multiline-Eigenschaft

Aktualisiert: November 2007

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

rgExp.multiline

Argumente

rgExp
Erforderlich. Eine Instanz eines Regular Expression-Objekts.

Hinweise

Die multiline-Eigenschaft ist schreibgeschützt und gibt true zurück, wenn das multiline-Flag für einen regulären Ausdruck gesetzt ist, andernfalls wird false zurückgegeben. Die multiline-Eigenschaft ist true, wenn das Regular Expression-Objekt mit dem m-Flag erstellt wurde. Der Standardwert ist false.

Wenn multiline den Wert false hat, stimmt "^" mit der Position am Anfang einer Zeichenfolge und "$" mit der Position am Ende einer Zeichenfolge überein. Wenn multiline den Wert true hat, stimmt "^" sowohl mit der Position am Anfang einer Zeichenfolge als auch mit der Position nach einem "\n" oder "\r" überein, und "$" stimmt sowohl mit der Position am Ende einer Zeichenfolge als auch mit der Position vor einem "\n" oder "\r" überein.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung der multiline-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