Description:
This routine
obtains an exact number of values from a parameter and stores them in a vector. If the
number of values obtained is less than that requested, a further get or gets will occur for the
remaining values until the exact number required is obtained (or an error occurs). The routine
reports how many additional values are required prior to these further reads. Should too
many values be entered an error results and a further read is attempted.
Invocation
CALL
PAR_EXACx( PARAM, NVALS, VALUES, STATUS )
Arguments
PARAM = CHARACTER
(
)
(Given)
The name of the parameter.
NVALS = INTEGER (Given)
The number of values needed.
Values will be requested until exactly this number of values (no more and no less) has been obtained.
VALUES( NVALS ) = ? (Returned)
The values obtained from the parameter system. They will only be
valid if STATUS is not set to an error value.
STATUS = INTEGER (Given and Returned)
The global
status.
Notes:
-
There is a routine for each of the data types character, double precision, integer, logical, and real:
replace "x" in the routine name by C, D, I, K, L, or R respectively as appropriate. The VALUES
argument must have the corresponding data type.
-
If more than one attempt is made is to obtain the values, the current value of the parameter will be
only that read at the last get, and not the full array of values.
-
A PAR__ERROR status is returned when the number of values requested is not positive.