# 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(
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

Si`search` 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