next up previous
Next: PAR_PUTVx - Puts an array of values into a parameter as if the parameter were a vector
Up: Reference Manual
Previous: PAR_PUT1x - Puts a vector of values into a parameter

PAR_PUTNx - Puts an array of values into a parameter    

Description:
This routine puts an n-dimensional array of values into a parameter. If necessary, the specified array is converted to the type of the parameter.

Invocation:
CALL PAR_PUTNx ( PARAM, NDIM, MAXD, VALUES, ACTD, STATUS )

Arguments:
PARAM = CHARACTER * ( * ) (Given)
The parameter name.
NDIM = INTEGER (Given)
The number of dimensions of the values array. This must match the number of dimensions of the object.
MAXD( NDIM ) = INTEGER (Given)
The array specifying the dimensions of the array to be put. These may not be greater than the actual dimensions of the parameter (ACTD) nor those of the VALUES array.
VALUES( * ) = ? (Given)
The array of values to be put into the parameter. These must be in Fortran order.
ACTD( NDIM ) = INTEGER (Given)
The dimensions of the parameter storage to be created. These are unlikely to be different from MAXD.

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, L, or R respectively as appropriate. The VALUES argument must have the corresponding data type.
  • In order to obtain a storage object for the parameter, the current implementation of the underlying ADAM parameter system will proceed in the same way as it does for input parameters. This can result in users being prompted for `a value'. This behaviour, and how to avoid it, is discussed further in the Interface Module Reference Manual ( SUN/115).
  • Limit checks for IN, RANGE, MIN/MAX are not applied.



next up previous
Next: PAR_PUTVx - Puts an array of values into a parameter as if the parameter were a vector
Up: Reference Manual
Previous: PAR_PUT1x - Puts a vector of values into a parameter

PAR Interface to the ADAM Parameter System
Starlink User Note 114
Malcolm J. Currie
Alan J. Chipperfield
1999 September 24
E-mail:ussc@star.rl.ac.uk