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 |
---|---|
Erstellt eine leere Liste. |
Öffentliche Methoden
Name |
Description |
---|---|
Fügt ein Element (oder alle Elemente in anderen Liste) den Kopf der Liste hinzu (erstellt einen neuen Kopf erstellt). |
|
Fügt ein Element (oder alle Elemente in anderen Liste) dem Ende der Liste hinzu (erstellt ein neues Ende erstellt). |
|
Ruft die Position eines Elements ab, das von Zeigerwert angegeben wird. |
|
Ruft die Position eines Elements ab, das durch einen nullbasierten Index angegeben wird. |
|
Ruft das Element in einer angegebenen Position ab. |
|
Gibt die Anzahl von Elementen in dieser Liste zurück. |
|
Gibt das Anfangselement der Liste zurück (kann nicht leer sein). |
|
Gibt die Position des Anfangselements der Liste zurück. |
|
Ruft das folgende Element zum Durchlaufen ab. |
|
Ruft das vorherige Element zum Durchlaufen ab. |
|
Gibt die Anzahl von Elementen in dieser Liste zurück. |
|
Gibt das Endeelement der Liste zurück (kann nicht leer sein). |
|
Gibt die Position des Endeelements der Liste zurück. |
|
Fügt ein neues Element nach einer angegebenen Position ein. |
|
Fügt ein neues Element vor einer angegebenen Position ein. |
|
Tests für die leere Listenzustand (keine Elemente). |
|
Entfernt alle Elemente aus dieser Liste. |
|
Entfernt ein Element aus dieser Liste, die durch Position angegeben ist. |
|
Entfernt das Element aus dem Anfang der Liste. |
|
Entfernt das Element aus dem Ende der Liste. |
|
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
CStringList
Anforderungen
Header: afxcoll.h