Função str_ireplace

A função str_ireplace procura em uma string todas as ocorrências de uma substring (sem diferenciar maiúsculas de minúsculas) e as substitui por um valor especificado. O primeiro parâmetro recebe a substring procurada, o segundo - a string de substituição, o terceiro - a string na qual a busca é realizada.

Sintaxe

phpstr_ireplace(search, replace, subject);

Exemplo

Vamos substituir todas as ocorrências da substring sem diferenciar maiúsculas de minúsculas:

php<?php
  echo str_ireplace('abc', '!', 'aBc abc ABC');
?>

Resultado da execução do código:

php'! ! !'

Exemplo

Vamos substituir várias variantes em um array:

php<?php
  $res = str_ireplace(['a', 'b'], ['1', '2'], 'aBc');
  echo $res;
?>

Resultado da execução do código:

php'12c'

Exemplo

Vamos substituir as letras especificadas por um caractere comum indicado:

php<?php
  echo str_ireplace(['a', 'b', 'c'], '!', 'AbcAbc');
?>

Resultado da execução do código:

php'!!!!!!'

Exemplo

Vamos executar a substituição em cada elemento do array:

php<?php
  $arr = ['Abc', 'abc', 'abc'];
  $res = str_ireplace('a', '!', $arr);
  print_r($res);
?>

Resultado da execução do código:

php['!bc', '!bc', '!bc']

Veja também

  • a função str_replace,
    que executa a substituição diferenciando maiúsculas de minúsculas
  • a função substr_replace,
    que substitui parte de uma string