std::swap(std::stack)

来自cppreference.com
< cpp‎ | container‎ | stack

[编辑模板]
 
C++
 
容器库
 
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(/* 见下文 */);
 (C++17 起)
(C++26 起为 constexpr)
为 std::stack 特化了 std::swap 算法。交换 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 引入的，但是在 C++98 中已经可以使用 std::swap 交换容器适配器。这种 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);
 
    // 打印 swap 之前的状态
    print("Alice：", alice);
    print("Bobby：", bob);
 
    std::cout << "-- SWAP\n";
    std::swap(alice, bob);
 
    // 打印 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)
 交换内容
(公开成员函数) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/container/stack/swap2&oldid=82362”