std::experimental::ranges::advance

 

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

契约

2D 图形

 

范围

概念

通用实用程序

迭代器

范围

算法

 

迭代器库

迭代器概念
可读 可写 弱可增量 可增量	迭代器 哨兵 大小哨兵	输入迭代器 前向迭代器 双向迭代器 随机访问迭代器	输出迭代器
间接可调用概念
IndirectUnaryInvocableIndirectRegularUnaryInvocable	间接一元谓词	间接关系	间接严格弱排序
通用算法要求
间接可移动 间接可移动可存储	间接可复制 间接可复制可存储	间接可交换 间接可比较	可置换 可合并 可排序
概念实用程序
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 /* 未指定 */ advance = /* 未指定 */; }		(范围 TS) (定制点对象)
调用签名
template< Iterator I > constexpr void advance( I& i, ranges::difference_type_t<I> n );	(1)
template< Iterator I, Sentinel<I> S > constexpr void advance( I& i, S bound );	(2)
template< Iterator I, Sentinel<I> S > constexpr ranges::difference_type_t<I> advance( I& i, ranges::difference_type_t<I> n, S bound );	(3)

使迭代器 i 前进 n 次，或直到达到 bound，以先发生者为准。

1) 如果 I 模型化 RandomAccessIterator，等效于 i += n。否则，递增（或如果 n 为负则递减） i n 次。如果 n 为负且 I 不模型化 BidirectionalIterator，则行为未定义。

2) 如果满足 Assignable<I&, S>，等效于 i = std::move(bound)。

否则，如果 [i, bound) 不表示范围，则行为未定义。

否则，如果满足 SizedSentinel<S, I>，等效于 ranges::advance(i, bound - i)。

否则，递增 i 直到 i == bound。

3) 如果满足 SizedSentinel<S, I>，等效于 ranges::advance(i, bound) 如果 |n| >= |bound - i|, 否则等效于 ranges::advance(i, n)。

否则，递增（或如果 n 为负则递减） i n 次或直到 i == bound，以先发生者为准。

如果 n > 0，则 [i, bound) 应表示范围；如果 n == 0，则 [i, bound) 或 [bound, i) 应表示范围；如果 n < 0，则 [bound, i) 应表示范围，I 和 S 应为相同类型，并且 I 必须模型化 BidirectionalIterator。否则，行为未定义。

定制点对象

名称 ranges::advance 表示一个定制点对象，它是一个 函数对象，具有 文字 Semiregular 类类型（出于说明目的，表示为 AdvanceT）。所有 AdvanceT 的实例都是相等的。因此，ranges::advance 可以随意复制，并且其副本可以互换使用。

给定一组类型 Args...，如果 std::declval<Args>()... 满足上述对 ranges::advance 的参数的要求，则 AdvanceT 将满足 ranges::Invocable<const AdvanceT, Args...>。否则，AdvanceT 的任何函数调用运算符都不会参与重载解析。

在每个定义了 ranges::advance 的翻译单元中，它都引用了定制点对象的同一个实例。（这意味着它可以在内联函数和函数模板等内容中自由使用，而不会违反单定义规则。）

返回值

1,2) （无）

3) 由于到达bound而未执行的增量/减量次数。换句话说，n - M，其中 M 是i 的起始位置到结束位置的距离，如果结束位置在起始位置之前，则为负数。

另请参阅

advance	按给定距离移动迭代器 (函数模板)
distance	返回迭代器和哨兵之间的距离，或范围的开头和结尾之间的距离 (函数模板)
next	增加迭代器 (函数模板)
prev	减少迭代器 (函数模板)