Compartir a través de


CByteArray (clase)

Admite matrices dinámicas de bytes.

Sintaxis

class CByteArray : public CObject

Miembros

Las funciones miembro de CByteArray 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 o un valor devuelto de función, sustituya un BYTE.

CObject* CObArray::GetAt( int <nIndex> ) const;

por ejemplo, se traduce en

BYTE CByteArray::GetAt( int <nIndex> ) const;

Constructores públicos

Nombre Descripción
CByteArray::CByteArray Construye una matriz vacía.

Métodos públicos

Nombre Descripción
CByteArray::Add Agrega un elemento al final de la matriz; aumenta el tamaño de la matriz si es necesario.
CByteArray::Append Anexa otra matriz a la matriz; aumenta el tamaño de la matriz si es necesario.
CByteArray::Copy Copia otra matriz a la matriz; aumenta el tamaño de la matriz si es necesario.
CByteArray::ElementAt Devuelve una referencia temporal al byte dentro de la matriz.
CByteArray::FreeExtra Libera toda la memoria no usada por encima del límite superior actual.
CByteArray::GetAt Devuelve el valor en un índice dado.
CByteArray::GetCount Obtiene el número de elementos de esta matriz.
CByteArray::GetData Permite el acceso a los elementos de la matriz. Puede ser NULL.
CByteArray::GetSize Obtiene el número de elementos de esta matriz.
CByteArray::GetUpperBound Devuelve el índice válido de mayor tamaño.
CByteArray::InsertAt Inserta un elemento (o todos los elementos de otra matriz) en un índice especificado.
CByteArray::IsEmpty Determina si la matriz está vacía.
CByteArray::RemoveAll Quita todos los elementos de esta matriz.
CByteArray::RemoveAt Quita un elemento en un índice específico.
CByteArray::SetAt Establece el valor de un índice dado; la matriz no puede aumentar de tamaño.
CByteArray::SetAtGrow Establece el valor de un índice dado; aumenta el tamaño de la matriz si es necesario.
CByteArray::SetSize Establece el número de elementos que contendrá esta matriz.

Operadores públicos

Nombre Descripción
CByteArray::operator [ ] Establece u obtiene el elemento en el índice especificado.

Comentarios

CByteArray incorpora la macro IMPLEMENT_SERIAL para admitir la serialización y el volcado de sus elementos. Si una matriz de bytes se almacena en un archivo, tanto con el operador de inserción sobrecargado (<<) como con la función miembro Serialize, cada elemento se serializa individualmente.

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 una salida de depuración de elementos individuales en la matriz, se debe establecer la profundidad del objeto CDumpContext en 1 o un valor superior.

Para más información sobre cómo usar CByteArray, consulte el artículo Colecciones.

Jerarquía de herencia

CObject

CByteArray

Requisitos

Encabezado: afxcoll.h

Consulte también

CObject (clase)
Gráfico de jerarquías
CObArray (clase)