std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: at
From cppreference.net
<
cpp
|
container
|
unordered map
|
T
&
at
(
const
Key
&
key
)
;
|
(1) | (depuis C++11) |
|
const
T
&
at
(
const
Key
&
key
)
const
;
|
(2) | (depuis C++11) |
|
template
<
class
K
>
T & at ( const K & x ) ; |
(3) | (depuis C++26) |
|
template
<
class
K
>
const T & at ( const K & x ) const ; |
(4) | (depuis C++26) |
Retourne une référence à la valeur mappée de l'élément avec la clé spécifiée. Si aucun élément de ce type n'existe, une exception de type std::out_of_range est levée.
1,2)
La clé est équivalente à
key
.
3,4)
La clé est
équivalente
à la valeur
x
. La référence à la valeur mappée est obtenue comme par l'expression
this
-
>
find
(
x
)
-
>
second
.
L'expression
this
-
>
find
(
x
)
doit être bien formée et avoir un comportement bien défini, sinon le comportement est indéfini.
Ces surcharges participent à la résolution de surcharge seulement si
Hash
et
KeyEqual
sont tous deux
transparents
. Cela suppose qu'un tel
Hash
peut être appelé avec les types
K
et
Key
, et que le
KeyEqual
est transparent, ce qui, ensemble, permet d'appeler cette fonction sans construire une instance de
Key
.
Table des matières |
Paramètres
| key | - | la clé de l'élément à trouver |
| x | - | une valeur de type quelconque pouvant être comparée de manière transparente avec une clé |
Valeur de retour
Une référence à la valeur mappée de l'élément demandé.
Exceptions
3,4)
std::out_of_range
si le conteneur ne possède pas l'élément spécifié, c'est-à-dire si
find
(
x
)
==
end
(
)
est
true
.
Complexité
Cas moyen : constant, cas le plus défavorable : linéaire en taille.
Notes
| Macro de test de fonctionnalité | Valeur | Std | Fonctionnalité |
|---|---|---|---|
__cpp_lib_associative_heterogeneous_insertion
|
202311L
|
(C++26) | Surcharges hétérogènes pour les fonctions membres restantes dans les conteneurs associatifs ordonnés et non ordonnés . ( 3,4 ) |
Exemple
|
Cette section est incomplète
Raison : aucun exemple |
Voir aussi
|
accéder ou insérer un élément spécifié
(fonction membre publique) |
|
|
trouve un élément avec une clé spécifique
(fonction membre publique) |