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), указатель на регулярное выражение (const regex_type*), флаги совпадения (std::regex_constants::match_flag_type) и текущее совпадение (std::match_results<BidirIt>).

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

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

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

Типы-члены

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

Примечания

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

Если часть регулярного выражения, к которой произошло совпадение, представляет собой только утверждение (^, $, \b, \B), то хранимое в итераторе совпадение имеет длину 0, то есть 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++.

1. iterator_category остался без изменений в результате решения, поскольку изменение его на std::input_iterator_tag может сломать слишком много существующего кода.

См. также