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!");
?>

Executar Exemplo

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";
?>

Executar Exemplo

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));
?>

Executar Exemplo