str_ireplace
(PHP 5)
str_ireplace — Versão que não diferencia maiúsculas e minúsculas de str_replace().
Descrição
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 .
Example#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 em count 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().