CObList, classe

Article
06/10/2015

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.