Partager via


map::at

Recherche un élément avec une valeur de clé spécifiée.

Type& at(
   const Key& _Key
);
const Type& at(
   const Key& _Key
) const;

Paramètres

Paramètre

Description

_Key

La valeur de clé à trouver.

Valeur de retour

Une référence à la valeur de données de l'élément trouvé.

Notes

Si la valeur de clé d'argument est introuvable, la fonction lève un objet de classe out_of_range Class.

Exemple

// map_at.cpp
// compile with: /EHsc
#include <map>
#include <iostream>

typedef std::map<char, int> Mymap; 
int main() 
    { 
    Mymap c1; 
 
    c1.insert(Mymap::value_type('a', 1)); 
    c1.insert(Mymap::value_type('b', 2)); 
    c1.insert(Mymap::value_type('c', 3)); 
 
// find and show elements
    std::cout << "c1.at('a') == " << c1.at('a') << std::endl; 
    std::cout << "c1.at('b') == " << c1.at('b') << std::endl; 
    std::cout << "c1.at('c') == " << c1.at('c') << std::endl; 

    return (0); 
    } 

Sortie

c1.at('a') == 1
c1.at('b') == 2
c1.at('c') == 3

Configuration requise

en-tête : <map>

l'espace de noms : DST

Voir aussi

Référence

map Class

Modèles Standard