BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
karray_add - add an entry into the array list
LIBRARY CALL
<type> *karray_add(
<type> *array,
int type,
<type> entry,
size_t num)
INPUT
- array - The current array in which we will be adding the
entry to (if NULL then return the newly
malloc'ed array list).
- entry - The entry identifier to be added to the array
list
- num - The number of entry in the list; ignored if
list is NULL
OUTPUT
none
RETURN VALUE
returns the modified array list.
DESCRIPTION
Adds an entry to the array list. This is done by
adding the entry to the end of the array list
(if the array currently exists). If the array is
currently NULL then the new item is returned as the
first entry of the array list. If the array list is
not NULL then the entry is added to the end of the
list and the original array is passed back to the calling
routine.
The routine first scans the array to make sure the
entry is not already on the list, if so then we
don't change original array.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/include/kutils/karray.h
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.