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