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(
    mixed $search,
    mixed $replace,
    mixed $subject,
    int &$count = ?
): mixed

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

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%>");
echo 
$bodytag// <body text=black>
?>

Notas

Nota: Esta función es segura binariamente.

Precaución

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