From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- .../global_objects/regexp/exec/index.html | 228 +++++++++++++++++++++ 1 file changed, 228 insertions(+) create mode 100644 files/ru/web/javascript/reference/global_objects/regexp/exec/index.html (limited to 'files/ru/web/javascript/reference/global_objects/regexp/exec') diff --git a/files/ru/web/javascript/reference/global_objects/regexp/exec/index.html b/files/ru/web/javascript/reference/global_objects/regexp/exec/index.html new file mode 100644 index 0000000000..fdd7c92041 --- /dev/null +++ b/files/ru/web/javascript/reference/global_objects/regexp/exec/index.html @@ -0,0 +1,228 @@ +--- +title: RegExp.prototype.exec() +slug: Web/JavaScript/Reference/Global_Objects/RegExp/exec +tags: + - JavaScript + - Method + - Prototype + - Reference + - RegExp + - регулярные выражения +translation_of: Web/JavaScript/Reference/Global_Objects/RegExp/exec +--- +
{{JSRef("Global_Objects", "RegExp")}}
+ +

Сводка

+ +

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

+ +

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

+ +

Синтаксис

+ +
regexObj.exec(str)
+ +

Параметры

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

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

+ +

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

+ +

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

+ +

Описание

+ +

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

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

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

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ОбъектСвойство/ИндексОписаниеПример
result[0]Все сопоставившиеся символы в строке.кайф, сплющь объём вши
[1], ...[n]Сопоставившиеся подстроки в круглых скобках, если они присутствуют. Количество возможных подстрок ничем не ограничено.[1] = сплющь
+ [2] = вши
indexИндекс сопоставления в строке, начинается с нуля.9
inputОригинальная строка.Эх, чужд кайф, сплющь объём вши, грызя цент.
relastIndexИндекс, с которого начнётся следующая попытка сопоставления. Если отсутствует флаг "g", остаётся равным нулю.31
ignoreCaseУказывает, что в регулярном выражении используется флаг игнорирования регистра "i".true
globalУказывает, что в регулярном выражении используется флаг глобального сопоставления "g".true
multilineУказывает, что в регулярном выражении используется флаг сопоставления по нескольким строкам "m".false
sourceТекст шаблона регулярного выражения.кайф,\s(сплющь).+?(вши)
+ +

Примеры

+ +

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

+ +

Если ваше регулярное выражение использует флаг "g", вы можете использовать метод exec() несколько раз для нахождения последовательных сопоставлений в одной и той же строке. Если вы сделаете это, поиск начнётся по подстроке строки str, начало которой определяется свойством {{jsxref("RegExp.lastIndex", "lastIndex")}} регулярного выражения (метод {{jsxref("RegExp.prototype.test()", "test()")}} также увеличивает свойство {{jsxref("RegExp.lastIndex", "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
+
+ +

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

+ +

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

+ +

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

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

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

+ +

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

+ + + + + + + + + + + + + + + + + + + + + + + + +
СпецификацияСтатусКомментарии
ECMAScript 3-е издание.СтандартИзначальное определение. Реализована в JavaScript 1.2.
{{SpecName('ES5.1', '#sec-15.10.6.21', 'RegExp.exec')}}{{Spec2('ES5.1')}} 
{{SpecName('ES6', '#sec-regexp.prototype.exec', 'RegExp.exec')}}{{Spec2('ES6')}} 
+ +

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

+ +
{{CompatibilityTable}}
+ +
+ + + + + + + + + + + + + + + + + + + +
ВозможностьChromeFirefox (Gecko)Internet ExplorerOperaSafari
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +
+ + + + + + + + + + + + + + + + + + + + + +
ВозможностьAndroidChrome для AndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Базовая поддержка{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}{{CompatVersionUnknown}}
+
+ +

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

+ + -- cgit v1.2.3-54-g00ecf