Partager via


CList, classe

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;

Hiérarchie d'héritage

CObject

CList

Configuration requise

Header: afxtempl.h

Voir aussi

Référence

CObject, classe

Graphique de la hiérarchie

CMap, classe

CArray, classe

Concepts

L'exemple MFC COLLECTENT