linux man page for genders_getmaxvallen

GENDERS_GETNUMNODES(3)						    LIBGENDERS						    GENDERS_GETNUMNODES(3)

NAME
       genders_getnumnodes, genders_getnumattrs, genders_getmaxattrs, genders_getmaxnodelen, genders_getmaxattrlen, genders_getmaxvallen - genders
       statistics routines

SYNOPSIS
       #include <genders.h>

       int genders_getnumnodes(genders_t handle);

       int genders_getnumattrs(genders_t handle);

       int genders_getmaxattrs(genders_t handle);

       int genders_getmaxnodelen(genders_t handle);

       int genders_getmaxattrlen(genders_t handle);

       int genders_getmaxvallen(genders_t handle);

DESCRIPTION
       genders_getnumnodes(), genders_getnumattrs(), genders_getmaxattrs(), genders_getmaxnodelen(), genders_getmaxattrlen(), and  genders_getmax-
       vallen() get statistics about the genders file associated with handle.

       genders_getnumnodes() returns the number of nodes stored in the genders file.

       genders_getnumattrs() returns the number of attributes listed in the genders file.

       genders_getmaxattrs() returns the maximum number of attributes listed with a node in the genders file.

       genders_getmaxnodelen() returns the maximum length of any node listed in the genders file.

       genders_getmaxattrlen() returns the maximum length of any attribute listed in the genders file.

       genders_getmaxvallen() returns the maximum length of any attribute value listed in the genders file.

       In general, genders_getnumnodes(), genders_getnumattrs(), genders_getmaxattrs(), genders_getmaxnodelen(), genders_getmaxattrlen(), and gen-
       ders_getmaxvallen() are used so a programmer can dynamically allocate a proper amount of memory to store genders file information in.

RETURN VALUES
       On success, 0 is returned.  On error, -1 is returned, and an error code is returned in handle.  The error code can be  retrieved  via  gen-
       ders_errnum(3) , and a description of the error code can be retrieved via genders_strerror(3).  Error codes are defined in genders.h.

ERRORS
       GENDERS_ERR_NULLHANDLE
	      The handle parameter is NULL.  The genders handle must be created with genders_handle_create(3).

       GENDERS_ERR_NOTLOADED
	      genders_load_data(3) has not been called to load genders data.

       GENDERS_ERR_MAGIC
	      handle  has  an  incorrect  magic  number.   handle  does not point to a genders handle or handle has been destroyed by genders_han-
	      dle_destroy(3).

FILES
       /usr/include/genders.h

SEE ALSO
       libgenders(3), genders_handle_create(3), genders_load_data(3), genders_errnum(3), genders_strerror(3)

LLNL
								    August 2003 					    GENDERS_GETNUMNODES(3)