key_eq.md

key_eq

• unordered_set[meta header]
• std[meta namespace]
• unordered_multiset[meta class]
• function[meta id-type]
• cpp11[meta cpp]

key_equal key_eq() const;

概要

コンテナのキー比較用関数オブジェクトを返す

戻り値

コンテナのキー比較用関数オブジェクト。

このメンバ関数で返されるキー比較用関数オブジェクトは、コンストラクタ、あるいは、直近の代入（コピー、あるいはムーブ）、交換でコンテナに保存されたオブジェクトのコピーである。

計算量

定数

備考

戻り値の型である、キー比較用関数オブジェクトの型 key_equal は、unordered_multiset のメンバ型で、三番目のテンプレートパラメータ Pred を別名定義したものである。

キー比較用関数オブジェクトは、名前の通りキーを比較するためのオブジェクトで、与えられた二つのキーが等しいときには true、等しくないときには false を返すメンバ関数 bool operator()(key_type, key_type)を持つ必要がある。

テンプレートパラメータを省略した場合、key_equal はデフォルト値 std::equal_to<key_type> となる。

例

#include <iostream>
#include <unordered_set>

int main()
{
  std::cout << std::boolalpha;

  std::unordered_multiset<int> ums{ 1, 2, 3, 4, 5, 6, };

  decltype(um)::key_equal eq{ ums.key_eq() };

  std::cout << "eq(1, 2) = " << eq(1, 2) << std::endl;
  std::cout << "eq(1, 1) = " << eq(1, 1) << std::endl;
}

• key_eq()[color ff0000]

出力

eq(1, 2) = false
eq(1, 1) = true

バージョン

言語

• C++11

処理系

• Clang: 3.1
• GCC: 4.7.0
• ICC: ?
• Visual C++: ?

関連項目

名前	説明
equal_to	等値比較演算関数オブジェクト(class template)
hash_function	ハッシュ関数オブジェクトの取得