Lire en anglais

Partager via


CPtrArray, classe

Prend en charge des tableaux de pointeurs void.

Syntaxe

class CPtrArray : public CObject

Membres

Les fonctions membres de CPtrArray 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 en tant que paramètre de fonction ou valeur de retour, remplacez un pointeur par void.

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

par exemple, se traduit par

void* CPtrArray::GetAt( int <nIndex> ) const;

Constructeurs publics

Nom Description
CPtrArray ::CPtrArray Construit un tableau vide.

Méthodes publiques

Nom Description
CPtrArray ::Add Ajoute un élément à la fin du tableau ; étend le tableau si nécessaire.
CPtrArray ::Append Ajoute un autre tableau au tableau ; étend le tableau si nécessaire.
CPtrArray ::Copy Copie un autre tableau dans le tableau ; étend le tableau si nécessaire.
CPtrArray ::ElementAt Retourne une référence temporaire au pointeur d'élément dans le tableau.
CPtrArray ::FreeExtra Libère toute la mémoire inutilisée au-dessus de la limite supérieure actuelle.
CPtrArray ::GetAt Retourne la valeur à un index donné.
CPtrArray ::GetCount Obtient le nombre d'éléments dans ce tableau.
CPtrArray ::GetData Autorise l'accès aux éléments du tableau. Peut être NULL.
CPtrArray ::GetSize Obtient le nombre d'éléments dans ce tableau.
CPtrArray ::GetUpperBound Retourne le plus grand index valide.
CPtrArray ::InsertAt Insère un élément (ou tous les éléments d'un autre tableau) à un index spécifique.
CPtrArray ::IsEmpty Détermine si le tableau est vide.
CPtrArray ::RemoveAll Supprime tous les éléments de ce tableau.
CPtrArray ::RemoveAt Supprime un élément à un index spécifique.
CPtrArray ::SetAt Définit la valeur d'un index donné. Le tableau n'est pas autorisé à s'étendre.
CPtrArray ::SetAtGrow Définit la valeur d'un index donné. Le tableau est étendu si nécessaire.
CPtrArray ::SetSize Définit le nombre d'éléments que ce tableau doit contenir.

Opérateurs publics

Nom Description
CPtrArray ::operator [ ] Définit ou obtient l'élément au niveau de l'index spécifié.

Notes

CPtrArray intègre la macro IMPLEMENT_DYNAMIC pour prendre en charge l’accès au type d’exécution et le vidage sur un CDumpContext objet. Si vous avez besoin d’un vidage d’éléments de tableau de pointeurs individuels, vous devez définir la profondeur du contexte de vidage sur 1 ou supérieur.

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.

Les tableaux de pointeurs ne peuvent pas être sérialisés.

Lorsqu’un tableau de pointeurs est supprimé ou lorsque ses éléments sont supprimés, seuls les pointeurs sont supprimés, et non les entités qu’ils référencent.

Pour plus d’informations sur l’utilisation CPtrArray, consultez l’article Collections.

Hiérarchie d'héritage

CObject

CPtrArray

Spécifications

En-tête : afxcoll.h

Voir aussi

CObject, classe
Graphique hiérarchique
CObArray, classe