1get_nfragments(3)                   GETDATA                  get_nfragments(3)
2
3
4

NAME

6       get_nfragments  —  retrieve  the  number  of format file fragments in a
7       dirfile
8

SYNOPSIS

10       #include <getdata.h>
11
12       int get_nfragments(const DIRFILE *dirfile);
13

DESCRIPTION

15       The get_nfragments() function queries a dirfile(5)  database  specified
16       by dirfile and returns the total number of parsed format file fragments
17       in the database.
18
19       The dirfile argument must point to a valid  DIRFILE  object  previously
20       created by a call to dirfile_open(3).
21
22

RETURN VALUE

24       Upon  successful  completion, get_nfragments() returns the total number
25       of format file fragments which are present in the dirfile.   On  error,
26       get_nfragments()  returns zero and sets the dirfile error to a non-zero
27       value.  Possible error values are:
28
29       GD_E_BAD_DIRFILE
30               The supplied dirfile was invalid.
31
32       The dirfile error may be retrieved by calling get_error(3).  A descrip‐
33       tive error string for the last error encountered can be obtained from a
34       call to get_error_string(3).
35

SEE ALSO

37       dirfile(5), dirfile_include(3),  dirfile_open(3),  get_fragmentname(3),
38       get_parent_fragment(3)
39
40
41
42Version 0.5.0                  14 December 2008              get_nfragments(3)