Procedure

   SpiceInt sumai_c ( ConstSpiceInt   * array,
                      SpiceInt          n     ) 

Abstract

 
    Return the sum of the elements of an integer array. 
 

Required_Reading

 
   None. 
 

Keywords

 
   ARRAY,  MATH,  UTILITY 
 

Brief_I/O

 
   VARIABLE  I/O  DESCRIPTION 
   --------  ---  -------------------------------------------------- 
   array      I   Input array. 
   n          I   Number of elements in the array. 

   The function returns the sum of the elements of the input array. 
 

Detailed_Input

 
   array       is the input array. 

   n           is the number of elements in the array. 
 

Detailed_Output

 
   The function returns the sum of the elements of the input array. 
   That is, 

      sumai_c ( array, n )  =  array[0] + array[1] + ... + array[n-1] 

   If n is zero or negative, sumai_c returns zero. 
 

Parameters

 
   None. 
 

Exceptions

 
   Error free. 
 

Files

 
   None. 
 

Particulars

 
   The value of the function is initially set to zero. The elements 
   of the array are then added. If the number of elements is zero or 
   negative, sumai_c is zero. 
 

Examples

 
   Let array contain the following elements. 

         array[0] = 12
         array[1] =  1 
         array[2] =  4 
         array[3] = 75 
         array[4] = 18 

   Then 

         sumai_c ( array,   -3 )       =   0 
         sumai_c ( array,    0 )       =   0 
         sumai_c ( array,    1 )       =  12 
         sumai_c ( array,    2 )       =  13 
         sumai_c ( array,    5 )       = 110 
         sumai_c ( array+2,  3 )       =  97 
 
 

Restrictions

 
   sumai_c does not check for overflow. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman    (JPL) 
   I.M. Underwood  (JPL) 

Version

 
   -CSPICE Version 1.0.0, 24-MAR-1999 (IMU) (NJB)

Index_Entries

 
   sum of an integer array 
 

Link to routine sumai_c source file sumai_c.c