Função PHP str_replace()
Exemplo
Substitua os caracteres "world" na string "Hello world!" com "Pedro":
<?php
echo str_replace("world","Peter","Hello world!");
?>
Definição e uso
A função str_replace() substitui alguns caracteres por outros caracteres em uma string.
Esta função funciona pelas seguintes regras:
- Se a string a ser pesquisada for uma matriz, ela retornará uma matriz
- Se a string a ser pesquisada for uma matriz, localizar e substituir será executado com cada elemento da matriz
- Se tanto find quanto replace forem arrays, e replace tiver menos elementos que find, uma string vazia será usada como replace
- Se find for um array e replace for uma string, a string de substituição será usada para cada valor de busca
Nota: Esta função diferencia maiúsculas de minúsculas. Use a função str_ireplace() para realizar uma pesquisa que não diferencia maiúsculas de minúsculas.
Nota: Esta função é segura para binários.
Sintaxe
str_replace(find,replace,string,count)
Valores de parâmetro
Parameter | Description |
---|---|
find | Required. Specifies the value to find |
replace | Required. Specifies the value to replace the value in find |
string | Required. Specifies the string to be searched |
count | Optional. A variable that counts the number of replacements |
Detalhes técnicos
Valor de retorno: | Retorna uma string ou um array com os valores substituídos |
---|---|
Versão do PHP: | 4+ |
Registro de alterações: | O parâmetro count foi adicionado no PHP 5.0 Antes do PHP 4.3.3, esta função apresentava problemas ao usar arrays como parâmetros de localização e substituição, o que fazia com que índices de localização vazios fossem ignorados sem avançar o ponteiro interno no array de substituição . Versões mais recentes não terão esse problema. A partir do PHP 4.0.5, a maioria dos parâmetros agora pode ser um array |
Mais exemplos
Exemplo
Usando str_replace() com um array e uma variável de contagem:
<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Replacements: $i";
?>
Exemplo
Usando str_replace() com menos elementos em replace do que find:
<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>
❮ Referência de String PHP