- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
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_NEWPK( 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*8
(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.
- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑