std::ranges::subrange<I,S,K>::advance

constexpr subrange& advance( std::iter_difference_t<I> n );

(начиная с C++20)

Увеличивает или уменьшает begin_ :

Если I моделирует bidirectional_iterator и n < 0 равно true, уменьшает begin_ на -n элементов.

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

ranges::advance(begin_ ,n);
ifconstexpr(StoreSize )
    size_ += to-unsigned-like (-n);
return*this;

В противном случае увеличивает begin_ на n элементов или до достижения end_.

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

autod=n-ranges::advance(begin_ ,n, end_ );
ifconstexpr(StoreSize )
    size_ -= to-unsigned-like (d);
return*this;

Согласно предусловиям ranges::advance, если n < 0 равно true и begin_ нельзя уменьшить на -n элементов, поведение не определено.

Параметры

максимальное число увеличений итератора

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

*this

Пример

#include <algorithm>
#include <array>
#include <iostream>
#include <iterator>
#include <ranges>

void print(auto name, auto const sub)
{
    std::cout << name << ".size() == " << sub.size() << "; { ";
    std::ranges::for_each(sub, [](int x) { std::cout << x << ' '; });
    std::cout << "}\n";
};

int main()
{
    std::array arr{1, 2, 3, 4, 5, 6, 7};
    std::ranges::subrange sub{std::next(arr.begin()), std::prev(arr.end())};
    print("1) sub", sub);
    print("2) sub", sub.advance(3));
    print("3) sub", sub.advance(-2));
}

Вывод:

1) sub.size() == 5; { 2 3 4 5 6 }
2) sub.size() == 2; { 5 6 }
3) sub.size() == 4; { 3 4 5 6 }

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроспективно к ранее опубликованным стандартам C++.

Отчёт об ошибке	Применяется к	Опубликованное поведение	Правильное поведение
LWG 3433	C++20	поведение не было определено, если `n < 0`	поведение определено, если `begin_` можно уменьшить

См. также

next	получает копию `subrange` с итератором, увеличенным на заданное расстояние (открытая функция-член)
prev	получает копию `subrange` с итератором, уменьшенным на заданное расстояние (открытая функция-член)
advance	увеличивает итератор на заданное расстояние (шаблон функции)
ranges::advance (C++20)	увеличивает итератор на заданное расстояние или до заданной границы (функциональный объект алгоритма)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/ranges/subrange/advance