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

From cppreference.com

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros(C++20)
Language support library
Concepts library(C++20)
Diagnostics library
Memory management library
Metaprogramming library(C++11)
General utilities library
Containers library
Iterators library
Ranges library(C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library(C++17)
Concurrency support library(C++11)
Execution control library(C++26)
Technical specifications
Symbols index
External libraries

[edit]

Ranges library

Range access

begin
cbegin
end
cend

rbegin
crbegin
rend
crend

size
ssize
data
cdata

reserve_hint (C++26)
empty

Range conversions
std::from_range_t std::from_range (C++23)(C++23)
to (C++23)

Dangling iterator handling
dangling
borrowed_iterator_t
borrowed_subrange_t

Range primitives

range_size_trange_difference_trange_value_t
elements_of (C++23)

iterator_tconst_iterator_tsentinel_tconst_sentinel_t

(C++23)(C++23)

range_reference_trange_const_reference_trange_rvalue_reference_trange_common_reference_t

(C++23)

Range concepts

range
borrowed_range
common_range

sized_range
viewable_range
view

input_range
output_range
forward_range

bidirectional_range
random_access_range
contiguous_range

approximately_sized_range (C++26)
constant_range (C++23)

empty_viewviews::empty

single_viewviews::single

basic_istream_viewviews::istream

iota_viewviews::iota

repeat_viewviews::repeat

(C++23)(C++23)

Range adaptors

views::all_tviews::all
as_rvalue_viewviews::as_rvalue (C++23)(C++23)
filter_viewviews::filter
transform_viewviews::transform
take_viewviews::take
take_while_viewviews::take_while
common_viewviews::common
views::counted
to_input_viewviews::to_input (C++26)(C++26)

ref_view
drop_viewviews::drop
drop_while_viewviews::drop_while
lazy_split_viewviews::lazy_split
split_viewviews::split
join_viewviews::join
join_with_viewviews::join_with (C++23)(C++23)
concat_viewviews::concat (C++26)(C++26)
cache_latest_viewviews::cache_latest (C++26)(C++26)

owning_view
reverse_viewviews::reverse
as_const_viewviews::as_const (C++23)(C++23)
elements_viewviews::elements
keys_viewviews::keys
values_viewviews::values
enumerate_viewviews::enumerate (C++23)(C++23)
zip_viewviews::zip (C++23)(C++23)
zip_transform_viewviews::zip_transform (C++23)(C++23)

adjacent_viewviews::adjacent (C++23)(C++23)
views::pairwise (C++23)
adjacent_transform_viewviews::adjacent_transform (C++23)(C++23)
views::pairwise_transform (C++23)
chunk_viewviews::chunk (C++23)(C++23)
slide_viewviews::slide (C++23)(C++23)
chunk_by_viewviews::chunk_by (C++23)(C++23)
stride_viewviews::stride (C++23)(C++23)
cartesian_product_viewviews::cartesian_product (C++23)(C++23)

Range generators
std::generator (C++23)

Range adaptor closure objects
range_adaptor_closure (C++23)

Range adaptor objects

Helper items

copyable-box
movable-box

(until C++23) (C++23)

simple-view
non-propagating-cache

[edit]

std::ranges::elements_view

Member functions
elements_view::elements_view
elements_view::base
elements_view::begin
elements_view::end
elements_view::size
elements_view::reserve_hint (C++26)
Nested classes
Iterator
elements_view::iterator::iterator
elements_view::iterator::base
elements_view::iterator::operator*
elements_view::iterator::operator[]
elements_view::iterator::operator++ elements_view::iterator::operator++(int) elements_view::iterator::operator-- elements_view::iterator::operator--(int) elements_view::iterator::operator+= elements_view::iterator::operator-=
operator==(elements_view::iterator) operator<(elements_view::iterator) operator>(elements_view::iterator) operator<=(elements_view::iterator) operator>=(elements_view::iterator) operator<=>(elements_view::iterator)
operator+(elements_view::iterator) operator-(elements_view::iterator)
Sentinel
elements_view::sentinel::sentinel
elements_view::sentinel::base
operator==(elements_view::iterator,elements_view::sentinel)
operator-(elements_view::iterator,elements_view::sentinel)

[edit]

template<bool Const> class/iterator/;		(exposition only*)

The return type ofelements_view::begin, and ofelements_view::end when the underlying view is acommon_range.

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

[edit]Member types

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

[edit]Data members

Member object	Definition
`current_`(private)	An iterator of typeranges::iterator_t<Base> to current element of underlying sequence. (exposition-only member object*)

[edit]Member functions

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

[edit]Non-member functions

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

[edit]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

[edit]See also

iterator

(C++20)

the return type ofranges::transform_view::begin, and ofranges::transform_view::end when the underlying view is acommon_range
(private member class template)[edit]

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/ranges/elements_view/iterator&oldid=173496"