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

Öffentliche Konstruktoren

Name	Description
CObList::CObList	Erstellt eine leere Liste.

Ö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

Hierarchiediagramm

Konzepte

MFC-Beispiel COLLECT