La classe CStringArray
Prend en charge des tableaux d'objets CString .
Syntaxe
class CStringArray : public CObject
Membres
Les fonctions membres de CStringArray sont similaires aux fonctions membres de la classe CObArray. Ainsi, vous pouvez utiliser la documentation de référence de CObArray pour connaître les spécificités des fonctions membres. Où que vous voyiez un CObject pointeur comme valeur de retour, remplacez un CString objet (et non un CString pointeur). Partout où vous voyez un pointeur CObject en tant que paramètre de fonction, remplacez LPCTSTR.
CObject* CObArray::GetAt( int <nIndex> ) const;
par exemple, se traduit par
const CString& CStringArray::GetAt( int <nIndex> ) const;
et
void SetAt( int <nIndex>, CObject* <newElement> )
se traduit par
void SetAt( int <nIndex>, LPCTSTR <newElement> )
Constructeurs publics
| Nom | Description |
|---|---|
CStringArray::CStringArray |
Construit un tableau vide. |
Méthodes publiques
| Nom | Description |
|---|---|
CStringArray::Add |
Ajoute un élément à la fin du tableau ; étend le tableau si nécessaire. |
CStringArray::Append |
Ajoute un autre tableau au tableau ; étend le tableau si nécessaire. |
CStringArray::Copy |
Copie un autre tableau dans le tableau ; étend le tableau si nécessaire. |
CStringArray::ElementAt |
Retourne une référence temporaire au pointeur d'élément dans le tableau. |
CStringArray::FreeExtra |
Libère toute la mémoire inutilisée au-dessus de la limite supérieure actuelle. |
CStringArray::GetAt |
Retourne la valeur à un index donné. |
CStringArray::GetCount |
Obtient le nombre d'éléments dans ce tableau. |
CStringArray::GetData |
Autorise l'accès aux éléments du tableau. Peut être NULL. |
CStringArray::GetSize |
Obtient le nombre d'éléments dans ce tableau. |
CStringArray::GetUpperBound |
Retourne le plus grand index valide. |
CStringArray::InsertAt |
Insère un élément (ou tous les éléments d'un autre tableau) à un index spécifique. |
CStringArray::IsEmpty |
Détermine si le tableau est vide. |
CStringArray::RemoveAll |
Supprime tous les éléments de ce tableau. |
CStringArray::RemoveAt |
Supprime un élément à un index spécifique. |
CStringArray::SetAt |
Définit la valeur d'un index donné. Le tableau n'est pas autorisé à s'étendre. |
CStringArray::SetAtGrow |
Définit la valeur d'un index donné. Le tableau est étendu si nécessaire. |
CStringArray::SetSize |
Définit le nombre d'éléments que ce tableau doit contenir. |
Opérateurs publics
| Nom | Description |
|---|---|
CStringArray::operator [ ] |
Définit ou obtient l'élément au niveau de l'index spécifié. |
Notes
CStringArray incorpore la macro IMPLEMENT_SERIAL pour prendre en charge la sérialisation et le vidage de ses éléments. Si un tableau d'objets CString est stocké dans une archive, soit avec un opérateur d'insertion surchargé, soit avec la fonction membre Serialize, chaque élément est sérialisé l'un après l'autre.
Remarque
Avant d'utiliser un tableau, utilisez SetSize pour définir sa taille et lui allouer la mémoire nécessaire. Si vous n'utilisez pas SetSize, l'ajout d'éléments à votre tableau risque d'entraîner de fréquentes opérations de réallocation et de copie de ce dernier. Les opérations fréquentes de réallocation et de copie sont inefficaces et peuvent fragmenter la mémoire.
Si vous avez besoin de vider des éléments de chaîne individuels dans le tableau, vous devez définir la profondeur du contexte de vidage à 1 ou plus.
Quand un tableau CString est supprimé, ou quand ses éléments sont retirés, la mémoire relative aux chaînes est libérée en fonction des besoins.
Pour plus d’informations sur l’utilisation CStringArray, consultez l’article Collections.
Hiérarchie d'héritage
CStringArray
Spécifications
En-tête : afxcoll.h