Namespaces
Variants

std::ranges::adjacent_view<V,N>:: iterator <Const>:: operator++,--,+=,-=

From cppreference.net
Ranges library
Range adaptors
constexpr /*iterator*/ & operator ++ ( ) ;
(1) (seit C++23)
constexpr /*iterator*/ operator ++ ( int ) ;
(2) (seit C++23)
constexpr /*iterator*/ & operator -- ( )
requires ranges:: bidirectional_range < Base > ;
(3) (seit C++23)
constexpr /*iterator*/ operator -- ( int )
requires ranges:: bidirectional_range < Base > ;
(4) (seit C++23)
constexpr /*iterator*/ & operator + = ( difference_type n )
requires ranges:: random_access_range < Base > ;
(5) (seit C++23)
constexpr /*iterator*/ & operator - = ( difference_type n )
requires ranges:: random_access_range < Base > ;
(6) (seit C++23)

Erhöht oder verringert den Iterator.

Sei current_ ein zugrundeliegendes Array von Iteratoren.

1) Entspricht:
for (auto& i : current_)
    i = std::ranges::next(i);
return *this;
Das Verhalten ist undefiniert, wenn vor dem Aufruf current_. back ( ) nicht inkrementierbar ist.
2) Entspricht:
auto tmp = *this;
++*this;
return tmp;
3) Entspricht:
for (auto& i : current_)
    i = std::ranges::prev(i);
return *this;
Das Verhalten ist undefiniert, wenn vor dem Aufruf current_. front ( ) nicht dekrementierbar ist.
4) Entspricht:
auto tmp = *this;
--*this;
return tmp;
5) Entspricht:
for (auto& i : current_)
    i = i + n;
return *this;
Das Verhalten ist undefiniert, wenn vor dem Aufruf current_. back ( ) + n kein wohldefiniertes Verhalten besitzt.
6) Entspricht:
for (auto& i : current_)
    i = i - n;
return *this;
Das Verhalten ist undefiniert, falls vor dem Aufruf current_. front ( ) - n kein wohldefiniertes Verhalten besitzt.

Inhaltsverzeichnis

Parameter

n - Position relativ zum aktuellen Standort

Rückgabewert

1,3,5,6) * this
2,4) Eine Kopie von * this , die vor der Änderung erstellt wurde.

Beispiel

#include <cassert>
#include <list>
#include <ranges>
#include <utility>
#include <vector>
int main()
{
    {
        auto v = std::vector{0, 1, 2, 3, 4, 5};
        auto i = (v | std::views::pairwise).begin();
        assert((*i == std::pair{0, 1}));
        ++i;                            // Überladung (1)
        assert((*i == std::pair{1, 2}));
        --i;                            // Überladung (3)
        assert((*i == std::pair{0, 1}));
        i += 2;                         // Überladung (5)
        assert((*i == std::pair{2, 3}));
        i -= 2;                         // Überladung (6)
        assert((*i == std::pair{0, 1}));
    }
    {
        auto v = std::list{0, 1, 2, 3, 4, 5};
        auto i = (v | std::views::pairwise).begin();
        assert((*i == std::pair{0, 1}));
        ++i;                            // Überladung (1)
        assert((*i == std::pair{1, 2}));
        --i;                            // Überladung (3)
        assert((*i == std::pair{0, 1}));
//      i += 2; // Fehler: v ist kein random_access_range; Überladung (5)
//      i -= 2; // Fehler: v ist kein random_access_range; Überladung (6)
    }
}

Siehe auch

führt Iterator-Arithmetik aus
(öffentliche Elementfunktion)