(PHP 5, PHP 7, PHP 8)
str_ireplace — Versão insensível a maiúsculas/minúsculas de str_replace()
$search,$replace,$subject,&$count = null
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.
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.
searchO 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.
subjectA 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.
countSe informado, será definido como o número de substituições realizadas.
Retorna uma string ou um array de substituiçõ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. |
Exemplo #1 Exemplo de str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>Nota: Esta função é compatível com dados binários.
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.