Count

Description

Calculates the total number of rows in the specified column.

Syntax

Count ( column { FOR range { DISTINCT { expres1 {, expres2 {, ... } } } } } )

Argument

Description

column

The column for which you want the number of rows. Column can be the column name or the column number preceded by a pound sign (#). Column can also be an expression that includes a reference to the column.

FOR range (optional)

The data that will be included in the count. For most presentation styles, values for range are:

  • ALL – (Default) The count of all rows in column.

  • GROUP n – The count of rows in column in the specified group. Specify the keyword GROUP followed by the group number: for example, GROUP 1.

  • PAGE – The count of the rows in column on a page.

For Crosstabs, specify CROSSTAB for range:

  • CROSSTAB – (Crosstabs only) The count of all rows in column in the crosstab.

For Graph and OLE objects, specify one of the following:

  • GRAPH – (Graphs only) The count of values in column in the range specified for the Rows option.

  • OBJECT – (OLE objects only) The count of values in column in the range specified for the Rows option.

DISTINCT (optional)

Causes Count to consider only the distinct values in column when counting the rows. For a value of column, the first row found with the value is used and other rows that have the same value are ignored.

expresn (optional)

One or more expressions that you want to evaluate to determine distinct rows. Expresn can be the name of a column, a function, or an expression.

Usage

If you specify range, Count determines the number of rows in column in range. If you specify DISTINCT, Count returns the number of the distinct rows displayed in column, or if you specify expresn, the number of rows displayed in column where the value of expresn is distinct.

For graphs and OLE objects, you do not select the range when you call the function. The range has already been determined by the Rows setting on the Data property page (the Range property), and the aggregation function uses that range.

Settings for Rows include the following:

Null values in the column are ignored and are not included in the count.

NoteNot in validation rules or filter expressions You cannot use this or other aggregate functions in validation rules or filter expressions.

Using an aggregate function cancels the effect of setting Retrieve Rows As Needed in the painter. To do the aggregation, a DataWindow object always retrieves all rows.

Examples

Example 1

This expression returns the number of rows in the column named emp_id that are not null:

Count(emp_id)

Example 2

This expression returns the number of rows in the column named emp_id of group 1 that are not null:

Count(emp_id for group 1)

Example 3

This expression returns the number of dept_ids that are distinct:

Count(dept_id for all DISTINCT)

Example 4

This expression returns the number of regions with distinct products:

Count(region_id for all DISTINCT Lower(product_id))

Example 5

This expression returns the number of rows in column 3 on the page that are not null:

Count(#3 for page)

See also