Partager via

CStringArray, classe

  • Article

Prend en charge les tableaux d'objets CString.

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. Partout où vous voyez un pointeur CObject en tant que valeur de retour, remplacez un objet CString (pas un pointeur CString). 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

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

CObArray::CObArray

Construit un tableau vide.

M&#233;thodes publiques

Nom

Description

CObArray::Add

Ajoute un élément à la fin du tableau ; étend le tableau si nécessaire.

CObArray::Append

Ajoute un autre tableau au tableau ; étend le tableau si nécessaire.

CObArray::Copy

Copie un autre tableau dans le tableau ; étend le tableau si nécessaire.

CObArray::ElementAt

Retourne une référence temporaire au pointeur d'élément dans le tableau.

CObArray::FreeExtra

Libère toute la mémoire inutilisée au-dessus de la limite supérieure actuelle.

CObArray::GetAt

Retourne la valeur à un index donné.

CObArray::GetCount

Obtient le nombre d'éléments dans ce tableau.

CObArray::GetData

Autorise l'accès aux éléments du tableau. Peut avoir la valeur NULL.

CObArray::GetSize

Obtient le nombre d'éléments dans ce tableau.

CObArray::GetUpperBound

Retourne le plus grand index valide.

CObArray::InsertAt

Insère un élément (ou tous les éléments d'un autre tableau) à un index spécifique.

CObArray::IsEmpty

Détermine si le tableau est vide.

CObArray::RemoveAll

Supprime tous les éléments de ce tableau.

CObArray::RemoveAt

Supprime un élément à un index spécifique.

CObArray::SetAt

Définit la valeur d'un index donné. Le tableau n'est pas autorisé à s'étendre.

CObArray::SetAtGrow

Définit la valeur d'un index donné. Le tableau est étendu si nécessaire.

CObArray::SetSize

Définit le nombre d'éléments que ce tableau doit contenir.

Op&#233;rateurs publics

Nom

Description

CObArray::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.

Notes

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 de CStringArray, consultez l'article Collections.

Hiérarchie d'héritage

CObject

CStringArray

Configuration requise

En-tête : afxcoll.h

Voir aussi

Référence

CObject, classe

Graphique de la hiérarchie