Команда APPEND FROM ARRAY

Добавляет одну запись в выбранную в данный момент таблицу для каждой строки массива и заполняет каждую запись данными из соответствующей строки массива.

Синтаксис

APPEND FROM ARRAY ArrayName
[FOR lExpression]
[FIELDS FieldList]

Параметры

ArrayName

Задает имя массива, содержащего данные, которые следует копировать в новые записи. Новые записи добавляются в таблицу до тех пор, пока не будут добавлены все строки массива.

Одномерные массивы

Если массив одномерный, команда APPEND FROM ARRAY добавляет в таблицу одну запись. Содержимое первого элемента массива заносится в первое поле вновь добавлен ой записи, содержимое второго элемента массива во второе поле записи и т.д.

Если в одномерном массиве больше элементов, чем полей в таблице, лишние элеме ты игнорируются. Если в таблице больше полей, чем элементов в массиве, лишние поля инициализируются "пустыми" значениями, принимаемыми по умолчанию. Ниже п иведены такие значения для каждого типа поля:

Тип поля	Значение по умолчанию
Character	Пробелы
Numeric	0
Currency	0
Float	0
Integer	0
Double	0
Date	Пустая дата (CTOD(''))
DateTime	Пустая дата.время ( CTOT(''))
Logical	Пусто (/ /)
Memo	Пусто (нет содержимого)

Двумерные массивы

Если в команде участвует двумерный массив, новая запись добавляется к таблице ля каждой строки массива. Например, если в массиве четыре строки, к таблице бу ут присоединены четыре новые записи.

Содержимое первого столбца массива заносится в первые поля вновь добавленных записей, содержимое второго столбца во вторые поля новых записей и т.д. Например, если массив состоит из четырех строк и трех столбцов, элементы первого столбца заполнят первые поля каждой из четырех новых записей, присоединенных к таблице.

Если в двумерном массиве больше столбцов, чем полей в таблице, лишние столбцы игнорируются. Если в таблице больше полей, чем столбцов в массиве, лишние поля инициализируются "пустыми" значениями (см. выше).

FOR lExpression

Задает условие добавления записей из массива. Выражение lExpression должно содержать имя поля назначения в его условном выражении.

Перед добавлением строки массива к записи в таблице проверяется элемент массива, который соответствует полю назначения, заданному выражением lExpression. Если элемент массива удовлетворяет условию lExpression, запись добавляется.

Если элемент массива не удовлетворяет этому условию, строка массива не добав яется и проверяется следующая строка массива удовлетворяет она условию или нет.

FIELDS FieldList

Указывает, что обновлять данными из массива следует только поля, приведенные в списке FieldList. Первое поле в списке обновляется содержимым первого элемента массива, второе поле содержимым второго элемента и т.д.

Несоответствие типов данных

Команда APPEND FROM ARRAY может заполнить поле даже в том случае, если тип дан ых соответствующего элемента массива не совпадает с типом данных поля, но при условии, что данные элемента совместимы с типом данных этого поля. Если данные есовместимы, поле инициализируется пустым значением.

Комментарии

Memo-поля и поля типа General игнорируются командой APPEND FROM ARRAY. Когда таблица открыта для совместного использования, команда APPEND FROM ARRAY блоки ует заголовок таблицы на время добавления записей.