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