- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑
Description:
This function copies an array to a new
location and returns an identifier for the resulting new base array.
Invocation
void aryCopy( Ary
ary1, AryPlace
place,
Ary ary2,
int status
)
Arguments
ary1
Identifier for the array (or array section) to be copied.
place
An array
placeholder (e.g. generated by the aryPlace function) which indicates the position in the data system
where the new array will reside. The placeholder is annulled by this function, and a value of NULL
will be returned.
ary2
Returned holding the identifier for the new array.
status
The global status.
Notes:
-
The result of copying a scaled or delta array will be an equivalent simple array.
-
If this routine is called with "
status"
set, then a value of NULL will be returned for the "
ary"
argument, although no further processing will occur. The same value will also be returned if the
function should fail for any reason. In either event, the placeholder will still be annulled.
- ←Prev
- ARY
A Subroutine Library for Accessing
ARRAY Data Structures - Next→
- TOC ↑