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
CByteArray
Requisitos
Cabeçalho: afxcoll.h