1
2
3
4
5
6
7
8
9gd_parser_callback(3) GETDATA gd_parser_callback(3)
10
11
12
14 gd_parser_callback — set the syntax error callback handler for a
15 Dirfile
16
17
19 #include <getdata.h>
20
21 void gd_parser_callback(DIRFILE *dirfile, gd_parser_callback_t
22 sehandler, void *extra);
23
24
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
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
51 gd_cbopen(3), gd_include(3), dirfile(5)
52
53
54
55Version 0.10.0 25 December 2016 gd_parser_callback(3)