Clase CByteArray

Artículo
04/10/2013

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.