Exemplo
Substituir os caracteres "world" na string "Hello world!" com "Peter" :
<?php
echo str_replace("world","Peter","Hello world!");
?> Exemplo executar » Definição e Uso
O str_replace() função substitui alguns caracteres com alguns outros personagens em uma corda.
Esta função funciona pelas seguintes regras:
- Se a string a ser pesquisada é um array, ele retorna um array
- Se a string a ser pesquisada é um array, localizar e substituir é executada com cada elemento do array
- Se ambos localizar e substituir são matrizes, e substituir tem menos elementos que encontrar, uma cadeia vazia será usado como substituir
- Se descoberta é um array e replace é uma string, o texto de substituição será usado para cada encontrar o valor
Note: Esta função é case-sensitive. Use o str_ireplace() função para realizar uma pesquisa diferencia maiúsculas de minúsculas.
Note: Esta função é compatível com dados binários.
Sintaxe
str_replace( find,replace,string,count )
| Parâmetro | Descrição |
|---|---|
| find | Requeridos. Especifica o valor de encontrar |
| replace | Requeridos. Especifica o valor para substituir o valor na find |
| string | Requeridos. Especifica a cadeia a ser pesquisada |
| count | Opcional. Uma variável que conta o número de substituições |
Detalhes técnicos
| Valor de retorno: | Retorna uma string ou um array com os valores substituídos |
|---|---|
| PHP Versão: | 4+ |
| changelog: | O parâmetro count foi adicionado no PHP 5.0 Antes do PHP 4.3.3, esta função experimentado dificuldades ao utilizar arrays em ambos os localizar e substituir parâmetros, o que causou índices find vazios para serem ignoradas, sem avançar o apontador interno no array substituir. As versões mais recentes não terá esse problema. A partir do PHP 4.0.5, a maior parte dos parâmetros podem agora ser uma matriz |
mais Exemplos
Exemplo 1
Usando str_replace() com uma matriz 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 executar » exemplo 2
Usando str_replace() com menos elementos em substituir do que encontrar:
<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?> Exemplo executar » <PHP seqüência de referência