Classe di CStringArray

Articolo
02/19/2013

Supporta le matrici di oggetti CString.

class CStringArray : public CObject

Membri

Le funzioni membro CStringArray sono simili alle funzioni membro di classe CObArray.A causa di questa somiglianze, è possibile utilizzare la documentazione di riferimento CObArray per le specifiche di funzione membro.Per visualizzare un puntatore CObject come valore restituito, sostituire CString (non un puntatore CString ).Per visualizzare un puntatore CObject come parametro di funzione, sostituire LPCTSTR.

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

ad esempio, converte a

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

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

converte un oggetto

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

Costruttori pubblici

Nome	Descrizione
CObArray::CObArray	Crea una matrice vuota.

Metodi pubblici

Nome	Descrizione
CObArray::Add	Aggiungere un elemento alla fine della matrice, ingrandito la matrice se necessario.
CObArray::Append	Aggiunge un'altra matrice alla matrice, ingrandito la matrice se necessario.
CObArray::Copy	Copia un'altra matrice alla matrice, ingrandito la matrice se necessario.
CObArray::ElementAt	Restituisce un riferimento temporaneo al puntatore dell'elemento nella matrice.
CObArray::FreeExtra	Libera la memoria inutilizzata sul limite superiore corrente.
CObArray::GetAt	Restituisce il valore a un indice specificato.
CObArray::GetCount	Ottiene il numero di elementi nella matrice.
CObArray::GetData	Consente l'accesso a elementi nella matrice.Può essere NULL.
CObArray::GetSize	Ottiene il numero di elementi nella matrice.
CObArray::GetUpperBound	Restituisce il maggiore indice valido.
CObArray::InsertAt	Inserire un elemento (o tutti gli elementi in un'altra matrice) a un indice specificato.
CObArray::IsEmpty	Determina se la matrice è vuota.
CObArray::RemoveAll	Rimuove tutti gli elementi della matrice.
CObArray::RemoveAt	Rimuove un elemento a un valore specifico.
CObArray::SetAt	Imposta il valore di indice specificato; matrice non consentita per lo sviluppo.
CObArray::SetAtGrow	Imposta il valore di indice specificato; ingrandito la matrice se necessario.
CObArray::SetSize	Imposta il numero di elementi da includere nella matrice.

Operatori pubblici

Nome	Descrizione
CObArray::operator [ ]	Imposta o ottiene l'elemento all'indice specificato.

Note

CStringArray include la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump degli elementi.Se una matrice di oggetti CString viene archiviata in un archivio, con un operatore di overload di inserimento o con la funzione membro Serialize, ogni elemento viene serializzato a sua volta.

[!NOTA]

Prima di utilizzo di una matrice, utilizzare SetSize per stabilire le dimensioni e per allocare memoria per.Se non si utilizza SetSize, aggiungere elementi alla matrice in modo che venga ridistribuito e alla copia di frequente.Il frequente riallocazione e copiare sono inefficaci e possono frammentare la memoria.

Se è necessario un dump di singoli elementi di tipo stringa nella matrice, è necessario impostare la profondità del contesto di dump a 1 o superiore.

Quando una matrice CString viene eliminato, oppure quando gli elementi vengono rimossi, la memoria della stringa viene liberata in base alle proprie esigenze.

Per ulteriori informazioni su l CStringArray, vedere l'articolo Raccolte.

Gerarchia di ereditarietà

CObject

CStringArray

Requisiti

Header: afxcoll.h

Vedere anche

Riferimenti

Classe di CObject

Grafico della gerarchia

Condividi tramite