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)。

異常安全

如果兩個容器中的分配器進行比較相等,或者它們的 分配器特性 表明分配器應該 傳播,則該函式永遠不會丟擲異常(無異常保證)。
否則,將導致未定義行為

另見