std::experimental::ranges::distance
来自cppreference.com
< cpp | experimental | ranges
| namespace { constexpr /* unspecified */ distance = /* unspecified */; |
(范围 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 的翻译单元中，它都指代定制点对象的同一实例。（这表示能自由地在类似 inline 函数和函数模板的东西中使用它，而不违反单一定义规则。）
返回值
first 与 last 间的距离，或范围 r 的首尾间的距离。
示例
| 本节未完成 原因：暂无示例 |
参阅
| 返回两个迭代器间的距离 (函数模板) | |
| 令迭代器前进给定的距离 (函数模板) | |
| 自增迭代器 (函数模板) | |
| 自减迭代器 (函数模板) | |
| 获得能在常数时间计算大小的范围的大小 (定制点对象) |
