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

Header: afxcoll.h

Siehe auch

MFC-Beispiel COLLECT
CObject Klasse
Hierarchiediagramm