Функция ACOPY( )

Копирует элементы из одного массива в другой.

Синтаксис

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

Параметры

SourceArrayName, DestinationArrayName

Задает исходный массив SourceArrayName, элементы которого копируются один к одному в массив назначения DestinationArrayName. Элементы массива назначения замещаются элементами исходного массива.

Массивы могут быть одномерными или двумерными. Если массив назначения не существует, Visual FoxPro автоматически создает его. В этом случае размер массива азначения будет совпадать с размером исходного массива.

Замечание Элемент двумерного массива можно указывать двумя способами: либо с помощью вух индексов, задающих позиции элемента в массиве по строкам и по столбцам, ли о с помощью одиночного номера. Данная функция, как и ряд других функций, манипу ирующих двумерными массивами, требуют задания одиночных номеров (в данном с учае nFirstSourceElement и nFirstDestElement). Для получения номера элемента исходя из его строчного и столбцевого ин ексов используйте функцию AELEMENT( ).

nFirstSourceElement

Задает номер первого элемента в исходном массиве, начиная с которого начнется копирование. Если номер nFirstSourceElement не задан, копирование начинается с самого первого элемента исходного массива.

nNumberElements

Задает число элементов, копируемых из исходного массива. Если в качестве nNumberElements задано значение 1, копируются все элементы исходного массива, начиная с элемента nFirstSourceElement.

nFirstDestElement

Задает первый элемент массива назначения, подлежащий замещению.

Результат

Числовой

Комментарии

Функция ACOPY( ) возвращает число элементов, скопированных в массив назначения.