Classe CByteArray
Supporta matrici di byte dinamiche.
Sintassi
class CByteArray : public CObject
Membri
Le funzioni membro di CByteArray sono simili alle funzioni membro della classe CObArray. Grazie a questa somiglianza, per le specifiche delle funzioni membro è possibile usare la documentazione di riferimento di CObArray. Ovunque venga visualizzato un CObject puntatore come parametro di funzione o valore restituito, sostituire un BYTE.
CObject* CObArray::GetAt( int <nIndex> ) const;
ad esempio, si converte in
BYTE CByteArray::GetAt( int <nIndex> ) const;
Costruttori pubblici
| Nome | Descrizione |
|---|---|
| CByteArray::CByteArray | Costruisce una matrice vuota. |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CByteArray::Add | Aggiunge un elemento alla fine della matrice; se necessario, aumenta le dimensioni della matrice. |
| CByteArray::Append | Accoda alla matrice un'altra matrice; se necessario, aumenta le dimensioni della matrice. |
| CByteArray::Copy | Copia nella matrice un'altra matrice; se necessario, aumenta le dimensioni della matrice. |
| CByteArray::ElementAt | Restituisce un riferimento temporaneo al byte all'interno della matrice. |
| CByteArray::FreeExtra | Libera tutta la memoria non utilizzata oltre limite il superiore corrente. |
| CByteArray::GetAt | Restituisce il valore in corrispondenza di un indice specificato. |
| CByteArray::GetCount | Ottiene il numero di elementi nella matrice. |
| CByteArray::GetData | Consente l'accesso a tutti gli elementi nella matrice. Può essere NULL. |
| CByteArray::GetSize | Ottiene il numero di elementi nella matrice. |
| CByteArray::GetUpperBound | Restituisce il massimo indice valido. |
| CByteArray::InsertAt | Inserisce un elemento (o tutti gli elementi di un'altra matrice) in corrispondenza di un indice specificato. |
| CByteArray::IsEmpty | Determina se la matrice è vuota. |
| CByteArray::RemoveAll | Rimuove tutti gli elementi dalla matrice. |
| CByteArray::RemoveAt | Rimuove un elemento in corrispondenza di un indice specificato. |
| CByteArray::SetAt | Imposta il valore per un indice specificato; l'aumento di dimensioni della matrice non è consentito. |
| CByteArray::SetAtGrow | Imposta il valore per un indice specificato; se necessario, aumenta le dimensioni della matrice. |
| CByteArray::SetSize | Imposta il numero di elementi che la matrice deve contenere. |
Operatori pubblici
| Nome | Descrizione |
|---|---|
| CByteArray::operator [ ] | Imposta o ottiene l'elemento in corrispondenza dell'indice specificato. |
Osservazioni:
CByteArray incorpora la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump dei relativi elementi. Se una matrice di byte viene archiviata in un archivio, con l'operatore di inserimento di overload ( <<) o con la Serialize funzione membro, ogni elemento è, a sua volta, serializzato.
Nota
Prima di usare una matrice, usare SetSize per determinarne le dimensioni e allocare la necessaria memoria. Se non si usa SetSize, l'aggiunta di elementi alla matrice ne causa la riallocazione e la copia frequente. Le operazioni di riallocazione e copia frequenti sono inefficienti e possono frammentare la memoria.
Se è necessario eseguire il debug dell'output da singoli elementi nella matrice, è necessario impostare la profondità dell'oggetto CDumpContext su 1 o versione successiva.
Per altre informazioni sull'uso CByteArraydi , vedere l'articolo Raccolte.
Gerarchia di ereditarietà
CByteArray
Requisiti
Intestazione: afxcoll.h