この関数は、subject の中に現れるすべての
search(大文字小文字を区別しない)を
replace に置き換えた文字列あるいは配列を
返します。一般に、凝った置換ルールが必要ないのであれば、
eregi_replace() あるいは
preg_replace() で i 修正子を
使用するかわりにこの関数を使用すべきです。
subject が配列の場合は、そのすべての要素に
対して検索と置換が行われ、返される結果も配列となります。
search および
replace が配列の場合は、
str_ireplace() はそれぞれの配列から取り出した
値を使用して subject の置換を行います。
replace の要素数が
search より少ない場合は、残りの要素は
空の文字列に置き換えられます。もし search
が配列で replace が文字列だった場合は
すべての search が同じ文字列に置き換えられます。
注意: すべての
search配列による置換は、 直前の置換の結果に対して作用します。
この関数はバイナリデータに対応しています。
注意: PHP 5.0.0 以降では、置き換えられた
needlesの数が、参照渡しのパラメータcountに返されます。 PHP 5.0.0 より前のバージョンではこのパラメータは使用できません。
str_replace()、 preg_replace() および strtr() も参照ください。