bionic (3) genders_parse.3.gz

Provided by: libgenders0-dev_1.21-1build5_amd64 bug

NAME
       genders_parse - determine errors with a genders file


SYNOPSIS
       #include <genders.h>

       int genders_parse(genders_t handle, const char *filename, FILE *stream);


DESCRIPTION
       genders_parse()  parses  the  genders  file indicated by filename and outputs information to stream about
       parse errors in the genders file.  If filename is NULL, the default genders file  will  be  checked.   If
       stream is NULL, information will be output to standard error.


RETURN VALUES
       On  success,  the  number of parse errors discovered is returned.  If there are no errors, 0 is returned.
       On error, -1 is returned, and an error code is returned in handle.  The error code can be  retrieved  via
       genders_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_OPEN
              The genders file indicated by filename cannot be opened for reading.

       GENDERS_ERR_OVERFLOW
              A line in the genders database exceeds the maximum allowed length.

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


FILES
       /usr/include/genders.h


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