str_replace

(PHP 3 = 3.0.6, PHP 4 )

str_replace -- 文字列 subject 中の文字列 search を全て文字列replaceに置換する

説明

mixed str_replace ( mixed search, mixed replace, mixed subject)

この関数は、 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 の各値について使用されます。しかし、 逆は意味がありません。

例 1 str_replace() の例

$bodytag = str_replace ("%body%", "black", " body text=%body% ");


この関数はバイナリでも使用可能です。

str_replace() は PHP 3.0.6 で追加されましたが、 PHP 3.0.8 まではバグがありました。

ereg_replace() preg_replace() strtr() も 参照下さい。