Função str_replace() do PHP

Exemplo

Substitua o caractere "world" da string "Hello world!" por "Shanghai":

<?php
echo str_replace("world", "Shanghai", "Hello world!");
?>

Executar Exemplo

Definição e uso

A função str_replace() substitui alguns caracteres de uma string por outros caracteres (distingue maiúsculas e minúsculas).

Esta função deve seguir as seguintes regras:

  • Se a string de busca é um array, ela retornará um array.
  • Se a string de busca é um array, ela buscará e substituirá cada elemento do array.
  • Se, ao buscar e substituir um array, o número de elementos substituídos for menor do que o número de elementos encontrados, os elementos em excesso serão substituídos por uma string vazia.
  • Se a busca é em um array e a substituição é uma string, a string de substituição afetará todos os valores encontrados.

Notas:Esta função distingue entre maiúsculas e minúsculas. Use str_ireplace() A execução da função não distingue entre maiúsculas e minúsculas na busca.

Notas:Esta função é segura para binários.

gramática

str_replace("", "", "");find,replace,string,count)
Parâmetros Descrição
find Obrigatório. Define o valor a ser encontrado.
replace Obrigatório. Define a substituição find do valor do valor.
string Obrigatório. Define a string a ser pesquisada.
count Opcional. Variável que conta o número de substituições.

Detalhes Técnicos

Retorno: Retorna uma string ou array com valores substituídos.
Versão PHP: 4+
Log de Atualizações:

No PHP 5.0, foi adicionado count parâmetros.

Antes do PHP 4.3.3, os parâmetros do função find e replace Quando todos os parâmetros são arrays, pode haver problemas, causando find O índice do ponteiro interno não foi trocado replace É ignorado no array. As novas versões não terão esse problema.

A partir do PHP 4.0.5, a maioria dos parâmetros pode ser um array.

Mais Exemplos

Exemplo 1

Use com arrays e count Função str_replace() de variável:

<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Número de substituições: $i";
?>

Executar Exemplo

Exemplo 2

Use a função str_replace() com elementos a serem substituídos menores que os encontrados:

<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>

Executar Exemplo