PHP | Función str_ireplace()

str_ireplace() es una función incorporada en PHP y se usa para reemplazar todas las ocurrencias de la string de búsqueda o array de strings de búsqueda por string de reemplazo o array de strings de reemplazo en la string o array dada respectivamente. Esta función realiza la búsqueda sin distinguir entre mayúsculas y minúsculas. Esta función es similar a la función str_replace() . La diferencia es que la función str_replace() distingue entre mayúsculas y minúsculas, mientras que str_ireplace() no lo es.

Sintaxis:

str_ireplace ( $searchVal, $replaceVal, $subjectVal, $count )

Parámetros : Esta función acepta cuatro parámetros de los cuales 3 son obligatorios y 1 es opcional. Todos estos parámetros se describen a continuación:

1. $searchVal : este parámetro puede ser de tipo string y array. Este parámetro especifica la string que se buscará y reemplazará.
2. $replaceVal : este parámetro puede ser de tipo string y array. Este parámetro especifica la string con la que queremos reemplazar la string $searchVal.
3. $subjectVal : este parámetro puede ser de tipo string y array. Este parámetro especifica la string o array de strings que queremos buscar $searchVal y reemplazar con $replaceVal.
4. $count : este parámetro es opcional y, si se pasa, su valor se establecerá en el número total de operaciones de reemplazo realizadas en la string $subjectVal.

Si los argumentos $searchVal y $replaceVal son arrays, todos los elementos del argumento $searchVal se buscan en la string $subjectVal y se reemplazan por los elementos correspondientes en el argumento $replaceVal. Si el número de elementos en $replaceVal es menor que el de la array $searchVal, entonces si hay elementos adicionales del argumento $searchVal en el argumento $subjectVal, se reemplazarán por una string vacía. Si el parámetro $subjectVal también es una array en lugar de una string, se buscarán todos los elementos de $subjectVal.

Valor devuelto: esta función devuelve una string o una array basada en el parámetro $subjectVal con valores reemplazados.

Ejemplos:

Input : $subjectVal = "How ARE you", $searcVal = "are"
        $replaceVal = "is"
        str_ireplace($searchVal,$replaceVal,$subjectVal);
Output : How is you 

Input : $subjectVal = "Geeks are Geeks", $searcVal = "are"
        $replaceVal = "for"
        str_ireplace($searchVal,$replaceVal,$subjectVal);
Output : Geeks for Geeks

Los siguientes programas ilustran la función str_ireplace() en PHP:

Programa 1: Este programa muestra que la función str_ireplace() no distingue entre mayúsculas y minúsculas.

<?php
  
// Input string
$subjectVal="how are you";
  
// using str_ireplace() function
$res = str_ireplace("are", "is", $subjectVal);
  
echo $res;
  
?>
  

Producción:

how is you

Programa 2:

<?php
  
// Input string
$subjectVal="Geeks are Geeks";
  
// using str_ireplace() function
$res = str_ireplace("are", "for", $subjectVal);
  
echo $res;
  
?>
  

Producción:

Geeks for Geeks

Referencia:
http://php.net/manual/en/function.str-ireplace.php