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

来自cppreference.com
< cpp‎ | ranges‎ | subrange
 
C++
 
范围库
范围适配器
 
std::ranges::subrange
 
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 起)

返回一个 begin_ 被自增（或在 n 为负时被自减）后的 subrange。由 advance() 进行实际自增（或自减）操作。

1) 返回 *this 的副本。
等价于：auto tmp = *this;
tmp.advance(n);
return tmp;。
2) 返回从 *this 移动得到的 subrange。
等价于：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 的副本并以给定距离减少其迭代器
(公开成员函数) [编辑]
以给定距离推进迭代器
(公开成员函数) [编辑]
(C++11)
 令迭代器自增
(函数模板) [编辑]
(C++20)
 自增迭代器给定的距离或到边界
(算法函数对象) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/ranges/subrange/next&oldid=98029”