table of contents
gd_hidden(3) | GETDATA | gd_hidden(3) |
NAME¶
gd_hidden — check whether a Dirfile entry is hidden or not
SYNOPSIS¶
#include <getdata.h>
int gd_hidden(const DIRFILE *dirfile, const char *entry_name);
DESCRIPTION¶
The gd_hidden() function queries a dirfile(5) database specified by dirfile to determine whether the field or alias called entry_name is hidden or not. This information is also available in the entry object proved by gd_entry(3).
By default, a hidden entry does not appear in the lists returned by the functions gd_match_entries(3), gd_entry_list(3) gd_constants(3), or gd_strings(3), including the special-case versions of gd_entry_list(3) such as gd_field_list(3). These omissions are also reflected in the counts returned by the corresponding field counting function gd_nentries(3) and it's special-case versions (gd_nfields(3), &c.).
RETURN VALUE¶
Upon successful completion, gd_hidden() returns one if the field or alias is hidden, or zero if the entry is not hidden.
On error, it returns a negative-valued error code. (As a result, the caller checking simply whether the return value of this function is non-zero is usually an error.) Possible error codes are:
- GD_E_BAD_CODE
- The field specified by field_code was not found in the database.
- GD_E_BAD_DIRFILE
- The supplied dirfile was invalid.
The error code is also stored in the DIRFILE object and may be retrieved after this function returns by calling gd_error(3). A descriptive error string for the error may be obtained by calling gd_error_string(3).
HISTORY¶
The gd_hidden() function appeared in GetData-0.8.0.
In GetData-0.10.0, the error return from this function changed from -1 to a negative-valued error code.
SEE ALSO¶
gd_entry(3), gd_field_list(3), gd_hide(3), gd_nfields(3), gd_open(3), gd_unhide(3), dirfile(5)
25 December 2016 | Version 0.10.0 |