Forum und email

str_replace

(PHP 4, PHP 5)

str_replace — Ersetzt alle Vorkommen des Suchstrings durch einen anderen String

Beschreibung

mixed str_replace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )

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.

Parameter Liste

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

Hinweis: Sofern angegeben, enthält der Parameter die Anzahl der gefunden und ersetzten Textstellen.

Rückgabewerte

Diese Funktion gibt eine Zeichenkette oder ein Array mit ersetzten Werten zurück.

ChangeLog

Version Beschreibung
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.

Beispiele

Example#1 str_replace()-Beispiele

<?php
// Liefert: <body text='schwarz'>
$bodytag str_replace("%body%""schwarz""<body text='%body%'>");

// 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 '<br />';
// 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;
?>

Anmerkungen

Hinweis: Diese Funktion ist binary safe.

Hinweis: Die Funktion berücksichtigt Groß- und Kleinschreibung. Verwenden Sie str_ireplace(), wenn Sie beim Ersetzen unabhängig von der Groß- und Kleinschreibung sein wollen.