CPtrArray-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Ondersteunt matrices van ongeldige aanwijzers.

Syntaxis

class CPtrArray : public CObject

Leden

De lidfuncties zijn CPtrArray vergelijkbaar met de lidfuncties van klasse CObArray. Vanwege deze overeenkomst kunt u de CObArray referentiedocumentatie gebruiken voor specifieke informatie over ledenfuncties. Waar u een CObject aanwijzer ziet als functieparameter of retourwaarde, vervangt u een aanwijzer in void.

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

bijvoorbeeld wordt omgezet in

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

Openbare constructors

Naam	Description
CPtrArray::CPtrArray	Maakt een lege matrix.

Openbare methoden

Naam	Description
CPtrArray::Add	Voegt een element toe aan het einde van de matrix; groeit de matrix indien nodig.
CPtrArray::Append	Voegt een andere matrix toe aan de matrix; groeit de matrix indien nodig.
CPtrArray::Copy	Kopieert een andere matrix naar de matrix; groeit de matrix indien nodig.
CPtrArray::ElementAt	Retourneert een tijdelijke verwijzing naar de elementpointer in de matrix.
CPtrArray::FreeExtra	Hiermee wordt al het ongebruikte geheugen boven de huidige bovengrens vrijgemaakt.
CPtrArray::GetAt	Retourneert de waarde in een bepaalde index.
CPtrArray::GetCount	Hiermee haalt u het aantal elementen in deze matrix op.
CPtrArray::GetData	Hiermee heeft u toegang tot elementen in de matrix. Kan zijn NULL.
CPtrArray::GetSize	Hiermee haalt u het aantal elementen in deze matrix op.
CPtrArray::GetUpperBound	Retourneert de grootste geldige index.
CPtrArray::InsertAt	Hiermee voegt u een element (of alle elementen in een andere matrix) in een opgegeven index in.
CPtrArray::IsEmpty	Bepaalt of de matrix leeg is.
CPtrArray::RemoveAll	Hiermee verwijdert u alle elementen uit deze matrix.
CPtrArray::RemoveAt	Hiermee verwijdert u een element in een specifieke index.
CPtrArray::SetAt	Hiermee stelt u de waarde voor een bepaalde index in; matrix mag niet groeien.
CPtrArray::SetAtGrow	Hiermee stelt u de waarde voor een bepaalde index in; groeit de matrix indien nodig.
CPtrArray::SetSize	Hiermee stelt u het aantal elementen in dat in deze matrix moet worden opgenomen.

Openbare operators

Naam	Description
CPtrArray::operator [ ]	Hiermee stelt u het element in of haalt u het op in de opgegeven index.

Opmerkingen

CPtrArray bevat de IMPLEMENT_DYNAMIC macro ter ondersteuning van runtime-toegang en dumping voor een CDumpContext object. Als u een dump van afzonderlijke aanwijzermatrixelementen nodig hebt, moet u de diepte van de dumpcontext instellen op 1 of hoger.

Opmerking

Voordat u een matrix gebruikt, gebruikt SetSize u deze om de grootte ervan vast te stellen en geheugen toe te wijzen. Als u dit niet doet SetSize, zorgt het toevoegen van elementen aan uw matrix ervoor dat deze vaak opnieuw wordt toegewezen en gekopieerd. Frequente herlocatie en kopiëren zijn inefficiënt en kunnen geheugenfragmenteren.

Aanwijzermatrices kunnen niet worden geserialiseerd.

Wanneer een aanwijzermatrix wordt verwijderd of wanneer de elementen ervan worden verwijderd, worden alleen de aanwijzers verwijderd, niet de entiteiten waarnaar ze verwijzen.

Zie het artikel Verzamelingen voor meer informatie over het gebruikCPtrArray.

Overnamehiërarchie

CObject

CPtrArray

Requirements

Koptekst: afxcoll.h

Zie ook

CObject-klasse
Hiërarchiegrafiek
CObArray-klasse