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;
}
出力
m1 :
[15, a]
m2 :
[10, b]
[10, c]
バージョン
言語
- C++17
処理系
- Clang: 7.0.0
- GCC: 7.1.0
- ICC: ??
- Visual C++: 2017 Update 5