ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / Managing databases / HFSQL / Managing statistics
  • Statistics on composite keys
  • Miscellaneous
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Returns an estimate regarding the number of entries for a given key item in a given interval of values. This estimate is deduced from the information obtained during the last statistical calculation.
Example
// Calculate statistics for the CustomerName key in the Customer data file
ResStat = HStatNbRecRange(Customer, CustName, "Clark", "Smith")
Syntax
<Result> = HStatNbRecRange([<Data file> [, <Key item>, ]] <Lower bound> , <Upper bound>)
<Result>: Integer
Number of entries found for the specified item in the requested interval.
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, HStatNbRecRange 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, HStatNbRecRange will use the last item used by the last HFSQL management function (function starting with "H").
<Lower bound>: Type of key item
Lower value of interval.
<Upper bound>: Type of key item
Upper value of interval.
Remarks

Statistics on composite keys

The following syntax allows you to calculate statistics on a composite key:
HStatNbRecRange(<Data file>, <Name of composite key>),
[<Lower bound of first element of composite key>,
<Lower bound of second element of composite key>],
[<Upper bound of first element of composite key>,
<Upper bound of second element of composite key>, ...])

Example:
HStatNbRecRange(Customer, LastName_FirstName, ["Black", "Alicia"], ["Morgan","Vince"])

Miscellaneous

  • 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.
Component: wd300hf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/04/2024

Send a report | Local help