C++

Reference

<stack>

stack

public member function
<stack>

std::stack::swap

void swap (stack& x) noexcept(/*see below*/);
Swap contents
Exchanges the contents of the container adaptor (*this) by those of x.

This member function calls the non-member function swap (unqualified) to swap the underlying containers.

The noexcept specifier matches the swap operation on the underlying container.

Parameters

x
Another stack container adaptor of the same type (i.e., instantiated with the same template parameters, T and Container). Sizes may differ.

Return value

none

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 
// stack::swap
#include <iostream>       // std::cout
#include <stack>          // std::stack

int main ()
{
  std::stack<int> foo,bar;
  foo.push (10); foo.push(20); foo.push(30);
  bar.push (111); bar.push(222);

  foo.swap(bar);

  std::cout << "size of foo: " << foo.size() << '\n';
  std::cout << "size of bar: " << bar.size() << '\n';

  return 0;
}

Output:

size of foo: 2
size of bar: 3


Complexity

Constant.

Data races

Both *this and x are modified.

Exception safety

Provides the same level of guarantees as the operation performed on the underlying container objects.

See also

swap (stack)
Exchange contents of stacks (public member function)
swap
Exchange values of two objects (function template)