BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

karray_delete - delete an entry from an array

LIBRARY CALL

<type> *karray_delete(
  <type> *array,
   int    type,
  <type>  entry,
   size_t num)

INPUT

OUTPUT

none

RETURN VALUE

The modified array when there are still entries in the array, NULL when the array becomes empty.

DESCRIPTION

Deletes an entry from the array, and returns the modified array to the calling routine.

The array utilities, including karray_delete(), support arrays of a variety of data types. The data type of the array being used is specified with the 'type' parameter; supported data types include:

KBYTE - array of characters KUBYTE - array of unsigned characters KSHORT - array of short integers KUSHORT - array of unsigned short integers KINT - array of integers KUINT - array of unsigned integers KLONG - array of long integers KULONG - array of unsigned long integers KFLOAT - array of floating point numbers KDOUBLE - array of double precision numbers KSTRING - array of strings KSTRUCT - array of pointers to structures KLOGICAL - array of TRUE/FALSE values

Note that the array and the entry passed in MUST both be of the type specified by the type parameter, or the results of this routine are unpredictable.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$BOOTSTRAP/objects/library/kutils/src/array.c

SEE ALSO

kutils(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.