^строка.match[шаблон]
^строка.match[шаблон][опции поиска]
Осуществляет поиск в строке по шаблону.
Шаблон - это строка с регулярным выражением, совместимым с PCRE (Perl compatible regular expressions) или объект класса regex [3.4.0].
Частичный перевод описания PCRE приведен в Приложении 4.
Предусмотрены следующие опции поиска:
i - не учитывать регистр;
x - игнорировать символы white space и разрешить #комментарий до конца строки;
s - символ $ считать концом всего текста (опция по умолчанию);
m - символ $ считать концом строки, но не всего текста;
U - инвертировать «жадность» квантификаторов (они становятся не «жадными», чтобы сделать их «жадными» необходимо поставить после них символ ?); [3.3.0] g - найти все вхождения строки (а не только первое);
n - вернуть число с количеством совпадений вместо таблицы; [3.2.2] u - unicode; [3.4.2] ' - вычислять значения столбцов prematch, match, postmatch.
Поскольку символы ^ и $ используются в Parser, в шаблоне вместо символа ^ используется строка ^^, а вместо символа $ - строка ^$ (см. Литералы).
Если указана опция поиска g, будет создана таблица (объект класса table) найденного по шаблону (по одной строке на каждое вхождение). Если опция g не была указана, то таблица будет содержать лишь одну строку с первым вхождением. Если не было найдено ни одного совпадения, то результатом операции будет пустая таблица. Если указана опция nто вместо таблицы с результатами будет возвращаться число - количество найденных совпадений.
Таблица совпадений имеет следующие столбцы: 1, 2,…, n, prematch, match, postmatch,
где:
prematch столбец с подстрокой от начала строки до совпадения
matchстолбец с подстрокой, совпавшей с шаблоном
postmatchстолбец с подстрокой, следующей за совпавшей подстрокой до конца строки
1, 2,…, nстолбцы с подстроками, соответствующими фрагментам шаблона, заключенным в круглые скобки, n - номер открывающей круглой скобки.
Замечание 1: значения столбцов prematch, match, postmatchвычисляются только если указана опция '. Замечание 2: начения столбцов 1, 2,…, n вычисляются лишь в случае, если в шаблоне указаны круглые скобки.
Замечание 3: если в шаблоне вам нужно использовать круглые скобки, но не требуется запоминания заключённого в них в результирующей таблице, то вместо них лучше использовать конструкцию (?:)
Примеры использования
$str[www.parser.ru?user=admin]
^if(^str.match[
\? #есть разделитель
.+ #и есть хоть что-то за ним
][x]){Есть совпадение}{Совпадений нет}
Выведет на экран: Есть совпадение.
Внимание: настоятельно советуем задавать комментарии к частям сложного регулярного выражения. Бывает, что даже вам самим через какое-то время бывает трудно в них разобраться. Для этого включите опцию x, разрешающую расширенный синтаксис выражений, допускающий комментарии.
$str[www.parser.ru?user=admin]
$mtc[^str.match[(\?.+)][']]
^mtc.save[match.txt]
Создаст файл match.txt, содержащий такую таблицу: