13.3. ARRAY

About
Functions order

13.3.1. About ARRAY

13.3.2. ARRAY functions order

A2EDIT() Просмотр двухмерного массива в виде таблицы
AADD() Добавляет новый элемент в конец массива.
ACLONE() Дублирует вложенный или многомерный массив.
ACOPY() Копирует элементы одного массива в другой.
ADEL() Удаляет элемент массива.
AEVAL() Выполняет блок кода для каждого элемента массива.
AFILL() Заполняет массив заданным значением.
AINS() Заносит элемент со значением NIL в массив.
ASCAN() Просмотр массива
__FLEDIT() Отбирает из массива структуры DBStruct() элементы, указанные в списке.
FT_AADDITION() Add elements unique of source array to target array
FT_AAVG() Average numeric values in an array
FT_ADESSORT() Sort an array in descending order
FT_AEMAXLEN() Find longest element within an array
FT_AEMINLEN() Find shortest element within an array
FT_AMEDIAN() Find middle value in array, or average of two middle values
FT_ANOMATCHES() Find the number of array elements meeting a condition
FT_AREDIT() 2 dimensional array editing function using TBrowse
FT_ASUM() Sum the elements of an array
FT_RESTARR() Restore a Clipper array from a disc file
FT_SAVEARR() Save Clipper array to a disc file.
MAP() Создает новый пустой объект (ассоциативный массив)
MAPMODIFY Включает/отключает режим контроля измений атрибутов.

13.3.2.1. Function A2EDIT()

  A2EDIT(<nTop>, <nLeft>, <nBottom>, <nRight>, <aData>, <cUserFunc>, <aSay>, <aHeaders>, <aHeadSep>, <aColSep>, <aFootSep>, <aFooters>) --> NIL
 

13.3.2.2. Function AADD()

  AADD(<имя массива>, <выражение>[, <keyValue>]) --> значение

13.3.2.2.3. Description

AADD() - это функция обработки массивов, которая увеличивает текущую длину указанного массива на единицу. Вновь созданному элементу присваивается значение, заданное аргументом <выражение>.

AADD() используется для динамического наращивания массивов. Это полезно для построения динамических списков и очередей. Примером может служить массив Getlist, используемый системой GET для хранения GET- объектов. После команд READ или CLEAR GETS, Getlist становится пустым массивом. Каждый раз, когда выполняется команда @...GET, система GET использует функцию AADD() для добавления нового элемента в конец массива Getlist и затем назначает новый GET-объект новому элементу.

AADD() похожа на ASIZE(), но добавляет только один элемент за вызов; ASIZE() может нарастить или сжать массив до заданного размера. AADD(), однако, имеет то преимущество, что может присваивать значение новому элементу, в то время как ASIZE() этого сделать не может. AADD() так же кажется похожей на функцию AINS(), однако они различны. AINS() перемещает элементы внутри массива, но она не может изменять длину массива.

Примечание. Если аргумент <выражение> - это тоже массив, то новый элемент в указанном массиве будет содержать ссылку на массив, заданный аргументом <выражение>.

13.3.2.4. Function ACOPY()

  ACOPY(<исходный массив>,<принимающий массив>,
 [<начальный элемент>],[<кол-во элементов>],
 [<нач. элемент принимающего массива>])
 --> принимающий массив
 
 

13.3.2.5. Function ADEL()

  ADEL(<принимающий массив>, <номер элемента>) --> принимающий массив
 
 

13.3.2.6. Function AEVAL()

  AEVAL(<имя массива>, <блок кода>, [<начальный элемент>],
 [<кол-во элементов>]) --> имя массива
 
 

13.3.2.7. Function AFILL()

  AFILL(<принимающий массив>, <выражение>,
 [<начальный элемент>], [<кол-во элементов>])
 --> принимающий массив
 
 

13.3.2.8. Function AINS()

  AINS(<принимающий массив>,<номер элемента>) --> принимающий массив
 
 

13.3.2.8.3. Description

AINS() - функция обработки массивов, которая заносит новый элемент в указанный массив. Вносимый элемент будет иметь значение NIL, пока ему не присвоят новое значение. После занесения последний элемент массива теряет свое значение, а все элементы после нового сдвигаются на одну позицию вниз.

--------------------------------------------------------------------- Предупреждение

При обработке многомерных массивов функцию AINS() следует применять с осторожностью. Многомерные массивы в Clipper строятся путем вложения одного массива в другой. При использовании функции AINS() с многомерными массивами уничтожается последний элемент в заданном массиве, что приводит к потере одного или более измерений. Для включения нового измерения в массив сначала добавьте новый элемент в конец массива, используя функцию AADD() или ASIZE() перед выполнением AINS(). ---------------------------------------------------------------------