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 69 66 6e 64 65 66 20 53 51 4c 49 54 N..#ifndef SQLIT
0200: 45 5f 43 4f 52 45 0a 20 20 23 64 65 66 69 6e 65 E_CORE. #define
0210: 20 53 51 4c 49 54 45 5f 43 4f 52 45 20 31 20 20 SQLITE_CORE 1
0220: 2f 2a 20 44 69 73 61 62 6c 65 20 74 68 65 20 41 /* Disable the A
0230: 50 49 20 72 65 64 65 66 69 6e 69 74 69 6f 6e 20 PI redefinition
0240: 69 6e 20 73 71 6c 69 74 65 33 65 78 74 2e 68 20 in sqlite3ext.h
0250: 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 6e 63 6c 75 */.#endif.#inclu
0260: 64 65 20 22 73 71 6c 69 74 65 33 65 78 74 2e 68 de "sqlite3ext.h
0270: 22 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 ".#include "sqli
0280: 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63 6c 75 64 teInt.h".#includ
0290: 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 23 69 6e e <string.h>.#in
02a0: 63 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 3e 0a clude <ctype.h>.
02b0: 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 20 41 50 49 20 ./*.** Some API
02c0: 72 6f 75 74 69 6e 65 73 20 61 72 65 20 6f 6d 69 routines are omi
02d0: 74 74 65 64 20 77 68 65 6e 20 76 61 72 69 6f 75 tted when variou
02e0: 73 20 66 65 61 74 75 72 65 73 20 61 72 65 0a 2a s features are.*
02f0: 2a 20 65 78 63 6c 75 64 65 64 20 66 72 6f 6d 20 * excluded from
0300: 61 20 62 75 69 6c 64 20 6f 66 20 53 51 4c 69 74 a build of SQLit
0310: 65 2e 20 20 53 75 62 73 74 69 74 75 74 65 20 61 e. Substitute a
0320: 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 0a 2a 2a NULL pointer.**
0330: 20 66 6f 72 20 61 6e 79 20 6d 69 73 73 69 6e 67 for any missing
0340: 20 41 50 49 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 APIs..*/.#ifnde
0350: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
0360: 43 4f 4c 55 4d 4e 5f 4d 45 54 41 44 41 54 41 0a COLUMN_METADATA.
0370: 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
0380: 5f 63 6f 6c 75 6d 6e 5f 64 61 74 61 62 61 73 65 _column_database
0390: 5f 6e 61 6d 65 20 20 20 30 0a 23 20 64 65 66 69 _name 0.# defi
03a0: 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d ne sqlite3_colum
03b0: 6e 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 n_database_name1
03c0: 36 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 6 0.# define sql
03d0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c ite3_column_tabl
03e0: 65 5f 6e 61 6d 65 20 20 20 20 20 20 30 0a 23 20 e_name 0.#
03f0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 define sqlite3_c
0400: 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f 6e 61 6d 65 olumn_table_name
0410: 31 36 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 16 0.# define
0420: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
0430: 6f 72 69 67 69 6e 5f 6e 61 6d 65 20 20 20 20 20 origin_name
0440: 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
0450: 65 33 5f 63 6f 6c 75 6d 6e 5f 6f 72 69 67 69 6e e3_column_origin
0460: 5f 6e 61 6d 65 31 36 20 20 20 30 0a 23 20 64 65 _name16 0.# de
0470: 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 74 61 62 fine sqlite3_tab
0480: 6c 65 5f 63 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 le_column_metada
0490: 74 61 20 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 ta 0.#endif..#i
04a0: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
04b0: 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 23 _AUTHORIZATION.#
04c0: 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f define sqlite3_
04d0: 73 65 74 5f 61 75 74 68 6f 72 69 7a 65 72 20 20 set_authorizer
04e0: 20 20 20 20 20 20 20 30 0a 23 65 6e 64 69 66 0a 0.#endif.
04f0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
0500: 4d 49 54 5f 55 54 46 31 36 0a 23 20 64 65 66 69 MIT_UTF16.# defi
0510: 6e 65 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f ne sqlite3_bind_
0520: 74 65 78 74 31 36 20 20 20 20 20 20 20 20 20 20 text16
0530: 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 0.# define sql
0540: 69 74 65 33 5f 63 6f 6c 6c 61 74 69 6f 6e 5f 6e ite3_collation_n
0550: 65 65 64 65 64 31 36 20 20 20 20 20 30 0a 23 20 eeded16 0.#
0560: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 define sqlite3_c
0570: 6f 6c 75 6d 6e 5f 64 65 63 6c 74 79 70 65 31 36 olumn_decltype16
0580: 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 0.# define
0590: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
05a0: 6e 61 6d 65 31 36 20 20 20 20 20 20 20 20 20 20 name16
05b0: 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
05c0: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 e3_column_text16
05d0: 20 20 20 20 20 20 20 20 20 20 30 0a 23 20 64 65 0.# de
05e0: 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d fine sqlite3_com
05f0: 70 6c 65 74 65 31 36 20 20 20 20 20 20 20 20 20 plete16
0600: 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 0.# define s
0610: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
0620: 6c 6c 61 74 69 6f 6e 31 36 20 20 20 20 20 30 0a llation16 0.
0630: 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
0640: 5f 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e _create_function
0650: 31 36 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 16 0.# defi
0660: 6e 65 20 73 71 6c 69 74 65 33 5f 65 72 72 6d 73 ne sqlite3_errms
0670: 67 31 36 20 20 20 20 20 20 20 20 20 20 20 20 20 g16
0680: 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 0.# define sql
0690: 69 74 65 33 5f 6f 70 65 6e 31 36 20 20 20 20 20 ite3_open16
06a0: 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 23 20 0.#
06b0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 70 define sqlite3_p
06c0: 72 65 70 61 72 65 31 36 20 20 20 20 20 20 20 20 repare16
06d0: 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 0.# define
06e0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
06f0: 31 36 5f 76 32 20 20 20 20 20 20 20 20 20 20 20 16_v2
0700: 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
0710: 65 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 31 e3_result_error1
0720: 36 20 20 20 20 20 20 20 20 20 30 0a 23 20 64 65 6 0.# de
0730: 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 72 65 73 fine sqlite3_res
0740: 75 6c 74 5f 74 65 78 74 31 36 20 20 20 20 20 20 ult_text16
0750: 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 0.# define s
0760: 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 qlite3_result_te
0770: 78 74 31 36 62 65 20 20 20 20 20 20 20 20 30 0a xt16be 0.
0780: 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
0790: 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 36 6c 65 _result_text16le
07a0: 20 20 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 0.# defi
07b0: 6e 65 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 ne sqlite3_value
07c0: 5f 74 65 78 74 31 36 20 20 20 20 20 20 20 20 20 _text16
07d0: 20 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 0.# define sql
07e0: 69 74 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 ite3_value_text1
07f0: 36 62 65 20 20 20 20 20 20 20 20 20 30 0a 23 20 6be 0.#
0800: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 76 define sqlite3_v
0810: 61 6c 75 65 5f 74 65 78 74 31 36 6c 65 20 20 20 alue_text16le
0820: 20 20 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 0.# define
0830: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
0840: 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 36 20 database_name16
0850: 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
0860: 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 6c 65 5f e3_column_table_
0870: 6e 61 6d 65 31 36 20 20 20 20 30 0a 23 20 64 65 name16 0.# de
0880: 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6c fine sqlite3_col
0890: 75 6d 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 31 umn_origin_name1
08a0: 36 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 6 0.#endif..#i
08b0: 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fdef SQLITE_OMIT
08c0: 5f 43 4f 4d 50 4c 45 54 45 0a 23 20 64 65 66 69 _COMPLETE.# defi
08d0: 6e 65 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c ne sqlite3_compl
08e0: 65 74 65 20 30 0a 23 20 64 65 66 69 6e 65 20 73 ete 0.# define s
08f0: 71 6c 69 74 65 33 5f 63 6f 6d 70 6c 65 74 65 31 qlite3_complete1
0900: 36 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 6 0.#endif..#ifd
0910: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 ef SQLITE_OMIT_P
0920: 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b ROGRESS_CALLBACK
0930: 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
0940: 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 3_progress_handl
0950: 65 72 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 er 0.#endif..#if
0960: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
0970: 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 23 20 64 VIRTUALTABLE.# d
0980: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 72 efine sqlite3_cr
0990: 65 61 74 65 5f 6d 6f 64 75 6c 65 20 30 0a 23 20 eate_module 0.#
09a0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 63 define sqlite3_c
09b0: 72 65 61 74 65 5f 6d 6f 64 75 6c 65 5f 76 32 20 reate_module_v2
09c0: 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
09d0: 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 62 20 e3_declare_vtab
09e0: 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 0.#endif..#ifdef
09f0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 SQLITE_OMIT_SHA
0a00: 52 45 44 5f 43 41 43 48 45 0a 23 20 64 65 66 69 RED_CACHE.# defi
0a10: 6e 65 20 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c ne sqlite3_enabl
0a20: 65 5f 73 68 61 72 65 64 5f 63 61 63 68 65 20 30 e_shared_cache 0
0a30: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
0a40: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 SQLITE_OMIT_TRAC
0a50: 45 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 E.# define sqlit
0a60: 65 33 5f 70 72 6f 66 69 6c 65 20 20 20 20 20 20 e3_profile
0a70: 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 0.# define sqli
0a80: 74 65 33 5f 74 72 61 63 65 20 20 20 20 20 20 20 te3_trace
0a90: 20 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 0.#endif..#ifd
0aa0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 47 ef SQLITE_OMIT_G
0ab0: 45 54 5f 54 41 42 4c 45 0a 23 20 64 65 66 69 6e ET_TABLE.# defin
0ac0: 65 20 73 71 6c 69 74 65 33 5f 66 72 65 65 5f 74 e sqlite3_free_t
0ad0: 61 62 6c 65 20 20 20 20 30 0a 23 20 64 65 66 69 able 0.# defi
0ae0: 6e 65 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 ne sqlite3_get_t
0af0: 61 62 6c 65 20 20 20 20 20 30 0a 23 65 6e 64 69 able 0.#endi
0b00: 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
0b10: 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 23 _OMIT_INCRBLOB.#
0b20: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f 62 define sqlite3_b
0b30: 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 20 20 30 0a ind_zeroblob 0.
0b40: 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 5f #define sqlite3_
0b50: 62 6c 6f 62 5f 62 79 74 65 73 20 20 20 20 20 30 blob_bytes 0
0b60: 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 .#define sqlite3
0b70: 5f 62 6c 6f 62 5f 63 6c 6f 73 65 20 20 20 20 20 _blob_close
0b80: 30 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 0.#define sqlite
0b90: 33 5f 62 6c 6f 62 5f 6f 70 65 6e 20 20 20 20 20 3_blob_open
0ba0: 20 30 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 0.#define sqlit
0bb0: 65 33 5f 62 6c 6f 62 5f 72 65 61 64 20 20 20 20 e3_blob_read
0bc0: 20 20 30 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 0.#define sqli
0bd0: 74 65 33 5f 62 6c 6f 62 5f 77 72 69 74 65 20 20 te3_blob_write
0be0: 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 0.#endif../*.
0bf0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
0c00: 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 structure conta
0c10: 69 6e 73 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 ins pointers to
0c20: 61 6c 6c 20 53 51 4c 69 74 65 20 41 50 49 20 72 all SQLite API r
0c30: 6f 75 74 69 6e 65 73 2e 0a 2a 2a 20 41 20 70 6f outines..** A po
0c40: 69 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 inter to this st
0c50: 72 75 63 74 75 72 65 20 69 73 20 70 61 73 73 65 ructure is passe
0c60: 64 20 69 6e 74 6f 20 65 78 74 65 6e 73 69 6f 6e d into extension
0c70: 73 20 77 68 65 6e 20 74 68 65 79 20 61 72 65 0a s when they are.
0c80: 2a 2a 20 6c 6f 61 64 65 64 20 73 6f 20 74 68 61 ** loaded so tha
0c90: 74 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 20 t the extension
0ca0: 63 61 6e 20 6d 61 6b 65 20 63 61 6c 6c 73 20 62 can make calls b
0cb0: 61 63 6b 20 69 6e 74 6f 20 74 68 65 20 53 51 4c ack into the SQL
0cc0: 69 74 65 0a 2a 2a 20 6c 69 62 72 61 72 79 2e 0a ite.** library..
0cd0: 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 64 64 69 6e **.** When addin
0ce0: 67 20 6e 65 77 20 41 50 49 73 2c 20 61 64 64 20 g new APIs, add
0cf0: 74 68 65 6d 20 74 6f 20 74 68 65 20 62 6f 74 74 them to the bott
0d00: 6f 6d 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 om of this struc
0d10: 74 75 72 65 0a 2a 2a 20 69 6e 20 6f 72 64 65 72 ture.** in order
0d20: 20 74 6f 20 70 72 65 73 65 72 76 65 20 62 61 63 to preserve bac
0d30: 6b 77 61 72 64 73 20 63 6f 6d 70 61 74 69 62 69 kwards compatibi
0d40: 6c 69 74 79 2e 0a 2a 2a 0a 2a 2a 20 45 78 74 65 lity..**.** Exte
0d50: 6e 73 69 6f 6e 73 20 74 68 61 74 20 75 73 65 20 nsions that use
0d60: 6e 65 77 65 72 20 41 50 49 73 20 73 68 6f 75 6c newer APIs shoul
0d70: 64 20 66 69 72 73 74 20 63 61 6c 6c 20 74 68 65 d first call the
0d80: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 6c 69 62 76 .** sqlite3_libv
0d90: 65 72 73 69 6f 6e 5f 6e 75 6d 62 65 72 28 29 20 ersion_number()
0da0: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 to make sure tha
0db0: 74 20 74 68 65 20 41 50 49 20 74 68 65 79 0a 2a t the API they.*
0dc0: 2a 20 69 6e 74 65 6e 64 20 74 6f 20 75 73 65 20 * intend to use
0dd0: 69 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 is supported by
0de0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 45 78 the library. Ex
0df0: 74 65 6e 73 69 6f 6e 73 20 73 68 6f 75 6c 64 0a tensions should.
0e00: 2a 2a 20 61 6c 73 6f 20 63 68 65 63 6b 20 74 6f ** also check to
0e10: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 make sure that
0e20: 74 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 the pointer to t
0e30: 68 65 20 66 75 6e 63 74 69 6f 6e 20 69 73 0a 2a he function is.*
0e40: 2a 20 6e 6f 74 20 4e 55 4c 4c 20 62 65 66 6f 72 * not NULL befor
0e50: 65 20 63 61 6c 6c 69 6e 67 20 69 74 2e 0a 2a 2f e calling it..*/
0e60: 0a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 61 .const sqlite3_a
0e70: 70 69 5f 72 6f 75 74 69 6e 65 73 20 73 71 6c 69 pi_routines sqli
0e80: 74 65 33 5f 61 70 69 73 20 3d 20 7b 0a 20 20 73 te3_apis = {. s
0e90: 71 6c 69 74 65 33 5f 61 67 67 72 65 67 61 74 65 qlite3_aggregate
0ea0: 5f 63 6f 6e 74 65 78 74 2c 0a 20 20 73 71 6c 69 _context,. sqli
0eb0: 74 65 33 5f 61 67 67 72 65 67 61 74 65 5f 63 6f te3_aggregate_co
0ec0: 75 6e 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 unt,. sqlite3_b
0ed0: 69 6e 64 5f 62 6c 6f 62 2c 0a 20 20 73 71 6c 69 ind_blob,. sqli
0ee0: 74 65 33 5f 62 69 6e 64 5f 64 6f 75 62 6c 65 2c te3_bind_double,
0ef0: 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f . sqlite3_bind_
0f00: 69 6e 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 int,. sqlite3_b
0f10: 69 6e 64 5f 69 6e 74 36 34 2c 0a 20 20 73 71 6c ind_int64,. sql
0f20: 69 74 65 33 5f 62 69 6e 64 5f 6e 75 6c 6c 2c 0a ite3_bind_null,.
0f30: 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 sqlite3_bind_p
0f40: 61 72 61 6d 65 74 65 72 5f 63 6f 75 6e 74 2c 0a arameter_count,.
0f50: 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 sqlite3_bind_p
0f60: 61 72 61 6d 65 74 65 72 5f 69 6e 64 65 78 2c 0a arameter_index,.
0f70: 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 70 sqlite3_bind_p
0f80: 61 72 61 6d 65 74 65 72 5f 6e 61 6d 65 2c 0a 20 arameter_name,.
0f90: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65 sqlite3_bind_te
0fa0: 78 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 69 xt,. sqlite3_bi
0fb0: 6e 64 5f 74 65 78 74 31 36 2c 0a 20 20 73 71 6c nd_text16,. sql
0fc0: 69 74 65 33 5f 62 69 6e 64 5f 76 61 6c 75 65 2c ite3_bind_value,
0fd0: 0a 20 20 73 71 6c 69 74 65 33 5f 62 75 73 79 5f . sqlite3_busy_
0fe0: 68 61 6e 64 6c 65 72 2c 0a 20 20 73 71 6c 69 74 handler,. sqlit
0ff0: 65 33 5f 62 75 73 79 5f 74 69 6d 65 6f 75 74 2c e3_busy_timeout,
1000: 0a 20 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 . sqlite3_chang
1010: 65 73 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6c es,. sqlite3_cl
1020: 6f 73 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 ose,. sqlite3_c
1030: 6f 6c 6c 61 74 69 6f 6e 5f 6e 65 65 64 65 64 2c ollation_needed,
1040: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 6c 61 . sqlite3_colla
1050: 74 69 6f 6e 5f 6e 65 65 64 65 64 31 36 2c 0a 20 tion_needed16,.
1060: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
1070: 62 6c 6f 62 2c 0a 20 20 73 71 6c 69 74 65 33 5f blob,. sqlite3_
1080: 63 6f 6c 75 6d 6e 5f 62 79 74 65 73 2c 0a 20 20 column_bytes,.
1090: 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 62 sqlite3_column_b
10a0: 79 74 65 73 31 36 2c 0a 20 20 73 71 6c 69 74 65 ytes16,. sqlite
10b0: 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 2c 0a 3_column_count,.
10c0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e sqlite3_column
10d0: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 2c 0a _database_name,.
10e0: 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e sqlite3_column
10f0: 5f 64 61 74 61 62 61 73 65 5f 6e 61 6d 65 31 36 _database_name16
1100: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 ,. sqlite3_colu
1110: 6d 6e 5f 64 65 63 6c 74 79 70 65 2c 0a 20 20 73 mn_decltype,. s
1120: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 65 qlite3_column_de
1130: 63 6c 74 79 70 65 31 36 2c 0a 20 20 73 71 6c 69 cltype16,. sqli
1140: 74 65 33 5f 63 6f 6c 75 6d 6e 5f 64 6f 75 62 6c te3_column_doubl
1150: 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c e,. sqlite3_col
1160: 75 6d 6e 5f 69 6e 74 2c 0a 20 20 73 71 6c 69 74 umn_int,. sqlit
1170: 65 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 2c e3_column_int64,
1180: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d . sqlite3_colum
1190: 6e 5f 6e 61 6d 65 2c 0a 20 20 73 71 6c 69 74 65 n_name,. sqlite
11a0: 33 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 31 36 2c 3_column_name16,
11b0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d . sqlite3_colum
11c0: 6e 5f 6f 72 69 67 69 6e 5f 6e 61 6d 65 2c 0a 20 n_origin_name,.
11d0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
11e0: 6f 72 69 67 69 6e 5f 6e 61 6d 65 31 36 2c 0a 20 origin_name16,.
11f0: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f sqlite3_column_
1200: 74 61 62 6c 65 5f 6e 61 6d 65 2c 0a 20 20 73 71 table_name,. sq
1210: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 61 62 lite3_column_tab
1220: 6c 65 5f 6e 61 6d 65 31 36 2c 0a 20 20 73 71 6c le_name16,. sql
1230: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 ite3_column_text
1240: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 ,. sqlite3_colu
1250: 6d 6e 5f 74 65 78 74 31 36 2c 0a 20 20 73 71 6c mn_text16,. sql
1260: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 79 70 65 ite3_column_type
1270: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 ,. sqlite3_colu
1280: 6d 6e 5f 76 61 6c 75 65 2c 0a 20 20 73 71 6c 69 mn_value,. sqli
1290: 74 65 33 5f 63 6f 6d 6d 69 74 5f 68 6f 6f 6b 2c te3_commit_hook,
12a0: 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70 6c . sqlite3_compl
12b0: 65 74 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 ete,. sqlite3_c
12c0: 6f 6d 70 6c 65 74 65 31 36 2c 0a 20 20 73 71 6c omplete16,. sql
12d0: 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f 6c 6c ite3_create_coll
12e0: 61 74 69 6f 6e 2c 0a 20 20 73 71 6c 69 74 65 33 ation,. sqlite3
12f0: 5f 63 72 65 61 74 65 5f 63 6f 6c 6c 61 74 69 6f _create_collatio
1300: 6e 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 n16,. sqlite3_c
1310: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 2c 0a reate_function,.
1320: 20 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 sqlite3_create
1330: 5f 66 75 6e 63 74 69 6f 6e 31 36 2c 0a 20 20 73 _function16,. s
1340: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f qlite3_create_mo
1350: 64 75 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f dule,. sqlite3_
1360: 64 61 74 61 5f 63 6f 75 6e 74 2c 0a 20 20 73 71 data_count,. sq
1370: 6c 69 74 65 33 5f 64 62 5f 68 61 6e 64 6c 65 2c lite3_db_handle,
1380: 0a 20 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 . sqlite3_decla
1390: 72 65 5f 76 74 61 62 2c 0a 20 20 73 71 6c 69 74 re_vtab,. sqlit
13a0: 65 33 5f 65 6e 61 62 6c 65 5f 73 68 61 72 65 64 e3_enable_shared
13b0: 5f 63 61 63 68 65 2c 0a 20 20 73 71 6c 69 74 65 _cache,. sqlite
13c0: 33 5f 65 72 72 63 6f 64 65 2c 0a 20 20 73 71 6c 3_errcode,. sql
13d0: 69 74 65 33 5f 65 72 72 6d 73 67 2c 0a 20 20 73 ite3_errmsg,. s
13e0: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 31 36 2c qlite3_errmsg16,
13f0: 0a 20 20 73 71 6c 69 74 65 33 5f 65 78 65 63 2c . sqlite3_exec,
1400: 0a 20 20 73 71 6c 69 74 65 33 5f 65 78 70 69 72 . sqlite3_expir
1410: 65 64 2c 0a 20 20 73 71 6c 69 74 65 33 5f 66 69 ed,. sqlite3_fi
1420: 6e 61 6c 69 7a 65 2c 0a 20 20 73 71 6c 69 74 65 nalize,. sqlite
1430: 33 5f 66 72 65 65 2c 0a 20 20 73 71 6c 69 74 65 3_free,. sqlite
1440: 33 5f 66 72 65 65 5f 74 61 62 6c 65 2c 0a 20 20 3_free_table,.
1450: 73 71 6c 69 74 65 33 5f 67 65 74 5f 61 75 74 6f sqlite3_get_auto
1460: 63 6f 6d 6d 69 74 2c 0a 20 20 73 71 6c 69 74 65 commit,. sqlite
1470: 33 5f 67 65 74 5f 61 75 78 64 61 74 61 2c 0a 20 3_get_auxdata,.
1480: 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 74 61 62 sqlite3_get_tab
1490: 6c 65 2c 0a 20 20 30 2c 20 20 20 20 20 2f 2a 20 le,. 0, /*
14a0: 57 61 73 20 73 71 6c 69 74 65 33 5f 67 6c 6f 62 Was sqlite3_glob
14b0: 61 6c 5f 72 65 63 6f 76 65 72 28 29 2c 20 62 75 al_recover(), bu
14c0: 74 20 74 68 61 74 20 66 75 6e 63 74 69 6f 6e 20 t that function
14d0: 69 73 20 64 65 70 72 65 63 61 74 65 64 20 2a 2f is deprecated */
14e0: 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 65 72 . sqlite3_inter
14f0: 72 75 70 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f rupt,. sqlite3_
1500: 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77 69 last_insert_rowi
1510: 64 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6c 69 62 d,. sqlite3_lib
1520: 76 65 72 73 69 6f 6e 2c 0a 20 20 73 71 6c 69 74 version,. sqlit
1530: 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f 6e 75 e3_libversion_nu
1540: 6d 62 65 72 2c 0a 20 20 73 71 6c 69 74 65 33 5f mber,. sqlite3_
1550: 6d 61 6c 6c 6f 63 2c 0a 20 20 73 71 6c 69 74 65 malloc,. sqlite
1560: 33 5f 6d 70 72 69 6e 74 66 2c 0a 20 20 73 71 6c 3_mprintf,. sql
1570: 69 74 65 33 5f 6f 70 65 6e 2c 0a 20 20 73 71 6c ite3_open,. sql
1580: 69 74 65 33 5f 6f 70 65 6e 31 36 2c 0a 20 20 73 ite3_open16,. s
1590: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 2c 0a qlite3_prepare,.
15a0: 20 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 sqlite3_prepar
15b0: 65 31 36 2c 0a 20 20 73 71 6c 69 74 65 33 5f 70 e16,. sqlite3_p
15c0: 72 6f 66 69 6c 65 2c 0a 20 20 73 71 6c 69 74 65 rofile,. sqlite
15d0: 33 5f 70 72 6f 67 72 65 73 73 5f 68 61 6e 64 6c 3_progress_handl
15e0: 65 72 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 er,. sqlite3_re
15f0: 61 6c 6c 6f 63 2c 0a 20 20 73 71 6c 69 74 65 33 alloc,. sqlite3
1600: 5f 72 65 73 65 74 2c 0a 20 20 73 71 6c 69 74 65 _reset,. sqlite
1610: 33 5f 72 65 73 75 6c 74 5f 62 6c 6f 62 2c 0a 20 3_result_blob,.
1620: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
1630: 64 6f 75 62 6c 65 2c 0a 20 20 73 71 6c 69 74 65 double,. sqlite
1640: 33 5f 72 65 73 75 6c 74 5f 65 72 72 6f 72 2c 0a 3_result_error,.
1650: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 sqlite3_result
1660: 5f 65 72 72 6f 72 31 36 2c 0a 20 20 73 71 6c 69 _error16,. sqli
1670: 74 65 33 5f 72 65 73 75 6c 74 5f 69 6e 74 2c 0a te3_result_int,.
1680: 20 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 sqlite3_result
1690: 5f 69 6e 74 36 34 2c 0a 20 20 73 71 6c 69 74 65 _int64,. sqlite
16a0: 33 5f 72 65 73 75 6c 74 5f 6e 75 6c 6c 2c 0a 20 3_result_null,.
16b0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
16c0: 74 65 78 74 2c 0a 20 20 73 71 6c 69 74 65 33 5f text,. sqlite3_
16d0: 72 65 73 75 6c 74 5f 74 65 78 74 31 36 2c 0a 20 result_text16,.
16e0: 20 73 71 6c 69 74 65 33 5f 72 65 73 75 6c 74 5f sqlite3_result_
16f0: 74 65 78 74 31 36 62 65 2c 0a 20 20 73 71 6c 69 text16be,. sqli
1700: 74 65 33 5f 72 65 73 75 6c 74 5f 74 65 78 74 31 te3_result_text1
1710: 36 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 6le,. sqlite3_r
1720: 65 73 75 6c 74 5f 76 61 6c 75 65 2c 0a 20 20 73 esult_value,. s
1730: 71 6c 69 74 65 33 5f 72 6f 6c 6c 62 61 63 6b 5f qlite3_rollback_
1740: 68 6f 6f 6b 2c 0a 20 20 73 71 6c 69 74 65 33 5f hook,. sqlite3_
1750: 73 65 74 5f 61 75 74 68 6f 72 69 7a 65 72 2c 0a set_authorizer,.
1760: 20 20 73 71 6c 69 74 65 33 5f 73 65 74 5f 61 75 sqlite3_set_au
1770: 78 64 61 74 61 2c 0a 20 20 73 71 6c 69 74 65 33 xdata,. sqlite3
1780: 5f 73 6e 70 72 69 6e 74 66 2c 0a 20 20 73 71 6c _snprintf,. sql
1790: 69 74 65 33 5f 73 74 65 70 2c 0a 20 20 73 71 6c ite3_step,. sql
17a0: 69 74 65 33 5f 74 61 62 6c 65 5f 63 6f 6c 75 6d ite3_table_colum
17b0: 6e 5f 6d 65 74 61 64 61 74 61 2c 0a 20 20 73 71 n_metadata,. sq
17c0: 6c 69 74 65 33 5f 74 68 72 65 61 64 5f 63 6c 65 lite3_thread_cle
17d0: 61 6e 75 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f anup,. sqlite3_
17e0: 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 2c 0a 20 total_changes,.
17f0: 20 73 71 6c 69 74 65 33 5f 74 72 61 63 65 2c 0a sqlite3_trace,.
1800: 20 20 73 71 6c 69 74 65 33 5f 74 72 61 6e 73 66 sqlite3_transf
1810: 65 72 5f 62 69 6e 64 69 6e 67 73 2c 0a 20 20 73 er_bindings,. s
1820: 71 6c 69 74 65 33 5f 75 70 64 61 74 65 5f 68 6f qlite3_update_ho
1830: 6f 6b 2c 0a 20 20 73 71 6c 69 74 65 33 5f 75 73 ok,. sqlite3_us
1840: 65 72 5f 64 61 74 61 2c 0a 20 20 73 71 6c 69 74 er_data,. sqlit
1850: 65 33 5f 76 61 6c 75 65 5f 62 6c 6f 62 2c 0a 20 e3_value_blob,.
1860: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 62 sqlite3_value_b
1870: 79 74 65 73 2c 0a 20 20 73 71 6c 69 74 65 33 5f ytes,. sqlite3_
1880: 76 61 6c 75 65 5f 62 79 74 65 73 31 36 2c 0a 20 value_bytes16,.
1890: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 64 sqlite3_value_d
18a0: 6f 75 62 6c 65 2c 0a 20 20 73 71 6c 69 74 65 33 ouble,. sqlite3
18b0: 5f 76 61 6c 75 65 5f 69 6e 74 2c 0a 20 20 73 71 _value_int,. sq
18c0: 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e 74 36 lite3_value_int6
18d0: 34 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 4,. sqlite3_val
18e0: 75 65 5f 6e 75 6d 65 72 69 63 5f 74 79 70 65 2c ue_numeric_type,
18f0: 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 . sqlite3_value
1900: 5f 74 65 78 74 2c 0a 20 20 73 71 6c 69 74 65 33 _text,. sqlite3
1910: 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 2c 0a 20 _value_text16,.
1920: 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 74 sqlite3_value_t
1930: 65 78 74 31 36 62 65 2c 0a 20 20 73 71 6c 69 74 ext16be,. sqlit
1940: 65 33 5f 76 61 6c 75 65 5f 74 65 78 74 31 36 6c e3_value_text16l
1950: 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c e,. sqlite3_val
1960: 75 65 5f 74 79 70 65 2c 0a 20 20 73 71 6c 69 74 ue_type,. sqlit
1970: 65 33 5f 76 6d 70 72 69 6e 74 66 2c 0a 20 20 2f e3_vmprintf,. /
1980: 2a 0a 20 20 2a 2a 20 54 68 65 20 6f 72 69 67 69 *. ** The origi
1990: 6e 61 6c 20 41 50 49 20 73 65 74 20 65 6e 64 73 nal API set ends
19a0: 20 68 65 72 65 2e 20 20 41 6c 6c 20 65 78 74 65 here. All exte
19b0: 6e 73 69 6f 6e 73 20 63 61 6e 20 63 61 6c 6c 20 nsions can call
19c0: 61 6e 79 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 any. ** of the
19d0: 41 50 49 73 20 61 62 6f 76 65 20 70 72 6f 76 69 APIs above provi
19e0: 64 65 64 20 74 68 61 74 20 74 68 65 20 70 6f 69 ded that the poi
19f0: 6e 74 65 72 20 69 73 20 6e 6f 74 20 4e 55 4c 4c nter is not NULL
1a00: 2e 20 20 42 75 74 0a 20 20 2a 2a 20 62 65 66 6f . But. ** befo
1a10: 72 65 20 63 61 6c 6c 69 6e 67 20 41 50 49 73 20 re calling APIs
1a20: 74 68 61 74 20 66 6f 6c 6c 6f 77 2c 20 65 78 74 that follow, ext
1a30: 65 6e 73 69 6f 6e 20 73 68 6f 75 6c 64 20 63 68 ension should ch
1a40: 65 63 6b 20 74 68 65 0a 20 20 2a 2a 20 73 71 6c eck the. ** sql
1a50: 69 74 65 33 5f 6c 69 62 76 65 72 73 69 6f 6e 5f ite3_libversion_
1a60: 6e 75 6d 62 65 72 28 29 20 74 6f 20 6d 61 6b 65 number() to make
1a70: 20 73 75 72 65 20 74 68 65 79 20 61 72 65 20 64 sure they are d
1a80: 65 61 6c 69 6e 67 20 77 69 74 68 0a 20 20 2a 2a ealing with. **
1a90: 20 61 20 6c 69 62 72 61 72 79 20 74 68 61 74 20 a library that
1aa0: 69 73 20 6e 65 77 20 65 6e 6f 75 67 68 20 74 6f is new enough to
1ab0: 20 73 75 70 70 6f 72 74 20 74 68 61 74 20 41 50 support that AP
1ac0: 49 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a I.. ***********
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 0a 20 **************.
1b10: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6f 76 */. sqlite3_ov
1b20: 65 72 6c 6f 61 64 5f 66 75 6e 63 74 69 6f 6e 2c erload_function,
1b30: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 41 64 64 65 .. /*. ** Adde
1b40: 64 20 61 66 74 65 72 20 33 2e 33 2e 31 33 0a 20 d after 3.3.13.
1b50: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 70 72 */. sqlite3_pr
1b60: 65 70 61 72 65 5f 76 32 2c 0a 20 20 73 71 6c 69 epare_v2,. sqli
1b70: 74 65 33 5f 70 72 65 70 61 72 65 31 36 5f 76 32 te3_prepare16_v2
1b80: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6c 65 61 ,. sqlite3_clea
1b90: 72 5f 62 69 6e 64 69 6e 67 73 2c 0a 0a 20 20 2f r_bindings,.. /
1ba0: 2a 0a 20 20 2a 2a 20 41 64 64 65 64 20 66 6f 72 *. ** Added for
1bb0: 20 33 2e 34 2e 31 0a 20 20 2a 2f 0a 20 20 73 71 3.4.1. */. sq
1bc0: 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f 64 lite3_create_mod
1bd0: 75 6c 65 5f 76 32 2c 0a 0a 20 20 2f 2a 0a 20 20 ule_v2,.. /*.
1be0: 2a 2a 20 41 64 64 65 64 20 66 6f 72 20 33 2e 35 ** Added for 3.5
1bf0: 2e 30 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 .0. */. sqlite
1c00: 33 5f 62 69 6e 64 5f 7a 65 72 6f 62 6c 6f 62 2c 3_bind_zeroblob,
1c10: 0a 20 20 73 71 6c 69 74 65 33 5f 62 6c 6f 62 5f . sqlite3_blob_
1c20: 62 79 74 65 73 2c 0a 20 20 73 71 6c 69 74 65 33 bytes,. sqlite3
1c30: 5f 62 6c 6f 62 5f 63 6c 6f 73 65 2c 0a 20 20 73 _blob_close,. s
1c40: 71 6c 69 74 65 33 5f 62 6c 6f 62 5f 6f 70 65 6e qlite3_blob_open
1c50: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 62 6c 6f 62 ,. sqlite3_blob
1c60: 5f 72 65 61 64 2c 0a 20 20 73 71 6c 69 74 65 33 _read,. sqlite3
1c70: 5f 62 6c 6f 62 5f 77 72 69 74 65 2c 0a 20 20 73 _blob_write,. s
1c80: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 63 6f qlite3_create_co
1c90: 6c 6c 61 74 69 6f 6e 5f 76 32 2c 0a 20 20 73 71 llation_v2,. sq
1ca0: 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 lite3_file_contr
1cb0: 6f 6c 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6d 65 ol,. sqlite3_me
1cc0: 6d 6f 72 79 5f 68 69 67 68 77 61 74 65 72 2c 0a mory_highwater,.
1cd0: 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d 6f 72 79 sqlite3_memory
1ce0: 5f 75 73 65 64 2c 0a 23 69 66 64 65 66 20 53 51 _used,.#ifdef SQ
1cf0: 4c 49 54 45 5f 4d 55 54 45 58 5f 4e 4f 4f 50 0a LITE_MUTEX_NOOP.
1d00: 20 20 30 2c 20 0a 20 20 30 2c 20 0a 20 20 30 2c 0, . 0, . 0,
1d10: 0a 20 20 30 2c 0a 20 20 30 2c 0a 23 65 6c 73 65 . 0,. 0,.#else
1d20: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
1d30: 5f 61 6c 6c 6f 63 2c 0a 20 20 73 71 6c 69 74 65 _alloc,. sqlite
1d40: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 2c 0a 20 3_mutex_enter,.
1d50: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 66 sqlite3_mutex_f
1d60: 72 65 65 2c 0a 20 20 73 71 6c 69 74 65 33 5f 6d ree,. sqlite3_m
1d70: 75 74 65 78 5f 6c 65 61 76 65 2c 0a 20 20 73 71 utex_leave,. sq
1d80: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 74 72 79 2c lite3_mutex_try,
1d90: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65 .#endif. sqlite
1da0: 33 5f 6f 70 65 6e 5f 76 32 2c 0a 20 20 73 71 6c 3_open_v2,. sql
1db0: 69 74 65 33 5f 72 65 6c 65 61 73 65 5f 6d 65 6d ite3_release_mem
1dc0: 6f 72 79 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 ory,. sqlite3_r
1dd0: 65 73 75 6c 74 5f 65 72 72 6f 72 5f 6e 6f 6d 65 esult_error_nome
1de0: 6d 2c 0a 20 20 73 71 6c 69 74 65 33 5f 72 65 73 m,. sqlite3_res
1df0: 75 6c 74 5f 65 72 72 6f 72 5f 74 6f 6f 62 69 67 ult_error_toobig
1e00: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 73 6c 65 65 ,. sqlite3_slee
1e10: 70 2c 0a 20 20 73 71 6c 69 74 65 33 5f 73 6f 66 p,. sqlite3_sof
1e20: 74 5f 68 65 61 70 5f 6c 69 6d 69 74 2c 0a 20 20 t_heap_limit,.
1e30: 73 71 6c 69 74 65 33 5f 76 66 73 5f 66 69 6e 64 sqlite3_vfs_find
1e40: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 5f ,. sqlite3_vfs_
1e50: 72 65 67 69 73 74 65 72 2c 0a 20 20 73 71 6c 69 register,. sqli
1e60: 74 65 33 5f 76 66 73 5f 75 6e 72 65 67 69 73 74 te3_vfs_unregist
1e70: 65 72 2c 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 74 er,.};../*.** At
1e80: 74 65 6d 70 74 20 74 6f 20 6c 6f 61 64 20 61 6e tempt to load an
1e90: 20 53 51 4c 69 74 65 20 65 78 74 65 6e 73 69 6f SQLite extensio
1ea0: 6e 20 6c 69 62 72 61 72 79 20 63 6f 6e 74 61 69 n library contai
1eb0: 6e 65 64 20 69 6e 20 74 68 65 20 66 69 6c 65 0a ned in the file.
1ec0: 2a 2a 20 7a 46 69 6c 65 2e 20 20 54 68 65 20 65 ** zFile. The e
1ed0: 6e 74 72 79 20 70 6f 69 6e 74 20 69 73 20 7a 50 ntry point is zP
1ee0: 72 6f 63 2e 20 20 7a 50 72 6f 63 20 6d 61 79 20 roc. zProc may
1ef0: 62 65 20 30 20 69 6e 20 77 68 69 63 68 20 63 61 be 0 in which ca
1f00: 73 65 20 61 0a 2a 2a 20 64 65 66 61 75 6c 74 20 se a.** default
1f10: 65 6e 74 72 79 20 70 6f 69 6e 74 20 6e 61 6d 65 entry point name
1f20: 20 28 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 73 (sqlite3_extens
1f30: 69 6f 6e 5f 69 6e 69 74 29 20 69 73 20 75 73 65 ion_init) is use
1f40: 64 2e 20 20 55 73 65 0a 2a 2a 20 6f 66 20 74 68 d. Use.** of th
1f50: 65 20 64 65 66 61 75 6c 74 20 6e 61 6d 65 20 69 e default name i
1f60: 73 20 72 65 63 6f 6d 6d 65 6e 64 65 64 2e 0a 2a s recommended..*
1f70: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 *.** Return SQLI
1f80: 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73 TE_OK on success
1f90: 20 61 6e 64 20 53 51 4c 49 54 45 5f 45 52 52 4f and SQLITE_ERRO
1fa0: 52 20 69 66 20 73 6f 6d 65 74 68 69 6e 67 20 67 R if something g
1fb0: 6f 65 73 20 77 72 6f 6e 67 2e 0a 2a 2a 0a 2a 2a oes wrong..**.**
1fc0: 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 If an error occ
1fd0: 75 72 73 20 61 6e 64 20 70 7a 45 72 72 4d 73 67 urs and pzErrMsg
1fe0: 20 69 73 20 6e 6f 74 20 30 2c 20 74 68 65 6e 20 is not 0, then
1ff0: 66 69 6c 6c 20 2a 70 7a 45 72 72 4d 73 67 20 77 fill *pzErrMsg w
2000: 69 74 68 20 0a 2a 2a 20 65 72 72 6f 72 20 6d 65 ith .** error me
2010: 73 73 61 67 65 20 74 65 78 74 2e 20 20 54 68 65 ssage text. The
2020: 20 63 61 6c 6c 69 6e 67 20 66 75 6e 63 74 69 6f calling functio
2030: 6e 20 73 68 6f 75 6c 64 20 66 72 65 65 20 74 68 n should free th
2040: 69 73 20 6d 65 6d 6f 72 79 0a 2a 2a 20 62 79 20 is memory.** by
2050: 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33 5f calling sqlite3_
2060: 66 72 65 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 free()..*/.stati
2070: 63 20 69 6e 74 20 73 71 6c 69 74 65 33 4c 6f 61 c int sqlite3Loa
2080: 64 45 78 74 65 6e 73 69 6f 6e 28 0a 20 20 73 71 dExtension(. sq
2090: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
20a0: 20 20 20 20 2f 2a 20 4c 6f 61 64 20 74 68 65 20 /* Load the
20b0: 65 78 74 65 6e 73 69 6f 6e 20 69 6e 74 6f 20 74 extension into t
20c0: 68 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e his database con
20d0: 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e nection */. con
20e0: 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 2c 20 st char *zFile,
20f0: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
2100: 65 20 73 68 61 72 65 64 20 6c 69 62 72 61 72 79 e shared library
2110: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 78 74 65 containing exte
2120: 6e 73 69 6f 6e 20 2a 2f 0a 20 20 63 6f 6e 73 74 nsion */. const
2130: 20 63 68 61 72 20 2a 7a 50 72 6f 63 2c 20 20 20 char *zProc,
2140: 20 2f 2a 20 45 6e 74 72 79 20 70 6f 69 6e 74 2e /* Entry point.
2150: 20 20 55 73 65 20 22 73 71 6c 69 74 65 33 5f 65 Use "sqlite3_e
2160: 78 74 65 6e 73 69 6f 6e 5f 69 6e 69 74 22 20 69 xtension_init" i
2170: 66 20 30 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a f 0 */. char **
2180: 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 2f pzErrMsg /
2190: 2a 20 50 75 74 20 65 72 72 6f 72 20 6d 65 73 73 * Put error mess
21a0: 61 67 65 20 68 65 72 65 20 69 66 20 6e 6f 74 20 age here if not
21b0: 30 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 0 */.){. sqlite
21c0: 33 5f 76 66 73 20 2a 70 56 66 73 20 3d 20 64 62 3_vfs *pVfs = db
21d0: 2d 3e 70 56 66 73 3b 0a 20 20 76 6f 69 64 20 2a ->pVfs;. void *
21e0: 68 61 6e 64 6c 65 3b 0a 20 20 69 6e 74 20 28 2a handle;. int (*
21f0: 78 49 6e 69 74 29 28 73 71 6c 69 74 65 33 2a 2c xInit)(sqlite3*,
2200: 63 68 61 72 2a 2a 2c 63 6f 6e 73 74 20 73 71 6c char**,const sql
2210: 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65 ite3_api_routine
2220: 73 2a 29 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 s*);. char *zEr
2230: 72 6d 73 67 20 3d 20 30 3b 0a 20 20 76 6f 69 64 rmsg = 0;. void
2240: 20 2a 2a 61 48 61 6e 64 6c 65 3b 0a 0a 20 20 2f **aHandle;.. /
2250: 2a 20 54 69 63 6b 65 74 20 23 31 38 36 33 2e 20 * Ticket #1863.
2260: 20 54 6f 20 61 76 6f 69 64 20 61 20 63 72 65 61 To avoid a crea
2270: 74 69 6e 67 20 73 65 63 75 72 69 74 79 20 70 72 ting security pr
2280: 6f 62 6c 65 6d 73 20 66 6f 72 20 6f 6c 64 65 72 oblems for older
2290: 0a 20 20 2a 2a 20 61 70 70 6c 69 63 61 74 69 6f . ** applicatio
22a0: 6e 73 20 74 68 61 74 20 72 65 6c 69 6e 6b 20 61 ns that relink a
22b0: 67 61 69 6e 73 74 20 6e 65 77 65 72 20 76 65 72 gainst newer ver
22c0: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 2c sions of SQLite,
22d0: 20 74 68 65 0a 20 20 2a 2a 20 61 62 69 6c 69 74 the. ** abilit
22e0: 79 20 74 6f 20 72 75 6e 20 6c 6f 61 64 5f 65 78 y to run load_ex
22f0: 74 65 6e 73 69 6f 6e 20 69 73 20 74 75 72 6e 65 tension is turne
2300: 64 20 6f 66 66 20 62 79 20 64 65 66 61 75 6c 74 d off by default
2310: 2e 20 20 4f 6e 65 0a 20 20 2a 2a 20 6d 75 73 74 . One. ** must
2320: 20 63 61 6c 6c 20 73 71 6c 69 74 65 33 5f 65 6e call sqlite3_en
2330: 61 62 6c 65 5f 6c 6f 61 64 5f 65 78 74 65 6e 73 able_load_extens
2340: 69 6f 6e 28 29 20 74 6f 20 74 75 72 6e 20 6f 6e ion() to turn on
2350: 20 65 78 74 65 6e 73 69 6f 6e 0a 20 20 2a 2a 20 extension. **
2360: 6c 6f 61 64 69 6e 67 2e 20 20 4f 74 68 65 72 77 loading. Otherw
2370: 69 73 65 20 79 6f 75 20 67 65 74 20 74 68 65 20 ise you get the
2380: 66 6f 6c 6c 6f 77 69 6e 67 20 65 72 72 6f 72 2e following error.
2390: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 28 64 62 2d . */. if( (db-
23a0: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f >flags & SQLITE_
23b0: 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 29 3d 3d LoadExtension)==
23c0: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 7a 45 0 ){. if( pzE
23d0: 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 2a rrMsg ){. *
23e0: 70 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 pzErrMsg = sqlit
23f0: 65 33 5f 6d 70 72 69 6e 74 66 28 22 6e 6f 74 20 e3_mprintf("not
2400: 61 75 74 68 6f 72 69 7a 65 64 22 29 3b 0a 20 20 authorized");.
2410: 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 53 }. return S
2420: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d QLITE_ERROR;. }
2430: 0a 0a 20 20 69 66 28 20 7a 50 72 6f 63 3d 3d 30 .. if( zProc==0
2440: 20 29 7b 0a 20 20 20 20 7a 50 72 6f 63 20 3d 20 ){. zProc =
2450: 22 73 71 6c 69 74 65 33 5f 65 78 74 65 6e 73 69 "sqlite3_extensi
2460: 6f 6e 5f 69 6e 69 74 22 3b 0a 20 20 7d 0a 0a 20 on_init";. }..
2470: 20 68 61 6e 64 6c 65 20 3d 20 73 71 6c 69 74 65 handle = sqlite
2480: 33 4f 73 44 6c 4f 70 65 6e 28 70 56 66 73 2c 20 3OsDlOpen(pVfs,
2490: 7a 46 69 6c 65 29 3b 0a 20 20 69 66 28 20 68 61 zFile);. if( ha
24a0: 6e 64 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20 69 ndle==0 ){. i
24b0: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a 20 f( pzErrMsg ){.
24c0: 20 20 20 20 20 63 68 61 72 20 7a 45 72 72 5b 32 char zErr[2
24d0: 35 36 5d 3b 0a 20 20 20 20 20 20 7a 45 72 72 5b 56];. zErr[
24e0: 73 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 5d 20 sizeof(zErr)-1]
24f0: 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 73 71 = '\0';. sq
2500: 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 73 lite3_snprintf(s
2510: 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 2c 20 7a izeof(zErr)-1, z
2520: 45 72 72 2c 20 0a 20 20 20 20 20 20 20 20 20 20 Err, .
2530: 22 75 6e 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 "unable to open
2540: 73 68 61 72 65 64 20 6c 69 62 72 61 72 79 20 5b shared library [
2550: 25 73 5d 22 2c 20 7a 46 69 6c 65 29 3b 0a 20 20 %s]", zFile);.
2560: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 45 sqlite3OsDlE
2570: 72 72 6f 72 28 70 56 66 73 2c 20 73 69 7a 65 6f rror(pVfs, sizeo
2580: 66 28 7a 45 72 72 29 2d 31 2c 20 7a 45 72 72 29 f(zErr)-1, zErr)
2590: 3b 0a 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 ;. *pzErrMs
25a0: 67 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72 g = sqlite3DbStr
25b0: 44 75 70 28 64 62 2c 20 7a 45 72 72 29 3b 0a 20 Dup(db, zErr);.
25c0: 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 }. return
25d0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 SQLITE_ERROR;.
25e0: 7d 0a 20 20 78 49 6e 69 74 20 3d 20 28 69 6e 74 }. xInit = (int
25f0: 28 2a 29 28 73 71 6c 69 74 65 33 2a 2c 63 68 61 (*)(sqlite3*,cha
2600: 72 2a 2a 2c 63 6f 6e 73 74 20 73 71 6c 69 74 65 r**,const sqlite
2610: 33 5f 61 70 69 5f 72 6f 75 74 69 6e 65 73 2a 29 3_api_routines*)
2620: 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ).
2630: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c sqlite3OsDl
2640: 53 79 6d 28 70 56 66 73 2c 20 68 61 6e 64 6c 65 Sym(pVfs, handle
2650: 2c 20 7a 50 72 6f 63 29 3b 0a 20 20 69 66 28 20 , zProc);. if(
2660: 78 49 6e 69 74 3d 3d 30 20 29 7b 0a 20 20 20 20 xInit==0 ){.
2670: 69 66 28 20 70 7a 45 72 72 4d 73 67 20 29 7b 0a if( pzErrMsg ){.
2680: 20 20 20 20 20 20 63 68 61 72 20 7a 45 72 72 5b char zErr[
2690: 32 35 36 5d 3b 0a 20 20 20 20 20 20 7a 45 72 72 256];. zErr
26a0: 5b 73 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 5d [sizeof(zErr)-1]
26b0: 20 3d 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 73 = '\0';. s
26c0: 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 qlite3_snprintf(
26d0: 73 69 7a 65 6f 66 28 7a 45 72 72 29 2d 31 2c 20 sizeof(zErr)-1,
26e0: 7a 45 72 72 2c 0a 20 20 20 20 20 20 20 20 20 20 zErr,.
26f0: 22 6e 6f 20 65 6e 74 72 79 20 70 6f 69 6e 74 20 "no entry point
2700: 5b 25 73 5d 20 69 6e 20 73 68 61 72 65 64 20 6c [%s] in shared l
2710: 69 62 72 61 72 79 20 5b 25 73 5d 22 2c 20 7a 50 ibrary [%s]", zP
2720: 72 6f 63 2c 7a 46 69 6c 65 29 3b 0a 20 20 20 20 roc,zFile);.
2730: 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 45 72 72 sqlite3OsDlErr
2740: 6f 72 28 70 56 66 73 2c 20 73 69 7a 65 6f 66 28 or(pVfs, sizeof(
2750: 7a 45 72 72 29 2d 31 2c 20 7a 45 72 72 29 3b 0a zErr)-1, zErr);.
2760: 20 20 20 20 20 20 2a 70 7a 45 72 72 4d 73 67 20 *pzErrMsg
2770: 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72 44 75 = sqlite3DbStrDu
2780: 70 28 64 62 2c 20 7a 45 72 72 29 3b 0a 20 20 20 p(db, zErr);.
2790: 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 43 6c sqlite3OsDlCl
27a0: 6f 73 65 28 70 56 66 73 2c 20 68 61 6e 64 6c 65 ose(pVfs, handle
27b0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 );. }. ret
27c0: 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 urn SQLITE_ERROR
27d0: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 78 49 ;. }else if( xI
27e0: 6e 69 74 28 64 62 2c 20 26 7a 45 72 72 6d 73 67 nit(db, &zErrmsg
27f0: 2c 20 26 73 71 6c 69 74 65 33 5f 61 70 69 73 29 , &sqlite3_apis)
2800: 20 29 7b 0a 20 20 20 20 69 66 28 20 70 7a 45 72 ){. if( pzEr
2810: 72 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 2a 70 rMsg ){. *p
2820: 7a 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 zErrMsg = sqlite
2830: 33 5f 6d 70 72 69 6e 74 66 28 22 65 72 72 6f 72 3_mprintf("error
2840: 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 during initiali
2850: 7a 61 74 69 6f 6e 3a 20 25 73 22 2c 20 7a 45 72 zation: %s", zEr
2860: 72 6d 73 67 29 3b 0a 20 20 20 20 7d 0a 20 20 20 rmsg);. }.
2870: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 7a 45 sqlite3_free(zE
2880: 72 72 6d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 rrmsg);. sqli
2890: 74 65 33 4f 73 44 6c 43 6c 6f 73 65 28 70 56 66 te3OsDlClose(pVf
28a0: 73 2c 20 68 61 6e 64 6c 65 29 3b 0a 20 20 20 20 s, handle);.
28b0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 45 52 return SQLITE_ER
28c0: 52 4f 52 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 ROR;. }.. /* A
28d0: 70 70 65 6e 64 20 74 68 65 20 6e 65 77 20 73 68 ppend the new sh
28e0: 61 72 65 64 20 6c 69 62 72 61 72 79 20 68 61 6e ared library han
28f0: 64 6c 65 20 74 6f 20 74 68 65 20 64 62 2d 3e 61 dle to the db->a
2900: 45 78 74 65 6e 73 69 6f 6e 20 61 72 72 61 79 2e Extension array.
2910: 20 2a 2f 0a 20 20 64 62 2d 3e 6e 45 78 74 65 6e */. db->nExten
2920: 73 69 6f 6e 2b 2b 3b 0a 20 20 61 48 61 6e 64 6c sion++;. aHandl
2930: 65 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c e = sqlite3DbMal
2940: 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 73 69 7a 65 locZero(db, size
2950: 6f 66 28 68 61 6e 64 6c 65 29 2a 64 62 2d 3e 6e of(handle)*db->n
2960: 45 78 74 65 6e 73 69 6f 6e 29 3b 0a 20 20 69 66 Extension);. if
2970: 28 20 61 48 61 6e 64 6c 65 3d 3d 30 20 29 7b 0a ( aHandle==0 ){.
2980: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
2990: 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 E_NOMEM;. }. i
29a0: 66 28 20 64 62 2d 3e 6e 45 78 74 65 6e 73 69 6f f( db->nExtensio
29b0: 6e 3e 30 20 29 7b 0a 20 20 20 20 6d 65 6d 63 70 n>0 ){. memcp
29c0: 79 28 61 48 61 6e 64 6c 65 2c 20 64 62 2d 3e 61 y(aHandle, db->a
29d0: 45 78 74 65 6e 73 69 6f 6e 2c 20 73 69 7a 65 6f Extension, sizeo
29e0: 66 28 68 61 6e 64 6c 65 29 2a 28 64 62 2d 3e 6e f(handle)*(db->n
29f0: 45 78 74 65 6e 73 69 6f 6e 2d 31 29 29 3b 0a 20 Extension-1));.
2a00: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65 }. sqlite3_fre
2a10: 65 28 64 62 2d 3e 61 45 78 74 65 6e 73 69 6f 6e e(db->aExtension
2a20: 29 3b 0a 20 20 64 62 2d 3e 61 45 78 74 65 6e 73 );. db->aExtens
2a30: 69 6f 6e 20 3d 20 61 48 61 6e 64 6c 65 3b 0a 0a ion = aHandle;..
2a40: 20 20 64 62 2d 3e 61 45 78 74 65 6e 73 69 6f 6e db->aExtension
2a50: 5b 64 62 2d 3e 6e 45 78 74 65 6e 73 69 6f 6e 2d [db->nExtension-
2a60: 31 5d 20 3d 20 68 61 6e 64 6c 65 3b 0a 20 20 72 1] = handle;. r
2a70: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b eturn SQLITE_OK;
2a80: 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 6c .}.int sqlite3_l
2a90: 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 0a 20 oad_extension(.
2aa0: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 sqlite3 *db,
2ab0: 20 20 20 20 20 20 20 2f 2a 20 4c 6f 61 64 20 74 /* Load t
2ac0: 68 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 6e 74 he extension int
2ad0: 6f 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 o this database
2ae0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 connection */.
2af0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c const char *zFil
2b00: 65 2c 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 e, /* Name of
2b10: 20 74 68 65 20 73 68 61 72 65 64 20 6c 69 62 72 the shared libr
2b20: 61 72 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 ary containing e
2b30: 78 74 65 6e 73 69 6f 6e 20 2a 2f 0a 20 20 63 6f xtension */. co
2b40: 6e 73 74 20 63 68 61 72 20 2a 7a 50 72 6f 63 2c nst char *zProc,
2b50: 20 20 20 20 2f 2a 20 45 6e 74 72 79 20 70 6f 69 /* Entry poi
2b60: 6e 74 2e 20 20 55 73 65 20 22 73 71 6c 69 74 65 nt. Use "sqlite
2b70: 33 5f 65 78 74 65 6e 73 69 6f 6e 5f 69 6e 69 74 3_extension_init
2b80: 22 20 69 66 20 30 20 2a 2f 0a 20 20 63 68 61 72 " if 0 */. char
2b90: 20 2a 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 **pzErrMsg
2ba0: 20 20 2f 2a 20 50 75 74 20 65 72 72 6f 72 20 6d /* Put error m
2bb0: 65 73 73 61 67 65 20 68 65 72 65 20 69 66 20 6e essage here if n
2bc0: 6f 74 20 30 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 ot 0 */.){. int
2bd0: 20 72 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d rc;. sqlite3_m
2be0: 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d utex_enter(db->m
2bf0: 75 74 65 78 29 3b 0a 20 20 72 63 20 3d 20 73 71 utex);. rc = sq
2c00: 6c 69 74 65 33 4c 6f 61 64 45 78 74 65 6e 73 69 lite3LoadExtensi
2c10: 6f 6e 28 64 62 2c 20 7a 46 69 6c 65 2c 20 7a 50 on(db, zFile, zP
2c20: 72 6f 63 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a roc, pzErrMsg);.
2c30: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
2c40: 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 leave(db->mutex)
2c50: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
2c60: 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68 69 ../*.** Call thi
2c70: 73 20 72 6f 75 74 69 6e 65 20 77 68 65 6e 20 74 s routine when t
2c80: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e he database conn
2c90: 65 63 74 69 6f 6e 20 69 73 20 63 6c 6f 73 69 6e ection is closin
2ca0: 67 20 69 6e 20 6f 72 64 65 72 0a 2a 2a 20 74 6f g in order.** to
2cb0: 20 63 6c 65 61 6e 20 75 70 20 6c 6f 61 64 65 64 clean up loaded
2cc0: 20 65 78 74 65 6e 73 69 6f 6e 73 0a 2a 2f 0a 76 extensions.*/.v
2cd0: 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 oid sqlite3Close
2ce0: 45 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 74 Extensions(sqlit
2cf0: 65 33 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 e3 *db){. int i
2d00: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 ;. assert( sqli
2d10: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 te3_mutex_held(d
2d20: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 b->mutex) );. f
2d30: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 45 or(i=0; i<db->nE
2d40: 78 74 65 6e 73 69 6f 6e 3b 20 69 2b 2b 29 7b 0a xtension; i++){.
2d50: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 6c 43 sqlite3OsDlC
2d60: 6c 6f 73 65 28 64 62 2d 3e 70 56 66 73 2c 20 64 lose(db->pVfs, d
2d70: 62 2d 3e 61 45 78 74 65 6e 73 69 6f 6e 5b 69 5d b->aExtension[i]
2d80: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 );. }. sqlite3
2d90: 5f 66 72 65 65 28 64 62 2d 3e 61 45 78 74 65 6e _free(db->aExten
2da0: 73 69 6f 6e 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 sion);.}../*.**
2db0: 45 6e 61 62 6c 65 20 6f 72 20 64 69 73 61 62 6c Enable or disabl
2dc0: 65 20 65 78 74 65 6e 73 69 6f 6e 20 6c 6f 61 64 e extension load
2dd0: 69 6e 67 2e 20 20 45 78 74 65 6e 73 69 6f 6e 20 ing. Extension
2de0: 6c 6f 61 64 69 6e 67 20 69 73 20 64 69 73 61 62 loading is disab
2df0: 6c 65 64 20 62 79 0a 2a 2a 20 64 65 66 61 75 6c led by.** defaul
2e00: 74 20 73 6f 20 61 73 20 6e 6f 74 20 74 6f 20 6f t so as not to o
2e10: 70 65 6e 20 73 65 63 75 72 69 74 79 20 68 6f 6c pen security hol
2e20: 65 73 20 69 6e 20 6f 6c 64 65 72 20 61 70 70 6c es in older appl
2e30: 69 63 61 74 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 ications..*/.int
2e40: 20 73 71 6c 69 74 65 33 5f 65 6e 61 62 6c 65 5f sqlite3_enable_
2e50: 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e 28 73 load_extension(s
2e60: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20 qlite3 *db, int
2e70: 6f 6e 6f 66 66 29 7b 0a 20 20 73 71 6c 69 74 65 onoff){. sqlite
2e80: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 3_mutex_enter(db
2e90: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 69 66 28 20 ->mutex);. if(
2ea0: 6f 6e 6f 66 66 20 29 7b 0a 20 20 20 20 64 62 2d onoff ){. db-
2eb0: 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 >flags |= SQLITE
2ec0: 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 3b 0a _LoadExtension;.
2ed0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 64 62 2d }else{. db-
2ee0: 3e 66 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 >flags &= ~SQLIT
2ef0: 45 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 3b E_LoadExtension;
2f00: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d . }. sqlite3_m
2f10: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d utex_leave(db->m
2f20: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 utex);. return
2f30: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a SQLITE_OK;.}../*
2f40: 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
2f50: 67 20 6f 62 6a 65 63 74 20 68 6f 6c 64 73 20 74 g object holds t
2f60: 68 65 20 6c 69 73 74 20 6f 66 20 61 75 74 6f 6d he list of autom
2f70: 61 74 69 63 61 6c 6c 79 20 6c 6f 61 64 65 64 0a atically loaded.
2f80: 2a 2a 20 65 78 74 65 6e 73 69 6f 6e 73 2e 0a 2a ** extensions..*
2f90: 2a 0a 2a 2a 20 54 68 69 73 20 6c 69 73 74 20 69 *.** This list i
2fa0: 73 20 73 68 61 72 65 64 20 61 63 72 6f 73 73 20 s shared across
2fb0: 74 68 72 65 61 64 73 2e 20 20 54 68 65 20 53 51 threads. The SQ
2fc0: 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 LITE_MUTEX_STATI
2fd0: 43 5f 4d 41 53 54 45 52 0a 2a 2a 20 6d 75 74 65 C_MASTER.** mute
2fe0: 78 20 6d 75 73 74 20 62 65 20 68 65 6c 64 20 77 x must be held w
2ff0: 68 69 6c 65 20 61 63 63 65 73 73 69 6e 67 20 74 hile accessing t
3000: 68 69 73 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 61 his list..*/.sta
3010: 74 69 63 20 73 74 72 75 63 74 20 7b 0a 20 20 69 tic struct {. i
3020: 6e 74 20 6e 45 78 74 3b 20 20 20 20 20 20 20 20 nt nExt;
3030: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 /* Number of ent
3040: 72 69 65 73 20 69 6e 20 61 45 78 74 5b 5d 20 2a ries in aExt[] *
3050: 2f 20 20 20 20 20 20 20 20 20 20 0a 20 20 76 6f / . vo
3060: 69 64 20 2a 2a 61 45 78 74 3b 20 20 20 20 20 2f id **aExt; /
3070: 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 * Pointers to th
3080: 65 20 65 78 74 65 6e 73 69 6f 6e 20 69 6e 69 74 e extension init
3090: 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 7d 20 functions */.}
30a0: 61 75 74 6f 65 78 74 20 3d 20 7b 20 30 2c 20 30 autoext = { 0, 0
30b0: 20 7d 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65 67 69 };.../*.** Regi
30c0: 73 74 65 72 20 61 20 73 74 61 74 69 63 61 6c 6c ster a staticall
30d0: 79 20 6c 69 6e 6b 65 64 20 65 78 74 65 6e 73 69 y linked extensi
30e0: 6f 6e 20 74 68 61 74 20 69 73 20 61 75 74 6f 6d on that is autom
30f0: 61 74 69 63 61 6c 6c 79 0a 2a 2a 20 6c 6f 61 64 atically.** load
3100: 65 64 20 62 79 20 65 76 65 72 79 20 6e 65 77 20 ed by every new
3110: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
3120: 69 6f 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ion..*/.int sqli
3130: 74 65 33 5f 61 75 74 6f 5f 65 78 74 65 6e 73 69 te3_auto_extensi
3140: 6f 6e 28 76 6f 69 64 20 2a 78 49 6e 69 74 29 7b on(void *xInit){
3150: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 . int i;. int
3160: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a rc = SQLITE_OK;.
3170: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 sqlite3_mutex
3180: 2a 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 65 33 *mutex = sqlite3
3190: 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 51 4c _mutex_alloc(SQL
31a0: 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 49 43 ITE_MUTEX_STATIC
31b0: 5f 4d 41 53 54 45 52 29 3b 0a 20 20 73 71 6c 69 _MASTER);. sqli
31c0: 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 te3_mutex_enter(
31d0: 6d 75 74 65 78 29 3b 0a 20 20 66 6f 72 28 69 3d mutex);. for(i=
31e0: 30 3b 20 69 3c 61 75 74 6f 65 78 74 2e 6e 45 78 0; i<autoext.nEx
31f0: 74 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 t; i++){. if(
3200: 20 61 75 74 6f 65 78 74 2e 61 45 78 74 5b 69 5d autoext.aExt[i]
3210: 3d 3d 78 49 6e 69 74 20 29 20 62 72 65 61 6b 3b ==xInit ) break;
3220: 0a 20 20 7d 0a 20 20 69 66 28 20 69 3d 3d 61 75 . }. if( i==au
3230: 74 6f 65 78 74 2e 6e 45 78 74 20 29 7b 0a 20 20 toext.nExt ){.
3240: 20 20 69 6e 74 20 6e 42 79 74 65 20 3d 20 28 61 int nByte = (a
3250: 75 74 6f 65 78 74 2e 6e 45 78 74 2b 31 29 2a 73 utoext.nExt+1)*s
3260: 69 7a 65 6f 66 28 61 75 74 6f 65 78 74 2e 61 45 izeof(autoext.aE
3270: 78 74 5b 30 5d 29 3b 0a 20 20 20 20 76 6f 69 64 xt[0]);. void
3280: 20 2a 2a 61 4e 65 77 3b 0a 20 20 20 20 61 4e 65 **aNew;. aNe
3290: 77 20 3d 20 73 71 6c 69 74 65 33 5f 72 65 61 6c w = sqlite3_real
32a0: 6c 6f 63 28 61 75 74 6f 65 78 74 2e 61 45 78 74 loc(autoext.aExt
32b0: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 69 66 , nByte);. if
32c0: 28 20 61 4e 65 77 3d 3d 30 20 29 7b 0a 20 20 20 ( aNew==0 ){.
32d0: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
32e0: 4f 4d 45 4d 3b 0a 20 20 20 20 7d 65 6c 73 65 7b OMEM;. }else{
32f0: 0a 20 20 20 20 20 20 61 75 74 6f 65 78 74 2e 61 . autoext.a
3300: 45 78 74 20 3d 20 61 4e 65 77 3b 0a 20 20 20 20 Ext = aNew;.
3310: 20 20 61 75 74 6f 65 78 74 2e 61 45 78 74 5b 61 autoext.aExt[a
3320: 75 74 6f 65 78 74 2e 6e 45 78 74 5d 20 3d 20 78 utoext.nExt] = x
3330: 49 6e 69 74 3b 0a 20 20 20 20 20 20 61 75 74 6f Init;. auto
3340: 65 78 74 2e 6e 45 78 74 2b 2b 3b 0a 20 20 20 20 ext.nExt++;.
3350: 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f }. }. sqlite3_
3360: 6d 75 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 mutex_leave(mute
3370: 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 72 x);. assert( (r
3380: 63 26 30 78 66 66 29 3d 3d 72 63 20 29 3b 0a 20 c&0xff)==rc );.
3390: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
33a0: 2a 0a 2a 2a 20 52 65 73 65 74 20 74 68 65 20 61 *.** Reset the a
33b0: 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73 69 utomatic extensi
33c0: 6f 6e 20 6c 6f 61 64 69 6e 67 20 6d 65 63 68 61 on loading mecha
33d0: 6e 69 73 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 nism..*/.void sq
33e0: 6c 69 74 65 33 5f 72 65 73 65 74 5f 61 75 74 6f lite3_reset_auto
33f0: 5f 65 78 74 65 6e 73 69 6f 6e 28 76 6f 69 64 29 _extension(void)
3400: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 {. sqlite3_mute
3410: 78 20 2a 6d 75 74 65 78 20 3d 20 73 71 6c 69 74 x *mutex = sqlit
3420: 65 33 5f 6d 75 74 65 78 5f 61 6c 6c 6f 63 28 53 e3_mutex_alloc(S
3430: 51 4c 49 54 45 5f 4d 55 54 45 58 5f 53 54 41 54 QLITE_MUTEX_STAT
3440: 49 43 5f 4d 41 53 54 45 52 29 3b 0a 20 20 73 71 IC_MASTER);. sq
3450: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
3460: 72 28 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 r(mutex);. sqli
3470: 74 65 33 5f 66 72 65 65 28 61 75 74 6f 65 78 74 te3_free(autoext
3480: 2e 61 45 78 74 29 3b 0a 20 20 61 75 74 6f 65 78 .aExt);. autoex
3490: 74 2e 61 45 78 74 20 3d 20 30 3b 0a 20 20 61 75 t.aExt = 0;. au
34a0: 74 6f 65 78 74 2e 6e 45 78 74 20 3d 20 30 3b 0a toext.nExt = 0;.
34b0: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
34c0: 6c 65 61 76 65 28 6d 75 74 65 78 29 3b 0a 7d 0a leave(mutex);.}.
34d0: 0a 2f 2a 0a 2a 2a 20 4c 6f 61 64 20 61 6c 6c 20 ./*.** Load all
34e0: 61 75 74 6f 6d 61 74 69 63 20 65 78 74 65 6e 73 automatic extens
34f0: 69 6f 6e 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c ions..*/.int sql
3500: 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 ite3AutoLoadExte
3510: 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 20 2a nsions(sqlite3 *
3520: 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 db){. int i;.
3530: 69 6e 74 20 67 6f 20 3d 20 31 3b 0a 20 20 69 6e int go = 1;. in
3540: 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b t rc = SQLITE_OK
3550: 3b 0a 20 20 69 6e 74 20 28 2a 78 49 6e 69 74 29 ;. int (*xInit)
3560: 28 73 71 6c 69 74 65 33 2a 2c 63 68 61 72 2a 2a (sqlite3*,char**
3570: 2c 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 61 ,const sqlite3_a
3580: 70 69 5f 72 6f 75 74 69 6e 65 73 2a 29 3b 0a 0a pi_routines*);..
3590: 20 20 69 66 28 20 61 75 74 6f 65 78 74 2e 6e 45 if( autoext.nE
35a0: 78 74 3d 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 xt==0 ){. /*
35b0: 43 6f 6d 6d 6f 6e 20 63 61 73 65 3a 20 65 61 72 Common case: ear
35c0: 6c 79 20 6f 75 74 20 77 69 74 68 6f 75 74 20 65 ly out without e
35d0: 76 65 72 79 20 68 61 76 69 6e 67 20 74 6f 20 61 very having to a
35e0: 63 71 75 69 72 65 20 61 20 6d 75 74 65 78 20 2a cquire a mutex *
35f0: 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c /. return SQL
3600: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 66 6f ITE_OK;. }. fo
3610: 72 28 69 3d 30 3b 20 67 6f 3b 20 69 2b 2b 29 7b r(i=0; go; i++){
3620: 0a 20 20 20 20 63 68 61 72 20 2a 7a 45 72 72 6d . char *zErrm
3630: 73 67 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69 sg = 0;. sqli
3640: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
3650: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 = sqlite3_mutex
3660: 5f 61 6c 6c 6f 63 28 53 51 4c 49 54 45 5f 4d 55 _alloc(SQLITE_MU
3670: 54 45 58 5f 53 54 41 54 49 43 5f 4d 41 53 54 45 TEX_STATIC_MASTE
3680: 52 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f R);. sqlite3_
3690: 6d 75 74 65 78 5f 65 6e 74 65 72 28 6d 75 74 65 mutex_enter(mute
36a0: 78 29 3b 0a 20 20 20 20 69 66 28 20 69 3e 3d 61 x);. if( i>=a
36b0: 75 74 6f 65 78 74 2e 6e 45 78 74 20 29 7b 0a 20 utoext.nExt ){.
36c0: 20 20 20 20 20 78 49 6e 69 74 20 3d 20 30 3b 0a xInit = 0;.
36d0: 20 20 20 20 20 20 67 6f 20 3d 20 30 3b 0a 20 20 go = 0;.
36e0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 78 }else{. x
36f0: 49 6e 69 74 20 3d 20 28 69 6e 74 28 2a 29 28 73 Init = (int(*)(s
3700: 71 6c 69 74 65 33 2a 2c 63 68 61 72 2a 2a 2c 63 qlite3*,char**,c
3710: 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 61 70 69 onst sqlite3_api
3720: 5f 72 6f 75 74 69 6e 65 73 2a 29 29 0a 20 20 20 _routines*)).
3730: 20 20 20 20 20 20 20 20 20 20 20 61 75 74 6f 65 autoe
3740: 78 74 2e 61 45 78 74 5b 69 5d 3b 0a 20 20 20 20 xt.aExt[i];.
3750: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 6d 75 }. sqlite3_mu
3760: 74 65 78 5f 6c 65 61 76 65 28 6d 75 74 65 78 29 tex_leave(mutex)
3770: 3b 0a 20 20 20 20 69 66 28 20 78 49 6e 69 74 20 ;. if( xInit
3780: 26 26 20 78 49 6e 69 74 28 64 62 2c 20 26 7a 45 && xInit(db, &zE
3790: 72 72 6d 73 67 2c 20 26 73 71 6c 69 74 65 33 5f rrmsg, &sqlite3_
37a0: 61 70 69 73 29 20 29 7b 0a 20 20 20 20 20 20 73 apis) ){. s
37b0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 qlite3Error(db,
37c0: 53 51 4c 49 54 45 5f 45 52 52 4f 52 2c 0a 20 20 SQLITE_ERROR,.
37d0: 20 20 20 20 20 20 20 20 20 20 22 61 75 74 6f 6d "autom
37e0: 61 74 69 63 20 65 78 74 65 6e 73 69 6f 6e 20 6c atic extension l
37f0: 6f 61 64 69 6e 67 20 66 61 69 6c 65 64 3a 20 25 oading failed: %
3800: 73 22 2c 20 7a 45 72 72 6d 73 67 29 3b 0a 20 20 s", zErrmsg);.
3810: 20 20 20 20 67 6f 20 3d 20 30 3b 0a 20 20 20 20 go = 0;.
3820: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 rc = SQLITE_ER
3830: 52 4f 52 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 ROR;. sqlit
3840: 65 33 5f 66 72 65 65 28 7a 45 72 72 6d 73 67 29 e3_free(zErrmsg)
3850: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 ;. }. }. re
3860: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 65 6e 64 turn rc;.}..#end
3870: 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 if /* SQLITE_OMI
3880: 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e T_LOAD_EXTENSION
3890: 20 2a 2f 0a */.