PHP str_replace() Function
Complete PHP String Reference
Definition and Usage
The str_replace() function replaces some characters with some other
characters in a string.
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
Syntax
|
str_replace(find,replace,string,count)
|
| Parameter |
Description |
| find |
Required. Specifies the value to find |
| replace |
Required. Specifies the value to replace the value in
find |
| string |
Required. Specifies the string to be searched |
| count |
Optional. A variable that counts the number of replacements |
Tips and Notes
Note: This function is case-sensitive. Use str_ireplace() to perform a
case-insensitive search.
Note: This function is binary-safe.
Example 1
<?php
echo str_replace("world","Peter","Hello world!");
?>
|
The output of the code above will be:
Example 2
In this example we will demonstrate str_replace() with an array and a count
variable:
<?php
$arr = array("blue","red","green","yellow");
print_r(str_replace("red","pink",$arr,$i));
echo "Replacements: $i";
?>
|
The output of the code above will be:
Array
(
[0] => blue
[1] => pink
[2] => green
[3] => yellow
)
Replacements: 1
|
Example 3
In this example we will demonstrate str_replace() with
less elements in replace than find:
<?php
$find = array("Hello","world");
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_replace($find,$replace,$arr));
?>
|
The output of the code above will be:
Array
(
[0] => B
[1] =>
[2] => !
)
|
Complete PHP String Reference

Need an easy way to get data into XML, or transform XML to another format?
MapForce lets you map XML data to/from any combination of XML, database, flat file, Excel 2007, XBRL, or Web services data.
Then it transforms data instantly or auto-generates royalty-free data integration code for recurrent conversions.
New features in Version 2010!
Download a free, fully functional 30-day trial to experience the following features:
- Easy-to-use, graphical data mapping interface
- Instant data transformation
- XSLT 1.0/2.0 and XQuery code generation
- Java, C#, and C++ code generation
- Advanced data processing functions
- Support for all major relational databases including SQL Server, IBM DB2, Oracle, and more
- Visual Studio & Eclipse integration
Download a fully-functional trial today!
|
|
|
|