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