CStringList-Klasse

Unterstützt Listen von CString -Objekten.

Syntax

class CStringList : public CObject

Member

Die Memberfunktionen der CStringList Klasse ähneln den Memberfunktionen der Klasse CObList. Aufgrund dieser Ähnlichkeit können Sie die CObList-Referenzdokumentation für Memberfunktionsbesonderheiten verwenden. Wenn ein Zeiger als Rückgabewert angezeigt CObject wird, ersetzen Sie einen CString (nicht einen CString Zeiger). Wenn ein Zeiger als Funktionsparameter angezeigt wird CObject , ersetzen Sie ein LPCTSTR.

CObject*& CObList::GetHead() const;

Beispielsweise übersetzt zu

CString& CStringList::GetHead() const;

and

POSITION AddHead( CObject* <newElement> );

wird übersetzt in

POSITION AddHead( LPCTSTR <newElement> );

Öffentliche Konstruktoren

Name	Beschreibung
CStringList::CStringList	Erstellt eine leere Liste.

Öffentliche Methoden

Name	Beschreibung
CStringList::AddHead	Fügt dem Kopf der Liste ein Element (oder alle Elemente in einer anderen Liste) hinzu (macht einen neuen Kopf).
CStringList::AddTail	Fügt dem Listenende ein Element (oder alle Elemente in einer anderen Liste) hinzu (macht einen neuen Tail).
CStringList::Find	Ruft die Position eines Elements ab, das durch Zeigerwert angegeben wird.
CStringList::FindIndex	Ruft die Position eines Elements ab, das durch einen nullbasierten Index angegeben wird.
CStringList::GetAt	Ruft das Element an einer bestimmten Position ab.
CStringList::GetCount	Gibt die Anzahl der Elemente in dieser Liste zurück.
CStringList::GetHead	Gibt das Kopfelement der Liste zurück (darf nicht leer sein).
CStringList::GetHeadPosition	Gibt die Position des Kopfelements der Liste zurück.
CStringList::GetNext	Ruft das nächste Element zum Durchlaufen ab.
CStringList::GetPrev	Ruft das vorherige Element zum Durchlaufen ab.
CStringList::GetSize	Gibt die Anzahl der Elemente in dieser Liste zurück.
CStringList::GetTail	Gibt das Tail-Element der Liste zurück (kann nicht leer sein).
CStringList::GetTailPosition	Gibt die Position des Tail-Elements der Liste zurück.
CStringList::InsertAfter	Fügt ein neues Element nach einer bestimmten Position ein.
CStringList::InsertBefore	Fügt ein neues Element vor einer bestimmten Position ein.
CStringList::IsEmpty	Tests für die leere Listenbedingung (keine Elemente).
CStringList::RemoveAll	Entfernt alle Elemente aus dieser Liste.
CStringList::RemoveAt	Entfernt ein Element aus dieser Liste, angegeben nach Position.
CStringList::RemoveHead	Entfernt das Element aus dem Kopf der Liste.
CStringList::RemoveTail	Entfernt das Element aus dem Tail der Liste.
CStringList::SetAt	Legt das Element an einer bestimmten Position fest.

Hinweise

Alle Vergleiche werden anhand des Werts durchgeführt, d. h., die Zeichen in der Zeichenfolge werden anstelle der Adressen der Zeichenfolgen verglichen.

CStringList enthält das Makro zur Unterstützung der IMPLEMENT_SERIAL Serialisierung und des Dumpings seiner Elemente. Wenn eine Liste von CString Objekten in einem Archiv gespeichert wird, entweder mit einem überladenen Einfügeoperator oder mit der Serialize Memberfunktion, wird jedes CString Element wiederum serialisiert.

Wenn Sie ein Abbild einzelner CString Elemente benötigen, müssen Sie die Tiefe des Dumpkontexts auf 1 oder höher festlegen.

Weitere Informationen zur Verwendung CStringListfinden Sie im Artikel Sammlungen.

Vererbungshierarchie

CObject

CStringList

Anforderungen

Headerafxcoll.h:

Siehe auch

MFC-Beispiel COLLECT
CObject Klasse
Hierarchiediagramm