描述
返回列值为long。
C / C ++语法
int sqlite3_column_int(sqlite3_stmt*, int iCol); |
PB语法
FUNCTION sqlite3_column_int ( _ BYVAL hStmt AS DWORD, _ BYVAL nCol AS LONG _ ) AS LONG |
参数
pStmt
[in]语句句柄。
nCol
[in]应返回信息的列的索引。结果集的最左列有索引0。结果中的列数可以使用sqlite3_column_count确定。
返回值
列值为长整数。
备注
如果SQL语句当前没有指向有效的行，或者如果列索引超出范围，则结果是未定义的。sqlite3_column_int只能在最近调用sqlite3_step已返回SQLITE_ROW时调用，并且之后不再调用sqlite3_reset或sqlite3_finalize.如果在sqlite3_reset或sqlite3_finalize之后或在sqlite3_step返回了除了SQLITE_ROW之外的任何其他功能之后调用了这些功能，则结果未定义。sqlite3_reset或sqlite3_reset或sqlite3_finalize在sqlite3_column_int待处理之前从另一个线程调用，则结果未定义。
sqlite3_column_int尝试在适当的时候转换值。下表详细说明了所应用的转化：
内部类型 |
请求类型 |
转变 |
NULL |
INTEGER |
结果为0 |
FLOAT |
INTEGER |
从浮点数转换为整数 |
TEXT |
INTEGER |
使用atoi（） |
BLOB |
INTEGER |
转换为TEXT然后使用atoi（） |
以上表格参考了标准C库函数atoi（）。SQLite并没有真正使用这个功能。它具有自己的等效内部功能。为了简洁起见，在表中使用了atoi（）名称，因为它们是大多数C程序员熟悉的。
如果在评估任何这些功能时发生内存分配错误，则返回默认值。默认值为0。对sqlite3_errcode的后续调用将返回SQLITE_NOMEM。
C ++实现代码
SQLITE_API int sqlite3_column_int(sqlite3_stmt *pStmt, int i){
int val = sqlite3_value_int( columnMem(pStmt,i) );
columnMallocFailure(pStmt);
return val;
}