Classe CByteArray

Suporta matrizes dinâmicas de bytes.

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 similaridade, você pode usar a documentação de referência de CObArray para específicos da função de membro. Onde quer que você verá um ponteiro de CObject como um ou um valor de retorno da função, substitua BYTE.

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

por exemplo, converte a

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

Construtores public

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

Métodos públicos

Nome	Descrição
CObArray::Add	Adiciona um elemento ao final da matriz; aumenta a matriz se necessário.
CObArray::Append	Acrescenta uma matriz a outra matriz; aumenta a matriz se necessário.
CObArray::Copy	Copia uma matriz a outra matriz; aumenta a matriz se necessário.
CObArray::ElementAt	Retorna uma referência temporária ao byte na matriz.
CObArray::FreeExtra	Qualquer libera a memória não usado acima do limite superior atual.
CObArray::GetAt	Retorna o valor em um índice especificado.
CObArray::GetCount	Obtém o número de elementos em esta matriz.
CObArray::GetData	Permite acesso aos elementos na matriz. Pode ser NULO.
CObArray::GetSize	Obtém o número de elementos em esta matriz.
CObArray::GetUpperBound	Retorna o índice válido maior.
CObArray::InsertAt	Insere elemento (ou todos os elementos em outros matriz) em um índice especificado.
CObArray::IsEmpty	Determina se a matriz está vazia.
CObArray::RemoveAll	Remove todos os elementos da matriz.
CObArray::RemoveAt	Remove um elemento em um índice específico.
CObArray::SetAt	Defina o valor para um índice dado; matriz não permitida crescer.
CObArray::SetAtGrow	Defina o valor para um índice dado; aumenta a matriz se necessário.
CObArray::SetSize	Define o número de elementos a serem contidos em esta matriz.

Operadores públicos

Nome	Descrição
[CObArray::operator]	Obtém ou define o elemento no índice especificado.

Comentários

CByteArray inserir a macro de IMPLEMENT_SERIAL para oferecer suporte a serialização e a despejo de seus elementos. Se uma matriz de bytes está armazenada em um arquivo, com o operador sobrecarregado de inserção (<<) ou com a função de membro de Serialize , cada elemento, é serializado por sua vez.

Dica

Antes de usar uma matriz, use SetSize para estabelecer o tamanho e atribuir a memória para ele.Se você não usar SetSize, adicione os elementos a sua matriz freqüentemente faz com que ele manipule a ser realocada e copiado.A realocação freqüentes e copiar e são não podem fragmentar a memória.

Se você precisar saída de depuração dos elementos individuais na matriz, você deve definir o tamanho do objeto de CDumpContext a 1 ou maior.

Para obter mais informações sobre como usar CByteArray, consulte o artigo coleções.

Hierarquia de herança

CObject

CByteArray

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObject

Gráfico da hierarquia

Classe CObArray