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


CONFIDENTIAL