5. begin

最終更新日時(UTC):
が更新

履歴 編集

function
<deque>

std::deque::begin

iterator begin();           // (1) C++03
iterator begin() noexcept;  // (1) C++11

const_iterator begin() const;           // (2) C++03
const_iterator begin() const noexcept;  // (2) C++11

概要

先頭要素を指すイテレータを取得する。

戻り値

非constな文脈ではiterator型で先頭要素へのイテレータを返し、 constな文脈ではconst_iterator型で先頭要素へのイテレータを返す。

例外

投げない

計算量

定数時間

例

#include <iostream>
#include <deque>

int main()
{
  std::deque<int> d = {1, 2, 3};
  const std::deque<int>& cd = d;

  decltype(d)::iterator i = d.begin();
  decltype(d)::const_iterator ci = cd.begin();

  std::cout << *i << std::endl;
  std::cout << *ci << std::endl;
}

出力

1
1

関連項目

名前 説明
cbegin 先頭要素を指す読み取り専用イテレータを取得する
end 末尾要素を指すイテレータを取得する
cend 末尾要素を指す読み取り専用イテレータを取得する
rbegin 末尾要素を指す逆イテレータを取得する
rend 先頭要素の前を指す逆イテレータを取得する