(PHP 5, PHP 7)
str_ireplace — Versión insensible a mayúsculas y minúsculas de str_replace()
Esta función devuelve un string o un array con todas las apariciones de
search en subject
(ignorando mayúsculas y minúsculas) reemplazadas con el valor dado de replace.
Si no se necesitan reglas complicadas de reemplazo, en general se
puede utilizar esta función en lugar de
preg_replace() con el modificador i.
Sisearch y replace son
matrices, entonces str_ireplace() toma un valor de cada array
y lo utiliza para buscar y reemplazar en
subject. Si replace tiene menos
valores que search, entonces un string vacío es usado para
el resto de los valores de reemplazo. Si search es un
array y replace es un string, entonces este string de reemplazo es
usado para cada valor de search. Sin embargo,
lo contrario no tendría sentido.
Si search o replace
son arrays, sus elementos son procesados del primero al último.
searchEl valor a ser buscado, también conocida como la aguja. Un array puede ser utilizado para designar varias agujas.
replace
El valor de reemplazo que sustituye los valores encontrados de search.
Un array puede ser utilizado para designar reemplazos múltiples.
subjectEl string o array sobre el que se busca y se sustituye, también conocido como el pajar.
Si subject es un array, entonces la búsqueda y
reemplazo se realiza con cada entrada de
subject y el valor devuelto también es
un array.
countSi es pasado, con éste parámetro se establece el número de reemplazos realizados.
Devuelve un string o un array de sustituciones.
Ejemplo #1 Ejemplo de str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>
Nota: Esta función es segura binariamente.
Debido a que str_ireplace() reemplaza de izquierda a derecha, podría sustituir a un valor previamente insertado cuando se hacen sustituciones múltiples. El ejemplo #2 en la documentación de str_replace() demuestra como esto puede afectar en la práctica.