Classe de CStringArray

Article
03/04/2013

Prend en charge des tableaux d'objets d' CString .

class CStringArray : public CObject

Membres

Les fonctions membres d' CStringArray sont semblables aux fonctions membres de la classe CObArray.En raison de cette ressemblance, vous pouvez utiliser la documentation de référence des CObArray pour les détails de la fonction membre.Partout où vous consultez un pointeur d' CObject comme valeur de retour, substituez CString (pas un pointeur d' CString ).Partout où vous consultez un pointeur d' CObject comme paramètre de fonction, substituez LPCTSTR.

CObject* CObArray::GetAt( int <nIndex> ) const;

par exemple, traduit la valeur

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

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

convertit la valeur

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

Constructeurs publics

Nom	Description
CObArray::CObArray	Construit un tableau vide.

Méthodes publiques

Nom	Description
CObArray::Add	Ajoute un élément à la fin du tableau ; élève le tableau si nécessaire.
CObArray::Append	Ajoute un autre tableau au tableau ; élève le tableau si nécessaire.
CObArray::Copy	Copie une autre tableau au tableau ; élève 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 non utilisé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	Permet l'accès aux éléments du tableau.Peut être 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 les éléments dans un autre tableau) à un index spécifié.
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 pour un index donné ; tableau non - autorisée pour développer.
CObArray::SetAtGrow	Définit la valeur pour un index donné ; élève le tableau si nécessaire.
CObArray::SetSize	Définit le nombre d'éléments à inclure dans ce tableau.

Opérateurs publics

Nom	Description
CObArray::operator []	Définit ou obtient l'élément à l'index spécifié.

Notes

CStringArray incorpore la macro d' IMPLEMENT_SERIAL pour prendre en charge la sérialisation et faire un dump de ses éléments.Si un tableau d'objets d' CString est stocké dans une archive, avec un opérateur surchargé d'insertion ou avec la fonction membre d' Serialize , chaque élément est sérialisé après.

[!REMARQUE]

Avant d'utiliser d'un tableau, utilisez SetSize pour générer sa taille et pour allouer de la mémoire pour celui-ci.Si vous n'utilisez pas SetSize, ajouter des éléments à la matrice la cause d'être souvent réaffectée et copiée.La réallocation et la copie fréquentes sont inefficaces et peuvent réduire la mémoire en fragments.

Si vous avez besoin d'un dump des éléments de chaîne du tableau, vous devez définir la profondeur du contexte de dump à 1 ou supérieur.

Lorsqu'un tableau d' CString est supprimé, ou lorsque ses éléments sont supprimés, la mémoire de chaîne est libérée selon les besoins.

Pour plus d'informations sur l'utilisation CStringArray, consultez l'article collections.

Hiérarchie d'héritage

CObject

CStringArray

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

Classe de CObject

Graphique de la hiérarchie

Partager via