std::experimental::ranges::prev
来自 cppreference.cn
< cpp | experimental | ranges
| namespace { constexpr /* 未指定 */ prev = /* 未指定 */; |
(范围 TS) (定制点对象) |
|
| 调用签名 (Call signature) |
||
| 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 的每个翻译单元中，它都指向自定义点对象的同一个实例。(这意味着它可以在内联函数和函数模板等中自由使用，而不会违反单一定义规则)。
[编辑] 返回值
递减后的迭代器。
[编辑] 示例
| 本节不完整 原因：无示例 |
[编辑] 另请参阅
| (C++11) |
递减迭代器 (函数模板) |
| 按给定距离前进迭代器 (函数模板) | |
| 递增迭代器 (函数模板) | |
| 返回迭代器与哨兵之间，或范围的起始与结束之间的距离 (函数模板) |
