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à
CStringArray
Requisiti
Intestazione: afxcoll.h