CStringArray Třída

Podporuje pole CString objektů.

Syntaxe

class CStringArray : public CObject

Členové

Členské funkce CStringArray jsou podobné členským funkcím třídy CObArray. Vzhledem k této podobnosti můžete použít CObArray referenční dokumentaci pro specifika členské funkce. Kdykoli uvidíte ukazatel jako návratovou CObject hodnotu, nahraďte CString objekt (nikoli CString ukazatel). Kdykoli uvidíte CObject ukazatel jako parametr funkce, nahraďte ho LPCTSTR.

CObject* CObArray::GetAt( int <nIndex> ) const;

Například se přeloží na

const CString& CStringArray::GetAt( int <nIndex> ) const;

a

void SetAt( int <nIndex>, CObject* <newElement> )

překládá na

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Veřejné konstruktory

Název	Popis
CStringArray::CStringArray	Vytvoří prázdné pole.

Veřejné metody

Název	Popis
CStringArray::Add	Přidá prvek na konec pole; v případě potřeby pole zvětšuje.
CStringArray::Append	Připojí k matici další pole; v případě potřeby pole zvětšuje.
CStringArray::Copy	Zkopíruje další pole do pole; v případě potřeby pole zvětšuje.
CStringArray::ElementAt	Vrátí dočasný odkaz na ukazatel prvku v rámci pole.
CStringArray::FreeExtra	Uvolní veškerou nevyužitou paměť nad aktuální horní mez.
CStringArray::GetAt	Vrátí hodnotu v daném indexu.
CStringArray::GetCount	Získá počet prvků v tomto poli.
CStringArray::GetData	Umožňuje přístup k prvkům v poli. Může to být NULL.
CStringArray::GetSize	Získá počet prvků v tomto poli.
CStringArray::GetUpperBound	Vrátí největší platný index.
CStringArray::InsertAt	Vloží prvek (nebo všechny prvky v jiném poli) do zadaného indexu.
CStringArray::IsEmpty	Určuje, zda je pole prázdné.
CStringArray::RemoveAll	Odebere všechny prvky z tohoto pole.
CStringArray::RemoveAt	Odebere prvek v určitém indexu.
CStringArray::SetAt	Nastaví hodnotu pro daný index; pole nelze zvětšit.
CStringArray::SetAtGrow	Nastaví hodnotu pro daný index; v případě potřeby pole zvětšuje.
CStringArray::SetSize	Nastaví počet prvků, které mají být obsaženy v tomto poli.

Veřejné operátory

Název	Popis
CStringArray::operator [ ]	Nastaví nebo získá prvek v zadaném indexu.

Poznámky

CStringArrayIMPLEMENT_SERIAL obsahuje makro pro podporu serializace a dumpingu jeho prvků. Pokud je pole CString objektů uloženo do archivu, buď s přetíženým operátorem vložení, nebo s Serialize členské funkce, každý prvek je serializován zase.

Poznámka:

Před použitím pole použijte SetSize k vytvoření jeho velikosti a přidělení paměti. Pokud nepoužíváte SetSize, přidání prvků do pole způsobí, že se často relokuje a kopíruje. Časté relokace a kopírování jsou neefektivní a můžou fragmentovat paměť.

Pokud potřebujete výpis jednotlivých prvků řetězce v poli, musíte nastavit hloubku kontextu výpisu na hodnotu 1 nebo vyšší.

CString Při odstranění pole nebo při odebrání jeho prvků se uvolní paměť řetězce podle potřeby.

Další informace o použití CStringArraynaleznete v článku Kolekce.

Hierarchie dědičnosti

CObject

CStringArray

Požadavky

Záhlaví: afxcoll.h

Viz také

CObject Třída
Graf hierarchie