Настройка библиотеки SQLite

int sqlite3_config(int, ...);

Интерфейс sqlite3_config() используется для внесения глобальных изменений в конфигурацию SQLite, чтобы настроить SQLite в соответствии с конкретными потребностями приложения. Для большинства приложений рекомендуется использовать стандартную конфигурацию, поэтому эта процедура обычно не требуется. Она предоставляется для поддержки редких приложений с необычными потребностями.

Интерфейс sqlite3_config() не является потокобезопасным. Приложение должно гарантировать, что другие интерфейсы SQLite не вызываются другими потоками во время выполнения sqlite3_config().

Первый аргумент sqlite3_config() — целое число опции конфигурации, определяющее, какой свойство SQLite необходимо настроить. Последующие аргументы зависят от опции конфигурации в первом аргументе.

Для большинства опций конфигурации интерфейс sqlite3_config() можно вызывать только до инициализации библиотеки с помощью sqlite3_initialize() или после завершения работы с помощью sqlite3_shutdown(). Исключительные опции конфигурации, которые можно вызывать в любое время, называются "опциями конфигурации в любое время". Если sqlite3_config() вызывается после sqlite3_initialize() и перед sqlite3_shutdown() с первым аргументом, который не является опцией конфигурации в любое время, то вызов sqlite3_config() вернет SQLITE_MISUSE. Однако обратите внимание, что sqlite3_config() может вызываться как часть реализации определенной приложением функции sqlite3_os_init().

При установке опции конфигурации sqlite3_config() возвращает SQLITE_OK. Если опция неизвестна или SQLite не может установить опцию, то эта процедура возвращает ненулевой код ошибки.

См. также списки объектов, констант и функций.