Třída CStringArray

Podporuje pole CString objekty.

class CStringArray : public CObject

Členy

Funkce člena CStringArray jsou podobné funkce člena třídy CObArray.Z důvodu této podobnosti, můžete použít CObArray referenční dokumentace pro specifické funkce člena.Všude, kde naleznete CObject ukazatel jako návratová hodnota nahradit CString objektu (není CString ukazatel myši).Všude, kde naleznete CObject ukazatel jako parametr funkce nahradit LPCTSTR.

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

Můžete 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

Name	Popis
CObArray::CObArray	Vytvoří prázdné pole.

Veřejné metody

Name	Popis
CObArray::Add	Přidá element do konce pole; pole zvětšuje, pokud je to nutné.
CObArray::Append	Připojí dalšího pole k poli; pole zvětšuje, pokud je to nutné.
CObArray::Copy	Zkopíruje dalšího pole do pole; pole zvětšuje, pokud je to nutné.
CObArray::ElementAt	Vrátí dočasný odkaz na element ukazatele v poli.
CObArray::FreeExtra	Uvolní všechny nepoužívané paměť nad aktuální horní mez.
CObArray::GetAt	Vrátí hodnotu daným indexem.
CObArray::GetCount	Získá počet elementů do tohoto pole.
CObArray::GetData	Umožňuje přístup k elementům v poli.Může být NULL.
CObArray::GetSize	Získá počet elementů do tohoto pole.
CObArray::GetUpperBound	Vrátí největší neplatný index.
CObArray::InsertAt	Vloží na zadaný index elementu (nebo všechny elementy v jiné pole).
CObArray::IsEmpty	Určuje, zda pole je prázdné.
CObArray::RemoveAll	Odebere všechny elementy z tohoto pole.
CObArray::RemoveAt	Odebere element na konkrétním indexu.
CObArray::SetAt	Nastaví hodnotu pro daným indexem; pole není povoleno k rozvoji.
CObArray::SetAtGrow	Nastaví hodnotu pro daným indexem; pole zvětšuje, pokud je to nutné.
CObArray::SetSize	Nastaví počet prvků, které mají být obsaženy v toto pole.

Veřejné operátory

Name	Popis
[CObArray::operator]	Nastavuje nebo získá prvek se zadaným indexem.

Poznámky

CStringArrayzahrnuje IMPLEMENT_SERIAL makra pro podporu serializace a ukládání jejích elementů.Pokud pole CString objektů je uložena do archivu, a to buď přetížených vložení operátor nebo s Serialize zase serializován členské funkce, každý element.

[!POZNÁMKA]

Před použitím pole, použijte SetSize k vytvoření jeho velikost a přidělit paměť pro něj.Pokud je velmi riskantní používat SetSize, přidávání elementů do pole způsobuje, že často znovu přidělit a zkopírovat.Časté rozdělení a kopírování jsou neefektivní a můžete fragmentu paměti.

Pokud potřebujete výpis řetězec jednotlivých prvků v poli, je nutné nastavit hloubku kontext výpisu na 1 nebo větší.

Když CString pole, odstraněn nebo při jeho prvky budou odebrány, je uvolnit paměť řetězec podle potřeby.

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

Hierarchie dědičnosti

CObject

CStringArray

Požadavky

Záhlaví: afxcoll.h

Viz také

Referenční dokumentace

Třída CObject

Graf hierarchie