std::experimental::ranges::prev

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

实验性非 TS

模式匹配

线性代数

std::execution

契约

二维图形

 

范围

概念

通用实用程序

迭代器

范围

算法

 

迭代器库

迭代器概念
可读 可写 弱增量 增量	迭代器 哨兵 定长哨兵	输入迭代器 前向迭代器 双向迭代器 随机访问迭代器	输出迭代器
间接可调用概念
间接一元可调用间接正则一元可调用	间接一元谓词	间接关系	间接严格弱序
常见算法要求
间接可移动 间接可移动可存储	间接可复制 间接可复制可存储	间接可交换 间接可比较	可置换 可合并 可排序
概念实用程序
indirect_result_of	projected
迭代器实用程序和操作
iter_move iter_swap	advance distance	next prev
迭代器特征
difference_type value_type reference_trvalue_reference_titer_common_reference_t iterator_category	input_iterator_tagoutput_iterator_tagforward_iterator_tagbidirectional_iterator_tagrandom_access_iterator_tag	ranges::iterator_traits std::iterator_traits<InputIterator>std::iterator_traits<OutputIterator>
迭代器适配器
reverse_iterator move_iterator move_sentinel	back_insert_iterator front_insert_iterator insert_iterator	common_iterator counted_iterator default_sentinel	danglingborrowed_iterator_t unreachable
流迭代器
istream_iterator	ostream_iterator	istreambuf_iterator	ostreambuf_iterator

 

定义于头文件 <experimental/ranges/iterator> 中
namespace {     constexpr /* 未指定 */ prev = /* 未指定 */; }		(范围 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 的每个翻译单元中，它都引用自定义点对象的同一实例。（这意味着它可以在内联函数和函数模板等地方随意使用，而不会违反 单定义规则。）

返回值

递减后的迭代器。

参见

prev (C++11)	递减迭代器 (函数模板)
advance	将迭代器向前移动给定距离 (函数模板)
next	递增迭代器 (函数模板)
distance	返回迭代器和哨兵之间的距离，或范围的开头和结尾之间的距离 (函数模板)