データベース接続を閉じる
2011. 02. 15
int sqlite3_close(sqlite3 *);
sqlite3_close()ルーチンはsqlite3オブジェクトのデストラクタです。
sqlite3_close()を呼び出すと、sqlite3オブジェクトの破棄と関連付けされたリソースの解放に成功した場合は、SQLITE_OKを返します。
アプリケーションはオブジェクトを閉じようと試みる前に、全てのprepared statementsのfinalizeと、sqlite3オブジェクトに関連付けされた全てのBLOB handlesのcloseを行います。
sqlite3_close()は、まだ未解決のprepared statementsまたはBLOB handlesのdatabase connectionで呼び出された場合、SQLITE_BUSYを返します。
トランザクションが開いている時にsqlite3_close()が呼び出された場合、トランザクションは自動的にロールバックされます。
sqlite3_close(C)のCパラメータはNULLポインタか、またはsqlite3_open()、sqlite3_open16()、またはsqlite3_open_v2()から取得したsqlite3オブジェクトのポインタで、事前に閉じていない必要があります。
引数にNULLポインタを指定してsqlite3_close()を呼び出した場合は何もしません。
Objects、Constants、Functionsの一覧を参照してください。
参考文献
・Closing A Database Connection