Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.stsci.edu/~sontag/spicedocs/cspice/szpool_c.html
Дата изменения: Sat Dec 17 06:09:58 2005 Дата индексирования: Mon Apr 11 00:11:36 2016 Кодировка: Поисковые слова: sojourner |
Return the kernel pool size limitations.
KERNEL
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.
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. Embedded blanks are also ignored.
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 and SPICEFALSE if it is not.
None.
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.
1) The following code fragment demonstrates how to determine the size of a kernel reader parameter. #include <stdio.h> #include "SpiceUsr.h" void 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:\t%s = %d\n", varname, n ); } }
None.
1) If the specified parameter is not recognized, the value of n will be set to zero and found will be set to SPICEFALSE.
None.
N.J. Bachman (JPL) W.L. Taber (JPL) H.W. Taylor (ACT)
None.
-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)
return a kernel pool definition parameter