(PHP 5, PHP 7)
str_ireplace — Versão que não diferencia maiúsculas e minúsculas de str_replace().
Esta função retorna uma string ou uma matriz com todas as ocorrencias de
search em subject
(não diferenciando maiúsculas e minúsculas) substituidas com o valor de replace.
Se você não necessitar de regras de substituição mais complicadas, você deve geralmente
usar esta função ao invés de eregi_replace() ou
preg_replace() com o modificador i.
Se subject for uma matriz, então a procura e substituição
é realizada para cada item de subject,
e o valor retornado é uma matriz.
Se search e
replace forem matrizes, então
str_ireplace() pega um valor de cada matriz
e os usas para localizar e substituir em
subject. Se
replace tiver menos valores do que
search, então uma string vazia é
usada para o resto dos valores de substituição.
Se search
é uma matriz e replace é uma string; então
esta string é usada para cada valor de
search.
Exemplo #1 Exemplo str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
Esta função é segura para binários.
Nota: Apartir do PHP 5.0.0 o número de vezes que
needlesfoi encontrado e substituido será retornado emcounto qual é passado por referencia. Anteriormente a PHP 5.0.0 este parâmetro não esta disponível.
Veja também: str_replace(), ereg_replace(), preg_replace() e strtr().