最終更新日時(UTC): 2026年02月17日 14時22分33秒
Akira Takahashi が更新

履歴 編集

function

# ::node_handle::swap(C++17)

    void
      swap(node_handle&)
        noexcept(ator_traits::propagate_on_container_swap::value ||
                 ator_traits::is_always_equal::value); // (1) C++17
    constexpr void
      swap(node_handle&)
        noexcept(ator_traits::propagate_on_container_swap::value ||
                 ator_traits::is_always_equal::value); // (1) C++26

## 概要

コンテナノードの所有権を入れ替る。

## 要件

一方のノードハンドルが空である。または、`allocator_traits<allocator_type>::propagate_on_container_swap`が`true`である。または、両方のアロケータが等値である。

## 効果

`swap(ptr_, nh.ptr_)` を呼び出す。一方のノードが空であるか、両方のノードが空でなく `std::allocator_traits<allocator_type>::propagate_on_container_swap` が `true` の場合、アロケータも同様に入れ替えられる。

## 戻り値

なし

## 例外

    noexcept(ator_traits::propagate_on_container_swap::value ||
                 ator_traits::is_always_equal::value);

で指定される。

## 例

    #include <iostream>
    #include <map>

    int main()
    {
      std::map<int, char> m = {
        {10, 'a'},
        {20, 'b'},
        {30, 'c'}
      };

      // ノードを取得
      std::map<int, char>::node_type node1 = m.extract(10);
      std::map<int, char>::node_type node2 = m.extract(20);

      std::cout << "node1 : [" << node1.key() << ", " << node1.mapped() << "]" << std::endl;
      std::cout << "node2 : [" << node2.key() << ", " << node2.mapped() << "]\n" << std::endl;

      // ノードを入れ替える
      node1.swap(node2);

      std::cout << "node1 : [" << node1.key() << ", " << node1.mapped() << "]" << std::endl;
      std::cout << "node2 : [" << node2.key() << ", " << node2.mapped() << "]" << std::endl;
    }

### 出力

    node1 : [10, a]
    node2 : [20, b]

    node1 : [20, b]
    node2 : [10, a]

## バージョン

### 言語

- C++17

### 処理系

- Clang: 7.0.0 ✅
- GCC: 7.1.0 ✅
- ICC: ??
- Visual C++: 2017 Update 5 ✅

## 関連項目

- node_handle

## 参照

- Splicing Maps and Sets(Revision 5)
- P3372R3 constexpr containers and adaptors