(PHP 3 >= 3.0.6, PHP 4, PHP 5)
str_replace -- Ersetzt alle Vorkommen des Suchstrings durch einen anderen String
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 Regular Expressions) benötigen, sollten
Sie immer diese Funktion anstelle von ereg_replace()
oder preg_replace() verwenden.
Seit PHP 4.0.5 kann jeder Parameter von str_replace() vom Type array sein.
Warnung |
Die PHP-Versionen vor PHP 4.3.3 enthalten einen Bug, der bei der
Verwendung von Arrays für |
Ist subject
ein Array, erfolgt das Suchen
und Ersetzen für jeder Wert von subject
,
und der Rückgabewert ist ebenfalls ein Array.
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.
Anmerkung: Diese Funktion ist binary safe.
Anmerkung: Ab PHP 5.0.0 wird die Anzahl der gefundenen und ersetzten Suchbegriffe (
search
) mittelscount
zurück gegeben, der als Referenz übergeben wird. Vor PHP 5.0.0 ist dieser Parameter nicht verfügbar.
Siehe auch str_ireplace(), substr_replace(), preg_replace() und strtr().
Zurück | Zum Anfang | Weiter |
str_repeat | Nach oben | str_rot13 |