Classe CStringArray

Supporta matrici di oggetti CString .

Sintassi

class CStringArray : public CObject

Membri

Le funzioni membro di CStringArray 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 valore restituito, sostituire un CString oggetto (non un CString puntatore). Ogni volta che un puntatore CObject appare come parametro di funzione, sostituire con un LPCTSTR.

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

ad esempio, si converte in

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

e

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

si converte in

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

Costruttori pubblici

Nome	Descrizione
CStringArray::CStringArray	Costruisce una matrice vuota.

Metodi pubblici

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

Operatori pubblici

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

Osservazioni:

CStringArray incorpora la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump dei relativi elementi. Se una matrice di oggetti CString viene memorizzata in un archivio, con un operatore di inserimento di overload o con la funzione membro Serialize, ogni elemento viene serializzato a turno.

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 di tipo stringa nella matrice, è necessario impostare la profondità del contesto di dump a 1 o superiore.

Quando una matrice CString viene eliminata o i relativi elementi vengono rimossi, viene liberata la memoria di stringa appropriata.

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

Gerarchia di ereditarietà

CObject

CStringArray

Requisiti

Intestazione: afxcoll.h

Vedi anche

CObject Classe
Grafico della gerarchia