CByteArray, classe

Prend en charge les tableaux d'octets dynamiques.

Syntaxe

class CByteArray : public CObject

Membres

Les fonctions membres de CByteArray 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 BYTE.

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

par exemple, se traduit par

BYTE CByteArray::GetAt( int <nIndex> ) const;

Constructeurs publics

Nom	Description
CByteArray ::CByteArray	Construit un tableau vide.

Méthodes publiques

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

Opérateurs publics

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

Notes

CByteArray intègre la macro IMPLEMENT_SERIAL pour prendre en charge la sérialisation et le dumping de ses éléments. Si un tableau d’octets est stocké dans une archive, avec l’opérateur d’insertion surchargé ( <<) ou avec la Serialize fonction membre, chaque élément est à son tour sérialisé.

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 déboguer la sortie à partir d’éléments individuels dans le tableau, vous devez définir la profondeur de l’objet CDumpContext sur 1 ou supérieur.

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

Hiérarchie d'héritage

CObject

CByteArray

Spécifications

En-tête : afxcoll.h

Voir aussi

CObject, classe
Graphique hiérarchique
CObArray, classe