diff --git a/functions/strings.xml b/functions/strings.xml
index 32cfd80ec7..f3d5199436 100644
--- a/functions/strings.xml
+++ b/functions/strings.xml
@@ -2944,28 +2944,49 @@ print $str; # Prints MARY HAD A LITTLE LAMB AND SHE LOVED IT SO
str_replace
- Replace all occurrences of needle in haystack with str
+ Replace all occurrences of the search string in subject with the replacement string
Description
- string str_replace
- string needle
- string str
- string haystack
+ mixed str_replace
+ mixed search
+ mixed replace
+ mixed subject
- This function replaces all occurences of
- needle in haystack
- with the given str. If you don't need
- fancy replacing rules, you should always use this function
- instead of ereg_replace.
+ This function replaces all occurences of search in
+ subject with the given
+ replace value. If you don't need fancy replacing
+ rules, you should always use this function instead of
+ ereg_replace or
+ preg_replace.
+
+ In PHP 4.0.5 and later, every parameter to
+ str_replace can be an array.
+
+
+ If subject is an array, then the search and replace
+ is performed on every entry of subject, and the
+ return value is an array as well.
+
+
+ If search and replace are
+ arrays, then str_replace takes a value from each
+ array and uses them to do search and replace on
+ subject. If replace has
+ fewer values than search, then an empty string is
+ used for the rest of replacement values. If search
+ is an array and replace is a string; then this
+ replacement string is used for every value of
+ search. The converse would not make sense, though.
+
- <function>Str_replace</function> example
+ <function>str_replace</function> example
$bodytag = str_replace ("%body%", "black", "<body text=%body%>");
@@ -2976,13 +2997,13 @@ $bodytag = str_replace ("%body%", "black", "<body text=%body%>");
- Str_replace was added in PHP 3.0.6, but was
+ str_replace was added in PHP 3.0.6, but was
buggy up until PHP 3.0.8.
- See also ereg_replace and
- strtr.
+ See also ereg_replace,
+ preg_replace, and strtr.