Share via


CTypedPtrList::GetNext

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 
);
TYPE GetNext(
   POSITION& rPosition 
) const;

Parámetros

  • TYPE
    Parámetro de plantilla que especifica el tipo de elementos incluidos en esta 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 se logra a través de un puntero a const CTypedPtrList, después GetNext devuelve un puntero de tipo que especifica el tipo de parámetro de plantilla.Esto permite que la función se usa únicamente a la derecha de una instrucción de asignación y protege así la lista de modificación.

Si la lista está accesible directamente o a través de un puntero a CTypedPtrList, después GetNext devuelve una referencia a un puntero de tipo que especifica el tipo de parámetro de plantilla.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 CPtrList::Find.

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.

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

Requisitos

encabezado: afxtempl.h

Vea también

Referencia

Clase de CTypedPtrList

Gráfico de jerarquía

CObList::Find

CObList::GetHeadPosition

CObList::GetTailPosition

CTypedPtrList::GetPrev

CTypedPtrList::GetHead

CTypedPtrList::GetTail