Scroll to navigation

std::ranges::stride_view::iterator::operator++,--,+=,-=(3) C++ Standard Libary std::ranges::stride_view::iterator::operator++,--,+=,-=(3)

NAME

std::ranges::stride_view::iterator::operator++,--,+=,-= - std::ranges::stride_view::iterator::operator++,--,+=,-=

Synopsis


constexpr /*iterator*/& operator++(); (1) (since C++23)
constexpr void operator++( int ); (2) (since C++23)
constexpr /*iterator*/ operator++( int ) (3) (since C++23)
requires ranges::forward_range<Base>;
constexpr /*iterator*/& operator--() (4) (since C++23)
requires ranges::bidirectional_range<Base>;
constexpr /*iterator*/ operator--( int ) (5) (since C++23)
requires ranges::bidirectional_range<Base>;
constexpr /*iterator*/& operator+=( difference_type n ) (6) (since C++23)
requires ranges::random_access_range<Base>;
constexpr /*iterator*/& operator-=( difference_type n ) (7) (since C++23)
requires ranges::random_access_range<Base>;


Increments or decrements the iterator.


Let current_, end_, stride_, and missing_ be the data members of the iterator.


1) Equivalent to


missing_ = ranges::advance(current_, stride_, end_);
return *this


Before the call current_ should not be equal to end_.
2) Equivalent to ++*this;.
3) Equivalent to auto tmp = *this; ++*this; return tmp;.
4) Equivalent to


ranges::advance(current_, missing_ - stride_);
missing_ = 0;
return *this;


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


if (n > 0)
{
ranges::advance(current_, stride_ * (n - 1));
missing_ = ranges::advance(current_, stride_, end_);
}
else if (n < 0)
{
ranges::advance(current_, stride_ * n + missing_);
missing_ = 0;
}


return *this;


If n > 0, then before the call to this function the ranges::distance(current_, end_)
must be greater than stride_ * (n - 1).


Note that if n < 0, the ranges::distance(current_, end_) is always greater than
(non-positive) stride_ * (n - 1).
7) Equivalent to return *this += -n;

Parameters


n - position relative to current location

Return value


1,4,6,7) *this
2) (none)
3,5) a copy of *this that was made before the change

Example


This section is incomplete
Reason: no example

See also


operator+ performs iterator arithmetic
operator- (function)
(C++23)

Category:


* Todo no example

2024.06.10 http://cppreference.com