- char *gd_linterp_tablename(DIRFILE *dirfile, const char *field_code);
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 VALUEOn success, gd_linterp_tablename() returns the full pathname of the LUT associated with the specified field in a buffer allocated by malloc(3). Once no longer needed, the returned pointer should be passed to free(3) to deallocate the associated memory. On error, NULL is returned and the dirfile error is set to a non-zero error value. Possible error values are:
- The library was unable to allocate memory.
- The field specified by field_code was not found.
- The supplied dirfile was invalid.
- The field specified by field_code was not a LINTERP field.