Сводка

Методexec() выполняет поиск сопоставления регулярного выражения в указанной строке. Возвращает массив с результатами илиnull.

Если целью выполнения является просто определить, проходит оно или нет, используйте методRegExp.prototype.test(), либо метод строкиString.prototype.search().

Синтаксис

regexObj.exec(str)

Параметры

str

Строка, с которой производится сопоставление регулярного выражения.

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

Если сопоставление успешно выполнилось, методexec() возвращает массив и обновляет свойства объекта регулярного выражения. Возвращаемый массив в первом элементе содержит сопоставленный текст, а в последующих элементах — текст, захваченный при сопоставлении круглыми скобками.

Если сопоставление не удалось, методexec() возвращаетnull.

Описание

Рассмотрим следующий пример:

// Сопоставляется с фразой «кайф, сплющь», за которой следует слово «вши»,// игнорируя любые символы между ними. Запоминает слова «сплющь» и «вши».// Игнорирует регистр символов.var re = /кайф,\s(сплющь).+?(вши)/gi;var result = re.exec("Эх, чужд кайф, сплющь объём вши, грызя цент.");

Таблица ниже показывает результаты выполнения данного примера:

Примеры

Пример: поиск последовательных сопоставлений

Если ваше регулярное выражение использует флаг"g", вы можете использовать методexec() несколько раз для нахождения последовательных сопоставлений в одной и той же строке. Если вы сделаете это, поиск начнётся по подстроке строкиstr, начало которой определяется свойствомlastIndex регулярного выражения (методtest() также увеличивает свойствоlastIndex). Например, предположим, что у вас есть следующий скрипт:

var myRe = /аб*/g;var str = "аббвгдеабж";var myArray;while ((myArray = myRe.exec(str)) !== null) {  var msg = "Найдено " + myArray[0] + ". ";  msg += "Следующее сопоставление начнётся с позиции " + myRe.lastIndex;  console.log(msg);}

Этот скрипт выведет следующий текст:

Найдено абб. Следующее сопоставление начнётся с позиции 3Найдено аб. Следующее сопоставление начнётся с позиции 9

Примечание: не помещайте литерал регулярного выражения (или конструкторRegExp) внутрь условияwhile; это приведёт к бесконечному циклу, поскольку свойствоlastIndex будет сбрасываться в ноль на каждой итерации цикла. Также убедитесь, что установлен флаг глобального сопоставления, в противном случае цикл будет бесконечным.

Пример: использование методаexec() вместе с литералами регулярного выражения

Вы можете использовать методexec() без создания объектаRegExp:

var matches = /(привет \S+)/.exec("Это привет миру!");console.log(matches[1]);

Скрипт выведет в журнал строку «привет миру!».

Спецификации

Совместимость с браузерами

Смотрите также

• Глава прорегулярные выражения вруководстве по JavaScript
• RegExp