global-Eigenschaft

Aktualisiert: November 2007

Gibt einen booleschen Wert zurück, der den Zustand des mit einem regulären Ausdruck verwendeten global-Flags (g) angibt.

rgExp.global

Argumente

  • rgExp
    Erforderlich. Eine Instanz eines Regular Expression-Objekts.

Hinweise

Die global-Eigenschaft ist schreibgeschützt und gibt true zurück, wenn das global-Flag für einen regulären Ausdruck gesetzt ist, andernfalls wird false zurückgegeben. Der Standardwert ist false.

Falls verwendet, gibt das global-Flag an, dass bei einer Suche alle Vorkommen des Musters in der zu durchsuchenden Zeichenfolge gesucht werden sollen, und nicht nur das erste. Dies nennt man auch "globale Suche".

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der global-Eigenschaft.

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);

Ausgabe dieses Programms:

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

Anforderungen

Version 5.5

Betrifft:

Regular Expression-Objekt

Siehe auch

Konzepte

Syntax regulärer Ausdrücke

Referenz

ignoreCase-Eigenschaft

multiline-Eigenschaft