
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:
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