CSPICE Routines: ISRCHI

(Index) | A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

ISRCHI_C: Search in an integer 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. 
```

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. 
```
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. 
```

Exceptions

   Error free. 

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

Files
```
   None. 
```

Author_and_Institution

   N.J. Bachman    (JPL)
   W.M. Owen       (JPL)

Literature_References
```
   None. 
```

Version

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

Index_Entries
```
   search in an integer array 
```
Link to routine source

(Index) | A B C D E F G H I J K L M N O P Q R S T U V W X Y Z