Classe CPtrArray

Supporta matrici di puntatori void.

Sintassi

class CPtrArray : public CObject

Membri

Le funzioni membro di CPtrArray sono simili alle funzioni membro della classe CObArray. Grazie a questa somiglianza, per le specifiche delle funzioni membro è possibile usare la documentazione di riferimento di CObArray. Ovunque venga visualizzato un CObject puntatore come parametro di funzione o valore restituito, sostituire un puntatore a void.

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

ad esempio, si converte in

void* CPtrArray::GetAt( int <nIndex> ) const;

Costruttori pubblici

Nome	Descrizione
CPtrArray::CPtrArray	Costruisce una matrice vuota.

Metodi pubblici

Nome	Descrizione
CPtrArray::Add	Aggiunge un elemento alla fine della matrice; se necessario, aumenta le dimensioni della matrice.
CPtrArray::Append	Accoda alla matrice un'altra matrice; se necessario, aumenta le dimensioni della matrice.
CPtrArray::Copy	Copia nella matrice un'altra matrice; se necessario, aumenta le dimensioni della matrice.
CPtrArray::ElementAt	Restituisce un riferimento temporaneo al puntatore dell'elemento nella matrice.
CPtrArray::FreeExtra	Libera tutta la memoria non utilizzata oltre limite il superiore corrente.
CPtrArray::GetAt	Restituisce il valore in corrispondenza di un indice specificato.
CPtrArray::GetCount	Ottiene il numero di elementi nella matrice.
CPtrArray::GetData	Consente l'accesso a tutti gli elementi nella matrice. Può essere NULL.
CPtrArray::GetSize	Ottiene il numero di elementi nella matrice.
CPtrArray::GetUpperBound	Restituisce il massimo indice valido.
CPtrArray::InsertAt	Inserisce un elemento (o tutti gli elementi di un'altra matrice) in corrispondenza di un indice specificato.
CPtrArray::IsEmpty	Determina se la matrice è vuota.
CPtrArray::RemoveAll	Rimuove tutti gli elementi dalla matrice.
CPtrArray::RemoveAt	Rimuove un elemento in corrispondenza di un indice specificato.
CPtrArray::SetAt	Imposta il valore per un indice specificato; l'aumento di dimensioni della matrice non è consentito.
CPtrArray::SetAtGrow	Imposta il valore per un indice specificato; se necessario, aumenta le dimensioni della matrice.
CPtrArray::SetSize	Imposta il numero di elementi che la matrice deve contenere.

Operatori pubblici

Nome	Descrizione
CPtrArray::operator [ ]	Imposta o ottiene l'elemento in corrispondenza dell'indice specificato.

Osservazioni:

CPtrArray incorpora la macro IMPLEMENT_DYNAMIC per supportare l'accesso al tipo di runtime e il dump in un CDumpContext oggetto . Se è necessario un dump di singoli elementi della matrice di puntatori, è necessario impostare la profondità del contesto di dump su 1 o versione successiva.

Nota

Prima di usare una matrice, usare SetSize per determinarne le dimensioni e allocare la necessaria memoria. Se non si usa SetSize, l'aggiunta di elementi alla matrice ne causa la riallocazione e la copia frequente. Le operazioni di riallocazione e copia frequenti sono inefficienti e possono frammentare la memoria.

Non è possibile serializzare matrici di puntatori.

Quando viene eliminata una matrice di puntatori o quando i relativi elementi vengono rimossi, vengono rimossi solo i puntatori, non le entità a cui fanno riferimento.

Per altre informazioni sull'uso CPtrArraydi , vedere l'articolo Raccolte.

Gerarchia di ereditarietà

CObject

CPtrArray

Requisiti

Intestazione: afxcoll.h

Vedi anche

Classe CObject
Grafico della gerarchia
Classe CObArray