Clase de CMap

Una clase de colección de diccionarios que asigna las claves únicas en valores.

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

Parámetros

• KEY
  Clase de objeto utilizado como clave al mapa.

• ARG*_*KEY
  tipo de datos utilizado para los argumentos de KEY ; normalmente una referencia a KEY.

• VALUE
  Clase del objeto en el mapa.

• ARG*_*VALUE
  tipo de datos utilizado para los argumentos de VALUE ; normalmente una referencia a VALUE.

Members

estructuras públicas

Name	Descripción
CMap::CPair	Una estructura anidada que contiene un valor de clave y el valor del objeto asociado.

Constructores públicos

Name	Descripción
CMap::CMap	Crea una colección que asigna las claves para los valores.

Métodos públicos

Name	Descripción
CMap::GetCount	Devuelve el número de elementos del mapa.
CMap::GetHashTableSize	Devuelve el número de elementos de la tabla hash.
CMap::GetNextAssoc	Obtiene el elemento siguiente para recorrer.
CMap::GetSize	Devuelve el número de elementos del mapa.
CMap::GetStartPosition	Devuelve la posición del primer elemento.
CMap::InitHashTable	Inicializa la tabla hash y especificar su tamaño.
CMap::IsEmpty	Comprueba la condición de vacío-mapa (ningún elemento).
CMap::Lookup	Busca el valor asignado a una clave especificada.
CMap::PGetFirstAssoc	Devuelve un puntero al primer elemento.
CMap::PGetNextAssoc	Obtiene un puntero al elemento siguiente para recorrer.
CMap::PLookup	Devuelve un puntero a una clave cuyo valor coincide con el valor especificado.
CMap::RemoveAll	Quita todos los elementos del mapa.
CMap::RemoveKey	Quita un elemento especificado por una clave.
CMap::SetAt	Inserta un elemento en la asignación; reemplaza un elemento existente si se encuentra una clave coincidente.

Operadores públicos

Name	Descripción
CMap::operator [ ]	Inserta un elemento en la asignación — sustitución de operador para SetAt.

Comentarios

Una vez que ha insertado un par clave-valor (elemento) en el mapa, puede recuperar o eliminar eficazmente los pares con la tecla de acceso.También puede iterar por todos los elementos del mapa.

Una variable de POSICIÓN tipo se utiliza para el acceso alternativo a entradas.Puede utilizar POSICIÓN “recuerda” una entrada y iterarlo a través del mapa.Crea que esta iteración es secuencial por valor de clave; no es.La secuencia de elementos recuperados es indeterminado.

Algunas funciones miembro de las funciones globales de esta de la clase auxiliar de llamada que se deben personalizar para la mayoría de utilizan la clase de CMap .Vea aplicaciones auxiliares de la clase de colección en la sección de macros y Globals de MFCReference.

CMap reemplaza CObject::Serialize para admitir la serialización y volcar de sus elementos.Si un mapa se almacena en un archivo con Serialize, cada elemento asignado es serializado a su vez.La implementación predeterminada de la función auxiliar de SerializeElements realiza una escritura bit a bit.Para obtener información sobre la serialización de los elementos de colección de puntero derivados de CObject u otros tipos definidos por el usuario, vea Cómo: Cree una colección de tipo.

Si necesita un volcado de diagnóstico de elementos individuales en el mapa (claves y valores), debe establecer el nivel de contexto de volcado en 1 o posterior.

Cuando se elimina un objeto de CMap , o cuando se quitan los elementos, se quitan las claves y valores ambas.

Derivación de la clase de mapa es similar a la derivación de lista.Vea el artículo colecciones para una ilustración de derivación de una clase especial de la lista.

Jerarquía de herencia

CObject

CMap

Requisitos

encabezado: afxtempl.h

Vea también

Referencia

Clase de CObject

Gráfico de jerarquía

Conceptos

El ejemplo de MFC como GET