std:: 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 ), то совпадение, хранимое в итераторе, является совпадением нулевой длины, то есть 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 могло бы нарушить слишком много существующего кода.

Смотрите также