Forum und email

str_ireplace

(PHP 5)

str_ireplace — Groß- und kleinschreibungsunabhängige Version von str_replace()

Beschreibung

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

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.