0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
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: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 49 6e 74 65 72 6e ******.** Intern
0180: 61 6c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 al interface def
0190: 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 53 51 4c initions for SQL
01a0: 69 74 65 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 6e 64 ite..**.*/.#ifnd
01b0: 65 66 20 53 51 4c 49 54 45 49 4e 54 5f 48 0a 23 ef SQLITEINT_H.#
01c0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 49 4e 54 define SQLITEINT
01d0: 5f 48 0a 0a 2f 2a 20 53 70 65 63 69 61 6c 20 43 _H../* Special C
01e0: 6f 6d 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 53 omments:.**.** S
01f0: 6f 6d 65 20 63 6f 6d 6d 65 6e 74 73 20 68 61 76 ome comments hav
0200: 65 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e e special meanin
0210: 67 20 74 6f 20 74 68 65 20 74 6f 6f 6c 73 20 74 g to the tools t
0220: 68 61 74 20 6d 65 61 73 75 72 65 20 74 65 73 74 hat measure test
0230: 0a 2a 2a 20 63 6f 76 65 72 61 67 65 3a 0a 2a 2a .** coverage:.**
0240: 0a 2a 2a 20 20 20 20 4e 4f 5f 54 45 53 54 20 20 .** NO_TEST
0250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0260: 20 20 20 2d 20 54 68 65 20 62 72 61 6e 63 68 65 - The branche
0270: 73 20 6f 6e 20 74 68 69 73 20 6c 69 6e 65 20 61 s on this line a
0280: 72 65 20 6e 6f 74 0a 2a 2a 20 20 20 20 20 20 20 re not.**
0290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
02a0: 20 20 20 20 20 20 20 20 20 20 20 6d 65 61 73 75 measu
02b0: 72 65 64 20 62 79 20 62 72 61 6e 63 68 20 63 6f red by branch co
02c0: 76 65 72 61 67 65 2e 20 20 54 68 69 73 20 69 73 verage. This is
02d0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
02e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
02f0: 20 20 20 20 20 75 73 65 64 20 6f 6e 20 6c 69 6e used on lin
0300: 65 73 20 6f 66 20 63 6f 64 65 20 74 68 61 74 20 es of code that
0310: 61 63 74 75 61 6c 6c 79 0a 2a 2a 20 20 20 20 20 actually.**
0320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0330: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6d 70 imp
0340: 6c 65 6d 65 6e 74 20 70 61 72 74 73 20 6f 66 20 lement parts of
0350: 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 6e 67 coverage testing
0360: 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 4f 50 54 49 4d ..**.** OPTIM
0370: 49 5a 41 54 49 4f 4e 2d 49 46 2d 54 52 55 45 20 IZATION-IF-TRUE
0380: 20 20 20 20 20 20 20 2d 20 54 68 69 73 20 62 72 - This br
0390: 61 6e 63 68 20 69 73 20 61 6c 6c 6f 77 65 64 20 anch is allowed
03a0: 74 6f 20 61 6c 77 61 79 20 62 65 20 66 61 6c 73 to alway be fals
03b0: 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
03c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
03d0: 20 20 20 20 20 20 61 6e 64 20 74 68 65 20 63 6f and the co
03e0: 72 72 65 63 74 20 61 6e 73 77 65 72 20 69 73 20 rrect answer is
03f0: 73 74 69 6c 6c 20 6f 62 74 61 69 6e 65 64 2c 0a still obtained,.
0400: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
0410: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0420: 20 20 20 20 74 68 6f 75 67 68 20 70 65 72 68 61 though perha
0430: 70 73 20 6d 6f 72 65 20 73 6c 6f 77 6c 79 2e 0a ps more slowly..
0440: 2a 2a 0a 2a 2a 20 20 20 20 4f 50 54 49 4d 49 5a **.** OPTIMIZ
0450: 41 54 49 4f 4e 2d 49 46 2d 46 41 4c 53 45 20 20 ATION-IF-FALSE
0460: 20 20 20 20 20 2d 20 54 68 69 73 20 62 72 61 6e - This bran
0470: 63 68 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f ch is allowed to
0480: 20 61 6c 77 61 79 20 62 65 20 74 72 75 65 0a 2a alway be true.*
0490: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
04a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
04b0: 20 20 20 61 6e 64 20 74 68 65 20 63 6f 72 72 65 and the corre
04c0: 63 74 20 61 6e 73 77 65 72 20 69 73 20 73 74 69 ct answer is sti
04d0: 6c 6c 20 6f 62 74 61 69 6e 65 64 2c 0a 2a 2a 20 ll obtained,.**
04e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
04f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0500: 20 74 68 6f 75 67 68 20 70 65 72 68 61 70 73 20 though perhaps
0510: 6d 6f 72 65 20 73 6c 6f 77 6c 79 2e 0a 2a 2a 0a more slowly..**.
0520: 2a 2a 20 20 20 20 50 52 45 56 45 4e 54 53 2d 48 ** PREVENTS-H
0530: 41 52 4d 4c 45 53 53 2d 4f 56 45 52 52 45 41 44 ARMLESS-OVERREAD
0540: 20 20 2d 20 54 68 69 73 20 62 72 61 6e 63 68 20 - This branch
0550: 70 72 65 76 65 6e 74 73 20 61 20 62 75 66 66 65 prevents a buffe
0560: 72 20 6f 76 65 72 72 65 61 64 0a 2a 2a 20 20 20 r overread.**
0570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
0590: 68 61 74 20 77 6f 75 6c 64 20 62 65 20 68 61 72 hat would be har
05a0: 6d 6c 65 73 73 20 61 6e 64 20 75 6e 64 65 74 65 mless and undete
05b0: 63 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 ctable.**
05c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
05d0: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 69 74 if it
05e0: 20 64 69 64 20 6f 63 63 75 72 2e 20 20 0a 2a 2a did occur. .**
05f0: 0a 2a 2a 20 49 6e 20 61 6c 6c 20 63 61 73 65 73 .** In all cases
0600: 2c 20 74 68 65 20 73 70 65 63 69 61 6c 20 63 6f , the special co
0610: 6d 6d 65 6e 74 20 6d 75 73 74 20 62 65 20 65 6e mment must be en
0620: 63 6c 6f 73 65 64 20 69 6e 20 74 68 65 20 75 73 closed in the us
0630: 75 61 6c 0a 2a 2a 20 73 6c 61 73 68 2d 61 73 74 ual.** slash-ast
0640: 65 72 69 73 6b 2e 2e 2e 61 73 74 65 72 69 73 6b erisk...asterisk
0650: 2d 73 6c 61 73 68 20 63 6f 6d 6d 65 6e 74 20 6d -slash comment m
0660: 61 72 6b 73 2c 20 77 69 74 68 20 6e 6f 20 73 70 arks, with no sp
0670: 61 63 65 73 20 62 65 74 77 65 65 6e 20 74 68 65 aces between the
0680: 20 0a 2a 2a 20 61 73 74 65 72 69 73 6b 73 20 61 .** asterisks a
0690: 6e 64 20 74 68 65 20 63 6f 6d 6d 65 6e 74 20 74 nd the comment t
06a0: 65 78 74 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 4d ext..*/../*.** M
06b0: 61 6b 65 20 73 75 72 65 20 74 68 65 20 54 63 6c ake sure the Tcl
06c0: 20 63 61 6c 6c 69 6e 67 20 63 6f 6e 76 65 6e 74 calling convent
06d0: 69 6f 6e 20 6d 61 63 72 6f 20 69 73 20 64 65 66 ion macro is def
06e0: 69 6e 65 64 2e 20 20 54 68 69 73 20 6d 61 63 72 ined. This macr
06f0: 6f 20 69 73 0a 2a 2a 20 6f 6e 6c 79 20 75 73 65 o is.** only use
0700: 64 20 62 79 20 74 65 73 74 20 63 6f 64 65 20 61 d by test code a
0710: 6e 64 20 54 63 6c 20 69 6e 74 65 67 72 61 74 69 nd Tcl integrati
0720: 6f 6e 20 63 6f 64 65 2e 0a 2a 2f 0a 23 69 66 6e on code..*/.#ifn
0730: 64 65 66 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 def SQLITE_TCLAP
0740: 49 0a 23 20 20 64 65 66 69 6e 65 20 53 51 4c 49 I.# define SQLI
0750: 54 45 5f 54 43 4c 41 50 49 0a 23 65 6e 64 69 66 TE_TCLAPI.#endif
0760: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 75 64 65 20 ../*.** Include
0770: 74 68 65 20 68 65 61 64 65 72 20 66 69 6c 65 20 the header file
0780: 75 73 65 64 20 74 6f 20 63 75 73 74 6f 6d 69 7a used to customiz
0790: 65 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 6f e the compiler o
07a0: 70 74 69 6f 6e 73 20 66 6f 72 20 4d 53 56 43 2e ptions for MSVC.
07b0: 0a 2a 2a 20 54 68 69 73 20 73 68 6f 75 6c 64 20 .** This should
07c0: 62 65 20 64 6f 6e 65 20 66 69 72 73 74 20 73 6f be done first so
07d0: 20 74 68 61 74 20 69 74 20 63 61 6e 20 73 75 63 that it can suc
07e0: 63 65 73 73 66 75 6c 6c 79 20 70 72 65 76 65 6e cessfully preven
07f0: 74 20 73 70 75 72 69 6f 75 73 0a 2a 2a 20 63 6f t spurious.** co
0800: 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e 67 73 20 mpiler warnings
0810: 64 75 65 20 74 6f 20 73 75 62 73 65 71 75 65 6e due to subsequen
0820: 74 20 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 69 t content in thi
0830: 73 20 66 69 6c 65 20 61 6e 64 20 6f 74 68 65 72 s file and other
0840: 20 66 69 6c 65 73 0a 2a 2a 20 74 68 61 74 20 61 files.** that a
0850: 72 65 20 69 6e 63 6c 75 64 65 64 20 62 79 20 74 re included by t
0860: 68 69 73 20 66 69 6c 65 2e 0a 2a 2f 0a 23 69 6e his file..*/.#in
0870: 63 6c 75 64 65 20 22 6d 73 76 63 2e 68 22 0a 0a clude "msvc.h"..
0880: 2f 2a 0a 2a 2a 20 53 70 65 63 69 61 6c 20 73 65 /*.** Special se
0890: 74 75 70 20 66 6f 72 20 56 78 57 6f 72 6b 73 0a tup for VxWorks.
08a0: 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 76 78 77 */.#include "vxw
08b0: 6f 72 6b 73 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 54 orks.h"../*.** T
08c0: 68 65 73 65 20 23 64 65 66 69 6e 65 73 20 73 68 hese #defines sh
08d0: 6f 75 6c 64 20 65 6e 61 62 6c 65 20 3e 32 47 42 ould enable >2GB
08e0: 20 66 69 6c 65 20 73 75 70 70 6f 72 74 20 6f 6e file support on
08f0: 20 50 4f 53 49 58 20 69 66 20 74 68 65 0a 2a 2a POSIX if the.**
0900: 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f 70 65 72 underlying oper
0910: 61 74 69 6e 67 20 73 79 73 74 65 6d 20 73 75 70 ating system sup
0920: 70 6f 72 74 73 20 69 74 2e 20 20 49 66 20 74 68 ports it. If th
0930: 65 20 4f 53 20 6c 61 63 6b 73 0a 2a 2a 20 6c 61 e OS lacks.** la
0940: 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 rge file support
0950: 2c 20 6f 72 20 69 66 20 74 68 65 20 4f 53 20 69 , or if the OS i
0960: 73 20 77 69 6e 64 6f 77 73 2c 20 74 68 65 73 65 s windows, these
0970: 20 73 68 6f 75 6c 64 20 62 65 20 6e 6f 2d 6f 70 should be no-op
0980: 73 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 20 s..**.** Ticket
0990: 23 32 37 33 39 3a 20 20 54 68 65 20 5f 4c 41 52 #2739: The _LAR
09a0: 47 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 6d 61 GEFILE_SOURCE ma
09b0: 63 72 6f 20 6d 75 73 74 20 61 70 70 65 61 72 20 cro must appear
09c0: 62 65 66 6f 72 65 20 61 6e 79 0a 2a 2a 20 73 79 before any.** sy
09d0: 73 74 65 6d 20 23 69 6e 63 6c 75 64 65 73 2e 20 stem #includes.
09e0: 20 48 65 6e 63 65 2c 20 74 68 69 73 20 62 6c 6f Hence, this blo
09f0: 63 6b 20 6f 66 20 63 6f 64 65 20 6d 75 73 74 20 ck of code must
0a00: 62 65 20 74 68 65 20 76 65 72 79 20 66 69 72 73 be the very firs
0a10: 74 0a 2a 2a 20 63 6f 64 65 20 69 6e 20 61 6c 6c t.** code in all
0a20: 20 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 2a source files..*
0a30: 2a 0a 2a 2a 20 4c 61 72 67 65 20 66 69 6c 65 20 *.** Large file
0a40: 73 75 70 70 6f 72 74 20 63 61 6e 20 62 65 20 64 support can be d
0a50: 69 73 61 62 6c 65 64 20 75 73 69 6e 67 20 74 68 isabled using th
0a60: 65 20 2d 44 53 51 4c 49 54 45 5f 44 49 53 41 42 e -DSQLITE_DISAB
0a70: 4c 45 5f 4c 46 53 20 73 77 69 74 63 68 0a 2a 2a LE_LFS switch.**
0a80: 20 6f 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 on the compiler
0a90: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2e 20 20 command line.
0aa0: 54 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 This is necessar
0ab0: 79 20 69 66 20 79 6f 75 20 61 72 65 20 63 6f 6d y if you are com
0ac0: 70 69 6c 69 6e 67 0a 2a 2a 20 6f 6e 20 61 20 72 piling.** on a r
0ad0: 65 63 65 6e 74 20 6d 61 63 68 69 6e 65 20 28 65 ecent machine (e
0ae0: 78 3a 20 52 65 64 20 48 61 74 20 37 2e 32 29 20 x: Red Hat 7.2)
0af0: 62 75 74 20 79 6f 75 20 77 61 6e 74 20 79 6f 75 but you want you
0b00: 72 20 63 6f 64 65 20 74 6f 20 77 6f 72 6b 0a 2a r code to work.*
0b10: 2a 20 6f 6e 20 61 6e 20 6f 6c 64 65 72 20 6d 61 * on an older ma
0b20: 63 68 69 6e 65 20 28 65 78 3a 20 52 65 64 20 48 chine (ex: Red H
0b30: 61 74 20 36 2e 30 29 2e 20 20 49 66 20 79 6f 75 at 6.0). If you
0b40: 20 63 6f 6d 70 69 6c 65 20 6f 6e 20 52 65 64 20 compile on Red
0b50: 48 61 74 20 37 2e 32 0a 2a 2a 20 77 69 74 68 6f Hat 7.2.** witho
0b60: 75 74 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 ut this option,
0b70: 4c 46 53 20 69 73 20 65 6e 61 62 6c 65 2e 20 20 LFS is enable.
0b80: 42 75 74 20 4c 46 53 20 64 6f 65 73 20 6e 6f 74 But LFS does not
0b90: 20 65 78 69 73 74 20 69 6e 20 74 68 65 20 6b 65 exist in the ke
0ba0: 72 6e 65 6c 0a 2a 2a 20 69 6e 20 52 65 64 20 48 rnel.** in Red H
0bb0: 61 74 20 36 2e 30 2c 20 73 6f 20 74 68 65 20 63 at 6.0, so the c
0bc0: 6f 64 65 20 77 6f 6e 27 74 20 77 6f 72 6b 2e 20 ode won't work.
0bd0: 20 48 65 6e 63 65 2c 20 66 6f 72 20 6d 61 78 69 Hence, for maxi
0be0: 6d 75 6d 20 62 69 6e 61 72 79 0a 2a 2a 20 70 6f mum binary.** po
0bf0: 72 74 61 62 69 6c 69 74 79 20 79 6f 75 20 73 68 rtability you sh
0c00: 6f 75 6c 64 20 6f 6d 69 74 20 4c 46 53 2e 0a 2a ould omit LFS..*
0c10: 2a 0a 2a 2a 20 54 68 65 20 70 72 65 76 69 6f 75 *.** The previou
0c20: 73 20 70 61 72 61 67 72 61 70 68 20 77 61 73 20 s paragraph was
0c30: 77 72 69 74 74 65 6e 20 69 6e 20 32 30 30 35 2e written in 2005.
0c40: 20 20 28 54 68 69 73 20 70 61 72 61 67 72 61 70 (This paragrap
0c50: 68 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 h is written.**
0c60: 6f 6e 20 32 30 30 38 2d 31 31 2d 32 38 2e 29 20 on 2008-11-28.)
0c70: 54 68 65 73 65 20 64 61 79 73 2c 20 61 6c 6c 20 These days, all
0c80: 4c 69 6e 75 78 20 6b 65 72 6e 65 6c 73 20 73 75 Linux kernels su
0c90: 70 70 6f 72 74 20 6c 61 72 67 65 20 66 69 6c 65 pport large file
0ca0: 73 2c 20 73 6f 0a 2a 2a 20 79 6f 75 20 73 68 6f s, so.** you sho
0cb0: 75 6c 64 20 70 72 6f 62 61 62 6c 79 20 6c 65 61 uld probably lea
0cc0: 76 65 20 4c 46 53 20 65 6e 61 62 6c 65 64 2e 20 ve LFS enabled.
0cd0: 20 42 75 74 20 73 6f 6d 65 20 65 6d 62 65 64 64 But some embedd
0ce0: 65 64 20 70 6c 61 74 66 6f 72 6d 73 20 6d 69 67 ed platforms mig
0cf0: 68 74 0a 2a 2a 20 6c 61 63 6b 20 4c 46 53 20 69 ht.** lack LFS i
0d00: 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 n which case the
0d10: 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f SQLITE_DISABLE_
0d20: 4c 46 53 20 6d 61 63 72 6f 20 6d 69 67 68 74 20 LFS macro might
0d30: 73 74 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2e still be useful.
0d40: 0a 2a 2a 0a 2a 2a 20 53 69 6d 69 6c 61 72 20 69 .**.** Similar i
0d50: 73 20 74 72 75 65 20 66 6f 72 20 4d 61 63 20 4f s true for Mac O
0d60: 53 20 58 2e 20 20 4c 46 53 20 69 73 20 6f 6e 6c S X. LFS is onl
0d70: 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 4d y supported on M
0d80: 61 63 20 4f 53 20 58 20 39 20 61 6e 64 20 6c 61 ac OS X 9 and la
0d90: 74 65 72 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ter..*/.#ifndef
0da0: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c SQLITE_DISABLE_L
0db0: 46 53 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 FS.# define _LAR
0dc0: 47 45 5f 46 49 4c 45 20 20 20 20 20 20 20 31 0a GE_FILE 1.
0dd0: 23 20 69 66 6e 64 65 66 20 5f 46 49 4c 45 5f 4f # ifndef _FILE_O
0de0: 46 46 53 45 54 5f 42 49 54 53 0a 23 20 20 20 64 FFSET_BITS.# d
0df0: 65 66 69 6e 65 20 5f 46 49 4c 45 5f 4f 46 46 53 efine _FILE_OFFS
0e00: 45 54 5f 42 49 54 53 20 36 34 0a 23 20 65 6e 64 ET_BITS 64.# end
0e10: 69 66 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 if.# define _LAR
0e20: 47 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 31 0a GEFILE_SOURCE 1.
0e30: 23 65 6e 64 69 66 0a 0a 2f 2a 20 54 68 65 20 47 #endif../* The G
0e40: 43 43 5f 56 45 52 53 49 4f 4e 20 61 6e 64 20 4d CC_VERSION and M
0e50: 53 56 43 5f 56 45 52 53 49 4f 4e 20 6d 61 63 72 SVC_VERSION macr
0e60: 6f 73 20 61 72 65 20 75 73 65 64 20 74 6f 0a 2a os are used to.*
0e70: 2a 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 * conditionally
0e80: 69 6e 63 6c 75 64 65 20 6f 70 74 69 6d 69 7a 61 include optimiza
0e90: 74 69 6f 6e 73 20 66 6f 72 20 65 61 63 68 20 6f tions for each o
0ea0: 66 20 74 68 65 73 65 20 63 6f 6d 70 69 6c 65 72 f these compiler
0eb0: 73 2e 20 20 41 0a 2a 2a 20 76 61 6c 75 65 20 6f s. A.** value o
0ec0: 66 20 30 20 6d 65 61 6e 73 20 74 68 61 74 20 63 f 0 means that c
0ed0: 6f 6d 70 69 6c 65 72 20 69 73 20 6e 6f 74 20 62 ompiler is not b
0ee0: 65 69 6e 67 20 75 73 65 64 2e 20 20 54 68 65 0a eing used. The.
0ef0: 2a 2a 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c ** SQLITE_DISABL
0f00: 45 5f 49 4e 54 52 49 4e 53 49 43 20 6d 61 63 72 E_INTRINSIC macr
0f10: 6f 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 75 o means do not u
0f20: 73 65 20 61 6e 79 20 63 6f 6d 70 69 6c 65 72 2d se any compiler-
0f30: 73 70 65 63 69 66 69 63 0a 2a 2a 20 6f 70 74 69 specific.** opti
0f40: 6d 69 7a 61 74 69 6f 6e 73 2c 20 61 6e 64 20 68 mizations, and h
0f50: 65 6e 63 65 20 73 65 74 20 61 6c 6c 20 63 6f 6d ence set all com
0f60: 70 69 6c 65 72 20 6d 61 63 72 6f 73 20 74 6f 20 piler macros to
0f70: 30 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 77 61 0.**.** There wa
0f80: 73 20 6f 6e 63 65 20 61 6c 73 6f 20 61 20 43 4c s once also a CL
0f90: 41 4e 47 5f 56 45 52 53 49 4f 4e 20 6d 61 63 72 ANG_VERSION macr
0fa0: 6f 2e 20 20 48 6f 77 65 76 65 72 2c 20 77 65 20 o. However, we
0fb0: 6c 65 61 72 6e 20 74 68 61 74 20 74 68 65 0a 2a learn that the.*
0fc0: 2a 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 * version number
0fd0: 73 20 69 6e 20 63 6c 61 6e 67 20 61 72 65 20 66 s in clang are f
0fe0: 6f 72 20 22 6d 61 72 6b 65 74 69 6e 67 22 20 6f or "marketing" o
0ff0: 6e 6c 79 20 61 6e 64 20 61 72 65 20 69 6e 63 6f nly and are inco
1000: 6e 73 69 73 74 65 6e 74 0a 2a 2a 20 61 6e 64 20 nsistent.** and
1010: 75 6e 72 65 6c 69 61 62 6c 65 2e 20 20 46 6f 72 unreliable. For
1020: 74 75 6e 61 74 65 6c 79 2c 20 61 6c 6c 20 76 65 tunately, all ve
1030: 72 73 69 6f 6e 73 20 6f 66 20 63 6c 61 6e 67 20 rsions of clang
1040: 61 6c 73 6f 20 72 65 63 6f 67 6e 69 7a 65 20 74 also recognize t
1050: 68 65 0a 2a 2a 20 67 63 63 20 76 65 72 73 69 6f he.** gcc versio
1060: 6e 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 68 61 n numbers and ha
1070: 76 65 20 72 65 61 73 6f 6e 61 62 6c 65 20 73 65 ve reasonable se
1080: 74 74 69 6e 67 73 20 66 6f 72 20 67 63 63 20 76 ttings for gcc v
1090: 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 73 2c 0a ersion numbers,.
10a0: 2a 2a 20 73 6f 20 74 68 65 20 47 43 43 5f 56 45 ** so the GCC_VE
10b0: 52 53 49 4f 4e 20 6d 61 63 72 6f 20 77 69 6c 6c RSION macro will
10c0: 20 62 65 20 73 65 74 20 74 6f 20 61 20 63 6f 72 be set to a cor
10d0: 72 65 63 74 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 rect non-zero va
10e0: 6c 75 65 20 65 76 65 6e 0a 2a 2a 20 77 68 65 6e lue even.** when
10f0: 20 63 6f 6d 70 69 6c 69 6e 67 20 77 69 74 68 20 compiling with
1100: 63 6c 61 6e 67 2e 0a 2a 2f 0a 23 69 66 20 64 65 clang..*/.#if de
1110: 66 69 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 fined(__GNUC__)
1120: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
1130: 54 45 5f 44 49 53 41 42 4c 45 5f 49 4e 54 52 49 TE_DISABLE_INTRI
1140: 4e 53 49 43 29 0a 23 20 64 65 66 69 6e 65 20 47 NSIC).# define G
1150: 43 43 5f 56 45 52 53 49 4f 4e 20 28 5f 5f 47 4e CC_VERSION (__GN
1160: 55 43 5f 5f 2a 31 30 30 30 30 30 30 2b 5f 5f 47 UC__*1000000+__G
1170: 4e 55 43 5f 4d 49 4e 4f 52 5f 5f 2a 31 30 30 30 NUC_MINOR__*1000
1180: 2b 5f 5f 47 4e 55 43 5f 50 41 54 43 48 4c 45 56 +__GNUC_PATCHLEV
1190: 45 4c 5f 5f 29 0a 23 65 6c 73 65 0a 23 20 64 65 EL__).#else.# de
11a0: 66 69 6e 65 20 47 43 43 5f 56 45 52 53 49 4f 4e fine GCC_VERSION
11b0: 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 0.#endif.#if de
11c0: 66 69 6e 65 64 28 5f 4d 53 43 5f 56 45 52 29 20 fined(_MSC_VER)
11d0: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
11e0: 54 45 5f 44 49 53 41 42 4c 45 5f 49 4e 54 52 49 TE_DISABLE_INTRI
11f0: 4e 53 49 43 29 0a 23 20 64 65 66 69 6e 65 20 4d NSIC).# define M
1200: 53 56 43 5f 56 45 52 53 49 4f 4e 20 5f 4d 53 43 SVC_VERSION _MSC
1210: 5f 56 45 52 0a 23 65 6c 73 65 0a 23 20 64 65 66 _VER.#else.# def
1220: 69 6e 65 20 4d 53 56 43 5f 56 45 52 53 49 4f 4e ine MSVC_VERSION
1230: 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 4e 65 0.#endif../* Ne
1240: 65 64 65 64 20 66 6f 72 20 76 61 72 69 6f 75 73 eded for various
1250: 20 64 65 66 69 6e 69 74 69 6f 6e 73 2e 2e 2e 20 definitions...
1260: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f */.#if defined(_
1270: 5f 47 4e 55 43 5f 5f 29 20 26 26 20 21 64 65 66 _GNUC__) && !def
1280: 69 6e 65 64 28 5f 47 4e 55 5f 53 4f 55 52 43 45 ined(_GNU_SOURCE
1290: 29 0a 23 20 64 65 66 69 6e 65 20 5f 47 4e 55 5f ).# define _GNU_
12a0: 53 4f 55 52 43 45 0a 23 65 6e 64 69 66 0a 0a 23 SOURCE.#endif..#
12b0: 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 4f 70 65 if defined(__Ope
12c0: 6e 42 53 44 5f 5f 29 20 26 26 20 21 64 65 66 69 nBSD__) && !defi
12d0: 6e 65 64 28 5f 42 53 44 5f 53 4f 55 52 43 45 29 ned(_BSD_SOURCE)
12e0: 0a 23 20 64 65 66 69 6e 65 20 5f 42 53 44 5f 53 .# define _BSD_S
12f0: 4f 55 52 43 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a OURCE.#endif../*
1300: 0a 2a 2a 20 46 6f 72 20 4d 69 6e 47 57 2c 20 63 .** For MinGW, c
1310: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 77 heck to see if w
1320: 65 20 63 61 6e 20 69 6e 63 6c 75 64 65 20 74 68 e can include th
1330: 65 20 68 65 61 64 65 72 20 66 69 6c 65 20 63 6f e header file co
1340: 6e 74 61 69 6e 69 6e 67 20 69 74 73 0a 2a 2a 20 ntaining its.**
1350: 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 version informat
1360: 69 6f 6e 2c 20 61 6d 6f 6e 67 20 6f 74 68 65 72 ion, among other
1370: 20 74 68 69 6e 67 73 2e 20 20 4e 6f 72 6d 61 6c things. Normal
1380: 6c 79 2c 20 74 68 69 73 20 69 6e 74 65 72 6e 61 ly, this interna
1390: 6c 20 4d 69 6e 47 57 0a 2a 2a 20 68 65 61 64 65 l MinGW.** heade
13a0: 72 20 66 69 6c 65 20 77 6f 75 6c 64 20 5b 6f 6e r file would [on
13b0: 6c 79 5d 20 62 65 20 69 6e 63 6c 75 64 65 64 20 ly] be included
13c0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 automatically by
13d0: 20 6f 74 68 65 72 20 4d 69 6e 47 57 20 68 65 61 other MinGW hea
13e0: 64 65 72 0a 2a 2a 20 66 69 6c 65 73 3b 20 68 6f der.** files; ho
13f0: 77 65 76 65 72 2c 20 74 68 65 20 63 6f 6e 74 61 wever, the conta
1400: 69 6e 65 64 20 76 65 72 73 69 6f 6e 20 69 6e 66 ined version inf
1410: 6f 72 6d 61 74 69 6f 6e 20 69 73 20 6e 6f 77 20 ormation is now
1420: 72 65 71 75 69 72 65 64 20 62 79 20 74 68 69 73 required by this
1430: 0a 2a 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20 .** header file
1440: 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 62 to work around b
1450: 69 6e 61 72 79 20 63 6f 6d 70 61 74 69 62 69 6c inary compatibil
1460: 69 74 79 20 69 73 73 75 65 73 20 28 73 65 65 20 ity issues (see
1470: 62 65 6c 6f 77 29 20 61 6e 64 0a 2a 2a 20 74 68 below) and.** th
1480: 69 73 20 69 73 20 74 68 65 20 6f 6e 6c 79 20 6b is is the only k
1490: 6e 6f 77 6e 20 77 61 79 20 74 6f 20 72 65 6c 69 nown way to reli
14a0: 61 62 6c 79 20 6f 62 74 61 69 6e 20 69 74 2e 20 ably obtain it.
14b0: 20 54 68 69 73 20 65 6e 74 69 72 65 20 23 69 66 This entire #if
14c0: 20 62 6c 6f 63 6b 0a 2a 2a 20 77 6f 75 6c 64 20 block.** would
14d0: 62 65 20 63 6f 6d 70 6c 65 74 65 6c 79 20 75 6e be completely un
14e0: 6e 65 63 65 73 73 61 72 79 20 69 66 20 74 68 65 necessary if the
14f0: 72 65 20 77 61 73 20 61 6e 79 20 6f 74 68 65 72 re was any other
1500: 20 77 61 79 20 6f 66 20 64 65 74 65 63 74 69 6e way of detectin
1510: 67 0a 2a 2a 20 4d 69 6e 47 57 20 76 69 61 20 74 g.** MinGW via t
1520: 68 65 69 72 20 70 72 65 70 72 6f 63 65 73 73 6f heir preprocesso
1530: 72 20 28 65 2e 67 2e 20 69 66 20 74 68 65 79 20 r (e.g. if they
1540: 63 75 73 74 6f 6d 69 7a 65 64 20 74 68 65 69 72 customized their
1550: 20 47 43 43 20 74 6f 20 64 65 66 69 6e 65 0a 2a GCC to define.*
1560: 2a 20 73 6f 6d 65 20 4d 69 6e 47 57 2d 73 70 65 * some MinGW-spe
1570: 63 69 66 69 63 20 6d 61 63 72 6f 73 29 2e 20 20 cific macros).
1580: 57 68 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 66 When compiling f
1590: 6f 72 20 4d 69 6e 47 57 2c 20 65 69 74 68 65 72 or MinGW, either
15a0: 20 74 68 65 0a 2a 2a 20 5f 48 41 56 45 5f 4d 49 the.** _HAVE_MI
15b0: 4e 47 57 5f 48 20 6f 72 20 5f 48 41 56 45 5f 5f NGW_H or _HAVE__
15c0: 4d 49 4e 47 57 5f 48 20 28 6e 6f 74 65 20 74 68 MINGW_H (note th
15d0: 65 20 65 78 74 72 61 20 75 6e 64 65 72 73 63 6f e extra undersco
15e0: 72 65 29 20 6d 61 63 72 6f 20 6d 75 73 74 20 62 re) macro must b
15f0: 65 0a 2a 2a 20 64 65 66 69 6e 65 64 3b 20 6f 74 e.** defined; ot
1600: 68 65 72 77 69 73 65 2c 20 64 65 74 65 63 74 69 herwise, detecti
1610: 6f 6e 20 6f 66 20 63 6f 6e 64 69 74 69 6f 6e 73 on of conditions
1620: 20 73 70 65 63 69 66 69 63 20 74 6f 20 4d 69 6e specific to Min
1630: 47 57 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 64 69 GW will be.** di
1640: 73 61 62 6c 65 64 2e 0a 2a 2f 0a 23 69 66 20 64 sabled..*/.#if d
1650: 65 66 69 6e 65 64 28 5f 48 41 56 45 5f 4d 49 4e efined(_HAVE_MIN
1660: 47 57 5f 48 29 0a 23 20 69 6e 63 6c 75 64 65 20 GW_H).# include
1670: 22 6d 69 6e 67 77 2e 68 22 0a 23 65 6c 69 66 20 "mingw.h".#elif
1680: 64 65 66 69 6e 65 64 28 5f 48 41 56 45 5f 5f 4d defined(_HAVE__M
1690: 49 4e 47 57 5f 48 29 0a 23 20 69 6e 63 6c 75 64 INGW_H).# includ
16a0: 65 20 22 5f 6d 69 6e 67 77 2e 68 22 0a 23 65 6e e "_mingw.h".#en
16b0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 4d dif../*.** For M
16c0: 69 6e 47 57 20 76 65 72 73 69 6f 6e 20 34 2e 78 inGW version 4.x
16d0: 20 28 61 6e 64 20 68 69 67 68 65 72 29 2c 20 63 (and higher), c
16e0: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 74 heck to see if t
16f0: 68 65 20 5f 55 53 45 5f 33 32 42 49 54 5f 54 49 he _USE_32BIT_TI
1700: 4d 45 5f 54 0a 2a 2a 20 64 65 66 69 6e 65 20 69 ME_T.** define i
1710: 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 6d 61 s required to ma
1720: 69 6e 74 61 69 6e 20 62 69 6e 61 72 79 20 63 6f intain binary co
1730: 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 mpatibility with
1740: 20 74 68 65 20 4d 53 56 43 20 72 75 6e 74 69 6d the MSVC runtim
1750: 65 0a 2a 2a 20 6c 69 62 72 61 72 79 20 69 6e 20 e.** library in
1760: 75 73 65 20 28 65 2e 67 2e 20 66 6f 72 20 57 69 use (e.g. for Wi
1770: 6e 64 6f 77 73 20 58 50 29 2e 0a 2a 2f 0a 23 69 ndows XP)..*/.#i
1780: 66 20 21 64 65 66 69 6e 65 64 28 5f 55 53 45 5f f !defined(_USE_
1790: 33 32 42 49 54 5f 54 49 4d 45 5f 54 29 20 26 26 32BIT_TIME_T) &&
17a0: 20 21 64 65 66 69 6e 65 64 28 5f 55 53 45 5f 36 !defined(_USE_6
17b0: 34 42 49 54 5f 54 49 4d 45 5f 54 29 20 26 26 20 4BIT_TIME_T) &&
17c0: 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 28 5f 57 \. defined(_W
17d0: 49 4e 33 32 29 20 26 26 20 21 64 65 66 69 6e 65 IN32) && !define
17e0: 64 28 5f 57 49 4e 36 34 29 20 26 26 20 5c 0a 20 d(_WIN64) && \.
17f0: 20 20 20 64 65 66 69 6e 65 64 28 5f 5f 4d 49 4e defined(__MIN
1800: 47 57 5f 4d 41 4a 4f 52 5f 56 45 52 53 49 4f 4e GW_MAJOR_VERSION
1810: 29 20 26 26 20 5f 5f 4d 49 4e 47 57 5f 4d 41 4a ) && __MINGW_MAJ
1820: 4f 52 5f 56 45 52 53 49 4f 4e 20 3e 3d 20 34 20 OR_VERSION >= 4
1830: 26 26 20 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 && \. defined
1840: 28 5f 5f 4d 53 56 43 52 54 5f 5f 29 0a 23 20 64 (__MSVCRT__).# d
1850: 65 66 69 6e 65 20 5f 55 53 45 5f 33 32 42 49 54 efine _USE_32BIT
1860: 5f 54 49 4d 45 5f 54 0a 23 65 6e 64 69 66 0a 0a _TIME_T.#endif..
1870: 2f 2a 20 54 68 65 20 70 75 62 6c 69 63 20 53 51 /* The public SQ
1880: 4c 69 74 65 20 69 6e 74 65 72 66 61 63 65 2e 20 Lite interface.
1890: 20 54 68 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 The _FILE_OFFSE
18a0: 54 5f 42 49 54 53 20 6d 61 63 72 6f 20 6d 75 73 T_BITS macro mus
18b0: 74 20 61 70 70 65 61 72 0a 2a 2a 20 66 69 72 73 t appear.** firs
18c0: 74 20 69 6e 20 51 4e 58 2e 20 20 41 6c 73 6f 2c t in QNX. Also,
18d0: 20 74 68 65 20 5f 55 53 45 5f 33 32 42 49 54 5f the _USE_32BIT_
18e0: 54 49 4d 45 5f 54 20 6d 61 63 72 6f 20 6d 75 73 TIME_T macro mus
18f0: 74 20 61 70 70 65 61 72 20 66 69 72 73 74 20 66 t appear first f
1900: 6f 72 0a 2a 2a 20 4d 69 6e 47 57 2e 0a 2a 2f 0a or.** MinGW..*/.
1910: 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 #include "sqlite
1920: 33 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 3.h"../*.** Incl
1930: 75 64 65 20 74 68 65 20 63 6f 6e 66 69 67 75 72 ude the configur
1940: 61 74 69 6f 6e 20 68 65 61 64 65 72 20 6f 75 74 ation header out
1950: 70 75 74 20 62 79 20 27 63 6f 6e 66 69 67 75 72 put by 'configur
1960: 65 27 20 69 66 20 77 65 27 72 65 20 75 73 69 6e e' if we're usin
1970: 67 20 74 68 65 0a 2a 2a 20 61 75 74 6f 63 6f 6e g the.** autocon
1980: 66 2d 62 61 73 65 64 20 62 75 69 6c 64 0a 2a 2f f-based build.*/
1990: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 48 41 .#if defined(_HA
19a0: 56 45 5f 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 VE_SQLITE_CONFIG
19b0: 5f 48 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 _H) && !defined(
19c0: 53 51 4c 49 54 45 43 4f 4e 46 49 47 5f 48 29 0a SQLITECONFIG_H).
19d0: 23 69 6e 63 6c 75 64 65 20 22 63 6f 6e 66 69 67 #include "config
19e0: 2e 68 22 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .h".#define SQLI
19f0: 54 45 43 4f 4e 46 49 47 5f 48 20 31 0a 23 65 6e TECONFIG_H 1.#en
1a00: 64 69 66 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 dif..#include "s
1a10: 71 6c 69 74 65 4c 69 6d 69 74 2e 68 22 0a 0a 2f qliteLimit.h"../
1a20: 2a 20 44 69 73 61 62 6c 65 20 6e 75 69 73 61 6e * Disable nuisan
1a30: 63 65 20 77 61 72 6e 69 6e 67 73 20 6f 6e 20 42 ce warnings on B
1a40: 6f 72 6c 61 6e 64 20 63 6f 6d 70 69 6c 65 72 73 orland compilers
1a50: 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 */.#if defined(
1a60: 5f 5f 42 4f 52 4c 41 4e 44 43 5f 5f 29 0a 23 70 __BORLANDC__).#p
1a70: 72 61 67 6d 61 20 77 61 72 6e 20 2d 72 63 68 20 ragma warn -rch
1a80: 2f 2a 20 75 6e 72 65 61 63 68 61 62 6c 65 20 63 /* unreachable c
1a90: 6f 64 65 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 ode */.#pragma w
1aa0: 61 72 6e 20 2d 63 63 63 20 2f 2a 20 43 6f 6e 64 arn -ccc /* Cond
1ab0: 69 74 69 6f 6e 20 69 73 20 61 6c 77 61 79 73 20 ition is always
1ac0: 74 72 75 65 20 6f 72 20 66 61 6c 73 65 20 2a 2f true or false */
1ad0: 0a 23 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 61 .#pragma warn -a
1ae0: 75 73 20 2f 2a 20 41 73 73 69 67 6e 65 64 20 76 us /* Assigned v
1af0: 61 6c 75 65 20 69 73 20 6e 65 76 65 72 20 75 73 alue is never us
1b00: 65 64 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 ed */.#pragma wa
1b10: 72 6e 20 2d 63 73 75 20 2f 2a 20 43 6f 6d 70 61 rn -csu /* Compa
1b20: 72 69 6e 67 20 73 69 67 6e 65 64 20 61 6e 64 20 ring signed and
1b30: 75 6e 73 69 67 6e 65 64 20 2a 2f 0a 23 70 72 61 unsigned */.#pra
1b40: 67 6d 61 20 77 61 72 6e 20 2d 73 70 61 20 2f 2a gma warn -spa /*
1b50: 20 53 75 73 70 69 63 69 6f 75 73 20 70 6f 69 6e Suspicious poin
1b60: 74 65 72 20 61 72 69 74 68 6d 65 74 69 63 20 2a ter arithmetic *
1b70: 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 /.#endif../*.**
1b80: 49 6e 63 6c 75 64 65 20 73 74 61 6e 64 61 72 64 Include standard
1b90: 20 68 65 61 64 65 72 20 66 69 6c 65 73 20 61 73 header files as
1ba0: 20 6e 65 63 65 73 73 61 72 79 0a 2a 2f 0a 23 69 necessary.*/.#i
1bb0: 66 64 65 66 20 48 41 56 45 5f 53 54 44 49 4e 54 fdef HAVE_STDINT
1bc0: 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 _H.#include <std
1bd0: 69 6e 74 2e 68 3e 0a 23 65 6e 64 69 66 0a 23 69 int.h>.#endif.#i
1be0: 66 64 65 66 20 48 41 56 45 5f 49 4e 54 54 59 50 fdef HAVE_INTTYP
1bf0: 45 53 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c 69 ES_H.#include <i
1c00: 6e 74 74 79 70 65 73 2e 68 3e 0a 23 65 6e 64 69 nttypes.h>.#endi
1c10: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c f../*.** The fol
1c20: 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 lowing macros ar
1c30: 65 20 75 73 65 64 20 74 6f 20 63 61 73 74 20 70 e used to cast p
1c40: 6f 69 6e 74 65 72 73 20 74 6f 20 69 6e 74 65 67 ointers to integ
1c50: 65 72 73 20 61 6e 64 0a 2a 2a 20 69 6e 74 65 67 ers and.** integ
1c60: 65 72 73 20 74 6f 20 70 6f 69 6e 74 65 72 73 2e ers to pointers.
1c70: 20 20 54 68 65 20 77 61 79 20 79 6f 75 20 64 6f The way you do
1c80: 20 74 68 69 73 20 76 61 72 69 65 73 20 66 72 6f this varies fro
1c90: 6d 20 6f 6e 65 20 63 6f 6d 70 69 6c 65 72 0a 2a m one compiler.*
1ca0: 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 2c 20 73 * to the next, s
1cb0: 6f 20 77 65 20 68 61 76 65 20 64 65 76 65 6c 6f o we have develo
1cc0: 70 65 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e ped the followin
1cd0: 67 20 73 65 74 20 6f 66 20 23 69 66 20 73 74 61 g set of #if sta
1ce0: 74 65 6d 65 6e 74 73 0a 2a 2a 20 74 6f 20 67 65 tements.** to ge
1cf0: 6e 65 72 61 74 65 20 61 70 70 72 6f 70 72 69 61 nerate appropria
1d00: 74 65 20 6d 61 63 72 6f 73 20 66 6f 72 20 61 20 te macros for a
1d10: 77 69 64 65 20 72 61 6e 67 65 20 6f 66 20 63 6f wide range of co
1d20: 6d 70 69 6c 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 mpilers..**.** T
1d30: 68 65 20 63 6f 72 72 65 63 74 20 22 41 4e 53 49 he correct "ANSI
1d40: 22 20 77 61 79 20 74 6f 20 64 6f 20 74 68 69 73 " way to do this
1d50: 20 69 73 20 74 6f 20 75 73 65 20 74 68 65 20 69 is to use the i
1d60: 6e 74 70 74 72 5f 74 20 74 79 70 65 2e 0a 2a 2a ntptr_t type..**
1d70: 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c 79 2c 20 Unfortunately,
1d80: 74 68 61 74 20 74 79 70 65 64 65 66 20 69 73 20 that typedef is
1d90: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e not available on
1da0: 20 61 6c 6c 20 63 6f 6d 70 69 6c 65 72 73 2c 20 all compilers,
1db0: 6f 72 0a 2a 2a 20 69 66 20 69 74 20 69 73 20 61 or.** if it is a
1dc0: 76 61 69 6c 61 62 6c 65 2c 20 69 74 20 72 65 71 vailable, it req
1dd0: 75 69 72 65 73 20 61 6e 20 23 69 6e 63 6c 75 64 uires an #includ
1de0: 65 20 6f 66 20 73 70 65 63 69 66 69 63 20 68 65 e of specific he
1df0: 61 64 65 72 73 0a 2a 2a 20 74 68 61 74 20 76 61 aders.** that va
1e00: 72 79 20 66 72 6f 6d 20 6f 6e 65 20 6d 61 63 68 ry from one mach
1e10: 69 6e 65 20 74 6f 20 74 68 65 20 6e 65 78 74 2e ine to the next.
1e20: 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 20 23 33 .**.** Ticket #3
1e30: 38 36 30 3a 20 20 54 68 65 20 6c 6c 76 6d 2d 67 860: The llvm-g
1e40: 63 63 2d 34 2e 32 20 63 6f 6d 70 69 6c 65 72 20 cc-4.2 compiler
1e50: 66 72 6f 6d 20 41 70 70 6c 65 20 63 68 6f 6b 65 from Apple choke
1e60: 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 28 28 76 6f s on.** the ((vo
1e70: 69 64 2a 29 26 28 28 63 68 61 72 2a 29 30 29 5b id*)&((char*)0)[
1e80: 58 5d 29 20 63 6f 6e 73 74 72 75 63 74 2e 20 20 X]) construct.
1e90: 42 75 74 20 4d 53 56 43 20 63 68 6f 6b 65 73 20 But MSVC chokes
1ea0: 6f 6e 20 28 28 76 6f 69 64 2a 29 28 58 29 29 2e on ((void*)(X)).
1eb0: 0a 2a 2a 20 53 6f 20 77 65 20 68 61 76 65 20 74 .** So we have t
1ec0: 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6d 61 63 o define the mac
1ed0: 72 6f 73 20 69 6e 20 64 69 66 66 65 72 65 6e 74 ros in different
1ee0: 20 77 61 79 73 20 64 65 70 65 6e 64 69 6e 67 20 ways depending
1ef0: 6f 6e 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 69 6c on the.** compil
1f00: 65 72 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e er..*/.#if defin
1f10: 65 64 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 50 ed(__PTRDIFF_TYP
1f20: 45 5f 5f 29 20 20 2f 2a 20 54 68 69 73 20 63 61 E__) /* This ca
1f30: 73 65 20 73 68 6f 75 6c 64 20 77 6f 72 6b 20 66 se should work f
1f40: 6f 72 20 47 43 43 20 2a 2f 0a 23 20 64 65 66 69 or GCC */.# defi
1f50: 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f ne SQLITE_INT_TO
1f60: 5f 50 54 52 28 58 29 20 20 28 28 76 6f 69 64 2a _PTR(X) ((void*
1f70: 29 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 50 45 )(__PTRDIFF_TYPE
1f80: 5f 5f 29 28 58 29 29 0a 23 20 64 65 66 69 6e 65 __)(X)).# define
1f90: 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 SQLITE_PTR_TO_I
1fa0: 4e 54 28 58 29 20 20 28 28 69 6e 74 29 28 5f 5f NT(X) ((int)(__
1fb0: 50 54 52 44 49 46 46 5f 54 59 50 45 5f 5f 29 28 PTRDIFF_TYPE__)(
1fc0: 58 29 29 0a 23 65 6c 69 66 20 21 64 65 66 69 6e X)).#elif !defin
1fd0: 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 20 20 20 ed(__GNUC__)
1fe0: 20 20 20 2f 2a 20 57 6f 72 6b 73 20 66 6f 72 20 /* Works for
1ff0: 63 6f 6d 70 69 6c 65 72 73 20 6f 74 68 65 72 20 compilers other
2000: 74 68 61 6e 20 4c 4c 56 4d 20 2a 2f 0a 23 20 64 than LLVM */.# d
2010: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 efine SQLITE_INT
2020: 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f _TO_PTR(X) ((vo
2030: 69 64 2a 29 26 28 28 63 68 61 72 2a 29 30 29 5b id*)&((char*)0)[
2040: 58 5d 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c X]).# define SQL
2050: 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 ITE_PTR_TO_INT(X
2060: 29 20 20 28 28 69 6e 74 29 28 28 28 63 68 61 72 ) ((int)(((char
2070: 2a 29 58 29 2d 28 63 68 61 72 2a 29 30 29 29 0a *)X)-(char*)0)).
2080: 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 48 41 #elif defined(HA
2090: 56 45 5f 53 54 44 49 4e 54 5f 48 29 20 20 20 2f VE_STDINT_H) /
20a0: 2a 20 55 73 65 20 74 68 69 73 20 63 61 73 65 20 * Use this case
20b0: 69 66 20 77 65 20 68 61 76 65 20 41 4e 53 49 20 if we have ANSI
20c0: 68 65 61 64 65 72 73 20 2a 2f 0a 23 20 64 65 66 headers */.# def
20d0: 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 ine SQLITE_INT_T
20e0: 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f 69 64 O_PTR(X) ((void
20f0: 2a 29 28 69 6e 74 70 74 72 5f 74 29 28 58 29 29 *)(intptr_t)(X))
2100: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
2110: 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 20 _PTR_TO_INT(X)
2120: 28 28 69 6e 74 29 28 69 6e 74 70 74 72 5f 74 29 ((int)(intptr_t)
2130: 28 58 29 29 0a 23 65 6c 73 65 20 20 20 20 20 20 (X)).#else
2140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2150: 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 73 /* Generates
2160: 20 61 20 77 61 72 6e 69 6e 67 20 2d 20 62 75 74 a warning - but
2170: 20 69 74 20 61 6c 77 61 79 73 20 77 6f 72 6b 73 it always works
2180: 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c */.# define SQL
2190: 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 ITE_INT_TO_PTR(X
21a0: 29 20 20 28 28 76 6f 69 64 2a 29 28 58 29 29 0a ) ((void*)(X)).
21b0: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
21c0: 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 20 28 PTR_TO_INT(X) (
21d0: 28 69 6e 74 29 28 58 29 29 0a 23 65 6e 64 69 66 (int)(X)).#endif
21e0: 0a 0a 2f 2a 0a 2a 2a 20 41 20 6d 61 63 72 6f 20 ../*.** A macro
21f0: 74 6f 20 68 69 6e 74 20 74 6f 20 74 68 65 20 63 to hint to the c
2200: 6f 6d 70 69 6c 65 72 20 74 68 61 74 20 61 20 66 ompiler that a f
2210: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 6e unction should n
2220: 6f 74 20 62 65 0a 2a 2a 20 69 6e 6c 69 6e 65 64 ot be.** inlined
2230: 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 ..*/.#if defined
2240: 28 5f 5f 47 4e 55 43 5f 5f 29 0a 23 20 20 64 65 (__GNUC__).# de
2250: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 49 4e fine SQLITE_NOIN
2260: 4c 49 4e 45 20 20 5f 5f 61 74 74 72 69 62 75 74 LINE __attribut
2270: 65 5f 5f 28 28 6e 6f 69 6e 6c 69 6e 65 29 29 0a e__((noinline)).
2280: 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 5f 4d #elif defined(_M
2290: 53 43 5f 56 45 52 29 20 26 26 20 5f 4d 53 43 5f SC_VER) && _MSC_
22a0: 56 45 52 3e 3d 31 33 31 30 0a 23 20 20 64 65 66 VER>=1310.# def
22b0: 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c ine SQLITE_NOINL
22c0: 49 4e 45 20 20 5f 5f 64 65 63 6c 73 70 65 63 28 INE __declspec(
22d0: 6e 6f 69 6e 6c 69 6e 65 29 0a 23 65 6c 73 65 0a noinline).#else.
22e0: 23 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 # define SQLITE
22f0: 5f 4e 4f 49 4e 4c 49 4e 45 0a 23 65 6e 64 69 66 _NOINLINE.#endif
2300: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 ../*.** Make sur
2310: 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 70 69 e that the compi
2320: 6c 65 72 20 69 6e 74 72 69 6e 73 69 63 73 20 77 ler intrinsics w
2330: 65 20 64 65 73 69 72 65 20 61 72 65 20 65 6e 61 e desire are ena
2340: 62 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d bled when.** com
2350: 70 69 6c 69 6e 67 20 77 69 74 68 20 61 6e 20 61 piling with an a
2360: 70 70 72 6f 70 72 69 61 74 65 20 76 65 72 73 69 ppropriate versi
2370: 6f 6e 20 6f 66 20 4d 53 56 43 20 75 6e 6c 65 73 on of MSVC unles
2380: 73 20 70 72 65 76 65 6e 74 65 64 20 62 79 0a 2a s prevented by.*
2390: 2a 20 74 68 65 20 53 51 4c 49 54 45 5f 44 49 53 * the SQLITE_DIS
23a0: 41 42 4c 45 5f 49 4e 54 52 49 4e 53 49 43 20 64 ABLE_INTRINSIC d
23b0: 65 66 69 6e 65 2e 0a 2a 2f 0a 23 69 66 20 21 64 efine..*/.#if !d
23c0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 49 efined(SQLITE_DI
23d0: 53 41 42 4c 45 5f 49 4e 54 52 49 4e 53 49 43 29 SABLE_INTRINSIC)
23e0: 0a 23 20 20 69 66 20 64 65 66 69 6e 65 64 28 5f .# if defined(_
23f0: 4d 53 43 5f 56 45 52 29 20 26 26 20 5f 4d 53 43 MSC_VER) && _MSC
2400: 5f 56 45 52 3e 3d 31 34 30 30 0a 23 20 20 20 20 _VER>=1400.#
2410: 69 66 20 21 64 65 66 69 6e 65 64 28 5f 57 49 4e if !defined(_WIN
2420: 33 32 5f 57 43 45 29 0a 23 20 20 20 20 20 20 69 32_WCE).# i
2430: 6e 63 6c 75 64 65 20 3c 69 6e 74 72 69 6e 2e 68 nclude <intrin.h
2440: 3e 0a 23 20 20 20 20 20 20 70 72 61 67 6d 61 20 >.# pragma
2450: 69 6e 74 72 69 6e 73 69 63 28 5f 62 79 74 65 73 intrinsic(_bytes
2460: 77 61 70 5f 75 73 68 6f 72 74 29 0a 23 20 20 20 wap_ushort).#
2470: 20 20 20 70 72 61 67 6d 61 20 69 6e 74 72 69 6e pragma intrin
2480: 73 69 63 28 5f 62 79 74 65 73 77 61 70 5f 75 6c sic(_byteswap_ul
2490: 6f 6e 67 29 0a 23 20 20 20 20 20 20 70 72 61 67 ong).# prag
24a0: 6d 61 20 69 6e 74 72 69 6e 73 69 63 28 5f 62 79 ma intrinsic(_by
24b0: 74 65 73 77 61 70 5f 75 69 6e 74 36 34 29 0a 23 teswap_uint64).#
24c0: 20 20 20 20 20 20 70 72 61 67 6d 61 20 69 6e 74 pragma int
24d0: 72 69 6e 73 69 63 28 5f 52 65 61 64 57 72 69 74 rinsic(_ReadWrit
24e0: 65 42 61 72 72 69 65 72 29 0a 23 20 20 20 20 65 eBarrier).# e
24f0: 6c 73 65 0a 23 20 20 20 20 20 20 69 6e 63 6c 75 lse.# inclu
2500: 64 65 20 3c 63 6d 6e 69 6e 74 72 69 6e 2e 68 3e de <cmnintrin.h>
2510: 0a 23 20 20 20 20 65 6e 64 69 66 0a 23 20 20 65 .# endif.# e
2520: 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a ndif.#endif../*.
2530: 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 54 48 ** The SQLITE_TH
2540: 52 45 41 44 53 41 46 45 20 6d 61 63 72 6f 20 6d READSAFE macro m
2550: 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 61 ust be defined a
2560: 73 20 30 2c 20 31 2c 20 6f 72 20 32 2e 0a 2a 2a s 0, 1, or 2..**
2570: 20 30 20 6d 65 61 6e 73 20 6d 75 74 65 78 65 73 0 means mutexes
2580: 20 61 72 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 are permanently
2590: 20 64 69 73 61 62 6c 65 20 61 6e 64 20 74 68 65 disable and the
25a0: 20 6c 69 62 72 61 72 79 20 69 73 20 6e 65 76 65 library is neve
25b0: 72 0a 2a 2a 20 74 68 72 65 61 64 73 61 66 65 2e r.** threadsafe.
25c0: 20 20 31 20 6d 65 61 6e 73 20 74 68 65 20 6c 69 1 means the li
25d0: 62 72 61 72 79 20 69 73 20 73 65 72 69 61 6c 69 brary is seriali
25e0: 7a 65 64 20 77 68 69 63 68 20 69 73 20 74 68 65 zed which is the
25f0: 20 68 69 67 68 65 73 74 0a 2a 2a 20 6c 65 76 65 highest.** leve
2600: 6c 20 6f 66 20 74 68 72 65 61 64 73 61 66 65 74 l of threadsafet
2610: 79 2e 20 20 32 20 6d 65 61 6e 73 20 74 68 65 20 y. 2 means the
2620: 6c 69 62 72 61 72 79 20 69 73 20 6d 75 6c 74 69 library is multi
2630: 74 68 72 65 61 64 65 64 20 2d 20 6d 75 6c 74 69 threaded - multi
2640: 70 6c 65 0a 2a 2a 20 74 68 72 65 61 64 73 20 63 ple.** threads c
2650: 61 6e 20 75 73 65 20 53 51 4c 69 74 65 20 61 73 an use SQLite as
2660: 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74 77 6f 20 long as no two
2670: 74 68 72 65 61 64 73 20 74 72 79 20 74 6f 20 75 threads try to u
2680: 73 65 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 64 se the same.** d
2690: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
26a0: 6f 6e 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 on at the same t
26b0: 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 4f 6c 64 65 72 ime..**.** Older
26c0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
26d0: 69 74 65 20 75 73 65 64 20 61 6e 20 6f 70 74 69 ite used an opti
26e0: 6f 6e 61 6c 20 54 48 52 45 41 44 53 41 46 45 20 onal THREADSAFE
26f0: 6d 61 63 72 6f 2e 0a 2a 2a 20 57 65 20 73 75 70 macro..** We sup
2700: 70 6f 72 74 20 74 68 61 74 20 66 6f 72 20 6c 65 port that for le
2710: 67 61 63 79 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 65 gacy..**.** To e
2720: 6e 73 75 72 65 20 74 68 61 74 20 74 68 65 20 63 nsure that the c
2730: 6f 72 72 65 63 74 20 76 61 6c 75 65 20 6f 66 20 orrect value of
2740: 22 54 48 52 45 41 44 53 41 46 45 22 20 69 73 20 "THREADSAFE" is
2750: 72 65 70 6f 72 74 65 64 20 77 68 65 6e 20 71 75 reported when qu
2760: 65 72 79 69 6e 67 0a 2a 2a 20 66 6f 72 20 63 6f erying.** for co
2770: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f mpile-time optio
2780: 6e 73 20 61 74 20 72 75 6e 74 69 6d 65 20 28 65 ns at runtime (e
2790: 2e 67 2e 20 22 50 52 41 47 4d 41 20 63 6f 6d 70 .g. "PRAGMA comp
27a0: 69 6c 65 5f 6f 70 74 69 6f 6e 73 22 29 2c 20 74 ile_options"), t
27b0: 68 69 73 0a 2a 2a 20 6c 6f 67 69 63 20 69 73 20 his.** logic is
27c0: 70 61 72 74 69 61 6c 6c 79 20 72 65 70 6c 69 63 partially replic
27d0: 61 74 65 64 20 69 6e 20 63 74 69 6d 65 2e 63 2e ated in ctime.c.
27e0: 20 49 66 20 69 74 20 69 73 20 75 70 64 61 74 65 If it is update
27f0: 64 20 68 65 72 65 2c 20 69 74 20 73 68 6f 75 6c d here, it shoul
2800: 64 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 75 70 64 d.** also be upd
2810: 61 74 65 64 20 74 68 65 72 65 2e 0a 2a 2f 0a 23 ated there..*/.#
2820: 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
2830: 54 45 5f 54 48 52 45 41 44 53 41 46 45 29 0a 23 TE_THREADSAFE).#
2840: 20 69 66 20 64 65 66 69 6e 65 64 28 54 48 52 45 if defined(THRE
2850: 41 44 53 41 46 45 29 0a 23 20 20 20 64 65 66 69 ADSAFE).# defi
2860: 6e 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ne SQLITE_THREAD
2870: 53 41 46 45 20 54 48 52 45 41 44 53 41 46 45 0a SAFE THREADSAFE.
2880: 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 6e # else.# defin
2890: 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 e SQLITE_THREADS
28a0: 41 46 45 20 31 20 2f 2a 20 49 4d 50 3a 20 52 2d AFE 1 /* IMP: R-
28b0: 30 37 32 37 32 2d 32 32 33 30 39 20 2a 2f 0a 23 07272-22309 */.#
28c0: 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f endif.#endif../
28d0: 2a 0a 2a 2a 20 50 6f 77 65 72 73 61 66 65 20 6f *.** Powersafe o
28e0: 76 65 72 77 72 69 74 65 20 69 73 20 6f 6e 20 62 verwrite is on b
28f0: 79 20 64 65 66 61 75 6c 74 2e 20 20 42 75 74 20 y default. But
2900: 63 61 6e 20 62 65 20 74 75 72 6e 65 64 20 6f 66 can be turned of
2910: 66 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 2d f using.** the -
2920: 44 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 DSQLITE_POWERSAF
2930: 45 5f 4f 56 45 52 57 52 49 54 45 3d 30 20 63 6f E_OVERWRITE=0 co
2940: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f mmand-line optio
2950: 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 n..*/.#ifndef SQ
2960: 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f LITE_POWERSAFE_O
2970: 56 45 52 57 52 49 54 45 0a 23 20 64 65 66 69 6e VERWRITE.# defin
2980: 65 20 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 e SQLITE_POWERSA
2990: 46 45 5f 4f 56 45 52 57 52 49 54 45 20 31 0a 23 FE_OVERWRITE 1.#
29a0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 56 49 endif../*.** EVI
29b0: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 35 37 31 DENCE-OF: R-2571
29c0: 35 2d 33 37 30 37 32 20 4d 65 6d 6f 72 79 20 61 5-37072 Memory a
29d0: 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 74 69 73 llocation statis
29e0: 74 69 63 73 20 61 72 65 20 65 6e 61 62 6c 65 64 tics are enabled
29f0: 20 62 79 0a 2a 2a 20 64 65 66 61 75 6c 74 20 75 by.** default u
2a00: 6e 6c 65 73 73 20 53 51 4c 69 74 65 20 69 73 20 nless SQLite is
2a10: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 compiled with SQ
2a20: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 45 4d LITE_DEFAULT_MEM
2a30: 53 54 41 54 55 53 3d 30 20 69 6e 0a 2a 2a 20 77 STATUS=0 in.** w
2a40: 68 69 63 68 20 63 61 73 65 20 6d 65 6d 6f 72 79 hich case memory
2a50: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 74 allocation stat
2a60: 69 73 74 69 63 73 20 61 72 65 20 64 69 73 61 62 istics are disab
2a70: 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 0a led by default..
2a80: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
2a90: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
2aa0: 45 4d 53 54 41 54 55 53 29 0a 23 20 64 65 66 69 EMSTATUS).# defi
2ab0: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
2ac0: 54 5f 4d 45 4d 53 54 41 54 55 53 20 31 0a 23 65 T_MEMSTATUS 1.#e
2ad0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 61 63 ndif../*.** Exac
2ae0: 74 6c 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 tly one of the f
2af0: 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 ollowing macros
2b00: 6d 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 must be defined
2b10: 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 73 in order to.** s
2b20: 70 65 63 69 66 79 20 77 68 69 63 68 20 6d 65 6d pecify which mem
2b30: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 ory allocation s
2b40: 75 62 73 79 73 74 65 6d 20 74 6f 20 75 73 65 2e ubsystem to use.
2b50: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 .**.** SQLIT
2b60: 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 20 E_SYSTEM_MALLOC
2b70: 20 20 20 20 20 20 20 20 20 2f 2f 20 55 73 65 20 // Use
2b80: 6e 6f 72 6d 61 6c 20 73 79 73 74 65 6d 20 6d 61 normal system ma
2b90: 6c 6c 6f 63 28 29 0a 2a 2a 20 20 20 20 20 53 51 lloc().** SQ
2ba0: 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f LITE_WIN32_MALLO
2bb0: 43 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 55 C // U
2bc0: 73 65 20 57 69 6e 33 32 20 6e 61 74 69 76 65 20 se Win32 native
2bd0: 68 65 61 70 20 41 50 49 0a 2a 2a 20 20 20 20 20 heap API.**
2be0: 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c SQLITE_ZERO_MALL
2bf0: 4f 43 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f OC //
2c00: 20 55 73 65 20 61 20 73 74 75 62 20 61 6c 6c 6f Use a stub allo
2c10: 63 61 74 6f 72 20 74 68 61 74 20 61 6c 77 61 79 cator that alway
2c20: 73 20 66 61 69 6c 73 0a 2a 2a 20 20 20 20 20 53 s fails.** S
2c30: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20 20 QLITE_MEMDEBUG
2c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 //
2c50: 44 65 62 75 67 67 69 6e 67 20 76 65 72 73 69 6f Debugging versio
2c60: 6e 20 6f 66 20 73 79 73 74 65 6d 20 6d 61 6c 6c n of system mall
2c70: 6f 63 28 29 0a 2a 2a 0a 2a 2a 20 4f 6e 20 57 69 oc().**.** On Wi
2c80: 6e 64 6f 77 73 2c 20 69 66 20 74 68 65 20 53 51 ndows, if the SQ
2c90: 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f LITE_WIN32_MALLO
2ca0: 43 5f 56 41 4c 49 44 41 54 45 20 6d 61 63 72 6f C_VALIDATE macro
2cb0: 20 69 73 20 64 65 66 69 6e 65 64 20 61 6e 64 20 is defined and
2cc0: 74 68 65 0a 2a 2a 20 61 73 73 65 72 74 28 29 20 the.** assert()
2cd0: 6d 61 63 72 6f 20 69 73 20 65 6e 61 62 6c 65 64 macro is enabled
2ce0: 2c 20 65 61 63 68 20 63 61 6c 6c 20 69 6e 74 6f , each call into
2cf0: 20 74 68 65 20 57 69 6e 33 32 20 6e 61 74 69 76 the Win32 nativ
2d00: 65 20 68 65 61 70 20 73 75 62 73 79 73 74 65 6d e heap subsystem
2d10: 0a 2a 2a 20 77 69 6c 6c 20 63 61 75 73 65 20 48 .** will cause H
2d20: 65 61 70 56 61 6c 69 64 61 74 65 20 74 6f 20 62 eapValidate to b
2d30: 65 20 63 61 6c 6c 65 64 2e 20 20 49 66 20 68 65 e called. If he
2d40: 61 70 20 76 61 6c 69 64 61 74 69 6f 6e 20 73 68 ap validation sh
2d50: 6f 75 6c 64 20 66 61 69 6c 2c 20 61 6e 0a 2a 2a ould fail, an.**
2d60: 20 61 73 73 65 72 74 69 6f 6e 20 77 69 6c 6c 20 assertion will
2d70: 62 65 20 74 72 69 67 67 65 72 65 64 2e 0a 2a 2a be triggered..**
2d80: 0a 2a 2a 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 .** If none of t
2d90: 68 65 20 61 62 6f 76 65 20 61 72 65 20 64 65 66 he above are def
2da0: 69 6e 65 64 2c 20 74 68 65 6e 20 73 65 74 20 53 ined, then set S
2db0: 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c QLITE_SYSTEM_MAL
2dc0: 4c 4f 43 20 61 73 0a 2a 2a 20 74 68 65 20 64 65 LOC as.** the de
2dd0: 66 61 75 6c 74 2e 0a 2a 2f 0a 23 69 66 20 64 65 fault..*/.#if de
2de0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 53 59 53 fined(SQLITE_SYS
2df0: 54 45 4d 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 TEM_MALLOC) \.
2e00: 2b 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 + defined(SQLITE
2e10: 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 29 20 5c _WIN32_MALLOC) \
2e20: 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c . + defined(SQL
2e30: 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 29 ITE_ZERO_MALLOC)
2e40: 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 \. + defined(S
2e50: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 29 3e QLITE_MEMDEBUG)>
2e60: 31 0a 23 20 65 72 72 6f 72 20 22 54 77 6f 20 6f 1.# error "Two o
2e70: 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 66 6f r more of the fo
2e80: 6c 6c 6f 77 69 6e 67 20 63 6f 6d 70 69 6c 65 2d llowing compile-
2e90: 74 69 6d 65 20 63 6f 6e 66 69 67 75 72 61 74 69 time configurati
2ea0: 6f 6e 20 6f 70 74 69 6f 6e 73 5c 0a 20 61 72 65 on options\. are
2eb0: 20 64 65 66 69 6e 65 64 20 62 75 74 20 61 74 20 defined but at
2ec0: 6d 6f 73 74 20 6f 6e 65 20 69 73 20 61 6c 6c 6f most one is allo
2ed0: 77 65 64 3a 5c 0a 20 53 51 4c 49 54 45 5f 53 59 wed:\. SQLITE_SY
2ee0: 53 54 45 4d 5f 4d 41 4c 4c 4f 43 2c 20 53 51 4c STEM_MALLOC, SQL
2ef0: 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 ITE_WIN32_MALLOC
2f00: 2c 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 , SQLITE_MEMDEBU
2f10: 47 2c 5c 0a 20 53 51 4c 49 54 45 5f 5a 45 52 4f G,\. SQLITE_ZERO
2f20: 5f 4d 41 4c 4c 4f 43 22 0a 23 65 6e 64 69 66 0a _MALLOC".#endif.
2f30: 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
2f40: 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 TE_SYSTEM_MALLOC
2f50: 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 ) \. + defined(
2f60: 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c SQLITE_WIN32_MAL
2f70: 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e LOC) \. + defin
2f80: 65 64 28 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d ed(SQLITE_ZERO_M
2f90: 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 ALLOC) \. + def
2fa0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 45 4d 44 ined(SQLITE_MEMD
2fb0: 45 42 55 47 29 3d 3d 30 0a 23 20 64 65 66 69 6e EBUG)==0.# defin
2fc0: 65 20 53 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f e SQLITE_SYSTEM_
2fd0: 4d 41 4c 4c 4f 43 20 31 0a 23 65 6e 64 69 66 0a MALLOC 1.#endif.
2fe0: 0a 2f 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 ./*.** If SQLITE
2ff0: 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d _MALLOC_SOFT_LIM
3000: 49 54 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c 20 IT is not zero,
3010: 74 68 65 6e 20 74 72 79 20 74 6f 20 6b 65 65 70 then try to keep
3020: 20 74 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f 66 the.** sizes of
3030: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
3040: 6f 6e 73 20 62 65 6c 6f 77 20 74 68 69 73 20 76 ons below this v
3050: 61 6c 75 65 20 77 68 65 72 65 20 70 6f 73 73 69 alue where possi
3060: 62 6c 65 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 ble..*/.#if !def
3070: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 41 4c 4c ined(SQLITE_MALL
3080: 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 29 0a 23 OC_SOFT_LIMIT).#
3090: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d define SQLITE_M
30a0: 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 ALLOC_SOFT_LIMIT
30b0: 20 31 30 32 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 1024.#endif../*
30c0: 0a 2a 2a 20 57 65 20 6e 65 65 64 20 74 6f 20 64 .** We need to d
30d0: 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f 53 4f 55 efine _XOPEN_SOU
30e0: 52 43 45 20 61 73 20 66 6f 6c 6c 6f 77 73 20 69 RCE as follows i
30f0: 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 61 62 6c n order to enabl
3100: 65 0a 2a 2a 20 72 65 63 75 72 73 69 76 65 20 6d e.** recursive m
3110: 75 74 65 78 65 73 20 6f 6e 20 6d 6f 73 74 20 55 utexes on most U
3120: 6e 69 78 20 73 79 73 74 65 6d 73 20 61 6e 64 20 nix systems and
3130: 66 63 68 6d 6f 64 28 29 20 6f 6e 20 4f 70 65 6e fchmod() on Open
3140: 42 53 44 2e 0a 2a 2a 20 42 75 74 20 5f 58 4f 50 BSD..** But _XOP
3150: 45 4e 5f 53 4f 55 52 43 45 20 64 65 66 69 6e 65 EN_SOURCE define
3160: 20 63 61 75 73 65 73 20 70 72 6f 62 6c 65 6d 73 causes problems
3170: 20 66 6f 72 20 4d 61 63 20 4f 53 20 58 2c 20 73 for Mac OS X, s
3180: 6f 20 6f 6d 69 74 0a 2a 2a 20 69 74 2e 0a 2a 2f o omit.** it..*/
3190: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 5f 58 .#if !defined(_X
31a0: 4f 50 45 4e 5f 53 4f 55 52 43 45 29 20 26 26 20 OPEN_SOURCE) &&
31b0: 21 64 65 66 69 6e 65 64 28 5f 5f 44 41 52 57 49 !defined(__DARWI
31c0: 4e 5f 5f 29 20 26 26 20 21 64 65 66 69 6e 65 64 N__) && !defined
31d0: 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 23 20 20 64 (__APPLE__).# d
31e0: 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f 53 4f 55 efine _XOPEN_SOU
31f0: 52 43 45 20 36 30 30 0a 23 65 6e 64 69 66 0a 0a RCE 600.#endif..
3200: 2f 2a 0a 2a 2a 20 4e 44 45 42 55 47 20 61 6e 64 /*.** NDEBUG and
3210: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 61 72 SQLITE_DEBUG ar
3220: 65 20 6f 70 70 6f 73 69 74 65 73 2e 20 20 49 74 e opposites. It
3230: 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 should always b
3240: 65 20 74 72 75 65 20 74 68 61 74 0a 2a 2a 20 64 e true that.** d
3250: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 3d 3d efined(NDEBUG)==
3260: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
3270: 44 45 42 55 47 29 2e 20 20 49 66 20 74 68 69 73 DEBUG). If this
3280: 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c is not currentl
3290: 79 20 74 72 75 65 2c 0a 2a 2a 20 6d 61 6b 65 20 y true,.** make
32a0: 69 74 20 74 72 75 65 20 62 79 20 64 65 66 69 6e it true by defin
32b0: 69 6e 67 20 6f 72 20 75 6e 64 65 66 69 6e 69 6e ing or undefinin
32c0: 67 20 4e 44 45 42 55 47 2e 0a 2a 2a 0a 2a 2a 20 g NDEBUG..**.**
32d0: 53 65 74 74 69 6e 67 20 4e 44 45 42 55 47 20 6d Setting NDEBUG m
32e0: 61 6b 65 73 20 74 68 65 20 63 6f 64 65 20 73 6d akes the code sm
32f0: 61 6c 6c 65 72 20 61 6e 64 20 66 61 73 74 65 72 aller and faster
3300: 20 62 79 20 64 69 73 61 62 6c 69 6e 67 20 74 68 by disabling th
3310: 65 0a 2a 2a 20 61 73 73 65 72 74 28 29 20 73 74 e.** assert() st
3320: 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 atements in the
3330: 63 6f 64 65 2e 20 20 53 6f 20 77 65 20 77 61 6e code. So we wan
3340: 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 t the default ac
3350: 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 20 66 6f tion.** to be fo
3360: 72 20 4e 44 45 42 55 47 20 74 6f 20 62 65 20 73 r NDEBUG to be s
3370: 65 74 20 61 6e 64 20 4e 44 45 42 55 47 20 74 6f et and NDEBUG to
3380: 20 62 65 20 75 6e 64 65 66 69 6e 65 64 20 6f 6e be undefined on
3390: 6c 79 20 69 66 20 53 51 4c 49 54 45 5f 44 45 42 ly if SQLITE_DEB
33a0: 55 47 0a 2a 2a 20 69 73 20 73 65 74 2e 20 20 54 UG.** is set. T
33b0: 68 75 73 20 4e 44 45 42 55 47 20 62 65 63 6f 6d hus NDEBUG becom
33c0: 65 73 20 61 6e 20 6f 70 74 2d 69 6e 20 72 61 74 es an opt-in rat
33d0: 68 65 72 20 74 68 61 6e 20 61 6e 20 6f 70 74 2d her than an opt-
33e0: 6f 75 74 0a 2a 2a 20 66 65 61 74 75 72 65 2e 0a out.** feature..
33f0: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
3400: 4e 44 45 42 55 47 29 20 26 26 20 21 64 65 66 69 NDEBUG) && !defi
3410: 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
3420: 29 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 42 55 ).# define NDEBU
3430: 47 20 31 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 G 1.#endif.#if d
3440: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 20 26 efined(NDEBUG) &
3450: 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 & defined(SQLITE
3460: 5f 44 45 42 55 47 29 0a 23 20 75 6e 64 65 66 20 _DEBUG).# undef
3470: 4e 44 45 42 55 47 0a 23 65 6e 64 69 66 0a 0a 2f NDEBUG.#endif../
3480: 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 53 51 4c 49 *.** Enable SQLI
3490: 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 TE_ENABLE_EXPLAI
34a0: 4e 5f 43 4f 4d 4d 45 4e 54 53 20 69 66 20 53 51 N_COMMENTS if SQ
34b0: 4c 49 54 45 5f 44 45 42 55 47 20 69 73 20 74 75 LITE_DEBUG is tu
34c0: 72 6e 65 64 20 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 rned on..*/.#if
34d0: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
34e0: 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 ENABLE_EXPLAIN_C
34f0: 4f 4d 4d 45 4e 54 53 29 20 26 26 20 64 65 66 69 OMMENTS) && defi
3500: 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
3510: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
3520: 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e E_ENABLE_EXPLAIN
3530: 5f 43 4f 4d 4d 45 4e 54 53 20 31 0a 23 65 6e 64 _COMMENTS 1.#end
3540: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 74 65 if../*.** The te
3550: 73 74 63 61 73 65 28 29 20 6d 61 63 72 6f 20 69 stcase() macro i
3560: 73 20 75 73 65 64 20 74 6f 20 61 69 64 20 69 6e s used to aid in
3570: 20 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 6e coverage testin
3580: 67 2e 20 20 57 68 65 6e 0a 2a 2a 20 64 6f 69 6e g. When.** doin
3590: 67 20 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 g coverage testi
35a0: 6e 67 2c 20 74 68 65 20 63 6f 6e 64 69 74 69 6f ng, the conditio
35b0: 6e 20 69 6e 73 69 64 65 20 74 68 65 20 61 72 67 n inside the arg
35c0: 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 65 73 74 ument to.** test
35d0: 63 61 73 65 28 29 20 6d 75 73 74 20 62 65 20 65 case() must be e
35e0: 76 61 6c 75 61 74 65 64 20 62 6f 74 68 20 74 72 valuated both tr
35f0: 75 65 20 61 6e 64 20 66 61 6c 73 65 20 69 6e 20 ue and false in
3600: 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 67 65 74 20 order to.** get
3610: 66 75 6c 6c 20 62 72 61 6e 63 68 20 63 6f 76 65 full branch cove
3620: 72 61 67 65 2e 20 20 54 68 65 20 74 65 73 74 63 rage. The testc
3630: 61 73 65 28 29 20 6d 61 63 72 6f 20 69 73 20 69 ase() macro is i
3640: 6e 73 65 72 74 65 64 0a 2a 2a 20 74 6f 20 68 65 nserted.** to he
3650: 6c 70 20 65 6e 73 75 72 65 20 61 64 65 71 75 61 lp ensure adequa
3660: 74 65 20 74 65 73 74 20 63 6f 76 65 72 61 67 65 te test coverage
3670: 20 69 6e 20 70 6c 61 63 65 73 20 77 68 65 72 65 in places where
3680: 20 73 69 6d 70 6c 65 0a 2a 2a 20 63 6f 6e 64 69 simple.** condi
3690: 74 69 6f 6e 2f 64 65 63 69 73 69 6f 6e 20 63 6f tion/decision co
36a0: 76 65 72 61 67 65 20 69 73 20 69 6e 61 64 65 71 verage is inadeq
36b0: 75 61 74 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 uate. For examp
36c0: 6c 65 2c 20 74 65 73 74 63 61 73 65 28 29 0a 2a le, testcase().*
36d0: 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f * can be used to
36e0: 20 6d 61 6b 65 20 73 75 72 65 20 62 6f 75 6e 64 make sure bound
36f0: 61 72 79 20 76 61 6c 75 65 73 20 61 72 65 20 74 ary values are t
3700: 65 73 74 65 64 2e 20 20 46 6f 72 0a 2a 2a 20 62 ested. For.** b
3710: 69 74 6d 61 73 6b 20 74 65 73 74 73 2c 20 74 65 itmask tests, te
3720: 73 74 63 61 73 65 28 29 20 63 61 6e 20 62 65 20 stcase() can be
3730: 75 73 65 64 20 74 6f 20 6d 61 6b 65 20 73 75 72 used to make sur
3740: 65 20 65 61 63 68 20 62 69 74 0a 2a 2a 20 69 73 e each bit.** is
3750: 20 73 69 67 6e 69 66 69 63 61 6e 74 20 61 6e 64 significant and
3760: 20 75 73 65 64 20 61 74 20 6c 65 61 73 74 20 6f used at least o
3770: 6e 63 65 2e 20 20 4f 6e 20 73 77 69 74 63 68 20 nce. On switch
3780: 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 77 68 statements.** wh
3790: 65 72 65 20 6d 75 6c 74 69 70 6c 65 20 63 61 73 ere multiple cas
37a0: 65 73 20 67 6f 20 74 6f 20 74 68 65 20 73 61 6d es go to the sam
37b0: 65 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 2c e block of code,
37c0: 20 74 65 73 74 63 61 73 65 28 29 0a 2a 2a 20 63 testcase().** c
37d0: 61 6e 20 69 6e 73 75 72 65 20 74 68 61 74 20 61 an insure that a
37e0: 6c 6c 20 63 61 73 65 73 20 61 72 65 20 65 76 61 ll cases are eva
37f0: 6c 75 61 74 65 64 2e 0a 2a 2a 0a 2a 2f 0a 23 69 luated..**.*/.#i
3800: 66 64 65 66 20 53 51 4c 49 54 45 5f 43 4f 56 45 fdef SQLITE_COVE
3810: 52 41 47 45 5f 54 45 53 54 0a 20 20 76 6f 69 64 RAGE_TEST. void
3820: 20 73 71 6c 69 74 65 33 43 6f 76 65 72 61 67 65 sqlite3Coverage
3830: 28 69 6e 74 29 3b 0a 23 20 64 65 66 69 6e 65 20 (int);.# define
3840: 74 65 73 74 63 61 73 65 28 58 29 20 20 69 66 28 testcase(X) if(
3850: 20 58 20 29 7b 20 73 71 6c 69 74 65 33 43 6f 76 X ){ sqlite3Cov
3860: 65 72 61 67 65 28 5f 5f 4c 49 4e 45 5f 5f 29 3b erage(__LINE__);
3870: 20 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e }.#else.# defin
3880: 65 20 74 65 73 74 63 61 73 65 28 58 29 0a 23 65 e testcase(X).#e
3890: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
38a0: 54 45 53 54 4f 4e 4c 59 20 6d 61 63 72 6f 20 69 TESTONLY macro i
38b0: 73 20 75 73 65 64 20 74 6f 20 65 6e 63 6c 6f 73 s used to enclos
38c0: 65 20 76 61 72 69 61 62 6c 65 20 64 65 63 6c 61 e variable decla
38d0: 72 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 6f 74 rations or.** ot
38e0: 68 65 72 20 62 69 74 73 20 6f 66 20 63 6f 64 65 her bits of code
38f0: 20 74 68 61 74 20 61 72 65 20 6e 65 65 64 65 64 that are needed
3900: 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 20 to support the
3910: 61 72 67 75 6d 65 6e 74 73 0a 2a 2a 20 77 69 74 arguments.** wit
3920: 68 69 6e 20 74 65 73 74 63 61 73 65 28 29 20 61 hin testcase() a
3930: 6e 64 20 61 73 73 65 72 74 28 29 20 6d 61 63 72 nd assert() macr
3940: 6f 73 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 os..*/.#if !defi
3950: 6e 65 64 28 4e 44 45 42 55 47 29 20 7c 7c 20 64 ned(NDEBUG) || d
3960: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 43 4f efined(SQLITE_CO
3970: 56 45 52 41 47 45 5f 54 45 53 54 29 0a 23 20 64 VERAGE_TEST).# d
3980: 65 66 69 6e 65 20 54 45 53 54 4f 4e 4c 59 28 58 efine TESTONLY(X
3990: 29 20 20 58 0a 23 65 6c 73 65 0a 23 20 64 65 66 ) X.#else.# def
39a0: 69 6e 65 20 54 45 53 54 4f 4e 4c 59 28 58 29 0a ine TESTONLY(X).
39b0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6f #endif../*.** So
39c0: 6d 65 74 69 6d 65 73 20 77 65 20 6e 65 65 64 20 metimes we need
39d0: 61 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e 74 20 6f a small amount o
39e0: 66 20 63 6f 64 65 20 73 75 63 68 20 61 73 20 61 f code such as a
39f0: 20 76 61 72 69 61 62 6c 65 20 69 6e 69 74 69 61 variable initia
3a00: 6c 69 7a 61 74 69 6f 6e 0a 2a 2a 20 74 6f 20 73 lization.** to s
3a10: 65 74 75 70 20 66 6f 72 20 61 20 6c 61 74 65 72 etup for a later
3a20: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
3a30: 65 6e 74 2e 20 20 57 65 20 64 6f 20 6e 6f 74 20 ent. We do not
3a40: 77 61 6e 74 20 74 68 69 73 20 63 6f 64 65 20 74 want this code t
3a50: 6f 0a 2a 2a 20 61 70 70 65 61 72 20 77 68 65 6e o.** appear when
3a60: 20 61 73 73 65 72 74 28 29 20 69 73 20 64 69 73 assert() is dis
3a70: 61 62 6c 65 64 2e 20 20 54 68 65 20 66 6f 6c 6c abled. The foll
3a80: 6f 77 69 6e 67 20 6d 61 63 72 6f 20 69 73 20 74 owing macro is t
3a90: 68 65 72 65 66 6f 72 65 0a 2a 2a 20 75 73 65 64 herefore.** used
3aa0: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 74 68 61 74 to contain that
3ab0: 20 73 65 74 75 70 20 63 6f 64 65 2e 20 20 54 68 setup code. Th
3ac0: 65 20 22 56 56 41 22 20 61 63 72 6f 6e 79 6d 20 e "VVA" acronym
3ad0: 73 74 61 6e 64 73 20 66 6f 72 0a 2a 2a 20 22 56 stands for.** "V
3ae0: 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 56 61 6c erification, Val
3af0: 69 64 61 74 69 6f 6e 2c 20 61 6e 64 20 41 63 63 idation, and Acc
3b00: 72 65 64 69 74 61 74 69 6f 6e 22 2e 20 20 49 6e reditation". In
3b10: 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 74 68 other words, th
3b20: 65 0a 2a 2a 20 63 6f 64 65 20 77 69 74 68 69 6e e.** code within
3b30: 20 56 56 41 5f 4f 4e 4c 59 28 29 20 77 69 6c 6c VVA_ONLY() will
3b40: 20 6f 6e 6c 79 20 72 75 6e 20 64 75 72 69 6e 67 only run during
3b50: 20 76 65 72 69 66 69 63 61 74 69 6f 6e 20 70 72 verification pr
3b60: 6f 63 65 73 73 65 73 2e 0a 2a 2f 0a 23 69 66 6e ocesses..*/.#ifn
3b70: 64 65 66 20 4e 44 45 42 55 47 0a 23 20 64 65 66 def NDEBUG.# def
3b80: 69 6e 65 20 56 56 41 5f 4f 4e 4c 59 28 58 29 20 ine VVA_ONLY(X)
3b90: 20 58 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e X.#else.# defin
3ba0: 65 20 56 56 41 5f 4f 4e 4c 59 28 58 29 0a 23 65 e VVA_ONLY(X).#e
3bb0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
3bc0: 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 56 45 52 ALWAYS and NEVER
3bd0: 20 6d 61 63 72 6f 73 20 73 75 72 72 6f 75 6e 64 macros surround
3be0: 20 62 6f 6f 6c 65 61 6e 20 65 78 70 72 65 73 73 boolean express
3bf0: 69 6f 6e 73 20 77 68 69 63 68 0a 2a 2a 20 61 72 ions which.** ar
3c00: 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 61 6c e intended to al
3c10: 77 61 79 73 20 62 65 20 74 72 75 65 20 6f 72 20 ways be true or
3c20: 66 61 6c 73 65 2c 20 72 65 73 70 65 63 74 69 76 false, respectiv
3c30: 65 6c 79 2e 20 20 53 75 63 68 0a 2a 2a 20 65 78 ely. Such.** ex
3c40: 70 72 65 73 73 69 6f 6e 73 20 63 6f 75 6c 64 20 pressions could
3c50: 62 65 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 be omitted from
3c60: 74 68 65 20 63 6f 64 65 20 63 6f 6d 70 6c 65 74 the code complet
3c70: 65 6c 79 2e 20 20 42 75 74 20 74 68 65 79 0a 2a ely. But they.*
3c80: 2a 20 61 72 65 20 69 6e 63 6c 75 64 65 64 20 69 * are included i
3c90: 6e 20 61 20 66 65 77 20 63 61 73 65 73 20 69 6e n a few cases in
3ca0: 20 6f 72 64 65 72 20 74 6f 20 65 6e 68 61 6e 63 order to enhanc
3cb0: 65 20 74 68 65 20 72 65 73 69 6c 69 65 6e 63 65 e the resilience
3cc0: 0a 2a 2a 20 6f 66 20 53 51 4c 69 74 65 20 74 6f .** of SQLite to
3cd0: 20 75 6e 65 78 70 65 63 74 65 64 20 62 65 68 61 unexpected beha
3ce0: 76 69 6f 72 20 2d 20 74 6f 20 6d 61 6b 65 20 74 vior - to make t
3cf0: 68 65 20 63 6f 64 65 20 22 73 65 6c 66 2d 68 65 he code "self-he
3d00: 61 6c 69 6e 67 22 0a 2a 2a 20 6f 72 20 22 64 75 aling".** or "du
3d10: 63 74 69 6c 65 22 20 72 61 74 68 65 72 20 74 68 ctile" rather th
3d20: 61 6e 20 62 65 69 6e 67 20 22 62 72 69 74 74 6c an being "brittl
3d30: 65 22 20 61 6e 64 20 63 72 61 73 68 69 6e 67 20 e" and crashing
3d40: 61 74 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 at the first.**
3d50: 68 69 6e 74 20 6f 66 20 75 6e 70 6c 61 6e 6e 65 hint of unplanne
3d60: 64 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2a 0a 2a d behavior..**.*
3d70: 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 * In other words
3d80: 2c 20 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 56 , ALWAYS and NEV
3d90: 45 52 20 61 72 65 20 61 64 64 65 64 20 66 6f 72 ER are added for
3da0: 20 64 65 66 65 6e 73 69 76 65 20 63 6f 64 65 2e defensive code.
3db0: 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 64 6f 69 6e .**.** When doin
3dc0: 67 20 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 g coverage testi
3dd0: 6e 67 20 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 ng ALWAYS and NE
3de0: 56 45 52 20 61 72 65 20 68 61 72 64 2d 63 6f 64 VER are hard-cod
3df0: 65 64 20 74 6f 0a 2a 2a 20 62 65 20 74 72 75 65 ed to.** be true
3e00: 20 61 6e 64 20 66 61 6c 73 65 20 73 6f 20 74 68 and false so th
3e10: 61 74 20 74 68 65 20 75 6e 72 65 61 63 68 61 62 at the unreachab
3e20: 6c 65 20 63 6f 64 65 20 74 68 65 79 20 73 70 65 le code they spe
3e30: 63 69 66 79 20 77 69 6c 6c 0a 2a 2a 20 6e 6f 74 cify will.** not
3e40: 20 62 65 20 63 6f 75 6e 74 65 64 20 61 73 20 75 be counted as u
3e50: 6e 74 65 73 74 65 64 20 63 6f 64 65 2e 0a 2a 2f ntested code..*/
3e60: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
3e70: 49 54 45 5f 43 4f 56 45 52 41 47 45 5f 54 45 53 ITE_COVERAGE_TES
3e80: 54 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 T) || defined(SQ
3e90: 4c 49 54 45 5f 4d 55 54 41 54 49 4f 4e 5f 54 45 LITE_MUTATION_TE
3ea0: 53 54 29 0a 23 20 64 65 66 69 6e 65 20 41 4c 57 ST).# define ALW
3eb0: 41 59 53 28 58 29 20 20 20 20 20 20 28 31 29 0a AYS(X) (1).
3ec0: 23 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 58 # define NEVER(X
3ed0: 29 20 20 20 20 20 20 20 28 30 29 0a 23 65 6c 69 ) (0).#eli
3ee0: 66 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 f !defined(NDEBU
3ef0: 47 29 0a 23 20 64 65 66 69 6e 65 20 41 4c 57 41 G).# define ALWA
3f00: 59 53 28 58 29 20 20 20 20 20 20 28 28 58 29 3f YS(X) ((X)?
3f10: 31 3a 28 61 73 73 65 72 74 28 30 29 2c 30 29 29 1:(assert(0),0))
3f20: 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 .# define NEVER(
3f30: 58 29 20 20 20 20 20 20 20 28 28 58 29 3f 28 61 X) ((X)?(a
3f40: 73 73 65 72 74 28 30 29 2c 31 29 3a 30 29 0a 23 ssert(0),1):0).#
3f50: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 41 4c else.# define AL
3f60: 57 41 59 53 28 58 29 20 20 20 20 20 20 28 58 29 WAYS(X) (X)
3f70: 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 .# define NEVER(
3f80: 58 29 20 20 20 20 20 20 20 28 58 29 0a 23 65 6e X) (X).#en
3f90: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 20 dif../*.** Some
3fa0: 63 6f 6e 64 69 74 69 6f 6e 61 6c 73 20 61 72 65 conditionals are
3fb0: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 6f optimizations o
3fc0: 6e 6c 79 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 nly. In other w
3fd0: 6f 72 64 73 2c 20 69 66 20 74 68 65 0a 2a 2a 20 ords, if the.**
3fe0: 63 6f 6e 64 69 74 69 6f 6e 61 6c 73 20 61 72 65 conditionals are
3ff0: 20 72 65 70 6c 61 63 65 64 20 77 69 74 68 20 61 replaced with a
4000: 20 63 6f 6e 73 74 61 6e 74 20 31 20 28 74 72 75 constant 1 (tru
4010: 65 29 20 6f 72 20 30 20 28 66 61 6c 73 65 29 20 e) or 0 (false)
4020: 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 6f 72 72 then.** the corr
4030: 65 63 74 20 61 6e 73 77 65 72 20 69 73 20 73 74 ect answer is st
4040: 69 6c 6c 20 6f 62 74 61 69 6e 65 64 2c 20 74 68 ill obtained, th
4050: 6f 75 67 68 20 70 65 72 68 61 70 73 20 6e 6f 74 ough perhaps not
4060: 20 61 73 20 71 75 69 63 6b 6c 79 2e 0a 2a 2a 0a as quickly..**.
4070: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
4080: 20 6d 61 63 72 6f 73 20 6d 61 72 6b 20 74 68 65 macros mark the
4090: 73 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 se optimizations
40a0: 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 73 2e 0a 2a conditionals..*
40b0: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 /.#if defined(SQ
40c0: 4c 49 54 45 5f 4d 55 54 41 54 49 4f 4e 5f 54 45 LITE_MUTATION_TE
40d0: 53 54 29 0a 23 20 64 65 66 69 6e 65 20 4f 4b 5f ST).# define OK_
40e0: 49 46 5f 41 4c 57 41 59 53 5f 54 52 55 45 28 58 IF_ALWAYS_TRUE(X
40f0: 29 20 20 28 31 29 0a 23 20 64 65 66 69 6e 65 20 ) (1).# define
4100: 4f 4b 5f 49 46 5f 41 4c 57 41 59 53 5f 46 41 4c OK_IF_ALWAYS_FAL
4110: 53 45 28 58 29 20 28 30 29 0a 23 65 6c 73 65 0a SE(X) (0).#else.
4120: 23 20 64 65 66 69 6e 65 20 4f 4b 5f 49 46 5f 41 # define OK_IF_A
4130: 4c 57 41 59 53 5f 54 52 55 45 28 58 29 20 20 28 LWAYS_TRUE(X) (
4140: 58 29 0a 23 20 64 65 66 69 6e 65 20 4f 4b 5f 49 X).# define OK_I
4150: 46 5f 41 4c 57 41 59 53 5f 46 41 4c 53 45 28 58 F_ALWAYS_FALSE(X
4160: 29 20 28 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a ) (X).#endif../*
4170: 0a 2a 2a 20 53 6f 6d 65 20 6d 61 6c 6c 6f 63 20 .** Some malloc
4180: 66 61 69 6c 75 72 65 73 20 61 72 65 20 6f 6e 6c failures are onl
4190: 79 20 70 6f 73 73 69 62 6c 65 20 69 66 20 53 51 y possible if SQ
41a0: 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 4c 4c 4f LITE_TEST_REALLO
41b0: 43 5f 53 54 52 45 53 53 20 69 73 0a 2a 2a 20 64 C_STRESS is.** d
41c0: 65 66 69 6e 65 64 2e 20 20 57 65 20 6e 65 65 64 efined. We need
41d0: 20 74 6f 20 64 65 66 65 6e 64 20 61 67 61 69 6e to defend again
41e0: 73 74 20 74 68 6f 73 65 20 66 61 69 6c 75 72 65 st those failure
41f0: 73 20 77 68 65 6e 20 74 65 73 74 69 6e 67 20 77 s when testing w
4200: 69 74 68 0a 2a 2a 20 53 51 4c 49 54 45 5f 54 45 ith.** SQLITE_TE
4210: 53 54 5f 52 45 41 4c 4c 4f 43 5f 53 54 52 45 53 ST_REALLOC_STRES
4220: 53 2c 20 62 75 74 20 77 65 20 64 6f 6e 27 74 20 S, but we don't
4230: 77 61 6e 74 20 74 68 65 20 75 6e 72 65 61 63 68 want the unreach
4240: 61 62 6c 65 20 62 72 61 6e 63 68 65 73 0a 2a 2a able branches.**
4250: 20 64 75 72 69 6e 67 20 61 20 6e 6f 72 6d 61 6c during a normal
4260: 20 62 75 69 6c 64 2e 20 20 54 68 65 20 66 6f 6c build. The fol
4270: 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 63 61 6e lowing macro can
4280: 20 62 65 20 75 73 65 64 20 74 6f 20 64 69 73 61 be used to disa
4290: 62 6c 65 20 74 65 73 74 73 0a 2a 2a 20 74 68 61 ble tests.** tha
42a0: 74 20 61 72 65 20 61 6c 77 61 79 73 20 66 61 6c t are always fal
42b0: 73 65 20 65 78 63 65 70 74 20 77 68 65 6e 20 53 se except when S
42c0: 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 4c 4c QLITE_TEST_REALL
42d0: 4f 43 5f 53 54 52 45 53 53 20 69 73 20 73 65 74 OC_STRESS is set
42e0: 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 ..*/.#if defined
42f0: 28 53 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 (SQLITE_TEST_REA
4300: 4c 4c 4f 43 5f 53 54 52 45 53 53 29 0a 23 20 64 LLOC_STRESS).# d
4310: 65 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 efine ONLY_IF_RE
4320: 41 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 ALLOC_STRESS(X)
4330: 20 28 58 29 0a 23 65 6c 69 66 20 21 64 65 66 69 (X).#elif !defi
4340: 6e 65 64 28 4e 44 45 42 55 47 29 0a 23 20 64 65 ned(NDEBUG).# de
4350: 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 41 fine ONLY_IF_REA
4360: 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 20 LLOC_STRESS(X)
4370: 28 28 58 29 3f 28 61 73 73 65 72 74 28 30 29 2c ((X)?(assert(0),
4380: 31 29 3a 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 1):0).#else.# de
4390: 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 41 fine ONLY_IF_REA
43a0: 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 20 LLOC_STRESS(X)
43b0: 28 30 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a (0).#endif../*.*
43c0: 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e 73 20 75 * Declarations u
43d0: 73 65 64 20 66 6f 72 20 74 72 61 63 69 6e 67 20 sed for tracing
43e0: 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 the operating sy
43f0: 73 74 65 6d 20 69 6e 74 65 72 66 61 63 65 73 2e stem interfaces.
4400: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
4410: 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 4f 53 5f SQLITE_FORCE_OS_
4420: 54 52 41 43 45 29 20 7c 7c 20 64 65 66 69 6e 65 TRACE) || define
4430: 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c d(SQLITE_TEST) |
4440: 7c 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 | \. (defined
4450: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 (SQLITE_DEBUG) &
4460: 26 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 & SQLITE_OS_WIN)
4470: 0a 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 . extern int sq
4480: 6c 69 74 65 33 4f 53 54 72 61 63 65 3b 0a 23 20 lite3OSTrace;.#
4490: 64 65 66 69 6e 65 20 4f 53 54 52 41 43 45 28 58 define OSTRACE(X
44a0: 29 20 20 20 20 20 20 20 20 20 20 69 66 28 20 73 ) if( s
44b0: 71 6c 69 74 65 33 4f 53 54 72 61 63 65 20 29 20 qlite3OSTrace )
44c0: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
44d0: 74 66 20 58 0a 23 20 64 65 66 69 6e 65 20 53 51 tf X.# define SQ
44e0: 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 41 LITE_HAVE_OS_TRA
44f0: 43 45 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e CE.#else.# defin
4500: 65 20 4f 53 54 52 41 43 45 28 58 29 0a 23 20 75 e OSTRACE(X).# u
4510: 6e 64 65 66 20 20 53 51 4c 49 54 45 5f 48 41 56 ndef SQLITE_HAV
4520: 45 5f 4f 53 5f 54 52 41 43 45 0a 23 65 6e 64 69 E_OS_TRACE.#endi
4530: 66 0a 0a 2f 2a 0a 2a 2a 20 49 73 20 74 68 65 20 f../*.** Is the
4540: 73 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 29 sqlite3ErrName()
4550: 20 66 75 6e 63 74 69 6f 6e 20 6e 65 65 64 65 64 function needed
4560: 20 69 6e 20 74 68 65 20 62 75 69 6c 64 3f 20 20 in the build?
4570: 43 75 72 72 65 6e 74 6c 79 2c 0a 2a 2a 20 69 74 Currently,.** it
4580: 20 69 73 20 6e 65 65 64 65 64 20 62 79 20 22 6d is needed by "m
4590: 75 74 65 78 5f 77 33 32 2e 63 22 20 28 77 68 65 utex_w32.c" (whe
45a0: 6e 20 64 65 62 75 67 67 69 6e 67 29 2c 20 22 6f n debugging), "o
45b0: 73 5f 77 69 6e 2e 63 22 20 28 77 68 65 6e 0a 2a s_win.c" (when.*
45c0: 2a 20 4f 53 54 52 41 43 45 20 69 73 20 65 6e 61 * OSTRACE is ena
45d0: 62 6c 65 64 29 2c 20 61 6e 64 20 62 79 20 73 65 bled), and by se
45e0: 76 65 72 61 6c 20 22 74 65 73 74 2a 2e 63 22 20 veral "test*.c"
45f0: 66 69 6c 65 73 20 28 77 68 69 63 68 20 61 72 65 files (which are
4600: 0a 2a 2a 20 63 6f 6d 70 69 6c 65 64 20 75 73 69 .** compiled usi
4610: 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 54 29 2e ng SQLITE_TEST).
4620: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
4630: 53 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 SQLITE_HAVE_OS_T
4640: 52 41 43 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 RACE) || defined
4650: 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c 7c (SQLITE_TEST) ||
4660: 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 28 \. (defined(
4670: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 26 SQLITE_DEBUG) &&
4680: 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 0a SQLITE_OS_WIN).
4690: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
46a0: 4e 45 45 44 5f 45 52 52 5f 4e 41 4d 45 0a 23 65 NEED_ERR_NAME.#e
46b0: 6c 73 65 0a 23 20 75 6e 64 65 66 20 20 53 51 4c lse.# undef SQL
46c0: 49 54 45 5f 4e 45 45 44 5f 45 52 52 5f 4e 41 4d ITE_NEED_ERR_NAM
46d0: 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 E.#endif../*.**
46e0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 SQLITE_ENABLE_EX
46f0: 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 20 69 PLAIN_COMMENTS i
4700: 73 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 77 s incompatible w
4710: 69 74 68 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ith SQLITE_OMIT_
4720: 45 58 50 4c 41 49 4e 0a 2a 2f 0a 23 69 66 64 65 EXPLAIN.*/.#ifde
4730: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 f SQLITE_OMIT_EX
4740: 50 4c 41 49 4e 0a 23 20 75 6e 64 65 66 20 53 51 PLAIN.# undef SQ
4750: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c LITE_ENABLE_EXPL
4760: 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 0a 23 65 6e AIN_COMMENTS.#en
4770: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 dif../*.** Retur
4780: 6e 20 74 72 75 65 20 28 6e 6f 6e 2d 7a 65 72 6f n true (non-zero
4790: 29 20 69 66 20 74 68 65 20 69 6e 70 75 74 20 69 ) if the input i
47a0: 73 20 61 6e 20 69 6e 74 65 67 65 72 20 74 68 61 s an integer tha
47b0: 74 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 0a 2a t is too large.*
47c0: 2a 20 74 6f 20 66 69 74 20 69 6e 20 33 32 2d 62 * to fit in 32-b
47d0: 69 74 73 2e 20 20 54 68 69 73 20 6d 61 63 72 6f its. This macro
47e0: 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 is used inside
47f0: 6f 66 20 76 61 72 69 6f 75 73 20 74 65 73 74 63 of various testc
4800: 61 73 65 28 29 0a 2a 2a 20 6d 61 63 72 6f 73 20 ase().** macros
4810: 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 77 to verify that w
4820: 65 20 68 61 76 65 20 74 65 73 74 65 64 20 53 51 e have tested SQ
4830: 4c 69 74 65 20 66 6f 72 20 6c 61 72 67 65 2d 66 Lite for large-f
4840: 69 6c 65 20 73 75 70 70 6f 72 74 2e 0a 2a 2f 0a ile support..*/.
4850: 23 64 65 66 69 6e 65 20 49 53 5f 42 49 47 5f 49 #define IS_BIG_I
4860: 4e 54 28 58 29 20 20 28 28 28 58 29 26 7e 28 69 NT(X) (((X)&~(i
4870: 36 34 29 30 78 66 66 66 66 66 66 66 66 29 21 3d 64)0xffffffff)!=
4880: 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6d 61 0)../*.** The ma
4890: 63 72 6f 20 75 6e 6c 69 6b 65 6c 79 28 29 20 69 cro unlikely() i
48a0: 73 20 61 20 68 69 6e 74 20 74 68 61 74 20 73 75 s a hint that su
48b0: 72 72 6f 75 6e 64 73 20 61 20 62 6f 6f 6c 65 61 rrounds a boolea
48c0: 6e 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 n.** expression
48d0: 74 68 61 74 20 69 73 20 75 73 75 61 6c 6c 79 20 that is usually
48e0: 66 61 6c 73 65 2e 20 20 4d 61 63 72 6f 20 6c 69 false. Macro li
48f0: 6b 65 6c 79 28 29 20 73 75 72 72 6f 75 6e 64 73 kely() surrounds
4900: 0a 2a 2a 20 61 20 62 6f 6f 6c 65 61 6e 20 65 78 .** a boolean ex
4910: 70 72 65 73 73 69 6f 6e 20 74 68 61 74 20 69 73 pression that is
4920: 20 75 73 75 61 6c 6c 79 20 74 72 75 65 2e 20 20 usually true.
4930: 54 68 65 73 65 20 68 69 6e 74 73 20 63 6f 75 6c These hints coul
4940: 64 2c 0a 2a 2a 20 69 6e 20 74 68 65 6f 72 79 2c d,.** in theory,
4950: 20 62 65 20 75 73 65 64 20 62 79 20 74 68 65 20 be used by the
4960: 63 6f 6d 70 69 6c 65 72 20 74 6f 20 67 65 6e 65 compiler to gene
4970: 72 61 74 65 20 62 65 74 74 65 72 20 63 6f 64 65 rate better code
4980: 2c 20 62 75 74 0a 2a 2a 20 63 75 72 72 65 6e 74 , but.** current
4990: 6c 79 20 74 68 65 79 20 61 72 65 20 6a 75 73 74 ly they are just
49a0: 20 63 6f 6d 6d 65 6e 74 73 20 66 6f 72 20 68 75 comments for hu
49b0: 6d 61 6e 20 72 65 61 64 65 72 73 2e 0a 2a 2f 0a man readers..*/.
49c0: 23 64 65 66 69 6e 65 20 6c 69 6b 65 6c 79 28 58 #define likely(X
49d0: 29 20 20 20 20 28 58 29 0a 23 64 65 66 69 6e 65 ) (X).#define
49e0: 20 75 6e 6c 69 6b 65 6c 79 28 58 29 20 20 28 58 unlikely(X) (X
49f0: 29 0a 0a 23 69 6e 63 6c 75 64 65 20 22 68 61 73 )..#include "has
4a00: 68 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 70 h.h".#include "p
4a10: 61 72 73 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 arse.h".#include
4a20: 20 3c 73 74 64 69 6f 2e 68 3e 0a 23 69 6e 63 6c <stdio.h>.#incl
4a30: 75 64 65 20 3c 73 74 64 6c 69 62 2e 68 3e 0a 23 ude <stdlib.h>.#
4a40: 69 6e 63 6c 75 64 65 20 3c 73 74 72 69 6e 67 2e include <string.
4a50: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 61 73 73 h>.#include <ass
4a60: 65 72 74 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 ert.h>.#include
4a70: 3c 73 74 64 64 65 66 2e 68 3e 0a 0a 2f 2a 0a 2a <stddef.h>../*.*
4a80: 2a 20 55 73 65 20 61 20 6d 61 63 72 6f 20 74 6f * Use a macro to
4a90: 20 72 65 70 6c 61 63 65 20 6d 65 6d 63 70 79 28 replace memcpy(
4aa0: 29 20 69 66 20 63 6f 6d 70 69 6c 65 64 20 77 69 ) if compiled wi
4ab0: 74 68 20 53 51 4c 49 54 45 5f 49 4e 4c 49 4e 45 th SQLITE_INLINE
4ac0: 5f 4d 45 4d 43 50 59 2e 0a 2a 2a 20 54 68 69 73 _MEMCPY..** This
4ad0: 20 61 6c 6c 6f 77 73 20 62 65 74 74 65 72 20 6d allows better m
4ae0: 65 61 73 75 72 65 6d 65 6e 74 73 20 6f 66 20 77 easurements of w
4af0: 68 65 72 65 20 6d 65 6d 63 70 79 28 29 20 69 73 here memcpy() is
4b00: 20 75 73 65 64 20 77 68 65 6e 20 72 75 6e 6e 69 used when runni
4b10: 6e 67 0a 2a 2a 20 63 61 63 68 65 67 72 69 6e 64 ng.** cachegrind
4b20: 2e 20 20 42 75 74 20 74 68 69 73 20 6d 61 63 72 . But this macr
4b30: 6f 20 76 65 72 73 69 6f 6e 20 6f 66 20 6d 65 6d o version of mem
4b40: 63 70 79 28 29 20 69 73 20 76 65 72 79 20 73 6c cpy() is very sl
4b50: 6f 77 20 73 6f 20 69 74 0a 2a 2a 20 73 68 6f 75 ow so it.** shou
4b60: 6c 64 20 6e 6f 74 20 62 65 20 75 73 65 64 20 69 ld not be used i
4b70: 6e 20 70 72 6f 64 75 63 74 69 6f 6e 2e 20 20 54 n production. T
4b80: 68 69 73 20 69 73 20 61 20 70 65 72 66 6f 72 6d his is a perform
4b90: 61 6e 63 65 20 6d 65 61 73 75 72 65 6d 65 6e 74 ance measurement
4ba0: 0a 2a 2a 20 68 61 63 6b 20 6f 6e 6c 79 2e 0a 2a .** hack only..*
4bb0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
4bc0: 49 4e 4c 49 4e 45 5f 4d 45 4d 43 50 59 0a 23 20 INLINE_MEMCPY.#
4bd0: 64 65 66 69 6e 65 20 6d 65 6d 63 70 79 28 44 2c define memcpy(D,
4be0: 53 2c 4e 29 20 7b 63 68 61 72 2a 78 78 64 3d 28 S,N) {char*xxd=(
4bf0: 63 68 61 72 2a 29 28 44 29 3b 63 6f 6e 73 74 20 char*)(D);const
4c00: 63 68 61 72 2a 78 78 73 3d 28 63 6f 6e 73 74 20 char*xxs=(const
4c10: 63 68 61 72 2a 29 28 53 29 3b 5c 0a 20 20 20 20 char*)(S);\.
4c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4c30: 20 20 20 20 69 6e 74 20 78 78 6e 3d 28 4e 29 3b int xxn=(N);
4c40: 77 68 69 6c 65 28 78 78 6e 2d 2d 3e 30 29 2a 28 while(xxn-->0)*(
4c50: 78 78 64 2b 2b 29 3d 2a 28 78 78 73 2b 2b 29 3b xxd++)=*(xxs++);
4c60: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
4c70: 49 66 20 63 6f 6d 70 69 6c 69 6e 67 20 66 6f 72 If compiling for
4c80: 20 61 20 70 72 6f 63 65 73 73 6f 72 20 74 68 61 a processor tha
4c90: 74 20 6c 61 63 6b 73 20 66 6c 6f 61 74 69 6e 67 t lacks floating
4ca0: 20 70 6f 69 6e 74 20 73 75 70 70 6f 72 74 2c 0a point support,.
4cb0: 2a 2a 20 73 75 62 73 74 69 74 75 74 65 20 69 6e ** substitute in
4cc0: 74 65 67 65 72 20 66 6f 72 20 66 6c 6f 61 74 69 teger for floati
4cd0: 6e 67 2d 70 6f 69 6e 74 0a 2a 2f 0a 23 69 66 64 ng-point.*/.#ifd
4ce0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 ef SQLITE_OMIT_F
4cf0: 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 23 20 LOATING_POINT.#
4d00: 64 65 66 69 6e 65 20 64 6f 75 62 6c 65 20 73 71 define double sq
4d10: 6c 69 74 65 5f 69 6e 74 36 34 0a 23 20 64 65 66 lite_int64.# def
4d20: 69 6e 65 20 66 6c 6f 61 74 20 73 71 6c 69 74 65 ine float sqlite
4d30: 5f 69 6e 74 36 34 0a 23 20 64 65 66 69 6e 65 20 _int64.# define
4d40: 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 20 LONGDOUBLE_TYPE
4d50: 73 71 6c 69 74 65 5f 69 6e 74 36 34 0a 23 20 69 sqlite_int64.# i
4d60: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 42 49 47 fndef SQLITE_BIG
4d70: 5f 44 42 4c 0a 23 20 20 20 64 65 66 69 6e 65 20 _DBL.# define
4d80: 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c 20 28 SQLITE_BIG_DBL (
4d90: 28 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 ((sqlite3_int64)
4da0: 31 29 3c 3c 35 30 29 0a 23 20 65 6e 64 69 66 0a 1)<<50).# endif.
4db0: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
4dc0: 4f 4d 49 54 5f 44 41 54 45 54 49 4d 45 5f 46 55 OMIT_DATETIME_FU
4dd0: 4e 43 53 20 31 0a 23 20 64 65 66 69 6e 65 20 53 NCS 1.# define S
4de0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 QLITE_OMIT_TRACE
4df0: 20 31 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 1.# undef SQLIT
4e00: 45 5f 4d 49 58 45 44 5f 45 4e 44 49 41 4e 5f 36 E_MIXED_ENDIAN_6
4e10: 34 42 49 54 5f 46 4c 4f 41 54 0a 23 20 75 6e 64 4BIT_FLOAT.# und
4e20: 65 66 20 53 51 4c 49 54 45 5f 48 41 56 45 5f 49 ef SQLITE_HAVE_I
4e30: 53 4e 41 4e 0a 23 65 6e 64 69 66 0a 23 69 66 6e SNAN.#endif.#ifn
4e40: 64 65 66 20 53 51 4c 49 54 45 5f 42 49 47 5f 44 def SQLITE_BIG_D
4e50: 42 4c 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 BL.# define SQLI
4e60: 54 45 5f 42 49 47 5f 44 42 4c 20 28 31 65 39 39 TE_BIG_DBL (1e99
4e70: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
4e80: 4f 4d 49 54 5f 54 45 4d 50 44 42 20 69 73 20 73 OMIT_TEMPDB is s
4e90: 65 74 20 74 6f 20 31 20 69 66 20 53 51 4c 49 54 et to 1 if SQLIT
4ea0: 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 20 69 73 E_OMIT_TEMPDB is
4eb0: 20 64 65 66 69 6e 65 64 2c 20 6f 72 20 30 0a 2a defined, or 0.*
4ec0: 2a 20 61 66 74 65 72 77 61 72 64 2e 20 48 61 76 * afterward. Hav
4ed0: 69 6e 67 20 74 68 69 73 20 6d 61 63 72 6f 20 61 ing this macro a
4ee0: 6c 6c 6f 77 73 20 75 73 20 74 6f 20 63 61 75 73 llows us to caus
4ef0: 65 20 74 68 65 20 43 20 63 6f 6d 70 69 6c 65 72 e the C compiler
4f00: 0a 2a 2a 20 74 6f 20 6f 6d 69 74 20 63 6f 64 65 .** to omit code
4f10: 20 75 73 65 64 20 62 79 20 54 45 4d 50 20 74 61 used by TEMP ta
4f20: 62 6c 65 73 20 77 69 74 68 6f 75 74 20 6d 65 73 bles without mes
4f30: 73 79 20 23 69 66 6e 64 65 66 20 73 74 61 74 65 sy #ifndef state
4f40: 6d 65 6e 74 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 ments..*/.#ifdef
4f50: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d SQLITE_OMIT_TEM
4f60: 50 44 42 0a 23 64 65 66 69 6e 65 20 4f 4d 49 54 PDB.#define OMIT
4f70: 5f 54 45 4d 50 44 42 20 31 0a 23 65 6c 73 65 0a _TEMPDB 1.#else.
4f80: 23 64 65 66 69 6e 65 20 4f 4d 49 54 5f 54 45 4d #define OMIT_TEM
4f90: 50 44 42 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a PDB 0.#endif../*
4fa0: 0a 2a 2a 20 54 68 65 20 22 66 69 6c 65 20 66 6f .** The "file fo
4fb0: 72 6d 61 74 22 20 6e 75 6d 62 65 72 20 69 73 20 rmat" number is
4fc0: 61 6e 20 69 6e 74 65 67 65 72 20 74 68 61 74 20 an integer that
4fd0: 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 20 77 is incremented w
4fe0: 68 65 6e 65 76 65 72 0a 2a 2a 20 74 68 65 20 56 henever.** the V
4ff0: 44 42 45 2d 6c 65 76 65 6c 20 66 69 6c 65 20 66 DBE-level file f
5000: 6f 72 6d 61 74 20 63 68 61 6e 67 65 73 2e 20 20 ormat changes.
5010: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 The following ma
5020: 63 72 6f 73 20 64 65 66 69 6e 65 20 74 68 65 0a cros define the.
5030: 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 ** the default f
5040: 69 6c 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 6e ile format for n
5050: 65 77 20 64 61 74 61 62 61 73 65 73 20 61 6e 64 ew databases and
5060: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 66 69 6c the maximum fil
5070: 65 20 66 6f 72 6d 61 74 0a 2a 2a 20 74 68 61 74 e format.** that
5080: 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 61 6e the library can
5090: 20 72 65 61 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e read..*/.#defin
50a0: 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 49 4c e SQLITE_MAX_FIL
50b0: 45 5f 46 4f 52 4d 41 54 20 34 0a 23 69 66 6e 64 E_FORMAT 4.#ifnd
50c0: 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ef SQLITE_DEFAUL
50d0: 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 0a 23 20 T_FILE_FORMAT.#
50e0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 define SQLITE_DE
50f0: 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 FAULT_FILE_FORMA
5100: 54 20 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a T 4.#endif../*.*
5110: 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 74 * Determine whet
5120: 68 65 72 20 74 72 69 67 67 65 72 73 20 61 72 65 her triggers are
5130: 20 72 65 63 75 72 73 69 76 65 20 62 79 20 64 65 recursive by de
5140: 66 61 75 6c 74 2e 20 20 54 68 69 73 20 63 61 6e fault. This can
5150: 20 62 65 0a 2a 2a 20 63 68 61 6e 67 65 64 20 61 be.** changed a
5160: 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67 t run-time using
5170: 20 61 20 70 72 61 67 6d 61 2e 0a 2a 2f 0a 23 69 a pragma..*/.#i
5180: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 fndef SQLITE_DEF
5190: 41 55 4c 54 5f 52 45 43 55 52 53 49 56 45 5f 54 AULT_RECURSIVE_T
51a0: 52 49 47 47 45 52 53 0a 23 20 64 65 66 69 6e 65 RIGGERS.# define
51b0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
51c0: 52 45 43 55 52 53 49 56 45 5f 54 52 49 47 47 45 RECURSIVE_TRIGGE
51d0: 52 53 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a RS 0.#endif../*.
51e0: 2a 2a 20 50 72 6f 76 69 64 65 20 61 20 64 65 66 ** Provide a def
51f0: 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 20 53 ault value for S
5200: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
5210: 20 69 6e 20 63 61 73 65 20 69 74 20 69 73 20 6e in case it is n
5220: 6f 74 20 73 70 65 63 69 66 69 65 64 0a 2a 2a 20 ot specified.**
5230: 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c on the command-l
5240: 69 6e 65 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ine.*/.#ifndef S
5250: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
5260: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
5270: 5f 54 45 4d 50 5f 53 54 4f 52 45 20 31 0a 23 65 _TEMP_STORE 1.#e
5280: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 6e ndif../*.** If n
5290: 6f 20 76 61 6c 75 65 20 68 61 73 20 62 65 65 6e o value has been
52a0: 20 70 72 6f 76 69 64 65 64 20 66 6f 72 20 53 51 provided for SQ
52b0: 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f LITE_MAX_WORKER_
52c0: 54 48 52 45 41 44 53 2c 20 6f 72 20 69 66 0a 2a THREADS, or if.*
52d0: 2a 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 * SQLITE_TEMP_ST
52e0: 4f 52 45 20 69 73 20 73 65 74 20 74 6f 20 33 20 ORE is set to 3
52f0: 28 6e 65 76 65 72 20 75 73 65 20 74 65 6d 70 6f (never use tempo
5300: 72 61 72 79 20 66 69 6c 65 73 29 2c 20 73 65 74 rary files), set
5310: 20 69 74 0a 2a 2a 20 74 6f 20 7a 65 72 6f 2e 0a it.** to zero..
5320: 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 45 */.#if SQLITE_TE
5330: 4d 50 5f 53 54 4f 52 45 3d 3d 33 20 7c 7c 20 53 MP_STORE==3 || S
5340: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
5350: 3d 3d 30 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 ==0.# undef SQLI
5360: 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 TE_MAX_WORKER_TH
5370: 52 45 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 READS.# define S
5380: 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 QLITE_MAX_WORKER
5390: 5f 54 48 52 45 41 44 53 20 30 0a 23 65 6e 64 69 _THREADS 0.#endi
53a0: 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 f.#ifndef SQLITE
53b0: 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 _MAX_WORKER_THRE
53c0: 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c ADS.# define SQL
53d0: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
53e0: 48 52 45 41 44 53 20 38 0a 23 65 6e 64 69 66 0a HREADS 8.#endif.
53f0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
5400: 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 EFAULT_WORKER_TH
5410: 52 45 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 READS.# define S
5420: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f QLITE_DEFAULT_WO
5430: 52 4b 45 52 5f 54 48 52 45 41 44 53 20 30 0a 23 RKER_THREADS 0.#
5440: 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
5450: 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f _DEFAULT_WORKER_
5460: 54 48 52 45 41 44 53 3e 53 51 4c 49 54 45 5f 4d THREADS>SQLITE_M
5470: 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 AX_WORKER_THREAD
5480: 53 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 S.# undef SQLITE
5490: 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 _MAX_WORKER_THRE
54a0: 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c ADS.# define SQL
54b0: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
54c0: 48 52 45 41 44 53 20 53 51 4c 49 54 45 5f 44 45 HREADS SQLITE_DE
54d0: 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 52 FAULT_WORKER_THR
54e0: 45 41 44 53 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a EADS.#endif../*.
54f0: 2a 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 ** The default i
5500: 6e 69 74 69 61 6c 20 61 6c 6c 6f 63 61 74 69 6f nitial allocatio
5510: 6e 20 66 6f 72 20 74 68 65 20 70 61 67 65 63 61 n for the pageca
5520: 63 68 65 20 77 68 65 6e 20 75 73 69 6e 67 20 73 che when using s
5530: 65 70 61 72 61 74 65 0a 2a 2a 20 70 61 67 65 63 eparate.** pagec
5540: 61 63 68 65 73 20 66 6f 72 20 65 61 63 68 20 64 aches for each d
5550: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
5560: 6f 6e 2e 20 20 41 20 70 6f 73 69 74 69 76 65 20 on. A positive
5570: 6e 75 6d 62 65 72 20 69 73 20 74 68 65 0a 2a 2a number is the.**
5580: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
5590: 2e 20 20 41 20 6e 65 67 61 74 69 76 65 20 6e 75 . A negative nu
55a0: 6d 62 65 72 20 4e 20 74 72 61 6e 73 6c 61 74 69 mber N translati
55b0: 6f 6e 73 20 6d 65 61 6e 73 20 74 68 61 74 20 61 ons means that a
55c0: 20 62 75 66 66 65 72 0a 2a 2a 20 6f 66 20 2d 31 buffer.** of -1
55d0: 30 32 34 2a 4e 20 62 79 74 65 73 20 69 73 20 61 024*N bytes is a
55e0: 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 75 73 65 llocated and use
55f0: 64 20 66 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 d for as many pa
5600: 67 65 73 20 61 73 20 69 74 20 77 69 6c 6c 20 68 ges as it will h
5610: 6f 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 old..**.** The d
5620: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 efault value of
5630: 22 32 30 22 20 77 61 73 20 63 68 6f 6f 73 65 6e "20" was choosen
5640: 20 74 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 to minimize the
5650: 20 72 75 6e 2d 74 69 6d 65 20 6f 66 20 74 68 65 run-time of the
5660: 0a 2a 2a 20 73 70 65 65 64 74 65 73 74 31 20 74 .** speedtest1 t
5670: 65 73 74 20 70 72 6f 67 72 61 6d 20 77 69 74 68 est program with
5680: 20 6f 70 74 69 6f 6e 73 3a 20 2d 2d 73 68 72 69 options: --shri
5690: 6e 6b 2d 6d 65 6d 6f 72 79 20 2d 2d 72 65 70 72 nk-memory --repr
56a0: 65 70 61 72 65 0a 2a 2f 0a 23 69 66 6e 64 65 66 epare.*/.#ifndef
56b0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
56c0: 50 43 41 43 48 45 5f 49 4e 49 54 53 5a 0a 23 20 PCACHE_INITSZ.#
56d0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 define SQLITE_DE
56e0: 46 41 55 4c 54 5f 50 43 41 43 48 45 5f 49 4e 49 FAULT_PCACHE_INI
56f0: 54 53 5a 20 32 30 0a 23 65 6e 64 69 66 0a 0a 2f TSZ 20.#endif../
5700: 2a 0a 2a 2a 20 44 65 66 61 75 6c 74 20 76 61 6c *.** Default val
5710: 75 65 20 66 6f 72 20 74 68 65 20 53 51 4c 49 54 ue for the SQLIT
5720: 45 5f 43 4f 4e 46 49 47 5f 53 4f 52 54 45 52 52 E_CONFIG_SORTERR
5730: 45 46 5f 53 49 5a 45 20 6f 70 74 69 6f 6e 2e 0a EF_SIZE option..
5740: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
5750: 45 5f 44 45 46 41 55 4c 54 5f 53 4f 52 54 45 52 E_DEFAULT_SORTER
5760: 52 45 46 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e REF_SIZE.# defin
5770: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
5780: 5f 53 4f 52 54 45 52 52 45 46 5f 53 49 5a 45 20 _SORTERREF_SIZE
5790: 30 78 37 66 66 66 66 66 66 66 0a 23 65 6e 64 69 0x7fffffff.#endi
57a0: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 63 6f 6d f../*.** The com
57b0: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e pile-time option
57c0: 73 20 53 51 4c 49 54 45 5f 4d 4d 41 50 5f 52 45 s SQLITE_MMAP_RE
57d0: 41 44 57 52 49 54 45 20 61 6e 64 20 0a 2a 2a 20 ADWRITE and .**
57e0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41 SQLITE_ENABLE_BA
57f0: 54 43 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 TCH_ATOMIC_WRITE
5800: 20 61 72 65 20 6e 6f 74 20 63 6f 6d 70 61 74 69 are not compati
5810: 62 6c 65 20 77 69 74 68 20 6f 6e 65 20 61 6e 6f ble with one ano
5820: 74 68 65 72 2e 0a 2a 2a 20 59 6f 75 20 6d 75 73 ther..** You mus
5830: 74 20 63 68 6f 6f 73 65 20 6f 6e 65 20 6f 72 20 t choose one or
5840: 74 68 65 20 6f 74 68 65 72 20 28 6f 72 20 6e 65 the other (or ne
5850: 69 74 68 65 72 29 20 62 75 74 20 6e 6f 74 20 62 ither) but not b
5860: 6f 74 68 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 oth..*/.#if defi
5870: 6e 65 64 28 53 51 4c 49 54 45 5f 4d 4d 41 50 5f ned(SQLITE_MMAP_
5880: 52 45 41 44 57 52 49 54 45 29 20 26 26 20 64 65 READWRITE) && de
5890: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
58a0: 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f 4d 49 43 BLE_BATCH_ATOMIC
58b0: 5f 57 52 49 54 45 29 0a 23 65 72 72 6f 72 20 43 _WRITE).#error C
58c0: 61 6e 6e 6f 74 20 75 73 65 20 62 6f 74 68 20 53 annot use both S
58d0: 51 4c 49 54 45 5f 4d 4d 41 50 5f 52 45 41 44 57 QLITE_MMAP_READW
58e0: 52 49 54 45 20 61 6e 64 20 53 51 4c 49 54 45 5f RITE and SQLITE_
58f0: 45 4e 41 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f ENABLE_BATCH_ATO
5900: 4d 49 43 5f 57 52 49 54 45 0a 23 65 6e 64 69 66 MIC_WRITE.#endif
5910: 0a 0a 2f 2a 0a 2a 2a 20 47 43 43 20 64 6f 65 73 ../*.** GCC does
5920: 20 6e 6f 74 20 64 65 66 69 6e 65 20 74 68 65 20 not define the
5930: 6f 66 66 73 65 74 6f 66 28 29 20 6d 61 63 72 6f offsetof() macro
5940: 20 73 6f 20 77 65 27 6c 6c 20 68 61 76 65 20 74 so we'll have t
5950: 6f 20 64 6f 20 69 74 0a 2a 2a 20 6f 75 72 73 65 o do it.** ourse
5960: 6c 76 65 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 lves..*/.#ifndef
5970: 20 6f 66 66 73 65 74 6f 66 0a 23 64 65 66 69 6e offsetof.#defin
5980: 65 20 6f 66 66 73 65 74 6f 66 28 53 54 52 55 43 e offsetof(STRUC
5990: 54 55 52 45 2c 46 49 45 4c 44 29 20 28 28 69 6e TURE,FIELD) ((in
59a0: 74 29 28 28 63 68 61 72 2a 29 26 28 28 53 54 52 t)((char*)&((STR
59b0: 55 43 54 55 52 45 2a 29 30 29 2d 3e 46 49 45 4c UCTURE*)0)->FIEL
59c0: 44 29 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a D)).#endif../*.*
59d0: 2a 20 4d 61 63 72 6f 73 20 74 6f 20 63 6f 6d 70 * Macros to comp
59e0: 75 74 65 20 6d 69 6e 69 6d 75 6d 20 61 6e 64 20 ute minimum and
59f0: 6d 61 78 69 6d 75 6d 20 6f 66 20 74 77 6f 20 6e maximum of two n
5a00: 75 6d 62 65 72 73 2e 0a 2a 2f 0a 23 69 66 6e 64 umbers..*/.#ifnd
5a10: 65 66 20 4d 49 4e 0a 23 20 64 65 66 69 6e 65 20 ef MIN.# define
5a20: 4d 49 4e 28 41 2c 42 29 20 28 28 41 29 3c 28 42 MIN(A,B) ((A)<(B
5a30: 29 3f 28 41 29 3a 28 42 29 29 0a 23 65 6e 64 69 )?(A):(B)).#endi
5a40: 66 0a 23 69 66 6e 64 65 66 20 4d 41 58 0a 23 20 f.#ifndef MAX.#
5a50: 64 65 66 69 6e 65 20 4d 41 58 28 41 2c 42 29 20 define MAX(A,B)
5a60: 28 28 41 29 3e 28 42 29 3f 28 41 29 3a 28 42 29 ((A)>(B)?(A):(B)
5a70: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
5a80: 53 77 61 70 20 74 77 6f 20 6f 62 6a 65 63 74 73 Swap two objects
5a90: 20 6f 66 20 74 79 70 65 20 54 59 50 45 2e 0a 2a of type TYPE..*
5aa0: 2f 0a 23 64 65 66 69 6e 65 20 53 57 41 50 28 54 /.#define SWAP(T
5ab0: 59 50 45 2c 41 2c 42 29 20 7b 54 59 50 45 20 74 YPE,A,B) {TYPE t
5ac0: 3d 41 3b 20 41 3d 42 3b 20 42 3d 74 3b 7d 0a 0a =A; A=B; B=t;}..
5ad0: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 /*.** Check to s
5ae0: 65 65 20 69 66 20 74 68 69 73 20 6d 61 63 68 69 ee if this machi
5af0: 6e 65 20 75 73 65 73 20 45 42 43 44 49 43 2e 20 ne uses EBCDIC.
5b00: 20 28 59 65 73 2c 20 62 65 6c 69 65 76 65 20 69 (Yes, believe i
5b10: 74 20 6f 72 0a 2a 2a 20 6e 6f 74 2c 20 74 68 65 t or.** not, the
5b20: 72 65 20 61 72 65 20 73 74 69 6c 6c 20 6d 61 63 re are still mac
5b30: 68 69 6e 65 73 20 6f 75 74 20 74 68 65 72 65 20 hines out there
5b40: 74 68 61 74 20 75 73 65 20 45 42 43 44 49 43 2e that use EBCDIC.
5b50: 29 0a 2a 2f 0a 23 69 66 20 27 41 27 20 3d 3d 20 ).*/.#if 'A' ==
5b60: 27 5c 33 30 31 27 0a 23 20 64 65 66 69 6e 65 20 '\301'.# define
5b70: 53 51 4c 49 54 45 5f 45 42 43 44 49 43 20 31 0a SQLITE_EBCDIC 1.
5b80: 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53 #else.# define S
5b90: 51 4c 49 54 45 5f 41 53 43 49 49 20 31 0a 23 65 QLITE_ASCII 1.#e
5ba0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 ndif../*.** Inte
5bb0: 67 65 72 73 20 6f 66 20 6b 6e 6f 77 6e 20 73 69 gers of known si
5bc0: 7a 65 73 2e 20 20 54 68 65 73 65 20 74 79 70 65 zes. These type
5bd0: 64 65 66 73 20 6d 69 67 68 74 20 63 68 61 6e 67 defs might chang
5be0: 65 20 66 6f 72 20 61 72 63 68 69 74 65 63 74 75 e for architectu
5bf0: 72 65 73 0a 2a 2a 20 77 68 65 72 65 20 74 68 65 res.** where the
5c00: 20 73 69 7a 65 73 20 76 65 72 79 2e 20 20 50 72 sizes very. Pr
5c10: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f eprocessor macro
5c20: 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 s are available
5c30: 73 6f 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 74 so that the.** t
5c40: 79 70 65 73 20 63 61 6e 20 62 65 20 63 6f 6e 76 ypes can be conv
5c50: 65 6e 69 65 6e 74 6c 79 20 72 65 64 65 66 69 6e eniently redefin
5c60: 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 79 ed at compile-ty
5c70: 70 65 2e 20 20 4c 69 6b 65 20 74 68 69 73 3a 0a pe. Like this:.
5c80: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 63 63 **.** cc
5c90: 20 27 2d 44 55 49 4e 54 50 54 52 5f 54 59 50 45 '-DUINTPTR_TYPE
5ca0: 3d 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 27 20 =long long int'
5cb0: 2e 2e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 55 ....*/.#ifndef U
5cc0: 49 4e 54 33 32 5f 54 59 50 45 0a 23 20 69 66 64 INT32_TYPE.# ifd
5cd0: 65 66 20 48 41 56 45 5f 55 49 4e 54 33 32 5f 54 ef HAVE_UINT32_T
5ce0: 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 33 .# define UINT3
5cf0: 32 5f 54 59 50 45 20 75 69 6e 74 33 32 5f 74 0a 2_TYPE uint32_t.
5d00: 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 # else.# define
5d10: 20 55 49 4e 54 33 32 5f 54 59 50 45 20 75 6e 73 UINT32_TYPE uns
5d20: 69 67 6e 65 64 20 69 6e 74 0a 23 20 65 6e 64 69 igned int.# endi
5d30: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
5d40: 20 55 49 4e 54 31 36 5f 54 59 50 45 0a 23 20 69 UINT16_TYPE.# i
5d50: 66 64 65 66 20 48 41 56 45 5f 55 49 4e 54 31 36 fdef HAVE_UINT16
5d60: 5f 54 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e _T.# define UIN
5d70: 54 31 36 5f 54 59 50 45 20 75 69 6e 74 31 36 5f T16_TYPE uint16_
5d80: 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 t.# else.# defi
5d90: 6e 65 20 55 49 4e 54 31 36 5f 54 59 50 45 20 75 ne UINT16_TYPE u
5da0: 6e 73 69 67 6e 65 64 20 73 68 6f 72 74 20 69 6e nsigned short in
5db0: 74 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 t.# endif.#endif
5dc0: 0a 23 69 66 6e 64 65 66 20 49 4e 54 31 36 5f 54 .#ifndef INT16_T
5dd0: 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 YPE.# ifdef HAVE
5de0: 5f 49 4e 54 31 36 5f 54 0a 23 20 20 64 65 66 69 _INT16_T.# defi
5df0: 6e 65 20 49 4e 54 31 36 5f 54 59 50 45 20 69 6e ne INT16_TYPE in
5e00: 74 31 36 5f 74 0a 23 20 65 6c 73 65 0a 23 20 20 t16_t.# else.#
5e10: 64 65 66 69 6e 65 20 49 4e 54 31 36 5f 54 59 50 define INT16_TYP
5e20: 45 20 73 68 6f 72 74 20 69 6e 74 0a 23 20 65 6e E short int.# en
5e30: 64 69 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 dif.#endif.#ifnd
5e40: 65 66 20 55 49 4e 54 38 5f 54 59 50 45 0a 23 20 ef UINT8_TYPE.#
5e50: 69 66 64 65 66 20 48 41 56 45 5f 55 49 4e 54 38 ifdef HAVE_UINT8
5e60: 5f 54 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e _T.# define UIN
5e70: 54 38 5f 54 59 50 45 20 75 69 6e 74 38 5f 74 0a T8_TYPE uint8_t.
5e80: 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 # else.# define
5e90: 20 55 49 4e 54 38 5f 54 59 50 45 20 75 6e 73 69 UINT8_TYPE unsi
5ea0: 67 6e 65 64 20 63 68 61 72 0a 23 20 65 6e 64 69 gned char.# endi
5eb0: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
5ec0: 20 49 4e 54 38 5f 54 59 50 45 0a 23 20 69 66 64 INT8_TYPE.# ifd
5ed0: 65 66 20 48 41 56 45 5f 49 4e 54 38 5f 54 0a 23 ef HAVE_INT8_T.#
5ee0: 20 20 64 65 66 69 6e 65 20 49 4e 54 38 5f 54 59 define INT8_TY
5ef0: 50 45 20 69 6e 74 38 5f 74 0a 23 20 65 6c 73 65 PE int8_t.# else
5f00: 0a 23 20 20 64 65 66 69 6e 65 20 49 4e 54 38 5f .# define INT8_
5f10: 54 59 50 45 20 73 69 67 6e 65 64 20 63 68 61 72 TYPE signed char
5f20: 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a .# endif.#endif.
5f30: 23 69 66 6e 64 65 66 20 4c 4f 4e 47 44 4f 55 42 #ifndef LONGDOUB
5f40: 4c 45 5f 54 59 50 45 0a 23 20 64 65 66 69 6e 65 LE_TYPE.# define
5f50: 20 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 LONGDOUBLE_TYPE
5f60: 20 6c 6f 6e 67 20 64 6f 75 62 6c 65 0a 23 65 6e long double.#en
5f70: 64 69 66 0a 74 79 70 65 64 65 66 20 73 71 6c 69 dif.typedef sqli
5f80: 74 65 5f 69 6e 74 36 34 20 69 36 34 3b 20 20 20 te_int64 i64;
5f90: 20 20 20 20 20 20 20 2f 2a 20 38 2d 62 79 74 65 /* 8-byte
5fa0: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 signed integer
5fb0: 2a 2f 0a 74 79 70 65 64 65 66 20 73 71 6c 69 74 */.typedef sqlit
5fc0: 65 5f 75 69 6e 74 36 34 20 75 36 34 3b 20 20 20 e_uint64 u64;
5fd0: 20 20 20 20 20 20 2f 2a 20 38 2d 62 79 74 65 20 /* 8-byte
5fe0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
5ff0: 20 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e 54 */.typedef UINT
6000: 33 32 5f 54 59 50 45 20 75 33 32 3b 20 20 20 20 32_TYPE u32;
6010: 20 20 20 20 20 20 20 2f 2a 20 34 2d 62 79 74 65 /* 4-byte
6020: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 unsigned intege
6030: 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e r */.typedef UIN
6040: 54 31 36 5f 54 59 50 45 20 75 31 36 3b 20 20 20 T16_TYPE u16;
6050: 20 20 20 20 20 20 20 20 2f 2a 20 32 2d 62 79 74 /* 2-byt
6060: 65 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 e unsigned integ
6070: 65 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e er */.typedef IN
6080: 54 31 36 5f 54 59 50 45 20 69 31 36 3b 20 20 20 T16_TYPE i16;
6090: 20 20 20 20 20 20 20 20 20 2f 2a 20 32 2d 62 79 /* 2-by
60a0: 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 te signed intege
60b0: 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e r */.typedef UIN
60c0: 54 38 5f 54 59 50 45 20 75 38 3b 20 20 20 20 20 T8_TYPE u8;
60d0: 20 20 20 20 20 20 20 20 2f 2a 20 31 2d 62 79 74 /* 1-byt
60e0: 65 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 e unsigned integ
60f0: 65 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e er */.typedef IN
6100: 54 38 5f 54 59 50 45 20 69 38 3b 20 20 20 20 20 T8_TYPE i8;
6110: 20 20 20 20 20 20 20 20 20 2f 2a 20 31 2d 62 79 /* 1-by
6120: 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 te signed intege
6130: 72 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 49 r */../*.** SQLI
6140: 54 45 5f 4d 41 58 5f 55 33 32 20 69 73 20 61 20 TE_MAX_U32 is a
6150: 75 36 34 20 63 6f 6e 73 74 61 6e 74 20 74 68 61 u64 constant tha
6160: 74 20 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d t is the maximum
6170: 20 75 36 34 20 76 61 6c 75 65 0a 2a 2a 20 74 68 u64 value.** th
6180: 61 74 20 63 61 6e 20 62 65 20 73 74 6f 72 65 64 at can be stored
6190: 20 69 6e 20 61 20 75 33 32 20 77 69 74 68 6f 75 in a u32 withou
61a0: 74 20 6c 6f 73 73 20 6f 66 20 64 61 74 61 2e 20 t loss of data.
61b0: 20 54 68 65 20 76 61 6c 75 65 0a 2a 2a 20 69 73 The value.** is
61c0: 20 30 78 30 30 30 30 30 30 30 30 66 66 66 66 66 0x00000000fffff
61d0: 66 66 66 2e 20 20 42 75 74 20 62 65 63 61 75 73 fff. But becaus
61e0: 65 20 6f 66 20 71 75 69 72 6b 73 20 6f 66 20 73 e of quirks of s
61f0: 6f 6d 65 20 63 6f 6d 70 69 6c 65 72 73 2c 20 77 ome compilers, w
6200: 65 0a 2a 2a 20 68 61 76 65 20 74 6f 20 73 70 65 e.** have to spe
6210: 63 69 66 79 20 74 68 65 20 76 61 6c 75 65 20 69 cify the value i
6220: 6e 20 74 68 65 20 6c 65 73 73 20 69 6e 74 75 69 n the less intui
6230: 74 69 76 65 20 6d 61 6e 6e 65 72 20 73 68 6f 77 tive manner show
6240: 6e 3a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 n:.*/.#define SQ
6250: 4c 49 54 45 5f 4d 41 58 5f 55 33 32 20 20 28 28 LITE_MAX_U32 ((
6260: 28 28 75 36 34 29 31 29 3c 3c 33 32 29 2d 31 29 ((u64)1)<<32)-1)
6270: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 ../*.** The data
6280: 74 79 70 65 20 75 73 65 64 20 74 6f 20 73 74 6f type used to sto
6290: 72 65 20 65 73 74 69 6d 61 74 65 73 20 6f 66 20 re estimates of
62a0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f the number of ro
62b0: 77 73 20 69 6e 20 61 0a 2a 2a 20 74 61 62 6c 65 ws in a.** table
62c0: 20 6f 72 20 69 6e 64 65 78 2e 20 20 54 68 69 73 or index. This
62d0: 20 69 73 20 61 6e 20 75 6e 73 69 67 6e 65 64 20 is an unsigned
62e0: 69 6e 74 65 67 65 72 20 74 79 70 65 2e 20 20 46 integer type. F
62f0: 6f 72 20 39 39 2e 39 25 20 6f 66 0a 2a 2a 20 74 or 99.9% of.** t
6300: 68 65 20 77 6f 72 6c 64 2c 20 61 20 33 32 2d 62 he world, a 32-b
6310: 69 74 20 69 6e 74 65 67 65 72 20 69 73 20 73 75 it integer is su
6320: 66 66 69 63 69 65 6e 74 2e 20 20 42 75 74 20 61 fficient. But a
6330: 20 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 0a 64-bit integer.
6340: 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 ** can be used a
6350: 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 69 t compile-time i
6360: 66 20 64 65 73 69 72 65 64 2e 0a 2a 2f 0a 23 69 f desired..*/.#i
6370: 66 64 65 66 20 53 51 4c 49 54 45 5f 36 34 42 49 fdef SQLITE_64BI
6380: 54 5f 53 54 41 54 53 0a 20 74 79 70 65 64 65 66 T_STATS. typedef
6390: 20 75 36 34 20 74 52 6f 77 63 6e 74 3b 20 20 20 u64 tRowcnt;
63a0: 20 2f 2a 20 36 34 2d 62 69 74 20 6f 6e 6c 79 20 /* 64-bit only
63b0: 69 66 20 72 65 71 75 65 73 74 65 64 20 61 74 20 if requested at
63c0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 2a 2f 0a compile-time */.
63d0: 23 65 6c 73 65 0a 20 74 79 70 65 64 65 66 20 75 #else. typedef u
63e0: 33 32 20 74 52 6f 77 63 6e 74 3b 20 20 20 20 2f 32 tRowcnt; /
63f0: 2a 20 33 32 2d 62 69 74 20 69 73 20 74 68 65 20 * 32-bit is the
6400: 64 65 66 61 75 6c 74 20 2a 2f 0a 23 65 6e 64 69 default */.#endi
6410: 66 0a 0a 2f 2a 0a 2a 2a 20 45 73 74 69 6d 61 74 f../*.** Estimat
6420: 65 64 20 71 75 61 6e 74 69 74 69 65 73 20 75 73 ed quantities us
6430: 65 64 20 66 6f 72 20 71 75 65 72 79 20 70 6c 61 ed for query pla
6440: 6e 6e 69 6e 67 20 61 72 65 20 73 74 6f 72 65 64 nning are stored
6450: 20 61 73 20 31 36 2d 62 69 74 0a 2a 2a 20 6c 6f as 16-bit.** lo
6460: 67 61 72 69 74 68 6d 73 2e 20 20 46 6f 72 20 71 garithms. For q
6470: 75 61 6e 74 69 74 79 20 58 2c 20 74 68 65 20 76 uantity X, the v
6480: 61 6c 75 65 20 73 74 6f 72 65 64 20 69 73 20 31 alue stored is 1
6490: 30 2a 6c 6f 67 32 28 58 29 2e 20 20 54 68 69 73 0*log2(X). This
64a0: 0a 2a 2a 20 67 69 76 65 73 20 61 20 70 6f 73 73 .** gives a poss
64b0: 69 62 6c 65 20 72 61 6e 67 65 20 6f 66 20 76 61 ible range of va
64c0: 6c 75 65 73 20 6f 66 20 61 70 70 72 6f 78 69 6d lues of approxim
64d0: 61 74 65 6c 79 20 31 2e 30 65 39 38 36 20 74 6f ately 1.0e986 to
64e0: 20 31 65 2d 39 38 36 2e 0a 2a 2a 20 42 75 74 20 1e-986..** But
64f0: 74 68 65 20 61 6c 6c 6f 77 65 64 20 76 61 6c 75 the allowed valu
6500: 65 73 20 61 72 65 20 22 67 72 61 69 6e 79 22 2e es are "grainy".
6510: 20 20 4e 6f 74 20 65 76 65 72 79 20 76 61 6c 75 Not every valu
6520: 65 20 69 73 20 72 65 70 72 65 73 65 6e 74 61 62 e is representab
6530: 6c 65 2e 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 le..** For examp
6540: 6c 65 2c 20 71 75 61 6e 74 69 74 69 65 73 20 31 le, quantities 1
6550: 36 20 61 6e 64 20 31 37 20 61 72 65 20 62 6f 74 6 and 17 are bot
6560: 68 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 h represented by
6570: 20 61 20 4c 6f 67 45 73 74 0a 2a 2a 20 6f 66 20 a LogEst.** of
6580: 34 30 2e 20 20 48 6f 77 65 76 65 72 2c 20 73 69 40. However, si
6590: 6e 63 65 20 4c 6f 67 45 73 74 20 71 75 61 6e 74 nce LogEst quant
65a0: 69 74 69 65 73 20 61 72 65 20 73 75 70 70 6f 73 ities are suppos
65b0: 65 20 74 6f 20 62 65 20 65 73 74 69 6d 61 74 65 e to be estimate
65c0: 73 2c 0a 2a 2a 20 6e 6f 74 20 65 78 61 63 74 20 s,.** not exact
65d0: 76 61 6c 75 65 73 2c 20 74 68 69 73 20 69 6d 70 values, this imp
65e0: 72 65 63 69 73 69 6f 6e 20 69 73 20 6e 6f 74 20 recision is not
65f0: 61 20 70 72 6f 62 6c 65 6d 2e 0a 2a 2a 0a 2a 2a a problem..**.**
6600: 20 22 4c 6f 67 45 73 74 22 20 69 73 20 73 68 6f "LogEst" is sho
6610: 72 74 20 66 6f 72 20 22 4c 6f 67 61 72 69 74 68 rt for "Logarith
6620: 6d 69 63 20 45 73 74 69 6d 61 74 65 22 2e 0a 2a mic Estimate"..*
6630: 2a 0a 2a 2a 20 45 78 61 6d 70 6c 65 73 3a 0a 2a *.** Examples:.*
6640: 2a 20 20 20 20 20 20 31 20 2d 3e 20 30 20 20 20 * 1 -> 0
6650: 20 20 20 20 20 20 20 20 20 20 20 32 30 20 2d 3e 20 ->
6660: 20 34 33 20 20 20 20 20 20 20 20 20 20 31 30 30 43 100
6670: 30 30 20 2d 3e 20 31 33 32 0a 2a 2a 20 20 20 20 00 -> 132.**
6680: 20 20 32 20 2d 3e 20 31 30 20 20 20 20 20 20 20 2 -> 10
6690: 20 20 20 20 20 20 32 35 20 2d 3e 20 34 36 20 20 25 -> 46
66a0: 20 20 20 20 20 20 20 20 32 35 30 30 30 20 2d 3e 25000 ->
66b0: 20 31 34 36 0a 2a 2a 20 20 20 20 20 20 33 20 2d 146.** 3 -
66c0: 3e 20 31 36 20 20 20 20 20 20 20 20 20 20 20 20 > 16
66d0: 31 30 30 20 2d 3e 20 36 36 20 20 20 20 20 20 20 100 -> 66
66e0: 20 31 30 30 30 30 30 30 20 2d 3e 20 31 39 39 0a 1000000 -> 199.
66f0: 2a 2a 20 20 20 20 20 20 34 20 2d 3e 20 32 30 20 ** 4 -> 20
6700: 20 20 20 20 20 20 20 20 20 20 31 30 30 30 20 2d 1000 -
6710: 3e 20 39 39 20 20 20 20 20 20 20 20 31 30 34 38 > 99 1048
6720: 35 37 36 20 2d 3e 20 32 30 30 0a 2a 2a 20 20 20 576 -> 200.**
6730: 20 20 31 30 20 2d 3e 20 33 33 20 20 20 20 20 20 10 -> 33
6740: 20 20 20 20 20 31 30 32 34 20 2d 3e 20 31 30 30 1024 -> 100
6750: 20 20 20 20 34 32 39 34 39 36 37 32 39 36 20 2d 4294967296 -
6760: 3e 20 33 32 30 0a 2a 2a 0a 2a 2a 20 54 68 65 20 > 320.**.** The
6770: 4c 6f 67 45 73 74 20 63 61 6e 20 62 65 20 6e 65 LogEst can be ne
6780: 67 61 74 69 76 65 20 74 6f 20 69 6e 64 69 63 61 gative to indica
6790: 74 65 20 66 72 61 63 74 69 6f 6e 61 6c 20 76 61 te fractional va
67a0: 6c 75 65 73 2e 0a 2a 2a 20 45 78 61 6d 70 6c 65 lues..** Example
67b0: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 30 2e 35 20 s:.**.** 0.5
67c0: 2d 3e 20 2d 31 30 20 20 20 20 20 20 20 20 20 20 -> -10
67d0: 20 30 2e 31 20 2d 3e 20 2d 33 33 20 20 20 20 20 0.1 -> -33
67e0: 20 20 20 30 2e 30 36 32 35 20 2d 3e 20 2d 34 30 0.0625 -> -40
67f0: 0a 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e 54 31 .*/.typedef INT1
6800: 36 5f 54 59 50 45 20 4c 6f 67 45 73 74 3b 0a 0a 6_TYPE LogEst;..
6810: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 53 51 /*.** Set the SQ
6820: 4c 49 54 45 5f 50 54 52 53 49 5a 45 20 6d 61 63 LITE_PTRSIZE mac
6830: 72 6f 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 ro to the number
6840: 20 6f 66 20 62 79 74 65 73 20 69 6e 20 61 20 70 of bytes in a p
6850: 6f 69 6e 74 65 72 0a 2a 2f 0a 23 69 66 6e 64 65 ointer.*/.#ifnde
6860: 66 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 f SQLITE_PTRSIZE
6870: 0a 23 20 69 66 20 64 65 66 69 6e 65 64 28 5f 5f .# if defined(__
6880: 53 49 5a 45 4f 46 5f 50 4f 49 4e 54 45 52 5f 5f SIZEOF_POINTER__
6890: 29 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c ).# define SQL
68a0: 49 54 45 5f 50 54 52 53 49 5a 45 20 5f 5f 53 49 ITE_PTRSIZE __SI
68b0: 5a 45 4f 46 5f 50 4f 49 4e 54 45 52 5f 5f 0a 23 ZEOF_POINTER__.#
68c0: 20 65 6c 69 66 20 64 65 66 69 6e 65 64 28 69 33 elif defined(i3
68d0: 38 36 29 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 86) || defin
68e0: 65 64 28 5f 5f 69 33 38 36 5f 5f 29 20 20 20 7c ed(__i386__) |
68f0: 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f 49 58 38 | defined(_M_IX8
6900: 36 29 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 6) || \.
6910: 20 20 64 65 66 69 6e 65 64 28 5f 4d 5f 41 52 4d defined(_M_ARM
6920: 29 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f ) || defined(_
6930: 5f 61 72 6d 5f 5f 29 20 20 20 20 7c 7c 20 64 65 _arm__) || de
6940: 66 69 6e 65 64 28 5f 5f 78 38 36 29 0a 23 20 20 fined(__x86).#
6950: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 define SQLITE_P
6960: 54 52 53 49 5a 45 20 34 0a 23 20 65 6c 73 65 0a TRSIZE 4.# else.
6970: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
6980: 45 5f 50 54 52 53 49 5a 45 20 38 0a 23 20 65 6e E_PTRSIZE 8.# en
6990: 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 54 dif.#endif../* T
69a0: 68 65 20 75 70 74 72 20 74 79 70 65 20 69 73 20 he uptr type is
69b0: 61 6e 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 an unsigned inte
69c0: 67 65 72 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 ger large enough
69d0: 20 74 6f 20 68 6f 6c 64 20 61 20 70 6f 69 6e 74 to hold a point
69e0: 65 72 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 er.*/.#if define
69f0: 64 28 48 41 56 45 5f 53 54 44 49 4e 54 5f 48 29 d(HAVE_STDINT_H)
6a00: 0a 20 20 74 79 70 65 64 65 66 20 75 69 6e 74 70 . typedef uintp
6a10: 74 72 5f 74 20 75 70 74 72 3b 0a 23 65 6c 69 66 tr_t uptr;.#elif
6a20: 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 3d SQLITE_PTRSIZE=
6a30: 3d 34 0a 20 20 74 79 70 65 64 65 66 20 75 33 32 =4. typedef u32
6a40: 20 75 70 74 72 3b 0a 23 65 6c 73 65 0a 20 20 74 uptr;.#else. t
6a50: 79 70 65 64 65 66 20 75 36 34 20 75 70 74 72 3b ypedef u64 uptr;
6a60: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
6a70: 68 65 20 53 51 4c 49 54 45 5f 57 49 54 48 49 4e he SQLITE_WITHIN
6a80: 28 50 2c 53 2c 45 29 20 6d 61 63 72 6f 20 63 68 (P,S,E) macro ch
6a90: 65 63 6b 73 20 74 6f 20 73 65 65 20 69 66 20 70 ecks to see if p
6aa0: 6f 69 6e 74 65 72 20 50 20 70 6f 69 6e 74 73 20 ointer P points
6ab0: 74 6f 0a 2a 2a 20 73 6f 6d 65 74 68 69 6e 67 20 to.** something
6ac0: 62 65 74 77 65 65 6e 20 53 20 28 69 6e 63 6c 75 between S (inclu
6ad0: 73 69 76 65 29 20 61 6e 64 20 45 20 28 65 78 63 sive) and E (exc
6ae0: 6c 75 73 69 76 65 29 2e 0a 2a 2a 0a 2a 2a 20 49 lusive)..**.** I
6af0: 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 53 n other words, S
6b00: 20 69 73 20 61 20 62 75 66 66 65 72 20 61 6e 64 is a buffer and
6b10: 20 45 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 E is a pointer
6b20: 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 to the first byt
6b30: 65 20 61 66 74 65 72 0a 2a 2a 20 74 68 65 20 65 e after.** the e
6b40: 6e 64 20 6f 66 20 62 75 66 66 65 72 20 53 2e 20 nd of buffer S.
6b50: 20 54 68 69 73 20 6d 61 63 72 6f 20 72 65 74 75 This macro retu
6b60: 72 6e 73 20 74 72 75 65 20 69 66 20 50 20 70 6f rns true if P po
6b70: 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e ints to somethin
6b80: 67 0a 2a 2a 20 63 6f 6e 74 61 69 6e 65 64 20 77 g.** contained w
6b90: 69 74 68 69 6e 20 74 68 65 20 62 75 66 66 65 72 ithin the buffer
6ba0: 20 53 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 S..*/.#define S
6bb0: 51 4c 49 54 45 5f 57 49 54 48 49 4e 28 50 2c 53 QLITE_WITHIN(P,S
6bc0: 2c 45 29 20 28 28 28 75 70 74 72 29 28 50 29 3e ,E) (((uptr)(P)>
6bd0: 3d 28 75 70 74 72 29 28 53 29 29 26 26 28 28 75 =(uptr)(S))&&((u
6be0: 70 74 72 29 28 50 29 3c 28 75 70 74 72 29 28 45 ptr)(P)<(uptr)(E
6bf0: 29 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 ))).../*.** Macr
6c00: 6f 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 os to determine
6c10: 77 68 65 74 68 65 72 20 74 68 65 20 6d 61 63 68 whether the mach
6c20: 69 6e 65 20 69 73 20 62 69 67 20 6f 72 20 6c 69 ine is big or li
6c30: 74 74 6c 65 20 65 6e 64 69 61 6e 2c 0a 2a 2a 20 ttle endian,.**
6c40: 61 6e 64 20 77 68 65 74 68 65 72 20 6f 72 20 6e and whether or n
6c50: 6f 74 20 74 68 61 74 20 64 65 74 65 72 6d 69 6e ot that determin
6c60: 61 74 69 6f 6e 20 69 73 20 72 75 6e 2d 74 69 6d ation is run-tim
6c70: 65 20 6f 72 20 63 6f 6d 70 69 6c 65 2d 74 69 6d e or compile-tim
6c80: 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 62 65 73 e..**.** For bes
6c90: 74 20 70 65 72 66 6f 72 6d 61 6e 63 65 2c 20 61 t performance, a
6ca0: 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 n attempt is mad
6cb0: 65 20 74 6f 20 67 75 65 73 73 20 61 74 20 74 68 e to guess at th
6cc0: 65 20 62 79 74 65 2d 6f 72 64 65 72 0a 2a 2a 20 e byte-order.**
6cd0: 75 73 69 6e 67 20 43 2d 70 72 65 70 72 6f 63 65 using C-preproce
6ce0: 73 73 6f 72 20 6d 61 63 72 6f 73 2e 20 20 49 66 ssor macros. If
6cf0: 20 74 68 61 74 20 69 73 20 75 6e 73 75 63 63 65 that is unsucce
6d00: 73 73 66 75 6c 2c 20 6f 72 20 69 66 0a 2a 2a 20 ssful, or if.**
6d10: 2d 44 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 -DSQLITE_BYTEORD
6d20: 45 52 3d 30 20 69 73 20 73 65 74 2c 20 74 68 65 ER=0 is set, the
6d30: 6e 20 62 79 74 65 2d 6f 72 64 65 72 20 69 73 20 n byte-order is
6d40: 64 65 74 65 72 6d 69 6e 65 64 0a 2a 2a 20 61 74 determined.** at
6d50: 20 72 75 6e 2d 74 69 6d 65 2e 0a 2a 2f 0a 23 69 run-time..*/.#i
6d60: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 42 59 54 fndef SQLITE_BYT
6d70: 45 4f 52 44 45 52 0a 23 20 69 66 20 64 65 66 69 EORDER.# if defi
6d80: 6e 65 64 28 69 33 38 36 29 20 20 20 20 20 7c 7c ned(i386) ||
6d90: 20 64 65 66 69 6e 65 64 28 5f 5f 69 33 38 36 5f defined(__i386_
6da0: 5f 29 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 _) || defined(
6db0: 5f 4d 5f 49 58 38 36 29 20 7c 7c 20 20 20 20 5c _M_IX86) || \
6dc0: 0a 20 20 20 20 20 64 65 66 69 6e 65 64 28 5f 5f . defined(__
6dd0: 78 38 36 5f 36 34 29 20 7c 7c 20 64 65 66 69 6e x86_64) || defin
6de0: 65 64 28 5f 5f 78 38 36 5f 36 34 5f 5f 29 20 7c ed(__x86_64__) |
6df0: 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f 58 36 34 | defined(_M_X64
6e00: 29 20 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 ) || \.
6e10: 64 65 66 69 6e 65 64 28 5f 4d 5f 41 4d 44 36 34 defined(_M_AMD64
6e20: 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f ) || defined(_M_
6e30: 41 52 4d 29 20 20 20 20 20 7c 7c 20 64 65 66 69 ARM) || defi
6e40: 6e 65 64 28 5f 5f 78 38 36 29 20 20 20 7c 7c 20 ned(__x86) ||
6e50: 20 20 20 5c 0a 20 20 20 20 20 64 65 66 69 6e 65 \. define
6e60: 64 28 5f 5f 61 72 6d 5f 5f 29 0a 23 20 20 20 64 d(__arm__).# d
6e70: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 59 54 efine SQLITE_BYT
6e80: 45 4f 52 44 45 52 20 20 20 20 31 32 33 34 0a 23 EORDER 1234.#
6e90: 20 65 6c 69 66 20 64 65 66 69 6e 65 64 28 73 70 elif defined(sp
6ea0: 61 72 63 29 20 20 20 20 7c 7c 20 64 65 66 69 6e arc) || defin
6eb0: 65 64 28 5f 5f 70 70 63 5f 5f 29 0a 23 20 20 20 ed(__ppc__).#
6ec0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 59 define SQLITE_BY
6ed0: 54 45 4f 52 44 45 52 20 20 20 20 34 33 32 31 0a TEORDER 4321.
6ee0: 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 6e # else.# defin
6ef0: 65 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 e SQLITE_BYTEORD
6f00: 45 52 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e ER 0.# endif.#en
6f10: 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 42 dif.#if SQLITE_B
6f20: 59 54 45 4f 52 44 45 52 3d 3d 34 33 32 31 0a 23 YTEORDER==4321.#
6f30: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 define SQLITE_B
6f40: 49 47 45 4e 44 49 41 4e 20 20 20 20 31 0a 23 20 IGENDIAN 1.#
6f50: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 define SQLITE_LI
6f60: 54 54 4c 45 45 4e 44 49 41 4e 20 30 0a 23 20 64 TTLEENDIAN 0.# d
6f70: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55 54 46 efine SQLITE_UTF
6f80: 31 36 4e 41 54 49 56 45 20 20 53 51 4c 49 54 45 16NATIVE SQLITE
6f90: 5f 55 54 46 31 36 42 45 0a 23 65 6c 69 66 20 53 _UTF16BE.#elif S
6fa0: 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 3d QLITE_BYTEORDER=
6fb0: 3d 31 32 33 34 0a 23 20 64 65 66 69 6e 65 20 53 =1234.# define S
6fc0: 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 QLITE_BIGENDIAN
6fd0: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 53 51 0.# define SQ
6fe0: 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 LITE_LITTLEENDIA
6ff0: 4e 20 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c N 1.# define SQL
7000: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 ITE_UTF16NATIVE
7010: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 0a SQLITE_UTF16LE.
7020: 23 65 6c 73 65 0a 23 20 69 66 64 65 66 20 53 51 #else.# ifdef SQ
7030: 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f LITE_AMALGAMATIO
7040: 4e 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 73 71 N. const int sq
7050: 6c 69 74 65 33 6f 6e 65 20 3d 20 31 3b 0a 23 20 lite3one = 1;.#
7060: 65 6c 73 65 0a 20 20 65 78 74 65 72 6e 20 63 6f else. extern co
7070: 6e 73 74 20 69 6e 74 20 73 71 6c 69 74 65 33 6f nst int sqlite3o
7080: 6e 65 3b 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 ne;.# endif.# de
7090: 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 45 fine SQLITE_BIGE
70a0: 4e 44 49 41 4e 20 20 20 20 28 2a 28 63 68 61 72 NDIAN (*(char
70b0: 20 2a 29 28 26 73 71 6c 69 74 65 33 6f 6e 65 29 *)(&sqlite3one)
70c0: 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 53 51 ==0).# define SQ
70d0: 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 LITE_LITTLEENDIA
70e0: 4e 20 28 2a 28 63 68 61 72 20 2a 29 28 26 73 71 N (*(char *)(&sq
70f0: 6c 69 74 65 33 6f 6e 65 29 3d 3d 31 29 0a 23 20 lite3one)==1).#
7100: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55 54 define SQLITE_UT
7110: 46 31 36 4e 41 54 49 56 45 20 20 28 53 51 4c 49 F16NATIVE (SQLI
7120: 54 45 5f 42 49 47 45 4e 44 49 41 4e 3f 53 51 4c TE_BIGENDIAN?SQL
7130: 49 54 45 5f 55 54 46 31 36 42 45 3a 53 51 4c 49 ITE_UTF16BE:SQLI
7140: 54 45 5f 55 54 46 31 36 4c 45 29 0a 23 65 6e 64 TE_UTF16LE).#end
7150: 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 61 if../*.** Consta
7160: 6e 74 73 20 66 6f 72 20 74 68 65 20 6c 61 72 67 nts for the larg
7170: 65 73 74 20 61 6e 64 20 73 6d 61 6c 6c 65 73 74 est and smallest
7180: 20 70 6f 73 73 69 62 6c 65 20 36 34 2d 62 69 74 possible 64-bit
7190: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 73 signed integers
71a0: 2e 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 6f ..** These macro
71b0: 73 20 61 72 65 20 64 65 73 69 67 6e 65 64 20 74 s are designed t
71c0: 6f 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 o work correctly
71d0: 20 6f 6e 20 62 6f 74 68 20 33 32 2d 62 69 74 20 on both 32-bit
71e0: 61 6e 64 20 36 34 2d 62 69 74 0a 2a 2a 20 63 6f and 64-bit.** co
71f0: 6d 70 69 6c 65 72 73 2e 0a 2a 2f 0a 23 64 65 66 mpilers..*/.#def
7200: 69 6e 65 20 4c 41 52 47 45 53 54 5f 49 4e 54 36 ine LARGEST_INT6
7210: 34 20 20 28 30 78 66 66 66 66 66 66 66 66 7c 28 4 (0xffffffff|(
7220: 28 28 69 36 34 29 30 78 37 66 66 66 66 66 66 66 ((i64)0x7fffffff
7230: 29 3c 3c 33 32 29 29 0a 23 64 65 66 69 6e 65 20 )<<32)).#define
7240: 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34 20 28 SMALLEST_INT64 (
7250: 28 28 69 36 34 29 2d 31 29 20 2d 20 4c 41 52 47 ((i64)-1) - LARG
7260: 45 53 54 5f 49 4e 54 36 34 29 0a 0a 2f 2a 0a 2a EST_INT64)../*.*
7270: 2a 20 52 6f 75 6e 64 20 75 70 20 61 20 6e 75 6d * Round up a num
7280: 62 65 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 ber to the next
7290: 6c 61 72 67 65 72 20 6d 75 6c 74 69 70 6c 65 20 larger multiple
72a0: 6f 66 20 38 2e 20 20 54 68 69 73 20 69 73 20 75 of 8. This is u
72b0: 73 65 64 0a 2a 2a 20 74 6f 20 66 6f 72 63 65 20 sed.** to force
72c0: 38 2d 62 79 74 65 20 61 6c 69 67 6e 6d 65 6e 74 8-byte alignment
72d0: 20 6f 6e 20 36 34 2d 62 69 74 20 61 72 63 68 69 on 64-bit archi
72e0: 74 65 63 74 75 72 65 73 2e 0a 2a 2f 0a 23 64 65 tectures..*/.#de
72f0: 66 69 6e 65 20 52 4f 55 4e 44 38 28 78 29 20 20 fine ROUND8(x)
7300: 20 20 20 28 28 28 78 29 2b 37 29 26 7e 37 29 0a (((x)+7)&~7).
7310: 0a 2f 2a 0a 2a 2a 20 52 6f 75 6e 64 20 64 6f 77 ./*.** Round dow
7320: 6e 20 74 6f 20 74 68 65 20 6e 65 61 72 65 73 74 n to the nearest
7330: 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 38 0a 2a multiple of 8.*
7340: 2f 0a 23 64 65 66 69 6e 65 20 52 4f 55 4e 44 44 /.#define ROUNDD
7350: 4f 57 4e 38 28 78 29 20 28 28 78 29 26 7e 37 29 OWN8(x) ((x)&~7)
7360: 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 65 72 74 20 74 ../*.** Assert t
7370: 68 61 74 20 74 68 65 20 70 6f 69 6e 74 65 72 20 hat the pointer
7380: 58 20 69 73 20 61 6c 69 67 6e 65 64 20 74 6f 20 X is aligned to
7390: 61 6e 20 38 2d 62 79 74 65 20 62 6f 75 6e 64 61 an 8-byte bounda
73a0: 72 79 2e 20 20 54 68 69 73 0a 2a 2a 20 6d 61 63 ry. This.** mac
73b0: 72 6f 20 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 ro is used only
73c0: 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 20 within assert()
73d0: 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74 to verify that t
73e0: 68 65 20 63 6f 64 65 20 67 65 74 73 0a 2a 2a 20 he code gets.**
73f0: 61 6c 6c 20 61 6c 69 67 6e 6d 65 6e 74 20 72 65 all alignment re
7400: 73 74 72 69 63 74 69 6f 6e 73 20 63 6f 72 72 65 strictions corre
7410: 63 74 2e 0a 2a 2a 0a 2a 2a 20 45 78 63 65 70 74 ct..**.** Except
7420: 2c 20 69 66 20 53 51 4c 49 54 45 5f 34 5f 42 59 , if SQLITE_4_BY
7430: 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f TE_ALIGNED_MALLO
7440: 43 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 C is defined, th
7450: 65 6e 20 74 68 65 0a 2a 2a 20 75 6e 64 65 72 6c en the.** underl
7460: 79 69 6e 67 20 6d 61 6c 6c 6f 63 28 29 20 69 6d ying malloc() im
7470: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 69 67 plementation mig
7480: 68 74 20 72 65 74 75 72 6e 20 75 73 20 34 2d 62 ht return us 4-b
7490: 79 74 65 20 61 6c 69 67 6e 65 64 0a 2a 2a 20 70 yte aligned.** p
74a0: 6f 69 6e 74 65 72 73 2e 20 20 49 6e 20 74 68 61 ointers. In tha
74b0: 74 20 63 61 73 65 2c 20 6f 6e 6c 79 20 76 65 72 t case, only ver
74c0: 69 66 79 20 34 2d 62 79 74 65 20 61 6c 69 67 6e ify 4-byte align
74d0: 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 ment..*/.#ifdef
74e0: 53 51 4c 49 54 45 5f 34 5f 42 59 54 45 5f 41 4c SQLITE_4_BYTE_AL
74f0: 49 47 4e 45 44 5f 4d 41 4c 4c 4f 43 0a 23 20 64 IGNED_MALLOC.# d
7500: 65 66 69 6e 65 20 45 49 47 48 54 5f 42 59 54 45 efine EIGHT_BYTE
7510: 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20 20 _ALIGNMENT(X)
7520: 28 28 28 28 63 68 61 72 2a 29 28 58 29 20 2d 20 ((((char*)(X) -
7530: 28 63 68 61 72 2a 29 30 29 26 33 29 3d 3d 30 29 (char*)0)&3)==0)
7540: 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
7550: 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e EIGHT_BYTE_ALIGN
7560: 4d 45 4e 54 28 58 29 20 20 20 28 28 28 28 63 68 MENT(X) ((((ch
7570: 61 72 2a 29 28 58 29 20 2d 20 28 63 68 61 72 2a ar*)(X) - (char*
7580: 29 30 29 26 37 29 3d 3d 30 29 0a 23 65 6e 64 69 )0)&7)==0).#endi
7590: 66 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 61 62 6c 65 f../*.** Disable
75a0: 20 4d 4d 41 50 20 6f 6e 20 70 6c 61 74 66 6f 72 MMAP on platfor
75b0: 6d 73 20 77 68 65 72 65 20 69 74 20 69 73 20 6b ms where it is k
75c0: 6e 6f 77 6e 20 74 6f 20 6e 6f 74 20 77 6f 72 6b nown to not work
75d0: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
75e0: 5f 5f 4f 70 65 6e 42 53 44 5f 5f 29 20 7c 7c 20 __OpenBSD__) ||
75f0: 64 65 66 69 6e 65 64 28 5f 5f 51 4e 58 4e 54 4f defined(__QNXNTO
7600: 5f 5f 29 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 __).# undef SQLI
7610: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
7620: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
7630: 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 _MAX_MMAP_SIZE 0
7640: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 .#endif../*.** D
7650: 65 66 61 75 6c 74 20 6d 61 78 69 6d 75 6d 20 73 efault maximum s
7660: 69 7a 65 20 6f 66 20 6d 65 6d 6f 72 79 20 75 73 ize of memory us
7670: 65 64 20 62 79 20 6d 65 6d 6f 72 79 2d 6d 61 70 ed by memory-map
7680: 70 65 64 20 49 2f 4f 20 69 6e 20 74 68 65 20 56 ped I/O in the V
7690: 46 53 0a 2a 2f 0a 23 69 66 64 65 66 20 5f 5f 41 FS.*/.#ifdef __A
76a0: 50 50 4c 45 5f 5f 0a 23 20 69 6e 63 6c 75 64 65 PPLE__.# include
76b0: 20 3c 54 61 72 67 65 74 43 6f 6e 64 69 74 69 6f <TargetConditio
76c0: 6e 61 6c 73 2e 68 3e 0a 23 65 6e 64 69 66 0a 23 nals.h>.#endif.#
76d0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 ifndef SQLITE_MA
76e0: 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 69 66 X_MMAP_SIZE.# if
76f0: 20 64 65 66 69 6e 65 64 28 5f 5f 6c 69 6e 75 78 defined(__linux
7700: 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 6e __) \. || defin
7710: 65 64 28 5f 57 49 4e 33 32 29 20 5c 0a 20 20 7c ed(_WIN32) \. |
7720: 7c 20 28 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 | (defined(__APP
7730: 4c 45 5f 5f 29 20 26 26 20 64 65 66 69 6e 65 64 LE__) && defined
7740: 28 5f 5f 4d 41 43 48 5f 5f 29 29 20 5c 0a 20 20 (__MACH__)) \.
7750: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 73 75 6e || defined(__sun
7760: 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 ) \. || defined
7770: 28 5f 5f 46 72 65 65 42 53 44 5f 5f 29 20 5c 0a (__FreeBSD__) \.
7780: 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 44 || defined(__D
7790: 72 61 67 6f 6e 46 6c 79 5f 5f 29 0a 23 20 20 20 ragonFly__).#
77a0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 define SQLITE_MA
77b0: 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 78 37 66 X_MMAP_SIZE 0x7f
77c0: 66 66 30 30 30 30 20 20 2f 2a 20 32 31 34 37 34 ff0000 /* 21474
77d0: 31 38 31 31 32 20 2a 2f 0a 23 20 65 6c 73 65 0a 18112 */.# else.
77e0: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
77f0: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 E_MAX_MMAP_SIZE
7800: 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0.# endif.#endif
7810: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 65 66 61 ../*.** The defa
7820: 75 6c 74 20 4d 4d 41 50 5f 53 49 5a 45 20 69 73 ult MMAP_SIZE is
7830: 20 7a 65 72 6f 20 6f 6e 20 61 6c 6c 20 70 6c 61 zero on all pla
7840: 74 66 6f 72 6d 73 2e 20 20 4f 72 2c 20 65 76 65 tforms. Or, eve
7850: 6e 20 69 66 20 61 20 6c 61 72 67 65 72 0a 2a 2a n if a larger.**
7860: 20 64 65 66 61 75 6c 74 20 4d 4d 41 50 5f 53 49 default MMAP_SI
7870: 5a 45 20 69 73 20 73 70 65 63 69 66 69 65 64 20 ZE is specified
7880: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2c at compile-time,
7890: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 make sure that
78a0: 69 74 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 it does.** not e
78b0: 78 63 65 65 64 20 74 68 65 20 6d 61 78 69 6d 75 xceed the maximu
78c0: 6d 20 6d 6d 61 70 20 73 69 7a 65 2e 0a 2a 2f 0a m mmap size..*/.
78d0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
78e0: 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 EFAULT_MMAP_SIZE
78f0: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
7900: 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 _DEFAULT_MMAP_SI
7910: 5a 45 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 ZE 0.#endif.#if
7920: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
7930: 4d 41 50 5f 53 49 5a 45 3e 53 51 4c 49 54 45 5f MAP_SIZE>SQLITE_
7940: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 MAX_MMAP_SIZE.#
7950: 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 undef SQLITE_DEF
7960: 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 AULT_MMAP_SIZE.#
7970: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 define SQLITE_D
7980: 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 EFAULT_MMAP_SIZE
7990: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
79a0: 5f 53 49 5a 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a _SIZE.#endif../*
79b0: 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20 6f 66 20 .** Only one of
79c0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
79d0: 41 54 33 20 6f 72 20 53 51 4c 49 54 45 5f 45 4e AT3 or SQLITE_EN
79e0: 41 42 4c 45 5f 53 54 41 54 34 20 63 61 6e 20 62 ABLE_STAT4 can b
79f0: 65 20 64 65 66 69 6e 65 64 2e 0a 2a 2a 20 50 72 e defined..** Pr
7a00: 69 6f 72 69 74 79 20 69 73 20 67 69 76 65 6e 20 iority is given
7a10: 74 6f 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 to SQLITE_ENABLE
7a20: 5f 53 54 41 54 34 2e 20 20 49 66 20 65 69 74 68 _STAT4. If eith
7a30: 65 72 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 er are defined,
7a40: 61 6c 73 6f 0a 2a 2a 20 64 65 66 69 6e 65 20 53 also.** define S
7a50: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
7a60: 54 33 5f 4f 52 5f 53 54 41 54 34 0a 2a 2f 0a 23 T3_OR_STAT4.*/.#
7a70: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
7a80: 42 4c 45 5f 53 54 41 54 34 0a 23 20 75 6e 64 65 BLE_STAT4.# unde
7a90: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
7aa0: 53 54 41 54 33 0a 23 20 64 65 66 69 6e 65 20 53 STAT3.# define S
7ab0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
7ac0: 54 33 5f 4f 52 5f 53 54 41 54 34 20 31 0a 23 65 T3_OR_STAT4 1.#e
7ad0: 6c 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c lif SQLITE_ENABL
7ae0: 45 5f 53 54 41 54 33 0a 23 20 64 65 66 69 6e 65 E_STAT3.# define
7af0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
7b00: 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 20 31 0a TAT3_OR_STAT4 1.
7b10: 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 #elif SQLITE_ENA
7b20: 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 BLE_STAT3_OR_STA
7b30: 54 34 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 T4.# undef SQLIT
7b40: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f E_ENABLE_STAT3_O
7b50: 52 5f 53 54 41 54 34 0a 23 65 6e 64 69 66 0a 0a R_STAT4.#endif..
7b60: 2f 2a 0a 2a 2a 20 53 45 4c 45 43 54 54 52 41 43 /*.** SELECTTRAC
7b70: 45 5f 45 4e 41 42 4c 45 44 20 77 69 6c 6c 20 62 E_ENABLED will b
7b80: 65 20 65 69 74 68 65 72 20 31 20 6f 72 20 30 20 e either 1 or 0
7b90: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 depending on whe
7ba0: 74 68 65 72 20 6f 72 20 6e 6f 74 0a 2a 2a 20 74 ther or not.** t
7bb0: 68 65 20 53 65 6c 65 63 74 20 71 75 65 72 79 20 he Select query
7bc0: 67 65 6e 65 72 61 74 6f 72 20 74 72 61 63 69 6e generator tracin
7bd0: 67 20 6c 6f 67 69 63 20 69 73 20 74 75 72 6e 65 g logic is turne
7be0: 64 20 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 d on..*/.#if def
7bf0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
7c00: 4c 45 5f 53 45 4c 45 43 54 54 52 41 43 45 29 0a LE_SELECTTRACE).
7c10: 23 20 64 65 66 69 6e 65 20 53 45 4c 45 43 54 54 # define SELECTT
7c20: 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 31 0a 23 RACE_ENABLED 1.#
7c30: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53 45 else.# define SE
7c40: 4c 45 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 LECTTRACE_ENABLE
7c50: 44 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a D 0.#endif../*.*
7c60: 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
7c70: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
7c80: 74 72 75 63 74 75 72 65 20 69 73 20 75 73 65 64 tructure is used
7c90: 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 62 75 to store the bu
7ca0: 73 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 sy-handler.** ca
7cb0: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 20 67 69 76 llback for a giv
7cc0: 65 6e 20 73 71 6c 69 74 65 20 68 61 6e 64 6c 65 en sqlite handle
7cd0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 ..**.** The sqli
7ce0: 74 65 2e 62 75 73 79 48 61 6e 64 6c 65 72 20 6d te.busyHandler m
7cf0: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 73 71 6c ember of the sql
7d00: 69 74 65 20 73 74 72 75 63 74 20 63 6f 6e 74 61 ite struct conta
7d10: 69 6e 73 20 74 68 65 20 62 75 73 79 0a 2a 2a 20 ins the busy.**
7d20: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 74 68 65 callback for the
7d30: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
7d40: 2e 20 45 61 63 68 20 70 61 67 65 72 20 6f 70 65 . Each pager ope
7d50: 6e 65 64 20 76 69 61 20 74 68 65 20 73 71 6c 69 ned via the sqli
7d60: 74 65 0a 2a 2a 20 68 61 6e 64 6c 65 20 69 73 20 te.** handle is
7d70: 70 61 73 73 65 64 20 61 20 70 6f 69 6e 74 65 72 passed a pointer
7d80: 20 74 6f 20 73 71 6c 69 74 65 2e 62 75 73 79 48 to sqlite.busyH
7d90: 61 6e 64 6c 65 72 2e 20 54 68 65 20 62 75 73 79 andler. The busy
7da0: 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c -handler.** call
7db0: 62 61 63 6b 20 69 73 20 63 75 72 72 65 6e 74 6c back is currentl
7dc0: 79 20 69 6e 76 6f 6b 65 64 20 6f 6e 6c 79 20 66 y invoked only f
7dd0: 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 67 65 72 rom within pager
7de0: 2e 63 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 .c..*/.typedef s
7df0: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
7e00: 72 20 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a 73 r BusyHandler;.s
7e10: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
7e20: 72 20 7b 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 r {. int (*xBus
7e30: 79 48 61 6e 64 6c 65 72 29 28 76 6f 69 64 20 2a yHandler)(void *
7e40: 2c 69 6e 74 29 3b 20 20 2f 2a 20 54 68 65 20 62 ,int); /* The b
7e50: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a usy callback */.
7e60: 20 20 76 6f 69 64 20 2a 70 42 75 73 79 41 72 67 void *pBusyArg
7e70: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7e80: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
7e90: 20 74 6f 20 62 75 73 79 20 63 61 6c 6c 62 61 63 to busy callbac
7ea0: 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 73 79 k */. int nBusy
7eb0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7ec0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 63 72 /* Incr
7ed0: 65 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 emented with eac
7ee0: 68 20 62 75 73 79 20 63 61 6c 6c 20 2a 2f 0a 20 h busy call */.
7ef0: 20 75 38 20 62 45 78 74 72 61 46 69 6c 65 41 72 u8 bExtraFileAr
7f00: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
7f10: 20 20 20 2f 2a 20 49 6e 63 6c 75 64 65 20 73 71 /* Include sq
7f20: 6c 69 74 65 33 5f 66 69 6c 65 20 61 73 20 63 61 lite3_file as ca
7f30: 6c 6c 62 61 63 6b 20 61 72 67 20 2a 2f 0a 7d 3b llback arg */.};
7f40: 0a 0a 2f 2a 0a 2a 2a 20 4e 61 6d 65 20 6f 66 20 ../*.** Name of
7f50: 74 68 65 20 6d 61 73 74 65 72 20 64 61 74 61 62 the master datab
7f60: 61 73 65 20 74 61 62 6c 65 2e 20 20 54 68 65 20 ase table. The
7f70: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 master database
7f80: 74 61 62 6c 65 0a 2a 2a 20 69 73 20 61 20 73 70 table.** is a sp
7f90: 65 63 69 61 6c 20 74 61 62 6c 65 20 74 68 61 74 ecial table that
7fa0: 20 68 6f 6c 64 73 20 74 68 65 20 6e 61 6d 65 73 holds the names
7fb0: 20 61 6e 64 20 61 74 74 72 69 62 75 74 65 73 20 and attributes
7fc0: 6f 66 20 61 6c 6c 0a 2a 2a 20 75 73 65 72 20 74 of all.** user t
7fd0: 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 ables and indice
7fe0: 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 s..*/.#define MA
7ff0: 53 54 45 52 5f 4e 41 4d 45 20 20 20 20 20 20 20 STER_NAME
8000: 22 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 0a "sqlite_master".
8010: 23 64 65 66 69 6e 65 20 54 45 4d 50 5f 4d 41 53 #define TEMP_MAS
8020: 54 45 52 5f 4e 41 4d 45 20 20 22 73 71 6c 69 74 TER_NAME "sqlit
8030: 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 22 0a 0a e_temp_master"..
8040: 2f 2a 0a 2a 2a 20 54 68 65 20 72 6f 6f 74 2d 70 /*.** The root-p
8050: 61 67 65 20 6f 66 20 74 68 65 20 6d 61 73 74 65 age of the maste
8060: 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 r database table
8070: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 ..*/.#define MAS
8080: 54 45 52 5f 52 4f 4f 54 20 20 20 20 20 20 20 31 TER_ROOT 1
8090: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e 61 6d 65 ../*.** The name
80a0: 20 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 74 of the schema t
80b0: 61 62 6c 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 able..*/.#define
80c0: 20 53 43 48 45 4d 41 5f 54 41 42 4c 45 28 78 29 SCHEMA_TABLE(x)
80d0: 20 20 28 28 21 4f 4d 49 54 5f 54 45 4d 50 44 42 ((!OMIT_TEMPDB
80e0: 29 26 26 28 78 3d 3d 31 29 3f 54 45 4d 50 5f 4d )&&(x==1)?TEMP_M
80f0: 41 53 54 45 52 5f 4e 41 4d 45 3a 4d 41 53 54 45 ASTER_NAME:MASTE
8100: 52 5f 4e 41 4d 45 29 0a 0a 2f 2a 0a 2a 2a 20 41 R_NAME)../*.** A
8110: 20 63 6f 6e 76 65 6e 69 65 6e 63 65 20 6d 61 63 convenience mac
8120: 72 6f 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 ro that returns
8130: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6c the number of el
8140: 65 6d 65 6e 74 73 20 69 6e 0a 2a 2a 20 61 6e 20 ements in.** an
8150: 61 72 72 61 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e array..*/.#defin
8160: 65 20 41 72 72 61 79 53 69 7a 65 28 58 29 20 20 e ArraySize(X)
8170: 20 20 28 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 ((int)(sizeof(
8180: 58 29 2f 73 69 7a 65 6f 66 28 58 5b 30 5d 29 29 X)/sizeof(X[0]))
8190: 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 )../*.** Determi
81a0: 6e 65 20 69 66 20 74 68 65 20 61 72 67 75 6d 65 ne if the argume
81b0: 6e 74 20 69 73 20 61 20 70 6f 77 65 72 20 6f 66 nt is a power of
81c0: 20 74 77 6f 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 two.*/.#define
81d0: 49 73 50 6f 77 65 72 4f 66 54 77 6f 28 58 29 20 IsPowerOfTwo(X)
81e0: 28 28 28 58 29 26 28 28 58 29 2d 31 29 29 3d 3d (((X)&((X)-1))==
81f0: 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 0)../*.** The fo
8200: 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 65 20 61 73 llowing value as
8210: 20 61 20 64 65 73 74 72 75 63 74 6f 72 20 6d 65 a destructor me
8220: 61 6e 73 20 74 6f 20 75 73 65 20 73 71 6c 69 74 ans to use sqlit
8230: 65 33 44 62 46 72 65 65 28 29 2e 0a 2a 2a 20 54 e3DbFree()..** T
8240: 68 65 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 he sqlite3DbFree
8250: 28 29 20 72 6f 75 74 69 6e 65 20 72 65 71 75 69 () routine requi
8260: 72 65 73 20 74 77 6f 20 70 61 72 61 6d 65 74 65 res two paramete
8270: 72 73 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 rs instead of th
8280: 65 0a 2a 2a 20 6f 6e 65 20 70 61 72 61 6d 65 74 e.** one paramet
8290: 65 72 20 74 68 61 74 20 64 65 73 74 72 75 63 74 er that destruct
82a0: 6f 72 73 20 6e 6f 72 6d 61 6c 6c 79 20 77 61 6e ors normally wan
82b0: 74 2e 20 20 53 6f 20 77 65 20 68 61 76 65 20 74 t. So we have t
82c0: 6f 20 69 6e 74 72 6f 64 75 63 65 0a 2a 2a 20 74 o introduce.** t
82d0: 68 69 73 20 6d 61 67 69 63 20 76 61 6c 75 65 20 his magic value
82e0: 74 68 61 74 20 74 68 65 20 63 6f 64 65 20 6b 6e that the code kn
82f0: 6f 77 73 20 74 6f 20 68 61 6e 64 6c 65 20 64 69 ows to handle di
8300: 66 66 65 72 65 6e 74 6c 79 2e 20 20 41 6e 79 0a fferently. Any.
8310: 2a 2a 20 70 6f 69 6e 74 65 72 20 77 69 6c 6c 20 ** pointer will
8320: 77 6f 72 6b 20 68 65 72 65 20 61 73 20 6c 6f 6e work here as lon
8330: 67 20 61 73 20 69 74 20 69 73 20 64 69 73 74 69 g as it is disti
8340: 6e 63 74 20 66 72 6f 6d 20 53 51 4c 49 54 45 5f nct from SQLITE_
8350: 53 54 41 54 49 43 0a 2a 2a 20 61 6e 64 20 53 51 STATIC.** and SQ
8360: 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 2e 0a LITE_TRANSIENT..
8370: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
8380: 45 5f 44 59 4e 41 4d 49 43 20 20 20 28 28 73 71 E_DYNAMIC ((sq
8390: 6c 69 74 65 33 5f 64 65 73 74 72 75 63 74 6f 72 lite3_destructor
83a0: 5f 74 79 70 65 29 73 71 6c 69 74 65 33 4d 61 6c _type)sqlite3Mal
83b0: 6c 6f 63 53 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 locSize)../*.**
83c0: 57 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4d 49 54 When SQLITE_OMIT
83d0: 5f 57 53 44 20 69 73 20 64 65 66 69 6e 65 64 2c _WSD is defined,
83e0: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 it means that t
83f0: 68 65 20 74 61 72 67 65 74 20 70 6c 61 74 66 6f he target platfo
8400: 72 6d 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 73 rm does.** not s
8410: 75 70 70 6f 72 74 20 57 72 69 74 61 62 6c 65 20 upport Writable
8420: 53 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 Static Data (WSD
8430: 29 20 73 75 63 68 20 61 73 20 67 6c 6f 62 61 6c ) such as global
8440: 20 61 6e 64 20 73 74 61 74 69 63 20 76 61 72 69 and static vari
8450: 61 62 6c 65 73 2e 0a 2a 2a 20 41 6c 6c 20 76 61 ables..** All va
8460: 72 69 61 62 6c 65 73 20 6d 75 73 74 20 65 69 74 riables must eit
8470: 68 65 72 20 62 65 20 6f 6e 20 74 68 65 20 73 74 her be on the st
8480: 61 63 6b 20 6f 72 20 64 79 6e 61 6d 69 63 61 6c ack or dynamical
8490: 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f ly allocated fro
84a0: 6d 0a 2a 2a 20 74 68 65 20 68 65 61 70 2e 20 20 m.** the heap.
84b0: 57 68 65 6e 20 57 53 44 20 69 73 20 75 6e 73 75 When WSD is unsu
84c0: 70 70 6f 72 74 65 64 2c 20 74 68 65 20 76 61 72 pported, the var
84d0: 69 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f iable declaratio
84e0: 6e 73 20 73 63 61 74 74 65 72 65 64 0a 2a 2a 20 ns scattered.**
84f0: 74 68 72 6f 75 67 68 6f 75 74 20 74 68 65 20 53 throughout the S
8500: 51 4c 69 74 65 20 63 6f 64 65 20 6d 75 73 74 20 QLite code must
8510: 62 65 63 6f 6d 65 20 63 6f 6e 73 74 61 6e 74 73 become constants
8520: 20 69 6e 73 74 65 61 64 2e 20 20 54 68 65 20 53 instead. The S
8530: 51 4c 49 54 45 5f 57 53 44 0a 2a 2a 20 6d 61 63 QLITE_WSD.** mac
8540: 72 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 ro is used for t
8550: 68 69 73 20 70 75 72 70 6f 73 65 2e 20 20 41 6e his purpose. An
8560: 64 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 66 d instead of ref
8570: 65 72 65 6e 63 69 6e 67 20 74 68 65 20 76 61 72 erencing the var
8580: 69 61 62 6c 65 0a 2a 2a 20 64 69 72 65 63 74 6c iable.** directl
8590: 79 2c 20 77 65 20 75 73 65 20 69 74 73 20 63 6f y, we use its co
85a0: 6e 73 74 61 6e 74 20 61 73 20 61 20 6b 65 79 20 nstant as a key
85b0: 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 72 75 to lookup the ru
85c0: 6e 2d 74 69 6d 65 20 61 6c 6c 6f 63 61 74 65 64 n-time allocated
85d0: 0a 2a 2a 20 62 75 66 66 65 72 20 74 68 61 74 20 .** buffer that
85e0: 68 6f 6c 64 73 20 72 65 61 6c 20 76 61 72 69 61 holds real varia
85f0: 62 6c 65 2e 20 20 54 68 65 20 63 6f 6e 73 74 61 ble. The consta
8600: 6e 74 20 69 73 20 61 6c 73 6f 20 74 68 65 20 69 nt is also the i
8610: 6e 69 74 69 61 6c 69 7a 65 72 0a 2a 2a 20 66 6f nitializer.** fo
8620: 72 20 74 68 65 20 72 75 6e 2d 74 69 6d 65 20 61 r the run-time a
8630: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e llocated buffer.
8640: 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 75 73 .**.** In the us
8650: 75 61 6c 20 63 61 73 65 20 77 68 65 72 65 20 57 ual case where W
8660: 53 44 20 69 73 20 73 75 70 70 6f 72 74 65 64 2c SD is supported,
8670: 20 74 68 65 20 53 51 4c 49 54 45 5f 57 53 44 20 the SQLITE_WSD
8680: 61 6e 64 20 47 4c 4f 42 41 4c 0a 2a 2a 20 6d 61 and GLOBAL.** ma
8690: 63 72 6f 73 20 62 65 63 6f 6d 65 20 6e 6f 2d 6f cros become no-o
86a0: 70 73 20 61 6e 64 20 68 61 76 65 20 7a 65 72 6f ps and have zero
86b0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70 performance imp
86c0: 61 63 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 act..*/.#ifdef S
86d0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 QLITE_OMIT_WSD.
86e0: 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f #define SQLITE_
86f0: 57 53 44 20 63 6f 6e 73 74 0a 20 20 23 64 65 66 WSD const. #def
8700: 69 6e 65 20 47 4c 4f 42 41 4c 28 74 2c 76 29 20 ine GLOBAL(t,v)
8710: 28 2a 28 74 2a 29 73 71 6c 69 74 65 33 5f 77 73 (*(t*)sqlite3_ws
8720: 64 5f 66 69 6e 64 28 28 76 6f 69 64 2a 29 26 28 d_find((void*)&(
8730: 76 29 2c 20 73 69 7a 65 6f 66 28 76 29 29 29 0a v), sizeof(v))).
8740: 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
8750: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20 47 4c 3GlobalConfig GL
8760: 4f 42 41 4c 28 73 74 72 75 63 74 20 53 71 6c 69 OBAL(struct Sqli
8770: 74 65 33 43 6f 6e 66 69 67 2c 20 73 71 6c 69 74 te3Config, sqlit
8780: 65 33 43 6f 6e 66 69 67 29 0a 20 20 69 6e 74 20 e3Config). int
8790: 73 71 6c 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 sqlite3_wsd_init
87a0: 28 69 6e 74 20 4e 2c 20 69 6e 74 20 4a 29 3b 0a (int N, int J);.
87b0: 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f void *sqlite3_
87c0: 77 73 64 5f 66 69 6e 64 28 76 6f 69 64 20 2a 4b wsd_find(void *K
87d0: 2c 20 69 6e 74 20 4c 29 3b 0a 23 65 6c 73 65 0a , int L);.#else.
87e0: 20 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 #define SQLITE
87f0: 5f 57 53 44 0a 20 20 23 64 65 66 69 6e 65 20 47 _WSD. #define G
8800: 4c 4f 42 41 4c 28 74 2c 76 29 20 76 0a 20 20 23 LOBAL(t,v) v. #
8810: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 6c define sqlite3Gl
8820: 6f 62 61 6c 43 6f 6e 66 69 67 20 73 71 6c 69 74 obalConfig sqlit
8830: 65 33 43 6f 6e 66 69 67 0a 23 65 6e 64 69 66 0a e3Config.#endif.
8840: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
8850: 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 65 20 wing macros are
8860: 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 used to suppress
8870: 20 63 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e compiler warnin
8880: 67 73 20 61 6e 64 20 74 6f 0a 2a 2a 20 6d 61 6b gs and to.** mak
8890: 65 20 69 74 20 63 6c 65 61 72 20 74 6f 20 68 75 e it clear to hu
88a0: 6d 61 6e 20 72 65 61 64 65 72 73 20 77 68 65 6e man readers when
88b0: 20 61 20 66 75 6e 63 74 69 6f 6e 20 70 61 72 61 a function para
88c0: 6d 65 74 65 72 20 69 73 20 64 65 6c 69 62 65 72 meter is deliber
88d0: 61 74 65 6c 79 0a 2a 2a 20 6c 65 66 74 20 75 6e ately.** left un
88e0: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 used within the
88f0: 62 6f 64 79 20 6f 66 20 61 20 66 75 6e 63 74 69 body of a functi
8900: 6f 6e 2e 20 54 68 69 73 20 75 73 75 61 6c 6c 79 on. This usually
8910: 20 68 61 70 70 65 6e 73 20 77 68 65 6e 0a 2a 2a happens when.**
8920: 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 a function is c
8930: 61 6c 6c 65 64 20 76 69 61 20 61 20 66 75 6e 63 alled via a func
8940: 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e 20 46 6f tion pointer. Fo
8950: 72 20 65 78 61 6d 70 6c 65 20 74 68 65 0a 2a 2a r example the.**
8960: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
8970: 6f 66 20 61 6e 20 53 51 4c 20 61 67 67 72 65 67 of an SQL aggreg
8980: 61 74 65 20 73 74 65 70 20 63 61 6c 6c 62 61 63 ate step callbac
8990: 6b 20 6d 61 79 20 6e 6f 74 20 75 73 65 20 74 68 k may not use th
89a0: 65 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69 e.** parameter i
89b0: 6e 64 69 63 61 74 69 6e 67 20 74 68 65 20 6e 75 ndicating the nu
89c0: 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
89d0: 73 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 s passed to the
89e0: 61 67 67 72 65 67 61 74 65 2c 0a 2a 2a 20 69 66 aggregate,.** if
89f0: 20 69 74 20 6b 6e 6f 77 73 20 74 68 61 74 20 74 it knows that t
8a00: 68 69 73 20 69 73 20 65 6e 66 6f 72 63 65 64 20 his is enforced
8a10: 65 6c 73 65 77 68 65 72 65 2e 0a 2a 2a 0a 2a 2a elsewhere..**.**
8a20: 20 57 68 65 6e 20 61 20 66 75 6e 63 74 69 6f 6e When a function
8a30: 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f parameter is no
8a40: 74 20 75 73 65 64 20 61 74 20 61 6c 6c 20 77 69 t used at all wi
8a50: 74 68 69 6e 20 74 68 65 20 62 6f 64 79 20 6f 66 thin the body of
8a60: 20 61 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 a function,.**
8a70: 69 74 20 69 73 20 67 65 6e 65 72 61 6c 6c 79 20 it is generally
8a80: 6e 61 6d 65 64 20 22 4e 6f 74 55 73 65 64 22 20 named "NotUsed"
8a90: 6f 72 20 22 4e 6f 74 55 73 65 64 32 22 20 74 6f or "NotUsed2" to
8aa0: 20 6d 61 6b 65 20 74 68 69 6e 67 73 20 65 76 65 make things eve
8ab0: 6e 20 63 6c 65 61 72 65 72 2e 0a 2a 2a 20 48 6f n clearer..** Ho
8ac0: 77 65 76 65 72 2c 20 74 68 65 73 65 20 6d 61 63 wever, these mac
8ad0: 72 6f 73 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 ros may also be
8ae0: 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 used to suppress
8af0: 20 77 61 72 6e 69 6e 67 73 20 72 65 6c 61 74 65 warnings relate
8b00: 64 20 74 6f 0a 2a 2a 20 70 61 72 61 6d 65 74 65 d to.** paramete
8b10: 72 73 20 74 68 61 74 20 6d 61 79 20 6f 72 20 6d rs that may or m
8b20: 61 79 20 6e 6f 74 20 62 65 20 75 73 65 64 20 64 ay not be used d
8b30: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f 6d 70 epending on comp
8b40: 69 6c 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 2e ilation options.
8b50: 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 .** For example
8b60: 74 68 6f 73 65 20 70 61 72 61 6d 65 74 65 72 73 those parameters
8b70: 20 6f 6e 6c 79 20 75 73 65 64 20 69 6e 20 61 73 only used in as
8b80: 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
8b90: 73 2e 20 49 6e 20 74 68 65 73 65 0a 2a 2a 20 63 s. In these.** c
8ba0: 61 73 65 73 20 74 68 65 20 70 61 72 61 6d 65 74 ases the paramet
8bb0: 65 72 73 20 61 72 65 20 6e 61 6d 65 64 20 61 73 ers are named as
8bc0: 20 70 65 72 20 74 68 65 20 75 73 75 61 6c 20 63 per the usual c
8bd0: 6f 6e 76 65 6e 74 69 6f 6e 73 2e 0a 2a 2f 0a 23 onventions..*/.#
8be0: 64 65 66 69 6e 65 20 55 4e 55 53 45 44 5f 50 41 define UNUSED_PA
8bf0: 52 41 4d 45 54 45 52 28 78 29 20 28 76 6f 69 64 RAMETER(x) (void
8c00: 29 28 78 29 0a 23 64 65 66 69 6e 65 20 55 4e 55 )(x).#define UNU
8c10: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 78 SED_PARAMETER2(x
8c20: 2c 79 29 20 55 4e 55 53 45 44 5f 50 41 52 41 4d ,y) UNUSED_PARAM
8c30: 45 54 45 52 28 78 29 2c 55 4e 55 53 45 44 5f 50 ETER(x),UNUSED_P
8c40: 41 52 41 4d 45 54 45 52 28 79 29 0a 0a 2f 2a 0a ARAMETER(y)../*.
8c50: 2a 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 ** Forward refer
8c60: 65 6e 63 65 73 20 74 6f 20 73 74 72 75 63 74 75 ences to structu
8c70: 72 65 73 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 res.*/.typedef s
8c80: 74 72 75 63 74 20 41 67 67 49 6e 66 6f 20 41 67 truct AggInfo Ag
8c90: 67 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 gInfo;.typedef s
8ca0: 74 72 75 63 74 20 41 75 74 68 43 6f 6e 74 65 78 truct AuthContex
8cb0: 74 20 41 75 74 68 43 6f 6e 74 65 78 74 3b 0a 74 t AuthContext;.t
8cc0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 41 75 ypedef struct Au
8cd0: 74 6f 69 6e 63 49 6e 66 6f 20 41 75 74 6f 69 6e toincInfo Autoin
8ce0: 63 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 cInfo;.typedef s
8cf0: 74 72 75 63 74 20 42 69 74 76 65 63 20 42 69 74 truct Bitvec Bit
8d00: 76 65 63 3b 0a 74 79 70 65 64 65 66 20 73 74 72 vec;.typedef str
8d10: 75 63 74 20 43 6f 6c 6c 53 65 71 20 43 6f 6c 6c uct CollSeq Coll
8d20: 53 65 71 3b 0a 74 79 70 65 64 65 66 20 73 74 72 Seq;.typedef str
8d30: 75 63 74 20 43 6f 6c 75 6d 6e 20 43 6f 6c 75 6d uct Column Colum
8d40: 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 n;.typedef struc
8d50: 74 20 44 62 20 44 62 3b 0a 74 79 70 65 64 65 66 t Db Db;.typedef
8d60: 20 73 74 72 75 63 74 20 53 63 68 65 6d 61 20 53 struct Schema S
8d70: 63 68 65 6d 61 3b 0a 74 79 70 65 64 65 66 20 73 chema;.typedef s
8d80: 74 72 75 63 74 20 45 78 70 72 20 45 78 70 72 3b truct Expr Expr;
8d90: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8da0: 45 78 70 72 4c 69 73 74 20 45 78 70 72 4c 69 73 ExprList ExprLis
8db0: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
8dc0: 74 20 46 4b 65 79 20 46 4b 65 79 3b 0a 74 79 70 t FKey FKey;.typ
8dd0: 65 64 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 edef struct Func
8de0: 44 65 73 74 72 75 63 74 6f 72 20 46 75 6e 63 44 Destructor FuncD
8df0: 65 73 74 72 75 63 74 6f 72 3b 0a 74 79 70 65 64 estructor;.typed
8e00: 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 44 65 ef struct FuncDe
8e10: 66 20 46 75 6e 63 44 65 66 3b 0a 74 79 70 65 64 f FuncDef;.typed
8e20: 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 44 65 ef struct FuncDe
8e30: 66 48 61 73 68 20 46 75 6e 63 44 65 66 48 61 73 fHash FuncDefHas
8e40: 68 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 h;.typedef struc
8e50: 74 20 49 64 4c 69 73 74 20 49 64 4c 69 73 74 3b t IdList IdList;
8e60: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8e70: 49 6e 64 65 78 20 49 6e 64 65 78 3b 0a 74 79 70 Index Index;.typ
8e80: 65 64 65 66 20 73 74 72 75 63 74 20 49 6e 64 65 edef struct Inde
8e90: 78 53 61 6d 70 6c 65 20 49 6e 64 65 78 53 61 6d xSample IndexSam
8ea0: 70 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ple;.typedef str
8eb0: 75 63 74 20 4b 65 79 43 6c 61 73 73 20 4b 65 79 uct KeyClass Key
8ec0: 43 6c 61 73 73 3b 0a 74 79 70 65 64 65 66 20 73 Class;.typedef s
8ed0: 74 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 4b 65 truct KeyInfo Ke
8ee0: 79 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 yInfo;.typedef s
8ef0: 74 72 75 63 74 20 4c 6f 6f 6b 61 73 69 64 65 20 truct Lookaside
8f00: 4c 6f 6f 6b 61 73 69 64 65 3b 0a 74 79 70 65 64 Lookaside;.typed
8f10: 65 66 20 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 ef struct Lookas
8f20: 69 64 65 53 6c 6f 74 20 4c 6f 6f 6b 61 73 69 64 ideSlot Lookasid
8f30: 65 53 6c 6f 74 3b 0a 74 79 70 65 64 65 66 20 73 eSlot;.typedef s
8f40: 74 72 75 63 74 20 4d 6f 64 75 6c 65 20 4d 6f 64 truct Module Mod
8f50: 75 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ule;.typedef str
8f60: 75 63 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 uct NameContext
8f70: 4e 61 6d 65 43 6f 6e 74 65 78 74 3b 0a 74 79 70 NameContext;.typ
8f80: 65 64 65 66 20 73 74 72 75 63 74 20 50 61 72 73 edef struct Pars
8f90: 65 20 50 61 72 73 65 3b 0a 74 79 70 65 64 65 66 e Parse;.typedef
8fa0: 20 73 74 72 75 63 74 20 50 72 65 55 70 64 61 74 struct PreUpdat
8fb0: 65 20 50 72 65 55 70 64 61 74 65 3b 0a 74 79 70 e PreUpdate;.typ
8fc0: 65 64 65 66 20 73 74 72 75 63 74 20 50 72 69 6e edef struct Prin
8fd0: 74 66 41 72 67 75 6d 65 6e 74 73 20 50 72 69 6e tfArguments Prin
8fe0: 74 66 41 72 67 75 6d 65 6e 74 73 3b 0a 74 79 70 tfArguments;.typ
8ff0: 65 64 65 66 20 73 74 72 75 63 74 20 52 6f 77 53 edef struct RowS
9000: 65 74 20 52 6f 77 53 65 74 3b 0a 74 79 70 65 64 et RowSet;.typed
9010: 65 66 20 73 74 72 75 63 74 20 53 61 76 65 70 6f ef struct Savepo
9020: 69 6e 74 20 53 61 76 65 70 6f 69 6e 74 3b 0a 74 int Savepoint;.t
9030: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 65 ypedef struct Se
9040: 6c 65 63 74 20 53 65 6c 65 63 74 3b 0a 74 79 70 lect Select;.typ
9050: 65 64 65 66 20 73 74 72 75 63 74 20 53 51 4c 69 edef struct SQLi
9060: 74 65 54 68 72 65 61 64 20 53 51 4c 69 74 65 54 teThread SQLiteT
9070: 68 72 65 61 64 3b 0a 74 79 70 65 64 65 66 20 73 hread;.typedef s
9080: 74 72 75 63 74 20 53 65 6c 65 63 74 44 65 73 74 truct SelectDest
9090: 20 53 65 6c 65 63 74 44 65 73 74 3b 0a 74 79 70 SelectDest;.typ
90a0: 65 64 65 66 20 73 74 72 75 63 74 20 53 72 63 4c edef struct SrcL
90b0: 69 73 74 20 53 72 63 4c 69 73 74 3b 0a 74 79 70 ist SrcList;.typ
90c0: 65 64 65 66 20 73 74 72 75 63 74 20 53 74 72 41 edef struct StrA
90d0: 63 63 75 6d 20 53 74 72 41 63 63 75 6d 3b 0a 74 ccum StrAccum;.t
90e0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 54 61 ypedef struct Ta
90f0: 62 6c 65 20 54 61 62 6c 65 3b 0a 74 79 70 65 64 ble Table;.typed
9100: 65 66 20 73 74 72 75 63 74 20 54 61 62 6c 65 4c ef struct TableL
9110: 6f 63 6b 20 54 61 62 6c 65 4c 6f 63 6b 3b 0a 74 ock TableLock;.t
9120: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 54 6f ypedef struct To
9130: 6b 65 6e 20 54 6f 6b 65 6e 3b 0a 74 79 70 65 64 ken Token;.typed
9140: 65 66 20 73 74 72 75 63 74 20 54 72 65 65 56 69 ef struct TreeVi
9150: 65 77 20 54 72 65 65 56 69 65 77 3b 0a 74 79 70 ew TreeView;.typ
9160: 65 64 65 66 20 73 74 72 75 63 74 20 54 72 69 67 edef struct Trig
9170: 67 65 72 20 54 72 69 67 67 65 72 3b 0a 74 79 70 ger Trigger;.typ
9180: 65 64 65 66 20 73 74 72 75 63 74 20 54 72 69 67 edef struct Trig
9190: 67 65 72 50 72 67 20 54 72 69 67 67 65 72 50 72 gerPrg TriggerPr
91a0: 67 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 g;.typedef struc
91b0: 74 20 54 72 69 67 67 65 72 53 74 65 70 20 54 72 t TriggerStep Tr
91c0: 69 67 67 65 72 53 74 65 70 3b 0a 74 79 70 65 64 iggerStep;.typed
91d0: 65 66 20 73 74 72 75 63 74 20 55 6e 70 61 63 6b ef struct Unpack
91e0: 65 64 52 65 63 6f 72 64 20 55 6e 70 61 63 6b 65 edRecord Unpacke
91f0: 64 52 65 63 6f 72 64 3b 0a 74 79 70 65 64 65 66 dRecord;.typedef
9200: 20 73 74 72 75 63 74 20 55 70 73 65 72 74 20 55 struct Upsert U
9210: 70 73 65 72 74 3b 0a 74 79 70 65 64 65 66 20 73 psert;.typedef s
9220: 74 72 75 63 74 20 56 54 61 62 6c 65 20 56 54 61 truct VTable VTa
9230: 62 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ble;.typedef str
9240: 75 63 74 20 56 74 61 62 43 74 78 20 56 74 61 62 uct VtabCtx Vtab
9250: 43 74 78 3b 0a 74 79 70 65 64 65 66 20 73 74 72 Ctx;.typedef str
9260: 75 63 74 20 57 61 6c 6b 65 72 20 57 61 6c 6b 65 uct Walker Walke
9270: 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 r;.typedef struc
9280: 74 20 57 68 65 72 65 49 6e 66 6f 20 57 68 65 72 t WhereInfo Wher
9290: 65 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 eInfo;.typedef s
92a0: 74 72 75 63 74 20 57 69 74 68 20 57 69 74 68 3b truct With With;
92b0: 0a 0a 2f 2a 20 41 20 56 4c 69 73 74 20 6f 62 6a ../* A VList obj
92c0: 65 63 74 20 72 65 63 6f 72 64 73 20 61 20 6d 61 ect records a ma
92d0: 70 70 69 6e 67 20 62 65 74 77 65 65 6e 20 70 61 pping between pa
92e0: 72 61 6d 65 74 65 72 73 2f 76 61 72 69 61 62 6c rameters/variabl
92f0: 65 73 2f 77 69 6c 64 63 61 72 64 73 0a 2a 2a 20 es/wildcards.**
9300: 69 6e 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 in the SQL state
9310: 6d 65 6e 74 20 28 73 75 63 68 20 61 73 20 24 61 ment (such as $a
9320: 62 63 2c 20 40 70 71 72 2c 20 6f 72 20 3a 78 79 bc, @pqr, or :xy
9330: 7a 29 20 61 6e 64 20 74 68 65 20 69 6e 74 65 67 z) and the integ
9340: 65 72 0a 2a 2a 20 76 61 72 69 61 62 6c 65 20 6e er.** variable n
9350: 75 6d 62 65 72 20 61 73 73 6f 63 69 61 74 65 64 umber associated
9360: 20 77 69 74 68 20 74 68 61 74 20 70 61 72 61 6d with that param
9370: 65 74 65 72 2e 20 20 53 65 65 20 74 68 65 20 66 eter. See the f
9380: 6f 72 6d 61 74 20 64 65 73 63 72 69 70 74 69 6f ormat descriptio
9390: 6e 0a 2a 2a 20 6f 6e 20 74 68 65 20 73 71 6c 69 n.** on the sqli
93a0: 74 65 33 56 4c 69 73 74 41 64 64 28 29 20 72 6f te3VListAdd() ro
93b0: 75 74 69 6e 65 20 66 6f 72 20 6d 6f 72 65 20 69 utine for more i
93c0: 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 41 20 56 nformation. A V
93d0: 4c 69 73 74 20 69 73 20 72 65 61 6c 6c 79 0a 2a List is really.*
93e0: 2a 20 6a 75 73 74 20 61 6e 20 61 72 72 61 79 20 * just an array
93f0: 6f 66 20 69 6e 74 65 67 65 72 73 2e 0a 2a 2f 0a of integers..*/.
9400: 74 79 70 65 64 65 66 20 69 6e 74 20 56 4c 69 73 typedef int VLis
9410: 74 3b 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 65 72 20 t;../*.** Defer
9420: 73 6f 75 72 63 69 6e 67 20 76 64 62 65 2e 68 20 sourcing vdbe.h
9430: 61 6e 64 20 62 74 72 65 65 2e 68 20 75 6e 74 69 and btree.h unti
9440: 6c 20 61 66 74 65 72 20 74 68 65 20 22 75 38 22 l after the "u8"
9450: 20 61 6e 64 0a 2a 2a 20 22 42 75 73 79 48 61 6e and.** "BusyHan
9460: 64 6c 65 72 22 20 74 79 70 65 64 65 66 73 2e 20 dler" typedefs.
9470: 76 64 62 65 2e 68 20 61 6c 73 6f 20 72 65 71 75 vdbe.h also requ
9480: 69 72 65 73 20 61 20 66 65 77 20 6f 66 20 74 68 ires a few of th
9490: 65 20 6f 70 61 71 75 65 0a 2a 2a 20 70 6f 69 6e e opaque.** poin
94a0: 74 65 72 20 74 79 70 65 73 20 28 69 2e 65 2e 20 ter types (i.e.
94b0: 46 75 6e 63 44 65 66 29 20 64 65 66 69 6e 65 64 FuncDef) defined
94c0: 20 61 62 6f 76 65 2e 0a 2a 2f 0a 23 69 6e 63 6c above..*/.#incl
94d0: 75 64 65 20 22 62 74 72 65 65 2e 68 22 0a 23 69 ude "btree.h".#i
94e0: 6e 63 6c 75 64 65 20 22 76 64 62 65 2e 68 22 0a nclude "vdbe.h".
94f0: 23 69 6e 63 6c 75 64 65 20 22 70 61 67 65 72 2e #include "pager.
9500: 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 70 63 61 h".#include "pca
9510: 63 68 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 che.h".#include
9520: 22 6f 73 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 "os.h".#include
9530: 22 6d 75 74 65 78 2e 68 22 0a 0a 2f 2a 20 54 68 "mutex.h"../* Th
9540: 65 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 44 e SQLITE_EXTRA_D
9550: 55 52 41 42 4c 45 20 63 6f 6d 70 69 6c 65 2d 74 URABLE compile-t
9560: 69 6d 65 20 6f 70 74 69 6f 6e 20 75 73 65 64 20 ime option used
9570: 74 6f 20 73 65 74 20 74 68 65 20 64 65 66 61 75 to set the defau
9580: 6c 74 0a 2a 2a 20 73 79 6e 63 68 72 6f 6e 6f 75 lt.** synchronou
9590: 73 20 73 65 74 74 69 6e 67 20 74 6f 20 45 58 54 s setting to EXT
95a0: 52 41 2e 20 20 49 74 20 69 73 20 6e 6f 20 6c 6f RA. It is no lo
95b0: 6e 67 65 72 20 73 75 70 70 6f 72 74 65 64 2e 0a nger supported..
95c0: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
95d0: 5f 45 58 54 52 41 5f 44 55 52 41 42 4c 45 0a 23 _EXTRA_DURABLE.#
95e0: 20 77 61 72 6e 69 6e 67 20 55 73 65 20 53 51 4c warning Use SQL
95f0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 ITE_DEFAULT_SYNC
9600: 48 52 4f 4e 4f 55 53 3d 33 20 69 6e 73 74 65 61 HRONOUS=3 instea
9610: 64 20 6f 66 20 53 51 4c 49 54 45 5f 45 58 54 52 d of SQLITE_EXTR
9620: 41 5f 44 55 52 41 42 4c 45 0a 23 20 64 65 66 69 A_DURABLE.# defi
9630: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
9640: 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 33 0a T_SYNCHRONOUS 3.
9650: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 #endif../*.** De
9660: 66 61 75 6c 74 20 73 79 6e 63 68 72 6f 6e 6f 75 fault synchronou
9670: 73 20 6c 65 76 65 6c 73 2e 0a 2a 2a 0a 2a 2a 20 s levels..**.**
9680: 4e 6f 74 65 20 74 68 61 74 20 28 66 6f 72 20 68 Note that (for h
9690: 69 73 74 6f 72 63 61 6c 20 72 65 61 73 6f 6e 73 istorcal reasons
96a0: 29 20 74 68 65 20 50 41 47 45 52 5f 53 59 4e 43 ) the PAGER_SYNC
96b0: 48 52 4f 4e 4f 55 53 5f 2a 20 6d 61 63 72 6f 73 HRONOUS_* macros
96c0: 20 64 69 66 66 65 72 0a 2a 2a 20 66 72 6f 6d 20 differ.** from
96d0: 74 68 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 the SQLITE_DEFAU
96e0: 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 76 LT_SYNCHRONOUS v
96f0: 61 6c 75 65 20 62 79 20 31 2e 0a 2a 2a 0a 2a 2a alue by 1..**.**
9700: 20 20 20 20 20 20 20 20 20 20 20 50 41 47 45 52 PAGER
9710: 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 20 20 20 _SYNCHRONOUS
9720: 20 20 20 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 DEFAULT_SYNCH
9730: 52 4f 4e 4f 55 53 0a 2a 2a 20 20 20 4f 46 46 20 RONOUS.** OFF
9740: 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 20 1
9750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9760: 20 20 20 20 30 0a 2a 2a 20 20 20 4e 4f 52 4d 41 0.** NORMA
9770: 4c 20 20 20 20 20 20 20 20 32 20 20 20 20 20 20 L 2
9780: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9790: 20 20 20 31 0a 2a 2a 20 20 20 46 55 4c 4c 20 20 1.** FULL
97a0: 20 20 20 20 20 20 20 20 33 20 20 20 20 20 20 20 3
97b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
97c0: 20 20 32 0a 2a 2a 20 20 20 45 58 54 52 41 20 20 2.** EXTRA
97d0: 20 20 20 20 20 20 20 34 20 20 20 20 20 20 20 20 4
97e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
97f0: 20 33 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22 50 52 3.**.** The "PR
9800: 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 AGMA synchronous
9810: 22 20 73 74 61 74 65 6d 65 6e 74 20 61 6c 73 6f " statement also
9820: 20 75 73 65 73 20 74 68 65 20 7a 65 72 6f 2d 62 uses the zero-b
9830: 61 73 65 64 20 6e 75 6d 62 65 72 73 2e 0a 2a 2a ased numbers..**
9840: 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c In other words,
9850: 20 74 68 65 20 7a 65 72 6f 2d 62 61 73 65 64 20 the zero-based
9860: 6e 75 6d 62 65 72 73 20 61 72 65 20 75 73 65 64 numbers are used
9870: 20 66 6f 72 20 61 6c 6c 20 65 78 74 65 72 6e 61 for all externa
9880: 6c 20 69 6e 74 65 72 66 61 63 65 73 0a 2a 2a 20 l interfaces.**
9890: 61 6e 64 20 74 68 65 20 6f 6e 65 2d 62 61 73 65 and the one-base
98a0: 64 20 76 61 6c 75 65 73 20 61 72 65 20 75 73 65 d values are use
98b0: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 2a 2f d internally..*/
98c0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
98d0: 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f 4e DEFAULT_SYNCHRON
98e0: 4f 55 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c OUS.# define SQL
98f0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 ITE_DEFAULT_SYNC
9900: 48 52 4f 4e 4f 55 53 20 32 0a 23 65 6e 64 69 66 HRONOUS 2.#endif
9910: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
9920: 44 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 4e 43 DEFAULT_WAL_SYNC
9930: 48 52 4f 4e 4f 55 53 0a 23 20 64 65 66 69 6e 65 HRONOUS.# define
9940: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
9950: 57 41 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 WAL_SYNCHRONOUS
9960: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 SQLITE_DEFAULT_S
9970: 59 4e 43 48 52 4f 4e 4f 55 53 0a 23 65 6e 64 69 YNCHRONOUS.#endi
9980: 66 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 64 61 f../*.** Each da
9990: 74 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 62 tabase file to b
99a0: 65 20 61 63 63 65 73 73 65 64 20 62 79 20 74 68 e accessed by th
99b0: 65 20 73 79 73 74 65 6d 20 69 73 20 61 6e 20 69 e system is an i
99c0: 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 nstance.** of th
99d0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 e following stru
99e0: 63 74 75 72 65 2e 20 20 54 68 65 72 65 20 61 72 cture. There ar
99f0: 65 20 6e 6f 72 6d 61 6c 6c 79 20 74 77 6f 20 6f e normally two o
9a00: 66 20 74 68 65 73 65 20 73 74 72 75 63 74 75 72 f these structur
9a10: 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 73 71 6c es.** in the sql
9a20: 69 74 65 2e 61 44 62 5b 5d 20 61 72 72 61 79 2e ite.aDb[] array.
9a30: 20 20 61 44 62 5b 30 5d 20 69 73 20 74 68 65 20 aDb[0] is the
9a40: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 main database fi
9a50: 6c 65 20 61 6e 64 0a 2a 2a 20 61 44 62 5b 31 5d le and.** aDb[1]
9a60: 20 69 73 20 74 68 65 20 64 61 74 61 62 61 73 65 is the database
9a70: 20 66 69 6c 65 20 75 73 65 64 20 74 6f 20 68 6f file used to ho
9a80: 6c 64 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 ld temporary tab
9a90: 6c 65 73 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c les. Additional
9aa0: 0a 2a 2a 20 64 61 74 61 62 61 73 65 73 20 6d 61 .** databases ma
9ab0: 79 20 62 65 20 61 74 74 61 63 68 65 64 2e 0a 2a y be attached..*
9ac0: 2f 0a 73 74 72 75 63 74 20 44 62 20 7b 0a 20 20 /.struct Db {.
9ad0: 63 68 61 72 20 2a 7a 44 62 53 4e 61 6d 65 3b 20 char *zDbSName;
9ae0: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
9af0: 74 68 69 73 20 64 61 74 61 62 61 73 65 2e 20 28 this database. (
9b00: 73 63 68 65 6d 61 20 6e 61 6d 65 2c 20 6e 6f 74 schema name, not
9b10: 20 66 69 6c 65 6e 61 6d 65 29 20 2a 2f 0a 20 20 filename) */.
9b20: 42 74 72 65 65 20 2a 70 42 74 3b 20 20 20 20 20 Btree *pBt;
9b30: 20 20 20 20 20 2f 2a 20 54 68 65 20 42 2a 54 72 /* The B*Tr
9b40: 65 65 20 73 74 72 75 63 74 75 72 65 20 66 6f 72 ee structure for
9b50: 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 66 this database f
9b60: 69 6c 65 20 2a 2f 0a 20 20 75 38 20 73 61 66 65 ile */. u8 safe
9b70: 74 79 5f 6c 65 76 65 6c 3b 20 20 20 20 20 2f 2a ty_level; /*
9b80: 20 48 6f 77 20 61 67 67 72 65 73 73 69 76 65 20 How aggressive
9b90: 61 74 20 73 79 6e 63 69 6e 67 20 64 61 74 61 20 at syncing data
9ba0: 74 6f 20 64 69 73 6b 20 2a 2f 0a 20 20 75 38 20 to disk */. u8
9bb0: 62 53 79 6e 63 53 65 74 3b 20 20 20 20 20 20 20 bSyncSet;
9bc0: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 22 50 52 /* True if "PR
9bd0: 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 AGMA synchronous
9be0: 3d 4e 22 20 68 61 73 20 62 65 65 6e 20 72 75 6e =N" has been run
9bf0: 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 */. Schema *pS
9c00: 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 50 6f chema; /* Po
9c10: 69 6e 74 65 72 20 74 6f 20 64 61 74 61 62 61 73 inter to databas
9c20: 65 20 73 63 68 65 6d 61 20 28 70 6f 73 73 69 62 e schema (possib
9c30: 6c 79 20 73 68 61 72 65 64 29 20 2a 2f 0a 7d 3b ly shared) */.};
9c40: 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 ../*.** An insta
9c50: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
9c60: 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 73 wing structure s
9c70: 74 6f 72 65 73 20 61 20 64 61 74 61 62 61 73 65 tores a database
9c80: 20 73 63 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 4d schema..**.** M
9c90: 6f 73 74 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 ost Schema objec
9ca0: 74 73 20 61 72 65 20 61 73 73 6f 63 69 61 74 65 ts are associate
9cb0: 64 20 77 69 74 68 20 61 20 42 74 72 65 65 2e 20 d with a Btree.
9cc0: 20 54 68 65 20 65 78 63 65 70 74 69 6f 6e 20 69 The exception i
9cd0: 73 0a 2a 2a 20 74 68 65 20 53 63 68 65 6d 61 20 s.** the Schema
9ce0: 66 6f 72 20 74 68 65 20 54 45 4d 50 20 64 61 74 for the TEMP dat
9cf0: 61 62 61 65 73 20 28 73 71 6c 69 74 65 33 2e 61 abaes (sqlite3.a
9d00: 44 62 5b 31 5d 29 20 77 68 69 63 68 20 69 73 20 Db[1]) which is
9d10: 66 72 65 65 2d 73 74 61 6e 64 69 6e 67 2e 0a 2a free-standing..*
9d20: 2a 20 49 6e 20 73 68 61 72 65 64 20 63 61 63 68 * In shared cach
9d30: 65 20 6d 6f 64 65 2c 20 61 20 73 69 6e 67 6c 65 e mode, a single
9d40: 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 74 20 63 Schema object c
9d50: 61 6e 20 62 65 20 73 68 61 72 65 64 20 62 79 20 an be shared by
9d60: 6d 75 6c 74 69 70 6c 65 0a 2a 2a 20 42 74 72 65 multiple.** Btre
9d70: 65 73 20 74 68 61 74 20 72 65 66 65 72 20 74 6f es that refer to
9d80: 20 74 68 65 20 73 61 6d 65 20 75 6e 64 65 72 6c the same underl
9d90: 79 69 6e 67 20 42 74 53 68 61 72 65 64 20 6f 62 ying BtShared ob
9da0: 6a 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 53 63 68 65 ject..**.** Sche
9db0: 6d 61 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 ma objects are a
9dc0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 61 utomatically dea
9dd0: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68 llocated when th
9de0: 65 20 6c 61 73 74 20 42 74 72 65 65 20 74 68 61 e last Btree tha
9df0: 74 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 20 t.** references
9e00: 74 68 65 6d 20 69 73 20 64 65 73 74 72 6f 79 65 them is destroye
9e10: 64 2e 20 20 20 54 68 65 20 54 45 4d 50 20 53 63 d. The TEMP Sc
9e20: 68 65 6d 61 20 69 73 20 6d 61 6e 75 61 6c 6c 79 hema is manually
9e30: 20 66 72 65 65 64 20 62 79 0a 2a 2a 20 73 71 6c freed by.** sql
9e40: 69 74 65 33 5f 63 6c 6f 73 65 28 29 2e 0a 2a 0a ite3_close()..*.
9e50: 2a 2a 20 41 20 74 68 72 65 61 64 20 6d 75 73 74 ** A thread must
9e60: 20 62 65 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 be holding a mu
9e70: 74 65 78 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 tex on the corre
9e80: 73 70 6f 6e 64 69 6e 67 20 42 74 72 65 65 20 69 sponding Btree i
9e90: 6e 20 6f 72 64 65 72 0a 2a 2a 20 74 6f 20 61 63 n order.** to ac
9ea0: 63 65 73 73 20 53 63 68 65 6d 61 20 63 6f 6e 74 cess Schema cont
9eb0: 65 6e 74 2e 20 20 54 68 69 73 20 69 6d 70 6c 69 ent. This impli
9ec0: 65 73 20 74 68 61 74 20 74 68 65 20 74 68 72 65 es that the thre
9ed0: 61 64 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 0a ad must also be.
9ee0: 2a 2a 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 74 ** holding a mut
9ef0: 65 78 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 65 ex on the sqlite
9f00: 33 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 3 connection poi
9f10: 6e 74 65 72 20 74 68 61 74 20 6f 77 6e 73 20 74 nter that owns t
9f20: 68 65 20 42 74 72 65 65 2e 0a 2a 2a 20 46 6f 72 he Btree..** For
9f30: 20 61 20 54 45 4d 50 20 53 63 68 65 6d 61 2c 20 a TEMP Schema,
9f40: 6f 6e 6c 79 20 74 68 65 20 63 6f 6e 6e 65 63 74 only the connect
9f50: 69 6f 6e 20 6d 75 74 65 78 20 69 73 20 72 65 71 ion mutex is req
9f60: 75 69 72 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 uired..*/.struct
9f70: 20 53 63 68 65 6d 61 20 7b 0a 20 20 69 6e 74 20 Schema {. int
9f80: 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 3b 20 20 schema_cookie;
9f90: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 73 63 68 /* Database sch
9fa0: 65 6d 61 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 ema version numb
9fb0: 65 72 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 er for this file
9fc0: 20 2a 2f 0a 20 20 69 6e 74 20 69 47 65 6e 65 72 */. int iGener
9fd0: 61 74 69 6f 6e 3b 20 20 20 20 20 2f 2a 20 47 65 ation; /* Ge
9fe0: 6e 65 72 61 74 69 6f 6e 20 63 6f 75 6e 74 65 72 neration counter
9ff0: 2e 20 20 49 6e 63 72 65 6d 65 6e 74 65 64 20 77 . Incremented w
a000: 69 74 68 20 65 61 63 68 20 63 68 61 6e 67 65 20 ith each change
a010: 2a 2f 0a 20 20 48 61 73 68 20 74 62 6c 48 61 73 */. Hash tblHas
a020: 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c h; /* All
a030: 20 74 61 62 6c 65 73 20 69 6e 64 65 78 65 64 20 tables indexed
a040: 62 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 73 by name */. Has
a050: 68 20 69 64 78 48 61 73 68 3b 20 20 20 20 20 20 h idxHash;
a060: 20 20 2f 2a 20 41 6c 6c 20 28 6e 61 6d 65 64 29 /* All (named)
a070: 20 69 6e 64 69 63 65 73 20 69 6e 64 65 78 65 64 indices indexed
a080: 20 62 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 by name */. Ha
a090: 73 68 20 74 72 69 67 48 61 73 68 3b 20 20 20 20 sh trigHash;
a0a0: 20 20 20 2f 2a 20 41 6c 6c 20 74 72 69 67 67 65 /* All trigge
a0b0: 72 73 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 rs indexed by na
a0c0: 6d 65 20 2a 2f 0a 20 20 48 61 73 68 20 66 6b 65 me */. Hash fke
a0d0: 79 48 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 yHash; /*
a0e0: 41 6c 6c 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 All foreign keys
a0f0: 20 62 79 20 72 65 66 65 72 65 6e 63 65 64 20 74 by referenced t
a100: 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 54 able name */. T
a110: 61 62 6c 65 20 2a 70 53 65 71 54 61 62 3b 20 20 able *pSeqTab;
a120: 20 20 20 20 2f 2a 20 54 68 65 20 73 71 6c 69 74 /* The sqlit
a130: 65 5f 73 65 71 75 65 6e 63 65 20 74 61 62 6c 65 e_sequence table
a140: 20 75 73 65 64 20 62 79 20 41 55 54 4f 49 4e 43 used by AUTOINC
a150: 52 45 4d 45 4e 54 20 2a 2f 0a 20 20 75 38 20 66 REMENT */. u8 f
a160: 69 6c 65 5f 66 6f 72 6d 61 74 3b 20 20 20 20 20 ile_format;
a170: 20 2f 2a 20 53 63 68 65 6d 61 20 66 6f 72 6d 61 /* Schema forma
a180: 74 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 74 68 t version for th
a190: 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 is file */. u8
a1a0: 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 enc;
a1b0: 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 /* Text encodi
a1c0: 6e 67 20 75 73 65 64 20 62 79 20 74 68 69 73 20 ng used by this
a1d0: 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 31 database */. u1
a1e0: 36 20 73 63 68 65 6d 61 46 6c 61 67 73 3b 20 20 6 schemaFlags;
a1f0: 20 20 20 2f 2a 20 46 6c 61 67 73 20 61 73 73 6f /* Flags asso
a200: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69 73 ciated with this
a210: 20 73 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 schema */. int
a220: 20 63 61 63 68 65 5f 73 69 7a 65 3b 20 20 20 20 cache_size;
a230: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
a240: 61 67 65 73 20 74 6f 20 75 73 65 20 69 6e 20 74 ages to use in t
a250: 68 65 20 63 61 63 68 65 20 2a 2f 0a 7d 3b 0a 0a he cache */.};..
a260: 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 /*.** These macr
a270: 6f 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 os can be used t
a280: 6f 20 74 65 73 74 2c 20 73 65 74 2c 20 6f 72 20 o test, set, or
a290: 63 6c 65 61 72 20 62 69 74 73 20 69 6e 20 74 68 clear bits in th
a2a0: 65 0a 2a 2a 20 44 62 2e 70 53 63 68 65 6d 61 2d e.** Db.pSchema-
a2b0: 3e 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f >flags field..*/
a2c0: 0a 23 64 65 66 69 6e 65 20 44 62 48 61 73 50 72 .#define DbHasPr
a2d0: 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 20 operty(D,I,P)
a2e0: 20 20 28 28 28 44 29 2d 3e 61 44 62 5b 49 5d 2e (((D)->aDb[I].
a2f0: 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 46 pSchema->schemaF
a300: 6c 61 67 73 26 28 50 29 29 3d 3d 28 50 29 29 0a lags&(P))==(P)).
a310: 23 64 65 66 69 6e 65 20 44 62 48 61 73 41 6e 79 #define DbHasAny
a320: 50 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 20 Property(D,I,P)
a330: 20 28 28 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 (((D)->aDb[I].p
a340: 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 46 6c Schema->schemaFl
a350: 61 67 73 26 28 50 29 29 21 3d 30 29 0a 23 64 65 ags&(P))!=0).#de
a360: 66 69 6e 65 20 44 62 53 65 74 50 72 6f 70 65 72 fine DbSetProper
a370: 74 79 28 44 2c 49 2c 50 29 20 20 20 20 20 28 44 ty(D,I,P) (D
a380: 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d )->aDb[I].pSchem
a390: 61 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 7c 3d a->schemaFlags|=
a3a0: 28 50 29 0a 23 64 65 66 69 6e 65 20 44 62 43 6c (P).#define DbCl
a3b0: 65 61 72 50 72 6f 70 65 72 74 79 28 44 2c 49 2c earProperty(D,I,
a3c0: 50 29 20 20 20 28 44 29 2d 3e 61 44 62 5b 49 5d P) (D)->aDb[I]
a3d0: 2e 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 .pSchema->schema
a3e0: 46 6c 61 67 73 26 3d 7e 28 50 29 0a 0a 2f 2a 0a Flags&=~(P)../*.
a3f0: 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 ** Allowed value
a400: 73 20 66 6f 72 20 74 68 65 20 44 42 2e 70 53 63 s for the DB.pSc
a410: 68 65 6d 61 2d 3e 66 6c 61 67 73 20 66 69 65 6c hema->flags fiel
a420: 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 44 42 5f d..**.** The DB_
a430: 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 66 6c 61 SchemaLoaded fla
a440: 67 20 69 73 20 73 65 74 20 61 66 74 65 72 20 74 g is set after t
a450: 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 he database sche
a460: 6d 61 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 72 ma has been.** r
a470: 65 61 64 20 69 6e 74 6f 20 69 6e 74 65 72 6e 61 ead into interna
a480: 6c 20 68 61 73 68 20 74 61 62 6c 65 73 2e 0a 2a l hash tables..*
a490: 2a 0a 2a 2a 20 44 42 5f 55 6e 72 65 73 65 74 56 *.** DB_UnresetV
a4a0: 69 65 77 73 20 6d 65 61 6e 73 20 74 68 61 74 20 iews means that
a4b0: 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 76 69 65 77 one or more view
a4c0: 73 20 68 61 76 65 20 63 6f 6c 75 6d 6e 20 6e 61 s have column na
a4d0: 6d 65 73 20 74 68 61 74 0a 2a 2a 20 68 61 76 65 mes that.** have
a4e0: 20 62 65 65 6e 20 66 69 6c 6c 65 64 20 6f 75 74 been filled out
a4f0: 2e 20 20 49 66 20 74 68 65 20 73 63 68 65 6d 61 . If the schema
a500: 20 63 68 61 6e 67 65 73 2c 20 74 68 65 73 65 20 changes, these
a510: 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 6d 69 67 column names mig
a520: 68 74 0a 2a 2a 20 63 68 61 6e 67 65 73 20 61 6e ht.** changes an
a530: 64 20 73 6f 20 74 68 65 20 76 69 65 77 20 77 69 d so the view wi
a540: 6c 6c 20 6e 65 65 64 20 74 6f 20 62 65 20 72 65 ll need to be re
a550: 73 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 set..*/.#define
a560: 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 DB_SchemaLoaded
a570: 20 20 20 30 78 30 30 30 31 20 20 2f 2a 20 54 68 0x0001 /* Th
a580: 65 20 73 63 68 65 6d 61 20 68 61 73 20 62 65 65 e schema has bee
a590: 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a 23 64 65 66 n loaded */.#def
a5a0: 69 6e 65 20 44 42 5f 55 6e 72 65 73 65 74 56 69 ine DB_UnresetVi
a5b0: 65 77 73 20 20 20 20 30 78 30 30 30 32 20 20 2f ews 0x0002 /
a5c0: 2a 20 53 6f 6d 65 20 76 69 65 77 73 20 68 61 76 * Some views hav
a5d0: 65 20 64 65 66 69 6e 65 64 20 63 6f 6c 75 6d 6e e defined column
a5e0: 20 6e 61 6d 65 73 20 2a 2f 0a 23 64 65 66 69 6e names */.#defin
a5f0: 65 20 44 42 5f 45 6d 70 74 79 20 20 20 20 20 20 e DB_Empty
a600: 20 20 20 20 20 30 78 30 30 30 34 20 20 2f 2a 20 0x0004 /*
a610: 54 68 65 20 66 69 6c 65 20 69 73 20 65 6d 70 74 The file is empt
a620: 79 20 28 6c 65 6e 67 74 68 20 30 20 62 79 74 65 y (length 0 byte
a630: 73 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 s) */.#define DB
a640: 5f 52 65 73 65 74 57 61 6e 74 65 64 20 20 20 20 _ResetWanted
a650: 20 30 78 30 30 30 38 20 20 2f 2a 20 52 65 73 65 0x0008 /* Rese
a660: 74 20 74 68 65 20 73 63 68 65 6d 61 20 77 68 65 t the schema whe
a670: 6e 20 6e 53 63 68 65 6d 61 4c 6f 63 6b 3d 3d 30 n nSchemaLock==0
a680: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e */../*.** The n
a690: 75 6d 62 65 72 20 6f 66 20 64 69 66 66 65 72 65 umber of differe
a6a0: 6e 74 20 6b 69 6e 64 73 20 6f 66 20 74 68 69 6e nt kinds of thin
a6b0: 67 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 6c gs that can be l
a6c0: 69 6d 69 74 65 64 0a 2a 2a 20 75 73 69 6e 67 20 imited.** using
a6d0: 74 68 65 20 73 71 6c 69 74 65 33 5f 6c 69 6d 69 the sqlite3_limi
a6e0: 74 28 29 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a t() interface..*
a6f0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
a700: 5f 4e 5f 4c 49 4d 49 54 20 28 53 51 4c 49 54 45 _N_LIMIT (SQLITE
a710: 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 48 _LIMIT_WORKER_TH
a720: 52 45 41 44 53 2b 31 29 0a 0a 2f 2a 0a 2a 2a 20 READS+1)../*.**
a730: 4c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f 63 Lookaside malloc
a740: 20 69 73 20 61 20 73 65 74 20 6f 66 20 66 69 78 is a set of fix
a750: 65 64 2d 73 69 7a 65 20 62 75 66 66 65 72 73 20 ed-size buffers
a760: 74 68 61 74 20 63 61 6e 20 62 65 20 75 73 65 64 that can be used
a770: 0a 2a 2a 20 74 6f 20 73 61 74 69 73 66 79 20 73 .** to satisfy s
a780: 6d 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 6d mall transient m
a790: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
a7a0: 20 72 65 71 75 65 73 74 73 20 66 6f 72 20 6f 62 requests for ob
a7b0: 6a 65 63 74 73 0a 2a 2a 20 61 73 73 6f 63 69 61 jects.** associa
a7c0: 74 65 64 20 77 69 74 68 20 61 20 70 61 72 74 69 ted with a parti
a7d0: 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 63 cular database c
a7e0: 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 54 68 65 20 onnection. The
a7f0: 75 73 65 20 6f 66 0a 2a 2a 20 6c 6f 6f 6b 61 73 use of.** lookas
a800: 69 64 65 20 6d 61 6c 6c 6f 63 20 70 72 6f 76 69 ide malloc provi
a810: 64 65 73 20 61 20 73 69 67 6e 69 66 69 63 61 6e des a significan
a820: 74 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 65 6e t performance en
a830: 68 61 6e 63 65 6d 65 6e 74 0a 2a 2a 20 28 61 70 hancement.** (ap
a840: 70 72 6f 78 20 31 30 25 29 20 62 79 20 61 76 6f prox 10%) by avo
a850: 69 64 69 6e 67 20 6e 75 6d 65 72 6f 75 73 20 6d iding numerous m
a860: 61 6c 6c 6f 63 2f 66 72 65 65 20 72 65 71 75 65 alloc/free reque
a870: 73 74 73 20 77 68 69 6c 65 20 70 61 72 73 69 6e sts while parsin
a880: 67 0a 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 g.** SQL stateme
a890: 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4c nts..**.** The L
a8a0: 6f 6f 6b 61 73 69 64 65 20 73 74 72 75 63 74 75 ookaside structu
a8b0: 72 65 20 68 6f 6c 64 73 20 63 6f 6e 66 69 67 75 re holds configu
a8c0: 72 61 74 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 ration informati
a8d0: 6f 6e 20 61 62 6f 75 74 20 74 68 65 0a 2a 2a 20 on about the.**
a8e0: 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f 63 lookaside malloc
a8f0: 20 73 75 62 73 79 73 74 65 6d 2e 20 20 45 61 63 subsystem. Eac
a900: 68 20 61 76 61 69 6c 61 62 6c 65 20 6d 65 6d 6f h available memo
a910: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 6e ry allocation in
a920: 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 .** the lookasid
a930: 65 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 73 e subsystem is s
a940: 74 6f 72 65 64 20 6f 6e 20 61 20 6c 69 6e 6b 65 tored on a linke
a950: 64 20 6c 69 73 74 20 6f 66 20 4c 6f 6f 6b 61 73 d list of Lookas
a960: 69 64 65 53 6c 6f 74 0a 2a 2a 20 6f 62 6a 65 63 ideSlot.** objec
a970: 74 73 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 ts..**.** Lookas
a980: 69 64 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 ide allocations
a990: 61 72 65 20 6f 6e 6c 79 20 61 6c 6c 6f 77 65 64 are only allowed
a9a0: 20 66 6f 72 20 6f 62 6a 65 63 74 73 20 74 68 61 for objects tha
a9b0: 74 20 61 72 65 20 61 73 73 6f 63 69 61 74 65 64 t are associated
a9c0: 0a 2a 2a 20 77 69 74 68 20 61 20 70 61 72 74 69 .** with a parti
a9d0: 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 63 cular database c
a9e0: 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 48 65 6e 63 onnection. Henc
a9f0: 65 2c 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d e, schema inform
aa00: 61 74 69 6f 6e 20 63 61 6e 6e 6f 74 0a 2a 2a 20 ation cannot.**
aa10: 62 65 20 73 74 6f 72 65 64 20 69 6e 20 6c 6f 6f be stored in loo
aa20: 6b 61 73 69 64 65 20 62 65 63 61 75 73 65 20 69 kaside because i
aa30: 6e 20 73 68 61 72 65 64 20 63 61 63 68 65 20 6d n shared cache m
aa40: 6f 64 65 20 74 68 65 20 73 63 68 65 6d 61 20 69 ode the schema i
aa50: 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 69 73 nformation.** is
aa60: 20 73 68 61 72 65 64 20 62 79 20 6d 75 6c 74 69 shared by multi
aa70: 70 6c 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e ple database con
aa80: 6e 65 63 74 69 6f 6e 73 2e 20 20 54 68 65 72 65 nections. There
aa90: 66 6f 72 65 2c 20 77 68 69 6c 65 20 70 61 72 73 fore, while pars
aaa0: 69 6e 67 0a 2a 2a 20 73 63 68 65 6d 61 20 69 6e ing.** schema in
aab0: 66 6f 72 6d 61 74 69 6f 6e 2c 20 74 68 65 20 4c formation, the L
aac0: 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 ookaside.bEnable
aad0: 64 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 65 d flag is cleare
aae0: 64 20 73 6f 20 74 68 61 74 0a 2a 2a 20 6c 6f 6f d so that.** loo
aaf0: 6b 61 73 69 64 65 20 61 6c 6c 6f 63 61 74 69 6f kaside allocatio
ab00: 6e 73 20 61 72 65 20 6e 6f 74 20 75 73 65 64 20 ns are not used
ab10: 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 74 68 65 to construct the
ab20: 20 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 2e schema objects.
ab30: 0a 2a 2f 0a 73 74 72 75 63 74 20 4c 6f 6f 6b 61 .*/.struct Looka
ab40: 73 69 64 65 20 7b 0a 20 20 75 33 32 20 62 44 69 side {. u32 bDi
ab50: 73 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 sable;
ab60: 20 2f 2a 20 4f 6e 6c 79 20 6f 70 65 72 61 74 65 /* Only operate
ab70: 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 77 the lookaside w
ab80: 68 65 6e 20 7a 65 72 6f 20 2a 2f 0a 20 20 75 31 hen zero */. u1
ab90: 36 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20 20 6 sz;
aba0: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
abb0: 20 65 61 63 68 20 62 75 66 66 65 72 20 69 6e 20 each buffer in
abc0: 62 79 74 65 73 20 2a 2f 0a 20 20 75 38 20 62 4d bytes */. u8 bM
abd0: 61 6c 6c 6f 63 65 64 3b 20 20 20 20 20 20 20 20 alloced;
abe0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 70 53 /* True if pS
abf0: 74 61 72 74 20 6f 62 74 61 69 6e 65 64 20 66 72 tart obtained fr
ac00: 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f om sqlite3_mallo
ac10: 63 28 29 20 2a 2f 0a 20 20 75 33 32 20 6e 53 6c c() */. u32 nSl
ac20: 6f 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ot;
ac30: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 6f /* Number of lo
ac40: 6f 6b 61 73 69 64 65 20 73 6c 6f 74 73 20 61 6c okaside slots al
ac50: 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 75 33 32 located */. u32
ac60: 20 61 6e 53 74 61 74 5b 33 5d 3b 20 20 20 20 20 anStat[3];
ac70: 20 20 20 20 20 2f 2a 20 30 3a 20 68 69 74 73 2e /* 0: hits.
ac80: 20 20 31 3a 20 73 69 7a 65 20 6d 69 73 73 65 73 1: size misses
ac90: 2e 20 20 32 3a 20 66 75 6c 6c 20 6d 69 73 73 65 . 2: full misse
aca0: 73 20 2a 2f 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 s */. Lookaside
acb0: 53 6c 6f 74 20 2a 70 49 6e 69 74 3b 20 20 20 2f Slot *pInit; /
acc0: 2a 20 4c 69 73 74 20 6f 66 20 62 75 66 66 65 72 * List of buffer
acd0: 73 20 6e 6f 74 20 70 72 65 76 69 6f 75 73 6c 79 s not previously
ace0: 20 75 73 65 64 20 2a 2f 0a 20 20 4c 6f 6f 6b 61 used */. Looka
acf0: 73 69 64 65 53 6c 6f 74 20 2a 70 46 72 65 65 3b sideSlot *pFree;
ad00: 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 61 76 /* List of av
ad10: 61 69 6c 61 62 6c 65 20 62 75 66 66 65 72 73 20 ailable buffers
ad20: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 61 72 */. void *pStar
ad30: 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
ad40: 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 61 76 First byte of av
ad50: 61 69 6c 61 62 6c 65 20 6d 65 6d 6f 72 79 20 73 ailable memory s
ad60: 70 61 63 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a pace */. void *
ad70: 70 45 6e 64 3b 20 20 20 20 20 20 20 20 20 20 20 pEnd;
ad80: 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 /* First byte
ad90: 70 61 73 74 20 65 6e 64 20 6f 66 20 61 76 61 69 past end of avai
ada0: 6c 61 62 6c 65 20 73 70 61 63 65 20 2a 2f 0a 7d lable space */.}
adb0: 3b 0a 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 69 ;.struct Lookasi
adc0: 64 65 53 6c 6f 74 20 7b 0a 20 20 4c 6f 6f 6b 61 deSlot {. Looka
add0: 73 69 64 65 53 6c 6f 74 20 2a 70 4e 65 78 74 3b sideSlot *pNext;
ade0: 20 20 20 20 2f 2a 20 4e 65 78 74 20 62 75 66 66 /* Next buff
adf0: 65 72 20 69 6e 20 74 68 65 20 6c 69 73 74 20 6f er in the list o
ae00: 66 20 66 72 65 65 20 62 75 66 66 65 72 73 20 2a f free buffers *
ae10: 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 68 61 /.};../*.** A ha
ae20: 73 68 20 74 61 62 6c 65 20 66 6f 72 20 62 75 69 sh table for bui
ae30: 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e 20 64 lt-in function d
ae40: 65 66 69 6e 69 74 69 6f 6e 73 2e 20 20 28 41 70 efinitions. (Ap
ae50: 70 6c 69 63 61 74 69 6f 6e 2d 64 65 66 69 6e 65 plication-define
ae60: 64 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 75 d.** functions u
ae70: 73 65 20 61 20 72 65 67 75 6c 61 72 20 74 61 62 se a regular tab
ae80: 6c 65 20 74 61 62 6c 65 20 66 72 6f 6d 20 68 61 le table from ha
ae90: 73 68 2e 68 2e 29 0a 2a 2a 0a 2a 2a 20 48 61 73 sh.h.).**.** Has
aea0: 68 20 65 61 63 68 20 46 75 6e 63 44 65 66 20 73 h each FuncDef s
aeb0: 74 72 75 63 74 75 72 65 20 69 6e 74 6f 20 6f 6e tructure into on
aec0: 65 20 6f 66 20 74 68 65 20 46 75 6e 63 44 65 66 e of the FuncDef
aed0: 48 61 73 68 2e 61 5b 5d 20 73 6c 6f 74 73 2e 0a Hash.a[] slots..
aee0: 2a 2a 20 43 6f 6c 6c 69 73 69 6f 6e 73 20 61 72 ** Collisions ar
aef0: 65 20 6f 6e 20 74 68 65 20 46 75 6e 63 44 65 66 e on the FuncDef
af00: 2e 75 2e 70 48 61 73 68 20 63 68 61 69 6e 2e 0a .u.pHash chain..
af10: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
af20: 45 5f 46 55 4e 43 5f 48 41 53 48 5f 53 5a 20 32 E_FUNC_HASH_SZ 2
af30: 33 0a 73 74 72 75 63 74 20 46 75 6e 63 44 65 66 3.struct FuncDef
af40: 48 61 73 68 20 7b 0a 20 20 46 75 6e 63 44 65 66 Hash {. FuncDef
af50: 20 2a 61 5b 53 51 4c 49 54 45 5f 46 55 4e 43 5f *a[SQLITE_FUNC_
af60: 48 41 53 48 5f 53 5a 5d 3b 20 20 20 20 20 20 20 HASH_SZ];
af70: 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 66 6f /* Hash table fo
af80: 72 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 7d r functions */.}
af90: 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ;..#ifdef SQLITE
afa0: 5f 55 53 45 52 5f 41 55 54 48 45 4e 54 49 43 41 _USER_AUTHENTICA
afb0: 54 49 4f 4e 0a 2f 2a 0a 2a 2a 20 49 6e 66 6f 72 TION./*.** Infor
afc0: 6d 61 74 69 6f 6e 20 68 65 6c 64 20 69 6e 20 74 mation held in t
afd0: 68 65 20 22 73 71 6c 69 74 65 33 22 20 64 61 74 he "sqlite3" dat
afe0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
aff0: 20 6f 62 6a 65 63 74 20 61 6e 64 20 75 73 65 64 object and used
b000: 0a 2a 2a 20 74 6f 20 6d 61 6e 61 67 65 20 75 73 .** to manage us
b010: 65 72 20 61 75 74 68 65 6e 74 69 63 61 74 69 6f er authenticatio
b020: 6e 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 n..*/.typedef st
b030: 72 75 63 74 20 73 71 6c 69 74 65 33 5f 75 73 65 ruct sqlite3_use
b040: 72 61 75 74 68 20 73 71 6c 69 74 65 33 5f 75 73 rauth sqlite3_us
b050: 65 72 61 75 74 68 3b 0a 73 74 72 75 63 74 20 73 erauth;.struct s
b060: 71 6c 69 74 65 33 5f 75 73 65 72 61 75 74 68 20 qlite3_userauth
b070: 7b 0a 20 20 75 38 20 61 75 74 68 4c 65 76 65 6c {. u8 authLevel
b080: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
b090: 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 61 75 74 /* Current aut
b0a0: 68 65 6e 74 69 63 61 74 69 6f 6e 20 6c 65 76 65 hentication leve
b0b0: 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 75 74 68 l */. int nAuth
b0c0: 50 57 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 PW;
b0d0: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
b0e0: 74 68 65 20 7a 41 75 74 68 50 57 20 69 6e 20 62 the zAuthPW in b
b0f0: 79 74 65 73 20 2a 2f 0a 20 20 63 68 61 72 20 2a ytes */. char *
b100: 7a 41 75 74 68 50 57 3b 20 20 20 20 20 20 20 20 zAuthPW;
b110: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 73 73 77 /* Passw
b120: 6f 72 64 20 75 73 65 64 20 74 6f 20 61 75 74 68 ord used to auth
b130: 65 6e 74 69 63 61 74 65 20 2a 2f 0a 20 20 63 68 enticate */. ch
b140: 61 72 20 2a 7a 41 75 74 68 55 73 65 72 3b 20 20 ar *zAuthUser;
b150: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 /* U
b160: 73 65 72 20 6e 61 6d 65 20 75 73 65 64 20 74 6f ser name used to
b170: 20 61 75 74 68 65 6e 74 69 63 61 74 65 20 2a 2f authenticate */
b180: 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 20 .};../* Allowed
b190: 76 61 6c 75 65 73 20 66 6f 72 20 73 71 6c 69 74 values for sqlit
b1a0: 65 33 5f 75 73 65 72 61 75 74 68 2e 61 75 74 68 e3_userauth.auth
b1b0: 4c 65 76 65 6c 20 2a 2f 0a 23 64 65 66 69 6e 65 Level */.#define
b1c0: 20 55 41 55 54 48 5f 55 6e 6b 6e 6f 77 6e 20 20 UAUTH_Unknown
b1d0: 20 20 20 30 20 20 20 20 20 2f 2a 20 41 75 74 68 0 /* Auth
b1e0: 65 6e 74 69 63 61 74 69 6f 6e 20 6e 6f 74 20 79 entication not y
b1f0: 65 74 20 63 68 65 63 6b 65 64 20 2a 2f 0a 23 64 et checked */.#d
b200: 65 66 69 6e 65 20 55 41 55 54 48 5f 46 61 69 6c efine UAUTH_Fail
b210: 20 20 20 20 20 20 20 20 31 20 20 20 20 20 2f 2a 1 /*
b220: 20 55 73 65 72 20 61 75 74 68 65 6e 74 69 63 61 User authentica
b230: 74 69 6f 6e 20 66 61 69 6c 65 64 20 2a 2f 0a 23 tion failed */.#
b240: 64 65 66 69 6e 65 20 55 41 55 54 48 5f 55 73 65 define UAUTH_Use
b250: 72 20 20 20 20 20 20 20 20 32 20 20 20 20 20 2f r 2 /
b260: 2a 20 41 75 74 68 65 6e 74 69 63 61 74 65 64 20 * Authenticated
b270: 61 73 20 61 20 6e 6f 72 6d 61 6c 20 75 73 65 72 as a normal user
b280: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 41 55 54 */.#define UAUT
b290: 48 5f 41 64 6d 69 6e 20 20 20 20 20 20 20 33 20 H_Admin 3
b2a0: 20 20 20 20 2f 2a 20 41 75 74 68 65 6e 74 69 63 /* Authentic
b2b0: 61 74 65 64 20 61 73 20 61 6e 20 61 64 6d 69 6e ated as an admin
b2c0: 69 73 74 72 61 74 6f 72 20 2a 2f 0a 0a 2f 2a 20 istrator */../*
b2d0: 46 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 6f Functions used o
b2e0: 6e 6c 79 20 62 79 20 75 73 65 72 20 61 75 74 68 nly by user auth
b2f0: 6f 72 69 7a 61 74 69 6f 6e 20 6c 6f 67 69 63 20 orization logic
b300: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 73 */.int sqlite3Us
b310: 65 72 41 75 74 68 54 61 62 6c 65 28 63 6f 6e 73 erAuthTable(cons
b320: 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 t char*);.int sq
b330: 6c 69 74 65 33 55 73 65 72 41 75 74 68 43 68 65 lite3UserAuthChe
b340: 63 6b 4c 6f 67 69 6e 28 73 71 6c 69 74 65 33 2a ckLogin(sqlite3*
b350: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 38 2a ,const char*,u8*
b360: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 );.void sqlite3U
b370: 73 65 72 41 75 74 68 49 6e 69 74 28 73 71 6c 69 serAuthInit(sqli
b380: 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 te3*);.void sqli
b390: 74 65 33 43 72 79 70 74 46 75 6e 63 28 73 71 6c te3CryptFunc(sql
b3a0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
b3b0: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a t,sqlite3_value*
b3c0: 2a 29 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 *);..#endif /* S
b3d0: 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 48 45 QLITE_USER_AUTHE
b3e0: 4e 54 49 43 41 54 49 4f 4e 20 2a 2f 0a 0a 2f 2a NTICATION */../*
b3f0: 0a 2a 2a 20 74 79 70 65 64 65 66 20 66 6f 72 20 .** typedef for
b400: 74 68 65 20 61 75 74 68 6f 72 69 7a 61 74 69 6f the authorizatio
b410: 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 n callback funct
b420: 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 ion..*/.#ifdef S
b430: 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 48 45 QLITE_USER_AUTHE
b440: 4e 54 49 43 41 54 49 4f 4e 0a 20 20 74 79 70 65 NTICATION. type
b450: 64 65 66 20 69 6e 74 20 28 2a 73 71 6c 69 74 65 def int (*sqlite
b460: 33 5f 78 61 75 74 68 29 28 76 6f 69 64 2a 2c 69 3_xauth)(void*,i
b470: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 nt,const char*,c
b480: 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 onst char*,const
b490: 20 63 68 61 72 2a 2c 0a 20 20 20 20 20 20 20 20 char*,.
b4a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b4b0: 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 const cha
b4c0: 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 r*, const char*)
b4d0: 3b 0a 23 65 6c 73 65 0a 20 20 74 79 70 65 64 65 ;.#else. typede
b4e0: 66 20 69 6e 74 20 28 2a 73 71 6c 69 74 65 33 5f f int (*sqlite3_
b4f0: 78 61 75 74 68 29 28 76 6f 69 64 2a 2c 69 6e 74 xauth)(void*,int
b500: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e ,const char*,con
b510: 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 st char*,const c
b520: 68 61 72 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 har*,.
b530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b540: 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 2a const char*
b550: 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 );.#endif..#ifnd
b560: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 ef SQLITE_OMIT_D
b570: 45 50 52 45 43 41 54 45 44 0a 2f 2a 20 54 68 69 EPRECATED./* Thi
b580: 73 20 69 73 20 61 6e 20 65 78 74 72 61 20 53 51 s is an extra SQ
b590: 4c 49 54 45 5f 54 52 41 43 45 20 6d 61 63 72 6f LITE_TRACE macro
b5a0: 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 73 20 that indicates
b5b0: 22 6c 65 67 61 63 79 22 20 74 72 61 63 69 6e 67 "legacy" tracing
b5c0: 0a 2a 2a 20 69 6e 20 74 68 65 20 73 74 79 6c 65 .** in the style
b5d0: 20 6f 66 20 73 71 6c 69 74 65 33 5f 74 72 61 63 of sqlite3_trac
b5e0: 65 28 29 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 e().*/.#define S
b5f0: 51 4c 49 54 45 5f 54 52 41 43 45 5f 4c 45 47 41 QLITE_TRACE_LEGA
b600: 43 59 20 20 30 78 38 30 0a 23 65 6c 73 65 0a 23 CY 0x80.#else.#
b610: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 52 define SQLITE_TR
b620: 41 43 45 5f 4c 45 47 41 43 59 20 20 30 0a 23 65 ACE_LEGACY 0.#e
b630: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
b640: 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 20 2a MIT_DEPRECATED *
b650: 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 64 /.../*.** Each d
b660: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
b670: 6f 6e 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 on is an instanc
b680: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
b690: 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f ng structure..*/
b6a0: 0a 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 20 .struct sqlite3
b6b0: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 {. sqlite3_vfs
b6c0: 2a 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 20 *pVfs;
b6d0: 20 20 2f 2a 20 4f 53 20 49 6e 74 65 72 66 61 63 /* OS Interfac
b6e0: 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 56 64 e */. struct Vd
b6f0: 62 65 20 2a 70 56 64 62 65 3b 20 20 20 20 20 20 be *pVdbe;
b700: 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
b710: 61 63 74 69 76 65 20 76 69 72 74 75 61 6c 20 6d active virtual m
b720: 61 63 68 69 6e 65 73 20 2a 2f 0a 20 20 43 6f 6c achines */. Col
b730: 6c 53 65 71 20 2a 70 44 66 6c 74 43 6f 6c 6c 3b lSeq *pDfltColl;
b740: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
b750: 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 e default collat
b760: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 28 42 49 ing sequence (BI
b770: 4e 41 52 59 29 20 2a 2f 0a 20 20 73 71 6c 69 74 NARY) */. sqlit
b780: 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b e3_mutex *mutex;
b790: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e /* Conn
b7a0: 65 63 74 69 6f 6e 20 6d 75 74 65 78 20 2a 2f 0a ection mutex */.
b7b0: 20 20 44 62 20 2a 61 44 62 3b 20 20 20 20 20 20 Db *aDb;
b7c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b7d0: 2f 2a 20 41 6c 6c 20 62 61 63 6b 65 6e 64 73 20 /* All backends
b7e0: 2a 2f 0a 20 20 69 6e 74 20 6e 44 62 3b 20 20 20 */. int nDb;
b7f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b800: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
b810: 62 61 63 6b 65 6e 64 73 20 63 75 72 72 65 6e 74 backends current
b820: 6c 79 20 69 6e 20 75 73 65 20 2a 2f 0a 20 20 75 ly in use */. u
b830: 33 32 20 6d 44 62 46 6c 61 67 73 3b 20 20 20 20 32 mDbFlags;
b840: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b850: 66 6c 61 67 73 20 72 65 63 6f 72 64 69 6e 67 20 flags recording
b860: 69 6e 74 65 72 6e 61 6c 20 73 74 61 74 65 20 2a internal state *
b870: 2f 0a 20 20 75 33 32 20 66 6c 61 67 73 3b 20 20 /. u32 flags;
b880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b890: 20 20 2f 2a 20 66 6c 61 67 73 20 73 65 74 74 61 /* flags setta
b8a0: 62 6c 65 20 62 79 20 70 72 61 67 6d 61 73 2e 20 ble by pragmas.
b8b0: 53 65 65 20 62 65 6c 6f 77 20 2a 2f 0a 20 20 69 See below */. i
b8c0: 36 34 20 6c 61 73 74 52 6f 77 69 64 3b 20 20 20 64 lastRowid;
b8d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b8e0: 52 4f 57 49 44 20 6f 66 20 6d 6f 73 74 20 72 65 ROWID of most re
b8f0: 63 65 6e 74 20 69 6e 73 65 72 74 20 28 73 65 65 cent insert (see
b900: 20 61 62 6f 76 65 29 20 2a 2f 0a 20 20 69 36 34 above) */. i64
b910: 20 73 7a 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 szMmap;
b920: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 /* De
b930: 66 61 75 6c 74 20 6d 6d 61 70 5f 73 69 7a 65 20 fault mmap_size
b940: 73 65 74 74 69 6e 67 20 2a 2f 0a 20 20 75 33 32 setting */. u32
b950: 20 6e 53 63 68 65 6d 61 4c 6f 63 6b 3b 20 20 20 nSchemaLock;
b960: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f /* Do
b970: 20 6e 6f 74 20 72 65 73 65 74 20 74 68 65 20 73 not reset the s
b980: 63 68 65 6d 61 20 77 68 65 6e 20 6e 6f 6e 2d 7a chema when non-z
b990: 65 72 6f 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 ero */. unsigne
b9a0: 64 20 69 6e 74 20 6f 70 65 6e 46 6c 61 67 73 3b d int openFlags;
b9b0: 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 /* Flags
b9c0: 70 61 73 73 65 64 20 74 6f 20 73 71 6c 69 74 65 passed to sqlite
b9d0: 33 5f 76 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 3_vfs.xOpen() */
b9e0: 0a 20 20 69 6e 74 20 65 72 72 43 6f 64 65 3b 20 . int errCode;
b9f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ba00: 20 2f 2a 20 4d 6f 73 74 20 72 65 63 65 6e 74 20 /* Most recent
ba10: 65 72 72 6f 72 20 63 6f 64 65 20 28 53 51 4c 49 error code (SQLI
ba20: 54 45 5f 2a 29 20 2a 2f 0a 20 20 69 6e 74 20 65 TE_*) */. int e
ba30: 72 72 4d 61 73 6b 3b 20 20 20 20 20 20 20 20 20 rrMask;
ba40: 20 20 20 20 20 20 20 20 20 2f 2a 20 26 20 72 65 /* & re
ba50: 73 75 6c 74 20 63 6f 64 65 73 20 77 69 74 68 20 sult codes with
ba60: 74 68 69 73 20 62 65 66 6f 72 65 20 72 65 74 75 this before retu
ba70: 72 6e 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 rning */. int i
ba80: 53 79 73 45 72 72 6e 6f 3b 20 20 20 20 20 20 20 SysErrno;
ba90: 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6e /* Errn
baa0: 6f 20 76 61 6c 75 65 20 66 72 6f 6d 20 6c 61 73 o value from las
bab0: 74 20 73 79 73 74 65 6d 20 65 72 72 6f 72 20 2a t system error *
bac0: 2f 0a 20 20 75 31 36 20 64 62 4f 70 74 46 6c 61 /. u16 dbOptFla
bad0: 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 gs;
bae0: 20 20 2f 2a 20 46 6c 61 67 73 20 74 6f 20 65 6e /* Flags to en
baf0: 61 62 6c 65 2f 64 69 73 61 62 6c 65 20 6f 70 74 able/disable opt
bb00: 69 6d 69 7a 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 imizations */.
bb10: 75 38 20 65 6e 63 3b 20 20 20 20 20 20 20 20 20 u8 enc;
bb20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
bb30: 20 54 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a Text encoding *
bb40: 2f 0a 20 20 75 38 20 61 75 74 6f 43 6f 6d 6d 69 /. u8 autoCommi
bb50: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
bb60: 20 20 2f 2a 20 54 68 65 20 61 75 74 6f 2d 63 6f /* The auto-co
bb70: 6d 6d 69 74 20 66 6c 61 67 2e 20 2a 2f 0a 20 20 mmit flag. */.
bb80: 75 38 20 74 65 6d 70 5f 73 74 6f 72 65 3b 20 20 u8 temp_store;
bb90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
bba0: 20 31 3a 20 66 69 6c 65 20 32 3a 20 6d 65 6d 6f 1: file 2: memo
bbb0: 72 79 20 30 3a 20 64 65 66 61 75 6c 74 20 2a 2f ry 0: default */
bbc0: 0a 20 20 75 38 20 6d 61 6c 6c 6f 63 46 61 69 6c . u8 mallocFail
bbd0: 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ed;
bbe0: 20 2f 2a 20 54 72 75 65 20 69 66 20 77 65 20 68 /* True if we h
bbf0: 61 76 65 20 73 65 65 6e 20 61 20 6d 61 6c 6c 6f ave seen a mallo
bc00: 63 20 66 61 69 6c 75 72 65 20 2a 2f 0a 20 20 75 c failure */. u
bc10: 38 20 62 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 3b 8 bBenignMalloc;
bc20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
bc30: 44 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 4f Do not require O
bc40: 4f 4d 73 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 OMs if true */.
bc50: 20 75 38 20 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 u8 dfltLockMode
bc60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
bc70: 2a 20 44 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e * Default lockin
bc80: 67 2d 6d 6f 64 65 20 66 6f 72 20 61 74 74 61 63 g-mode for attac
bc90: 68 65 64 20 64 62 73 20 2a 2f 0a 20 20 73 69 67 hed dbs */. sig
bca0: 6e 65 64 20 63 68 61 72 20 6e 65 78 74 41 75 74 ned char nextAut
bcb0: 6f 76 61 63 3b 20 20 20 20 20 20 2f 2a 20 41 75 ovac; /* Au
bcc0: 74 6f 76 61 63 20 73 65 74 74 69 6e 67 20 61 66 tovac setting af
bcd0: 74 65 72 20 56 41 43 55 55 4d 20 69 66 20 3e 3d ter VACUUM if >=
bce0: 30 20 2a 2f 0a 20 20 75 38 20 73 75 70 70 72 65 0 */. u8 suppre
bcf0: 73 73 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 ssErr;
bd00: 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 69 /* Do not i
bd10: 73 73 75 65 20 65 72 72 6f 72 20 6d 65 73 73 61 ssue error messa
bd20: 67 65 73 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 ges if true */.
bd30: 20 75 38 20 76 74 61 62 4f 6e 43 6f 6e 66 6c 69 u8 vtabOnConfli
bd40: 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ct; /
bd50: 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72 * Value to retur
bd60: 6e 20 66 6f 72 20 73 33 5f 76 74 61 62 5f 6f 6e n for s3_vtab_on
bd70: 5f 63 6f 6e 66 6c 69 63 74 28 29 20 2a 2f 0a 20 _conflict() */.
bd80: 20 75 38 20 69 73 54 72 61 6e 73 61 63 74 69 6f u8 isTransactio
bd90: 6e 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 2f nSavepoint; /
bda0: 2a 20 54 72 75 65 20 69 66 20 74 68 65 20 6f 75 * True if the ou
bdb0: 74 65 72 6d 6f 73 74 20 73 61 76 65 70 6f 69 6e termost savepoin
bdc0: 74 20 69 73 20 61 20 54 53 20 2a 2f 0a 20 20 75 t is a TS */. u
bdd0: 38 20 6d 54 72 61 63 65 3b 20 20 20 20 20 20 20 8 mTrace;
bde0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
bdf0: 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c zero or more SQL
be00: 49 54 45 5f 54 52 41 43 45 20 66 6c 61 67 73 20 ITE_TRACE flags
be10: 2a 2f 0a 20 20 75 38 20 6e 6f 53 68 61 72 65 64 */. u8 noShared
be20: 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 20 20 Cache;
be30: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 6e 6f /* True if no
be40: 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 62 61 shared-cache ba
be50: 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 75 38 20 6e ckends */. u8 n
be60: 53 71 6c 45 78 65 63 3b 20 20 20 20 20 20 20 20 SqlExec;
be70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
be80: 62 65 72 20 6f 66 20 70 65 6e 64 69 6e 67 20 4f ber of pending O
be90: 50 5f 53 71 6c 45 78 65 63 20 6f 70 63 6f 64 65 P_SqlExec opcode
bea0: 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 78 74 50 s */. int nextP
beb0: 61 67 65 73 69 7a 65 3b 20 20 20 20 20 20 20 20 agesize;
bec0: 20 20 20 20 20 2f 2a 20 50 61 67 65 73 69 7a 65 /* Pagesize
bed0: 20 61 66 74 65 72 20 56 41 43 55 55 4d 20 69 66 after VACUUM if
bee0: 20 3e 30 20 2a 2f 0a 20 20 75 33 32 20 6d 61 67 >0 */. u32 mag
bef0: 69 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ic;
bf00: 20 20 20 20 20 20 20 2f 2a 20 4d 61 67 69 63 20 /* Magic
bf10: 6e 75 6d 62 65 72 20 66 6f 72 20 64 65 74 65 63 number for detec
bf20: 74 20 6c 69 62 72 61 72 79 20 6d 69 73 75 73 65 t library misuse
bf30: 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67 */. int nChang
bf40: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
bf50: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 /* Value ret
bf60: 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33 urned by sqlite3
bf70: 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f 0a 20 20 _changes() */.
bf80: 69 6e 74 20 6e 54 6f 74 61 6c 43 68 61 6e 67 65 int nTotalChange
bf90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
bfa0: 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 Value returned
bfb0: 62 79 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c by sqlite3_total
bfc0: 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f 0a 20 20 _changes() */.
bfd0: 69 6e 74 20 61 4c 69 6d 69 74 5b 53 51 4c 49 54 int aLimit[SQLIT
bfe0: 45 5f 4e 5f 4c 49 4d 49 54 5d 3b 20 20 20 2f 2a E_N_LIMIT]; /*
bff0: 20 4c 69 6d 69 74 73 20 2a 2f 0a 20 20 69 6e 74 Limits */. int
c000: 20 6e 4d 61 78 53 6f 72 74 65 72 4d 6d 61 70 3b nMaxSorterMmap;
c010: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 /* Ma
c020: 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 72 65 ximum size of re
c030: 67 69 6f 6e 73 20 6d 61 70 70 65 64 20 62 79 20 gions mapped by
c040: 73 6f 72 74 65 72 20 2a 2f 0a 20 20 73 74 72 75 sorter */. stru
c050: 63 74 20 73 71 6c 69 74 65 33 49 6e 69 74 49 6e ct sqlite3InitIn
c060: 66 6f 20 7b 20 20 20 20 20 20 2f 2a 20 49 6e 66 fo { /* Inf
c070: 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 64 75 ormation used du
c080: 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 ring initializat
c090: 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e ion */. int n
c0a0: 65 77 54 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 ewTnum;
c0b0: 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 70 61 /* Rootpa
c0c0: 67 65 20 6f 66 20 74 61 62 6c 65 20 62 65 69 6e ge of table bein
c0d0: 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f g initialized */
c0e0: 0a 20 20 20 20 75 38 20 69 44 62 3b 20 20 20 20 . u8 iDb;
c0f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c100: 20 2f 2a 20 57 68 69 63 68 20 64 62 20 66 69 6c /* Which db fil
c110: 65 20 69 73 20 62 65 69 6e 67 20 69 6e 69 74 69 e is being initi
c120: 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 20 20 75 38 alized */. u8
c130: 20 62 75 73 79 3b 20 20 20 20 20 20 20 20 20 20 busy;
c140: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 52 55 /* TRU
c150: 45 20 69 66 20 63 75 72 72 65 6e 74 6c 79 20 69 E if currently i
c160: 6e 69 74 69 61 6c 69 7a 69 6e 67 20 2a 2f 0a 20 nitializing */.
c170: 20 20 20 75 6e 73 69 67 6e 65 64 20 6f 72 70 68 unsigned orph
c180: 61 6e 54 72 69 67 67 65 72 20 3a 20 31 3b 20 2f anTrigger : 1; /
c190: 2a 20 4c 61 73 74 20 73 74 61 74 65 6d 65 6e 74 * Last statement
c1a0: 20 69 73 20 6f 72 70 68 61 6e 65 64 20 54 45 4d is orphaned TEM
c1b0: 50 20 74 72 69 67 67 65 72 20 2a 2f 0a 20 20 20 P trigger */.
c1c0: 20 75 6e 73 69 67 6e 65 64 20 69 6d 70 6f 73 74 unsigned impost
c1d0: 65 72 54 61 62 6c 65 20 3a 20 31 3b 20 2f 2a 20 erTable : 1; /*
c1e0: 42 75 69 6c 64 69 6e 67 20 61 6e 20 69 6d 70 6f Building an impo
c1f0: 73 74 65 72 20 74 61 62 6c 65 20 2a 2f 0a 20 20 ster table */.
c200: 20 20 75 6e 73 69 67 6e 65 64 20 72 65 6f 70 65 unsigned reope
c210: 6e 4d 65 6d 64 62 20 3a 20 31 3b 20 20 20 2f 2a nMemdb : 1; /*
c220: 20 41 54 54 41 43 48 20 69 73 20 72 65 61 6c 6c ATTACH is reall
c230: 79 20 61 20 72 65 6f 70 65 6e 20 75 73 69 6e 67 y a reopen using
c240: 20 4d 65 6d 44 42 20 2a 2f 0a 20 20 7d 20 69 6e MemDB */. } in
c250: 69 74 3b 0a 20 20 69 6e 74 20 6e 56 64 62 65 41 it;. int nVdbeA
c260: 63 74 69 76 65 3b 20 20 20 20 20 20 20 20 20 20 ctive;
c270: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
c280: 20 56 44 42 45 73 20 63 75 72 72 65 6e 74 6c 79 VDBEs currently
c290: 20 72 75 6e 6e 69 6e 67 20 2a 2f 0a 20 20 69 6e running */. in
c2a0: 74 20 6e 56 64 62 65 52 65 61 64 3b 20 20 20 20 t nVdbeRead;
c2b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
c2c0: 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 65 20 umber of active
c2d0: 56 44 42 45 73 20 74 68 61 74 20 72 65 61 64 20 VDBEs that read
c2e0: 6f 72 20 77 72 69 74 65 20 2a 2f 0a 20 20 69 6e or write */. in
c2f0: 74 20 6e 56 64 62 65 57 72 69 74 65 3b 20 20 20 t nVdbeWrite;
c300: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
c310: 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 65 20 umber of active
c320: 56 44 42 45 73 20 74 68 61 74 20 72 65 61 64 20 VDBEs that read
c330: 61 6e 64 20 77 72 69 74 65 20 2a 2f 0a 20 20 69 and write */. i
c340: 6e 74 20 6e 56 64 62 65 45 78 65 63 3b 20 20 20 nt nVdbeExec;
c350: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
c360: 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 Number of nested
c370: 20 63 61 6c 6c 73 20 74 6f 20 56 64 62 65 45 78 calls to VdbeEx
c380: 65 63 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 ec() */. int nV
c390: 44 65 73 74 72 6f 79 3b 20 20 20 20 20 20 20 20 Destroy;
c3a0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
c3b0: 72 20 6f 66 20 61 63 74 69 76 65 20 4f 50 5f 56 r of active OP_V
c3c0: 44 65 73 74 72 6f 79 20 6f 70 65 72 61 74 69 6f Destroy operatio
c3d0: 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 74 ns */. int nExt
c3e0: 65 6e 73 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 ension;
c3f0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
c400: 6f 66 20 6c 6f 61 64 65 64 20 65 78 74 65 6e 73 of loaded extens
c410: 69 6f 6e 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a ions */. void *
c420: 2a 61 45 78 74 65 6e 73 69 6f 6e 3b 20 20 20 20 *aExtension;
c430: 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 /* Array
c440: 20 6f 66 20 73 68 61 72 65 64 20 6c 69 62 72 61 of shared libra
c450: 72 79 20 68 61 6e 64 6c 65 73 20 2a 2f 0a 20 20 ry handles */.
c460: 69 6e 74 20 28 2a 78 54 72 61 63 65 29 28 75 33 int (*xTrace)(u3
c470: 32 2c 76 6f 69 64 2a 2c 76 6f 69 64 2a 2c 76 6f 2,void*,void*,vo
c480: 69 64 2a 29 3b 20 20 20 20 20 2f 2a 20 54 72 61 id*); /* Tra
c490: 63 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 ce function */.
c4a0: 20 76 6f 69 64 20 2a 70 54 72 61 63 65 41 72 67 void *pTraceArg
c4b0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
c4c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
c4d0: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 74 72 gument to the tr
c4e0: 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a ace function */.
c4f0: 20 20 76 6f 69 64 20 28 2a 78 50 72 6f 66 69 6c void (*xProfil
c500: 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 e)(void*,const c
c510: 68 61 72 2a 2c 75 36 34 29 3b 20 20 2f 2a 20 50 har*,u64); /* P
c520: 72 6f 66 69 6c 69 6e 67 20 66 75 6e 63 74 69 6f rofiling functio
c530: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 50 72 n */. void *pPr
c540: 6f 66 69 6c 65 41 72 67 3b 20 20 20 20 20 20 20 ofileArg;
c550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c560: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
c570: 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e profile function
c580: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6d */. void *pCom
c590: 6d 69 74 41 72 67 3b 20 20 20 20 20 20 20 20 20 mitArg;
c5a0: 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d /* Argum
c5b0: 65 6e 74 20 74 6f 20 78 43 6f 6d 6d 69 74 43 61 ent to xCommitCa
c5c0: 6c 6c 62 61 63 6b 28 29 20 2a 2f 0a 20 20 69 6e llback() */. in
c5d0: 74 20 28 2a 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 t (*xCommitCallb
c5e0: 61 63 6b 29 28 76 6f 69 64 2a 29 3b 20 20 20 20 ack)(void*);
c5f0: 2f 2a 20 49 6e 76 6f 6b 65 64 20 61 74 20 65 76 /* Invoked at ev
c600: 65 72 79 20 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 ery commit. */.
c610: 20 76 6f 69 64 20 2a 70 52 6f 6c 6c 62 61 63 6b void *pRollback
c620: 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 Arg;
c630: 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 /* Argument t
c640: 6f 20 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 o xRollbackCallb
c650: 61 63 6b 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 ack() */. void
c660: 28 2a 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 (*xRollbackCallb
c670: 61 63 6b 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 ack)(void*); /*
c680: 49 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 72 79 Invoked at every
c690: 20 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f commit. */. vo
c6a0: 69 64 20 2a 70 55 70 64 61 74 65 41 72 67 3b 0a id *pUpdateArg;.
c6b0: 20 20 76 6f 69 64 20 28 2a 78 55 70 64 61 74 65 void (*xUpdate
c6c0: 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c Callback)(void*,
c6d0: 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a int, const char*
c6e0: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c ,const char*,sql
c6f0: 69 74 65 5f 69 6e 74 36 34 29 3b 0a 23 69 66 64 ite_int64);.#ifd
c700: 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
c710: 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a _PREUPDATE_HOOK.
c720: 20 20 76 6f 69 64 20 2a 70 50 72 65 55 70 64 61 void *pPreUpda
c730: 74 65 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 teArg;
c740: 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e /* First argumen
c750: 74 20 74 6f 20 78 50 72 65 55 70 64 61 74 65 43 t to xPreUpdateC
c760: 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 allback */. voi
c770: 64 20 28 2a 78 50 72 65 55 70 64 61 74 65 43 61 d (*xPreUpdateCa
c780: 6c 6c 62 61 63 6b 29 28 20 20 20 2f 2a 20 52 65 llback)( /* Re
c790: 67 69 73 74 65 72 65 64 20 75 73 69 6e 67 20 73 gistered using s
c7a0: 71 6c 69 74 65 33 5f 70 72 65 75 70 64 61 74 65 qlite3_preupdate
c7b0: 5f 68 6f 6f 6b 28 29 20 2a 2f 0a 20 20 20 20 76 _hook() */. v
c7c0: 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e oid*,sqlite3*,in
c7d0: 74 2c 63 68 61 72 20 63 6f 6e 73 74 2a 2c 63 68 t,char const*,ch
c7e0: 61 72 20 63 6f 6e 73 74 2a 2c 73 71 6c 69 74 65 ar const*,sqlite
c7f0: 33 5f 69 6e 74 36 34 2c 73 71 6c 69 74 65 33 5f 3_int64,sqlite3_
c800: 69 6e 74 36 34 0a 20 20 29 3b 0a 20 20 50 72 65 int64. );. Pre
c810: 55 70 64 61 74 65 20 2a 70 50 72 65 55 70 64 61 Update *pPreUpda
c820: 74 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 43 6f te; /* Co
c830: 6e 74 65 78 74 20 66 6f 72 20 61 63 74 69 76 65 ntext for active
c840: 20 70 72 65 2d 75 70 64 61 74 65 20 63 61 6c 6c pre-update call
c850: 62 61 63 6b 20 2a 2f 0a 23 65 6e 64 69 66 20 2f back */.#endif /
c860: 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f * SQLITE_ENABLE_
c870: 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 20 2a PREUPDATE_HOOK *
c880: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
c890: 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 69 6e 74 20 _OMIT_WAL. int
c8a0: 28 2a 78 57 61 6c 43 61 6c 6c 62 61 63 6b 29 28 (*xWalCallback)(
c8b0: 76 6f 69 64 20 2a 2c 20 73 71 6c 69 74 65 33 20 void *, sqlite3
c8c0: 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c *, const char *,
c8d0: 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 2a 70 int);. void *p
c8e0: 57 61 6c 41 72 67 3b 0a 23 65 6e 64 69 66 0a 20 WalArg;.#endif.
c8f0: 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 void(*xCollNeed
c900: 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 ed)(void*,sqlite
c910: 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 3*,int eTextRep,
c920: 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 const char*);.
c930: 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 void(*xCollNeede
c940: 64 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 d16)(void*,sqlit
c950: 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 e3*,int eTextRep
c960: 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 3b 0a 20 ,const void*);.
c970: 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 void *pCollNeed
c980: 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 edArg;. sqlite3
c990: 5f 76 61 6c 75 65 20 2a 70 45 72 72 3b 20 20 20 _value *pErr;
c9a0: 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 74 20 72 /* Most r
c9b0: 65 63 65 6e 74 20 65 72 72 6f 72 20 6d 65 73 73 ecent error mess
c9c0: 61 67 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b age */. union {
c9d0: 0a 20 20 20 20 76 6f 6c 61 74 69 6c 65 20 69 6e . volatile in
c9e0: 74 20 69 73 49 6e 74 65 72 72 75 70 74 65 64 3b t isInterrupted;
c9f0: 20 2f 2a 20 54 72 75 65 20 69 66 20 73 71 6c 69 /* True if sqli
ca00: 74 65 33 5f 69 6e 74 65 72 72 75 70 74 20 68 61 te3_interrupt ha
ca10: 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 2a 2f s been called */
ca20: 0a 20 20 20 20 64 6f 75 62 6c 65 20 6e 6f 74 55 . double notU
ca30: 73 65 64 31 3b 20 20 20 20 20 20 20 20 20 20 20 sed1;
ca40: 20 2f 2a 20 53 70 61 63 65 72 20 2a 2f 0a 20 20 /* Spacer */.
ca50: 7d 20 75 31 3b 0a 20 20 4c 6f 6f 6b 61 73 69 64 } u1;. Lookasid
ca60: 65 20 6c 6f 6f 6b 61 73 69 64 65 3b 20 20 20 20 e lookaside;
ca70: 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 6b 61 73 69 /* Lookasi
ca80: 64 65 20 6d 61 6c 6c 6f 63 20 63 6f 6e 66 69 67 de malloc config
ca90: 75 72 61 74 69 6f 6e 20 2a 2f 0a 23 69 66 6e 64 uration */.#ifnd
caa0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
cab0: 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 73 UTHORIZATION. s
cac0: 71 6c 69 74 65 33 5f 78 61 75 74 68 20 78 41 75 qlite3_xauth xAu
cad0: 74 68 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 th; /*
cae0: 41 63 63 65 73 73 20 61 75 74 68 6f 72 69 7a 61 Access authoriza
caf0: 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a 2f tion function */
cb00: 0a 20 20 76 6f 69 64 20 2a 70 41 75 74 68 41 72 . void *pAuthAr
cb10: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
cb20: 20 2f 2a 20 31 73 74 20 61 72 67 75 6d 65 6e 74 /* 1st argument
cb30: 20 74 6f 20 74 68 65 20 61 63 63 65 73 73 20 61 to the access a
cb40: 75 74 68 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a uth function */.
cb50: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 #endif.#ifndef S
cb60: 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 QLITE_OMIT_PROGR
cb70: 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 20 20 69 ESS_CALLBACK. i
cb80: 6e 74 20 28 2a 78 50 72 6f 67 72 65 73 73 29 28 nt (*xProgress)(
cb90: 76 6f 69 64 20 2a 29 3b 20 20 20 20 20 2f 2a 20 void *); /*
cba0: 54 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c The progress cal
cbb0: 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 lback */. void
cbc0: 2a 70 50 72 6f 67 72 65 73 73 41 72 67 3b 20 20 *pProgressArg;
cbd0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 /* Argu
cbe0: 6d 65 6e 74 20 74 6f 20 74 68 65 20 70 72 6f 67 ment to the prog
cbf0: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f ress callback */
cc00: 0a 20 20 75 6e 73 69 67 6e 65 64 20 6e 50 72 6f . unsigned nPro
cc10: 67 72 65 73 73 4f 70 73 3b 20 20 20 20 20 20 20 gressOps;
cc20: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6f 70 /* Number of op
cc30: 63 6f 64 65 73 20 66 6f 72 20 70 72 6f 67 72 65 codes for progre
cc40: 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 23 ss callback */.#
cc50: 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 endif.#ifndef SQ
cc60: 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
cc70: 4c 54 41 42 4c 45 0a 20 20 69 6e 74 20 6e 56 54 LTABLE. int nVT
cc80: 72 61 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 rans;
cc90: 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 /* Alloca
cca0: 74 65 64 20 73 69 7a 65 20 6f 66 20 61 56 54 72 ted size of aVTr
ccb0: 61 6e 73 20 2a 2f 0a 20 20 48 61 73 68 20 61 4d ans */. Hash aM
ccc0: 6f 64 75 6c 65 3b 20 20 20 20 20 20 20 20 20 20 odule;
ccd0: 20 20 20 20 20 20 20 2f 2a 20 70 6f 70 75 6c 61 /* popula
cce0: 74 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 63 ted by sqlite3_c
ccf0: 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a reate_module() *
cd00: 2f 0a 20 20 56 74 61 62 43 74 78 20 2a 70 56 74 /. VtabCtx *pVt
cd10: 61 62 43 74 78 3b 20 20 20 20 20 20 20 20 20 20 abCtx;
cd20: 20 20 2f 2a 20 43 6f 6e 74 65 78 74 20 66 6f 72 /* Context for
cd30: 20 61 63 74 69 76 65 20 76 74 61 62 20 63 6f 6e active vtab con
cd40: 6e 65 63 74 2f 63 72 65 61 74 65 20 2a 2f 0a 20 nect/create */.
cd50: 20 56 54 61 62 6c 65 20 2a 2a 61 56 54 72 61 6e VTable **aVTran
cd60: 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f s; /
cd70: 2a 20 56 69 72 74 75 61 6c 20 74 61 62 6c 65 73 * Virtual tables
cd80: 20 77 69 74 68 20 6f 70 65 6e 20 74 72 61 6e 73 with open trans
cd90: 61 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 56 54 61 actions */. VTa
cda0: 62 6c 65 20 2a 70 44 69 73 63 6f 6e 6e 65 63 74 ble *pDisconnect
cdb0: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 69 ; /* Di
cdc0: 73 63 6f 6e 6e 65 63 74 20 74 68 65 73 65 20 69 sconnect these i
cdd0: 6e 20 6e 65 78 74 20 73 71 6c 69 74 65 33 5f 70 n next sqlite3_p
cde0: 72 65 70 61 72 65 28 29 20 2a 2f 0a 23 65 6e 64 repare() */.#end
cdf0: 69 66 0a 20 20 48 61 73 68 20 61 46 75 6e 63 3b if. Hash aFunc;
ce00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ce10: 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 /* Hash table
ce20: 20 6f 66 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 66 of connection f
ce30: 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 48 61 unctions */. Ha
ce40: 73 68 20 61 43 6f 6c 6c 53 65 71 3b 20 20 20 20 sh aCollSeq;
ce50: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
ce60: 6c 6c 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 ll collating seq
ce70: 75 65 6e 63 65 73 20 2a 2f 0a 20 20 42 75 73 79 uences */. Busy
ce80: 48 61 6e 64 6c 65 72 20 62 75 73 79 48 61 6e 64 Handler busyHand
ce90: 6c 65 72 3b 20 20 20 20 20 20 2f 2a 20 42 75 73 ler; /* Bus
cea0: 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 y callback */.
ceb0: 44 62 20 61 44 62 53 74 61 74 69 63 5b 32 5d 3b Db aDbStatic[2];
cec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
ced0: 20 53 74 61 74 69 63 20 73 70 61 63 65 20 66 6f Static space fo
cee0: 72 20 74 68 65 20 32 20 64 65 66 61 75 6c 74 20 r the 2 default
cef0: 62 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 53 61 backends */. Sa
cf00: 76 65 70 6f 69 6e 74 20 2a 70 53 61 76 65 70 6f vepoint *pSavepo
cf10: 69 6e 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c int; /* L
cf20: 69 73 74 20 6f 66 20 61 63 74 69 76 65 20 73 61 ist of active sa
cf30: 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e vepoints */. in
cf40: 74 20 62 75 73 79 54 69 6d 65 6f 75 74 3b 20 20 t busyTimeout;
cf50: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
cf60: 75 73 79 20 68 61 6e 64 6c 65 72 20 74 69 6d 65 usy handler time
cf70: 6f 75 74 2c 20 69 6e 20 6d 73 65 63 20 2a 2f 0a out, in msec */.
cf80: 20 20 69 6e 74 20 6e 53 61 76 65 70 6f 69 6e 74 int nSavepoint
cf90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
cfa0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e 6f 6e /* Number of non
cfb0: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 -transaction sav
cfc0: 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 epoints */. int
cfd0: 20 6e 53 74 61 74 65 6d 65 6e 74 3b 20 20 20 20 nStatement;
cfe0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
cff0: 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 20 73 mber of nested s
d000: 74 61 74 65 6d 65 6e 74 2d 74 72 61 6e 73 61 63 tatement-transac
d010: 74 69 6f 6e 73 20 20 2a 2f 0a 20 20 69 36 34 20 tions */. i64
d020: 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 20 20 nDeferredCons;
d030: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 74 /* Net
d040: 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 deferred constr
d050: 61 69 6e 74 73 20 74 68 69 73 20 74 72 61 6e 73 aints this trans
d060: 61 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 69 36 34 action. */. i64
d070: 20 6e 44 65 66 65 72 72 65 64 49 6d 6d 43 6f 6e nDeferredImmCon
d080: 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 s; /* Ne
d090: 74 20 64 65 66 65 72 72 65 64 20 69 6d 6d 65 64 t deferred immed
d0a0: 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 iate constraints
d0b0: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 42 79 74 */. int *pnByt
d0c0: 65 73 46 72 65 65 64 3b 20 20 20 20 20 20 20 20 esFreed;
d0d0: 20 20 20 20 2f 2a 20 49 66 20 6e 6f 74 20 4e 55 /* If not NU
d0e0: 4c 4c 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 LL, increment th
d0f0: 69 73 20 69 6e 20 44 62 46 72 65 65 28 29 20 2a is in DbFree() *
d100: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
d110: 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f ENABLE_UNLOCK_NO
d120: 54 49 46 59 0a 20 20 2f 2a 20 54 68 65 20 66 6f TIFY. /* The fo
d130: 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 62 6c 65 llowing variable
d140: 73 20 61 72 65 20 61 6c 6c 20 70 72 6f 74 65 63 s are all protec
d150: 74 65 64 20 62 79 20 74 68 65 20 53 54 41 54 49 ted by the STATI
d160: 43 5f 4d 41 53 54 45 52 0a 20 20 2a 2a 20 6d 75 C_MASTER. ** mu
d170: 74 65 78 2c 20 6e 6f 74 20 62 79 20 73 71 6c 69 tex, not by sqli
d180: 74 65 33 2e 6d 75 74 65 78 2e 20 54 68 65 79 20 te3.mutex. They
d190: 61 72 65 20 75 73 65 64 20 62 79 20 63 6f 64 65 are used by code
d1a0: 20 69 6e 20 6e 6f 74 69 66 79 2e 63 2e 0a 20 20 in notify.c..
d1b0: 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 2e 70 **. ** When X.p
d1c0: 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 6f 6e UnlockConnection
d1d0: 3d 3d 59 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 ==Y, that means
d1e0: 74 68 61 74 20 58 20 69 73 20 77 61 69 74 69 6e that X is waitin
d1f0: 67 20 66 6f 72 20 59 20 74 6f 0a 20 20 2a 2a 20 g for Y to. **
d200: 75 6e 6c 6f 63 6b 20 73 6f 20 74 68 61 74 20 69 unlock so that i
d210: 74 20 63 61 6e 20 70 72 6f 63 65 65 64 2e 0a 20 t can proceed..
d220: 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 2e **. ** When X.
d230: 70 42 6c 6f 63 6b 69 6e 67 43 6f 6e 6e 65 63 74 pBlockingConnect
d240: 69 6f 6e 3d 3d 59 2c 20 74 68 61 74 20 6d 65 61 ion==Y, that mea
d250: 6e 73 20 74 68 61 74 20 73 6f 6d 65 74 68 69 6e ns that somethin
d260: 67 20 74 68 61 74 20 58 20 74 72 69 65 64 0a 20 g that X tried.
d270: 20 2a 2a 20 74 72 69 65 64 20 74 6f 20 64 6f 20 ** tried to do
d280: 72 65 63 65 6e 74 6c 79 20 66 61 69 6c 65 64 20 recently failed
d290: 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 4c with an SQLITE_L
d2a0: 4f 43 4b 45 44 20 65 72 72 6f 72 20 64 75 65 20 OCKED error due
d2b0: 74 6f 20 6c 6f 63 6b 73 0a 20 20 2a 2a 20 68 65 to locks. ** he
d2c0: 6c 64 20 62 79 20 59 2e 0a 20 20 2a 2f 0a 20 20 ld by Y.. */.
d2d0: 73 71 6c 69 74 65 33 20 2a 70 42 6c 6f 63 6b 69 sqlite3 *pBlocki
d2e0: 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3b 20 2f 2a ngConnection; /*
d2f0: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 68 61 74 Connection that
d300: 20 63 61 75 73 65 64 20 53 51 4c 49 54 45 5f 4c caused SQLITE_L
d310: 4f 43 4b 45 44 20 2a 2f 0a 20 20 73 71 6c 69 74 OCKED */. sqlit
d320: 65 33 20 2a 70 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 e3 *pUnlockConne
d330: 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 ction;
d340: 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 /* Connection t
d350: 6f 20 77 61 74 63 68 20 66 6f 72 20 75 6e 6c 6f o watch for unlo
d360: 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 55 ck */. void *pU
d370: 6e 6c 6f 63 6b 41 72 67 3b 20 20 20 20 20 20 20 nlockArg;
d380: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
d390: 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 55 6e Argument to xUn
d3a0: 6c 6f 63 6b 4e 6f 74 69 66 79 20 2a 2f 0a 20 20 lockNotify */.
d3b0: 76 6f 69 64 20 28 2a 78 55 6e 6c 6f 63 6b 4e 6f void (*xUnlockNo
d3c0: 74 69 66 79 29 28 76 6f 69 64 20 2a 2a 2c 20 69 tify)(void **, i
d3d0: 6e 74 29 3b 20 20 2f 2a 20 55 6e 6c 6f 63 6b 20 nt); /* Unlock
d3e0: 6e 6f 74 69 66 79 20 63 61 6c 6c 62 61 63 6b 20 notify callback
d3f0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 4e */. sqlite3 *pN
d400: 65 78 74 42 6c 6f 63 6b 65 64 3b 20 20 20 20 20 extBlocked;
d410: 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 6c 69 /* Next in li
d420: 73 74 20 6f 66 20 61 6c 6c 20 62 6c 6f 63 6b 65 st of all blocke
d430: 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f d connections */
d440: 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 .#endif.#ifdef S
d450: 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 48 45 QLITE_USER_AUTHE
d460: 4e 54 49 43 41 54 49 4f 4e 0a 20 20 73 71 6c 69 NTICATION. sqli
d470: 74 65 33 5f 75 73 65 72 61 75 74 68 20 61 75 74 te3_userauth aut
d480: 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 h; /* Use
d490: 72 20 61 75 74 68 65 6e 74 69 63 61 74 69 6f 6e r authentication
d4a0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a information */.
d4b0: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
d4c0: 20 41 20 6d 61 63 72 6f 20 74 6f 20 64 69 73 63 A macro to disc
d4d0: 6f 76 65 72 20 74 68 65 20 65 6e 63 6f 64 69 6e over the encodin
d4e0: 67 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 2e g of a database.
d4f0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 43 48 45 .*/.#define SCHE
d500: 4d 41 5f 45 4e 43 28 64 62 29 20 28 28 64 62 29 MA_ENC(db) ((db)
d510: 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 6d 61 ->aDb[0].pSchema
d520: 2d 3e 65 6e 63 29 0a 23 64 65 66 69 6e 65 20 45 ->enc).#define E
d530: 4e 43 28 64 62 29 20 20 20 20 20 20 20 20 28 28 NC(db) ((
d540: 64 62 29 2d 3e 65 6e 63 29 0a 0a 2f 2a 0a 2a 2a db)->enc)../*.**
d550: 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 Possible values
d560: 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 65 33 for the sqlite3
d570: 2e 66 6c 61 67 73 2e 0a 2a 2a 0a 2a 2a 20 56 61 .flags..**.** Va
d580: 6c 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 lue constraints
d590: 28 65 6e 66 6f 72 63 65 64 20 76 69 61 20 61 73 (enforced via as
d5a0: 73 65 72 74 28 29 29 3a 0a 2a 2a 20 20 20 20 20 sert()):.**
d5b0: 20 53 51 4c 49 54 45 5f 46 75 6c 6c 46 53 79 6e SQLITE_FullFSyn
d5c0: 63 20 20 20 20 20 3d 3d 20 50 41 47 45 52 5f 46 c == PAGER_F
d5d0: 55 4c 4c 46 53 59 4e 43 0a 2a 2a 20 20 20 20 20 ULLFSYNC.**
d5e0: 20 53 51 4c 49 54 45 5f 43 6b 70 74 46 75 6c 6c SQLITE_CkptFull
d5f0: 46 53 79 6e 63 20 3d 3d 20 50 41 47 45 52 5f 43 FSync == PAGER_C
d600: 4b 50 54 5f 46 55 4c 4c 46 53 59 4e 43 0a 2a 2a KPT_FULLFSYNC.**
d610: 20 20 20 20 20 20 53 51 4c 49 54 45 5f 43 61 63 SQLITE_Cac
d620: 68 65 53 70 69 6c 6c 20 20 20 20 3d 3d 20 50 41 heSpill == PA
d630: 47 45 52 5f 43 41 43 48 45 5f 53 50 49 4c 4c 0a GER_CACHE_SPILL.
d640: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
d650: 45 5f 57 72 69 74 65 53 63 68 65 6d 61 20 20 20 E_WriteSchema
d660: 20 30 78 30 30 30 30 30 30 30 31 20 20 2f 2a 20 0x00000001 /*
d670: 4f 4b 20 74 6f 20 75 70 64 61 74 65 20 53 51 4c OK to update SQL
d680: 49 54 45 5f 4d 41 53 54 45 52 20 2a 2f 0a 23 64 ITE_MASTER */.#d
d690: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 65 67 efine SQLITE_Leg
d6a0: 61 63 79 46 69 6c 65 46 6d 74 20 20 30 78 30 30 acyFileFmt 0x00
d6b0: 30 30 30 30 30 32 20 20 2f 2a 20 43 72 65 61 74 000002 /* Creat
d6c0: 65 20 6e 65 77 20 64 61 74 61 62 61 73 65 73 20 e new databases
d6d0: 69 6e 20 66 6f 72 6d 61 74 20 31 20 2a 2f 0a 23 in format 1 */.#
d6e0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 75 define SQLITE_Fu
d6f0: 6c 6c 43 6f 6c 4e 61 6d 65 73 20 20 20 30 78 30 llColNames 0x0
d700: 30 30 30 30 30 30 34 20 20 2f 2a 20 53 68 6f 77 0000004 /* Show
d710: 20 66 75 6c 6c 20 63 6f 6c 75 6d 6e 20 6e 61 6d full column nam
d720: 65 73 20 6f 6e 20 53 45 4c 45 43 54 20 2a 2f 0a es on SELECT */.
d730: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
d740: 75 6c 6c 46 53 79 6e 63 20 20 20 20 20 20 30 78 ullFSync 0x
d750: 30 30 30 30 30 30 30 38 20 20 2f 2a 20 55 73 65 00000008 /* Use
d760: 20 66 75 6c 6c 20 66 73 79 6e 63 20 6f 6e 20 74 full fsync on t
d770: 68 65 20 62 61 63 6b 65 6e 64 20 2a 2f 0a 23 64 he backend */.#d
d780: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6b 70 efine SQLITE_Ckp
d790: 74 46 75 6c 6c 46 53 79 6e 63 20 20 30 78 30 30 tFullFSync 0x00
d7a0: 30 30 30 30 31 30 20 20 2f 2a 20 55 73 65 20 66 000010 /* Use f
d7b0: 75 6c 6c 20 66 73 79 6e 63 20 66 6f 72 20 63 68 ull fsync for ch
d7c0: 65 63 6b 70 6f 69 6e 74 20 2a 2f 0a 23 64 65 66 eckpoint */.#def
d7d0: 69 6e 65 20 53 51 4c 49 54 45 5f 43 61 63 68 65 ine SQLITE_Cache
d7e0: 53 70 69 6c 6c 20 20 20 20 20 30 78 30 30 30 30 Spill 0x0000
d7f0: 30 30 32 30 20 20 2f 2a 20 4f 4b 20 74 6f 20 73 0020 /* OK to s
d800: 70 69 6c 6c 20 70 61 67 65 72 20 63 61 63 68 65 pill pager cache
d810: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
d820: 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 TE_ShortColNames
d830: 20 20 30 78 30 30 30 30 30 30 34 30 20 20 2f 2a 0x00000040 /*
d840: 20 53 68 6f 77 20 73 68 6f 72 74 20 63 6f 6c 75 Show short colu
d850: 6d 6e 73 20 6e 61 6d 65 73 20 2a 2f 0a 23 64 65 mns names */.#de
d860: 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6f 75 6e fine SQLITE_Coun
d870: 74 52 6f 77 73 20 20 20 20 20 20 30 78 30 30 30 tRows 0x000
d880: 30 30 30 38 30 20 20 2f 2a 20 43 6f 75 6e 74 20 00080 /* Count
d890: 72 6f 77 73 20 63 68 61 6e 67 65 64 20 62 79 20 rows changed by
d8a0: 49 4e 53 45 52 54 2c 20 2a 2f 0a 20 20 20 20 20 INSERT, */.
d8b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d8c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d8d0: 20 20 20 20 20 2f 2a 20 20 20 44 45 4c 45 54 45 /* DELETE
d8e0: 2c 20 6f 72 20 55 50 44 41 54 45 20 61 6e 64 20 , or UPDATE and
d8f0: 72 65 74 75 72 6e 20 2a 2f 0a 20 20 20 20 20 20 return */.
d900: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d920: 20 20 20 20 2f 2a 20 20 20 74 68 65 20 63 6f 75 /* the cou
d930: 6e 74 20 75 73 69 6e 67 20 61 20 63 61 6c 6c 62 nt using a callb
d940: 61 63 6b 2e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ack. */.#define
d950: 53 51 4c 49 54 45 5f 4e 75 6c 6c 43 61 6c 6c 62 SQLITE_NullCallb
d960: 61 63 6b 20 20 20 30 78 30 30 30 30 30 31 30 30 ack 0x00000100
d970: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 /* Invoke the
d980: 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20 69 66 callback once if
d990: 20 74 68 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 the */.
d9a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d9b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d9c0: 20 20 2f 2a 20 20 20 72 65 73 75 6c 74 20 73 65 /* result se
d9d0: 74 20 69 73 20 65 6d 70 74 79 20 2a 2f 0a 23 64 t is empty */.#d
d9e0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 67 6e efine SQLITE_Ign
d9f0: 6f 72 65 43 68 65 63 6b 73 20 20 20 30 78 30 30 oreChecks 0x00
da00: 30 30 30 32 30 30 20 20 2f 2a 20 44 6f 20 6e 6f 000200 /* Do no
da10: 74 20 65 6e 66 6f 72 63 65 20 63 68 65 63 6b 20 t enforce check
da20: 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 23 constraints */.#
da30: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 define SQLITE_Re
da40: 61 64 55 6e 63 6f 6d 6d 69 74 20 20 20 30 78 30 adUncommit 0x0
da50: 30 30 30 30 34 30 30 20 20 2f 2a 20 52 45 41 44 0000400 /* READ
da60: 20 55 4e 43 4f 4d 4d 49 54 54 45 44 20 69 6e 20 UNCOMMITTED in
da70: 73 68 61 72 65 64 2d 63 61 63 68 65 20 2a 2f 0a shared-cache */.
da80: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e #define SQLITE_N
da90: 6f 43 6b 70 74 4f 6e 43 6c 6f 73 65 20 20 30 78 oCkptOnClose 0x
daa0: 30 30 30 30 30 38 30 30 20 20 2f 2a 20 4e 6f 20 00000800 /* No
dab0: 63 68 65 63 6b 70 6f 69 6e 74 20 6f 6e 20 63 6c checkpoint on cl
dac0: 6f 73 65 28 29 2f 44 45 54 41 43 48 20 2a 2f 0a ose()/DETACH */.
dad0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 #define SQLITE_R
dae0: 65 76 65 72 73 65 4f 72 64 65 72 20 20 20 30 78 everseOrder 0x
daf0: 30 30 30 30 31 30 30 30 20 20 2f 2a 20 52 65 76 00001000 /* Rev
db00: 65 72 73 65 20 75 6e 6f 72 64 65 72 65 64 20 53 erse unordered S
db10: 45 4c 45 43 54 73 20 2a 2f 0a 23 64 65 66 69 6e ELECTs */.#defin
db20: 65 20 53 51 4c 49 54 45 5f 52 65 63 54 72 69 67 e SQLITE_RecTrig
db30: 67 65 72 73 20 20 20 20 30 78 30 30 30 30 32 30 gers 0x000020
db40: 30 30 20 20 2f 2a 20 45 6e 61 62 6c 65 20 72 65 00 /* Enable re
db50: 63 75 72 73 69 76 65 20 74 72 69 67 67 65 72 73 cursive triggers
db60: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
db70: 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20 20 TE_ForeignKeys
db80: 20 20 30 78 30 30 30 30 34 30 30 30 20 20 2f 2a 0x00004000 /*
db90: 20 45 6e 66 6f 72 63 65 20 66 6f 72 65 69 67 6e Enforce foreign
dba0: 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 key constraints
dbb0: 20 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c */.#define SQL
dbc0: 49 54 45 5f 41 75 74 6f 49 6e 64 65 78 20 20 20 ITE_AutoIndex
dbd0: 20 20 20 30 78 30 30 30 30 38 30 30 30 20 20 2f 0x00008000 /
dbe0: 2a 20 45 6e 61 62 6c 65 20 61 75 74 6f 6d 61 74 * Enable automat
dbf0: 69 63 20 69 6e 64 65 78 65 73 20 2a 2f 0a 23 64 ic indexes */.#d
dc00: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 6f 61 efine SQLITE_Loa
dc10: 64 45 78 74 65 6e 73 69 6f 6e 20 20 30 78 30 30 dExtension 0x00
dc20: 30 31 30 30 30 30 20 20 2f 2a 20 45 6e 61 62 6c 010000 /* Enabl
dc30: 65 20 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e e load_extension
dc40: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
dc50: 54 45 5f 4c 6f 61 64 45 78 74 46 75 6e 63 20 20 TE_LoadExtFunc
dc60: 20 20 30 78 30 30 30 32 30 30 30 30 20 20 2f 2a 0x00020000 /*
dc70: 20 45 6e 61 62 6c 65 20 6c 6f 61 64 5f 65 78 74 Enable load_ext
dc80: 65 6e 73 69 6f 6e 28 29 20 53 51 4c 20 66 75 6e ension() SQL fun
dc90: 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c c */.#define SQL
dca0: 49 54 45 5f 45 6e 61 62 6c 65 54 72 69 67 67 65 ITE_EnableTrigge
dcb0: 72 20 20 30 78 30 30 30 34 30 30 30 30 20 20 2f r 0x00040000 /
dcc0: 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 * True to enable
dcd0: 20 74 72 69 67 67 65 72 73 20 2a 2f 0a 23 64 65 triggers */.#de
dce0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 65 66 65 fine SQLITE_Defe
dcf0: 72 46 4b 73 20 20 20 20 20 20 20 30 78 30 30 30 rFKs 0x000
dd00: 38 30 30 30 30 20 20 2f 2a 20 44 65 66 65 72 20 80000 /* Defer
dd10: 61 6c 6c 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e all FK constrain
dd20: 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ts */.#define SQ
dd30: 4c 49 54 45 5f 51 75 65 72 79 4f 6e 6c 79 20 20 LITE_QueryOnly
dd40: 20 20 20 20 30 78 30 30 31 30 30 30 30 30 20 20 0x00100000
dd50: 2f 2a 20 44 69 73 61 62 6c 65 20 64 61 74 61 62 /* Disable datab
dd60: 61 73 65 20 63 68 61 6e 67 65 73 20 2a 2f 0a 23 ase changes */.#
dd70: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 65 define SQLITE_Ce
dd80: 6c 6c 53 69 7a 65 43 6b 20 20 20 20 20 30 78 30 llSizeCk 0x0
dd90: 30 32 30 30 30 30 30 20 20 2f 2a 20 43 68 65 63 0200000 /* Chec
dda0: 6b 20 62 74 72 65 65 20 63 65 6c 6c 20 73 69 7a k btree cell siz
ddb0: 65 73 20 6f 6e 20 6c 6f 61 64 20 2a 2f 0a 23 64 es on load */.#d
ddc0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 74 73 efine SQLITE_Fts
ddd0: 33 54 6f 6b 65 6e 69 7a 65 72 20 20 30 78 30 30 3Tokenizer 0x00
dde0: 34 30 30 30 30 30 20 20 2f 2a 20 45 6e 61 62 6c 400000 /* Enabl
ddf0: 65 20 66 74 73 33 5f 74 6f 6b 65 6e 69 7a 65 72 e fts3_tokenizer
de00: 28 32 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 (2) */.#define S
de10: 51 4c 49 54 45 5f 45 6e 61 62 6c 65 51 50 53 47 QLITE_EnableQPSG
de20: 20 20 20 20 20 30 78 30 30 38 30 30 30 30 30 20 0x00800000
de30: 20 2f 2a 20 51 75 65 72 79 20 50 6c 61 6e 6e 65 /* Query Planne
de40: 72 20 53 74 61 62 69 6c 69 74 79 20 47 75 61 72 r Stability Guar
de50: 61 6e 74 65 65 2a 2f 0a 23 64 65 66 69 6e 65 20 antee*/.#define
de60: 53 51 4c 49 54 45 5f 54 72 69 67 67 65 72 45 51 SQLITE_TriggerEQ
de70: 50 20 20 20 20 20 30 78 30 31 30 30 30 30 30 30 P 0x01000000
de80: 20 20 2f 2a 20 53 68 6f 77 20 74 72 69 67 67 65 /* Show trigge
de90: 72 20 45 58 50 4c 41 49 4e 20 51 55 45 52 59 20 r EXPLAIN QUERY
dea0: 50 4c 41 4e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 PLAN */.#define
deb0: 53 51 4c 49 54 45 5f 52 65 73 65 74 44 61 74 61 SQLITE_ResetData
dec0: 62 61 73 65 20 20 30 78 30 32 30 30 30 30 30 30 base 0x02000000
ded0: 20 20 2f 2a 20 52 65 73 65 74 20 74 68 65 20 64 /* Reset the d
dee0: 61 74 61 62 61 73 65 20 2a 2f 0a 0a 2f 2a 20 46 atabase */../* F
def0: 6c 61 67 73 20 75 73 65 64 20 6f 6e 6c 79 20 69 lags used only i
df00: 66 20 64 65 62 75 67 67 69 6e 67 20 2a 2f 0a 23 f debugging */.#
df10: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
df20: 55 47 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 UG.#define SQLIT
df30: 45 5f 53 71 6c 54 72 61 63 65 20 20 20 20 20 20 E_SqlTrace
df40: 20 30 78 30 38 30 30 30 30 30 30 20 20 2f 2a 20 0x08000000 /*
df50: 44 65 62 75 67 20 70 72 69 6e 74 20 53 51 4c 20 Debug print SQL
df60: 61 73 20 69 74 20 65 78 65 63 75 74 65 73 20 2a as it executes *
df70: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
df80: 5f 56 64 62 65 4c 69 73 74 69 6e 67 20 20 20 20 _VdbeListing
df90: 30 78 31 30 30 30 30 30 30 30 20 20 2f 2a 20 44 0x10000000 /* D
dfa0: 65 62 75 67 20 6c 69 73 74 69 6e 67 73 20 6f 66 ebug listings of
dfb0: 20 56 44 42 45 20 70 72 6f 67 72 61 6d 73 20 2a VDBE programs *
dfc0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
dfd0: 5f 56 64 62 65 54 72 61 63 65 20 20 20 20 20 20 _VdbeTrace
dfe0: 30 78 32 30 30 30 30 30 30 30 20 20 2f 2a 20 54 0x20000000 /* T
dff0: 72 75 65 20 74 6f 20 74 72 61 63 65 20 56 44 42 rue to trace VDB
e000: 45 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f 0a 23 E execution */.#
e010: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 define SQLITE_Vd
e020: 62 65 41 64 64 6f 70 54 72 61 63 65 20 30 78 34 beAddopTrace 0x4
e030: 30 30 30 30 30 30 30 20 20 2f 2a 20 54 72 61 63 0000000 /* Trac
e040: 65 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 e sqlite3VdbeAdd
e050: 4f 70 28 29 20 63 61 6c 6c 73 20 2a 2f 0a 23 64 Op() calls */.#d
e060: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 62 efine SQLITE_Vdb
e070: 65 45 51 50 20 20 20 20 20 20 20 20 30 78 38 30 eEQP 0x80
e080: 30 30 30 30 30 30 20 20 2f 2a 20 44 65 62 75 67 000000 /* Debug
e090: 20 45 58 50 4c 41 49 4e 20 51 55 45 52 59 20 50 EXPLAIN QUERY P
e0a0: 4c 41 4e 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f LAN */.#endif../
e0b0: 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c *.** Allowed val
e0c0: 75 65 73 20 66 6f 72 20 73 71 6c 69 74 65 33 2e ues for sqlite3.
e0d0: 6d 44 62 46 6c 61 67 73 0a 2a 2f 0a 23 64 65 66 mDbFlags.*/.#def
e0e0: 69 6e 65 20 44 42 46 4c 41 47 5f 53 63 68 65 6d ine DBFLAG_Schem
e0f0: 61 43 68 61 6e 67 65 20 20 20 30 78 30 30 30 31 aChange 0x0001
e100: 20 20 2f 2a 20 55 6e 63 6f 6d 6d 69 74 74 65 64 /* Uncommitted
e110: 20 48 61 73 68 20 74 61 62 6c 65 20 63 68 61 6e Hash table chan
e120: 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 ges */.#define D
e130: 42 46 4c 41 47 5f 50 72 65 66 65 72 42 75 69 6c BFLAG_PreferBuil
e140: 74 69 6e 20 20 30 78 30 30 30 32 20 20 2f 2a 20 tin 0x0002 /*
e150: 50 72 65 66 65 72 65 6e 63 65 20 74 6f 20 62 75 Preference to bu
e160: 69 6c 74 2d 69 6e 20 66 75 6e 63 73 20 2a 2f 0a ilt-in funcs */.
e170: 23 64 65 66 69 6e 65 20 44 42 46 4c 41 47 5f 56 #define DBFLAG_V
e180: 61 63 75 75 6d 20 20 20 20 20 20 20 20 20 30 78 acuum 0x
e190: 30 30 30 34 20 20 2f 2a 20 43 75 72 72 65 6e 74 0004 /* Current
e1a0: 6c 79 20 69 6e 20 61 20 56 41 43 55 55 4d 20 2a ly in a VACUUM *
e1b0: 2f 0a 23 64 65 66 69 6e 65 20 44 42 46 4c 41 47 /.#define DBFLAG
e1c0: 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 20 20 _SchemaKnownOk
e1d0: 30 78 30 30 30 38 20 20 2f 2a 20 53 63 68 65 6d 0x0008 /* Schem
e1e0: 61 20 69 73 20 6b 6e 6f 77 6e 20 74 6f 20 62 65 a is known to be
e1f0: 20 76 61 6c 69 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a valid */../*.**
e200: 20 42 69 74 73 20 6f 66 20 74 68 65 20 73 71 6c Bits of the sql
e210: 69 74 65 33 2e 64 62 4f 70 74 46 6c 61 67 73 20 ite3.dbOptFlags
e220: 66 69 65 6c 64 20 74 68 61 74 20 61 72 65 20 75 field that are u
e230: 73 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 73 71 sed by the.** sq
e240: 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 lite3_test_contr
e250: 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ol(SQLITE_TESTCT
e260: 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 RL_OPTIMIZATIONS
e270: 2c 2e 2e 2e 29 20 69 6e 74 65 72 66 61 63 65 20 ,...) interface
e280: 74 6f 0a 2a 2a 20 73 65 6c 65 63 74 69 76 65 6c to.** selectivel
e290: 79 20 64 69 73 61 62 6c 65 20 76 61 72 69 6f 75 y disable variou
e2a0: 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 2e s optimizations.
e2b0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .*/.#define SQLI
e2c0: 54 45 5f 51 75 65 72 79 46 6c 61 74 74 65 6e 65 TE_QueryFlattene
e2d0: 72 20 30 78 30 30 30 31 20 20 20 2f 2a 20 51 75 r 0x0001 /* Qu
e2e0: 65 72 79 20 66 6c 61 74 74 65 6e 69 6e 67 20 2a ery flattening *
e2f0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
e300: 5f 43 6f 6c 75 6d 6e 43 61 63 68 65 20 20 20 20 _ColumnCache
e310: 30 78 30 30 30 32 20 20 20 2f 2a 20 43 6f 6c 75 0x0002 /* Colu
e320: 6d 6e 20 63 61 63 68 65 20 2a 2f 0a 23 64 65 66 mn cache */.#def
e330: 69 6e 65 20 53 51 4c 49 54 45 5f 47 72 6f 75 70 ine SQLITE_Group
e340: 42 79 4f 72 64 65 72 20 20 20 30 78 30 30 30 34 ByOrder 0x0004
e350: 20 20 20 2f 2a 20 47 52 4f 55 50 42 59 20 63 6f /* GROUPBY co
e360: 76 65 72 20 6f 66 20 4f 52 44 45 52 42 59 20 2a ver of ORDERBY *
e370: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
e380: 5f 46 61 63 74 6f 72 4f 75 74 43 6f 6e 73 74 20 _FactorOutConst
e390: 30 78 30 30 30 38 20 20 20 2f 2a 20 43 6f 6e 73 0x0008 /* Cons
e3a0: 74 61 6e 74 20 66 61 63 74 6f 72 69 6e 67 20 2a tant factoring *
e3b0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
e3c0: 5f 44 69 73 74 69 6e 63 74 4f 70 74 20 20 20 20 _DistinctOpt
e3d0: 30 78 30 30 31 30 20 20 20 2f 2a 20 44 49 53 54 0x0010 /* DIST
e3e0: 49 4e 43 54 20 75 73 69 6e 67 20 69 6e 64 65 78 INCT using index
e3f0: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
e400: 4c 49 54 45 5f 43 6f 76 65 72 49 64 78 53 63 61 LITE_CoverIdxSca
e410: 6e 20 20 20 30 78 30 30 32 30 20 20 20 2f 2a 20 n 0x0020 /*
e420: 43 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 20 73 Covering index s
e430: 63 61 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 cans */.#define
e440: 53 51 4c 49 54 45 5f 4f 72 64 65 72 42 79 49 64 SQLITE_OrderById
e450: 78 4a 6f 69 6e 20 30 78 30 30 34 30 20 20 20 2f xJoin 0x0040 /
e460: 2a 20 4f 52 44 45 52 20 42 59 20 6f 66 20 6a 6f * ORDER BY of jo
e470: 69 6e 73 20 76 69 61 20 69 6e 64 65 78 20 2a 2f ins via index */
e480: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e490: 54 72 61 6e 73 69 74 69 76 65 20 20 20 20 20 30 Transitive 0
e4a0: 78 30 30 38 30 20 20 20 2f 2a 20 54 72 61 6e 73 x0080 /* Trans
e4b0: 69 74 69 76 65 20 63 6f 6e 73 74 72 61 69 6e 74 itive constraint
e4c0: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
e4d0: 49 54 45 5f 4f 6d 69 74 4e 6f 6f 70 4a 6f 69 6e ITE_OmitNoopJoin
e4e0: 20 20 20 30 78 30 31 30 30 20 20 20 2f 2a 20 4f 0x0100 /* O
e4f0: 6d 69 74 20 75 6e 75 73 65 64 20 74 61 62 6c 65 mit unused table
e500: 73 20 69 6e 20 6a 6f 69 6e 73 20 2a 2f 0a 23 64 s in joins */.#d
e510: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6f 75 efine SQLITE_Cou
e520: 6e 74 4f 66 56 69 65 77 20 20 20 20 30 78 30 32 ntOfView 0x02
e530: 30 30 20 20 20 2f 2a 20 54 68 65 20 63 6f 75 6e 00 /* The coun
e540: 74 2d 6f 66 2d 76 69 65 77 20 6f 70 74 69 6d 69 t-of-view optimi
e550: 7a 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e zation */.#defin
e560: 65 20 53 51 4c 49 54 45 5f 43 75 72 73 6f 72 48 e SQLITE_CursorH
e570: 69 6e 74 73 20 20 20 20 30 78 30 34 30 30 20 20 ints 0x0400
e580: 20 2f 2a 20 41 64 64 20 4f 50 5f 43 75 72 73 6f /* Add OP_Curso
e590: 72 48 69 6e 74 20 6f 70 63 6f 64 65 73 20 2a 2f rHint opcodes */
e5a0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e5b0: 53 74 61 74 33 34 20 20 20 20 20 20 20 20 20 30 Stat34 0
e5c0: 78 30 38 30 30 20 20 20 2f 2a 20 55 73 65 20 53 x0800 /* Use S
e5d0: 54 41 54 33 20 6f 72 20 53 54 41 54 34 20 64 61 TAT3 or STAT4 da
e5e0: 74 61 20 2a 2f 0a 20 20 20 2f 2a 20 54 48 33 20 ta */. /* TH3
e5f0: 65 78 70 65 63 74 73 20 74 68 65 20 53 74 61 74 expects the Stat
e600: 33 34 20 20 5e 5e 5e 5e 5e 5e 20 76 61 6c 75 65 34 ^^^^^^ value
e610: 20 74 6f 20 62 65 20 30 78 30 38 30 30 2e 20 20 to be 0x0800.
e620: 44 6f 6e 27 74 20 63 68 61 6e 67 65 20 69 74 20 Don't change it
e630: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
e640: 45 5f 50 75 73 68 44 6f 77 6e 20 20 20 20 20 20 E_PushDown
e650: 20 30 78 31 30 30 30 20 20 20 2f 2a 20 54 68 65 0x1000 /* The
e660: 20 70 75 73 68 2d 64 6f 77 6e 20 6f 70 74 69 6d push-down optim
e670: 69 7a 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 ization */.#defi
e680: 6e 65 20 53 51 4c 49 54 45 5f 53 69 6d 70 6c 69 ne SQLITE_Simpli
e690: 66 79 4a 6f 69 6e 20 20 20 30 78 32 30 30 30 20 fyJoin 0x2000
e6a0: 20 20 2f 2a 20 43 6f 6e 76 65 72 74 20 4c 45 46 /* Convert LEF
e6b0: 54 20 4a 4f 49 4e 20 74 6f 20 4a 4f 49 4e 20 2a T JOIN to JOIN *
e6c0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
e6d0: 5f 41 6c 6c 4f 70 74 73 20 20 20 20 20 20 20 20 _AllOpts
e6e0: 30 78 66 66 66 66 20 20 20 2f 2a 20 41 6c 6c 20 0xffff /* All
e6f0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 2a 2f optimizations */
e700: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 66 ../*.** Macros f
e710: 6f 72 20 74 65 73 74 69 6e 67 20 77 68 65 74 68 or testing wheth
e720: 65 72 20 6f 72 20 6e 6f 74 20 6f 70 74 69 6d 69 er or not optimi
e730: 7a 61 74 69 6f 6e 73 20 61 72 65 20 65 6e 61 62 zations are enab
e740: 6c 65 64 20 6f 72 20 64 69 73 61 62 6c 65 64 2e led or disabled.
e750: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 70 74 69 .*/.#define Opti
e760: 6d 69 7a 61 74 69 6f 6e 44 69 73 61 62 6c 65 64 mizationDisabled
e770: 28 64 62 2c 20 6d 61 73 6b 29 20 20 28 28 28 64 (db, mask) (((d
e780: 62 29 2d 3e 64 62 4f 70 74 46 6c 61 67 73 26 28 b)->dbOptFlags&(
e790: 6d 61 73 6b 29 29 21 3d 30 29 0a 23 64 65 66 69 mask))!=0).#defi
e7a0: 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 45 ne OptimizationE
e7b0: 6e 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b 29 nabled(db, mask)
e7c0: 20 20 20 28 28 28 64 62 29 2d 3e 64 62 4f 70 74 (((db)->dbOpt
e7d0: 46 6c 61 67 73 26 28 6d 61 73 6b 29 29 3d 3d 30 Flags&(mask))==0
e7e0: 29 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 )../*.** Return
e7f0: 74 72 75 65 20 69 66 20 69 74 20 4f 4b 20 74 6f true if it OK to
e800: 20 66 61 63 74 6f 72 20 63 6f 6e 73 74 61 6e 74 factor constant
e810: 20 65 78 70 72 65 73 73 69 6f 6e 73 20 69 6e 74 expressions int
e820: 6f 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 o the initializa
e830: 74 69 6f 6e 0a 2a 2a 20 63 6f 64 65 2e 20 54 68 tion.** code. Th
e840: 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 20 e argument is a
e850: 50 61 72 73 65 20 6f 62 6a 65 63 74 20 66 6f 72 Parse object for
e860: 20 74 68 65 20 63 6f 64 65 20 67 65 6e 65 72 61 the code genera
e870: 74 6f 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 tor..*/.#define
e880: 43 6f 6e 73 74 46 61 63 74 6f 72 4f 6b 28 50 29 ConstFactorOk(P)
e890: 20 28 28 50 29 2d 3e 6f 6b 43 6f 6e 73 74 46 61 ((P)->okConstFa
e8a0: 63 74 6f 72 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 ctor)../*.** Pos
e8b0: 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 sible values for
e8c0: 20 74 68 65 20 73 71 6c 69 74 65 2e 6d 61 67 69 the sqlite.magi
e8d0: 63 20 66 69 65 6c 64 2e 0a 2a 2a 20 54 68 65 20 c field..** The
e8e0: 6e 75 6d 62 65 72 73 20 61 72 65 20 6f 62 74 61 numbers are obta
e8f0: 69 6e 65 64 20 61 74 20 72 61 6e 64 6f 6d 20 61 ined at random a
e900: 6e 64 20 68 61 76 65 20 6e 6f 20 73 70 65 63 69 nd have no speci
e910: 61 6c 20 6d 65 61 6e 69 6e 67 2c 20 6f 74 68 65 al meaning, othe
e920: 72 0a 2a 2a 20 74 68 61 6e 20 62 65 69 6e 67 20 r.** than being
e930: 64 69 73 74 69 6e 63 74 20 66 72 6f 6d 20 6f 6e distinct from on
e940: 65 20 61 6e 6f 74 68 65 72 2e 0a 2a 2f 0a 23 64 e another..*/.#d
e950: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 efine SQLITE_MAG
e960: 49 43 5f 4f 50 45 4e 20 20 20 20 20 30 78 61 30 IC_OPEN 0xa0
e970: 32 39 61 36 39 37 20 20 2f 2a 20 44 61 74 61 62 29a697 /* Datab
e980: 61 73 65 20 69 73 20 6f 70 65 6e 20 2a 2f 0a 23 ase is open */.#
e990: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 define SQLITE_MA
e9a0: 47 49 43 5f 43 4c 4f 53 45 44 20 20 20 30 78 39 GIC_CLOSED 0x9
e9b0: 66 33 63 32 64 33 33 20 20 2f 2a 20 44 61 74 61 f3c2d33 /* Data
e9c0: 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 20 2a base is closed *
e9d0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
e9e0: 5f 4d 41 47 49 43 5f 53 49 43 4b 20 20 20 20 20 _MAGIC_SICK
e9f0: 30 78 34 62 37 37 31 32 39 30 20 20 2f 2a 20 45 0x4b771290 /* E
ea00: 72 72 6f 72 20 61 6e 64 20 61 77 61 69 74 69 6e rror and awaitin
ea10: 67 20 63 6c 6f 73 65 20 2a 2f 0a 23 64 65 66 69 g close */.#defi
ea20: 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f ne SQLITE_MAGIC_
ea30: 42 55 53 59 20 20 20 20 20 30 78 66 30 33 62 37 BUSY 0xf03b7
ea40: 39 30 36 20 20 2f 2a 20 44 61 74 61 62 61 73 65 906 /* Database
ea50: 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 currently in us
ea60: 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c e */.#define SQL
ea70: 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 20 ITE_MAGIC_ERROR
ea80: 20 20 20 30 78 62 35 33 35 37 39 33 30 20 20 2f 0xb5357930 /
ea90: 2a 20 41 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 * An SQLITE_MISU
eaa0: 53 45 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 SE error occurre
eab0: 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c d */.#define SQL
eac0: 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 ITE_MAGIC_ZOMBIE
ead0: 20 20 20 30 78 36 34 63 66 66 63 37 66 20 20 2f 0x64cffc7f /
eae0: 2a 20 43 6c 6f 73 65 20 77 69 74 68 20 6c 61 73 * Close with las
eaf0: 74 20 73 74 61 74 65 6d 65 6e 74 20 63 6c 6f 73 t statement clos
eb00: 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 e */../*.** Each
eb10: 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 SQL function is
eb20: 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 20 69 defined by an i
eb30: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 nstance of the f
eb40: 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 72 75 ollowing.** stru
eb50: 63 74 75 72 65 2e 20 20 46 6f 72 20 67 6c 6f 62 cture. For glob
eb60: 61 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 al built-in func
eb70: 74 69 6f 6e 73 20 28 65 78 3a 20 73 75 62 73 74 tions (ex: subst
eb80: 72 28 29 2c 20 6d 61 78 28 29 2c 20 63 6f 75 6e r(), max(), coun
eb90: 74 28 29 29 0a 2a 2a 20 61 20 70 6f 69 6e 74 65 t()).** a pointe
eba0: 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
ebb0: 75 72 65 20 69 73 20 68 65 6c 64 20 69 6e 20 74 ure is held in t
ebc0: 68 65 20 73 71 6c 69 74 65 33 42 75 69 6c 74 69 he sqlite3Builti
ebd0: 6e 46 75 6e 63 74 69 6f 6e 73 20 6f 62 6a 65 63 nFunctions objec
ebe0: 74 2e 0a 2a 2a 20 46 6f 72 20 70 65 72 2d 63 6f t..** For per-co
ebf0: 6e 6e 65 63 74 69 6f 6e 20 61 70 70 6c 69 63 61 nnection applica
ec00: 74 69 6f 6e 2d 64 65 66 69 6e 65 64 20 66 75 6e tion-defined fun
ec10: 63 74 69 6f 6e 73 2c 20 61 20 70 6f 69 6e 74 65 ctions, a pointe
ec20: 72 20 74 6f 20 74 68 69 73 0a 2a 2a 20 73 74 72 r to this.** str
ec30: 75 63 74 75 72 65 20 69 73 20 68 65 6c 64 20 69 ucture is held i
ec40: 6e 20 74 68 65 20 64 62 2d 3e 61 48 61 73 68 20 n the db->aHash
ec50: 68 61 73 68 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a hash table..**.*
ec60: 2a 20 54 68 65 20 75 2e 70 48 61 73 68 20 66 69 * The u.pHash fi
ec70: 65 6c 64 20 69 73 20 75 73 65 64 20 62 79 20 74 eld is used by t
ec80: 68 65 20 67 6c 6f 62 61 6c 20 62 75 69 6c 74 2d he global built-
ec90: 69 6e 73 2e 20 20 54 68 65 20 75 2e 70 44 65 73 ins. The u.pDes
eca0: 74 72 75 63 74 6f 72 0a 2a 2a 20 66 69 65 6c 64 tructor.** field
ecb0: 20 69 73 20 75 73 65 64 20 62 79 20 70 65 72 2d is used by per-
ecc0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 70 70 2d 64 connection app-d
ecd0: 65 66 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2f ef functions..*/
ece0: 0a 73 74 72 75 63 74 20 46 75 6e 63 44 65 66 20 .struct FuncDef
ecf0: 7b 0a 20 20 69 38 20 6e 41 72 67 3b 20 20 20 20 {. i8 nArg;
ed00: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
ed10: 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 2e er of arguments.
ed20: 20 20 2d 31 20 6d 65 61 6e 73 20 75 6e 6c 69 6d -1 means unlim
ed30: 69 74 65 64 20 2a 2f 0a 20 20 75 31 36 20 66 75 ited */. u16 fu
ed40: 6e 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 2f ncFlags; /
ed50: 2a 20 53 6f 6d 65 20 63 6f 6d 62 69 6e 61 74 69 * Some combinati
ed60: 6f 6e 20 6f 66 20 53 51 4c 49 54 45 5f 46 55 4e on of SQLITE_FUN
ed70: 43 5f 2a 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 C_* */. void *p
ed80: 55 73 65 72 44 61 74 61 3b 20 20 20 20 20 2f 2a UserData; /*
ed90: 20 55 73 65 72 20 64 61 74 61 20 70 61 72 61 6d User data param
eda0: 65 74 65 72 20 2a 2f 0a 20 20 46 75 6e 63 44 65 eter */. FuncDe
edb0: 66 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 2f f *pNext; /
edc0: 2a 20 4e 65 78 74 20 66 75 6e 63 74 69 6f 6e 20 * Next function
edd0: 77 69 74 68 20 73 61 6d 65 20 6e 61 6d 65 20 2a with same name *
ede0: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 53 46 75 6e /. void (*xSFun
edf0: 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 c)(sqlite3_conte
ee00: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
ee10: 76 61 6c 75 65 2a 2a 29 3b 20 2f 2a 20 66 75 6e value**); /* fun
ee20: 63 20 6f 72 20 61 67 67 2d 73 74 65 70 20 2a 2f c or agg-step */
ee30: 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c . void (*xFinal
ee40: 69 7a 65 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e ize)(sqlite3_con
ee50: 74 65 78 74 2a 29 3b 20 20 20 20 20 20 20 20 20 text*);
ee60: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 67 67 20 /* Agg
ee70: 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a 20 20 63 finalizer */. c
ee80: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 onst char *zName
ee90: 3b 20 20 20 2f 2a 20 53 51 4c 20 6e 61 6d 65 20 ; /* SQL name
eea0: 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e of the function.
eeb0: 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 */. union {.
eec0: 20 20 46 75 6e 63 44 65 66 20 2a 70 48 61 73 68 FuncDef *pHash
eed0: 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 77 ; /* Next w
eee0: 69 74 68 20 61 20 64 69 66 66 65 72 65 6e 74 20 ith a different
eef0: 6e 61 6d 65 20 62 75 74 20 74 68 65 20 73 61 6d name but the sam
ef00: 65 20 68 61 73 68 20 2a 2f 0a 20 20 20 20 46 75 e hash */. Fu
ef10: 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 44 ncDestructor *pD
ef20: 65 73 74 72 75 63 74 6f 72 3b 20 20 20 2f 2a 20 estructor; /*
ef30: 52 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 65 Reference counte
ef40: 64 20 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e d destructor fun
ef50: 63 74 69 6f 6e 20 2a 2f 0a 20 20 7d 20 75 3b 0a ction */. } u;.
ef60: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 73 };../*.** This s
ef70: 74 72 75 63 74 75 72 65 20 65 6e 63 61 70 73 75 tructure encapsu
ef80: 6c 61 74 65 73 20 61 20 75 73 65 72 2d 66 75 6e lates a user-fun
ef90: 63 74 69 6f 6e 20 64 65 73 74 72 75 63 74 6f 72 ction destructor
efa0: 20 63 61 6c 6c 62 61 63 6b 20 28 61 73 0a 2a 2a callback (as.**
efb0: 20 63 6f 6e 66 69 67 75 72 65 64 20 75 73 69 6e configured usin
efc0: 67 20 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f g create_functio
efd0: 6e 5f 76 32 28 29 29 20 61 6e 64 20 61 20 72 65 n_v2()) and a re
efe0: 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 65 72 2e ference counter.
eff0: 20 57 68 65 6e 0a 2a 2a 20 63 72 65 61 74 65 5f When.** create_
f000: 66 75 6e 63 74 69 6f 6e 5f 76 32 28 29 20 69 73 function_v2() is
f010: 20 63 61 6c 6c 65 64 20 74 6f 20 63 72 65 61 74 called to creat
f020: 65 20 61 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 e a function wit
f030: 68 20 61 20 64 65 73 74 72 75 63 74 6f 72 2c 0a h a destructor,.
f040: 2a 2a 20 61 20 73 69 6e 67 6c 65 20 6f 62 6a 65 ** a single obje
f050: 63 74 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 ct of this type
f060: 69 73 20 61 6c 6c 6f 63 61 74 65 64 2e 20 46 75 is allocated. Fu
f070: 6e 63 44 65 73 74 72 75 63 74 6f 72 2e 6e 52 65 ncDestructor.nRe
f080: 66 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a 20 74 f is set to.** t
f090: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 46 75 6e he number of Fun
f0a0: 63 44 65 66 20 6f 62 6a 65 63 74 73 20 63 72 65 cDef objects cre
f0b0: 61 74 65 64 20 28 65 69 74 68 65 72 20 31 20 6f ated (either 1 o
f0c0: 72 20 33 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f r 3, depending o
f0d0: 6e 20 77 68 65 74 68 65 72 0a 2a 2a 20 6f 72 20 n whether.** or
f0e0: 6e 6f 74 20 74 68 65 20 73 70 65 63 69 66 69 65 not the specifie
f0f0: 64 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 53 51 d encoding is SQ
f100: 4c 49 54 45 5f 41 4e 59 29 2e 20 54 68 65 20 46 LITE_ANY). The F
f110: 75 6e 63 44 65 66 2e 70 44 65 73 74 72 75 63 74 uncDef.pDestruct
f120: 6f 72 0a 2a 2a 20 6d 65 6d 62 65 72 20 6f 66 20 or.** member of
f130: 65 61 63 68 20 6f 66 20 74 68 65 20 6e 65 77 20 each of the new
f140: 46 75 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 20 FuncDef objects
f150: 69 73 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 is set to point
f160: 74 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 64 to the allocated
f170: 0a 2a 2a 20 46 75 6e 63 44 65 73 74 72 75 63 74 .** FuncDestruct
f180: 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 61 or..**.** Therea
f190: 66 74 65 72 2c 20 77 68 65 6e 20 6f 6e 65 20 6f fter, when one o
f1a0: 66 20 74 68 65 20 46 75 6e 63 44 65 66 20 6f 62 f the FuncDef ob
f1b0: 6a 65 63 74 73 20 69 73 20 64 65 6c 65 74 65 64 jects is deleted
f1c0: 2c 20 74 68 65 20 72 65 66 65 72 65 6e 63 65 0a , the reference.
f1d0: 2a 2a 20 63 6f 75 6e 74 20 6f 6e 20 74 68 69 73 ** count on this
f1e0: 20 6f 62 6a 65 63 74 20 69 73 20 64 65 63 72 65 object is decre
f1f0: 6d 65 6e 74 65 64 2e 20 57 68 65 6e 20 69 74 20 mented. When it
f200: 72 65 61 63 68 65 73 20 30 2c 20 74 68 65 20 64 reaches 0, the d
f210: 65 73 74 72 75 63 74 6f 72 0a 2a 2a 20 69 73 20 estructor.** is
f220: 69 6e 76 6f 6b 65 64 20 61 6e 64 20 74 68 65 20 invoked and the
f230: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 73 FuncDestructor s
f240: 74 72 75 63 74 75 72 65 20 66 72 65 65 64 2e 0a tructure freed..
f250: 2a 2f 0a 73 74 72 75 63 74 20 46 75 6e 63 44 65 */.struct FuncDe
f260: 73 74 72 75 63 74 6f 72 20 7b 0a 20 20 69 6e 74 structor {. int
f270: 20 6e 52 65 66 3b 0a 20 20 76 6f 69 64 20 28 2a nRef;. void (*
f280: 78 44 65 73 74 72 6f 79 29 28 76 6f 69 64 20 2a xDestroy)(void *
f290: 29 3b 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 );. void *pUser
f2a0: 44 61 74 61 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 Data;.};../*.**
f2b0: 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 Possible values
f2c0: 66 6f 72 20 46 75 6e 63 44 65 66 2e 66 6c 61 67 for FuncDef.flag
f2d0: 73 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 s. Note that th
f2e0: 65 20 5f 4c 45 4e 47 54 48 20 61 6e 64 20 5f 54 e _LENGTH and _T
f2f0: 59 50 45 4f 46 0a 2a 2a 20 76 61 6c 75 65 73 20 YPEOF.** values
f300: 6d 75 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 must correspond
f310: 74 6f 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 48 to OPFLAG_LENGTH
f320: 41 52 47 20 61 6e 64 20 4f 50 46 4c 41 47 5f 54 ARG and OPFLAG_T
f330: 59 50 45 4f 46 41 52 47 2e 20 20 41 6e 64 0a 2a YPEOFARG. And.*
f340: 2a 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f * SQLITE_FUNC_CO
f350: 4e 53 54 41 4e 54 20 6d 75 73 74 20 62 65 20 74 NSTANT must be t
f360: 68 65 20 73 61 6d 65 20 61 73 20 53 51 4c 49 54 he same as SQLIT
f370: 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 43 2e E_DETERMINISTIC.
f380: 20 20 54 68 65 72 65 0a 2a 2a 20 61 72 65 20 61 There.** are a
f390: 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
f3a0: 74 73 20 69 6e 20 74 68 65 20 63 6f 64 65 20 74 ts in the code t
f3b0: 6f 20 76 65 72 69 66 79 20 74 68 69 73 2e 0a 2a o verify this..*
f3c0: 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e 73 74 *.** Value const
f3d0: 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 63 65 64 raints (enforced
f3e0: 20 76 69 61 20 61 73 73 65 72 74 28 29 29 3a 0a via assert()):.
f3f0: 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 46 55 ** SQLITE_FU
f400: 4e 43 5f 4d 49 4e 4d 41 58 20 20 20 20 3d 3d 20 NC_MINMAX ==
f410: 20 4e 43 5f 4d 69 6e 4d 61 78 41 67 67 20 20 20 NC_MinMaxAgg
f420: 20 20 20 3d 3d 20 53 46 5f 4d 69 6e 4d 61 78 41 == SF_MinMaxA
f430: 67 67 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 gg.** SQLITE
f440: 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 20 20 20 20 _FUNC_LENGTH
f450: 3d 3d 20 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 == OPFLAG_LENGT
f460: 48 41 52 47 0a 2a 2a 20 20 20 20 20 53 51 4c 49 HARG.** SQLI
f470: 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 20 20 TE_FUNC_TYPEOF
f480: 20 20 3d 3d 20 20 4f 50 46 4c 41 47 5f 54 59 50 == OPFLAG_TYP
f490: 45 4f 46 41 52 47 0a 2a 2a 20 20 20 20 20 53 51 EOFARG.** SQ
f4a0: 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 LITE_FUNC_CONSTA
f4b0: 4e 54 20 20 3d 3d 20 20 53 51 4c 49 54 45 5f 44 NT == SQLITE_D
f4c0: 45 54 45 52 4d 49 4e 49 53 54 49 43 20 66 72 6f ETERMINISTIC fro
f4d0: 6d 20 74 68 65 20 41 50 49 0a 2a 2a 20 20 20 20 m the API.**
f4e0: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 SQLITE_FUNC_ENC
f4f0: 4d 41 53 4b 20 20 20 64 65 70 65 6e 64 73 20 6f MASK depends o
f500: 6e 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 6d 61 n SQLITE_UTF* ma
f510: 63 72 6f 73 20 69 6e 20 74 68 65 20 41 50 49 0a cros in the API.
f520: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
f530: 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 20 20 E_FUNC_ENCMASK
f540: 30 78 30 30 30 33 20 2f 2a 20 53 51 4c 49 54 45 0x0003 /* SQLITE
f550: 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 55 54 _UTF8, SQLITE_UT
f560: 46 31 36 42 45 20 6f 72 20 55 54 46 31 36 4c 45 F16BE or UTF16LE
f570: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
f580: 54 45 5f 46 55 4e 43 5f 4c 49 4b 45 20 20 20 20 TE_FUNC_LIKE
f590: 20 30 78 30 30 30 34 20 2f 2a 20 43 61 6e 64 69 0x0004 /* Candi
f5a0: 64 61 74 65 20 66 6f 72 20 74 68 65 20 4c 49 4b date for the LIK
f5b0: 45 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 2a E optimization *
f5c0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
f5d0: 5f 46 55 4e 43 5f 43 41 53 45 20 20 20 20 20 30 _FUNC_CASE 0
f5e0: 78 30 30 30 38 20 2f 2a 20 43 61 73 65 2d 73 65 x0008 /* Case-se
f5f0: 6e 73 69 74 69 76 65 20 4c 49 4b 45 2d 74 79 70 nsitive LIKE-typ
f600: 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 e function */.#d
f610: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
f620: 43 5f 45 50 48 45 4d 20 20 20 20 30 78 30 30 31 C_EPHEM 0x001
f630: 30 20 2f 2a 20 45 70 68 65 6d 65 72 61 6c 2e 20 0 /* Ephemeral.
f640: 20 44 65 6c 65 74 65 20 77 69 74 68 20 56 44 42 Delete with VDB
f650: 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c E */.#define SQL
f660: 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c ITE_FUNC_NEEDCOL
f670: 4c 20 30 78 30 30 32 30 20 2f 2a 20 73 71 6c 69 L 0x0020 /* sqli
f680: 74 65 33 47 65 74 46 75 6e 63 43 6f 6c 6c 53 65 te3GetFuncCollSe
f690: 71 28 29 20 6d 69 67 68 74 20 62 65 20 63 61 6c q() might be cal
f6a0: 6c 65 64 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 led*/.#define SQ
f6b0: 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 LITE_FUNC_LENGTH
f6c0: 20 20 20 30 78 30 30 34 30 20 2f 2a 20 42 75 69 0x0040 /* Bui
f6d0: 6c 74 2d 69 6e 20 6c 65 6e 67 74 68 28 29 20 66 lt-in length() f
f6e0: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 unction */.#defi
f6f0: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 54 ne SQLITE_FUNC_T
f700: 59 50 45 4f 46 20 20 20 30 78 30 30 38 30 20 2f YPEOF 0x0080 /
f710: 2a 20 42 75 69 6c 74 2d 69 6e 20 74 79 70 65 6f * Built-in typeo
f720: 66 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a f() function */.
f730: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
f740: 55 4e 43 5f 43 4f 55 4e 54 20 20 20 20 30 78 30 UNC_COUNT 0x0
f750: 31 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 100 /* Built-in
f760: 63 6f 75 6e 74 28 2a 29 20 61 67 67 72 65 67 61 count(*) aggrega
f770: 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 te */.#define SQ
f780: 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 41 4c 45 53 LITE_FUNC_COALES
f790: 43 45 20 30 78 30 32 30 30 20 2f 2a 20 42 75 69 CE 0x0200 /* Bui
f7a0: 6c 74 2d 69 6e 20 63 6f 61 6c 65 73 63 65 28 29 lt-in coalesce()
f7b0: 20 6f 72 20 69 66 6e 75 6c 6c 28 29 20 2a 2f 0a or ifnull() */.
f7c0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
f7d0: 55 4e 43 5f 55 4e 4c 49 4b 45 4c 59 20 30 78 30 UNC_UNLIKELY 0x0
f7e0: 34 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 400 /* Built-in
f7f0: 75 6e 6c 69 6b 65 6c 79 28 29 20 66 75 6e 63 74 unlikely() funct
f800: 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ion */.#define S
f810: 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 QLITE_FUNC_CONST
f820: 41 4e 54 20 30 78 30 38 30 30 20 2f 2a 20 43 6f ANT 0x0800 /* Co
f830: 6e 73 74 61 6e 74 20 69 6e 70 75 74 73 20 67 69 nstant inputs gi
f840: 76 65 20 61 20 63 6f 6e 73 74 61 6e 74 20 6f 75 ve a constant ou
f850: 74 70 75 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tput */.#define
f860: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4d 49 4e 4d SQLITE_FUNC_MINM
f870: 41 58 20 20 20 30 78 31 30 30 30 20 2f 2a 20 54 AX 0x1000 /* T
f880: 72 75 65 20 66 6f 72 20 6d 69 6e 28 29 20 61 6e rue for min() an
f890: 64 20 6d 61 78 28 29 20 61 67 67 72 65 67 61 74 d max() aggregat
f8a0: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
f8b0: 4c 49 54 45 5f 46 55 4e 43 5f 53 4c 4f 43 48 4e LITE_FUNC_SLOCHN
f8c0: 47 20 20 30 78 32 30 30 30 20 2f 2a 20 22 53 6c G 0x2000 /* "Sl
f8d0: 6f 77 20 43 68 61 6e 67 65 22 2e 20 56 61 6c 75 ow Change". Valu
f8e0: 65 20 63 6f 6e 73 74 61 6e 74 20 64 75 72 69 6e e constant durin
f8f0: 67 20 61 0a 20 20 20 20 20 20 20 20 20 20 20 20 g a.
f900: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f910: 20 20 20 20 20 20 20 20 2a 2a 20 73 69 6e 67 6c ** singl
f920: 65 20 71 75 65 72 79 20 2d 20 6d 69 67 68 74 20 e query - might
f930: 63 68 61 6e 67 65 20 6f 76 65 72 20 74 69 6d 65 change over time
f940: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
f950: 54 45 5f 46 55 4e 43 5f 41 46 46 49 4e 49 54 59 TE_FUNC_AFFINITY
f960: 20 30 78 34 30 30 30 20 2f 2a 20 42 75 69 6c 74 0x4000 /* Built
f970: 2d 69 6e 20 61 66 66 69 6e 69 74 79 28 29 20 66 -in affinity() f
f980: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 unction */.#defi
f990: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4f ne SQLITE_FUNC_O
f9a0: 46 46 53 45 54 20 20 20 30 78 38 30 30 30 20 2f FFSET 0x8000 /
f9b0: 2a 20 42 75 69 6c 74 2d 69 6e 20 73 71 6c 69 74 * Built-in sqlit
f9c0: 65 5f 6f 66 66 73 65 74 28 29 20 66 75 6e 63 74 e_offset() funct
f9d0: 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 ion */../*.** Th
f9e0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 72 65 e following thre
f9f0: 65 20 6d 61 63 72 6f 73 2c 20 46 55 4e 43 54 49 e macros, FUNCTI
fa00: 4f 4e 28 29 2c 20 4c 49 4b 45 46 55 4e 43 28 29 ON(), LIKEFUNC()
fa10: 20 61 6e 64 20 41 47 47 52 45 47 41 54 45 28 29 and AGGREGATE()
fa20: 20 61 72 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 are.** used to
fa30: 63 72 65 61 74 65 20 74 68 65 20 69 6e 69 74 69 create the initi
fa40: 61 6c 69 7a 65 72 73 20 66 6f 72 20 74 68 65 20 alizers for the
fa50: 46 75 6e 63 44 65 66 20 73 74 72 75 63 74 75 72 FuncDef structur
fa60: 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 55 4e 43 es..**.** FUNC
fa70: 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 TION(zName, nArg
fa80: 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 , iArg, bNC, xFu
fa90: 6e 63 29 0a 2a 2a 20 20 20 20 20 55 73 65 64 20 nc).** Used
faa0: 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 61 6c to create a scal
fab0: 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 ar function defi
fac0: 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 6e 63 nition of a func
fad0: 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 20 20 tion zName.**
fae0: 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 implemented by
faf0: 20 43 20 66 75 6e 63 74 69 6f 6e 20 78 46 75 6e C function xFun
fb00: 63 20 74 68 61 74 20 61 63 63 65 70 74 73 20 6e c that accepts n
fb10: 41 72 67 20 61 72 67 75 6d 65 6e 74 73 2e 20 54 Arg arguments. T
fb20: 68 65 0a 2a 2a 20 20 20 20 20 76 61 6c 75 65 20 he.** value
fb30: 70 61 73 73 65 64 20 61 73 20 69 41 72 67 20 69 passed as iArg i
fb40: 73 20 63 61 73 74 20 74 6f 20 61 20 28 76 6f 69 s cast to a (voi
fb50: 64 2a 29 20 61 6e 64 20 6d 61 64 65 20 61 76 61 d*) and made ava
fb60: 69 6c 61 62 6c 65 0a 2a 2a 20 20 20 20 20 61 73 ilable.** as
fb70: 20 74 68 65 20 75 73 65 72 2d 64 61 74 61 20 28 the user-data (
fb80: 73 71 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74 sqlite3_user_dat
fb90: 61 28 29 29 20 66 6f 72 20 74 68 65 20 66 75 6e a()) for the fun
fba0: 63 74 69 6f 6e 2e 20 49 66 0a 2a 2a 20 20 20 20 ction. If.**
fbb0: 20 61 72 67 75 6d 65 6e 74 20 62 4e 43 20 69 73 argument bNC is
fbc0: 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 true, then the
fbd0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 SQLITE_FUNC_NEED
fbe0: 43 4f 4c 4c 20 66 6c 61 67 20 69 73 20 73 65 74 COLL flag is set
fbf0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 56 46 55 4e 43 54 ..**.** VFUNCT
fc00: 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c ION(zName, nArg,
fc10: 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e iArg, bNC, xFun
fc20: 63 29 0a 2a 2a 20 20 20 20 20 4c 69 6b 65 20 46 c).** Like F
fc30: 55 4e 43 54 49 4f 4e 20 65 78 63 65 70 74 20 69 UNCTION except i
fc40: 74 20 6f 6d 69 74 73 20 74 68 65 20 53 51 4c 49 t omits the SQLI
fc50: 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 TE_FUNC_CONSTANT
fc60: 20 66 6c 61 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 flag..**.** D
fc70: 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 FUNCTION(zName,
fc80: 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c nArg, iArg, bNC,
fc90: 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 4c xFunc).** L
fca0: 69 6b 65 20 46 55 4e 43 54 49 4f 4e 20 65 78 63 ike FUNCTION exc
fcb0: 65 70 74 20 69 74 20 6f 6d 69 74 73 20 74 68 65 ept it omits the
fcc0: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e SQLITE_FUNC_CON
fcd0: 53 54 41 4e 54 20 66 6c 61 67 20 61 6e 64 0a 2a STANT flag and.*
fce0: 2a 20 20 20 20 20 61 64 64 73 20 74 68 65 20 53 * adds the S
fcf0: 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c 4f 43 48 QLITE_FUNC_SLOCH
fd00: 4e 47 20 66 6c 61 67 2e 20 20 55 73 65 64 20 66 NG flag. Used f
fd10: 6f 72 20 64 61 74 65 20 26 20 74 69 6d 65 20 66 or date & time f
fd20: 75 6e 63 74 69 6f 6e 73 0a 2a 2a 20 20 20 20 20 unctions.**
fd30: 61 6e 64 20 66 75 6e 63 74 69 6f 6e 73 20 6c 69 and functions li
fd40: 6b 65 20 73 71 6c 69 74 65 5f 76 65 72 73 69 6f ke sqlite_versio
fd50: 6e 28 29 20 74 68 61 74 20 63 61 6e 20 63 68 61 n() that can cha
fd60: 6e 67 65 2c 20 62 75 74 20 6e 6f 74 20 64 75 72 nge, but not dur
fd70: 69 6e 67 0a 2a 2a 20 20 20 20 20 61 20 73 69 6e ing.** a sin
fd80: 67 6c 65 20 71 75 65 72 79 2e 20 20 54 68 65 20 gle query. The
fd90: 69 41 72 67 20 69 73 20 69 67 6e 6f 72 65 64 2e iArg is ignored.
fda0: 20 20 54 68 65 20 75 73 65 72 2d 64 61 74 61 20 The user-data
fdb0: 69 73 20 61 6c 77 61 79 73 20 73 65 74 0a 2a 2a is always set.**
fdc0: 20 20 20 20 20 74 6f 20 61 20 4e 55 4c 4c 20 70 to a NULL p
fdd0: 6f 69 6e 74 65 72 2e 20 20 54 68 65 20 62 4e 43 ointer. The bNC
fde0: 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f parameter is no
fdf0: 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 t used..**.**
fe00: 50 55 52 45 5f 44 41 54 45 28 7a 4e 61 6d 65 2c PURE_DATE(zName,
fe10: 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 nArg, iArg, bNC
fe20: 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 , xFunc).**
fe30: 55 73 65 64 20 66 6f 72 20 22 70 75 72 65 22 20 Used for "pure"
fe40: 64 61 74 65 2f 74 69 6d 65 20 66 75 6e 63 74 69 date/time functi
fe50: 6f 6e 73 2c 20 74 68 69 73 20 6d 61 63 72 6f 20 ons, this macro
fe60: 69 73 20 6c 69 6b 65 20 44 46 55 4e 43 54 49 4f is like DFUNCTIO
fe70: 4e 0a 2a 2a 20 20 20 20 20 65 78 63 65 70 74 20 N.** except
fe80: 74 68 61 74 20 69 74 20 64 6f 65 73 20 73 65 74 that it does set
fe90: 20 74 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 the SQLITE_FUNC
fea0: 5f 43 4f 4e 53 54 41 4e 54 20 66 6c 61 67 73 2e _CONSTANT flags.
feb0: 20 20 69 41 72 67 20 69 73 0a 2a 2a 20 20 20 20 iArg is.**
fec0: 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 74 68 65 ignored and the
fed0: 20 75 73 65 72 2d 64 61 74 61 20 66 6f 72 20 74 user-data for t
fee0: 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 hese functions i
fef0: 73 20 73 65 74 20 74 6f 20 61 6e 20 0a 2a 2a 20 s set to an .**
ff00: 20 20 20 20 61 72 62 69 74 72 61 72 79 20 6e 6f arbitrary no
ff10: 6e 2d 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2e 20 n-NULL pointer.
ff20: 20 54 68 65 20 62 4e 43 20 70 61 72 61 6d 65 74 The bNC paramet
ff30: 65 72 20 69 73 20 6e 6f 74 20 75 73 65 64 2e 0a er is not used..
ff40: 2a 2a 0a 2a 2a 20 20 20 41 47 47 52 45 47 41 54 **.** AGGREGAT
ff50: 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 E(zName, nArg, i
ff60: 41 72 67 2c 20 62 4e 43 2c 20 78 53 74 65 70 2c Arg, bNC, xStep,
ff70: 20 78 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 20 20 xFinal).**
ff80: 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 Used to create a
ff90: 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 n aggregate func
ffa0: 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 tion definition
ffb0: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 0a 2a implemented by.*
ffc0: 2a 20 20 20 20 20 74 68 65 20 43 20 66 75 6e 63 * the C func
ffd0: 74 69 6f 6e 73 20 78 53 74 65 70 20 61 6e 64 20 tions xStep and
ffe0: 78 46 69 6e 61 6c 2e 20 54 68 65 20 66 69 72 73 xFinal. The firs
fff0: 74 20 66 6f 75 72 20 70 61 72 61 6d 65 74 65 72 t four parameter
10000 73 0a 2a 2a 20 20 20 20 20 61 72 65 20 69 6e 74 s.** are int
10010 65 72 70 72 65 74 65 64 20 69 6e 20 74 68 65 20 erpreted in the
10020 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 same way as the
10030 66 69 72 73 74 20 34 20 70 61 72 61 6d 65 74 65 first 4 paramete
10040 72 73 20 74 6f 0a 2a 2a 20 20 20 20 20 46 55 4e rs to.** FUN
10050 43 54 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 CTION()..**.**
10060 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d 65 2c LIKEFUNC(zName,
10070 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 66 6c 61 nArg, pArg, fla
10080 67 73 29 0a 2a 2a 20 20 20 20 20 55 73 65 64 20 gs).** Used
10090 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 61 6c to create a scal
100a0 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 ar function defi
100b0 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 6e 63 nition of a func
100c0 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 20 20 tion zName.**
100d0 20 20 74 68 61 74 20 61 63 63 65 70 74 73 20 6e that accepts n
100e0 41 72 67 20 61 72 67 75 6d 65 6e 74 73 20 61 6e Arg arguments an
100f0 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 d is implemented
10100 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 43 0a by a call to C.
10110 2a 2a 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 20 ** function
10120 6c 69 6b 65 46 75 6e 63 2e 20 41 72 67 75 6d 65 likeFunc. Argume
10130 6e 74 20 70 41 72 67 20 69 73 20 63 61 73 74 20 nt pArg is cast
10140 74 6f 20 61 20 28 76 6f 69 64 20 2a 29 20 61 6e to a (void *) an
10150 64 20 6d 61 64 65 0a 2a 2a 20 20 20 20 20 61 76 d made.** av
10160 61 69 6c 61 62 6c 65 20 61 73 20 74 68 65 20 66 ailable as the f
10170 75 6e 63 74 69 6f 6e 20 75 73 65 72 2d 64 61 74 unction user-dat
10180 61 20 28 73 71 6c 69 74 65 33 5f 75 73 65 72 5f a (sqlite3_user_
10190 64 61 74 61 28 29 29 2e 20 54 68 65 0a 2a 2a 20 data()). The.**
101a0 20 20 20 20 46 75 6e 63 44 65 66 2e 66 6c 61 67 FuncDef.flag
101b0 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 73 65 s variable is se
101c0 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 70 t to the value p
101d0 61 73 73 65 64 20 61 73 20 74 68 65 20 66 6c 61 assed as the fla
101e0 67 73 0a 2a 2a 20 20 20 20 20 70 61 72 61 6d 65 gs.** parame
101f0 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ter..*/.#define
10200 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 FUNCTION(zName,
10210 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c nArg, iArg, bNC,
10220 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 xFunc) \. {nAr
10230 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 g, SQLITE_FUNC_C
10240 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 ONSTANT|SQLITE_U
10250 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f TF8|(bNC*SQLITE_
10260 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 FUNC_NEEDCOLL),
10270 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f \. SQLITE_INT_
10280 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 30 2c TO_PTR(iArg), 0,
10290 20 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d xFunc, 0, #zNam
102a0 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 e, {0} }.#define
102b0 20 56 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 VFUNCTION(zName
102c0 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
102d0 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e C, xFunc) \. {n
102e0 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 Arg, SQLITE_UTF8
102f0 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 55 4e |(bNC*SQLITE_FUN
10300 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 C_NEEDCOLL), \.
10310 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f SQLITE_INT_TO_
10320 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 78 46 PTR(iArg), 0, xF
10330 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 unc, 0, #zName,
10340 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 44 46 {0} }.#define DF
10350 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e UNCTION(zName, n
10360 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 Arg, iArg, bNC,
10370 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 xFunc) \. {nArg
10380 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c , SQLITE_FUNC_SL
10390 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f 55 54 46 OCHNG|SQLITE_UTF
103a0 38 2c 20 5c 0a 20 20 20 30 2c 20 30 2c 20 78 46 8, \. 0, 0, xF
103b0 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 unc, 0, #zName,
103c0 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 50 55 {0} }.#define PU
103d0 52 45 5f 44 41 54 45 28 7a 4e 61 6d 65 2c 20 6e RE_DATE(zName, n
103e0 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 Arg, iArg, bNC,
103f0 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 xFunc) \. {nArg
10400 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c , SQLITE_FUNC_SL
10410 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f 55 54 46 OCHNG|SQLITE_UTF
10420 38 7c 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 8|SQLITE_FUNC_CO
10430 4e 53 54 41 4e 54 2c 20 5c 0a 20 20 20 28 76 6f NSTANT, \. (vo
10440 69 64 2a 29 26 73 71 6c 69 74 65 33 43 6f 6e 66 id*)&sqlite3Conf
10450 69 67 2c 20 30 2c 20 78 46 75 6e 63 2c 20 30 2c ig, 0, xFunc, 0,
10460 20 23 7a 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 #zName, {0} }.#
10470 64 65 66 69 6e 65 20 46 55 4e 43 54 49 4f 4e 32 define FUNCTION2
10480 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 (zName, nArg, iA
10490 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 2c 20 rg, bNC, xFunc,
104a0 65 78 74 72 61 46 6c 61 67 73 29 20 5c 0a 20 20 extraFlags) \.
104b0 7b 6e 41 72 67 2c 53 51 4c 49 54 45 5f 46 55 4e {nArg,SQLITE_FUN
104c0 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 C_CONSTANT|SQLIT
104d0 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 E_UTF8|(bNC*SQLI
104e0 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
104f0 29 7c 65 78 74 72 61 46 6c 61 67 73 2c 5c 0a 20 )|extraFlags,\.
10500 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f SQLITE_INT_TO_
10510 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 78 46 PTR(iArg), 0, xF
10520 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 unc, 0, #zName,
10530 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 53 54 {0} }.#define ST
10540 52 5f 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 R_FUNCTION(zName
10550 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 62 4e , nArg, pArg, bN
10560 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e C, xFunc) \. {n
10570 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 Arg, SQLITE_FUNC
10580 5f 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f _SLOCHNG|SQLITE_
10590 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 UTF8|(bNC*SQLITE
105a0 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c _FUNC_NEEDCOLL),
105b0 20 5c 0a 20 20 20 70 41 72 67 2c 20 30 2c 20 78 \. pArg, 0, x
105c0 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c Func, 0, #zName,
105d0 20 7d 0a 23 64 65 66 69 6e 65 20 4c 49 4b 45 46 }.#define LIKEF
105e0 55 4e 43 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c UNC(zName, nArg,
105f0 20 61 72 67 2c 20 66 6c 61 67 73 29 20 5c 0a 20 arg, flags) \.
10600 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 {nArg, SQLITE_F
10610 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c UNC_CONSTANT|SQL
10620 49 54 45 5f 55 54 46 38 7c 66 6c 61 67 73 2c 20 ITE_UTF8|flags,
10630 5c 0a 20 20 20 28 76 6f 69 64 20 2a 29 61 72 67 \. (void *)arg
10640 2c 20 30 2c 20 6c 69 6b 65 46 75 6e 63 2c 20 30 , 0, likeFunc, 0
10650 2c 20 23 7a 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0a , #zName, {0} }.
10660 23 64 65 66 69 6e 65 20 41 47 47 52 45 47 41 54 #define AGGREGAT
10670 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 61 E(zName, nArg, a
10680 72 67 2c 20 6e 63 2c 20 78 53 74 65 70 2c 20 78 rg, nc, xStep, x
10690 46 69 6e 61 6c 29 20 5c 0a 20 20 7b 6e 41 72 67 Final) \. {nArg
106a0 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 6e , SQLITE_UTF8|(n
106b0 63 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 c*SQLITE_FUNC_NE
106c0 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 53 51 EDCOLL), \. SQ
106d0 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 LITE_INT_TO_PTR(
106e0 61 72 67 29 2c 20 30 2c 20 78 53 74 65 70 2c 78 arg), 0, xStep,x
106f0 46 69 6e 61 6c 2c 23 7a 4e 61 6d 65 2c 20 7b 30 Final,#zName, {0
10700 7d 7d 0a 23 64 65 66 69 6e 65 20 41 47 47 52 45 }}.#define AGGRE
10710 47 41 54 45 32 28 7a 4e 61 6d 65 2c 20 6e 41 72 GATE2(zName, nAr
10720 67 2c 20 61 72 67 2c 20 6e 63 2c 20 78 53 74 65 g, arg, nc, xSte
10730 70 2c 20 78 46 69 6e 61 6c 2c 20 65 78 74 72 61 p, xFinal, extra
10740 46 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 67 Flags) \. {nArg
10750 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 6e , SQLITE_UTF8|(n
10760 63 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 c*SQLITE_FUNC_NE
10770 45 44 43 4f 4c 4c 29 7c 65 78 74 72 61 46 6c 61 EDCOLL)|extraFla
10780 67 73 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f gs, \. SQLITE_
10790 49 4e 54 5f 54 4f 5f 50 54 52 28 61 72 67 29 2c INT_TO_PTR(arg),
107a0 20 30 2c 20 78 53 74 65 70 2c 78 46 69 6e 61 6c 0, xStep,xFinal
107b0 2c 23 7a 4e 61 6d 65 2c 20 7b 30 7d 7d 0a 0a 2f ,#zName, {0}}../
107c0 2a 0a 2a 2a 20 41 6c 6c 20 63 75 72 72 65 6e 74 *.** All current
107d0 20 73 61 76 65 70 6f 69 6e 74 73 20 61 72 65 20 savepoints are
107e0 73 74 6f 72 65 64 20 69 6e 20 61 20 6c 69 6e 6b stored in a link
107f0 65 64 20 6c 69 73 74 20 73 74 61 72 74 69 6e 67 ed list starting
10800 20 61 74 0a 2a 2a 20 73 71 6c 69 74 65 33 2e 70 at.** sqlite3.p
10810 53 61 76 65 70 6f 69 6e 74 2e 20 54 68 65 20 66 Savepoint. The f
10820 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 irst element in
10830 74 68 65 20 6c 69 73 74 20 69 73 20 74 68 65 20 the list is the
10840 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 0a 2a 2a most recently.**
10850 20 6f 70 65 6e 65 64 20 73 61 76 65 70 6f 69 6e opened savepoin
10860 74 2e 20 53 61 76 65 70 6f 69 6e 74 73 20 61 72 t. Savepoints ar
10870 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 6c e added to the l
10880 69 73 74 20 62 79 20 74 68 65 20 76 64 62 65 0a ist by the vdbe.
10890 2a 2a 20 4f 50 5f 53 61 76 65 70 6f 69 6e 74 20 ** OP_Savepoint
108a0 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2f 0a instruction..*/.
108b0 73 74 72 75 63 74 20 53 61 76 65 70 6f 69 6e 74 struct Savepoint
108c0 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 {. char *zName
108d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
108e0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 61 76 65 /* Save
108f0 70 6f 69 6e 74 20 6e 61 6d 65 20 28 6e 75 6c 2d point name (nul-
10900 74 65 72 6d 69 6e 61 74 65 64 29 20 2a 2f 0a 20 terminated) */.
10910 20 69 36 34 20 6e 44 65 66 65 72 72 65 64 43 6f i64 nDeferredCo
10920 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ns;
10930 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
10940 66 20 64 65 66 65 72 72 65 64 20 66 6b 20 76 69 f deferred fk vi
10950 6f 6c 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 36 olations */. i6
10960 34 20 6e 44 65 66 65 72 72 65 64 49 6d 6d 43 6f 4 nDeferredImmCo
10970 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ns;
10980 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 /* Number of d
10990 65 66 65 72 72 65 64 20 69 6d 6d 20 66 6b 2e 20 eferred imm fk.
109a0 2a 2f 0a 20 20 53 61 76 65 70 6f 69 6e 74 20 2a */. Savepoint *
109b0 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 pNext;
109c0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 65 /* Pare
109d0 6e 74 20 73 61 76 65 70 6f 69 6e 74 20 28 69 66 nt savepoint (if
109e0 20 61 6e 79 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a any) */.};../*.
109f0 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
10a00 20 61 72 65 20 75 73 65 64 20 61 73 20 74 68 65 are used as the
10a10 20 73 65 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 second paramete
10a20 72 20 74 6f 20 73 71 6c 69 74 65 33 53 61 76 65 r to sqlite3Save
10a30 70 6f 69 6e 74 28 29 2c 0a 2a 2a 20 61 6e 64 20 point(),.** and
10a40 61 73 20 74 68 65 20 50 31 20 61 72 67 75 6d 65 as the P1 argume
10a50 6e 74 20 74 6f 20 74 68 65 20 4f 50 5f 53 61 76 nt to the OP_Sav
10a60 65 70 6f 69 6e 74 20 69 6e 73 74 72 75 63 74 69 epoint instructi
10a70 6f 6e 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 on..*/.#define S
10a80 41 56 45 50 4f 49 4e 54 5f 42 45 47 49 4e 20 20 AVEPOINT_BEGIN
10a90 20 20 20 20 30 0a 23 64 65 66 69 6e 65 20 53 41 0.#define SA
10aa0 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 VEPOINT_RELEASE
10ab0 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 41 56 1.#define SAV
10ac0 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b 20 EPOINT_ROLLBACK
10ad0 20 20 32 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 2.../*.** Each
10ae0 20 53 51 4c 69 74 65 20 6d 6f 64 75 6c 65 20 28 SQLite module (
10af0 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 64 65 virtual table de
10b00 66 69 6e 69 74 69 6f 6e 29 20 69 73 20 64 65 66 finition) is def
10b10 69 6e 65 64 20 62 79 20 61 6e 0a 2a 2a 20 69 6e ined by an.** in
10b20 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
10b30 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
10b40 65 2c 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 e, stored in the
10b50 20 73 71 6c 69 74 65 33 2e 61 4d 6f 64 75 6c 65 sqlite3.aModule
10b60 0a 2a 2a 20 68 61 73 68 20 74 61 62 6c 65 2e 0a .** hash table..
10b70 2a 2f 0a 73 74 72 75 63 74 20 4d 6f 64 75 6c 65 */.struct Module
10b80 20 7b 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 {. const sqlit
10b90 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64 75 e3_module *pModu
10ba0 6c 65 3b 20 20 20 20 20 20 20 2f 2a 20 43 61 6c le; /* Cal
10bb0 6c 62 61 63 6b 20 70 6f 69 6e 74 65 72 73 20 2a lback pointers *
10bc0 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
10bd0 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 zName;
10be0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 /* Name
10bf0 20 70 61 73 73 65 64 20 74 6f 20 63 72 65 61 74 passed to creat
10c00 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a 20 20 e_module() */.
10c10 76 6f 69 64 20 2a 70 41 75 78 3b 20 20 20 20 20 void *pAux;
10c20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10c30 20 20 20 20 20 2f 2a 20 70 41 75 78 20 70 61 73 /* pAux pas
10c40 73 65 64 20 74 6f 20 63 72 65 61 74 65 5f 6d 6f sed to create_mo
10c50 64 75 6c 65 28 29 20 2a 2f 0a 20 20 76 6f 69 64 dule() */. void
10c60 20 28 2a 78 44 65 73 74 72 6f 79 29 28 76 6f 69 (*xDestroy)(voi
10c70 64 20 2a 29 3b 20 20 20 20 20 20 20 20 20 20 20 d *);
10c80 20 2f 2a 20 4d 6f 64 75 6c 65 20 64 65 73 74 72 /* Module destr
10c90 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a uctor function *
10ca0 2f 0a 20 20 54 61 62 6c 65 20 2a 70 45 70 6f 54 /. Table *pEpoT
10cb0 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ab;
10cc0 20 20 20 20 20 20 20 20 20 2f 2a 20 45 70 6f 6e /* Epon
10cd0 79 6d 6f 75 73 20 74 61 62 6c 65 20 66 6f 72 20 ymous table for
10ce0 74 68 69 73 20 6d 6f 64 75 6c 65 20 2a 2f 0a 7d this module */.}
10cf0 3b 0a 0a 2f 2a 0a 2a 2a 20 69 6e 66 6f 72 6d 61 ;../*.** informa
10d00 74 69 6f 6e 20 61 62 6f 75 74 20 65 61 63 68 20 tion about each
10d10 63 6f 6c 75 6d 6e 20 6f 66 20 61 6e 20 53 51 4c column of an SQL
10d20 20 74 61 62 6c 65 20 69 73 20 68 65 6c 64 20 69 table is held i
10d30 6e 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a n an instance.**
10d40 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 of this structu
10d50 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 43 6f re..*/.struct Co
10d60 6c 75 6d 6e 20 7b 0a 20 20 63 68 61 72 20 2a 7a lumn {. char *z
10d70 4e 61 6d 65 3b 20 20 20 20 20 2f 2a 20 4e 61 6d Name; /* Nam
10d80 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e e of this column
10d90 2c 20 5c 30 30 30 2c 20 74 68 65 6e 20 74 68 65 , \000, then the
10da0 20 74 79 70 65 20 2a 2f 0a 20 20 45 78 70 72 20 type */. Expr
10db0 2a 70 44 66 6c 74 3b 20 20 20 20 20 2f 2a 20 44 *pDflt; /* D
10dc0 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 efault value of
10dd0 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 this column */.
10de0 20 63 68 61 72 20 2a 7a 43 6f 6c 6c 3b 20 20 20 char *zColl;
10df0 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 73 /* Collating s
10e00 65 71 75 65 6e 63 65 2e 20 20 49 66 20 4e 55 4c equence. If NUL
10e10 4c 2c 20 75 73 65 20 74 68 65 20 64 65 66 61 75 L, use the defau
10e20 6c 74 20 2a 2f 0a 20 20 75 38 20 6e 6f 74 4e 75 lt */. u8 notNu
10e30 6c 6c 3b 20 20 20 20 20 20 2f 2a 20 41 6e 20 4f ll; /* An O
10e40 45 5f 20 63 6f 64 65 20 66 6f 72 20 68 61 6e 64 E_ code for hand
10e50 6c 69 6e 67 20 61 20 4e 4f 54 20 4e 55 4c 4c 20 ling a NOT NULL
10e60 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 20 20 constraint */.
10e70 63 68 61 72 20 61 66 66 69 6e 69 74 79 3b 20 20 char affinity;
10e80 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20 53 /* One of the S
10e90 51 4c 49 54 45 5f 41 46 46 5f 2e 2e 2e 20 76 61 QLITE_AFF_... va
10ea0 6c 75 65 73 20 2a 2f 0a 20 20 75 38 20 73 7a 45 lues */. u8 szE
10eb0 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 45 73 st; /* Es
10ec0 74 69 6d 61 74 65 64 20 73 69 7a 65 20 6f 66 20 timated size of
10ed0 76 61 6c 75 65 20 69 6e 20 74 68 69 73 20 63 6f value in this co
10ee0 6c 75 6d 6e 2e 20 73 69 7a 65 6f 66 28 49 4e 54 lumn. sizeof(INT
10ef0 29 3d 3d 31 20 2a 2f 0a 20 20 75 38 20 63 6f 6c )==1 */. u8 col
10f00 46 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 42 6f Flags; /* Bo
10f10 6f 6c 65 61 6e 20 70 72 6f 70 65 72 74 69 65 73 olean properties
10f20 2e 20 20 53 65 65 20 43 4f 4c 46 4c 41 47 5f 20 . See COLFLAG_
10f30 64 65 66 69 6e 65 73 20 62 65 6c 6f 77 20 2a 2f defines below */
10f40 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 20 .};../* Allowed
10f50 76 61 6c 75 65 73 20 66 6f 72 20 43 6f 6c 75 6d values for Colum
10f60 6e 2e 63 6f 6c 46 6c 61 67 73 3a 0a 2a 2f 0a 23 n.colFlags:.*/.#
10f70 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 50 define COLFLAG_P
10f80 52 49 4d 4b 45 59 20 20 30 78 30 30 30 31 20 20 RIMKEY 0x0001
10f90 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 69 73 20 70 /* Column is p
10fa0 61 72 74 20 6f 66 20 74 68 65 20 70 72 69 6d 61 art of the prima
10fb0 72 79 20 6b 65 79 20 2a 2f 0a 23 64 65 66 69 6e ry key */.#defin
10fc0 65 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 45 4e e COLFLAG_HIDDEN
10fd0 20 20 20 30 78 30 30 30 32 20 20 20 20 2f 2a 20 0x0002 /*
10fe0 41 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 20 A hidden column
10ff0 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 in a virtual tab
11000 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f le */.#define CO
11010 4c 46 4c 41 47 5f 48 41 53 54 59 50 45 20 20 30 LFLAG_HASTYPE 0
11020 78 30 30 30 34 20 20 20 20 2f 2a 20 54 79 70 65 x0004 /* Type
11030 20 6e 61 6d 65 20 66 6f 6c 6c 6f 77 73 20 63 6f name follows co
11040 6c 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 23 64 65 lumn name */.#de
11050 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 55 4e 49 fine COLFLAG_UNI
11060 51 55 45 20 20 20 30 78 30 30 30 38 20 20 20 20 QUE 0x0008
11070 2f 2a 20 43 6f 6c 75 6d 6e 20 64 65 66 20 63 6f /* Column def co
11080 6e 74 61 69 6e 73 20 22 55 4e 49 51 55 45 22 20 ntains "UNIQUE"
11090 6f 72 20 22 50 4b 22 20 2a 2f 0a 23 64 65 66 69 or "PK" */.#defi
110a0 6e 65 20 43 4f 4c 46 4c 41 47 5f 53 4f 52 54 45 ne COLFLAG_SORTE
110b0 52 52 45 46 20 30 78 30 30 31 30 20 20 20 2f 2a RREF 0x0010 /*
110c0 20 55 73 65 20 73 6f 72 74 65 72 2d 72 65 66 73 Use sorter-refs
110d0 20 77 69 74 68 20 74 68 69 73 20 63 6f 6c 75 6d with this colum
110e0 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 22 43 n */../*.** A "C
110f0 6f 6c 6c 61 74 69 6e 67 20 53 65 71 75 65 6e 63 ollating Sequenc
11100 65 22 20 69 73 20 64 65 66 69 6e 65 64 20 62 79 e" is defined by
11110 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 an instance of
11120 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a the following.**
11130 20 73 74 72 75 63 74 75 72 65 2e 20 43 6f 6e 63 structure. Conc
11140 65 70 74 75 61 6c 6c 79 2c 20 61 20 63 6f 6c 6c eptually, a coll
11150 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 63 ating sequence c
11160 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 6e 61 6d onsists of a nam
11170 65 20 61 6e 64 0a 2a 2a 20 61 20 63 6f 6d 70 61 e and.** a compa
11180 72 69 73 6f 6e 20 72 6f 75 74 69 6e 65 20 74 68 rison routine th
11190 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 20 6f at defines the o
111a0 72 64 65 72 20 6f 66 20 74 68 61 74 20 73 65 71 rder of that seq
111b0 75 65 6e 63 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 uence..**.** If
111c0 43 6f 6c 6c 53 65 71 2e 78 43 6d 70 20 69 73 20 CollSeq.xCmp is
111d0 4e 55 4c 4c 2c 20 69 74 20 6d 65 61 6e 73 20 74 NULL, it means t
111e0 68 61 74 20 74 68 65 0a 2a 2a 20 63 6f 6c 6c 61 hat the.** colla
111f0 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 ting sequence is
11200 20 75 6e 64 65 66 69 6e 65 64 2e 20 20 49 6e 64 undefined. Ind
11210 69 63 65 73 20 62 75 69 6c 74 20 6f 6e 20 61 6e ices built on an
11220 20 75 6e 64 65 66 69 6e 65 64 0a 2a 2a 20 63 6f undefined.** co
11230 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
11240 20 6d 61 79 20 6e 6f 74 20 62 65 20 72 65 61 64 may not be read
11250 20 6f 72 20 77 72 69 74 74 65 6e 2e 0a 2a 2f 0a or written..*/.
11260 73 74 72 75 63 74 20 43 6f 6c 6c 53 65 71 20 7b struct CollSeq {
11270 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 . char *zName;
11280 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 /* Name
11290 20 6f 66 20 74 68 65 20 63 6f 6c 6c 61 74 69 6e of the collatin
112a0 67 20 73 65 71 75 65 6e 63 65 2c 20 55 54 46 2d g sequence, UTF-
112b0 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 75 8 encoded */. u
112c0 38 20 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 8 enc;
112d0 20 20 20 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 /* Text enc
112e0 6f 64 69 6e 67 20 68 61 6e 64 6c 65 64 20 62 79 oding handled by
112f0 20 78 43 6d 70 28 29 20 2a 2f 0a 20 20 76 6f 69 xCmp() */. voi
11300 64 20 2a 70 55 73 65 72 3b 20 20 20 20 20 20 20 d *pUser;
11310 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 /* First argu
11320 6d 65 6e 74 20 74 6f 20 78 43 6d 70 28 29 20 2a ment to xCmp() *
11330 2f 0a 20 20 69 6e 74 20 28 2a 78 43 6d 70 29 28 /. int (*xCmp)(
11340 76 6f 69 64 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 void*,int, const
11350 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 63 6f 6e void*, int, con
11360 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 76 6f 69 st void*);. voi
11370 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 d (*xDel)(void*)
11380 3b 20 20 2f 2a 20 44 65 73 74 72 75 63 74 6f 72 ; /* Destructor
11390 20 66 6f 72 20 70 55 73 65 72 20 2a 2f 0a 7d 3b for pUser */.};
113a0 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 6f 72 74 20 6f ../*.** A sort o
113b0 72 64 65 72 20 63 61 6e 20 62 65 20 65 69 74 68 rder can be eith
113c0 65 72 20 41 53 43 20 6f 72 20 44 45 53 43 2e 0a er ASC or DESC..
113d0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
113e0 45 5f 53 4f 5f 41 53 43 20 20 20 20 20 20 20 30 E_SO_ASC 0
113f0 20 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 /* Sort in asc
11400 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a ending order */.
11410 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
11420 4f 5f 44 45 53 43 20 20 20 20 20 20 31 20 20 2f O_DESC 1 /
11430 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 65 6e 64 * Sort in ascend
11440 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 23 64 65 ing order */.#de
11450 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 4f 5f 55 fine SQLITE_SO_U
11460 4e 44 45 46 49 4e 45 44 20 2d 31 20 2f 2a 20 4e NDEFINED -1 /* N
11470 6f 20 73 6f 72 74 20 6f 72 64 65 72 20 73 70 65 o sort order spe
11480 63 69 66 69 65 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a cified */../*.**
11490 20 43 6f 6c 75 6d 6e 20 61 66 66 69 6e 69 74 79 Column affinity
114a0 20 74 79 70 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 types..**.** Th
114b0 65 73 65 20 75 73 65 64 20 74 6f 20 68 61 76 65 ese used to have
114c0 20 6d 6e 65 6d 6f 6e 69 63 20 6e 61 6d 65 20 6c mnemonic name l
114d0 69 6b 65 20 27 69 27 20 66 6f 72 20 53 51 4c 49 ike 'i' for SQLI
114e0 54 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 20 61 TE_AFF_INTEGER a
114f0 6e 64 0a 2a 2a 20 27 74 27 20 66 6f 72 20 53 51 nd.** 't' for SQ
11500 4c 49 54 45 5f 41 46 46 5f 54 45 58 54 2e 20 20 LITE_AFF_TEXT.
11510 42 75 74 20 77 65 20 63 61 6e 20 73 61 76 65 20 But we can save
11520 61 20 6c 69 74 74 6c 65 20 73 70 61 63 65 20 61 a little space a
11530 6e 64 20 69 6d 70 72 6f 76 65 0a 2a 2a 20 74 68 nd improve.** th
11540 65 20 73 70 65 65 64 20 61 20 6c 69 74 74 6c 65 e speed a little
11550 20 62 79 20 6e 75 6d 62 65 72 69 6e 67 20 74 68 by numbering th
11560 65 20 76 61 6c 75 65 73 20 63 6f 6e 73 65 63 75 e values consecu
11570 74 69 76 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 42 75 tively..**.** Bu
11580 74 20 72 61 74 68 65 72 20 74 68 61 6e 20 73 74 t rather than st
11590 61 72 74 20 77 69 74 68 20 30 20 6f 72 20 31 2c art with 0 or 1,
115a0 20 77 65 20 62 65 67 69 6e 20 77 69 74 68 20 27 we begin with '
115b0 41 27 2e 20 20 54 68 61 74 20 77 61 79 2c 0a 2a A'. That way,.*
115c0 2a 20 77 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 * when multiple
115d0 61 66 66 69 6e 69 74 79 20 74 79 70 65 73 20 61 affinity types a
115e0 72 65 20 63 6f 6e 63 61 74 65 6e 61 74 65 64 20 re concatenated
115f0 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 61 6e into a string an
11600 64 0a 2a 2a 20 75 73 65 64 20 61 73 20 74 68 65 d.** used as the
11610 20 50 34 20 6f 70 65 72 61 6e 64 2c 20 74 68 65 P4 operand, the
11620 79 20 77 69 6c 6c 20 62 65 20 6d 6f 72 65 20 72 y will be more r
11630 65 61 64 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 4e eadable..**.** N
11640 6f 74 65 20 61 6c 73 6f 20 74 68 61 74 20 74 68 ote also that th
11650 65 20 6e 75 6d 65 72 69 63 20 74 79 70 65 73 20 e numeric types
11660 61 72 65 20 67 72 6f 75 70 65 64 20 74 6f 67 65 are grouped toge
11670 74 68 65 72 20 73 6f 20 74 68 61 74 20 74 65 73 ther so that tes
11680 74 69 6e 67 0a 2a 2a 20 66 6f 72 20 61 20 6e 75 ting.** for a nu
11690 6d 65 72 69 63 20 74 79 70 65 20 69 73 20 61 20 meric type is a
116a0 73 69 6e 67 6c 65 20 63 6f 6d 70 61 72 69 73 6f single compariso
116b0 6e 2e 20 20 41 6e 64 20 74 68 65 20 42 4c 4f 42 n. And the BLOB
116c0 20 74 79 70 65 20 69 73 20 66 69 72 73 74 2e 0a type is first..
116d0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
116e0 45 5f 41 46 46 5f 42 4c 4f 42 20 20 20 20 20 27 E_AFF_BLOB '
116f0 41 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 A'.#define SQLIT
11700 45 5f 41 46 46 5f 54 45 58 54 20 20 20 20 20 27 E_AFF_TEXT '
11710 42 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 B'.#define SQLIT
11720 45 5f 41 46 46 5f 4e 55 4d 45 52 49 43 20 20 27 E_AFF_NUMERIC '
11730 43 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 C'.#define SQLIT
11740 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 20 20 27 E_AFF_INTEGER '
11750 44 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 D'.#define SQLIT
11760 45 5f 41 46 46 5f 52 45 41 4c 20 20 20 20 20 27 E_AFF_REAL '
11770 45 27 0a 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 E'..#define sqli
11780 74 65 33 49 73 4e 75 6d 65 72 69 63 41 66 66 69 te3IsNumericAffi
11790 6e 69 74 79 28 58 29 20 20 28 28 58 29 3e 3d 53 nity(X) ((X)>=S
117a0 51 4c 49 54 45 5f 41 46 46 5f 4e 55 4d 45 52 49 QLITE_AFF_NUMERI
117b0 43 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 C)../*.** The SQ
117c0 4c 49 54 45 5f 41 46 46 5f 4d 41 53 4b 20 76 61 LITE_AFF_MASK va
117d0 6c 75 65 73 20 6d 61 73 6b 73 20 6f 66 66 20 74 lues masks off t
117e0 68 65 20 73 69 67 6e 69 66 69 63 61 6e 74 20 62 he significant b
117f0 69 74 73 20 6f 66 20 61 6e 0a 2a 2a 20 61 66 66 its of an.** aff
11800 69 6e 69 74 79 20 76 61 6c 75 65 2e 0a 2a 2f 0a inity value..*/.
11810 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 #define SQLITE_A
11820 46 46 5f 4d 41 53 4b 20 20 20 20 20 30 78 34 37 FF_MASK 0x47
11830 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 69 74 69 6f 6e ../*.** Addition
11840 61 6c 20 62 69 74 20 76 61 6c 75 65 73 20 74 68 al bit values th
11850 61 74 20 63 61 6e 20 62 65 20 4f 52 65 64 20 77 at can be ORed w
11860 69 74 68 20 61 6e 20 61 66 66 69 6e 69 74 79 20 ith an affinity
11870 77 69 74 68 6f 75 74 0a 2a 2a 20 63 68 61 6e 67 without.** chang
11880 69 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 ing the affinity
11890 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 ..**.** The SQLI
118a0 54 45 5f 4e 4f 54 4e 55 4c 4c 20 66 6c 61 67 20 TE_NOTNULL flag
118b0 69 73 20 61 20 63 6f 6d 62 69 6e 61 74 69 6f 6e is a combination
118c0 20 6f 66 20 4e 55 4c 4c 45 51 20 61 6e 64 20 4a of NULLEQ and J
118d0 55 4d 50 49 46 4e 55 4c 4c 2e 0a 2a 2a 20 49 74 UMPIFNULL..** It
118e0 20 63 61 75 73 65 73 20 61 6e 20 61 73 73 65 72 causes an asser
118f0 74 28 29 20 74 6f 20 66 69 72 65 20 69 66 20 65 t() to fire if e
11900 69 74 68 65 72 20 6f 70 65 72 61 6e 64 20 74 6f ither operand to
11910 20 61 20 63 6f 6d 70 61 72 69 73 6f 6e 0a 2a 2a a comparison.**
11920 20 6f 70 65 72 61 74 6f 72 20 69 73 20 4e 55 4c operator is NUL
11930 4c 2e 20 20 49 74 20 69 73 20 61 64 64 65 64 20 L. It is added
11940 74 6f 20 63 65 72 74 61 69 6e 20 63 6f 6d 70 61 to certain compa
11950 72 69 73 6f 6e 20 6f 70 65 72 61 74 6f 72 73 20 rison operators
11960 74 6f 0a 2a 2a 20 70 72 6f 76 65 20 74 68 61 74 to.** prove that
11970 20 74 68 65 20 6f 70 65 72 61 6e 64 73 20 61 72 the operands ar
11980 65 20 61 6c 77 61 79 73 20 4e 4f 54 20 4e 55 4c e always NOT NUL
11990 4c 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 L..*/.#define SQ
119a0 4c 49 54 45 5f 4b 45 45 50 4e 55 4c 4c 20 20 20 LITE_KEEPNULL
119b0 20 20 30 78 30 38 20 20 2f 2a 20 55 73 65 64 20 0x08 /* Used
119c0 62 79 20 76 65 63 74 6f 72 20 3d 3d 20 6f 72 20 by vector == or
119d0 3c 3e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 <> */.#define SQ
119e0 4c 49 54 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c 20 LITE_JUMPIFNULL
119f0 20 20 30 78 31 30 20 20 2f 2a 20 6a 75 6d 70 73 0x10 /* jumps
11a00 20 69 66 20 65 69 74 68 65 72 20 6f 70 65 72 61 if either opera
11a10 6e 64 20 69 73 20 4e 55 4c 4c 20 2a 2f 0a 23 64 nd is NULL */.#d
11a20 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 54 4f efine SQLITE_STO
11a30 52 45 50 32 20 20 20 20 20 20 30 78 32 30 20 20 REP2 0x20
11a40 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 /* Store result
11a50 69 6e 20 72 65 67 5b 50 32 5d 20 72 61 74 68 65 in reg[P2] rathe
11a60 72 20 74 68 61 6e 20 6a 75 6d 70 20 2a 2f 0a 23 r than jump */.#
11a70 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 55 define SQLITE_NU
11a80 4c 4c 45 51 20 20 20 20 20 20 20 30 78 38 30 20 LLEQ 0x80
11a90 20 2f 2a 20 4e 55 4c 4c 3d 4e 55 4c 4c 20 2a 2f /* NULL=NULL */
11aa0 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
11ab0 4e 4f 54 4e 55 4c 4c 20 20 20 20 20 20 30 78 39 NOTNULL 0x9
11ac0 30 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 0 /* Assert tha
11ad0 74 20 6f 70 65 72 61 6e 64 73 20 61 72 65 20 6e t operands are n
11ae0 65 76 65 72 20 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a ever NULL */../*
11af0 0a 2a 2a 20 41 6e 20 6f 62 6a 65 63 74 20 6f 66 .** An object of
11b00 20 74 68 69 73 20 74 79 70 65 20 69 73 20 63 72 this type is cr
11b10 65 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 76 eated for each v
11b20 69 72 74 75 61 6c 20 74 61 62 6c 65 20 70 72 65 irtual table pre
11b30 73 65 6e 74 20 69 6e 0a 2a 2a 20 74 68 65 20 64 sent in.** the d
11b40 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 0a atabase schema..
11b50 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 **.** If the dat
11b60 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 abase schema is
11b70 73 68 61 72 65 64 2c 20 74 68 65 6e 20 74 68 65 shared, then the
11b80 72 65 20 69 73 20 6f 6e 65 20 69 6e 73 74 61 6e re is one instan
11b90 63 65 20 6f 66 20 74 68 69 73 0a 2a 2a 20 73 74 ce of this.** st
11ba0 72 75 63 74 75 72 65 20 66 6f 72 20 65 61 63 68 ructure for each
11bb0 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
11bc0 74 69 6f 6e 20 28 73 71 6c 69 74 65 33 2a 29 20 tion (sqlite3*)
11bd0 74 68 61 74 20 75 73 65 73 20 74 68 65 20 73 68 that uses the sh
11be0 61 72 65 64 0a 2a 2a 20 73 63 68 65 6d 61 2e 20 ared.** schema.
11bf0 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65 20 This is because
11c00 65 61 63 68 20 64 61 74 61 62 61 73 65 20 63 6f each database co
11c10 6e 6e 65 63 74 69 6f 6e 20 72 65 71 75 69 72 65 nnection require
11c20 73 20 69 74 73 20 6f 77 6e 20 75 6e 69 71 75 65 s its own unique
11c30 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 .** instance of
11c40 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 the sqlite3_vtab
11c50 2a 20 68 61 6e 64 6c 65 20 75 73 65 64 20 74 6f * handle used to
11c60 20 61 63 63 65 73 73 20 74 68 65 20 76 69 72 74 access the virt
11c70 75 61 6c 20 74 61 62 6c 65 0a 2a 2a 20 69 6d 70 ual table.** imp
11c80 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 73 71 6c lementation. sql
11c90 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 6c ite3_vtab* handl
11ca0 65 73 20 63 61 6e 20 6e 6f 74 20 62 65 20 73 68 es can not be sh
11cb0 61 72 65 64 20 62 65 74 77 65 65 6e 0a 2a 2a 20 ared between.**
11cc0 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
11cd0 69 6f 6e 73 2c 20 65 76 65 6e 20 77 68 65 6e 20 ions, even when
11ce0 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 the rest of the
11cf0 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 in-memory databa
11d00 73 65 0a 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 se.** schema is
11d10 73 68 61 72 65 64 2c 20 61 73 20 74 68 65 20 69 shared, as the i
11d20 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 mplementation of
11d30 74 65 6e 20 73 74 6f 72 65 73 20 74 68 65 20 64 ten stores the d
11d40 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 atabase.** conne
11d50 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 70 61 73 ction handle pas
11d60 73 65 64 20 74 6f 20 69 74 20 76 69 61 20 74 68 sed to it via th
11d70 65 20 78 43 6f 6e 6e 65 63 74 28 29 20 6f 72 20 e xConnect() or
11d80 78 43 72 65 61 74 65 28 29 20 6d 65 74 68 6f 64 xCreate() method
11d90 0a 2a 2a 20 64 75 72 69 6e 67 20 69 6e 69 74 69 .** during initi
11da0 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 74 65 72 6e alization intern
11db0 61 6c 6c 79 2e 20 54 68 69 73 20 64 61 74 61 62 ally. This datab
11dc0 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 ase connection h
11dd0 61 6e 64 6c 65 20 6d 61 79 0a 2a 2a 20 74 68 65 andle may.** the
11de0 6e 20 62 65 20 75 73 65 64 20 62 79 20 74 68 65 n be used by the
11df0 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 69 virtual table i
11e00 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 74 6f mplementation to
11e10 20 61 63 63 65 73 73 20 72 65 61 6c 20 74 61 62 access real tab
11e20 6c 65 73 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 les.** within th
11e30 65 20 64 61 74 61 62 61 73 65 2e 20 53 6f 20 74 e database. So t
11e40 68 61 74 20 74 68 65 79 20 61 70 70 65 61 72 20 hat they appear
11e50 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 as part of the c
11e60 61 6c 6c 65 72 73 0a 2a 2a 20 74 72 61 6e 73 61 allers.** transa
11e70 63 74 69 6f 6e 2c 20 74 68 65 73 65 20 61 63 63 ction, these acc
11e80 65 73 73 65 73 20 6e 65 65 64 20 74 6f 20 62 65 esses need to be
11e90 20 6d 61 64 65 20 76 69 61 20 74 68 65 20 73 61 made via the sa
11ea0 6d 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 me database.** c
11eb0 6f 6e 6e 65 63 74 69 6f 6e 20 61 73 20 74 68 61 onnection as tha
11ec0 74 20 75 73 65 64 20 74 6f 20 65 78 65 63 75 74 t used to execut
11ed0 65 20 53 51 4c 20 6f 70 65 72 61 74 69 6f 6e 73 e SQL operations
11ee0 20 6f 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 on the virtual
11ef0 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c table..**.** All
11f00 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 74 73 20 VTable objects
11f10 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 that correspond
11f20 74 6f 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c to a single tabl
11f30 65 20 69 6e 20 61 20 73 68 61 72 65 64 0a 2a 2a e in a shared.**
11f40 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
11f50 20 61 72 65 20 69 6e 69 74 69 61 6c 6c 79 20 73 are initially s
11f60 74 6f 72 65 64 20 69 6e 20 61 20 6c 69 6e 6b 65 tored in a linke
11f70 64 2d 6c 69 73 74 20 70 6f 69 6e 74 65 64 20 74 d-list pointed t
11f80 6f 20 62 79 0a 2a 2a 20 74 68 65 20 54 61 62 6c o by.** the Tabl
11f90 65 2e 70 56 54 61 62 6c 65 20 6d 65 6d 62 65 72 e.pVTable member
11fa0 20 76 61 72 69 61 62 6c 65 20 6f 66 20 74 68 65 variable of the
11fb0 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 54 corresponding T
11fc0 61 62 6c 65 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 able object..**
11fd0 57 68 65 6e 20 61 6e 20 73 71 6c 69 74 65 33 5f When an sqlite3_
11fe0 70 72 65 70 61 72 65 28 29 20 6f 70 65 72 61 74 prepare() operat
11ff0 69 6f 6e 20 69 73 20 72 65 71 75 69 72 65 64 20 ion is required
12000 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 76 69 to access the vi
12010 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 2c 20 rtual.** table,
12020 69 74 20 73 65 61 72 63 68 65 73 20 74 68 65 20 it searches the
12030 6c 69 73 74 20 66 6f 72 20 74 68 65 20 56 54 61 list for the VTa
12040 62 6c 65 20 74 68 61 74 20 63 6f 72 72 65 73 70 ble that corresp
12050 6f 6e 64 73 20 74 6f 20 74 68 65 0a 2a 2a 20 64 onds to the.** d
12060 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
12070 6f 6e 20 64 6f 69 6e 67 20 74 68 65 20 70 72 65 on doing the pre
12080 70 61 72 69 6e 67 20 73 6f 20 61 73 20 74 6f 20 paring so as to
12090 75 73 65 20 74 68 65 20 63 6f 72 72 65 63 74 0a use the correct.
120a0 2a 2a 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a ** sqlite3_vtab*
120b0 20 68 61 6e 64 6c 65 20 69 6e 20 74 68 65 20 63 handle in the c
120c0 6f 6d 70 69 6c 65 64 20 71 75 65 72 79 2e 0a 2a ompiled query..*
120d0 2a 0a 2a 2a 20 57 68 65 6e 20 61 6e 20 69 6e 2d *.** When an in-
120e0 6d 65 6d 6f 72 79 20 54 61 62 6c 65 20 6f 62 6a memory Table obj
120f0 65 63 74 20 69 73 20 64 65 6c 65 74 65 64 20 28 ect is deleted (
12100 66 6f 72 20 65 78 61 6d 70 6c 65 20 77 68 65 6e for example when
12110 20 74 68 65 0a 2a 2a 20 73 63 68 65 6d 61 20 69 the.** schema i
12120 73 20 62 65 69 6e 67 20 72 65 6c 6f 61 64 65 64 s being reloaded
12130 20 66 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e for some reason
12140 29 2c 20 74 68 65 20 56 54 61 62 6c 65 20 6f 62 ), the VTable ob
12150 6a 65 63 74 73 20 61 72 65 20 6e 6f 74 0a 2a 2a jects are not.**
12160 20 64 65 6c 65 74 65 64 20 61 6e 64 20 74 68 65 deleted and the
12170 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 sqlite3_vtab* h
12180 61 6e 64 6c 65 73 20 61 72 65 20 6e 6f 74 20 78 andles are not x
12190 44 69 73 63 6f 6e 6e 65 63 74 28 29 65 64 0a 2a Disconnect()ed.*
121a0 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e 20 49 * immediately. I
121b0 6e 73 74 65 61 64 2c 20 74 68 65 79 20 61 72 65 nstead, they are
121c0 20 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 moved from the
121d0 54 61 62 6c 65 2e 70 56 54 61 62 6c 65 20 6c 69 Table.pVTable li
121e0 73 74 20 74 6f 0a 2a 2a 20 61 6e 6f 74 68 65 72 st to.** another
121f0 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 linked list hea
12200 64 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 ded by the sqlit
12210 65 33 2e 70 44 69 73 63 6f 6e 6e 65 63 74 20 6d e3.pDisconnect m
12220 65 6d 62 65 72 20 6f 66 20 74 68 65 0a 2a 2a 20 ember of the.**
12230 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 corresponding sq
12240 6c 69 74 65 33 20 73 74 72 75 63 74 75 72 65 2e lite3 structure.
12250 20 54 68 65 79 20 61 72 65 20 74 68 65 6e 20 64 They are then d
12260 65 6c 65 74 65 64 2f 78 44 69 73 63 6f 6e 6e 65 eleted/xDisconne
12270 63 74 65 64 0a 2a 2a 20 6e 65 78 74 20 74 69 6d cted.** next tim
12280 65 20 61 20 73 74 61 74 65 6d 65 6e 74 20 69 73 e a statement is
12290 20 70 72 65 70 61 72 65 64 20 75 73 69 6e 67 20 prepared using
122a0 73 61 69 64 20 73 71 6c 69 74 65 33 2a 2e 20 54 said sqlite3*. T
122b0 68 69 73 20 69 73 20 64 6f 6e 65 0a 2a 2a 20 74 his is done.** t
122c0 6f 20 61 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b o avoid deadlock
122d0 20 69 73 73 75 65 73 20 69 6e 76 6f 6c 76 69 6e issues involvin
122e0 67 20 6d 75 6c 74 69 70 6c 65 20 73 71 6c 69 74 g multiple sqlit
122f0 65 33 2e 6d 75 74 65 78 20 6d 75 74 65 78 65 73 e3.mutex mutexes
12300 2e 0a 2a 2a 20 52 65 66 65 72 20 74 6f 20 63 6f ..** Refer to co
12310 6d 6d 65 6e 74 73 20 61 62 6f 76 65 20 66 75 6e mments above fun
12320 63 74 69 6f 6e 20 73 71 6c 69 74 65 33 56 74 61 ction sqlite3Vta
12330 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 29 20 66 6f bUnlockList() fo
12340 72 20 61 6e 0a 2a 2a 20 65 78 70 6c 61 6e 61 74 r an.** explanat
12350 69 6f 6e 20 61 73 20 74 6f 20 77 68 79 20 69 74 ion as to why it
12360 20 69 73 20 73 61 66 65 20 74 6f 20 61 64 64 20 is safe to add
12370 61 6e 20 65 6e 74 72 79 20 74 6f 20 61 6e 20 73 an entry to an s
12380 71 6c 69 74 65 33 2e 70 44 69 73 63 6f 6e 6e 65 qlite3.pDisconne
12390 63 74 0a 2a 2a 20 6c 69 73 74 20 77 69 74 68 6f ct.** list witho
123a0 75 74 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 63 ut holding the c
123b0 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c orresponding sql
123c0 69 74 65 33 2e 6d 75 74 65 78 20 6d 75 74 65 78 ite3.mutex mutex
123d0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 65 6d 6f ..**.** The memo
123e0 72 79 20 66 6f 72 20 6f 62 6a 65 63 74 73 20 6f ry for objects o
123f0 66 20 74 68 69 73 20 74 79 70 65 20 69 73 20 61 f this type is a
12400 6c 77 61 79 73 20 61 6c 6c 6f 63 61 74 65 64 20 lways allocated
12410 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 44 62 4d by.** sqlite3DbM
12420 61 6c 6c 6f 63 28 29 2c 20 75 73 69 6e 67 20 74 alloc(), using t
12430 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 he connection ha
12440 6e 64 6c 65 20 73 74 6f 72 65 64 20 69 6e 20 56 ndle stored in V
12450 54 61 62 6c 65 2e 64 62 20 61 73 0a 2a 2a 20 74 Table.db as.** t
12460 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e he first argumen
12470 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56 54 61 t..*/.struct VTa
12480 62 6c 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 ble {. sqlite3
12490 2a 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 *db;
124a0 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f /* Database co
124b0 6e 6e 65 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 nnection associa
124c0 74 65 64 20 77 69 74 68 20 74 68 69 73 20 74 61 ted with this ta
124d0 62 6c 65 20 2a 2f 0a 20 20 4d 6f 64 75 6c 65 20 ble */. Module
124e0 2a 70 4d 6f 64 3b 20 20 20 20 20 20 20 20 20 20 *pMod;
124f0 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
12500 20 6d 6f 64 75 6c 65 20 69 6d 70 6c 65 6d 65 6e module implemen
12510 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69 tation */. sqli
12520 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62 3b te3_vtab *pVtab;
12530 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
12540 20 74 6f 20 76 74 61 62 20 69 6e 73 74 61 6e 63 to vtab instanc
12550 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b e */. int nRef;
12560 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12570 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f /* Number of po
12580 69 6e 74 65 72 73 20 74 6f 20 74 68 69 73 20 73 inters to this s
12590 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 75 38 tructure */. u8
125a0 20 62 43 6f 6e 73 74 72 61 69 6e 74 3b 20 20 20 bConstraint;
125b0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
125c0 69 66 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 if constraints a
125d0 72 65 20 73 75 70 70 6f 72 74 65 64 20 2a 2f 0a re supported */.
125e0 20 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 int iSavepoint
125f0 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 ; /* D
12600 65 70 74 68 20 6f 66 20 74 68 65 20 53 41 56 45 epth of the SAVE
12610 50 4f 49 4e 54 20 73 74 61 63 6b 20 2a 2f 0a 20 POINT stack */.
12620 20 56 54 61 62 6c 65 20 2a 70 4e 65 78 74 3b 20 VTable *pNext;
12630 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 /* Ne
12640 78 74 20 69 6e 20 6c 69 6e 6b 65 64 20 6c 69 73 xt in linked lis
12650 74 20 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f t (see above) */
12660 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 .};../*.** The s
12670 63 68 65 6d 61 20 66 6f 72 20 65 61 63 68 20 53 chema for each S
12680 51 4c 20 74 61 62 6c 65 20 61 6e 64 20 76 69 65 QL table and vie
12690 77 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 64 w is represented
126a0 20 69 6e 20 6d 65 6d 6f 72 79 0a 2a 2a 20 62 79 in memory.** by
126b0 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 an instance of
126c0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
126d0 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 ructure..*/.stru
126e0 63 74 20 54 61 62 6c 65 20 7b 0a 20 20 63 68 61 ct Table {. cha
126f0 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 r *zName;
12700 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 /* Name of the
12710 20 74 61 62 6c 65 20 6f 72 20 76 69 65 77 20 2a table or view *
12720 2f 0a 20 20 43 6f 6c 75 6d 6e 20 2a 61 43 6f 6c /. Column *aCol
12730 3b 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 66 6f ; /* Info
12740 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 65 61 rmation about ea
12750 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 49 ch column */. I
12760 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 20 20 20 ndex *pIndex;
12770 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 53 /* List of S
12780 51 4c 20 69 6e 64 65 78 65 73 20 6f 6e 20 74 68 QL indexes on th
12790 69 73 20 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 53 is table. */. S
127a0 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 3b 20 elect *pSelect;
127b0 20 20 20 20 2f 2a 20 4e 55 4c 4c 20 66 6f 72 20 /* NULL for
127c0 74 61 62 6c 65 73 2e 20 20 50 6f 69 6e 74 73 20 tables. Points
127d0 74 6f 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 66 to definition if
127e0 20 61 20 76 69 65 77 2e 20 2a 2f 0a 20 20 46 4b a view. */. FK
127f0 65 79 20 2a 70 46 4b 65 79 3b 20 20 20 20 20 20 ey *pFKey;
12800 20 20 20 2f 2a 20 4c 69 6e 6b 65 64 20 6c 69 73 /* Linked lis
12810 74 20 6f 66 20 61 6c 6c 20 66 6f 72 65 69 67 6e t of all foreign
12820 20 6b 65 79 73 20 69 6e 20 74 68 69 73 20 74 61 keys in this ta
12830 62 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a ble */. char *z
12840 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 20 2f 2a ColAff; /*
12850 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 6e 67 String defining
12860 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 the affinity of
12870 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a each column */.
12880 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68 65 ExprList *pChe
12890 63 6b 3b 20 20 20 20 2f 2a 20 41 6c 6c 20 43 48 ck; /* All CH
128a0 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 ECK constraints
128b0 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 */.
128c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 20 2e /* .
128d0 2e 2e 20 61 6c 73 6f 20 75 73 65 64 20 61 73 20 .. also used as
128e0 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 6c 69 73 74 column name list
128f0 20 69 6e 20 61 20 56 49 45 57 20 2a 2f 0a 20 20 in a VIEW */.
12900 69 6e 74 20 74 6e 75 6d 3b 20 20 20 20 20 20 20 int tnum;
12910 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 42 54 72 /* Root BTr
12920 65 65 20 70 61 67 65 20 66 6f 72 20 74 68 69 73 ee page for this
12930 20 74 61 62 6c 65 20 2a 2f 0a 20 20 75 33 32 20 table */. u32
12940 6e 54 61 62 52 65 66 3b 20 20 20 20 20 20 20 20 nTabRef;
12950 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f /* Number of po
12960 69 6e 74 65 72 73 20 74 6f 20 74 68 69 73 20 54 inters to this T
12970 61 62 6c 65 20 2a 2f 0a 20 20 75 33 32 20 74 61 able */. u32 ta
12980 62 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 2f bFlags; /
12990 2a 20 4d 61 73 6b 20 6f 66 20 54 46 5f 2a 20 76 * Mask of TF_* v
129a0 61 6c 75 65 73 20 2a 2f 0a 20 20 69 31 36 20 69 alues */. i16 i
129b0 50 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 PKey;
129c0 2f 2a 20 49 66 20 6e 6f 74 20 6e 65 67 61 74 69 /* If not negati
129d0 76 65 2c 20 75 73 65 20 61 43 6f 6c 5b 69 50 4b ve, use aCol[iPK
129e0 65 79 5d 20 61 73 20 74 68 65 20 72 6f 77 69 64 ey] as the rowid
129f0 20 2a 2f 0a 20 20 69 31 36 20 6e 43 6f 6c 3b 20 */. i16 nCol;
12a00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
12a10 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
12a20 69 6e 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f in this table */
12a30 0a 20 20 4c 6f 67 45 73 74 20 6e 52 6f 77 4c 6f . LogEst nRowLo
12a40 67 45 73 74 3b 20 20 20 2f 2a 20 45 73 74 69 6d gEst; /* Estim
12a50 61 74 65 64 20 72 6f 77 73 20 69 6e 20 74 61 62 ated rows in tab
12a60 6c 65 20 2d 20 66 72 6f 6d 20 73 71 6c 69 74 65 le - from sqlite
12a70 5f 73 74 61 74 31 20 74 61 62 6c 65 20 2a 2f 0a _stat1 table */.
12a80 20 20 4c 6f 67 45 73 74 20 73 7a 54 61 62 52 6f LogEst szTabRo
12a90 77 3b 20 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 w; /* Estima
12aa0 74 65 64 20 73 69 7a 65 20 6f 66 20 65 61 63 68 ted size of each
12ab0 20 74 61 62 6c 65 20 72 6f 77 20 69 6e 20 62 79 table row in by
12ac0 74 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 tes */.#ifdef SQ
12ad0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 53 54 LITE_ENABLE_COST
12ae0 4d 55 4c 54 0a 20 20 4c 6f 67 45 73 74 20 63 6f MULT. LogEst co
12af0 73 74 4d 75 6c 74 3b 20 20 20 20 20 2f 2a 20 43 stMult; /* C
12b00 6f 73 74 20 6d 75 6c 74 69 70 6c 69 65 72 20 66 ost multiplier f
12b10 6f 72 20 75 73 69 6e 67 20 74 68 69 73 20 74 61 or using this ta
12b20 62 6c 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 ble */.#endif.
12b30 75 38 20 6b 65 79 43 6f 6e 66 3b 20 20 20 20 20 u8 keyConf;
12b40 20 20 20 20 20 2f 2a 20 57 68 61 74 20 74 6f 20 /* What to
12b50 64 6f 20 69 6e 20 63 61 73 65 20 6f 66 20 75 6e do in case of un
12b60 69 71 75 65 6e 65 73 73 20 63 6f 6e 66 6c 69 63 iqueness conflic
12b70 74 20 6f 6e 20 69 50 4b 65 79 20 2a 2f 0a 23 69 t on iPKey */.#i
12b80 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
12b90 54 5f 41 4c 54 45 52 54 41 42 4c 45 0a 20 20 69 T_ALTERTABLE. i
12ba0 6e 74 20 61 64 64 43 6f 6c 4f 66 66 73 65 74 3b nt addColOffset;
12bb0 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e /* Offset in
12bc0 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 CREATE TABLE st
12bd0 6d 74 20 74 6f 20 61 64 64 20 61 20 6e 65 77 20 mt to add a new
12be0 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 65 6e 64 69 66 column */.#endif
12bf0 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
12c00 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
12c10 45 0a 20 20 69 6e 74 20 6e 4d 6f 64 75 6c 65 41 E. int nModuleA
12c20 72 67 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 rg; /* Numb
12c30 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 er of arguments
12c40 74 6f 20 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f to the module */
12c50 0a 20 20 63 68 61 72 20 2a 2a 61 7a 4d 6f 64 75 . char **azModu
12c60 6c 65 41 72 67 3b 20 20 2f 2a 20 30 3a 20 6d 6f leArg; /* 0: mo
12c70 64 75 6c 65 20 31 3a 20 73 63 68 65 6d 61 20 32 dule 1: schema 2
12c80 3a 20 76 74 61 62 20 6e 61 6d 65 20 33 2e 2e 2e : vtab name 3...
12c90 3a 20 61 72 67 73 20 2a 2f 0a 20 20 56 54 61 62 : args */. VTab
12ca0 6c 65 20 2a 70 56 54 61 62 6c 65 3b 20 20 20 20 le *pVTable;
12cb0 20 2f 2a 20 4c 69 73 74 20 6f 66 20 56 54 61 62 /* List of VTab
12cc0 6c 65 20 6f 62 6a 65 63 74 73 2e 20 2a 2f 0a 23 le objects. */.#
12cd0 65 6e 64 69 66 0a 20 20 54 72 69 67 67 65 72 20 endif. Trigger
12ce0 2a 70 54 72 69 67 67 65 72 3b 20 20 20 2f 2a 20 *pTrigger; /*
12cf0 4c 69 73 74 20 6f 66 20 74 72 69 67 67 65 72 73 List of triggers
12d00 20 73 74 6f 72 65 64 20 69 6e 20 70 53 63 68 65 stored in pSche
12d10 6d 61 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a ma */. Schema *
12d20 70 53 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 pSchema; /*
12d30 53 63 68 65 6d 61 20 74 68 61 74 20 63 6f 6e 74 Schema that cont
12d40 61 69 6e 73 20 74 68 69 73 20 74 61 62 6c 65 20 ains this table
12d50 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 4e 65 78 */. Table *pNex
12d60 74 5a 6f 6d 62 69 65 3b 20 20 2f 2a 20 4e 65 78 tZombie; /* Nex
12d70 74 20 6f 6e 20 74 68 65 20 50 61 72 73 65 2e 70 t on the Parse.p
12d80 5a 6f 6d 62 69 65 54 61 62 20 6c 69 73 74 20 2a ZombieTab list *
12d90 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f /.};../*.** Allo
12da0 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 54 wed values for T
12db0 61 62 6c 65 2e 74 61 62 46 6c 61 67 73 2e 0a 2a able.tabFlags..*
12dc0 2a 0a 2a 2a 20 54 46 5f 4f 4f 4f 48 69 64 64 65 *.** TF_OOOHidde
12dd0 6e 20 61 70 70 6c 69 65 73 20 74 6f 20 74 61 62 n applies to tab
12de0 6c 65 73 20 6f 72 20 76 69 65 77 20 74 68 61 74 les or view that
12df0 20 68 61 76 65 20 68 69 64 64 65 6e 20 63 6f 6c have hidden col
12e00 75 6d 6e 73 20 74 68 61 74 20 61 72 65 0a 2a 2a umns that are.**
12e10 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6e 6f 6e followed by non
12e20 2d 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 2e -hidden columns.
12e30 20 20 45 78 61 6d 70 6c 65 3a 20 20 22 43 52 45 Example: "CRE
12e40 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c ATE VIRTUAL TABL
12e50 45 20 78 20 55 53 49 4e 47 0a 2a 2a 20 76 74 61 E x USING.** vta
12e60 62 31 28 61 20 48 49 44 44 45 4e 2c 20 62 29 3b b1(a HIDDEN, b);
12e70 22 2e 20 20 53 69 6e 63 65 20 22 62 22 20 69 73 ". Since "b" is
12e80 20 61 20 6e 6f 6e 2d 68 69 64 64 65 6e 20 63 6f a non-hidden co
12e90 6c 75 6d 6e 20 62 75 74 20 22 61 22 20 69 73 20 lumn but "a" is
12ea0 68 69 64 64 65 6e 2c 0a 2a 2a 20 74 68 65 20 54 hidden,.** the T
12eb0 46 5f 4f 4f 4f 48 69 64 64 65 6e 20 61 74 74 72 F_OOOHidden attr
12ec0 69 62 75 74 65 20 77 6f 75 6c 64 20 61 70 70 6c ibute would appl
12ed0 79 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 y in this case.
12ee0 20 53 75 63 68 20 74 61 62 6c 65 73 20 72 65 71 Such tables req
12ef0 75 69 72 65 0a 2a 2a 20 73 70 65 63 69 61 6c 20 uire.** special
12f00 68 61 6e 64 6c 69 6e 67 20 64 75 72 69 6e 67 20 handling during
12f10 49 4e 53 45 52 54 20 70 72 6f 63 65 73 73 69 6e INSERT processin
12f20 67 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 g..*/.#define TF
12f30 5f 52 65 61 64 6f 6e 6c 79 20 20 20 20 20 20 20 _Readonly
12f40 20 30 78 30 30 30 31 20 20 20 20 2f 2a 20 52 65 0x0001 /* Re
12f50 61 64 2d 6f 6e 6c 79 20 73 79 73 74 65 6d 20 74 ad-only system t
12f60 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 able */.#define
12f70 54 46 5f 45 70 68 65 6d 65 72 61 6c 20 20 20 20 TF_Ephemeral
12f80 20 20 20 30 78 30 30 30 32 20 20 20 20 2f 2a 20 0x0002 /*
12f90 41 6e 20 65 70 68 65 6d 65 72 61 6c 20 74 61 62 An ephemeral tab
12fa0 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 le */.#define TF
12fb0 5f 48 61 73 50 72 69 6d 61 72 79 4b 65 79 20 20 _HasPrimaryKey
12fc0 20 30 78 30 30 30 34 20 20 20 20 2f 2a 20 54 61 0x0004 /* Ta
12fd0 62 6c 65 20 68 61 73 20 61 20 70 72 69 6d 61 72 ble has a primar
12fe0 79 20 6b 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 y key */.#define
12ff0 20 54 46 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e TF_Autoincremen
13000 74 20 20 20 30 78 30 30 30 38 20 20 20 20 2f 2a t 0x0008 /*
13010 20 49 6e 74 65 67 65 72 20 70 72 69 6d 61 72 79 Integer primary
13020 20 6b 65 79 20 69 73 20 61 75 74 6f 69 6e 63 72 key is autoincr
13030 65 6d 65 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 ement */.#define
13040 20 54 46 5f 48 61 73 53 74 61 74 31 20 20 20 20 TF_HasStat1
13050 20 20 20 20 30 78 30 30 31 30 20 20 20 20 2f 2a 0x0010 /*
13060 20 6e 52 6f 77 4c 6f 67 45 73 74 20 73 65 74 20 nRowLogEst set
13070 66 72 6f 6d 20 73 71 6c 69 74 65 5f 73 74 61 74 from sqlite_stat
13080 31 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 1 */.#define TF_
13090 57 69 74 68 6f 75 74 52 6f 77 69 64 20 20 20 20 WithoutRowid
130a0 30 78 30 30 32 30 20 20 20 20 2f 2a 20 4e 6f 20 0x0020 /* No
130b0 72 6f 77 69 64 2e 20 20 50 52 49 4d 41 52 59 20 rowid. PRIMARY
130c0 4b 45 59 20 69 73 20 74 68 65 20 6b 65 79 20 2a KEY is the key *
130d0 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 4e 6f 56 /.#define TF_NoV
130e0 69 73 69 62 6c 65 52 6f 77 69 64 20 20 30 78 30 isibleRowid 0x0
130f0 30 34 30 20 20 20 20 2f 2a 20 4e 6f 20 75 73 65 040 /* No use
13100 72 2d 76 69 73 69 62 6c 65 20 22 72 6f 77 69 64 r-visible "rowid
13110 22 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 65 66 " column */.#def
13120 69 6e 65 20 54 46 5f 4f 4f 4f 48 69 64 64 65 6e ine TF_OOOHidden
13130 20 20 20 20 20 20 20 30 78 30 30 38 30 20 20 20 0x0080
13140 20 2f 2a 20 4f 75 74 2d 6f 66 2d 4f 72 64 65 72 /* Out-of-Order
13150 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 20 hidden columns
13160 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 53 74 */.#define TF_St
13170 61 74 73 55 73 65 64 20 20 20 20 20 20 20 30 78 atsUsed 0x
13180 30 31 30 30 20 20 20 20 2f 2a 20 51 75 65 72 79 0100 /* Query
13190 20 70 6c 61 6e 6e 65 72 20 64 65 63 69 73 69 6f planner decisio
131a0 6e 73 20 61 66 66 65 63 74 65 64 20 62 79 0a 20 ns affected by.
131b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
131c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
131d0 20 20 20 20 2a 2a 20 49 6e 64 65 78 2e 61 69 52 ** Index.aiR
131e0 6f 77 4c 6f 67 45 73 74 5b 5d 20 76 61 6c 75 65 owLogEst[] value
131f0 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f s */.#define TF_
13200 48 61 73 4e 6f 74 4e 75 6c 6c 20 20 20 20 20 20 HasNotNull
13210 30 78 30 32 30 30 20 20 20 20 2f 2a 20 43 6f 6e 0x0200 /* Con
13220 74 61 69 6e 73 20 4e 4f 54 20 4e 55 4c 4c 20 63 tains NOT NULL c
13230 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 0a 2f onstraints */../
13240 2a 0a 2a 2a 20 54 65 73 74 20 74 6f 20 73 65 65 *.** Test to see
13250 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
13260 61 20 74 61 62 6c 65 20 69 73 20 61 20 76 69 72 a table is a vir
13270 74 75 61 6c 20 74 61 62 6c 65 2e 20 20 54 68 69 tual table. Thi
13280 73 20 69 73 0a 2a 2a 20 64 6f 6e 65 20 61 73 20 s is.** done as
13290 61 20 6d 61 63 72 6f 20 73 6f 20 74 68 61 74 20 a macro so that
132a0 69 74 20 77 69 6c 6c 20 62 65 20 6f 70 74 69 6d it will be optim
132b0 69 7a 65 64 20 6f 75 74 20 77 68 65 6e 20 76 69 ized out when vi
132c0 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 20 73 rtual.** table s
132d0 75 70 70 6f 72 74 20 69 73 20 6f 6d 69 74 74 65 upport is omitte
132e0 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 d from the build
132f0 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
13300 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
13310 54 41 42 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 TABLE.# define
13320 49 73 56 69 72 74 75 61 6c 28 58 29 20 20 20 20 IsVirtual(X)
13330 20 20 28 28 58 29 2d 3e 6e 4d 6f 64 75 6c 65 41 ((X)->nModuleA
13340 72 67 29 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 rg).#else.# def
13350 69 6e 65 20 49 73 56 69 72 74 75 61 6c 28 58 29 ine IsVirtual(X)
13360 20 20 20 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 0.#endif..
13370 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 6f 20 /*.** Macros to
13380 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 20 63 determine if a c
13390 6f 6c 75 6d 6e 20 69 73 20 68 69 64 64 65 6e 2e olumn is hidden.
133a0 20 20 49 73 4f 72 64 69 6e 61 72 79 48 69 64 64 IsOrdinaryHidd
133b0 65 6e 43 6f 6c 75 6d 6e 28 29 0a 2a 2a 20 6f 6e enColumn().** on
133c0 6c 79 20 77 6f 72 6b 73 20 66 6f 72 20 6e 6f 6e ly works for non
133d0 2d 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 -virtual tables
133e0 28 6f 72 64 69 6e 61 72 79 20 74 61 62 6c 65 73 (ordinary tables
133f0 20 61 6e 64 20 76 69 65 77 73 29 20 61 6e 64 20 and views) and
13400 69 73 0a 2a 2a 20 61 6c 77 61 79 73 20 66 61 6c is.** always fal
13410 73 65 20 75 6e 6c 65 73 73 20 53 51 4c 49 54 45 se unless SQLITE
13420 5f 45 4e 41 42 4c 45 5f 48 49 44 44 45 4e 5f 43 _ENABLE_HIDDEN_C
13430 4f 4c 55 4d 4e 53 20 69 73 20 64 65 66 69 6e 65 OLUMNS is define
13440 64 2e 20 20 54 68 65 0a 2a 2a 20 49 73 48 69 64 d. The.** IsHid
13450 64 65 6e 43 6f 6c 75 6d 6e 28 29 20 6d 61 63 72 denColumn() macr
13460 6f 20 69 73 20 67 65 6e 65 72 61 6c 20 70 75 72 o is general pur
13470 70 6f 73 65 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 pose..*/.#if def
13480 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
13490 4c 45 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e LE_HIDDEN_COLUMN
134a0 53 29 0a 23 20 20 64 65 66 69 6e 65 20 49 73 48 S).# define IsH
134b0 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 iddenColumn(X)
134c0 20 20 20 20 20 20 20 28 28 28 58 29 2d 3e 63 6f (((X)->co
134d0 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 lFlags & COLFLAG
134e0 5f 48 49 44 44 45 4e 29 21 3d 30 29 0a 23 20 20 _HIDDEN)!=0).#
134f0 64 65 66 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 define IsOrdinar
13500 79 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 yHiddenColumn(X)
13510 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c 61 67 73 (((X)->colFlags
13520 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 45 & COLFLAG_HIDDE
13530 4e 29 21 3d 30 29 0a 23 65 6c 69 66 20 21 64 65 N)!=0).#elif !de
13540 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 fined(SQLITE_OMI
13550 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 0a T_VIRTUALTABLE).
13560 23 20 20 64 65 66 69 6e 65 20 49 73 48 69 64 64 # define IsHidd
13570 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 20 20 20 enColumn(X)
13580 20 20 20 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c (((X)->colFl
13590 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 ags & COLFLAG_HI
135a0 44 44 45 4e 29 21 3d 30 29 0a 23 20 20 64 65 66 DDEN)!=0).# def
135b0 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 48 69 ine IsOrdinaryHi
135c0 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 30 0a ddenColumn(X) 0.
135d0 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 #else.# define
135e0 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 IsHiddenColumn(X
135f0 29 20 20 20 20 20 20 20 20 20 30 0a 23 20 20 64 ) 0.# d
13600 65 66 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 efine IsOrdinary
13610 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 HiddenColumn(X)
13620 30 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 20 44 6f 0.#endif.../* Do
13630 65 73 20 74 68 65 20 74 61 62 6c 65 20 68 61 76 es the table hav
13640 65 20 61 20 72 6f 77 69 64 20 2a 2f 0a 23 64 65 e a rowid */.#de
13650 66 69 6e 65 20 48 61 73 52 6f 77 69 64 28 58 29 fine HasRowid(X)
13660 20 20 20 20 20 28 28 28 58 29 2d 3e 74 61 62 46 (((X)->tabF
13670 6c 61 67 73 20 26 20 54 46 5f 57 69 74 68 6f 75 lags & TF_Withou
13680 74 52 6f 77 69 64 29 3d 3d 30 29 0a 23 64 65 66 tRowid)==0).#def
13690 69 6e 65 20 56 69 73 69 62 6c 65 52 6f 77 69 64 ine VisibleRowid
136a0 28 58 29 20 28 28 28 58 29 2d 3e 74 61 62 46 6c (X) (((X)->tabFl
136b0 61 67 73 20 26 20 54 46 5f 4e 6f 56 69 73 69 62 ags & TF_NoVisib
136c0 6c 65 52 6f 77 69 64 29 3d 3d 30 29 0a 0a 2f 2a leRowid)==0)../*
136d0 0a 2a 2a 20 45 61 63 68 20 66 6f 72 65 69 67 6e .** Each foreign
136e0 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 key constraint
136f0 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f is an instance o
13700 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
13710 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a structure..**.**
13720 20 41 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 69 A foreign key i
13730 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 s associated wit
13740 68 20 74 77 6f 20 74 61 62 6c 65 73 2e 20 20 54 h two tables. T
13750 68 65 20 22 66 72 6f 6d 22 20 74 61 62 6c 65 20 he "from" table
13760 69 73 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 is.** the table
13770 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
13780 65 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c 61 e REFERENCES cla
13790 75 73 65 20 74 68 61 74 20 63 72 65 61 74 65 73 use that creates
137a0 20 74 68 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 the foreign.**
137b0 6b 65 79 2e 20 20 54 68 65 20 22 74 6f 22 20 74 key. The "to" t
137c0 61 62 6c 65 20 69 73 20 74 68 65 20 74 61 62 6c able is the tabl
137d0 65 20 74 68 61 74 20 69 73 20 6e 61 6d 65 64 20 e that is named
137e0 69 6e 20 74 68 65 20 52 45 46 45 52 45 4e 43 45 in the REFERENCE
137f0 53 20 63 6c 61 75 73 65 2e 0a 2a 2a 20 43 6f 6e S clause..** Con
13800 73 69 64 65 72 20 74 68 69 73 20 65 78 61 6d 70 sider this examp
13810 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 le:.**.** CR
13820 45 41 54 45 20 54 41 42 4c 45 20 65 78 31 28 0a EATE TABLE ex1(.
13830 2a 2a 20 20 20 20 20 20 20 61 20 49 4e 54 45 47 ** a INTEG
13840 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a ER PRIMARY KEY,.
13850 2a 2a 20 20 20 20 20 20 20 62 20 49 4e 54 45 47 ** b INTEG
13860 45 52 20 43 4f 4e 53 54 52 41 49 4e 54 20 66 6b ER CONSTRAINT fk
13870 31 20 52 45 46 45 52 45 4e 43 45 53 20 65 78 32 1 REFERENCES ex2
13880 28 78 29 0a 2a 2a 20 20 20 20 20 29 3b 0a 2a 2a (x).** );.**
13890 0a 2a 2a 20 46 6f 72 20 66 6f 72 65 69 67 6e 20 .** For foreign
138a0 6b 65 79 20 22 66 6b 31 22 2c 20 74 68 65 20 66 key "fk1", the f
138b0 72 6f 6d 2d 74 61 62 6c 65 20 69 73 20 22 65 78 rom-table is "ex
138c0 31 22 20 61 6e 64 20 74 68 65 20 74 6f 2d 74 61 1" and the to-ta
138d0 62 6c 65 20 69 73 20 22 65 78 32 22 2e 0a 2a 2a ble is "ex2"..**
138e0 20 45 71 75 69 76 61 6c 65 6e 74 20 6e 61 6d 65 Equivalent name
138f0 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 66 72 6f s:.**.** fro
13900 6d 2d 74 61 62 6c 65 20 3d 3d 20 63 68 69 6c 64 m-table == child
13910 2d 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 -table.**
13920 74 6f 2d 74 61 62 6c 65 20 3d 3d 20 70 61 72 65 to-table == pare
13930 6e 74 2d 74 61 62 6c 65 0a 2a 2a 0a 2a 2a 20 45 nt-table.**.** E
13940 61 63 68 20 52 45 46 45 52 45 4e 43 45 53 20 63 ach REFERENCES c
13950 6c 61 75 73 65 20 67 65 6e 65 72 61 74 65 73 20 lause generates
13960 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
13970 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
13980 75 63 74 75 72 65 0a 2a 2a 20 77 68 69 63 68 20 ucture.** which
13990 69 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 is attached to t
139a0 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 2e 20 20 he from-table.
139b0 54 68 65 20 74 6f 2d 74 61 62 6c 65 20 6e 65 65 The to-table nee
139c0 64 20 6e 6f 74 20 65 78 69 73 74 20 77 68 65 6e d not exist when
139d0 0a 2a 2a 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 .** the from-tab
139e0 6c 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 le is created.
139f0 54 68 65 20 65 78 69 73 74 65 6e 63 65 20 6f 66 The existence of
13a00 20 74 68 65 20 74 6f 2d 74 61 62 6c 65 20 69 73 the to-table is
13a10 20 6e 6f 74 20 63 68 65 63 6b 65 64 2e 0a 2a 2a not checked..**
13a20 0a 2a 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 .** The list of
13a30 61 6c 6c 20 70 61 72 65 6e 74 73 20 66 6f 72 20 all parents for
13a40 63 68 69 6c 64 20 54 61 62 6c 65 20 58 20 69 73 child Table X is
13a50 20 68 65 6c 64 20 61 74 20 58 2e 70 46 4b 65 79 held at X.pFKey
13a60 2e 0a 2a 2a 0a 2a 2a 20 41 20 6c 69 73 74 20 6f ..**.** A list o
13a70 66 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 66 f all children f
13a80 6f 72 20 61 20 74 61 62 6c 65 20 6e 61 6d 65 64 or a table named
13a90 20 5a 20 28 77 68 69 63 68 20 6d 69 67 68 74 20 Z (which might
13aa0 6e 6f 74 20 65 76 65 6e 20 65 78 69 73 74 29 0a not even exist).
13ab0 2a 2a 20 69 73 20 68 65 6c 64 20 69 6e 20 53 63 ** is held in Sc
13ac0 68 65 6d 61 2e 66 6b 65 79 48 61 73 68 20 77 69 hema.fkeyHash wi
13ad0 74 68 20 61 20 68 61 73 68 20 6b 65 79 20 6f 66 th a hash key of
13ae0 20 5a 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 46 4b Z..*/.struct FK
13af0 65 79 20 7b 0a 20 20 54 61 62 6c 65 20 2a 70 46 ey {. Table *pF
13b00 72 6f 6d 3b 20 20 20 20 20 2f 2a 20 54 61 62 6c rom; /* Tabl
13b10 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 e containing the
13b20 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 REFERENCES clau
13b30 73 65 20 28 61 6b 61 3a 20 43 68 69 6c 64 29 20 se (aka: Child)
13b40 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 */. FKey *pNext
13b50 46 72 6f 6d 3b 20 20 2f 2a 20 4e 65 78 74 20 46 From; /* Next F
13b60 4b 65 79 20 77 69 74 68 20 74 68 65 20 73 61 6d Key with the sam
13b70 65 20 69 6e 20 70 46 72 6f 6d 2e 20 4e 65 78 74 e in pFrom. Next
13b80 20 70 61 72 65 6e 74 20 6f 66 20 70 46 72 6f 6d parent of pFrom
13b90 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 6f 3b */. char *zTo;
13ba0 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
13bb0 6f 66 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 of table that th
13bc0 65 20 6b 65 79 20 70 6f 69 6e 74 73 20 74 6f 20 e key points to
13bd0 28 61 6b 61 3a 20 50 61 72 65 6e 74 29 20 2a 2f (aka: Parent) */
13be0 0a 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 54 6f . FKey *pNextTo
13bf0 3b 20 20 20 20 2f 2a 20 4e 65 78 74 20 77 69 74 ; /* Next wit
13c00 68 20 74 68 65 20 73 61 6d 65 20 7a 54 6f 2e 20 h the same zTo.
13c10 4e 65 78 74 20 63 68 69 6c 64 20 6f 66 20 7a 54 Next child of zT
13c20 6f 2e 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 50 o. */. FKey *pP
13c30 72 65 76 54 6f 3b 20 20 20 20 2f 2a 20 50 72 65 revTo; /* Pre
13c40 76 69 6f 75 73 20 77 69 74 68 20 74 68 65 20 73 vious with the s
13c50 61 6d 65 20 7a 54 6f 20 2a 2f 0a 20 20 69 6e 74 ame zTo */. int
13c60 20 6e 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 2f nCol; /
13c70 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 * Number of colu
13c80 6d 6e 73 20 69 6e 20 74 68 69 73 20 6b 65 79 20 mns in this key
13c90 2a 2f 0a 20 20 2f 2a 20 45 56 3a 20 52 2d 33 30 */. /* EV: R-30
13ca0 33 32 33 2d 32 31 39 31 37 20 2a 2f 0a 20 20 75 323-21917 */. u
13cb0 38 20 69 73 44 65 66 65 72 72 65 64 3b 20 20 20 8 isDeferred;
13cc0 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 /* True if c
13cd0 6f 6e 73 74 72 61 69 6e 74 20 63 68 65 63 6b 69 onstraint checki
13ce0 6e 67 20 69 73 20 64 65 66 65 72 72 65 64 20 74 ng is deferred t
13cf0 69 6c 6c 20 43 4f 4d 4d 49 54 20 2a 2f 0a 20 20 ill COMMIT */.
13d00 75 38 20 61 41 63 74 69 6f 6e 5b 32 5d 3b 20 20 u8 aAction[2];
13d10 20 20 20 20 20 20 2f 2a 20 4f 4e 20 44 45 4c 45 /* ON DELE
13d20 54 45 20 61 6e 64 20 4f 4e 20 55 50 44 41 54 45 TE and ON UPDATE
13d30 20 61 63 74 69 6f 6e 73 2c 20 72 65 73 70 65 63 actions, respec
13d40 74 69 76 65 6c 79 20 2a 2f 0a 20 20 54 72 69 67 tively */. Trig
13d50 67 65 72 20 2a 61 70 54 72 69 67 67 65 72 5b 32 ger *apTrigger[2
13d60 5d 3b 2f 2a 20 54 72 69 67 67 65 72 73 20 66 6f ];/* Triggers fo
13d70 72 20 61 41 63 74 69 6f 6e 5b 5d 20 61 63 74 69 r aAction[] acti
13d80 6f 6e 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 ons */. struct
13d90 73 43 6f 6c 4d 61 70 20 7b 20 20 20 20 20 20 2f sColMap { /
13da0 2a 20 4d 61 70 70 69 6e 67 20 6f 66 20 63 6f 6c * Mapping of col
13db0 75 6d 6e 73 20 69 6e 20 70 46 72 6f 6d 20 74 6f umns in pFrom to
13dc0 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 7a 54 6f 20 columns in zTo
13dd0 2a 2f 0a 20 20 20 20 69 6e 74 20 69 46 72 6f 6d */. int iFrom
13de0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
13df0 49 6e 64 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 Index of column
13e00 69 6e 20 70 46 72 6f 6d 20 2a 2f 0a 20 20 20 20 in pFrom */.
13e10 63 68 61 72 20 2a 7a 43 6f 6c 3b 20 20 20 20 20 char *zCol;
13e20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
13e30 20 63 6f 6c 75 6d 6e 20 69 6e 20 7a 54 6f 2e 20 column in zTo.
13e40 20 49 66 20 4e 55 4c 4c 20 75 73 65 20 50 52 49 If NULL use PRI
13e50 4d 41 52 59 20 4b 45 59 20 2a 2f 0a 20 20 7d 20 MARY KEY */. }
13e60 61 43 6f 6c 5b 31 5d 3b 20 20 20 20 20 20 20 20 aCol[1];
13e70 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 /* One entry
13e80 20 66 6f 72 20 65 61 63 68 20 6f 66 20 6e 43 6f for each of nCo
13e90 6c 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 7d 3b 0a l columns */.};.
13ea0 0a 2f 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 73 75 ./*.** SQLite su
13eb0 70 70 6f 72 74 73 20 6d 61 6e 79 20 64 69 66 66 pports many diff
13ec0 65 72 65 6e 74 20 77 61 79 73 20 74 6f 20 72 65 erent ways to re
13ed0 73 6f 6c 76 65 20 61 20 63 6f 6e 73 74 72 61 69 solve a constrai
13ee0 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 20 20 52 4f nt.** error. RO
13ef0 4c 4c 42 41 43 4b 20 70 72 6f 63 65 73 73 69 6e LLBACK processin
13f00 67 20 6d 65 61 6e 73 20 74 68 61 74 20 61 20 63 g means that a c
13f10 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 onstraint violat
13f20 69 6f 6e 0a 2a 2a 20 63 61 75 73 65 73 20 74 68 ion.** causes th
13f30 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 e operation in p
13f40 72 6f 63 65 73 73 20 74 6f 20 66 61 69 6c 20 61 rocess to fail a
13f50 6e 64 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 nd for the curre
13f60 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a nt transaction.*
13f70 2a 20 74 6f 20 62 65 20 72 6f 6c 6c 65 64 20 62 * to be rolled b
13f80 61 63 6b 2e 20 20 41 42 4f 52 54 20 70 72 6f 63 ack. ABORT proc
13f90 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 68 65 essing means the
13fa0 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 operation in pr
13fb0 6f 63 65 73 73 0a 2a 2a 20 66 61 69 6c 73 20 61 ocess.** fails a
13fc0 6e 64 20 61 6e 79 20 70 72 69 6f 72 20 63 68 61 nd any prior cha
13fd0 6e 67 65 73 20 66 72 6f 6d 20 74 68 61 74 20 6f nges from that o
13fe0 6e 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 72 65 ne operation are
13ff0 20 62 61 63 6b 65 64 20 6f 75 74 2c 0a 2a 2a 20 backed out,.**
14000 62 75 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 but the transact
14010 69 6f 6e 20 69 73 20 6e 6f 74 20 72 6f 6c 6c 65 ion is not rolle
14020 64 20 62 61 63 6b 2e 20 20 46 41 49 4c 20 70 72 d back. FAIL pr
14030 6f 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 ocessing means t
14040 68 61 74 0a 2a 2a 20 74 68 65 20 6f 70 65 72 61 hat.** the opera
14050 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 tion in progress
14060 20 73 74 6f 70 73 20 61 6e 64 20 72 65 74 75 72 stops and retur
14070 6e 73 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 ns an error code
14080 2e 20 20 42 75 74 20 70 72 69 6f 72 0a 2a 2a 20 . But prior.**
14090 63 68 61 6e 67 65 73 20 64 75 65 20 74 6f 20 74 changes due to t
140a0 68 65 20 73 61 6d 65 20 6f 70 65 72 61 74 69 6f he same operatio
140b0 6e 20 61 72 65 20 6e 6f 74 20 62 61 63 6b 65 64 n are not backed
140c0 20 6f 75 74 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c out and no roll
140d0 62 61 63 6b 0a 2a 2a 20 6f 63 63 75 72 73 2e 20 back.** occurs.
140e0 20 49 47 4e 4f 52 45 20 6d 65 61 6e 73 20 74 68 IGNORE means th
140f0 61 74 20 74 68 65 20 70 61 72 74 69 63 75 6c 61 at the particula
14100 72 20 72 6f 77 20 74 68 61 74 20 63 61 75 73 65 r row that cause
14110 64 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 d the constraint
14120 0a 2a 2a 20 65 72 72 6f 72 20 69 73 20 6e 6f 74 .** error is not
14130 20 69 6e 73 65 72 74 65 64 20 6f 72 20 75 70 64 inserted or upd
14140 61 74 65 64 2e 20 20 50 72 6f 63 65 73 73 69 6e ated. Processin
14150 67 20 63 6f 6e 74 69 6e 75 65 73 20 61 6e 64 20 g continues and
14160 6e 6f 20 65 72 72 6f 72 0a 2a 2a 20 69 73 20 72 no error.** is r
14170 65 74 75 72 6e 65 64 2e 20 20 52 45 50 4c 41 43 eturned. REPLAC
14180 45 20 6d 65 61 6e 73 20 74 68 61 74 20 70 72 65 E means that pre
14190 65 78 69 73 74 69 6e 67 20 64 61 74 61 62 61 73 existing databas
141a0 65 20 72 6f 77 73 20 74 68 61 74 20 63 61 75 73 e rows that caus
141b0 65 64 0a 2a 2a 20 61 20 55 4e 49 51 55 45 20 63 ed.** a UNIQUE c
141c0 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 onstraint violat
141d0 69 6f 6e 20 61 72 65 20 72 65 6d 6f 76 65 64 20 ion are removed
141e0 73 6f 20 74 68 61 74 20 74 68 65 20 6e 65 77 20 so that the new
141f0 69 6e 73 65 72 74 20 6f 72 0a 2a 2a 20 75 70 64 insert or.** upd
14200 61 74 65 20 63 61 6e 20 70 72 6f 63 65 65 64 2e ate can proceed.
14210 20 20 50 72 6f 63 65 73 73 69 6e 67 20 63 6f 6e Processing con
14220 74 69 6e 75 65 73 20 61 6e 64 20 6e 6f 20 65 72 tinues and no er
14230 72 6f 72 20 69 73 20 72 65 70 6f 72 74 65 64 2e ror is reported.
14240 0a 2a 2a 0a 2a 2a 20 52 45 53 54 52 49 43 54 2c .**.** RESTRICT,
14250 20 53 45 54 4e 55 4c 4c 2c 20 61 6e 64 20 43 41 SETNULL, and CA
14260 53 43 41 44 45 20 61 63 74 69 6f 6e 73 20 61 70 SCADE actions ap
14270 70 6c 79 20 6f 6e 6c 79 20 74 6f 20 66 6f 72 65 ply only to fore
14280 69 67 6e 20 6b 65 79 73 2e 0a 2a 2a 20 52 45 53 ign keys..** RES
14290 54 52 49 43 54 20 69 73 20 74 68 65 20 73 61 6d TRICT is the sam
142a0 65 20 61 73 20 41 42 4f 52 54 20 66 6f 72 20 49 e as ABORT for I
142b0 4d 4d 45 44 49 41 54 45 20 66 6f 72 65 69 67 6e MMEDIATE foreign
142c0 20 6b 65 79 73 20 61 6e 64 20 74 68 65 0a 2a 2a keys and the.**
142d0 20 73 61 6d 65 20 61 73 20 52 4f 4c 4c 42 41 43 same as ROLLBAC
142e0 4b 20 66 6f 72 20 44 45 46 45 52 52 45 44 20 6b K for DEFERRED k
142f0 65 79 73 2e 20 20 53 45 54 4e 55 4c 4c 20 6d 65 eys. SETNULL me
14300 61 6e 73 20 74 68 61 74 20 74 68 65 20 66 6f 72 ans that the for
14310 65 69 67 6e 0a 2a 2a 20 6b 65 79 20 69 73 20 73 eign.** key is s
14320 65 74 20 74 6f 20 4e 55 4c 4c 2e 20 20 43 41 53 et to NULL. CAS
14330 43 41 44 45 20 6d 65 61 6e 73 20 74 68 61 74 20 CADE means that
14340 61 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 a DELETE or UPDA
14350 54 45 20 6f 66 20 74 68 65 0a 2a 2a 20 72 65 66 TE of the.** ref
14360 65 72 65 6e 63 65 64 20 74 61 62 6c 65 20 72 6f erenced table ro
14370 77 20 69 73 20 70 72 6f 70 61 67 61 74 65 64 20 w is propagated
14380 69 6e 74 6f 20 74 68 65 20 72 6f 77 20 74 68 61 into the row tha
14390 74 20 68 6f 6c 64 73 20 74 68 65 0a 2a 2a 20 66 t holds the.** f
143a0 6f 72 65 69 67 6e 20 6b 65 79 2e 0a 2a 2a 0a 2a oreign key..**.*
143b0 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
143c0 73 79 6d 62 6f 6c 69 63 20 76 61 6c 75 65 73 20 symbolic values
143d0 61 72 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f are used to reco
143e0 72 64 20 77 68 69 63 68 20 74 79 70 65 0a 2a 2a rd which type.**
143f0 20 6f 66 20 61 63 74 69 6f 6e 20 74 6f 20 74 61 of action to ta
14400 6b 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ke..*/.#define O
14410 45 5f 4e 6f 6e 65 20 20 20 20 20 30 20 20 20 2f E_None 0 /
14420 2a 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f * There is no co
14430 6e 73 74 72 61 69 6e 74 20 74 6f 20 63 68 65 63 nstraint to chec
14440 6b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f k */.#define OE_
14450 52 6f 6c 6c 62 61 63 6b 20 31 20 20 20 2f 2a 20 Rollback 1 /*
14460 46 61 69 6c 20 74 68 65 20 6f 70 65 72 61 74 69 Fail the operati
14470 6f 6e 20 61 6e 64 20 72 6f 6c 6c 62 61 63 6b 20 on and rollback
14480 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
14490 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 41 62 */.#define OE_Ab
144a0 6f 72 74 20 20 20 20 32 20 20 20 2f 2a 20 42 61 ort 2 /* Ba
144b0 63 6b 20 6f 75 74 20 63 68 61 6e 67 65 73 20 62 ck out changes b
144c0 75 74 20 64 6f 20 6e 6f 20 72 6f 6c 6c 62 61 63 ut do no rollbac
144d0 6b 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f k transaction */
144e0 0a 23 64 65 66 69 6e 65 20 4f 45 5f 46 61 69 6c .#define OE_Fail
144f0 20 20 20 20 20 33 20 20 20 2f 2a 20 53 74 6f 70 3 /* Stop
14500 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 62 the operation b
14510 75 74 20 6c 65 61 76 65 20 61 6c 6c 20 70 72 69 ut leave all pri
14520 6f 72 20 63 68 61 6e 67 65 73 20 2a 2f 0a 23 64 or changes */.#d
14530 65 66 69 6e 65 20 4f 45 5f 49 67 6e 6f 72 65 20 efine OE_Ignore
14540 20 20 34 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 4 /* Ignore
14550 74 68 65 20 65 72 72 6f 72 2e 20 44 6f 20 6e 6f the error. Do no
14560 74 20 64 6f 20 74 68 65 20 49 4e 53 45 52 54 20 t do the INSERT
14570 6f 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 65 or UPDATE */.#de
14580 66 69 6e 65 20 4f 45 5f 52 65 70 6c 61 63 65 20 fine OE_Replace
14590 20 35 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 65 5 /* Delete e
145a0 78 69 73 74 69 6e 67 20 72 65 63 6f 72 64 2c 20 xisting record,
145b0 74 68 65 6e 20 64 6f 20 49 4e 53 45 52 54 20 6f then do INSERT o
145c0 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 65 66 r UPDATE */.#def
145d0 69 6e 65 20 4f 45 5f 55 70 64 61 74 65 20 20 20 ine OE_Update
145e0 36 20 20 20 2f 2a 20 50 72 6f 63 65 73 73 20 61 6 /* Process a
145f0 73 20 61 20 44 4f 20 55 50 44 41 54 45 20 69 6e s a DO UPDATE in
14600 20 61 6e 20 75 70 73 65 72 74 20 2a 2f 0a 23 64 an upsert */.#d
14610 65 66 69 6e 65 20 4f 45 5f 52 65 73 74 72 69 63 efine OE_Restric
14620 74 20 37 20 20 20 2f 2a 20 4f 45 5f 41 62 6f 72 t 7 /* OE_Abor
14630 74 20 66 6f 72 20 49 4d 4d 45 44 49 41 54 45 2c t for IMMEDIATE,
14640 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b 20 66 6f 72 OE_Rollback for
14650 20 44 45 46 45 52 52 45 44 20 2a 2f 0a 23 64 65 DEFERRED */.#de
14660 66 69 6e 65 20 4f 45 5f 53 65 74 4e 75 6c 6c 20 fine OE_SetNull
14670 20 38 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 8 /* Set the
14680 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 61 6c 75 foreign key valu
14690 65 20 74 6f 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 e to NULL */.#de
146a0 66 69 6e 65 20 4f 45 5f 53 65 74 44 66 6c 74 20 fine OE_SetDflt
146b0 20 39 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 9 /* Set the
146c0 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 61 6c 75 foreign key valu
146d0 65 20 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 e to its default
146e0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 43 */.#define OE_C
146f0 61 73 63 61 64 65 20 20 31 30 20 20 2f 2a 20 43 ascade 10 /* C
14700 61 73 63 61 64 65 20 74 68 65 20 63 68 61 6e 67 ascade the chang
14710 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 es */.#define OE
14720 5f 44 65 66 61 75 6c 74 20 20 31 31 20 20 2f 2a _Default 11 /*
14730 20 44 6f 20 77 68 61 74 65 76 65 72 20 74 68 65 Do whatever the
14740 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 default action
14750 69 73 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6e is */.../*.** An
14760 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
14770 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
14780 74 75 72 65 20 69 73 20 70 61 73 73 65 64 20 61 ture is passed a
14790 73 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 s the first.** a
147a0 72 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74 rgument to sqlit
147b0 65 33 56 64 62 65 4b 65 79 43 6f 6d 70 61 72 65 e3VdbeKeyCompare
147c0 20 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 and is used to
147d0 63 6f 6e 74 72 6f 6c 20 74 68 65 0a 2a 2a 20 63 control the.** c
147e0 6f 6d 70 61 72 69 73 6f 6e 20 6f 66 20 74 68 65 omparison of the
147f0 20 74 77 6f 20 69 6e 64 65 78 20 6b 65 79 73 2e two index keys.
14800 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 .**.** Note that
14810 20 61 53 6f 72 74 4f 72 64 65 72 5b 5d 20 61 6e aSortOrder[] an
14820 64 20 61 43 6f 6c 6c 5b 5d 20 68 61 76 65 20 6e d aColl[] have n
14830 46 69 65 6c 64 2b 31 20 73 6c 6f 74 73 2e 20 20 Field+1 slots.
14840 54 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 46 69 There.** are nFi
14850 65 6c 64 20 73 6c 6f 74 73 20 66 6f 72 20 74 68 eld slots for th
14860 65 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6e 20 e columns of an
14870 69 6e 64 65 78 20 74 68 65 6e 20 6f 6e 65 20 65 index then one e
14880 78 74 72 61 20 73 6c 6f 74 0a 2a 2a 20 66 6f 72 xtra slot.** for
14890 20 74 68 65 20 72 6f 77 69 64 20 61 74 20 74 68 the rowid at th
148a0 65 20 65 6e 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 e end..*/.struct
148b0 20 4b 65 79 49 6e 66 6f 20 7b 0a 20 20 75 33 32 KeyInfo {. u32
148c0 20 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 nRef;
148d0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 /* Number of re
148e0 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 69 73 ferences to this
148f0 20 4b 65 79 49 6e 66 6f 20 6f 62 6a 65 63 74 20 KeyInfo object
14900 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 20 */. u8 enc;
14910 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 /* Text
14920 20 65 6e 63 6f 64 69 6e 67 20 2d 20 6f 6e 65 20 encoding - one
14930 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 55 54 of the SQLITE_UT
14940 46 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 F* values */. u
14950 31 36 20 6e 4b 65 79 46 69 65 6c 64 3b 20 20 20 16 nKeyField;
14960 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
14970 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 key columns in t
14980 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 31 he index */. u1
14990 36 20 6e 41 6c 6c 46 69 65 6c 64 3b 20 20 20 20 6 nAllField;
149a0 20 20 2f 2a 20 54 6f 74 61 6c 20 63 6f 6c 75 6d /* Total colum
149b0 6e 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 6b 65 ns, including ke
149c0 79 20 70 6c 75 73 20 6f 74 68 65 72 73 20 2a 2f y plus others */
149d0 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 . sqlite3 *db;
149e0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 /* The da
149f0 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
14a00 6e 20 2a 2f 0a 20 20 75 38 20 2a 61 53 6f 72 74 n */. u8 *aSort
14a10 4f 72 64 65 72 3b 20 20 20 20 20 2f 2a 20 53 6f Order; /* So
14a20 72 74 20 6f 72 64 65 72 20 66 6f 72 20 65 61 63 rt order for eac
14a30 68 20 63 6f 6c 75 6d 6e 2e 20 2a 2f 0a 20 20 43 h column. */. C
14a40 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 5b 31 5d ollSeq *aColl[1]
14a50 3b 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 ; /* Collating
14a60 73 65 71 75 65 6e 63 65 20 66 6f 72 20 65 61 63 sequence for eac
14a70 68 20 74 65 72 6d 20 6f 66 20 74 68 65 20 6b 65 h term of the ke
14a80 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 y */.};../*.** T
14a90 68 69 73 20 6f 62 6a 65 63 74 20 68 6f 6c 64 73 his object holds
14aa0 20 61 20 72 65 63 6f 72 64 20 77 68 69 63 68 20 a record which
14ab0 68 61 73 20 62 65 65 6e 20 70 61 72 73 65 64 20 has been parsed
14ac0 6f 75 74 20 69 6e 74 6f 20 69 6e 64 69 76 69 64 out into individ
14ad0 75 61 6c 0a 2a 2a 20 66 69 65 6c 64 73 2c 20 66 ual.** fields, f
14ae0 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 73 20 or the purposes
14af0 6f 66 20 64 6f 69 6e 67 20 61 20 63 6f 6d 70 61 of doing a compa
14b00 72 69 73 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 rison..**.** A r
14b10 65 63 6f 72 64 20 69 73 20 61 6e 20 6f 62 6a 65 ecord is an obje
14b20 63 74 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 ct that contains
14b30 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 66 69 65 one or more fie
14b40 6c 64 73 20 6f 66 20 64 61 74 61 2e 0a 2a 2a 20 lds of data..**
14b50 52 65 63 6f 72 64 73 20 61 72 65 20 75 73 65 64 Records are used
14b60 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 63 6f to store the co
14b70 6e 74 65 6e 74 20 6f 66 20 61 20 74 61 62 6c 65 ntent of a table
14b80 20 72 6f 77 20 61 6e 64 20 74 6f 20 73 74 6f 72 row and to stor
14b90 65 0a 2a 2a 20 74 68 65 20 6b 65 79 20 6f 66 20 e.** the key of
14ba0 61 6e 20 69 6e 64 65 78 2e 20 20 41 20 62 6c 6f an index. A blo
14bb0 62 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 61 20 b encoding of a
14bc0 72 65 63 6f 72 64 20 69 73 20 63 72 65 61 74 65 record is create
14bd0 64 20 62 79 0a 2a 2a 20 74 68 65 20 4f 50 5f 4d d by.** the OP_M
14be0 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 akeRecord opcode
14bf0 20 6f 66 20 74 68 65 20 56 44 42 45 20 61 6e 64 of the VDBE and
14c00 20 69 73 20 64 69 73 61 73 73 65 6d 62 6c 65 64 is disassembled
14c10 20 62 79 20 74 68 65 0a 2a 2a 20 4f 50 5f 43 6f by the.** OP_Co
14c20 6c 75 6d 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 0a lumn opcode..**.
14c30 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f ** An instance o
14c40 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 73 65 f this object se
14c50 72 76 65 73 20 61 73 20 61 20 22 6b 65 79 22 20 rves as a "key"
14c60 66 6f 72 20 64 6f 69 6e 67 20 61 20 73 65 61 72 for doing a sear
14c70 63 68 20 6f 6e 0a 2a 2a 20 61 6e 20 69 6e 64 65 ch on.** an inde
14c80 78 20 62 2b 74 72 65 65 2e 20 54 68 65 20 67 6f x b+tree. The go
14c90 61 6c 20 6f 66 20 74 68 65 20 73 65 61 72 63 68 al of the search
14ca0 20 69 73 20 74 6f 20 66 69 6e 64 20 74 68 65 20 is to find the
14cb0 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 69 73 entry that.** is
14cc0 20 63 6c 6f 73 65 64 20 74 6f 20 74 68 65 20 6b closed to the k
14cd0 65 79 20 64 65 73 63 72 69 62 65 64 20 62 79 20 ey described by
14ce0 74 68 69 73 20 6f 62 6a 65 63 74 2e 20 20 54 68 this object. Th
14cf0 69 73 20 6f 62 6a 65 63 74 20 6d 69 67 68 74 20 is object might
14d00 68 6f 6c 64 0a 2a 2a 20 6a 75 73 74 20 61 20 70 hold.** just a p
14d10 72 65 66 69 78 20 6f 66 20 74 68 65 20 6b 65 79 refix of the key
14d20 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 . The number of
14d30 20 66 69 65 6c 64 73 20 69 73 20 67 69 76 65 6e fields is given
14d40 20 62 79 0a 2a 2a 20 70 4b 65 79 49 6e 66 6f 2d by.** pKeyInfo-
14d50 3e 6e 46 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 >nField..**.** T
14d60 68 65 20 72 31 20 61 6e 64 20 72 32 20 66 69 65 he r1 and r2 fie
14d70 6c 64 73 20 61 72 65 20 74 68 65 20 76 61 6c 75 lds are the valu
14d80 65 73 20 74 6f 20 72 65 74 75 72 6e 20 69 66 20 es to return if
14d90 74 68 69 73 20 6b 65 79 20 69 73 20 6c 65 73 73 this key is less
14da0 20 74 68 61 6e 0a 2a 2a 20 6f 72 20 67 72 65 61 than.** or grea
14db0 74 65 72 20 74 68 61 6e 20 61 20 6b 65 79 20 69 ter than a key i
14dc0 6e 20 74 68 65 20 62 74 72 65 65 2c 20 72 65 73 n the btree, res
14dd0 70 65 63 74 69 76 65 6c 79 2e 20 20 54 68 65 73 pectively. Thes
14de0 65 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 0a 2a e are normally.*
14df0 2a 20 2d 31 20 61 6e 64 20 2b 31 20 72 65 73 70 * -1 and +1 resp
14e00 65 63 74 69 76 65 6c 79 2c 20 62 75 74 20 6d 69 ectively, but mi
14e10 67 68 74 20 62 65 20 69 6e 76 65 72 74 65 64 20 ght be inverted
14e20 74 6f 20 2b 31 20 61 6e 64 20 2d 31 20 69 66 20 to +1 and -1 if
14e30 74 68 65 20 62 2d 74 72 65 65 0a 2a 2a 20 69 73 the b-tree.** is
14e40 20 69 6e 20 44 45 53 43 20 6f 72 64 65 72 2e 0a in DESC order..
14e50 2a 2a 0a 2a 2a 20 54 68 65 20 6b 65 79 20 63 6f **.** The key co
14e60 6d 70 61 72 69 73 6f 6e 20 66 75 6e 63 74 69 6f mparison functio
14e70 6e 73 20 61 63 74 75 61 6c 6c 79 20 72 65 74 75 ns actually retu
14e80 72 6e 20 64 65 66 61 75 6c 74 5f 72 63 20 77 68 rn default_rc wh
14e90 65 6e 20 74 68 65 79 20 66 69 6e 64 0a 2a 2a 20 en they find.**
14ea0 61 6e 20 65 71 75 61 6c 73 20 63 6f 6d 70 61 72 an equals compar
14eb0 69 73 6f 6e 2e 20 20 64 65 66 61 75 6c 74 5f 72 ison. default_r
14ec0 63 20 63 61 6e 20 62 65 20 2d 31 2c 20 30 2c 20 c can be -1, 0,
14ed0 6f 72 20 2b 31 2e 20 20 49 66 20 74 68 65 72 65 or +1. If there
14ee0 20 61 72 65 0a 2a 2a 20 6d 75 6c 74 69 70 6c 65 are.** multiple
14ef0 20 65 6e 74 72 69 65 73 20 69 6e 20 74 68 65 20 entries in the
14f00 62 2d 74 72 65 65 20 77 69 74 68 20 74 68 65 20 b-tree with the
14f10 73 61 6d 65 20 6b 65 79 20 28 77 68 65 6e 20 6f same key (when o
14f20 6e 6c 79 20 6c 6f 6f 6b 69 6e 67 0a 2a 2a 20 61 nly looking.** a
14f30 74 20 74 68 65 20 66 69 72 73 74 20 70 4b 65 79 t the first pKey
14f40 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 73 2c 29 20 Info->nFields,)
14f50 74 68 65 6e 20 64 65 66 61 75 6c 74 5f 72 63 20 then default_rc
14f60 63 61 6e 20 62 65 20 73 65 74 20 74 6f 20 2d 31 can be set to -1
14f70 20 74 6f 0a 2a 2a 20 63 61 75 73 65 20 74 68 65 to.** cause the
14f80 20 73 65 61 72 63 68 20 74 6f 20 66 69 6e 64 20 search to find
14f90 74 68 65 20 6c 61 73 74 20 6d 61 74 63 68 2c 20 the last match,
14fa0 6f 72 20 2b 31 20 74 6f 20 63 61 75 73 65 20 74 or +1 to cause t
14fb0 68 65 20 73 65 61 72 63 68 20 74 6f 0a 2a 2a 20 he search to.**
14fc0 66 69 6e 64 20 74 68 65 20 66 69 72 73 74 20 6d find the first m
14fd0 61 74 63 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 atch..**.** The
14fe0 6b 65 79 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 key comparison f
14ff0 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 73 65 unctions will se
15000 74 20 65 71 53 65 65 6e 20 74 6f 20 74 72 75 65 t eqSeen to true
15010 20 69 66 20 74 68 65 79 20 65 76 65 72 0a 2a 2a if they ever.**
15020 20 67 65 74 20 61 6e 64 20 65 71 75 61 6c 20 72 get and equal r
15030 65 73 75 6c 74 73 20 77 68 65 6e 20 63 6f 6d 70 esults when comp
15040 61 72 69 6e 67 20 74 68 69 73 20 73 74 72 75 63 aring this struc
15050 74 75 72 65 20 74 6f 20 61 20 62 2d 74 72 65 65 ture to a b-tree
15060 20 72 65 63 6f 72 64 2e 0a 2a 2a 20 57 68 65 6e record..** When
15070 20 64 65 66 61 75 6c 74 5f 72 63 21 3d 30 2c 20 default_rc!=0,
15080 74 68 65 20 73 65 61 72 63 68 20 6d 69 67 68 74 the search might
15090 20 65 6e 64 20 75 70 20 6f 6e 20 74 68 65 20 72 end up on the r
150a0 65 63 6f 72 64 20 69 6d 6d 65 64 69 61 74 65 6c ecord immediatel
150b0 79 0a 2a 2a 20 62 65 66 6f 72 65 20 74 68 65 20 y.** before the
150c0 66 69 72 73 74 20 6d 61 74 63 68 20 6f 72 20 69 first match or i
150d0 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 mmediately after
150e0 20 74 68 65 20 6c 61 73 74 20 6d 61 74 63 68 2e the last match.
150f0 20 20 54 68 65 0a 2a 2a 20 65 71 53 65 65 6e 20 The.** eqSeen
15100 66 69 65 6c 64 20 77 69 6c 6c 20 69 6e 64 69 63 field will indic
15110 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e ate whether or n
15120 6f 74 20 61 6e 20 65 78 61 63 74 20 6d 61 74 63 ot an exact matc
15130 68 20 65 78 69 73 74 73 20 69 6e 20 74 68 65 0a h exists in the.
15140 2a 2a 20 62 2d 74 72 65 65 2e 0a 2a 2f 0a 73 74 ** b-tree..*/.st
15150 72 75 63 74 20 55 6e 70 61 63 6b 65 64 52 65 63 ruct UnpackedRec
15160 6f 72 64 20 7b 0a 20 20 4b 65 79 49 6e 66 6f 20 ord {. KeyInfo
15170 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 2f 2a 20 43 *pKeyInfo; /* C
15180 6f 6c 6c 61 74 69 6f 6e 20 61 6e 64 20 73 6f 72 ollation and sor
15190 74 2d 6f 72 64 65 72 20 69 6e 66 6f 72 6d 61 74 t-order informat
151a0 69 6f 6e 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d ion */. Mem *aM
151b0 65 6d 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 em; /*
151c0 56 61 6c 75 65 73 20 2a 2f 0a 20 20 75 31 36 20 Values */. u16
151d0 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 20 20 nField;
151e0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 /* Number of ent
151f0 72 69 65 73 20 69 6e 20 61 70 4d 65 6d 5b 5d 20 ries in apMem[]
15200 2a 2f 0a 20 20 69 38 20 64 65 66 61 75 6c 74 5f */. i8 default_
15210 72 63 3b 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 rc; /* Comp
15220 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20 69 66 arison result if
15230 20 6b 65 79 73 20 61 72 65 20 65 71 75 61 6c 20 keys are equal
15240 2a 2f 0a 20 20 75 38 20 65 72 72 43 6f 64 65 3b */. u8 errCode;
15250 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f /* Erro
15260 72 20 64 65 74 65 63 74 65 64 20 62 79 20 78 52 r detected by xR
15270 65 63 6f 72 64 43 6f 6d 70 61 72 65 20 28 43 4f ecordCompare (CO
15280 52 52 55 50 54 20 6f 72 20 4e 4f 4d 45 4d 29 20 RRUPT or NOMEM)
15290 2a 2f 0a 20 20 69 38 20 72 31 3b 20 20 20 20 20 */. i8 r1;
152a0 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 /* Valu
152b0 65 20 74 6f 20 72 65 74 75 72 6e 20 69 66 20 28 e to return if (
152c0 6c 68 73 20 3c 20 72 68 73 29 20 2a 2f 0a 20 20 lhs < rhs) */.
152d0 69 38 20 72 32 3b 20 20 20 20 20 20 20 20 20 20 i8 r2;
152e0 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 /* Value to
152f0 72 65 74 75 72 6e 20 69 66 20 28 6c 68 73 20 3e return if (lhs >
15300 20 72 68 73 29 20 2a 2f 0a 20 20 75 38 20 65 71 rhs) */. u8 eq
15310 53 65 65 6e 3b 20 20 20 20 20 20 20 20 20 20 2f Seen; /
15320 2a 20 54 72 75 65 20 69 66 20 61 6e 20 65 71 75 * True if an equ
15330 61 6c 69 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e ality comparison
15340 20 68 61 73 20 62 65 65 6e 20 73 65 65 6e 20 2a has been seen *
15350 2f 0a 7d 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 /.};.../*.** Eac
15360 68 20 53 51 4c 20 69 6e 64 65 78 20 69 73 20 72 h SQL index is r
15370 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 epresented in me
15380 6d 6f 72 79 20 62 79 20 61 6e 0a 2a 2a 20 69 6e mory by an.** in
15390 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
153a0 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
153b0 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6c e..**.** The col
153c0 75 6d 6e 73 20 6f 66 20 74 68 65 20 74 61 62 6c umns of the tabl
153d0 65 20 74 68 61 74 20 61 72 65 20 74 6f 20 62 65 e that are to be
153e0 20 69 6e 64 65 78 65 64 20 61 72 65 20 64 65 73 indexed are des
153f0 63 72 69 62 65 64 0a 2a 2a 20 62 79 20 74 68 65 cribed.** by the
15400 20 61 69 43 6f 6c 75 6d 6e 5b 5d 20 66 69 65 6c aiColumn[] fiel
15410 64 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 d of this struct
15420 75 72 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c ure. For exampl
15430 65 2c 20 73 75 70 70 6f 73 65 0a 2a 2a 20 77 65 e, suppose.** we
15440 20 68 61 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77 have the follow
15450 69 6e 67 20 74 61 62 6c 65 20 61 6e 64 20 69 6e ing table and in
15460 64 65 78 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 dex:.**.** C
15470 52 45 41 54 45 20 54 41 42 4c 45 20 45 78 31 28 REATE TABLE Ex1(
15480 63 31 20 69 6e 74 2c 20 63 32 20 69 6e 74 2c 20 c1 int, c2 int,
15490 63 33 20 74 65 78 74 29 3b 0a 2a 2a 20 20 20 20 c3 text);.**
154a0 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 45 78 CREATE INDEX Ex
154b0 32 20 4f 4e 20 45 78 31 28 63 33 2c 63 31 29 3b 2 ON Ex1(c3,c1);
154c0 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 54 61 .**.** In the Ta
154d0 62 6c 65 20 73 74 72 75 63 74 75 72 65 20 64 65 ble structure de
154e0 73 63 72 69 62 69 6e 67 20 45 78 31 2c 20 6e 43 scribing Ex1, nC
154f0 6f 6c 3d 3d 33 20 62 65 63 61 75 73 65 20 74 68 ol==3 because th
15500 65 72 65 20 61 72 65 0a 2a 2a 20 74 68 72 65 65 ere are.** three
15510 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 columns in the
15520 74 61 62 6c 65 2e 20 20 49 6e 20 74 68 65 20 49 table. In the I
15530 6e 64 65 78 20 73 74 72 75 63 74 75 72 65 20 64 ndex structure d
15540 65 73 63 72 69 62 69 6e 67 0a 2a 2a 20 45 78 32 escribing.** Ex2
15550 2c 20 6e 43 6f 6c 75 6d 6e 3d 3d 32 20 73 69 6e , nColumn==2 sin
15560 63 65 20 32 20 6f 66 20 74 68 65 20 33 20 63 6f ce 2 of the 3 co
15570 6c 75 6d 6e 73 20 6f 66 20 45 78 31 20 61 72 65 lumns of Ex1 are
15580 20 69 6e 64 65 78 65 64 2e 0a 2a 2a 20 54 68 65 indexed..** The
15590 20 76 61 6c 75 65 20 6f 66 20 61 69 43 6f 6c 75 value of aiColu
155a0 6d 6e 20 69 73 20 7b 32 2c 20 30 7d 2e 20 20 61 mn is {2, 0}. a
155b0 69 43 6f 6c 75 6d 6e 5b 30 5d 3d 3d 32 20 62 65 iColumn[0]==2 be
155c0 63 61 75 73 65 20 74 68 65 0a 2a 2a 20 66 69 72 cause the.** fir
155d0 73 74 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 st column to be
155e0 69 6e 64 65 78 65 64 20 28 63 33 29 20 68 61 73 indexed (c3) has
155f0 20 61 6e 20 69 6e 64 65 78 20 6f 66 20 32 20 69 an index of 2 i
15600 6e 20 45 78 31 2e 61 43 6f 6c 5b 5d 2e 0a 2a 2a n Ex1.aCol[]..**
15610 20 54 68 65 20 73 65 63 6f 6e 64 20 63 6f 6c 75 The second colu
15620 6d 6e 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 mn to be indexed
15630 20 28 63 31 29 20 68 61 73 20 61 6e 20 69 6e 64 (c1) has an ind
15640 65 78 20 6f 66 20 30 20 69 6e 0a 2a 2a 20 45 78 ex of 0 in.** Ex
15650 31 2e 61 43 6f 6c 5b 5d 2c 20 68 65 6e 63 65 20 1.aCol[], hence
15660 45 78 32 2e 61 69 43 6f 6c 75 6d 6e 5b 31 5d 3d Ex2.aiColumn[1]=
15670 3d 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 6e =0..**.** The In
15680 64 65 78 2e 6f 6e 45 72 72 6f 72 20 66 69 65 6c dex.onError fiel
15690 64 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 d determines whe
156a0 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 ther or not the
156b0 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d 6e 73 0a indexed columns.
156c0 2a 2a 20 6d 75 73 74 20 62 65 20 75 6e 69 71 75 ** must be uniqu
156d0 65 20 61 6e 64 20 77 68 61 74 20 74 6f 20 64 6f e and what to do
156e0 20 69 66 20 74 68 65 79 20 61 72 65 20 6e 6f 74 if they are not
156f0 2e 20 20 57 68 65 6e 20 49 6e 64 65 78 2e 6f 6e . When Index.on
15700 45 72 72 6f 72 3d 4f 45 5f 4e 6f 6e 65 2c 0a 2a Error=OE_None,.*
15710 2a 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 * it means this
15720 69 73 20 6e 6f 74 20 61 20 75 6e 69 71 75 65 20 is not a unique
15730 69 6e 64 65 78 2e 20 20 4f 74 68 65 72 77 69 73 index. Otherwis
15740 65 20 69 74 20 69 73 20 61 20 75 6e 69 71 75 65 e it is a unique
15750 20 69 6e 64 65 78 0a 2a 2a 20 61 6e 64 20 74 68 index.** and th
15760 65 20 76 61 6c 75 65 20 6f 66 20 49 6e 64 65 78 e value of Index
15770 2e 6f 6e 45 72 72 6f 72 20 69 6e 64 69 63 61 74 .onError indicat
15780 65 20 74 68 65 20 77 68 69 63 68 20 63 6f 6e 66 e the which conf
15790 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 0a lict resolution.
157a0 2a 2a 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 ** algorithm to
157b0 65 6d 70 6c 6f 79 20 77 68 65 6e 65 76 65 72 20 employ whenever
157c0 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 an attempt is ma
157d0 64 65 20 74 6f 20 69 6e 73 65 72 74 20 61 20 6e de to insert a n
157e0 6f 6e 2d 75 6e 69 71 75 65 0a 2a 2a 20 65 6c 65 on-unique.** ele
157f0 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 57 68 69 6c ment..**.** Whil
15800 65 20 70 61 72 73 69 6e 67 20 61 20 43 52 45 41 e parsing a CREA
15810 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 TE TABLE or CREA
15820 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 TE INDEX stateme
15830 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a nt in order to.*
15840 2a 20 67 65 6e 65 72 61 74 65 20 56 44 42 45 20 * generate VDBE
15850 63 6f 64 65 20 28 61 73 20 6f 70 70 6f 73 65 64 code (as opposed
15860 20 74 6f 20 70 61 72 73 69 6e 67 20 6f 6e 65 20 to parsing one
15870 72 65 61 64 20 66 72 6f 6d 20 61 6e 20 73 71 6c read from an sql
15880 69 74 65 5f 6d 61 73 74 65 72 0a 2a 2a 20 74 61 ite_master.** ta
15890 62 6c 65 20 61 73 20 70 61 72 74 20 6f 66 20 70 ble as part of p
158a0 61 72 73 69 6e 67 20 61 6e 20 65 78 69 73 74 69 arsing an existi
158b0 6e 67 20 64 61 74 61 62 61 73 65 20 73 63 68 65 ng database sche
158c0 6d 61 29 2c 20 74 72 61 6e 73 69 65 6e 74 20 69 ma), transient i
158d0 6e 73 74 61 6e 63 65 73 0a 2a 2a 20 6f 66 20 74 nstances.** of t
158e0 68 69 73 20 73 74 72 75 63 74 75 72 65 20 6d 61 his structure ma
158f0 79 20 62 65 20 63 72 65 61 74 65 64 2e 20 49 6e y be created. In
15900 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 49 this case the I
15910 6e 64 65 78 2e 74 6e 75 6d 20 76 61 72 69 61 62 ndex.tnum variab
15920 6c 65 20 69 73 0a 2a 2a 20 75 73 65 64 20 74 6f le is.** used to
15930 20 73 74 6f 72 65 20 74 68 65 20 61 64 64 72 65 store the addre
15940 73 73 20 6f 66 20 61 20 56 44 42 45 20 69 6e 73 ss of a VDBE ins
15950 74 72 75 63 74 69 6f 6e 2c 20 6e 6f 74 20 61 20 truction, not a
15960 64 61 74 61 62 61 73 65 20 70 61 67 65 0a 2a 2a database page.**
15970 20 6e 75 6d 62 65 72 20 28 69 74 20 63 61 6e 6e number (it cann
15980 6f 74 20 2d 20 74 68 65 20 64 61 74 61 62 61 73 ot - the databas
15990 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c e page is not al
159a0 6c 6f 63 61 74 65 64 20 75 6e 74 69 6c 20 74 68 located until th
159b0 65 20 56 44 42 45 0a 2a 2a 20 70 72 6f 67 72 61 e VDBE.** progra
159c0 6d 20 69 73 20 65 78 65 63 75 74 65 64 29 2e 20 m is executed).
159d0 53 65 65 20 63 6f 6e 76 65 72 74 54 6f 57 69 74 See convertToWit
159e0 68 6f 75 74 52 6f 77 69 64 54 61 62 6c 65 28 29 houtRowidTable()
159f0 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f for details..*/
15a00 0a 73 74 72 75 63 74 20 49 6e 64 65 78 20 7b 0a .struct Index {.
15a10 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
15a20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 /* Na
15a30 6d 65 20 6f 66 20 74 68 69 73 20 69 6e 64 65 78 me of this index
15a40 20 2a 2f 0a 20 20 69 31 36 20 2a 61 69 43 6f 6c */. i16 *aiCol
15a50 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 2f umn; /
15a60 2a 20 57 68 69 63 68 20 63 6f 6c 75 6d 6e 73 20 * Which columns
15a70 61 72 65 20 75 73 65 64 20 62 79 20 74 68 69 73 are used by this
15a80 20 69 6e 64 65 78 2e 20 20 31 73 74 20 69 73 20 index. 1st is
15a90 30 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 2a 61 0 */. LogEst *a
15aa0 69 52 6f 77 4c 6f 67 45 73 74 3b 20 20 20 20 20 iRowLogEst;
15ab0 2f 2a 20 46 72 6f 6d 20 41 4e 41 4c 59 5a 45 3a /* From ANALYZE:
15ac0 20 45 73 74 2e 20 72 6f 77 73 20 73 65 6c 65 63 Est. rows selec
15ad0 74 65 64 20 62 79 20 65 61 63 68 20 63 6f 6c 75 ted by each colu
15ae0 6d 6e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 mn */. Table *p
15af0 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 Table;
15b00 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 61 62 6c /* The SQL tabl
15b10 65 20 62 65 69 6e 67 20 69 6e 64 65 78 65 64 20 e being indexed
15b20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6c 41 */. char *zColA
15b30 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ff; /*
15b40 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 6e 67 String defining
15b50 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 the affinity of
15b60 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a each column */.
15b70 20 20 49 6e 64 65 78 20 2a 70 4e 65 78 74 3b 20 Index *pNext;
15b80 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
15b90 65 20 6e 65 78 74 20 69 6e 64 65 78 20 61 73 73 e next index ass
15ba0 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
15bb0 20 73 61 6d 65 20 74 61 62 6c 65 20 2a 2f 0a 20 same table */.
15bc0 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 Schema *pSchema
15bd0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 63 68 ; /* Sch
15be0 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ema containing t
15bf0 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 his index */. u
15c00 38 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b 20 20 8 *aSortOrder;
15c10 20 20 20 20 20 20 20 20 2f 2a 20 66 6f 72 20 65 /* for e
15c20 61 63 68 20 63 6f 6c 75 6d 6e 3a 20 54 72 75 65 ach column: True
15c30 3d 3d 44 45 53 43 2c 20 46 61 6c 73 65 3d 3d 41 ==DESC, False==A
15c40 53 43 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 SC */. const ch
15c50 61 72 20 2a 2a 61 7a 43 6f 6c 6c 3b 20 20 20 20 ar **azColl;
15c60 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 6f 6c /* Array of col
15c70 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
15c80 6e 61 6d 65 73 20 66 6f 72 20 69 6e 64 65 78 20 names for index
15c90 2a 2f 0a 20 20 45 78 70 72 20 2a 70 50 61 72 74 */. Expr *pPart
15ca0 49 64 78 57 68 65 72 65 3b 20 20 20 20 20 2f 2a IdxWhere; /*
15cb0 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 66 6f WHERE clause fo
15cc0 72 20 70 61 72 74 69 61 6c 20 69 6e 64 69 63 65 r partial indice
15cd0 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
15ce0 2a 61 43 6f 6c 45 78 70 72 3b 20 20 20 20 20 20 *aColExpr;
15cf0 2f 2a 20 43 6f 6c 75 6d 6e 20 65 78 70 72 65 73 /* Column expres
15d00 73 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 74 sions */. int t
15d10 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 num;
15d20 20 20 20 20 2f 2a 20 44 42 20 50 61 67 65 20 63 /* DB Page c
15d30 6f 6e 74 61 69 6e 69 6e 67 20 72 6f 6f 74 20 6f ontaining root o
15d40 66 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a f this index */.
15d50 20 20 4c 6f 67 45 73 74 20 73 7a 49 64 78 52 6f LogEst szIdxRo
15d60 77 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 45 73 w; /* Es
15d70 74 69 6d 61 74 65 64 20 61 76 65 72 61 67 65 20 timated average
15d80 72 6f 77 20 73 69 7a 65 20 69 6e 20 62 79 74 65 row size in byte
15d90 73 20 2a 2f 0a 20 20 75 31 36 20 6e 4b 65 79 43 s */. u16 nKeyC
15da0 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ol;
15db0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c /* Number of col
15dc0 75 6d 6e 73 20 66 6f 72 6d 69 6e 67 20 74 68 65 umns forming the
15dd0 20 6b 65 79 20 2a 2f 0a 20 20 75 31 36 20 6e 43 key */. u16 nC
15de0 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
15df0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
15e00 63 6f 6c 75 6d 6e 73 20 73 74 6f 72 65 64 20 69 columns stored i
15e10 6e 20 74 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 n the index */.
15e20 20 75 38 20 6f 6e 45 72 72 6f 72 3b 20 20 20 20 u8 onError;
15e30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f /* OE_
15e40 41 62 6f 72 74 2c 20 4f 45 5f 49 67 6e 6f 72 65 Abort, OE_Ignore
15e50 2c 20 4f 45 5f 52 65 70 6c 61 63 65 2c 20 6f 72 , OE_Replace, or
15e60 20 4f 45 5f 4e 6f 6e 65 20 2a 2f 0a 20 20 75 6e OE_None */. un
15e70 73 69 67 6e 65 64 20 69 64 78 54 79 70 65 3a 32 signed idxType:2
15e80 3b 20 20 20 20 20 20 2f 2a 20 31 3d 3d 55 4e 49 ; /* 1==UNI
15e90 51 55 45 2c 20 32 3d 3d 50 52 49 4d 41 52 59 20 QUE, 2==PRIMARY
15ea0 4b 45 59 2c 20 30 3d 3d 43 52 45 41 54 45 20 49 KEY, 0==CREATE I
15eb0 4e 44 45 58 20 2a 2f 0a 20 20 75 6e 73 69 67 6e NDEX */. unsign
15ec0 65 64 20 62 55 6e 6f 72 64 65 72 65 64 3a 31 3b ed bUnordered:1;
15ed0 20 20 20 2f 2a 20 55 73 65 20 74 68 69 73 20 69 /* Use this i
15ee0 6e 64 65 78 20 66 6f 72 20 3d 3d 20 6f 72 20 49 ndex for == or I
15ef0 4e 20 71 75 65 72 69 65 73 20 6f 6e 6c 79 20 2a N queries only *
15f00 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 75 6e 69 /. unsigned uni
15f10 71 4e 6f 74 4e 75 6c 6c 3a 31 3b 20 20 2f 2a 20 qNotNull:1; /*
15f20 54 72 75 65 20 69 66 20 55 4e 49 51 55 45 20 61 True if UNIQUE a
15f30 6e 64 20 4e 4f 54 20 4e 55 4c 4c 20 66 6f 72 20 nd NOT NULL for
15f40 61 6c 6c 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 all columns */.
15f50 20 75 6e 73 69 67 6e 65 64 20 69 73 52 65 73 69 unsigned isResi
15f60 7a 65 64 3a 31 3b 20 20 20 20 2f 2a 20 54 72 75 zed:1; /* Tru
15f70 65 20 69 66 20 72 65 73 69 7a 65 49 6e 64 65 78 e if resizeIndex
15f80 4f 62 6a 65 63 74 28 29 20 68 61 73 20 62 65 65 Object() has bee
15f90 6e 20 63 61 6c 6c 65 64 20 2a 2f 0a 20 20 75 6e n called */. un
15fa0 73 69 67 6e 65 64 20 69 73 43 6f 76 65 72 69 6e signed isCoverin
15fb0 67 3a 31 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 g:1; /* True i
15fc0 66 20 74 68 69 73 20 69 73 20 61 20 63 6f 76 65 f this is a cove
15fd0 72 69 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 ring index */.
15fe0 75 6e 73 69 67 6e 65 64 20 6e 6f 53 6b 69 70 53 unsigned noSkipS
15ff0 63 61 6e 3a 31 3b 20 20 20 2f 2a 20 44 6f 20 6e can:1; /* Do n
16000 6f 74 20 74 72 79 20 74 6f 20 75 73 65 20 73 6b ot try to use sk
16010 69 70 2d 73 63 61 6e 20 69 66 20 74 72 75 65 20 ip-scan if true
16020 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 68 61 */. unsigned ha
16030 73 53 74 61 74 31 3a 31 3b 20 20 20 20 20 2f 2a sStat1:1; /*
16040 20 61 69 52 6f 77 4c 6f 67 45 73 74 20 76 61 6c aiRowLogEst val
16050 75 65 73 20 63 6f 6d 65 20 66 72 6f 6d 20 73 71 ues come from sq
16060 6c 69 74 65 5f 73 74 61 74 31 20 2a 2f 0a 20 20 lite_stat1 */.
16070 75 6e 73 69 67 6e 65 64 20 62 4e 6f 51 75 65 72 unsigned bNoQuer
16080 79 3a 31 3b 20 20 20 20 20 2f 2a 20 44 6f 20 6e y:1; /* Do n
16090 6f 74 20 75 73 65 20 74 68 69 73 20 69 6e 64 65 ot use this inde
160a0 78 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 71 75 x to optimize qu
160b0 65 72 69 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 eries */.#ifdef
160c0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
160d0 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 AT3_OR_STAT4. i
160e0 6e 74 20 6e 53 61 6d 70 6c 65 3b 20 20 20 20 20 nt nSample;
160f0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
16100 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e r of elements in
16110 20 61 53 61 6d 70 6c 65 5b 5d 20 2a 2f 0a 20 20 aSample[] */.
16120 69 6e 74 20 6e 53 61 6d 70 6c 65 43 6f 6c 3b 20 int nSampleCol;
16130 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
16140 20 6f 66 20 49 6e 64 65 78 53 61 6d 70 6c 65 2e of IndexSample.
16150 61 6e 45 71 5b 5d 20 61 6e 64 20 73 6f 20 6f 6e anEq[] and so on
16160 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 */. tRowcnt *a
16170 41 76 67 45 71 3b 20 20 20 20 20 20 20 20 20 2f AvgEq; /
16180 2a 20 41 76 65 72 61 67 65 20 6e 45 71 20 76 61 * Average nEq va
16190 6c 75 65 73 20 66 6f 72 20 6b 65 79 73 20 6e 6f lues for keys no
161a0 74 20 69 6e 20 61 53 61 6d 70 6c 65 20 2a 2f 0a t in aSample */.
161b0 20 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 2a 61 IndexSample *a
161c0 53 61 6d 70 6c 65 3b 20 20 20 20 2f 2a 20 53 61 Sample; /* Sa
161d0 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 6c 65 66 mples of the lef
161e0 74 2d 6d 6f 73 74 20 6b 65 79 20 2a 2f 0a 20 20 t-most key */.
161f0 74 52 6f 77 63 6e 74 20 2a 61 69 52 6f 77 45 73 tRowcnt *aiRowEs
16200 74 3b 20 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d t; /* Non-
16210 6c 6f 67 61 72 69 74 68 6d 69 63 20 73 74 61 74 logarithmic stat
16220 31 20 64 61 74 61 20 66 6f 72 20 74 68 69 73 20 1 data for this
16230 69 6e 64 65 78 20 2a 2f 0a 20 20 74 52 6f 77 63 index */. tRowc
16240 6e 74 20 6e 52 6f 77 45 73 74 30 3b 20 20 20 20 nt nRowEst0;
16250 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6c 6f 67 61 72 /* Non-logar
16260 69 74 68 6d 69 63 20 6e 75 6d 62 65 72 20 6f 66 ithmic number of
16270 20 72 6f 77 73 20 69 6e 20 74 68 65 20 69 6e 64 rows in the ind
16280 65 78 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a ex */.#endif.};.
16290 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 ./*.** Allowed v
162a0 61 6c 75 65 73 20 66 6f 72 20 49 6e 64 65 78 2e alues for Index.
162b0 69 64 78 54 79 70 65 0a 2a 2f 0a 23 64 65 66 69 idxType.*/.#defi
162c0 6e 65 20 53 51 4c 49 54 45 5f 49 44 58 54 59 50 ne SQLITE_IDXTYP
162d0 45 5f 41 50 50 44 45 46 20 20 20 20 20 20 30 20 E_APPDEF 0
162e0 20 20 2f 2a 20 43 72 65 61 74 65 64 20 75 73 69 /* Created usi
162f0 6e 67 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 ng CREATE INDEX
16300 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
16310 45 5f 49 44 58 54 59 50 45 5f 55 4e 49 51 55 45 E_IDXTYPE_UNIQUE
16320 20 20 20 20 20 20 31 20 20 20 2f 2a 20 49 6d 70 1 /* Imp
16330 6c 65 6d 65 6e 74 73 20 61 20 55 4e 49 51 55 45 lements a UNIQUE
16340 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 constraint */.#
16350 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 44 define SQLITE_ID
16360 58 54 59 50 45 5f 50 52 49 4d 41 52 59 4b 45 59 XTYPE_PRIMARYKEY
16370 20 20 32 20 20 20 2f 2a 20 49 73 20 74 68 65 20 2 /* Is the
16380 50 52 49 4d 41 52 59 20 4b 45 59 20 66 6f 72 20 PRIMARY KEY for
16390 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 0a 2f 2a the table */../*
163a0 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 Return true if
163b0 69 6e 64 65 78 20 58 20 69 73 20 61 20 50 52 49 index X is a PRI
163c0 4d 41 52 59 20 4b 45 59 20 69 6e 64 65 78 20 2a MARY KEY index *
163d0 2f 0a 23 64 65 66 69 6e 65 20 49 73 50 72 69 6d /.#define IsPrim
163e0 61 72 79 4b 65 79 49 6e 64 65 78 28 58 29 20 20 aryKeyIndex(X)
163f0 28 28 58 29 2d 3e 69 64 78 54 79 70 65 3d 3d 53 ((X)->idxType==S
16400 51 4c 49 54 45 5f 49 44 58 54 59 50 45 5f 50 52 QLITE_IDXTYPE_PR
16410 49 4d 41 52 59 4b 45 59 29 0a 0a 2f 2a 20 52 65 IMARYKEY)../* Re
16420 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 6e 64 turn true if ind
16430 65 78 20 58 20 69 73 20 61 20 55 4e 49 51 55 45 ex X is a UNIQUE
16440 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e index */.#defin
16450 65 20 49 73 55 6e 69 71 75 65 49 6e 64 65 78 28 e IsUniqueIndex(
16460 58 29 20 20 20 20 20 20 28 28 58 29 2d 3e 6f 6e X) ((X)->on
16470 45 72 72 6f 72 21 3d 4f 45 5f 4e 6f 6e 65 29 0a Error!=OE_None).
16480 0a 2f 2a 20 54 68 65 20 49 6e 64 65 78 2e 61 69 ./* The Index.ai
16490 43 6f 6c 75 6d 6e 5b 5d 20 76 61 6c 75 65 73 20 Column[] values
164a0 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 70 6f 73 are normally pos
164b0 69 74 69 76 65 20 69 6e 74 65 67 65 72 2e 20 20 itive integer.
164c0 42 75 74 0a 2a 2a 20 74 68 65 72 65 20 61 72 65 But.** there are
164d0 20 73 6f 6d 65 20 6e 65 67 61 74 69 76 65 20 76 some negative v
164e0 61 6c 75 65 73 20 74 68 61 74 20 68 61 76 65 20 alues that have
164f0 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e 67 3a special meaning:
16500 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e 5f 52 .*/.#define XN_R
16510 4f 57 49 44 20 20 20 20 20 28 2d 31 29 20 20 20 OWID (-1)
16520 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f 6c /* Indexed col
16530 75 6d 6e 20 69 73 20 74 68 65 20 72 6f 77 69 64 umn is the rowid
16540 20 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e 5f 45 */.#define XN_E
16550 58 50 52 20 20 20 20 20 20 28 2d 32 29 20 20 20 XPR (-2)
16560 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f 6c /* Indexed col
16570 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73 umn is an expres
16580 73 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 sion */../*.** E
16590 61 63 68 20 73 61 6d 70 6c 65 20 73 74 6f 72 65 ach sample store
165a0 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 5f d in the sqlite_
165b0 73 74 61 74 33 20 74 61 62 6c 65 20 69 73 20 72 stat3 table is r
165c0 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 epresented in me
165d0 6d 6f 72 79 0a 2a 2a 20 75 73 69 6e 67 20 61 20 mory.** using a
165e0 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 69 structure of thi
165f0 73 20 74 79 70 65 2e 20 20 53 65 65 20 64 6f 63 s type. See doc
16600 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 20 74 68 umentation at th
16610 65 20 74 6f 70 20 6f 66 20 74 68 65 0a 2a 2a 20 e top of the.**
16620 61 6e 61 6c 79 7a 65 2e 63 20 73 6f 75 72 63 65 analyze.c source
16630 20 66 69 6c 65 20 66 6f 72 20 61 64 64 69 74 69 file for additi
16640 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e onal information
16650 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 ..*/.struct Inde
16660 78 53 61 6d 70 6c 65 20 7b 0a 20 20 76 6f 69 64 xSample {. void
16670 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 2f 2a *p; /*
16680 20 50 6f 69 6e 74 65 72 20 74 6f 20 73 61 6d 70 Pointer to samp
16690 6c 65 64 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 led record */.
166a0 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20 20 int n;
166b0 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65 63 /* Size of rec
166c0 6f 72 64 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a ord in bytes */.
166d0 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 45 71 3b tRowcnt *anEq;
166e0 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 /* Est. numb
166f0 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 er of rows where
16700 20 74 68 65 20 6b 65 79 20 65 71 75 61 6c 73 20 the key equals
16710 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 20 this sample */.
16720 20 74 52 6f 77 63 6e 74 20 2a 61 6e 4c 74 3b 20 tRowcnt *anLt;
16730 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 65 /* Est. numbe
16740 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 20 r of rows where
16750 6b 65 79 20 69 73 20 6c 65 73 73 20 74 68 61 6e key is less than
16760 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a this sample */.
16770 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 44 4c 74 tRowcnt *anDLt
16780 3b 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 ; /* Est. numb
16790 65 72 20 6f 66 20 64 69 73 74 69 6e 63 74 20 6b er of distinct k
167a0 65 79 73 20 6c 65 73 73 20 74 68 61 6e 20 74 68 eys less than th
167b0 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 7d 3b 0a is sample */.};.
167c0 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 6f 6b 65 ./*.** Each toke
167d0 6e 20 63 6f 6d 69 6e 67 20 6f 75 74 20 6f 66 20 n coming out of
167e0 74 68 65 20 6c 65 78 65 72 20 69 73 20 61 6e 20 the lexer is an
167f0 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74 instance of.** t
16800 68 69 73 20 73 74 72 75 63 74 75 72 65 2e 20 20 his structure.
16810 54 6f 6b 65 6e 73 20 61 72 65 20 61 6c 73 6f 20 Tokens are also
16820 75 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 used as part of
16830 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2a an expression..*
16840 2a 0a 2a 2a 20 4e 6f 74 65 20 69 66 20 54 6f 6b *.** Note if Tok
16850 65 6e 2e 7a 3d 3d 30 20 74 68 65 6e 20 54 6f 6b en.z==0 then Tok
16860 65 6e 2e 64 79 6e 20 61 6e 64 20 54 6f 6b 65 6e en.dyn and Token
16870 2e 6e 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 .n are undefined
16880 20 61 6e 64 0a 2a 2a 20 6d 61 79 20 63 6f 6e 74 and.** may cont
16890 61 69 6e 20 72 61 6e 64 6f 6d 20 76 61 6c 75 65 ain random value
168a0 73 2e 20 20 44 6f 20 6e 6f 74 20 6d 61 6b 65 20 s. Do not make
168b0 61 6e 79 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 any assumptions
168c0 61 62 6f 75 74 20 54 6f 6b 65 6e 2e 64 79 6e 0a about Token.dyn.
168d0 2a 2a 20 61 6e 64 20 54 6f 6b 65 6e 2e 6e 20 77 ** and Token.n w
168e0 68 65 6e 20 54 6f 6b 65 6e 2e 7a 3d 3d 30 2e 0a hen Token.z==0..
168f0 2a 2f 0a 73 74 72 75 63 74 20 54 6f 6b 65 6e 20 */.struct Token
16900 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
16910 7a 3b 20 20 20 20 20 2f 2a 20 54 65 78 74 20 6f z; /* Text o
16920 66 20 74 68 65 20 74 6f 6b 65 6e 2e 20 20 4e 6f f the token. No
16930 74 20 4e 55 4c 4c 2d 74 65 72 6d 69 6e 61 74 65 t NULL-terminate
16940 64 21 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 d! */. unsigned
16950 20 69 6e 74 20 6e 3b 20 20 20 20 2f 2a 20 4e 75 int n; /* Nu
16960 6d 62 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 mber of characte
16970 72 73 20 69 6e 20 74 68 69 73 20 74 6f 6b 65 6e rs in this token
16980 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
16990 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 instance of thi
169a0 73 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 s structure cont
169b0 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ains information
169c0 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
169d0 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 ate.** code for
169e0 61 20 53 45 4c 45 43 54 20 74 68 61 74 20 63 6f a SELECT that co
169f0 6e 74 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 ntains aggregate
16a00 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a functions..**.*
16a10 2a 20 49 66 20 45 78 70 72 2e 6f 70 3d 3d 54 4b * If Expr.op==TK
16a20 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 6f 72 20 54 _AGG_COLUMN or T
16a30 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 74 K_AGG_FUNCTION t
16a40 68 65 6e 20 45 78 70 72 2e 70 41 67 67 49 6e 66 hen Expr.pAggInf
16a50 6f 20 69 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 o is a.** pointe
16a60 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
16a70 75 72 65 2e 20 20 54 68 65 20 45 78 70 72 2e 69 ure. The Expr.i
16a80 43 6f 6c 75 6d 6e 20 66 69 65 6c 64 20 69 73 20 Column field is
16a90 74 68 65 20 69 6e 64 65 78 20 69 6e 0a 2a 2a 20 the index in.**
16aa0 41 67 67 49 6e 66 6f 2e 61 43 6f 6c 5b 5d 20 6f AggInfo.aCol[] o
16ab0 72 20 41 67 67 49 6e 66 6f 2e 61 46 75 6e 63 5b r AggInfo.aFunc[
16ac0 5d 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ] of information
16ad0 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
16ae0 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 ate.** code for
16af0 74 68 61 74 20 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a that node..**.**
16b00 20 41 67 67 49 6e 66 6f 2e 70 47 72 6f 75 70 42 AggInfo.pGroupB
16b10 79 20 61 6e 64 20 41 67 67 49 6e 66 6f 2e 61 46 y and AggInfo.aF
16b20 75 6e 63 2e 70 45 78 70 72 20 70 6f 69 6e 74 20 unc.pExpr point
16b30 74 6f 20 66 69 65 6c 64 73 20 77 69 74 68 69 6e to fields within
16b40 20 74 68 65 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c the.** original
16b50 20 53 65 6c 65 63 74 20 73 74 72 75 63 74 75 72 Select structur
16b60 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 e that describes
16b70 20 74 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 the SELECT stat
16b80 65 6d 65 6e 74 2e 20 20 54 68 65 73 65 0a 2a 2a ement. These.**
16b90 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f 74 20 6e fields do not n
16ba0 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 64 20 eed to be freed
16bb0 77 68 65 6e 20 64 65 61 6c 6c 6f 63 61 74 69 6e when deallocatin
16bc0 67 20 74 68 65 20 41 67 67 49 6e 66 6f 20 73 74 g the AggInfo st
16bd0 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 ructure..*/.stru
16be0 63 74 20 41 67 67 49 6e 66 6f 20 7b 0a 20 20 75 ct AggInfo {. u
16bf0 38 20 64 69 72 65 63 74 4d 6f 64 65 3b 20 20 20 8 directMode;
16c00 20 20 20 20 20 20 20 2f 2a 20 44 69 72 65 63 74 /* Direct
16c10 20 72 65 6e 64 65 72 69 6e 67 20 6d 6f 64 65 20 rendering mode
16c20 6d 65 61 6e 73 20 74 61 6b 65 20 64 61 74 61 20 means take data
16c30 64 69 72 65 63 74 6c 79 0a 20 20 20 20 20 20 20 directly.
16c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16c50 20 20 20 2a 2a 20 66 72 6f 6d 20 73 6f 75 72 63 ** from sourc
16c60 65 20 74 61 62 6c 65 73 20 72 61 74 68 65 72 20 e tables rather
16c70 74 68 61 6e 20 66 72 6f 6d 20 61 63 63 75 6d 75 than from accumu
16c80 6c 61 74 6f 72 73 20 2a 2f 0a 20 20 75 38 20 75 lators */. u8 u
16c90 73 65 53 6f 72 74 69 6e 67 49 64 78 3b 20 20 20 seSortingIdx;
16ca0 20 20 20 20 2f 2a 20 49 6e 20 64 69 72 65 63 74 /* In direct
16cb0 20 6d 6f 64 65 2c 20 72 65 66 65 72 65 6e 63 65 mode, reference
16cc0 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
16cd0 65 78 20 72 61 74 68 65 72 0a 20 20 20 20 20 20 ex rather.
16ce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16cf0 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 68 65 20 ** than the
16d00 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a source table */.
16d10 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 49 64 78 int sortingIdx
16d20 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 ; /* Cur
16d30 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 sor number of th
16d40 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 20 e sorting index
16d50 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 */. int sorting
16d60 49 64 78 50 54 61 62 3b 20 20 20 20 20 2f 2a 20 IdxPTab; /*
16d70 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 Cursor number of
16d80 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 20 2a 2f pseudo-table */
16d90 0a 20 20 69 6e 74 20 6e 53 6f 72 74 69 6e 67 43 . int nSortingC
16da0 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 olumn; /* Nu
16db0 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
16dc0 69 6e 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 in the sorting i
16dd0 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 6d 6e ndex */. int mn
16de0 52 65 67 2c 20 6d 78 52 65 67 3b 20 20 20 20 20 Reg, mxReg;
16df0 20 20 2f 2a 20 52 61 6e 67 65 20 6f 66 20 72 65 /* Range of re
16e00 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 65 gisters allocate
16e10 64 20 66 6f 72 20 61 43 6f 6c 20 61 6e 64 20 61 d for aCol and a
16e20 46 75 6e 63 20 2a 2f 0a 20 20 45 78 70 72 4c 69 Func */. ExprLi
16e30 73 74 20 2a 70 47 72 6f 75 70 42 79 3b 20 20 20 st *pGroupBy;
16e40 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 62 /* The group b
16e50 79 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 73 74 y clause */. st
16e60 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 63 6f 6c ruct AggInfo_col
16e70 20 7b 20 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 { /* For eac
16e80 68 20 63 6f 6c 75 6d 6e 20 75 73 65 64 20 69 6e h column used in
16e90 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 2a source tables *
16ea0 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 /. Table *pTa
16eb0 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f b; /
16ec0 2a 20 53 6f 75 72 63 65 20 74 61 62 6c 65 20 2a * Source table *
16ed0 2f 0a 20 20 20 20 69 6e 74 20 69 54 61 62 6c 65 /. int iTable
16ee0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
16ef0 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 * Cursor number
16f00 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 of the source ta
16f10 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 ble */. int i
16f20 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 Column;
16f30 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 /* Column nu
16f40 6d 62 65 72 20 77 69 74 68 69 6e 20 74 68 65 20 mber within the
16f50 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a source table */.
16f60 20 20 20 20 69 6e 74 20 69 53 6f 72 74 65 72 43 int iSorterC
16f70 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 2f 2a 20 olumn; /*
16f80 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e Column number in
16f90 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
16fa0 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d ex */. int iM
16fb0 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 em;
16fc0 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 /* Memory loc
16fd0 61 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 ation that acts
16fe0 61 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a as accumulator *
16ff0 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 /. Expr *pExp
17000 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f r; /
17010 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 65 * The original e
17020 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 7d xpression */. }
17030 20 2a 61 43 6f 6c 3b 0a 20 20 69 6e 74 20 6e 43 *aCol;. int nC
17040 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
17050 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
17060 73 65 64 20 65 6e 74 72 69 65 73 20 69 6e 20 61 sed entries in a
17070 43 6f 6c 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e Col[] */. int n
17080 41 63 63 75 6d 75 6c 61 74 6f 72 3b 20 20 20 20 Accumulator;
17090 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
170a0 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 73 68 6f columns that sho
170b0 77 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 w through to the
170c0 20 6f 75 74 70 75 74 2e 0a 20 20 20 20 20 20 20 output..
170d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
170e0 20 20 20 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c ** Additional
170f0 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 75 73 65 columns are use
17100 64 20 6f 6e 6c 79 20 61 73 20 70 61 72 61 6d 65 d only as parame
17110 74 65 72 73 20 74 6f 0a 20 20 20 20 20 20 20 20 ters to.
17120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17130 20 20 2a 2a 20 61 67 67 72 65 67 61 74 65 20 66 ** aggregate f
17140 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 74 unctions */. st
17150 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 66 75 6e ruct AggInfo_fun
17160 63 20 7b 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 c { /* For eac
17170 68 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 h aggregate func
17180 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 45 78 70 72 tion */. Expr
17190 20 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 *pExpr;
171a0 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 /* Expressi
171b0 6f 6e 20 65 6e 63 6f 64 69 6e 67 20 74 68 65 20 on encoding the
171c0 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 function */.
171d0 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 3b 20 FuncDef *pFunc;
171e0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
171f0 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
17200 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f on implementatio
17210 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d 65 n */. int iMe
17220 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 m;
17230 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 /* Memory loca
17240 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 61 tion that acts a
17250 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f s accumulator */
17260 0a 20 20 20 20 69 6e 74 20 69 44 69 73 74 69 6e . int iDistin
17270 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ct; /*
17280 20 45 70 68 65 6d 65 72 61 6c 20 74 61 62 6c 65 Ephemeral table
17290 20 75 73 65 64 20 74 6f 20 65 6e 66 6f 72 63 65 used to enforce
172a0 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 20 20 7d DISTINCT */. }
172b0 20 2a 61 46 75 6e 63 3b 0a 20 20 69 6e 74 20 6e *aFunc;. int n
172c0 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 Func;
172d0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
172e0 65 6e 74 72 69 65 73 20 69 6e 20 61 46 75 6e 63 entries in aFunc
172f0 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 [] */.};../*.**
17300 54 68 65 20 64 61 74 61 74 79 70 65 20 79 6e 56 The datatype ynV
17310 61 72 20 69 73 20 61 20 73 69 67 6e 65 64 20 69 ar is a signed i
17320 6e 74 65 67 65 72 2c 20 65 69 74 68 65 72 20 31 nteger, either 1
17330 36 2d 62 69 74 20 6f 72 20 33 32 2d 62 69 74 2e 6-bit or 32-bit.
17340 0a 2a 2a 20 55 73 75 61 6c 6c 79 20 69 74 20 69 .** Usually it i
17350 73 20 31 36 2d 62 69 74 73 2e 20 20 42 75 74 20 s 16-bits. But
17360 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 if SQLITE_MAX_VA
17370 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 20 69 73 RIABLE_NUMBER is
17380 20 67 72 65 61 74 65 72 0a 2a 2a 20 74 68 61 6e greater.** than
17390 20 33 32 37 36 37 20 77 65 20 68 61 76 65 20 74 32767 we have t
173a0 6f 20 6d 61 6b 65 20 69 74 20 33 32 2d 62 69 74 o make it 32-bit
173b0 2e 20 20 31 36 2d 62 69 74 20 69 73 20 70 72 65 . 16-bit is pre
173c0 66 65 72 72 65 64 20 62 65 63 61 75 73 65 0a 2a ferred because.*
173d0 2a 20 69 74 20 75 73 65 73 20 6c 65 73 73 20 6d * it uses less m
173e0 65 6d 6f 72 79 20 69 6e 20 74 68 65 20 45 78 70 emory in the Exp
173f0 72 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 r object, which
17400 69 73 20 61 20 62 69 67 20 6d 65 6d 6f 72 79 20 is a big memory
17410 75 73 65 72 0a 2a 2a 20 69 6e 20 73 79 73 74 65 user.** in syste
17420 6d 73 20 77 69 74 68 20 6c 6f 74 73 20 6f 66 20 ms with lots of
17430 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 prepared stateme
17440 6e 74 73 2e 20 20 41 6e 64 20 66 65 77 20 61 70 nts. And few ap
17450 70 6c 69 63 61 74 69 6f 6e 73 0a 2a 2a 20 6e 65 plications.** ne
17460 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 61 62 6f ed more than abo
17470 75 74 20 31 30 20 6f 72 20 32 30 20 76 61 72 69 ut 10 or 20 vari
17480 61 62 6c 65 73 2e 20 20 42 75 74 20 73 6f 6d 65 ables. But some
17490 20 65 78 74 72 65 6d 65 20 75 73 65 72 73 20 77 extreme users w
174a0 61 6e 74 0a 2a 2a 20 74 6f 20 68 61 76 65 20 70 ant.** to have p
174b0 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e repared statemen
174c0 74 73 20 77 69 74 68 20 6f 76 65 72 20 33 32 37 ts with over 327
174d0 36 37 20 76 61 72 69 61 62 6c 65 73 2c 20 61 6e 67 variables, an
174e0 64 20 66 6f 72 20 74 68 65 6d 0a 2a 2a 20 74 68 d for them.** th
174f0 65 20 6f 70 74 69 6f 6e 20 69 73 20 61 76 61 69 e option is avai
17500 6c 61 62 6c 65 20 28 61 74 20 63 6f 6d 70 69 6c lable (at compil
17510 65 2d 74 69 6d 65 29 2e 0a 2a 2f 0a 23 69 66 20 e-time)..*/.#if
17520 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 SQLITE_MAX_VARIA
17530 42 4c 45 5f 4e 55 4d 42 45 52 3c 3d 33 32 37 36 BLE_NUMBER<=3276
17540 37 0a 74 79 70 65 64 65 66 20 69 31 36 20 79 6e 7.typedef i16 yn
17550 56 61 72 3b 0a 23 65 6c 73 65 0a 74 79 70 65 64 Var;.#else.typed
17560 65 66 20 69 6e 74 20 79 6e 56 61 72 3b 0a 23 65 ef int ynVar;.#e
17570 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 ndif../*.** Each
17580 20 6e 6f 64 65 20 6f 66 20 61 6e 20 65 78 70 72 node of an expr
17590 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 70 61 ession in the pa
175a0 72 73 65 20 74 72 65 65 20 69 73 20 61 6e 20 69 rse tree is an i
175b0 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 nstance.** of th
175c0 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a is structure..**
175d0 0a 2a 2a 20 45 78 70 72 2e 6f 70 20 69 73 20 74 .** Expr.op is t
175e0 68 65 20 6f 70 63 6f 64 65 2e 20 54 68 65 20 69 he opcode. The i
175f0 6e 74 65 67 65 72 20 70 61 72 73 65 72 20 74 6f nteger parser to
17600 6b 65 6e 20 63 6f 64 65 73 20 61 72 65 20 72 65 ken codes are re
17610 75 73 65 64 0a 2a 2a 20 61 73 20 6f 70 63 6f 64 used.** as opcod
17620 65 73 20 68 65 72 65 2e 20 46 6f 72 20 65 78 61 es here. For exa
17630 6d 70 6c 65 2c 20 74 68 65 20 70 61 72 73 65 72 mple, the parser
17640 20 64 65 66 69 6e 65 73 20 54 4b 5f 47 45 20 74 defines TK_GE t
17650 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 0a o be an integer.
17660 2a 2a 20 63 6f 64 65 20 72 65 70 72 65 73 65 6e ** code represen
17670 74 69 6e 67 20 74 68 65 20 22 3e 3d 22 20 6f 70 ting the ">=" op
17680 65 72 61 74 6f 72 2e 20 54 68 69 73 20 73 61 6d erator. This sam
17690 65 20 69 6e 74 65 67 65 72 20 63 6f 64 65 20 69 e integer code i
176a0 73 20 72 65 75 73 65 64 0a 2a 2a 20 74 6f 20 72 s reused.** to r
176b0 65 70 72 65 73 65 6e 74 20 74 68 65 20 67 72 65 epresent the gre
176c0 61 74 65 72 2d 74 68 61 6e 2d 6f 72 2d 65 71 75 ater-than-or-equ
176d0 61 6c 2d 74 6f 20 6f 70 65 72 61 74 6f 72 20 69 al-to operator i
176e0 6e 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e n the expression
176f0 0a 2a 2a 20 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 .** tree..**.**
17700 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f If the expressio
17710 6e 20 69 73 20 61 6e 20 53 51 4c 20 6c 69 74 65 n is an SQL lite
17720 72 61 6c 20 28 54 4b 5f 49 4e 54 45 47 45 52 2c ral (TK_INTEGER,
17730 20 54 4b 5f 46 4c 4f 41 54 2c 20 54 4b 5f 42 4c TK_FLOAT, TK_BL
17740 4f 42 2c 0a 2a 2a 20 6f 72 20 54 4b 5f 53 54 52 OB,.** or TK_STR
17750 49 4e 47 29 2c 20 74 68 65 6e 20 45 78 70 72 2e ING), then Expr.
17760 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 20 74 token contains t
17770 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 53 he text of the S
17780 51 4c 20 6c 69 74 65 72 61 6c 2e 20 49 66 0a 2a QL literal. If.*
17790 2a 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e * the expression
177a0 20 69 73 20 61 20 76 61 72 69 61 62 6c 65 20 28 is a variable (
177b0 54 4b 5f 56 41 52 49 41 42 4c 45 29 2c 20 74 68 TK_VARIABLE), th
177c0 65 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f en Expr.token co
177d0 6e 74 61 69 6e 73 20 74 68 65 0a 2a 2a 20 76 61 ntains the.** va
177e0 72 69 61 62 6c 65 20 6e 61 6d 65 2e 20 46 69 6e riable name. Fin
177f0 61 6c 6c 79 2c 20 69 66 20 74 68 65 20 65 78 70 ally, if the exp
17800 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 ression is an SQ
17810 4c 20 66 75 6e 63 74 69 6f 6e 20 28 54 4b 5f 46 L function (TK_F
17820 55 4e 43 54 49 4f 4e 29 2c 0a 2a 2a 20 74 68 65 UNCTION),.** the
17830 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e n Expr.token con
17840 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 20 6f tains the name o
17850 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 0a f the function..
17860 2a 2a 0a 2a 2a 20 45 78 70 72 2e 70 52 69 67 68 **.** Expr.pRigh
17870 74 20 61 6e 64 20 45 78 70 72 2e 70 4c 65 66 74 t and Expr.pLeft
17880 20 61 72 65 20 74 68 65 20 6c 65 66 74 20 61 6e are the left an
17890 64 20 72 69 67 68 74 20 73 75 62 65 78 70 72 65 d right subexpre
178a0 73 73 69 6f 6e 73 20 6f 66 20 61 0a 2a 2a 20 62 ssions of a.** b
178b0 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 2e 20 inary operator.
178c0 45 69 74 68 65 72 20 6f 72 20 62 6f 74 68 20 6d Either or both m
178d0 61 79 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a ay be NULL..**.*
178e0 2a 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 69 * Expr.x.pList i
178f0 73 20 61 20 6c 69 73 74 20 6f 66 20 61 72 67 75 s a list of argu
17900 6d 65 6e 74 73 20 69 66 20 74 68 65 20 65 78 70 ments if the exp
17910 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 ression is an SQ
17920 4c 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 61 L function,.** a
17930 20 43 41 53 45 20 65 78 70 72 65 73 73 69 6f 6e CASE expression
17940 20 6f 72 20 61 6e 20 49 4e 20 65 78 70 72 65 73 or an IN expres
17950 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d sion of the form
17960 20 22 3c 6c 68 73 3e 20 49 4e 20 28 3c 79 3e 2c "<lhs> IN (<y>,
17970 20 3c 7a 3e 2e 2e 2e 29 22 2e 0a 2a 2a 20 45 78 <z>...)"..** Ex
17980 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 73 20 pr.x.pSelect is
17990 75 73 65 64 20 69 66 20 74 68 65 20 65 78 70 72 used if the expr
179a0 65 73 73 69 6f 6e 20 69 73 20 61 20 73 75 62 2d ession is a sub-
179b0 73 65 6c 65 63 74 20 6f 72 20 61 6e 20 65 78 70 select or an exp
179c0 72 65 73 73 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 ression of.** th
179d0 65 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 49 4e e form "<lhs> IN
179e0 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 2e 20 (SELECT ...)".
179f0 49 66 20 74 68 65 20 45 50 5f 78 49 73 53 65 6c If the EP_xIsSel
17a00 65 63 74 20 62 69 74 20 69 73 20 73 65 74 20 69 ect bit is set i
17a10 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e 66 6c n the.** Expr.fl
17a20 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 45 ags mask, then E
17a30 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 73 xpr.x.pSelect is
17a40 20 76 61 6c 69 64 2e 20 4f 74 68 65 72 77 69 73 valid. Otherwis
17a50 65 2c 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 e, Expr.x.pList
17a60 69 73 0a 2a 2a 20 76 61 6c 69 64 2e 0a 2a 2a 0a is.** valid..**.
17a70 2a 2a 20 41 6e 20 65 78 70 72 65 73 73 69 6f 6e ** An expression
17a80 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 49 44 20 of the form ID
17a90 6f 72 20 49 44 2e 49 44 20 72 65 66 65 72 73 20 or ID.ID refers
17aa0 74 6f 20 61 20 63 6f 6c 75 6d 6e 20 69 6e 20 61 to a column in a
17ab0 20 74 61 62 6c 65 2e 0a 2a 2a 20 46 6f 72 20 73 table..** For s
17ac0 75 63 68 20 65 78 70 72 65 73 73 69 6f 6e 73 2c uch expressions,
17ad0 20 45 78 70 72 2e 6f 70 20 69 73 20 73 65 74 20 Expr.op is set
17ae0 74 6f 20 54 4b 5f 43 4f 4c 55 4d 4e 20 61 6e 64 to TK_COLUMN and
17af0 20 45 78 70 72 2e 69 54 61 62 6c 65 20 69 73 0a Expr.iTable is.
17b00 2a 2a 20 74 68 65 20 69 6e 74 65 67 65 72 20 63 ** the integer c
17b10 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 ursor number of
17b20 61 20 56 44 42 45 20 63 75 72 73 6f 72 20 70 6f a VDBE cursor po
17b30 69 6e 74 69 6e 67 20 74 6f 20 74 68 61 74 20 74 inting to that t
17b40 61 62 6c 65 20 61 6e 64 0a 2a 2a 20 45 78 70 72 able and.** Expr
17b50 2e 69 43 6f 6c 75 6d 6e 20 69 73 20 74 68 65 20 .iColumn is the
17b60 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 66 6f column number fo
17b70 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 63 r the specific c
17b80 6f 6c 75 6d 6e 2e 20 20 49 66 20 74 68 65 0a 2a olumn. If the.*
17b90 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 * expression is
17ba0 75 73 65 64 20 61 73 20 61 20 72 65 73 75 6c 74 used as a result
17bb0 20 69 6e 20 61 6e 20 61 67 67 72 65 67 61 74 65 in an aggregate
17bc0 20 53 45 4c 45 43 54 2c 20 74 68 65 6e 20 74 68 SELECT, then th
17bd0 65 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 61 6c e.** value is al
17be0 73 6f 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 so stored in the
17bf0 20 45 78 70 72 2e 69 41 67 67 20 63 6f 6c 75 6d Expr.iAgg colum
17c00 6e 20 69 6e 20 74 68 65 20 61 67 67 72 65 67 61 n in the aggrega
17c10 74 65 20 73 6f 20 74 68 61 74 0a 2a 2a 20 69 74 te so that.** it
17c20 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 65 64 can be accessed
17c30 20 61 66 74 65 72 20 61 6c 6c 20 61 67 67 72 65 after all aggre
17c40 67 61 74 65 73 20 61 72 65 20 63 6f 6d 70 75 74 gates are comput
17c50 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
17c60 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 expression is a
17c70 6e 20 75 6e 62 6f 75 6e 64 20 76 61 72 69 61 62 n unbound variab
17c80 6c 65 20 6d 61 72 6b 65 72 20 28 61 20 71 75 65 le marker (a que
17c90 73 74 69 6f 6e 20 6d 61 72 6b 0a 2a 2a 20 63 68 stion mark.** ch
17ca0 61 72 61 63 74 65 72 20 27 3f 27 20 69 6e 20 74 aracter '?' in t
17cb0 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 29 he original SQL)
17cc0 20 74 68 65 6e 20 74 68 65 20 45 78 70 72 2e 69 then the Expr.i
17cd0 54 61 62 6c 65 20 68 6f 6c 64 73 20 74 68 65 20 Table holds the
17ce0 69 6e 64 65 78 0a 2a 2a 20 6e 75 6d 62 65 72 20 index.** number
17cf0 66 6f 72 20 74 68 61 74 20 76 61 72 69 61 62 6c for that variabl
17d00 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
17d10 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 20 expression is a
17d20 73 75 62 71 75 65 72 79 20 74 68 65 6e 20 45 78 subquery then Ex
17d30 70 72 2e 69 43 6f 6c 75 6d 6e 20 68 6f 6c 64 73 pr.iColumn holds
17d40 20 61 6e 20 69 6e 74 65 67 65 72 0a 2a 2a 20 72 an integer.** r
17d50 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 20 63 egister number c
17d60 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 72 65 ontaining the re
17d70 73 75 6c 74 20 6f 66 20 74 68 65 20 73 75 62 71 sult of the subq
17d80 75 65 72 79 2e 20 20 49 66 20 74 68 65 0a 2a 2a uery. If the.**
17d90 20 73 75 62 71 75 65 72 79 20 67 69 76 65 73 20 subquery gives
17da0 61 20 63 6f 6e 73 74 61 6e 74 20 72 65 73 75 6c a constant resul
17db0 74 2c 20 74 68 65 6e 20 69 54 61 62 6c 65 20 69 t, then iTable i
17dc0 73 20 2d 31 2e 20 20 49 66 20 74 68 65 20 73 75 s -1. If the su
17dd0 62 71 75 65 72 79 0a 2a 2a 20 67 69 76 65 73 20 bquery.** gives
17de0 61 20 64 69 66 66 65 72 65 6e 74 20 61 6e 73 77 a different answ
17df0 65 72 20 61 74 20 64 69 66 66 65 72 65 6e 74 20 er at different
17e00 74 69 6d 65 73 20 64 75 72 69 6e 67 20 73 74 61 times during sta
17e10 74 65 6d 65 6e 74 20 70 72 6f 63 65 73 73 69 6e tement processin
17e20 67 0a 2a 2a 20 74 68 65 6e 20 69 54 61 62 6c 65 g.** then iTable
17e30 20 69 73 20 74 68 65 20 61 64 64 72 65 73 73 20 is the address
17e40 6f 66 20 61 20 73 75 62 72 6f 75 74 69 6e 65 20 of a subroutine
17e50 74 68 61 74 20 63 6f 6d 70 75 74 65 73 20 74 68 that computes th
17e60 65 20 73 75 62 71 75 65 72 79 2e 0a 2a 2a 0a 2a e subquery..**.*
17e70 2a 20 49 66 20 74 68 65 20 45 78 70 72 20 69 73 * If the Expr is
17e80 20 6f 66 20 74 79 70 65 20 4f 50 5f 43 6f 6c 75 of type OP_Colu
17e90 6d 6e 2c 20 61 6e 64 20 74 68 65 20 74 61 62 6c mn, and the tabl
17ea0 65 20 69 74 20 69 73 20 73 65 6c 65 63 74 69 6e e it is selectin
17eb0 67 20 66 72 6f 6d 0a 2a 2a 20 69 73 20 61 20 64 g from.** is a d
17ec0 69 73 6b 20 74 61 62 6c 65 20 6f 72 20 74 68 65 isk table or the
17ed0 20 22 6f 6c 64 2e 2a 22 20 70 73 65 75 64 6f 2d "old.*" pseudo-
17ee0 74 61 62 6c 65 2c 20 74 68 65 6e 20 70 54 61 62 table, then pTab
17ef0 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a points to the.*
17f00 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 * corresponding
17f10 74 61 62 6c 65 20 64 65 66 69 6e 69 74 69 6f 6e table definition
17f20 2e 0a 2a 2a 0a 2a 2a 20 41 4c 4c 4f 43 41 54 49 ..**.** ALLOCATI
17f30 4f 4e 20 4e 4f 54 45 53 3a 0a 2a 2a 0a 2a 2a 20 ON NOTES:.**.**
17f40 45 78 70 72 20 6f 62 6a 65 63 74 73 20 63 61 6e Expr objects can
17f50 20 75 73 65 20 61 20 6c 6f 74 20 6f 66 20 6d 65 use a lot of me
17f60 6d 6f 72 79 20 73 70 61 63 65 20 69 6e 20 64 61 mory space in da
17f70 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 20 tabase schema.
17f80 54 6f 0a 2a 2a 20 68 65 6c 70 20 72 65 64 75 63 To.** help reduc
17f90 65 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65 e memory require
17fa0 6d 65 6e 74 73 2c 20 73 6f 6d 65 74 69 6d 65 73 ments, sometimes
17fb0 20 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 74 20 an Expr object
17fc0 77 69 6c 6c 20 62 65 0a 2a 2a 20 74 72 75 6e 63 will be.** trunc
17fd0 61 74 65 64 2e 20 20 41 6e 64 20 74 6f 20 72 65 ated. And to re
17fe0 64 75 63 65 20 74 68 65 20 6e 75 6d 62 65 72 20 duce the number
17ff0 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 of memory alloca
18000 74 69 6f 6e 73 2c 20 73 6f 6d 65 74 69 6d 65 73 tions, sometimes
18010 0a 2a 2a 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 .** two or more
18020 45 78 70 72 20 6f 62 6a 65 63 74 73 20 77 69 6c Expr objects wil
18030 6c 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 61 l be stored in a
18040 20 73 69 6e 67 6c 65 20 6d 65 6d 6f 72 79 20 61 single memory a
18050 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a 20 74 6f llocation,.** to
18060 67 65 74 68 65 72 20 77 69 74 68 20 45 78 70 72 gether with Expr
18070 2e 7a 54 6f 6b 65 6e 20 73 74 72 69 6e 67 73 2e .zToken strings.
18080 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 45 50 .**.** If the EP
18090 5f 52 65 64 75 63 65 64 20 61 6e 64 20 45 50 5f _Reduced and EP_
180a0 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 67 73 20 TokenOnly flags
180b0 61 72 65 20 73 65 74 20 77 68 65 6e 0a 2a 2a 20 are set when.**
180c0 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 74 20 69 an Expr object i
180d0 73 20 74 72 75 6e 63 61 74 65 64 2e 20 20 57 68 s truncated. Wh
180e0 65 6e 20 45 50 5f 52 65 64 75 63 65 64 20 69 73 en EP_Reduced is
180f0 20 73 65 74 2c 20 74 68 65 6e 20 61 6c 6c 0a 2a set, then all.*
18100 2a 20 74 68 65 20 63 68 69 6c 64 20 45 78 70 72 * the child Expr
18110 20 6f 62 6a 65 63 74 73 20 69 6e 20 74 68 65 20 objects in the
18120 45 78 70 72 2e 70 4c 65 66 74 20 61 6e 64 20 45 Expr.pLeft and E
18130 78 70 72 2e 70 52 69 67 68 74 20 73 75 62 74 72 xpr.pRight subtr
18140 65 65 73 0a 2a 2a 20 61 72 65 20 63 6f 6e 74 61 ees.** are conta
18150 69 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 ined within the
18160 73 61 6d 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f same memory allo
18170 63 61 74 69 6f 6e 2e 20 20 4e 6f 74 65 2c 20 68 cation. Note, h
18180 6f 77 65 76 65 72 2c 20 74 68 61 74 0a 2a 2a 20 owever, that.**
18190 74 68 65 20 73 75 62 74 72 65 65 73 20 69 6e 20 the subtrees in
181a0 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 6f 72 20 Expr.x.pList or
181b0 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 61 Expr.x.pSelect a
181c0 72 65 20 61 6c 77 61 79 73 20 73 65 70 61 72 61 re always separa
181d0 74 65 6c 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 tely.** allocate
181e0 64 2c 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 d, regardless of
181f0 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
18200 45 50 5f 52 65 64 75 63 65 64 20 69 73 20 73 65 EP_Reduced is se
18210 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 70 t..*/.struct Exp
18220 72 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 r {. u8 op;
18230 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
18240 4f 70 65 72 61 74 69 6f 6e 20 70 65 72 66 6f 72 Operation perfor
18250 6d 65 64 20 62 79 20 74 68 69 73 20 6e 6f 64 65 med by this node
18260 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 69 6e */. char affin
18270 69 74 79 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ity; /*
18280 54 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 The affinity of
18290 74 68 65 20 63 6f 6c 75 6d 6e 20 6f 72 20 30 20 the column or 0
182a0 69 66 20 6e 6f 74 20 61 20 63 6f 6c 75 6d 6e 20 if not a column
182b0 2a 2f 0a 20 20 75 33 32 20 66 6c 61 67 73 3b 20 */. u32 flags;
182c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
182d0 61 72 69 6f 75 73 20 66 6c 61 67 73 2e 20 20 45 arious flags. E
182e0 50 5f 2a 20 53 65 65 20 62 65 6c 6f 77 20 2a 2f P_* See below */
182f0 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 63 . union {. c
18300 68 61 72 20 2a 7a 54 6f 6b 65 6e 3b 20 20 20 20 har *zToken;
18310 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 76 /* Token v
18320 61 6c 75 65 2e 20 5a 65 72 6f 20 74 65 72 6d 69 alue. Zero termi
18330 6e 61 74 65 64 20 61 6e 64 20 64 65 71 75 6f 74 nated and dequot
18340 65 64 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 56 ed */. int iV
18350 61 6c 75 65 3b 20 20 20 20 20 20 20 20 20 20 20 alue;
18360 20 2f 2a 20 4e 6f 6e 2d 6e 65 67 61 74 69 76 65 /* Non-negative
18370 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 20 69 integer value i
18380 66 20 45 50 5f 49 6e 74 56 61 6c 75 65 20 2a 2f f EP_IntValue */
18390 0a 20 20 7d 20 75 3b 0a 0a 20 20 2f 2a 20 49 66 . } u;.. /* If
183a0 20 74 68 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c the EP_TokenOnl
183b0 79 20 66 6c 61 67 20 69 73 20 73 65 74 20 69 6e y flag is set in
183c0 20 74 68 65 20 45 78 70 72 2e 66 6c 61 67 73 20 the Expr.flags
183d0 6d 61 73 6b 2c 20 74 68 65 6e 20 6e 6f 0a 20 20 mask, then no.
183e0 2a 2a 20 73 70 61 63 65 20 69 73 20 61 6c 6c 6f ** space is allo
183f0 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 66 69 cated for the fi
18400 65 6c 64 73 20 62 65 6c 6f 77 20 74 68 69 73 20 elds below this
18410 70 6f 69 6e 74 2e 20 41 6e 20 61 74 74 65 6d 70 point. An attemp
18420 74 20 74 6f 0a 20 20 2a 2a 20 61 63 63 65 73 73 t to. ** access
18430 20 74 68 65 6d 20 77 69 6c 6c 20 72 65 73 75 6c them will resul
18440 74 20 69 6e 20 61 20 73 65 67 66 61 75 6c 74 20 t in a segfault
18450 6f 72 20 6d 61 6c 66 75 6e 63 74 69 6f 6e 2e 0a or malfunction..
18460 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************
18470 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18480 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18490 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
184a0 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 45 78 70 72 *******/.. Expr
184b0 20 2a 70 4c 65 66 74 3b 20 20 20 20 20 20 20 20 *pLeft;
184c0 20 20 20 2f 2a 20 4c 65 66 74 20 73 75 62 6e 6f /* Left subno
184d0 64 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 52 de */. Expr *pR
184e0 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 20 2f ight; /
184f0 2a 20 52 69 67 68 74 20 73 75 62 6e 6f 64 65 20 * Right subnode
18500 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 */. union {.
18510 20 45 78 70 72 4c 69 73 74 20 2a 70 4c 69 73 74 ExprList *pList
18520 3b 20 20 20 20 20 2f 2a 20 6f 70 20 3d 20 49 4e ; /* op = IN
18530 2c 20 45 58 49 53 54 53 2c 20 53 45 4c 45 43 54 , EXISTS, SELECT
18540 2c 20 43 41 53 45 2c 20 46 55 4e 43 54 49 4f 4e , CASE, FUNCTION
18550 2c 20 42 45 54 57 45 45 4e 20 2a 2f 0a 20 20 20 , BETWEEN */.
18560 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 Select *pSelect
18570 3b 20 20 20 20 20 2f 2a 20 45 50 5f 78 49 73 53 ; /* EP_xIsS
18580 65 6c 65 63 74 20 61 6e 64 20 6f 70 20 3d 20 49 elect and op = I
18590 4e 2c 20 45 58 49 53 54 53 2c 20 53 45 4c 45 43 N, EXISTS, SELEC
185a0 54 20 2a 2f 0a 20 20 7d 20 78 3b 0a 0a 20 20 2f T */. } x;.. /
185b0 2a 20 49 66 20 74 68 65 20 45 50 5f 52 65 64 75 * If the EP_Redu
185c0 63 65 64 20 66 6c 61 67 20 69 73 20 73 65 74 20 ced flag is set
185d0 69 6e 20 74 68 65 20 45 78 70 72 2e 66 6c 61 67 in the Expr.flag
185e0 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 6e 6f 0a s mask, then no.
185f0 20 20 2a 2a 20 73 70 61 63 65 20 69 73 20 61 6c ** space is al
18600 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 located for the
18610 66 69 65 6c 64 73 20 62 65 6c 6f 77 20 74 68 69 fields below thi
18620 73 20 70 6f 69 6e 74 2e 20 41 6e 20 61 74 74 65 s point. An atte
18630 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 61 63 63 65 mpt to. ** acce
18640 73 73 20 74 68 65 6d 20 77 69 6c 6c 20 72 65 73 ss them will res
18650 75 6c 74 20 69 6e 20 61 20 73 65 67 66 61 75 6c ult in a segfaul
18660 74 20 6f 72 20 6d 61 6c 66 75 6e 63 74 69 6f 6e t or malfunction
18670 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .. ************
18680 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18690 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
186a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
186b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 23 69 66 20 *********/..#if
186c0 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f SQLITE_MAX_EXPR_
186d0 44 45 50 54 48 3e 30 0a 20 20 69 6e 74 20 6e 48 DEPTH>0. int nH
186e0 65 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 20 eight;
186f0 20 2f 2a 20 48 65 69 67 68 74 20 6f 66 20 74 68 /* Height of th
18700 65 20 74 72 65 65 20 68 65 61 64 65 64 20 62 79 e tree headed by
18710 20 74 68 69 73 20 6e 6f 64 65 20 2a 2f 0a 23 65 this node */.#e
18720 6e 64 69 66 0a 20 20 69 6e 74 20 69 54 61 62 6c ndif. int iTabl
18730 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
18740 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 75 72 73 TK_COLUMN: curs
18750 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 61 62 or number of tab
18760 6c 65 20 68 6f 6c 64 69 6e 67 20 63 6f 6c 75 6d le holding colum
18770 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 n.
18780 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b ** TK
18790 5f 52 45 47 49 53 54 45 52 3a 20 72 65 67 69 73 _REGISTER: regis
187a0 74 65 72 20 6e 75 6d 62 65 72 0a 20 20 20 20 20 ter number.
187b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
187c0 20 20 20 20 2a 2a 20 54 4b 5f 54 52 49 47 47 45 ** TK_TRIGGE
187d0 52 3a 20 31 20 2d 3e 20 6e 65 77 2c 20 30 20 2d R: 1 -> new, 0 -
187e0 3e 20 6f 6c 64 0a 20 20 20 20 20 20 20 20 20 20 > old.
187f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
18800 2a 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 3a 20 20 * EP_Unlikely:
18810 31 33 34 32 31 37 37 32 38 20 74 69 6d 65 73 20 134217728 times
18820 6c 69 6b 65 6c 69 68 6f 6f 64 0a 20 20 20 20 20 likelihood.
18830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18840 20 20 20 20 2a 2a 20 54 4b 5f 53 45 4c 45 43 54 ** TK_SELECT
18850 3a 20 31 73 74 20 72 65 67 69 73 74 65 72 20 6f : 1st register o
18860 66 20 72 65 73 75 6c 74 20 76 65 63 74 6f 72 20 f result vector
18870 2a 2f 0a 20 20 79 6e 56 61 72 20 69 43 6f 6c 75 */. ynVar iColu
18880 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 mn; /* T
18890 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c 75 6d 6e K_COLUMN: column
188a0 20 69 6e 64 65 78 2e 20 20 2d 31 20 66 6f 72 20 index. -1 for
188b0 72 6f 77 69 64 2e 0a 20 20 20 20 20 20 20 20 20 rowid..
188c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
188d0 2a 2a 20 54 4b 5f 56 41 52 49 41 42 4c 45 3a 20 ** TK_VARIABLE:
188e0 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 20 variable number
188f0 28 61 6c 77 61 79 73 20 3e 3d 20 31 29 2e 0a 20 (always >= 1)..
18900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18910 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f 53 45 ** TK_SE
18920 4c 45 43 54 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c LECT_COLUMN: col
18930 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 75 6c umn of the resul
18940 74 20 76 65 63 74 6f 72 20 2a 2f 0a 20 20 69 31 t vector */. i1
18950 36 20 69 41 67 67 3b 20 20 20 20 20 20 20 20 20 6 iAgg;
18960 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 65 6e /* Which en
18970 74 72 79 20 69 6e 20 70 41 67 67 49 6e 66 6f 2d try in pAggInfo-
18980 3e 61 43 6f 6c 5b 5d 20 6f 72 20 2d 3e 61 46 75 >aCol[] or ->aFu
18990 6e 63 5b 5d 20 2a 2f 0a 20 20 69 31 36 20 69 52 nc[] */. i16 iR
189a0 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 3b 20 20 ightJoinTable;
189b0 20 2f 2a 20 49 66 20 45 50 5f 46 72 6f 6d 4a 6f /* If EP_FromJo
189c0 69 6e 2c 20 74 68 65 20 72 69 67 68 74 20 74 61 in, the right ta
189d0 62 6c 65 20 6f 66 20 74 68 65 20 6a 6f 69 6e 20 ble of the join
189e0 2a 2f 0a 20 20 75 38 20 6f 70 32 3b 20 20 20 20 */. u8 op2;
189f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
18a00 4b 5f 52 45 47 49 53 54 45 52 3a 20 6f 72 69 67 K_REGISTER: orig
18a10 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 45 78 inal value of Ex
18a20 70 72 2e 6f 70 0a 20 20 20 20 20 20 20 20 20 20 pr.op.
18a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
18a40 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 74 68 65 * TK_COLUMN: the
18a50 20 76 61 6c 75 65 20 6f 66 20 70 35 20 66 6f 72 value of p5 for
18a60 20 4f 50 5f 43 6f 6c 75 6d 6e 0a 20 20 20 20 20 OP_Column.
18a70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18a80 20 20 20 20 2a 2a 20 54 4b 5f 41 47 47 5f 46 55 ** TK_AGG_FU
18a90 4e 43 54 49 4f 4e 3a 20 6e 65 73 74 69 6e 67 20 NCTION: nesting
18aa0 64 65 70 74 68 20 2a 2f 0a 20 20 41 67 67 49 6e depth */. AggIn
18ab0 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 20 20 fo *pAggInfo;
18ac0 20 20 2f 2a 20 55 73 65 64 20 62 79 20 54 4b 5f /* Used by TK_
18ad0 41 47 47 5f 43 4f 4c 55 4d 4e 20 61 6e 64 20 54 AGG_COLUMN and T
18ae0 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 2a K_AGG_FUNCTION *
18af0 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b /. Table *pTab;
18b00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 /* Ta
18b10 62 6c 65 20 66 6f 72 20 54 4b 5f 43 4f 4c 55 4d ble for TK_COLUM
18b20 4e 20 65 78 70 72 65 73 73 69 6f 6e 73 2e 20 20 N expressions.
18b30 43 61 6e 20 62 65 20 4e 55 4c 4c 0a 20 20 20 20 Can be NULL.
18b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18b50 20 20 20 20 20 2a 2a 20 66 6f 72 20 61 20 63 6f ** for a co
18b60 6c 75 6d 6e 20 6f 66 20 61 6e 20 69 6e 64 65 78 lumn of an index
18b70 20 6f 6e 20 61 6e 20 65 78 70 72 65 73 73 69 6f on an expressio
18b80 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 n */.};../*.** T
18b90 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 he following are
18ba0 20 74 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 the meanings of
18bb0 20 62 69 74 73 20 69 6e 20 74 68 65 20 45 78 70 bits in the Exp
18bc0 72 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a r.flags field..*
18bd0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 46 72 6f /.#define EP_Fro
18be0 6d 4a 6f 69 6e 20 20 30 78 30 30 30 30 30 31 20 mJoin 0x000001
18bf0 2f 2a 20 4f 72 69 67 69 6e 61 74 65 73 20 69 6e /* Originates in
18c00 20 4f 4e 2f 55 53 49 4e 47 20 63 6c 61 75 73 65 ON/USING clause
18c10 20 6f 66 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a of outer join *
18c20 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 67 67 /.#define EP_Agg
18c30 20 20 20 20 20 20 20 30 78 30 30 30 30 30 32 20 0x000002
18c40 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 /* Contains one
18c50 6f 72 20 6d 6f 72 65 20 61 67 67 72 65 67 61 74 or more aggregat
18c60 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 e functions */.#
18c70 64 65 66 69 6e 65 20 45 50 5f 48 61 73 46 75 6e define EP_HasFun
18c80 63 20 20 20 30 78 30 30 30 30 30 34 20 2f 2a 20 c 0x000004 /*
18c90 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 Contains one or
18ca0 6d 6f 72 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f more functions o
18cb0 66 20 61 6e 79 20 6b 69 6e 64 20 2a 2f 0a 20 20 f any kind */.
18cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18cd0 2f 2a 20 30 78 30 30 30 30 30 38 20 2f 2f 20 61 /* 0x000008 // a
18ce0 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 75 73 65 vailable for use
18cf0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 44 */.#define EP_D
18d00 69 73 74 69 6e 63 74 20 20 30 78 30 30 30 30 31 istinct 0x00001
18d10 30 20 2f 2a 20 41 67 67 72 65 67 61 74 65 20 66 0 /* Aggregate f
18d20 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 44 49 53 unction with DIS
18d30 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 20 2a 2f TINCT keyword */
18d40 0a 23 64 65 66 69 6e 65 20 45 50 5f 56 61 72 53 .#define EP_VarS
18d50 65 6c 65 63 74 20 30 78 30 30 30 30 32 30 20 2f elect 0x000020 /
18d60 2a 20 70 53 65 6c 65 63 74 20 69 73 20 63 6f 72 * pSelect is cor
18d70 72 65 6c 61 74 65 64 2c 20 6e 6f 74 20 63 6f 6e related, not con
18d80 73 74 61 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 stant */.#define
18d90 20 45 50 5f 44 62 6c 51 75 6f 74 65 64 20 30 78 EP_DblQuoted 0x
18da0 30 30 30 30 34 30 20 2f 2a 20 74 6f 6b 65 6e 2e 000040 /* token.
18db0 7a 20 77 61 73 20 6f 72 69 67 69 6e 61 6c 6c 79 z was originally
18dc0 20 69 6e 20 22 2e 2e 2e 22 20 2a 2f 0a 23 64 65 in "..." */.#de
18dd0 66 69 6e 65 20 45 50 5f 49 6e 66 69 78 46 75 6e fine EP_InfixFun
18de0 63 20 30 78 30 30 30 30 38 30 20 2f 2a 20 54 72 c 0x000080 /* Tr
18df0 75 65 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 20 ue for an infix
18e00 66 75 6e 63 74 69 6f 6e 3a 20 4c 49 4b 45 2c 20 function: LIKE,
18e10 47 4c 4f 42 2c 20 65 74 63 20 2a 2f 0a 23 64 65 GLOB, etc */.#de
18e20 66 69 6e 65 20 45 50 5f 43 6f 6c 6c 61 74 65 20 fine EP_Collate
18e30 20 20 30 78 30 30 30 31 30 30 20 2f 2a 20 54 72 0x000100 /* Tr
18e40 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 4b ee contains a TK
18e50 5f 43 4f 4c 4c 41 54 45 20 6f 70 65 72 61 74 6f _COLLATE operato
18e60 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f r */.#define EP_
18e70 47 65 6e 65 72 69 63 20 20 20 30 78 30 30 30 32 Generic 0x0002
18e80 30 30 20 2f 2a 20 49 67 6e 6f 72 65 20 43 4f 4c 00 /* Ignore COL
18e90 4c 41 54 45 20 6f 72 20 61 66 66 69 6e 69 74 79 LATE or affinity
18ea0 20 6f 6e 20 74 68 69 73 20 74 72 65 65 20 2a 2f on this tree */
18eb0 0a 23 64 65 66 69 6e 65 20 45 50 5f 49 6e 74 56 .#define EP_IntV
18ec0 61 6c 75 65 20 20 30 78 30 30 30 34 30 30 20 2f alue 0x000400 /
18ed0 2a 20 49 6e 74 65 67 65 72 20 76 61 6c 75 65 20 * Integer value
18ee0 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 75 2e 69 contained in u.i
18ef0 56 61 6c 75 65 20 2a 2f 0a 23 64 65 66 69 6e 65 Value */.#define
18f00 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 30 78 EP_xIsSelect 0x
18f10 30 30 30 38 30 30 20 2f 2a 20 78 2e 70 53 65 6c 000800 /* x.pSel
18f20 65 63 74 20 69 73 20 76 61 6c 69 64 20 28 6f 74 ect is valid (ot
18f30 68 65 72 77 69 73 65 20 78 2e 70 4c 69 73 74 20 herwise x.pList
18f40 69 73 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 is) */.#define E
18f50 50 5f 53 6b 69 70 20 20 20 20 20 20 30 78 30 30 P_Skip 0x00
18f60 31 30 30 30 20 2f 2a 20 43 4f 4c 4c 41 54 45 2c 1000 /* COLLATE,
18f70 20 41 53 2c 20 6f 72 20 55 4e 4c 49 4b 45 4c 59 AS, or UNLIKELY
18f80 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 52 */.#define EP_R
18f90 65 64 75 63 65 64 20 20 20 30 78 30 30 32 30 30 educed 0x00200
18fa0 30 20 2f 2a 20 45 78 70 72 20 73 74 72 75 63 74 0 /* Expr struct
18fb0 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 49 5a EXPR_REDUCEDSIZ
18fc0 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a E bytes only */.
18fd0 23 64 65 66 69 6e 65 20 45 50 5f 54 6f 6b 65 6e #define EP_Token
18fe0 4f 6e 6c 79 20 30 78 30 30 34 30 30 30 20 2f 2a Only 0x004000 /*
18ff0 20 45 78 70 72 20 73 74 72 75 63 74 20 45 58 50 Expr struct EXP
19000 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a 45 20 R_TOKENONLYSIZE
19010 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a 23 64 bytes only */.#d
19020 65 66 69 6e 65 20 45 50 5f 53 74 61 74 69 63 20 efine EP_Static
19030 20 20 20 30 78 30 30 38 30 30 30 20 2f 2a 20 48 0x008000 /* H
19040 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 6e 6f eld in memory no
19050 74 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 t obtained from
19060 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 23 64 65 66 malloc() */.#def
19070 69 6e 65 20 45 50 5f 4d 65 6d 54 6f 6b 65 6e 20 ine EP_MemToken
19080 20 30 78 30 31 30 30 30 30 20 2f 2a 20 4e 65 65 0x010000 /* Nee
19090 64 20 74 6f 20 73 71 6c 69 74 65 33 44 62 46 72 d to sqlite3DbFr
190a0 65 65 28 29 20 45 78 70 72 2e 7a 54 6f 6b 65 6e ee() Expr.zToken
190b0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 4e */.#define EP_N
190c0 6f 52 65 64 75 63 65 20 20 30 78 30 32 30 30 30 oReduce 0x02000
190d0 30 20 2f 2a 20 43 61 6e 6e 6f 74 20 45 58 50 52 0 /* Cannot EXPR
190e0 44 55 50 5f 52 45 44 55 43 45 20 74 68 69 73 20 DUP_REDUCE this
190f0 45 78 70 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 Expr */.#define
19100 45 50 5f 55 6e 6c 69 6b 65 6c 79 20 20 30 78 30 EP_Unlikely 0x0
19110 34 30 30 30 30 20 2f 2a 20 75 6e 6c 69 6b 65 6c 40000 /* unlikel
19120 79 28 29 20 6f 72 20 6c 69 6b 65 6c 69 68 6f 6f y() or likelihoo
19130 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a d() function */.
19140 23 64 65 66 69 6e 65 20 45 50 5f 43 6f 6e 73 74 #define EP_Const
19150 46 75 6e 63 20 30 78 30 38 30 30 30 30 20 2f 2a Func 0x080000 /*
19160 20 41 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 A SQLITE_FUNC_C
19170 4f 4e 53 54 41 4e 54 20 6f 72 20 5f 53 4c 4f 43 ONSTANT or _SLOC
19180 48 4e 47 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a HNG function */.
19190 23 64 65 66 69 6e 65 20 45 50 5f 43 61 6e 42 65 #define EP_CanBe
191a0 4e 75 6c 6c 20 30 78 31 30 30 30 30 30 20 2f 2a Null 0x100000 /*
191b0 20 43 61 6e 20 62 65 20 6e 75 6c 6c 20 64 65 73 Can be null des
191c0 70 69 74 65 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f pite NOT NULL co
191d0 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 64 65 66 nstraint */.#def
191e0 69 6e 65 20 45 50 5f 53 75 62 71 75 65 72 79 20 ine EP_Subquery
191f0 20 30 78 32 30 30 30 30 30 20 2f 2a 20 54 72 65 0x200000 /* Tre
19200 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 4b 5f e contains a TK_
19210 53 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72 20 SELECT operator
19220 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 6c */.#define EP_Al
19230 69 61 73 20 20 20 20 20 30 78 34 30 30 30 30 30 ias 0x400000
19240 20 2f 2a 20 49 73 20 61 6e 20 61 6c 69 61 73 20 /* Is an alias
19250 66 6f 72 20 61 20 72 65 73 75 6c 74 20 73 65 74 for a result set
19260 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 65 66 69 column */.#defi
19270 6e 65 20 45 50 5f 4c 65 61 66 20 20 20 20 20 20 ne EP_Leaf
19280 30 78 38 30 30 30 30 30 20 2f 2a 20 45 78 70 72 0x800000 /* Expr
19290 2e 70 4c 65 66 74 2c 20 2e 70 52 69 67 68 74 2c .pLeft, .pRight,
192a0 20 2e 75 2e 70 53 65 6c 65 63 74 20 61 6c 6c 20 .u.pSelect all
192b0 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 NULL */../*.** T
192c0 68 65 20 45 50 5f 50 72 6f 70 61 67 61 74 65 20 he EP_Propagate
192d0 6d 61 73 6b 20 69 73 20 61 20 73 65 74 20 6f 66 mask is a set of
192e0 20 70 72 6f 70 65 72 74 69 65 73 20 74 68 61 74 properties that
192f0 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 70 automatically p
19300 72 6f 70 61 67 61 74 65 0a 2a 2a 20 75 70 77 61 ropagate.** upwa
19310 72 64 73 20 69 6e 74 6f 20 70 61 72 65 6e 74 20 rds into parent
19320 6e 6f 64 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e nodes..*/.#defin
19330 65 20 45 50 5f 50 72 6f 70 61 67 61 74 65 20 28 e EP_Propagate (
19340 45 50 5f 43 6f 6c 6c 61 74 65 7c 45 50 5f 53 75 EP_Collate|EP_Su
19350 62 71 75 65 72 79 7c 45 50 5f 48 61 73 46 75 6e bquery|EP_HasFun
19360 63 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 c)../*.** These
19370 6d 61 63 72 6f 73 20 63 61 6e 20 62 65 20 75 73 macros can be us
19380 65 64 20 74 6f 20 74 65 73 74 2c 20 73 65 74 2c ed to test, set,
19390 20 6f 72 20 63 6c 65 61 72 20 62 69 74 73 20 69 or clear bits i
193a0 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e 66 6c n the.** Expr.fl
193b0 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 64 ags field..*/.#d
193c0 65 66 69 6e 65 20 45 78 70 72 48 61 73 50 72 6f efine ExprHasPro
193d0 70 65 72 74 79 28 45 2c 50 29 20 20 20 20 20 28 perty(E,P) (
193e0 28 28 45 29 2d 3e 66 6c 61 67 73 26 28 50 29 29 ((E)->flags&(P))
193f0 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 45 78 70 !=0).#define Exp
19400 72 48 61 73 41 6c 6c 50 72 6f 70 65 72 74 79 28 rHasAllProperty(
19410 45 2c 50 29 20 20 28 28 28 45 29 2d 3e 66 6c 61 E,P) (((E)->fla
19420 67 73 26 28 50 29 29 3d 3d 28 50 29 29 0a 23 64 gs&(P))==(P)).#d
19430 65 66 69 6e 65 20 45 78 70 72 53 65 74 50 72 6f efine ExprSetPro
19440 70 65 72 74 79 28 45 2c 50 29 20 20 20 20 20 28 perty(E,P) (
19450 45 29 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 0a 23 E)->flags|=(P).#
19460 64 65 66 69 6e 65 20 45 78 70 72 43 6c 65 61 72 define ExprClear
19470 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 Property(E,P)
19480 28 45 29 2d 3e 66 6c 61 67 73 26 3d 7e 28 50 29 (E)->flags&=~(P)
19490 0a 0a 2f 2a 20 54 68 65 20 45 78 70 72 53 65 74 ../* The ExprSet
194a0 56 56 41 50 72 6f 70 65 72 74 79 28 29 20 6d 61 VVAProperty() ma
194b0 63 72 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 cro is used for
194c0 56 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 56 61 Verification, Va
194d0 6c 69 64 61 74 69 6f 6e 2c 0a 2a 2a 20 61 6e 64 lidation,.** and
194e0 20 41 63 63 72 65 64 69 74 61 74 69 6f 6e 20 6f Accreditation o
194f0 6e 6c 79 2e 20 20 49 74 20 77 6f 72 6b 73 20 6c nly. It works l
19500 69 6b 65 20 45 78 70 72 53 65 74 50 72 6f 70 65 ike ExprSetPrope
19510 72 74 79 28 29 20 64 75 72 69 6e 67 20 56 56 41 rty() during VVA
19520 0a 2a 2a 20 70 72 6f 63 65 73 73 65 73 20 62 75 .** processes bu
19530 74 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 6f 72 t is a no-op for
19540 20 64 65 6c 69 76 65 72 79 2e 0a 2a 2f 0a 23 69 delivery..*/.#i
19550 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
19560 47 0a 23 20 64 65 66 69 6e 65 20 45 78 70 72 53 G.# define ExprS
19570 65 74 56 56 41 50 72 6f 70 65 72 74 79 28 45 2c etVVAProperty(E,
19580 50 29 20 20 28 45 29 2d 3e 66 6c 61 67 73 7c 3d P) (E)->flags|=
19590 28 50 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 (P).#else.# defi
195a0 6e 65 20 45 78 70 72 53 65 74 56 56 41 50 72 6f ne ExprSetVVAPro
195b0 70 65 72 74 79 28 45 2c 50 29 0a 23 65 6e 64 69 perty(E,P).#endi
195c0 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 f../*.** Macros
195d0 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 to determine the
195e0 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 number of bytes
195f0 20 72 65 71 75 69 72 65 64 20 62 79 20 61 20 6e required by a n
19600 6f 72 6d 61 6c 20 45 78 70 72 0a 2a 2a 20 73 74 ormal Expr.** st
19610 72 75 63 74 2c 20 61 6e 20 45 78 70 72 20 73 74 ruct, an Expr st
19620 72 75 63 74 20 77 69 74 68 20 74 68 65 20 45 50 ruct with the EP
19630 5f 52 65 64 75 63 65 64 20 66 6c 61 67 20 73 65 _Reduced flag se
19640 74 20 69 6e 20 45 78 70 72 2e 66 6c 61 67 73 0a t in Expr.flags.
19650 2a 2a 20 61 6e 64 20 61 6e 20 45 78 70 72 20 73 ** and an Expr s
19660 74 72 75 63 74 20 77 69 74 68 20 74 68 65 20 45 truct with the E
19670 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 67 P_TokenOnly flag
19680 20 73 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 set..*/.#define
19690 20 45 58 50 52 5f 46 55 4c 4c 53 49 5a 45 20 20 EXPR_FULLSIZE
196a0 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28 sizeof(
196b0 45 78 70 72 29 20 20 20 20 20 20 20 20 20 20 20 Expr)
196c0 2f 2a 20 46 75 6c 6c 20 73 69 7a 65 20 2a 2f 0a /* Full size */.
196d0 23 64 65 66 69 6e 65 20 45 58 50 52 5f 52 45 44 #define EXPR_RED
196e0 55 43 45 44 53 49 5a 45 20 20 20 20 20 20 20 20 UCEDSIZE
196f0 6f 66 66 73 65 74 6f 66 28 45 78 70 72 2c 69 54 offsetof(Expr,iT
19700 61 62 6c 65 29 20 20 2f 2a 20 43 6f 6d 6d 6f 6e able) /* Common
19710 20 66 65 61 74 75 72 65 73 20 2a 2f 0a 23 64 65 features */.#de
19720 66 69 6e 65 20 45 58 50 52 5f 54 4f 4b 45 4e 4f fine EXPR_TOKENO
19730 4e 4c 59 53 49 5a 45 20 20 20 20 20 20 6f 66 66 NLYSIZE off
19740 73 65 74 6f 66 28 45 78 70 72 2c 70 4c 65 66 74 setof(Expr,pLeft
19750 29 20 20 20 2f 2a 20 46 65 77 65 72 20 66 65 61 ) /* Fewer fea
19760 74 75 72 65 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 tures */../*.**
19770 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 6f 20 Flags passed to
19780 74 68 65 20 73 71 6c 69 74 65 33 45 78 70 72 44 the sqlite3ExprD
19790 75 70 28 29 20 66 75 6e 63 74 69 6f 6e 2e 20 53 up() function. S
197a0 65 65 20 74 68 65 20 68 65 61 64 65 72 20 63 6f ee the header co
197b0 6d 6d 65 6e 74 0a 2a 2a 20 61 62 6f 76 65 20 73 mment.** above s
197c0 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 29 20 qlite3ExprDup()
197d0 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a for details..*/.
197e0 23 64 65 66 69 6e 65 20 45 58 50 52 44 55 50 5f #define EXPRDUP_
197f0 52 45 44 55 43 45 20 20 20 20 20 20 20 20 20 30 REDUCE 0
19800 78 30 30 30 31 20 20 2f 2a 20 55 73 65 64 20 72 x0001 /* Used r
19810 65 64 75 63 65 64 2d 73 69 7a 65 20 45 78 70 72 educed-size Expr
19820 20 6e 6f 64 65 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a nodes */../*.**
19830 20 41 20 6c 69 73 74 20 6f 66 20 65 78 70 72 65 A list of expre
19840 73 73 69 6f 6e 73 2e 20 20 45 61 63 68 20 65 78 ssions. Each ex
19850 70 72 65 73 73 69 6f 6e 20 6d 61 79 20 6f 70 74 pression may opt
19860 69 6f 6e 61 6c 6c 79 20 68 61 76 65 20 61 0a 2a ionally have a.*
19870 2a 20 6e 61 6d 65 2e 20 20 41 6e 20 65 78 70 72 * name. An expr
19880 2f 6e 61 6d 65 20 63 6f 6d 62 69 6e 61 74 69 6f /name combinatio
19890 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 69 6e n can be used in
198a0 20 73 65 76 65 72 61 6c 20 77 61 79 73 2c 20 73 several ways, s
198b0 75 63 68 0a 2a 2a 20 61 73 20 74 68 65 20 6c 69 uch.** as the li
198c0 73 74 20 6f 66 20 22 65 78 70 72 20 41 53 20 49 st of "expr AS I
198d0 44 22 20 66 69 65 6c 64 73 20 66 6f 6c 6c 6f 77 D" fields follow
198e0 69 6e 67 20 61 20 22 53 45 4c 45 43 54 22 20 6f ing a "SELECT" o
198f0 72 20 69 6e 20 74 68 65 0a 2a 2a 20 6c 69 73 74 r in the.** list
19900 20 6f 66 20 22 49 44 20 3d 20 65 78 70 72 22 20 of "ID = expr"
19910 69 74 65 6d 73 20 69 6e 20 61 6e 20 55 50 44 41 items in an UPDA
19920 54 45 2e 20 20 41 20 6c 69 73 74 20 6f 66 20 65 TE. A list of e
19930 78 70 72 65 73 73 69 6f 6e 73 20 63 61 6e 0a 2a xpressions can.*
19940 2a 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 61 * also be used a
19950 73 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 74 s the argument t
19960 6f 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 69 6e o a function, in
19970 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 which case the
19980 61 2e 7a 4e 61 6d 65 0a 2a 2a 20 66 69 65 6c 64 a.zName.** field
19990 20 69 73 20 6e 6f 74 20 75 73 65 64 2e 0a 2a 2a is not used..**
199a0 0a 2a 2a 20 42 79 20 64 65 66 61 75 6c 74 20 74 .** By default t
199b0 68 65 20 45 78 70 72 2e 7a 53 70 61 6e 20 66 69 he Expr.zSpan fi
199c0 65 6c 64 20 68 6f 6c 64 73 20 61 20 68 75 6d 61 eld holds a huma
199d0 6e 2d 72 65 61 64 61 62 6c 65 20 64 65 73 63 72 n-readable descr
199e0 69 70 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 65 iption of.** the
199f0 20 65 78 70 72 65 73 73 69 6f 6e 20 74 68 61 74 expression that
19a00 20 69 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 is used in the
19a10 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 65 72 generation of er
19a20 72 6f 72 20 6d 65 73 73 61 67 65 73 20 61 6e 64 ror messages and
19a30 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6c 61 62 65 6c .** column label
19a40 73 2e 20 20 49 6e 20 74 68 69 73 20 63 61 73 65 s. In this case
19a50 2c 20 45 78 70 72 2e 7a 53 70 61 6e 20 69 73 20 , Expr.zSpan is
19a60 74 79 70 69 63 61 6c 6c 79 20 74 68 65 20 74 65 typically the te
19a70 78 74 20 6f 66 20 61 0a 2a 2a 20 63 6f 6c 75 6d xt of a.** colum
19a80 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 61 73 20 n expression as
19a90 69 74 20 65 78 69 73 74 73 20 69 6e 20 61 20 53 it exists in a S
19aa0 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e ELECT statement.
19ab0 20 20 48 6f 77 65 76 65 72 2c 20 69 66 0a 2a 2a However, if.**
19ac0 20 74 68 65 20 62 53 70 61 6e 49 73 54 61 62 20 the bSpanIsTab
19ad0 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 65 flag is set, the
19ae0 6e 20 7a 53 70 61 6e 20 69 73 20 6f 76 65 72 6c n zSpan is overl
19af0 6f 61 64 65 64 20 74 6f 20 6d 65 61 6e 20 74 68 oaded to mean th
19b00 65 20 6e 61 6d 65 0a 2a 2a 20 6f 66 20 74 68 65 e name.** of the
19b10 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 20 69 result column i
19b20 6e 20 74 68 65 20 66 6f 72 6d 3a 20 44 41 54 41 n the form: DATA
19b30 42 41 53 45 2e 54 41 42 4c 45 2e 43 4f 4c 55 4d BASE.TABLE.COLUM
19b40 4e 2e 20 20 54 68 69 73 20 6c 61 74 65 72 0a 2a N. This later.*
19b50 2a 20 66 6f 72 6d 20 69 73 20 75 73 65 64 20 66 * form is used f
19b60 6f 72 20 6e 61 6d 65 20 72 65 73 6f 6c 75 74 69 or name resoluti
19b70 6f 6e 20 77 69 74 68 20 6e 65 73 74 65 64 20 46 on with nested F
19b80 52 4f 4d 20 63 6c 61 75 73 65 73 2e 0a 2a 2f 0a ROM clauses..*/.
19b90 73 74 72 75 63 74 20 45 78 70 72 4c 69 73 74 20 struct ExprList
19ba0 7b 0a 20 20 69 6e 74 20 6e 45 78 70 72 3b 20 20 {. int nExpr;
19bb0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
19bc0 6d 62 65 72 20 6f 66 20 65 78 70 72 65 73 73 69 mber of expressi
19bd0 6f 6e 73 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 ons on the list
19be0 2a 2f 0a 20 20 73 74 72 75 63 74 20 45 78 70 72 */. struct Expr
19bf0 4c 69 73 74 5f 69 74 65 6d 20 7b 20 2f 2a 20 46 List_item { /* F
19c00 6f 72 20 65 61 63 68 20 65 78 70 72 65 73 73 69 or each expressi
19c10 6f 6e 20 69 6e 20 74 68 65 20 6c 69 73 74 20 2a on in the list *
19c20 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 /. Expr *pExp
19c30 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a r; /*
19c40 20 54 68 65 20 70 61 72 73 65 20 74 72 65 65 20 The parse tree
19c50 66 6f 72 20 74 68 69 73 20 65 78 70 72 65 73 73 for this express
19c60 69 6f 6e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 ion */. char
19c70 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 *zName;
19c80 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 61 73 73 6f /* Token asso
19c90 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69 73 ciated with this
19ca0 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 expression */.
19cb0 20 20 20 63 68 61 72 20 2a 7a 53 70 61 6e 3b 20 char *zSpan;
19cc0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 /* Or
19cd0 69 67 69 6e 61 6c 20 74 65 78 74 20 6f 66 20 74 iginal text of t
19ce0 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f he expression */
19cf0 0a 20 20 20 20 75 38 20 73 6f 72 74 4f 72 64 65 . u8 sortOrde
19d00 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 r; /*
19d10 31 20 66 6f 72 20 44 45 53 43 20 6f 72 20 30 20 1 for DESC or 0
19d20 66 6f 72 20 41 53 43 20 2a 2f 0a 20 20 20 20 75 for ASC */. u
19d30 6e 73 69 67 6e 65 64 20 64 6f 6e 65 20 3a 31 3b nsigned done :1;
19d40 20 20 20 20 20 20 20 2f 2a 20 41 20 66 6c 61 67 /* A flag
19d50 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 68 65 to indicate whe
19d60 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20 n processing is
19d70 66 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 20 20 finished */.
19d80 75 6e 73 69 67 6e 65 64 20 62 53 70 61 6e 49 73 unsigned bSpanIs
19d90 54 61 62 20 3a 31 3b 20 2f 2a 20 7a 53 70 61 6e Tab :1; /* zSpan
19da0 20 68 6f 6c 64 73 20 44 42 2e 54 41 42 4c 45 2e holds DB.TABLE.
19db0 43 4f 4c 55 4d 4e 20 2a 2f 0a 20 20 20 20 75 6e COLUMN */. un
19dc0 73 69 67 6e 65 64 20 72 65 75 73 61 62 6c 65 20 signed reusable
19dd0 3a 31 3b 20 20 20 2f 2a 20 43 6f 6e 73 74 61 6e :1; /* Constan
19de0 74 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 t expression is
19df0 72 65 75 73 61 62 6c 65 20 2a 2f 0a 20 20 20 20 reusable */.
19e00 75 6e 73 69 67 6e 65 64 20 62 53 6f 72 74 65 72 unsigned bSorter
19e10 52 65 66 20 3a 31 3b 20 2f 2a 20 44 65 66 65 72 Ref :1; /* Defer
19e20 20 65 76 61 6c 75 61 74 69 6f 6e 20 75 6e 74 69 evaluation unti
19e30 6c 20 61 66 74 65 72 20 73 6f 72 74 69 6e 67 20 l after sorting
19e40 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 20 7b 0a 20 */. union {.
19e50 20 20 20 20 20 73 74 72 75 63 74 20 7b 0a 20 20 struct {.
19e60 20 20 20 20 20 20 75 31 36 20 69 4f 72 64 65 72 u16 iOrder
19e70 42 79 43 6f 6c 3b 20 20 20 20 20 20 2f 2a 20 46 ByCol; /* F
19e80 6f 72 20 4f 52 44 45 52 20 42 59 2c 20 63 6f 6c or ORDER BY, col
19e90 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 72 65 umn number in re
19ea0 73 75 6c 74 20 73 65 74 20 2a 2f 0a 20 20 20 20 sult set */.
19eb0 20 20 20 20 75 31 36 20 69 41 6c 69 61 73 3b 20 u16 iAlias;
19ec0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
19ed0 65 78 20 69 6e 74 6f 20 50 61 72 73 65 2e 61 41 ex into Parse.aA
19ee0 6c 69 61 73 5b 5d 20 66 6f 72 20 7a 4e 61 6d 65 lias[] for zName
19ef0 20 2a 2f 0a 20 20 20 20 20 20 7d 20 78 3b 0a 20 */. } x;.
19f00 20 20 20 20 20 69 6e 74 20 69 43 6f 6e 73 74 45 int iConstE
19f10 78 70 72 52 65 67 3b 20 20 20 20 20 20 2f 2a 20 xprReg; /*
19f20 52 65 67 69 73 74 65 72 20 69 6e 20 77 68 69 63 Register in whic
19f30 68 20 45 78 70 72 20 76 61 6c 75 65 20 69 73 20 h Expr value is
19f40 63 61 63 68 65 64 20 2a 2f 0a 20 20 20 20 7d 20 cached */. }
19f50 75 3b 0a 20 20 7d 20 61 5b 31 5d 3b 20 20 20 20 u;. } a[1];
19f60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
19f70 20 4f 6e 65 20 73 6c 6f 74 20 66 6f 72 20 65 61 One slot for ea
19f80 63 68 20 65 78 70 72 65 73 73 69 6f 6e 20 69 6e ch expression in
19f90 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a the list */.};.
19fa0 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
19fb0 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 ce of this struc
19fc0 74 75 72 65 20 63 61 6e 20 68 6f 6c 64 20 61 20 ture can hold a
19fd0 73 69 6d 70 6c 65 20 6c 69 73 74 20 6f 66 20 69 simple list of i
19fe0 64 65 6e 74 69 66 69 65 72 73 2c 0a 2a 2a 20 73 dentifiers,.** s
19ff0 75 63 68 20 61 73 20 74 68 65 20 6c 69 73 74 20 uch as the list
1a000 22 61 2c 62 2c 63 22 20 69 6e 20 74 68 65 20 66 "a,b,c" in the f
1a010 6f 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 ollowing stateme
1a020 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 nts:.**.**
1a030 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 28 61 2c INSERT INTO t(a,
1a040 62 2c 63 29 20 56 41 4c 55 45 53 20 2e 2e 2e 3b b,c) VALUES ...;
1a050 0a 2a 2a 20 20 20 20 20 20 43 52 45 41 54 45 20 .** CREATE
1a060 49 4e 44 45 58 20 69 64 78 20 4f 4e 20 74 28 61 INDEX idx ON t(a
1a070 2c 62 2c 63 29 3b 0a 2a 2a 20 20 20 20 20 20 43 ,b,c);.** C
1a080 52 45 41 54 45 20 54 52 49 47 47 45 52 20 74 72 REATE TRIGGER tr
1a090 69 67 20 42 45 46 4f 52 45 20 55 50 44 41 54 45 ig BEFORE UPDATE
1a0a0 20 4f 4e 20 74 28 61 2c 62 2c 63 29 20 2e 2e 2e ON t(a,b,c) ...
1a0b0 3b 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 64 4c 69 ;.**.** The IdLi
1a0c0 73 74 2e 61 2e 69 64 78 20 66 69 65 6c 64 20 69 st.a.idx field i
1a0d0 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 s used when the
1a0e0 49 64 4c 69 73 74 20 72 65 70 72 65 73 65 6e 74 IdList represent
1a0f0 73 20 74 68 65 20 6c 69 73 74 20 6f 66 0a 2a 2a s the list of.**
1a100 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 61 66 column names af
1a110 74 65 72 20 61 20 74 61 62 6c 65 20 6e 61 6d 65 ter a table name
1a120 20 69 6e 20 61 6e 20 49 4e 53 45 52 54 20 73 74 in an INSERT st
1a130 61 74 65 6d 65 6e 74 2e 20 20 49 6e 20 74 68 65 atement. In the
1a140 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 0a 2a 2a statement.**.**
1a150 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 4f INSERT INTO
1a160 20 74 28 61 2c 62 2c 63 29 20 2e 2e 2e 0a 2a 2a t(a,b,c) ....**
1a170 0a 2a 2a 20 49 66 20 22 61 22 20 69 73 20 74 68 .** If "a" is th
1a180 65 20 6b 2d 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 e k-th column of
1a190 20 74 61 62 6c 65 20 22 74 22 2c 20 74 68 65 6e table "t", then
1a1a0 20 49 64 4c 69 73 74 2e 61 5b 30 5d 2e 69 64 78 IdList.a[0].idx
1a1b0 3d 3d 6b 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 ==k..*/.struct I
1a1c0 64 4c 69 73 74 20 7b 0a 20 20 73 74 72 75 63 74 dList {. struct
1a1d0 20 49 64 4c 69 73 74 5f 69 74 65 6d 20 7b 0a 20 IdList_item {.
1a1e0 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 char *zName;
1a1f0 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
1a200 74 68 65 20 69 64 65 6e 74 69 66 69 65 72 20 2a the identifier *
1a210 2f 0a 20 20 20 20 69 6e 74 20 69 64 78 3b 20 20 /. int idx;
1a220 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 /* Index
1a230 20 69 6e 20 73 6f 6d 65 20 54 61 62 6c 65 2e 61 in some Table.a
1a240 43 6f 6c 5b 5d 20 6f 66 20 61 20 63 6f 6c 75 6d Col[] of a colum
1a250 6e 20 6e 61 6d 65 64 20 7a 4e 61 6d 65 20 2a 2f n named zName */
1a260 0a 20 20 7d 20 2a 61 3b 0a 20 20 69 6e 74 20 6e . } *a;. int n
1a270 49 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e Id; /* N
1a280 75 6d 62 65 72 20 6f 66 20 69 64 65 6e 74 69 66 umber of identif
1a290 69 65 72 73 20 6f 6e 20 74 68 65 20 6c 69 73 74 iers on the list
1a2a0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 */.};../*.** Th
1a2b0 65 20 62 69 74 6d 61 73 6b 20 64 61 74 61 74 79 e bitmask dataty
1a2c0 70 65 20 64 65 66 69 6e 65 64 20 62 65 6c 6f 77 pe defined below
1a2d0 20 69 73 20 75 73 65 64 20 66 6f 72 20 76 61 72 is used for var
1a2e0 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f ious optimizatio
1a2f0 6e 73 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69 ns..**.** Changi
1a300 6e 67 20 74 68 69 73 20 66 72 6f 6d 20 61 20 36 ng this from a 6
1a310 34 2d 62 69 74 20 74 6f 20 61 20 33 32 2d 62 69 4-bit to a 32-bi
1a320 74 20 74 79 70 65 20 6c 69 6d 69 74 73 20 74 68 t type limits th
1a330 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 74 e number of.** t
1a340 61 62 6c 65 73 20 69 6e 20 61 20 6a 6f 69 6e 20 ables in a join
1a350 74 6f 20 33 32 20 69 6e 73 74 65 61 64 20 6f 66 to 32 instead of
1a360 20 36 34 2e 20 20 42 75 74 20 69 74 20 61 6c 73 64. But it als
1a370 6f 20 72 65 64 75 63 65 73 20 74 68 65 20 73 69 o reduces the si
1a380 7a 65 0a 2a 2a 20 6f 66 20 74 68 65 20 6c 69 62 ze.** of the lib
1a390 72 61 72 79 20 62 79 20 37 33 38 20 62 79 74 65 rary by 738 byte
1a3a0 73 20 6f 6e 20 69 78 38 36 2e 0a 2a 2f 0a 23 69 s on ix86..*/.#i
1a3b0 66 64 65 66 20 53 51 4c 49 54 45 5f 42 49 54 4d fdef SQLITE_BITM
1a3c0 41 53 4b 5f 54 59 50 45 0a 20 20 74 79 70 65 64 ASK_TYPE. typed
1a3d0 65 66 20 53 51 4c 49 54 45 5f 42 49 54 4d 41 53 ef SQLITE_BITMAS
1a3e0 4b 5f 54 59 50 45 20 42 69 74 6d 61 73 6b 3b 0a K_TYPE Bitmask;.
1a3f0 23 65 6c 73 65 0a 20 20 74 79 70 65 64 65 66 20 #else. typedef
1a400 75 36 34 20 42 69 74 6d 61 73 6b 3b 0a 23 65 6e u64 Bitmask;.#en
1a410 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e dif../*.** The n
1a420 75 6d 62 65 72 20 6f 66 20 62 69 74 73 20 69 6e umber of bits in
1a430 20 61 20 42 69 74 6d 61 73 6b 2e 20 20 22 42 4d a Bitmask. "BM
1a440 53 22 20 6d 65 61 6e 73 20 22 42 69 74 4d 61 73 S" means "BitMas
1a450 6b 20 53 69 7a 65 22 2e 0a 2a 2f 0a 23 64 65 66 k Size"..*/.#def
1a460 69 6e 65 20 42 4d 53 20 20 28 28 69 6e 74 29 28 ine BMS ((int)(
1a470 73 69 7a 65 6f 66 28 42 69 74 6d 61 73 6b 29 2a sizeof(Bitmask)*
1a480 38 29 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 62 69 74 8))../*.** A bit
1a490 20 69 6e 20 61 20 42 69 74 6d 61 73 6b 0a 2a 2f in a Bitmask.*/
1a4a0 0a 23 64 65 66 69 6e 65 20 4d 41 53 4b 42 49 54 .#define MASKBIT
1a4b0 28 6e 29 20 20 20 28 28 28 42 69 74 6d 61 73 6b (n) (((Bitmask
1a4c0 29 31 29 3c 3c 28 6e 29 29 0a 23 64 65 66 69 6e )1)<<(n)).#defin
1a4d0 65 20 4d 41 53 4b 42 49 54 33 32 28 6e 29 20 28 e MASKBIT32(n) (
1a4e0 28 28 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 31 ((unsigned int)1
1a4f0 29 3c 3c 28 6e 29 29 0a 23 64 65 66 69 6e 65 20 )<<(n)).#define
1a500 41 4c 4c 42 49 54 53 20 20 20 20 20 20 28 28 42 ALLBITS ((B
1a510 69 74 6d 61 73 6b 29 2d 31 29 0a 0a 2f 2a 0a 2a itmask)-1)../*.*
1a520 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
1a530 73 74 72 75 63 74 75 72 65 20 64 65 73 63 72 69 structure descri
1a540 62 65 73 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 bes the FROM cla
1a550 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43 54 20 use of a SELECT
1a560 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 45 61 statement..** Ea
1a570 63 68 20 74 61 62 6c 65 20 6f 72 20 73 75 62 71 ch table or subq
1a580 75 65 72 79 20 69 6e 20 74 68 65 20 46 52 4f 4d uery in the FROM
1a590 20 63 6c 61 75 73 65 20 69 73 20 61 20 73 65 70 clause is a sep
1a5a0 61 72 61 74 65 20 65 6c 65 6d 65 6e 74 20 6f 66 arate element of
1a5b0 0a 2a 2a 20 74 68 65 20 53 72 63 4c 69 73 74 2e .** the SrcList.
1a5c0 61 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a 2a 2a a[] array..**.**
1a5d0 20 57 69 74 68 20 74 68 65 20 61 64 64 69 74 69 With the additi
1a5e0 6f 6e 20 6f 66 20 6d 75 6c 74 69 70 6c 65 20 64 on of multiple d
1a5f0 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 2c atabase support,
1a600 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
1a610 74 72 75 63 74 75 72 65 0a 2a 2a 20 63 61 6e 20 tructure.** can
1a620 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 6f 20 also be used to
1a630 64 65 73 63 72 69 62 65 20 61 20 70 61 72 74 69 describe a parti
1a640 63 75 6c 61 72 20 74 61 62 6c 65 20 73 75 63 68 cular table such
1a650 20 61 73 20 74 68 65 20 74 61 62 6c 65 20 74 68 as the table th
1a660 61 74 0a 2a 2a 20 69 73 20 6d 6f 64 69 66 69 65 at.** is modifie
1a670 64 20 62 79 20 61 6e 20 49 4e 53 45 52 54 2c 20 d by an INSERT,
1a680 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 44 41 54 DELETE, or UPDAT
1a690 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 49 6e E statement. In
1a6a0 20 73 74 61 6e 64 61 72 64 20 53 51 4c 2c 0a 2a standard SQL,.*
1a6b0 2a 20 73 75 63 68 20 61 20 74 61 62 6c 65 20 6d * such a table m
1a6c0 75 73 74 20 62 65 20 61 20 73 69 6d 70 6c 65 20 ust be a simple
1a6d0 6e 61 6d 65 3a 20 49 44 2e 20 20 42 75 74 20 69 name: ID. But i
1a6e0 6e 20 53 51 4c 69 74 65 2c 20 74 68 65 20 74 61 n SQLite, the ta
1a6f0 62 6c 65 20 63 61 6e 0a 2a 2a 20 6e 6f 77 20 62 ble can.** now b
1a700 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 e identified by
1a710 61 20 64 61 74 61 62 61 73 65 20 6e 61 6d 65 2c a database name,
1a720 20 61 20 64 6f 74 2c 20 74 68 65 6e 20 74 68 65 a dot, then the
1a730 20 74 61 62 6c 65 20 6e 61 6d 65 3a 20 49 44 2e table name: ID.
1a740 49 44 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6a 6f ID..**.** The jo
1a750 69 6e 74 79 70 65 20 73 74 61 72 74 73 20 6f 75 intype starts ou
1a760 74 20 73 68 6f 77 69 6e 67 20 74 68 65 20 6a 6f t showing the jo
1a770 69 6e 20 74 79 70 65 20 62 65 74 77 65 65 6e 20 in type between
1a780 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 62 6c the current tabl
1a790 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 6e 65 78 e.** and the nex
1a7a0 74 20 74 61 62 6c 65 20 6f 6e 20 74 68 65 20 6c t table on the l
1a7b0 69 73 74 2e 20 20 54 68 65 20 70 61 72 73 65 72 ist. The parser
1a7c0 20 62 75 69 6c 64 73 20 74 68 65 20 6c 69 73 74 builds the list
1a7d0 20 74 68 69 73 20 77 61 79 2e 0a 2a 2a 20 42 75 this way..** Bu
1a7e0 74 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 t sqlite3SrcList
1a7f0 53 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 29 20 ShiftJoinType()
1a800 6c 61 74 65 72 20 73 68 69 66 74 73 20 74 68 65 later shifts the
1a810 20 6a 6f 69 6e 74 79 70 65 73 20 73 6f 20 74 68 jointypes so th
1a820 61 74 20 65 61 63 68 0a 2a 2a 20 6a 6f 69 6e 74 at each.** joint
1a830 79 70 65 20 65 78 70 72 65 73 73 65 73 20 74 68 ype expresses th
1a840 65 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e 20 74 e join between t
1a850 68 65 20 74 61 62 6c 65 20 61 6e 64 20 74 68 65 he table and the
1a860 20 70 72 65 76 69 6f 75 73 20 74 61 62 6c 65 2e previous table.
1a870 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 63 6f .**.** In the co
1a880 6c 55 73 65 64 20 66 69 65 6c 64 2c 20 74 68 65 lUsed field, the
1a890 20 68 69 67 68 2d 6f 72 64 65 72 20 62 69 74 20 high-order bit
1a8a0 28 62 69 74 20 36 33 29 20 69 73 20 73 65 74 20 (bit 63) is set
1a8b0 69 66 20 74 68 65 20 74 61 62 6c 65 0a 2a 2a 20 if the table.**
1a8c0 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 74 68 contains more th
1a8d0 61 6e 20 36 33 20 63 6f 6c 75 6d 6e 73 20 61 6e an 63 columns an
1a8e0 64 20 74 68 65 20 36 34 2d 74 68 20 6f 72 20 6c d the 64-th or l
1a8f0 61 74 65 72 20 63 6f 6c 75 6d 6e 20 69 73 20 75 ater column is u
1a900 73 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 sed..*/.struct S
1a910 72 63 4c 69 73 74 20 7b 0a 20 20 69 6e 74 20 6e rcList {. int n
1a920 53 72 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e Src; /* N
1a930 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 73 20 umber of tables
1a940 6f 72 20 73 75 62 71 75 65 72 69 65 73 20 69 6e or subqueries in
1a950 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 the FROM clause
1a960 20 2a 2f 0a 20 20 75 33 32 20 6e 41 6c 6c 6f 63 */. u32 nAlloc
1a970 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 ; /* Number
1a980 20 6f 66 20 65 6e 74 72 69 65 73 20 61 6c 6c 6f of entries allo
1a990 63 61 74 65 64 20 69 6e 20 61 5b 5d 20 62 65 6c cated in a[] bel
1a9a0 6f 77 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 53 ow */. struct S
1a9b0 72 63 4c 69 73 74 5f 69 74 65 6d 20 7b 0a 20 20 rcList_item {.
1a9c0 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d Schema *pSchem
1a9d0 61 3b 20 20 2f 2a 20 53 63 68 65 6d 61 20 74 6f a; /* Schema to
1a9e0 20 77 68 69 63 68 20 74 68 69 73 20 69 74 65 6d which this item
1a9f0 20 69 73 20 66 69 78 65 64 20 2a 2f 0a 20 20 20 is fixed */.
1aa00 20 63 68 61 72 20 2a 7a 44 61 74 61 62 61 73 65 char *zDatabase
1aa10 3b 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 61 ; /* Name of da
1aa20 74 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 20 74 tabase holding t
1aa30 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 his table */.
1aa40 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 char *zName;
1aa50 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
1aa60 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 63 e table */. c
1aa70 68 61 72 20 2a 7a 41 6c 69 61 73 3b 20 20 20 20 har *zAlias;
1aa80 20 2f 2a 20 54 68 65 20 22 42 22 20 70 61 72 74 /* The "B" part
1aa90 20 6f 66 20 61 20 22 41 20 41 53 20 42 22 20 70 of a "A AS B" p
1aaa0 68 72 61 73 65 2e 20 20 7a 4e 61 6d 65 20 69 73 hrase. zName is
1aab0 20 74 68 65 20 22 41 22 20 2a 2f 0a 20 20 20 20 the "A" */.
1aac0 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 Table *pTab;
1aad0 20 20 2f 2a 20 41 6e 20 53 51 4c 20 74 61 62 6c /* An SQL tabl
1aae0 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 e corresponding
1aaf0 74 6f 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 20 20 to zName */.
1ab00 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 3b Select *pSelect;
1ab10 20 20 2f 2a 20 41 20 53 45 4c 45 43 54 20 73 74 /* A SELECT st
1ab20 61 74 65 6d 65 6e 74 20 75 73 65 64 20 69 6e 20 atement used in
1ab30 70 6c 61 63 65 20 6f 66 20 61 20 74 61 62 6c 65 place of a table
1ab40 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 69 6e 74 name */. int
1ab50 20 61 64 64 72 46 69 6c 6c 53 75 62 3b 20 20 2f addrFillSub; /
1ab60 2a 20 41 64 64 72 65 73 73 20 6f 66 20 73 75 62 * Address of sub
1ab70 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 6e 69 66 routine to manif
1ab80 65 73 74 20 61 20 73 75 62 71 75 65 72 79 20 2a est a subquery *
1ab90 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 52 65 74 /. int regRet
1aba0 75 72 6e 3b 20 20 20 20 2f 2a 20 52 65 67 69 73 urn; /* Regis
1abb0 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 65 74 75 ter holding retu
1abc0 72 6e 20 61 64 64 72 65 73 73 20 6f 66 20 61 64 rn address of ad
1abd0 64 72 46 69 6c 6c 53 75 62 20 2a 2f 0a 20 20 20 drFillSub */.
1abe0 20 69 6e 74 20 72 65 67 52 65 73 75 6c 74 3b 20 int regResult;
1abf0 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 73 20 /* Registers
1ac00 68 6f 6c 64 69 6e 67 20 72 65 73 75 6c 74 73 20 holding results
1ac10 6f 66 20 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 of a co-routine
1ac20 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 7b 0a */. struct {.
1ac30 20 20 20 20 20 20 75 38 20 6a 6f 69 6e 74 79 70 u8 jointyp
1ac40 65 3b 20 20 20 20 20 20 2f 2a 20 54 79 70 65 20 e; /* Type
1ac50 6f 66 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e 20 of join between
1ac60 74 68 69 73 20 74 61 62 6c 65 20 61 6e 64 20 74 this table and t
1ac70 68 65 20 70 72 65 76 69 6f 75 73 20 2a 2f 0a 20 he previous */.
1ac80 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 6e 6f unsigned no
1ac90 74 49 6e 64 65 78 65 64 20 3a 31 3b 20 20 20 20 tIndexed :1;
1aca0 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 72 65 /* True if there
1acb0 20 69 73 20 61 20 4e 4f 54 20 49 4e 44 45 58 45 is a NOT INDEXE
1acc0 44 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 D clause */.
1acd0 20 20 75 6e 73 69 67 6e 65 64 20 69 73 49 6e 64 unsigned isInd
1ace0 65 78 65 64 42 79 20 3a 31 3b 20 20 20 2f 2a 20 exedBy :1; /*
1acf0 54 72 75 65 20 69 66 20 74 68 65 72 65 20 69 73 True if there is
1ad00 20 61 6e 20 49 4e 44 45 58 45 44 20 42 59 20 63 an INDEXED BY c
1ad10 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 20 20 75 lause */. u
1ad20 6e 73 69 67 6e 65 64 20 69 73 54 61 62 46 75 6e nsigned isTabFun
1ad30 63 20 3a 31 3b 20 20 20 20 20 2f 2a 20 54 72 75 c :1; /* Tru
1ad40 65 20 69 66 20 74 61 62 6c 65 2d 76 61 6c 75 65 e if table-value
1ad50 64 2d 66 75 6e 63 74 69 6f 6e 20 73 79 6e 74 61 d-function synta
1ad60 78 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 67 x */. unsig
1ad70 6e 65 64 20 69 73 43 6f 72 72 65 6c 61 74 65 64 ned isCorrelated
1ad80 20 3a 31 3b 20 20 2f 2a 20 54 72 75 65 20 69 66 :1; /* True if
1ad90 20 73 75 62 2d 71 75 65 72 79 20 69 73 20 63 6f sub-query is co
1ada0 72 72 65 6c 61 74 65 64 20 2a 2f 0a 20 20 20 20 rrelated */.
1adb0 20 20 75 6e 73 69 67 6e 65 64 20 76 69 61 43 6f unsigned viaCo
1adc0 72 6f 75 74 69 6e 65 20 3a 31 3b 20 20 2f 2a 20 routine :1; /*
1add0 49 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 Implemented as a
1ade0 20 63 6f 2d 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 co-routine */.
1adf0 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 73 unsigned is
1ae00 52 65 63 75 72 73 69 76 65 20 3a 31 3b 20 20 20 Recursive :1;
1ae10 2f 2a 20 54 72 75 65 20 66 6f 72 20 72 65 63 75 /* True for recu
1ae20 72 73 69 76 65 20 72 65 66 65 72 65 6e 63 65 20 rsive reference
1ae30 69 6e 20 57 49 54 48 20 2a 2f 0a 20 20 20 20 7d in WITH */. }
1ae40 20 66 67 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c fg;.#ifndef SQL
1ae50 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e ITE_OMIT_EXPLAIN
1ae60 0a 20 20 20 20 75 38 20 69 53 65 6c 65 63 74 49 . u8 iSelectI
1ae70 64 3b 20 20 20 20 20 2f 2a 20 49 66 20 70 53 65 d; /* If pSe
1ae80 6c 65 63 74 21 3d 30 2c 20 74 68 65 20 69 64 20 lect!=0, the id
1ae90 6f 66 20 74 68 65 20 73 75 62 2d 73 65 6c 65 63 of the sub-selec
1aea0 74 20 69 6e 20 45 51 50 20 2a 2f 0a 23 65 6e 64 t in EQP */.#end
1aeb0 69 66 0a 20 20 20 20 69 6e 74 20 69 43 75 72 73 if. int iCurs
1aec0 6f 72 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 or; /* The
1aed0 56 44 42 45 20 63 75 72 73 6f 72 20 6e 75 6d 62 VDBE cursor numb
1aee0 65 72 20 75 73 65 64 20 74 6f 20 61 63 63 65 73 er used to acces
1aef0 73 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a s this table */.
1af00 20 20 20 20 45 78 70 72 20 2a 70 4f 6e 3b 20 20 Expr *pOn;
1af10 20 20 20 20 20 20 2f 2a 20 54 68 65 20 4f 4e 20 /* The ON
1af20 63 6c 61 75 73 65 20 6f 66 20 61 20 6a 6f 69 6e clause of a join
1af30 20 2a 2f 0a 20 20 20 20 49 64 4c 69 73 74 20 2a */. IdList *
1af40 70 55 73 69 6e 67 3b 20 20 20 2f 2a 20 54 68 65 pUsing; /* The
1af50 20 55 53 49 4e 47 20 63 6c 61 75 73 65 20 6f 66 USING clause of
1af60 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 42 a join */. B
1af70 69 74 6d 61 73 6b 20 63 6f 6c 55 73 65 64 3b 20 itmask colUsed;
1af80 20 2f 2a 20 42 69 74 20 4e 20 28 31 3c 3c 4e 29 /* Bit N (1<<N)
1af90 20 73 65 74 20 69 66 20 63 6f 6c 75 6d 6e 20 4e set if column N
1afa0 20 6f 66 20 70 54 61 62 20 69 73 20 75 73 65 64 of pTab is used
1afb0 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 20 7b 0a */. union {.
1afc0 20 20 20 20 20 20 63 68 61 72 20 2a 7a 49 6e 64 char *zInd
1afd0 65 78 65 64 42 79 3b 20 20 20 20 2f 2a 20 49 64 exedBy; /* Id
1afe0 65 6e 74 69 66 69 65 72 20 66 72 6f 6d 20 22 49 entifier from "I
1aff0 4e 44 45 58 45 44 20 42 59 20 3c 7a 49 6e 64 65 NDEXED BY <zInde
1b000 78 3e 22 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 x>" clause */.
1b010 20 20 20 20 45 78 70 72 4c 69 73 74 20 2a 70 46 ExprList *pF
1b020 75 6e 63 41 72 67 3b 20 20 2f 2a 20 41 72 67 75 uncArg; /* Argu
1b030 6d 65 6e 74 73 20 74 6f 20 74 61 62 6c 65 2d 76 ments to table-v
1b040 61 6c 75 65 64 2d 66 75 6e 63 74 69 6f 6e 20 2a alued-function *
1b050 2f 0a 20 20 20 20 7d 20 75 31 3b 0a 20 20 20 20 /. } u1;.
1b060 49 6e 64 65 78 20 2a 70 49 42 49 6e 64 65 78 3b Index *pIBIndex;
1b070 20 20 2f 2a 20 49 6e 64 65 78 20 73 74 72 75 63 /* Index struc
1b080 74 75 72 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 ture correspondi
1b090 6e 67 20 74 6f 20 75 31 2e 7a 49 6e 64 65 78 65 ng to u1.zIndexe
1b0a0 64 42 79 20 2a 2f 0a 20 20 7d 20 61 5b 31 5d 3b dBy */. } a[1];
1b0b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1b0c0 4f 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 One entry for ea
1b0d0 63 68 20 69 64 65 6e 74 69 66 69 65 72 20 6f 6e ch identifier on
1b0e0 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a the list */.};.
1b0f0 0a 2f 2a 0a 2a 2a 20 50 65 72 6d 69 74 74 65 64 ./*.** Permitted
1b100 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 53 values of the S
1b110 72 63 4c 69 73 74 2e 61 2e 6a 6f 69 6e 74 79 70 rcList.a.jointyp
1b120 65 20 66 69 65 6c 64 0a 2a 2f 0a 23 64 65 66 69 e field.*/.#defi
1b130 6e 65 20 4a 54 5f 49 4e 4e 45 52 20 20 20 20 20 ne JT_INNER
1b140 30 78 30 30 30 31 20 20 20 20 2f 2a 20 41 6e 79 0x0001 /* Any
1b150 20 6b 69 6e 64 20 6f 66 20 69 6e 6e 65 72 20 6f kind of inner o
1b160 72 20 63 72 6f 73 73 20 6a 6f 69 6e 20 2a 2f 0a r cross join */.
1b170 23 64 65 66 69 6e 65 20 4a 54 5f 43 52 4f 53 53 #define JT_CROSS
1b180 20 20 20 20 20 30 78 30 30 30 32 20 20 20 20 2f 0x0002 /
1b190 2a 20 45 78 70 6c 69 63 69 74 20 75 73 65 20 6f * Explicit use o
1b1a0 66 20 74 68 65 20 43 52 4f 53 53 20 6b 65 79 77 f the CROSS keyw
1b1b0 6f 72 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a ord */.#define J
1b1c0 54 5f 4e 41 54 55 52 41 4c 20 20 20 30 78 30 30 T_NATURAL 0x00
1b1d0 30 34 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 04 /* True fo
1b1e0 72 20 61 20 22 6e 61 74 75 72 61 6c 22 20 6a 6f r a "natural" jo
1b1f0 69 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 in */.#define JT
1b200 5f 4c 45 46 54 20 20 20 20 20 20 30 78 30 30 30 _LEFT 0x000
1b210 38 20 20 20 20 2f 2a 20 4c 65 66 74 20 6f 75 74 8 /* Left out
1b220 65 72 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 er join */.#defi
1b230 6e 65 20 4a 54 5f 52 49 47 48 54 20 20 20 20 20 ne JT_RIGHT
1b240 30 78 30 30 31 30 20 20 20 20 2f 2a 20 52 69 67 0x0010 /* Rig
1b250 68 74 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a 2f ht outer join */
1b260 0a 23 64 65 66 69 6e 65 20 4a 54 5f 4f 55 54 45 .#define JT_OUTE
1b270 52 20 20 20 20 20 30 78 30 30 32 30 20 20 20 20 R 0x0020
1b280 2f 2a 20 54 68 65 20 22 4f 55 54 45 52 22 20 6b /* The "OUTER" k
1b290 65 79 77 6f 72 64 20 69 73 20 70 72 65 73 65 6e eyword is presen
1b2a0 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f t */.#define JT_
1b2b0 45 52 52 4f 52 20 20 20 20 20 30 78 30 30 34 30 ERROR 0x0040
1b2c0 20 20 20 20 2f 2a 20 75 6e 6b 6e 6f 77 6e 20 6f /* unknown o
1b2d0 72 20 75 6e 73 75 70 70 6f 72 74 65 64 20 6a 6f r unsupported jo
1b2e0 69 6e 20 74 79 70 65 20 2a 2f 0a 0a 0a 2f 2a 0a in type */.../*.
1b2f0 2a 2a 20 46 6c 61 67 73 20 61 70 70 72 6f 70 72 ** Flags appropr
1b300 69 61 74 65 20 66 6f 72 20 74 68 65 20 77 63 74 iate for the wct
1b310 72 6c 46 6c 61 67 73 20 70 61 72 61 6d 65 74 65 rlFlags paramete
1b320 72 20 6f 66 20 73 71 6c 69 74 65 33 57 68 65 72 r of sqlite3Wher
1b330 65 42 65 67 69 6e 28 29 0a 2a 2a 20 61 6e 64 20 eBegin().** and
1b340 74 68 65 20 57 68 65 72 65 49 6e 66 6f 2e 77 63 the WhereInfo.wc
1b350 74 72 6c 46 6c 61 67 73 20 6d 65 6d 62 65 72 2e trlFlags member.
1b360 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e .**.** Value con
1b370 73 74 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 63 straints (enforc
1b380 65 64 20 76 69 61 20 61 73 73 65 72 74 28 29 29 ed via assert())
1b390 3a 0a 2a 2a 20 20 20 20 20 57 48 45 52 45 5f 55 :.** WHERE_U
1b3a0 53 45 5f 4c 49 4d 49 54 20 20 3d 3d 20 53 46 5f SE_LIMIT == SF_
1b3b0 46 69 78 65 64 4c 69 6d 69 74 0a 2a 2f 0a 23 64 FixedLimit.*/.#d
1b3c0 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 45 efine WHERE_ORDE
1b3d0 52 42 59 5f 4e 4f 52 4d 41 4c 20 20 20 30 78 30 RBY_NORMAL 0x0
1b3e0 30 30 30 20 2f 2a 20 4e 6f 2d 6f 70 20 2a 2f 0a 000 /* No-op */.
1b3f0 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 #define WHERE_OR
1b400 44 45 52 42 59 5f 4d 49 4e 20 20 20 20 20 20 30 DERBY_MIN 0
1b410 78 30 30 30 31 20 2f 2a 20 4f 52 44 45 52 20 42 x0001 /* ORDER B
1b420 59 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 Y processing for
1b430 20 6d 69 6e 28 29 20 66 75 6e 63 20 2a 2f 0a 23 min() func */.#
1b440 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 define WHERE_ORD
1b450 45 52 42 59 5f 4d 41 58 20 20 20 20 20 20 30 78 ERBY_MAX 0x
1b460 30 30 30 32 20 2f 2a 20 4f 52 44 45 52 20 42 59 0002 /* ORDER BY
1b470 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 processing for
1b480 6d 61 78 28 29 20 66 75 6e 63 20 2a 2f 0a 23 64 max() func */.#d
1b490 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e 45 50 efine WHERE_ONEP
1b4a0 41 53 53 5f 44 45 53 49 52 45 44 20 20 30 78 30 ASS_DESIRED 0x0
1b4b0 30 30 34 20 2f 2a 20 57 61 6e 74 20 74 6f 20 64 004 /* Want to d
1b4c0 6f 20 6f 6e 65 2d 70 61 73 73 20 55 50 44 41 54 o one-pass UPDAT
1b4d0 45 2f 44 45 4c 45 54 45 20 2a 2f 0a 23 64 65 66 E/DELETE */.#def
1b4e0 69 6e 65 20 57 48 45 52 45 5f 4f 4e 45 50 41 53 ine WHERE_ONEPAS
1b4f0 53 5f 4d 55 4c 54 49 52 4f 57 20 30 78 30 30 30 S_MULTIROW 0x000
1b500 38 20 2f 2a 20 4f 4e 45 50 41 53 53 20 69 73 20 8 /* ONEPASS is
1b510 6f 6b 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65 ok with multiple
1b520 20 72 6f 77 73 20 2a 2f 0a 23 64 65 66 69 6e 65 rows */.#define
1b530 20 57 48 45 52 45 5f 44 55 50 4c 49 43 41 54 45 WHERE_DUPLICATE
1b540 53 5f 4f 4b 20 20 20 20 30 78 30 30 31 30 20 2f S_OK 0x0010 /
1b550 2a 20 4f 6b 20 74 6f 20 72 65 74 75 72 6e 20 61 * Ok to return a
1b560 20 72 6f 77 20 6d 6f 72 65 20 74 68 61 6e 20 6f row more than o
1b570 6e 63 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 nce */.#define W
1b580 48 45 52 45 5f 4f 52 5f 53 55 42 43 4c 41 55 53 HERE_OR_SUBCLAUS
1b590 45 20 20 20 20 20 30 78 30 30 32 30 20 2f 2a 20 E 0x0020 /*
1b5a0 50 72 6f 63 65 73 73 69 6e 67 20 61 20 73 75 62 Processing a sub
1b5b0 2d 57 48 45 52 45 20 61 73 20 70 61 72 74 20 6f -WHERE as part o
1b5c0 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f.
1b5d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b5e0 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 4f ** the O
1b5f0 52 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 20 R optimization
1b600 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
1b610 5f 47 52 4f 55 50 42 59 20 20 20 20 20 20 20 20 _GROUPBY
1b620 20 20 30 78 30 30 34 30 20 2f 2a 20 70 4f 72 64 0x0040 /* pOrd
1b630 65 72 42 79 20 69 73 20 72 65 61 6c 6c 79 20 61 erBy is really a
1b640 20 47 52 4f 55 50 20 42 59 20 2a 2f 0a 23 64 65 GROUP BY */.#de
1b650 66 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 fine WHERE_DISTI
1b660 4e 43 54 42 59 20 20 20 20 20 20 20 30 78 30 30 NCTBY 0x00
1b670 38 30 20 2f 2a 20 70 4f 72 64 65 72 62 79 20 69 80 /* pOrderby i
1b680 73 20 72 65 61 6c 6c 79 20 61 20 44 49 53 54 49 s really a DISTI
1b690 4e 43 54 20 63 6c 61 75 73 65 20 2a 2f 0a 23 64 NCT clause */.#d
1b6a0 65 66 69 6e 65 20 57 48 45 52 45 5f 57 41 4e 54 efine WHERE_WANT
1b6b0 5f 44 49 53 54 49 4e 43 54 20 20 20 20 30 78 30 _DISTINCT 0x0
1b6c0 31 30 30 20 2f 2a 20 41 6c 6c 20 6f 75 74 70 75 100 /* All outpu
1b6d0 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 64 69 t needs to be di
1b6e0 73 74 69 6e 63 74 20 2a 2f 0a 23 64 65 66 69 6e stinct */.#defin
1b6f0 65 20 57 48 45 52 45 5f 53 4f 52 54 42 59 47 52 e WHERE_SORTBYGR
1b700 4f 55 50 20 20 20 20 20 20 30 78 30 32 30 30 20 OUP 0x0200
1b710 2f 2a 20 53 75 70 70 6f 72 74 20 73 71 6c 69 74 /* Support sqlit
1b720 65 33 57 68 65 72 65 49 73 53 6f 72 74 65 64 28 e3WhereIsSorted(
1b730 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 ) */.#define WHE
1b740 52 45 5f 53 45 45 4b 5f 54 41 42 4c 45 20 20 20 RE_SEEK_TABLE
1b750 20 20 20 20 30 78 30 34 30 30 20 2f 2a 20 44 6f 0x0400 /* Do
1b760 20 6e 6f 74 20 64 65 66 65 72 20 73 65 65 6b 73 not defer seeks
1b770 20 6f 6e 20 6d 61 69 6e 20 74 61 62 6c 65 20 2a on main table *
1b780 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1b790 4f 52 44 45 52 42 59 5f 4c 49 4d 49 54 20 20 20 ORDERBY_LIMIT
1b7a0 20 30 78 30 38 30 30 20 2f 2a 20 4f 52 44 45 52 0x0800 /* ORDER
1b7b0 42 59 2b 4c 49 4d 49 54 20 6f 6e 20 74 68 65 20 BY+LIMIT on the
1b7c0 69 6e 6e 65 72 20 6c 6f 6f 70 20 2a 2f 0a 23 64 inner loop */.#d
1b7d0 65 66 69 6e 65 20 57 48 45 52 45 5f 53 45 45 4b efine WHERE_SEEK
1b7e0 5f 55 4e 49 51 5f 54 41 42 4c 45 20 20 30 78 31 _UNIQ_TABLE 0x1
1b7f0 30 30 30 20 2f 2a 20 44 6f 20 6e 6f 74 20 64 65 000 /* Do not de
1b800 66 65 72 20 73 65 65 6b 73 20 69 66 20 75 6e 69 fer seeks if uni
1b810 71 75 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 que */.
1b820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1b830 2a 20 20 20 20 20 30 78 32 30 30 30 20 20 20 20 * 0x2000
1b840 6e 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 75 73 not currently us
1b850 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 ed */.#define WH
1b860 45 52 45 5f 55 53 45 5f 4c 49 4d 49 54 20 20 20 ERE_USE_LIMIT
1b870 20 20 20 20 20 30 78 34 30 30 30 20 2f 2a 20 55 0x4000 /* U
1b880 73 65 20 74 68 65 20 4c 49 4d 49 54 20 69 6e 20 se the LIMIT in
1b890 63 6f 73 74 20 65 73 74 69 6d 61 74 65 73 20 2a cost estimates *
1b8a0 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 /.
1b8b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 20 20 /*
1b8c0 20 30 78 38 30 30 30 20 20 20 20 6e 6f 74 20 63 0x8000 not c
1b8d0 75 72 72 65 6e 74 6c 79 20 75 73 65 64 20 2a 2f urrently used */
1b8e0 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 20 72 65 74 ../* Allowed ret
1b8f0 75 72 6e 20 76 61 6c 75 65 73 20 66 72 6f 6d 20 urn values from
1b900 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 44 69 sqlite3WhereIsDi
1b910 73 74 69 6e 63 74 28 29 0a 2a 2f 0a 23 64 65 66 stinct().*/.#def
1b920 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e ine WHERE_DISTIN
1b930 43 54 5f 4e 4f 4f 50 20 20 20 20 20 20 30 20 20 CT_NOOP 0
1b940 2f 2a 20 44 49 53 54 49 4e 43 54 20 6b 65 79 77 /* DISTINCT keyw
1b950 6f 72 64 20 6e 6f 74 20 75 73 65 64 20 2a 2f 0a ord not used */.
1b960 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 #define WHERE_DI
1b970 53 54 49 4e 43 54 5f 55 4e 49 51 55 45 20 20 20 STINCT_UNIQUE
1b980 20 31 20 20 2f 2a 20 4e 6f 20 64 75 70 6c 69 63 1 /* No duplic
1b990 61 74 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ates */.#define
1b9a0 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 4f WHERE_DISTINCT_O
1b9b0 52 44 45 52 45 44 20 20 20 32 20 20 2f 2a 20 41 RDERED 2 /* A
1b9c0 6c 6c 20 64 75 70 6c 69 63 61 74 65 73 20 61 72 ll duplicates ar
1b9d0 65 20 61 64 6a 61 63 65 6e 74 20 2a 2f 0a 23 64 e adjacent */.#d
1b9e0 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 efine WHERE_DIST
1b9f0 49 4e 43 54 5f 55 4e 4f 52 44 45 52 45 44 20 33 INCT_UNORDERED 3
1ba00 20 20 2f 2a 20 44 75 70 6c 69 63 61 74 65 73 20 /* Duplicates
1ba10 61 72 65 20 73 63 61 74 74 65 72 65 64 20 2a 2f are scattered */
1ba20 0a 0a 2f 2a 0a 2a 2a 20 41 20 4e 61 6d 65 43 6f ../*.** A NameCo
1ba30 6e 74 65 78 74 20 64 65 66 69 6e 65 73 20 61 20 ntext defines a
1ba40 63 6f 6e 74 65 78 74 20 69 6e 20 77 68 69 63 68 context in which
1ba50 20 74 6f 20 72 65 73 6f 6c 76 65 20 74 61 62 6c to resolve tabl
1ba60 65 20 61 6e 64 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 e and column.**
1ba70 6e 61 6d 65 73 2e 20 20 54 68 65 20 63 6f 6e 74 names. The cont
1ba80 65 78 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 ext consists of
1ba90 61 20 6c 69 73 74 20 6f 66 20 74 61 62 6c 65 73 a list of tables
1baa0 20 28 74 68 65 20 70 53 72 63 4c 69 73 74 29 20 (the pSrcList)
1bab0 66 69 65 6c 64 20 61 6e 64 0a 2a 2a 20 61 20 6c field and.** a l
1bac0 69 73 74 20 6f 66 20 6e 61 6d 65 64 20 65 78 70 ist of named exp
1bad0 72 65 73 73 69 6f 6e 20 28 70 45 4c 69 73 74 29 ression (pEList)
1bae0 2e 20 20 54 68 65 20 6e 61 6d 65 64 20 65 78 70 . The named exp
1baf0 72 65 73 73 69 6f 6e 20 6c 69 73 74 20 6d 61 79 ression list may
1bb00 0a 2a 2a 20 62 65 20 4e 55 4c 4c 2e 20 20 54 68 .** be NULL. Th
1bb10 65 20 70 53 72 63 20 63 6f 72 72 65 73 70 6f 6e e pSrc correspon
1bb20 64 73 20 74 6f 20 74 68 65 20 46 52 4f 4d 20 63 ds to the FROM c
1bb30 6c 61 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43 lause of a SELEC
1bb40 54 20 6f 72 0a 2a 2a 20 74 6f 20 74 68 65 20 74 T or.** to the t
1bb50 61 62 6c 65 20 62 65 69 6e 67 20 6f 70 65 72 61 able being opera
1bb60 74 65 64 20 6f 6e 20 62 79 20 49 4e 53 45 52 54 ted on by INSERT
1bb70 2c 20 55 50 44 41 54 45 2c 20 6f 72 20 44 45 4c , UPDATE, or DEL
1bb80 45 54 45 2e 20 20 54 68 65 0a 2a 2a 20 70 45 4c ETE. The.** pEL
1bb90 69 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 ist corresponds
1bba0 74 6f 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 to the result se
1bbb0 74 20 6f 66 20 61 20 53 45 4c 45 43 54 20 61 6e t of a SELECT an
1bbc0 64 20 69 73 20 4e 55 4c 4c 20 66 6f 72 0a 2a 2a d is NULL for.**
1bbd0 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 other statement
1bbe0 73 2e 0a 2a 2a 0a 2a 2a 20 4e 61 6d 65 43 6f 6e s..**.** NameCon
1bbf0 74 65 78 74 73 20 63 61 6e 20 62 65 20 6e 65 73 texts can be nes
1bc00 74 65 64 2e 20 20 57 68 65 6e 20 72 65 73 6f 6c ted. When resol
1bc10 76 69 6e 67 20 6e 61 6d 65 73 2c 20 74 68 65 20 ving names, the
1bc20 69 6e 6e 65 72 2d 6d 6f 73 74 0a 2a 2a 20 63 6f inner-most.** co
1bc30 6e 74 65 78 74 20 69 73 20 73 65 61 72 63 68 65 ntext is searche
1bc40 64 20 66 69 72 73 74 2e 20 20 49 66 20 6e 6f 20 d first. If no
1bc50 6d 61 74 63 68 20 69 73 20 66 6f 75 6e 64 2c 20 match is found,
1bc60 74 68 65 20 6e 65 78 74 20 6f 75 74 65 72 0a 2a the next outer.*
1bc70 2a 20 63 6f 6e 74 65 78 74 20 69 73 20 63 68 65 * context is che
1bc80 63 6b 65 64 2e 20 20 49 66 20 74 68 65 72 65 20 cked. If there
1bc90 69 73 20 73 74 69 6c 6c 20 6e 6f 20 6d 61 74 63 is still no matc
1bca0 68 2c 20 74 68 65 20 6e 65 78 74 20 63 6f 6e 74 h, the next cont
1bcb0 65 78 74 0a 2a 2a 20 69 73 20 63 68 65 63 6b 65 ext.** is checke
1bcc0 64 2e 20 20 54 68 69 73 20 70 72 6f 63 65 73 73 d. This process
1bcd0 20 63 6f 6e 74 69 6e 75 65 73 20 75 6e 74 69 6c continues until
1bce0 20 65 69 74 68 65 72 20 61 20 6d 61 74 63 68 20 either a match
1bcf0 69 73 20 66 6f 75 6e 64 0a 2a 2a 20 6f 72 20 61 is found.** or a
1bd00 6c 6c 20 63 6f 6e 74 65 78 74 73 20 61 72 65 20 ll contexts are
1bd10 63 68 65 63 6b 2e 20 20 57 68 65 6e 20 61 20 6d check. When a m
1bd20 61 74 63 68 20 69 73 20 66 6f 75 6e 64 2c 20 74 atch is found, t
1bd30 68 65 20 6e 52 65 66 20 6d 65 6d 62 65 72 20 6f he nRef member o
1bd40 66 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 65 78 74 f.** the context
1bd50 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 containing the
1bd60 6d 61 74 63 68 20 69 73 20 69 6e 63 72 65 6d 65 match is increme
1bd70 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 nted..**.** Each
1bd80 20 73 75 62 71 75 65 72 79 20 67 65 74 73 20 61 subquery gets a
1bd90 20 6e 65 77 20 4e 61 6d 65 43 6f 6e 74 65 78 74 new NameContext
1bda0 2e 20 20 54 68 65 20 70 4e 65 78 74 20 66 69 65 . The pNext fie
1bdb0 6c 64 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 ld points to the
1bdc0 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 .** NameContext
1bdd0 69 6e 20 74 68 65 20 70 61 72 65 6e 74 20 71 75 in the parent qu
1bde0 65 72 79 2e 20 20 54 68 75 73 20 74 68 65 20 70 ery. Thus the p
1bdf0 72 6f 63 65 73 73 20 6f 66 20 73 63 61 6e 6e 69 rocess of scanni
1be00 6e 67 20 74 68 65 0a 2a 2a 20 4e 61 6d 65 43 6f ng the.** NameCo
1be10 6e 74 65 78 74 20 6c 69 73 74 20 63 6f 72 72 65 ntext list corre
1be20 73 70 6f 6e 64 73 20 74 6f 20 73 65 61 72 63 68 sponds to search
1be30 69 6e 67 20 74 68 72 6f 75 67 68 20 73 75 63 63 ing through succ
1be40 65 73 73 69 76 65 6c 79 20 6f 75 74 65 72 0a 2a essively outer.*
1be50 2a 20 73 75 62 71 75 65 72 69 65 73 20 6c 6f 6f * subqueries loo
1be60 6b 69 6e 67 20 66 6f 72 20 61 20 6d 61 74 63 68 king for a match
1be70 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4e 61 6d 65 ..*/.struct Name
1be80 43 6f 6e 74 65 78 74 20 7b 0a 20 20 50 61 72 73 Context {. Pars
1be90 65 20 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 e *pParse;
1bea0 20 2f 2a 20 54 68 65 20 70 61 72 73 65 72 20 2a /* The parser *
1beb0 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 53 72 /. SrcList *pSr
1bec0 63 4c 69 73 74 3b 20 20 20 2f 2a 20 4f 6e 65 20 cList; /* One
1bed0 6f 72 20 6d 6f 72 65 20 74 61 62 6c 65 73 20 75 or more tables u
1bee0 73 65 64 20 74 6f 20 72 65 73 6f 6c 76 65 20 6e sed to resolve n
1bef0 61 6d 65 73 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 ames */. union
1bf00 7b 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 2a {. ExprList *
1bf10 70 45 4c 69 73 74 3b 20 20 20 20 2f 2a 20 4f 70 pEList; /* Op
1bf20 74 69 6f 6e 61 6c 20 6c 69 73 74 20 6f 66 20 72 tional list of r
1bf30 65 73 75 6c 74 2d 73 65 74 20 63 6f 6c 75 6d 6e esult-set column
1bf40 73 20 2a 2f 0a 20 20 20 20 41 67 67 49 6e 66 6f s */. AggInfo
1bf50 20 2a 70 41 67 67 49 6e 66 6f 3b 20 20 20 2f 2a *pAggInfo; /*
1bf60 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f Information abo
1bf70 75 74 20 61 67 67 72 65 67 61 74 65 73 20 61 74 ut aggregates at
1bf80 20 74 68 69 73 20 6c 65 76 65 6c 20 2a 2f 0a 20 this level */.
1bf90 20 20 20 55 70 73 65 72 74 20 2a 70 55 70 73 65 Upsert *pUpse
1bfa0 72 74 3b 20 20 20 20 20 2f 2a 20 4f 4e 20 43 4f rt; /* ON CO
1bfb0 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 20 69 6e NFLICT clause in
1bfc0 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 61 formation from a
1bfd0 6e 20 75 70 73 65 72 74 20 2a 2f 0a 20 20 7d 20 n upsert */. }
1bfe0 75 4e 43 3b 0a 20 20 4e 61 6d 65 43 6f 6e 74 65 uNC;. NameConte
1bff0 78 74 20 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e xt *pNext; /* N
1c000 65 78 74 20 6f 75 74 65 72 20 6e 61 6d 65 20 63 ext outer name c
1c010 6f 6e 74 65 78 74 2e 20 20 4e 55 4c 4c 20 66 6f ontext. NULL fo
1c020 72 20 6f 75 74 65 72 6d 6f 73 74 20 2a 2f 0a 20 r outermost */.
1c030 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 int nRef;
1c040 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
1c050 6f 66 20 6e 61 6d 65 73 20 72 65 73 6f 6c 76 65 of names resolve
1c060 64 20 62 79 20 74 68 69 73 20 63 6f 6e 74 65 78 d by this contex
1c070 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 72 72 3b t */. int nErr;
1c080 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1c090 75 6d 62 65 72 20 6f 66 20 65 72 72 6f 72 73 20 umber of errors
1c0a0 65 6e 63 6f 75 6e 74 65 72 65 64 20 77 68 69 6c encountered whil
1c0b0 65 20 72 65 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 e resolving name
1c0c0 73 20 2a 2f 0a 20 20 75 31 36 20 6e 63 46 6c 61 s */. u16 ncFla
1c0d0 67 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 5a gs; /* Z
1c0e0 65 72 6f 20 6f 72 20 6d 6f 72 65 20 4e 43 5f 2a ero or more NC_*
1c0f0 20 66 6c 61 67 73 20 64 65 66 69 6e 65 64 20 62 flags defined b
1c100 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a elow */.};../*.*
1c110 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 * Allowed values
1c120 20 66 6f 72 20 74 68 65 20 4e 61 6d 65 43 6f 6e for the NameCon
1c130 74 65 78 74 2c 20 6e 63 46 6c 61 67 73 20 66 69 text, ncFlags fi
1c140 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 eld..**.** Value
1c150 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 61 6c constraints (al
1c160 6c 20 63 68 65 63 6b 65 64 20 76 69 61 20 61 73 l checked via as
1c170 73 65 72 74 28 29 29 3a 0a 2a 2a 20 20 20 20 4e sert()):.** N
1c180 43 5f 48 61 73 41 67 67 20 20 20 20 3d 3d 20 53 C_HasAgg == S
1c190 46 5f 48 61 73 41 67 67 0a 2a 2a 20 20 20 20 4e F_HasAgg.** N
1c1a0 43 5f 4d 69 6e 4d 61 78 41 67 67 20 3d 3d 20 53 C_MinMaxAgg == S
1c1b0 46 5f 4d 69 6e 4d 61 78 41 67 67 20 3d 3d 20 53 F_MinMaxAgg == S
1c1c0 51 4c 49 54 45 5f 46 55 4e 43 5f 4d 49 4e 4d 41 QLITE_FUNC_MINMA
1c1d0 58 0a 2a 2a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 X.**.*/.#define
1c1e0 4e 43 5f 41 6c 6c 6f 77 41 67 67 20 20 30 78 30 NC_AllowAgg 0x0
1c1f0 30 30 31 20 20 2f 2a 20 41 67 67 72 65 67 61 74 001 /* Aggregat
1c200 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 e functions are
1c210 61 6c 6c 6f 77 65 64 20 68 65 72 65 20 2a 2f 0a allowed here */.
1c220 23 64 65 66 69 6e 65 20 4e 43 5f 50 61 72 74 49 #define NC_PartI
1c230 64 78 20 20 20 30 78 30 30 30 32 20 20 2f 2a 20 dx 0x0002 /*
1c240 54 72 75 65 20 69 66 20 72 65 73 6f 6c 76 69 6e True if resolvin
1c250 67 20 61 20 70 61 72 74 69 61 6c 20 69 6e 64 65 g a partial inde
1c260 78 20 57 48 45 52 45 20 2a 2f 0a 23 64 65 66 69 x WHERE */.#defi
1c270 6e 65 20 4e 43 5f 49 73 43 68 65 63 6b 20 20 20 ne NC_IsCheck
1c280 30 78 30 30 30 34 20 20 2f 2a 20 54 72 75 65 20 0x0004 /* True
1c290 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 6e 61 6d if resolving nam
1c2a0 65 73 20 69 6e 20 61 20 43 48 45 43 4b 20 63 6f es in a CHECK co
1c2b0 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 64 65 66 nstraint */.#def
1c2c0 69 6e 65 20 4e 43 5f 49 6e 41 67 67 46 75 6e 63 ine NC_InAggFunc
1c2d0 20 30 78 30 30 30 38 20 20 2f 2a 20 54 72 75 65 0x0008 /* True
1c2e0 20 69 66 20 61 6e 61 6c 79 7a 69 6e 67 20 61 72 if analyzing ar
1c2f0 67 75 6d 65 6e 74 73 20 74 6f 20 61 6e 20 61 67 guments to an ag
1c300 67 20 66 75 6e 63 20 2a 2f 0a 23 64 65 66 69 6e g func */.#defin
1c310 65 20 4e 43 5f 48 61 73 41 67 67 20 20 20 20 30 e NC_HasAgg 0
1c320 78 30 30 31 30 20 20 2f 2a 20 4f 6e 65 20 6f 72 x0010 /* One or
1c330 20 6d 6f 72 65 20 61 67 67 72 65 67 61 74 65 20 more aggregate
1c340 66 75 6e 63 74 69 6f 6e 73 20 73 65 65 6e 20 2a functions seen *
1c350 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 49 64 78 /.#define NC_Idx
1c360 45 78 70 72 20 20 20 30 78 30 30 32 30 20 20 2f Expr 0x0020 /
1c370 2a 20 54 72 75 65 20 69 66 20 72 65 73 6f 6c 76 * True if resolv
1c380 69 6e 67 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 43 ing columns of C
1c390 52 45 41 54 45 20 49 4e 44 45 58 20 2a 2f 0a 23 REATE INDEX */.#
1c3a0 64 65 66 69 6e 65 20 4e 43 5f 56 61 72 53 65 6c define NC_VarSel
1c3b0 65 63 74 20 30 78 30 30 34 30 20 20 2f 2a 20 41 ect 0x0040 /* A
1c3c0 20 63 6f 72 72 65 6c 61 74 65 64 20 73 75 62 71 correlated subq
1c3d0 75 65 72 79 20 68 61 73 20 62 65 65 6e 20 73 65 uery has been se
1c3e0 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 en */.#define NC
1c3f0 5f 55 45 4c 69 73 74 20 20 20 20 30 78 30 30 38 _UEList 0x008
1c400 30 20 20 2f 2a 20 54 72 75 65 20 69 66 20 75 4e 0 /* True if uN
1c410 43 2e 70 45 4c 69 73 74 20 69 73 20 75 73 65 64 C.pEList is used
1c420 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 55 */.#define NC_U
1c430 41 67 67 49 6e 66 6f 20 20 30 78 30 31 30 30 20 AggInfo 0x0100
1c440 20 2f 2a 20 54 72 75 65 20 69 66 20 75 4e 43 2e /* True if uNC.
1c450 70 41 67 67 49 6e 66 6f 20 69 73 20 75 73 65 64 pAggInfo is used
1c460 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 55 */.#define NC_U
1c470 55 70 73 65 72 74 20 20 20 30 78 30 32 30 30 20 Upsert 0x0200
1c480 20 2f 2a 20 54 72 75 65 20 69 66 20 75 4e 43 2e /* True if uNC.
1c490 70 55 70 73 65 72 74 20 69 73 20 75 73 65 64 20 pUpsert is used
1c4a0 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 4d 69 */.#define NC_Mi
1c4b0 6e 4d 61 78 41 67 67 20 30 78 31 30 30 30 20 20 nMaxAgg 0x1000
1c4c0 2f 2a 20 6d 69 6e 2f 6d 61 78 20 61 67 67 72 65 /* min/max aggre
1c4d0 67 61 74 65 73 20 73 65 65 6e 2e 20 20 53 65 65 gates seen. See
1c4e0 20 6e 6f 74 65 20 61 62 6f 76 65 20 2a 2f 0a 23 note above */.#
1c4f0 64 65 66 69 6e 65 20 4e 43 5f 43 6f 6d 70 6c 65 define NC_Comple
1c500 78 20 20 20 30 78 32 30 30 30 20 20 2f 2a 20 54 x 0x2000 /* T
1c510 72 75 65 20 69 66 20 61 20 66 75 6e 63 74 69 6f rue if a functio
1c520 6e 20 6f 72 20 73 75 62 71 75 65 72 79 20 73 65 n or subquery se
1c530 65 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 en */../*.** An
1c540 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
1c550 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a 65 63 74 following object
1c560 20 64 65 73 63 72 69 62 65 73 20 61 20 73 69 6e describes a sin
1c570 67 6c 65 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 0a gle ON CONFLICT.
1c580 2a 2a 20 63 6c 61 75 73 65 20 69 6e 20 61 6e 20 ** clause in an
1c590 75 70 73 65 72 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 upsert..**.** Th
1c5a0 65 20 70 55 70 73 65 72 74 54 61 72 67 65 74 20 e pUpsertTarget
1c5b0 66 69 65 6c 64 20 69 73 20 6f 6e 6c 79 20 73 65 field is only se
1c5c0 74 20 69 66 20 74 68 65 20 4f 4e 20 43 4f 4e 46 t if the ON CONF
1c5d0 4c 49 43 54 20 63 6c 61 75 73 65 20 69 6e 63 6c LICT clause incl
1c5e0 75 64 65 73 0a 2a 2a 20 63 6f 6e 66 6c 69 63 74 udes.** conflict
1c5f0 2d 74 61 72 67 65 74 20 63 6c 61 75 73 65 2e 20 -target clause.
1c600 20 28 49 6e 20 22 4f 4e 20 43 4f 4e 46 4c 49 43 (In "ON CONFLIC
1c610 54 28 61 2c 62 29 22 20 74 68 65 20 22 28 61 2c T(a,b)" the "(a,
1c620 62 29 22 20 69 73 20 74 68 65 0a 2a 2a 20 63 6f b)" is the.** co
1c630 6e 66 6c 69 63 74 2d 74 61 72 67 65 74 20 63 6c nflict-target cl
1c640 61 75 73 65 2e 29 20 20 54 68 65 20 70 55 70 73 ause.) The pUps
1c650 65 72 74 54 61 72 67 65 74 57 68 65 72 65 20 69 ertTargetWhere i
1c660 73 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c 0a 2a s the optional.*
1c670 2a 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 75 * WHERE clause u
1c680 73 65 64 20 74 6f 20 69 64 65 6e 74 69 66 79 20 sed to identify
1c690 70 61 72 74 69 61 6c 20 75 6e 69 71 75 65 20 69 partial unique i
1c6a0 6e 64 65 78 65 73 2e 0a 2a 2a 0a 2a 2a 20 70 55 ndexes..**.** pU
1c6b0 70 73 65 72 74 53 65 74 20 69 73 20 74 68 65 20 psertSet is the
1c6c0 6c 69 73 74 20 6f 66 20 63 6f 6c 75 6d 6e 3d 65 list of column=e
1c6d0 78 70 72 20 74 65 72 6d 73 20 6f 66 20 74 68 65 xpr terms of the
1c6e0 20 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e UPDATE statemen
1c6f0 74 2e 20 0a 2a 2a 20 54 68 65 20 70 55 70 73 65 t. .** The pUpse
1c700 72 74 53 65 74 20 66 69 65 6c 64 20 69 73 20 4e rtSet field is N
1c710 55 4c 4c 20 66 6f 72 20 61 20 4f 4e 20 43 4f 4e ULL for a ON CON
1c720 46 4c 49 43 54 20 44 4f 20 4e 4f 54 48 49 4e 47 FLICT DO NOTHING
1c730 2e 20 20 54 68 65 0a 2a 2a 20 70 55 70 73 65 72 . The.** pUpser
1c740 74 57 68 65 72 65 20 69 73 20 74 68 65 20 57 48 tWhere is the WH
1c750 45 52 45 20 63 6c 61 75 73 65 20 66 6f 72 20 74 ERE clause for t
1c760 68 65 20 55 50 44 41 54 45 20 61 6e 64 20 69 73 he UPDATE and is
1c770 20 4e 55 4c 4c 20 69 66 20 74 68 65 0a 2a 2a 20 NULL if the.**
1c780 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 WHERE clause is
1c790 6f 6d 69 74 74 65 64 2e 0a 2a 2f 0a 73 74 72 75 omitted..*/.stru
1c7a0 63 74 20 55 70 73 65 72 74 20 7b 0a 20 20 45 78 ct Upsert {. Ex
1c7b0 70 72 4c 69 73 74 20 2a 70 55 70 73 65 72 74 54 prList *pUpsertT
1c7c0 61 72 67 65 74 3b 20 20 2f 2a 20 4f 70 74 69 6f arget; /* Optio
1c7d0 6e 61 6c 20 64 65 73 63 72 69 70 74 69 6f 6e 20 nal description
1c7e0 6f 66 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 69 of conflicting i
1c7f0 6e 64 65 78 20 2a 2f 0a 20 20 45 78 70 72 20 2a ndex */. Expr *
1c800 70 55 70 73 65 72 74 54 61 72 67 65 74 57 68 65 pUpsertTargetWhe
1c810 72 65 3b 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 re; /* WHERE cla
1c820 75 73 65 20 66 6f 72 20 70 61 72 74 69 61 6c 20 use for partial
1c830 69 6e 64 65 78 20 74 61 72 67 65 74 73 20 2a 2f index targets */
1c840 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 55 70 . ExprList *pUp
1c850 73 65 72 74 53 65 74 3b 20 20 20 20 20 2f 2a 20 sertSet; /*
1c860 54 68 65 20 53 45 54 20 63 6c 61 75 73 65 20 66 The SET clause f
1c870 72 6f 6d 20 61 6e 20 4f 4e 20 43 4f 4e 46 4c 49 rom an ON CONFLI
1c880 43 54 20 55 50 44 41 54 45 20 2a 2f 0a 20 20 45 CT UPDATE */. E
1c890 78 70 72 20 2a 70 55 70 73 65 72 74 57 68 65 72 xpr *pUpsertWher
1c8a0 65 3b 20 20 20 20 20 20 20 2f 2a 20 57 48 45 52 e; /* WHER
1c8b0 45 20 63 6c 61 75 73 65 20 66 6f 72 20 74 68 65 E clause for the
1c8c0 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 55 50 44 ON CONFLICT UPD
1c8d0 41 54 45 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 ATE */. /* The
1c8e0 66 69 65 6c 64 73 20 61 62 6f 76 65 20 63 6f 6d fields above com
1c8f0 70 72 69 73 65 20 74 68 65 20 70 61 72 73 65 20 prise the parse
1c900 74 72 65 65 20 66 6f 72 20 74 68 65 20 75 70 73 tree for the ups
1c910 65 72 74 20 63 6c 61 75 73 65 2e 0a 20 20 2a 2a ert clause.. **
1c920 20 54 68 65 20 66 69 65 6c 64 73 20 62 65 6c 6f The fields belo
1c930 77 20 61 72 65 20 75 73 65 64 20 74 6f 20 74 72 w are used to tr
1c940 61 6e 73 66 65 72 20 69 6e 66 6f 72 6d 61 74 69 ansfer informati
1c950 6f 6e 20 66 72 6f 6d 20 74 68 65 20 49 4e 53 45 on from the INSE
1c960 52 54 0a 20 20 2a 2a 20 70 72 6f 63 65 73 73 69 RT. ** processi
1c970 6e 67 20 64 6f 77 6e 20 69 6e 74 6f 20 74 68 65 ng down into the
1c980 20 55 50 44 41 54 45 20 70 72 6f 63 65 73 73 69 UPDATE processi
1c990 6e 67 20 77 68 69 6c 65 20 67 65 6e 65 72 61 74 ng while generat
1c9a0 69 6e 67 20 63 6f 64 65 2e 0a 20 20 2a 2a 20 55 ing code.. ** U
1c9b0 70 73 65 72 74 20 6f 77 6e 73 20 74 68 65 20 6d psert owns the m
1c9c0 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 65 64 20 emory allocated
1c9d0 61 62 6f 76 65 2c 20 62 75 74 20 6e 6f 74 20 74 above, but not t
1c9e0 68 65 20 6d 65 6d 6f 72 79 20 62 65 6c 6f 77 2e he memory below.
1c9f0 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 55 70 */. Index *pUp
1ca00 73 65 72 74 49 64 78 3b 20 20 20 20 20 20 20 20 sertIdx;
1ca10 2f 2a 20 43 6f 6e 73 74 72 61 69 6e 74 20 74 68 /* Constraint th
1ca20 61 74 20 70 55 70 73 65 72 74 54 61 72 67 65 74 at pUpsertTarget
1ca30 20 69 64 65 6e 74 69 66 69 65 73 20 2a 2f 0a 20 identifies */.
1ca40 20 53 72 63 4c 69 73 74 20 2a 70 55 70 73 65 72 SrcList *pUpser
1ca50 74 53 72 63 3b 20 20 20 20 20 20 2f 2a 20 54 61 tSrc; /* Ta
1ca60 62 6c 65 20 74 6f 20 62 65 20 75 70 64 61 74 65 ble to be update
1ca70 64 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 44 61 d */. int regDa
1ca80 74 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ta;
1ca90 20 2f 2a 20 46 69 72 73 74 20 72 65 67 69 73 74 /* First regist
1caa0 65 72 20 68 6f 6c 64 69 6e 67 20 61 72 72 61 79 er holding array
1cab0 20 6f 66 20 56 41 4c 55 45 53 20 2a 2f 0a 20 20 of VALUES */.
1cac0 69 6e 74 20 69 44 61 74 61 43 75 72 3b 20 20 20 int iDataCur;
1cad0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
1cae0 65 78 20 6f 66 20 74 68 65 20 64 61 74 61 20 63 ex of the data c
1caf0 75 72 73 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 69 ursor */. int i
1cb00 49 64 78 43 75 72 3b 20 20 20 20 20 20 20 20 20 IdxCur;
1cb10 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
1cb20 20 74 68 65 20 66 69 72 73 74 20 69 6e 64 65 78 the first index
1cb30 20 63 75 72 73 6f 72 20 2a 2f 0a 7d 3b 0a 0a 2f cursor */.};../
1cb40 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
1cb50 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
1cb60 67 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 g structure cont
1cb70 61 69 6e 73 20 61 6c 6c 20 69 6e 66 6f 72 6d 61 ains all informa
1cb80 74 69 6f 6e 0a 2a 2a 20 6e 65 65 64 65 64 20 74 tion.** needed t
1cb90 6f 20 67 65 6e 65 72 61 74 65 20 63 6f 64 65 20 o generate code
1cba0 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 53 45 4c for a single SEL
1cbb0 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a ECT statement..*
1cbc0 2a 0a 2a 2a 20 6e 4c 69 6d 69 74 20 69 73 20 73 *.** nLimit is s
1cbd0 65 74 20 74 6f 20 2d 31 20 69 66 20 74 68 65 72 et to -1 if ther
1cbe0 65 20 69 73 20 6e 6f 20 4c 49 4d 49 54 20 63 6c e is no LIMIT cl
1cbf0 61 75 73 65 2e 20 20 6e 4f 66 66 73 65 74 20 69 ause. nOffset i
1cc00 73 20 73 65 74 20 74 6f 20 30 2e 0a 2a 2a 20 49 s set to 0..** I
1cc10 66 20 74 68 65 72 65 20 69 73 20 61 20 4c 49 4d f there is a LIM
1cc20 49 54 20 63 6c 61 75 73 65 2c 20 74 68 65 20 70 IT clause, the p
1cc30 61 72 73 65 72 20 73 65 74 73 20 6e 4c 69 6d 69 arser sets nLimi
1cc40 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 20 6f t to the value o
1cc50 66 20 74 68 65 0a 2a 2a 20 6c 69 6d 69 74 20 61 f the.** limit a
1cc60 6e 64 20 6e 4f 66 66 73 65 74 20 74 6f 20 74 68 nd nOffset to th
1cc70 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f e value of the o
1cc80 66 66 73 65 74 20 28 6f 72 20 30 20 69 66 20 74 ffset (or 0 if t
1cc90 68 65 72 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 6f here is not.** o
1cca0 66 66 73 65 74 29 2e 20 20 42 75 74 20 6c 61 74 ffset). But lat
1ccb0 65 72 20 6f 6e 2c 20 6e 4c 69 6d 69 74 20 61 6e er on, nLimit an
1ccc0 64 20 6e 4f 66 66 73 65 74 20 62 65 63 6f 6d 65 d nOffset become
1ccd0 20 74 68 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 the memory loca
1cce0 74 69 6f 6e 73 0a 2a 2a 20 69 6e 20 74 68 65 20 tions.** in the
1ccf0 56 44 42 45 20 74 68 61 74 20 72 65 63 6f 72 64 VDBE that record
1cd00 20 74 68 65 20 6c 69 6d 69 74 20 61 6e 64 20 6f the limit and o
1cd10 66 66 73 65 74 20 63 6f 75 6e 74 65 72 73 2e 0a ffset counters..
1cd20 2a 2a 0a 2a 2a 20 61 64 64 72 4f 70 65 6e 45 70 **.** addrOpenEp
1cd30 68 6d 5b 5d 20 65 6e 74 72 69 65 73 20 63 6f 6e hm[] entries con
1cd40 74 61 69 6e 20 74 68 65 20 61 64 64 72 65 73 73 tain the address
1cd50 20 6f 66 20 4f 50 5f 4f 70 65 6e 45 70 68 65 6d of OP_OpenEphem
1cd60 65 72 61 6c 20 6f 70 63 6f 64 65 73 2e 0a 2a 2a eral opcodes..**
1cd70 20 54 68 65 73 65 20 61 64 64 72 65 73 73 65 73 These addresses
1cd80 20 6d 75 73 74 20 62 65 20 73 74 6f 72 65 64 20 must be stored
1cd90 73 6f 20 74 68 61 74 20 77 65 20 63 61 6e 20 67 so that we can g
1cda0 6f 20 62 61 63 6b 20 61 6e 64 20 66 69 6c 6c 20 o back and fill
1cdb0 69 6e 0a 2a 2a 20 74 68 65 20 50 34 5f 4b 45 59 in.** the P4_KEY
1cdc0 49 4e 46 4f 20 61 6e 64 20 50 32 20 70 61 72 61 INFO and P2 para
1cdd0 6d 65 74 65 72 73 20 6c 61 74 65 72 2e 20 20 4e meters later. N
1cde0 65 69 74 68 65 72 20 74 68 65 20 4b 65 79 49 6e either the KeyIn
1cdf0 66 6f 20 6e 6f 72 0a 2a 2a 20 74 68 65 20 6e 75 fo nor.** the nu
1ce00 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
1ce10 69 6e 20 50 32 20 63 61 6e 20 62 65 20 63 6f 6d in P2 can be com
1ce20 70 75 74 65 64 20 61 74 20 74 68 65 20 73 61 6d puted at the sam
1ce30 65 20 74 69 6d 65 0a 2a 2a 20 61 73 20 74 68 65 e time.** as the
1ce40 20 4f 50 5f 4f 70 65 6e 45 70 68 6d 20 69 6e 73 OP_OpenEphm ins
1ce50 74 72 75 63 74 69 6f 6e 20 69 73 20 63 6f 64 65 truction is code
1ce60 64 20 62 65 63 61 75 73 65 20 6e 6f 74 0a 2a 2a d because not.**
1ce70 20 65 6e 6f 75 67 68 20 69 6e 66 6f 72 6d 61 74 enough informat
1ce80 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 63 6f ion about the co
1ce90 6d 70 6f 75 6e 64 20 71 75 65 72 79 20 69 73 20 mpound query is
1cea0 6b 6e 6f 77 6e 20 61 74 20 74 68 61 74 20 70 6f known at that po
1ceb0 69 6e 74 2e 0a 2a 2a 20 54 68 65 20 4b 65 79 49 int..** The KeyI
1cec0 6e 66 6f 20 66 6f 72 20 61 64 64 72 4f 70 65 6e nfo for addrOpen
1ced0 54 72 61 6e 5b 30 5d 20 61 6e 64 20 5b 31 5d 20 Tran[0] and [1]
1cee0 63 6f 6e 74 61 69 6e 73 20 63 6f 6c 6c 61 74 69 contains collati
1cef0 6e 67 20 73 65 71 75 65 6e 63 65 73 0a 2a 2a 20 ng sequences.**
1cf00 66 6f 72 20 74 68 65 20 72 65 73 75 6c 74 20 73 for the result s
1cf10 65 74 2e 20 20 54 68 65 20 4b 65 79 49 6e 66 6f et. The KeyInfo
1cf20 20 66 6f 72 20 61 64 64 72 4f 70 65 6e 45 70 68 for addrOpenEph
1cf30 6d 5b 32 5d 20 63 6f 6e 74 61 69 6e 73 20 63 6f m[2] contains co
1cf40 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73 65 71 75 65 llating.** seque
1cf50 6e 63 65 73 20 66 6f 72 20 74 68 65 20 4f 52 44 nces for the ORD
1cf60 45 52 20 42 59 20 63 6c 61 75 73 65 2e 0a 2a 2f ER BY clause..*/
1cf70 0a 73 74 72 75 63 74 20 53 65 6c 65 63 74 20 7b .struct Select {
1cf80 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 45 4c . ExprList *pEL
1cf90 69 73 74 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 ist; /* The
1cfa0 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 20 72 fields of the r
1cfb0 65 73 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6f 70 esult */. u8 op
1cfc0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1cfd0 20 20 2f 2a 20 4f 6e 65 20 6f 66 3a 20 54 4b 5f /* One of: TK_
1cfe0 55 4e 49 4f 4e 20 54 4b 5f 41 4c 4c 20 54 4b 5f UNION TK_ALL TK_
1cff0 49 4e 54 45 52 53 45 43 54 20 54 4b 5f 45 58 43 INTERSECT TK_EXC
1d000 45 50 54 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 EPT */. LogEst
1d010 6e 53 65 6c 65 63 74 52 6f 77 3b 20 20 20 20 20 nSelectRow;
1d020 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 6e 75 6d /* Estimated num
1d030 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20 72 6f ber of result ro
1d040 77 73 20 2a 2f 0a 20 20 75 33 32 20 73 65 6c 46 ws */. u32 selF
1d050 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 2f lags; /
1d060 2a 20 56 61 72 69 6f 75 73 20 53 46 5f 2a 20 76 * Various SF_* v
1d070 61 6c 75 65 73 20 2a 2f 0a 20 20 69 6e 74 20 69 alues */. int i
1d080 4c 69 6d 69 74 2c 20 69 4f 66 66 73 65 74 3b 20 Limit, iOffset;
1d090 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 72 65 67 69 /* Memory regi
1d0a0 73 74 65 72 73 20 68 6f 6c 64 69 6e 67 20 4c 49 sters holding LI
1d0b0 4d 49 54 20 26 20 4f 46 46 53 45 54 20 63 6f 75 MIT & OFFSET cou
1d0c0 6e 74 65 72 73 20 2a 2f 0a 23 69 66 20 53 45 4c nters */.#if SEL
1d0d0 45 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 ECTTRACE_ENABLED
1d0e0 0a 20 20 63 68 61 72 20 7a 53 65 6c 4e 61 6d 65 . char zSelName
1d0f0 5b 31 32 5d 3b 20 20 20 20 20 2f 2a 20 53 79 6d [12]; /* Sym
1d100 62 6f 6c 69 63 20 6e 61 6d 65 20 6f 66 20 74 68 bolic name of th
1d110 69 73 20 53 45 4c 45 43 54 20 75 73 65 20 66 6f is SELECT use fo
1d120 72 20 64 65 62 75 67 67 69 6e 67 20 2a 2f 0a 20 r debugging */.
1d130 20 75 33 32 20 69 53 65 6c 65 63 74 49 64 3b 20 u32 iSelectId;
1d140 20 20 20 20 20 20 20 20 2f 2a 20 45 58 50 4c 41 /* EXPLA
1d150 49 4e 20 51 55 45 52 59 20 50 4c 41 4e 20 73 65 IN QUERY PLAN se
1d160 6c 65 63 74 20 49 44 20 2a 2f 0a 23 65 6e 64 69 lect ID */.#endi
1d170 66 0a 20 20 69 6e 74 20 61 64 64 72 4f 70 65 6e f. int addrOpen
1d180 45 70 68 6d 5b 32 5d 3b 20 20 20 2f 2a 20 4f 50 Ephm[2]; /* OP
1d190 5f 4f 70 65 6e 45 70 68 65 6d 20 6f 70 63 6f 64 _OpenEphem opcod
1d1a0 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 68 es related to th
1d1b0 69 73 20 73 65 6c 65 63 74 20 2a 2f 0a 20 20 53 is select */. S
1d1c0 72 63 4c 69 73 74 20 2a 70 53 72 63 3b 20 20 20 rcList *pSrc;
1d1d0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 52 4f /* The FRO
1d1e0 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 M clause */. Ex
1d1f0 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 20 pr *pWhere;
1d200 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 /* The WHER
1d210 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 E clause */. Ex
1d220 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 79 prList *pGroupBy
1d230 3b 20 20 20 20 2f 2a 20 54 68 65 20 47 52 4f 55 ; /* The GROU
1d240 50 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 P BY clause */.
1d250 20 45 78 70 72 20 2a 70 48 61 76 69 6e 67 3b 20 Expr *pHaving;
1d260 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 48 /* The H
1d270 41 56 49 4e 47 20 63 6c 61 75 73 65 20 2a 2f 0a AVING clause */.
1d280 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 64 ExprList *pOrd
1d290 65 72 42 79 3b 20 20 20 20 2f 2a 20 54 68 65 20 erBy; /* The
1d2a0 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 ORDER BY clause
1d2b0 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 50 72 */. Select *pPr
1d2c0 69 6f 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 50 ior; /* P
1d2d0 72 69 6f 72 20 73 65 6c 65 63 74 20 69 6e 20 61 rior select in a
1d2e0 20 63 6f 6d 70 6f 75 6e 64 20 73 65 6c 65 63 74 compound select
1d2f0 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 statement */.
1d300 53 65 6c 65 63 74 20 2a 70 4e 65 78 74 3b 20 20 Select *pNext;
1d310 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 73 /* Next s
1d320 65 6c 65 63 74 20 74 6f 20 74 68 65 20 6c 65 66 elect to the lef
1d330 74 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 t in a compound
1d340 2a 2f 0a 20 20 45 78 70 72 20 2a 70 4c 69 6d 69 */. Expr *pLimi
1d350 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c t; /* L
1d360 49 4d 49 54 20 65 78 70 72 65 73 73 69 6f 6e 2e IMIT expression.
1d370 20 4e 55 4c 4c 20 6d 65 61 6e 73 20 6e 6f 74 20 NULL means not
1d380 75 73 65 64 2e 20 2a 2f 0a 20 20 57 69 74 68 20 used. */. With
1d390 2a 70 57 69 74 68 3b 20 20 20 20 20 20 20 20 20 *pWith;
1d3a0 20 20 2f 2a 20 57 49 54 48 20 63 6c 61 75 73 65 /* WITH clause
1d3b0 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 69 attached to thi
1d3c0 73 20 73 65 6c 65 63 74 2e 20 4f 72 20 4e 55 4c s select. Or NUL
1d3d0 4c 2e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 L. */.};../*.**
1d3e0 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 Allowed values f
1d3f0 6f 72 20 53 65 6c 65 63 74 2e 73 65 6c 46 6c 61 or Select.selFla
1d400 67 73 2e 20 20 54 68 65 20 22 53 46 22 20 70 72 gs. The "SF" pr
1d410 65 66 69 78 20 73 74 61 6e 64 73 20 66 6f 72 0a efix stands for.
1d420 2a 2a 20 22 53 65 6c 65 63 74 20 46 6c 61 67 22 ** "Select Flag"
1d430 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f ..**.** Value co
1d440 6e 73 74 72 61 69 6e 74 73 20 28 61 6c 6c 20 63 nstraints (all c
1d450 68 65 63 6b 65 64 20 76 69 61 20 61 73 73 65 72 hecked via asser
1d460 74 28 29 29 0a 2a 2a 20 20 20 20 20 53 46 5f 48 t()).** SF_H
1d470 61 73 41 67 67 20 20 20 20 20 3d 3d 20 4e 43 5f asAgg == NC_
1d480 48 61 73 41 67 67 0a 2a 2a 20 20 20 20 20 53 46 HasAgg.** SF
1d490 5f 4d 69 6e 4d 61 78 41 67 67 20 20 3d 3d 20 4e _MinMaxAgg == N
1d4a0 43 5f 4d 69 6e 4d 61 78 41 67 67 20 20 20 20 20 C_MinMaxAgg
1d4b0 3d 3d 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4d == SQLITE_FUNC_M
1d4c0 49 4e 4d 41 58 0a 2a 2a 20 20 20 20 20 53 46 5f INMAX.** SF_
1d4d0 46 69 78 65 64 4c 69 6d 69 74 20 3d 3d 20 57 48 FixedLimit == WH
1d4e0 45 52 45 5f 55 53 45 5f 4c 49 4d 49 54 0a 2a 2f ERE_USE_LIMIT.*/
1d4f0 0a 23 64 65 66 69 6e 65 20 53 46 5f 44 69 73 74 .#define SF_Dist
1d500 69 6e 63 74 20 20 20 20 20 20 20 30 78 30 30 30 inct 0x000
1d510 30 31 20 20 2f 2a 20 4f 75 74 70 75 74 20 73 68 01 /* Output sh
1d520 6f 75 6c 64 20 62 65 20 44 49 53 54 49 4e 43 54 ould be DISTINCT
1d530 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 41 */.#define SF_A
1d540 6c 6c 20 20 20 20 20 20 20 20 20 20 20 20 30 78 ll 0x
1d550 30 30 30 30 32 20 20 2f 2a 20 49 6e 63 6c 75 64 00002 /* Includ
1d560 65 73 20 74 68 65 20 41 4c 4c 20 6b 65 79 77 6f es the ALL keywo
1d570 72 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 rd */.#define SF
1d580 5f 52 65 73 6f 6c 76 65 64 20 20 20 20 20 20 20 _Resolved
1d590 30 78 30 30 30 30 34 20 20 2f 2a 20 49 64 65 6e 0x00004 /* Iden
1d5a0 74 69 66 69 65 72 73 20 68 61 76 65 20 62 65 65 tifiers have bee
1d5b0 6e 20 72 65 73 6f 6c 76 65 64 20 2a 2f 0a 23 64 n resolved */.#d
1d5c0 65 66 69 6e 65 20 53 46 5f 41 67 67 72 65 67 61 efine SF_Aggrega
1d5d0 74 65 20 20 20 20 20 20 30 78 30 30 30 30 38 20 te 0x00008
1d5e0 20 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 61 67 67 /* Contains agg
1d5f0 20 66 75 6e 63 74 69 6f 6e 73 20 6f 72 20 61 20 functions or a
1d600 47 52 4f 55 50 20 42 59 20 2a 2f 0a 23 64 65 66 GROUP BY */.#def
1d610 69 6e 65 20 53 46 5f 48 61 73 41 67 67 20 20 20 ine SF_HasAgg
1d620 20 20 20 20 20 20 30 78 30 30 30 31 30 20 20 2f 0x00010 /
1d630 2a 20 43 6f 6e 74 61 69 6e 73 20 61 67 67 72 65 * Contains aggre
1d640 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a gate functions *
1d650 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 55 73 65 /.#define SF_Use
1d660 73 45 70 68 65 6d 65 72 61 6c 20 20 30 78 30 30 sEphemeral 0x00
1d670 30 32 30 20 20 2f 2a 20 55 73 65 73 20 74 68 65 020 /* Uses the
1d680 20 4f 70 65 6e 45 70 68 65 6d 65 72 61 6c 20 6f OpenEphemeral o
1d690 70 63 6f 64 65 20 2a 2f 0a 23 64 65 66 69 6e 65 pcode */.#define
1d6a0 20 53 46 5f 45 78 70 61 6e 64 65 64 20 20 20 20 SF_Expanded
1d6b0 20 20 20 30 78 30 30 30 34 30 20 20 2f 2a 20 73 0x00040 /* s
1d6c0 71 6c 69 74 65 33 53 65 6c 65 63 74 45 78 70 61 qlite3SelectExpa
1d6d0 6e 64 28 29 20 63 61 6c 6c 65 64 20 6f 6e 20 74 nd() called on t
1d6e0 68 69 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 his */.#define S
1d6f0 46 5f 48 61 73 54 79 70 65 49 6e 66 6f 20 20 20 F_HasTypeInfo
1d700 20 30 78 30 30 30 38 30 20 20 2f 2a 20 46 52 4f 0x00080 /* FRO
1d710 4d 20 73 75 62 71 75 65 72 69 65 73 20 68 61 76 M subqueries hav
1d720 65 20 54 61 62 6c 65 20 6d 65 74 61 64 61 74 61 e Table metadata
1d730 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 43 */.#define SF_C
1d740 6f 6d 70 6f 75 6e 64 20 20 20 20 20 20 20 30 78 ompound 0x
1d750 30 30 31 30 30 20 20 2f 2a 20 50 61 72 74 20 6f 00100 /* Part o
1d760 66 20 61 20 63 6f 6d 70 6f 75 6e 64 20 71 75 65 f a compound que
1d770 72 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 ry */.#define SF
1d780 5f 56 61 6c 75 65 73 20 20 20 20 20 20 20 20 20 _Values
1d790 30 78 30 30 32 30 30 20 20 2f 2a 20 53 79 6e 74 0x00200 /* Synt
1d7a0 68 65 73 69 7a 65 64 20 66 72 6f 6d 20 56 41 4c hesized from VAL
1d7b0 55 45 53 20 63 6c 61 75 73 65 20 2a 2f 0a 23 64 UES clause */.#d
1d7c0 65 66 69 6e 65 20 53 46 5f 4d 75 6c 74 69 56 61 efine SF_MultiVa
1d7d0 6c 75 65 20 20 20 20 20 30 78 30 30 34 30 30 20 lue 0x00400
1d7e0 20 2f 2a 20 53 69 6e 67 6c 65 20 56 41 4c 55 45 /* Single VALUE
1d7f0 53 20 74 65 72 6d 20 77 69 74 68 20 6d 75 6c 74 S term with mult
1d800 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a 23 64 65 iple rows */.#de
1d810 66 69 6e 65 20 53 46 5f 4e 65 73 74 65 64 46 72 fine SF_NestedFr
1d820 6f 6d 20 20 20 20 20 30 78 30 30 38 30 30 20 20 om 0x00800
1d830 2f 2a 20 50 61 72 74 20 6f 66 20 61 20 70 61 72 /* Part of a par
1d840 65 6e 74 68 65 73 69 7a 65 64 20 46 52 4f 4d 20 enthesized FROM
1d850 63 6c 61 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e clause */.#defin
1d860 65 20 53 46 5f 4d 69 6e 4d 61 78 41 67 67 20 20 e SF_MinMaxAgg
1d870 20 20 20 20 30 78 30 31 30 30 30 20 20 2f 2a 20 0x01000 /*
1d880 41 67 67 72 65 67 61 74 65 20 63 6f 6e 74 61 69 Aggregate contai
1d890 6e 69 6e 67 20 6d 69 6e 28 29 20 6f 72 20 6d 61 ning min() or ma
1d8a0 78 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 x() */.#define S
1d8b0 46 5f 52 65 63 75 72 73 69 76 65 20 20 20 20 20 F_Recursive
1d8c0 20 30 78 30 32 30 30 30 20 20 2f 2a 20 54 68 65 0x02000 /* The
1d8d0 20 72 65 63 75 72 73 69 76 65 20 70 61 72 74 20 recursive part
1d8e0 6f 66 20 61 20 72 65 63 75 72 73 69 76 65 20 43 of a recursive C
1d8f0 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 TE */.#define SF
1d900 5f 46 69 78 65 64 4c 69 6d 69 74 20 20 20 20 20 _FixedLimit
1d910 30 78 30 34 30 30 30 20 20 2f 2a 20 6e 53 65 6c 0x04000 /* nSel
1d920 65 63 74 52 6f 77 20 73 65 74 20 62 79 20 61 20 ectRow set by a
1d930 63 6f 6e 73 74 61 6e 74 20 4c 49 4d 49 54 20 2a constant LIMIT *
1d940 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d 61 79 /.#define SF_May
1d950 62 65 43 6f 6e 76 65 72 74 20 20 20 30 78 30 38 beConvert 0x08
1d960 30 30 30 20 20 2f 2a 20 4e 65 65 64 20 63 6f 6e 000 /* Need con
1d970 76 65 72 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 vertCompoundSele
1d980 63 74 54 6f 53 75 62 71 75 65 72 79 28 29 20 2a ctToSubquery() *
1d990 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 43 6f 6e /.#define SF_Con
1d9a0 76 65 72 74 65 64 20 20 20 20 20 20 30 78 31 30 verted 0x10
1d9b0 30 30 30 20 20 2f 2a 20 42 79 20 63 6f 6e 76 65 000 /* By conve
1d9c0 72 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 74 rtCompoundSelect
1d9d0 54 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f 0a ToSubquery() */.
1d9e0 23 64 65 66 69 6e 65 20 53 46 5f 49 6e 63 6c 75 #define SF_Inclu
1d9f0 64 65 48 69 64 64 65 6e 20 20 30 78 32 30 30 30 deHidden 0x2000
1da00 30 20 20 2f 2a 20 49 6e 63 6c 75 64 65 20 68 69 0 /* Include hi
1da10 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 dden columns in
1da20 6f 75 74 70 75 74 20 2a 2f 0a 23 64 65 66 69 6e output */.#defin
1da30 65 20 53 46 5f 43 6f 6d 70 6c 65 78 52 65 73 75 e SF_ComplexResu
1da40 6c 74 20 20 30 78 34 30 30 30 30 20 20 2f 2a 20 lt 0x40000 /*
1da50 52 65 73 75 6c 74 20 73 65 74 20 63 6f 6e 74 61 Result set conta
1da60 69 6e 73 20 73 75 62 71 75 65 72 79 20 6f 72 20 ins subquery or
1da70 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 0a 0a 2f 2a function */.../*
1da80 0a 2a 2a 20 54 68 65 20 72 65 73 75 6c 74 73 20 .** The results
1da90 6f 66 20 61 20 53 45 4c 45 43 54 20 63 61 6e 20 of a SELECT can
1daa0 62 65 20 64 69 73 74 72 69 62 75 74 65 64 20 69 be distributed i
1dab0 6e 20 73 65 76 65 72 61 6c 20 77 61 79 73 2c 20 n several ways,
1dac0 61 73 20 64 65 66 69 6e 65 64 0a 2a 2a 20 62 79 as defined.** by
1dad0 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c one of the foll
1dae0 6f 77 69 6e 67 20 6d 61 63 72 6f 73 2e 20 20 54 owing macros. T
1daf0 68 65 20 22 53 52 54 22 20 70 72 65 66 69 78 20 he "SRT" prefix
1db00 6d 65 61 6e 73 20 22 53 45 4c 45 43 54 20 52 65 means "SELECT Re
1db10 73 75 6c 74 0a 2a 2a 20 54 79 70 65 22 2e 0a 2a sult.** Type"..*
1db20 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 55 6e 69 *.** SRT_Uni
1db30 6f 6e 20 20 20 20 20 20 20 53 74 6f 72 65 20 72 on Store r
1db40 65 73 75 6c 74 73 20 61 73 20 61 20 6b 65 79 20 esults as a key
1db50 69 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 69 in a temporary i
1db60 6e 64 65 78 0a 2a 2a 20 20 20 20 20 20 20 20 20 ndex.**
1db70 20 20 20 20 20 20 20 20 20 20 20 20 69 64 65 6e iden
1db80 74 69 66 69 65 64 20 62 79 20 70 44 65 73 74 2d tified by pDest-
1db90 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a 0a 2a 2a 20 >iSDParm..**.**
1dba0 20 20 20 20 53 52 54 5f 45 78 63 65 70 74 20 20 SRT_Except
1dbb0 20 20 20 20 52 65 6d 6f 76 65 20 72 65 73 75 6c Remove resul
1dbc0 74 73 20 66 72 6f 6d 20 74 68 65 20 74 65 6d 70 ts from the temp
1dbd0 6f 72 61 72 79 20 69 6e 64 65 78 20 70 44 65 73 orary index pDes
1dbe0 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a 0a 2a t->iSDParm..**.*
1dbf0 2a 20 20 20 20 20 53 52 54 5f 45 78 69 73 74 73 * SRT_Exists
1dc00 20 20 20 20 20 20 53 74 6f 72 65 20 61 20 31 20 Store a 1
1dc10 69 6e 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 70 in memory cell p
1dc20 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 69 66 Dest->iSDParm if
1dc30 20 74 68 65 20 72 65 73 75 6c 74 0a 2a 2a 20 20 the result.**
1dc40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dc50 20 20 20 73 65 74 20 69 73 20 6e 6f 74 20 65 6d set is not em
1dc60 70 74 79 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 pty..**.** S
1dc70 52 54 5f 44 69 73 63 61 72 64 20 20 20 20 20 54 RT_Discard T
1dc80 68 72 6f 77 20 74 68 65 20 72 65 73 75 6c 74 73 hrow the results
1dc90 20 61 77 61 79 2e 20 20 54 68 69 73 20 69 73 20 away. This is
1dca0 75 73 65 64 20 62 79 20 53 45 4c 45 43 54 0a 2a used by SELECT.*
1dcb0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1dcc0 20 20 20 20 20 20 73 74 61 74 65 6d 65 6e 74 73 statements
1dcd0 20 77 69 74 68 69 6e 20 74 72 69 67 67 65 72 73 within triggers
1dce0 20 77 68 6f 73 65 20 6f 6e 6c 79 20 70 75 72 70 whose only purp
1dcf0 6f 73 65 20 69 73 0a 2a 2a 20 20 20 20 20 20 20 ose is.**
1dd00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 th
1dd10 65 20 73 69 64 65 2d 65 66 66 65 63 74 73 20 6f e side-effects o
1dd20 66 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a f functions..**.
1dd30 2a 2a 20 41 6c 6c 20 6f 66 20 74 68 65 20 61 62 ** All of the ab
1dd40 6f 76 65 20 61 72 65 20 66 72 65 65 20 74 6f 20 ove are free to
1dd50 69 67 6e 6f 72 65 20 74 68 65 69 72 20 4f 52 44 ignore their ORD
1dd60 45 52 20 42 59 20 63 6c 61 75 73 65 2e 20 54 68 ER BY clause. Th
1dd70 6f 73 65 20 74 68 61 74 0a 2a 2a 20 66 6f 6c 6c ose that.** foll
1dd80 6f 77 20 6d 75 73 74 20 68 6f 6e 6f 72 20 74 68 ow must honor th
1dd90 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 e ORDER BY claus
1dda0 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 e..**.** SRT
1ddb0 5f 4f 75 74 70 75 74 20 20 20 20 20 20 47 65 6e _Output Gen
1ddc0 65 72 61 74 65 20 61 20 72 6f 77 20 6f 66 20 6f erate a row of o
1ddd0 75 74 70 75 74 20 28 75 73 69 6e 67 20 74 68 65 utput (using the
1dde0 20 4f 50 5f 52 65 73 75 6c 74 52 6f 77 0a 2a 2a OP_ResultRow.**
1ddf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1de00 20 20 20 20 20 6f 70 63 6f 64 65 29 20 66 6f 72 opcode) for
1de10 20 65 61 63 68 20 72 6f 77 20 69 6e 20 74 68 65 each row in the
1de20 20 72 65 73 75 6c 74 20 73 65 74 2e 0a 2a 2a 0a result set..**.
1de30 2a 2a 20 20 20 20 20 53 52 54 5f 4d 65 6d 20 20 ** SRT_Mem
1de40 20 20 20 20 20 20 20 4f 6e 6c 79 20 76 61 6c 69 Only vali
1de50 64 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 d if the result
1de60 69 73 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 is a single colu
1de70 6d 6e 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 mn..**
1de80 20 20 20 20 20 20 20 20 20 20 20 53 74 6f 72 65 Store
1de90 20 74 68 65 20 66 69 72 73 74 20 63 6f 6c 75 6d the first colum
1dea0 6e 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 72 n of the first r
1deb0 65 73 75 6c 74 20 72 6f 77 0a 2a 2a 20 20 20 20 esult row.**
1dec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ded0 20 69 6e 20 72 65 67 69 73 74 65 72 20 70 44 65 in register pDe
1dee0 73 74 2d 3e 69 53 44 50 61 72 6d 20 74 68 65 6e st->iSDParm then
1def0 20 61 62 61 6e 64 6f 6e 20 74 68 65 20 72 65 73 abandon the res
1df00 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 t.**
1df10 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 of the
1df20 71 75 65 72 79 2e 20 20 54 68 69 73 20 64 65 73 query. This des
1df30 74 69 6e 61 74 69 6f 6e 20 69 6d 70 6c 69 65 73 tination implies
1df40 20 22 4c 49 4d 49 54 20 31 22 2e 0a 2a 2a 0a 2a "LIMIT 1"..**.*
1df50 2a 20 20 20 20 20 53 52 54 5f 53 65 74 20 20 20 * SRT_Set
1df60 20 20 20 20 20 20 54 68 65 20 72 65 73 75 6c 74 The result
1df70 20 6d 75 73 74 20 62 65 20 61 20 73 69 6e 67 6c must be a singl
1df80 65 20 63 6f 6c 75 6d 6e 2e 20 20 53 74 6f 72 65 e column. Store
1df90 20 65 61 63 68 0a 2a 2a 20 20 20 20 20 20 20 20 each.**
1dfa0 20 20 20 20 20 20 20 20 20 20 20 20 20 72 6f 77 row
1dfb0 20 6f 66 20 72 65 73 75 6c 74 20 61 73 20 74 68 of result as th
1dfc0 65 20 6b 65 79 20 69 6e 20 74 61 62 6c 65 20 70 e key in table p
1dfd0 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a Dest->iSDParm..*
1dfe0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1dff0 20 20 20 20 20 20 41 70 70 6c 79 20 74 68 65 20 Apply the
1e000 61 66 66 69 6e 69 74 79 20 70 44 65 73 74 2d 3e affinity pDest->
1e010 61 66 66 53 64 73 74 20 62 65 66 6f 72 65 20 73 affSdst before s
1e020 74 6f 72 69 6e 67 0a 2a 2a 20 20 20 20 20 20 20 toring.**
1e030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
1e040 73 75 6c 74 73 2e 20 20 55 73 65 64 20 74 6f 20 sults. Used to
1e050 69 6d 70 6c 65 6d 65 6e 74 20 22 49 4e 20 28 53 implement "IN (S
1e060 45 4c 45 43 54 20 2e 2e 2e 29 22 2e 0a 2a 2a 0a ELECT ...)"..**.
1e070 2a 2a 20 20 20 20 20 53 52 54 5f 45 70 68 65 6d ** SRT_Ephem
1e080 54 61 62 20 20 20 20 43 72 65 61 74 65 20 61 6e Tab Create an
1e090 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 temporary table
1e0a0 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 pDest->iSDParm
1e0b0 61 6e 64 20 73 74 6f 72 65 0a 2a 2a 20 20 20 20 and store.**
1e0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e0d0 20 74 68 65 20 72 65 73 75 6c 74 20 74 68 65 72 the result ther
1e0e0 65 2e 20 54 68 65 20 63 75 72 73 6f 72 20 69 73 e. The cursor is
1e0f0 20 6c 65 66 74 20 6f 70 65 6e 20 61 66 74 65 72 left open after
1e100 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1e110 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 69 6e returnin
1e120 67 2e 20 20 54 68 69 73 20 69 73 20 6c 69 6b 65 g. This is like
1e130 20 53 52 54 5f 54 61 62 6c 65 20 65 78 63 65 70 SRT_Table excep
1e140 74 20 74 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 t that.**
1e150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 th
1e160 69 73 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 75 is destination u
1e170 73 65 73 20 4f 50 5f 4f 70 65 6e 45 70 68 65 6d ses OP_OpenEphem
1e180 65 72 61 6c 20 74 6f 20 63 72 65 61 74 65 0a 2a eral to create.*
1e190 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1e1a0 20 20 20 20 20 20 74 68 65 20 74 61 62 6c 65 20 the table
1e1b0 66 69 72 73 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 first..**.**
1e1c0 20 53 52 54 5f 43 6f 72 6f 75 74 69 6e 65 20 20 SRT_Coroutine
1e1d0 20 47 65 6e 65 72 61 74 65 20 61 20 63 6f 2d 72 Generate a co-r
1e1e0 6f 75 74 69 6e 65 20 74 68 61 74 20 72 65 74 75 outine that retu
1e1f0 72 6e 73 20 61 20 6e 65 77 20 72 6f 77 20 6f 66 rns a new row of
1e200 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1e210 20 20 20 20 20 20 20 20 72 65 73 75 6c 74 73 20 results
1e220 65 61 63 68 20 74 69 6d 65 20 69 74 20 69 73 20 each time it is
1e230 69 6e 76 6f 6b 65 64 2e 20 20 54 68 65 20 65 6e invoked. The en
1e240 74 72 79 20 70 6f 69 6e 74 0a 2a 2a 20 20 20 20 try point.**
1e250 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e260 20 6f 66 20 74 68 65 20 63 6f 2d 72 6f 75 74 69 of the co-routi
1e270 6e 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 ne is stored in
1e280 72 65 67 69 73 74 65 72 20 70 44 65 73 74 2d 3e register pDest->
1e290 69 53 44 50 61 72 6d 0a 2a 2a 20 20 20 20 20 20 iSDParm.**
1e2a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 a
1e2b0 6e 64 20 74 68 65 20 72 65 73 75 6c 74 20 72 6f nd the result ro
1e2c0 77 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 70 w is stored in p
1e2d0 44 65 73 74 2d 3e 6e 44 65 73 74 20 72 65 67 69 Dest->nDest regi
1e2e0 73 74 65 72 73 0a 2a 2a 20 20 20 20 20 20 20 20 sters.**
1e2f0 20 20 20 20 20 20 20 20 20 20 20 20 20 73 74 61 sta
1e300 72 74 69 6e 67 20 77 69 74 68 20 70 44 65 73 74 rting with pDest
1e310 2d 3e 69 53 64 73 74 2e 0a 2a 2a 0a 2a 2a 20 20 ->iSdst..**.**
1e320 20 20 20 53 52 54 5f 54 61 62 6c 65 20 20 20 20 SRT_Table
1e330 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 Store results
1e340 20 69 6e 20 74 65 6d 70 6f 72 61 72 79 20 74 61 in temporary ta
1e350 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 50 61 ble pDest->iSDPa
1e360 72 6d 2e 0a 2a 2a 20 20 20 20 20 53 52 54 5f 46 rm..** SRT_F
1e370 69 66 6f 20 20 20 20 20 20 20 20 54 68 69 73 20 ifo This
1e380 69 73 20 6c 69 6b 65 20 53 52 54 5f 45 70 68 65 is like SRT_Ephe
1e390 6d 54 61 62 20 65 78 63 65 70 74 20 74 68 61 74 mTab except that
1e3a0 20 74 68 65 20 74 61 62 6c 65 0a 2a 2a 20 20 20 the table.**
1e3b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e3c0 20 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 is assumed to
1e3d0 61 6c 72 65 61 64 79 20 62 65 20 6f 70 65 6e 2e already be open.
1e3e0 20 20 53 52 54 5f 46 69 66 6f 20 68 61 73 0a 2a SRT_Fifo has.*
1e3f0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1e400 20 20 20 20 20 20 74 68 65 20 61 64 64 69 74 69 the additi
1e410 6f 6e 61 6c 20 70 72 6f 70 65 72 74 79 20 6f 66 onal property of
1e420 20 62 65 69 6e 67 20 61 62 6c 65 20 74 6f 20 69 being able to i
1e430 67 6e 6f 72 65 0a 2a 2a 20 20 20 20 20 20 20 20 gnore.**
1e440 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 the
1e450 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 ORDER BY clause
1e460 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
1e470 44 69 73 74 46 69 66 6f 20 20 20 20 53 74 6f 72 DistFifo Stor
1e480 65 20 72 65 73 75 6c 74 73 20 69 6e 20 61 20 74 e results in a t
1e490 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 20 70 emporary table p
1e4a0 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a Dest->iSDParm..*
1e4b0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1e4c0 20 20 20 20 20 20 42 75 74 20 61 6c 73 6f 20 75 But also u
1e4d0 73 65 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 se temporary tab
1e4e0 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 le pDest->iSDPar
1e4f0 6d 2b 31 20 61 73 0a 2a 2a 20 20 20 20 20 20 20 m+1 as.**
1e500 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 20 a
1e510 72 65 63 6f 72 64 20 6f 66 20 61 6c 6c 20 70 72 record of all pr
1e520 69 6f 72 20 72 65 73 75 6c 74 73 20 61 6e 64 20 ior results and
1e530 69 67 6e 6f 72 65 20 61 6e 79 20 64 75 70 6c 69 ignore any dupli
1e540 63 61 74 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 cate.**
1e550 20 20 20 20 20 20 20 20 20 20 20 20 72 6f 77 73 rows
1e560 2e 20 20 4e 61 6d 65 20 6d 65 61 6e 73 3a 20 20 . Name means:
1e570 22 44 69 73 74 69 6e 63 74 20 46 69 66 6f 22 2e "Distinct Fifo".
1e580 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 51 .**.** SRT_Q
1e590 75 65 75 65 20 20 20 20 20 20 20 53 74 6f 72 65 ueue Store
1e5a0 20 72 65 73 75 6c 74 73 20 69 6e 20 70 72 69 6f results in prio
1e5b0 72 69 74 79 20 71 75 65 75 65 20 70 44 65 73 74 rity queue pDest
1e5c0 2d 3e 69 53 44 50 61 72 6d 20 28 72 65 61 6c 6c ->iSDParm (reall
1e5d0 79 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 y.**
1e5e0 20 20 20 20 20 20 20 20 20 61 6e 20 69 6e 64 65 an inde
1e5f0 78 29 2e 20 20 41 70 70 65 6e 64 20 61 20 73 65 x). Append a se
1e600 71 75 65 6e 63 65 20 6e 75 6d 62 65 72 20 73 6f quence number so
1e610 20 74 68 61 74 20 61 6c 6c 20 65 6e 74 72 69 65 that all entrie
1e620 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 s.**
1e630 20 20 20 20 20 20 20 20 20 61 72 65 20 64 69 73 are dis
1e640 74 69 6e 63 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 tinct..**.**
1e650 20 53 52 54 5f 44 69 73 74 51 75 65 75 65 20 20 SRT_DistQueue
1e660 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 69 Store results i
1e670 6e 20 70 72 69 6f 72 69 74 79 20 71 75 65 75 65 n priority queue
1e680 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 pDest->iSDParm
1e690 6f 6e 6c 79 20 69 66 0a 2a 2a 20 20 20 20 20 20 only if.**
1e6a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
1e6b0 68 65 20 73 61 6d 65 20 72 65 63 6f 72 64 20 68 he same record h
1e6c0 61 73 20 6e 65 76 65 72 20 62 65 65 6e 20 73 74 as never been st
1e6d0 6f 72 65 64 20 62 65 66 6f 72 65 2e 20 20 54 68 ored before. Th
1e6e0 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
1e6f0 20 20 20 20 20 20 20 20 20 69 6e 64 65 78 20 61 index a
1e700 74 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d t pDest->iSDParm
1e710 2b 31 20 68 6f 6c 64 20 61 6c 6c 20 70 72 69 6f +1 hold all prio
1e720 72 20 73 74 6f 72 65 73 2e 0a 2a 2f 0a 23 64 65 r stores..*/.#de
1e730 66 69 6e 65 20 53 52 54 5f 55 6e 69 6f 6e 20 20 fine SRT_Union
1e740 20 20 20 20 20 20 31 20 20 2f 2a 20 53 74 6f 72 1 /* Stor
1e750 65 20 72 65 73 75 6c 74 20 61 73 20 6b 65 79 73 e result as keys
1e760 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a in an index */.
1e770 23 64 65 66 69 6e 65 20 53 52 54 5f 45 78 63 65 #define SRT_Exce
1e780 70 74 20 20 20 20 20 20 20 32 20 20 2f 2a 20 52 pt 2 /* R
1e790 65 6d 6f 76 65 20 72 65 73 75 6c 74 20 66 72 6f emove result fro
1e7a0 6d 20 61 20 55 4e 49 4f 4e 20 69 6e 64 65 78 20 m a UNION index
1e7b0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 */.#define SRT_E
1e7c0 78 69 73 74 73 20 20 20 20 20 20 20 33 20 20 2f xists 3 /
1e7d0 2a 20 53 74 6f 72 65 20 31 20 69 66 20 74 68 65 * Store 1 if the
1e7e0 20 72 65 73 75 6c 74 20 69 73 20 6e 6f 74 20 65 result is not e
1e7f0 6d 70 74 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 mpty */.#define
1e800 53 52 54 5f 44 69 73 63 61 72 64 20 20 20 20 20 SRT_Discard
1e810 20 34 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 73 61 4 /* Do not sa
1e820 76 65 20 74 68 65 20 72 65 73 75 6c 74 73 20 61 ve the results a
1e830 6e 79 77 68 65 72 65 20 2a 2f 0a 23 64 65 66 69 nywhere */.#defi
1e840 6e 65 20 53 52 54 5f 46 69 66 6f 20 20 20 20 20 ne SRT_Fifo
1e850 20 20 20 20 35 20 20 2f 2a 20 53 74 6f 72 65 20 5 /* Store
1e860 72 65 73 75 6c 74 20 61 73 20 64 61 74 61 20 77 result as data w
1e870 69 74 68 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 ith an automatic
1e880 20 72 6f 77 69 64 20 2a 2f 0a 23 64 65 66 69 6e rowid */.#defin
1e890 65 20 53 52 54 5f 44 69 73 74 46 69 66 6f 20 20 e SRT_DistFifo
1e8a0 20 20 20 36 20 20 2f 2a 20 4c 69 6b 65 20 53 52 6 /* Like SR
1e8b0 54 5f 46 69 66 6f 2c 20 62 75 74 20 75 6e 69 71 T_Fifo, but uniq
1e8c0 75 65 20 72 65 73 75 6c 74 73 20 6f 6e 6c 79 20 ue results only
1e8d0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 51 */.#define SRT_Q
1e8e0 75 65 75 65 20 20 20 20 20 20 20 20 37 20 20 2f ueue 7 /
1e8f0 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 69 * Store result i
1e900 6e 20 61 6e 20 71 75 65 75 65 20 2a 2f 0a 23 64 n an queue */.#d
1e910 65 66 69 6e 65 20 53 52 54 5f 44 69 73 74 51 75 efine SRT_DistQu
1e920 65 75 65 20 20 20 20 38 20 20 2f 2a 20 4c 69 6b eue 8 /* Lik
1e930 65 20 53 52 54 5f 51 75 65 75 65 2c 20 62 75 74 e SRT_Queue, but
1e940 20 75 6e 69 71 75 65 20 72 65 73 75 6c 74 73 20 unique results
1e950 6f 6e 6c 79 20 2a 2f 0a 0a 2f 2a 20 54 68 65 20 only */../* The
1e960 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 ORDER BY clause
1e970 69 73 20 69 67 6e 6f 72 65 64 20 66 6f 72 20 61 is ignored for a
1e980 6c 6c 20 6f 66 20 74 68 65 20 61 62 6f 76 65 20 ll of the above
1e990 2a 2f 0a 23 64 65 66 69 6e 65 20 49 67 6e 6f 72 */.#define Ignor
1e9a0 61 62 6c 65 4f 72 64 65 72 62 79 28 58 29 20 28 ableOrderby(X) (
1e9b0 28 58 2d 3e 65 44 65 73 74 29 3c 3d 53 52 54 5f (X->eDest)<=SRT_
1e9c0 44 69 73 74 51 75 65 75 65 29 0a 0a 23 64 65 66 DistQueue)..#def
1e9d0 69 6e 65 20 53 52 54 5f 4f 75 74 70 75 74 20 20 ine SRT_Output
1e9e0 20 20 20 20 20 39 20 20 2f 2a 20 4f 75 74 70 75 9 /* Outpu
1e9f0 74 20 65 61 63 68 20 72 6f 77 20 6f 66 20 72 65 t each row of re
1ea00 73 75 6c 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 sult */.#define
1ea10 53 52 54 5f 4d 65 6d 20 20 20 20 20 20 20 20 20 SRT_Mem
1ea20 31 30 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 10 /* Store res
1ea30 75 6c 74 20 69 6e 20 61 20 6d 65 6d 6f 72 79 20 ult in a memory
1ea40 63 65 6c 6c 20 2a 2f 0a 23 64 65 66 69 6e 65 20 cell */.#define
1ea50 53 52 54 5f 53 65 74 20 20 20 20 20 20 20 20 20 SRT_Set
1ea60 31 31 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 11 /* Store res
1ea70 75 6c 74 73 20 61 73 20 6b 65 79 73 20 69 6e 20 ults as keys in
1ea80 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 an index */.#def
1ea90 69 6e 65 20 53 52 54 5f 45 70 68 65 6d 54 61 62 ine SRT_EphemTab
1eaa0 20 20 20 20 31 32 20 20 2f 2a 20 43 72 65 61 74 12 /* Creat
1eab0 65 20 74 72 61 6e 73 69 65 6e 74 20 74 61 62 20 e transient tab
1eac0 61 6e 64 20 73 74 6f 72 65 20 6c 69 6b 65 20 53 and store like S
1ead0 52 54 5f 54 61 62 6c 65 20 2a 2f 0a 23 64 65 66 RT_Table */.#def
1eae0 69 6e 65 20 53 52 54 5f 43 6f 72 6f 75 74 69 6e ine SRT_Coroutin
1eaf0 65 20 20 20 31 33 20 20 2f 2a 20 47 65 6e 65 72 e 13 /* Gener
1eb00 61 74 65 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 ate a single row
1eb10 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a 23 64 of result */.#d
1eb20 65 66 69 6e 65 20 53 52 54 5f 54 61 62 6c 65 20 efine SRT_Table
1eb30 20 20 20 20 20 20 31 34 20 20 2f 2a 20 53 74 6f 14 /* Sto
1eb40 72 65 20 72 65 73 75 6c 74 20 61 73 20 64 61 74 re result as dat
1eb50 61 20 77 69 74 68 20 61 6e 20 61 75 74 6f 6d 61 a with an automa
1eb60 74 69 63 20 72 6f 77 69 64 20 2a 2f 0a 0a 2f 2a tic rowid */../*
1eb70 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
1eb80 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 64 of this object d
1eb90 65 73 63 72 69 62 65 73 20 77 68 65 72 65 20 74 escribes where t
1eba0 6f 20 70 75 74 20 6f 66 20 74 68 65 20 72 65 73 o put of the res
1ebb0 75 6c 74 73 20 6f 66 0a 2a 2a 20 61 20 53 45 4c ults of.** a SEL
1ebc0 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a ECT statement..*
1ebd0 2f 0a 73 74 72 75 63 74 20 53 65 6c 65 63 74 44 /.struct SelectD
1ebe0 65 73 74 20 7b 0a 20 20 75 38 20 65 44 65 73 74 est {. u8 eDest
1ebf0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
1ec00 48 6f 77 20 74 6f 20 64 69 73 70 6f 73 65 20 6f How to dispose o
1ec10 66 20 74 68 65 20 72 65 73 75 6c 74 73 2e 20 20 f the results.
1ec20 4f 6e 20 6f 66 20 53 52 54 5f 2a 20 61 62 6f 76 On of SRT_* abov
1ec30 65 2e 20 2a 2f 0a 20 20 69 6e 74 20 69 53 44 50 e. */. int iSDP
1ec40 61 72 6d 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 arm; /*
1ec50 41 20 70 61 72 61 6d 65 74 65 72 20 75 73 65 64 A parameter used
1ec60 20 62 79 20 74 68 65 20 65 44 65 73 74 20 64 69 by the eDest di
1ec70 73 70 6f 73 61 6c 20 6d 65 74 68 6f 64 20 2a 2f sposal method */
1ec80 0a 20 20 69 6e 74 20 69 53 64 73 74 3b 20 20 20 . int iSdst;
1ec90 20 20 20 20 20 20 20 20 2f 2a 20 42 61 73 65 20 /* Base
1eca0 72 65 67 69 73 74 65 72 20 77 68 65 72 65 20 72 register where r
1ecb0 65 73 75 6c 74 73 20 61 72 65 20 77 72 69 74 74 esults are writt
1ecc0 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 64 73 en */. int nSds
1ecd0 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
1ece0 4e 75 6d 62 65 72 20 6f 66 20 72 65 67 69 73 74 Number of regist
1ecf0 65 72 73 20 61 6c 6c 6f 63 61 74 65 64 20 2a 2f ers allocated */
1ed00 0a 20 20 63 68 61 72 20 2a 7a 41 66 66 53 64 73 . char *zAffSds
1ed10 74 3b 20 20 20 20 20 20 2f 2a 20 41 66 66 69 6e t; /* Affin
1ed20 69 74 79 20 75 73 65 64 20 77 68 65 6e 20 65 44 ity used when eD
1ed30 65 73 74 3d 3d 53 52 54 5f 53 65 74 20 2a 2f 0a est==SRT_Set */.
1ed40 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 64 ExprList *pOrd
1ed50 65 72 42 79 3b 20 20 2f 2a 20 4b 65 79 20 63 6f erBy; /* Key co
1ed60 6c 75 6d 6e 73 20 66 6f 72 20 53 52 54 5f 51 75 lumns for SRT_Qu
1ed70 65 75 65 20 61 6e 64 20 53 52 54 5f 44 69 73 74 eue and SRT_Dist
1ed80 51 75 65 75 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a Queue */.};../*.
1ed90 2a 2a 20 44 75 72 69 6e 67 20 63 6f 64 65 20 67 ** During code g
1eda0 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 73 74 61 eneration of sta
1edb0 74 65 6d 65 6e 74 73 20 74 68 61 74 20 64 6f 20 tements that do
1edc0 69 6e 73 65 72 74 73 20 69 6e 74 6f 20 41 55 54 inserts into AUT
1edd0 4f 49 4e 43 52 45 4d 45 4e 54 0a 2a 2a 20 74 61 OINCREMENT.** ta
1ede0 62 6c 65 73 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 bles, the follow
1edf0 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ing information
1ee00 69 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 is attached to t
1ee10 68 65 20 54 61 62 6c 65 2e 75 2e 61 75 74 6f 49 he Table.u.autoI
1ee20 6e 63 2e 70 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 nc.p.** pointer
1ee30 6f 66 20 65 61 63 68 20 61 75 74 6f 69 6e 63 72 of each autoincr
1ee40 65 6d 65 6e 74 20 74 61 62 6c 65 20 74 6f 20 72 ement table to r
1ee50 65 63 6f 72 64 20 73 6f 6d 65 20 73 69 64 65 20 ecord some side
1ee60 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 information that
1ee70 0a 2a 2a 20 74 68 65 20 63 6f 64 65 20 67 65 6e .** the code gen
1ee80 65 72 61 74 6f 72 20 6e 65 65 64 73 2e 20 20 57 erator needs. W
1ee90 65 20 68 61 76 65 20 74 6f 20 6b 65 65 70 20 70 e have to keep p
1eea0 65 72 2d 74 61 62 6c 65 20 61 75 74 6f 69 6e 63 er-table autoinc
1eeb0 72 65 6d 65 6e 74 0a 2a 2a 20 69 6e 66 6f 72 6d rement.** inform
1eec0 61 74 69 6f 6e 20 69 6e 20 63 61 73 65 20 69 6e ation in case in
1eed0 73 65 72 74 73 20 61 72 65 20 64 6f 6e 65 20 77 serts are done w
1eee0 69 74 68 69 6e 20 74 72 69 67 67 65 72 73 2e 20 ithin triggers.
1eef0 20 54 72 69 67 67 65 72 73 20 64 6f 20 6e 6f 74 Triggers do not
1ef00 0a 2a 2a 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6f .** normally coo
1ef10 72 64 69 6e 61 74 65 20 74 68 65 69 72 20 61 63 rdinate their ac
1ef20 74 69 76 69 74 69 65 73 2c 20 62 75 74 20 77 65 tivities, but we
1ef30 20 64 6f 20 6e 65 65 64 20 74 6f 20 63 6f 6f 72 do need to coor
1ef40 64 69 6e 61 74 65 20 74 68 65 0a 2a 2a 20 6c 6f dinate the.** lo
1ef50 61 64 69 6e 67 20 61 6e 64 20 73 61 76 69 6e 67 ading and saving
1ef60 20 6f 66 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e of autoincremen
1ef70 74 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a t information..*
1ef80 2f 0a 73 74 72 75 63 74 20 41 75 74 6f 69 6e 63 /.struct Autoinc
1ef90 49 6e 66 6f 20 7b 0a 20 20 41 75 74 6f 69 6e 63 Info {. Autoinc
1efa0 49 6e 66 6f 20 2a 70 4e 65 78 74 3b 20 20 20 2f Info *pNext; /
1efb0 2a 20 4e 65 78 74 20 69 6e 66 6f 20 62 6c 6f 63 * Next info bloc
1efc0 6b 20 69 6e 20 61 20 6c 69 73 74 20 6f 66 20 74 k in a list of t
1efd0 68 65 6d 20 61 6c 6c 20 2a 2f 0a 20 20 54 61 62 hem all */. Tab
1efe0 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 20 le *pTab;
1eff0 20 20 20 2f 2a 20 54 61 62 6c 65 20 74 68 69 73 /* Table this
1f000 20 69 6e 66 6f 20 62 6c 6f 63 6b 20 72 65 66 65 info block refe
1f010 72 73 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 rs to */. int i
1f020 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 Db;
1f030 20 2f 2a 20 49 6e 64 65 78 20 69 6e 20 73 71 6c /* Index in sql
1f040 69 74 65 33 2e 61 44 62 5b 5d 20 6f 66 20 64 61 ite3.aDb[] of da
1f050 74 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 20 70 tabase holding p
1f060 54 61 62 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 Tab */. int reg
1f070 43 74 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f Ctr; /
1f080 2a 20 4d 65 6d 6f 72 79 20 72 65 67 69 73 74 65 * Memory registe
1f090 72 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 72 6f r holding the ro
1f0a0 77 69 64 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 7d wid counter */.}
1f0b0 3b 0a 0a 2f 2a 0a 2a 2a 20 53 69 7a 65 20 6f 66 ;../*.** Size of
1f0c0 20 74 68 65 20 63 6f 6c 75 6d 6e 20 63 61 63 68 the column cach
1f0d0 65 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c e.*/.#ifndef SQL
1f0e0 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 0a 23 ITE_N_COLCACHE.#
1f0f0 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e define SQLITE_N
1f100 5f 43 4f 4c 43 41 43 48 45 20 31 30 0a 23 65 6e _COLCACHE 10.#en
1f110 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 74 20 6c 65 dif../*.** At le
1f120 61 73 74 20 6f 6e 65 20 69 6e 73 74 61 6e 63 65 ast one instance
1f130 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
1f140 67 20 73 74 72 75 63 74 75 72 65 20 69 73 20 63 g structure is c
1f150 72 65 61 74 65 64 20 66 6f 72 20 65 61 63 68 0a reated for each.
1f160 2a 2a 20 74 72 69 67 67 65 72 20 74 68 61 74 20 ** trigger that
1f170 6d 61 79 20 62 65 20 66 69 72 65 64 20 77 68 69 may be fired whi
1f180 6c 65 20 70 61 72 73 69 6e 67 20 61 6e 20 49 4e le parsing an IN
1f190 53 45 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20 SERT, UPDATE or
1f1a0 44 45 4c 45 54 45 0a 2a 2a 20 73 74 61 74 65 6d DELETE.** statem
1f1b0 65 6e 74 2e 20 41 6c 6c 20 73 75 63 68 20 6f 62 ent. All such ob
1f1c0 6a 65 63 74 73 20 61 72 65 20 73 74 6f 72 65 64 jects are stored
1f1d0 20 69 6e 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c in the linked l
1f1e0 69 73 74 20 68 65 61 64 65 64 20 61 74 0a 2a 2a ist headed at.**
1f1f0 20 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 Parse.pTriggerP
1f200 72 67 20 61 6e 64 20 64 65 6c 65 74 65 64 20 6f rg and deleted o
1f210 6e 63 65 20 73 74 61 74 65 6d 65 6e 74 20 63 6f nce statement co
1f220 6d 70 69 6c 61 74 69 6f 6e 20 68 61 73 20 62 65 mpilation has be
1f230 65 6e 0a 2a 2a 20 63 6f 6d 70 6c 65 74 65 64 2e en.** completed.
1f240 0a 2a 2a 0a 2a 2a 20 41 20 56 64 62 65 20 73 75 .**.** A Vdbe su
1f250 62 2d 70 72 6f 67 72 61 6d 20 74 68 61 74 20 69 b-program that i
1f260 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 62 6f mplements the bo
1f270 64 79 20 61 6e 64 20 57 48 45 4e 20 63 6c 61 75 dy and WHEN clau
1f280 73 65 20 6f 66 20 74 72 69 67 67 65 72 0a 2a 2a se of trigger.**
1f290 20 54 72 69 67 67 65 72 50 72 67 2e 70 54 72 69 TriggerPrg.pTri
1f2a0 67 67 65 72 2c 20 61 73 73 75 6d 69 6e 67 20 61 gger, assuming a
1f2b0 20 64 65 66 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 default ON CONF
1f2c0 4c 49 43 54 20 63 6c 61 75 73 65 20 6f 66 0a 2a LICT clause of.*
1f2d0 2a 20 54 72 69 67 67 65 72 50 72 67 2e 6f 72 63 * TriggerPrg.orc
1f2e0 6f 6e 66 2c 20 69 73 20 73 74 6f 72 65 64 20 69 onf, is stored i
1f2f0 6e 20 74 68 65 20 54 72 69 67 67 65 72 50 72 67 n the TriggerPrg
1f300 2e 70 50 72 6f 67 72 61 6d 20 76 61 72 69 61 62 .pProgram variab
1f310 6c 65 2e 0a 2a 2a 20 54 68 65 20 50 61 72 73 65 le..** The Parse
1f320 2e 70 54 72 69 67 67 65 72 50 72 67 20 6c 69 73 .pTriggerPrg lis
1f330 74 20 6e 65 76 65 72 20 63 6f 6e 74 61 69 6e 73 t never contains
1f340 20 74 77 6f 20 65 6e 74 72 69 65 73 20 77 69 74 two entries wit
1f350 68 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 76 61 h the same.** va
1f360 6c 75 65 73 20 66 6f 72 20 62 6f 74 68 20 70 54 lues for both pT
1f370 72 69 67 67 65 72 20 61 6e 64 20 6f 72 63 6f 6e rigger and orcon
1f380 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 54 72 69 f..**.** The Tri
1f390 67 67 65 72 50 72 67 2e 61 43 6f 6c 6d 61 73 6b ggerPrg.aColmask
1f3a0 5b 30 5d 20 76 61 72 69 61 62 6c 65 20 69 73 20 [0] variable is
1f3b0 73 65 74 20 74 6f 20 61 20 6d 61 73 6b 20 6f 66 set to a mask of
1f3c0 20 6f 6c 64 2e 2a 20 63 6f 6c 75 6d 6e 73 0a 2a old.* columns.*
1f3d0 2a 20 61 63 63 65 73 73 65 64 20 28 6f 72 20 73 * accessed (or s
1f3e0 65 74 20 74 6f 20 30 20 66 6f 72 20 74 72 69 67 et to 0 for trig
1f3f0 67 65 72 73 20 66 69 72 65 64 20 61 73 20 61 20 gers fired as a
1f400 72 65 73 75 6c 74 20 6f 66 20 49 4e 53 45 52 54 result of INSERT
1f410 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 29 2e .** statements).
1f420 20 53 69 6d 69 6c 61 72 6c 79 2c 20 74 68 65 20 Similarly, the
1f430 54 72 69 67 67 65 72 50 72 67 2e 61 43 6f 6c 6d TriggerPrg.aColm
1f440 61 73 6b 5b 31 5d 20 76 61 72 69 61 62 6c 65 20 ask[1] variable
1f450 69 73 20 73 65 74 20 74 6f 0a 2a 2a 20 61 20 6d is set to.** a m
1f460 61 73 6b 20 6f 66 20 6e 65 77 2e 2a 20 63 6f 6c ask of new.* col
1f470 75 6d 6e 73 20 75 73 65 64 20 62 79 20 74 68 65 umns used by the
1f480 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 73 74 72 program..*/.str
1f490 75 63 74 20 54 72 69 67 67 65 72 50 72 67 20 7b uct TriggerPrg {
1f4a0 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 72 69 . Trigger *pTri
1f4b0 67 67 65 72 3b 20 20 20 20 20 20 2f 2a 20 54 72 gger; /* Tr
1f4c0 69 67 67 65 72 20 74 68 69 73 20 70 72 6f 67 72 igger this progr
1f4d0 61 6d 20 77 61 73 20 63 6f 64 65 64 20 66 72 6f am was coded fro
1f4e0 6d 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 50 72 m */. TriggerPr
1f4f0 67 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 2f g *pNext; /
1f500 2a 20 4e 65 78 74 20 65 6e 74 72 79 20 69 6e 20 * Next entry in
1f510 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 72 Parse.pTriggerPr
1f520 67 20 6c 69 73 74 20 2a 2f 0a 20 20 53 75 62 50 g list */. SubP
1f530 72 6f 67 72 61 6d 20 2a 70 50 72 6f 67 72 61 6d rogram *pProgram
1f540 3b 20 20 20 2f 2a 20 50 72 6f 67 72 61 6d 20 69 ; /* Program i
1f550 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 70 54 72 69 mplementing pTri
1f560 67 67 65 72 2f 6f 72 63 6f 6e 66 20 2a 2f 0a 20 gger/orconf */.
1f570 20 69 6e 74 20 6f 72 63 6f 6e 66 3b 20 20 20 20 int orconf;
1f580 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 /* Defa
1f590 75 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 ult ON CONFLICT
1f5a0 70 6f 6c 69 63 79 20 2a 2f 0a 20 20 75 33 32 20 policy */. u32
1f5b0 61 43 6f 6c 6d 61 73 6b 5b 32 5d 3b 20 20 20 20 aColmask[2];
1f5c0 20 20 20 20 2f 2a 20 4d 61 73 6b 73 20 6f 66 20 /* Masks of
1f5d0 6f 6c 64 2e 2a 2c 20 6e 65 77 2e 2a 20 63 6f 6c old.*, new.* col
1f5e0 75 6d 6e 73 20 61 63 63 65 73 73 65 64 20 2a 2f umns accessed */
1f5f0 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 79 .};../*.** The y
1f600 44 62 4d 61 73 6b 20 64 61 74 61 74 79 70 65 20 DbMask datatype
1f610 66 6f 72 20 74 68 65 20 62 69 74 6d 61 73 6b 20 for the bitmask
1f620 6f 66 20 61 6c 6c 20 61 74 74 61 63 68 65 64 20 of all attached
1f630 64 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a 23 69 databases..*/.#i
1f640 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 f SQLITE_MAX_ATT
1f650 41 43 48 45 44 3e 33 30 0a 20 20 74 79 70 65 64 ACHED>30. typed
1f660 65 66 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 ef unsigned char
1f670 20 79 44 62 4d 61 73 6b 5b 28 53 51 4c 49 54 45 yDbMask[(SQLITE
1f680 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 2b 39 29 _MAX_ATTACHED+9)
1f690 2f 38 5d 3b 0a 23 20 64 65 66 69 6e 65 20 44 62 /8];.# define Db
1f6a0 4d 61 73 6b 54 65 73 74 28 4d 2c 49 29 20 20 20 MaskTest(M,I)
1f6b0 20 28 28 28 4d 29 5b 28 49 29 2f 38 5d 26 28 31 (((M)[(I)/8]&(1
1f6c0 3c 3c 28 28 49 29 26 37 29 29 29 21 3d 30 29 0a <<((I)&7)))!=0).
1f6d0 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 5a # define DbMaskZ
1f6e0 65 72 6f 28 4d 29 20 20 20 20 20 20 6d 65 6d 73 ero(M) mems
1f6f0 65 74 28 28 4d 29 2c 30 2c 73 69 7a 65 6f 66 28 et((M),0,sizeof(
1f700 4d 29 29 0a 23 20 64 65 66 69 6e 65 20 44 62 4d M)).# define DbM
1f710 61 73 6b 53 65 74 28 4d 2c 49 29 20 20 20 20 20 askSet(M,I)
1f720 28 4d 29 5b 28 49 29 2f 38 5d 7c 3d 28 31 3c 3c (M)[(I)/8]|=(1<<
1f730 28 28 49 29 26 37 29 29 0a 23 20 64 65 66 69 6e ((I)&7)).# defin
1f740 65 20 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 e DbMaskAllZero(
1f750 4d 29 20 20 20 73 71 6c 69 74 65 33 44 62 4d 61 M) sqlite3DbMa
1f760 73 6b 41 6c 6c 5a 65 72 6f 28 4d 29 0a 23 20 64 skAllZero(M).# d
1f770 65 66 69 6e 65 20 44 62 4d 61 73 6b 4e 6f 6e 5a efine DbMaskNonZ
1f780 65 72 6f 28 4d 29 20 20 20 28 73 71 6c 69 74 65 ero(M) (sqlite
1f790 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 4d 3DbMaskAllZero(M
1f7a0 29 3d 3d 30 29 0a 23 65 6c 73 65 0a 20 20 74 79 )==0).#else. ty
1f7b0 70 65 64 65 66 20 75 6e 73 69 67 6e 65 64 20 69 pedef unsigned i
1f7c0 6e 74 20 79 44 62 4d 61 73 6b 3b 0a 23 20 64 65 nt yDbMask;.# de
1f7d0 66 69 6e 65 20 44 62 4d 61 73 6b 54 65 73 74 28 fine DbMaskTest(
1f7e0 4d 2c 49 29 20 20 20 20 28 28 28 4d 29 26 28 28 M,I) (((M)&((
1f7f0 28 79 44 62 4d 61 73 6b 29 31 29 3c 3c 28 49 29 (yDbMask)1)<<(I)
1f800 29 29 21 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 ))!=0).# define
1f810 44 62 4d 61 73 6b 5a 65 72 6f 28 4d 29 20 20 20 DbMaskZero(M)
1f820 20 20 20 28 4d 29 3d 30 0a 23 20 64 65 66 69 6e (M)=0.# defin
1f830 65 20 44 62 4d 61 73 6b 53 65 74 28 4d 2c 49 29 e DbMaskSet(M,I)
1f840 20 20 20 20 20 28 4d 29 7c 3d 28 28 28 79 44 62 (M)|=(((yDb
1f850 4d 61 73 6b 29 31 29 3c 3c 28 49 29 29 0a 23 20 Mask)1)<<(I)).#
1f860 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 41 6c 6c define DbMaskAll
1f870 5a 65 72 6f 28 4d 29 20 20 20 28 4d 29 3d 3d 30 Zero(M) (M)==0
1f880 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b .# define DbMask
1f890 4e 6f 6e 5a 65 72 6f 28 4d 29 20 20 20 28 4d 29 NonZero(M) (M)
1f8a0 21 3d 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a !=0.#endif../*.*
1f8b0 2a 20 41 6e 20 53 51 4c 20 70 61 72 73 65 72 20 * An SQL parser
1f8c0 63 6f 6e 74 65 78 74 2e 20 20 41 20 63 6f 70 79 context. A copy
1f8d0 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 of this structu
1f8e0 72 65 20 69 73 20 70 61 73 73 65 64 20 74 68 72 re is passed thr
1f8f0 6f 75 67 68 0a 2a 2a 20 74 68 65 20 70 61 72 73 ough.** the pars
1f900 65 72 20 61 6e 64 20 64 6f 77 6e 20 69 6e 74 6f er and down into
1f910 20 61 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 all the parser
1f920 61 63 74 69 6f 6e 20 72 6f 75 74 69 6e 65 20 69 action routine i
1f930 6e 20 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 63 61 n order to.** ca
1f940 72 72 79 20 61 72 6f 75 6e 64 20 69 6e 66 6f 72 rry around infor
1f950 6d 61 74 69 6f 6e 20 74 68 61 74 20 69 73 20 67 mation that is g
1f960 6c 6f 62 61 6c 20 74 6f 20 74 68 65 20 65 6e 74 lobal to the ent
1f970 69 72 65 20 70 61 72 73 65 2e 0a 2a 2a 0a 2a 2a ire parse..**.**
1f980 20 54 68 65 20 73 74 72 75 63 74 75 72 65 20 69 The structure i
1f990 73 20 64 69 76 69 64 65 64 20 69 6e 74 6f 20 74 s divided into t
1f9a0 77 6f 20 70 61 72 74 73 2e 20 20 57 68 65 6e 20 wo parts. When
1f9b0 74 68 65 20 70 61 72 73 65 72 20 61 6e 64 20 63 the parser and c
1f9c0 6f 64 65 0a 2a 2a 20 67 65 6e 65 72 61 74 65 20 ode.** generate
1f9d0 63 61 6c 6c 20 74 68 65 6d 73 65 6c 76 65 73 20 call themselves
1f9e0 72 65 63 75 72 73 69 76 65 6c 79 2c 20 74 68 65 recursively, the
1f9f0 20 66 69 72 73 74 20 70 61 72 74 20 6f 66 20 74 first part of t
1fa00 68 65 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 he structure.**
1fa10 69 73 20 63 6f 6e 73 74 61 6e 74 20 62 75 74 20 is constant but
1fa20 74 68 65 20 73 65 63 6f 6e 64 20 70 61 72 74 20 the second part
1fa30 69 73 20 72 65 73 65 74 20 61 74 20 74 68 65 20 is reset at the
1fa40 62 65 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65 6e beginning and en
1fa50 64 20 6f 66 0a 2a 2a 20 65 61 63 68 20 72 65 63 d of.** each rec
1fa60 75 72 73 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 ursion..**.** Th
1fa70 65 20 6e 54 61 62 6c 65 4c 6f 63 6b 20 61 6e 64 e nTableLock and
1fa80 20 61 54 61 62 6c 65 4c 6f 63 6b 20 76 61 72 69 aTableLock vari
1fa90 61 62 6c 65 73 20 61 72 65 20 6f 6e 6c 79 20 75 ables are only u
1faa0 73 65 64 20 69 66 20 74 68 65 20 73 68 61 72 65 sed if the share
1fab0 64 2d 63 61 63 68 65 0a 2a 2a 20 66 65 61 74 75 d-cache.** featu
1fac0 72 65 20 69 73 20 65 6e 61 62 6c 65 64 20 28 69 re is enabled (i
1fad0 66 20 73 71 6c 69 74 65 33 54 73 64 28 29 2d 3e f sqlite3Tsd()->
1fae0 75 73 65 53 68 61 72 65 64 44 61 74 61 20 69 73 useSharedData is
1faf0 20 74 72 75 65 29 2e 20 54 68 65 79 20 61 72 65 true). They are
1fb00 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 .** used to stor
1fb10 65 20 74 68 65 20 73 65 74 20 6f 66 20 74 61 62 e the set of tab
1fb20 6c 65 2d 6c 6f 63 6b 73 20 72 65 71 75 69 72 65 le-locks require
1fb30 64 20 62 79 20 74 68 65 20 73 74 61 74 65 6d 65 d by the stateme
1fb40 6e 74 20 62 65 69 6e 67 0a 2a 2a 20 63 6f 6d 70 nt being.** comp
1fb50 69 6c 65 64 2e 20 46 75 6e 63 74 69 6f 6e 20 73 iled. Function s
1fb60 71 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 qlite3TableLock(
1fb70 29 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 64 ) is used to add
1fb80 20 65 6e 74 72 69 65 73 20 74 6f 20 74 68 65 0a entries to the.
1fb90 2a 2a 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 72 75 ** list..*/.stru
1fba0 63 74 20 50 61 72 73 65 20 7b 0a 20 20 73 71 6c ct Parse {. sql
1fbb0 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 ite3 *db;
1fbc0 20 20 2f 2a 20 54 68 65 20 6d 61 69 6e 20 64 61 /* The main da
1fbd0 74 61 62 61 73 65 20 73 74 72 75 63 74 75 72 65 tabase structure
1fbe0 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 */. char *zErr
1fbf0 4d 73 67 3b 20 20 20 20 20 20 20 2f 2a 20 41 6e Msg; /* An
1fc00 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a error message *
1fc10 2f 0a 20 20 56 64 62 65 20 2a 70 56 64 62 65 3b /. Vdbe *pVdbe;
1fc20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 /* An e
1fc30 6e 67 69 6e 65 20 66 6f 72 20 65 78 65 63 75 74 ngine for execut
1fc40 69 6e 67 20 64 61 74 61 62 61 73 65 20 62 79 74 ing database byt
1fc50 65 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 72 ecode */. int r
1fc60 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
1fc70 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 66 /* Return code f
1fc80 72 6f 6d 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f rom execution */
1fc90 0a 20 20 75 38 20 63 6f 6c 4e 61 6d 65 73 53 65 . u8 colNamesSe
1fca0 74 3b 20 20 20 20 20 20 2f 2a 20 54 52 55 45 20 t; /* TRUE
1fcb0 61 66 74 65 72 20 4f 50 5f 43 6f 6c 75 6d 6e 4e after OP_ColumnN
1fcc0 61 6d 65 20 68 61 73 20 62 65 65 6e 20 69 73 73 ame has been iss
1fcd0 75 65 64 20 74 6f 20 70 56 64 62 65 20 2a 2f 0a ued to pVdbe */.
1fce0 20 20 75 38 20 63 68 65 63 6b 53 63 68 65 6d 61 u8 checkSchema
1fcf0 3b 20 20 20 20 20 20 2f 2a 20 43 61 75 73 65 73 ; /* Causes
1fd00 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20 63 schema cookie c
1fd10 68 65 63 6b 20 61 66 74 65 72 20 61 6e 20 65 72 heck after an er
1fd20 72 6f 72 20 2a 2f 0a 20 20 75 38 20 6e 65 73 74 ror */. u8 nest
1fd30 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ed; /*
1fd40 20 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 Number of neste
1fd50 64 20 63 61 6c 6c 73 20 74 6f 20 74 68 65 20 70 d calls to the p
1fd60 61 72 73 65 72 2f 63 6f 64 65 20 67 65 6e 65 72 arser/code gener
1fd70 61 74 6f 72 20 2a 2f 0a 20 20 75 38 20 6e 54 65 ator */. u8 nTe
1fd80 6d 70 52 65 67 3b 20 20 20 20 20 20 20 20 20 2f mpReg; /
1fd90 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 65 6d 70 * Number of temp
1fda0 6f 72 61 72 79 20 72 65 67 69 73 74 65 72 73 20 orary registers
1fdb0 69 6e 20 61 54 65 6d 70 52 65 67 5b 5d 20 2a 2f in aTempReg[] */
1fdc0 0a 20 20 75 38 20 69 73 4d 75 6c 74 69 57 72 69 . u8 isMultiWri
1fdd0 74 65 3b 20 20 20 20 20 2f 2a 20 54 72 75 65 20 te; /* True
1fde0 69 66 20 73 74 61 74 65 6d 65 6e 74 20 6d 61 79 if statement may
1fdf0 20 6d 6f 64 69 66 79 2f 69 6e 73 65 72 74 20 6d modify/insert m
1fe00 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a ultiple rows */.
1fe10 20 20 75 38 20 6d 61 79 41 62 6f 72 74 3b 20 20 u8 mayAbort;
1fe20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
1fe30 66 20 73 74 61 74 65 6d 65 6e 74 20 6d 61 79 20 f statement may
1fe40 74 68 72 6f 77 20 61 6e 20 41 42 4f 52 54 20 65 throw an ABORT e
1fe50 78 63 65 70 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 xception */. u8
1fe60 20 68 61 73 43 6f 6d 70 6f 75 6e 64 3b 20 20 20 hasCompound;
1fe70 20 20 20 2f 2a 20 4e 65 65 64 20 74 6f 20 69 6e /* Need to in
1fe80 76 6f 6b 65 20 63 6f 6e 76 65 72 74 43 6f 6d 70 voke convertComp
1fe90 6f 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 oundSelectToSubq
1fea0 75 65 72 79 28 29 20 2a 2f 0a 20 20 75 38 20 6f uery() */. u8 o
1feb0 6b 43 6f 6e 73 74 46 61 63 74 6f 72 3b 20 20 20 kConstFactor;
1fec0 20 2f 2a 20 4f 4b 20 74 6f 20 66 61 63 74 6f 72 /* OK to factor
1fed0 20 6f 75 74 20 63 6f 6e 73 74 61 6e 74 73 20 2a out constants *
1fee0 2f 0a 20 20 75 38 20 64 69 73 61 62 6c 65 4c 6f /. u8 disableLo
1fef0 6f 6b 61 73 69 64 65 3b 20 2f 2a 20 4e 75 6d 62 okaside; /* Numb
1ff00 65 72 20 6f 66 20 74 69 6d 65 73 20 6c 6f 6f 6b er of times look
1ff10 61 73 69 64 65 20 68 61 73 20 62 65 65 6e 20 64 aside has been d
1ff20 69 73 61 62 6c 65 64 20 2a 2f 0a 20 20 75 38 20 isabled */. u8
1ff30 6e 43 6f 6c 43 61 63 68 65 3b 20 20 20 20 20 20 nColCache;
1ff40 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 /* Number of e
1ff50 6e 74 72 69 65 73 20 69 6e 20 61 43 6f 6c 43 61 ntries in aColCa
1ff60 63 68 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e che[] */. int n
1ff70 52 61 6e 67 65 52 65 67 3b 20 20 20 20 20 20 20 RangeReg;
1ff80 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 74 /* Size of the t
1ff90 65 6d 70 6f 72 61 72 79 20 72 65 67 69 73 74 65 emporary registe
1ffa0 72 20 62 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e 74 r block */. int
1ffb0 20 69 52 61 6e 67 65 52 65 67 3b 20 20 20 20 20 iRangeReg;
1ffc0 20 20 2f 2a 20 46 69 72 73 74 20 72 65 67 69 73 /* First regis
1ffd0 74 65 72 20 69 6e 20 74 65 6d 70 6f 72 61 72 79 ter in temporary
1ffe0 20 72 65 67 69 73 74 65 72 20 62 6c 6f 63 6b 20 register block
1fff0 2a 2f 0a 20 20 69 6e 74 20 6e 45 72 72 3b 20 20 */. int nErr;
20000 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
20010 62 65 72 20 6f 66 20 65 72 72 6f 72 73 20 73 65 ber of errors se
20020 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 54 61 62 en */. int nTab
20030 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
20040 4e 75 6d 62 65 72 20 6f 66 20 70 72 65 76 69 6f Number of previo
20050 75 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 56 usly allocated V
20060 44 42 45 20 63 75 72 73 6f 72 73 20 2a 2f 0a 20 DBE cursors */.
20070 20 69 6e 74 20 6e 4d 65 6d 3b 20 20 20 20 20 20 int nMem;
20080 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
20090 6f 66 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 20 of memory cells
200a0 75 73 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 used so far */.
200b0 20 69 6e 74 20 6e 4f 70 41 6c 6c 6f 63 3b 20 20 int nOpAlloc;
200c0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
200d0 6f 66 20 73 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 of slots allocat
200e0 65 64 20 66 6f 72 20 56 64 62 65 2e 61 4f 70 5b ed for Vdbe.aOp[
200f0 5d 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 4f 70 41 ] */. int szOpA
20100 6c 6c 6f 63 3b 20 20 20 20 20 20 20 2f 2a 20 42 lloc; /* B
20110 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 73 ytes of memory s
20120 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 64 20 66 pace allocated f
20130 6f 72 20 56 64 62 65 2e 61 4f 70 5b 5d 20 2a 2f or Vdbe.aOp[] */
20140 0a 20 20 69 6e 74 20 69 53 65 6c 66 54 61 62 3b . int iSelfTab;
20150 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 /* Table
20160 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
20170 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 65 78 70 an index on exp
20180 72 2c 20 6f 72 20 6e 65 67 61 74 69 76 65 0a 20 r, or negative.
20190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
201a0 20 20 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 ** of the
201b0 62 61 73 65 20 72 65 67 69 73 74 65 72 20 64 75 base register du
201c0 72 69 6e 67 20 63 68 65 63 6b 2d 63 6f 6e 73 74 ring check-const
201d0 72 61 69 6e 74 20 65 76 61 6c 20 2a 2f 0a 20 20 raint eval */.
201e0 69 6e 74 20 69 43 61 63 68 65 4c 65 76 65 6c 3b int iCacheLevel;
201f0 20 20 20 20 20 2f 2a 20 43 6f 6c 43 61 63 68 65 /* ColCache
20200 20 76 61 6c 69 64 20 77 68 65 6e 20 61 43 6f 6c valid when aCol
20210 43 61 63 68 65 5b 5d 2e 69 4c 65 76 65 6c 3c 3d Cache[].iLevel<=
20220 69 43 61 63 68 65 4c 65 76 65 6c 20 2a 2f 0a 20 iCacheLevel */.
20230 20 69 6e 74 20 69 43 61 63 68 65 43 6e 74 3b 20 int iCacheCnt;
20240 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e 74 65 72 /* Counter
20250 20 75 73 65 64 20 74 6f 20 67 65 6e 65 72 61 74 used to generat
20260 65 20 61 43 6f 6c 43 61 63 68 65 5b 5d 2e 6c 72 e aColCache[].lr
20270 75 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 69 6e u values */. in
20280 74 20 6e 4c 61 62 65 6c 3b 20 20 20 20 20 20 20 t nLabel;
20290 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
202a0 6c 61 62 65 6c 73 20 75 73 65 64 20 2a 2f 0a 20 labels used */.
202b0 20 69 6e 74 20 2a 61 4c 61 62 65 6c 3b 20 20 20 int *aLabel;
202c0 20 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20 74 /* Space t
202d0 6f 20 68 6f 6c 64 20 74 68 65 20 6c 61 62 65 6c o hold the label
202e0 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
202f0 2a 70 43 6f 6e 73 74 45 78 70 72 3b 2f 2a 20 43 *pConstExpr;/* C
20300 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 73 69 onstant expressi
20310 6f 6e 73 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 63 ons */. Token c
20320 6f 6e 73 74 72 61 69 6e 74 4e 61 6d 65 3b 2f 2a onstraintName;/*
20330 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e Name of the con
20340 73 74 72 61 69 6e 74 20 63 75 72 72 65 6e 74 6c straint currentl
20350 79 20 62 65 69 6e 67 20 70 61 72 73 65 64 20 2a y being parsed *
20360 2f 0a 20 20 79 44 62 4d 61 73 6b 20 77 72 69 74 /. yDbMask writ
20370 65 4d 61 73 6b 3b 20 20 20 2f 2a 20 53 74 61 72 eMask; /* Star
20380 74 20 61 20 77 72 69 74 65 20 74 72 61 6e 73 61 t a write transa
20390 63 74 69 6f 6e 20 6f 6e 20 74 68 65 73 65 20 64 ction on these d
203a0 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 79 44 atabases */. yD
203b0 62 4d 61 73 6b 20 63 6f 6f 6b 69 65 4d 61 73 6b bMask cookieMask
203c0 3b 20 20 2f 2a 20 42 69 74 6d 61 73 6b 20 6f 66 ; /* Bitmask of
203d0 20 73 63 68 65 6d 61 20 76 65 72 69 66 69 65 64 schema verified
203e0 20 64 61 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 databases */.
203f0 69 6e 74 20 72 65 67 52 6f 77 69 64 3b 20 20 20 int regRowid;
20400 20 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 /* Register
20410 20 68 6f 6c 64 69 6e 67 20 72 6f 77 69 64 20 6f holding rowid o
20420 66 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 65 f CREATE TABLE e
20430 6e 74 72 79 20 2a 2f 0a 20 20 69 6e 74 20 72 65 ntry */. int re
20440 67 52 6f 6f 74 3b 20 20 20 20 20 20 20 20 20 2f gRoot; /
20450 2a 20 52 65 67 69 73 74 65 72 20 68 6f 6c 64 69 * Register holdi
20460 6e 67 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d ng root page num
20470 62 65 72 20 66 6f 72 20 6e 65 77 20 6f 62 6a 65 ber for new obje
20480 63 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 cts */. int nMa
20490 78 41 72 67 3b 20 20 20 20 20 20 20 20 20 2f 2a xArg; /*
204a0 20 4d 61 78 20 61 72 67 73 20 70 61 73 73 65 64 Max args passed
204b0 20 74 6f 20 75 73 65 72 20 66 75 6e 63 74 69 6f to user functio
204c0 6e 20 62 79 20 73 75 62 2d 70 72 6f 67 72 61 6d n by sub-program
204d0 20 2a 2f 0a 23 69 66 20 53 45 4c 45 43 54 54 52 */.#if SELECTTR
204e0 41 43 45 5f 45 4e 41 42 4c 45 44 0a 20 20 69 6e ACE_ENABLED. in
204f0 74 20 6e 53 65 6c 65 63 74 3b 20 20 20 20 20 20 t nSelect;
20500 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
20510 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 SELECT statement
20520 73 20 73 65 65 6e 20 2a 2f 0a 23 65 6e 64 69 66 s seen */.#endif
20530 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
20540 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
20550 45 0a 20 20 69 6e 74 20 6e 54 61 62 6c 65 4c 6f E. int nTableLo
20560 63 6b 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 ck; /* Nu
20570 6d 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 69 6e mber of locks in
20580 20 61 54 61 62 6c 65 4c 6f 63 6b 20 2a 2f 0a 20 aTableLock */.
20590 20 54 61 62 6c 65 4c 6f 63 6b 20 2a 61 54 61 62 TableLock *aTab
205a0 6c 65 4c 6f 63 6b 3b 20 2f 2a 20 52 65 71 75 69 leLock; /* Requi
205b0 72 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 20 red table locks
205c0 66 6f 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 for shared-cache
205d0 20 6d 6f 64 65 20 2a 2f 0a 23 65 6e 64 69 66 0a mode */.#endif.
205e0 20 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 AutoincInfo *p
205f0 41 69 6e 63 3b 20 20 2f 2a 20 49 6e 66 6f 72 6d Ainc; /* Inform
20600 61 74 69 6f 6e 20 61 62 6f 75 74 20 41 55 54 4f ation about AUTO
20610 49 4e 43 52 45 4d 45 4e 54 20 63 6f 75 6e 74 65 INCREMENT counte
20620 72 73 20 2a 2f 0a 20 20 50 61 72 73 65 20 2a 70 rs */. Parse *p
20630 54 6f 70 6c 65 76 65 6c 3b 20 20 20 20 2f 2a 20 Toplevel; /*
20640 50 61 72 73 65 20 73 74 72 75 63 74 75 72 65 20 Parse structure
20650 66 6f 72 20 6d 61 69 6e 20 70 72 6f 67 72 61 6d for main program
20660 20 28 6f 72 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 (or NULL) */.
20670 54 61 62 6c 65 20 2a 70 54 72 69 67 67 65 72 54 Table *pTriggerT
20680 61 62 3b 20 20 2f 2a 20 54 61 62 6c 65 20 74 72 ab; /* Table tr
20690 69 67 67 65 72 73 20 61 72 65 20 62 65 69 6e 67 iggers are being
206a0 20 63 6f 64 65 64 20 66 6f 72 20 2a 2f 0a 20 20 coded for */.
206b0 69 6e 74 20 61 64 64 72 43 72 54 61 62 3b 20 20 int addrCrTab;
206c0 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
206d0 6f 66 20 4f 50 5f 43 72 65 61 74 65 42 74 72 65 of OP_CreateBtre
206e0 65 20 6f 70 63 6f 64 65 20 6f 6e 20 43 52 45 41 e opcode on CREA
206f0 54 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 75 33 TE TABLE */. u3
20700 32 20 6e 51 75 65 72 79 4c 6f 6f 70 3b 20 20 20 2 nQueryLoop;
20710 20 20 20 2f 2a 20 45 73 74 20 6e 75 6d 62 65 72 /* Est number
20720 20 6f 66 20 69 74 65 72 61 74 69 6f 6e 73 20 6f of iterations o
20730 66 20 61 20 71 75 65 72 79 20 28 31 30 2a 6c 6f f a query (10*lo
20740 67 32 28 4e 29 29 20 2a 2f 0a 20 20 75 33 32 20 g2(N)) */. u32
20750 6f 6c 64 6d 61 73 6b 3b 20 20 20 20 20 20 20 20 oldmask;
20760 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 6f 6c 64 2e /* Mask of old.
20770 2a 20 63 6f 6c 75 6d 6e 73 20 72 65 66 65 72 65 * columns refere
20780 6e 63 65 64 20 2a 2f 0a 20 20 75 33 32 20 6e 65 nced */. u32 ne
20790 77 6d 61 73 6b 3b 20 20 20 20 20 20 20 20 20 2f wmask; /
207a0 2a 20 4d 61 73 6b 20 6f 66 20 6e 65 77 2e 2a 20 * Mask of new.*
207b0 63 6f 6c 75 6d 6e 73 20 72 65 66 65 72 65 6e 63 columns referenc
207c0 65 64 20 2a 2f 0a 20 20 75 38 20 65 54 72 69 67 ed */. u8 eTrig
207d0 67 65 72 4f 70 3b 20 20 20 20 20 20 20 2f 2a 20 gerOp; /*
207e0 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e TK_UPDATE, TK_IN
207f0 53 45 52 54 20 6f 72 20 54 4b 5f 44 45 4c 45 54 SERT or TK_DELET
20800 45 20 2a 2f 0a 20 20 75 38 20 65 4f 72 63 6f 6e E */. u8 eOrcon
20810 66 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 f; /* D
20820 65 66 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 efault ON CONFLI
20830 43 54 20 70 6f 6c 69 63 79 20 66 6f 72 20 74 72 CT policy for tr
20840 69 67 67 65 72 20 73 74 65 70 73 20 2a 2f 0a 20 igger steps */.
20850 20 75 38 20 64 69 73 61 62 6c 65 54 72 69 67 67 u8 disableTrigg
20860 65 72 73 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f ers; /* True to
20870 20 64 69 73 61 62 6c 65 20 74 72 69 67 67 65 72 disable trigger
20880 73 20 2a 2f 0a 0a 20 20 2f 2a 2a 2a 2a 2a 2a 2a s */.. /*******
20890 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
208a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
208b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
208c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
208d0 2a 2a 2a 0a 20 20 2a 2a 20 46 69 65 6c 64 73 20 ***. ** Fields
208e0 61 62 6f 76 65 20 6d 75 73 74 20 62 65 20 69 6e above must be in
208f0 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 7a 65 72 itialized to zer
20900 6f 2e 20 20 54 68 65 20 66 69 65 6c 64 73 20 74 o. The fields t
20910 68 61 74 20 66 6f 6c 6c 6f 77 2c 0a 20 20 2a 2a hat follow,. **
20920 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 62 65 67 down to the beg
20930 69 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 72 65 inning of the re
20940 63 75 72 73 69 76 65 20 73 65 63 74 69 6f 6e 2c cursive section,
20950 20 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 do not need to
20960 62 65 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 be. ** initiali
20970 7a 65 64 20 61 73 20 74 68 65 79 20 77 69 6c 6c zed as they will
20980 20 62 65 20 73 65 74 20 62 65 66 6f 72 65 20 62 be set before b
20990 65 69 6e 67 20 75 73 65 64 2e 20 20 54 68 65 20 eing used. The
209a0 62 6f 75 6e 64 61 72 79 20 69 73 0a 20 20 2a 2a boundary is. **
209b0 20 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 6f determined by o
209c0 66 66 73 65 74 6f 66 28 50 61 72 73 65 2c 61 43 ffsetof(Parse,aC
209d0 6f 6c 43 61 63 68 65 29 2e 0a 20 20 2a 2a 2a 2a olCache).. ****
209e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
209f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20a00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20a10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20a20 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 73 74 72 75 63 ******/.. struc
20a30 74 20 79 43 6f 6c 43 61 63 68 65 20 7b 0a 20 20 t yColCache {.
20a40 20 20 69 6e 74 20 69 54 61 62 6c 65 3b 20 20 20 int iTable;
20a50 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 /* Table
20a60 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 2a cursor number *
20a70 2f 0a 20 20 20 20 69 31 36 20 69 43 6f 6c 75 6d /. i16 iColum
20a80 6e 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 n; /* T
20a90 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 able column numb
20aa0 65 72 20 2a 2f 0a 20 20 20 20 75 38 20 74 65 6d er */. u8 tem
20ab0 70 52 65 67 3b 20 20 20 20 20 20 20 20 20 20 20 pReg;
20ac0 2f 2a 20 69 52 65 67 20 69 73 20 61 20 74 65 6d /* iReg is a tem
20ad0 70 20 72 65 67 69 73 74 65 72 20 74 68 61 74 20 p register that
20ae0 6e 65 65 64 73 20 74 6f 20 62 65 20 66 72 65 65 needs to be free
20af0 64 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4c 65 d */. int iLe
20b00 76 65 6c 3b 20 20 20 20 20 20 20 20 20 20 20 2f vel; /
20b10 2a 20 4e 65 73 74 69 6e 67 20 6c 65 76 65 6c 20 * Nesting level
20b20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 52 65 67 3b */. int iReg;
20b30 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
20b40 52 65 67 20 77 69 74 68 20 76 61 6c 75 65 20 6f Reg with value o
20b50 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 2e 20 30 f this column. 0
20b60 20 6d 65 61 6e 73 20 6e 6f 6e 65 2e 20 2a 2f 0a means none. */.
20b70 20 20 20 20 69 6e 74 20 6c 72 75 3b 20 20 20 20 int lru;
20b80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 61 /* Lea
20b90 73 74 20 72 65 63 65 6e 74 6c 79 20 75 73 65 64 st recently used
20ba0 20 65 6e 74 72 79 20 68 61 73 20 74 68 65 20 73 entry has the s
20bb0 6d 61 6c 6c 65 73 74 20 76 61 6c 75 65 20 2a 2f mallest value */
20bc0 0a 20 20 7d 20 61 43 6f 6c 43 61 63 68 65 5b 53 . } aColCache[S
20bd0 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 QLITE_N_COLCACHE
20be0 5d 3b 20 20 2f 2a 20 4f 6e 65 20 66 6f 72 20 65 ]; /* One for e
20bf0 61 63 68 20 63 6f 6c 75 6d 6e 20 63 61 63 68 65 ach column cache
20c00 20 65 6e 74 72 79 20 2a 2f 0a 20 20 69 6e 74 20 entry */. int
20c10 61 54 65 6d 70 52 65 67 5b 38 5d 3b 20 20 20 20 aTempReg[8];
20c20 20 20 20 20 2f 2a 20 48 6f 6c 64 69 6e 67 20 61 /* Holding a
20c30 72 65 61 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 rea for temporar
20c40 79 20 72 65 67 69 73 74 65 72 73 20 2a 2f 0a 20 y registers */.
20c50 20 54 6f 6b 65 6e 20 73 4e 61 6d 65 54 6f 6b 65 Token sNameToke
20c60 6e 3b 20 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 n; /* Toke
20c70 6e 20 77 69 74 68 20 75 6e 71 75 61 6c 69 66 69 n with unqualifi
20c80 65 64 20 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 ed schema object
20c90 20 6e 61 6d 65 20 2a 2f 0a 0a 20 20 2f 2a 2a 2a name */.. /***
20ca0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20cb0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20cc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20cd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20ce0 2a 2a 2a 2a 2a 0a 20 20 2a 2a 20 41 62 6f 76 65 *****. ** Above
20cf0 20 69 73 20 63 6f 6e 73 74 61 6e 74 20 62 65 74 is constant bet
20d00 77 65 65 6e 20 72 65 63 75 72 73 69 6f 6e 73 2e ween recursions.
20d10 20 20 42 65 6c 6f 77 20 69 73 20 72 65 73 65 74 Below is reset
20d20 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 before and afte
20d30 72 0a 20 20 2a 2a 20 65 61 63 68 20 72 65 63 75 r. ** each recu
20d40 72 73 69 6f 6e 2e 20 20 54 68 65 20 62 6f 75 6e rsion. The boun
20d50 64 61 72 79 20 62 65 74 77 65 65 6e 20 74 68 65 dary between the
20d60 73 65 20 74 77 6f 20 72 65 67 69 6f 6e 73 20 69 se two regions i
20d70 73 20 64 65 74 65 72 6d 69 6e 65 64 0a 20 20 2a s determined. *
20d80 2a 20 75 73 69 6e 67 20 6f 66 66 73 65 74 6f 66 * using offsetof
20d90 28 50 61 72 73 65 2c 73 4c 61 73 74 54 6f 6b 65 (Parse,sLastToke
20da0 6e 29 20 73 6f 20 74 68 65 20 73 4c 61 73 74 54 n) so the sLastT
20db0 6f 6b 65 6e 20 66 69 65 6c 64 20 6d 75 73 74 20 oken field must
20dc0 62 65 20 74 68 65 0a 20 20 2a 2a 20 66 69 72 73 be the. ** firs
20dd0 74 20 66 69 65 6c 64 20 69 6e 20 74 68 65 20 72 t field in the r
20de0 65 63 75 72 73 69 76 65 20 72 65 67 69 6f 6e 2e ecursive region.
20df0 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a . *************
20e00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20e10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20e20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20e30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 ***********/..
20e40 54 6f 6b 65 6e 20 73 4c 61 73 74 54 6f 6b 65 6e Token sLastToken
20e50 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6c ; /* The l
20e60 61 73 74 20 74 6f 6b 65 6e 20 70 61 72 73 65 64 ast token parsed
20e70 20 2a 2f 0a 20 20 79 6e 56 61 72 20 6e 56 61 72 */. ynVar nVar
20e80 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
20e90 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 27 3f 27 /* Number of '?'
20ea0 20 76 61 72 69 61 62 6c 65 73 20 73 65 65 6e 20 variables seen
20eb0 69 6e 20 74 68 65 20 53 51 4c 20 73 6f 20 66 61 in the SQL so fa
20ec0 72 20 2a 2f 0a 20 20 75 38 20 69 50 6b 53 6f 72 r */. u8 iPkSor
20ed0 74 4f 72 64 65 72 3b 20 20 20 20 20 20 20 20 20 tOrder;
20ee0 20 2f 2a 20 41 53 43 20 6f 72 20 44 45 53 43 20 /* ASC or DESC
20ef0 66 6f 72 20 49 4e 54 45 47 45 52 20 50 52 49 4d for INTEGER PRIM
20f00 41 52 59 20 4b 45 59 20 2a 2f 0a 20 20 75 38 20 ARY KEY */. u8
20f10 65 78 70 6c 61 69 6e 3b 20 20 20 20 20 20 20 20 explain;
20f20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
20f30 66 20 74 68 65 20 45 58 50 4c 41 49 4e 20 66 6c f the EXPLAIN fl
20f40 61 67 20 69 73 20 66 6f 75 6e 64 20 6f 6e 20 74 ag is found on t
20f50 68 65 20 71 75 65 72 79 20 2a 2f 0a 23 69 66 6e he query */.#ifn
20f60 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
20f70 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 75 VIRTUALTABLE. u
20f80 38 20 64 65 63 6c 61 72 65 56 74 61 62 3b 20 20 8 declareVtab;
20f90 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
20fa0 20 69 66 20 69 6e 73 69 64 65 20 73 71 6c 69 74 if inside sqlit
20fb0 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 62 28 e3_declare_vtab(
20fc0 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 74 61 62 ) */. int nVtab
20fd0 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 Lock;
20fe0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 76 69 /* Number of vi
20ff0 72 74 75 61 6c 20 74 61 62 6c 65 73 20 74 6f 20 rtual tables to
21000 6c 6f 63 6b 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 lock */.#endif.
21010 20 69 6e 74 20 6e 48 65 69 67 68 74 3b 20 20 20 int nHeight;
21020 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 /* Ex
21030 70 72 65 73 73 69 6f 6e 20 74 72 65 65 20 68 65 pression tree he
21040 69 67 68 74 20 6f 66 20 63 75 72 72 65 6e 74 20 ight of current
21050 73 75 62 2d 73 65 6c 65 63 74 20 2a 2f 0a 23 69 sub-select */.#i
21060 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
21070 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69 6e 74 20 T_EXPLAIN. int
21080 69 53 65 6c 65 63 74 49 64 3b 20 20 20 20 20 20 iSelectId;
21090 20 20 20 20 20 20 2f 2a 20 49 44 20 6f 66 20 63 /* ID of c
210a0 75 72 72 65 6e 74 20 73 65 6c 65 63 74 20 66 6f urrent select fo
210b0 72 20 45 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 r EXPLAIN output
210c0 20 2a 2f 0a 20 20 69 6e 74 20 69 4e 65 78 74 53 */. int iNextS
210d0 65 6c 65 63 74 49 64 3b 20 20 20 20 20 20 20 20 electId;
210e0 2f 2a 20 4e 65 78 74 20 61 76 61 69 6c 61 62 6c /* Next availabl
210f0 65 20 73 65 6c 65 63 74 20 49 44 20 66 6f 72 20 e select ID for
21100 45 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 20 2a EXPLAIN output *
21110 2f 0a 23 65 6e 64 69 66 0a 20 20 56 4c 69 73 74 /.#endif. VList
21120 20 2a 70 56 4c 69 73 74 3b 20 20 20 20 20 20 20 *pVList;
21130 20 20 20 20 20 2f 2a 20 4d 61 70 70 69 6e 67 20 /* Mapping
21140 62 65 74 77 65 65 6e 20 76 61 72 69 61 62 6c 65 between variable
21150 20 6e 61 6d 65 73 20 61 6e 64 20 6e 75 6d 62 65 names and numbe
21160 72 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 52 rs */. Vdbe *pR
21170 65 70 72 65 70 61 72 65 3b 20 20 20 20 20 20 20 eprepare;
21180 20 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 72 65 /* VM being re
21190 70 72 65 70 61 72 65 64 20 28 73 71 6c 69 74 65 prepared (sqlite
211a0 33 52 65 70 72 65 70 61 72 65 28 29 29 20 2a 2f 3Reprepare()) */
211b0 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
211c0 54 61 69 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 Tail; /*
211d0 41 6c 6c 20 53 51 4c 20 74 65 78 74 20 70 61 73 All SQL text pas
211e0 74 20 74 68 65 20 6c 61 73 74 20 73 65 6d 69 63 t the last semic
211f0 6f 6c 6f 6e 20 70 61 72 73 65 64 20 2a 2f 0a 20 olon parsed */.
21200 20 54 61 62 6c 65 20 2a 70 4e 65 77 54 61 62 6c Table *pNewTabl
21210 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 e; /* A
21220 74 61 62 6c 65 20 62 65 69 6e 67 20 63 6f 6e 73 table being cons
21230 74 72 75 63 74 65 64 20 62 79 20 43 52 45 41 54 tructed by CREAT
21240 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 54 72 69 E TABLE */. Tri
21250 67 67 65 72 20 2a 70 4e 65 77 54 72 69 67 67 65 gger *pNewTrigge
21260 72 3b 20 20 20 20 20 2f 2a 20 54 72 69 67 67 65 r; /* Trigge
21270 72 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 75 63 r under construc
21280 74 20 62 79 20 61 20 43 52 45 41 54 45 20 54 52 t by a CREATE TR
21290 49 47 47 45 52 20 2a 2f 0a 20 20 63 6f 6e 73 74 IGGER */. const
212a0 20 63 68 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 char *zAuthCont
212b0 65 78 74 3b 20 2f 2a 20 54 68 65 20 36 74 68 20 ext; /* The 6th
212c0 70 61 72 61 6d 65 74 65 72 20 74 6f 20 64 62 2d parameter to db-
212d0 3e 78 41 75 74 68 20 63 61 6c 6c 62 61 63 6b 73 >xAuth callbacks
212e0 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */.#ifndef SQLI
212f0 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
21300 41 42 4c 45 0a 20 20 54 6f 6b 65 6e 20 73 41 72 ABLE. Token sAr
21310 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
21320 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 74 65 78 /* Complete tex
21330 74 20 6f 66 20 61 20 6d 6f 64 75 6c 65 20 61 72 t of a module ar
21340 67 75 6d 65 6e 74 20 2a 2f 0a 20 20 54 61 62 6c gument */. Tabl
21350 65 20 2a 2a 61 70 56 74 61 62 4c 6f 63 6b 3b 20 e **apVtabLock;
21360 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
21370 20 74 6f 20 76 69 72 74 75 61 6c 20 74 61 62 6c to virtual tabl
21380 65 73 20 6e 65 65 64 69 6e 67 20 6c 6f 63 6b 69 es needing locki
21390 6e 67 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 54 ng */.#endif. T
213a0 61 62 6c 65 20 2a 70 5a 6f 6d 62 69 65 54 61 62 able *pZombieTab
213b0 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 ; /* List
213c0 20 6f 66 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 of Table object
213d0 73 20 74 6f 20 64 65 6c 65 74 65 20 61 66 74 65 s to delete afte
213e0 72 20 63 6f 64 65 20 67 65 6e 20 2a 2f 0a 20 20 r code gen */.
213f0 54 72 69 67 67 65 72 50 72 67 20 2a 70 54 72 69 TriggerPrg *pTri
21400 67 67 65 72 50 72 67 3b 20 20 2f 2a 20 4c 69 6e ggerPrg; /* Lin
21410 6b 65 64 20 6c 69 73 74 20 6f 66 20 63 6f 64 65 ked list of code
21420 64 20 74 72 69 67 67 65 72 73 20 2a 2f 0a 20 20 d triggers */.
21430 57 69 74 68 20 2a 70 57 69 74 68 3b 20 20 20 20 With *pWith;
21440 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
21450 72 65 6e 74 20 57 49 54 48 20 63 6c 61 75 73 65 rent WITH clause
21460 2c 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 57 , or NULL */. W
21470 69 74 68 20 2a 70 57 69 74 68 54 6f 46 72 65 65 ith *pWithToFree
21480 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 ; /* Free
21490 20 74 68 69 73 20 57 49 54 48 20 6f 62 6a 65 63 this WITH objec
214a0 74 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 t at the end of
214b0 74 68 65 20 70 61 72 73 65 20 2a 2f 0a 7d 3b 0a the parse */.};.
214c0 0a 2f 2a 0a 2a 2a 20 53 69 7a 65 73 20 61 6e 64 ./*.** Sizes and
214d0 20 70 6f 69 6e 74 65 72 73 20 6f 66 20 76 61 72 pointers of var
214e0 69 6f 75 73 20 70 61 72 74 73 20 6f 66 20 74 68 ious parts of th
214f0 65 20 50 61 72 73 65 20 6f 62 6a 65 63 74 2e 0a e Parse object..
21500 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 52 53 45 */.#define PARSE
21510 5f 48 44 52 5f 53 5a 20 6f 66 66 73 65 74 6f 66 _HDR_SZ offsetof
21520 28 50 61 72 73 65 2c 61 43 6f 6c 43 61 63 68 65 (Parse,aColCache
21530 29 20 2f 2a 20 52 65 63 75 72 73 69 76 65 20 70 ) /* Recursive p
21540 61 72 74 20 77 2f 6f 20 61 43 6f 6c 43 61 63 68 art w/o aColCach
21550 65 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 52 53 e*/.#define PARS
21560 45 5f 52 45 43 55 52 53 45 5f 53 5a 20 6f 66 66 E_RECURSE_SZ off
21570 73 65 74 6f 66 28 50 61 72 73 65 2c 73 4c 61 73 setof(Parse,sLas
21580 74 54 6f 6b 65 6e 29 20 20 20 20 2f 2a 20 52 65 tToken) /* Re
21590 63 75 72 73 69 76 65 20 70 61 72 74 20 2a 2f 0a cursive part */.
215a0 23 64 65 66 69 6e 65 20 50 41 52 53 45 5f 54 41 #define PARSE_TA
215b0 49 4c 5f 53 5a 20 28 73 69 7a 65 6f 66 28 50 61 IL_SZ (sizeof(Pa
215c0 72 73 65 29 2d 50 41 52 53 45 5f 52 45 43 55 52 rse)-PARSE_RECUR
215d0 53 45 5f 53 5a 29 20 2f 2a 20 4e 6f 6e 2d 72 65 SE_SZ) /* Non-re
215e0 63 75 72 73 69 76 65 20 70 61 72 74 20 2a 2f 0a cursive part */.
215f0 23 64 65 66 69 6e 65 20 50 41 52 53 45 5f 54 41 #define PARSE_TA
21600 49 4c 28 58 29 20 28 28 28 63 68 61 72 2a 29 28 IL(X) (((char*)(
21610 58 29 29 2b 50 41 52 53 45 5f 52 45 43 55 52 53 X))+PARSE_RECURS
21620 45 5f 53 5a 29 20 20 2f 2a 20 50 6f 69 6e 74 65 E_SZ) /* Pointe
21630 72 20 74 6f 20 74 61 69 6c 20 2a 2f 0a 0a 2f 2a r to tail */../*
21640 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 .** Return true
21650 69 66 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 73 if currently ins
21660 69 64 65 20 61 6e 20 73 71 6c 69 74 65 33 5f 64 ide an sqlite3_d
21670 65 63 6c 61 72 65 5f 76 74 61 62 28 29 20 63 61 eclare_vtab() ca
21680 6c 6c 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ll..*/.#ifdef SQ
21690 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
216a0 4c 54 41 42 4c 45 0a 20 20 23 64 65 66 69 6e 65 LTABLE. #define
216b0 20 49 4e 5f 44 45 43 4c 41 52 45 5f 56 54 41 42 IN_DECLARE_VTAB
216c0 20 30 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 0.#else. #defi
216d0 6e 65 20 49 4e 5f 44 45 43 4c 41 52 45 5f 56 54 ne IN_DECLARE_VT
216e0 41 42 20 28 70 50 61 72 73 65 2d 3e 64 65 63 6c AB (pParse->decl
216f0 61 72 65 56 74 61 62 29 0a 23 65 6e 64 69 66 0a areVtab).#endif.
21700 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
21710 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
21720 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 63 61 ing structure ca
21730 6e 20 62 65 20 64 65 63 6c 61 72 65 64 20 6f 6e n be declared on
21740 20 61 20 73 74 61 63 6b 20 61 6e 64 20 75 73 65 a stack and use
21750 64 0a 2a 2a 20 74 6f 20 73 61 76 65 20 74 68 65 d.** to save the
21760 20 50 61 72 73 65 2e 7a 41 75 74 68 43 6f 6e 74 Parse.zAuthCont
21770 65 78 74 20 76 61 6c 75 65 20 73 6f 20 74 68 61 ext value so tha
21780 74 20 69 74 20 63 61 6e 20 62 65 20 72 65 73 74 t it can be rest
21790 6f 72 65 64 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 ored later..*/.s
217a0 74 72 75 63 74 20 41 75 74 68 43 6f 6e 74 65 78 truct AuthContex
217b0 74 20 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 t {. const char
217c0 20 2a 7a 41 75 74 68 43 6f 6e 74 65 78 74 3b 20 *zAuthContext;
217d0 20 20 2f 2a 20 50 75 74 20 73 61 76 65 64 20 50 /* Put saved P
217e0 61 72 73 65 2e 7a 41 75 74 68 43 6f 6e 74 65 78 arse.zAuthContex
217f0 74 20 68 65 72 65 20 2a 2f 0a 20 20 50 61 72 73 t here */. Pars
21800 65 20 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 e *pParse;
21810 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 50 /* The P
21820 61 72 73 65 20 73 74 72 75 63 74 75 72 65 20 2a arse structure *
21830 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 42 69 74 66 /.};../*.** Bitf
21840 69 65 6c 64 20 66 6c 61 67 73 20 66 6f 72 20 50 ield flags for P
21850 35 20 76 61 6c 75 65 20 69 6e 20 76 61 72 69 6f 5 value in vario
21860 75 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2a 0a 2a us opcodes..**.*
21870 2a 20 56 61 6c 75 65 20 63 6f 6e 73 74 72 61 69 * Value constrai
21880 6e 74 73 20 28 65 6e 66 6f 72 63 65 64 20 76 69 nts (enforced vi
21890 61 20 61 73 73 65 72 74 28 29 29 3a 0a 2a 2a 20 a assert()):.**
218a0 20 20 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 48 OPFLAG_LENGTH
218b0 41 52 47 20 20 20 20 3d 3d 20 53 51 4c 49 54 45 ARG == SQLITE
218c0 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 0a 2a 2a 20 _FUNC_LENGTH.**
218d0 20 20 20 4f 50 46 4c 41 47 5f 54 59 50 45 4f 46 OPFLAG_TYPEOF
218e0 41 52 47 20 20 20 20 3d 3d 20 53 51 4c 49 54 45 ARG == SQLITE
218f0 5f 46 55 4e 43 5f 54 59 50 45 4f 46 0a 2a 2a 20 _FUNC_TYPEOF.**
21900 20 20 20 4f 50 46 4c 41 47 5f 42 55 4c 4b 43 53 OPFLAG_BULKCS
21910 52 20 20 20 20 20 20 3d 3d 20 42 54 52 45 45 5f R == BTREE_
21920 42 55 4c 4b 4c 4f 41 44 0a 2a 2a 20 20 20 20 4f BULKLOAD.** O
21930 50 46 4c 41 47 5f 53 45 45 4b 45 51 20 20 20 20 PFLAG_SEEKEQ
21940 20 20 20 3d 3d 20 42 54 52 45 45 5f 53 45 45 4b == BTREE_SEEK
21950 5f 45 51 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 _EQ.** OPFLAG
21960 5f 46 4f 52 44 45 4c 45 54 45 20 20 20 20 3d 3d _FORDELETE ==
21970 20 42 54 52 45 45 5f 46 4f 52 44 45 4c 45 54 45 BTREE_FORDELETE
21980 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 53 41 .** OPFLAG_SA
21990 56 45 50 4f 53 49 54 49 4f 4e 20 3d 3d 20 42 54 VEPOSITION == BT
219a0 52 45 45 5f 53 41 56 45 50 4f 53 49 54 49 4f 4e REE_SAVEPOSITION
219b0 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 41 55 .** OPFLAG_AU
219c0 58 44 45 4c 45 54 45 20 20 20 20 3d 3d 20 42 54 XDELETE == BT
219d0 52 45 45 5f 41 55 58 44 45 4c 45 54 45 0a 2a 2f REE_AUXDELETE.*/
219e0 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
219f0 4e 43 48 41 4e 47 45 20 20 20 20 20 20 20 30 78 NCHANGE 0x
21a00 30 31 20 20 20 20 2f 2a 20 4f 50 5f 49 6e 73 65 01 /* OP_Inse
21a10 72 74 3a 20 53 65 74 20 74 6f 20 75 70 64 61 74 rt: Set to updat
21a20 65 20 64 62 2d 3e 6e 43 68 61 6e 67 65 20 2a 2f e db->nChange */
21a30 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
21a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21a50 20 20 20 20 20 20 2f 2a 20 41 6c 73 6f 20 75 73 /* Also us
21a60 65 64 20 69 6e 20 50 32 20 28 6e 6f 74 20 50 35 ed in P2 (not P5
21a70 29 20 6f 66 20 4f 50 5f 44 65 6c 65 74 65 20 2a ) of OP_Delete *
21a80 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
21a90 5f 45 50 48 45 4d 20 20 20 20 20 20 20 20 20 30 _EPHEM 0
21aa0 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c x01 /* OP_Col
21ab0 75 6d 6e 3a 20 45 70 68 65 6d 65 72 61 6c 20 6f umn: Ephemeral o
21ac0 75 74 70 75 74 20 69 73 20 6f 6b 20 2a 2f 0a 23 utput is ok */.#
21ad0 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 4c 41 define OPFLAG_LA
21ae0 53 54 52 4f 57 49 44 20 20 20 20 20 30 78 32 30 STROWID 0x20
21af0 20 20 20 20 2f 2a 20 53 65 74 20 74 6f 20 75 70 /* Set to up
21b00 64 61 74 65 20 64 62 2d 3e 6c 61 73 74 52 6f 77 date db->lastRow
21b10 69 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 id */.#define OP
21b20 46 4c 41 47 5f 49 53 55 50 44 41 54 45 20 20 20 FLAG_ISUPDATE
21b30 20 20 20 30 78 30 34 20 20 20 20 2f 2a 20 54 68 0x04 /* Th
21b40 69 73 20 4f 50 5f 49 6e 73 65 72 74 20 69 73 20 is OP_Insert is
21b50 61 6e 20 73 71 6c 20 55 50 44 41 54 45 20 2a 2f an sql UPDATE */
21b60 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
21b70 41 50 50 45 4e 44 20 20 20 20 20 20 20 20 30 78 APPEND 0x
21b80 30 38 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 08 /* This is
21b90 20 6c 69 6b 65 6c 79 20 74 6f 20 62 65 20 61 6e likely to be an
21ba0 20 61 70 70 65 6e 64 20 2a 2f 0a 23 64 65 66 69 append */.#defi
21bb0 6e 65 20 4f 50 46 4c 41 47 5f 55 53 45 53 45 45 ne OPFLAG_USESEE
21bc0 4b 52 45 53 55 4c 54 20 30 78 31 30 20 20 20 20 KRESULT 0x10
21bd0 2f 2a 20 54 72 79 20 74 6f 20 61 76 6f 69 64 20 /* Try to avoid
21be0 61 20 73 65 65 6b 20 69 6e 20 42 74 72 65 65 49 a seek in BtreeI
21bf0 6e 73 65 72 74 28 29 20 2a 2f 0a 23 64 65 66 69 nsert() */.#defi
21c00 6e 65 20 4f 50 46 4c 41 47 5f 49 53 4e 4f 4f 50 ne OPFLAG_ISNOOP
21c10 20 20 20 20 20 20 20 20 30 78 34 30 20 20 20 20 0x40
21c20 2f 2a 20 4f 50 5f 44 65 6c 65 74 65 20 64 6f 65 /* OP_Delete doe
21c30 73 20 70 72 65 2d 75 70 64 61 74 65 2d 68 6f 6f s pre-update-hoo
21c40 6b 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e k only */.#defin
21c50 65 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 48 41 e OPFLAG_LENGTHA
21c60 52 47 20 20 20 20 20 30 78 34 30 20 20 20 20 2f RG 0x40 /
21c70 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c 79 * OP_Column only
21c80 20 75 73 65 64 20 66 6f 72 20 6c 65 6e 67 74 68 used for length
21c90 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 () */.#define OP
21ca0 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 20 20 FLAG_TYPEOFARG
21cb0 20 20 20 30 78 38 30 20 20 20 20 2f 2a 20 4f 50 0x80 /* OP
21cc0 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 65 _Column only use
21cd0 64 20 66 6f 72 20 74 79 70 65 6f 66 28 29 20 2a d for typeof() *
21ce0 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
21cf0 5f 42 55 4c 4b 43 53 52 20 20 20 20 20 20 20 30 _BULKCSR 0
21d00 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 x01 /* OP_Ope
21d10 6e 2a 2a 20 75 73 65 64 20 74 6f 20 6f 70 65 6e n** used to open
21d20 20 62 75 6c 6b 20 63 75 72 73 6f 72 20 2a 2f 0a bulk cursor */.
21d30 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 53 #define OPFLAG_S
21d40 45 45 4b 45 51 20 20 20 20 20 20 20 20 30 78 30 EEKEQ 0x0
21d50 32 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 2a 2 /* OP_Open*
21d60 2a 20 63 75 72 73 6f 72 20 75 73 65 73 20 45 51 * cursor uses EQ
21d70 20 73 65 65 6b 20 6f 6e 6c 79 20 2a 2f 0a 23 64 seek only */.#d
21d80 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 46 4f 52 efine OPFLAG_FOR
21d90 44 45 4c 45 54 45 20 20 20 20 20 30 78 30 38 20 DELETE 0x08
21da0 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 20 73 68 /* OP_Open sh
21db0 6f 75 6c 64 20 75 73 65 20 42 54 52 45 45 5f 46 ould use BTREE_F
21dc0 4f 52 44 45 4c 45 54 45 20 2a 2f 0a 23 64 65 66 ORDELETE */.#def
21dd0 69 6e 65 20 4f 50 46 4c 41 47 5f 50 32 49 53 52 ine OPFLAG_P2ISR
21de0 45 47 20 20 20 20 20 20 20 30 78 31 30 20 20 20 EG 0x10
21df0 20 2f 2a 20 50 32 20 74 6f 20 4f 50 5f 4f 70 65 /* P2 to OP_Ope
21e00 6e 2a 2a 20 69 73 20 61 20 72 65 67 69 73 74 65 n** is a registe
21e10 72 20 6e 75 6d 62 65 72 20 2a 2f 0a 23 64 65 66 r number */.#def
21e20 69 6e 65 20 4f 50 46 4c 41 47 5f 50 45 52 4d 55 ine OPFLAG_PERMU
21e30 54 45 20 20 20 20 20 20 20 30 78 30 31 20 20 20 TE 0x01
21e40 20 2f 2a 20 4f 50 5f 43 6f 6d 70 61 72 65 3a 20 /* OP_Compare:
21e50 75 73 65 20 74 68 65 20 70 65 72 6d 75 74 61 74 use the permutat
21e60 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ion */.#define O
21e70 50 46 4c 41 47 5f 53 41 56 45 50 4f 53 49 54 49 PFLAG_SAVEPOSITI
21e80 4f 4e 20 20 30 78 30 32 20 20 20 20 2f 2a 20 4f ON 0x02 /* O
21e90 50 5f 44 65 6c 65 74 65 2f 49 6e 73 65 72 74 3a P_Delete/Insert:
21ea0 20 73 61 76 65 20 63 75 72 73 6f 72 20 70 6f 73 save cursor pos
21eb0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c */.#define OPFL
21ec0 41 47 5f 41 55 58 44 45 4c 45 54 45 20 20 20 20 AG_AUXDELETE
21ed0 20 30 78 30 34 20 20 20 20 2f 2a 20 4f 50 5f 44 0x04 /* OP_D
21ee0 65 6c 65 74 65 3a 20 69 6e 64 65 78 20 69 6e 20 elete: index in
21ef0 61 20 44 45 4c 45 54 45 20 6f 70 20 2a 2f 0a 23 a DELETE op */.#
21f00 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 4e 4f define OPFLAG_NO
21f10 43 48 4e 47 5f 4d 41 47 49 43 20 20 30 78 36 64 CHNG_MAGIC 0x6d
21f20 20 20 20 20 2f 2a 20 4f 50 5f 4d 61 6b 65 52 65 /* OP_MakeRe
21f30 63 6f 72 64 3a 20 73 65 72 69 61 6c 74 79 70 65 cord: serialtype
21f40 20 31 30 20 69 73 20 6f 6b 20 2a 2f 0a 0a 2f 2a 10 is ok */../*
21f50 0a 20 2a 20 45 61 63 68 20 74 72 69 67 67 65 72 . * Each trigger
21f60 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 20 present in the
21f70 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 database schema
21f80 69 73 20 73 74 6f 72 65 64 20 61 73 20 61 6e 20 is stored as an
21f90 69 6e 73 74 61 6e 63 65 20 6f 66 0a 20 2a 20 73 instance of. * s
21fa0 74 72 75 63 74 20 54 72 69 67 67 65 72 2e 0a 20 truct Trigger..
21fb0 2a 0a 20 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f *. * Pointers to
21fc0 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 73 74 instances of st
21fd0 72 75 63 74 20 54 72 69 67 67 65 72 20 61 72 65 ruct Trigger are
21fe0 20 73 74 6f 72 65 64 20 69 6e 20 74 77 6f 20 77 stored in two w
21ff0 61 79 73 2e 0a 20 2a 20 31 2e 20 49 6e 20 74 68 ays.. * 1. In th
22000 65 20 22 74 72 69 67 48 61 73 68 22 20 68 61 73 e "trigHash" has
22010 68 20 74 61 62 6c 65 20 28 70 61 72 74 20 6f 66 h table (part of
22020 20 74 68 65 20 73 71 6c 69 74 65 33 2a 20 74 68 the sqlite3* th
22030 61 74 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 at represents th
22040 65 0a 20 2a 20 20 20 20 64 61 74 61 62 61 73 65 e. * database
22050 29 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 54 ). This allows T
22060 72 69 67 67 65 72 20 73 74 72 75 63 74 75 72 65 rigger structure
22070 73 20 74 6f 20 62 65 20 72 65 74 72 69 65 76 65 s to be retrieve
22080 64 20 62 79 20 6e 61 6d 65 2e 0a 20 2a 20 32 2e d by name.. * 2.
22090 20 41 6c 6c 20 74 72 69 67 67 65 72 73 20 61 73 All triggers as
220a0 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 sociated with a
220b0 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 66 6f 72 single table for
220c0 6d 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 2c m a linked list,
220d0 20 75 73 69 6e 67 20 74 68 65 0a 20 2a 20 20 20 using the. *
220e0 20 70 4e 65 78 74 20 6d 65 6d 62 65 72 20 6f 66 pNext member of
220f0 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 2e struct Trigger.
22100 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 A pointer to th
22110 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 e first element
22120 6f 66 20 74 68 65 0a 20 2a 20 20 20 20 6c 69 6e of the. * lin
22130 6b 65 64 20 6c 69 73 74 20 69 73 20 73 74 6f 72 ked list is stor
22140 65 64 20 61 73 20 74 68 65 20 22 70 54 72 69 67 ed as the "pTrig
22150 67 65 72 22 20 6d 65 6d 62 65 72 20 6f 66 20 74 ger" member of t
22160 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20 2a he associated. *
22170 20 20 20 20 73 74 72 75 63 74 20 54 61 62 6c 65 struct Table
22180 2e 0a 20 2a 0a 20 2a 20 54 68 65 20 22 73 74 65 .. *. * The "ste
22190 70 5f 6c 69 73 74 22 20 6d 65 6d 62 65 72 20 70 p_list" member p
221a0 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 66 69 72 oints to the fir
221b0 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 61 20 st element of a
221c0 6c 69 6e 6b 65 64 20 6c 69 73 74 0a 20 2a 20 63 linked list. * c
221d0 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 53 51 ontaining the SQ
221e0 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 73 70 65 L statements spe
221f0 63 69 66 69 65 64 20 61 73 20 74 68 65 20 74 72 cified as the tr
22200 69 67 67 65 72 20 70 72 6f 67 72 61 6d 2e 0a 20 igger program..
22210 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 65 */.struct Trigge
22220 72 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d r {. char *zNam
22230 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
22240 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 The name of the
22250 20 74 72 69 67 67 65 72 20 20 20 20 20 20 20 20 trigger
22260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22270 2a 2f 0a 20 20 63 68 61 72 20 2a 74 61 62 6c 65 */. char *table
22280 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
22290 54 68 65 20 74 61 62 6c 65 20 6f 72 20 76 69 65 The table or vie
222a0 77 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 74 w to which the t
222b0 72 69 67 67 65 72 20 61 70 70 6c 69 65 73 20 2a rigger applies *
222c0 2f 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 20 20 /. u8 op;
222d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
222e0 6e 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 2c ne of TK_DELETE,
222f0 20 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 TK_UPDATE, TK_I
22300 4e 53 45 52 54 20 20 20 20 20 20 20 20 20 2a 2f NSERT */
22310 0a 20 20 75 38 20 74 72 5f 74 6d 3b 20 20 20 20 . u8 tr_tm;
22320 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e /* On
22330 65 20 6f 66 20 54 52 49 47 47 45 52 5f 42 45 46 e of TRIGGER_BEF
22340 4f 52 45 2c 20 54 52 49 47 47 45 52 5f 41 46 54 ORE, TRIGGER_AFT
22350 45 52 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 ER */. Expr *pW
22360 68 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 hen;
22370 2f 2a 20 54 68 65 20 57 48 45 4e 20 63 6c 61 75 /* The WHEN clau
22380 73 65 20 6f 66 20 74 68 65 20 65 78 70 72 65 73 se of the expres
22390 73 69 6f 6e 20 28 6d 61 79 20 62 65 20 4e 55 4c sion (may be NUL
223a0 4c 29 20 2a 2f 0a 20 20 49 64 4c 69 73 74 20 2a L) */. IdList *
223b0 70 43 6f 6c 75 6d 6e 73 3b 20 20 20 20 20 20 20 pColumns;
223c0 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 6e /* If this is an
223d0 20 55 50 44 41 54 45 20 4f 46 20 3c 63 6f 6c 75 UPDATE OF <colu
223e0 6d 6e 2d 6c 69 73 74 3e 20 74 72 69 67 67 65 72 mn-list> trigger
223f0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
22400 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
22410 68 65 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e he <column-list>
22420 20 69 73 20 73 74 6f 72 65 64 20 68 65 72 65 20 is stored here
22430 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 */. Schema *pSc
22440 68 65 6d 61 3b 20 20 20 20 20 20 20 20 2f 2a 20 hema; /*
22450 53 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e Schema containin
22460 67 20 74 68 65 20 74 72 69 67 67 65 72 20 2a 2f g the trigger */
22470 0a 20 20 53 63 68 65 6d 61 20 2a 70 54 61 62 53 . Schema *pTabS
22480 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 53 63 chema; /* Sc
22490 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 20 hema containing
224a0 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 54 the table */. T
224b0 72 69 67 67 65 72 53 74 65 70 20 2a 73 74 65 70 riggerStep *step
224c0 5f 6c 69 73 74 3b 20 2f 2a 20 4c 69 6e 6b 20 6c _list; /* Link l
224d0 69 73 74 20 6f 66 20 74 72 69 67 67 65 72 20 70 ist of trigger p
224e0 72 6f 67 72 61 6d 20 73 74 65 70 73 20 20 20 20 rogram steps
224f0 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 54 72 */. Tr
22500 69 67 67 65 72 20 2a 70 4e 65 78 74 3b 20 20 20 igger *pNext;
22510 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 74 72 /* Next tr
22520 69 67 67 65 72 20 61 73 73 6f 63 69 61 74 65 64 igger associated
22530 20 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 20 with the table
22540 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 74 */.};../*.** A t
22550 72 69 67 67 65 72 20 69 73 20 65 69 74 68 65 72 rigger is either
22560 20 61 20 42 45 46 4f 52 45 20 6f 72 20 61 6e 20 a BEFORE or an
22570 41 46 54 45 52 20 74 72 69 67 67 65 72 2e 20 20 AFTER trigger.
22580 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f The following co
22590 6e 73 74 61 6e 74 73 0a 2a 2a 20 64 65 74 65 72 nstants.** deter
225a0 6d 69 6e 65 20 77 68 69 63 68 2e 0a 2a 2a 0a 2a mine which..**.*
225b0 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 6d * If there are m
225c0 75 6c 74 69 70 6c 65 20 74 72 69 67 67 65 72 73 ultiple triggers
225d0 2c 20 79 6f 75 20 6d 69 67 68 74 20 6f 66 20 73 , you might of s
225e0 6f 6d 65 20 42 45 46 4f 52 45 20 61 6e 64 20 73 ome BEFORE and s
225f0 6f 6d 65 20 41 46 54 45 52 2e 0a 2a 2a 20 49 6e ome AFTER..** In
22600 20 74 68 61 74 20 63 61 73 65 73 2c 20 74 68 65 that cases, the
22610 20 63 6f 6e 73 74 61 6e 74 73 20 62 65 6c 6f 77 constants below
22620 20 63 61 6e 20 62 65 20 4f 52 65 64 20 74 6f 67 can be ORed tog
22630 65 74 68 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e ether..*/.#defin
22640 65 20 54 52 49 47 47 45 52 5f 42 45 46 4f 52 45 e TRIGGER_BEFORE
22650 20 20 31 0a 23 64 65 66 69 6e 65 20 54 52 49 47 1.#define TRIG
22660 47 45 52 5f 41 46 54 45 52 20 20 20 32 0a 0a 2f GER_AFTER 2../
22670 2a 0a 20 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *. * An instance
22680 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 67 67 of struct Trigg
22690 65 72 53 74 65 70 20 69 73 20 75 73 65 64 20 74 erStep is used t
226a0 6f 20 73 74 6f 72 65 20 61 20 73 69 6e 67 6c 65 o store a single
226b0 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 0a 20 SQL statement.
226c0 2a 20 74 68 61 74 20 69 73 20 61 20 70 61 72 74 * that is a part
226d0 20 6f 66 20 61 20 74 72 69 67 67 65 72 2d 70 72 of a trigger-pr
226e0 6f 67 72 61 6d 2e 0a 20 2a 0a 20 2a 20 49 6e 73 ogram.. *. * Ins
226f0 74 61 6e 63 65 73 20 6f 66 20 73 74 72 75 63 74 tances of struct
22700 20 54 72 69 67 67 65 72 53 74 65 70 20 61 72 65 TriggerStep are
22710 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73 69 6e stored in a sin
22720 67 6c 79 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 gly linked list
22730 28 6c 69 6e 6b 65 64 0a 20 2a 20 75 73 69 6e 67 (linked. * using
22740 20 74 68 65 20 22 70 4e 65 78 74 22 20 6d 65 6d the "pNext" mem
22750 62 65 72 29 20 72 65 66 65 72 65 6e 63 65 64 20 ber) referenced
22760 62 79 20 74 68 65 20 22 73 74 65 70 5f 6c 69 73 by the "step_lis
22770 74 22 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 t" member of the
22780 0a 20 2a 20 61 73 73 6f 63 69 61 74 65 64 20 73 . * associated s
22790 74 72 75 63 74 20 54 72 69 67 67 65 72 20 69 6e truct Trigger in
227a0 73 74 61 6e 63 65 2e 20 54 68 65 20 66 69 72 73 stance. The firs
227b0 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 t element of the
227c0 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 69 73 0a linked list is.
227d0 20 2a 20 74 68 65 20 66 69 72 73 74 20 73 74 65 * the first ste
227e0 70 20 6f 66 20 74 68 65 20 74 72 69 67 67 65 72 p of the trigger
227f0 2d 70 72 6f 67 72 61 6d 2e 0a 20 2a 0a 20 2a 20 -program.. *. *
22800 54 68 65 20 22 6f 70 22 20 6d 65 6d 62 65 72 20 The "op" member
22810 69 6e 64 69 63 61 74 65 73 20 77 68 65 74 68 65 indicates whethe
22820 72 20 74 68 69 73 20 69 73 20 61 20 22 44 45 4c r this is a "DEL
22830 45 54 45 22 2c 20 22 49 4e 53 45 52 54 22 2c 20 ETE", "INSERT",
22840 22 55 50 44 41 54 45 22 20 6f 72 0a 20 2a 20 22 "UPDATE" or. * "
22850 53 45 4c 45 43 54 22 20 73 74 61 74 65 6d 65 6e SELECT" statemen
22860 74 2e 20 54 68 65 20 6d 65 61 6e 69 6e 67 73 20 t. The meanings
22870 6f 66 20 74 68 65 20 6f 74 68 65 72 20 6d 65 6d of the other mem
22880 62 65 72 73 20 69 73 20 64 65 74 65 72 6d 69 6e bers is determin
22890 65 64 20 62 79 20 74 68 65 0a 20 2a 20 76 61 6c ed by the. * val
228a0 75 65 20 6f 66 20 22 6f 70 22 20 61 73 20 66 6f ue of "op" as fo
228b0 6c 6c 6f 77 73 3a 0a 20 2a 0a 20 2a 20 28 6f 70 llows:. *. * (op
228c0 20 3d 3d 20 54 4b 5f 49 4e 53 45 52 54 29 0a 20 == TK_INSERT).
228d0 2a 20 6f 72 63 6f 6e 66 20 20 20 20 2d 3e 20 73 * orconf -> s
228e0 74 6f 72 65 73 20 74 68 65 20 4f 4e 20 43 4f 4e tores the ON CON
228f0 46 4c 49 43 54 20 61 6c 67 6f 72 69 74 68 6d 0a FLICT algorithm.
22900 20 2a 20 70 53 65 6c 65 63 74 20 20 20 2d 3e 20 * pSelect ->
22910 49 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e If this is an IN
22920 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 SERT INTO ... SE
22930 4c 45 43 54 20 2e 2e 2e 20 73 74 61 74 65 6d 65 LECT ... stateme
22940 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 20 20 20 20 nt, then. *
22950 20 20 20 20 20 20 20 20 20 74 68 69 73 20 73 74 this st
22960 6f 72 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 ores a pointer t
22970 6f 20 74 68 65 20 53 45 4c 45 43 54 20 73 74 61 o the SELECT sta
22980 74 65 6d 65 6e 74 2e 20 4f 74 68 65 72 77 69 73 tement. Otherwis
22990 65 20 4e 55 4c 4c 2e 0a 20 2a 20 7a 54 61 72 67 e NULL.. * zTarg
229a0 65 74 20 20 20 2d 3e 20 44 65 71 75 6f 74 65 64 et -> Dequoted
229b0 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
229c0 6c 65 20 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 le to insert int
229d0 6f 2e 0a 20 2a 20 70 45 78 70 72 4c 69 73 74 20 o.. * pExprList
229e0 2d 3e 20 49 66 20 74 68 69 73 20 69 73 20 61 6e -> If this is an
229f0 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e INSERT INTO ...
22a00 20 56 41 4c 55 45 53 20 2e 2e 2e 20 73 74 61 74 VALUES ... stat
22a10 65 6d 65 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 20 ement, then. *
22a20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 this
22a30 20 73 74 6f 72 65 73 20 76 61 6c 75 65 73 20 74 stores values t
22a40 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 20 4f o be inserted. O
22a50 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 therwise NULL..
22a60 2a 20 70 49 64 4c 69 73 74 20 20 20 2d 3e 20 49 * pIdList -> I
22a70 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 f this is an INS
22a80 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 28 3c 63 ERT INTO ... (<c
22a90 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 3e 29 20 56 41 olumn-names>) VA
22aa0 4c 55 45 53 20 2e 2e 2e 0a 20 2a 20 20 20 20 20 LUES .... *
22ab0 20 20 20 20 20 20 20 20 20 73 74 61 74 65 6d 65 stateme
22ac0 6e 74 2c 20 74 68 65 6e 20 74 68 69 73 20 73 74 nt, then this st
22ad0 6f 72 65 73 20 74 68 65 20 63 6f 6c 75 6d 6e 2d ores the column-
22ae0 6e 61 6d 65 73 20 74 6f 20 62 65 0a 20 2a 20 20 names to be. *
22af0 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 73 65 inse
22b00 72 74 65 64 20 69 6e 74 6f 2e 0a 20 2a 0a 20 2a rted into.. *. *
22b10 20 28 6f 70 20 3d 3d 20 54 4b 5f 44 45 4c 45 54 (op == TK_DELET
22b20 45 29 0a 20 2a 20 7a 54 61 72 67 65 74 20 20 20 E). * zTarget
22b30 2d 3e 20 44 65 71 75 6f 74 65 64 20 6e 61 6d 65 -> Dequoted name
22b40 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 6f of the table to
22b50 20 64 65 6c 65 74 65 20 66 72 6f 6d 2e 0a 20 2a delete from.. *
22b60 20 70 57 68 65 72 65 20 20 20 20 2d 3e 20 54 68 pWhere -> Th
22b70 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 6f e WHERE clause o
22b80 66 20 74 68 65 20 44 45 4c 45 54 45 20 73 74 61 f the DELETE sta
22b90 74 65 6d 65 6e 74 20 69 66 20 6f 6e 65 20 69 73 tement if one is
22ba0 20 73 70 65 63 69 66 69 65 64 2e 0a 20 2a 20 20 specified.. *
22bb0 20 20 20 20 20 20 20 20 20 20 20 20 4f 74 68 65 Othe
22bc0 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a 0a 20 rwise NULL.. *.
22bd0 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 55 50 44 41 * (op == TK_UPDA
22be0 54 45 29 0a 20 2a 20 7a 54 61 72 67 65 74 20 20 TE). * zTarget
22bf0 20 2d 3e 20 44 65 71 75 6f 74 65 64 20 6e 61 6d -> Dequoted nam
22c00 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 e of the table t
22c10 6f 20 75 70 64 61 74 65 2e 0a 20 2a 20 70 57 68 o update.. * pWh
22c20 65 72 65 20 20 20 20 2d 3e 20 54 68 65 20 57 48 ere -> The WH
22c30 45 52 45 20 63 6c 61 75 73 65 20 6f 66 20 74 68 ERE clause of th
22c40 65 20 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 e UPDATE stateme
22c50 6e 74 20 69 66 20 6f 6e 65 20 69 73 20 73 70 65 nt if one is spe
22c60 63 69 66 69 65 64 2e 0a 20 2a 20 20 20 20 20 20 cified.. *
22c70 20 20 20 20 20 20 20 20 4f 74 68 65 72 77 69 73 Otherwis
22c80 65 20 4e 55 4c 4c 2e 0a 20 2a 20 70 45 78 70 72 e NULL.. * pExpr
22c90 4c 69 73 74 20 2d 3e 20 41 20 6c 69 73 74 20 6f List -> A list o
22ca0 66 20 74 68 65 20 63 6f 6c 75 6d 6e 73 20 74 6f f the columns to
22cb0 20 75 70 64 61 74 65 20 61 6e 64 20 74 68 65 20 update and the
22cc0 65 78 70 72 65 73 73 69 6f 6e 73 20 74 6f 20 75 expressions to u
22cd0 70 64 61 74 65 0a 20 2a 20 20 20 20 20 20 20 20 pdate. *
22ce0 20 20 20 20 20 20 74 68 65 6d 20 74 6f 2e 20 53 them to. S
22cf0 65 65 20 73 71 6c 69 74 65 33 55 70 64 61 74 65 ee sqlite3Update
22d00 28 29 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e () documentation
22d10 20 6f 66 20 22 70 43 68 61 6e 67 65 73 22 0a 20 of "pChanges".
22d20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 * a
22d30 72 67 75 6d 65 6e 74 2e 0a 20 2a 0a 20 2a 2f 0a rgument.. *. */.
22d40 73 74 72 75 63 74 20 54 72 69 67 67 65 72 53 74 struct TriggerSt
22d50 65 70 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 20 ep {. u8 op;
22d60 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
22d70 6e 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 2c ne of TK_DELETE,
22d80 20 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 TK_UPDATE, TK_I
22d90 4e 53 45 52 54 2c 20 54 4b 5f 53 45 4c 45 43 54 NSERT, TK_SELECT
22da0 20 2a 2f 0a 20 20 75 38 20 6f 72 63 6f 6e 66 3b */. u8 orconf;
22db0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 45 /* OE
22dc0 5f 52 6f 6c 6c 62 61 63 6b 20 65 74 63 2e 20 2a _Rollback etc. *
22dd0 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 72 /. Trigger *pTr
22de0 69 67 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ig; /* The
22df0 74 72 69 67 67 65 72 20 74 68 61 74 20 74 68 69 trigger that thi
22e00 73 20 73 74 65 70 20 69 73 20 61 20 70 61 72 74 s step is a part
22e10 20 6f 66 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 of */. Select
22e20 2a 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a *pSelect; /*
22e30 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
22e40 74 20 6f 72 20 52 48 53 20 6f 66 20 49 4e 53 45 t or RHS of INSE
22e50 52 54 20 49 4e 54 4f 20 53 45 4c 45 43 54 20 2e RT INTO SELECT .
22e60 2e 2e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 .. */. char *zT
22e70 61 72 67 65 74 3b 20 20 20 20 20 20 20 2f 2a 20 arget; /*
22e80 54 61 72 67 65 74 20 74 61 62 6c 65 20 66 6f 72 Target table for
22e90 20 44 45 4c 45 54 45 2c 20 55 50 44 41 54 45 2c DELETE, UPDATE,
22ea0 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 45 78 70 INSERT */. Exp
22eb0 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 20 20 r *pWhere;
22ec0 20 20 2f 2a 20 54 68 65 20 57 48 45 52 45 20 63 /* The WHERE c
22ed0 6c 61 75 73 65 20 66 6f 72 20 44 45 4c 45 54 45 lause for DELETE
22ee0 20 6f 72 20 55 50 44 41 54 45 20 73 74 65 70 73 or UPDATE steps
22ef0 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a */. ExprList *
22f00 70 45 78 70 72 4c 69 73 74 3b 20 2f 2a 20 53 45 pExprList; /* SE
22f10 54 20 63 6c 61 75 73 65 20 66 6f 72 20 55 50 44 T clause for UPD
22f20 41 54 45 20 2a 2f 0a 20 20 49 64 4c 69 73 74 20 ATE */. IdList
22f30 2a 70 49 64 4c 69 73 74 3b 20 20 20 20 20 2f 2a *pIdList; /*
22f40 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 66 6f Column names fo
22f50 72 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 55 70 r INSERT */. Up
22f60 73 65 72 74 20 2a 70 55 70 73 65 72 74 3b 20 20 sert *pUpsert;
22f70 20 20 20 2f 2a 20 55 70 73 65 72 74 20 63 6c 61 /* Upsert cla
22f80 75 73 65 73 20 6f 6e 20 61 6e 20 49 4e 53 45 52 uses on an INSER
22f90 54 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 53 70 T */. char *zSp
22fa0 61 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f an; /* O
22fb0 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 riginal SQL text
22fc0 20 6f 66 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 of this command
22fd0 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 74 65 */. TriggerSte
22fe0 70 20 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 p *pNext; /* Ne
22ff0 78 74 20 69 6e 20 74 68 65 20 6c 69 6e 6b 2d 6c xt in the link-l
23000 69 73 74 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 ist */. Trigger
23010 53 74 65 70 20 2a 70 4c 61 73 74 3b 20 20 2f 2a Step *pLast; /*
23020 20 4c 61 73 74 20 65 6c 65 6d 65 6e 74 20 69 6e Last element in
23030 20 6c 69 6e 6b 2d 6c 69 73 74 2e 20 56 61 6c 69 link-list. Vali
23040 64 20 66 6f 72 20 31 73 74 20 65 6c 65 6d 20 6f d for 1st elem o
23050 6e 6c 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a nly */.};../*.**
23060 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 The following s
23070 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e tructure contain
23080 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 s information us
23090 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 65 ed by the sqlite
230a0 46 69 78 2e 2e 2e 0a 2a 2a 20 72 6f 75 74 69 6e Fix....** routin
230b0 65 73 20 61 73 20 74 68 65 79 20 77 61 6c 6b 20 es as they walk
230c0 74 68 65 20 70 61 72 73 65 20 74 72 65 65 20 74 the parse tree t
230d0 6f 20 6d 61 6b 65 20 64 61 74 61 62 61 73 65 20 o make database
230e0 72 65 66 65 72 65 6e 63 65 73 0a 2a 2a 20 65 78 references.** ex
230f0 70 6c 69 63 69 74 2e 0a 2a 2f 0a 74 79 70 65 64 plicit..*/.typed
23100 65 66 20 73 74 72 75 63 74 20 44 62 46 69 78 65 ef struct DbFixe
23110 72 20 44 62 46 69 78 65 72 3b 0a 73 74 72 75 63 r DbFixer;.struc
23120 74 20 44 62 46 69 78 65 72 20 7b 0a 20 20 50 61 t DbFixer {. Pa
23130 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 20 20 rse *pParse;
23140 20 20 2f 2a 20 54 68 65 20 70 61 72 73 69 6e 67 /* The parsing
23150 20 63 6f 6e 74 65 78 74 2e 20 20 45 72 72 6f 72 context. Error
23160 20 6d 65 73 73 61 67 65 73 20 77 72 69 74 74 65 messages writte
23170 6e 20 68 65 72 65 20 2a 2f 0a 20 20 53 63 68 65 n here */. Sche
23180 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 20 20 ma *pSchema;
23190 2f 2a 20 46 69 78 20 69 74 65 6d 73 20 74 6f 20 /* Fix items to
231a0 74 68 69 73 20 73 63 68 65 6d 61 20 2a 2f 0a 20 this schema */.
231b0 20 69 6e 74 20 62 56 61 72 4f 6e 6c 79 3b 20 20 int bVarOnly;
231c0 20 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 66 6f /* Check fo
231d0 72 20 76 61 72 69 61 62 6c 65 20 72 65 66 65 72 r variable refer
231e0 65 6e 63 65 73 20 6f 6e 6c 79 20 2a 2f 0a 20 20 ences only */.
231f0 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 3b const char *zDb;
23200 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 /* Make sure
23210 20 61 6c 6c 20 6f 62 6a 65 63 74 73 20 61 72 65 all objects are
23220 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 74 68 contained in th
23230 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 is database */.
23240 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 79 const char *zTy
23250 70 65 3b 20 20 2f 2a 20 54 79 70 65 20 6f 66 20 pe; /* Type of
23260 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 2d 20 the container -
23270 75 73 65 64 20 66 6f 72 20 65 72 72 6f 72 20 6d used for error m
23280 65 73 73 61 67 65 73 20 2a 2f 0a 20 20 63 6f 6e essages */. con
23290 73 74 20 54 6f 6b 65 6e 20 2a 70 4e 61 6d 65 3b st Token *pName;
232a0 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
232b0 63 6f 6e 74 61 69 6e 65 72 20 2d 20 75 73 65 64 container - used
232c0 20 66 6f 72 20 65 72 72 6f 72 20 6d 65 73 73 61 for error messa
232d0 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ges */.};../*.**
232e0 20 41 6e 20 6f 62 6a 65 63 74 65 64 20 75 73 65 An objected use
232f0 64 20 74 6f 20 61 63 63 75 6d 75 6c 61 74 65 20 d to accumulate
23300 74 68 65 20 74 65 78 74 20 6f 66 20 61 20 73 74 the text of a st
23310 72 69 6e 67 20 77 68 65 72 65 20 77 65 0a 2a 2a ring where we.**
23320 20 64 6f 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 do not necessar
23330 69 6c 79 20 6b 6e 6f 77 20 68 6f 77 20 62 69 67 ily know how big
23340 20 74 68 65 20 73 74 72 69 6e 67 20 77 69 6c 6c the string will
23350 20 62 65 20 69 6e 20 74 68 65 20 65 6e 64 2e 0a be in the end..
23360 2a 2f 0a 73 74 72 75 63 74 20 53 74 72 41 63 63 */.struct StrAcc
23370 75 6d 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a um {. sqlite3 *
23380 64 62 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f db; /* O
23390 70 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 ptional database
233a0 20 66 6f 72 20 6c 6f 6f 6b 61 73 69 64 65 2e 20 for lookaside.
233b0 20 43 61 6e 20 62 65 20 4e 55 4c 4c 20 2a 2f 0a Can be NULL */.
233c0 20 20 63 68 61 72 20 2a 7a 54 65 78 74 3b 20 20 char *zText;
233d0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 74 /* The st
233e0 72 69 6e 67 20 63 6f 6c 6c 65 63 74 65 64 20 73 ring collected s
233f0 6f 20 66 61 72 20 2a 2f 0a 20 20 75 33 32 20 20 o far */. u32
23400 6e 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20 nAlloc;
23410 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 73 70 61 /* Amount of spa
23420 63 65 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 ce allocated in
23430 7a 54 65 78 74 20 2a 2f 0a 20 20 75 33 32 20 20 zText */. u32
23440 6d 78 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 mxAlloc;
23450 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6c 6c 6f 77 /* Maximum allow
23460 65 64 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 ed allocation.
23470 30 20 66 6f 72 20 6e 6f 20 6d 61 6c 6c 6f 63 20 0 for no malloc
23480 75 73 61 67 65 20 2a 2f 0a 20 20 75 33 32 20 20 usage */. u32
23490 6e 43 68 61 72 3b 20 20 20 20 20 20 20 20 20 20 nChar;
234a0 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 74 68 65 /* Length of the
234b0 20 73 74 72 69 6e 67 20 73 6f 20 66 61 72 20 2a string so far *
234c0 2f 0a 20 20 75 38 20 20 20 61 63 63 45 72 72 6f /. u8 accErro
234d0 72 3b 20 20 20 20 20 20 20 2f 2a 20 53 54 52 41 r; /* STRA
234e0 43 43 55 4d 5f 4e 4f 4d 45 4d 20 6f 72 20 53 54 CCUM_NOMEM or ST
234f0 52 41 43 43 55 4d 5f 54 4f 4f 42 49 47 20 2a 2f RACCUM_TOOBIG */
23500 0a 20 20 75 38 20 20 20 70 72 69 6e 74 66 46 6c . u8 printfFl
23510 61 67 73 3b 20 20 20 20 2f 2a 20 53 51 4c 49 54 ags; /* SQLIT
23520 45 5f 50 52 49 4e 54 46 20 66 6c 61 67 73 20 62 E_PRINTF flags b
23530 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 23 64 65 66 69 elow */.};.#defi
23540 6e 65 20 53 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 ne STRACCUM_NOME
23550 4d 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 54 M 1.#define ST
23560 52 41 43 43 55 4d 5f 54 4f 4f 42 49 47 20 20 32 RACCUM_TOOBIG 2
23570 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
23580 50 52 49 4e 54 46 5f 49 4e 54 45 52 4e 41 4c 20 PRINTF_INTERNAL
23590 30 78 30 31 20 20 2f 2a 20 49 6e 74 65 72 6e 61 0x01 /* Interna
235a0 6c 2d 75 73 65 2d 6f 6e 6c 79 20 63 6f 6e 76 65 l-use-only conve
235b0 72 74 65 72 73 20 61 6c 6c 6f 77 65 64 20 2a 2f rters allowed */
235c0 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
235d0 50 52 49 4e 54 46 5f 53 51 4c 46 55 4e 43 20 20 PRINTF_SQLFUNC
235e0 30 78 30 32 20 20 2f 2a 20 53 51 4c 20 66 75 6e 0x02 /* SQL fun
235f0 63 74 69 6f 6e 20 61 72 67 75 6d 65 6e 74 73 20 ction arguments
23600 74 6f 20 56 58 50 72 69 6e 74 66 20 2a 2f 0a 23 to VXPrintf */.#
23610 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 define SQLITE_PR
23620 49 4e 54 46 5f 4d 41 4c 4c 4f 43 45 44 20 30 78 INTF_MALLOCED 0x
23630 30 34 20 20 2f 2a 20 54 72 75 65 20 69 66 20 78 04 /* True if x
23640 54 65 78 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 Text is allocate
23650 64 20 73 70 61 63 65 20 2a 2f 0a 0a 23 64 65 66 d space */..#def
23660 69 6e 65 20 69 73 4d 61 6c 6c 6f 63 65 64 28 58 ine isMalloced(X
23670 29 20 20 28 28 28 58 29 2d 3e 70 72 69 6e 74 66 ) (((X)->printf
23680 46 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 50 Flags & SQLITE_P
23690 52 49 4e 54 46 5f 4d 41 4c 4c 4f 43 45 44 29 21 RINTF_MALLOCED)!
236a0 3d 30 29 0a 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f =0).../*.** A po
236b0 69 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 inter to this st
236c0 72 75 63 74 75 72 65 20 69 73 20 75 73 65 64 20 ructure is used
236d0 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 65 20 69 to communicate i
236e0 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 nformation.** fr
236f0 6f 6d 20 73 71 6c 69 74 65 33 49 6e 69 74 20 61 om sqlite3Init a
23700 6e 64 20 4f 50 5f 50 61 72 73 65 53 63 68 65 6d nd OP_ParseSchem
23710 61 20 69 6e 74 6f 20 74 68 65 20 73 71 6c 69 74 a into the sqlit
23720 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2e 0a e3InitCallback..
23730 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 */.typedef struc
23740 74 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 t {. sqlite3 *d
23750 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 b; /* The
23760 20 64 61 74 61 62 61 73 65 20 62 65 69 6e 67 20 database being
23770 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 initialized */.
23780 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 char **pzErrMsg
23790 3b 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 6d 65 ; /* Error me
237a0 73 73 61 67 65 20 73 74 6f 72 65 64 20 68 65 72 ssage stored her
237b0 65 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 e */. int iDb;
237c0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 30 20 /* 0
237d0 66 6f 72 20 6d 61 69 6e 20 64 61 74 61 62 61 73 for main databas
237e0 65 2e 20 20 31 20 66 6f 72 20 54 45 4d 50 2c 20 e. 1 for TEMP,
237f0 32 2e 2e 20 66 6f 72 20 41 54 54 41 43 48 65 64 2.. for ATTACHed
23800 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 */. int rc;
23810 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 73 /* Res
23820 75 6c 74 20 63 6f 64 65 20 73 74 6f 72 65 64 20 ult code stored
23830 68 65 72 65 20 2a 2f 0a 7d 20 49 6e 69 74 44 61 here */.} InitDa
23840 74 61 3b 0a 0a 2f 2a 0a 2a 2a 20 53 74 72 75 63 ta;../*.** Struc
23850 74 75 72 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ture containing
23860 67 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 75 72 61 global configura
23870 74 69 6f 6e 20 64 61 74 61 20 66 6f 72 20 74 68 tion data for th
23880 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 e SQLite library
23890 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74 72 ..**.** This str
238a0 75 63 74 75 72 65 20 61 6c 73 6f 20 63 6f 6e 74 ucture also cont
238b0 61 69 6e 73 20 73 6f 6d 65 20 73 74 61 74 65 20 ains some state
238c0 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a information..*/.
238d0 73 74 72 75 63 74 20 53 71 6c 69 74 65 33 43 6f struct Sqlite3Co
238e0 6e 66 69 67 20 7b 0a 20 20 69 6e 74 20 62 4d 65 nfig {. int bMe
238f0 6d 73 74 61 74 3b 20 20 20 20 20 20 20 20 20 20 mstat;
23900 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
23910 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 6d 65 6d ue to enable mem
23920 6f 72 79 20 73 74 61 74 75 73 20 2a 2f 0a 20 20 ory status */.
23930 69 6e 74 20 62 43 6f 72 65 4d 75 74 65 78 3b 20 int bCoreMutex;
23940 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23950 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 /* True to ena
23960 62 6c 65 20 63 6f 72 65 20 6d 75 74 65 78 69 6e ble core mutexin
23970 67 20 2a 2f 0a 20 20 69 6e 74 20 62 46 75 6c 6c g */. int bFull
23980 4d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 Mutex;
23990 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
239a0 20 74 6f 20 65 6e 61 62 6c 65 20 66 75 6c 6c 20 to enable full
239b0 6d 75 74 65 78 69 6e 67 20 2a 2f 0a 20 20 69 6e mutexing */. in
239c0 74 20 62 4f 70 65 6e 55 72 69 3b 20 20 20 20 20 t bOpenUri;
239d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
239e0 2f 2a 20 54 72 75 65 20 74 6f 20 69 6e 74 65 72 /* True to inter
239f0 70 72 65 74 20 66 69 6c 65 6e 61 6d 65 73 20 61 pret filenames a
23a00 73 20 55 52 49 73 20 2a 2f 0a 20 20 69 6e 74 20 s URIs */. int
23a10 62 55 73 65 43 69 73 3b 20 20 20 20 20 20 20 20 bUseCis;
23a20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
23a30 20 55 73 65 20 63 6f 76 65 72 69 6e 67 20 69 6e Use covering in
23a40 64 69 63 65 73 20 66 6f 72 20 66 75 6c 6c 2d 73 dices for full-s
23a50 63 61 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 62 53 cans */. int bS
23a60 6d 61 6c 6c 4d 61 6c 6c 6f 63 3b 20 20 20 20 20 mallMalloc;
23a70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
23a80 76 6f 69 64 20 6c 61 72 67 65 20 6d 65 6d 6f 72 void large memor
23a90 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 69 66 y allocations if
23aa0 20 74 72 75 65 20 2a 2f 0a 20 20 69 6e 74 20 6d true */. int m
23ab0 78 53 74 72 6c 65 6e 3b 20 20 20 20 20 20 20 20 xStrlen;
23ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23ad0 4d 61 78 69 6d 75 6d 20 73 74 72 69 6e 67 20 6c Maximum string l
23ae0 65 6e 67 74 68 20 2a 2f 0a 20 20 69 6e 74 20 6e ength */. int n
23af0 65 76 65 72 43 6f 72 72 75 70 74 3b 20 20 20 20 everCorrupt;
23b00 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23b10 44 61 74 61 62 61 73 65 20 69 73 20 61 6c 77 61 Database is alwa
23b20 79 73 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 2a ys well-formed *
23b30 2f 0a 20 20 69 6e 74 20 73 7a 4c 6f 6f 6b 61 73 /. int szLookas
23b40 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ide;
23b50 20 20 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 /* Default
23b60 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 lookaside buffe
23b70 72 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 r size */. int
23b80 6e 4c 6f 6f 6b 61 73 69 64 65 3b 20 20 20 20 20 nLookaside;
23b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
23ba0 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b 61 73 69 Default lookasi
23bb0 64 65 20 62 75 66 66 65 72 20 63 6f 75 6e 74 20 de buffer count
23bc0 2a 2f 0a 20 20 69 6e 74 20 6e 53 74 6d 74 53 70 */. int nStmtSp
23bd0 69 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 ill;
23be0 20 20 20 20 20 20 20 2f 2a 20 53 74 6d 74 2d 6a /* Stmt-j
23bf0 6f 75 72 6e 61 6c 20 73 70 69 6c 6c 2d 74 6f 2d ournal spill-to-
23c00 64 69 73 6b 20 74 68 72 65 73 68 6f 6c 64 20 2a disk threshold *
23c10 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f /. sqlite3_mem_
23c20 6d 65 74 68 6f 64 73 20 6d 3b 20 20 20 20 20 20 methods m;
23c30 20 20 20 20 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 /* Low-lev
23c40 65 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 el memory alloca
23c50 74 69 6f 6e 20 69 6e 74 65 72 66 61 63 65 20 2a tion interface *
23c60 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 /. sqlite3_mute
23c70 78 5f 6d 65 74 68 6f 64 73 20 6d 75 74 65 78 3b x_methods mutex;
23c80 20 20 20 20 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 /* Low-lev
23c90 65 6c 20 6d 75 74 65 78 20 69 6e 74 65 72 66 61 el mutex interfa
23ca0 63 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ce */. sqlite3_
23cb0 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 73 32 20 pcache_methods2
23cc0 70 63 61 63 68 65 32 3b 20 20 2f 2a 20 4c 6f 77 pcache2; /* Low
23cd0 2d 6c 65 76 65 6c 20 70 61 67 65 2d 63 61 63 68 -level page-cach
23ce0 65 20 69 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 e interface */.
23cf0 20 76 6f 69 64 20 2a 70 48 65 61 70 3b 20 20 20 void *pHeap;
23d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d10 20 20 20 2f 2a 20 48 65 61 70 20 73 74 6f 72 61 /* Heap stora
23d20 67 65 20 73 70 61 63 65 20 2a 2f 0a 20 20 69 6e ge space */. in
23d30 74 20 6e 48 65 61 70 3b 20 20 20 20 20 20 20 20 t nHeap;
23d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d50 2f 2a 20 53 69 7a 65 20 6f 66 20 70 48 65 61 70 /* Size of pHeap
23d60 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6d 6e 52 65 [] */. int mnRe
23d70 71 2c 20 6d 78 52 65 71 3b 20 20 20 20 20 20 20 q, mxReq;
23d80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e /* Min
23d90 20 61 6e 64 20 6d 61 78 20 68 65 61 70 20 72 65 and max heap re
23da0 71 75 65 73 74 73 20 73 69 7a 65 73 20 2a 2f 0a quests sizes */.
23db0 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
23dc0 73 7a 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 20 szMmap;
23dd0 20 20 20 20 2f 2a 20 6d 6d 61 70 28 29 20 73 70 /* mmap() sp
23de0 61 63 65 20 70 65 72 20 6f 70 65 6e 20 66 69 6c ace per open fil
23df0 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 e */. sqlite3_i
23e00 6e 74 36 34 20 6d 78 4d 6d 61 70 3b 20 20 20 20 nt64 mxMmap;
23e10 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 /* Maxi
23e20 6d 75 6d 20 76 61 6c 75 65 20 66 6f 72 20 73 7a mum value for sz
23e30 4d 6d 61 70 20 2a 2f 0a 20 20 76 6f 69 64 20 2a Mmap */. void *
23e40 70 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 pPage;
23e50 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
23e60 61 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 79 age cache memory
23e70 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 */. int szPage
23e80 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
23e90 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
23ea0 6f 66 20 65 61 63 68 20 70 61 67 65 20 69 6e 20 of each page in
23eb0 70 50 61 67 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 pPage[] */. int
23ec0 20 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 nPage;
23ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23ee0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 * Number of page
23ef0 73 20 69 6e 20 70 50 61 67 65 5b 5d 20 2a 2f 0a s in pPage[] */.
23f00 20 20 69 6e 74 20 6d 78 50 61 72 73 65 72 53 74 int mxParserSt
23f10 61 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 ack;
23f20 20 20 20 20 2f 2a 20 6d 61 78 69 6d 75 6d 20 64 /* maximum d
23f30 65 70 74 68 20 6f 66 20 74 68 65 20 70 61 72 73 epth of the pars
23f40 65 72 20 73 74 61 63 6b 20 2a 2f 0a 20 20 69 6e er stack */. in
23f50 74 20 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 t sharedCacheEna
23f60 62 6c 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 bled;
23f70 2f 2a 20 74 72 75 65 20 69 66 20 73 68 61 72 65 /* true if share
23f80 64 2d 63 61 63 68 65 20 6d 6f 64 65 20 65 6e 61 d-cache mode ena
23f90 62 6c 65 64 20 2a 2f 0a 20 20 75 33 32 20 73 7a bled */. u32 sz
23fa0 50 6d 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 Pma;
23fb0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d /* M
23fc0 61 78 69 6d 75 6d 20 53 6f 72 74 65 72 20 50 4d aximum Sorter PM
23fd0 41 20 73 69 7a 65 20 2a 2f 0a 20 20 2f 2a 20 54 A size */. /* T
23fe0 68 65 20 61 62 6f 76 65 20 6d 69 67 68 74 20 62 he above might b
23ff0 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f e initialized to
24000 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 20 54 68 65 20 non-zero. The
24010 66 6f 6c 6c 6f 77 69 6e 67 20 6e 65 65 64 20 74 following need t
24020 6f 20 61 6c 77 61 79 73 0a 20 20 2a 2a 20 69 6e o always. ** in
24030 69 74 69 61 6c 6c 79 20 62 65 20 7a 65 72 6f 2c itially be zero,
24040 20 68 6f 77 65 76 65 72 2e 20 2a 2f 0a 20 20 69 however. */. i
24050 6e 74 20 69 73 49 6e 69 74 3b 20 20 20 20 20 20 nt isInit;
24060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24070 20 2f 2a 20 54 72 75 65 20 61 66 74 65 72 20 69 /* True after i
24080 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 68 61 nitialization ha
24090 73 20 66 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 s finished */.
240a0 69 6e 74 20 69 6e 50 72 6f 67 72 65 73 73 3b 20 int inProgress;
240b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
240c0 20 20 2f 2a 20 54 72 75 65 20 77 68 69 6c 65 20 /* True while
240d0 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 initialization i
240e0 6e 20 70 72 6f 67 72 65 73 73 20 2a 2f 0a 20 20 n progress */.
240f0 69 6e 74 20 69 73 4d 75 74 65 78 49 6e 69 74 3b int isMutexInit;
24100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24110 20 20 2f 2a 20 54 72 75 65 20 61 66 74 65 72 20 /* True after
24120 6d 75 74 65 78 65 73 20 61 72 65 20 69 6e 69 74 mutexes are init
24130 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 ialized */. int
24140 20 69 73 4d 61 6c 6c 6f 63 49 6e 69 74 3b 20 20 isMallocInit;
24150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
24160 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 61 6c * True after mal
24170 6c 6f 63 20 69 73 20 69 6e 69 74 69 61 6c 69 7a loc is initializ
24180 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 50 43 ed */. int isPC
24190 61 63 68 65 49 6e 69 74 3b 20 20 20 20 20 20 20 acheInit;
241a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
241b0 65 20 61 66 74 65 72 20 6d 61 6c 6c 6f 63 20 69 e after malloc i
241c0 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f s initialized */
241d0 0a 20 20 69 6e 74 20 6e 52 65 66 49 6e 69 74 4d . int nRefInitM
241e0 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 20 20 utex;
241f0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
24200 66 20 75 73 65 72 73 20 6f 66 20 70 49 6e 69 74 f users of pInit
24210 4d 75 74 65 78 20 2a 2f 0a 20 20 73 71 6c 69 74 Mutex */. sqlit
24220 65 33 5f 6d 75 74 65 78 20 2a 70 49 6e 69 74 4d e3_mutex *pInitM
24230 75 74 65 78 3b 20 20 20 20 20 20 20 20 2f 2a 20 utex; /*
24240 4d 75 74 65 78 20 75 73 65 64 20 62 79 20 73 71 Mutex used by sq
24250 6c 69 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 lite3_initialize
24260 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 () */. void (*x
24270 4c 6f 67 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 Log)(void*,int,c
24280 6f 6e 73 74 20 63 68 61 72 2a 29 3b 20 2f 2a 20 onst char*); /*
24290 46 75 6e 63 74 69 6f 6e 20 66 6f 72 20 6c 6f 67 Function for log
242a0 67 69 6e 67 20 2a 2f 0a 20 20 76 6f 69 64 20 2a ging */. void *
242b0 70 4c 6f 67 41 72 67 3b 20 20 20 20 20 20 20 20 pLogArg;
242c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
242d0 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 * First argument
242e0 20 74 6f 20 78 4c 6f 67 28 29 20 2a 2f 0a 23 69 to xLog() */.#i
242f0 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
24300 4c 45 5f 53 51 4c 4c 4f 47 0a 20 20 76 6f 69 64 LE_SQLLOG. void
24310 28 2a 78 53 71 6c 6c 6f 67 29 28 76 6f 69 64 2a (*xSqllog)(void*
24320 2c 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 ,sqlite3*,const
24330 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 char*, int);. v
24340 6f 69 64 20 2a 70 53 71 6c 6c 6f 67 41 72 67 3b oid *pSqllogArg;
24350 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 .#endif.#ifdef S
24360 51 4c 49 54 45 5f 56 44 42 45 5f 43 4f 56 45 52 QLITE_VDBE_COVER
24370 41 47 45 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c AGE. /* The fol
24380 6c 6f 77 69 6e 67 20 63 61 6c 6c 62 61 63 6b 20 lowing callback
24390 28 69 66 20 6e 6f 74 20 4e 55 4c 4c 29 20 69 73 (if not NULL) is
243a0 20 69 6e 76 6f 6b 65 64 20 6f 6e 20 65 76 65 72 invoked on ever
243b0 79 20 56 44 42 45 20 62 72 61 6e 63 68 0a 20 20 y VDBE branch.
243c0 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 53 ** operation. S
243d0 65 74 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 et the callback
243e0 75 73 69 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 using SQLITE_TES
243f0 54 43 54 52 4c 5f 56 44 42 45 5f 43 4f 56 45 52 TCTRL_VDBE_COVER
24400 41 47 45 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 AGE.. */. void
24410 20 28 2a 78 56 64 62 65 42 72 61 6e 63 68 29 28 (*xVdbeBranch)(
24420 76 6f 69 64 2a 2c 69 6e 74 20 69 53 72 63 4c 69 void*,int iSrcLi
24430 6e 65 2c 75 38 20 65 54 68 69 73 2c 75 38 20 65 ne,u8 eThis,u8 e
24440 4d 78 29 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 Mx); /* Callbac
24450 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 56 64 k */. void *pVd
24460 62 65 42 72 61 6e 63 68 41 72 67 3b 20 20 20 20 beBranchArg;
24470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24490 20 2f 2a 20 31 73 74 20 61 72 67 75 6d 65 6e 74 /* 1st argument
244a0 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 */.#endif.#ifnd
244b0 65 66 20 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 ef SQLITE_UNTEST
244c0 41 42 4c 45 0a 20 20 69 6e 74 20 28 2a 78 54 65 ABLE. int (*xTe
244d0 73 74 43 61 6c 6c 62 61 63 6b 29 28 69 6e 74 29 stCallback)(int)
244e0 3b 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 76 6f ; /* Invo
244f0 6b 65 64 20 62 79 20 73 71 6c 69 74 65 33 46 61 ked by sqlite3Fa
24500 75 6c 74 53 69 6d 28 29 20 2a 2f 0a 23 65 6e 64 ultSim() */.#end
24510 69 66 0a 20 20 69 6e 74 20 62 4c 6f 63 61 6c 74 if. int bLocalt
24520 69 6d 65 46 61 75 6c 74 3b 20 20 20 20 20 20 20 imeFault;
24530 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 /* True t
24540 6f 20 66 61 69 6c 20 6c 6f 63 61 6c 74 69 6d 65 o fail localtime
24550 28 29 20 63 61 6c 6c 73 20 2a 2f 0a 20 20 69 6e () calls */. in
24560 74 20 69 4f 6e 63 65 52 65 73 65 74 54 68 72 65 t iOnceResetThre
24570 73 68 6f 6c 64 3b 20 20 20 20 20 20 20 20 20 20 shold;
24580 2f 2a 20 57 68 65 6e 20 74 6f 20 72 65 73 65 74 /* When to reset
24590 20 4f 50 5f 4f 6e 63 65 20 63 6f 75 6e 74 65 72 OP_Once counter
245a0 73 20 2a 2f 0a 20 20 75 33 32 20 73 7a 53 6f 72 s */. u32 szSor
245b0 74 65 72 52 65 66 3b 20 20 20 20 20 20 20 20 20 terRef;
245c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 20 /* Min
245d0 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 74 6f size in bytes to
245e0 20 75 73 65 20 73 6f 72 74 65 72 2d 72 65 66 73 use sorter-refs
245f0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 */.};../*.** Th
24600 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 is macro is used
24610 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 65 72 inside of asser
24620 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 74 t() statements t
24630 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74 0a o indicate that.
24640 2a 2a 20 74 68 65 20 61 73 73 65 72 74 20 69 73 ** the assert is
24650 20 6f 6e 6c 79 20 76 61 6c 69 64 20 6f 6e 20 61 only valid on a
24660 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 well-formed dat
24670 61 62 61 73 65 2e 20 20 49 6e 73 74 65 61 64 20 abase. Instead
24680 6f 66 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 73 of:.**.** as
24690 73 65 72 74 28 20 58 20 29 3b 0a 2a 2a 0a 2a 2a sert( X );.**.**
246a0 20 4f 6e 65 20 77 72 69 74 65 73 3a 0a 2a 2a 0a One writes:.**.
246b0 2a 2a 20 20 20 20 20 61 73 73 65 72 74 28 20 58 ** assert( X
246c0 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 20 29 || CORRUPT_DB )
246d0 3b 0a 2a 2a 0a 2a 2a 20 43 4f 52 52 55 50 54 5f ;.**.** CORRUPT_
246e0 44 42 20 69 73 20 74 72 75 65 20 64 75 72 69 6e DB is true durin
246f0 67 20 6e 6f 72 6d 61 6c 20 6f 70 65 72 61 74 69 g normal operati
24700 6f 6e 2e 20 20 43 4f 52 52 55 50 54 5f 44 42 20 on. CORRUPT_DB
24710 64 6f 65 73 20 6e 6f 74 20 69 6e 64 69 63 61 74 does not indicat
24720 65 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 64 61 e.** that the da
24730 74 61 62 61 73 65 20 69 73 20 64 65 66 69 6e 69 tabase is defini
24740 74 65 6c 79 20 63 6f 72 72 75 70 74 2c 20 6f 6e tely corrupt, on
24750 6c 79 20 74 68 61 74 20 69 74 20 6d 69 67 68 74 ly that it might
24760 20 62 65 20 63 6f 72 72 75 70 74 2e 0a 2a 2a 20 be corrupt..**
24770 46 6f 72 20 6d 6f 73 74 20 74 65 73 74 20 63 61 For most test ca
24780 73 65 73 2c 20 43 4f 52 52 55 50 54 5f 44 42 20 ses, CORRUPT_DB
24790 69 73 20 73 65 74 20 74 6f 20 66 61 6c 73 65 20 is set to false
247a0 75 73 69 6e 67 20 61 20 73 70 65 63 69 61 6c 0a using a special.
247b0 2a 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f ** sqlite3_test_
247c0 63 6f 6e 74 72 6f 6c 28 29 2e 20 20 54 68 69 73 control(). This
247d0 20 65 6e 61 62 6c 65 73 20 61 73 73 65 72 74 28 enables assert(
247e0 29 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 ) statements to
247f0 70 72 6f 76 65 0a 2a 2a 20 74 68 69 6e 67 73 20 prove.** things
24800 74 68 61 74 20 61 72 65 20 61 6c 77 61 79 73 20 that are always
24810 74 72 75 65 20 66 6f 72 20 77 65 6c 6c 2d 66 6f true for well-fo
24820 72 6d 65 64 20 64 61 74 61 62 61 73 65 73 2e 0a rmed databases..
24830 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f 52 52 55 */.#define CORRU
24840 50 54 5f 44 42 20 20 28 73 71 6c 69 74 65 33 43 PT_DB (sqlite3C
24850 6f 6e 66 69 67 2e 6e 65 76 65 72 43 6f 72 72 75 onfig.neverCorru
24860 70 74 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 43 6f pt==0)../*.** Co
24870 6e 74 65 78 74 20 70 6f 69 6e 74 65 72 20 70 61 ntext pointer pa
24880 73 73 65 64 20 64 6f 77 6e 20 74 68 72 6f 75 67 ssed down throug
24890 68 20 74 68 65 20 74 72 65 65 2d 77 61 6c 6b 2e h the tree-walk.
248a0 0a 2a 2f 0a 73 74 72 75 63 74 20 57 61 6c 6b 65 .*/.struct Walke
248b0 72 20 7b 0a 20 20 50 61 72 73 65 20 2a 70 50 61 r {. Parse *pPa
248c0 72 73 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 rse;
248d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
248e0 2f 2a 20 50 61 72 73 65 72 20 63 6f 6e 74 65 78 /* Parser contex
248f0 74 2e 20 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 t. */. int (*x
24900 45 78 70 72 43 61 6c 6c 62 61 63 6b 29 28 57 61 ExprCallback)(Wa
24910 6c 6b 65 72 2a 2c 20 45 78 70 72 2a 29 3b 20 20 lker*, Expr*);
24920 20 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 /* Callback f
24930 6f 72 20 65 78 70 72 65 73 73 69 6f 6e 73 20 2a or expressions *
24940 2f 0a 20 20 69 6e 74 20 28 2a 78 53 65 6c 65 63 /. int (*xSelec
24950 74 43 61 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 tCallback)(Walke
24960 72 2a 2c 53 65 6c 65 63 74 2a 29 3b 20 20 2f 2a r*,Select*); /*
24970 20 43 61 6c 6c 62 61 63 6b 20 66 6f 72 20 53 45 Callback for SE
24980 4c 45 43 54 73 20 2a 2f 0a 20 20 76 6f 69 64 20 LECTs */. void
24990 28 2a 78 53 65 6c 65 63 74 43 61 6c 6c 62 61 63 (*xSelectCallbac
249a0 6b 32 29 28 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 k2)(Walker*,Sele
249b0 63 74 2a 29 3b 2f 2a 20 53 65 63 6f 6e 64 20 63 ct*);/* Second c
249c0 61 6c 6c 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 allback for SELE
249d0 43 54 73 20 2a 2f 0a 20 20 69 6e 74 20 77 61 6c CTs */. int wal
249e0 6b 65 72 44 65 70 74 68 3b 20 20 20 20 20 20 20 kerDepth;
249f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24a00 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
24a10 73 75 62 71 75 65 72 69 65 73 20 2a 2f 0a 20 20 subqueries */.
24a20 75 38 20 65 43 6f 64 65 3b 20 20 20 20 20 20 20 u8 eCode;
24a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24a40 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 73 /* A s
24a50 6d 61 6c 6c 20 70 72 6f 63 65 73 73 69 6e 67 20 mall processing
24a60 63 6f 64 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 code */. union
24a70 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
24a80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24a90 20 20 20 20 2f 2a 20 45 78 74 72 61 20 64 61 74 /* Extra dat
24aa0 61 20 66 6f 72 20 63 61 6c 6c 62 61 63 6b 20 2a a for callback *
24ab0 2f 0a 20 20 20 20 4e 61 6d 65 43 6f 6e 74 65 78 /. NameContex
24ac0 74 20 2a 70 4e 43 3b 20 20 20 20 20 20 20 20 20 t *pNC;
24ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24ae0 2f 2a 20 4e 61 6d 69 6e 67 20 63 6f 6e 74 65 78 /* Naming contex
24af0 74 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 3b 20 t */. int n;
24b00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24b10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24b20 20 20 20 2f 2a 20 41 20 63 6f 75 6e 74 65 72 20 /* A counter
24b30 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 75 72 3b */. int iCur;
24b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24b60 20 2f 2a 20 41 20 63 75 72 73 6f 72 20 6e 75 6d /* A cursor num
24b70 62 65 72 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 ber */. SrcLi
24b80 73 74 20 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 st *pSrcList;
24b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24ba0 20 20 20 20 20 2f 2a 20 46 52 4f 4d 20 63 6c 61 /* FROM cla
24bb0 75 73 65 20 2a 2f 0a 20 20 20 20 73 74 72 75 63 use */. struc
24bc0 74 20 53 72 63 43 6f 75 6e 74 20 2a 70 53 72 63 t SrcCount *pSrc
24bd0 43 6f 75 6e 74 3b 20 20 20 20 20 20 20 20 20 20 Count;
24be0 20 20 20 20 20 2f 2a 20 43 6f 75 6e 74 69 6e 67 /* Counting
24bf0 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65 6e 63 column referenc
24c00 65 73 20 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 es */. struct
24c10 20 43 43 75 72 48 69 6e 74 20 2a 70 43 43 75 72 CCurHint *pCCur
24c20 48 69 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 Hint;
24c30 20 20 20 20 2f 2a 20 55 73 65 64 20 62 79 20 63 /* Used by c
24c40 6f 64 65 43 75 72 73 6f 72 48 69 6e 74 28 29 20 odeCursorHint()
24c50 2a 2f 0a 20 20 20 20 69 6e 74 20 2a 61 69 43 6f */. int *aiCo
24c60 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l;
24c70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24c80 20 2f 2a 20 61 72 72 61 79 20 6f 66 20 63 6f 6c /* array of col
24c90 75 6d 6e 20 69 6e 64 65 78 65 73 20 2a 2f 0a 20 umn indexes */.
24ca0 20 20 20 73 74 72 75 63 74 20 49 64 78 43 6f 76 struct IdxCov
24cb0 65 72 20 2a 70 49 64 78 43 6f 76 65 72 3b 20 20 er *pIdxCover;
24cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24cd0 43 68 65 63 6b 20 66 6f 72 20 69 6e 64 65 78 20 Check for index
24ce0 63 6f 76 65 72 61 67 65 20 2a 2f 0a 20 20 20 20 coverage */.
24cf0 73 74 72 75 63 74 20 49 64 78 45 78 70 72 54 72 struct IdxExprTr
24d00 61 6e 73 20 2a 70 49 64 78 54 72 61 6e 73 3b 20 ans *pIdxTrans;
24d10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e /* Con
24d20 76 65 72 74 20 69 64 78 65 64 20 65 78 70 72 20 vert idxed expr
24d30 74 6f 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 20 to column */.
24d40 20 45 78 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 ExprList *pGrou
24d50 70 42 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 pBy;
24d60 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 47 52 /* GR
24d70 4f 55 50 20 42 59 20 63 6c 61 75 73 65 20 2a 2f OUP BY clause */
24d80 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65 . Select *pSe
24d90 6c 65 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 lect;
24da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
24db0 2a 20 48 41 56 49 4e 47 20 74 6f 20 57 48 45 52 * HAVING to WHER
24dc0 45 20 63 6c 61 75 73 65 20 63 74 78 20 2a 2f 0a E clause ctx */.
24dd0 20 20 7d 20 75 3b 0a 7d 3b 0a 0a 2f 2a 20 46 6f } u;.};../* Fo
24de0 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 6f rward declaratio
24df0 6e 73 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 ns */.int sqlite
24e00 33 57 61 6c 6b 45 78 70 72 28 57 61 6c 6b 65 72 3WalkExpr(Walker
24e10 2a 2c 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 *, Expr*);.int s
24e20 71 6c 69 74 65 33 57 61 6c 6b 45 78 70 72 4c 69 qlite3WalkExprLi
24e30 73 74 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 st(Walker*, Expr
24e40 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 List*);.int sqli
24e50 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 28 57 61 te3WalkSelect(Wa
24e60 6c 6b 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b lker*, Select*);
24e70 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 6b .int sqlite3Walk
24e80 53 65 6c 65 63 74 45 78 70 72 28 57 61 6c 6b 65 SelectExpr(Walke
24e90 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e r*, Select*);.in
24ea0 74 20 73 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c t sqlite3WalkSel
24eb0 65 63 74 46 72 6f 6d 28 57 61 6c 6b 65 72 2a 2c ectFrom(Walker*,
24ec0 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 Select*);.int s
24ed0 71 6c 69 74 65 33 45 78 70 72 57 61 6c 6b 4e 6f qlite3ExprWalkNo
24ee0 6f 70 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 op(Walker*, Expr
24ef0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 *);.int sqlite3S
24f00 65 6c 65 63 74 57 61 6c 6b 4e 6f 6f 70 28 57 61 electWalkNoop(Wa
24f10 6c 6b 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b lker*, Select*);
24f20 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 65 6c 65 .int sqlite3Sele
24f30 63 74 57 61 6c 6b 46 61 69 6c 28 57 61 6c 6b 65 ctWalkFail(Walke
24f40 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 23 69 r*, Select*);.#i
24f50 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
24f60 47 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 G.void sqlite3Se
24f70 6c 65 63 74 57 61 6c 6b 41 73 73 65 72 74 32 28 lectWalkAssert2(
24f80 57 61 6c 6b 65 72 2a 2c 20 53 65 6c 65 63 74 2a Walker*, Select*
24f90 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a );.#endif../*.**
24fa0 20 52 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f Return code fro
24fb0 6d 20 74 68 65 20 70 61 72 73 65 2d 74 72 65 65 m the parse-tree
24fc0 20 77 61 6c 6b 69 6e 67 20 70 72 69 6d 69 74 69 walking primiti
24fd0 76 65 73 20 61 6e 64 20 74 68 65 69 72 0a 2a 2a ves and their.**
24fe0 20 63 61 6c 6c 62 61 63 6b 73 2e 0a 2a 2f 0a 23 callbacks..*/.#
24ff0 64 65 66 69 6e 65 20 57 52 43 5f 43 6f 6e 74 69 define WRC_Conti
25000 6e 75 65 20 20 20 20 30 20 20 20 2f 2a 20 43 6f nue 0 /* Co
25010 6e 74 69 6e 75 65 20 64 6f 77 6e 20 69 6e 74 6f ntinue down into
25020 20 63 68 69 6c 64 72 65 6e 20 2a 2f 0a 23 64 65 children */.#de
25030 66 69 6e 65 20 57 52 43 5f 50 72 75 6e 65 20 20 fine WRC_Prune
25040 20 20 20 20 20 31 20 20 20 2f 2a 20 4f 6d 69 74 1 /* Omit
25050 20 63 68 69 6c 64 72 65 6e 20 62 75 74 20 63 6f children but co
25060 6e 74 69 6e 75 65 20 77 61 6c 6b 69 6e 67 20 73 ntinue walking s
25070 69 62 6c 69 6e 67 73 20 2a 2f 0a 23 64 65 66 69 iblings */.#defi
25080 6e 65 20 57 52 43 5f 41 62 6f 72 74 20 20 20 20 ne WRC_Abort
25090 20 20 20 32 20 20 20 2f 2a 20 41 62 61 6e 64 6f 2 /* Abando
250a0 6e 20 74 68 65 20 74 72 65 65 20 77 61 6c 6b 20 n the tree walk
250b0 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 */../*.** An ins
250c0 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 73 74 tance of this st
250d0 72 75 63 74 75 72 65 20 72 65 70 72 65 73 65 6e ructure represen
250e0 74 73 20 61 20 73 65 74 20 6f 66 20 6f 6e 65 20 ts a set of one
250f0 6f 72 20 6d 6f 72 65 20 43 54 45 73 0a 2a 2a 20 or more CTEs.**
25100 28 63 6f 6d 6d 6f 6e 20 74 61 62 6c 65 20 65 78 (common table ex
25110 70 72 65 73 73 69 6f 6e 73 29 20 63 72 65 61 74 pressions) creat
25120 65 64 20 62 79 20 61 20 73 69 6e 67 6c 65 20 57 ed by a single W
25130 49 54 48 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 73 ITH clause..*/.s
25140 74 72 75 63 74 20 57 69 74 68 20 7b 0a 20 20 69 truct With {. i
25150 6e 74 20 6e 43 74 65 3b 20 20 20 20 20 20 20 20 nt nCte;
25160 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
25170 2a 20 4e 75 6d 62 65 72 20 6f 66 20 43 54 45 73 * Number of CTEs
25180 20 69 6e 20 74 68 65 20 57 49 54 48 20 63 6c 61 in the WITH cla
25190 75 73 65 20 2a 2f 0a 20 20 57 69 74 68 20 2a 70 use */. With *p
251a0 4f 75 74 65 72 3b 20 20 20 20 20 20 20 20 20 20 Outer;
251b0 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 /* Cont
251c0 61 69 6e 69 6e 67 20 57 49 54 48 20 63 6c 61 75 aining WITH clau
251d0 73 65 2c 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 se, or NULL */.
251e0 20 73 74 72 75 63 74 20 43 74 65 20 7b 20 20 20 struct Cte {
251f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25200 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 43 54 45 /* For each CTE
25210 20 69 6e 20 74 68 65 20 57 49 54 48 20 63 6c 61 in the WITH cla
25220 75 73 65 2e 2e 2e 2e 20 2a 2f 0a 20 20 20 20 63 use.... */. c
25230 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
25240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
25250 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 43 * Name of this C
25260 54 45 20 2a 2f 0a 20 20 20 20 45 78 70 72 4c 69 TE */. ExprLi
25270 73 74 20 2a 70 43 6f 6c 73 3b 20 20 20 20 20 20 st *pCols;
25280 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 /* Lis
25290 74 20 6f 66 20 65 78 70 6c 69 63 69 74 20 63 6f t of explicit co
252a0 6c 75 6d 6e 20 6e 61 6d 65 73 2c 20 6f 72 20 4e lumn names, or N
252b0 55 4c 4c 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 ULL */. Selec
252c0 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 20 20 t *pSelect;
252d0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
252e0 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 e definition of
252f0 74 68 69 73 20 43 54 45 20 2a 2f 0a 20 20 20 20 this CTE */.
25300 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 74 65 const char *zCte
25310 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 Err;
25320 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 /* Error message
25330 20 66 6f 72 20 63 69 72 63 75 6c 61 72 20 72 65 for circular re
25340 66 65 72 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 ferences */. }
25350 61 5b 31 5d 3b 0a 7d 3b 0a 0a 23 69 66 64 65 66 a[1];.};..#ifdef
25360 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a SQLITE_DEBUG./*
25370 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
25380 6f 66 20 74 68 65 20 54 72 65 65 56 69 65 77 20 of the TreeView
25390 6f 62 6a 65 63 74 20 69 73 20 75 73 65 64 20 66 object is used f
253a0 6f 72 20 70 72 69 6e 74 69 6e 67 20 74 68 65 20 or printing the
253b0 63 6f 6e 74 65 6e 74 20 6f 66 0a 2a 2a 20 64 61 content of.** da
253c0 74 61 20 73 74 72 75 63 74 75 72 65 73 20 6f 6e ta structures on
253d0 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 sqlite3DebugPri
253e0 6e 74 66 28 29 20 75 73 69 6e 67 20 61 20 74 72 ntf() using a tr
253f0 65 65 2d 6c 69 6b 65 20 76 69 65 77 2e 0a 2a 2f ee-like view..*/
25400 0a 73 74 72 75 63 74 20 54 72 65 65 56 69 65 77 .struct TreeView
25410 20 7b 0a 20 20 69 6e 74 20 69 4c 65 76 65 6c 3b {. int iLevel;
25420 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
25430 57 68 69 63 68 20 6c 65 76 65 6c 20 6f 66 20 74 Which level of t
25440 68 65 20 74 72 65 65 20 77 65 20 61 72 65 20 6f he tree we are o
25450 6e 20 2a 2f 0a 20 20 75 38 20 20 62 4c 69 6e 65 n */. u8 bLine
25460 5b 31 30 30 5d 3b 20 20 20 20 20 20 20 20 20 2f [100]; /
25470 2a 20 44 72 61 77 20 76 65 72 74 69 63 61 6c 20 * Draw vertical
25480 69 6e 20 63 6f 6c 75 6d 6e 20 69 20 69 66 20 62 in column i if b
25490 4c 69 6e 65 5b 69 5d 20 69 73 20 74 72 75 65 20 Line[i] is true
254a0 2a 2f 0a 7d 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 */.};.#endif /*
254b0 53 51 4c 49 54 45 5f 44 45 42 55 47 20 2a 2f 0a SQLITE_DEBUG */.
254c0 0a 2f 2a 0a 2a 2a 20 41 73 73 75 6d 69 6e 67 20 ./*.** Assuming
254d0 7a 49 6e 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 zIn points to th
254e0 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 e first byte of
254f0 61 20 55 54 46 2d 38 20 63 68 61 72 61 63 74 65 a UTF-8 characte
25500 72 2c 0a 2a 2a 20 61 64 76 61 6e 63 65 20 7a 49 r,.** advance zI
25510 6e 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 n to point to th
25520 65 20 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 e first byte of
25530 74 68 65 20 6e 65 78 74 20 55 54 46 2d 38 20 63 the next UTF-8 c
25540 68 61 72 61 63 74 65 72 2e 0a 2a 2f 0a 23 64 65 haracter..*/.#de
25550 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 4b 49 50 fine SQLITE_SKIP
25560 5f 55 54 46 38 28 7a 49 6e 29 20 7b 20 20 20 20 _UTF8(zIn) {
25570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25580 20 20 20 20 5c 0a 20 20 69 66 28 20 28 2a 28 7a \. if( (*(z
25590 49 6e 2b 2b 29 29 3e 3d 30 78 63 30 20 29 7b 20 In++))>=0xc0 ){
255a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
255b0 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 \.
255c0 20 20 20 77 68 69 6c 65 28 20 28 2a 7a 49 6e 20 while( (*zIn
255d0 26 20 30 78 63 30 29 3d 3d 30 78 38 30 20 29 7b & 0xc0)==0x80 ){
255e0 20 7a 49 6e 2b 2b 3b 20 7d 20 20 20 20 20 20 20 zIn++; }
255f0 20 20 20 20 20 20 5c 0a 20 20 7d 20 20 20 20 20 \. }
25600 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
25630 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 .}../*.** The SQ
25640 4c 49 54 45 5f 2a 5f 42 4b 50 54 20 6d 61 63 72 LITE_*_BKPT macr
25650 6f 73 20 61 72 65 20 73 75 62 73 74 69 74 75 74 os are substitut
25660 65 73 20 66 6f 72 20 74 68 65 20 65 72 72 6f 72 es for the error
25670 20 63 6f 64 65 73 20 77 69 74 68 0a 2a 2a 20 74 codes with.** t
25680 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 62 75 74 he same name but
25690 20 77 69 74 68 6f 75 74 20 74 68 65 20 5f 42 4b without the _BK
256a0 50 54 20 73 75 66 66 69 78 2e 20 20 54 68 65 73 PT suffix. Thes
256b0 65 20 6d 61 63 72 6f 73 20 69 6e 76 6f 6b 65 0a e macros invoke.
256c0 2a 2a 20 72 6f 75 74 69 6e 65 73 20 74 68 61 74 ** routines that
256d0 20 72 65 70 6f 72 74 20 74 68 65 20 6c 69 6e 65 report the line
256e0 2d 6e 75 6d 62 65 72 20 6f 6e 20 77 68 69 63 68 -number on which
256f0 20 74 68 65 20 65 72 72 6f 72 20 6f 72 69 67 69 the error origi
25700 6e 61 74 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 nated.** using s
25710 71 6c 69 74 65 33 5f 6c 6f 67 28 29 2e 20 20 54 qlite3_log(). T
25720 68 65 20 72 6f 75 74 69 6e 65 73 20 61 6c 73 6f he routines also
25730 20 70 72 6f 76 69 64 65 20 61 20 63 6f 6e 76 65 provide a conve
25740 6e 69 65 6e 74 20 70 6c 61 63 65 0a 2a 2a 20 74 nient place.** t
25750 6f 20 73 65 74 20 61 20 64 65 62 75 67 67 65 72 o set a debugger
25760 20 62 72 65 61 6b 70 6f 69 6e 74 2e 0a 2a 2f 0a breakpoint..*/.
25770 69 6e 74 20 73 71 6c 69 74 65 33 52 65 70 6f 72 int sqlite3Repor
25780 74 45 72 72 6f 72 28 69 6e 74 20 69 45 72 72 2c tError(int iErr,
25790 20 69 6e 74 20 6c 69 6e 65 6e 6f 2c 20 63 6f 6e int lineno, con
257a0 73 74 20 63 68 61 72 20 2a 7a 54 79 70 65 29 3b st char *zType);
257b0 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 72 .int sqlite3Corr
257c0 75 70 74 45 72 72 6f 72 28 69 6e 74 29 3b 0a 69 uptError(int);.i
257d0 6e 74 20 73 71 6c 69 74 65 33 4d 69 73 75 73 65 nt sqlite3Misuse
257e0 45 72 72 6f 72 28 69 6e 74 29 3b 0a 69 6e 74 20 Error(int);.int
257f0 73 71 6c 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 sqlite3CantopenE
25800 72 72 6f 72 28 69 6e 74 29 3b 0a 23 64 65 66 69 rror(int);.#defi
25810 6e 65 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 ne SQLITE_CORRUP
25820 54 5f 42 4b 50 54 20 73 71 6c 69 74 65 33 43 6f T_BKPT sqlite3Co
25830 72 72 75 70 74 45 72 72 6f 72 28 5f 5f 4c 49 4e rruptError(__LIN
25840 45 5f 5f 29 0a 23 64 65 66 69 6e 65 20 53 51 4c E__).#define SQL
25850 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 20 ITE_MISUSE_BKPT
25860 73 71 6c 69 74 65 33 4d 69 73 75 73 65 45 72 72 sqlite3MisuseErr
25870 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 64 65 or(__LINE__).#de
25880 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 fine SQLITE_CANT
25890 4f 50 45 4e 5f 42 4b 50 54 20 73 71 6c 69 74 65 OPEN_BKPT sqlite
258a0 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f 72 28 5f 3CantopenError(_
258b0 5f 4c 49 4e 45 5f 5f 29 0a 23 69 66 64 65 66 20 _LINE__).#ifdef
258c0 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 69 SQLITE_DEBUG. i
258d0 6e 74 20 73 71 6c 69 74 65 33 4e 6f 6d 65 6d 45 nt sqlite3NomemE
258e0 72 72 6f 72 28 69 6e 74 29 3b 0a 20 20 69 6e 74 rror(int);. int
258f0 20 73 71 6c 69 74 65 33 49 6f 65 72 72 6e 6f 6d sqlite3Ioerrnom
25900 65 6d 45 72 72 6f 72 28 69 6e 74 29 3b 0a 20 20 emError(int);.
25910 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 72 72 75 int sqlite3Corru
25920 70 74 50 67 6e 6f 45 72 72 6f 72 28 69 6e 74 2c ptPgnoError(int,
25930 50 67 6e 6f 29 3b 0a 23 20 64 65 66 69 6e 65 20 Pgno);.# define
25940 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
25950 54 20 73 71 6c 69 74 65 33 4e 6f 6d 65 6d 45 72 T sqlite3NomemEr
25960 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 20 ror(__LINE__).#
25970 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4f define SQLITE_IO
25980 45 52 52 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 73 ERR_NOMEM_BKPT s
25990 71 6c 69 74 65 33 49 6f 65 72 72 6e 6f 6d 65 6d qlite3Ioerrnomem
259a0 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a Error(__LINE__).
259b0 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
259c0 43 4f 52 52 55 50 54 5f 50 47 4e 4f 28 50 29 20 CORRUPT_PGNO(P)
259d0 73 71 6c 69 74 65 33 43 6f 72 72 75 70 74 50 67 sqlite3CorruptPg
259e0 6e 6f 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f noError(__LINE__
259f0 2c 28 50 29 29 0a 23 65 6c 73 65 0a 23 20 64 65 ,(P)).#else.# de
25a00 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 fine SQLITE_NOME
25a10 4d 5f 42 4b 50 54 20 53 51 4c 49 54 45 5f 4e 4f M_BKPT SQLITE_NO
25a20 4d 45 4d 0a 23 20 64 65 66 69 6e 65 20 53 51 4c MEM.# define SQL
25a30 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 5f ITE_IOERR_NOMEM_
25a40 42 4b 50 54 20 53 51 4c 49 54 45 5f 49 4f 45 52 BKPT SQLITE_IOER
25a50 52 5f 4e 4f 4d 45 4d 0a 23 20 64 65 66 69 6e 65 R_NOMEM.# define
25a60 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f SQLITE_CORRUPT_
25a70 50 47 4e 4f 28 50 29 20 73 71 6c 69 74 65 33 43 PGNO(P) sqlite3C
25a80 6f 72 72 75 70 74 45 72 72 6f 72 28 5f 5f 4c 49 orruptError(__LI
25a90 4e 45 5f 5f 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a NE__).#endif../*
25aa0 0a 2a 2a 20 46 54 53 33 20 61 6e 64 20 46 54 53 .** FTS3 and FTS
25ab0 34 20 62 6f 74 68 20 72 65 71 75 69 72 65 20 76 4 both require v
25ac0 69 72 74 75 61 6c 20 74 61 62 6c 65 20 73 75 70 irtual table sup
25ad0 70 6f 72 74 0a 2a 2f 0a 23 69 66 20 64 65 66 69 port.*/.#if defi
25ae0 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
25af0 56 49 52 54 55 41 4c 54 41 42 4c 45 29 0a 23 20 VIRTUALTABLE).#
25b00 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 undef SQLITE_ENA
25b10 42 4c 45 5f 46 54 53 33 0a 23 20 75 6e 64 65 66 BLE_FTS3.# undef
25b20 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
25b30 54 53 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a TS4.#endif../*.*
25b40 2a 20 46 54 53 34 20 69 73 20 72 65 61 6c 6c 79 * FTS4 is really
25b50 20 61 6e 20 65 78 74 65 6e 73 69 6f 6e 20 66 6f an extension fo
25b60 72 20 46 54 53 33 2e 20 20 49 74 20 69 73 20 65 r FTS3. It is e
25b70 6e 61 62 6c 65 64 20 75 73 69 6e 67 20 74 68 65 nabled using the
25b80 0a 2a 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c .** SQLITE_ENABL
25b90 45 5f 46 54 53 33 20 6d 61 63 72 6f 2e 20 20 42 E_FTS3 macro. B
25ba0 75 74 20 74 6f 20 61 76 6f 69 64 20 63 6f 6e 66 ut to avoid conf
25bb0 75 73 69 6f 6e 20 77 65 20 61 6c 73 6f 20 63 61 usion we also ca
25bc0 6c 6c 0a 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 ll.** the SQLITE
25bd0 5f 45 4e 41 42 4c 45 5f 46 54 53 34 20 6d 61 63 _ENABLE_FTS4 mac
25be0 72 6f 20 74 6f 20 73 65 72 76 65 20 61 73 20 61 ro to serve as a
25bf0 6e 20 61 6c 69 61 73 20 66 6f 72 20 53 51 4c 49 n alias for SQLI
25c00 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 2e 0a TE_ENABLE_FTS3..
25c10 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
25c20 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 QLITE_ENABLE_FTS
25c30 34 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 4) && !defined(S
25c40 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 QLITE_ENABLE_FTS
25c50 33 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 3).# define SQLI
25c60 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 20 31 TE_ENABLE_FTS3 1
25c70 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
25c80 68 65 20 63 74 79 70 65 2e 68 20 68 65 61 64 65 he ctype.h heade
25c90 72 20 69 73 20 6e 65 65 64 65 64 20 66 6f 72 20 r is needed for
25ca0 6e 6f 6e 2d 41 53 43 49 49 20 73 79 73 74 65 6d non-ASCII system
25cb0 73 2e 20 20 49 74 20 69 73 20 61 6c 73 6f 0a 2a s. It is also.*
25cc0 2a 20 6e 65 65 64 65 64 20 62 79 20 46 54 53 33 * needed by FTS3
25cd0 20 77 68 65 6e 20 46 54 53 33 20 69 73 20 69 6e when FTS3 is in
25ce0 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 61 6d cluded in the am
25cf0 61 6c 67 61 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 algamation..*/.#
25d00 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
25d10 54 45 5f 41 53 43 49 49 29 20 7c 7c 20 5c 0a 20 TE_ASCII) || \.
25d20 20 20 20 28 64 65 66 69 6e 65 64 28 53 51 4c 49 (defined(SQLI
25d30 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 29 20 TE_ENABLE_FTS3)
25d40 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 && defined(SQLIT
25d50 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 29 29 E_AMALGAMATION))
25d60 0a 23 20 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 .# include <ctyp
25d70 65 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a e.h>.#endif../*.
25d80 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
25d90 20 6d 61 63 72 6f 73 20 6d 69 6d 69 63 20 74 68 macros mimic th
25da0 65 20 73 74 61 6e 64 61 72 64 20 6c 69 62 72 61 e standard libra
25db0 72 79 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 75 ry functions tou
25dc0 70 70 65 72 28 29 2c 0a 2a 2a 20 69 73 73 70 61 pper(),.** isspa
25dd0 63 65 28 29 2c 20 69 73 61 6c 6e 75 6d 28 29 2c ce(), isalnum(),
25de0 20 69 73 64 69 67 69 74 28 29 20 61 6e 64 20 69 isdigit() and i
25df0 73 78 64 69 67 69 74 28 29 2c 20 72 65 73 70 65 sxdigit(), respe
25e00 63 74 69 76 65 6c 79 2e 20 54 68 65 0a 2a 2a 20 ctively. The.**
25e10 73 71 6c 69 74 65 20 76 65 72 73 69 6f 6e 73 20 sqlite versions
25e20 6f 6e 6c 79 20 77 6f 72 6b 20 66 6f 72 20 41 53 only work for AS
25e30 43 49 49 20 63 68 61 72 61 63 74 65 72 73 2c 20 CII characters,
25e40 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 6c 6f regardless of lo
25e50 63 61 6c 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 cale..*/.#ifdef
25e60 53 51 4c 49 54 45 5f 41 53 43 49 49 0a 23 20 64 SQLITE_ASCII.# d
25e70 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f 75 efine sqlite3Tou
25e80 70 70 65 72 28 78 29 20 20 28 28 78 29 26 7e 28 pper(x) ((x)&~(
25e90 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b sqlite3CtypeMap[
25ea0 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
25eb0 78 29 5d 26 30 78 32 30 29 29 0a 23 20 64 65 66 x)]&0x20)).# def
25ec0 69 6e 65 20 73 71 6c 69 74 65 33 49 73 73 70 61 ine sqlite3Isspa
25ed0 63 65 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 ce(x) (sqlite3
25ee0 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e CtypeMap[(unsign
25ef0 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 ed char)(x)]&0x0
25f00 31 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 1).# define sqli
25f10 74 65 33 49 73 61 6c 6e 75 6d 28 78 29 20 20 20 te3Isalnum(x)
25f20 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 (sqlite3CtypeMap
25f30 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 [(unsigned char)
25f40 28 78 29 5d 26 30 78 30 36 29 0a 23 20 64 65 66 (x)]&0x06).# def
25f50 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 6c 70 ine sqlite3Isalp
25f60 68 61 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 ha(x) (sqlite3
25f70 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e CtypeMap[(unsign
25f80 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 ed char)(x)]&0x0
25f90 32 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 2).# define sqli
25fa0 74 65 33 49 73 64 69 67 69 74 28 78 29 20 20 20 te3Isdigit(x)
25fb0 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 (sqlite3CtypeMap
25fc0 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 [(unsigned char)
25fd0 28 78 29 5d 26 30 78 30 34 29 0a 23 20 64 65 66 (x)]&0x04).# def
25fe0 69 6e 65 20 73 71 6c 69 74 65 33 49 73 78 64 69 ine sqlite3Isxdi
25ff0 67 69 74 28 78 29 20 20 28 73 71 6c 69 74 65 33 git(x) (sqlite3
26000 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e CtypeMap[(unsign
26010 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 ed char)(x)]&0x0
26020 38 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 8).# define sqli
26030 74 65 33 54 6f 6c 6f 77 65 72 28 78 29 20 20 20 te3Tolower(x)
26040 28 73 71 6c 69 74 65 33 55 70 70 65 72 54 6f 4c (sqlite3UpperToL
26050 6f 77 65 72 5b 28 75 6e 73 69 67 6e 65 64 20 63 ower[(unsigned c
26060 68 61 72 29 28 78 29 5d 29 0a 23 20 64 65 66 69 har)(x)]).# defi
26070 6e 65 20 73 71 6c 69 74 65 33 49 73 71 75 6f 74 ne sqlite3Isquot
26080 65 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 e(x) (sqlite3C
26090 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 typeMap[(unsigne
260a0 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 38 30 d char)(x)]&0x80
260b0 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ).#else.# define
260c0 20 73 71 6c 69 74 65 33 54 6f 75 70 70 65 72 28 sqlite3Toupper(
260d0 78 29 20 20 20 74 6f 75 70 70 65 72 28 28 75 6e x) toupper((un
260e0 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 signed char)(x))
260f0 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
26100 33 49 73 73 70 61 63 65 28 78 29 20 20 20 69 73 3Isspace(x) is
26110 73 70 61 63 65 28 28 75 6e 73 69 67 6e 65 64 20 space((unsigned
26120 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 char)(x)).# defi
26130 6e 65 20 73 71 6c 69 74 65 33 49 73 61 6c 6e 75 ne sqlite3Isalnu
26140 6d 28 78 29 20 20 20 69 73 61 6c 6e 75 6d 28 28 m(x) isalnum((
26150 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 unsigned char)(x
26160 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 )).# define sqli
26170 74 65 33 49 73 61 6c 70 68 61 28 78 29 20 20 20 te3Isalpha(x)
26180 69 73 61 6c 70 68 61 28 28 75 6e 73 69 67 6e 65 isalpha((unsigne
26190 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 d char)(x)).# de
261a0 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 64 69 fine sqlite3Isdi
261b0 67 69 74 28 78 29 20 20 20 69 73 64 69 67 69 74 git(x) isdigit
261c0 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 ((unsigned char)
261d0 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 (x)).# define sq
261e0 6c 69 74 65 33 49 73 78 64 69 67 69 74 28 78 29 lite3Isxdigit(x)
261f0 20 20 69 73 78 64 69 67 69 74 28 28 75 6e 73 69 isxdigit((unsi
26200 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 gned char)(x)).#
26210 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 define sqlite3T
26220 6f 6c 6f 77 65 72 28 78 29 20 20 20 74 6f 6c 6f olower(x) tolo
26230 77 65 72 28 28 75 6e 73 69 67 6e 65 64 20 63 68 wer((unsigned ch
26240 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 ar)(x)).# define
26250 20 73 71 6c 69 74 65 33 49 73 71 75 6f 74 65 28 sqlite3Isquote(
26260 78 29 20 20 20 28 28 78 29 3d 3d 27 22 27 7c 7c x) ((x)=='"'||
26270 28 78 29 3d 3d 27 5c 27 27 7c 7c 28 78 29 3d 3d (x)=='\''||(x)==
26280 27 5b 27 7c 7c 28 78 29 3d 3d 27 60 27 29 0a 23 '['||(x)=='`').#
26290 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 endif.#ifndef SQ
262a0 4c 49 54 45 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c LITE_OMIT_COMPIL
262b0 45 4f 50 54 49 4f 4e 5f 44 49 41 47 53 0a 69 6e EOPTION_DIAGS.in
262c0 74 20 73 71 6c 69 74 65 33 49 73 49 64 43 68 61 t sqlite3IsIdCha
262d0 72 28 75 38 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f r(u8);.#endif../
262e0 2a 0a 2a 2a 20 49 6e 74 65 72 6e 61 6c 20 66 75 *.** Internal fu
262f0 6e 63 74 69 6f 6e 20 70 72 6f 74 6f 74 79 70 65 nction prototype
26300 73 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 s.*/.int sqlite3
26310 53 74 72 49 43 6d 70 28 63 6f 6e 73 74 20 63 68 StrICmp(const ch
26320 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 ar*,const char*)
26330 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 72 ;.int sqlite3Str
26340 6c 65 6e 33 30 28 63 6f 6e 73 74 20 63 68 61 72 len30(const char
26350 2a 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 *);.char *sqlite
26360 33 43 6f 6c 75 6d 6e 54 79 70 65 28 43 6f 6c 75 3ColumnType(Colu
26370 6d 6e 2a 2c 63 68 61 72 2a 29 3b 0a 23 64 65 66 mn*,char*);.#def
26380 69 6e 65 20 73 71 6c 69 74 65 33 53 74 72 4e 49 ine sqlite3StrNI
26390 43 6d 70 20 73 71 6c 69 74 65 33 5f 73 74 72 6e Cmp sqlite3_strn
263a0 69 63 6d 70 0a 0a 69 6e 74 20 73 71 6c 69 74 65 icmp..int sqlite
263b0 33 4d 61 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 3MallocInit(void
263c0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d );.void sqlite3M
263d0 61 6c 6c 6f 63 45 6e 64 28 76 6f 69 64 29 3b 0a allocEnd(void);.
263e0 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c void *sqlite3Mal
263f0 6c 6f 63 28 75 36 34 29 3b 0a 76 6f 69 64 20 2a loc(u64);.void *
26400 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 sqlite3MallocZer
26410 6f 28 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 o(u64);.void *sq
26420 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 lite3DbMallocZer
26430 6f 28 73 71 6c 69 74 65 33 2a 2c 20 75 36 34 29 o(sqlite3*, u64)
26440 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 ;.void *sqlite3D
26450 62 4d 61 6c 6c 6f 63 52 61 77 28 73 71 6c 69 74 bMallocRaw(sqlit
26460 65 33 2a 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 e3*, u64);.void
26470 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 *sqlite3DbMalloc
26480 52 61 77 4e 4e 28 73 71 6c 69 74 65 33 2a 2c 20 RawNN(sqlite3*,
26490 75 36 34 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 u64);.char *sqli
264a0 74 65 33 44 62 53 74 72 44 75 70 28 73 71 6c 69 te3DbStrDup(sqli
264b0 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
264c0 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
264d0 44 62 53 74 72 4e 44 75 70 28 73 71 6c 69 74 65 DbStrNDup(sqlite
264e0 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 3*,const char*,
264f0 75 36 34 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 u64);.char *sqli
26500 74 65 33 44 62 53 70 61 6e 44 75 70 28 73 71 6c te3DbSpanDup(sql
26510 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 ite3*,const char
26520 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a *,const char*);.
26530 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 52 65 61 void *sqlite3Rea
26540 6c 6c 6f 63 28 76 6f 69 64 2a 2c 20 75 36 34 29 lloc(void*, u64)
26550 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 ;.void *sqlite3D
26560 62 52 65 61 6c 6c 6f 63 4f 72 46 72 65 65 28 73 bReallocOrFree(s
26570 71 6c 69 74 65 33 20 2a 2c 20 76 6f 69 64 20 2a qlite3 *, void *
26580 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 , u64);.void *sq
26590 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 lite3DbRealloc(s
265a0 71 6c 69 74 65 33 20 2a 2c 20 76 6f 69 64 20 2a qlite3 *, void *
265b0 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 73 71 6c , u64);.void sql
265c0 69 74 65 33 44 62 46 72 65 65 28 73 71 6c 69 74 ite3DbFree(sqlit
265d0 65 33 2a 2c 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 e3*, void*);.voi
265e0 64 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 4e d sqlite3DbFreeN
265f0 4e 28 73 71 6c 69 74 65 33 2a 2c 20 76 6f 69 64 N(sqlite3*, void
26600 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d *);.int sqlite3M
26610 61 6c 6c 6f 63 53 69 7a 65 28 76 6f 69 64 2a 29 allocSize(void*)
26620 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 62 4d ;.int sqlite3DbM
26630 61 6c 6c 6f 63 53 69 7a 65 28 73 71 6c 69 74 65 allocSize(sqlite
26640 33 2a 2c 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 3*, void*);.void
26650 20 2a 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c *sqlite3PageMal
26660 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 loc(int);.void s
26670 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 76 qlite3PageFree(v
26680 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 oid*);.void sqli
26690 74 65 33 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 te3MemSetDefault
266a0 28 76 6f 69 64 29 3b 0a 23 69 66 6e 64 65 66 20 (void);.#ifndef
266b0 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
266c0 45 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 65 E.void sqlite3Be
266d0 6e 69 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 nignMallocHooks(
266e0 76 6f 69 64 20 28 2a 29 28 76 6f 69 64 29 2c 20 void (*)(void),
266f0 76 6f 69 64 20 28 2a 29 28 76 6f 69 64 29 29 3b void (*)(void));
26700 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 .#endif.int sqli
26710 74 65 33 48 65 61 70 4e 65 61 72 6c 79 46 75 6c te3HeapNearlyFul
26720 6c 28 76 6f 69 64 29 3b 0a 0a 2f 2a 0a 2a 2a 20 l(void);../*.**
26730 4f 6e 20 73 79 73 74 65 6d 73 20 77 69 74 68 20 On systems with
26740 61 6d 70 6c 65 20 73 74 61 63 6b 20 73 70 61 63 ample stack spac
26750 65 20 61 6e 64 20 74 68 61 74 20 73 75 70 70 6f e and that suppo
26760 72 74 20 61 6c 6c 6f 63 61 28 29 2c 20 6d 61 6b rt alloca(), mak
26770 65 0a 2a 2a 20 75 73 65 20 6f 66 20 61 6c 6c 6f e.** use of allo
26780 63 61 28 29 20 74 6f 20 6f 62 74 61 69 6e 20 73 ca() to obtain s
26790 70 61 63 65 20 66 6f 72 20 6c 61 72 67 65 20 61 pace for large a
267a0 75 74 6f 6d 61 74 69 63 20 6f 62 6a 65 63 74 73 utomatic objects
267b0 2e 20 20 42 79 20 64 65 66 61 75 6c 74 2c 0a 2a . By default,.*
267c0 2a 20 6f 62 74 61 69 6e 20 73 70 61 63 65 20 66 * obtain space f
267d0 72 6f 6d 20 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a rom malloc()..**
267e0 0a 2a 2a 20 54 68 65 20 61 6c 6c 6f 63 61 28 29 .** The alloca()
267f0 20 72 6f 75 74 69 6e 65 20 6e 65 76 65 72 20 72 routine never r
26800 65 74 75 72 6e 73 20 4e 55 4c 4c 2e 20 20 54 68 eturns NULL. Th
26810 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 63 6f is will cause co
26820 64 65 20 70 61 74 68 73 0a 2a 2a 20 74 68 61 74 de paths.** that
26830 20 64 65 61 6c 20 77 69 74 68 20 73 71 6c 69 74 deal with sqlit
26840 65 33 53 74 61 63 6b 41 6c 6c 6f 63 28 29 20 66 e3StackAlloc() f
26850 61 69 6c 75 72 65 73 20 74 6f 20 62 65 20 75 6e ailures to be un
26860 72 65 61 63 68 61 62 6c 65 2e 0a 2a 2f 0a 23 69 reachable..*/.#i
26870 66 64 65 66 20 53 51 4c 49 54 45 5f 55 53 45 5f fdef SQLITE_USE_
26880 41 4c 4c 4f 43 41 0a 23 20 64 65 66 69 6e 65 20 ALLOCA.# define
26890 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f sqlite3StackAllo
268a0 63 52 61 77 28 44 2c 4e 29 20 20 20 61 6c 6c 6f cRaw(D,N) allo
268b0 63 61 28 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 ca(N).# define s
268c0 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 qlite3StackAlloc
268d0 5a 65 72 6f 28 44 2c 4e 29 20 20 6d 65 6d 73 65 Zero(D,N) memse
268e0 74 28 61 6c 6c 6f 63 61 28 4e 29 2c 20 30 2c 20 t(alloca(N), 0,
268f0 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 N).# define sqli
26900 74 65 33 53 74 61 63 6b 46 72 65 65 28 44 2c 50 te3StackFree(D,P
26910 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ).#else.# define
26920 20 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c sqlite3StackAll
26930 6f 63 52 61 77 28 44 2c 4e 29 20 20 20 73 71 6c ocRaw(D,N) sql
26940 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 ite3DbMallocRaw(
26950 44 2c 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 D,N).# define sq
26960 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 5a lite3StackAllocZ
26970 65 72 6f 28 44 2c 4e 29 20 20 73 71 6c 69 74 65 ero(D,N) sqlite
26980 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 44 2c 3DbMallocZero(D,
26990 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 N).# define sqli
269a0 74 65 33 53 74 61 63 6b 46 72 65 65 28 44 2c 50 te3StackFree(D,P
269b0 29 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 ) sqlite3D
269c0 62 46 72 65 65 28 44 2c 50 29 0a 23 65 6e 64 69 bFree(D,P).#endi
269d0 66 0a 0a 2f 2a 20 44 6f 20 6e 6f 74 20 61 6c 6c f../* Do not all
269e0 6f 77 20 62 6f 74 68 20 4d 45 4d 53 59 53 35 20 ow both MEMSYS5
269f0 61 6e 64 20 4d 45 4d 53 59 53 33 20 74 6f 20 62 and MEMSYS3 to b
26a00 65 20 64 65 66 69 6e 65 64 20 74 6f 67 65 74 68 e defined togeth
26a10 65 72 2e 20 20 49 66 20 74 68 65 79 0a 2a 2a 20 er. If they.**
26a20 61 72 65 2c 20 64 69 73 61 62 6c 65 20 4d 45 4d are, disable MEM
26a30 53 59 53 33 0a 2a 2f 0a 23 69 66 64 65 66 20 53 SYS3.*/.#ifdef S
26a40 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d QLITE_ENABLE_MEM
26a50 53 59 53 35 0a 63 6f 6e 73 74 20 73 71 6c 69 74 SYS5.const sqlit
26a60 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 2a e3_mem_methods *
26a70 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d sqlite3MemGetMem
26a80 73 79 73 35 28 76 6f 69 64 29 3b 0a 23 75 6e 64 sys5(void);.#und
26a90 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
26aa0 5f 4d 45 4d 53 59 53 33 0a 23 65 6e 64 69 66 0a _MEMSYS3.#endif.
26ab0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
26ac0 41 42 4c 45 5f 4d 45 4d 53 59 53 33 0a 63 6f 6e ABLE_MEMSYS3.con
26ad0 73 74 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d st sqlite3_mem_m
26ae0 65 74 68 6f 64 73 20 2a 73 71 6c 69 74 65 33 4d ethods *sqlite3M
26af0 65 6d 47 65 74 4d 65 6d 73 79 73 33 28 76 6f 69 emGetMemsys3(voi
26b00 64 29 3b 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 d);.#endif...#if
26b10 6e 64 65 66 20 53 51 4c 49 54 45 5f 4d 55 54 45 ndef SQLITE_MUTE
26b20 58 5f 4f 4d 49 54 0a 20 20 73 71 6c 69 74 65 33 X_OMIT. sqlite3
26b30 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 _mutex_methods c
26b40 6f 6e 73 74 20 2a 73 71 6c 69 74 65 33 44 65 66 onst *sqlite3Def
26b50 61 75 6c 74 4d 75 74 65 78 28 76 6f 69 64 29 3b aultMutex(void);
26b60 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
26b70 5f 6d 65 74 68 6f 64 73 20 63 6f 6e 73 74 20 2a _methods const *
26b80 73 71 6c 69 74 65 33 4e 6f 6f 70 4d 75 74 65 78 sqlite3NoopMutex
26b90 28 76 6f 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 (void);. sqlite
26ba0 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 3_mutex *sqlite3
26bb0 4d 75 74 65 78 41 6c 6c 6f 63 28 69 6e 74 29 3b MutexAlloc(int);
26bc0 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4d 75 . int sqlite3Mu
26bd0 74 65 78 49 6e 69 74 28 76 6f 69 64 29 3b 0a 20 texInit(void);.
26be0 20 69 6e 74 20 73 71 6c 69 74 65 33 4d 75 74 65 int sqlite3Mute
26bf0 78 45 6e 64 28 76 6f 69 64 29 3b 0a 23 65 6e 64 xEnd(void);.#end
26c00 69 66 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 if.#if !defined(
26c10 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 4f 4d 49 SQLITE_MUTEX_OMI
26c20 54 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 T) && !defined(S
26c30 51 4c 49 54 45 5f 4d 55 54 45 58 5f 4e 4f 4f 50 QLITE_MUTEX_NOOP
26c40 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ). void sqlite3
26c50 4d 65 6d 6f 72 79 42 61 72 72 69 65 72 28 76 6f MemoryBarrier(vo
26c60 69 64 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 id);.#else.# def
26c70 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 ine sqlite3Memor
26c80 79 42 61 72 72 69 65 72 28 29 0a 23 65 6e 64 69 yBarrier().#endi
26c90 66 0a 0a 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 f..sqlite3_int64
26ca0 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 56 61 sqlite3StatusVa
26cb0 6c 75 65 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 lue(int);.void s
26cc0 71 6c 69 74 65 33 53 74 61 74 75 73 55 70 28 69 qlite3StatusUp(i
26cd0 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
26ce0 71 6c 69 74 65 33 53 74 61 74 75 73 44 6f 77 6e qlite3StatusDown
26cf0 28 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 (int, int);.void
26d00 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 48 69 sqlite3StatusHi
26d10 67 68 77 61 74 65 72 28 69 6e 74 2c 20 69 6e 74 ghwater(int, int
26d20 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4c 6f );.int sqlite3Lo
26d30 6f 6b 61 73 69 64 65 55 73 65 64 28 73 71 6c 69 okasideUsed(sqli
26d40 74 65 33 2a 2c 69 6e 74 2a 29 3b 0a 0a 2f 2a 20 te3*,int*);../*
26d50 41 63 63 65 73 73 20 74 6f 20 6d 75 74 65 78 65 Access to mutexe
26d60 73 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 65 s used by sqlite
26d70 33 5f 73 74 61 74 75 73 28 29 20 2a 2f 0a 73 71 3_status() */.sq
26d80 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c lite3_mutex *sql
26d90 69 74 65 33 50 63 61 63 68 65 31 4d 75 74 65 78 ite3Pcache1Mutex
26da0 28 76 6f 69 64 29 3b 0a 73 71 6c 69 74 65 33 5f (void);.sqlite3_
26db0 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 4d 61 mutex *sqlite3Ma
26dc0 6c 6c 6f 63 4d 75 74 65 78 28 76 6f 69 64 29 3b llocMutex(void);
26dd0 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 ..#if defined(SQ
26de0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 55 4c 54 LITE_ENABLE_MULT
26df0 49 54 48 52 45 41 44 45 44 5f 43 48 45 43 4b 53 ITHREADED_CHECKS
26e00 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 ) && !defined(SQ
26e10 4c 49 54 45 5f 4d 55 54 45 58 5f 4f 4d 49 54 29 LITE_MUTEX_OMIT)
26e20 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 75 74 .void sqlite3Mut
26e30 65 78 57 61 72 6e 4f 6e 43 6f 6e 74 65 6e 74 69 exWarnOnContenti
26e40 6f 6e 28 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 on(sqlite3_mutex
26e50 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 *);.#else.# defi
26e60 6e 65 20 73 71 6c 69 74 65 33 4d 75 74 65 78 57 ne sqlite3MutexW
26e70 61 72 6e 4f 6e 43 6f 6e 74 65 6e 74 69 6f 6e 28 arnOnContention(
26e80 78 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 x).#endif..#ifnd
26e90 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 ef SQLITE_OMIT_F
26ea0 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 LOATING_POINT.
26eb0 69 6e 74 20 73 71 6c 69 74 65 33 49 73 4e 61 4e int sqlite3IsNaN
26ec0 28 64 6f 75 62 6c 65 29 3b 0a 23 65 6c 73 65 0a (double);.#else.
26ed0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
26ee0 49 73 4e 61 4e 28 58 29 20 20 30 0a 23 65 6e 64 IsNaN(X) 0.#end
26ef0 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 if../*.** An ins
26f00 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c tance of the fol
26f10 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 lowing structure
26f20 20 68 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 holds informati
26f30 6f 6e 20 61 62 6f 75 74 20 53 51 4c 0a 2a 2a 20 on about SQL.**
26f40 66 75 6e 63 74 69 6f 6e 73 20 61 72 67 75 6d 65 functions argume
26f50 6e 74 73 20 74 68 61 74 20 61 72 65 20 74 68 65 nts that are the
26f60 20 70 61 72 61 6d 65 74 65 72 73 20 74 6f 20 74 parameters to t
26f70 68 65 20 70 72 69 6e 74 66 28 29 20 66 75 6e 63 he printf() func
26f80 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 tion..*/.struct
26f90 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 PrintfArguments
26fa0 7b 0a 20 20 69 6e 74 20 6e 41 72 67 3b 20 20 20 {. int nArg;
26fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
26fc0 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 Total number of
26fd0 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 69 arguments */. i
26fe0 6e 74 20 6e 55 73 65 64 3b 20 20 20 20 20 20 20 nt nUsed;
26ff0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
27000 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 75 r of arguments u
27010 73 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 sed so far */.
27020 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a sqlite3_value **
27030 61 70 41 72 67 3b 20 20 20 2f 2a 20 54 68 65 20 apArg; /* The
27040 61 72 67 75 6d 65 6e 74 20 76 61 6c 75 65 73 20 argument values
27050 2a 2f 0a 7d 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 */.};..void sqli
27060 74 65 33 56 58 50 72 69 6e 74 66 28 53 74 72 41 te3VXPrintf(StrA
27070 63 63 75 6d 2a 2c 20 63 6f 6e 73 74 20 63 68 61 ccum*, const cha
27080 72 2a 2c 20 76 61 5f 6c 69 73 74 29 3b 0a 76 6f r*, va_list);.vo
27090 69 64 20 73 71 6c 69 74 65 33 58 50 72 69 6e 74 id sqlite3XPrint
270a0 66 28 53 74 72 41 63 63 75 6d 2a 2c 20 63 6f 6e f(StrAccum*, con
270b0 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a st char*, ...);.
270c0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4d 50 72 char *sqlite3MPr
270d0 69 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c 63 6f intf(sqlite3*,co
270e0 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b nst char*, ...);
270f0 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 4d .char *sqlite3VM
27100 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c Printf(sqlite3*,
27110 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 76 61 5f const char*, va_
27120 6c 69 73 74 29 3b 0a 23 69 66 20 64 65 66 69 6e list);.#if defin
27130 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 ed(SQLITE_DEBUG)
27140 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 || defined(SQLI
27150 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 41 43 45 TE_HAVE_OS_TRACE
27160 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ). void sqlite3
27170 44 65 62 75 67 50 72 69 6e 74 66 28 63 6f 6e 73 DebugPrintf(cons
27180 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 23 t char*, ...);.#
27190 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 endif.#if define
271a0 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 0a 20 d(SQLITE_TEST).
271b0 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 54 65 void *sqlite3Te
271c0 73 74 54 65 78 74 54 6f 50 74 72 28 63 6f 6e 73 stTextToPtr(cons
271d0 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 t char*);.#endif
271e0 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 ..#if defined(SQ
271f0 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 20 76 6f LITE_DEBUG). vo
27200 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 56 69 id sqlite3TreeVi
27210 65 77 45 78 70 72 28 54 72 65 65 56 69 65 77 2a ewExpr(TreeView*
27220 2c 20 63 6f 6e 73 74 20 45 78 70 72 2a 2c 20 75 , const Expr*, u
27230 38 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 8);. void sqlit
27240 65 33 54 72 65 65 56 69 65 77 42 61 72 65 45 78 e3TreeViewBareEx
27250 70 72 4c 69 73 74 28 54 72 65 65 56 69 65 77 2a prList(TreeView*
27260 2c 20 63 6f 6e 73 74 20 45 78 70 72 4c 69 73 74 , const ExprList
27270 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b *, const char*);
27280 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 . void sqlite3T
27290 72 65 65 56 69 65 77 45 78 70 72 4c 69 73 74 28 reeViewExprList(
272a0 54 72 65 65 56 69 65 77 2a 2c 20 63 6f 6e 73 74 TreeView*, const
272b0 20 45 78 70 72 4c 69 73 74 2a 2c 20 75 38 2c 20 ExprList*, u8,
272c0 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 const char*);.
272d0 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 void sqlite3Tree
272e0 56 69 65 77 53 65 6c 65 63 74 28 54 72 65 65 56 ViewSelect(TreeV
272f0 69 65 77 2a 2c 20 63 6f 6e 73 74 20 53 65 6c 65 iew*, const Sele
27300 63 74 2a 2c 20 75 38 29 3b 0a 20 20 76 6f 69 64 ct*, u8);. void
27310 20 73 71 6c 69 74 65 33 54 72 65 65 56 69 65 77 sqlite3TreeView
27320 57 69 74 68 28 54 72 65 65 56 69 65 77 2a 2c 20 With(TreeView*,
27330 63 6f 6e 73 74 20 57 69 74 68 2a 2c 20 75 38 29 const With*, u8)
27340 3b 0a 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ;.. void sqlite
27350 33 41 73 74 45 78 70 72 28 63 6f 6e 73 74 20 45 3AstExpr(const E
27360 78 70 72 2a 2c 69 6e 74 2a 2c 69 6e 74 29 3b 0a xpr*,int*,int);.
27370 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 73 void sqlite3As
27380 74 45 78 70 72 4c 69 73 74 28 63 6f 6e 73 74 20 tExprList(const
27390 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 2a 2c 69 ExprList*,int*,i
273a0 6e 74 2c 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 nt,int);. void
273b0 73 71 6c 69 74 65 33 41 73 74 53 65 6c 65 63 74 sqlite3AstSelect
273c0 28 63 6f 6e 73 74 20 53 65 6c 65 63 74 2a 2c 69 (const Select*,i
273d0 6e 74 2a 2c 69 6e 74 29 3b 0a 20 20 76 6f 69 64 nt*,int);. void
273e0 20 73 71 6c 69 74 65 33 41 73 74 57 69 74 68 28 sqlite3AstWith(
273f0 63 6f 6e 73 74 20 57 69 74 68 2a 2c 69 6e 74 2a const With*,int*
27400 2c 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 0a ,int);.#endif...
27410 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 74 53 void sqlite3SetS
27420 74 72 69 6e 67 28 63 68 61 72 20 2a 2a 2c 20 73 tring(char **, s
27430 71 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 qlite3*, const c
27440 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 har*);.void sqli
27450 74 65 33 45 72 72 6f 72 4d 73 67 28 50 61 72 73 te3ErrorMsg(Pars
27460 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c e*, const char*,
27470 20 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ...);.void sqli
27480 74 65 33 44 65 71 75 6f 74 65 28 63 68 61 72 2a te3Dequote(char*
27490 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 54 );.void sqlite3T
274a0 6f 6b 65 6e 49 6e 69 74 28 54 6f 6b 65 6e 2a 2c okenInit(Token*,
274b0 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 char*);.int sqli
274c0 74 65 33 4b 65 79 77 6f 72 64 43 6f 64 65 28 63 te3KeywordCode(c
274d0 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
274e0 61 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 ar*, int);.int s
274f0 71 6c 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 qlite3RunParser(
27500 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 Parse*, const ch
27510 61 72 2a 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 76 ar*, char **);.v
27520 6f 69 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 oid sqlite3Finis
27530 68 43 6f 64 69 6e 67 28 50 61 72 73 65 2a 29 3b hCoding(Parse*);
27540 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 65 74 54 .int sqlite3GetT
27550 65 6d 70 52 65 67 28 50 61 72 73 65 2a 29 3b 0a empReg(Parse*);.
27560 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 6c 65 void sqlite3Rele
27570 61 73 65 54 65 6d 70 52 65 67 28 50 61 72 73 65 aseTempReg(Parse
27580 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 *,int);.int sqli
27590 74 65 33 47 65 74 54 65 6d 70 52 61 6e 67 65 28 te3GetTempRange(
275a0 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 76 6f 69 Parse*,int);.voi
275b0 64 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 d sqlite3Release
275c0 54 65 6d 70 52 61 6e 67 65 28 50 61 72 73 65 2a TempRange(Parse*
275d0 2c 69 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 ,int,int);.void
275e0 73 71 6c 69 74 65 33 43 6c 65 61 72 54 65 6d 70 sqlite3ClearTemp
275f0 52 65 67 43 61 63 68 65 28 50 61 72 73 65 2a 29 RegCache(Parse*)
27600 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
27610 44 45 42 55 47 0a 69 6e 74 20 73 71 6c 69 74 65 DEBUG.int sqlite
27620 33 4e 6f 54 65 6d 70 73 49 6e 52 61 6e 67 65 28 3NoTempsInRange(
27630 50 61 72 73 65 2a 2c 69 6e 74 2c 69 6e 74 29 3b Parse*,int,int);
27640 0a 23 65 6e 64 69 66 0a 45 78 70 72 20 2a 73 71 .#endif.Expr *sq
27650 6c 69 74 65 33 45 78 70 72 41 6c 6c 6f 63 28 73 lite3ExprAlloc(s
27660 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 qlite3*,int,cons
27670 74 20 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 45 t Token*,int);.E
27680 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 xpr *sqlite3Expr
27690 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f (sqlite3*,int,co
276a0 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
276b0 20 73 71 6c 69 74 65 33 45 78 70 72 41 74 74 61 sqlite3ExprAtta
276c0 63 68 53 75 62 74 72 65 65 73 28 73 71 6c 69 74 chSubtrees(sqlit
276d0 65 33 2a 2c 45 78 70 72 2a 2c 45 78 70 72 2a 2c e3*,Expr*,Expr*,
276e0 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 Expr*);.Expr *sq
276f0 6c 69 74 65 33 50 45 78 70 72 28 50 61 72 73 65 lite3PExpr(Parse
27700 2a 2c 20 69 6e 74 2c 20 45 78 70 72 2a 2c 20 45 *, int, Expr*, E
27710 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
27720 74 65 33 50 45 78 70 72 41 64 64 53 65 6c 65 63 te3PExprAddSelec
27730 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c t(Parse*, Expr*,
27740 20 53 65 6c 65 63 74 2a 29 3b 0a 45 78 70 72 20 Select*);.Expr
27750 2a 73 71 6c 69 74 65 33 45 78 70 72 41 6e 64 28 *sqlite3ExprAnd(
27760 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 20 sqlite3*,Expr*,
27770 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 Expr*);.Expr *sq
27780 6c 69 74 65 33 45 78 70 72 46 75 6e 63 74 69 6f lite3ExprFunctio
27790 6e 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 n(Parse*,ExprLis
277a0 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 t*, Token*);.voi
277b0 64 20 73 71 6c 69 74 65 33 45 78 70 72 41 73 73 d sqlite3ExprAss
277c0 69 67 6e 56 61 72 4e 75 6d 62 65 72 28 50 61 72 ignVarNumber(Par
277d0 73 65 2a 2c 20 45 78 70 72 2a 2c 20 75 33 32 29 se*, Expr*, u32)
277e0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
277f0 70 72 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 prDelete(sqlite3
27800 2a 2c 20 45 78 70 72 2a 29 3b 0a 45 78 70 72 4c *, Expr*);.ExprL
27810 69 73 74 20 2a 73 71 6c 69 74 65 33 45 78 70 72 ist *sqlite3Expr
27820 4c 69 73 74 41 70 70 65 6e 64 28 50 61 72 73 65 ListAppend(Parse
27830 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 *,ExprList*,Expr
27840 2a 29 3b 0a 45 78 70 72 4c 69 73 74 20 2a 73 71 *);.ExprList *sq
27850 6c 69 74 65 33 45 78 70 72 4c 69 73 74 41 70 70 lite3ExprListApp
27860 65 6e 64 56 65 63 74 6f 72 28 50 61 72 73 65 2a endVector(Parse*
27870 2c 45 78 70 72 4c 69 73 74 2a 2c 49 64 4c 69 73 ,ExprList*,IdLis
27880 74 2a 2c 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 t*,Expr*);.void
27890 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 53 sqlite3ExprListS
278a0 65 74 53 6f 72 74 4f 72 64 65 72 28 45 78 70 72 etSortOrder(Expr
278b0 4c 69 73 74 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 List*,int);.void
278c0 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 sqlite3ExprList
278d0 53 65 74 4e 61 6d 65 28 50 61 72 73 65 2a 2c 45 SetName(Parse*,E
278e0 78 70 72 4c 69 73 74 2a 2c 54 6f 6b 65 6e 2a 2c xprList*,Token*,
278f0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
27900 65 33 45 78 70 72 4c 69 73 74 53 65 74 53 70 61 e3ExprListSetSpa
27910 6e 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 n(Parse*,ExprLis
27920 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 t*,const char*,c
27930 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 onst char*);.voi
27940 64 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 d sqlite3ExprLis
27950 74 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a tDelete(sqlite3*
27960 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a 75 33 , ExprList*);.u3
27970 32 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 2 sqlite3ExprLis
27980 74 46 6c 61 67 73 28 63 6f 6e 73 74 20 45 78 70 tFlags(const Exp
27990 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c rList*);.int sql
279a0 69 74 65 33 49 6e 69 74 28 73 71 6c 69 74 65 33 ite3Init(sqlite3
279b0 2a 2c 20 63 68 61 72 2a 2a 29 3b 0a 69 6e 74 20 *, char**);.int
279c0 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 sqlite3InitCallb
279d0 61 63 6b 28 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 ack(void*, int,
279e0 63 68 61 72 2a 2a 2c 20 63 68 61 72 2a 2a 29 3b char**, char**);
279f0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 72 61 .void sqlite3Pra
27a00 67 6d 61 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e gma(Parse*,Token
27a10 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c *,Token*,Token*,
27a20 69 6e 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 int);.#ifndef SQ
27a30 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
27a40 4c 54 41 42 4c 45 0a 4d 6f 64 75 6c 65 20 2a 73 LTABLE.Module *s
27a50 71 6c 69 74 65 33 50 72 61 67 6d 61 56 74 61 62 qlite3PragmaVtab
27a60 52 65 67 69 73 74 65 72 28 73 71 6c 69 74 65 33 Register(sqlite3
27a70 2a 2c 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e *,const char *zN
27a80 61 6d 65 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 ame);.#endif.voi
27a90 64 20 73 71 6c 69 74 65 33 52 65 73 65 74 41 6c d sqlite3ResetAl
27aa0 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 lSchemasOfConnec
27ab0 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a 29 3b 0a tion(sqlite3*);.
27ac0 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 65 void sqlite3Rese
27ad0 74 4f 6e 65 53 63 68 65 6d 61 28 73 71 6c 69 74 tOneSchema(sqlit
27ae0 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 e3*,int);.void s
27af0 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 44 61 qlite3CollapseDa
27b00 74 61 62 61 73 65 41 72 72 61 79 28 73 71 6c 69 tabaseArray(sqli
27b10 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 te3*);.void sqli
27b20 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 te3CommitInterna
27b30 6c 43 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 lChanges(sqlite3
27b40 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
27b50 44 65 6c 65 74 65 43 6f 6c 75 6d 6e 4e 61 6d 65 DeleteColumnName
27b60 73 28 73 71 6c 69 74 65 33 2a 2c 54 61 62 6c 65 s(sqlite3*,Table
27b70 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 *);.int sqlite3C
27b80 6f 6c 75 6d 6e 73 46 72 6f 6d 45 78 70 72 4c 69 olumnsFromExprLi
27b90 73 74 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 st(Parse*,ExprLi
27ba0 73 74 2a 2c 69 31 36 2a 2c 43 6f 6c 75 6d 6e 2a st*,i16*,Column*
27bb0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
27bc0 53 65 6c 65 63 74 41 64 64 43 6f 6c 75 6d 6e 54 SelectAddColumnT
27bd0 79 70 65 41 6e 64 43 6f 6c 6c 61 74 69 6f 6e 28 ypeAndCollation(
27be0 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 53 65 Parse*,Table*,Se
27bf0 6c 65 63 74 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 lect*);.Table *s
27c00 71 6c 69 74 65 33 52 65 73 75 6c 74 53 65 74 4f qlite3ResultSetO
27c10 66 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c 53 fSelect(Parse*,S
27c20 65 6c 65 63 74 2a 29 3b 0a 76 6f 69 64 20 73 71 elect*);.void sq
27c30 6c 69 74 65 33 4f 70 65 6e 4d 61 73 74 65 72 54 lite3OpenMasterT
27c40 61 62 6c 65 28 50 61 72 73 65 20 2a 2c 20 69 6e able(Parse *, in
27c50 74 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 t);.Index *sqlit
27c60 65 33 50 72 69 6d 61 72 79 4b 65 79 49 6e 64 65 e3PrimaryKeyInde
27c70 78 28 54 61 62 6c 65 2a 29 3b 0a 69 31 36 20 73 x(Table*);.i16 s
27c80 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e qlite3ColumnOfIn
27c90 64 65 78 28 49 6e 64 65 78 2a 2c 20 69 31 36 29 dex(Index*, i16)
27ca0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 ;.void sqlite3St
27cb0 61 72 74 54 61 62 6c 65 28 50 61 72 73 65 2a 2c artTable(Parse*,
27cc0 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e Token*,Token*,in
27cd0 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a t,int,int,int);.
27ce0 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c #if SQLITE_ENABL
27cf0 45 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e 53 E_HIDDEN_COLUMNS
27d00 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 . void sqlite3C
27d10 6f 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 46 olumnPropertiesF
27d20 72 6f 6d 4e 61 6d 65 28 54 61 62 6c 65 2a 2c 20 romName(Table*,
27d30 43 6f 6c 75 6d 6e 2a 29 3b 0a 23 65 6c 73 65 0a Column*);.#else.
27d40 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
27d50 43 6f 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 ColumnProperties
27d60 46 72 6f 6d 4e 61 6d 65 28 54 2c 43 29 20 2f 2a FromName(T,C) /*
27d70 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 65 6e 64 69 66 no-op */.#endif
27d80 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 .void sqlite3Add
27d90 43 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 54 6f Column(Parse*,To
27da0 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 76 6f ken*,Token*);.vo
27db0 69 64 20 73 71 6c 69 74 65 33 41 64 64 4e 6f 74 id sqlite3AddNot
27dc0 4e 75 6c 6c 28 50 61 72 73 65 2a 2c 20 69 6e 74 Null(Parse*, int
27dd0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
27de0 64 64 50 72 69 6d 61 72 79 4b 65 79 28 50 61 72 ddPrimaryKey(Par
27df0 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 se*, ExprList*,
27e00 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
27e10 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 43 void sqlite3AddC
27e20 68 65 63 6b 43 6f 6e 73 74 72 61 69 6e 74 28 50 heckConstraint(P
27e30 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 arse*, Expr*);.v
27e40 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 44 65 oid sqlite3AddDe
27e50 66 61 75 6c 74 56 61 6c 75 65 28 50 61 72 73 65 faultValue(Parse
27e60 2a 2c 45 78 70 72 2a 2c 63 6f 6e 73 74 20 63 68 *,Expr*,const ch
27e70 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 ar*,const char*)
27e80 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 ;.void sqlite3Ad
27e90 64 43 6f 6c 6c 61 74 65 54 79 70 65 28 50 61 72 dCollateType(Par
27ea0 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f se*, Token*);.vo
27eb0 69 64 20 73 71 6c 69 74 65 33 45 6e 64 54 61 62 id sqlite3EndTab
27ec0 6c 65 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a le(Parse*,Token*
27ed0 2c 54 6f 6b 65 6e 2a 2c 75 38 2c 53 65 6c 65 63 ,Token*,u8,Selec
27ee0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
27ef0 50 61 72 73 65 55 72 69 28 63 6f 6e 73 74 20 63 ParseUri(const c
27f00 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a har*,const char*
27f10 2c 75 6e 73 69 67 6e 65 64 20 69 6e 74 2a 2c 0a ,unsigned int*,.
27f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27f30 20 20 20 20 73 71 6c 69 74 65 33 5f 76 66 73 2a sqlite3_vfs*
27f40 2a 2c 63 68 61 72 2a 2a 2c 63 68 61 72 20 2a 2a *,char**,char **
27f50 29 3b 0a 42 74 72 65 65 20 2a 73 71 6c 69 74 65 );.Btree *sqlite
27f60 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 73 3DbNameToBtree(s
27f70 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
27f80 61 72 2a 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 ar*);..#ifdef SQ
27f90 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c 45 0a LITE_UNTESTABLE.
27fa0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
27fb0 46 61 75 6c 74 53 69 6d 28 58 29 20 53 51 4c 49 FaultSim(X) SQLI
27fc0 54 45 5f 4f 4b 0a 23 65 6c 73 65 0a 20 20 69 6e TE_OK.#else. in
27fd0 74 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 69 t sqlite3FaultSi
27fe0 6d 28 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a m(int);.#endif..
27ff0 42 69 74 76 65 63 20 2a 73 71 6c 69 74 65 33 42 Bitvec *sqlite3B
28000 69 74 76 65 63 43 72 65 61 74 65 28 75 33 32 29 itvecCreate(u32)
28010 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 74 ;.int sqlite3Bit
28020 76 65 63 54 65 73 74 28 42 69 74 76 65 63 2a 2c vecTest(Bitvec*,
28030 20 75 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 u32);.int sqlit
28040 65 33 42 69 74 76 65 63 54 65 73 74 4e 6f 74 4e e3BitvecTestNotN
28050 75 6c 6c 28 42 69 74 76 65 63 2a 2c 20 75 33 32 ull(Bitvec*, u32
28060 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 );.int sqlite3Bi
28070 74 76 65 63 53 65 74 28 42 69 74 76 65 63 2a 2c tvecSet(Bitvec*,
28080 20 75 33 32 29 3b 0a 76 6f 69 64 20 73 71 6c 69 u32);.void sqli
28090 74 65 33 42 69 74 76 65 63 43 6c 65 61 72 28 42 te3BitvecClear(B
280a0 69 74 76 65 63 2a 2c 20 75 33 32 2c 20 76 6f 69 itvec*, u32, voi
280b0 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 d*);.void sqlite
280c0 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 42 3BitvecDestroy(B
280d0 69 74 76 65 63 2a 29 3b 0a 75 33 32 20 73 71 6c itvec*);.u32 sql
280e0 69 74 65 33 42 69 74 76 65 63 53 69 7a 65 28 42 ite3BitvecSize(B
280f0 69 74 76 65 63 2a 29 3b 0a 23 69 66 6e 64 65 66 itvec*);.#ifndef
28100 20 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 SQLITE_UNTESTAB
28110 4c 45 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 LE.int sqlite3Bi
28120 74 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 28 tvecBuiltinTest(
28130 69 6e 74 2c 69 6e 74 2a 29 3b 0a 23 65 6e 64 69 int,int*);.#endi
28140 66 0a 0a 52 6f 77 53 65 74 20 2a 73 71 6c 69 74 f..RowSet *sqlit
28150 65 33 52 6f 77 53 65 74 49 6e 69 74 28 73 71 6c e3RowSetInit(sql
28160 69 74 65 33 2a 2c 20 76 6f 69 64 2a 2c 20 75 6e ite3*, void*, un
28170 73 69 67 6e 65 64 20 69 6e 74 29 3b 0a 76 6f 69 signed int);.voi
28180 64 20 73 71 6c 69 74 65 33 52 6f 77 53 65 74 43 d sqlite3RowSetC
28190 6c 65 61 72 28 52 6f 77 53 65 74 2a 29 3b 0a 76 lear(RowSet*);.v
281a0 6f 69 64 20 73 71 6c 69 74 65 33 52 6f 77 53 65 oid sqlite3RowSe
281b0 74 49 6e 73 65 72 74 28 52 6f 77 53 65 74 2a 2c tInsert(RowSet*,
281c0 20 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 i64);.int sqlit
281d0 65 33 52 6f 77 53 65 74 54 65 73 74 28 52 6f 77 e3RowSetTest(Row
281e0 53 65 74 2a 2c 20 69 6e 74 20 69 42 61 74 63 68 Set*, int iBatch
281f0 2c 20 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 , i64);.int sqli
28200 74 65 33 52 6f 77 53 65 74 4e 65 78 74 28 52 6f te3RowSetNext(Ro
28210 77 53 65 74 2a 2c 20 69 36 34 2a 29 3b 0a 0a 76 wSet*, i64*);..v
28220 6f 69 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 oid sqlite3Creat
28230 65 56 69 65 77 28 50 61 72 73 65 2a 2c 54 6f 6b eView(Parse*,Tok
28240 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e en*,Token*,Token
28250 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 65 6c 65 *,ExprList*,Sele
28260 63 74 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 0a 23 ct*,int,int);..#
28270 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
28280 54 45 5f 4f 4d 49 54 5f 56 49 45 57 29 20 7c 7c TE_OMIT_VIEW) ||
28290 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
282a0 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
282b0 4c 45 29 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 LE). int sqlite
282c0 33 56 69 65 77 47 65 74 43 6f 6c 75 6d 6e 4e 61 3ViewGetColumnNa
282d0 6d 65 73 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 mes(Parse*,Table
282e0 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 *);.#else.# defi
282f0 6e 65 20 73 71 6c 69 74 65 33 56 69 65 77 47 65 ne sqlite3ViewGe
28300 74 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 41 2c 42 tColumnNames(A,B
28310 29 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 ) 0.#endif..#if
28320 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 SQLITE_MAX_ATTAC
28330 48 45 44 3e 33 30 0a 20 20 69 6e 74 20 73 71 6c HED>30. int sql
28340 69 74 65 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 ite3DbMaskAllZer
28350 6f 28 79 44 62 4d 61 73 6b 29 3b 0a 23 65 6e 64 o(yDbMask);.#end
28360 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 if.void sqlite3D
28370 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a 2c ropTable(Parse*,
28380 20 53 72 63 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 SrcList*, int,
28390 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
283a0 65 33 43 6f 64 65 44 72 6f 70 54 61 62 6c 65 28 e3CodeDropTable(
283b0 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 Parse*, Table*,
283c0 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
283d0 73 71 6c 69 74 65 33 44 65 6c 65 74 65 54 61 62 sqlite3DeleteTab
283e0 6c 65 28 73 71 6c 69 74 65 33 2a 2c 20 54 61 62 le(sqlite3*, Tab
283f0 6c 65 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 le*);.#ifndef SQ
28400 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e LITE_OMIT_AUTOIN
28410 43 52 45 4d 45 4e 54 0a 20 20 76 6f 69 64 20 73 CREMENT. void s
28420 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d qlite3Autoincrem
28430 65 6e 74 42 65 67 69 6e 28 50 61 72 73 65 20 2a entBegin(Parse *
28440 70 50 61 72 73 65 29 3b 0a 20 20 76 6f 69 64 20 pParse);. void
28450 73 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 sqlite3Autoincre
28460 6d 65 6e 74 45 6e 64 28 50 61 72 73 65 20 2a 70 mentEnd(Parse *p
28470 50 61 72 73 65 29 3b 0a 23 65 6c 73 65 0a 23 20 Parse);.#else.#
28480 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 define sqlite3Au
28490 74 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 69 6e toincrementBegin
284a0 28 58 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c (X).# define sql
284b0 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e ite3Autoincremen
284c0 74 45 6e 64 28 58 29 0a 23 65 6e 64 69 66 0a 76 tEnd(X).#endif.v
284d0 6f 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 oid sqlite3Inser
284e0 74 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 t(Parse*, SrcLis
284f0 74 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 49 64 4c t*, Select*, IdL
28500 69 73 74 2a 2c 20 69 6e 74 2c 20 55 70 73 65 72 ist*, int, Upser
28510 74 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 t*);.void *sqlit
28520 65 33 41 72 72 61 79 41 6c 6c 6f 63 61 74 65 28 e3ArrayAllocate(
28530 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69 sqlite3*,void*,i
28540 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a 49 nt,int*,int*);.I
28550 64 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 64 dList *sqlite3Id
28560 4c 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 74 ListAppend(sqlit
28570 65 33 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 54 6f e3*, IdList*, To
28580 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ken*);.int sqlit
28590 65 33 49 64 4c 69 73 74 49 6e 64 65 78 28 49 64 e3IdListIndex(Id
285a0 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 List*,const char
285b0 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c *);.SrcList *sql
285c0 69 74 65 33 53 72 63 4c 69 73 74 45 6e 6c 61 72 ite3SrcListEnlar
285d0 67 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 ge(sqlite3*, Src
285e0 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 List*, int, int)
285f0 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 ;.SrcList *sqlit
28600 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e 64 28 e3SrcListAppend(
28610 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 sqlite3*, SrcLis
28620 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 t*, Token*, Toke
28630 6e 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 n*);.SrcList *sq
28640 6c 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 lite3SrcListAppe
28650 6e 64 46 72 6f 6d 54 65 72 6d 28 50 61 72 73 65 ndFromTerm(Parse
28660 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b *, SrcList*, Tok
28670 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 0a 20 20 20 en*, Token*,.
28680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
286a0 20 20 20 54 6f 6b 65 6e 2a 2c 20 53 65 6c 65 63 Token*, Selec
286b0 74 2a 2c 20 45 78 70 72 2a 2c 20 49 64 4c 69 73 t*, Expr*, IdLis
286c0 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
286d0 33 53 72 63 4c 69 73 74 49 6e 64 65 78 65 64 42 3SrcListIndexedB
286e0 79 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c 69 y(Parse *, SrcLi
286f0 73 74 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b 0a st *, Token *);.
28700 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c void sqlite3SrcL
28710 69 73 74 46 75 6e 63 41 72 67 73 28 50 61 72 73 istFuncArgs(Pars
28720 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 e*, SrcList*, Ex
28730 70 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 prList*);.int sq
28740 6c 69 74 65 33 49 6e 64 65 78 65 64 42 79 4c 6f lite3IndexedByLo
28750 6f 6b 75 70 28 50 61 72 73 65 20 2a 2c 20 73 74 okup(Parse *, st
28760 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 ruct SrcList_ite
28770 6d 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 m *);.void sqlit
28780 65 33 53 72 63 4c 69 73 74 53 68 69 66 74 4a 6f e3SrcListShiftJo
28790 69 6e 54 79 70 65 28 53 72 63 4c 69 73 74 2a 29 inType(SrcList*)
287a0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 ;.void sqlite3Sr
287b0 63 4c 69 73 74 41 73 73 69 67 6e 43 75 72 73 6f cListAssignCurso
287c0 72 73 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 rs(Parse*, SrcLi
287d0 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 st*);.void sqlit
287e0 65 33 49 64 4c 69 73 74 44 65 6c 65 74 65 28 73 e3IdListDelete(s
287f0 71 6c 69 74 65 33 2a 2c 20 49 64 4c 69 73 74 2a qlite3*, IdList*
28800 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
28810 72 63 4c 69 73 74 44 65 6c 65 74 65 28 73 71 6c rcListDelete(sql
28820 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 74 2a 29 ite3*, SrcList*)
28830 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 ;.Index *sqlite3
28840 41 6c 6c 6f 63 61 74 65 49 6e 64 65 78 4f 62 6a AllocateIndexObj
28850 65 63 74 28 73 71 6c 69 74 65 33 2a 2c 69 31 36 ect(sqlite3*,i16
28860 2c 69 6e 74 2c 63 68 61 72 2a 2a 29 3b 0a 76 6f ,int,char**);.vo
28870 69 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 id sqlite3Create
28880 49 6e 64 65 78 28 50 61 72 73 65 2a 2c 54 6f 6b Index(Parse*,Tok
28890 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 53 72 63 4c 69 en*,Token*,SrcLi
288a0 73 74 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e st*,ExprList*,in
288b0 74 2c 54 6f 6b 65 6e 2a 2c 0a 20 20 20 20 20 20 t,Token*,.
288c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
288d0 20 20 20 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 Expr*, int,
288e0 69 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 int, u8);.void s
288f0 71 6c 69 74 65 33 44 72 6f 70 49 6e 64 65 78 28 qlite3DropIndex(
28900 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
28910 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 , int);.int sqli
28920 74 65 33 53 65 6c 65 63 74 28 50 61 72 73 65 2a te3Select(Parse*
28930 2c 20 53 65 6c 65 63 74 2a 2c 20 53 65 6c 65 63 , Select*, Selec
28940 74 44 65 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 tDest*);.Select
28950 2a 73 71 6c 69 74 65 33 53 65 6c 65 63 74 4e 65 *sqlite3SelectNe
28960 77 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 w(Parse*,ExprLis
28970 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 t*,SrcList*,Expr
28980 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 0a 20 20 20 *,ExprList*,.
28990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
289a0 20 20 20 20 20 20 45 78 70 72 2a 2c 45 78 70 72 Expr*,Expr
289b0 4c 69 73 74 2a 2c 75 33 32 2c 45 78 70 72 2a 29 List*,u32,Expr*)
289c0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 ;.void sqlite3Se
289d0 6c 65 63 74 44 65 6c 65 74 65 28 73 71 6c 69 74 lectDelete(sqlit
289e0 65 33 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 54 e3*, Select*);.T
289f0 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 53 72 63 able *sqlite3Src
28a00 4c 69 73 74 4c 6f 6f 6b 75 70 28 50 61 72 73 65 ListLookup(Parse
28a10 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 69 6e *, SrcList*);.in
28a20 74 20 73 71 6c 69 74 65 33 49 73 52 65 61 64 4f t sqlite3IsReadO
28a30 6e 6c 79 28 50 61 72 73 65 2a 2c 20 54 61 62 6c nly(Parse*, Tabl
28a40 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 e*, int);.void s
28a50 71 6c 69 74 65 33 4f 70 65 6e 54 61 62 6c 65 28 qlite3OpenTable(
28a60 50 61 72 73 65 2a 2c 20 69 6e 74 20 69 43 75 72 Parse*, int iCur
28a70 2c 20 69 6e 74 20 69 44 62 2c 20 54 61 62 6c 65 , int iDb, Table
28a80 2a 2c 20 69 6e 74 29 3b 0a 23 69 66 20 64 65 66 *, int);.#if def
28a90 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
28aa0 4c 45 5f 55 50 44 41 54 45 5f 44 45 4c 45 54 45 LE_UPDATE_DELETE
28ab0 5f 4c 49 4d 49 54 29 20 26 26 20 21 64 65 66 69 _LIMIT) && !defi
28ac0 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
28ad0 53 55 42 51 55 45 52 59 29 0a 45 78 70 72 20 2a SUBQUERY).Expr *
28ae0 73 71 6c 69 74 65 33 4c 69 6d 69 74 57 68 65 72 sqlite3LimitWher
28af0 65 28 50 61 72 73 65 2a 2c 53 72 63 4c 69 73 74 e(Parse*,SrcList
28b00 2a 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 *,Expr*,ExprList
28b10 2a 2c 45 78 70 72 2a 2c 63 68 61 72 2a 29 3b 0a *,Expr*,char*);.
28b20 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 #endif.void sqli
28b30 74 65 33 44 65 6c 65 74 65 46 72 6f 6d 28 50 61 te3DeleteFrom(Pa
28b40 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 rse*, SrcList*,
28b50 45 78 70 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a Expr*, ExprList*
28b60 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 , Expr*);.void s
28b70 71 6c 69 74 65 33 55 70 64 61 74 65 28 50 61 72 qlite3Update(Par
28b80 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 se*, SrcList*, E
28b90 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 69 xprList*,Expr*,i
28ba0 6e 74 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 nt,ExprList*,Exp
28bb0 72 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 r*,.
28bc0 20 20 20 20 20 20 20 55 70 73 65 72 74 2a 29 3b Upsert*);
28bd0 0a 57 68 65 72 65 49 6e 66 6f 20 2a 73 71 6c 69 .WhereInfo *sqli
28be0 74 65 33 57 68 65 72 65 42 65 67 69 6e 28 50 61 te3WhereBegin(Pa
28bf0 72 73 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 rse*,SrcList*,Ex
28c00 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 pr*,ExprList*,Ex
28c10 70 72 4c 69 73 74 2a 2c 75 31 36 2c 69 6e 74 29 prList*,u16,int)
28c20 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 57 68 ;.void sqlite3Wh
28c30 65 72 65 45 6e 64 28 57 68 65 72 65 49 6e 66 6f ereEnd(WhereInfo
28c40 2a 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 *);.LogEst sqlit
28c50 65 33 57 68 65 72 65 4f 75 74 70 75 74 52 6f 77 e3WhereOutputRow
28c60 43 6f 75 6e 74 28 57 68 65 72 65 49 6e 66 6f 2a Count(WhereInfo*
28c70 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 );.int sqlite3Wh
28c80 65 72 65 49 73 44 69 73 74 69 6e 63 74 28 57 68 ereIsDistinct(Wh
28c90 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 ereInfo*);.int s
28ca0 71 6c 69 74 65 33 57 68 65 72 65 49 73 4f 72 64 qlite3WhereIsOrd
28cb0 65 72 65 64 28 57 68 65 72 65 49 6e 66 6f 2a 29 ered(WhereInfo*)
28cc0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 ;.int sqlite3Whe
28cd0 72 65 4f 72 64 65 72 65 64 49 6e 6e 65 72 4c 6f reOrderedInnerLo
28ce0 6f 70 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a op(WhereInfo*);.
28cf0 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 int sqlite3Where
28d00 49 73 53 6f 72 74 65 64 28 57 68 65 72 65 49 6e IsSorted(WhereIn
28d10 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 fo*);.int sqlite
28d20 33 57 68 65 72 65 43 6f 6e 74 69 6e 75 65 4c 61 3WhereContinueLa
28d30 62 65 6c 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b bel(WhereInfo*);
28d40 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 .int sqlite3Wher
28d50 65 42 72 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 eBreakLabel(Wher
28d60 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c eInfo*);.int sql
28d70 69 74 65 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 ite3WhereOkOnePa
28d80 73 73 28 57 68 65 72 65 49 6e 66 6f 2a 2c 20 69 ss(WhereInfo*, i
28d90 6e 74 2a 29 3b 0a 23 64 65 66 69 6e 65 20 4f 4e nt*);.#define ON
28da0 45 50 41 53 53 5f 4f 46 46 20 20 20 20 20 20 30 EPASS_OFF 0
28db0 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 6f /* Use o
28dc0 66 20 4f 4e 45 50 41 53 53 20 6e 6f 74 20 61 6c f ONEPASS not al
28dd0 6c 6f 77 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 lowed */.#define
28de0 20 4f 4e 45 50 41 53 53 5f 53 49 4e 47 4c 45 20 ONEPASS_SINGLE
28df0 20 20 31 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 1 /* ON
28e00 45 50 41 53 53 20 76 61 6c 69 64 20 66 6f 72 20 EPASS valid for
28e10 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 75 70 64 a single row upd
28e20 61 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ate */.#define O
28e30 4e 45 50 41 53 53 5f 4d 55 4c 54 49 20 20 20 20 NEPASS_MULTI
28e40 32 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 50 2 /* ONEP
28e50 41 53 53 20 69 73 20 76 61 6c 69 64 20 66 6f 72 ASS is valid for
28e60 20 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a multiple rows *
28e70 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 /.void sqlite3Ex
28e80 70 72 43 6f 64 65 4c 6f 61 64 49 6e 64 65 78 43 prCodeLoadIndexC
28e90 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 20 49 6e olumn(Parse*, In
28ea0 64 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 dex*, int, int,
28eb0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
28ec0 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 3ExprCodeGetColu
28ed0 6d 6e 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 mn(Parse*, Table
28ee0 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 *, int, int, int
28ef0 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 , u8);.void sqli
28f00 74 65 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f te3ExprCodeGetCo
28f10 6c 75 6d 6e 54 6f 52 65 67 28 50 61 72 73 65 2a lumnToReg(Parse*
28f20 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 , Table*, int, i
28f30 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
28f40 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 qlite3ExprCodeGe
28f50 74 43 6f 6c 75 6d 6e 4f 66 54 61 62 6c 65 28 56 tColumnOfTable(V
28f60 64 62 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e dbe*, Table*, in
28f70 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f t, int, int);.vo
28f80 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f id sqlite3ExprCo
28f90 64 65 4d 6f 76 65 28 50 61 72 73 65 2a 2c 20 69 deMove(Parse*, i
28fa0 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 nt, int, int);.v
28fb0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
28fc0 61 63 68 65 53 74 6f 72 65 28 50 61 72 73 65 2a acheStore(Parse*
28fd0 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 , int, int, int)
28fe0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
28ff0 70 72 43 61 63 68 65 50 75 73 68 28 50 61 72 73 prCachePush(Pars
29000 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
29010 33 45 78 70 72 43 61 63 68 65 50 6f 70 28 50 61 3ExprCachePop(Pa
29020 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 rse*);.void sqli
29030 74 65 33 45 78 70 72 43 61 63 68 65 52 65 6d 6f te3ExprCacheRemo
29040 76 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 ve(Parse*, int,
29050 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
29060 65 33 45 78 70 72 43 61 63 68 65 43 6c 65 61 72 e3ExprCacheClear
29070 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 (Parse*);.void s
29080 71 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 41 qlite3ExprCacheA
29090 66 66 69 6e 69 74 79 43 68 61 6e 67 65 28 50 61 ffinityChange(Pa
290a0 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b rse*, int, int);
290b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
290c0 72 43 6f 64 65 28 50 61 72 73 65 2a 2c 20 45 78 rCode(Parse*, Ex
290d0 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 pr*, int);.void
290e0 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 43 sqlite3ExprCodeC
290f0 6f 70 79 28 50 61 72 73 65 2a 2c 20 45 78 70 72 opy(Parse*, Expr
29100 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
29110 6c 69 74 65 33 45 78 70 72 43 6f 64 65 46 61 63 lite3ExprCodeFac
29120 74 6f 72 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 torable(Parse*,
29130 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 Expr*, int);.int
29140 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 sqlite3ExprCode
29150 41 74 49 6e 69 74 28 50 61 72 73 65 2a 2c 20 45 AtInit(Parse*, E
29160 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 xpr*, int);.int
29170 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 54 sqlite3ExprCodeT
29180 65 6d 70 28 50 61 72 73 65 2a 2c 20 45 78 70 72 emp(Parse*, Expr
29190 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 *, int*);.int sq
291a0 6c 69 74 65 33 45 78 70 72 43 6f 64 65 54 61 72 lite3ExprCodeTar
291b0 67 65 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 get(Parse*, Expr
291c0 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
291d0 6c 69 74 65 33 45 78 70 72 43 6f 64 65 41 6e 64 lite3ExprCodeAnd
291e0 43 61 63 68 65 28 50 61 72 73 65 2a 2c 20 45 78 Cache(Parse*, Ex
291f0 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 pr*, int);.int s
29200 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 45 78 qlite3ExprCodeEx
29210 70 72 4c 69 73 74 28 50 61 72 73 65 2a 2c 20 45 prList(Parse*, E
29220 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 xprList*, int, i
29230 6e 74 2c 20 75 38 29 3b 0a 23 64 65 66 69 6e 65 nt, u8);.#define
29240 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f 44 55 50 SQLITE_ECEL_DUP
29250 20 20 20 20 20 20 30 78 30 31 20 20 2f 2a 20 44 0x01 /* D
29260 65 65 70 2c 20 6e 6f 74 20 73 68 61 6c 6c 6f 77 eep, not shallow
29270 20 63 6f 70 69 65 73 20 2a 2f 0a 23 64 65 66 69 copies */.#defi
29280 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f 46 ne SQLITE_ECEL_F
29290 41 43 54 4f 52 20 20 20 30 78 30 32 20 20 2f 2a ACTOR 0x02 /*
292a0 20 46 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e 73 Factor out cons
292b0 74 61 6e 74 20 74 65 72 6d 73 20 2a 2f 0a 23 64 tant terms */.#d
292c0 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 efine SQLITE_ECE
292d0 4c 5f 52 45 46 20 20 20 20 20 20 30 78 30 34 20 L_REF 0x04
292e0 20 2f 2a 20 55 73 65 20 45 78 70 72 4c 69 73 74 /* Use ExprList
292f0 2e 75 2e 78 2e 69 4f 72 64 65 72 42 79 43 6f 6c .u.x.iOrderByCol
29300 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
29310 54 45 5f 45 43 45 4c 5f 4f 4d 49 54 52 45 46 20 TE_ECEL_OMITREF
29320 20 30 78 30 38 20 20 2f 2a 20 4f 6d 69 74 20 69 0x08 /* Omit i
29330 66 20 45 78 70 72 4c 69 73 74 2e 75 2e 78 2e 69 f ExprList.u.x.i
29340 4f 72 64 65 72 42 79 43 6f 6c 20 2a 2f 0a 76 6f OrderByCol */.vo
29350 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 49 66 id sqlite3ExprIf
29360 54 72 75 65 28 50 61 72 73 65 2a 2c 20 45 78 70 True(Parse*, Exp
29370 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 r*, int, int);.v
29380 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 49 oid sqlite3ExprI
29390 66 46 61 6c 73 65 28 50 61 72 73 65 2a 2c 20 45 fFalse(Parse*, E
293a0 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b xpr*, int, int);
293b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
293c0 72 49 66 46 61 6c 73 65 44 75 70 28 50 61 72 73 rIfFalseDup(Pars
293d0 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 e*, Expr*, int,
293e0 69 6e 74 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c int);.Table *sql
293f0 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28 73 71 ite3FindTable(sq
29400 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
29410 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 r*, const char*)
29420 3b 0a 23 64 65 66 69 6e 65 20 4c 4f 43 41 54 45 ;.#define LOCATE
29430 5f 56 49 45 57 20 20 20 20 30 78 30 31 0a 23 64 _VIEW 0x01.#d
29440 65 66 69 6e 65 20 4c 4f 43 41 54 45 5f 4e 4f 45 efine LOCATE_NOE
29450 52 52 20 20 20 30 78 30 32 0a 54 61 62 6c 65 20 RR 0x02.Table
29460 2a 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 61 *sqlite3LocateTa
29470 62 6c 65 28 50 61 72 73 65 2a 2c 75 33 32 20 66 ble(Parse*,u32 f
29480 6c 61 67 73 2c 63 6f 6e 73 74 20 63 68 61 72 2a lags,const char*
29490 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a , const char*);.
294a0 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 4c 6f Table *sqlite3Lo
294b0 63 61 74 65 54 61 62 6c 65 49 74 65 6d 28 50 61 cateTableItem(Pa
294c0 72 73 65 2a 2c 75 33 32 20 66 6c 61 67 73 2c 73 rse*,u32 flags,s
294d0 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 truct SrcList_it
294e0 65 6d 20 2a 29 3b 0a 49 6e 64 65 78 20 2a 73 71 em *);.Index *sq
294f0 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28 73 lite3FindIndex(s
29500 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
29510 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a ar*, const char*
29520 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 );.void sqlite3U
29530 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 54 61 nlinkAndDeleteTa
29540 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 ble(sqlite3*,int
29550 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 ,const char*);.v
29560 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e oid sqlite3Unlin
29570 6b 41 6e 64 44 65 6c 65 74 65 49 6e 64 65 78 28 kAndDeleteIndex(
29580 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e sqlite3*,int,con
29590 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 st char*);.void
295a0 73 71 6c 69 74 65 33 56 61 63 75 75 6d 28 50 61 sqlite3Vacuum(Pa
295b0 72 73 65 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 69 6e rse*,Token*);.in
295c0 74 20 73 71 6c 69 74 65 33 52 75 6e 56 61 63 75 t sqlite3RunVacu
295d0 75 6d 28 63 68 61 72 2a 2a 2c 20 73 71 6c 69 74 um(char**, sqlit
295e0 65 33 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 e3*, int);.char
295f0 2a 73 71 6c 69 74 65 33 4e 61 6d 65 46 72 6f 6d *sqlite3NameFrom
29600 54 6f 6b 65 6e 28 73 71 6c 69 74 65 33 2a 2c 20 Token(sqlite3*,
29610 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c Token*);.int sql
29620 69 74 65 33 45 78 70 72 43 6f 6d 70 61 72 65 28 ite3ExprCompare(
29630 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c 20 45 78 Parse*,Expr*, Ex
29640 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 pr*, int);.int s
29650 71 6c 69 74 65 33 45 78 70 72 43 6f 6d 70 61 72 qlite3ExprCompar
29660 65 53 6b 69 70 28 45 78 70 72 2a 2c 20 45 78 70 eSkip(Expr*, Exp
29670 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
29680 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 6f 6d lite3ExprListCom
29690 70 61 72 65 28 45 78 70 72 4c 69 73 74 2a 2c 20 pare(ExprList*,
296a0 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 3b ExprList*, int);
296b0 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
296c0 49 6d 70 6c 69 65 73 45 78 70 72 28 50 61 72 73 ImpliesExpr(Pars
296d0 65 2a 2c 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c e*,Expr*, Expr*,
296e0 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
296f0 65 33 45 78 70 72 49 6d 70 6c 69 65 73 4e 6f 6e e3ExprImpliesNon
29700 4e 75 6c 6c 52 6f 77 28 45 78 70 72 2a 2c 69 6e NullRow(Expr*,in
29710 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
29720 45 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 72 65 ExprAnalyzeAggre
29730 67 61 74 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 gates(NameContex
29740 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 t*, Expr*);.void
29750 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 61 6c sqlite3ExprAnal
29760 79 7a 65 41 67 67 4c 69 73 74 28 4e 61 6d 65 43 yzeAggList(NameC
29770 6f 6e 74 65 78 74 2a 2c 45 78 70 72 4c 69 73 74 ontext*,ExprList
29780 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 *);.int sqlite3E
29790 78 70 72 43 6f 76 65 72 65 64 42 79 49 6e 64 65 xprCoveredByInde
297a0 78 28 45 78 70 72 2a 2c 20 69 6e 74 20 69 43 75 x(Expr*, int iCu
297b0 72 2c 20 49 6e 64 65 78 20 2a 70 49 64 78 29 3b r, Index *pIdx);
297c0 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 75 6e 63 .int sqlite3Func
297d0 74 69 6f 6e 55 73 65 73 54 68 69 73 53 72 63 28 tionUsesThisSrc(
297e0 45 78 70 72 2a 2c 20 53 72 63 4c 69 73 74 2a 29 Expr*, SrcList*)
297f0 3b 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33 47 ;.Vdbe *sqlite3G
29800 65 74 56 64 62 65 28 50 61 72 73 65 2a 29 3b 0a etVdbe(Parse*);.
29810 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 55 #ifndef SQLITE_U
29820 4e 54 45 53 54 41 42 4c 45 0a 76 6f 69 64 20 73 NTESTABLE.void s
29830 71 6c 69 74 65 33 50 72 6e 67 53 61 76 65 53 74 qlite3PrngSaveSt
29840 61 74 65 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 ate(void);.void
29850 73 71 6c 69 74 65 33 50 72 6e 67 52 65 73 74 6f sqlite3PrngResto
29860 72 65 53 74 61 74 65 28 76 6f 69 64 29 3b 0a 23 reState(void);.#
29870 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 endif.void sqlit
29880 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 e3RollbackAll(sq
29890 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 lite3*,int);.voi
298a0 64 20 73 71 6c 69 74 65 33 43 6f 64 65 56 65 72 d sqlite3CodeVer
298b0 69 66 79 53 63 68 65 6d 61 28 50 61 72 73 65 2a ifySchema(Parse*
298c0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
298d0 69 74 65 33 43 6f 64 65 56 65 72 69 66 79 4e 61 ite3CodeVerifyNa
298e0 6d 65 64 53 63 68 65 6d 61 28 50 61 72 73 65 2a medSchema(Parse*
298f0 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 , const char *zD
29900 62 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 b);.void sqlite3
29910 42 65 67 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e BeginTransaction
29920 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 (Parse*, int);.v
29930 6f 69 64 20 73 71 6c 69 74 65 33 45 6e 64 54 72 oid sqlite3EndTr
29940 61 6e 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a ansaction(Parse*
29950 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
29960 74 65 33 53 61 76 65 70 6f 69 6e 74 28 50 61 72 te3Savepoint(Par
29970 73 65 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2a se*, int, Token*
29980 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 );.void sqlite3C
29990 6c 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 loseSavepoints(s
299a0 71 6c 69 74 65 33 20 2a 29 3b 0a 76 6f 69 64 20 qlite3 *);.void
299b0 73 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65 sqlite3LeaveMute
299c0 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28 xAndCloseZombie(
299d0 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 sqlite3*);.int s
299e0 71 6c 69 74 65 33 45 78 70 72 49 64 54 6f 54 72 qlite3ExprIdToTr
299f0 75 65 46 61 6c 73 65 28 45 78 70 72 2a 29 3b 0a ueFalse(Expr*);.
29a00 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 54 int sqlite3ExprT
29a10 72 75 74 68 56 61 6c 75 65 28 63 6f 6e 73 74 20 ruthValue(const
29a20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Expr*);.int sqli
29a30 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 6e te3ExprIsConstan
29a40 74 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 t(Expr*);.int sq
29a50 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 lite3ExprIsConst
29a60 61 6e 74 4e 6f 74 4a 6f 69 6e 28 45 78 70 72 2a antNotJoin(Expr*
29a70 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
29a80 70 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 46 75 prIsConstantOrFu
29a90 6e 63 74 69 6f 6e 28 45 78 70 72 2a 2c 20 75 38 nction(Expr*, u8
29aa0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
29ab0 70 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 47 72 prIsConstantOrGr
29ac0 6f 75 70 42 79 28 50 61 72 73 65 2a 2c 20 45 78 oupBy(Parse*, Ex
29ad0 70 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b pr*, ExprList*);
29ae0 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
29af0 49 73 54 61 62 6c 65 43 6f 6e 73 74 61 6e 74 28 IsTableConstant(
29b00 45 78 70 72 2a 2c 69 6e 74 29 3b 0a 23 69 66 64 Expr*,int);.#ifd
29b10 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
29b20 5f 43 55 52 53 4f 52 5f 48 49 4e 54 53 0a 69 6e _CURSOR_HINTS.in
29b30 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6e t sqlite3ExprCon
29b40 74 61 69 6e 73 53 75 62 71 75 65 72 79 28 45 78 tainsSubquery(Ex
29b50 70 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 pr*);.#endif.int
29b60 20 73 71 6c 69 74 65 33 45 78 70 72 49 73 49 6e sqlite3ExprIsIn
29b70 74 65 67 65 72 28 45 78 70 72 2a 2c 20 69 6e 74 teger(Expr*, int
29b80 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 *);.int sqlite3E
29b90 78 70 72 43 61 6e 42 65 4e 75 6c 6c 28 63 6f 6e xprCanBeNull(con
29ba0 73 74 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 st Expr*);.int s
29bb0 71 6c 69 74 65 33 45 78 70 72 4e 65 65 64 73 4e qlite3ExprNeedsN
29bc0 6f 41 66 66 69 6e 69 74 79 43 68 61 6e 67 65 28 oAffinityChange(
29bd0 63 6f 6e 73 74 20 45 78 70 72 2a 2c 20 63 68 61 const Expr*, cha
29be0 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 r);.int sqlite3I
29bf0 73 52 6f 77 69 64 28 63 6f 6e 73 74 20 63 68 61 sRowid(const cha
29c00 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
29c10 33 47 65 6e 65 72 61 74 65 52 6f 77 44 65 6c 65 3GenerateRowDele
29c20 74 65 28 0a 20 20 20 20 50 61 72 73 65 2a 2c 54 te(. Parse*,T
29c30 61 62 6c 65 2a 2c 54 72 69 67 67 65 72 2a 2c 69 able*,Trigger*,i
29c40 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 31 36 2c 75 nt,int,int,i16,u
29c50 38 2c 75 38 2c 75 38 2c 69 6e 74 29 3b 0a 76 6f 8,u8,u8,int);.vo
29c60 69 64 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 id sqlite3Genera
29c70 74 65 52 6f 77 49 6e 64 65 78 44 65 6c 65 74 65 teRowIndexDelete
29c80 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
29c90 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c int, int, int*,
29ca0 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
29cb0 65 33 47 65 6e 65 72 61 74 65 49 6e 64 65 78 4b e3GenerateIndexK
29cc0 65 79 28 50 61 72 73 65 2a 2c 20 49 6e 64 65 78 ey(Parse*, Index
29cd0 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 *, int, int, int
29ce0 2c 20 69 6e 74 2a 2c 49 6e 64 65 78 2a 2c 69 6e , int*,Index*,in
29cf0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
29d00 52 65 73 6f 6c 76 65 50 61 72 74 49 64 78 4c 61 ResolvePartIdxLa
29d10 62 65 6c 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b bel(Parse*,int);
29d20 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 65 6e .void sqlite3Gen
29d30 65 72 61 74 65 43 6f 6e 73 74 72 61 69 6e 74 43 erateConstraintC
29d40 68 65 63 6b 73 28 50 61 72 73 65 2a 2c 54 61 62 hecks(Parse*,Tab
29d50 6c 65 2a 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 le*,int*,int,int
29d60 2c 69 6e 74 2c 69 6e 74 2c 0a 20 20 20 20 20 20 ,int,int,.
29d70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 75 u
29d90 38 2c 75 38 2c 69 6e 74 2c 69 6e 74 2a 2c 69 6e 8,u8,int,int*,in
29da0 74 2a 2c 55 70 73 65 72 74 2a 29 3b 0a 23 69 66 t*,Upsert*);.#if
29db0 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
29dc0 45 5f 4e 55 4c 4c 5f 54 52 49 4d 0a 20 20 76 6f E_NULL_TRIM. vo
29dd0 69 64 20 73 71 6c 69 74 65 33 53 65 74 4d 61 6b id sqlite3SetMak
29de0 65 52 65 63 6f 72 64 50 35 28 56 64 62 65 2a 2c eRecordP5(Vdbe*,
29df0 54 61 62 6c 65 2a 29 3b 0a 23 65 6c 73 65 0a 23 Table*);.#else.#
29e00 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 define sqlite3S
29e10 65 74 4d 61 6b 65 52 65 63 6f 72 64 50 35 28 41 etMakeRecordP5(A
29e20 2c 42 29 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 ,B).#endif.void
29e30 73 71 6c 69 74 65 33 43 6f 6d 70 6c 65 74 65 49 sqlite3CompleteI
29e40 6e 73 65 72 74 69 6f 6e 28 50 61 72 73 65 2a 2c nsertion(Parse*,
29e50 54 61 62 6c 65 2a 2c 69 6e 74 2c 69 6e 74 2c 69 Table*,int,int,i
29e60 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 2c nt,int*,int,int,
29e70 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
29e80 33 4f 70 65 6e 54 61 62 6c 65 41 6e 64 49 6e 64 3OpenTableAndInd
29e90 69 63 65 73 28 50 61 72 73 65 2a 2c 20 54 61 62 ices(Parse*, Tab
29ea0 6c 65 2a 2c 20 69 6e 74 2c 20 75 38 2c 20 69 6e le*, int, u8, in
29eb0 74 2c 20 75 38 2a 2c 20 69 6e 74 2a 2c 20 69 6e t, u8*, int*, in
29ec0 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
29ed0 33 42 65 67 69 6e 57 72 69 74 65 4f 70 65 72 61 3BeginWriteOpera
29ee0 74 69 6f 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 tion(Parse*, int
29ef0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
29f00 69 74 65 33 4d 75 6c 74 69 57 72 69 74 65 28 50 ite3MultiWrite(P
29f10 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c arse*);.void sql
29f20 69 74 65 33 4d 61 79 41 62 6f 72 74 28 50 61 72 ite3MayAbort(Par
29f30 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
29f40 65 33 48 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 e3HaltConstraint
29f50 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e (Parse*, int, in
29f60 74 2c 20 63 68 61 72 2a 2c 20 69 38 2c 20 75 38 t, char*, i8, u8
29f70 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 );.void sqlite3U
29f80 6e 69 71 75 65 43 6f 6e 73 74 72 61 69 6e 74 28 niqueConstraint(
29f90 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 49 6e 64 Parse*, int, Ind
29fa0 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ex*);.void sqlit
29fb0 65 33 52 6f 77 69 64 43 6f 6e 73 74 72 61 69 6e e3RowidConstrain
29fc0 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 54 t(Parse*, int, T
29fd0 61 62 6c 65 2a 29 3b 0a 45 78 70 72 20 2a 73 71 able*);.Expr *sq
29fe0 6c 69 74 65 33 45 78 70 72 44 75 70 28 73 71 6c lite3ExprDup(sql
29ff0 69 74 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 ite3*,Expr*,int)
2a000 3b 0a 45 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 ;.ExprList *sqli
2a010 74 65 33 45 78 70 72 4c 69 73 74 44 75 70 28 73 te3ExprListDup(s
2a020 71 6c 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 qlite3*,ExprList
2a030 2a 2c 69 6e 74 29 3b 0a 53 72 63 4c 69 73 74 20 *,int);.SrcList
2a040 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 *sqlite3SrcListD
2a050 75 70 28 73 71 6c 69 74 65 33 2a 2c 53 72 63 4c up(sqlite3*,SrcL
2a060 69 73 74 2a 2c 69 6e 74 29 3b 0a 49 64 4c 69 73 ist*,int);.IdLis
2a070 74 20 2a 73 71 6c 69 74 65 33 49 64 4c 69 73 74 t *sqlite3IdList
2a080 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 49 64 4c Dup(sqlite3*,IdL
2a090 69 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 2a 73 ist*);.Select *s
2a0a0 71 6c 69 74 65 33 53 65 6c 65 63 74 44 75 70 28 qlite3SelectDup(
2a0b0 73 71 6c 69 74 65 33 2a 2c 53 65 6c 65 63 74 2a sqlite3*,Select*
2a0c0 2c 69 6e 74 29 3b 0a 23 69 66 20 53 45 4c 45 43 ,int);.#if SELEC
2a0d0 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 76 TTRACE_ENABLED.v
2a0e0 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 oid sqlite3Selec
2a0f0 74 53 65 74 4e 61 6d 65 28 53 65 6c 65 63 74 2a tSetName(Select*
2a100 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 ,const char*);.#
2a110 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
2a120 6c 69 74 65 33 53 65 6c 65 63 74 53 65 74 4e 61 lite3SelectSetNa
2a130 6d 65 28 41 2c 42 29 0a 23 65 6e 64 69 66 0a 76 me(A,B).#endif.v
2a140 6f 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 oid sqlite3Inser
2a150 74 42 75 69 6c 74 69 6e 46 75 6e 63 73 28 46 75 tBuiltinFuncs(Fu
2a160 6e 63 44 65 66 2a 2c 69 6e 74 29 3b 0a 46 75 6e ncDef*,int);.Fun
2a170 63 44 65 66 20 2a 73 71 6c 69 74 65 33 46 69 6e cDef *sqlite3Fin
2a180 64 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 dFunction(sqlite
2a190 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 3*,const char*,i
2a1a0 6e 74 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 20 nt,u8,u8);.void
2a1b0 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 sqlite3RegisterB
2a1c0 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 uiltinFunctions(
2a1d0 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 void);.void sqli
2a1e0 74 65 33 52 65 67 69 73 74 65 72 44 61 74 65 54 te3RegisterDateT
2a1f0 69 6d 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 imeFunctions(voi
2a200 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 d);.void sqlite3
2a210 52 65 67 69 73 74 65 72 50 65 72 43 6f 6e 6e 65 RegisterPerConne
2a220 63 74 69 6f 6e 42 75 69 6c 74 69 6e 46 75 6e 63 ctionBuiltinFunc
2a230 74 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b tions(sqlite3*);
2a240 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 61 66 65 .int sqlite3Safe
2a250 74 79 43 68 65 63 6b 4f 6b 28 73 71 6c 69 74 65 tyCheckOk(sqlite
2a260 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 3*);.int sqlite3
2a270 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f SafetyCheckSickO
2a280 72 4f 6b 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 rOk(sqlite3*);.v
2a290 6f 69 64 20 73 71 6c 69 74 65 33 43 68 61 6e 67 oid sqlite3Chang
2a2a0 65 43 6f 6f 6b 69 65 28 50 61 72 73 65 2a 2c 20 eCookie(Parse*,
2a2b0 69 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 69 int);..#if !defi
2a2c0 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
2a2d0 56 49 45 57 29 20 26 26 20 21 64 65 66 69 6e 65 VIEW) && !define
2a2e0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 d(SQLITE_OMIT_TR
2a2f0 49 47 47 45 52 29 0a 76 6f 69 64 20 73 71 6c 69 IGGER).void sqli
2a300 74 65 33 4d 61 74 65 72 69 61 6c 69 7a 65 56 69 te3MaterializeVi
2a310 65 77 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 ew(Parse*, Table
2a320 2a 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 4c 69 *, Expr*, ExprLi
2a330 73 74 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b 0a st*,Expr*,int);.
2a340 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
2a350 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 SQLITE_OMIT_TRIG
2a360 47 45 52 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 GER. void sqlit
2a370 65 33 42 65 67 69 6e 54 72 69 67 67 65 72 28 50 e3BeginTrigger(P
2a380 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 54 6f arse*, Token*,To
2a390 6b 65 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 49 64 4c ken*,int,int,IdL
2a3a0 69 73 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 0a 20 ist*,SrcList*,.
2a3b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a3c0 20 20 20 20 20 20 20 20 20 20 45 78 70 72 2a 2c Expr*,
2a3d0 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 int, int);. voi
2a3e0 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 54 d sqlite3FinishT
2a3f0 72 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 rigger(Parse*, T
2a400 72 69 67 67 65 72 53 74 65 70 2a 2c 20 54 6f 6b riggerStep*, Tok
2a410 65 6e 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c en*);. void sql
2a420 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 28 ite3DropTrigger(
2a430 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
2a440 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 , int);. void s
2a450 71 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 qlite3DropTrigge
2a460 72 50 74 72 28 50 61 72 73 65 2a 2c 20 54 72 69 rPtr(Parse*, Tri
2a470 67 67 65 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 gger*);. Trigge
2a480 72 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 r *sqlite3Trigge
2a490 72 73 45 78 69 73 74 28 50 61 72 73 65 20 2a 2c rsExist(Parse *,
2a4a0 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 45 78 Table*, int, Ex
2a4b0 70 72 4c 69 73 74 2a 2c 20 69 6e 74 20 2a 70 4d prList*, int *pM
2a4c0 61 73 6b 29 3b 0a 20 20 54 72 69 67 67 65 72 20 ask);. Trigger
2a4d0 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 4c *sqlite3TriggerL
2a4e0 69 73 74 28 50 61 72 73 65 20 2a 2c 20 54 61 62 ist(Parse *, Tab
2a4f0 6c 65 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 le *);. void sq
2a500 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 lite3CodeRowTrig
2a510 67 65 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 ger(Parse*, Trig
2a520 67 65 72 20 2a 2c 20 69 6e 74 2c 20 45 78 70 72 ger *, int, Expr
2a530 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 54 61 62 6c List*, int, Tabl
2a540 65 20 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 e *,.
2a550 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a560 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
2a570 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 . void sqlite3C
2a580 6f 64 65 52 6f 77 54 72 69 67 67 65 72 44 69 72 odeRowTriggerDir
2a590 65 63 74 28 50 61 72 73 65 20 2a 2c 20 54 72 69 ect(Parse *, Tri
2a5a0 67 67 65 72 20 2a 2c 20 54 61 62 6c 65 20 2a 2c gger *, Table *,
2a5b0 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
2a5c0 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 56 69 . void sqliteVi
2a5d0 65 77 54 72 69 67 67 65 72 73 28 50 61 72 73 65 ewTriggers(Parse
2a5e0 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a *, Table*, Expr*
2a5f0 2c 20 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a , int, ExprList*
2a600 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
2a610 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 53 74 3DeleteTriggerSt
2a620 65 70 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 ep(sqlite3*, Tri
2a630 67 67 65 72 53 74 65 70 2a 29 3b 0a 20 20 54 72 ggerStep*);. Tr
2a640 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 iggerStep *sqlit
2a650 65 33 54 72 69 67 67 65 72 53 65 6c 65 63 74 53 e3TriggerSelectS
2a660 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c tep(sqlite3*,Sel
2a670 65 63 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 ect*,.
2a680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f co
2a6a0 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 nst char*,const
2a6b0 63 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 char*);. Trigge
2a6c0 72 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 rStep *sqlite3Tr
2a6d0 69 67 67 65 72 49 6e 73 65 72 74 53 74 65 70 28 iggerInsertStep(
2a6e0 73 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c sqlite3*,Token*,
2a6f0 20 49 64 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 IdList*,.
2a700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a720 20 20 53 65 6c 65 63 74 2a 2c 75 38 2c 55 70 73 Select*,u8,Ups
2a730 65 72 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 ert*,.
2a740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f co
2a760 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 nst char*,const
2a770 63 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 char*);. Trigge
2a780 72 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 rStep *sqlite3Tr
2a790 69 67 67 65 72 55 70 64 61 74 65 53 74 65 70 28 iggerUpdateStep(
2a7a0 73 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c sqlite3*,Token*,
2a7b0 45 78 70 72 4c 69 73 74 2a 2c 20 45 78 70 72 2a ExprList*, Expr*
2a7c0 2c 20 75 38 2c 0a 20 20 20 20 20 20 20 20 20 20 , u8,.
2a7d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a7e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f co
2a7f0 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 nst char*,const
2a800 63 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 char*);. Trigge
2a810 72 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 rStep *sqlite3Tr
2a820 69 67 67 65 72 44 65 6c 65 74 65 53 74 65 70 28 iggerDeleteStep(
2a830 73 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c sqlite3*,Token*,
2a840 20 45 78 70 72 2a 2c 0a 20 20 20 20 20 20 20 20 Expr*,.
2a850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a870 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 const char*,cons
2a880 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 t char*);. void
2a890 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 54 72 sqlite3DeleteTr
2a8a0 69 67 67 65 72 28 73 71 6c 69 74 65 33 2a 2c 20 igger(sqlite3*,
2a8b0 54 72 69 67 67 65 72 2a 29 3b 0a 20 20 76 6f 69 Trigger*);. voi
2a8c0 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 d sqlite3UnlinkA
2a8d0 6e 64 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 ndDeleteTrigger(
2a8e0 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e sqlite3*,int,con
2a8f0 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 75 33 32 st char*);. u32
2a900 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 43 sqlite3TriggerC
2a910 6f 6c 6d 61 73 6b 28 50 61 72 73 65 2a 2c 54 72 olmask(Parse*,Tr
2a920 69 67 67 65 72 2a 2c 45 78 70 72 4c 69 73 74 2a igger*,ExprList*
2a930 2c 69 6e 74 2c 69 6e 74 2c 54 61 62 6c 65 2a 2c ,int,int,Table*,
2a940 69 6e 74 29 3b 0a 23 20 64 65 66 69 6e 65 20 73 int);.# define s
2a950 71 6c 69 74 65 33 50 61 72 73 65 54 6f 70 6c 65 qlite3ParseTople
2a960 76 65 6c 28 70 29 20 28 28 70 29 2d 3e 70 54 6f vel(p) ((p)->pTo
2a970 70 6c 65 76 65 6c 20 3f 20 28 70 29 2d 3e 70 54 plevel ? (p)->pT
2a980 6f 70 6c 65 76 65 6c 20 3a 20 28 70 29 29 0a 23 oplevel : (p)).#
2a990 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 define sqlite3I
2a9a0 73 54 6f 70 6c 65 76 65 6c 28 70 29 20 28 28 70 sToplevel(p) ((p
2a9b0 29 2d 3e 70 54 6f 70 6c 65 76 65 6c 3d 3d 30 29 )->pToplevel==0)
2a9c0 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
2a9d0 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 73 45 sqlite3TriggersE
2a9e0 78 69 73 74 28 42 2c 43 2c 44 2c 45 2c 46 29 20 xist(B,C,D,E,F)
2a9f0 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
2aa00 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 e3DeleteTrigger(
2aa10 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 20 73 71 A,B).# define sq
2aa20 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 lite3DropTrigger
2aa30 50 74 72 28 41 2c 42 29 0a 23 20 64 65 66 69 6e Ptr(A,B).# defin
2aa40 65 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 e sqlite3UnlinkA
2aa50 6e 64 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 ndDeleteTrigger(
2aa60 41 2c 42 2c 43 29 0a 23 20 64 65 66 69 6e 65 20 A,B,C).# define
2aa70 73 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 sqlite3CodeRowTr
2aa80 69 67 67 65 72 28 41 2c 42 2c 43 2c 44 2c 45 2c igger(A,B,C,D,E,
2aa90 46 2c 47 2c 48 2c 49 29 0a 23 20 64 65 66 69 6e F,G,H,I).# defin
2aaa0 65 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 e sqlite3CodeRow
2aab0 54 72 69 67 67 65 72 44 69 72 65 63 74 28 41 2c TriggerDirect(A,
2aac0 42 2c 43 2c 44 2c 45 2c 46 29 0a 23 20 64 65 66 B,C,D,E,F).# def
2aad0 69 6e 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 ine sqlite3Trigg
2aae0 65 72 4c 69 73 74 28 58 2c 20 59 29 20 30 0a 23 erList(X, Y) 0.#
2aaf0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 50 define sqlite3P
2ab00 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 29 20 arseToplevel(p)
2ab10 70 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 p.# define sqlit
2ab20 65 33 49 73 54 6f 70 6c 65 76 65 6c 28 70 29 20 e3IsToplevel(p)
2ab30 31 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 1.# define sqlit
2ab40 65 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 73 6b e3TriggerColmask
2ab50 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 2c 47 29 20 (A,B,C,D,E,F,G)
2ab60 30 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 0.#endif..int sq
2ab70 6c 69 74 65 33 4a 6f 69 6e 54 79 70 65 28 50 61 lite3JoinType(Pa
2ab80 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f rse*, Token*, To
2ab90 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 ken*, Token*);.v
2aba0 6f 69 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 oid sqlite3Creat
2abb0 65 46 6f 72 65 69 67 6e 4b 65 79 28 50 61 72 73 eForeignKey(Pars
2abc0 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 54 e*, ExprList*, T
2abd0 6f 6b 65 6e 2a 2c 20 45 78 70 72 4c 69 73 74 2a oken*, ExprList*
2abe0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
2abf0 69 74 65 33 44 65 66 65 72 46 6f 72 65 69 67 6e ite3DeferForeign
2ac00 4b 65 79 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 Key(Parse*, int)
2ac10 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
2ac20 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 _OMIT_AUTHORIZAT
2ac30 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 ION. void sqlit
2ac40 65 33 41 75 74 68 52 65 61 64 28 50 61 72 73 65 e3AuthRead(Parse
2ac50 2a 2c 45 78 70 72 2a 2c 53 63 68 65 6d 61 2a 2c *,Expr*,Schema*,
2ac60 53 72 63 4c 69 73 74 2a 29 3b 0a 20 20 69 6e 74 SrcList*);. int
2ac70 20 73 71 6c 69 74 65 33 41 75 74 68 43 68 65 63 sqlite3AuthChec
2ac80 6b 28 50 61 72 73 65 2a 2c 69 6e 74 2c 20 63 6f k(Parse*,int, co
2ac90 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 nst char*, const
2aca0 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 char*, const ch
2acb0 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c ar*);. void sql
2acc0 69 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 50 ite3AuthContextP
2acd0 75 73 68 28 50 61 72 73 65 2a 2c 20 41 75 74 68 ush(Parse*, Auth
2ace0 43 6f 6e 74 65 78 74 2a 2c 20 63 6f 6e 73 74 20 Context*, const
2acf0 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 char*);. void s
2ad00 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 65 78 qlite3AuthContex
2ad10 74 50 6f 70 28 41 75 74 68 43 6f 6e 74 65 78 74 tPop(AuthContext
2ad20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 *);. int sqlite
2ad30 33 41 75 74 68 52 65 61 64 43 6f 6c 28 50 61 72 3AuthReadCol(Par
2ad40 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 se*, const char
2ad50 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c *, const char *,
2ad60 20 69 6e 74 29 3b 0a 23 65 6c 73 65 0a 23 20 64 int);.#else.# d
2ad70 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 efine sqlite3Aut
2ad80 68 52 65 61 64 28 61 2c 62 2c 63 2c 64 29 0a 23 hRead(a,b,c,d).#
2ad90 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 define sqlite3A
2ada0 75 74 68 43 68 65 63 6b 28 61 2c 62 2c 63 2c 64 uthCheck(a,b,c,d
2adb0 2c 65 29 20 20 20 20 53 51 4c 49 54 45 5f 4f 4b ,e) SQLITE_OK
2adc0 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2add0 33 41 75 74 68 43 6f 6e 74 65 78 74 50 75 73 68 3AuthContextPush
2ade0 28 61 2c 62 2c 63 29 0a 23 20 64 65 66 69 6e 65 (a,b,c).# define
2adf0 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 sqlite3AuthCont
2ae00 65 78 74 50 6f 70 28 61 29 20 20 28 28 76 6f 69 extPop(a) ((voi
2ae10 64 29 28 61 29 29 0a 23 65 6e 64 69 66 0a 76 6f d)(a)).#endif.vo
2ae20 69 64 20 73 71 6c 69 74 65 33 41 74 74 61 63 68 id sqlite3Attach
2ae30 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 (Parse*, Expr*,
2ae40 45 78 70 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 Expr*, Expr*);.v
2ae50 6f 69 64 20 73 71 6c 69 74 65 33 44 65 74 61 63 oid sqlite3Detac
2ae60 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 h(Parse*, Expr*)
2ae70 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 69 ;.void sqlite3Fi
2ae80 78 49 6e 69 74 28 44 62 46 69 78 65 72 2a 2c 20 xInit(DbFixer*,
2ae90 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 63 6f 6e Parse*, int, con
2aea0 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
2aeb0 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c Token*);.int sql
2aec0 69 74 65 33 46 69 78 53 72 63 4c 69 73 74 28 44 ite3FixSrcList(D
2aed0 62 46 69 78 65 72 2a 2c 20 53 72 63 4c 69 73 74 bFixer*, SrcList
2aee0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 *);.int sqlite3F
2aef0 69 78 53 65 6c 65 63 74 28 44 62 46 69 78 65 72 ixSelect(DbFixer
2af00 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 *, Select*);.int
2af10 20 73 71 6c 69 74 65 33 46 69 78 45 78 70 72 28 sqlite3FixExpr(
2af20 44 62 46 69 78 65 72 2a 2c 20 45 78 70 72 2a 29 DbFixer*, Expr*)
2af30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 ;.int sqlite3Fix
2af40 45 78 70 72 4c 69 73 74 28 44 62 46 69 78 65 72 ExprList(DbFixer
2af50 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a 69 *, ExprList*);.i
2af60 6e 74 20 73 71 6c 69 74 65 33 46 69 78 54 72 69 nt sqlite3FixTri
2af70 67 67 65 72 53 74 65 70 28 44 62 46 69 78 65 72 ggerStep(DbFixer
2af80 2a 2c 20 54 72 69 67 67 65 72 53 74 65 70 2a 29 *, TriggerStep*)
2af90 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 74 6f ;.int sqlite3Ato
2afa0 46 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c F(const char *z,
2afb0 20 64 6f 75 62 6c 65 2a 2c 20 69 6e 74 2c 20 75 double*, int, u
2afc0 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 8);.int sqlite3G
2afd0 65 74 49 6e 74 33 32 28 63 6f 6e 73 74 20 63 68 etInt32(const ch
2afe0 61 72 20 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 ar *, int*);.int
2aff0 20 73 71 6c 69 74 65 33 41 74 6f 69 28 63 6f 6e sqlite3Atoi(con
2b000 73 74 20 63 68 61 72 2a 29 3b 0a 23 69 66 6e 64 st char*);.#ifnd
2b010 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
2b020 54 46 31 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 TF16.int sqlite3
2b030 55 74 66 31 36 42 79 74 65 4c 65 6e 28 63 6f 6e Utf16ByteLen(con
2b040 73 74 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 st void *pData,
2b050 69 6e 74 20 6e 43 68 61 72 29 3b 0a 23 65 6e 64 int nChar);.#end
2b060 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 74 if.int sqlite3Ut
2b070 66 38 43 68 61 72 4c 65 6e 28 63 6f 6e 73 74 20 f8CharLen(const
2b080 63 68 61 72 20 2a 70 44 61 74 61 2c 20 69 6e 74 char *pData, int
2b090 20 6e 42 79 74 65 29 3b 0a 75 33 32 20 73 71 6c nByte);.u32 sql
2b0a0 69 74 65 33 55 74 66 38 52 65 61 64 28 63 6f 6e ite3Utf8Read(con
2b0b0 73 74 20 75 38 2a 2a 29 3b 0a 4c 6f 67 45 73 74 st u8**);.LogEst
2b0c0 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 75 sqlite3LogEst(u
2b0d0 36 34 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 64);.LogEst sqli
2b0e0 74 65 33 4c 6f 67 45 73 74 41 64 64 28 4c 6f 67 te3LogEstAdd(Log
2b0f0 45 73 74 2c 4c 6f 67 45 73 74 29 3b 0a 23 69 66 Est,LogEst);.#if
2b100 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2b110 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 4c 6f _VIRTUALTABLE.Lo
2b120 67 45 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 gEst sqlite3LogE
2b130 73 74 46 72 6f 6d 44 6f 75 62 6c 65 28 64 6f 75 stFromDouble(dou
2b140 62 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 ble);.#endif.#if
2b150 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
2b160 45 4e 41 42 4c 45 5f 53 54 4d 54 5f 53 43 41 4e ENABLE_STMT_SCAN
2b170 53 54 41 54 55 53 29 20 7c 7c 20 5c 0a 20 20 20 STATUS) || \.
2b180 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
2b190 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f ENABLE_STAT3_OR_
2b1a0 53 54 41 54 34 29 20 7c 7c 20 5c 0a 20 20 20 20 STAT4) || \.
2b1b0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
2b1c0 58 50 4c 41 49 4e 5f 45 53 54 49 4d 41 54 45 44 XPLAIN_ESTIMATED
2b1d0 5f 52 4f 57 53 29 0a 75 36 34 20 73 71 6c 69 74 _ROWS).u64 sqlit
2b1e0 65 33 4c 6f 67 45 73 74 54 6f 49 6e 74 28 4c 6f e3LogEstToInt(Lo
2b1f0 67 45 73 74 29 3b 0a 23 65 6e 64 69 66 0a 56 4c gEst);.#endif.VL
2b200 69 73 74 20 2a 73 71 6c 69 74 65 33 56 4c 69 73 ist *sqlite3VLis
2b210 74 41 64 64 28 73 71 6c 69 74 65 33 2a 2c 56 4c tAdd(sqlite3*,VL
2b220 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a ist*,const char*
2b230 2c 69 6e 74 2c 69 6e 74 29 3b 0a 63 6f 6e 73 74 ,int,int);.const
2b240 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 4c char *sqlite3VL
2b250 69 73 74 4e 75 6d 54 6f 4e 61 6d 65 28 56 4c 69 istNumToName(VLi
2b260 73 74 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 st*,int);.int sq
2b270 6c 69 74 65 33 56 4c 69 73 74 4e 61 6d 65 54 6f lite3VListNameTo
2b280 4e 75 6d 28 56 4c 69 73 74 2a 2c 63 6f 6e 73 74 Num(VList*,const
2b290 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 0a 2f 2a char*,int);../*
2b2a0 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 74 6f 20 .** Routines to
2b2b0 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 76 read and write v
2b2c0 61 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 69 ariable-length i
2b2d0 6e 74 65 67 65 72 73 2e 20 20 54 68 65 73 65 20 ntegers. These
2b2e0 75 73 65 64 20 74 6f 0a 2a 2a 20 62 65 20 64 65 used to.** be de
2b2f0 66 69 6e 65 64 20 6c 6f 63 61 6c 6c 79 2c 20 62 fined locally, b
2b300 75 74 20 6e 6f 77 20 77 65 20 75 73 65 20 74 68 ut now we use th
2b310 65 20 76 61 72 69 6e 74 20 72 6f 75 74 69 6e 65 e varint routine
2b320 73 20 69 6e 20 74 68 65 20 75 74 69 6c 2e 63 0a s in the util.c.
2b330 2a 2a 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 ** file..*/.int
2b340 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e 74 sqlite3PutVarint
2b350 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 2c (unsigned char*,
2b360 20 75 36 34 29 3b 0a 75 38 20 73 71 6c 69 74 65 u64);.u8 sqlite
2b370 33 47 65 74 56 61 72 69 6e 74 28 63 6f 6e 73 74 3GetVarint(const
2b380 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
2b390 2c 20 75 36 34 20 2a 29 3b 0a 75 38 20 73 71 6c , u64 *);.u8 sql
2b3a0 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 ite3GetVarint32(
2b3b0 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 const unsigned c
2b3c0 68 61 72 20 2a 2c 20 75 33 32 20 2a 29 3b 0a 69 har *, u32 *);.i
2b3d0 6e 74 20 73 71 6c 69 74 65 33 56 61 72 69 6e 74 nt sqlite3Varint
2b3e0 4c 65 6e 28 75 36 34 20 76 29 3b 0a 0a 2f 2a 0a Len(u64 v);../*.
2b3f0 2a 2a 20 54 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 ** The common ca
2b400 73 65 20 69 73 20 66 6f 72 20 61 20 76 61 72 69 se is for a vari
2b410 6e 74 20 74 6f 20 62 65 20 61 20 73 69 6e 67 6c nt to be a singl
2b420 65 20 62 79 74 65 2e 20 20 54 68 65 79 20 66 6f e byte. They fo
2b430 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 6d 61 63 72 6f llowing.** macro
2b440 73 20 68 61 6e 64 6c 65 20 74 68 65 20 63 6f 6d s handle the com
2b450 6d 6f 6e 20 63 61 73 65 20 77 69 74 68 6f 75 74 mon case without
2b460 20 61 20 70 72 6f 63 65 64 75 72 65 20 63 61 6c a procedure cal
2b470 6c 2c 20 62 75 74 20 74 68 65 6e 20 63 61 6c 6c l, but then call
2b480 0a 2a 2a 20 74 68 65 20 70 72 6f 63 65 64 75 72 .** the procedur
2b490 65 20 66 6f 72 20 6c 61 72 67 65 72 20 76 61 72 e for larger var
2b4a0 69 6e 74 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ints..*/.#define
2b4b0 20 67 65 74 56 61 72 69 6e 74 33 32 28 41 2c 42 getVarint32(A,B
2b4c0 29 20 20 5c 0a 20 20 28 75 38 29 28 28 2a 28 41 ) \. (u8)((*(A
2b4d0 29 3c 28 75 38 29 30 78 38 30 29 3f 28 28 42 29 )<(u8)0x80)?((B)
2b4e0 3d 28 75 33 32 29 2a 28 41 29 29 2c 31 3a 73 71 =(u32)*(A)),1:sq
2b4f0 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 lite3GetVarint32
2b500 28 28 41 29 2c 28 75 33 32 20 2a 29 26 28 42 29 ((A),(u32 *)&(B)
2b510 29 29 0a 23 64 65 66 69 6e 65 20 70 75 74 56 61 )).#define putVa
2b520 72 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a 20 rint32(A,B) \.
2b530 20 28 75 38 29 28 28 28 75 33 32 29 28 42 29 3c (u8)(((u32)(B)<
2b540 28 75 33 32 29 30 78 38 30 29 3f 28 2a 28 41 29 (u32)0x80)?(*(A)
2b550 3d 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 =(unsigned char)
2b560 28 42 29 29 2c 31 3a 5c 0a 20 20 73 71 6c 69 74 (B)),1:\. sqlit
2b570 65 33 50 75 74 56 61 72 69 6e 74 28 28 41 29 2c e3PutVarint((A),
2b580 28 42 29 29 29 0a 23 64 65 66 69 6e 65 20 67 65 (B))).#define ge
2b590 74 56 61 72 69 6e 74 20 20 20 20 73 71 6c 69 74 tVarint sqlit
2b5a0 65 33 47 65 74 56 61 72 69 6e 74 0a 23 64 65 66 e3GetVarint.#def
2b5b0 69 6e 65 20 70 75 74 56 61 72 69 6e 74 20 20 20 ine putVarint
2b5c0 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e sqlite3PutVarin
2b5d0 74 0a 0a 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a t...const char *
2b5e0 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 66 69 sqlite3IndexAffi
2b5f0 6e 69 74 79 53 74 72 28 73 71 6c 69 74 65 33 2a nityStr(sqlite3*
2b600 2c 20 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 , Index*);.void
2b610 73 71 6c 69 74 65 33 54 61 62 6c 65 41 66 66 69 sqlite3TableAffi
2b620 6e 69 74 79 28 56 64 62 65 2a 2c 20 54 61 62 6c nity(Vdbe*, Tabl
2b630 65 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 73 e*, int);.char s
2b640 71 6c 69 74 65 33 43 6f 6d 70 61 72 65 41 66 66 qlite3CompareAff
2b650 69 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 inity(Expr *pExp
2b660 72 2c 20 63 68 61 72 20 61 66 66 32 29 3b 0a 69 r, char aff2);.i
2b670 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 65 78 41 nt sqlite3IndexA
2b680 66 66 69 6e 69 74 79 4f 6b 28 45 78 70 72 20 2a ffinityOk(Expr *
2b690 70 45 78 70 72 2c 20 63 68 61 72 20 69 64 78 5f pExpr, char idx_
2b6a0 61 66 66 69 6e 69 74 79 29 3b 0a 63 68 61 72 20 affinity);.char
2b6b0 73 71 6c 69 74 65 33 54 61 62 6c 65 43 6f 6c 75 sqlite3TableColu
2b6c0 6d 6e 41 66 66 69 6e 69 74 79 28 54 61 62 6c 65 mnAffinity(Table
2b6d0 2a 2c 69 6e 74 29 3b 0a 63 68 61 72 20 73 71 6c *,int);.char sql
2b6e0 69 74 65 33 45 78 70 72 41 66 66 69 6e 69 74 79 ite3ExprAffinity
2b6f0 28 45 78 70 72 20 2a 70 45 78 70 72 29 3b 0a 69 (Expr *pExpr);.i
2b700 6e 74 20 73 71 6c 69 74 65 33 41 74 6f 69 36 34 nt sqlite3Atoi64
2b710 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 36 (const char*, i6
2b720 34 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 6e 4*, int, u8);.in
2b730 74 20 73 71 6c 69 74 65 33 44 65 63 4f 72 48 65 t sqlite3DecOrHe
2b740 78 54 6f 49 36 34 28 63 6f 6e 73 74 20 63 68 61 xToI64(const cha
2b750 72 2a 2c 20 69 36 34 2a 29 3b 0a 76 6f 69 64 20 r*, i64*);.void
2b760 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 sqlite3ErrorWith
2b770 4d 73 67 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e Msg(sqlite3*, in
2b780 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 2e t, const char*,.
2b790 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 ..);.void sqlite
2b7a0 33 45 72 72 6f 72 28 73 71 6c 69 74 65 33 2a 2c 3Error(sqlite3*,
2b7b0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
2b7c0 65 33 53 79 73 74 65 6d 45 72 72 6f 72 28 73 71 e3SystemError(sq
2b7d0 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 lite3*,int);.voi
2b7e0 64 20 2a 73 71 6c 69 74 65 33 48 65 78 54 6f 42 d *sqlite3HexToB
2b7f0 6c 6f 62 28 73 71 6c 69 74 65 33 2a 2c 20 63 6f lob(sqlite3*, co
2b800 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 nst char *z, int
2b810 20 6e 29 3b 0a 75 38 20 73 71 6c 69 74 65 33 48 n);.u8 sqlite3H
2b820 65 78 54 6f 49 6e 74 28 69 6e 74 20 68 29 3b 0a exToInt(int h);.
2b830 69 6e 74 20 73 71 6c 69 74 65 33 54 77 6f 50 61 int sqlite3TwoPa
2b840 72 74 4e 61 6d 65 28 50 61 72 73 65 20 2a 2c 20 rtName(Parse *,
2b850 54 6f 6b 65 6e 20 2a 2c 20 54 6f 6b 65 6e 20 2a Token *, Token *
2b860 2c 20 54 6f 6b 65 6e 20 2a 2a 29 3b 0a 0a 23 69 , Token **);..#i
2b870 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
2b880 5f 4e 45 45 44 5f 45 52 52 5f 4e 41 4d 45 29 0a _NEED_ERR_NAME).
2b890 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 const char *sqli
2b8a0 74 65 33 45 72 72 4e 61 6d 65 28 69 6e 74 29 3b te3ErrName(int);
2b8b0 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
2b8c0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 44 45 SQLITE_ENABLE_DE
2b8d0 53 45 52 49 41 4c 49 5a 45 0a 69 6e 74 20 73 71 SERIALIZE.int sq
2b8e0 6c 69 74 65 33 4d 65 6d 64 62 49 6e 69 74 28 76 lite3MemdbInit(v
2b8f0 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 0a 63 6f oid);.#endif..co
2b900 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 nst char *sqlite
2b910 33 45 72 72 53 74 72 28 69 6e 74 29 3b 0a 69 6e 3ErrStr(int);.in
2b920 74 20 73 71 6c 69 74 65 33 52 65 61 64 53 63 68 t sqlite3ReadSch
2b930 65 6d 61 28 50 61 72 73 65 20 2a 70 50 61 72 73 ema(Parse *pPars
2b940 65 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c e);.CollSeq *sql
2b950 69 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 ite3FindCollSeq(
2b960 73 71 6c 69 74 65 33 2a 2c 75 38 20 65 6e 63 2c sqlite3*,u8 enc,
2b970 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 const char*,int
2b980 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
2b990 74 65 33 4c 6f 63 61 74 65 43 6f 6c 6c 53 65 71 te3LocateCollSeq
2b9a0 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 (Parse *pParse,
2b9b0 63 6f 6e 73 74 20 63 68 61 72 2a 7a 4e 61 6d 65 const char*zName
2b9c0 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
2b9d0 74 65 33 45 78 70 72 43 6f 6c 6c 53 65 71 28 50 te3ExprCollSeq(P
2b9e0 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 45 78 arse *pParse, Ex
2b9f0 70 72 20 2a 70 45 78 70 72 29 3b 0a 43 6f 6c 6c pr *pExpr);.Coll
2ba00 53 65 71 20 2a 73 71 6c 69 74 65 33 45 78 70 72 Seq *sqlite3Expr
2ba10 4e 4e 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 NNCollSeq(Parse
2ba20 2a 70 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 *pParse, Expr *p
2ba30 45 78 70 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 Expr);.int sqlit
2ba40 65 33 45 78 70 72 43 6f 6c 6c 53 65 71 4d 61 74 e3ExprCollSeqMat
2ba50 63 68 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c ch(Parse*,Expr*,
2ba60 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 Expr*);.Expr *sq
2ba70 6c 69 74 65 33 45 78 70 72 41 64 64 43 6f 6c 6c lite3ExprAddColl
2ba80 61 74 65 54 6f 6b 65 6e 28 50 61 72 73 65 20 2a ateToken(Parse *
2ba90 70 50 61 72 73 65 2c 20 45 78 70 72 2a 2c 20 63 pParse, Expr*, c
2baa0 6f 6e 73 74 20 54 6f 6b 65 6e 2a 2c 20 69 6e 74 onst Token*, int
2bab0 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 );.Expr *sqlite3
2bac0 45 78 70 72 41 64 64 43 6f 6c 6c 61 74 65 53 74 ExprAddCollateSt
2bad0 72 69 6e 67 28 50 61 72 73 65 2a 2c 45 78 70 72 ring(Parse*,Expr
2bae0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a *,const char*);.
2baf0 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
2bb00 72 53 6b 69 70 43 6f 6c 6c 61 74 65 28 45 78 70 rSkipCollate(Exp
2bb10 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
2bb20 43 68 65 63 6b 43 6f 6c 6c 53 65 71 28 50 61 72 CheckCollSeq(Par
2bb30 73 65 20 2a 2c 20 43 6f 6c 6c 53 65 71 20 2a 29 se *, CollSeq *)
2bb40 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 68 65 ;.int sqlite3Che
2bb50 63 6b 4f 62 6a 65 63 74 4e 61 6d 65 28 50 61 72 ckObjectName(Par
2bb60 73 65 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 se *, const char
2bb70 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);.void sqlite
2bb80 33 56 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 3VdbeSetChanges(
2bb90 73 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 29 3b sqlite3 *, int);
2bba0 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 64 64 49 .int sqlite3AddI
2bbb0 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a nt64(i64*,i64);.
2bbc0 69 6e 74 20 73 71 6c 69 74 65 33 53 75 62 49 6e int sqlite3SubIn
2bbd0 74 36 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 t64(i64*,i64);.i
2bbe0 6e 74 20 73 71 6c 69 74 65 33 4d 75 6c 49 6e 74 nt sqlite3MulInt
2bbf0 36 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 64(i64*,i64);.in
2bc00 74 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 33 t sqlite3AbsInt3
2bc10 32 28 69 6e 74 29 3b 0a 23 69 66 64 65 66 20 53 2(int);.#ifdef S
2bc20 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 QLITE_ENABLE_8_3
2bc30 5f 4e 41 4d 45 53 0a 76 6f 69 64 20 73 71 6c 69 _NAMES.void sqli
2bc40 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 63 te3FileSuffix3(c
2bc50 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 68 61 72 onst char*, char
2bc60 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 *);.#else.# defi
2bc70 6e 65 20 73 71 6c 69 74 65 33 46 69 6c 65 53 75 ne sqlite3FileSu
2bc80 66 66 69 78 33 28 58 2c 59 29 0a 23 65 6e 64 69 ffix3(X,Y).#endi
2bc90 66 0a 75 38 20 73 71 6c 69 74 65 33 47 65 74 42 f.u8 sqlite3GetB
2bca0 6f 6f 6c 65 61 6e 28 63 6f 6e 73 74 20 63 68 61 oolean(const cha
2bcb0 72 20 2a 7a 2c 75 38 29 3b 0a 0a 63 6f 6e 73 74 r *z,u8);..const
2bcc0 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 56 61 void *sqlite3Va
2bcd0 6c 75 65 54 65 78 74 28 73 71 6c 69 74 65 33 5f lueText(sqlite3_
2bce0 76 61 6c 75 65 2a 2c 20 75 38 29 3b 0a 69 6e 74 value*, u8);.int
2bcf0 20 73 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 sqlite3ValueByt
2bd00 65 73 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 es(sqlite3_value
2bd10 2a 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c *, u8);.void sql
2bd20 69 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 ite3ValueSetStr(
2bd30 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2c 20 sqlite3_value*,
2bd40 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 int, const void
2bd50 2a 2c 75 38 2c 0a 20 20 20 20 20 20 20 20 20 20 *,u8,.
2bd60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 76 6f vo
2bd70 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b 0a 76 id(*)(void*));.v
2bd80 6f 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 oid sqlite3Value
2bd90 53 65 74 4e 75 6c 6c 28 73 71 6c 69 74 65 33 5f SetNull(sqlite3_
2bda0 76 61 6c 75 65 2a 29 3b 0a 76 6f 69 64 20 73 71 value*);.void sq
2bdb0 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 73 lite3ValueFree(s
2bdc0 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 3b 0a qlite3_value*);.
2bdd0 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 73 sqlite3_value *s
2bde0 71 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 73 qlite3ValueNew(s
2bdf0 71 6c 69 74 65 33 20 2a 29 3b 0a 23 69 66 6e 64 qlite3 *);.#ifnd
2be00 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 ef SQLITE_OMIT_U
2be10 54 46 31 36 0a 63 68 61 72 20 2a 73 71 6c 69 74 TF16.char *sqlit
2be20 65 33 55 74 66 31 36 74 6f 38 28 73 71 6c 69 74 e3Utf16to8(sqlit
2be30 65 33 20 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 e3 *, const void
2be40 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 23 65 6e *, int, u8);.#en
2be50 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 dif.int sqlite3V
2be60 61 6c 75 65 46 72 6f 6d 45 78 70 72 28 73 71 6c alueFromExpr(sql
2be70 69 74 65 33 20 2a 2c 20 45 78 70 72 20 2a 2c 20 ite3 *, Expr *,
2be80 75 38 2c 20 75 38 2c 20 73 71 6c 69 74 65 33 5f u8, u8, sqlite3_
2be90 76 61 6c 75 65 20 2a 2a 29 3b 0a 76 6f 69 64 20 value **);.void
2bea0 73 71 6c 69 74 65 33 56 61 6c 75 65 41 70 70 6c sqlite3ValueAppl
2beb0 79 41 66 66 69 6e 69 74 79 28 73 71 6c 69 74 65 yAffinity(sqlite
2bec0 33 5f 76 61 6c 75 65 20 2a 2c 20 75 38 2c 20 75 3_value *, u8, u
2bed0 38 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 8);.#ifndef SQLI
2bee0 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a TE_AMALGAMATION.
2bef0 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e 73 extern const uns
2bf00 69 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 74 igned char sqlit
2bf10 65 33 4f 70 63 6f 64 65 50 72 6f 70 65 72 74 79 e3OpcodeProperty
2bf20 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 [];.extern const
2bf30 20 63 68 61 72 20 73 71 6c 69 74 65 33 53 74 72 char sqlite3Str
2bf40 42 49 4e 41 52 59 5b 5d 3b 0a 65 78 74 65 72 6e BINARY[];.extern
2bf50 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 const unsigned
2bf60 63 68 61 72 20 73 71 6c 69 74 65 33 55 70 70 65 char sqlite3Uppe
2bf70 72 54 6f 4c 6f 77 65 72 5b 5d 3b 0a 65 78 74 65 rToLower[];.exte
2bf80 72 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 rn const unsigne
2bf90 64 20 63 68 61 72 20 73 71 6c 69 74 65 33 43 74 d char sqlite3Ct
2bfa0 79 70 65 4d 61 70 5b 5d 3b 0a 65 78 74 65 72 6e ypeMap[];.extern
2bfb0 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 20 73 71 6c const Token sql
2bfc0 69 74 65 33 49 6e 74 54 6f 6b 65 6e 73 5b 5d 3b ite3IntTokens[];
2bfd0 0a 65 78 74 65 72 6e 20 53 51 4c 49 54 45 5f 57 .extern SQLITE_W
2bfe0 53 44 20 73 74 72 75 63 74 20 53 71 6c 69 74 65 SD struct Sqlite
2bff0 33 43 6f 6e 66 69 67 20 73 71 6c 69 74 65 33 43 3Config sqlite3C
2c000 6f 6e 66 69 67 3b 0a 65 78 74 65 72 6e 20 46 75 onfig;.extern Fu
2c010 6e 63 44 65 66 48 61 73 68 20 73 71 6c 69 74 65 ncDefHash sqlite
2c020 33 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 3BuiltinFunction
2c030 73 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 s;.#ifndef SQLIT
2c040 45 5f 4f 4d 49 54 5f 57 53 44 0a 65 78 74 65 72 E_OMIT_WSD.exter
2c050 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 50 65 6e n int sqlite3Pen
2c060 64 69 6e 67 42 79 74 65 3b 0a 23 65 6e 64 69 66 dingByte;.#endif
2c070 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 56 .#endif.#ifdef V
2c080 44 42 45 5f 50 52 4f 46 49 4c 45 0a 65 78 74 65 DBE_PROFILE.exte
2c090 72 6e 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 rn sqlite3_uint6
2c0a0 34 20 73 71 6c 69 74 65 33 4e 50 72 6f 66 69 6c 4 sqlite3NProfil
2c0b0 65 43 6e 74 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 eCnt;.#endif.voi
2c0c0 64 20 73 71 6c 69 74 65 33 52 6f 6f 74 50 61 67 d sqlite3RootPag
2c0d0 65 4d 6f 76 65 64 28 73 71 6c 69 74 65 33 2a 2c eMoved(sqlite3*,
2c0e0 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
2c0f0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 69 .void sqlite3Rei
2c100 6e 64 65 78 28 50 61 72 73 65 2a 2c 20 54 6f 6b ndex(Parse*, Tok
2c110 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f en*, Token*);.vo
2c120 69 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 46 id sqlite3AlterF
2c130 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a unctions(void);.
2c140 76 6f 69 64 20 73 71 6c 69 74 65 33 41 6c 74 65 void sqlite3Alte
2c150 72 52 65 6e 61 6d 65 54 61 62 6c 65 28 50 61 72 rRenameTable(Par
2c160 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 se*, SrcList*, T
2c170 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 oken*);.int sqli
2c180 74 65 33 47 65 74 54 6f 6b 65 6e 28 63 6f 6e 73 te3GetToken(cons
2c190 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 t unsigned char
2c1a0 2a 2c 20 69 6e 74 20 2a 29 3b 0a 76 6f 69 64 20 *, int *);.void
2c1b0 73 71 6c 69 74 65 33 4e 65 73 74 65 64 50 61 72 sqlite3NestedPar
2c1c0 73 65 28 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 se(Parse*, const
2c1d0 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f char*, ...);.vo
2c1e0 69 64 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 id sqlite3Expire
2c1f0 50 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e PreparedStatemen
2c200 74 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e ts(sqlite3*);.in
2c210 74 20 73 71 6c 69 74 65 33 43 6f 64 65 53 75 62 t sqlite3CodeSub
2c220 73 65 6c 65 63 74 28 50 61 72 73 65 2a 2c 20 45 select(Parse*, E
2c230 78 70 72 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 xpr *, int, int)
2c240 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 ;.void sqlite3Se
2c250 6c 65 63 74 50 72 65 70 28 50 61 72 73 65 2a 2c lectPrep(Parse*,
2c260 20 53 65 6c 65 63 74 2a 2c 20 4e 61 6d 65 43 6f Select*, NameCo
2c270 6e 74 65 78 74 2a 29 3b 0a 76 6f 69 64 20 73 71 ntext*);.void sq
2c280 6c 69 74 65 33 53 65 6c 65 63 74 57 72 6f 6e 67 lite3SelectWrong
2c290 4e 75 6d 54 65 72 6d 73 45 72 72 6f 72 28 50 61 NumTermsError(Pa
2c2a0 72 73 65 20 2a 70 50 61 72 73 65 2c 20 53 65 6c rse *pParse, Sel
2c2b0 65 63 74 20 2a 70 29 3b 0a 69 6e 74 20 73 71 6c ect *p);.int sql
2c2c0 69 74 65 33 4d 61 74 63 68 53 70 61 6e 4e 61 6d ite3MatchSpanNam
2c2d0 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 e(const char*, c
2c2e0 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 onst char*, cons
2c2f0 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 t char*, const c
2c300 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 har*);.int sqlit
2c310 65 33 52 65 73 6f 6c 76 65 45 78 70 72 4e 61 6d e3ResolveExprNam
2c320 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 2c es(NameContext*,
2c330 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c Expr*);.int sql
2c340 69 74 65 33 52 65 73 6f 6c 76 65 45 78 70 72 4c ite3ResolveExprL
2c350 69 73 74 4e 61 6d 65 73 28 4e 61 6d 65 43 6f 6e istNames(NameCon
2c360 74 65 78 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a text*, ExprList*
2c370 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
2c380 65 73 6f 6c 76 65 53 65 6c 65 63 74 4e 61 6d 65 esolveSelectName
2c390 73 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 s(Parse*, Select
2c3a0 2a 2c 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 29 *, NameContext*)
2c3b0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 ;.void sqlite3Re
2c3c0 73 6f 6c 76 65 53 65 6c 66 52 65 66 65 72 65 6e solveSelfReferen
2c3d0 63 65 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a ce(Parse*,Table*
2c3e0 2c 69 6e 74 2c 45 78 70 72 2a 2c 45 78 70 72 4c ,int,Expr*,ExprL
2c3f0 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ist*);.int sqlit
2c400 65 33 52 65 73 6f 6c 76 65 4f 72 64 65 72 47 72 e3ResolveOrderGr
2c410 6f 75 70 42 79 28 50 61 72 73 65 2a 2c 20 53 65 oupBy(Parse*, Se
2c420 6c 65 63 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a lect*, ExprList*
2c430 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a , const char*);.
2c440 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6c 75 void sqlite3Colu
2c450 6d 6e 44 65 66 61 75 6c 74 28 56 64 62 65 20 2a mnDefault(Vdbe *
2c460 2c 20 54 61 62 6c 65 20 2a 2c 20 69 6e 74 2c 20 , Table *, int,
2c470 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
2c480 65 33 41 6c 74 65 72 46 69 6e 69 73 68 41 64 64 e3AlterFinishAdd
2c490 43 6f 6c 75 6d 6e 28 50 61 72 73 65 20 2a 2c 20 Column(Parse *,
2c4a0 54 6f 6b 65 6e 20 2a 29 3b 0a 76 6f 69 64 20 73 Token *);.void s
2c4b0 71 6c 69 74 65 33 41 6c 74 65 72 42 65 67 69 6e qlite3AlterBegin
2c4c0 41 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 20 AddColumn(Parse
2c4d0 2a 2c 20 53 72 63 4c 69 73 74 20 2a 29 3b 0a 43 *, SrcList *);.C
2c4e0 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 47 ollSeq *sqlite3G
2c4f0 65 74 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 2a etCollSeq(Parse*
2c500 2c 20 75 38 2c 20 43 6f 6c 6c 53 65 71 20 2a 2c , u8, CollSeq *,
2c510 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 63 const char*);.c
2c520 68 61 72 20 73 71 6c 69 74 65 33 41 66 66 69 6e har sqlite3Affin
2c530 69 74 79 54 79 70 65 28 63 6f 6e 73 74 20 63 68 ityType(const ch
2c540 61 72 2a 2c 20 43 6f 6c 75 6d 6e 2a 29 3b 0a 76 ar*, Column*);.v
2c550 6f 69 64 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 oid sqlite3Analy
2c560 7a 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e ze(Parse*, Token
2c570 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 *, Token*);.int
2c580 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75 73 sqlite3InvokeBus
2c590 79 48 61 6e 64 6c 65 72 28 42 75 73 79 48 61 6e yHandler(BusyHan
2c5a0 64 6c 65 72 2a 2c 20 73 71 6c 69 74 65 33 5f 66 dler*, sqlite3_f
2c5b0 69 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ile*);.int sqlit
2c5c0 65 33 46 69 6e 64 44 62 28 73 71 6c 69 74 65 33 e3FindDb(sqlite3
2c5d0 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 *, Token*);.int
2c5e0 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d sqlite3FindDbNam
2c5f0 65 28 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e e(sqlite3 *, con
2c600 73 74 20 63 68 61 72 20 2a 29 3b 0a 69 6e 74 20 st char *);.int
2c610 73 71 6c 69 74 65 33 41 6e 61 6c 79 73 69 73 4c sqlite3AnalysisL
2c620 6f 61 64 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 oad(sqlite3*,int
2c630 20 69 44 42 29 3b 0a 76 6f 69 64 20 73 71 6c 69 iDB);.void sqli
2c640 74 65 33 44 65 6c 65 74 65 49 6e 64 65 78 53 61 te3DeleteIndexSa
2c650 6d 70 6c 65 73 28 73 71 6c 69 74 65 33 2a 2c 49 mples(sqlite3*,I
2c660 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c ndex*);.void sql
2c670 69 74 65 33 44 65 66 61 75 6c 74 52 6f 77 45 73 ite3DefaultRowEs
2c680 74 28 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 t(Index*);.void
2c690 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 4c sqlite3RegisterL
2c6a0 69 6b 65 46 75 6e 63 74 69 6f 6e 73 28 73 71 6c ikeFunctions(sql
2c6b0 69 74 65 33 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 ite3*, int);.int
2c6c0 20 73 71 6c 69 74 65 33 49 73 4c 69 6b 65 46 75 sqlite3IsLikeFu
2c6d0 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a 2c nction(sqlite3*,
2c6e0 45 78 70 72 2a 2c 69 6e 74 2a 2c 63 68 61 72 2a Expr*,int*,char*
2c6f0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
2c700 63 68 65 6d 61 43 6c 65 61 72 28 76 6f 69 64 20 chemaClear(void
2c710 2a 29 3b 0a 53 63 68 65 6d 61 20 2a 73 71 6c 69 *);.Schema *sqli
2c720 74 65 33 53 63 68 65 6d 61 47 65 74 28 73 71 6c te3SchemaGet(sql
2c730 69 74 65 33 20 2a 2c 20 42 74 72 65 65 20 2a 29 ite3 *, Btree *)
2c740 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68 ;.int sqlite3Sch
2c750 65 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74 emaToIndex(sqlit
2c760 65 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a e3 *db, Schema *
2c770 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 );.KeyInfo *sqli
2c780 74 65 33 4b 65 79 49 6e 66 6f 41 6c 6c 6f 63 28 te3KeyInfoAlloc(
2c790 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 69 6e 74 sqlite3*,int,int
2c7a0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4b );.void sqlite3K
2c7b0 65 79 49 6e 66 6f 55 6e 72 65 66 28 4b 65 79 49 eyInfoUnref(KeyI
2c7c0 6e 66 6f 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a nfo*);.KeyInfo *
2c7d0 73 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 52 65 sqlite3KeyInfoRe
2c7e0 66 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b 65 79 f(KeyInfo*);.Key
2c7f0 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 Info *sqlite3Key
2c800 49 6e 66 6f 4f 66 49 6e 64 65 78 28 50 61 72 73 InfoOfIndex(Pars
2c810 65 2a 2c 20 49 6e 64 65 78 2a 29 3b 0a 23 69 66 e*, Index*);.#if
2c820 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
2c830 0a 69 6e 74 20 73 71 6c 69 74 65 33 4b 65 79 49 .int sqlite3KeyI
2c840 6e 66 6f 49 73 57 72 69 74 65 61 62 6c 65 28 4b nfoIsWriteable(K
2c850 65 79 49 6e 66 6f 2a 29 3b 0a 23 65 6e 64 69 66 eyInfo*);.#endif
2c860 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 72 65 61 .int sqlite3Crea
2c870 74 65 46 75 6e 63 28 73 71 6c 69 74 65 33 20 2a teFunc(sqlite3 *
2c880 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 , const char *,
2c890 69 6e 74 2c 20 69 6e 74 2c 20 76 6f 69 64 20 2a int, int, void *
2c8a0 2c 0a 20 20 76 6f 69 64 20 28 2a 29 28 73 71 6c ,. void (*)(sql
2c8b0 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
2c8c0 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
2c8d0 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 29 28 **),. void (*)(
2c8e0 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
2c8f0 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
2c900 75 65 20 2a 2a 29 2c 20 76 6f 69 64 20 28 2a 29 ue **), void (*)
2c910 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
2c920 2a 29 2c 0a 20 20 46 75 6e 63 44 65 73 74 72 75 *),. FuncDestru
2c930 63 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f ctor *pDestructo
2c940 72 0a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r.);.void sqlite
2c950 33 4f 6f 6d 46 61 75 6c 74 28 73 71 6c 69 74 65 3OomFault(sqlite
2c960 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 3*);.void sqlite
2c970 33 4f 6f 6d 43 6c 65 61 72 28 73 71 6c 69 74 65 3OomClear(sqlite
2c980 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 3*);.int sqlite3
2c990 41 70 69 45 78 69 74 28 73 71 6c 69 74 65 33 20 ApiExit(sqlite3
2c9a0 2a 64 62 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 *db, int);.int s
2c9b0 71 6c 69 74 65 33 4f 70 65 6e 54 65 6d 70 44 61 qlite3OpenTempDa
2c9c0 74 61 62 61 73 65 28 50 61 72 73 65 20 2a 29 3b tabase(Parse *);
2c9d0 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 ..void sqlite3St
2c9e0 72 41 63 63 75 6d 49 6e 69 74 28 53 74 72 41 63 rAccumInit(StrAc
2c9f0 63 75 6d 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 cum*, sqlite3*,
2ca00 63 68 61 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 char*, int, int)
2ca10 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 ;.void sqlite3St
2ca20 72 41 63 63 75 6d 41 70 70 65 6e 64 28 53 74 72 rAccumAppend(Str
2ca30 41 63 63 75 6d 2a 2c 63 6f 6e 73 74 20 63 68 61 Accum*,const cha
2ca40 72 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 r*,int);.void sq
2ca50 6c 69 74 65 33 53 74 72 41 63 63 75 6d 41 70 70 lite3StrAccumApp
2ca60 65 6e 64 41 6c 6c 28 53 74 72 41 63 63 75 6d 2a endAll(StrAccum*
2ca70 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 ,const char*);.v
2ca80 6f 69 64 20 73 71 6c 69 74 65 33 41 70 70 65 6e oid sqlite3Appen
2ca90 64 43 68 61 72 28 53 74 72 41 63 63 75 6d 2a 2c dChar(StrAccum*,
2caa0 69 6e 74 2c 63 68 61 72 29 3b 0a 63 68 61 72 20 int,char);.char
2cab0 2a 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d *sqlite3StrAccum
2cac0 46 69 6e 69 73 68 28 53 74 72 41 63 63 75 6d 2a Finish(StrAccum*
2cad0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
2cae0 74 72 41 63 63 75 6d 52 65 73 65 74 28 53 74 72 trAccumReset(Str
2caf0 41 63 63 75 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 Accum*);.void sq
2cb00 6c 69 74 65 33 53 65 6c 65 63 74 44 65 73 74 49 lite3SelectDestI
2cb10 6e 69 74 28 53 65 6c 65 63 74 44 65 73 74 2a 2c nit(SelectDest*,
2cb20 69 6e 74 2c 69 6e 74 29 3b 0a 45 78 70 72 20 2a int,int);.Expr *
2cb30 73 71 6c 69 74 65 33 43 72 65 61 74 65 43 6f 6c sqlite3CreateCol
2cb40 75 6d 6e 45 78 70 72 28 73 71 6c 69 74 65 33 20 umnExpr(sqlite3
2cb50 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 69 6e *, SrcList *, in
2cb60 74 2c 20 69 6e 74 29 3b 0a 0a 76 6f 69 64 20 73 t, int);..void s
2cb70 71 6c 69 74 65 33 42 61 63 6b 75 70 52 65 73 74 qlite3BackupRest
2cb80 61 72 74 28 73 71 6c 69 74 65 33 5f 62 61 63 6b art(sqlite3_back
2cb90 75 70 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 up *);.void sqli
2cba0 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 65 28 te3BackupUpdate(
2cbb0 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a sqlite3_backup *
2cbc0 2c 20 50 67 6e 6f 2c 20 63 6f 6e 73 74 20 75 38 , Pgno, const u8
2cbd0 20 2a 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 *);..#ifndef SQ
2cbe0 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55 45 LITE_OMIT_SUBQUE
2cbf0 52 59 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 RY.int sqlite3Ex
2cc00 70 72 43 68 65 63 6b 49 4e 28 50 61 72 73 65 2a prCheckIN(Parse*
2cc10 2c 20 45 78 70 72 2a 29 3b 0a 23 65 6c 73 65 0a , Expr*);.#else.
2cc20 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
2cc30 45 78 70 72 43 68 65 63 6b 49 4e 28 78 2c 79 29 ExprCheckIN(x,y)
2cc40 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 SQLITE_OK.#endi
2cc50 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
2cc60 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
2cc70 5f 53 54 41 54 34 0a 76 6f 69 64 20 73 71 6c 69 _STAT4.void sqli
2cc80 74 65 33 41 6e 61 6c 79 7a 65 46 75 6e 63 74 69 te3AnalyzeFuncti
2cc90 6f 6e 73 28 76 6f 69 64 29 3b 0a 69 6e 74 20 73 ons(void);.int s
2cca0 71 6c 69 74 65 33 53 74 61 74 34 50 72 6f 62 65 qlite3Stat4Probe
2ccb0 53 65 74 56 61 6c 75 65 28 0a 20 20 20 20 50 61 SetValue(. Pa
2ccc0 72 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 6e 70 61 rse*,Index*,Unpa
2ccd0 63 6b 65 64 52 65 63 6f 72 64 2a 2a 2c 45 78 70 ckedRecord**,Exp
2cce0 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2a 29 r*,int,int,int*)
2ccf0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 ;.int sqlite3Sta
2cd00 74 34 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 28 t4ValueFromExpr(
2cd10 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 75 Parse*, Expr*, u
2cd20 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 8, sqlite3_value
2cd30 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 **);.void sqlite
2cd40 33 53 74 61 74 34 50 72 6f 62 65 46 72 65 65 28 3Stat4ProbeFree(
2cd50 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 29 UnpackedRecord*)
2cd60 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 ;.int sqlite3Sta
2cd70 74 34 43 6f 6c 75 6d 6e 28 73 71 6c 69 74 65 33 t4Column(sqlite3
2cd80 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 *, const void*,
2cd90 69 6e 74 2c 20 69 6e 74 2c 20 73 71 6c 69 74 65 int, int, sqlite
2cda0 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 63 68 61 72 3_value**);.char
2cdb0 20 73 71 6c 69 74 65 33 49 6e 64 65 78 43 6f 6c sqlite3IndexCol
2cdc0 75 6d 6e 41 66 66 69 6e 69 74 79 28 73 71 6c 69 umnAffinity(sqli
2cdd0 74 65 33 2a 2c 20 49 6e 64 65 78 2a 2c 20 69 6e te3*, Index*, in
2cde0 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a t);.#endif../*.*
2cdf0 2a 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 * The interface
2ce00 74 6f 20 74 68 65 20 4c 45 4d 4f 4e 2d 67 65 6e to the LEMON-gen
2ce10 65 72 61 74 65 64 20 70 61 72 73 65 72 0a 2a 2f erated parser.*/
2ce20 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2ce30 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a 20 20 76 AMALGAMATION. v
2ce40 6f 69 64 20 2a 73 71 6c 69 74 65 33 50 61 72 73 oid *sqlite3Pars
2ce50 65 72 41 6c 6c 6f 63 28 76 6f 69 64 2a 28 2a 29 erAlloc(void*(*)
2ce60 28 75 36 34 29 2c 20 50 61 72 73 65 2a 29 3b 0a (u64), Parse*);.
2ce70 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 void sqlite3Pa
2ce80 72 73 65 72 46 72 65 65 28 76 6f 69 64 2a 2c 20 rserFree(void*,
2ce90 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b void(*)(void*));
2cea0 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c .#endif.void sql
2ceb0 69 74 65 33 50 61 72 73 65 72 28 76 6f 69 64 2a ite3Parser(void*
2cec0 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 29 3b 0a 23 , int, Token);.#
2ced0 69 66 64 65 66 20 59 59 54 52 41 43 4b 4d 41 58 ifdef YYTRACKMAX
2cee0 53 54 41 43 4b 44 45 50 54 48 0a 20 20 69 6e 74 STACKDEPTH. int
2cef0 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 53 74 sqlite3ParserSt
2cf00 61 63 6b 50 65 61 6b 28 76 6f 69 64 2a 29 3b 0a ackPeak(void*);.
2cf10 23 65 6e 64 69 66 0a 0a 76 6f 69 64 20 73 71 6c #endif..void sql
2cf20 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 ite3AutoLoadExte
2cf30 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 nsions(sqlite3*)
2cf40 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
2cf50 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e _OMIT_LOAD_EXTEN
2cf60 53 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c 69 SION. void sqli
2cf70 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 6f te3CloseExtensio
2cf80 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 ns(sqlite3*);.#e
2cf90 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
2cfa0 69 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 ite3CloseExtensi
2cfb0 6f 6e 73 28 58 29 0a 23 65 6e 64 69 66 0a 0a 23 ons(X).#endif..#
2cfc0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
2cfd0 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
2cfe0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 61 void sqlite3Ta
2cff0 62 6c 65 4c 6f 63 6b 28 50 61 72 73 65 20 2a 2c bleLock(Parse *,
2d000 20 69 6e 74 2c 20 69 6e 74 2c 20 75 38 2c 20 63 int, int, u8, c
2d010 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 23 65 onst char *);.#e
2d020 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 lse. #define sq
2d030 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 76 lite3TableLock(v
2d040 2c 77 2c 78 2c 79 2c 7a 29 0a 23 65 6e 64 69 66 ,w,x,y,z).#endif
2d050 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
2d060 54 45 53 54 0a 20 20 69 6e 74 20 73 71 6c 69 74 TEST. int sqlit
2d070 65 33 55 74 66 38 54 6f 38 28 75 6e 73 69 67 6e e3Utf8To8(unsign
2d080 65 64 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 ed char*);.#endi
2d090 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
2d0a0 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
2d0b0 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c LE.# define sql
2d0c0 69 74 65 33 56 74 61 62 43 6c 65 61 72 28 59 29 ite3VtabClear(Y)
2d0d0 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 .# define sqlit
2d0e0 65 33 56 74 61 62 53 79 6e 63 28 58 2c 59 29 20 e3VtabSync(X,Y)
2d0f0 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 64 65 66 SQLITE_OK.# def
2d100 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 52 ine sqlite3VtabR
2d110 6f 6c 6c 62 61 63 6b 28 58 29 0a 23 20 20 64 65 ollback(X).# de
2d120 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
2d130 43 6f 6d 6d 69 74 28 58 29 0a 23 20 20 64 65 66 Commit(X).# def
2d140 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 49 ine sqlite3VtabI
2d150 6e 53 79 6e 63 28 64 62 29 20 30 0a 23 20 20 64 nSync(db) 0.# d
2d160 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 efine sqlite3Vta
2d170 62 4c 6f 63 6b 28 58 29 0a 23 20 20 64 65 66 69 bLock(X).# defi
2d180 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e ne sqlite3VtabUn
2d190 6c 6f 63 6b 28 58 29 0a 23 20 20 64 65 66 69 6e lock(X).# defin
2d1a0 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c e sqlite3VtabUnl
2d1b0 6f 63 6b 4c 69 73 74 28 58 29 0a 23 20 20 64 65 ockList(X).# de
2d1c0 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
2d1d0 53 61 76 65 70 6f 69 6e 74 28 58 2c 20 59 2c 20 Savepoint(X, Y,
2d1e0 5a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 Z) SQLITE_OK.#
2d1f0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 65 define sqlite3Ge
2d200 74 56 54 61 62 6c 65 28 58 2c 59 29 20 20 28 28 tVTable(X,Y) ((
2d210 56 54 61 62 6c 65 2a 29 30 29 0a 23 65 6c 73 65 VTable*)0).#else
2d220 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 . void sqlite3
2d230 56 74 61 62 43 6c 65 61 72 28 73 71 6c 69 74 65 VtabClear(sqlite
2d240 33 20 2a 64 62 2c 20 54 61 62 6c 65 2a 29 3b 0a 3 *db, Table*);.
2d250 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 void sqlite3V
2d260 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 73 71 tabDisconnect(sq
2d270 6c 69 74 65 33 20 2a 64 62 2c 20 54 61 62 6c 65 lite3 *db, Table
2d280 20 2a 70 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c *p);. int sql
2d290 69 74 65 33 56 74 61 62 53 79 6e 63 28 73 71 6c ite3VtabSync(sql
2d2a0 69 74 65 33 20 2a 64 62 2c 20 56 64 62 65 2a 29 ite3 *db, Vdbe*)
2d2b0 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 33 ;. int sqlite3
2d2c0 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 73 71 6c VtabRollback(sql
2d2d0 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 20 69 6e ite3 *db);. in
2d2e0 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 6f 6d t sqlite3VtabCom
2d2f0 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 mit(sqlite3 *db)
2d300 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ;. void sqlite
2d310 33 56 74 61 62 4c 6f 63 6b 28 56 54 61 62 6c 65 3VtabLock(VTable
2d320 20 2a 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c *);. void sql
2d330 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 56 ite3VtabUnlock(V
2d340 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 76 6f 69 Table *);. voi
2d350 64 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c d sqlite3VtabUnl
2d360 6f 63 6b 4c 69 73 74 28 73 71 6c 69 74 65 33 2a ockList(sqlite3*
2d370 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 );. int sqlite
2d380 33 56 74 61 62 53 61 76 65 70 6f 69 6e 74 28 73 3VtabSavepoint(s
2d390 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 2c 20 69 qlite3 *, int, i
2d3a0 6e 74 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c nt);. void sql
2d3b0 69 74 65 33 56 74 61 62 49 6d 70 6f 72 74 45 72 ite3VtabImportEr
2d3c0 72 6d 73 67 28 56 64 62 65 2a 2c 20 73 71 6c 69 rmsg(Vdbe*, sqli
2d3d0 74 65 33 5f 76 74 61 62 2a 29 3b 0a 20 20 20 56 te3_vtab*);. V
2d3e0 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 47 65 Table *sqlite3Ge
2d3f0 74 56 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a tVTable(sqlite3*
2d400 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 20 4d 6f , Table*);. Mo
2d410 64 75 6c 65 20 2a 73 71 6c 69 74 65 33 56 74 61 dule *sqlite3Vta
2d420 62 43 72 65 61 74 65 4d 6f 64 75 6c 65 28 0a 20 bCreateModule(.
2d430 20 20 20 20 73 71 6c 69 74 65 33 2a 2c 0a 20 20 sqlite3*,.
2d440 20 20 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 0a const char*,.
2d450 20 20 20 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 const sqlit
2d460 65 33 5f 6d 6f 64 75 6c 65 2a 2c 0a 20 20 20 20 e3_module*,.
2d470 20 76 6f 69 64 2a 2c 0a 20 20 20 20 20 76 6f 69 void*,. voi
2d480 64 28 2a 29 28 76 6f 69 64 2a 29 0a 20 20 20 29 d(*)(void*). )
2d490 3b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 ;.# define sqli
2d4a0 74 65 33 56 74 61 62 49 6e 53 79 6e 63 28 64 62 te3VtabInSync(db
2d4b0 29 20 28 28 64 62 29 2d 3e 6e 56 54 72 61 6e 73 ) ((db)->nVTrans
2d4c0 3e 30 20 26 26 20 28 64 62 29 2d 3e 61 56 54 72 >0 && (db)->aVTr
2d4d0 61 6e 73 3d 3d 30 29 0a 23 65 6e 64 69 66 0a 69 ans==0).#endif.i
2d4e0 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 45 70 nt sqlite3VtabEp
2d4f0 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 49 6e 69 74 onymousTableInit
2d500 28 50 61 72 73 65 2a 2c 4d 6f 64 75 6c 65 2a 29 (Parse*,Module*)
2d510 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 ;.void sqlite3Vt
2d520 61 62 45 70 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 abEponymousTable
2d530 43 6c 65 61 72 28 73 71 6c 69 74 65 33 2a 2c 4d Clear(sqlite3*,M
2d540 6f 64 75 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 odule*);.void sq
2d550 6c 69 74 65 33 56 74 61 62 4d 61 6b 65 57 72 69 lite3VtabMakeWri
2d560 74 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 61 62 table(Parse*,Tab
2d570 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 le*);.void sqlit
2d580 65 33 56 74 61 62 42 65 67 69 6e 50 61 72 73 65 e3VtabBeginParse
2d590 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c (Parse*, Token*,
2d5a0 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c Token*, Token*,
2d5b0 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
2d5c0 74 65 33 56 74 61 62 46 69 6e 69 73 68 50 61 72 te3VtabFinishPar
2d5d0 73 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e se(Parse*, Token
2d5e0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2d5f0 56 74 61 62 41 72 67 49 6e 69 74 28 50 61 72 73 VtabArgInit(Pars
2d600 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
2d610 33 56 74 61 62 41 72 67 45 78 74 65 6e 64 28 50 3VtabArgExtend(P
2d620 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a arse*, Token*);.
2d630 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 int sqlite3VtabC
2d640 61 6c 6c 43 72 65 61 74 65 28 73 71 6c 69 74 65 allCreate(sqlite
2d650 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 3*, int, const c
2d660 68 61 72 20 2a 2c 20 63 68 61 72 20 2a 2a 29 3b har *, char **);
2d670 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 .int sqlite3Vtab
2d680 43 61 6c 6c 43 6f 6e 6e 65 63 74 28 50 61 72 73 CallConnect(Pars
2d690 65 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 69 6e 74 e*, Table*);.int
2d6a0 20 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c sqlite3VtabCall
2d6b0 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 2a Destroy(sqlite3*
2d6c0 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 , int, const cha
2d6d0 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 r *);.int sqlite
2d6e0 33 56 74 61 62 42 65 67 69 6e 28 73 71 6c 69 74 3VtabBegin(sqlit
2d6f0 65 33 20 2a 2c 20 56 54 61 62 6c 65 20 2a 29 3b e3 *, VTable *);
2d700 0a 46 75 6e 63 44 65 66 20 2a 73 71 6c 69 74 65 .FuncDef *sqlite
2d710 33 56 74 61 62 4f 76 65 72 6c 6f 61 64 46 75 6e 3VtabOverloadFun
2d720 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 20 2a 2c ction(sqlite3 *,
2d730 46 75 6e 63 44 65 66 2a 2c 20 69 6e 74 20 6e 41 FuncDef*, int nA
2d740 72 67 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 rg, Expr*);.void
2d750 20 73 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 sqlite3InvalidF
2d760 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 5f unction(sqlite3_
2d770 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c context*,int,sql
2d780 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 73 ite3_value**);.s
2d790 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c qlite3_int64 sql
2d7a0 69 74 65 33 53 74 6d 74 43 75 72 72 65 6e 74 54 ite3StmtCurrentT
2d7b0 69 6d 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 ime(sqlite3_cont
2d7c0 65 78 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ext*);.int sqlit
2d7d0 65 33 56 64 62 65 50 61 72 61 6d 65 74 65 72 49 e3VdbeParameterI
2d7e0 6e 64 65 78 28 56 64 62 65 2a 2c 20 63 6f 6e 73 ndex(Vdbe*, cons
2d7f0 74 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a 69 t char*, int);.i
2d800 6e 74 20 73 71 6c 69 74 65 33 54 72 61 6e 73 66 nt sqlite3Transf
2d810 65 72 42 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 erBindings(sqlit
2d820 65 33 5f 73 74 6d 74 20 2a 2c 20 73 71 6c 69 74 e3_stmt *, sqlit
2d830 65 33 5f 73 74 6d 74 20 2a 29 3b 0a 76 6f 69 64 e3_stmt *);.void
2d840 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65 sqlite3ParserRe
2d850 73 65 74 28 50 61 72 73 65 2a 29 3b 0a 69 6e 74 set(Parse*);.int
2d860 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 sqlite3Reprepar
2d870 65 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 e(Vdbe*);.void s
2d880 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 68 qlite3ExprListCh
2d890 65 63 6b 4c 65 6e 67 74 68 28 50 61 72 73 65 2a eckLength(Parse*
2d8a0 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f 6e , ExprList*, con
2d8b0 73 74 20 63 68 61 72 2a 29 3b 0a 43 6f 6c 6c 53 st char*);.CollS
2d8c0 65 71 20 2a 73 71 6c 69 74 65 33 42 69 6e 61 72 eq *sqlite3Binar
2d8d0 79 43 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 28 yCompareCollSeq(
2d8e0 50 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c Parse *, Expr *,
2d8f0 20 45 78 70 72 20 2a 29 3b 0a 69 6e 74 20 73 71 Expr *);.int sq
2d900 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 lite3TempInMemor
2d910 79 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 2a y(const sqlite3*
2d920 29 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 );.const char *s
2d930 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4d 6f 64 qlite3JournalMod
2d940 65 6e 61 6d 65 28 69 6e 74 29 3b 0a 23 69 66 6e ename(int);.#ifn
2d950 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2d960 57 41 4c 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 WAL. int sqlite
2d970 33 43 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 3Checkpoint(sqli
2d980 74 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 te3*, int, int,
2d990 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 20 20 69 int*, int*);. i
2d9a0 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 44 65 66 nt sqlite3WalDef
2d9b0 61 75 6c 74 48 6f 6f 6b 28 76 6f 69 64 2a 2c 73 aultHook(void*,s
2d9c0 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
2d9d0 61 72 2a 2c 69 6e 74 29 3b 0a 23 65 6e 64 69 66 ar*,int);.#endif
2d9e0 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2d9f0 4f 4d 49 54 5f 43 54 45 0a 20 20 57 69 74 68 20 OMIT_CTE. With
2da00 2a 73 71 6c 69 74 65 33 57 69 74 68 41 64 64 28 *sqlite3WithAdd(
2da10 50 61 72 73 65 2a 2c 57 69 74 68 2a 2c 54 6f 6b Parse*,With*,Tok
2da20 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 65 en*,ExprList*,Se
2da30 6c 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 73 lect*);. void s
2da40 71 6c 69 74 65 33 57 69 74 68 44 65 6c 65 74 65 qlite3WithDelete
2da50 28 73 71 6c 69 74 65 33 2a 2c 57 69 74 68 2a 29 (sqlite3*,With*)
2da60 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
2da70 57 69 74 68 50 75 73 68 28 50 61 72 73 65 2a 2c WithPush(Parse*,
2da80 20 57 69 74 68 2a 2c 20 75 38 29 3b 0a 23 65 6c With*, u8);.#el
2da90 73 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 se.#define sqlit
2daa0 65 33 57 69 74 68 50 75 73 68 28 78 2c 79 2c 7a e3WithPush(x,y,z
2dab0 29 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 ).#define sqlite
2dac0 33 57 69 74 68 44 65 6c 65 74 65 28 78 2c 79 29 3WithDelete(x,y)
2dad0 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
2dae0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 50 53 45 SQLITE_OMIT_UPSE
2daf0 52 54 0a 20 20 55 70 73 65 72 74 20 2a 73 71 6c RT. Upsert *sql
2db00 69 74 65 33 55 70 73 65 72 74 4e 65 77 28 73 71 ite3UpsertNew(sq
2db10 6c 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a lite3*,ExprList*
2db20 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a ,Expr*,ExprList*
2db30 2c 45 78 70 72 2a 29 3b 0a 20 20 76 6f 69 64 20 ,Expr*);. void
2db40 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 65 6c sqlite3UpsertDel
2db50 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 55 70 73 ete(sqlite3*,Ups
2db60 65 72 74 2a 29 3b 0a 20 20 55 70 73 65 72 74 20 ert*);. Upsert
2db70 2a 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 75 *sqlite3UpsertDu
2db80 70 28 73 71 6c 69 74 65 33 2a 2c 55 70 73 65 72 p(sqlite3*,Upser
2db90 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 t*);. int sqlit
2dba0 65 33 55 70 73 65 72 74 41 6e 61 6c 79 7a 65 54 e3UpsertAnalyzeT
2dbb0 61 72 67 65 74 28 50 61 72 73 65 2a 2c 53 72 63 arget(Parse*,Src
2dbc0 4c 69 73 74 2a 2c 55 70 73 65 72 74 2a 29 3b 0a List*,Upsert*);.
2dbd0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 55 70 void sqlite3Up
2dbe0 73 65 72 74 44 6f 55 70 64 61 74 65 28 50 61 72 sertDoUpdate(Par
2dbf0 73 65 2a 2c 55 70 73 65 72 74 2a 2c 54 61 62 6c se*,Upsert*,Tabl
2dc00 65 2a 2c 49 6e 64 65 78 2a 2c 69 6e 74 29 3b 0a e*,Index*,int);.
2dc10 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 73 71 #else.#define sq
2dc20 6c 69 74 65 33 55 70 73 65 72 74 4e 65 77 28 76 lite3UpsertNew(v
2dc30 2c 77 2c 78 2c 79 2c 7a 29 20 28 28 55 70 73 65 ,w,x,y,z) ((Upse
2dc40 72 74 2a 29 30 29 0a 23 64 65 66 69 6e 65 20 73 rt*)0).#define s
2dc50 71 6c 69 74 65 33 55 70 73 65 72 74 44 65 6c 65 qlite3UpsertDele
2dc60 74 65 28 78 2c 79 29 0a 23 64 65 66 69 6e 65 20 te(x,y).#define
2dc70 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 75 70 sqlite3UpsertDup
2dc80 28 78 2c 79 29 20 20 20 20 20 20 20 28 28 55 70 (x,y) ((Up
2dc90 73 65 72 74 2a 29 30 29 0a 23 65 6e 64 69 66 0a sert*)0).#endif.
2dca0 0a 0a 2f 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e ../* Declaration
2dcb0 73 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 s for functions
2dcc0 69 6e 20 66 6b 65 79 2e 63 2e 20 41 6c 6c 20 6f in fkey.c. All o
2dcd0 66 20 74 68 65 73 65 20 61 72 65 20 72 65 70 6c f these are repl
2dce0 61 63 65 64 20 62 79 0a 2a 2a 20 6e 6f 2d 6f 70 aced by.** no-op
2dcf0 20 6d 61 63 72 6f 73 20 69 66 20 4f 4d 49 54 5f macros if OMIT_
2dd00 46 4f 52 45 49 47 4e 5f 4b 45 59 20 69 73 20 64 FOREIGN_KEY is d
2dd10 65 66 69 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 efined. In this
2dd20 63 61 73 65 20 6e 6f 20 66 6f 72 65 69 67 6e 0a case no foreign.
2dd30 2a 2a 20 6b 65 79 20 66 75 6e 63 74 69 6f 6e 61 ** key functiona
2dd40 6c 69 74 79 20 69 73 20 61 76 61 69 6c 61 62 6c lity is availabl
2dd50 65 2e 20 49 66 20 4f 4d 49 54 5f 54 52 49 47 47 e. If OMIT_TRIGG
2dd60 45 52 20 69 73 20 64 65 66 69 6e 65 64 20 62 75 ER is defined bu
2dd70 74 0a 2a 2a 20 4f 4d 49 54 5f 46 4f 52 45 49 47 t.** OMIT_FOREIG
2dd80 4e 5f 4b 45 59 20 69 73 20 6e 6f 74 2c 20 6f 6e N_KEY is not, on
2dd90 6c 79 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 66 ly some of the f
2dda0 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f 2d unctions are no-
2ddb0 6f 70 65 64 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 oped. In.** this
2ddc0 20 63 61 73 65 20 66 6f 72 65 69 67 6e 20 6b 65 case foreign ke
2ddd0 79 73 20 61 72 65 20 70 61 72 73 65 64 2c 20 62 ys are parsed, b
2dde0 75 74 20 6e 6f 20 6f 74 68 65 72 20 66 75 6e 63 ut no other func
2ddf0 74 69 6f 6e 61 6c 69 74 79 20 69 73 0a 2a 2a 20 tionality is.**
2de00 70 72 6f 76 69 64 65 64 20 28 65 6e 66 6f 72 63 provided (enforc
2de10 65 6d 65 6e 74 20 6f 66 20 46 4b 20 63 6f 6e 73 ement of FK cons
2de20 74 72 61 69 6e 74 73 20 72 65 71 75 69 72 65 73 traints requires
2de30 20 74 68 65 20 74 72 69 67 67 65 72 73 20 73 75 the triggers su
2de40 62 2d 73 79 73 74 65 6d 29 2e 0a 2a 2f 0a 23 69 b-system)..*/.#i
2de50 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
2de60 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b E_OMIT_FOREIGN_K
2de70 45 59 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 EY) && !defined(
2de80 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 SQLITE_OMIT_TRIG
2de90 47 45 52 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 GER). void sqli
2dea0 74 65 33 46 6b 43 68 65 63 6b 28 50 61 72 73 65 te3FkCheck(Parse
2deb0 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 *, Table*, int,
2dec0 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b int, int*, int);
2ded0 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 46 . void sqlite3F
2dee0 6b 44 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 kDropTable(Parse
2def0 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 54 61 *, SrcList *, Ta
2df00 62 6c 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 ble*);. void sq
2df10 6c 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 50 lite3FkActions(P
2df20 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 arse*, Table*, E
2df30 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 xprList*, int, i
2df40 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 69 6e 74 nt*, int);. int
2df50 20 73 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72 sqlite3FkRequir
2df60 65 64 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 ed(Parse*, Table
2df70 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 *, int*, int);.
2df80 20 75 33 32 20 73 71 6c 69 74 65 33 46 6b 4f 6c u32 sqlite3FkOl
2df90 64 6d 61 73 6b 28 50 61 72 73 65 2a 2c 20 54 61 dmask(Parse*, Ta
2dfa0 62 6c 65 2a 29 3b 0a 20 20 46 4b 65 79 20 2a 73 ble*);. FKey *s
2dfb0 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 qlite3FkReferenc
2dfc0 65 73 28 54 61 62 6c 65 20 2a 29 3b 0a 23 65 6c es(Table *);.#el
2dfd0 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c se. #define sql
2dfe0 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 61 2c ite3FkActions(a,
2dff0 62 2c 63 2c 64 2c 65 2c 66 29 0a 20 20 23 64 65 b,c,d,e,f). #de
2e000 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 43 68 fine sqlite3FkCh
2e010 65 63 6b 28 61 2c 62 2c 63 2c 64 2c 65 2c 66 29 eck(a,b,c,d,e,f)
2e020 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
2e030 65 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 61 2c e3FkDropTable(a,
2e040 62 2c 63 29 0a 20 20 23 64 65 66 69 6e 65 20 73 b,c). #define s
2e050 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 61 73 6b 28 qlite3FkOldmask(
2e060 61 2c 62 29 20 20 20 20 20 20 20 20 20 30 0a 20 a,b) 0.
2e070 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
2e080 46 6b 52 65 71 75 69 72 65 64 28 61 2c 62 2c 63 FkRequired(a,b,c
2e090 2c 64 29 20 20 20 20 30 0a 20 20 23 64 65 66 69 ,d) 0. #defi
2e0a0 6e 65 20 73 71 6c 69 74 65 33 46 6b 52 65 66 65 ne sqlite3FkRefe
2e0b0 72 65 6e 63 65 73 28 61 29 20 20 20 20 20 20 20 rences(a)
2e0c0 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 0.#endif.#ifnde
2e0d0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f f SQLITE_OMIT_FO
2e0e0 52 45 49 47 4e 5f 4b 45 59 0a 20 20 76 6f 69 64 REIGN_KEY. void
2e0f0 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 sqlite3FkDelete
2e100 28 73 71 6c 69 74 65 33 20 2a 2c 20 54 61 62 6c (sqlite3 *, Tabl
2e110 65 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 e*);. int sqlit
2e120 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 e3FkLocateIndex(
2e130 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 46 4b Parse*,Table*,FK
2e140 65 79 2a 2c 49 6e 64 65 78 2a 2a 2c 69 6e 74 2a ey*,Index**,int*
2e150 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 *);.#else. #def
2e160 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 44 65 6c ine sqlite3FkDel
2e170 65 74 65 28 61 2c 62 29 0a 20 20 23 64 65 66 69 ete(a,b). #defi
2e180 6e 65 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 ne sqlite3FkLoca
2e190 74 65 49 6e 64 65 78 28 61 2c 62 2c 63 2c 64 2c teIndex(a,b,c,d,
2e1a0 65 29 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a e).#endif.../*.*
2e1b0 2a 20 41 76 61 69 6c 61 62 6c 65 20 66 61 75 6c * Available faul
2e1c0 74 20 69 6e 6a 65 63 74 6f 72 73 2e 20 20 53 68 t injectors. Sh
2e1d0 6f 75 6c 64 20 62 65 20 6e 75 6d 62 65 72 65 64 ould be numbered
2e1e0 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 beginning with
2e1f0 30 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 0..*/.#define SQ
2e200 4c 49 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 LITE_FAULTINJECT
2e210 4f 52 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 30 0a OR_MALLOC 0.
2e220 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
2e230 41 55 4c 54 49 4e 4a 45 43 54 4f 52 5f 43 4f 55 AULTINJECTOR_COU
2e240 4e 54 20 20 20 20 20 20 31 0a 0a 2f 2a 0a 2a 2a NT 1../*.**
2e250 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 The interface t
2e260 6f 20 74 68 65 20 63 6f 64 65 20 69 6e 20 66 61 o the code in fa
2e270 75 6c 74 2e 63 20 75 73 65 64 20 66 6f 72 20 69 ult.c used for i
2e280 64 65 6e 74 69 66 79 69 6e 67 20 22 62 65 6e 69 dentifying "beni
2e290 67 6e 22 0a 2a 2a 20 6d 61 6c 6c 6f 63 20 66 61 gn".** malloc fa
2e2a0 69 6c 75 72 65 73 2e 20 54 68 69 73 20 69 73 20 ilures. This is
2e2b0 6f 6e 6c 79 20 70 72 65 73 65 6e 74 20 69 66 20 only present if
2e2c0 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
2e2d0 45 0a 2a 2a 20 69 73 20 6e 6f 74 20 64 65 66 69 E.** is not defi
2e2e0 6e 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ned..*/.#ifndef
2e2f0 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
2e300 45 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 E. void sqlite3
2e310 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f BeginBenignMallo
2e320 63 28 76 6f 69 64 29 3b 0a 20 20 76 6f 69 64 20 c(void);. void
2e330 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e sqlite3EndBenign
2e340 4d 61 6c 6c 6f 63 28 76 6f 69 64 29 3b 0a 23 65 Malloc(void);.#e
2e350 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 lse. #define sq
2e360 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
2e370 4d 61 6c 6c 6f 63 28 29 0a 20 20 23 64 65 66 69 Malloc(). #defi
2e380 6e 65 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e ne sqlite3EndBen
2e390 69 67 6e 4d 61 6c 6c 6f 63 28 29 0a 23 65 6e 64 ignMalloc().#end
2e3a0 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 if../*.** Allowe
2e3b0 64 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 20 d return values
2e3c0 66 72 6f 6d 20 73 71 6c 69 74 65 33 46 69 6e 64 from sqlite3Find
2e3d0 49 6e 49 6e 64 65 78 28 29 0a 2a 2f 0a 23 64 65 InIndex().*/.#de
2e3e0 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 52 4f fine IN_INDEX_RO
2e3f0 57 49 44 20 20 20 20 20 20 20 20 31 20 20 20 2f WID 1 /
2e400 2a 20 53 65 61 72 63 68 20 74 68 65 20 72 6f 77 * Search the row
2e410 69 64 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 id of the table
2e420 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e */.#define IN_IN
2e430 44 45 58 5f 45 50 48 20 20 20 20 20 20 20 20 20 DEX_EPH
2e440 20 32 20 20 20 2f 2a 20 53 65 61 72 63 68 20 61 2 /* Search a
2e450 6e 20 65 70 68 65 6d 65 72 61 6c 20 62 2d 74 72 n ephemeral b-tr
2e460 65 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e ee */.#define IN
2e470 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 41 53 43 _INDEX_INDEX_ASC
2e480 20 20 20 20 33 20 20 20 2f 2a 20 45 78 69 73 74 3 /* Exist
2e490 69 6e 67 20 69 6e 64 65 78 20 41 53 43 45 4e 44 ing index ASCEND
2e4a0 49 4e 47 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 ING */.#define I
2e4b0 4e 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 44 45 N_INDEX_INDEX_DE
2e4c0 53 43 20 20 20 34 20 20 20 2f 2a 20 45 78 69 73 SC 4 /* Exis
2e4d0 74 69 6e 67 20 69 6e 64 65 78 20 44 45 53 43 45 ting index DESCE
2e4e0 4e 44 49 4e 47 20 2a 2f 0a 23 64 65 66 69 6e 65 NDING */.#define
2e4f0 20 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 20 20 IN_INDEX_NOOP
2e500 20 20 20 20 20 20 20 35 20 20 20 2f 2a 20 4e 6f 5 /* No
2e510 20 74 61 62 6c 65 20 61 76 61 69 6c 61 62 6c 65 table available
2e520 2e 20 55 73 65 20 63 6f 6d 70 61 72 69 73 6f 6e . Use comparison
2e530 73 20 2a 2f 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 s */./*.** Allow
2e540 65 64 20 66 6c 61 67 73 20 66 6f 72 20 74 68 65 ed flags for the
2e550 20 33 72 64 20 70 61 72 61 6d 65 74 65 72 20 74 3rd parameter t
2e560 6f 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 49 o sqlite3FindInI
2e570 6e 64 65 78 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 ndex()..*/.#defi
2e580 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 ne IN_INDEX_NOOP
2e590 5f 4f 4b 20 20 20 20 20 30 78 30 30 30 31 20 20 _OK 0x0001
2e5a0 2f 2a 20 4f 4b 20 74 6f 20 72 65 74 75 72 6e 20 /* OK to return
2e5b0 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 20 2a 2f IN_INDEX_NOOP */
2e5c0 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 .#define IN_INDE
2e5d0 58 5f 4d 45 4d 42 45 52 53 48 49 50 20 20 30 78 X_MEMBERSHIP 0x
2e5e0 30 30 30 32 20 20 2f 2a 20 49 4e 20 6f 70 65 72 0002 /* IN oper
2e5f0 61 74 6f 72 20 75 73 65 64 20 66 6f 72 20 6d 65 ator used for me
2e600 6d 62 65 72 73 68 69 70 20 74 65 73 74 20 2a 2f mbership test */
2e610 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 .#define IN_INDE
2e620 58 5f 4c 4f 4f 50 20 20 20 20 20 20 20 20 30 78 X_LOOP 0x
2e630 30 30 30 34 20 20 2f 2a 20 49 4e 20 6f 70 65 72 0004 /* IN oper
2e640 61 74 6f 72 20 75 73 65 64 20 61 73 20 61 20 6c ator used as a l
2e650 6f 6f 70 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 oop */.int sqlit
2e660 65 33 46 69 6e 64 49 6e 49 6e 64 65 78 28 50 61 e3FindInIndex(Pa
2e670 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c 20 75 rse *, Expr *, u
2e680 33 32 2c 20 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 32, int*, int*);
2e690 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 ..int sqlite3Jou
2e6a0 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 rnalOpen(sqlite3
2e6b0 5f 76 66 73 20 2a 2c 20 63 6f 6e 73 74 20 63 68 _vfs *, const ch
2e6c0 61 72 20 2a 2c 20 73 71 6c 69 74 65 33 5f 66 69 ar *, sqlite3_fi
2e6d0 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b le *, int, int);
2e6e0 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 .int sqlite3Jour
2e6f0 6e 61 6c 53 69 7a 65 28 73 71 6c 69 74 65 33 5f nalSize(sqlite3_
2e700 76 66 73 20 2a 29 3b 0a 23 69 66 20 64 65 66 69 vfs *);.#if defi
2e710 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
2e720 45 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 29 20 E_ATOMIC_WRITE)
2e730 5c 0a 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 \. || defined(SQ
2e740 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41 54 43 LITE_ENABLE_BATC
2e750 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 29 0a H_ATOMIC_WRITE).
2e760 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 int sqlite3Jou
2e770 72 6e 61 6c 43 72 65 61 74 65 28 73 71 6c 69 74 rnalCreate(sqlit
2e780 65 33 5f 66 69 6c 65 20 2a 29 3b 0a 23 65 6e 64 e3_file *);.#end
2e790 69 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a if..int sqlite3J
2e7a0 6f 75 72 6e 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 ournalIsInMemory
2e7b0 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 (sqlite3_file *p
2e7c0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d );.void sqlite3M
2e7d0 65 6d 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 73 71 emJournalOpen(sq
2e7e0 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 3b 0a 0a lite3_file *);..
2e7f0 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
2e800 53 65 74 48 65 69 67 68 74 41 6e 64 46 6c 61 67 SetHeightAndFlag
2e810 73 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c s(Parse *pParse,
2e820 20 45 78 70 72 20 2a 70 29 3b 0a 23 69 66 20 53 Expr *p);.#if S
2e830 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 QLITE_MAX_EXPR_D
2e840 45 50 54 48 3e 30 0a 20 20 69 6e 74 20 73 71 6c EPTH>0. int sql
2e850 69 74 65 33 53 65 6c 65 63 74 45 78 70 72 48 65 ite3SelectExprHe
2e860 69 67 68 74 28 53 65 6c 65 63 74 20 2a 29 3b 0a ight(Select *);.
2e870 20 20 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 int sqlite3Exp
2e880 72 43 68 65 63 6b 48 65 69 67 68 74 28 50 61 72 rCheckHeight(Par
2e890 73 65 2a 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 se*, int);.#else
2e8a0 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
2e8b0 65 33 53 65 6c 65 63 74 45 78 70 72 48 65 69 67 e3SelectExprHeig
2e8c0 68 74 28 78 29 20 30 0a 20 20 23 64 65 66 69 6e ht(x) 0. #defin
2e8d0 65 20 73 71 6c 69 74 65 33 45 78 70 72 43 68 65 e sqlite3ExprChe
2e8e0 63 6b 48 65 69 67 68 74 28 78 2c 79 29 0a 23 65 ckHeight(x,y).#e
2e8f0 6e 64 69 66 0a 0a 75 33 32 20 73 71 6c 69 74 65 ndif..u32 sqlite
2e900 33 47 65 74 34 62 79 74 65 28 63 6f 6e 73 74 20 3Get4byte(const
2e910 75 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u8*);.void sqlit
2e920 65 33 50 75 74 34 62 79 74 65 28 75 38 2a 2c 20 e3Put4byte(u8*,
2e930 75 33 32 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 u32);..#ifdef SQ
2e940 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 4e 4c 4f LITE_ENABLE_UNLO
2e950 43 4b 5f 4e 4f 54 49 46 59 0a 20 20 76 6f 69 64 CK_NOTIFY. void
2e960 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
2e970 6f 6e 42 6c 6f 63 6b 65 64 28 73 71 6c 69 74 65 onBlocked(sqlite
2e980 33 20 2a 2c 20 73 71 6c 69 74 65 33 20 2a 29 3b 3 *, sqlite3 *);
2e990 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 . void sqlite3C
2e9a0 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c 6f 63 6b 65 onnectionUnlocke
2e9b0 64 28 73 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a d(sqlite3 *db);.
2e9c0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
2e9d0 6e 6e 65 63 74 69 6f 6e 43 6c 6f 73 65 64 28 73 nnectionClosed(s
2e9e0 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a 23 65 6c qlite3 *db);.#el
2e9f0 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c se. #define sql
2ea00 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c ite3ConnectionBl
2ea10 6f 63 6b 65 64 28 78 2c 79 29 0a 20 20 23 64 65 ocked(x,y). #de
2ea20 66 69 6e 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e fine sqlite3Conn
2ea30 65 63 74 69 6f 6e 55 6e 6c 6f 63 6b 65 64 28 78 ectionUnlocked(x
2ea40 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 ). #define sqli
2ea50 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c 6f te3ConnectionClo
2ea60 73 65 64 28 78 29 0a 23 65 6e 64 69 66 0a 0a 23 sed(x).#endif..#
2ea70 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
2ea80 55 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 UG. void sqlite
2ea90 33 50 61 72 73 65 72 54 72 61 63 65 28 46 49 4c 3ParserTrace(FIL
2eaa0 45 2a 2c 20 63 68 61 72 20 2a 29 3b 0a 23 65 6e E*, char *);.#en
2eab0 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 dif.#if defined(
2eac0 59 59 43 4f 56 45 52 41 47 45 29 0a 20 20 69 6e YYCOVERAGE). in
2ead0 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 43 t sqlite3ParserC
2eae0 6f 76 65 72 61 67 65 28 46 49 4c 45 2a 29 3b 0a overage(FILE*);.
2eaf0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 #endif../*.** If
2eb00 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 the SQLITE_ENAB
2eb10 4c 45 20 49 4f 54 52 41 43 45 20 65 78 69 73 74 LE IOTRACE exist
2eb20 73 20 74 68 65 6e 20 74 68 65 20 67 6c 6f 62 61 s then the globa
2eb30 6c 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 73 71 l variable.** sq
2eb40 6c 69 74 65 33 49 6f 54 72 61 63 65 20 69 73 20 lite3IoTrace is
2eb50 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 70 a pointer to a p
2eb60 72 69 6e 74 66 2d 6c 69 6b 65 20 72 6f 75 74 69 rintf-like routi
2eb70 6e 65 20 75 73 65 64 20 74 6f 0a 2a 2a 20 70 72 ne used to.** pr
2eb80 69 6e 74 20 49 2f 4f 20 74 72 61 63 69 6e 67 20 int I/O tracing
2eb90 6d 65 73 73 61 67 65 73 2e 0a 2a 2f 0a 23 69 66 messages..*/.#if
2eba0 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
2ebb0 45 5f 49 4f 54 52 41 43 45 0a 23 20 64 65 66 69 E_IOTRACE.# defi
2ebc0 6e 65 20 49 4f 54 52 41 43 45 28 41 29 20 20 69 ne IOTRACE(A) i
2ebd0 66 28 20 73 71 6c 69 74 65 33 49 6f 54 72 61 63 f( sqlite3IoTrac
2ebe0 65 20 29 7b 20 73 71 6c 69 74 65 33 49 6f 54 72 e ){ sqlite3IoTr
2ebf0 61 63 65 20 41 3b 20 7d 0a 20 20 76 6f 69 64 20 ace A; }. void
2ec00 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 72 61 sqlite3VdbeIOTra
2ec10 63 65 53 71 6c 28 56 64 62 65 2a 29 3b 0a 53 51 ceSql(Vdbe*);.SQ
2ec20 4c 49 54 45 5f 41 50 49 20 53 51 4c 49 54 45 5f LITE_API SQLITE_
2ec30 45 58 54 45 52 4e 20 76 6f 69 64 20 28 53 51 4c EXTERN void (SQL
2ec40 49 54 45 5f 43 44 45 43 4c 20 2a 73 71 6c 69 74 ITE_CDECL *sqlit
2ec50 65 33 49 6f 54 72 61 63 65 29 28 63 6f 6e 73 74 e3IoTrace)(const
2ec60 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a 23 65 6c char*,...);.#el
2ec70 73 65 0a 23 20 64 65 66 69 6e 65 20 49 4f 54 52 se.# define IOTR
2ec80 41 43 45 28 41 29 0a 23 20 64 65 66 69 6e 65 20 ACE(A).# define
2ec90 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 72 61 sqlite3VdbeIOTra
2eca0 63 65 53 71 6c 28 58 29 0a 23 65 6e 64 69 66 0a ceSql(X).#endif.
2ecb0 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f 75 ./*.** These rou
2ecc0 74 69 6e 65 73 20 61 72 65 20 61 76 61 69 6c 61 tines are availa
2ecd0 62 6c 65 20 66 6f 72 20 74 68 65 20 6d 65 6d 32 ble for the mem2
2ece0 2e 63 20 64 65 62 75 67 67 69 6e 67 20 6d 65 6d .c debugging mem
2ecf0 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 0a 2a 2a ory allocator.**
2ed00 20 6f 6e 6c 79 2e 20 20 54 68 65 79 20 61 72 65 only. They are
2ed10 20 75 73 65 64 20 74 6f 20 76 65 72 69 66 79 20 used to verify
2ed20 74 68 61 74 20 64 69 66 66 65 72 65 6e 74 20 22 that different "
2ed30 74 79 70 65 73 22 20 6f 66 20 6d 65 6d 6f 72 79 types" of memory
2ed40 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 .** allocations
2ed50 61 72 65 20 70 72 6f 70 65 72 6c 79 20 74 72 61 are properly tra
2ed60 63 6b 65 64 20 62 79 20 74 68 65 20 73 79 73 74 cked by the syst
2ed70 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 em..**.** sqlite
2ed80 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 3MemdebugSetType
2ed90 28 29 20 73 65 74 73 20 74 68 65 20 22 74 79 70 () sets the "typ
2eda0 65 22 20 6f 66 20 61 6e 20 61 6c 6c 6f 63 61 74 e" of an allocat
2edb0 69 6f 6e 20 74 6f 20 6f 6e 65 20 6f 66 0a 2a 2a ion to one of.**
2edc0 20 74 68 65 20 4d 45 4d 54 59 50 45 5f 2a 20 6d the MEMTYPE_* m
2edd0 61 63 72 6f 73 20 64 65 66 69 6e 65 64 20 62 65 acros defined be
2ede0 6c 6f 77 2e 20 20 54 68 65 20 74 79 70 65 20 6d low. The type m
2edf0 75 73 74 20 62 65 20 61 20 62 69 74 6d 61 73 6b ust be a bitmask
2ee00 20 77 69 74 68 0a 2a 2a 20 61 20 73 69 6e 67 6c with.** a singl
2ee10 65 20 62 69 74 20 73 65 74 2e 0a 2a 2a 0a 2a 2a e bit set..**.**
2ee20 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 sqlite3Memdebug
2ee30 48 61 73 54 79 70 65 28 29 20 72 65 74 75 72 6e HasType() return
2ee40 73 20 74 72 75 65 20 69 66 20 61 6e 79 20 6f 66 s true if any of
2ee50 20 74 68 65 20 62 69 74 73 20 69 6e 20 69 74 73 the bits in its
2ee60 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 67 75 6d second.** argum
2ee70 65 6e 74 20 6d 61 74 63 68 20 74 68 65 20 74 79 ent match the ty
2ee80 70 65 20 73 65 74 20 62 79 20 74 68 65 20 70 72 pe set by the pr
2ee90 65 76 69 6f 75 73 20 73 71 6c 69 74 65 33 4d 65 evious sqlite3Me
2eea0 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 29 2e mdebugSetType().
2eeb0 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
2eec0 62 75 67 48 61 73 54 79 70 65 28 29 20 69 73 20 bugHasType() is
2eed0 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 intended for use
2eee0 20 69 6e 73 69 64 65 20 61 73 73 65 72 74 28 29 inside assert()
2eef0 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a statements..**.
2ef00 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 ** sqlite3Memdeb
2ef10 75 67 4e 6f 54 79 70 65 28 29 20 72 65 74 75 72 ugNoType() retur
2ef20 6e 73 20 74 72 75 65 20 69 66 20 6e 6f 6e 65 20 ns true if none
2ef30 6f 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 69 of the bits in i
2ef40 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 67 ts second.** arg
2ef50 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 20 ument match the
2ef60 74 79 70 65 20 73 65 74 20 62 79 20 74 68 65 20 type set by the
2ef70 70 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 33 previous sqlite3
2ef80 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 MemdebugSetType(
2ef90 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 72 68 61 70 73 )..**.** Perhaps
2efa0 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74 the most import
2efb0 61 6e 74 20 70 6f 69 6e 74 20 69 73 20 74 68 65 ant point is the
2efc0 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 difference betw
2efd0 65 65 6e 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 een MEMTYPE_HEAP
2efe0 0a 2a 2a 20 61 6e 64 20 4d 45 4d 54 59 50 45 5f .** and MEMTYPE_
2eff0 4c 4f 4f 4b 41 53 49 44 45 2e 20 20 49 66 20 61 LOOKASIDE. If a
2f000 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 n allocation is
2f010 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 MEMTYPE_LOOKASID
2f020 45 2c 20 74 68 61 74 20 6d 65 61 6e 73 0a 2a 2a E, that means.**
2f030 20 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 62 it might have b
2f040 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 een allocated by
2f050 20 6c 6f 6f 6b 61 73 69 64 65 2c 20 65 78 63 65 lookaside, exce
2f060 70 74 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f pt the allocatio
2f070 6e 20 77 61 73 0a 2a 2a 20 74 6f 6f 20 6c 61 72 n was.** too lar
2f080 67 65 20 6f 72 20 6c 6f 6f 6b 61 73 69 64 65 20 ge or lookaside
2f090 77 61 73 20 61 6c 72 65 61 64 79 20 66 75 6c 6c was already full
2f0a0 2e 20 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 . It is importa
2f0b0 6e 74 20 74 6f 20 76 65 72 69 66 79 0a 2a 2a 20 nt to verify.**
2f0c0 74 68 61 74 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 that allocations
2f0d0 20 74 68 61 74 20 6d 69 67 68 74 20 68 61 76 65 that might have
2f0e0 20 62 65 65 6e 20 73 61 74 69 73 66 69 65 64 20 been satisfied
2f0f0 62 79 20 6c 6f 6f 6b 61 73 69 64 65 20 61 72 65 by lookaside are
2f100 20 6e 6f 74 0a 2a 2a 20 70 61 73 73 65 64 20 62 not.** passed b
2f110 61 63 6b 20 74 6f 20 6e 6f 6e 2d 6c 6f 6f 6b 61 ack to non-looka
2f120 73 69 64 65 20 66 72 65 65 28 29 20 72 6f 75 74 side free() rout
2f130 69 6e 65 73 2e 20 20 41 73 73 65 72 74 73 20 73 ines. Asserts s
2f140 75 63 68 20 61 73 20 74 68 65 0a 2a 2a 20 65 78 uch as the.** ex
2f150 61 6d 70 6c 65 20 61 62 6f 76 65 20 61 72 65 20 ample above are
2f160 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 20 6e 6f placed on the no
2f170 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 72 65 65 n-lookaside free
2f180 28 29 20 72 6f 75 74 69 6e 65 73 20 74 6f 20 76 () routines to v
2f190 65 72 69 66 79 0a 2a 2a 20 74 68 69 73 20 63 6f erify.** this co
2f1a0 6e 73 74 72 61 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 nstraint..**.**
2f1b0 41 6c 6c 20 6f 66 20 74 68 69 73 20 69 73 20 6e All of this is n
2f1c0 6f 2d 6f 70 20 66 6f 72 20 61 20 70 72 6f 64 75 o-op for a produ
2f1d0 63 74 69 6f 6e 20 62 75 69 6c 64 2e 20 20 49 74 ction build. It
2f1e0 20 6f 6e 6c 79 20 63 6f 6d 65 73 20 69 6e 74 6f only comes into
2f1f0 0a 2a 2a 20 70 6c 61 79 20 77 68 65 6e 20 74 68 .** play when th
2f200 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 e SQLITE_MEMDEBU
2f210 47 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f G compile-time o
2f220 70 74 69 6f 6e 20 69 73 20 75 73 65 64 2e 0a 2a ption is used..*
2f230 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
2f240 4d 45 4d 44 45 42 55 47 0a 20 20 76 6f 69 64 20 MEMDEBUG. void
2f250 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 sqlite3MemdebugS
2f260 65 74 54 79 70 65 28 76 6f 69 64 2a 2c 75 38 29 etType(void*,u8)
2f270 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4d ;. int sqlite3M
2f280 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 76 emdebugHasType(v
2f290 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 69 6e 74 20 oid*,u8);. int
2f2a0 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e sqlite3MemdebugN
2f2b0 6f 54 79 70 65 28 76 6f 69 64 2a 2c 75 38 29 3b oType(void*,u8);
2f2c0 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
2f2d0 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 sqlite3MemdebugS
2f2e0 65 74 54 79 70 65 28 58 2c 59 29 20 20 2f 2a 20 etType(X,Y) /*
2f2f0 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 64 65 66 69 6e no-op */.# defin
2f300 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 e sqlite3Memdebu
2f310 67 48 61 73 54 79 70 65 28 58 2c 59 29 20 20 31 gHasType(X,Y) 1
2f320 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2f330 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 3MemdebugNoType(
2f340 58 2c 59 29 20 20 20 31 0a 23 65 6e 64 69 66 0a X,Y) 1.#endif.
2f350 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f #define MEMTYPE_
2f360 48 45 41 50 20 20 20 20 20 20 20 30 78 30 31 20 HEAP 0x01
2f370 20 2f 2a 20 47 65 6e 65 72 61 6c 20 68 65 61 70 /* General heap
2f380 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 2a 2f 0a allocations */.
2f390 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f #define MEMTYPE_
2f3a0 4c 4f 4f 4b 41 53 49 44 45 20 20 30 78 30 32 20 LOOKASIDE 0x02
2f3b0 20 2f 2a 20 48 65 61 70 20 74 68 61 74 20 6d 69 /* Heap that mi
2f3c0 67 68 74 20 68 61 76 65 20 62 65 65 6e 20 6c 6f ght have been lo
2f3d0 6f 6b 61 73 69 64 65 20 2a 2f 0a 23 64 65 66 69 okaside */.#defi
2f3e0 6e 65 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 ne MEMTYPE_PCACH
2f3f0 45 20 20 20 20 20 30 78 30 34 20 20 2f 2a 20 50 E 0x04 /* P
2f400 61 67 65 20 63 61 63 68 65 20 61 6c 6c 6f 63 61 age cache alloca
2f410 74 69 6f 6e 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 tions */../*.**
2f420 54 68 72 65 61 64 69 6e 67 20 69 6e 74 65 72 66 Threading interf
2f430 61 63 65 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 ace.*/.#if SQLIT
2f440 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 E_MAX_WORKER_THR
2f450 45 41 44 53 3e 30 0a 69 6e 74 20 73 71 6c 69 74 EADS>0.int sqlit
2f460 65 33 54 68 72 65 61 64 43 72 65 61 74 65 28 53 e3ThreadCreate(S
2f470 51 4c 69 74 65 54 68 72 65 61 64 2a 2a 2c 76 6f QLiteThread**,vo
2f480 69 64 2a 28 2a 29 28 76 6f 69 64 2a 29 2c 76 6f id*(*)(void*),vo
2f490 69 64 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 id*);.int sqlite
2f4a0 33 54 68 72 65 61 64 4a 6f 69 6e 28 53 51 4c 69 3ThreadJoin(SQLi
2f4b0 74 65 54 68 72 65 61 64 2a 2c 20 76 6f 69 64 2a teThread*, void*
2f4c0 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 *);.#endif..#if
2f4d0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
2f4e0 4e 41 42 4c 45 5f 44 42 50 41 47 45 5f 56 54 41 NABLE_DBPAGE_VTA
2f4f0 42 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 B) || defined(SQ
2f500 4c 49 54 45 5f 54 45 53 54 29 0a 69 6e 74 20 73 LITE_TEST).int s
2f510 71 6c 69 74 65 33 44 62 70 61 67 65 52 65 67 69 qlite3DbpageRegi
2f520 73 74 65 72 28 73 71 6c 69 74 65 33 2a 29 3b 0a ster(sqlite3*);.
2f530 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
2f540 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
2f550 5f 44 42 53 54 41 54 5f 56 54 41 42 29 20 7c 7c _DBSTAT_VTAB) ||
2f560 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
2f570 54 45 53 54 29 0a 69 6e 74 20 73 71 6c 69 74 65 TEST).int sqlite
2f580 33 44 62 73 74 61 74 52 65 67 69 73 74 65 72 28 3DbstatRegister(
2f590 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 6e 64 69 sqlite3*);.#endi
2f5a0 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 f..int sqlite3Ex
2f5b0 70 72 56 65 63 74 6f 72 53 69 7a 65 28 45 78 70 prVectorSize(Exp
2f5c0 72 20 2a 70 45 78 70 72 29 3b 0a 69 6e 74 20 73 r *pExpr);.int s
2f5d0 71 6c 69 74 65 33 45 78 70 72 49 73 56 65 63 74 qlite3ExprIsVect
2f5e0 6f 72 28 45 78 70 72 20 2a 70 45 78 70 72 29 3b or(Expr *pExpr);
2f5f0 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 56 65 .Expr *sqlite3Ve
2f600 63 74 6f 72 46 69 65 6c 64 53 75 62 65 78 70 72 ctorFieldSubexpr
2f610 28 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 45 78 (Expr*, int);.Ex
2f620 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 46 pr *sqlite3ExprF
2f630 6f 72 56 65 63 74 6f 72 46 69 65 6c 64 28 50 61 orVectorField(Pa
2f640 72 73 65 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b rse*,Expr*,int);
2f650 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 65 63 .void sqlite3Vec
2f660 74 6f 72 45 72 72 6f 72 4d 73 67 28 50 61 72 73 torErrorMsg(Pars
2f670 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 0a 23 69 66 e*, Expr*);..#if
2f680 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2f690 5f 43 4f 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f 44 _COMPILEOPTION_D
2f6a0 49 41 47 53 0a 63 6f 6e 73 74 20 63 68 61 72 20 IAGS.const char
2f6b0 2a 2a 73 71 6c 69 74 65 33 43 6f 6d 70 69 6c 65 **sqlite3Compile
2f6c0 4f 70 74 69 6f 6e 73 28 69 6e 74 20 2a 70 6e 4f Options(int *pnO
2f6d0 70 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 65 6e pt);.#endif..#en
2f6e0 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 49 4e 54 dif /* SQLITEINT
2f6f0 5f 48 20 2a 2f 0a _H */.