diff --git a/src/SQLiteC++/Database.cpp b/src/SQLiteC++/Database.cpp index fa6a15b..9e40d72 100644 --- a/src/SQLiteC++/Database.cpp +++ b/src/SQLiteC++/Database.cpp @@ -41,7 +41,7 @@ Database::~Database(void) throw() // nothrow } } -// Shortcut to execute one or multiple SQL statements without results. +// Shortcut to execute one or multiple SQL statements without results (UPDATE, INSERT, ALTER, COMMIT...). int Database::exec(const char* apQueries) // throw(SQLite::Exception); { int ret = sqlite3_exec(mpSQLite, apQueries, NULL, NULL, NULL); diff --git a/src/SQLiteC++/Database.h b/src/SQLiteC++/Database.h index 49de0c9..f5c5949 100644 --- a/src/SQLiteC++/Database.h +++ b/src/SQLiteC++/Database.h @@ -57,9 +57,12 @@ public: /** * @brief Shortcut to execute one or multiple statements without results. * - * This is useful for Data Manipulation Language SQL statements like CREATE, INSERT, UPDATE, DROP + * This is useful for any kind of statements other than the Data Query Language (DQL) "SELECT" : + * - Data Definition Language (DDL) statements "CREATE", "ALTER" and "DROP" + * - Data Manipulation Language (DML) statements "INSERT", "UPDATE" and "DELETE" + * - Data Control Language (DCL) statements "GRANT", "REVOKE", "COMMIT" and "ROLLBACK" * - * @see also Statement class for handling queries with results + * @see Statement class and Statement::executeStep() for handling "SELECT" queries with results * * @param[in] apQueries one or multiple UTF-8 encoded, semicolon-separate SQL statements */ diff --git a/src/SQLiteC++/Statement.h b/src/SQLiteC++/Statement.h index 347ec17..5e33997 100644 --- a/src/SQLiteC++/Statement.h +++ b/src/SQLiteC++/Statement.h @@ -118,6 +118,8 @@ public: * then you have to call executeStep() again to fetch more rows until the query is finished * - false (SQLITE_DONE) if the query has finished executing : there is no (more) row of result * (case of a query with no result, or after N rows fetched successfully) + * + * @see Database::exec() is a shortcut to execute one or multiple statements without results */ bool executeStep(void); // throw(SQLite::Exception);