C++

參考

<iterator>

函式模板
<iterator> <array> <deque> <forward_list> <list> <map> <regex> <set> <string> <unordered_map> <unordered_set> <vector>

std::begin

容器 (1)
template <class Container>  auto begin (Container& cont) -> decltype (cont.begin());template <class Container>  auto begin (const Container& cont) -> decltype (cont.begin());
陣列 (2)
template <class T, size_t N>  T* begin (T(&arr)[N]);
容器 (1)
template <class Container>  auto begin (Container& cont) -> decltype (cont.begin());template <class Container>  auto begin (const Container& cont) -> decltype (cont.begin());
陣列 (2)
template <class T, size_t N>  constexpr T* begin (T(&arr)[N]) noexcept;
指向序列開始的迭代器
返回指向序列第一個元素的迭代器

(1) 容器
函式返回 cont.begin()。
(2) 陣列
函式返回其引數的 *陣列到指標轉換*。

如果序列 *為空*，則不應 *解引用* 返回值。

這些函式模板定義在多個頭檔案中：每個標頭檔案都包含了所有容器和陣列型別的通用模板，而不僅僅是特定的過載。這些標頭檔案是：<iterator>、<array>、<deque>、<forward_list>、<list>、map、<regex>、<set>、<string>、<unordered_map>、<unordered_set> 和 <vector>。

相反，begin 在標頭檔案 <initializer_list> 和 <valarray> 中被過載（具有不同的定義）。

引數

cont
一個類型別的物件，其成員 begin 已定義。
arr
一個數組。

返回值

對於 *(1)*，與 cont.begin() 返回的相同。
對於 *(2)*，指向陣列第一個元素的指標。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
 
// std::begin / std::end example
#include <iostream>     // std::cout
#include <vector>       // std::vector, std::begin, std::end

int main () {
  int foo[] = {10,20,30,40,50};
  std::vector<int> bar;

  // iterate foo: inserting into bar
  for (auto it = std::begin(foo); it!=std::end(foo); ++it)
    bar.push_back(*it);

  // iterate bar: print contents:
  std::cout << "bar contains:";
  for (auto it = std::begin(bar); it!=std::end(bar); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  return 0;
}

輸出
bar contains: 10 20 30 40 50


資料競爭

該引數被訪問但未被修改。
呼叫不會訪問序列中的任何元素，但返回的迭代器可用於訪問或修改它們。

異常安全

提供與對引數執行的操作相同的保證級別（對於標準容器和陣列，這是無異常保證）。

另見

end
指向末尾的迭代器 (函式模板)