1GENDERS_HANDLE_DESTROY(3)         LIBGENDERS         GENDERS_HANDLE_DESTROY(3)
2
3
4

NAME

6       genders_handle_destroy - destroys a genders handle
7

SYNOPSIS

9       #include <genders.h>
10
11       int genders_handle_destroy(genders_t handle);
12

DESCRIPTION

14       genders_handle_destroy() destroys the genders handle pointed to by han‐
15       dle and frees all allocated memory associated with it.
16

RETURN VALUES

18       On success, 0 is returned.  On error, -1 is returned, and an error code
19       is  returned  in  handle.   The  error  code  can be retrieved via gen‐
20       ders_errnum(3) , and a description of the error code can  be  retrieved
21       via genders_strerror(3).  Error codes are defined in genders.h.
22

ERRORS

24       GENDERS_ERR_NULLHANDLE
25              The  handle  parameter is NULL.  The genders handle must be cre‐
26              ated with genders_handle_create(3).
27
28       GENDERS_ERR_MAGIC
29              handle has an incorrect magic number.  handle does not point  to
30              a genders handle or handle has already been destroyed.
31

FILES

33       /usr/include/genders.h
34

SEE ALSO

36       libgenders(3),   genders_handle_create(3),  genders_load_data(3),  gen‐
37       ders_errnum(3), genders_strerror(3)
38
39
40
41LLNL                              August 2003        GENDERS_HANDLE_DESTROY(3)