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

ColumnDouble Method

Previous pageReturn to chapter overviewNext page

描述

 

将列值返回为double。

 

PB语法

 

METHOD ColumnDouble (BYVAL vCol AS VARIANT) AS DOUBLE

 

参数

 

vCol

 

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

 

返回值

 

列值为double。

 

备注

 

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

 

ColumnDouble尝试在适当的情况下转换值。下表详细说明了所应用的转化:

 

内部类型

请求类型

转变

NULL

FLOAT

结果为0.0

INTEGER

FLOAT

从整数转换为浮点数

TEXT

FLOAT

使用atof()

BLOB

FLOAT

转换为TEXT然后使用atof()

 

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

 

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