std::distance

 

C++

语言

概念

实用工具库

字符串库

集装箱库

算法库

迭代器库

Numerics库

输入/输出库

本地化库

正则表达式库 （C++11）

原子操作库 （C++11）

线程的支持库 （C++11）

 

迭代器库

迭代器原语 原文： Iterator primitives 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
iterator_traits
input_iterator_tag output_iterator_tag forward_iterator_tag bidirectional_iterator_tag random_access_iterator_tag
iterator
迭代器适配器 原文： Iterator adaptors 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
reverse_iterator
move_iterator （C++11） back_insert_iterator front_insert_iterator insert_iterator	make_move_iterator （C++11） back_inserter front_inserter inserter
流迭代器 原文： Stream iterators 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
istream_iterator
ostream_iterator
istreambuf_iterator
ostreambuf_iterator
迭代器操作 原文： Iterator operations 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
advance
distance
prev （C++11）
next （C++11）
远程接入 原文： Range access 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
begin （C++11）
end （C++11）

 

在头文件 <iterator> 中定义
template< class InputIt > typename std::iterator_traits<InputIt>::difference_type     distance( InputIt first, InputIt last );

返回的元素数之间first和last.

原文：

Returns the number of elements between first and last.

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

的行为是不确定的，如果last是不可达的，从first可能反复递增first.

原文：

The behavior is undefined if last is not reachable from first by (possibly repeatedly) incrementing first.

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

参数

first	-	迭代器，指向第一个元素 原文： iterator pointing to the first element 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
last	-	迭代器，指向的最后一个元素 原文： iterator pointing to the last element 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
类型要求
- InputIt 必须满足 InputIterator 的要求。 The operation is more efficient if InputIt additionally meets the requirements of RandomAccessIterator

返回值

的数量之间first和last的元素，

原文：

The number of elements between first and last.

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

复杂度

线性.

原文：

Linear.

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

然而，如果InputIt附加RandomAccessIterator符合要求的，复杂度为恒定

原文：

However, if InputIt additionally meets the requirements of RandomAccessIterator, complexity is constant.

这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

示例

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

输出：

3

另请参阅

advance	给定距离的迭代器 原文： advances an iterator by given distance 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数）