std::unordered_multiset<Key,Hash,KeyEqual,Allocator>:: swap
|
void
swap
(
unordered_multiset
&
other
)
;
|
(начиная с C++11)
(до C++17) |
|
|
void
swap
(
unordered_multiset
&
other
)
noexcept
(
/* see below */
)
;
|
(начиная с C++17)
(constexpr начиная с C++26) |
|
Обменивает содержимое контейнера с содержимым other . Не вызывает никаких операций перемещения, копирования или обмена для отдельных элементов.
Все итераторы и ссылки остаются действительными. Итератор
end()
инвалидируется.
Hash
и
KeyEqual
должны быть
Swappable
, и объекты этих типов обмениваются с помощью неквалифицированных вызовов нечленной функции
swap
.
Если
std::
allocator_traits
<
allocator_type
>
::
propagate_on_container_swap
::
value
равно
true
, то аллокаторы обмениваются с помощью неквалифицированного вызова нечленной функции
swap
. В противном случае они не обмениваются (и если
get_allocator
(
)
!
=
other.
get_allocator
(
)
, поведение не определено).
Содержание |
Параметры
| other | - | контейнер для обмена содержимым |
Исключения
|
Любое исключение, выброшенное при обмене объектов
|
(до C++17) |
|
noexcept
спецификация:
noexcept
(
std::
allocator_traits
<
Allocator
>
::
is_always_equal
::
value
&&
std::
is_nothrow_swappable
<
Hash
>
::
value
|
(начиная с C++17) |
Сложность
Константа.
Пример
#include <iostream> #include <unordered_set> template<class Os, class Co> Os& operator<<(Os& os, const Co& co) { os << '{'; for (const auto& i : co) os << ' ' << i; return os << " } "; } int main() { std::unordered_multiset<int> a1{3, 1, 3, 2}, a2{5, 4, 5}; auto it1 = std::next(a1.begin()); auto it2 = std::next(a2.begin()); const int& ref1 = *(a1.begin()); const int& ref2 = *(a2.begin()); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; a1.swap(a2); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; // Обратите внимание, что каждый итератор, ссылающийся на элемент в одном контейнере до обмена, // ссылается на тот же элемент в другом контейнере после обмена. То же самое верно // для ссылок. }
Возможный вывод:
{ 2 3 3 1 } { 4 5 5 } 3 5 2 4
{ 4 5 5 } { 2 3 3 1 } 3 5 2 4
Смотрите также
|
специализирует алгоритм
std::swap
(шаблон функции) |