Compartilhar via


Classe CMap

Uma classe de coleção de dicionário que mapeia chaves exclusivas para valores.

template< class KEY, class ARG_KEY, class VALUE, class ARG_VALUE >class CMap : public CObject

Parâmetros

  • KEY
    Classe do objeto usado sistema autônomo chave para o MAP.

  • ARG*_*KEY
    Tipo de dados usado para KEY argumentos; geralmente uma referência para KEY.

  • VALUE
    Classe do objeto armazenado no MAP.

  • ARG*_*VALUE
    Tipo de dados usado para VALUE argumentos; geralmente uma referência para VALUE.

Comentários

Depois que você inseriu um emparelhar chave-valor (elemento) para o MAP, com eficiência pode recuperar ou excluir o emparelhar usando a chave para acessá-lo.Também é possível iterar sobre todos os elementos no MAP.

Uma variável do tipo POSIÇÃO é usado para acesso alternativo às entradas.Você pode usar um POSIÇÃO para uma entrada "lembrar" e iterar através do MAP.Você pode achar que essa iteração é seqüencial por valor de chave; não é.A sequência dos elementos recuperados é indeterminada.

Determinadas funções de membro desta telefonar de classe auxiliar global funções que devem ser personalizadas para a maioria dos usos do CMap classe. See Collection Class Helpers in the Macros and Globals section of the MFCReference.

CMap substituições CObject::Serialize para oferecer suporte a serialização e despejo de seus elementos. Se um MAP estiver armazenado em um arquivar usando Serialize, cada elemento do MAP é serializado por sua vez. A implementação padrão do SerializeElements função auxiliar faz uma gravar de bit a bit. Para obter informações sobre a serialização de ponteiro itens de coleção derivado de CObject ou outros tipos definidos pelo usuário, consulte Como: Tornar uma coleção de fortemente tipado.

Se você precisar de um despejo de diagnóstico dos elementos individuais do MAP (as chaves e valores), você deve conjunto a profundidade do contexto de despejo para 1 ou maior.

Quando um CMap objeto é excluído, ou quando seus elementos são removidos, as chaves e valores sejam removidas.

Derivação de classe de MAP é semelhante à derivação de lista.Consulte o artigo Coleções para obter uma ilustração da derivação de uma classe de lista de finalidades especiais.

Requisitos

Cabeçalho: afxtempl.h

Consulte também

Tarefas

COLETAR Exemplo: Ilustra as classes de coleção do MFC

Referência

Classe CObject

Gráfico de hierarquia

Outros recursos

CMap membros