Namespaces
Variants

std:: swap (std::stack)

From cppreference.net

C++
Containers library
std::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)
(constexpr начиная с C++26)
Specializes the std::swap algorithm for std::stack . Swaps the contents of lhs and rhs . Calls lhs. swap ( rhs ) .

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

(since 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("Bobby:", bob);
    std::cout << "-- SWAP\n";
    std::swap(alice, bob);
    // Print state after swap
    print("Alice:", alice);
    print("Bobby:", bob);
}

Вывод: 

Alice: size=3 top=3
Bobby: size=4 top=10
-- SWAP
Alice: size=4 top=10
Bobby: size=3 top=3

Смотрите также

(C++11)
обменивает содержимое
(публичная функция-член)