str_ireplace
(PHP 5)
str_ireplace — Groß- und kleinschreibungsunabhängige Version von str_replace()
Beschreibung
Die Funktion gibt einen String oder ein Array zurück, in dem alle Vorkommen von search innerhalb von subject unabhängig von deren Groß- oder Kleinschreibung gegen den entsprechenden replace -Wert ausgetauscht wurden. Sofern Sie keine speziellen Ersetzungsregeln verwenden, sollten Sie diese Funktion grundsätzlich anstelle von eregi_replace() oder preg_replace() mit i-Modifier verwenden.
Parameter Liste
- search
-
Hinweis: Jede Ersetzung aus dem search -Array wird auf dem Ergebnis der jeweils vorhergehenden Ersetzung ausgeführt.
- replace
-
- subject
-
Ist subject ein Array, wird die Suchen-Ersetzen-Funktionalität auf jedes Element von subject angewendet. Die Funktion gibt dann natürlich ein Array zurück.
- count
-
Die Anzahl der gefundenen und ersetzten Textstellen needle wird mittels der an den Parameter count als Referenz übergebenen Variablen zurückgegeben.
Sind search und replace Arrays, dann verwendet str_ireplace() aus beiden Arrays den Wert der aktuellen Zeigerposition, um damit ein Suchen und Ersetzen in subject durchzuführen. Hat replace weniger Werte als search , wird ein leerer String als Wert zum Ersetzen der verbleibenden Elemente verwendet. Ist search ein Array und replace ein String, wird dieser String als Ersetzung für jeden Wert von search verwendet.
Rückgabewerte
Gibt eine Zeichenkette oder ein Array mit ersetzten Werten zurück.
ChangeLog
| Version | Beschreibung |
|---|---|
| 5.0.0 | Der Parameter count wurde hinzugefügt. |
Beispiele
Example#1 str_ireplace()-Beispiel
<?php
$bodytag = str_ireplace("%body%", "schwarz", "<body text=%BODY%>");
?>
Anmerkungen
Hinweis: Diese Funktion ist binary safe.