CWordArray – třída
Podporuje pole 16bitových slov.
Syntaxe
class CWordArray : public CObject
Členové
Členské funkce jsou podobné členské funkce CWordArray třídy CObArray. Vzhledem k této podobnosti můžete použít CObArray referenční dokumentaci pro specifika členské funkce. Kdykoli uvidíte ukazatel CObject jako parametr funkce nebo návratovou hodnotu, nahraďte WORD.
CObject* CObArray::GetAt( int <nIndex> ) const;
Například se přeloží na
WORD CWordArray::GetAt( int <nIndex> ) const;
Veřejné konstruktory
| Název | Popis |
|---|---|
| CWordArray::CWordArray | Vytvoří prázdné pole. |
Veřejné metody
| Název | Popis |
|---|---|
| CWordArray::Add | Přidá prvek na konec pole; v případě potřeby pole zvětšuje. |
| CWordArray::Append | Připojí k matici další pole; v případě potřeby pole zvětšuje. |
| CWordArray::Copy | Zkopíruje další pole do pole; v případě potřeby pole zvětšuje. |
| CWordArray::ElementAt | Vrátí dočasný odkaz na ukazatel prvku v rámci pole. |
| CWordArray::FreeExtra | Uvolní veškerou nevyužitou paměť nad aktuální horní mez. |
| CWordArray::GetAt | Vrátí hodnotu v daném indexu. |
| CWordArray::GetCount | Získá počet prvků v tomto poli. |
| CWordArray::GetData | Umožňuje přístup k prvkům v poli. Může mít hodnotu NULL. |
| CWordArray::GetSize | Získá počet prvků v tomto poli. |
| CWordArray::GetUpperBound | Vrátí největší platný index. |
| CWordArray::InsertAt | Vloží prvek (nebo všechny prvky v jiném poli) do zadaného indexu. |
| CWordArray::IsEmpty | Určuje, zda je pole prázdné. |
| CWordArray::RemoveAll | Odebere všechny prvky z tohoto pole. |
| CWordArray::RemoveAt | Odebere prvek v určitém indexu. |
| CWordArray::SetAt | Nastaví hodnotu pro daný index; pole nelze zvětšit. |
| CWordArray::SetAtGrow | Nastaví hodnotu pro daný index; v případě potřeby pole zvětšuje. |
| CWordArray::SetSize | Nastaví počet prvků, které mají být obsaženy v tomto poli. |
Veřejné operátory
| Název | Popis |
|---|---|
CWordArray::operator[] |
Nastaví nebo získá prvek v zadaném indexu. |
Poznámky
CWordArrayzahrnuje IMPLEMENT_SERIAL makro pro podporu serializace a dumpingu jeho prvků. Pokud je pole slov uloženo v archivu, buď s přetíženým operátorem vložení, nebo pomocí členské funkce CObject::Serialize , je každý prvek serializován.
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ů v poli, musíte nastavit hloubku kontextu výpisu na hodnotu 1 nebo vyšší.
Další informace o použití CWordArraynaleznete v článku Kolekce.
Hierarchie dědičnosti
CWordArray
Požadavky
Hlavička: afxcoll.h