把一个数组的元素复制到另一个数组中。
语法
ACOPY(SourceArrayName, DestinationArrayName
[, nFirstSourceElement [, nNumberElements [, nFirstDestElement ]]])
返回值类型
数值型
参数
SourceArrayName, DestinationArrayName
将源数组 SourceArrayName 中的元素一对一地复制到目标数组 DestinationArrayName
中去,源数组中的元素将替换目标数组的元素。
数组可以是一维或二维数组。如目标数组不存在,Visual FoxPro 将自动创建目标数组。这时,目标数组的大小与源数组大小相同。
注意
可以用两种方法引用二维内存变量数组的元素.第一种是用两个下标值指定元素在数组中的行和列,另一种则指定单个元素的编号。此函数和其他操作二维数组的函数需要单个元素编号(此处为 nFirstSourceElement 和 nFirstDestElement)。使用 AELEMENT( ) 函数,可以根据元素的行和列下标,返回二维数组中某元素的正确元素编号。
nFirstSourceElement
指定源数组中第一个被复制元素的编号,复制从此元素开始(复制时,包含编号为 nFirstSourceElement
的元素)。如果复制时不使用元素编号 nFirstSourceElement,则从源数组的第一个元素开始复制。
nNumberElements
指定复制的源数组的元素数目。如果 nNumberElement 为 -1,则从元素 nFirstSourceElement 开始,复制源数组中所有的元素。
nFirstDestElement
指定目标数组中第一个被替换的元素。
说明
acopy( ) 函数返回复制到目标数组中的元素个数。