Classe de CList

Article
03/26/2013

Prend en charge les listes ordonnées d'objets non uniques accessibles de manière séquentielle ou par valeur.

template< class TYPE, class ARG_TYPE = const TYPE& > 
class CList : public CObject

Membres

Constructeurs publics

Nom	Description
CList::CList	Construit une liste triée vide.

Méthodes publiques

Nom	Description
CList::AddHead	Ajoute un élément (ou tous les autres éléments de liste) au début de la liste (fait une nouvelle tête).
CList::AddTail	Ajoute un élément (ou tous les autres éléments de liste) à la fin de la liste (fait une nouvelle file).
CList::Find	Obtient la position d'un élément spécifié par valeur de pointeur.
CList::FindIndex	Obtient la position d'un élément spécifié par un index de base zéro.
CList::GetAt	Obtient l'élément à une position donnée.
CList::GetCount	Retourne le nombre d'éléments de cette liste.
CList::GetHead	Retourne l'élément head de la liste (ne peut pas être vide).
CList::GetHeadPosition	Retourne la position de l'élément head de la liste.
CList::GetNext	Obtient l'élément pour itérer.
CList::GetPrev	Obtient l'élément précédent pour itérer.
CList::GetSize	Retourne le nombre d'éléments de cette liste.
CList::GetTail	Retourne l'élément de fin de la liste (ne peut pas être vide).
CList::GetTailPosition	Retourne la position de l'élément de fin de la liste.
CList::InsertAfter	Insère un nouvel élément après qu'une position donnée.
CList::InsertBefore	Insère un nouvel élément avant qu'une position donnée.
CList::IsEmpty	Tests pour l'état vide de liste (les éléments).
CList::RemoveAll	Supprime tous les éléments de cette liste.
CList::RemoveAt	Supprime un élément de cette liste, spécifiée par position.
CList::RemoveHead	Supprime l'élément de le début de la liste.
CList::RemoveTail	Supprime l'élément de la fin de la liste.
CList::SetAt	Définit l'élément à une position donnée.

Paramètres

TYPE
Type d'objet stocké dans la liste.
ARG*_*TYPE
Tapez utilisé des objets de référence stockés dans la liste.Peut être une référence.

Notes

Les listes d'CList se comportent comme les deux listes liées.

Une variable de type position est une clé de la liste.Vous pouvez utiliser une variable de position comme itérateur pour parcourir une liste séquentielle et comme signet pour stocker un seul emplacement.Une position n'est pas identique à un index, cependant.

L'implémentation d'élément est très rapidement au début de liste, à la fin, et à position.Une recherche linéaire est nécessaire de rechercher un élément par valeur ou index.Cette recherche peut être lente si la liste est longue.

Si vous avez besoin d'un dump des éléments dans la liste, vous devez définir la profondeur du contexte de dump à 1 ou supérieur.

Certaines fonctions membres de cette classe appelle les fonctions d'assistance globales qui doivent être personnalisées pour la plupart des fonctionnalités de la classe d' CList .Consultez programmes d'assistance de classe de collection dans la section « macros et Globals ».

Pour plus d'informations sur l'utilisation CList, consultez l'article collections.

Exemple

// CList is a template class that takes two template arguments.
// The first argument is type stored internally by the list, the
// second argument is the type used in the arguments for the
// CList methods.

// This code defines a list of ints.
CList<int,int> myIntList;

// This code defines a list of CStrings
CList<CString,CString&> myStringList;

// This code defines a list of MYTYPEs,
// NOTE: MYTYPE could be any struct, class or type definition
CList<MYTYPE,MYTYPE&> myTypeList;