cend.md

cend

• map[meta header]
• std[meta namespace]
• multimap[meta class]
• function[meta id-type]
• cpp11[meta cpp]

const_iterator cend() const noexcept;

概要

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

戻り値

コンテナの末尾の次を参照するイテレータ。 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.cbegin(); i != m.cend() ; ++i ) {
    std::cout << i->first << " " << i->second << "\n";
  }

  return 0;
}

• cend()[color ff0000]
• m.cbegin()[link cbegin.md]
• m.insert[link insert.md]

出力

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

バージョン

言語

• C++11

処理系

• Clang: 3.0 3.1 [mark verified], 3.2 [mark verified], 3.3 [mark verified]
• GCC: ??
• ICC: ??
• Visual C++: ??

関連項目

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