Classe di CList

Articolo
03/05/2013

Supporta gli elenchi ordinati di oggetti nonunique accessibili in sequenza o per valore.

template< class TYPE, class ARG_TYPE = const TYPE& > 
class CList : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CList::CList	Crea un elenco ordinato vuoto.

Metodi pubblici

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

Parametri

TYPE
Tipo di oggetto memorizzato.
ARG*_*TYPE
Tipo utilizzato per fare riferimento agli oggetti memorizzati nell'elenco.Può essere un riferimento.

Note

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

Una variabile di tipo POSITION è una chiave per l'elenco.È possibile utilizzare una variabile POSITION come iteratore per scorrere un elenco in sequenza e 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.

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

Alcune funzioni membro della classe chiamano funzioni di supporto globali che devono essere personalizzate per la maggior parte di utilizzare la classe CList.Vedere Supporto della classe di raccolta nella sezione "Globals e di macro".

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

Esempio

// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.

// This code defines a list of ints.
CList<int,int> myIntList;

// This code defines a list of CStrings
CList<CString,CString&> myStringList;

// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE,MYTYPE&> myTypeList;