gd_unhide(3) hide or unhide a dirfile database entry

Other Alias



#include <getdata.h>
int gd_hide(const DIRFILE *dirfile, const char *entry_name);
int gd_unhide(const DIRFILE *dirfile, const char *entry_name);


The gd_hide() function hides the field or alias called entry_name in the dirfile(5) database specified by dirfile and indicates whether the field or alias called is hidden or not. Similarly, the gd_unhide() function unhides the specified entry. An entry can also be hidden or unhidden using gd_alter_entry(3).

A hidden entry does not appear in the field lists returned by the functions gd_field_list(3), gd_field_list_by_type(3), gd_vectors(3), gd_constants(3), and gd_strings(3). These omissions are also reflected in the counts returned by the corresponding field counting functions (gd_nfields(3), &c.). A hidden field is otherwise no different than an unhidden field.


Upon successful completion, gd_hide() and gd_unhide() return zero. On error they returns -1 and sets the dirfile error a non-zero error value. Possible error values are:
The specified dirfile was opened read-only.
The field specified by field_code was not found in the database.
The supplied dirfile was invalid.
The metadata of the affected format specification fragments was protected from change.

The dirfile error may be retrieved by calling gd_error(3). A descriptive error string for the last error encountered can be obtained from a call to gd_error_string(3).