ignoreCase プロパティ

正規表現で使用する ignoreCase フラグ (i) の状態を表すブール値を返します。既定値は false です。読み取り専用です。

rgExp.ignoreCase

rgExp 参照は必ず指定し、RegExp オブジェクトのインスタンスを指定します。

解説

ignoreCase プロパティは、正規表現の ignoreCase フラグが設定されているときは true を返し、設定されていないときは false を返します。

ignoreCase フラグを使用すると、検索文字列内のパターンをマッチングさせるときに、大文字小文字の区別をしません。

使用例

ignoreCase プロパティの使用例を次に示します。次に示すように、関数に "i" を渡すと、先頭の "The" を含む、単語 "the" のすべてのインスタンスが単語の "a" に置換されます。これは、ignoreCase フラグを設定すると、検索で大文字小文字が無視されるためです。そのため、マッチングの際には "T" と "t" が同等に扱われます。

この関数は、使用可能な正規表現のフラグ g、i、および m と関連付けられているプロパティの状態を示す表の文字列を返します。置換されたすべての文字列も返します。

function RegExpPropDemo(flag){
   if (flag.match(/[^gim]/))        // フラグの妥当性をチェックします。
     return("指定されたフラグが無効です");
   var r, re, s                     // 変数を宣言します。
   var ss = "The man hit the ball with the bat.\n";
   ss += "while the fielder caught the ball with the glove.";
   re = new RegExp("the",flag);    // 検索パターンを指定します。
   r = ss.replace(re, "a");        // "the" を "a" で置換します。
   s = "Regular Expression property values:\n\n"
   s += "global  ignoreCase  multiline\n"
   if (re.global)                  // グローバル フラグをテストします。
     s += " True     ";
   else
     s += "False     ";
   if (re.ignoreCase)              // ignoreCase フラグをテストします。
     s += " True  ";
   else
     s += "False  ";
   if (re.multiline)               // multiline フラグをテストします。
     s += "     True     ";
   else
     s += "     False   ";
   s += "\n\nThe resulting string is:\n\n" + r;
   return(s);                      // 置換文字列を返します。
}

必要条件

バージョン 5.5

参照

global プロパティ | multiline プロパティ | 正規表現の構文

対象: RegExp オブジェクト