Condividi tramite


Classe CWordArray

Supporta matrici di parole a 16 bit.

Sintassi

class CWordArray : public CObject

Membri

Le funzioni membro di CWordArray 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 puntatore CObject come parametro di funzione o valore restituito, sostituire un word.

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

ad esempio, si converte in

WORD CWordArray::GetAt( int <nIndex> ) const;

Costruttori pubblici

Nome Descrizione
CWordArray::CWordArray Costruisce una matrice vuota.

Metodi pubblici

Nome Descrizione
CWordArray::Add Aggiunge un elemento alla fine della matrice; se necessario, aumenta le dimensioni della matrice.
CWordArray::Append Accoda alla matrice un'altra matrice; se necessario, aumenta le dimensioni della matrice.
CWordArray::Copy Copia nella matrice un'altra matrice; se necessario, aumenta le dimensioni della matrice.
CWordArray::ElementAt Restituisce un riferimento temporaneo al puntatore dell'elemento nella matrice.
CWordArray::FreeExtra Libera tutta la memoria non utilizzata oltre limite il superiore corrente.
CWordArray::GetAt Restituisce il valore in corrispondenza di un indice specificato.
CWordArray::GetCount Ottiene il numero di elementi nella matrice.
CWordArray::GetData Consente l'accesso a tutti gli elementi nella matrice. Può essere NULL.
CWordArray::GetSize Ottiene il numero di elementi nella matrice.
CWordArray::GetUpperBound Restituisce il massimo indice valido.
CWordArray::InsertAt Inserisce un elemento (o tutti gli elementi di un'altra matrice) in corrispondenza di un indice specificato.
CWordArray::IsEmpty Determina se la matrice è vuota.
CWordArray::RemoveAll Rimuove tutti gli elementi dalla matrice.
CWordArray::RemoveAt Rimuove un elemento in corrispondenza di un indice specificato.
CWordArray::SetAt Imposta il valore per un indice specificato; l'aumento di dimensioni della matrice non è consentito.
CWordArray::SetAtGrow Imposta il valore per un indice specificato; se necessario, aumenta le dimensioni della matrice.
CWordArray::SetSize Imposta il numero di elementi che la matrice deve contenere.

Operatori pubblici

Nome Descrizione
CWordArray::operator[] Imposta o ottiene l'elemento in corrispondenza dell'indice specificato.

Osservazioni:

CWordArray incorpora la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump dei relativi elementi. Se una matrice di parole viene archiviata in un archivio, con un operatore di inserimento di overload o con la funzione membro CObject::Serialize , 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 un dump di singoli elementi nella matrice, è necessario impostare la profondità del contesto di dump su 1 o versione successiva.

Per altre informazioni sull'uso CWordArraydi , vedere l'articolo Raccolte.

Gerarchia di ereditarietà

CObject

CWordArray

Requisiti

Intestazione: afxcoll.h

Vedi anche

Raccolta di esempi MFC
Classe CObject
Grafico della gerarchia