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
概要
map
コンテナの末尾の次を参照するイテレータを取得する。
戻り値
コンテナの末尾の次を参照するイテレータ。
iterator
と const_iterator
はいずれもメンバ型である。map
クラステンプレートにおいて、これらは双方向イテレータである。
計算量
定数時間
備考
- この関数によって返されるイテレータは、
*this
が保持するいずれの要素も参照しない。その指す先は、不正な範囲となるだろう
例
#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
処理系
- Clang: 2.9 ✅, 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅
- GCC: ??
- ICC: ??
- Visual C++: ??
関連項目
名前 | 説明 |
---|---|
map::begin |
先頭を指すイテレータを取得する |
map::cbegin |
先頭を指すconstイテレータを取得する |
map::cend |
末尾の次を指すconstイテレータを取得する |
map::rbegin |
末尾を指す逆イテレータを取得する |
map::rend |
先頭の前を指す逆イテレータを取得する |
map::crbegin |
末尾を指す逆constイテレータを取得する |
map::crend |
先頭の前を指す逆constイテレータを取得する |