std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: bucket
From cppreference.net
<
cpp
|
container
|
unordered map
|
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
に対応するバケットのインデックスを返します。
key
と等価なキーを持つ要素（存在する場合）は常にこのバケット内に存在します。
2)
値
x
と比較して
等価
となるキーのバケットインデックスを返す。
x
と比較して等価となるキーを持つ要素（存在する場合）は常にこのバケット内に存在する。このオーバーロードは、
Hash
と
KeyEqual
の両方が
透過的
である場合にのみオーバーロード解決に参加する。これは、そのような
Hash
が
K
型と
Key
型の両方で呼び出し可能であり、かつ
KeyEqual
が透過的であることを前提としており、これらにより
Key
のインスタンスを構築せずにこの関数を呼び出すことが可能となる。
返される値は、同じ値に対して bucket_count() が同じ値を返すコンテナのインスタンスに対してのみ有効です（例えば、 rehash() は以前に取得した値を無効にします）。
bucket_count() がゼロの場合、動作は未定義です。
目次 |
パラメータ
| key | - | 検査するキーの値 |
| x | - | キーと透過的に比較可能な任意の型の値 |
戻り値
要求されたキーのバケットインデックス。
計算量
定数。
注記
| 機能テスト マクロ | 値 | 標準 | 機能 |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | 順序付き および 非順序 連想 コンテナ の残りのメンバー関数に対する異種オーバーロード。 ( 2 ) |
例
|
このセクションは不完全です
理由: 例がありません |
関連項目
|
特定のバケット内の要素数を返す
(公開メンバ関数) |