map::at

Sucht ein Element mit einem angegebenen Schlüsselwert.

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

Parameter

Rückgabewert

Ein Verweis auf den Datenwert des Elements gefunden.

Hinweise

Wenn der Argumentschlüsselwert nicht gefunden wird, löst die Funktion ein Objekt der Klasse out_of_range Class 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); 
    } 

Output

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

Anforderungen

Header: <map>

Namespace: std

Siehe auch

Referenz

map Class

Standardvorlagenbibliothek