関数の概要
str_ireplace は、PHPの文字列置換関数の一つで、大文字・小文字を区別せずに指定した文字列を別の文字列に置換します。通常の str_replace と違い、置換対象の文字列の大文字小文字を無視して動作するため、ケースセンシティブな文字列操作が不要な場合に便利です。
パラメータの説明
- search（文字列|配列）: 置換対象となる文字列、または文字列の配列を指定します。
- replace（文字列|配列）: 置換後の文字列、または文字列の配列を指定します。
- subject（文字列|配列）: 置換を行う元の文字列、または文字列の配列。
- &count（整数・省略可能）: 実際に置換が行われた回数を受け取る変数への参照。
戻り値
置換後の文字列を返します。subjectが配列の場合は、配列の各要素について置換を行った結果の配列が返されます。
使用例
基本的な使い方
<?php
$text = "Hello World!";
$result = str_ireplace("hello", "Hi", $text);
echo $result; // 結果: "Hi World!"
?>
「hello」を「Hi」に置換していますが、大文字・小文字を無視して置換が行われます。
複数の文字列を同時に置換する
<?php
$text = "Apples and apples are tasty.";
$search = ["apples", "tasty"];
$replace = ["oranges", "delicious"];
$result = str_ireplace($search, $replace, $text);
echo $result; // 結果: "Oranges and oranges are delicious."
?>
複数の置換対象を配列で指定し、それぞれ別の文字列に置換しています。
置換回数を取得する
<?php
$text = "PHP is fun. php is popular.";
$count = 0;
$result = str_ireplace("php", "PHP", $text, $count);
echo $result; // 結果: "PHP is fun. PHP is popular."
echo "<br>置換回数: " . $count; // 結果: 2
?>
置換された回数を $count 変数で取得できます。
関連する関数
str_replace– 大文字小文字を区別して文字列を置換preg_replace– 正規表現を使った文字列置換strstr– 指定文字列が含まれているか判定（大文字小文字指定可能）
まとめ
str_ireplace は大文字・小文字の違いを気にせずに文字列を置換したいときに非常に便利な関数です。用途に応じて str_replace と使い分けることで、柔軟な文字列操作が可能になります。また、配列を使った一括置換や置換回数の取得もサポートしているため、実務でも多用される基本的かつ重要な関数です。
