multiline 屬性

發行項
08/21/2008

更新：2007 年 11 月

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

 rgExp.multiline

引數

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

備註

multiline 屬性是唯讀的，如果已設定規則運算式的 multiline 旗標，就會傳回 true，否則會傳回 false。如果是以 m 旗標建立規則運算式物件，multiline 屬性為 true。預設值為 false。

如果 multiline 是 false，「^」會比對字串的開始位置，而「$」則會比對字串的結束位置。如果 multiline 是 true，「^」會比對字串的開始位置，以及「\n」或「\r」之後的位置；而「$」則會比對字串的結束位置，以及「\n」或「\r」之前的位置。

範例

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

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