std::swap

来自cppreference.com
< cpp‎ | algorithm
 
 
算法库
执行策略 (C++17)
不修改的序列操作
(C++11)
(C++11)
(C++11)
(C++17)
修改的序列操作
未初始化存储上的操作
划分操作
排序操作
(C++11)
二分查找操作
集合操作(在已排序范围上)
堆操作
(C++11)
最小/最大操作
(C++11)
(C++17)

重排
数值操作
C 库
 
定义于头文件 <algorithm>
定义于头文件 <utility>
(C++11 前)
(C++11 起)
template< class T >
void swap( T& a, T& b );
(1)
template< class T2, std::size_t N >
void swap( T2 (&a)[N], T2 (&b)[N]);
(2) (C++11 起)

交换给定值

1) 交换 ab此重载仅若 std::is_move_constructible_v<T> && std::is_move_assignable_v<T>true 才参与重载决议。 (C++17 起)
2) 交换 ab 数组。等效于调用 std::swap_ranges(a, a+N, b). 此重载仅若 std::is_swappable_v<T2>true 才参与重载决议。 (C++17 起)

目录

[编辑] 参数

a, b - 要交换的值
类型要求
-
T 必须满足 MoveAssignable MoveConstructible 的要求。
-
T2 必须满足 Swappable 的要求。

[编辑] 返回值

(无)

[编辑] 异常

1)
(无) (C++11 前)
noexcept 规定:  
noexcept(

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

)
(C++11 起)
2)
noexcept 规定:  
noexcept(noexcept(swap(*a, *b)))
(C++17 前)
noexcept 规定:  
noexcept(std::is_nothrow_swappable_v<T2>)
(C++17 起)

[编辑] 复杂度

1) 常量
2) 与 N 呈线性

[编辑] 特化

std::swap 可以对用户定义类型在命名空间 std 中特化,但这些特化不会为 ADL所寻找(命名空间 std 并非对用户定义类型的关联空间)。令用户定义类型可交换的期待方式是在与该类型相同的命名空间中提供非成员函数 swap :细节见可交换Swappable)。

标准库已提供下列重载:

特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap() 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap() 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
std::swapunique_lock 的特化
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]
特化 std::swap 算法
(函数) [编辑]
特化 std::swap 算法
(函数) [编辑]
特化 std::swap 算法
(函数) [编辑]
交换二个路径
(函数) [编辑]

[编辑] 示例

#include <algorithm>
#include <iostream>
 
int main()
{
   int a = 5, b = 3;
 
   // 前
   std::cout << a << ' ' << b << '\n';
 
   std::swap(a,b);
 
   // 后
   std::cout << a << ' ' << b << '\n';
}

输出:

5 3
3 5

[编辑] 参阅

交换两个迭代器所指向的元素
(函数模板) [编辑]
交换两个范围的元素
(函数模板) [编辑]