next up previous contents
Next: milist_grp_next Up: ATTRIBUTE/GROUP FUNCTIONS (11) Previous: milist_start   Contents

milist_attr_next

NAME 

milist_attr_next - get the attributes at given path

SYNOPSIS

#include <minc2.h>

int milist_attr_next  ( milisthandle_t          handle,
                        char                    *path,
                        int                     maxpath
                        char                    *name,
                        int                     maxname)

DESCRIPTION

This function returns each of the attributes associated with the
listing initiated by a call to milist_attr_start().  Each successive
call of the milist_attr_next() function returns the next attribute's
path and name in the corresponding string buffers.  

When all possible attributes have been returned, the function returns
an error.

The maxpath and maxname parameters are used to set the maximum length of the
two string buffers.

If the listing operation is not recursive, the path parameter will always
have length zero (the empty string).

RETURN VALUE

milist_attr_next returns MI_NOERROR if it successfully gets the
attribute name or MI_ERROR otherwise



Robert VINCENT 2005-03-09