Partager via


CObList, classe

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

class CObList : public CObject

Membres

Constructeurs publics

Nom

Description

CObList::CObList

Construit une liste vide pour les pointeurs d' CObject .

Méthodes publiques

Nom

Description

CObList::AddHead

Ajoute un élément (ou tous les autres éléments de liste) au début de la liste (fait une nouvelle tête).

CObList::AddTail

Ajoute un élément (ou tous les autres éléments de liste) à la fin de la liste (fait une nouvelle file).

CObList::Find

Obtient la position d'un élément spécifié par valeur de pointeur.

CObList::FindIndex

Obtient la position d'un élément spécifié par un index de base zéro.

CObList::GetAt

Obtient l'élément à une position donnée.

CObList::GetCount

Retourne le nombre d'éléments de cette liste.

CObList::GetHead

Retourne l'élément head de la liste (ne peut pas être vide).

CObList::GetHeadPosition

Retourne la position de l'élément head de la liste.

CObList::GetNext

Obtient l'élément pour itérer.

CObList::GetPrev

Obtient l'élément précédent pour itérer.

CObList::GetSize

Retourne le nombre d'éléments de cette liste.

CObList::GetTail

Retourne l'élément de fin de la liste (ne peut pas être vide).

CObList::GetTailPosition

Retourne la position de l'élément de fin de la liste.

CObList::InsertAfter

Insère un nouvel élément après qu'une position donnée.

CObList::InsertBefore

Insère un nouvel élément avant qu'une position donnée.

CObList::IsEmpty

Tests pour l'état vide de liste (les éléments).

CObList::RemoveAll

Supprime tous les éléments de cette liste.

CObList::RemoveAt

Supprime un élément de cette liste, spécifiée par position.

CObList::RemoveHead

Supprime l'élément de le début de la liste.

CObList::RemoveTail

Supprime l'élément de la fin de la liste.

CObList::SetAt

Définit l'élément à une position donnée.

Notes

Les listes d'CObList 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.

CObList incorpore la macro d' IMPLEMENT_SERIAL pour prendre en charge la sérialisation et faire un dump de ses éléments. Si une liste des pointeurs d' CObject est stockée à une archive, avec un opérateur surchargé d'insertion ou avec la fonction membre d' Serialize , chaque élément d' CObject est sérialisé après.

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

Lorsqu'un objet d' CObList est supprimé, ou lorsque ses éléments sont supprimés, seuls les pointeurs d' CObject sont supprimés, pas les objets qu'ils référencent.

Vous pouvez dériver vos propres classes d' CObList. Votre nouvelle classe de liste, conçue pour contenir les pointeurs vers des objets dérivés d' CObject, ajoute de nouvelles données membres et nouvelles fonctions membres. Notez que la liste résultante n'est pas strictement type sécurisé, car elle permet l'implémentation de n'importe quel pointeur d' CObject .

Notes

Vous devez utiliser la macro d' IMPLEMENT_SERIAL dans l'implémentation de votre classe dérivée si vous avez l'intention de sérialiser la liste.

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

Hiérarchie d'héritage

CObject

CObList

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

CObject, classe

Graphique de la hiérarchie

CStringList, classe

CPtrList, classe