Partilhar via


Classe CMapStringToPtr

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Suporta mapas de ponteiros de vazio ligados por CString objetos.

Sintaxe

class CMapStringToPtr : public CObject

Membros

As funções membros de CMapStringToPtr são semelhantes às funções membros da classe CMapStringToOb. Devido a esta semelhança, pode usar a CMapStringToOb documentação de referência para especificações da função dos membros. Sempre que vir um CObject ponteiro como parâmetro de função ou valor de retorno, substitua por um ponteiro para void.

BOOL CMapStringToPtr::Lookup( LPCTSTR <key>, void*& <rValue> ) const;

por exemplo, traduz-se em

BOOL CMapStringToOb::Lookup( const char* <key>, CObject*& <rValue> ) const;

Construtores Públicos

Nome Description
CMapStringToPtr::CMapStringToPtr Construtor.

Métodos Públicos

Nome Description
CMapStringToPtr::GetCount Devolve o número de elementos neste mapa.
CMapStringToPtr::GetHashTableSize Determina o número atual de elementos na tabela hash.
CMapStringToPtr::GetNextAssoc Recebe o próximo elemento para iterar.
CMapStringToPtr::GetSize Devolve o número de elementos neste mapa.
CMapStringToPtr::GetStartPosition Devolve a posição do primeiro elemento.
CMapStringToPtr::HashKey Calcula o valor de hash de uma chave especificada.
CMapStringToPtr::InitHashTable Inicializa a tabela de hash.
CMapStringToPtr::IsEmpty Testa a condição de mapa vazio (sem elementos).
CMapStringToPtr::Procurar Procura um ponteiro de vazio com base na tecla de ponteiro de vazio. O valor do apontador, e não a entidade para a qual aponta, é usado para a comparação de chaves.
CMapStringToPtr::LookupKey Devolve uma referência à chave associada ao valor da chave especificada.
CMapStringToPtr::RemoveAll Remove todos os elementos deste mapa.
CMapStringToPtr::RemoveKey Remove um elemento especificado por uma chave.
CMapStringToPtr::SetAt Insere um elemento no mapa; substitui um elemento existente se for encontrada uma chave correspondente.

Operadores Públicos

Nome Description
CMapStringToPtr::operator [ ] Insere um elemento na aplicação — substituição de operadores para SetAt.

Observações

CMapStringToPtr incorpora a macro IMPLEMENT_DYNAMIC para suportar o acesso e o dump de tipos em tempo de execução para um CDumpContext objeto. Se precisar de um dump de elementos individuais do mapa, deve definir a profundidade do contexto do dump para 1 ou superior.

Os mapas string-para-ponteiro podem não ser serializados.

Quando um CMapStringToPtr objeto é eliminado, ou quando os seus elementos são removidos, os CString objetos-chave e as palavras são removidos.

Hierarquia de herança

CObject

CMapStringToPtr

Requerimentos

Cabeçalho: afxcoll.h

Consulte também

CObject Classe
Gráfico de Hierarquia