PHP Handbuch
Zurück |  | Weiter

# 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.

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ück | Zum Anfang | Weiter
str_getcsv | Nach oben | str_pad