begin.md

begin

• iterator[meta header]
• std[meta namespace]
• function template[meta id-type]
• cpp11[meta cpp]

namespace std {
  template <class C>
  auto begin(C& c) -> decltype(c.begin());                 // (1) C++11

  template <class C>
  constexpr auto begin(C& c) -> decltype(c.begin());       // (1) C++17

  template <class C>
  auto begin(const C& c) -> decltype(c.begin());           // (2) C++11

  template <class C>
  constexpr auto begin(const C& c) -> decltype(c.begin()); // (2) C++17

  template <class T, size_t N>
  T* begin(T (&array)[N]);                                 // (3) C++11

  template <class T, size_t N>
  constexpr T* begin(T (&array)[N]) noexcept;              // (3) C++14
}

概要

範囲から先頭要素へのイテレータを取得する。

戻り値

• (1) : return c.begin();
• (2) : return c.begin();
• (3) : return array;

備考

この関数は、範囲for文の実装に使用される。

例

#include <iostream>
#include <vector>
#include <iterator>
#include <algorithm>

void print(int x)
{
  std::cout << x << " ";
}

int main()
{
  // コンテナ
  {
    std::vector<int> v = {1, 2, 3};

    decltype(v)::iterator first = std::begin(v);
    decltype(v)::iterator last = std::end(v);

    std::for_each(first, last, print);
  }
  std::cout << std::endl;

  // 組み込み配列
  {
    int ar[] = {4, 5, 6};

    int* first = std::begin(ar);
    int* last = std::end(ar);

    std::for_each(first, last, print);
  }
}

• std::begin[color ff0000]

出力

1 2 3 
4 5 6 

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC:
• GCC, C++11 mode: 4.7.0
• ICC: ??
• Visual C++: ??

参照

• N2930 Range-Based For Loop Wording (Without Concepts)
• boost::begin() - Boost Range Library
• LWG2280 - begin/end for arrays should be constexpr and noexcept
• P0031R0 A Proposal to Add Constexpr Modifiers to reverse_iterator, move_iterator, array and Range Access