Třída CStringArray

Podporuje pole CString objektů.

class CStringArray : public CObject

Členy

Funkce členů z CStringArray jsou podobné funkce členů třídy CObArray.Díky této podobnosti lze použít CObArray referenční dokumentace pro specifikace členské funkce.Narazíte CObject ukazatel vrácenou hodnotu nahradit CString (není CString ukazatel).Narazíte CObject ukazatel jako parametr funkce nahradit LPCTSTR .

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

například překládá do

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

and

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

Převede na

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

Veřejné konstruktory

Název	Description
CObArray::CObArray	Vytvoří prázdné pole.

Veřejné metody

Název	Description
CObArray::Add	Přidá prvek do konce pole; pole roste, pokud je to nutné.
CObArray::Append	Připojí další pole na pole; pole roste, pokud je to nutné.
CObArray::Copy	Další pole zkopíruje do pole; pole roste, pokud je to nutné.
CObArray::ElementAt	Vrátí odkaz dočasné ukazatel prvek uvnitř pole.
CObArray::FreeExtra	Uvolní všechny nevyužité paměti nad aktuální horní mez.
CObArray::GetAt	Vrátí hodnotu v daném indexu.
CObArray::GetCount	Počet prvků získá tohoto pole.
CObArray::GetData	Umožňuje přístup k prvkům matice.Může být NULL.
CObArray::GetSize	Počet prvků získá tohoto pole.
CObArray::GetUpperBound	Vrátí největší platný index.
CObArray::InsertAt	Vloží zadaný index prvku (nebo všechny prvky v jiném poli).
CObArray::IsEmpty	Určuje, zda je pole prázdné.
CObArray::RemoveAll	Odebere všechny prvky z tohoto pole.
CObArray::RemoveAt	Odstraní prvek na určité indexu.
CObArray::SetAt	Nastaví hodnotu pro daný index; pole není povoleno pro růst.
CObArray::SetAtGrow	Nastaví hodnotu pro daný index; pole roste, pokud je to nutné.
CObArray::SetSize	Nastaví počet prvků, které mají být obsaženy v tomto poli.

Veřejné operátory

Název	Description
[CObArray::operator]	Nastaví nebo získá prvku v zadaném indexu.

Poznámky

CStringArrayzahrnuje IMPLEMENT_SERIAL makro pro podporu serializace a jeho prvků dumpingu.Pokud pole CString objektů je uložena do archivu s operátorem přetížené kurzoru nebo se Serialize zase serializována členské funkce jednotlivých prvků.

[!POZNÁMKA]

Před použitím pole, použijte SetSize jeho velikost a přidělit paměť.Pokud nepoužíváte SetSize , přidávání prvků pole způsobí často přerozděleny a zkopírován.Přerozdělení časté kopírování jsou neefektivní a paměti lze rozdělit.

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

Když CString array je odstraněn nebo odebraný prvky řetězec paměť je uvolněna podle potřeby.

Další informace o použití CStringArray , naleznete v článku kolekce.

Hierarchii dědičnosti

CObject

CStringArray

Požadavky

Záhlaví: afxcoll.h

Viz také

Referenční dokumentace

Třída CObject

Diagram hierarchie