std::experimental::ranges::next
< cpp | experimental | ranges
|
namespace {
constexpr /* 未指明 */ next = /* 未指明 */; |
(范围 TS) (定制点对象) |
|
|
调用签名
|
||
|
template< Iterator I >
constexpr I next( I i ); |
(1) | |
|
template< Iterator I >
constexpr I next( I i, ranges::difference_type_t<I> n ); |
(2) | |
|
template< Iterator I, Sentinel<I> S >
constexpr I next( I i, S bound ); |
(3) | |
|
template< Iterator I, Sentinel<I> S >
constexpr I next( I i, ranges::difference_type_t<I> n, S bound ); |
(4) | |
n 次推进迭代器 i，或直至抵达 bound，先到为止，并返回前进的迭代器。
1) 等价于 ++i; return i;。
2) 等价于 ranges::advance(i, n); return i;。
3) 等价于 ranges::advance(i, bound); return i;。
4) 等价于 ranges::advance(i, n, bound); return i;。
定制点对象
名称 ranges::next 代表一个定制点对象，它是字面 Semiregular 类类型的cpp/named req/FunctionObject（为说明目的以 NextT 表示）。NextT 的所有实例均相等。从而能自由地复制 ranges::next，且能交替使用其副本。
给定类型集合 Args...，若 std::declval<Args>()... 满足上面针对 ranges::next 实参的要求，则 NextT 将满足 ranges::Invocable<const NextT, Args...>。否则，没有 NextT 的函数调用运算符参与重载决议。
在每个定义 ranges::next 的翻译单元中，它都指代定制点对象的同一实例。（这表示能自由地在类似 inline 函数和函数模板的东西中使用它，而不违反单一定义规则。）
返回值
推进后的迭代器。
注解
虽然对重载 (2) 忽略 n 表现为如同 n 为 1，但对重载 (4) 忽略 n 表现为 n 为无穷大（始终推进到 bound）。
示例
| 本节未完成 原因：暂无示例 |
参阅
|
(C++11)
|
令迭代器自增 (函数模板) |
| 令迭代器前进给定的距离 (函数模板) |
|
| 自减迭代器 (函数模板) |
|
| 返回迭代器和哨位之间的距离，或范围起始和结尾间的距离 (函数模板) |