Package-level declarations

Types

Link copied to clipboard
typealias JniPointer = Long

Pointer type for JNI.

Link copied to clipboard

Pointer array type for JNI.

Link copied to clipboard
sealed class OutputPointer<Value>

Output pointer holding a value set on native side.

Functions

Link copied to clipboard
external fun ioMethodsClose(xClose: JniPointer, file: JniPointer): Int

Invokes sqlite3io_methods::[xClose].

Link copied to clipboard

To align with other platforms behavior, only one auto extension is allowed.

Link copied to clipboard
Link copied to clipboard
external fun ksqlite_prepare_v2(db: JniPointer, sql: ByteArray, maxBytes: Int, outStmt: OutputPointer.OfPointer, outOffset: OutputPointer.OfInt32?): Int
Link copied to clipboard
external fun ksqlite_prepare_v3(db: JniPointer, sql: ByteArray, maxBytes: Int, flags: Int, outStmt: OutputPointer.OfPointer, outOffset: OutputPointer.OfInt32?): Int
Link copied to clipboard

Loads the Kotlin SQLite library (including SQLite Official JNI layer and SQLite).

Link copied to clipboard
external fun nativeBufferAllocate(size: Long): JniPointer

Allocates size bytes and returns a pointer to the allocated memory. The default allocator is used to obtains memory.

Link copied to clipboard
external fun nativeBufferFree(pointer: JniPointer)

Frees memory previously obtained using nativeBufferAllocate.

Link copied to clipboard
external fun nativeBufferRead(buffer: JniPointer, destination: ByteArray, size: Int, sourceOffset: Long, destinationOffset: Int)

Reads bytes into destination.

Link copied to clipboard
external fun nativeBufferWrite(buffer: JniPointer, source: ByteArray, size: Int, sourceOffset: Int, destinationOffset: Long)

Writes bytes from source.

Link copied to clipboard
external fun nativeFreeAndMalloc(pointer: JniPointer, message: String?): JniPointer

Frees pointer using sqlite3_free ands returns the result of sqlite3_mprintf on message. If message is null then only sqlite3_free is called on pointer and 0 is returned

Link copied to clipboard
external fun nativeReadString(pointer: JniPointer): String

Reads bytes until null termination marker is found and returns the bytes read as String.

Link copied to clipboard
external fun sqlite3_aggregate_context(context: JniPointer, create: Boolean): JniPointer
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_backup_finish(backup: JniPointer): Int
Link copied to clipboard
external fun sqlite3_backup_init(destDb: JniPointer, destDbName: String, srcDb: JniPointer, srcDbName: String): JniPointer
Link copied to clipboard
external fun sqlite3_backup_pagecount(backup: JniPointer): Int
Link copied to clipboard
external fun sqlite3_backup_remaining(backup: JniPointer): Int
Link copied to clipboard
external fun sqlite3_backup_step(backup: JniPointer, nPage: Int): Int
Link copied to clipboard
external fun sqlite3_bind_blob(stmt: JniPointer, index: Int, bytes: ByteArray, size: Int, destructor: DestructorCallback?): Int
Link copied to clipboard
external fun sqlite3_bind_blob64(stmt: JniPointer, index: Int, buffer: JniPointer, size: Long, destructor: DestructorCallback?): Int
Link copied to clipboard
external fun sqlite3_bind_double(stmt: JniPointer, index: Int, value: Double): Int
Link copied to clipboard
external fun sqlite3_bind_int(stmt: JniPointer, index: Int, value: Int): Int
Link copied to clipboard
external fun sqlite3_bind_int64(stmt: JniPointer, index: Int, value: Long): Int
Link copied to clipboard
external fun sqlite3_bind_null(stmt: JniPointer, index: Int): Int
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_bind_parameter_name(stmt: JniPointer, index: Int): String
Link copied to clipboard
external fun sqlite3_bind_pointer(stmt: JniPointer, index: Int, data: Any?, type: String?, destructor: DestructorCallback?): Int
Link copied to clipboard
external fun sqlite3_bind_text(stmt: JniPointer, index: Int, value: String): Int
Link copied to clipboard
external fun sqlite3_bind_text64(stmt: JniPointer, index: Int, buffer: JniPointer, size: Long, destructor: DestructorCallback?, encoding: Int): Int
Link copied to clipboard
external fun sqlite3_bind_value(stmt: JniPointer, index: Int, value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_bind_zeroblob(stmt: JniPointer, index: Int, size: Int): Int
Link copied to clipboard
external fun sqlite3_bind_zeroblob64(stmt: JniPointer, index: Int, size: Long): Int
Link copied to clipboard
external fun sqlite3_blob_bytes(blob: JniPointer): Int
Link copied to clipboard
external fun sqlite3_blob_close(blob: JniPointer): Int
Link copied to clipboard
external fun sqlite3_blob_open(db: JniPointer, databaseName: String, tableName: String, columnName: String, rowid: Long, flags: Int, outBlob: OutputPointer.OfPointer?): Int
Link copied to clipboard
external fun sqlite3_blob_read(blob: JniPointer, buffer: ByteArray, size: Int, offset: Int): Int
Link copied to clipboard
external fun sqlite3_blob_reopen(blob: JniPointer, rowid: Long): Int
Link copied to clipboard
external fun sqlite3_blob_write(blob: JniPointer, buffer: ByteArray, size: Int, offset: Int): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_busy_timeout(db: JniPointer, millis: Int): Int
Link copied to clipboard
external fun sqlite3_changes(db: JniPointer): Int
Link copied to clipboard
external fun sqlite3_changes64(db: JniPointer): Long
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_close(db: JniPointer): Int
Link copied to clipboard
external fun sqlite3_close_v2(db: JniPointer): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_column_blob(stmt: JniPointer, index: Int): ByteArray
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_column_bytes(stmt: JniPointer, index: Int): Int
Link copied to clipboard
external fun sqlite3_column_count(stmt: JniPointer): Int
Link copied to clipboard
external fun sqlite3_column_database_name(stmt: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_column_decltype(stmt: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_column_double(stmt: JniPointer, index: Int): Double
Link copied to clipboard
external fun sqlite3_column_int(stmt: JniPointer, index: Int): Int
Link copied to clipboard
external fun sqlite3_column_int64(stmt: JniPointer, index: Int): Long
Link copied to clipboard
external fun sqlite3_column_name(stmt: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_column_origin_name(stmt: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_column_table_name(stmt: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_column_text(stmt: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_column_type(stmt: JniPointer, index: Int): Int
Link copied to clipboard
external fun sqlite3_column_value(stmt: JniPointer, index: Int): JniPointer
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_compileoption_get(index: Int): String?
Link copied to clipboard
external fun sqlite3_compileoption_used(optName: String): Int
Link copied to clipboard
external fun sqlite3_complete(sql: String): Int
Link copied to clipboard
external fun sqlite3_config(id: Int, args: Array<*>): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_create_collation_v2(db: JniPointer, name: String, eTextRep: Int, destructor: DestructorCallback?, callback: CollationCallback?): Int
Link copied to clipboard
external fun sqlite3_create_function_v2(db: JniPointer, name: String, nArg: Int, eTextRep: Int, appData: Any?, func: FunctionCallback.Func?, step: FunctionCallback.Step?, final: FunctionCallback.Final?, destroy: DestructorCallback?): Int
Link copied to clipboard
external fun sqlite3_create_module_v2(db: JniPointer, name: String, module: JniPointer, appData: Any?, destroy: DestructorCallback?): Int
Link copied to clipboard
external fun sqlite3_create_window_function(db: JniPointer, name: String, nArg: Int, eTextRep: Int, appData: Any?, step: FunctionCallback.Step?, final: FunctionCallback.Final?, value: FunctionCallback.Value?, inverse: FunctionCallback.Inverse?, destroy: DestructorCallback?): Int
Link copied to clipboard
external fun sqlite3_data_count(stmt: JniPointer): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_db_config(db: JniPointer, option: Int, args: Array<*>): Int
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_db_name(db: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_db_readonly(db: JniPointer, name: String): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_db_status(db: JniPointer, option: Int, outCurrent: OutputPointer.OfInt32?, outHighwater: OutputPointer.OfInt32?, resetFlag: Int): Int
Link copied to clipboard
external fun sqlite3_db_status64(db: JniPointer, option: Int, outCurrent: OutputPointer.OfInt64?, outHighwater: OutputPointer.OfInt64?, resetFlag: Int): Int
Link copied to clipboard
external fun sqlite3_declare_vtab(db: JniPointer, sql: String): Int
Link copied to clipboard
external fun sqlite3_deserialize(db: JniPointer, schema: String?, buffer: JniPointer, dbSize: Long, bufferSize: Long, flags: Int): Int
Link copied to clipboard
external fun sqlite3_drop_modules(db: JniPointer, modules: Array<String>?): Int
Link copied to clipboard
external fun sqlite3_errcode(db: JniPointer): Int
Link copied to clipboard
external fun sqlite3_errmsg(db: JniPointer): String?
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_errstr(resultCode: Int): String?
Link copied to clipboard
external fun sqlite3_exec(db: JniPointer, sql: String, callback: ExecCallback?, errorMessage: OutputPointer.OfString?): Int
Link copied to clipboard
external fun sqlite3_expanded_sql(stmt: JniPointer): String?
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_extended_result_codes(db: JniPointer, enabled: Int): Int
Link copied to clipboard
external fun sqlite3_file_control(db: JniPointer, name: String?, opcode: Int, param: Any?): Int
Link copied to clipboard
external fun sqlite3_filename_database(fileName: JniPointer): String?
Link copied to clipboard
external fun sqlite3_filename_journal(fileName: JniPointer): String?
Link copied to clipboard
external fun sqlite3_filename_wal(fileName: JniPointer): String?
Link copied to clipboard
external fun sqlite3_finalize(stmt: JniPointer): Int
Link copied to clipboard
external fun sqlite3_free(buffer: JniPointer)
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_get_auxdata(context: JniPointer, index: Int): JniPointer
Link copied to clipboard
external fun sqlite3_hard_heap_limit64(limit: Long): Long
Link copied to clipboard
external fun sqlite3_initialize(): Int
Link copied to clipboard
external fun sqlite3_interrupt(db: JniPointer)
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_key(db: JniPointer, key: ByteArray, nKey: Int): Int
Link copied to clipboard
external fun sqlite3_key_v2(db: JniPointer, dbName: String, key: ByteArray, nKey: Int): Int
Link copied to clipboard
external fun sqlite3_keyword_check(word: String): Int
Link copied to clipboard
external fun sqlite3_keyword_count(): Int
Link copied to clipboard
external fun sqlite3_keyword_name(index: Int, name: OutputPointer.OfString?): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_libversion(): String
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_limit(db: JniPointer, id: Int, newVal: Int): Int
Link copied to clipboard
external fun sqlite3_log(errorCode: Int, message: String)
Link copied to clipboard
external fun sqlite3_malloc(size: Int): JniPointer
Link copied to clipboard
external fun sqlite3_malloc64(size: Long): JniPointer
Link copied to clipboard
external fun sqlite3_memory_highwater(resetFlag: Int): Long
Link copied to clipboard
external fun sqlite3_memory_used(): Long
Link copied to clipboard
external fun sqlite3_msize(buffer: JniPointer): Long
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_open(fileName: String, outDb: OutputPointer.OfPointer): Int
Link copied to clipboard
external fun sqlite3_open_v2(fileName: String, outDb: OutputPointer.OfPointer, flags: Int, vfs: String?): Int
Link copied to clipboard
external fun sqlite3_overload_function(db: JniPointer, name: String, nArg: Int): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_prepare_v3(db: JniPointer, sql: String, flags: Int, outStmt: OutputPointer.OfPointer): Int
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_preupdate_new(db: JniPointer, index: Int, outValue: OutputPointer.OfPointer): Int
Link copied to clipboard
external fun sqlite3_preupdate_old(db: JniPointer, index: Int, outValue: OutputPointer.OfPointer): Int
Link copied to clipboard
external fun sqlite3_progress_handler(db: JniPointer, nOps: Int, callback: ProgressHandlerCallback?)
Link copied to clipboard
external fun sqlite3_randomness(size: Int, buffer: JniPointer)
Link copied to clipboard
external fun sqlite3_realloc(buffer: JniPointer, size: Int): JniPointer
Link copied to clipboard
external fun sqlite3_realloc64(buffer: JniPointer, size: Long): JniPointer
Link copied to clipboard
external fun sqlite3_rekey(db: JniPointer, key: ByteArray, nKey: Int): Int
Link copied to clipboard
external fun sqlite3_rekey_v2(db: JniPointer, dbName: String, key: ByteArray, nKey: Int): Int
Link copied to clipboard
external fun sqlite3_release_memory(size: Int): Int
Link copied to clipboard
external fun sqlite3_reset(stmt: JniPointer): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_result_blob(context: JniPointer, bytes: ByteArray, size: Int, destructor: DestructorCallback?)
Link copied to clipboard
external fun sqlite3_result_blob64(context: JniPointer, buffer: JniPointer, size: Long, destructor: DestructorCallback?)
Link copied to clipboard
external fun sqlite3_result_double(context: JniPointer, value: Double)
Link copied to clipboard
external fun sqlite3_result_error(context: JniPointer, message: String)
Link copied to clipboard
external fun sqlite3_result_error_code(context: JniPointer, errorCode: Int)
Link copied to clipboard
external fun sqlite3_result_error_nomem(context: JniPointer)
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_result_int(context: JniPointer, value: Int)
Link copied to clipboard
external fun sqlite3_result_int64(context: JniPointer, value: Long)
Link copied to clipboard
external fun sqlite3_result_null(context: JniPointer)
Link copied to clipboard
external fun sqlite3_result_pointer(context: JniPointer, data: Any?, type: String?, destructor: DestructorCallback?)
Link copied to clipboard
external fun sqlite3_result_subtype(context: JniPointer, subtype: Int)
Link copied to clipboard
external fun sqlite3_result_text(context: JniPointer, value: String)
Link copied to clipboard
external fun sqlite3_result_text64(context: JniPointer, buffer: JniPointer, size: Long, destructor: DestructorCallback?, encoding: Int)
Link copied to clipboard
external fun sqlite3_result_value(context: JniPointer, value: JniPointer)
Link copied to clipboard
external fun sqlite3_result_zeroblob(context: JniPointer, size: Int)
Link copied to clipboard
external fun sqlite3_result_zeroblob64(context: JniPointer, size: Long): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_serialize(db: JniPointer, schema: String?, outSize: OutputPointer.OfInt64, flags: Int): JniPointer
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_set_auxdata(context: JniPointer, index: Int, destructor: DestructorCallback?): JniPointer
Link copied to clipboard
external fun sqlite3_set_errmsg(db: JniPointer, errorCode: Int, message: String?): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_shutdown(): Int
Link copied to clipboard
external fun sqlite3_snapshot_cmp(snapshot1: JniPointer, snapshot2: JniPointer): Int
Link copied to clipboard
external fun sqlite3_snapshot_free(snapshot: JniPointer)
Link copied to clipboard
external fun sqlite3_snapshot_get(db: JniPointer, name: String, outSnapshot: OutputPointer.OfPointer): Int
Link copied to clipboard
external fun sqlite3_snapshot_open(db: JniPointer, name: String, snapshot: JniPointer): Int
Link copied to clipboard
external fun sqlite3_snapshot_recover(db: JniPointer, name: String): Int
Link copied to clipboard
external fun sqlite3_soft_heap_limit64(limit: Long): Long
Link copied to clipboard
external fun sqlite3_sourceid(): String
Link copied to clipboard
external fun sqlite3_sql(stmt: JniPointer): String
Link copied to clipboard
external fun sqlite3_status(option: Int, outCurrent: OutputPointer.OfInt32, outHighwater: OutputPointer.OfInt32, resetFlag: Int): Int
Link copied to clipboard
external fun sqlite3_status64(option: Int, outCurrent: OutputPointer.OfInt64, outHighwater: OutputPointer.OfInt64, resetFlag: Int): Int
Link copied to clipboard
external fun sqlite3_step(stmt: JniPointer): Int
Link copied to clipboard
external fun sqlite3_stmt_busy(stmt: JniPointer): Int
Link copied to clipboard
external fun sqlite3_stmt_explain(stmt: JniPointer, mode: Int): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_stmt_readonly(stmt: JniPointer): Int
Link copied to clipboard
external fun sqlite3_stmt_status(stmt: JniPointer, counter: Int, resetFlag: Int): Int
Link copied to clipboard
external fun sqlite3_strglob(pattern: String, input: String): Int
Link copied to clipboard
external fun sqlite3_stricmp(first: String, second: String): Int
Link copied to clipboard
external fun sqlite3_strlike(pattern: String, input: String, escape: Int): Int
Link copied to clipboard
external fun sqlite3_strnicmp(first: String, second: String, maxChars: Int): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_table_column_metadata(db: JniPointer, dbName: String?, tableName: String, columnName: String, outDataType: OutputPointer.OfString?, outCollationName: OutputPointer.OfString?, outNotNull: OutputPointer.OfInt32?, outPrimaryKey: OutputPointer.OfInt32?, outAutoIncrement: OutputPointer.OfInt32?): Int
Link copied to clipboard
external fun sqlite3_threadsafe(): Int
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_trace_v2(db: JniPointer, mask: Int, callback: TraceCallback?): Int
Link copied to clipboard
external fun sqlite3_txn_state(db: JniPointer, schema: String?): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_uri_boolean(fileName: JniPointer, parameter: String, def: Int): Int
Link copied to clipboard
external fun sqlite3_uri_int64(fileName: JniPointer, parameter: String, def: Long): Long
Link copied to clipboard
external fun sqlite3_uri_key(fileName: JniPointer, index: Int): String?
Link copied to clipboard
external fun sqlite3_uri_parameter(fileName: JniPointer, parameter: String): String?
Link copied to clipboard
external fun sqlite3_user_data(context: JniPointer): Any?
Link copied to clipboard
external fun sqlite3_value_blob(value: JniPointer): ByteArray?
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_value_bytes(value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_value_double(value: JniPointer): Double
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_value_encoding(value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_value_free(value: JniPointer)
Link copied to clipboard
external fun sqlite3_value_frombind(value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_value_int(value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_value_int64(value: JniPointer): Long
Link copied to clipboard
external fun sqlite3_value_nochange(value: JniPointer): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_value_pointer(value: JniPointer, type: String?): Any?
Link copied to clipboard
external fun sqlite3_value_subtype(value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_value_text(value: JniPointer): String?
Link copied to clipboard
external fun sqlite3_value_type(value: JniPointer): Int
Link copied to clipboard
external fun sqlite3_vfs_find(name: String?): JniPointer
Link copied to clipboard
external fun sqlite3_vfs_register(vfs: JniPointer, makeDefault: Int): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_vtab_collation(info: JniPointer, index: Int): String
Link copied to clipboard
external fun sqlite3_vtab_config(db: JniPointer, option: Int, args: Array<*>): Int
Link copied to clipboard
external fun sqlite3_vtab_distinct(info: JniPointer): Int
Link copied to clipboard
external fun sqlite3_vtab_in(info: JniPointer, index: Int, handle: Int): Int
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_vtab_nochange(context: JniPointer): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3_vtab_rhs_value(info: JniPointer, index: Int, outValue: OutputPointer.OfPointer?): Int
Link copied to clipboard
external fun sqlite3_wal_autocheckpoint(db: JniPointer, nFrame: Int): Int
Link copied to clipboard
external fun sqlite3_wal_checkpoint(db: JniPointer, name: String?): Int
Link copied to clipboard
external fun sqlite3_wal_checkpoint_v2(db: JniPointer, name: String?, mode: Int, outNLog: OutputPointer.OfInt32?, outNCkpt: OutputPointer.OfInt32?): Int
Link copied to clipboard
Link copied to clipboard
external fun sqlite3mc_cipher_count(): Int
Link copied to clipboard
external fun sqlite3mc_cipher_index(cipherName: String): Int
Link copied to clipboard
external fun sqlite3mc_cipher_name(index: Int): String?
Link copied to clipboard
external fun sqlite3mc_codec_data(db: JniPointer, schemaName: String?, paramName: String): JniPointer
Link copied to clipboard
external fun sqlite3mc_config(db: JniPointer, paramName: String, newValue: Int): Int
Link copied to clipboard
external fun sqlite3mc_config_cipher(db: JniPointer, cipherName: String, paramName: String, newValue: Int): Int
Link copied to clipboard
external fun sqlite3mc_register_cipher(descriptor: JniPointer, params: JniPointer, makeDefault: Int): Int
Link copied to clipboard
external fun sqlite3mc_version(): String
Link copied to clipboard
external fun sqlite3mc_vfs_create(realName: String, makeDefault: Int): Int
Link copied to clipboard
external fun sqlite3mc_vfs_destroy(name: String)
Link copied to clipboard
external fun sqlite3mc_vfs_shutdown()
Link copied to clipboard
external fun vfsAccess(xAccess: JniPointer, vfs: JniPointer, name: String, flags: Int, outFlags: OutputPointer.OfInt32?): Int

Invokes sqlite3_vfs::[xAccess].

Link copied to clipboard
external fun vfsDelete(xDelete: JniPointer, vfs: JniPointer, name: String, syncDir: Int): Int

Invokes sqlite3_vfs::[xDelete].

Link copied to clipboard
external fun vfsOpen(xOpen: JniPointer, vfs: JniPointer, name: String?, file: JniPointer, flags: Int, outFlags: OutputPointer.OfInt32?): Int

Invokes sqlite3_vfs::[xOpen].