std::unordered_set<Key,Hash,KeyEqual,Allocator>::bucket
從 cppreference.com
< cpp | container | unordered set
| 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) |
[編輯] 示例
| 本節未完成 原因：暫無示例 |
[編輯] 參閱
| 返回特定的桶中的元素數量 (公開成員函數) |
