PHP | str_ireplace() Function

The str_ireplace() is a built-in function in PHP and is used to replace all the occurrences of the search string or array of search strings by replacement string or array of replacement strings in the given string or array respectively. This function performs the search in a case-insensitive manner. This function is similar to str_replace() function. The difference is that the str_replace() function is case-sensitive whereas str_ireplace() is not.

Syntax:

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

Parameters: This function accepts four parameters out of which 3 are mandatory and 1 is optional. All of these parameters are described below:

  1. $searchVal: This parameter can be of both string and array types. This parameter specifies the string to be searched and replaced.
  2. $replaceVal: This parameter can be of both string and array types. This parameter specifies the string with which we want to replace the $searchVal string.
  3. $subjectVal: This parameter can be of both string and array types. This parameter specifies the string or array of strings which we want to search for $searchVal and replace with $replaceVal.
  4. $count: This parameter is optional and if passed, it’s value will be set to the total number of replacement operations performed on the string $subjectVal.

If the $searchVal and the $replaceVal arguments are arrays, then all the elements of the $searchVal argument are searched in the $subjectVal string and replaced by the corresponding elements in the $replaceVal argument. If number of elements in $replaceVal is less than that in $searchVal array, then if there are any occurences of the additional elements of $searchVal argument in the $subjectVal argument then they will be replaced by an empty string. If the $subjectVal parameter is also an array instead of string then all of the elements of $subjectVal will be searched.

Return Value: This function returns a string or an array based on the $subjectVal parameter with replaced values.



Examples:

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

Below programs illustrate the str_ireplace() function in PHP:

Program 1: This program shows that the str_ireplace() function is case-insensitive.

filter_none

edit
close

play_arrow

link
brightness_4
code

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

chevron_right


Output:

how is you

Program 2:

filter_none

edit
close

play_arrow

link
brightness_4
code

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

chevron_right


Output:

Geeks for Geeks

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



My Personal Notes arrow_drop_up

Check out this Author's contributed articles.

If you like GeeksforGeeks and would like to contribute, you can also write an article using contribute.geeksforgeeks.org or mail your article to contribute@geeksforgeeks.org. See your article appearing on the GeeksforGeeks main page and help other Geeks.

Please Improve this article if you find anything incorrect by clicking on the "Improve Article" button below.




Article Tags :
Practice Tags :


Be the First to upvote.


Please write to us at contribute@geeksforgeeks.org to report any issue with the above content.