str_replace
Ersetzt alle Vorkommen des Suchstrings durch einen anderen String
&reftitle.description;
mixedstr_replace
mixedsearch
mixedreplace
mixedsubject
intcount
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.
Wenn Sie keine ausgefallenen Ersetzungsregeln (wie Reguläre Ausdrücke)
benötigen, sollten Sie immer diese Funktion anstelle von
ereg_replace oder preg_replace
verwenden.
&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
replace
subject
Ist subject ein Array, erfolgt das Suchen
und Ersetzen für jeder Wert von subject,
und der Rückgabewert ist ebenfalls ein Array.
count
Sofern angegeben, enthält der Parameter die Anzahl der gefunden und
ersetzten Textstellen.
&reftitle.returnvalues;
Diese Funktion gibt eine Zeichenkette oder ein Array mit ersetzten Werten
zurück.
&reftitle.changelog;
&Version;
&Description;
5.0.0
Der Parameter count wurde hinzugefügt.
4.3.3
Das Verhalten der Funktion wurde verändert. Ältere Versionen enthalten
einen Bug, der bei der Verwendung von Arrays für
search und replace dazu
führt, dass leere search-Indexe übersprungen
werden, ohne dabei den internen Zeiger innerhalb des
replace-Arrays ebenfalls weiter zu bewegen. Dies
wurde in PHP 4.3.3 korrigiert. Alle Skripte, die sich auf diesen Bug
verlassen, sollten leere Suchwerte entfernen, bevor diese Funktion
aufgerufen wird, um die ursprüngliche Verhalten zu imitieren.
4.0.5
Die meisten Parameter können vom Typ array sein.
&reftitle.examples;
str_replace-Beispiele
$bodytag = str_replace("%body%", "schwarz", "");
// Liefert: Hll PHP-Wlt
$vokale = array("a", "e", "i", "o", "u", "A", "E", "I", "O", "U");
$onlyconsonants = str_replace($vokale, "", "Hallo PHP-Welt");
// Liefert: Sie sollten taeglich Pizza, Bier und Eiscreme essen.
$phrase = "Sie sollten taeglich Fruechte, Gemuese und Ballaststoffe essen.";
$gesund = array("Fruechte", "Gemuese", "Ballaststoffe");
$lecker = array("Pizza", "Bier", "Eiscreme");
$newphrase = str_replace($gesund, $lecker, $phrase);
// Die Verwendung des count-Parameters ist ab PHP 5.0.0 möglich
$str = str_replace("ll", "", "good golly miss molly!", $count);
echo $count; // 2
// Reihenfolge von Ersetzungen
$str = "Zeile 1\nZeile 2\rZeile 3\r\nZeile 4\n";
$order = array("\r\n", "\n", "\r");
$replace = '
';
// Verarbeitet \r\n's zuerst, so dass sie nicht doppelt konvertiert werden
$newstr = str_replace($order, $replace, $str);
// Ausgabe: apearpearle pear
$letters = array('a', 'p');
$fruit = array('apple', 'pear');
$text = 'a p';
$output = str_replace($letters, $fruit, $text);
echo $output;
?>
]]>
&reftitle.notes;
¬e.bin-safe;
Die Funktion berücksichtigt Groß- und Kleinschreibung. Verwenden Sie
str_ireplace, wenn Sie beim Ersetzen unabhängig von
der Groß- und Kleinschreibung sein wollen.
&reftitle.seealso;
str_ireplace
substr_replace
preg_replace
strtr