Classe CPtrArray
Dá suporte a matrizes de ponteiros nulos.
Sintaxe
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 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 CObject como um parâmetro de função ou valor de retorno, substitua um ponteiro para void.
CObject* CObArray::GetAt( int <nIndex> ) const;
por exemplo, traduz para
void* CPtrArray::GetAt( int <nIndex> ) const;
Construtores públicos
| Nome | Descrição |
|---|---|
| CPtrArray::CPtrArray | Constrói uma matriz vazia. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CPtrArray::Add | Inclui um elemento ao final da matriz; aumenta a matriz quando necessário. |
| CPtrArray::Append | Acrescenta outra matriz à matriz; aumenta a matriz quando necessário. |
| CPtrArray::Copy | Copia outra matriz à matriz; aumenta a matriz quando necessário. |
| CPtrArray::ElementAt | Retorna uma referência temporária ao ponteiro do elemento dentro da matriz. |
| CPtrArray::FreeExtra | Libera toda memória não usada acima do limite superior atual. |
| CPtrArray::GetAt | Retorna o valor a um determinado índice. |
| CPtrArray::GetCount | Obtém o número de elementos nesta matriz. |
| CPtrArray::GetData | Permite acesso aos elementos na matriz. Pode ser NULL. |
| CPtrArray::GetSize | Obtém o número de elementos nesta matriz. |
| CPtrArray::GetUpperBound | Retorna o maior índice válido. |
| CPtrArray::InsertAt | Insere um elemento (ou todos os elementos em outra matriz) em um índice especificado. |
| CPtrArray::IsEmpty | Determina se a matriz está vazia. |
| CPtrArray::RemoveAll | Remove todos os elementos dessa matriz. |
| CPtrArray::RemoveAt | Remove um elemento a um índice específico. |
| CPtrArray::SetAt | Define o valor de um determinado índice; não é permitido à matriz aumentar. |
| CPtrArray::SetAtGrow | Define o valor de um determinado índice; aumenta a matriz quando necessário. |
| CPtrArray::SetSize | Define o número de elementos a ser contido nesta matriz. |
Operadores públicos
| Nome | Descrição |
|---|---|
| CPtrArray::operator [ ] | Define ou obtém o elemento no índice especificado. |
Comentários
CPtrArray incorpora a macro IMPLEMENT_DYNAMIC para dar suporte ao acesso e despejo de tipo em tempo de execução a um objeto CDumpContext. Se for necessário um despejo de elementos individuais na matriz de ponteiros, será necessário definir a profundidade do contexto do despejo para 1 ou maior.
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.
Matrizes de ponteiro não podem ser serializadas.
Quando uma matriz de ponteiro é excluída ou quando seus elementos são removidos, apenas os ponteiros são removidos, não as entidades que eles referenciam.
Para mais informações sobre como usar CPtrArray, confira o artigo Coleções.
Hierarquia de herança
CPtrArray
Requisitos
Cabeçalho: afxcoll.h