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, за исключением того, что поддерживается только копирование и перемещение, а также операции, определённые для постоянных контейнеров, и что семантика функций сравнения отличается от требуемой для контейнера.

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

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

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

Типы членов

Члены-функции

Нечлен-функции