Connection Information

To perform the requested action, WordPress needs to access your web server. Please enter your FTP credentials to proceed. If you do not remember your credentials, you should contact your web host.

Connection Type

Count – PB Docs 125 – PowerBuilder Library

Count – PB Docs 125

Count DataWindow expression function

Description

Calculates the total number of rows in the specified column.

Syntax

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:

  • For the Graph or OLE presentation
    style, Rows is always All.

  • For Graph controls, Rows can be All, Page, or Group.

  • For OLE controls, Rows can be All, Current Row,
    Page, or Group. The available choices depend on the layer the control
    occupies.

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

note.png Not 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

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

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

This expression returns the number of dept_ids
that are distinct:

This expression returns the number of regions with
distinct products:

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

See Also


Document get from Powerbuilder help
Thank you for watching.
Was this article helpful?
Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x