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