global プロパティ

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

正規表現で使用する global フラグ (g) の状態を表すブール値を返します。

rgExp.global

引数

rgExp
必ず指定します。Regular Expression オブジェクトのインスタンスを指定します。

解説

global プロパティは読み取り専用で、正規表現のグローバルフラグが設定されているときは true を返し、設定されていないときは false を返します。既定値は false です。

global フラグを使用すると、検索文字列内のパターンの最初の 1 候補だけではなく、すべての候補を検索できます。これはグローバルマッチングとも呼びます。

使用例

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