Funkcja PHP str_ireplace()

Funkcja PHP str_ireplace() zamienia wszystkie egzemplarze szukanego łańcucha na inny łańcuch w łańcuchu źródłowym, ignorując wielkość liter przy porównywaniu wartości.

Funkcja str_ireplace() nie rozróżnia wielkośi liter. Jeśli chcesz dokonywać zamiany z uwzględnieniem wielkości liter, użyj funkcji str_replace().

Przykład

Podmiana fragmentu tekstu za pomocą funkcji PHP str_ireplace().


$uprzejmosci = "Ty, sułtanie, diable turecki, przeklętego diabła bracie.";

echo str_replace("bracie", "pomiocie", $uprzejmosci);

Wynik:

Ty, sułtanie, diable turecki, przeklętego diabła pomiocie.

Składnia funkcji PHP str_ireplace()

Funkcja PHP str_ireplace() ma następującą składnię:

str_ireplace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

Parametry

Parametr	Opis
`search`	Parametr obowiązkowy. Szukana wartość (igła — ang. needle). Może to być też tablica zawierająca kilka wartości do wyszukania.
`replace`	Parametr obowiązkowy. Wartość, która ma zostać wstawiona w miejsce znalezionej wartości. Może to być też tablica zawierająca kilka wartości na zamianę.
`subject`	Parametr obowiązkowy. Łańcuch lub tablica do przeszukania i ewentualnie zamiany wartości (stóg siana — ang. haystack). Jeśli argument ten jest tablicą, to operacja wyszukiwania i zamiany jest wykonywana w każdym elemencie i zwracana jest tablica.
`count`	Parametr opcjonalny, który określa, ile podmian ma zostać wykonanych.

Wartość zwrotna

Funkcja PHP str_ireplace() zwraca łańcuch lub tablicę z podmienionymi wartościami.

Typ zwrotny: string|array.

Dodatkowy przykład użycia funkcji PHP str_ireplace()

Poniżej znajduje się przykład użycia funkcji PHP str_ireplace() z tablicami.


$uprzejmosci = "Ty, sułtanie, diable turecki, przeklętego diabła bracie.";
$do_wymiany = ["sułtanie", "diable", "diabła", "bracie"];
$na_wymiane = ["dzbanie", "moczymordo", "szatana", "kamracie"];

echo str_replace($do_wymiany, $na_wymiane, $uprzejmosci);