std::basic_regex

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека регулярных выражений

Классы

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Алгоритмы

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Итераторы

regex_iterator (C++11)

regex_token_iterator (C++11)

Исключения

regex_error (C++11)

Типы

regex_traits (C++11)

Константы

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

Грамматика регулярных выражений

Модифицированный ECMAScript-262 (C++11)

 

std::basic_regex

Функции-элементы

basic_regex::basic_regex

basic_regex::~basic_regex

basic_regex::operator=

basic_regex::assign

Наблюдатели

basic_regex::mark_count

basic_regex::flags

Локаль

basic_regex::getloc

basic_regex::imbue

Модификаторы

basic_regex::swap

Константы

Функции, не являющиеся элементами

swap(std::basic_regex)

Принципы вывода (C++17)

 

Определено в заголовочном файле <regex>
template <     class CharT = char,     class Traits = std::regex_traits<CharT> > class basic_regex;		(начиная с C++11)

Шаблон класса basic_regex предоставляет общую структуру для хранения регулярных выражений.

Предусмотрено несколько определений типов для распространённых типов символов:

Определены в заголовочном файле <regex>
Тип	Определение
std::regex	std::basic_regex<char>
std::wregex	std::basic_regex<wchar_t>

Типы-элементы

Тип элемент	Определение
value_type	CharT
traits_type	Traits
string_type	Traits::string_type
locale_type	Traits::locale_type
flag_type	std::regex_constants::syntax_option_type

Функции-элементы

(конструктор)	создаёт объект регулярного выражения (public функция-элемент)
(деструктор)	разрушает объект регулярного выражения (public функция-элемент)
operator=	присваивает содержимое (public функция-элемент)
assign	присваивает содержимое (public функция-элемент)
Наблюдатели
mark_count	возвращает количество отмеченных подвыражений в регулярном выражении (public функция-элемент)
flags	возвращает флаги синтаксиса (public функция-элемент)
Локаль
getloc	получает информацию о локали (public функция-элемент)
imbue	устанавливает информацию о локали (public функция-элемент)
Модификаторы
swap	обменивает содержимое (public функция-элемент)
Константы

Значение	Эффект(ы)
icase	Сопоставление символов должно выполняться без учёта регистра.
nosubs	При выполнении сопоставлений все отмеченные подвыражения (expr) обрабатываются как немаркирующие подвыражения (?:expr). В предоставленной структуре std::regex_match нет совпадений, а mark_count() равно нулю.
optimize	Даёт указание обработчику регулярных выражений ускорить сопоставление с потенциальными затратами на замедление построения. Например, это может означать преобразование недетерминированного FSA в детерминированное FSA.
collate	Диапазоны символов в форме "[a-b]" будут чувствительны к локали.
multiline (C++17)	Указывает, что ^ должен соответствовать началу строки, а $ должен соответствовать концу строки, если выбран механизм ECMAScript.
ECMAScript	Используется Модифицированная грамматика регулярных выражений ECMAScript
basic	Используется базовая грамматика регулярных выражений POSIX (документация по грамматике).
extended	Используется расширенная грамматика регулярных выражений POSIX (документация по грамматике).
awk	Используется грамматика регулярных выражений, используемая утилитой awk в POSIX (документация по грамматике)
grep	Используется грамматика регулярных выражений, используемая утилитой grep в POSIX. Фактически это то же самое, что и опция basic с добавлением новой строки '\n' в качестве разделителя чередования.
egrep	Используется грамматика регулярных выражений, используемая утилитой grep в POSIX с параметром -E. Фактически это то же самое, что и опция extended с добавлением новой строки '\n' в качестве разделителя чередования в дополнение к '|'.

Необходимо выбрать не более одного варианта грамматики из ECMAScript, basic, extended, awk, grep, egrep. Если грамматика не выбрана, предполагается, что выбрана ECMAScript. Другие параметры служат модификаторами, например std::regex("meow", std::regex::icase) эквивалентно std::regex("meow", std::regex::ECMAScript|std::regex::icase)

Константы-элементы в basic_regex являются дубликатами констант syntax_option_type, определённых в пространстве имён std::regex_constants.

Функции, не являющиеся элементами

std::swap(std::basic_regex) (C++11)

специализация алгоритма std::swap (шаблон функции)