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
CStringList
Anforderungen
Header: afxcoll.h