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).

CALL ARY_STYPE( FTYPE, IARY, STATUS )

FTYPE = CHARACTER $\ast$ ( $\ast$ ) (Given)

IARY = INTEGER (Given)

STATUS = INTEGER (Given and Returned)

• 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.