- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
Description:
The routine obtains mapped
access an array, returning a pointer to the mapped values and a count of the number of
elements mapped.
Invocation
CALL ARY_MAP( IARY, TYPE, MMOD, PNTR, EL, STATUS
)
Arguments
IARY = INTEGER (Given)
Array identifier.
TYPE = CHARACTER
(
)
(Given)
The numerical data type required for access (e.g. ’_REAL’).
MMOD = CHARACTER
(
)
(Given)
The mapping mode for access to the array: ’READ’, ’UPDATE’ or ’WRITE’, with an
optional initialisation mode ’/BAD’ or ’/ZERO’ appended.
PNTR = INTEGER (Returned)
Pointer to the mapped values.
EL = INTEGER (Returned)
Number of elements mapped.
STATUS
= INTEGER (Given and Returned)
The global status.
Notes:
-
If the array is a scaled array, the returned mapped values will be the stored array values multiplied by
the scale factor and shifted by the zero term.
-
If the array is a delta (i.e. compressed) array, the returned mapped values will be the uncompressed
array values.
-
Currently, only READ access is available for scaled and compressed arrays. An error will be reported
if an attempt is made to get WRITE or UPDATE access to a scaled or compressed array.
- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑