Clase CWordArray
Admite matrices de palabras de 16 bits.
Sintaxis
class CWordArray : public CObject
Miembros
Las funciones miembro de CWordArray son similares a las de la clase CObArray. Debido a esta similitud, puede utilizar la documentación de referencia de CObArray para obtener información específica de la función miembro. Siempre que vea un puntero CObject como un parámetro de función o un valor devuelto, sustituya un elemento WORD.
CObject* CObArray::GetAt( int <nIndex> ) const;
por ejemplo, se traduce en
WORD CWordArray::GetAt( int <nIndex> ) const;
Constructores públicos
| Nombre | Descripción |
|---|---|
| CWordArray::CWordArray | Construye una matriz vacía. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CWordArray::Add | Agrega un elemento al final de la matriz; aumenta el tamaño de la matriz si es necesario. |
| CWordArray::Append | Anexa otra matriz a la matriz; aumenta el tamaño de la matriz si es necesario. |
| CWordArray::Copy | Copia otra matriz a la matriz; aumenta el tamaño de la matriz si es necesario. |
| CWordArray::ElementAt | Devuelve una referencia temporal al puntero del elemento dentro de la matriz. |
| CWordArray::FreeExtra | Libera toda la memoria no usada por encima del límite superior actual. |
| CWordArray::GetAt | Devuelve el valor en un índice dado. |
| CWordArray::GetCount | Obtiene el número de elementos de esta matriz. |
| CWordArray::GetData | Permite el acceso a los elementos de la matriz. Puede ser NULL. |
| CWordArray::GetSize | Obtiene el número de elementos de esta matriz. |
| CWordArray::GetUpperBound | Devuelve el índice válido de mayor tamaño. |
| CWordArray::InsertAt | Inserta un elemento (o todos los elementos de otra matriz) en un índice especificado. |
| CWordArray::IsEmpty | Determina si la matriz está vacía. |
| CWordArray::RemoveAll | Quita todos los elementos de esta matriz. |
| CWordArray::RemoveAt | Quita un elemento en un índice específico. |
| CWordArray::SetAt | Establece el valor de un índice dado; la matriz no puede aumentar de tamaño. |
| CWordArray::SetAtGrow | Establece el valor de un índice dado; aumenta el tamaño de la matriz si es necesario. |
| CWordArray::SetSize | Establece el número de elementos que contendrá esta matriz. |
Operadores públicos
| Nombre | Descripción |
|---|---|
CWordArray::operator[] |
Establece u obtiene el elemento en el índice especificado. |
Comentarios
CWordArray incorpora la macro IMPLEMENT_SERIAL para admitir la serialización y el volcado de sus elementos. Si una matriz de palabras se almacena en un archivo, bien con un operador de inserción sobrecargado, o bien con la función miembro CObject::Serialize, cada elemento se serializa a su vez.
Nota:
Antes de usar una matriz, use SetSize para establecer su tamaño y asignarle memoria. Si no usa SetSize, al agregar elementos a la matriz, esta se reasigna y se copia con frecuencia. La reasignación y copia frecuentes son ineficaces y pueden fragmentar la memoria.
Si se necesita un volcado de elementos individuales en la matriz, se debe establecer la profundidad del contexto de volcado en 1 o un valor superior.
Para más información sobre cómo usar CWordArray, consulte el artículo Colecciones.
Jerarquía de herencia
CWordArray
Requisitos
Encabezado: afxcoll.h
Consulte también
Ejemplo COLLECT de MFC
CObject (clase)
Gráfico de jerarquías