- unordered_set[meta header]
- std[meta namespace]
- unordered_multiset[meta class]
- function[meta id-type]
- cpp11[meta cpp]
size_type bucket(const key_type& k) const; // (1) C++11
constexpr size_type bucket(const key_type& k) const; // (1) C++26
template <class K>
constexpr size_type bucket(const K& k) const; // (2) C++26指定したキーと等価な要素が格納されている場合、そのバケットのインデックス(添え字)を取得する。
- (1) :
key_type型のキーを受け取って、バケットのインデックスを取得する - (2) :
key_typeと比較可能なキーを受け取って、バケットのインデックスを取得する
- (2) :
Hash::is_transparentおよびPred::is_transparentが妥当な式であること
当該コンテナは bucket_count() > 0 であること
パラメータ k と等価なキーの要素が格納されているバケットのインデックス(添え字)
戻り値は [0, bucket_count()) の範囲である。
定数。
- 指定したキーと等価な要素が格納されていない場合、そのキーを挿入した際に
rehashが発生しなければ格納されるバケットのインデックス(添え字)が返る。 - (2) :
is_transparentは、HashとPredの両方がメンバ型として持つ必要がある。Predにはis_transparentを定義するstd::equal_to<>が使えるが、Hashには標準ライブラリに該当するものがないため、利用者が定義する必要がある。詳細はstd::hashクラスのページを参照。- これらのオーバーロードは、
unordered_multiset<string>のようなコンテナに対し、検索操作で文字列リテラルを渡した際に、キー型の一時オブジェクトが生成されるコストを減らすためにある。
#include <iostream>
#include <string>
#include <unordered_set>
int main()
{
std::unordered_multiset<std::string> ums{ "A", "B", "C", "D", "E", "A", "B", "C", "D", "E", };
decltype(ums)::size_type c = ums.bucket_count();
std::cout << "bucket_count() = " << c << std::endl;
// 全てのキーに対するバケットのインデックスとそのバケットの要素数を取得
for (decltype(ums)::key_type k : ums) {
decltype(ums)::size_type b = ums.bucket(k);
decltype(ums)::size_type s = ums.bucket_size(b);
std::cout << "key = " << k << ", bucket = " << b << ", bucket_size = " << s << std::endl;
}
// 存在しないキーに対するバケットのインデックスとそのバケットの要素数を取得
decltype(ums)::key_type k = "H";
decltype(ums)::size_type b = ums.bucket(k);
decltype(ums)::size_type s = ums.bucket_size(b);
std::cout << "key = " << k << ", bucket = " << b << ", bucket_size = " << s << std::endl;
}- bucket[color ff0000]
- ums.bucket_count()[link bucket_count.md]
- ums.bucket_size[link bucket_size.md]
bucket_count() = 11
key = E, bucket = 6, bucket_size = 2
key = E, bucket = 6, bucket_size = 2
key = A, bucket = 5, bucket_size = 6
key = A, bucket = 5, bucket_size = 6
key = C, bucket = 5, bucket_size = 6
key = C, bucket = 5, bucket_size = 6
key = D, bucket = 5, bucket_size = 6
key = D, bucket = 5, bucket_size = 6
key = B, bucket = 7, bucket_size = 2
key = B, bucket = 7, bucket_size = 2
key = H, bucket = 3, bucket_size = 0
- C++11
- Clang: 3.1 [mark verified]
- GCC: 4.7.2 [mark verified]
- Visual C++: ?
| 名前 | 説明 |
|---|---|
max_bucket_count |
最大バケット数の取得 |
- P2363R5 Extending associative containers with the remaining heterogeneous overloads
- C++26で
template <class K>のバージョンが追加された
- C++26で
- P3372R3 constexpr containers and adaptors
- LWG Issue 1197. Can unordered containers have
bucket_count()== 0?- C++11で、
bucket_count()> 0という事前条件が追加された。バケット数が0の場合、剰余によるバケット決定が行えないため
- C++11で、