Classe CStringList

Supporta elenchi di oggetti CString .

Sintassi

class CStringList : public CObject

Membri

Le funzioni membro di CStringList sono simili alle funzioni membro della classe CObList. Grazie a questa somiglianza, per le specifiche delle funzioni membro è possibile usare la documentazione di riferimento di CObList. Ovunque venga visualizzato un CObject puntatore come valore restituito, sostituire un CString (non un CString puntatore). Ovunque venga visualizzato un CObject puntatore come parametro di funzione, sostituire un oggetto LPCTSTR.

CObject*& CObList::GetHead() const;

ad esempio, si converte in

CString& CStringList::GetHead() const;

e

POSITION AddHead( CObject* <newElement> );

si converte in

POSITION AddHead( LPCTSTR <newElement> );

Costruttori pubblici

Nome	Descrizione
CStringList::CStringList	Costruisce un elenco vuoto.

Metodi pubblici

Nome	Descrizione
CStringList::AddHead	Aggiunge un elemento (o tutti gli elementi di un altro elenco) all'inizio dell'elenco (crea una nuova testa).
CStringList::AddTail	Aggiunge un elemento (o tutti gli elementi di un altro elenco) alla parte finale dell'elenco (crea una nuova coda).
CStringList::Find	Ottiene la posizione di un elemento specificato dal valore del puntatore.
CStringList::FindIndex	Ottiene la posizione di un elemento specificato da un indice in base zero.
CStringList::GetAt	Ottiene l'elemento in corrispondenza di una determinata posizione.
CStringList::GetCount	Restituisce il numero di elementi nell'elenco.
CStringList::GetHead	Restituisce l'elemento head dell'elenco (non può essere vuoto).
CStringList::GetHeadPosition	Restituisce la posizione dell'elemento head dell'elenco.
CStringList::GetNext	Ottiene l'elemento successivo per l'iterazione.
CStringList::GetPrev	Ottiene l'elemento precedente per l'iterazione.
CStringList::GetSize	Restituisce il numero di elementi nell'elenco.
CStringList::GetTail	Restituisce l'elemento finale dell'elenco (non può essere vuoto).
CStringList::GetTailPosition	Restituisce la posizione dell'elemento finale dell'elenco.
CStringList::InsertAfter	Inserisce un nuovo elemento dopo una determinata posizione.
CStringList::InsertBefore	Inserisce un nuovo elemento prima di una determinata posizione.
CStringList::IsEmpty	Verifica la condizione di elenco vuota (nessun elemento).
CStringList::RemoveAll	Rimuove tutti gli elementi dall'elenco.
CStringList::RemoveAt	Rimuove un elemento da questo elenco, specificato dalla posizione.
CStringList::RemoveHead	Rimuove l'elemento dall'inizio dell'elenco.
CStringList::RemoveTail	Rimuove l'elemento dalla parte finale dell'elenco.
CStringList::SetAt	Imposta l'elemento in una determinata posizione.

Osservazioni:

Tutti i confronti vengono eseguiti in base al valore, ovvero i caratteri nella stringa vengono confrontati anziché gli indirizzi delle stringhe.

CStringList incorpora la macro IMPLEMENT_SERIAL per supportare la serializzazione e il dump dei relativi elementi. Se un elenco di CString oggetti viene archiviato in un archivio, con un operatore di inserimento di overload o con la Serialize funzione membro, ogni CString elemento viene serializzato a sua volta.

Se è necessario un dump di singoli CString elementi, è necessario impostare la profondità del contesto di dump su 1 o versione successiva.

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

Gerarchia di ereditarietà

CObject

CStringList

Requisiti

Intestazione: afxcoll.h

Vedi anche

Esempio MFC COLLECT
CObject Classe
Grafico della gerarchia