begin.md

begin

• set[meta header]
• std[meta namespace]
• multiset[meta class]
• function[meta id-type]

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

概要

multiset コンテナの先頭要素を参照するイテレータを取得する。

内部的に、multisetコンテナは要素を下位から上位へと並べており、従って begin() は multiset 内の最下位のキーにあたる値へのイテレータを返す。

戻り値

コンテナの先頭要素へのイテレータ。

iterator と const_iterator はともにメンバ型である。multiset クラステンプレートにおいて、これらは双方向イテレータである。

備考

const 版ではない begin が返す iterator も読み取り専用イテレータである。

（が、iterator と const_iterator が同じ型とは限らない）

計算量

定数時間。

例

#include <iostream>
#include <set>

int main()
{
  std::multiset<int> c;
  c.insert(5);
  c.insert(2);
  c.insert(4);
  c.insert(1);
  c.insert(0);
  c.insert(0);
  c.insert(9);

  std::multiset<int>::iterator i = c.begin();
  while (i != c.end())
    std::cout << *i++ << " ";
  std::cout << std::endl;
}

• begin()[color ff0000]
• c.insert[link insert.md]
• c.end()[link end.md]

出力

0 0 1 2 4 5 9  

関連項目

名前	説明
multiset::end	末尾の次を指すイテレータを取得する
multiset::rbegin	末尾を指す逆イテレータを取得する
multiset::rend	先頭の前を指す逆イテレータを取得する