Partager via


La classe CStringList

Prend en charge des listes d'objets CString .

Syntaxe

class CStringList : public CObject

Membres

Les fonctions membres de CStringList sont similaires aux fonctions membres de la classe CObList. Ainsi, vous pouvez utiliser la documentation de référence de CObList pour connaître les spécificités des fonctions membres. Où que vous voyiez un CObject pointeur comme une valeur de retour, remplacez un CString (et non un CString pointeur). Où que vous voyiez un CObject pointeur comme paramètre de fonction, remplacez un LPCTSTR.

CObject*& CObList::GetHead() const;

par exemple, se traduit par

CString& CStringList::GetHead() const;

et

POSITION AddHead( CObject* <newElement> );

se traduit par

POSITION AddHead( LPCTSTR <newElement> );

Constructeurs publics

Nom Description
CStringList::CStringList Construit une liste vide.

Méthodes publiques

Nom Description
CStringList::AddHead Ajoute un élément (ou tous les éléments d’une autre liste) à la tête de la liste (fait un nouveau chef).
CStringList::AddTail Ajoute un élément (ou tous les éléments d’une autre liste) à la fin de la liste (fait une nouvelle queue).
CStringList::Find Obtient la position d’un élément spécifié par la valeur du pointeur.
CStringList::FindIndex Obtient la position d’un élément spécifié par un index de base zéro.
CStringList::GetAt Obtient l’élément à une position donnée.
CStringList::GetCount Retourne le nombre d’éléments de cette liste.
CStringList::GetHead Renvoie l’élément principal de la liste (ne peut pas être vide).
CStringList::GetHeadPosition Retourne la position de l’élément principal de la liste.
CStringList::GetNext Obtient l’élément suivant pour itérer.
CStringList::GetPrev Obtient l’élément précédent pour l’itération.
CStringList::GetSize Retourne le nombre d’éléments de cette liste.
CStringList::GetTail Retourne l’élément tail de la liste (ne peut pas être vide).
CStringList::GetTailPosition Retourne la position de l’élément de fin de la liste.
CStringList::InsertAfter Insère un nouvel élément après une position donnée.
CStringList::InsertBefore Insère un nouvel élément avant une position donnée.
CStringList::IsEmpty Teste la condition de liste vide (aucun élément).
CStringList::RemoveAll Supprime tous les éléments de cette liste.
CStringList::RemoveAt Supprime un élément de cette liste, spécifié par position.
CStringList::RemoveHead Supprime l’élément de la tête de la liste.
CStringList::RemoveTail Supprime l’élément de la fin de la liste.
CStringList::SetAt Définit l’élément à une position donnée.

Notes

Toutes les comparaisons sont effectuées par valeur, ce qui signifie que les caractères de la chaîne sont comparés au lieu des adresses des chaînes.

CStringList incorpore la macro IMPLEMENT_SERIAL pour prendre en charge la sérialisation et le vidage de ses éléments. Si une liste d’objets CString est stockée dans une archive, avec un opérateur d’insertion surchargé ou avec la Serialize fonction membre, chaque CString élément est sérialisé à son tour.

Si vous avez besoin d’un vidage d’éléments individuels CString , vous devez définir la profondeur du contexte de vidage sur 1 ou supérieur.

Pour plus d’informations sur l’utilisation CStringList, consultez l’article Collections.

Hiérarchie d'héritage

CObject

CStringList

Spécifications

En-tête : afxcoll.h

Voir aussi

Exemple MFC COLLECT
CObject Classe
Graphique hiérarchique