SQL-Statement ausführen

int sqlite3_step(sqlite3_stmt*);



Nach dem Compilieren eines Prepared Statements mittels sqlite3_prepare_v2() oder einer der anderen Prepare-Funktionen, muss diese Funktion aufgerufen werden, um das Statement auszuführen. SQL-Befehle die keine Werte zurückliefern, werden normalerweise mit einem einzigen Aufruf der Funktion vollständig durchlaufen. Werden Werte zurückgegeben, muss der Befehl mehrmals aufgerufen werden. Gibt die Funktion SQLITE_ROW zurück, so ist die Ausführung noch nicht abgeschlossen und es befinden sich weitere Werte in der Rückgabe. Die Funktion muss bzw. kann nochmals aufgerufen werden, bis die Funktion den Wert SQLITE_DONE zurückgibt. Um keinen Fehler zu erhalten, darf ein Statement, das SQLITE_DONE zurückgeliefert hat, kein weiteres Mal aufgerufen werden, es sei denn, es wurde mit sqlite3_reset() zurückgesetzt. Neben SQLITE_DONE und SQLITE_ROW können auch noch diverse Fehlercodes zurückgeliefert werden. Tritt ein Fehlercode auf, so muss das Statement ebenfalls mit sqlite3_reset() zurückgesetzt werden, bevor es erneut mit sqlite3_step() aufgerufen werden kann.