Редактирование: Модуль:String/doc (раздел)

== match ==
Функция возвращает часть целевой строки, которая соответствует заданной строке.

; Использование

: <Code><nowiki>{{#invoke:</nowiki>String|match|''исходная_строка''|''заданная_строка''|''начальный_индекс''|''номер_совпадения''|''true{{\}}false''|''значение_если_нет_совпадений''}}</Code>

: или

: <Code><nowiki>{{#invoke:</nowiki>String|match|s= ''исходная_строка'' |pattern= ''заданная_строка'' |start= ''начальный_индекс''|match= ''номер_совпадения''|plain= ''true{{\}}false'' |nomatch= ''значение_если_нет_совпадений'' }}</Code>

; Параметры
{|
|{{Code|s}}:
|Целевая строка, часть которой необходимо найти.
|-
|{{Code|pattern}}:
|Строка, совпадение с которой необходимо найти в целевой строке.
|-
|{{Code|start}}:
|Порядковый номер символа, начиная с которого необходимо произвести поиск совпадения. По умолчанию — {{Code|1}}. Если начиная с заданного символа совпадений не найдено, функция возвращает сообщение об ошибке.
|-
|{{Code|match}}:
|В некоторых случаях может оказаться несколько совпадений с заданной строкой в одной целевой строке. Параметр задает номер совпадения, которое необходимо вывести. Если параметру присвоено отрицательное значение, то оно распознается модулем как порядковый номер совпадения, отсчитываемый с конца строки. Другими словами, значение {{Code|-1}} распознается модулем как порядковый номер последнего совпадения в строке. По умолчанию — 1.
|-
|{{Code|plain}}:
|Если параметру присвоено значение {{Code|true}}, функция воспринимает заданную строку как обычный текст, а не [[mw:Extension:Scribunto/Lua reference manual#Patterns|регулярное выражение]]. По умолчанию — {{Code|false}}.
|-
|{{Code|nomatch}}:
|Последовательность символов, выводимая строкой в случае отсутствия совпадений вместо сообщения об ошибке.
|}
Если введённый индекс по модулю больше длины целевой строки или совпадений найдено меньше, чем число, заданное в параметре {{Code|match}}, то выводится сообщение об ошибке.
Если добавить параметр {{Code|ignore_errors{{=}}true}}, то вместо любого из сообщений об ошибке будет возвращена пустая строка.

Подробнее о [[Регулярное выражение|регулярных выражениях]], используемых в [[Lua]], см. [[mw:Extension:Scribunto/Lua reference manual#Patterns|Руководство по метасимволам]].