CList::GetPrev

Artykuł
06/10/2015

Pobiera element listy, identyfikowane przez rPosition, następnie ustawia rPosition do stanowisko wartość poprzedniej pozycji na liście.

TYPE& GetPrev( 
   POSITION& rPosition  
); 
const TYPE& GetPrev( 
   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 GetPrev lub inne wywołanie funkcji Członkowskich.

Wartość zwracana

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

Jeśli lista nie jest const, GetPrev 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ć GetPrev w pętli wstecznego iteracji, jeśli ustanowić początkowego położenia wywołania GetTailPosition 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 pobrano element pierwszy 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, 
// in reverse order.
POSITION pos = myList.GetTailPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetPrev(pos));
}