CStringList Třída
Podporuje seznamy CString objektů.
Syntaxe
class CStringList : public CObject
Členové
Členské funkce CStringList jsou podobné členským funkcím třídy CObList. Vzhledem k této podobnosti můžete použít CObList referenční dokumentaci pro specifika členské funkce. Všude, kde se ukazatel zobrazuje jako návratová CObject hodnota, nahraďte znakem CString (nikoli ukazatelem CString ). Kdykoli uvidíte CObject ukazatel jako parametr funkce, nahraďte ho .LPCTSTR
CObject*& CObList::GetHead() const;
Například se přeloží na
CString& CStringList::GetHead() const;
a
POSITION AddHead( CObject* <newElement> );
překládá na
POSITION AddHead( LPCTSTR <newElement> );
Veřejné konstruktory
| Název | Popis |
|---|---|
CStringList::CStringList |
Vytvoří prázdný seznam. |
Veřejné metody
| Název | Popis |
|---|---|
CStringList::AddHead |
Přidá prvek (nebo všechny prvky v jiném seznamu) do hlavy seznamu (vytvoří novou hlavu). |
CStringList::AddTail |
Přidá prvek (nebo všechny prvky v jiném seznamu) na konec seznamu (vytvoří nový ocas). |
CStringList::Find |
Získá pozici prvku určeného hodnotou ukazatele. |
CStringList::FindIndex |
Získá pozici prvku určeného indexem založeným na nule. |
CStringList::GetAt |
Získá prvek na dané pozici. |
CStringList::GetCount |
Vrátí počet prvků v tomto seznamu. |
CStringList::GetHead |
Vrátí hlavní prvek seznamu (nemůže být prázdný). |
CStringList::GetHeadPosition |
Vrátí pozici hlavního prvku seznamu. |
CStringList::GetNext |
Získá další prvek pro iterování. |
CStringList::GetPrev |
Získá předchozí prvek pro iterování. |
CStringList::GetSize |
Vrátí počet prvků v tomto seznamu. |
CStringList::GetTail |
Vrátí koncovou část seznamu (nemůže být prázdný). |
CStringList::GetTailPosition |
Vrátí pozici koncového prvku seznamu. |
CStringList::InsertAfter |
Vloží nový prvek za danou pozici. |
CStringList::InsertBefore |
Vloží nový prvek před danou pozici. |
CStringList::IsEmpty |
Testuje prázdnou podmínku seznamu (žádné prvky). |
CStringList::RemoveAll |
Odebere všechny prvky z tohoto seznamu. |
CStringList::RemoveAt |
Odebere prvek z tohoto seznamu určený pozicí. |
CStringList::RemoveHead |
Odebere prvek z hlavy seznamu. |
CStringList::RemoveTail |
Odebere prvek z konce seznamu. |
CStringList::SetAt |
Nastaví prvek na dané pozici. |
Poznámky
Všechna porovnání se provádějí podle hodnoty, což znamená, že se znaky v řetězci porovnávají místo adres řetězců.
CStringListIMPLEMENT_SERIAL obsahuje makro pro podporu serializace a dumpingu jeho prvků. Pokud je seznam CString objektů uložen v archivu, buď s přetíženým operátorem vložení, nebo s Serialize členské funkce, každý CString prvek je serializován postupně.
Pokud potřebujete výpis jednotlivých CString prvků, musíte nastavit hloubku kontextu výpisu na hodnotu 1 nebo vyšší.
Další informace o použití CStringListnaleznete v článku Kolekce.
Hierarchie dědičnosti
CStringList
Požadavky
Záhlaví: afxcoll.h