5. extract

最終更新日時(UTC):
が更新

履歴 編集

function
<unordered_set>

std::unordered_multiset::extract(C++17)

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

概要

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

戻り値

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

計算量

(1), (2) : 平均的なケースでは定数（O(1)）だが、最悪のケースではコンテナの要素数に比例（O(size())）

備考

extractは、要素に対するコピーもムーブも行わずに、要素の所有権を転送することができる。 また、extractは、ムーブオンリーオブジェクトをunordered_multisetから取り出すことができる。

#include <iostream>
#include <unordered_set>

class noncopyable {
protected:
  constexpr noncopyable() noexcept = default;
  ~noncopyable() = default;
  constexpr noncopyable(noncopyable const &) noexcept = delete;
  constexpr noncopyable(noncopyable &&) noexcept = default;
  noncopyable & operator=(noncopyable const &) noexcept = delete;
  noncopyable & operator=(noncopyable &&) noexcept = default;
};

struct my_struct // ムーブオンリーな型
  : private noncopyable {
  int value;
  int num = 0;
  static inline int count = 0;
  constexpr my_struct(int i) noexcept : value(i) { num = count++; };
  bool operator == (const my_struct &rhs) const noexcept {return this->value == rhs.value;}
};

// ハッシュ関数
auto my_hash = [](my_struct const& s) noexcept -> std::size_t
{
  return std::hash<int>{}(s.value);
};

int main()
{
  // ムーブオンリーな型をキーとして扱う multiset
  std::unordered_multiset<my_struct, decltype(my_hash)> s;

  // 挿入
  s.insert(my_struct{1});
  s.insert(my_struct{1});
  s.insert(my_struct{3});

  // 要素を取り出す
  my_struct m = std::move(s.extract(s.begin()).value());
}

出力

例

#include <iostream>
#include <unordered_set>

int main()
{
  std::unordered_multiset<int> s1;
  std::unordered_multiset<int> s2 = { 1, 1, 3 };

  // ノードを取得
  std::unordered_multiset<int>::node_type node = s2.extract(1);

  // 再確保なしに値を書き換える
  node.value() = 15;

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

  if (s1.size() != 0) std::cout << "s1 = { ";
  else std::cout << "s1 = {}\n";

  for(auto&& itr = s1.begin(); itr != s1.end();)
    std::cout << *itr << (++itr != s1.end() ? ", " : " }\n");

  if (s2.size() != 0) std::cout << "s2 = { ";
  else std::cout << "s2 = {}\n";

  for(auto&& itr = s2.begin(); itr != s2.end();)
    std::cout << *itr << (++itr != s2.end() ? ", " : " }\n");
}

出力

s1 = { 15 }
s2 = { 3, 1 }

バージョン

言語

  • C++17

処理系

関連項目

参照