Small. Fast. Reliable.
Choose any three.

SQLite C Interface

Test To See If The Library Is Threadsafe

int sqlite3_threadsafe(void);

SQLite can be compiled with or without mutexes. When the SQLITE_THREADSAFE C preprocessor macro 1 or 2, mutexes are enabled and SQLite is threadsafe. When the SQLITE_THREADSAFE macro is 0, the mutexes are omitted. Without the mutexes, it is not safe to use SQLite concurrently from more than one thread.

Enabling mutexes incurs a measurable performance penalty. So if speed is of utmost importance, it makes sense to disable the mutexes. But for maximum safety, mutexes should be enabled. The default behavior is for mutexes to be enabled.

This interface can be used by a program to make sure that the version of SQLite that it is linking against was compiled with the desired setting of the SQLITE_THREADSAFE macro.

This interface only reports on the compile-time mutex setting of the SQLITE_THREADSAFE flag. If SQLite is compiled with SQLITE_THREADSAFE=1 then mutexes are enabled by default but can be fully or partially disabled using a call to sqlite3_config() with the verbs SQLITE_CONFIG_SINGLETHREAD, SQLITE_CONFIG_MULTITHREAD, or SQLITE_CONFIG_MUTEX. The return value of this function shows only the default compile-time setting, not any run-time changes to that setting.

See the threading mode documentation for additional information.

Requirements: H10101 H10102

See also lists of Objects, Constants, and Functions.


This page last modified 2009/07/31 12:35:28 UTC