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