std::experimental::ranges::distance

来自cppreference.com
< cpp‎ | experimental‎ | ranges
 
 
技术规范
文件系统库 (文件系统 TS)
库基础 (库基础 TS)
库基础 2 (库基础 TS v2)
并行扩展 (并行 TS)
并行扩展 2 (并行 TS v2)
并发扩展 (并发 TS)
概念 (概念 TS)
范围 (范围 TS)
数学特殊函数 (特殊函数 TR)
 
 
迭代器库
迭代器概念
间接可调用概念
                                                  
                                                  
                                                  
常用算法要求
                                                  
概念工具
迭代器工具及运算
distance
迭代器特性
迭代器适配器
流迭代器
 
定义于头文件 <experimental/ranges/iterator>
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)

返回 firstlast 间的距离,或范围 r 的首尾间的距离。

1)SizedSentinel<S, I> 得到满足,则等价于 return last - first; 。否则,返回从 first 得到 last 所需的自增次数。若 [first, last) 不代表范围,则 IS 必须为同一类型且必须实现 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 函数和函数模板的东西中使用它,而不违反单一定义规则。)

返回值

firstlast 间的距离,或范围 r 的首尾间的距离。

示例

参阅

返回两个迭代器间的距离
(函数模板)
令迭代器前进给定的距离
(函数模板)
自增迭代器
(函数模板)
自减迭代器
(函数模板)
获得能在常数时间计算大小的范围的大小
(定制点对象)