std::ranges::repeat_view<W, Bound>::iterator

 

C++

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)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Technical specifications

Symbols index

External libraries

 

Ranges library

Range access
begin cbegin end cend	rbegin crbegin rend crend	size ssize data cdata	empty
Range conversions
to (C++23)
Range primitives
range_size_trange_difference_t range_value_t	range_reference_trange_const_reference_trange_rvalue_reference_t   (C++23)	iterator_tconst_iterator_tsentinel_t (C++23)
Dangling iterator handling
dangling	borrowed_iterator_t	borrowed_subrange_t
Range concepts
range borrowed_range    sized_range constant_range (C++23)	common_range view viewable_range	input_range output_range forward_range	bidirectional_range random_access_range contiguous_range
Views
view_interface	subrange
Factories
empty_viewviews::empty iota_viewviews::iota	single_viewviews::single cartesian_product_viewviews::cartesian_product (C++23)(C++23)	basic_istream_viewviews::istream repeat_viewviews::repeat (C++23)(C++23)
Adaptors
ref_view views::all_tviews::all common_viewviews::common reverse_viewviews::reverse as_const_viewviews::as_const (C++23)(C++23) as_rvalue_viewviews::as_rvalue (C++23)(C++23)   zip_viewviews::zip (C++23)(C++23) zip_transform_viewviews::zip_transform (C++23)(C++23)	owning_view take_viewviews::take take_while_viewviews::take_while drop_viewviews::drop drop_while_viewviews::drop_while 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)	views::counted elements_viewviews::elements keys_viewviews::keys values_viewviews::values transform_viewviews::transform chunk_viewviews::chunk (C++23)(C++23) chunk_by_viewviews::chunk_by (C++23)(C++23) slide_viewviews::slide (C++23)(C++23)	filter_viewviews::filter split_viewviews::split lazy_split_viewviews::lazy_split join_viewviews::join join_with_viewviews::join_with (C++23)(C++23) enumerate_viewviews::enumerate (C++23)(C++23) stride_viewviews::stride (C++23)(C++23)
Range generators
std::generator (C++23)
Range adaptor objects
Range adaptor closure objects
Helper items
movable-box	non-propagating-cache	simple-view

 

std::ranges::repeat_view

Member functions

repeat_view::repeat_view (C++23)

repeat_view::begin (C++23)

repeat_view::end (C++23)

repeat_view::size (C++23)

Deduction guides (C++23)

Iterator

Member functions

repeat_view::iterator::iterator (C++23)

repeat_view::iterator::operator* (C++23)

repeat_view::iterator::operator[] (C++23)

repeat_view::iterator::operator++ repeat_view::iterator::operator++(int) (C++23)(C++23)

repeat_view::iterator::operator-- repeat_view::iterator::operator--(int) (C++23)(C++23)

repeat_view::iterator::operator+= (C++23)

repeat_view::iterator::operator-= (C++23)

Non-member functions

operator==(repeat_view::iterator) operator<=>(repeat_view::iterator) (C++23)(C++23)

operator+(repeat_view::iterator) (C++23)

operator-(repeat_view::iterator) (C++23)

 

struct /*iterator*/;	(1)	(since C++23)
Helper alias templates
template< class I > using /*iota-diff-t*/ = /* see below */;  // exposition only	(2)	(since C++20)

1) The return type of repeat_view::begin. The name of this class (shown here as /*iterator*/) is unspecified.

2) The exposition-only alias template iota-diff-t calculates the difference type for both iterator types and integer-like types.

• If W is not an integral type, or if it is an integral type and sizeof(std::iter_difference_t<I>) is greater than sizeof(I), then /*iota-diff-t*/<I> is std::iter_difference_t<I>.
• Otherwise, /*iota-diff-t*/<I> is a signed integer type of width greater than the width of I if such a type exists.
• Otherwise, I is one of the widest integral types, and /*iota-diff-t*/<I> is an unspecified signed-integer-like type of width not less than the width of I. It is unspecified whether /*iota-diff-t*/<I> models weakly_incrementable in this case.

Member types

Member type	Definition
index-type (private)	std::ptrdiff_t, if Bound is the same as std::unreachable_sentinel_t. Otherwise, Bound. The name is for exposition only.
iterator_concept	std::random_access_iterator_tag
iterator_category	std::random_access_iterator_tag
value_type	W
difference_type	/*index-type*/, if /*is-signed-like*/</*index-type*/> is true, /*iota-diff-t*/(/*index-type*/) otherwise.

Data members

Typical implementation of this iterator type contains two data members:

• value_ of type const W* that holds the pointer to the value to repeat;
• current_ of type /*index-type*/ that holds the current position.

These names are exposition only.

Member functions

std::ranges::repeat_view::iterator::iterator

/*iterator*/() = default;	(1)	(since C++23)
constexpr explicit /*iterator*/(    // exposition only     const W* value, /*index-type*/ b = /*index-type*/() );	(2)	(since C++23)

1) Value initializes the exposition-only data members:

• value_ with nullptr_t via its default member initializer;
• index_ via its default member initializer (= /*index-type*/()).

2) Value initializes value_ with value and bound_ with b. If Bound is not std::unreachable_sentinel_t then b must be non-negative. This constructor is not a part of the public interface.

std::ranges::repeat_view::iterator::operator*

constexpr const W& operator*() const noexcept;		(since C++23)

Equivalent to return *value_;.

std::ranges::repeat_view::iterator::operator++

constexpr /*iterator*/& operator++();	(1)	(since C++23)
constexpr void operator++(int);	(2)	(since C++23)

1) Equivalent to ++current_; return *this;.

2) Equivalent to auto tmp = *this; ++*this; return tmp;.

std::ranges::repeat_view::iterator::operator--

constexpr /*iterator*/& operator--();	(1)	(since C++23)
constexpr /*iterator*/ operator--(int);	(2)	(since C++23)

1) Equivalent to --current_; return *this;. If Bound is not std::unreachable_sentinel_t then bound_ must be positive.

2) Equivalent to auto tmp = *this; --*this; return tmp;.

std::ranges::repeat_view::iterator::operator+=

constexpr /*iterator*/& operator+=( difference_type n );		(since C++23)

Equivalent to current_ += n; return *this;. If Bound is not std::unreachable_sentinel_t then (bound_ + n) must be non-negative.

std::ranges::repeat_view::iterator::operator-=

constexpr /*iterator*/& operator-=( difference_type n );		(since C++23)

Equivalent to current_ -= n; return *this;. If Bound is not std::unreachable_sentinel_t, then (bound_ - n) must be non-negative.

std::ranges::repeat_view::iterator::operator[]

constexpr const W& operator[]( difference_type n ) const noexcept;		(since C++23)

Equivalent to return *(*this + n);.

Non-member functions

operator==, <=>(std::ranges::repeat_view::iterator)

friend constexpr bool operator==( const /*iterator*/& x, const /*iterator*/& y );	(1)	(since C++23)
friend constexpr auto operator<=>( const /*iterator*/& x, const /*iterator*/& y );	(2)	(since C++23)

1) Equivalent to x.current_ == y.current_.

2) Equivalent to x.current_ <=> y.current_.

The != operator is synthesized from operator==.

These functions are not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when iterator is an associated class of the arguments.

operator+(std::ranges::repeat_view::iterator)

friend constexpr /*iterator*/ operator+( /*iterator*/ i, difference_type n );	(1)	(since C++23)
friend constexpr /*iterator*/ operator+( difference_type n, /*iterator*/ i );	(2)	(since C++23)

Equivalent to i += n; return i;.

These functions are not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when iterator is an associated class of the arguments.

operator-(std::ranges::repeat_view::iterator)

friend constexpr /*iterator*/ operator-( /*iterator*/ i, difference_type n );	(1)	(since C++23)
friend constexpr difference_type operator-( const /*iterator*/& x,                                             const /*iterator*/& y );	(2)	(since C++23)

1) Equivalent to i -= n; return i;.

2) Equivalent to return static_cast<difference_type>(x.current_) - static_cast<difference_type>(y.current_);.

These functions are not visible to ordinary unqualified or qualified lookup, and can only be found by argument-dependent lookup when iterator is an associated class of the arguments.

Notes

iterator is always random_access_iterator.