Man page - gd_hidden(3)

Packages contains this manual

Manual

gd_hidden

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
HISTORY
SEE ALSO

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)