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
CStringArray
Požadavky
Záhlaví: afxcoll.h