Поделиться через


CTypedPtrList::GetNext

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

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

Параметры

  • ТИП
    Параметр шаблона, указывающие тип элементов, содержащихся в этом списке.

  • rPosition
    Ссылка на значение POSITION вернула предыдущим GetNext, GetHeadPosition или другим вызовом функции-члена.

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

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

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

Заметки

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

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

Если полученный элемент является последним в списке, то новое значение rPosition установлено в NULL.

Можно удалить элемент во время итерации. См. пример для CObList::RemoveAt.

Требования

Header: afxtempl.h

См. также

Ссылки

Класс CTypedPtrList

Диаграмма иерархии

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CTypedPtrList::GetPrev

CTypedPtrList::GetHead

CTypedPtrList::GetTail