std::begin

 

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 C > auto begin( C& c ) -> decltype(c.begin());	(1)	（C++11 起）
template< class C > auto begin( const C& c ) -> decltype(c.begin());	(2)	（C++11 起）
template< class T, size_t N > T* begin( T (&array)[N] );	(3)	（C++11 起）

c或数组给定的容器array返回一个迭代的开始.

原文：

Returns an iterator to the beginning of the given container c or array array.

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

参数

c	-	的容器具有begin方法 原文： a container with a begin method 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
array	-	任意类型的数组 原文： an array of arbitrary type 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

返回值

c或array一个迭代的开始

原文：

an iterator to the beginning of c or array

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

注释

除了被包括在<iterator>std::begin保证变得可用，如果没有下面的接头连接器包括：<array>，<deque>，<forward_list>，<list>，<map>，<regex>，<set>，<string>，<unordered_map>，<unordered_set>，并<vector>.

原文：

In addition to being included in <iterator>, std::begin is guaranteed to become available if any of the following headers are included: <array>, <deque>, <forward_list>, <list>, <map>, <regex>, <set>, <string>, <unordered_map>, <unordered_set>, and <vector>.

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

专业化

定制专业的std::begin可能会不露出一个合适的begin()成员函数的类，还可以迭代。以下专业的标准库已经提供了

原文：

Custom specializations of std::begin may be provided for classes that do not expose a suitable begin() member function, yet can be iterated. The following specializations are already provided by the standard library:

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

std::begin(std::initializer_list) （C++11）	专业std::begin 原文： specializes std::begin 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）
std::begin(std::valarray) （C++11）	专业std::begin 原文： specializes std::begin 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数模板）

示例

#include <iostream>
#include <vector>
#include <iterator>
 
int main() 
{
    std::vector<int> v = { 3, 1, 4 };
    auto vi = std::begin(v);
    std::cout << *vi << '\n'; 
 
    int a[] = { -5, 10, 15 };
    auto ai = std::begin(a);
    std::cout << *ai << '\n';
}

输出：

3
-5

另请参阅

end （C++11）	返回一个迭代器的容器或数组 原文： returns an iterator to the end of a container or array 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 （函数）