勇芳软件工作室.汉化:  SQLite3 API Functions > Statements >

sqlite3_stmt_status

Previous pageReturn to chapter overviewNext page

描述

 

此函数用于从准备好的语句中检索和重置计数器值。

 

C / C ++语法

 

int sqlite3_stmt_status(sqlite3_stmt*, int op,int resetFlg);

 

PB语法

 

FUNCTION sqlite3_stmt_status ( _

BYVAL hStmt AS DWORD, _

BYVAL op AS LONG, _

BYVAL resetFlag AS LONG _

) AS LONG

 

参数

 

pStmt

 

[in]语句句柄。

 

op

 

[in]要查询的特定SQLITE_STMTSTATUS计数器的整数代码。

 

resetFlag

 

[in]TRUE或FALSE。如果为true,则在此接口调用返回后,计数器将重置为零。

 

返回值

 

计数器值。

 

备注

 

每个准备好的语句都会维护各种SQLITE_STMTSTATUS计数器,用于测量执行特定操作的次数。这些计数器可用于监视预准备语句的性能特征。例如,如果表步数大大超过了表搜索或结果行的数量,那么这将倾向于指示准备好的语句正在使用全表扫描而不是索引。

 

C ++实现代码

 

/*

** Return the value of a status counter for a prepared statement

*/

SQLITE_API int sqlite3_stmt_status(sqlite3_stmt *pStmt, int op, int resetFlag){

Vdbe *pVdbe = (Vdbe*)pStmt;

int v = pVdbe->aCounter[op-1];

if( resetFlag ) pVdbe->aCounter[op-1] = 0;

return v;

}