C++ Reference: Standard C++ Library reference: Containers: deque: deque: swap

C++官网参考链接：https://cplusplus.com/reference/deque/deque/swap/

公有成员函数 
<deque>
std::deque::swap
void swap (deque& x);
交换内容
通过x的内容交换容器的内容，x是另一个包含相同类型元素的deque对象。大小可能不同。
在调用这个成员函数之后，这个容器中的元素是在调用之前在x中的元素，而x中的元素是在this中的元素。所有iterator、reference和指针对于交换的对象仍然有效。
注意，存在一个具有相同名称、swap的非成员函数，用行为类似于此成员函数的优化重载该算法。
C++98
没有关于allocators的详细信息。
C++11
没有定义容器allocators是否也被交换，除非适当的allocator trait显式地指出它们应该被传播（propagate）。

形参 
x
另一个相同类型的deque容器（即，用相同的模板形参T和Alloc实例化），其内容与this容器的内容交换。

返回值
没有返回值。

用例
// swap deques
#include
#include

main ()
{
  unsigned int i;
  std::deque foo (3,100);   // three ints with a value of 100
  std::deque bar (5,200);   // five ints with a value of 200

  foo.swap(bar);

  std::cout << "foo contains:";
  for (std::deque::iterator it = foo.begin(); it!=foo.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  std::cout << "bar contains:";
  for (std::deque::iterator it = bar.begin(); it!=bar.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  return 0;
}
输出：

复杂度 
常量。

iterator的有效性
所有指向两个容器中元素的iterator、指针和reference仍然有效，现在指向的是它们在调用之前引用的相同元素，但在另一个容器中，它们现在进行迭代的地方。
注意，结束iterator不指向元素，可能会无效。

数据竞争
容器和x都被修改了。
调用不会访问任何包含的元素（参见上面的iterator的有效性）。

异常安全
如果两个容器中的allocator比较相等，或者它们的allocator traits表明allocator将传播（propagate），则该函数永远不会抛出异常（无抛出保证）。
否则，它将导致未定义的行为。