Note | 该命令在头文件中定义,将由 X# 预处理器预处理为函数调用。如果禁用标准头文件 (-nostddefs),该命令将不可用。如果告诉编译器使用不同的标准头文件(-stddef ),则此命令也可能不可用。 |
为数组中的每一行在当前选定的表中添加一条记录,并用相应数组行的数据填充每条记录。
APPEND FROM ARRAY <ArrayName> [FOR <lCondition>]
[FIELDS <idFieldList> | FIELDS LIKE <Skeleton> | FIELDS EXCEPT <Skeleton>]
<ArrayName> | 指定包含要复制到新记录中的数据的数组名称。新记录会被添加到表中,直到数组中的所有记录都被附加。 |
FIELDS <idFieldList> | 要处理的字段列表。默认为所有字段,备注字段除外,除非命令支持 MEMO 子句。 |
只有两个文件中名称和类型相同的字段才会被附加。 如果相同名称的字段在数据类型上不匹配,则会出现运行时错误。 |
FIELDS LIKE <Skeleton> | 可以使用通配符指定字段名称,例如 FIELDS LIKE *name |
FIELDS EXCEPT <Skeleton> | 可以排除主键等字段: FIELDS EXCEPT Id <Skeleton> 支持使用通配符(* 和 ?)。 例如,要替换所有以字母 A 和 P 开头的字段,请使用 FIELDS LIKE A*,P* |
请注意,您可以将 FIELDS LIKE 和 FIELDS EXCEPT 结合使用,但不能将字段列表与 LIKE 和 EXCEPT 子句结合使用。
FOR <lCondition> | 处理范围内每条可见记录必须满足的条件。 如果某条记录不符合指定条件,则会被忽略,并处理下一条可见记录。 如果没有指定 <Scope> 或 WHILE 子句,则 for 条件会将默认范围改为所有可见记录。 |