(PHP 5, PHP 7, PHP 8)
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.
search
El 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.
subject
El 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.
count
Si 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.