Чтение онлайн

Синтаксис литерала

Конструктор

Аргументы

шаблон Строка, задающая шаблон регулярного выражения или другое регулярное выражение.

атрибуты Необязательная строка, содержащая любые из атрибутов «g», «і» и «т», задающих глобальный, нечувствительный к регистру и многострочный поиск, соответственно. До выхода стандарта ECMAScript атрибут «m» не был доступен. Если аргумент шаблон - это регулярное выражение, а не строка, аргумент атрибуты может отсутствовать.

Возвращаемое

значение

Возвращается новый объект RegExp с указанными шаблоном и атрибутами. Если аргумент шаблон представляет собой регулярное выражение, а не строку, конструктор

создаст новый объект , используя тот же шаблон и атрибуты, что и в указанном объекте . Если вызывается как функция (без оператора ), то ведет себя так же, как при вызове с оператором , кроме случая, когда шаблон уже является объектом ; тогда функция возвращает аргумент шаблон, а не создает новый объект .

Исключения

Генерируется, если шаблон не является допустимым регулярным выражением или если аргумент атрибуты содержит символы, отличные от «g», «і» и «т».

Генерируется, если шаблон - это объект и аргумент атрибуты не

опущен.

Свойства экземпляра

Методы

Описание

Объект

представляет регулярное выражение - мощное средство для поиска в строках по шаблону. Синтаксис и применение регулярных выражений полностью описаны в главе 10.

См. также

Глава 10

универсальный поиск по шаблону

Синтаксис

Аргументы

строка Строка, в которой выполняется поиск.

Возвращаемое значение

Массив, содержащий результаты поиска или значение null, если соответствия не найдено. Формат возвращаемого массива описан далее.

Исключения

Генерируется, если метод вызывается для объекта, не являющегося объектом .

Описание

Метод

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

Метод

ищет в строке текст, соответствующий выражению . И если находит, то возвращает массив результатов; в противном случае возвращается значение null. Элемент 0 полученного массива представляет собою искомый текст. Элемент 1 - это текст, соответствующий первому подвыражению в скобках внутри , если оно есть. Элемент 2 соответствует второму подвыражению и т. д. Свойство массива, как обычно, определяет количество элементов в массиве. В дополнение к элементам массива и свойству значение, возвращаемое имеет еще два свойства. Свойство указывает позицию первого символа искомого текста. Свойство ссылается на строку. Этот возвращаемый массив совпадает с массивом, возвращаемым методом когда он вызывается для неглобального объекта .

Когда метод

вызывается для неглобального шаблона, он выполняет поиск и возвращает описанный выше результат. Однако если – глобальное регулярное выражение, ведет себя несколько сложнее. Он начинает поиск в строке с символьной позиции, заданной свойством . Найдя соответствие, метод устанавливает свойство равным позиции первого символа после найденного соответствия. Это значит, что можно вызвать несколько раз, чтобы выполнить цикл по всем соответствиям в строке. Если метод больше не находит соответствий, он возвращает значение null и сбрасывает свойство в ноль. Начиная поиск непосредственно после успешного нахождения соответствия в другой строке, необходимо соблюдать внимательность и вручную установить свойство равным нулю. Обратите внимание: всегда включает полную информацию для найденного соответствия в возвращаемый им массив независимо от того, является глобальным шаблоном или нет. Этим отличается от метода , который возвращает намного меньше информации при работе с глобальными шаблонами. Вызов в цикле - единственный способ получить полную информацию о результатах поиска для глобального шаблона.

Пример

Для нахождения всех соответствий в строке метод

можно вызывать в цикле:

См. также

RegExp.lastlndex, RegExp.test, String.match, String.replace, String.search; глава 10

выполняется ли глобальный поиск по данному регулярному выражению

<