UDF > SQLite >

_SQLite_QueryFinalize

Finalise une requ�te _SQLite_Query(). La requ�te est interrompue

#include <SQLite.au3>
_SQLite_QueryFinalize ( $hQuery )

Param�tre

$hQuery Handle de la requ�te g�n�r�e par _SQLite_Query()

Valeur de retour

Succ�s: Retourne $SQLITE_OK.
�chec: Retourne une valeur qui peut �tre compar�e aux constantes $SQLITE_*.
@error: -1 - SQLite a signal� une erreur (Examinez la valeur de retour)
 1 - Erreur dans l'appel de l'API SQLite 'sqlite3_finalize'
 2 - Appel emp�ch� par SafeMode

Remarques

La fonction _SQLite_QueryFinalize() est appel�e pour supprimer une instruction SQL obtenue par un appel pr�c�dent � _SQLite_Query(). Si la d�claration a �t� ex�cut�e avec succ�s, ou non ex�cut�e du tout, alors $SQLITE_OK est retourn�. Si l'ex�cution de l'instruction a �chou� alors un code d'erreur est retourn�.

Toutes les instructions pr�par�es doivent �tre finalis�es avant d'appeler _SQLite_Close() ou sinon l'appel �chouera avec un code de retour $SQLITE_BUSY.

En relation

_SQLite_Query, _SQLite_QueryReset

Exemple

#include <MsgBoxConstants.au3>
#include <SQLite.au3>
#include <SQLite.dll.au3>

Local $hQuery, $aRow, $aNames
_SQLite_Startup()
ConsoleWrite("_SQLite_LibVersion=" & _SQLite_LibVersion() & @CRLF)
_SQLite_Open() ; Ouvre une base de donn�es :memory:
_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) ; Lit Tablenames
MsgBox($MB_SYSTEMMODAL, "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 ; Ceci obtient une ligne � la fois
    MsgBox($MB_SYSTEMMODAL, "SQLite", "Get Data using FetchData : " & StringFormat(" %-10s  %-10s  %-10s  %-10s ", $aRow[0], $aRow[1], $aRow[2], $aRow[3]) & @CRLF)
    _SQLite_QueryFinalize($hQuery) ; Ceci arr�tera le requ�te, en obtenant plus de lignes
WEnd
_SQLite_Exec(-1, "DROP TABLE aTest; ")
_SQLite_Close()
_SQLite_Shutdown()

; R�sultat:
; rowid       A           B           C
; 3           a           1           Hello