str_ireplace

PHP Handbuch
Zurück		Weiter

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.

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(), ereg_replace(), preg_replace() und strtr().

Zurück	Zum Anfang	Weiter
sscanf	Nach oben	str_pad