1GENDERS_ISNODE(3)                 LIBGENDERS                 GENDERS_ISNODE(3)
2
3
4

NAME

6       genders_isnode,  genders_isattr,  genders_isattrval  - node, attribute,
7       value check routines
8

SYNOPSIS

10       #include <genders.h>
11
12       int genders_isnode(genders_t handle, const char *node);
13
14       int genders_isattr(genders_t handle, const char *attr);
15
16       int genders_isattrval(genders_t handle, const char  *attr,  const  char
17       *val);
18

DESCRIPTION

20       genders_isnode()  tests if the node pointed to by node is listed in the
21       genders file.  If node is NULL, the current node is tested.
22
23       genders_isattr() tests if the attribute pointed to by  attr  is  listed
24       for some node in the genders file.
25
26       genders_isattrval()  tests if the attribute pointed to by attr is equal
27       to the value pointed to by val for some node in the genders file.
28

RETURN VALUES

30       For genders_isnode(), if node is listed  in  the  genders  file,  1  is
31       returned.  If it is not listed, 0 is returned.
32
33       For  genders_isattr(),  if  attr  is  listed  in the genders file, 1 is
34       returned.  If it is not listed, 0 is returned.
35
36       For genders_isattrval(), if attr=val is listed in the genders  file,  1
37       is returned.  If it is not listed, 0 is returned.
38
39       On  error, all three return -1 and an error code is returned in handle.
40       The error code can be retrieved via genders_errnum(3) , and a  descrip‐
41       tion of the error code can be retrieved via genders_strerror(3).  Error
42       codes are defined in genders.h.
43

ERRORS

45       GENDERS_ERR_NULLHANDLE
46              The handle parameter is NULL.  The genders handle must  be  cre‐
47              ated with genders_handle_create(3).
48
49       GENDERS_ERR_NOTLOADED
50              genders_load_data(3) has not been called to load genders data.
51
52       GENDERS_ERR_PARAMETERS
53              An incorrect parameter has been passed in.
54
55       GENDERS_ERR_MAGIC
56              handle  has an incorrect magic number.  handle does not point to
57              a genders handle or handle has been  destroyed  by  genders_han‐
58              dle_destroy(3).
59

FILES

61       /usr/include/genders.h
62

SEE ALSO

64       libgenders(3),   genders_handle_create(3),  genders_load_data(3),  gen‐
65       ders_errnum(3), genders_strerror(3)
66
67
68
69LLNL                              August 2003                GENDERS_ISNODE(3)
Impressum