std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: bucket
From cppreference.net
<
cpp
|
container
|
unordered multimap
|
size_type bucket
(
const
Key
&
key
)
const
;
|
(1) | (desde C++11) |
|
template
<
typename
K
>
size_type bucket ( const K & x ) const ; |
(2) | (desde C++26) |
1)
Devuelve el índice del bucket para la clave
key
. Los elementos (si existen) con claves equivalentes a
key
siempre se encuentran en este bucket.
2)
Devuelve el índice del bucket para la clave que compara
equivalente
al valor
x
. Los elementos (si existen) con claves que comparan equivalentes a
x
siempre se encuentran en este bucket. Esta sobrecarga participa en la resolución de sobrecarga solo si
Hash
y
KeyEqual
son ambos
transparentes
. Esto asume que dicho
Hash
es invocable tanto con el tipo
K
como con el tipo
Key
, y que el
KeyEqual
es transparente, lo que, en conjunto, permite llamar a esta función sin construir una instancia de
Key
.
El valor devuelto es válido solo para instancias del contenedor para las cuales bucket_count() devuelve el mismo valor (por ejemplo, rehash() invalida el valor obtenido previamente).
El comportamiento es indefinido si bucket_count() es cero.
Contenidos |
Parámetros
| key | - | el valor de la clave a examinar |
| x | - | un valor de cualquier tipo que puede compararse transparentemente con una clave |
Valor de retorno
Índice de bucket para la clave solicitada.
Complejidad
Constante.
Notas
| Macro de prueba de características | Valor | Estándar | Característica |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | Sobrecargas heterogéneas para las funciones miembro restantes en contenedores asociativos ordenados y contenedores asociativos no ordenados . ( 2 ) |
Ejemplo
|
Esta sección está incompleta
Motivo: sin ejemplo |
Véase también
|
devuelve el número de elementos en un bucket específico
(función miembro pública) |