std::deque::operator=

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека контейнеров

Последовательные

array (C++11)

vector

vector<bool>

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::deque

Типы элементы

Функции-элементы

deque::deque

deque::~deque

deque::operator=

deque::assign

deque::assign_range (C++23)

deque::get_allocator

Доступ к элементам

deque::at

deque::operator[]

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 (DR*)

Модификаторы

deque::clear

deque::insert

deque::insert_range (C++23)

deque::emplace

deque::erase

deque::push_front

deque::emplace_front

deque::prepend_range (C++23)

deque::pop_front

deque::push_back

deque::emplace_back (C++11)

deque::append_range (C++23)

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(/* смотрите ниже */);			(начиная с 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 находится в корректном, но неопределенном состоянии. Если std::allocator_traits<allocator_type>::propagate_on_container_move_assignment::value равно true, то аллокатор текущего контейнера заменяется копией аллокатора присваиваемого. Если же это значение false и аллокаторы текущего и присваиваемого контейнера не равны, то, поскольку текущий контейнер не может завладеть памятью присваиваемого, он вынужден присвоить перемещением каждый элемент по отдельности, выделяя дополнительную память с помощью своего аллокатора если потребуется. В любом случае все элементы изначально находящиеся в *this либо уничтожаются либо заменяются путём поэлементного присваивания.

3) Заменяет текущее содержимое содержимым ilist.

Параметры

other	—	другой контейнер, используемый как источник данных
ilist	—	список инициализаторов, используемый как источник данных

Возвращаемое значение

*this

Сложность

1) Линейная от размера *this и other.

2) Линейная от размера *this, помимо случая, когда аллокаторы не равны и не распространяются при присваивании, в котором линейная от размера *this и other.

3) Линейная от размера *this и ilist.

Исключения 2) спецификация noexcept:   noexcept(std::allocator_traits<Allocator>::is_always_equal::value)

(начиная с C++17)

Примечания

После присвоения перемещением (перегрузка (2)), помимо случая, когда поэлементное присвоение произошло по причине несовместимых аллокаторов, ссылки, указатели и итераторы (кроме end итератора) из other остаются корректными, но ссылаются на элементы, которые теперь находятся в *this. Текущий стандарт даёт такую гарантию согласно общему утверждению из [container.requirements.general]/12, более прямая гарантия рассматривается в [lwg-2321].

Пример

Код ниже использует operator= для того, чтобы присвоить один std::deque другому:

Запустить этот код

#include <deque>#include <iostream>   void display_sizes(charconst* comment, conststd::deque<int>& nums1, conststd::deque<int>& nums2, conststd::deque<int>& nums3){std::cout<< comment <<" nums1: "<< nums1.size()<<','<<" nums2: "<< nums2.size()<<','<<" nums3: "<< nums3.size()<<'\n';}   void display(charconst* comment, conststd::deque<int>& v){std::cout<< comment <<"{ ";for(int e : v){std::cout<< e <<' ';}std::cout<<"}\n";}   int main(){std::deque<int> nums1 {3, 1, 4, 6, 5, 9};std::deque<int> nums2;std::deque<int> nums3;   display_sizes("Сначала:\n", nums1, nums2, nums3);   // присвоение копированием копирует данные nums1 в nums2 nums2 = nums1;   display_sizes("После присвоения:\n", nums1, nums2, nums3);   // присвоение перемещением перемещает данные из nums1 в nums3,// изменяя, как nums1, так и nums3 nums3 = std::move(nums1);   display_sizes("После присвоения перемещением:\n", nums1, nums2, nums3);   display("Теперь nums3 = ", nums3);   // Присвоение копированием списка инициализаторов копирует данные в nums3 nums3 ={1, 2, 3};   display("После присвоения initializer_list \n nums3 = ", nums3);}

Вывод:

Сначала: nums1: 6, nums2: 0, nums3: 0 После присвоения: nums1: 6, nums2: 6, nums3: 0 После присвоения перемещением: nums1: 0, nums2: 6, nums3: 6 Now nums3 = { 3 1 4 6 5 9 } После присвоения initializer_list nums3 = { 1 2 3 }

См. также

(конструктор)	создаёт deque (public функция-элемент)
assign	присваивает значения контейнеру (public функция-элемент)