std::stack<T,Container>::swap (3) - Linux Manuals

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

NAME

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

Synopsis


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


Exchanges the contents of the container adaptor with those of other. Effectively calls using std::swap; swap(c, other.c);

Parameters


other - container adaptor to exchange the contents with

Return value


(none)

Exceptions


noexcept specification:
noexcept(noexcept(swap(c, other.c))) (until C++17)
In the expression above, the identifier swap is looked up in the same manner as the one used by the C++17 std::is_nothrow_swappable trait.
noexcept specification: (since C++17)
noexcept(std::is_nothrow_swappable<Container>::value)

Complexity


Same as underlying container (typically constant)


Defect reports


The following behavior-changing defect reports were applied retroactively to previously published C++ standards.


DR Applied to Behavior as published Correct behavior
LWG_2456 C++11 the noexcept specification is ill-formed made to work

See also


                      specializes the std::swap algorithm
std::swap(std::stack) (function template)