std::deque::cbegin(C++11)

const_iterator cbegin() const noexcept;

概要

先頭の要素を指す読み取り専用イテレータを取得する。

begin()は非constなdequeオブジェクトに対してiteratorを返し、constなdequeオブジェクトに対してはconst_iteratorを返すが、cbegin()はconst_iteratorを返すバージョンのみが提供されている。

アルゴリズムにイテレータの組を渡す際、アルゴリズム内でデータの書き換えが起こらないというユーザーの意図を示す場合などに有用である。

戻り値

先頭の要素を指す読み取り専用イテレータ

例外

投げない

計算量

定数時間

例

#include <iostream>
#include <deque>
#include <algorithm>

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

  // このアルゴリズム内ではcの書き換えを決して行わない
  std::for_each(c.cbegin(), c.cend(), [](const int& x) {
    std::cout << x << std::endl;
  });
}

出力

1
2
3

バージョン

言語

• C++11

処理系

• Clang: ??
• GCC: 4.7.0
• ICC: ??
• Visual C++: 2010, 2012, 2013

参照