array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.str-ireplace.php', 1 => 'str_ireplace', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funciones de strings', ), 'prev' => array ( 0 => 'function.str-increment.php', 1 => 'str_increment', ), 'next' => array ( 0 => 'function.str-pad.php', 1 => 'str_pad', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/strings/functions/str-ireplace.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.