Classe CList
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 |
---|---|
Crea un elenco ordinato vuoto. |
Metodi pubblici
Nome |
Descrizione |
---|---|
Aggiunge un elemento (o tutti gli elementi in un altro elenco) all'inizio dell'elenco (effettua una nuova intestazione). |
|
Aggiunge un elemento (o tutti gli elementi in un altro elenco) la parte finale di elenco (effettua un nuovo elemento tail). |
|
Ottiene la posizione di un elemento specificato dal valore di un puntatore. |
|
Ottiene la posizione di un elemento specificato da un indice a base zero. |
|
Ottiene l'elemento nella posizione specificata. |
|
Restituisce il numero di elementi di questo elenco. |
|
Restituisce l'elemento head dell'elenco (non può essere vuoto. |
|
Restituisce la posizione dell'elemento head dell'elenco. |
|
Ottiene l'elemento seguente per l'iterazione. |
|
Ottiene l'elemento precedente per l'iterazione. |
|
Restituisce il numero di elementi di questo elenco. |
|
Restituisce l'elemento tail di elenco (non può essere vuoto. |
|
Restituisce la posizione dell'elemento tail dell'elenco. |
|
Inserisce un nuovo elemento a una posizione specificata. |
|
Inserisce un nuovo elemento prima della posizione specificata. |
|
Test per lo stato dell'elenco vuoto (alcun elemento). |
|
Rimuove tutti gli elementi di questo elenco. |
|
Rimuove un elemento da questo elenco, specificato dalla posizione. |
|
Rimuove l'elemento dall'intestazione dell'elenco. |
|
Rimuove l'elemento dalla coda dell'elenco. |
|
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;
Gerarchia di ereditarietà
CList
Requisiti
Header: afxtempl.h