Свойство multiline

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает логическое значение, указывающее состояние флага "multiline" (m), используемого с регулярным выражением.

rgExp.multiline

Аргументы

rgExp
Обязательный. Экземпляр объекта Regular Expression.

Заметки

Свойство multiline предназначено только для чтения, оно возвращает значение true, если флаг "multiline" установлен для регулярного выражения, и значение false, если этот флаг не установлен. Свойство multiline равно значению true, если объект регулярного выражения создан с флагом m. Значением по умолчанию является 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