5. begin

    • Class / Function / Type

      std::

    • Header file

      <>

    • Other / All

    crsearch v3.0.23

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

    履歴 編集

    function
    <map>

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

    概要

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

    戻り値

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

    計算量

    定数時間。

    例

    #include <iostream>
#include <map>

int main() 
{
  std::multimap<int, char> m;
  m.insert(std::make_pair(3, 'C'));
  m.insert(std::make_pair(3, 'D'));
  m.insert(std::make_pair(7, 'G'));
  m.insert(std::make_pair(8, 'H'));
  m.insert(std::make_pair(4, 'D'));
  m.insert(std::make_pair(5, 'E'));
  m.insert(std::make_pair(1, 'A'));
  m.insert(std::make_pair(2, 'B'));
  m.insert(std::make_pair(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
3 D
4 D
5 E
6 F
7 G
8 H

    バージョン

    言語

    • C++03

    処理系

    関連項目

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