https://www.proggen.org/ 2026-04-12T15:29:11+0200 https://www.proggen.org/ https://www.proggen.org/lib/tpl/proggenX/images/favicon.ico text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:errors&rev=1663869537 Funktionsrückmeldungen Konstanten Fehlercodes Bedeutung SQLITE_OK 0 Erfolgreich ausgeführt SQLITE_ERROR 1 SQL Fehler oder fehlende DatenbankSQLITE_INTERNAL 2 interner SQLite FehlerSQLITE_PERM 3 text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sidebar&rev=1663869537 Datenbanken * Startseite * MySQL * SQLite Startseite * libsqlite3 Startseite Befehlsreferenz libsqlite3 Funktionen * sqlite3_close * sqlite3_column_* * sqlite3_errmsg * sqlite3_exec * sqlite3_finalize * sqlite3_free * sqlite3_free_table * sqlite3_get_table * sqlite3_open * sqlite3_prepare * sqlite3_reset * sqlite3_step * Funktionsrückmeldungen Objekte * sqlite3 * sqlite3_stmt text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3&rev=1663869537 Handle für die Datenbankverbindung typedef struct sqlite3 sqlite3; ---------- Jede SQLite Datenbank wird von einen Pointer diesen Typ repräsentiert. Am besten denkt man sich diesen Pointer als Datenbankobjekt. Dann stellt sqlite3_open() den Konstruktor dar und text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_close&rev=1663869537 Datenbankverbindung schließen int sqlite3_close(sqlite3 *); ---------- Diese Funktion schließt die Datenbankverbindung und zerstört die Instanz des sqlite3-Objekts, die als Parameter angegeben wird. Alle prepared statements müssen per sqlite3_finalize() zerstört werden, bevor die Funktion aufgerufen wird. Wird diese Funktion aufgerufen während ein Arbeitsvorgang in der Datenbank ausgeführt wird, werden die Änderungen zurückgesetzt. text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_column&rev=1663869537 Rückgabewerte von sqlite3_step auswerten const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); int sqlite3_column_bytes(sqlite3_stmt*, int iCol); double sqlite3_column_double(sqlite3_stmt*, int iCol); int sqlite3_column_int(sqlite3_stmt*, int iCol); text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_errmsg&rev=1663869537 Fehlercodes und Nachrichten int sqlite3_errcode(sqlite3 *db); const char *sqlite3_errmsg(sqlite3*); const void *sqlite3_errmsg16(sqlite3*); ---------- Die Funktion sqlite3_errcode liefert einen Fehlercode zurück, während die sqlite3_errmsg Funktionen eine Englisch Fehlermeldung zurückliefern. sqlite3_errmsg ist für die UTF-8 Codierung vorgesehen und sqlite3_errmsg16 für die UTF-16 Codierung. Für die Fehlermeldungen muss kein Speicher manuell freigegeben werden. Dies wird von den Funktion… text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_exec&rev=1663869537 Ausführen von SQL-Kommandos in einem Schritt int sqlite3_exec( sqlite3*, const char *sql, int (*callback)(void*,int,char**,char**), void *, char **errmsg ); ---------- Mit Hilfe dieses Befehls kann ein, oder mehrere SQL-Kommandos ausgeführt werden. Mehrere Kommandos müssen durch Semikolons getrennt werden. text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_finalize&rev=1663869537 Zerstörung eines prepared Statement Objekts int sqlite3_finalize(sqlite3_stmt *pStmt); ---------- Diese Funktion wird aufgerufen, um ein prepared statement Objekt zu löschen. Wurde das Statement bereits erfolgreich ausgeführt, oder noch nicht ausgeführt liefert die Funktion SQLITE_OK zurück. Trat beim Ausführen des Statements ein Fehler auf, wird ein text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_free&rev=1663869537 Arbeitsspeichersubsystem void *sqlite3_malloc(int); void *sqlite3_realloc(void*, int); void sqlite3_free(void*);\ ---------- Diese drei Funktionen werden von den Sqlite3 Kernfunktionen zur Speicherreservierung genutzt. sqlite3_malloc(n) liefert einen Zeiger auf einen Speicherblock zurück, der die Größe von n Bytes hat. Kann kein Speicher reserviert werden, dann wird NULL zurückgeliefert. Ist n Null oder negativ, wird ebenfalls NULL zurückgeliefert. text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_get_table&rev=1663869537 SQL-Kommando ausführen, Ergebnisse auf dem Heap int sqlite3_get_table( sqlite3 *db, const char *zSql, char ***pazResult, int *pnRow, int *pnColumn, char **pzErrmsg ); void sqlite3_free_table(char text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_open&rev=1663869537 Öffnen einer Datenbankverbindung int sqlite3_open ( const char *dateiname, sqlite3 **datenbankhandle ); ---------- Diese Funktion öffnet die Datenbankverbindung. Sie erwartet den Dateinamen als char-Pointer, der in UTF-8 codiert ist. Der zweite Parameter ist ein Datenbankhandle vom Typ text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_prepare_v2&rev=1663869537 Einen SQL-Befehl in Bytecode compilieren int sqlite3_prepare_v2( sqlite3 *db, const char *zSql, int nByte, sqlite3_stmt **ppStmt, const char **pzTail ); ---------- Um ein SQL-Kommando per sqlite3_step() ausführen zu können, muss es vorher in Bytecode compiliert werden. Die Funktion erwartet diese Parameter: text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_reset&rev=1663869537 Ein Prepared Statement Objekt zurücksetzen int sqlite3_reset(sqlite3_stmt *pStmt); ---------- Diese Funktion setzt ein Prepared Statement Objekt auf seinen Anfangszustand zurück, so dass es ein weiteres Mal per sqlite3_step() ausgeführt werden kann. Das ist vor allem im Zusammenhang mit der sqlite3_bind_*() text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_step&rev=1663869537 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,… text/html 2022-09-22T19:58:57+0200 Anonymous (anonymous@undisclosed.example.com) https://www.proggen.org/doku.php?id=dbs:sqlite:libsqlite3:ref:sqlite3_stmt&rev=1663869537 SQL Statement Objekt typedef struct sqlite3_stmt sqlite3_stmt; ---------- Eine Instanz dieses Objekts repräsentiert ein einzelnes SQL-Kommando. Man nennt diese Objekt oft auch „prepared statement“, „compiliertes SQL statement“ oder einfach nur