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

Objekt CObject

CPtrArray

Požadavky

Hlavička: afxcoll.h

Viz také

CObject – třída
Graf hierarchie
CObArray – třída