获得结果
在本章中,我们来学习如何获得SQL语句的执行结果。
我们称由查询返回的一组记录为一个 结果集(result set) (或在VB中被称为recordset).检索结果通常分为以下几个步骤:
- 确认一个结果集是否可用。
- 将结果集的列绑定在适当的变量上。
- 取得行
完成对结果集的操作后,我们必须调用SQLCloseCursor来销毁它.
确认一个结果集是否可用
有时在执行SQL语句后,我们就已经知道结果集是否可用了。如果执行的语句并不是返回结果集的类型,我们就知道结果集不可用了。但有时我们不太清楚使用的SQL语句是什么类型,比如说,让用户自行输入SQL语句。这时,我们必须确认是否有结果集被建立,这可以通过SQLNumResultCols函数实现。如果结果集存在,则该函数返回结果集中的列数(字段数)。语法如下:
SQLNumResultCols proto StatementHandle:DWORD, pNumCols:DWORD
- StatementHandle 语句句柄
- pNumCols 指向一个双字的指针,其中包含了结果集的列数。
如果 pNumCols指向的值为0,那么表明结果集不存在。
绑定列
与绑定一个变量到SQL语句的参数相同,我们连接(绑定)一个变量到结果集中的某一列。这里要用到的函数是SQLBindCol,语法如下:
SQLBindCol proto StatementHandle:DWORD, ColumnNumber:DWORD, TargetType:DWORD, TargetValuePtr:DWORD, BufferLength:DWORD, pStrLenOrIndPtr:DWORD
- StatementHandle 语句句柄
- ColumnNumber 结果集中要绑定的列序数.列序数从1开始.列0是书签(bookmark)列.
- TargetType The 指示 TargetValuePtr指向的变量(缓冲区)的类型的常数。
- TargetValuePtr 指向将要捆绑到列的变量或缓冲区的指针。当调用SQLFetch来获得结果集中的行时,本参数指向的变量或缓冲区将被填入被绑定的列的值。
- BufferLength 由TargetValuePtr指向的缓冲区的长度。
- pStrLenOrIndPtr 参见前章SQLBindParameter
例子:
.data? buffer db 21 dup(?) DataLength dd ? ;调用SQLFetch后,被填入缓冲区的字符串的长度
.code ..... invoke SQLBindCol, hStmt, 1, SQL_C_CHAR, addr buffer, 21, addr DataLength
取得一行
非常简单.先调用SQLFetch 检索结果集的一列到绑定的变量中。当SQLFetch调用完成,游标(cursor)被更新(updated).可以认为游标就是一个记录指针(record pointer). 它指明了SQLFetch调用后将返回哪一行。比如说,如果结果集有4列,当结果集建立时,游标指向第一行.当调用了SQLFetch 后,游标被加1。所以如果调用了SQLFetch 4次,就没有更多的行可被提交了。游标会显示指向文件尾(EOF). SQLFetch语法如下:
SQLFetch proto StatementHandle:DWORD
当没有行可提交时,这个函数返回 SQL_NO_DATA.
例子:
.data? buffer db 21 dup(?) DataLength dd ?
.code ..... invoke SQLBindCol, hStmt, 1, SQL_C_CHAR, addr buffer, 21, addr DataLength invoke SQLFetch, hStmt
译者废话:还记得地球的经纬吗?我们通过SQLBindCol来定位经度(列),用游标来定义纬度(行),用SQLFetch来获得坐标,而结果集就是地球。大航海时代2的同好们不应忘记呀!(船长,我们找不到水......顺便问一句,这是地球吗%$#@&*^:-)
|