Note
	это сокращенная ссылка на функции POSIX API, они предназначены для совместимости с другими библиотеками, а не как API для использования в новом коде (если вам не нужен доступ с языка, отличного от C++). Эта версия этих функций также должна счастливо сосуществовать с другими версиями, поскольку используемые имена являются макросами, которые расширяются до фактических названий функций.

#include <boost/cregex.hpp>

или:

#include <boost/regex.h>

Следующие функции доступны для пользователей, которым нужна библиотека POSIX, совместимая с C, они доступны как в версиях Unicode, так и в версиях с узкими символами, стандартные имена POSIX API - это макросы, которые расширяются до одной версии или другой в зависимости от того, определен UNICODE или нет.

	Important
	Обратите внимание, что все символы, определенные здесь, при использовании в программах C++ заключены внутри пространства имен<boost>, если вы не используете вместо этого<#include<boost/regex.h>>- в этом случае символы все еще определены в пространстве имен, но также доступны в глобальном пространстве имен.

Функции определяются как:

extern "C" {
struct regex_tA;
struct regex_tW;
int regcompA(regex_tA*, const char*, int);
unsigned int regerrorA(int, const regex_tA*, char*, unsigned int);
int regexecA(const regex_tA*, const char*, unsigned int, regmatch_t*, int);
void regfreeA(regex_tA*);
int regcompW(regex_tW*, const wchar_t*, int);
unsigned int regerrorW(int, const regex_tW*, wchar_t*, unsigned int);
int regexecW(const regex_tW*, const wchar_t*, unsigned int, regmatch_t*, int);
void regfreeW(regex_tW*);
#ifdef UNICODE
#define regcomp regcompW
#define regerror regerrorW
#define regexec regexecW
#define regfree regfreeW
#define regex_t regex_tW
#else
#define regcomp regcompA
#define regerror regerrorA
#define regexec regexecA
#define regfree regfreeA
#define regex_t regex_tA
#endif
}

Все функции работают на структуре regex_t, которая выявляет двух публичных членов:

	Note
	<regex_t>на самом деле является<#define>- это либо<regex_tA>или<regex_tW>в зависимости от того, определено<UNICODE>или нет,<TCHAR>или<char>или<wchar_t>снова в зависимости от макроса<UNICODE>.

regcomp

<regcomp>берет указатель на<regex_t>, указатель на выражение для компиляции и параметр флагов, который может быть комбинацией:

regerror

Regerror принимает следующие параметры, он отображает код ошибки в читаемую строку человека:

Если код ошибки OR'ed с REG_ITOA, то сообщение, которое приводит к результату, является напечатанным именем кода, а не сообщением, например "REG_BADPAT". Если код REG_ATIO, то e не должен быть нулевым, а e->re_pend должен указывать на печатаемое имя кода ошибки, то значение возврата - это значение кода ошибки. Для любого другого значения кода значение возврата - это количество символов в сообщении об ошибке, если значение возврата больше или равно размеру buf_size, то повторная регистрация должна быть вызвана снова с большим буфером.

regexec

regexec находит первое появление выражения e в строке buf. Если len не равен нулю, то*mзаполняется тем, что соответствует обычному выражению, m<boost>содержит то, что соответствует всей строке, m<#include<boost/regex.h>>первое подвыражение и т.д., см. regmatch_t в объявлении файла заголовка для более подробной информации. Параметр eflags может быть комбинацией:

regfree

<regfree>освобождает всю память, которая была выделена regcomp.