mirror of
https://github.com/cuberite/SQLiteCpp.git
synced 2025-08-04 17:56:13 -04:00
Added tryExecuteStep and tryReset
This commit is contained in:
parent
1a46a942b3
commit
8191046ea5
@ -78,6 +78,10 @@ public:
|
|||||||
/// Reset the statement to make it ready for a new execution.
|
/// Reset the statement to make it ready for a new execution.
|
||||||
void reset();
|
void reset();
|
||||||
|
|
||||||
|
/// Reset the statement to make it ready for a new execution. Returns the sqlite result code
|
||||||
|
/// instead of throwing an exception on error.
|
||||||
|
int tryReset() noexcept;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Clears away all the bindings of a prepared statement.
|
* @brief Clears away all the bindings of a prepared statement.
|
||||||
*
|
*
|
||||||
@ -335,6 +339,7 @@ public:
|
|||||||
* thru the getColumn() method
|
* thru the getColumn() method
|
||||||
*
|
*
|
||||||
* @see exec() execute a one-step prepared statement with no expected result
|
* @see exec() execute a one-step prepared statement with no expected result
|
||||||
|
* @see tryExecuteStep() try to execute a step of the prepared query to fetch one row of results, returning the sqlite result code.
|
||||||
* @see Database::exec() is a shortcut to execute one or multiple statements without results
|
* @see Database::exec() is a shortcut to execute one or multiple statements without results
|
||||||
*
|
*
|
||||||
* @return - true (SQLITE_ROW) if there is another row ready : you can call getColumn(N) to get it
|
* @return - true (SQLITE_ROW) if there is another row ready : you can call getColumn(N) to get it
|
||||||
@ -346,6 +351,19 @@ public:
|
|||||||
*/
|
*/
|
||||||
bool executeStep();
|
bool executeStep();
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Try to execute a step of the prepared query to fetch one row of results, returning the sqlite result code.
|
||||||
|
*
|
||||||
|
*
|
||||||
|
*
|
||||||
|
* @see exec() execute a one-step prepared statement with no expected result
|
||||||
|
* @see executeStep() execute a step of the prepared query to fetch one row of results
|
||||||
|
* @see Database::exec() is a shortcut to execute one or multiple statements without results
|
||||||
|
*
|
||||||
|
* @return the sqlite result code.
|
||||||
|
*/
|
||||||
|
int tryExecuteStep() noexcept;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Execute a one-step query with no expected result.
|
* @brief Execute a one-step query with no expected result.
|
||||||
*
|
*
|
||||||
@ -359,6 +377,7 @@ public:
|
|||||||
* - reusing it allows for better performances (efficient for multiple insertion).
|
* - reusing it allows for better performances (efficient for multiple insertion).
|
||||||
*
|
*
|
||||||
* @see executeStep() execute a step of the prepared query to fetch one row of results
|
* @see executeStep() execute a step of the prepared query to fetch one row of results
|
||||||
|
* @see tryExecuteStep() try to execute a step of the prepared query to fetch one row of results, returning the sqlite result code.
|
||||||
* @see Database::exec() is a shortcut to execute one or multiple statements without results
|
* @see Database::exec() is a shortcut to execute one or multiple statements without results
|
||||||
*
|
*
|
||||||
* @return number of row modified by this SQL statement (INSERT, UPDATE or DELETE)
|
* @return number of row modified by this SQL statement (INSERT, UPDATE or DELETE)
|
||||||
|
@ -58,6 +58,14 @@ void Statement::reset()
|
|||||||
check(ret);
|
check(ret);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
int Statement::tryReset() noexcept
|
||||||
|
{
|
||||||
|
mbOk = false;
|
||||||
|
mbDone = false;
|
||||||
|
const int ret = sqlite3_reset(mStmtPtr);
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
// Clears away all the bindings of a prepared statement (can be associated with #reset() above).
|
// Clears away all the bindings of a prepared statement (can be associated with #reset() above).
|
||||||
void Statement::clearBindings()
|
void Statement::clearBindings()
|
||||||
{
|
{
|
||||||
@ -266,6 +274,26 @@ bool Statement::executeStep()
|
|||||||
return mbOk; // true only if one row is accessible by getColumn(N)
|
return mbOk; // true only if one row is accessible by getColumn(N)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
int Statement::tryExecuteStep() noexcept {
|
||||||
|
const int ret = sqlite3_step(mStmtPtr);
|
||||||
|
if (SQLITE_ROW == ret) // one row is ready : call getColumn(N) to access it
|
||||||
|
{
|
||||||
|
mbOk = true;
|
||||||
|
}
|
||||||
|
else if (SQLITE_DONE == ret) // no (more) row ready : the query has finished executing
|
||||||
|
{
|
||||||
|
mbOk = false;
|
||||||
|
mbDone = true;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
mbOk = false;
|
||||||
|
mbDone = false;
|
||||||
|
}
|
||||||
|
|
||||||
|
return ret;
|
||||||
|
}
|
||||||
|
|
||||||
// Execute a one-step query with no expected result
|
// Execute a one-step query with no expected result
|
||||||
int Statement::exec()
|
int Statement::exec()
|
||||||
{
|
{
|
||||||
|
Loading…
x
Reference in New Issue
Block a user