Manual do PHP
Anterior |  | Próxima

# str_ireplace

(PHP 5)

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