next up previous
Next: ARY_SAME - Enquire if two arrays are part of the same base array
Up: Routine Descriptions
Previous: ARY_PLACE - Obtain an array placeholder

ARY_RESET  -  Reset an array to an undefined state

Description:
The routine resets an array so that its values become undefined. Its use is advisable before making format changes to an array if retention of the existing values is not required (e.g. before changing its data type with the ARY_STYPE routine); this will avoid the cost of converting the existing values.

Invocation:
CALL ARY_RESET( IARY, STATUS )

Arguments:
IARY = INTEGER (Given)
Array identifier.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • This routine may only be used to reset the state of a base array. If an array section is supplied, then it will return without action. No error will result.

  • An array cannot be reset while it is mapped for access. This routine will fail if this is the case.



next up previous
Next: ARY_SAME - Enquire if two arrays are part of the same base array
Up: Routine Descriptions
Previous: ARY_PLACE - Obtain an array placeholder



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