Index Page
ktotal_c
A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X 

Procedure
Abstract
Required_Reading
Keywords
Brief_I/O
Detailed_Input
Detailed_Output
Parameters
Exceptions
Files
Particulars
Examples
Restrictions
Literature_References
Author_and_Institution
Version
Index_Entries

Procedure

   void ktotal_c ( ConstSpiceChar   * kind,
                   SpiceInt         * count ) 

Abstract

 
   Return the current number of kernels that have been loaded 
   via the KEEPER interface that are of a specified type. 
 

Required_Reading

 
   None. 
 

Keywords

 
   KERNEL 
 

Brief_I/O

 
   VARIABLE  I/O  DESCRIPTION 
   --------  ---  -------------------------------------------------- 
   kind       I   A list of kinds of kernels to count.
   count      O   The number of kernels of type kind.
 

Detailed_Input

 
   kind       is a list of types of kernels to count when computing
              loaded kernels.  kind should consist of a list of words
              of kernels to examine.  Recognized types are
 
                 SPK  --- All SPK files are counted in the total.
                 CK   --- All CK files are counted in the total. 
                 PCK  --- All binary PCK files are counted in the 
                          total. 
                 DSK  --- All DSK files are counted in the total. 
                 EK   --- All EK files are counted in the total. 
                 TEXT --- All text kernels that are not meta-text. 
                          kernels are included in the total. 
                 META --- All meta-text kernels are counted in the 
                          total. 
                 ALL  --- Every type of kernel is counted in the 
                          total. 
 
               kind is case insensitive.  If a word appears in kind 
               that is not one of those listed above, it is ignored. 
 
               See the Examples section for illustrations of the 
               use of kind. 
 

Detailed_Output

 
   count       is the number of kernels loaded through furnsh_c that 
               belong to the list specified by kind. 
 

Parameters

 
   None. 
 

Exceptions

   1) If a word on the list specified by kind is not recognized 
      it is ignored. 
 
   2) If kind is blank, or none of the words in kind is on the 
      list specified above, count will be returned as zero. 
 
   3) If the input file kind argument pointer is null, the error
      SPICE(NULLPOINTER) will be signaled.
      
   4) If the input file kind argument pointer is the empty string, the 
      error SPICE(EMPTYSTRING) will be signaled.
   

Files

 
   None. 
 

Particulars

 
   ktotal_c allows you to easily determine the number of kernels 
   loaded via the interface furnsh_c that are of a type of interest. 
 

Examples

 
   Suppose you wish to determine the number of SPK kernels that 
   have been loaded via the interface furnsh_c.  Assign kind 
   the value "SPK" and call ktotal_c as shown: 
 
      #include "SpiceUsr.h"
           .
           .
           .
      ktotal_c ( "spk", &count ); 
 
      printf ( "The number of loaded SPK files is:  %d\n", count );
       
 
   To determine the number of text kernels that are loaded that 
   are not meta-kernels: 
 
      ktotal_c ( "TEXT", &ntext ); 
 
      printf ( "The number of non-meta-text kernels loaded is: %d\n",
                ntext                                                ); 
 
   To determine the number of SPK, CK and PCK kernels loaded, make the
   following call:
 
      ktotal_c ( "SPK PCK CK", &count );
 
 
   To get a count of all loaded kernels: 
 
      ktotal_c ( "ALL", &count );
 
      printf ( "There are %d SPICE kernels loaded.\n", count ); 
 
 

Restrictions

 
   None. 
 

Literature_References

 
   None. 
 

Author_and_Institution

 
   N.J. Bachman    (JPL)
   W.L. Taber      (JPL) 
 

Version

 
   -CSPICE Version 1.0.1, 20-JAN-2016 (NJB) (WLT)

       Header was updated to reflect support for use
       of DSKs. Header sections were reordered.

   -CSPICE Version 1.0.0, 01-SEP-1999 (NJB) (WLT)

Index_Entries

 
   Number of loaded kernels of a given type 
 
Wed Apr  5 17:54:37 2017