Small. Fast. Reliable.
Choose any three.

SQLite C接口

准备的语句扫描状态

int sqlite3_stmt_scanstatus(
  sqlite3_stmt * pStmt,/ *所需信息的预备语句* /
  int idx,/ *要报告的循环索引* /
  int iScanStatusOp,/ *所需信息。SQLITE_SCANSTAT_ * * /
  无效* pOut / *结果写在这里* /
);

此接口返回有关pStmt的预测和测量性能的信息。高级应用程序可以使用此界面比较预测的性能和测得的性能,并发出警告和/或在发现差异时重新运行ANALYZE

由于预计很少使用此接口,因此仅当使用SQLITE_ENABLE_STMT_SCANSTATUS 编译时选项编译SQLite时,此接口才可用。

“ iScanStatusOp”参数确定要返回的状态信息。“ iScanStatusOp”必须是scanstatus选项之一,否则此接口的行为未定义。所请求的测量值将写入“ pOut”参数指向的变量中。参数“ idx”标识要检索其统计信息的特定循环。循环从零开始编号。如果idx超出范围-小于零或大于或等于用于执行该语句的循环总数-将返回非零值,并且pOut指向的变量不变。

统计信息可能不适用于所有语句中的所有循环。在存在没有可用统计信息的循环的情况下,此函数的行为就像该循环不存在一样-它返回非零值,并使pOut指向的变量保持不变。

另请参见:sqlite3_stmt_scanstatus_reset()

另请参见 对象常量函数的列表