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