CList::GetNext

Статья
06/10/2015

Возвращает элемент списка указанный rPosition, а затем устанавливает rPosition к значению POSITION следующей записи в списке.

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

Параметры

ТИП
Параметр шаблона, указывающие тип элементов в списке.
rPosition
Ссылка на значение POSITION вернула предыдущим GetNext, GetHeadPosition или другим вызовом функции-члена.

Возвращаемое значение

Если список const, то GetNext возвращает копию элемента списка. Это позволяет функции, которую необходимо использовать только в правой части оператора присваивания и защищает список из изменений.

Если список не является const, то GetNext возвращает ссылку на элемент списка. Это позволяет функции, которую необходимо использовать с обеих сторон оператора назначения и таким образом позволяющее записи списка, который требуется изменить.

Заметки

Можно использовать GetNext на переднем цикле итерации при установке на первоначальную позицию с вызовом GetHeadPosition или Найти.

Необходимо убедиться, что значение POSITION представляет допустимую положение в списке. Если оно является недопустимым, отладочная версия библиотеки Microsoft Foundation Class assert.

Если полученный элемент является последним в списке, то новое значение 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.
POSITION pos = myList.GetHeadPosition();
for (int i = 0; i < myList.GetCount(); i++)
{
   TRACE(_T("%s\r\n"), (LPCTSTR)myList.GetNext(pos));
}