SCBD_GET_VALUES(3) | SCBD_GET_VALUES(3) |
#include <scboard.h>
int scbd_get_values( char *name, char *attr, char *list[], int *size );
scbd_get_values()
attempts to get a value list of a records
which have name name
and attribute attr
.
The value list will be stored in the list
argument. Thus,
list
must be an array of character pointers whose size is
specified in the size
argument. Upon successful return from
this function call, size
is set to the number of values
found.
All the storage area of the strings set in list
are
allocated using the malloc
function. So it is the user's
responsibility to free those memory regions.
scbd_get_values()
returns 0 on success or one of the
the following errors:
attr
or value
is a null pointer
attr
or value
is a null string
scoreboard
(8)
database process
scoreboard
(8),
scorehosts.db
(5)