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 preg_replace()
mit i-Modifier verwenden.
Wenn der search und replace
Arrays sind, nimmt str_ireplace() einen Wert von jedem
Array und sucht/ersetzt mit diesen im subject.
Wenn replace weniger Werte als
search besitzt, wird eine leere Zeichenkette für die
verbleibenden Ersetzungswerte verwendet.
Wenn search ein Array ist und
replace eine Zeichenkette, wird dieser
Ersetzungswert für alle Werte des search genutzt.
Die Umkehrung jedoch wäre sinnlos.
Wenn search oder replace
Array sind, werden ihre Elemente in aufsteigender Reihenfolge bearbeitet.
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, wird die
Suchen-Ersetzen-Funktionalität auf jedes Element von
subject angewendet. Die Funktion gibt
dann natürlich ein Array zurück.
count
Falls übergeben, wird dies auf die Anzahl der durchgeführten Ersetzungen gesetzt.
Gibt eine Zeichenkette oder ein Array mit ersetzten Werten zurück.
| Version | Beschreibung |
|---|---|
| 5.0.0 |
Der Parameter count wurde hinzugefügt.
|
Beispiel #1 str_ireplace()-Beispiel
<?php
$bodytag = str_ireplace("%body%", "schwarz", "<body text=%BODY%>");
?>
Hinweis: Diese Funktion ist binary safe.
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.