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

# str_ireplace

(PHP 5)

str_ireplace -- 大文字小文字を区別しない str_replace()

## 説明

mixed str_ireplace ( mixed search, mixed replace, mixed subject [, int &count] )

この関数は、`subject` の中に現れるすべての `search`(大文字小文字を区別しない)を `replace` に置き換えた文字列あるいは配列を 返します。一般に、凝った置換ルールが必要ないのであれば、 eregi_replace() あるいは preg_replace() で `i` 修正子を 使用するかわりにこの関数を使用すべきです。

`subject` が配列の場合は、そのすべての要素に 対して検索と置換が行われ、返される結果も配列となります。

`search` および `replace` が配列の場合は、 str_ireplace() はそれぞれの配列から取り出した 値を使用して `subject` の置換を行います。 `replace` の要素数が `search` より少ない場合は、残りの要素は 空の文字列に置き換えられます。もし `search` が配列で `replace` が文字列だった場合は すべての `search` が同じ文字列に置き換えられます。

例 1. str_ireplace() の例

`<?php $bodytag = str_ireplace("%body%", "black", "<body text=%BODY%>"); ?>`

この関数はバイナリデータに対応しています。

> 注意: PHP 5.0.0 以降では、置き換えられた `needles` の数が、参照渡しのパラメータ `count` に返されます。 PHP 5.0.0 より前のバージョンではこのパラメータは使用できません。

str_replace()、 preg_replace() および strtr() も参照ください。

前のページ | ホーム | 次のページ
str_getcsv | 上に戻る | str_pad