Шрифт:
Выполняет откомпилированное регулярное выражение в
*preg
в строке string eflags
контролирует способ выполнения; ее значение равно 0 или побитовому ИЛИ одного или более флагов из табл. 12.8. Вскоре мы обсудим другие аргументы.
size_t regerror(int errcode, const regex_t *preg,
char *errbuf, size_t errbuf_size)
Преобразует ошибку, возвращенную
regcomp
или regexec
, в удобочитаемую строку.
void regfree(regex_t *preg)
Освобождает динамическую память, используемую откомпилированным регулярным выражением в
*preg
. Заголовочный файл
<regex.h>
определяет ряд флагов. Некоторые используются с regcomp
; другие используются с regexec
. Однако, все они начинаются с префикса 'REG_
'. В табл. 12.7 перечислены флаги для компиляции регулярных выражений с помощью regcomp
. Таблица 12.7. Флаги для
regcomp
| Константа | Значение |
|---|---|
| REG_EXTENDED | Использовать расширенные регулярные выражения. По умолчанию используются базовые регулярные выражения |
| REG_ICASE | Сопоставление regexec игнорирует регистр символов |
| REG_NEWLINE | Операторы, заменяющие любой символ, не включают символ конца строки |
| REG_NOSUB | Информация о начале и конце вложенною шаблона не требуется (см текст) |
Флаги для сопоставления регулярных выражений с помощью
regexec
приведены в табл. 12.8. Таблица 12.8. Флаги дли
regexec
| Константа | Значение |
|---|---|
| REG_NOTBOL | Оператор ^ (начало строки) не сопоставляется |
| REG_NOTEOL | Оператор $ (конец строки) не сопоставляется |
Флаги
REG_NEWLINE
, REG_NOTBOL
и REG_NOTEOL
взаимодействуют друг с другом. Это немного запутано, поэтому мы будем продвигаться небольшими шажками. • Когда в
cflags
не включен REG_NEWLINE
, символ конца строки действует в качестве обычного символа. С ним может быть сопоставлен метасимвол '.
' (любой символ), а также дополненные списки символов ('[^...]
'). При этом $
не сопоставляется немедленно с началом вставленного символа новой строки, а ^
не сопоставляется немедленно с его концом. • Когда в
eflags
установлен REG_NOTBOL
, оператор ^
не соответствует началу строки. Это полезно, когда параметр string
является адресом символа в середине сопоставляемого текста. • Сходным образом, когда в
eflags
установлен REG_NOTEOL
, оператор $
не соответствует концу строки. • Когда в
cflags
включен REG_NEWLINE
, то: • Символ конца строки не соответствует '
.
' или дополненному списку символов. • Оператор
^
всегда соответствует положению непосредственно за вставленным символом конца строки независимо от установки REG_BOL
. • Оператор
$
всегда соответствует положению непосредственно перед вставленным символом конца строки независимо от установки REG_EOL
. Когда вы осуществляете построчный ввод/вывод, как в случае с
grep
, можно не включать REG_NEWLINE
в cflags
. Если в буфере несколько строк, и каждую из них нужно рассматривать как отдельную, с сопоставлением ^
и $
, тогда следует включить REG_NEWLINE
. Структура
regex_t
по большей части непрозрачна. Код уровня пользователя может исследовать лишь один член этой структуры; остальное предназначено для внутреннего использования процедурами регулярных выражений:
typedef struct {
/* ...здесь внутренний материал... */
size_t re_nsub;
/* ...здесь внутренний материал... */
} regex_t;
В структуре
regmatch_t
есть по крайней мере два члена для использования кодом уровня пользователя:
typedef struct {
/* ...здесь возможный внутренний материал... */
regoff_t rm_so; /* Смещение начала вложенной строки в байтах */