Compartir a través de


CMap Class

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: Crear una colección con seguridad de tipos.

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

CObject (Clase)

Gráfico de jerarquías

Conceptos

El ejemplo de MFC como GET