summaryrefslogtreecommitdiff
path: root/c/sqlite3.h
diff options
context:
space:
mode:
Diffstat (limited to 'c/sqlite3.h')
-rw-r--r--c/sqlite3.h42
1 files changed, 36 insertions, 6 deletions
diff --git a/c/sqlite3.h b/c/sqlite3.h
index 33dbec2..f0df724 100644
--- a/c/sqlite3.h
+++ b/c/sqlite3.h
@@ -146,9 +146,9 @@ extern "C" {
146** [sqlite3_libversion_number()], [sqlite3_sourceid()], 146** [sqlite3_libversion_number()], [sqlite3_sourceid()],
147** [sqlite_version()] and [sqlite_source_id()]. 147** [sqlite_version()] and [sqlite_source_id()].
148*/ 148*/
149#define SQLITE_VERSION "3.38.2" 149#define SQLITE_VERSION "3.39.2"
150#define SQLITE_VERSION_NUMBER 3038002 150#define SQLITE_VERSION_NUMBER 3039002
151#define SQLITE_SOURCE_ID "2022-03-26 13:51:10 d33c709cc0af66bc5b6dc6216eba9f1f0b40960b9ae83694c986fbf4c1d6f08f" 151#define SQLITE_SOURCE_ID "2022-07-21 15:24:47 698edb77537b67c41adc68f9b892db56bcf9a55e00371a61420f3ddd668e6603"
152 152
153/* 153/*
154** CAPI3REF: Run-Time Library Version Numbers 154** CAPI3REF: Run-Time Library Version Numbers
@@ -5593,7 +5593,8 @@ SQLITE_API unsigned int sqlite3_value_subtype(sqlite3_value*);
5593** object D and returns a pointer to that copy. ^The [sqlite3_value] returned 5593** object D and returns a pointer to that copy. ^The [sqlite3_value] returned
5594** is a [protected sqlite3_value] object even if the input is not. 5594** is a [protected sqlite3_value] object even if the input is not.
5595** ^The sqlite3_value_dup(V) interface returns NULL if V is NULL or if a 5595** ^The sqlite3_value_dup(V) interface returns NULL if V is NULL or if a
5596** memory allocation fails. 5596** memory allocation fails. ^If V is a [pointer value], then the result
5597** of sqlite3_value_dup(V) is a NULL value.
5597** 5598**
5598** ^The sqlite3_value_free(V) interface frees an [sqlite3_value] object 5599** ^The sqlite3_value_free(V) interface frees an [sqlite3_value] object
5599** previously obtained from [sqlite3_value_dup()]. ^If V is a NULL pointer 5600** previously obtained from [sqlite3_value_dup()]. ^If V is a NULL pointer
@@ -6276,6 +6277,28 @@ SQLITE_API int sqlite3_get_autocommit(sqlite3*);
6276SQLITE_API sqlite3 *sqlite3_db_handle(sqlite3_stmt*); 6277SQLITE_API sqlite3 *sqlite3_db_handle(sqlite3_stmt*);
6277 6278
6278/* 6279/*
6280** CAPI3REF: Return The Schema Name For A Database Connection
6281** METHOD: sqlite3
6282**
6283** ^The sqlite3_db_name(D,N) interface returns a pointer to the schema name
6284** for the N-th database on database connection D, or a NULL pointer of N is
6285** out of range. An N value of 0 means the main database file. An N of 1 is
6286** the "temp" schema. Larger values of N correspond to various ATTACH-ed
6287** databases.
6288**
6289** Space to hold the string that is returned by sqlite3_db_name() is managed
6290** by SQLite itself. The string might be deallocated by any operation that
6291** changes the schema, including [ATTACH] or [DETACH] or calls to
6292** [sqlite3_serialize()] or [sqlite3_deserialize()], even operations that
6293** occur on a different thread. Applications that need to
6294** remember the string long-term should make their own copy. Applications that
6295** are accessing the same database connection simultaneously on multiple
6296** threads should mutex-protect calls to this API and should make their own
6297** private copy of the result prior to releasing the mutex.
6298*/
6299SQLITE_API const char *sqlite3_db_name(sqlite3 *db, int N);
6300
6301/*
6279** CAPI3REF: Return The Filename For A Database Connection 6302** CAPI3REF: Return The Filename For A Database Connection
6280** METHOD: sqlite3 6303** METHOD: sqlite3
6281** 6304**
@@ -9554,8 +9577,8 @@ SQLITE_API SQLITE_EXPERIMENTAL const char *sqlite3_vtab_collation(sqlite3_index_
9554** of a [virtual table] implementation. The result of calling this 9577** of a [virtual table] implementation. The result of calling this
9555** interface from outside of xBestIndex() is undefined and probably harmful. 9578** interface from outside of xBestIndex() is undefined and probably harmful.
9556** 9579**
9557** ^The sqlite3_vtab_distinct() interface returns an integer that is 9580** ^The sqlite3_vtab_distinct() interface returns an integer between 0 and
9558** either 0, 1, or 2. The integer returned by sqlite3_vtab_distinct() 9581** 3. The integer returned by sqlite3_vtab_distinct()
9559** gives the virtual table additional information about how the query 9582** gives the virtual table additional information about how the query
9560** planner wants the output to be ordered. As long as the virtual table 9583** planner wants the output to be ordered. As long as the virtual table
9561** can meet the ordering requirements of the query planner, it may set 9584** can meet the ordering requirements of the query planner, it may set
@@ -9587,6 +9610,13 @@ SQLITE_API SQLITE_EXPERIMENTAL const char *sqlite3_vtab_collation(sqlite3_index_
9587** that have the same value for all columns identified by "aOrderBy". 9610** that have the same value for all columns identified by "aOrderBy".
9588** ^However omitting the extra rows is optional. 9611** ^However omitting the extra rows is optional.
9589** This mode is used for a DISTINCT query. 9612** This mode is used for a DISTINCT query.
9613** <li value="3"><p>
9614** ^(If the sqlite3_vtab_distinct() interface returns 3, that means
9615** that the query planner needs only distinct rows but it does need the
9616** rows to be sorted.)^ ^The virtual table implementation is free to omit
9617** rows that are identical in all aOrderBy columns, if it wants to, but
9618** it is not required to omit any rows. This mode is used for queries
9619** that have both DISTINCT and ORDER BY clauses.
9590** </ol> 9620** </ol>
9591** 9621**
9592** ^For the purposes of comparing virtual table output values to see if the 9622** ^For the purposes of comparing virtual table output values to see if the