Freigeben über


CList-Klasse

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;

Vererbungshierarchie

CObject

CList

Anforderungen

Header: afxtempl.h

Siehe auch

Referenz

CObject-Klasse

Hierarchiediagramm

CMap-Klasse

CArray-Klasse

Konzepte

MFC-Beispiel COLLECT