xref: /sqlite-3.40.0/src/sqlite3ext.h (revision fca760c8)
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 typedef struct sqlite3_api_routines sqlite3_api_routines;
231e397f8fSdrh 
241e397f8fSdrh /*
25d885c7beSmlcreech ** The following structure holds pointers to all of the SQLite API
261e397f8fSdrh ** routines.
27d8a2b384Sdrh **
28d8a2b384Sdrh ** WARNING:  In order to maintain backwards compatibility, add new
29d8a2b384Sdrh ** interfaces to the end of this structure only.  If you insert new
30d8a2b384Sdrh ** interfaces in the middle of this structure, then older different
3160ec914cSpeter.d.reid ** versions of SQLite will not be able to load each other's shared
32d8a2b384Sdrh ** libraries!
331e397f8fSdrh */
341e397f8fSdrh struct sqlite3_api_routines {
351e397f8fSdrh   void * (*aggregate_context)(sqlite3_context*,int nBytes);
361e397f8fSdrh   int  (*aggregate_count)(sqlite3_context*);
371e397f8fSdrh   int  (*bind_blob)(sqlite3_stmt*,int,const void*,int n,void(*)(void*));
381e397f8fSdrh   int  (*bind_double)(sqlite3_stmt*,int,double);
391e397f8fSdrh   int  (*bind_int)(sqlite3_stmt*,int,int);
401e397f8fSdrh   int  (*bind_int64)(sqlite3_stmt*,int,sqlite_int64);
411e397f8fSdrh   int  (*bind_null)(sqlite3_stmt*,int);
421e397f8fSdrh   int  (*bind_parameter_count)(sqlite3_stmt*);
431e397f8fSdrh   int  (*bind_parameter_index)(sqlite3_stmt*,const char*zName);
441e397f8fSdrh   const char * (*bind_parameter_name)(sqlite3_stmt*,int);
451e397f8fSdrh   int  (*bind_text)(sqlite3_stmt*,int,const char*,int n,void(*)(void*));
461e397f8fSdrh   int  (*bind_text16)(sqlite3_stmt*,int,const void*,int,void(*)(void*));
47c1be6324Sdrh   int  (*bind_value)(sqlite3_stmt*,int,const sqlite3_value*);
481e397f8fSdrh   int  (*busy_handler)(sqlite3*,int(*)(void*,int),void*);
491e397f8fSdrh   int  (*busy_timeout)(sqlite3*,int ms);
501e397f8fSdrh   int  (*changes)(sqlite3*);
511e397f8fSdrh   int  (*close)(sqlite3*);
520d1ee483Sdrh   int  (*collation_needed)(sqlite3*,void*,void(*)(void*,sqlite3*,
530d1ee483Sdrh                            int eTextRep,const char*));
540d1ee483Sdrh   int  (*collation_needed16)(sqlite3*,void*,void(*)(void*,sqlite3*,
550d1ee483Sdrh                              int eTextRep,const void*));
561e397f8fSdrh   const void * (*column_blob)(sqlite3_stmt*,int iCol);
571e397f8fSdrh   int  (*column_bytes)(sqlite3_stmt*,int iCol);
581e397f8fSdrh   int  (*column_bytes16)(sqlite3_stmt*,int iCol);
591e397f8fSdrh   int  (*column_count)(sqlite3_stmt*pStmt);
601e397f8fSdrh   const char * (*column_database_name)(sqlite3_stmt*,int);
611e397f8fSdrh   const void * (*column_database_name16)(sqlite3_stmt*,int);
621e397f8fSdrh   const char * (*column_decltype)(sqlite3_stmt*,int i);
631e397f8fSdrh   const void * (*column_decltype16)(sqlite3_stmt*,int);
641e397f8fSdrh   double  (*column_double)(sqlite3_stmt*,int iCol);
651e397f8fSdrh   int  (*column_int)(sqlite3_stmt*,int iCol);
661e397f8fSdrh   sqlite_int64  (*column_int64)(sqlite3_stmt*,int iCol);
671e397f8fSdrh   const char * (*column_name)(sqlite3_stmt*,int);
681e397f8fSdrh   const void * (*column_name16)(sqlite3_stmt*,int);
691e397f8fSdrh   const char * (*column_origin_name)(sqlite3_stmt*,int);
701e397f8fSdrh   const void * (*column_origin_name16)(sqlite3_stmt*,int);
711e397f8fSdrh   const char * (*column_table_name)(sqlite3_stmt*,int);
721e397f8fSdrh   const void * (*column_table_name16)(sqlite3_stmt*,int);
731e397f8fSdrh   const unsigned char * (*column_text)(sqlite3_stmt*,int iCol);
741e397f8fSdrh   const void * (*column_text16)(sqlite3_stmt*,int iCol);
751e397f8fSdrh   int  (*column_type)(sqlite3_stmt*,int iCol);
76d6e8dd00Sdanielk1977   sqlite3_value* (*column_value)(sqlite3_stmt*,int iCol);
771e397f8fSdrh   void * (*commit_hook)(sqlite3*,int(*)(void*),void*);
781e397f8fSdrh   int  (*complete)(const char*sql);
791e397f8fSdrh   int  (*complete16)(const void*sql);
800d1ee483Sdrh   int  (*create_collation)(sqlite3*,const char*,int,void*,
810d1ee483Sdrh                            int(*)(void*,int,const void*,int,const void*));
820d1ee483Sdrh   int  (*create_collation16)(sqlite3*,const void*,int,void*,
830d1ee483Sdrh                              int(*)(void*,int,const void*,int,const void*));
840d1ee483Sdrh   int  (*create_function)(sqlite3*,const char*,int,int,void*,
850d1ee483Sdrh                           void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
860d1ee483Sdrh                           void (*xStep)(sqlite3_context*,int,sqlite3_value**),
870d1ee483Sdrh                           void (*xFinal)(sqlite3_context*));
880d1ee483Sdrh   int  (*create_function16)(sqlite3*,const void*,int,int,void*,
890d1ee483Sdrh                             void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
900d1ee483Sdrh                             void (*xStep)(sqlite3_context*,int,sqlite3_value**),
910d1ee483Sdrh                             void (*xFinal)(sqlite3_context*));
929c41938fSdrh   int (*create_module)(sqlite3*,const char*,const sqlite3_module*,void*);
931e397f8fSdrh   int  (*data_count)(sqlite3_stmt*pStmt);
941e397f8fSdrh   sqlite3 * (*db_handle)(sqlite3_stmt*);
95d6e8dd00Sdanielk1977   int (*declare_vtab)(sqlite3*,const char*);
961e397f8fSdrh   int  (*enable_shared_cache)(int);
971e397f8fSdrh   int  (*errcode)(sqlite3*db);
981e397f8fSdrh   const char * (*errmsg)(sqlite3*);
991e397f8fSdrh   const void * (*errmsg16)(sqlite3*);
1001e397f8fSdrh   int  (*exec)(sqlite3*,const char*,sqlite3_callback,void*,char**);
1011e397f8fSdrh   int  (*expired)(sqlite3_stmt*);
1021e397f8fSdrh   int  (*finalize)(sqlite3_stmt*pStmt);
103c1be6324Sdrh   void  (*free)(void*);
1041e397f8fSdrh   void  (*free_table)(char**result);
1051e397f8fSdrh   int  (*get_autocommit)(sqlite3*);
1061e397f8fSdrh   void * (*get_auxdata)(sqlite3_context*,int);
1071e397f8fSdrh   int  (*get_table)(sqlite3*,const char*,char***,int*,int*,char**);
1081e397f8fSdrh   int  (*global_recover)(void);
1096be36cb6Sdrh   void  (*interruptx)(sqlite3*);
1101e397f8fSdrh   sqlite_int64  (*last_insert_rowid)(sqlite3*);
1111e397f8fSdrh   const char * (*libversion)(void);
1121e397f8fSdrh   int  (*libversion_number)(void);
113f3a65f7eSdrh   void *(*malloc)(int);
1141e397f8fSdrh   char * (*mprintf)(const char*,...);
1151e397f8fSdrh   int  (*open)(const char*,sqlite3**);
1161e397f8fSdrh   int  (*open16)(const void*,sqlite3**);
1171e397f8fSdrh   int  (*prepare)(sqlite3*,const char*,int,sqlite3_stmt**,const char**);
1181e397f8fSdrh   int  (*prepare16)(sqlite3*,const void*,int,sqlite3_stmt**,const void**);
1191e397f8fSdrh   void * (*profile)(sqlite3*,void(*)(void*,const char*,sqlite_uint64),void*);
1201e397f8fSdrh   void  (*progress_handler)(sqlite3*,int,int(*)(void*),void*);
121f3a65f7eSdrh   void *(*realloc)(void*,int);
1221e397f8fSdrh   int  (*reset)(sqlite3_stmt*pStmt);
1231e397f8fSdrh   void  (*result_blob)(sqlite3_context*,const void*,int,void(*)(void*));
1241e397f8fSdrh   void  (*result_double)(sqlite3_context*,double);
1251e397f8fSdrh   void  (*result_error)(sqlite3_context*,const char*,int);
1261e397f8fSdrh   void  (*result_error16)(sqlite3_context*,const void*,int);
1271e397f8fSdrh   void  (*result_int)(sqlite3_context*,int);
1281e397f8fSdrh   void  (*result_int64)(sqlite3_context*,sqlite_int64);
1291e397f8fSdrh   void  (*result_null)(sqlite3_context*);
1301e397f8fSdrh   void  (*result_text)(sqlite3_context*,const char*,int,void(*)(void*));
1311e397f8fSdrh   void  (*result_text16)(sqlite3_context*,const void*,int,void(*)(void*));
1321e397f8fSdrh   void  (*result_text16be)(sqlite3_context*,const void*,int,void(*)(void*));
1331e397f8fSdrh   void  (*result_text16le)(sqlite3_context*,const void*,int,void(*)(void*));
1341e397f8fSdrh   void  (*result_value)(sqlite3_context*,sqlite3_value*);
1351e397f8fSdrh   void * (*rollback_hook)(sqlite3*,void(*)(void*),void*);
1360d1ee483Sdrh   int  (*set_authorizer)(sqlite3*,int(*)(void*,int,const char*,const char*,
1370d1ee483Sdrh                          const char*,const char*),void*);
1381e397f8fSdrh   void  (*set_auxdata)(sqlite3_context*,int,void*,void (*)(void*));
1391e397f8fSdrh   char * (*snprintf)(int,char*,const char*,...);
1401e397f8fSdrh   int  (*step)(sqlite3_stmt*);
1410d1ee483Sdrh   int  (*table_column_metadata)(sqlite3*,const char*,const char*,const char*,
1420d1ee483Sdrh                                 char const**,char const**,int*,int*,int*);
1431e397f8fSdrh   void  (*thread_cleanup)(void);
1441e397f8fSdrh   int  (*total_changes)(sqlite3*);
1451e397f8fSdrh   void * (*trace)(sqlite3*,void(*xTrace)(void*,const char*),void*);
1461e397f8fSdrh   int  (*transfer_bindings)(sqlite3_stmt*,sqlite3_stmt*);
1470d1ee483Sdrh   void * (*update_hook)(sqlite3*,void(*)(void*,int ,char const*,char const*,
1480d1ee483Sdrh                                          sqlite_int64),void*);
1491e397f8fSdrh   void * (*user_data)(sqlite3_context*);
1501e397f8fSdrh   const void * (*value_blob)(sqlite3_value*);
1511e397f8fSdrh   int  (*value_bytes)(sqlite3_value*);
1521e397f8fSdrh   int  (*value_bytes16)(sqlite3_value*);
1531e397f8fSdrh   double  (*value_double)(sqlite3_value*);
1541e397f8fSdrh   int  (*value_int)(sqlite3_value*);
1551e397f8fSdrh   sqlite_int64  (*value_int64)(sqlite3_value*);
1561e397f8fSdrh   int  (*value_numeric_type)(sqlite3_value*);
1571e397f8fSdrh   const unsigned char * (*value_text)(sqlite3_value*);
1581e397f8fSdrh   const void * (*value_text16)(sqlite3_value*);
1591e397f8fSdrh   const void * (*value_text16be)(sqlite3_value*);
1601e397f8fSdrh   const void * (*value_text16le)(sqlite3_value*);
1611e397f8fSdrh   int  (*value_type)(sqlite3_value*);
1621e397f8fSdrh   char *(*vmprintf)(const char*,va_list);
163428e2826Sdrh   /* Added ??? */
1647409310aSshess   int (*overload_function)(sqlite3*, const char *zFuncName, int nArg);
165428e2826Sdrh   /* Added by 3.3.13 */
1666d54da05Sdrh   int (*prepare_v2)(sqlite3*,const char*,int,sqlite3_stmt**,const char**);
1676d54da05Sdrh   int (*prepare16_v2)(sqlite3*,const void*,int,sqlite3_stmt**,const void**);
168a92993caSdrh   int (*clear_bindings)(sqlite3_stmt*);
169428e2826Sdrh   /* Added by 3.4.1 */
1700d1ee483Sdrh   int (*create_module_v2)(sqlite3*,const char*,const sqlite3_module*,void*,
1710d1ee483Sdrh                           void (*xDestroy)(void *));
172428e2826Sdrh   /* Added by 3.5.0 */
173428e2826Sdrh   int (*bind_zeroblob)(sqlite3_stmt*,int,int);
174428e2826Sdrh   int (*blob_bytes)(sqlite3_blob*);
175428e2826Sdrh   int (*blob_close)(sqlite3_blob*);
1760d1ee483Sdrh   int (*blob_open)(sqlite3*,const char*,const char*,const char*,sqlite3_int64,
1770d1ee483Sdrh                    int,sqlite3_blob**);
178428e2826Sdrh   int (*blob_read)(sqlite3_blob*,void*,int,int);
179428e2826Sdrh   int (*blob_write)(sqlite3_blob*,const void*,int,int);
1800d1ee483Sdrh   int (*create_collation_v2)(sqlite3*,const char*,int,void*,
1810d1ee483Sdrh                              int(*)(void*,int,const void*,int,const void*),
1820d1ee483Sdrh                              void(*)(void*));
183cc6bb3eaSdrh   int (*file_control)(sqlite3*,const char*,int,void*);
184428e2826Sdrh   sqlite3_int64 (*memory_highwater)(int);
185428e2826Sdrh   sqlite3_int64 (*memory_used)(void);
18661f6dc60Sdrh   sqlite3_mutex *(*mutex_alloc)(int);
18761f6dc60Sdrh   void (*mutex_enter)(sqlite3_mutex*);
18861f6dc60Sdrh   void (*mutex_free)(sqlite3_mutex*);
18961f6dc60Sdrh   void (*mutex_leave)(sqlite3_mutex*);
19061f6dc60Sdrh   int (*mutex_try)(sqlite3_mutex*);
191428e2826Sdrh   int (*open_v2)(const char*,sqlite3**,int,const char*);
192428e2826Sdrh   int (*release_memory)(int);
193428e2826Sdrh   void (*result_error_nomem)(sqlite3_context*);
194428e2826Sdrh   void (*result_error_toobig)(sqlite3_context*);
195428e2826Sdrh   int (*sleep)(int);
196428e2826Sdrh   void (*soft_heap_limit)(int);
197428e2826Sdrh   sqlite3_vfs *(*vfs_find)(const char*);
198428e2826Sdrh   int (*vfs_register)(sqlite3_vfs*,int);
199428e2826Sdrh   int (*vfs_unregister)(sqlite3_vfs*);
200e5dd20a6Sdrh   int (*xthreadsafe)(void);
201e5dd20a6Sdrh   void (*result_zeroblob)(sqlite3_context*,int);
202e5dd20a6Sdrh   void (*result_error_code)(sqlite3_context*,int);
203e5dd20a6Sdrh   int (*test_control)(int, ...);
2042fa1868fSdrh   void (*randomness)(int,void*);
205fa4a4b91Sdrh   sqlite3 *(*context_db_handle)(sqlite3_context*);
2068b6abedbSdrh   int (*extended_result_codes)(sqlite3*,int);
2078b6abedbSdrh   int (*limit)(sqlite3*,int,int);
2088b6abedbSdrh   sqlite3_stmt *(*next_stmt)(sqlite3*,sqlite3_stmt*);
2098b6abedbSdrh   const char *(*sql)(sqlite3_stmt*);
2108b6abedbSdrh   int (*status)(int,int*,int*,int);
211fd7ebbf6Sdrh   int (*backup_finish)(sqlite3_backup*);
212fd7ebbf6Sdrh   sqlite3_backup *(*backup_init)(sqlite3*,const char*,sqlite3*,const char*);
213fd7ebbf6Sdrh   int (*backup_pagecount)(sqlite3_backup*);
214fd7ebbf6Sdrh   int (*backup_remaining)(sqlite3_backup*);
215fd7ebbf6Sdrh   int (*backup_step)(sqlite3_backup*,int);
216fd7ebbf6Sdrh   const char *(*compileoption_get)(int);
217fd7ebbf6Sdrh   int (*compileoption_used)(const char*);
2180d1ee483Sdrh   int (*create_function_v2)(sqlite3*,const char*,int,int,void*,
2190d1ee483Sdrh                             void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
2200d1ee483Sdrh                             void (*xStep)(sqlite3_context*,int,sqlite3_value**),
2210d1ee483Sdrh                             void (*xFinal)(sqlite3_context*),
2220d1ee483Sdrh                             void(*xDestroy)(void*));
223fd7ebbf6Sdrh   int (*db_config)(sqlite3*,int,...);
224fd7ebbf6Sdrh   sqlite3_mutex *(*db_mutex)(sqlite3*);
225fd7ebbf6Sdrh   int (*db_status)(sqlite3*,int,int*,int*,int);
226fd7ebbf6Sdrh   int (*extended_errcode)(sqlite3*);
227fd7ebbf6Sdrh   void (*log)(int,const char*,...);
228fd7ebbf6Sdrh   sqlite3_int64 (*soft_heap_limit64)(sqlite3_int64);
229fd7ebbf6Sdrh   const char *(*sourceid)(void);
230fd7ebbf6Sdrh   int (*stmt_status)(sqlite3_stmt*,int,int);
231fd7ebbf6Sdrh   int (*strnicmp)(const char*,const char*,int);
232fd7ebbf6Sdrh   int (*unlock_notify)(sqlite3*,void(*)(void**,int),void*);
233fd7ebbf6Sdrh   int (*wal_autocheckpoint)(sqlite3*,int);
234fd7ebbf6Sdrh   int (*wal_checkpoint)(sqlite3*,const char*);
235fd7ebbf6Sdrh   void *(*wal_hook)(sqlite3*,int(*)(void*,sqlite3*,const char*,int),void*);
2360ea2517cSdan   int (*blob_reopen)(sqlite3_blob*,sqlite3_int64);
2370ea2517cSdan   int (*vtab_config)(sqlite3*,int op,...);
2380ea2517cSdan   int (*vtab_on_conflict)(sqlite3*);
2394207a3fbSdrh   /* Version 3.7.16 and later */
2404207a3fbSdrh   int (*close_v2)(sqlite3*);
2414207a3fbSdrh   const char *(*db_filename)(sqlite3*,const char*);
2424207a3fbSdrh   int (*db_readonly)(sqlite3*,const char*);
2434207a3fbSdrh   int (*db_release_memory)(sqlite3*);
2444207a3fbSdrh   const char *(*errstr)(int);
2454207a3fbSdrh   int (*stmt_busy)(sqlite3_stmt*);
2464207a3fbSdrh   int (*stmt_readonly)(sqlite3_stmt*);
2474207a3fbSdrh   int (*stricmp)(const char*,const char*);
2484207a3fbSdrh   int (*uri_boolean)(const char*,const char*,int);
2494207a3fbSdrh   sqlite3_int64 (*uri_int64)(const char*,const char*,sqlite3_int64);
2504207a3fbSdrh   const char *(*uri_parameter)(const char*,const char*);
2514207a3fbSdrh   char *(*vsnprintf)(int,char*,const char*,va_list);
2524207a3fbSdrh   int (*wal_checkpoint_v2)(sqlite3*,const char*,int,int*,int*);
2530807cc2cSdrh   /* Version 3.8.7 and later */
2540807cc2cSdrh   int (*auto_extension)(void(*)(void));
2550807cc2cSdrh   int (*bind_blob64)(sqlite3_stmt*,int,const void*,sqlite3_uint64,
2560807cc2cSdrh                      void(*)(void*));
257bbf483f8Sdrh   int (*bind_text64)(sqlite3_stmt*,int,const char*,sqlite3_uint64,
2580807cc2cSdrh                       void(*)(void*),unsigned char);
2590807cc2cSdrh   int (*cancel_auto_extension)(void(*)(void));
2600807cc2cSdrh   int (*load_extension)(sqlite3*,const char*,const char*,char**);
2610807cc2cSdrh   void *(*malloc64)(sqlite3_uint64);
2620807cc2cSdrh   sqlite3_uint64 (*msize)(void*);
2630807cc2cSdrh   void *(*realloc64)(void*,sqlite3_uint64);
2640807cc2cSdrh   void (*reset_auto_extension)(void);
2650807cc2cSdrh   void (*result_blob64)(sqlite3_context*,const void*,sqlite3_uint64,
2660807cc2cSdrh                         void(*)(void*));
267bbf483f8Sdrh   void (*result_text64)(sqlite3_context*,const char*,sqlite3_uint64,
2680807cc2cSdrh                          void(*)(void*), unsigned char);
2690807cc2cSdrh   int (*strglob)(const char*,const char*);
270f5ed7ad6Sdrh   /* Version 3.8.11 and later */
271f5ed7ad6Sdrh   sqlite3_value *(*value_dup)(const sqlite3_value*);
2724f03f413Sdrh   void (*value_free)(sqlite3_value*);
273a4d5ae8fSdan   int (*result_zeroblob64)(sqlite3_context*,sqlite3_uint64);
27480c03022Sdan   int (*bind_zeroblob64)(sqlite3_stmt*, int, sqlite3_uint64);
27558a8a923Sdrh   /* Version 3.9.0 and later */
276cf94f179Sdrh   unsigned int (*value_subtype)(sqlite3_value*);
277cf94f179Sdrh   void (*result_subtype)(sqlite3_context*,unsigned int);
2788b4a94adSdrh   /* Version 3.10.0 and later */
2797be53fe4Sdrh   int (*status64)(int,sqlite3_int64*,sqlite3_int64*,int);
2808b4a94adSdrh   int (*strlike)(const char*,const char*,unsigned int);
2817be53fe4Sdrh   int (*db_cacheflush)(sqlite3*);
2821b9f2141Sdrh   /* Version 3.12.0 and later */
2831b9f2141Sdrh   int (*system_errno)(sqlite3*);
2843d2a529dSdrh   /* Version 3.14.0 and later */
285*fca760c8Sdrh   int (*trace_v2)(sqlite3*,int(*)(unsigned,void*,void*,void*),unsigned,void*);
286*fca760c8Sdrh   char *(*expanded_sql)(sqlite3_stmt*);
2871e397f8fSdrh };
2881e397f8fSdrh 
2891e397f8fSdrh /*
2901e397f8fSdrh ** The following macros redefine the API routines so that they are
29160ec914cSpeter.d.reid ** redirected through the global sqlite3_api structure.
2921e397f8fSdrh **
2931e397f8fSdrh ** This header file is also used by the loadext.c source file
2941e397f8fSdrh ** (part of the main SQLite library - not an extension) so that
2951e397f8fSdrh ** it can get access to the sqlite3_api_routines structure
2961e397f8fSdrh ** definition.  But the main library does not want to redefine
2971e397f8fSdrh ** the API.  So the redefinition macros are only valid if the
2981e397f8fSdrh ** SQLITE_CORE macros is undefined.
2991e397f8fSdrh */
3000c275088Sdrh #if !defined(SQLITE_CORE) && !defined(SQLITE_OMIT_LOAD_EXTENSION)
3011e397f8fSdrh #define sqlite3_aggregate_context      sqlite3_api->aggregate_context
302eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED
3031e397f8fSdrh #define sqlite3_aggregate_count        sqlite3_api->aggregate_count
304eec556d3Sshane #endif
3051e397f8fSdrh #define sqlite3_bind_blob              sqlite3_api->bind_blob
3061e397f8fSdrh #define sqlite3_bind_double            sqlite3_api->bind_double
3071e397f8fSdrh #define sqlite3_bind_int               sqlite3_api->bind_int
3081e397f8fSdrh #define sqlite3_bind_int64             sqlite3_api->bind_int64
3091e397f8fSdrh #define sqlite3_bind_null              sqlite3_api->bind_null
3101e397f8fSdrh #define sqlite3_bind_parameter_count   sqlite3_api->bind_parameter_count
3111e397f8fSdrh #define sqlite3_bind_parameter_index   sqlite3_api->bind_parameter_index
3121e397f8fSdrh #define sqlite3_bind_parameter_name    sqlite3_api->bind_parameter_name
3131e397f8fSdrh #define sqlite3_bind_text              sqlite3_api->bind_text
3141e397f8fSdrh #define sqlite3_bind_text16            sqlite3_api->bind_text16
315c1be6324Sdrh #define sqlite3_bind_value             sqlite3_api->bind_value
3161e397f8fSdrh #define sqlite3_busy_handler           sqlite3_api->busy_handler
3171e397f8fSdrh #define sqlite3_busy_timeout           sqlite3_api->busy_timeout
3181e397f8fSdrh #define sqlite3_changes                sqlite3_api->changes
3191e397f8fSdrh #define sqlite3_close                  sqlite3_api->close
3201e397f8fSdrh #define sqlite3_collation_needed       sqlite3_api->collation_needed
3211e397f8fSdrh #define sqlite3_collation_needed16     sqlite3_api->collation_needed16
3221e397f8fSdrh #define sqlite3_column_blob            sqlite3_api->column_blob
3231e397f8fSdrh #define sqlite3_column_bytes           sqlite3_api->column_bytes
3241e397f8fSdrh #define sqlite3_column_bytes16         sqlite3_api->column_bytes16
3251e397f8fSdrh #define sqlite3_column_count           sqlite3_api->column_count
3261e397f8fSdrh #define sqlite3_column_database_name   sqlite3_api->column_database_name
3271e397f8fSdrh #define sqlite3_column_database_name16 sqlite3_api->column_database_name16
3281e397f8fSdrh #define sqlite3_column_decltype        sqlite3_api->column_decltype
3291e397f8fSdrh #define sqlite3_column_decltype16      sqlite3_api->column_decltype16
3301e397f8fSdrh #define sqlite3_column_double          sqlite3_api->column_double
3311e397f8fSdrh #define sqlite3_column_int             sqlite3_api->column_int
3321e397f8fSdrh #define sqlite3_column_int64           sqlite3_api->column_int64
3331e397f8fSdrh #define sqlite3_column_name            sqlite3_api->column_name
3341e397f8fSdrh #define sqlite3_column_name16          sqlite3_api->column_name16
3351e397f8fSdrh #define sqlite3_column_origin_name     sqlite3_api->column_origin_name
3361e397f8fSdrh #define sqlite3_column_origin_name16   sqlite3_api->column_origin_name16
3371e397f8fSdrh #define sqlite3_column_table_name      sqlite3_api->column_table_name
3381e397f8fSdrh #define sqlite3_column_table_name16    sqlite3_api->column_table_name16
3391e397f8fSdrh #define sqlite3_column_text            sqlite3_api->column_text
3401e397f8fSdrh #define sqlite3_column_text16          sqlite3_api->column_text16
3411e397f8fSdrh #define sqlite3_column_type            sqlite3_api->column_type
342d6e8dd00Sdanielk1977 #define sqlite3_column_value           sqlite3_api->column_value
3431e397f8fSdrh #define sqlite3_commit_hook            sqlite3_api->commit_hook
3441e397f8fSdrh #define sqlite3_complete               sqlite3_api->complete
3451e397f8fSdrh #define sqlite3_complete16             sqlite3_api->complete16
3461e397f8fSdrh #define sqlite3_create_collation       sqlite3_api->create_collation
3471e397f8fSdrh #define sqlite3_create_collation16     sqlite3_api->create_collation16
3481e397f8fSdrh #define sqlite3_create_function        sqlite3_api->create_function
3491e397f8fSdrh #define sqlite3_create_function16      sqlite3_api->create_function16
350d6e8dd00Sdanielk1977 #define sqlite3_create_module          sqlite3_api->create_module
351832a58a6Sdanielk1977 #define sqlite3_create_module_v2       sqlite3_api->create_module_v2
3521e397f8fSdrh #define sqlite3_data_count             sqlite3_api->data_count
3531e397f8fSdrh #define sqlite3_db_handle              sqlite3_api->db_handle
354d6e8dd00Sdanielk1977 #define sqlite3_declare_vtab           sqlite3_api->declare_vtab
3551e397f8fSdrh #define sqlite3_enable_shared_cache    sqlite3_api->enable_shared_cache
3561e397f8fSdrh #define sqlite3_errcode                sqlite3_api->errcode
3571e397f8fSdrh #define sqlite3_errmsg                 sqlite3_api->errmsg
3581e397f8fSdrh #define sqlite3_errmsg16               sqlite3_api->errmsg16
3591e397f8fSdrh #define sqlite3_exec                   sqlite3_api->exec
360eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED
3611e397f8fSdrh #define sqlite3_expired                sqlite3_api->expired
362eec556d3Sshane #endif
3631e397f8fSdrh #define sqlite3_finalize               sqlite3_api->finalize
3641e397f8fSdrh #define sqlite3_free                   sqlite3_api->free
3651e397f8fSdrh #define sqlite3_free_table             sqlite3_api->free_table
3661e397f8fSdrh #define sqlite3_get_autocommit         sqlite3_api->get_autocommit
3671e397f8fSdrh #define sqlite3_get_auxdata            sqlite3_api->get_auxdata
3681e397f8fSdrh #define sqlite3_get_table              sqlite3_api->get_table
369eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED
3701e397f8fSdrh #define sqlite3_global_recover         sqlite3_api->global_recover
371eec556d3Sshane #endif
3726be36cb6Sdrh #define sqlite3_interrupt              sqlite3_api->interruptx
3731e397f8fSdrh #define sqlite3_last_insert_rowid      sqlite3_api->last_insert_rowid
3741e397f8fSdrh #define sqlite3_libversion             sqlite3_api->libversion
3751e397f8fSdrh #define sqlite3_libversion_number      sqlite3_api->libversion_number
37628dd479cSdrh #define sqlite3_malloc                 sqlite3_api->malloc
3771e397f8fSdrh #define sqlite3_mprintf                sqlite3_api->mprintf
3781e397f8fSdrh #define sqlite3_open                   sqlite3_api->open
3791e397f8fSdrh #define sqlite3_open16                 sqlite3_api->open16
3801e397f8fSdrh #define sqlite3_prepare                sqlite3_api->prepare
3811e397f8fSdrh #define sqlite3_prepare16              sqlite3_api->prepare16
3826d54da05Sdrh #define sqlite3_prepare_v2             sqlite3_api->prepare_v2
3836d54da05Sdrh #define sqlite3_prepare16_v2           sqlite3_api->prepare16_v2
3841e397f8fSdrh #define sqlite3_profile                sqlite3_api->profile
3851e397f8fSdrh #define sqlite3_progress_handler       sqlite3_api->progress_handler
38628dd479cSdrh #define sqlite3_realloc                sqlite3_api->realloc
3871e397f8fSdrh #define sqlite3_reset                  sqlite3_api->reset
3881e397f8fSdrh #define sqlite3_result_blob            sqlite3_api->result_blob
3891e397f8fSdrh #define sqlite3_result_double          sqlite3_api->result_double
3901e397f8fSdrh #define sqlite3_result_error           sqlite3_api->result_error
3911e397f8fSdrh #define sqlite3_result_error16         sqlite3_api->result_error16
3921e397f8fSdrh #define sqlite3_result_int             sqlite3_api->result_int
3931e397f8fSdrh #define sqlite3_result_int64           sqlite3_api->result_int64
3941e397f8fSdrh #define sqlite3_result_null            sqlite3_api->result_null
3951e397f8fSdrh #define sqlite3_result_text            sqlite3_api->result_text
3961e397f8fSdrh #define sqlite3_result_text16          sqlite3_api->result_text16
3971e397f8fSdrh #define sqlite3_result_text16be        sqlite3_api->result_text16be
3981e397f8fSdrh #define sqlite3_result_text16le        sqlite3_api->result_text16le
3991e397f8fSdrh #define sqlite3_result_value           sqlite3_api->result_value
4001e397f8fSdrh #define sqlite3_rollback_hook          sqlite3_api->rollback_hook
4011e397f8fSdrh #define sqlite3_set_authorizer         sqlite3_api->set_authorizer
4021e397f8fSdrh #define sqlite3_set_auxdata            sqlite3_api->set_auxdata
4031e397f8fSdrh #define sqlite3_snprintf               sqlite3_api->snprintf
4041e397f8fSdrh #define sqlite3_step                   sqlite3_api->step
4051e397f8fSdrh #define sqlite3_table_column_metadata  sqlite3_api->table_column_metadata
4061e397f8fSdrh #define sqlite3_thread_cleanup         sqlite3_api->thread_cleanup
4071e397f8fSdrh #define sqlite3_total_changes          sqlite3_api->total_changes
4081e397f8fSdrh #define sqlite3_trace                  sqlite3_api->trace
409eec556d3Sshane #ifndef SQLITE_OMIT_DEPRECATED
4101e397f8fSdrh #define sqlite3_transfer_bindings      sqlite3_api->transfer_bindings
411eec556d3Sshane #endif
4121e397f8fSdrh #define sqlite3_update_hook            sqlite3_api->update_hook
4131e397f8fSdrh #define sqlite3_user_data              sqlite3_api->user_data
4141e397f8fSdrh #define sqlite3_value_blob             sqlite3_api->value_blob
4151e397f8fSdrh #define sqlite3_value_bytes            sqlite3_api->value_bytes
4161e397f8fSdrh #define sqlite3_value_bytes16          sqlite3_api->value_bytes16
4171e397f8fSdrh #define sqlite3_value_double           sqlite3_api->value_double
4181e397f8fSdrh #define sqlite3_value_int              sqlite3_api->value_int
4191e397f8fSdrh #define sqlite3_value_int64            sqlite3_api->value_int64
4201e397f8fSdrh #define sqlite3_value_numeric_type     sqlite3_api->value_numeric_type
4211e397f8fSdrh #define sqlite3_value_text             sqlite3_api->value_text
4221e397f8fSdrh #define sqlite3_value_text16           sqlite3_api->value_text16
4231e397f8fSdrh #define sqlite3_value_text16be         sqlite3_api->value_text16be
4241e397f8fSdrh #define sqlite3_value_text16le         sqlite3_api->value_text16le
4251e397f8fSdrh #define sqlite3_value_type             sqlite3_api->value_type
4261e397f8fSdrh #define sqlite3_vmprintf               sqlite3_api->vmprintf
427cfe05d88Sdrh #define sqlite3_vsnprintf              sqlite3_api->vsnprintf
4287409310aSshess #define sqlite3_overload_function      sqlite3_api->overload_function
429a92993caSdrh #define sqlite3_prepare_v2             sqlite3_api->prepare_v2
430a92993caSdrh #define sqlite3_prepare16_v2           sqlite3_api->prepare16_v2
431a92993caSdrh #define sqlite3_clear_bindings         sqlite3_api->clear_bindings
432428e2826Sdrh #define sqlite3_bind_zeroblob          sqlite3_api->bind_zeroblob
433428e2826Sdrh #define sqlite3_blob_bytes             sqlite3_api->blob_bytes
434428e2826Sdrh #define sqlite3_blob_close             sqlite3_api->blob_close
435428e2826Sdrh #define sqlite3_blob_open              sqlite3_api->blob_open
436428e2826Sdrh #define sqlite3_blob_read              sqlite3_api->blob_read
437428e2826Sdrh #define sqlite3_blob_write             sqlite3_api->blob_write
438428e2826Sdrh #define sqlite3_create_collation_v2    sqlite3_api->create_collation_v2
439cc6bb3eaSdrh #define sqlite3_file_control           sqlite3_api->file_control
440428e2826Sdrh #define sqlite3_memory_highwater       sqlite3_api->memory_highwater
441428e2826Sdrh #define sqlite3_memory_used            sqlite3_api->memory_used
44261f6dc60Sdrh #define sqlite3_mutex_alloc            sqlite3_api->mutex_alloc
44361f6dc60Sdrh #define sqlite3_mutex_enter            sqlite3_api->mutex_enter
44461f6dc60Sdrh #define sqlite3_mutex_free             sqlite3_api->mutex_free
44561f6dc60Sdrh #define sqlite3_mutex_leave            sqlite3_api->mutex_leave
44661f6dc60Sdrh #define sqlite3_mutex_try              sqlite3_api->mutex_try
447428e2826Sdrh #define sqlite3_open_v2                sqlite3_api->open_v2
448428e2826Sdrh #define sqlite3_release_memory         sqlite3_api->release_memory
449428e2826Sdrh #define sqlite3_result_error_nomem     sqlite3_api->result_error_nomem
450428e2826Sdrh #define sqlite3_result_error_toobig    sqlite3_api->result_error_toobig
451428e2826Sdrh #define sqlite3_sleep                  sqlite3_api->sleep
452428e2826Sdrh #define sqlite3_soft_heap_limit        sqlite3_api->soft_heap_limit
453428e2826Sdrh #define sqlite3_vfs_find               sqlite3_api->vfs_find
454428e2826Sdrh #define sqlite3_vfs_register           sqlite3_api->vfs_register
455428e2826Sdrh #define sqlite3_vfs_unregister         sqlite3_api->vfs_unregister
456e5dd20a6Sdrh #define sqlite3_threadsafe             sqlite3_api->xthreadsafe
457e5dd20a6Sdrh #define sqlite3_result_zeroblob        sqlite3_api->result_zeroblob
458e5dd20a6Sdrh #define sqlite3_result_error_code      sqlite3_api->result_error_code
459e5dd20a6Sdrh #define sqlite3_test_control           sqlite3_api->test_control
4602fa1868fSdrh #define sqlite3_randomness             sqlite3_api->randomness
461fa4a4b91Sdrh #define sqlite3_context_db_handle      sqlite3_api->context_db_handle
4628b6abedbSdrh #define sqlite3_extended_result_codes  sqlite3_api->extended_result_codes
4638b6abedbSdrh #define sqlite3_limit                  sqlite3_api->limit
4648b6abedbSdrh #define sqlite3_next_stmt              sqlite3_api->next_stmt
4658b6abedbSdrh #define sqlite3_sql                    sqlite3_api->sql
4668b6abedbSdrh #define sqlite3_status                 sqlite3_api->status
467fd7ebbf6Sdrh #define sqlite3_backup_finish          sqlite3_api->backup_finish
468fd7ebbf6Sdrh #define sqlite3_backup_init            sqlite3_api->backup_init
469fd7ebbf6Sdrh #define sqlite3_backup_pagecount       sqlite3_api->backup_pagecount
470fd7ebbf6Sdrh #define sqlite3_backup_remaining       sqlite3_api->backup_remaining
471fd7ebbf6Sdrh #define sqlite3_backup_step            sqlite3_api->backup_step
472fd7ebbf6Sdrh #define sqlite3_compileoption_get      sqlite3_api->compileoption_get
473fd7ebbf6Sdrh #define sqlite3_compileoption_used     sqlite3_api->compileoption_used
474fd7ebbf6Sdrh #define sqlite3_create_function_v2     sqlite3_api->create_function_v2
475fd7ebbf6Sdrh #define sqlite3_db_config              sqlite3_api->db_config
476fd7ebbf6Sdrh #define sqlite3_db_mutex               sqlite3_api->db_mutex
477fd7ebbf6Sdrh #define sqlite3_db_status              sqlite3_api->db_status
478fd7ebbf6Sdrh #define sqlite3_extended_errcode       sqlite3_api->extended_errcode
479fd7ebbf6Sdrh #define sqlite3_log                    sqlite3_api->log
480fd7ebbf6Sdrh #define sqlite3_soft_heap_limit64      sqlite3_api->soft_heap_limit64
481fd7ebbf6Sdrh #define sqlite3_sourceid               sqlite3_api->sourceid
482fd7ebbf6Sdrh #define sqlite3_stmt_status            sqlite3_api->stmt_status
483fd7ebbf6Sdrh #define sqlite3_strnicmp               sqlite3_api->strnicmp
484fd7ebbf6Sdrh #define sqlite3_unlock_notify          sqlite3_api->unlock_notify
485fd7ebbf6Sdrh #define sqlite3_wal_autocheckpoint     sqlite3_api->wal_autocheckpoint
486fd7ebbf6Sdrh #define sqlite3_wal_checkpoint         sqlite3_api->wal_checkpoint
487fd7ebbf6Sdrh #define sqlite3_wal_hook               sqlite3_api->wal_hook
4880ea2517cSdan #define sqlite3_blob_reopen            sqlite3_api->blob_reopen
4890ea2517cSdan #define sqlite3_vtab_config            sqlite3_api->vtab_config
4900ea2517cSdan #define sqlite3_vtab_on_conflict       sqlite3_api->vtab_on_conflict
4914207a3fbSdrh /* Version 3.7.16 and later */
4924207a3fbSdrh #define sqlite3_close_v2               sqlite3_api->close_v2
4934207a3fbSdrh #define sqlite3_db_filename            sqlite3_api->db_filename
4944207a3fbSdrh #define sqlite3_db_readonly            sqlite3_api->db_readonly
4954207a3fbSdrh #define sqlite3_db_release_memory      sqlite3_api->db_release_memory
4964207a3fbSdrh #define sqlite3_errstr                 sqlite3_api->errstr
4974207a3fbSdrh #define sqlite3_stmt_busy              sqlite3_api->stmt_busy
4984207a3fbSdrh #define sqlite3_stmt_readonly          sqlite3_api->stmt_readonly
4994207a3fbSdrh #define sqlite3_stricmp                sqlite3_api->stricmp
5004207a3fbSdrh #define sqlite3_uri_boolean            sqlite3_api->uri_boolean
5014207a3fbSdrh #define sqlite3_uri_int64              sqlite3_api->uri_int64
5024207a3fbSdrh #define sqlite3_uri_parameter          sqlite3_api->uri_parameter
5034207a3fbSdrh #define sqlite3_uri_vsnprintf          sqlite3_api->vsnprintf
5044207a3fbSdrh #define sqlite3_wal_checkpoint_v2      sqlite3_api->wal_checkpoint_v2
5050807cc2cSdrh /* Version 3.8.7 and later */
5060807cc2cSdrh #define sqlite3_auto_extension         sqlite3_api->auto_extension
5070807cc2cSdrh #define sqlite3_bind_blob64            sqlite3_api->bind_blob64
508bbf483f8Sdrh #define sqlite3_bind_text64            sqlite3_api->bind_text64
5090807cc2cSdrh #define sqlite3_cancel_auto_extension  sqlite3_api->cancel_auto_extension
5100807cc2cSdrh #define sqlite3_load_extension         sqlite3_api->load_extension
5110807cc2cSdrh #define sqlite3_malloc64               sqlite3_api->malloc64
5120807cc2cSdrh #define sqlite3_msize                  sqlite3_api->msize
5130807cc2cSdrh #define sqlite3_realloc64              sqlite3_api->realloc64
5140807cc2cSdrh #define sqlite3_reset_auto_extension   sqlite3_api->reset_auto_extension
5150807cc2cSdrh #define sqlite3_result_blob64          sqlite3_api->result_blob64
516bbf483f8Sdrh #define sqlite3_result_text64          sqlite3_api->result_text64
5170807cc2cSdrh #define sqlite3_strglob                sqlite3_api->strglob
5184f03f413Sdrh /* Version 3.8.11 and later */
5194f03f413Sdrh #define sqlite3_value_dup              sqlite3_api->value_dup
5204f03f413Sdrh #define sqlite3_value_free             sqlite3_api->value_free
521a4d5ae8fSdan #define sqlite3_result_zeroblob64      sqlite3_api->result_zeroblob64
52280c03022Sdan #define sqlite3_bind_zeroblob64        sqlite3_api->bind_zeroblob64
52358a8a923Sdrh /* Version 3.9.0 and later */
524cf94f179Sdrh #define sqlite3_value_subtype          sqlite3_api->value_subtype
525cf94f179Sdrh #define sqlite3_result_subtype         sqlite3_api->result_subtype
5268b4a94adSdrh /* Version 3.10.0 and later */
5277be53fe4Sdrh #define sqlite3_status64               sqlite3_api->status64
5288b4a94adSdrh #define sqlite3_strlike                sqlite3_api->strlike
5297be53fe4Sdrh #define sqlite3_db_cacheflush          sqlite3_api->db_cacheflush
5301b9f2141Sdrh /* Version 3.12.0 and later */
5311b9f2141Sdrh #define sqlite3_system_errno           sqlite3_api->system_errno
5323d2a529dSdrh /* Version 3.14.0 and later */
5333d2a529dSdrh #define sqlite3_trace_v2               sqlite3_api->trace_v2
534*fca760c8Sdrh #define sqlite3_expanded_sql           sqlite3_api->expanded_sql
5350c275088Sdrh #endif /* !defined(SQLITE_CORE) && !defined(SQLITE_OMIT_LOAD_EXTENSION) */
5361e397f8fSdrh 
5370c275088Sdrh #if !defined(SQLITE_CORE) && !defined(SQLITE_OMIT_LOAD_EXTENSION)
53808ef8d73Sdrh   /* This case when the file really is being compiled as a loadable
53908ef8d73Sdrh   ** extension */
54063703a42Sdanielk1977 # define SQLITE_EXTENSION_INIT1     const sqlite3_api_routines *sqlite3_api=0;
5411e397f8fSdrh # define SQLITE_EXTENSION_INIT2(v)  sqlite3_api=v;
542049d487eSmistachkin # define SQLITE_EXTENSION_INIT3     \
543049d487eSmistachkin     extern const sqlite3_api_routines *sqlite3_api;
54408ef8d73Sdrh #else
54508ef8d73Sdrh   /* This case when the file is being statically linked into the
54608ef8d73Sdrh   ** application */
54708ef8d73Sdrh # define SQLITE_EXTENSION_INIT1     /*no-op*/
54808ef8d73Sdrh # define SQLITE_EXTENSION_INIT2(v)  (void)v; /* unused parameter */
549049d487eSmistachkin # define SQLITE_EXTENSION_INIT3     /*no-op*/
55008ef8d73Sdrh #endif
5511e397f8fSdrh 
55243f58d6aSdrh #endif /* SQLITE3EXT_H */
553