std::regex_iterator

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

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

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека регулярных выражений

Классы

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Алгоритмы

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Итераторы

regex_iterator (C++11)

regex_token_iterator (C++11)

Исключения

regex_error (C++11)

Типы

regex_traits (C++11)

Константы

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

Грамматика регулярных выражений

Модифицированный ECMAScript-262 (C++11)

 

template<     class BidirIt,     class CharT =typenamestd::iterator_traits<BidirIt>::value_type,     class Traits =std::regex_traits<CharT> >class regex_iterator		(начиная с C++11)

std::regex_iterator является доступной только для чтения ForwardIterator, которые обращаются отдельные матчи регулярного выражения в основной последовательности символов.

Оригинал:

std::regex_iterator is a read-only ForwardIterator that accesses the individual matches of a regular expression within the underlying character sequence.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Оригинал:

On construction, and on every increment, it calls std::regex_search and remembers the result (that is, saves a copy of the value std::match_results<BidirIt>). The first object may be read when the iterator is constructed or when the first dereferencing is done. Otherwise, dereferencing only returns a copy of the most recently obtained regex match.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Оригинал:

The default-constructed std::regex_iterator is the end-of-sequence iterator. When a valid std::regex_iterator is incremented after reaching the last match (std::regex_search returns false), it becomes equal to the end-of-sequence iterator. Dereferencing or incrementing it further invokes undefined behavior.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Оригинал:

A typical implementation of std::regex_iterator holds the begin and the end iterators for the underlying sequence (two instances of BidirIt), a pointer to the regular expression (const regex_type*) and the match flags (std::regex_constants::match_flag_type), and the current match (std::match_results<BidirIt>).

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

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

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

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

Оригинал:

Several specializations for common character sequence types are defined:

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Определены в заголовочном файле <regex>
Тип	Definition
cregex_iterator	regex_iterator<constchar*>
wcregex_iterator	regex_iterator<constwchar_t*>
sregex_iterator	regex_iterator<std::string::const_iterator>
wsregex_iterator	regex_iterator<std::wstring::const_iterator>

Типы-члены

Тип члена	Определение
value_type	std::match_results<BidirIt>
difference_type	std::ptrdiff_t
pointer	const value_type*
reference	const value_type&
iterator_category	std::forward_iterator_tag
regex_type	basic_regex<CharT, Traits>

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

(конструктор)	создает новый regex_iterator Оригинал: constructs a new regex_iterator Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
(деструктор) (объявлено неявно)	destructs a regex_iterator, including the cached value (public функция-элемент)
operator=	заменяет regex_iterator Оригинал: replaces a regex_iterator Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
operator==operator!=	сравнивает два regex_iterators Оригинал: compares two regex_iterators Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
operator*operator->	получает ссылку на текущий match accesses члена текущем матче Оригинал: obtains a reference to the current match accesses a member of the current match Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)
operator++operator++(int)	авансы regex_iterator на следующий матч Оригинал: advances the regex_iterator to the next match Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (public функция-элемент)

Заметки

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

Оригинал:

It is the programmer's responsibility to ensure that the std::basic_regex object passed to the iterator's constructor outlives the iterator. Because the iterator stores a pointer to the regex, incrementing the iterator after the regex was destroyed accesses a dangling pointer.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Оригинал:

If the part of the regular expression that matched is just an assertion (^, $, \b, \B), the match stored in the iterator is a zero-length match, that is, match[0].first== match[0].second.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Пример

Запустить этот код

#include <regex>#include <iterator>#include <iostream>   int main(){conststd::string text ="Quick brown fox.";   std::regex re("[^\\s]+");auto beg = std::sregex_iterator(text.begin(), text.end(), re);auto end = std::sregex_iterator();   std::cout<<"The number of words is "<<std::distance(beg, end)<<'\n';}

Вывод:

The number of words is 3

См. также

match_results (C++11)	идентифицирует одно совпадение регулярного выражения, включая все совпадения подвыражений (шаблон класса)
regex_search (C++11)	проверить, если регулярное выражение встречается в любом месте строки Оригинал: check if a regular expression occurs anywhere within a string Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда. (шаблон функции)