この関数は、
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()
も 参照下さい。