PC SOFT

ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Home | Sign in | English EN
  • Current row in the query
  • Query columns
  • Query without result
  • Using tabulations in the items
  • SQLCol and SQLGetCol functions
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
Retrieves the content of the specified column from the query result, for the current line.
Caution: This function must be used during a "SQLFetch/SQLGetCol" browse of the query result. For more details, see Types of SQL browse.
Versions 19 and later
Android Widget This function is now available in Android widget mode (accessing external databases via a Webservice).
Android This function is now available for Android applications (accessing external databases via a Webservice).
iPhone/iPad This function is now available for iPhone/iPad applications (accessing external databases via a Webservice).
New in version 19
Android Widget This function is now available in Android widget mode (accessing external databases via a Webservice).
Android This function is now available for Android applications (accessing external databases via a Webservice).
iPhone/iPad This function is now available for iPhone/iPad applications (accessing external databases via a Webservice).
Android Widget This function is now available in Android widget mode (accessing external databases via a Webservice).
Android This function is now available for Android applications (accessing external databases via a Webservice).
iPhone/iPad This function is now available for iPhone/iPad applications (accessing external databases via a Webservice).
Versions 21 and later
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
New in version 21
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Universal Windows 10 App This function is now available in Universal Windows 10 App mode.
Example
i is int = 0
SQLExec("SELECT LASTNAME, FIRSTNAME, EXTENSION, PHOTO FROM CUSTOMER", "QRY1")
// Retrieve the query row by row
WHILE SQLFetch("QRY1") = 0 // There is another line to read
i++
// Retrieve the data
LASTNAME[i] = SQLGetCol("QRY1", 1)
FIRSTNAME[i] = SQLGetCol("QRY1", 2)
EXTENSION[i] = SQLGetCol("QRY1", 3)
END
SQLClose("QRY1")
Syntax
<Result> = SQLGetCol(<Query name> , <Column number>)
<Result>: Character string
Value of the column.
<Query name>: Character string
Name of the query created and executed with SQLExec, or executed with SQLExecWDR.
<Column number>: Integer
Number of the column to retrieve. This column corresponds to a query column (and not to a table column). If several columns must be retrieved, the subscript of the columns must be specified in ascending order. For example, you must do SQLCol("QRY1", 1) then SQLCol("QRY1", 2).
Remarks

Current row in the query

The current line is positioned by SQLFetch.

Query columns

  • To read memo columns, use SQLGetMemo. To read the text memo columns, use SQLGetTextMemo.

  • The number of columns found in the query result is returned by the SQL.NbCol variable (assigned by SQLInfo).
  • If the column is a numeric column, SQLGetCol converts the result to a string. However, in WLanguage, you can assign the result returned by SQLGetCol in a numeric variable. WLanguage automatically performs the conversion.
  • Columns have to be retrieved in ascending order.
  • The same column cannot be retrieved several times in a row. Indeed, the second time, the result will be an empty string.
  • SQLGetCol cannot be used to retrieve the binary strings.

Query without result

SQLGetCol should not be called if the query did not return a result: the SQL.Out variable must be tested once the position has been set in the query result, before calling SQLGetCol.
For example:
// Retrieve the value of the 1st column for the 1st record
Value is string
QueryText is string
QueryText = "SELECT CUSTNAME, ADDR1, ADDR2, CITY, ZIP FROM INV"
SQLExec(QueryText, "QRY1")
Value = SQLGetCol("QRY1", 1)

Using tabulations in the items

The SQL functions are used to insert tabulations into the file items.
To get the value of the items (with Tabs), use SQLFetch/SQLGetCol.
Example: SQLGetCol and tabs in items
The items of the records to retrieve are as follows:
Item 1Item 2
Record 1JohnSmith
Record 2John + tab + MacDoughnut
For the first record:
  • SQLGetCol(QRY, 1): retrieves John
  • SQLGetCol(QRY, 2): retrieves Smith
For the second record:
  • SQLGetCol(QRY,1 ): retrieves John + tab + Mac
  • SQLGetCol(QRY, 2): retrieves Doughnut
HFSQLHFSQL Client/Server

SQLCol and SQLGetCol functions

SQLCol and SQLGetCol are equivalent in an OLE DB or HFSQL access. However, you must respect the type of browse associated with each one of these functions:
  • SQLCol function: "SQLFirst/SQLCol" browse
  • SQLGetCol function: "SQLFetch/SQLGetCol" browse
For more details, see Types of SQL browse.
Remark: From version 19, HFSQL is the new name of HyperFileSQL.
Component: wd270hf.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment