std::regex_iterator

template<
    class BidirIt,
    class CharT = typename std::iterator_traits<BidirIt>::value_type,
    class Traits = std::regex_traits<CharT>
> class regex_iterator

std::regex_iterator — это итератор только для чтения, который обращается к отдельным совпадениям регулярного выражения в базовой последовательности символов. Он соответствует требованиям LegacyForwardIterator, за исключением того, что для разыменовываемых значений a и b с a == b объекты, на которые ссылаются *a и *b, не будут одним и тем же объектом.

При конструировании и при каждом увеличении итератор вызывает std::regex_search и сохраняет результат (то есть копию значения std::match_results<BidirIt>). Первый объект может быть прочитан при конструировании итератора или при первом разыменовании. В противном случае разыменование лишь возвращает копию последнего найденного совпадения регулярного выражения.

Итератор std::regex_iterator, сконструированный по умолчанию, является итератором конца последовательности. Когда допустимый std::regex_iterator увеличивается после достижения последнего совпадения (std::regex_search возвращает false), он становится равен итератору конца последовательности. Дальнейшее разыменование или увеличение приводит к неопределённому поведению.

Типичная реализация std::regex_iterator хранит итераторы начала и конца базовой последовательности (два экземпляра BidirIt), указатель на регулярное выражение (constregex_type*), флаги совпадения (std::regex_constants::match_flag_type) и текущее совпадение (std::match_results<BidirIt>).

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

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

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

Типы-члены

Члены-данные

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

Примечания

Программист несёт ответственность за то, чтобы объект std::basic_regex, переданный конструктору итератора, существовал дольше итератора. Поскольку итератор хранит указатель на регулярное выражение, увеличение итератора после уничтожения регулярного выражения приводит к обращению к висячему указателю.

Если совпавшая часть регулярного выражения является лишь утверждением (^, $, \b, \B), совпадение, хранящееся в итераторе, имеет нулевую длину, то есть match[0].first == match[0].second.

Пример

#include <iostream>
#include <iterator>
#include <regex>
#include <string>

int main()
{
    const std::string s = "Quick brown fox.";
    
    std::regex words_regex("[^\\s]+");
    auto words_begin = std::sregex_iterator(s.begin(), s.end(), words_regex);
    auto words_end = std::sregex_iterator();
    
    std::cout << "Found " << std::distance(words_begin, words_end) << " words:\n";
    
    for (std::sregex_iterator i = words_begin; i != words_end; ++i)
    {
        std::smatch match = *i;
        std::string match_str = match.str();
        std::cout << match_str << '\n';
    }
}

Found 3 words:
Quick
brown
fox.

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены задним числом к ранее опубликованным стандартам C++.

См. также