GeezerVison is showing cpprefjp.github.io — std::map - cpprefjp C++日本語リファレンス
最終更新日時:
2026年09月30日 11時08分16秒 (JST)
Akira Takahashi
が更新
履歴
編集
class template
<map>
std:: map
namespace std {
template <
class Key ,
class T ,
class Compare = less < Key > ,
class Allocator = allocator < pair < const Key , T > >
>
class map ;
namespace pmr {
template < class Key , class T , class Compare = less < Key >>
using map = std::map < Key , T , Compare ,
polymorphic_allocator < pair < const Key , T >>> ; // C++17から
}
}
概要
map はユニークな要素を格納する連想コンテナの一種であり、キーとそれに対応する値を格納する。
連想コンテナは特にそれらキーによる要素アクセスが効率的になるよう設計されたコンテナである(要素への相対位置または絶対位置によるアクセスが効率的であるシーケンシャルコンテナとは異なる)。
内部的には、map 内の要素は、コンテナの構築時に設定された狭義の弱順序 基準に従って小さいものから大きいものへとソートされる。
map は一般的に、二分木として実装される。従って、連想コンテナである map の主な特性は以下の通りである。
ユニークな要素のキー:互いに等しい二つのキーを持つ要素が map に格納されることは無い。複数の等しいキーを許す同様の連想コンテナは multimap を参照のこと。
要素の値はキーと値のpair型である。
要素は常に狭義の弱順序 に従う。
挿入操作はイテレータや要素の参照に影響を与えない。
このコンテナクラスは、双方向イテレータをサポートする。
概念・前提知識
テンプレートパラメータ
Key: キーの型。キーの値の大小に従って自動的に並び替えられる。
T: 値の型。
pair<const Key, T>: 要素の型。
Compare: 比較クラス。このクラスは 2 つの引数(同じ型)をとり bool 値を返す。狭義の弱順序 において a が b よりも前の場所に位置づけられる場合に true である。これはクラスが関数呼び出しオブジェクトを実装したクラスであっても良いし関数ポインタであっても良い(例は コンストラクタ を参照)。これは、operator<() を適用( a < b )したときと同じ値を返す less<Key> がデフォルトである。
Allocator: ストレージアロケーションモデルを決定づける、アロケータオブジェクトの型である。デフォルトでは、pair<const Key, T> への allocator クラステンプレート(これは値に依存しないシンプルなメモリ確保モデルを定義する)が使われる。
メンバ関数
構築・破棄
イテレータ
名前
説明
対応バージョン
begin
先頭を指すイテレータを取得する
cbegin
先頭を指す読み取り専用イテレータを取得する
C++11
end
末尾の次を指すイテレータを取得する
cend
末尾の次を指す読み取り専用イテレータを取得する
C++11
rbegin
末尾を指す逆イテレータを取得する
crbegin
末尾を指す読み取り専用逆イテレータを取得する
C++11
rend
先頭の前を指す逆イテレータを取得する
crend
先頭の前を指す読み取り専用逆イテレータを取得する
C++11
領域
コンテナの変更
要素アクセス
オブザーバー
メンバ型
名前
説明
対応バージョン
key_type
キーの型。テンプレートパラメータ Key。
value_type
要素の型。std::pair <const Key, T>。
mapped_type
値の型。テンプレートパラメータ T。
key_compare
キー値の大小関係を判定する二項述語の型。テンプレートパラメータ Compare。
value_compare
要素値のキー部分で大小関係を判定する二項述語の型。入れ子クラス
allocator_type
アロケータの型。テンプレートパラメータ Allocator。
reference
要素value_typeへの参照型。value_type&。
const_reference
要素value_typeへのconst参照型。const value_type&。
iterator
双方向イテレータ。
const_iterator
読み取り専用双方向イテレータ。
size_type
要素数を表す符号なし整数型。difference_type で表現可能な非負整数(0以上の整数)を表すことが可能。(通常は size_t )
difference_type
同一のコンテナを指す iterator の差を表す符号付き整数型(通常は ptrdiff_t ) std::iterator_traits <iterator>::difference_type、および、std::iterator_traits <const_iterator>::difference_type と同じ。
pointer
要素 value_typeへのポインタ。 C++98 : typename Allocator::pointer。 C++11以降 : typename allocator_traits <Allocator>::pointer。
const_pointer
要素 value_typeへのconstポインタ。 C++98 : typename Allocator::const_pointer。 C++11以降 : typename allocator_traits <Allocator>::const_pointer。
reverse_iterator
逆順双方向イテレータ。std::reverse_iterator <iterator>。
const_reverse_iterator
読み取り専用逆順双方向イテレータ。std::reverse_iterator <const_iterator>。
node_type
node_handle クラステンプレートの特殊化。
C++17
insert_return_type
ノードを挿入した結果を記述するために使用されるクラス型。以下に示すinsert-return-typeテンプレートの特殊化である。ただし、これは説明用のクラスであり、実装定義 である。
C++17
template < class Iterator , class NodeType >
struct insert - return - type {
Iterator position ;
bool inserted ;
NodeType node ;
};
非メンバ関数
比較演算子
入れ替え
名前
説明
対応バージョン
swap
2つのmapオブジェクトを入れ替える
要素削除
名前
説明
対応バージョン
erase_if
指定した条件に合致する要素とその分の領域を、コンテナから削除する
C++20
推論補助
例
基本的な使い方
出力
10
ユーザー定義型をキーとして使用する (operator<を定義)
#include <iostream>
#include <map>
#include <string>
#include <tuple>
// 要素がひとつの場合
struct MyInt {
int value ;
};
bool operator < ( const MyInt & a , const MyInt & b ) noexcept {
return a . value < b . value ;
}
// 要素が複数の場合
struct Person {
int id ;
int age ;
std::string name ;
};
bool operator < ( const Person & a , const Person & b ) noexcept {
// キーとして比較したい要素を列挙する
return std::tie ( a . id , a . age , a . name ) < std::tie ( b . id , b . age , b . name );
}
int main () {
std::map < MyInt , int > m1 {
{ MyInt { 1 }, 3 },
{ MyInt { 2 }, 1 },
{ MyInt { 3 }, 4 },
};
std::cout << m1 [ MyInt { 2 }] << std::endl ;
std::map < Person , int > m2 {
{ Person { 1 , 18 , "Alice" }, 3 },
{ Person { 2 , 30 , "Bob" }, 1 },
{ Person { 3 , 30 , "Carol" }, 4 },
};
std::cout << m2 [ Person { 2 , 30 , "Bob" }] << std::endl ;
}
出力
1
1
ユーザー定義型をキーとして使用する (大小比較の関数オブジェクトを定義)
#include <iostream>
#include <map>
#include <string>
#include <tuple>
// 要素がひとつの場合
struct MyInt {
int value ;
};
struct MyIntLess {
bool operator ()( const MyInt & a , const MyInt & b ) const noexcept {
return a . value < b . value ;
}
};
// 要素が複数の場合
struct Person {
int id ;
int age ;
std::string name ;
};
struct PersonLess {
bool operator ()( const Person & a , const Person & b ) const noexcept {
// キーとして比較したい要素を列挙する
return std::tie ( a . id , a . age , a . name ) < std::tie ( b . id , b . age , b . name );
}
};
int main () {
std::map < MyInt , int , MyIntLess > m1 {
{ MyInt { 1 }, 3 },
{ MyInt { 2 }, 1 },
{ MyInt { 3 }, 4 },
};
std::cout << m1 [ MyInt { 2 }] << std::endl ;
std::map < Person , int , PersonLess > m2 {
{ Person { 1 , 18 , "Alice" }, 3 },
{ Person { 2 , 30 , "Bob" }, 1 },
{ Person { 3 , 30 , "Carol" }, 4 },
};
std::cout << m2 [ Person { 2 , 30 , "Bob" }] << std::endl ;
}
出力
1
1
ユーザー定義型をキーとして使用する (三方比較演算子を定義) (C++20)
#include <iostream>
#include <map>
#include <string>
// 要素がひとつの場合
struct MyInt {
int value ;
friend auto operator <=> ( const MyInt & , const MyInt & ) = default ;
};
// 要素が複数の場合
struct Person {
int id ;
int age ;
std::string name ;
friend auto operator <=> ( const Person & , const Person & ) = default ;
};
int main () {
std::map < MyInt , int > m1 {
{ MyInt { 1 }, 3 },
{ MyInt { 2 }, 1 },
{ MyInt { 3 }, 4 },
};
std::cout << m1 [ MyInt { 2 }] << std::endl ;
std::map < Person , int > m2 {
{ Person { 1 , 18 , "Alice" }, 3 },
{ Person { 2 , 30 , "Bob" }, 1 },
{ Person { 3 , 30 , "Carol" }, 4 },
};
std::cout << m2 [ Person { 2 , 30 , "Bob" }] << std::endl ;
}
出力
1
1
文字列比較のコストを下げる比較関数オブジェクトの指定方法 (C++14)
出力
4
関連項目
参照