CStringArray Class

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Prend en charge les tableaux de CString objets.

class CStringArray : public CObject  

Les fonctions membres de CStringArray sont similaires aux fonctions membres de classe CObArray. Ainsi, vous pouvez utiliser la documentation de référence de CObArray pour connaître les spécificités des fonctions membres. Chaque fois que vous voyez un CObject pointeur en tant que valeur de retour, remplacez un CString objet (pas 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

CString CStringArray::GetAt( int <nIndex> ) const;

et

void SetAt( int <nIndex>, CObject* <newElement> )

se traduit par

void SetAt( int <nIndex>, LPCTSTR <newElement> )

Constructeurs publics

NomDescription
CObArray::CObArrayConstruit un tableau vide.

Méthodes publiques

NomDescription
CObArray::AddAjoute un élément à la fin du tableau ; étend le tableau si nécessaire.
CObArray::AppendAjoute un autre tableau au tableau ; étend le tableau si nécessaire.
CObArray::CopyCopie un autre tableau dans le tableau ; étend le tableau si nécessaire.
CObArray::ElementAtRetourne une référence temporaire au pointeur d'élément dans le tableau.
CObArray::FreeExtraLibère toute la mémoire inutilisée au-dessus de la limite supérieure actuelle.
CObArray::GetAtRetourne la valeur à un index donné.
CObArray::GetCountObtient le nombre d'éléments dans ce tableau.
CObArray::GetDataAutorise l'accès aux éléments du tableau. Peut être NULL.
CObArray::GetSizeObtient le nombre d'éléments dans ce tableau.
CObArray::GetUpperBoundRetourne le plus grand index valide.
CObArray::InsertAtInsère un élément (ou tous les éléments d'un autre tableau) à un index spécifique.
CObArray::IsEmptyDétermine si le tableau est vide.
CObArray::RemoveAllSupprime tous les éléments de ce tableau.
CObArray::RemoveAtSupprime un élément à un index spécifique.
CObArray::SetAtDéfinit la valeur d'un index donné. Le tableau n'est pas autorisé à s'étendre.
CObArray::SetAtGrowDéfinit la valeur d'un index donné. Le tableau est étendu si nécessaire.
CObArray::SetSizeDéfinit le nombre d'éléments que ce tableau doit contenir.

Opérateurs publics

NomDescription
[] CObArray::operatorDéfinit ou obtient l'élément au niveau de l'index spécifié.

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.

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

CObject

CStringArray

En-tête : afxcoll.h

CObject (classe)
Graphique de la hiérarchie

Afficher: