Compartir a través de


CByteArray Class

Admite matrices dinámicas de bytes.

class CByteArray : public CObject

Members

Las funciones miembro de CByteArray son similares a las funciones miembro de clases CObArray. Debido a esta similitud, puede utilizar la documentación de referencia de CObArray para las características de la función miembro. Siempre que aparezca un puntero de CObject como un parámetro o valor devuelto de la función, sustituya BYTE.

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

por ejemplo, convierte a

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

Constructores públicos

Name

Descripción

CObArray::CObArray

Crea una matriz vacía.

Métodos públicos

Name

Descripción

CObArray::Add

Agrega un elemento al final de la matriz; aumenta la matriz en caso necesario.

CObArray::Append

Anexa otra matriz a la matriz; aumenta la matriz en caso necesario.

CObArray::Copy

Copia otra matriz a la matriz; aumenta la matriz en caso necesario.

CObArray::ElementAt

Devuelve una referencia temporal a byte dentro de la matriz.

CObArray::FreeExtra

Libera toda la memoria no utilizada sobre el límite superior actual.

CObArray::GetAt

Devuelve el valor en el índice especificado.

CObArray::GetCount

Obtiene el número de elementos en esta matriz.

CObArray::GetData

Permite el acceso a los elementos de la matriz. puede ser NULL.

CObArray::GetSize

Obtiene el número de elementos en esta matriz.

CObArray::GetUpperBound

Devuelve el índice válido mayor.

CObArray::InsertAt

Inserta un elemento (o todos los elementos en otra matriz) en el índice especificado.

CObArray::IsEmpty

Determina si la matriz está vacía.

CObArray::RemoveAll

Quita todos los elementos de esta matriz.

CObArray::RemoveAt

quita un elemento en un índice específico.

CObArray::SetAt

Establece el valor en el índice especificado; matriz no permitido crecer.

CObArray::SetAtGrow

Establece el valor en el índice especificado; aumenta la matriz en caso necesario.

CObArray::SetSize

Establece el número de elementos que se contendrán en esta matriz.

Operadores públicos

Name

Descripción

CObArray::operator []

Establece u obtiene el elemento en el índice especificado.

Comentarios

CByteArray escribe la macro de IMPLEMENT_SERIAL para admitir la serialización y volcar de sus elementos. Si una matriz de bytes se almacena en un archivo, con el operador sobrecargado de inserción (<<) o con la función miembro de Serialize , cada elemento, a su vez, se serializa.

Nota

Antes de utilizar una matriz, utilice SetSize para establecer su tamaño y para asignar memoria para ella.Si no utiliza SetSize, agregar elementos a la matriz hace con frecuencia que se reasignara y copiar.La reasignación frecuente y la copia son ineficaces y pueden fragmentar la memoria.

Si necesita depuración generar de elementos individuales de la matriz, debe establecer la profundidad del objeto de CDumpContext en 1 o posterior.

Para obtener más información sobre cómo utilizar CByteArray, vea el artículo colecciones.

Jerarquía de herencia

CObject

CByteArray

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

CObject (Clase)

Gráfico de jerarquías

CObArray (Clase)