std::multimap<Key,T,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::multimap

メンバ関数

multimap::multimap multimap::~multimap        multimap::operator= multimap::get_allocator

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

非メンバ関数

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

推論補助(C++17)

 

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

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

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

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

(C++11以降)

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

もし std::allocator_traits<allocator_type>::propagate_on_container_move_assignment::value が true ならば、*this のアロケータは other のアロケータのコピーで置き換えられます。もし false で、*this と other のアロケータが等しく比較されない場合、*this は other が所有するメモリを引き継ぐことができず、必要に応じて自身の allocator を使用して追加メモリを確保しながら、各要素を個別に移動代入しなければなりません。いずれの場合も、元々 *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::multimap を別の std::multimap に代入するために operator= を使用しています。

このコードを実行

#include <initializer_list>
#include <iostream>
#include <iterator>
#include <map>
#include <utility>
 
void print(auto const comment, auto const& container)
{
    auto size = std::size(container);
    std::cout << comment << "{ ";
    for (auto const& [key, value] : container)
        std::cout << '{' << key << ',' << value << (--size ? "}, " : "} ");
    std::cout << "}\n";
}
 
int main()
{
    std::multimap<int, int> x{{1,1}, {2,2}, {3,3}}, y, z;
    const auto w = {std::pair<const int, int>{4,4}, {5,5}, {6,6}, {7,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,1}, {2,2}, {3,3} }
y = { }
z = { }
Copy assignment copies data from x to y:
x = { {1,1}, {2,2}, {3,3} }
y = { {1,1}, {2,2}, {3,3} }
Move assignment moves data from x to z, modifying both x and z:
x = { }
z = { {1,1}, {2,2}, {3,3} }
Assignment of initializer_list w to z:
w = { {4,4}, {5,5}, {6,6}, {7,7} }
z = { {4,4}, {5,5}, {6,6}, {7,7} }

関連項目

(コンストラクタ)

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