Megosztás a következőn keresztül:


CStringList osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Támogatja az CString objektumok listáját.

Szemantika

class CStringList : public CObject

Tagok

A tagfüggvények CStringList az osztály CObListtagfüggvényeihez hasonlóak. A hasonlóság miatt a CObList tagfüggvény-specifikus referenciadokumentációt használhatja. Ha egy mutatót CObject visszatérési értékként lát, helyettesítsen egy CString (nem mutató) CString elemet. Ahol egy mutatót CObject függvényparaméterként lát, helyettesítsen egy LPCTSTR.

CObject*& CObList::GetHead() const;

például lefordítja a következőre:

CString& CStringList::GetHead() const;

és

POSITION AddHead( CObject* <newElement> );

lefordítja a

POSITION AddHead( LPCTSTR <newElement> );

Nyilvános konstruktorok

Név Description
CStringList::CStringList Üres listát hoz létre.

Nyilvános metódusok

Név Description
CStringList::AddHead Hozzáad egy elemet (vagy egy másik lista összes elemét) a lista éléhez (új fejet hoz létre).
CStringList::AddTail Hozzáad egy elemet (vagy egy másik lista összes elemét) a lista farkához (új farkát készít).
CStringList::Find Lekéri a mutatóérték által megadott elem pozícióját.
CStringList::FindIndex Lekéri egy nulla alapú index által megadott elem pozícióját.
CStringList::GetAt Az elemet egy adott pozícióba helyezi.
CStringList::GetCount A lista elemeinek számát adja vissza.
CStringList::GetHead A lista fő elemét adja vissza (nem lehet üres).
CStringList::GetHeadPosition A lista fő elemének pozícióját adja vissza.
CStringList::GetNext Lekéri az iterálás következő elemét.
CStringList::GetPrev Lekéri az előző elemet az iteráláshoz.
CStringList::GetSize A lista elemeinek számát adja vissza.
CStringList::GetTail A lista farokelemét adja vissza (nem lehet üres).
CStringList::GetTailPosition A lista farokelemének pozícióját adja vissza.
CStringList::InsertAfter Új elemet szúr be egy adott pozíció után.
CStringList::InsertBefore Új elemet szúr be egy adott pozíció elé.
CStringList::IsEmpty Az üres listafeltétel (elemek nélkül) tesztelése.
CStringList::RemoveAll Eltávolítja a listából az összes elemet.
CStringList::RemoveAt Eltávolít egy elemet a listából, amelyet a pozíció határoz meg.
CStringList::RemoveHead Eltávolítja az elemet a lista éléről.
CStringList::RemoveTail Eltávolítja az elemet a lista farkából.
CStringList::SetAt Az elemet egy adott pozícióba állítja.

Megjegyzések

Minden összehasonlítás érték szerint történik, ami azt jelenti, hogy a sztringben szereplő karaktereket a sztringek címei helyett hasonlítjuk össze.

CStringList a makrót beépíti az IMPLEMENT_SERIAL elemek szerializálásának és memóriaképének támogatására. Ha az objektumok listája CString egy archívumban van tárolva, túlterhelt beszúrási operátorral vagy tagfüggvénnyel Serialize , az egyes CString elemek egymás után szerializálva lesznek.

Ha egyedi CString elemekből álló memóriaképre van szüksége, a memóriakép-környezet mélységét 1 vagy nagyobbra kell állítania.

A használatról CStringListtovábbi információt a Gyűjtemények című cikkben talál.

Öröklési hierarchia

CObject

CStringList

Requirements

Fejléc:afxcoll.h

Lásd még

MFC-minta COLLECT
CObject osztály
hierarchiadiagram