sqlite.h


Resetear un objeto de sentencia preparada

int sqlite3_reset(sqlite3_stmt *pStmt);

La función sqlite3_reset() es invocada para resetear un objeto de sentencia preparada a su estado inicial, preparado para ser reejecutada. Cualquier variable de sentencia SQL que tenga valores asociados con ellas usando funciones sqlite3_bind_*() retienen sus valores. Usar sqlite3_clear_bindings() para resetear las asociaciones.

La función sqlite3_reset(S) resetea la sentencia preparada S al principio de su programa.

En la llamada más reciente a sqlite3_step(S) para la sentencia preparada S retorna SQLITE_ROW o SQLITE_DONE, o si sqlite3_step(S) nunca fue llamada antes para S, entonces sqlite3_reset(S) retorna SQLITE_OK.

Si la llamada más reciente a sqlite3_step(S) para la sentencia preparada S indica un error, entonces sqlite3_reset(S) retorna un código de error apropiado.

La función sqlite3_reset(S) no cambia los valores de ninguna asociación de la sentencia preparada S.