array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.str-ireplace.php', 1 => 'str_ireplace', 2 => 'Versión insensible a mayúsculas y minúsculas de str_replace', ), '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', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplace — Versión insensible a mayúsculas y minúsculas de str_replace()

Descripción

str_ireplace(
    array|string $search,
    array|string $replace,
    string|array $subject,
    int &$count = null
): string|array

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 ..

Parámetros

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 string 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 string, entonces esta string 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 string o un array 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.

Valores devueltos

Devuelve una cadena o un array de reemplazo.

Historial de cambios

Versión Descripción
8.2.0 El case folding ya no depende de la configuración local definida con setlocale(). Solo se realizará el case folding ASCII. Los octetos no-ASCII serán comparados por su valor de octeto.

Ejemplos

Ejemplo #1 Ejemplo con str_ireplace()

<?php
$bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>");
echo $bodytag; // <body text=black>
?>

Notas

Nota: Esta función es segura para sistemas binarios.

Precaución

Orden de reemplazo

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.

Ver también