PHP str_ireplace()関数

PHP String 参考手册PHP String リファレンスマニュアル

例

文字列 "Hello world!" 内の文字 "WORLD"(大文字と小文字を区別しない)を "Peter" に置き換える:

<?php
echo str_ireplace("WORLD","Peter","Hello world!");
?>

例を実行 »

定義と使い方

str_ireplace() 関数は、文字列内の一部の文字を置き換えます(大文字と小文字を区別しません)。

この関数は次のルールに従う必要があります:

  • 検索される文字列が配列の場合、配列を返します。
  • 検索される文字列が配列の場合、配列内の各要素を検索して置き換えます。
  • 配列の検索と置換を同時に行う必要があり、置換を実行する要素が検索された要素の数より少ない場合、余分な要素は空の文字列で置き換えられます。
  • 配列を検索するが、1つの文字列のみを置換する場合、置換文字列は検索されたすべての値に適用されます。

注:この関数は大文字と小文字を区別しません。使用してくださいstr_replace()関数は大文字と小文字を区別した検索を実行します。

注:この関数はバイナリセーフです。


構文

str_ireplace(find,replace,string,count)

パラメータ 説明
find 必須。検索する値を指定します。
replace 必須。find 内の値を置き換えるfind値を指定します。
string 必須。検索対象の文字列を指定します。
count 省略可能。置換回数をカウントする変数です。

技術詳細

戻り値: 置換値を含む文字列または配列を返します。
PHP バージョン: 5+
変更履歴: PHP 5.0 で、countパラメータが追加されました。


その他の例

例 1

配列と count 変数を使用した str_ireplace() 関数:

<?php
$arr = array("blue","red","green","yellow");
print_r(str_ireplace("RED","pink",$arr,$i)); // This function is case-insensitive
echo "Replacements: $i";
?>

例を実行 »

例 2

置換する要素が検索された要素より少ない str_ireplace() 関数を使用する:

<?php
$find = array("HELLO","WORLD"); // This function is case-insensitive
$replace = array("B");
$arr = array("Hello","world","!");
print_r(str_ireplace($find,$replace,$arr));
?>

例を実行 »


PHP String 参考手册PHP String リファレンスマニュアル その他の拡張機能