CObList-Klasse

Artikel
06/10/2015

Unterstützt sortierte Listen von nonunique CObject Zeigern, die sequenziell zugegriffen werden kann oder durch Zeigerwert.

class CObList : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CObList::CObList	Erstellt eine leere Liste für CObject Zeiger.

Öffentliche Methoden

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

Hinweise

CObList 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.

CObList enthält das IMPLEMENT_SERIAL-Makro, um die Serialisierung und das Speichern seiner Elemente zu unterstützen. Wenn eine Liste von CObject Zeiger zu einem Archiv, entweder mit einem überladenen Einfügungsoperator oder mit der Serialize-Memberfunktion gespeichert wird, wird jedes Element CObject wiederum serialisiert.

Wenn Sie ein Speicherabbild der einzelnen CObject-Elemente in der Liste benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 festlegen oder größer ist.

Wenn ein CObList-Objekt gelöscht oder wenn seine Elemente entfernt werden, nur die CObject Zeiger entfernt werden, nicht die Objekte, die darauf verweisen.

Sie können eigene Klassen von CObList berechnen. Die neue Listenklasse, entwickelt, um Zeiger auf Objekte enthält, die von CObject abgeleitet werden, fügt neue Datenmember und neue Memberfunktionen hinzu. Beachten Sie, dass die resultierende Liste ausschließlich nicht typsicher ist, da sie Einfügen eines beliebigen CObject Zeigers zulässig.

Hinweis

Sie müssen das IMPLEMENT_SERIAL-Makro in der Implementierung der abgeleiteten Klasse verwenden, wenn Sie beabsichtigen, die Liste zu serialisieren.

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