# NNS_FndGetNextListObject

## C Specification

      #include <nnsys/fnd.h>

      void* NNS_FndGetNextListObject(  NNSFndList* list ,  void* object );

## Arguments

list | Pointer to the list structure
object | Pointer to the current object

## Return Values

Returns the pointer to the next object from the designated object. Returns NULL if there is no next object.

## Description

Returns the pointer to the next object in the list designated with `object`. Returns the pointer to the object connected to the top of the list if `object` is set to NULL. Returns NULL if there is no next object.

The following process can be performed to access all objects in order from the top of the list.

    void* object = NULL;

    while ( ( object = NNS_FndGetNextListObject( list , object ) ) != NULL )
        {
            ......
        }

## See Also

`NNS_FndGetPrevListObject`, `NNS_FndNthListObject`

## Revision History

10/21/2004 Corrected the sample code in the description
02/02/2004 Initial version