Returns the number of entries for a given key item. This number was calculated during the last statistical calculation.
// Calculate statistics about the CustName key from the Customer data file
ResStat = HStatNbRec(Customer, CustName)
<Result> = HStatNbRec([<Data file> [, <Key item>]])
Number of entries found for the specified item.
Corresponds to the hInvalidRecNum constant if:
- the statistics have never been calculated for the specified item.
- the statistics are not supported by the specified type of item. HFSQL allows you to perform statistical calculations on key items only.
<Data file>: Optional character string
Name of the data file used. If this name is not specified, HStatNbRec will use the last data file used by the last HFSQL function (function starting with "H").
<Key item>: Optional character string
Name of the key item used to calculate statistics. If this name is not specified, HStatNbRec will use the last item used by the last HFSQL management function (function starting with "H").
- The statistics can be updated by HIndex and HStatCalculate.
- In the HFSQL Classic data files, the statistical calculations can only be performed on key items.