CPtrArray osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Támogatja az üres mutatótömböket.

Szemantika

class CPtrArray : public CObject

Tagok

A tagfüggvények CPtrArray hasonlóak a CObArray osztály tagfüggvényeihez. A hasonlóság miatt a CObArray tagfüggvény-specifikus referenciadokumentációt használhatja. Ha egy mutatót CObject függvényparaméterként vagy visszatérési értékként lát, cserélje le a mutatót a következőre void:

CObject* CObArray::GetAt( int <nIndex> ) const;

például lefordítja a következőre:

void* CPtrArray::GetAt( int <nIndex> ) const;

Nyilvános konstruktorok

Név	Description
CPtrArray::CPtrArray	Üres tömböt hoz létre.

Nyilvános metódusok

Név	Description
CPtrArray::Hozzáadás	Hozzáad egy elemet a tömb végéhez; szükség esetén növeli a tömböt.
CPtrArray::Append	Egy másik tömb hozzáfűzése a tömbhöz; szükség esetén növeli a tömböt.
CPtrArray::Copy	Másik tömb másolása a tömbbe; szükség esetén növeli a tömböt.
CPtrArray::ElementAt	A tömbön belüli elemmutatóra mutató ideiglenes hivatkozást ad vissza.
CPtrArray::FreeExtra	Felszabadítja az összes fel nem használt memóriát az aktuális felső határ felett.
CPtrArray::GetAt	Egy adott index értékét adja vissza.
CPtrArray::GetCount	Lekéri a tömb elemeinek számát.
CPtrArray::GetData	Lehetővé teszi a tömb elemeinek elérését. Lehet NULL.
CPtrArray::GetSize	Lekéri a tömb elemeinek számát.
CPtrArray::GetUpperBound	A legnagyobb érvényes indexet adja vissza.
CPtrArray::InsertAt	Egy elemet (vagy egy másik tömb összes elemét) szúr be egy adott indexbe.
CPtrArray::IsEmpty	Meghatározza, hogy a tömb üres-e.
CPtrArray::RemoveAll	Eltávolítja az összes elemet ebből a tömbből.
CPtrArray::RemoveAt	Eltávolít egy elemet egy adott indexből.
CPtrArray::SetAt	Egy adott index értékét állítja be; tömb nem növekedhet.
CPtrArray::SetAtGrow	Egy adott index értékét állítja be; szükség esetén növeli a tömböt.
CPtrArray::SetSize	Beállítja a tömbben található elemek számát.

Nyilvános operátorok

Név	Description
CPtrArray::operátor [ ]	Beállítja vagy lekéri az elemet a megadott indexen.

Megjegyzések

CPtrArray A IMPLEMENT_DYNAMIC makrót tartalmazza az objektum futásidejű hozzáférésének és memóriaképének támogatásához CDumpContext . Ha a mutatótömb egyes elemeinek memóriaképére van szüksége, a memóriakép-környezet mélységét 1 vagy nagyobbra kell állítania.

Megjegyzés:

A tömb használata előtt állítsa SetSize be a méretét, és foglaljon le memóriát. Ha nem használ SetSizeelemeket a tömbhöz, az gyakran újraelosztást és másolást okoz. A gyakori újratelepítés és másolás nem hatékony, és töredezett memóriát okozhat.

A mutatótömbök nem szerializálhatók.

A mutatótömb törlésekor vagy elemeinek eltávolításakor csak a mutatókat távolítja el, a hivatkozott entitásokat nem.

A használatról CPtrArraytovábbi információt a Gyűjtemények című cikkben talál.

Öröklési hierarchia

CObject

CPtrArray

Requirements

Fejléc: afxcoll.h

Lásd még

CObject osztály
hierarchiadiagram
CObArray osztály