Classe CObArray

Artigo
06/10/2015

Suporta matrizes de ponteiros de CObject .

class CObArray : public CObject

Membros

Construtores public

Nome	Descrição
CObArray::CObArray	Constrói uma matriz vazia para ponteiros de CObject .

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 ponteiro de elemento dentro da 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

Essas matrizes de objetos são semelhantes às matrizes de C, mas podem dinamicamente reduz e crescer conforme necessário.

Matriz de índices sempre início na posição 0. Você pode decidir se corrigir o limite superior ou permitir que a matriz expandir quando você adiciona elementos após o limite atual. A memória é atribuída continuamente ao limite superior, mesmo se alguns elementos são nulos.

Em O, o tamanho de um objeto de CObArray é delimitado somente na memória disponível.

Como com matriz de energia AC, última hora de acesso para um elemento indexado CObArray são constantes e são independentes do tamanho da matriz.

CObArray inserir a macro de IMPLEMENT_SERIAL para oferecer suporte a serialização e a despejo de seus elementos. Se uma matriz de ponteiros de CObject é armazenada em um arquivo, com o operador sobrecarregado insert ou com a função de membro de Serialize , cada elemento de CObject , é serializado por sua vez junto com seu índice de matriz.

Se você precisar de um despejo dos elementos individuais de CObject em uma matriz, você deve definir o tamanho do objeto de CDumpContext a 1 ou maior.

Quando um objeto de CObArray é excluído, ou quando seus elementos são removidos, somente os ponteiros de CObject são removidos, não os objetos que referenciam.

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.

A derivação da classe da matriz é semelhante à derivação da lista. Para obter detalhes sobre derivar de uma classe de lista de propósito especial, consulte o artigo coleções.

Dica

Você deve usar a macro de IMPLEMENT_SERIAL na implementação da classe derivada se você pretende serializar a matriz.