std::forward_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::forward_list

メンバ関数
forward_list::forward_list forward_list::~forward_list forward_list::operator= forward_list::assign forward_list::assign_range (C++23)   forward_list::get_allocator 要素アクセス forward_list::front イテレータ forward_list::before_beginforward_list::cbefore_begin forward_list::beginforward_list::cbegin forward_list::endforward_list::cend 容量 forward_list::empty forward_list::max_size	変更 forward_list::clear forward_list::emplace_front forward_list::push_front forward_list::insert_after forward_list::emplace_after forward_list::erase_after forward_list::insert_range_after (C++23) forward_list::prepend_range (C++23) forward_list::pop_front forward_list::resize forward_list::swap 操作 forward_list::merge forward_list::splice_after forward_list::removeforward_list::remove_if forward_list::reverse forward_list::unique forward_list::sort
非メンバ関数
operator==operator<=> (C++20) swap(std::forward_list) erase(std::forward_list)erase_if(std::forward_list) (C++20)(C++20)	operator!=operator<operator>operator<=operator>= (C++20まで)(C++20まで)(C++20まで)(C++20まで)(C++20まで)
推論ガイド (C++17)

 

forward_list& operator=( const forward_list& other );	(1)	(C++11以降)
	(2)
forward_list& operator=( forward_list&& other );			(C++11以降) (C++17まで)
forward_list& operator=( forward_list&& other ) noexcept(/* 以下参照 */);			(C++17以降)
forward_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 に属していた要素は破棄されるか、要素ごとのコピー代入で置き換えられる可能性があります。

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 を通じてより直接的な保証が検討されています。

例

次のコードは、operator= を使用して、ある std::forward_list を別のものに代入します。

このコードを実行

#include <initializer_list>
#include <iostream>
#include <iterator>
#include <forward_list>
 
void print(auto const comment, auto const& container)
{
    auto size = std::ranges::distance(container);
    std::cout << comment << "{ ";
    for (auto const& element : container)
        std::cout << element << (--size ? ", " : " ");
    std::cout << "}\n";
}
 
int main()
{
    std::forward_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 }

関連項目

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