Manual do PHP
Anterior |  | Próxima

# str_ireplace

(PHP 5 CVS only)

str_ireplace -- Versão que não diferencia maiúsculas e minúsculas de str_replace().

## Descrição

mixed str_ireplace ( mixed search, mixed replace, mixed subject [, int &count])

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 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().

Anterior | Principal | Próxima
sscanf | Acima | str_pad