map::at
Sucht ein Element mit einem angegebenen Schlüsselwert.
Type& at(
const Key& _Key
);
const Type& at(
const Key& _Key
) const;
Parameter
Parameter |
Beschreibung |
_Key |
Der Schlüsselwert, das gesucht werden soll. |
Rückgabewert
Ein Verweis auf den Datenwert des gefundenen Elements.
Hinweise
Wenn der Argumentschlüsselwert nicht gefunden wird, löst die Funktion ein Objekt der Klasse out_of_range-Klasse aus.
Beispiel
// 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);
}
Ausgabe
c1.at('a') == 1
c1.at('b') == 2
c1.at('c') == 3
Anforderungen
Header: <map>
Namespace: std