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 が同じ文字列に置き換えられます。

注意: すべての 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() も参照ください。