| 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 | Включает/отключает режим контроля измений атрибутов. |
A2EDIT(<nTop>, <nLeft>, <nBottom>, <nRight>, <aData>, <cUserFunc>, <aSay>, <aHeaders>, <aHeadSep>, <aColSep>, <aFootSep>, <aFooters>) --> NIL
| <nTop> | Numeric, верхняя координата A2EDIT() окна. |
| <nLeft> | Numeric, левая координата. |
| <nBottom> | Numeric, нижняя координата. |
| <nRight> | Numeric, правая координата. |
| <aData> | Array, массив для просмотра. |
| <cUserFunc> | String, имя функции пользователя. |
| <aSay> | Array, шаблоны для представления содержимого колонок. |
| <aHeaders> | Array, заголовки колонок. |
| <aHeadSep> | Array or character, разделители колонок заголовков. |
| <aColSep> | Array or character, разделители колонок. |
| <aFootSep> | Array or character, разделители колонок подвала. |
| <aFooters> | Array, строки подписей к колонкам. |
A2EDIT() возвращает NIL.
A2EDIT() - это функция работы с массивом, которая предназначена для просмотра 2-мерного массива.
A2EDIT() это таже DBEDIT(), но только работает с массивом, а не с БД.
Не зависит от платформ
AADD(<имя массива>, <выражение>[, <keyValue>]) --> значение
AADD преобразует <выражение> и возвращает его значение. Если <выражение> не задано, AADD() возвращает NIL.
AADD() - это функция обработки массивов, которая увеличивает текущую длину указанного массива на единицу. Вновь созданному элементу присваивается значение, заданное аргументом <выражение>.
AADD() используется для динамического наращивания массивов. Это полезно для построения динамических списков и очередей. Примером может служить массив Getlist, используемый системой GET для хранения GET- объектов. После команд READ или CLEAR GETS, Getlist становится пустым массивом. Каждый раз, когда выполняется команда @...GET, система GET использует функцию AADD() для добавления нового элемента в конец массива Getlist и затем назначает новый GET-объект новому элементу.
AADD() похожа на ASIZE(), но добавляет только один элемент за вызов; ASIZE() может нарастить или сжать массив до заданного размера. AADD(), однако, имеет то преимущество, что может присваивать значение новому элементу, в то время как ASIZE() этого сделать не может. AADD() так же кажется похожей на функцию AINS(), однако они различны. AINS() перемещает элементы внутри массива, но она не может изменять длину массива.
Примечание. Если аргумент <выражение> - это тоже массив, то новый элемент в указанном массиве будет содержать ссылку на массив, заданный аргументом <выражение>.
AADD() может принимать в качестве параметра <имя массива> объект. В этом случае <keyValue> это хэш-код нового элемента.
Не зависит от платформ
ACLONE(<массив>) --> дублированный массив
ACLONE() возвращает дубликат массива <массив>.
ACLONE() - это функция обработки массивов, создающая полный дубликат массива <массив>. Если массив <массив> содержит подмассивы, ACLONE() создает соответствующие подмассивы и заполняет их копиями значений подмассивов массива <массив>. ACLONE() подобна ACOPY(), но ACOPY() не может дублировать вложенные массивы.
ACOPY(<исходный массив>,<принимающий массив>, [<начальный элемент>],[<кол-во элементов>], [<нач. элемент принимающего массива>]) --> принимающий массив
| <исходный массив> | - массив, из которого копируются элементы. |
| <принимающий массив> | - массив, в который копируются элементы. |
| <начальный элемент> | - позиция начального элемента в массиве <исходный |
| массив>. Если она не определена, то по умолчанию принимается равной | |
| единице. | |
| <кол-во элементов> | - количество элементов, которое необходимо |
| скопировать из массива <исходный массив>, начиная с позиции | |
| <начальный элемент> | . Если значение <кол-во элементов> не задано, |
| копируются все элементы, начиная со значения <начальный элемент>. | |
| <нач. элемент принимающего массива> | - начальная позиция в массиве |
| <принимающий массив> | , начиная с которой принимаются копируемые |
| элементы. Если не определено, то по умолчанию - с первого элемента. | |
ACOPY() возвращает ссылку на принимающий массив <принимающий массив>.
ACOPY() - это функция работы с массивами, которая копирует элементы массива <исходный массив> в массив <принимающий массив>. Массив <принимающий массив> должен быть создан до начала работы функции и иметь достаточно большой размер, чтобы принять копируемые элементы. Если массив <исходный массив> содержит избыточное количество элементов, лишние элементы не будут копироваться.
ACOPY() копирует все типы данных, включая NIL и блок кода. Если какой-либо элемент массива <исходный массив> является подмассивом, соответствующий элемент массива <принимающий массив> будет содержать ссылку на подмассив. Таким образом, ACOPY() не создает полную копию многомерного массива. Для того, чтобы сделать это, используйте функцию ACLONE().
ADEL(<принимающий массив>, <номер элемента>) --> принимающий массив
ADEL() возвращает ссылку на указанный <принимающий массив>.
ADEL() - функция обработки массивов удаляет один элемент массива. Значение указанного элемента пропадает и все следующие за ним элементы сдвигаются на одну позицию вверх. Последний элемент массива принимает значение NIL.
--------------------------------------------------------------------- Предупреждение
В Clipper многомерные массивы создаются путем вложения одних массивов в другие. Если массив <принимающий массив> является многомерным, ADEL() удалит весь подмассив, определенный в <номер элемента>. ---------------------------------------------------------------------
AEVAL(<имя массива>, <блок кода>, [<начальный элемент>], [<кол-во элементов>]) --> имя массива
| <имя массива> | - имя массива для обработки. |
| <блок кода> | - блок кодов, предназначенных для обработки каждого |
| элемента массива. | |
| <начальный элемент> | - номер первого обрабатываемого элемента массива. |
| Если <начальный элемент> не определен, то по умолчанию принимается | |
| первый элемент. | |
| <кол-во элементов> | - количество элементов, которое необходимо |
| обработать начиная с элемента с номером <начальный элемент>. | |
| Если <кол-во элементов> не определено, то по умолчанию | |
| обрабатываются все элементы. | |
AEVAL() возвращает ссылку на <имя массива>.
AEVAL() - функция работы с массивами, которая выполняет блок кода для каждого элемента массива, передавая этот элемент в блок кода как параметр. Возвращаемое значение блока игнорируется. Если не определены параметры <начальный элемент> и <кол-во элементов>, обрабатываются все элементы массива. AEVAL() работает аналогично функции DBEVAL(), которая обрабатывает блоком кода каждую запись файла базы данных. Подобно DBEVAL(), AEVAL() можно использовать как примитив для построения итерационных команд при обработке массивов с простой и сложной структурами. За более подробной информацией о теории и синтаксисе блоков кода обращайтесь к разделу "Блок кода" в главе "Основные концепции"
AFILL(<принимающий массив>, <выражение>, [<начальный элемент>], [<кол-во элементов>]) --> принимающий массив
| <принимающий массив> | - массив, подлежащий заполнению. |
| <выражение> | - значение, которое заносится в каждый элемент массива |
| <принимающий массив> | . Может быть выражением любого допустимого типа. |
| <начальный элемент> | - номер первого заполняемого элемента. Если не |
| указан, по умолчанию заполняется с первого элемента. | |
| <кол-во элементов> | - количество заполняемых элементов, начиная с |
| элемента с номером <начальный элемент> и до конца массива. | |
AFILL() возвращает ссылку на массив <принимающий массив>.
AFILL() - функция обработки массивов, которая заполняет указанный массив одним значением любого допустимого типа ( включая массивы блоков кода, NIL ) путем присвоения значения <выражение> каждому его элементу в заданных границах.
--------------------------------------------------------------------- Предупреждение
AFILL() нельзя использовать для заполнения многомерных массивов. Многомерные массивы в Clipper формируются путем вложения одних массивов в другие. Чтобы использовать функцию AFILL() для многомерных массивов, перепишите подмассивы, используемые для других измерений массива. ---------------------------------------------------------------------
AINS(<принимающий массив>,<номер элемента>) --> принимающий массив
AINS() возвращает ссылку на массив <принимающий массив>.
AINS() - функция обработки массивов, которая заносит новый элемент в указанный массив. Вносимый элемент будет иметь значение NIL, пока ему не присвоят новое значение. После занесения последний элемент массива теряет свое значение, а все элементы после нового сдвигаются на одну позицию вниз.
--------------------------------------------------------------------- Предупреждение
При обработке многомерных массивов функцию AINS() следует применять с осторожностью. Многомерные массивы в Clipper строятся путем вложения одного массива в другой. При использовании функции AINS() с многомерными массивами уничтожается последний элемент в заданном массиве, что приводит к потере одного или более измерений. Для включения нового измерения в массив сначала добавьте новый элемент в конец массива, используя функцию AADD() или ASIZE() перед выполнением AINS(). ---------------------------------------------------------------------
ASCAN(<aArr>, <Expression>, [<nStart>], [<nCount>], [lBack]) --> <nStoppedAt>
Возвращает числовое значение, соответствующее позиции в массиве последнего просмотренного элемента.
ASCAN() просматривает массив <aArr> до совпадения со значением <Expression> или пока кодовый блок <Expression > возвращает TRUE. ASCAN() использует для сравнения оператор (=).
В CLIP добавлен новый параметр <lBack> для просмотра массива с конца.
Не зависит от платформ
__Fledit( <aSrc>, <aList>) -> <aSelected>
Массив, содержащий отобранные поля.
__FlEdit ищет соответствие для каждого элемента массива <aList> в массиве <aSrc> по имени (<aList>[1] - DBS_NAME). Если элемент обнаружен, то соответствующий элемент <aSrc> добавляется в возвращаемый массив <aSelected>. Соответствие остальных подэлементов (DBS_TYPE, DBS_LEN, DBS_DEC) не проверяется.
Функция __Fledit не документирована (но активно используется) в CLIPPER.
Евгений Бондарь
Не зависит от платформы
FT_AADDITION( <aList1>, <aList2> [, <lTrimmer> [, <lCaseSens> ] ] ) ; -> aNewArray
| <aList1> | is the primary array. |
| <aList2> | is the secondary array. |
| <lTrimmer> | is a logical value denoting whether leading or |
| trailing spaces should be included in the | |
| comparison. If .T., then ignores spaces in | |
| comparison, defaults to .T., .F. includes spaces. | |
| <lCaseSens> | is a logical value denoting case sensitivity. |
| If .T., then comparison is sensitive to case, | |
| defaults to .T., .F. ignores case. |
An array of the union of aList1 and aList2.
This function will add the elements unique of aList2 with aList1. It returns a new array including all the elements of aList1 plus the unique elements of aList2.
FT_AAVG( <aArray> [, <nStartIndex> [, <nEndIndex> ] ] ) -> nAverage
The average of the specified array elements.
This function is used to get a numeric average of selected or all elements of an array.
This routine requires FT_ASUM().
FT_ADESSORT( <aArray> [, <nStartIndex> [, <nEndIndex> ] ] ) -> aSorted
The array, sorted in descending order.
This function is used to sort an array in descending order, i.e., Z-A
FT_AEMAXLEN( <aArray> [, <nDimension> [, <nStart> [, <nCount> ] ] ] ) ; -> nMaxlen
| <aArray> | is the array containing the elements to be measured. |
| <nDimension> | is the array dimension to be measured, |
| defaults to first dimension. | |
| <nStart> | is the starting array element to include, |
| defaults to first array element. | |
| <nCount> | is the number of array elements to process from |
| from <nStart>, defaults to remaining elements | |
| in array. |
The length of the longest size element of an array.
This function will measure each element of an array dimension and return the longest element.
FT_AEMINLEN( <aArray> [, <nDimension> [, <nStart> [, <nCount> ] ] ] ) -> nMinlen
| <aArray> | is the array containing the elements to be measured. |
| <nDimension> | is the array dimension to be measured, |
| defaults to first dimension. | |
| <nStart> | is the starting array element to include, |
| defaults to first array element. | |
| <nCount> | is the number of array elements to process from |
| from <nStart>, defaults to remaining elements | |
| in array. |
The length of the shortest size element of an array.
This function will measure each element of an array dimension and return the shortest element.
FT_AMEDIAN( <aArray> [, <nStart> [, <nEnd> ] ] ) -> nMedian
The median average of the array elements
This function sorts the elements of a numeric array and then returns the value in the middle element of the sorted array. If there is no exact middle value, then it returns the average of the two middle values. Half of the elements are > median and half are < median. A median average may more reflect a more useful average when there are extreme values in the set.
FT_ANOMATCHES( <aArray>, <bCompareBlock> ; [, <nStartIndex> [, <nEndIndex> ] ] ) -> nNoOfMatches
| <aArray> | is the array to be searched |
| <bCompareBlock> | is a code block containing the expression for |
| the array elements to be tested with. Each element is passed | |
| as a parameter to the block. If the block returns .T., the | |
| number of matches will be incremented by one. | |
| <nStartIndex> | is the first array item to include in the search, |
| defaults to first element. | |
| <nEndIndex> | is the last array element to include in the search, |
| defaults to all elements. |
The number of elements that cause the code block to return .T.
This function returns the number of array elements that, when passed to the supplied code block, cause that code block to return a .T. value.
FT_AREDIT( <nTop>, <nLeft>, <nBottom>, <nRight>, <Array Name>, ; <nElem>, <aHeadings>, <aBlocks> [, <bGetFunc> ] ) -> xElement
| <nTop> | , <nLeft>, <nBottom>, <nRight> are coordinates for TBrowse |
| <Array Name> | is name of 2 dimensional to array edit |
| <nElem> | is pointer for element in array |
| <aHeadings> | is array of column headings |
| <aBlocks> | is array of blocks describing each array element |
| [ <bGetFunc> ] is get editing function for handling individual elements |
Value of element positioned on when exit FT_AREDIT() The type of this value depends on what is displayed.
This function allows you to position yourself in an array, add and delete rows with the <F7> and <F8> keys, and pass a UDF with information to edit the individual gets.
FT_ASUM( <aArray> [, <nStartIndex> [, <nEndIndex> ] ] ) -> nSum
The sum of the elements of the array or the lengths of the elements.
This function is to sum the elements of a numeric array or to sum the lengths of a character array.
FT_RESTARR( <cFileName>, <nErrorCode> ) -> aArray
Return an array variable.
FT_RESTARR() restores an array which was saved to a disc file using FT_SAVEARR().
[10/1/92 Librarian note:
This function does not appear to work with multi-dimensional arrays. If you'd care to modify it to support this feature, please do and send it to Glenn Scott 71620,1521.]
FT_SAVEARR( <aArray>, <cFileName>, <nErrorCode> ) -> lRet
.F. if there was a DOS file error or the array contained code blocks, otherwise returns .T.
FT_SAVEARR() saves any Clipper array, except those containing compiled code blocks, to a disc file. The array can be restored from the disc file using FT_RESTARR().
[10/1/92 Librarian note:
This function does not appear to work with multi-dimensional arrays. If you'd care to modify it to support this feature, please do and send it to Glenn Scott 71620,1521.]
MAP() --> <oObject>
No arguments
Возвращает пустой объект.
Map() создает новый пустой объект (ассоциативный массив) и возвращает его.
MAPMODIFY(<oObj>, <lMode>) --> <lOldMode>
Возвращает логическое значение - старое значение режима контроля.
MAPMODIFY() включает/отключает режим контроля изменения атрибутов.
Если <lMode> TRUE и объект <oObj> содержит метод <Modify>, то перед изменением значения атрибута будет автоматически вызван метод oObj:Modify(<nHashAttr>, <vNewValue>). Где <nHashAttr> хэш-код изменяемого атрибута, <vNewValue> новое значение атрибута. Метод <Modify> должен вернуть реальное значение, которое будет присвоено модифицируемому атрибуту.
| Пред. | Начало | След. |
| SYSTEM | Уровень выше | ENVIRONMENT |