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

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

Инкрементирует или декрементирует итератор.

Пусть current_ — это лежащий в основе массив итераторов.

1) Эквивалентно:

for (auto& i : current_)
    std::ranges::next(i);
return *this;

Поведение не определено, если перед вызовом current_.back() не может быть инкрементирован.

2) Эквивалентно:

auto tmp = *this;
++*this;
return tmp;

3) Эквивалентно:

for (auto& i : current_)
    std::ranges::prev(i);
return *this;

Поведение не определено, если перед вызовом current_.front() не может быть декрементирован.

4) Эквивалентно:

auto tmp = *this;
--*this;
return tmp;

5) Эквивалентно:

for (auto& i : current_)
    i += n;
return *this;

Поведение не определено, если перед вызовом current_.back() + n не имеет четко определенного поведения.

6) Эквивалентно:

for (auto& i : current_)
    i -= n;
return *this;

Поведение не определено, если перед вызовом current_.front() - n не имеет четко определенного поведения.

Параметры

смещение относительно текущего местоположения

Возвращаемое значение

1,3,5,6) *this

2,4) Копия *this, сделанная до изменения.

Пример

#include <cassert>
#include <list>
#include <ranges>
#include <utility>
#include <vector>
 
[[nodiscard]]
bool operator==(std::pair<int&, int&> x, std::pair<int, int> y)
{
    return x.first == y.first and x.second == y.second;
}
 
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;                            // overload (1)
        assert((*i == std::pair{1, 2}));
        --i;                            // overload (3)
        assert((*i == std::pair{0, 1}));
        i += 2;                         // overload (5)
        assert((*i == std::pair{2, 3}));
        i -= 2;                         // overload (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;                            // overload (1)
        assert((*i == std::pair{1, 2}));
        --i;                            // overload (3)
        assert((*i == std::pair{0, 1}));
//      i += 2; // Error: v is not a random_access_range; overload (5)
//      i -= 2; // Error: v is not a random_access_range; overload (6)
    }
}

См. также

operator+operator-

(C++23)

выполняет арифметику итераторов
(публичный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/ranges/adjacent_view/iterator/operator_arith