std::deque<T,Allocator>::operator=

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

コンテナライブラリ

array (C++11)

vector

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

span (C++20)

 

std::deque

メンバ関数

deque::deque

deque::~deque

deque::operator=

deque::assign

deque::get_allocator

要素アクセス

deque::front

deque::back

イテレータ

deque::begindeque::cbegin (C++11)

deque::enddeque::cend (C++11)

deque::rbegindeque::crbegin (C++11)

deque::renddeque::crend (C++11)

容量

deque::empty

deque::size

deque::max_size

deque::shrink_to_fit

変更

deque::clear

deque::insert

deque::emplace

deque::erase

deque::push_front

deque::emplace_front

deque::pop_front

deque::push_back

deque::emplace_back

deque::pop_back

deque::resize

deque::swap

非メンバ関数

std::swap

eraseerase_if (C++20)(C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)

推定ガイド(C++17)

 

deque& operator=(const deque& other );	(1)
	(2)
deque& operator=( deque&& other );			(C++11以上) (C++17未満)
deque& operator=( deque&& other )noexcept(/* see below */);			(C++17以上)
deque& operator=(std::initializer_list<T> ilist );		(3)	(C++11以上)

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

1) コピー代入演算子。 内容を other の内容のコピーで置き換えます。 std::allocator_traits<allocator_type>::propagate_on_container_copy_assignment::value が true の場合、ターゲットのアロケータはソースのアロケータのコピーで置き換えられます。 ターゲットとソースのアロケータを比較して等しくない場合、ターゲット (*this) のアロケータがメモリを解放するための使用され、その後、要素をコピーする前に、 other のアロケータがメモリを確保するために使用されます。(C++11以上)

2) ムーブ代入演算子。 内容をムーブセマンティクスを用いて other の内容で置き換えます (つまり other のデータが other からこのコンテナにムーブされます)。 処理後 other は有効ですが未規定の状態になります。 std::allocator_traits<allocator_type>::propagate_on_container_move_assignment::value が true の場合、ターゲットのアロケータはソースのアロケータのコピーで置き換えられます。 false の場合、ソースとターゲットのアロケータを比較して等しくなければ、ターゲットはソースのメモリの所有権を取得することができず、必要に応じて自身のアロケータを使用して追加のメモリを確保し、個々の要素を個別にムーブ代入しなければなりません。 いずれの場合でも、元々 *this に格納されていたすべての要素は、破壊されるか、要素単位のムーブ代入によって置き換えられます。

3) 内容を初期化子リスト ilist によって表された内容で置き換えます。

引数

other	-	データソースとして使用される別のコンテナ
ilist	-	データソースとして使用される初期化子リスト

戻り値

*this。

計算量

1)*this と other のサイズに比例。

2) アロケータが比較して等しくなく、伝播しない場合、 *this と other のサイズに比例。 そうでなければ、 *this のサイズに比例。

3)*this と ilist のサイズに比例。

例外 2) noexcept 指定:   noexcept(std::allocator_traits<Allocator>::is_always_equal::value)

(C++17以上)

ノート

コンテナのムーブ代入 (オーバーロード (2)) の後、アロケータの非互換によって要素単位のムーブ代入が強制されない限り、 other を指す参照、ポインタ、イテレータ (終端イテレータを除く) は有効なままですが、 *this 内の要素を参照するようになります。 現行の標準ではこの保証は [container.requirements.general]/12 の包括的な文言によってなされていますが、より直接的な保証が LWG issue 2321 で検討されています。

例

以下のコードは operator= を使用して std::deque を別の std::deque に代入します。

Run this code

#include <deque>#include <iostream>   void display_sizes(conststd::deque<int>& nums1, conststd::deque<int>& nums2, conststd::deque<int>& nums3){std::cout<<"nums1: "<< nums1.size()<<" nums2: "<< nums2.size()<<" nums3: "<< nums3.size()<<'\n';}   int main(){std::deque<int> nums1 {3, 1, 4, 6, 5, 9};std::deque<int> nums2;std::deque<int> nums3;   std::cout<<"Initially:\n"; display_sizes(nums1, nums2, nums3);   // copy assignment copies data from nums1 to nums2 nums2 = nums1;   std::cout<<"After assigment:\n"; display_sizes(nums1, nums2, nums3);   // move assignment moves data from nums1 to nums3,// modifying both nums1 and nums3 nums3 = std::move(nums1);   std::cout<<"After move assigment:\n"; display_sizes(nums1, nums2, nums3);}

出力:

Initially: nums1: 6 nums2: 0 nums3: 0 After assigment: nums1: 6 nums2: 6 nums3: 0 After move assigment: nums1: 0 nums2: 6 nums3: 6

関連項目

コンストラクタ	deque を構築します (パブリックメンバ関数)
assign	コンテナに値を代入します (パブリックメンバ関数)