std::multiset<Key,Compare,Allocator>::operator=

 

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)

 

multiset& operator=( const multiset& other );	(1)
	(2)
multiset& operator=( multiset&& other );			(C++11以降) (C++17まで)
multiset& operator=( multiset&& other ) noexcept(/* see below */);			(C++17以降)
multiset& operator=( std::initializer_list<value_type> ilist );		(3)	(C++11以降)

コンテナの内容を置き換えます。

1) コピー代入演算子。コンテナの内容を other の内容のコピーで置き換えます。

もし allocator_type のアロケータの propagate_on_container_copy_assignment の value が true ならば、*this のアロケータは other のコピーで置き換えられます。*this のアロケータが代入後にその古い値と等しくないと比較される場合、古いアロケータはメモリを解放するために使用され、次に新しいアロケータが要素をコピーするために使用されます。そうでなければ、*this が所有するメモリは可能な場合に再利用されることがあります。いずれの場合も、*this の元の要素は破棄されるか、要素ごとのコピー代入で置き換えられる可能性があります。

(C++11以降)

2) ムーブ代入演算子。コンテナの内容を other の内容で、ムーブセマンティクスを使用して置き換えます（すなわち、other のデータが other からこのコンテナに移動されます）。その後、other は有効ですが未指定の状態になります。

allocator_type のアロケータの propagate_on_container_move_assignment の value が true ならば、*this のアロケータは other のアロケータのコピーで置き換えられます。false であり、*this と other のアロケータが等しくないと比較される場合、*this は other が所有するメモリを引き継ぐことができず、必要に応じて独自のアロケータを使用して追加のメモリを割り当てながら、各要素を個別に移動代入する必要があります。いずれの場合も、*this の元のすべての要素は破棄されるか、要素ごとの移動代入で置き換えられる可能性があります。

3) コンテナの内容を初期化リスト ilist で指定された内容で置き換えます。

パラメータ

その他	-	データソースとして使用する別のコンテナ
ilist	-	データソースとして使用する初期化リスト

戻り値

*this

計算量

1) *this および other のサイズに対する線形。

2) アロケータが等しくなく、かつ伝播しない場合を除き、*this のサイズに対する線形。この場合、*this および other のサイズに対する線形。

3) 一般的には O(NlogN) です。ここで N は size() + ilist.size() です。ilist が value_comp() に関してソートされている場合は線形です。

例外

1-3) 実装定義の例外を投げる可能性があります。	(C++17まで)
1,3) 実装定義の例外を投げる可能性があります。 2) noexcept 指定:   noexcept(std::allocator_traits<Allocator>::is_always_equal::value && std::is_nothrow_move_assignable<Compare>::value)	(C++17以降)

注釈

コンテナのムーブ代入後（オーバーロード (2)）、互換性のないアロケータによる要素ごとのムーブ代入が強制されない限り、other への参照、ポインタ、およびイテレータ（終端イテレータを除く）は有効なままですが、*this に含まれるようになった要素を参照します。現在の標準では、[container.reqmts]/67 の包括的な声明によりこの保証が提供されており、LWG issue 2321 を通じてより直接的な保証が検討されています。

例

以下のコードは、ある std::multiset を別の multiset に代入するために operator= を使用しています。

このコードを実行

#include <initializer_list>
#include <iostream>
#include <iterator>
#include <set>
 
void print(auto const comment, auto const& container)
{
    auto size = std::size(container);
    std::cout << comment << "{ ";
    for (auto const& element : container)
        std::cout << element << (--size ? ", " : " ");
    std::cout << "}\n";
}
 
int main()
{
    std::multiset<int> x{1, 2, 3}, y, z;
    const auto w = {4, 5, 6, 7};
 
    std::cout << "Initially:\n";
    print("x = ", x);
    print("y = ", y);
    print("z = ", z);
 
    std::cout << "Copy assignment copies data from x to y:\n";
    y = x;
    print("x = ", x);
    print("y = ", y);
 
    std::cout << "Move assignment moves data from x to z, modifying both x and z:\n";
    z = std::move(x);
    print("x = ", x);
    print("z = ", z);
 
    std::cout << "Assignment of initializer_list w to z:\n";
    z = w;
    print("w = ", w);
    print("z = ", z);
}

出力

Initially:
x = { 1, 2, 3 }
y = { }
z = { }
Copy assignment copies data from x to y:
x = { 1, 2, 3 }
y = { 1, 2, 3 }
Move assignment moves data from x to z, modifying both x and z:
x = { }
z = { 1, 2, 3 }
Assignment of initializer_list w to z:
w = { 4, 5, 6, 7 }
z = { 4, 5, 6, 7 }

関連項目

(コンストラクタ)

multisetを構築します (公開メンバ関数)