最終更新日時: 2026年03月21日 23時12分53秒 (JST)
Raclamusi が更新

履歴 編集

function template
<map>

# std::swap (非メンバ関数)

    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); // (1) C++03
      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)));            // (1) C++17
      template <class Key, class T, class Compare, class Allocator>
      constexpr void
        swap(multimap<Key,T,Compare,Allocator>& x,
             multimap<Key,T,Compare,Allocator>& y)
          noexcept(noexcept(x.swap(y)));            // (1) C++26
    }

## 概要

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);
    }

### 出力

    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` 追加の経緯となる提案文書
- P3372R3 constexpr containers and adaptors