(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
needles
foi encontrado e substituido será retornado emcount
o 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().