gd_naliases man page

gd_naliases — report the number of aliases of a field in a dirfile


#include <getdata.h>

unsigned int gd_naliases(DIRFILE *dirfile, const char *field_code);


The gd_naliases() function queries a dirfile(5) database specified by dirfile and returns the number of aliases of the field specified by field_code.

The dirfile argument must point to a valid DIRFILE object previously created by a call to gd_open(3).

Return Value

Upon successful completion, gd_naliases() returns the number of aliases of the specified field code in the dirfile. If successful, this count will be at least one. On error, it returns zero and sets the dirfile error to a non-zero error value. Possible error values are:

The supplied field code was not found in the database.
The supplied dirfile was invalid.

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).

See Also

dirfile(5), gd_open(3), gd_aliases(3), gd_alias_target(3)

Referenced By


Explore man page connections for gd_naliases(3).

GETDATA Version 0.9.0 1 October 2013