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

メンバ関数
list::list list::~list list::operator= list::assign list::assign_range (C++23)   list::get_allocator 要素アクセス list::front list::back イテレータ list::beginlist::cbegin (C++11) list::endlist::cend (C++11) list::rbeginlist::crbegin (C++11) list::rendlist::crend (C++11) 容量 list::size list::empty list::max_size	変更 list::clear list::insert list::insert_range (C++23) list::emplace (C++11) list::erase list::push_front list::emplace_front (C++11) list::prepend_range (C++23) list::pop_front list::push_back list::emplace_back (C++11) list::append_range (C++23) list::pop_back list::resize list::swap 操作 list::merge list::splice list::removelist::remove_if list::reverse list::unique list::sort
非メンバ関数
operator==operator<=> (C++20) swap(std::list) erase(std::list)erase_if(std::list) (C++20)(C++20)	operator!=operator<operator>operator<=operator>= (C++20まで)(C++20まで)(C++20まで)(C++20まで)(C++20まで)
推論補助(C++17)

 

list& operator=( const list& other );	(1)
	(2)
list& operator=( list&& other );			(C++11以降) (C++17まで)
list& operator=( list&& other ) noexcept(/* 以下参照 */);			(C++17以降)
list& 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) *this および ilist のサイズに対する線形。

例外

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

注釈

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

例

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

このコードを実行

#include <initializer_list>
#include <iostream>
#include <iterator>
#include <list>
 
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::list<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 }

関連項目

(コンストラクタ)	list を構築します (公開メンバ関数)
代入する	コンテナに値を代入する (公開メンバ関数)