1
2
3
4
5
6
7
8
9gd_parser_callback(3)               GETDATA              gd_parser_callback(3)
10
11
12

NAME

14       gd_parser_callback  —  set  the  syntax  error  callback  handler for a
15       Dirfile
16
17

SYNOPSIS

19       #include <getdata.h>
20
21       void gd_parser_callback(DIRFILE *dirfile, gd_parser_callback_t
22              sehandler, void *extra);
23
24

DESCRIPTION

26       The  gd_parser_callback()  function  updates  the syntax error callback
27       function of the DIRFILE object dirfile to be sehandler, and the  caller
28       supplied  extra  pointer  passed to the handler to be extra, discarding
29       any syntax error handler and extra pointer which were previously regis‐
30       tered  for  this  DIRFILE.   If sehandler is NULL, the existing handler
31       will be removed and the default behaviour (abort  on  error)  restored.
32       See  gd_cbopen(3)  for  a discussion on the requirements for the syntax
33       handler.
34
35       Since parsing of an  existing  format  specification  occurs  when  the
36       DIRFILE  object  is  created,  before this function can be called, this
37       function is only useful to set or modify a  callback  function  or  its
38       caller  data  before calling gd_include(3), which will invoke the call‐
39       back function if syntax errors are found in the included fragment.
40
41       This function always succeeds, and has no return value.
42
43

HISTORY

45       The dirfile_parser_callback() function appeared in GetData-0.5.0.
46
47       In GetData-0.7.0, this function was renamed to gd_parser_callback().
48
49

SEE ALSO

51       gd_cbopen(3), gd_include(3), dirfile(5)
52
53
54
55Version 0.10.0                 25 December 2016          gd_parser_callback(3)
Impressum