std::multiset

 

C++

コンパイラサポート

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

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

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

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

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

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

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

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

コンテナライブラリ

シーケンス

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

hive (C++26)

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

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

表示

span (C++20)

mdspan (C++23)

表

イテレータの無効化

メンバ関数テーブル

非メンバ関数テーブル

 

std::multiset

メンバ関数

multiset::multiset multiset::~multiset         multiset::operator= multiset::get_allocator

イテレータ multiset::beginmultiset::cbegin (C++11) multiset::endmultiset::cend (C++11) multiset::rbeginmultiset::crbegin (C++11)     multiset::rendmultiset::crend (C++11) 容量 multiset::size multiset::max_size multiset::empty 監視 multiset::key_comp multiset::value_comp 変更 multiset::clear multiset::erase multiset::swap multiset::extract (C++17) multiset::merge (C++17) multiset::insert multiset::insert_range (C++23) multiset::emplace (C++11) multiset::emplace_hint (C++11) 検索 multiset::count multiset::find multiset::contains (C++20) multiset::equal_range multiset::lower_bound multiset::upper_bound

非メンバ関数

std::swap(std::multiset) erase_if(std::multiset) (C++20)   operator==operator<=> (C++20) operator!=operator<operator>operator<=operator>= (C++20まで)(C++20まで)(C++20まで)(C++20まで)(C++20まで)

推論補助(C++17)

 

ヘッダー <set> で定義
template<     class Key,     class Compare = std::less<Key>,     class Allocator = std::allocator<Key> > class multiset;	(1)
namespace pmr {     template<         class Key,         class Compare = std::less<Key>     > using multiset = std::multiset<Key, Compare, std::pmr::polymorphic_allocator<Key>>; }	(2)	(C++17以降)

std::multisetは、Key型のオブジェクトのソート済みセットを格納する連想コンテナである。setとは異なり、等価な値を持つ複数のキーが許可される。ソートはキー比較関数Compareを用いて行われる。探索、挿入、および削除操作は対数時間複雑度を持つ。

標準ライブラリがCompare要件を使用する箇所では常に、Compareで説明されている同値関係を使用して同値性が判定される。不正確な言い方をすれば、2つのオブジェクトaとbは、どちらも他方より小さいと見なされない場合（!comp(a, b) && !comp(b, a)）に等価であると見なされる。

等価と判定される要素の順序は挿入順であり、変更されない。

(C++11以降)

std::multisetはコンテナ (Container)、アロケータ認識コンテナ (AllocatorAwareContainer)、連想コンテナ (AssociativeContainer)、およびリバーシブルコンテナ (ReversibleContainer)の要件を満たす。

std::multisetのすべてのメンバ関数はconstexprである：定数式の評価においてstd::multisetオブジェクトを作成し使用することが可能である。 しかし、std::multisetオブジェクトは一般的にconstexprにはなれない。なぜなら、動的に割り当てられたストレージは同じ定数式の評価内で解放されなければならないからである。

(C++26以降)

メンバ型

型	定義
key_type	Key
value_type	Key
size_type	符号なし整数型 (通常は std::size_t)
difference_type	符号付き整数型 (通常は std::ptrdiff_t)
key_compare	Compare
value_compare	Compare
allocator_type	Allocator
reference	value_type&
const_reference	const value_type&
pointer	Allocator::pointer (C++11まで) std::allocator_traits<Allocator>::pointer (C++11以降)
const_pointer	Allocator::const_pointer (C++11まで) std::allocator_traits<Allocator>::const_pointer (C++11以降)
iterator	value_typeへの定数旧来の双方向イテレータ (LegacyBidirectionalIterator) および定数式イテレータ (ConstexprIterator)(C++26から)
const_iterator	const value_type への LegacyBidirectionalIterator および ConstexprIterator(C++26以降)
reverse_iterator	std::reverse_iterator<iterator>
const_reverse_iterator	std::reverse_iterator<const_iterator>
node_type (C++17以降)	コンテナのノードを表す ノードハンドル の特殊化

メンバ関数

(コンストラクタ)	multisetを構築する (公開メンバ関数)
(デストラクタ)	multisetを破棄する (公開メンバ関数)
operator=	コンテナに値を代入する (公開メンバ関数)
get_allocator	関連付けられたアロケータを返す (公開メンバ関数)
イテレータ
begincbegin (C++11)	先頭へのイテレータを返す (public メンバ関数)
endcend (C++11)	末尾へのイテレータを返す (public メンバ関数)
rbegincrbegin (C++11)	先頭への逆イテレータを返す (public メンバ関数)
rendcrend (C++11)	末尾への逆イテレータを返す (public メンバ関数)
容量
empty	コンテナが空かどうかをチェックする (public メンバ関数)
size	要素数を返す (public メンバ関数)
max_size	可能な最大要素数を返す (public メンバ関数)
変更
clear	内容をクリアする (公開メンバ関数)
insert	要素 またはノード(C++17以降)を挿入する (公開メンバ関数)
insert_range (C++23)	要素の範囲を挿入する (公開メンバ関数)
emplace (C++11)	要素を直接構築する (公開メンバ関数)
emplace_hint (C++11)	ヒントを使用して要素を直接構築する (公開メンバ関数)
erase	要素を削除する (公開メンバ関数)
swap	内容を交換する (public メンバ関数)
extract (C++17)	コンテナからノードを抽出する (公開メンバ関数)
merge (C++17)	他のコンテナからノードを連結する (公開メンバ関数)
検索
count	特定のキーに一致する要素の数を返す (公開メンバ関数)
find	特定のキーを持つ要素を検索する (公開メンバ関数)
contains (C++20)	コンテナが特定のキーを持つ要素を含むか確認する (公開メンバ関数)
equal_range	特定のキーに一致する要素の範囲を返す (公開メンバ関数)
lower_bound	指定されたキーより小さくない最初の要素へのイテレータを返す (公開メンバ関数)
upper_bound	指定されたキーより大きい最初の要素へのイテレータを返す (公開メンバ関数)
監視
key_comp	キーを比較する関数を返す (公開メンバ関数)
value_comp	value_type 型のオブジェクト内のキーを比較する関数を返す (公開メンバ関数)

非メンバ関数

operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20で削除)(C++20で削除)(C++20で削除)(C++20で削除)(C++20で削除)(C++20)	2つのmultisetの値を辞書式比較する (関数テンプレート)
std::swap(std::multiset)	std::swap アルゴリズムを特殊化する (関数テンプレート)
erase_if(std::multiset) (C++20)	特定の基準を満たすすべての要素を削除する (関数テンプレート)

推論補助

(C++17以降)

ノート

メンバ型 iterator と const_iterator は同じ型へのエイリアスかもしれない。これは、これら2つの型をパラメータ型として使用する関数オーバーロードのペアを定義すると、ODR (One Definition Rule) に違反する可能性があることを意味する。iterator は const_iterator に変換可能なので、代わりに const_iterator をパラメータ型として持つ単一の関数が機能する。

機能テストマクロ	値	規格	機能
__cpp_lib_containers_ranges	202202L	(C++23)	コンテナのRangeコンストラクタとRange挿入
__cpp_lib_constexpr_containers	202502L	(C++26)	constexpr std::multiset

欠陥報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 103	C++98	イテレータがキーの変更を許可する	イテレータが定数になった
LWG 230	C++98	Key が CopyConstructible であることを要求されていなかった (Key 型のキーが構築できない可能性があった)	Key には次のことも要求される CopyConstructible であること

関連項目

set	ユニークなキーのコレクション、キーによってソートされる (class template)
unordered_multiset (C++11)	キーのコレクション、キーによってハッシュ化される (class template)
flat_multiset (C++23)	コンテナを適応させ、キーでソートされたキーのコレクションを提供する (クラステンプレート)