std::experimental::ranges::distance
来自 cppreference.cn
< cpp | experimental | ranges
| namespace { constexpr /* unspecified */ distance = /* unspecified */; |
(ranges TS) (定制点对象) |
|
| 调用签名 |
||
| 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 的起始和结束之间的距离。
[编辑] 示例
| 本节不完整 原因：没有示例 |
[编辑] 参见
| 返回两个迭代器之间的距离 (函数模板) | |
| 将迭代器前进给定距离 (函数模板) | |
| 递增迭代器 (函数模板) | |
| 递减迭代器 (函数模板) | |
| 获取可以在常数时间内计算大小的范围的大小 (定制点对象) |
