CStringList-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 lijsten met CString objecten.

Syntaxis

class CStringList : public CObject

Leden

De lidfuncties zijn CStringList vergelijkbaar met de lidfuncties van klasse CObList. Vanwege deze overeenkomst kunt u de CObList referentiedocumentatie gebruiken voor specifieke informatie over ledenfuncties. Waar u een CObject aanwijzer ziet als een retourwaarde, vervangt u een CString (geen CString aanwijzer). Waar u een CObject aanwijzer ziet als een functieparameter, vervangt u een LPCTSTR.

CObject*& CObList::GetHead() const;

bijvoorbeeld wordt omgezet in

CString& CStringList::GetHead() const;

en

POSITION AddHead( CObject* <newElement> );

wordt omgezet in

POSITION AddHead( LPCTSTR <newElement> );

Openbare constructors

Naam	Description
CStringList::CStringList	Hiermee wordt een lege lijst gemaakt.

Openbare methoden

Naam	Description
CStringList::AddHead	Voegt een element (of alle elementen in een andere lijst) toe aan het hoofd van de lijst (maakt een nieuw hoofd).
CStringList::AddTail	Voegt een element (of alle elementen in een andere lijst) toe aan de staart van de lijst (maakt een nieuwe staart).
CStringList::Find	Hiermee haalt u de positie op van een element dat is opgegeven door de aanwijzerwaarde.
CStringList::FindIndex	Hiermee haalt u de positie op van een element dat is opgegeven door een index op basis van nul.
CStringList::GetAt	Hiermee haalt u het element op een bepaalde positie op.
CStringList::GetCount	Retourneert het aantal elementen in deze lijst.
CStringList::GetHead	Retourneert het hoofdelement van de lijst (mag niet leeg zijn).
CStringList::GetHeadPosition	Retourneert de positie van het hoofdelement van de lijst.
CStringList::GetNext	Hiermee haalt u het volgende element op voor het herhalen.
CStringList::GetPrev	Hiermee haalt u het vorige element op voor het herhalen.
CStringList::GetSize	Retourneert het aantal elementen in deze lijst.
CStringList::GetTail	Retourneert het staartelement van de lijst (kan niet leeg zijn).
CStringList::GetTailPosition	Retourneert de positie van het staartelement van de lijst.
CStringList::InsertAfter	Hiermee voegt u een nieuw element in na een bepaalde positie.
CStringList::InsertBefore	Hiermee voegt u een nieuw element in vóór een bepaalde positie.
CStringList::IsEmpty	Hiermee wordt getest op de voorwaarde voor een lege lijst (geen elementen).
CStringList::RemoveAll	Hiermee verwijdert u alle elementen uit deze lijst.
CStringList::RemoveAt	Hiermee verwijdert u een element uit deze lijst, opgegeven op positie.
CStringList::RemoveHead	Hiermee verwijdert u het element uit de kop van de lijst.
CStringList::RemoveTail	Hiermee verwijdert u het element uit de staart van de lijst.
CStringList::SetAt	Hiermee stelt u het element op een bepaalde positie in.

Opmerkingen

Alle vergelijkingen worden uitgevoerd op waarde, wat betekent dat de tekens in de tekenreeks worden vergeleken in plaats van de adressen van de tekenreeksen.

CStringList bevat de IMPLEMENT_SERIAL macro ter ondersteuning van serialisatie en dumping van de elementen. Als een lijst met CString objecten wordt opgeslagen in een archief, ofwel met een overbelaste invoegoperator of met de Serialize lidfunctie, wordt elk CString element op zijn beurt geserialiseerd.

Als u een dump van afzonderlijke CString elementen nodig hebt, moet u de diepte van de dumpcontext instellen op 1 of hoger.

Zie het artikel Verzamelingen voor meer informatie over het gebruikCStringList.

Overnamehiërarchie

CObject

CStringList

Requirements

Rubriek:afxcoll.h

Zie ook

MFC-voorbeeld COLLECT
CObject klasse
Hiërarchiegrafiek