Function ACopy() Foundation
Copies elements of an array into another array
ACopy( <aSource>, ; <aTarget>, ; [<nStartSource>], ; [<nCount>], ; [<nStartTarget>] ) --> aTarget
The return value of ACopy() is a reference to <aTarget>.
The array function ACopy() copies values from the array elements in <aSource> into the target array <aTarget>. Only values in the first dimension of <aSource> are copied. If <aSource> has subarrays (is a multi-dimensional array), only the array references and not the content of the subarrays are copied into <aTarget>. In this case, both arrays have the reference to the same subarrays. To completely copy a multi-dimensional array, the function AClone() must be used.
The array <aTarget> must be large enough to hold the copied values. If <aSource> is greater than <aTarget>, all the elements are not copied.
The array <aTarget> can be identical to <aSource>. When this is the case, elements in <aSource> may be moved in blocks.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.