std::map<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::map

メンバ関数

map::map map::~map               map::operator= map::get_allocator

要素アクセス map::at map::operator[] イテレータ map::beginmap::cbegin (C++11) map::endmap::cend (C++11) map::rbeginmap::crbegin (C++11)      map::rendmap::crend (C++11) 容量 map::size map::max_size map::empty 監視 map::key_comp map::value_comp 変更 map::clear map::insert map::erase map::swap map::extract (C++17) map::merge (C++17) map::insert_range (C++23) map::insert_or_assign (C++17) map::emplace (C++11) map::emplace_hint (C++11) map::try_emplace (C++17) 検索 map::count map::find map::contains (C++20) map::equal_range map::lower_bound map::upper_bound

非メンバ関数

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

推論補助 (C++17)

 

map& operator=( const map& other );	(1)
	(2)
map& operator=( map&& other );			(C++11以降) (C++17まで)
map& operator=( map&& other ) noexcept(/* see below */);			(C++17以降)
map& 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が所有するメモリの所有権を取得できず、必要に応じて自身のメモリを使用して各要素を個別に移動代入しなければなりません。いずれの場合も、*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 を通じてより直接的な保証が検討されています。

例

次のコードは、operator=を使用して1つのstd::mapを別のmapに代入しています。

このコードを実行

#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::map<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} }

関連項目

(コンストラクタ)

mapを構築する (公開メンバ関数)