ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / Managing databases / HFSQL / HFSQL functions
  • Order of items
  • Displaying the result in a List Box or Combo Box control
  • HFSQL type
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 the list of items in a data file (query or view) recognized by the HFSQL engine. The data files defined by <Source>.Declare, <Source>.DeclareExternal and <Source>.DescribeFile are taken into account.
Example
// Retrieve items of a data file from current analysis
ItemList is string
ItemList = Customer.ListItem(hLstDetail)
 
// Add the list of items into COMBO_COMBO1
COMBO_COMBO1.Add(ItemList)
// Run a "SELECT *" query and interrogate the items
dsListCITY is Data Source
sListItm is string
sRecContent is string
sQry is string = "SELECT * FROM ZIPCODES WHERE ZIPCODE ='34000'"
 
// Execute query
dsListCITY.ExecuteSQLQuery(hQueryDefault, sQry)
// List the items of the query.
sListItm = dsListCITY.ListItem()
 
// Loop through the query
FOR EACH dsListCITY
sRecContent = ""
// The items must be browsed for each record
FOR EACH STRING sAnItem OF sListItm SEPARATED BY CR
sRecContent += {"dsListCITY." + sAnItem, indItem}
END
Info("Content of the record: " + sRecContent)
END
Syntax

Listing the items of a data file Hide the details

<Result> = <Source>.ListItem([<Path of the WDD file> [, <Password of the WDD file> [, <Options>]]])
<Result>: Character string
List of items found in the specified data file. The descriptions of each item are separated by CR characters (Carriage Return). The result is more or less detailed depending on the constant used:
hLstDetail is not specified<Name of item 1> + CR + <Name of item 2> + CR + ...
hLstDetail is specified<Name of item 1> + TAB + <Type> + TAB + <HFSQL type> + TAB + <Size> + TAB + <Number of indices> + TAB + <Caption> + CR + ...
hLstDetailPlus<Name of item 1> + TAB + <Type> + TAB + <HFSQL type> + TAB + <Size> + TAB + <Number of indices> + TAB + <Caption> + TAB + <Integer part of numeric items> + TAB + <Decimal part of numeric items> + CR + ...
Where:
  • <Name of item X>: Item name
  • <Type>: Type of item: "T" for text (and currency) or "N" for numeric
  • <HFSQL type>: HFSQL type of item. For more details, see Remarks.
  • <Size>: Item size
  • <Number of indices>: Number of elements in the array
  • <Caption>: Item caption.
  • <Integer part of numeric items>: Number of digits in the integer part of numeric items
  • <Decimal part of numeric items>: Number of digits in the decimal part of numeric items
Java In Java, <Caption> corresponds to the name of item.
<Source>: Type corresponding to the specified source
Name of the data file (query or view) whose items will be listed.
If a query name is specified, this query must be currently run (<Source>.ExecuteQuery or <Source>.ExecuteSQLQuery) in order for <Source>.ListItem to operate. Otherwise, a WLanguage error occurs.
<Path of the WDD file>: Optional character string
Full path of analysis (.WDD file) where the data file is described. If this parameter is not specified or if it is equal to an empty string (""), the data file is sought in the current analysis.
Java This parameter is ignored. The data file is sought in the current analysis.
<Password of the WDD file>: : Optional character string
Password defined for the analysis. If no password is defined, this parameter must be equal to an empty string ("").
Java This parameter is ignored.
<Options>: Optional Integer constant (or combination of constants)
Type of list to perform:
hLstAllLists all the type of items (hLstItem + hLstMemo + hLstKey + hLstCompositeKey)
Hyper File 5.5 This constant is ignored.
hLstCompositeKeyLists the composite key items only
Hyper File 5.5 This constant is ignored.
hLstDetailDetailed information (idem earlier versions).
hLstDetailPlusFor the numeric items, adds the number of digits in the integer part and in the decimal part.
Hyper File 5.5 This constant is ignored.
hLstItemLists the non-key and non-memo items
hLstKeyLists the key items (non-composite keys only)
Hyper File 5.5 This constant is ignored.
hLstLogicalOrderSorts the list in logical order of items (ignored if hLstSorted is specified)
Hyper File 5.5 This constant is ignored.
hLstMemoLists the memo items
Hyper File 5.5 This constant is ignored.
hLstNormal
(default value)
Corresponds to hLstItem + hLstMemo + hLstKey
hLstOriginalItemUsed on a log file (xxxJNL.fic), lists the items of the source file (that was logged). For example, on CustomerLOG.Fic, lists the items of CUSTOMER file.
Hyper File 5.5 This constant is ignored.

Java This constant is not available.
hLstSortedSorts the list in alphabetical order
Hyper File 5.5 This constant is ignored.
Remarks

Order of items

The items listed in <Result> are sorted according to the physical order of items in the data file (except if the hLstSorted constant is used).

Displaying the result in a List Box or Combo Box control

<Result> can be directly assigned to a List Box or Combo Box control by <List Box>.Add. Each row will contain the description of an item.

HFSQL type

The possible HFSQL types are as follows:
0unknown type18-byte automatic identifier
2text item3signed integer item on 2 bytes
4signed integer item on 1 byte5signed integer item on 4 bytes
6simple real item (on 4 bytes)7simple real item (on 8 bytes)
8record number item (unsigned integer)9unsigned integer item on 2 bytes
10date item on 611time item
12unsigned integer item on 1 byte13turbo real item
14date item on 815text memo item
16binary memo 4.0 item17currency item
18binary memo, image memo item,
Sound memo, OLE memo or other binary memo
19signed integer item on 8 bytes
20unsigned integer item on 8 bytes21image item
22unsigned integer item on 4 bytes23character string item
24date+time item25duration item
26character item27boolean item
28automatic identifier item (on 4 bytes)29Unicode text item
30Unicode text memo item31high-precision numeric item
32Enumeration item33Combination item
34128-bit UUID item35128-bit automatic UUID item
36256-bit UUID item37256-bit automatic UUID item
38JSON item39Secure Password item
Component: wd290hf.dll
Minimum version required
  • Version 25
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 06/21/2023

Send a report | Local help