cbegin.md

cbegin

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

namespace std {
  template <class C>
  constexpr auto cbegin(const C& c)
    noexcept(noexcept(std::begin(c)))
    -> decltype(std::begin(c));
}

• std::begin[link begin.md]

概要

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

戻り値

return std::begin(c);

パラメータをconstで受け取っているので、std::begin()を経由することで、読み取り専用イテレータを取得している。

例

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

int main()
{
  std::vector<int> v = {1, 2, 3};

  decltype(v)::const_iterator first = std::cbegin(v);
  decltype(v)::const_iterator last = std::cend(v);

  std::for_each(first, last, [](const int& x) {
    std::cout << x << std::endl;
  });
}

• std::cbegin[color ff0000]
• std::cend[link cend.md]

出力

1
2
3

バージョン

言語

• C++14

処理系

• Clang: 3.4 [mark verified]
• GCC: 5.0 [mark verified]
• ICC: ??
• Visual C++: ??

参照

• LWG Issue 2128. Absence of global functions cbegin/cend