array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.str-ireplace.php', 1 => 'str_ireplace', 2 => 'Versão insensível a maiúsculas/minúsculas de str_replace', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.str-increment.php', 1 => 'str_increment', ), 'next' => array ( 0 => 'function.str-pad.php', 1 => 'str_pad', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/str-ireplace.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — Versão insensível a maiúsculas/minúsculas de str_replace()

Descrição

str_ireplace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

Esta função retorna uma string ou um array com todas as ocorrências de search em subject (ignorando maiúsculas e minúsculas) substituídas pelo valor replace fornecido.

Para substituir texto baseado em um padrão em vez de uma string fixa, use preg_replace() com o modificador de expressões regulares i.

Parâmetros

Se search e replace forem arrays, str_ireplace() pega um valor de cada array e os usa para pesquisar e substituir em subject. Se replace tiver menos valores que search, uma string vazia será usada para o restante dos valores de substituição. Se search for um array e replace for uma string, esta string de substituição será usada para cada valor de search. O inverso não faria sentido, no entanto.

Se search ou replace forem arrays, seus elementos serão processados ​​do primeiro ao último.

search

O valor que está sendo pesquisado, também conhecido como agulha. Um array pode ser usado para designar múltiplas agulhas.

replace

O valor de substituição que substitui os valores de search encontrados. Um array pode ser usado para designar múltiplas substituições.

subject

A string ou array sendo pesquisado e substituído, também conhecido como o palheiro.

Se subject for um array, a pesquisa e a substituição são realizadas com cada entrada de subject, e o valor de retorno é também um array.

count

Se informado, será definido como o número de substituições realizadas.

Valor Retornado

Retorna uma string ou um array de substituições.

Registro de Alterações

Versão Descrição
8.2.0 A redução de todas as letras a maiúsculas ou minúsculas não depende mais da localidade definida com setlocale(). Somente a redução de todas as letras ASCII a maiúsculas ou minúsculas será feita. Os bytes não ASCII serão comparados por seu valor de byte.

Exemplos

Exemplo #1 Exemplo de str_ireplace()

<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>

Notas

Nota: Esta função é compatível com dados binários.

Cuidado

Armadilha na ordem de substituição

Como str_ireplace() substitui da esquerda para a direita, ela pode substituir um valor inserido anteriormente ao realizar múltiplas substituições. O exemplo #2 na documentação da função str_replace() demonstra o efeito disto na prática.

Veja Também