COUNT 命令

对当前视图中的记录总数进行计数，或者仅对那些满足指定条件的记录进行计数。

语法

COUNT <IF 测试> <WHILE 测试> <FIRST 范围|NEXT 范围>

参数

名称	描述
IF 测试可选	一个条件表达式，它必须为真以便处理每个记录。仅对满足条件的那些记录执行该命令。说明在应用任何范围参数（WHILE、FIRST、NEXT）之后，仅针对表中的剩余记录评估 IF 条件。
WHILE 测试可选	一个条件表达式，它必须为真以便处理每个记录。该命令被一直执行到条件的计算结果为假或者到达表的末尾为止。说明如果您将 WHILE 与 FIRST 或 NEXT 结合使用，请在达到一个限制时立即记下处理步骤。
FIRST 范围 \| NEXT 范围可选	要处理的记录数： FIRST 从第一个记录开始处理，直到达到指定的记录数为止 NEXT 从当前选定的记录开始处理，直到达到指定的记录数为止请使用范围指定要处理的记录数。如果您省略 FIRST 和 NEXT，则会默认处理所有记录。

名称

描述

IF 测试

可选

一个条件表达式，它必须为真以便处理每个记录。仅对满足条件的那些记录执行该命令。

说明

在应用任何范围参数（WHILE、FIRST、NEXT）之后，仅针对表中的剩余记录评估 IF 条件。

WHILE 测试

可选

一个条件表达式，它必须为真以便处理每个记录。该命令被一直执行到条件的计算结果为假或者到达表的末尾为止。

说明

如果您将 WHILE 与 FIRST 或 NEXT 结合使用，请在达到一个限制时立即记下处理步骤。

FIRST 范围 | NEXT 范围

可选

要处理的记录数：

FIRST 从第一个记录开始处理，直到达到指定的记录数为止
NEXT 从当前选定的记录开始处理，直到达到指定的记录数为止

请使用范围指定要处理的记录数。

如果您省略 FIRST 和 NEXT，则会默认处理所有记录。

Analytics 输出变量

名称	包含
COUNTn	该命令计算出的记录计数。如果变量名为 COUNT1，则将存储大部分近期执行命令的记录计数。如果变量名为 COUNTn，其中 n 大于 1，则该变量将存储在 GROUP 命令内部执行的命令的记录计数。 n 的值将根据 GROUP 中命令的行号进行分配。例如，如果 GROUP 命令下的命令只有一行，则将分配值 COUNT2。如果 GROUP 命令下的命令有四行，则将分配值 COUNT5。

名称

包含

COUNTn

该命令计算出的记录计数。

如果变量名为 COUNT1，则将存储大部分近期执行命令的记录计数。
如果变量名为 COUNTn，其中 n 大于 1，则该变量将存储在 GROUP 命令内部执行的命令的记录计数。
n 的值将根据 GROUP 中命令的行号进行分配。例如，如果 GROUP 命令下的命令只有一行，则将分配值 COUNT2。如果 GROUP 命令下的命令有四行，则将分配值 COUNT5。

示例

存储 COUNT1

COUNT 命令的结果被存储在 COUNT1 输出变量中。您可以检索此值并将其存储在用户定义的变量中。

COUNT 命令每次执行时都会覆盖 COUNT1 变量，因此在将过滤器应用于该表后且再次执行该命令之前，需要将该值存储在用户定义的变量中：

OPEN CustomerAddress 
COUNT 
TotalRec = COUNT1 
SET FILTER TO ModifiedDate > '20100101' 
COUNT 
TotalFilteredRec = COUNT1

备注

何时使用 COUNT

使用 COUNT 命令统计 Analytics 表中的记录数，或者统计符合特定测试条件的记录数。如果未指定测试，则显示 Analytics 表中的记录总数。

过滤器如何影响 COUNT

如果已对视图应用了过滤器，则该命令会在应用过滤条件后统计视图中剩余的记录数。