PHP Handbuch
Zurück |  | Nach vorne

# str_replace

(PHP 3>= 3.0.6, PHP 4 , PHP 5)

str_replace -- Ersetzt alle Vorkommen eines Strings in einem anderen String

## Beschreibung

mixed str_replace ( mixed search, mixed replace, mixed subject)

Diese Funktion ersetzt alle Vorkommen von `search` innerhalb der Zeichenkette `subject` durch den String `replace`. Falls Sie keine ausgefallenen String-Ersetzungen brauchen, sollten Sie immer dieser Funktion den Vorzug vor ereg_replace() oder preg_replace() geben.

Seit PHP 4.0.5 kann jeder Parameter von str_replace() auch ein Array sein.

Ist `subject` ein Array, erfolgt das Suchen und Ersetzen an jedem Wert von `subject`, und der Rückgabewert ist ebenfalls ein Array.

Sind `search` und `replace` Arrays, nimmt str_replace() einen Wert von jedem Array und verwendet ihn zum Suchen und Ersetzen von `subject`. Hat `replace` weniger Werte als `search`, so wird ein leerer String für den Rest der Werte zum Ersetzen verwendet. Ist `search` ein Array und `replace` ein String, dann wird dieser String für jeden Wert von `search` angewandt.

Beispiel 1. str_replace() Beispiel:
`$bodytag = str_replace("%body%", "black", "<body text=%body%>");`

Diese Funktion beruht auf einem Binär-Vergleich.

> Anmerkung: str_replace() ist seit PHP 3.0.6 verfügbar, war aber bis PHP 3.0.8 fehlerhaft.

Siehe auch str_ireplace(), ereg_replace(), preg_replace() und strtr().

Zurück | Zum Anfang | Nach vorne
str_repeat | Nach oben | str_rot13