Classe CMapStringToOb

Artigo
06/10/2015

Uma classe de coleção de dicionário que mapeia CString exclusivo objetos para ponteiros de CObject .

class CMapStringToOb : public CObject

Membros

Construtores public

Nome	Descrição
CMapStringToOb::CMapStringToOb	Construtor.

Métodos públicos

Nome	Descrição
CMapStringToOb::GetCount	Retorna o número de elementos em esse mapeamento.
CMapStringToOb::GetHashTableSize	Determina o número de elementos atual na tabela hash.
CMapStringToOb::GetNextAssoc	Obtém o próximo elemento para iterar.
CMapStringToOb::GetSize	Retorna o número de elementos em esse mapeamento.
CMapStringToOb::GetStartPosition	Retorna a posição do primeiro elemento.
CMapStringToOb::HashKey	Calcula o valor de hash de uma chave especificada.
CMapStringToOb::InitHashTable	Inicializa o tabela de hash.
CMapStringToOb::IsEmpty	Testa a condição de mapa vazio- (elementos).
CMapStringToOb::Lookup	Pesquisa um ponteiro vago com base na chave vaga do ponteiro. O valor de ponteiro, não entidade que aponte para, é usado para comparação principal.
CMapStringToOb::LookupKey	Retorna uma referência para a chave associada com o valor da chave especificado.
CMapStringToOb::RemoveAll	Remove todos os elementos de esse mapeamento.
CMapStringToOb::RemoveKey	Remove um elemento especificado por uma chave.
CMapStringToOb::SetAt	Insere um elemento no mapa; substitui um elemento existente se uma tecla correspondente for encontrada.

Operadores públicos

Nome	Descrição
[CMapStringToOb::operator]	Insere um elemento no mapa — substituição do operador para SetAt.

Comentários

Uma vez que você inseriu um par de CString- deCObject* (elemento) no mapa de forma eficiente, você pode recuperar ou exclua os pares usando uma cadeia de caracteres ou um valor de CString como uma chave. Você também pode iterar todos os elementos no mapa.

Uma variável do tipo POSIÇÃO é usado para acesso alternativo de entrada em todas as variações de mapa. Você pode usar POSIÇÃO “memoriza” uma entrada e iterar-lo através do mapa. Você pode pensar que essa interação é seqüencial pelo valor da chave; não é. A seqüência de elementos recuperados é indefinida.

CMapStringToOb inserir a macro de IMPLEMENT_SERIAL para oferecer suporte a serialização e a despejo de seus elementos. Cada elemento é serializado por sua vez se um mapa é armazenado em um arquivo, com o operador sobrecarregado de inserção (<<) ou com a função de membro de Serialize.

Se você precisar de um despejo diagnóstico dos elementos individuais no mapa (o valor de CString e o conteúdo de CObject ), você deve definir o tamanho do contexto de um despejo a 1 ou maior.

Quando um objeto de CMapStringToOb é excluído, ou quando seus elementos são removidos, os objetos de CString e ponteiros de CObject são removidos. Os objetos referenciados pelos ponteiros de CObject não serão destruídos.

A derivação da classe de mapa é semelhante à derivação da lista. Consulte o artigo coleções para uma ilustração de derivar de uma classe de lista de propósito especial.