std::regex_iterator<BidirIt,CharT,Traits>::regex_iterator - cppreference.com (original) (raw)

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.

[edit] Parameters

[edit] Example

#include #include #include   int main() { constexpr std::string_view str{R"( #ONE: p = &Mass; #Two: MOV %rd, 42 )"}; const std::regex re("[a-w]");   // create regex_iterator, overload (2) auto it = std::regex_iteratorstd::string_view::iterator { str.cbegin(), str.cend(), re // re is lvalue; if an immediate expression was used // instead, e.g. std::regex{"[a-z]"}, this would // produce an error since overload (4) is deleted };   for (decltype(it) last / overload (1) */; it != last; ++it) std::cout << (*it).str(); std::cout << '\n'; }

Output:

[edit] Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.