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