aryCopy

Copy an array to a new location

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: