CStringList-Klasse

Stützlisten von CString-Objekten.

class CStringList : public CObject

Mitglieder

Die Memberfunktionen von CStringList sind - Memberfunktion der Klasse CObList ähnlich.Aufgrund dieser Ähnlichkeit, können Sie die CObList Referenzdokumentation für Memberfunktionsbesonderen verwenden.Wenn Sie einen CObject Zeiger als Rückgabewert finden, ersetzen Sie CString (keinen CString Zeiger).Wenn Sie einen CObject Zeiger als Funktionsparameter finden, ersetzen Sie LPCTSTR.

CObject*& CObList::GetHead() const;

beispielsweise übersetzt zu

CString& CStringList::GetHead() const;

und

POSITION AddHead( CObject* <newElement> );

übersetzt zu

POSITION AddHead( LPCTSTR <newElement> );

kkh6xzcc.collapse_all(de-de,VS.110).gifÖffentliche Konstruktoren

Name

Description

CObList::CObList

Erstellt eine leere Liste.

kkh6xzcc.collapse_all(de-de,VS.110).gifÖ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

Alle Vergleiche werden durch den Wert ausgeführt und bedeuten, dass die Zeichen in der Zeichenfolge anstelle der Adressen der Zeichenfolgen verglichen werden.

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

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

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

Vererbungshierarchie

CObject

CStringList

Anforderungen

Header: afxcoll.h

Siehe auch

Referenz

CObject-Klasse

Hierarchien-Diagramm

Konzepte

MFC-Beispiel COLLECT