描述
返回列值为long。
PB语法
METHOD ColumnLong (BYVAL vCol AS VARIANT) AS LONG |
参数
nCol
[in]应返回信息的列的索引或名称。结果集的最左列有索引0。结果中的列数可以使用ColumnCount确定。
返回值
列值为长整数。
备注
如果SQL语句当前没有指向有效的行，或者如果列索引超出范围，则结果是未定义的。ColumnLong只能在最近调用步已返回SQLITE_ROW时调用，并且之后不再调用重启或最终确定.如果在重启或最终确定之后或步返回了除了SQLITE_ROW之外的任何其他函数中调用了这些函数，则结果未定义。重启或重启或最终确定在ColumnLong待处理之前从其他线程调用，则结果未定义。
ColumnLong尝试在适当的情况下转换值。下表详细说明了所应用的转化：
内部类型 |
请求类型 |
转变 |
NULL |
INTEGER |
结果为0 |
FLOAT |
INTEGER |
从浮点数转换为整数 |
TEXT |
INTEGER |
使用atoi（） |
BLOB |
INTEGER |
转换为TEXT然后使用atoi（） |
以上表格参考了标准C库函数atoi（）。SQLite并没有真正使用这个功能。它具有自己的等效内部功能。为了简洁起见，在表中使用了atoi（）名称，因为它们是大多数C程序员熟悉的。
如果在评估任何这些功能时发生内存分配错误，则返回默认值。默认值为0。对ErrCode的后续调用将返回SQLITE_NOMEM。