Espruino:Справочник по API/Класс String/match(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[https://www.espruino.com/Reference#l_String_match www.espruino.com - function String.match(substr)]</ref>=
=Функция String.match()<ref>[https://www.espruino.com/Reference#l_String_match www.espruino.com - function String.match(substr)]</ref>=
 
[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/match См. веб-документацию MDN].


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
String.match(substr)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


* '''substr''' – подстрока или регулярное выражение для поиска совпадений
==Возвращаемое значение==


Массив с совпадениями или null (см. ниже).


==Возвращаемое значение==
==Описание==


Ищет в исходной строке совпадения по подстроке или регулярному выражению, заданному в аргументе substr.


Если совпадений найдено не будет, возвращает null. Или:


==Описание==
<syntaxhighlight lang="javascript" enclose="div">
"abcdef".match("b") == [
  "b",        // 0-ой индекс массива – совпавшая строка
  index: 1,    // первый индекс совпадения
  input: "b"  // искомая строка
]
"abcdefabcdef".match(/bcd/) == [
  "bcd", index: 1,
  input: "abcdefabcdef"
]   
</syntaxhighlight>


''«Глобальный»'' поиск при помощи регулярного выражения просто вернет массив совпадений (без индексов):


<syntaxhighlight lang="javascript" enclose="div">
"abcdefabcdef".match(/bcd/g) = [
  "bcd",
  "bcd"
]
</syntaxhighlight>


== Примеры ==
== Примеры ==

Версия от 15:21, 28 февраля 2021

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция String.match()[1]

См. веб-документацию MDN.

Синтаксис

String.match(substr)

Параметры

  • substr – подстрока или регулярное выражение для поиска совпадений

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

Массив с совпадениями или null (см. ниже).

Описание

Ищет в исходной строке совпадения по подстроке или регулярному выражению, заданному в аргументе substr.

Если совпадений найдено не будет, возвращает null. Или:

"abcdef".match("b") == [
  "b",         // 0-ой индекс массива – совпавшая строка
  index: 1,    // первый индекс совпадения
  input: "b"   // искомая строка
 ]
"abcdefabcdef".match(/bcd/) == [
  "bcd", index: 1,
  input: "abcdefabcdef"
 ]

«Глобальный» поиск при помощи регулярного выражения просто вернет массив совпадений (без индексов):

"abcdefabcdef".match(/bcd/g) = [
  "bcd",
  "bcd"
 ]

Примеры

См.также

Внешние ссылки