str_ireplace

(PHP 5, PHP 7, PHP 8)

str_ireplaceVersió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 chaîne de caractères 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 chaîne de caractères, entonces esta chaîne de caractères 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 chaîne de caractères o un tableau 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 Case folding no longer depends on the locale set with setlocale(). Only ASCII case folding will be done. Non-ASCII bytes will be compared by their byte value.

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

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

  • str_replace() - Reemplaza todas las ocurrencias en una string
  • preg_replace() - Buscar y reemplazar mediante expresión regular estándar
  • strtr() - Reemplaza caracteres en un string