Namespaces
Variants

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

    From ja.cppreference.net

    C++
    Containers library
    std::multiset
    Member functions
    Non-member functions
    Deduction guides (C++17)
    multiset & operator = ( const multiset & other ) ;
    		(1) (constexpr since C++26)
    (2)
    multiset & operator = ( multiset && other ) ;
    		(since C++11)
    (until C++17)
    multiset & operator = ( multiset && other )
    noexcept ( /* see below */ ) ;
    		(since C++17)
    (constexpr since C++26)
    multiset & operator = ( std:: initializer_list < value_type > ilist ) ;
    		(3) (since C++11)
    (constexpr since C++26)

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

    traits を std:: allocator_traits < allocator_type > とします：

    1) コピー代入演算子。内容を other の内容のコピーで置き換える。

    traits :: propagate_on_container_copy_assignment :: value が true の場合、 * this のアロケータは other のコピーで置き換えられる。代入後の * this のアロケータが古い値と等しくないと比較される場合、古いアロケータを使用してメモリを解放した後、新しいアロケータを使用して要素をコピーする前にメモリを確保する。それ以外の場合、 * this が所有するメモリは可能な場合に再利用される。いずれの場合も、元々 * this に属していた要素は、破棄されるか、要素ごとのコピー代入で置き換えられる可能性がある。

    		(C++11以降)
    2) ムーブ代入演算子。内容を other の内容で置き換える（ムーブセマンティクスを使用、すなわち other のデータが other からこのコンテナにムーブされる）。 other はその後、有効だが未規定の状態となる。
    traits :: propagate_on_container_move_assignment :: value が true の場合、 * this のアロケータは other のアロケータのコピーで置き換えられる。 false であり、かつ * this と other のアロケータが等しくない場合、 * this は other が所有するメモリの所有権を取得できず、各要素を個別にムーブ代入し、必要に応じて自身のアロケータを使用して追加のメモリを確保しなければならない。いずれの場合も、元々 * this に属していたすべての要素は、破棄されるか要素ごとのムーブ代入によって置き換えられる。
    3) 内容を初期化子リスト ilist で指定されたものに置き換えます。

    内容

    パラメータ

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

    戻り値

    * this

    計算量

    1) * this と other のサイズに対して線形。
    2) アロケータが等価でなく伝播しない場合を除き、 * this のサイズに対して線形。その場合、 * this と other のサイズに対して線形。
    3) O(N·log(N)) 一般的には N が size ( ) + ilist. size ( ) の場合。もし ilist が value_comp() に関してソートされている場合は線形時間。

    例外

    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 を通じて検討中である。

    例

    以下のコードは operator = を使用して、一方の std::multiset をもう一方に代入します：

    このコードを実行 
    #include <initializer_list>
#include <iostream>
#include <iterator>
#include <set>
void print(const auto comment, const auto& container)
{
    auto size = std::size(container);
    std::cout << comment << "{ ";
    for (const auto& 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を構築する
    (public member function)