std::ranges::subrange<I,S,K>::next
На основе ru.cppreference.net
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);.Параметр
| n | - | количество максимальных инкрементов итератора |
Возвращаемое значение
Как описано выше.
Примечания
Разница между этой функцией и
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]
Смотрите также
получает копию
subrange
с итератором, уменьшенным на заданное расстояние
(public member function) |
|
|
перемещает итератор на заданное расстояние
(public member function) |
|
|
(C++11)
|
инкрементирует итератор
(function template) |
|
(C++20)
|
инкрементирует итератор на заданное расстояние или до границы
(algorithm function object) |