std::distance

来自cppreference.com
< cpp‎ | iterator
定义于头文件 <iterator>
template< class InputIt >

typename std::iterator_traits<InputIt>::difference_type

    distance( InputIt first, InputIt last );
(C++17 前)
template< class InputIt >

constexpr typename std::iterator_traits<InputIt>::difference_type

    distance( InputIt first, InputIt last );
(C++17 起)

返回从 firstlast 的路程。

last 不可从 first 通过(可以重复)自增 first 抵达,则行为未定义。

(C++11 前)

InputIt 不是随机访问迭代器 (RandomAccessIterator) ,则若 last 不可从 first 通过(可以重复)自增 first 抵达,则行为未定义。 若 InputIt随机访问迭代器 (RandomAccessIterator) ,则若 last 不可从 first 抵达且 first 不可从 last 抵达,则行为未定义。

(C++11 起)

目录

[编辑] 参数

first - 指向首元素的迭代器
last - 指向范围尾的迭代器
类型要求
-
InputIt 必须满足 InputIterator 的要求。若 InputIt 额外满足随机访问迭代器 (RandomAccessIterator) 的要求则操作更高效

[编辑] 返回值

first 走到 last 所需的自增数。若使用随机访问迭代器且 first 可从 last 抵达,则值可能为负。 (C++11 起)

[编辑] 复杂度

线性。

然而,若 InputIt 额外满足随机访问迭代器 (RandomAccessIterator) 的要求,则复杂度是常数。

[编辑] 示例

#include <iostream>
#include <iterator>
#include <vector>
 
int main() 
{
    std::vector<int> v{ 3, 1, 4 };
    std::cout << "distance(first, last) = "
              << std::distance(v.begin(), v.end()) << '\n'
              << "distance(last, first) = "
              << std::distance(v.end(), v.begin()) << '\n';
}

输出:

distance(first, last) = 3
distance(last, first) = -3

[编辑] 参阅

令迭代器前进给定的距离
(函数) [编辑]