CList::GetNext

Articolo
03/05/2013

Ottiene l'elemento dell'elenco identificato da rPosition, quindi imposta rPosition al valore della posizione della voce seguente nell'elenco.

TYPE& GetNext(
   POSITION& rPosition 
);
const TYPE& GetNext( 
   POSITION& rPosition  
) const;

Parametri

TIPO
Parametro di modello che specifica il tipo degli elementi nell'elenco.
rPosition
Un riferimento a un valore di percorso restituito da GetNextprecedente, da GetHeadPosition, o da un'altra chiamata di funzione membro.

Valore restituito

Se l'elenco è const, GetNext restituisce una copia di un elemento di elenco.Questo consente alla funzione da utilizzare solo nella parte destra di un'istruzione di assegnazione e proteggere l'elenco di modifica.

Se l'elenco non è const, GetNext restituisce un riferimento a un elemento di elenco.Questo consente alla funzione da utilizzare per entrambi i lati di un'istruzione di assegnazione e pertanto consente le voci di elenco da modificare.

Note

È possibile utilizzare GetNext in un ciclo di iterazione in avanti se si stabilisce la posizione iniziale con una chiamata a GetHeadPosition o a Trova.

È necessario assicurarsi che il valore della posizione rappresenta un percorso valido nell'elenco.Se non è valido, quindi la versione di debug delle asserzioni della libreria MFC.

Se l'elemento recuperato è l'ultimo nell'elenco, il nuovo valore rPosition è impostato su NULL.

Esempio

// Define myList.
CList<CString,CString&> myList;

// Add two elements to the list.
myList.AddHead(CString(_T("ABC")));
myList.AddHead(CString(_T("123")));

// Dump the list elements to the debug window.
POSITION pos = myList.GetHeadPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetNext(pos));
}