Partilhar via


CMapStringToOb::RemoveKey

Procura a entrada de mapeamento correspondente à chave fornecida; em seguida, se a chave for encontrada, remove a entrada.

BOOL RemoveKey(
   LPCTSTR key 
);

Parâmetros

  • key
    Especifica a seqüência de caracteres usada para pesquisa de MAP.

Valor de retorno

Diferente de zero se a entrada foi encontrada e removida com êxito; caso contrário, 0.

Comentários

Isso pode causar vazamentos de memória se o CObject objeto não é excluído em outro lugar.

A tabela a seguir mostra outras funções de membro semelhantes a CMapStringToOb::RemoveKey.

Classe

Função de membro

CMapPtrToPtr

BOOL RemoveKey (void * key );

CMapPtrToWord

BOOL RemoveKey (void * key );

CMapStringToPtr

BOOL RemoveKey (LPCTSTR key );

CMapStringToString

BOOL RemoveKey (LPCTSTR key );

CMapWordToOb

BOOL RemoveKey (palavra key );

CMapWordToPtr

BOOL RemoveKey (palavra key );

Exemplo

See CObList::CObList para obter uma lista do CAge classe usada em todos os exemplos de coleção.

CMapStringToOb map;

map.SetAt(_T("Bart"), new CAge(13));
map.SetAt(_T("Lisa"), new CAge(11));
map.SetAt(_T("Homer"), new CAge(36));
map.SetAt(_T("Marge"), new CAge(35));
map.RemoveKey(_T("Lisa")); // Memory leak: CAge object not
                           // deleted.
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("RemoveKey example: ") << &map << _T("\n");
#endif         

sistema autônomo resultados deste programa são da seguinte maneira:

RemoveKey example: A CMapStringToOb with 3 elements

[Marge] = a CAge at $49A0 35

[Homer] = a CAge at $495E 36

[Bart] = a CAge at $4634 13

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CMapStringToOb

Gráfico de hierarquia

CMapStringToOb::RemoveAll

Outros recursos

CMapStringToOb membros