acopy( ) 函数

示例 请参阅

把一个数组的元素复制到另一个数组中。

语法

ACOPY(SourceArrayName, DestinationArrayName
[, nFirstSourceElement [, nNumberElements [, nFirstDestElement ]]])

返回值类型

数值型

参数

SourceArrayName, DestinationArrayName

将源数组 SourceArrayName 中的元素一对一地复制到目标数组 DestinationArrayName 
中去,源数组中的元素将替换目标数组的元素。
数组可以是一维或二维数组。如目标数组不存在,Visual FoxPro 将自动创建目标数组。这时,目标数组的大小与源数组大小相同。

注意  

可以用两种方法引用二维内存变量数组的元素.第一种是用两个下标值指定元素在数组中的行和列,另一种则指定单个元素的编号。此函数和其他操作二维数组的函数需要单个元素编号(此处为 nFirstSourceElement 和 nFirstDestElement)。使用 AELEMENT( ) 函数,可以根据元素的行和列下标,返回二维数组中某元素的正确元素编号。

nFirstSourceElement

指定源数组中第一个被复制元素的编号,复制从此元素开始(复制时,包含编号为 nFirstSourceElement 
的元素)。如果复制时不使用元素编号 nFirstSourceElement,则从源数组的第一个元素开始复制。

nNumberElements

指定复制的源数组的元素数目。如果 nNumberElement 为 -1,则从元素 nFirstSourceElement 开始,复制源数组中所有的元素。

nFirstDestElement

指定目标数组中第一个被替换的元素。

说明

acopy( ) 函数返回复制到目标数组中的元素个数。