勇芳软件工作室.汉化:  CSQLite Classes > CSQLiteStatement Class > ISQLiteStatement Interface >

ColumnQuad Method

Previous pageReturn to chapter overviewNext page

描述

 

以四进制形式返回列值。

 

PB语法

 

METHOD ColumnQuad (BYVAL vCol AS VARIANT) AS QUAD

 

参数

 

vCol

 

[in]应返回信息的列的索引或名称。结果集的最左列有索引0。结果中的列数可以使用ColumnCount确定。

 

返回值

 

列值作为四元组。

 

备注

 

如果SQL语句当前没有指向有效的行,或者如果列索引超出范围,则结果是未定义的。只有当最近调用已经返回SQLITE_ROW并且以后不再调用重启最终确定时才可以调用这些函数。如果这些功能中的任何一个在重启最终确定之后或已返回非SQLITE_ROW之后调用,则结果未定义。重启最终确定ColumnQuad待处理之前从另一个线程调用,则结果未定义。

 

ColumnQuad尝试在适当的时候转换值。下表详细说明了所应用的转化:

 

内部类型

请求类型

转变

NULL

INTEGER

结果为0

FLOAT

INTEGER

从浮点数转换为整数

TEXT

INTEGER

使用atoi()

BLOB

INTEGER

转换为TEXT然后使用atoi()

 

上面的表格参考了标准C库函数atoi()和atof()。SQLite并没有真正使用这些功能。它具有自己的等效内部功能。为了简洁起见,在表中使用了atoi()和atof()名称,因为它们是大多数C程序员熟悉的。

 

如果在评估任何这些功能时发生内存分配错误,则返回默认值。默认值为整数0,浮点数0.0或空指针。对ErrCode的后续调用将返回SQLITE_NOMEM。