この関数は、subject の中の search を全て replace に置換します。技巧的な置換ルールを 必要としない場合、ereg_replace() または preg_replace()の替わりにこの関数を常用するべき です。
PHP 4.0.5 以降では、str_replace() への全てのパ ラメータは配列とすることが可能です。
subject が配列の場合、 subject の各エントリについて検索と置換が行 われ、返り値は同様に配列となります。
search と replace が配列の場合、str_replace() は各配列から値を一 つとりだし、subject 上で検索と置換を行うた めに使用します。replace の値が search よりも少ない場合、置換される値の残 りの部分には空の文字列が使用されます。 search が配列で replaceが文字列の場合、この置換文字列が search の各値について使用されます。しかし、 逆は意味がありません。
この関数はバイナリでも使用可能です。
str_replace() は PHP 3.0.6 で追加されましたが、 PHP 3.0.8 まではバグがありました。
ereg_replace()、 preg_replace()、strtr() も 参照下さい。