HStatNbDuplicates (Function)

ONLINE HELP
FOR WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

Management of databases

Management of statistics

HStatNbDuplicates

Presentation

Example

See also

HStatNbDuplicates (Function)

In french: HStatNbDoublon

Available only with these kinds of connection

Returns the number of duplicates for a given key item. This number of duplicates was calculated during the last calculation of statistics.

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Note: From version 19, HFSQL is the new name of HyperFileSQL.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Versions 22 and later

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the Java applications.

This function is now available for the Android applications.

New in version 22

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the Java applications.

This function is now available for the Android applications.

This function is now available for the iPhone/iPad applications.

This function is now available in Android Widget mode.

This function is now available for the Java applications.

This function is now available for the Android applications.

Example

// Calculate statistics about the duplicates on the CUSTNAME key of CUSTOMER file
ResStat = HStatNbDuplicates(CUSTOMER, CUSTNAME)

Syntax

<Result> = HStatNbDuplicates([<File Name> [, <Name of Key Item>]])

<Result>: Integer

Number of duplicates found. 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.

<File Name>: Optional character string (with or without quotes)

Name of data file used. If this name is not specified, HStatNbDuplicates handles the last data file used by the last function for HFSQL management (starting with the letter H).

<Name of Key Item>: Optional character string (with or without quotes)

Name of key item used to perform the statistical calculation. If this name is not specified, HStatNbDuplicates handles the last item used by the last function for HFSQL management (starting with the letter H).

Remarks

The statistics can also be updated by HIndex. HIndex and HStatCalculate are the only two functions that update the statistics of the data file.
In the HFSQL Classic data files, the statistical calculations can only be performed on key items.
The number of duplicates corresponds to the total numer of entries less the number of distinct values. For example, if the entries are the numbers: 1, 3, 3, 5, 5, 5, 6, 7, 7, 7, 8, 9, then the number of duplicates is 12-7 = 5.

Component : wd240hf.dll