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