BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kread_string - read an array of strings
LIBRARY CALL
ssize_t kread_string(
int id,
kstring *data,
size_t num)
INPUT
- id - the file id to be read which was opened earlier
with kopen().
- num - the number of string to be read into the
data array.
OUTPUT
- data - the kstring array in which the data will be stored.
RETURN VALUE
the number of strings read
DESCRIPTION
This module is used to read an array of strings. The
data will need to contain enough memory to store "num"
string pointers. The memory that the strings
are stored in will be allocated by kread_string.
Where "kstring" is really a typedef for a character
pointer "char *". So an array of kstring is really
an array of character pointers.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
the strings that are returned should be freed by the
programmer
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/include/kutils/kread.h
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.