sqlite3_finalize()

最新推荐文章于 2024-09-25 09:25:33 发布

转载最新推荐文章于 2024-09-25 09:25:33 发布 · 3k 阅读

文章标签：

#sqlite #constants #application #behavior #delete #function

Sqlite 专栏收录该内容

13 篇文章

订阅专栏

本文介绍如何使用sqlite3_finalize()函数来销毁SQLite预编译语句。该函数可以在预编译语句生命周期内的任意时刻调用，无论其是否已执行或遇到错误。正确调用此函数对于避免资源泄露至关重要。

Destroy A Prepared Statement Object

int sqlite3_finalize(sqlite3_stmt *pStmt);

The sqlite3_finalize() function is called to delete a prepared statement. If the most recent evaluation of the statement encountered no errors or if the statement is never been evaluated, then sqlite3_finalize() returns SQLITE_OK. If the most recent evaluation of statement S failed, then sqlite3_finalize(S) returns the appropriate error code or extended error code.

The sqlite3_finalize(S) routine can be called at any point during the life cycle of prepared statement S: before statement S is ever evaluated, after one or more calls to sqlite3_reset(), or after any call to sqlite3_step() regardless of whether or not the statement has completed execution.

Invoking sqlite3_finalize() on a NULL pointer is a harmless no-op.

The application must finalize every prepared statement in order to avoid resource leaks. It is a grievous error for the application to try to use a prepared statement after it has been finalized. Any use of a prepared statement after it has been finalized can result in undefined and undesirable behavior such as segfaults and heap corruption.

See also lists of Objects, Constants, and Functions.