std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: at
From cppreference.net
<
cpp
|
container
|
unordered map
|
T
&
at
(
const
Key
&
key
)
;
|
(1) | (desde C++11) |
|
const
T
&
at
(
const
Key
&
key
)
const
;
|
(2) | (desde C++11) |
|
template
<
class
K
>
T & at ( const K & x ) ; |
(3) | (desde C++26) |
|
template
<
class
K
>
const T & at ( const K & x ) const ; |
(4) | (desde C++26) |
Devuelve una referencia al valor mapeado del elemento con la clave especificada. Si no existe tal elemento, se lanza una excepción de tipo std::out_of_range .
1,2)
La clave es equivalente a
key
.
3,4)
La clave se compara como
equivalente
al valor
x
. La referencia al valor mapeado se obtiene como si mediante la expresión
this
-
>
find
(
x
)
-
>
second
.
La expresión
this
-
>
find
(
x
)
debe estar bien formada y tener un comportamiento bien definido; de lo contrario, el comportamiento es indefinido.
Estas sobrecargas participan en la resolución de sobrecarga solo si
Hash
y
KeyEqual
son ambos
transparentes
. Esto asume que dicho
Hash
puede ser invocado 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
.
Contenidos |
Parámetros
| key | - | la clave del elemento a buscar |
| x | - | un valor de cualquier tipo que puede compararse transparentemente con una clave |
Valor de retorno
Una referencia al valor mapeado del elemento solicitado.
Excepciones
3,4)
std::out_of_range
si el contenedor no tiene el elemento especificado, es decir, si
find
(
x
)
==
end
(
)
es
true
.
Complejidad
Caso promedio: constante, caso peor: lineal en tamaño.
Notas
| Macro de prueba de características | Valor | Std | 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 . ( 3,4 ) |
Ejemplo
|
Esta sección está incompleta
Razón: sin ejemplo |
Véase también
|
acceder o insertar elemento especificado
(función miembro pública) |
|
|
encuentra elemento con clave específica
(función miembro pública) |