str_ireplace
(PHP 5, PHP 7, PHP 8)
str_ireplace — Versão insensível a maiúsculas/minúsculas de str_replace()
Descrição
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
searchencontrados. 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
subjectfor um array, a pesquisa e a substituição são realizadas com cada entrada desubject, 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
Example #1 Exemplo de str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>Notas
Note: Esta função é compatível com dados binários.
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
- str_replace() - Substitui todas as ocorrências da string de pesquisa com a string de substituição
- preg_replace() - Realiza uma pesquisa por uma expressão regular e substitui
- strtr() - Traduz caracteres ou substitui substrings