ENUMERATE

ENUMERATE, ENUM

Top  Previous  Next

 

The ENUMERATE field qualifier keyword causes a field to be reported together with a count of values. The synonym ENUM may be used.

 

 

Format

 

ENUM field {field.qualifiers} {NO.NULLS}

 

where

 

fieldis the field or evaluated expression to be displayed.

 

field.qualifiers are other field qualifying keywords

 

NO.NULLScauses null values to be ignored.

 

 

The ENUMERATE field qualifier keyword is placed before the field name to which it applies and causes the query processor to report the value of the field for each record processed and also to report the number of values at the end of the report. Used with breakpoints, the ENUMERATE keyword will also report the number of values at each breakpoint.

 

If the field is defined as multivalued, the ENUMERATE keyword counts each value.

 

The NO.NULLS keyword can be used to ignore null values.

 

 

Example

 

The command

 

LIST INVOICES ENUMERATE VALUE CUSTOMER.NAME WITH NO AMT.PAID

 

would produce a display such as that below in which the number of items in the VALUE field is shown at the end of the report.

 

LIST INVOICES ENUMERATE VALUE CUSTOMER.NAME WITH NO AMT.PAID

Invoice  ...Value  Customer...................

74529    £1712.43  J McTavish

74273      £95.23  County Newspapers

63940     £141.00  R Bryant

74993       £9.29  Write Right Stationery

        ========

               4

4 records listed.