/ Hex Artifact Content
Login

Artifact 0215a9c83b7f720aba30f06f183fe6fb3c56a009:


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 23  te library..*/.#
01d0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
01e0: 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f  IT_LOAD_EXTENSIO
01f0: 4e 0a 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54  N..#define SQLIT
0200: 45 5f 43 4f 52 45 20 31 20 20 2f 2a 20 44 69 73  E_CORE 1  /* Dis
0210: 61 62 6c 65 20 74 68 65 20 41 50 49 20 72 65 64  able the API red
0220: 65 66 69 6e 69 74 69 6f 6e 20 69 6e 20 73 71 6c  efinition in sql
0230: 69 74 65 33 65 78 74 2e 68 20 2a 2f 0a 23 69 6e  ite3ext.h */.#in
0240: 63 6c 75 64 65 20 22 73 71 6c 69 74 65 33 65 78  clude "sqlite3ex
0250: 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 73  t.h".#include "s
0260: 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63  qliteInt.h".#inc
0270: 6c 75 64 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a  lude <string.h>.
0280: 23 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 2e  #include <ctype.
0290: 68 3e 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 20 41  h>../*.** Some A
02a0: 50 49 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20  PI routines are 
02b0: 6f 6d 69 74 74 65 64 20 77 68 65 6e 20 76 61 72  omitted when var
02c0: 69 6f 75 73 20 66 65 61 74 75 72 65 73 20 61 72  ious features ar
02d0: 65 0a 2a 2a 20 65 78 63 6c 75 64 65 64 20 66 72  e.** excluded fr
02e0: 6f 6d 20 61 20 62 75 69 6c 64 20 6f 66 20 53 51  om a build of SQ
02f0: 4c 69 74 65 2e 20 20 53 75 62 73 74 69 74 75 74  Lite.  Substitut
0300: 65 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72  e a NULL pointer
0310: 0a 2a 2a 20 66 6f 72 20 61 6e 79 20 6d 69 73 73  .** for any miss
0320: 69 6e 67 20 41 50 49 73 2e 0a 2a 2f 0a 23 69 66  ing APIs..*/.#if
0330: 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42  ndef SQLITE_ENAB
0340: 4c 45 5f 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41  LE_COLUMN_METADA
0350: 54 41 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69  TA.# define sqli
0360: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62  te3_column_datab
0370: 61 73 65 5f 6e 61 6d 65 20 20 20 30 0a 23 20 64  ase_name   0.# d
0380: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f  efine sqlite3_co
0390: 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61  lumn_database_na
03a0: 6d 65 31 36 20 30 0a 23 20 64 65 66 69 6e 65 20  me16 0.# define 
03b0: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74  sqlite3_column_t
03c0: 61 62 6c 65 5f 6e 61 6d 65 20 20 20 20 20 20 30  able_name      0
03d0: 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65  .# define sqlite
03e0: 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e  3_column_table_n
03f0: 61 6d 65 31 36 20 20 20 20 30 0a 23 20 64 65 66  ame16    0.# def
0400: 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  ine sqlite3_colu
0410: 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 20 20  mn_origin_name  
0420: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71     0.# define sq
0430: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69  lite3_column_ori
0440: 67 69 6e 5f 6e 61 6d 65 31 36 20 20 20 30 0a 23  gin_name16   0.#
0450: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f   define sqlite3_
0460: 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74  table_column_met
0470: 61 64 61 74 61 20 20 30 0a 23 65 6e 64 69 66 0a  adata  0.#endif.
0480: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f  ./*.** The follo
0490: 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 63  wing structure c
04a0: 6f 6e 74 61 69 6e 73 20 70 6f 69 6e 74 65 72 73  ontains pointers
04b0: 20 74 6f 20 61 6c 6c 20 53 51 4c 69 74 65 20 41   to all SQLite A
04c0: 50 49 20 72 6f 75 74 69 6e 65 73 2e 0a 2a 2a 20  PI routines..** 
04d0: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69  A pointer to thi
04e0: 73 20 73 74 72 75 63 74 75 72 65 20 69 73 20 70  s structure is p
04f0: 61 73 73 65 64 20 69 6e 74 6f 20 65 78 74 65 6e  assed into exten
0500: 73 69 6f 6e 73 20 77 68 65 6e 20 74 68 65 79 20  sions when they 
0510: 61 72 65 0a 2a 2a 20 6c 6f 61 64 65 64 20 73 6f  are.** loaded so
0520: 20 74 68 61 74 20 74 68 65 20 65 78 74 65 6e 73   that the extens
0530: 69 6f 6e 20 63 61 6e 20 6d 61 6b 65 20 63 61 6c  ion can make cal
0540: 6c 73 20 62 61 63 6b 20 69 6e 74 6f 20 74 68 65  ls back into the
0550: 20 53 51 4c 69 74 65 0a 2a 2a 20 6c 69 62 72 61   SQLite.** libra
0560: 72 79 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61  ry..**.** When a
0570: 64 64 69 6e 67 20 6e 65 77 20 41 50 49 73 2c 20  dding new APIs, 
0580: 61 64 64 20 74 68 65 6d 20 74 6f 20 74 68 65 20  add them to the 
0590: 62 6f 74 74 6f 6d 20 6f 66 20 74 68 69 73 20 73  bottom of this s
05a0: 74 72 75 63 74 75 72 65 0a 2a 2a 20 69 6e 20 6f  tructure.** in o
05b0: 72 64 65 72 20 74 6f 20 70 72 65 73 65 72 76 65  rder to preserve
05c0: 20 62 61 63 6b 77 61 72 64 73 20 63 6f 6d 70 61   backwards compa
05d0: 74 69 62 69 6c 69 74 79 2e 0a 2a 2a 0a 2a 2a 20  tibility..**.** 
05e0: 45 78 74 65 6e 73 69 6f 6e 73 20 74 68 61 74 20  Extensions that 
05f0: 75 73 65 20 6e 65 77 65 72 20 41 50 49 73 20 73  use newer APIs s
0600: 68 6f 75 6c 64 20 66 69 72 73 74 20 63 61 6c 6c  hould first call
0610: 20 74 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f   the.** sqlite3_
0620: 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62 65  libversion_numbe
0630: 72 28 29 20 74 6f 20 6d 61 6b 65 20 73 75 72 65  r() to make sure
0640: 20 74 68 61 74 20 74 68 65 20 41 50 49 20 74 68   that the API th
0650: 65 79 0a 2a 2a 20 69 6e 74 65 6e 64 20 74 6f 20  ey.** intend to 
0660: 75 73 65 20 69 73 20 73 75 70 70 6f 72 74 65 64  use is supported
0670: 20 62 79 20 74 68 65 20 6c 69 62 72 61 72 79 2e   by the library.
0680: 20 20 45 78 74 65 6e 73 69 6f 6e 73 20 73 68 6f    Extensions sho
0690: 75 6c 64 0a 2a 2a 20 61 6c 73 6f 20 63 68 65 63  uld.** also chec
06a0: 6b 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74  k to make sure t
06b0: 68 61 74 20 74 68 65 20 70 6f 69 6e 74 65 72 20  hat the pointer 
06c0: 74 6f 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20  to the function 
06d0: 69 73 0a 2a 2a 20 6e 6f 74 20 4e 55 4c 4c 20 62  is.** not NULL b
06e0: 65 66 6f 72 65 20 63 61 6c 6c 69 6e 67 20 69 74  efore calling it
06f0: 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 73 71 6c 69 74  ..*/.const sqlit
0700: 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65 73 20  e3_api_routines 
0710: 73 71 6c 69 74 65 33 5f 61 70 69 20 3d 20 7b 0a  sqlite3_api = {.
0720: 20 20 73 71 6c 69 74 65 33 5f 61 67 67 72 65 67    sqlite3_aggreg
0730: 61 74 65 5f 63 6f 6e 74 65 78 74 2c 0a 20 20 73  ate_context,.  s
0740: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65  qlite3_aggregate
0750: 5f 63 6f 75 6e 74 2c 0a 20 20 73 71 6c 69 74 65  _count,.  sqlite
0760: 33 5f 62 69 6e 64 5f 62 6c 6f 62 2c 0a 20 20 73  3_bind_blob,.  s
0770: 71 6c 69 74 65 33 5f 62 69 6e 64 5f 64 6f 75 62  qlite3_bind_doub
0780: 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69  le,.  sqlite3_bi
0790: 6e 64 5f 69 6e 74 2c 0a 20 20 73 71 6c 69 74 65  nd_int,.  sqlite
07a0: 33 5f 62 69 6e 64 5f 69 6e 74 36 34 2c 0a 20 20  3_bind_int64,.  
07b0: 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c  sqlite3_bind_nul
07c0: 6c 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e  l,.  sqlite3_bin
07d0: 64 5f 70 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e  d_parameter_coun
07e0: 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e  t,.  sqlite3_bin
07f0: 64 5f 70 61 72 61 6d 65 74 65 72 5f 69 6e 64 65  d_parameter_inde
0800: 78 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e  x,.  sqlite3_bin
0810: 64 5f 70 61 72 61 6d 65 74 65 72 5f 6e 61 6d 65  d_parameter_name
0820: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64  ,.  sqlite3_bind
0830: 5f 74 65 78 74 2c 0a 20 20 73 71 6c 69 74 65 33  _text,.  sqlite3
0840: 5f 62 69 6e 64 5f 74 65 78 74 31 36 2c 0a 20 20  _bind_text16,.  
0850: 73 71 6c 69 74 65 33 5f 62 75 73 79 5f 68 61 6e  sqlite3_busy_han
0860: 64 6c 65 72 2c 0a 20 20 73 71 6c 69 74 65 33 5f  dler,.  sqlite3_
0870: 62 75 73 79 5f 74 69 6d 65 6f 75 74 2c 0a 20 20  busy_timeout,.  
0880: 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 2c  sqlite3_changes,
0890: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65  .  sqlite3_close
08a0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c  ,.  sqlite3_coll
08b0: 61 74 69 6f 6e 5f 6e 65 65 64 65 64 2c 0a 20 20  ation_needed,.  
08c0: 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f  sqlite3_collatio
08d0: 6e 5f 6e 65 65 64 65 64 31 36 2c 0a 20 20 73 71  n_needed16,.  sq
08e0: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 6c 6f  lite3_column_blo
08f0: 62 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c  b,.  sqlite3_col
0900: 75 6d 6e 5f 62 79 74 65 73 2c 0a 20 20 73 71 6c  umn_bytes,.  sql
0910: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 79 74 65  ite3_column_byte
0920: 73 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63  s16,.  sqlite3_c
0930: 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 2c 0a 20 20 73  olumn_count,.  s
0940: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61  qlite3_column_da
0950: 74 61 62 61 73 65 5f 6e 61 6d 65 2c 0a 20 20 73  tabase_name,.  s
0960: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 61  qlite3_column_da
0970: 74 61 62 61 73 65 5f 6e 61 6d 65 31 36 2c 0a 20  tabase_name16,. 
0980: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
0990: 64 65 63 6c 74 79 70 65 2c 0a 20 20 73 71 6c 69  decltype,.  sqli
09a0: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 63 6c 74  te3_column_declt
09b0: 79 70 65 31 36 2c 0a 20 20 73 71 6c 69 74 65 33  ype16,.  sqlite3
09c0: 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c 65 2c 0a  _column_double,.
09d0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e    sqlite3_column
09e0: 5f 69 6e 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f  _int,.  sqlite3_
09f0: 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 2c 0a 20 20  column_int64,.  
0a00: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6e  sqlite3_column_n
0a10: 61 6d 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63  ame,.  sqlite3_c
0a20: 6f 6c 75 6d 6e 5f 6e 61 6d 65 31 36 2c 0a 20 20  olumn_name16,.  
0a30: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f  sqlite3_column_o
0a40: 72 69 67 69 6e 5f 6e 61 6d 65 2c 0a 20 20 73 71  rigin_name,.  sq
0a50: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69  lite3_column_ori
0a60: 67 69 6e 5f 6e 61 6d 65 31 36 2c 0a 20 20 73 71  gin_name16,.  sq
0a70: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62  lite3_column_tab
0a80: 6c 65 5f 6e 61 6d 65 2c 0a 20 20 73 71 6c 69 74  le_name,.  sqlit
0a90: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f  e3_column_table_
0aa0: 6e 61 6d 65 31 36 2c 0a 20 20 73 71 6c 69 74 65  name16,.  sqlite
0ab0: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 2c 0a 20  3_column_text,. 
0ac0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
0ad0: 74 65 78 74 31 36 2c 0a 20 20 73 71 6c 69 74 65  text16,.  sqlite
0ae0: 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 2c 0a 20  3_column_type,. 
0af0: 20 73 71 6c 69 74 65 33 5f 63 6f 6d 6d 69 74 5f   sqlite3_commit_
0b00: 68 6f 6f 6b 2c 0a 20 20 73 71 6c 69 74 65 33 5f  hook,.  sqlite3_
0b10: 63 6f 6d 70 6c 65 74 65 2c 0a 20 20 73 71 6c 69  complete,.  sqli
0b20: 74 65 33 5f 63 6f 6d 70 6c 65 74 65 31 36 2c 0a  te3_complete16,.
0b30: 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65    sqlite3_create
0b40: 5f 63 6f 6c 6c 61 74 69 6f 6e 2c 0a 20 20 73 71  _collation,.  sq
0b50: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c  lite3_create_col
0b60: 6c 61 74 69 6f 6e 31 36 2c 0a 20 20 73 71 6c 69  lation16,.  sqli
0b70: 74 65 33 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  te3_create_funct
0b80: 69 6f 6e 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63  ion,.  sqlite3_c
0b90: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 31 36  reate_function16
0ba0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 64 61 74 61  ,.  sqlite3_data
0bb0: 5f 63 6f 75 6e 74 2c 0a 20 20 73 71 6c 69 74 65  _count,.  sqlite
0bc0: 33 5f 64 62 5f 68 61 6e 64 6c 65 2c 0a 20 20 73  3_db_handle,.  s
0bd0: 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f 73 68  qlite3_enable_sh
0be0: 61 72 65 64 5f 63 61 63 68 65 2c 0a 20 20 73 71  ared_cache,.  sq
0bf0: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 2c 0a 20  lite3_errcode,. 
0c00: 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 2c   sqlite3_errmsg,
0c10: 0a 20 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73  .  sqlite3_errms
0c20: 67 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 65  g16,.  sqlite3_e
0c30: 78 65 63 2c 0a 20 20 73 71 6c 69 74 65 33 5f 65  xec,.  sqlite3_e
0c40: 78 70 69 72 65 64 2c 0a 20 20 73 71 6c 69 74 65  xpired,.  sqlite
0c50: 33 5f 66 69 6e 61 6c 69 7a 65 2c 0a 20 20 73 71  3_finalize,.  sq
0c60: 6c 69 74 65 33 5f 66 72 65 65 2c 0a 20 20 73 71  lite3_free,.  sq
0c70: 6c 69 74 65 33 5f 66 72 65 65 5f 74 61 62 6c 65  lite3_free_table
0c80: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 67 65 74 5f  ,.  sqlite3_get_
0c90: 61 75 74 6f 63 6f 6d 6d 69 74 2c 0a 20 20 73 71  autocommit,.  sq
0ca0: 6c 69 74 65 33 5f 67 65 74 5f 61 75 78 64 61 74  lite3_get_auxdat
0cb0: 61 2c 0a 20 20 73 71 6c 69 74 65 33 5f 67 65 74  a,.  sqlite3_get
0cc0: 5f 74 61 62 6c 65 2c 0a 20 20 73 71 6c 69 74 65  _table,.  sqlite
0cd0: 33 5f 67 6c 6f 62 61 6c 5f 72 65 63 6f 76 65 72  3_global_recover
0ce0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 65  ,.  sqlite3_inte
0cf0: 72 72 75 70 74 2c 0a 20 20 73 71 6c 69 74 65 33  rrupt,.  sqlite3
0d00: 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77  _last_insert_row
0d10: 69 64 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6c 69  id,.  sqlite3_li
0d20: 62 76 65 72 73 69 6f 6e 2c 0a 20 20 73 71 6c 69  bversion,.  sqli
0d30: 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e  te3_libversion_n
0d40: 75 6d 62 65 72 2c 0a 20 20 73 71 6c 69 74 65 33  umber,.  sqlite3
0d50: 5f 6d 70 72 69 6e 74 66 2c 0a 20 20 73 71 6c 69  _mprintf,.  sqli
0d60: 74 65 33 5f 6f 70 65 6e 2c 0a 20 20 73 71 6c 69  te3_open,.  sqli
0d70: 74 65 33 5f 6f 70 65 6e 31 36 2c 0a 20 20 73 71  te3_open16,.  sq
0d80: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 2c 0a 20  lite3_prepare,. 
0d90: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
0da0: 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 70 72  16,.  sqlite3_pr
0db0: 6f 66 69 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33  ofile,.  sqlite3
0dc0: 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 65  _progress_handle
0dd0: 72 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73  r,.  sqlite3_res
0de0: 65 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65  et,.  sqlite3_re
0df0: 73 75 6c 74 5f 62 6c 6f 62 2c 0a 20 20 73 71 6c  sult_blob,.  sql
0e00: 69 74 65 33 5f 72 65 73 75 6c 74 5f 64 6f 75 62  ite3_result_doub
0e10: 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65  le,.  sqlite3_re
0e20: 73 75 6c 74 5f 65 72 72 6f 72 2c 0a 20 20 73 71  sult_error,.  sq
0e30: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 65 72 72  lite3_result_err
0e40: 6f 72 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f  or16,.  sqlite3_
0e50: 72 65 73 75 6c 74 5f 69 6e 74 2c 0a 20 20 73 71  result_int,.  sq
0e60: 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74  lite3_result_int
0e70: 36 34 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65  64,.  sqlite3_re
0e80: 73 75 6c 74 5f 6e 75 6c 6c 2c 0a 20 20 73 71 6c  sult_null,.  sql
0e90: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74  ite3_result_text
0ea0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75  ,.  sqlite3_resu
0eb0: 6c 74 5f 74 65 78 74 31 36 2c 0a 20 20 73 71 6c  lt_text16,.  sql
0ec0: 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74  ite3_result_text
0ed0: 31 36 62 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f  16be,.  sqlite3_
0ee0: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 2c  result_text16le,
0ef0: 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c  .  sqlite3_resul
0f00: 74 5f 76 61 6c 75 65 2c 0a 20 20 73 71 6c 69 74  t_value,.  sqlit
0f10: 65 33 5f 72 6f 6c 6c 62 61 63 6b 5f 68 6f 6f 6b  e3_rollback_hook
0f20: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 73 65 74 5f  ,.  sqlite3_set_
0f30: 61 75 74 68 6f 72 69 7a 65 72 2c 0a 20 20 73 71  authorizer,.  sq
0f40: 6c 69 74 65 33 5f 73 65 74 5f 61 75 78 64 61 74  lite3_set_auxdat
0f50: 61 2c 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e 70  a,.  sqlite3_snp
0f60: 72 69 6e 74 66 2c 0a 20 20 73 71 6c 69 74 65 33  rintf,.  sqlite3
0f70: 5f 73 74 65 70 2c 0a 20 20 73 71 6c 69 74 65 33  _step,.  sqlite3
0f80: 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65  _table_column_me
0f90: 74 61 64 61 74 61 2c 0a 20 20 73 71 6c 69 74 65  tadata,.  sqlite
0fa0: 33 5f 74 68 72 65 61 64 5f 63 6c 65 61 6e 75 70  3_thread_cleanup
0fb0: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 74 6f 74 61  ,.  sqlite3_tota
0fc0: 6c 5f 63 68 61 6e 67 65 73 2c 0a 20 20 73 71 6c  l_changes,.  sql
0fd0: 69 74 65 33 5f 74 72 61 63 65 2c 0a 20 20 73 71  ite3_trace,.  sq
0fe0: 6c 69 74 65 33 5f 74 72 61 6e 73 66 65 72 5f 62  lite3_transfer_b
0ff0: 69 6e 64 69 6e 67 73 2c 0a 20 20 73 71 6c 69 74  indings,.  sqlit
1000: 65 33 5f 75 70 64 61 74 65 5f 68 6f 6f 6b 2c 0a  e3_update_hook,.
1010: 20 20 73 71 6c 69 74 65 33 5f 75 73 65 72 5f 64    sqlite3_user_d
1020: 61 74 61 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  ata,.  sqlite3_v
1030: 61 6c 75 65 5f 62 6c 6f 62 2c 0a 20 20 73 71 6c  alue_blob,.  sql
1040: 69 74 65 33 5f 76 61 6c 75 65 5f 62 79 74 65 73  ite3_value_bytes
1050: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  ,.  sqlite3_valu
1060: 65 5f 62 79 74 65 73 31 36 2c 0a 20 20 73 71 6c  e_bytes16,.  sql
1070: 69 74 65 33 5f 76 61 6c 75 65 5f 64 6f 75 62 6c  ite3_value_doubl
1080: 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  e,.  sqlite3_val
1090: 75 65 5f 69 6e 74 2c 0a 20 20 73 71 6c 69 74 65  ue_int,.  sqlite
10a0: 33 5f 76 61 6c 75 65 5f 69 6e 74 36 34 2c 0a 20  3_value_int64,. 
10b0: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 6e   sqlite3_value_n
10c0: 75 6d 65 72 69 63 5f 74 79 70 65 2c 0a 20 20 73  umeric_type,.  s
10d0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78  qlite3_value_tex
10e0: 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c  t,.  sqlite3_val
10f0: 75 65 5f 74 65 78 74 31 36 2c 0a 20 20 73 71 6c  ue_text16,.  sql
1100: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31  ite3_value_text1
1110: 36 62 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  6be,.  sqlite3_v
1120: 61 6c 75 65 5f 74 65 78 74 31 36 6c 65 2c 0a 20  alue_text16le,. 
1130: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74   sqlite3_value_t
1140: 79 70 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76  ype,.  sqlite3_v
1150: 6d 70 72 69 6e 74 66 2c 0a 20 20 2f 2a 0a 20 20  mprintf,.  /*.  
1160: 2a 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20  ** The original 
1170: 41 50 49 20 73 65 74 20 65 6e 64 73 20 68 65 72  API set ends her
1180: 65 2e 20 20 41 6c 6c 20 65 78 74 65 6e 73 69 6f  e.  All extensio
1190: 6e 73 20 63 61 6e 20 63 61 6c 6c 20 61 6e 79 0a  ns can call any.
11a0: 20 20 2a 2a 20 6f 66 20 74 68 65 20 41 50 49 73    ** of the APIs
11b0: 20 61 62 6f 76 65 20 70 72 6f 76 69 64 65 64 20   above provided 
11c0: 74 68 61 74 20 74 68 65 20 70 6f 69 6e 74 65 72  that the pointer
11d0: 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 2e 20 20 42   is not NULL.  B
11e0: 75 74 0a 20 20 2a 2a 20 62 65 66 6f 72 65 20 63  ut.  ** before c
11f0: 61 6c 6c 69 6e 67 20 41 50 49 73 20 74 68 61 74  alling APIs that
1200: 20 66 6f 6c 6c 6f 77 2c 20 65 78 74 65 6e 73 69   follow, extensi
1210: 6f 6e 20 73 68 6f 75 6c 64 20 63 68 65 63 6b 20  on should check 
1220: 74 68 65 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33  the.  ** sqlite3
1230: 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 6d 62  _libversion_numb
1240: 65 72 28 29 20 74 6f 20 6d 61 6b 65 20 73 75 72  er() to make sur
1250: 65 20 74 68 65 79 20 61 72 65 20 64 65 61 6c 69  e they are deali
1260: 6e 67 20 77 69 74 68 0a 20 20 2a 2a 20 61 20 6c  ng with.  ** a l
1270: 69 62 72 61 72 79 20 74 68 61 74 20 69 73 20 6e  ibrary that is n
1280: 65 77 20 65 6e 6f 75 67 68 20 74 6f 20 73 75 70  ew enough to sup
1290: 70 6f 72 74 20 74 68 61 74 20 41 50 49 2e 0a 20  port that API.. 
12a0: 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a   ***************
12b0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12c0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12d0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
12e0: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2f 0a  **********.  */.
12f0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 77 69  };../*.** The wi
1300: 6e 64 6f 77 73 20 69 6d 70 6c 65 6d 65 6e 74 61  ndows implementa
1310: 74 69 6f 6e 20 6f 66 20 73 68 61 72 65 64 2d 6c  tion of shared-l
1320: 69 62 72 61 72 79 20 6c 6f 61 64 65 72 73 0a 2a  ibrary loaders.*
1330: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 57  /.#if defined(_W
1340: 49 4e 33 32 29 20 7c 7c 20 64 65 66 69 6e 65 64  IN32) || defined
1350: 28 57 49 4e 33 32 29 20 7c 7c 20 64 65 66 69 6e  (WIN32) || defin
1360: 65 64 28 5f 5f 4d 49 4e 47 57 33 32 5f 5f 29 20  ed(__MINGW32__) 
1370: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 42 4f 52  || defined(__BOR
1380: 4c 41 4e 44 43 5f 5f 29 0a 23 20 69 6e 63 6c 75  LANDC__).# inclu
1390: 64 65 20 3c 77 69 6e 64 6f 77 73 2e 68 3e 0a 23  de <windows.h>.#
13a0: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c   define SQLITE_L
13b0: 49 42 52 41 52 59 5f 54 59 50 45 20 20 20 20 20  IBRARY_TYPE     
13c0: 48 41 4e 44 4c 45 0a 23 20 64 65 66 69 6e 65 20  HANDLE.# define 
13d0: 53 51 4c 49 54 45 5f 4f 50 45 4e 5f 4c 49 42 52  SQLITE_OPEN_LIBR
13e0: 41 52 59 28 41 29 20 20 4c 6f 61 64 4c 69 62 72  ARY(A)  LoadLibr
13f0: 61 72 79 28 41 29 0a 23 20 64 65 66 69 6e 65 20  ary(A).# define 
1400: 53 51 4c 49 54 45 5f 46 49 4e 44 5f 53 59 4d 42  SQLITE_FIND_SYMB
1410: 4f 4c 28 41 2c 42 29 20 47 65 74 50 72 6f 63 41  OL(A,B) GetProcA
1420: 64 64 72 65 73 73 28 41 2c 42 29 0a 23 20 64 65  ddress(A,B).# de
1430: 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 4c 4f 53  fine SQLITE_CLOS
1440: 45 5f 4c 49 42 52 41 52 59 28 41 29 20 46 72 65  E_LIBRARY(A) Fre
1450: 65 4c 69 62 72 61 72 79 28 41 29 0a 23 65 6e 64  eLibrary(A).#end
1460: 69 66 20 2f 2a 20 77 69 6e 64 6f 77 73 20 2a 2f  if /* windows */
1470: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 75 6e 69 78  ../*.** The unix
1480: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20   implementation 
1490: 6f 66 20 73 68 61 72 65 64 2d 6c 69 62 72 61 72  of shared-librar
14a0: 79 20 6c 6f 61 64 65 72 73 0a 2a 2f 0a 23 69 66  y loaders.*/.#if
14b0: 20 64 65 66 69 6e 65 64 28 48 41 56 45 5f 44 4c   defined(HAVE_DL
14c0: 4f 50 45 4e 29 20 26 26 20 21 64 65 66 69 6e 65  OPEN) && !define
14d0: 64 28 53 51 4c 49 54 45 5f 4c 49 42 52 41 52 59  d(SQLITE_LIBRARY
14e0: 5f 54 59 50 45 29 0a 23 20 69 6e 63 6c 75 64 65  _TYPE).# include
14f0: 20 3c 64 6c 66 63 6e 2e 68 3e 0a 23 20 64 65 66   <dlfcn.h>.# def
1500: 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 42 52 41  ine SQLITE_LIBRA
1510: 52 59 5f 54 59 50 45 20 20 20 20 20 76 6f 69 64  RY_TYPE     void
1520: 2a 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54  *.# define SQLIT
1530: 45 5f 4f 50 45 4e 5f 4c 49 42 52 41 52 59 28 41  E_OPEN_LIBRARY(A
1540: 29 20 20 64 6c 6f 70 65 6e 28 41 2c 20 52 54 4c  )  dlopen(A, RTL
1550: 44 5f 4e 4f 57 20 7c 20 52 54 4c 44 5f 47 4c 4f  D_NOW | RTLD_GLO
1560: 42 41 4c 29 0a 23 20 64 65 66 69 6e 65 20 53 51  BAL).# define SQ
1570: 4c 49 54 45 5f 46 49 4e 44 5f 53 59 4d 42 4f 4c  LITE_FIND_SYMBOL
1580: 28 41 2c 42 29 20 64 6c 73 79 6d 28 41 2c 42 29  (A,B) dlsym(A,B)
1590: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45  .# define SQLITE
15a0: 5f 43 4c 4f 53 45 5f 4c 49 42 52 41 52 59 28 41  _CLOSE_LIBRARY(A
15b0: 29 20 64 6c 63 6c 6f 73 65 28 41 29 0a 23 65 6e  ) dlclose(A).#en
15c0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d  dif../*.** Attem
15d0: 70 74 20 74 6f 20 6c 6f 61 64 20 61 6e 20 53 51  pt to load an SQ
15e0: 4c 69 74 65 20 65 78 74 65 6e 73 69 6f 6e 20 6c  Lite extension l
15f0: 69 62 72 61 72 79 20 63 6f 6e 74 61 69 6e 65 64  ibrary contained
1600: 20 69 6e 20 74 68 65 20 66 69 6c 65 0a 2a 2a 20   in the file.** 
1610: 7a 46 69 6c 65 2e 20 20 54 68 65 20 65 6e 74 72  zFile.  The entr
1620: 79 20 70 6f 69 6e 74 20 69 73 20 7a 50 72 6f 63  y point is zProc
1630: 2e 20 20 7a 50 72 6f 63 20 6d 61 79 20 62 65 20  .  zProc may be 
1640: 30 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20  0 in which case 
1650: 74 68 65 0a 2a 2a 20 6e 61 6d 65 20 6f 66 20 74  the.** name of t
1660: 68 65 20 65 6e 74 72 79 20 70 6f 69 6e 74 20 69  he entry point i
1670: 73 20 64 65 72 69 76 65 64 20 66 72 6f 6d 20 74  s derived from t
1680: 68 65 20 66 69 6c 65 6e 61 6d 65 2e 0a 2a 2a 0a  he filename..**.
1690: 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  ** Return SQLITE
16a0: 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 20 61  _OK on success a
16b0: 6e 64 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20  nd SQLITE_ERROR 
16c0: 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65  if something goe
16d0: 73 20 77 72 6f 6e 67 2e 0a 2a 2a 0a 2a 2a 20 49  s wrong..**.** I
16e0: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
16f0: 73 20 61 6e 64 20 70 7a 45 72 72 4d 73 67 20 69  s and pzErrMsg i
1700: 73 20 6e 6f 74 20 30 2c 20 74 68 65 6e 20 66 69  s not 0, then fi
1710: 6c 6c 20 2a 70 7a 45 72 72 4d 73 67 20 77 69 74  ll *pzErrMsg wit
1720: 68 20 0a 2a 2a 20 65 72 72 6f 72 20 6d 65 73 73  h .** error mess
1730: 61 67 65 20 74 65 78 74 2e 20 20 54 68 65 20 63  age text.  The c
1740: 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20  alling function 
1750: 73 68 6f 75 6c 64 20 66 72 65 65 20 74 68 69 73  should free this
1760: 20 6d 65 6d 6f 72 79 0a 2a 2a 20 62 79 20 63 61   memory.** by ca
1770: 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 5f 66 72  lling sqlite3_fr
1780: 65 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ee()..**.** The 
1790: 65 6e 74 72 79 20 70 6f 69 6e 74 20 6e 61 6d 65  entry point name
17a0: 20 69 73 20 64 65 72 69 76 65 64 20 66 72 6f 6d   is derived from
17b0: 20 74 68 65 20 66 69 6c 65 6e 61 6d 65 20 61 63   the filename ac
17c0: 63 6f 72 64 69 6e 67 20 74 6f 20 74 68 65 0a 2a  cording to the.*
17d0: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 65 70  * following step
17e0: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 2a 20 43 6f  s:.**.**    * Co
17f0: 6e 76 65 72 74 20 74 68 65 20 6e 61 6d 65 20 74  nvert the name t
1800: 6f 20 6c 6f 77 65 72 20 63 61 73 65 0a 2a 2a 20  o lower case.** 
1810: 20 20 20 2a 20 52 65 6d 6f 76 65 20 74 68 65 20     * Remove the 
1820: 70 61 74 68 20 70 72 65 66 69 78 20 66 72 6f 6d  path prefix from
1830: 20 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 20 20 20   the name.**    
1840: 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 66 69 72  * Remove the fir
1850: 73 74 20 22 2e 22 20 61 6e 64 20 61 6c 6c 20 66  st "." and all f
1860: 6f 6c 6c 6f 77 69 6e 67 20 63 68 61 72 61 63 74  ollowing charact
1870: 65 72 73 20 66 72 6f 6d 20 74 68 65 20 6e 61 6d  ers from the nam
1880: 65 0a 2a 2a 20 20 20 20 2a 20 49 66 20 74 68 65  e.**    * If the
1890: 20 6e 61 6d 65 20 62 65 67 69 6e 73 20 77 69 74   name begins wit
18a0: 68 20 22 6c 69 62 22 20 72 65 6d 6f 76 65 20 74  h "lib" remove t
18b0: 68 65 20 66 69 72 73 74 20 33 20 63 68 61 72 61  he first 3 chara
18c0: 63 74 65 72 73 0a 2a 2a 20 20 20 20 2a 20 52 65  cters.**    * Re
18d0: 6d 6f 76 65 20 61 6c 6c 20 63 68 61 72 61 63 74  move all charact
18e0: 65 72 73 20 74 68 61 74 20 61 72 65 20 6e 6f 74  ers that are not
18f0: 20 55 53 2d 41 53 43 49 49 20 61 6c 70 68 61 6e   US-ASCII alphan
1900: 75 6d 65 72 69 63 73 0a 2a 2a 20 20 20 20 20 20  umerics.**      
1910: 6f 72 20 75 6e 64 65 72 73 63 6f 72 65 73 0a 2a  or underscores.*
1920: 2a 20 20 20 20 2a 20 52 65 6d 6f 76 65 20 61 6e  *    * Remove an
1930: 79 20 6c 65 61 64 69 6e 67 20 64 69 67 69 74 73  y leading digits
1940: 20 61 6e 64 20 75 6e 64 65 72 73 63 6f 72 65 73   and underscores
1950: 20 66 72 6f 6d 20 74 68 65 20 6e 61 6d 65 0a 2a   from the name.*
1960: 2a 20 20 20 20 2a 20 41 70 70 65 6e 64 20 22 5f  *    * Append "_
1970: 69 6e 69 74 22 20 74 6f 20 74 68 65 20 6e 61 6d  init" to the nam
1980: 65 0a 2a 2a 0a 2a 2a 20 53 6f 2c 20 66 6f 72 20  e.**.** So, for 
1990: 65 78 61 6d 70 6c 65 2c 20 69 66 20 74 68 65 20  example, if the 
19a0: 69 6e 70 75 74 20 66 69 6c 65 6e 61 6d 65 20 69  input filename i
19b0: 73 20 22 2f 68 6f 6d 65 2f 64 72 68 2f 6c 69 62  s "/home/drh/lib
19c0: 74 65 73 74 31 2e 35 32 2e 73 6f 22 0a 2a 2a 20  test1.52.so".** 
19d0: 74 68 65 6e 20 74 68 65 20 65 6e 74 72 79 20 70  then the entry p
19e0: 6f 69 6e 74 20 77 6f 75 6c 64 20 62 65 20 63 6f  oint would be co
19f0: 6d 70 75 74 65 64 20 61 73 20 22 74 65 73 74 31  mputed as "test1
1a00: 5f 69 6e 69 74 22 2e 0a 2a 2a 0a 2a 2a 20 54 68  _init"..**.** Th
1a10: 65 20 64 65 72 69 76 65 64 20 65 6e 74 72 79 20  e derived entry 
1a20: 70 6f 69 6e 74 20 6e 61 6d 65 20 69 73 20 6c 69  point name is li
1a30: 6d 69 74 65 64 20 74 6f 20 61 20 72 65 61 73 6f  mited to a reaso
1a40: 6e 61 62 6c 65 20 6e 75 6d 62 65 72 20 6f 66 0a  nable number of.
1a50: 2a 2a 20 63 68 61 72 61 63 74 65 72 73 20 28 63  ** characters (c
1a60: 75 72 72 65 6e 74 6c 79 20 32 30 30 29 2e 0a 2a  urrently 200)..*
1a70: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c 6f  /.int sqlite3_lo
1a80: 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 0a 20 20  ad_extension(.  
1a90: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
1aa0: 20 20 20 20 20 20 2f 2a 20 4c 6f 61 64 20 74 68        /* Load th
1ab0: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 6e 74 6f  e extension into
1ac0: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 63   this database c
1ad0: 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63  onnection */.  c
1ae0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65  onst char *zFile
1af0: 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20  ,    /* Name of 
1b00: 74 68 65 20 73 68 61 72 65 64 20 6c 69 62 72 61  the shared libra
1b10: 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 78  ry containing ex
1b20: 74 65 6e 73 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e  tension */.  con
1b30: 73 74 20 63 68 61 72 20 2a 7a 50 72 6f 63 2c 20  st char *zProc, 
1b40: 20 20 20 2f 2a 20 45 6e 74 72 79 20 70 6f 69 6e     /* Entry poin
1b50: 74 2e 20 20 44 65 72 69 76 65 64 20 66 72 6f 6d  t.  Derived from
1b60: 20 7a 46 69 6c 65 20 69 66 20 30 20 2a 2f 0a 20   zFile if 0 */. 
1b70: 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67   char **pzErrMsg
1b80: 20 20 20 20 20 20 20 2f 2a 20 50 75 74 20 65 72         /* Put er
1b90: 72 6f 72 20 6d 65 73 73 61 67 65 20 68 65 72 65  ror message here
1ba0: 20 69 66 20 6e 6f 74 20 30 20 2a 2f 0a 29 7b 0a   if not 0 */.){.
1bb0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4c 49  #ifdef SQLITE_LI
1bc0: 42 52 41 52 59 5f 54 59 50 45 0a 20 20 53 51 4c  BRARY_TYPE.  SQL
1bd0: 49 54 45 5f 4c 49 42 52 41 52 59 5f 54 59 50 45  ITE_LIBRARY_TYPE
1be0: 20 68 61 6e 64 6c 65 3b 0a 20 20 69 6e 74 20 28   handle;.  int (
1bf0: 2a 78 49 6e 69 74 29 28 73 71 6c 69 74 65 33 2a  *xInit)(sqlite3*
1c00: 2c 63 68 61 72 2a 2a 2c 63 6f 6e 73 74 20 73 71  ,char**,const sq
1c10: 6c 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e  lite3_api_routin
1c20: 65 73 2a 29 3b 0a 20 20 63 68 61 72 20 2a 7a 45  es*);.  char *zE
1c30: 72 72 6d 73 67 20 3d 20 30 3b 0a 20 20 53 51 4c  rrmsg = 0;.  SQL
1c40: 49 54 45 5f 4c 49 42 52 41 52 59 5f 54 59 50 45  ITE_LIBRARY_TYPE
1c50: 20 2a 61 48 61 6e 64 6c 65 3b 0a 0a 20 20 64 62   *aHandle;..  db
1c60: 2d 3e 6e 45 78 74 65 6e 73 69 6f 6e 2b 2b 3b 0a  ->nExtension++;.
1c70: 20 20 61 48 61 6e 64 6c 65 20 3d 20 73 71 6c 69    aHandle = sqli
1c80: 74 65 4d 61 6c 6c 6f 63 28 73 69 7a 65 6f 66 28  teMalloc(sizeof(
1c90: 68 61 6e 64 6c 65 29 2a 64 62 2d 3e 6e 45 78 74  handle)*db->nExt
1ca0: 65 6e 73 69 6f 6e 29 3b 0a 20 20 69 66 28 20 61  ension);.  if( a
1cb0: 48 61 6e 64 6c 65 3d 3d 30 20 29 7b 0a 20 20 20  Handle==0 ){.   
1cc0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e   return SQLITE_N
1cd0: 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28 20  OMEM;.  }.  if( 
1ce0: 64 62 2d 3e 6e 45 78 74 65 6e 73 69 6f 6e 3e 30  db->nExtension>0
1cf0: 20 29 7b 0a 20 20 20 20 6d 65 6d 63 70 79 28 61   ){.    memcpy(a
1d00: 48 61 6e 64 6c 65 2c 20 64 62 2d 3e 61 45 78 74  Handle, db->aExt
1d10: 65 6e 73 69 6f 6e 2c 20 73 69 7a 65 6f 66 28 68  ension, sizeof(h
1d20: 61 6e 64 6c 65 29 2a 28 64 62 2d 3e 6e 45 78 74  andle)*(db->nExt
1d30: 65 6e 73 69 6f 6e 2d 31 29 29 3b 0a 20 20 7d 0a  ension-1));.  }.
1d40: 20 20 73 71 6c 69 74 65 46 72 65 65 28 64 62 2d    sqliteFree(db-
1d50: 3e 61 45 78 74 65 6e 73 69 6f 6e 29 3b 0a 20 20  >aExtension);.  
1d60: 64 62 2d 3e 61 45 78 74 65 6e 73 69 6f 6e 20 3d  db->aExtension =
1d70: 20 61 48 61 6e 64 6c 65 3b 0a 20 20 69 66 28 20   aHandle;.  if( 
1d80: 7a 50 72 6f 63 3d 3d 30 20 29 7b 0a 20 20 20 20  zProc==0 ){.    
1d90: 69 6e 74 20 69 2c 20 6a 2c 20 6e 3b 0a 20 20 20  int i, j, n;.   
1da0: 20 63 68 61 72 20 2a 7a 3b 0a 20 20 20 20 63 68   char *z;.    ch
1db0: 61 72 20 7a 42 75 66 5b 32 30 30 5d 3b 0a 20 20  ar zBuf[200];.  
1dc0: 20 20 6e 20 3d 20 73 74 72 6c 65 6e 28 7a 46 69    n = strlen(zFi
1dd0: 6c 65 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d 6e  le);.    for(i=n
1de0: 2d 31 3b 20 69 3e 30 20 26 26 20 7a 46 69 6c 65  -1; i>0 && zFile
1df0: 5b 69 2d 31 5d 21 3d 27 2f 27 3b 20 69 2d 2d 29  [i-1]!='/'; i--)
1e00: 7b 7d 0a 20 20 20 20 66 6f 72 28 6a 3d 69 3b 20  {}.    for(j=i; 
1e10: 7a 46 69 6c 65 5b 6a 5d 20 26 26 20 7a 46 69 6c  zFile[j] && zFil
1e20: 65 5b 6a 5d 21 3d 27 2e 27 3b 20 6a 2b 2b 29 7b  e[j]!='.'; j++){
1e30: 7d 0a 20 20 20 20 69 66 28 20 6a 2d 69 20 3e 20  }.    if( j-i > 
1e40: 73 69 7a 65 6f 66 28 7a 42 75 66 29 2d 31 30 20  sizeof(zBuf)-10 
1e50: 29 20 6a 20 3d 20 69 20 2b 20 73 69 7a 65 6f 66  ) j = i + sizeof
1e60: 28 7a 42 75 66 29 20 2d 20 31 30 3b 0a 20 20 20  (zBuf) - 10;.   
1e70: 20 6d 65 6d 63 70 79 28 7a 42 75 66 2c 20 26 7a   memcpy(zBuf, &z
1e80: 46 69 6c 65 5b 69 5d 2c 20 6a 20 2d 20 69 29 3b  File[i], j - i);
1e90: 0a 20 20 20 20 7a 42 75 66 5b 6a 20 2d 20 69 5d  .    zBuf[j - i]
1ea0: 20 3d 20 30 3b 0a 20 20 20 20 7a 20 3d 20 7a 42   = 0;.    z = zB
1eb0: 75 66 3b 0a 20 20 20 20 66 6f 72 28 69 3d 6a 3d  uf;.    for(i=j=
1ec0: 30 3b 20 7a 5b 69 5d 3b 20 69 2b 2b 29 7b 0a 20  0; z[i]; i++){. 
1ed0: 20 20 20 20 20 69 6e 74 20 63 20 3d 20 7a 5b 69       int c = z[i
1ee0: 5d 3b 0a 20 20 20 20 20 20 69 66 28 20 28 63 20  ];.      if( (c 
1ef0: 26 20 30 78 38 30 29 21 3d 30 20 7c 7c 20 28 21  & 0x80)!=0 || (!
1f00: 69 73 61 6c 6e 75 6d 28 63 29 20 26 26 20 63 21  isalnum(c) && c!
1f10: 3d 27 5f 27 29 20 29 20 63 6f 6e 74 69 6e 75 65  ='_') ) continue
1f20: 3b 0a 20 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d  ;.      z[j++] =
1f30: 20 74 6f 6c 6f 77 65 72 28 63 29 3b 0a 20 20 20   tolower(c);.   
1f40: 20 7d 0a 20 20 20 20 7a 5b 6a 5d 20 3d 20 30 3b   }.    z[j] = 0;
1f50: 0a 20 20 20 20 69 66 28 20 73 74 72 6e 63 6d 70  .    if( strncmp
1f60: 28 7a 2c 20 22 6c 69 62 22 2c 20 33 29 3d 3d 30  (z, "lib", 3)==0
1f70: 20 29 7b 0a 20 20 20 20 20 20 7a 20 2b 3d 20 33   ){.      z += 3
1f80: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 77 68 69 6c  ;.    }.    whil
1f90: 65 28 20 7a 5b 30 5d 20 26 26 20 21 69 73 61 6c  e( z[0] && !isal
1fa0: 70 68 61 28 7a 5b 30 5d 29 20 29 7b 0a 20 20 20  pha(z[0]) ){.   
1fb0: 20 20 20 7a 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20     z++;.    }.  
1fc0: 20 20 73 74 72 63 61 74 28 7a 2c 20 22 5f 69 6e    strcat(z, "_in
1fd0: 69 74 22 29 3b 0a 20 20 20 20 7a 50 72 6f 63 20  it");.    zProc 
1fe0: 3d 20 7a 3b 0a 20 20 7d 0a 0a 20 20 68 61 6e 64  = z;.  }..  hand
1ff0: 6c 65 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e  le = SQLITE_OPEN
2000: 5f 4c 49 42 52 41 52 59 28 7a 46 69 6c 65 29 3b  _LIBRARY(zFile);
2010: 0a 20 20 69 66 28 20 68 61 6e 64 6c 65 3d 3d 30  .  if( handle==0
2020: 20 29 7b 0a 20 20 20 20 69 66 28 20 70 7a 45 72   ){.    if( pzEr
2030: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 2a 70  rMsg ){.      *p
2040: 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65  zErrMsg = sqlite
2050: 33 5f 6d 70 72 69 6e 74 66 28 22 75 6e 61 62 6c  3_mprintf("unabl
2060: 65 20 74 6f 20 6f 70 65 6e 20 73 68 61 72 65 64  e to open shared
2070: 20 6c 69 62 72 61 72 79 20 5b 25 73 5d 22 2c 20   library [%s]", 
2080: 7a 46 69 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20  zFile);.    }.  
2090: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
20a0: 45 52 52 4f 52 3b 0a 20 20 7d 0a 20 20 78 49 6e  ERROR;.  }.  xIn
20b0: 69 74 20 3d 20 28 69 6e 74 28 2a 29 28 73 71 6c  it = (int(*)(sql
20c0: 69 74 65 33 2a 2c 63 68 61 72 2a 2a 2c 63 6f 6e  ite3*,char**,con
20d0: 73 74 20 73 71 6c 69 74 65 33 5f 61 70 69 5f 72  st sqlite3_api_r
20e0: 6f 75 74 69 6e 65 73 2a 29 29 0a 20 20 20 20 20  outines*)).     
20f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51                SQ
2100: 4c 49 54 45 5f 46 49 4e 44 5f 53 59 4d 42 4f 4c  LITE_FIND_SYMBOL
2110: 28 68 61 6e 64 6c 65 2c 20 7a 50 72 6f 63 29 3b  (handle, zProc);
2120: 0a 20 20 69 66 28 20 78 49 6e 69 74 3d 3d 30 20  .  if( xInit==0 
2130: 29 7b 0a 20 20 20 20 69 66 28 20 70 7a 45 72 72  ){.    if( pzErr
2140: 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 20 2a 70  Msg ){.       *p
2150: 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65  zErrMsg = sqlite
2160: 33 5f 6d 70 72 69 6e 74 66 28 22 6e 6f 20 65 6e  3_mprintf("no en
2170: 74 72 79 20 70 6f 69 6e 74 20 5b 25 73 5d 20 69  try point [%s] i
2180: 6e 20 73 68 61 72 65 64 20 6c 69 62 72 61 72 79  n shared library
2190: 20 5b 25 73 5d 22 2c 0a 20 20 20 20 20 20 20 20   [%s]",.        
21a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21b0: 20 20 20 20 20 20 20 20 20 20 20 7a 50 72 6f 63             zProc
21c0: 2c 20 7a 46 69 6c 65 29 3b 0a 20 20 20 20 7d 0a  , zFile);.    }.
21d0: 20 20 20 20 53 51 4c 49 54 45 5f 43 4c 4f 53 45      SQLITE_CLOSE
21e0: 5f 4c 49 42 52 41 52 59 28 68 61 6e 64 6c 65 29  _LIBRARY(handle)
21f0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
2200: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c  ITE_ERROR;.  }el
2210: 73 65 20 69 66 28 20 78 49 6e 69 74 28 64 62 2c  se if( xInit(db,
2220: 20 26 7a 45 72 72 6d 73 67 2c 20 26 73 71 6c 69   &zErrmsg, &sqli
2230: 74 65 33 5f 61 70 69 29 20 29 7b 0a 20 20 20 20  te3_api) ){.    
2240: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a  if( pzErrMsg ){.
2250: 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20        *pzErrMsg 
2260: 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74  = sqlite3_mprint
2270: 66 28 22 65 72 72 6f 72 20 64 75 72 69 6e 67 20  f("error during 
2280: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 3a 20  initialization: 
2290: 25 73 22 2c 20 7a 45 72 72 6d 73 67 29 3b 0a 20  %s", zErrmsg);. 
22a0: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
22b0: 5f 66 72 65 65 28 7a 45 72 72 6d 73 67 29 3b 0a  _free(zErrmsg);.
22c0: 20 20 20 20 53 51 4c 49 54 45 5f 43 4c 4f 53 45      SQLITE_CLOSE
22d0: 5f 4c 49 42 52 41 52 59 28 68 61 6e 64 6c 65 29  _LIBRARY(handle)
22e0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
22f0: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 20  ITE_ERROR;.  }. 
2300: 20 28 28 53 51 4c 49 54 45 5f 4c 49 42 52 41 52   ((SQLITE_LIBRAR
2310: 59 5f 54 59 50 45 2a 29 64 62 2d 3e 61 45 78 74  Y_TYPE*)db->aExt
2320: 65 6e 73 69 6f 6e 29 5b 64 62 2d 3e 6e 45 78 74  ension)[db->nExt
2330: 65 6e 73 69 6f 6e 2d 31 5d 20 3d 20 68 61 6e 64  ension-1] = hand
2340: 6c 65 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  le;.  return SQL
2350: 49 54 45 5f 4f 4b 3b 0a 23 65 6c 73 65 0a 20 20  ITE_OK;.#else.  
2360: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a  if( pzErrMsg ){.
2370: 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 3d 20      *pzErrMsg = 
2380: 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28  sqlite3_mprintf(
2390: 22 65 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 69  "extension loadi
23a0: 6e 67 20 69 73 20 64 69 73 61 62 6c 65 64 22 29  ng is disabled")
23b0: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 53  ;.  }.  return S
23c0: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 23 65 6e  QLITE_ERROR;.#en
23d0: 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c  dif.}../*.** Cal
23e0: 6c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 77  l this routine w
23f0: 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  hen the database
2400: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 63   connection is c
2410: 6c 6f 73 69 6e 67 20 69 6e 20 6f 72 64 65 72 0a  losing in order.
2420: 2a 2a 20 74 6f 20 63 6c 65 61 6e 20 75 70 20 6c  ** to clean up l
2430: 6f 61 64 65 64 20 65 78 74 65 6e 73 69 6f 6e 73  oaded extensions
2440: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
2450: 43 6c 6f 73 65 45 78 74 65 6e 73 69 6f 6e 73 28  CloseExtensions(
2460: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 23 69  sqlite3 *db){.#i
2470: 66 64 65 66 20 53 51 4c 49 54 45 5f 4c 49 42 52  fdef SQLITE_LIBR
2480: 41 52 59 5f 54 59 50 45 0a 20 20 69 6e 74 20 69  ARY_TYPE.  int i
2490: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64  ;.  for(i=0; i<d
24a0: 62 2d 3e 6e 45 78 74 65 6e 73 69 6f 6e 3b 20 69  b->nExtension; i
24b0: 2b 2b 29 7b 0a 20 20 20 20 53 51 4c 49 54 45 5f  ++){.    SQLITE_
24c0: 43 4c 4f 53 45 5f 4c 49 42 52 41 52 59 28 28 28  CLOSE_LIBRARY(((
24d0: 53 51 4c 49 54 45 5f 4c 49 42 52 41 52 59 5f 54  SQLITE_LIBRARY_T
24e0: 59 50 45 2a 29 64 62 2d 3e 61 45 78 74 65 6e 73  YPE*)db->aExtens
24f0: 69 6f 6e 29 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20  ion)[i]);.  }.  
2500: 73 71 6c 69 74 65 46 72 65 65 28 64 62 2d 3e 61  sqliteFree(db->a
2510: 45 78 74 65 6e 73 69 6f 6e 29 3b 0a 23 65 6e 64  Extension);.#end
2520: 69 66 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20  if.}..#endif /* 
2530: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44  SQLITE_OMIT_LOAD
2540: 5f 45 58 54 45 4e 53 49 4f 4e 20 2a 2f 0a        _EXTENSION */.