CPtrArray – třída
Podporuje pole ukazatelů void.
Syntaxe
class CPtrArray : public CObject
Členové
Členské funkce jsou podobné členské funkce CPtrArray 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 ukazatelem void.
CObject* CObArray::GetAt( int <nIndex> ) const;
Například se přeloží na
void* CPtrArray::GetAt( int <nIndex> ) const;
Veřejné konstruktory
| Název | Popis |
|---|---|
| CPtrArray::CPtrArray | Vytvoří prázdné pole. |
Veřejné metody
| Název | Popis |
|---|---|
| CPtrArray::Add | Přidá prvek na konec pole; v případě potřeby pole zvětšuje. |
| CPtrArray::Append | Připojí k matici další pole; v případě potřeby pole zvětšuje. |
| CPtrArray::Copy | Zkopíruje další pole do pole; v případě potřeby pole zvětšuje. |
| CPtrArray::ElementAt | Vrátí dočasný odkaz na ukazatel prvku v rámci pole. |
| CPtrArray::FreeExtra | Uvolní veškerou nevyužitou paměť nad aktuální horní mez. |
| CPtrArray::GetAt | Vrátí hodnotu v daném indexu. |
| CPtrArray::GetCount | Získá počet prvků v tomto poli. |
| CPtrArray::GetData | Umožňuje přístup k prvkům v poli. Může to být NULL. |
| CPtrArray::GetSize | Získá počet prvků v tomto poli. |
| CPtrArray::GetUpperBound | Vrátí největší platný index. |
| CPtrArray::InsertAt | Vloží prvek (nebo všechny prvky v jiném poli) do zadaného indexu. |
| CPtrArray::IsEmpty | Určuje, zda je pole prázdné. |
| CPtrArray::RemoveAll | Odebere všechny prvky z tohoto pole. |
| CPtrArray::RemoveAt | Odebere prvek v určitém indexu. |
| CPtrArray::SetAt | Nastaví hodnotu pro daný index; pole nelze zvětšit. |
| CPtrArray::SetAtGrow | Nastaví hodnotu pro daný index; v případě potřeby pole zvětšuje. |
| CPtrArray::SetSize | Nastaví počet prvků, které mají být obsaženy v tomto poli. |
Veřejné operátory
| Název | Popis |
|---|---|
| CPtrArray::operator [ ] | Nastaví nebo získá prvek v zadaném indexu. |
Poznámky
CPtrArray zahrnuje makro IMPLEMENT_DYNAMIC pro podporu přístupu k typu za běhu a výpisu do objektu CDumpContext . Pokud potřebujete výpis jednotlivých prvků pole ukazatelů, musíte nastavit hloubku kontextu výpisu na hodnotu 1 nebo vyšší.
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ěť.
Pole ukazatelů nelze serializovat.
Když je pole ukazatele odstraněno nebo když jsou jeho prvky odebrány, odeberou se pouze ukazatele, nikoli entity, na které odkazují.
Další informace o použití CPtrArraynaleznete v článku Kolekce.
Hierarchie dědičnosti
CPtrArray
Požadavky
Hlavička: afxcoll.h