_SQLite_Query()に基づくクエリを終了します。クエリは中断されます。
#include <SQLite.au3>
_SQLite_QueryFinalize ( $hQuery )
パラメータ
| $hQuery | _SQLite_Query()から渡されるクエリハンドル |
返し値
| 成功: | $SQLITE_OKを返します |
| 失敗: | $SQLITE_* 定数と比較可能な値を返します |
| @error: | -1 - SQLiteがエラーを報告 (返し値を調べてください) |
| 1 - SQLite API 'sqlite3_finalize'の呼び出しエラー | |
| 2 - SafeModeによって呼び出しが阻止されました |
注意
_SQLite_QueryFinalize関数は過去の_SQLite_Query呼び出しによって用意されたSQLステートメントを削除するために使用されます。ステートメントの実行が成功した場合またはまったく実行されなかった場合、SQLITE_OKが返されます。ステートメントの実行が失敗した場合、エラーコードが返されます。
関連
_SQLite_Query
例
#include <SQLite.au3>
#include <SQLite.dll.au3>
Local $hQuery, $aRow, $aNames
_SQLite_Startup ()
ConsoleWrite("_SQLite_LibVersion=" &_SQLite_LibVersion() & @CRLF)
_SQLite_Open () ; :メモリ: データベースを開く
_SQLite_Exec (-1, "CREATE TABLE aTest (a,b,c);")
_SQLite_Exec (-1, "INSERT INTO aTest(a,b,c) VALUES ('c','2','World');")
_SQLite_Exec (-1, "INSERT INTO aTest(a,b,c) VALUES ('b','3',' ');")
_SQLite_Exec (-1, "INSERT INTO aTest(a,b,c) VALUES ('a','1','Hello');")
_SQlite_Query (-1, "SELECT ROWID,* FROM aTest ORDER BY a;", $hQuery)
_SQLite_FetchNames ($hQuery, $aNames) ; テーブル名の読み出し
MsgBox(0,"SQLite","Row ID is : " & StringFormat(" %-10s %-10s %-10s %-10s ", $aNames[0], $aNames[1], $aNames[2], $aNames[3]) & @CRLF)
While _SQLite_FetchData ($hQuery, $aRow) = $SQLITE_OK ; 1度に1列取得
MsgBox(0,"SQLite","Get Data using FetchData : " & StringFormat(" %-10s %-10s %-10s %-10s ", $aRow[0], $aRow[1], $aRow[2], $aRow[3]) & @CRLF)
_SQLite_QueryFinalize ($hQuery) ; 複数行を取得するクエリを停止
WEnd
_SQLite_Exec (-1, "DROP TABLE aTest;")
_SQLite_Close ()
_SQLite_Shutdown ()
;~ 出力:
;~
;~ rowid a b c
;~ 3 a 1 Hello