Namespaces
Variants

std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: bucket

From cppreference.net

size_type bucket ( const Key & key ) const ;
(1) (seit C++11)
template < typename K >
size_type bucket ( const K & x ) const ;
(2) (seit C++26)
1) Gibt den Index des Buckets für den Schlüssel key zurück. Elemente (falls vorhanden) mit Schlüsseln, die äquivalent zu key sind, befinden sich immer in diesem Bucket.
2) Gibt den Index des Buckets für den Schlüssel zurück, der zum Wert x äquivalent vergleicht. Elemente (falls vorhanden) mit Schlüsseln, die zu x äquivalent vergleichen, befinden sich immer in diesem Bucket. Diese Überladung nimmt nur dann an der Überladungsauflösung teil, wenn Hash und KeyEqual beide transparent sind. Dies setzt voraus, dass ein solcher Hash mit sowohl dem Typ K als auch dem Typ Key aufrufbar ist und dass der KeyEqual transparent ist, was zusammen den Aufruf dieser Funktion ohne Konstruktion einer Instanz von Key ermöglicht.

Der zurückgegebene Wert ist nur für Instanzen des Containers gültig, für die bucket_count() denselben Wert zurückgibt (z.B. macht rehash() zuvor erhaltene Werte ungültig).

Das Verhalten ist undefiniert, wenn bucket_count() null ist.

Inhaltsverzeichnis

Parameter

key - der Wert des zu prüfenden Schlüssels
x - ein Wert beliebigen Typs, der transparent mit einem Schlüssel verglichen werden kann

Rückgabewert

Bucket-Index für den angeforderten Schlüssel.

Komplexität

Konstante.

Hinweise

Feature-Test Makro Wert Std Feature
__cpp_lib_associative_heterogeneous_insertion 202311L (C++26) Heterogene Überladungen für die verbleibenden Memberfunktionen in geordneten und ungeordneten assoziativen Containern . ( 2 )

Beispiel

Siehe auch

gibt die Anzahl der Elemente in einem bestimmten Bucket zurück
(öffentliche Elementfunktion)