Funkcja PHP str_replace()

Funkcja PHP str_replace() zamienia wszystkie egzemplarze szukanego łańcucha na inny łańcuch w łańcuchu źródłowym.

Funkcja str_replace() rozpoznaje wielkość liter. Jeśli chcesz dokonywać zamiany bez rozróżniania wielkości liter, użyj funkcji str_ireplace().

Przykład

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


$uprzejmosci = "Ty, sułtanie, diable turecki, przeklętego diabła bracie i towarzyszu, samego Lucyfera sekretarzu.";

echo str_replace("Lucyfera", "Behemota", $uprzejmosci);

Wynik:

Ty, sułtanie, diable turecki, przeklętego diabła bracie i towarzyszu, samego Behemota sekretarzu.

Składnia funkcji PHP str_replace()

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

str_replace(
    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_replace() zwraca łańcuch lub tablicę z podmienionymi wartościami.

Typ zwrotny: string|array.

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

Poniżej znajduje się przykład użycia funkcji PHP str_replace() do podmiany jednego bajtu znaku dwubajtowego UTF-8.


$uprzejmosci = "Ty, sułtanie, diable turecki, przeklętego diabła bracie i towarzyszu, samego Lucyfera sekretarzu.";

echo str_replace("\xC5", "\xc7", $uprzejmosci);