
Next:
ARY_TEMP
-
Obtain a placeholder for a temporary array
Up: Routine Descriptions
Previous:
ARY_STATE
-
Determine the state of an array (defined or undefined)
ARY_STYPE
-
Set a new type for an array
- Description:
-
The routine sets a new full type for an array, causing its data
storage type to be changed. If the array 's pixel values are
defined, then they will be converted from the old type to the new
one. If they are undefined, then no conversion will be
necessary. Subsequent enquiries will reflect the new type.
Conversion may be performed between any types supported by the
ARY_ routines, including from a non-complex type to a complex
type (and vice versa).
- Invocation:
-
CALL ARY_STYPE( FTYPE, IARY, STATUS )
- Arguments:
-
-
FTYPE = CHARACTER
(
) (Given)
-
The new full type specification for the array (e.g. '_REAL '
or 'COMPLEX_INTEGER ').
-
IARY = INTEGER (Given)
-
Array identifier.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
-
-
This routine may only be used to change the type of a base
array. If it is called with an array which is not a base array,
then it will return without action. No error will result.
-
An error will result if the array, or any part of it, is
currently mapped for access (e.g. through another identifier).
-
If the type of an array is to be changed without its pixel
values being retained, then a call to ARY_RESET should be made
beforehand. This will avoid the cost of converting all the
values.

Next:
ARY_TEMP
-
Obtain a placeholder for a temporary array
Up: Routine Descriptions
Previous:
ARY_STATE
-
Determine the state of an array (defined or undefined)
ARY A Subroutine Library for Accessing ARRAY Data Structures
Starlink User Note 11
R.F. Warren-Smith
28th April 1998
E-mail:rfws@star.rl.ac.uk