next up previous
Next: ARY_OFFS - Obtain the pixel offset between two arrays
Up: Routine Descriptions
Previous: ARY_NEWP - Create a new primitive array

ARY_NOACC  -  Disable a specified type of access to an array

Description:
The routine disables the specified type of access to an array, so that any subsequent attempt to access it in that way will fail. Access restrictions imposed on an array identifier by this routine will be propagated to any new identifiers derived from it, and cannot be revoked.

Invocation:
CALL ARY_NOACC( ACCESS, IARY, STATUS )

Arguments:
ACCESS = CHARACTER ( ) (Given)
The type of access to be disabled: 'BOUNDS ', 'DELETE ', 'MODIFY ', 'SHIFT ', 'TYPE ' or 'WRITE '.
IARY = INTEGER (Given)
Array identifier.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
Disabling each type of access imposes the following restrictions on an array:
  • 'BOUNDS ' prevents the pixel-index bounds of a base array from being altered.

  • 'DELETE ' prevents the array being deleted.

  • 'MODIFY ' prevents any form of modification to the array (i.e. it disables all the other access types).

  • 'SHIFT ' prevents pixel-index shifts from being applied to a base array.

  • 'TYPE ' prevents the data type of the array from being altered.

  • 'WRITE ' prevents new values from being written to the array, or the array 's state from being reset.



next up previous
Next: ARY_OFFS - Obtain the pixel offset between two arrays
Up: Routine Descriptions
Previous: ARY_NEWP - Create a new primitive array



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