kdbm_read - Find a key and reads the associated data.
LIBRARY CALL
int kdbm_read(
kdbm *dbf,
kdatum key,
kaddr data,
int num,
int type)
INPUT
dbf - the database file
key - the key in which to read from
data - the data array to read into
num - number of data points to read
type - the type of data points to read from
OUTPUT
none
RETURN VALUE
the number of data points actually read, or -1 upon error
DESCRIPTION
Look up a given KEY and return the information
associated with that KEY. The pointer in the
structure that is returned is a pointer to dynamically
allocated memory block. This is similar to the
kdbm_fetch routine, except that kdbm_read supports
incremental reads.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/klibdb/src/kdbm.c
SEE ALSO
klibdb(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.