std::match_results

template<
    class BidirIt,
    class Alloc = std::allocator<std::sub_match<BidirIt>>
> class match_results;

namespace pmr {
    template <class BidirIt>
    using match_results = std::match_results<BidirIt,
                              std::pmr::polymorphic_allocator<
                                  std::sub_match<BidirIt>>>;
}

Шаблон класса std::match_results содержит коллекцию символьных последовательностей, представляющих результат сопоставления с регулярным выражением.

Это специализированный контейнер с поддержкой аллокатора. Его можно только создать по умолчанию, получить из std::regex_iterator или изменить с помощью std::regex_search или std::regex_match. Поскольку std::match_results содержит std::sub_matchы, каждый из которых является парой итераторов в исходной символьной последовательности, с которой выполнялось сопоставление, поведение не определено, если обращаться к std::match_results после уничтожения исходной символьной последовательности или если итераторы в неё были признаны недействительными по другим причинам.

Первый std::sub_match (индекс 0) в std::match_result всегда представляет полное совпадение в целевой последовательности, найденное регулярным выражением, а последующие std::sub_matchы представляют совпадения подвыражений в порядке, соответствующем открывающим скобкам, ограничивающим подвыражения в регулярном выражении.

std::match_results соответствует требованиям AllocatorAwareContainer и SequenceContainer, за исключением того, что поддерживаются только операции копирующего присваивания, перемещающего присваивания и операции, определённые для константных контейнеров, а семантика функций сравнения отличается от требуемой для контейнера.

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

Специализации

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

Типы-члены

Функции-члены

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