C++官网参考链接:https://cplusplus.com/reference/map/map/swap/
公有成员函数
<map>
std::map::swap
void swap (map& x);
交换内容
用x的内容交换容器的内容,x是另一个相同类型的map。大小可能不同。
在调用这个成员函数之后,这个容器中的元素是在调用之前在x中的元素,而x中的元素是在this中的元素。所有iterators、references和pointers对于交换的对象仍然有效。
注意,存在一个具有相同名称、swap的非成员函数,用行为类似于此成员函数的优化重载该算法。
C++98
内部容器allocators和比较对象(comparison objects)是否交换未定义。
C++11
没有定义内部容器allocators是否交换,除非适当的allocator trait显式指示它们将传播(propagate)。
内部比较对象(comparison objects)总是使用swap进行交换。
形参
x
与此相同类型的另一个map容器(即具有相同的模板形参,Key、T、Compare和Alloc),其内容与this容器的内容交换。
返回值
没有返回值。
用例
// swap maps
#include <iostream>
#include <map>
int main ()
{
std::map<char,int> foo,bar;
foo['x']=100;
foo['y']=200;
bar['a']=11;
bar['b']=22;
bar['c']=33;
foo.swap(bar);
std::cout << "foo contains:\n";
for (std::map<char,int>::iterator it=foo.begin(); it!=foo.end(); ++it)
std::cout << it->first << " => " << it->second << '\n';
std::cout << "bar contains:\n";
for (std::map<char,int>::iterator it=bar.begin(); it!=bar.end(); ++it)
std::cout << it->first << " => " << it->second << '\n';
return 0;
}
输出:
复杂度
常量。
iterator的有效性
所有指向两个容器中元素的iterators、pointers和references仍然有效,但现在指向另一个容器中的元素,并在其中迭代。
注意,结束iterator不指向元素,可能会无效。
数据竞争
容器和x都被修改了。
调用不会访问任何包含的元素(参见上面的iterator的有效性)。
异常安全
如果两个容器中的allocators比较相等,或者它们的allocator traits表明allocators将传播(propagate),则该函数永远不会抛出异常(无抛出保证)。
否则,它将导致未定义的行为。