aryMap

Obtain mapped access to an array

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:

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.