std::stack<T,Container>::swap

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

void swap( stack& other ) noexcept(/* see below */);
(C++11 起)

交换容器适配器与 other 的内容。等效地调用 using std::swap; swap(c, other.c);

参数

other - 要交换内容的容器适配器

返回值

(无)

异常

noexcept 说明:  
noexcept(noexcept(swap(c, other.c)))

上述表达式中,用与 C++17 std::is_nothrow_swappable 特性所用的相同方式查找标识符 swap

(C++11 起)
(C++17 前)
noexcept 说明:  
noexcept(std::is_nothrow_swappable_v<Container>)
(C++17 起)

复杂度

与底层容器相同(常为常数)。

注解

一些实现(例如 libc++ )对 C++11 前模式提供 swap 成员函数作为扩展。

示例

#include <iostream>
#include <stack>
#include <string>
#include <vector>
 
template <typename Stack>
void print(Stack stack /* pass by value */, int id)
{
    std::cout << "s" << id << " [" << stack.size() << "]: ";
    for (; !stack.empty(); stack.pop())
        std::cout << stack.top() << ' ';
    std::cout << (id > 1 ? "\n\n" : "\n");
}
 
int main()
{
    std::vector<std::string>
        v1{"1","2","3","4"},
        v2{"Ɐ","B","Ɔ","D","Ǝ"};
 
    std::stack s1{std::move(v1)};
    std::stack s2{std::move(v2)};
 
    print(s1, 1);
    print(s2, 2);
 
    s1.swap(s2);
 
    print(s1, 1);
    print(s2, 2);
}

输出:

s1 [4]: 4 3 2 1 
s2 [5]: Ǝ D Ɔ B Ɐ 
 
s1 [5]: Ǝ D Ɔ B Ɐ 
s2 [4]: 4 3 2 1

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

DR 应用于 出版时的行为 正确行为
LWG 2456 C++11 noexcept 规定非良构 使之能用

参阅

特化 std::swap 算法
(函数模板)