/ Hex Artifact Content
Login

Artifact 5c20a5afeb154e68d62ed6d9c634add1b21387fd:


0000: 2f 2a 0a 2a 2a 20 32 30 30 36 20 4a 75 6e 65 20  /*.** 2006 June 
0010: 37 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  7.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f  .** This file co
0180: 6e 74 61 69 6e 73 20 63 6f 64 65 20 75 73 65 64  ntains code used
0190: 20 74 6f 20 64 79 6e 61 6d 69 63 61 6c 6c 79 20   to dynamically 
01a0: 6c 6f 61 64 20 65 78 74 65 6e 73 69 6f 6e 73 20  load extensions 
01b0: 69 6e 74 6f 0a 2a 2a 20 74 68 65 20 53 51 4c 69  into.** the SQLi
01c0: 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a 2f 0a 0a  te library..*/..
01d0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 43  #ifndef SQLITE_C
01e0: 4f 52 45 0a 20 20 23 64 65 66 69 6e 65 20 53 51  ORE.  #define SQ
01f0: 4c 49 54 45 5f 43 4f 52 45 20 31 20 20 2f 2a 20  LITE_CORE 1  /* 
0200: 44 69 73 61 62 6c 65 20 74 68 65 20 41 50 49 20  Disable the API 
0210: 72 65 64 65 66 69 6e 69 74 69 6f 6e 20 69 6e 20  redefinition in 
0220: 73 71 6c 69 74 65 33 65 78 74 2e 68 20 2a 2f 0a  sqlite3ext.h */.
0230: 23 65 6e 64 69 66 0a 23 69 6e 63 6c 75 64 65 20  #endif.#include 
0240: 22 73 71 6c 69 74 65 33 65 78 74 2e 68 22 0a 23  "sqlite3ext.h".#
0250: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49  include "sqliteI
0260: 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 3c  nt.h".#include <
0270: 73 74 72 69 6e 67 2e 68 3e 0a 23 69 6e 63 6c 75  string.h>.#inclu
0280: 64 65 20 3c 63 74 79 70 65 2e 68 3e 0a 0a 23 69  de <ctype.h>..#i
0290: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
02a0: 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e  T_LOAD_EXTENSION
02b0: 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 20 41 50 49  ../*.** Some API
02c0: 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 6f 6d   routines are om
02d0: 69 74 74 65 64 20 77 68 65 6e 20 76 61 72 69 6f  itted when vario
02e0: 75 73 20 66 65 61 74 75 72 65 73 20 61 72 65 0a  us features are.
02f0: 2a 2a 20 65 78 63 6c 75 64 65 64 20 66 72 6f 6d  ** excluded from
0300: 20 61 20 62 75 69 6c 64 20 6f 66 20 53 51 4c 69   a build of SQLi
0310: 74 65 2e 20 20 53 75 62 73 74 69 74 75 74 65 20  te.  Substitute 
0320: 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 0a 2a  a NULL pointer.*
0330: 2a 20 66 6f 72 20 61 6e 79 20 6d 69 73 73 69 6e  * for any missin
0340: 67 20 41 50 49 73 2e 0a 2a 2f 0a 23 69 66 6e 64  g APIs..*/.#ifnd
0350: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45  ef SQLITE_ENABLE
0360: 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41  _COLUMN_METADATA
0370: 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65  .# define sqlite
0380: 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73  3_column_databas
0390: 65 5f 6e 61 6d 65 20 20 20 30 0a 23 20 64 65 66  e_name   0.# def
03a0: 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ine sqlite3_colu
03b0: 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65  mn_database_name
03c0: 31 36 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71  16 0.# define sq
03d0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62  lite3_column_tab
03e0: 6c 65 5f 6e 61 6d 65 20 20 20 20 20 20 30 0a 23  le_name      0.#
03f0: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f   define sqlite3_
0400: 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d  column_table_nam
0410: 65 31 36 20 20 20 20 30 0a 23 20 64 65 66 69 6e  e16    0.# defin
0420: 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  e sqlite3_column
0430: 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 20 20 20 20  _origin_name    
0440: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69   0.# define sqli
0450: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69  te3_column_origi
0460: 6e 5f 6e 61 6d 65 31 36 20 20 20 30 0a 23 20 64  n_name16   0.# d
0470: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 74 61  efine sqlite3_ta
0480: 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64  ble_column_metad
0490: 61 74 61 20 20 30 0a 23 65 6e 64 69 66 0a 0a 23  ata  0.#endif..#
04a0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  ifdef SQLITE_OMI
04b0: 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a  T_AUTHORIZATION.
04c0: 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  # define sqlite3
04d0: 5f 73 65 74 5f 61 75 74 68 6f 72 69 7a 65 72 20  _set_authorizer 
04e0: 20 20 20 20 20 20 20 20 30 0a 23 65 6e 64 69 66          0.#endif
04f0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
0500: 4f 4d 49 54 5f 55 54 46 31 36 0a 23 20 64 65 66  OMIT_UTF16.# def
0510: 69 6e 65 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  ine sqlite3_bind
0520: 5f 74 65 78 74 31 36 20 20 20 20 20 20 20 20 20  _text16         
0530: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71     0.# define sq
0540: 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f  lite3_collation_
0550: 6e 65 65 64 65 64 31 36 20 20 20 20 20 30 0a 23  needed16     0.#
0560: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f   define sqlite3_
0570: 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31  column_decltype1
0580: 36 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e  6      0.# defin
0590: 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  e sqlite3_column
05a0: 5f 6e 61 6d 65 31 36 20 20 20 20 20 20 20 20 20  _name16         
05b0: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69   0.# define sqli
05c0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31  te3_column_text1
05d0: 36 20 20 20 20 20 20 20 20 20 20 30 0a 23 20 64  6          0.# d
05e0: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f  efine sqlite3_co
05f0: 6d 70 6c 65 74 65 31 36 20 20 20 20 20 20 20 20  mplete16        
0600: 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20       0.# define 
0610: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63  sqlite3_create_c
0620: 6f 6c 6c 61 74 69 6f 6e 31 36 20 20 20 20 20 30  ollation16     0
0630: 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65  .# define sqlite
0640: 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f  3_create_functio
0650: 6e 31 36 20 20 20 20 20 20 30 0a 23 20 64 65 66  n16      0.# def
0660: 69 6e 65 20 73 71 6c 69 74 65 33 5f 65 72 72 6d  ine sqlite3_errm
0670: 73 67 31 36 20 20 20 20 20 20 20 20 20 20 20 20  sg16            
0680: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71     0.# define sq
0690: 6c 69 74 65 33 5f 6f 70 65 6e 31 36 20 20 20 20  lite3_open16    
06a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 23               0.#
06b0: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f   define sqlite3_
06c0: 70 72 65 70 61 72 65 31 36 20 20 20 20 20 20 20  prepare16       
06d0: 20 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e         0.# defin
06e0: 65 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72  e sqlite3_prepar
06f0: 65 31 36 5f 76 32 20 20 20 20 20 20 20 20 20 20  e16_v2          
0700: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69   0.# define sqli
0710: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72  te3_result_error
0720: 31 36 20 20 20 20 20 20 20 20 20 30 0a 23 20 64  16         0.# d
0730: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 72 65  efine sqlite3_re
0740: 73 75 6c 74 5f 74 65 78 74 31 36 20 20 20 20 20  sult_text16     
0750: 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20       0.# define 
0760: 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74  sqlite3_result_t
0770: 65 78 74 31 36 62 65 20 20 20 20 20 20 20 20 30  ext16be        0
0780: 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65  .# define sqlite
0790: 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 6c  3_result_text16l
07a0: 65 20 20 20 20 20 20 20 20 30 0a 23 20 64 65 66  e        0.# def
07b0: 69 6e 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  ine sqlite3_valu
07c0: 65 5f 74 65 78 74 31 36 20 20 20 20 20 20 20 20  e_text16        
07d0: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71     0.# define sq
07e0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74  lite3_value_text
07f0: 31 36 62 65 20 20 20 20 20 20 20 20 20 30 0a 23  16be         0.#
0800: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f   define sqlite3_
0810: 76 61 6c 75 65 5f 74 65 78 74 31 36 6c 65 20 20  value_text16le  
0820: 20 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e         0.# defin
0830: 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  e sqlite3_column
0840: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 36  _database_name16
0850: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69   0.# define sqli
0860: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65  te3_column_table
0870: 5f 6e 61 6d 65 31 36 20 20 20 20 30 0a 23 20 64  _name16    0.# d
0880: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f  efine sqlite3_co
0890: 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65  lumn_origin_name
08a0: 31 36 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 23  16   0.#endif..#
08b0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  ifdef SQLITE_OMI
08c0: 54 5f 43 4f 4d 50 4c 45 54 45 0a 23 20 64 65 66  T_COMPLETE.# def
08d0: 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70  ine sqlite3_comp
08e0: 6c 65 74 65 20 30 0a 23 20 64 65 66 69 6e 65 20  lete 0.# define 
08f0: 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65  sqlite3_complete
0900: 31 36 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66  16 0.#endif..#if
0910: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
0920: 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43  PROGRESS_CALLBAC
0930: 4b 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74  K.# define sqlit
0940: 65 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64  e3_progress_hand
0950: 6c 65 72 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69  ler 0.#endif..#i
0960: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  fdef SQLITE_OMIT
0970: 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 23 20  _VIRTUALTABLE.# 
0980: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63  define sqlite3_c
0990: 72 65 61 74 65 5f 6d 6f 64 75 6c 65 20 30 0a 23  reate_module 0.#
09a0: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f   define sqlite3_
09b0: 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 5f 76 32  create_module_v2
09c0: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69   0.# define sqli
09d0: 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 62  te3_declare_vtab
09e0: 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65   0.#endif..#ifde
09f0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48  f SQLITE_OMIT_SH
0a00: 41 52 45 44 5f 43 41 43 48 45 0a 23 20 64 65 66  ARED_CACHE.# def
0a10: 69 6e 65 20 73 71 6c 69 74 65 33 5f 65 6e 61 62  ine sqlite3_enab
0a20: 6c 65 5f 73 68 61 72 65 64 5f 63 61 63 68 65 20  le_shared_cache 
0a30: 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66  0.#endif..#ifdef
0a40: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41   SQLITE_OMIT_TRA
0a50: 43 45 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69  CE.# define sqli
0a60: 74 65 33 5f 70 72 6f 66 69 6c 65 20 20 20 20 20  te3_profile     
0a70: 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c    0.# define sql
0a80: 69 74 65 33 5f 74 72 61 63 65 20 20 20 20 20 20  ite3_trace      
0a90: 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66     0.#endif..#if
0aa0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
0ab0: 47 45 54 5f 54 41 42 4c 45 0a 23 20 64 65 66 69  GET_TABLE.# defi
0ac0: 6e 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 5f  ne sqlite3_free_
0ad0: 74 61 62 6c 65 20 20 20 20 30 0a 23 20 64 65 66  table    0.# def
0ae0: 69 6e 65 20 73 71 6c 69 74 65 33 5f 67 65 74 5f  ine sqlite3_get_
0af0: 74 61 62 6c 65 20 20 20 20 20 30 0a 23 65 6e 64  table     0.#end
0b00: 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54  if..#ifdef SQLIT
0b10: 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a  E_OMIT_INCRBLOB.
0b20: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f  #define sqlite3_
0b30: 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 20 20 30  bind_zeroblob  0
0b40: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33  .#define sqlite3
0b50: 5f 62 6c 6f 62 5f 62 79 74 65 73 20 20 20 20 20  _blob_bytes     
0b60: 30 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65  0.#define sqlite
0b70: 33 5f 62 6c 6f 62 5f 63 6c 6f 73 65 20 20 20 20  3_blob_close    
0b80: 20 30 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74   0.#define sqlit
0b90: 65 33 5f 62 6c 6f 62 5f 6f 70 65 6e 20 20 20 20  e3_blob_open    
0ba0: 20 20 30 0a 23 64 65 66 69 6e 65 20 73 71 6c 69    0.#define sqli
0bb0: 74 65 33 5f 62 6c 6f 62 5f 72 65 61 64 20 20 20  te3_blob_read   
0bc0: 20 20 20 30 0a 23 64 65 66 69 6e 65 20 73 71 6c     0.#define sql
0bd0: 69 74 65 33 5f 62 6c 6f 62 5f 77 72 69 74 65 20  ite3_blob_write 
0be0: 20 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a      0.#endif../*
0bf0: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  .** The followin
0c00: 67 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74  g structure cont
0c10: 61 69 6e 73 20 70 6f 69 6e 74 65 72 73 20 74 6f  ains pointers to
0c20: 20 61 6c 6c 20 53 51 4c 69 74 65 20 41 50 49 20   all SQLite API 
0c30: 72 6f 75 74 69 6e 65 73 2e 0a 2a 2a 20 41 20 70  routines..** A p
0c40: 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73  ointer to this s
0c50: 74 72 75 63 74 75 72 65 20 69 73 20 70 61 73 73  tructure is pass
0c60: 65 64 20 69 6e 74 6f 20 65 78 74 65 6e 73 69 6f  ed into extensio
0c70: 6e 73 20 77 68 65 6e 20 74 68 65 79 20 61 72 65  ns when they are
0c80: 0a 2a 2a 20 6c 6f 61 64 65 64 20 73 6f 20 74 68  .** loaded so th
0c90: 61 74 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e  at the extension
0ca0: 20 63 61 6e 20 6d 61 6b 65 20 63 61 6c 6c 73 20   can make calls 
0cb0: 62 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 53 51  back into the SQ
0cc0: 4c 69 74 65 0a 2a 2a 20 6c 69 62 72 61 72 79 2e  Lite.** library.
0cd0: 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 64 64 69  .**.** When addi
0ce0: 6e 67 20 6e 65 77 20 41 50 49 73 2c 20 61 64 64  ng new APIs, add
0cf0: 20 74 68 65 6d 20 74 6f 20 74 68 65 20 62 6f 74   them to the bot
0d00: 74 6f 6d 20 6f 66 20 74 68 69 73 20 73 74 72 75  tom of this stru
0d10: 63 74 75 72 65 0a 2a 2a 20 69 6e 20 6f 72 64 65  cture.** in orde
0d20: 72 20 74 6f 20 70 72 65 73 65 72 76 65 20 62 61  r to preserve ba
0d30: 63 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62  ckwards compatib
0d40: 69 6c 69 74 79 2e 0a 2a 2a 0a 2a 2a 20 45 78 74  ility..**.** Ext
0d50: 65 6e 73 69 6f 6e 73 20 74 68 61 74 20 75 73 65  ensions that use
0d60: 20 6e 65 77 65 72 20 41 50 49 73 20 73 68 6f 75   newer APIs shou
0d70: 6c 64 20 66 69 72 73 74 20 63 61 6c 6c 20 74 68  ld first call th
0d80: 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6c 69 62  e.** sqlite3_lib
0d90: 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 29  version_number()
0da0: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68   to make sure th
0db0: 61 74 20 74 68 65 20 41 50 49 20 74 68 65 79 0a  at the API they.
0dc0: 2a 2a 20 69 6e 74 65 6e 64 20 74 6f 20 75 73 65  ** intend to use
0dd0: 20 69 73 20 73 75 70 70 6f 72 74 65 64 20 62 79   is supported by
0de0: 20 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 45   the library.  E
0df0: 78 74 65 6e 73 69 6f 6e 73 20 73 68 6f 75 6c 64  xtensions should
0e00: 0a 2a 2a 20 61 6c 73 6f 20 63 68 65 63 6b 20 74  .** also check t
0e10: 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74  o make sure that
0e20: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20   the pointer to 
0e30: 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 0a  the function is.
0e40: 2a 2a 20 6e 6f 74 20 4e 55 4c 4c 20 62 65 66 6f  ** not NULL befo
0e50: 72 65 20 63 61 6c 6c 69 6e 67 20 69 74 2e 0a 2a  re calling it..*
0e60: 2f 0a 73 74 61 74 69 63 20 63 6f 6e 73 74 20 73  /.static const s
0e70: 71 6c 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69  qlite3_api_routi
0e80: 6e 65 73 20 73 71 6c 69 74 65 33 41 70 69 73 20  nes sqlite3Apis 
0e90: 3d 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f 61 67  = {.  sqlite3_ag
0ea0: 67 72 65 67 61 74 65 5f 63 6f 6e 74 65 78 74 2c  gregate_context,
0eb0: 0a 20 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65  .  sqlite3_aggre
0ec0: 67 61 74 65 5f 63 6f 75 6e 74 2c 0a 20 20 73 71  gate_count,.  sq
0ed0: 6c 69 74 65 33 5f 62 69 6e 64 5f 62 6c 6f 62 2c  lite3_bind_blob,
0ee0: 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f  .  sqlite3_bind_
0ef0: 64 6f 75 62 6c 65 2c 0a 20 20 73 71 6c 69 74 65  double,.  sqlite
0f00: 33 5f 62 69 6e 64 5f 69 6e 74 2c 0a 20 20 73 71  3_bind_int,.  sq
0f10: 6c 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 36 34  lite3_bind_int64
0f20: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  ,.  sqlite3_bind
0f30: 5f 6e 75 6c 6c 2c 0a 20 20 73 71 6c 69 74 65 33  _null,.  sqlite3
0f40: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f  _bind_parameter_
0f50: 63 6f 75 6e 74 2c 0a 20 20 73 71 6c 69 74 65 33  count,.  sqlite3
0f60: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f  _bind_parameter_
0f70: 69 6e 64 65 78 2c 0a 20 20 73 71 6c 69 74 65 33  index,.  sqlite3
0f80: 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74 65 72 5f  _bind_parameter_
0f90: 6e 61 6d 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f  name,.  sqlite3_
0fa0: 62 69 6e 64 5f 74 65 78 74 2c 0a 20 20 73 71 6c  bind_text,.  sql
0fb0: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 31 36  ite3_bind_text16
0fc0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  ,.  sqlite3_bind
0fd0: 5f 76 61 6c 75 65 2c 0a 20 20 73 71 6c 69 74 65  _value,.  sqlite
0fe0: 33 5f 62 75 73 79 5f 68 61 6e 64 6c 65 72 2c 0a  3_busy_handler,.
0ff0: 20 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 74    sqlite3_busy_t
1000: 69 6d 65 6f 75 74 2c 0a 20 20 73 71 6c 69 74 65  imeout,.  sqlite
1010: 33 5f 63 68 61 6e 67 65 73 2c 0a 20 20 73 71 6c  3_changes,.  sql
1020: 69 74 65 33 5f 63 6c 6f 73 65 2c 0a 20 20 73 71  ite3_close,.  sq
1030: 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f  lite3_collation_
1040: 6e 65 65 64 65 64 2c 0a 20 20 73 71 6c 69 74 65  needed,.  sqlite
1050: 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64  3_collation_need
1060: 65 64 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f  ed16,.  sqlite3_
1070: 63 6f 6c 75 6d 6e 5f 62 6c 6f 62 2c 0a 20 20 73  column_blob,.  s
1080: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79  qlite3_column_by
1090: 74 65 73 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63  tes,.  sqlite3_c
10a0: 6f 6c 75 6d 6e 5f 62 79 74 65 73 31 36 2c 0a 20  olumn_bytes16,. 
10b0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
10c0: 63 6f 75 6e 74 2c 0a 20 20 73 71 6c 69 74 65 33  count,.  sqlite3
10d0: 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65  _column_database
10e0: 5f 6e 61 6d 65 2c 0a 20 20 73 71 6c 69 74 65 33  _name,.  sqlite3
10f0: 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65  _column_database
1100: 5f 6e 61 6d 65 31 36 2c 0a 20 20 73 71 6c 69 74  _name16,.  sqlit
1110: 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79  e3_column_declty
1120: 70 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f  pe,.  sqlite3_co
1130: 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 2c  lumn_decltype16,
1140: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d  .  sqlite3_colum
1150: 6e 5f 64 6f 75 62 6c 65 2c 0a 20 20 73 71 6c 69  n_double,.  sqli
1160: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 2c 0a  te3_column_int,.
1170: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e    sqlite3_column
1180: 5f 69 6e 74 36 34 2c 0a 20 20 73 71 6c 69 74 65  _int64,.  sqlite
1190: 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 2c 0a 20  3_column_name,. 
11a0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
11b0: 6e 61 6d 65 31 36 2c 0a 20 20 73 71 6c 69 74 65  name16,.  sqlite
11c0: 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f  3_column_origin_
11d0: 6e 61 6d 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f  name,.  sqlite3_
11e0: 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61  column_origin_na
11f0: 6d 65 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f  me16,.  sqlite3_
1200: 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d  column_table_nam
1210: 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c  e,.  sqlite3_col
1220: 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 31 36  umn_table_name16
1230: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ,.  sqlite3_colu
1240: 6d 6e 5f 74 65 78 74 2c 0a 20 20 73 71 6c 69 74  mn_text,.  sqlit
1250: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36  e3_column_text16
1260: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ,.  sqlite3_colu
1270: 6d 6e 5f 74 79 70 65 2c 0a 20 20 73 71 6c 69 74  mn_type,.  sqlit
1280: 65 33 5f 63 6f 6c 75 6d 6e 5f 76 61 6c 75 65 2c  e3_column_value,
1290: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69  .  sqlite3_commi
12a0: 74 5f 68 6f 6f 6b 2c 0a 20 20 73 71 6c 69 74 65  t_hook,.  sqlite
12b0: 33 5f 63 6f 6d 70 6c 65 74 65 2c 0a 20 20 73 71  3_complete,.  sq
12c0: 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 31 36  lite3_complete16
12d0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61  ,.  sqlite3_crea
12e0: 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 2c 0a 20 20  te_collation,.  
12f0: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63  sqlite3_create_c
1300: 6f 6c 6c 61 74 69 6f 6e 31 36 2c 0a 20 20 73 71  ollation16,.  sq
1310: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e  lite3_create_fun
1320: 63 74 69 6f 6e 2c 0a 20 20 73 71 6c 69 74 65 33  ction,.  sqlite3
1330: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e  _create_function
1340: 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 72  16,.  sqlite3_cr
1350: 65 61 74 65 5f 6d 6f 64 75 6c 65 2c 0a 20 20 73  eate_module,.  s
1360: 71 6c 69 74 65 33 5f 64 61 74 61 5f 63 6f 75 6e  qlite3_data_coun
1370: 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 64 62 5f  t,.  sqlite3_db_
1380: 68 61 6e 64 6c 65 2c 0a 20 20 73 71 6c 69 74 65  handle,.  sqlite
1390: 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 62 2c 0a  3_declare_vtab,.
13a0: 20 20 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65    sqlite3_enable
13b0: 5f 73 68 61 72 65 64 5f 63 61 63 68 65 2c 0a 20  _shared_cache,. 
13c0: 20 73 71 6c 69 74 65 33 5f 65 72 72 63 6f 64 65   sqlite3_errcode
13d0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 65 72 72 6d  ,.  sqlite3_errm
13e0: 73 67 2c 0a 20 20 73 71 6c 69 74 65 33 5f 65 72  sg,.  sqlite3_er
13f0: 72 6d 73 67 31 36 2c 0a 20 20 73 71 6c 69 74 65  rmsg16,.  sqlite
1400: 33 5f 65 78 65 63 2c 0a 20 20 73 71 6c 69 74 65  3_exec,.  sqlite
1410: 33 5f 65 78 70 69 72 65 64 2c 0a 20 20 73 71 6c  3_expired,.  sql
1420: 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 2c 0a 20  ite3_finalize,. 
1430: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 2c 0a 20   sqlite3_free,. 
1440: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 5f 74 61   sqlite3_free_ta
1450: 62 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 67  ble,.  sqlite3_g
1460: 65 74 5f 61 75 74 6f 63 6f 6d 6d 69 74 2c 0a 20  et_autocommit,. 
1470: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 78   sqlite3_get_aux
1480: 64 61 74 61 2c 0a 20 20 73 71 6c 69 74 65 33 5f  data,.  sqlite3_
1490: 67 65 74 5f 74 61 62 6c 65 2c 0a 20 20 30 2c 20  get_table,.  0, 
14a0: 20 20 20 20 2f 2a 20 57 61 73 20 73 71 6c 69 74      /* Was sqlit
14b0: 65 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76 65  e3_global_recove
14c0: 72 28 29 2c 20 62 75 74 20 74 68 61 74 20 66 75  r(), but that fu
14d0: 6e 63 74 69 6f 6e 20 69 73 20 64 65 70 72 65 63  nction is deprec
14e0: 61 74 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65  ated */.  sqlite
14f0: 33 5f 69 6e 74 65 72 72 75 70 74 2c 0a 20 20 73  3_interrupt,.  s
1500: 71 6c 69 74 65 33 5f 6c 61 73 74 5f 69 6e 73 65  qlite3_last_inse
1510: 72 74 5f 72 6f 77 69 64 2c 0a 20 20 73 71 6c 69  rt_rowid,.  sqli
1520: 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 2c 0a  te3_libversion,.
1530: 20 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 65 72    sqlite3_libver
1540: 73 69 6f 6e 5f 6e 75 6d 62 65 72 2c 0a 20 20 73  sion_number,.  s
1550: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 2c 0a 20  qlite3_malloc,. 
1560: 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66   sqlite3_mprintf
1570: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e  ,.  sqlite3_open
1580: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e  ,.  sqlite3_open
1590: 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 70 72  16,.  sqlite3_pr
15a0: 65 70 61 72 65 2c 0a 20 20 73 71 6c 69 74 65 33  epare,.  sqlite3
15b0: 5f 70 72 65 70 61 72 65 31 36 2c 0a 20 20 73 71  _prepare16,.  sq
15c0: 6c 69 74 65 33 5f 70 72 6f 66 69 6c 65 2c 0a 20  lite3_profile,. 
15d0: 20 73 71 6c 69 74 65 33 5f 70 72 6f 67 72 65 73   sqlite3_progres
15e0: 73 5f 68 61 6e 64 6c 65 72 2c 0a 20 20 73 71 6c  s_handler,.  sql
15f0: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 2c 0a 20 20  ite3_realloc,.  
1600: 73 71 6c 69 74 65 33 5f 72 65 73 65 74 2c 0a 20  sqlite3_reset,. 
1610: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
1620: 62 6c 6f 62 2c 0a 20 20 73 71 6c 69 74 65 33 5f  blob,.  sqlite3_
1630: 72 65 73 75 6c 74 5f 64 6f 75 62 6c 65 2c 0a 20  result_double,. 
1640: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
1650: 65 72 72 6f 72 2c 0a 20 20 73 71 6c 69 74 65 33  error,.  sqlite3
1660: 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 31 36 2c  _result_error16,
1670: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
1680: 74 5f 69 6e 74 2c 0a 20 20 73 71 6c 69 74 65 33  t_int,.  sqlite3
1690: 5f 72 65 73 75 6c 74 5f 69 6e 74 36 34 2c 0a 20  _result_int64,. 
16a0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f   sqlite3_result_
16b0: 6e 75 6c 6c 2c 0a 20 20 73 71 6c 69 74 65 33 5f  null,.  sqlite3_
16c0: 72 65 73 75 6c 74 5f 74 65 78 74 2c 0a 20 20 73  result_text,.  s
16d0: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65  qlite3_result_te
16e0: 78 74 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f  xt16,.  sqlite3_
16f0: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 62 65 2c  result_text16be,
1700: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
1710: 74 5f 74 65 78 74 31 36 6c 65 2c 0a 20 20 73 71  t_text16le,.  sq
1720: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 76 61 6c  lite3_result_val
1730: 75 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 6f  ue,.  sqlite3_ro
1740: 6c 6c 62 61 63 6b 5f 68 6f 6f 6b 2c 0a 20 20 73  llback_hook,.  s
1750: 71 6c 69 74 65 33 5f 73 65 74 5f 61 75 74 68 6f  qlite3_set_autho
1760: 72 69 7a 65 72 2c 0a 20 20 73 71 6c 69 74 65 33  rizer,.  sqlite3
1770: 5f 73 65 74 5f 61 75 78 64 61 74 61 2c 0a 20 20  _set_auxdata,.  
1780: 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66  sqlite3_snprintf
1790: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 65 70  ,.  sqlite3_step
17a0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 74 61 62 6c  ,.  sqlite3_tabl
17b0: 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74  e_column_metadat
17c0: 61 2c 0a 20 20 73 71 6c 69 74 65 33 5f 74 68 72  a,.  sqlite3_thr
17d0: 65 61 64 5f 63 6c 65 61 6e 75 70 2c 0a 20 20 73  ead_cleanup,.  s
17e0: 71 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61  qlite3_total_cha
17f0: 6e 67 65 73 2c 0a 20 20 73 71 6c 69 74 65 33 5f  nges,.  sqlite3_
1800: 74 72 61 63 65 2c 0a 20 20 73 71 6c 69 74 65 33  trace,.  sqlite3
1810: 5f 74 72 61 6e 73 66 65 72 5f 62 69 6e 64 69 6e  _transfer_bindin
1820: 67 73 2c 0a 20 20 73 71 6c 69 74 65 33 5f 75 70  gs,.  sqlite3_up
1830: 64 61 74 65 5f 68 6f 6f 6b 2c 0a 20 20 73 71 6c  date_hook,.  sql
1840: 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61 2c 0a  ite3_user_data,.
1850: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f    sqlite3_value_
1860: 62 6c 6f 62 2c 0a 20 20 73 71 6c 69 74 65 33 5f  blob,.  sqlite3_
1870: 76 61 6c 75 65 5f 62 79 74 65 73 2c 0a 20 20 73  value_bytes,.  s
1880: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74  qlite3_value_byt
1890: 65 73 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f  es16,.  sqlite3_
18a0: 76 61 6c 75 65 5f 64 6f 75 62 6c 65 2c 0a 20 20  value_double,.  
18b0: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
18c0: 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  t,.  sqlite3_val
18d0: 75 65 5f 69 6e 74 36 34 2c 0a 20 20 73 71 6c 69  ue_int64,.  sqli
18e0: 74 65 33 5f 76 61 6c 75 65 5f 6e 75 6d 65 72 69  te3_value_numeri
18f0: 63 5f 74 79 70 65 2c 0a 20 20 73 71 6c 69 74 65  c_type,.  sqlite
1900: 33 5f 76 61 6c 75 65 5f 74 65 78 74 2c 0a 20 20  3_value_text,.  
1910: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65  sqlite3_value_te
1920: 78 74 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f  xt16,.  sqlite3_
1930: 76 61 6c 75 65 5f 74 65 78 74 31 36 62 65 2c 0a  value_text16be,.
1940: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f    sqlite3_value_
1950: 74 65 78 74 31 36 6c 65 2c 0a 20 20 73 71 6c 69  text16le,.  sqli
1960: 74 65 33 5f 76 61 6c 75 65 5f 74 79 70 65 2c 0a  te3_value_type,.
1970: 20 20 73 71 6c 69 74 65 33 5f 76 6d 70 72 69 6e    sqlite3_vmprin
1980: 74 66 2c 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68  tf,.  /*.  ** Th
1990: 65 20 6f 72 69 67 69 6e 61 6c 20 41 50 49 20 73  e original API s
19a0: 65 74 20 65 6e 64 73 20 68 65 72 65 2e 20 20 41  et ends here.  A
19b0: 6c 6c 20 65 78 74 65 6e 73 69 6f 6e 73 20 63 61  ll extensions ca
19c0: 6e 20 63 61 6c 6c 20 61 6e 79 0a 20 20 2a 2a 20  n call any.  ** 
19d0: 6f 66 20 74 68 65 20 41 50 49 73 20 61 62 6f 76  of the APIs abov
19e0: 65 20 70 72 6f 76 69 64 65 64 20 74 68 61 74 20  e provided that 
19f0: 74 68 65 20 70 6f 69 6e 74 65 72 20 69 73 20 6e  the pointer is n
1a00: 6f 74 20 4e 55 4c 4c 2e 20 20 42 75 74 0a 20 20  ot NULL.  But.  
1a10: 2a 2a 20 62 65 66 6f 72 65 20 63 61 6c 6c 69 6e  ** before callin
1a20: 67 20 41 50 49 73 20 74 68 61 74 20 66 6f 6c 6c  g APIs that foll
1a30: 6f 77 2c 20 65 78 74 65 6e 73 69 6f 6e 20 73 68  ow, extension sh
1a40: 6f 75 6c 64 20 63 68 65 63 6b 20 74 68 65 0a 20  ould check the. 
1a50: 20 2a 2a 20 73 71 6c 69 74 65 33 5f 6c 69 62 76   ** sqlite3_libv
1a60: 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 29 20  ersion_number() 
1a70: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 65  to make sure the
1a80: 79 20 61 72 65 20 64 65 61 6c 69 6e 67 20 77 69  y are dealing wi
1a90: 74 68 0a 20 20 2a 2a 20 61 20 6c 69 62 72 61 72  th.  ** a librar
1aa0: 79 20 74 68 61 74 20 69 73 20 6e 65 77 20 65 6e  y that is new en
1ab0: 6f 75 67 68 20 74 6f 20 73 75 70 70 6f 72 74 20  ough to support 
1ac0: 74 68 61 74 20 41 50 49 2e 0a 20 20 2a 2a 2a 2a  that API..  ****
1ad0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1ae0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1af0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1b00: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
1b10: 2a 2a 2a 2a 2a 0a 20 20 2a 2f 0a 20 20 73 71 6c  *****.  */.  sql
1b20: 69 74 65 33 5f 6f 76 65 72 6c 6f 61 64 5f 66 75  ite3_overload_fu
1b30: 6e 63 74 69 6f 6e 2c 0a 0a 20 20 2f 2a 0a 20 20  nction,..  /*.  
1b40: 2a 2a 20 41 64 64 65 64 20 61 66 74 65 72 20 33  ** Added after 3
1b50: 2e 33 2e 31 33 0a 20 20 2a 2f 0a 20 20 73 71 6c  .3.13.  */.  sql
1b60: 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 2c  ite3_prepare_v2,
1b70: 0a 20 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  .  sqlite3_prepa
1b80: 72 65 31 36 5f 76 32 2c 0a 20 20 73 71 6c 69 74  re16_v2,.  sqlit
1b90: 65 33 5f 63 6c 65 61 72 5f 62 69 6e 64 69 6e 67  e3_clear_binding
1ba0: 73 2c 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 41 64  s,..  /*.  ** Ad
1bb0: 64 65 64 20 66 6f 72 20 33 2e 34 2e 31 0a 20 20  ded for 3.4.1.  
1bc0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 63 72 65  */.  sqlite3_cre
1bd0: 61 74 65 5f 6d 6f 64 75 6c 65 5f 76 32 2c 0a 0a  ate_module_v2,..
1be0: 20 20 2f 2a 0a 20 20 2a 2a 20 41 64 64 65 64 20    /*.  ** Added 
1bf0: 66 6f 72 20 33 2e 35 2e 30 0a 20 20 2a 2f 0a 20  for 3.5.0.  */. 
1c00: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 7a 65   sqlite3_bind_ze
1c10: 72 6f 62 6c 6f 62 2c 0a 20 20 73 71 6c 69 74 65  roblob,.  sqlite
1c20: 33 5f 62 6c 6f 62 5f 62 79 74 65 73 2c 0a 20 20  3_blob_bytes,.  
1c30: 73 71 6c 69 74 65 33 5f 62 6c 6f 62 5f 63 6c 6f  sqlite3_blob_clo
1c40: 73 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 6c  se,.  sqlite3_bl
1c50: 6f 62 5f 6f 70 65 6e 2c 0a 20 20 73 71 6c 69 74  ob_open,.  sqlit
1c60: 65 33 5f 62 6c 6f 62 5f 72 65 61 64 2c 0a 20 20  e3_blob_read,.  
1c70: 73 71 6c 69 74 65 33 5f 62 6c 6f 62 5f 77 72 69  sqlite3_blob_wri
1c80: 74 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 72  te,.  sqlite3_cr
1c90: 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 76  eate_collation_v
1ca0: 32 2c 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 6c  2,.  sqlite3_fil
1cb0: 65 5f 63 6f 6e 74 72 6f 6c 2c 0a 20 20 73 71 6c  e_control,.  sql
1cc0: 69 74 65 33 5f 6d 65 6d 6f 72 79 5f 68 69 67 68  ite3_memory_high
1cd0: 77 61 74 65 72 2c 0a 20 20 73 71 6c 69 74 65 33  water,.  sqlite3
1ce0: 5f 6d 65 6d 6f 72 79 5f 75 73 65 64 2c 0a 23 69  _memory_used,.#i
1cf0: 66 64 65 66 20 53 51 4c 49 54 45 5f 4d 55 54 45  fdef SQLITE_MUTE
1d00: 58 5f 4e 4f 4f 50 0a 20 20 30 2c 20 0a 20 20 30  X_NOOP.  0, .  0
1d10: 2c 20 0a 20 20 30 2c 0a 20 20 30 2c 0a 20 20 30  , .  0,.  0,.  0
1d20: 2c 0a 23 65 6c 73 65 0a 20 20 73 71 6c 69 74 65  ,.#else.  sqlite
1d30: 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 2c 0a 20  3_mutex_alloc,. 
1d40: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65   sqlite3_mutex_e
1d50: 6e 74 65 72 2c 0a 20 20 73 71 6c 69 74 65 33 5f  nter,.  sqlite3_
1d60: 6d 75 74 65 78 5f 66 72 65 65 2c 0a 20 20 73 71  mutex_free,.  sq
1d70: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
1d80: 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74  e,.  sqlite3_mut
1d90: 65 78 5f 74 72 79 2c 0a 23 65 6e 64 69 66 0a 20  ex_try,.#endif. 
1da0: 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32   sqlite3_open_v2
1db0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 6c 65  ,.  sqlite3_rele
1dc0: 61 73 65 5f 6d 65 6d 6f 72 79 2c 0a 20 20 73 71  ase_memory,.  sq
1dd0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
1de0: 6f 72 5f 6e 6f 6d 65 6d 2c 0a 20 20 73 71 6c 69  or_nomem,.  sqli
1df0: 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72  te3_result_error
1e00: 5f 74 6f 6f 62 69 67 2c 0a 20 20 73 71 6c 69 74  _toobig,.  sqlit
1e10: 65 33 5f 73 6c 65 65 70 2c 0a 20 20 73 71 6c 69  e3_sleep,.  sqli
1e20: 74 65 33 5f 73 6f 66 74 5f 68 65 61 70 5f 6c 69  te3_soft_heap_li
1e30: 6d 69 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  mit,.  sqlite3_v
1e40: 66 73 5f 66 69 6e 64 2c 0a 20 20 73 71 6c 69 74  fs_find,.  sqlit
1e50: 65 33 5f 76 66 73 5f 72 65 67 69 73 74 65 72 2c  e3_vfs_register,
1e60: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 5f 75  .  sqlite3_vfs_u
1e70: 6e 72 65 67 69 73 74 65 72 2c 0a 0a 20 20 2f 2a  nregister,..  /*
1e80: 0a 20 20 2a 2a 20 41 64 64 65 64 20 66 6f 72 20  .  ** Added for 
1e90: 33 2e 35 2e 38 0a 20 20 2a 2f 0a 20 20 73 71 6c  3.5.8.  */.  sql
1ea0: 69 74 65 33 5f 74 68 72 65 61 64 73 61 66 65 2c  ite3_threadsafe,
1eb0: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
1ec0: 74 5f 7a 65 72 6f 62 6c 6f 62 2c 0a 20 20 73 71  t_zeroblob,.  sq
1ed0: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
1ee0: 6f 72 5f 63 6f 64 65 2c 0a 20 20 73 71 6c 69 74  or_code,.  sqlit
1ef0: 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 2c  e3_test_control,
1f00: 0a 20 20 73 71 6c 69 74 65 33 5f 72 61 6e 64 6f  .  sqlite3_rando
1f10: 6d 6e 65 73 73 2c 0a 20 20 73 71 6c 69 74 65 33  mness,.  sqlite3
1f20: 5f 63 6f 6e 74 65 78 74 5f 64 62 5f 68 61 6e 64  _context_db_hand
1f30: 6c 65 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 74  le,.};../*.** At
1f40: 74 65 6d 70 74 20 74 6f 20 6c 6f 61 64 20 61 6e  tempt to load an
1f50: 20 53 51 4c 69 74 65 20 65 78 74 65 6e 73 69 6f   SQLite extensio
1f60: 6e 20 6c 69 62 72 61 72 79 20 63 6f 6e 74 61 69  n library contai
1f70: 6e 65 64 20 69 6e 20 74 68 65 20 66 69 6c 65 0a  ned in the file.
1f80: 2a 2a 20 7a 46 69 6c 65 2e 20 20 54 68 65 20 65  ** zFile.  The e
1f90: 6e 74 72 79 20 70 6f 69 6e 74 20 69 73 20 7a 50  ntry point is zP
1fa0: 72 6f 63 2e 20 20 7a 50 72 6f 63 20 6d 61 79 20  roc.  zProc may 
1fb0: 62 65 20 30 20 69 6e 20 77 68 69 63 68 20 63 61  be 0 in which ca
1fc0: 73 65 20 61 0a 2a 2a 20 64 65 66 61 75 6c 74 20  se a.** default 
1fd0: 65 6e 74 72 79 20 70 6f 69 6e 74 20 6e 61 6d 65  entry point name
1fe0: 20 28 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 73   (sqlite3_extens
1ff0: 69 6f 6e 5f 69 6e 69 74 29 20 69 73 20 75 73 65  ion_init) is use
2000: 64 2e 20 20 55 73 65 0a 2a 2a 20 6f 66 20 74 68  d.  Use.** of th
2010: 65 20 64 65 66 61 75 6c 74 20 6e 61 6d 65 20 69  e default name i
2020: 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 2e 0a 2a  s recommended..*
2030: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49  *.** Return SQLI
2040: 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73  TE_OK on success
2050: 20 61 6e 64 20 53 51 4c 49 54 45 5f 45 52 52 4f   and SQLITE_ERRO
2060: 52 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 67  R if something g
2070: 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2a 0a 2a 2a  oes wrong..**.**
2080: 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63   If an error occ
2090: 75 72 73 20 61 6e 64 20 70 7a 45 72 72 4d 73 67  urs and pzErrMsg
20a0: 20 69 73 20 6e 6f 74 20 30 2c 20 74 68 65 6e 20   is not 0, then 
20b0: 66 69 6c 6c 20 2a 70 7a 45 72 72 4d 73 67 20 77  fill *pzErrMsg w
20c0: 69 74 68 20 0a 2a 2a 20 65 72 72 6f 72 20 6d 65  ith .** error me
20d0: 73 73 61 67 65 20 74 65 78 74 2e 20 20 54 68 65  ssage text.  The
20e0: 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f   calling functio
20f0: 6e 20 73 68 6f 75 6c 64 20 66 72 65 65 20 74 68  n should free th
2100: 69 73 20 6d 65 6d 6f 72 79 0a 2a 2a 20 62 79 20  is memory.** by 
2110: 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 5f  calling sqlite3_
2120: 66 72 65 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69  free()..*/.stati
2130: 63 20 69 6e 74 20 73 71 6c 69 74 65 33 4c 6f 61  c int sqlite3Loa
2140: 64 45 78 74 65 6e 73 69 6f 6e 28 0a 20 20 73 71  dExtension(.  sq
2150: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
2160: 20 20 20 20 2f 2a 20 4c 6f 61 64 20 74 68 65 20      /* Load the 
2170: 65 78 74 65 6e 73 69 6f 6e 20 69 6e 74 6f 20 74  extension into t
2180: 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e  his database con
2190: 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e  nection */.  con
21a0: 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 2c 20  st char *zFile, 
21b0: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68     /* Name of th
21c0: 65 20 73 68 61 72 65 64 20 6c 69 62 72 61 72 79  e shared library
21d0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 78 74 65   containing exte
21e0: 6e 73 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74  nsion */.  const
21f0: 20 63 68 61 72 20 2a 7a 50 72 6f 63 2c 20 20 20   char *zProc,   
2200: 20 2f 2a 20 45 6e 74 72 79 20 70 6f 69 6e 74 2e   /* Entry point.
2210: 20 20 55 73 65 20 22 73 71 6c 69 74 65 33 5f 65    Use "sqlite3_e
2220: 78 74 65 6e 73 69 6f 6e 5f 69 6e 69 74 22 20 69  xtension_init" i
2230: 66 20 30 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  f 0 */.  char **
2240: 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 2f  pzErrMsg       /
2250: 2a 20 50 75 74 20 65 72 72 6f 72 20 6d 65 73 73  * Put error mess
2260: 61 67 65 20 68 65 72 65 20 69 66 20 6e 6f 74 20  age here if not 
2270: 30 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65  0 */.){.  sqlite
2280: 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 64 62  3_vfs *pVfs = db
2290: 2d 3e 70 56 66 73 3b 0a 20 20 76 6f 69 64 20 2a  ->pVfs;.  void *
22a0: 68 61 6e 64 6c 65 3b 0a 20 20 69 6e 74 20 28 2a  handle;.  int (*
22b0: 78 49 6e 69 74 29 28 73 71 6c 69 74 65 33 2a 2c  xInit)(sqlite3*,
22c0: 63 68 61 72 2a 2a 2c 63 6f 6e 73 74 20 73 71 6c  char**,const sql
22d0: 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65  ite3_api_routine
22e0: 73 2a 29 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72  s*);.  char *zEr
22f0: 72 6d 73 67 20 3d 20 30 3b 0a 20 20 76 6f 69 64  rmsg = 0;.  void
2300: 20 2a 2a 61 48 61 6e 64 6c 65 3b 0a 0a 20 20 2f   **aHandle;..  /
2310: 2a 20 54 69 63 6b 65 74 20 23 31 38 36 33 2e 20  * Ticket #1863. 
2320: 20 54 6f 20 61 76 6f 69 64 20 61 20 63 72 65 61   To avoid a crea
2330: 74 69 6e 67 20 73 65 63 75 72 69 74 79 20 70 72  ting security pr
2340: 6f 62 6c 65 6d 73 20 66 6f 72 20 6f 6c 64 65 72  oblems for older
2350: 0a 20 20 2a 2a 20 61 70 70 6c 69 63 61 74 69 6f  .  ** applicatio
2360: 6e 73 20 74 68 61 74 20 72 65 6c 69 6e 6b 20 61  ns that relink a
2370: 67 61 69 6e 73 74 20 6e 65 77 65 72 20 76 65 72  gainst newer ver
2380: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2c  sions of SQLite,
2390: 20 74 68 65 0a 20 20 2a 2a 20 61 62 69 6c 69 74   the.  ** abilit
23a0: 79 20 74 6f 20 72 75 6e 20 6c 6f 61 64 5f 65 78  y to run load_ex
23b0: 74 65 6e 73 69 6f 6e 20 69 73 20 74 75 72 6e 65  tension is turne
23c0: 64 20 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74  d off by default
23d0: 2e 20 20 4f 6e 65 0a 20 20 2a 2a 20 6d 75 73 74  .  One.  ** must
23e0: 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 65 6e   call sqlite3_en
23f0: 61 62 6c 65 5f 6c 6f 61 64 5f 65 78 74 65 6e 73  able_load_extens
2400: 69 6f 6e 28 29 20 74 6f 20 74 75 72 6e 20 6f 6e  ion() to turn on
2410: 20 65 78 74 65 6e 73 69 6f 6e 0a 20 20 2a 2a 20   extension.  ** 
2420: 6c 6f 61 64 69 6e 67 2e 20 20 4f 74 68 65 72 77  loading.  Otherw
2430: 69 73 65 20 79 6f 75 20 67 65 74 20 74 68 65 20  ise you get the 
2440: 66 6f 6c 6c 6f 77 69 6e 67 20 65 72 72 6f 72 2e  following error.
2450: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 64 62 2d  .  */.  if( (db-
2460: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
2470: 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 29 3d 3d  LoadExtension)==
2480: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 7a 45  0 ){.    if( pzE
2490: 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 2a  rrMsg ){.      *
24a0: 70 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74  pzErrMsg = sqlit
24b0: 65 33 5f 6d 70 72 69 6e 74 66 28 22 6e 6f 74 20  e3_mprintf("not 
24c0: 61 75 74 68 6f 72 69 7a 65 64 22 29 3b 0a 20 20  authorized");.  
24d0: 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 53    }.    return S
24e0: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d  QLITE_ERROR;.  }
24f0: 0a 0a 20 20 69 66 28 20 7a 50 72 6f 63 3d 3d 30  ..  if( zProc==0
2500: 20 29 7b 0a 20 20 20 20 7a 50 72 6f 63 20 3d 20   ){.    zProc = 
2510: 22 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 73 69  "sqlite3_extensi
2520: 6f 6e 5f 69 6e 69 74 22 3b 0a 20 20 7d 0a 0a 20  on_init";.  }.. 
2530: 20 68 61 6e 64 6c 65 20 3d 20 73 71 6c 69 74 65   handle = sqlite
2540: 33 4f 73 44 6c 4f 70 65 6e 28 70 56 66 73 2c 20  3OsDlOpen(pVfs, 
2550: 7a 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 68 61  zFile);.  if( ha
2560: 6e 64 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69  ndle==0 ){.    i
2570: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a 20  f( pzErrMsg ){. 
2580: 20 20 20 20 20 63 68 61 72 20 7a 45 72 72 5b 32       char zErr[2
2590: 35 36 5d 3b 0a 20 20 20 20 20 20 7a 45 72 72 5b  56];.      zErr[
25a0: 73 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 5d 20  sizeof(zErr)-1] 
25b0: 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 73 71  = '\0';.      sq
25c0: 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 73  lite3_snprintf(s
25d0: 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 2c 20 7a  izeof(zErr)-1, z
25e0: 45 72 72 2c 20 0a 20 20 20 20 20 20 20 20 20 20  Err, .          
25f0: 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20  "unable to open 
2600: 73 68 61 72 65 64 20 6c 69 62 72 61 72 79 20 5b  shared library [
2610: 25 73 5d 22 2c 20 7a 46 69 6c 65 29 3b 0a 20 20  %s]", zFile);.  
2620: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 45      sqlite3OsDlE
2630: 72 72 6f 72 28 70 56 66 73 2c 20 73 69 7a 65 6f  rror(pVfs, sizeo
2640: 66 28 7a 45 72 72 29 2d 31 2c 20 7a 45 72 72 29  f(zErr)-1, zErr)
2650: 3b 0a 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73  ;.      *pzErrMs
2660: 67 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72  g = sqlite3DbStr
2670: 44 75 70 28 64 62 2c 20 7a 45 72 72 29 3b 0a 20  Dup(db, zErr);. 
2680: 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20     }.    return 
2690: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20  SQLITE_ERROR;.  
26a0: 7d 0a 20 20 78 49 6e 69 74 20 3d 20 28 69 6e 74  }.  xInit = (int
26b0: 28 2a 29 28 73 71 6c 69 74 65 33 2a 2c 63 68 61  (*)(sqlite3*,cha
26c0: 72 2a 2a 2c 63 6f 6e 73 74 20 73 71 6c 69 74 65  r**,const sqlite
26d0: 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65 73 2a 29  3_api_routines*)
26e0: 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ).              
26f0: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c       sqlite3OsDl
2700: 53 79 6d 28 70 56 66 73 2c 20 68 61 6e 64 6c 65  Sym(pVfs, handle
2710: 2c 20 7a 50 72 6f 63 29 3b 0a 20 20 69 66 28 20  , zProc);.  if( 
2720: 78 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20  xInit==0 ){.    
2730: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a  if( pzErrMsg ){.
2740: 20 20 20 20 20 20 63 68 61 72 20 7a 45 72 72 5b        char zErr[
2750: 32 35 36 5d 3b 0a 20 20 20 20 20 20 7a 45 72 72  256];.      zErr
2760: 5b 73 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 5d  [sizeof(zErr)-1]
2770: 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 73   = '\0';.      s
2780: 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28  qlite3_snprintf(
2790: 73 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 2c 20  sizeof(zErr)-1, 
27a0: 7a 45 72 72 2c 0a 20 20 20 20 20 20 20 20 20 20  zErr,.          
27b0: 22 6e 6f 20 65 6e 74 72 79 20 70 6f 69 6e 74 20  "no entry point 
27c0: 5b 25 73 5d 20 69 6e 20 73 68 61 72 65 64 20 6c  [%s] in shared l
27d0: 69 62 72 61 72 79 20 5b 25 73 5d 22 2c 20 7a 50  ibrary [%s]", zP
27e0: 72 6f 63 2c 7a 46 69 6c 65 29 3b 0a 20 20 20 20  roc,zFile);.    
27f0: 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 45 72 72    sqlite3OsDlErr
2800: 6f 72 28 70 56 66 73 2c 20 73 69 7a 65 6f 66 28  or(pVfs, sizeof(
2810: 7a 45 72 72 29 2d 31 2c 20 7a 45 72 72 29 3b 0a  zErr)-1, zErr);.
2820: 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20        *pzErrMsg 
2830: 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72 44 75  = sqlite3DbStrDu
2840: 70 28 64 62 2c 20 7a 45 72 72 29 3b 0a 20 20 20  p(db, zErr);.   
2850: 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 43 6c     sqlite3OsDlCl
2860: 6f 73 65 28 70 56 66 73 2c 20 68 61 6e 64 6c 65  ose(pVfs, handle
2870: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74  );.    }.    ret
2880: 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  urn SQLITE_ERROR
2890: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 78 49  ;.  }else if( xI
28a0: 6e 69 74 28 64 62 2c 20 26 7a 45 72 72 6d 73 67  nit(db, &zErrmsg
28b0: 2c 20 26 73 71 6c 69 74 65 33 41 70 69 73 29 20  , &sqlite3Apis) 
28c0: 29 7b 0a 20 20 20 20 69 66 28 20 70 7a 45 72 72  ){.    if( pzErr
28d0: 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 2a 70 7a  Msg ){.      *pz
28e0: 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33  ErrMsg = sqlite3
28f0: 5f 6d 70 72 69 6e 74 66 28 22 65 72 72 6f 72 20  _mprintf("error 
2900: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a  during initializ
2910: 61 74 69 6f 6e 3a 20 25 73 22 2c 20 7a 45 72 72  ation: %s", zErr
2920: 6d 73 67 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  msg);.    }.    
2930: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 72  sqlite3_free(zEr
2940: 72 6d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74  rmsg);.    sqlit
2950: 65 33 4f 73 44 6c 43 6c 6f 73 65 28 70 56 66 73  e3OsDlClose(pVfs
2960: 2c 20 68 61 6e 64 6c 65 29 3b 0a 20 20 20 20 72  , handle);.    r
2970: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52  eturn SQLITE_ERR
2980: 4f 52 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 70  OR;.  }..  /* Ap
2990: 70 65 6e 64 20 74 68 65 20 6e 65 77 20 73 68 61  pend the new sha
29a0: 72 65 64 20 6c 69 62 72 61 72 79 20 68 61 6e 64  red library hand
29b0: 6c 65 20 74 6f 20 74 68 65 20 64 62 2d 3e 61 45  le to the db->aE
29c0: 78 74 65 6e 73 69 6f 6e 20 61 72 72 61 79 2e 20  xtension array. 
29d0: 2a 2f 0a 20 20 64 62 2d 3e 6e 45 78 74 65 6e 73  */.  db->nExtens
29e0: 69 6f 6e 2b 2b 3b 0a 20 20 61 48 61 6e 64 6c 65  ion++;.  aHandle
29f0: 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   = sqlite3DbMall
2a00: 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65 6f  ocZero(db, sizeo
2a10: 66 28 68 61 6e 64 6c 65 29 2a 64 62 2d 3e 6e 45  f(handle)*db->nE
2a20: 78 74 65 6e 73 69 6f 6e 29 3b 0a 20 20 69 66 28  xtension);.  if(
2a30: 20 61 48 61 6e 64 6c 65 3d 3d 30 20 29 7b 0a 20   aHandle==0 ){. 
2a40: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
2a50: 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66  _NOMEM;.  }.  if
2a60: 28 20 64 62 2d 3e 6e 45 78 74 65 6e 73 69 6f 6e  ( db->nExtension
2a70: 3e 30 20 29 7b 0a 20 20 20 20 6d 65 6d 63 70 79  >0 ){.    memcpy
2a80: 28 61 48 61 6e 64 6c 65 2c 20 64 62 2d 3e 61 45  (aHandle, db->aE
2a90: 78 74 65 6e 73 69 6f 6e 2c 20 73 69 7a 65 6f 66  xtension, sizeof
2aa0: 28 68 61 6e 64 6c 65 29 2a 28 64 62 2d 3e 6e 45  (handle)*(db->nE
2ab0: 78 74 65 6e 73 69 6f 6e 2d 31 29 29 3b 0a 20 20  xtension-1));.  
2ac0: 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65  }.  sqlite3_free
2ad0: 28 64 62 2d 3e 61 45 78 74 65 6e 73 69 6f 6e 29  (db->aExtension)
2ae0: 3b 0a 20 20 64 62 2d 3e 61 45 78 74 65 6e 73 69  ;.  db->aExtensi
2af0: 6f 6e 20 3d 20 61 48 61 6e 64 6c 65 3b 0a 0a 20  on = aHandle;.. 
2b00: 20 64 62 2d 3e 61 45 78 74 65 6e 73 69 6f 6e 5b   db->aExtension[
2b10: 64 62 2d 3e 6e 45 78 74 65 6e 73 69 6f 6e 2d 31  db->nExtension-1
2b20: 5d 20 3d 20 68 61 6e 64 6c 65 3b 0a 20 20 72 65  ] = handle;.  re
2b30: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
2b40: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c 6f  }.int sqlite3_lo
2b50: 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 0a 20 20  ad_extension(.  
2b60: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
2b70: 20 20 20 20 20 20 2f 2a 20 4c 6f 61 64 20 74 68        /* Load th
2b80: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 6e 74 6f  e extension into
2b90: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63   this database c
2ba0: 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63  onnection */.  c
2bb0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
2bc0: 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20  ,    /* Name of 
2bd0: 74 68 65 20 73 68 61 72 65 64 20 6c 69 62 72 61  the shared libra
2be0: 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 78  ry containing ex
2bf0: 74 65 6e 73 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e  tension */.  con
2c00: 73 74 20 63 68 61 72 20 2a 7a 50 72 6f 63 2c 20  st char *zProc, 
2c10: 20 20 20 2f 2a 20 45 6e 74 72 79 20 70 6f 69 6e     /* Entry poin
2c20: 74 2e 20 20 55 73 65 20 22 73 71 6c 69 74 65 33  t.  Use "sqlite3
2c30: 5f 65 78 74 65 6e 73 69 6f 6e 5f 69 6e 69 74 22  _extension_init"
2c40: 20 69 66 20 30 20 2a 2f 0a 20 20 63 68 61 72 20   if 0 */.  char 
2c50: 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20  **pzErrMsg      
2c60: 20 2f 2a 20 50 75 74 20 65 72 72 6f 72 20 6d 65   /* Put error me
2c70: 73 73 61 67 65 20 68 65 72 65 20 69 66 20 6e 6f  ssage here if no
2c80: 74 20 30 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  t 0 */.){.  int 
2c90: 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75  rc;.  sqlite3_mu
2ca0: 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75  tex_enter(db->mu
2cb0: 74 65 78 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c  tex);.  rc = sql
2cc0: 69 74 65 33 4c 6f 61 64 45 78 74 65 6e 73 69 6f  ite3LoadExtensio
2cd0: 6e 28 64 62 2c 20 7a 46 69 6c 65 2c 20 7a 50 72  n(db, zFile, zPr
2ce0: 6f 63 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20  oc, pzErrMsg);. 
2cf0: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c   sqlite3_mutex_l
2d00: 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b  eave(db->mutex);
2d10: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
2d20: 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 69 73  ./*.** Call this
2d30: 20 72 6f 75 74 69 6e 65 20 77 68 65 6e 20 74 68   routine when th
2d40: 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65  e database conne
2d50: 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 69 6e 67  ction is closing
2d60: 20 69 6e 20 6f 72 64 65 72 0a 2a 2a 20 74 6f 20   in order.** to 
2d70: 63 6c 65 61 6e 20 75 70 20 6c 6f 61 64 65 64 20  clean up loaded 
2d80: 65 78 74 65 6e 73 69 6f 6e 73 0a 2a 2f 0a 76 6f  extensions.*/.vo
2d90: 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45  id sqlite3CloseE
2da0: 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65  xtensions(sqlite
2db0: 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b  3 *db){.  int i;
2dc0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
2dd0: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62  e3_mutex_held(db
2de0: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f  ->mutex) );.  fo
2df0: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 45 78  r(i=0; i<db->nEx
2e00: 74 65 6e 73 69 6f 6e 3b 20 69 2b 2b 29 7b 0a 20  tension; i++){. 
2e10: 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 43 6c     sqlite3OsDlCl
2e20: 6f 73 65 28 64 62 2d 3e 70 56 66 73 2c 20 64 62  ose(db->pVfs, db
2e30: 2d 3e 61 45 78 74 65 6e 73 69 6f 6e 5b 69 5d 29  ->aExtension[i])
2e40: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f  ;.  }.  sqlite3_
2e50: 66 72 65 65 28 64 62 2d 3e 61 45 78 74 65 6e 73  free(db->aExtens
2e60: 69 6f 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45  ion);.}../*.** E
2e70: 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c 65  nable or disable
2e80: 20 65 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 69   extension loadi
2e90: 6e 67 2e 20 20 45 78 74 65 6e 73 69 6f 6e 20 6c  ng.  Extension l
2ea0: 6f 61 64 69 6e 67 20 69 73 20 64 69 73 61 62 6c  oading is disabl
2eb0: 65 64 20 62 79 0a 2a 2a 20 64 65 66 61 75 6c 74  ed by.** default
2ec0: 20 73 6f 20 61 73 20 6e 6f 74 20 74 6f 20 6f 70   so as not to op
2ed0: 65 6e 20 73 65 63 75 72 69 74 79 20 68 6f 6c 65  en security hole
2ee0: 73 20 69 6e 20 6f 6c 64 65 72 20 61 70 70 6c 69  s in older appli
2ef0: 63 61 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20  cations..*/.int 
2f00: 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 6c  sqlite3_enable_l
2f10: 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 73 71  oad_extension(sq
2f20: 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 6f  lite3 *db, int o
2f30: 6e 6f 66 66 29 7b 0a 20 20 73 71 6c 69 74 65 33  noff){.  sqlite3
2f40: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d  _mutex_enter(db-
2f50: 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 6f  >mutex);.  if( o
2f60: 6e 6f 66 66 20 29 7b 0a 20 20 20 20 64 62 2d 3e  noff ){.    db->
2f70: 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f  flags |= SQLITE_
2f80: 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 3b 0a 20  LoadExtension;. 
2f90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d 3e   }else{.    db->
2fa0: 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45  flags &= ~SQLITE
2fb0: 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 3b 0a  _LoadExtension;.
2fc0: 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75    }.  sqlite3_mu
2fd0: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75  tex_leave(db->mu
2fe0: 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 53  tex);.  return S
2ff0: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 23 65 6e  QLITE_OK;.}..#en
3000: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d  dif /* SQLITE_OM
3010: 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f  IT_LOAD_EXTENSIO
3020: 4e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  N */../*.** The 
3030: 61 75 74 6f 2d 65 78 74 65 6e 73 69 6f 6e 20 63  auto-extension c
3040: 6f 64 65 20 61 64 64 65 64 20 72 65 67 61 72 64  ode added regard
3050: 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 20  less of whether 
3060: 6f 72 20 6e 6f 74 20 65 78 74 65 6e 73 69 6f 6e  or not extension
3070: 0a 2a 2a 20 6c 6f 61 64 69 6e 67 20 69 73 20 73  .** loading is s
3080: 75 70 70 6f 72 74 65 64 2e 20 20 57 65 20 6e 65  upported.  We ne
3090: 65 64 20 61 20 64 75 6d 6d 79 20 73 71 6c 69 74  ed a dummy sqlit
30a0: 65 33 41 70 69 73 20 70 6f 69 6e 74 65 72 20 66  e3Apis pointer f
30b0: 6f 72 20 74 68 61 74 0a 2a 2a 20 63 6f 64 65 20  or that.** code 
30c0: 69 66 20 72 65 67 75 6c 61 72 20 65 78 74 65 6e  if regular exten
30d0: 73 69 6f 6e 20 6c 6f 61 64 69 6e 67 20 69 73 20  sion loading is 
30e0: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 2e 20 20  not available.  
30f0: 54 68 69 73 20 69 73 20 74 68 61 74 0a 2a 2a 20  This is that.** 
3100: 64 75 6d 6d 79 20 70 6f 69 6e 74 65 72 2e 0a 2a  dummy pointer..*
3110: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  /.#ifdef SQLITE_
3120: 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53  OMIT_LOAD_EXTENS
3130: 49 4f 4e 0a 73 74 61 74 69 63 20 63 6f 6e 73 74  ION.static const
3140: 20 73 71 6c 69 74 65 33 5f 61 70 69 5f 72 6f 75   sqlite3_api_rou
3150: 74 69 6e 65 73 20 73 71 6c 69 74 65 33 41 70 69  tines sqlite3Api
3160: 73 20 3d 20 7b 20 30 20 7d 3b 0a 23 65 6e 64 69  s = { 0 };.#endi
3170: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  f.../*.** The fo
3180: 6c 6c 6f 77 69 6e 67 20 6f 62 6a 65 63 74 20 68  llowing object h
3190: 6f 6c 64 73 20 74 68 65 20 6c 69 73 74 20 6f 66  olds the list of
31a0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 6c   automatically l
31b0: 6f 61 64 65 64 0a 2a 2a 20 65 78 74 65 6e 73 69  oaded.** extensi
31c0: 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ons..**.** This 
31d0: 6c 69 73 74 20 69 73 20 73 68 61 72 65 64 20 61  list is shared a
31e0: 63 72 6f 73 73 20 74 68 72 65 61 64 73 2e 20 20  cross threads.  
31f0: 54 68 65 20 53 51 4c 49 54 45 5f 4d 55 54 45 58  The SQLITE_MUTEX
3200: 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 0a 2a  _STATIC_MASTER.*
3210: 2a 20 6d 75 74 65 78 20 6d 75 73 74 20 62 65 20  * mutex must be 
3220: 68 65 6c 64 20 77 68 69 6c 65 20 61 63 63 65 73  held while acces
3230: 73 69 6e 67 20 74 68 69 73 20 6c 69 73 74 2e 0a  sing this list..
3240: 2a 2f 0a 73 74 61 74 69 63 20 73 74 72 75 63 74  */.static struct
3250: 20 7b 0a 20 20 69 6e 74 20 6e 45 78 74 3b 20 20   {.  int nExt;  
3260: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
3270: 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 45  of entries in aE
3280: 78 74 5b 5d 20 2a 2f 20 20 20 20 20 20 20 20 20  xt[] */         
3290: 20 0a 20 20 76 6f 69 64 20 2a 2a 61 45 78 74 3b   .  void **aExt;
32a0: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 73       /* Pointers
32b0: 20 74 6f 20 74 68 65 20 65 78 74 65 6e 73 69 6f   to the extensio
32c0: 6e 20 69 6e 69 74 20 66 75 6e 63 74 69 6f 6e 73  n init functions
32d0: 20 2a 2f 0a 7d 20 61 75 74 6f 65 78 74 20 3d 20   */.} autoext = 
32e0: 7b 20 30 2c 20 30 20 7d 3b 0a 0a 0a 2f 2a 0a 2a  { 0, 0 };.../*.*
32f0: 2a 20 52 65 67 69 73 74 65 72 20 61 20 73 74 61  * Register a sta
3300: 74 69 63 61 6c 6c 79 20 6c 69 6e 6b 65 64 20 65  tically linked e
3310: 78 74 65 6e 73 69 6f 6e 20 74 68 61 74 20 69 73  xtension that is
3320: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 2a   automatically.*
3330: 2a 20 6c 6f 61 64 65 64 20 62 79 20 65 76 65 72  * loaded by ever
3340: 79 20 6e 65 77 20 64 61 74 61 62 61 73 65 20 63  y new database c
3350: 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 2a 2f 0a 69 6e  onnection..*/.in
3360: 74 20 73 71 6c 69 74 65 33 5f 61 75 74 6f 5f 65  t sqlite3_auto_e
3370: 78 74 65 6e 73 69 6f 6e 28 76 6f 69 64 20 2a 78  xtension(void *x
3380: 49 6e 69 74 29 7b 0a 20 20 69 6e 74 20 69 3b 0a  Init){.  int i;.
3390: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
33a0: 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 5f  E_OK;.  sqlite3_
33b0: 6d 75 74 65 78 20 2a 6d 75 74 65 78 20 3d 20 73  mutex *mutex = s
33c0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61 6c 6c  qlite3_mutex_all
33d0: 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f  oc(SQLITE_MUTEX_
33e0: 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29 3b 0a  STATIC_MASTER);.
33f0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f    sqlite3_mutex_
3400: 65 6e 74 65 72 28 6d 75 74 65 78 29 3b 0a 20 20  enter(mutex);.  
3410: 66 6f 72 28 69 3d 30 3b 20 69 3c 61 75 74 6f 65  for(i=0; i<autoe
3420: 78 74 2e 6e 45 78 74 3b 20 69 2b 2b 29 7b 0a 20  xt.nExt; i++){. 
3430: 20 20 20 69 66 28 20 61 75 74 6f 65 78 74 2e 61     if( autoext.a
3440: 45 78 74 5b 69 5d 3d 3d 78 49 6e 69 74 20 29 20  Ext[i]==xInit ) 
3450: 62 72 65 61 6b 3b 0a 20 20 7d 0a 20 20 69 66 28  break;.  }.  if(
3460: 20 69 3d 3d 61 75 74 6f 65 78 74 2e 6e 45 78 74   i==autoext.nExt
3470: 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 42 79 74   ){.    int nByt
3480: 65 20 3d 20 28 61 75 74 6f 65 78 74 2e 6e 45 78  e = (autoext.nEx
3490: 74 2b 31 29 2a 73 69 7a 65 6f 66 28 61 75 74 6f  t+1)*sizeof(auto
34a0: 65 78 74 2e 61 45 78 74 5b 30 5d 29 3b 0a 20 20  ext.aExt[0]);.  
34b0: 20 20 76 6f 69 64 20 2a 2a 61 4e 65 77 3b 0a 20    void **aNew;. 
34c0: 20 20 20 61 4e 65 77 20 3d 20 73 71 6c 69 74 65     aNew = sqlite
34d0: 33 5f 72 65 61 6c 6c 6f 63 28 61 75 74 6f 65 78  3_realloc(autoex
34e0: 74 2e 61 45 78 74 2c 20 6e 42 79 74 65 29 3b 0a  t.aExt, nByte);.
34f0: 20 20 20 20 69 66 28 20 61 4e 65 77 3d 3d 30 20      if( aNew==0 
3500: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51  ){.      rc = SQ
3510: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
3520: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 61 75 74  }else{.      aut
3530: 6f 65 78 74 2e 61 45 78 74 20 3d 20 61 4e 65 77  oext.aExt = aNew
3540: 3b 0a 20 20 20 20 20 20 61 75 74 6f 65 78 74 2e  ;.      autoext.
3550: 61 45 78 74 5b 61 75 74 6f 65 78 74 2e 6e 45 78  aExt[autoext.nEx
3560: 74 5d 20 3d 20 78 49 6e 69 74 3b 0a 20 20 20 20  t] = xInit;.    
3570: 20 20 61 75 74 6f 65 78 74 2e 6e 45 78 74 2b 2b    autoext.nExt++
3580: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71  ;.    }.  }.  sq
3590: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
35a0: 65 28 6d 75 74 65 78 29 3b 0a 20 20 61 73 73 65  e(mutex);.  asse
35b0: 72 74 28 20 28 72 63 26 30 78 66 66 29 3d 3d 72  rt( (rc&0xff)==r
35c0: 63 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  c );.  return rc
35d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 65 74  ;.}../*.** Reset
35e0: 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 65   the automatic e
35f0: 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 69 6e 67  xtension loading
3600: 20 6d 65 63 68 61 6e 69 73 6d 2e 0a 2a 2f 0a 76   mechanism..*/.v
3610: 6f 69 64 20 73 71 6c 69 74 65 33 5f 72 65 73 65  oid sqlite3_rese
3620: 74 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69 6f 6e  t_auto_extension
3630: 28 76 6f 69 64 29 7b 0a 20 20 73 71 6c 69 74 65  (void){.  sqlite
3640: 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 20 3d  3_mutex *mutex =
3650: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 61   sqlite3_mutex_a
3660: 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 54 45  lloc(SQLITE_MUTE
3670: 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 52 29  X_STATIC_MASTER)
3680: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  ;.  sqlite3_mute
3690: 78 5f 65 6e 74 65 72 28 6d 75 74 65 78 29 3b 0a  x_enter(mutex);.
36a0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 61    sqlite3_free(a
36b0: 75 74 6f 65 78 74 2e 61 45 78 74 29 3b 0a 20 20  utoext.aExt);.  
36c0: 61 75 74 6f 65 78 74 2e 61 45 78 74 20 3d 20 30  autoext.aExt = 0
36d0: 3b 0a 20 20 61 75 74 6f 65 78 74 2e 6e 45 78 74  ;.  autoext.nExt
36e0: 20 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 5f   = 0;.  sqlite3_
36f0: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65  mutex_leave(mute
3700: 78 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 61  x);.}../*.** Loa
3710: 64 20 61 6c 6c 20 61 75 74 6f 6d 61 74 69 63 20  d all automatic 
3720: 65 78 74 65 6e 73 69 6f 6e 73 2e 0a 2a 2f 0a 69  extensions..*/.i
3730: 6e 74 20 73 71 6c 69 74 65 33 41 75 74 6f 4c 6f  nt sqlite3AutoLo
3740: 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c  adExtensions(sql
3750: 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74  ite3 *db){.  int
3760: 20 69 3b 0a 20 20 69 6e 74 20 67 6f 20 3d 20 31   i;.  int go = 1
3770: 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c  ;.  int rc = SQL
3780: 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 28 2a  ITE_OK;.  int (*
3790: 78 49 6e 69 74 29 28 73 71 6c 69 74 65 33 2a 2c  xInit)(sqlite3*,
37a0: 63 68 61 72 2a 2a 2c 63 6f 6e 73 74 20 73 71 6c  char**,const sql
37b0: 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65  ite3_api_routine
37c0: 73 2a 29 3b 0a 0a 20 20 69 66 28 20 61 75 74 6f  s*);..  if( auto
37d0: 65 78 74 2e 6e 45 78 74 3d 3d 30 20 29 7b 0a 20  ext.nExt==0 ){. 
37e0: 20 20 20 2f 2a 20 43 6f 6d 6d 6f 6e 20 63 61 73     /* Common cas
37f0: 65 3a 20 65 61 72 6c 79 20 6f 75 74 20 77 69 74  e: early out wit
3800: 68 6f 75 74 20 65 76 65 72 79 20 68 61 76 69 6e  hout every havin
3810: 67 20 74 6f 20 61 63 71 75 69 72 65 20 61 20 6d  g to acquire a m
3820: 75 74 65 78 20 2a 2f 0a 20 20 20 20 72 65 74 75  utex */.    retu
3830: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
3840: 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20 67 6f 3b  }.  for(i=0; go;
3850: 20 69 2b 2b 29 7b 0a 20 20 20 20 63 68 61 72 20   i++){.    char 
3860: 2a 7a 45 72 72 6d 73 67 20 3d 20 30 3b 0a 20 20  *zErrmsg = 0;.  
3870: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20    sqlite3_mutex 
3880: 2a 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33  *mutex = sqlite3
3890: 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c  _mutex_alloc(SQL
38a0: 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43  ITE_MUTEX_STATIC
38b0: 5f 4d 41 53 54 45 52 29 3b 0a 20 20 20 20 73 71  _MASTER);.    sq
38c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
38d0: 72 28 6d 75 74 65 78 29 3b 0a 20 20 20 20 69 66  r(mutex);.    if
38e0: 28 20 69 3e 3d 61 75 74 6f 65 78 74 2e 6e 45 78  ( i>=autoext.nEx
38f0: 74 20 29 7b 0a 20 20 20 20 20 20 78 49 6e 69 74  t ){.      xInit
3900: 20 3d 20 30 3b 0a 20 20 20 20 20 20 67 6f 20 3d   = 0;.      go =
3910: 20 30 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20   0;.    }else{. 
3920: 20 20 20 20 20 78 49 6e 69 74 20 3d 20 28 69 6e       xInit = (in
3930: 74 28 2a 29 28 73 71 6c 69 74 65 33 2a 2c 63 68  t(*)(sqlite3*,ch
3940: 61 72 2a 2a 2c 63 6f 6e 73 74 20 73 71 6c 69 74  ar**,const sqlit
3950: 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65 73 2a  e3_api_routines*
3960: 29 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  )).             
3970: 20 61 75 74 6f 65 78 74 2e 61 45 78 74 5b 69 5d   autoext.aExt[i]
3980: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
3990: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
39a0: 6d 75 74 65 78 29 3b 0a 20 20 20 20 69 66 28 20  mutex);.    if( 
39b0: 78 49 6e 69 74 20 26 26 20 78 49 6e 69 74 28 64  xInit && xInit(d
39c0: 62 2c 20 26 7a 45 72 72 6d 73 67 2c 20 26 73 71  b, &zErrmsg, &sq
39d0: 6c 69 74 65 33 41 70 69 73 29 20 29 7b 0a 20 20  lite3Apis) ){.  
39e0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
39f0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 45 52 52 4f  (db, SQLITE_ERRO
3a00: 52 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 22  R,.            "
3a10: 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73  automatic extens
3a20: 69 6f 6e 20 6c 6f 61 64 69 6e 67 20 66 61 69 6c  ion loading fail
3a30: 65 64 3a 20 25 73 22 2c 20 7a 45 72 72 6d 73 67  ed: %s", zErrmsg
3a40: 29 3b 0a 20 20 20 20 20 20 67 6f 20 3d 20 30 3b  );.      go = 0;
3a50: 0a 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49  .      rc = SQLI
3a60: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20  TE_ERROR;.      
3a70: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 72  sqlite3_free(zEr
3a80: 72 6d 73 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  rmsg);.    }.  }
3a90: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.