next up previous
Next: ARY_NOACC - Disable a specified type of access to an array
Up: Routine Descriptions
Previous: ARY_NEW - Create a new simple array

ARY_NEWP  -  Create a new primitive array

Description:
The routine creates a new primitive array and returns an identifier for it. The array may subsequently be manipulated with the ARY_ routines.

Invocation:
CALL ARY_NEWP( FTYPE, NDIM, UBND, PLACE, IARY, STATUS )

Arguments:
FTYPE = CHARACTER ( ) (Given)
Data type of the array (e.g. '_REAL '). Note that complex types are not allowed for primitive arrays.
NDIM = INTEGER (Given)
Number of array dimensions.
UBND( NDIM ) = INTEGER (Given)
Upper pixel-index bounds of the array (the lower bound of each dimension is taken to be 1).
PLACE = INTEGER (Given and Returned)
An array placeholder (e.g. generated by the ARY_PLACE routine) which indicates the position in the data system where the new array will reside. The placeholder is annulled by this routine, and a value of ARY__NOPL will be returned (as defined in the include file ARY_PAR).
IARY = INTEGER (Returned)
Identifier for the new array.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • If this routine is called with STATUS set, then a value of ARY__NOID will be returned for the IARY argument, although no further processing will occur. The same value will also be returned if the routine should fail for any reason. In either event, the placeholder will still be annulled. The ARY__NOID constant is defined in the include file ARY_PAR.



next up previous
Next: ARY_NOACC - Disable a specified type of access to an array
Up: Routine Descriptions
Previous: ARY_NEW - Create a new simple 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