| Note | 该命令在头文件中定义，将由 X# 预处理器预处理为函数调用。如果禁用标准头文件 (-nostddefs)，该命令将不可用。如果告诉编译器使用不同的标准头文件（-stddef ），则此命令也可能不可用。 |
用途
针对当前工作区中的一系列记录计算一系列数字表达式的总和，并将结果分配给一系列变量。
语法
SUM <nValueList> TO <idVarList> [<Scope>] [WHILE <lCondition>] [FOR <lCondition>]
参数
| <nValueList> | 要对处理的每条记录求和的值列表。 请注意，<nValueList> 是必填项，而不是其他方言中的可选项。 |
| TO <idVarList> | 定义一个或多个变量的列表，用于分配求和的结果。 如果列表中的变量引用不明确(即在编译时未声明或未明确使用别名限定)，则假定为 MEMVAR。 如果列表中的任何变量不可见或不存在，则使用 <uValue> 创建一个私有变量。 |
| <Scope> | 当前数据库文件中要处理的部分。 默认为所有可见记录。范围可以是以下一个或多个子句： [NEXT <NEXT>] 可选择指定从源文件第一条记录开始处理的记录数。这将从源文件的第一条记录开始。 [RECORD <rec>] 可选的记录 ID 如果指定，处理将从源文件中的该数据记录开始。 [<rest:REST>] 选项 REST 可指定是否从当前记录到最后一条记录按顺序搜索。如果指定了条件，则选项 ALL 为默认值。 [ALL] 选项 ALL 指定导入源文件中的所有记录。这是默认设置。 |
| WHILE <lCondition> | 范围内每条可见记录都必须满足的条件，从当前记录开始。 一旦 while 条件失败，进程就会终止。 如果没有指定 <Scope>，while 条件会将默认范围改为文件中的其他可见记录。 |
| FOR <lCondition> | 处理范围内每条可见记录必须满足的条件。 如果某条记录不符合指定条件，则会被忽略，并处理下一条可见记录。 如果没有指定 <Scope> 或 WHILE 子句，则 for 条件会将默认范围改为所有可见记录。 |
示例
本例说明了 SUM 的使用：
LOCAL nTotalPrice, nTotalAmount
USE sales NEW
SUM Price * .10, Amount TO nTotalPrice, nTotalAmount
? nTotalPrice // Result: 151515.00
? nTotalAmount // Result: 150675.00
程序集
XSharp.RT.DLL
参见
AVERAGE, COUNT, DBEval(), TOTAL
