Namespaces
Variants

std::unordered_multiset<Key,Hash,KeyEqual,Allocator>:: bucket

From cppreference.net

size_type bucket ( const Key & key ) const ;
(1) (C++11以降)
template < typename K >
size_type bucket ( const K & x ) const ;
(2) (C++26以降)
1) キー key のバケットインデックスを返す。キーが等価な要素(存在する場合)は常にこのバケット内で見つかる。
2) x 等価 に比較されるキーのバケットインデックスを返します。値 x と等価に比較されるキーを持つ要素(存在する場合)は常にこのバケット内に存在します。このオーバーロードは、 Hash KeyEqual の両方が transparent である場合にのみオーバーロード解決に参加します。これは、そのような Hash K 型と Key 型の両方で呼び出し可能であり、かつ KeyEqual がtransparentであることを前提としており、これらが組み合わさることで Key のインスタンスを構築せずにこの関数を呼び出すことが可能になります。

返される値は、コンテナのインスタンスに対してのみ有効であり、 bucket_count() が同じ値を返す場合に限ります(例えば、 rehash() は以前に取得した値を無効にします)。

bucket_count() がゼロの場合、動作は未定義です。

目次

パラメータ

key - 検査するキーの値
x - キーと透過的に比較可能な任意の型の値

戻り値

要求されたキーのバケットインデックス。

計算量

定数。

注記

機能テスト マクロ 標準 機能
__cpp_lib_associative_heterogeneous_insertion 202311L (C++26) 順序付き および 非順序 連想 コンテナ の残りのメンバー関数に対する異種オーバーロード ( 2 )

関連項目

特定のバケット内の要素数を返す
(public member function)