next up previous
Next: ARY_MAPZ - Obtain complex mapped access to an array
Up: Routine Descriptions
Previous: ARY_ISTMP - Determine if an array is temporary

ARY_MAP  -  Obtain mapped access to an array

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.



next up previous
Next: ARY_MAPZ - Obtain complex mapped access to an array
Up: Routine Descriptions
Previous: ARY_ISTMP - Determine if an array is temporary



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