void clpool_c ( void )
Remove all variables from the kernel pool. Watches
on kernel variables are retained.
KERNEL
CONSTANTS
FILES
None.
None.
None.
None.
1) All known agents (those established through swpool_) will
be "notified" that their watched variables have been updated
whenever clpool_c is called.
None.
clpool_c clears the pool of kernel variables maintained by
the subroutine pool_. All the variables in the pool are deleted.
However, all watcher information is retained.
Each watched variable will be regarded as having been updated.
Any agent associated with that variable will have a notice
posted for it indicating that its watched variable has been
updated.
Application programs can delete watches by calling the function
dwpool_, which is located in the source file pool.c.
See the documentation of dwpool_ for details.
The following code fragment demonstrates how to clear to kernel pool
to make room for new kernel data. In this example, three kernels
are successively loaded and used, after which the kernel pool is
cleared. The kernels may collectively contain too much data for the
kernel pool to hold, but clearing the kernel pool after each use
makes it possible to use all three.
#include "SpiceUsr.h"
.
.
.
/.
Store in an array the names of the kernel files whose
values will be loaded into the kernel pool. These are
SCLK kernels for three different spacecraft clocks.
./
ConstSpiceChar * kerptr [3] = { "vg1_sclk.ker",
"vg2_sclk.ker",
"gll_sclk.ker" };
/.
Use each kernel in turn.
/.
for ( i = 0; i < 3; i++ )
{
ldpool_c ( kerptr[i] );
[ use SCLK data for ith spacecraft ]
/.
Clear the kernel pool, making room for new data.
./
clpool_c ();
}
None.
None.
N.J. Bachman (JPL)
I.M. Underwood (JPL)
W.L. Taber (JPL)
-CSPICE Version 1.0.1, 01-JUL-2014 (NJB)
Updated comments regarding behavior of the watcher
subsystem.
-CSPICE Version 1.0.0, 18-JUN-1999 (IMU) (WLT) (NJB)
CLEAR the pool of kernel variables
Link to routine clpool_c source file clpool_c.c
|