Index of Functions: A B C D E F G H I J K L M N O P Q R S T U V W X
Index Page ekntab_c
Table of contents
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
       ekntab_c ( EK, return number of loaded tables )

       void ekntab_c ( SpiceInt   * n )
#### Abstract
       Return the number of loaded EK tables.
#### Required_Reading
       EK
#### Keywords
       EK
       FILES
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       n          O   Number of loaded tables.
#### Detailed_Input
       None.
#### Detailed_Output
       n           is the number of loaded tables. The count refers
                   to the number of logical tables; if multiple
                   segments contain data for the same table, these
                   segments collectively contribute only one table
                   to the count.
#### Parameters
       None.
#### Exceptions
       None.
#### Files
       The returned count is based on the currently loaded EK files.
#### Particulars
       This routine is a utility that provides the caller with the
       number of loaded tables. Callers of ektnam_c can use this count
       as the upper bound on set of table indices when looking up table
       names.
#### Examples
       The numerical results shown for this example may differ across
       platforms. The results depend on the SPICE kernels used as
       input, the compiler and supporting libraries, and the machine
       specific arithmetic implementation.

       1) Suppose we have several EK files. Load one at a time and
          display, right after, the number of loaded EK tables in the
          system.

          Use the EK kernel below to load the Cassini Science Plan
          SPICE E-Kernel File based upon integrated science plan. This
          kernel contains 3 tables.

             S79_CIMSSSUPa.bep

          Use the EK kernel below to load the Cassini Spacecraft
          Sequence Status SPICE E-Kernel File based upon integrated
          Predicted Events File. This kernel contains 1 table.

             S79_status_pf.bes

          Example code begins here.

          /.
             Program ekntab_ex1
          ./
          #include <stdio.h>
          #include "SpiceUsr.h"

          int main( )
          {

             /.
             Local variables
             ./
             SpiceInt             n;

             /.
             Load the first EK.
             ./
             furnsh_c ( "S79_CIMSSSUPa.bep" );

             /.
             Display the number of EK tables in the system after
             the first EK file is loaded.
             ./
             ekntab_c ( &n );
             printf( "EK tables in the system (1 EK): %2d\n", n );

             /.
             Load the second EK.
             ./
             furnsh_c ( "S79_status_pf.bes" );

             /.
             Display the number of EK tables in the system after
             the second EK file is loaded.
             ./
             ekntab_c ( &n );
             printf( "EK tables in the system (2 EK): %2d\n", n );

             return ( 0 );
          }

          When this program was executed on a Mac/Intel/cc/64-bit
          platform, the output was:

          EK tables in the system (1 EK):  3
          EK tables in the system (2 EK):  4
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       N.J. Bachman        (JPL)
       J. Diaz del Rio     (ODC Space)
#### Version
       -CSPICE Version 1.0.1, 19-APR-2021 (JDR)

           Edited the header to comply with NAIF standard. Added complete
           code example based on existing fragments.

       -CSPICE Version 1.0.0, 14-OCT-2001 (NJB)
#### Index_Entries
       return number of loaded tables
#### Link to routine ekntab_c source file ekntab_c.c

    Fri Dec 31 18:41:06 2021