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:
- $searchVal: This parameter can be of both string and array types. This parameter specifies the string to be searched and replaced.
- $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.
- $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.
- $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 occurrences 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.
<?php // Input string $subjectVal="how are you"; // using str_ireplace() function $res = str_ireplace("are", "is", $subjectVal); echo $res; ?> |
Output:
how is you
Program 2:
<?php // Input string $subjectVal="Geeks are Geeks"; // using str_ireplace() function $res = str_ireplace("are", "for", $subjectVal); echo $res; ?> |
Output:
Geeks for Geeks
Reference:
http://php.net/manual/en/function.str-ireplace.php
