Descripción
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.
Parámetros
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
subjectes un array, entonces la búsqueda y reemplazo se realiza con cada entrada desubjecty el valor devuelto también es un array. -
count -
Si es pasado, con éste parámetro se establece el número de reemplazos realizados.
Valores devueltos
Devuelve un string o un array de sustituciones.
Ejemplos
Ejemplo #1 Ejemplo de str_ireplace()
<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
?>
Notas
Nota: Esta función es segura binariamente.
Trampa en que se puede caer por el orden de reemplazo
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.
Ver también
- str_replace() - Reemplaza todas las apariciones del string buscado con el string de reemplazo
- preg_replace() - Realiza una búsqueda y sustitución de una expresión regular
- strtr() - Convierte caracteres o reemplaza substrings