std::unordered_multimap

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

入出力ライブラリ

ローカライゼーションライブラリ

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

ファイルシステムライブラリ (C++17)

技術仕様書

 

コンテナライブラリ

array (C++11)

vector

deque

forward_list (C++11)

list

set

multiset

map

multimap

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

stack

queue

priority_queue

span (C++20)

 

std::unordered_multimap

メンバ関数

unordered_multimap::unordered_multimap

unordered_multimap::~unordered_multimap

unordered_multimap::operator=

unordered_multimap::get_allocator

イテレータ

unordered_multimap::beginunordered_multimap::cbegin

unordered_multimap::endunordered_multimap::cend

容量

unordered_multimap::empty

unordered_multimap::size

unordered_multimap::max_size

変更

unordered_multimap::clear

unordered_multimap::insert

unordered_multimap::emplace

unordered_multimap::emplace_hint

unordered_multimap::erase

unordered_multimap::swap

unordered_multimap::extract (C++17)

unordered_multimap::merge (C++17)

検索

unordered_multimap::count

unordered_multimap::find

unordered_multimap::contains (C++20)

unordered_multimap::equal_range

バケットインタフェース

unordered_multimap::begin(size_type)unordered_multimap::cbegin(size_type)

unordered_multimap::end(size_type)unordered_multimap::cend(size_type)

unordered_multimap::bucket_count

unordered_multimap::max_bucket_count

unordered_multimap::bucket_size

unordered_multimap::bucket

ハッシュポリシー

unordered_multimap::load_factor

unordered_multimap::max_load_factor

unordered_multimap::rehash

unordered_multimap::reserve

観察

unordered_multimap::hash_function

unordered_multimap::key_eq

推定ガイド(C++17)

 

ヘッダ <unordered_map> で定義
template<     class Key,     class T,     class Hash = std::hash<Key>,     class KeyEqual = std::equal_to<Key>,     class Allocator = std::allocator< std::pair<const Key, T> > > class unordered_multimap;	(1)	(C++11以上)
namespace pmr {     template <class Key, class T,               class Hash = std::hash<Key>,               class Pred = std::equal_to<Key>>     using unordered_multimap = std::unordered_multimap<Key, T, Hash, Pred,                                    std::pmr::polymorphic_allocator<std::pair<const Key,T>>>; }	(2)	(C++17以上)

unordered multimap は等しいキーをサポートする非順序連想コンテナで、キーを異なる型の値に関連付けます。 unordered_multimap は各キーのコピーを複数格納できます。 unordered_multimap は前方イテレータをサポートします。 検索、挿入、削除は平均定数時間の計算量を持ちます。

内部的には、要素は特定の順序にソートされず、複数のバケットにまとめられます。 要素がどのバケットに配置されるかはもっぱらその値のハッシュに依存します。 これにより、いったんハッシュが計算されればその要素が配置される正確なバケットを参照できるため、個々の要素への高速なアクセスが可能になります。

このコンテナのイテレーション順序が安定であることは要求されません (そのため、例えば2つの std::unordered_multimap を比較するために std::equal を使うことはできません) が、キーが同等 (key_eq() で比較して等しい) である要素のグループは、イテレーション順序において隣接した範囲を形成します。 この範囲は equal_range() でアクセスできます。

std::unordered_multimap は Container, AllocatorAwareContainer, UnorderedAssociativeContainer の要件を満たします。

メンバ型

メンバ型	定義
key_type	Key
mapped_type	T
value_type	std::pair<const Key, T>
size_type	符号なし整数型 (通常 std::size_t)
difference_type	符号付き整数型 (通常 std::ptrdiff_t)
hasher	Hash
key_equal	KeyEqual (C++20未満) 定義されていて型を表す場合は Hash::transparent_key_equal、そうでなければ KeyEqual (C++20以上)
allocator_type	Allocator
reference	value_type&
const_reference	const value_type&
pointer	std::allocator_traits<Allocator>::pointer
const_pointer	std::allocator_traits<Allocator>::const_pointer
iterator	LegacyForwardIterator
const_iterator	const LegacyForwardIterator
local_iterator	カテゴリおよび value, difference, pointer, reference の各型が iterator と同じイテレータ型。 このイテレータはバケット内をイテレートするために使用することができますが、別のバケットには移動できません
const_local_iterator	カテゴリおよび value, difference, pointer, reference の各型が const_iterator と同じイテレータ型。 このイテレータはバケット内をイテレートするために使用することができますが、別のバケットには移動できません
node_type (C++17以上)	コンテナノードを表すノードハンドルの特殊化

メンバ関数

コンストラクタ	unordered_multimap を構築します (パブリックメンバ関数)
デストラクタ	unordered_multimap を破棄します (パブリックメンバ関数)
operator=	コンテナに値を代入します (パブリックメンバ関数)
get_allocator	関連付けられているアロケータを返します (パブリックメンバ関数)
イテレータ
begin cbegin	先頭を指すイテレータを返します (パブリックメンバ関数)
end cend	終端を指すイテレータを返します (パブリックメンバ関数)
容量
empty	コンテナが空かどうか調べます (パブリックメンバ関数)
size	要素数を返します (パブリックメンバ関数)
max_size	可能な最大の要素数を返します (パブリックメンバ関数)
変更
clear	すべての要素を削除します (パブリックメンバ関数)
insert	要素またはノード (C++17以上)を挿入します (パブリックメンバ関数)
emplace	要素をその場で構築します (パブリックメンバ関数)
emplace_hint	ヒントを使用して要素をその場で構築します (パブリックメンバ関数)
erase	要素を削除します (パブリックメンバ関数)
swap	内容を入れ替えます (パブリックメンバ関数)
extract (C++17)	コンテナからノードを抽出します (パブリックメンバ関数)
merge (C++17)	他のコンテナからノードを接合します (パブリックメンバ関数)
検索
count	指定されたキーと一致する要素の数を返します (パブリックメンバ関数)
find	指定されたキーを持つ要素を探します (パブリックメンバ関数)
contains (C++20)	コンテナが指定されたキーを持つ要素を格納しているかどうか調べます (パブリックメンバ関数)
equal_range	指定されたキーに一致する要素の範囲を返します (パブリックメンバ関数)
バケットインタフェース
begin(size_type) cbegin(size_type)	指定されたバケットの先頭を指すイテレータを返します (パブリックメンバ関数)
end(size_type) cend(size_type)	指定されたバケットの終端を指すイテレータを返します (パブリックメンバ関数)
bucket_count	バケットの数を返します (パブリックメンバ関数)
max_bucket_count	バケットの最大数を返します (パブリックメンバ関数)
bucket_size	特定のバケットの要素数を返します (パブリックメンバ関数)
bucket	指定されたキーのためのバケットを返します (パブリックメンバ関数)
ハッシュポリシー
load_factor	バケットあたりの平均要素数を返します (パブリックメンバ関数)
max_load_factor	バケットあたりの平均要素数の最大値を管理します (パブリックメンバ関数)
rehash	少なくとも指定された数のバケットを予約します。 これによりハッシュテーブルが再生成されます。 (パブリックメンバ関数)
reserve	少なくとも指定された数の要素のための空間を予約します。 これによりハッシュテーブルが再生成されます。 (パブリックメンバ関数)
観察
hash_function	キーをハッシュするために使用される関数を返します (パブリックメンバ関数)
key_eq	キーが等しいかどうかを比較するために使用される関数を返します (パブリックメンバ関数)

非メンバ関数

operator==operator!=	unordered_multimap 内の値を比較します (関数テンプレート)
std::swap(std::unordered_multimap) (C++11)	std::swap アルゴリズムの特殊化 (関数テンプレート)
erase_if(std::unordered_multimap) (C++20)	特定の基準を満たすすべての要素を削除します (関数テンプレート)