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

履歴 編集

function
<map>

std::map::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

概要

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

戻り値

コンテナの先頭要素へのイテレータ。 iteratorconst_iterator はともにメンバ型である。map クラステンプレートにおいて、これらは双方向イテレータである。

計算量

定数時間。

#include <iostream>
#include <map>

int main()
{
  std::map<int, char> m;
  m[3] = 'C';
  m[7] = 'G';
  m[8] = 'H';
  m[4] = 'D';
  m[5] = 'E';
  m[1] = 'A';
  m[2] = 'B';
  m[6] = 'F';

  for( auto i = m.begin(); i != m.end() ; ++i ) {
      std::cout << i->first << " " << i->second << "\n";
  }

  return 0;
}

出力

1 A
2 B
3 C
4 D
5 E
6 F
7 G
8 H

バージョン

言語

  • C++03

処理系

関連項目

名前 説明
map::end 末尾の次を指すイテレータを取得する
map::cbegin 先頭を指すconstイテレータを取得する
map::cend 末尾の次を指すconstイテレータを取得する
map::rbegin 末尾を指す逆イテレータを取得する
map::rend 先頭の前を指す逆イテレータを取得する
map::crbegin 末尾を指す逆constイテレータを取得する
map::crend 先頭の前を指す逆constイテレータを取得する