Função str_ireplace() do PHP
Exemplo
Substitua o caractere "WORLD" (sem distinção entre maiúsculas e minúsculas) da string "Hello world!" por "Shanghai":
<?php echo str_ireplace("WORLD","Shanghai","Hello world!"); ?>
Definição e uso
A função str_ireplace() substitui alguns caracteres em uma string (sem distinção entre maiúsculas e minúsculas).
Esta função deve seguir as seguintes regras:
- Se a string de busca for um array, ele retornará um array.
- Se a string de busca for um array, ele buscará e substituirá cada elemento do array.
- Se a busca e a substituição precisarem ser feitas em um array e o número de elementos a serem 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 é feita em um array, mas a substituição é aplicada a uma string, a string substituída terá efeito em todos os valores encontrados.
Comentário:Esta função não diferencia maiúsculas e minúsculas. Use str_replace() função para executar pesquisa diferenciada por maiúsculas e minúsculas.
Comentário:Esta função é segura para binários.
Sintaxe
str_ireplace(find,replace,string,count)
Parâmetros | Descrição |
---|---|
find | Obrigatório. Especifica o valor a ser encontrado. |
replace | Obrigatório. Especifica a substituição find do valor do valor. |
string | Obrigatório. Especifica a string a ser pesquisada. |
count | Opcional. Uma 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: | 5+ |
Log de Atualizações: | Em PHP 5.0, foi adicionado count Parâmetros. |
Mais Exemplos
Exemplo 1
Use com arrays e count Função str_ireplace() de variável:
<?php $arr = array("blue","red","green","yellow"); print_r(str_ireplace("RED","pink",$arr,$i)); // Esta função é insensível a maiúsculas e minúsculas echo "Número de substituições: $i"; ?>
Exemplo 2
Use a função str_ireplace() com menos elementos a serem substituídos do que os encontrados:
<?php $find = array("HELLO","WORLD"); $replace = array("B"); $arr = array("Hello","world","!"); print_r(str_ireplace($find,$replace,$arr)); ?>