|
@@ -146,9 +146,9 @@ extern "C" {
|
|
|
** [sqlite3_libversion_number()], [sqlite3_sourceid()],
|
|
|
** [sqlite_version()] and [sqlite_source_id()].
|
|
|
*/
|
|
|
-#define SQLITE_VERSION "3.39.4"
|
|
|
-#define SQLITE_VERSION_NUMBER 3039004
|
|
|
-#define SQLITE_SOURCE_ID "2022-09-29 15:55:41 a29f9949895322123f7c38fbe94c649a9d6e6c9cd0c3b41c96d694552f26alt1"
|
|
|
+#define SQLITE_VERSION "3.40.0"
|
|
|
+#define SQLITE_VERSION_NUMBER 3040000
|
|
|
+#define SQLITE_SOURCE_ID "2022-11-16 12:10:08 89c459e766ea7e9165d0beeb124708b955a4950d0f4792f457465d71b158alt1"
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Run-Time Library Version Numbers
|
|
@@ -670,13 +670,17 @@ SQLITE_API int sqlite3_exec(
|
|
|
**
|
|
|
** SQLite uses one of these integer values as the second
|
|
|
** argument to calls it makes to the xLock() and xUnlock() methods
|
|
|
-** of an [sqlite3_io_methods] object.
|
|
|
+** of an [sqlite3_io_methods] object. These values are ordered from
|
|
|
+** lest restrictive to most restrictive.
|
|
|
+**
|
|
|
+** The argument to xLock() is always SHARED or higher. The argument to
|
|
|
+** xUnlock is either SHARED or NONE.
|
|
|
*/
|
|
|
-#define SQLITE_LOCK_NONE 0
|
|
|
-#define SQLITE_LOCK_SHARED 1
|
|
|
-#define SQLITE_LOCK_RESERVED 2
|
|
|
-#define SQLITE_LOCK_PENDING 3
|
|
|
-#define SQLITE_LOCK_EXCLUSIVE 4
|
|
|
+#define SQLITE_LOCK_NONE 0 /* xUnlock() only */
|
|
|
+#define SQLITE_LOCK_SHARED 1 /* xLock() or xUnlock() */
|
|
|
+#define SQLITE_LOCK_RESERVED 2 /* xLock() only */
|
|
|
+#define SQLITE_LOCK_PENDING 3 /* xLock() only */
|
|
|
+#define SQLITE_LOCK_EXCLUSIVE 4 /* xLock() only */
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Synchronization Type Flags
|
|
@@ -754,7 +758,14 @@ struct sqlite3_file {
|
|
|
** <li> [SQLITE_LOCK_PENDING], or
|
|
|
** <li> [SQLITE_LOCK_EXCLUSIVE].
|
|
|
** </ul>
|
|
|
-** xLock() increases the lock. xUnlock() decreases the lock.
|
|
|
+** xLock() upgrades the database file lock. In other words, xLock() moves the
|
|
|
+** database file lock in the direction NONE toward EXCLUSIVE. The argument to
|
|
|
+** xLock() is always on of SHARED, RESERVED, PENDING, or EXCLUSIVE, never
|
|
|
+** SQLITE_LOCK_NONE. If the database file lock is already at or above the
|
|
|
+** requested lock, then the call to xLock() is a no-op.
|
|
|
+** xUnlock() downgrades the database file lock to either SHARED or NONE.
|
|
|
+* If the lock is already at or below the requested lock state, then the call
|
|
|
+** to xUnlock() is a no-op.
|
|
|
** The xCheckReservedLock() method checks whether any database connection,
|
|
|
** either in this process or in some other process, is holding a RESERVED,
|
|
|
** PENDING, or EXCLUSIVE lock on the file. It returns true
|
|
@@ -859,9 +870,8 @@ struct sqlite3_io_methods {
|
|
|
** opcode causes the xFileControl method to write the current state of
|
|
|
** the lock (one of [SQLITE_LOCK_NONE], [SQLITE_LOCK_SHARED],
|
|
|
** [SQLITE_LOCK_RESERVED], [SQLITE_LOCK_PENDING], or [SQLITE_LOCK_EXCLUSIVE])
|
|
|
-** into an integer that the pArg argument points to. This capability
|
|
|
-** is used during testing and is only available when the SQLITE_TEST
|
|
|
-** compile-time option is used.
|
|
|
+** into an integer that the pArg argument points to.
|
|
|
+** This capability is only available if SQLite is compiled with [SQLITE_DEBUG].
|
|
|
**
|
|
|
** <li>[[SQLITE_FCNTL_SIZE_HINT]]
|
|
|
** The [SQLITE_FCNTL_SIZE_HINT] opcode is used by SQLite to give the VFS
|
|
@@ -1253,6 +1263,26 @@ typedef struct sqlite3_mutex sqlite3_mutex;
|
|
|
*/
|
|
|
typedef struct sqlite3_api_routines sqlite3_api_routines;
|
|
|
|
|
|
+/*
|
|
|
+** CAPI3REF: File Name
|
|
|
+**
|
|
|
+** Type [sqlite3_filename] is used by SQLite to pass filenames to the
|
|
|
+** xOpen method of a [VFS]. It may be cast to (const char*) and treated
|
|
|
+** as a normal, nul-terminated, UTF-8 buffer containing the filename, but
|
|
|
+** may also be passed to special APIs such as:
|
|
|
+**
|
|
|
+** <ul>
|
|
|
+** <li> sqlite3_filename_database()
|
|
|
+** <li> sqlite3_filename_journal()
|
|
|
+** <li> sqlite3_filename_wal()
|
|
|
+** <li> sqlite3_uri_parameter()
|
|
|
+** <li> sqlite3_uri_boolean()
|
|
|
+** <li> sqlite3_uri_int64()
|
|
|
+** <li> sqlite3_uri_key()
|
|
|
+** </ul>
|
|
|
+*/
|
|
|
+typedef const char *sqlite3_filename;
|
|
|
+
|
|
|
/*
|
|
|
** CAPI3REF: OS Interface Object
|
|
|
**
|
|
@@ -1431,7 +1461,7 @@ struct sqlite3_vfs {
|
|
|
sqlite3_vfs *pNext; /* Next registered VFS */
|
|
|
const char *zName; /* Name of this virtual file system */
|
|
|
void *pAppData; /* Pointer to application-specific data */
|
|
|
- int (*xOpen)(sqlite3_vfs*, const char *zName, sqlite3_file*,
|
|
|
+ int (*xOpen)(sqlite3_vfs*, sqlite3_filename zName, sqlite3_file*,
|
|
|
int flags, int *pOutFlags);
|
|
|
int (*xDelete)(sqlite3_vfs*, const char *zName, int syncDir);
|
|
|
int (*xAccess)(sqlite3_vfs*, const char *zName, int flags, int *pResOut);
|
|
@@ -2309,6 +2339,7 @@ struct sqlite3_mem_methods {
|
|
|
** <ul>
|
|
|
** <li> The [PRAGMA writable_schema=ON] statement.
|
|
|
** <li> The [PRAGMA journal_mode=OFF] statement.
|
|
|
+** <li> The [PRAGMA schema_version=N] statement.
|
|
|
** <li> Writes to the [sqlite_dbpage] virtual table.
|
|
|
** <li> Direct writes to [shadow tables].
|
|
|
** </ul>
|
|
@@ -3424,6 +3455,9 @@ SQLITE_API void sqlite3_progress_handler(sqlite3*, int, int(*)(void*), void*);
|
|
|
** <dd>The database is opened [shared cache] enabled, overriding
|
|
|
** the default shared cache setting provided by
|
|
|
** [sqlite3_enable_shared_cache()].)^
|
|
|
+** The [use of shared cache mode is discouraged] and hence shared cache
|
|
|
+** capabilities may be omitted from many builds of SQLite. In such cases,
|
|
|
+** this option is a no-op.
|
|
|
**
|
|
|
** ^(<dt>[SQLITE_OPEN_PRIVATECACHE]</dt>
|
|
|
** <dd>The database is opened [shared cache] disabled, overriding
|
|
@@ -3439,7 +3473,7 @@ SQLITE_API void sqlite3_progress_handler(sqlite3*, int, int(*)(void*), void*);
|
|
|
** to return an extended result code.</dd>
|
|
|
**
|
|
|
** [[OPEN_NOFOLLOW]] ^(<dt>[SQLITE_OPEN_NOFOLLOW]</dt>
|
|
|
-** <dd>The database filename is not allowed to be a symbolic link</dd>
|
|
|
+** <dd>The database filename is not allowed to contain a symbolic link</dd>
|
|
|
** </dl>)^
|
|
|
**
|
|
|
** If the 3rd parameter to sqlite3_open_v2() is not one of the
|
|
@@ -3698,10 +3732,10 @@ SQLITE_API int sqlite3_open_v2(
|
|
|
**
|
|
|
** See the [URI filename] documentation for additional information.
|
|
|
*/
|
|
|
-SQLITE_API const char *sqlite3_uri_parameter(const char *zFilename, const char *zParam);
|
|
|
-SQLITE_API int sqlite3_uri_boolean(const char *zFile, const char *zParam, int bDefault);
|
|
|
-SQLITE_API sqlite3_int64 sqlite3_uri_int64(const char*, const char*, sqlite3_int64);
|
|
|
-SQLITE_API const char *sqlite3_uri_key(const char *zFilename, int N);
|
|
|
+SQLITE_API const char *sqlite3_uri_parameter(sqlite3_filename z, const char *zParam);
|
|
|
+SQLITE_API int sqlite3_uri_boolean(sqlite3_filename z, const char *zParam, int bDefault);
|
|
|
+SQLITE_API sqlite3_int64 sqlite3_uri_int64(sqlite3_filename, const char*, sqlite3_int64);
|
|
|
+SQLITE_API const char *sqlite3_uri_key(sqlite3_filename z, int N);
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Translate filenames
|
|
@@ -3730,9 +3764,9 @@ SQLITE_API const char *sqlite3_uri_key(const char *zFilename, int N);
|
|
|
** return value from [sqlite3_db_filename()], then the result is
|
|
|
** undefined and is likely a memory access violation.
|
|
|
*/
|
|
|
-SQLITE_API const char *sqlite3_filename_database(const char*);
|
|
|
-SQLITE_API const char *sqlite3_filename_journal(const char*);
|
|
|
-SQLITE_API const char *sqlite3_filename_wal(const char*);
|
|
|
+SQLITE_API const char *sqlite3_filename_database(sqlite3_filename);
|
|
|
+SQLITE_API const char *sqlite3_filename_journal(sqlite3_filename);
|
|
|
+SQLITE_API const char *sqlite3_filename_wal(sqlite3_filename);
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Database File Corresponding To A Journal
|
|
@@ -3798,14 +3832,14 @@ SQLITE_API sqlite3_file *sqlite3_database_file_object(const char*);
|
|
|
** then the corresponding [sqlite3_module.xClose() method should also be
|
|
|
** invoked prior to calling sqlite3_free_filename(Y).
|
|
|
*/
|
|
|
-SQLITE_API char *sqlite3_create_filename(
|
|
|
+SQLITE_API sqlite3_filename sqlite3_create_filename(
|
|
|
const char *zDatabase,
|
|
|
const char *zJournal,
|
|
|
const char *zWal,
|
|
|
int nParam,
|
|
|
const char **azParam
|
|
|
);
|
|
|
-SQLITE_API void sqlite3_free_filename(char*);
|
|
|
+SQLITE_API void sqlite3_free_filename(sqlite3_filename);
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Error Codes And Messages
|
|
@@ -5508,6 +5542,16 @@ SQLITE_API SQLITE_DEPRECATED int sqlite3_memory_alarm(void(*)(void*,sqlite3_int6
|
|
|
** then the conversion is performed. Otherwise no conversion occurs.
|
|
|
** The [SQLITE_INTEGER | datatype] after conversion is returned.)^
|
|
|
**
|
|
|
+** ^(The sqlite3_value_encoding(X) interface returns one of [SQLITE_UTF8],
|
|
|
+** [SQLITE_UTF16BE], or [SQLITE_UTF16LE] according to the current encoding
|
|
|
+** of the value X, assuming that X has type TEXT.)^ If sqlite3_value_type(X)
|
|
|
+** returns something other than SQLITE_TEXT, then the return value from
|
|
|
+** sqlite3_value_encoding(X) is meaningless. ^Calls to
|
|
|
+** sqlite3_value_text(X), sqlite3_value_text16(X), sqlite3_value_text16be(X),
|
|
|
+** sqlite3_value_text16le(X), sqlite3_value_bytes(X), or
|
|
|
+** sqlite3_value_bytes16(X) might change the encoding of the value X and
|
|
|
+** thus change the return from subsequent calls to sqlite3_value_encoding(X).
|
|
|
+**
|
|
|
** ^Within the [xUpdate] method of a [virtual table], the
|
|
|
** sqlite3_value_nochange(X) interface returns true if and only if
|
|
|
** the column corresponding to X is unchanged by the UPDATE operation
|
|
@@ -5572,6 +5616,7 @@ SQLITE_API int sqlite3_value_type(sqlite3_value*);
|
|
|
SQLITE_API int sqlite3_value_numeric_type(sqlite3_value*);
|
|
|
SQLITE_API int sqlite3_value_nochange(sqlite3_value*);
|
|
|
SQLITE_API int sqlite3_value_frombind(sqlite3_value*);
|
|
|
+SQLITE_API int sqlite3_value_encoding(sqlite3_value*);
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Finding The Subtype Of SQL Values
|
|
@@ -5625,7 +5670,7 @@ SQLITE_API void sqlite3_value_free(sqlite3_value*);
|
|
|
**
|
|
|
** ^The sqlite3_aggregate_context(C,N) routine returns a NULL pointer
|
|
|
** when first called if N is less than or equal to zero or if a memory
|
|
|
-** allocate error occurs.
|
|
|
+** allocation error occurs.
|
|
|
**
|
|
|
** ^(The amount of space allocated by sqlite3_aggregate_context(C,N) is
|
|
|
** determined by the N parameter on first successful call. Changing the
|
|
@@ -5830,9 +5875,10 @@ typedef void (*sqlite3_destructor_type)(void*);
|
|
|
** of [SQLITE_UTF8], [SQLITE_UTF16], [SQLITE_UTF16BE], or [SQLITE_UTF16LE].
|
|
|
** ^SQLite takes the text result from the application from
|
|
|
** the 2nd parameter of the sqlite3_result_text* interfaces.
|
|
|
-** ^If the 3rd parameter to the sqlite3_result_text* interfaces
|
|
|
-** is negative, then SQLite takes result text from the 2nd parameter
|
|
|
-** through the first zero character.
|
|
|
+** ^If the 3rd parameter to any of the sqlite3_result_text* interfaces
|
|
|
+** other than sqlite3_result_text64() is negative, then SQLite computes
|
|
|
+** the string length itself by searching the 2nd parameter for the first
|
|
|
+** zero character.
|
|
|
** ^If the 3rd parameter to the sqlite3_result_text* interfaces
|
|
|
** is non-negative, then as many bytes (not characters) of the text
|
|
|
** pointed to by the 2nd parameter are taken as the application-defined
|
|
@@ -6328,7 +6374,7 @@ SQLITE_API const char *sqlite3_db_name(sqlite3 *db, int N);
|
|
|
** <li> [sqlite3_filename_wal()]
|
|
|
** </ul>
|
|
|
*/
|
|
|
-SQLITE_API const char *sqlite3_db_filename(sqlite3 *db, const char *zDbName);
|
|
|
+SQLITE_API sqlite3_filename sqlite3_db_filename(sqlite3 *db, const char *zDbName);
|
|
|
|
|
|
/*
|
|
|
** CAPI3REF: Determine if a database is read-only
|
|
@@ -6465,7 +6511,7 @@ SQLITE_API void *sqlite3_rollback_hook(sqlite3*, void(*)(void *), void*);
|
|
|
** function C that is invoked prior to each autovacuum of the database
|
|
|
** file. ^The callback is passed a copy of the generic data pointer (P),
|
|
|
** the schema-name of the attached database that is being autovacuumed,
|
|
|
-** the the size of the database file in pages, the number of free pages,
|
|
|
+** the size of the database file in pages, the number of free pages,
|
|
|
** and the number of bytes per page, respectively. The callback should
|
|
|
** return the number of free pages that should be removed by the
|
|
|
** autovacuum. ^If the callback returns zero, then no autovacuum happens.
|
|
@@ -6586,6 +6632,11 @@ SQLITE_API void *sqlite3_update_hook(
|
|
|
** to the same database. Sharing is enabled if the argument is true
|
|
|
** and disabled if the argument is false.)^
|
|
|
**
|
|
|
+** This interface is omitted if SQLite is compiled with
|
|
|
+** [-DSQLITE_OMIT_SHARED_CACHE]. The [-DSQLITE_OMIT_SHARED_CACHE]
|
|
|
+** compile-time option is recommended because the
|
|
|
+** [use of shared cache mode is discouraged].
|
|
|
+**
|
|
|
** ^Cache sharing is enabled and disabled for an entire process.
|
|
|
** This is a change as of SQLite [version 3.5.0] ([dateof:3.5.0]).
|
|
|
** In prior versions of SQLite,
|
|
@@ -6684,7 +6735,7 @@ SQLITE_API int sqlite3_db_release_memory(sqlite3*);
|
|
|
** ^The soft heap limit may not be greater than the hard heap limit.
|
|
|
** ^If the hard heap limit is enabled and if sqlite3_soft_heap_limit(N)
|
|
|
** is invoked with a value of N that is greater than the hard heap limit,
|
|
|
-** the the soft heap limit is set to the value of the hard heap limit.
|
|
|
+** the soft heap limit is set to the value of the hard heap limit.
|
|
|
** ^The soft heap limit is automatically enabled whenever the hard heap
|
|
|
** limit is enabled. ^When sqlite3_hard_heap_limit64(N) is invoked and
|
|
|
** the soft heap limit is outside the range of 1..N, then the soft heap
|
|
@@ -8979,7 +9030,7 @@ typedef struct sqlite3_backup sqlite3_backup;
|
|
|
** if the application incorrectly accesses the destination [database connection]
|
|
|
** and so no error code is reported, but the operations may malfunction
|
|
|
** nevertheless. Use of the destination database connection while a
|
|
|
-** backup is in progress might also also cause a mutex deadlock.
|
|
|
+** backup is in progress might also cause a mutex deadlock.
|
|
|
**
|
|
|
** If running in [shared cache mode], the application must
|
|
|
** guarantee that the shared cache used by the destination database
|
|
@@ -9407,7 +9458,7 @@ SQLITE_API int sqlite3_wal_checkpoint_v2(
|
|
|
*/
|
|
|
#define SQLITE_CHECKPOINT_PASSIVE 0 /* Do as much as possible w/o blocking */
|
|
|
#define SQLITE_CHECKPOINT_FULL 1 /* Wait for writers, then checkpoint */
|
|
|
-#define SQLITE_CHECKPOINT_RESTART 2 /* Like FULL but wait for for readers */
|
|
|
+#define SQLITE_CHECKPOINT_RESTART 2 /* Like FULL but wait for readers */
|
|
|
#define SQLITE_CHECKPOINT_TRUNCATE 3 /* Like RESTART but also truncate WAL */
|
|
|
|
|
|
/*
|