Abstract

   CSPICE_EKNTAB returns the number of loaded EK tables, i.e.
   the number of tables within all loaded EK files.

I/O

   The call:

      cspice_ekntab, n

   returns:

      n        the number of loaded tables.

               help, n
                  LONG = Scalar

               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.

Examples

   Any numerical results shown for this example may differ between
   platforms as the results depend on the SPICE kernels used as input
   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.


      PRO ekntab_ex1

         ;;
         ;; Load the first EK.
         ;;
         cspice_furnsh, 'S79_CIMSSSUPa.bep'

         ;;
         ;; Display the number of EK tables in the system after
         ;; the first EK file is loaded.
         ;;
         cspice_ekntab, n
         print, format='(A,I3)', 'EK tables in the system (1 EK):', n

         ;;
         ;; Load the second EK.
         ;;
         cspice_furnsh, 'S79_status_pf.bes'

         ;;
         ;; Display the number of EK tables in the system after
         ;; the second EK file is loaded.
         ;;
         cspice_ekntab, n
         print, format='(A,I3)', 'EK tables in the system (2 EK):', n

      END


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


      EK tables in the system (1 EK):  3
      EK tables in the system (2 EK):  4

Particulars

   This routine is a utility that provides the caller with the
   number of loaded tables. Callers of cspice_ektnam can use this count
   as the upper bound on set of table indices when looking up table
   names.

Exceptions

   1)  If the output argument `n' is not a named variable, an error
       is signaled by the Icy interface.

Files

   The returned count is based on the currently loaded EK files.

Restrictions

   None.

Required_Reading

   EK.REQ
   ICY.REQ

Literature_References

   None.

Author_and_Institution

   J. Diaz del Rio     (ODC Space)
   E.D. Wright         (JPL)

Version

   -Icy Version 1.0.2, 31-MAY-2021 (JDR)

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

       Added -Parameters, -Exceptions, -Files, -Restrictions,
       -Literature_References and -Author_and_Institution sections, and
       completed -Particulars section.

       Removed reference to the routine's corresponding CSPICE header from
       -Abstract section.

       Added argument's type and size information in the -I/O section.

   -Icy Version 1.0.1, 08-AUG-2008 (EDW)

       Minor edits to header text.

   -Icy Version 1.0.0, 16-JUN-2003 (EDW)

Index_Entries

   return number of loaded tables