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

constexpr subrange next( std::iter_difference_t<I> n = 1 ) const& requires std::forward_iterator<I>;	(1)	(начиная с C++20)
constexpr subrange next( std::iter_difference_t<I> n = 1 ) &&;	(2)	(начиная с C++20)

Возвращает subrange, у которого begin_ увеличен (или уменьшен, если n отрицательно). Фактическая операция увеличения (или уменьшения) выполняется с помощью advance().

1) Возвращает копию *this.

Эквивалентно: auto tmp = *this;tmp.advance(n);return tmp;.

2) Возвращает subrange, перемещённый из *this.

Эквивалентно: advance(n);return std::move(*this);.

Параметр

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

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

Как описано выше.

Примечания

Отличие этой функции от advance() состоит в том, что последняя выполняет увеличение (или уменьшение) на месте.

Пример

#include <array>
#include <iterator>
#include <print>
#include <ranges>

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

Вывод:

1) sub: [3, 4, 5]
2) sub: [4, 5]
3) sub: [5]

См. также

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

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