Classe di CObArray

Articolo
02/19/2013

Supporta le matrici di puntatori a CObject.

class CObArray : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CObArray::CObArray	Crea una matrice vuota per puntatori a CObject.

Metodi pubblici

Nome	Descrizione
CObArray::Add	Aggiungere un elemento alla fine della matrice, ingrandito la matrice se necessario.
CObArray::Append	Aggiunge un'altra matrice alla matrice, ingrandito la matrice se necessario.
CObArray::Copy	Copia un'altra matrice alla matrice, ingrandito la matrice se necessario.
CObArray::ElementAt	Restituisce un riferimento temporaneo al puntatore dell'elemento nella matrice.
CObArray::FreeExtra	Libera la memoria inutilizzata sul limite superiore corrente.
CObArray::GetAt	Restituisce il valore a un indice specificato.
CObArray::GetCount	Ottiene il numero di elementi nella matrice.
CObArray::GetData	Consente l'accesso a elementi nella matrice.Può essere NULL.
CObArray::GetSize	Ottiene il numero di elementi nella matrice.
CObArray::GetUpperBound	Restituisce il maggiore indice valido.
CObArray::InsertAt	Inserire un elemento (o tutti gli elementi in un'altra matrice) a un indice specificato.
CObArray::IsEmpty	Determina se la matrice è vuota.
CObArray::RemoveAll	Rimuove tutti gli elementi della matrice.
CObArray::RemoveAt	Rimuove un elemento a un valore specifico.
CObArray::SetAt	Imposta il valore di indice specificato; matrice non consentita per lo sviluppo.
CObArray::SetAtGrow	Imposta il valore di indice specificato; ingrandito la matrice se necessario.
CObArray::SetSize	Imposta il numero di elementi da includere nella matrice.

Operatori pubblici

Nome	Descrizione
CObArray::operator [ ]	Imposta o ottiene l'elemento all'indice specificato.

Note

Queste matrici di oggetti sono simili alle matrici c, ma possono essere ridotti o ingranditi in modo dinamico in base alle esigenze.

Gli indici di matrice iniziano sempre nella posizione 0.È possibile decidere se correggere il limite superiore o consentire la matrice si espande quando si aggiungono elementi al limite corrente.Viene allocata memoria in modo contiguo al limite superiore, anche se alcuni elementi sono null.

In Win32, la dimensione di un oggetto CObArray è limitata solo alla memoria disponibile.

Come matrice di tipo c, il tempo di accesso per un elemento indicizzato CObArray è costante e è indipendente dalla dimensione della matrice.

CObArray include la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump degli elementi.Se una matrice di puntatori a CObject viene archiviata in un archivio, con l'operatore di overload di inserimento o con la funzione membro Serialize, ogni elemento CObject, a sua volta, viene serializzato al relativo indice della matrice.

Se è necessario un dump degli elementi CObject dell'utente in una matrice, è necessario impostare la profondità dell'oggetto CDumpContext a 1 o superiore.

Quando un oggetto CObArray viene eliminato, oppure quando gli elementi vengono rimossi, solo i puntatori CObject vengono eliminati, non oggetti che fanno riferimento.

[!NOTA]

Prima di utilizzo di una matrice, utilizzare SetSize per stabilire le dimensioni e per allocare memoria per.Se non si utilizza SetSize, aggiungere elementi alla matrice in modo che venga ridistribuito e alla copia di frequente.Il frequente riallocazione e copiare sono inefficaci e possono frammentare la memoria.

La derivazione della classe di matrice è simile alla derivazione dell'elenco.Per informazioni dettagliate sulla derivazione di una classe per scopi specifici dell'elenco, vedere l'articolo Raccolte.