next up previous
Next: ARY_NEWP - Create a new primitive array
Up: Routine Descriptions
Previous: ARY_NDIM - Enquire the dimensionality of an array

ARY_NEW  -  Create a new simple array

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

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

Arguments:
FTYPE = CHARACTER ( ) (Given)
Full data type of the array.
NDIM = INTEGER (Given)
Number of array dimensions.
LBND( NDIM ) = INTEGER (Given)
Lower pixel-index bounds of the array.
UBND( NDIM ) = INTEGER (Given)
Upper pixel-index bounds of the array.
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_NEWP - Create a new primitive array
Up: Routine Descriptions
Previous: ARY_NDIM - Enquire the dimensionality of an 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