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 str_replace-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 str_replace
';
// 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