Classe CObList

Articolo
06/10/2015

Supporta gli elenchi ordinati dei puntatori nonunique CObject accessibili in sequenza o per valore del puntatore.

class CObList : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CObList::CObList	Crea un elenco vuoto per puntatori a CObject.

Metodi pubblici

Nome	Descrizione
CObList::AddHead	Aggiunge un elemento (o tutti gli elementi in un altro elenco) all'inizio dell'elenco (effettua una nuova intestazione).
CObList::AddTail	Aggiunge un elemento (o tutti gli elementi in un altro elenco) la parte finale di elenco (effettua un nuovo elemento tail).
CObList::Find	Ottiene la posizione di un elemento specificato dal valore di un puntatore.
CObList::FindIndex	Ottiene la posizione di un elemento specificato da un indice a base zero.
CObList::GetAt	Ottiene l'elemento nella posizione specificata.
CObList::GetCount	Restituisce il numero di elementi di questo elenco.
CObList::GetHead	Restituisce l'elemento head dell'elenco (non può essere vuoto.
CObList::GetHeadPosition	Restituisce la posizione dell'elemento head dell'elenco.
CObList::GetNext	Ottiene l'elemento seguente per l'iterazione.
CObList::GetPrev	Ottiene l'elemento precedente per l'iterazione.
CObList::GetSize	Restituisce il numero di elementi di questo elenco.
CObList::GetTail	Restituisce l'elemento tail di elenco (non può essere vuoto.
CObList::GetTailPosition	Restituisce la posizione dell'elemento tail dell'elenco.
CObList::InsertAfter	Inserisce un nuovo elemento a una posizione specificata.
CObList::InsertBefore	Inserisce un nuovo elemento prima della posizione specificata.
CObList::IsEmpty	Test per lo stato dell'elenco vuoto (alcun elemento).
CObList::RemoveAll	Rimuove tutti gli elementi di questo elenco.
CObList::RemoveAt	Rimuove un elemento da questo elenco, specificato dalla posizione.
CObList::RemoveHead	Rimuove l'elemento dall'intestazione dell'elenco.
CObList::RemoveTail	Rimuove l'elemento dalla coda dell'elenco.
CObList::SetAt	Imposta l'elemento nel percorso specificato.

Note

Gli elenchi diCObList si comportano come gli elenchi doppio-collegati.

Una variabile di tipo POSITION è una chiave per l'elenco. È possibile utilizzare una variabile POSITION sia come iteratore per scorrere un elenco in sequenza che come segnalibro per utilizzare un punto. Una posizione non è uguale all'indice, tuttavia.

L'inserimento dell'elemento è molto veloceinizio dell'elenco, la parte finale e a POSITIONnoto. Una ricerca sequenziale è necessaria per trovare un elemento per valore o indice. La ricerca può essere lenta se l'elenco è lungo.

CObList include la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump degli elementi. Se l'elenco dei puntatori CObject viene archiviato in un archivio, con un operatore di overload di inserimento o con la funzione membro Serialize, ogni elemento CObject viene serializzato a sua volta.

Se è necessario un dump degli elementi CObject nell'elenco, è necessario impostare la profondità del contesto di dump a 1 o superiore.

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

È possibile derivare classi personalizzate da CObList. La nuova classe di elenco, progettata per utilizzare i puntatori agli oggetti derivati da CObject, aggiunge nuovi membri dati e nuove funzioni membro. Si noti che l'elenco risultante non completamente indipendente dai tipi, in quanto consente l'inserimento del puntatore CObject.

Nota

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

Per ulteriori informazioni su l CObList, vedere l'articolo Raccolte.