Classe de CPtrArray

Artigo
02/25/2013

Suporta matrizes de ponteiros vagos.

class CPtrArray : public CObject

Membros

As funções de membro de CPtrArray 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 um ponteiro para void.

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

por exemplo, converte a

void* CPtrArray::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 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 NULL.
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

CPtrArray inserir a macro de IMPLEMENT_DYNAMIC para oferecer suporte ao acesso do tipo em tempo de execução e o despejo a CDumpContext de um objeto.Se você precisar de um despejo dos elementos da matriz individuais do ponteiro, você deve definir o tamanho do contexto de um despejo a 1 ou maior.

Observação
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.

Matrizes de ponteiro não podem ser serializadas.

Quando uma matriz de ponteiro é excluída, ou quando seus elementos são removidos, somente os ponteiros são removidos, não as entidades que referenciam.

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