(PHP 3 >= 3.0.6, PHP 4, PHP 5)
str_replace -- Substitui todas as ocorrências da string de procura com a string de substituição
Esta função retorna uma string ou um array com todas as ocorrências de
pesquisa
em assunto
substituidas com a o valor dado para substitui
. Se
você não precisa de regras de substituição especiais, você sempre poderia usar
esta função ao invés de ereg_replace() ou
preg_replace().
Como do PHP 4.0.5, cada parâmetro em str_replace() pode ser um array.
Atenção |
Em versões do PHP anteriores à 4.3.3 existia um bug ao se usar arrays em ambos
os parâmetros |
Se assunto
é um array, então a pesquisa
e a substituição é executada com cada entrada do assunto
,
e o valor de retorno é um array também.
Se pesquisa
e
substitui
são arrays, então
str_replace() pega o valor de cada array
e os usa para fazer a pesquisa e a substituição em subject
. Se
substitui
tem menos valores do que
pesquisa
, então um string vazia é usada para o restante dos
valores de substituição. Se pesquisa
é um array e substitui
é uma string; então
esta string de substituição é usada para cada valor de
pesquisa
.
Nota: Esta função é compatível com dados binários
Nota: No PHP 5.0.0 o número "neddles" (
search
) combinadas e substituidas será retornado emcount
que é passado por referência. Antes do PHP 5.0.0 este parâmetro não estava disponível.
Veja também str_ireplace(), substr_replace(), ereg_replace(), preg_replace(), e strtr().