aryMapz

Obtain complex mapped access to an array

Description:

This function obtains complex mapped access to an array, returning pointers to the real and imaginary values and a count of the number of elements mapped.

Invocation

void aryMapz( Ary ∗ary, const char ∗type, const char ∗mmod, void ∗∗rpntr, void ∗∗ipntr, size_t ∗el, int ∗status )

Parameters :

ary
Array identifier.
type
The numerical data type required for accessing the array (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.
rpntr
Returned holding a pointer to the mapped real (i.e. non-imaginary) values.
ipntr
Returned holding a pointer to the mapped imaginary values.
el
Returned holding the number of elements mapped.
status
The global status.