std::multimap::end

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

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

概要

multimap コンテナの末尾の次を参照するイテレータを取得する。

戻り値

コンテナの末尾の次を参照するイテレータ。 iterator と const_iterator はいずれもメンバ型である。multimap クラステンプレートにおいて、これらは双方向イテレータである。

計算量

定数時間

備考

• この関数によって返されるイテレータは、*thisが保持するいずれの要素も参照しない。その指す先は、不正な範囲となるだろう

例

#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

処理系

• Clang: 2.9 ✅, 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅
• GCC: ??
• ICC: ??
• Visual C++: ??

関連項目