CList::GetNext

Artículo
02/19/2013

Obtiene el elemento de la lista identificado por rPosition, establezca rPosition al valor de POSITION de entrada siguiente en la lista.

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

Parámetros

TYPE
Parámetro de plantilla que especifica el tipo de los elementos de la lista.
rPosition
Una referencia a un valor devuelto de POSITION por el GetNextanterior, el GetHeadPosition, u otra llamada de función miembro.

Valor devuelto

Si la lista está const, GetNext devuelve una copia de un elemento de la lista.Esto permite que la función se usa únicamente a la derecha de una instrucción de asignación y protege la lista de modificación.

Si la lista no está const, GetNext devuelve una referencia a un elemento de la lista.Esto permite que la función se utiliza a cada lado de una instrucción de asignación y permite de modo que las entradas de lista son modificadas.

Comentarios

Puede utilizar GetNext en un bucle de iteración frontal si establece la posición inicial con una llamada a GetHeadPosition o a Buscar.

Debe asegurarse de que el valor de POSICIÓN representa una posición válida en la lista.Si no es válido, la versión de depuración de la biblioteca Microsoft Foundation Class aserciones.

Si el elemento recuperado es el último en la lista, el nuevo valor de rPosition se establece en NULL.

Ejemplo

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