^regex::create[шаблон]
^regex::create[шаблон][опции поиска]
Шаблон - это строка с регулярным выражением, совместимым с PCRE (Perl compatible regular expressions). Частичный перевод описания PCRE приведен в «Приложение 4. Perl-совместимые регулярные выражения».
Предусмотрены следующие опции поиска:
i - не учитывать регистр;
x - игнорировать символы white space и разрешить #комментарий до конца строки;
s - символ $ считать концом всего текста (опция по умолчанию);
m - символ $ считать концом строки, но не всего текста;
U - инвертировать «жадность» квантификаторов (они становятся не «жадными», чтобы сделать их «жадными», необходимо поставить после них символ «?»); [3.3.0]
g - найти все вхождения строки (а не только первое);
n - вернуть число с количеством совпадений вместо таблицы;
' - вычислять значения столбцов prematch, match, postmatch.
Поскольку символы ^ и $ используются в Parser, в шаблоне вместо символа ^ используется строка ^^, а вместо символа $ - строка ^$ (см. «Литералы»).