PHP Handbuch
ZurückWeiter

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.

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.

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 verwendet. Isst search ein Array und replace ein String, wird dieser String als Ersetzung für jeden Wert von search verwendet.

Anmerkung: Jede Ersetzung aus dem search-Array wird auf dem Ergebnis der jeweils vorhergehenden Ersetzung ausgeführt.

Beispiel 1. str_ireplace() Beispiel

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

Diese Funktion ist binary safe.

Anmerkung: Seit PHP 5.0.0 wird die Anzahl der gefundenen und ersetzten needles im Parameter count als Referenz zurückgegeben. Der Parameter steht nicht in PHP-Versionen vor 5.0.0 zur Verfügung.

Siehe auch: str_replace(), preg_replace() und strtr().

ZurückZum AnfangWeiter
str_getcsvNach obenstr_pad