Classe di CObArray

Supporta le matrici di puntatori a CObject.

class CObArray : public CObject

Membri

088sck34.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

CObArray::CObArray

Crea una matrice vuota per puntatori a CObject.

088sck34.collapse_all(it-it,VS.110).gifMetodi 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.

088sck34.collapse_all(it-it,VS.110).gifOperatori 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.

[!NOTA]

È necessario utilizzare la macro IMPLEMENT_SERIAL nell'implementazione della classe derivata se si desidera serializzare la matrice.

Gerarchia di ereditarietà

CObject

CObArray

Requisiti

Header: afxcoll.h

Vedere anche

Riferimenti

Classe di CObject

Grafico della gerarchia

Classe di CStringArray

Classe di CPtrArray

Classe CByteArray

Classe di CWordArray

Classe di CDWordArray