|
str_replace
(PHP 4, PHP 5) str_replace — Ersetzt alle Vorkommen des Suchstrings durch einen anderen String
Beschreibung
Wenn Sie keine ausgefallenen Ersetzungsregeln (wie Reguläre Ausdrücke)
benötigen, sollten Sie immer diese Funktion anstelle von
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
-
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 Nadeln zu
bestimmen.
-
subject
-
Die zu durchsuchende und darin ersetzende Zeichenkette oder das Array,
auch Heuhaufen (haystack) genannt.
Ist subject ein Array, erfolgt das Suchen
und Ersetzen für jeder Wert von subject,
und der Rückgabewert ist ebenfalls ein Array.
-
count
-
Falls übergeben, wird dies auf die Anzahl der durchgeführten
Ersetzungen gesetzt.
Rückgabewerte
Diese Funktion gibt eine Zeichenkette oder ein Array mit ersetzten Werten
zurück.
Beispiele
Beispiel #1 Grundlegendestr_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);
// Liefert: 2
$str = str_replace("ll", "", "good golly miss molly!", $count);
echo $count;
?>
Beispiel #2 Beispiele möglicher str_replace() Überraschungen
<?php
// 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: 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);
// 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;
?>
Anmerkungen
Hinweis: Diese Funktion ist binary safe.
Achtung
Besonderes Verhalten bei der Reihenfolge der Ersetzungen
Weil str_ireplace() von links nach rechts ersetzt,
kann sie einen zuvor eingesetzten Wert ersetzen, falls mehrere
Ersetzungen durchgeführrt werden. Beispiel #2 in der Dokomenation
von str_replace() zeigt, wie dies sie in der Praxis
betreffen kann.
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.
Siehe auch
- str_ireplace() - Groß- und kleinschreibungsunabhängige Version von
str_replace
- substr_replace() - Ersetzt Text innerhalb einer Zeichenkette
- preg_replace() - Sucht und ersetzt mit regulären Ausdrücken
- strtr() - Tauscht Zeichen aus oder ersetzt Zeichenketten
|
