gd_linterp_tablename(3) GETDATA gd_linterp_tablename(3)NAMEgd_linterp_tablename — retrieve the pathname of a look-up table in a
dirfile
SYNOPSIS
#include <getdata.h>
const char *gd_linterp_tablename(DIRFILE *dirfile, const char
*field_code);
DESCRIPTION
The gd_linterp_tablename() function retrieves the pathname of the look-
up table (LUT) used by the LINTERP field specified by field_code in the
dirfile specified by dirfile. If field_code contains a valid represen‐
tation suffix, it will be ignored.
Note: this function returns a fully canonicalised, absolute path. The
value of the table member in a gd_entry_t object (see gd_entry(3)) is
the path which appears in the format specification on disk, which may
be a path relative to the fragment directory.
RETURN VALUE
On success, gd_linterp_tablename() returns the full pathname of the LUT
associated with the specified field. On error, NULL is returned and
the dirfile error is set to a non-zero error value. Possible error
values are:
GD_E_ALLOC
The library was unable to allocate memory.
GD_E_BAD_CODE
The field specified by field_code was not found.
GD_E_BAD_DIRFILE
The supplied dirfile was invalid.
GD_E_BAD_FIELD_TYPE
The field specified by field_code was not a LINTERP field.
GD_E_BAD_REPR
The representation suffix specified in field_code was not
recognised.
The dirfile error may be retrieved by calling gd_error(3). A descrip‐
tive error string for the last error encountered can be obtained from a
call to gd_error_string(3).
SEE ALSOgd_entry(3), gd_error(3), gd_error_string(3), dirfile(5), dirfile-for‐
mat(5)Version 0.8.1 1 August 2012 gd_linterp_tablename(3)