11e397f8fSdrh /* 21e397f8fSdrh ** 2006 June 7 31e397f8fSdrh ** 41e397f8fSdrh ** The author disclaims copyright to this source code. In place of 51e397f8fSdrh ** a legal notice, here is a blessing: 61e397f8fSdrh ** 71e397f8fSdrh ** May you do good and not evil. 81e397f8fSdrh ** May you find forgiveness for yourself and forgive others. 91e397f8fSdrh ** May you share freely, never taking more than you give. 101e397f8fSdrh ** 111e397f8fSdrh ************************************************************************* 121e397f8fSdrh ** This header file defines the SQLite interface for use by 131e397f8fSdrh ** shared libraries that want to be imported as extensions into 141e397f8fSdrh ** an SQLite instance. Shared libraries that intend to be loaded 151e397f8fSdrh ** as extensions by SQLite should #include this file instead of 161e397f8fSdrh ** sqlite3.h. 171e397f8fSdrh */ 1843f58d6aSdrh #ifndef SQLITE3EXT_H 1943f58d6aSdrh #define SQLITE3EXT_H 2073bdf077Sdrh #include "sqlite3.h" 211e397f8fSdrh 221e397f8fSdrh /* 23d885c7beSmlcreech ** The following structure holds pointers to all of the SQLite API 241e397f8fSdrh ** routines. 25d8a2b384Sdrh ** 26d8a2b384Sdrh ** WARNING: In order to maintain backwards compatibility, add new 27d8a2b384Sdrh ** interfaces to the end of this structure only. If you insert new 28d8a2b384Sdrh ** interfaces in the middle of this structure, then older different 2960ec914cSpeter.d.reid ** versions of SQLite will not be able to load each other's shared 30d8a2b384Sdrh ** libraries! 311e397f8fSdrh */ 321e397f8fSdrh struct sqlite3_api_routines { 331e397f8fSdrh void * (*aggregate_context)(sqlite3_context*,int nBytes); 341e397f8fSdrh int (*aggregate_count)(sqlite3_context*); 351e397f8fSdrh int (*bind_blob)(sqlite3_stmt*,int,const void*,int n,void(*)(void*)); 361e397f8fSdrh int (*bind_double)(sqlite3_stmt*,int,double); 371e397f8fSdrh int (*bind_int)(sqlite3_stmt*,int,int); 381e397f8fSdrh int (*bind_int64)(sqlite3_stmt*,int,sqlite_int64); 391e397f8fSdrh int (*bind_null)(sqlite3_stmt*,int); 401e397f8fSdrh int (*bind_parameter_count)(sqlite3_stmt*); 411e397f8fSdrh int (*bind_parameter_index)(sqlite3_stmt*,const char*zName); 421e397f8fSdrh const char * (*bind_parameter_name)(sqlite3_stmt*,int); 431e397f8fSdrh int (*bind_text)(sqlite3_stmt*,int,const char*,int n,void(*)(void*)); 441e397f8fSdrh int (*bind_text16)(sqlite3_stmt*,int,const void*,int,void(*)(void*)); 45c1be6324Sdrh int (*bind_value)(sqlite3_stmt*,int,const sqlite3_value*); 461e397f8fSdrh int (*busy_handler)(sqlite3*,int(*)(void*,int),void*); 471e397f8fSdrh int (*busy_timeout)(sqlite3*,int ms); 481e397f8fSdrh int (*changes)(sqlite3*); 491e397f8fSdrh int (*close)(sqlite3*); 500d1ee483Sdrh int (*collation_needed)(sqlite3*,void*,void(*)(void*,sqlite3*, 510d1ee483Sdrh int eTextRep,const char*)); 520d1ee483Sdrh int (*collation_needed16)(sqlite3*,void*,void(*)(void*,sqlite3*, 530d1ee483Sdrh int eTextRep,const void*)); 541e397f8fSdrh const void * (*column_blob)(sqlite3_stmt*,int iCol); 551e397f8fSdrh int (*column_bytes)(sqlite3_stmt*,int iCol); 561e397f8fSdrh int (*column_bytes16)(sqlite3_stmt*,int iCol); 571e397f8fSdrh int (*column_count)(sqlite3_stmt*pStmt); 581e397f8fSdrh const char * (*column_database_name)(sqlite3_stmt*,int); 591e397f8fSdrh const void * (*column_database_name16)(sqlite3_stmt*,int); 601e397f8fSdrh const char * (*column_decltype)(sqlite3_stmt*,int i); 611e397f8fSdrh const void * (*column_decltype16)(sqlite3_stmt*,int); 621e397f8fSdrh double (*column_double)(sqlite3_stmt*,int iCol); 631e397f8fSdrh int (*column_int)(sqlite3_stmt*,int iCol); 641e397f8fSdrh sqlite_int64 (*column_int64)(sqlite3_stmt*,int iCol); 651e397f8fSdrh const char * (*column_name)(sqlite3_stmt*,int); 661e397f8fSdrh const void * (*column_name16)(sqlite3_stmt*,int); 671e397f8fSdrh const char * (*column_origin_name)(sqlite3_stmt*,int); 681e397f8fSdrh const void * (*column_origin_name16)(sqlite3_stmt*,int); 691e397f8fSdrh const char * (*column_table_name)(sqlite3_stmt*,int); 701e397f8fSdrh const void * (*column_table_name16)(sqlite3_stmt*,int); 711e397f8fSdrh const unsigned char * (*column_text)(sqlite3_stmt*,int iCol); 721e397f8fSdrh const void * (*column_text16)(sqlite3_stmt*,int iCol); 731e397f8fSdrh int (*column_type)(sqlite3_stmt*,int iCol); 74d6e8dd00Sdanielk1977 sqlite3_value* (*column_value)(sqlite3_stmt*,int iCol); 751e397f8fSdrh void * (*commit_hook)(sqlite3*,int(*)(void*),void*); 761e397f8fSdrh int (*complete)(const char*sql); 771e397f8fSdrh int (*complete16)(const void*sql); 780d1ee483Sdrh int (*create_collation)(sqlite3*,const char*,int,void*, 790d1ee483Sdrh int(*)(void*,int,const void*,int,const void*)); 800d1ee483Sdrh int (*create_collation16)(sqlite3*,const void*,int,void*, 810d1ee483Sdrh int(*)(void*,int,const void*,int,const void*)); 820d1ee483Sdrh int (*create_function)(sqlite3*,const char*,int,int,void*, 830d1ee483Sdrh void (*xFunc)(sqlite3_context*,int,sqlite3_value**), 840d1ee483Sdrh void (*xStep)(sqlite3_context*,int,sqlite3_value**), 850d1ee483Sdrh void (*xFinal)(sqlite3_context*)); 860d1ee483Sdrh int (*create_function16)(sqlite3*,const void*,int,int,void*, 870d1ee483Sdrh void (*xFunc)(sqlite3_context*,int,sqlite3_value**), 880d1ee483Sdrh void (*xStep)(sqlite3_context*,int,sqlite3_value**), 890d1ee483Sdrh void (*xFinal)(sqlite3_context*)); 909c41938fSdrh int (*create_module)(sqlite3*,const char*,const sqlite3_module*,void*); 911e397f8fSdrh int (*data_count)(sqlite3_stmt*pStmt); 921e397f8fSdrh sqlite3 * (*db_handle)(sqlite3_stmt*); 93d6e8dd00Sdanielk1977 int (*declare_vtab)(sqlite3*,const char*); 941e397f8fSdrh int (*enable_shared_cache)(int); 951e397f8fSdrh int (*errcode)(sqlite3*db); 961e397f8fSdrh const char * (*errmsg)(sqlite3*); 971e397f8fSdrh const void * (*errmsg16)(sqlite3*); 981e397f8fSdrh int (*exec)(sqlite3*,const char*,sqlite3_callback,void*,char**); 991e397f8fSdrh int (*expired)(sqlite3_stmt*); 1001e397f8fSdrh int (*finalize)(sqlite3_stmt*pStmt); 101c1be6324Sdrh void (*free)(void*); 1021e397f8fSdrh void (*free_table)(char**result); 1031e397f8fSdrh int (*get_autocommit)(sqlite3*); 1041e397f8fSdrh void * (*get_auxdata)(sqlite3_context*,int); 1051e397f8fSdrh int (*get_table)(sqlite3*,const char*,char***,int*,int*,char**); 1061e397f8fSdrh int (*global_recover)(void); 1076be36cb6Sdrh void (*interruptx)(sqlite3*); 1081e397f8fSdrh sqlite_int64 (*last_insert_rowid)(sqlite3*); 1091e397f8fSdrh const char * (*libversion)(void); 1101e397f8fSdrh int (*libversion_number)(void); 111f3a65f7eSdrh void *(*malloc)(int); 1121e397f8fSdrh char * (*mprintf)(const char*,...); 1131e397f8fSdrh int (*open)(const char*,sqlite3**); 1141e397f8fSdrh int (*open16)(const void*,sqlite3**); 1151e397f8fSdrh int (*prepare)(sqlite3*,const char*,int,sqlite3_stmt**,const char**); 1161e397f8fSdrh int (*prepare16)(sqlite3*,const void*,int,sqlite3_stmt**,const void**); 1171e397f8fSdrh void * (*profile)(sqlite3*,void(*)(void*,const char*,sqlite_uint64),void*); 1181e397f8fSdrh void (*progress_handler)(sqlite3*,int,int(*)(void*),void*); 119f3a65f7eSdrh void *(*realloc)(void*,int); 1201e397f8fSdrh int (*reset)(sqlite3_stmt*pStmt); 1211e397f8fSdrh void (*result_blob)(sqlite3_context*,const void*,int,void(*)(void*)); 1221e397f8fSdrh void (*result_double)(sqlite3_context*,double); 1231e397f8fSdrh void (*result_error)(sqlite3_context*,const char*,int); 1241e397f8fSdrh void (*result_error16)(sqlite3_context*,const void*,int); 1251e397f8fSdrh void (*result_int)(sqlite3_context*,int); 1261e397f8fSdrh void (*result_int64)(sqlite3_context*,sqlite_int64); 1271e397f8fSdrh void (*result_null)(sqlite3_context*); 1281e397f8fSdrh void (*result_text)(sqlite3_context*,const char*,int,void(*)(void*)); 1291e397f8fSdrh void (*result_text16)(sqlite3_context*,const void*,int,void(*)(void*)); 1301e397f8fSdrh void (*result_text16be)(sqlite3_context*,const void*,int,void(*)(void*)); 1311e397f8fSdrh void (*result_text16le)(sqlite3_context*,const void*,int,void(*)(void*)); 1321e397f8fSdrh void (*result_value)(sqlite3_context*,sqlite3_value*); 1331e397f8fSdrh void * (*rollback_hook)(sqlite3*,void(*)(void*),void*); 1340d1ee483Sdrh int (*set_authorizer)(sqlite3*,int(*)(void*,int,const char*,const char*, 1350d1ee483Sdrh const char*,const char*),void*); 1361e397f8fSdrh void (*set_auxdata)(sqlite3_context*,int,void*,void (*)(void*)); 1371e397f8fSdrh char * (*snprintf)(int,char*,const char*,...); 1381e397f8fSdrh int (*step)(sqlite3_stmt*); 1390d1ee483Sdrh int (*table_column_metadata)(sqlite3*,const char*,const char*,const char*, 1400d1ee483Sdrh char const**,char const**,int*,int*,int*); 1411e397f8fSdrh void (*thread_cleanup)(void); 1421e397f8fSdrh int (*total_changes)(sqlite3*); 1431e397f8fSdrh void * (*trace)(sqlite3*,void(*xTrace)(void*,const char*),void*); 1441e397f8fSdrh int (*transfer_bindings)(sqlite3_stmt*,sqlite3_stmt*); 1450d1ee483Sdrh void * (*update_hook)(sqlite3*,void(*)(void*,int ,char const*,char const*, 1460d1ee483Sdrh sqlite_int64),void*); 1471e397f8fSdrh void * (*user_data)(sqlite3_context*); 1481e397f8fSdrh const void * (*value_blob)(sqlite3_value*); 1491e397f8fSdrh int (*value_bytes)(sqlite3_value*); 1501e397f8fSdrh int (*value_bytes16)(sqlite3_value*); 1511e397f8fSdrh double (*value_double)(sqlite3_value*); 1521e397f8fSdrh int (*value_int)(sqlite3_value*); 1531e397f8fSdrh sqlite_int64 (*value_int64)(sqlite3_value*); 1541e397f8fSdrh int (*value_numeric_type)(sqlite3_value*); 1551e397f8fSdrh const unsigned char * (*value_text)(sqlite3_value*); 1561e397f8fSdrh const void * (*value_text16)(sqlite3_value*); 1571e397f8fSdrh const void * (*value_text16be)(sqlite3_value*); 1581e397f8fSdrh const void * (*value_text16le)(sqlite3_value*); 1591e397f8fSdrh int (*value_type)(sqlite3_value*); 1601e397f8fSdrh char *(*vmprintf)(const char*,va_list); 161428e2826Sdrh /* Added ??? */ 1627409310aSshess int (*overload_function)(sqlite3*, const char *zFuncName, int nArg); 163428e2826Sdrh /* Added by 3.3.13 */ 1646d54da05Sdrh int (*prepare_v2)(sqlite3*,const char*,int,sqlite3_stmt**,const char**); 1656d54da05Sdrh int (*prepare16_v2)(sqlite3*,const void*,int,sqlite3_stmt**,const void**); 166a92993caSdrh int (*clear_bindings)(sqlite3_stmt*); 167428e2826Sdrh /* Added by 3.4.1 */ 1680d1ee483Sdrh int (*create_module_v2)(sqlite3*,const char*,const sqlite3_module*,void*, 1690d1ee483Sdrh void (*xDestroy)(void *)); 170428e2826Sdrh /* Added by 3.5.0 */ 171428e2826Sdrh int (*bind_zeroblob)(sqlite3_stmt*,int,int); 172428e2826Sdrh int (*blob_bytes)(sqlite3_blob*); 173428e2826Sdrh int (*blob_close)(sqlite3_blob*); 1740d1ee483Sdrh int (*blob_open)(sqlite3*,const char*,const char*,const char*,sqlite3_int64, 1750d1ee483Sdrh int,sqlite3_blob**); 176428e2826Sdrh int (*blob_read)(sqlite3_blob*,void*,int,int); 177428e2826Sdrh int (*blob_write)(sqlite3_blob*,const void*,int,int); 1780d1ee483Sdrh int (*create_collation_v2)(sqlite3*,const char*,int,void*, 1790d1ee483Sdrh int(*)(void*,int,const void*,int,const void*), 1800d1ee483Sdrh void(*)(void*)); 181cc6bb3eaSdrh int (*file_control)(sqlite3*,const char*,int,void*); 182428e2826Sdrh sqlite3_int64 (*memory_highwater)(int); 183428e2826Sdrh sqlite3_int64 (*memory_used)(void); 18461f6dc60Sdrh sqlite3_mutex *(*mutex_alloc)(int); 18561f6dc60Sdrh void (*mutex_enter)(sqlite3_mutex*); 18661f6dc60Sdrh void (*mutex_free)(sqlite3_mutex*); 18761f6dc60Sdrh void (*mutex_leave)(sqlite3_mutex*); 18861f6dc60Sdrh int (*mutex_try)(sqlite3_mutex*); 189428e2826Sdrh int (*open_v2)(const char*,sqlite3**,int,const char*); 190428e2826Sdrh int (*release_memory)(int); 191428e2826Sdrh void (*result_error_nomem)(sqlite3_context*); 192428e2826Sdrh void (*result_error_toobig)(sqlite3_context*); 193428e2826Sdrh int (*sleep)(int); 194428e2826Sdrh void (*soft_heap_limit)(int); 195428e2826Sdrh sqlite3_vfs *(*vfs_find)(const char*); 196428e2826Sdrh int (*vfs_register)(sqlite3_vfs*,int); 197428e2826Sdrh int (*vfs_unregister)(sqlite3_vfs*); 198e5dd20a6Sdrh int (*xthreadsafe)(void); 199e5dd20a6Sdrh void (*result_zeroblob)(sqlite3_context*,int); 200e5dd20a6Sdrh void (*result_error_code)(sqlite3_context*,int); 201e5dd20a6Sdrh int (*test_control)(int, ...); 2022fa1868fSdrh void (*randomness)(int,void*); 203fa4a4b91Sdrh sqlite3 *(*context_db_handle)(sqlite3_context*); 2048b6abedbSdrh int (*extended_result_codes)(sqlite3*,int); 2058b6abedbSdrh int (*limit)(sqlite3*,int,int); 2068b6abedbSdrh sqlite3_stmt *(*next_stmt)(sqlite3*,sqlite3_stmt*); 2078b6abedbSdrh const char *(*sql)(sqlite3_stmt*); 2088b6abedbSdrh int (*status)(int,int*,int*,int); 209fd7ebbf6Sdrh int (*backup_finish)(sqlite3_backup*); 210fd7ebbf6Sdrh sqlite3_backup *(*backup_init)(sqlite3*,const char*,sqlite3*,const char*); 211fd7ebbf6Sdrh int (*backup_pagecount)(sqlite3_backup*); 212fd7ebbf6Sdrh int (*backup_remaining)(sqlite3_backup*); 213fd7ebbf6Sdrh int (*backup_step)(sqlite3_backup*,int); 214fd7ebbf6Sdrh const char *(*compileoption_get)(int); 215fd7ebbf6Sdrh int (*compileoption_used)(const char*); 2160d1ee483Sdrh int (*create_function_v2)(sqlite3*,const char*,int,int,void*, 2170d1ee483Sdrh void (*xFunc)(sqlite3_context*,int,sqlite3_value**), 2180d1ee483Sdrh void (*xStep)(sqlite3_context*,int,sqlite3_value**), 2190d1ee483Sdrh void (*xFinal)(sqlite3_context*), 2200d1ee483Sdrh void(*xDestroy)(void*)); 221fd7ebbf6Sdrh int (*db_config)(sqlite3*,int,...); 222fd7ebbf6Sdrh sqlite3_mutex *(*db_mutex)(sqlite3*); 223fd7ebbf6Sdrh int (*db_status)(sqlite3*,int,int*,int*,int); 224fd7ebbf6Sdrh int (*extended_errcode)(sqlite3*); 225fd7ebbf6Sdrh void (*log)(int,const char*,...); 226fd7ebbf6Sdrh sqlite3_int64 (*soft_heap_limit64)(sqlite3_int64); 227fd7ebbf6Sdrh const char *(*sourceid)(void); 228fd7ebbf6Sdrh int (*stmt_status)(sqlite3_stmt*,int,int); 229fd7ebbf6Sdrh int (*strnicmp)(const char*,const char*,int); 230fd7ebbf6Sdrh int (*unlock_notify)(sqlite3*,void(*)(void**,int),void*); 231fd7ebbf6Sdrh int (*wal_autocheckpoint)(sqlite3*,int); 232fd7ebbf6Sdrh int (*wal_checkpoint)(sqlite3*,const char*); 233fd7ebbf6Sdrh void *(*wal_hook)(sqlite3*,int(*)(void*,sqlite3*,const char*,int),void*); 2340ea2517cSdan int (*blob_reopen)(sqlite3_blob*,sqlite3_int64); 2350ea2517cSdan int (*vtab_config)(sqlite3*,int op,...); 2360ea2517cSdan int (*vtab_on_conflict)(sqlite3*); 2374207a3fbSdrh /* Version 3.7.16 and later */ 2384207a3fbSdrh int (*close_v2)(sqlite3*); 2394207a3fbSdrh const char *(*db_filename)(sqlite3*,const char*); 2404207a3fbSdrh int (*db_readonly)(sqlite3*,const char*); 2414207a3fbSdrh int (*db_release_memory)(sqlite3*); 2424207a3fbSdrh const char *(*errstr)(int); 2434207a3fbSdrh int (*stmt_busy)(sqlite3_stmt*); 2444207a3fbSdrh int (*stmt_readonly)(sqlite3_stmt*); 2454207a3fbSdrh int (*stricmp)(const char*,const char*); 2464207a3fbSdrh int (*uri_boolean)(const char*,const char*,int); 2474207a3fbSdrh sqlite3_int64 (*uri_int64)(const char*,const char*,sqlite3_int64); 2484207a3fbSdrh const char *(*uri_parameter)(const char*,const char*); 249*ca03bdafSdrh char *(*xvsnprintf)(int,char*,const char*,va_list); 2504207a3fbSdrh int (*wal_checkpoint_v2)(sqlite3*,const char*,int,int*,int*); 2510807cc2cSdrh /* Version 3.8.7 and later */ 25232c83c8bSdrh int (*auto_extension)(void(*)(void)); 2530807cc2cSdrh int (*bind_blob64)(sqlite3_stmt*,int,const void*,sqlite3_uint64, 2540807cc2cSdrh void(*)(void*)); 255bbf483f8Sdrh int (*bind_text64)(sqlite3_stmt*,int,const char*,sqlite3_uint64, 2560807cc2cSdrh void(*)(void*),unsigned char); 25732c83c8bSdrh int (*cancel_auto_extension)(void(*)(void)); 2580807cc2cSdrh int (*load_extension)(sqlite3*,const char*,const char*,char**); 2590807cc2cSdrh void *(*malloc64)(sqlite3_uint64); 2600807cc2cSdrh sqlite3_uint64 (*msize)(void*); 2610807cc2cSdrh void *(*realloc64)(void*,sqlite3_uint64); 2620807cc2cSdrh void (*reset_auto_extension)(void); 2630807cc2cSdrh void (*result_blob64)(sqlite3_context*,const void*,sqlite3_uint64, 2640807cc2cSdrh void(*)(void*)); 265bbf483f8Sdrh void (*result_text64)(sqlite3_context*,const char*,sqlite3_uint64, 2660807cc2cSdrh void(*)(void*), unsigned char); 2670807cc2cSdrh int (*strglob)(const char*,const char*); 268f5ed7ad6Sdrh /* Version 3.8.11 and later */ 269f5ed7ad6Sdrh sqlite3_value *(*value_dup)(const sqlite3_value*); 2704f03f413Sdrh void (*value_free)(sqlite3_value*); 271a4d5ae8fSdan int (*result_zeroblob64)(sqlite3_context*,sqlite3_uint64); 27280c03022Sdan int (*bind_zeroblob64)(sqlite3_stmt*, int, sqlite3_uint64); 27358a8a923Sdrh /* Version 3.9.0 and later */ 274cf94f179Sdrh unsigned int (*value_subtype)(sqlite3_value*); 275cf94f179Sdrh void (*result_subtype)(sqlite3_context*,unsigned int); 2768b4a94adSdrh /* Version 3.10.0 and later */ 2777be53fe4Sdrh int (*status64)(int,sqlite3_int64*,sqlite3_int64*,int); 2788b4a94adSdrh int (*strlike)(const char*,const char*,unsigned int); 2797be53fe4Sdrh int (*db_cacheflush)(sqlite3*); 2801b9f2141Sdrh /* Version 3.12.0 and later */ 2811b9f2141Sdrh int (*system_errno)(sqlite3*); 2823d2a529dSdrh /* Version 3.14.0 and later */ 283c0e2203aSdrh int (*trace_v2)(sqlite3*,unsigned,int(*)(unsigned,void*,void*,void*),void*); 284fca760c8Sdrh char *(*expanded_sql)(sqlite3_stmt*); 2850d8d9c9eSdrh /* Version 3.18.0 and later */ 2860d8d9c9eSdrh void (*set_last_insert_rowid)(sqlite3*,sqlite3_int64); 287db3e0456Sdrh /* Version 3.20.0 and later */ 288db3e0456Sdrh int (*prepare_v3)(sqlite3*,const char*,int,unsigned int, 289db3e0456Sdrh sqlite3_stmt**,const char**); 290db3e0456Sdrh int (*prepare16_v3)(sqlite3*,const void*,int,unsigned int, 291db3e0456Sdrh sqlite3_stmt**,const void**); 29222930062Sdrh int (*bind_pointer)(sqlite3_stmt*,int,void*,const char*,void(*)(void*)); 29322930062Sdrh void (*result_pointer)(sqlite3_context*,void*,const char*,void(*)(void*)); 294ae3ec3f9Sdrh void *(*value_pointer)(sqlite3_value*,const char*); 2951e397f8fSdrh }; 2961e397f8fSdrh 2971e397f8fSdrh /* 29844e95d4fSmistachkin ** This is the function signature used for all extension entry points. It 29944e95d4fSmistachkin ** is also defined in the file "loadext.c". 30044e95d4fSmistachkin */ 30144e95d4fSmistachkin typedef int (*sqlite3_loadext_entry)( 30244e95d4fSmistachkin sqlite3 *db, /* Handle to the database. */ 30344e95d4fSmistachkin char **pzErrMsg, /* Used to set error string on failure. */ 30444e95d4fSmistachkin const sqlite3_api_routines *pThunk /* Extension API function pointers. */ 30544e95d4fSmistachkin ); 30644e95d4fSmistachkin 30744e95d4fSmistachkin /* 3081e397f8fSdrh ** The following macros redefine the API routines so that they are 30960ec914cSpeter.d.reid ** redirected through the global sqlite3_api structure. 3101e397f8fSdrh ** 3111e397f8fSdrh ** This header file is also used by the loadext.c source file 3121e397f8fSdrh ** (part of the main SQLite library - not an extension) so that 3131e397f8fSdrh ** it can get access to the sqlite3_api_routines structure 3141e397f8fSdrh ** definition. But the main library does not want to redefine 3151e397f8fSdrh ** the API. So the redefinition macros are only valid if the 3161e397f8fSdrh ** SQLITE_CORE macros is undefined. 3171e397f8fSdrh */ 3180c275088Sdrh #if !defined(SQLITE_CORE) && !defined(SQLITE_OMIT_LOAD_EXTENSION) 3191e397f8fSdrh #define sqlite3_aggregate_context sqlite3_api->aggregate_context 320eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED 3211e397f8fSdrh #define sqlite3_aggregate_count sqlite3_api->aggregate_count 322eec556d3Sshane #endif 3231e397f8fSdrh #define sqlite3_bind_blob sqlite3_api->bind_blob 3241e397f8fSdrh #define sqlite3_bind_double sqlite3_api->bind_double 3251e397f8fSdrh #define sqlite3_bind_int sqlite3_api->bind_int 3261e397f8fSdrh #define sqlite3_bind_int64 sqlite3_api->bind_int64 3271e397f8fSdrh #define sqlite3_bind_null sqlite3_api->bind_null 3281e397f8fSdrh #define sqlite3_bind_parameter_count sqlite3_api->bind_parameter_count 3291e397f8fSdrh #define sqlite3_bind_parameter_index sqlite3_api->bind_parameter_index 3301e397f8fSdrh #define sqlite3_bind_parameter_name sqlite3_api->bind_parameter_name 3311e397f8fSdrh #define sqlite3_bind_text sqlite3_api->bind_text 3321e397f8fSdrh #define sqlite3_bind_text16 sqlite3_api->bind_text16 333c1be6324Sdrh #define sqlite3_bind_value sqlite3_api->bind_value 3341e397f8fSdrh #define sqlite3_busy_handler sqlite3_api->busy_handler 3351e397f8fSdrh #define sqlite3_busy_timeout sqlite3_api->busy_timeout 3361e397f8fSdrh #define sqlite3_changes sqlite3_api->changes 3371e397f8fSdrh #define sqlite3_close sqlite3_api->close 3381e397f8fSdrh #define sqlite3_collation_needed sqlite3_api->collation_needed 3391e397f8fSdrh #define sqlite3_collation_needed16 sqlite3_api->collation_needed16 3401e397f8fSdrh #define sqlite3_column_blob sqlite3_api->column_blob 3411e397f8fSdrh #define sqlite3_column_bytes sqlite3_api->column_bytes 3421e397f8fSdrh #define sqlite3_column_bytes16 sqlite3_api->column_bytes16 3431e397f8fSdrh #define sqlite3_column_count sqlite3_api->column_count 3441e397f8fSdrh #define sqlite3_column_database_name sqlite3_api->column_database_name 3451e397f8fSdrh #define sqlite3_column_database_name16 sqlite3_api->column_database_name16 3461e397f8fSdrh #define sqlite3_column_decltype sqlite3_api->column_decltype 3471e397f8fSdrh #define sqlite3_column_decltype16 sqlite3_api->column_decltype16 3481e397f8fSdrh #define sqlite3_column_double sqlite3_api->column_double 3491e397f8fSdrh #define sqlite3_column_int sqlite3_api->column_int 3501e397f8fSdrh #define sqlite3_column_int64 sqlite3_api->column_int64 3511e397f8fSdrh #define sqlite3_column_name sqlite3_api->column_name 3521e397f8fSdrh #define sqlite3_column_name16 sqlite3_api->column_name16 3531e397f8fSdrh #define sqlite3_column_origin_name sqlite3_api->column_origin_name 3541e397f8fSdrh #define sqlite3_column_origin_name16 sqlite3_api->column_origin_name16 3551e397f8fSdrh #define sqlite3_column_table_name sqlite3_api->column_table_name 3561e397f8fSdrh #define sqlite3_column_table_name16 sqlite3_api->column_table_name16 3571e397f8fSdrh #define sqlite3_column_text sqlite3_api->column_text 3581e397f8fSdrh #define sqlite3_column_text16 sqlite3_api->column_text16 3591e397f8fSdrh #define sqlite3_column_type sqlite3_api->column_type 360d6e8dd00Sdanielk1977 #define sqlite3_column_value sqlite3_api->column_value 3611e397f8fSdrh #define sqlite3_commit_hook sqlite3_api->commit_hook 3621e397f8fSdrh #define sqlite3_complete sqlite3_api->complete 3631e397f8fSdrh #define sqlite3_complete16 sqlite3_api->complete16 3641e397f8fSdrh #define sqlite3_create_collation sqlite3_api->create_collation 3651e397f8fSdrh #define sqlite3_create_collation16 sqlite3_api->create_collation16 3661e397f8fSdrh #define sqlite3_create_function sqlite3_api->create_function 3671e397f8fSdrh #define sqlite3_create_function16 sqlite3_api->create_function16 368d6e8dd00Sdanielk1977 #define sqlite3_create_module sqlite3_api->create_module 369832a58a6Sdanielk1977 #define sqlite3_create_module_v2 sqlite3_api->create_module_v2 3701e397f8fSdrh #define sqlite3_data_count sqlite3_api->data_count 3711e397f8fSdrh #define sqlite3_db_handle sqlite3_api->db_handle 372d6e8dd00Sdanielk1977 #define sqlite3_declare_vtab sqlite3_api->declare_vtab 3731e397f8fSdrh #define sqlite3_enable_shared_cache sqlite3_api->enable_shared_cache 3741e397f8fSdrh #define sqlite3_errcode sqlite3_api->errcode 3751e397f8fSdrh #define sqlite3_errmsg sqlite3_api->errmsg 3761e397f8fSdrh #define sqlite3_errmsg16 sqlite3_api->errmsg16 3771e397f8fSdrh #define sqlite3_exec sqlite3_api->exec 378eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED 3791e397f8fSdrh #define sqlite3_expired sqlite3_api->expired 380eec556d3Sshane #endif 3811e397f8fSdrh #define sqlite3_finalize sqlite3_api->finalize 3821e397f8fSdrh #define sqlite3_free sqlite3_api->free 3831e397f8fSdrh #define sqlite3_free_table sqlite3_api->free_table 3841e397f8fSdrh #define sqlite3_get_autocommit sqlite3_api->get_autocommit 3851e397f8fSdrh #define sqlite3_get_auxdata sqlite3_api->get_auxdata 3861e397f8fSdrh #define sqlite3_get_table sqlite3_api->get_table 387eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED 3881e397f8fSdrh #define sqlite3_global_recover sqlite3_api->global_recover 389eec556d3Sshane #endif 3906be36cb6Sdrh #define sqlite3_interrupt sqlite3_api->interruptx 3911e397f8fSdrh #define sqlite3_last_insert_rowid sqlite3_api->last_insert_rowid 3921e397f8fSdrh #define sqlite3_libversion sqlite3_api->libversion 3931e397f8fSdrh #define sqlite3_libversion_number sqlite3_api->libversion_number 39428dd479cSdrh #define sqlite3_malloc sqlite3_api->malloc 3951e397f8fSdrh #define sqlite3_mprintf sqlite3_api->mprintf 3961e397f8fSdrh #define sqlite3_open sqlite3_api->open 3971e397f8fSdrh #define sqlite3_open16 sqlite3_api->open16 3981e397f8fSdrh #define sqlite3_prepare sqlite3_api->prepare 3991e397f8fSdrh #define sqlite3_prepare16 sqlite3_api->prepare16 4006d54da05Sdrh #define sqlite3_prepare_v2 sqlite3_api->prepare_v2 4016d54da05Sdrh #define sqlite3_prepare16_v2 sqlite3_api->prepare16_v2 4021e397f8fSdrh #define sqlite3_profile sqlite3_api->profile 4031e397f8fSdrh #define sqlite3_progress_handler sqlite3_api->progress_handler 40428dd479cSdrh #define sqlite3_realloc sqlite3_api->realloc 4051e397f8fSdrh #define sqlite3_reset sqlite3_api->reset 4061e397f8fSdrh #define sqlite3_result_blob sqlite3_api->result_blob 4071e397f8fSdrh #define sqlite3_result_double sqlite3_api->result_double 4081e397f8fSdrh #define sqlite3_result_error sqlite3_api->result_error 4091e397f8fSdrh #define sqlite3_result_error16 sqlite3_api->result_error16 4101e397f8fSdrh #define sqlite3_result_int sqlite3_api->result_int 4111e397f8fSdrh #define sqlite3_result_int64 sqlite3_api->result_int64 4121e397f8fSdrh #define sqlite3_result_null sqlite3_api->result_null 4131e397f8fSdrh #define sqlite3_result_text sqlite3_api->result_text 4141e397f8fSdrh #define sqlite3_result_text16 sqlite3_api->result_text16 4151e397f8fSdrh #define sqlite3_result_text16be sqlite3_api->result_text16be 4161e397f8fSdrh #define sqlite3_result_text16le sqlite3_api->result_text16le 4171e397f8fSdrh #define sqlite3_result_value sqlite3_api->result_value 4181e397f8fSdrh #define sqlite3_rollback_hook sqlite3_api->rollback_hook 4191e397f8fSdrh #define sqlite3_set_authorizer sqlite3_api->set_authorizer 4201e397f8fSdrh #define sqlite3_set_auxdata sqlite3_api->set_auxdata 4211e397f8fSdrh #define sqlite3_snprintf sqlite3_api->snprintf 4221e397f8fSdrh #define sqlite3_step sqlite3_api->step 4231e397f8fSdrh #define sqlite3_table_column_metadata sqlite3_api->table_column_metadata 4241e397f8fSdrh #define sqlite3_thread_cleanup sqlite3_api->thread_cleanup 4251e397f8fSdrh #define sqlite3_total_changes sqlite3_api->total_changes 4261e397f8fSdrh #define sqlite3_trace sqlite3_api->trace 427eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED 4281e397f8fSdrh #define sqlite3_transfer_bindings sqlite3_api->transfer_bindings 429eec556d3Sshane #endif 4301e397f8fSdrh #define sqlite3_update_hook sqlite3_api->update_hook 4311e397f8fSdrh #define sqlite3_user_data sqlite3_api->user_data 4321e397f8fSdrh #define sqlite3_value_blob sqlite3_api->value_blob 4331e397f8fSdrh #define sqlite3_value_bytes sqlite3_api->value_bytes 4341e397f8fSdrh #define sqlite3_value_bytes16 sqlite3_api->value_bytes16 4351e397f8fSdrh #define sqlite3_value_double sqlite3_api->value_double 4361e397f8fSdrh #define sqlite3_value_int sqlite3_api->value_int 4371e397f8fSdrh #define sqlite3_value_int64 sqlite3_api->value_int64 4381e397f8fSdrh #define sqlite3_value_numeric_type sqlite3_api->value_numeric_type 4391e397f8fSdrh #define sqlite3_value_text sqlite3_api->value_text 4401e397f8fSdrh #define sqlite3_value_text16 sqlite3_api->value_text16 4411e397f8fSdrh #define sqlite3_value_text16be sqlite3_api->value_text16be 4421e397f8fSdrh #define sqlite3_value_text16le sqlite3_api->value_text16le 4431e397f8fSdrh #define sqlite3_value_type sqlite3_api->value_type 4441e397f8fSdrh #define sqlite3_vmprintf sqlite3_api->vmprintf 445*ca03bdafSdrh #define sqlite3_vsnprintf sqlite3_api->xvsnprintf 4467409310aSshess #define sqlite3_overload_function sqlite3_api->overload_function 447a92993caSdrh #define sqlite3_prepare_v2 sqlite3_api->prepare_v2 448a92993caSdrh #define sqlite3_prepare16_v2 sqlite3_api->prepare16_v2 449a92993caSdrh #define sqlite3_clear_bindings sqlite3_api->clear_bindings 450428e2826Sdrh #define sqlite3_bind_zeroblob sqlite3_api->bind_zeroblob 451428e2826Sdrh #define sqlite3_blob_bytes sqlite3_api->blob_bytes 452428e2826Sdrh #define sqlite3_blob_close sqlite3_api->blob_close 453428e2826Sdrh #define sqlite3_blob_open sqlite3_api->blob_open 454428e2826Sdrh #define sqlite3_blob_read sqlite3_api->blob_read 455428e2826Sdrh #define sqlite3_blob_write sqlite3_api->blob_write 456428e2826Sdrh #define sqlite3_create_collation_v2 sqlite3_api->create_collation_v2 457cc6bb3eaSdrh #define sqlite3_file_control sqlite3_api->file_control 458428e2826Sdrh #define sqlite3_memory_highwater sqlite3_api->memory_highwater 459428e2826Sdrh #define sqlite3_memory_used sqlite3_api->memory_used 46061f6dc60Sdrh #define sqlite3_mutex_alloc sqlite3_api->mutex_alloc 46161f6dc60Sdrh #define sqlite3_mutex_enter sqlite3_api->mutex_enter 46261f6dc60Sdrh #define sqlite3_mutex_free sqlite3_api->mutex_free 46361f6dc60Sdrh #define sqlite3_mutex_leave sqlite3_api->mutex_leave 46461f6dc60Sdrh #define sqlite3_mutex_try sqlite3_api->mutex_try 465428e2826Sdrh #define sqlite3_open_v2 sqlite3_api->open_v2 466428e2826Sdrh #define sqlite3_release_memory sqlite3_api->release_memory 467428e2826Sdrh #define sqlite3_result_error_nomem sqlite3_api->result_error_nomem 468428e2826Sdrh #define sqlite3_result_error_toobig sqlite3_api->result_error_toobig 469428e2826Sdrh #define sqlite3_sleep sqlite3_api->sleep 470428e2826Sdrh #define sqlite3_soft_heap_limit sqlite3_api->soft_heap_limit 471428e2826Sdrh #define sqlite3_vfs_find sqlite3_api->vfs_find 472428e2826Sdrh #define sqlite3_vfs_register sqlite3_api->vfs_register 473428e2826Sdrh #define sqlite3_vfs_unregister sqlite3_api->vfs_unregister 474e5dd20a6Sdrh #define sqlite3_threadsafe sqlite3_api->xthreadsafe 475e5dd20a6Sdrh #define sqlite3_result_zeroblob sqlite3_api->result_zeroblob 476e5dd20a6Sdrh #define sqlite3_result_error_code sqlite3_api->result_error_code 477e5dd20a6Sdrh #define sqlite3_test_control sqlite3_api->test_control 4782fa1868fSdrh #define sqlite3_randomness sqlite3_api->randomness 479fa4a4b91Sdrh #define sqlite3_context_db_handle sqlite3_api->context_db_handle 4808b6abedbSdrh #define sqlite3_extended_result_codes sqlite3_api->extended_result_codes 4818b6abedbSdrh #define sqlite3_limit sqlite3_api->limit 4828b6abedbSdrh #define sqlite3_next_stmt sqlite3_api->next_stmt 4838b6abedbSdrh #define sqlite3_sql sqlite3_api->sql 4848b6abedbSdrh #define sqlite3_status sqlite3_api->status 485fd7ebbf6Sdrh #define sqlite3_backup_finish sqlite3_api->backup_finish 486fd7ebbf6Sdrh #define sqlite3_backup_init sqlite3_api->backup_init 487fd7ebbf6Sdrh #define sqlite3_backup_pagecount sqlite3_api->backup_pagecount 488fd7ebbf6Sdrh #define sqlite3_backup_remaining sqlite3_api->backup_remaining 489fd7ebbf6Sdrh #define sqlite3_backup_step sqlite3_api->backup_step 490fd7ebbf6Sdrh #define sqlite3_compileoption_get sqlite3_api->compileoption_get 491fd7ebbf6Sdrh #define sqlite3_compileoption_used sqlite3_api->compileoption_used 492fd7ebbf6Sdrh #define sqlite3_create_function_v2 sqlite3_api->create_function_v2 493fd7ebbf6Sdrh #define sqlite3_db_config sqlite3_api->db_config 494fd7ebbf6Sdrh #define sqlite3_db_mutex sqlite3_api->db_mutex 495fd7ebbf6Sdrh #define sqlite3_db_status sqlite3_api->db_status 496fd7ebbf6Sdrh #define sqlite3_extended_errcode sqlite3_api->extended_errcode 497fd7ebbf6Sdrh #define sqlite3_log sqlite3_api->log 498fd7ebbf6Sdrh #define sqlite3_soft_heap_limit64 sqlite3_api->soft_heap_limit64 499fd7ebbf6Sdrh #define sqlite3_sourceid sqlite3_api->sourceid 500fd7ebbf6Sdrh #define sqlite3_stmt_status sqlite3_api->stmt_status 501fd7ebbf6Sdrh #define sqlite3_strnicmp sqlite3_api->strnicmp 502fd7ebbf6Sdrh #define sqlite3_unlock_notify sqlite3_api->unlock_notify 503fd7ebbf6Sdrh #define sqlite3_wal_autocheckpoint sqlite3_api->wal_autocheckpoint 504fd7ebbf6Sdrh #define sqlite3_wal_checkpoint sqlite3_api->wal_checkpoint 505fd7ebbf6Sdrh #define sqlite3_wal_hook sqlite3_api->wal_hook 5060ea2517cSdan #define sqlite3_blob_reopen sqlite3_api->blob_reopen 5070ea2517cSdan #define sqlite3_vtab_config sqlite3_api->vtab_config 5080ea2517cSdan #define sqlite3_vtab_on_conflict sqlite3_api->vtab_on_conflict 5094207a3fbSdrh /* Version 3.7.16 and later */ 5104207a3fbSdrh #define sqlite3_close_v2 sqlite3_api->close_v2 5114207a3fbSdrh #define sqlite3_db_filename sqlite3_api->db_filename 5124207a3fbSdrh #define sqlite3_db_readonly sqlite3_api->db_readonly 5134207a3fbSdrh #define sqlite3_db_release_memory sqlite3_api->db_release_memory 5144207a3fbSdrh #define sqlite3_errstr sqlite3_api->errstr 5154207a3fbSdrh #define sqlite3_stmt_busy sqlite3_api->stmt_busy 5164207a3fbSdrh #define sqlite3_stmt_readonly sqlite3_api->stmt_readonly 5174207a3fbSdrh #define sqlite3_stricmp sqlite3_api->stricmp 5184207a3fbSdrh #define sqlite3_uri_boolean sqlite3_api->uri_boolean 5194207a3fbSdrh #define sqlite3_uri_int64 sqlite3_api->uri_int64 5204207a3fbSdrh #define sqlite3_uri_parameter sqlite3_api->uri_parameter 521*ca03bdafSdrh #define sqlite3_uri_vsnprintf sqlite3_api->xvsnprintf 5224207a3fbSdrh #define sqlite3_wal_checkpoint_v2 sqlite3_api->wal_checkpoint_v2 5230807cc2cSdrh /* Version 3.8.7 and later */ 5240807cc2cSdrh #define sqlite3_auto_extension sqlite3_api->auto_extension 5250807cc2cSdrh #define sqlite3_bind_blob64 sqlite3_api->bind_blob64 526bbf483f8Sdrh #define sqlite3_bind_text64 sqlite3_api->bind_text64 5270807cc2cSdrh #define sqlite3_cancel_auto_extension sqlite3_api->cancel_auto_extension 5280807cc2cSdrh #define sqlite3_load_extension sqlite3_api->load_extension 5290807cc2cSdrh #define sqlite3_malloc64 sqlite3_api->malloc64 5300807cc2cSdrh #define sqlite3_msize sqlite3_api->msize 5310807cc2cSdrh #define sqlite3_realloc64 sqlite3_api->realloc64 5320807cc2cSdrh #define sqlite3_reset_auto_extension sqlite3_api->reset_auto_extension 5330807cc2cSdrh #define sqlite3_result_blob64 sqlite3_api->result_blob64 534bbf483f8Sdrh #define sqlite3_result_text64 sqlite3_api->result_text64 5350807cc2cSdrh #define sqlite3_strglob sqlite3_api->strglob 5364f03f413Sdrh /* Version 3.8.11 and later */ 5374f03f413Sdrh #define sqlite3_value_dup sqlite3_api->value_dup 5384f03f413Sdrh #define sqlite3_value_free sqlite3_api->value_free 539a4d5ae8fSdan #define sqlite3_result_zeroblob64 sqlite3_api->result_zeroblob64 54080c03022Sdan #define sqlite3_bind_zeroblob64 sqlite3_api->bind_zeroblob64 54158a8a923Sdrh /* Version 3.9.0 and later */ 542cf94f179Sdrh #define sqlite3_value_subtype sqlite3_api->value_subtype 543cf94f179Sdrh #define sqlite3_result_subtype sqlite3_api->result_subtype 5448b4a94adSdrh /* Version 3.10.0 and later */ 5457be53fe4Sdrh #define sqlite3_status64 sqlite3_api->status64 5468b4a94adSdrh #define sqlite3_strlike sqlite3_api->strlike 5477be53fe4Sdrh #define sqlite3_db_cacheflush sqlite3_api->db_cacheflush 5481b9f2141Sdrh /* Version 3.12.0 and later */ 5491b9f2141Sdrh #define sqlite3_system_errno sqlite3_api->system_errno 5503d2a529dSdrh /* Version 3.14.0 and later */ 5513d2a529dSdrh #define sqlite3_trace_v2 sqlite3_api->trace_v2 552fca760c8Sdrh #define sqlite3_expanded_sql sqlite3_api->expanded_sql 5530d8d9c9eSdrh /* Version 3.18.0 and later */ 5540d8d9c9eSdrh #define sqlite3_set_last_insert_rowid sqlite3_api->set_last_insert_rowid 555db3e0456Sdrh /* Version 3.20.0 and later */ 556db3e0456Sdrh #define sqlite3_prepare_v3 sqlite3_api->prepare_v3 557db3e0456Sdrh #define sqlite3_prepare16_v3 sqlite3_api->prepare16_v3 5585587d86dSdrh #define sqlite3_bind_pointer sqlite3_api->bind_pointer 5595587d86dSdrh #define sqlite3_result_pointer sqlite3_api->result_pointer 5605587d86dSdrh #define sqlite3_value_pointer sqlite3_api->value_pointer 5610c275088Sdrh #endif /* !defined(SQLITE_CORE) && !defined(SQLITE_OMIT_LOAD_EXTENSION) */ 5621e397f8fSdrh 5630c275088Sdrh #if !defined(SQLITE_CORE) && !defined(SQLITE_OMIT_LOAD_EXTENSION) 56408ef8d73Sdrh /* This case when the file really is being compiled as a loadable 56508ef8d73Sdrh ** extension */ 56663703a42Sdanielk1977 # define SQLITE_EXTENSION_INIT1 const sqlite3_api_routines *sqlite3_api=0; 5671e397f8fSdrh # define SQLITE_EXTENSION_INIT2(v) sqlite3_api=v; 568049d487eSmistachkin # define SQLITE_EXTENSION_INIT3 \ 569049d487eSmistachkin extern const sqlite3_api_routines *sqlite3_api; 57008ef8d73Sdrh #else 57108ef8d73Sdrh /* This case when the file is being statically linked into the 57208ef8d73Sdrh ** application */ 57308ef8d73Sdrh # define SQLITE_EXTENSION_INIT1 /*no-op*/ 57408ef8d73Sdrh # define SQLITE_EXTENSION_INIT2(v) (void)v; /* unused parameter */ 575049d487eSmistachkin # define SQLITE_EXTENSION_INIT3 /*no-op*/ 57608ef8d73Sdrh #endif 5771e397f8fSdrh 57843f58d6aSdrh #endif /* SQLITE3EXT_H */ 579