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

ColumnValue Method

Previous pageReturn to chapter overviewNext page

描述

 

返回列值作为指向不受保护的sqlite3_value对象的指针。

 

PB语法

 

METHOD ColumnValue (BYVAL vCol AS LONG) AS DWORD

 

参数

 

vCol

 

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

 

返回值

 

列值作为指向不受保护的sqlite3_value对象的指针。

 

备注

 

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

 

ColumnValue返回的对象是一个不受保护的sqlite3_value对象。不受保护的sqlite3_value对象只能与BindValueResultValue一起使用。如果以ColumnValue返回的未受保护的sqlite3_value对象以任何其他方式使用,包括对ValueLongValueTextValueBytes等函数的调用,那么行为是未定义的。

 

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