str_ireplace – PHP String Functions

Syntax :

Description :

str_ireplace() function will replace all occurrences of the search string with the replacement string. It is case – insensitive function.

This function works by the following rules:

• If the string to be searched is an array, it returns an array
• If the string to be searched is an array, find and replace is performed with every array element
• If both find and replace are arrays, and replace has fewer elements than find, an empty string will be used as replace
• If find is an array and replace is a string, the replace string will be used for every find value

Parameter :

• find – This is a Required parameter. It sets values to find.
• replace – This is a Required parameter. It sets values to replace.
• string – This is a Required parameter. It sets string to search.
• count – This is an Optional parameter. If passed, this will be set to the number of replacements performed.

Output :

This will return string or an array with replaced values.

ChangeLog :

[table caption=”” width=”100%” colwidth=”50%|50%” colalign=”left|left”]
Version, Description
PHP 5.0 , The count parameter was added.

[/table]

Related articles : str_replace(), preg_replace, strtr().

str_ireplace() – PHP Functions Example 1 :

<?php
// below statement will replace the Hi word with Hello."
$strExample = "Hi from tutorialmines!"; 
echo str_ireplace("Hi","Hello",$strExample);
?>

In above example ,We have a string “Hi from tutorialmines! “. Now this function will replace the value “Hi” with “Hello” value in the string. Output of above code in the browser is as below:

str_ireplace() – PHP Functions Example 2 :

<?php
$arr = array("january","febuary","march","april");
print_r(str_ireplace("Febuary","Month-2",$arr,$i)); // This function is case-insensitive
echo "Replacements: $i";
?>

In above example ,We have an array of strings “january”,”febuary”,”march”,”april”. Now this function will replace the value in array “Febuary” with “Month-2” value in the string. Output of above code in the browser is as below:

str_ireplace() – PHP Functions Example 3 :  less elements in replace than find

<?php
$strArr = array("january","febuary","march","april");
$find = array("januaRy","Febuary",""); // Case-insensitive
$replace = array("first replacement","second replacement");
print_r(str_ireplace($find,$replace,$strArr,$count));
echo "<br/>Numbers of replacements done are - ".$count;
?>

In above example ,We have an array of strings “january”,”febuary”,”march”,”april”.

Now this function will find the value in array “januaRy”,”Febuary”,””. and replace them with “”first replacement”,”second replacement”” values. Output of above code in the browser is as below: