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

NAME

14       gd_nfragments  —  retrieve the number of format specification fragments
15       in a dirfile
16
17

SYNOPSIS

19       #include <getdata.h>
20
21       int gd_nfragments(const DIRFILE *dirfile);
22
23

DESCRIPTION

25       The gd_nfragments() function queries a dirfile(5) database specified by
26       dirfile  and  returns  the  total number of parsed format specification
27       fragments in the database.
28
29       The dirfile argument must point to a valid  DIRFILE  object  previously
30       created by a call to gd_open(3).
31
32

RETURN VALUE

34       Upon successful completion, gd_nfragments() returns the total number of
35       format specification fragments which are present in the dirfile.
36
37       On error, this function return zero and store a  negative-valued  error
38       code  in the DIRFILE object which may be retrieved by a subsequent call
39       to gd_error(3).  Possible error codes are:
40
41       GD_E_BAD_DIRFILE
42               The supplied dirfile was invalid.
43
44       A descriptive error string for the error may  be  obtained  by  calling
45       gd_error_string(3).
46
47

HISTORY

49       The get_nfragments() function appeared in GetData-0.4.0.
50
51       In GetData-0.7.0, this function was renamed to gd_nfragments().
52
53

SEE ALSO

55       dirfile(5),      gd_fragmentname(3),     gd_include(3),     gd_open(3),
56       gd_parent_fragment(3)
57
58
59
60Version 0.10.0                 25 December 2016               gd_nfragments(3)
Impressum