map::at
Localiza um elemento com um valor de chave especificado.
Type& at(
const Key& _Key
);
const Type& at(
const Key& _Key
) const;
Parâmetros
Parâmetro |
Descrição |
_Key |
O valor de chave a ser localizado. |
Valor de retorno
Uma referência ao valor de dados do elemento encontrado.
Comentários
Se o valor da chave do argumento não for localizado, a função gerará um objeto da classe Classe out_of_range.
Exemplo
// 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);
}
Saída
c1.at('a') == 1
c1.at('b') == 2
c1.at('c') == 3
Requisitos
mapa <deCabeçalho: >
Namespace: std