(PHP 5, PHP 7, PHP 8)
str_ireplace — Versión insensible a mayúsculas y minúsculas de str_replace()
$search
,$replace
,$subject
,&$count
= null
str_ireplace() devuelve una cadena de caracteres
o un array en el que todas las ocurrencias de search
en subject
(ignorando mayúsculas y minúsculas), han sido
reemplazadas por el valor de replace
.
Para reemplazar un texto según un patrón en lugar de una cadena fija,
utilice preg_replace() con el modificador de patrón
i
..
Si los parámetros search
y replace
son arrays, entonces la función str_ireplace()
tomará un valor de cada array y los utilizará para la búsqueda y
el reemplazo en subject
. Si el parámetro
replace
tiene menos valores que el parámetro
search
, entonces una chaîne de caractères vacía será utilizada
como valor para el resto de los valores de reemplazo. Si el parámetro
search
es un array y el parámetro
replace
es una chaîne de caractères, entonces esta chaîne de caractères
de reemplazo será utilizada para cada valor de search
.
Lo contrario no tiene sentido.
Si el parámetro search
o el parámetro
replace
son arrays, sus elementos son tratados
del primero al último.
search
El valor a buscar, conocido también como needle. Un array puede ser utilizado para designar múltiples needles.
replace
El valor de reemplazo utilizado para cada valor encontrado
en search
. Un array puede ser utilizado
para designar múltiples reemplazos.
subject
Una chaîne de caractères o un tableau en el que se realiza la búsqueda, también conocido como haystack.
Si subject
es un array, el reemplazo se
realiza en cada uno de los elementos del sujeto
subject
, y el valor devuelto es también un
array.
count
Si se proporciona, esta variable contendrá el número de reemplazos realizados.
Devuelve una cadena o un array de reemplazo.
Versión | Descripción |
---|---|
8.2.0 | Case folding no longer depends on the locale set with setlocale(). Only ASCII case folding will be done. Non-ASCII bytes will be compared by their byte value. |
Ejemplo #1 Ejemplo con str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
Nota: Esta función es segura binariamente.
Dado que la función str_ireplace() realiza los reemplazos de izquierda a derecha, puede reemplazar un valor previamente insertado durante un reemplazo múltiple. El ejemplo #2 de la documentación de la función str_replace() sobre cómo tratar esta problemática.