namespace std {
template <class Key, class T, class Hash, class Pred, class Alloc>
void swap (unordered_map<Key,T,Hash,Pred,Alloc>& x,
unordered_map<Key,T,Hash,Pred,Alloc>& y);
template <class Key, class T, class Hash, class Pred, class Alloc>
void swap (unordered_map<Key,T,Hash,Pred,Alloc>& x,
unordered_map<Key,T,Hash,Pred,Alloc>& y)
noexcept(noexcept(x.swap(y))); // C++17
}
概要
2つの unordered_map
オブジェクトである x
と 'y'が保持するコンテンツを交換する。サイズは異なる場合もある。
このメンバ関数の呼び出しの後、呼び出し前に 'x' にあった要素は y
へ、y
内にあった要素は x
へ移る。全てのイテレータ、参照、ポインタは有効なまま残る。
効果
x.swap(y);
戻り値
なし
例外
投げない。
計算量
定数時間
例
#include <iostream>
#include <unordered_map>
template <class Map>
void print(const char* name, const Map& m)
{
std::cout << name << " : {";
for (const auto& x : m) {
std::cout << "[" << x.first << "," << x.second << "], ";
}
std::cout << "}" << std::endl;
}
int main()
{
std::unordered_map<int, char> um1;
um1.insert(std::make_pair(10,'a'));
um1.insert(std::make_pair(20,'b'));
um1.insert(std::make_pair(30,'c'));
std::unordered_map<int, char> um2;
um2.insert(std::make_pair(5,'d'));
um2.insert(std::make_pair(15,'e'));
// c1とc2を入れ替える
std::swap(um1, um2);
print("um1", um1);
print("um2", um2);
}
出力
um1 : {[5,d], [15,e], }
um2 : {[10,a], [20,b], [30,c], }
バージョン
言語
- C++11
処理系
- Clang: ??
- GCC: ??
- ICC: ??
- Visual C++: 2012 ✅
参照
- N4258 Cleaning-up noexcept in the Library, Rev 3
noexcept
追加の経緯となる提案文書