str_replace
(PHP 4, PHP 5, PHP 7)
str_replace — Ersetzt alle Vorkommen des Suchstrings durch einen anderen String
Beschreibung
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 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 Werte zu bestimmen. -
subject
-
Die zu durchsuchende und darin enthaltene zu ersetzende Zeichenkette oder das Array, auch Heuhaufen (haystack) genannt.
Ist
subject
ein Array, erfolgt das Suchen und Ersetzen für jeden Wert vonsubject
, und der Rückgabewert ist ebenfalls ein Array. -
count
-
Falls übergeben, wird dies auf die Anzahl der durchgeführten Ersetzungen gesetzt.
Beispiele
Beispiel #1 Grundlegende 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);
// Liefert: 2
$str = str_replace("ll", "", "good golly miss molly!", $count);
echo $count;
?>
Beispiel #2 Beispiele möglicher Probleme durch str_replace()
<?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.
Mögliche Probleme durch Reihenfolge der Ersetzungen
Weil str_replace() von links nach rechts ersetzt, kann ein zuvor eingesetzter Wert ersetzt werden, wenn mehrere Ersetzungen durchgeführt werden. Das letzte Beispiel zeigt, was dies für Auswirkungen hat.
Hinweis:
Die Funktion berücksichtigt Groß- und Kleinschreibung. Verwenden Sie str_ireplace(), wenn Sie unabhängig von Groß- und Kleinschreibung ersetzen möchten.
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
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 30/01/2003, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/php-rf-str-replace.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.