global 屬性

發行項
08/21/2008

更新：2007 年 11 月

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

 rgExp.global

引數

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

備註

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

若使用全域旗標，表示搜尋功能應該在搜尋字串中將發生的每一次模式的項目找出來，而不只是只找出第一次。這也稱為全域模式比對。

範例

以下範例說明 global 屬性的用法。

function RegExpPropDemo(re : RegExp) {
   print("Regular expression: " + re);
   print("global:     " + re.global);
   print("ignoreCase: " + re.ignoreCase);
   print("multiline:  " + re.multiline);
   print();
};

// Some regular expression to test the function.
var re1 : RegExp = new RegExp("the","i");  // Use the constructor.
var re2 = /\w+/gm;                         // Use a literal.
RegExpPropDemo(re1);
RegExpPropDemo(re2);
RegExpPropDemo(/^\s*$/im);

本程式的輸出為：

Regular expression: /the/i
global:     false
ignoreCase: true
multiline:  false

Regular expression: /\w+/gm
global:     true
ignoreCase: false
multiline:  true

Regular expression: /^\s*$/im
global:     false
ignoreCase: true
multiline:  true