CList-Klasse

Artikel
06/10/2015

Unterstützt den nonunique sortierte Listen von Objekten, die sequenziell zugegriffen werden kann oder durch einen Wert.

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

Mitglieder

Öffentliche Konstruktoren

Name	Description
CList::CList	Erstellt eine leere sortierte Liste.

Öffentliche Methoden

Name	Description
CList::AddHead	Fügt ein Element (oder alle Elemente in anderen Liste) den Kopf der Liste hinzu (erstellt einen neuen Kopf erstellt).
CList::AddTail	Fügt ein Element (oder alle Elemente in anderen Liste) dem Ende der Liste hinzu (erstellt ein neues Ende erstellt).
CList::Find	Ruft die Position eines Elements ab, das von Zeigerwert angegeben wird.
CList::FindIndex	Ruft die Position eines Elements ab, das durch einen nullbasierten Index angegeben wird.
CList::GetAt	Ruft das Element in einer angegebenen Position ab.
CList::GetCount	Gibt die Anzahl von Elementen in dieser Liste zurück.
CList::GetHead	Gibt das Anfangselement der Liste zurück (kann nicht leer sein).
CList::GetHeadPosition	Gibt die Position des Anfangselements der Liste zurück.
CList::GetNext	Ruft das folgende Element zum Durchlaufen ab.
CList::GetPrev	Ruft das vorherige Element zum Durchlaufen ab.
CList::GetSize	Gibt die Anzahl von Elementen in dieser Liste zurück.
CList::GetTail	Gibt das Endeelement der Liste zurück (kann nicht leer sein).
CList::GetTailPosition	Gibt die Position des Endeelements der Liste zurück.
CList::InsertAfter	Fügt ein neues Element nach einer angegebenen Position ein.
CList::InsertBefore	Fügt ein neues Element vor einer angegebenen Position ein.
CList::IsEmpty	Tests für die leere Listenzustand (keine Elemente).
CList::RemoveAll	Entfernt alle Elemente aus dieser Liste.
CList::RemoveAt	Entfernt ein Element aus dieser Liste, die durch Position angegeben ist.
CList::RemoveHead	Entfernt das Element aus dem Anfang der Liste.
CList::RemoveTail	Entfernt das Element aus dem Ende der Liste.
CList::SetAt	Legt das Element in einer angegebenen Position fest.

Parameter

TYPE
Typ des Objekts in der Liste.
ARG _ TYPE
Geben Sie verwendet, um die Objekte zu verweisen, die in der Liste gespeichert werden. Kann ein Verweis.

Hinweise

CList Listen verhalten sich wie doppelt-verknüpfte Listen.

Eine Variable vom Typ POSITION ist eine Schlüssel für die Liste. Sie können eine POSITION-Variable als Iterator, um eine Liste sequenziell zu durchlaufen und als Lesezeichen verwenden, um einen Ort aufzunehmen. Eine Position ist nicht identisch mit einem Index, jedoch.

Elementeinfügung ist sehr schnell am Listenkopf, am Ende bei bekannten POSITION. Eine sequenzielle Suche ist erforderlich, um ein Element als Wert oder Index gesucht wird. Diese Suche kann langsam sein, wenn die Liste lang ist.

Wenn Sie eine Dumpdatei einzelner Elemente in der Liste benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 festlegen oder größer ist.

Bestimmte Memberfunktionen dieser Klasse rufen globale Hilfsfunktionen auf, die für die meisten Verwendungsmöglichkeiten der Klasse CList angepasst werden müssen. Siehe Auflistungsklassen-Hilfen im "Makro- und Werte" Abschnitt.

Weitere Informationen zur Verwendung von CList, finden Sie im Artikel Auflistungen.

Beispiel

// 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;