Klasse CByteArray

Opmerking

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

Ondersteunt dynamische matrices van bytes.

Syntaxis

class CByteArray : public CObject

Leden

De lidfuncties zijn CByteArray 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 BYTE.

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

bijvoorbeeld wordt omgezet in

BYTE CByteArray::GetAt( int <nIndex> ) const;

Openbare constructors

Naam	Description
CByteArray::CByteArray	Maakt een lege matrix.

Openbare methoden

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

Openbare operators

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

Opmerkingen

CByteArray bevat de IMPLEMENT_SERIAL macro ter ondersteuning van serialisatie en dumping van de elementen. Als een matrix van bytes wordt opgeslagen in een archief, ofwel met de operator voor overbelaste invoeging ( <<) of met de Serialize lidfunctie, wordt elk element op zijn beurt geserialiseerd.

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.

Als u foutopsporingsuitvoer van afzonderlijke elementen in de matrix nodig hebt, moet u de diepte van het CDumpContext object instellen op 1 of hoger.

Zie het artikel Verzamelingen voor meer informatie over het gebruikCByteArray.

Overnamehiërarchie

CObject

CByteArray

Requirements

Koptekst: afxcoll.h

Zie ook

CObject-klasse
Hiërarchiegrafiek
CObArray-klasse