Return the number of segments in a specified EK. 

   EK 

   Variable  I/O  Description 
   --------  ---  -------------------------------------------------- 
   handle     I   EK file handle. 

   The function returns the number of segments in the specified 
   E-kernel. 

   handle         is the handle of an EK file opened for read access. 

   The function returns the number of segments in the specified 
   E-kernel. 

   None. 

   This routine is used to support the function of summarizing an 
   EK file.  Given the number of segments in the file, a program 
   can use ekssum_c in a loop to summarize each of them. 

   1)  Open an EK file and count the segments in it. 

          ekopr_c ( ekname, &handle );
          n = eknseg_c  ( handle );

   None. 

   1)  If handle is invalid, the error will be diagnosed by routines 
       called by this routine.  eknseg_c will return the value zero. 

   2)  If an I/O error occurs while trying to read the EK, the error 
       will be diagnosed by routines called by this routine. 
       eknseg_c will return the value zero. 

   See the description of handle in $Detailed_Input. 

   N.J. Bachman   (JPL) 

   None. 

   -CSPICE Version 1.0.0, 24-FEB-1999 (NJB)

   return number of segments in an E-kernel