std::forward_list<T,Allocator>:: operator=
From ja.cppreference.net
<
cpp
|
container
|
forward list
|
forward_list
&
operator
=
(
const
forward_list
&
other
)
;
|
(1) |
(C++11以降)
(C++26以降 constexpr) |
| (2) | ||
|
forward_list
&
operator
=
(
forward_list
&&
other
)
;
|
(C++11以降)
(C++17まで) |
|
|
forward_list
&
operator
=
(
forward_list
&&
other
)
noexcept ( /* 下記参照 */ ) ; |
(C++17以降)
(C++26以降 constexpr) |
|
|
forward_list
&
operator
=
(
std::
initializer_list
<
value_type
>
ilist
)
;
|
(3) |
(C++11以降)
(C++26以降 constexpr) |
コンテナの内容を置き換えます。
traits
を
std::
allocator_traits
<
allocator_type
>
とします：
1)
コピー代入演算子。内容を
other
の内容のコピーで置き換えます。
traits
::
propagate_on_container_copy_assignment
::
value
が
true
の場合、
*
this
のアロケータは
other
のコピーで置き換えられる。代入後の
*
this
のアロケータが古い値と等しくないと比較される場合、古いアロケータを使用してメモリを解放した後、新しいアロケータを使用して要素をコピーする前にメモリを確保する。それ以外の場合、
*
this
が所有するメモリは可能な場合に再利用される。いずれの場合も、元々
*
this
に属していた要素は、破棄されるか、要素ごとのコピー代入によって置き換えられる可能性がある。
2)
ムーブ代入演算子。内容を
other
の内容で置き換える（ムーブセマンティクスを使用、すなわち
other
のデータが
other
からこのコンテナにムーブされる）。
other
はその後、有効だが未規定の状態となる。
traits
::
propagate_on_container_move_assignment
::
value
が
true
の場合、
*
this
のアロケータは
other
のアロケータのコピーで置き換えられる。
false
であり、かつ
*
this
と
other
のアロケータが等しくない場合、
*
this
は
other
が所有するメモリの所有権を取得できず、各要素を個別にムーブ代入し、必要に応じて自身のアロケータを使用して追加のメモリを確保しなければならない。いずれの場合も、元々
*
this
に属していたすべての要素は、破棄されるか要素ごとのムーブ代入によって置き換えられる。
3)
内容を初期化子リスト
ilist
で指定されたものに置き換えます。
目次パラメータ
戻り値* this 計算量
1)
*
this
と
other
のサイズに対して線形。
2)
アロケータが等価ではなく伝播しない場合を除き、
*
this
のサイズに対して線形。その場合、
*
this
と
other
のサイズに対して線形。
3)
*
this
および
ilist
のサイズに対して線形。
例外
注記コンテナのムーブ代入（オーバーロード (2)）の後、互換性のないアロケータによって要素単位のムーブ代入が強制されない限り、元々 例以下のコードは operator = を使用して、ある std::forward_list を別のものに代入します：
このコードを実行
#include <initializer_list> #include <iostream> #include <iterator> #include <forward_list> void print(const auto comment, const auto& container) { auto size = std::ranges::distance(container); std::cout << comment << "{ "; for (const auto& 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 }
関連項目
|