CList::GetPrev

项目
03/01/2013

获取列表元素标识由 rPosition，然后设置 rPosition 前面项的 POSITION 值列表中的。

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

参数

类型
指定元素的类型模板参数列表。
rPosition
为 POSITION 值的引用由以前的 GetPrev 返回或其他成员函数调用。

返回值

如果列表为 const，GetPrev 返回元素的副本放在列表的开头。这使得功能在赋值语句右侧仅使用并防止修改的列表。

如果列表不是 const，GetPrev 返回对列表的元素。这使得函数使用在赋值语句的两侧从而允许列表项进行修改。

备注

如果您建立与调用的初始位置。GetTailPosition 或 Find，您可以在一个反向迭代周期中使用 GetPrev。

您必须确保 POSITION 值表示列表中的有效位置。如果是无效的，则选件Microsoft基础类库的调试版本断言。

如果已检索的元素是第一个在列表中，则 rPosition 的新值设置为 NULL。

示例

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