Procedure

   isrchi_c ( Search in an integer array ) 

   SpiceInt isrchi_c ( SpiceInt         value,
                       SpiceInt         ndim,
                       ConstSpiceInt  * array  )

Abstract

   Search for a given value within an integer array. Return
   the index of the first matching array entry, or -1 if the key
   value was not found.

Required_Reading

   None.

Keywords

   ARRAY
   SEARCH

Brief_I/O

   VARIABLE  I/O  DESCRIPTION
   --------  ---  --------------------------------------------------
   value      I   Key value to be found in array.
   ndim       I   Dimension of array.
   array      I   Integer array to search.

   The function returns the index of the first matching array
   element or -1 if the value is not found.

Detailed_Input

   value       is the key value to be found in the array.

   ndim        is the dimension of the array.

   array       is the integer array to be searched.

Detailed_Output

   The function returns the index of the first matching array
   element in array. If value is not found, isrchi_c returns -1.

Parameters

   None.

Exceptions

   Error free.

   1)  If ndim < 1, the function value is -1.

Files

   None.

Particulars

   None.

Examples

   The following table shows the value of isrchi_c given the contents
   of ARRAY and VALUE:

     ARRAY        VALUE   isrchi_c
   ----------     -----   --------
   1, 0, 4, 2       4        2
   1, 0, 4, 2       2        3
   1, 0, 4, 2       3       -1

Restrictions

   None.

Literature_References

   None.

Author_and_Institution

   N.J. Bachman        (JPL)
   J. Diaz del Rio     (ODC Space)
   W.M. Owen           (JPL)

Version

   -CSPICE Version 1.0.1, 03-JUL-2021 (JDR)

       Edited the header to comply with NAIF standard.

   -CSPICE Version 1.0.0, 10-JUL-2000 (NJB) (WMO)

Index_Entries

   search in an integer array