CList::GetNext

Artykuł
02/27/2013

Pobiera element listy, identyfikowane przez rPosition, następnie ustawia rPosition do stanowisko wartość następnego wpisu.

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

Parametry

TYP
Określanie typu elementów na liście parametr szablonu.
rPosition
Odwołanie do stanowisko wartości zwróconej przez poprzednie GetNext, GetHeadPosition, lub inne wywołanie funkcji Członkowskich.

Wartość zwracana

Jeśli lista jest const, GetNext zwraca kopię elementu listy.Umożliwia funkcja tylko na prawej stronie instrukcji przypisania i chroni przed modyfikacją listy.

Jeśli lista nie jest const, GetNext zwraca odwołanie do elementu listy.Umożliwia funkcji na dowolnej stronie instrukcji przypisania i tym samym pozwala na pozycje listy modyfikacji.

Uwagi

Można użyć GetNext w pętli do przodu iteracji po nawiązaniu początkowego położenia wywołania GetHeadPosition lub znaleźć.

Musi zapewnić, że Twój stanowisko wartość reprezentuje prawidłową pozycję na liście.Jeśli jest nieprawidłowa wersja debugowania biblioteki klas Microsoft Foundation potwierdza.

Jeśli element pobrane ostatni na liście, jest następnie nową wartość rPosition jest ustawiona na NULL.

Przykład

// 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));
}