Small. Fast. Reliable.
Choose any three.

About Sitemap Documentation Download License News Developers Support

This document contains the text of all requirements that define the operation of SQLite.

This document is currently a work in progress. It is incomplete and inaccurate. Check back later for further updates.

## Requirements

> F10010 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_VERSION         "3.5.9"
>     #define SQLITE_VERSION_NUMBER  3005009
F10011 | The SQLITE_VERSION #define in the sqlite3.h header file evaluates to a string literal that is the SQLite version with which the header file is associated.
F10014 | The SQLITE_VERSION_NUMBER #define resolves to an integer with the value (X*1000000 + Y*1000 + Z) where X, Y, and Z are the major version, minor version, and release number.
> F10020 | The sqlite3.h header file defines the following interfaces:
>     SQLITE_EXTERN const char sqlite3_version[];
>     const char *sqlite3_libversion(void);
>     int sqlite3_libversion_number(void);
F10021 | The sqlite3_libversion_number() interface returns an integer equal to SQLITE_VERSION_NUMBER.
F10022 | The sqlite3_version string constant contains the text of the SQLITE_VERSION string.
F10023 | The sqlite3_libversion() function returns a pointer to the sqlite3_version string constant.
> F10100 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_threadsafe(void);
F10101 | The sqlite3_threadsafe() function returns nonzero if SQLite was compiled with its mutexes enabled or zero if SQLite was compiled with mutexes disabled.
> F10200 | The sqlite3.h header file defines the following interfaces:
>     #ifdef SQLITE_INT64_TYPE
>       typedef SQLITE_INT64_TYPE sqlite_int64;
>       typedef unsigned SQLITE_INT64_TYPE sqlite_uint64;
>     #elif defined(_MSC_VER) || defined(__BORLANDC__)
>       typedef __int64 sqlite_int64;
>       typedef unsigned __int64 sqlite_uint64;
>     #else
>       typedef long long int sqlite_int64;
>       typedef unsigned long long int sqlite_uint64;
>     #endif
>     typedef sqlite_int64 sqlite3_int64;
>     typedef sqlite_uint64 sqlite3_uint64;
F10201 | The sqlite_int64 and sqlite3_int64 types specify a 64-bit signed integer.
F10202 | The sqlite_uint64 and sqlite3_uint64 types specify a 64-bit unsigned integer.
> F10210 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_OK           0   /* Successful result */
>     /* beginning-of-error-codes */
>     #define SQLITE_ERROR        1   /* SQL error or missing database */
>     #define SQLITE_INTERNAL     2   /* Internal logic error in SQLite */
>     #define SQLITE_PERM         3   /* Access permission denied */
>     #define SQLITE_ABORT        4   /* Callback routine requested an abort */
>     #define SQLITE_BUSY         5   /* The database file is locked */
>     #define SQLITE_LOCKED       6   /* A table in the database is locked */
>     #define SQLITE_NOMEM        7   /* A malloc() failed */
>     #define SQLITE_READONLY     8   /* Attempt to write a readonly database */
>     #define SQLITE_INTERRUPT    9   /* Operation terminated by sqlite3_interrupt()*/
>     #define SQLITE_IOERR       10   /* Some kind of disk I/O error occurred */
>     #define SQLITE_CORRUPT     11   /* The database disk image is malformed */
>     #define SQLITE_NOTFOUND    12   /* NOT USED. Table or record not found */
>     #define SQLITE_FULL        13   /* Insertion failed because database is full */
>     #define SQLITE_CANTOPEN    14   /* Unable to open the database file */
>     #define SQLITE_PROTOCOL    15   /* NOT USED. Database lock protocol error */
>     #define SQLITE_EMPTY       16   /* Database is empty */
>     #define SQLITE_SCHEMA      17   /* The database schema changed */
>     #define SQLITE_TOOBIG      18   /* String or BLOB exceeds size limit */
>     #define SQLITE_CONSTRAINT  19   /* Abort due to constraint violation */
>     #define SQLITE_MISMATCH    20   /* Data type mismatch */
>     #define SQLITE_MISUSE      21   /* Library used incorrectly */
>     #define SQLITE_NOLFS       22   /* Uses OS features not supported on host */
>     #define SQLITE_AUTH        23   /* Authorization denied */
>     #define SQLITE_FORMAT      24   /* Auxiliary database format error */
>     #define SQLITE_RANGE       25   /* 2nd parameter to sqlite3_bind out of range */
>     #define SQLITE_NOTADB      26   /* File opened that is not a database file */
>     #define SQLITE_ROW         100  /* sqlite3_step() has another row ready */
>     #define SQLITE_DONE        101  /* sqlite3_step() has finished executing */
>     /* end-of-error-codes */
> F10220 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_IOERR_READ          (SQLITE_IOERR | (1<<8))
>     #define SQLITE_IOERR_SHORT_READ    (SQLITE_IOERR | (2<<8))
>     #define SQLITE_IOERR_WRITE         (SQLITE_IOERR | (3<<8))
>     #define SQLITE_IOERR_FSYNC         (SQLITE_IOERR | (4<<8))
>     #define SQLITE_IOERR_DIR_FSYNC     (SQLITE_IOERR | (5<<8))
>     #define SQLITE_IOERR_TRUNCATE      (SQLITE_IOERR | (6<<8))
>     #define SQLITE_IOERR_FSTAT         (SQLITE_IOERR | (7<<8))
>     #define SQLITE_IOERR_UNLOCK        (SQLITE_IOERR | (8<<8))
>     #define SQLITE_IOERR_RDLOCK        (SQLITE_IOERR | (9<<8))
>     #define SQLITE_IOERR_DELETE        (SQLITE_IOERR | (10<<8))
>     #define SQLITE_IOERR_BLOCKED       (SQLITE_IOERR | (11<<8))
>     #define SQLITE_IOERR_NOMEM         (SQLITE_IOERR | (12<<8))
F10223 | The symbolic name for an extended result code always contains a related primary result code as a prefix.
F10224 | Primary result code names contain a single "_" character.
F10225 | Extended result code names contain two or more "_" characters.
F10226 | The numeric value of an extended result code contains the numeric value of its corresponding primary result code in its least significant 8 bits.
> F10230 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_OPEN_READONLY         0x00000001
>     #define SQLITE_OPEN_READWRITE        0x00000002
>     #define SQLITE_OPEN_CREATE           0x00000004
>     #define SQLITE_OPEN_DELETEONCLOSE    0x00000008
>     #define SQLITE_OPEN_EXCLUSIVE        0x00000010
>     #define SQLITE_OPEN_MAIN_DB          0x00000100
>     #define SQLITE_OPEN_TEMP_DB          0x00000200
>     #define SQLITE_OPEN_TRANSIENT_DB     0x00000400
>     #define SQLITE_OPEN_MAIN_JOURNAL     0x00000800
>     #define SQLITE_OPEN_TEMP_JOURNAL     0x00001000
>     #define SQLITE_OPEN_SUBJOURNAL       0x00002000
>     #define SQLITE_OPEN_MASTER_JOURNAL   0x00004000
> F10240 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_IOCAP_ATOMIC          0x00000001
>     #define SQLITE_IOCAP_ATOMIC512       0x00000002
>     #define SQLITE_IOCAP_ATOMIC1K        0x00000004
>     #define SQLITE_IOCAP_ATOMIC2K        0x00000008
>     #define SQLITE_IOCAP_ATOMIC4K        0x00000010
>     #define SQLITE_IOCAP_ATOMIC8K        0x00000020
>     #define SQLITE_IOCAP_ATOMIC16K       0x00000040
>     #define SQLITE_IOCAP_ATOMIC32K       0x00000080
>     #define SQLITE_IOCAP_ATOMIC64K       0x00000100
>     #define SQLITE_IOCAP_SAFE_APPEND     0x00000200
>     #define SQLITE_IOCAP_SEQUENTIAL      0x00000400
> F10250 | The sqlite3.h header file defines the following interfaces:
>     #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
> F10260 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_SYNC_NORMAL        0x00002
>     #define SQLITE_SYNC_FULL          0x00003
>     #define SQLITE_SYNC_DATAONLY      0x00010
> F10265 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_INTEGER  1
>     #define SQLITE_FLOAT    2
>     #define SQLITE_BLOB     4
>     #define SQLITE_NULL     5
>     #ifdef SQLITE_TEXT
>     # undef SQLITE_TEXT
>     #else
>     # define SQLITE_TEXT     3
>     #endif
>     #define SQLITE3_TEXT     3
> F10267 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_UTF8           1
>     #define SQLITE_UTF16LE        2
>     #define SQLITE_UTF16BE        3
>     #define SQLITE_UTF16          4    /* Use native byte order */
>     #define SQLITE_ANY            5    /* sqlite3_create_function only */
>     #define SQLITE_UTF16_ALIGNED  8    /* sqlite3_create_collation only */
> F10280 | The sqlite3.h header file defines the following interfaces:
>     typedef void (*sqlite3_destructor_type)(void*);
>     #define SQLITE_STATIC      ((sqlite3_destructor_type)0)
>     #define SQLITE_TRANSIENT   ((sqlite3_destructor_type)-1)
> F10310 | The sqlite3.h header file defines the following interfaces:
>     SQLITE_EXTERN char *sqlite3_temp_directory;
> F10330 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_enable_shared_cache(int);
F10331 | A successful invocation of sqlite3_enable_shared_cache(B) will enable or disable shared cache mode for any subsequently created database connection in the same process.
F10336 | When shared cache is enabled, the sqlite3_create_module() interface will always return an error.
F10337 | The sqlite3_enable_shared_cache(B) interface returns SQLITE_OK if shared cache was enabled or disabled successfully.
F10339 | Shared cache is disabled by default.
> F10510 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_complete(const char *sql);
>     int sqlite3_complete16(const void *sql);
F10511 | The sqlite3_complete() and sqlite3_complete16() functions return true (non-zero) if and only if the last non-whitespace token in their input is a semicolon that is not in between the BEGIN and END of a CREATE TRIGGER statement.
> F10530 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_sleep(int);
F10533 | The sqlite3_sleep(M) interface invokes the xSleep method of the default VFS in order to suspend execution of the current thread for at least M milliseconds.
F10536 | The sqlite3_sleep(M) interface returns the number of milliseconds of sleep actually requested of the operating system, which might be larger than the parameter M.
> F11110 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_file sqlite3_file;
>     struct sqlite3_file {
>       const struct sqlite3_io_methods *pMethods;  /* Methods for an open file */
>     };
> F11120 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_io_methods sqlite3_io_methods;
>     struct sqlite3_io_methods {
>       int iVersion;
>       int (*xClose)(sqlite3_file*);
>       int (*xRead)(sqlite3_file*, void*, int iAmt, sqlite3_int64 iOfst);
>       int (*xWrite)(sqlite3_file*, const void*, int iAmt, sqlite3_int64 iOfst);
>       int (*xTruncate)(sqlite3_file*, sqlite3_int64 size);
>       int (*xSync)(sqlite3_file*, int flags);
>       int (*xFileSize)(sqlite3_file*, sqlite3_int64 *pSize);
>       int (*xLock)(sqlite3_file*, int);
>       int (*xUnlock)(sqlite3_file*, int);
>       int (*xCheckReservedLock)(sqlite3_file*);
>       int (*xFileControl)(sqlite3_file*, int op, void *pArg);
>       int (*xSectorSize)(sqlite3_file*);
>       int (*xDeviceCharacteristics)(sqlite3_file*);
>       /* Additional methods may be added in future releases */
>     };
> F11140 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_vfs sqlite3_vfs;
>     struct sqlite3_vfs {
>       int iVersion;            /* Structure version number */
>       int szOsFile;            /* Size of subclassed sqlite3_file */
>       int mxPathname;          /* Maximum file pathname length */
>       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 flags, int *pOutFlags);
>       int (*xDelete)(sqlite3_vfs*, const char *zName, int syncDir);
>       int (*xAccess)(sqlite3_vfs*, const char *zName, int flags);
>       int (*xGetTempname)(sqlite3_vfs*, int nOut, char *zOut);
>       int (*xFullPathname)(sqlite3_vfs*, const char *zName, int nOut, char *zOut);
>       void *(*xDlOpen)(sqlite3_vfs*, const char *zFilename);
>       void (*xDlError)(sqlite3_vfs*, int nByte, char *zErrMsg);
>       void *(*xDlSym)(sqlite3_vfs*,void*, const char *zSymbol);
>       void (*xDlClose)(sqlite3_vfs*, void*);
>       int (*xRandomness)(sqlite3_vfs*, int nByte, char *zOut);
>       int (*xSleep)(sqlite3_vfs*, int microseconds);
>       int (*xCurrentTime)(sqlite3_vfs*, double*);
>       /* New fields may be appended in figure versions.  The iVersion
>       ** value will increment whenever this happens. */
>     };
> F11190 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_ACCESS_EXISTS    0
>     #define SQLITE_ACCESS_READWRITE 1
>     #define SQLITE_ACCESS_READ      2
> F11200 | The sqlite3.h header file defines the following interfaces:
>     sqlite3_vfs *sqlite3_vfs_find(const char *zVfsName);
>     int sqlite3_vfs_register(sqlite3_vfs*, int makeDflt);
>     int sqlite3_vfs_unregister(sqlite3_vfs*);
F11203 | The sqlite3_vfs_find(N) interface returns a pointer to the registered sqlite3_vfs object whose name exactly matches the zero-terminated UTF-8 string N, or it returns NULL if there is no match.
F11206 | If the N parameter to sqlite3_vfs_find(N) is NULL then the function returns a pointer to the default sqlite3_vfs object if there is one, or NULL if there is no default sqlite3_vfs object.
F11209 | The sqlite3_vfs_register(P,F) interface registers the well-formed sqlite3_vfs object P using the name given by the zName field of the object.
F11212 | Using the sqlite3_vfs_register(P,F) interface to register the same sqlite3_vfs object multiple times is a harmless no-op.
F11215 | The sqlite3_vfs_register(P,F) interface makes the the sqlite3_vfs object P the default sqlite3_vfs object if F is non-zero.
F11218 | The sqlite3_vfs_unregister(P) interface unregisters the sqlite3_vfs object P so that it is no longer returned by subsequent calls to sqlite3_vfs_find().
> F11300 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_file_control(sqlite3*, const char *zDbName, int op, void*);
F11302 | The sqlite3_finalize(S) interface destroys the prepared statement S and releases all memory and file resources held by that object.
F11304 | If the most recent call to sqlite3_step(S) for the prepared statement S returned an error, then sqlite3_finalize(S) returns that same error.
> F11310 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_FCNTL_LOCKSTATE        1
> F11400 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_test_control(int op, ...);
> F11410 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_TESTCTRL_FAULT_CONFIG             1
>     #define SQLITE_TESTCTRL_FAULT_FAILURES           2
>     #define SQLITE_TESTCTRL_FAULT_BENIGN_FAILURES    3
>     #define SQLITE_TESTCTRL_FAULT_PENDING            4
>     #define SQLITE_TESTCTRL_PRNG_SAVE                5
>     #define SQLITE_TESTCTRL_PRNG_RESTORE             6
>     #define SQLITE_TESTCTRL_PRNG_RESET               7
>     #define SQLITE_TESTCTRL_BITVEC_TEST              8
> F12000 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3 sqlite3;
> F12010 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_close(sqlite3 *);
F12011 | The sqlite3_close() interface destroys an sqlite3 object allocated by a prior call to sqlite3_open(), sqlite3_open16(), or sqlite3_open_v2().
F12012 | The sqlite3_close() function releases all memory used by the connection and closes all open files.
F12013 | If the database connection contains prepared statements that have not been finalized by sqlite3_finalize(), then sqlite3_close() returns SQLITE_BUSY and leaves the connection open.
F12014 | Giving sqlite3_close() a NULL pointer is a harmless no-op.
> F12100 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_exec(
>       sqlite3*,                                  /* An open database */
>       const char *sql,                           /* SQL to be evaluted */
>       int (*callback)(void*,int,char**,char**),  /* Callback function */
>       void *,                                    /* 1st argument to callback */
>       char **errmsg                              /* Error msg written here */
>     );
F12101 | The sqlite3_exec() interface evaluates zero or more UTF-8 encoded, semicolon-separated, SQL statements in the zero-terminated string of its 2nd parameter within the context of the sqlite3 object given in the 1st parameter.
F12104 | The return value of sqlite3_exec() is SQLITE_OK if all SQL statements run successfully.
F12105 | The return value of sqlite3_exec() is an appropriate non-zero error code if any SQL statement fails.
F12107 | If one or more of the SQL statements handed to sqlite3_exec() return results and the 3rd parameter is not NULL, then the callback function specified by the 3rd parameter is invoked once for each row of result.
F12110 | If the callback returns a non-zero value then sqlite3_exec() will aborted the SQL statement it is currently evaluating, skip all subsequent SQL statements, and return SQLITE_ABORT. What happens to *errmsg here? Does the result code for sqlite3_errcode() get set?
F12113 | The sqlite3_exec() routine will pass its 4th parameter through as the 1st parameter of the callback.
F12116 | The sqlite3_exec() routine sets the 2nd parameter of its callback to be the number of columns in the current row of result.
F12119 | The sqlite3_exec() routine sets the 3rd parameter of its callback to be an array of pointers to strings holding the values for each column in the current result set row as obtained from sqlite3_column_text().
F12122 | The sqlite3_exec() routine sets the 4th parameter of its callback to be an array of pointers to strings holding the names of result columns as obtained from sqlite3_column_name().
F12125 | If the 3rd parameter to sqlite3_exec() is NULL then sqlite3_exec() never invokes a callback. All query results are silently discarded.
F12128 | If an error occurs while parsing or evaluating any of the SQL statements handed to sqlite3_exec() then sqlite3_exec() will return an error code other than SQLITE_OK.
F12131 | If an error occurs while parsing or evaluating any of the SQL handed to sqlite3_exec() and if the 5th parameter (errmsg) to sqlite3_exec() is not NULL, then an error message is allocated using the equivalent of sqlite3_mprintf() and *errmsg is made to point to that message.
F12134 | The sqlite3_exec() routine does not change the value of *errmsg if errmsg is NULL or if there are no errors.
F12137 | The sqlite3_exec() function sets the error code and message accessible via sqlite3_errcode(), sqlite3_errmsg(), and sqlite3_errmsg16().
> F12200 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_extended_result_codes(sqlite3*, int onoff);
F12201 | Each new database connection has the extended result codes feature disabled by default.
F12202 | The sqlite3_extended_result_codes(D,F) interface will enable extended result codes for the database connection D if the F parameter is true, or disable them if F is false.
> F12220 | The sqlite3.h header file defines the following interfaces:
>     sqlite3_int64 sqlite3_last_insert_rowid(sqlite3*);
F12221 | The sqlite3_last_insert_rowid() function returns the rowid of the most recent successful insert done on the same database connection and within the same trigger context, or zero if there have been no qualifying inserts on that connection.
F12223 | The sqlite3_last_insert_rowid() function returns same value when called from the same trigger context immediately before and after a ROLLBACK.
> F12240 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_changes(sqlite3*);
F12241 | The sqlite3_changes() function returns the number of row changes caused by the most recent INSERT, UPDATE, or DELETE statement on the same database connection and within the same trigger context, or zero if there have not been any qualifying row changes.
> F12260 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_total_changes(sqlite3*);
F12261 | The sqlite3_total_changes() returns the total number of row changes caused by INSERT, UPDATE, and/or DELETE statements on the same database connection, in any trigger context, since the database connection was created.
> F12270 | The sqlite3.h header file defines the following interfaces:
>     void sqlite3_interrupt(sqlite3*);
F12271 | The sqlite3_interrupt() interface will force all running SQL statements associated with the same database connection to halt after processing at most one additional row of data.
F12272 | Any SQL statement that is interrupted by sqlite3_interrupt() will return SQLITE_INTERRUPT.
> F12280 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_trace(sqlite3*, void(*xTrace)(void*,const char*), void*);
>     void *sqlite3_profile(sqlite3*,
>        void(*xProfile)(void*,const char*,sqlite3_uint64), void*);
F12281 | The callback function registered by sqlite3_trace() is whenever an SQL statement first begins to execute and whenever a trigger subprogram first begins to run.
F12282 | Each call to sqlite3_trace() overrides the previously registered trace callback.
F12283 | A NULL trace callback disables tracing.
F12284 | The first argument to the trace callback is a copy of the pointer which was the 3rd argument to sqlite3_trace().
F12285 | The second argument to the trace callback is a zero-terminated UTF8 string containing the original text of the SQL statement as it was passed into sqlite3_prepare_v2() or the equivalent, or an SQL comment indicating the beginning of a trigger subprogram.
F12287 | The callback function registered by sqlite3_profile() is invoked as each SQL statement finishes.
F12288 | The first parameter to the profile callback is a copy of the 3rd parameter to sqlite3_profile().
F12289 | The second parameter to the profile callback is a zero-terminated UTF-8 string that contains the complete text of the SQL statement as it was processed by sqlite3_prepare_v2() or the equivalent.
F12290 | The third parameter to the profile callback is an estimate of the number of nanoseconds of wall-clock time required to run the SQL statement from start to finish.
> F12310 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_busy_handler(sqlite3*, int(*)(void*,int), void*);
F12311 | The sqlite3_busy_handler() function replaces the busy handler callback in the database connection identified by the 1st parameter with a new busy handler identified by the 2nd and 3rd parameters.
F12312 | The default busy handler for new database connections is NULL.
F12314 | When two or more database connection share a common cache, the busy handler for the database connection currently using the cache is invoked when the cache encounters a lock.
F12316 | If a busy handler callback returns zero, then the SQLite interface that provoked the locking event will return SQLITE_BUSY.
F12318 | SQLite will invokes the busy handler with two argument which are a copy of the pointer supplied by the 3rd parameter to sqlite3_busy_handler() and a count of the number of prior invocations of the busy handler for the same locking event.
> F12340 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_busy_timeout(sqlite3*, int ms);
F12341 | The sqlite3_busy_timeout() function overrides any prior sqlite3_busy_timeout() or sqlite3_busy_handler() setting on the same database connection.
F12343 | If the 2nd parameter to sqlite3_busy_timeout() is less than or equal to zero, then the busy handler is cleared so that all subsequent locking events immediately return SQLITE_BUSY.
F12344 | If the 2nd parameter to sqlite3_busy_timeout() is a positive number N, then a busy handler is set that repeatedly calls the xSleep() method in the VFS interface until either the lock clears or until the cumulative sleep time reported back by xSleep() exceeds N milliseconds.
> F12370 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_get_table(
>       sqlite3*,             /* An open database */
>       const char *sql,      /* SQL to be evaluated */
>       char ***pResult,      /* Results of the query */
>       int *nrow,            /* Number of result rows written here */
>       int *ncolumn,         /* Number of result columns written here */
>       char **errmsg         /* Error msg written here */
>     );
>     void sqlite3_free_table(char **result);
F12371 | If a sqlite3_get_table() fails a memory allocation, then it frees the result table under construction, aborts the query in process, skips any subsequent queries, sets the *resultp output pointer to NULL and returns SQLITE_NOMEM.
F12373 | If the ncolumn parameter to sqlite3_get_table() is not NULL then sqlite3_get_table() write the number of columns in the result set of the query into *ncolumn if the query is successful (if the function returns SQLITE_OK).
F12374 | If the nrow parameter to sqlite3_get_table() is not NULL then sqlite3_get_table() write the number of rows in the result set of the query into *nrow if the query is successful (if the function returns SQLITE_OK).
F12376 | The sqlite3_get_table() function sets its *ncolumn value to the number of columns in the result set of the query in the sql parameter, or to zero if the query in sql has an empty result set.
> F12500 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_set_authorizer(
>       sqlite3*,
>       int (*xAuth)(void*,int,const char*,const char*,const char*,const char*),
>       void *pUserData
>     );
F12501 | The sqlite3_set_authorizer(D,...) interface registers a authorizer callback with database connection D.
F12502 | The authorizer callback is invoked as SQL statements are being compiled
F12503 | If the authorizer callback returns any value other than SQLITE_IGNORE, SQLITE_OK, or SQLITE_DENY then the sqlite3_prepare_v2() or equivalent call that caused the authorizer callback to run shall fail with an SQLITE_ERROR error code and an appropriate error message.
F12504 | When the authorizer callback returns SQLITE_OK, the operation described is coded normally.
F12505 | When the authorizer callback returns SQLITE_DENY, the sqlite3_prepare_v2() or equivalent call that caused the authorizer callback to run shall fail with an SQLITE_ERROR error code and an error message explaining that access is denied.
F12506 | If the authorizer code (the 2nd parameter to the authorizer callback) is SQLITE_READ and the authorizer callback returns SQLITE_IGNORE then the prepared statement is constructed to insert a NULL value in place of the table column that would have been read if SQLITE_OK had been returned.
F12507 | If the authorizer code (the 2nd parameter to the authorizer callback) is anything other than SQLITE_READ, then a return of SQLITE_IGNORE has the same effect as SQLITE_DENY.
F12510 | The first parameter to the authorizer callback is a copy of the third parameter to the sqlite3_set_authorizer() interface.
F12511 | The second parameter to the callback is an integer action code that specifies the particular action to be authorized.
F12512 | The third through sixth parameters to the callback are zero-terminated strings that contain additional details about the action to be authorized.
F12520 | Each call to sqlite3_set_authorizer() overrides the any previously installed authorizer.
F12521 | A NULL authorizer means that no authorization callback is invoked.
F12522 | The default authorizer is NULL.
> F12550 | The sqlite3.h header file defines the following interfaces:
>     /******************************************* 3rd ************ 4th ***********/
>     #define SQLITE_CREATE_INDEX          1   /* Index Name      Table Name      */
>     #define SQLITE_CREATE_TABLE          2   /* Table Name      NULL            */
>     #define SQLITE_CREATE_TEMP_INDEX     3   /* Index Name      Table Name      */
>     #define SQLITE_CREATE_TEMP_TABLE     4   /* Table Name      NULL            */
>     #define SQLITE_CREATE_TEMP_TRIGGER   5   /* Trigger Name    Table Name      */
>     #define SQLITE_CREATE_TEMP_VIEW      6   /* View Name       NULL            */
>     #define SQLITE_CREATE_TRIGGER        7   /* Trigger Name    Table Name      */
>     #define SQLITE_CREATE_VIEW           8   /* View Name       NULL            */
>     #define SQLITE_DELETE                9   /* Table Name      NULL            */
>     #define SQLITE_DROP_INDEX           10   /* Index Name      Table Name      */
>     #define SQLITE_DROP_TABLE           11   /* Table Name      NULL            */
>     #define SQLITE_DROP_TEMP_INDEX      12   /* Index Name      Table Name      */
>     #define SQLITE_DROP_TEMP_TABLE      13   /* Table Name      NULL            */
>     #define SQLITE_DROP_TEMP_TRIGGER    14   /* Trigger Name    Table Name      */
>     #define SQLITE_DROP_TEMP_VIEW       15   /* View Name       NULL            */
>     #define SQLITE_DROP_TRIGGER         16   /* Trigger Name    Table Name      */
>     #define SQLITE_DROP_VIEW            17   /* View Name       NULL            */
>     #define SQLITE_INSERT               18   /* Table Name      NULL            */
>     #define SQLITE_PRAGMA               19   /* Pragma Name     1st arg or NULL */
>     #define SQLITE_READ                 20   /* Table Name      Column Name     */
>     #define SQLITE_SELECT               21   /* NULL            NULL            */
>     #define SQLITE_TRANSACTION          22   /* NULL            NULL            */
>     #define SQLITE_UPDATE               23   /* Table Name      Column Name     */
>     #define SQLITE_ATTACH               24   /* Filename        NULL            */
>     #define SQLITE_DETACH               25   /* Database Name   NULL            */
>     #define SQLITE_ALTER_TABLE          26   /* Database Name   Table Name      */
>     #define SQLITE_REINDEX              27   /* Index Name      NULL            */
>     #define SQLITE_ANALYZE              28   /* Table Name      NULL            */
>     #define SQLITE_CREATE_VTABLE        29   /* Table Name      Module Name     */
>     #define SQLITE_DROP_VTABLE          30   /* Table Name      Module Name     */
>     #define SQLITE_FUNCTION             31   /* Function Name   NULL            */
>     #define SQLITE_COPY                  0   /* No longer used */
F12551 | The second parameter to an authorizer callback is always an integer [SQLITE_COPY that specifies what action is being authorized.
F12552 | The 3rd and 4th parameters to the authorization callback function will be parameters or NULL depending on which authorizer code is used as the second parameter.
F12553 | The 5th parameter to the authorizer callback is the name of the database (example: "main", "temp", etc.) if applicable.
F12554 | The 6th parameter to the authorizer callback is the name of the inner-most trigger or view that is responsible for the access attempt or NULL if this access attempt is directly from top-level SQL code.
> F12590 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_DENY   1   /* Abort the SQL statement with an error */
>     #define SQLITE_IGNORE 2   /* Don't allow access, but don't generate an error */
> F12600 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_load_extension(
>       sqlite3 *db,          /* Load the extension into this database connection */
>       const char *zFile,    /* Name of the shared library containing extension */
>       const char *zProc,    /* Entry point.  Derived from zFile if 0 */
>       char **pzErrMsg       /* Put error message here if not 0 */
>     );
> F12620 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_enable_load_extension(sqlite3 *db, int onoff);
> F12640 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_auto_extension(void *xEntryPoint);
> F12660 | The sqlite3.h header file defines the following interfaces:
>     void sqlite3_reset_auto_extension(void);
> F12700 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_open(
>       const char *filename,   /* Database filename (UTF-8) */
>       sqlite3 **ppDb          /* OUT: SQLite db handle */
>     );
>     int sqlite3_open16(
>       const void *filename,   /* Database filename (UTF-16) */
>       sqlite3 **ppDb          /* OUT: SQLite db handle */
>     );
>     int sqlite3_open_v2(
>       const char *filename,   /* Database filename (UTF-8) */
>       sqlite3 **ppDb,         /* OUT: SQLite db handle */
>       int flags,              /* Flags */
>       const char *zVfs        /* Name of VFS module to use */
>     );
F12701 | The sqlite3_open(), sqlite3_open16(), and sqlite3_open_v2() interfaces create a new database connection associated with the database file given in their first parameter.
F12702 | The filename argument is interpreted as UTF-8 for sqlite3_open() and sqlite3_open_v2() and as UTF-16 in the native byte order for sqlite3_open16().
F12703 | A successful invocation of sqlite3_open(), sqlite3_open16(), or sqlite3_open_v2() writes a pointer to a new database connection into *ppDb.
F12704 | The sqlite3_open(), sqlite3_open16(), and sqlite3_open_v2() interfaces return SQLITE_OK upon success, or an appropriate error code on failure.
F12706 | The default text encoding for a new database created using sqlite3_open() or sqlite3_open_v2() will be UTF-8.
F12707 | The default text encoding for a new database created using sqlite3_open16() will be UTF-16.
F12709 | The sqlite3_open(F,D) interface is equivalent to sqlite3_open_v2(F,D,G,0) where the G parameter is SQLITE_OPEN_READWRITE| SQLITE_OPEN_CREATE.
F12711 | If the G parameter to sqlite3_open_v2(F,D,G,V) contains the bit value SQLITE_OPEN_READONLY then the database is opened for reading only.
F12712 | If the G parameter to sqlite3_open_v2(F,D,G,V) contains the bit value SQLITE_OPEN_READWRITE then the database is opened reading and writing if possible, or for reading only if the file is write protected by the operating system.
F12713 | If the G parameter to sqlite3_open(v2(F,D,G,V) omits the bit value SQLITE_OPEN_CREATE and the database does not previously exist, an error is returned.
F12714 | If the G parameter to sqlite3_open(v2(F,D,G,V) contains the bit value SQLITE_OPEN_CREATE and the database does not previously exist, then an attempt is made to create and initialize the database.
F12717 | If the filename argument to sqlite3_open(), sqlite3_open16(), or sqlite3_open_v2() is ":memory:", then an private, ephemeral, in-memory database is created for the connection. Is SQLITE_OPEN_CREATE|SQLITE_OPEN_READWRITE required in sqlite3_open_v2()?
F12719 | If the filename is NULL or an empty string, then a private, ephermeral on-disk database will be created. Is SQLITE_OPEN_CREATE|SQLITE_OPEN_READWRITE required in sqlite3_open_v2()?
F12721 | The database connection created by sqlite3_open_v2(F,D,G,V) will use the sqlite3_vfs object identified by the V parameter, or the default sqlite3_vfs object is V is a NULL pointer.
> F12760 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_limit(sqlite3*, int id, int newVal);
F12762 | A successful call to sqlite3_limit(D,C,V) where V is positive changes the limit on the size of construct C in database connection D to the lessor of V and the hard upper bound on the size of C that is set at compile-time.
F12766 | A successful call to sqlite3_limit(D,C,V) where V is negative leaves the state of database connection D unchanged.
F12769 | A successful call to sqlite3_limit(D,C,V) returns the value of the limit on the size of construct C in in database connection D as it was prior to the call.
> F12790 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_LIMIT_LENGTH                    0
>     #define SQLITE_LIMIT_SQL_LENGTH                1
>     #define SQLITE_LIMIT_COLUMN                    2
>     #define SQLITE_LIMIT_EXPR_DEPTH                3
>     #define SQLITE_LIMIT_COMPOUND_SELECT           4
>     #define SQLITE_LIMIT_VDBE_OP                   5
>     #define SQLITE_LIMIT_FUNCTION_ARG              6
>     #define SQLITE_LIMIT_ATTACHED                  7
>     #define SQLITE_LIMIT_LIKE_PATTERN_LENGTH       8
>     #define SQLITE_LIMIT_VARIABLE_NUMBER           9
> F12800 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_errcode(sqlite3 *db);
>     const char *sqlite3_errmsg(sqlite3*);
>     const void *sqlite3_errmsg16(sqlite3*);
F12801 | The sqlite3_errcode(D) interface returns the numeric result code or extended result code for the most recently failed interface call associated with database connection D.
F12803 | The sqlite3_errmsg(D) and sqlite3_errmsg16(D) interfaces return English-language text that describes the error in the mostly recently failed interface call, encoded as either UTF8 or UTF16 respectively.
F12807 | The strings returned by sqlite3_errmsg() and sqlite3_errmsg16() are valid until the next SQLite interface call.
F12808 | Calls to API routines that do not return an error code (example: sqlite3_data_count()) do not change the error code or message returned by sqlite3_errcode(), sqlite3_errmsg(), or sqlite3_errmsg16().
F12809 | Interfaces that are not associated with a specific database connection (examples: sqlite3_mprintf() or sqlite3_enable_shared_cache() do not change the values returned by sqlite3_errcode(), sqlite3_errmsg(), or sqlite3_errmsg16().
> F12850 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_table_column_metadata(
>       sqlite3 *db,                /* Connection handle */
>       const char *zDbName,        /* Database name or NULL */
>       const char *zTableName,     /* Table name */
>       const char *zColumnName,    /* Column name */
>       char const **pzDataType,    /* OUTPUT: Declared data type */
>       char const **pzCollSeq,     /* OUTPUT: Collation sequence name */
>       int *pNotNull,              /* OUTPUT: True if NOT NULL constraint exists */
>       int *pPrimaryKey,           /* OUTPUT: True if column part of PK */
>       int *pAutoinc               /* OUTPUT: True if column is auto-increment */
>     );
> F12910 | The sqlite3.h header file defines the following interfaces:
>     void sqlite3_progress_handler(sqlite3*, int, int(*)(void*), void*);
F12911 | The callback function registered by sqlite3_progress_handler() is invoked periodically during long running calls to sqlite3_step().
F12912 | The progress callback is invoked once for every N virtual machine opcodes, where N is the second argument to the sqlite3_progress_handler() call that registered the callback. What if N is less than 1?
F12913 | The progress callback itself is identified by the third argument to sqlite3_progress_handler().
F12914 | The fourth argument sqlite3_progress_handler() is a void pointer passed to the progress callback function each time it is invoked.
F12915 | If a call to sqlite3_step() results in fewer than N opcodes being executed, then the progress callback is never invoked. {END}
F12916 | Every call to sqlite3_progress_handler() overwrites any previously registere progress handler.
F12917 | If the progress handler callback is NULL then no progress handler is invoked.
F12918 | If the progress callback returns a result other than 0, then the behavior is a if sqlite3_interrupt() had been called.
> F12930 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_get_autocommit(sqlite3*);
F12931 | The sqlite3_get_autocommit(D) interface returns non-zero or zero if the database connection D is or is not in autocommit mode, respectively.
F12932 | Autocommit mode is on by default.
F12933 | Autocommit mode is disabled by a successful BEGIN statement.
F12934 | Autocommit mode is enabled by a successful COMMIT or ROLLBACK statement.
> F12950 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_commit_hook(sqlite3*, int(*)(void*), void*);
>     void *sqlite3_rollback_hook(sqlite3*, void(*)(void *), void*);
F12951 | The sqlite3_commit_hook(D,F,P) interface registers the callback function F to be invoked with argument P whenever a transaction commits on database connection D.
F12952 | The sqlite3_commit_hook(D,F,P) interface returns the P argument from the previous call with the same database connection D , or NULL on the first call for a particular database connection D.
F12953 | Each call to sqlite3_commit_hook() overwrites the callback registered by prior calls.
F12954 | If the F argument to sqlite3_commit_hook(D,F,P) is NULL then the commit hook callback is cancelled and no callback is invoked when a transaction commits.
F12955 | If the commit callback returns non-zero then the commit is converted into a rollback.
F12961 | The sqlite3_rollback_hook(D,F,P) interface registers the callback function F to be invoked with argument P whenever a transaction rolls back on database connection D.
F12962 | The sqlite3_rollback_hook(D,F,P) interface returns the P argument from the previous call with the same database connection D , or NULL on the first call for a particular database connection D.
F12963 | Each call to sqlite3_rollback_hook() overwrites the callback registered by prior calls.
F12964 | If the F argument to sqlite3_rollback_hook(D,F,P) is NULL then the rollback hook callback is cancelled and no callback is invoked when a transaction rolls back.
> F12970 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_update_hook(
>       sqlite3*,
>       void(*)(void *,int ,char const *,char const *,sqlite3_int64),
>       void*
>     );
F12971 | The sqlite3_update_hook(D,F,P) interface causes callback function F to be invoked with first parameter P whenever a table row is modified, inserted, or deleted on database connection D.
F12973 | The sqlite3_update_hook(D,F,P) interface returns the value of P for the previous call on the same database connection D, or NULL for the first call.
F12975 | If the update hook callback F in sqlite3_update_hook(D,F,P) is NULL then the no update callbacks are made.
F12977 | Each call to sqlite3_update_hook(D,F,P) overrides prior calls to the same interface on the same database connection D.
F12979 | The update hook callback is not invoked when internal system tables such as sqlite_master and sqlite_sequence are modified.
F12981 | The second parameter to the update callback is one of SQLITE_INSERT, SQLITE_DELETE or SQLITE_UPDATE, depending on the operation that caused the callback to be invoked.
F12983 | The third and fourth arguments to the callback contain pointers to zero-terminated UTF-8 strings which are the names of the database and table that is being updated.
F12985 | The final callback parameter is the rowid of the row after the change occurs.
> F13000 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_stmt sqlite3_stmt;
> F13010 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_prepare(
>       sqlite3 *db,            /* Database handle */
>       const char *zSql,       /* SQL statement, UTF-8 encoded */
>       int nByte,              /* Maximum length of zSql in bytes. */
>       sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
>       const char **pzTail     /* OUT: Pointer to unused portion of zSql */
>     );
>     int sqlite3_prepare_v2(
>       sqlite3 *db,            /* Database handle */
>       const char *zSql,       /* SQL statement, UTF-8 encoded */
>       int nByte,              /* Maximum length of zSql in bytes. */
>       sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
>       const char **pzTail     /* OUT: Pointer to unused portion of zSql */
>     );
>     int sqlite3_prepare16(
>       sqlite3 *db,            /* Database handle */
>       const void *zSql,       /* SQL statement, UTF-16 encoded */
>       int nByte,              /* Maximum length of zSql in bytes. */
>       sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
>       const void **pzTail     /* OUT: Pointer to unused portion of zSql */
>     );
>     int sqlite3_prepare16_v2(
>       sqlite3 *db,            /* Database handle */
>       const void *zSql,       /* SQL statement, UTF-16 encoded */
>       int nByte,              /* Maximum length of zSql in bytes. */
>       sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
>       const void **pzTail     /* OUT: Pointer to unused portion of zSql */
>     );
F13011 | The sqlite3_prepare(db,zSql,...) and sqlite3_prepare_v2(db,zSql,...) interfaces interpret the text in their zSql parameter as UTF-8.
F13012 | The sqlite3_prepare16(db,zSql,...) and sqlite3_prepare16_v2(db,zSql,...) interfaces interpret the text in their zSql parameter as UTF-16 in the native byte order.
F13013 | If the nByte argument to sqlite3_prepare_v2(db,zSql,nByte,...) and its variants is less than zero, then SQL text is read from zSql is read up to the first zero terminator.
F13014 | If the nByte argument to sqlite3_prepare_v2(db,zSql,nByte,...) and its variants is non-negative, then at most nBytes bytes SQL text is read from zSql.
F13015 | In sqlite3_prepare_v2(db,zSql,N,P,pzTail) and its variants if the zSql input text contains more than one SQL statement and pzTail is not NULL, then *pzTail is made to point to the first byte past the end of the first SQL statement in zSql. What does *pzTail point to if there is one statement?
F13016 | A successful call to sqlite3_prepare_v2(db,zSql,N,ppStmt,...) or one of its variants writes into *ppStmt a pointer to a new prepared statement or a pointer to NULL if zSql contains nothing other than whitespace or comments.
F13019 | The sqlite3_prepare_v2() interface and its variants return SQLITE_OK or an appropriate error code upon failure.
F13021 | Before sqlite3_prepare(db,zSql,nByte,ppStmt,pzTail) or its variants returns an error (any value other than SQLITE_OK) it first sets *ppStmt to NULL.
> F13120 | The sqlite3.h header file defines the following interfaces:
>     sqlite3 *sqlite3_db_handle(sqlite3_stmt*);
F13123 | The sqlite3_db_handle(S) interface returns a pointer to the database connection associated with prepared statement S.
> F13200 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_step(sqlite3_stmt*);
F13202 | If prepared statement S is ready to be run, then sqlite3_step(S) advances that prepared statement until to completion or until it is ready to return another row of the result set or an interrupt or run-time error occurs.
> F13300 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_finalize(sqlite3_stmt *pStmt);
> F13330 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_reset(sqlite3_stmt *pStmt);
> F13500 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));
>     int sqlite3_bind_double(sqlite3_stmt*, int, double);
>     int sqlite3_bind_int(sqlite3_stmt*, int, int);
>     int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite3_int64);
>     int sqlite3_bind_null(sqlite3_stmt*, int);
>     int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));
>     int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int, void(*)(void*));
>     int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);
>     int sqlite3_bind_zeroblob(sqlite3_stmt*, int, int n);
F13506 | The SQL statement compiler recognizes tokens of the forms "?", "?NNN", "$VVV", ":VVV", and "@VVV" as SQL parameters, where NNN is any sequence of one or more digits and where VVV is any sequence of one or more alphanumeric characters or "::" optionally followed by a string containing no spaces and contained within parentheses.
F13509 | The initial value of an SQL parameter is NULL.
F13512 | The index of an "?" SQL parameter is one larger than the largest index of SQL parameter to the left, or 1 if the "?" is the leftmost SQL parameter.
F13515 | The index of an "?NNN" SQL parameter is the integer NNN.
F13518 | The index of an ":VVV", "$VVV", or "@VVV" SQL parameter is the same as the index of leftmost occurances of the same parameter, or one more than the largest index over all parameters to the left if this is the first occurrance of this parameter, or 1 if this is the leftmost parameter.
F13521 | The SQL statement compiler fail with an SQLITE_RANGE error if the index of an SQL parameter is less than 1 or greater than SQLITE_MAX_VARIABLE_NUMBER.
F13524 | Calls to sqlite3_bind(S,N,V,...) associate the value V with all SQL parameters having an index of N in the prepared statement S.
F13527 | Calls to sqlite3_bind(S,N,...) override prior calls with the same values of S and N.
F13530 | Bindings established by sqlite3_bind(S,...) persist across calls to sqlite3_reset(S).
F13533 | In calls to sqlite3_bind_blob(S,N,V,L,D), sqlite3_bind_text(S,N,V,L,D), or sqlite3_bind_text16(S,N,V,L,D) SQLite binds the first L bytes of the blob or string pointed to by V, when L is non-negative.
F13536 | In calls to sqlite3_bind_text(S,N,V,L,D) or sqlite3_bind_text16(S,N,V,L,D) SQLite binds characters from V through the first zero character when L is negative.
F13539 | In calls to sqlite3_bind_blob(S,N,V,L,D), sqlite3_bind_text(S,N,V,L,D), or sqlite3_bind_text16(S,N,V,L,D) when D is the special constant SQLITE_STATIC, SQLite assumes that the value V is held in static unmanaged space that will not change during the lifetime of the binding.
F13542 | In calls to sqlite3_bind_blob(S,N,V,L,D), sqlite3_bind_text(S,N,V,L,D), or sqlite3_bind_text16(S,N,V,L,D) when D is the special constant SQLITE_TRANSIENT, the routine makes a private copy of V value before it returns.
F13545 | In calls to sqlite3_bind_blob(S,N,V,L,D), sqlite3_bind_text(S,N,V,L,D), or sqlite3_bind_text16(S,N,V,L,D) when D is a pointer to a function, SQLite invokes that function to destroy the V value after it has finished using the V value.
F13548 | In calls to sqlite3_bind_zeroblob(S,N,V,L) the value bound is a blob of L bytes, or a zero-length blob if L is negative.
F13551 | In calls to sqlite3_bind_value(S,N,V) the V argument may be either a protected sqlite3_value object or an unprotected sqlite3_value object.
> F13600 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_bind_parameter_count(sqlite3_stmt*);
F13601 | The sqlite3_bind_parameter_count(S) interface returns the largest index of all SQL parameters in the prepared statement S, or 0 if S contains no SQL parameters.
> F13620 | The sqlite3.h header file defines the following interfaces:
>     const char *sqlite3_bind_parameter_name(sqlite3_stmt*, int);
F13621 | The sqlite3_bind_parameter_name(S,N) interface returns a UTF-8 rendering of the name of the SQL parameter in prepared statement S having index N, or NULL if there is no SQL parameter with index N or if the parameter with index N is an anonymous parameter "?".
> F13640 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_bind_parameter_index(sqlite3_stmt*, const char *zName);
F13641 | The sqlite3_bind_parameter_index(S,N) interface returns the index of SQL parameter in prepared statement S whose name matches the UTF-8 string N, or 0 if there is no match.
> F13660 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_clear_bindings(sqlite3_stmt*);
F13661 | The sqlite3_clear_bindings(S) interface resets all SQL parameter bindings in prepared statement S back to NULL.
> F13710 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_column_count(sqlite3_stmt *pStmt);
F13711 | The sqlite3_column_count(S) interface returns the number of columns in the result set generated by the prepared statement S, or 0 if S does not generate a result set.
> F13720 | The sqlite3.h header file defines the following interfaces:
>     const char *sqlite3_column_name(sqlite3_stmt*, int N);
>     const void *sqlite3_column_name16(sqlite3_stmt*, int N);
F13721 | A successful invocation of the sqlite3_column_name(S,N) interface returns the name of the Nth column (where 0 is the left-most column) for the result set of prepared statement S as a zero-terminated UTF-8 string.
F13723 | A successful invocation of the sqlite3_column_name16(S,N) interface returns the name of the Nth column (where 0 is the left-most column) for the result set of prepared statement S as a zero-terminated UTF-16 string in the native byte order.
F13724 | The sqlite3_column_name() and sqlite3_column_name16() interfaces return a NULL pointer if they are unable to allocate memory memory to hold there normal return strings.
F13725 | If the N parameter to sqlite3_column_name(S,N) or sqlite3_column_name16(S,N) is out of range, then the interfaces returns a NULL pointer.
F13726 | The strings returned by sqlite3_column_name(S,N) and sqlite3_column_name16(S,N) are valid until the next call to either routine with the same S and N parameters or until sqlite3_finalize(S) is called.
F13727 | When a result column of a SELECT statement contains an AS clause, the name of that column is the indentifier to the right of the AS keyword.
> F13740 | The sqlite3.h header file defines the following interfaces:
>     const char *sqlite3_column_database_name(sqlite3_stmt*,int);
>     const void *sqlite3_column_database_name16(sqlite3_stmt*,int);
>     const char *sqlite3_column_table_name(sqlite3_stmt*,int);
>     const void *sqlite3_column_table_name16(sqlite3_stmt*,int);
>     const char *sqlite3_column_origin_name(sqlite3_stmt*,int);
>     const void *sqlite3_column_origin_name16(sqlite3_stmt*,int);
F13741 | The sqlite3_column_database_name(S,N) interface returns either the UTF-8 zero-terminated name of the database from which the Nth result column of prepared statement S is extracted, or NULL if the the Nth column of S is a general expression or if unable to allocate memory to store the name.
F13742 | The sqlite3_column_database_name16(S,N) interface returns either the UTF-16 native byte order zero-terminated name of the database from which the Nth result column of prepared statement S is extracted, or NULL if the the Nth column of S is a general expression or if unable to allocate memory to store the name.
F13743 | The sqlite3_column_table_name(S,N) interface returns either the UTF-8 zero-terminated name of the table from which the Nth result column of prepared statement S is extracted, or NULL if the the Nth column of S is a general expression or if unable to allocate memory to store the name.
F13744 | The sqlite3_column_table_name16(S,N) interface returns either the UTF-16 native byte order zero-terminated name of the table from which the Nth result column of prepared statement S is extracted, or NULL if the the Nth column of S is a general expression or if unable to allocate memory to store the name.
F13745 | The sqlite3_column_origin_name(S,N) interface returns either the UTF-8 zero-terminated name of the table column from which the Nth result column of prepared statement S is extracted, or NULL if the the Nth column of S is a general expression or if unable to allocate memory to store the name.
F13746 | The sqlite3_column_origin_name16(S,N) interface returns either the UTF-16 native byte order zero-terminated name of the table column from which the Nth result column of prepared statement S is extracted, or NULL if the the Nth column of S is a general expression or if unable to allocate memory to store the name.
F13748 | The return values from column metadata interfaces are valid for the lifetime of the prepared statement or until the encoding is changed by another metadata interface call for the same prepared statement and column.
> F13760 | The sqlite3.h header file defines the following interfaces:
>     const char *sqlite3_column_decltype(sqlite3_stmt*,int);
>     const void *sqlite3_column_decltype16(sqlite3_stmt*,int);
F13761 | A successful call to sqlite3_column_decltype(S,N) returns a zero-terminated UTF-8 string containing the the declared datatype of the table column that appears as the Nth column (numbered from 0) of the result set to the prepared statement S.
F13762 | A successful call to sqlite3_column_decltype16(S,N) returns a zero-terminated UTF-16 native byte order string containing the declared datatype of the table column that appears as the Nth column (numbered from 0) of the result set to the prepared statement S.
F13763 | If N is less than 0 or N is greater than or equal to the number of columns in prepared statement S or if the Nth column of S is an expression or subquery rather than a table column or if a memory allocation failure occurs during encoding conversions, then calls to sqlite3_column_decltype(S,N) or sqlite3_column_decltype16(S,N) return NULL.
> F13770 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_data_count(sqlite3_stmt *pStmt);
F13771 | After a call to sqlite3_step(S) that returns SQLITE_ROW, the sqlite3_data_count(S) routine will return the same value as the sqlite3_column_count(S) function.
F13772 | After sqlite3_step(S) has returned any value other than SQLITE_ROW or before sqlite3_step(S) has been called on the prepared statement for the first time since it was prepared or reset, the sqlite3_data_count(S) routine returns zero.
> F13800 | The sqlite3.h header file defines the following interfaces:
>     const void *sqlite3_column_blob(sqlite3_stmt*, int iCol);
>     int sqlite3_column_bytes(sqlite3_stmt*, int iCol);
>     int sqlite3_column_bytes16(sqlite3_stmt*, int iCol);
>     double sqlite3_column_double(sqlite3_stmt*, int iCol);
>     int sqlite3_column_int(sqlite3_stmt*, int iCol);
>     sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol);
>     const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);
>     const void *sqlite3_column_text16(sqlite3_stmt*, int iCol);
>     int sqlite3_column_type(sqlite3_stmt*, int iCol);
>     sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);
F13803 | The sqlite3_column_blob(S,N) interface converts the Nth column in the current row of the result set for prepared statement S into a blob and then returns a pointer to the converted value.
F13806 | The sqlite3_column_bytes(S,N) interface returns the number of bytes in the blob or string (exclusive of the zero terminator on the string) that was returned by the most recent call to sqlite3_column_blob(S,N) or sqlite3_column_text(S,N).
F13809 | The sqlite3_column_bytes16(S,N) interface returns the number of bytes in the string (exclusive of the zero terminator on the string) that was returned by the most recent call to sqlite3_column_text16(S,N).
F13812 | The sqlite3_column_double(S,N) interface converts the Nth column in the current row of the result set for prepared statement S into a floating point value and returns a copy of that value.
F13815 | The sqlite3_column_int(S,N) interface converts the Nth column in the current row of the result set for prepared statement S into a 64-bit signed integer and returns the lower 32 bits of that integer.
F13818 | The sqlite3_column_int64(S,N) interface converts the Nth column in the current row of the result set for prepared statement S into a 64-bit signed integer and returns a copy of that integer.
F13821 | The sqlite3_column_text(S,N) interface converts the Nth column in the current row of the result set for prepared statement S into a zero-terminated UTF-8 string and returns a pointer to that string.
F13824 | The sqlite3_column_text16(S,N) interface converts the Nth column in the current row of the result set for prepared statement S into a zero-terminated 2-byte aligned UTF-16 native byte order string and returns a pointer to that string.
F13827 | The sqlite3_column_type(S,N) interface returns one of SQLITE_NULL, SQLITE_INTEGER, SQLITE_FLOAT, SQLITE_TEXT, or SQLITE_BLOB as appropriate for the Nth column in the current row of the result set for prepared statement S.
F13830 | The sqlite3_column_value(S,N) interface returns a pointer to an unprotected sqlite3_value object for the Nth column in the current row of the result set for prepared statement S.
> F15000 | The sqlite3.h header file defines the following interfaces:
>     typedef struct Mem sqlite3_value;
> F15100 | The sqlite3.h header file defines the following interfaces:
>     const void *sqlite3_value_blob(sqlite3_value*);
>     int sqlite3_value_bytes(sqlite3_value*);
>     int sqlite3_value_bytes16(sqlite3_value*);
>     double sqlite3_value_double(sqlite3_value*);
>     int sqlite3_value_int(sqlite3_value*);
>     sqlite3_int64 sqlite3_value_int64(sqlite3_value*);
>     const unsigned char *sqlite3_value_text(sqlite3_value*);
>     const void *sqlite3_value_text16(sqlite3_value*);
>     const void *sqlite3_value_text16le(sqlite3_value*);
>     const void *sqlite3_value_text16be(sqlite3_value*);
>     int sqlite3_value_type(sqlite3_value*);
>     int sqlite3_value_numeric_type(sqlite3_value*);
F15103 | The sqlite3_value_blob(V) interface converts the protected sqlite3_value object V into a blob and then returns a pointer to the converted value.
F15106 | The sqlite3_value_bytes(V) interface returns the number of bytes in the blob or string (exclusive of the zero terminator on the string) that was returned by the most recent call to sqlite3_value_blob(V) or sqlite3_value_text(V).
F15109 | The sqlite3_value_bytes16(V) interface returns the number of bytes in the string (exclusive of the zero terminator on the string) that was returned by the most recent call to sqlite3_value_text16(V), sqlite3_value_text16be(V), or sqlite3_value_text16le(V).
F15112 | The sqlite3_value_double(V) interface converts the protected sqlite3_value object V into a floating point value and returns a copy of that value.
F15115 | The sqlite3_value_int(V) interface converts the protected sqlite3_value object V into a 64-bit signed integer and returns the lower 32 bits of that integer.
F15118 | The sqlite3_value_int64(V) interface converts the protected sqlite3_value object V into a 64-bit signed integer and returns a copy of that integer.
F15121 | The sqlite3_value_text(V) interface converts the protected sqlite3_value object V into a zero-terminated UTF-8 string and returns a pointer to that string.
F15124 | The sqlite3_value_text16(V) interface converts the protected sqlite3_value object V into a zero-terminated 2-byte aligned UTF-16 native byte order string and returns a pointer to that string.
F15127 | The sqlite3_value_text16be(V) interface converts the protected sqlite3_value object V into a zero-terminated 2-byte aligned UTF-16 big-endian string and returns a pointer to that string.
F15130 | The sqlite3_value_text16le(V) interface converts the protected sqlite3_value object V into a zero-terminated 2-byte aligned UTF-16 little-endian string and returns a pointer to that string.
F15133 | The sqlite3_value_type(V) interface returns one of SQLITE_NULL, SQLITE_INTEGER, SQLITE_FLOAT, SQLITE_TEXT, or SQLITE_BLOB as appropriate for the sqlite3_value object V.
F15136 | The sqlite3_value_numeric_type(V) interface converts the protected sqlite3_value object V into either an integer or a floating point value if it can do so without loss of information, and returns one of SQLITE_NULL, SQLITE_INTEGER, SQLITE_FLOAT, SQLITE_TEXT, or SQLITE_BLOB as appropriate for the protected sqlite3_value object V after the conversion attempt.
F15304 | When a call to sqlite3_step(S) causes the prepared statement S to run to completion, the function returns SQLITE_DONE.
F15306 | When a call to sqlite3_step(S) stops because it is ready to return another row of the result set, it returns SQLITE_ROW.
F15308 | If a call to sqlite3_step(S) encounters an interrupt or a run-time error, it returns an appropraite error code that is not one of SQLITE_OK, SQLITE_ROW, or SQLITE_DONE.
F15310 | If an interrupt or run-time error occurs during a call to sqlite3_step(S) for a prepared statement S created using legacy interfaces sqlite3_prepare() or sqlite3_prepare16() then the function returns either SQLITE_ERROR, SQLITE_BUSY, or SQLITE_MISUSE.
> F16001 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_context sqlite3_context;
> F16100 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_create_function(
>       sqlite3 *db,
>       const char *zFunctionName,
>       int nArg,
>       int eTextRep,
>       void *pApp,
>       void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
>       void (*xStep)(sqlite3_context*,int,sqlite3_value**),
>       void (*xFinal)(sqlite3_context*)
>     );
>     int sqlite3_create_function16(
>       sqlite3 *db,
>       const void *zFunctionName,
>       int nArg,
>       int eTextRep,
>       void *pApp,
>       void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
>       void (*xStep)(sqlite3_context*,int,sqlite3_value**),
>       void (*xFinal)(sqlite3_context*)
>     );
F16103 | The sqlite3_create_function16() interface behaves exactly like sqlite3_create_function() in every way except that it interprets the zFunctionName argument as zero-terminated UTF-16 native byte order instead of as a zero-terminated UTF-8.
F16106 | A successful invocation of the sqlite3_create_function(D,X,N,E,...) interface registers or replaces callback functions in database connection D used to implement the SQL function named X with N parameters and having a perferred text encoding of E.
F16109 | A successful call to sqlite3_create_function(D,X,N,E,P,F,S,L) replaces the P, F, S, and L values from any prior calls with the same D, X, N, and E values.
F16112 | The sqlite3_create_function(D,X,...) interface fails with a return code of SQLITE_ERROR if the SQL function name X is longer than 255 bytes exclusive of the zero terminator.
F16118 | Either F must be NULL and S and L are non-NULL or else F is non-NULL and S and L are NULL, otherwise sqlite3_create_function(D,X,N,E,P,F,S,L) returns SQLITE_ERROR.
F16121 | The sqlite3_create_function(D,...) interface fails with an error code of SQLITE_BUSY if there exist prepared statements associated with the database connection D.
F16124 | The sqlite3_create_function(D,X,N,...) interface fails with an error code of SQLITE_ERROR if parameter N (specifying the number of arguments to the SQL function being registered) is less than -1 or greater than 127.
F16127 | When N is non-negative, the sqlite3_create_function(D,X,N,...) interface causes callbacks to be invoked for the SQL function named X when the number of arguments to the SQL function is exactly N.
F16130 | When N is -1, the sqlite3_create_function(D,X,N,...) interface causes callbacks to be invoked for the SQL function named X with any number of arguments.
F16133 | When calls to sqlite3_create_function(D,X,N,...) specify multiple implementations of the same function X and when one implementation has N>=0 and the other has N=(-1) the implementation with a non-zero N is preferred.
F16136 | When calls to sqlite3_create_function(D,X,N,E,...) specify multiple implementations of the same function X with the same number of arguments N but with different encodings E, then the implementation where E matches the database encoding is preferred.
F16139 | For an aggregate SQL function created using sqlite3_create_function(D,X,N,E,P,0,S,L) the finializer function L will always be invoked exactly once if the step function S is called one or more times.
F16142 | When SQLite invokes either the xFunc or xStep function of an application-defined SQL function or aggregate created by sqlite3_create_function() or sqlite3_create_function16(), then the array of sqlite3_value objects passed as the third parameter are always protected sqlite3_value objects.
> F16210 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_aggregate_context(sqlite3_context*, int nBytes);
F16211 | The first invocation of sqlite3_aggregate_context(C,N) for a particular instance of an aggregate function (for a particular context C) causes SQLite to allocation N bytes of memory, zero that memory, and return a pointer to the allocationed memory.
F16213 | If a memory allocation error occurs during sqlite3_aggregate_context(C,N) then the function returns 0.
F16215 | Second and subsequent invocations of sqlite3_aggregate_context(C,N) for the same context pointer C ignore the N parameter and return a pointer to the same block of memory returned by the first invocation.
F16217 | The memory allocated by sqlite3_aggregate_context(C,N) is automatically freed on the next call to sqlite3_reset() or sqlite3_finalize() for the prepared statement containing the aggregate function associated with context C.
> F16240 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_user_data(sqlite3_context*);
F16243 | The sqlite3_user_data(C) interface returns a copy of the P pointer from the sqlite3_create_function(D,X,N,E,P,F,S,L) or sqlite3_create_function16(D,X,N,E,P,F,S,L) call that registered the SQL function associated with sqlite3_context C.
> F16250 | The sqlite3.h header file defines the following interfaces:
>     sqlite3 *sqlite3_context_db_handle(sqlite3_context*);
F16253 | The sqlite3_context_db_handle(C) interface returns a copy of the D pointer from the sqlite3_create_function(D,X,N,E,P,F,S,L) or sqlite3_create_function16(D,X,N,E,P,F,S,L) call that registered the SQL function associated with sqlite3_context C.
> F16270 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_get_auxdata(sqlite3_context*, int N);
>     void sqlite3_set_auxdata(sqlite3_context*, int N, void*, void (*)(void*));
F16272 | The sqlite3_get_auxdata(C,N) interface returns a pointer to metadata associated with the Nth parameter of the SQL function whose context is C, or NULL if there is no metadata associated with that parameter.
F16274 | The sqlite3_set_auxdata(C,N,P,D) interface assigns a metadata pointer P to the Nth parameter of the SQL function with context C.
F16276 | SQLite will invoke the destructor D with a single argument which is the metadata pointer P following a call to sqlite3_set_auxdata(C,N,P,D) when SQLite ceases to hold the metadata.
F16277 | SQLite ceases to hold metadata for an SQL function parameter when the value of that parameter changes.
F16278 | When sqlite3_set_auxdata(C,N,P,D) is invoked, the destructor is called for any prior metadata associated with the same function context C and parameter N.
F16279 | SQLite will call destructors for any metadata it is holding in a particular prepared statement S when either sqlite3_reset(S) or sqlite3_finalize(S) is called.
F16342 | The sqlite3_release_memory(N) returns the number of bytes actually freed, which might be more or less than the amount requested.
F16351 | The sqlite3_soft_heap_limit(N) interface places a soft limit of N bytes on the amount of heap memory that may be allocated using sqlite3_malloc() or sqlite3_realloc() at any point in time.
F16352 | If a call to sqlite3_malloc() or sqlite3_realloc() would cause the total amount of allocated memory to exceed the soft heap limit, then sqlite3_release_memory() is invoked in an attempt to reduce the memory usage prior to proceeding with the memory allocation attempt.
F16353 | Calls to sqlite3_malloc() or sqlite3_realloc() that trigger attempts to reduce memory usage through the soft heap limit mechanism continue even if the attempt to reduce memory usage is unsuccessful.
F16354 | A negative or zero value for N in a call to sqlite3_soft_heap_limit(N) means that there is no soft heap limit and sqlite3_release_memory() will only be called when memory is completely exhausted.
F16355 | The default value for the soft heap limit is zero.
F16358 | Each call to sqlite3_soft_heap_limit(N) overrides the values set by all prior calls.
> F16400 | The sqlite3.h header file defines the following interfaces:
>     void sqlite3_result_blob(sqlite3_context*, const void*, int, void(*)(void*));
>     void sqlite3_result_double(sqlite3_context*, double);
>     void sqlite3_result_error(sqlite3_context*, const char*, int);
>     void sqlite3_result_error16(sqlite3_context*, const void*, int);
>     void sqlite3_result_error_toobig(sqlite3_context*);
>     void sqlite3_result_error_nomem(sqlite3_context*);
>     void sqlite3_result_error_code(sqlite3_context*, int);
>     void sqlite3_result_int(sqlite3_context*, int);
>     void sqlite3_result_int64(sqlite3_context*, sqlite3_int64);
>     void sqlite3_result_null(sqlite3_context*);
>     void sqlite3_result_text(sqlite3_context*, const char*, int, void(*)(void*));
>     void sqlite3_result_text16(sqlite3_context*, const void*, int, void(*)(void*));
>     void sqlite3_result_text16le(sqlite3_context*, const void*, int,void(*)(void*));
>     void sqlite3_result_text16be(sqlite3_context*, const void*, int,void(*)(void*));
>     void sqlite3_result_value(sqlite3_context*, sqlite3_value*);
>     void sqlite3_result_zeroblob(sqlite3_context*, int n);
F16403 | The default return value from any SQL function is NULL.
F16406 | The sqlite3_result_blob(C,V,N,D) interface changes the return value of function C to be a blob that is N bytes in length and with content pointed to by V.
F16409 | The sqlite3_result_double(C,V) interface changes the return value of function C to be the floating point value V.
F16412 | The sqlite3_result_error(C,V,N) interface changes the return value of function C to be an exception with error code SQLITE_ERROR and a UTF8 error message copied from V up to the first zero byte or until N bytes are read if N is positive.
F16415 | The sqlite3_result_error16(C,V,N) interface changes the return value of function C to be an exception with error code SQLITE_ERROR and a UTF16 native byte order error message copied from V up to the first zero terminator or until N bytes are read if N is positive.
F16418 | The sqlite3_result_error_toobig(C) interface changes the return value of the function C to be an exception with error code SQLITE_TOOBIG and an appropriate error message.
F16421 | The sqlite3_result_error_nomem(C) interface changes the return value of the function C to be an exception with error code SQLITE_NOMEM and an appropriate error message.
F16424 | The sqlite3_result_error_code(C,E) interface changes the return value of the function C to be an exception with error code E. The error message text is unchanged.
F16427 | The sqlite3_result_int(C,V) interface changes the return value of function C to be the 32-bit integer value V.
F16430 | The sqlite3_result_int64(C,V) interface changes the return value of function C to be the 64-bit integer value V.
F16433 | The sqlite3_result_null(C) interface changes the return value of function C to be NULL.
F16436 | The sqlite3_result_text(C,V,N,D) interface changes the return value of function C to be the UTF8 string V up to the first zero if N is negative or the first N bytes of V if N is non-negative.
F16439 | The sqlite3_result_text16(C,V,N,D) interface changes the return value of function C to be the UTF16 native byte order string V up to the first zero if N is negative or the first N bytes of V if N is non-negative.
F16442 | The sqlite3_result_text16be(C,V,N,D) interface changes the return value of function C to be the UTF16 big-endian string V up to the first zero if N is is negative or the first N bytes or V if N is non-negative.
F16445 | The sqlite3_result_text16le(C,V,N,D) interface changes the return value of function C to be the UTF16 little-endian string V up to the first zero if N is negative or the first N bytes of V if N is non-negative.
F16448 | The sqlite3_result_value(C,V) interface changes the return value of function C to be unprotected sqlite3_value object V.
F16451 | The sqlite3_result_zeroblob(C,N) interface changes the return value of function C to be an N-byte blob of all zeros.
F16454 | The sqlite3_result_error() and sqlite3_result_error16() interfaces make a copy of their error message strings before returning.
F16457 | If the D destructor parameter to sqlite3_result_blob(C,V,N,D), sqlite3_result_text(C,V,N,D), sqlite3_result_text16(C,V,N,D), sqlite3_result_text16be(C,V,N,D), or sqlite3_result_text16le(C,V,N,D) is the constant SQLITE_STATIC then no destructor is ever called on the pointer V and SQLite assumes that V is immutable.
F16460 | If the D destructor parameter to sqlite3_result_blob(C,V,N,D), sqlite3_result_text(C,V,N,D), sqlite3_result_text16(C,V,N,D), sqlite3_result_text16be(C,V,N,D), or sqlite3_result_text16le(C,V,N,D) is the constant SQLITE_TRANSIENT then the interfaces makes a copy of the content of V and retains the copy.
F16463 | If the D destructor parameter to sqlite3_result_blob(C,V,N,D), sqlite3_result_text(C,V,N,D), sqlite3_result_text16(C,V,N,D), sqlite3_result_text16be(C,V,N,D), or sqlite3_result_text16le(C,V,N,D) is some value other than the constants SQLITE_STATIC and SQLITE_TRANSIENT then SQLite will invoke the destructor D with V as its only argument when it has finished with the V value.
> F16600 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_create_collation(
>       sqlite3*,
>       const char *zName,
>       int eTextRep,
>       void*,
>       int(*xCompare)(void*,int,const void*,int,const void*)
>     );
>     int sqlite3_create_collation_v2(
>       sqlite3*,
>       const char *zName,
>       int eTextRep,
>       void*,
>       int(*xCompare)(void*,int,const void*,int,const void*),
>       void(*xDestroy)(void*)
>     );
>     int sqlite3_create_collation16(
>       sqlite3*,
>       const char *zName,
>       int eTextRep,
>       void*,
>       int(*xCompare)(void*,int,const void*,int,const void*)
>     );
F16603 | A successful call to the sqlite3_create_collation_v2(B,X,E,P,F,D) interface registers function F as the comparison function used to implement collation X on database connection B for databases having encoding E.
F16604 | SQLite understands the X parameter to sqlite3_create_collation_v2(B,X,E,P,F,D) as a zero-terminated UTF-8 string in which case is ignored for ASCII characters and is significant for non-ASCII characters.
F16606 | Successive calls to sqlite3_create_collation_v2(B,X,E,P,F,D) with the same values for B, X, and E, override prior values of P, F, and D.
F16609 | The destructor D in sqlite3_create_collation_v2(B,X,E,P,F,D) is not NULL then it is called with argument P when the collating function is dropped by SQLite.
F16612 | A collating function is dropped when it is overloaded.
F16615 | A collating function is dropped when the database connection is closed using sqlite3_close().
F16618 | The pointer P in sqlite3_create_collation_v2(B,X,E,P,F,D) is passed through as the first parameter to the comparison function F for all subsequent invocations of F.
F16621 | A call to sqlite3_create_collation(B,X,E,P,F) is exactly the same as a call to sqlite3_create_collation_v2() with the same parameters and a NULL destructor.
F16624 | Following a sqlite3_create_collation_v2(B,X,E,P,F,D), SQLite uses the comparison function F for all text comparison operations on database connection B on text values that use the collating sequence name X.
F16627 | The sqlite3_create_collation16(B,X,E,P,F) works the same as sqlite3_create_collation(B,X,E,P,F) except that the collation name X is understood as UTF-16 in native byte order instead of UTF-8.
F16630 | When multiple comparison functions are available for the same collating sequence, SQLite chooses the one whose text encoding requires the least amount of conversion from the default text encoding of the database.
> F16700 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_collation_needed(
>       sqlite3*,
>       void*,
>       void(*)(void*,sqlite3*,int eTextRep,const char*)
>     );
>     int sqlite3_collation_needed16(
>       sqlite3*,
>       void*,
>       void(*)(void*,sqlite3*,int eTextRep,const void*)
>     );
F16702 | A successful call to sqlite3_collation_needed(D,P,F) or sqlite3_collation_needed16(D,P,F) causes the database connection D to invoke callback F with first parameter P whenever it needs a comparison function for a collating sequence that it does not know about.
F16704 | Each successful call to sqlite3_collation_needed() or sqlite3_collation_needed16() overrides the callback registered on the same database connection by prior calls to either interface.
F16706 | The name of the requested collating function passed in the 4th parameter to the callback is in UTF-8 if the callback was registered using sqlite3_collation_needed() and is in UTF-16 native byte order if the callback was registered using sqlite3_collation_needed16().
> F17000 | The sqlite3.h header file defines the following interfaces:
>     sqlite3_mutex *sqlite3_mutex_alloc(int);
>     void sqlite3_mutex_free(sqlite3_mutex*);
>     void sqlite3_mutex_enter(sqlite3_mutex*);
>     int sqlite3_mutex_try(sqlite3_mutex*);
>     void sqlite3_mutex_leave(sqlite3_mutex*);
> F17001 | The sqlite3.h header file defines the following interfaces:
>     #define SQLITE_MUTEX_FAST             0
>     #define SQLITE_MUTEX_RECURSIVE        1
>     #define SQLITE_MUTEX_STATIC_MASTER    2
>     #define SQLITE_MUTEX_STATIC_MEM       3  /* sqlite3_malloc() */
>     #define SQLITE_MUTEX_STATIC_MEM2      4  /* sqlite3_release_memory() */
>     #define SQLITE_MUTEX_STATIC_PRNG      5  /* sqlite3_random() */
>     #define SQLITE_MUTEX_STATIC_LRU       6  /* lru page list */
>     #define SQLITE_MUTEX_STATIC_LRU2      7  /* lru page list */
> F17080 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_mutex_held(sqlite3_mutex*);
>     int sqlite3_mutex_notheld(sqlite3_mutex*);
> F17110 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_mutex sqlite3_mutex;
> F17300 | The sqlite3.h header file defines the following interfaces:
>     void *sqlite3_malloc(int);
>     void *sqlite3_realloc(void*, int);
>     void sqlite3_free(void*);
F17303 | The sqlite3_malloc(N) interface returns either a pointer to newly checked-out block of at least N bytes of memory that is 8-byte aligned, or it returns NULL if it is unable to fulfill the request.
F17304 | The sqlite3_malloc(N) interface returns a NULL pointer if N is less than or equal to zero.
F17305 | The sqlite3_free(P) interface releases memory previously returned from sqlite3_malloc() or sqlite3_realloc(), making it available for reuse.
F17306 | A call to sqlite3_free(NULL) is a harmless no-op.
F17310 | A call to sqlite3_realloc(0,N) is equivalent to a call to sqlite3_malloc(N).
F17312 | A call to sqlite3_realloc(P,0) is equivalent to a call to sqlite3_free(P).
F17315 | The SQLite core uses sqlite3_malloc(), sqlite3_realloc(), and sqlite3_free() for all of its memory allocation and deallocation needs.
F17318 | The sqlite3_realloc(P,N) interface returns either a pointer to a block of checked-out memory of at least N bytes in size that is 8-byte aligned, or a NULL pointer.
F17321 | When sqlite3_realloc(P,N) returns a non-NULL pointer, it first copies the first K bytes of content from P into the newly allocated where K is the lessor of N and the size of the buffer P.
F17322 | When sqlite3_realloc(P,N) returns a non-NULL pointer, it first releases the buffer P.
F17323 | When sqlite3_realloc(P,N) returns NULL, the buffer P is not modified or released.
> F17340 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_release_memory(int);
F17341 | The sqlite3_release_memory(N) interface attempts to free N bytes of heap memory by deallocating non-essential memory allocations held by the database labrary.
> F17350 | The sqlite3.h header file defines the following interfaces:
>     void sqlite3_soft_heap_limit(int);
> F17370 | The sqlite3.h header file defines the following interfaces:
>     sqlite3_int64 sqlite3_memory_used(void);
>     sqlite3_int64 sqlite3_memory_highwater(int resetFlag);
F17371 | The sqlite3_memory_used() routine returns the number of bytes of memory currently outstanding (malloced but not freed).
F17373 | The sqlite3_memory_highwater() routine returns the maximum value of sqlite3_memory_used() since the highwater mark was last reset.
F17374 | The values returned by sqlite3_memory_used() and sqlite3_memory_highwater() include any overhead added by SQLite in its implementation of sqlite3_malloc(), but not overhead added by the any underlying system library routines that sqlite3_malloc() may call.
F17375 | The memory highwater mark is reset to the current value of sqlite3_memory_used() if and only if the parameter to sqlite3_memory_highwater() is true. The value returned by sqlite3_memory_highwater(1) is the highwater mark prior to the reset.
> F17390 | The sqlite3.h header file defines the following interfaces:
>     void sqlite3_randomness(int N, void *P);
F17392 | The sqlite3_randomness(N,P) interface writes N bytes of high-quality pseudo-randomness into buffer P.
> F17400 | The sqlite3.h header file defines the following interfaces:
>     char *sqlite3_mprintf(const char*,...);
>     char *sqlite3_vmprintf(const char*, va_list);
>     char *sqlite3_snprintf(int,char*,const char*, ...);
F17403 | The sqlite3_mprintf() and sqlite3_vmprintf() interfaces return either pointers to zero-terminated UTF-8 strings held in memory obtained from sqlite3_malloc() or NULL pointers if a call to sqlite3_malloc() fails.
F17406 | The sqlite3_snprintf() interface writes a zero-terminated UTF-8 string into the buffer pointed to by the second parameter provided that the first parameter is greater than zero.
F17407 | The sqlite3_snprintf() interface does not writes slots of its output buffer (the second parameter) outside the range of 0 through N-1 (where N is the first parameter) regardless of the length of the string requested by the format specification.
> F17800 | The sqlite3.h header file defines the following interfaces:
>     typedef struct sqlite3_blob sqlite3_blob;
> F17810 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_blob_open(
>       sqlite3*,
>       const char *zDb,
>       const char *zTable,
>       const char *zColumn,
>       sqlite3_int64 iRow,
>       int flags,
>       sqlite3_blob **ppBlob
>     );
F17813 | A successful invocation of the sqlite3_blob_open(D,B,T,C,R,F,P) interface opens an sqlite3_blob object P on the blob in column C of table T in database B on database connection D.
F17814 | A successful invocation of sqlite3_blob_open(D,...) starts a new transaction on database connection D if that connection is not already in a transaction.
F17816 | The sqlite3_blob_open(D,B,T,C,R,F,P) interface opens the blob for read and write access if and only if the F parameter is non-zero.
F17819 | The sqlite3_blob_open() interface returns SQLITE_OK on success and an appropriate error code on failure.
F17821 | If an error occurs during evaluation of sqlite3_blob_open(D,...) then subsequent calls to sqlite3_errcode(D), sqlite3_errmsg(D), and sqlite3_errmsg16(D) will return information approprate for that error.
> F17830 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_blob_close(sqlite3_blob *);
F17833 | The sqlite3_blob_close(P) interface closes an sqlite3_blob object P previously opened using sqlite3_blob_open().
F17836 | Closing an sqlite3_blob object using sqlite3_blob_close() shall cause the current transaction to commit if there are no other open sqlite3_blob objects or prepared statements on the same database connection and the database connection is in autocommit mode.
F17839 | The sqlite3_blob_close(P) interfaces closes the sqlite3_blob object P unconditionally, even if sqlite3_blob_close(P) returns something other than SQLITE_OK.
> F17840 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_blob_bytes(sqlite3_blob *);
F17843 | The sqlite3_blob_bytes(P) interface returns the size in bytes of the BLOB that the sqlite3_blob object P refers to.
> F17850 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_blob_read(sqlite3_blob *, void *Z, int N, int iOffset);
F17853 | The sqlite3_blob_read(P,Z,N,X) interface reads N bytes beginning at offset X from the blob that sqlite3_blob object P refers to and writes those N bytes into buffer Z.
F17856 | In sqlite3_blob_read(P,Z,N,X) if the size of the blob is less than N+X bytes, then the function returns SQLITE_ERROR and nothing is read from the blob.
F17859 | In sqlite3_blob_read(P,Z,N,X) if X or N is less than zero then the function returns SQLITE_ERROR and nothing is read from the blob.
F17862 | The sqlite3_blob_read(P,Z,N,X) interface returns SQLITE_OK if N bytes where successfully read into buffer Z.
F17865 | If the requested read could not be completed, the sqlite3_blob_read(P,Z,N,X) interface returns an appropriate error code or extended error code.
F17868 | If an error occurs during evaluation of sqlite3_blob_read(P,...) then subsequent calls to sqlite3_errcode(D), sqlite3_errmsg(D), and sqlite3_errmsg16(D) will return information approprate for that error, where D is the database handle that was used to open blob handle P.
> F17870 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_blob_write(sqlite3_blob *, const void *z, int n, int iOffset);
F17873 | The sqlite3_blob_write(P,Z,N,X) interface writes N bytes from buffer Z into the blob that sqlite3_blob object P refers to beginning at an offset of X into the blob.
F17875 | The sqlite3_blob_write(P,Z,N,X) interface returns SQLITE_READONLY if the sqlite3_blob object P was opened for reading only.
F17876 | In sqlite3_blob_write(P,Z,N,X) if the size of the blob is less than N+X bytes, then the function returns SQLITE_ERROR and nothing is written into the blob.
F17879 | In sqlite3_blob_write(P,Z,N,X) if X or N is less than zero then the function returns SQLITE_ERROR and nothing is written into the blob.
F17882 | The sqlite3_blob_write(P,Z,N,X) interface returns SQLITE_OK if N bytes where successfully written into blob.
F17885 | If the requested write could not be completed, the sqlite3_blob_write(P,Z,N,X) interface returns an appropriate error code or extended error code.
F17888 | If an error occurs during evaluation of sqlite3_blob_write(D,...) then subsequent calls to sqlite3_errcode(D), sqlite3_errmsg(D), and sqlite3_errmsg16(D) will return information approprate for that error.
> F18000 | The sqlite3.h header file defines the following interfaces:
>     struct sqlite3_module {
>       int iVersion;
>       int (*xCreate)(sqlite3*, void *pAux,
>                    int argc, const char *const*argv,
>                    sqlite3_vtab **ppVTab, char**);
>       int (*xConnect)(sqlite3*, void *pAux,
>                    int argc, const char *const*argv,
>                    sqlite3_vtab **ppVTab, char**);
>       int (*xBestIndex)(sqlite3_vtab *pVTab, sqlite3_index_info*);
>       int (*xDisconnect)(sqlite3_vtab *pVTab);
>       int (*xDestroy)(sqlite3_vtab *pVTab);
>       int (*xOpen)(sqlite3_vtab *pVTab, sqlite3_vtab_cursor **ppCursor);
>       int (*xClose)(sqlite3_vtab_cursor*);
>       int (*xFilter)(sqlite3_vtab_cursor*, int idxNum, const char *idxStr,
>                     int argc, sqlite3_value **argv);
>       int (*xNext)(sqlite3_vtab_cursor*);
>       int (*xEof)(sqlite3_vtab_cursor*);
>       int (*xColumn)(sqlite3_vtab_cursor*, sqlite3_context*, int);
>       int (*xRowid)(sqlite3_vtab_cursor*, sqlite3_int64 *pRowid);
>       int (*xUpdate)(sqlite3_vtab *, int, sqlite3_value **, sqlite3_int64 *);
>       int (*xBegin)(sqlite3_vtab *pVTab);
>       int (*xSync)(sqlite3_vtab *pVTab);
>       int (*xCommit)(sqlite3_vtab *pVTab);
>       int (*xRollback)(sqlite3_vtab *pVTab);
>       int (*xFindFunction)(sqlite3_vtab *pVtab, int nArg, const char *zName,
>                            void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),
>                            void **ppArg);
> F18010 | The sqlite3.h header file defines the following interfaces:
>     struct sqlite3_vtab {
>       const sqlite3_module *pModule;  /* The module for this virtual table */
>       int nRef;                       /* Used internally */
>       char *zErrMsg;                  /* Error message from sqlite3_mprintf() */
>       /* Virtual table implementations will typically add additional fields */
>     };
> F18020 | The sqlite3.h header file defines the following interfaces:
>     struct sqlite3_vtab_cursor {
>       sqlite3_vtab *pVtab;      /* Virtual table of this cursor */
>       /* Virtual table implementations will typically add additional fields */
>     };
> F18100 | The sqlite3.h header file defines the following interfaces:
>     struct sqlite3_index_info {
>       /* Inputs */
>       int nConstraint;           /* Number of entries in aConstraint */
>       struct sqlite3_index_constraint {
>          int iColumn;              /* Column on left-hand side of constraint */
>          unsigned char op;         /* Constraint operator */
>          unsigned char usable;     /* True if this constraint is usable */
>          int iTermOffset;          /* Used internally - xBestIndex should ignore */
>       } *aConstraint;            /* Table of WHERE clause constraints */
>       int nOrderBy;              /* Number of terms in the ORDER BY clause */
>       struct sqlite3_index_orderby {
>          int iColumn;              /* Column number */
>          unsigned char desc;       /* True for DESC.  False for ASC. */
>       } *aOrderBy;               /* The ORDER BY clause */
> F18200 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_create_module(
>       sqlite3 *db,               /* SQLite connection to register module with */
>       const char *zName,         /* Name of the module */
>       const sqlite3_module *,    /* Methods for the module */
>       void *                     /* Client data for xCreate/xConnect */
>     );
> F18210 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_create_module_v2(
>       sqlite3 *db,               /* SQLite connection to register module with */
>       const char *zName,         /* Name of the module */
>       const sqlite3_module *,    /* Methods for the module */
>       void *,                    /* Client data for xCreate/xConnect */
>       void(*xDestroy)(void*)     /* Module destructor function */
>     );
> F18280 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_declare_vtab(sqlite3*, const char *zCreateTable);
> F18300 | The sqlite3.h header file defines the following interfaces:
>     int sqlite3_overload_function(sqlite3*, const char *zFuncName, int nArg);
U10512 | The input to sqlite3_complete() must be a zero-terminated UTF-8 string.
U10513 | The input to sqlite3_complete16() must be a zero-terminated UTF-16 string in native byte order.
U12015 | The parameter to sqlite3_close() must be an sqlite3 object pointer previously obtained from sqlite3_open() or the equivalent, or NULL.
U12016 | The parameter to sqlite3_close() must not have been previously closed.
U12141 | The first parameter to sqlite3_exec() must be an valid and open database connection.
U12142 | The database connection must not be closed while sqlite3_exec() is running.
U12143 | The calling function is should use sqlite3_free() to free the memory that *errmsg is left pointing at once the error message is no longer needed.
U12145 | The SQL statement text in the 2nd parameter to sqlite3_exec() must remain unchanged while sqlite3_exec() is running.
U12232 | If a separate thread does a new insert on the same database connection while the sqlite3_last_insert_rowid() function is running and thus changes the last insert rowid, then the value returned by sqlite3_last_insert_rowid() is unpredictable and might not equal either the old or the new last insert rowid.
U12252 | If a separate thread makes changes on the same database connection while sqlite3_changes() is running then the value returned is unpredictable and unmeaningful.
U12264 | If a separate thread makes changes on the same database connection while sqlite3_total_changes() is running then the value returned is unpredictable and unmeaningful.
U12279 | If the database connection closes while sqlite3_interrupt() is running then bad things will likely happen.
U12319 | A busy handler should not call close the database connection or prepared statement that invoked the busy handler.
U12936 | If another thread changes the autocommit status of the database connection while this routine is running, then the return value is undefined.
U13751 | If two or more threads call one or more column metadata interfaces the same prepared statement and result column at the same time then the results are undefined.
U17350 | The pointer arguments to sqlite3_free() and sqlite3_realloc() must be either NULL or else a pointer obtained from a prior invocation of sqlite3_malloc() or sqlite3_realloc() that has not been released.
U17351 | The application must not read or write any part of a block of memory after it has been released using sqlite3_free() or sqlite3_realloc().

This page last modified 2008/01/30 17:07:56 UTC