BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

karray_locate - locate an entry in an array

LIBRARY CALL

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

INPUT

OUTPUT

none

RETURN VALUE

Returns the index of the entry if it is found, -1 otherwise

DESCRIPTION

Locate an entry in the array. If the entry exists in the array, then the index to that entry is returned. If the entry doesn't exist in the array, then -1 is returned.

The array utilities, including karray_locate(), 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

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.