dirfile_parser_callback

Langue: en

Autres versions - même langue

Version: 19 December 2008 (fedora - 05/07/09)

Section: 3 (Bibliothèques de fonctions)

NAME

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

SYNOPSIS

#include <getdata.h>
void dirfile_parser_callback(DIRFILE *dirfile, int (*sehandler)(const DIRFILE*, int, char*));

DESCRIPTION

The dirfile_parser_callback() sets the syntax error callback function of the DIRFILE object dirfile to sehandler, discarding any signal handler which was previously registered for this DIRFILE. If sehandler is NULL, the existing handler will be removed and the default behaviour (abort on error) restored. See dirfile_cbopen(3) for a discussion on the requirements for the syntax handler.

Since parsing of an existing format file occurs when the DIRFILE object is created, before this function can be called, this function is only useful to modify set or modify a callback function before calling dirfile_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

dirfile_cbopen(3), dirfile_include(3), dirfile(5)