std::experimental::ranges::prev

 

C++

编译器支持

独立和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (filesystem TS)

库基础 (library fundamentals TS)

库基础 2 (library fundamentals TS v2)

库基础 3 (library fundamentals TS v3)

并行扩展 (parallelism TS)

并行扩展 2 (parallelism TS v2)

并发扩展 (concurrency TS)

并发扩展 2 (concurrency TS v2)

概念 (concepts TS)

范围 (ranges TS)

反射 (reflection TS)

数学特殊函数 (special functions TR)

实验性非TS

模式匹配

线性代数

std::execution

契约

2D图形

 

范围

概念

通用工具

迭代器

范围

算法

 

迭代器库

迭代器概念
可读的 可写的 弱可递增的 可递增的	迭代器 哨位 定尺寸哨位	输入迭代器 前向迭代器 双向迭代器 随机访问迭代器	输出迭代器
间接可调用概念
间接一元可调用间接正则一元可调用	间接一元谓词	间接关系	间接严格弱序
通用算法要求
间接可移动的 间接可移动可存储的	间接可复制的 间接可复制可存储的	间接可交换的 间接可比较的	可置换的 可归并的 可排序的
概念工具
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 /* unspecified */ prev = /* unspecified */; }		(ranges 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	返回迭代器与哨位之间，或范围的起始与结尾之间的距离 (函数模板)