std::ranges::split_view<V,Pattern>::iterator
class /*iterator*/; // exposition only |
(since C++20) |
The return type of split_view::begin
. The name iterator
is for exposition purposes only.
This is a forward_iterator
, so it is expected that V
models at least forward_range
.
Member types
Member type | Definition |
---|---|
iterator_concept |
std::forward_iterator_tag |
iterator_category |
std::input_iterator_tag |
value_type |
ranges::subrange<ranges::iterator_t<V>> |
difference_type |
ranges::range_difference_t<V> |
Data members
Typical implementations of iterator
hold four non-static data members:
- a pointer of type
ranges::split_view<V, Pattern>*
to the parentsplit_view
object (shown here asparent_
for exposition only), - an iterator of type
ranges::iterator_t<V>
(shown here ascur_
for exposition only) into the underlyingview
;cur_
points to the begin of a current subrange, - a subrange of type
ranges::subrange<ranges::iterator_t<V>>
(shown here asnext_
for exposition only) to the position of the pattern next to the current subrange, and - a boolean flag (shown here as
trailing_empty_
for exposition only) that indicates whether an empty trailing subrange (if any) was reached.
Member functions
(constructor)
(C++20)
|
constructs an iterator (public member function) |
base
(C++20)
|
returns the underlying iterator (public member function) |
operator*
(C++20)
|
returns the current subrange (public member function) |
operator++operator++(int)
(C++20)
|
advances the iterator (public member function) |
std::ranges::split_view::iterator::iterator
/*iterator*/() = default; |
(1) | (since C++20) |
constexpr /*iterator*/( split_view& parent, ranges::iterator_t<V> current, ranges::subrange<ranges::iterator_t<V>> next ); |
(2) | (since C++20) |
-
ranges::split_view* parent_ = nullptr;
, -
ranges::iterator_t<V> cur_ = ranges::iterator_t<V>();
, -
ranges::subrange<ranges::iterator_t<V>> next_ = ranges::subrange<ranges::iterator_t<V>>();
, and -
bool trailing_empty_ = false;
.
-
ranges::split_view* parent_ = std::addressof(parent);
, -
ranges::iterator_t<V> cur_ = std::move(current);
, -
ranges::subrange<ranges::iterator_t<V>> next_ = std::move(next);
, and -
bool trailing_empty_ = false;
.
std::ranges::split_view::iterator::base
constexpr const ranges::iterator_t<V> base() const; |
(since C++20) |
Equivalent to return cur_;
.
std::ranges::split_view::iterator::operator*
constexpr ranges::range_reference_t<V> operator*() const; |
(since C++20) |
Equivalent to return {cur_, next_.begin()};
.
std::ranges::split_view::iterator::operator++
constexpr /*iterator*/& operator++(); |
(1) | (since C++20) |
constexpr void operator++( int ); |
(2) | (since C++20) |
cur_ = next_.begin();
if (cur_ != ranges::end(parent_->base_)) {
cur_ = next_.end();
if (cur_ == ranges::end(parent_->base_)) {
trailing_empty_ = true;
next_ = {cur_, cur_};
} else {
next_ = parent_->find_next(cur_);
}
} else {
trailing_empty_ = false;
}
return *this;
.
auto tmp = *this; ++*this; return tmp;
.
Non-member functions
operator==
(C++20)
|
compares the underlying iterators (function) |
operator==(std::ranges::split_view::iterator, std::ranges::split_view::iterator)
friend constexpr bool operator==( const /*iterator*/& x, const /*iterator*/& y ); |
(since C++20) |
Equivalent to return x.cur_ == y.cur_ && x.trailing_empty_ == y.trailing_empty_;
.
The !=
operator is synthesized from operator==
.
This function is not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when std::ranges::split_view::iterator
is an associated class of the arguments.
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/ranges/split_view/iterator