std::swap

Template:cpp/algorithm/sidebar Template:ddcl list begin <tr class="t-dsc-header">

<td>

Defined in header <algorithm>
Defined in header <utility>

</td>

<td></td>

<td>

Template:mark pre c++11 version
Template:mark c++11 version

</td>

</tr> <tr class="t-dcl ">

<td >

template< class T >
void swap( T& a, T& b );

</td>

<td > (1) </td> <td class="t-dcl-nopad"> </td> </tr> <tr class="t-dcl ">

<td >

template< class T, size_t N >
void swap( T (&a)[N], T (&b)[N]);

</td>

<td > (2) </td> <td > Template:mark c++11 feature </td> </tr> Template:ddcl list end

Exchanges the given values.

1) Swaps the values a and b.

2) Swaps the arrays a and b. In effect calls Template:cpp.

Parameters

a, b

-

the values to be swapped

Return value

(none)

Exceptions

1)

noexcept specification:  

noexcept(noexcept(

    std::is_nothrow_move_constructible<T>::value &&
    std::is_nothrow_move_assignable<T>::value

))

2)

noexcept specification:  

noexcept(noexcept(swap(*a, *b)))

Complexity

Constant

Specializations

Custom specializations of the Template:cpp algorithm are allowed. The following specializations are already provided by the standard library:

Template:cpp/memory/shared ptr/dcl list swap2Template:cpp/memory/weak ptr/dcl list swap2Template:cpp/memory/unique ptr/dcl list swap2Template:cpp/string/basic string/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/container/dcl list swap2Template:cpp/io/basic fstream/dcl list swap2Template:cpp/io/basic fstream/dcl list swap2Template:cpp/io/basic fstream/dcl list swap2

std::swap(std::pair) (C++11)	specializes the std::swap algorithm (function template)
std::swap(std::tuple) (C++11)	specializes the std::swap algorithm (function template)
std::swap(std::function) (C++11)	specializes the std::swap algorithm (function template)
std::swap(std::valarray) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::basic_stringbuf) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::basic_istringstream) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::basic_ostringstream) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::basic_stringstream) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::basic_filebuf) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::basic_regex) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::match_results) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
swap(std::) ({{{1}}})	specializes the std::swap algorithm (function)
std::swap(std::unique_lock) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::promise) (C++11)	specializes the Template:cpp/ltf algorithm (function template)
std::swap(std::packaged_task) (C++11)	specializes the Template:cpp/ltf algorithm (function template)

See also

Template:cpp/algorithm/dcl list iter swapTemplate:cpp/algorithm/dcl list swap ranges