Willi's Homepage - Tricks und Tips

Du bist hier: Tips » Scripte » PHP

PHP

Referenzliste

str_replace

«« str_repeat

str_rot13 »»

String-Funktionen

Befehl:

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

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 einn 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.

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

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.

Aktiv in Version:

(PHP 4, PHP 5, PHP 7)

Hinweis:

Hinweis:

Diese Funktion ist binary safe.

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

Achtung:

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.

Siehe auch:

• str_ireplace()

Gross- 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

Bsp. 1
Bsp. 2

str_replace() - Beispiel:

Eingabe:

<?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;
?>

Beschreibung:

Mit str_replace() kann man in einer Zeichenkette (haystack) nach allen Vorkommen des Strings needle suchen und durch einen anderen String (str) ersetzen lassen. Bei der Funktion werden auf Binï¿½r-Basis die Vorkommen des Strings gesucht. Einfache Ersetzungen sollten Sie immer mit dieser Funktion realisieren. Fï¿½r ausgefallenere Ersetzungen bietet sich ereg_replace() an.

Beschreibung:

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.

str_replace() - Beispiel 2: mï¿½glicher str_replace() ï¿½berraschungen

Eingabe:

<?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;
?>

Beschreibung:

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.

str_repeat

str_rot13

String-Funktionen