ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / Managing databases / Managing xBase files / WLanguage functions
  • Using space characters in the parameters
  • Describing an index
  • Limitations
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
HDBDescribeIndex (Function)
In french: HDBDecritIndex
Native Connectors (Native Accesses)HFSQL ClassicAvailable only with these kinds of connection
Describes through programming the different index files that will be created. An index file must be described for each search key. The created index file will be in dBase 3 format.
Remark: The data file and index files described will be created using the HDBCreation function (dBase 3 format only).. Therefore, the indexes with a format other than NDX cannot be created by HDBDescribeIndex.
Example
HDBDescribeFile("CUSTOMER", "DA", "C:\FILE\CUSTOMER.DBF")
HDBDescribeField("LASTNAME,C,20")
HDBDescribeField("FIRSTNAME,C,20")
HDBDescribeField("MARRIED,L")
HDBDescribeField("DOB,D")
HDBDescribeField("INFO,M")
HDBDescribeIndex("C:\FILE\LASTNFILE.NDX", "LASTNAME")
HDBDescribeIndex("C:\FILE\LNFNFILE.NDX", "FULLNAME,C,40", "LASTNAME+FIRSTNAME")
HDBCreation()
Syntax
<Result> = HDBDescribeIndex(<Full name of index file> , <Name of key item> , <Expression of composite key>)
<Result>: Boolean
  • True if the operation was performed,
  • False if a problem occurs. HError is used to identify the error.
<Full name of index file>: Character string
Access path to index file and full file name (with the extension)
<Name of key item>: Character string
  • Simple key name: this is the name of a heading in the file.
  • Name and type of composite key. <Name of key item> has the following format "<Name_CompKey>,<KeyType>":
    <Name_CompKey>Name of composite key
    <KeyType>Type of key:
    • C,<Taille> Text type heading, <Taille> is the size of the string
    • N,<Taille>,<NbDecimale>: Numerical type heading. <Size> is the size of numeric value, <NbDecimals> is the number of decimals in the numeric value.
    • L: Boolean type field.
    • D: Date field (in "YYMMDD" format).
    • M: Text memo type heading.
<Expression of composite key>: Character string
Expression of composite key to use.
Remarks

Using space characters in the parameters

The parameters must not be separated by space characters; for example, you must not write:
HDBDescribeIndex("C:\FILE\LNFNFILE.NDX", "FULLNAME, C, 40", "LASTNAME+FIRSTNAME")
You must write:
HDBDescribeIndex("C:\FILE\LNFNFILE.NDX", "FULLNAME,C,40", "LASTNAME+FIRSTNAME")

Describing an index

  • An error 1009 will be generated if the file is already opened during the call to HDBDescribeIndex.
  • The maximum size of an item:
    • cannot exceed 254 characters for a non-key text item.
    • cannot exceed 100 characters for a key text item.
    • cannot exceed 19 digits in the integer part and 15 digits in the decimal part for a numeric item.
  • To use HDBDescribeIndex, the file must be described by HDBDescribeFile.

Limitations

This function is not available when using a stand-alone executable.
Component: wd300hf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 11/23/2024

Send a report | Local help