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
.gif "s897094z.collapse_all(es-es,VS.110).gif")
estructuras públicas
Name |
Descripción |
|---|---|
Una estructura anidada que contiene un valor de clave y el valor del objeto asociado. |
Constructores públicos
Name |
Descripción |
|---|---|
Crea una colección que asigna las claves para los valores. |
Métodos públicos
Name |
Descripción |
|---|---|
Devuelve el número de elementos del mapa. |
|
Devuelve el número de elementos de la tabla hash. |
|
Obtiene el elemento siguiente para recorrer. |
|
Devuelve el número de elementos del mapa. |
|
Devuelve la posición del primer elemento. |
|
Inicializa la tabla hash y especificar su tamaño. |
|
Comprueba la condición de vacío-mapa (ningún elemento). |
|
Busca el valor asignado a una clave especificada. |
|
Devuelve un puntero al primer elemento. |
|
Obtiene un puntero al elemento siguiente para recorrer. |
|
Devuelve un puntero a una clave cuyo valor coincide con el valor especificado. |
|
Quita todos los elementos del mapa. |
|
Quita un elemento especificado por una clave. |
|
Inserta un elemento en la asignación; reemplaza un elemento existente si se encuentra una clave coincidente. |
Operadores públicos
Name |
Descripción |
|---|---|
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
CMap
Requisitos
encabezado: afxtempl.h