Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Observação
A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.
Suporta arrays de ponteiros de void.
Sintaxe
class CPtrArray : public CObject
Membros
As funções membros de CPtrArray são semelhantes às funções membros da classe CObArray. Devido a esta semelhança, pode usar a CObArray documentação de referência para especificações da função dos membros. Sempre que vir um CObject ponteiro como parâmetro de função ou valor de retorno, substitua por um ponteiro para void.
CObject* CObArray::GetAt( int <nIndex> ) const;
por exemplo, traduz-se em
void* CPtrArray::GetAt( int <nIndex> ) const;
Construtores Públicos
| Nome | Description |
|---|---|
| CPtrArray::CPtrArray | Constrói um array vazio. |
Métodos Públicos
| Nome | Description |
|---|---|
| CPtrArray::Add | Adiciona um elemento ao final do array; Cresce a matriz se necessário. |
| CPtrArray::Append | Adiciona outro array ao array; Cresce a matriz se necessário. |
| CPtrArray::Copiar | Copia outro array para o array; Cresce a matriz se necessário. |
| CPtrArray::ElementAt | Devolve uma referência temporária ao ponteiro de elemento dentro do array. |
| CPtrArray::FreeExtra | Liberta toda a memória não utilizada acima do limite superior atual. |
| CPtrArray::GetAt | Devolve o valor num dado índice. |
| CPtrArray::GetCount | Obtém o número de elementos neste array. |
| CPtrArray::GetData | Permite o acesso a elementos no array. Pode ser NULL. |
| CPtrArray::GetSize | Obtém o número de elementos neste array. |
| CPtrArray::GetUpperBound | Devolve o maior índice válido. |
| CPtrArray::InsertAt | Insere um elemento (ou todos os elementos de outro array) num índice especificado. |
| CPtrArray::IsEmpty | Determina se o array está vazio. |
| CPtrArray::RemoveAll | Remove todos os elementos deste array. |
| CPtrArray::RemoveAt | Remove um elemento num índice específico. |
| CPtrArray::SetAt | Define o valor para um dado índice; Array não pode crescer. |
| CPtrArray::SetAtGrow | Define o valor para um dado índice; Cresce a matriz se necessário. |
| CPtrArray::SetSize | Define o número de elementos a serem contidos neste arranjo. |
Operadores Públicos
| Nome | Description |
|---|---|
| CPtrArray::operador [ ] | Define ou obtém o elemento no índice especificado. |
Observações
CPtrArray incorpora a macro IMPLEMENT_DYNAMIC para suportar o acesso e o dump de tipos em tempo de execução para um CDumpContext objeto. Se precisar de um dump de elementos individuais do array de ponteiros, deve definir a profundidade do contexto do dump para 1 ou superior.
Observação
Antes de usar um array, use SetSize para determinar o seu tamanho e alocar memória para ele. Se não usar SetSize, adicionar elementos ao seu array faz com que este seja frequentemente realocado e copiado. A realocação e cópia frequentes são ineficientes e podem fragmentar a memória.
Os arrays de ponteiros não podem ser serializados.
Quando um array de ponteiros é eliminado, ou quando os seus elementos são removidos, apenas os ponteiros são removidos, e não as entidades a que se referem.
Para mais informações sobre a utilização CPtrArrayde , consulte o artigo Coleções.
Hierarquia de herança
CPtrArray
Requerimentos
Cabeçalho: afxcoll.h