Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

str_ireplace

String-Funktionen

    Befehl:
mixed str_ireplace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )


    Parameter-Liste:

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.

NameBeschreibung
searchDer gesuchte Wert, auch Nadel (needle) genannt. Ein Array kann genutzt werden, um mehrere Nadeln zu bestimmen.
replaceDer 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.

countFalls übergeben, wird dies auf die Anzahl der durchgeführten Ersetzungen gesetzt.

    Beschreibung:
Die Funktion gibt einen String oder ein Array zurück, in dem alle Vorkommen von search innerhalb von subject unabhängig von deren Gross- 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.


    Aktiv in Version:
(PHP 5, PHP 7)

    Hinweis:
Hinweis:

Diese Funktion ist binary safe.


    Achtung:
Achtung: Reihenfolge der Ersetzungen Überraschung

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:
Ersetzt alle Vorkommen des Suchstrings durch einen anderen String
 
Sucht und ersetzt mit regulären Ausdrücken
 
•  strtr()
Tauscht Zeichen aus oder ersetzt Zeichenketten
 

str_ireplace() - Beispiel:


Eingabe:
<?php
$bodytag = str_ireplace("%body%", "schwarz", "<body text=%BODY%>");
?>


Beschreibung:
Version Beschreibung
5.0.0 Der Parameter count wurde hinzugefügt.
String-Funktionen