- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
Description:
This function
obtains mapped access an array, returning a pointer to the mapped values and
a count of the number of elements mapped.
Invocation
void aryMap( Ary
∗ary, const char
∗type, const
char ∗mmod, void
∗∗pntr,
size_t ∗el,
int ∗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.
Parameters :
ary
Array identifier.
type
The numerical data type required for access (e.g. "
_REAL"
).
mmod
The mapping mode for access to the array: "
READ"
, "
UPDATE"
or "
WRITE"
, with an optional
initialisation mode "
/BAD"
or "
/ZERO"
appended.
pntr
Returned holding a pointer to the
mapped values.
el
Returned holding the number of elements mapped.
status
The global status.
- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑