std::regex_iterator<BidirIt,CharT,Traits>::regex_iterator

 

C++

Language

Standard Library Headers

Freestanding and hosted implementations

Named requirements

Language support library

Concepts library (C++20)

Diagnostics library

Utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

Filesystem library (C++17)

Technical Specifications

 

Regular expressions library

Classes

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Algorithms

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Iterators

regex_iterator (C++11)

regex_token_iterator (C++11)

Exceptions

regex_error (C++11)

Traits

regex_traits (C++11)

Constants

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

Regex Grammar

Modified ECMAScript-262 (C++11)

 

std::regex_iterator

Member Functions

regex_iterator::regex_iterator

regex_iterator::operator=

Comparisons

regex_iterator::operator==regex_iterator::operator!=

Observers

regex_iterator::operator*regex_iterator::operator->

Modifiers

regex_iterator::operator++regex_iterator::operator++(int)

 

regex_iterator();	(1)	(since C++11)
regex_iterator(BidirIt a, BidirIt b,                const regex_type& re,                std::regex_constants::match_flag_type m =                    std::regex_constants::match_default);	(2)	(since C++11)
regex_iterator(const regex_iterator&);	(3)	(since C++11)
regex_iterator(BidirIt, BidirIt,                const regex_type&&,                std::regex_constants::match_flag_type =                    std::regex_constants::match_default) = delete;	(4)	(since C++14)

Constructs a new regex_iterator:

1) Default constructor. Constructs an end-of-sequence iterator.

2) Constructs a regex_iterator from the sequence of characters [a, b), the regular expression re, and a flag m that governs matching behavior. This constructor performs an initial call to std::regex_search with this data. If the result of this initial call is false, *this is set to an end-of-sequence iterator.

3) Copies a regex_iterator.

4) The overload 2 is not allowed to be called with a temporary regex, since the returned iterator would be immediately invalidated.

Parameters

a	-	BidirIt to the beginning of the target character sequence
b	-	BidirIt to the end of the target character sequence
re	-	regular expression used to search the target character sequence
m	-	flags that govern the behavior of re