ignoreCase 屬性

發行項
08/12/2011

傳回布林值，該布林值表示規則運算式所使用之 ignoreCase 旗標 (i) 的狀態。

rgExp.ignoreCase

引數

rgExp
必要項。 規則運算式物件的執行個體。

備註

ignoreCase 的屬性是唯讀的，如果已設定規則運算式的 ignoreCase 旗標，就會傳回 true，否則傳回 false。預設值為 false。

若使用 ignoreCase 旗標，表示搜尋功能在搜尋字串內比對模式時應該不區分大小寫。

範例

以下範例示範 ignoreCase 屬性的用法。

下列範例說明 ignoreCase 屬性的使用方式。如果您將 gi 傳入下列顯示的函式，則會將所有的單字 "the" 全部取代成 "a" 這個字，包括句首的 "The"。這是因為設定 ignoreCase 旗標後，搜尋便會忽略任何大小寫。因此，就比對目的來說，"T" 與 "t" 相同。

這個函式會傳回布林值，這些布林值表示允許的規則運算式旗標 (包括 g、i 和 m) 的狀態。這個函式也會傳回已完成所有取代的字串。

function RegExpPropDemo(flag){
    // The flag parameter is a string that contains
    // g, i, or m.  The flags can be combined.

    // Check flags for validity.
    if (flag.match(/[^gim]/))
        {
        return ("Flag specified is not valid");
        }

    // Create the string on which to perform the replacement.
    var orig = "The batter hit the ball with the bat ";
    orig += "and the fielder caught the ball with the glove.";

    //Replace "the" with "a".
    var re = new RegExp("the", flag);
    var r = orig.replace(re, "a");        

    // Output the resulting string and the values of the flags.
    print("global: " + re.global.toString());
    print("ignoreCase: " + re.ignoreCase.toString());
    print("multiline: " + re.multiline.toString());
    print("Resulting String: " + r);
}

RegExpPropDemo("gi");
RegExpPropDemo("g");

下列是產生的輸出。

global: true
ignoreCase: true
multiline: false
Resulting String: a batter hit a ball with a bat and a fielder caught a ball with a glove.

global: true
ignoreCase: false
multiline: false
Resulting String: The batter hit a ball with a bat and a fielder caught a ball with a glove.