std::swap(std::stack)

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

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

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

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

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

(с C++17)

Специализирует алгоритм std::swap для std::stack. Меняет содержимое 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 <stack>
 
int main()
{
    std::stack<int> alice;
    std::stack<int> bob;
 
    auto print = [](const auto& title, const auto& cont)
    {
        std::cout << title << " size=" << cont.size();
        std::cout << " top=" << cont.top() << '\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 top=3
bob  : size=4 top=10
-- SWAP
alice: size=4 top=10
bob  : size=3 top=3

См. также

swap

(C++11)

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

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