gd_parser_callback(3) [debian man page]

gd_parser_callback(3)						      GETDATA						     gd_parser_callback(3)

NAME

       gd_parser_callback -- set the syntax error callback handler for a dirfile

SYNOPSIS

       #include <getdata.h>

       void gd_parser_callback(DIRFILE *dirfile, gd_parser_callback_t sehandler, void *extra);

DESCRIPTION

       The  gd_parser_callback() function updates the syntax error callback function of the DIRFILE object dirfile to be sehandler, and the caller
       supplied extra pointer passed to the handler to be extra, discarding any syntax error handler and extra pointer which were previously  reg-
       istered	for this DIRFILE.  If sehandler is NULL, the existing handler will be removed and the default behaviour (abort on error) restored.
       See gd_cbopen(3) for a discussion on the requirements for the syntax handler.

       Since parsing of an existing format specification occurs when the DIRFILE object is created, before this function can be called, this func-
       tion  is  only  useful to set or modify a callback function or its caller data before calling gd_include(3), which will invoke the callback
       function if syntax errors are found in the included fragment.

       This function always succeeds, and has no return value.

SEE ALSO

       gd_cbopen(3), gd_include(3), dirfile(5)

Version 0.7.0							 17 September 2010					     gd_parser_callback(3)

gd_fragmentname(3)						      GETDATA							gd_fragmentname(3)

NAME

       gd_fragmentname -- retrieve a dirfile format specification fragment name

SYNOPSIS

       #include <getdata.h>

       const char* gd_fragmentname(const DIRFILE *dirfile, int index);

DESCRIPTION

       The  gd_fragmentname()  function  queries  a  dirfile(5) database specified by dirfile and returns the filename of the format specification
       fragment indexed by the non-negative index.

       The dirfile argument must point to a valid DIRFILE object previously created by a call to gd_open(3).

       The fragment with index equal to zero is always the primary fragment for the database (the file called format in the root dirfile  directo-
       ry).   The  largest  valid  value  of  index is one less than the total number of fragments, which may be obtained from a call to gd_nfrag-
       ments(3).

RETURN VALUE

       Upon successful completion, gd_fragmentname() returns a pointer to a read-only character string containing the file name of  the  specified
       fragment.  On error, gd_fragmentname() returns NULL and sets the dirfile error a non-zero error value.  Possible error values are:

       GD_E_BAD_DIRFILE
	       The supplied dirfile was invalid.

       GD_E_BAD_INDEX
	       The supplied index was out of range.

       The  dirfile error may be retrieved by calling gd_error(3).  A descriptive error string for the last error encountered can be obtained from
       a call to gd_error_string(3).

SEE ALSO

       dirfile(5), gd_error(3), gd_error_string(3), gd_include(3), gd_nfragments(3), gd_open(3), gd_parent_fragment(3)

Version 0.7.0							   21 July 2010 						gd_fragmentname(3)