Classe de CSimpleMap

Artigo
06/09/2015

Essa classe fornece suporte para uma matriz simples de mapeamento.

template <  
   class TKey, 
   class TVal, 
   class TEqual = CSimpleMapEqualHelper< TKey, TVal >  
>  
class CSimpleMap

Parâmetros

TKey
o tipo de elemento chave.
TVal
O tipo de elemento de valor.
TEqual
Um objeto sublinhado, definindo o teste de igualdade para elementos do tipo T.

Membros

Typedefs público

Nome	Descrição
CSimpleMap::_ArrayElementType	Typedef para o tipo de valor.
CSimpleMap::_ArrayKeyType	Typedef para o tipo de chave.

Construtores public

Nome	Descrição
CSimpleMap::CSimpleMap	o construtor.
CSimpleMap::~CSimpleMap	O destrutor.

Métodos públicos

Nome	Descrição
CSimpleMap::Add	Adiciona uma chave e um valor associado à matriz de mapa.
CSimpleMap::FindKey	Localiza uma chave específica.
CSimpleMap::FindVal	Localiza um valor específico.
CSimpleMap::GetKeyAt	Recupera a chave especificada.
CSimpleMap::GetSize	Retorna o número de entradas na matriz de mapeamento.
CSimpleMap::GetValueAt	Recupera o valor especificado.
CSimpleMap::Lookup	Retorna o valor associado com a chave determinada.
CSimpleMap::Remove	Remove um valor da chave e de correspondência.
CSimpleMap::RemoveAll	Remove todas as chaves e valores.
CSimpleMap::RemoveAt	Remove um valor específico de chave e de correspondência.
CSimpleMap::ReverseLookup	Retorna a chave associada com o valor fornecido.
CSimpleMap::SetAt	Defina o valor associado com a chave determinada.
CSimpleMap::SetAtIndex	Define a chave e o valor específico.

Comentários

CSimpleMap fornece suporte para uma matriz simples de mapeamento de qualquer tipo determinado T, gerenciando uma matriz não ordenada de chaves elementos e seus valores associados.

O parâmetro TEqual fornece um meio para definir uma função de igualdade para dois elementos de tipo T. Criando uma classe semelhante a CSimpleMapEqualHelper, é possível alterar o comportamento de teste de igualdade para qualquer matriz fornecida. Por exemplo, ao manipular uma matriz de ponteiros, pode ser útil para definir a igualdade como dependendo dos ponteiros referenciam. A implementação padrão usa operator==().

CSimpleMap e CSimpleArray são fornecidos para compatibilidade com versões anteriores de ATL, e as implementações mais completo e mais eficientes de coleção são fornecidas por CAtlArray e por CAtlMap.

Diferentemente de outras coleções de mapa de ATL e em MFC, essa classe é implementada com uma matriz simples, e as pesquisas de pesquisa requerem uma pesquisa linear. CAtlMap deve ser usado quando a matriz contém um grande número de elementos.

Requisitos

Cabeçalho: atlsimpcoll.h

Exemplo

// Create a map with an integer key and character pointer value
CSimpleMap<int, char *> iArray;

Consulte também

Outros recursos

Visão geral da classe de ATL

Partilhar via