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 clé à rechercher.

Valeur de retour

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

Notes

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

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 : <mappage>

Espace de noms : std

Voir aussi

Référence

map, classe

Bibliothèque STL (Standard Template Library)