extract.md

extract

• map[meta header]
• function[meta id-type]
• std[meta namespace]
• multimap[meta class]
• cpp17[meta cpp]

node_type extract(const_iterator position); (1)
node_type extract(const key_type& x);       (2)

概要

(1) positionが指すノードを切り離し、その要素を所有するノードハンドルを返す。
(2) xと等価なキーが見つかった場合、xが指す最初の要素を持つノードを切り離し、その要素を所有するノードハンドルを返す。それ以外の場合は空のノードハンドルを返す。

戻り値

要素を所有するノードハンドル。ただし、オーバーロード(2)の場合は空のノードハンドルの可能性がある。

計算量

(1) 償却定数時間
(2) log((*this).size())

備考

extractは、要素に対するコピーもムーブも行わずに、要素の所有権を転送することができる。 また、extractは再確保なしでマップ要素のキーを変更することができる。

例

#include <iostream>
#include <map>

int main()
{
  std::multimap<int, char> m1;
  std::multimap<int, char> m2 = {
    {10, 'a'},
    {10, 'b'},
    {10, 'c'}
  };

  // ノードを取得
  std::multimap<int, char>::node_type node = m2.extract(10);

  // キーを書き換え
  node.key() = 15;

  // ノードを転送
  m1.insert(std::move(node));

  std::cout << "m1 :" << std::endl;

  for (const auto& [key, value] : m1)
    std::cout << "[" << key << ", " << value << "]" << std::endl;

  std::cout << "\n" << "m2 :" << std::endl;

  for (const auto& [key, value] : m2)
    std::cout << "[" << key << ", " << value << "]" << std::endl;
}

• extract[color ff0000]
• node_type[link /reference/node_handle/node_handle.md]
• key[link /reference/node_handle/node_handle/key.md]

出力

m1 :
[15, a]

m2 :
[10, b]
[10, c]

バージョン

言語

• C++17

処理系

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

関連項目

• node_handle

参照

• Splicing Maps and Sets(Revision 5)