Свойство global

Статья
11/05/2008

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

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

rgExp.global

Аргументы

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

Заметки

Свойство global доступно только для чтения; оно возвращает значение true, если для регулярного выражения установлен глобальный флаг, и значение false в противном случае. Значением по умолчанию является false.

Глобальный флаг означает, что при поиске следует найти все вхождения шаблона в строке для поиска, а не только первое вхождение. Этот флаг также называется глобальным соответствием.

Пример

В следующем примере демонстрируется использование свойства 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