std::ranges::elements_view<V,N>::iterator

template< bool Const >
class /*iterator*/;

(since C++20)

The return type of elements_view::begin, and of elements_view::end when the underlying view is a common_range.

The type /*iterator*/<true> is returned by the const-qualified overloads. The type /*iterator*/<false> is returned by the non-const-qualified overloads.

The name of this class template (shown here as iterator) is unspecified.

Member types

Member type	Definition
`Base` (private)	`const V` if `Const` is `true`, otherwise `V`. The name is for exposition only
`iterator_concept`	`std::random_access_iterator_tag` if `Base` models `random_access_range`, `std::bidirectional_iterator_tag` if `Base` models `bidirectional_range`, `std::forward_iterator_tag` if `Base` models `forward_range`, `std::input_iterator_tag` otherwise
`iterator_category`	Not defined if `Base` does not model `forward_range`. Otherwise, if `std::get<N>(*current_)` is an rvalue, the type is `std::input_iterator_tag`. Otherwise, let `C` be the type `std::iterator_traits<std::iterator_t<Base>>::iterator_category`. Then if `C` models `std::derived_from<std::random_access_iterator_tag>`, the type is `std::random_access_iterator_tag`. Otherwise, the type is `C`.
`value_type`	`std::remove_cvref_t<std::tuple_element_t<N, ranges::range_value_t<Base>>>`
`difference_type`	`ranges::range_difference_t<Base>`

Member objects

Member name	Definition
`current_` (private)	an object of type `ranges::iterator_t<Base>`, the name is for exposition only

Member functions

(constructor) (C++20)	constructs an iterator (public member function)
base (C++20)	returns the underlying iterator (public member function)
operator* (C++20)	accesses the `N`-th tuple element (public member function)
operator[] (C++20)	accesses an element by index (public member function)
operator++operator++(int) operator--operator--(int)operator+=operator-= (C++20)	advances or decrements the underlying iterator (public member function)

Non-member functions

operator==operator<operator>operator<=operator>=operator<=> (C++20)	compares the underlying iterators (function)
operator+operator- (C++20)	performs iterator arithmetic (function)

Defect reports

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

DR	Applied to	Behavior as published	Correct behavior
P2259R1	C++20	member `iterator_category` is always defined	defined only if `Base` models `forward_range`
LWG 3555	C++20	the definition of `iterator_concept` ignores const	made to consider

Name	C++
Version
Badge
Last Updated	2022-06-02T22:02:33Z