CStringArray-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 CString objecten.

Syntaxis

class CStringArray : public CObject

Leden

De lidfuncties zijn CStringArray 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 als retourwaarde ziet, vervangt u een CString object (geen CString aanwijzer). Waar u een CObject aanwijzer ziet als een functieparameter, vervangt u een LPCTSTR.

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

bijvoorbeeld wordt omgezet in

const CString& CStringArray::GetAt( int <nIndex> ) const;

en

void SetAt( int <nIndex>, CObject* <newElement> )

wordt omgezet in

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Openbare constructors

Naam	Description
CStringArray::CStringArray	Maakt een lege matrix.

Openbare methoden

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

Openbare operators

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

Opmerkingen

CStringArray bevat de IMPLEMENT_SERIAL macro ter ondersteuning van serialisatie en dumping van de elementen. Als een matrix van CString objecten wordt opgeslagen in een archief, ofwel met een overbelaste invoegoperator 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 een dump van afzonderlijke tekenreekselementen in de matrix nodig hebt, moet u de diepte van de dumpcontext instellen op 1 of hoger.

Wanneer een CString matrix wordt verwijderd of wanneer de elementen ervan worden verwijderd, wordt het geheugen van de tekenreeks naar wens vrijgemaakt.

Zie het artikel Verzamelingen voor meer informatie over het gebruikCStringArray.

Overnamehiërarchie

CObject

CStringArray

Requirements

Rubriek:afxcoll.h

Zie ook

CObject klasse
Hiërarchiegrafiek