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 szpool_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
       szpool_c (Get size limitations of the kernel pool)

       void szpool_c ( ConstSpiceChar * name,
                       SpiceInt       * n,
                       SpiceBoolean   * found )
#### Abstract
       Return the kernel pool size limitations.
#### Required_Reading
       KERNEL
#### Keywords
       CONSTANTS
       FILES
#### Brief_I/O
       VARIABLE  I/O  DESCRIPTION
       --------  ---  --------------------------------------------------
       name       I   Name of the parameter to be returned.
       n          O   Value of parameter specified by name.
       found      O   SPICETRUE if name is recognized.
#### Detailed_Input
       name        is the name of a kernel pool size parameter.
                   The following parameters may be specified.

                      "MAXVAR"    is the maximum number of variables that
                                  the kernel pool may contain at any one
                                  time. MAXVAR should be a prime number.

                      "MAXLEN"    is the maximum length of the variable
                                  names that can be stored in the kernel
                                  pool.

                      "MAXVAL"    is the maximum number of distinct values
                                  that may belong to the variables in the
                                  kernel pool. Each variable must have at
                                  least one value, and may have any number,
                                  so long as the total number does not
                                  exceed MAXVAL. MAXVAL must be at least as
                                  large as MAXVAR.

                      "MXNOTE"    is the maximum number of distinct
                                  variable-agents pairs that can be
                                  maintained by the kernel pool. (A variable
                                  is "paired" with an agent, if that agent
                                  is to be notified whenever the variable is
                                  updated.)

                      "MAXAGT"    is the maximum number of agents that can
                                  be kept on the distribution list for
                                  notification of updates to kernel
                                  variables.

                      "MAXCHR"    is the maximum number of characters that
                                  can be stored in a component of a string
                                  valued kernel variable.

                      "MAXLIN"    is the maximum number of character strings
                                  that can be stored as data for kernel pool
                                  variables.

                   Note that the case of `name' is insignificant.
#### Detailed_Output
       n           is the value of the parameter specified by `name'. If
                   `name' is not one of the items specified above, `n' will
                   be returned with the value 0.

       found       is SPICETRUE if the parameter is recognized SPICEFALSE if it
                   is not.
#### Parameters
       None.
#### Exceptions
       1)  If the specified parameter is not recognized, the value of `n'
           returned will be zero and `found' will be set to SPICEFALSE.

       2)  If the `name' input string pointer is null, the error
           SPICE(NULLPOINTER) is signaled.

       3)  If the `name' input string has zero length, the error
           SPICE(EMPTYSTRING) is signaled.
#### Files
       None.
#### Particulars
       This routine provides a programmatic interface to the parameters
       used to define the capacity limits of kernel pool. It is not
       anticipated that most kernel pool users will need to use this
       routine.
#### 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) The following code example demonstrates how to determine the
          size of a kernel reader parameter.

          Example code begins here.

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

          int main ()
          {

             /.
             Local Variables
             ./
             ConstSpiceChar    * varname = "MAXLEN";

             SpiceBoolean        found;

             SpiceInt            n;

             /.
             Make the call to retrieve the value of MAXLEN
             ./
             szpool_c ( varname, &n, &found );

             /.
             If MAXLEN parameter was found, print it out
             ./
             if ( found ) {
                printf ( "Kernel parameter found.\n" );
                printf ( "value:   %s = %d\n", varname, n );
             }

             return ( 0 );
          }

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

          Kernel parameter found.
          value:   MAXLEN = 32
#### Restrictions
       None.
#### Literature_References
       None.
#### Author_and_Institution
       N.J. Bachman        (JPL)
       J. Diaz del Rio     (ODC Space)
       H.W. Taylor         (ACT)
#### Version
       -CSPICE Version 2.1.1, 04-AUG-2021 (JDR)

           Edited the header to comply with NAIF standard. Added example's
           solution.

       -CSPICE Version 2.1.0, 02-SEP-1999 (NJB)

           Local type logical variable now used for found flag used in
           interface of szpool_.

       -CSPICE Version 1.0.0, 23-MAR-1999 (HWT)
#### Index_Entries
       return a kernel pool definition parameter
#### Link to routine szpool_c source file szpool_c.c

    Fri Dec 31 18:41:13 2021