The class template regex_iterator
is an iterator adaptor.
It represents a new view of an existing iterator sequence, by
enumerating all the occurrences of a regular expression within that
to find successive
regular expression matches within the sequence from which it was
After the iterator is constructed, and every time operator++
used, the iterator finds and stores a value of
If the end of the sequence is
), the iterator becomes equal to
the end-of-sequence iterator value.
The default constructor
constructs an end-of-sequence iterator object,
which is the only legitimate iterator to be used for the end
The result of operator*
on an end-of-sequence iterator is not
For any other iterator value a const
The result of
on an end-of-sequence iterator is not defined.
For any other
iterator value a const match_results<BidirectionalIterator>*
It is impossible to store things into regex_iterator
end-of-sequence iterators are always equal.
iterator is not equal to a non-end-of-sequence iterator.
non-end-of-sequence iterators are equal when they are constructed from
the same arguments.