Classe di CObArray
Supporta le matrici di puntatori a CObject.
class CObArray : public CObject
Membri
Costruttori pubblici
Nome |
Descrizione |
---|---|
Crea una matrice vuota per puntatori a CObject. |
Metodi pubblici
Nome |
Descrizione |
---|---|
Aggiungere un elemento alla fine della matrice, ingrandito la matrice se necessario. |
|
Aggiunge un'altra matrice alla matrice, ingrandito la matrice se necessario. |
|
Copia un'altra matrice alla matrice, ingrandito la matrice se necessario. |
|
Restituisce un riferimento temporaneo al puntatore dell'elemento nella matrice. |
|
Libera la memoria inutilizzata sul limite superiore corrente. |
|
Restituisce il valore a un indice specificato. |
|
Ottiene il numero di elementi nella matrice. |
|
Consente l'accesso a elementi nella matrice.Può essere NULL. |
|
Ottiene il numero di elementi nella matrice. |
|
Restituisce il maggiore indice valido. |
|
Inserire un elemento (o tutti gli elementi in un'altra matrice) a un indice specificato. |
|
Determina se la matrice è vuota. |
|
Rimuove tutti gli elementi della matrice. |
|
Rimuove un elemento a un valore specifico. |
|
Imposta il valore di indice specificato; matrice non consentita per lo sviluppo. |
|
Imposta il valore di indice specificato; ingrandito la matrice se necessario. |
|
Imposta il numero di elementi da includere nella matrice. |
Operatori pubblici
Nome |
Descrizione |
---|---|
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à
CObArray
Requisiti
Header: afxcoll.h