std::hive<T,Allocator>::swap

void swap( hive& other ) noexcept(/* see description */);

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

Обменивает содержимое, ёмкость и current-limits контейнера с соответствующими параметрами other. Не вызывает операции перемещения, копирования или обмена для отдельных элементов.

Все итераторы и ссылки остаются действительными. Не определено, будет ли итератор, хранящий значение end() этого контейнера, ссылаться на этот или другой контейнер после выполнения операции.

Если std::allocator_traits<allocator_type>::propagate_on_container_swap::value имеет значение true, то аллокаторы обмениваются с помощью неквалифицированного вызова нестатической функции swap. В противном случае они не обмениваются (а если get_allocator() != other.get_allocator(), поведение не определено).

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

Параметры

other

контейнер, с которым нужно обменяться содержимым

Сложность

Константная.

Исключения

noexcept спецификация:

noexcept(std::allocator_traits<Allocator>::propagate_on_container_swap::value ||
         std::allocator_traits<Allocator>::is_always_equal::value)

Пример

#include <hive>
#include <print>

int main()
{
    std::hive<int> a1{1, 2, 3}, a2{4, 5};

    auto it1 = std::next(a1.begin());
    auto it2 = std::next(a2.begin());

    int& ref1 = *a1.begin();
    int& ref2 = *a2.begin();

    std::println("{} {} {} {} {} {}", a1, a2, *it1, *it2, ref1, ref2);
    a1.swap(a2);
    std::println("{} {} {} {} {} {}", a1, a2, *it1, *it2, ref1, ref2);

    // Note that after swap the iterators and references stay associated with their
    // original elements, e.g., it1 that pointed to an element in 'a1' with value 2
    // still points to the same element, though this element was moved into 'a2'.
}

Вывод:

[1, 2, 3] [4, 5] 2 5 1 4
[4, 5] [1, 2, 3] 2 5 1 4

См. также

std::swap(std::hive)

(C++26)

специализирует алгоритм std::swap
(шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/hive/swap