std::swap(std::queue)

Определено в заголовке <queue>

Определено в заголовке `<queue>`
template< class T, class Container > void swap( std::queue<T, Container>& lhs, std::queue<T, Container>& rhs );		(с C++11) (до C++17)
template< class T, class Container > void swap( std::queue<T, Container>& lhs, std::queue<T, Container>& rhs ) noexcept(/* see below */);		(с C++17)

template< class T, class Container >
void swap( std::queue<T, Container>& lhs,
           std::queue<T, Container>& rhs );

(с C++11)
(до C++17)

template< class T, class Container >
void swap( std::queue<T, Container>& lhs,
           std::queue<T, Container>& rhs )
               noexcept(/* see below */);

(с C++17)

Специализирует алгоритм std::swap для std::queue. Меняет содержимое lhs и rhs. Вызывает lhs.swap(rhs).

Этот перегруз участвует в разрешении перегрузки только если std::is_swappable_v<Container> является true.

(с C++17)

Параметры

lhs, rhs

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

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

(ничего)

Сложность

Такая же, как при обмене содержимого базового контейнера.

Исключения

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

noexcept(noexcept(lhs.swap(rhs)))

(с C++17)

Примечания

Хотя перегрузки std::swap для адаптеров контейнеров введены в C++11, адаптеры контейнеров уже можно было менять местами с помощью std::swap в C++98. Такие вызовы std::swap обычно имеют линейную сложность, но может быть обеспечена лучшая сложность.

Пример

#include <algorithm>
#include <iostream>
#include <queue>
 
int main()
{
    std::queue<int> alice;
    std::queue<int> bob;
 
    auto print = [](const auto& title, const auto& cont)
    {
        std::cout << title << " size=" << cont.size();
        std::cout << " front=" << cont.front();
        std::cout << " back=" << cont.back() << '\n';
    };
 
    for (int i = 1; i < 4; ++i)
        alice.push(i);
    for (int i = 7; i < 11; ++i)
        bob.push(i);
 
    // Print state before swap
    print("alice:", alice);
    print("bob  :", bob);
 
    std::cout << "-- SWAP\n";
    std::swap(alice, bob);
 
    // Print state after swap
    print("alice:", alice);
    print("bob  :", bob);
}

Вывод:

alice: size=3 front=1 back=3
bob  : size=4 front=7 back=10
-- SWAP
alice: size=4 front=7 back=10
bob  : size=3 front=1 back=3

См. также

swap

(C++11)

меняет местами содержимое
(публичный член-функция)

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