std::sub_match

Определён в заголовочном файле `<regex>`
template< class BidirIt > class sub_match;		(начиная с C++11)

Шаблон класса std::sub_match используется движком регулярных выражений для обозначения последовательностей символов, соответствующих отмеченным подвыражениям. Совпадение представляет собой пару [begin, end) в целевом диапазоне, соответствующую регулярному выражению, но с дополнительными функциями наблюдения для повышения ясности кода.

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

Функции-члены возвращают заданные значения по умолчанию, если член matched не равен true.

std::sub_match наследуется от std::pair<BidirIt,BidirIt>, хотя его нельзя рассматривать как объект std::pair, поскольку функции-члены, такие как присваивание, не будут работать ожидаемым образом.

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

-BidirIt должен соответствовать требованиям LegacyBidirectionalIterator.

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

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

Определён в заголовочном файле `<regex>`
Тип	Определение
`std::csub_match`	std::sub_match<constchar*>
`std::wcsub_match`	std::sub_match<constwchar_t*>
`std::ssub_match`	std::sub_match<std::string::const_iterator>
`std::wssub_match`	std::sub_match<std::wstring::const_iterator>

Вложенные типы

Тип	Определение
`iterator`	`BidirIt`
`value_type`	std::iterator_traits<BidirIt>::value_type
`difference_type`	std::iterator_traits<BidirIt>::difference_type
`string_type`	std::basic_string<value_type>

Поля данных

Член	Описание
`matched`	успешно ли выполнено это сопоставление (открытый объект-член)

Наследуется от std::pair

BidirIt first	начало последовательности совпадения (открытый объект-член)
BidirIt second	позиция сразу после конца последовательности совпадения (открытый объект-член)

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

(конструктор)	создаёт объект совпадения (открытая функция-член)
Функции наблюдения
length	возвращает длину совпадения (если оно есть) (открытая функция-член)
stroperator string_type	преобразует в базовый строковый тип (открытая функция-член)
compare	сравнивает сопоставленную подпоследовательность (если она есть) (открытая функция-член)
Модификаторы
swap	обменивает содержимое (открытая функция-член)

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

operator==operator!=operator<operator<=operator>operator>=operator<=> (исключён в C++20)(исключён в C++20)(исключён в C++20)(исключён в C++20)(исключён в C++20)(C++20)	сравнивает `sub_match` с другим `sub_match`, строкой или символом (шаблон функции)
operator<<	выводит сопоставленную символьную подпоследовательность (шаблон функции)

Пример

#include <cassert>
#include <iostream>
#include <regex>
#include <string>

int main()
{
    std::string sentence{"Friday the thirteenth."};
    const std::regex re{"([A-z]+) ([a-z]+) ([a-z]+)"};
    std::smatch words;
    std::regex_search(sentence, words, re);
    std::cout << std::boolalpha;
    for (const auto& m : words)
    {
        assert(m.matched);
        std::cout << "m: [" << m << "], m.length(): " << m.length() << ", "
                     "*m.first: '" << *m.first << "', "
                     "*m.second: '" << *m.second << "'\n";
    }
}

Вывод:

m: [Friday the thirteenth], m.length(): 21, *m.first: 'F', *m.second: '.'
m: [Friday], m.length(): 6, *m.first: 'F', *m.second: ' '
m: [the], m.length(): 3, *m.first: 't', *m.second: ' '
m: [thirteenth], m.length(): 10, *m.first: 't', *m.second: '.'

См. также

regex_token_iterator

(C++11)

проходит по заданным подвыражениям во всех совпадениях с регулярным выражением в данной строке или по подстрокам, не имеющим совпадений
(шаблон класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/regex/sub_match