std::experimental::ranges::prev

< cpp‎ | experimental‎ | ranges
 
C++
 
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
库基础 3 (库基础 TS v3)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
概念 (概念 TS)
范围 (范围 TS)
数学特殊函数 (特殊函数 TR)
 
范围
 
迭代器库
迭代器概念
间接可调用概念
                                                  
                                                  
                                                  
常用算法要求
                                                  
概念工具
迭代器工具及运算
prev
迭代器特性
迭代器适配器
流迭代器
 
定义于头文件 <experimental/ranges/iterator>
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)
 令迭代器自减
(函数模板)
令迭代器前进给定的距离
(函数模板)
自增迭代器
(函数模板)
返回迭代器和哨位之间的距离，或范围起始和结尾间的距离
(函数模板)