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êteafxcoll.h:

Voir aussi

Exemple MFC COLLECT
CObject Classe
Graphique hiérarchique