PHP マニュアル
前のページ |  | 次のページ

# str_replace

(PHP 3>= 3.0.6, PHP 4 , PHP 5)

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() も 参照下さい。

前のページ | ホーム | 次のページ
str_repeat | 上に戻る | str_rot13