gd_fragmentname3
Retrieve a dirfile format specification fragment name
Usage
#include <getdata.h>
const char* gd_fragmentname(const DIRFILE *dirfile, int index);
Overview
The gd_fragmentname() function queries a dirfile(5) database specified by dirfile and returns the filename of the format specification fragment indexed by the non-negative index.
The dirfile argument must point to a valid DIRFILE object previously created by a call to gd_open(3).
The fragment with index equal to zero is always the primary fragment for the database (the file called format in the root dirfile directory). The largest valid value of index is one less than the total number of fragments, which may be obtained from a call to gd_nfragments(3).
Return value
Upon successful completion, gd_fragmentname() returns a pointer to a read-only character string containing the file name of the specified fragment.
On error, this function returns NULL and stores a negative-valued error code in the DIRFILE object which may be retrieved by a subsequent call to gd_error(3). Possible error codes are:
.TP 8 GD_E_BAD_DIRFILE The supplied dirfile was invalid.
.TP 8 GD_E_BAD_INDEX The supplied index was out of range.
A descriptive error string for the error may be obtained by calling gd_error_string(3).
Releases
7 releases since Debian 7 (Wheezy); the text changed 1 time.