Partilhar via


Classe CByteArray

Dá suporte a matrizes dinâmicas de bytes.

Sintaxe

class CByteArray : public CObject

Membros

As funções de membro de CByteArray são semelhantes às funções de membro da classe CObArray. Devido a essa semelhança, é possível usar a documentação de referência da CObArray para obter a função específica de membro. Ao ver um ponteiro de CObject como um parâmetro de função ou valor retornado, substitua um BYTE.

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

por exemplo, traduz para

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

Construtores públicos

Nome Descrição
CByteArray::CByteArray Constrói uma matriz vazia.

Métodos públicos

Nome Descrição
CByteArray::Add Inclui um elemento ao final da matriz; aumenta a matriz quando necessário.
CByteArray::Append Acrescenta outra matriz à matriz; aumenta a matriz quando necessário.
CByteArray::Copy Copia outra matriz à matriz; aumenta a matriz quando necessário.
CByteArray::ElementAt Retorna uma referência temporária ao ponteiro do elemento dentro da matriz.
CByteArray::FreeExtra Libera toda memória não usada acima do limite superior atual.
CByteArray::GetAt Retorna o valor a um determinado índice.
CByteArray::GetCount Obtém o número de elementos nesta matriz.
CByteArray::GetData Permite acesso aos elementos na matriz. Pode ser NULL.
CByteArray::GetSize Obtém o número de elementos nesta matriz.
CByteArray::GetUpperBound Retorna o maior índice válido.
CByteArray::InsertAt Insere um elemento (ou todos os elementos em outra matriz) em um índice especificado.
CByteArray::IsEmpty Determina se a matriz está vazia.
CByteArray::RemoveAll Remove todos os elementos dessa matriz.
CByteArray::RemoveAt Remove um elemento a um índice específico.
CByteArray::SetAt Define o valor de um determinado índice; não é permitido à matriz aumentar.
CByteArray::SetAtGrow Define o valor de um determinado índice; aumenta a matriz quando necessário.
CByteArray::SetSize Define o número de elementos a ser contido nesta matriz.

Operadores públicos

Nome Descrição
CByteArray::operator [ ] Define ou obtém o elemento no índice especificado.

Comentários

A CByteArray incorpora a macro IMPLEMENT_SERIAL para dar suporte à serialização e despejo de seus elementos. Se uma matriz de bytes for armazenada em um arquivo, seja com um operador de inserção sobrecarregado ( <<), seja com a função membro Serialize, cada elemento será serializado por vez.

Observação

Antes de usar uma matriz, utilize SetSize para estabelecer seu tamanho e alocar memória para ela. Se SetSize não for utilizado, incluir elementos à matriz fará com que ela seja frequentemente realocada e copiada. Realocações e cópias frequentes são ineficientes e podem fragmentar a memória.

Se for necessário depurar a saída a partir de elementos individuais na matriz, será necessário definir a profundidade objetoCDumpContext para 1 ou mais.

Para mais informações sobre como usar CByteArray, confira o artigo Coleções.

Hierarquia de herança

CObject

CByteArray

Requisitos

Cabeçalho: afxcoll.h

Confira também

Classe CObject
Gráfico da hierarquia
Classe CObArray