Compartilhar via


hash_map::at

ObservaçãoObservação

este API é obsoleto.Uma alternativa é unordered_map Class.

Localizar um elemento em um hash_map 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 do elemento que deve ser encontrado.

Valor de retorno

Uma referência ao valor de dados do elemento encontrado.

Comentários

Se o valor do argumento não for encontrado, então a função gera uma classe de objeto out_of_range Class.

Em o Visual C++ .NET 2003, os membros dos arquivos de cabeçalho de <hash_map> e de <hash_set> não estão mais no namespace de STD, mas tenham sido portados em vez de stdext no namespace.Consulte O namespace de stdext para mais informações.

Exemplo

// hash_map_at.cpp
// compile with: /EHsc
#include <hash_map>
#include <iostream>

int main( )
{
   using namespace std;
   using namespace stdext;
   typedef pair <const int, int> cInt2Int;
   hash_map <int, int> hm1;
   
   // Insert data values
   hm1.insert ( cInt2Int ( 1, 10 ) );
   hm1.insert ( cInt2Int ( 2, 20 ) );
   hm1.insert ( cInt2Int ( 3, 30 ) );

   cout  << "The values of the mapped elements are:";
   for ( int i = 1 ; i <= hm1.size() ; i++ )
      cout << " " << hm1.at(i);
   cout << "." << endl;
}

Saída

The values of the mapped elements are: 10 20 30.

Requisitos

Cabeçalho: <hash_map>

stdext denamespace:

Consulte também

Referência

hash_map Class

Standard Template Library