C++官网参考链接:https://cplusplus.com/reference/map/map/swap-free/
函数模板
<map>
std::swap (map)
template <class Key, class T, class Compare, class Alloc>
void swap (map<Key,T,Compare,Alloc>& x, map<Key,T,Compare,Alloc>& y);
交换两个map的内容
容器x的内容与容器y的内容交换。两个容器对象必须具有相同的类型(相同的模板形参),尽管大小可能不同。
在调用这个成员函数之后,x中的元素是调用之前在y中的元素,y中的元素是在x中的元素。所有iterators、references和pointers对于交换后的对象仍然有效。
这是泛型算法swap的重载,通过将资产的所有权相互转移到另一个容器(即,容器交换对其数据的引用,而不实际执行任何元素复制或移动)来提高性能:它的行为就像调用了x.swap(y)。
形参
x, y
相同类型的map容器(即,具有相同的模板形参:Key、T、Compare和Alloc)。
返回值
没有返回值。
用例
// 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;
swap(foo,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和y都被修改了。
调用不会访问任何包含的元素(参见上面的iterator的有效性)。
异常安全
如果两个maps中的allocator比较相等,或者它们的allocator traits表明allocator将传播(propagate),则该函数永远不会抛出异常(无抛出保证)。
否则,它将导致未定义的行为。