Função str_replace
A função str_replace busca em uma string
um texto especificado e o substitui por outro. O primeiro
parâmetro da função é o que substituímos,
e o segundo - pelo que substituímos. Estes podem ser
duas strings ou dois arrays. No segundo caso,
os elementos correspondentes de um array serão substituídos
pelos elementos correspondentes do segundo array
(veja os exemplos).
Sintaxe
str_replace(array|string $search, array|string $replace, string|array $subject, int &$count = null): string|array
Exemplo
Vamos substituir todas as letras 'a' por '!':
<?php
echo str_replace('a', '!', 'abcabc');
?>
Resultado da execução do código:
'!bc!bc'
Exemplo
Vamos substituir todas as letras 'a' por 1,
letras 'b' por 2, letras 'c'
por 3:
<?php
echo str_replace(['a', 'b', 'c'], [1, 2, 3], 'abcabc');
?>
Resultado da execução do código:
'123123'
Exemplo
Vamos substituir as letras especificadas por um símbolo comum indicado:
<?php
echo str_replace(['a', 'b', 'c'], '!', 'abcabc');
?>
Resultado da execução do código:
'!!!!!!'
Exemplo
Vamos realizar a substituição em cada elemento do array:
<?php
$arr = ['abc', 'abc', 'abc'];
$res = str_replace('a', '!', $arr);
print_r($res);
?>
Resultado da execução do código:
['!bc', '!bc', '!bc']
Exemplo
Letras maiúsculas e minúsculas são diferentes:
<?php
echo str_replace('a', '!', 'Abcabc');
?>
Resultado da execução do código:
'Abc!bc'
Veja também
-
a função
str_ireplace,
que realiza busca e substituição sem diferenciar letras maiúsculas e minúsculas -
a função
strtr,
que também realiza busca e substituição -
a função
substr_replace,
que remove parte de uma string e a substitui por outra
