int genders_index_attrvals(genders_t handle, const char *attr);
DESCRIPTION
genders_index_attrvals() internally indexes attribute values in
a genders handle so that genders searches can be done more quickly in
the
genders_getnodes(3)
and
genders_isattrval(3)
functions.
Only one attribute can be indexed at a time through this function.
Subsequent calls to this function with a different attribute will
overwrite earlier indexes.
RETURN VALUES
On success, 0 is returned. On error, -1 is returned, and an error
code is returned in handle. The error code can be retrieved via
genders_errnum(3)
, and a description of the error code can be retrieved via
genders_strerror(3).
Error codes are defined in genders.h.
ERRORS
GENDERS_ERR_NULLHANDLE
The handle parameter is NULL. The genders handle must be
created with
genders_handle_create(3).