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
CStringList
Spécifications
En-tête : afxcoll.h