Funkcja str_replace

Funkcja str_replace wyszukuje w ciągu znaków określony tekst i zamienia go na inny. Pierwszym parametrem funkcja przyjmuje to, co zamieniamy, a drugim - na co zamieniamy. Mogą to być dwa ciągi znaków lub dwie tablice. W drugim przypadku odpowiednie elementy jednej tablicy zostaną zastąpione przez odpowiednie elementy drugiej tablicy (patrz przykłady).

Składnia

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

Przykład

Zamieńmy wszystkie litery 'a' na '!':

<?php
	echo str_replace('a', '!', 'abcabc');
?>

Wynik wykonania kodu:

'!bc!bc'

Przykład

Zamieńmy wszystkie litery 'a' na 1, litery 'b' na 2, litery 'c' na 3:

<?php
	echo str_replace(['a', 'b', 'c'], [1, 2, 3], 'abcabc');
?>

Wynik wykonania kodu:

'123123'

Przykład

Zamieńmy określone litery na jeden wspólny określony znak:

<?php
	echo str_replace(['a', 'b', 'c'], '!', 'abcabc');
?>

Wynik wykonania kodu:

'!!!!!!'

Przykład

Wykonajmy zamianę w każdym elemencie tablicy:

<?php
	$arr = ['abc', 'abc', 'abc'];
	$res = str_replace('a', '!', $arr);
	print_r($res);
?>

Wynik wykonania kodu:

['!bc', '!bc', '!bc']

Przykład

Wielkość liter ma znaczenie:

<?php
	echo str_replace('a', '!', 'Abcabc');
?>

Wynik wykonania kodu:

'Abc!bc'

Zobacz też

funkcję str_ireplace,
która wykonuje wyszukiwanie i zamianę bez uwzględniania wielkości liter
funkcję strtr,
która również wykonuje wyszukiwanie i zamianę
funkcję substr_replace,
która wycina część ciągu znaków i zastępuje ją inną