(until C++11) (since C++11) | ||
---|---|---|
template< class T > void swap( T& a, T& b ); | (1) | |
template< class T2, size_t N > void swap( T2 (&a)[N], T2 (&b)[N]); | (2) | (since C++11) |
Exchanges the given values.
1) Swaps the values
a
and b
.Parameters
a, b | - | the values to be swapped |
Type requirements | ||
- T must meet the requirements of MoveAssignable and MoveConstructible . | ||
- T2 must meet the requirements of Swappable . |
Return value
(none).
Exceptions
1)
(none) | (until C++11) |
noexcept specification: noexcept(
) | (since C++11) |
2)
noexcept
specification: noexcept(noexcept(swap(*a, *b)))
Complexity
1) Constant
2) Linear in N
Specializations
std::swap
may be specialized in namespace std for user-defined types, but such specializations are not found by ADL (the namespace std is not the associated namespace for the user-defined type). The expected way to make a user-defined type swappable is to provide a non-member function swap in the same namespace as the type: see Swappable
for details.
The following overloads are already provided by the standard library:
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
specializes the std::swap algorithm (function template) | |
(C++11) | specializes the std::swap algorithm (function template) |
specializes the std::swap algorithm (function template) | |
(C++11) | specializes the std::swap algorithm (function template) |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
(C++11) | specializes the std::swap algorithm (function template) |
specializes the std::swap algorithm (function template) | |
(C++11) | specializes the std::swap algorithm (function template) |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
(C++11) | specializes the std::swap() algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
specializes the std::swap algorithm (function template) | |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap() algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specialization of std::swap for unique_lock (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
(C++11) | specializes the std::swap algorithm (function template) |
Example
#include <algorithm> #include <iostream> int main() { int a = 5, b = 3; // before std::cout << a << ' ' << b << '\n'; std::swap(a,b); // after std::cout << a << ' ' << b << '\n'; }
Output:
5 3 3 5
See also
swaps the elements pointed to by two iterators (function template) | |
swaps two ranges of elements (function template) |
Please login to continue.