public member function
<set>

std::multiset::swap

void swap (multiset& x);
交换内容
交换容器的内容和 x 的内容,x 是另一个同类型的 multiset。大小可能不同。

调用此成员函数后,此容器中的元素将是调用前 x 中的元素,而 x 中的元素将是调用前this容器中的元素。所有迭代器、引用和指针对于交换后的对象仍然有效。

请注意,存在一个同名的非成员函数 swap,该函数通过优化重载了该算法,其行为类似于此成员函数。

内部容器的 allocator比较对象 是否被交换是不确定的。
内部容器的 allocator 是否被交换未定义,除非在适当的 allocator trait 明确指示它们应 传播 的情况下。

内部 比较对象 总是通过 swap 进行交换。

参数

x
另一个与此容器同类型的 multisetset 容器(即具有相同的模板参数,T, CompareAlloc)其内容与此容器的内容交换。

返回值



示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// swap multisets
#include <iostream>
#include <set>

main ()
{
  int myints[]={19,72,4,36,20,20};
  std::multiset<int> first (myints,myints+3);     // 4,19,72
  std::multiset<int> second (myints+3,myints+6);  // 20,20,36

  first.swap(second);

  std::cout << "first contains:";
  for (std::multiset<int>::iterator it=first.begin(); it!=first.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  std::cout << "second contains:";
  for (std::multiset<int>::iterator it=second.begin(); it!=second.end(); ++it)
    std::cout << ' ' << *it;
  std::cout << '\n';

  return 0;
}

输出
first contains: 20 20 36
second contains: 4 19 72


复杂度

常量。

迭代器有效性

指向两个容器中元素的的所有迭代器、指针和引用仍然有效,但现在指向另一个容器中的元素,并在其中迭代。
请注意,end iterators 不指向任何元素,并且可能会失效。

数据竞争

容器和 x 都被修改。
调用时不会访问任何包含的元素(尽管请参见上面的iterator validity)。

异常安全

如果两个容器中的分配器进行比较相等,或者它们的 分配器特性 表明分配器应该 传播,则该函数永远不会抛出异常(无异常保证)。
否则,将导致未定义行为

另见