std::experimental::ranges::distance
来自 cppreference.cn
< cpp | experimental | ranges
| namespace { constexpr /* 未指定 */ distance = /* 未指定 */; |
(ranges TS) (定制点对象) |
|
| 调用签名 (Call signature) |
||
| template< Iterator I, Sentinel<I> S > constexpr ranges::difference_type_t<I> distance( I first, S last ); |
(1) | |
| template< Range R > constexpr ranges::difference_type_t<ranges::iterator_t<R>> distance( R&& r ); |
(2) | |
| template< SizedRange R > constexpr ranges::difference_type_t<ranges::iterator_t<R>> distance( R&& r ); |
(3) | |
返回 first 和 last 之间，或范围 r 的起始和结束之间的距离。
1) 如果满足 SizedSentinel<S, I>，则等价于 return last - first;。否则，返回从 first 到 last 所需的增量次数。如果
[first, last) 不表示一个范围，则 I 和 S 必须是相同的类型，并且必须模型化 SizedSentinel，并且 [last, first) 必须表示一个范围。否则，行为未定义。2) 等价于 return ranges::distance(ranges::begin(r), ranges::end(r));。
3) 等价于 return ranges::size(r);。
如果头文件 <experimental/ranges/range> 在实例化点之前未被包含，则实例化重载 (2,3) 可能会格式错误。
目录 |
[编辑] 定制点对象
名称 ranges::distance 表示一个定制点对象，它是 函数对象，属于 字面量 Semiregular 类类型（为解释目的，记为 DistanceT）。DistanceT 的所有实例都相等。因此，ranges::distance 可以自由复制，并且其副本可以互换使用。
给定一组类型 Args...，如果 std::declval<Args>()... 满足上述 ranges::distance 的参数要求，则 DistanceT 将满足 ranges::Invocable<const DistanceT, Args...>。否则，DistanceT 的函数调用运算符不参与重载决议。
在定义 ranges::distance 的每个翻译单元中，它引用定制点对象的同一个实例。(这意味着它可以在诸如内联函数和函数模板中自由使用，而不会违反单一定义规则。)
[编辑] 返回值
first 和 last 之间，或范围 r 的起始和结束之间的距离。
[编辑] 示例
| 本节不完整 原因：无示例 |
[编辑] 参阅
| 返回两个迭代器间的距离 (函数模板) | |
| 按给定距离前进迭代器 (函数模板) | |
| 递增迭代器 (函数模板) | |
| 递减迭代器 (函数模板) | |
| 获取在常数时间内可计算大小的范围的大小 (定制点对象) |
