str_replace Ersetzt alle Vorkommen des Suchstrings durch einen anderen String &reftitle.description; stringarraystr_replace arraystringsearch arraystringreplace stringarraysubject intcount&null; Diese Funktion gibt einen String oder ein Array zurück, in dem alle Vorkommen von search innerhalb von subject durch den angegebenen replace-Wert ersetzt wurden. Um Text anhand eines Musters statt einer konkreten Zeichenkette zu ersetzen, kann preg_replace verwendet werden. &reftitle.parameters; Sind search und replace Arrays, nimmt str_replace je einen Wert beider Arrays und verwendet diese zum Suchen und Ersetzen in subject. Hat replace weniger Werte als search, so wird ein leerer String zum Ersetzen für den Rest der Werte verwendet. Ist search ein Array und replace ein String, dann wird dieser String für jeden Wert von search angewandt. Das Gegenteil ist nicht sinnvoll. Sind search und/oder replace Arrays, werden ihre Elemente vom ersten zum letzten hin verarbeitet. search Der gesuchte Wert, auch Nadel (needle) genannt. Ein Array kann genutzt werden, um mehrere Nadeln zu bestimmen. replace Der Ersetzungswert, der gefundene search Werte ersetzt. Ein Array kann genutzt werden, um mehrere Werte zu bestimmen. subject Die zu durchsuchende und darin enthaltene zu ersetzende Zeichenkette oder das Array, auch Heuhaufen (haystack) genannt. Ist subject ein Array, erfolgt das Suchen und Ersetzen für jeden Wert von subject, und der Rückgabewert ist ebenfalls ein Array. count Falls übergeben, wird dies auf die Anzahl der durchgeführten Ersetzungen gesetzt. &reftitle.returnvalues; Diese Funktion gibt eine Zeichenkette oder ein Array mit ersetzten Werten zurück. &reftitle.examples; Grundlegende <function>str_replace</function>-Beispiele $bodytag = str_replace("%body%", "black", ""); echo $bodytag, PHP_EOL; // Liefert: Hll PHP-Wlt $vokale = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U"); $nurkonsonanten = str_replace($vokale, "", "Hallo PHP-Welt"); echo $nurkonsonanten, PHP_EOL; // Liefert: Sie sollten taeglich Pizza, Bier und Eiscreme essen. $satz = "Sie sollten taeglich Fruechte, Gemuese und Ballaststoffe essen."; $gesund = array("Fruechte", "Gemuese", "Ballaststoffe"); $lecker = array("Pizza", "Bier", "Eiscreme"); $neuersatz = str_replace($gesund, $lecker, $satz); echo $neuersatz, PHP_EOL; // Liefert: 2 $str = str_replace("ll", "", "good golly miss molly!", $anzahl); echo $anzahl, PHP_EOL; ?> ]]> Beispiele möglicher Probleme durch <function>str_replace</function> '; // Verarbeitet \r\n's zuerst, so dass sie nicht doppelt konvertiert werden $newstr = str_replace($order, $replace, $str); echo $newstr, PHP_EOL; // Ausgabe: F da A durch B ersetzt wird, dann B durch C, und so weiter... // Letztlich wird E durch F ersetzt, wegen der Ersetzung von Links nach Rechts $search = array('A', 'B', 'C', 'D', 'E'); $replace = array('B', 'C', 'D', 'E', 'F'); $subject = 'A'; echo str_replace($search, $replace, $subject), PHP_EOL; // Ausgabe: apearpearle pear // Aus dem gleichen Grund wie oben beschrieben $letters = array('a', 'p'); $fruit = array('apple', 'pear'); $text = 'a p'; $output = str_replace($letters, $fruit, $text); echo $output, PHP_EOL; ?> ]]> &reftitle.notes; ¬e.bin-safe; Mögliche Probleme durch Reihenfolge der Ersetzungen Weil str_replace von links nach rechts ersetzt, kann ein zuvor eingesetzter Wert ersetzt werden, wenn mehrere Ersetzungen durchgeführt werden. Das letzte Beispiel zeigt, was dies für Auswirkungen hat. Die Funktion berücksichtigt Groß- und Kleinschreibung. Verwenden Sie str_ireplace, wenn Sie unabhängig von Groß- und Kleinschreibung ersetzen möchten. &reftitle.seealso; str_ireplace substr_replace preg_replace strtr