Clases Plantilla-Basadas

En este artículo se explica las clases de colección basadas en plantillas diseñó en MFC versión 3,0 y posterior.Mediante estas plantillas crear colecciones con seguridad de tipos es más conveniente y ayuda proporcionan seguridad de tipos más eficazmente que utilizar las clases de colección no basadas en las plantillas.

MFC predefine dos categorías de colecciones basadas en plantillas:

• Matriz simple, lista, y clases asignadas

  CArray, CList, CMap

• Matrices, listas, y mapas de punteros escritos

  CTypedPtrArray, CTypedPtrList, CTypedPtrMap

Las clases de colección simples no son derivadas de la clase CObject, por lo que heredan la serialización, la creación dinámica, y otras propiedades de CObject.Las clases de colección con tipo de puntero es necesario especificar la clase que se deriva de )que debe ser una de las colecciones de puntero de segunda predefinidas por MFC, como CPtrList o CPtrArray.La nueva clase de colección hereda de la clase base especificada, y las llamadas encapsuladas uso de las funciones miembro de la nueva clase a los miembros de la clase base para aplicar la seguridad de tipos.

Para obtener más información sobre las plantillas de C++, vea Plantillas en la referencia del lenguaje C++.

Mediante la matriz, la lista, plantillas de mapa sencillo

Para utilizar plantillas simples de la colección, debe saber qué tipo de datos puede almacenar en estas colecciones y qué parámetros a utilizar en las declaraciones de la colección.

Matriz simple y Uso enumerado

La matriz simple y clases mostradas, CArray y CList, toman dos parámetros: TYPE y ARG_TYPE.Estas clases pueden almacenar cualquier tipo de datos, que se especifica en el parámetro de tipo :

• Tipos de datos fundamentales de C++, como int, char, y float

• Estructuras y clases de C++

• Otros tipos que defina

Para mayor comodidad y la eficacia, puede utilizar el parámetro de ARG_TYPE para especificar el tipo de argumentos de función.Normalmente, se especifica ARG_TYPE como referencia al tipo que se llama en el parámetro de tipo .Por ejemplo:

CArray<int, int> myArray;
CList<CPerson, CPerson&> myList;

El primer ejemplo declara una colección de matriz, myArray, que contiene s para int.El segundo ejemplo declara una colección de listas, myList, que almacena los objetos de CPerson .Algunas funciones miembro de las clases de colección toman argumentos del parámetro de plantilla de ARG_TYPE especifica un tipo.Por ejemplo, la función miembro de agregar de la clase CArray toma un argumento de ARG_TYPE :

CArray<CPerson, CPerson&> personArr;
CPerson person;
personArr.Add(person);

Uso sencillo de mapa

La clase simple de mapa, CMap, toma cuatro parámetros: TECLA, ARG_KEY, DEFAULT, y ARG_VALUE.Como matriz y clases mostradas, las clases de mapa pueden almacenar cualquier tipo de datos.A diferencia de matrices y listas, que el índice y orden los datos que almacena, las claves de asociar maps y valores: Tiene acceso a un valor en un mapa especificando la clave asociado del valor.El parámetro DOMINANTE especifica el tipo de datos de las claves utilizadas para tener acceso a los datos del mapa.Si el tipo de TECLA es una estructura o clase, el parámetro de ARG_KEY es normalmente una referencia al tipo especificado en TECLA.El parámetro de QUE especifica el tipo de los elementos almacenados en el mapa.Si el tipo de ARG_VALUE es una estructura o clase, el parámetro de ARG_VALUE es normalmente una referencia al tipo especificado en DEFAULT.Por ejemplo:

CMap< int, int, MY_STRUCT, MY_STRUCT& > myMap1;
CMap< CString, LPCTSTR, CPerson, CPerson& > myMap2;

El primer ejemplo almacena los valores de MY_STRUCT , se tiene acceso por las claves de int , y devuelve los elementos desde MY_STRUCT por referencia.El segundo ejemplo almacena los valores de CPerson , se tiene acceso por las claves de CString , y devuelve referencias a elementos acceso.Este ejemplo podría representar una libreta de direcciones simple, en la que se busca a personas por apellido.

Dado que el parámetro DOMINANTE es de CString escrito y el parámetro de KEY_TYPE es de LPCSTRtipo, las claves se almacenan en el mapa como elementos de CString tipo pero se hace referencia en funciones como SetAt con punteros de LPCSTRescrito.Por ejemplo:

CMap< CString, LPCTSTR, CPerson, CPerson& > myMap;
CPerson person;
LPCTSTR lpstrName = _T("Jones");
myMap.SetAt(lpstrName, person);

Mediante plantillas de la colección de Escribir-Puntero

Para utilizar las plantillas de la colección de escribir-puntero, debe saber qué tipo de datos puede almacenar en estas colecciones y qué parámetros a utilizar en las declaraciones de la colección.

Matriz de Escribir-Puntero y Uso enumerado

La matriz y las clases mostradas, CTypedPtrArray y CTypedPtrListde escribir-puntero, toman dos parámetros: BASE_CLASS y TYPE.Estas clases pueden almacenar cualquier tipo de datos, que se especifica en el parámetro de tipo .Son derivadas a partir de una de las clases de colección de segunda que almacena punteros; especifica esta clase base en BASE_CLASS.Para las matrices, utilice CObArray o CPtrArray.Para las listas, utilice CObList o CPtrList.

En efecto, cuando se declara una colección basada en, supongamos CObList, la nueva clase no solo hereda miembros de su clase base, pero también declara a varios miembro con seguridad adicional las funciones y operadores que ayuda proporciona seguridad de tipos encapsulan llamadas a miembros de clase base.Estas encapsulaciones administran toda la conversión de tipos necesaria.Por ejemplo:

CTypedPtrArray<CObArray, CPerson*> myArray;
CTypedPtrList<CPtrList, MY_STRUCT*> myList;

El primer ejemplo se declara una matriz de escribir-puntero, myArray, derivado de CObArray.La matriz almacena y devuelve punteros a objetos de CPerson (donde es una clase CPerson derivada de CObject).Puede llamar a la función miembro de CObArray , o a nuevos GetAt y funciones thunk de ElementAt o utilizar el operador con seguridad de tipos [] .

El segundo ejemplo declara una lista de escribir-puntero, myList, derivado de CPtrList.La lista almacena y devuelve punteros a objetos de MY_STRUCT .Una clase basada en CPtrList se utiliza para almacenar los punteros a objetos no derivados de CObject.CTypedPtrList tiene varias funciones diseñó miembro: GetHead, GetTail, RemoveHead, RemoveTail, GetNext, GetPrev, y GetAt.

Uso del mapa del Escribir-Puntero

La clase del mapa del escribir-puntero, CTypedPtrMap, toma tres parámetros: BASE_CLASS, TECLA, y DEFAULT.El parámetro de BASE_CLASS especifica la clase de la que deriva la nueva clase: CMapPtrToWord, CMapPtrToPtr, CMapStringToPtr, CMapWordToPtr, CMapStringToOb, etc.La TECLA es análoga CERRAR en CMap: Especifica el tipo de la clave utilizada para las búsquedas.El QUE es análogo a DEFAULT en CMap: Especifica el tipo de objeto en el mapa.Por ejemplo:

CTypedPtrMap<CMapPtrToPtr, CString, MY_STRUCT*> myPtrMap;
CTypedPtrMap<CMapStringToOb, CString, CPerson*> myPersonMap;

El primer ejemplo es un mapa según la r de CMapPtrToPt— utiliza las teclas de CString asignadas a punteros a MY_STRUCT.Puede buscar un puntero almacenado llamando a una función con seguridad de tipos de miembro de Lookup .Puede utilizar el operador de [] para buscar un puntero almacenado y agregarlo si no encontrado.Y puede recorrer el mapa mediante la función seguro de GetNextAssoc .También puede llamar a otras funciones miembro de clases CMapPtrToPtr.

El segundo ejemplo es un mapa según el b CMapStringToO— utilizan claves de cadena asignadas a punteros almacenados en los objetos de CMyObject .Puede utilizar los mismos miembros seguridad descritos en el párrafo anterior, o puede llamar a los miembros de la clase CMapStringToOb.

[!NOTA]

Si especifica class o struct escribe para el parámetro de DEFAULT , en lugar de un puntero o una referencia al tipo, la clase o estructura debe tener un constructor de copia.

Para obtener más información, vea Cómo crear una colección de tipo.

Vea también

Conceptos

Colecciones