Share via


CObList::GetNext

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

CObject*& GetNext(
   POSITION& rPosition 
);
const CObject* GetNext( 
   POSITION& rPosition  
) const;

Parámetros

  • rPosition
    Una referencia a un valor devuelto de POSITION por el GetNextanterior, el GetHeadPosition, u otra llamada de función miembro.

Valor devuelto

Vea la descripción del valor devuelto para GetHead.

Comentarios

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

Debe asegurarse de que el valor de POSITION 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.

Es posible quitar un elemento durante una iteración.Vea el ejemplo para RemoveAt.

[!NOTA]

A partir de MFC 8,0 la versión const de este método ha cambiado para devolver const CObject* en lugar de const CObject*&.Este cambio se realizó para llevar el compilador en conformidad con el estándar de C++.

La tabla siguiente se muestran otras funciones miembro que son similares a CObList::GetNext.

Clase

Función miembro

CPtrList

void*& GetNext( POSITION& rPosition );

const void* GetNext( POSITION& rPosition ) const;

CStringList

CString& GetNext( POSITION& rPosition );

const CString& GetNext( POSITION& rPosition ) const;

Ejemplo

Vea CObList:: CObList para una lista de la clase de CAge .

CObList list;
POSITION pos;
list.AddHead(new CAge(21));
list.AddHead(new CAge(40)); // List now contains (40, 21).
// Iterate through the list in head-to-tail order.
#ifdef _DEBUG
   for (pos = list.GetHeadPosition(); pos != NULL;)
   {
      afxDump << list.GetNext(pos) << _T("\n");
   }
#endif      

Los resultados de este programa son los siguientes:

a CAge at $479C 40

a CAge at $46C0 21

Requisitos

encabezado: afxcoll.h

Vea también

Referencia

Clase CObList

Gráfico de jerarquía

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CObList::GetPrev

CObList::GetHead