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 20 20 20 7c fined(__x86) |
6950: 7c 20 20 20 20 5c 0a 20 20 20 20 20 20 28 64 65 | \. (de
6960: 66 69 6e 65 64 28 5f 5f 54 4f 53 5f 41 49 58 5f fined(__TOS_AIX_
6970: 5f 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 5f _) && !defined(_
6980: 5f 36 34 42 49 54 5f 5f 29 29 0a 23 20 20 20 64 _64BIT__)).# d
6990: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 efine SQLITE_PTR
69a0: 53 49 5a 45 20 34 0a 23 20 65 6c 73 65 0a 23 20 SIZE 4.# else.#
69b0: 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f define SQLITE_
69c0: 50 54 52 53 49 5a 45 20 38 0a 23 20 65 6e 64 69 PTRSIZE 8.# endi
69d0: 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 54 68 65 f.#endif../* The
69e0: 20 75 70 74 72 20 74 79 70 65 20 69 73 20 61 6e uptr type is an
69f0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 unsigned intege
6a00: 72 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 20 74 r large enough t
6a10: 6f 20 68 6f 6c 64 20 61 20 70 6f 69 6e 74 65 72 o hold a pointer
6a20: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
6a30: 48 41 56 45 5f 53 54 44 49 4e 54 5f 48 29 0a 20 HAVE_STDINT_H).
6a40: 20 74 79 70 65 64 65 66 20 75 69 6e 74 70 74 72 typedef uintptr
6a50: 5f 74 20 75 70 74 72 3b 0a 23 65 6c 69 66 20 53 _t uptr;.#elif S
6a60: 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 3d 3d 34 QLITE_PTRSIZE==4
6a70: 0a 20 20 74 79 70 65 64 65 66 20 75 33 32 20 75 . typedef u32 u
6a80: 70 74 72 3b 0a 23 65 6c 73 65 0a 20 20 74 79 70 ptr;.#else. typ
6a90: 65 64 65 66 20 75 36 34 20 75 70 74 72 3b 0a 23 edef u64 uptr;.#
6aa0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 endif../*.** The
6ab0: 20 53 51 4c 49 54 45 5f 57 49 54 48 49 4e 28 50 SQLITE_WITHIN(P
6ac0: 2c 53 2c 45 29 20 6d 61 63 72 6f 20 63 68 65 63 ,S,E) macro chec
6ad0: 6b 73 20 74 6f 20 73 65 65 20 69 66 20 70 6f 69 ks to see if poi
6ae0: 6e 74 65 72 20 50 20 70 6f 69 6e 74 73 20 74 6f nter P points to
6af0: 0a 2a 2a 20 73 6f 6d 65 74 68 69 6e 67 20 62 65 .** something be
6b00: 74 77 65 65 6e 20 53 20 28 69 6e 63 6c 75 73 69 tween S (inclusi
6b10: 76 65 29 20 61 6e 64 20 45 20 28 65 78 63 6c 75 ve) and E (exclu
6b20: 73 69 76 65 29 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 sive)..**.** In
6b30: 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 53 20 69 other words, S i
6b40: 73 20 61 20 62 75 66 66 65 72 20 61 6e 64 20 45 s a buffer and E
6b50: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f is a pointer to
6b60: 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 20 the first byte
6b70: 61 66 74 65 72 0a 2a 2a 20 74 68 65 20 65 6e 64 after.** the end
6b80: 20 6f 66 20 62 75 66 66 65 72 20 53 2e 20 20 54 of buffer S. T
6b90: 68 69 73 20 6d 61 63 72 6f 20 72 65 74 75 72 6e his macro return
6ba0: 73 20 74 72 75 65 20 69 66 20 50 20 70 6f 69 6e s true if P poin
6bb0: 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e 67 0a ts to something.
6bc0: 2a 2a 20 63 6f 6e 74 61 69 6e 65 64 20 77 69 74 ** contained wit
6bd0: 68 69 6e 20 74 68 65 20 62 75 66 66 65 72 20 53 hin the buffer S
6be0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
6bf0: 49 54 45 5f 57 49 54 48 49 4e 28 50 2c 53 2c 45 ITE_WITHIN(P,S,E
6c00: 29 20 28 28 28 75 70 74 72 29 28 50 29 3e 3d 28 ) (((uptr)(P)>=(
6c10: 75 70 74 72 29 28 53 29 29 26 26 28 28 75 70 74 uptr)(S))&&((upt
6c20: 72 29 28 50 29 3c 28 75 70 74 72 29 28 45 29 29 r)(P)<(uptr)(E))
6c30: 29 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 ).../*.** Macros
6c40: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 68 to determine wh
6c50: 65 74 68 65 72 20 74 68 65 20 6d 61 63 68 69 6e ether the machin
6c60: 65 20 69 73 20 62 69 67 20 6f 72 20 6c 69 74 74 e is big or litt
6c70: 6c 65 20 65 6e 64 69 61 6e 2c 0a 2a 2a 20 61 6e le endian,.** an
6c80: 64 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 d whether or not
6c90: 20 74 68 61 74 20 64 65 74 65 72 6d 69 6e 61 74 that determinat
6ca0: 69 6f 6e 20 69 73 20 72 75 6e 2d 74 69 6d 65 20 ion is run-time
6cb0: 6f 72 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e or compile-time.
6cc0: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 62 65 73 74 20 .**.** For best
6cd0: 70 65 72 66 6f 72 6d 61 6e 63 65 2c 20 61 6e 20 performance, an
6ce0: 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 attempt is made
6cf0: 74 6f 20 67 75 65 73 73 20 61 74 20 74 68 65 20 to guess at the
6d00: 62 79 74 65 2d 6f 72 64 65 72 0a 2a 2a 20 75 73 byte-order.** us
6d10: 69 6e 67 20 43 2d 70 72 65 70 72 6f 63 65 73 73 ing C-preprocess
6d20: 6f 72 20 6d 61 63 72 6f 73 2e 20 20 49 66 20 74 or macros. If t
6d30: 68 61 74 20 69 73 20 75 6e 73 75 63 63 65 73 73 hat is unsuccess
6d40: 66 75 6c 2c 20 6f 72 20 69 66 0a 2a 2a 20 2d 44 ful, or if.** -D
6d50: 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 SQLITE_BYTEORDER
6d60: 3d 30 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 =0 is set, then
6d70: 62 79 74 65 2d 6f 72 64 65 72 20 69 73 20 64 65 byte-order is de
6d80: 74 65 72 6d 69 6e 65 64 0a 2a 2a 20 61 74 20 72 termined.** at r
6d90: 75 6e 2d 74 69 6d 65 2e 0a 2a 2f 0a 23 69 66 6e un-time..*/.#ifn
6da0: 64 65 66 20 53 51 4c 49 54 45 5f 42 59 54 45 4f def SQLITE_BYTEO
6db0: 52 44 45 52 0a 23 20 69 66 20 64 65 66 69 6e 65 RDER.# if define
6dc0: 64 28 69 33 38 36 29 20 20 20 20 20 7c 7c 20 64 d(i386) || d
6dd0: 65 66 69 6e 65 64 28 5f 5f 69 33 38 36 5f 5f 29 efined(__i386__)
6de0: 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4d || defined(_M
6df0: 5f 49 58 38 36 29 20 7c 7c 20 20 20 20 5c 0a 20 _IX86) || \.
6e00: 20 20 20 20 64 65 66 69 6e 65 64 28 5f 5f 78 38 defined(__x8
6e10: 36 5f 36 34 29 20 7c 7c 20 64 65 66 69 6e 65 64 6_64) || defined
6e20: 28 5f 5f 78 38 36 5f 36 34 5f 5f 29 20 7c 7c 20 (__x86_64__) ||
6e30: 64 65 66 69 6e 65 64 28 5f 4d 5f 58 36 34 29 20 defined(_M_X64)
6e40: 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 64 65 || \. de
6e50: 66 69 6e 65 64 28 5f 4d 5f 41 4d 44 36 34 29 20 fined(_M_AMD64)
6e60: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f 41 52 || defined(_M_AR
6e70: 4d 29 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 M) || define
6e80: 64 28 5f 5f 78 38 36 29 20 20 20 7c 7c 20 20 20 d(__x86) ||
6e90: 20 5c 0a 20 20 20 20 20 64 65 66 69 6e 65 64 28 \. defined(
6ea0: 5f 5f 61 72 6d 5f 5f 29 20 20 7c 7c 20 64 65 66 __arm__) || def
6eb0: 69 6e 65 64 28 5f 4d 5f 41 52 4d 36 34 29 0a 23 ined(_M_ARM64).#
6ec0: 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 define SQLITE
6ed0: 5f 42 59 54 45 4f 52 44 45 52 20 20 20 20 31 32 _BYTEORDER 12
6ee0: 33 34 0a 23 20 65 6c 69 66 20 64 65 66 69 6e 65 34.# elif define
6ef0: 64 28 73 70 61 72 63 29 20 20 20 20 7c 7c 20 64 d(sparc) || d
6f00: 65 66 69 6e 65 64 28 5f 5f 70 70 63 5f 5f 29 0a efined(__ppc__).
6f10: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
6f20: 45 5f 42 59 54 45 4f 52 44 45 52 20 20 20 20 34 E_BYTEORDER 4
6f30: 33 32 31 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 321.# else.# d
6f40: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 59 54 efine SQLITE_BYT
6f50: 45 4f 52 44 45 52 20 30 0a 23 20 65 6e 64 69 66 EORDER 0.# endif
6f60: 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 .#endif.#if SQLI
6f70: 54 45 5f 42 59 54 45 4f 52 44 45 52 3d 3d 34 33 TE_BYTEORDER==43
6f80: 32 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 21.# define SQLI
6f90: 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 20 20 20 TE_BIGENDIAN
6fa0: 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 1.# define SQLIT
6fb0: 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 4e 20 30 E_LITTLEENDIAN 0
6fc0: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
6fd0: 5f 55 54 46 31 36 4e 41 54 49 56 45 20 20 53 51 _UTF16NATIVE SQ
6fe0: 4c 49 54 45 5f 55 54 46 31 36 42 45 0a 23 65 6c LITE_UTF16BE.#el
6ff0: 69 66 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 if SQLITE_BYTEOR
7000: 44 45 52 3d 3d 31 32 33 34 0a 23 20 64 65 66 69 DER==1234.# defi
7010: 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 ne SQLITE_BIGEND
7020: 49 41 4e 20 20 20 20 30 0a 23 20 64 65 66 69 6e IAN 0.# defin
7030: 65 20 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 e SQLITE_LITTLEE
7040: 4e 44 49 41 4e 20 31 0a 23 20 64 65 66 69 6e 65 NDIAN 1.# define
7050: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
7060: 49 56 45 20 20 53 51 4c 49 54 45 5f 55 54 46 31 IVE SQLITE_UTF1
7070: 36 4c 45 0a 23 65 6c 73 65 0a 23 20 69 66 64 65 6LE.#else.# ifde
7080: 66 20 53 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d f SQLITE_AMALGAM
7090: 41 54 49 4f 4e 0a 20 20 63 6f 6e 73 74 20 69 6e ATION. const in
70a0: 74 20 73 71 6c 69 74 65 33 6f 6e 65 20 3d 20 31 t sqlite3one = 1
70b0: 3b 0a 23 20 65 6c 73 65 0a 20 20 65 78 74 65 72 ;.# else. exter
70c0: 6e 20 63 6f 6e 73 74 20 69 6e 74 20 73 71 6c 69 n const int sqli
70d0: 74 65 33 6f 6e 65 3b 0a 23 20 65 6e 64 69 66 0a te3one;.# endif.
70e0: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
70f0: 42 49 47 45 4e 44 49 41 4e 20 20 20 20 28 2a 28 BIGENDIAN (*(
7100: 63 68 61 72 20 2a 29 28 26 73 71 6c 69 74 65 33 char *)(&sqlite3
7110: 6f 6e 65 29 3d 3d 30 29 0a 23 20 64 65 66 69 6e one)==0).# defin
7120: 65 20 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 e SQLITE_LITTLEE
7130: 4e 44 49 41 4e 20 28 2a 28 63 68 61 72 20 2a 29 NDIAN (*(char *)
7140: 28 26 73 71 6c 69 74 65 33 6f 6e 65 29 3d 3d 31 (&sqlite3one)==1
7150: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
7160: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 20 28 E_UTF16NATIVE (
7170: 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e SQLITE_BIGENDIAN
7180: 3f 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3a ?SQLITE_UTF16BE:
7190: 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 0a SQLITE_UTF16LE).
71a0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f #endif../*.** Co
71b0: 6e 73 74 61 6e 74 73 20 66 6f 72 20 74 68 65 20 nstants for the
71c0: 6c 61 72 67 65 73 74 20 61 6e 64 20 73 6d 61 6c largest and smal
71d0: 6c 65 73 74 20 70 6f 73 73 69 62 6c 65 20 36 34 lest possible 64
71e0: 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65 -bit signed inte
71f0: 67 65 72 73 2e 0a 2a 2a 20 54 68 65 73 65 20 6d gers..** These m
7200: 61 63 72 6f 73 20 61 72 65 20 64 65 73 69 67 6e acros are design
7210: 65 64 20 74 6f 20 77 6f 72 6b 20 63 6f 72 72 65 ed to work corre
7220: 63 74 6c 79 20 6f 6e 20 62 6f 74 68 20 33 32 2d ctly on both 32-
7230: 62 69 74 20 61 6e 64 20 36 34 2d 62 69 74 0a 2a bit and 64-bit.*
7240: 2a 20 63 6f 6d 70 69 6c 65 72 73 2e 0a 2a 2f 0a * compilers..*/.
7250: 23 64 65 66 69 6e 65 20 4c 41 52 47 45 53 54 5f #define LARGEST_
7260: 49 4e 54 36 34 20 20 28 30 78 66 66 66 66 66 66 INT64 (0xffffff
7270: 66 66 7c 28 28 28 69 36 34 29 30 78 37 66 66 66 ff|(((i64)0x7fff
7280: 66 66 66 66 29 3c 3c 33 32 29 29 0a 23 64 65 66 ffff)<<32)).#def
7290: 69 6e 65 20 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 ine SMALLEST_INT
72a0: 36 34 20 28 28 28 69 36 34 29 2d 31 29 20 2d 20 64 (((i64)-1) -
72b0: 4c 41 52 47 45 53 54 5f 49 4e 54 36 34 29 0a 0a LARGEST_INT64)..
72c0: 2f 2a 0a 2a 2a 20 52 6f 75 6e 64 20 75 70 20 61 /*.** Round up a
72d0: 20 6e 75 6d 62 65 72 20 74 6f 20 74 68 65 20 6e number to the n
72e0: 65 78 74 20 6c 61 72 67 65 72 20 6d 75 6c 74 69 ext larger multi
72f0: 70 6c 65 20 6f 66 20 38 2e 20 20 54 68 69 73 20 ple of 8. This
7300: 69 73 20 75 73 65 64 0a 2a 2a 20 74 6f 20 66 6f is used.** to fo
7310: 72 63 65 20 38 2d 62 79 74 65 20 61 6c 69 67 6e rce 8-byte align
7320: 6d 65 6e 74 20 6f 6e 20 36 34 2d 62 69 74 20 61 ment on 64-bit a
7330: 72 63 68 69 74 65 63 74 75 72 65 73 2e 0a 2a 2f rchitectures..*/
7340: 0a 23 64 65 66 69 6e 65 20 52 4f 55 4e 44 38 28 .#define ROUND8(
7350: 78 29 20 20 20 20 20 28 28 28 78 29 2b 37 29 26 x) (((x)+7)&
7360: 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 6e 64 ~7)../*.** Round
7370: 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 6e 65 61 down to the nea
7380: 72 65 73 74 20 6d 75 6c 74 69 70 6c 65 20 6f 66 rest multiple of
7390: 20 38 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 52 4f 8.*/.#define RO
73a0: 55 4e 44 44 4f 57 4e 38 28 78 29 20 28 28 78 29 UNDDOWN8(x) ((x)
73b0: 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 65 &~7)../*.** Asse
73c0: 72 74 20 74 68 61 74 20 74 68 65 20 70 6f 69 6e rt that the poin
73d0: 74 65 72 20 58 20 69 73 20 61 6c 69 67 6e 65 64 ter X is aligned
73e0: 20 74 6f 20 61 6e 20 38 2d 62 79 74 65 20 62 6f to an 8-byte bo
73f0: 75 6e 64 61 72 79 2e 20 20 54 68 69 73 0a 2a 2a undary. This.**
7400: 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 6f macro is used o
7410: 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 73 65 72 nly within asser
7420: 74 28 29 20 74 6f 20 76 65 72 69 66 79 20 74 68 t() to verify th
7430: 61 74 20 74 68 65 20 63 6f 64 65 20 67 65 74 73 at the code gets
7440: 0a 2a 2a 20 61 6c 6c 20 61 6c 69 67 6e 6d 65 6e .** all alignmen
7450: 74 20 72 65 73 74 72 69 63 74 69 6f 6e 73 20 63 t restrictions c
7460: 6f 72 72 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 45 78 orrect..**.** Ex
7470: 63 65 70 74 2c 20 69 66 20 53 51 4c 49 54 45 5f cept, if SQLITE_
7480: 34 5f 42 59 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 4_BYTE_ALIGNED_M
7490: 41 4c 4c 4f 43 20 69 73 20 64 65 66 69 6e 65 64 ALLOC is defined
74a0: 2c 20 74 68 65 6e 20 74 68 65 0a 2a 2a 20 75 6e , then the.** un
74b0: 64 65 72 6c 79 69 6e 67 20 6d 61 6c 6c 6f 63 28 derlying malloc(
74c0: 29 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e ) implementation
74d0: 20 6d 69 67 68 74 20 72 65 74 75 72 6e 20 75 73 might return us
74e0: 20 34 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 0a 4-byte aligned.
74f0: 2a 2a 20 70 6f 69 6e 74 65 72 73 2e 20 20 49 6e ** pointers. In
7500: 20 74 68 61 74 20 63 61 73 65 2c 20 6f 6e 6c 79 that case, only
7510: 20 76 65 72 69 66 79 20 34 2d 62 79 74 65 20 61 verify 4-byte a
7520: 6c 69 67 6e 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 lignment..*/.#if
7530: 64 65 66 20 53 51 4c 49 54 45 5f 34 5f 42 59 54 def SQLITE_4_BYT
7540: 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f 43 E_ALIGNED_MALLOC
7550: 0a 23 20 64 65 66 69 6e 65 20 45 49 47 48 54 5f .# define EIGHT_
7560: 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 BYTE_ALIGNMENT(X
7570: 29 20 20 20 28 28 28 28 63 68 61 72 2a 29 28 58 ) ((((char*)(X
7580: 29 20 2d 20 28 63 68 61 72 2a 29 30 29 26 33 29 ) - (char*)0)&3)
7590: 3d 3d 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 ==0).#else.# def
75a0: 69 6e 65 20 45 49 47 48 54 5f 42 59 54 45 5f 41 ine EIGHT_BYTE_A
75b0: 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20 20 28 28 LIGNMENT(X) ((
75c0: 28 28 63 68 61 72 2a 29 28 58 29 20 2d 20 28 63 ((char*)(X) - (c
75d0: 68 61 72 2a 29 30 29 26 37 29 3d 3d 30 29 0a 23 har*)0)&7)==0).#
75e0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 endif../*.** Dis
75f0: 61 62 6c 65 20 4d 4d 41 50 20 6f 6e 20 70 6c 61 able MMAP on pla
7600: 74 66 6f 72 6d 73 20 77 68 65 72 65 20 69 74 20 tforms where it
7610: 69 73 20 6b 6e 6f 77 6e 20 74 6f 20 6e 6f 74 20 is known to not
7620: 77 6f 72 6b 0a 2a 2f 0a 23 69 66 20 64 65 66 69 work.*/.#if defi
7630: 6e 65 64 28 5f 5f 4f 70 65 6e 42 53 44 5f 5f 29 ned(__OpenBSD__)
7640: 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 51 4e || defined(__QN
7650: 58 4e 54 4f 5f 5f 29 0a 23 20 75 6e 64 65 66 20 XNTO__).# undef
7660: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
7670: 53 49 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 51 SIZE.# define SQ
7680: 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 LITE_MAX_MMAP_SI
7690: 5a 45 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a ZE 0.#endif../*.
76a0: 2a 2a 20 44 65 66 61 75 6c 74 20 6d 61 78 69 6d ** Default maxim
76b0: 75 6d 20 73 69 7a 65 20 6f 66 20 6d 65 6d 6f 72 um size of memor
76c0: 79 20 75 73 65 64 20 62 79 20 6d 65 6d 6f 72 79 y used by memory
76d0: 2d 6d 61 70 70 65 64 20 49 2f 4f 20 69 6e 20 74 -mapped I/O in t
76e0: 68 65 20 56 46 53 0a 2a 2f 0a 23 69 66 64 65 66 he VFS.*/.#ifdef
76f0: 20 5f 5f 41 50 50 4c 45 5f 5f 0a 23 20 69 6e 63 __APPLE__.# inc
7700: 6c 75 64 65 20 3c 54 61 72 67 65 74 43 6f 6e 64 lude <TargetCond
7710: 69 74 69 6f 6e 61 6c 73 2e 68 3e 0a 23 65 6e 64 itionals.h>.#end
7720: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
7730: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a E_MAX_MMAP_SIZE.
7740: 23 20 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 6c # if defined(__l
7750: 69 6e 75 78 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 inux__) \. || d
7760: 65 66 69 6e 65 64 28 5f 57 49 4e 33 32 29 20 5c efined(_WIN32) \
7770: 0a 20 20 7c 7c 20 28 64 65 66 69 6e 65 64 28 5f . || (defined(_
7780: 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 64 65 66 _APPLE__) && def
7790: 69 6e 65 64 28 5f 5f 4d 41 43 48 5f 5f 29 29 20 ined(__MACH__))
77a0: 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f \. || defined(_
77b0: 5f 73 75 6e 29 20 5c 0a 20 20 7c 7c 20 64 65 66 _sun) \. || def
77c0: 69 6e 65 64 28 5f 5f 46 72 65 65 42 53 44 5f 5f ined(__FreeBSD__
77d0: 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 ) \. || defined
77e0: 28 5f 5f 44 72 61 67 6f 6e 46 6c 79 5f 5f 29 0a (__DragonFly__).
77f0: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
7800: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 E_MAX_MMAP_SIZE
7810: 30 78 37 66 66 66 30 30 30 30 20 20 2f 2a 20 32 0x7fff0000 /* 2
7820: 31 34 37 34 31 38 31 31 32 20 2a 2f 0a 23 20 65 147418112 */.# e
7830: 6c 73 65 0a 23 20 20 20 64 65 66 69 6e 65 20 53 lse.# define S
7840: 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
7850: 49 5a 45 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 IZE 0.# endif.#e
7860: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
7870: 64 65 66 61 75 6c 74 20 4d 4d 41 50 5f 53 49 5a default MMAP_SIZ
7880: 45 20 69 73 20 7a 65 72 6f 20 6f 6e 20 61 6c 6c E is zero on all
7890: 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20 4f 72 2c platforms. Or,
78a0: 20 65 76 65 6e 20 69 66 20 61 20 6c 61 72 67 65 even if a large
78b0: 72 0a 2a 2a 20 64 65 66 61 75 6c 74 20 4d 4d 41 r.** default MMA
78c0: 50 5f 53 49 5a 45 20 69 73 20 73 70 65 63 69 66 P_SIZE is specif
78d0: 69 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 ied at compile-t
78e0: 69 6d 65 2c 20 6d 61 6b 65 20 73 75 72 65 20 74 ime, make sure t
78f0: 68 61 74 20 69 74 20 64 6f 65 73 0a 2a 2a 20 6e hat it does.** n
7900: 6f 74 20 65 78 63 65 65 64 20 74 68 65 20 6d 61 ot exceed the ma
7910: 78 69 6d 75 6d 20 6d 6d 61 70 20 73 69 7a 65 2e ximum mmap size.
7920: 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .*/.#ifndef SQLI
7930: 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f TE_DEFAULT_MMAP_
7940: 53 49 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 51 SIZE.# define SQ
7950: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 LITE_DEFAULT_MMA
7960: 50 5f 53 49 5a 45 20 30 0a 23 65 6e 64 69 66 0a P_SIZE 0.#endif.
7970: 23 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 #if SQLITE_DEFAU
7980: 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 3e 53 51 4c LT_MMAP_SIZE>SQL
7990: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
79a0: 45 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 E.# undef SQLITE
79b0: 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 _DEFAULT_MMAP_SI
79c0: 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 ZE.# define SQLI
79d0: 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f TE_DEFAULT_MMAP_
79e0: 53 49 5a 45 20 53 51 4c 49 54 45 5f 4d 41 58 5f SIZE SQLITE_MAX_
79f0: 4d 4d 41 50 5f 53 49 5a 45 0a 23 65 6e 64 69 66 MMAP_SIZE.#endif
7a00: 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 ../*.** Only one
7a10: 20 6f 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c of SQLITE_ENABL
7a20: 45 5f 53 54 41 54 33 20 6f 72 20 53 51 4c 49 54 E_STAT3 or SQLIT
7a30: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 20 63 E_ENABLE_STAT4 c
7a40: 61 6e 20 62 65 20 64 65 66 69 6e 65 64 2e 0a 2a an be defined..*
7a50: 2a 20 50 72 69 6f 72 69 74 79 20 69 73 20 67 69 * Priority is gi
7a60: 76 65 6e 20 74 6f 20 53 51 4c 49 54 45 5f 45 4e ven to SQLITE_EN
7a70: 41 42 4c 45 5f 53 54 41 54 34 2e 20 20 49 66 20 ABLE_STAT4. If
7a80: 65 69 74 68 65 72 20 61 72 65 20 64 65 66 69 6e either are defin
7a90: 65 64 2c 20 61 6c 73 6f 0a 2a 2a 20 64 65 66 69 ed, also.** defi
7aa0: 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ne SQLITE_ENABLE
7ab0: 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a _STAT3_OR_STAT4.
7ac0: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
7ad0: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 0a 23 20 _ENABLE_STAT4.#
7ae0: 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 undef SQLITE_ENA
7af0: 42 4c 45 5f 53 54 41 54 33 0a 23 20 64 65 66 69 BLE_STAT3.# defi
7b00: 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ne SQLITE_ENABLE
7b10: 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 20 _STAT3_OR_STAT4
7b20: 31 0a 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 45 1.#elif SQLITE_E
7b30: 4e 41 42 4c 45 5f 53 54 41 54 33 0a 23 20 64 65 NABLE_STAT3.# de
7b40: 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 fine SQLITE_ENAB
7b50: 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 LE_STAT3_OR_STAT
7b60: 34 20 31 0a 23 65 6c 69 66 20 53 51 4c 49 54 45 4 1.#elif SQLITE
7b70: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
7b80: 5f 53 54 41 54 34 0a 23 20 75 6e 64 65 66 20 53 _STAT4.# undef S
7b90: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
7ba0: 54 33 5f 4f 52 5f 53 54 41 54 34 0a 23 65 6e 64 T3_OR_STAT4.#end
7bb0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 45 4c 45 43 54 if../*.** SELECT
7bc0: 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 77 69 TRACE_ENABLED wi
7bd0: 6c 6c 20 62 65 20 65 69 74 68 65 72 20 31 20 6f ll be either 1 o
7be0: 72 20 30 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e r 0 depending on
7bf0: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 0a whether or not.
7c00: 2a 2a 20 74 68 65 20 53 65 6c 65 63 74 20 71 75 ** the Select qu
7c10: 65 72 79 20 67 65 6e 65 72 61 74 6f 72 20 74 72 ery generator tr
7c20: 61 63 69 6e 67 20 6c 6f 67 69 63 20 69 73 20 74 acing logic is t
7c30: 75 72 6e 65 64 20 6f 6e 2e 0a 2a 2f 0a 23 69 66 urned on..*/.#if
7c40: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
7c50: 45 4e 41 42 4c 45 5f 53 45 4c 45 43 54 54 52 41 ENABLE_SELECTTRA
7c60: 43 45 29 0a 23 20 64 65 66 69 6e 65 20 53 45 4c CE).# define SEL
7c70: 45 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 ECTTRACE_ENABLED
7c80: 20 31 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 1.#else.# defin
7c90: 65 20 53 45 4c 45 43 54 54 52 41 43 45 5f 45 4e e SELECTTRACE_EN
7ca0: 41 42 4c 45 44 20 30 0a 23 65 6e 64 69 66 0a 0a ABLED 0.#endif..
7cb0: 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 /*.** An instanc
7cc0: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
7cd0: 6e 67 20 73 74 72 75 63 74 75 72 65 20 69 73 20 ng structure is
7ce0: 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 used to store th
7cf0: 65 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 0a 2a e busy-handler.*
7d00: 2a 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 * callback for a
7d10: 20 67 69 76 65 6e 20 73 71 6c 69 74 65 20 68 61 given sqlite ha
7d20: 6e 64 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 ndle..**.** The
7d30: 73 71 6c 69 74 65 2e 62 75 73 79 48 61 6e 64 6c sqlite.busyHandl
7d40: 65 72 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 er member of the
7d50: 20 73 71 6c 69 74 65 20 73 74 72 75 63 74 20 63 sqlite struct c
7d60: 6f 6e 74 61 69 6e 73 20 74 68 65 20 62 75 73 79 ontains the busy
7d70: 0a 2a 2a 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 .** callback for
7d80: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 the database ha
7d90: 6e 64 6c 65 2e 20 45 61 63 68 20 70 61 67 65 72 ndle. Each pager
7da0: 20 6f 70 65 6e 65 64 20 76 69 61 20 74 68 65 20 opened via the
7db0: 73 71 6c 69 74 65 0a 2a 2a 20 68 61 6e 64 6c 65 sqlite.** handle
7dc0: 20 69 73 20 70 61 73 73 65 64 20 61 20 70 6f 69 is passed a poi
7dd0: 6e 74 65 72 20 74 6f 20 73 71 6c 69 74 65 2e 62 nter to sqlite.b
7de0: 75 73 79 48 61 6e 64 6c 65 72 2e 20 54 68 65 20 usyHandler. The
7df0: 62 75 73 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 busy-handler.**
7e00: 63 61 6c 6c 62 61 63 6b 20 69 73 20 63 75 72 72 callback is curr
7e10: 65 6e 74 6c 79 20 69 6e 76 6f 6b 65 64 20 6f 6e ently invoked on
7e20: 6c 79 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 70 ly from within p
7e30: 61 67 65 72 2e 63 2e 0a 2a 2f 0a 74 79 70 65 64 ager.c..*/.typed
7e40: 65 66 20 73 74 72 75 63 74 20 42 75 73 79 48 61 ef struct BusyHa
7e50: 6e 64 6c 65 72 20 42 75 73 79 48 61 6e 64 6c 65 ndler BusyHandle
7e60: 72 3b 0a 73 74 72 75 63 74 20 42 75 73 79 48 61 r;.struct BusyHa
7e70: 6e 64 6c 65 72 20 7b 0a 20 20 69 6e 74 20 28 2a ndler {. int (*
7e80: 78 42 75 73 79 48 61 6e 64 6c 65 72 29 28 76 6f xBusyHandler)(vo
7e90: 69 64 20 2a 2c 69 6e 74 29 3b 20 20 2f 2a 20 54 id *,int); /* T
7ea0: 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b he busy callback
7eb0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 42 75 73 */. void *pBus
7ec0: 79 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 yArg;
7ed0: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
7ee0: 20 61 72 67 20 74 6f 20 62 75 73 79 20 63 61 6c arg to busy cal
7ef0: 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e lback */. int n
7f00: 42 75 73 79 3b 20 20 20 20 20 20 20 20 20 20 20 Busy;
7f10: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7f20: 49 6e 63 72 65 6d 65 6e 74 65 64 20 77 69 74 68 Incremented with
7f30: 20 65 61 63 68 20 62 75 73 79 20 63 61 6c 6c 20 each busy call
7f40: 2a 2f 0a 20 20 75 38 20 62 45 78 74 72 61 46 69 */. u8 bExtraFi
7f50: 6c 65 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 leArg;
7f60: 20 20 20 20 20 20 20 2f 2a 20 49 6e 63 6c 75 64 /* Includ
7f70: 65 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 61 e sqlite3_file a
7f80: 73 20 63 61 6c 6c 62 61 63 6b 20 61 72 67 20 2a s callback arg *
7f90: 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 4e 61 6d 65 /.};../*.** Name
7fa0: 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 64 of the master d
7fb0: 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e 20 20 atabase table.
7fc0: 54 68 65 20 6d 61 73 74 65 72 20 64 61 74 61 62 The master datab
7fd0: 61 73 65 20 74 61 62 6c 65 0a 2a 2a 20 69 73 20 ase table.** is
7fe0: 61 20 73 70 65 63 69 61 6c 20 74 61 62 6c 65 20 a special table
7ff0: 74 68 61 74 20 68 6f 6c 64 73 20 74 68 65 20 6e that holds the n
8000: 61 6d 65 73 20 61 6e 64 20 61 74 74 72 69 62 75 ames and attribu
8010: 74 65 73 20 6f 66 20 61 6c 6c 0a 2a 2a 20 75 73 tes of all.** us
8020: 65 72 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e er tables and in
8030: 64 69 63 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e dices..*/.#defin
8040: 65 20 4d 41 53 54 45 52 5f 4e 41 4d 45 20 20 20 e MASTER_NAME
8050: 20 20 20 20 22 73 71 6c 69 74 65 5f 6d 61 73 74 "sqlite_mast
8060: 65 72 22 0a 23 64 65 66 69 6e 65 20 54 45 4d 50 er".#define TEMP
8070: 5f 4d 41 53 54 45 52 5f 4e 41 4d 45 20 20 22 73 _MASTER_NAME "s
8080: 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 qlite_temp_maste
8090: 72 22 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 72 6f r"../*.** The ro
80a0: 6f 74 2d 70 61 67 65 20 6f 66 20 74 68 65 20 6d ot-page of the m
80b0: 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 74 aster database t
80c0: 61 62 6c 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 able..*/.#define
80d0: 20 4d 41 53 54 45 52 5f 52 4f 4f 54 20 20 20 20 MASTER_ROOT
80e0: 20 20 20 31 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 1../*.** The
80f0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 73 63 68 65 name of the sche
8100: 6d 61 20 74 61 62 6c 65 2e 0a 2a 2f 0a 23 64 65 ma table..*/.#de
8110: 66 69 6e 65 20 53 43 48 45 4d 41 5f 54 41 42 4c fine SCHEMA_TABL
8120: 45 28 78 29 20 20 28 28 21 4f 4d 49 54 5f 54 45 E(x) ((!OMIT_TE
8130: 4d 50 44 42 29 26 26 28 78 3d 3d 31 29 3f 54 45 MPDB)&&(x==1)?TE
8140: 4d 50 5f 4d 41 53 54 45 52 5f 4e 41 4d 45 3a 4d MP_MASTER_NAME:M
8150: 41 53 54 45 52 5f 4e 41 4d 45 29 0a 0a 2f 2a 0a ASTER_NAME)../*.
8160: 2a 2a 20 41 20 63 6f 6e 76 65 6e 69 65 6e 63 65 ** A convenience
8170: 20 6d 61 63 72 6f 20 74 68 61 74 20 72 65 74 75 macro that retu
8180: 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f rns the number o
8190: 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e 0a 2a 2a f elements in.**
81a0: 20 61 6e 20 61 72 72 61 79 2e 0a 2a 2f 0a 23 64 an array..*/.#d
81b0: 65 66 69 6e 65 20 41 72 72 61 79 53 69 7a 65 28 efine ArraySize(
81c0: 58 29 20 20 20 20 28 28 69 6e 74 29 28 73 69 7a X) ((int)(siz
81d0: 65 6f 66 28 58 29 2f 73 69 7a 65 6f 66 28 58 5b eof(X)/sizeof(X[
81e0: 30 5d 29 29 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 0])))../*.** Det
81f0: 65 72 6d 69 6e 65 20 69 66 20 74 68 65 20 61 72 ermine if the ar
8200: 67 75 6d 65 6e 74 20 69 73 20 61 20 70 6f 77 65 gument is a powe
8210: 72 20 6f 66 20 74 77 6f 0a 2a 2f 0a 23 64 65 66 r of two.*/.#def
8220: 69 6e 65 20 49 73 50 6f 77 65 72 4f 66 54 77 6f ine IsPowerOfTwo
8230: 28 58 29 20 28 28 28 58 29 26 28 28 58 29 2d 31 (X) (((X)&((X)-1
8240: 29 29 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 ))==0)../*.** Th
8250: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 e following valu
8260: 65 20 61 73 20 61 20 64 65 73 74 72 75 63 74 6f e as a destructo
8270: 72 20 6d 65 61 6e 73 20 74 6f 20 75 73 65 20 73 r means to use s
8280: 71 6c 69 74 65 33 44 62 46 72 65 65 28 29 2e 0a qlite3DbFree()..
8290: 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 33 44 62 ** The sqlite3Db
82a0: 46 72 65 65 28 29 20 72 6f 75 74 69 6e 65 20 72 Free() routine r
82b0: 65 71 75 69 72 65 73 20 74 77 6f 20 70 61 72 61 equires two para
82c0: 6d 65 74 65 72 73 20 69 6e 73 74 65 61 64 20 6f meters instead o
82d0: 66 20 74 68 65 0a 2a 2a 20 6f 6e 65 20 70 61 72 f the.** one par
82e0: 61 6d 65 74 65 72 20 74 68 61 74 20 64 65 73 74 ameter that dest
82f0: 72 75 63 74 6f 72 73 20 6e 6f 72 6d 61 6c 6c 79 ructors normally
8300: 20 77 61 6e 74 2e 20 20 53 6f 20 77 65 20 68 61 want. So we ha
8310: 76 65 20 74 6f 20 69 6e 74 72 6f 64 75 63 65 0a ve to introduce.
8320: 2a 2a 20 74 68 69 73 20 6d 61 67 69 63 20 76 61 ** this magic va
8330: 6c 75 65 20 74 68 61 74 20 74 68 65 20 63 6f 64 lue that the cod
8340: 65 20 6b 6e 6f 77 73 20 74 6f 20 68 61 6e 64 6c e knows to handl
8350: 65 20 64 69 66 66 65 72 65 6e 74 6c 79 2e 20 20 e differently.
8360: 41 6e 79 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 77 Any.** pointer w
8370: 69 6c 6c 20 77 6f 72 6b 20 68 65 72 65 20 61 73 ill work here as
8380: 20 6c 6f 6e 67 20 61 73 20 69 74 20 69 73 20 64 long as it is d
8390: 69 73 74 69 6e 63 74 20 66 72 6f 6d 20 53 51 4c istinct from SQL
83a0: 49 54 45 5f 53 54 41 54 49 43 0a 2a 2a 20 61 6e ITE_STATIC.** an
83b0: 64 20 53 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 d SQLITE_TRANSIE
83c0: 4e 54 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 NT..*/.#define S
83d0: 51 4c 49 54 45 5f 44 59 4e 41 4d 49 43 20 20 20 QLITE_DYNAMIC
83e0: 28 28 73 71 6c 69 74 65 33 5f 64 65 73 74 72 75 ((sqlite3_destru
83f0: 63 74 6f 72 5f 74 79 70 65 29 73 71 6c 69 74 65 ctor_type)sqlite
8400: 33 4d 61 6c 6c 6f 63 53 69 7a 65 29 0a 0a 2f 2a 3MallocSize)../*
8410: 0a 2a 2a 20 57 68 65 6e 20 53 51 4c 49 54 45 5f .** When SQLITE_
8420: 4f 4d 49 54 5f 57 53 44 20 69 73 20 64 65 66 69 OMIT_WSD is defi
8430: 6e 65 64 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 ned, it means th
8440: 61 74 20 74 68 65 20 74 61 72 67 65 74 20 70 6c at the target pl
8450: 61 74 66 6f 72 6d 20 64 6f 65 73 0a 2a 2a 20 6e atform does.** n
8460: 6f 74 20 73 75 70 70 6f 72 74 20 57 72 69 74 61 ot support Writa
8470: 62 6c 65 20 53 74 61 74 69 63 20 44 61 74 61 20 ble Static Data
8480: 28 57 53 44 29 20 73 75 63 68 20 61 73 20 67 6c (WSD) such as gl
8490: 6f 62 61 6c 20 61 6e 64 20 73 74 61 74 69 63 20 obal and static
84a0: 76 61 72 69 61 62 6c 65 73 2e 0a 2a 2a 20 41 6c variables..** Al
84b0: 6c 20 76 61 72 69 61 62 6c 65 73 20 6d 75 73 74 l variables must
84c0: 20 65 69 74 68 65 72 20 62 65 20 6f 6e 20 74 68 either be on th
84d0: 65 20 73 74 61 63 6b 20 6f 72 20 64 79 6e 61 6d e stack or dynam
84e0: 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 61 74 65 64 ically allocated
84f0: 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 68 65 61 from.** the hea
8500: 70 2e 20 20 57 68 65 6e 20 57 53 44 20 69 73 20 p. When WSD is
8510: 75 6e 73 75 70 70 6f 72 74 65 64 2c 20 74 68 65 unsupported, the
8520: 20 76 61 72 69 61 62 6c 65 20 64 65 63 6c 61 72 variable declar
8530: 61 74 69 6f 6e 73 20 73 63 61 74 74 65 72 65 64 ations scattered
8540: 0a 2a 2a 20 74 68 72 6f 75 67 68 6f 75 74 20 74 .** throughout t
8550: 68 65 20 53 51 4c 69 74 65 20 63 6f 64 65 20 6d he SQLite code m
8560: 75 73 74 20 62 65 63 6f 6d 65 20 63 6f 6e 73 74 ust become const
8570: 61 6e 74 73 20 69 6e 73 74 65 61 64 2e 20 20 54 ants instead. T
8580: 68 65 20 53 51 4c 49 54 45 5f 57 53 44 0a 2a 2a he SQLITE_WSD.**
8590: 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 66 macro is used f
85a0: 6f 72 20 74 68 69 73 20 70 75 72 70 6f 73 65 2e or this purpose.
85b0: 20 20 41 6e 64 20 69 6e 73 74 65 61 64 20 6f 66 And instead of
85c0: 20 72 65 66 65 72 65 6e 63 69 6e 67 20 74 68 65 referencing the
85d0: 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 64 69 72 variable.** dir
85e0: 65 63 74 6c 79 2c 20 77 65 20 75 73 65 20 69 74 ectly, we use it
85f0: 73 20 63 6f 6e 73 74 61 6e 74 20 61 73 20 61 20 s constant as a
8600: 6b 65 79 20 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 key to lookup th
8610: 65 20 72 75 6e 2d 74 69 6d 65 20 61 6c 6c 6f 63 e run-time alloc
8620: 61 74 65 64 0a 2a 2a 20 62 75 66 66 65 72 20 74 ated.** buffer t
8630: 68 61 74 20 68 6f 6c 64 73 20 72 65 61 6c 20 76 hat holds real v
8640: 61 72 69 61 62 6c 65 2e 20 20 54 68 65 20 63 6f ariable. The co
8650: 6e 73 74 61 6e 74 20 69 73 20 61 6c 73 6f 20 74 nstant is also t
8660: 68 65 20 69 6e 69 74 69 61 6c 69 7a 65 72 0a 2a he initializer.*
8670: 2a 20 66 6f 72 20 74 68 65 20 72 75 6e 2d 74 69 * for the run-ti
8680: 6d 65 20 61 6c 6c 6f 63 61 74 65 64 20 62 75 66 me allocated buf
8690: 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 fer..**.** In th
86a0: 65 20 75 73 75 61 6c 20 63 61 73 65 20 77 68 65 e usual case whe
86b0: 72 65 20 57 53 44 20 69 73 20 73 75 70 70 6f 72 re WSD is suppor
86c0: 74 65 64 2c 20 74 68 65 20 53 51 4c 49 54 45 5f ted, the SQLITE_
86d0: 57 53 44 20 61 6e 64 20 47 4c 4f 42 41 4c 0a 2a WSD and GLOBAL.*
86e0: 2a 20 6d 61 63 72 6f 73 20 62 65 63 6f 6d 65 20 * macros become
86f0: 6e 6f 2d 6f 70 73 20 61 6e 64 20 68 61 76 65 20 no-ops and have
8700: 7a 65 72 6f 20 70 65 72 66 6f 72 6d 61 6e 63 65 zero performance
8710: 20 69 6d 70 61 63 74 2e 0a 2a 2f 0a 23 69 66 64 impact..*/.#ifd
8720: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
8730: 53 44 0a 20 20 23 64 65 66 69 6e 65 20 53 51 4c SD. #define SQL
8740: 49 54 45 5f 57 53 44 20 63 6f 6e 73 74 0a 20 20 ITE_WSD const.
8750: 23 64 65 66 69 6e 65 20 47 4c 4f 42 41 4c 28 74 #define GLOBAL(t
8760: 2c 76 29 20 28 2a 28 74 2a 29 73 71 6c 69 74 65 ,v) (*(t*)sqlite
8770: 33 5f 77 73 64 5f 66 69 6e 64 28 28 76 6f 69 64 3_wsd_find((void
8780: 2a 29 26 28 76 29 2c 20 73 69 7a 65 6f 66 28 76 *)&(v), sizeof(v
8790: 29 29 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 ))). #define sq
87a0: 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 lite3GlobalConfi
87b0: 67 20 47 4c 4f 42 41 4c 28 73 74 72 75 63 74 20 g GLOBAL(struct
87c0: 53 71 6c 69 74 65 33 43 6f 6e 66 69 67 2c 20 73 Sqlite3Config, s
87d0: 71 6c 69 74 65 33 43 6f 6e 66 69 67 29 0a 20 20 qlite3Config).
87e0: 69 6e 74 20 73 71 6c 69 74 65 33 5f 77 73 64 5f int sqlite3_wsd_
87f0: 69 6e 69 74 28 69 6e 74 20 4e 2c 20 69 6e 74 20 init(int N, int
8800: 4a 29 3b 0a 20 20 76 6f 69 64 20 2a 73 71 6c 69 J);. void *sqli
8810: 74 65 33 5f 77 73 64 5f 66 69 6e 64 28 76 6f 69 te3_wsd_find(voi
8820: 64 20 2a 4b 2c 20 69 6e 74 20 4c 29 3b 0a 23 65 d *K, int L);.#e
8830: 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 53 51 lse. #define SQ
8840: 4c 49 54 45 5f 57 53 44 0a 20 20 23 64 65 66 69 LITE_WSD. #defi
8850: 6e 65 20 47 4c 4f 42 41 4c 28 74 2c 76 29 20 76 ne GLOBAL(t,v) v
8860: 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
8870: 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20 73 e3GlobalConfig s
8880: 71 6c 69 74 65 33 43 6f 6e 66 69 67 0a 23 65 6e qlite3Config.#en
8890: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 dif../*.** The f
88a0: 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 ollowing macros
88b0: 61 72 65 20 75 73 65 64 20 74 6f 20 73 75 70 70 are used to supp
88c0: 72 65 73 73 20 63 6f 6d 70 69 6c 65 72 20 77 61 ress compiler wa
88d0: 72 6e 69 6e 67 73 20 61 6e 64 20 74 6f 0a 2a 2a rnings and to.**
88e0: 20 6d 61 6b 65 20 69 74 20 63 6c 65 61 72 20 74 make it clear t
88f0: 6f 20 68 75 6d 61 6e 20 72 65 61 64 65 72 73 20 o human readers
8900: 77 68 65 6e 20 61 20 66 75 6e 63 74 69 6f 6e 20 when a function
8910: 70 61 72 61 6d 65 74 65 72 20 69 73 20 64 65 6c parameter is del
8920: 69 62 65 72 61 74 65 6c 79 0a 2a 2a 20 6c 65 66 iberately.** lef
8930: 74 20 75 6e 75 73 65 64 20 77 69 74 68 69 6e 20 t unused within
8940: 74 68 65 20 62 6f 64 79 20 6f 66 20 61 20 66 75 the body of a fu
8950: 6e 63 74 69 6f 6e 2e 20 54 68 69 73 20 75 73 75 nction. This usu
8960: 61 6c 6c 79 20 68 61 70 70 65 6e 73 20 77 68 65 ally happens whe
8970: 6e 0a 2a 2a 20 61 20 66 75 6e 63 74 69 6f 6e 20 n.** a function
8980: 69 73 20 63 61 6c 6c 65 64 20 76 69 61 20 61 20 is called via a
8990: 66 75 6e 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 function pointer
89a0: 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 . For example th
89b0: 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 e.** implementat
89c0: 69 6f 6e 20 6f 66 20 61 6e 20 53 51 4c 20 61 67 ion of an SQL ag
89d0: 67 72 65 67 61 74 65 20 73 74 65 70 20 63 61 6c gregate step cal
89e0: 6c 62 61 63 6b 20 6d 61 79 20 6e 6f 74 20 75 73 lback may not us
89f0: 65 20 74 68 65 0a 2a 2a 20 70 61 72 61 6d 65 74 e the.** paramet
8a00: 65 72 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 er indicating th
8a10: 65 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 e number of argu
8a20: 6d 65 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 ments passed to
8a30: 74 68 65 20 61 67 67 72 65 67 61 74 65 2c 0a 2a the aggregate,.*
8a40: 2a 20 69 66 20 69 74 20 6b 6e 6f 77 73 20 74 68 * if it knows th
8a50: 61 74 20 74 68 69 73 20 69 73 20 65 6e 66 6f 72 at this is enfor
8a60: 63 65 64 20 65 6c 73 65 77 68 65 72 65 2e 0a 2a ced elsewhere..*
8a70: 2a 0a 2a 2a 20 57 68 65 6e 20 61 20 66 75 6e 63 *.** When a func
8a80: 74 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 20 69 tion parameter i
8a90: 73 20 6e 6f 74 20 75 73 65 64 20 61 74 20 61 6c s not used at al
8aa0: 6c 20 77 69 74 68 69 6e 20 74 68 65 20 62 6f 64 l within the bod
8ab0: 79 20 6f 66 20 61 20 66 75 6e 63 74 69 6f 6e 2c y of a function,
8ac0: 0a 2a 2a 20 69 74 20 69 73 20 67 65 6e 65 72 61 .** it is genera
8ad0: 6c 6c 79 20 6e 61 6d 65 64 20 22 4e 6f 74 55 73 lly named "NotUs
8ae0: 65 64 22 20 6f 72 20 22 4e 6f 74 55 73 65 64 32 ed" or "NotUsed2
8af0: 22 20 74 6f 20 6d 61 6b 65 20 74 68 69 6e 67 73 " to make things
8b00: 20 65 76 65 6e 20 63 6c 65 61 72 65 72 2e 0a 2a even clearer..*
8b10: 2a 20 48 6f 77 65 76 65 72 2c 20 74 68 65 73 65 * However, these
8b20: 20 6d 61 63 72 6f 73 20 6d 61 79 20 61 6c 73 6f macros may also
8b30: 20 62 65 20 75 73 65 64 20 74 6f 20 73 75 70 70 be used to supp
8b40: 72 65 73 73 20 77 61 72 6e 69 6e 67 73 20 72 65 ress warnings re
8b50: 6c 61 74 65 64 20 74 6f 0a 2a 2a 20 70 61 72 61 lated to.** para
8b60: 6d 65 74 65 72 73 20 74 68 61 74 20 6d 61 79 20 meters that may
8b70: 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 75 73 or may not be us
8b80: 65 64 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 ed depending on
8b90: 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 74 69 compilation opti
8ba0: 6f 6e 73 2e 0a 2a 2a 20 46 6f 72 20 65 78 61 6d ons..** For exam
8bb0: 70 6c 65 20 74 68 6f 73 65 20 70 61 72 61 6d 65 ple those parame
8bc0: 74 65 72 73 20 6f 6e 6c 79 20 75 73 65 64 20 69 ters only used i
8bd0: 6e 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 n assert() state
8be0: 6d 65 6e 74 73 2e 20 49 6e 20 74 68 65 73 65 0a ments. In these.
8bf0: 2a 2a 20 63 61 73 65 73 20 74 68 65 20 70 61 72 ** cases the par
8c00: 61 6d 65 74 65 72 73 20 61 72 65 20 6e 61 6d 65 ameters are name
8c10: 64 20 61 73 20 70 65 72 20 74 68 65 20 75 73 75 d as per the usu
8c20: 61 6c 20 63 6f 6e 76 65 6e 74 69 6f 6e 73 2e 0a al conventions..
8c30: 2a 2f 0a 23 64 65 66 69 6e 65 20 55 4e 55 53 45 */.#define UNUSE
8c40: 44 5f 50 41 52 41 4d 45 54 45 52 28 78 29 20 28 D_PARAMETER(x) (
8c50: 76 6f 69 64 29 28 78 29 0a 23 64 65 66 69 6e 65 void)(x).#define
8c60: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
8c70: 52 32 28 78 2c 79 29 20 55 4e 55 53 45 44 5f 50 R2(x,y) UNUSED_P
8c80: 41 52 41 4d 45 54 45 52 28 78 29 2c 55 4e 55 53 ARAMETER(x),UNUS
8c90: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 79 29 0a ED_PARAMETER(y).
8ca0: 0a 2f 2a 0a 2a 2a 20 46 6f 72 77 61 72 64 20 72 ./*.** Forward r
8cb0: 65 66 65 72 65 6e 63 65 73 20 74 6f 20 73 74 72 eferences to str
8cc0: 75 63 74 75 72 65 73 0a 2a 2f 0a 74 79 70 65 64 uctures.*/.typed
8cd0: 65 66 20 73 74 72 75 63 74 20 41 67 67 49 6e 66 ef struct AggInf
8ce0: 6f 20 41 67 67 49 6e 66 6f 3b 0a 74 79 70 65 64 o AggInfo;.typed
8cf0: 65 66 20 73 74 72 75 63 74 20 41 75 74 68 43 6f ef struct AuthCo
8d00: 6e 74 65 78 74 20 41 75 74 68 43 6f 6e 74 65 78 ntext AuthContex
8d10: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
8d20: 74 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 41 75 t AutoincInfo Au
8d30: 74 6f 69 6e 63 49 6e 66 6f 3b 0a 74 79 70 65 64 toincInfo;.typed
8d40: 65 66 20 73 74 72 75 63 74 20 42 69 74 76 65 63 ef struct Bitvec
8d50: 20 42 69 74 76 65 63 3b 0a 74 79 70 65 64 65 66 Bitvec;.typedef
8d60: 20 73 74 72 75 63 74 20 43 6f 6c 6c 53 65 71 20 struct CollSeq
8d70: 43 6f 6c 6c 53 65 71 3b 0a 74 79 70 65 64 65 66 CollSeq;.typedef
8d80: 20 73 74 72 75 63 74 20 43 6f 6c 75 6d 6e 20 43 struct Column C
8d90: 6f 6c 75 6d 6e 3b 0a 74 79 70 65 64 65 66 20 73 olumn;.typedef s
8da0: 74 72 75 63 74 20 44 62 20 44 62 3b 0a 74 79 70 truct Db Db;.typ
8db0: 65 64 65 66 20 73 74 72 75 63 74 20 53 63 68 65 edef struct Sche
8dc0: 6d 61 20 53 63 68 65 6d 61 3b 0a 74 79 70 65 64 ma Schema;.typed
8dd0: 65 66 20 73 74 72 75 63 74 20 45 78 70 72 20 45 ef struct Expr E
8de0: 78 70 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 xpr;.typedef str
8df0: 75 63 74 20 45 78 70 72 4c 69 73 74 20 45 78 70 uct ExprList Exp
8e00: 72 4c 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 rList;.typedef s
8e10: 74 72 75 63 74 20 46 4b 65 79 20 46 4b 65 79 3b truct FKey FKey;
8e20: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8e30: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 46 FuncDestructor F
8e40: 75 6e 63 44 65 73 74 72 75 63 74 6f 72 3b 0a 74 uncDestructor;.t
8e50: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 ypedef struct Fu
8e60: 6e 63 44 65 66 20 46 75 6e 63 44 65 66 3b 0a 74 ncDef FuncDef;.t
8e70: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 ypedef struct Fu
8e80: 6e 63 44 65 66 48 61 73 68 20 46 75 6e 63 44 65 ncDefHash FuncDe
8e90: 66 48 61 73 68 3b 0a 74 79 70 65 64 65 66 20 73 fHash;.typedef s
8ea0: 74 72 75 63 74 20 49 64 4c 69 73 74 20 49 64 4c truct IdList IdL
8eb0: 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ist;.typedef str
8ec0: 75 63 74 20 49 6e 64 65 78 20 49 6e 64 65 78 3b uct Index Index;
8ed0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8ee0: 49 6e 64 65 78 53 61 6d 70 6c 65 20 49 6e 64 65 IndexSample Inde
8ef0: 78 53 61 6d 70 6c 65 3b 0a 74 79 70 65 64 65 66 xSample;.typedef
8f00: 20 73 74 72 75 63 74 20 4b 65 79 43 6c 61 73 73 struct KeyClass
8f10: 20 4b 65 79 43 6c 61 73 73 3b 0a 74 79 70 65 64 KeyClass;.typed
8f20: 65 66 20 73 74 72 75 63 74 20 4b 65 79 49 6e 66 ef struct KeyInf
8f30: 6f 20 4b 65 79 49 6e 66 6f 3b 0a 74 79 70 65 64 o KeyInfo;.typed
8f40: 65 66 20 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 ef struct Lookas
8f50: 69 64 65 20 4c 6f 6f 6b 61 73 69 64 65 3b 0a 74 ide Lookaside;.t
8f60: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 4c 6f ypedef struct Lo
8f70: 6f 6b 61 73 69 64 65 53 6c 6f 74 20 4c 6f 6f 6b okasideSlot Look
8f80: 61 73 69 64 65 53 6c 6f 74 3b 0a 74 79 70 65 64 asideSlot;.typed
8f90: 65 66 20 73 74 72 75 63 74 20 4d 6f 64 75 6c 65 ef struct Module
8fa0: 20 4d 6f 64 75 6c 65 3b 0a 74 79 70 65 64 65 66 Module;.typedef
8fb0: 20 73 74 72 75 63 74 20 4e 61 6d 65 43 6f 6e 74 struct NameCont
8fc0: 65 78 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 3b ext NameContext;
8fd0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8fe0: 50 61 72 73 65 20 50 61 72 73 65 3b 0a 74 79 70 Parse Parse;.typ
8ff0: 65 64 65 66 20 73 74 72 75 63 74 20 50 72 65 55 edef struct PreU
9000: 70 64 61 74 65 20 50 72 65 55 70 64 61 74 65 3b pdate PreUpdate;
9010: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
9020: 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 PrintfArguments
9030: 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 73 3b PrintfArguments;
9040: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
9050: 52 65 6e 61 6d 65 54 6f 6b 65 6e 20 52 65 6e 61 RenameToken Rena
9060: 6d 65 54 6f 6b 65 6e 3b 0a 74 79 70 65 64 65 66 meToken;.typedef
9070: 20 73 74 72 75 63 74 20 52 6f 77 53 65 74 20 52 struct RowSet R
9080: 6f 77 53 65 74 3b 0a 74 79 70 65 64 65 66 20 73 owSet;.typedef s
9090: 74 72 75 63 74 20 53 61 76 65 70 6f 69 6e 74 20 truct Savepoint
90a0: 53 61 76 65 70 6f 69 6e 74 3b 0a 74 79 70 65 64 Savepoint;.typed
90b0: 65 66 20 73 74 72 75 63 74 20 53 65 6c 65 63 74 ef struct Select
90c0: 20 53 65 6c 65 63 74 3b 0a 74 79 70 65 64 65 66 Select;.typedef
90d0: 20 73 74 72 75 63 74 20 53 51 4c 69 74 65 54 68 struct SQLiteTh
90e0: 72 65 61 64 20 53 51 4c 69 74 65 54 68 72 65 61 read SQLiteThrea
90f0: 64 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 d;.typedef struc
9100: 74 20 53 65 6c 65 63 74 44 65 73 74 20 53 65 6c t SelectDest Sel
9110: 65 63 74 44 65 73 74 3b 0a 74 79 70 65 64 65 66 ectDest;.typedef
9120: 20 73 74 72 75 63 74 20 53 72 63 4c 69 73 74 20 struct SrcList
9130: 53 72 63 4c 69 73 74 3b 0a 74 79 70 65 64 65 66 SrcList;.typedef
9140: 20 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f struct sqlite3_
9150: 73 74 72 20 53 74 72 41 63 63 75 6d 3b 20 2f 2a str StrAccum; /*
9160: 20 49 6e 74 65 72 6e 61 6c 20 61 6c 69 61 73 20 Internal alias
9170: 66 6f 72 20 73 71 6c 69 74 65 33 5f 73 74 72 20 for sqlite3_str
9180: 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 */.typedef struc
9190: 74 20 54 61 62 6c 65 20 54 61 62 6c 65 3b 0a 74 t Table Table;.t
91a0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 54 61 ypedef struct Ta
91b0: 62 6c 65 4c 6f 63 6b 20 54 61 62 6c 65 4c 6f 63 bleLock TableLoc
91c0: 6b 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 k;.typedef struc
91d0: 74 20 54 6f 6b 65 6e 20 54 6f 6b 65 6e 3b 0a 74 t Token Token;.t
91e0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 54 72 ypedef struct Tr
91f0: 65 65 56 69 65 77 20 54 72 65 65 56 69 65 77 3b eeView TreeView;
9200: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
9210: 54 72 69 67 67 65 72 20 54 72 69 67 67 65 72 3b Trigger Trigger;
9220: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
9230: 54 72 69 67 67 65 72 50 72 67 20 54 72 69 67 67 TriggerPrg Trigg
9240: 65 72 50 72 67 3b 0a 74 79 70 65 64 65 66 20 73 erPrg;.typedef s
9250: 74 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 truct TriggerSte
9260: 70 20 54 72 69 67 67 65 72 53 74 65 70 3b 0a 74 p TriggerStep;.t
9270: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 55 6e ypedef struct Un
9280: 70 61 63 6b 65 64 52 65 63 6f 72 64 20 55 6e 70 packedRecord Unp
9290: 61 63 6b 65 64 52 65 63 6f 72 64 3b 0a 74 79 70 ackedRecord;.typ
92a0: 65 64 65 66 20 73 74 72 75 63 74 20 55 70 73 65 edef struct Upse
92b0: 72 74 20 55 70 73 65 72 74 3b 0a 74 79 70 65 64 rt Upsert;.typed
92c0: 65 66 20 73 74 72 75 63 74 20 56 54 61 62 6c 65 ef struct VTable
92d0: 20 56 54 61 62 6c 65 3b 0a 74 79 70 65 64 65 66 VTable;.typedef
92e0: 20 73 74 72 75 63 74 20 56 74 61 62 43 74 78 20 struct VtabCtx
92f0: 56 74 61 62 43 74 78 3b 0a 74 79 70 65 64 65 66 VtabCtx;.typedef
9300: 20 73 74 72 75 63 74 20 57 61 6c 6b 65 72 20 57 struct Walker W
9310: 61 6c 6b 65 72 3b 0a 74 79 70 65 64 65 66 20 73 alker;.typedef s
9320: 74 72 75 63 74 20 57 68 65 72 65 49 6e 66 6f 20 truct WhereInfo
9330: 57 68 65 72 65 49 6e 66 6f 3b 0a 74 79 70 65 64 WhereInfo;.typed
9340: 65 66 20 73 74 72 75 63 74 20 57 69 6e 64 6f 77 ef struct Window
9350: 20 57 69 6e 64 6f 77 3b 0a 74 79 70 65 64 65 66 Window;.typedef
9360: 20 73 74 72 75 63 74 20 57 69 74 68 20 57 69 74 struct With Wit
9370: 68 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 62 h;.../*.** The b
9380: 69 74 6d 61 73 6b 20 64 61 74 61 74 79 70 65 20 itmask datatype
9390: 64 65 66 69 6e 65 64 20 62 65 6c 6f 77 20 69 73 defined below is
93a0: 20 75 73 65 64 20 66 6f 72 20 76 61 72 69 6f 75 used for variou
93b0: 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 2e s optimizations.
93c0: 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69 6e 67 20 .**.** Changing
93d0: 74 68 69 73 20 66 72 6f 6d 20 61 20 36 34 2d 62 this from a 64-b
93e0: 69 74 20 74 6f 20 61 20 33 32 2d 62 69 74 20 74 it to a 32-bit t
93f0: 79 70 65 20 6c 69 6d 69 74 73 20 74 68 65 20 6e ype limits the n
9400: 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 74 61 62 6c umber of.** tabl
9410: 65 73 20 69 6e 20 61 20 6a 6f 69 6e 20 74 6f 20 es in a join to
9420: 33 32 20 69 6e 73 74 65 61 64 20 6f 66 20 36 34 32 instead of 64
9430: 2e 20 20 42 75 74 20 69 74 20 61 6c 73 6f 20 72 . But it also r
9440: 65 64 75 63 65 73 20 74 68 65 20 73 69 7a 65 0a educes the size.
9450: 2a 2a 20 6f 66 20 74 68 65 20 6c 69 62 72 61 72 ** of the librar
9460: 79 20 62 79 20 37 33 38 20 62 79 74 65 73 20 6f y by 738 bytes o
9470: 6e 20 69 78 38 36 2e 0a 2a 2f 0a 23 69 66 64 65 n ix86..*/.#ifde
9480: 66 20 53 51 4c 49 54 45 5f 42 49 54 4d 41 53 4b f SQLITE_BITMASK
9490: 5f 54 59 50 45 0a 20 20 74 79 70 65 64 65 66 20 _TYPE. typedef
94a0: 53 51 4c 49 54 45 5f 42 49 54 4d 41 53 4b 5f 54 SQLITE_BITMASK_T
94b0: 59 50 45 20 42 69 74 6d 61 73 6b 3b 0a 23 65 6c YPE Bitmask;.#el
94c0: 73 65 0a 20 20 74 79 70 65 64 65 66 20 75 36 34 se. typedef u64
94d0: 20 42 69 74 6d 61 73 6b 3b 0a 23 65 6e 64 69 66 Bitmask;.#endif
94e0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 ../*.** The numb
94f0: 65 72 20 6f 66 20 62 69 74 73 20 69 6e 20 61 20 er of bits in a
9500: 42 69 74 6d 61 73 6b 2e 20 20 22 42 4d 53 22 20 Bitmask. "BMS"
9510: 6d 65 61 6e 73 20 22 42 69 74 4d 61 73 6b 20 53 means "BitMask S
9520: 69 7a 65 22 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ize"..*/.#define
9530: 20 42 4d 53 20 20 28 28 69 6e 74 29 28 73 69 7a BMS ((int)(siz
9540: 65 6f 66 28 42 69 74 6d 61 73 6b 29 2a 38 29 29 eof(Bitmask)*8))
9550: 0a 0a 2f 2a 0a 2a 2a 20 41 20 62 69 74 20 69 6e ../*.** A bit in
9560: 20 61 20 42 69 74 6d 61 73 6b 0a 2a 2f 0a 23 64 a Bitmask.*/.#d
9570: 65 66 69 6e 65 20 4d 41 53 4b 42 49 54 28 6e 29 efine MASKBIT(n)
9580: 20 20 20 28 28 28 42 69 74 6d 61 73 6b 29 31 29 (((Bitmask)1)
9590: 3c 3c 28 6e 29 29 0a 23 64 65 66 69 6e 65 20 4d <<(n)).#define M
95a0: 41 53 4b 42 49 54 33 32 28 6e 29 20 28 28 28 75 ASKBIT32(n) (((u
95b0: 6e 73 69 67 6e 65 64 20 69 6e 74 29 31 29 3c 3c nsigned int)1)<<
95c0: 28 6e 29 29 0a 23 64 65 66 69 6e 65 20 41 4c 4c (n)).#define ALL
95d0: 42 49 54 53 20 20 20 20 20 20 28 28 42 69 74 6d BITS ((Bitm
95e0: 61 73 6b 29 2d 31 29 0a 0a 2f 2a 20 41 20 56 4c ask)-1)../* A VL
95f0: 69 73 74 20 6f 62 6a 65 63 74 20 72 65 63 6f 72 ist object recor
9600: 64 73 20 61 20 6d 61 70 70 69 6e 67 20 62 65 74 ds a mapping bet
9610: 77 65 65 6e 20 70 61 72 61 6d 65 74 65 72 73 2f ween parameters/
9620: 76 61 72 69 61 62 6c 65 73 2f 77 69 6c 64 63 61 variables/wildca
9630: 72 64 73 0a 2a 2a 20 69 6e 20 74 68 65 20 53 51 rds.** in the SQ
9640: 4c 20 73 74 61 74 65 6d 65 6e 74 20 28 73 75 63 L statement (suc
9650: 68 20 61 73 20 24 61 62 63 2c 20 40 70 71 72 2c h as $abc, @pqr,
9660: 20 6f 72 20 3a 78 79 7a 29 20 61 6e 64 20 74 68 or :xyz) and th
9670: 65 20 69 6e 74 65 67 65 72 0a 2a 2a 20 76 61 72 e integer.** var
9680: 69 61 62 6c 65 20 6e 75 6d 62 65 72 20 61 73 73 iable number ass
9690: 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 61 ociated with tha
96a0: 74 20 70 61 72 61 6d 65 74 65 72 2e 20 20 53 65 t parameter. Se
96b0: 65 20 74 68 65 20 66 6f 72 6d 61 74 20 64 65 73 e the format des
96c0: 63 72 69 70 74 69 6f 6e 0a 2a 2a 20 6f 6e 20 74 cription.** on t
96d0: 68 65 20 73 71 6c 69 74 65 33 56 4c 69 73 74 41 he sqlite3VListA
96e0: 64 64 28 29 20 72 6f 75 74 69 6e 65 20 66 6f 72 dd() routine for
96f0: 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 6f more informatio
9700: 6e 2e 20 20 41 20 56 4c 69 73 74 20 69 73 20 72 n. A VList is r
9710: 65 61 6c 6c 79 0a 2a 2a 20 6a 75 73 74 20 61 6e eally.** just an
9720: 20 61 72 72 61 79 20 6f 66 20 69 6e 74 65 67 65 array of intege
9730: 72 73 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 69 rs..*/.typedef i
9740: 6e 74 20 56 4c 69 73 74 3b 0a 0a 2f 2a 0a 2a 2a nt VList;../*.**
9750: 20 44 65 66 65 72 20 73 6f 75 72 63 69 6e 67 20 Defer sourcing
9760: 76 64 62 65 2e 68 20 61 6e 64 20 62 74 72 65 65 vdbe.h and btree
9770: 2e 68 20 75 6e 74 69 6c 20 61 66 74 65 72 20 74 .h until after t
9780: 68 65 20 22 75 38 22 20 61 6e 64 0a 2a 2a 20 22 he "u8" and.** "
9790: 42 75 73 79 48 61 6e 64 6c 65 72 22 20 74 79 70 BusyHandler" typ
97a0: 65 64 65 66 73 2e 20 76 64 62 65 2e 68 20 61 6c edefs. vdbe.h al
97b0: 73 6f 20 72 65 71 75 69 72 65 73 20 61 20 66 65 so requires a fe
97c0: 77 20 6f 66 20 74 68 65 20 6f 70 61 71 75 65 0a w of the opaque.
97d0: 2a 2a 20 70 6f 69 6e 74 65 72 20 74 79 70 65 73 ** pointer types
97e0: 20 28 69 2e 65 2e 20 46 75 6e 63 44 65 66 29 20 (i.e. FuncDef)
97f0: 64 65 66 69 6e 65 64 20 61 62 6f 76 65 2e 0a 2a defined above..*
9800: 2f 0a 23 69 6e 63 6c 75 64 65 20 22 62 74 72 65 /.#include "btre
9810: 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 76 e.h".#include "v
9820: 64 62 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 dbe.h".#include
9830: 22 70 61 67 65 72 2e 68 22 0a 23 69 6e 63 6c 75 "pager.h".#inclu
9840: 64 65 20 22 70 63 61 63 68 65 2e 68 22 0a 23 69 de "pcache.h".#i
9850: 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 69 nclude "os.h".#i
9860: 6e 63 6c 75 64 65 20 22 6d 75 74 65 78 2e 68 22 nclude "mutex.h"
9870: 0a 0a 2f 2a 20 54 68 65 20 53 51 4c 49 54 45 5f ../* The SQLITE_
9880: 45 58 54 52 41 5f 44 55 52 41 42 4c 45 20 63 6f EXTRA_DURABLE co
9890: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f mpile-time optio
98a0: 6e 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 68 n used to set th
98b0: 65 20 64 65 66 61 75 6c 74 0a 2a 2a 20 73 79 6e e default.** syn
98c0: 63 68 72 6f 6e 6f 75 73 20 73 65 74 74 69 6e 67 chronous setting
98d0: 20 74 6f 20 45 58 54 52 41 2e 20 20 49 74 20 69 to EXTRA. It i
98e0: 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 75 70 70 s no longer supp
98f0: 6f 72 74 65 64 2e 0a 2a 2f 0a 23 69 66 64 65 66 orted..*/.#ifdef
9900: 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 44 55 SQLITE_EXTRA_DU
9910: 52 41 42 4c 45 0a 23 20 77 61 72 6e 69 6e 67 20 RABLE.# warning
9920: 55 73 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 Use SQLITE_DEFAU
9930: 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 3d 33 LT_SYNCHRONOUS=3
9940: 20 69 6e 73 74 65 61 64 20 6f 66 20 53 51 4c 49 instead of SQLI
9950: 54 45 5f 45 58 54 52 41 5f 44 55 52 41 42 4c 45 TE_EXTRA_DURABLE
9960: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
9970: 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f _DEFAULT_SYNCHRO
9980: 4e 4f 55 53 20 33 0a 23 65 6e 64 69 66 0a 0a 2f NOUS 3.#endif../
9990: 2a 0a 2a 2a 20 44 65 66 61 75 6c 74 20 73 79 6e *.** Default syn
99a0: 63 68 72 6f 6e 6f 75 73 20 6c 65 76 65 6c 73 2e chronous levels.
99b0: 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 .**.** Note that
99c0: 20 28 66 6f 72 20 68 69 73 74 6f 72 63 61 6c 20 (for historcal
99d0: 72 65 61 73 6f 6e 73 29 20 74 68 65 20 50 41 47 reasons) the PAG
99e0: 45 52 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 2a ER_SYNCHRONOUS_*
99f0: 20 6d 61 63 72 6f 73 20 64 69 66 66 65 72 0a 2a macros differ.*
9a00: 2a 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 49 54 * from the SQLIT
9a10: 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 E_DEFAULT_SYNCHR
9a20: 4f 4e 4f 55 53 20 76 61 6c 75 65 20 62 79 20 31 ONOUS value by 1
9a30: 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 ..**.**
9a40: 20 20 50 41 47 45 52 5f 53 59 4e 43 48 52 4f 4e PAGER_SYNCHRON
9a50: 4f 55 53 20 20 20 20 20 20 20 44 45 46 41 55 4c OUS DEFAUL
9a60: 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 0a 2a 2a T_SYNCHRONOUS.**
9a70: 20 20 20 4f 46 46 20 20 20 20 20 20 20 20 20 20 OFF
9a80: 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 1
9a90: 20 20 20 20 20 20 20 20 20 20 20 30 0a 2a 2a 20 0.**
9aa0: 20 20 4e 4f 52 4d 41 4c 20 20 20 20 20 20 20 20 NORMAL
9ab0: 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
9ac0: 20 20 20 20 20 20 20 20 20 20 31 0a 2a 2a 20 20 1.**
9ad0: 20 46 55 4c 4c 20 20 20 20 20 20 20 20 20 20 33 FULL 3
9ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9af0: 20 20 20 20 20 20 20 20 20 32 0a 2a 2a 20 20 20 2.**
9b00: 45 58 54 52 41 20 20 20 20 20 20 20 20 20 34 20 EXTRA 4
9b10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9b20: 20 20 20 20 20 20 20 20 33 0a 2a 2a 0a 2a 2a 20 3.**.**
9b30: 54 68 65 20 22 50 52 41 47 4d 41 20 73 79 6e 63 The "PRAGMA sync
9b40: 68 72 6f 6e 6f 75 73 22 20 73 74 61 74 65 6d 65 hronous" stateme
9b50: 6e 74 20 61 6c 73 6f 20 75 73 65 73 20 74 68 65 nt also uses the
9b60: 20 7a 65 72 6f 2d 62 61 73 65 64 20 6e 75 6d 62 zero-based numb
9b70: 65 72 73 2e 0a 2a 2a 20 49 6e 20 6f 74 68 65 72 ers..** In other
9b80: 20 77 6f 72 64 73 2c 20 74 68 65 20 7a 65 72 6f words, the zero
9b90: 2d 62 61 73 65 64 20 6e 75 6d 62 65 72 73 20 61 -based numbers a
9ba0: 72 65 20 75 73 65 64 20 66 6f 72 20 61 6c 6c 20 re used for all
9bb0: 65 78 74 65 72 6e 61 6c 20 69 6e 74 65 72 66 61 external interfa
9bc0: 63 65 73 0a 2a 2a 20 61 6e 64 20 74 68 65 20 6f ces.** and the o
9bd0: 6e 65 2d 62 61 73 65 64 20 76 61 6c 75 65 73 20 ne-based values
9be0: 61 72 65 20 75 73 65 64 20 69 6e 74 65 72 6e 61 are used interna
9bf0: 6c 6c 79 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 lly..*/.#ifndef
9c00: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 SQLITE_DEFAULT_S
9c10: 59 4e 43 48 52 4f 4e 4f 55 53 0a 23 20 64 65 66 YNCHRONOUS.# def
9c20: 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 ine SQLITE_DEFAU
9c30: 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 32 LT_SYNCHRONOUS 2
9c40: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
9c50: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 SQLITE_DEFAULT_W
9c60: 41 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 0a 23 AL_SYNCHRONOUS.#
9c70: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 define SQLITE_D
9c80: 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 4e 43 48 EFAULT_WAL_SYNCH
9c90: 52 4f 4e 4f 55 53 20 53 51 4c 49 54 45 5f 44 45 RONOUS SQLITE_DE
9ca0: 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 FAULT_SYNCHRONOU
9cb0: 53 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 S.#endif../*.**
9cc0: 45 61 63 68 20 64 61 74 61 62 61 73 65 20 66 69 Each database fi
9cd0: 6c 65 20 74 6f 20 62 65 20 61 63 63 65 73 73 65 le to be accesse
9ce0: 64 20 62 79 20 74 68 65 20 73 79 73 74 65 6d 20 d by the system
9cf0: 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a 2a is an instance.*
9d00: 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 * of the followi
9d10: 6e 67 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 ng structure. T
9d20: 68 65 72 65 20 61 72 65 20 6e 6f 72 6d 61 6c 6c here are normall
9d30: 79 20 74 77 6f 20 6f 66 20 74 68 65 73 65 20 73 y two of these s
9d40: 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 69 6e 20 tructures.** in
9d50: 74 68 65 20 73 71 6c 69 74 65 2e 61 44 62 5b 5d the sqlite.aDb[]
9d60: 20 61 72 72 61 79 2e 20 20 61 44 62 5b 30 5d 20 array. aDb[0]
9d70: 69 73 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 is the main data
9d80: 62 61 73 65 20 66 69 6c 65 20 61 6e 64 0a 2a 2a base file and.**
9d90: 20 61 44 62 5b 31 5d 20 69 73 20 74 68 65 20 64 aDb[1] is the d
9da0: 61 74 61 62 61 73 65 20 66 69 6c 65 20 75 73 65 atabase file use
9db0: 64 20 74 6f 20 68 6f 6c 64 20 74 65 6d 70 6f 72 d to hold tempor
9dc0: 61 72 79 20 74 61 62 6c 65 73 2e 20 20 41 64 64 ary tables. Add
9dd0: 69 74 69 6f 6e 61 6c 0a 2a 2a 20 64 61 74 61 62 itional.** datab
9de0: 61 73 65 73 20 6d 61 79 20 62 65 20 61 74 74 61 ases may be atta
9df0: 63 68 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ched..*/.struct
9e00: 44 62 20 7b 0a 20 20 63 68 61 72 20 2a 7a 44 62 Db {. char *zDb
9e10: 53 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 4e SName; /* N
9e20: 61 6d 65 20 6f 66 20 74 68 69 73 20 64 61 74 61 ame of this data
9e30: 62 61 73 65 2e 20 28 73 63 68 65 6d 61 20 6e 61 base. (schema na
9e40: 6d 65 2c 20 6e 6f 74 20 66 69 6c 65 6e 61 6d 65 me, not filename
9e50: 29 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 42 ) */. Btree *pB
9e60: 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 t; /* T
9e70: 68 65 20 42 2a 54 72 65 65 20 73 74 72 75 63 74 he B*Tree struct
9e80: 75 72 65 20 66 6f 72 20 74 68 69 73 20 64 61 74 ure for this dat
9e90: 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
9ea0: 75 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 3b u8 safety_level;
9eb0: 20 20 20 20 20 2f 2a 20 48 6f 77 20 61 67 67 72 /* How aggr
9ec0: 65 73 73 69 76 65 20 61 74 20 73 79 6e 63 69 6e essive at syncin
9ed0: 67 20 64 61 74 61 20 74 6f 20 64 69 73 6b 20 2a g data to disk *
9ee0: 2f 0a 20 20 75 38 20 62 53 79 6e 63 53 65 74 3b /. u8 bSyncSet;
9ef0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
9f00: 20 69 66 20 22 50 52 41 47 4d 41 20 73 79 6e 63 if "PRAGMA sync
9f10: 68 72 6f 6e 6f 75 73 3d 4e 22 20 68 61 73 20 62 hronous=N" has b
9f20: 65 65 6e 20 72 75 6e 20 2a 2f 0a 20 20 53 63 68 een run */. Sch
9f30: 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 20 ema *pSchema;
9f40: 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
9f50: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 database schema
9f60: 28 70 6f 73 73 69 62 6c 79 20 73 68 61 72 65 64 (possibly shared
9f70: 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 ) */.};../*.** A
9f80: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
9f90: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 e following stru
9fa0: 63 74 75 72 65 20 73 74 6f 72 65 73 20 61 20 64 cture stores a d
9fb0: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 0a atabase schema..
9fc0: 2a 2a 0a 2a 2a 20 4d 6f 73 74 20 53 63 68 65 6d **.** Most Schem
9fd0: 61 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 73 a objects are as
9fe0: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 sociated with a
9ff0: 42 74 72 65 65 2e 20 20 54 68 65 20 65 78 63 65 Btree. The exce
a000: 70 74 69 6f 6e 20 69 73 0a 2a 2a 20 74 68 65 20 ption is.** the
a010: 53 63 68 65 6d 61 20 66 6f 72 20 74 68 65 20 54 Schema for the T
a020: 45 4d 50 20 64 61 74 61 62 61 65 73 20 28 73 71 EMP databaes (sq
a030: 6c 69 74 65 33 2e 61 44 62 5b 31 5d 29 20 77 68 lite3.aDb[1]) wh
a040: 69 63 68 20 69 73 20 66 72 65 65 2d 73 74 61 6e ich is free-stan
a050: 64 69 6e 67 2e 0a 2a 2a 20 49 6e 20 73 68 61 72 ding..** In shar
a060: 65 64 20 63 61 63 68 65 20 6d 6f 64 65 2c 20 61 ed cache mode, a
a070: 20 73 69 6e 67 6c 65 20 53 63 68 65 6d 61 20 6f single Schema o
a080: 62 6a 65 63 74 20 63 61 6e 20 62 65 20 73 68 61 bject can be sha
a090: 72 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 0a red by multiple.
a0a0: 2a 2a 20 42 74 72 65 65 73 20 74 68 61 74 20 72 ** Btrees that r
a0b0: 65 66 65 72 20 74 6f 20 74 68 65 20 73 61 6d 65 efer to the same
a0c0: 20 75 6e 64 65 72 6c 79 69 6e 67 20 42 74 53 68 underlying BtSh
a0d0: 61 72 65 64 20 6f 62 6a 65 63 74 2e 0a 2a 2a 0a ared object..**.
a0e0: 2a 2a 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 74 ** Schema object
a0f0: 73 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61 s are automatica
a100: 6c 6c 79 20 64 65 61 6c 6c 6f 63 61 74 65 64 20 lly deallocated
a110: 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 42 74 when the last Bt
a120: 72 65 65 20 74 68 61 74 0a 2a 2a 20 72 65 66 65 ree that.** refe
a130: 72 65 6e 63 65 73 20 74 68 65 6d 20 69 73 20 64 rences them is d
a140: 65 73 74 72 6f 79 65 64 2e 20 20 20 54 68 65 20 estroyed. The
a150: 54 45 4d 50 20 53 63 68 65 6d 61 20 69 73 20 6d TEMP Schema is m
a160: 61 6e 75 61 6c 6c 79 20 66 72 65 65 64 20 62 79 anually freed by
a170: 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6c 6f 73 .** sqlite3_clos
a180: 65 28 29 2e 0a 2a 0a 2a 2a 20 41 20 74 68 72 65 e()..*.** A thre
a190: 61 64 20 6d 75 73 74 20 62 65 20 68 6f 6c 64 69 ad must be holdi
a1a0: 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 68 ng a mutex on th
a1b0: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 e corresponding
a1c0: 42 74 72 65 65 20 69 6e 20 6f 72 64 65 72 0a 2a Btree in order.*
a1d0: 2a 20 74 6f 20 61 63 63 65 73 73 20 53 63 68 65 * to access Sche
a1e0: 6d 61 20 63 6f 6e 74 65 6e 74 2e 20 20 54 68 69 ma content. Thi
a1f0: 73 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 74 s implies that t
a200: 68 65 20 74 68 72 65 61 64 20 6d 75 73 74 20 61 he thread must a
a210: 6c 73 6f 20 62 65 0a 2a 2a 20 68 6f 6c 64 69 6e lso be.** holdin
a220: 67 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 68 65 g a mutex on the
a230: 20 73 71 6c 69 74 65 33 20 63 6f 6e 6e 65 63 74 sqlite3 connect
a240: 69 6f 6e 20 70 6f 69 6e 74 65 72 20 74 68 61 74 ion pointer that
a250: 20 6f 77 6e 73 20 74 68 65 20 42 74 72 65 65 2e owns the Btree.
a260: 0a 2a 2a 20 46 6f 72 20 61 20 54 45 4d 50 20 53 .** For a TEMP S
a270: 63 68 65 6d 61 2c 20 6f 6e 6c 79 20 74 68 65 20 chema, only the
a280: 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 74 65 78 connection mutex
a290: 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 2a 2f is required..*/
a2a0: 0a 73 74 72 75 63 74 20 53 63 68 65 6d 61 20 7b .struct Schema {
a2b0: 0a 20 20 69 6e 74 20 73 63 68 65 6d 61 5f 63 6f . int schema_co
a2c0: 6f 6b 69 65 3b 20 20 20 2f 2a 20 44 61 74 61 62 okie; /* Datab
a2d0: 61 73 65 20 73 63 68 65 6d 61 20 76 65 72 73 69 ase schema versi
a2e0: 6f 6e 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 on number for th
a2f0: 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e 74 is file */. int
a300: 20 69 47 65 6e 65 72 61 74 69 6f 6e 3b 20 20 20 iGeneration;
a310: 20 20 2f 2a 20 47 65 6e 65 72 61 74 69 6f 6e 20 /* Generation
a320: 63 6f 75 6e 74 65 72 2e 20 20 49 6e 63 72 65 6d counter. Increm
a330: 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68 20 ented with each
a340: 63 68 61 6e 67 65 20 2a 2f 0a 20 20 48 61 73 68 change */. Hash
a350: 20 74 62 6c 48 61 73 68 3b 20 20 20 20 20 20 20 tblHash;
a360: 20 2f 2a 20 41 6c 6c 20 74 61 62 6c 65 73 20 69 /* All tables i
a370: 6e 64 65 78 65 64 20 62 79 20 6e 61 6d 65 20 2a ndexed by name *
a380: 2f 0a 20 20 48 61 73 68 20 69 64 78 48 61 73 68 /. Hash idxHash
a390: 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 ; /* All
a3a0: 28 6e 61 6d 65 64 29 20 69 6e 64 69 63 65 73 20 (named) indices
a3b0: 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d 65 20 indexed by name
a3c0: 2a 2f 0a 20 20 48 61 73 68 20 74 72 69 67 48 61 */. Hash trigHa
a3d0: 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c sh; /* All
a3e0: 20 74 72 69 67 67 65 72 73 20 69 6e 64 65 78 65 triggers indexe
a3f0: 64 20 62 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 d by name */. H
a400: 61 73 68 20 66 6b 65 79 48 61 73 68 3b 20 20 20 ash fkeyHash;
a410: 20 20 20 20 2f 2a 20 41 6c 6c 20 66 6f 72 65 69 /* All forei
a420: 67 6e 20 6b 65 79 73 20 62 79 20 72 65 66 65 72 gn keys by refer
a430: 65 6e 63 65 64 20 74 61 62 6c 65 20 6e 61 6d 65 enced table name
a440: 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 53 65 */. Table *pSe
a450: 71 54 61 62 3b 20 20 20 20 20 20 2f 2a 20 54 68 qTab; /* Th
a460: 65 20 73 71 6c 69 74 65 5f 73 65 71 75 65 6e 63 e sqlite_sequenc
a470: 65 20 74 61 62 6c 65 20 75 73 65 64 20 62 79 20 e table used by
a480: 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 20 2a 2f AUTOINCREMENT */
a490: 0a 20 20 75 38 20 66 69 6c 65 5f 66 6f 72 6d 61 . u8 file_forma
a4a0: 74 3b 20 20 20 20 20 20 2f 2a 20 53 63 68 65 6d t; /* Schem
a4b0: 61 20 66 6f 72 6d 61 74 20 76 65 72 73 69 6f 6e a format version
a4c0: 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 20 2a for this file *
a4d0: 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 20 20 /. u8 enc;
a4e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 /* Text
a4f0: 20 65 6e 63 6f 64 69 6e 67 20 75 73 65 64 20 62 encoding used b
a500: 79 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 y this database
a510: 2a 2f 0a 20 20 75 31 36 20 73 63 68 65 6d 61 46 */. u16 schemaF
a520: 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 46 6c 61 lags; /* Fla
a530: 67 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 gs associated wi
a540: 74 68 20 74 68 69 73 20 73 63 68 65 6d 61 20 2a th this schema *
a550: 2f 0a 20 20 69 6e 74 20 63 61 63 68 65 5f 73 69 /. int cache_si
a560: 7a 65 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 ze; /* Numb
a570: 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20 75 er of pages to u
a580: 73 65 20 69 6e 20 74 68 65 20 63 61 63 68 65 20 se in the cache
a590: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 */.};../*.** The
a5a0: 73 65 20 6d 61 63 72 6f 73 20 63 61 6e 20 62 65 se macros can be
a5b0: 20 75 73 65 64 20 74 6f 20 74 65 73 74 2c 20 73 used to test, s
a5c0: 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 62 69 74 et, or clear bit
a5d0: 73 20 69 6e 20 74 68 65 0a 2a 2a 20 44 62 2e 70 s in the.** Db.p
a5e0: 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 20 66 69 Schema->flags fi
a5f0: 65 6c 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 eld..*/.#define
a600: 44 62 48 61 73 50 72 6f 70 65 72 74 79 28 44 2c DbHasProperty(D,
a610: 49 2c 50 29 20 20 20 20 20 28 28 28 44 29 2d 3e I,P) (((D)->
a620: 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d 3e aDb[I].pSchema->
a630: 73 63 68 65 6d 61 46 6c 61 67 73 26 28 50 29 29 schemaFlags&(P))
a640: 3d 3d 28 50 29 29 0a 23 64 65 66 69 6e 65 20 44 ==(P)).#define D
a650: 62 48 61 73 41 6e 79 50 72 6f 70 65 72 74 79 28 bHasAnyProperty(
a660: 44 2c 49 2c 50 29 20 20 28 28 28 44 29 2d 3e 61 D,I,P) (((D)->a
a670: 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d 3e 73 Db[I].pSchema->s
a680: 63 68 65 6d 61 46 6c 61 67 73 26 28 50 29 29 21 chemaFlags&(P))!
a690: 3d 30 29 0a 23 64 65 66 69 6e 65 20 44 62 53 65 =0).#define DbSe
a6a0: 74 50 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 tProperty(D,I,P)
a6b0: 20 20 20 20 20 28 44 29 2d 3e 61 44 62 5b 49 5d (D)->aDb[I]
a6c0: 2e 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 .pSchema->schema
a6d0: 46 6c 61 67 73 7c 3d 28 50 29 0a 23 64 65 66 69 Flags|=(P).#defi
a6e0: 6e 65 20 44 62 43 6c 65 61 72 50 72 6f 70 65 72 ne DbClearProper
a6f0: 74 79 28 44 2c 49 2c 50 29 20 20 20 28 44 29 2d ty(D,I,P) (D)-
a700: 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d >aDb[I].pSchema-
a710: 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 3d 7e 28 >schemaFlags&=~(
a720: 50 29 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 P)../*.** Allowe
a730: 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 d values for the
a740: 20 44 42 2e 70 53 63 68 65 6d 61 2d 3e 66 6c 61 DB.pSchema->fla
a750: 67 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 gs field..**.**
a760: 54 68 65 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 The DB_SchemaLoa
a770: 64 65 64 20 66 6c 61 67 20 69 73 20 73 65 74 20 ded flag is set
a780: 61 66 74 65 72 20 74 68 65 20 64 61 74 61 62 61 after the databa
a790: 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 62 65 se schema has be
a7a0: 65 6e 0a 2a 2a 20 72 65 61 64 20 69 6e 74 6f 20 en.** read into
a7b0: 69 6e 74 65 72 6e 61 6c 20 68 61 73 68 20 74 61 internal hash ta
a7c0: 62 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 44 42 5f 55 bles..**.** DB_U
a7d0: 6e 72 65 73 65 74 56 69 65 77 73 20 6d 65 61 6e nresetViews mean
a7e0: 73 20 74 68 61 74 20 6f 6e 65 20 6f 72 20 6d 6f s that one or mo
a7f0: 72 65 20 76 69 65 77 73 20 68 61 76 65 20 63 6f re views have co
a800: 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 68 61 74 0a lumn names that.
a810: 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 66 69 6c ** have been fil
a820: 6c 65 64 20 6f 75 74 2e 20 20 49 66 20 74 68 65 led out. If the
a830: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 2c schema changes,
a840: 20 74 68 65 73 65 20 63 6f 6c 75 6d 6e 20 6e 61 these column na
a850: 6d 65 73 20 6d 69 67 68 74 0a 2a 2a 20 63 68 61 mes might.** cha
a860: 6e 67 65 73 20 61 6e 64 20 73 6f 20 74 68 65 20 nges and so the
a870: 76 69 65 77 20 77 69 6c 6c 20 6e 65 65 64 20 74 view will need t
a880: 6f 20 62 65 20 72 65 73 65 74 2e 0a 2a 2f 0a 23 o be reset..*/.#
a890: 64 65 66 69 6e 65 20 44 42 5f 53 63 68 65 6d 61 define DB_Schema
a8a0: 4c 6f 61 64 65 64 20 20 20 20 30 78 30 30 30 31 Loaded 0x0001
a8b0: 20 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 61 20 /* The schema
a8c0: 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 has been loaded
a8d0: 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 55 6e */.#define DB_Un
a8e0: 72 65 73 65 74 56 69 65 77 73 20 20 20 20 30 78 resetViews 0x
a8f0: 30 30 30 32 20 20 2f 2a 20 53 6f 6d 65 20 76 69 0002 /* Some vi
a900: 65 77 73 20 68 61 76 65 20 64 65 66 69 6e 65 64 ews have defined
a910: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 2a 2f column names */
a920: 0a 23 64 65 66 69 6e 65 20 44 42 5f 45 6d 70 74 .#define DB_Empt
a930: 79 20 20 20 20 20 20 20 20 20 20 20 30 78 30 30 y 0x00
a940: 30 34 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 04 /* The file
a950: 69 73 20 65 6d 70 74 79 20 28 6c 65 6e 67 74 68 is empty (length
a960: 20 30 20 62 79 74 65 73 29 20 2a 2f 0a 23 64 65 0 bytes) */.#de
a970: 66 69 6e 65 20 44 42 5f 52 65 73 65 74 57 61 6e fine DB_ResetWan
a980: 74 65 64 20 20 20 20 20 30 78 30 30 30 38 20 20 ted 0x0008
a990: 2f 2a 20 52 65 73 65 74 20 74 68 65 20 73 63 68 /* Reset the sch
a9a0: 65 6d 61 20 77 68 65 6e 20 6e 53 63 68 65 6d 61 ema when nSchema
a9b0: 4c 6f 63 6b 3d 3d 30 20 2a 2f 0a 0a 2f 2a 0a 2a Lock==0 */../*.*
a9c0: 2a 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 * The number of
a9d0: 64 69 66 66 65 72 65 6e 74 20 6b 69 6e 64 73 20 different kinds
a9e0: 6f 66 20 74 68 69 6e 67 73 20 74 68 61 74 20 63 of things that c
a9f0: 61 6e 20 62 65 20 6c 69 6d 69 74 65 64 0a 2a 2a an be limited.**
aa00: 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 using the sqlit
aa10: 65 33 5f 6c 69 6d 69 74 28 29 20 69 6e 74 65 72 e3_limit() inter
aa20: 66 61 63 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 face..*/.#define
aa30: 20 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 20 SQLITE_N_LIMIT
aa40: 28 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 4f (SQLITE_LIMIT_WO
aa50: 52 4b 45 52 5f 54 48 52 45 41 44 53 2b 31 29 0a RKER_THREADS+1).
aa60: 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 69 64 65 ./*.** Lookaside
aa70: 20 6d 61 6c 6c 6f 63 20 69 73 20 61 20 73 65 74 malloc is a set
aa80: 20 6f 66 20 66 69 78 65 64 2d 73 69 7a 65 20 62 of fixed-size b
aa90: 75 66 66 65 72 73 20 74 68 61 74 20 63 61 6e 20 uffers that can
aaa0: 62 65 20 75 73 65 64 0a 2a 2a 20 74 6f 20 73 61 be used.** to sa
aab0: 74 69 73 66 79 20 73 6d 61 6c 6c 20 74 72 61 6e tisfy small tran
aac0: 73 69 65 6e 74 20 6d 65 6d 6f 72 79 20 61 6c 6c sient memory all
aad0: 6f 63 61 74 69 6f 6e 20 72 65 71 75 65 73 74 73 ocation requests
aae0: 20 66 6f 72 20 6f 62 6a 65 63 74 73 0a 2a 2a 20 for objects.**
aaf0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
ab00: 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 a particular dat
ab10: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
ab20: 2e 20 20 54 68 65 20 75 73 65 20 6f 66 0a 2a 2a . The use of.**
ab30: 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f lookaside mallo
ab40: 63 20 70 72 6f 76 69 64 65 73 20 61 20 73 69 67 c provides a sig
ab50: 6e 69 66 69 63 61 6e 74 20 70 65 72 66 6f 72 6d nificant perform
ab60: 61 6e 63 65 20 65 6e 68 61 6e 63 65 6d 65 6e 74 ance enhancement
ab70: 0a 2a 2a 20 28 61 70 70 72 6f 78 20 31 30 25 29 .** (approx 10%)
ab80: 20 62 79 20 61 76 6f 69 64 69 6e 67 20 6e 75 6d by avoiding num
ab90: 65 72 6f 75 73 20 6d 61 6c 6c 6f 63 2f 66 72 65 erous malloc/fre
aba0: 65 20 72 65 71 75 65 73 74 73 20 77 68 69 6c 65 e requests while
abb0: 20 70 61 72 73 69 6e 67 0a 2a 2a 20 53 51 4c 20 parsing.** SQL
abc0: 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a statements..**.*
abd0: 2a 20 54 68 65 20 4c 6f 6f 6b 61 73 69 64 65 20 * The Lookaside
abe0: 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 20 structure holds
abf0: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 6e configuration in
ac00: 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
ac10: 74 68 65 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 the.** lookaside
ac20: 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 malloc subsyste
ac30: 6d 2e 20 20 45 61 63 68 20 61 76 61 69 6c 61 62 m. Each availab
ac40: 6c 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 le memory alloca
ac50: 74 69 6f 6e 20 69 6e 0a 2a 2a 20 74 68 65 20 6c tion in.** the l
ac60: 6f 6f 6b 61 73 69 64 65 20 73 75 62 73 79 73 74 ookaside subsyst
ac70: 65 6d 20 69 73 20 73 74 6f 72 65 64 20 6f 6e 20 em is stored on
ac80: 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 a linked list of
ac90: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 0a 2a LookasideSlot.*
aca0: 2a 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a * objects..**.**
acb0: 20 4c 6f 6f 6b 61 73 69 64 65 20 61 6c 6c 6f 63 Lookaside alloc
acc0: 61 74 69 6f 6e 73 20 61 72 65 20 6f 6e 6c 79 20 ations are only
acd0: 61 6c 6c 6f 77 65 64 20 66 6f 72 20 6f 62 6a 65 allowed for obje
ace0: 63 74 73 20 74 68 61 74 20 61 72 65 20 61 73 73 cts that are ass
acf0: 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 20 ociated.** with
ad00: 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 74 a particular dat
ad10: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
ad20: 2e 20 20 48 65 6e 63 65 2c 20 73 63 68 65 6d 61 . Hence, schema
ad30: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 6e information can
ad40: 6e 6f 74 0a 2a 2a 20 62 65 20 73 74 6f 72 65 64 not.** be stored
ad50: 20 69 6e 20 6c 6f 6f 6b 61 73 69 64 65 20 62 65 in lookaside be
ad60: 63 61 75 73 65 20 69 6e 20 73 68 61 72 65 64 20 cause in shared
ad70: 63 61 63 68 65 20 6d 6f 64 65 20 74 68 65 20 73 cache mode the s
ad80: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f chema informatio
ad90: 6e 0a 2a 2a 20 69 73 20 73 68 61 72 65 64 20 62 n.** is shared b
ada0: 79 20 6d 75 6c 74 69 70 6c 65 20 64 61 74 61 62 y multiple datab
adb0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e ase connections.
adc0: 20 20 54 68 65 72 65 66 6f 72 65 2c 20 77 68 69 Therefore, whi
add0: 6c 65 20 70 61 72 73 69 6e 67 0a 2a 2a 20 73 63 le parsing.** sc
ade0: 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e hema information
adf0: 2c 20 74 68 65 20 4c 6f 6f 6b 61 73 69 64 65 2e , the Lookaside.
ae00: 62 45 6e 61 62 6c 65 64 20 66 6c 61 67 20 69 73 bEnabled flag is
ae10: 20 63 6c 65 61 72 65 64 20 73 6f 20 74 68 61 74 cleared so that
ae20: 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 61 6c .** lookaside al
ae30: 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 20 6e 6f locations are no
ae40: 74 20 75 73 65 64 20 74 6f 20 63 6f 6e 73 74 72 t used to constr
ae50: 75 63 74 20 74 68 65 20 73 63 68 65 6d 61 20 6f uct the schema o
ae60: 62 6a 65 63 74 73 2e 0a 2a 2f 0a 73 74 72 75 63 bjects..*/.struc
ae70: 74 20 4c 6f 6f 6b 61 73 69 64 65 20 7b 0a 20 20 t Lookaside {.
ae80: 75 33 32 20 62 44 69 73 61 62 6c 65 3b 20 20 20 u32 bDisable;
ae90: 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 6c 79 20 /* Only
aea0: 6f 70 65 72 61 74 65 20 74 68 65 20 6c 6f 6f 6b operate the look
aeb0: 61 73 69 64 65 20 77 68 65 6e 20 7a 65 72 6f 20 aside when zero
aec0: 2a 2f 0a 20 20 75 31 36 20 73 7a 3b 20 20 20 20 */. u16 sz;
aed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
aee0: 53 69 7a 65 20 6f 66 20 65 61 63 68 20 62 75 66 Size of each buf
aef0: 66 65 72 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a fer in bytes */.
af00: 20 20 75 38 20 62 4d 61 6c 6c 6f 63 65 64 3b 20 u8 bMalloced;
af10: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
af20: 65 20 69 66 20 70 53 74 61 72 74 20 6f 62 74 61 e if pStart obta
af30: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 ined from sqlite
af40: 33 5f 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 20 20 3_malloc() */.
af50: 75 33 32 20 6e 53 6c 6f 74 3b 20 20 20 20 20 20 u32 nSlot;
af60: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
af70: 72 20 6f 66 20 6c 6f 6f 6b 61 73 69 64 65 20 73 r of lookaside s
af80: 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65 64 20 2a lots allocated *
af90: 2f 0a 20 20 75 33 32 20 61 6e 53 74 61 74 5b 33 /. u32 anStat[3
afa0: 5d 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 30 ]; /* 0
afb0: 3a 20 68 69 74 73 2e 20 20 31 3a 20 73 69 7a 65 : hits. 1: size
afc0: 20 6d 69 73 73 65 73 2e 20 20 32 3a 20 66 75 6c misses. 2: ful
afd0: 6c 20 6d 69 73 73 65 73 20 2a 2f 0a 20 20 4c 6f l misses */. Lo
afe0: 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 49 6e okasideSlot *pIn
aff0: 69 74 3b 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 it; /* List of
b000: 20 62 75 66 66 65 72 73 20 6e 6f 74 20 70 72 65 buffers not pre
b010: 76 69 6f 75 73 6c 79 20 75 73 65 64 20 2a 2f 0a viously used */.
b020: 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 LookasideSlot
b030: 2a 70 46 72 65 65 3b 20 20 20 2f 2a 20 4c 69 73 *pFree; /* Lis
b040: 74 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 t of available b
b050: 75 66 66 65 72 73 20 2a 2f 0a 20 20 76 6f 69 64 uffers */. void
b060: 20 2a 70 53 74 61 72 74 3b 20 20 20 20 20 20 20 *pStart;
b070: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 /* First byt
b080: 65 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 6d e of available m
b090: 65 6d 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 emory space */.
b0a0: 20 76 6f 69 64 20 2a 70 45 6e 64 3b 20 20 20 20 void *pEnd;
b0b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
b0c0: 74 20 62 79 74 65 20 70 61 73 74 20 65 6e 64 20 t byte past end
b0d0: 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 73 70 61 of available spa
b0e0: 63 65 20 2a 2f 0a 7d 3b 0a 73 74 72 75 63 74 20 ce */.};.struct
b0f0: 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 7b 0a LookasideSlot {.
b100: 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 LookasideSlot
b110: 2a 70 4e 65 78 74 3b 20 20 20 20 2f 2a 20 4e 65 *pNext; /* Ne
b120: 78 74 20 62 75 66 66 65 72 20 69 6e 20 74 68 65 xt buffer in the
b130: 20 6c 69 73 74 20 6f 66 20 66 72 65 65 20 62 75 list of free bu
b140: 66 66 65 72 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a ffers */.};../*.
b150: 2a 2a 20 41 20 68 61 73 68 20 74 61 62 6c 65 20 ** A hash table
b160: 66 6f 72 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e for built-in fun
b170: 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e ction definition
b180: 73 2e 20 20 28 41 70 70 6c 69 63 61 74 69 6f 6e s. (Application
b190: 2d 64 65 66 69 6e 65 64 0a 2a 2a 20 66 75 6e 63 -defined.** func
b1a0: 74 69 6f 6e 73 20 75 73 65 20 61 20 72 65 67 75 tions use a regu
b1b0: 6c 61 72 20 74 61 62 6c 65 20 74 61 62 6c 65 20 lar table table
b1c0: 66 72 6f 6d 20 68 61 73 68 2e 68 2e 29 0a 2a 2a from hash.h.).**
b1d0: 0a 2a 2a 20 48 61 73 68 20 65 61 63 68 20 46 75 .** Hash each Fu
b1e0: 6e 63 44 65 66 20 73 74 72 75 63 74 75 72 65 20 ncDef structure
b1f0: 69 6e 74 6f 20 6f 6e 65 20 6f 66 20 74 68 65 20 into one of the
b200: 46 75 6e 63 44 65 66 48 61 73 68 2e 61 5b 5d 20 FuncDefHash.a[]
b210: 73 6c 6f 74 73 2e 0a 2a 2a 20 43 6f 6c 6c 69 73 slots..** Collis
b220: 69 6f 6e 73 20 61 72 65 20 6f 6e 20 74 68 65 20 ions are on the
b230: 46 75 6e 63 44 65 66 2e 75 2e 70 48 61 73 68 20 FuncDef.u.pHash
b240: 63 68 61 69 6e 2e 20 20 55 73 65 20 74 68 65 20 chain. Use the
b250: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 48 41 53 48 SQLITE_FUNC_HASH
b260: 28 29 0a 2a 2a 20 6d 61 63 72 6f 20 74 6f 20 63 ().** macro to c
b270: 6f 6d 70 75 74 65 20 61 20 68 61 73 68 20 6f 6e ompute a hash on
b280: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 6e 61 the function na
b290: 6d 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 me..*/.#define S
b2a0: 51 4c 49 54 45 5f 46 55 4e 43 5f 48 41 53 48 5f QLITE_FUNC_HASH_
b2b0: 53 5a 20 32 33 0a 73 74 72 75 63 74 20 46 75 6e SZ 23.struct Fun
b2c0: 63 44 65 66 48 61 73 68 20 7b 0a 20 20 46 75 6e cDefHash {. Fun
b2d0: 63 44 65 66 20 2a 61 5b 53 51 4c 49 54 45 5f 46 cDef *a[SQLITE_F
b2e0: 55 4e 43 5f 48 41 53 48 5f 53 5a 5d 3b 20 20 20 UNC_HASH_SZ];
b2f0: 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c /* Hash tabl
b300: 65 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 e for functions
b310: 2a 2f 0a 7d 3b 0a 23 64 65 66 69 6e 65 20 53 51 */.};.#define SQ
b320: 4c 49 54 45 5f 46 55 4e 43 5f 48 41 53 48 28 43 LITE_FUNC_HASH(C
b330: 2c 4c 29 20 28 28 28 43 29 2b 28 4c 29 29 25 53 ,L) (((C)+(L))%S
b340: 51 4c 49 54 45 5f 46 55 4e 43 5f 48 41 53 48 5f QLITE_FUNC_HASH_
b350: 53 5a 29 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 SZ)..#ifdef SQLI
b360: 54 45 5f 55 53 45 52 5f 41 55 54 48 45 4e 54 49 TE_USER_AUTHENTI
b370: 43 41 54 49 4f 4e 0a 2f 2a 0a 2a 2a 20 49 6e 66 CATION./*.** Inf
b380: 6f 72 6d 61 74 69 6f 6e 20 68 65 6c 64 20 69 6e ormation held in
b390: 20 74 68 65 20 22 73 71 6c 69 74 65 33 22 20 64 the "sqlite3" d
b3a0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
b3b0: 6f 6e 20 6f 62 6a 65 63 74 20 61 6e 64 20 75 73 on object and us
b3c0: 65 64 0a 2a 2a 20 74 6f 20 6d 61 6e 61 67 65 20 ed.** to manage
b3d0: 75 73 65 72 20 61 75 74 68 65 6e 74 69 63 61 74 user authenticat
b3e0: 69 6f 6e 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 ion..*/.typedef
b3f0: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 75 struct sqlite3_u
b400: 73 65 72 61 75 74 68 20 73 71 6c 69 74 65 33 5f serauth sqlite3_
b410: 75 73 65 72 61 75 74 68 3b 0a 73 74 72 75 63 74 userauth;.struct
b420: 20 73 71 6c 69 74 65 33 5f 75 73 65 72 61 75 74 sqlite3_useraut
b430: 68 20 7b 0a 20 20 75 38 20 61 75 74 68 4c 65 76 h {. u8 authLev
b440: 65 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 el;
b450: 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 61 /* Current a
b460: 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 6c 65 uthentication le
b470: 76 65 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 75 vel */. int nAu
b480: 74 68 50 57 3b 20 20 20 20 20 20 20 20 20 20 20 thPW;
b490: 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
b4a0: 66 20 74 68 65 20 7a 41 75 74 68 50 57 20 69 6e f the zAuthPW in
b4b0: 20 62 79 74 65 73 20 2a 2f 0a 20 20 63 68 61 72 bytes */. char
b4c0: 20 2a 7a 41 75 74 68 50 57 3b 20 20 20 20 20 20 *zAuthPW;
b4d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 73 /* Pas
b4e0: 73 77 6f 72 64 20 75 73 65 64 20 74 6f 20 61 75 sword used to au
b4f0: 74 68 65 6e 74 69 63 61 74 65 20 2a 2f 0a 20 20 thenticate */.
b500: 63 68 61 72 20 2a 7a 41 75 74 68 55 73 65 72 3b char *zAuthUser;
b510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
b520: 20 55 73 65 72 20 6e 61 6d 65 20 75 73 65 64 20 User name used
b530: 74 6f 20 61 75 74 68 65 6e 74 69 63 61 74 65 20 to authenticate
b540: 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 */.};../* Allowe
b550: 64 20 76 61 6c 75 65 73 20 66 6f 72 20 73 71 6c d values for sql
b560: 69 74 65 33 5f 75 73 65 72 61 75 74 68 2e 61 75 ite3_userauth.au
b570: 74 68 4c 65 76 65 6c 20 2a 2f 0a 23 64 65 66 69 thLevel */.#defi
b580: 6e 65 20 55 41 55 54 48 5f 55 6e 6b 6e 6f 77 6e ne UAUTH_Unknown
b590: 20 20 20 20 20 30 20 20 20 20 20 2f 2a 20 41 75 0 /* Au
b5a0: 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 6e 6f 74 thentication not
b5b0: 20 79 65 74 20 63 68 65 63 6b 65 64 20 2a 2f 0a yet checked */.
b5c0: 23 64 65 66 69 6e 65 20 55 41 55 54 48 5f 46 61 #define UAUTH_Fa
b5d0: 69 6c 20 20 20 20 20 20 20 20 31 20 20 20 20 20 il 1
b5e0: 2f 2a 20 55 73 65 72 20 61 75 74 68 65 6e 74 69 /* User authenti
b5f0: 63 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 2a 2f cation failed */
b600: 0a 23 64 65 66 69 6e 65 20 55 41 55 54 48 5f 55 .#define UAUTH_U
b610: 73 65 72 20 20 20 20 20 20 20 20 32 20 20 20 20 ser 2
b620: 20 2f 2a 20 41 75 74 68 65 6e 74 69 63 61 74 65 /* Authenticate
b630: 64 20 61 73 20 61 20 6e 6f 72 6d 61 6c 20 75 73 d as a normal us
b640: 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 41 er */.#define UA
b650: 55 54 48 5f 41 64 6d 69 6e 20 20 20 20 20 20 20 UTH_Admin
b660: 33 20 20 20 20 20 2f 2a 20 41 75 74 68 65 6e 74 3 /* Authent
b670: 69 63 61 74 65 64 20 61 73 20 61 6e 20 61 64 6d icated as an adm
b680: 69 6e 69 73 74 72 61 74 6f 72 20 2a 2f 0a 0a 2f inistrator */../
b690: 2a 20 46 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 * Functions used
b6a0: 20 6f 6e 6c 79 20 62 79 20 75 73 65 72 20 61 75 only by user au
b6b0: 74 68 6f 72 69 7a 61 74 69 6f 6e 20 6c 6f 67 69 thorization logi
b6c0: 63 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 c */.int sqlite3
b6d0: 55 73 65 72 41 75 74 68 54 61 62 6c 65 28 63 6f UserAuthTable(co
b6e0: 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 nst char*);.int
b6f0: 73 71 6c 69 74 65 33 55 73 65 72 41 75 74 68 43 sqlite3UserAuthC
b700: 68 65 63 6b 4c 6f 67 69 6e 28 73 71 6c 69 74 65 heckLogin(sqlite
b710: 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 3*,const char*,u
b720: 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 8*);.void sqlite
b730: 33 55 73 65 72 41 75 74 68 49 6e 69 74 28 73 71 3UserAuthInit(sq
b740: 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 lite3*);.void sq
b750: 6c 69 74 65 33 43 72 79 70 74 46 75 6e 63 28 73 lite3CryptFunc(s
b760: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
b770: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
b780: 65 2a 2a 29 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a e**);..#endif /*
b790: 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 SQLITE_USER_AUT
b7a0: 48 45 4e 54 49 43 41 54 49 4f 4e 20 2a 2f 0a 0a HENTICATION */..
b7b0: 2f 2a 0a 2a 2a 20 74 79 70 65 64 65 66 20 66 6f /*.** typedef fo
b7c0: 72 20 74 68 65 20 61 75 74 68 6f 72 69 7a 61 74 r the authorizat
b7d0: 69 6f 6e 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e ion callback fun
b7e0: 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 64 65 66 ction..*/.#ifdef
b7f0: 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 SQLITE_USER_AUT
b800: 48 45 4e 54 49 43 41 54 49 4f 4e 0a 20 20 74 79 HENTICATION. ty
b810: 70 65 64 65 66 20 69 6e 74 20 28 2a 73 71 6c 69 pedef int (*sqli
b820: 74 65 33 5f 78 61 75 74 68 29 28 76 6f 69 64 2a te3_xauth)(void*
b830: 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a ,int,const char*
b840: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e ,const char*,con
b850: 73 74 20 63 68 61 72 2a 2c 0a 20 20 20 20 20 20 st char*,.
b860: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b870: 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 const c
b880: 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 har*, const char
b890: 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 74 79 70 65 *);.#else. type
b8a0: 64 65 66 20 69 6e 74 20 28 2a 73 71 6c 69 74 65 def int (*sqlite
b8b0: 33 5f 78 61 75 74 68 29 28 76 6f 69 64 2a 2c 69 3_xauth)(void*,i
b8c0: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 nt,const char*,c
b8d0: 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 onst char*,const
b8e0: 20 63 68 61 72 2a 2c 0a 20 20 20 20 20 20 20 20 char*,.
b8f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b900: 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 const cha
b910: 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 r*);.#endif..#if
b920: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
b930: 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a 20 54 _DEPRECATED./* T
b940: 68 69 73 20 69 73 20 61 6e 20 65 78 74 72 61 20 his is an extra
b950: 53 51 4c 49 54 45 5f 54 52 41 43 45 20 6d 61 63 SQLITE_TRACE mac
b960: 72 6f 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 ro that indicate
b970: 73 20 22 6c 65 67 61 63 79 22 20 74 72 61 63 69 s "legacy" traci
b980: 6e 67 0a 2a 2a 20 69 6e 20 74 68 65 20 73 74 79 ng.** in the sty
b990: 6c 65 20 6f 66 20 73 71 6c 69 74 65 33 5f 74 72 le of sqlite3_tr
b9a0: 61 63 65 28 29 0a 2a 2f 0a 23 64 65 66 69 6e 65 ace().*/.#define
b9b0: 20 53 51 4c 49 54 45 5f 54 52 41 43 45 5f 4c 45 SQLITE_TRACE_LE
b9c0: 47 41 43 59 20 20 20 20 20 20 20 20 20 20 30 78 GACY 0x
b9d0: 34 30 20 20 20 20 20 2f 2a 20 55 73 65 20 74 68 40 /* Use th
b9e0: 65 20 6c 65 67 61 63 79 20 78 54 72 61 63 65 20 e legacy xTrace
b9f0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
ba00: 45 5f 54 52 41 43 45 5f 58 50 52 4f 46 49 4c 45 E_TRACE_XPROFILE
ba10: 20 20 20 20 20 20 20 20 30 78 38 30 20 20 20 20 0x80
ba20: 20 2f 2a 20 55 73 65 20 74 68 65 20 6c 65 67 61 /* Use the lega
ba30: 63 79 20 78 50 72 6f 66 69 6c 65 20 2a 2f 0a 23 cy xProfile */.#
ba40: 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 53 51 4c else.#define SQL
ba50: 49 54 45 5f 54 52 41 43 45 5f 4c 45 47 41 43 59 ITE_TRACE_LEGACY
ba60: 20 20 20 20 20 20 20 20 20 20 30 0a 23 64 65 66 0.#def
ba70: 69 6e 65 20 53 51 4c 49 54 45 5f 54 52 41 43 45 ine SQLITE_TRACE
ba80: 5f 58 50 52 4f 46 49 4c 45 20 20 20 20 20 20 20 _XPROFILE
ba90: 20 30 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 0.#endif /* SQL
baa0: 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 ITE_OMIT_DEPRECA
bab0: 54 45 44 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 TED */.#define S
bac0: 51 4c 49 54 45 5f 54 52 41 43 45 5f 4e 4f 4e 4c QLITE_TRACE_NONL
bad0: 45 47 41 43 59 5f 4d 41 53 4b 20 20 30 78 30 66 EGACY_MASK 0x0f
bae0: 20 20 20 20 20 2f 2a 20 4e 6f 72 6d 61 6c 20 66 /* Normal f
baf0: 6c 61 67 73 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 lags */.../*.**
bb00: 45 61 63 68 20 64 61 74 61 62 61 73 65 20 63 6f Each database co
bb10: 6e 6e 65 63 74 69 6f 6e 20 69 73 20 61 6e 20 69 nnection is an i
bb20: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 nstance of the f
bb30: 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
bb40: 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73 71 re..*/.struct sq
bb50: 6c 69 74 65 33 20 7b 0a 20 20 73 71 6c 69 74 65 lite3 {. sqlite
bb60: 33 5f 76 66 73 20 2a 70 56 66 73 3b 20 20 20 20 3_vfs *pVfs;
bb70: 20 20 20 20 20 20 20 20 2f 2a 20 4f 53 20 49 6e /* OS In
bb80: 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 73 74 72 terface */. str
bb90: 75 63 74 20 56 64 62 65 20 2a 70 56 64 62 65 3b uct Vdbe *pVdbe;
bba0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 /* Li
bbb0: 73 74 20 6f 66 20 61 63 74 69 76 65 20 76 69 72 st of active vir
bbc0: 74 75 61 6c 20 6d 61 63 68 69 6e 65 73 20 2a 2f tual machines */
bbd0: 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 44 66 6c . CollSeq *pDfl
bbe0: 74 43 6f 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 tColl;
bbf0: 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 /* The default
bc00: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
bc10: 63 65 20 28 42 49 4e 41 52 59 29 20 2a 2f 0a 20 ce (BINARY) */.
bc20: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a sqlite3_mutex *
bc30: 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 2f mutex; /
bc40: 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 74 * Connection mut
bc50: 65 78 20 2a 2f 0a 20 20 44 62 20 2a 61 44 62 3b ex */. Db *aDb;
bc60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bc70: 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 62 61 63 /* All bac
bc80: 6b 65 6e 64 73 20 2a 2f 0a 20 20 69 6e 74 20 6e kends */. int n
bc90: 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 Db;
bca0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
bcb0: 65 72 20 6f 66 20 62 61 63 6b 65 6e 64 73 20 63 er of backends c
bcc0: 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 urrently in use
bcd0: 2a 2f 0a 20 20 75 33 32 20 6d 44 62 46 6c 61 67 */. u32 mDbFlag
bce0: 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s;
bcf0: 20 20 20 2f 2a 20 66 6c 61 67 73 20 72 65 63 6f /* flags reco
bd00: 72 64 69 6e 67 20 69 6e 74 65 72 6e 61 6c 20 73 rding internal s
bd10: 74 61 74 65 20 2a 2f 0a 20 20 75 36 34 20 66 6c tate */. u64 fl
bd20: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
bd30: 20 20 20 20 20 20 20 20 2f 2a 20 66 6c 61 67 73 /* flags
bd40: 20 73 65 74 74 61 62 6c 65 20 62 79 20 70 72 61 settable by pra
bd50: 67 6d 61 73 2e 20 53 65 65 20 62 65 6c 6f 77 20 gmas. See below
bd60: 2a 2f 0a 20 20 69 36 34 20 6c 61 73 74 52 6f 77 */. i64 lastRow
bd70: 69 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 id;
bd80: 20 20 20 2f 2a 20 52 4f 57 49 44 20 6f 66 20 6d /* ROWID of m
bd90: 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 ost recent inser
bda0: 74 20 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f t (see above) */
bdb0: 0a 20 20 69 36 34 20 73 7a 4d 6d 61 70 3b 20 20 . i64 szMmap;
bdc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bdd0: 20 2f 2a 20 44 65 66 61 75 6c 74 20 6d 6d 61 70 /* Default mmap
bde0: 5f 73 69 7a 65 20 73 65 74 74 69 6e 67 20 2a 2f _size setting */
bdf0: 0a 20 20 75 33 32 20 6e 53 63 68 65 6d 61 4c 6f . u32 nSchemaLo
be00: 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ck;
be10: 20 2f 2a 20 44 6f 20 6e 6f 74 20 72 65 73 65 74 /* Do not reset
be20: 20 74 68 65 20 73 63 68 65 6d 61 20 77 68 65 6e the schema when
be30: 20 6e 6f 6e 2d 7a 65 72 6f 20 2a 2f 0a 20 20 75 non-zero */. u
be40: 6e 73 69 67 6e 65 64 20 69 6e 74 20 6f 70 65 6e nsigned int open
be50: 46 6c 61 67 73 3b 20 20 20 20 20 20 20 2f 2a 20 Flags; /*
be60: 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 6f 20 Flags passed to
be70: 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 sqlite3_vfs.xOpe
be80: 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 65 72 72 n() */. int err
be90: 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 Code;
bea0: 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 74 20 72 /* Most r
beb0: 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65 ecent error code
bec0: 20 28 53 51 4c 49 54 45 5f 2a 29 20 2a 2f 0a 20 (SQLITE_*) */.
bed0: 20 69 6e 74 20 65 72 72 4d 61 73 6b 3b 20 20 20 int errMask;
bee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
bef0: 2a 20 26 20 72 65 73 75 6c 74 20 63 6f 64 65 73 * & result codes
bf00: 20 77 69 74 68 20 74 68 69 73 20 62 65 66 6f 72 with this befor
bf10: 65 20 72 65 74 75 72 6e 69 6e 67 20 2a 2f 0a 20 e returning */.
bf20: 20 69 6e 74 20 69 53 79 73 45 72 72 6e 6f 3b 20 int iSysErrno;
bf30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
bf40: 2a 20 45 72 72 6e 6f 20 76 61 6c 75 65 20 66 72 * Errno value fr
bf50: 6f 6d 20 6c 61 73 74 20 73 79 73 74 65 6d 20 65 om last system e
bf60: 72 72 6f 72 20 2a 2f 0a 20 20 75 31 36 20 64 62 rror */. u16 db
bf70: 4f 70 74 46 6c 61 67 73 3b 20 20 20 20 20 20 20 OptFlags;
bf80: 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 67 73 /* Flags
bf90: 20 74 6f 20 65 6e 61 62 6c 65 2f 64 69 73 61 62 to enable/disab
bfa0: 6c 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 le optimizations
bfb0: 20 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 */. u8 enc;
bfc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bfd0: 20 20 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f /* Text enco
bfe0: 64 69 6e 67 20 2a 2f 0a 20 20 75 38 20 61 75 74 ding */. u8 aut
bff0: 6f 43 6f 6d 6d 69 74 3b 20 20 20 20 20 20 20 20 oCommit;
c000: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 61 /* The a
c010: 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61 67 2e uto-commit flag.
c020: 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 5f 73 74 */. u8 temp_st
c030: 6f 72 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ore;
c040: 20 20 20 20 2f 2a 20 31 3a 20 66 69 6c 65 20 32 /* 1: file 2
c050: 3a 20 6d 65 6d 6f 72 79 20 30 3a 20 64 65 66 61 : memory 0: defa
c060: 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6d 61 6c 6c ult */. u8 mall
c070: 6f 63 46 61 69 6c 65 64 3b 20 20 20 20 20 20 20 ocFailed;
c080: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
c090: 66 20 77 65 20 68 61 76 65 20 73 65 65 6e 20 61 f we have seen a
c0a0: 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 20 malloc failure
c0b0: 2a 2f 0a 20 20 75 38 20 62 42 65 6e 69 67 6e 4d */. u8 bBenignM
c0c0: 61 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20 20 alloc;
c0d0: 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 72 65 71 /* Do not req
c0e0: 75 69 72 65 20 4f 4f 4d 73 20 69 66 20 74 72 75 uire OOMs if tru
c0f0: 65 20 2a 2f 0a 20 20 75 38 20 64 66 6c 74 4c 6f e */. u8 dfltLo
c100: 63 6b 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20 ckMode;
c110: 20 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 /* Default
c120: 6c 6f 63 6b 69 6e 67 2d 6d 6f 64 65 20 66 6f 72 locking-mode for
c130: 20 61 74 74 61 63 68 65 64 20 64 62 73 20 2a 2f attached dbs */
c140: 0a 20 20 73 69 67 6e 65 64 20 63 68 61 72 20 6e . signed char n
c150: 65 78 74 41 75 74 6f 76 61 63 3b 20 20 20 20 20 extAutovac;
c160: 20 2f 2a 20 41 75 74 6f 76 61 63 20 73 65 74 74 /* Autovac sett
c170: 69 6e 67 20 61 66 74 65 72 20 56 41 43 55 55 4d ing after VACUUM
c180: 20 69 66 20 3e 3d 30 20 2a 2f 0a 20 20 75 38 20 if >=0 */. u8
c190: 73 75 70 70 72 65 73 73 45 72 72 3b 20 20 20 20 suppressErr;
c1a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f /* Do
c1b0: 20 6e 6f 74 20 69 73 73 75 65 20 65 72 72 6f 72 not issue error
c1c0: 20 6d 65 73 73 61 67 65 73 20 69 66 20 74 72 75 messages if tru
c1d0: 65 20 2a 2f 0a 20 20 75 38 20 76 74 61 62 4f 6e e */. u8 vtabOn
c1e0: 43 6f 6e 66 6c 69 63 74 3b 20 20 20 20 20 20 20 Conflict;
c1f0: 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f /* Value to
c200: 20 72 65 74 75 72 6e 20 66 6f 72 20 73 33 5f 76 return for s3_v
c210: 74 61 62 5f 6f 6e 5f 63 6f 6e 66 6c 69 63 74 28 tab_on_conflict(
c220: 29 20 2a 2f 0a 20 20 75 38 20 69 73 54 72 61 6e ) */. u8 isTran
c230: 73 61 63 74 69 6f 6e 53 61 76 65 70 6f 69 6e 74 sactionSavepoint
c240: 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 ; /* True if
c250: 74 68 65 20 6f 75 74 65 72 6d 6f 73 74 20 73 61 the outermost sa
c260: 76 65 70 6f 69 6e 74 20 69 73 20 61 20 54 53 20 vepoint is a TS
c270: 2a 2f 0a 20 20 75 38 20 6d 54 72 61 63 65 3b 20 */. u8 mTrace;
c280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c290: 20 20 20 2f 2a 20 7a 65 72 6f 20 6f 72 20 6d 6f /* zero or mo
c2a0: 72 65 20 53 51 4c 49 54 45 5f 54 52 41 43 45 20 re SQLITE_TRACE
c2b0: 66 6c 61 67 73 20 2a 2f 0a 20 20 75 38 20 6e 6f flags */. u8 no
c2c0: 53 68 61 72 65 64 43 61 63 68 65 3b 20 20 20 20 SharedCache;
c2d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
c2e0: 20 69 66 20 6e 6f 20 73 68 61 72 65 64 2d 63 61 if no shared-ca
c2f0: 63 68 65 20 62 61 63 6b 65 6e 64 73 20 2a 2f 0a che backends */.
c300: 20 20 75 38 20 6e 53 71 6c 45 78 65 63 3b 20 20 u8 nSqlExec;
c310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c320: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 65 6e /* Number of pen
c330: 64 69 6e 67 20 4f 50 5f 53 71 6c 45 78 65 63 20 ding OP_SqlExec
c340: 6f 70 63 6f 64 65 73 20 2a 2f 0a 20 20 69 6e 74 opcodes */. int
c350: 20 6e 65 78 74 50 61 67 65 73 69 7a 65 3b 20 20 nextPagesize;
c360: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
c370: 67 65 73 69 7a 65 20 61 66 74 65 72 20 56 41 43 gesize after VAC
c380: 55 55 4d 20 69 66 20 3e 30 20 2a 2f 0a 20 20 75 UUM if >0 */. u
c390: 33 32 20 6d 61 67 69 63 3b 20 20 20 20 20 20 20 32 magic;
c3a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
c3b0: 4d 61 67 69 63 20 6e 75 6d 62 65 72 20 66 6f 72 Magic number for
c3c0: 20 64 65 74 65 63 74 20 6c 69 62 72 61 72 79 20 detect library
c3d0: 6d 69 73 75 73 65 20 2a 2f 0a 20 20 69 6e 74 20 misuse */. int
c3e0: 6e 43 68 61 6e 67 65 3b 20 20 20 20 20 20 20 20 nChange;
c3f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c /* Val
c400: 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 73 ue returned by s
c410: 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 28 29 qlite3_changes()
c420: 20 2a 2f 0a 20 20 69 6e 74 20 6e 54 6f 74 61 6c */. int nTotal
c430: 43 68 61 6e 67 65 3b 20 20 20 20 20 20 20 20 20 Change;
c440: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 /* Value ret
c450: 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33 urned by sqlite3
c460: 5f 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 28 29 _total_changes()
c470: 20 2a 2f 0a 20 20 69 6e 74 20 61 4c 69 6d 69 74 */. int aLimit
c480: 5b 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 5d [SQLITE_N_LIMIT]
c490: 3b 20 20 20 2f 2a 20 4c 69 6d 69 74 73 20 2a 2f ; /* Limits */
c4a0: 0a 20 20 69 6e 74 20 6e 4d 61 78 53 6f 72 74 65 . int nMaxSorte
c4b0: 72 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 20 20 rMmap;
c4c0: 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 73 69 7a 65 /* Maximum size
c4d0: 20 6f 66 20 72 65 67 69 6f 6e 73 20 6d 61 70 70 of regions mapp
c4e0: 65 64 20 62 79 20 73 6f 72 74 65 72 20 2a 2f 0a ed by sorter */.
c4f0: 20 20 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 struct sqlite3
c500: 49 6e 69 74 49 6e 66 6f 20 7b 20 20 20 20 20 20 InitInfo {
c510: 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 /* Information u
c520: 73 65 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 sed during initi
c530: 61 6c 69 7a 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 alization */.
c540: 20 69 6e 74 20 6e 65 77 54 6e 75 6d 3b 20 20 20 int newTnum;
c550: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
c560: 52 6f 6f 74 70 61 67 65 20 6f 66 20 74 61 62 6c Rootpage of tabl
c570: 65 20 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 e being initiali
c580: 7a 65 64 20 2a 2f 0a 20 20 20 20 75 38 20 69 44 zed */. u8 iD
c590: 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b;
c5a0: 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 /* Which
c5b0: 64 62 20 66 69 6c 65 20 69 73 20 62 65 69 6e 67 db file is being
c5c0: 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a initialized */.
c5d0: 20 20 20 20 75 38 20 62 75 73 79 3b 20 20 20 20 u8 busy;
c5e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c5f0: 2f 2a 20 54 52 55 45 20 69 66 20 63 75 72 72 65 /* TRUE if curre
c600: 6e 74 6c 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e ntly initializin
c610: 67 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 g */. unsigne
c620: 64 20 6f 72 70 68 61 6e 54 72 69 67 67 65 72 20 d orphanTrigger
c630: 3a 20 31 3b 20 2f 2a 20 4c 61 73 74 20 73 74 61 : 1; /* Last sta
c640: 74 65 6d 65 6e 74 20 69 73 20 6f 72 70 68 61 6e tement is orphan
c650: 65 64 20 54 45 4d 50 20 74 72 69 67 67 65 72 20 ed TEMP trigger
c660: 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 */. unsigned
c670: 69 6d 70 6f 73 74 65 72 54 61 62 6c 65 20 3a 20 imposterTable :
c680: 31 3b 20 2f 2a 20 42 75 69 6c 64 69 6e 67 20 61 1; /* Building a
c690: 6e 20 69 6d 70 6f 73 74 65 72 20 74 61 62 6c 65 n imposter table
c6a0: 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 */. unsigned
c6b0: 20 72 65 6f 70 65 6e 4d 65 6d 64 62 20 3a 20 31 reopenMemdb : 1
c6c0: 3b 20 20 20 2f 2a 20 41 54 54 41 43 48 20 69 73 ; /* ATTACH is
c6d0: 20 72 65 61 6c 6c 79 20 61 20 72 65 6f 70 65 6e really a reopen
c6e0: 20 75 73 69 6e 67 20 4d 65 6d 44 42 20 2a 2f 0a using MemDB */.
c6f0: 20 20 7d 20 69 6e 69 74 3b 0a 20 20 69 6e 74 20 } init;. int
c700: 6e 56 64 62 65 41 63 74 69 76 65 3b 20 20 20 20 nVdbeActive;
c710: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
c720: 62 65 72 20 6f 66 20 56 44 42 45 73 20 63 75 72 ber of VDBEs cur
c730: 72 65 6e 74 6c 79 20 72 75 6e 6e 69 6e 67 20 2a rently running *
c740: 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 52 65 61 /. int nVdbeRea
c750: 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d;
c760: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 /* Number of a
c770: 63 74 69 76 65 20 56 44 42 45 73 20 74 68 61 74 ctive VDBEs that
c780: 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 2a read or write *
c790: 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 57 72 69 /. int nVdbeWri
c7a0: 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 te;
c7b0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 /* Number of a
c7c0: 63 74 69 76 65 20 56 44 42 45 73 20 74 68 61 74 ctive VDBEs that
c7d0: 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 read and write
c7e0: 2a 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 45 78 */. int nVdbeEx
c7f0: 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ec;
c800: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
c810: 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f 20 nested calls to
c820: 56 64 62 65 45 78 65 63 28 29 20 2a 2f 0a 20 20 VdbeExec() */.
c830: 69 6e 74 20 6e 56 44 65 73 74 72 6f 79 3b 20 20 int nVDestroy;
c840: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c850: 20 4e 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 Number of activ
c860: 65 20 4f 50 5f 56 44 65 73 74 72 6f 79 20 6f 70 e OP_VDestroy op
c870: 65 72 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e erations */. in
c880: 74 20 6e 45 78 74 65 6e 73 69 6f 6e 3b 20 20 20 t nExtension;
c890: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
c8a0: 75 6d 62 65 72 20 6f 66 20 6c 6f 61 64 65 64 20 umber of loaded
c8b0: 65 78 74 65 6e 73 69 6f 6e 73 20 2a 2f 0a 20 20 extensions */.
c8c0: 76 6f 69 64 20 2a 2a 61 45 78 74 65 6e 73 69 6f void **aExtensio
c8d0: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a n; /*
c8e0: 20 41 72 72 61 79 20 6f 66 20 73 68 61 72 65 64 Array of shared
c8f0: 20 6c 69 62 72 61 72 79 20 68 61 6e 64 6c 65 73 library handles
c900: 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 54 72 61 */. int (*xTra
c910: 63 65 29 28 75 33 32 2c 76 6f 69 64 2a 2c 76 6f ce)(u32,void*,vo
c920: 69 64 2a 2c 76 6f 69 64 2a 29 3b 20 20 20 20 20 id*,void*);
c930: 2f 2a 20 54 72 61 63 65 20 66 75 6e 63 74 69 6f /* Trace functio
c940: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 54 72 n */. void *pTr
c950: 61 63 65 41 72 67 3b 20 20 20 20 20 20 20 20 20 aceArg;
c960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c970: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
c980: 74 68 65 20 74 72 61 63 65 20 66 75 6e 63 74 69 the trace functi
c990: 6f 6e 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 on */.#ifndef SQ
c9a0: 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 LITE_OMIT_DEPREC
c9b0: 41 54 45 44 0a 20 20 76 6f 69 64 20 28 2a 78 50 ATED. void (*xP
c9c0: 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f rofile)(void*,co
c9d0: 6e 73 74 20 63 68 61 72 2a 2c 75 36 34 29 3b 20 nst char*,u64);
c9e0: 20 2f 2a 20 50 72 6f 66 69 6c 69 6e 67 20 66 75 /* Profiling fu
c9f0: 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 nction */. void
ca00: 20 2a 70 50 72 6f 66 69 6c 65 41 72 67 3b 20 20 *pProfileArg;
ca10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ca20: 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e /* Argumen
ca30: 74 20 74 6f 20 70 72 6f 66 69 6c 65 20 66 75 6e t to profile fun
ca40: 63 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a ction */.#endif.
ca50: 20 20 76 6f 69 64 20 2a 70 43 6f 6d 6d 69 74 41 void *pCommitA
ca60: 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rg;
ca70: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
ca80: 74 6f 20 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 to xCommitCallba
ca90: 63 6b 28 29 20 2a 2f 0a 20 20 69 6e 74 20 28 2a ck() */. int (*
caa0: 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 29 xCommitCallback)
cab0: 28 76 6f 69 64 2a 29 3b 20 20 20 20 2f 2a 20 49 (void*); /* I
cac0: 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 nvoked at every
cad0: 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 commit. */. voi
cae0: 64 20 2a 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b d *pRollbackArg;
caf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
cb00: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 52 * Argument to xR
cb10: 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 ollbackCallback(
cb20: 29 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 52 ) */. void (*xR
cb30: 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 29 ollbackCallback)
cb40: 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 49 6e 76 6f (void*); /* Invo
cb50: 6b 65 64 20 61 74 20 65 76 65 72 79 20 63 6f 6d ked at every com
cb60: 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a mit. */. void *
cb70: 70 55 70 64 61 74 65 41 72 67 3b 0a 20 20 76 6f pUpdateArg;. vo
cb80: 69 64 20 28 2a 78 55 70 64 61 74 65 43 61 6c 6c id (*xUpdateCall
cb90: 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c back)(void*,int,
cba0: 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e const char*,con
cbb0: 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f st char*,sqlite_
cbc0: 69 6e 74 36 34 29 3b 0a 23 69 66 64 65 66 20 53 int64);.#ifdef S
cbd0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 QLITE_ENABLE_PRE
cbe0: 55 50 44 41 54 45 5f 48 4f 4f 4b 0a 20 20 76 6f UPDATE_HOOK. vo
cbf0: 69 64 20 2a 70 50 72 65 55 70 64 61 74 65 41 72 id *pPreUpdateAr
cc00: 67 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 g; /* F
cc10: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f irst argument to
cc20: 20 78 50 72 65 55 70 64 61 74 65 43 61 6c 6c 62 xPreUpdateCallb
cc30: 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a ack */. void (*
cc40: 78 50 72 65 55 70 64 61 74 65 43 61 6c 6c 62 61 xPreUpdateCallba
cc50: 63 6b 29 28 20 20 20 2f 2a 20 52 65 67 69 73 74 ck)( /* Regist
cc60: 65 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 ered using sqlit
cc70: 65 33 5f 70 72 65 75 70 64 61 74 65 5f 68 6f 6f e3_preupdate_hoo
cc80: 6b 28 29 20 2a 2f 0a 20 20 20 20 76 6f 69 64 2a k() */. void*
cc90: 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 68 ,sqlite3*,int,ch
cca0: 61 72 20 63 6f 6e 73 74 2a 2c 63 68 61 72 20 63 ar const*,char c
ccb0: 6f 6e 73 74 2a 2c 73 71 6c 69 74 65 33 5f 69 6e onst*,sqlite3_in
ccc0: 74 36 34 2c 73 71 6c 69 74 65 33 5f 69 6e 74 36 t64,sqlite3_int6
ccd0: 34 0a 20 20 29 3b 0a 20 20 50 72 65 55 70 64 61 4. );. PreUpda
cce0: 74 65 20 2a 70 50 72 65 55 70 64 61 74 65 3b 20 te *pPreUpdate;
ccf0: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 78 /* Contex
cd00: 74 20 66 6f 72 20 61 63 74 69 76 65 20 70 72 65 t for active pre
cd10: 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61 63 6b -update callback
cd20: 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 */.#endif /* SQ
cd30: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 55 LITE_ENABLE_PREU
cd40: 50 44 41 54 45 5f 48 4f 4f 4b 20 2a 2f 0a 23 69 PDATE_HOOK */.#i
cd50: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
cd60: 54 5f 57 41 4c 0a 20 20 69 6e 74 20 28 2a 78 57 T_WAL. int (*xW
cd70: 61 6c 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 alCallback)(void
cd80: 20 2a 2c 20 73 71 6c 69 74 65 33 20 2a 2c 20 63 *, sqlite3 *, c
cd90: 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 6e 74 onst char *, int
cda0: 29 3b 0a 20 20 76 6f 69 64 20 2a 70 57 61 6c 41 );. void *pWalA
cdb0: 72 67 3b 0a 23 65 6e 64 69 66 0a 20 20 76 6f 69 rg;.#endif. voi
cdc0: 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 d(*xCollNeeded)(
cdd0: 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 void*,sqlite3*,i
cde0: 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 nt eTextRep,cons
cdf0: 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 t char*);. void
ce00: 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 29 (*xCollNeeded16)
ce10: 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c (void*,sqlite3*,
ce20: 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e int eTextRep,con
ce30: 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 76 6f 69 st void*);. voi
ce40: 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 d *pCollNeededAr
ce50: 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c g;. sqlite3_val
ce60: 75 65 20 2a 70 45 72 72 3b 20 20 20 20 20 20 20 ue *pErr;
ce70: 20 20 20 2f 2a 20 4d 6f 73 74 20 72 65 63 65 6e /* Most recen
ce80: 74 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 t error message
ce90: 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 */. union {.
cea0: 20 76 6f 6c 61 74 69 6c 65 20 69 6e 74 20 69 73 volatile int is
ceb0: 49 6e 74 65 72 72 75 70 74 65 64 3b 20 2f 2a 20 Interrupted; /*
cec0: 54 72 75 65 20 69 66 20 73 71 6c 69 74 65 33 5f True if sqlite3_
ced0: 69 6e 74 65 72 72 75 70 74 20 68 61 73 20 62 65 interrupt has be
cee0: 65 6e 20 63 61 6c 6c 65 64 20 2a 2f 0a 20 20 20 en called */.
cef0: 20 64 6f 75 62 6c 65 20 6e 6f 74 55 73 65 64 31 double notUsed1
cf00: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
cf10: 53 70 61 63 65 72 20 2a 2f 0a 20 20 7d 20 75 31 Spacer */. } u1
cf20: 3b 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 20 6c 6f ;. Lookaside lo
cf30: 6f 6b 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 okaside;
cf40: 20 20 2f 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 6d /* Lookaside m
cf50: 61 6c 6c 6f 63 20 63 6f 6e 66 69 67 75 72 61 74 alloc configurat
cf60: 69 6f 6e 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ion */.#ifndef S
cf70: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f QLITE_OMIT_AUTHO
cf80: 52 49 5a 41 54 49 4f 4e 0a 20 20 73 71 6c 69 74 RIZATION. sqlit
cf90: 65 33 5f 78 61 75 74 68 20 78 41 75 74 68 3b 20 e3_xauth xAuth;
cfa0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 63 63 65 /* Acce
cfb0: 73 73 20 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e ss authorization
cfc0: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 function */. v
cfd0: 6f 69 64 20 2a 70 41 75 74 68 41 72 67 3b 20 20 oid *pAuthArg;
cfe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
cff0: 31 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 1st argument to
d000: 74 68 65 20 61 63 63 65 73 73 20 61 75 74 68 20 the access auth
d010: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 function */.#end
d020: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
d030: 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 53 5f E_OMIT_PROGRESS_
d040: 43 41 4c 4c 42 41 43 4b 0a 20 20 69 6e 74 20 28 CALLBACK. int (
d050: 2a 78 50 72 6f 67 72 65 73 73 29 28 76 6f 69 64 *xProgress)(void
d060: 20 2a 29 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 *); /* The
d070: 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 progress callbac
d080: 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 50 72 k */. void *pPr
d090: 6f 67 72 65 73 73 41 72 67 3b 20 20 20 20 20 20 ogressArg;
d0a0: 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 /* Argument
d0b0: 20 74 6f 20 74 68 65 20 70 72 6f 67 72 65 73 73 to the progress
d0c0: 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 75 callback */. u
d0d0: 6e 73 69 67 6e 65 64 20 6e 50 72 6f 67 72 65 73 nsigned nProgres
d0e0: 73 4f 70 73 3b 20 20 20 20 20 20 20 20 2f 2a 20 sOps; /*
d0f0: 4e 75 6d 62 65 72 20 6f 66 20 6f 70 63 6f 64 65 Number of opcode
d100: 73 20 66 6f 72 20 70 72 6f 67 72 65 73 73 20 63 s for progress c
d110: 61 6c 6c 62 61 63 6b 20 2a 2f 0a 23 65 6e 64 69 allback */.#endi
d120: 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 f.#ifndef SQLITE
d130: 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
d140: 4c 45 0a 20 20 69 6e 74 20 6e 56 54 72 61 6e 73 LE. int nVTrans
d150: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
d160: 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20 /* Allocated
d170: 73 69 7a 65 20 6f 66 20 61 56 54 72 61 6e 73 20 size of aVTrans
d180: 2a 2f 0a 20 20 48 61 73 68 20 61 4d 6f 64 75 6c */. Hash aModul
d190: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
d1a0: 20 20 20 2f 2a 20 70 6f 70 75 6c 61 74 65 64 20 /* populated
d1b0: 62 79 20 73 71 6c 69 74 65 33 5f 63 72 65 61 74 by sqlite3_creat
d1c0: 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a 20 20 e_module() */.
d1d0: 56 74 61 62 43 74 78 20 2a 70 56 74 61 62 43 74 VtabCtx *pVtabCt
d1e0: 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a x; /*
d1f0: 20 43 6f 6e 74 65 78 74 20 66 6f 72 20 61 63 74 Context for act
d200: 69 76 65 20 76 74 61 62 20 63 6f 6e 6e 65 63 74 ive vtab connect
d210: 2f 63 72 65 61 74 65 20 2a 2f 0a 20 20 56 54 61 /create */. VTa
d220: 62 6c 65 20 2a 2a 61 56 54 72 61 6e 73 3b 20 20 ble **aVTrans;
d230: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 69 /* Vi
d240: 72 74 75 61 6c 20 74 61 62 6c 65 73 20 77 69 74 rtual tables wit
d250: 68 20 6f 70 65 6e 20 74 72 61 6e 73 61 63 74 69 h open transacti
d260: 6f 6e 73 20 2a 2f 0a 20 20 56 54 61 62 6c 65 20 ons */. VTable
d270: 2a 70 44 69 73 63 6f 6e 6e 65 63 74 3b 20 20 20 *pDisconnect;
d280: 20 20 20 20 20 20 20 2f 2a 20 44 69 73 63 6f 6e /* Discon
d290: 6e 65 63 74 20 74 68 65 73 65 20 69 6e 20 6e 65 nect these in ne
d2a0: 78 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 xt sqlite3_prepa
d2b0: 72 65 28 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 re() */.#endif.
d2c0: 20 48 61 73 68 20 61 46 75 6e 63 3b 20 20 20 20 Hash aFunc;
d2d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
d2e0: 2a 20 48 61 73 68 20 74 61 62 6c 65 20 6f 66 20 * Hash table of
d2f0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 66 75 6e 63 74 connection funct
d300: 69 6f 6e 73 20 2a 2f 0a 20 20 48 61 73 68 20 61 ions */. Hash a
d310: 43 6f 6c 6c 53 65 71 3b 20 20 20 20 20 20 20 20 CollSeq;
d320: 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 63 /* All c
d330: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 ollating sequenc
d340: 65 73 20 2a 2f 0a 20 20 42 75 73 79 48 61 6e 64 es */. BusyHand
d350: 6c 65 72 20 62 75 73 79 48 61 6e 64 6c 65 72 3b ler busyHandler;
d360: 20 20 20 20 20 20 2f 2a 20 42 75 73 79 20 63 61 /* Busy ca
d370: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 44 62 20 61 llback */. Db a
d380: 44 62 53 74 61 74 69 63 5b 32 5d 3b 20 20 20 20 DbStatic[2];
d390: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 61 /* Sta
d3a0: 74 69 63 20 73 70 61 63 65 20 66 6f 72 20 74 68 tic space for th
d3b0: 65 20 32 20 64 65 66 61 75 6c 74 20 62 61 63 6b e 2 default back
d3c0: 65 6e 64 73 20 2a 2f 0a 20 20 53 61 76 65 70 6f ends */. Savepo
d3d0: 69 6e 74 20 2a 70 53 61 76 65 70 6f 69 6e 74 3b int *pSavepoint;
d3e0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 /* List
d3f0: 6f 66 20 61 63 74 69 76 65 20 73 61 76 65 70 6f of active savepo
d400: 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 62 75 ints */. int bu
d410: 73 79 54 69 6d 65 6f 75 74 3b 20 20 20 20 20 20 syTimeout;
d420: 20 20 20 20 20 20 20 20 2f 2a 20 42 75 73 79 20 /* Busy
d430: 68 61 6e 64 6c 65 72 20 74 69 6d 65 6f 75 74 2c handler timeout,
d440: 20 69 6e 20 6d 73 65 63 20 2a 2f 0a 20 20 69 6e in msec */. in
d450: 74 20 6e 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 t nSavepoint;
d460: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
d470: 75 6d 62 65 72 20 6f 66 20 6e 6f 6e 2d 74 72 61 umber of non-tra
d480: 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 nsaction savepoi
d490: 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 74 nts */. int nSt
d4a0: 61 74 65 6d 65 6e 74 3b 20 20 20 20 20 20 20 20 atement;
d4b0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
d4c0: 20 6f 66 20 6e 65 73 74 65 64 20 73 74 61 74 65 of nested state
d4d0: 6d 65 6e 74 2d 74 72 61 6e 73 61 63 74 69 6f 6e ment-transaction
d4e0: 73 20 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 s */. i64 nDef
d4f0: 65 72 72 65 64 43 6f 6e 73 3b 20 20 20 20 20 20 erredCons;
d500: 20 20 20 20 20 20 2f 2a 20 4e 65 74 20 64 65 66 /* Net def
d510: 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74 erred constraint
d520: 73 20 74 68 69 73 20 74 72 61 6e 73 61 63 74 69 s this transacti
d530: 6f 6e 2e 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 on. */. i64 nDe
d540: 66 65 72 72 65 64 49 6d 6d 43 6f 6e 73 3b 20 20 ferredImmCons;
d550: 20 20 20 20 20 20 20 2f 2a 20 4e 65 74 20 64 65 /* Net de
d560: 66 65 72 72 65 64 20 69 6d 6d 65 64 69 61 74 65 ferred immediate
d570: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
d580: 20 20 69 6e 74 20 2a 70 6e 42 79 74 65 73 46 72 int *pnBytesFr
d590: 65 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 eed;
d5a0: 2f 2a 20 49 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 /* If not NULL,
d5b0: 69 6e 63 72 65 6d 65 6e 74 20 74 68 69 73 20 69 increment this i
d5c0: 6e 20 44 62 46 72 65 65 28 29 20 2a 2f 0a 23 69 n DbFree() */.#i
d5d0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
d5e0: 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 LE_UNLOCK_NOTIFY
d5f0: 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
d600: 69 6e 67 20 76 61 72 69 61 62 6c 65 73 20 61 72 ing variables ar
d610: 65 20 61 6c 6c 20 70 72 6f 74 65 63 74 65 64 20 e all protected
d620: 62 79 20 74 68 65 20 53 54 41 54 49 43 5f 4d 41 by the STATIC_MA
d630: 53 54 45 52 0a 20 20 2a 2a 20 6d 75 74 65 78 2c STER. ** mutex,
d640: 20 6e 6f 74 20 62 79 20 73 71 6c 69 74 65 33 2e not by sqlite3.
d650: 6d 75 74 65 78 2e 20 54 68 65 79 20 61 72 65 20 mutex. They are
d660: 75 73 65 64 20 62 79 20 63 6f 64 65 20 69 6e 20 used by code in
d670: 6e 6f 74 69 66 79 2e 63 2e 0a 20 20 2a 2a 0a 20 notify.c.. **.
d680: 20 2a 2a 20 57 68 65 6e 20 58 2e 70 55 6e 6c 6f ** When X.pUnlo
d690: 63 6b 43 6f 6e 6e 65 63 74 69 6f 6e 3d 3d 59 2c ckConnection==Y,
d6a0: 20 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 74 that means that
d6b0: 20 58 20 69 73 20 77 61 69 74 69 6e 67 20 66 6f X is waiting fo
d6c0: 72 20 59 20 74 6f 0a 20 20 2a 2a 20 75 6e 6c 6f r Y to. ** unlo
d6d0: 63 6b 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 ck so that it ca
d6e0: 6e 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2a 0a n proceed.. **.
d6f0: 20 20 2a 2a 20 57 68 65 6e 20 58 2e 70 42 6c 6f ** When X.pBlo
d700: 63 6b 69 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3d ckingConnection=
d710: 3d 59 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 74 =Y, that means t
d720: 68 61 74 20 73 6f 6d 65 74 68 69 6e 67 20 74 68 hat something th
d730: 61 74 20 58 20 74 72 69 65 64 0a 20 20 2a 2a 20 at X tried. **
d740: 74 72 69 65 64 20 74 6f 20 64 6f 20 72 65 63 65 tried to do rece
d750: 6e 74 6c 79 20 66 61 69 6c 65 64 20 77 69 74 68 ntly failed with
d760: 20 61 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 an SQLITE_LOCKE
d770: 44 20 65 72 72 6f 72 20 64 75 65 20 74 6f 20 6c D error due to l
d780: 6f 63 6b 73 0a 20 20 2a 2a 20 68 65 6c 64 20 62 ocks. ** held b
d790: 79 20 59 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 y Y.. */. sqli
d7a0: 74 65 33 20 2a 70 42 6c 6f 63 6b 69 6e 67 43 6f te3 *pBlockingCo
d7b0: 6e 6e 65 63 74 69 6f 6e 3b 20 2f 2a 20 43 6f 6e nnection; /* Con
d7c0: 6e 65 63 74 69 6f 6e 20 74 68 61 74 20 63 61 75 nection that cau
d7d0: 73 65 64 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 sed SQLITE_LOCKE
d7e0: 44 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a D */. sqlite3 *
d7f0: 70 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 6f pUnlockConnectio
d800: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 n; /*
d810: 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 77 61 Connection to wa
d820: 74 63 68 20 66 6f 72 20 75 6e 6c 6f 63 6b 20 2a tch for unlock *
d830: 2f 0a 20 20 76 6f 69 64 20 2a 70 55 6e 6c 6f 63 /. void *pUnloc
d840: 6b 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 kArg;
d850: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
d860: 75 6d 65 6e 74 20 74 6f 20 78 55 6e 6c 6f 63 6b ument to xUnlock
d870: 4e 6f 74 69 66 79 20 2a 2f 0a 20 20 76 6f 69 64 Notify */. void
d880: 20 28 2a 78 55 6e 6c 6f 63 6b 4e 6f 74 69 66 79 (*xUnlockNotify
d890: 29 28 76 6f 69 64 20 2a 2a 2c 20 69 6e 74 29 3b )(void **, int);
d8a0: 20 20 2f 2a 20 55 6e 6c 6f 63 6b 20 6e 6f 74 69 /* Unlock noti
d8b0: 66 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 fy callback */.
d8c0: 20 73 71 6c 69 74 65 33 20 2a 70 4e 65 78 74 42 sqlite3 *pNextB
d8d0: 6c 6f 63 6b 65 64 3b 20 20 20 20 20 20 20 20 2f locked; /
d8e0: 2a 20 4e 65 78 74 20 69 6e 20 6c 69 73 74 20 6f * Next in list o
d8f0: 66 20 61 6c 6c 20 62 6c 6f 63 6b 65 64 20 63 6f f all blocked co
d900: 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 23 65 6e nnections */.#en
d910: 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 dif.#ifdef SQLIT
d920: 45 5f 55 53 45 52 5f 41 55 54 48 45 4e 54 49 43 E_USER_AUTHENTIC
d930: 41 54 49 4f 4e 0a 20 20 73 71 6c 69 74 65 33 5f ATION. sqlite3_
d940: 75 73 65 72 61 75 74 68 20 61 75 74 68 3b 20 20 userauth auth;
d950: 20 20 20 20 20 20 2f 2a 20 55 73 65 72 20 61 75 /* User au
d960: 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 69 6e 66 thentication inf
d970: 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 ormation */.#end
d980: 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 6d if.};../*.** A m
d990: 61 63 72 6f 20 74 6f 20 64 69 73 63 6f 76 65 72 acro to discover
d9a0: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66 the encoding of
d9b0: 20 61 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a a database..*/.
d9c0: 23 64 65 66 69 6e 65 20 53 43 48 45 4d 41 5f 45 #define SCHEMA_E
d9d0: 4e 43 28 64 62 29 20 28 28 64 62 29 2d 3e 61 44 NC(db) ((db)->aD
d9e0: 62 5b 30 5d 2e 70 53 63 68 65 6d 61 2d 3e 65 6e b[0].pSchema->en
d9f0: 63 29 0a 23 64 65 66 69 6e 65 20 45 4e 43 28 64 c).#define ENC(d
da00: 62 29 20 20 20 20 20 20 20 20 28 28 64 62 29 2d b) ((db)-
da10: 3e 65 6e 63 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 >enc)../*.** Pos
da20: 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 sible values for
da30: 20 74 68 65 20 73 71 6c 69 74 65 33 2e 66 6c 61 the sqlite3.fla
da40: 67 73 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 gs..**.** Value
da50: 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 65 6e 66 constraints (enf
da60: 6f 72 63 65 64 20 76 69 61 20 61 73 73 65 72 74 orced via assert
da70: 28 29 29 3a 0a 2a 2a 20 20 20 20 20 20 53 51 4c ()):.** SQL
da80: 49 54 45 5f 46 75 6c 6c 46 53 79 6e 63 20 20 20 ITE_FullFSync
da90: 20 20 3d 3d 20 50 41 47 45 52 5f 46 55 4c 4c 46 == PAGER_FULLF
daa0: 53 59 4e 43 0a 2a 2a 20 20 20 20 20 20 53 51 4c SYNC.** SQL
dab0: 49 54 45 5f 43 6b 70 74 46 75 6c 6c 46 53 79 6e ITE_CkptFullFSyn
dac0: 63 20 3d 3d 20 50 41 47 45 52 5f 43 4b 50 54 5f c == PAGER_CKPT_
dad0: 46 55 4c 4c 46 53 59 4e 43 0a 2a 2a 20 20 20 20 FULLFSYNC.**
dae0: 20 20 53 51 4c 49 54 45 5f 43 61 63 68 65 53 70 SQLITE_CacheSp
daf0: 69 6c 6c 20 20 20 20 3d 3d 20 50 41 47 45 52 5f ill == PAGER_
db00: 43 41 43 48 45 5f 53 50 49 4c 4c 0a 2a 2f 0a 23 CACHE_SPILL.*/.#
db10: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 57 72 define SQLITE_Wr
db20: 69 74 65 53 63 68 65 6d 61 20 20 20 20 30 78 30 iteSchema 0x0
db30: 30 30 30 30 30 30 31 20 20 2f 2a 20 4f 4b 20 74 0000001 /* OK t
db40: 6f 20 75 70 64 61 74 65 20 53 51 4c 49 54 45 5f o update SQLITE_
db50: 4d 41 53 54 45 52 20 2a 2f 0a 23 64 65 66 69 6e MASTER */.#defin
db60: 65 20 53 51 4c 49 54 45 5f 4c 65 67 61 63 79 46 e SQLITE_LegacyF
db70: 69 6c 65 46 6d 74 20 20 30 78 30 30 30 30 30 30 ileFmt 0x000000
db80: 30 32 20 20 2f 2a 20 43 72 65 61 74 65 20 6e 65 02 /* Create ne
db90: 77 20 64 61 74 61 62 61 73 65 73 20 69 6e 20 66 w databases in f
dba0: 6f 72 6d 61 74 20 31 20 2a 2f 0a 23 64 65 66 69 ormat 1 */.#defi
dbb0: 6e 65 20 53 51 4c 49 54 45 5f 46 75 6c 6c 43 6f ne SQLITE_FullCo
dbc0: 6c 4e 61 6d 65 73 20 20 20 30 78 30 30 30 30 30 lNames 0x00000
dbd0: 30 30 34 20 20 2f 2a 20 53 68 6f 77 20 66 75 6c 004 /* Show ful
dbe0: 6c 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 6f l column names o
dbf0: 6e 20 53 45 4c 45 43 54 20 2a 2f 0a 23 64 65 66 n SELECT */.#def
dc00: 69 6e 65 20 53 51 4c 49 54 45 5f 46 75 6c 6c 46 ine SQLITE_FullF
dc10: 53 79 6e 63 20 20 20 20 20 20 30 78 30 30 30 30 Sync 0x0000
dc20: 30 30 30 38 20 20 2f 2a 20 55 73 65 20 66 75 6c 0008 /* Use ful
dc30: 6c 20 66 73 79 6e 63 20 6f 6e 20 74 68 65 20 62 l fsync on the b
dc40: 61 63 6b 65 6e 64 20 2a 2f 0a 23 64 65 66 69 6e ackend */.#defin
dc50: 65 20 53 51 4c 49 54 45 5f 43 6b 70 74 46 75 6c e SQLITE_CkptFul
dc60: 6c 46 53 79 6e 63 20 20 30 78 30 30 30 30 30 30 lFSync 0x000000
dc70: 31 30 20 20 2f 2a 20 55 73 65 20 66 75 6c 6c 20 10 /* Use full
dc80: 66 73 79 6e 63 20 66 6f 72 20 63 68 65 63 6b 70 fsync for checkp
dc90: 6f 69 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 oint */.#define
dca0: 53 51 4c 49 54 45 5f 43 61 63 68 65 53 70 69 6c SQLITE_CacheSpil
dcb0: 6c 20 20 20 20 20 30 78 30 30 30 30 30 30 32 30 l 0x00000020
dcc0: 20 20 2f 2a 20 4f 4b 20 74 6f 20 73 70 69 6c 6c /* OK to spill
dcd0: 20 70 61 67 65 72 20 63 61 63 68 65 20 2a 2f 0a pager cache */.
dce0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
dcf0: 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 20 20 30 78 hortColNames 0x
dd00: 30 30 30 30 30 30 34 30 20 20 2f 2a 20 53 68 6f 00000040 /* Sho
dd10: 77 20 73 68 6f 72 74 20 63 6f 6c 75 6d 6e 73 20 w short columns
dd20: 6e 61 6d 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 names */.#define
dd30: 20 53 51 4c 49 54 45 5f 43 6f 75 6e 74 52 6f 77 SQLITE_CountRow
dd40: 73 20 20 20 20 20 20 30 78 30 30 30 30 30 30 38 s 0x0000008
dd50: 30 20 20 2f 2a 20 43 6f 75 6e 74 20 72 6f 77 73 0 /* Count rows
dd60: 20 63 68 61 6e 67 65 64 20 62 79 20 49 4e 53 45 changed by INSE
dd70: 52 54 2c 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 RT, */.
dd80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dd90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dda0: 20 2f 2a 20 20 20 44 45 4c 45 54 45 2c 20 6f 72 /* DELETE, or
ddb0: 20 55 50 44 41 54 45 20 61 6e 64 20 72 65 74 75 UPDATE and retu
ddc0: 72 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 rn */.
ddd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
dde0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ddf0: 2f 2a 20 20 20 74 68 65 20 63 6f 75 6e 74 20 75 /* the count u
de00: 73 69 6e 67 20 61 20 63 61 6c 6c 62 61 63 6b 2e sing a callback.
de10: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
de20: 54 45 5f 4e 75 6c 6c 43 61 6c 6c 62 61 63 6b 20 TE_NullCallback
de30: 20 20 30 78 30 30 30 30 30 31 30 30 20 20 2f 2a 0x00000100 /*
de40: 20 49 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c Invoke the call
de50: 62 61 63 6b 20 6f 6e 63 65 20 69 66 20 74 68 65 back once if the
de60: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 */.
de70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
de80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
de90: 20 20 20 72 65 73 75 6c 74 20 73 65 74 20 69 73 result set is
dea0: 20 65 6d 70 74 79 20 2a 2f 0a 23 64 65 66 69 6e empty */.#defin
deb0: 65 20 53 51 4c 49 54 45 5f 49 67 6e 6f 72 65 43 e SQLITE_IgnoreC
dec0: 68 65 63 6b 73 20 20 20 30 78 30 30 30 30 30 32 hecks 0x000002
ded0: 30 30 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 65 6e 00 /* Do not en
dee0: 66 6f 72 63 65 20 63 68 65 63 6b 20 63 6f 6e 73 force check cons
def0: 74 72 61 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 traints */.#defi
df00: 6e 65 20 53 51 4c 49 54 45 5f 52 65 61 64 55 6e ne SQLITE_ReadUn
df10: 63 6f 6d 6d 69 74 20 20 20 30 78 30 30 30 30 30 commit 0x00000
df20: 34 30 30 20 20 2f 2a 20 52 45 41 44 20 55 4e 43 400 /* READ UNC
df30: 4f 4d 4d 49 54 54 45 44 20 69 6e 20 73 68 61 72 OMMITTED in shar
df40: 65 64 2d 63 61 63 68 65 20 2a 2f 0a 23 64 65 66 ed-cache */.#def
df50: 69 6e 65 20 53 51 4c 49 54 45 5f 4e 6f 43 6b 70 ine SQLITE_NoCkp
df60: 74 4f 6e 43 6c 6f 73 65 20 20 30 78 30 30 30 30 tOnClose 0x0000
df70: 30 38 30 30 20 20 2f 2a 20 4e 6f 20 63 68 65 63 0800 /* No chec
df80: 6b 70 6f 69 6e 74 20 6f 6e 20 63 6c 6f 73 65 28 kpoint on close(
df90: 29 2f 44 45 54 41 43 48 20 2a 2f 0a 23 64 65 66 )/DETACH */.#def
dfa0: 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 76 65 72 ine SQLITE_Rever
dfb0: 73 65 4f 72 64 65 72 20 20 20 30 78 30 30 30 30 seOrder 0x0000
dfc0: 31 30 30 30 20 20 2f 2a 20 52 65 76 65 72 73 65 1000 /* Reverse
dfd0: 20 75 6e 6f 72 64 65 72 65 64 20 53 45 4c 45 43 unordered SELEC
dfe0: 54 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 Ts */.#define SQ
dff0: 4c 49 54 45 5f 52 65 63 54 72 69 67 67 65 72 73 LITE_RecTriggers
e000: 20 20 20 20 30 78 30 30 30 30 32 30 30 30 20 20 0x00002000
e010: 2f 2a 20 45 6e 61 62 6c 65 20 72 65 63 75 72 73 /* Enable recurs
e020: 69 76 65 20 74 72 69 67 67 65 72 73 20 2a 2f 0a ive triggers */.
e030: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
e040: 6f 72 65 69 67 6e 4b 65 79 73 20 20 20 20 30 78 oreignKeys 0x
e050: 30 30 30 30 34 30 30 30 20 20 2f 2a 20 45 6e 66 00004000 /* Enf
e060: 6f 72 63 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 orce foreign key
e070: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 20 2a 2f constraints */
e080: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e090: 41 75 74 6f 49 6e 64 65 78 20 20 20 20 20 20 30 AutoIndex 0
e0a0: 78 30 30 30 30 38 30 30 30 20 20 2f 2a 20 45 6e x00008000 /* En
e0b0: 61 62 6c 65 20 61 75 74 6f 6d 61 74 69 63 20 69 able automatic i
e0c0: 6e 64 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 6e ndexes */.#defin
e0d0: 65 20 53 51 4c 49 54 45 5f 4c 6f 61 64 45 78 74 e SQLITE_LoadExt
e0e0: 65 6e 73 69 6f 6e 20 20 30 78 30 30 30 31 30 30 ension 0x000100
e0f0: 30 30 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6c 6f 00 /* Enable lo
e100: 61 64 5f 65 78 74 65 6e 73 69 6f 6e 20 2a 2f 0a ad_extension */.
e110: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c #define SQLITE_L
e120: 6f 61 64 45 78 74 46 75 6e 63 20 20 20 20 30 78 oadExtFunc 0x
e130: 30 30 30 32 30 30 30 30 20 20 2f 2a 20 45 6e 61 00020000 /* Ena
e140: 62 6c 65 20 6c 6f 61 64 5f 65 78 74 65 6e 73 69 ble load_extensi
e150: 6f 6e 28 29 20 53 51 4c 20 66 75 6e 63 20 2a 2f on() SQL func */
e160: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e170: 45 6e 61 62 6c 65 54 72 69 67 67 65 72 20 20 30 EnableTrigger 0
e180: 78 30 30 30 34 30 30 30 30 20 20 2f 2a 20 54 72 x00040000 /* Tr
e190: 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 69 ue to enable tri
e1a0: 67 67 65 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 ggers */.#define
e1b0: 20 53 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 SQLITE_DeferFKs
e1c0: 20 20 20 20 20 20 20 30 78 30 30 30 38 30 30 30 0x0008000
e1d0: 30 20 20 2f 2a 20 44 65 66 65 72 20 61 6c 6c 20 0 /* Defer all
e1e0: 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a FK constraints *
e1f0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
e200: 5f 51 75 65 72 79 4f 6e 6c 79 20 20 20 20 20 20 _QueryOnly
e210: 30 78 30 30 31 30 30 30 30 30 20 20 2f 2a 20 44 0x00100000 /* D
e220: 69 73 61 62 6c 65 20 64 61 74 61 62 61 73 65 20 isable database
e230: 63 68 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 changes */.#defi
e240: 6e 65 20 53 51 4c 49 54 45 5f 43 65 6c 6c 53 69 ne SQLITE_CellSi
e250: 7a 65 43 6b 20 20 20 20 20 30 78 30 30 32 30 30 zeCk 0x00200
e260: 30 30 30 20 20 2f 2a 20 43 68 65 63 6b 20 62 74 000 /* Check bt
e270: 72 65 65 20 63 65 6c 6c 20 73 69 7a 65 73 20 6f ree cell sizes o
e280: 6e 20 6c 6f 61 64 20 2a 2f 0a 23 64 65 66 69 6e n load */.#defin
e290: 65 20 53 51 4c 49 54 45 5f 46 74 73 33 54 6f 6b e SQLITE_Fts3Tok
e2a0: 65 6e 69 7a 65 72 20 20 30 78 30 30 34 30 30 30 enizer 0x004000
e2b0: 30 30 20 20 2f 2a 20 45 6e 61 62 6c 65 20 66 74 00 /* Enable ft
e2c0: 73 33 5f 74 6f 6b 65 6e 69 7a 65 72 28 32 29 20 s3_tokenizer(2)
e2d0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
e2e0: 45 5f 45 6e 61 62 6c 65 51 50 53 47 20 20 20 20 E_EnableQPSG
e2f0: 20 30 78 30 30 38 30 30 30 30 30 20 20 2f 2a 20 0x00800000 /*
e300: 51 75 65 72 79 20 50 6c 61 6e 6e 65 72 20 53 74 Query Planner St
e310: 61 62 69 6c 69 74 79 20 47 75 61 72 61 6e 74 65 ability Guarante
e320: 65 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 e*/.#define SQLI
e330: 54 45 5f 54 72 69 67 67 65 72 45 51 50 20 20 20 TE_TriggerEQP
e340: 20 20 30 78 30 31 30 30 30 30 30 30 20 20 2f 2a 0x01000000 /*
e350: 20 53 68 6f 77 20 74 72 69 67 67 65 72 20 45 58 Show trigger EX
e360: 50 4c 41 49 4e 20 51 55 45 52 59 20 50 4c 41 4e PLAIN QUERY PLAN
e370: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e380: 54 45 5f 52 65 73 65 74 44 61 74 61 62 61 73 65 TE_ResetDatabase
e390: 20 20 30 78 30 32 30 30 30 30 30 30 20 20 2f 2a 0x02000000 /*
e3a0: 20 52 65 73 65 74 20 74 68 65 20 64 61 74 61 62 Reset the datab
e3b0: 61 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ase */.#define S
e3c0: 51 4c 49 54 45 5f 4c 65 67 61 63 79 41 6c 74 65 QLITE_LegacyAlte
e3d0: 72 20 20 20 20 30 78 30 34 30 30 30 30 30 30 20 r 0x04000000
e3e0: 20 2f 2a 20 4c 65 67 61 63 79 20 41 4c 54 45 52 /* Legacy ALTER
e3f0: 20 54 41 42 4c 45 20 62 65 68 61 76 69 6f 75 72 TABLE behaviour
e400: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e410: 54 45 5f 4e 6f 53 63 68 65 6d 61 45 72 72 6f 72 TE_NoSchemaError
e420: 20 20 30 78 30 38 30 30 30 30 30 30 20 20 2f 2a 0x08000000 /*
e430: 20 44 6f 20 6e 6f 74 20 72 65 70 6f 72 74 20 73 Do not report s
e440: 63 68 65 6d 61 20 70 61 72 73 65 20 65 72 72 6f chema parse erro
e450: 72 73 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c rs*/.#define SQL
e460: 49 54 45 5f 44 65 66 65 6e 73 69 76 65 20 20 20 ITE_Defensive
e470: 20 20 20 30 78 31 30 30 30 30 30 30 30 20 20 2f 0x10000000 /
e480: 2a 20 49 6e 70 75 74 20 53 51 4c 20 69 73 20 6c * Input SQL is l
e490: 69 6b 65 6c 79 20 68 6f 73 74 69 6c 65 20 2a 2f ikely hostile */
e4a0: 0a 0a 2f 2a 20 46 6c 61 67 73 20 75 73 65 64 20 ../* Flags used
e4b0: 6f 6e 6c 79 20 69 66 20 64 65 62 75 67 67 69 6e only if debuggin
e4c0: 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 48 49 28 g */.#define HI(
e4d0: 58 29 20 20 28 28 75 36 34 29 28 58 29 3c 3c 33 X) ((u64)(X)<<3
e4e0: 32 29 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 2).#ifdef SQLITE
e4f0: 5f 44 45 42 55 47 0a 23 64 65 66 69 6e 65 20 53 _DEBUG.#define S
e500: 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65 20 20 QLITE_SqlTrace
e510: 20 20 20 20 20 48 49 28 30 78 30 30 30 31 29 20 HI(0x0001)
e520: 20 2f 2a 20 44 65 62 75 67 20 70 72 69 6e 74 20 /* Debug print
e530: 53 51 4c 20 61 73 20 69 74 20 65 78 65 63 75 74 SQL as it execut
e540: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
e550: 4c 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e 67 LITE_VdbeListing
e560: 20 20 20 20 48 49 28 30 78 30 30 30 32 29 20 20 HI(0x0002)
e570: 2f 2a 20 44 65 62 75 67 20 6c 69 73 74 69 6e 67 /* Debug listing
e580: 73 20 6f 66 20 56 44 42 45 20 70 72 6f 67 73 20 s of VDBE progs
e590: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
e5a0: 45 5f 56 64 62 65 54 72 61 63 65 20 20 20 20 20 E_VdbeTrace
e5b0: 20 48 49 28 30 78 30 30 30 34 29 20 20 2f 2a 20 HI(0x0004) /*
e5c0: 54 72 75 65 20 74 6f 20 74 72 61 63 65 20 56 44 True to trace VD
e5d0: 42 45 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f 0a BE execution */.
e5e0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 #define SQLITE_V
e5f0: 64 62 65 41 64 64 6f 70 54 72 61 63 65 20 48 49 dbeAddopTrace HI
e600: 28 30 78 30 30 30 38 29 20 20 2f 2a 20 54 72 61 (0x0008) /* Tra
e610: 63 65 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 ce sqlite3VdbeAd
e620: 64 4f 70 28 29 20 63 61 6c 6c 73 20 2a 2f 0a 23 dOp() calls */.#
e630: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 define SQLITE_Vd
e640: 62 65 45 51 50 20 20 20 20 20 20 20 20 48 49 28 beEQP HI(
e650: 30 78 30 30 31 30 29 20 20 2f 2a 20 44 65 62 75 0x0010) /* Debu
e660: 67 20 45 58 50 4c 41 49 4e 20 51 55 45 52 59 20 g EXPLAIN QUERY
e670: 50 4c 41 4e 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a PLAN */.#endif..
e680: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 /*.** Allowed va
e690: 6c 75 65 73 20 66 6f 72 20 73 71 6c 69 74 65 33 lues for sqlite3
e6a0: 2e 6d 44 62 46 6c 61 67 73 0a 2a 2f 0a 23 64 65 .mDbFlags.*/.#de
e6b0: 66 69 6e 65 20 44 42 46 4c 41 47 5f 53 63 68 65 fine DBFLAG_Sche
e6c0: 6d 61 43 68 61 6e 67 65 20 20 20 30 78 30 30 30 maChange 0x000
e6d0: 31 20 20 2f 2a 20 55 6e 63 6f 6d 6d 69 74 74 65 1 /* Uncommitte
e6e0: 64 20 48 61 73 68 20 74 61 62 6c 65 20 63 68 61 d Hash table cha
e6f0: 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 nges */.#define
e700: 44 42 46 4c 41 47 5f 50 72 65 66 65 72 42 75 69 DBFLAG_PreferBui
e710: 6c 74 69 6e 20 20 30 78 30 30 30 32 20 20 2f 2a ltin 0x0002 /*
e720: 20 50 72 65 66 65 72 65 6e 63 65 20 74 6f 20 62 Preference to b
e730: 75 69 6c 74 2d 69 6e 20 66 75 6e 63 73 20 2a 2f uilt-in funcs */
e740: 0a 23 64 65 66 69 6e 65 20 44 42 46 4c 41 47 5f .#define DBFLAG_
e750: 56 61 63 75 75 6d 20 20 20 20 20 20 20 20 20 30 Vacuum 0
e760: 78 30 30 30 34 20 20 2f 2a 20 43 75 72 72 65 6e x0004 /* Curren
e770: 74 6c 79 20 69 6e 20 61 20 56 41 43 55 55 4d 20 tly in a VACUUM
e780: 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 46 4c 41 */.#define DBFLA
e790: 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 20 G_SchemaKnownOk
e7a0: 20 30 78 30 30 30 38 20 20 2f 2a 20 53 63 68 65 0x0008 /* Sche
e7b0: 6d 61 20 69 73 20 6b 6e 6f 77 6e 20 74 6f 20 62 ma is known to b
e7c0: 65 20 76 61 6c 69 64 20 2a 2f 0a 0a 2f 2a 0a 2a e valid */../*.*
e7d0: 2a 20 42 69 74 73 20 6f 66 20 74 68 65 20 73 71 * Bits of the sq
e7e0: 6c 69 74 65 33 2e 64 62 4f 70 74 46 6c 61 67 73 lite3.dbOptFlags
e7f0: 20 66 69 65 6c 64 20 74 68 61 74 20 61 72 65 20 field that are
e800: 75 73 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 73 used by the.** s
e810: 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
e820: 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 rol(SQLITE_TESTC
e830: 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e TRL_OPTIMIZATION
e840: 53 2c 2e 2e 2e 29 20 69 6e 74 65 72 66 61 63 65 S,...) interface
e850: 20 74 6f 0a 2a 2a 20 73 65 6c 65 63 74 69 76 65 to.** selective
e860: 6c 79 20 64 69 73 61 62 6c 65 20 76 61 72 69 6f ly disable vario
e870: 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 us optimizations
e880: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
e890: 49 54 45 5f 51 75 65 72 79 46 6c 61 74 74 65 6e ITE_QueryFlatten
e8a0: 65 72 20 30 78 30 30 30 31 20 20 20 2f 2a 20 51 er 0x0001 /* Q
e8b0: 75 65 72 79 20 66 6c 61 74 74 65 6e 69 6e 67 20 uery flattening
e8c0: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 */.
e8d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
e8e0: 20 30 78 30 30 30 32 20 20 20 61 76 61 69 6c 61 0x0002 availa
e8f0: 62 6c 65 20 66 6f 72 20 72 65 75 73 65 20 2a 2f ble for reuse */
e900: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e910: 47 72 6f 75 70 42 79 4f 72 64 65 72 20 20 20 30 GroupByOrder 0
e920: 78 30 30 30 34 20 20 20 2f 2a 20 47 52 4f 55 50 x0004 /* GROUP
e930: 42 59 20 63 6f 76 65 72 20 6f 66 20 4f 52 44 45 BY cover of ORDE
e940: 52 42 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 RBY */.#define S
e950: 51 4c 49 54 45 5f 46 61 63 74 6f 72 4f 75 74 43 QLITE_FactorOutC
e960: 6f 6e 73 74 20 30 78 30 30 30 38 20 20 20 2f 2a onst 0x0008 /*
e970: 20 43 6f 6e 73 74 61 6e 74 20 66 61 63 74 6f 72 Constant factor
e980: 69 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ing */.#define S
e990: 51 4c 49 54 45 5f 44 69 73 74 69 6e 63 74 4f 70 QLITE_DistinctOp
e9a0: 74 20 20 20 20 30 78 30 30 31 30 20 20 20 2f 2a t 0x0010 /*
e9b0: 20 44 49 53 54 49 4e 43 54 20 75 73 69 6e 67 20 DISTINCT using
e9c0: 69 6e 64 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 indexes */.#defi
e9d0: 6e 65 20 53 51 4c 49 54 45 5f 43 6f 76 65 72 49 ne SQLITE_CoverI
e9e0: 64 78 53 63 61 6e 20 20 20 30 78 30 30 32 30 20 dxScan 0x0020
e9f0: 20 20 2f 2a 20 43 6f 76 65 72 69 6e 67 20 69 6e /* Covering in
ea00: 64 65 78 20 73 63 61 6e 73 20 2a 2f 0a 23 64 65 dex scans */.#de
ea10: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 72 64 65 fine SQLITE_Orde
ea20: 72 42 79 49 64 78 4a 6f 69 6e 20 30 78 30 30 34 rByIdxJoin 0x004
ea30: 30 20 20 20 2f 2a 20 4f 52 44 45 52 20 42 59 20 0 /* ORDER BY
ea40: 6f 66 20 6a 6f 69 6e 73 20 76 69 61 20 69 6e 64 of joins via ind
ea50: 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ex */.#define SQ
ea60: 4c 49 54 45 5f 54 72 61 6e 73 69 74 69 76 65 20 LITE_Transitive
ea70: 20 20 20 20 30 78 30 30 38 30 20 20 20 2f 2a 20 0x0080 /*
ea80: 54 72 61 6e 73 69 74 69 76 65 20 63 6f 6e 73 74 Transitive const
ea90: 72 61 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 6e raints */.#defin
eaa0: 65 20 53 51 4c 49 54 45 5f 4f 6d 69 74 4e 6f 6f e SQLITE_OmitNoo
eab0: 70 4a 6f 69 6e 20 20 20 30 78 30 31 30 30 20 20 pJoin 0x0100
eac0: 20 2f 2a 20 4f 6d 69 74 20 75 6e 75 73 65 64 20 /* Omit unused
ead0: 74 61 62 6c 65 73 20 69 6e 20 6a 6f 69 6e 73 20 tables in joins
eae0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
eaf0: 45 5f 43 6f 75 6e 74 4f 66 56 69 65 77 20 20 20 E_CountOfView
eb00: 20 30 78 30 32 30 30 20 20 20 2f 2a 20 54 68 65 0x0200 /* The
eb10: 20 63 6f 75 6e 74 2d 6f 66 2d 76 69 65 77 20 6f count-of-view o
eb20: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 2a 2f 0a 23 ptimization */.#
eb30: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 75 define SQLITE_Cu
eb40: 72 73 6f 72 48 69 6e 74 73 20 20 20 20 30 78 30 rsorHints 0x0
eb50: 34 30 30 20 20 20 2f 2a 20 41 64 64 20 4f 50 5f 400 /* Add OP_
eb60: 43 75 72 73 6f 72 48 69 6e 74 20 6f 70 63 6f 64 CursorHint opcod
eb70: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
eb80: 4c 49 54 45 5f 53 74 61 74 33 34 20 20 20 20 20 LITE_Stat34
eb90: 20 20 20 20 30 78 30 38 30 30 20 20 20 2f 2a 20 0x0800 /*
eba0: 55 73 65 20 53 54 41 54 33 20 6f 72 20 53 54 41 Use STAT3 or STA
ebb0: 54 34 20 64 61 74 61 20 2a 2f 0a 20 20 20 2f 2a T4 data */. /*
ebc0: 20 54 48 33 20 65 78 70 65 63 74 73 20 74 68 65 TH3 expects the
ebd0: 20 53 74 61 74 33 34 20 20 5e 5e 5e 5e 5e 5e 20 Stat34 ^^^^^^
ebe0: 76 61 6c 75 65 20 74 6f 20 62 65 20 30 78 30 38 value to be 0x08
ebf0: 30 30 2e 20 20 44 6f 6e 27 74 20 63 68 61 6e 67 00. Don't chang
ec00: 65 20 69 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 e it */.#define
ec10: 53 51 4c 49 54 45 5f 50 75 73 68 44 6f 77 6e 20 SQLITE_PushDown
ec20: 20 20 20 20 20 20 30 78 31 30 30 30 20 20 20 2f 0x1000 /
ec30: 2a 20 54 68 65 20 70 75 73 68 2d 64 6f 77 6e 20 * The push-down
ec40: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 2a 2f 0a optimization */.
ec50: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
ec60: 69 6d 70 6c 69 66 79 4a 6f 69 6e 20 20 20 30 78 implifyJoin 0x
ec70: 32 30 30 30 20 20 20 2f 2a 20 43 6f 6e 76 65 72 2000 /* Conver
ec80: 74 20 4c 45 46 54 20 4a 4f 49 4e 20 74 6f 20 4a t LEFT JOIN to J
ec90: 4f 49 4e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 OIN */.#define S
eca0: 51 4c 49 54 45 5f 53 6b 69 70 53 63 61 6e 20 20 QLITE_SkipScan
ecb0: 20 20 20 20 20 30 78 34 30 30 30 20 20 20 2f 2a 0x4000 /*
ecc0: 20 53 6b 69 70 2d 73 63 61 6e 73 20 2a 2f 0a 23 Skip-scans */.#
ecd0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 72 define SQLITE_Pr
ece0: 6f 70 61 67 61 74 65 43 6f 6e 73 74 20 30 78 38 opagateConst 0x8
ecf0: 30 30 30 20 20 20 2f 2a 20 54 68 65 20 63 6f 6e 000 /* The con
ed00: 73 74 61 6e 74 20 70 72 6f 70 61 67 61 74 69 6f stant propagatio
ed10: 6e 20 6f 70 74 20 2a 2f 0a 23 64 65 66 69 6e 65 n opt */.#define
ed20: 20 53 51 4c 49 54 45 5f 41 6c 6c 4f 70 74 73 20 SQLITE_AllOpts
ed30: 20 20 20 20 20 20 20 30 78 66 66 66 66 20 20 20 0xffff
ed40: 2f 2a 20 41 6c 6c 20 6f 70 74 69 6d 69 7a 61 74 /* All optimizat
ed50: 69 6f 6e 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 4d ions */../*.** M
ed60: 61 63 72 6f 73 20 66 6f 72 20 74 65 73 74 69 6e acros for testin
ed70: 67 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 g whether or not
ed80: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 61 optimizations a
ed90: 72 65 20 65 6e 61 62 6c 65 64 20 6f 72 20 64 69 re enabled or di
eda0: 73 61 62 6c 65 64 2e 0a 2a 2f 0a 23 64 65 66 69 sabled..*/.#defi
edb0: 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 44 ne OptimizationD
edc0: 69 73 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b isabled(db, mask
edd0: 29 20 20 28 28 28 64 62 29 2d 3e 64 62 4f 70 74 ) (((db)->dbOpt
ede0: 46 6c 61 67 73 26 28 6d 61 73 6b 29 29 21 3d 30 Flags&(mask))!=0
edf0: 29 0a 23 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 ).#define Optimi
ee00: 7a 61 74 69 6f 6e 45 6e 61 62 6c 65 64 28 64 62 zationEnabled(db
ee10: 2c 20 6d 61 73 6b 29 20 20 20 28 28 28 64 62 29 , mask) (((db)
ee20: 2d 3e 64 62 4f 70 74 46 6c 61 67 73 26 28 6d 61 ->dbOptFlags&(ma
ee30: 73 6b 29 29 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 sk))==0)../*.**
ee40: 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 Return true if i
ee50: 74 20 4f 4b 20 74 6f 20 66 61 63 74 6f 72 20 63 t OK to factor c
ee60: 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 73 69 onstant expressi
ee70: 6f 6e 73 20 69 6e 74 6f 20 74 68 65 20 69 6e 69 ons into the ini
ee80: 74 69 61 6c 69 7a 61 74 69 6f 6e 0a 2a 2a 20 63 tialization.** c
ee90: 6f 64 65 2e 20 54 68 65 20 61 72 67 75 6d 65 6e ode. The argumen
eea0: 74 20 69 73 20 61 20 50 61 72 73 65 20 6f 62 6a t is a Parse obj
eeb0: 65 63 74 20 66 6f 72 20 74 68 65 20 63 6f 64 65 ect for the code
eec0: 20 67 65 6e 65 72 61 74 6f 72 2e 0a 2a 2f 0a 23 generator..*/.#
eed0: 64 65 66 69 6e 65 20 43 6f 6e 73 74 46 61 63 74 define ConstFact
eee0: 6f 72 4f 6b 28 50 29 20 28 28 50 29 2d 3e 6f 6b orOk(P) ((P)->ok
eef0: 43 6f 6e 73 74 46 61 63 74 6f 72 29 0a 0a 2f 2a ConstFactor)../*
ef00: 0a 2a 2a 20 50 6f 73 73 69 62 6c 65 20 76 61 6c .** Possible val
ef10: 75 65 73 20 66 6f 72 20 74 68 65 20 73 71 6c 69 ues for the sqli
ef20: 74 65 2e 6d 61 67 69 63 20 66 69 65 6c 64 2e 0a te.magic field..
ef30: 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72 73 20 61 ** The numbers a
ef40: 72 65 20 6f 62 74 61 69 6e 65 64 20 61 74 20 72 re obtained at r
ef50: 61 6e 64 6f 6d 20 61 6e 64 20 68 61 76 65 20 6e andom and have n
ef60: 6f 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e o special meanin
ef70: 67 2c 20 6f 74 68 65 72 0a 2a 2a 20 74 68 61 6e g, other.** than
ef80: 20 62 65 69 6e 67 20 64 69 73 74 69 6e 63 74 20 being distinct
ef90: 66 72 6f 6d 20 6f 6e 65 20 61 6e 6f 74 68 65 72 from one another
efa0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
efb0: 49 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 20 20 ITE_MAGIC_OPEN
efc0: 20 20 20 30 78 61 30 32 39 61 36 39 37 20 20 2f 0xa029a697 /
efd0: 2a 20 44 61 74 61 62 61 73 65 20 69 73 20 6f 70 * Database is op
efe0: 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 en */.#define SQ
eff0: 4c 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 LITE_MAGIC_CLOSE
f000: 44 20 20 20 30 78 39 66 33 63 32 64 33 33 20 20 D 0x9f3c2d33
f010: 2f 2a 20 44 61 74 61 62 61 73 65 20 69 73 20 63 /* Database is c
f020: 6c 6f 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 losed */.#define
f030: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 53 49 SQLITE_MAGIC_SI
f040: 43 4b 20 20 20 20 20 30 78 34 62 37 37 31 32 39 CK 0x4b77129
f050: 30 20 20 2f 2a 20 45 72 72 6f 72 20 61 6e 64 20 0 /* Error and
f060: 61 77 61 69 74 69 6e 67 20 63 6c 6f 73 65 20 2a awaiting close *
f070: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
f080: 5f 4d 41 47 49 43 5f 42 55 53 59 20 20 20 20 20 _MAGIC_BUSY
f090: 30 78 66 30 33 62 37 39 30 36 20 20 2f 2a 20 44 0xf03b7906 /* D
f0a0: 61 74 61 62 61 73 65 20 63 75 72 72 65 6e 74 6c atabase currentl
f0b0: 79 20 69 6e 20 75 73 65 20 2a 2f 0a 23 64 65 66 y in use */.#def
f0c0: 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 ine SQLITE_MAGIC
f0d0: 5f 45 52 52 4f 52 20 20 20 20 30 78 62 35 33 35 _ERROR 0xb535
f0e0: 37 39 33 30 20 20 2f 2a 20 41 6e 20 53 51 4c 49 7930 /* An SQLI
f0f0: 54 45 5f 4d 49 53 55 53 45 20 65 72 72 6f 72 20 TE_MISUSE error
f100: 6f 63 63 75 72 72 65 64 20 2a 2f 0a 23 64 65 66 occurred */.#def
f110: 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 ine SQLITE_MAGIC
f120: 5f 5a 4f 4d 42 49 45 20 20 20 30 78 36 34 63 66 _ZOMBIE 0x64cf
f130: 66 63 37 66 20 20 2f 2a 20 43 6c 6f 73 65 20 77 fc7f /* Close w
f140: 69 74 68 20 6c 61 73 74 20 73 74 61 74 65 6d 65 ith last stateme
f150: 6e 74 20 63 6c 6f 73 65 20 2a 2f 0a 0a 2f 2a 0a nt close */../*.
f160: 2a 2a 20 45 61 63 68 20 53 51 4c 20 66 75 6e 63 ** Each SQL func
f170: 74 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20 tion is defined
f180: 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f by an instance o
f190: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a f the following.
f1a0: 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 20 20 46 ** structure. F
f1b0: 6f 72 20 67 6c 6f 62 61 6c 20 62 75 69 6c 74 2d or global built-
f1c0: 69 6e 20 66 75 6e 63 74 69 6f 6e 73 20 28 65 78 in functions (ex
f1d0: 3a 20 73 75 62 73 74 72 28 29 2c 20 6d 61 78 28 : substr(), max(
f1e0: 29 2c 20 63 6f 75 6e 74 28 29 29 0a 2a 2a 20 61 ), count()).** a
f1f0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 pointer to this
f200: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 68 65 structure is he
f210: 6c 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 ld in the sqlite
f220: 33 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 3BuiltinFunction
f230: 73 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 46 6f 72 s object..** For
f240: 20 70 65 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 per-connection
f250: 61 70 70 6c 69 63 61 74 69 6f 6e 2d 64 65 66 69 application-defi
f260: 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 2c 20 61 ned functions, a
f270: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 pointer to this
f280: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 20 69 73 .** structure is
f290: 20 68 65 6c 64 20 69 6e 20 74 68 65 20 64 62 2d held in the db-
f2a0: 3e 61 48 61 73 68 20 68 61 73 68 20 74 61 62 6c >aHash hash tabl
f2b0: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 75 2e 70 e..**.** The u.p
f2c0: 48 61 73 68 20 66 69 65 6c 64 20 69 73 20 75 73 Hash field is us
f2d0: 65 64 20 62 79 20 74 68 65 20 67 6c 6f 62 61 6c ed by the global
f2e0: 20 62 75 69 6c 74 2d 69 6e 73 2e 20 20 54 68 65 built-ins. The
f2f0: 20 75 2e 70 44 65 73 74 72 75 63 74 6f 72 0a 2a u.pDestructor.*
f300: 2a 20 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 * field is used
f310: 62 79 20 70 65 72 2d 63 6f 6e 6e 65 63 74 69 6f by per-connectio
f320: 6e 20 61 70 70 2d 64 65 66 20 66 75 6e 63 74 69 n app-def functi
f330: 6f 6e 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 46 ons..*/.struct F
f340: 75 6e 63 44 65 66 20 7b 0a 20 20 69 38 20 6e 41 uncDef {. i8 nA
f350: 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rg;
f360: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67 /* Number of arg
f370: 75 6d 65 6e 74 73 2e 20 20 2d 31 20 6d 65 61 6e uments. -1 mean
f380: 73 20 75 6e 6c 69 6d 69 74 65 64 20 2a 2f 0a 20 s unlimited */.
f390: 20 75 33 32 20 66 75 6e 63 46 6c 61 67 73 3b 20 u32 funcFlags;
f3a0: 20 20 20 20 20 20 2f 2a 20 53 6f 6d 65 20 63 6f /* Some co
f3b0: 6d 62 69 6e 61 74 69 6f 6e 20 6f 66 20 53 51 4c mbination of SQL
f3c0: 49 54 45 5f 46 55 4e 43 5f 2a 20 2a 2f 0a 20 20 ITE_FUNC_* */.
f3d0: 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 3b void *pUserData;
f3e0: 20 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61 74 /* User dat
f3f0: 61 20 70 61 72 61 6d 65 74 65 72 20 2a 2f 0a 20 a parameter */.
f400: 20 46 75 6e 63 44 65 66 20 2a 70 4e 65 78 74 3b FuncDef *pNext;
f410: 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 66 75 /* Next fu
f420: 6e 63 74 69 6f 6e 20 77 69 74 68 20 73 61 6d 65 nction with same
f430: 20 6e 61 6d 65 20 2a 2f 0a 20 20 76 6f 69 64 20 name */. void
f440: 28 2a 78 53 46 75 6e 63 29 28 73 71 6c 69 74 65 (*xSFunc)(sqlite
f450: 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 3_context*,int,s
f460: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b qlite3_value**);
f470: 20 2f 2a 20 66 75 6e 63 20 6f 72 20 61 67 67 2d /* func or agg-
f480: 73 74 65 70 20 2a 2f 0a 20 20 76 6f 69 64 20 28 step */. void (
f490: 2a 78 46 69 6e 61 6c 69 7a 65 29 28 73 71 6c 69 *xFinalize)(sqli
f4a0: 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 3b 20 20 te3_context*);
f4b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f4c0: 2f 2a 20 41 67 67 20 66 69 6e 61 6c 69 7a 65 72 /* Agg finalizer
f4d0: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 56 61 */. void (*xVa
f4e0: 6c 75 65 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e lue)(sqlite3_con
f4f0: 74 65 78 74 2a 29 3b 20 20 20 20 20 20 20 20 20 text*);
f500: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
f510: 75 72 72 65 6e 74 20 61 67 67 20 76 61 6c 75 65 urrent agg value
f520: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 49 6e */. void (*xIn
f530: 76 65 72 73 65 29 28 73 71 6c 69 74 65 33 5f 63 verse)(sqlite3_c
f540: 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
f550: 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 20 2f 2a te3_value**); /*
f560: 20 69 6e 76 65 72 73 65 20 61 67 67 2d 73 74 65 inverse agg-ste
f570: 70 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 p */. const cha
f580: 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 2f 2a 20 53 r *zName; /* S
f590: 51 4c 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 QL name of the f
f5a0: 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 75 6e unction. */. un
f5b0: 69 6f 6e 20 7b 0a 20 20 20 20 46 75 6e 63 44 65 ion {. FuncDe
f5c0: 66 20 2a 70 48 61 73 68 3b 20 20 20 20 20 20 2f f *pHash; /
f5d0: 2a 20 4e 65 78 74 20 77 69 74 68 20 61 20 64 69 * Next with a di
f5e0: 66 66 65 72 65 6e 74 20 6e 61 6d 65 20 62 75 74 fferent name but
f5f0: 20 74 68 65 20 73 61 6d 65 20 68 61 73 68 20 2a the same hash *
f600: 2f 0a 20 20 20 20 46 75 6e 63 44 65 73 74 72 75 /. FuncDestru
f610: 63 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f ctor *pDestructo
f620: 72 3b 20 20 20 2f 2a 20 52 65 66 65 72 65 6e 63 r; /* Referenc
f630: 65 20 63 6f 75 6e 74 65 64 20 64 65 73 74 72 75 e counted destru
f640: 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f ctor function */
f650: 0a 20 20 7d 20 75 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a . } u;.};../*.*
f660: 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 72 65 * This structure
f670: 20 65 6e 63 61 70 73 75 6c 61 74 65 73 20 61 20 encapsulates a
f680: 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 user-function de
f690: 73 74 72 75 63 74 6f 72 20 63 61 6c 6c 62 61 63 structor callbac
f6a0: 6b 20 28 61 73 0a 2a 2a 20 63 6f 6e 66 69 67 75 k (as.** configu
f6b0: 72 65 64 20 75 73 69 6e 67 20 63 72 65 61 74 65 red using create
f6c0: 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 29 29 20 _function_v2())
f6d0: 61 6e 64 20 61 20 72 65 66 65 72 65 6e 63 65 20 and a reference
f6e0: 63 6f 75 6e 74 65 72 2e 20 57 68 65 6e 0a 2a 2a counter. When.**
f6f0: 20 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e create_function
f700: 5f 76 32 28 29 20 69 73 20 63 61 6c 6c 65 64 20 _v2() is called
f710: 74 6f 20 63 72 65 61 74 65 20 61 20 66 75 6e 63 to create a func
f720: 74 69 6f 6e 20 77 69 74 68 20 61 20 64 65 73 74 tion with a dest
f730: 72 75 63 74 6f 72 2c 0a 2a 2a 20 61 20 73 69 6e ructor,.** a sin
f740: 67 6c 65 20 6f 62 6a 65 63 74 20 6f 66 20 74 68 gle object of th
f750: 69 73 20 74 79 70 65 20 69 73 20 61 6c 6c 6f 63 is type is alloc
f760: 61 74 65 64 2e 20 46 75 6e 63 44 65 73 74 72 75 ated. FuncDestru
f770: 63 74 6f 72 2e 6e 52 65 66 20 69 73 20 73 65 74 ctor.nRef is set
f780: 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 65 to.** the numbe
f790: 72 20 6f 66 20 46 75 6e 63 44 65 66 20 6f 62 6a r of FuncDef obj
f7a0: 65 63 74 73 20 63 72 65 61 74 65 64 20 28 65 69 ects created (ei
f7b0: 74 68 65 72 20 31 20 6f 72 20 33 2c 20 64 65 70 ther 1 or 3, dep
f7c0: 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 ending on whethe
f7d0: 72 0a 2a 2a 20 6f 72 20 6e 6f 74 20 74 68 65 20 r.** or not the
f7e0: 73 70 65 63 69 66 69 65 64 20 65 6e 63 6f 64 69 specified encodi
f7f0: 6e 67 20 69 73 20 53 51 4c 49 54 45 5f 41 4e 59 ng is SQLITE_ANY
f800: 29 2e 20 54 68 65 20 46 75 6e 63 44 65 66 2e 70 ). The FuncDef.p
f810: 44 65 73 74 72 75 63 74 6f 72 0a 2a 2a 20 6d 65 Destructor.** me
f820: 6d 62 65 72 20 6f 66 20 65 61 63 68 20 6f 66 20 mber of each of
f830: 74 68 65 20 6e 65 77 20 46 75 6e 63 44 65 66 20 the new FuncDef
f840: 6f 62 6a 65 63 74 73 20 69 73 20 73 65 74 20 74 objects is set t
f850: 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 61 o point to the a
f860: 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 46 75 6e 63 llocated.** Func
f870: 44 65 73 74 72 75 63 74 6f 72 2e 0a 2a 2a 0a 2a Destructor..**.*
f880: 2a 20 54 68 65 72 65 61 66 74 65 72 2c 20 77 68 * Thereafter, wh
f890: 65 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 46 75 en one of the Fu
f8a0: 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 20 69 73 ncDef objects is
f8b0: 20 64 65 6c 65 74 65 64 2c 20 74 68 65 20 72 65 deleted, the re
f8c0: 66 65 72 65 6e 63 65 0a 2a 2a 20 63 6f 75 6e 74 ference.** count
f8d0: 20 6f 6e 20 74 68 69 73 20 6f 62 6a 65 63 74 20 on this object
f8e0: 69 73 20 64 65 63 72 65 6d 65 6e 74 65 64 2e 20 is decremented.
f8f0: 57 68 65 6e 20 69 74 20 72 65 61 63 68 65 73 20 When it reaches
f900: 30 2c 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 0, the destructo
f910: 72 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65 64 20 r.** is invoked
f920: 61 6e 64 20 74 68 65 20 46 75 6e 63 44 65 73 74 and the FuncDest
f930: 72 75 63 74 6f 72 20 73 74 72 75 63 74 75 72 65 ructor structure
f940: 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 freed..*/.struc
f950: 74 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 t FuncDestructor
f960: 20 7b 0a 20 20 69 6e 74 20 6e 52 65 66 3b 0a 20 {. int nRef;.
f970: 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 void (*xDestroy
f980: 29 28 76 6f 69 64 20 2a 29 3b 0a 20 20 76 6f 69 )(void *);. voi
f990: 64 20 2a 70 55 73 65 72 44 61 74 61 3b 0a 7d 3b d *pUserData;.};
f9a0: 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c 65 ../*.** Possible
f9b0: 20 76 61 6c 75 65 73 20 66 6f 72 20 46 75 6e 63 values for Func
f9c0: 44 65 66 2e 66 6c 61 67 73 2e 20 20 4e 6f 74 65 Def.flags. Note
f9d0: 20 74 68 61 74 20 74 68 65 20 5f 4c 45 4e 47 54 that the _LENGT
f9e0: 48 20 61 6e 64 20 5f 54 59 50 45 4f 46 0a 2a 2a H and _TYPEOF.**
f9f0: 20 76 61 6c 75 65 73 20 6d 75 73 74 20 63 6f 72 values must cor
fa00: 72 65 73 70 6f 6e 64 20 74 6f 20 4f 50 46 4c 41 respond to OPFLA
fa10: 47 5f 4c 45 4e 47 54 48 41 52 47 20 61 6e 64 20 G_LENGTHARG and
fa20: 4f 50 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 OPFLAG_TYPEOFARG
fa30: 2e 20 20 41 6e 64 0a 2a 2a 20 53 51 4c 49 54 45 . And.** SQLITE
fa40: 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 6d _FUNC_CONSTANT m
fa50: 75 73 74 20 62 65 20 74 68 65 20 73 61 6d 65 20 ust be the same
fa60: 61 73 20 53 51 4c 49 54 45 5f 44 45 54 45 52 4d as SQLITE_DETERM
fa70: 49 4e 49 53 54 49 43 2e 20 20 54 68 65 72 65 0a INISTIC. There.
fa80: 2a 2a 20 61 72 65 20 61 73 73 65 72 74 28 29 20 ** are assert()
fa90: 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 68 statements in th
faa0: 65 20 63 6f 64 65 20 74 6f 20 76 65 72 69 66 79 e code to verify
fab0: 20 74 68 69 73 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c this..**.** Val
fac0: 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 ue constraints (
fad0: 65 6e 66 6f 72 63 65 64 20 76 69 61 20 61 73 73 enforced via ass
fae0: 65 72 74 28 29 29 3a 0a 2a 2a 20 20 20 20 20 53 ert()):.** S
faf0: 51 4c 49 54 45 5f 46 55 4e 43 5f 4d 49 4e 4d 41 QLITE_FUNC_MINMA
fb00: 58 20 20 20 20 3d 3d 20 20 4e 43 5f 4d 69 6e 4d X == NC_MinM
fb10: 61 78 41 67 67 20 20 20 20 20 20 3d 3d 20 53 46 axAgg == SF
fb20: 5f 4d 69 6e 4d 61 78 41 67 67 0a 2a 2a 20 20 20 _MinMaxAgg.**
fb30: 20 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 SQLITE_FUNC_LE
fb40: 4e 47 54 48 20 20 20 20 3d 3d 20 20 4f 50 46 4c NGTH == OPFL
fb50: 41 47 5f 4c 45 4e 47 54 48 41 52 47 0a 2a 2a 20 AG_LENGTHARG.**
fb60: 20 20 20 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f SQLITE_FUNC_
fb70: 54 59 50 45 4f 46 20 20 20 20 3d 3d 20 20 4f 50 TYPEOF == OP
fb80: 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 0a 2a FLAG_TYPEOFARG.*
fb90: 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 46 55 4e * SQLITE_FUN
fba0: 43 5f 43 4f 4e 53 54 41 4e 54 20 20 3d 3d 20 20 C_CONSTANT ==
fbb0: 53 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 SQLITE_DETERMINI
fbc0: 53 54 49 43 20 66 72 6f 6d 20 74 68 65 20 41 50 STIC from the AP
fbd0: 49 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f I.** SQLITE_
fbe0: 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 20 20 20 64 FUNC_ENCMASK d
fbf0: 65 70 65 6e 64 73 20 6f 6e 20 53 51 4c 49 54 45 epends on SQLITE
fc00: 5f 55 54 46 2a 20 6d 61 63 72 6f 73 20 69 6e 20 _UTF* macros in
fc10: 74 68 65 20 41 50 49 0a 2a 2f 0a 23 64 65 66 69 the API.*/.#defi
fc20: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 ne SQLITE_FUNC_E
fc30: 4e 43 4d 41 53 4b 20 20 30 78 30 30 30 33 20 2f NCMASK 0x0003 /
fc40: 2a 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 * SQLITE_UTF8, S
fc50: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 6f 72 QLITE_UTF16BE or
fc60: 20 55 54 46 31 36 4c 45 20 2a 2f 0a 23 64 65 66 UTF16LE */.#def
fc70: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
fc80: 4c 49 4b 45 20 20 20 20 20 30 78 30 30 30 34 20 LIKE 0x0004
fc90: 2f 2a 20 43 61 6e 64 69 64 61 74 65 20 66 6f 72 /* Candidate for
fca0: 20 74 68 65 20 4c 49 4b 45 20 6f 70 74 69 6d 69 the LIKE optimi
fcb0: 7a 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e zation */.#defin
fcc0: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 41 e SQLITE_FUNC_CA
fcd0: 53 45 20 20 20 20 20 30 78 30 30 30 38 20 2f 2a SE 0x0008 /*
fce0: 20 43 61 73 65 2d 73 65 6e 73 69 74 69 76 65 20 Case-sensitive
fcf0: 4c 49 4b 45 2d 74 79 70 65 20 66 75 6e 63 74 69 LIKE-type functi
fd00: 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 on */.#define SQ
fd10: 4c 49 54 45 5f 46 55 4e 43 5f 45 50 48 45 4d 20 LITE_FUNC_EPHEM
fd20: 20 20 20 30 78 30 30 31 30 20 2f 2a 20 45 70 68 0x0010 /* Eph
fd30: 65 6d 65 72 61 6c 2e 20 20 44 65 6c 65 74 65 20 emeral. Delete
fd40: 77 69 74 68 20 56 44 42 45 20 2a 2f 0a 23 64 65 with VDBE */.#de
fd50: 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 fine SQLITE_FUNC
fd60: 5f 4e 45 45 44 43 4f 4c 4c 20 30 78 30 30 32 30 _NEEDCOLL 0x0020
fd70: 20 2f 2a 20 73 71 6c 69 74 65 33 47 65 74 46 75 /* sqlite3GetFu
fd80: 6e 63 43 6f 6c 6c 53 65 71 28 29 20 6d 69 67 68 ncCollSeq() migh
fd90: 74 20 62 65 20 63 61 6c 6c 65 64 2a 2f 0a 23 64 t be called*/.#d
fda0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
fdb0: 43 5f 4c 45 4e 47 54 48 20 20 20 30 78 30 30 34 C_LENGTH 0x004
fdc0: 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 6c 65 0 /* Built-in le
fdd0: 6e 67 74 68 28 29 20 66 75 6e 63 74 69 6f 6e 20 ngth() function
fde0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
fdf0: 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 20 20 20 E_FUNC_TYPEOF
fe00: 30 78 30 30 38 30 20 2f 2a 20 42 75 69 6c 74 2d 0x0080 /* Built-
fe10: 69 6e 20 74 79 70 65 6f 66 28 29 20 66 75 6e 63 in typeof() func
fe20: 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tion */.#define
fe30: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 55 4e SQLITE_FUNC_COUN
fe40: 54 20 20 20 20 30 78 30 31 30 30 20 2f 2a 20 42 T 0x0100 /* B
fe50: 75 69 6c 74 2d 69 6e 20 63 6f 75 6e 74 28 2a 29 uilt-in count(*)
fe60: 20 61 67 67 72 65 67 61 74 65 20 2a 2f 0a 23 64 aggregate */.#d
fe70: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
fe80: 43 5f 43 4f 41 4c 45 53 43 45 20 30 78 30 32 30 C_COALESCE 0x020
fe90: 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 63 6f 0 /* Built-in co
fea0: 61 6c 65 73 63 65 28 29 20 6f 72 20 69 66 6e 75 alesce() or ifnu
feb0: 6c 6c 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ll() */.#define
fec0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 55 4e 4c 49 SQLITE_FUNC_UNLI
fed0: 4b 45 4c 59 20 30 78 30 34 30 30 20 2f 2a 20 42 KELY 0x0400 /* B
fee0: 75 69 6c 74 2d 69 6e 20 75 6e 6c 69 6b 65 6c 79 uilt-in unlikely
fef0: 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 () function */.#
ff00: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 define SQLITE_FU
ff10: 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 30 78 30 38 NC_CONSTANT 0x08
ff20: 30 30 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 69 00 /* Constant i
ff30: 6e 70 75 74 73 20 67 69 76 65 20 61 20 63 6f 6e nputs give a con
ff40: 73 74 61 6e 74 20 6f 75 74 70 75 74 20 2a 2f 0a stant output */.
ff50: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
ff60: 55 4e 43 5f 4d 49 4e 4d 41 58 20 20 20 30 78 31 UNC_MINMAX 0x1
ff70: 30 30 30 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 000 /* True for
ff80: 6d 69 6e 28 29 20 61 6e 64 20 6d 61 78 28 29 20 min() and max()
ff90: 61 67 67 72 65 67 61 74 65 73 20 2a 2f 0a 23 64 aggregates */.#d
ffa0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
ffb0: 43 5f 53 4c 4f 43 48 4e 47 20 20 30 78 32 30 30 C_SLOCHNG 0x200
ffc0: 30 20 2f 2a 20 22 53 6c 6f 77 20 43 68 61 6e 67 0 /* "Slow Chang
ffd0: 65 22 2e 20 56 61 6c 75 65 20 63 6f 6e 73 74 61 e". Value consta
ffe0: 6e 74 20 64 75 72 69 6e 67 20 61 0a 20 20 20 20 nt during a.
fff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10000 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10010 2a 2a 20 73 69 6e 67 6c 65 20 71 75 65 72 79 20 ** single query
10020 2d 20 6d 69 67 68 74 20 63 68 61 6e 67 65 20 6f - might change o
10030 76 65 72 20 74 69 6d 65 20 2a 2f 0a 23 64 65 66 ver time */.#def
10040 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
10050 41 46 46 49 4e 49 54 59 20 30 78 34 30 30 30 20 AFFINITY 0x4000
10060 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 61 66 66 69 /* Built-in affi
10070 6e 69 74 79 28 29 20 66 75 6e 63 74 69 6f 6e 20 nity() function
10080 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
10090 45 5f 46 55 4e 43 5f 4f 46 46 53 45 54 20 20 20 E_FUNC_OFFSET
100a0 30 78 38 30 30 30 20 2f 2a 20 42 75 69 6c 74 2d 0x8000 /* Built-
100b0 69 6e 20 73 71 6c 69 74 65 5f 6f 66 66 73 65 74 in sqlite_offset
100c0 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 () function */.#
100d0 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 define SQLITE_FU
100e0 4e 43 5f 57 49 4e 44 4f 57 20 20 20 30 78 30 30 NC_WINDOW 0x00
100f0 30 31 30 30 30 30 20 2f 2a 20 42 75 69 6c 74 2d 010000 /* Built-
10100 69 6e 20 77 69 6e 64 6f 77 2d 6f 6e 6c 79 20 66 in window-only f
10110 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 unction */.#defi
10120 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 57 ne SQLITE_FUNC_W
10130 49 4e 44 4f 57 5f 53 49 5a 45 20 30 78 32 30 30 INDOW_SIZE 0x200
10140 30 30 20 2f 2a 20 52 65 71 75 69 72 65 73 20 70 00 /* Requires p
10150 61 72 74 69 74 69 6f 6e 20 73 69 7a 65 20 61 73 artition size as
10160 20 61 72 67 2e 20 2a 2f 0a 23 64 65 66 69 6e 65 arg. */.#define
10170 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 49 4e 54 SQLITE_FUNC_INT
10180 45 52 4e 41 4c 20 30 78 30 30 30 34 30 30 30 30 ERNAL 0x00040000
10190 20 2f 2a 20 46 6f 72 20 75 73 65 20 62 79 20 4e /* For use by N
101a0 65 73 74 65 64 50 61 72 73 65 28 29 20 6f 6e 6c estedParse() onl
101b0 79 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 y */../*.** The
101c0 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 72 65 65 20 following three
101d0 6d 61 63 72 6f 73 2c 20 46 55 4e 43 54 49 4f 4e macros, FUNCTION
101e0 28 29 2c 20 4c 49 4b 45 46 55 4e 43 28 29 20 61 (), LIKEFUNC() a
101f0 6e 64 20 41 47 47 52 45 47 41 54 45 28 29 20 61 nd AGGREGATE() a
10200 72 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 63 72 re.** used to cr
10210 65 61 74 65 20 74 68 65 20 69 6e 69 74 69 61 6c eate the initial
10220 69 7a 65 72 73 20 66 6f 72 20 74 68 65 20 46 75 izers for the Fu
10230 6e 63 44 65 66 20 73 74 72 75 63 74 75 72 65 73 ncDef structures
10240 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 55 4e 43 54 49 ..**.** FUNCTI
10250 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 ON(zName, nArg,
10260 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 iArg, bNC, xFunc
10270 29 0a 2a 2a 20 20 20 20 20 55 73 65 64 20 74 6f ).** Used to
10280 20 63 72 65 61 74 65 20 61 20 73 63 61 6c 61 72 create a scalar
10290 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 function defini
102a0 74 69 6f 6e 20 6f 66 20 61 20 66 75 6e 63 74 69 tion of a functi
102b0 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 20 20 20 20 on zName.**
102c0 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 43 implemented by C
102d0 20 66 75 6e 63 74 69 6f 6e 20 78 46 75 6e 63 20 function xFunc
102e0 74 68 61 74 20 61 63 63 65 70 74 73 20 6e 41 72 that accepts nAr
102f0 67 20 61 72 67 75 6d 65 6e 74 73 2e 20 54 68 65 g arguments. The
10300 0a 2a 2a 20 20 20 20 20 76 61 6c 75 65 20 70 61 .** value pa
10310 73 73 65 64 20 61 73 20 69 41 72 67 20 69 73 20 ssed as iArg is
10320 63 61 73 74 20 74 6f 20 61 20 28 76 6f 69 64 2a cast to a (void*
10330 29 20 61 6e 64 20 6d 61 64 65 20 61 76 61 69 6c ) and made avail
10340 61 62 6c 65 0a 2a 2a 20 20 20 20 20 61 73 20 74 able.** as t
10350 68 65 20 75 73 65 72 2d 64 61 74 61 20 28 73 71 he user-data (sq
10360 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28 lite3_user_data(
10370 29 29 20 66 6f 72 20 74 68 65 20 66 75 6e 63 74 )) for the funct
10380 69 6f 6e 2e 20 49 66 0a 2a 2a 20 20 20 20 20 61 ion. If.** a
10390 72 67 75 6d 65 6e 74 20 62 4e 43 20 69 73 20 74 rgument bNC is t
103a0 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 53 51 rue, then the SQ
103b0 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f LITE_FUNC_NEEDCO
103c0 4c 4c 20 66 6c 61 67 20 69 73 20 73 65 74 2e 0a LL flag is set..
103d0 2a 2a 0a 2a 2a 20 20 20 56 46 55 4e 43 54 49 4f **.** VFUNCTIO
103e0 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 N(zName, nArg, i
103f0 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 Arg, bNC, xFunc)
10400 0a 2a 2a 20 20 20 20 20 4c 69 6b 65 20 46 55 4e .** Like FUN
10410 43 54 49 4f 4e 20 65 78 63 65 70 74 20 69 74 20 CTION except it
10420 6f 6d 69 74 73 20 74 68 65 20 53 51 4c 49 54 45 omits the SQLITE
10430 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 66 _FUNC_CONSTANT f
10440 6c 61 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 46 55 lag..**.** DFU
10450 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 NCTION(zName, nA
10460 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 rg, iArg, bNC, x
10470 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 4c 69 6b Func).** Lik
10480 65 20 46 55 4e 43 54 49 4f 4e 20 65 78 63 65 70 e FUNCTION excep
10490 74 20 69 74 20 6f 6d 69 74 73 20 74 68 65 20 53 t it omits the S
104a0 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 QLITE_FUNC_CONST
104b0 41 4e 54 20 66 6c 61 67 20 61 6e 64 0a 2a 2a 20 ANT flag and.**
104c0 20 20 20 20 61 64 64 73 20 74 68 65 20 53 51 4c adds the SQL
104d0 49 54 45 5f 46 55 4e 43 5f 53 4c 4f 43 48 4e 47 ITE_FUNC_SLOCHNG
104e0 20 66 6c 61 67 2e 20 20 55 73 65 64 20 66 6f 72 flag. Used for
104f0 20 64 61 74 65 20 26 20 74 69 6d 65 20 66 75 6e date & time fun
10500 63 74 69 6f 6e 73 0a 2a 2a 20 20 20 20 20 61 6e ctions.** an
10510 64 20 66 75 6e 63 74 69 6f 6e 73 20 6c 69 6b 65 d functions like
10520 20 73 71 6c 69 74 65 5f 76 65 72 73 69 6f 6e 28 sqlite_version(
10530 29 20 74 68 61 74 20 63 61 6e 20 63 68 61 6e 67 ) that can chang
10540 65 2c 20 62 75 74 20 6e 6f 74 20 64 75 72 69 6e e, but not durin
10550 67 0a 2a 2a 20 20 20 20 20 61 20 73 69 6e 67 6c g.** a singl
10560 65 20 71 75 65 72 79 2e 20 20 54 68 65 20 69 41 e query. The iA
10570 72 67 20 69 73 20 69 67 6e 6f 72 65 64 2e 20 20 rg is ignored.
10580 54 68 65 20 75 73 65 72 2d 64 61 74 61 20 69 73 The user-data is
10590 20 61 6c 77 61 79 73 20 73 65 74 0a 2a 2a 20 20 always set.**
105a0 20 20 20 74 6f 20 61 20 4e 55 4c 4c 20 70 6f 69 to a NULL poi
105b0 6e 74 65 72 2e 20 20 54 68 65 20 62 4e 43 20 70 nter. The bNC p
105c0 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 20 arameter is not
105d0 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 20 20 50 55 used..**.** PU
105e0 52 45 5f 44 41 54 45 28 7a 4e 61 6d 65 2c 20 6e RE_DATE(zName, n
105f0 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 Arg, iArg, bNC,
10600 78 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 55 73 xFunc).** Us
10610 65 64 20 66 6f 72 20 22 70 75 72 65 22 20 64 61 ed for "pure" da
10620 74 65 2f 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e te/time function
10630 73 2c 20 74 68 69 73 20 6d 61 63 72 6f 20 69 73 s, this macro is
10640 20 6c 69 6b 65 20 44 46 55 4e 43 54 49 4f 4e 0a like DFUNCTION.
10650 2a 2a 20 20 20 20 20 65 78 63 65 70 74 20 74 68 ** except th
10660 61 74 20 69 74 20 64 6f 65 73 20 73 65 74 20 74 at it does set t
10670 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 he SQLITE_FUNC_C
10680 4f 4e 53 54 41 4e 54 20 66 6c 61 67 73 2e 20 20 ONSTANT flags.
10690 69 41 72 67 20 69 73 0a 2a 2a 20 20 20 20 20 69 iArg is.** i
106a0 67 6e 6f 72 65 64 20 61 6e 64 20 74 68 65 20 75 gnored and the u
106b0 73 65 72 2d 64 61 74 61 20 66 6f 72 20 74 68 65 ser-data for the
106c0 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 69 73 20 se functions is
106d0 73 65 74 20 74 6f 20 61 6e 20 0a 2a 2a 20 20 20 set to an .**
106e0 20 20 61 72 62 69 74 72 61 72 79 20 6e 6f 6e 2d arbitrary non-
106f0 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 2e 20 20 54 NULL pointer. T
10700 68 65 20 62 4e 43 20 70 61 72 61 6d 65 74 65 72 he bNC parameter
10710 20 69 73 20 6e 6f 74 20 75 73 65 64 2e 0a 2a 2a is not used..**
10720 0a 2a 2a 20 20 20 41 47 47 52 45 47 41 54 45 28 .** AGGREGATE(
10730 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 zName, nArg, iAr
10740 67 2c 20 62 4e 43 2c 20 78 53 74 65 70 2c 20 78 g, bNC, xStep, x
10750 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 20 20 55 73 Final).** Us
10760 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6e 20 ed to create an
10770 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
10780 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 6d on definition im
10790 70 6c 65 6d 65 6e 74 65 64 20 62 79 0a 2a 2a 20 plemented by.**
107a0 20 20 20 20 74 68 65 20 43 20 66 75 6e 63 74 69 the C functi
107b0 6f 6e 73 20 78 53 74 65 70 20 61 6e 64 20 78 46 ons xStep and xF
107c0 69 6e 61 6c 2e 20 54 68 65 20 66 69 72 73 74 20 inal. The first
107d0 66 6f 75 72 20 70 61 72 61 6d 65 74 65 72 73 0a four parameters.
107e0 2a 2a 20 20 20 20 20 61 72 65 20 69 6e 74 65 72 ** are inter
107f0 70 72 65 74 65 64 20 69 6e 20 74 68 65 20 73 61 preted in the sa
10800 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 66 69 me way as the fi
10810 72 73 74 20 34 20 70 61 72 61 6d 65 74 65 72 73 rst 4 parameters
10820 20 74 6f 0a 2a 2a 20 20 20 20 20 46 55 4e 43 54 to.** FUNCT
10830 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 57 ION()..**.** W
10840 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 FUNCTION(zName,
10850 6e 41 72 67 2c 20 69 41 72 67 2c 20 78 53 74 65 nArg, iArg, xSte
10860 70 2c 20 78 46 69 6e 61 6c 2c 20 78 56 61 6c 75 p, xFinal, xValu
10870 65 2c 20 78 49 6e 76 65 72 73 65 29 0a 2a 2a 20 e, xInverse).**
10880 20 20 20 20 55 73 65 64 20 74 6f 20 63 72 65 61 Used to crea
10890 74 65 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 te an aggregate
108a0 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 function definit
108b0 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 ion implemented
108c0 62 79 0a 2a 2a 20 20 20 20 20 74 68 65 20 43 20 by.** the C
108d0 66 75 6e 63 74 69 6f 6e 73 20 78 53 74 65 70 20 functions xStep
108e0 61 6e 64 20 78 46 69 6e 61 6c 2e 20 54 68 65 20 and xFinal. The
108f0 66 69 72 73 74 20 66 6f 75 72 20 70 61 72 61 6d first four param
10900 65 74 65 72 73 0a 2a 2a 20 20 20 20 20 61 72 65 eters.** are
10910 20 69 6e 74 65 72 70 72 65 74 65 64 20 69 6e 20 interpreted in
10920 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 the same way as
10930 74 68 65 20 66 69 72 73 74 20 34 20 70 61 72 61 the first 4 para
10940 6d 65 74 65 72 73 20 74 6f 0a 2a 2a 20 20 20 20 meters to.**
10950 20 46 55 4e 43 54 49 4f 4e 28 29 2e 0a 2a 2a 0a FUNCTION()..**.
10960 2a 2a 20 20 20 4c 49 4b 45 46 55 4e 43 28 7a 4e ** LIKEFUNC(zN
10970 61 6d 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c ame, nArg, pArg,
10980 20 66 6c 61 67 73 29 0a 2a 2a 20 20 20 20 20 55 flags).** U
10990 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 sed to create a
109a0 73 63 61 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 scalar function
109b0 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 definition of a
109c0 66 75 6e 63 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a function zName.*
109d0 2a 20 20 20 20 20 74 68 61 74 20 61 63 63 65 70 * that accep
109e0 74 73 20 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 ts nArg argument
109f0 73 20 61 6e 64 20 69 73 20 69 6d 70 6c 65 6d 65 s and is impleme
10a00 6e 74 65 64 20 62 79 20 61 20 63 61 6c 6c 20 74 nted by a call t
10a10 6f 20 43 0a 2a 2a 20 20 20 20 20 66 75 6e 63 74 o C.** funct
10a20 69 6f 6e 20 6c 69 6b 65 46 75 6e 63 2e 20 41 72 ion likeFunc. Ar
10a30 67 75 6d 65 6e 74 20 70 41 72 67 20 69 73 20 63 gument pArg is c
10a40 61 73 74 20 74 6f 20 61 20 28 76 6f 69 64 20 2a ast to a (void *
10a50 29 20 61 6e 64 20 6d 61 64 65 0a 2a 2a 20 20 20 ) and made.**
10a60 20 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 74 available as t
10a70 68 65 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 72 he function user
10a80 2d 64 61 74 61 20 28 73 71 6c 69 74 65 33 5f 75 -data (sqlite3_u
10a90 73 65 72 5f 64 61 74 61 28 29 29 2e 20 54 68 65 ser_data()). The
10aa0 0a 2a 2a 20 20 20 20 20 46 75 6e 63 44 65 66 2e .** FuncDef.
10ab0 66 6c 61 67 73 20 76 61 72 69 61 62 6c 65 20 69 flags variable i
10ac0 73 20 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c s set to the val
10ad0 75 65 20 70 61 73 73 65 64 20 61 73 20 74 68 65 ue passed as the
10ae0 20 66 6c 61 67 73 0a 2a 2a 20 20 20 20 20 70 61 flags.** pa
10af0 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 rameter..*/.#def
10b00 69 6e 65 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 ine FUNCTION(zNa
10b10 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 me, nArg, iArg,
10b20 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 bNC, xFunc) \.
10b30 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 {nArg, SQLITE_FU
10b40 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 NC_CONSTANT|SQLI
10b50 54 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c TE_UTF8|(bNC*SQL
10b60 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c ITE_FUNC_NEEDCOL
10b70 4c 29 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f L), \. SQLITE_
10b80 49 4e 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 INT_TO_PTR(iArg)
10b90 2c 20 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 , 0, xFunc, 0, 0
10ba0 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 7b 30 7d , 0, #zName, {0}
10bb0 20 7d 0a 23 64 65 66 69 6e 65 20 56 46 55 4e 43 }.#define VFUNC
10bc0 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 TION(zName, nArg
10bd0 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 , iArg, bNC, xFu
10be0 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 nc) \. {nArg, S
10bf0 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 2a QLITE_UTF8|(bNC*
10c00 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 SQLITE_FUNC_NEED
10c10 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 53 51 4c 49 COLL), \. SQLI
10c20 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 69 41 TE_INT_TO_PTR(iA
10c30 72 67 29 2c 20 30 2c 20 78 46 75 6e 63 2c 20 30 rg), 0, xFunc, 0
10c40 2c 20 30 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 , 0, 0, #zName,
10c50 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 44 46 {0} }.#define DF
10c60 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e UNCTION(zName, n
10c70 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 Arg, iArg, bNC,
10c80 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 xFunc) \. {nArg
10c90 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c , SQLITE_FUNC_SL
10ca0 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f 55 54 46 OCHNG|SQLITE_UTF
10cb0 38 2c 20 5c 0a 20 20 20 30 2c 20 30 2c 20 78 46 8, \. 0, 0, xF
10cc0 75 6e 63 2c 20 30 2c 20 30 2c 20 30 2c 20 23 7a unc, 0, 0, 0, #z
10cd0 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 Name, {0} }.#def
10ce0 69 6e 65 20 50 55 52 45 5f 44 41 54 45 28 7a 4e ine PURE_DATE(zN
10cf0 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c ame, nArg, iArg,
10d00 20 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 bNC, xFunc) \.
10d10 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 {nArg, SQLITE_F
10d20 55 4e 43 5f 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 UNC_SLOCHNG|SQLI
10d30 54 45 5f 55 54 46 38 7c 53 51 4c 49 54 45 5f 46 TE_UTF8|SQLITE_F
10d40 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 2c 20 5c 0a UNC_CONSTANT, \.
10d50 20 20 20 28 76 6f 69 64 2a 29 26 73 71 6c 69 74 (void*)&sqlit
10d60 65 33 43 6f 6e 66 69 67 2c 20 30 2c 20 78 46 75 e3Config, 0, xFu
10d70 6e 63 2c 20 30 2c 20 30 2c 20 30 2c 20 23 7a 4e nc, 0, 0, 0, #zN
10d80 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 ame, {0} }.#defi
10d90 6e 65 20 46 55 4e 43 54 49 4f 4e 32 28 7a 4e 61 ne FUNCTION2(zNa
10da0 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 me, nArg, iArg,
10db0 62 4e 43 2c 20 78 46 75 6e 63 2c 20 65 78 74 72 bNC, xFunc, extr
10dc0 61 46 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 aFlags) \. {nAr
10dd0 67 2c 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f g,SQLITE_FUNC_CO
10de0 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 54 NSTANT|SQLITE_UT
10df0 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 F8|(bNC*SQLITE_F
10e00 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 7c 65 78 UNC_NEEDCOLL)|ex
10e10 74 72 61 46 6c 61 67 73 2c 5c 0a 20 20 20 53 51 traFlags,\. SQ
10e20 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 LITE_INT_TO_PTR(
10e30 69 41 72 67 29 2c 20 30 2c 20 78 46 75 6e 63 2c iArg), 0, xFunc,
10e40 20 30 2c 20 30 2c 20 30 2c 20 23 7a 4e 61 6d 65 0, 0, 0, #zName
10e50 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 , {0} }.#define
10e60 53 54 52 5f 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 STR_FUNCTION(zNa
10e70 6d 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 me, nArg, pArg,
10e80 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 bNC, xFunc) \.
10e90 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 {nArg, SQLITE_FU
10ea0 4e 43 5f 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 54 NC_SLOCHNG|SQLIT
10eb0 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 E_UTF8|(bNC*SQLI
10ec0 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
10ed0 29 2c 20 5c 0a 20 20 20 70 41 72 67 2c 20 30 2c ), \. pArg, 0,
10ee0 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 20 30 2c xFunc, 0, 0, 0,
10ef0 20 23 7a 4e 61 6d 65 2c 20 7d 0a 23 64 65 66 69 #zName, }.#defi
10f00 6e 65 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d ne LIKEFUNC(zNam
10f10 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c 20 66 6c e, nArg, arg, fl
10f20 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 ags) \. {nArg,
10f30 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 SQLITE_FUNC_CONS
10f40 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 54 46 38 TANT|SQLITE_UTF8
10f50 7c 66 6c 61 67 73 2c 20 5c 0a 20 20 20 28 76 6f |flags, \. (vo
10f60 69 64 20 2a 29 61 72 67 2c 20 30 2c 20 6c 69 6b id *)arg, 0, lik
10f70 65 46 75 6e 63 2c 20 30 2c 20 30 2c 20 30 2c 20 eFunc, 0, 0, 0,
10f80 23 7a 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 #zName, {0} }.#d
10f90 65 66 69 6e 65 20 41 47 47 52 45 47 41 54 45 28 efine AGGREGATE(
10fa0 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 zName, nArg, arg
10fb0 2c 20 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 , nc, xStep, xFi
10fc0 6e 61 6c 2c 20 78 56 61 6c 75 65 29 20 5c 0a 20 nal, xValue) \.
10fd0 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 {nArg, SQLITE_U
10fe0 54 46 38 7c 28 6e 63 2a 53 51 4c 49 54 45 5f 46 TF8|(nc*SQLITE_F
10ff0 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c UNC_NEEDCOLL), \
11000 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 . SQLITE_INT_T
11010 4f 5f 50 54 52 28 61 72 67 29 2c 20 30 2c 20 78 O_PTR(arg), 0, x
11020 53 74 65 70 2c 78 46 69 6e 61 6c 2c 78 56 61 6c Step,xFinal,xVal
11030 75 65 2c 30 2c 23 7a 4e 61 6d 65 2c 20 7b 30 7d ue,0,#zName, {0}
11040 7d 0a 23 64 65 66 69 6e 65 20 41 47 47 52 45 47 }.#define AGGREG
11050 41 54 45 32 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 ATE2(zName, nArg
11060 2c 20 61 72 67 2c 20 6e 63 2c 20 78 53 74 65 70 , arg, nc, xStep
11070 2c 20 78 46 69 6e 61 6c 2c 20 65 78 74 72 61 46 , xFinal, extraF
11080 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 67 2c lags) \. {nArg,
11090 20 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 6e 63 SQLITE_UTF8|(nc
110a0 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 *SQLITE_FUNC_NEE
110b0 44 43 4f 4c 4c 29 7c 65 78 74 72 61 46 6c 61 67 DCOLL)|extraFlag
110c0 73 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 s, \. SQLITE_I
110d0 4e 54 5f 54 4f 5f 50 54 52 28 61 72 67 29 2c 20 NT_TO_PTR(arg),
110e0 30 2c 20 78 53 74 65 70 2c 78 46 69 6e 61 6c 2c 0, xStep,xFinal,
110f0 78 46 69 6e 61 6c 2c 30 2c 23 7a 4e 61 6d 65 2c xFinal,0,#zName,
11100 20 7b 30 7d 7d 0a 23 64 65 66 69 6e 65 20 57 41 {0}}.#define WA
11110 47 47 52 45 47 41 54 45 28 7a 4e 61 6d 65 2c 20 GGREGATE(zName,
11120 6e 41 72 67 2c 20 61 72 67 2c 20 6e 63 2c 20 78 nArg, arg, nc, x
11130 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 78 56 Step, xFinal, xV
11140 61 6c 75 65 2c 20 78 49 6e 76 65 72 73 65 2c 20 alue, xInverse,
11150 66 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 f) \. {nArg, SQ
11160 4c 49 54 45 5f 55 54 46 38 7c 28 6e 63 2a 53 51 LITE_UTF8|(nc*SQ
11170 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f LITE_FUNC_NEEDCO
11180 4c 4c 29 7c 66 2c 20 5c 0a 20 20 20 53 51 4c 49 LL)|f, \. SQLI
11190 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 61 72 TE_INT_TO_PTR(ar
111a0 67 29 2c 20 30 2c 20 78 53 74 65 70 2c 78 46 69 g), 0, xStep,xFi
111b0 6e 61 6c 2c 78 56 61 6c 75 65 2c 78 49 6e 76 65 nal,xValue,xInve
111c0 72 73 65 2c 23 7a 4e 61 6d 65 2c 20 7b 30 7d 7d rse,#zName, {0}}
111d0 0a 23 64 65 66 69 6e 65 20 49 4e 54 45 52 4e 41 .#define INTERNA
111e0 4c 5f 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 L_FUNCTION(zName
111f0 2c 20 6e 41 72 67 2c 20 78 46 75 6e 63 29 20 5c , nArg, xFunc) \
11200 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 . {nArg, SQLITE
11210 5f 46 55 4e 43 5f 49 4e 54 45 52 4e 41 4c 7c 53 _FUNC_INTERNAL|S
11220 51 4c 49 54 45 5f 55 54 46 38 7c 53 51 4c 49 54 QLITE_UTF8|SQLIT
11230 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 2c E_FUNC_CONSTANT,
11240 20 5c 0a 20 20 20 30 2c 20 30 2c 20 78 46 75 6e \. 0, 0, xFun
11250 63 2c 20 30 2c 20 30 2c 20 30 2c 20 23 7a 4e 61 c, 0, 0, 0, #zNa
11260 6d 65 2c 20 7b 30 7d 20 7d 0a 0a 0a 2f 2a 0a 2a me, {0} }.../*.*
11270 2a 20 41 6c 6c 20 63 75 72 72 65 6e 74 20 73 61 * All current sa
11280 76 65 70 6f 69 6e 74 73 20 61 72 65 20 73 74 6f vepoints are sto
11290 72 65 64 20 69 6e 20 61 20 6c 69 6e 6b 65 64 20 red in a linked
112a0 6c 69 73 74 20 73 74 61 72 74 69 6e 67 20 61 74 list starting at
112b0 0a 2a 2a 20 73 71 6c 69 74 65 33 2e 70 53 61 76 .** sqlite3.pSav
112c0 65 70 6f 69 6e 74 2e 20 54 68 65 20 66 69 72 73 epoint. The firs
112d0 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 74 68 65 t element in the
112e0 20 6c 69 73 74 20 69 73 20 74 68 65 20 6d 6f 73 list is the mos
112f0 74 20 72 65 63 65 6e 74 6c 79 0a 2a 2a 20 6f 70 t recently.** op
11300 65 6e 65 64 20 73 61 76 65 70 6f 69 6e 74 2e 20 ened savepoint.
11310 53 61 76 65 70 6f 69 6e 74 73 20 61 72 65 20 61 Savepoints are a
11320 64 64 65 64 20 74 6f 20 74 68 65 20 6c 69 73 74 dded to the list
11330 20 62 79 20 74 68 65 20 76 64 62 65 0a 2a 2a 20 by the vdbe.**
11340 4f 50 5f 53 61 76 65 70 6f 69 6e 74 20 69 6e 73 OP_Savepoint ins
11350 74 72 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 truction..*/.str
11360 75 63 74 20 53 61 76 65 70 6f 69 6e 74 20 7b 0a uct Savepoint {.
11370 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
11380 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11390 20 20 20 20 20 20 2f 2a 20 53 61 76 65 70 6f 69 /* Savepoi
113a0 6e 74 20 6e 61 6d 65 20 28 6e 75 6c 2d 74 65 72 nt name (nul-ter
113b0 6d 69 6e 61 74 65 64 29 20 2a 2f 0a 20 20 69 36 minated) */. i6
113c0 34 20 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 4 nDeferredCons;
113d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
113e0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 /* Number of d
113f0 65 66 65 72 72 65 64 20 66 6b 20 76 69 6f 6c 61 eferred fk viola
11400 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 36 34 20 6e tions */. i64 n
11410 44 65 66 65 72 72 65 64 49 6d 6d 43 6f 6e 73 3b DeferredImmCons;
11420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
11430 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 65 66 65 * Number of defe
11440 72 72 65 64 20 69 6d 6d 20 66 6b 2e 20 2a 2f 0a rred imm fk. */.
11450 20 20 53 61 76 65 70 6f 69 6e 74 20 2a 70 4e 65 Savepoint *pNe
11460 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 xt;
11470 20 20 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 /* Parent
11480 73 61 76 65 70 6f 69 6e 74 20 28 69 66 20 61 6e savepoint (if an
11490 79 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 y) */.};../*.**
114a0 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 The following ar
114b0 65 20 75 73 65 64 20 61 73 20 74 68 65 20 73 65 e used as the se
114c0 63 6f 6e 64 20 70 61 72 61 6d 65 74 65 72 20 74 cond parameter t
114d0 6f 20 73 71 6c 69 74 65 33 53 61 76 65 70 6f 69 o sqlite3Savepoi
114e0 6e 74 28 29 2c 0a 2a 2a 20 61 6e 64 20 61 73 20 nt(),.** and as
114f0 74 68 65 20 50 31 20 61 72 67 75 6d 65 6e 74 20 the P1 argument
11500 74 6f 20 74 68 65 20 4f 50 5f 53 61 76 65 70 6f to the OP_Savepo
11510 69 6e 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e int instruction.
11520 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 41 56 45 .*/.#define SAVE
11530 50 4f 49 4e 54 5f 42 45 47 49 4e 20 20 20 20 20 POINT_BEGIN
11540 20 30 0a 23 64 65 66 69 6e 65 20 53 41 56 45 50 0.#define SAVEP
11550 4f 49 4e 54 5f 52 45 4c 45 41 53 45 20 20 20 20 OINT_RELEASE
11560 31 0a 23 64 65 66 69 6e 65 20 53 41 56 45 50 4f 1.#define SAVEPO
11570 49 4e 54 5f 52 4f 4c 4c 42 41 43 4b 20 20 20 32 INT_ROLLBACK 2
11580 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 51 .../*.** Each SQ
11590 4c 69 74 65 20 6d 6f 64 75 6c 65 20 28 76 69 72 Lite module (vir
115a0 74 75 61 6c 20 74 61 62 6c 65 20 64 65 66 69 6e tual table defin
115b0 69 74 69 6f 6e 29 20 69 73 20 64 65 66 69 6e 65 ition) is define
115c0 64 20 62 79 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 d by an.** insta
115d0 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
115e0 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2c 20 wing structure,
115f0 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 73 71 stored in the sq
11600 6c 69 74 65 33 2e 61 4d 6f 64 75 6c 65 0a 2a 2a lite3.aModule.**
11610 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 2a 2f 0a hash table..*/.
11620 73 74 72 75 63 74 20 4d 6f 64 75 6c 65 20 7b 0a struct Module {.
11630 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f const sqlite3_
11640 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64 75 6c 65 3b module *pModule;
11650 20 20 20 20 20 20 20 2f 2a 20 43 61 6c 6c 62 61 /* Callba
11660 63 6b 20 70 6f 69 6e 74 65 72 73 20 2a 2f 0a 20 ck pointers */.
11670 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
11680 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 me;
11690 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 70 61 /* Name pa
116a0 73 73 65 64 20 74 6f 20 63 72 65 61 74 65 5f 6d ssed to create_m
116b0 6f 64 75 6c 65 28 29 20 2a 2f 0a 20 20 76 6f 69 odule() */. voi
116c0 64 20 2a 70 41 75 78 3b 20 20 20 20 20 20 20 20 d *pAux;
116d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
116e0 20 20 2f 2a 20 70 41 75 78 20 70 61 73 73 65 64 /* pAux passed
116f0 20 74 6f 20 63 72 65 61 74 65 5f 6d 6f 64 75 6c to create_modul
11700 65 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a e() */. void (*
11710 78 44 65 73 74 72 6f 79 29 28 76 6f 69 64 20 2a xDestroy)(void *
11720 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ); /*
11730 20 4d 6f 64 75 6c 65 20 64 65 73 74 72 75 63 74 Module destruct
11740 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 or function */.
11750 20 54 61 62 6c 65 20 2a 70 45 70 6f 54 61 62 3b Table *pEpoTab;
11760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11770 20 20 20 20 20 20 2f 2a 20 45 70 6f 6e 79 6d 6f /* Eponymo
11780 75 73 20 74 61 62 6c 65 20 66 6f 72 20 74 68 69 us table for thi
11790 73 20 6d 6f 64 75 6c 65 20 2a 2f 0a 7d 3b 0a 0a s module */.};..
117a0 2f 2a 0a 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f /*.** informatio
117b0 6e 20 61 62 6f 75 74 20 65 61 63 68 20 63 6f 6c n about each col
117c0 75 6d 6e 20 6f 66 20 61 6e 20 53 51 4c 20 74 61 umn of an SQL ta
117d0 62 6c 65 20 69 73 20 68 65 6c 64 20 69 6e 20 61 ble is held in a
117e0 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 n instance.** of
117f0 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 2e this structure.
11800 0a 2a 2f 0a 73 74 72 75 63 74 20 43 6f 6c 75 6d .*/.struct Colum
11810 6e 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d n {. char *zNam
11820 65 3b 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f e; /* Name o
11830 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 2c 20 5c f this column, \
11840 30 30 30 2c 20 74 68 65 6e 20 74 68 65 20 74 79 000, then the ty
11850 70 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 44 pe */. Expr *pD
11860 66 6c 74 3b 20 20 20 20 20 2f 2a 20 44 65 66 61 flt; /* Defa
11870 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 74 68 69 ult value of thi
11880 73 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 63 68 s column */. ch
11890 61 72 20 2a 7a 43 6f 6c 6c 3b 20 20 20 20 20 2f ar *zColl; /
118a0 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 * Collating sequ
118b0 65 6e 63 65 2e 20 20 49 66 20 4e 55 4c 4c 2c 20 ence. If NULL,
118c0 75 73 65 20 74 68 65 20 64 65 66 61 75 6c 74 20 use the default
118d0 2a 2f 0a 20 20 75 38 20 6e 6f 74 4e 75 6c 6c 3b */. u8 notNull;
118e0 20 20 20 20 20 20 2f 2a 20 41 6e 20 4f 45 5f 20 /* An OE_
118f0 63 6f 64 65 20 66 6f 72 20 68 61 6e 64 6c 69 6e code for handlin
11900 67 20 61 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e g a NOT NULL con
11910 73 74 72 61 69 6e 74 20 2a 2f 0a 20 20 63 68 61 straint */. cha
11920 72 20 61 66 66 69 6e 69 74 79 3b 20 20 20 2f 2a r affinity; /*
11930 20 4f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 One of the SQLI
11940 54 45 5f 41 46 46 5f 2e 2e 2e 20 76 61 6c 75 65 TE_AFF_... value
11950 73 20 2a 2f 0a 20 20 75 38 20 73 7a 45 73 74 3b s */. u8 szEst;
11960 20 20 20 20 20 20 20 20 2f 2a 20 45 73 74 69 6d /* Estim
11970 61 74 65 64 20 73 69 7a 65 20 6f 66 20 76 61 6c ated size of val
11980 75 65 20 69 6e 20 74 68 69 73 20 63 6f 6c 75 6d ue in this colum
11990 6e 2e 20 73 69 7a 65 6f 66 28 49 4e 54 29 3d 3d n. sizeof(INT)==
119a0 31 20 2a 2f 0a 20 20 75 38 20 63 6f 6c 46 6c 61 1 */. u8 colFla
119b0 67 73 3b 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 gs; /* Boole
119c0 61 6e 20 70 72 6f 70 65 72 74 69 65 73 2e 20 20 an properties.
119d0 53 65 65 20 43 4f 4c 46 4c 41 47 5f 20 64 65 66 See COLFLAG_ def
119e0 69 6e 65 73 20 62 65 6c 6f 77 20 2a 2f 0a 7d 3b ines below */.};
119f0 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c ../* Allowed val
11a00 75 65 73 20 66 6f 72 20 43 6f 6c 75 6d 6e 2e 63 ues for Column.c
11a10 6f 6c 46 6c 61 67 73 3a 0a 2a 2f 0a 23 64 65 66 olFlags:.*/.#def
11a20 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 50 52 49 4d ine COLFLAG_PRIM
11a30 4b 45 59 20 20 30 78 30 30 30 31 20 20 20 20 2f KEY 0x0001 /
11a40 2a 20 43 6f 6c 75 6d 6e 20 69 73 20 70 61 72 74 * Column is part
11a50 20 6f 66 20 74 68 65 20 70 72 69 6d 61 72 79 20 of the primary
11a60 6b 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 43 key */.#define C
11a70 4f 4c 46 4c 41 47 5f 48 49 44 44 45 4e 20 20 20 OLFLAG_HIDDEN
11a80 30 78 30 30 30 32 20 20 20 20 2f 2a 20 41 20 68 0x0002 /* A h
11a90 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 20 69 6e 20 idden column in
11aa0 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 a virtual table
11ab0 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c */.#define COLFL
11ac0 41 47 5f 48 41 53 54 59 50 45 20 20 30 78 30 30 AG_HASTYPE 0x00
11ad0 30 34 20 20 20 20 2f 2a 20 54 79 70 65 20 6e 61 04 /* Type na
11ae0 6d 65 20 66 6f 6c 6c 6f 77 73 20 63 6f 6c 75 6d me follows colum
11af0 6e 20 6e 61 6d 65 20 2a 2f 0a 23 64 65 66 69 6e n name */.#defin
11b00 65 20 43 4f 4c 46 4c 41 47 5f 55 4e 49 51 55 45 e COLFLAG_UNIQUE
11b10 20 20 20 30 78 30 30 30 38 20 20 20 20 2f 2a 20 0x0008 /*
11b20 43 6f 6c 75 6d 6e 20 64 65 66 20 63 6f 6e 74 61 Column def conta
11b30 69 6e 73 20 22 55 4e 49 51 55 45 22 20 6f 72 20 ins "UNIQUE" or
11b40 22 50 4b 22 20 2a 2f 0a 23 64 65 66 69 6e 65 20 "PK" */.#define
11b50 43 4f 4c 46 4c 41 47 5f 53 4f 52 54 45 52 52 45 COLFLAG_SORTERRE
11b60 46 20 30 78 30 30 31 30 20 20 20 2f 2a 20 55 73 F 0x0010 /* Us
11b70 65 20 73 6f 72 74 65 72 2d 72 65 66 73 20 77 69 e sorter-refs wi
11b80 74 68 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a th this column *
11b90 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 22 43 6f 6c 6c /../*.** A "Coll
11ba0 61 74 69 6e 67 20 53 65 71 75 65 6e 63 65 22 20 ating Sequence"
11bb0 69 73 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e is defined by an
11bc0 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
11bd0 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 following.** st
11be0 72 75 63 74 75 72 65 2e 20 43 6f 6e 63 65 70 74 ructure. Concept
11bf0 75 61 6c 6c 79 2c 20 61 20 63 6f 6c 6c 61 74 69 ually, a collati
11c00 6e 67 20 73 65 71 75 65 6e 63 65 20 63 6f 6e 73 ng sequence cons
11c10 69 73 74 73 20 6f 66 20 61 20 6e 61 6d 65 20 61 ists of a name a
11c20 6e 64 0a 2a 2a 20 61 20 63 6f 6d 70 61 72 69 73 nd.** a comparis
11c30 6f 6e 20 72 6f 75 74 69 6e 65 20 74 68 61 74 20 on routine that
11c40 64 65 66 69 6e 65 73 20 74 68 65 20 6f 72 64 65 defines the orde
11c50 72 20 6f 66 20 74 68 61 74 20 73 65 71 75 65 6e r of that sequen
11c60 63 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 43 6f 6c ce..**.** If Col
11c70 6c 53 65 71 2e 78 43 6d 70 20 69 73 20 4e 55 4c lSeq.xCmp is NUL
11c80 4c 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 L, it means that
11c90 20 74 68 65 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e the.** collatin
11ca0 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 75 6e g sequence is un
11cb0 64 65 66 69 6e 65 64 2e 20 20 49 6e 64 69 63 65 defined. Indice
11cc0 73 20 62 75 69 6c 74 20 6f 6e 20 61 6e 20 75 6e s built on an un
11cd0 64 65 66 69 6e 65 64 0a 2a 2a 20 63 6f 6c 6c 61 defined.** colla
11ce0 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 6d 61 ting sequence ma
11cf0 79 20 6e 6f 74 20 62 65 20 72 65 61 64 20 6f 72 y not be read or
11d00 20 77 72 69 74 74 65 6e 2e 0a 2a 2f 0a 73 74 72 written..*/.str
11d10 75 63 74 20 43 6f 6c 6c 53 65 71 20 7b 0a 20 20 uct CollSeq {.
11d20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 char *zName;
11d30 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
11d40 20 74 68 65 20 63 6f 6c 6c 61 74 69 6e 67 20 73 the collating s
11d50 65 71 75 65 6e 63 65 2c 20 55 54 46 2d 38 20 65 equence, UTF-8 e
11d60 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 75 38 20 65 ncoded */. u8 e
11d70 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nc;
11d80 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 /* Text encodi
11d90 6e 67 20 68 61 6e 64 6c 65 64 20 62 79 20 78 43 ng handled by xC
11da0 6d 70 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 2a mp() */. void *
11db0 70 55 73 65 72 3b 20 20 20 20 20 20 20 20 20 20 pUser;
11dc0 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e /* First argumen
11dd0 74 20 74 6f 20 78 43 6d 70 28 29 20 2a 2f 0a 20 t to xCmp() */.
11de0 20 69 6e 74 20 28 2a 78 43 6d 70 29 28 76 6f 69 int (*xCmp)(voi
11df0 64 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f d*,int, const vo
11e00 69 64 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 id*, int, const
11e10 76 6f 69 64 2a 29 3b 0a 20 20 76 6f 69 64 20 28 void*);. void (
11e20 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 3b 20 20 *xDel)(void*);
11e30 2f 2a 20 44 65 73 74 72 75 63 74 6f 72 20 66 6f /* Destructor fo
11e40 72 20 70 55 73 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f r pUser */.};../
11e50 2a 0a 2a 2a 20 41 20 73 6f 72 74 20 6f 72 64 65 *.** A sort orde
11e60 72 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20 r can be either
11e70 41 53 43 20 6f 72 20 44 45 53 43 2e 0a 2a 2f 0a ASC or DESC..*/.
11e80 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
11e90 4f 5f 41 53 43 20 20 20 20 20 20 20 30 20 20 2f O_ASC 0 /
11ea0 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 65 6e 64 * Sort in ascend
11eb0 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 23 64 65 ing order */.#de
11ec0 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 4f 5f 44 fine SQLITE_SO_D
11ed0 45 53 43 20 20 20 20 20 20 31 20 20 2f 2a 20 53 ESC 1 /* S
11ee0 6f 72 74 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 ort in ascending
11ef0 20 6f 72 64 65 72 20 2a 2f 0a 23 64 65 66 69 6e order */.#defin
11f00 65 20 53 51 4c 49 54 45 5f 53 4f 5f 55 4e 44 45 e SQLITE_SO_UNDE
11f10 46 49 4e 45 44 20 2d 31 20 2f 2a 20 4e 6f 20 73 FINED -1 /* No s
11f20 6f 72 74 20 6f 72 64 65 72 20 73 70 65 63 69 66 ort order specif
11f30 69 65 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 6f ied */../*.** Co
11f40 6c 75 6d 6e 20 61 66 66 69 6e 69 74 79 20 74 79 lumn affinity ty
11f50 70 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 pes..**.** These
11f60 20 75 73 65 64 20 74 6f 20 68 61 76 65 20 6d 6e used to have mn
11f70 65 6d 6f 6e 69 63 20 6e 61 6d 65 20 6c 69 6b 65 emonic name like
11f80 20 27 69 27 20 66 6f 72 20 53 51 4c 49 54 45 5f 'i' for SQLITE_
11f90 41 46 46 5f 49 4e 54 45 47 45 52 20 61 6e 64 0a AFF_INTEGER and.
11fa0 2a 2a 20 27 74 27 20 66 6f 72 20 53 51 4c 49 54 ** 't' for SQLIT
11fb0 45 5f 41 46 46 5f 54 45 58 54 2e 20 20 42 75 74 E_AFF_TEXT. But
11fc0 20 77 65 20 63 61 6e 20 73 61 76 65 20 61 20 6c we can save a l
11fd0 69 74 74 6c 65 20 73 70 61 63 65 20 61 6e 64 20 ittle space and
11fe0 69 6d 70 72 6f 76 65 0a 2a 2a 20 74 68 65 20 73 improve.** the s
11ff0 70 65 65 64 20 61 20 6c 69 74 74 6c 65 20 62 79 peed a little by
12000 20 6e 75 6d 62 65 72 69 6e 67 20 74 68 65 20 76 numbering the v
12010 61 6c 75 65 73 20 63 6f 6e 73 65 63 75 74 69 76 alues consecutiv
12020 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 42 75 74 20 72 ely..**.** But r
12030 61 74 68 65 72 20 74 68 61 6e 20 73 74 61 72 74 ather than start
12040 20 77 69 74 68 20 30 20 6f 72 20 31 2c 20 77 65 with 0 or 1, we
12050 20 62 65 67 69 6e 20 77 69 74 68 20 27 41 27 2e begin with 'A'.
12060 20 20 54 68 61 74 20 77 61 79 2c 0a 2a 2a 20 77 That way,.** w
12070 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 61 66 66 hen multiple aff
12080 69 6e 69 74 79 20 74 79 70 65 73 20 61 72 65 20 inity types are
12090 63 6f 6e 63 61 74 65 6e 61 74 65 64 20 69 6e 74 concatenated int
120a0 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 0a 2a o a string and.*
120b0 2a 20 75 73 65 64 20 61 73 20 74 68 65 20 50 34 * used as the P4
120c0 20 6f 70 65 72 61 6e 64 2c 20 74 68 65 79 20 77 operand, they w
120d0 69 6c 6c 20 62 65 20 6d 6f 72 65 20 72 65 61 64 ill be more read
120e0 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 able..**.** Note
120f0 20 61 6c 73 6f 20 74 68 61 74 20 74 68 65 20 6e also that the n
12100 75 6d 65 72 69 63 20 74 79 70 65 73 20 61 72 65 umeric types are
12110 20 67 72 6f 75 70 65 64 20 74 6f 67 65 74 68 65 grouped togethe
12120 72 20 73 6f 20 74 68 61 74 20 74 65 73 74 69 6e r so that testin
12130 67 0a 2a 2a 20 66 6f 72 20 61 20 6e 75 6d 65 72 g.** for a numer
12140 69 63 20 74 79 70 65 20 69 73 20 61 20 73 69 6e ic type is a sin
12150 67 6c 65 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 20 gle comparison.
12160 20 41 6e 64 20 74 68 65 20 42 4c 4f 42 20 74 79 And the BLOB ty
12170 70 65 20 69 73 20 66 69 72 73 74 2e 0a 2a 2f 0a pe is first..*/.
12180 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 #define SQLITE_A
12190 46 46 5f 42 4c 4f 42 20 20 20 20 20 27 41 27 0a FF_BLOB 'A'.
121a0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 #define SQLITE_A
121b0 46 46 5f 54 45 58 54 20 20 20 20 20 27 42 27 0a FF_TEXT 'B'.
121c0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 #define SQLITE_A
121d0 46 46 5f 4e 55 4d 45 52 49 43 20 20 27 43 27 0a FF_NUMERIC 'C'.
121e0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 #define SQLITE_A
121f0 46 46 5f 49 4e 54 45 47 45 52 20 20 27 44 27 0a FF_INTEGER 'D'.
12200 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 #define SQLITE_A
12210 46 46 5f 52 45 41 4c 20 20 20 20 20 27 45 27 0a FF_REAL 'E'.
12220 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 .#define sqlite3
12230 49 73 4e 75 6d 65 72 69 63 41 66 66 69 6e 69 74 IsNumericAffinit
12240 79 28 58 29 20 20 28 28 58 29 3e 3d 53 51 4c 49 y(X) ((X)>=SQLI
12250 54 45 5f 41 46 46 5f 4e 55 4d 45 52 49 43 29 0a TE_AFF_NUMERIC).
12260 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 ./*.** The SQLIT
12270 45 5f 41 46 46 5f 4d 41 53 4b 20 76 61 6c 75 65 E_AFF_MASK value
12280 73 20 6d 61 73 6b 73 20 6f 66 66 20 74 68 65 20 s masks off the
12290 73 69 67 6e 69 66 69 63 61 6e 74 20 62 69 74 73 significant bits
122a0 20 6f 66 20 61 6e 0a 2a 2a 20 61 66 66 69 6e 69 of an.** affini
122b0 74 79 20 76 61 6c 75 65 2e 0a 2a 2f 0a 23 64 65 ty value..*/.#de
122c0 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f fine SQLITE_AFF_
122d0 4d 41 53 4b 20 20 20 20 20 30 78 34 37 0a 0a 2f MASK 0x47../
122e0 2a 0a 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c 20 *.** Additional
122f0 62 69 74 20 76 61 6c 75 65 73 20 74 68 61 74 20 bit values that
12300 63 61 6e 20 62 65 20 4f 52 65 64 20 77 69 74 68 can be ORed with
12310 20 61 6e 20 61 66 66 69 6e 69 74 79 20 77 69 74 an affinity wit
12320 68 6f 75 74 0a 2a 2a 20 63 68 61 6e 67 69 6e 67 hout.** changing
12330 20 74 68 65 20 61 66 66 69 6e 69 74 79 2e 0a 2a the affinity..*
12340 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f *.** The SQLITE_
12350 4e 4f 54 4e 55 4c 4c 20 66 6c 61 67 20 69 73 20 NOTNULL flag is
12360 61 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 6f 66 a combination of
12370 20 4e 55 4c 4c 45 51 20 61 6e 64 20 4a 55 4d 50 NULLEQ and JUMP
12380 49 46 4e 55 4c 4c 2e 0a 2a 2a 20 49 74 20 63 61 IFNULL..** It ca
12390 75 73 65 73 20 61 6e 20 61 73 73 65 72 74 28 29 uses an assert()
123a0 20 74 6f 20 66 69 72 65 20 69 66 20 65 69 74 68 to fire if eith
123b0 65 72 20 6f 70 65 72 61 6e 64 20 74 6f 20 61 20 er operand to a
123c0 63 6f 6d 70 61 72 69 73 6f 6e 0a 2a 2a 20 6f 70 comparison.** op
123d0 65 72 61 74 6f 72 20 69 73 20 4e 55 4c 4c 2e 20 erator is NULL.
123e0 20 49 74 20 69 73 20 61 64 64 65 64 20 74 6f 20 It is added to
123f0 63 65 72 74 61 69 6e 20 63 6f 6d 70 61 72 69 73 certain comparis
12400 6f 6e 20 6f 70 65 72 61 74 6f 72 73 20 74 6f 0a on operators to.
12410 2a 2a 20 70 72 6f 76 65 20 74 68 61 74 20 74 68 ** prove that th
12420 65 20 6f 70 65 72 61 6e 64 73 20 61 72 65 20 61 e operands are a
12430 6c 77 61 79 73 20 4e 4f 54 20 4e 55 4c 4c 2e 0a lways NOT NULL..
12440 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
12450 45 5f 4b 45 45 50 4e 55 4c 4c 20 20 20 20 20 30 E_KEEPNULL 0
12460 78 30 38 20 20 2f 2a 20 55 73 65 64 20 62 79 20 x08 /* Used by
12470 76 65 63 74 6f 72 20 3d 3d 20 6f 72 20 3c 3e 20 vector == or <>
12480 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
12490 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c 20 20 20 30 E_JUMPIFNULL 0
124a0 78 31 30 20 20 2f 2a 20 6a 75 6d 70 73 20 69 66 x10 /* jumps if
124b0 20 65 69 74 68 65 72 20 6f 70 65 72 61 6e 64 20 either operand
124c0 69 73 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 69 is NULL */.#defi
124d0 6e 65 20 53 51 4c 49 54 45 5f 53 54 4f 52 45 50 ne SQLITE_STOREP
124e0 32 20 20 20 20 20 20 30 78 32 30 20 20 2f 2a 20 2 0x20 /*
124f0 53 74 6f 72 65 20 72 65 73 75 6c 74 20 69 6e 20 Store result in
12500 72 65 67 5b 50 32 5d 20 72 61 74 68 65 72 20 74 reg[P2] rather t
12510 68 61 6e 20 6a 75 6d 70 20 2a 2f 0a 23 64 65 66 han jump */.#def
12520 69 6e 65 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 45 ine SQLITE_NULLE
12530 51 20 20 20 20 20 20 20 30 78 38 30 20 20 2f 2a Q 0x80 /*
12540 20 4e 55 4c 4c 3d 4e 55 4c 4c 20 2a 2f 0a 23 64 NULL=NULL */.#d
12550 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 54 efine SQLITE_NOT
12560 4e 55 4c 4c 20 20 20 20 20 20 30 78 39 30 20 20 NULL 0x90
12570 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74 20 6f /* Assert that o
12580 70 65 72 61 6e 64 73 20 61 72 65 20 6e 65 76 65 perands are neve
12590 72 20 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a r NULL */../*.**
125a0 20 41 6e 20 6f 62 6a 65 63 74 20 6f 66 20 74 68 An object of th
125b0 69 73 20 74 79 70 65 20 69 73 20 63 72 65 61 74 is type is creat
125c0 65 64 20 66 6f 72 20 65 61 63 68 20 76 69 72 74 ed for each virt
125d0 75 61 6c 20 74 61 62 6c 65 20 70 72 65 73 65 6e ual table presen
125e0 74 20 69 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61 t in.** the data
125f0 62 61 73 65 20 73 63 68 65 6d 61 2e 0a 2a 2a 0a base schema..**.
12600 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 ** If the databa
12610 73 65 20 73 63 68 65 6d 61 20 69 73 20 73 68 61 se schema is sha
12620 72 65 64 2c 20 74 68 65 6e 20 74 68 65 72 65 20 red, then there
12630 69 73 20 6f 6e 65 20 69 6e 73 74 61 6e 63 65 20 is one instance
12640 6f 66 20 74 68 69 73 0a 2a 2a 20 73 74 72 75 63 of this.** struc
12650 74 75 72 65 20 66 6f 72 20 65 61 63 68 20 64 61 ture for each da
12660 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
12670 6e 20 28 73 71 6c 69 74 65 33 2a 29 20 74 68 61 n (sqlite3*) tha
12680 74 20 75 73 65 73 20 74 68 65 20 73 68 61 72 65 t uses the share
12690 64 0a 2a 2a 20 73 63 68 65 6d 61 2e 20 54 68 69 d.** schema. Thi
126a0 73 20 69 73 20 62 65 63 61 75 73 65 20 65 61 63 s is because eac
126b0 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 h database conne
126c0 63 74 69 6f 6e 20 72 65 71 75 69 72 65 73 20 69 ction requires i
126d0 74 73 20 6f 77 6e 20 75 6e 69 71 75 65 0a 2a 2a ts own unique.**
126e0 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
126f0 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 sqlite3_vtab* h
12700 61 6e 64 6c 65 20 75 73 65 64 20 74 6f 20 61 63 andle used to ac
12710 63 65 73 73 20 74 68 65 20 76 69 72 74 75 61 6c cess the virtual
12720 20 74 61 62 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d table.** implem
12730 65 6e 74 61 74 69 6f 6e 2e 20 73 71 6c 69 74 65 entation. sqlite
12740 33 5f 76 74 61 62 2a 20 68 61 6e 64 6c 65 73 20 3_vtab* handles
12750 63 61 6e 20 6e 6f 74 20 62 65 20 73 68 61 72 65 can not be share
12760 64 20 62 65 74 77 65 65 6e 0a 2a 2a 20 64 61 74 d between.** dat
12770 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
12780 73 2c 20 65 76 65 6e 20 77 68 65 6e 20 74 68 65 s, even when the
12790 20 72 65 73 74 20 6f 66 20 74 68 65 20 69 6e 2d rest of the in-
127a0 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 0a memory database.
127b0 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 73 68 61 ** schema is sha
127c0 72 65 64 2c 20 61 73 20 74 68 65 20 69 6d 70 6c red, as the impl
127d0 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 74 65 6e ementation often
127e0 20 73 74 6f 72 65 73 20 74 68 65 20 64 61 74 61 stores the data
127f0 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 base.** connecti
12800 6f 6e 20 68 61 6e 64 6c 65 20 70 61 73 73 65 64 on handle passed
12810 20 74 6f 20 69 74 20 76 69 61 20 74 68 65 20 78 to it via the x
12820 43 6f 6e 6e 65 63 74 28 29 20 6f 72 20 78 43 72 Connect() or xCr
12830 65 61 74 65 28 29 20 6d 65 74 68 6f 64 0a 2a 2a eate() method.**
12840 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 during initiali
12850 7a 61 74 69 6f 6e 20 69 6e 74 65 72 6e 61 6c 6c zation internall
12860 79 2e 20 54 68 69 73 20 64 61 74 61 62 61 73 65 y. This database
12870 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 connection hand
12880 6c 65 20 6d 61 79 0a 2a 2a 20 74 68 65 6e 20 62 le may.** then b
12890 65 20 75 73 65 64 20 62 79 20 74 68 65 20 76 69 e used by the vi
128a0 72 74 75 61 6c 20 74 61 62 6c 65 20 69 6d 70 6c rtual table impl
128b0 65 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 61 63 ementation to ac
128c0 63 65 73 73 20 72 65 61 6c 20 74 61 62 6c 65 73 cess real tables
128d0 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 64 .** within the d
128e0 61 74 61 62 61 73 65 2e 20 53 6f 20 74 68 61 74 atabase. So that
128f0 20 74 68 65 79 20 61 70 70 65 61 72 20 61 73 20 they appear as
12900 70 61 72 74 20 6f 66 20 74 68 65 20 63 61 6c 6c part of the call
12910 65 72 73 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 ers.** transacti
12920 6f 6e 2c 20 74 68 65 73 65 20 61 63 63 65 73 73 on, these access
12930 65 73 20 6e 65 65 64 20 74 6f 20 62 65 20 6d 61 es need to be ma
12940 64 65 20 76 69 61 20 74 68 65 20 73 61 6d 65 20 de via the same
12950 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e database.** conn
12960 65 63 74 69 6f 6e 20 61 73 20 74 68 61 74 20 75 ection as that u
12970 73 65 64 20 74 6f 20 65 78 65 63 75 74 65 20 53 sed to execute S
12980 51 4c 20 6f 70 65 72 61 74 69 6f 6e 73 20 6f 6e QL operations on
12990 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 the virtual tab
129a0 6c 65 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 56 54 le..**.** All VT
129b0 61 62 6c 65 20 6f 62 6a 65 63 74 73 20 74 68 61 able objects tha
129c0 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 t correspond to
129d0 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 69 a single table i
129e0 6e 20 61 20 73 68 61 72 65 64 0a 2a 2a 20 64 61 n a shared.** da
129f0 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 61 72 tabase schema ar
12a00 65 20 69 6e 69 74 69 61 6c 6c 79 20 73 74 6f 72 e initially stor
12a10 65 64 20 69 6e 20 61 20 6c 69 6e 6b 65 64 2d 6c ed in a linked-l
12a20 69 73 74 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 ist pointed to b
12a30 79 0a 2a 2a 20 74 68 65 20 54 61 62 6c 65 2e 70 y.** the Table.p
12a40 56 54 61 62 6c 65 20 6d 65 6d 62 65 72 20 76 61 VTable member va
12a50 72 69 61 62 6c 65 20 6f 66 20 74 68 65 20 63 6f riable of the co
12a60 72 72 65 73 70 6f 6e 64 69 6e 67 20 54 61 62 6c rresponding Tabl
12a70 65 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 57 68 65 e object..** Whe
12a80 6e 20 61 6e 20 73 71 6c 69 74 65 33 5f 70 72 65 n an sqlite3_pre
12a90 70 61 72 65 28 29 20 6f 70 65 72 61 74 69 6f 6e pare() operation
12aa0 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 is required to
12ab0 61 63 63 65 73 73 20 74 68 65 20 76 69 72 74 75 access the virtu
12ac0 61 6c 0a 2a 2a 20 74 61 62 6c 65 2c 20 69 74 20 al.** table, it
12ad0 73 65 61 72 63 68 65 73 20 74 68 65 20 6c 69 73 searches the lis
12ae0 74 20 66 6f 72 20 74 68 65 20 56 54 61 62 6c 65 t for the VTable
12af0 20 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 that correspond
12b00 73 20 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 61 s to the.** data
12b10 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 base connection
12b20 64 6f 69 6e 67 20 74 68 65 20 70 72 65 70 61 72 doing the prepar
12b30 69 6e 67 20 73 6f 20 61 73 20 74 6f 20 75 73 65 ing so as to use
12b40 20 74 68 65 20 63 6f 72 72 65 63 74 0a 2a 2a 20 the correct.**
12b50 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 61 sqlite3_vtab* ha
12b60 6e 64 6c 65 20 69 6e 20 74 68 65 20 63 6f 6d 70 ndle in the comp
12b70 69 6c 65 64 20 71 75 65 72 79 2e 0a 2a 2a 0a 2a iled query..**.*
12b80 2a 20 57 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d * When an in-mem
12b90 6f 72 79 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 ory Table object
12ba0 20 69 73 20 64 65 6c 65 74 65 64 20 28 66 6f 72 is deleted (for
12bb0 20 65 78 61 6d 70 6c 65 20 77 68 65 6e 20 74 68 example when th
12bc0 65 0a 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 62 e.** schema is b
12bd0 65 69 6e 67 20 72 65 6c 6f 61 64 65 64 20 66 6f eing reloaded fo
12be0 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 29 2c 20 r some reason),
12bf0 74 68 65 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 the VTable objec
12c00 74 73 20 61 72 65 20 6e 6f 74 0a 2a 2a 20 64 65 ts are not.** de
12c10 6c 65 74 65 64 20 61 6e 64 20 74 68 65 20 73 71 leted and the sq
12c20 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 lite3_vtab* hand
12c30 6c 65 73 20 61 72 65 20 6e 6f 74 20 78 44 69 73 les are not xDis
12c40 63 6f 6e 6e 65 63 74 28 29 65 64 0a 2a 2a 20 69 connect()ed.** i
12c50 6d 6d 65 64 69 61 74 65 6c 79 2e 20 49 6e 73 74 mmediately. Inst
12c60 65 61 64 2c 20 74 68 65 79 20 61 72 65 20 6d 6f ead, they are mo
12c70 76 65 64 20 66 72 6f 6d 20 74 68 65 20 54 61 62 ved from the Tab
12c80 6c 65 2e 70 56 54 61 62 6c 65 20 6c 69 73 74 20 le.pVTable list
12c90 74 6f 0a 2a 2a 20 61 6e 6f 74 68 65 72 20 6c 69 to.** another li
12ca0 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 64 65 64 nked list headed
12cb0 20 62 79 20 74 68 65 20 73 71 6c 69 74 65 33 2e by the sqlite3.
12cc0 70 44 69 73 63 6f 6e 6e 65 63 74 20 6d 65 6d 62 pDisconnect memb
12cd0 65 72 20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f 72 er of the.** cor
12ce0 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c 69 74 responding sqlit
12cf0 65 33 20 73 74 72 75 63 74 75 72 65 2e 20 54 68 e3 structure. Th
12d00 65 79 20 61 72 65 20 74 68 65 6e 20 64 65 6c 65 ey are then dele
12d10 74 65 64 2f 78 44 69 73 63 6f 6e 6e 65 63 74 65 ted/xDisconnecte
12d20 64 0a 2a 2a 20 6e 65 78 74 20 74 69 6d 65 20 61 d.** next time a
12d30 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 70 72 statement is pr
12d40 65 70 61 72 65 64 20 75 73 69 6e 67 20 73 61 69 epared using sai
12d50 64 20 73 71 6c 69 74 65 33 2a 2e 20 54 68 69 73 d sqlite3*. This
12d60 20 69 73 20 64 6f 6e 65 0a 2a 2a 20 74 6f 20 61 is done.** to a
12d70 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b 20 69 73 void deadlock is
12d80 73 75 65 73 20 69 6e 76 6f 6c 76 69 6e 67 20 6d sues involving m
12d90 75 6c 74 69 70 6c 65 20 73 71 6c 69 74 65 33 2e ultiple sqlite3.
12da0 6d 75 74 65 78 20 6d 75 74 65 78 65 73 2e 0a 2a mutex mutexes..*
12db0 2a 20 52 65 66 65 72 20 74 6f 20 63 6f 6d 6d 65 * Refer to comme
12dc0 6e 74 73 20 61 62 6f 76 65 20 66 75 6e 63 74 69 nts above functi
12dd0 6f 6e 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e on sqlite3VtabUn
12de0 6c 6f 63 6b 4c 69 73 74 28 29 20 66 6f 72 20 61 lockList() for a
12df0 6e 0a 2a 2a 20 65 78 70 6c 61 6e 61 74 69 6f 6e n.** explanation
12e00 20 61 73 20 74 6f 20 77 68 79 20 69 74 20 69 73 as to why it is
12e10 20 73 61 66 65 20 74 6f 20 61 64 64 20 61 6e 20 safe to add an
12e20 65 6e 74 72 79 20 74 6f 20 61 6e 20 73 71 6c 69 entry to an sqli
12e30 74 65 33 2e 70 44 69 73 63 6f 6e 6e 65 63 74 0a te3.pDisconnect.
12e40 2a 2a 20 6c 69 73 74 20 77 69 74 68 6f 75 74 20 ** list without
12e50 68 6f 6c 64 69 6e 67 20 74 68 65 20 63 6f 72 72 holding the corr
12e60 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c 69 74 65 esponding sqlite
12e70 33 2e 6d 75 74 65 78 20 6d 75 74 65 78 2e 0a 2a 3.mutex mutex..*
12e80 2a 0a 2a 2a 20 54 68 65 20 6d 65 6d 6f 72 79 20 *.** The memory
12e90 66 6f 72 20 6f 62 6a 65 63 74 73 20 6f 66 20 74 for objects of t
12ea0 68 69 73 20 74 79 70 65 20 69 73 20 61 6c 77 61 his type is alwa
12eb0 79 73 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 0a ys allocated by.
12ec0 2a 2a 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c ** sqlite3DbMall
12ed0 6f 63 28 29 2c 20 75 73 69 6e 67 20 74 68 65 20 oc(), using the
12ee0 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c connection handl
12ef0 65 20 73 74 6f 72 65 64 20 69 6e 20 56 54 61 62 e stored in VTab
12f00 6c 65 2e 64 62 20 61 73 0a 2a 2a 20 74 68 65 20 le.db as.** the
12f10 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a first argument..
12f20 2a 2f 0a 73 74 72 75 63 74 20 56 54 61 62 6c 65 */.struct VTable
12f30 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 {. sqlite3 *db
12f40 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
12f50 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 * Database conne
12f60 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 ction associated
12f70 20 77 69 74 68 20 74 68 69 73 20 74 61 62 6c 65 with this table
12f80 20 2a 2f 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 4d */. Module *pM
12f90 6f 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 od;
12fa0 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 6d 6f /* Pointer to mo
12fb0 64 75 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 dule implementat
12fc0 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 ion */. sqlite3
12fd0 5f 76 74 61 62 20 2a 70 56 74 61 62 3b 20 20 20 _vtab *pVtab;
12fe0 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
12ff0 20 76 74 61 62 20 69 6e 73 74 61 6e 63 65 20 2a vtab instance *
13000 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 /. int nRef;
13010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
13020 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 Number of point
13030 65 72 73 20 74 6f 20 74 68 69 73 20 73 74 72 75 ers to this stru
13040 63 74 75 72 65 20 2a 2f 0a 20 20 75 38 20 62 43 cture */. u8 bC
13050 6f 6e 73 74 72 61 69 6e 74 3b 20 20 20 20 20 20 onstraint;
13060 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
13070 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 72 65 20 constraints are
13080 73 75 70 70 6f 72 74 65 64 20 2a 2f 0a 20 20 69 supported */. i
13090 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 3b 20 20 nt iSavepoint;
130a0 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 70 74 /* Dept
130b0 68 20 6f 66 20 74 68 65 20 53 41 56 45 50 4f 49 h of the SAVEPOI
130c0 4e 54 20 73 74 61 63 6b 20 2a 2f 0a 20 20 56 54 NT stack */. VT
130d0 61 62 6c 65 20 2a 70 4e 65 78 74 3b 20 20 20 20 able *pNext;
130e0 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 /* Next
130f0 69 6e 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 28 in linked list (
13100 73 65 65 20 61 62 6f 76 65 29 20 2a 2f 0a 7d 3b see above) */.};
13110 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 63 68 65 ../*.** The sche
13120 6d 61 20 66 6f 72 20 65 61 63 68 20 53 51 4c 20 ma for each SQL
13130 74 61 62 6c 65 20 61 6e 64 20 76 69 65 77 20 69 table and view i
13140 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 69 6e s represented in
13150 20 6d 65 6d 6f 72 79 0a 2a 2a 20 62 79 20 61 6e memory.** by an
13160 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
13170 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
13180 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ture..*/.struct
13190 54 61 62 6c 65 20 7b 0a 20 20 63 68 61 72 20 2a Table {. char *
131a0 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 2f zName; /
131b0 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 * Name of the ta
131c0 62 6c 65 20 6f 72 20 76 69 65 77 20 2a 2f 0a 20 ble or view */.
131d0 20 43 6f 6c 75 6d 6e 20 2a 61 43 6f 6c 3b 20 20 Column *aCol;
131e0 20 20 20 20 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 /* Informa
131f0 74 69 6f 6e 20 61 62 6f 75 74 20 65 61 63 68 20 tion about each
13200 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 49 6e 64 65 column */. Inde
13210 78 20 2a 70 49 6e 64 65 78 3b 20 20 20 20 20 20 x *pIndex;
13220 20 2f 2a 20 4c 69 73 74 20 6f 66 20 53 51 4c 20 /* List of SQL
13230 69 6e 64 65 78 65 73 20 6f 6e 20 74 68 69 73 20 indexes on this
13240 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 53 65 6c 65 table. */. Sele
13250 63 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 20 ct *pSelect;
13260 20 2f 2a 20 4e 55 4c 4c 20 66 6f 72 20 74 61 62 /* NULL for tab
13270 6c 65 73 2e 20 20 50 6f 69 6e 74 73 20 74 6f 20 les. Points to
13280 64 65 66 69 6e 69 74 69 6f 6e 20 69 66 20 61 20 definition if a
13290 76 69 65 77 2e 20 2a 2f 0a 20 20 46 4b 65 79 20 view. */. FKey
132a0 2a 70 46 4b 65 79 3b 20 20 20 20 20 20 20 20 20 *pFKey;
132b0 2f 2a 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f /* Linked list o
132c0 66 20 61 6c 6c 20 66 6f 72 65 69 67 6e 20 6b 65 f all foreign ke
132d0 79 73 20 69 6e 20 74 68 69 73 20 74 61 62 6c 65 ys in this table
132e0 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6c */. char *zCol
132f0 41 66 66 3b 20 20 20 20 20 20 20 2f 2a 20 53 74 Aff; /* St
13300 72 69 6e 67 20 64 65 66 69 6e 69 6e 67 20 74 68 ring defining th
13310 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 65 61 e affinity of ea
13320 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 45 ch column */. E
13330 78 70 72 4c 69 73 74 20 2a 70 43 68 65 63 6b 3b xprList *pCheck;
13340 20 20 20 20 2f 2a 20 41 6c 6c 20 43 48 45 43 4b /* All CHECK
13350 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
13360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13370 20 20 20 20 20 20 20 2f 2a 20 20 20 2e 2e 2e 20 /* ...
13380 61 6c 73 6f 20 75 73 65 64 20 61 73 20 63 6f 6c also used as col
13390 75 6d 6e 20 6e 61 6d 65 20 6c 69 73 74 20 69 6e umn name list in
133a0 20 61 20 56 49 45 57 20 2a 2f 0a 20 20 69 6e 74 a VIEW */. int
133b0 20 74 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 20 tnum;
133c0 20 20 2f 2a 20 52 6f 6f 74 20 42 54 72 65 65 20 /* Root BTree
133d0 70 61 67 65 20 66 6f 72 20 74 68 69 73 20 74 61 page for this ta
133e0 62 6c 65 20 2a 2f 0a 20 20 75 33 32 20 6e 54 61 ble */. u32 nTa
133f0 62 52 65 66 3b 20 20 20 20 20 20 20 20 20 2f 2a bRef; /*
13400 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 Number of point
13410 65 72 73 20 74 6f 20 74 68 69 73 20 54 61 62 6c ers to this Tabl
13420 65 20 2a 2f 0a 20 20 75 33 32 20 74 61 62 46 6c e */. u32 tabFl
13430 61 67 73 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d ags; /* M
13440 61 73 6b 20 6f 66 20 54 46 5f 2a 20 76 61 6c 75 ask of TF_* valu
13450 65 73 20 2a 2f 0a 20 20 69 31 36 20 69 50 4b 65 es */. i16 iPKe
13460 79 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 y; /*
13470 49 66 20 6e 6f 74 20 6e 65 67 61 74 69 76 65 2c If not negative,
13480 20 75 73 65 20 61 43 6f 6c 5b 69 50 4b 65 79 5d use aCol[iPKey]
13490 20 61 73 20 74 68 65 20 72 6f 77 69 64 20 2a 2f as the rowid */
134a0 0a 20 20 69 31 36 20 6e 43 6f 6c 3b 20 20 20 20 . i16 nCol;
134b0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
134c0 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 r of columns in
134d0 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 this table */.
134e0 4c 6f 67 45 73 74 20 6e 52 6f 77 4c 6f 67 45 73 LogEst nRowLogEs
134f0 74 3b 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 t; /* Estimate
13500 64 20 72 6f 77 73 20 69 6e 20 74 61 62 6c 65 20 d rows in table
13510 2d 20 66 72 6f 6d 20 73 71 6c 69 74 65 5f 73 74 - from sqlite_st
13520 61 74 31 20 74 61 62 6c 65 20 2a 2f 0a 20 20 4c at1 table */. L
13530 6f 67 45 73 74 20 73 7a 54 61 62 52 6f 77 3b 20 ogEst szTabRow;
13540 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 /* Estimated
13550 20 73 69 7a 65 20 6f 66 20 65 61 63 68 20 74 61 size of each ta
13560 62 6c 65 20 72 6f 77 20 69 6e 20 62 79 74 65 73 ble row in bytes
13570 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
13580 45 5f 45 4e 41 42 4c 45 5f 43 4f 53 54 4d 55 4c E_ENABLE_COSTMUL
13590 54 0a 20 20 4c 6f 67 45 73 74 20 63 6f 73 74 4d T. LogEst costM
135a0 75 6c 74 3b 20 20 20 20 20 2f 2a 20 43 6f 73 74 ult; /* Cost
135b0 20 6d 75 6c 74 69 70 6c 69 65 72 20 66 6f 72 20 multiplier for
135c0 75 73 69 6e 67 20 74 68 69 73 20 74 61 62 6c 65 using this table
135d0 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 75 38 20 */.#endif. u8
135e0 6b 65 79 43 6f 6e 66 3b 20 20 20 20 20 20 20 20 keyConf;
135f0 20 20 2f 2a 20 57 68 61 74 20 74 6f 20 64 6f 20 /* What to do
13600 69 6e 20 63 61 73 65 20 6f 66 20 75 6e 69 71 75 in case of uniqu
13610 65 6e 65 73 73 20 63 6f 6e 66 6c 69 63 74 20 6f eness conflict o
13620 6e 20 69 50 4b 65 79 20 2a 2f 0a 23 69 66 6e 64 n iPKey */.#ifnd
13630 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
13640 4c 54 45 52 54 41 42 4c 45 0a 20 20 69 6e 74 20 LTERTABLE. int
13650 61 64 64 43 6f 6c 4f 66 66 73 65 74 3b 20 20 20 addColOffset;
13660 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 20 43 52 /* Offset in CR
13670 45 41 54 45 20 54 41 42 4c 45 20 73 74 6d 74 20 EATE TABLE stmt
13680 74 6f 20 61 64 64 20 61 20 6e 65 77 20 63 6f 6c to add a new col
13690 75 6d 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 umn */.#endif.#i
136a0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
136b0 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 T_VIRTUALTABLE.
136c0 20 69 6e 74 20 6e 4d 6f 64 75 6c 65 41 72 67 3b int nModuleArg;
136d0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
136e0 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 of arguments to
136f0 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f 0a 20 20 the module */.
13700 63 68 61 72 20 2a 2a 61 7a 4d 6f 64 75 6c 65 41 char **azModuleA
13710 72 67 3b 20 20 2f 2a 20 30 3a 20 6d 6f 64 75 6c rg; /* 0: modul
13720 65 20 31 3a 20 73 63 68 65 6d 61 20 32 3a 20 76 e 1: schema 2: v
13730 74 61 62 20 6e 61 6d 65 20 33 2e 2e 2e 3a 20 61 tab name 3...: a
13740 72 67 73 20 2a 2f 0a 20 20 56 54 61 62 6c 65 20 rgs */. VTable
13750 2a 70 56 54 61 62 6c 65 3b 20 20 20 20 20 2f 2a *pVTable; /*
13760 20 4c 69 73 74 20 6f 66 20 56 54 61 62 6c 65 20 List of VTable
13770 6f 62 6a 65 63 74 73 2e 20 2a 2f 0a 23 65 6e 64 objects. */.#end
13780 69 66 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 if. Trigger *pT
13790 72 69 67 67 65 72 3b 20 20 20 2f 2a 20 4c 69 73 rigger; /* Lis
137a0 74 20 6f 66 20 74 72 69 67 67 65 72 73 20 73 74 t of triggers st
137b0 6f 72 65 64 20 69 6e 20 70 53 63 68 65 6d 61 20 ored in pSchema
137c0 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 */. Schema *pSc
137d0 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 53 63 68 hema; /* Sch
137e0 65 6d 61 20 74 68 61 74 20 63 6f 6e 74 61 69 6e ema that contain
137f0 73 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a s this table */.
13800 20 20 54 61 62 6c 65 20 2a 70 4e 65 78 74 5a 6f Table *pNextZo
13810 6d 62 69 65 3b 20 20 2f 2a 20 4e 65 78 74 20 6f mbie; /* Next o
13820 6e 20 74 68 65 20 50 61 72 73 65 2e 70 5a 6f 6d n the Parse.pZom
13830 62 69 65 54 61 62 20 6c 69 73 74 20 2a 2f 0a 7d bieTab list */.}
13840 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 ;../*.** Allowed
13850 20 76 61 6c 75 65 73 20 66 6f 72 20 54 61 62 6c values for Tabl
13860 65 2e 74 61 62 46 6c 61 67 73 2e 0a 2a 2a 0a 2a e.tabFlags..**.*
13870 2a 20 54 46 5f 4f 4f 4f 48 69 64 64 65 6e 20 61 * TF_OOOHidden a
13880 70 70 6c 69 65 73 20 74 6f 20 74 61 62 6c 65 73 pplies to tables
13890 20 6f 72 20 76 69 65 77 20 74 68 61 74 20 68 61 or view that ha
138a0 76 65 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e ve hidden column
138b0 73 20 74 68 61 74 20 61 72 65 0a 2a 2a 20 66 6f s that are.** fo
138c0 6c 6c 6f 77 65 64 20 62 79 20 6e 6f 6e 2d 68 69 llowed by non-hi
138d0 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 2e 20 20 45 dden columns. E
138e0 78 61 6d 70 6c 65 3a 20 20 22 43 52 45 41 54 45 xample: "CREATE
138f0 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 78 VIRTUAL TABLE x
13900 20 55 53 49 4e 47 0a 2a 2a 20 76 74 61 62 31 28 USING.** vtab1(
13910 61 20 48 49 44 44 45 4e 2c 20 62 29 3b 22 2e 20 a HIDDEN, b);".
13920 20 53 69 6e 63 65 20 22 62 22 20 69 73 20 61 20 Since "b" is a
13930 6e 6f 6e 2d 68 69 64 64 65 6e 20 63 6f 6c 75 6d non-hidden colum
13940 6e 20 62 75 74 20 22 61 22 20 69 73 20 68 69 64 n but "a" is hid
13950 64 65 6e 2c 0a 2a 2a 20 74 68 65 20 54 46 5f 4f den,.** the TF_O
13960 4f 4f 48 69 64 64 65 6e 20 61 74 74 72 69 62 75 OOHidden attribu
13970 74 65 20 77 6f 75 6c 64 20 61 70 70 6c 79 20 69 te would apply i
13980 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 53 75 n this case. Su
13990 63 68 20 74 61 62 6c 65 73 20 72 65 71 75 69 72 ch tables requir
139a0 65 0a 2a 2a 20 73 70 65 63 69 61 6c 20 68 61 6e e.** special han
139b0 64 6c 69 6e 67 20 64 75 72 69 6e 67 20 49 4e 53 dling during INS
139c0 45 52 54 20 70 72 6f 63 65 73 73 69 6e 67 2e 0a ERT processing..
139d0 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 52 65 */.#define TF_Re
139e0 61 64 6f 6e 6c 79 20 20 20 20 20 20 20 20 30 78 adonly 0x
139f0 30 30 30 31 20 20 20 20 2f 2a 20 52 65 61 64 2d 0001 /* Read-
13a00 6f 6e 6c 79 20 73 79 73 74 65 6d 20 74 61 62 6c only system tabl
13a10 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f e */.#define TF_
13a20 45 70 68 65 6d 65 72 61 6c 20 20 20 20 20 20 20 Ephemeral
13a30 30 78 30 30 30 32 20 20 20 20 2f 2a 20 41 6e 20 0x0002 /* An
13a40 65 70 68 65 6d 65 72 61 6c 20 74 61 62 6c 65 20 ephemeral table
13a50 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 48 61 */.#define TF_Ha
13a60 73 50 72 69 6d 61 72 79 4b 65 79 20 20 20 30 78 sPrimaryKey 0x
13a70 30 30 30 34 20 20 20 20 2f 2a 20 54 61 62 6c 65 0004 /* Table
13a80 20 68 61 73 20 61 20 70 72 69 6d 61 72 79 20 6b has a primary k
13a90 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 ey */.#define TF
13aa0 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 20 20 _Autoincrement
13ab0 20 30 78 30 30 30 38 20 20 20 20 2f 2a 20 49 6e 0x0008 /* In
13ac0 74 65 67 65 72 20 70 72 69 6d 61 72 79 20 6b 65 teger primary ke
13ad0 79 20 69 73 20 61 75 74 6f 69 6e 63 72 65 6d 65 y is autoincreme
13ae0 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 nt */.#define TF
13af0 5f 48 61 73 53 74 61 74 31 20 20 20 20 20 20 20 _HasStat1
13b00 20 30 78 30 30 31 30 20 20 20 20 2f 2a 20 6e 52 0x0010 /* nR
13b10 6f 77 4c 6f 67 45 73 74 20 73 65 74 20 66 72 6f owLogEst set fro
13b20 6d 20 73 71 6c 69 74 65 5f 73 74 61 74 31 20 2a m sqlite_stat1 *
13b30 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 57 69 74 /.#define TF_Wit
13b40 68 6f 75 74 52 6f 77 69 64 20 20 20 20 30 78 30 houtRowid 0x0
13b50 30 32 30 20 20 20 20 2f 2a 20 4e 6f 20 72 6f 77 020 /* No row
13b60 69 64 2e 20 20 50 52 49 4d 41 52 59 20 4b 45 59 id. PRIMARY KEY
13b70 20 69 73 20 74 68 65 20 6b 65 79 20 2a 2f 0a 23 is the key */.#
13b80 64 65 66 69 6e 65 20 54 46 5f 4e 6f 56 69 73 69 define TF_NoVisi
13b90 62 6c 65 52 6f 77 69 64 20 20 30 78 30 30 34 30 bleRowid 0x0040
13ba0 20 20 20 20 2f 2a 20 4e 6f 20 75 73 65 72 2d 76 /* No user-v
13bb0 69 73 69 62 6c 65 20 22 72 6f 77 69 64 22 20 63 isible "rowid" c
13bc0 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 olumn */.#define
13bd0 20 54 46 5f 4f 4f 4f 48 69 64 64 65 6e 20 20 20 TF_OOOHidden
13be0 20 20 20 20 30 78 30 30 38 30 20 20 20 20 2f 2a 0x0080 /*
13bf0 20 4f 75 74 2d 6f 66 2d 4f 72 64 65 72 20 68 69 Out-of-Order hi
13c00 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a dden columns */.
13c10 23 64 65 66 69 6e 65 20 54 46 5f 53 74 61 74 73 #define TF_Stats
13c20 55 73 65 64 20 20 20 20 20 20 20 30 78 30 31 30 Used 0x010
13c30 30 20 20 20 20 2f 2a 20 51 75 65 72 79 20 70 6c 0 /* Query pl
13c40 61 6e 6e 65 72 20 64 65 63 69 73 69 6f 6e 73 20 anner decisions
13c50 61 66 66 65 63 74 65 64 20 62 79 0a 20 20 20 20 affected by.
13c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13c70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13c80 20 2a 2a 20 49 6e 64 65 78 2e 61 69 52 6f 77 4c ** Index.aiRowL
13c90 6f 67 45 73 74 5b 5d 20 76 61 6c 75 65 73 20 2a ogEst[] values *
13ca0 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 48 61 73 /.#define TF_Has
13cb0 4e 6f 74 4e 75 6c 6c 20 20 20 20 20 20 30 78 30 NotNull 0x0
13cc0 32 30 30 20 20 20 20 2f 2a 20 43 6f 6e 74 61 69 200 /* Contai
13cd0 6e 73 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6e 73 ns NOT NULL cons
13ce0 74 72 61 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 traints */.#defi
13cf0 6e 65 20 54 46 5f 53 68 61 64 6f 77 20 20 20 20 ne TF_Shadow
13d00 20 20 20 20 20 20 30 78 30 34 30 30 20 20 20 20 0x0400
13d10 2f 2a 20 54 72 75 65 20 66 6f 72 20 61 20 73 68 /* True for a sh
13d20 61 64 6f 77 20 74 61 62 6c 65 20 2a 2f 0a 0a 2f adow table */../
13d30 2a 0a 2a 2a 20 54 65 73 74 20 74 6f 20 73 65 65 *.** Test to see
13d40 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
13d50 61 20 74 61 62 6c 65 20 69 73 20 61 20 76 69 72 a table is a vir
13d60 74 75 61 6c 20 74 61 62 6c 65 2e 20 20 54 68 69 tual table. Thi
13d70 73 20 69 73 0a 2a 2a 20 64 6f 6e 65 20 61 73 20 s is.** done as
13d80 61 20 6d 61 63 72 6f 20 73 6f 20 74 68 61 74 20 a macro so that
13d90 69 74 20 77 69 6c 6c 20 62 65 20 6f 70 74 69 6d it will be optim
13da0 69 7a 65 64 20 6f 75 74 20 77 68 65 6e 20 76 69 ized out when vi
13db0 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 20 73 rtual.** table s
13dc0 75 70 70 6f 72 74 20 69 73 20 6f 6d 69 74 74 65 upport is omitte
13dd0 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 d from the build
13de0 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
13df0 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
13e00 54 41 42 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 TABLE.# define
13e10 49 73 56 69 72 74 75 61 6c 28 58 29 20 20 20 20 IsVirtual(X)
13e20 20 20 28 28 58 29 2d 3e 6e 4d 6f 64 75 6c 65 41 ((X)->nModuleA
13e30 72 67 29 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 rg).#else.# def
13e40 69 6e 65 20 49 73 56 69 72 74 75 61 6c 28 58 29 ine IsVirtual(X)
13e50 20 20 20 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 0.#endif..
13e60 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 6f 20 /*.** Macros to
13e70 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 20 63 determine if a c
13e80 6f 6c 75 6d 6e 20 69 73 20 68 69 64 64 65 6e 2e olumn is hidden.
13e90 20 20 49 73 4f 72 64 69 6e 61 72 79 48 69 64 64 IsOrdinaryHidd
13ea0 65 6e 43 6f 6c 75 6d 6e 28 29 0a 2a 2a 20 6f 6e enColumn().** on
13eb0 6c 79 20 77 6f 72 6b 73 20 66 6f 72 20 6e 6f 6e ly works for non
13ec0 2d 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 -virtual tables
13ed0 28 6f 72 64 69 6e 61 72 79 20 74 61 62 6c 65 73 (ordinary tables
13ee0 20 61 6e 64 20 76 69 65 77 73 29 20 61 6e 64 20 and views) and
13ef0 69 73 0a 2a 2a 20 61 6c 77 61 79 73 20 66 61 6c is.** always fal
13f00 73 65 20 75 6e 6c 65 73 73 20 53 51 4c 49 54 45 se unless SQLITE
13f10 5f 45 4e 41 42 4c 45 5f 48 49 44 44 45 4e 5f 43 _ENABLE_HIDDEN_C
13f20 4f 4c 55 4d 4e 53 20 69 73 20 64 65 66 69 6e 65 OLUMNS is define
13f30 64 2e 20 20 54 68 65 0a 2a 2a 20 49 73 48 69 64 d. The.** IsHid
13f40 64 65 6e 43 6f 6c 75 6d 6e 28 29 20 6d 61 63 72 denColumn() macr
13f50 6f 20 69 73 20 67 65 6e 65 72 61 6c 20 70 75 72 o is general pur
13f60 70 6f 73 65 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 pose..*/.#if def
13f70 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
13f80 4c 45 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e LE_HIDDEN_COLUMN
13f90 53 29 0a 23 20 20 64 65 66 69 6e 65 20 49 73 48 S).# define IsH
13fa0 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 iddenColumn(X)
13fb0 20 20 20 20 20 20 20 28 28 28 58 29 2d 3e 63 6f (((X)->co
13fc0 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 lFlags & COLFLAG
13fd0 5f 48 49 44 44 45 4e 29 21 3d 30 29 0a 23 20 20 _HIDDEN)!=0).#
13fe0 64 65 66 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 define IsOrdinar
13ff0 79 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 yHiddenColumn(X)
14000 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c 61 67 73 (((X)->colFlags
14010 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 45 & COLFLAG_HIDDE
14020 4e 29 21 3d 30 29 0a 23 65 6c 69 66 20 21 64 65 N)!=0).#elif !de
14030 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 fined(SQLITE_OMI
14040 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 0a T_VIRTUALTABLE).
14050 23 20 20 64 65 66 69 6e 65 20 49 73 48 69 64 64 # define IsHidd
14060 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 20 20 20 enColumn(X)
14070 20 20 20 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c (((X)->colFl
14080 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 ags & COLFLAG_HI
14090 44 44 45 4e 29 21 3d 30 29 0a 23 20 20 64 65 66 DDEN)!=0).# def
140a0 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 48 69 ine IsOrdinaryHi
140b0 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 30 0a ddenColumn(X) 0.
140c0 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 #else.# define
140d0 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 IsHiddenColumn(X
140e0 29 20 20 20 20 20 20 20 20 20 30 0a 23 20 20 64 ) 0.# d
140f0 65 66 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 efine IsOrdinary
14100 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 HiddenColumn(X)
14110 30 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 20 44 6f 0.#endif.../* Do
14120 65 73 20 74 68 65 20 74 61 62 6c 65 20 68 61 76 es the table hav
14130 65 20 61 20 72 6f 77 69 64 20 2a 2f 0a 23 64 65 e a rowid */.#de
14140 66 69 6e 65 20 48 61 73 52 6f 77 69 64 28 58 29 fine HasRowid(X)
14150 20 20 20 20 20 28 28 28 58 29 2d 3e 74 61 62 46 (((X)->tabF
14160 6c 61 67 73 20 26 20 54 46 5f 57 69 74 68 6f 75 lags & TF_Withou
14170 74 52 6f 77 69 64 29 3d 3d 30 29 0a 23 64 65 66 tRowid)==0).#def
14180 69 6e 65 20 56 69 73 69 62 6c 65 52 6f 77 69 64 ine VisibleRowid
14190 28 58 29 20 28 28 28 58 29 2d 3e 74 61 62 46 6c (X) (((X)->tabFl
141a0 61 67 73 20 26 20 54 46 5f 4e 6f 56 69 73 69 62 ags & TF_NoVisib
141b0 6c 65 52 6f 77 69 64 29 3d 3d 30 29 0a 0a 2f 2a leRowid)==0)../*
141c0 0a 2a 2a 20 45 61 63 68 20 66 6f 72 65 69 67 6e .** Each foreign
141d0 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 key constraint
141e0 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f is an instance o
141f0 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
14200 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a structure..**.**
14210 20 41 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 69 A foreign key i
14220 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 s associated wit
14230 68 20 74 77 6f 20 74 61 62 6c 65 73 2e 20 20 54 h two tables. T
14240 68 65 20 22 66 72 6f 6d 22 20 74 61 62 6c 65 20 he "from" table
14250 69 73 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 is.** the table
14260 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
14270 65 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c 61 e REFERENCES cla
14280 75 73 65 20 74 68 61 74 20 63 72 65 61 74 65 73 use that creates
14290 20 74 68 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 the foreign.**
142a0 6b 65 79 2e 20 20 54 68 65 20 22 74 6f 22 20 74 key. The "to" t
142b0 61 62 6c 65 20 69 73 20 74 68 65 20 74 61 62 6c able is the tabl
142c0 65 20 74 68 61 74 20 69 73 20 6e 61 6d 65 64 20 e that is named
142d0 69 6e 20 74 68 65 20 52 45 46 45 52 45 4e 43 45 in the REFERENCE
142e0 53 20 63 6c 61 75 73 65 2e 0a 2a 2a 20 43 6f 6e S clause..** Con
142f0 73 69 64 65 72 20 74 68 69 73 20 65 78 61 6d 70 sider this examp
14300 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 le:.**.** CR
14310 45 41 54 45 20 54 41 42 4c 45 20 65 78 31 28 0a EATE TABLE ex1(.
14320 2a 2a 20 20 20 20 20 20 20 61 20 49 4e 54 45 47 ** a INTEG
14330 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a ER PRIMARY KEY,.
14340 2a 2a 20 20 20 20 20 20 20 62 20 49 4e 54 45 47 ** b INTEG
14350 45 52 20 43 4f 4e 53 54 52 41 49 4e 54 20 66 6b ER CONSTRAINT fk
14360 31 20 52 45 46 45 52 45 4e 43 45 53 20 65 78 32 1 REFERENCES ex2
14370 28 78 29 0a 2a 2a 20 20 20 20 20 29 3b 0a 2a 2a (x).** );.**
14380 0a 2a 2a 20 46 6f 72 20 66 6f 72 65 69 67 6e 20 .** For foreign
14390 6b 65 79 20 22 66 6b 31 22 2c 20 74 68 65 20 66 key "fk1", the f
143a0 72 6f 6d 2d 74 61 62 6c 65 20 69 73 20 22 65 78 rom-table is "ex
143b0 31 22 20 61 6e 64 20 74 68 65 20 74 6f 2d 74 61 1" and the to-ta
143c0 62 6c 65 20 69 73 20 22 65 78 32 22 2e 0a 2a 2a ble is "ex2"..**
143d0 20 45 71 75 69 76 61 6c 65 6e 74 20 6e 61 6d 65 Equivalent name
143e0 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 66 72 6f s:.**.** fro
143f0 6d 2d 74 61 62 6c 65 20 3d 3d 20 63 68 69 6c 64 m-table == child
14400 2d 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 -table.**
14410 74 6f 2d 74 61 62 6c 65 20 3d 3d 20 70 61 72 65 to-table == pare
14420 6e 74 2d 74 61 62 6c 65 0a 2a 2a 0a 2a 2a 20 45 nt-table.**.** E
14430 61 63 68 20 52 45 46 45 52 45 4e 43 45 53 20 63 ach REFERENCES c
14440 6c 61 75 73 65 20 67 65 6e 65 72 61 74 65 73 20 lause generates
14450 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
14460 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
14470 75 63 74 75 72 65 0a 2a 2a 20 77 68 69 63 68 20 ucture.** which
14480 69 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 is attached to t
14490 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 2e 20 20 he from-table.
144a0 54 68 65 20 74 6f 2d 74 61 62 6c 65 20 6e 65 65 The to-table nee
144b0 64 20 6e 6f 74 20 65 78 69 73 74 20 77 68 65 6e d not exist when
144c0 0a 2a 2a 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 .** the from-tab
144d0 6c 65 20 69 73 20 63 72 65 61 74 65 64 2e 20 20 le is created.
144e0 54 68 65 20 65 78 69 73 74 65 6e 63 65 20 6f 66 The existence of
144f0 20 74 68 65 20 74 6f 2d 74 61 62 6c 65 20 69 73 the to-table is
14500 20 6e 6f 74 20 63 68 65 63 6b 65 64 2e 0a 2a 2a not checked..**
14510 0a 2a 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 .** The list of
14520 61 6c 6c 20 70 61 72 65 6e 74 73 20 66 6f 72 20 all parents for
14530 63 68 69 6c 64 20 54 61 62 6c 65 20 58 20 69 73 child Table X is
14540 20 68 65 6c 64 20 61 74 20 58 2e 70 46 4b 65 79 held at X.pFKey
14550 2e 0a 2a 2a 0a 2a 2a 20 41 20 6c 69 73 74 20 6f ..**.** A list o
14560 66 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 66 f all children f
14570 6f 72 20 61 20 74 61 62 6c 65 20 6e 61 6d 65 64 or a table named
14580 20 5a 20 28 77 68 69 63 68 20 6d 69 67 68 74 20 Z (which might
14590 6e 6f 74 20 65 76 65 6e 20 65 78 69 73 74 29 0a not even exist).
145a0 2a 2a 20 69 73 20 68 65 6c 64 20 69 6e 20 53 63 ** is held in Sc
145b0 68 65 6d 61 2e 66 6b 65 79 48 61 73 68 20 77 69 hema.fkeyHash wi
145c0 74 68 20 61 20 68 61 73 68 20 6b 65 79 20 6f 66 th a hash key of
145d0 20 5a 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 46 4b Z..*/.struct FK
145e0 65 79 20 7b 0a 20 20 54 61 62 6c 65 20 2a 70 46 ey {. Table *pF
145f0 72 6f 6d 3b 20 20 20 20 20 2f 2a 20 54 61 62 6c rom; /* Tabl
14600 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 e containing the
14610 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 REFERENCES clau
14620 73 65 20 28 61 6b 61 3a 20 43 68 69 6c 64 29 20 se (aka: Child)
14630 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 */. FKey *pNext
14640 46 72 6f 6d 3b 20 20 2f 2a 20 4e 65 78 74 20 46 From; /* Next F
14650 4b 65 79 20 77 69 74 68 20 74 68 65 20 73 61 6d Key with the sam
14660 65 20 69 6e 20 70 46 72 6f 6d 2e 20 4e 65 78 74 e in pFrom. Next
14670 20 70 61 72 65 6e 74 20 6f 66 20 70 46 72 6f 6d parent of pFrom
14680 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 6f 3b */. char *zTo;
14690 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
146a0 6f 66 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 of table that th
146b0 65 20 6b 65 79 20 70 6f 69 6e 74 73 20 74 6f 20 e key points to
146c0 28 61 6b 61 3a 20 50 61 72 65 6e 74 29 20 2a 2f (aka: Parent) */
146d0 0a 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 54 6f . FKey *pNextTo
146e0 3b 20 20 20 20 2f 2a 20 4e 65 78 74 20 77 69 74 ; /* Next wit
146f0 68 20 74 68 65 20 73 61 6d 65 20 7a 54 6f 2e 20 h the same zTo.
14700 4e 65 78 74 20 63 68 69 6c 64 20 6f 66 20 7a 54 Next child of zT
14710 6f 2e 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 50 o. */. FKey *pP
14720 72 65 76 54 6f 3b 20 20 20 20 2f 2a 20 50 72 65 revTo; /* Pre
14730 76 69 6f 75 73 20 77 69 74 68 20 74 68 65 20 73 vious with the s
14740 61 6d 65 20 7a 54 6f 20 2a 2f 0a 20 20 69 6e 74 ame zTo */. int
14750 20 6e 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 2f nCol; /
14760 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 * Number of colu
14770 6d 6e 73 20 69 6e 20 74 68 69 73 20 6b 65 79 20 mns in this key
14780 2a 2f 0a 20 20 2f 2a 20 45 56 3a 20 52 2d 33 30 */. /* EV: R-30
14790 33 32 33 2d 32 31 39 31 37 20 2a 2f 0a 20 20 75 323-21917 */. u
147a0 38 20 69 73 44 65 66 65 72 72 65 64 3b 20 20 20 8 isDeferred;
147b0 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 /* True if c
147c0 6f 6e 73 74 72 61 69 6e 74 20 63 68 65 63 6b 69 onstraint checki
147d0 6e 67 20 69 73 20 64 65 66 65 72 72 65 64 20 74 ng is deferred t
147e0 69 6c 6c 20 43 4f 4d 4d 49 54 20 2a 2f 0a 20 20 ill COMMIT */.
147f0 75 38 20 61 41 63 74 69 6f 6e 5b 32 5d 3b 20 20 u8 aAction[2];
14800 20 20 20 20 20 20 2f 2a 20 4f 4e 20 44 45 4c 45 /* ON DELE
14810 54 45 20 61 6e 64 20 4f 4e 20 55 50 44 41 54 45 TE and ON UPDATE
14820 20 61 63 74 69 6f 6e 73 2c 20 72 65 73 70 65 63 actions, respec
14830 74 69 76 65 6c 79 20 2a 2f 0a 20 20 54 72 69 67 tively */. Trig
14840 67 65 72 20 2a 61 70 54 72 69 67 67 65 72 5b 32 ger *apTrigger[2
14850 5d 3b 2f 2a 20 54 72 69 67 67 65 72 73 20 66 6f ];/* Triggers fo
14860 72 20 61 41 63 74 69 6f 6e 5b 5d 20 61 63 74 69 r aAction[] acti
14870 6f 6e 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 ons */. struct
14880 73 43 6f 6c 4d 61 70 20 7b 20 20 20 20 20 20 2f sColMap { /
14890 2a 20 4d 61 70 70 69 6e 67 20 6f 66 20 63 6f 6c * Mapping of col
148a0 75 6d 6e 73 20 69 6e 20 70 46 72 6f 6d 20 74 6f umns in pFrom to
148b0 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 7a 54 6f 20 columns in zTo
148c0 2a 2f 0a 20 20 20 20 69 6e 74 20 69 46 72 6f 6d */. int iFrom
148d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
148e0 49 6e 64 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 Index of column
148f0 69 6e 20 70 46 72 6f 6d 20 2a 2f 0a 20 20 20 20 in pFrom */.
14900 63 68 61 72 20 2a 7a 43 6f 6c 3b 20 20 20 20 20 char *zCol;
14910 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
14920 20 63 6f 6c 75 6d 6e 20 69 6e 20 7a 54 6f 2e 20 column in zTo.
14930 20 49 66 20 4e 55 4c 4c 20 75 73 65 20 50 52 49 If NULL use PRI
14940 4d 41 52 59 20 4b 45 59 20 2a 2f 0a 20 20 7d 20 MARY KEY */. }
14950 61 43 6f 6c 5b 31 5d 3b 20 20 20 20 20 20 20 20 aCol[1];
14960 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 /* One entry
14970 20 66 6f 72 20 65 61 63 68 20 6f 66 20 6e 43 6f for each of nCo
14980 6c 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 7d 3b 0a l columns */.};.
14990 0a 2f 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 73 75 ./*.** SQLite su
149a0 70 70 6f 72 74 73 20 6d 61 6e 79 20 64 69 66 66 pports many diff
149b0 65 72 65 6e 74 20 77 61 79 73 20 74 6f 20 72 65 erent ways to re
149c0 73 6f 6c 76 65 20 61 20 63 6f 6e 73 74 72 61 69 solve a constrai
149d0 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 20 20 52 4f nt.** error. RO
149e0 4c 4c 42 41 43 4b 20 70 72 6f 63 65 73 73 69 6e LLBACK processin
149f0 67 20 6d 65 61 6e 73 20 74 68 61 74 20 61 20 63 g means that a c
14a00 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 onstraint violat
14a10 69 6f 6e 0a 2a 2a 20 63 61 75 73 65 73 20 74 68 ion.** causes th
14a20 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 e operation in p
14a30 72 6f 63 65 73 73 20 74 6f 20 66 61 69 6c 20 61 rocess to fail a
14a40 6e 64 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 nd for the curre
14a50 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a nt transaction.*
14a60 2a 20 74 6f 20 62 65 20 72 6f 6c 6c 65 64 20 62 * to be rolled b
14a70 61 63 6b 2e 20 20 41 42 4f 52 54 20 70 72 6f 63 ack. ABORT proc
14a80 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 68 65 essing means the
14a90 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 operation in pr
14aa0 6f 63 65 73 73 0a 2a 2a 20 66 61 69 6c 73 20 61 ocess.** fails a
14ab0 6e 64 20 61 6e 79 20 70 72 69 6f 72 20 63 68 61 nd any prior cha
14ac0 6e 67 65 73 20 66 72 6f 6d 20 74 68 61 74 20 6f nges from that o
14ad0 6e 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 72 65 ne operation are
14ae0 20 62 61 63 6b 65 64 20 6f 75 74 2c 0a 2a 2a 20 backed out,.**
14af0 62 75 74 20 74 68 65 20 74 72 61 6e 73 61 63 74 but the transact
14b00 69 6f 6e 20 69 73 20 6e 6f 74 20 72 6f 6c 6c 65 ion is not rolle
14b10 64 20 62 61 63 6b 2e 20 20 46 41 49 4c 20 70 72 d back. FAIL pr
14b20 6f 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 ocessing means t
14b30 68 61 74 0a 2a 2a 20 74 68 65 20 6f 70 65 72 61 hat.** the opera
14b40 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 tion in progress
14b50 20 73 74 6f 70 73 20 61 6e 64 20 72 65 74 75 72 stops and retur
14b60 6e 73 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 ns an error code
14b70 2e 20 20 42 75 74 20 70 72 69 6f 72 0a 2a 2a 20 . But prior.**
14b80 63 68 61 6e 67 65 73 20 64 75 65 20 74 6f 20 74 changes due to t
14b90 68 65 20 73 61 6d 65 20 6f 70 65 72 61 74 69 6f he same operatio
14ba0 6e 20 61 72 65 20 6e 6f 74 20 62 61 63 6b 65 64 n are not backed
14bb0 20 6f 75 74 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c out and no roll
14bc0 62 61 63 6b 0a 2a 2a 20 6f 63 63 75 72 73 2e 20 back.** occurs.
14bd0 20 49 47 4e 4f 52 45 20 6d 65 61 6e 73 20 74 68 IGNORE means th
14be0 61 74 20 74 68 65 20 70 61 72 74 69 63 75 6c 61 at the particula
14bf0 72 20 72 6f 77 20 74 68 61 74 20 63 61 75 73 65 r row that cause
14c00 64 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 d the constraint
14c10 0a 2a 2a 20 65 72 72 6f 72 20 69 73 20 6e 6f 74 .** error is not
14c20 20 69 6e 73 65 72 74 65 64 20 6f 72 20 75 70 64 inserted or upd
14c30 61 74 65 64 2e 20 20 50 72 6f 63 65 73 73 69 6e ated. Processin
14c40 67 20 63 6f 6e 74 69 6e 75 65 73 20 61 6e 64 20 g continues and
14c50 6e 6f 20 65 72 72 6f 72 0a 2a 2a 20 69 73 20 72 no error.** is r
14c60 65 74 75 72 6e 65 64 2e 20 20 52 45 50 4c 41 43 eturned. REPLAC
14c70 45 20 6d 65 61 6e 73 20 74 68 61 74 20 70 72 65 E means that pre
14c80 65 78 69 73 74 69 6e 67 20 64 61 74 61 62 61 73 existing databas
14c90 65 20 72 6f 77 73 20 74 68 61 74 20 63 61 75 73 e rows that caus
14ca0 65 64 0a 2a 2a 20 61 20 55 4e 49 51 55 45 20 63 ed.** a UNIQUE c
14cb0 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 onstraint violat
14cc0 69 6f 6e 20 61 72 65 20 72 65 6d 6f 76 65 64 20 ion are removed
14cd0 73 6f 20 74 68 61 74 20 74 68 65 20 6e 65 77 20 so that the new
14ce0 69 6e 73 65 72 74 20 6f 72 0a 2a 2a 20 75 70 64 insert or.** upd
14cf0 61 74 65 20 63 61 6e 20 70 72 6f 63 65 65 64 2e ate can proceed.
14d00 20 20 50 72 6f 63 65 73 73 69 6e 67 20 63 6f 6e Processing con
14d10 74 69 6e 75 65 73 20 61 6e 64 20 6e 6f 20 65 72 tinues and no er
14d20 72 6f 72 20 69 73 20 72 65 70 6f 72 74 65 64 2e ror is reported.
14d30 0a 2a 2a 0a 2a 2a 20 52 45 53 54 52 49 43 54 2c .**.** RESTRICT,
14d40 20 53 45 54 4e 55 4c 4c 2c 20 61 6e 64 20 43 41 SETNULL, and CA
14d50 53 43 41 44 45 20 61 63 74 69 6f 6e 73 20 61 70 SCADE actions ap
14d60 70 6c 79 20 6f 6e 6c 79 20 74 6f 20 66 6f 72 65 ply only to fore
14d70 69 67 6e 20 6b 65 79 73 2e 0a 2a 2a 20 52 45 53 ign keys..** RES
14d80 54 52 49 43 54 20 69 73 20 74 68 65 20 73 61 6d TRICT is the sam
14d90 65 20 61 73 20 41 42 4f 52 54 20 66 6f 72 20 49 e as ABORT for I
14da0 4d 4d 45 44 49 41 54 45 20 66 6f 72 65 69 67 6e MMEDIATE foreign
14db0 20 6b 65 79 73 20 61 6e 64 20 74 68 65 0a 2a 2a keys and the.**
14dc0 20 73 61 6d 65 20 61 73 20 52 4f 4c 4c 42 41 43 same as ROLLBAC
14dd0 4b 20 66 6f 72 20 44 45 46 45 52 52 45 44 20 6b K for DEFERRED k
14de0 65 79 73 2e 20 20 53 45 54 4e 55 4c 4c 20 6d 65 eys. SETNULL me
14df0 61 6e 73 20 74 68 61 74 20 74 68 65 20 66 6f 72 ans that the for
14e00 65 69 67 6e 0a 2a 2a 20 6b 65 79 20 69 73 20 73 eign.** key is s
14e10 65 74 20 74 6f 20 4e 55 4c 4c 2e 20 20 43 41 53 et to NULL. CAS
14e20 43 41 44 45 20 6d 65 61 6e 73 20 74 68 61 74 20 CADE means that
14e30 61 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 a DELETE or UPDA
14e40 54 45 20 6f 66 20 74 68 65 0a 2a 2a 20 72 65 66 TE of the.** ref
14e50 65 72 65 6e 63 65 64 20 74 61 62 6c 65 20 72 6f erenced table ro
14e60 77 20 69 73 20 70 72 6f 70 61 67 61 74 65 64 20 w is propagated
14e70 69 6e 74 6f 20 74 68 65 20 72 6f 77 20 74 68 61 into the row tha
14e80 74 20 68 6f 6c 64 73 20 74 68 65 0a 2a 2a 20 66 t holds the.** f
14e90 6f 72 65 69 67 6e 20 6b 65 79 2e 0a 2a 2a 0a 2a oreign key..**.*
14ea0 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
14eb0 73 79 6d 62 6f 6c 69 63 20 76 61 6c 75 65 73 20 symbolic values
14ec0 61 72 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f are used to reco
14ed0 72 64 20 77 68 69 63 68 20 74 79 70 65 0a 2a 2a rd which type.**
14ee0 20 6f 66 20 61 63 74 69 6f 6e 20 74 6f 20 74 61 of action to ta
14ef0 6b 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ke..*/.#define O
14f00 45 5f 4e 6f 6e 65 20 20 20 20 20 30 20 20 20 2f E_None 0 /
14f10 2a 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f * There is no co
14f20 6e 73 74 72 61 69 6e 74 20 74 6f 20 63 68 65 63 nstraint to chec
14f30 6b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f k */.#define OE_
14f40 52 6f 6c 6c 62 61 63 6b 20 31 20 20 20 2f 2a 20 Rollback 1 /*
14f50 46 61 69 6c 20 74 68 65 20 6f 70 65 72 61 74 69 Fail the operati
14f60 6f 6e 20 61 6e 64 20 72 6f 6c 6c 62 61 63 6b 20 on and rollback
14f70 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 the transaction
14f80 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 41 62 */.#define OE_Ab
14f90 6f 72 74 20 20 20 20 32 20 20 20 2f 2a 20 42 61 ort 2 /* Ba
14fa0 63 6b 20 6f 75 74 20 63 68 61 6e 67 65 73 20 62 ck out changes b
14fb0 75 74 20 64 6f 20 6e 6f 20 72 6f 6c 6c 62 61 63 ut do no rollbac
14fc0 6b 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f k transaction */
14fd0 0a 23 64 65 66 69 6e 65 20 4f 45 5f 46 61 69 6c .#define OE_Fail
14fe0 20 20 20 20 20 33 20 20 20 2f 2a 20 53 74 6f 70 3 /* Stop
14ff0 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 62 the operation b
15000 75 74 20 6c 65 61 76 65 20 61 6c 6c 20 70 72 69 ut leave all pri
15010 6f 72 20 63 68 61 6e 67 65 73 20 2a 2f 0a 23 64 or changes */.#d
15020 65 66 69 6e 65 20 4f 45 5f 49 67 6e 6f 72 65 20 efine OE_Ignore
15030 20 20 34 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 4 /* Ignore
15040 74 68 65 20 65 72 72 6f 72 2e 20 44 6f 20 6e 6f the error. Do no
15050 74 20 64 6f 20 74 68 65 20 49 4e 53 45 52 54 20 t do the INSERT
15060 6f 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 65 or UPDATE */.#de
15070 66 69 6e 65 20 4f 45 5f 52 65 70 6c 61 63 65 20 fine OE_Replace
15080 20 35 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 65 5 /* Delete e
15090 78 69 73 74 69 6e 67 20 72 65 63 6f 72 64 2c 20 xisting record,
150a0 74 68 65 6e 20 64 6f 20 49 4e 53 45 52 54 20 6f then do INSERT o
150b0 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 65 66 r UPDATE */.#def
150c0 69 6e 65 20 4f 45 5f 55 70 64 61 74 65 20 20 20 ine OE_Update
150d0 36 20 20 20 2f 2a 20 50 72 6f 63 65 73 73 20 61 6 /* Process a
150e0 73 20 61 20 44 4f 20 55 50 44 41 54 45 20 69 6e s a DO UPDATE in
150f0 20 61 6e 20 75 70 73 65 72 74 20 2a 2f 0a 23 64 an upsert */.#d
15100 65 66 69 6e 65 20 4f 45 5f 52 65 73 74 72 69 63 efine OE_Restric
15110 74 20 37 20 20 20 2f 2a 20 4f 45 5f 41 62 6f 72 t 7 /* OE_Abor
15120 74 20 66 6f 72 20 49 4d 4d 45 44 49 41 54 45 2c t for IMMEDIATE,
15130 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b 20 66 6f 72 OE_Rollback for
15140 20 44 45 46 45 52 52 45 44 20 2a 2f 0a 23 64 65 DEFERRED */.#de
15150 66 69 6e 65 20 4f 45 5f 53 65 74 4e 75 6c 6c 20 fine OE_SetNull
15160 20 38 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 8 /* Set the
15170 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 61 6c 75 foreign key valu
15180 65 20 74 6f 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 e to NULL */.#de
15190 66 69 6e 65 20 4f 45 5f 53 65 74 44 66 6c 74 20 fine OE_SetDflt
151a0 20 39 20 20 20 2f 2a 20 53 65 74 20 74 68 65 20 9 /* Set the
151b0 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 61 6c 75 foreign key valu
151c0 65 20 74 6f 20 69 74 73 20 64 65 66 61 75 6c 74 e to its default
151d0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 43 */.#define OE_C
151e0 61 73 63 61 64 65 20 20 31 30 20 20 2f 2a 20 43 ascade 10 /* C
151f0 61 73 63 61 64 65 20 74 68 65 20 63 68 61 6e 67 ascade the chang
15200 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 es */.#define OE
15210 5f 44 65 66 61 75 6c 74 20 20 31 31 20 20 2f 2a _Default 11 /*
15220 20 44 6f 20 77 68 61 74 65 76 65 72 20 74 68 65 Do whatever the
15230 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 default action
15240 69 73 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6e is */.../*.** An
15250 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
15260 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
15270 74 75 72 65 20 69 73 20 70 61 73 73 65 64 20 61 ture is passed a
15280 73 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 s the first.** a
15290 72 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74 rgument to sqlit
152a0 65 33 56 64 62 65 4b 65 79 43 6f 6d 70 61 72 65 e3VdbeKeyCompare
152b0 20 61 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 and is used to
152c0 63 6f 6e 74 72 6f 6c 20 74 68 65 0a 2a 2a 20 63 control the.** c
152d0 6f 6d 70 61 72 69 73 6f 6e 20 6f 66 20 74 68 65 omparison of the
152e0 20 74 77 6f 20 69 6e 64 65 78 20 6b 65 79 73 2e two index keys.
152f0 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 .**.** Note that
15300 20 61 53 6f 72 74 4f 72 64 65 72 5b 5d 20 61 6e aSortOrder[] an
15310 64 20 61 43 6f 6c 6c 5b 5d 20 68 61 76 65 20 6e d aColl[] have n
15320 46 69 65 6c 64 2b 31 20 73 6c 6f 74 73 2e 20 20 Field+1 slots.
15330 54 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 46 69 There.** are nFi
15340 65 6c 64 20 73 6c 6f 74 73 20 66 6f 72 20 74 68 eld slots for th
15350 65 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6e 20 e columns of an
15360 69 6e 64 65 78 20 74 68 65 6e 20 6f 6e 65 20 65 index then one e
15370 78 74 72 61 20 73 6c 6f 74 0a 2a 2a 20 66 6f 72 xtra slot.** for
15380 20 74 68 65 20 72 6f 77 69 64 20 61 74 20 74 68 the rowid at th
15390 65 20 65 6e 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 e end..*/.struct
153a0 20 4b 65 79 49 6e 66 6f 20 7b 0a 20 20 75 33 32 KeyInfo {. u32
153b0 20 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 nRef;
153c0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 /* Number of re
153d0 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 69 73 ferences to this
153e0 20 4b 65 79 49 6e 66 6f 20 6f 62 6a 65 63 74 20 KeyInfo object
153f0 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 20 */. u8 enc;
15400 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 /* Text
15410 20 65 6e 63 6f 64 69 6e 67 20 2d 20 6f 6e 65 20 encoding - one
15420 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f 55 54 of the SQLITE_UT
15430 46 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 F* values */. u
15440 31 36 20 6e 4b 65 79 46 69 65 6c 64 3b 20 20 20 16 nKeyField;
15450 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
15460 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 key columns in t
15470 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 31 he index */. u1
15480 36 20 6e 41 6c 6c 46 69 65 6c 64 3b 20 20 20 20 6 nAllField;
15490 20 20 2f 2a 20 54 6f 74 61 6c 20 63 6f 6c 75 6d /* Total colum
154a0 6e 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 6b 65 ns, including ke
154b0 79 20 70 6c 75 73 20 6f 74 68 65 72 73 20 2a 2f y plus others */
154c0 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 . sqlite3 *db;
154d0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 /* The da
154e0 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
154f0 6e 20 2a 2f 0a 20 20 75 38 20 2a 61 53 6f 72 74 n */. u8 *aSort
15500 4f 72 64 65 72 3b 20 20 20 20 20 2f 2a 20 53 6f Order; /* So
15510 72 74 20 6f 72 64 65 72 20 66 6f 72 20 65 61 63 rt order for eac
15520 68 20 63 6f 6c 75 6d 6e 2e 20 2a 2f 0a 20 20 43 h column. */. C
15530 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 5b 31 5d ollSeq *aColl[1]
15540 3b 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 ; /* Collating
15550 73 65 71 75 65 6e 63 65 20 66 6f 72 20 65 61 63 sequence for eac
15560 68 20 74 65 72 6d 20 6f 66 20 74 68 65 20 6b 65 h term of the ke
15570 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 y */.};../*.** T
15580 68 69 73 20 6f 62 6a 65 63 74 20 68 6f 6c 64 73 his object holds
15590 20 61 20 72 65 63 6f 72 64 20 77 68 69 63 68 20 a record which
155a0 68 61 73 20 62 65 65 6e 20 70 61 72 73 65 64 20 has been parsed
155b0 6f 75 74 20 69 6e 74 6f 20 69 6e 64 69 76 69 64 out into individ
155c0 75 61 6c 0a 2a 2a 20 66 69 65 6c 64 73 2c 20 66 ual.** fields, f
155d0 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 73 20 or the purposes
155e0 6f 66 20 64 6f 69 6e 67 20 61 20 63 6f 6d 70 61 of doing a compa
155f0 72 69 73 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 rison..**.** A r
15600 65 63 6f 72 64 20 69 73 20 61 6e 20 6f 62 6a 65 ecord is an obje
15610 63 74 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 ct that contains
15620 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 66 69 65 one or more fie
15630 6c 64 73 20 6f 66 20 64 61 74 61 2e 0a 2a 2a 20 lds of data..**
15640 52 65 63 6f 72 64 73 20 61 72 65 20 75 73 65 64 Records are used
15650 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 63 6f to store the co
15660 6e 74 65 6e 74 20 6f 66 20 61 20 74 61 62 6c 65 ntent of a table
15670 20 72 6f 77 20 61 6e 64 20 74 6f 20 73 74 6f 72 row and to stor
15680 65 0a 2a 2a 20 74 68 65 20 6b 65 79 20 6f 66 20 e.** the key of
15690 61 6e 20 69 6e 64 65 78 2e 20 20 41 20 62 6c 6f an index. A blo
156a0 62 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 61 20 b encoding of a
156b0 72 65 63 6f 72 64 20 69 73 20 63 72 65 61 74 65 record is create
156c0 64 20 62 79 0a 2a 2a 20 74 68 65 20 4f 50 5f 4d d by.** the OP_M
156d0 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 akeRecord opcode
156e0 20 6f 66 20 74 68 65 20 56 44 42 45 20 61 6e 64 of the VDBE and
156f0 20 69 73 20 64 69 73 61 73 73 65 6d 62 6c 65 64 is disassembled
15700 20 62 79 20 74 68 65 0a 2a 2a 20 4f 50 5f 43 6f by the.** OP_Co
15710 6c 75 6d 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 0a lumn opcode..**.
15720 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f ** An instance o
15730 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 73 65 f this object se
15740 72 76 65 73 20 61 73 20 61 20 22 6b 65 79 22 20 rves as a "key"
15750 66 6f 72 20 64 6f 69 6e 67 20 61 20 73 65 61 72 for doing a sear
15760 63 68 20 6f 6e 0a 2a 2a 20 61 6e 20 69 6e 64 65 ch on.** an inde
15770 78 20 62 2b 74 72 65 65 2e 20 54 68 65 20 67 6f x b+tree. The go
15780 61 6c 20 6f 66 20 74 68 65 20 73 65 61 72 63 68 al of the search
15790 20 69 73 20 74 6f 20 66 69 6e 64 20 74 68 65 20 is to find the
157a0 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 69 73 entry that.** is
157b0 20 63 6c 6f 73 65 64 20 74 6f 20 74 68 65 20 6b closed to the k
157c0 65 79 20 64 65 73 63 72 69 62 65 64 20 62 79 20 ey described by
157d0 74 68 69 73 20 6f 62 6a 65 63 74 2e 20 20 54 68 this object. Th
157e0 69 73 20 6f 62 6a 65 63 74 20 6d 69 67 68 74 20 is object might
157f0 68 6f 6c 64 0a 2a 2a 20 6a 75 73 74 20 61 20 70 hold.** just a p
15800 72 65 66 69 78 20 6f 66 20 74 68 65 20 6b 65 79 refix of the key
15810 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 . The number of
15820 20 66 69 65 6c 64 73 20 69 73 20 67 69 76 65 6e fields is given
15830 20 62 79 0a 2a 2a 20 70 4b 65 79 49 6e 66 6f 2d by.** pKeyInfo-
15840 3e 6e 46 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 >nField..**.** T
15850 68 65 20 72 31 20 61 6e 64 20 72 32 20 66 69 65 he r1 and r2 fie
15860 6c 64 73 20 61 72 65 20 74 68 65 20 76 61 6c 75 lds are the valu
15870 65 73 20 74 6f 20 72 65 74 75 72 6e 20 69 66 20 es to return if
15880 74 68 69 73 20 6b 65 79 20 69 73 20 6c 65 73 73 this key is less
15890 20 74 68 61 6e 0a 2a 2a 20 6f 72 20 67 72 65 61 than.** or grea
158a0 74 65 72 20 74 68 61 6e 20 61 20 6b 65 79 20 69 ter than a key i
158b0 6e 20 74 68 65 20 62 74 72 65 65 2c 20 72 65 73 n the btree, res
158c0 70 65 63 74 69 76 65 6c 79 2e 20 20 54 68 65 73 pectively. Thes
158d0 65 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 0a 2a e are normally.*
158e0 2a 20 2d 31 20 61 6e 64 20 2b 31 20 72 65 73 70 * -1 and +1 resp
158f0 65 63 74 69 76 65 6c 79 2c 20 62 75 74 20 6d 69 ectively, but mi
15900 67 68 74 20 62 65 20 69 6e 76 65 72 74 65 64 20 ght be inverted
15910 74 6f 20 2b 31 20 61 6e 64 20 2d 31 20 69 66 20 to +1 and -1 if
15920 74 68 65 20 62 2d 74 72 65 65 0a 2a 2a 20 69 73 the b-tree.** is
15930 20 69 6e 20 44 45 53 43 20 6f 72 64 65 72 2e 0a in DESC order..
15940 2a 2a 0a 2a 2a 20 54 68 65 20 6b 65 79 20 63 6f **.** The key co
15950 6d 70 61 72 69 73 6f 6e 20 66 75 6e 63 74 69 6f mparison functio
15960 6e 73 20 61 63 74 75 61 6c 6c 79 20 72 65 74 75 ns actually retu
15970 72 6e 20 64 65 66 61 75 6c 74 5f 72 63 20 77 68 rn default_rc wh
15980 65 6e 20 74 68 65 79 20 66 69 6e 64 0a 2a 2a 20 en they find.**
15990 61 6e 20 65 71 75 61 6c 73 20 63 6f 6d 70 61 72 an equals compar
159a0 69 73 6f 6e 2e 20 20 64 65 66 61 75 6c 74 5f 72 ison. default_r
159b0 63 20 63 61 6e 20 62 65 20 2d 31 2c 20 30 2c 20 c can be -1, 0,
159c0 6f 72 20 2b 31 2e 20 20 49 66 20 74 68 65 72 65 or +1. If there
159d0 20 61 72 65 0a 2a 2a 20 6d 75 6c 74 69 70 6c 65 are.** multiple
159e0 20 65 6e 74 72 69 65 73 20 69 6e 20 74 68 65 20 entries in the
159f0 62 2d 74 72 65 65 20 77 69 74 68 20 74 68 65 20 b-tree with the
15a00 73 61 6d 65 20 6b 65 79 20 28 77 68 65 6e 20 6f same key (when o
15a10 6e 6c 79 20 6c 6f 6f 6b 69 6e 67 0a 2a 2a 20 61 nly looking.** a
15a20 74 20 74 68 65 20 66 69 72 73 74 20 70 4b 65 79 t the first pKey
15a30 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 73 2c 29 20 Info->nFields,)
15a40 74 68 65 6e 20 64 65 66 61 75 6c 74 5f 72 63 20 then default_rc
15a50 63 61 6e 20 62 65 20 73 65 74 20 74 6f 20 2d 31 can be set to -1
15a60 20 74 6f 0a 2a 2a 20 63 61 75 73 65 20 74 68 65 to.** cause the
15a70 20 73 65 61 72 63 68 20 74 6f 20 66 69 6e 64 20 search to find
15a80 74 68 65 20 6c 61 73 74 20 6d 61 74 63 68 2c 20 the last match,
15a90 6f 72 20 2b 31 20 74 6f 20 63 61 75 73 65 20 74 or +1 to cause t
15aa0 68 65 20 73 65 61 72 63 68 20 74 6f 0a 2a 2a 20 he search to.**
15ab0 66 69 6e 64 20 74 68 65 20 66 69 72 73 74 20 6d find the first m
15ac0 61 74 63 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 atch..**.** The
15ad0 6b 65 79 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 key comparison f
15ae0 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 73 65 unctions will se
15af0 74 20 65 71 53 65 65 6e 20 74 6f 20 74 72 75 65 t eqSeen to true
15b00 20 69 66 20 74 68 65 79 20 65 76 65 72 0a 2a 2a if they ever.**
15b10 20 67 65 74 20 61 6e 64 20 65 71 75 61 6c 20 72 get and equal r
15b20 65 73 75 6c 74 73 20 77 68 65 6e 20 63 6f 6d 70 esults when comp
15b30 61 72 69 6e 67 20 74 68 69 73 20 73 74 72 75 63 aring this struc
15b40 74 75 72 65 20 74 6f 20 61 20 62 2d 74 72 65 65 ture to a b-tree
15b50 20 72 65 63 6f 72 64 2e 0a 2a 2a 20 57 68 65 6e record..** When
15b60 20 64 65 66 61 75 6c 74 5f 72 63 21 3d 30 2c 20 default_rc!=0,
15b70 74 68 65 20 73 65 61 72 63 68 20 6d 69 67 68 74 the search might
15b80 20 65 6e 64 20 75 70 20 6f 6e 20 74 68 65 20 72 end up on the r
15b90 65 63 6f 72 64 20 69 6d 6d 65 64 69 61 74 65 6c ecord immediatel
15ba0 79 0a 2a 2a 20 62 65 66 6f 72 65 20 74 68 65 20 y.** before the
15bb0 66 69 72 73 74 20 6d 61 74 63 68 20 6f 72 20 69 first match or i
15bc0 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 mmediately after
15bd0 20 74 68 65 20 6c 61 73 74 20 6d 61 74 63 68 2e the last match.
15be0 20 20 54 68 65 0a 2a 2a 20 65 71 53 65 65 6e 20 The.** eqSeen
15bf0 66 69 65 6c 64 20 77 69 6c 6c 20 69 6e 64 69 63 field will indic
15c00 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e ate whether or n
15c10 6f 74 20 61 6e 20 65 78 61 63 74 20 6d 61 74 63 ot an exact matc
15c20 68 20 65 78 69 73 74 73 20 69 6e 20 74 68 65 0a h exists in the.
15c30 2a 2a 20 62 2d 74 72 65 65 2e 0a 2a 2f 0a 73 74 ** b-tree..*/.st
15c40 72 75 63 74 20 55 6e 70 61 63 6b 65 64 52 65 63 ruct UnpackedRec
15c50 6f 72 64 20 7b 0a 20 20 4b 65 79 49 6e 66 6f 20 ord {. KeyInfo
15c60 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 2f 2a 20 43 *pKeyInfo; /* C
15c70 6f 6c 6c 61 74 69 6f 6e 20 61 6e 64 20 73 6f 72 ollation and sor
15c80 74 2d 6f 72 64 65 72 20 69 6e 66 6f 72 6d 61 74 t-order informat
15c90 69 6f 6e 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d ion */. Mem *aM
15ca0 65 6d 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 em; /*
15cb0 56 61 6c 75 65 73 20 2a 2f 0a 20 20 75 31 36 20 Values */. u16
15cc0 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 20 20 nField;
15cd0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 /* Number of ent
15ce0 72 69 65 73 20 69 6e 20 61 70 4d 65 6d 5b 5d 20 ries in apMem[]
15cf0 2a 2f 0a 20 20 69 38 20 64 65 66 61 75 6c 74 5f */. i8 default_
15d00 72 63 3b 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 rc; /* Comp
15d10 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20 69 66 arison result if
15d20 20 6b 65 79 73 20 61 72 65 20 65 71 75 61 6c 20 keys are equal
15d30 2a 2f 0a 20 20 75 38 20 65 72 72 43 6f 64 65 3b */. u8 errCode;
15d40 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f /* Erro
15d50 72 20 64 65 74 65 63 74 65 64 20 62 79 20 78 52 r detected by xR
15d60 65 63 6f 72 64 43 6f 6d 70 61 72 65 20 28 43 4f ecordCompare (CO
15d70 52 52 55 50 54 20 6f 72 20 4e 4f 4d 45 4d 29 20 RRUPT or NOMEM)
15d80 2a 2f 0a 20 20 69 38 20 72 31 3b 20 20 20 20 20 */. i8 r1;
15d90 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 /* Valu
15da0 65 20 74 6f 20 72 65 74 75 72 6e 20 69 66 20 28 e to return if (
15db0 6c 68 73 20 3c 20 72 68 73 29 20 2a 2f 0a 20 20 lhs < rhs) */.
15dc0 69 38 20 72 32 3b 20 20 20 20 20 20 20 20 20 20 i8 r2;
15dd0 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 /* Value to
15de0 72 65 74 75 72 6e 20 69 66 20 28 6c 68 73 20 3e return if (lhs >
15df0 20 72 68 73 29 20 2a 2f 0a 20 20 75 38 20 65 71 rhs) */. u8 eq
15e00 53 65 65 6e 3b 20 20 20 20 20 20 20 20 20 20 2f Seen; /
15e10 2a 20 54 72 75 65 20 69 66 20 61 6e 20 65 71 75 * True if an equ
15e20 61 6c 69 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e ality comparison
15e30 20 68 61 73 20 62 65 65 6e 20 73 65 65 6e 20 2a has been seen *
15e40 2f 0a 7d 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 /.};.../*.** Eac
15e50 68 20 53 51 4c 20 69 6e 64 65 78 20 69 73 20 72 h SQL index is r
15e60 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 epresented in me
15e70 6d 6f 72 79 20 62 79 20 61 6e 0a 2a 2a 20 69 6e mory by an.** in
15e80 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
15e90 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
15ea0 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6c e..**.** The col
15eb0 75 6d 6e 73 20 6f 66 20 74 68 65 20 74 61 62 6c umns of the tabl
15ec0 65 20 74 68 61 74 20 61 72 65 20 74 6f 20 62 65 e that are to be
15ed0 20 69 6e 64 65 78 65 64 20 61 72 65 20 64 65 73 indexed are des
15ee0 63 72 69 62 65 64 0a 2a 2a 20 62 79 20 74 68 65 cribed.** by the
15ef0 20 61 69 43 6f 6c 75 6d 6e 5b 5d 20 66 69 65 6c aiColumn[] fiel
15f00 64 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 d of this struct
15f10 75 72 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c ure. For exampl
15f20 65 2c 20 73 75 70 70 6f 73 65 0a 2a 2a 20 77 65 e, suppose.** we
15f30 20 68 61 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77 have the follow
15f40 69 6e 67 20 74 61 62 6c 65 20 61 6e 64 20 69 6e ing table and in
15f50 64 65 78 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 dex:.**.** C
15f60 52 45 41 54 45 20 54 41 42 4c 45 20 45 78 31 28 REATE TABLE Ex1(
15f70 63 31 20 69 6e 74 2c 20 63 32 20 69 6e 74 2c 20 c1 int, c2 int,
15f80 63 33 20 74 65 78 74 29 3b 0a 2a 2a 20 20 20 20 c3 text);.**
15f90 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 45 78 CREATE INDEX Ex
15fa0 32 20 4f 4e 20 45 78 31 28 63 33 2c 63 31 29 3b 2 ON Ex1(c3,c1);
15fb0 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 54 61 .**.** In the Ta
15fc0 62 6c 65 20 73 74 72 75 63 74 75 72 65 20 64 65 ble structure de
15fd0 73 63 72 69 62 69 6e 67 20 45 78 31 2c 20 6e 43 scribing Ex1, nC
15fe0 6f 6c 3d 3d 33 20 62 65 63 61 75 73 65 20 74 68 ol==3 because th
15ff0 65 72 65 20 61 72 65 0a 2a 2a 20 74 68 72 65 65 ere are.** three
16000 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 columns in the
16010 74 61 62 6c 65 2e 20 20 49 6e 20 74 68 65 20 49 table. In the I
16020 6e 64 65 78 20 73 74 72 75 63 74 75 72 65 20 64 ndex structure d
16030 65 73 63 72 69 62 69 6e 67 0a 2a 2a 20 45 78 32 escribing.** Ex2
16040 2c 20 6e 43 6f 6c 75 6d 6e 3d 3d 32 20 73 69 6e , nColumn==2 sin
16050 63 65 20 32 20 6f 66 20 74 68 65 20 33 20 63 6f ce 2 of the 3 co
16060 6c 75 6d 6e 73 20 6f 66 20 45 78 31 20 61 72 65 lumns of Ex1 are
16070 20 69 6e 64 65 78 65 64 2e 0a 2a 2a 20 54 68 65 indexed..** The
16080 20 76 61 6c 75 65 20 6f 66 20 61 69 43 6f 6c 75 value of aiColu
16090 6d 6e 20 69 73 20 7b 32 2c 20 30 7d 2e 20 20 61 mn is {2, 0}. a
160a0 69 43 6f 6c 75 6d 6e 5b 30 5d 3d 3d 32 20 62 65 iColumn[0]==2 be
160b0 63 61 75 73 65 20 74 68 65 0a 2a 2a 20 66 69 72 cause the.** fir
160c0 73 74 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 st column to be
160d0 69 6e 64 65 78 65 64 20 28 63 33 29 20 68 61 73 indexed (c3) has
160e0 20 61 6e 20 69 6e 64 65 78 20 6f 66 20 32 20 69 an index of 2 i
160f0 6e 20 45 78 31 2e 61 43 6f 6c 5b 5d 2e 0a 2a 2a n Ex1.aCol[]..**
16100 20 54 68 65 20 73 65 63 6f 6e 64 20 63 6f 6c 75 The second colu
16110 6d 6e 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 mn to be indexed
16120 20 28 63 31 29 20 68 61 73 20 61 6e 20 69 6e 64 (c1) has an ind
16130 65 78 20 6f 66 20 30 20 69 6e 0a 2a 2a 20 45 78 ex of 0 in.** Ex
16140 31 2e 61 43 6f 6c 5b 5d 2c 20 68 65 6e 63 65 20 1.aCol[], hence
16150 45 78 32 2e 61 69 43 6f 6c 75 6d 6e 5b 31 5d 3d Ex2.aiColumn[1]=
16160 3d 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 6e =0..**.** The In
16170 64 65 78 2e 6f 6e 45 72 72 6f 72 20 66 69 65 6c dex.onError fiel
16180 64 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 d determines whe
16190 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 ther or not the
161a0 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d 6e 73 0a indexed columns.
161b0 2a 2a 20 6d 75 73 74 20 62 65 20 75 6e 69 71 75 ** must be uniqu
161c0 65 20 61 6e 64 20 77 68 61 74 20 74 6f 20 64 6f e and what to do
161d0 20 69 66 20 74 68 65 79 20 61 72 65 20 6e 6f 74 if they are not
161e0 2e 20 20 57 68 65 6e 20 49 6e 64 65 78 2e 6f 6e . When Index.on
161f0 45 72 72 6f 72 3d 4f 45 5f 4e 6f 6e 65 2c 0a 2a Error=OE_None,.*
16200 2a 20 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 * it means this
16210 69 73 20 6e 6f 74 20 61 20 75 6e 69 71 75 65 20 is not a unique
16220 69 6e 64 65 78 2e 20 20 4f 74 68 65 72 77 69 73 index. Otherwis
16230 65 20 69 74 20 69 73 20 61 20 75 6e 69 71 75 65 e it is a unique
16240 20 69 6e 64 65 78 0a 2a 2a 20 61 6e 64 20 74 68 index.** and th
16250 65 20 76 61 6c 75 65 20 6f 66 20 49 6e 64 65 78 e value of Index
16260 2e 6f 6e 45 72 72 6f 72 20 69 6e 64 69 63 61 74 .onError indicat
16270 65 20 74 68 65 20 77 68 69 63 68 20 63 6f 6e 66 e the which conf
16280 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 0a lict resolution.
16290 2a 2a 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 ** algorithm to
162a0 65 6d 70 6c 6f 79 20 77 68 65 6e 65 76 65 72 20 employ whenever
162b0 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 an attempt is ma
162c0 64 65 20 74 6f 20 69 6e 73 65 72 74 20 61 20 6e de to insert a n
162d0 6f 6e 2d 75 6e 69 71 75 65 0a 2a 2a 20 65 6c 65 on-unique.** ele
162e0 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 57 68 69 6c ment..**.** Whil
162f0 65 20 70 61 72 73 69 6e 67 20 61 20 43 52 45 41 e parsing a CREA
16300 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 TE TABLE or CREA
16310 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 TE INDEX stateme
16320 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a nt in order to.*
16330 2a 20 67 65 6e 65 72 61 74 65 20 56 44 42 45 20 * generate VDBE
16340 63 6f 64 65 20 28 61 73 20 6f 70 70 6f 73 65 64 code (as opposed
16350 20 74 6f 20 70 61 72 73 69 6e 67 20 6f 6e 65 20 to parsing one
16360 72 65 61 64 20 66 72 6f 6d 20 61 6e 20 73 71 6c read from an sql
16370 69 74 65 5f 6d 61 73 74 65 72 0a 2a 2a 20 74 61 ite_master.** ta
16380 62 6c 65 20 61 73 20 70 61 72 74 20 6f 66 20 70 ble as part of p
16390 61 72 73 69 6e 67 20 61 6e 20 65 78 69 73 74 69 arsing an existi
163a0 6e 67 20 64 61 74 61 62 61 73 65 20 73 63 68 65 ng database sche
163b0 6d 61 29 2c 20 74 72 61 6e 73 69 65 6e 74 20 69 ma), transient i
163c0 6e 73 74 61 6e 63 65 73 0a 2a 2a 20 6f 66 20 74 nstances.** of t
163d0 68 69 73 20 73 74 72 75 63 74 75 72 65 20 6d 61 his structure ma
163e0 79 20 62 65 20 63 72 65 61 74 65 64 2e 20 49 6e y be created. In
163f0 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 49 this case the I
16400 6e 64 65 78 2e 74 6e 75 6d 20 76 61 72 69 61 62 ndex.tnum variab
16410 6c 65 20 69 73 0a 2a 2a 20 75 73 65 64 20 74 6f le is.** used to
16420 20 73 74 6f 72 65 20 74 68 65 20 61 64 64 72 65 store the addre
16430 73 73 20 6f 66 20 61 20 56 44 42 45 20 69 6e 73 ss of a VDBE ins
16440 74 72 75 63 74 69 6f 6e 2c 20 6e 6f 74 20 61 20 truction, not a
16450 64 61 74 61 62 61 73 65 20 70 61 67 65 0a 2a 2a database page.**
16460 20 6e 75 6d 62 65 72 20 28 69 74 20 63 61 6e 6e number (it cann
16470 6f 74 20 2d 20 74 68 65 20 64 61 74 61 62 61 73 ot - the databas
16480 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 61 6c e page is not al
16490 6c 6f 63 61 74 65 64 20 75 6e 74 69 6c 20 74 68 located until th
164a0 65 20 56 44 42 45 0a 2a 2a 20 70 72 6f 67 72 61 e VDBE.** progra
164b0 6d 20 69 73 20 65 78 65 63 75 74 65 64 29 2e 20 m is executed).
164c0 53 65 65 20 63 6f 6e 76 65 72 74 54 6f 57 69 74 See convertToWit
164d0 68 6f 75 74 52 6f 77 69 64 54 61 62 6c 65 28 29 houtRowidTable()
164e0 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f for details..*/
164f0 0a 73 74 72 75 63 74 20 49 6e 64 65 78 20 7b 0a .struct Index {.
16500 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
16510 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 /* Na
16520 6d 65 20 6f 66 20 74 68 69 73 20 69 6e 64 65 78 me of this index
16530 20 2a 2f 0a 20 20 69 31 36 20 2a 61 69 43 6f 6c */. i16 *aiCol
16540 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 2f umn; /
16550 2a 20 57 68 69 63 68 20 63 6f 6c 75 6d 6e 73 20 * Which columns
16560 61 72 65 20 75 73 65 64 20 62 79 20 74 68 69 73 are used by this
16570 20 69 6e 64 65 78 2e 20 20 31 73 74 20 69 73 20 index. 1st is
16580 30 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 2a 61 0 */. LogEst *a
16590 69 52 6f 77 4c 6f 67 45 73 74 3b 20 20 20 20 20 iRowLogEst;
165a0 2f 2a 20 46 72 6f 6d 20 41 4e 41 4c 59 5a 45 3a /* From ANALYZE:
165b0 20 45 73 74 2e 20 72 6f 77 73 20 73 65 6c 65 63 Est. rows selec
165c0 74 65 64 20 62 79 20 65 61 63 68 20 63 6f 6c 75 ted by each colu
165d0 6d 6e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 mn */. Table *p
165e0 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 Table;
165f0 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 61 62 6c /* The SQL tabl
16600 65 20 62 65 69 6e 67 20 69 6e 64 65 78 65 64 20 e being indexed
16610 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6c 41 */. char *zColA
16620 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ff; /*
16630 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 6e 67 String defining
16640 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 the affinity of
16650 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a each column */.
16660 20 20 49 6e 64 65 78 20 2a 70 4e 65 78 74 3b 20 Index *pNext;
16670 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
16680 65 20 6e 65 78 74 20 69 6e 64 65 78 20 61 73 73 e next index ass
16690 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 ociated with the
166a0 20 73 61 6d 65 20 74 61 62 6c 65 20 2a 2f 0a 20 same table */.
166b0 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 Schema *pSchema
166c0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 63 68 ; /* Sch
166d0 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ema containing t
166e0 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 his index */. u
166f0 38 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b 20 20 8 *aSortOrder;
16700 20 20 20 20 20 20 20 20 2f 2a 20 66 6f 72 20 65 /* for e
16710 61 63 68 20 63 6f 6c 75 6d 6e 3a 20 54 72 75 65 ach column: True
16720 3d 3d 44 45 53 43 2c 20 46 61 6c 73 65 3d 3d 41 ==DESC, False==A
16730 53 43 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 SC */. const ch
16740 61 72 20 2a 2a 61 7a 43 6f 6c 6c 3b 20 20 20 20 ar **azColl;
16750 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 6f 6c /* Array of col
16760 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 lation sequence
16770 6e 61 6d 65 73 20 66 6f 72 20 69 6e 64 65 78 20 names for index
16780 2a 2f 0a 20 20 45 78 70 72 20 2a 70 50 61 72 74 */. Expr *pPart
16790 49 64 78 57 68 65 72 65 3b 20 20 20 20 20 2f 2a IdxWhere; /*
167a0 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 66 6f WHERE clause fo
167b0 72 20 70 61 72 74 69 61 6c 20 69 6e 64 69 63 65 r partial indice
167c0 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
167d0 2a 61 43 6f 6c 45 78 70 72 3b 20 20 20 20 20 20 *aColExpr;
167e0 2f 2a 20 43 6f 6c 75 6d 6e 20 65 78 70 72 65 73 /* Column expres
167f0 73 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 74 sions */. int t
16800 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 num;
16810 20 20 20 20 2f 2a 20 44 42 20 50 61 67 65 20 63 /* DB Page c
16820 6f 6e 74 61 69 6e 69 6e 67 20 72 6f 6f 74 20 6f ontaining root o
16830 66 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a f this index */.
16840 20 20 4c 6f 67 45 73 74 20 73 7a 49 64 78 52 6f LogEst szIdxRo
16850 77 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 45 73 w; /* Es
16860 74 69 6d 61 74 65 64 20 61 76 65 72 61 67 65 20 timated average
16870 72 6f 77 20 73 69 7a 65 20 69 6e 20 62 79 74 65 row size in byte
16880 73 20 2a 2f 0a 20 20 75 31 36 20 6e 4b 65 79 43 s */. u16 nKeyC
16890 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ol;
168a0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c /* Number of col
168b0 75 6d 6e 73 20 66 6f 72 6d 69 6e 67 20 74 68 65 umns forming the
168c0 20 6b 65 79 20 2a 2f 0a 20 20 75 31 36 20 6e 43 key */. u16 nC
168d0 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
168e0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
168f0 63 6f 6c 75 6d 6e 73 20 73 74 6f 72 65 64 20 69 columns stored i
16900 6e 20 74 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 n the index */.
16910 20 75 38 20 6f 6e 45 72 72 6f 72 3b 20 20 20 20 u8 onError;
16920 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f /* OE_
16930 41 62 6f 72 74 2c 20 4f 45 5f 49 67 6e 6f 72 65 Abort, OE_Ignore
16940 2c 20 4f 45 5f 52 65 70 6c 61 63 65 2c 20 6f 72 , OE_Replace, or
16950 20 4f 45 5f 4e 6f 6e 65 20 2a 2f 0a 20 20 75 6e OE_None */. un
16960 73 69 67 6e 65 64 20 69 64 78 54 79 70 65 3a 32 signed idxType:2
16970 3b 20 20 20 20 20 20 2f 2a 20 31 3d 3d 55 4e 49 ; /* 1==UNI
16980 51 55 45 2c 20 32 3d 3d 50 52 49 4d 41 52 59 20 QUE, 2==PRIMARY
16990 4b 45 59 2c 20 30 3d 3d 43 52 45 41 54 45 20 49 KEY, 0==CREATE I
169a0 4e 44 45 58 20 2a 2f 0a 20 20 75 6e 73 69 67 6e NDEX */. unsign
169b0 65 64 20 62 55 6e 6f 72 64 65 72 65 64 3a 31 3b ed bUnordered:1;
169c0 20 20 20 2f 2a 20 55 73 65 20 74 68 69 73 20 69 /* Use this i
169d0 6e 64 65 78 20 66 6f 72 20 3d 3d 20 6f 72 20 49 ndex for == or I
169e0 4e 20 71 75 65 72 69 65 73 20 6f 6e 6c 79 20 2a N queries only *
169f0 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 75 6e 69 /. unsigned uni
16a00 71 4e 6f 74 4e 75 6c 6c 3a 31 3b 20 20 2f 2a 20 qNotNull:1; /*
16a10 54 72 75 65 20 69 66 20 55 4e 49 51 55 45 20 61 True if UNIQUE a
16a20 6e 64 20 4e 4f 54 20 4e 55 4c 4c 20 66 6f 72 20 nd NOT NULL for
16a30 61 6c 6c 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 all columns */.
16a40 20 75 6e 73 69 67 6e 65 64 20 69 73 52 65 73 69 unsigned isResi
16a50 7a 65 64 3a 31 3b 20 20 20 20 2f 2a 20 54 72 75 zed:1; /* Tru
16a60 65 20 69 66 20 72 65 73 69 7a 65 49 6e 64 65 78 e if resizeIndex
16a70 4f 62 6a 65 63 74 28 29 20 68 61 73 20 62 65 65 Object() has bee
16a80 6e 20 63 61 6c 6c 65 64 20 2a 2f 0a 20 20 75 6e n called */. un
16a90 73 69 67 6e 65 64 20 69 73 43 6f 76 65 72 69 6e signed isCoverin
16aa0 67 3a 31 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 g:1; /* True i
16ab0 66 20 74 68 69 73 20 69 73 20 61 20 63 6f 76 65 f this is a cove
16ac0 72 69 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 ring index */.
16ad0 75 6e 73 69 67 6e 65 64 20 6e 6f 53 6b 69 70 53 unsigned noSkipS
16ae0 63 61 6e 3a 31 3b 20 20 20 2f 2a 20 44 6f 20 6e can:1; /* Do n
16af0 6f 74 20 74 72 79 20 74 6f 20 75 73 65 20 73 6b ot try to use sk
16b00 69 70 2d 73 63 61 6e 20 69 66 20 74 72 75 65 20 ip-scan if true
16b10 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 68 61 */. unsigned ha
16b20 73 53 74 61 74 31 3a 31 3b 20 20 20 20 20 2f 2a sStat1:1; /*
16b30 20 61 69 52 6f 77 4c 6f 67 45 73 74 20 76 61 6c aiRowLogEst val
16b40 75 65 73 20 63 6f 6d 65 20 66 72 6f 6d 20 73 71 ues come from sq
16b50 6c 69 74 65 5f 73 74 61 74 31 20 2a 2f 0a 20 20 lite_stat1 */.
16b60 75 6e 73 69 67 6e 65 64 20 62 4e 6f 51 75 65 72 unsigned bNoQuer
16b70 79 3a 31 3b 20 20 20 20 20 2f 2a 20 44 6f 20 6e y:1; /* Do n
16b80 6f 74 20 75 73 65 20 74 68 69 73 20 69 6e 64 65 ot use this inde
16b90 78 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 71 75 x to optimize qu
16ba0 65 72 69 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 eries */.#ifdef
16bb0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
16bc0 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 AT3_OR_STAT4. i
16bd0 6e 74 20 6e 53 61 6d 70 6c 65 3b 20 20 20 20 20 nt nSample;
16be0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
16bf0 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e r of elements in
16c00 20 61 53 61 6d 70 6c 65 5b 5d 20 2a 2f 0a 20 20 aSample[] */.
16c10 69 6e 74 20 6e 53 61 6d 70 6c 65 43 6f 6c 3b 20 int nSampleCol;
16c20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
16c30 20 6f 66 20 49 6e 64 65 78 53 61 6d 70 6c 65 2e of IndexSample.
16c40 61 6e 45 71 5b 5d 20 61 6e 64 20 73 6f 20 6f 6e anEq[] and so on
16c50 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 */. tRowcnt *a
16c60 41 76 67 45 71 3b 20 20 20 20 20 20 20 20 20 2f AvgEq; /
16c70 2a 20 41 76 65 72 61 67 65 20 6e 45 71 20 76 61 * Average nEq va
16c80 6c 75 65 73 20 66 6f 72 20 6b 65 79 73 20 6e 6f lues for keys no
16c90 74 20 69 6e 20 61 53 61 6d 70 6c 65 20 2a 2f 0a t in aSample */.
16ca0 20 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 2a 61 IndexSample *a
16cb0 53 61 6d 70 6c 65 3b 20 20 20 20 2f 2a 20 53 61 Sample; /* Sa
16cc0 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 6c 65 66 mples of the lef
16cd0 74 2d 6d 6f 73 74 20 6b 65 79 20 2a 2f 0a 20 20 t-most key */.
16ce0 74 52 6f 77 63 6e 74 20 2a 61 69 52 6f 77 45 73 tRowcnt *aiRowEs
16cf0 74 3b 20 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d t; /* Non-
16d00 6c 6f 67 61 72 69 74 68 6d 69 63 20 73 74 61 74 logarithmic stat
16d10 31 20 64 61 74 61 20 66 6f 72 20 74 68 69 73 20 1 data for this
16d20 69 6e 64 65 78 20 2a 2f 0a 20 20 74 52 6f 77 63 index */. tRowc
16d30 6e 74 20 6e 52 6f 77 45 73 74 30 3b 20 20 20 20 nt nRowEst0;
16d40 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6c 6f 67 61 72 /* Non-logar
16d50 69 74 68 6d 69 63 20 6e 75 6d 62 65 72 20 6f 66 ithmic number of
16d60 20 72 6f 77 73 20 69 6e 20 74 68 65 20 69 6e 64 rows in the ind
16d70 65 78 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 42 ex */.#endif. B
16d80 69 74 6d 61 73 6b 20 63 6f 6c 4e 6f 74 49 64 78 itmask colNotIdx
16d90 65 64 3b 20 20 20 20 20 2f 2a 20 30 20 66 6f 72 ed; /* 0 for
16da0 20 75 6e 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d unindexed colum
16db0 6e 73 20 69 6e 20 70 54 61 62 20 2a 2f 0a 7d 3b ns in pTab */.};
16dc0 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 ../*.** Allowed
16dd0 76 61 6c 75 65 73 20 66 6f 72 20 49 6e 64 65 78 values for Index
16de0 2e 69 64 78 54 79 70 65 0a 2a 2f 0a 23 64 65 66 .idxType.*/.#def
16df0 69 6e 65 20 53 51 4c 49 54 45 5f 49 44 58 54 59 ine SQLITE_IDXTY
16e00 50 45 5f 41 50 50 44 45 46 20 20 20 20 20 20 30 PE_APPDEF 0
16e10 20 20 20 2f 2a 20 43 72 65 61 74 65 64 20 75 73 /* Created us
16e20 69 6e 67 20 43 52 45 41 54 45 20 49 4e 44 45 58 ing CREATE INDEX
16e30 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
16e40 54 45 5f 49 44 58 54 59 50 45 5f 55 4e 49 51 55 TE_IDXTYPE_UNIQU
16e50 45 20 20 20 20 20 20 31 20 20 20 2f 2a 20 49 6d E 1 /* Im
16e60 70 6c 65 6d 65 6e 74 73 20 61 20 55 4e 49 51 55 plements a UNIQU
16e70 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a E constraint */.
16e80 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 #define SQLITE_I
16e90 44 58 54 59 50 45 5f 50 52 49 4d 41 52 59 4b 45 DXTYPE_PRIMARYKE
16ea0 59 20 20 32 20 20 20 2f 2a 20 49 73 20 74 68 65 Y 2 /* Is the
16eb0 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 6f 72 PRIMARY KEY for
16ec0 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 0a 2f the table */../
16ed0 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 * Return true if
16ee0 20 69 6e 64 65 78 20 58 20 69 73 20 61 20 50 52 index X is a PR
16ef0 49 4d 41 52 59 20 4b 45 59 20 69 6e 64 65 78 20 IMARY KEY index
16f00 2a 2f 0a 23 64 65 66 69 6e 65 20 49 73 50 72 69 */.#define IsPri
16f10 6d 61 72 79 4b 65 79 49 6e 64 65 78 28 58 29 20 maryKeyIndex(X)
16f20 20 28 28 58 29 2d 3e 69 64 78 54 79 70 65 3d 3d ((X)->idxType==
16f30 53 51 4c 49 54 45 5f 49 44 58 54 59 50 45 5f 50 SQLITE_IDXTYPE_P
16f40 52 49 4d 41 52 59 4b 45 59 29 0a 0a 2f 2a 20 52 RIMARYKEY)../* R
16f50 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 6e eturn true if in
16f60 64 65 78 20 58 20 69 73 20 61 20 55 4e 49 51 55 dex X is a UNIQU
16f70 45 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 E index */.#defi
16f80 6e 65 20 49 73 55 6e 69 71 75 65 49 6e 64 65 78 ne IsUniqueIndex
16f90 28 58 29 20 20 20 20 20 20 28 28 58 29 2d 3e 6f (X) ((X)->o
16fa0 6e 45 72 72 6f 72 21 3d 4f 45 5f 4e 6f 6e 65 29 nError!=OE_None)
16fb0 0a 0a 2f 2a 20 54 68 65 20 49 6e 64 65 78 2e 61 ../* The Index.a
16fc0 69 43 6f 6c 75 6d 6e 5b 5d 20 76 61 6c 75 65 73 iColumn[] values
16fd0 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 70 6f are normally po
16fe0 73 69 74 69 76 65 20 69 6e 74 65 67 65 72 2e 20 sitive integer.
16ff0 20 42 75 74 0a 2a 2a 20 74 68 65 72 65 20 61 72 But.** there ar
17000 65 20 73 6f 6d 65 20 6e 65 67 61 74 69 76 65 20 e some negative
17010 76 61 6c 75 65 73 20 74 68 61 74 20 68 61 76 65 values that have
17020 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e 67 special meaning
17030 3a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e 5f :.*/.#define XN_
17040 52 4f 57 49 44 20 20 20 20 20 28 2d 31 29 20 20 ROWID (-1)
17050 20 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f /* Indexed co
17060 6c 75 6d 6e 20 69 73 20 74 68 65 20 72 6f 77 69 lumn is the rowi
17070 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e 5f d */.#define XN_
17080 45 58 50 52 20 20 20 20 20 20 28 2d 32 29 20 20 EXPR (-2)
17090 20 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f /* Indexed co
170a0 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 lumn is an expre
170b0 73 73 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 ssion */../*.**
170c0 45 61 63 68 20 73 61 6d 70 6c 65 20 73 74 6f 72 Each sample stor
170d0 65 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 ed in the sqlite
170e0 5f 73 74 61 74 33 20 74 61 62 6c 65 20 69 73 20 _stat3 table is
170f0 72 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 6d represented in m
17100 65 6d 6f 72 79 0a 2a 2a 20 75 73 69 6e 67 20 61 emory.** using a
17110 20 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 structure of th
17120 69 73 20 74 79 70 65 2e 20 20 53 65 65 20 64 6f is type. See do
17130 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 20 74 cumentation at t
17140 68 65 20 74 6f 70 20 6f 66 20 74 68 65 0a 2a 2a he top of the.**
17150 20 61 6e 61 6c 79 7a 65 2e 63 20 73 6f 75 72 63 analyze.c sourc
17160 65 20 66 69 6c 65 20 66 6f 72 20 61 64 64 69 74 e file for addit
17170 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f ional informatio
17180 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 n..*/.struct Ind
17190 65 78 53 61 6d 70 6c 65 20 7b 0a 20 20 76 6f 69 exSample {. voi
171a0 64 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 2f d *p; /
171b0 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 73 61 6d * Pointer to sam
171c0 70 6c 65 64 20 72 65 63 6f 72 64 20 2a 2f 0a 20 pled record */.
171d0 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20 int n;
171e0 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65 /* Size of re
171f0 63 6f 72 64 20 69 6e 20 62 79 74 65 73 20 2a 2f cord in bytes */
17200 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 45 71 . tRowcnt *anEq
17210 3b 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d ; /* Est. num
17220 62 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 ber of rows wher
17230 65 20 74 68 65 20 6b 65 79 20 65 71 75 61 6c 73 e the key equals
17240 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a this sample */.
17250 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 4c 74 3b tRowcnt *anLt;
17260 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 /* Est. numb
17270 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 er of rows where
17280 20 6b 65 79 20 69 73 20 6c 65 73 73 20 74 68 61 key is less tha
17290 6e 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f n this sample */
172a0 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 44 4c . tRowcnt *anDL
172b0 74 3b 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d t; /* Est. num
172c0 62 65 72 20 6f 66 20 64 69 73 74 69 6e 63 74 20 ber of distinct
172d0 6b 65 79 73 20 6c 65 73 73 20 74 68 61 6e 20 74 keys less than t
172e0 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 7d 3b his sample */.};
172f0 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c 65 ../*.** Possible
17300 20 76 61 6c 75 65 73 20 74 6f 20 75 73 65 20 77 values to use w
17310 69 74 68 69 6e 20 74 68 65 20 66 6c 61 67 73 20 ithin the flags
17320 61 72 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 argument to sqli
17330 74 65 33 47 65 74 54 6f 6b 65 6e 28 29 2e 0a 2a te3GetToken()..*
17340 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
17350 5f 54 4f 4b 45 4e 5f 51 55 4f 54 45 44 20 20 20 _TOKEN_QUOTED
17360 20 30 78 31 20 2f 2a 20 54 6f 6b 65 6e 20 69 73 0x1 /* Token is
17370 20 61 20 71 75 6f 74 65 64 20 69 64 65 6e 74 69 a quoted identi
17380 66 69 65 72 2e 20 2a 2f 0a 23 64 65 66 69 6e 65 fier. */.#define
17390 20 53 51 4c 49 54 45 5f 54 4f 4b 45 4e 5f 4b 45 SQLITE_TOKEN_KE
173a0 59 57 4f 52 44 20 20 20 30 78 32 20 2f 2a 20 54 YWORD 0x2 /* T
173b0 6f 6b 65 6e 20 69 73 20 61 20 6b 65 79 77 6f 72 oken is a keywor
173c0 64 2e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 d. */../*.** Eac
173d0 68 20 74 6f 6b 65 6e 20 63 6f 6d 69 6e 67 20 6f h token coming o
173e0 75 74 20 6f 66 20 74 68 65 20 6c 65 78 65 72 20 ut of the lexer
173f0 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f is an instance o
17400 66 0a 2a 2a 20 74 68 69 73 20 73 74 72 75 63 74 f.** this struct
17410 75 72 65 2e 20 20 54 6f 6b 65 6e 73 20 61 72 65 ure. Tokens are
17420 20 61 6c 73 6f 20 75 73 65 64 20 61 73 20 70 61 also used as pa
17430 72 74 20 6f 66 20 61 6e 20 65 78 70 72 65 73 73 rt of an express
17440 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d ion..**.** The m
17450 65 6d 6f 72 79 20 74 68 61 74 20 22 7a 22 20 70 emory that "z" p
17460 6f 69 6e 74 73 20 74 6f 20 69 73 20 6f 77 6e 65 oints to is owne
17470 64 20 62 79 20 6f 74 68 65 72 20 6f 62 6a 65 63 d by other objec
17480 74 73 2e 20 20 54 61 6b 65 20 63 61 72 65 0a 2a ts. Take care.*
17490 2a 20 74 68 61 74 20 74 68 65 20 6f 77 6e 65 72 * that the owner
174a0 20 6f 66 20 74 68 65 20 22 7a 22 20 73 74 72 69 of the "z" stri
174b0 6e 67 20 64 6f 65 73 20 6e 6f 74 20 64 65 61 6c ng does not deal
174c0 6c 6f 63 61 74 65 20 74 68 65 20 73 74 72 69 6e locate the strin
174d0 67 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 65 20 g before.** the
174e0 54 6f 6b 65 6e 20 67 6f 65 73 20 6f 75 74 20 6f Token goes out o
174f0 66 20 73 63 6f 70 65 21 20 20 56 65 72 79 20 6f f scope! Very o
17500 66 74 65 6e 2c 20 74 68 65 20 22 7a 22 20 70 6f ften, the "z" po
17510 69 6e 74 73 20 74 6f 20 73 6f 6d 65 20 70 6c 61 ints to some pla
17520 63 65 0a 2a 2a 20 69 6e 20 74 68 65 20 6d 69 64 ce.** in the mid
17530 64 6c 65 20 6f 66 20 74 68 65 20 50 61 72 73 65 dle of the Parse
17540 2e 7a 53 71 6c 20 74 65 78 74 2e 20 20 42 75 74 .zSql text. But
17550 20 69 74 20 6d 69 67 68 74 20 61 6c 73 6f 20 70 it might also p
17560 6f 69 6e 74 20 74 6f 20 61 0a 2a 2a 20 73 74 61 oint to a.** sta
17570 74 69 63 20 73 74 72 69 6e 67 2e 0a 2a 2f 0a 73 tic string..*/.s
17580 74 72 75 63 74 20 54 6f 6b 65 6e 20 7b 0a 20 20 truct Token {.
17590 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b 20 20 const char *z;
175a0 20 20 20 2f 2a 20 54 65 78 74 20 6f 66 20 74 68 /* Text of th
175b0 65 20 74 6f 6b 65 6e 2e 20 20 4e 6f 74 20 4e 55 e token. Not NU
175c0 4c 4c 2d 74 65 72 6d 69 6e 61 74 65 64 21 20 2a LL-terminated! *
175d0 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 /. unsigned int
175e0 20 6e 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 n; /* Number
175f0 20 6f 66 20 63 68 61 72 61 63 74 65 72 73 20 69 of characters i
17600 6e 20 74 68 69 73 20 74 6f 6b 65 6e 20 2a 2f 0a n this token */.
17610 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 };../*.** An ins
17620 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 73 74 tance of this st
17630 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 ructure contains
17640 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6e 65 65 information nee
17650 64 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 0a ded to generate.
17660 2a 2a 20 63 6f 64 65 20 66 6f 72 20 61 20 53 45 ** code for a SE
17670 4c 45 43 54 20 74 68 61 74 20 63 6f 6e 74 61 69 LECT that contai
17680 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 75 6e ns aggregate fun
17690 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 ctions..**.** If
176a0 20 45 78 70 72 2e 6f 70 3d 3d 54 4b 5f 41 47 47 Expr.op==TK_AGG
176b0 5f 43 4f 4c 55 4d 4e 20 6f 72 20 54 4b 5f 41 47 _COLUMN or TK_AG
176c0 47 5f 46 55 4e 43 54 49 4f 4e 20 74 68 65 6e 20 G_FUNCTION then
176d0 45 78 70 72 2e 70 41 67 67 49 6e 66 6f 20 69 73 Expr.pAggInfo is
176e0 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f a.** pointer to
176f0 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 2e this structure.
17700 20 20 54 68 65 20 45 78 70 72 2e 69 43 6f 6c 75 The Expr.iColu
17710 6d 6e 20 66 69 65 6c 64 20 69 73 20 74 68 65 20 mn field is the
17720 69 6e 64 65 78 20 69 6e 0a 2a 2a 20 41 67 67 49 index in.** AggI
17730 6e 66 6f 2e 61 43 6f 6c 5b 5d 20 6f 72 20 41 67 nfo.aCol[] or Ag
17740 67 49 6e 66 6f 2e 61 46 75 6e 63 5b 5d 20 6f 66 gInfo.aFunc[] of
17750 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6e 65 65 information nee
17760 64 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 0a ded to generate.
17770 2a 2a 20 63 6f 64 65 20 66 6f 72 20 74 68 61 74 ** code for that
17780 20 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 67 67 node..**.** Agg
17790 49 6e 66 6f 2e 70 47 72 6f 75 70 42 79 20 61 6e Info.pGroupBy an
177a0 64 20 41 67 67 49 6e 66 6f 2e 61 46 75 6e 63 2e d AggInfo.aFunc.
177b0 70 45 78 70 72 20 70 6f 69 6e 74 20 74 6f 20 66 pExpr point to f
177c0 69 65 6c 64 73 20 77 69 74 68 69 6e 20 74 68 65 ields within the
177d0 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c 20 53 65 6c .** original Sel
177e0 65 63 74 20 73 74 72 75 63 74 75 72 65 20 74 68 ect structure th
177f0 61 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 at describes the
17800 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
17810 74 2e 20 20 54 68 65 73 65 0a 2a 2a 20 66 69 65 t. These.** fie
17820 6c 64 73 20 64 6f 20 6e 6f 74 20 6e 65 65 64 20 lds do not need
17830 74 6f 20 62 65 20 66 72 65 65 64 20 77 68 65 6e to be freed when
17840 20 64 65 61 6c 6c 6f 63 61 74 69 6e 67 20 74 68 deallocating th
17850 65 20 41 67 67 49 6e 66 6f 20 73 74 72 75 63 74 e AggInfo struct
17860 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 41 ure..*/.struct A
17870 67 67 49 6e 66 6f 20 7b 0a 20 20 75 38 20 64 69 ggInfo {. u8 di
17880 72 65 63 74 4d 6f 64 65 3b 20 20 20 20 20 20 20 rectMode;
17890 20 20 20 2f 2a 20 44 69 72 65 63 74 20 72 65 6e /* Direct ren
178a0 64 65 72 69 6e 67 20 6d 6f 64 65 20 6d 65 61 6e dering mode mean
178b0 73 20 74 61 6b 65 20 64 61 74 61 20 64 69 72 65 s take data dire
178c0 63 74 6c 79 0a 20 20 20 20 20 20 20 20 20 20 20 ctly.
178d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
178e0 2a 20 66 72 6f 6d 20 73 6f 75 72 63 65 20 74 61 * from source ta
178f0 62 6c 65 73 20 72 61 74 68 65 72 20 74 68 61 6e bles rather than
17900 20 66 72 6f 6d 20 61 63 63 75 6d 75 6c 61 74 6f from accumulato
17910 72 73 20 2a 2f 0a 20 20 75 38 20 75 73 65 53 6f rs */. u8 useSo
17920 72 74 69 6e 67 49 64 78 3b 20 20 20 20 20 20 20 rtingIdx;
17930 2f 2a 20 49 6e 20 64 69 72 65 63 74 20 6d 6f 64 /* In direct mod
17940 65 2c 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 e, reference the
17950 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 20 72 sorting index r
17960 61 74 68 65 72 0a 20 20 20 20 20 20 20 20 20 20 ather.
17970 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17980 2a 2a 20 74 68 61 6e 20 74 68 65 20 73 6f 75 72 ** than the sour
17990 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69 6e ce table */. in
179a0 74 20 73 6f 72 74 69 6e 67 49 64 78 3b 20 20 20 t sortingIdx;
179b0 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 /* Cursor
179c0 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 73 6f number of the so
179d0 72 74 69 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 rting index */.
179e0 20 69 6e 74 20 73 6f 72 74 69 6e 67 49 64 78 50 int sortingIdxP
179f0 54 61 62 3b 20 20 20 20 20 2f 2a 20 43 75 72 73 Tab; /* Curs
17a00 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 70 73 65 or number of pse
17a10 75 64 6f 2d 74 61 62 6c 65 20 2a 2f 0a 20 20 69 udo-table */. i
17a20 6e 74 20 6e 53 6f 72 74 69 6e 67 43 6f 6c 75 6d nt nSortingColum
17a30 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 n; /* Number
17a40 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 of columns in t
17a50 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 he sorting index
17a60 20 2a 2f 0a 20 20 69 6e 74 20 6d 6e 52 65 67 2c */. int mnReg,
17a70 20 6d 78 52 65 67 3b 20 20 20 20 20 20 20 2f 2a mxReg; /*
17a80 20 52 61 6e 67 65 20 6f 66 20 72 65 67 69 73 74 Range of regist
17a90 65 72 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f ers allocated fo
17aa0 72 20 61 43 6f 6c 20 61 6e 64 20 61 46 75 6e 63 r aCol and aFunc
17ab0 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a */. ExprList *
17ac0 70 47 72 6f 75 70 42 79 3b 20 20 20 20 20 2f 2a pGroupBy; /*
17ad0 20 54 68 65 20 67 72 6f 75 70 20 62 79 20 63 6c The group by cl
17ae0 61 75 73 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 ause */. struct
17af0 20 41 67 67 49 6e 66 6f 5f 63 6f 6c 20 7b 20 20 AggInfo_col {
17b00 20 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 63 6f /* For each co
17b10 6c 75 6d 6e 20 75 73 65 64 20 69 6e 20 73 6f 75 lumn used in sou
17b20 72 63 65 20 74 61 62 6c 65 73 20 2a 2f 0a 20 20 rce tables */.
17b30 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 Table *pTab;
17b40 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f /* So
17b50 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 urce table */.
17b60 20 20 69 6e 74 20 69 54 61 62 6c 65 3b 20 20 20 int iTable;
17b70 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 /* Cu
17b80 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 rsor number of t
17b90 68 65 20 73 6f 75 72 63 65 20 74 61 62 6c 65 20 he source table
17ba0 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 6f 6c 75 */. int iColu
17bb0 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 mn;
17bc0 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 /* Column number
17bd0 20 77 69 74 68 69 6e 20 74 68 65 20 73 6f 75 72 within the sour
17be0 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 ce table */.
17bf0 69 6e 74 20 69 53 6f 72 74 65 72 43 6f 6c 75 6d int iSorterColum
17c00 6e 3b 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 n; /* Colu
17c10 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 74 68 65 mn number in the
17c20 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 20 2a sorting index *
17c30 2f 0a 20 20 20 20 69 6e 74 20 69 4d 65 6d 3b 20 /. int iMem;
17c40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
17c50 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f * Memory locatio
17c60 6e 20 74 68 61 74 20 61 63 74 73 20 61 73 20 61 n that acts as a
17c70 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f 0a 20 20 ccumulator */.
17c80 20 20 45 78 70 72 20 2a 70 45 78 70 72 3b 20 20 Expr *pExpr;
17c90 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
17ca0 65 20 6f 72 69 67 69 6e 61 6c 20 65 78 70 72 65 e original expre
17cb0 73 73 69 6f 6e 20 2a 2f 0a 20 20 7d 20 2a 61 43 ssion */. } *aC
17cc0 6f 6c 3b 0a 20 20 69 6e 74 20 6e 43 6f 6c 75 6d ol;. int nColum
17cd0 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a n; /*
17ce0 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 65 64 20 Number of used
17cf0 65 6e 74 72 69 65 73 20 69 6e 20 61 43 6f 6c 5b entries in aCol[
17d00 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 63 63 75 ] */. int nAccu
17d10 6d 75 6c 61 74 6f 72 3b 20 20 20 20 20 20 20 2f mulator; /
17d20 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 * Number of colu
17d30 6d 6e 73 20 74 68 61 74 20 73 68 6f 77 20 74 68 mns that show th
17d40 72 6f 75 67 68 20 74 6f 20 74 68 65 20 6f 75 74 rough to the out
17d50 70 75 74 2e 0a 20 20 20 20 20 20 20 20 20 20 20 put..
17d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
17d70 2a 20 41 64 64 69 74 69 6f 6e 61 6c 20 63 6f 6c * Additional col
17d80 75 6d 6e 73 20 61 72 65 20 75 73 65 64 20 6f 6e umns are used on
17d90 6c 79 20 61 73 20 70 61 72 61 6d 65 74 65 72 73 ly as parameters
17da0 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 20 20 to.
17db0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a **
17dc0 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 aggregate funct
17dd0 69 6f 6e 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 ions */. struct
17de0 20 41 67 67 49 6e 66 6f 5f 66 75 6e 63 20 7b 20 AggInfo_func {
17df0 20 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 61 67 /* For each ag
17e00 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e gregate function
17e10 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 */. Expr *pE
17e20 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 xpr;
17e30 20 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 65 /* Expression e
17e40 6e 63 6f 64 69 6e 67 20 74 68 65 20 66 75 6e 63 ncoding the func
17e50 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 46 75 6e 63 tion */. Func
17e60 44 65 66 20 2a 70 46 75 6e 63 3b 20 20 20 20 20 Def *pFunc;
17e70 20 20 20 20 20 2f 2a 20 54 68 65 20 61 67 67 72 /* The aggr
17e80 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 20 69 egate function i
17e90 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f mplementation */
17ea0 0a 20 20 20 20 69 6e 74 20 69 4d 65 6d 3b 20 20 . int iMem;
17eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
17ec0 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e Memory location
17ed0 20 74 68 61 74 20 61 63 74 73 20 61 73 20 61 63 that acts as ac
17ee0 63 75 6d 75 6c 61 74 6f 72 20 2a 2f 0a 20 20 20 cumulator */.
17ef0 20 69 6e 74 20 69 44 69 73 74 69 6e 63 74 3b 20 int iDistinct;
17f00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 70 68 /* Eph
17f10 65 6d 65 72 61 6c 20 74 61 62 6c 65 20 75 73 65 emeral table use
17f20 64 20 74 6f 20 65 6e 66 6f 72 63 65 20 44 49 53 d to enforce DIS
17f30 54 49 4e 43 54 20 2a 2f 0a 20 20 7d 20 2a 61 46 TINCT */. } *aF
17f40 75 6e 63 3b 0a 20 20 69 6e 74 20 6e 46 75 6e 63 unc;. int nFunc
17f50 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
17f60 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 * Number of entr
17f70 69 65 73 20 69 6e 20 61 46 75 6e 63 5b 5d 20 2a ies in aFunc[] *
17f80 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 /.};../*.** The
17f90 64 61 74 61 74 79 70 65 20 79 6e 56 61 72 20 69 datatype ynVar i
17fa0 73 20 61 20 73 69 67 6e 65 64 20 69 6e 74 65 67 s a signed integ
17fb0 65 72 2c 20 65 69 74 68 65 72 20 31 36 2d 62 69 er, either 16-bi
17fc0 74 20 6f 72 20 33 32 2d 62 69 74 2e 0a 2a 2a 20 t or 32-bit..**
17fd0 55 73 75 61 6c 6c 79 20 69 74 20 69 73 20 31 36 Usually it is 16
17fe0 2d 62 69 74 73 2e 20 20 42 75 74 20 69 66 20 53 -bits. But if S
17ff0 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 QLITE_MAX_VARIAB
18000 4c 45 5f 4e 55 4d 42 45 52 20 69 73 20 67 72 65 LE_NUMBER is gre
18010 61 74 65 72 0a 2a 2a 20 74 68 61 6e 20 33 32 37 ater.** than 327
18020 36 37 20 77 65 20 68 61 76 65 20 74 6f 20 6d 61 67 we have to ma
18030 6b 65 20 69 74 20 33 32 2d 62 69 74 2e 20 20 31 ke it 32-bit. 1
18040 36 2d 62 69 74 20 69 73 20 70 72 65 66 65 72 72 6-bit is preferr
18050 65 64 20 62 65 63 61 75 73 65 0a 2a 2a 20 69 74 ed because.** it
18060 20 75 73 65 73 20 6c 65 73 73 20 6d 65 6d 6f 72 uses less memor
18070 79 20 69 6e 20 74 68 65 20 45 78 70 72 20 6f 62 y in the Expr ob
18080 6a 65 63 74 2c 20 77 68 69 63 68 20 69 73 20 61 ject, which is a
18090 20 62 69 67 20 6d 65 6d 6f 72 79 20 75 73 65 72 big memory user
180a0 0a 2a 2a 20 69 6e 20 73 79 73 74 65 6d 73 20 77 .** in systems w
180b0 69 74 68 20 6c 6f 74 73 20 6f 66 20 70 72 65 70 ith lots of prep
180c0 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 2e ared statements.
180d0 20 20 41 6e 64 20 66 65 77 20 61 70 70 6c 69 63 And few applic
180e0 61 74 69 6f 6e 73 0a 2a 2a 20 6e 65 65 64 20 6d ations.** need m
180f0 6f 72 65 20 74 68 61 6e 20 61 62 6f 75 74 20 31 ore than about 1
18100 30 20 6f 72 20 32 30 20 76 61 72 69 61 62 6c 65 0 or 20 variable
18110 73 2e 20 20 42 75 74 20 73 6f 6d 65 20 65 78 74 s. But some ext
18120 72 65 6d 65 20 75 73 65 72 73 20 77 61 6e 74 0a reme users want.
18130 2a 2a 20 74 6f 20 68 61 76 65 20 70 72 65 70 61 ** to have prepa
18140 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 20 77 red statements w
18150 69 74 68 20 6f 76 65 72 20 33 32 37 36 37 20 76 ith over 32767 v
18160 61 72 69 61 62 6c 65 73 2c 20 61 6e 64 20 66 6f ariables, and fo
18170 72 20 74 68 65 6d 0a 2a 2a 20 74 68 65 20 6f 70 r them.** the op
18180 74 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 62 6c tion is availabl
18190 65 20 28 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 e (at compile-ti
181a0 6d 65 29 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 me)..*/.#if SQLI
181b0 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f TE_MAX_VARIABLE_
181c0 4e 55 4d 42 45 52 3c 3d 33 32 37 36 37 0a 74 79 NUMBER<=32767.ty
181d0 70 65 64 65 66 20 69 31 36 20 79 6e 56 61 72 3b pedef i16 ynVar;
181e0 0a 23 65 6c 73 65 0a 74 79 70 65 64 65 66 20 69 .#else.typedef i
181f0 6e 74 20 79 6e 56 61 72 3b 0a 23 65 6e 64 69 66 nt ynVar;.#endif
18200 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 6e 6f 64 ../*.** Each nod
18210 65 20 6f 66 20 61 6e 20 65 78 70 72 65 73 73 69 e of an expressi
18220 6f 6e 20 69 6e 20 74 68 65 20 70 61 72 73 65 20 on in the parse
18230 74 72 65 65 20 69 73 20 61 6e 20 69 6e 73 74 61 tree is an insta
18240 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 69 73 20 73 nce.** of this s
18250 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 tructure..**.**
18260 45 78 70 72 2e 6f 70 20 69 73 20 74 68 65 20 6f Expr.op is the o
18270 70 63 6f 64 65 2e 20 54 68 65 20 69 6e 74 65 67 pcode. The integ
18280 65 72 20 70 61 72 73 65 72 20 74 6f 6b 65 6e 20 er parser token
18290 63 6f 64 65 73 20 61 72 65 20 72 65 75 73 65 64 codes are reused
182a0 0a 2a 2a 20 61 73 20 6f 70 63 6f 64 65 73 20 68 .** as opcodes h
182b0 65 72 65 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 ere. For example
182c0 2c 20 74 68 65 20 70 61 72 73 65 72 20 64 65 66 , the parser def
182d0 69 6e 65 73 20 54 4b 5f 47 45 20 74 6f 20 62 65 ines TK_GE to be
182e0 20 61 6e 20 69 6e 74 65 67 65 72 0a 2a 2a 20 63 an integer.** c
182f0 6f 64 65 20 72 65 70 72 65 73 65 6e 74 69 6e 67 ode representing
18300 20 74 68 65 20 22 3e 3d 22 20 6f 70 65 72 61 74 the ">=" operat
18310 6f 72 2e 20 54 68 69 73 20 73 61 6d 65 20 69 6e or. This same in
18320 74 65 67 65 72 20 63 6f 64 65 20 69 73 20 72 65 teger code is re
18330 75 73 65 64 0a 2a 2a 20 74 6f 20 72 65 70 72 65 used.** to repre
18340 73 65 6e 74 20 74 68 65 20 67 72 65 61 74 65 72 sent the greater
18350 2d 74 68 61 6e 2d 6f 72 2d 65 71 75 61 6c 2d 74 -than-or-equal-t
18360 6f 20 6f 70 65 72 61 74 6f 72 20 69 6e 20 74 68 o operator in th
18370 65 20 65 78 70 72 65 73 73 69 6f 6e 0a 2a 2a 20 e expression.**
18380 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 tree..**.** If t
18390 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 he expression is
183a0 20 61 6e 20 53 51 4c 20 6c 69 74 65 72 61 6c 20 an SQL literal
183b0 28 54 4b 5f 49 4e 54 45 47 45 52 2c 20 54 4b 5f (TK_INTEGER, TK_
183c0 46 4c 4f 41 54 2c 20 54 4b 5f 42 4c 4f 42 2c 0a FLOAT, TK_BLOB,.
183d0 2a 2a 20 6f 72 20 54 4b 5f 53 54 52 49 4e 47 29 ** or TK_STRING)
183e0 2c 20 74 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 , then Expr.toke
183f0 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 74 n contains the t
18400 65 78 74 20 6f 66 20 74 68 65 20 53 51 4c 20 6c ext of the SQL l
18410 69 74 65 72 61 6c 2e 20 49 66 0a 2a 2a 20 74 68 iteral. If.** th
18420 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 e expression is
18430 61 20 76 61 72 69 61 62 6c 65 20 28 54 4b 5f 56 a variable (TK_V
18440 41 52 49 41 42 4c 45 29 2c 20 74 68 65 6e 20 45 ARIABLE), then E
18450 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 xpr.token contai
18460 6e 73 20 74 68 65 0a 2a 2a 20 76 61 72 69 61 62 ns the.** variab
18470 6c 65 20 6e 61 6d 65 2e 20 46 69 6e 61 6c 6c 79 le name. Finally
18480 2c 20 69 66 20 74 68 65 20 65 78 70 72 65 73 73 , if the express
18490 69 6f 6e 20 69 73 20 61 6e 20 53 51 4c 20 66 75 ion is an SQL fu
184a0 6e 63 74 69 6f 6e 20 28 54 4b 5f 46 55 4e 43 54 nction (TK_FUNCT
184b0 49 4f 4e 29 2c 0a 2a 2a 20 74 68 65 6e 20 45 78 ION),.** then Ex
184c0 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e pr.token contain
184d0 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 s the name of th
184e0 65 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a e function..**.*
184f0 2a 20 45 78 70 72 2e 70 52 69 67 68 74 20 61 6e * Expr.pRight an
18500 64 20 45 78 70 72 2e 70 4c 65 66 74 20 61 72 65 d Expr.pLeft are
18510 20 74 68 65 20 6c 65 66 74 20 61 6e 64 20 72 69 the left and ri
18520 67 68 74 20 73 75 62 65 78 70 72 65 73 73 69 6f ght subexpressio
18530 6e 73 20 6f 66 20 61 0a 2a 2a 20 62 69 6e 61 72 ns of a.** binar
18540 79 20 6f 70 65 72 61 74 6f 72 2e 20 45 69 74 68 y operator. Eith
18550 65 72 20 6f 72 20 62 6f 74 68 20 6d 61 79 20 62 er or both may b
18560 65 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 45 78 e NULL..**.** Ex
18570 70 72 2e 78 2e 70 4c 69 73 74 20 69 73 20 61 20 pr.x.pList is a
18580 6c 69 73 74 20 6f 66 20 61 72 67 75 6d 65 6e 74 list of argument
18590 73 20 69 66 20 74 68 65 20 65 78 70 72 65 73 73 s if the express
185a0 69 6f 6e 20 69 73 20 61 6e 20 53 51 4c 20 66 75 ion is an SQL fu
185b0 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 61 20 43 41 53 nction,.** a CAS
185c0 45 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 72 20 E expression or
185d0 61 6e 20 49 4e 20 65 78 70 72 65 73 73 69 6f 6e an IN expression
185e0 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 22 3c 6c of the form "<l
185f0 68 73 3e 20 49 4e 20 28 3c 79 3e 2c 20 3c 7a 3e hs> IN (<y>, <z>
18600 2e 2e 2e 29 22 2e 0a 2a 2a 20 45 78 70 72 2e 78 ...)"..** Expr.x
18610 2e 70 53 65 6c 65 63 74 20 69 73 20 75 73 65 64 .pSelect is used
18620 20 69 66 20 74 68 65 20 65 78 70 72 65 73 73 69 if the expressi
18630 6f 6e 20 69 73 20 61 20 73 75 62 2d 73 65 6c 65 on is a sub-sele
18640 63 74 20 6f 72 20 61 6e 20 65 78 70 72 65 73 73 ct or an express
18650 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 65 20 66 6f ion of.** the fo
18660 72 6d 20 22 3c 6c 68 73 3e 20 49 4e 20 28 53 45 rm "<lhs> IN (SE
18670 4c 45 43 54 20 2e 2e 2e 29 22 2e 20 49 66 20 74 LECT ...)". If t
18680 68 65 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 he EP_xIsSelect
18690 62 69 74 20 69 73 20 73 65 74 20 69 6e 20 74 68 bit is set in th
186a0 65 0a 2a 2a 20 45 78 70 72 2e 66 6c 61 67 73 20 e.** Expr.flags
186b0 6d 61 73 6b 2c 20 74 68 65 6e 20 45 78 70 72 2e mask, then Expr.
186c0 78 2e 70 53 65 6c 65 63 74 20 69 73 20 76 61 6c x.pSelect is val
186d0 69 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 45 id. Otherwise, E
186e0 78 70 72 2e 78 2e 70 4c 69 73 74 20 69 73 0a 2a xpr.x.pList is.*
186f0 2a 20 76 61 6c 69 64 2e 0a 2a 2a 0a 2a 2a 20 41 * valid..**.** A
18700 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 66 20 n expression of
18710 74 68 65 20 66 6f 72 6d 20 49 44 20 6f 72 20 49 the form ID or I
18720 44 2e 49 44 20 72 65 66 65 72 73 20 74 6f 20 61 D.ID refers to a
18730 20 63 6f 6c 75 6d 6e 20 69 6e 20 61 20 74 61 62 column in a tab
18740 6c 65 2e 0a 2a 2a 20 46 6f 72 20 73 75 63 68 20 le..** For such
18750 65 78 70 72 65 73 73 69 6f 6e 73 2c 20 45 78 70 expressions, Exp
18760 72 2e 6f 70 20 69 73 20 73 65 74 20 74 6f 20 54 r.op is set to T
18770 4b 5f 43 4f 4c 55 4d 4e 20 61 6e 64 20 45 78 70 K_COLUMN and Exp
18780 72 2e 69 54 61 62 6c 65 20 69 73 0a 2a 2a 20 74 r.iTable is.** t
18790 68 65 20 69 6e 74 65 67 65 72 20 63 75 72 73 6f he integer curso
187a0 72 20 6e 75 6d 62 65 72 20 6f 66 20 61 20 56 44 r number of a VD
187b0 42 45 20 63 75 72 73 6f 72 20 70 6f 69 6e 74 69 BE cursor pointi
187c0 6e 67 20 74 6f 20 74 68 61 74 20 74 61 62 6c 65 ng to that table
187d0 20 61 6e 64 0a 2a 2a 20 45 78 70 72 2e 69 43 6f and.** Expr.iCo
187e0 6c 75 6d 6e 20 69 73 20 74 68 65 20 63 6f 6c 75 lumn is the colu
187f0 6d 6e 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 mn number for th
18800 65 20 73 70 65 63 69 66 69 63 20 63 6f 6c 75 6d e specific colum
18810 6e 2e 20 20 49 66 20 74 68 65 0a 2a 2a 20 65 78 n. If the.** ex
18820 70 72 65 73 73 69 6f 6e 20 69 73 20 75 73 65 64 pression is used
18830 20 61 73 20 61 20 72 65 73 75 6c 74 20 69 6e 20 as a result in
18840 61 6e 20 61 67 67 72 65 67 61 74 65 20 53 45 4c an aggregate SEL
18850 45 43 54 2c 20 74 68 65 6e 20 74 68 65 0a 2a 2a ECT, then the.**
18860 20 76 61 6c 75 65 20 69 73 20 61 6c 73 6f 20 73 value is also s
18870 74 6f 72 65 64 20 69 6e 20 74 68 65 20 45 78 70 tored in the Exp
18880 72 2e 69 41 67 67 20 63 6f 6c 75 6d 6e 20 69 6e r.iAgg column in
18890 20 74 68 65 20 61 67 67 72 65 67 61 74 65 20 73 the aggregate s
188a0 6f 20 74 68 61 74 0a 2a 2a 20 69 74 20 63 61 6e o that.** it can
188b0 20 62 65 20 61 63 63 65 73 73 65 64 20 61 66 74 be accessed aft
188c0 65 72 20 61 6c 6c 20 61 67 67 72 65 67 61 74 65 er all aggregate
188d0 73 20 61 72 65 20 63 6f 6d 70 75 74 65 64 2e 0a s are computed..
188e0 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 65 78 70 **.** If the exp
188f0 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 75 6e ression is an un
18900 62 6f 75 6e 64 20 76 61 72 69 61 62 6c 65 20 6d bound variable m
18910 61 72 6b 65 72 20 28 61 20 71 75 65 73 74 69 6f arker (a questio
18920 6e 20 6d 61 72 6b 0a 2a 2a 20 63 68 61 72 61 63 n mark.** charac
18930 74 65 72 20 27 3f 27 20 69 6e 20 74 68 65 20 6f ter '?' in the o
18940 72 69 67 69 6e 61 6c 20 53 51 4c 29 20 74 68 65 riginal SQL) the
18950 6e 20 74 68 65 20 45 78 70 72 2e 69 54 61 62 6c n the Expr.iTabl
18960 65 20 68 6f 6c 64 73 20 74 68 65 20 69 6e 64 65 e holds the inde
18970 78 0a 2a 2a 20 6e 75 6d 62 65 72 20 66 6f 72 20 x.** number for
18980 74 68 61 74 20 76 61 72 69 61 62 6c 65 2e 0a 2a that variable..*
18990 2a 0a 2a 2a 20 49 66 20 74 68 65 20 65 78 70 72 *.** If the expr
189a0 65 73 73 69 6f 6e 20 69 73 20 61 20 73 75 62 71 ession is a subq
189b0 75 65 72 79 20 74 68 65 6e 20 45 78 70 72 2e 69 uery then Expr.i
189c0 43 6f 6c 75 6d 6e 20 68 6f 6c 64 73 20 61 6e 20 Column holds an
189d0 69 6e 74 65 67 65 72 0a 2a 2a 20 72 65 67 69 73 integer.** regis
189e0 74 65 72 20 6e 75 6d 62 65 72 20 63 6f 6e 74 61 ter number conta
189f0 69 6e 69 6e 67 20 74 68 65 20 72 65 73 75 6c 74 ining the result
18a00 20 6f 66 20 74 68 65 20 73 75 62 71 75 65 72 79 of the subquery
18a10 2e 20 20 49 66 20 74 68 65 0a 2a 2a 20 73 75 62 . If the.** sub
18a20 71 75 65 72 79 20 67 69 76 65 73 20 61 20 63 6f query gives a co
18a30 6e 73 74 61 6e 74 20 72 65 73 75 6c 74 2c 20 74 nstant result, t
18a40 68 65 6e 20 69 54 61 62 6c 65 20 69 73 20 2d 31 hen iTable is -1
18a50 2e 20 20 49 66 20 74 68 65 20 73 75 62 71 75 65 . If the subque
18a60 72 79 0a 2a 2a 20 67 69 76 65 73 20 61 20 64 69 ry.** gives a di
18a70 66 66 65 72 65 6e 74 20 61 6e 73 77 65 72 20 61 fferent answer a
18a80 74 20 64 69 66 66 65 72 65 6e 74 20 74 69 6d 65 t different time
18a90 73 20 64 75 72 69 6e 67 20 73 74 61 74 65 6d 65 s during stateme
18aa0 6e 74 20 70 72 6f 63 65 73 73 69 6e 67 0a 2a 2a nt processing.**
18ab0 20 74 68 65 6e 20 69 54 61 62 6c 65 20 69 73 20 then iTable is
18ac0 74 68 65 20 61 64 64 72 65 73 73 20 6f 66 20 61 the address of a
18ad0 20 73 75 62 72 6f 75 74 69 6e 65 20 74 68 61 74 subroutine that
18ae0 20 63 6f 6d 70 75 74 65 73 20 74 68 65 20 73 75 computes the su
18af0 62 71 75 65 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 bquery..**.** If
18b00 20 74 68 65 20 45 78 70 72 20 69 73 20 6f 66 20 the Expr is of
18b10 74 79 70 65 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 type OP_Column,
18b20 61 6e 64 20 74 68 65 20 74 61 62 6c 65 20 69 74 and the table it
18b30 20 69 73 20 73 65 6c 65 63 74 69 6e 67 20 66 72 is selecting fr
18b40 6f 6d 0a 2a 2a 20 69 73 20 61 20 64 69 73 6b 20 om.** is a disk
18b50 74 61 62 6c 65 20 6f 72 20 74 68 65 20 22 6f 6c table or the "ol
18b60 64 2e 2a 22 20 70 73 65 75 64 6f 2d 74 61 62 6c d.*" pseudo-tabl
18b70 65 2c 20 74 68 65 6e 20 70 54 61 62 20 70 6f 69 e, then pTab poi
18b80 6e 74 73 20 74 6f 20 74 68 65 0a 2a 2a 20 63 6f nts to the.** co
18b90 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 61 62 6c rresponding tabl
18ba0 65 20 64 65 66 69 6e 69 74 69 6f 6e 2e 0a 2a 2a e definition..**
18bb0 0a 2a 2a 20 41 4c 4c 4f 43 41 54 49 4f 4e 20 4e .** ALLOCATION N
18bc0 4f 54 45 53 3a 0a 2a 2a 0a 2a 2a 20 45 78 70 72 OTES:.**.** Expr
18bd0 20 6f 62 6a 65 63 74 73 20 63 61 6e 20 75 73 65 objects can use
18be0 20 61 20 6c 6f 74 20 6f 66 20 6d 65 6d 6f 72 79 a lot of memory
18bf0 20 73 70 61 63 65 20 69 6e 20 64 61 74 61 62 61 space in databa
18c00 73 65 20 73 63 68 65 6d 61 2e 20 20 54 6f 0a 2a se schema. To.*
18c10 2a 20 68 65 6c 70 20 72 65 64 75 63 65 20 6d 65 * help reduce me
18c20 6d 6f 72 79 20 72 65 71 75 69 72 65 6d 65 6e 74 mory requirement
18c30 73 2c 20 73 6f 6d 65 74 69 6d 65 73 20 61 6e 20 s, sometimes an
18c40 45 78 70 72 20 6f 62 6a 65 63 74 20 77 69 6c 6c Expr object will
18c50 20 62 65 0a 2a 2a 20 74 72 75 6e 63 61 74 65 64 be.** truncated
18c60 2e 20 20 41 6e 64 20 74 6f 20 72 65 64 75 63 65 . And to reduce
18c70 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6d the number of m
18c80 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
18c90 73 2c 20 73 6f 6d 65 74 69 6d 65 73 0a 2a 2a 20 s, sometimes.**
18ca0 74 77 6f 20 6f 72 20 6d 6f 72 65 20 45 78 70 72 two or more Expr
18cb0 20 6f 62 6a 65 63 74 73 20 77 69 6c 6c 20 62 65 objects will be
18cc0 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73 69 6e stored in a sin
18cd0 67 6c 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 gle memory alloc
18ce0 61 74 69 6f 6e 2c 0a 2a 2a 20 74 6f 67 65 74 68 ation,.** togeth
18cf0 65 72 20 77 69 74 68 20 45 78 70 72 2e 7a 54 6f er with Expr.zTo
18d00 6b 65 6e 20 73 74 72 69 6e 67 73 2e 0a 2a 2a 0a ken strings..**.
18d10 2a 2a 20 49 66 20 74 68 65 20 45 50 5f 52 65 64 ** If the EP_Red
18d20 75 63 65 64 20 61 6e 64 20 45 50 5f 54 6f 6b 65 uced and EP_Toke
18d30 6e 4f 6e 6c 79 20 66 6c 61 67 73 20 61 72 65 20 nOnly flags are
18d40 73 65 74 20 77 68 65 6e 0a 2a 2a 20 61 6e 20 45 set when.** an E
18d50 78 70 72 20 6f 62 6a 65 63 74 20 69 73 20 74 72 xpr object is tr
18d60 75 6e 63 61 74 65 64 2e 20 20 57 68 65 6e 20 45 uncated. When E
18d70 50 5f 52 65 64 75 63 65 64 20 69 73 20 73 65 74 P_Reduced is set
18d80 2c 20 74 68 65 6e 20 61 6c 6c 0a 2a 2a 20 74 68 , then all.** th
18d90 65 20 63 68 69 6c 64 20 45 78 70 72 20 6f 62 6a e child Expr obj
18da0 65 63 74 73 20 69 6e 20 74 68 65 20 45 78 70 72 ects in the Expr
18db0 2e 70 4c 65 66 74 20 61 6e 64 20 45 78 70 72 2e .pLeft and Expr.
18dc0 70 52 69 67 68 74 20 73 75 62 74 72 65 65 73 0a pRight subtrees.
18dd0 2a 2a 20 61 72 65 20 63 6f 6e 74 61 69 6e 65 64 ** are contained
18de0 20 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65 within the same
18df0 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
18e00 6f 6e 2e 20 20 4e 6f 74 65 2c 20 68 6f 77 65 76 on. Note, howev
18e10 65 72 2c 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 er, that.** the
18e20 73 75 62 74 72 65 65 73 20 69 6e 20 45 78 70 72 subtrees in Expr
18e30 2e 78 2e 70 4c 69 73 74 20 6f 72 20 45 78 70 72 .x.pList or Expr
18e40 2e 78 2e 70 53 65 6c 65 63 74 20 61 72 65 20 61 .x.pSelect are a
18e50 6c 77 61 79 73 20 73 65 70 61 72 61 74 65 6c 79 lways separately
18e60 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 64 2c 20 72 .** allocated, r
18e70 65 67 61 72 64 6c 65 73 73 20 6f 66 20 77 68 65 egardless of whe
18e80 74 68 65 72 20 6f 72 20 6e 6f 74 20 45 50 5f 52 ther or not EP_R
18e90 65 64 75 63 65 64 20 69 73 20 73 65 74 2e 0a 2a educed is set..*
18ea0 2f 0a 73 74 72 75 63 74 20 45 78 70 72 20 7b 0a /.struct Expr {.
18eb0 20 20 75 38 20 6f 70 3b 20 20 20 20 20 20 20 20 u8 op;
18ec0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 65 72 /* Oper
18ed0 61 74 69 6f 6e 20 70 65 72 66 6f 72 6d 65 64 20 ation performed
18ee0 62 79 20 74 68 69 73 20 6e 6f 64 65 20 2a 2f 0a by this node */.
18ef0 20 20 63 68 61 72 20 61 66 66 69 6e 69 74 79 3b char affinity;
18f00 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
18f10 61 66 66 69 6e 69 74 79 20 6f 66 20 74 68 65 20 affinity of the
18f20 63 6f 6c 75 6d 6e 20 6f 72 20 30 20 69 66 20 6e column or 0 if n
18f30 6f 74 20 61 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 ot a column */.
18f40 20 75 33 32 20 66 6c 61 67 73 3b 20 20 20 20 20 u32 flags;
18f50 20 20 20 20 20 20 20 20 2f 2a 20 56 61 72 69 6f /* Vario
18f60 75 73 20 66 6c 61 67 73 2e 20 20 45 50 5f 2a 20 us flags. EP_*
18f70 53 65 65 20 62 65 6c 6f 77 20 2a 2f 0a 20 20 75 See below */. u
18f80 6e 69 6f 6e 20 7b 0a 20 20 20 20 63 68 61 72 20 nion {. char
18f90 2a 7a 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 20 *zToken;
18fa0 20 20 2f 2a 20 54 6f 6b 65 6e 20 76 61 6c 75 65 /* Token value
18fb0 2e 20 5a 65 72 6f 20 74 65 72 6d 69 6e 61 74 65 . Zero terminate
18fc0 64 20 61 6e 64 20 64 65 71 75 6f 74 65 64 20 2a d and dequoted *
18fd0 2f 0a 20 20 20 20 69 6e 74 20 69 56 61 6c 75 65 /. int iValue
18fe0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
18ff0 4e 6f 6e 2d 6e 65 67 61 74 69 76 65 20 69 6e 74 Non-negative int
19000 65 67 65 72 20 76 61 6c 75 65 20 69 66 20 45 50 eger value if EP
19010 5f 49 6e 74 56 61 6c 75 65 20 2a 2f 0a 20 20 7d _IntValue */. }
19020 20 75 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 u;.. /* If the
19030 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c EP_TokenOnly fl
19040 61 67 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 ag is set in the
19050 20 45 78 70 72 2e 66 6c 61 67 73 20 6d 61 73 6b Expr.flags mask
19060 2c 20 74 68 65 6e 20 6e 6f 0a 20 20 2a 2a 20 73 , then no. ** s
19070 70 61 63 65 20 69 73 20 61 6c 6c 6f 63 61 74 65 pace is allocate
19080 64 20 66 6f 72 20 74 68 65 20 66 69 65 6c 64 73 d for the fields
19090 20 62 65 6c 6f 77 20 74 68 69 73 20 70 6f 69 6e below this poin
190a0 74 2e 20 41 6e 20 61 74 74 65 6d 70 74 20 74 6f t. An attempt to
190b0 0a 20 20 2a 2a 20 61 63 63 65 73 73 20 74 68 65 . ** access the
190c0 6d 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e m will result in
190d0 20 61 20 73 65 67 66 61 75 6c 74 20 6f 72 20 6d a segfault or m
190e0 61 6c 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a alfunction.. **
190f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19100 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19110 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19120 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19130 2a 2a 2a 2f 0a 0a 20 20 45 78 70 72 20 2a 70 4c ***/.. Expr *pL
19140 65 66 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f eft; /
19150 2a 20 4c 65 66 74 20 73 75 62 6e 6f 64 65 20 2a * Left subnode *
19160 2f 0a 20 20 45 78 70 72 20 2a 70 52 69 67 68 74 /. Expr *pRight
19170 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 69 ; /* Ri
19180 67 68 74 20 73 75 62 6e 6f 64 65 20 2a 2f 0a 20 ght subnode */.
19190 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 45 78 70 union {. Exp
191a0 72 4c 69 73 74 20 2a 70 4c 69 73 74 3b 20 20 20 rList *pList;
191b0 20 20 2f 2a 20 6f 70 20 3d 20 49 4e 2c 20 45 58 /* op = IN, EX
191c0 49 53 54 53 2c 20 53 45 4c 45 43 54 2c 20 43 41 ISTS, SELECT, CA
191d0 53 45 2c 20 46 55 4e 43 54 49 4f 4e 2c 20 42 45 SE, FUNCTION, BE
191e0 54 57 45 45 4e 20 2a 2f 0a 20 20 20 20 53 65 6c TWEEN */. Sel
191f0 65 63 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 ect *pSelect;
19200 20 20 2f 2a 20 45 50 5f 78 49 73 53 65 6c 65 63 /* EP_xIsSelec
19210 74 20 61 6e 64 20 6f 70 20 3d 20 49 4e 2c 20 45 t and op = IN, E
19220 58 49 53 54 53 2c 20 53 45 4c 45 43 54 20 2a 2f XISTS, SELECT */
19230 0a 20 20 7d 20 78 3b 0a 0a 20 20 2f 2a 20 49 66 . } x;.. /* If
19240 20 74 68 65 20 45 50 5f 52 65 64 75 63 65 64 20 the EP_Reduced
19250 66 6c 61 67 20 69 73 20 73 65 74 20 69 6e 20 74 flag is set in t
19260 68 65 20 45 78 70 72 2e 66 6c 61 67 73 20 6d 61 he Expr.flags ma
19270 73 6b 2c 20 74 68 65 6e 20 6e 6f 0a 20 20 2a 2a sk, then no. **
19280 20 73 70 61 63 65 20 69 73 20 61 6c 6c 6f 63 61 space is alloca
19290 74 65 64 20 66 6f 72 20 74 68 65 20 66 69 65 6c ted for the fiel
192a0 64 73 20 62 65 6c 6f 77 20 74 68 69 73 20 70 6f ds below this po
192b0 69 6e 74 2e 20 41 6e 20 61 74 74 65 6d 70 74 20 int. An attempt
192c0 74 6f 0a 20 20 2a 2a 20 61 63 63 65 73 73 20 74 to. ** access t
192d0 68 65 6d 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 hem will result
192e0 69 6e 20 61 20 73 65 67 66 61 75 6c 74 20 6f 72 in a segfault or
192f0 20 6d 61 6c 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 malfunction..
19300 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19310 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19320 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19330 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
19340 2a 2a 2a 2a 2a 2f 0a 0a 23 69 66 20 53 51 4c 49 *****/..#if SQLI
19350 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 TE_MAX_EXPR_DEPT
19360 48 3e 30 0a 20 20 69 6e 74 20 6e 48 65 69 67 68 H>0. int nHeigh
19370 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
19380 48 65 69 67 68 74 20 6f 66 20 74 68 65 20 74 72 Height of the tr
19390 65 65 20 68 65 61 64 65 64 20 62 79 20 74 68 69 ee headed by thi
193a0 73 20 6e 6f 64 65 20 2a 2f 0a 23 65 6e 64 69 66 s node */.#endif
193b0 0a 20 20 69 6e 74 20 69 54 61 62 6c 65 3b 20 20 . int iTable;
193c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 4b 5f /* TK_
193d0 43 4f 4c 55 4d 4e 3a 20 63 75 72 73 6f 72 20 6e COLUMN: cursor n
193e0 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 20 68 umber of table h
193f0 6f 6c 64 69 6e 67 20 63 6f 6c 75 6d 6e 0a 20 20 olding column.
19400 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19410 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f 52 45 47 ** TK_REG
19420 49 53 54 45 52 3a 20 72 65 67 69 73 74 65 72 20 ISTER: register
19430 6e 75 6d 62 65 72 0a 20 20 20 20 20 20 20 20 20 number.
19440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19450 2a 2a 20 54 4b 5f 54 52 49 47 47 45 52 3a 20 31 ** TK_TRIGGER: 1
19460 20 2d 3e 20 6e 65 77 2c 20 30 20 2d 3e 20 6f 6c -> new, 0 -> ol
19470 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d.
19480 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 45 50 ** EP
19490 5f 55 6e 6c 69 6b 65 6c 79 3a 20 20 31 33 34 32 _Unlikely: 1342
194a0 31 37 37 32 38 20 74 69 6d 65 73 20 6c 69 6b 65 17728 times like
194b0 6c 69 68 6f 6f 64 0a 20 20 20 20 20 20 20 20 20 lihood.
194c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
194d0 2a 2a 20 54 4b 5f 53 45 4c 45 43 54 3a 20 31 73 ** TK_SELECT: 1s
194e0 74 20 72 65 67 69 73 74 65 72 20 6f 66 20 72 65 t register of re
194f0 73 75 6c 74 20 76 65 63 74 6f 72 20 2a 2f 0a 20 sult vector */.
19500 20 79 6e 56 61 72 20 69 43 6f 6c 75 6d 6e 3b 20 ynVar iColumn;
19510 20 20 20 20 20 20 20 20 2f 2a 20 54 4b 5f 43 4f /* TK_CO
19520 4c 55 4d 4e 3a 20 63 6f 6c 75 6d 6e 20 69 6e 64 LUMN: column ind
19530 65 78 2e 20 20 2d 31 20 66 6f 72 20 72 6f 77 69 ex. -1 for rowi
19540 64 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 d..
19550 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 ** T
19560 4b 5f 56 41 52 49 41 42 4c 45 3a 20 76 61 72 69 K_VARIABLE: vari
19570 61 62 6c 65 20 6e 75 6d 62 65 72 20 28 61 6c 77 able number (alw
19580 61 79 73 20 3e 3d 20 31 29 2e 0a 20 20 20 20 20 ays >= 1)..
19590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
195a0 20 20 20 20 2a 2a 20 54 4b 5f 53 45 4c 45 43 54 ** TK_SELECT
195b0 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c 75 6d 6e 20 _COLUMN: column
195c0 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 76 65 of the result ve
195d0 63 74 6f 72 20 2a 2f 0a 20 20 69 31 36 20 69 41 ctor */. i16 iA
195e0 67 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 gg;
195f0 20 2f 2a 20 57 68 69 63 68 20 65 6e 74 72 79 20 /* Which entry
19600 69 6e 20 70 41 67 67 49 6e 66 6f 2d 3e 61 43 6f in pAggInfo->aCo
19610 6c 5b 5d 20 6f 72 20 2d 3e 61 46 75 6e 63 5b 5d l[] or ->aFunc[]
19620 20 2a 2f 0a 20 20 69 31 36 20 69 52 69 67 68 74 */. i16 iRight
19630 4a 6f 69 6e 54 61 62 6c 65 3b 20 20 20 2f 2a 20 JoinTable; /*
19640 49 66 20 45 50 5f 46 72 6f 6d 4a 6f 69 6e 2c 20 If EP_FromJoin,
19650 74 68 65 20 72 69 67 68 74 20 74 61 62 6c 65 20 the right table
19660 6f 66 20 74 68 65 20 6a 6f 69 6e 20 2a 2f 0a 20 of the join */.
19670 20 75 38 20 6f 70 32 3b 20 20 20 20 20 20 20 20 u8 op2;
19680 20 20 20 20 20 20 20 20 2f 2a 20 54 4b 5f 52 45 /* TK_RE
19690 47 49 53 54 45 52 3a 20 6f 72 69 67 69 6e 61 6c GISTER: original
196a0 20 76 61 6c 75 65 20 6f 66 20 45 78 70 72 2e 6f value of Expr.o
196b0 70 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p.
196c0 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b ** TK
196d0 5f 43 4f 4c 55 4d 4e 3a 20 74 68 65 20 76 61 6c _COLUMN: the val
196e0 75 65 20 6f 66 20 70 35 20 66 6f 72 20 4f 50 5f ue of p5 for OP_
196f0 43 6f 6c 75 6d 6e 0a 20 20 20 20 20 20 20 20 20 Column.
19700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19710 2a 2a 20 54 4b 5f 41 47 47 5f 46 55 4e 43 54 49 ** TK_AGG_FUNCTI
19720 4f 4e 3a 20 6e 65 73 74 69 6e 67 20 64 65 70 74 ON: nesting dept
19730 68 20 2a 2f 0a 20 20 41 67 67 49 6e 66 6f 20 2a h */. AggInfo *
19740 70 41 67 67 49 6e 66 6f 3b 20 20 20 20 20 2f 2a pAggInfo; /*
19750 20 55 73 65 64 20 62 79 20 54 4b 5f 41 47 47 5f Used by TK_AGG_
19760 43 4f 4c 55 4d 4e 20 61 6e 64 20 54 4b 5f 41 47 COLUMN and TK_AG
19770 47 5f 46 55 4e 43 54 49 4f 4e 20 2a 2f 0a 20 20 G_FUNCTION */.
19780 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 54 61 62 6c union {. Tabl
19790 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 20 20 e *pTab;
197a0 20 20 20 2f 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a /* TK_COLUMN:
197b0 20 54 61 62 6c 65 20 63 6f 6e 74 61 69 6e 69 6e Table containin
197c0 67 20 63 6f 6c 75 6d 6e 2e 20 43 61 6e 20 62 65 g column. Can be
197d0 20 4e 55 4c 4c 0a 20 20 20 20 20 20 20 20 20 20 NULL.
197e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
197f0 20 2a 2a 20 66 6f 72 20 61 20 63 6f 6c 75 6d 6e ** for a column
19800 20 6f 66 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 of an index on
19810 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f an expression */
19820 0a 20 20 20 20 57 69 6e 64 6f 77 20 2a 70 57 69 . Window *pWi
19830 6e 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 n; /* T
19840 4b 5f 46 55 4e 43 54 49 4f 4e 3a 20 57 69 6e 64 K_FUNCTION: Wind
19850 6f 77 20 64 65 66 69 6e 69 74 69 6f 6e 20 66 6f ow definition fo
19860 72 20 74 68 65 20 66 75 6e 63 20 2a 2f 0a 20 20 r the func */.
19870 20 20 73 74 72 75 63 74 20 7b 20 20 20 20 20 20 struct {
19880 20 20 20 20 20 20 20 20 20 2f 2a 20 54 4b 5f 49 /* TK_I
19890 4e 2c 20 54 4b 5f 53 45 4c 45 43 54 2c 20 61 6e N, TK_SELECT, an
198a0 64 20 54 4b 5f 45 58 49 53 54 53 20 2a 2f 0a 20 d TK_EXISTS */.
198b0 20 20 20 20 20 69 6e 74 20 69 41 64 64 72 3b 20 int iAddr;
198c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
198d0 75 62 72 6f 75 74 69 6e 65 20 65 6e 74 72 79 20 ubroutine entry
198e0 61 64 64 72 65 73 73 20 2a 2f 0a 20 20 20 20 20 address */.
198f0 20 69 6e 74 20 72 65 67 52 65 74 75 72 6e 3b 20 int regReturn;
19900 20 20 20 20 20 20 20 20 2f 2a 20 52 65 67 69 73 /* Regis
19910 74 65 72 20 75 73 65 64 20 74 6f 20 68 6f 6c 64 ter used to hold
19920 20 72 65 74 75 72 6e 20 61 64 64 72 65 73 73 20 return address
19930 2a 2f 0a 20 20 20 20 7d 20 73 75 62 3b 0a 20 20 */. } sub;.
19940 7d 20 79 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 } y;.};../*.** T
19950 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 he following are
19960 20 74 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 the meanings of
19970 20 62 69 74 73 20 69 6e 20 74 68 65 20 45 78 70 bits in the Exp
19980 72 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a r.flags field..*
19990 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 46 72 6f /.#define EP_Fro
199a0 6d 4a 6f 69 6e 20 20 30 78 30 30 30 30 30 31 20 mJoin 0x000001
199b0 2f 2a 20 4f 72 69 67 69 6e 61 74 65 73 20 69 6e /* Originates in
199c0 20 4f 4e 2f 55 53 49 4e 47 20 63 6c 61 75 73 65 ON/USING clause
199d0 20 6f 66 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a of outer join *
199e0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 67 67 /.#define EP_Agg
199f0 20 20 20 20 20 20 20 30 78 30 30 30 30 30 32 20 0x000002
19a00 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 /* Contains one
19a10 6f 72 20 6d 6f 72 65 20 61 67 67 72 65 67 61 74 or more aggregat
19a20 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 e functions */.#
19a30 64 65 66 69 6e 65 20 45 50 5f 48 61 73 46 75 6e define EP_HasFun
19a40 63 20 20 20 30 78 30 30 30 30 30 34 20 2f 2a 20 c 0x000004 /*
19a50 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 Contains one or
19a60 6d 6f 72 65 20 66 75 6e 63 74 69 6f 6e 73 20 6f more functions o
19a70 66 20 61 6e 79 20 6b 69 6e 64 20 2a 2f 0a 23 64 f any kind */.#d
19a80 65 66 69 6e 65 20 45 50 5f 46 69 78 65 64 43 6f efine EP_FixedCo
19a90 6c 20 20 30 78 30 30 30 30 30 38 20 2f 2a 20 54 l 0x000008 /* T
19aa0 4b 5f 43 6f 6c 75 6d 6e 20 77 69 74 68 20 61 20 K_Column with a
19ab0 6b 6e 6f 77 6e 20 66 69 78 65 64 20 76 61 6c 75 known fixed valu
19ac0 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f e */.#define EP_
19ad0 44 69 73 74 69 6e 63 74 20 20 30 78 30 30 30 30 Distinct 0x0000
19ae0 31 30 20 2f 2a 20 41 67 67 72 65 67 61 74 65 20 10 /* Aggregate
19af0 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 44 49 function with DI
19b00 53 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 20 2a STINCT keyword *
19b10 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 56 61 72 /.#define EP_Var
19b20 53 65 6c 65 63 74 20 30 78 30 30 30 30 32 30 20 Select 0x000020
19b30 2f 2a 20 70 53 65 6c 65 63 74 20 69 73 20 63 6f /* pSelect is co
19b40 72 72 65 6c 61 74 65 64 2c 20 6e 6f 74 20 63 6f rrelated, not co
19b50 6e 73 74 61 6e 74 20 2a 2f 0a 23 64 65 66 69 6e nstant */.#defin
19b60 65 20 45 50 5f 44 62 6c 51 75 6f 74 65 64 20 30 e EP_DblQuoted 0
19b70 78 30 30 30 30 34 30 20 2f 2a 20 74 6f 6b 65 6e x000040 /* token
19b80 2e 7a 20 77 61 73 20 6f 72 69 67 69 6e 61 6c 6c .z was originall
19b90 79 20 69 6e 20 22 2e 2e 2e 22 20 2a 2f 0a 23 64 y in "..." */.#d
19ba0 65 66 69 6e 65 20 45 50 5f 49 6e 66 69 78 46 75 efine EP_InfixFu
19bb0 6e 63 20 30 78 30 30 30 30 38 30 20 2f 2a 20 54 nc 0x000080 /* T
19bc0 72 75 65 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 rue for an infix
19bd0 20 66 75 6e 63 74 69 6f 6e 3a 20 4c 49 4b 45 2c function: LIKE,
19be0 20 47 4c 4f 42 2c 20 65 74 63 20 2a 2f 0a 23 64 GLOB, etc */.#d
19bf0 65 66 69 6e 65 20 45 50 5f 43 6f 6c 6c 61 74 65 efine EP_Collate
19c00 20 20 20 30 78 30 30 30 31 30 30 20 2f 2a 20 54 0x000100 /* T
19c10 72 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 ree contains a T
19c20 4b 5f 43 4f 4c 4c 41 54 45 20 6f 70 65 72 61 74 K_COLLATE operat
19c30 6f 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 or */.#define EP
19c40 5f 47 65 6e 65 72 69 63 20 20 20 30 78 30 30 30 _Generic 0x000
19c50 32 30 30 20 2f 2a 20 49 67 6e 6f 72 65 20 43 4f 200 /* Ignore CO
19c60 4c 4c 41 54 45 20 6f 72 20 61 66 66 69 6e 69 74 LLATE or affinit
19c70 79 20 6f 6e 20 74 68 69 73 20 74 72 65 65 20 2a y on this tree *
19c80 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 49 6e 74 /.#define EP_Int
19c90 56 61 6c 75 65 20 20 30 78 30 30 30 34 30 30 20 Value 0x000400
19ca0 2f 2a 20 49 6e 74 65 67 65 72 20 76 61 6c 75 65 /* Integer value
19cb0 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 75 2e contained in u.
19cc0 69 56 61 6c 75 65 20 2a 2f 0a 23 64 65 66 69 6e iValue */.#defin
19cd0 65 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 30 e EP_xIsSelect 0
19ce0 78 30 30 30 38 30 30 20 2f 2a 20 78 2e 70 53 65 x000800 /* x.pSe
19cf0 6c 65 63 74 20 69 73 20 76 61 6c 69 64 20 28 6f lect is valid (o
19d00 74 68 65 72 77 69 73 65 20 78 2e 70 4c 69 73 74 therwise x.pList
19d10 20 69 73 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 is) */.#define
19d20 45 50 5f 53 6b 69 70 20 20 20 20 20 20 30 78 30 EP_Skip 0x0
19d30 30 31 30 30 30 20 2f 2a 20 43 4f 4c 4c 41 54 45 01000 /* COLLATE
19d40 2c 20 41 53 2c 20 6f 72 20 55 4e 4c 49 4b 45 4c , AS, or UNLIKEL
19d50 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f Y */.#define EP_
19d60 52 65 64 75 63 65 64 20 20 20 30 78 30 30 32 30 Reduced 0x0020
19d70 30 30 20 2f 2a 20 45 78 70 72 20 73 74 72 75 63 00 /* Expr struc
19d80 74 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 49 t EXPR_REDUCEDSI
19d90 5a 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f ZE bytes only */
19da0 0a 23 64 65 66 69 6e 65 20 45 50 5f 54 6f 6b 65 .#define EP_Toke
19db0 6e 4f 6e 6c 79 20 30 78 30 30 34 30 30 30 20 2f nOnly 0x004000 /
19dc0 2a 20 45 78 70 72 20 73 74 72 75 63 74 20 45 58 * Expr struct EX
19dd0 50 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a 45 PR_TOKENONLYSIZE
19de0 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a 23 bytes only */.#
19df0 64 65 66 69 6e 65 20 45 50 5f 53 74 61 74 69 63 define EP_Static
19e00 20 20 20 20 30 78 30 30 38 30 30 30 20 2f 2a 20 0x008000 /*
19e10 48 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 6e Held in memory n
19e20 6f 74 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d ot obtained from
19e30 20 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 23 64 65 malloc() */.#de
19e40 66 69 6e 65 20 45 50 5f 4d 65 6d 54 6f 6b 65 6e fine EP_MemToken
19e50 20 20 30 78 30 31 30 30 30 30 20 2f 2a 20 4e 65 0x010000 /* Ne
19e60 65 64 20 74 6f 20 73 71 6c 69 74 65 33 44 62 46 ed to sqlite3DbF
19e70 72 65 65 28 29 20 45 78 70 72 2e 7a 54 6f 6b 65 ree() Expr.zToke
19e80 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f n */.#define EP_
19e90 4e 6f 52 65 64 75 63 65 20 20 30 78 30 32 30 30 NoReduce 0x0200
19ea0 30 30 20 2f 2a 20 43 61 6e 6e 6f 74 20 45 58 50 00 /* Cannot EXP
19eb0 52 44 55 50 5f 52 45 44 55 43 45 20 74 68 69 73 RDUP_REDUCE this
19ec0 20 45 78 70 72 20 2a 2f 0a 23 64 65 66 69 6e 65 Expr */.#define
19ed0 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 20 20 30 78 EP_Unlikely 0x
19ee0 30 34 30 30 30 30 20 2f 2a 20 75 6e 6c 69 6b 65 040000 /* unlike
19ef0 6c 79 28 29 20 6f 72 20 6c 69 6b 65 6c 69 68 6f ly() or likeliho
19f00 6f 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f od() function */
19f10 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 6f 6e 73 .#define EP_Cons
19f20 74 46 75 6e 63 20 30 78 30 38 30 30 30 30 20 2f tFunc 0x080000 /
19f30 2a 20 41 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f * A SQLITE_FUNC_
19f40 43 4f 4e 53 54 41 4e 54 20 6f 72 20 5f 53 4c 4f CONSTANT or _SLO
19f50 43 48 4e 47 20 66 75 6e 63 74 69 6f 6e 20 2a 2f CHNG function */
19f60 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 61 6e 42 .#define EP_CanB
19f70 65 4e 75 6c 6c 20 30 78 31 30 30 30 30 30 20 2f eNull 0x100000 /
19f80 2a 20 43 61 6e 20 62 65 20 6e 75 6c 6c 20 64 65 * Can be null de
19f90 73 70 69 74 65 20 4e 4f 54 20 4e 55 4c 4c 20 63 spite NOT NULL c
19fa0 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 64 65 onstraint */.#de
19fb0 66 69 6e 65 20 45 50 5f 53 75 62 71 75 65 72 79 fine EP_Subquery
19fc0 20 20 30 78 32 30 30 30 30 30 20 2f 2a 20 54 72 0x200000 /* Tr
19fd0 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 4b ee contains a TK
19fe0 5f 53 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72 _SELECT operator
19ff0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 */.#define EP_A
1a000 6c 69 61 73 20 20 20 20 20 30 78 34 30 30 30 30 lias 0x40000
1a010 30 20 2f 2a 20 49 73 20 61 6e 20 61 6c 69 61 73 0 /* Is an alias
1a020 20 66 6f 72 20 61 20 72 65 73 75 6c 74 20 73 65 for a result se
1a030 74 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 65 66 t column */.#def
1a040 69 6e 65 20 45 50 5f 4c 65 61 66 20 20 20 20 20 ine EP_Leaf
1a050 20 30 78 38 30 30 30 30 30 20 2f 2a 20 45 78 70 0x800000 /* Exp
1a060 72 2e 70 4c 65 66 74 2c 20 2e 70 52 69 67 68 74 r.pLeft, .pRight
1a070 2c 20 2e 75 2e 70 53 65 6c 65 63 74 20 61 6c 6c , .u.pSelect all
1a080 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 69 6e 65 NULL */.#define
1a090 20 45 50 5f 57 69 6e 46 75 6e 63 20 20 30 78 31 EP_WinFunc 0x1
1a0a0 30 30 30 30 30 30 20 2f 2a 20 54 4b 5f 46 55 4e 000000 /* TK_FUN
1a0b0 43 54 49 4f 4e 20 77 69 74 68 20 45 78 70 72 2e CTION with Expr.
1a0c0 79 2e 70 57 69 6e 20 73 65 74 20 2a 2f 0a 23 64 y.pWin set */.#d
1a0d0 65 66 69 6e 65 20 45 50 5f 53 75 62 72 74 6e 20 efine EP_Subrtn
1a0e0 20 20 30 78 32 30 30 30 30 30 30 20 2f 2a 20 55 0x2000000 /* U
1a0f0 73 65 73 20 45 78 70 72 2e 79 2e 73 75 62 2e 20 ses Expr.y.sub.
1a100 54 4b 5f 49 4e 2c 20 5f 53 45 4c 45 43 54 2c 20 TK_IN, _SELECT,
1a110 6f 72 20 5f 45 58 49 53 54 53 20 2a 2f 0a 0a 2f or _EXISTS */../
1a120 2a 0a 2a 2a 20 54 68 65 20 45 50 5f 50 72 6f 70 *.** The EP_Prop
1a130 61 67 61 74 65 20 6d 61 73 6b 20 69 73 20 61 20 agate mask is a
1a140 73 65 74 20 6f 66 20 70 72 6f 70 65 72 74 69 65 set of propertie
1a150 73 20 74 68 61 74 20 61 75 74 6f 6d 61 74 69 63 s that automatic
1a160 61 6c 6c 79 20 70 72 6f 70 61 67 61 74 65 0a 2a ally propagate.*
1a170 2a 20 75 70 77 61 72 64 73 20 69 6e 74 6f 20 70 * upwards into p
1a180 61 72 65 6e 74 20 6e 6f 64 65 73 2e 0a 2a 2f 0a arent nodes..*/.
1a190 23 64 65 66 69 6e 65 20 45 50 5f 50 72 6f 70 61 #define EP_Propa
1a1a0 67 61 74 65 20 28 45 50 5f 43 6f 6c 6c 61 74 65 gate (EP_Collate
1a1b0 7c 45 50 5f 53 75 62 71 75 65 72 79 7c 45 50 5f |EP_Subquery|EP_
1a1c0 48 61 73 46 75 6e 63 29 0a 0a 2f 2a 0a 2a 2a 20 HasFunc)../*.**
1a1d0 54 68 65 73 65 20 6d 61 63 72 6f 73 20 63 61 6e These macros can
1a1e0 20 62 65 20 75 73 65 64 20 74 6f 20 74 65 73 74 be used to test
1a1f0 2c 20 73 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 , set, or clear
1a200 62 69 74 73 20 69 6e 20 74 68 65 0a 2a 2a 20 45 bits in the.** E
1a210 78 70 72 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e xpr.flags field.
1a220 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 78 70 72 .*/.#define Expr
1a230 48 61 73 50 72 6f 70 65 72 74 79 28 45 2c 50 29 HasProperty(E,P)
1a240 20 20 20 20 20 28 28 28 45 29 2d 3e 66 6c 61 67 (((E)->flag
1a250 73 26 28 50 29 29 21 3d 30 29 0a 23 64 65 66 69 s&(P))!=0).#defi
1a260 6e 65 20 45 78 70 72 48 61 73 41 6c 6c 50 72 6f ne ExprHasAllPro
1a270 70 65 72 74 79 28 45 2c 50 29 20 20 28 28 28 45 perty(E,P) (((E
1a280 29 2d 3e 66 6c 61 67 73 26 28 50 29 29 3d 3d 28 )->flags&(P))==(
1a290 50 29 29 0a 23 64 65 66 69 6e 65 20 45 78 70 72 P)).#define Expr
1a2a0 53 65 74 50 72 6f 70 65 72 74 79 28 45 2c 50 29 SetProperty(E,P)
1a2b0 20 20 20 20 20 28 45 29 2d 3e 66 6c 61 67 73 7c (E)->flags|
1a2c0 3d 28 50 29 0a 23 64 65 66 69 6e 65 20 45 78 70 =(P).#define Exp
1a2d0 72 43 6c 65 61 72 50 72 6f 70 65 72 74 79 28 45 rClearProperty(E
1a2e0 2c 50 29 20 20 20 28 45 29 2d 3e 66 6c 61 67 73 ,P) (E)->flags
1a2f0 26 3d 7e 28 50 29 0a 0a 2f 2a 20 54 68 65 20 45 &=~(P)../* The E
1a300 78 70 72 53 65 74 56 56 41 50 72 6f 70 65 72 74 xprSetVVAPropert
1a310 79 28 29 20 6d 61 63 72 6f 20 69 73 20 75 73 65 y() macro is use
1a320 64 20 66 6f 72 20 56 65 72 69 66 69 63 61 74 69 d for Verificati
1a330 6f 6e 2c 20 56 61 6c 69 64 61 74 69 6f 6e 2c 0a on, Validation,.
1a340 2a 2a 20 61 6e 64 20 41 63 63 72 65 64 69 74 61 ** and Accredita
1a350 74 69 6f 6e 20 6f 6e 6c 79 2e 20 20 49 74 20 77 tion only. It w
1a360 6f 72 6b 73 20 6c 69 6b 65 20 45 78 70 72 53 65 orks like ExprSe
1a370 74 50 72 6f 70 65 72 74 79 28 29 20 64 75 72 69 tProperty() duri
1a380 6e 67 20 56 56 41 0a 2a 2a 20 70 72 6f 63 65 73 ng VVA.** proces
1a390 73 65 73 20 62 75 74 20 69 73 20 61 20 6e 6f 2d ses but is a no-
1a3a0 6f 70 20 66 6f 72 20 64 65 6c 69 76 65 72 79 2e op for delivery.
1a3b0 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
1a3c0 45 5f 44 45 42 55 47 0a 23 20 64 65 66 69 6e 65 E_DEBUG.# define
1a3d0 20 45 78 70 72 53 65 74 56 56 41 50 72 6f 70 65 ExprSetVVAPrope
1a3e0 72 74 79 28 45 2c 50 29 20 20 28 45 29 2d 3e 66 rty(E,P) (E)->f
1a3f0 6c 61 67 73 7c 3d 28 50 29 0a 23 65 6c 73 65 0a lags|=(P).#else.
1a400 23 20 64 65 66 69 6e 65 20 45 78 70 72 53 65 74 # define ExprSet
1a410 56 56 41 50 72 6f 70 65 72 74 79 28 45 2c 50 29 VVAProperty(E,P)
1a420 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d .#endif../*.** M
1a430 61 63 72 6f 73 20 74 6f 20 64 65 74 65 72 6d 69 acros to determi
1a440 6e 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 ne the number of
1a450 20 62 79 74 65 73 20 72 65 71 75 69 72 65 64 20 bytes required
1a460 62 79 20 61 20 6e 6f 72 6d 61 6c 20 45 78 70 72 by a normal Expr
1a470 0a 2a 2a 20 73 74 72 75 63 74 2c 20 61 6e 20 45 .** struct, an E
1a480 78 70 72 20 73 74 72 75 63 74 20 77 69 74 68 20 xpr struct with
1a490 74 68 65 20 45 50 5f 52 65 64 75 63 65 64 20 66 the EP_Reduced f
1a4a0 6c 61 67 20 73 65 74 20 69 6e 20 45 78 70 72 2e lag set in Expr.
1a4b0 66 6c 61 67 73 0a 2a 2a 20 61 6e 64 20 61 6e 20 flags.** and an
1a4c0 45 78 70 72 20 73 74 72 75 63 74 20 77 69 74 68 Expr struct with
1a4d0 20 74 68 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c the EP_TokenOnl
1a4e0 79 20 66 6c 61 67 20 73 65 74 2e 0a 2a 2f 0a 23 y flag set..*/.#
1a4f0 64 65 66 69 6e 65 20 45 58 50 52 5f 46 55 4c 4c define EXPR_FULL
1a500 53 49 5a 45 20 20 20 20 20 20 20 20 20 20 20 73 SIZE s
1a510 69 7a 65 6f 66 28 45 78 70 72 29 20 20 20 20 20 izeof(Expr)
1a520 20 20 20 20 20 20 2f 2a 20 46 75 6c 6c 20 73 69 /* Full si
1a530 7a 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 ze */.#define EX
1a540 50 52 5f 52 45 44 55 43 45 44 53 49 5a 45 20 20 PR_REDUCEDSIZE
1a550 20 20 20 20 20 20 6f 66 66 73 65 74 6f 66 28 45 offsetof(E
1a560 78 70 72 2c 69 54 61 62 6c 65 29 20 20 2f 2a 20 xpr,iTable) /*
1a570 43 6f 6d 6d 6f 6e 20 66 65 61 74 75 72 65 73 20 Common features
1a580 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 5f */.#define EXPR_
1a590 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a 45 20 20 20 TOKENONLYSIZE
1a5a0 20 20 20 6f 66 66 73 65 74 6f 66 28 45 78 70 72 offsetof(Expr
1a5b0 2c 70 4c 65 66 74 29 20 20 20 2f 2a 20 46 65 77 ,pLeft) /* Few
1a5c0 65 72 20 66 65 61 74 75 72 65 73 20 2a 2f 0a 0a er features */..
1a5d0 2f 2a 0a 2a 2a 20 46 6c 61 67 73 20 70 61 73 73 /*.** Flags pass
1a5e0 65 64 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 ed to the sqlite
1a5f0 33 45 78 70 72 44 75 70 28 29 20 66 75 6e 63 74 3ExprDup() funct
1a600 69 6f 6e 2e 20 53 65 65 20 74 68 65 20 68 65 61 ion. See the hea
1a610 64 65 72 20 63 6f 6d 6d 65 6e 74 0a 2a 2a 20 61 der comment.** a
1a620 62 6f 76 65 20 73 71 6c 69 74 65 33 45 78 70 72 bove sqlite3Expr
1a630 44 75 70 28 29 20 66 6f 72 20 64 65 74 61 69 6c Dup() for detail
1a640 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 s..*/.#define EX
1a650 50 52 44 55 50 5f 52 45 44 55 43 45 20 20 20 20 PRDUP_REDUCE
1a660 20 20 20 20 20 30 78 30 30 30 31 20 20 2f 2a 20 0x0001 /*
1a670 55 73 65 64 20 72 65 64 75 63 65 64 2d 73 69 7a Used reduced-siz
1a680 65 20 45 78 70 72 20 6e 6f 64 65 73 20 2a 2f 0a e Expr nodes */.
1a690 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 74 20 6f 66 ./*.** A list of
1a6a0 20 65 78 70 72 65 73 73 69 6f 6e 73 2e 20 20 45 expressions. E
1a6b0 61 63 68 20 65 78 70 72 65 73 73 69 6f 6e 20 6d ach expression m
1a6c0 61 79 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 68 61 ay optionally ha
1a6d0 76 65 20 61 0a 2a 2a 20 6e 61 6d 65 2e 20 20 41 ve a.** name. A
1a6e0 6e 20 65 78 70 72 2f 6e 61 6d 65 20 63 6f 6d 62 n expr/name comb
1a6f0 69 6e 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 ination can be u
1a700 73 65 64 20 69 6e 20 73 65 76 65 72 61 6c 20 77 sed in several w
1a710 61 79 73 2c 20 73 75 63 68 0a 2a 2a 20 61 73 20 ays, such.** as
1a720 74 68 65 20 6c 69 73 74 20 6f 66 20 22 65 78 70 the list of "exp
1a730 72 20 41 53 20 49 44 22 20 66 69 65 6c 64 73 20 r AS ID" fields
1a740 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 22 53 45 4c following a "SEL
1a750 45 43 54 22 20 6f 72 20 69 6e 20 74 68 65 0a 2a ECT" or in the.*
1a760 2a 20 6c 69 73 74 20 6f 66 20 22 49 44 20 3d 20 * list of "ID =
1a770 65 78 70 72 22 20 69 74 65 6d 73 20 69 6e 20 61 expr" items in a
1a780 6e 20 55 50 44 41 54 45 2e 20 20 41 20 6c 69 73 n UPDATE. A lis
1a790 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e 73 t of expressions
1a7a0 20 63 61 6e 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 can.** also be
1a7b0 75 73 65 64 20 61 73 20 74 68 65 20 61 72 67 75 used as the argu
1a7c0 6d 65 6e 74 20 74 6f 20 61 20 66 75 6e 63 74 69 ment to a functi
1a7d0 6f 6e 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 on, in which cas
1a7e0 65 20 74 68 65 20 61 2e 7a 4e 61 6d 65 0a 2a 2a e the a.zName.**
1a7f0 20 66 69 65 6c 64 20 69 73 20 6e 6f 74 20 75 73 field is not us
1a800 65 64 2e 0a 2a 2a 0a 2a 2a 20 42 79 20 64 65 66 ed..**.** By def
1a810 61 75 6c 74 20 74 68 65 20 45 78 70 72 2e 7a 53 ault the Expr.zS
1a820 70 61 6e 20 66 69 65 6c 64 20 68 6f 6c 64 73 20 pan field holds
1a830 61 20 68 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65 a human-readable
1a840 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 0a description of.
1a850 2a 2a 20 74 68 65 20 65 78 70 72 65 73 73 69 6f ** the expressio
1a860 6e 20 74 68 61 74 20 69 73 20 75 73 65 64 20 69 n that is used i
1a870 6e 20 74 68 65 20 67 65 6e 65 72 61 74 69 6f 6e n the generation
1a880 20 6f 66 20 65 72 72 6f 72 20 6d 65 73 73 61 67 of error messag
1a890 65 73 20 61 6e 64 0a 2a 2a 20 63 6f 6c 75 6d 6e es and.** column
1a8a0 20 6c 61 62 65 6c 73 2e 20 20 49 6e 20 74 68 69 labels. In thi
1a8b0 73 20 63 61 73 65 2c 20 45 78 70 72 2e 7a 53 70 s case, Expr.zSp
1a8c0 61 6e 20 69 73 20 74 79 70 69 63 61 6c 6c 79 20 an is typically
1a8d0 74 68 65 20 74 65 78 74 20 6f 66 20 61 0a 2a 2a the text of a.**
1a8e0 20 63 6f 6c 75 6d 6e 20 65 78 70 72 65 73 73 69 column expressi
1a8f0 6f 6e 20 61 73 20 69 74 20 65 78 69 73 74 73 20 on as it exists
1a900 69 6e 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 in a SELECT stat
1a910 65 6d 65 6e 74 2e 20 20 48 6f 77 65 76 65 72 2c ement. However,
1a920 20 69 66 0a 2a 2a 20 74 68 65 20 62 53 70 61 6e if.** the bSpan
1a930 49 73 54 61 62 20 66 6c 61 67 20 69 73 20 73 65 IsTab flag is se
1a940 74 2c 20 74 68 65 6e 20 7a 53 70 61 6e 20 69 73 t, then zSpan is
1a950 20 6f 76 65 72 6c 6f 61 64 65 64 20 74 6f 20 6d overloaded to m
1a960 65 61 6e 20 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 ean the name.**
1a970 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f of the result co
1a980 6c 75 6d 6e 20 69 6e 20 74 68 65 20 66 6f 72 6d lumn in the form
1a990 3a 20 44 41 54 41 42 41 53 45 2e 54 41 42 4c 45 : DATABASE.TABLE
1a9a0 2e 43 4f 4c 55 4d 4e 2e 20 20 54 68 69 73 20 6c .COLUMN. This l
1a9b0 61 74 65 72 0a 2a 2a 20 66 6f 72 6d 20 69 73 20 ater.** form is
1a9c0 75 73 65 64 20 66 6f 72 20 6e 61 6d 65 20 72 65 used for name re
1a9d0 73 6f 6c 75 74 69 6f 6e 20 77 69 74 68 20 6e 65 solution with ne
1a9e0 73 74 65 64 20 46 52 4f 4d 20 63 6c 61 75 73 65 sted FROM clause
1a9f0 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 70 s..*/.struct Exp
1aa00 72 4c 69 73 74 20 7b 0a 20 20 69 6e 74 20 6e 45 rList {. int nE
1aa10 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 xpr;
1aa20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 78 /* Number of ex
1aa30 70 72 65 73 73 69 6f 6e 73 20 6f 6e 20 74 68 65 pressions on the
1aa40 20 6c 69 73 74 20 2a 2f 0a 20 20 73 74 72 75 63 list */. struc
1aa50 74 20 45 78 70 72 4c 69 73 74 5f 69 74 65 6d 20 t ExprList_item
1aa60 7b 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 65 78 { /* For each ex
1aa70 70 72 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 pression in the
1aa80 6c 69 73 74 20 2a 2f 0a 20 20 20 20 45 78 70 72 list */. Expr
1aa90 20 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 *pExpr;
1aaa0 20 20 20 20 2f 2a 20 54 68 65 20 70 61 72 73 65 /* The parse
1aab0 20 74 72 65 65 20 66 6f 72 20 74 68 69 73 20 65 tree for this e
1aac0 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 20 xpression */.
1aad0 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 char *zName;
1aae0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 /* Toke
1aaf0 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 n associated wit
1ab00 68 20 74 68 69 73 20 65 78 70 72 65 73 73 69 6f h this expressio
1ab10 6e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a n */. char *z
1ab20 53 70 61 6e 3b 20 20 20 20 20 20 20 20 20 20 20 Span;
1ab30 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 74 65 78 /* Original tex
1ab40 74 20 6f 66 20 74 68 65 20 65 78 70 72 65 73 73 t of the express
1ab50 69 6f 6e 20 2a 2f 0a 20 20 20 20 75 38 20 73 6f ion */. u8 so
1ab60 72 74 4f 72 64 65 72 3b 20 20 20 20 20 20 20 20 rtOrder;
1ab70 20 20 20 2f 2a 20 31 20 66 6f 72 20 44 45 53 43 /* 1 for DESC
1ab80 20 6f 72 20 30 20 66 6f 72 20 41 53 43 20 2a 2f or 0 for ASC */
1ab90 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 64 6f . unsigned do
1aba0 6e 65 20 3a 31 3b 20 20 20 20 20 20 20 2f 2a 20 ne :1; /*
1abb0 41 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 63 61 A flag to indica
1abc0 74 65 20 77 68 65 6e 20 70 72 6f 63 65 73 73 69 te when processi
1abd0 6e 67 20 69 73 20 66 69 6e 69 73 68 65 64 20 2a ng is finished *
1abe0 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 62 /. unsigned b
1abf0 53 70 61 6e 49 73 54 61 62 20 3a 31 3b 20 2f 2a SpanIsTab :1; /*
1ac00 20 7a 53 70 61 6e 20 68 6f 6c 64 73 20 44 42 2e zSpan holds DB.
1ac10 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 20 2a 2f 0a TABLE.COLUMN */.
1ac20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 72 65 75 unsigned reu
1ac30 73 61 62 6c 65 20 3a 31 3b 20 20 20 2f 2a 20 43 sable :1; /* C
1ac40 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 73 69 onstant expressi
1ac50 6f 6e 20 69 73 20 72 65 75 73 61 62 6c 65 20 2a on is reusable *
1ac60 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 62 /. unsigned b
1ac70 53 6f 72 74 65 72 52 65 66 20 3a 31 3b 20 2f 2a SorterRef :1; /*
1ac80 20 44 65 66 65 72 20 65 76 61 6c 75 61 74 69 6f Defer evaluatio
1ac90 6e 20 75 6e 74 69 6c 20 61 66 74 65 72 20 73 6f n until after so
1aca0 72 74 69 6e 67 20 2a 2f 0a 20 20 20 20 75 6e 69 rting */. uni
1acb0 6f 6e 20 7b 0a 20 20 20 20 20 20 73 74 72 75 63 on {. struc
1acc0 74 20 7b 0a 20 20 20 20 20 20 20 20 75 31 36 20 t {. u16
1acd0 69 4f 72 64 65 72 42 79 43 6f 6c 3b 20 20 20 20 iOrderByCol;
1ace0 20 20 2f 2a 20 46 6f 72 20 4f 52 44 45 52 20 42 /* For ORDER B
1acf0 59 2c 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 Y, column number
1ad00 20 69 6e 20 72 65 73 75 6c 74 20 73 65 74 20 2a in result set *
1ad10 2f 0a 20 20 20 20 20 20 20 20 75 31 36 20 69 41 /. u16 iA
1ad20 6c 69 61 73 3b 20 20 20 20 20 20 20 20 20 20 20 lias;
1ad30 2f 2a 20 49 6e 64 65 78 20 69 6e 74 6f 20 50 61 /* Index into Pa
1ad40 72 73 65 2e 61 41 6c 69 61 73 5b 5d 20 66 6f 72 rse.aAlias[] for
1ad50 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 20 20 20 20 zName */.
1ad60 7d 20 78 3b 0a 20 20 20 20 20 20 69 6e 74 20 69 } x;. int i
1ad70 43 6f 6e 73 74 45 78 70 72 52 65 67 3b 20 20 20 ConstExprReg;
1ad80 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 69 /* Register i
1ad90 6e 20 77 68 69 63 68 20 45 78 70 72 20 76 61 6c n which Expr val
1ada0 75 65 20 69 73 20 63 61 63 68 65 64 20 2a 2f 0a ue is cached */.
1adb0 20 20 20 20 7d 20 75 3b 0a 20 20 7d 20 61 5b 31 } u;. } a[1
1adc0 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ];
1add0 20 20 20 20 2f 2a 20 4f 6e 65 20 73 6c 6f 74 20 /* One slot
1ade0 66 6f 72 20 65 61 63 68 20 65 78 70 72 65 73 73 for each express
1adf0 69 6f 6e 20 69 6e 20 74 68 65 20 6c 69 73 74 20 ion in the list
1ae00 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 */.};../*.** An
1ae10 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 instance of this
1ae20 20 73 74 72 75 63 74 75 72 65 20 63 61 6e 20 68 structure can h
1ae30 6f 6c 64 20 61 20 73 69 6d 70 6c 65 20 6c 69 73 old a simple lis
1ae40 74 20 6f 66 20 69 64 65 6e 74 69 66 69 65 72 73 t of identifiers
1ae50 2c 0a 2a 2a 20 73 75 63 68 20 61 73 20 74 68 65 ,.** such as the
1ae60 20 6c 69 73 74 20 22 61 2c 62 2c 63 22 20 69 6e list "a,b,c" in
1ae70 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
1ae80 74 61 74 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a tatements:.**.**
1ae90 20 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 INSERT INT
1aea0 4f 20 74 28 61 2c 62 2c 63 29 20 56 41 4c 55 45 O t(a,b,c) VALUE
1aeb0 53 20 2e 2e 2e 3b 0a 2a 2a 20 20 20 20 20 20 43 S ...;.** C
1aec0 52 45 41 54 45 20 49 4e 44 45 58 20 69 64 78 20 REATE INDEX idx
1aed0 4f 4e 20 74 28 61 2c 62 2c 63 29 3b 0a 2a 2a 20 ON t(a,b,c);.**
1aee0 20 20 20 20 20 43 52 45 41 54 45 20 54 52 49 47 CREATE TRIG
1aef0 47 45 52 20 74 72 69 67 20 42 45 46 4f 52 45 20 GER trig BEFORE
1af00 55 50 44 41 54 45 20 4f 4e 20 74 28 61 2c 62 2c UPDATE ON t(a,b,
1af10 63 29 20 2e 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 68 c) ...;.**.** Th
1af20 65 20 49 64 4c 69 73 74 2e 61 2e 69 64 78 20 66 e IdList.a.idx f
1af30 69 65 6c 64 20 69 73 20 75 73 65 64 20 77 68 65 ield is used whe
1af40 6e 20 74 68 65 20 49 64 4c 69 73 74 20 72 65 70 n the IdList rep
1af50 72 65 73 65 6e 74 73 20 74 68 65 20 6c 69 73 74 resents the list
1af60 20 6f 66 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6e 61 of.** column na
1af70 6d 65 73 20 61 66 74 65 72 20 61 20 74 61 62 6c mes after a tabl
1af80 65 20 6e 61 6d 65 20 69 6e 20 61 6e 20 49 4e 53 e name in an INS
1af90 45 52 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 ERT statement.
1afa0 49 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 In the statement
1afb0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 49 4e 53 45 52 .**.** INSER
1afc0 54 20 49 4e 54 4f 20 74 28 61 2c 62 2c 63 29 20 T INTO t(a,b,c)
1afd0 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 22 61 22 ....**.** If "a"
1afe0 20 69 73 20 74 68 65 20 6b 2d 74 68 20 63 6f 6c is the k-th col
1aff0 75 6d 6e 20 6f 66 20 74 61 62 6c 65 20 22 74 22 umn of table "t"
1b000 2c 20 74 68 65 6e 20 49 64 4c 69 73 74 2e 61 5b , then IdList.a[
1b010 30 5d 2e 69 64 78 3d 3d 6b 2e 0a 2a 2f 0a 73 74 0].idx==k..*/.st
1b020 72 75 63 74 20 49 64 4c 69 73 74 20 7b 0a 20 20 ruct IdList {.
1b030 73 74 72 75 63 74 20 49 64 4c 69 73 74 5f 69 74 struct IdList_it
1b040 65 6d 20 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a em {. char *z
1b050 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 4e 61 Name; /* Na
1b060 6d 65 20 6f 66 20 74 68 65 20 69 64 65 6e 74 69 me of the identi
1b070 66 69 65 72 20 2a 2f 0a 20 20 20 20 69 6e 74 20 fier */. int
1b080 69 64 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a idx; /*
1b090 20 49 6e 64 65 78 20 69 6e 20 73 6f 6d 65 20 54 Index in some T
1b0a0 61 62 6c 65 2e 61 43 6f 6c 5b 5d 20 6f 66 20 61 able.aCol[] of a
1b0b0 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 64 20 7a 4e column named zN
1b0c0 61 6d 65 20 2a 2f 0a 20 20 7d 20 2a 61 3b 0a 20 ame */. } *a;.
1b0d0 20 69 6e 74 20 6e 49 64 3b 20 20 20 20 20 20 20 int nId;
1b0e0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 69 /* Number of i
1b0f0 64 65 6e 74 69 66 69 65 72 73 20 6f 6e 20 74 68 dentifiers on th
1b100 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a e list */.};../*
1b110 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
1b120 67 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 g structure desc
1b130 72 69 62 65 73 20 74 68 65 20 46 52 4f 4d 20 63 ribes the FROM c
1b140 6c 61 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43 lause of a SELEC
1b150 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 T statement..**
1b160 45 61 63 68 20 74 61 62 6c 65 20 6f 72 20 73 75 Each table or su
1b170 62 71 75 65 72 79 20 69 6e 20 74 68 65 20 46 52 bquery in the FR
1b180 4f 4d 20 63 6c 61 75 73 65 20 69 73 20 61 20 73 OM clause is a s
1b190 65 70 61 72 61 74 65 20 65 6c 65 6d 65 6e 74 20 eparate element
1b1a0 6f 66 0a 2a 2a 20 74 68 65 20 53 72 63 4c 69 73 of.** the SrcLis
1b1b0 74 2e 61 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a t.a[] array..**.
1b1c0 2a 2a 20 57 69 74 68 20 74 68 65 20 61 64 64 69 ** With the addi
1b1d0 74 69 6f 6e 20 6f 66 20 6d 75 6c 74 69 70 6c 65 tion of multiple
1b1e0 20 64 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 database suppor
1b1f0 74 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 t, the following
1b200 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 63 61 structure.** ca
1b210 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 n also be used t
1b220 6f 20 64 65 73 63 72 69 62 65 20 61 20 70 61 72 o describe a par
1b230 74 69 63 75 6c 61 72 20 74 61 62 6c 65 20 73 75 ticular table su
1b240 63 68 20 61 73 20 74 68 65 20 74 61 62 6c 65 20 ch as the table
1b250 74 68 61 74 0a 2a 2a 20 69 73 20 6d 6f 64 69 66 that.** is modif
1b260 69 65 64 20 62 79 20 61 6e 20 49 4e 53 45 52 54 ied by an INSERT
1b270 2c 20 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 44 , DELETE, or UPD
1b280 41 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 ATE statement.
1b290 49 6e 20 73 74 61 6e 64 61 72 64 20 53 51 4c 2c In standard SQL,
1b2a0 0a 2a 2a 20 73 75 63 68 20 61 20 74 61 62 6c 65 .** such a table
1b2b0 20 6d 75 73 74 20 62 65 20 61 20 73 69 6d 70 6c must be a simpl
1b2c0 65 20 6e 61 6d 65 3a 20 49 44 2e 20 20 42 75 74 e name: ID. But
1b2d0 20 69 6e 20 53 51 4c 69 74 65 2c 20 74 68 65 20 in SQLite, the
1b2e0 74 61 62 6c 65 20 63 61 6e 0a 2a 2a 20 6e 6f 77 table can.** now
1b2f0 20 62 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 be identified b
1b300 79 20 61 20 64 61 74 61 62 61 73 65 20 6e 61 6d y a database nam
1b310 65 2c 20 61 20 64 6f 74 2c 20 74 68 65 6e 20 74 e, a dot, then t
1b320 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 3a 20 49 he table name: I
1b330 44 2e 49 44 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 D.ID..**.** The
1b340 6a 6f 69 6e 74 79 70 65 20 73 74 61 72 74 73 20 jointype starts
1b350 6f 75 74 20 73 68 6f 77 69 6e 67 20 74 68 65 20 out showing the
1b360 6a 6f 69 6e 20 74 79 70 65 20 62 65 74 77 65 65 join type betwee
1b370 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 n the current ta
1b380 62 6c 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 6e ble.** and the n
1b390 65 78 74 20 74 61 62 6c 65 20 6f 6e 20 74 68 65 ext table on the
1b3a0 20 6c 69 73 74 2e 20 20 54 68 65 20 70 61 72 73 list. The pars
1b3b0 65 72 20 62 75 69 6c 64 73 20 74 68 65 20 6c 69 er builds the li
1b3c0 73 74 20 74 68 69 73 20 77 61 79 2e 0a 2a 2a 20 st this way..**
1b3d0 42 75 74 20 73 71 6c 69 74 65 33 53 72 63 4c 69 But sqlite3SrcLi
1b3e0 73 74 53 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 stShiftJoinType(
1b3f0 29 20 6c 61 74 65 72 20 73 68 69 66 74 73 20 74 ) later shifts t
1b400 68 65 20 6a 6f 69 6e 74 79 70 65 73 20 73 6f 20 he jointypes so
1b410 74 68 61 74 20 65 61 63 68 0a 2a 2a 20 6a 6f 69 that each.** joi
1b420 6e 74 79 70 65 20 65 78 70 72 65 73 73 65 73 20 ntype expresses
1b430 74 68 65 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e the join between
1b440 20 74 68 65 20 74 61 62 6c 65 20 61 6e 64 20 74 the table and t
1b450 68 65 20 70 72 65 76 69 6f 75 73 20 74 61 62 6c he previous tabl
1b460 65 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 e..**.** In the
1b470 63 6f 6c 55 73 65 64 20 66 69 65 6c 64 2c 20 74 colUsed field, t
1b480 68 65 20 68 69 67 68 2d 6f 72 64 65 72 20 62 69 he high-order bi
1b490 74 20 28 62 69 74 20 36 33 29 20 69 73 20 73 65 t (bit 63) is se
1b4a0 74 20 69 66 20 74 68 65 20 74 61 62 6c 65 0a 2a t if the table.*
1b4b0 2a 20 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 * contains more
1b4c0 74 68 61 6e 20 36 33 20 63 6f 6c 75 6d 6e 73 20 than 63 columns
1b4d0 61 6e 64 20 74 68 65 20 36 34 2d 74 68 20 6f 72 and the 64-th or
1b4e0 20 6c 61 74 65 72 20 63 6f 6c 75 6d 6e 20 69 73 later column is
1b4f0 20 75 73 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 used..*/.struct
1b500 20 53 72 63 4c 69 73 74 20 7b 0a 20 20 69 6e 74 SrcList {. int
1b510 20 6e 53 72 63 3b 20 20 20 20 20 20 20 20 2f 2a nSrc; /*
1b520 20 4e 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 Number of table
1b530 73 20 6f 72 20 73 75 62 71 75 65 72 69 65 73 20 s or subqueries
1b540 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 in the FROM clau
1b550 73 65 20 2a 2f 0a 20 20 75 33 32 20 6e 41 6c 6c se */. u32 nAll
1b560 6f 63 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 oc; /* Numb
1b570 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 61 6c er of entries al
1b580 6c 6f 63 61 74 65 64 20 69 6e 20 61 5b 5d 20 62 located in a[] b
1b590 65 6c 6f 77 20 2a 2f 0a 20 20 73 74 72 75 63 74 elow */. struct
1b5a0 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 7b 0a SrcList_item {.
1b5b0 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 Schema *pSch
1b5c0 65 6d 61 3b 20 20 2f 2a 20 53 63 68 65 6d 61 20 ema; /* Schema
1b5d0 74 6f 20 77 68 69 63 68 20 74 68 69 73 20 69 74 to which this it
1b5e0 65 6d 20 69 73 20 66 69 78 65 64 20 2a 2f 0a 20 em is fixed */.
1b5f0 20 20 20 63 68 61 72 20 2a 7a 44 61 74 61 62 61 char *zDataba
1b600 73 65 3b 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 se; /* Name of
1b610 64 61 74 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 database holding
1b620 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 this table */.
1b630 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 char *zName;
1b640 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
1b650 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 the table */.
1b660 20 63 68 61 72 20 2a 7a 41 6c 69 61 73 3b 20 20 char *zAlias;
1b670 20 20 20 2f 2a 20 54 68 65 20 22 42 22 20 70 61 /* The "B" pa
1b680 72 74 20 6f 66 20 61 20 22 41 20 41 53 20 42 22 rt of a "A AS B"
1b690 20 70 68 72 61 73 65 2e 20 20 7a 4e 61 6d 65 20 phrase. zName
1b6a0 69 73 20 74 68 65 20 22 41 22 20 2a 2f 0a 20 20 is the "A" */.
1b6b0 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 Table *pTab;
1b6c0 20 20 20 20 2f 2a 20 41 6e 20 53 51 4c 20 74 61 /* An SQL ta
1b6d0 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e ble correspondin
1b6e0 67 20 74 6f 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 g to zName */.
1b6f0 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 Select *pSelec
1b700 74 3b 20 20 2f 2a 20 41 20 53 45 4c 45 43 54 20 t; /* A SELECT
1b710 73 74 61 74 65 6d 65 6e 74 20 75 73 65 64 20 69 statement used i
1b720 6e 20 70 6c 61 63 65 20 6f 66 20 61 20 74 61 62 n place of a tab
1b730 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 69 le name */. i
1b740 6e 74 20 61 64 64 72 46 69 6c 6c 53 75 62 3b 20 nt addrFillSub;
1b750 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 73 /* Address of s
1b760 75 62 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 6e ubroutine to man
1b770 69 66 65 73 74 20 61 20 73 75 62 71 75 65 72 79 ifest a subquery
1b780 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 52 */. int regR
1b790 65 74 75 72 6e 3b 20 20 20 20 2f 2a 20 52 65 67 eturn; /* Reg
1b7a0 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 65 ister holding re
1b7b0 74 75 72 6e 20 61 64 64 72 65 73 73 20 6f 66 20 turn address of
1b7c0 61 64 64 72 46 69 6c 6c 53 75 62 20 2a 2f 0a 20 addrFillSub */.
1b7d0 20 20 20 69 6e 74 20 72 65 67 52 65 73 75 6c 74 int regResult
1b7e0 3b 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 ; /* Register
1b7f0 73 20 68 6f 6c 64 69 6e 67 20 72 65 73 75 6c 74 s holding result
1b800 73 20 6f 66 20 61 20 63 6f 2d 72 6f 75 74 69 6e s of a co-routin
1b810 65 20 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 e */. struct
1b820 7b 0a 20 20 20 20 20 20 75 38 20 6a 6f 69 6e 74 {. u8 joint
1b830 79 70 65 3b 20 20 20 20 20 20 2f 2a 20 54 79 70 ype; /* Typ
1b840 65 20 6f 66 20 6a 6f 69 6e 20 62 65 74 77 65 65 e of join betwee
1b850 6e 20 74 68 69 73 20 74 61 62 6c 65 20 61 6e 64 n this table and
1b860 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 2a 2f the previous */
1b870 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 . unsigned
1b880 6e 6f 74 49 6e 64 65 78 65 64 20 3a 31 3b 20 20 notIndexed :1;
1b890 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 /* True if the
1b8a0 72 65 20 69 73 20 61 20 4e 4f 54 20 49 4e 44 45 re is a NOT INDE
1b8b0 58 45 44 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 XED clause */.
1b8c0 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 73 49 unsigned isI
1b8d0 6e 64 65 78 65 64 42 79 20 3a 31 3b 20 20 20 2f ndexedBy :1; /
1b8e0 2a 20 54 72 75 65 20 69 66 20 74 68 65 72 65 20 * True if there
1b8f0 69 73 20 61 6e 20 49 4e 44 45 58 45 44 20 42 59 is an INDEXED BY
1b900 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 20 clause */.
1b910 20 75 6e 73 69 67 6e 65 64 20 69 73 54 61 62 46 unsigned isTabF
1b920 75 6e 63 20 3a 31 3b 20 20 20 20 20 2f 2a 20 54 unc :1; /* T
1b930 72 75 65 20 69 66 20 74 61 62 6c 65 2d 76 61 6c rue if table-val
1b940 75 65 64 2d 66 75 6e 63 74 69 6f 6e 20 73 79 6e ued-function syn
1b950 74 61 78 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 tax */. uns
1b960 69 67 6e 65 64 20 69 73 43 6f 72 72 65 6c 61 74 igned isCorrelat
1b970 65 64 20 3a 31 3b 20 20 2f 2a 20 54 72 75 65 20 ed :1; /* True
1b980 69 66 20 73 75 62 2d 71 75 65 72 79 20 69 73 20 if sub-query is
1b990 63 6f 72 72 65 6c 61 74 65 64 20 2a 2f 0a 20 20 correlated */.
1b9a0 20 20 20 20 75 6e 73 69 67 6e 65 64 20 76 69 61 unsigned via
1b9b0 43 6f 72 6f 75 74 69 6e 65 20 3a 31 3b 20 20 2f Coroutine :1; /
1b9c0 2a 20 49 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 * Implemented as
1b9d0 20 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 2a 2f a co-routine */
1b9e0 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 . unsigned
1b9f0 69 73 52 65 63 75 72 73 69 76 65 20 3a 31 3b 20 isRecursive :1;
1ba00 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 72 65 /* True for re
1ba10 63 75 72 73 69 76 65 20 72 65 66 65 72 65 6e 63 cursive referenc
1ba20 65 20 69 6e 20 57 49 54 48 20 2a 2f 0a 20 20 20 e in WITH */.
1ba30 20 7d 20 66 67 3b 0a 20 20 20 20 69 6e 74 20 69 } fg;. int i
1ba40 43 75 72 73 6f 72 3b 20 20 20 20 20 20 2f 2a 20 Cursor; /*
1ba50 54 68 65 20 56 44 42 45 20 63 75 72 73 6f 72 20 The VDBE cursor
1ba60 6e 75 6d 62 65 72 20 75 73 65 64 20 74 6f 20 61 number used to a
1ba70 63 63 65 73 73 20 74 68 69 73 20 74 61 62 6c 65 ccess this table
1ba80 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 4f */. Expr *pO
1ba90 6e 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 n; /* The
1baa0 20 4f 4e 20 63 6c 61 75 73 65 20 6f 66 20 61 20 ON clause of a
1bab0 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 49 64 4c 69 join */. IdLi
1bac0 73 74 20 2a 70 55 73 69 6e 67 3b 20 20 20 2f 2a st *pUsing; /*
1bad0 20 54 68 65 20 55 53 49 4e 47 20 63 6c 61 75 73 The USING claus
1bae0 65 20 6f 66 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 e of a join */.
1baf0 20 20 20 42 69 74 6d 61 73 6b 20 63 6f 6c 55 73 Bitmask colUs
1bb00 65 64 3b 20 20 2f 2a 20 42 69 74 20 4e 20 28 31 ed; /* Bit N (1
1bb10 3c 3c 4e 29 20 73 65 74 20 69 66 20 63 6f 6c 75 <<N) set if colu
1bb20 6d 6e 20 4e 20 6f 66 20 70 54 61 62 20 69 73 20 mn N of pTab is
1bb30 75 73 65 64 20 2a 2f 0a 20 20 20 20 75 6e 69 6f used */. unio
1bb40 6e 20 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a n {. char *
1bb50 7a 49 6e 64 65 78 65 64 42 79 3b 20 20 20 20 2f zIndexedBy; /
1bb60 2a 20 49 64 65 6e 74 69 66 69 65 72 20 66 72 6f * Identifier fro
1bb70 6d 20 22 49 4e 44 45 58 45 44 20 42 59 20 3c 7a m "INDEXED BY <z
1bb80 49 6e 64 65 78 3e 22 20 63 6c 61 75 73 65 20 2a Index>" clause *
1bb90 2f 0a 20 20 20 20 20 20 45 78 70 72 4c 69 73 74 /. ExprList
1bba0 20 2a 70 46 75 6e 63 41 72 67 3b 20 20 2f 2a 20 *pFuncArg; /*
1bbb0 41 72 67 75 6d 65 6e 74 73 20 74 6f 20 74 61 62 Arguments to tab
1bbc0 6c 65 2d 76 61 6c 75 65 64 2d 66 75 6e 63 74 69 le-valued-functi
1bbd0 6f 6e 20 2a 2f 0a 20 20 20 20 7d 20 75 31 3b 0a on */. } u1;.
1bbe0 20 20 20 20 49 6e 64 65 78 20 2a 70 49 42 49 6e Index *pIBIn
1bbf0 64 65 78 3b 20 20 2f 2a 20 49 6e 64 65 78 20 73 dex; /* Index s
1bc00 74 72 75 63 74 75 72 65 20 63 6f 72 72 65 73 70 tructure corresp
1bc10 6f 6e 64 69 6e 67 20 74 6f 20 75 31 2e 7a 49 6e onding to u1.zIn
1bc20 64 65 78 65 64 42 79 20 2a 2f 0a 20 20 7d 20 61 dexedBy */. } a
1bc30 5b 31 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 [1];
1bc40 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 20 66 6f /* One entry fo
1bc50 72 20 65 61 63 68 20 69 64 65 6e 74 69 66 69 65 r each identifie
1bc60 72 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 2a 2f r on the list */
1bc70 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 6d 69 .};../*.** Permi
1bc80 74 74 65 64 20 76 61 6c 75 65 73 20 6f 66 20 74 tted values of t
1bc90 68 65 20 53 72 63 4c 69 73 74 2e 61 2e 6a 6f 69 he SrcList.a.joi
1bca0 6e 74 79 70 65 20 66 69 65 6c 64 0a 2a 2f 0a 23 ntype field.*/.#
1bcb0 64 65 66 69 6e 65 20 4a 54 5f 49 4e 4e 45 52 20 define JT_INNER
1bcc0 20 20 20 20 30 78 30 30 30 31 20 20 20 20 2f 2a 0x0001 /*
1bcd0 20 41 6e 79 20 6b 69 6e 64 20 6f 66 20 69 6e 6e Any kind of inn
1bce0 65 72 20 6f 72 20 63 72 6f 73 73 20 6a 6f 69 6e er or cross join
1bcf0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 43 */.#define JT_C
1bd00 52 4f 53 53 20 20 20 20 20 30 78 30 30 30 32 20 ROSS 0x0002
1bd10 20 20 20 2f 2a 20 45 78 70 6c 69 63 69 74 20 75 /* Explicit u
1bd20 73 65 20 6f 66 20 74 68 65 20 43 52 4f 53 53 20 se of the CROSS
1bd30 6b 65 79 77 6f 72 64 20 2a 2f 0a 23 64 65 66 69 keyword */.#defi
1bd40 6e 65 20 4a 54 5f 4e 41 54 55 52 41 4c 20 20 20 ne JT_NATURAL
1bd50 30 78 30 30 30 34 20 20 20 20 2f 2a 20 54 72 75 0x0004 /* Tru
1bd60 65 20 66 6f 72 20 61 20 22 6e 61 74 75 72 61 6c e for a "natural
1bd70 22 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e " join */.#defin
1bd80 65 20 4a 54 5f 4c 45 46 54 20 20 20 20 20 20 30 e JT_LEFT 0
1bd90 78 30 30 30 38 20 20 20 20 2f 2a 20 4c 65 66 74 x0008 /* Left
1bda0 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a 2f 0a 23 outer join */.#
1bdb0 64 65 66 69 6e 65 20 4a 54 5f 52 49 47 48 54 20 define JT_RIGHT
1bdc0 20 20 20 20 30 78 30 30 31 30 20 20 20 20 2f 2a 0x0010 /*
1bdd0 20 52 69 67 68 74 20 6f 75 74 65 72 20 6a 6f 69 Right outer joi
1bde0 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f n */.#define JT_
1bdf0 4f 55 54 45 52 20 20 20 20 20 30 78 30 30 32 30 OUTER 0x0020
1be00 20 20 20 20 2f 2a 20 54 68 65 20 22 4f 55 54 45 /* The "OUTE
1be10 52 22 20 6b 65 79 77 6f 72 64 20 69 73 20 70 72 R" keyword is pr
1be20 65 73 65 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 esent */.#define
1be30 20 4a 54 5f 45 52 52 4f 52 20 20 20 20 20 30 78 JT_ERROR 0x
1be40 30 30 34 30 20 20 20 20 2f 2a 20 75 6e 6b 6e 6f 0040 /* unkno
1be50 77 6e 20 6f 72 20 75 6e 73 75 70 70 6f 72 74 65 wn or unsupporte
1be60 64 20 6a 6f 69 6e 20 74 79 70 65 20 2a 2f 0a 0a d join type */..
1be70 0a 2f 2a 0a 2a 2a 20 46 6c 61 67 73 20 61 70 70 ./*.** Flags app
1be80 72 6f 70 72 69 61 74 65 20 66 6f 72 20 74 68 65 ropriate for the
1be90 20 77 63 74 72 6c 46 6c 61 67 73 20 70 61 72 61 wctrlFlags para
1bea0 6d 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 33 meter of sqlite3
1beb0 57 68 65 72 65 42 65 67 69 6e 28 29 0a 2a 2a 20 WhereBegin().**
1bec0 61 6e 64 20 74 68 65 20 57 68 65 72 65 49 6e 66 and the WhereInf
1bed0 6f 2e 77 63 74 72 6c 46 6c 61 67 73 20 6d 65 6d o.wctrlFlags mem
1bee0 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 ber..**.** Value
1bef0 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 65 6e constraints (en
1bf00 66 6f 72 63 65 64 20 76 69 61 20 61 73 73 65 72 forced via asser
1bf10 74 28 29 29 3a 0a 2a 2a 20 20 20 20 20 57 48 45 t()):.** WHE
1bf20 52 45 5f 55 53 45 5f 4c 49 4d 49 54 20 20 3d 3d RE_USE_LIMIT ==
1bf30 20 53 46 5f 46 69 78 65 64 4c 69 6d 69 74 0a 2a SF_FixedLimit.*
1bf40 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1bf50 4f 52 44 45 52 42 59 5f 4e 4f 52 4d 41 4c 20 20 ORDERBY_NORMAL
1bf60 20 30 78 30 30 30 30 20 2f 2a 20 4e 6f 2d 6f 70 0x0000 /* No-op
1bf70 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
1bf80 45 5f 4f 52 44 45 52 42 59 5f 4d 49 4e 20 20 20 E_ORDERBY_MIN
1bf90 20 20 20 30 78 30 30 30 31 20 2f 2a 20 4f 52 44 0x0001 /* ORD
1bfa0 45 52 20 42 59 20 70 72 6f 63 65 73 73 69 6e 67 ER BY processing
1bfb0 20 66 6f 72 20 6d 69 6e 28 29 20 66 75 6e 63 20 for min() func
1bfc0 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
1bfd0 5f 4f 52 44 45 52 42 59 5f 4d 41 58 20 20 20 20 _ORDERBY_MAX
1bfe0 20 20 30 78 30 30 30 32 20 2f 2a 20 4f 52 44 45 0x0002 /* ORDE
1bff0 52 20 42 59 20 70 72 6f 63 65 73 73 69 6e 67 20 R BY processing
1c000 66 6f 72 20 6d 61 78 28 29 20 66 75 6e 63 20 2a for max() func *
1c010 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1c020 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 45 44 20 ONEPASS_DESIRED
1c030 20 30 78 30 30 30 34 20 2f 2a 20 57 61 6e 74 20 0x0004 /* Want
1c040 74 6f 20 64 6f 20 6f 6e 65 2d 70 61 73 73 20 55 to do one-pass U
1c050 50 44 41 54 45 2f 44 45 4c 45 54 45 20 2a 2f 0a PDATE/DELETE */.
1c060 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e #define WHERE_ON
1c070 45 50 41 53 53 5f 4d 55 4c 54 49 52 4f 57 20 30 EPASS_MULTIROW 0
1c080 78 30 30 30 38 20 2f 2a 20 4f 4e 45 50 41 53 53 x0008 /* ONEPASS
1c090 20 69 73 20 6f 6b 20 77 69 74 68 20 6d 75 6c 74 is ok with mult
1c0a0 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a 23 64 65 iple rows */.#de
1c0b0 66 69 6e 65 20 57 48 45 52 45 5f 44 55 50 4c 49 fine WHERE_DUPLI
1c0c0 43 41 54 45 53 5f 4f 4b 20 20 20 20 30 78 30 30 CATES_OK 0x00
1c0d0 31 30 20 2f 2a 20 4f 6b 20 74 6f 20 72 65 74 75 10 /* Ok to retu
1c0e0 72 6e 20 61 20 72 6f 77 20 6d 6f 72 65 20 74 68 rn a row more th
1c0f0 61 6e 20 6f 6e 63 65 20 2a 2f 0a 23 64 65 66 69 an once */.#defi
1c100 6e 65 20 57 48 45 52 45 5f 4f 52 5f 53 55 42 43 ne WHERE_OR_SUBC
1c110 4c 41 55 53 45 20 20 20 20 20 30 78 30 30 32 30 LAUSE 0x0020
1c120 20 2f 2a 20 50 72 6f 63 65 73 73 69 6e 67 20 61 /* Processing a
1c130 20 73 75 62 2d 57 48 45 52 45 20 61 73 20 70 61 sub-WHERE as pa
1c140 72 74 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 rt of.
1c150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c160 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 ** t
1c170 68 65 20 4f 52 20 6f 70 74 69 6d 69 7a 61 74 69 he OR optimizati
1c180 6f 6e 20 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 on */.#define W
1c190 48 45 52 45 5f 47 52 4f 55 50 42 59 20 20 20 20 HERE_GROUPBY
1c1a0 20 20 20 20 20 20 30 78 30 30 34 30 20 2f 2a 20 0x0040 /*
1c1b0 70 4f 72 64 65 72 42 79 20 69 73 20 72 65 61 6c pOrderBy is real
1c1c0 6c 79 20 61 20 47 52 4f 55 50 20 42 59 20 2a 2f ly a GROUP BY */
1c1d0 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 .#define WHERE_D
1c1e0 49 53 54 49 4e 43 54 42 59 20 20 20 20 20 20 20 ISTINCTBY
1c1f0 30 78 30 30 38 30 20 2f 2a 20 70 4f 72 64 65 72 0x0080 /* pOrder
1c200 62 79 20 69 73 20 72 65 61 6c 6c 79 20 61 20 44 by is really a D
1c210 49 53 54 49 4e 43 54 20 63 6c 61 75 73 65 20 2a ISTINCT clause *
1c220 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1c230 57 41 4e 54 5f 44 49 53 54 49 4e 43 54 20 20 20 WANT_DISTINCT
1c240 20 30 78 30 31 30 30 20 2f 2a 20 41 6c 6c 20 6f 0x0100 /* All o
1c250 75 74 70 75 74 20 6e 65 65 64 73 20 74 6f 20 62 utput needs to b
1c260 65 20 64 69 73 74 69 6e 63 74 20 2a 2f 0a 23 64 e distinct */.#d
1c270 65 66 69 6e 65 20 57 48 45 52 45 5f 53 4f 52 54 efine WHERE_SORT
1c280 42 59 47 52 4f 55 50 20 20 20 20 20 20 30 78 30 BYGROUP 0x0
1c290 32 30 30 20 2f 2a 20 53 75 70 70 6f 72 74 20 73 200 /* Support s
1c2a0 71 6c 69 74 65 33 57 68 65 72 65 49 73 53 6f 72 qlite3WhereIsSor
1c2b0 74 65 64 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 ted() */.#define
1c2c0 20 57 48 45 52 45 5f 53 45 45 4b 5f 54 41 42 4c WHERE_SEEK_TABL
1c2d0 45 20 20 20 20 20 20 20 30 78 30 34 30 30 20 2f E 0x0400 /
1c2e0 2a 20 44 6f 20 6e 6f 74 20 64 65 66 65 72 20 73 * Do not defer s
1c2f0 65 65 6b 73 20 6f 6e 20 6d 61 69 6e 20 74 61 62 eeks on main tab
1c300 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 le */.#define WH
1c310 45 52 45 5f 4f 52 44 45 52 42 59 5f 4c 49 4d 49 ERE_ORDERBY_LIMI
1c320 54 20 20 20 20 30 78 30 38 30 30 20 2f 2a 20 4f T 0x0800 /* O
1c330 52 44 45 52 42 59 2b 4c 49 4d 49 54 20 6f 6e 20 RDERBY+LIMIT on
1c340 74 68 65 20 69 6e 6e 65 72 20 6c 6f 6f 70 20 2a the inner loop *
1c350 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1c360 53 45 45 4b 5f 55 4e 49 51 5f 54 41 42 4c 45 20 SEEK_UNIQ_TABLE
1c370 20 30 78 31 30 30 30 20 2f 2a 20 44 6f 20 6e 6f 0x1000 /* Do no
1c380 74 20 64 65 66 65 72 20 73 65 65 6b 73 20 69 66 t defer seeks if
1c390 20 75 6e 69 71 75 65 20 2a 2f 0a 20 20 20 20 20 unique */.
1c3a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c3b0 20 20 20 2f 2a 20 20 20 20 20 30 78 32 30 30 30 /* 0x2000
1c3c0 20 20 20 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c not currentl
1c3d0 79 20 75 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e y used */.#defin
1c3e0 65 20 57 48 45 52 45 5f 55 53 45 5f 4c 49 4d 49 e WHERE_USE_LIMI
1c3f0 54 20 20 20 20 20 20 20 20 30 78 34 30 30 30 20 T 0x4000
1c400 2f 2a 20 55 73 65 20 74 68 65 20 4c 49 4d 49 54 /* Use the LIMIT
1c410 20 69 6e 20 63 6f 73 74 20 65 73 74 69 6d 61 74 in cost estimat
1c420 65 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 es */.
1c430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1c440 20 20 20 20 20 30 78 38 30 30 30 20 20 20 20 6e 0x8000 n
1c450 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 75 73 65 ot currently use
1c460 64 20 2a 2f 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 d */../* Allowed
1c470 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 20 66 return values f
1c480 72 6f 6d 20 73 71 6c 69 74 65 33 57 68 65 72 65 rom sqlite3Where
1c490 49 73 44 69 73 74 69 6e 63 74 28 29 0a 2a 2f 0a IsDistinct().*/.
1c4a0 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 #define WHERE_DI
1c4b0 53 54 49 4e 43 54 5f 4e 4f 4f 50 20 20 20 20 20 STINCT_NOOP
1c4c0 20 30 20 20 2f 2a 20 44 49 53 54 49 4e 43 54 20 0 /* DISTINCT
1c4d0 6b 65 79 77 6f 72 64 20 6e 6f 74 20 75 73 65 64 keyword not used
1c4e0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
1c4f0 45 5f 44 49 53 54 49 4e 43 54 5f 55 4e 49 51 55 E_DISTINCT_UNIQU
1c500 45 20 20 20 20 31 20 20 2f 2a 20 4e 6f 20 64 75 E 1 /* No du
1c510 70 6c 69 63 61 74 65 73 20 2a 2f 0a 23 64 65 66 plicates */.#def
1c520 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e ine WHERE_DISTIN
1c530 43 54 5f 4f 52 44 45 52 45 44 20 20 20 32 20 20 CT_ORDERED 2
1c540 2f 2a 20 41 6c 6c 20 64 75 70 6c 69 63 61 74 65 /* All duplicate
1c550 73 20 61 72 65 20 61 64 6a 61 63 65 6e 74 20 2a s are adjacent *
1c560 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1c570 44 49 53 54 49 4e 43 54 5f 55 4e 4f 52 44 45 52 DISTINCT_UNORDER
1c580 45 44 20 33 20 20 2f 2a 20 44 75 70 6c 69 63 61 ED 3 /* Duplica
1c590 74 65 73 20 61 72 65 20 73 63 61 74 74 65 72 65 tes are scattere
1c5a0 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 4e 61 d */../*.** A Na
1c5b0 6d 65 43 6f 6e 74 65 78 74 20 64 65 66 69 6e 65 meContext define
1c5c0 73 20 61 20 63 6f 6e 74 65 78 74 20 69 6e 20 77 s a context in w
1c5d0 68 69 63 68 20 74 6f 20 72 65 73 6f 6c 76 65 20 hich to resolve
1c5e0 74 61 62 6c 65 20 61 6e 64 20 63 6f 6c 75 6d 6e table and column
1c5f0 0a 2a 2a 20 6e 61 6d 65 73 2e 20 20 54 68 65 20 .** names. The
1c600 63 6f 6e 74 65 78 74 20 63 6f 6e 73 69 73 74 73 context consists
1c610 20 6f 66 20 61 20 6c 69 73 74 20 6f 66 20 74 61 of a list of ta
1c620 62 6c 65 73 20 28 74 68 65 20 70 53 72 63 4c 69 bles (the pSrcLi
1c630 73 74 29 20 66 69 65 6c 64 20 61 6e 64 0a 2a 2a st) field and.**
1c640 20 61 20 6c 69 73 74 20 6f 66 20 6e 61 6d 65 64 a list of named
1c650 20 65 78 70 72 65 73 73 69 6f 6e 20 28 70 45 4c expression (pEL
1c660 69 73 74 29 2e 20 20 54 68 65 20 6e 61 6d 65 64 ist). The named
1c670 20 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 expression list
1c680 20 6d 61 79 0a 2a 2a 20 62 65 20 4e 55 4c 4c 2e may.** be NULL.
1c690 20 20 54 68 65 20 70 53 72 63 20 63 6f 72 72 65 The pSrc corre
1c6a0 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 46 52 sponds to the FR
1c6b0 4f 4d 20 63 6c 61 75 73 65 20 6f 66 20 61 20 53 OM clause of a S
1c6c0 45 4c 45 43 54 20 6f 72 0a 2a 2a 20 74 6f 20 74 ELECT or.** to t
1c6d0 68 65 20 74 61 62 6c 65 20 62 65 69 6e 67 20 6f he table being o
1c6e0 70 65 72 61 74 65 64 20 6f 6e 20 62 79 20 49 4e perated on by IN
1c6f0 53 45 52 54 2c 20 55 50 44 41 54 45 2c 20 6f 72 SERT, UPDATE, or
1c700 20 44 45 4c 45 54 45 2e 20 20 54 68 65 0a 2a 2a DELETE. The.**
1c710 20 70 45 4c 69 73 74 20 63 6f 72 72 65 73 70 6f pEList correspo
1c720 6e 64 73 20 74 6f 20 74 68 65 20 72 65 73 75 6c nds to the resul
1c730 74 20 73 65 74 20 6f 66 20 61 20 53 45 4c 45 43 t set of a SELEC
1c740 54 20 61 6e 64 20 69 73 20 4e 55 4c 4c 20 66 6f T and is NULL fo
1c750 72 0a 2a 2a 20 6f 74 68 65 72 20 73 74 61 74 65 r.** other state
1c760 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 4e 61 6d ments..**.** Nam
1c770 65 43 6f 6e 74 65 78 74 73 20 63 61 6e 20 62 65 eContexts can be
1c780 20 6e 65 73 74 65 64 2e 20 20 57 68 65 6e 20 72 nested. When r
1c790 65 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 73 2c 20 esolving names,
1c7a0 74 68 65 20 69 6e 6e 65 72 2d 6d 6f 73 74 0a 2a the inner-most.*
1c7b0 2a 20 63 6f 6e 74 65 78 74 20 69 73 20 73 65 61 * context is sea
1c7c0 72 63 68 65 64 20 66 69 72 73 74 2e 20 20 49 66 rched first. If
1c7d0 20 6e 6f 20 6d 61 74 63 68 20 69 73 20 66 6f 75 no match is fou
1c7e0 6e 64 2c 20 74 68 65 20 6e 65 78 74 20 6f 75 74 nd, the next out
1c7f0 65 72 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 69 73 er.** context is
1c800 20 63 68 65 63 6b 65 64 2e 20 20 49 66 20 74 68 checked. If th
1c810 65 72 65 20 69 73 20 73 74 69 6c 6c 20 6e 6f 20 ere is still no
1c820 6d 61 74 63 68 2c 20 74 68 65 20 6e 65 78 74 20 match, the next
1c830 63 6f 6e 74 65 78 74 0a 2a 2a 20 69 73 20 63 68 context.** is ch
1c840 65 63 6b 65 64 2e 20 20 54 68 69 73 20 70 72 6f ecked. This pro
1c850 63 65 73 73 20 63 6f 6e 74 69 6e 75 65 73 20 75 cess continues u
1c860 6e 74 69 6c 20 65 69 74 68 65 72 20 61 20 6d 61 ntil either a ma
1c870 74 63 68 20 69 73 20 66 6f 75 6e 64 0a 2a 2a 20 tch is found.**
1c880 6f 72 20 61 6c 6c 20 63 6f 6e 74 65 78 74 73 20 or all contexts
1c890 61 72 65 20 63 68 65 63 6b 2e 20 20 57 68 65 6e are check. When
1c8a0 20 61 20 6d 61 74 63 68 20 69 73 20 66 6f 75 6e a match is foun
1c8b0 64 2c 20 74 68 65 20 6e 52 65 66 20 6d 65 6d 62 d, the nRef memb
1c8c0 65 72 20 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 6e er of.** the con
1c8d0 74 65 78 74 20 63 6f 6e 74 61 69 6e 69 6e 67 20 text containing
1c8e0 74 68 65 20 6d 61 74 63 68 20 69 73 20 69 6e 63 the match is inc
1c8f0 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 remented..**.**
1c900 45 61 63 68 20 73 75 62 71 75 65 72 79 20 67 65 Each subquery ge
1c910 74 73 20 61 20 6e 65 77 20 4e 61 6d 65 43 6f 6e ts a new NameCon
1c920 74 65 78 74 2e 20 20 54 68 65 20 70 4e 65 78 74 text. The pNext
1c930 20 66 69 65 6c 64 20 70 6f 69 6e 74 73 20 74 6f field points to
1c940 20 74 68 65 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 the.** NameCont
1c950 65 78 74 20 69 6e 20 74 68 65 20 70 61 72 65 6e ext in the paren
1c960 74 20 71 75 65 72 79 2e 20 20 54 68 75 73 20 74 t query. Thus t
1c970 68 65 20 70 72 6f 63 65 73 73 20 6f 66 20 73 63 he process of sc
1c980 61 6e 6e 69 6e 67 20 74 68 65 0a 2a 2a 20 4e 61 anning the.** Na
1c990 6d 65 43 6f 6e 74 65 78 74 20 6c 69 73 74 20 63 meContext list c
1c9a0 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 73 65 orresponds to se
1c9b0 61 72 63 68 69 6e 67 20 74 68 72 6f 75 67 68 20 arching through
1c9c0 73 75 63 63 65 73 73 69 76 65 6c 79 20 6f 75 74 successively out
1c9d0 65 72 0a 2a 2a 20 73 75 62 71 75 65 72 69 65 73 er.** subqueries
1c9e0 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 6d looking for a m
1c9f0 61 74 63 68 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 atch..*/.struct
1ca00 4e 61 6d 65 43 6f 6e 74 65 78 74 20 7b 0a 20 20 NameContext {.
1ca10 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 Parse *pParse;
1ca20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 72 73 /* The pars
1ca30 65 72 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 er */. SrcList
1ca40 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 2f 2a 20 *pSrcList; /*
1ca50 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 61 62 6c One or more tabl
1ca60 65 73 20 75 73 65 64 20 74 6f 20 72 65 73 6f 6c es used to resol
1ca70 76 65 20 6e 61 6d 65 73 20 2a 2f 0a 20 20 75 6e ve names */. un
1ca80 69 6f 6e 20 7b 0a 20 20 20 20 45 78 70 72 4c 69 ion {. ExprLi
1ca90 73 74 20 2a 70 45 4c 69 73 74 3b 20 20 20 20 2f st *pEList; /
1caa0 2a 20 4f 70 74 69 6f 6e 61 6c 20 6c 69 73 74 20 * Optional list
1cab0 6f 66 20 72 65 73 75 6c 74 2d 73 65 74 20 63 6f of result-set co
1cac0 6c 75 6d 6e 73 20 2a 2f 0a 20 20 20 20 41 67 67 lumns */. Agg
1cad0 49 6e 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 Info *pAggInfo;
1cae0 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e /* Information
1caf0 20 61 62 6f 75 74 20 61 67 67 72 65 67 61 74 65 about aggregate
1cb00 73 20 61 74 20 74 68 69 73 20 6c 65 76 65 6c 20 s at this level
1cb10 2a 2f 0a 20 20 20 20 55 70 73 65 72 74 20 2a 70 */. Upsert *p
1cb20 55 70 73 65 72 74 3b 20 20 20 20 20 2f 2a 20 4f Upsert; /* O
1cb30 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 N CONFLICT claus
1cb40 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 e information fr
1cb50 6f 6d 20 61 6e 20 75 70 73 65 72 74 20 2a 2f 0a om an upsert */.
1cb60 20 20 7d 20 75 4e 43 3b 0a 20 20 4e 61 6d 65 43 } uNC;. NameC
1cb70 6f 6e 74 65 78 74 20 2a 70 4e 65 78 74 3b 20 20 ontext *pNext;
1cb80 2f 2a 20 4e 65 78 74 20 6f 75 74 65 72 20 6e 61 /* Next outer na
1cb90 6d 65 20 63 6f 6e 74 65 78 74 2e 20 20 4e 55 4c me context. NUL
1cba0 4c 20 66 6f 72 20 6f 75 74 65 72 6d 6f 73 74 20 L for outermost
1cbb0 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 */. int nRef;
1cbc0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1cbd0 62 65 72 20 6f 66 20 6e 61 6d 65 73 20 72 65 73 ber of names res
1cbe0 6f 6c 76 65 64 20 62 79 20 74 68 69 73 20 63 6f olved by this co
1cbf0 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 6e ntext */. int n
1cc00 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 Err;
1cc10 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 72 72 /* Number of err
1cc20 6f 72 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 ors encountered
1cc30 77 68 69 6c 65 20 72 65 73 6f 6c 76 69 6e 67 20 while resolving
1cc40 6e 61 6d 65 73 20 2a 2f 0a 20 20 75 31 36 20 6e names */. u16 n
1cc50 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 cFlags;
1cc60 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 /* Zero or more
1cc70 4e 43 5f 2a 20 66 6c 61 67 73 20 64 65 66 69 6e NC_* flags defin
1cc80 65 64 20 62 65 6c 6f 77 20 2a 2f 0a 20 20 53 65 ed below */. Se
1cc90 6c 65 63 74 20 2a 70 57 69 6e 53 65 6c 65 63 74 lect *pWinSelect
1cca0 3b 20 20 2f 2a 20 53 45 4c 45 43 54 20 73 74 61 ; /* SELECT sta
1ccb0 74 65 6d 65 6e 74 20 66 6f 72 20 61 6e 79 20 77 tement for any w
1ccc0 69 6e 64 6f 77 20 66 75 6e 63 74 69 6f 6e 73 20 indow functions
1ccd0 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c */.};../*.** All
1cce0 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 owed values for
1ccf0 74 68 65 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2c the NameContext,
1cd00 20 6e 63 46 6c 61 67 73 20 66 69 65 6c 64 2e 0a ncFlags field..
1cd10 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e 73 **.** Value cons
1cd20 74 72 61 69 6e 74 73 20 28 61 6c 6c 20 63 68 65 traints (all che
1cd30 63 6b 65 64 20 76 69 61 20 61 73 73 65 72 74 28 cked via assert(
1cd40 29 29 3a 0a 2a 2a 20 20 20 20 4e 43 5f 48 61 73 )):.** NC_Has
1cd50 41 67 67 20 20 20 20 3d 3d 20 53 46 5f 48 61 73 Agg == SF_Has
1cd60 41 67 67 0a 2a 2a 20 20 20 20 4e 43 5f 4d 69 6e Agg.** NC_Min
1cd70 4d 61 78 41 67 67 20 3d 3d 20 53 46 5f 4d 69 6e MaxAgg == SF_Min
1cd80 4d 61 78 41 67 67 20 3d 3d 20 53 51 4c 49 54 45 MaxAgg == SQLITE
1cd90 5f 46 55 4e 43 5f 4d 49 4e 4d 41 58 0a 2a 2a 0a _FUNC_MINMAX.**.
1cda0 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 41 6c */.#define NC_Al
1cdb0 6c 6f 77 41 67 67 20 20 30 78 30 30 30 31 20 20 lowAgg 0x0001
1cdc0 2f 2a 20 41 67 67 72 65 67 61 74 65 20 66 75 6e /* Aggregate fun
1cdd0 63 74 69 6f 6e 73 20 61 72 65 20 61 6c 6c 6f 77 ctions are allow
1cde0 65 64 20 68 65 72 65 20 2a 2f 0a 23 64 65 66 69 ed here */.#defi
1cdf0 6e 65 20 4e 43 5f 50 61 72 74 49 64 78 20 20 20 ne NC_PartIdx
1ce00 30 78 30 30 30 32 20 20 2f 2a 20 54 72 75 65 20 0x0002 /* True
1ce10 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 61 20 70 if resolving a p
1ce20 61 72 74 69 61 6c 20 69 6e 64 65 78 20 57 48 45 artial index WHE
1ce30 52 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 RE */.#define NC
1ce40 5f 49 73 43 68 65 63 6b 20 20 20 30 78 30 30 30 _IsCheck 0x000
1ce50 34 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 65 4 /* True if re
1ce60 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 73 20 69 6e solving names in
1ce70 20 61 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 a CHECK constra
1ce80 69 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e int */.#define N
1ce90 43 5f 49 6e 41 67 67 46 75 6e 63 20 30 78 30 30 C_InAggFunc 0x00
1cea0 30 38 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 08 /* True if a
1ceb0 6e 61 6c 79 7a 69 6e 67 20 61 72 67 75 6d 65 6e nalyzing argumen
1cec0 74 73 20 74 6f 20 61 6e 20 61 67 67 20 66 75 6e ts to an agg fun
1ced0 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f c */.#define NC_
1cee0 48 61 73 41 67 67 20 20 20 20 30 78 30 30 31 30 HasAgg 0x0010
1cef0 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 65 /* One or more
1cf00 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 aggregate funct
1cf10 69 6f 6e 73 20 73 65 65 6e 20 2a 2f 0a 23 64 65 ions seen */.#de
1cf20 66 69 6e 65 20 4e 43 5f 49 64 78 45 78 70 72 20 fine NC_IdxExpr
1cf30 20 20 30 78 30 30 32 30 20 20 2f 2a 20 54 72 75 0x0020 /* Tru
1cf40 65 20 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 63 e if resolving c
1cf50 6f 6c 75 6d 6e 73 20 6f 66 20 43 52 45 41 54 45 olumns of CREATE
1cf60 20 49 4e 44 45 58 20 2a 2f 0a 23 64 65 66 69 6e INDEX */.#defin
1cf70 65 20 4e 43 5f 56 61 72 53 65 6c 65 63 74 20 30 e NC_VarSelect 0
1cf80 78 30 30 34 30 20 20 2f 2a 20 41 20 63 6f 72 72 x0040 /* A corr
1cf90 65 6c 61 74 65 64 20 73 75 62 71 75 65 72 79 20 elated subquery
1cfa0 68 61 73 20 62 65 65 6e 20 73 65 65 6e 20 2a 2f has been seen */
1cfb0 0a 23 64 65 66 69 6e 65 20 4e 43 5f 55 45 4c 69 .#define NC_UELi
1cfc0 73 74 20 20 20 20 30 78 30 30 38 30 20 20 2f 2a st 0x0080 /*
1cfd0 20 54 72 75 65 20 69 66 20 75 4e 43 2e 70 45 4c True if uNC.pEL
1cfe0 69 73 74 20 69 73 20 75 73 65 64 20 2a 2f 0a 23 ist is used */.#
1cff0 64 65 66 69 6e 65 20 4e 43 5f 55 41 67 67 49 6e define NC_UAggIn
1d000 66 6f 20 20 30 78 30 31 30 30 20 20 2f 2a 20 54 fo 0x0100 /* T
1d010 72 75 65 20 69 66 20 75 4e 43 2e 70 41 67 67 49 rue if uNC.pAggI
1d020 6e 66 6f 20 69 73 20 75 73 65 64 20 2a 2f 0a 23 nfo is used */.#
1d030 64 65 66 69 6e 65 20 4e 43 5f 55 55 70 73 65 72 define NC_UUpser
1d040 74 20 20 20 30 78 30 32 30 30 20 20 2f 2a 20 54 t 0x0200 /* T
1d050 72 75 65 20 69 66 20 75 4e 43 2e 70 55 70 73 65 rue if uNC.pUpse
1d060 72 74 20 69 73 20 75 73 65 64 20 2a 2f 0a 23 64 rt is used */.#d
1d070 65 66 69 6e 65 20 4e 43 5f 4d 69 6e 4d 61 78 41 efine NC_MinMaxA
1d080 67 67 20 30 78 31 30 30 30 20 20 2f 2a 20 6d 69 gg 0x1000 /* mi
1d090 6e 2f 6d 61 78 20 61 67 67 72 65 67 61 74 65 73 n/max aggregates
1d0a0 20 73 65 65 6e 2e 20 20 53 65 65 20 6e 6f 74 65 seen. See note
1d0b0 20 61 62 6f 76 65 20 2a 2f 0a 23 64 65 66 69 6e above */.#defin
1d0c0 65 20 4e 43 5f 43 6f 6d 70 6c 65 78 20 20 20 30 e NC_Complex 0
1d0d0 78 32 30 30 30 20 20 2f 2a 20 54 72 75 65 20 69 x2000 /* True i
1d0e0 66 20 61 20 66 75 6e 63 74 69 6f 6e 20 6f 72 20 f a function or
1d0f0 73 75 62 71 75 65 72 79 20 73 65 65 6e 20 2a 2f subquery seen */
1d100 0a 23 64 65 66 69 6e 65 20 4e 43 5f 41 6c 6c 6f .#define NC_Allo
1d110 77 57 69 6e 20 20 30 78 34 30 30 30 20 20 2f 2a wWin 0x4000 /*
1d120 20 57 69 6e 64 6f 77 20 66 75 6e 63 74 69 6f 6e Window function
1d130 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 68 65 s are allowed he
1d140 72 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 re */../*.** An
1d150 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
1d160 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 6a 65 63 74 following object
1d170 20 64 65 73 63 72 69 62 65 73 20 61 20 73 69 6e describes a sin
1d180 67 6c 65 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 0a gle ON CONFLICT.
1d190 2a 2a 20 63 6c 61 75 73 65 20 69 6e 20 61 6e 20 ** clause in an
1d1a0 75 70 73 65 72 74 2e 0a 2a 2a 0a 2a 2a 20 54 68 upsert..**.** Th
1d1b0 65 20 70 55 70 73 65 72 74 54 61 72 67 65 74 20 e pUpsertTarget
1d1c0 66 69 65 6c 64 20 69 73 20 6f 6e 6c 79 20 73 65 field is only se
1d1d0 74 20 69 66 20 74 68 65 20 4f 4e 20 43 4f 4e 46 t if the ON CONF
1d1e0 4c 49 43 54 20 63 6c 61 75 73 65 20 69 6e 63 6c LICT clause incl
1d1f0 75 64 65 73 0a 2a 2a 20 63 6f 6e 66 6c 69 63 74 udes.** conflict
1d200 2d 74 61 72 67 65 74 20 63 6c 61 75 73 65 2e 20 -target clause.
1d210 20 28 49 6e 20 22 4f 4e 20 43 4f 4e 46 4c 49 43 (In "ON CONFLIC
1d220 54 28 61 2c 62 29 22 20 74 68 65 20 22 28 61 2c T(a,b)" the "(a,
1d230 62 29 22 20 69 73 20 74 68 65 0a 2a 2a 20 63 6f b)" is the.** co
1d240 6e 66 6c 69 63 74 2d 74 61 72 67 65 74 20 63 6c nflict-target cl
1d250 61 75 73 65 2e 29 20 20 54 68 65 20 70 55 70 73 ause.) The pUps
1d260 65 72 74 54 61 72 67 65 74 57 68 65 72 65 20 69 ertTargetWhere i
1d270 73 20 74 68 65 20 6f 70 74 69 6f 6e 61 6c 0a 2a s the optional.*
1d280 2a 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 75 * WHERE clause u
1d290 73 65 64 20 74 6f 20 69 64 65 6e 74 69 66 79 20 sed to identify
1d2a0 70 61 72 74 69 61 6c 20 75 6e 69 71 75 65 20 69 partial unique i
1d2b0 6e 64 65 78 65 73 2e 0a 2a 2a 0a 2a 2a 20 70 55 ndexes..**.** pU
1d2c0 70 73 65 72 74 53 65 74 20 69 73 20 74 68 65 20 psertSet is the
1d2d0 6c 69 73 74 20 6f 66 20 63 6f 6c 75 6d 6e 3d 65 list of column=e
1d2e0 78 70 72 20 74 65 72 6d 73 20 6f 66 20 74 68 65 xpr terms of the
1d2f0 20 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e UPDATE statemen
1d300 74 2e 20 0a 2a 2a 20 54 68 65 20 70 55 70 73 65 t. .** The pUpse
1d310 72 74 53 65 74 20 66 69 65 6c 64 20 69 73 20 4e rtSet field is N
1d320 55 4c 4c 20 66 6f 72 20 61 20 4f 4e 20 43 4f 4e ULL for a ON CON
1d330 46 4c 49 43 54 20 44 4f 20 4e 4f 54 48 49 4e 47 FLICT DO NOTHING
1d340 2e 20 20 54 68 65 0a 2a 2a 20 70 55 70 73 65 72 . The.** pUpser
1d350 74 57 68 65 72 65 20 69 73 20 74 68 65 20 57 48 tWhere is the WH
1d360 45 52 45 20 63 6c 61 75 73 65 20 66 6f 72 20 74 ERE clause for t
1d370 68 65 20 55 50 44 41 54 45 20 61 6e 64 20 69 73 he UPDATE and is
1d380 20 4e 55 4c 4c 20 69 66 20 74 68 65 0a 2a 2a 20 NULL if the.**
1d390 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 WHERE clause is
1d3a0 6f 6d 69 74 74 65 64 2e 0a 2a 2f 0a 73 74 72 75 omitted..*/.stru
1d3b0 63 74 20 55 70 73 65 72 74 20 7b 0a 20 20 45 78 ct Upsert {. Ex
1d3c0 70 72 4c 69 73 74 20 2a 70 55 70 73 65 72 74 54 prList *pUpsertT
1d3d0 61 72 67 65 74 3b 20 20 2f 2a 20 4f 70 74 69 6f arget; /* Optio
1d3e0 6e 61 6c 20 64 65 73 63 72 69 70 74 69 6f 6e 20 nal description
1d3f0 6f 66 20 63 6f 6e 66 6c 69 63 74 69 6e 67 20 69 of conflicting i
1d400 6e 64 65 78 20 2a 2f 0a 20 20 45 78 70 72 20 2a ndex */. Expr *
1d410 70 55 70 73 65 72 74 54 61 72 67 65 74 57 68 65 pUpsertTargetWhe
1d420 72 65 3b 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 re; /* WHERE cla
1d430 75 73 65 20 66 6f 72 20 70 61 72 74 69 61 6c 20 use for partial
1d440 69 6e 64 65 78 20 74 61 72 67 65 74 73 20 2a 2f index targets */
1d450 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 55 70 . ExprList *pUp
1d460 73 65 72 74 53 65 74 3b 20 20 20 20 20 2f 2a 20 sertSet; /*
1d470 54 68 65 20 53 45 54 20 63 6c 61 75 73 65 20 66 The SET clause f
1d480 72 6f 6d 20 61 6e 20 4f 4e 20 43 4f 4e 46 4c 49 rom an ON CONFLI
1d490 43 54 20 55 50 44 41 54 45 20 2a 2f 0a 20 20 45 CT UPDATE */. E
1d4a0 78 70 72 20 2a 70 55 70 73 65 72 74 57 68 65 72 xpr *pUpsertWher
1d4b0 65 3b 20 20 20 20 20 20 20 2f 2a 20 57 48 45 52 e; /* WHER
1d4c0 45 20 63 6c 61 75 73 65 20 66 6f 72 20 74 68 65 E clause for the
1d4d0 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 55 50 44 ON CONFLICT UPD
1d4e0 41 54 45 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 ATE */. /* The
1d4f0 66 69 65 6c 64 73 20 61 62 6f 76 65 20 63 6f 6d fields above com
1d500 70 72 69 73 65 20 74 68 65 20 70 61 72 73 65 20 prise the parse
1d510 74 72 65 65 20 66 6f 72 20 74 68 65 20 75 70 73 tree for the ups
1d520 65 72 74 20 63 6c 61 75 73 65 2e 0a 20 20 2a 2a ert clause.. **
1d530 20 54 68 65 20 66 69 65 6c 64 73 20 62 65 6c 6f The fields belo
1d540 77 20 61 72 65 20 75 73 65 64 20 74 6f 20 74 72 w are used to tr
1d550 61 6e 73 66 65 72 20 69 6e 66 6f 72 6d 61 74 69 ansfer informati
1d560 6f 6e 20 66 72 6f 6d 20 74 68 65 20 49 4e 53 45 on from the INSE
1d570 52 54 0a 20 20 2a 2a 20 70 72 6f 63 65 73 73 69 RT. ** processi
1d580 6e 67 20 64 6f 77 6e 20 69 6e 74 6f 20 74 68 65 ng down into the
1d590 20 55 50 44 41 54 45 20 70 72 6f 63 65 73 73 69 UPDATE processi
1d5a0 6e 67 20 77 68 69 6c 65 20 67 65 6e 65 72 61 74 ng while generat
1d5b0 69 6e 67 20 63 6f 64 65 2e 0a 20 20 2a 2a 20 55 ing code.. ** U
1d5c0 70 73 65 72 74 20 6f 77 6e 73 20 74 68 65 20 6d psert owns the m
1d5d0 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 65 64 20 emory allocated
1d5e0 61 62 6f 76 65 2c 20 62 75 74 20 6e 6f 74 20 74 above, but not t
1d5f0 68 65 20 6d 65 6d 6f 72 79 20 62 65 6c 6f 77 2e he memory below.
1d600 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 55 70 */. Index *pUp
1d610 73 65 72 74 49 64 78 3b 20 20 20 20 20 20 20 20 sertIdx;
1d620 2f 2a 20 43 6f 6e 73 74 72 61 69 6e 74 20 74 68 /* Constraint th
1d630 61 74 20 70 55 70 73 65 72 74 54 61 72 67 65 74 at pUpsertTarget
1d640 20 69 64 65 6e 74 69 66 69 65 73 20 2a 2f 0a 20 identifies */.
1d650 20 53 72 63 4c 69 73 74 20 2a 70 55 70 73 65 72 SrcList *pUpser
1d660 74 53 72 63 3b 20 20 20 20 20 20 2f 2a 20 54 61 tSrc; /* Ta
1d670 62 6c 65 20 74 6f 20 62 65 20 75 70 64 61 74 65 ble to be update
1d680 64 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 44 61 d */. int regDa
1d690 74 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ta;
1d6a0 20 2f 2a 20 46 69 72 73 74 20 72 65 67 69 73 74 /* First regist
1d6b0 65 72 20 68 6f 6c 64 69 6e 67 20 61 72 72 61 79 er holding array
1d6c0 20 6f 66 20 56 41 4c 55 45 53 20 2a 2f 0a 20 20 of VALUES */.
1d6d0 69 6e 74 20 69 44 61 74 61 43 75 72 3b 20 20 20 int iDataCur;
1d6e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
1d6f0 65 78 20 6f 66 20 74 68 65 20 64 61 74 61 20 63 ex of the data c
1d700 75 72 73 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 69 ursor */. int i
1d710 49 64 78 43 75 72 3b 20 20 20 20 20 20 20 20 20 IdxCur;
1d720 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
1d730 20 74 68 65 20 66 69 72 73 74 20 69 6e 64 65 78 the first index
1d740 20 63 75 72 73 6f 72 20 2a 2f 0a 7d 3b 0a 0a 2f cursor */.};../
1d750 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
1d760 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
1d770 67 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 g structure cont
1d780 61 69 6e 73 20 61 6c 6c 20 69 6e 66 6f 72 6d 61 ains all informa
1d790 74 69 6f 6e 0a 2a 2a 20 6e 65 65 64 65 64 20 74 tion.** needed t
1d7a0 6f 20 67 65 6e 65 72 61 74 65 20 63 6f 64 65 20 o generate code
1d7b0 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 53 45 4c for a single SEL
1d7c0 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a ECT statement..*
1d7d0 2a 0a 2a 2a 20 53 65 65 20 74 68 65 20 68 65 61 *.** See the hea
1d7e0 64 65 72 20 63 6f 6d 6d 65 6e 74 20 6f 6e 20 74 der comment on t
1d7f0 68 65 20 63 6f 6d 70 75 74 65 4c 69 6d 69 74 52 he computeLimitR
1d800 65 67 69 73 74 65 72 73 28 29 20 72 6f 75 74 69 egisters() routi
1d810 6e 65 20 66 6f 72 20 61 0a 2a 2a 20 64 65 74 61 ne for a.** deta
1d820 69 6c 65 64 20 64 65 73 63 72 69 70 74 69 6f 6e iled description
1d830 20 6f 66 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 of the meaning
1d840 6f 66 20 74 68 65 20 69 4c 69 6d 69 74 20 61 6e of the iLimit an
1d850 64 20 69 4f 66 66 73 65 74 20 66 69 65 6c 64 73 d iOffset fields
1d860 2e 0a 2a 2a 0a 2a 2a 20 61 64 64 72 4f 70 65 6e ..**.** addrOpen
1d870 45 70 68 6d 5b 5d 20 65 6e 74 72 69 65 73 20 63 Ephm[] entries c
1d880 6f 6e 74 61 69 6e 20 74 68 65 20 61 64 64 72 65 ontain the addre
1d890 73 73 20 6f 66 20 4f 50 5f 4f 70 65 6e 45 70 68 ss of OP_OpenEph
1d8a0 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 73 2e 0a emeral opcodes..
1d8b0 2a 2a 20 54 68 65 73 65 20 61 64 64 72 65 73 73 ** These address
1d8c0 65 73 20 6d 75 73 74 20 62 65 20 73 74 6f 72 65 es must be store
1d8d0 64 20 73 6f 20 74 68 61 74 20 77 65 20 63 61 6e d so that we can
1d8e0 20 67 6f 20 62 61 63 6b 20 61 6e 64 20 66 69 6c go back and fil
1d8f0 6c 20 69 6e 0a 2a 2a 20 74 68 65 20 50 34 5f 4b l in.** the P4_K
1d900 45 59 49 4e 46 4f 20 61 6e 64 20 50 32 20 70 61 EYINFO and P2 pa
1d910 72 61 6d 65 74 65 72 73 20 6c 61 74 65 72 2e 20 rameters later.
1d920 20 4e 65 69 74 68 65 72 20 74 68 65 20 4b 65 79 Neither the Key
1d930 49 6e 66 6f 20 6e 6f 72 0a 2a 2a 20 74 68 65 20 Info nor.** the
1d940 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e number of column
1d950 73 20 69 6e 20 50 32 20 63 61 6e 20 62 65 20 63 s in P2 can be c
1d960 6f 6d 70 75 74 65 64 20 61 74 20 74 68 65 20 73 omputed at the s
1d970 61 6d 65 20 74 69 6d 65 0a 2a 2a 20 61 73 20 74 ame time.** as t
1d980 68 65 20 4f 50 5f 4f 70 65 6e 45 70 68 6d 20 69 he OP_OpenEphm i
1d990 6e 73 74 72 75 63 74 69 6f 6e 20 69 73 20 63 6f nstruction is co
1d9a0 64 65 64 20 62 65 63 61 75 73 65 20 6e 6f 74 0a ded because not.
1d9b0 2a 2a 20 65 6e 6f 75 67 68 20 69 6e 66 6f 72 6d ** enough inform
1d9c0 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 ation about the
1d9d0 63 6f 6d 70 6f 75 6e 64 20 71 75 65 72 79 20 69 compound query i
1d9e0 73 20 6b 6e 6f 77 6e 20 61 74 20 74 68 61 74 20 s known at that
1d9f0 70 6f 69 6e 74 2e 0a 2a 2a 20 54 68 65 20 4b 65 point..** The Ke
1da00 79 49 6e 66 6f 20 66 6f 72 20 61 64 64 72 4f 70 yInfo for addrOp
1da10 65 6e 54 72 61 6e 5b 30 5d 20 61 6e 64 20 5b 31 enTran[0] and [1
1da20 5d 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6c 6c 61 ] contains colla
1da30 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 0a 2a ting sequences.*
1da40 2a 20 66 6f 72 20 74 68 65 20 72 65 73 75 6c 74 * for the result
1da50 20 73 65 74 2e 20 20 54 68 65 20 4b 65 79 49 6e set. The KeyIn
1da60 66 6f 20 66 6f 72 20 61 64 64 72 4f 70 65 6e 45 fo for addrOpenE
1da70 70 68 6d 5b 32 5d 20 63 6f 6e 74 61 69 6e 73 20 phm[2] contains
1da80 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73 65 71 collating.** seq
1da90 75 65 6e 63 65 73 20 66 6f 72 20 74 68 65 20 4f uences for the O
1daa0 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2e 0a RDER BY clause..
1dab0 2a 2f 0a 73 74 72 75 63 74 20 53 65 6c 65 63 74 */.struct Select
1dac0 20 7b 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 {. ExprList *p
1dad0 45 4c 69 73 74 3b 20 20 20 20 20 20 2f 2a 20 54 EList; /* T
1dae0 68 65 20 66 69 65 6c 64 73 20 6f 66 20 74 68 65 he fields of the
1daf0 20 72 65 73 75 6c 74 20 2a 2f 0a 20 20 75 38 20 result */. u8
1db00 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 op;
1db10 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 3a 20 54 /* One of: T
1db20 4b 5f 55 4e 49 4f 4e 20 54 4b 5f 41 4c 4c 20 54 K_UNION TK_ALL T
1db30 4b 5f 49 4e 54 45 52 53 45 43 54 20 54 4b 5f 45 K_INTERSECT TK_E
1db40 58 43 45 50 54 20 2a 2f 0a 20 20 4c 6f 67 45 73 XCEPT */. LogEs
1db50 74 20 6e 53 65 6c 65 63 74 52 6f 77 3b 20 20 20 t nSelectRow;
1db60 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 6e /* Estimated n
1db70 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20 umber of result
1db80 72 6f 77 73 20 2a 2f 0a 20 20 75 33 32 20 73 65 rows */. u32 se
1db90 6c 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 lFlags;
1dba0 20 2f 2a 20 56 61 72 69 6f 75 73 20 53 46 5f 2a /* Various SF_*
1dbb0 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 69 6e 74 values */. int
1dbc0 20 69 4c 69 6d 69 74 2c 20 69 4f 66 66 73 65 74 iLimit, iOffset
1dbd0 3b 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 72 65 ; /* Memory re
1dbe0 67 69 73 74 65 72 73 20 68 6f 6c 64 69 6e 67 20 gisters holding
1dbf0 4c 49 4d 49 54 20 26 20 4f 46 46 53 45 54 20 63 LIMIT & OFFSET c
1dc00 6f 75 6e 74 65 72 73 20 2a 2f 0a 20 20 75 33 32 ounters */. u32
1dc10 20 73 65 6c 49 64 3b 20 20 20 20 20 20 20 20 20 selId;
1dc20 20 20 20 20 2f 2a 20 55 6e 69 71 75 65 20 69 64 /* Unique id
1dc30 65 6e 74 69 66 69 65 72 20 6e 75 6d 62 65 72 20 entifier number
1dc40 66 6f 72 20 74 68 69 73 20 53 45 4c 45 43 54 20 for this SELECT
1dc50 2a 2f 0a 20 20 69 6e 74 20 61 64 64 72 4f 70 65 */. int addrOpe
1dc60 6e 45 70 68 6d 5b 32 5d 3b 20 20 20 2f 2a 20 4f nEphm[2]; /* O
1dc70 50 5f 4f 70 65 6e 45 70 68 65 6d 20 6f 70 63 6f P_OpenEphem opco
1dc80 64 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 des related to t
1dc90 68 69 73 20 73 65 6c 65 63 74 20 2a 2f 0a 20 20 his select */.
1dca0 53 72 63 4c 69 73 74 20 2a 70 53 72 63 3b 20 20 SrcList *pSrc;
1dcb0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 52 /* The FR
1dcc0 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 OM clause */. E
1dcd0 78 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 xpr *pWhere;
1dce0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 /* The WHE
1dcf0 52 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 RE clause */. E
1dd00 78 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 xprList *pGroupB
1dd10 79 3b 20 20 20 20 2f 2a 20 54 68 65 20 47 52 4f y; /* The GRO
1dd20 55 50 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a UP BY clause */.
1dd30 20 20 45 78 70 72 20 2a 70 48 61 76 69 6e 67 3b Expr *pHaving;
1dd40 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
1dd50 48 41 56 49 4e 47 20 63 6c 61 75 73 65 20 2a 2f HAVING clause */
1dd60 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 . ExprList *pOr
1dd70 64 65 72 42 79 3b 20 20 20 20 2f 2a 20 54 68 65 derBy; /* The
1dd80 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 ORDER BY clause
1dd90 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 50 */. Select *pP
1dda0 72 69 6f 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 rior; /*
1ddb0 50 72 69 6f 72 20 73 65 6c 65 63 74 20 69 6e 20 Prior select in
1ddc0 61 20 63 6f 6d 70 6f 75 6e 64 20 73 65 6c 65 63 a compound selec
1ddd0 74 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 t statement */.
1dde0 20 53 65 6c 65 63 74 20 2a 70 4e 65 78 74 3b 20 Select *pNext;
1ddf0 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 /* Next
1de00 73 65 6c 65 63 74 20 74 6f 20 74 68 65 20 6c 65 select to the le
1de10 66 74 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 ft in a compound
1de20 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 4c 69 6d */. Expr *pLim
1de30 69 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 it; /*
1de40 4c 49 4d 49 54 20 65 78 70 72 65 73 73 69 6f 6e LIMIT expression
1de50 2e 20 4e 55 4c 4c 20 6d 65 61 6e 73 20 6e 6f 74 . NULL means not
1de60 20 75 73 65 64 2e 20 2a 2f 0a 20 20 57 69 74 68 used. */. With
1de70 20 2a 70 57 69 74 68 3b 20 20 20 20 20 20 20 20 *pWith;
1de80 20 20 20 2f 2a 20 57 49 54 48 20 63 6c 61 75 73 /* WITH claus
1de90 65 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 e attached to th
1dea0 69 73 20 73 65 6c 65 63 74 2e 20 4f 72 20 4e 55 is select. Or NU
1deb0 4c 4c 2e 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 LL. */.#ifndef S
1dec0 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 49 4e 44 4f QLITE_OMIT_WINDO
1ded0 57 46 55 4e 43 0a 20 20 57 69 6e 64 6f 77 20 2a WFUNC. Window *
1dee0 70 57 69 6e 3b 20 20 20 20 20 20 20 20 20 20 2f pWin; /
1def0 2a 20 4c 69 73 74 20 6f 66 20 77 69 6e 64 6f 77 * List of window
1df00 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 functions */.
1df10 57 69 6e 64 6f 77 20 2a 70 57 69 6e 44 65 66 6e Window *pWinDefn
1df20 3b 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f ; /* List o
1df30 66 20 6e 61 6d 65 64 20 77 69 6e 64 6f 77 20 64 f named window d
1df40 65 66 69 6e 69 74 69 6f 6e 73 20 2a 2f 0a 23 65 efinitions */.#e
1df50 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 ndif.};../*.** A
1df60 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f llowed values fo
1df70 72 20 53 65 6c 65 63 74 2e 73 65 6c 46 6c 61 67 r Select.selFlag
1df80 73 2e 20 20 54 68 65 20 22 53 46 22 20 70 72 65 s. The "SF" pre
1df90 66 69 78 20 73 74 61 6e 64 73 20 66 6f 72 0a 2a fix stands for.*
1dfa0 2a 20 22 53 65 6c 65 63 74 20 46 6c 61 67 22 2e * "Select Flag".
1dfb0 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e .**.** Value con
1dfc0 73 74 72 61 69 6e 74 73 20 28 61 6c 6c 20 63 68 straints (all ch
1dfd0 65 63 6b 65 64 20 76 69 61 20 61 73 73 65 72 74 ecked via assert
1dfe0 28 29 29 0a 2a 2a 20 20 20 20 20 53 46 5f 48 61 ()).** SF_Ha
1dff0 73 41 67 67 20 20 20 20 20 3d 3d 20 4e 43 5f 48 sAgg == NC_H
1e000 61 73 41 67 67 0a 2a 2a 20 20 20 20 20 53 46 5f asAgg.** SF_
1e010 4d 69 6e 4d 61 78 41 67 67 20 20 3d 3d 20 4e 43 MinMaxAgg == NC
1e020 5f 4d 69 6e 4d 61 78 41 67 67 20 20 20 20 20 3d _MinMaxAgg =
1e030 3d 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4d 49 = SQLITE_FUNC_MI
1e040 4e 4d 41 58 0a 2a 2a 20 20 20 20 20 53 46 5f 46 NMAX.** SF_F
1e050 69 78 65 64 4c 69 6d 69 74 20 3d 3d 20 57 48 45 ixedLimit == WHE
1e060 52 45 5f 55 53 45 5f 4c 49 4d 49 54 0a 2a 2f 0a RE_USE_LIMIT.*/.
1e070 23 64 65 66 69 6e 65 20 53 46 5f 44 69 73 74 69 #define SF_Disti
1e080 6e 63 74 20 20 20 20 20 20 20 30 78 30 30 30 30 nct 0x0000
1e090 31 20 20 2f 2a 20 4f 75 74 70 75 74 20 73 68 6f 1 /* Output sho
1e0a0 75 6c 64 20 62 65 20 44 49 53 54 49 4e 43 54 20 uld be DISTINCT
1e0b0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 41 6c */.#define SF_Al
1e0c0 6c 20 20 20 20 20 20 20 20 20 20 20 20 30 78 30 l 0x0
1e0d0 30 30 30 32 20 20 2f 2a 20 49 6e 63 6c 75 64 65 0002 /* Include
1e0e0 73 20 74 68 65 20 41 4c 4c 20 6b 65 79 77 6f 72 s the ALL keywor
1e0f0 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f d */.#define SF_
1e100 52 65 73 6f 6c 76 65 64 20 20 20 20 20 20 20 30 Resolved 0
1e110 78 30 30 30 30 34 20 20 2f 2a 20 49 64 65 6e 74 x00004 /* Ident
1e120 69 66 69 65 72 73 20 68 61 76 65 20 62 65 65 6e ifiers have been
1e130 20 72 65 73 6f 6c 76 65 64 20 2a 2f 0a 23 64 65 resolved */.#de
1e140 66 69 6e 65 20 53 46 5f 41 67 67 72 65 67 61 74 fine SF_Aggregat
1e150 65 20 20 20 20 20 20 30 78 30 30 30 30 38 20 20 e 0x00008
1e160 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 61 67 67 20 /* Contains agg
1e170 66 75 6e 63 74 69 6f 6e 73 20 6f 72 20 61 20 47 functions or a G
1e180 52 4f 55 50 20 42 59 20 2a 2f 0a 23 64 65 66 69 ROUP BY */.#defi
1e190 6e 65 20 53 46 5f 48 61 73 41 67 67 20 20 20 20 ne SF_HasAgg
1e1a0 20 20 20 20 20 30 78 30 30 30 31 30 20 20 2f 2a 0x00010 /*
1e1b0 20 43 6f 6e 74 61 69 6e 73 20 61 67 67 72 65 67 Contains aggreg
1e1c0 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f ate functions */
1e1d0 0a 23 64 65 66 69 6e 65 20 53 46 5f 55 73 65 73 .#define SF_Uses
1e1e0 45 70 68 65 6d 65 72 61 6c 20 20 30 78 30 30 30 Ephemeral 0x000
1e1f0 32 30 20 20 2f 2a 20 55 73 65 73 20 74 68 65 20 20 /* Uses the
1e200 4f 70 65 6e 45 70 68 65 6d 65 72 61 6c 20 6f 70 OpenEphemeral op
1e210 63 6f 64 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 code */.#define
1e220 53 46 5f 45 78 70 61 6e 64 65 64 20 20 20 20 20 SF_Expanded
1e230 20 20 30 78 30 30 30 34 30 20 20 2f 2a 20 73 71 0x00040 /* sq
1e240 6c 69 74 65 33 53 65 6c 65 63 74 45 78 70 61 6e lite3SelectExpan
1e250 64 28 29 20 63 61 6c 6c 65 64 20 6f 6e 20 74 68 d() called on th
1e260 69 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 is */.#define SF
1e270 5f 48 61 73 54 79 70 65 49 6e 66 6f 20 20 20 20 _HasTypeInfo
1e280 30 78 30 30 30 38 30 20 20 2f 2a 20 46 52 4f 4d 0x00080 /* FROM
1e290 20 73 75 62 71 75 65 72 69 65 73 20 68 61 76 65 subqueries have
1e2a0 20 54 61 62 6c 65 20 6d 65 74 61 64 61 74 61 20 Table metadata
1e2b0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 43 6f */.#define SF_Co
1e2c0 6d 70 6f 75 6e 64 20 20 20 20 20 20 20 30 78 30 mpound 0x0
1e2d0 30 31 30 30 20 20 2f 2a 20 50 61 72 74 20 6f 66 0100 /* Part of
1e2e0 20 61 20 63 6f 6d 70 6f 75 6e 64 20 71 75 65 72 a compound quer
1e2f0 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f y */.#define SF_
1e300 56 61 6c 75 65 73 20 20 20 20 20 20 20 20 20 30 Values 0
1e310 78 30 30 32 30 30 20 20 2f 2a 20 53 79 6e 74 68 x00200 /* Synth
1e320 65 73 69 7a 65 64 20 66 72 6f 6d 20 56 41 4c 55 esized from VALU
1e330 45 53 20 63 6c 61 75 73 65 20 2a 2f 0a 23 64 65 ES clause */.#de
1e340 66 69 6e 65 20 53 46 5f 4d 75 6c 74 69 56 61 6c fine SF_MultiVal
1e350 75 65 20 20 20 20 20 30 78 30 30 34 30 30 20 20 ue 0x00400
1e360 2f 2a 20 53 69 6e 67 6c 65 20 56 41 4c 55 45 53 /* Single VALUES
1e370 20 74 65 72 6d 20 77 69 74 68 20 6d 75 6c 74 69 term with multi
1e380 70 6c 65 20 72 6f 77 73 20 2a 2f 0a 23 64 65 66 ple rows */.#def
1e390 69 6e 65 20 53 46 5f 4e 65 73 74 65 64 46 72 6f ine SF_NestedFro
1e3a0 6d 20 20 20 20 20 30 78 30 30 38 30 30 20 20 2f m 0x00800 /
1e3b0 2a 20 50 61 72 74 20 6f 66 20 61 20 70 61 72 65 * Part of a pare
1e3c0 6e 74 68 65 73 69 7a 65 64 20 46 52 4f 4d 20 63 nthesized FROM c
1e3d0 6c 61 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 lause */.#define
1e3e0 20 53 46 5f 4d 69 6e 4d 61 78 41 67 67 20 20 20 SF_MinMaxAgg
1e3f0 20 20 20 30 78 30 31 30 30 30 20 20 2f 2a 20 41 0x01000 /* A
1e400 67 67 72 65 67 61 74 65 20 63 6f 6e 74 61 69 6e ggregate contain
1e410 69 6e 67 20 6d 69 6e 28 29 20 6f 72 20 6d 61 78 ing min() or max
1e420 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 () */.#define SF
1e430 5f 52 65 63 75 72 73 69 76 65 20 20 20 20 20 20 _Recursive
1e440 30 78 30 32 30 30 30 20 20 2f 2a 20 54 68 65 20 0x02000 /* The
1e450 72 65 63 75 72 73 69 76 65 20 70 61 72 74 20 6f recursive part o
1e460 66 20 61 20 72 65 63 75 72 73 69 76 65 20 43 54 f a recursive CT
1e470 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f E */.#define SF_
1e480 46 69 78 65 64 4c 69 6d 69 74 20 20 20 20 20 30 FixedLimit 0
1e490 78 30 34 30 30 30 20 20 2f 2a 20 6e 53 65 6c 65 x04000 /* nSele
1e4a0 63 74 52 6f 77 20 73 65 74 20 62 79 20 61 20 63 ctRow set by a c
1e4b0 6f 6e 73 74 61 6e 74 20 4c 49 4d 49 54 20 2a 2f onstant LIMIT */
1e4c0 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d 61 79 62 .#define SF_Mayb
1e4d0 65 43 6f 6e 76 65 72 74 20 20 20 30 78 30 38 30 eConvert 0x080
1e4e0 30 30 20 20 2f 2a 20 4e 65 65 64 20 63 6f 6e 76 00 /* Need conv
1e4f0 65 72 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 ertCompoundSelec
1e500 74 54 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f tToSubquery() */
1e510 0a 23 64 65 66 69 6e 65 20 53 46 5f 43 6f 6e 76 .#define SF_Conv
1e520 65 72 74 65 64 20 20 20 20 20 20 30 78 31 30 30 erted 0x100
1e530 30 30 20 20 2f 2a 20 42 79 20 63 6f 6e 76 65 72 00 /* By conver
1e540 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 74 54 tCompoundSelectT
1e550 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f 0a 23 oSubquery() */.#
1e560 64 65 66 69 6e 65 20 53 46 5f 49 6e 63 6c 75 64 define SF_Includ
1e570 65 48 69 64 64 65 6e 20 20 30 78 32 30 30 30 30 eHidden 0x20000
1e580 20 20 2f 2a 20 49 6e 63 6c 75 64 65 20 68 69 64 /* Include hid
1e590 64 65 6e 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 6f den columns in o
1e5a0 75 74 70 75 74 20 2a 2f 0a 23 64 65 66 69 6e 65 utput */.#define
1e5b0 20 53 46 5f 43 6f 6d 70 6c 65 78 52 65 73 75 6c SF_ComplexResul
1e5c0 74 20 20 30 78 34 30 30 30 30 20 20 2f 2a 20 52 t 0x40000 /* R
1e5d0 65 73 75 6c 74 20 63 6f 6e 74 61 69 6e 73 20 73 esult contains s
1e5e0 75 62 71 75 65 72 79 20 6f 72 20 66 75 6e 63 74 ubquery or funct
1e5f0 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 ion */../*.** Th
1e600 65 20 72 65 73 75 6c 74 73 20 6f 66 20 61 20 53 e results of a S
1e610 45 4c 45 43 54 20 63 61 6e 20 62 65 20 64 69 73 ELECT can be dis
1e620 74 72 69 62 75 74 65 64 20 69 6e 20 73 65 76 65 tributed in seve
1e630 72 61 6c 20 77 61 79 73 2c 20 61 73 20 64 65 66 ral ways, as def
1e640 69 6e 65 64 0a 2a 2a 20 62 79 20 6f 6e 65 20 6f ined.** by one o
1e650 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
1e660 6d 61 63 72 6f 73 2e 20 20 54 68 65 20 22 53 52 macros. The "SR
1e670 54 22 20 70 72 65 66 69 78 20 6d 65 61 6e 73 20 T" prefix means
1e680 22 53 45 4c 45 43 54 20 52 65 73 75 6c 74 0a 2a "SELECT Result.*
1e690 2a 20 54 79 70 65 22 2e 0a 2a 2a 0a 2a 2a 20 20 * Type"..**.**
1e6a0 20 20 20 53 52 54 5f 55 6e 69 6f 6e 20 20 20 20 SRT_Union
1e6b0 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 Store results
1e6c0 20 61 73 20 61 20 6b 65 79 20 69 6e 20 61 20 74 as a key in a t
1e6d0 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 78 0a 2a emporary index.*
1e6e0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1e6f0 20 20 20 20 20 20 69 64 65 6e 74 69 66 69 65 64 identified
1e700 20 62 79 20 70 44 65 73 74 2d 3e 69 53 44 50 61 by pDest->iSDPa
1e710 72 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 rm..**.** SR
1e720 54 5f 45 78 63 65 70 74 20 20 20 20 20 20 52 65 T_Except Re
1e730 6d 6f 76 65 20 72 65 73 75 6c 74 73 20 66 72 6f move results fro
1e740 6d 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 m the temporary
1e750 69 6e 64 65 78 20 70 44 65 73 74 2d 3e 69 53 44 index pDest->iSD
1e760 50 61 72 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 Parm..**.**
1e770 53 52 54 5f 45 78 69 73 74 73 20 20 20 20 20 20 SRT_Exists
1e780 53 74 6f 72 65 20 61 20 31 20 69 6e 20 6d 65 6d Store a 1 in mem
1e790 6f 72 79 20 63 65 6c 6c 20 70 44 65 73 74 2d 3e ory cell pDest->
1e7a0 69 53 44 50 61 72 6d 20 69 66 20 74 68 65 20 72 iSDParm if the r
1e7b0 65 73 75 6c 74 0a 2a 2a 20 20 20 20 20 20 20 20 esult.**
1e7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 73 65 74 set
1e7d0 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 2e 0a 2a is not empty..*
1e7e0 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 44 69 73 *.** SRT_Dis
1e7f0 63 61 72 64 20 20 20 20 20 54 68 72 6f 77 20 74 card Throw t
1e800 68 65 20 72 65 73 75 6c 74 73 20 61 77 61 79 2e he results away.
1e810 20 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62 This is used b
1e820 79 20 53 45 4c 45 43 54 0a 2a 2a 20 20 20 20 20 y SELECT.**
1e830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e840 73 74 61 74 65 6d 65 6e 74 73 20 77 69 74 68 69 statements withi
1e850 6e 20 74 72 69 67 67 65 72 73 20 77 68 6f 73 65 n triggers whose
1e860 20 6f 6e 6c 79 20 70 75 72 70 6f 73 65 20 69 73 only purpose is
1e870 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1e880 20 20 20 20 20 20 20 20 74 68 65 20 73 69 64 65 the side
1e890 2d 65 66 66 65 63 74 73 20 6f 66 20 66 75 6e 63 -effects of func
1e8a0 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c tions..**.** All
1e8b0 20 6f 66 20 74 68 65 20 61 62 6f 76 65 20 61 72 of the above ar
1e8c0 65 20 66 72 65 65 20 74 6f 20 69 67 6e 6f 72 65 e free to ignore
1e8d0 20 74 68 65 69 72 20 4f 52 44 45 52 20 42 59 20 their ORDER BY
1e8e0 63 6c 61 75 73 65 2e 20 54 68 6f 73 65 20 74 68 clause. Those th
1e8f0 61 74 0a 2a 2a 20 66 6f 6c 6c 6f 77 20 6d 75 73 at.** follow mus
1e900 74 20 68 6f 6e 6f 72 20 74 68 65 20 4f 52 44 45 t honor the ORDE
1e910 52 20 42 59 20 63 6c 61 75 73 65 2e 0a 2a 2a 0a R BY clause..**.
1e920 2a 2a 20 20 20 20 20 53 52 54 5f 4f 75 74 70 75 ** SRT_Outpu
1e930 74 20 20 20 20 20 20 47 65 6e 65 72 61 74 65 20 t Generate
1e940 61 20 72 6f 77 20 6f 66 20 6f 75 74 70 75 74 20 a row of output
1e950 28 75 73 69 6e 67 20 74 68 65 20 4f 50 5f 52 65 (using the OP_Re
1e960 73 75 6c 74 52 6f 77 0a 2a 2a 20 20 20 20 20 20 sultRow.**
1e970 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f o
1e980 70 63 6f 64 65 29 20 66 6f 72 20 65 61 63 68 20 pcode) for each
1e990 72 6f 77 20 69 6e 20 74 68 65 20 72 65 73 75 6c row in the resul
1e9a0 74 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 t set..**.**
1e9b0 20 53 52 54 5f 4d 65 6d 20 20 20 20 20 20 20 20 SRT_Mem
1e9c0 20 4f 6e 6c 79 20 76 61 6c 69 64 20 69 66 20 74 Only valid if t
1e9d0 68 65 20 72 65 73 75 6c 74 20 69 73 20 61 20 73 he result is a s
1e9e0 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a ingle column..**
1e9f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea00 20 20 20 20 20 53 74 6f 72 65 20 74 68 65 20 66 Store the f
1ea10 69 72 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 irst column of t
1ea20 68 65 20 66 69 72 73 74 20 72 65 73 75 6c 74 20 he first result
1ea30 72 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 row.**
1ea40 20 20 20 20 20 20 20 20 20 20 20 69 6e 20 72 65 in re
1ea50 67 69 73 74 65 72 20 70 44 65 73 74 2d 3e 69 53 gister pDest->iS
1ea60 44 50 61 72 6d 20 74 68 65 6e 20 61 62 61 6e 64 DParm then aband
1ea70 6f 6e 20 74 68 65 20 72 65 73 74 0a 2a 2a 20 20 on the rest.**
1ea80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ea90 20 20 20 6f 66 20 74 68 65 20 71 75 65 72 79 2e of the query.
1eaa0 20 20 54 68 69 73 20 64 65 73 74 69 6e 61 74 69 This destinati
1eab0 6f 6e 20 69 6d 70 6c 69 65 73 20 22 4c 49 4d 49 on implies "LIMI
1eac0 54 20 31 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 T 1"..**.**
1ead0 53 52 54 5f 53 65 74 20 20 20 20 20 20 20 20 20 SRT_Set
1eae0 54 68 65 20 72 65 73 75 6c 74 20 6d 75 73 74 20 The result must
1eaf0 62 65 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 be a single colu
1eb00 6d 6e 2e 20 20 53 74 6f 72 65 20 65 61 63 68 0a mn. Store each.
1eb10 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1eb20 20 20 20 20 20 20 20 72 6f 77 20 6f 66 20 72 65 row of re
1eb30 73 75 6c 74 20 61 73 20 74 68 65 20 6b 65 79 20 sult as the key
1eb40 69 6e 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e in table pDest->
1eb50 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 iSDParm..**
1eb60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1eb70 41 70 70 6c 79 20 74 68 65 20 61 66 66 69 6e 69 Apply the affini
1eb80 74 79 20 70 44 65 73 74 2d 3e 61 66 66 53 64 73 ty pDest->affSds
1eb90 74 20 62 65 66 6f 72 65 20 73 74 6f 72 69 6e 67 t before storing
1eba0 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1ebb0 20 20 20 20 20 20 20 20 72 65 73 75 6c 74 73 2e results.
1ebc0 20 20 55 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d Used to implem
1ebd0 65 6e 74 20 22 49 4e 20 28 53 45 4c 45 43 54 20 ent "IN (SELECT
1ebe0 2e 2e 2e 29 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 ...)"..**.**
1ebf0 20 53 52 54 5f 45 70 68 65 6d 54 61 62 20 20 20 SRT_EphemTab
1ec00 20 43 72 65 61 74 65 20 61 6e 20 74 65 6d 70 6f Create an tempo
1ec10 72 61 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 rary table pDest
1ec20 2d 3e 69 53 44 50 61 72 6d 20 61 6e 64 20 73 74 ->iSDParm and st
1ec30 6f 72 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ore.**
1ec40 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 72 the r
1ec50 65 73 75 6c 74 20 74 68 65 72 65 2e 20 54 68 65 esult there. The
1ec60 20 63 75 72 73 6f 72 20 69 73 20 6c 65 66 74 20 cursor is left
1ec70 6f 70 65 6e 20 61 66 74 65 72 0a 2a 2a 20 20 20 open after.**
1ec80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ec90 20 20 72 65 74 75 72 6e 69 6e 67 2e 20 20 54 68 returning. Th
1eca0 69 73 20 69 73 20 6c 69 6b 65 20 53 52 54 5f 54 is is like SRT_T
1ecb0 61 62 6c 65 20 65 78 63 65 70 74 20 74 68 61 74 able except that
1ecc0 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1ecd0 20 20 20 20 20 20 20 20 74 68 69 73 20 64 65 73 this des
1ece0 74 69 6e 61 74 69 6f 6e 20 75 73 65 73 20 4f 50 tination uses OP
1ecf0 5f 4f 70 65 6e 45 70 68 65 6d 65 72 61 6c 20 74 _OpenEphemeral t
1ed00 6f 20 63 72 65 61 74 65 0a 2a 2a 20 20 20 20 20 o create.**
1ed10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ed20 74 68 65 20 74 61 62 6c 65 20 66 69 72 73 74 2e the table first.
1ed30 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 43 .**.** SRT_C
1ed40 6f 72 6f 75 74 69 6e 65 20 20 20 47 65 6e 65 72 oroutine Gener
1ed50 61 74 65 20 61 20 63 6f 2d 72 6f 75 74 69 6e 65 ate a co-routine
1ed60 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 61 20 that returns a
1ed70 6e 65 77 20 72 6f 77 20 6f 66 0a 2a 2a 20 20 20 new row of.**
1ed80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ed90 20 20 72 65 73 75 6c 74 73 20 65 61 63 68 20 74 results each t
1eda0 69 6d 65 20 69 74 20 69 73 20 69 6e 76 6f 6b 65 ime it is invoke
1edb0 64 2e 20 20 54 68 65 20 65 6e 74 72 79 20 70 6f d. The entry po
1edc0 69 6e 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 int.**
1edd0 20 20 20 20 20 20 20 20 20 20 20 6f 66 20 74 68 of th
1ede0 65 20 63 6f 2d 72 6f 75 74 69 6e 65 20 69 73 20 e co-routine is
1edf0 73 74 6f 72 65 64 20 69 6e 20 72 65 67 69 73 74 stored in regist
1ee00 65 72 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 er pDest->iSDPar
1ee10 6d 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 m.**
1ee20 20 20 20 20 20 20 20 20 20 61 6e 64 20 74 68 65 and the
1ee30 20 72 65 73 75 6c 74 20 72 6f 77 20 69 73 20 73 result row is s
1ee40 74 6f 72 65 64 20 69 6e 20 70 44 65 73 74 2d 3e tored in pDest->
1ee50 6e 44 65 73 74 20 72 65 67 69 73 74 65 72 73 0a nDest registers.
1ee60 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1ee70 20 20 20 20 20 20 20 73 74 61 72 74 69 6e 67 20 starting
1ee80 77 69 74 68 20 70 44 65 73 74 2d 3e 69 53 64 73 with pDest->iSds
1ee90 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 t..**.** SRT
1eea0 5f 54 61 62 6c 65 20 20 20 20 20 20 20 53 74 6f _Table Sto
1eeb0 72 65 20 72 65 73 75 6c 74 73 20 69 6e 20 74 65 re results in te
1eec0 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 20 70 44 mporary table pD
1eed0 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a est->iSDParm..**
1eee0 20 20 20 20 20 53 52 54 5f 46 69 66 6f 20 20 20 SRT_Fifo
1eef0 20 20 20 20 20 54 68 69 73 20 69 73 20 6c 69 6b This is lik
1ef00 65 20 53 52 54 5f 45 70 68 65 6d 54 61 62 20 65 e SRT_EphemTab e
1ef10 78 63 65 70 74 20 74 68 61 74 20 74 68 65 20 74 xcept that the t
1ef20 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 able.**
1ef30 20 20 20 20 20 20 20 20 20 20 20 20 69 73 20 61 is a
1ef40 73 73 75 6d 65 64 20 74 6f 20 61 6c 72 65 61 64 ssumed to alread
1ef50 79 20 62 65 20 6f 70 65 6e 2e 20 20 53 52 54 5f y be open. SRT_
1ef60 46 69 66 6f 20 68 61 73 0a 2a 2a 20 20 20 20 20 Fifo has.**
1ef70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ef80 74 68 65 20 61 64 64 69 74 69 6f 6e 61 6c 20 70 the additional p
1ef90 72 6f 70 65 72 74 79 20 6f 66 20 62 65 69 6e 67 roperty of being
1efa0 20 61 62 6c 65 20 74 6f 20 69 67 6e 6f 72 65 0a able to ignore.
1efb0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1efc0 20 20 20 20 20 20 20 74 68 65 20 4f 52 44 45 52 the ORDER
1efd0 20 42 59 20 63 6c 61 75 73 65 2e 0a 2a 2a 0a 2a BY clause..**.*
1efe0 2a 20 20 20 20 20 53 52 54 5f 44 69 73 74 46 69 * SRT_DistFi
1eff0 66 6f 20 20 20 20 53 74 6f 72 65 20 72 65 73 75 fo Store resu
1f000 6c 74 73 20 69 6e 20 61 20 74 65 6d 70 6f 72 61 lts in a tempora
1f010 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e ry table pDest->
1f020 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 iSDParm..**
1f030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f040 42 75 74 20 61 6c 73 6f 20 75 73 65 20 74 65 6d But also use tem
1f050 70 6f 72 61 72 79 20 74 61 62 6c 65 20 70 44 65 porary table pDe
1f060 73 74 2d 3e 69 53 44 50 61 72 6d 2b 31 20 61 73 st->iSDParm+1 as
1f070 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1f080 20 20 20 20 20 20 20 20 61 20 72 65 63 6f 72 64 a record
1f090 20 6f 66 20 61 6c 6c 20 70 72 69 6f 72 20 72 65 of all prior re
1f0a0 73 75 6c 74 73 20 61 6e 64 20 69 67 6e 6f 72 65 sults and ignore
1f0b0 20 61 6e 79 20 64 75 70 6c 69 63 61 74 65 0a 2a any duplicate.*
1f0c0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1f0d0 20 20 20 20 20 20 72 6f 77 73 2e 20 20 4e 61 6d rows. Nam
1f0e0 65 20 6d 65 61 6e 73 3a 20 20 22 44 69 73 74 69 e means: "Disti
1f0f0 6e 63 74 20 46 69 66 6f 22 2e 0a 2a 2a 0a 2a 2a nct Fifo"..**.**
1f100 20 20 20 20 20 53 52 54 5f 51 75 65 75 65 20 20 SRT_Queue
1f110 20 20 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c Store resul
1f120 74 73 20 69 6e 20 70 72 69 6f 72 69 74 79 20 71 ts in priority q
1f130 75 65 75 65 20 70 44 65 73 74 2d 3e 69 53 44 50 ueue pDest->iSDP
1f140 61 72 6d 20 28 72 65 61 6c 6c 79 0a 2a 2a 20 20 arm (really.**
1f150 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f160 20 20 20 61 6e 20 69 6e 64 65 78 29 2e 20 20 41 an index). A
1f170 70 70 65 6e 64 20 61 20 73 65 71 75 65 6e 63 65 ppend a sequence
1f180 20 6e 75 6d 62 65 72 20 73 6f 20 74 68 61 74 20 number so that
1f190 61 6c 6c 20 65 6e 74 72 69 65 73 0a 2a 2a 20 20 all entries.**
1f1a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f1b0 20 20 20 61 72 65 20 64 69 73 74 69 6e 63 74 2e are distinct.
1f1c0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 44 .**.** SRT_D
1f1d0 69 73 74 51 75 65 75 65 20 20 20 53 74 6f 72 65 istQueue Store
1f1e0 20 72 65 73 75 6c 74 73 20 69 6e 20 70 72 69 6f results in prio
1f1f0 72 69 74 79 20 71 75 65 75 65 20 70 44 65 73 74 rity queue pDest
1f200 2d 3e 69 53 44 50 61 72 6d 20 6f 6e 6c 79 20 69 ->iSDParm only i
1f210 66 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 f.**
1f220 20 20 20 20 20 20 20 20 20 74 68 65 20 73 61 6d the sam
1f230 65 20 72 65 63 6f 72 64 20 68 61 73 20 6e 65 76 e record has nev
1f240 65 72 20 62 65 65 6e 20 73 74 6f 72 65 64 20 62 er been stored b
1f250 65 66 6f 72 65 2e 20 20 54 68 65 0a 2a 2a 20 20 efore. The.**
1f260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f270 20 20 20 69 6e 64 65 78 20 61 74 20 70 44 65 73 index at pDes
1f280 74 2d 3e 69 53 44 50 61 72 6d 2b 31 20 68 6f 6c t->iSDParm+1 hol
1f290 64 20 61 6c 6c 20 70 72 69 6f 72 20 73 74 6f 72 d all prior stor
1f2a0 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 es..*/.#define S
1f2b0 52 54 5f 55 6e 69 6f 6e 20 20 20 20 20 20 20 20 RT_Union
1f2c0 31 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 1 /* Store resu
1f2d0 6c 74 20 61 73 20 6b 65 79 73 20 69 6e 20 61 6e lt as keys in an
1f2e0 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e index */.#defin
1f2f0 65 20 53 52 54 5f 45 78 63 65 70 74 20 20 20 20 e SRT_Except
1f300 20 20 20 32 20 20 2f 2a 20 52 65 6d 6f 76 65 20 2 /* Remove
1f310 72 65 73 75 6c 74 20 66 72 6f 6d 20 61 20 55 4e result from a UN
1f320 49 4f 4e 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 ION index */.#de
1f330 66 69 6e 65 20 53 52 54 5f 45 78 69 73 74 73 20 fine SRT_Exists
1f340 20 20 20 20 20 20 33 20 20 2f 2a 20 53 74 6f 72 3 /* Stor
1f350 65 20 31 20 69 66 20 74 68 65 20 72 65 73 75 6c e 1 if the resul
1f360 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 20 2a t is not empty *
1f370 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 44 69 /.#define SRT_Di
1f380 73 63 61 72 64 20 20 20 20 20 20 34 20 20 2f 2a scard 4 /*
1f390 20 44 6f 20 6e 6f 74 20 73 61 76 65 20 74 68 65 Do not save the
1f3a0 20 72 65 73 75 6c 74 73 20 61 6e 79 77 68 65 72 results anywher
1f3b0 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 e */.#define SRT
1f3c0 5f 46 69 66 6f 20 20 20 20 20 20 20 20 20 35 20 _Fifo 5
1f3d0 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 /* Store result
1f3e0 20 61 73 20 64 61 74 61 20 77 69 74 68 20 61 6e as data with an
1f3f0 20 61 75 74 6f 6d 61 74 69 63 20 72 6f 77 69 64 automatic rowid
1f400 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f */.#define SRT_
1f410 44 69 73 74 46 69 66 6f 20 20 20 20 20 36 20 20 DistFifo 6
1f420 2f 2a 20 4c 69 6b 65 20 53 52 54 5f 46 69 66 6f /* Like SRT_Fifo
1f430 2c 20 62 75 74 20 75 6e 69 71 75 65 20 72 65 73 , but unique res
1f440 75 6c 74 73 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 ults only */.#de
1f450 66 69 6e 65 20 53 52 54 5f 51 75 65 75 65 20 20 fine SRT_Queue
1f460 20 20 20 20 20 20 37 20 20 2f 2a 20 53 74 6f 72 7 /* Stor
1f470 65 20 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 71 e result in an q
1f480 75 65 75 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ueue */.#define
1f490 53 52 54 5f 44 69 73 74 51 75 65 75 65 20 20 20 SRT_DistQueue
1f4a0 20 38 20 20 2f 2a 20 4c 69 6b 65 20 53 52 54 5f 8 /* Like SRT_
1f4b0 51 75 65 75 65 2c 20 62 75 74 20 75 6e 69 71 75 Queue, but uniqu
1f4c0 65 20 72 65 73 75 6c 74 73 20 6f 6e 6c 79 20 2a e results only *
1f4d0 2f 0a 0a 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 /../* The ORDER
1f4e0 42 59 20 63 6c 61 75 73 65 20 69 73 20 69 67 6e BY clause is ign
1f4f0 6f 72 65 64 20 66 6f 72 20 61 6c 6c 20 6f 66 20 ored for all of
1f500 74 68 65 20 61 62 6f 76 65 20 2a 2f 0a 23 64 65 the above */.#de
1f510 66 69 6e 65 20 49 67 6e 6f 72 61 62 6c 65 4f 72 fine IgnorableOr
1f520 64 65 72 62 79 28 58 29 20 28 28 58 2d 3e 65 44 derby(X) ((X->eD
1f530 65 73 74 29 3c 3d 53 52 54 5f 44 69 73 74 51 75 est)<=SRT_DistQu
1f540 65 75 65 29 0a 0a 23 64 65 66 69 6e 65 20 53 52 eue)..#define SR
1f550 54 5f 4f 75 74 70 75 74 20 20 20 20 20 20 20 39 T_Output 9
1f560 20 20 2f 2a 20 4f 75 74 70 75 74 20 65 61 63 68 /* Output each
1f570 20 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 20 2a row of result *
1f580 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 4d 65 /.#define SRT_Me
1f590 6d 20 20 20 20 20 20 20 20 20 31 30 20 20 2f 2a m 10 /*
1f5a0 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 69 6e Store result in
1f5b0 20 61 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 2a a memory cell *
1f5c0 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 53 65 /.#define SRT_Se
1f5d0 74 20 20 20 20 20 20 20 20 20 31 31 20 20 2f 2a t 11 /*
1f5e0 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 61 Store results a
1f5f0 73 20 6b 65 79 73 20 69 6e 20 61 6e 20 69 6e 64 s keys in an ind
1f600 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 ex */.#define SR
1f610 54 5f 45 70 68 65 6d 54 61 62 20 20 20 20 31 32 T_EphemTab 12
1f620 20 20 2f 2a 20 43 72 65 61 74 65 20 74 72 61 6e /* Create tran
1f630 73 69 65 6e 74 20 74 61 62 20 61 6e 64 20 73 74 sient tab and st
1f640 6f 72 65 20 6c 69 6b 65 20 53 52 54 5f 54 61 62 ore like SRT_Tab
1f650 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 le */.#define SR
1f660 54 5f 43 6f 72 6f 75 74 69 6e 65 20 20 20 31 33 T_Coroutine 13
1f670 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 20 61 20 /* Generate a
1f680 73 69 6e 67 6c 65 20 72 6f 77 20 6f 66 20 72 65 single row of re
1f690 73 75 6c 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 sult */.#define
1f6a0 53 52 54 5f 54 61 62 6c 65 20 20 20 20 20 20 20 SRT_Table
1f6b0 31 34 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 14 /* Store res
1f6c0 75 6c 74 20 61 73 20 64 61 74 61 20 77 69 74 68 ult as data with
1f6d0 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 72 6f an automatic ro
1f6e0 77 69 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e wid */../*.** An
1f6f0 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 instance of thi
1f700 73 20 6f 62 6a 65 63 74 20 64 65 73 63 72 69 62 s object describ
1f710 65 73 20 77 68 65 72 65 20 74 6f 20 70 75 74 20 es where to put
1f720 6f 66 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f of the results o
1f730 66 0a 2a 2a 20 61 20 53 45 4c 45 43 54 20 73 74 f.** a SELECT st
1f740 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 72 75 atement..*/.stru
1f750 63 74 20 53 65 6c 65 63 74 44 65 73 74 20 7b 0a ct SelectDest {.
1f760 20 20 75 38 20 65 44 65 73 74 3b 20 20 20 20 20 u8 eDest;
1f770 20 20 20 20 20 20 20 2f 2a 20 48 6f 77 20 74 6f /* How to
1f780 20 64 69 73 70 6f 73 65 20 6f 66 20 74 68 65 20 dispose of the
1f790 72 65 73 75 6c 74 73 2e 20 20 4f 6e 20 6f 66 20 results. On of
1f7a0 53 52 54 5f 2a 20 61 62 6f 76 65 2e 20 2a 2f 0a SRT_* above. */.
1f7b0 20 20 69 6e 74 20 69 53 44 50 61 72 6d 3b 20 20 int iSDParm;
1f7c0 20 20 20 20 20 20 20 2f 2a 20 41 20 70 61 72 61 /* A para
1f7d0 6d 65 74 65 72 20 75 73 65 64 20 62 79 20 74 68 meter used by th
1f7e0 65 20 65 44 65 73 74 20 64 69 73 70 6f 73 61 6c e eDest disposal
1f7f0 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 69 6e 74 method */. int
1f800 20 69 53 64 73 74 3b 20 20 20 20 20 20 20 20 20 iSdst;
1f810 20 20 2f 2a 20 42 61 73 65 20 72 65 67 69 73 74 /* Base regist
1f820 65 72 20 77 68 65 72 65 20 72 65 73 75 6c 74 73 er where results
1f830 20 61 72 65 20 77 72 69 74 74 65 6e 20 2a 2f 0a are written */.
1f840 20 20 69 6e 74 20 6e 53 64 73 74 3b 20 20 20 20 int nSdst;
1f850 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1f860 20 6f 66 20 72 65 67 69 73 74 65 72 73 20 61 6c of registers al
1f870 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 63 68 61 located */. cha
1f880 72 20 2a 7a 41 66 66 53 64 73 74 3b 20 20 20 20 r *zAffSdst;
1f890 20 20 2f 2a 20 41 66 66 69 6e 69 74 79 20 75 73 /* Affinity us
1f8a0 65 64 20 77 68 65 6e 20 65 44 65 73 74 3d 3d 53 ed when eDest==S
1f8b0 52 54 5f 53 65 74 20 2a 2f 0a 20 20 45 78 70 72 RT_Set */. Expr
1f8c0 4c 69 73 74 20 2a 70 4f 72 64 65 72 42 79 3b 20 List *pOrderBy;
1f8d0 20 2f 2a 20 4b 65 79 20 63 6f 6c 75 6d 6e 73 20 /* Key columns
1f8e0 66 6f 72 20 53 52 54 5f 51 75 65 75 65 20 61 6e for SRT_Queue an
1f8f0 64 20 53 52 54 5f 44 69 73 74 51 75 65 75 65 20 d SRT_DistQueue
1f900 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 */.};../*.** Dur
1f910 69 6e 67 20 63 6f 64 65 20 67 65 6e 65 72 61 74 ing code generat
1f920 69 6f 6e 20 6f 66 20 73 74 61 74 65 6d 65 6e 74 ion of statement
1f930 73 20 74 68 61 74 20 64 6f 20 69 6e 73 65 72 74 s that do insert
1f940 73 20 69 6e 74 6f 20 41 55 54 4f 49 4e 43 52 45 s into AUTOINCRE
1f950 4d 45 4e 54 0a 2a 2a 20 74 61 62 6c 65 73 2c 20 MENT.** tables,
1f960 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e the following in
1f970 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 61 74 74 formation is att
1f980 61 63 68 65 64 20 74 6f 20 74 68 65 20 54 61 62 ached to the Tab
1f990 6c 65 2e 75 2e 61 75 74 6f 49 6e 63 2e 70 0a 2a le.u.autoInc.p.*
1f9a0 2a 20 70 6f 69 6e 74 65 72 20 6f 66 20 65 61 63 * pointer of eac
1f9b0 68 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 20 h autoincrement
1f9c0 74 61 62 6c 65 20 74 6f 20 72 65 63 6f 72 64 20 table to record
1f9d0 73 6f 6d 65 20 73 69 64 65 20 69 6e 66 6f 72 6d some side inform
1f9e0 61 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 68 ation that.** th
1f9f0 65 20 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 e code generator
1fa00 20 6e 65 65 64 73 2e 20 20 57 65 20 68 61 76 65 needs. We have
1fa10 20 74 6f 20 6b 65 65 70 20 70 65 72 2d 74 61 62 to keep per-tab
1fa20 6c 65 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 le autoincrement
1fa30 0a 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 .** information
1fa40 69 6e 20 63 61 73 65 20 69 6e 73 65 72 74 73 20 in case inserts
1fa50 61 72 65 20 64 6f 6e 65 20 77 69 74 68 69 6e 20 are done within
1fa60 74 72 69 67 67 65 72 73 2e 20 20 54 72 69 67 67 triggers. Trigg
1fa70 65 72 73 20 64 6f 20 6e 6f 74 0a 2a 2a 20 6e 6f ers do not.** no
1fa80 72 6d 61 6c 6c 79 20 63 6f 6f 72 64 69 6e 61 74 rmally coordinat
1fa90 65 20 74 68 65 69 72 20 61 63 74 69 76 69 74 69 e their activiti
1faa0 65 73 2c 20 62 75 74 20 77 65 20 64 6f 20 6e 65 es, but we do ne
1fab0 65 64 20 74 6f 20 63 6f 6f 72 64 69 6e 61 74 65 ed to coordinate
1fac0 20 74 68 65 0a 2a 2a 20 6c 6f 61 64 69 6e 67 20 the.** loading
1fad0 61 6e 64 20 73 61 76 69 6e 67 20 6f 66 20 61 75 and saving of au
1fae0 74 6f 69 6e 63 72 65 6d 65 6e 74 20 69 6e 66 6f toincrement info
1faf0 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 rmation..*/.stru
1fb00 63 74 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 7b ct AutoincInfo {
1fb10 0a 20 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 2a . AutoincInfo *
1fb20 70 4e 65 78 74 3b 20 20 20 2f 2a 20 4e 65 78 74 pNext; /* Next
1fb30 20 69 6e 66 6f 20 62 6c 6f 63 6b 20 69 6e 20 61 info block in a
1fb40 20 6c 69 73 74 20 6f 66 20 74 68 65 6d 20 61 6c list of them al
1fb50 6c 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 l */. Table *pT
1fb60 61 62 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ab; /*
1fb70 54 61 62 6c 65 20 74 68 69 73 20 69 6e 66 6f 20 Table this info
1fb80 62 6c 6f 63 6b 20 72 65 66 65 72 73 20 74 6f 20 block refers to
1fb90 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 */. int iDb;
1fba0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
1fbb0 64 65 78 20 69 6e 20 73 71 6c 69 74 65 33 2e 61 dex in sqlite3.a
1fbc0 44 62 5b 5d 20 6f 66 20 64 61 74 61 62 61 73 65 Db[] of database
1fbd0 20 68 6f 6c 64 69 6e 67 20 70 54 61 62 20 2a 2f holding pTab */
1fbe0 0a 20 20 69 6e 74 20 72 65 67 43 74 72 3b 20 20 . int regCtr;
1fbf0 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f /* Memo
1fc00 72 79 20 72 65 67 69 73 74 65 72 20 68 6f 6c 64 ry register hold
1fc10 69 6e 67 20 74 68 65 20 72 6f 77 69 64 20 63 6f ing the rowid co
1fc20 75 6e 74 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a unter */.};../*.
1fc30 2a 2a 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 ** At least one
1fc40 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
1fc50 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
1fc60 75 72 65 20 69 73 20 63 72 65 61 74 65 64 20 66 ure is created f
1fc70 6f 72 20 65 61 63 68 0a 2a 2a 20 74 72 69 67 67 or each.** trigg
1fc80 65 72 20 74 68 61 74 20 6d 61 79 20 62 65 20 66 er that may be f
1fc90 69 72 65 64 20 77 68 69 6c 65 20 70 61 72 73 69 ired while parsi
1fca0 6e 67 20 61 6e 20 49 4e 53 45 52 54 2c 20 55 50 ng an INSERT, UP
1fcb0 44 41 54 45 20 6f 72 20 44 45 4c 45 54 45 0a 2a DATE or DELETE.*
1fcc0 2a 20 73 74 61 74 65 6d 65 6e 74 2e 20 41 6c 6c * statement. All
1fcd0 20 73 75 63 68 20 6f 62 6a 65 63 74 73 20 61 72 such objects ar
1fce0 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 e stored in the
1fcf0 6c 69 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 64 linked list head
1fd00 65 64 20 61 74 0a 2a 2a 20 50 61 72 73 65 2e 70 ed at.** Parse.p
1fd10 54 72 69 67 67 65 72 50 72 67 20 61 6e 64 20 64 TriggerPrg and d
1fd20 65 6c 65 74 65 64 20 6f 6e 63 65 20 73 74 61 74 eleted once stat
1fd30 65 6d 65 6e 74 20 63 6f 6d 70 69 6c 61 74 69 6f ement compilatio
1fd40 6e 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 63 6f n has been.** co
1fd50 6d 70 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 mpleted..**.** A
1fd60 20 56 64 62 65 20 73 75 62 2d 70 72 6f 67 72 61 Vdbe sub-progra
1fd70 6d 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 m that implement
1fd80 73 20 74 68 65 20 62 6f 64 79 20 61 6e 64 20 57 s the body and W
1fd90 48 45 4e 20 63 6c 61 75 73 65 20 6f 66 20 74 72 HEN clause of tr
1fda0 69 67 67 65 72 0a 2a 2a 20 54 72 69 67 67 65 72 igger.** Trigger
1fdb0 50 72 67 2e 70 54 72 69 67 67 65 72 2c 20 61 73 Prg.pTrigger, as
1fdc0 73 75 6d 69 6e 67 20 61 20 64 65 66 61 75 6c 74 suming a default
1fdd0 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 ON CONFLICT cla
1fde0 75 73 65 20 6f 66 0a 2a 2a 20 54 72 69 67 67 65 use of.** Trigge
1fdf0 72 50 72 67 2e 6f 72 63 6f 6e 66 2c 20 69 73 20 rPrg.orconf, is
1fe00 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 54 72 stored in the Tr
1fe10 69 67 67 65 72 50 72 67 2e 70 50 72 6f 67 72 61 iggerPrg.pProgra
1fe20 6d 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2a 20 54 m variable..** T
1fe30 68 65 20 50 61 72 73 65 2e 70 54 72 69 67 67 65 he Parse.pTrigge
1fe40 72 50 72 67 20 6c 69 73 74 20 6e 65 76 65 72 20 rPrg list never
1fe50 63 6f 6e 74 61 69 6e 73 20 74 77 6f 20 65 6e 74 contains two ent
1fe60 72 69 65 73 20 77 69 74 68 20 74 68 65 20 73 61 ries with the sa
1fe70 6d 65 0a 2a 2a 20 76 61 6c 75 65 73 20 66 6f 72 me.** values for
1fe80 20 62 6f 74 68 20 70 54 72 69 67 67 65 72 20 61 both pTrigger a
1fe90 6e 64 20 6f 72 63 6f 6e 66 2e 0a 2a 2a 0a 2a 2a nd orconf..**.**
1fea0 20 54 68 65 20 54 72 69 67 67 65 72 50 72 67 2e The TriggerPrg.
1feb0 61 43 6f 6c 6d 61 73 6b 5b 30 5d 20 76 61 72 69 aColmask[0] vari
1fec0 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f 20 61 able is set to a
1fed0 20 6d 61 73 6b 20 6f 66 20 6f 6c 64 2e 2a 20 63 mask of old.* c
1fee0 6f 6c 75 6d 6e 73 0a 2a 2a 20 61 63 63 65 73 73 olumns.** access
1fef0 65 64 20 28 6f 72 20 73 65 74 20 74 6f 20 30 20 ed (or set to 0
1ff00 66 6f 72 20 74 72 69 67 67 65 72 73 20 66 69 72 for triggers fir
1ff10 65 64 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f ed as a result o
1ff20 66 20 49 4e 53 45 52 54 0a 2a 2a 20 73 74 61 74 f INSERT.** stat
1ff30 65 6d 65 6e 74 73 29 2e 20 53 69 6d 69 6c 61 72 ements). Similar
1ff40 6c 79 2c 20 74 68 65 20 54 72 69 67 67 65 72 50 ly, the TriggerP
1ff50 72 67 2e 61 43 6f 6c 6d 61 73 6b 5b 31 5d 20 76 rg.aColmask[1] v
1ff60 61 72 69 61 62 6c 65 20 69 73 20 73 65 74 20 74 ariable is set t
1ff70 6f 0a 2a 2a 20 61 20 6d 61 73 6b 20 6f 66 20 6e o.** a mask of n
1ff80 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 75 73 65 ew.* columns use
1ff90 64 20 62 79 20 74 68 65 20 70 72 6f 67 72 61 6d d by the program
1ffa0 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 ..*/.struct Trig
1ffb0 67 65 72 50 72 67 20 7b 0a 20 20 54 72 69 67 67 gerPrg {. Trigg
1ffc0 65 72 20 2a 70 54 72 69 67 67 65 72 3b 20 20 20 er *pTrigger;
1ffd0 20 20 20 2f 2a 20 54 72 69 67 67 65 72 20 74 68 /* Trigger th
1ffe0 69 73 20 70 72 6f 67 72 61 6d 20 77 61 73 20 63 is program was c
1fff0 6f 64 65 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 54 oded from */. T
20000 72 69 67 67 65 72 50 72 67 20 2a 70 4e 65 78 74 riggerPrg *pNext
20010 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 65 ; /* Next e
20020 6e 74 72 79 20 69 6e 20 50 61 72 73 65 2e 70 54 ntry in Parse.pT
20030 72 69 67 67 65 72 50 72 67 20 6c 69 73 74 20 2a riggerPrg list *
20040 2f 0a 20 20 53 75 62 50 72 6f 67 72 61 6d 20 2a /. SubProgram *
20050 70 50 72 6f 67 72 61 6d 3b 20 20 20 2f 2a 20 50 pProgram; /* P
20060 72 6f 67 72 61 6d 20 69 6d 70 6c 65 6d 65 6e 74 rogram implement
20070 69 6e 67 20 70 54 72 69 67 67 65 72 2f 6f 72 63 ing pTrigger/orc
20080 6f 6e 66 20 2a 2f 0a 20 20 69 6e 74 20 6f 72 63 onf */. int orc
20090 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 onf;
200a0 20 2f 2a 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 /* Default ON C
200b0 4f 4e 46 4c 49 43 54 20 70 6f 6c 69 63 79 20 2a ONFLICT policy *
200c0 2f 0a 20 20 75 33 32 20 61 43 6f 6c 6d 61 73 6b /. u32 aColmask
200d0 5b 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d [2]; /* M
200e0 61 73 6b 73 20 6f 66 20 6f 6c 64 2e 2a 2c 20 6e asks of old.*, n
200f0 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 61 63 63 ew.* columns acc
20100 65 73 73 65 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a essed */.};../*.
20110 2a 2a 20 54 68 65 20 79 44 62 4d 61 73 6b 20 64 ** The yDbMask d
20120 61 74 61 74 79 70 65 20 66 6f 72 20 74 68 65 20 atatype for the
20130 62 69 74 6d 61 73 6b 20 6f 66 20 61 6c 6c 20 61 bitmask of all a
20140 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 ttached database
20150 73 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 s..*/.#if SQLITE
20160 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 33 30 _MAX_ATTACHED>30
20170 0a 20 20 74 79 70 65 64 65 66 20 75 6e 73 69 67 . typedef unsig
20180 6e 65 64 20 63 68 61 72 20 79 44 62 4d 61 73 6b ned char yDbMask
20190 5b 28 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 [(SQLITE_MAX_ATT
201a0 41 43 48 45 44 2b 39 29 2f 38 5d 3b 0a 23 20 64 ACHED+9)/8];.# d
201b0 65 66 69 6e 65 20 44 62 4d 61 73 6b 54 65 73 74 efine DbMaskTest
201c0 28 4d 2c 49 29 20 20 20 20 28 28 28 4d 29 5b 28 (M,I) (((M)[(
201d0 49 29 2f 38 5d 26 28 31 3c 3c 28 28 49 29 26 37 I)/8]&(1<<((I)&7
201e0 29 29 29 21 3d 30 29 0a 23 20 64 65 66 69 6e 65 )))!=0).# define
201f0 20 44 62 4d 61 73 6b 5a 65 72 6f 28 4d 29 20 20 DbMaskZero(M)
20200 20 20 20 20 6d 65 6d 73 65 74 28 28 4d 29 2c 30 memset((M),0
20210 2c 73 69 7a 65 6f 66 28 4d 29 29 0a 23 20 64 65 ,sizeof(M)).# de
20220 66 69 6e 65 20 44 62 4d 61 73 6b 53 65 74 28 4d fine DbMaskSet(M
20230 2c 49 29 20 20 20 20 20 28 4d 29 5b 28 49 29 2f ,I) (M)[(I)/
20240 38 5d 7c 3d 28 31 3c 3c 28 28 49 29 26 37 29 29 8]|=(1<<((I)&7))
20250 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b .# define DbMask
20260 41 6c 6c 5a 65 72 6f 28 4d 29 20 20 20 73 71 6c AllZero(M) sql
20270 69 74 65 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 ite3DbMaskAllZer
20280 6f 28 4d 29 0a 23 20 64 65 66 69 6e 65 20 44 62 o(M).# define Db
20290 4d 61 73 6b 4e 6f 6e 5a 65 72 6f 28 4d 29 20 20 MaskNonZero(M)
202a0 20 28 73 71 6c 69 74 65 33 44 62 4d 61 73 6b 41 (sqlite3DbMaskA
202b0 6c 6c 5a 65 72 6f 28 4d 29 3d 3d 30 29 0a 23 65 llZero(M)==0).#e
202c0 6c 73 65 0a 20 20 74 79 70 65 64 65 66 20 75 6e lse. typedef un
202d0 73 69 67 6e 65 64 20 69 6e 74 20 79 44 62 4d 61 signed int yDbMa
202e0 73 6b 3b 0a 23 20 64 65 66 69 6e 65 20 44 62 4d sk;.# define DbM
202f0 61 73 6b 54 65 73 74 28 4d 2c 49 29 20 20 20 20 askTest(M,I)
20300 28 28 28 4d 29 26 28 28 28 79 44 62 4d 61 73 6b (((M)&(((yDbMask
20310 29 31 29 3c 3c 28 49 29 29 29 21 3d 30 29 0a 23 )1)<<(I)))!=0).#
20320 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 5a 65 define DbMaskZe
20330 72 6f 28 4d 29 20 20 20 20 20 20 28 4d 29 3d 30 ro(M) (M)=0
20340 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b .# define DbMask
20350 53 65 74 28 4d 2c 49 29 20 20 20 20 20 28 4d 29 Set(M,I) (M)
20360 7c 3d 28 28 28 79 44 62 4d 61 73 6b 29 31 29 3c |=(((yDbMask)1)<
20370 3c 28 49 29 29 0a 23 20 64 65 66 69 6e 65 20 44 <(I)).# define D
20380 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 4d 29 20 bMaskAllZero(M)
20390 20 20 28 4d 29 3d 3d 30 0a 23 20 64 65 66 69 6e (M)==0.# defin
203a0 65 20 44 62 4d 61 73 6b 4e 6f 6e 5a 65 72 6f 28 e DbMaskNonZero(
203b0 4d 29 20 20 20 28 4d 29 21 3d 30 0a 23 65 6e 64 M) (M)!=0.#end
203c0 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 53 51 4c if../*.** An SQL
203d0 20 70 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e parser context.
203e0 20 20 41 20 63 6f 70 79 20 6f 66 20 74 68 69 73 A copy of this
203f0 20 73 74 72 75 63 74 75 72 65 20 69 73 20 70 61 structure is pa
20400 73 73 65 64 20 74 68 72 6f 75 67 68 0a 2a 2a 20 ssed through.**
20410 74 68 65 20 70 61 72 73 65 72 20 61 6e 64 20 64 the parser and d
20420 6f 77 6e 20 69 6e 74 6f 20 61 6c 6c 20 74 68 65 own into all the
20430 20 70 61 72 73 65 72 20 61 63 74 69 6f 6e 20 72 parser action r
20440 6f 75 74 69 6e 65 20 69 6e 20 6f 72 64 65 72 20 outine in order
20450 74 6f 0a 2a 2a 20 63 61 72 72 79 20 61 72 6f 75 to.** carry arou
20460 6e 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 nd information t
20470 68 61 74 20 69 73 20 67 6c 6f 62 61 6c 20 74 6f hat is global to
20480 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 72 73 the entire pars
20490 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 74 72 e..**.** The str
204a0 75 63 74 75 72 65 20 69 73 20 64 69 76 69 64 65 ucture is divide
204b0 64 20 69 6e 74 6f 20 74 77 6f 20 70 61 72 74 73 d into two parts
204c0 2e 20 20 57 68 65 6e 20 74 68 65 20 70 61 72 73 . When the pars
204d0 65 72 20 61 6e 64 20 63 6f 64 65 0a 2a 2a 20 67 er and code.** g
204e0 65 6e 65 72 61 74 65 20 63 61 6c 6c 20 74 68 65 enerate call the
204f0 6d 73 65 6c 76 65 73 20 72 65 63 75 72 73 69 76 mselves recursiv
20500 65 6c 79 2c 20 74 68 65 20 66 69 72 73 74 20 70 ely, the first p
20510 61 72 74 20 6f 66 20 74 68 65 20 73 74 72 75 63 art of the struc
20520 74 75 72 65 0a 2a 2a 20 69 73 20 63 6f 6e 73 74 ture.** is const
20530 61 6e 74 20 62 75 74 20 74 68 65 20 73 65 63 6f ant but the seco
20540 6e 64 20 70 61 72 74 20 69 73 20 72 65 73 65 74 nd part is reset
20550 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e at the beginnin
20560 67 20 61 6e 64 20 65 6e 64 20 6f 66 0a 2a 2a 20 g and end of.**
20570 65 61 63 68 20 72 65 63 75 72 73 69 6f 6e 2e 0a each recursion..
20580 2a 2a 0a 2a 2a 20 54 68 65 20 6e 54 61 62 6c 65 **.** The nTable
20590 4c 6f 63 6b 20 61 6e 64 20 61 54 61 62 6c 65 4c Lock and aTableL
205a0 6f 63 6b 20 76 61 72 69 61 62 6c 65 73 20 61 72 ock variables ar
205b0 65 20 6f 6e 6c 79 20 75 73 65 64 20 69 66 20 74 e only used if t
205c0 68 65 20 73 68 61 72 65 64 2d 63 61 63 68 65 0a he shared-cache.
205d0 2a 2a 20 66 65 61 74 75 72 65 20 69 73 20 65 6e ** feature is en
205e0 61 62 6c 65 64 20 28 69 66 20 73 71 6c 69 74 65 abled (if sqlite
205f0 33 54 73 64 28 29 2d 3e 75 73 65 53 68 61 72 65 3Tsd()->useShare
20600 64 44 61 74 61 20 69 73 20 74 72 75 65 29 2e 20 dData is true).
20610 54 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 65 64 They are.** used
20620 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 73 65 to store the se
20630 74 20 6f 66 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 t of table-locks
20640 20 72 65 71 75 69 72 65 64 20 62 79 20 74 68 65 required by the
20650 20 73 74 61 74 65 6d 65 6e 74 20 62 65 69 6e 67 statement being
20660 0a 2a 2a 20 63 6f 6d 70 69 6c 65 64 2e 20 46 75 .** compiled. Fu
20670 6e 63 74 69 6f 6e 20 73 71 6c 69 74 65 33 54 61 nction sqlite3Ta
20680 62 6c 65 4c 6f 63 6b 28 29 20 69 73 20 75 73 65 bleLock() is use
20690 64 20 74 6f 20 61 64 64 20 65 6e 74 72 69 65 73 d to add entries
206a0 20 74 6f 20 74 68 65 0a 2a 2a 20 6c 69 73 74 2e to the.** list.
206b0 0a 2a 2f 0a 73 74 72 75 63 74 20 50 61 72 73 65 .*/.struct Parse
206c0 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 {. sqlite3 *db
206d0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 ; /* The
206e0 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 73 main database s
206f0 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 63 68 tructure */. ch
20700 61 72 20 2a 7a 45 72 72 4d 73 67 3b 20 20 20 20 ar *zErrMsg;
20710 20 20 20 2f 2a 20 41 6e 20 65 72 72 6f 72 20 6d /* An error m
20720 65 73 73 61 67 65 20 2a 2f 0a 20 20 56 64 62 65 essage */. Vdbe
20730 20 2a 70 56 64 62 65 3b 20 20 20 20 20 20 20 20 *pVdbe;
20740 20 2f 2a 20 41 6e 20 65 6e 67 69 6e 65 20 66 6f /* An engine fo
20750 72 20 65 78 65 63 75 74 69 6e 67 20 64 61 74 61 r executing data
20760 62 61 73 65 20 62 79 74 65 63 6f 64 65 20 2a 2f base bytecode */
20770 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
20780 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 /* Retur
20790 6e 20 63 6f 64 65 20 66 72 6f 6d 20 65 78 65 63 n code from exec
207a0 75 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 63 6f ution */. u8 co
207b0 6c 4e 61 6d 65 73 53 65 74 3b 20 20 20 20 20 20 lNamesSet;
207c0 2f 2a 20 54 52 55 45 20 61 66 74 65 72 20 4f 50 /* TRUE after OP
207d0 5f 43 6f 6c 75 6d 6e 4e 61 6d 65 20 68 61 73 20 _ColumnName has
207e0 62 65 65 6e 20 69 73 73 75 65 64 20 74 6f 20 70 been issued to p
207f0 56 64 62 65 20 2a 2f 0a 20 20 75 38 20 63 68 65 Vdbe */. u8 che
20800 63 6b 53 63 68 65 6d 61 3b 20 20 20 20 20 20 2f ckSchema; /
20810 2a 20 43 61 75 73 65 73 20 73 63 68 65 6d 61 20 * Causes schema
20820 63 6f 6f 6b 69 65 20 63 68 65 63 6b 20 61 66 74 cookie check aft
20830 65 72 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 er an error */.
20840 20 75 38 20 6e 65 73 74 65 64 3b 20 20 20 20 20 u8 nested;
20850 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
20860 6f 66 20 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 of nested calls
20870 74 6f 20 74 68 65 20 70 61 72 73 65 72 2f 63 6f to the parser/co
20880 64 65 20 67 65 6e 65 72 61 74 6f 72 20 2a 2f 0a de generator */.
20890 20 20 75 38 20 6e 54 65 6d 70 52 65 67 3b 20 20 u8 nTempReg;
208a0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
208b0 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 72 65 of temporary re
208c0 67 69 73 74 65 72 73 20 69 6e 20 61 54 65 6d 70 gisters in aTemp
208d0 52 65 67 5b 5d 20 2a 2f 0a 20 20 75 38 20 69 73 Reg[] */. u8 is
208e0 4d 75 6c 74 69 57 72 69 74 65 3b 20 20 20 20 20 MultiWrite;
208f0 2f 2a 20 54 72 75 65 20 69 66 20 73 74 61 74 65 /* True if state
20900 6d 65 6e 74 20 6d 61 79 20 6d 6f 64 69 66 79 2f ment may modify/
20910 69 6e 73 65 72 74 20 6d 75 6c 74 69 70 6c 65 20 insert multiple
20920 72 6f 77 73 20 2a 2f 0a 20 20 75 38 20 6d 61 79 rows */. u8 may
20930 41 62 6f 72 74 3b 20 20 20 20 20 20 20 20 20 2f Abort; /
20940 2a 20 54 72 75 65 20 69 66 20 73 74 61 74 65 6d * True if statem
20950 65 6e 74 20 6d 61 79 20 74 68 72 6f 77 20 61 6e ent may throw an
20960 20 41 42 4f 52 54 20 65 78 63 65 70 74 69 6f 6e ABORT exception
20970 20 2a 2f 0a 20 20 75 38 20 68 61 73 43 6f 6d 70 */. u8 hasComp
20980 6f 75 6e 64 3b 20 20 20 20 20 20 2f 2a 20 4e 65 ound; /* Ne
20990 65 64 20 74 6f 20 69 6e 76 6f 6b 65 20 63 6f 6e ed to invoke con
209a0 76 65 72 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 vertCompoundSele
209b0 63 74 54 6f 53 75 62 71 75 65 72 79 28 29 20 2a ctToSubquery() *
209c0 2f 0a 20 20 75 38 20 6f 6b 43 6f 6e 73 74 46 61 /. u8 okConstFa
209d0 63 74 6f 72 3b 20 20 20 20 2f 2a 20 4f 4b 20 74 ctor; /* OK t
209e0 6f 20 66 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e o factor out con
209f0 73 74 61 6e 74 73 20 2a 2f 0a 20 20 75 38 20 64 stants */. u8 d
20a00 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b isableLookaside;
20a10 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 /* Number of ti
20a20 6d 65 73 20 6c 6f 6f 6b 61 73 69 64 65 20 68 61 mes lookaside ha
20a30 73 20 62 65 65 6e 20 64 69 73 61 62 6c 65 64 20 s been disabled
20a40 2a 2f 0a 20 20 75 38 20 64 69 73 61 62 6c 65 56 */. u8 disableV
20a50 74 61 62 3b 20 20 20 20 20 20 2f 2a 20 44 69 73 tab; /* Dis
20a60 61 62 6c 65 20 61 6c 6c 20 76 69 72 74 75 61 6c able all virtual
20a70 20 74 61 62 6c 65 73 20 66 6f 72 20 74 68 69 73 tables for this
20a80 20 70 61 72 73 65 20 2a 2f 0a 20 20 69 6e 74 20 parse */. int
20a90 6e 52 61 6e 67 65 52 65 67 3b 20 20 20 20 20 20 nRangeReg;
20aa0 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 /* Size of the
20ab0 74 65 6d 70 6f 72 61 72 79 20 72 65 67 69 73 74 temporary regist
20ac0 65 72 20 62 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e er block */. in
20ad0 74 20 69 52 61 6e 67 65 52 65 67 3b 20 20 20 20 t iRangeReg;
20ae0 20 20 20 2f 2a 20 46 69 72 73 74 20 72 65 67 69 /* First regi
20af0 73 74 65 72 20 69 6e 20 74 65 6d 70 6f 72 61 72 ster in temporar
20b00 79 20 72 65 67 69 73 74 65 72 20 62 6c 6f 63 6b y register block
20b10 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 72 72 3b 20 */. int nErr;
20b20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
20b30 6d 62 65 72 20 6f 66 20 65 72 72 6f 72 73 20 73 mber of errors s
20b40 65 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 54 61 een */. int nTa
20b50 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a b; /*
20b60 20 4e 75 6d 62 65 72 20 6f 66 20 70 72 65 76 69 Number of previ
20b70 6f 75 73 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 ously allocated
20b80 56 44 42 45 20 63 75 72 73 6f 72 73 20 2a 2f 0a VDBE cursors */.
20b90 20 20 69 6e 74 20 6e 4d 65 6d 3b 20 20 20 20 20 int nMem;
20ba0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
20bb0 20 6f 66 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 of memory cells
20bc0 20 75 73 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a used so far */.
20bd0 20 20 69 6e 74 20 73 7a 4f 70 41 6c 6c 6f 63 3b int szOpAlloc;
20be0 20 20 20 20 20 20 20 2f 2a 20 42 79 74 65 73 20 /* Bytes
20bf0 6f 66 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 of memory space
20c00 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 56 64 allocated for Vd
20c10 62 65 2e 61 4f 70 5b 5d 20 2a 2f 0a 20 20 69 6e be.aOp[] */. in
20c20 74 20 69 53 65 6c 66 54 61 62 3b 20 20 20 20 20 t iSelfTab;
20c30 20 20 20 2f 2a 20 54 61 62 6c 65 20 61 73 73 6f /* Table asso
20c40 63 69 61 74 65 64 20 77 69 74 68 20 61 6e 20 69 ciated with an i
20c50 6e 64 65 78 20 6f 6e 20 65 78 70 72 2c 20 6f 72 ndex on expr, or
20c60 20 6e 65 67 61 74 69 76 65 0a 20 20 20 20 20 20 negative.
20c70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20c80 20 2a 2a 20 6f 66 20 74 68 65 20 62 61 73 65 20 ** of the base
20c90 72 65 67 69 73 74 65 72 20 64 75 72 69 6e 67 20 register during
20ca0 63 68 65 63 6b 2d 63 6f 6e 73 74 72 61 69 6e 74 check-constraint
20cb0 20 65 76 61 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e eval */. int n
20cc0 4c 61 62 65 6c 3b 20 20 20 20 20 20 20 20 20 20 Label;
20cd0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 61 62 /* Number of lab
20ce0 65 6c 73 20 75 73 65 64 20 2a 2f 0a 20 20 69 6e els used */. in
20cf0 74 20 2a 61 4c 61 62 65 6c 3b 20 20 20 20 20 20 t *aLabel;
20d00 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 68 /* Space to h
20d10 6f 6c 64 20 74 68 65 20 6c 61 62 65 6c 73 20 2a old the labels *
20d20 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 /. ExprList *pC
20d30 6f 6e 73 74 45 78 70 72 3b 2f 2a 20 43 6f 6e 73 onstExpr;/* Cons
20d40 74 61 6e 74 20 65 78 70 72 65 73 73 69 6f 6e 73 tant expressions
20d50 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 63 6f 6e 73 */. Token cons
20d60 74 72 61 69 6e 74 4e 61 6d 65 3b 2f 2a 20 4e 61 traintName;/* Na
20d70 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 73 74 72 me of the constr
20d80 61 69 6e 74 20 63 75 72 72 65 6e 74 6c 79 20 62 aint currently b
20d90 65 69 6e 67 20 70 61 72 73 65 64 20 2a 2f 0a 20 eing parsed */.
20da0 20 79 44 62 4d 61 73 6b 20 77 72 69 74 65 4d 61 yDbMask writeMa
20db0 73 6b 3b 20 20 20 2f 2a 20 53 74 61 72 74 20 61 sk; /* Start a
20dc0 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 write transacti
20dd0 6f 6e 20 6f 6e 20 74 68 65 73 65 20 64 61 74 61 on on these data
20de0 62 61 73 65 73 20 2a 2f 0a 20 20 79 44 62 4d 61 bases */. yDbMa
20df0 73 6b 20 63 6f 6f 6b 69 65 4d 61 73 6b 3b 20 20 sk cookieMask;
20e00 2f 2a 20 42 69 74 6d 61 73 6b 20 6f 66 20 73 63 /* Bitmask of sc
20e10 68 65 6d 61 20 76 65 72 69 66 69 65 64 20 64 61 hema verified da
20e20 74 61 62 61 73 65 73 20 2a 2f 0a 20 20 69 6e 74 tabases */. int
20e30 20 72 65 67 52 6f 77 69 64 3b 20 20 20 20 20 20 regRowid;
20e40 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 68 6f /* Register ho
20e50 6c 64 69 6e 67 20 72 6f 77 69 64 20 6f 66 20 43 lding rowid of C
20e60 52 45 41 54 45 20 54 41 42 4c 45 20 65 6e 74 72 REATE TABLE entr
20e70 79 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 52 6f y */. int regRo
20e80 6f 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 52 ot; /* R
20e90 65 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 egister holding
20ea0 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 root page number
20eb0 20 66 6f 72 20 6e 65 77 20 6f 62 6a 65 63 74 73 for new objects
20ec0 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 78 41 72 */. int nMaxAr
20ed0 67 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 g; /* Ma
20ee0 78 20 61 72 67 73 20 70 61 73 73 65 64 20 74 6f x args passed to
20ef0 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 20 62 user function b
20f00 79 20 73 75 62 2d 70 72 6f 67 72 61 6d 20 2a 2f y sub-program */
20f10 0a 20 20 69 6e 74 20 6e 53 65 6c 65 63 74 3b 20 . int nSelect;
20f20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
20f30 72 20 6f 66 20 53 45 4c 45 43 54 20 73 74 6d 74 r of SELECT stmt
20f40 73 2e 20 43 6f 75 6e 74 65 72 20 66 6f 72 20 53 s. Counter for S
20f50 65 6c 65 63 74 2e 73 65 6c 49 64 20 2a 2f 0a 23 elect.selId */.#
20f60 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
20f70 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
20f80 20 20 69 6e 74 20 6e 54 61 62 6c 65 4c 6f 63 6b int nTableLock
20f90 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 ; /* Numb
20fa0 65 72 20 6f 66 20 6c 6f 63 6b 73 20 69 6e 20 61 er of locks in a
20fb0 54 61 62 6c 65 4c 6f 63 6b 20 2a 2f 0a 20 20 54 TableLock */. T
20fc0 61 62 6c 65 4c 6f 63 6b 20 2a 61 54 61 62 6c 65 ableLock *aTable
20fd0 4c 6f 63 6b 3b 20 2f 2a 20 52 65 71 75 69 72 65 Lock; /* Require
20fe0 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 20 66 6f d table locks fo
20ff0 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d r shared-cache m
21000 6f 64 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 ode */.#endif.
21010 41 75 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 41 69 AutoincInfo *pAi
21020 6e 63 3b 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 nc; /* Informat
21030 69 6f 6e 20 61 62 6f 75 74 20 41 55 54 4f 49 4e ion about AUTOIN
21040 43 52 45 4d 45 4e 54 20 63 6f 75 6e 74 65 72 73 CREMENT counters
21050 20 2a 2f 0a 20 20 50 61 72 73 65 20 2a 70 54 6f */. Parse *pTo
21060 70 6c 65 76 65 6c 3b 20 20 20 20 2f 2a 20 50 61 plevel; /* Pa
21070 72 73 65 20 73 74 72 75 63 74 75 72 65 20 66 6f rse structure fo
21080 72 20 6d 61 69 6e 20 70 72 6f 67 72 61 6d 20 28 r main program (
21090 6f 72 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 54 61 or NULL) */. Ta
210a0 62 6c 65 20 2a 70 54 72 69 67 67 65 72 54 61 62 ble *pTriggerTab
210b0 3b 20 20 2f 2a 20 54 61 62 6c 65 20 74 72 69 67 ; /* Table trig
210c0 67 65 72 73 20 61 72 65 20 62 65 69 6e 67 20 63 gers are being c
210d0 6f 64 65 64 20 66 6f 72 20 2a 2f 0a 20 20 69 6e oded for */. in
210e0 74 20 61 64 64 72 43 72 54 61 62 3b 20 20 20 20 t addrCrTab;
210f0 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 /* Address of
21100 20 4f 50 5f 43 72 65 61 74 65 42 74 72 65 65 20 OP_CreateBtree
21110 6f 70 63 6f 64 65 20 6f 6e 20 43 52 45 41 54 45 opcode on CREATE
21120 20 54 41 42 4c 45 20 2a 2f 0a 20 20 75 33 32 20 TABLE */. u32
21130 6e 51 75 65 72 79 4c 6f 6f 70 3b 20 20 20 20 20 nQueryLoop;
21140 20 2f 2a 20 45 73 74 20 6e 75 6d 62 65 72 20 6f /* Est number o
21150 66 20 69 74 65 72 61 74 69 6f 6e 73 20 6f 66 20 f iterations of
21160 61 20 71 75 65 72 79 20 28 31 30 2a 6c 6f 67 32 a query (10*log2
21170 28 4e 29 29 20 2a 2f 0a 20 20 75 33 32 20 6f 6c (N)) */. u32 ol
21180 64 6d 61 73 6b 3b 20 20 20 20 20 20 20 20 20 2f dmask; /
21190 2a 20 4d 61 73 6b 20 6f 66 20 6f 6c 64 2e 2a 20 * Mask of old.*
211a0 63 6f 6c 75 6d 6e 73 20 72 65 66 65 72 65 6e 63 columns referenc
211b0 65 64 20 2a 2f 0a 20 20 75 33 32 20 6e 65 77 6d ed */. u32 newm
211c0 61 73 6b 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ask; /*
211d0 4d 61 73 6b 20 6f 66 20 6e 65 77 2e 2a 20 63 6f Mask of new.* co
211e0 6c 75 6d 6e 73 20 72 65 66 65 72 65 6e 63 65 64 lumns referenced
211f0 20 2a 2f 0a 20 20 75 38 20 65 54 72 69 67 67 65 */. u8 eTrigge
21200 72 4f 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 4b rOp; /* TK
21210 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e 53 45 _UPDATE, TK_INSE
21220 52 54 20 6f 72 20 54 4b 5f 44 45 4c 45 54 45 20 RT or TK_DELETE
21230 2a 2f 0a 20 20 75 38 20 65 4f 72 63 6f 6e 66 3b */. u8 eOrconf;
21240 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 /* Def
21250 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 ault ON CONFLICT
21260 20 70 6f 6c 69 63 79 20 66 6f 72 20 74 72 69 67 policy for trig
21270 67 65 72 20 73 74 65 70 73 20 2a 2f 0a 20 20 75 ger steps */. u
21280 38 20 64 69 73 61 62 6c 65 54 72 69 67 67 65 72 8 disableTrigger
21290 73 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 64 s; /* True to d
212a0 69 73 61 62 6c 65 20 74 72 69 67 67 65 72 73 20 isable triggers
212b0 2a 2f 0a 0a 20 20 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a */.. /*********
212c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
212d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
212e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
212f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21300 2a 0a 20 20 2a 2a 20 46 69 65 6c 64 73 20 61 62 *. ** Fields ab
21310 6f 76 65 20 6d 75 73 74 20 62 65 20 69 6e 69 74 ove must be init
21320 69 61 6c 69 7a 65 64 20 74 6f 20 7a 65 72 6f 2e ialized to zero.
21330 20 20 54 68 65 20 66 69 65 6c 64 73 20 74 68 61 The fields tha
21340 74 20 66 6f 6c 6c 6f 77 2c 0a 20 20 2a 2a 20 64 t follow,. ** d
21350 6f 77 6e 20 74 6f 20 74 68 65 20 62 65 67 69 6e own to the begin
21360 6e 69 6e 67 20 6f 66 20 74 68 65 20 72 65 63 75 ning of the recu
21370 72 73 69 76 65 20 73 65 63 74 69 6f 6e 2c 20 64 rsive section, d
21380 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 o not need to be
21390 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c 69 7a 65 . ** initialize
213a0 64 20 61 73 20 74 68 65 79 20 77 69 6c 6c 20 62 d as they will b
213b0 65 20 73 65 74 20 62 65 66 6f 72 65 20 62 65 69 e set before bei
213c0 6e 67 20 75 73 65 64 2e 20 20 54 68 65 20 62 6f ng used. The bo
213d0 75 6e 64 61 72 79 20 69 73 0a 20 20 2a 2a 20 64 undary is. ** d
213e0 65 74 65 72 6d 69 6e 65 64 20 62 79 20 6f 66 66 etermined by off
213f0 73 65 74 6f 66 28 50 61 72 73 65 2c 61 54 65 6d setof(Parse,aTem
21400 70 52 65 67 29 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a pReg).. *******
21410 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21420 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21430 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21440 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21450 2a 2a 2a 2f 0a 0a 20 20 69 6e 74 20 61 54 65 6d ***/.. int aTem
21460 70 52 65 67 5b 38 5d 3b 20 20 20 20 20 20 20 20 pReg[8];
21470 2f 2a 20 48 6f 6c 64 69 6e 67 20 61 72 65 61 20 /* Holding area
21480 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 72 65 for temporary re
21490 67 69 73 74 65 72 73 20 2a 2f 0a 20 20 54 6f 6b gisters */. Tok
214a0 65 6e 20 73 4e 61 6d 65 54 6f 6b 65 6e 3b 20 20 en sNameToken;
214b0 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 77 69 /* Token wi
214c0 74 68 20 75 6e 71 75 61 6c 69 66 69 65 64 20 73 th unqualified s
214d0 63 68 65 6d 61 20 6f 62 6a 65 63 74 20 6e 61 6d chema object nam
214e0 65 20 2a 2f 0a 0a 20 20 2f 2a 2a 2a 2a 2a 2a 2a e */.. /*******
214f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21500 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21510 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21520 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21530 2a 0a 20 20 2a 2a 20 41 62 6f 76 65 20 69 73 20 *. ** Above is
21540 63 6f 6e 73 74 61 6e 74 20 62 65 74 77 65 65 6e constant between
21550 20 72 65 63 75 72 73 69 6f 6e 73 2e 20 20 42 65 recursions. Be
21560 6c 6f 77 20 69 73 20 72 65 73 65 74 20 62 65 66 low is reset bef
21570 6f 72 65 20 61 6e 64 20 61 66 74 65 72 0a 20 20 ore and after.
21580 2a 2a 20 65 61 63 68 20 72 65 63 75 72 73 69 6f ** each recursio
21590 6e 2e 20 20 54 68 65 20 62 6f 75 6e 64 61 72 79 n. The boundary
215a0 20 62 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 between these t
215b0 77 6f 20 72 65 67 69 6f 6e 73 20 69 73 20 64 65 wo regions is de
215c0 74 65 72 6d 69 6e 65 64 0a 20 20 2a 2a 20 75 73 termined. ** us
215d0 69 6e 67 20 6f 66 66 73 65 74 6f 66 28 50 61 72 ing offsetof(Par
215e0 73 65 2c 73 4c 61 73 74 54 6f 6b 65 6e 29 20 73 se,sLastToken) s
215f0 6f 20 74 68 65 20 73 4c 61 73 74 54 6f 6b 65 6e o the sLastToken
21600 20 66 69 65 6c 64 20 6d 75 73 74 20 62 65 20 74 field must be t
21610 68 65 0a 20 20 2a 2a 20 66 69 72 73 74 20 66 69 he. ** first fi
21620 65 6c 64 20 69 6e 20 74 68 65 20 72 65 63 75 72 eld in the recur
21630 73 69 76 65 20 72 65 67 69 6f 6e 2e 0a 20 20 2a sive region.. *
21640 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21650 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21660 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21670 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
21680 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 54 6f 6b 65 *******/.. Toke
21690 6e 20 73 4c 61 73 74 54 6f 6b 65 6e 3b 20 20 20 n sLastToken;
216a0 20 20 20 20 2f 2a 20 54 68 65 20 6c 61 73 74 20 /* The last
216b0 74 6f 6b 65 6e 20 70 61 72 73 65 64 20 2a 2f 0a token parsed */.
216c0 20 20 79 6e 56 61 72 20 6e 56 61 72 3b 20 20 20 ynVar nVar;
216d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
216e0 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 76 61 72 umber of '?' var
216f0 69 61 62 6c 65 73 20 73 65 65 6e 20 69 6e 20 74 iables seen in t
21700 68 65 20 53 51 4c 20 73 6f 20 66 61 72 20 2a 2f he SQL so far */
21710 0a 20 20 75 38 20 69 50 6b 53 6f 72 74 4f 72 64 . u8 iPkSortOrd
21720 65 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 er; /*
21730 41 53 43 20 6f 72 20 44 45 53 43 20 66 6f 72 20 ASC or DESC for
21740 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 INTEGER PRIMARY
21750 4b 45 59 20 2a 2f 0a 20 20 75 38 20 65 78 70 6c KEY */. u8 expl
21760 61 69 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 ain;
21770 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 /* True if th
21780 65 20 45 58 50 4c 41 49 4e 20 66 6c 61 67 20 69 e EXPLAIN flag i
21790 73 20 66 6f 75 6e 64 20 6f 6e 20 74 68 65 20 71 s found on the q
217a0 75 65 72 79 20 2a 2f 0a 23 69 66 20 21 28 64 65 uery */.#if !(de
217b0 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 fined(SQLITE_OMI
217c0 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 20 T_VIRTUALTABLE)
217d0 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 && defined(SQLIT
217e0 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c E_OMIT_ALTERTABL
217f0 45 29 29 0a 20 20 75 38 20 65 50 61 72 73 65 4d E)). u8 eParseM
21800 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ode;
21810 2f 2a 20 50 41 52 53 45 5f 4d 4f 44 45 5f 58 58 /* PARSE_MODE_XX
21820 58 20 63 6f 6e 73 74 61 6e 74 20 2a 2f 0a 23 65 X constant */.#e
21830 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c ndif.#ifndef SQL
21840 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
21850 54 41 42 4c 45 0a 20 20 69 6e 74 20 6e 56 74 61 TABLE. int nVta
21860 62 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 20 bLock;
21870 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 76 /* Number of v
21880 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 74 6f irtual tables to
21890 20 6c 6f 63 6b 20 2a 2f 0a 23 65 6e 64 69 66 0a lock */.#endif.
218a0 20 20 69 6e 74 20 6e 48 65 69 67 68 74 3b 20 20 int nHeight;
218b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
218c0 78 70 72 65 73 73 69 6f 6e 20 74 72 65 65 20 68 xpression tree h
218d0 65 69 67 68 74 20 6f 66 20 63 75 72 72 65 6e 74 eight of current
218e0 20 73 75 62 2d 73 65 6c 65 63 74 20 2a 2f 0a 23 sub-select */.#
218f0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
21900 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69 6e 74 IT_EXPLAIN. int
21910 20 61 64 64 72 45 78 70 6c 61 69 6e 3b 20 20 20 addrExplain;
21920 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 /* Addres
21930 73 20 6f 66 20 63 75 72 72 65 6e 74 20 4f 50 5f s of current OP_
21940 45 78 70 6c 61 69 6e 20 6f 70 63 6f 64 65 20 2a Explain opcode *
21950 2f 0a 23 65 6e 64 69 66 0a 20 20 56 4c 69 73 74 /.#endif. VList
21960 20 2a 70 56 4c 69 73 74 3b 20 20 20 20 20 20 20 *pVList;
21970 20 20 20 20 20 2f 2a 20 4d 61 70 70 69 6e 67 20 /* Mapping
21980 62 65 74 77 65 65 6e 20 76 61 72 69 61 62 6c 65 between variable
21990 20 6e 61 6d 65 73 20 61 6e 64 20 6e 75 6d 62 65 names and numbe
219a0 72 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 52 rs */. Vdbe *pR
219b0 65 70 72 65 70 61 72 65 3b 20 20 20 20 20 20 20 eprepare;
219c0 20 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 72 65 /* VM being re
219d0 70 72 65 70 61 72 65 64 20 28 73 71 6c 69 74 65 prepared (sqlite
219e0 33 52 65 70 72 65 70 61 72 65 28 29 29 20 2a 2f 3Reprepare()) */
219f0 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
21a00 54 61 69 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 Tail; /*
21a10 41 6c 6c 20 53 51 4c 20 74 65 78 74 20 70 61 73 All SQL text pas
21a20 74 20 74 68 65 20 6c 61 73 74 20 73 65 6d 69 63 t the last semic
21a30 6f 6c 6f 6e 20 70 61 72 73 65 64 20 2a 2f 0a 20 olon parsed */.
21a40 20 54 61 62 6c 65 20 2a 70 4e 65 77 54 61 62 6c Table *pNewTabl
21a50 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 e; /* A
21a60 74 61 62 6c 65 20 62 65 69 6e 67 20 63 6f 6e 73 table being cons
21a70 74 72 75 63 74 65 64 20 62 79 20 43 52 45 41 54 tructed by CREAT
21a80 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 49 6e 64 E TABLE */. Ind
21a90 65 78 20 2a 70 4e 65 77 49 6e 64 65 78 3b 20 20 ex *pNewIndex;
21aa0 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 69 6e 64 /* An ind
21ab0 65 78 20 62 65 69 6e 67 20 63 6f 6e 73 74 72 75 ex being constru
21ac0 63 74 65 64 20 62 79 20 43 52 45 41 54 45 20 49 cted by CREATE I
21ad0 4e 44 45 58 20 2a 2f 0a 20 20 54 72 69 67 67 65 NDEX */. Trigge
21ae0 72 20 2a 70 4e 65 77 54 72 69 67 67 65 72 3b 20 r *pNewTrigger;
21af0 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 20 75 /* Trigger u
21b00 6e 64 65 72 20 63 6f 6e 73 74 72 75 63 74 20 62 nder construct b
21b10 79 20 61 20 43 52 45 41 54 45 20 54 52 49 47 47 y a CREATE TRIGG
21b20 45 52 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 ER */. const ch
21b30 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 65 78 74 ar *zAuthContext
21b40 3b 20 2f 2a 20 54 68 65 20 36 74 68 20 70 61 72 ; /* The 6th par
21b50 61 6d 65 74 65 72 20 74 6f 20 64 62 2d 3e 78 41 ameter to db->xA
21b60 75 74 68 20 63 61 6c 6c 62 61 63 6b 73 20 2a 2f uth callbacks */
21b70 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
21b80 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
21b90 45 0a 20 20 54 6f 6b 65 6e 20 73 41 72 67 3b 20 E. Token sArg;
21ba0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
21bb0 20 43 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f Complete text o
21bc0 66 20 61 20 6d 6f 64 75 6c 65 20 61 72 67 75 6d f a module argum
21bd0 65 6e 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a ent */. Table *
21be0 2a 61 70 56 74 61 62 4c 6f 63 6b 3b 20 20 20 20 *apVtabLock;
21bf0 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
21c00 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
21c10 6e 65 65 64 69 6e 67 20 6c 6f 63 6b 69 6e 67 20 needing locking
21c20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 54 61 62 6c */.#endif. Tabl
21c30 65 20 2a 70 5a 6f 6d 62 69 65 54 61 62 3b 20 20 e *pZombieTab;
21c40 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 /* List of
21c50 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 73 20 74 Table objects t
21c60 6f 20 64 65 6c 65 74 65 20 61 66 74 65 72 20 63 o delete after c
21c70 6f 64 65 20 67 65 6e 20 2a 2f 0a 20 20 54 72 69 ode gen */. Tri
21c80 67 67 65 72 50 72 67 20 2a 70 54 72 69 67 67 65 ggerPrg *pTrigge
21c90 72 50 72 67 3b 20 20 2f 2a 20 4c 69 6e 6b 65 64 rPrg; /* Linked
21ca0 20 6c 69 73 74 20 6f 66 20 63 6f 64 65 64 20 74 list of coded t
21cb0 72 69 67 67 65 72 73 20 2a 2f 0a 20 20 57 69 74 riggers */. Wit
21cc0 68 20 2a 70 57 69 74 68 3b 20 20 20 20 20 20 20 h *pWith;
21cd0 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e /* Curren
21ce0 74 20 57 49 54 48 20 63 6c 61 75 73 65 2c 20 6f t WITH clause, o
21cf0 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 57 69 74 68 r NULL */. With
21d00 20 2a 70 57 69 74 68 54 6f 46 72 65 65 3b 20 20 *pWithToFree;
21d10 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20 74 68 /* Free th
21d20 69 73 20 57 49 54 48 20 6f 62 6a 65 63 74 20 61 is WITH object a
21d30 74 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 t the end of the
21d40 20 70 61 72 73 65 20 2a 2f 0a 23 69 66 6e 64 65 parse */.#ifnde
21d50 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c f SQLITE_OMIT_AL
21d60 54 45 52 54 41 42 4c 45 0a 20 20 52 65 6e 61 6d TERTABLE. Renam
21d70 65 54 6f 6b 65 6e 20 2a 70 52 65 6e 61 6d 65 3b eToken *pRename;
21d80 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 73 20 73 /* Tokens s
21d90 75 62 6a 65 63 74 20 74 6f 20 72 65 6e 61 6d 69 ubject to renami
21da0 6e 67 20 62 79 20 41 4c 54 45 52 20 54 41 42 4c ng by ALTER TABL
21db0 45 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a E */.#endif.};..
21dc0 23 64 65 66 69 6e 65 20 50 41 52 53 45 5f 4d 4f #define PARSE_MO
21dd0 44 45 5f 4e 4f 52 4d 41 4c 20 20 20 20 20 20 20 DE_NORMAL
21de0 20 30 0a 23 64 65 66 69 6e 65 20 50 41 52 53 45 0.#define PARSE
21df0 5f 4d 4f 44 45 5f 44 45 43 4c 41 52 45 5f 56 54 _MODE_DECLARE_VT
21e00 41 42 20 20 31 0a 23 64 65 66 69 6e 65 20 50 41 AB 1.#define PA
21e10 52 53 45 5f 4d 4f 44 45 5f 52 45 4e 41 4d 45 5f RSE_MODE_RENAME_
21e20 43 4f 4c 55 4d 4e 20 32 0a 23 64 65 66 69 6e 65 COLUMN 2.#define
21e30 20 50 41 52 53 45 5f 4d 4f 44 45 5f 52 45 4e 41 PARSE_MODE_RENA
21e40 4d 45 5f 54 41 42 4c 45 20 20 33 0a 0a 2f 2a 0a ME_TABLE 3../*.
21e50 2a 2a 20 53 69 7a 65 73 20 61 6e 64 20 70 6f 69 ** Sizes and poi
21e60 6e 74 65 72 73 20 6f 66 20 76 61 72 69 6f 75 73 nters of various
21e70 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 50 61 parts of the Pa
21e80 72 73 65 20 6f 62 6a 65 63 74 2e 0a 2a 2f 0a 23 rse object..*/.#
21e90 64 65 66 69 6e 65 20 50 41 52 53 45 5f 48 44 52 define PARSE_HDR
21ea0 5f 53 5a 20 6f 66 66 73 65 74 6f 66 28 50 61 72 _SZ offsetof(Par
21eb0 73 65 2c 61 54 65 6d 70 52 65 67 29 20 2f 2a 20 se,aTempReg) /*
21ec0 52 65 63 75 72 73 69 76 65 20 70 61 72 74 20 77 Recursive part w
21ed0 2f 6f 20 61 43 6f 6c 43 61 63 68 65 2a 2f 0a 23 /o aColCache*/.#
21ee0 64 65 66 69 6e 65 20 50 41 52 53 45 5f 52 45 43 define PARSE_REC
21ef0 55 52 53 45 5f 53 5a 20 6f 66 66 73 65 74 6f 66 URSE_SZ offsetof
21f00 28 50 61 72 73 65 2c 73 4c 61 73 74 54 6f 6b 65 (Parse,sLastToke
21f10 6e 29 20 20 20 20 2f 2a 20 52 65 63 75 72 73 69 n) /* Recursi
21f20 76 65 20 70 61 72 74 20 2a 2f 0a 23 64 65 66 69 ve part */.#defi
21f30 6e 65 20 50 41 52 53 45 5f 54 41 49 4c 5f 53 5a ne PARSE_TAIL_SZ
21f40 20 28 73 69 7a 65 6f 66 28 50 61 72 73 65 29 2d (sizeof(Parse)-
21f50 50 41 52 53 45 5f 52 45 43 55 52 53 45 5f 53 5a PARSE_RECURSE_SZ
21f60 29 20 2f 2a 20 4e 6f 6e 2d 72 65 63 75 72 73 69 ) /* Non-recursi
21f70 76 65 20 70 61 72 74 20 2a 2f 0a 23 64 65 66 69 ve part */.#defi
21f80 6e 65 20 50 41 52 53 45 5f 54 41 49 4c 28 58 29 ne PARSE_TAIL(X)
21f90 20 28 28 28 63 68 61 72 2a 29 28 58 29 29 2b 50 (((char*)(X))+P
21fa0 41 52 53 45 5f 52 45 43 55 52 53 45 5f 53 5a 29 ARSE_RECURSE_SZ)
21fb0 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 /* Pointer to
21fc0 74 61 69 6c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 tail */../*.** R
21fd0 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 63 75 eturn true if cu
21fe0 72 72 65 6e 74 6c 79 20 69 6e 73 69 64 65 20 61 rrently inside a
21ff0 6e 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 n sqlite3_declar
22000 65 5f 76 74 61 62 28 29 20 63 61 6c 6c 2e 0a 2a e_vtab() call..*
22010 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
22020 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
22030 45 0a 20 20 23 64 65 66 69 6e 65 20 49 4e 5f 44 E. #define IN_D
22040 45 43 4c 41 52 45 5f 56 54 41 42 20 30 0a 23 65 ECLARE_VTAB 0.#e
22050 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 49 4e lse. #define IN
22060 5f 44 45 43 4c 41 52 45 5f 56 54 41 42 20 28 70 _DECLARE_VTAB (p
22070 50 61 72 73 65 2d 3e 65 50 61 72 73 65 4d 6f 64 Parse->eParseMod
22080 65 3d 3d 50 41 52 53 45 5f 4d 4f 44 45 5f 44 45 e==PARSE_MODE_DE
22090 43 4c 41 52 45 5f 56 54 41 42 29 0a 23 65 6e 64 CLARE_VTAB).#end
220a0 69 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 if..#if defined(
220b0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 SQLITE_OMIT_ALTE
220c0 52 54 41 42 4c 45 29 0a 20 20 23 64 65 66 69 6e RTABLE). #defin
220d0 65 20 49 4e 5f 52 45 4e 41 4d 45 5f 4f 42 4a 45 e IN_RENAME_OBJE
220e0 43 54 20 30 0a 23 65 6c 73 65 0a 20 20 23 64 65 CT 0.#else. #de
220f0 66 69 6e 65 20 49 4e 5f 52 45 4e 41 4d 45 5f 4f fine IN_RENAME_O
22100 42 4a 45 43 54 20 28 70 50 61 72 73 65 2d 3e 65 BJECT (pParse->e
22110 50 61 72 73 65 4d 6f 64 65 3e 3d 50 41 52 53 45 ParseMode>=PARSE
22120 5f 4d 4f 44 45 5f 52 45 4e 41 4d 45 5f 43 4f 4c _MODE_RENAME_COL
22130 55 4d 4e 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 UMN).#endif..#if
22140 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
22150 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
22160 45 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 E) && defined(SQ
22170 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 LITE_OMIT_ALTERT
22180 41 42 4c 45 29 0a 20 20 23 64 65 66 69 6e 65 20 ABLE). #define
22190 49 4e 5f 53 50 45 43 49 41 4c 5f 50 41 52 53 45 IN_SPECIAL_PARSE
221a0 20 30 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 0.#else. #defi
221b0 6e 65 20 49 4e 5f 53 50 45 43 49 41 4c 5f 50 41 ne IN_SPECIAL_PA
221c0 52 53 45 20 28 70 50 61 72 73 65 2d 3e 65 50 61 RSE (pParse->ePa
221d0 72 73 65 4d 6f 64 65 21 3d 50 41 52 53 45 5f 4d rseMode!=PARSE_M
221e0 4f 44 45 5f 4e 4f 52 4d 41 4c 29 0a 23 65 6e 64 ODE_NORMAL).#end
221f0 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 if../*.** An ins
22200 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c tance of the fol
22210 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 lowing structure
22220 20 63 61 6e 20 62 65 20 64 65 63 6c 61 72 65 64 can be declared
22230 20 6f 6e 20 61 20 73 74 61 63 6b 20 61 6e 64 20 on a stack and
22240 75 73 65 64 0a 2a 2a 20 74 6f 20 73 61 76 65 20 used.** to save
22250 74 68 65 20 50 61 72 73 65 2e 7a 41 75 74 68 43 the Parse.zAuthC
22260 6f 6e 74 65 78 74 20 76 61 6c 75 65 20 73 6f 20 ontext value so
22270 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 72 that it can be r
22280 65 73 74 6f 72 65 64 20 6c 61 74 65 72 2e 0a 2a estored later..*
22290 2f 0a 73 74 72 75 63 74 20 41 75 74 68 43 6f 6e /.struct AuthCon
222a0 74 65 78 74 20 7b 0a 20 20 63 6f 6e 73 74 20 63 text {. const c
222b0 68 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 65 78 har *zAuthContex
222c0 74 3b 20 20 20 2f 2a 20 50 75 74 20 73 61 76 65 t; /* Put save
222d0 64 20 50 61 72 73 65 2e 7a 41 75 74 68 43 6f 6e d Parse.zAuthCon
222e0 74 65 78 74 20 68 65 72 65 20 2a 2f 0a 20 20 50 text here */. P
222f0 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 20 arse *pParse;
22300 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
22310 65 20 50 61 72 73 65 20 73 74 72 75 63 74 75 72 e Parse structur
22320 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 42 e */.};../*.** B
22330 69 74 66 69 65 6c 64 20 66 6c 61 67 73 20 66 6f itfield flags fo
22340 72 20 50 35 20 76 61 6c 75 65 20 69 6e 20 76 61 r P5 value in va
22350 72 69 6f 75 73 20 6f 70 63 6f 64 65 73 2e 0a 2a rious opcodes..*
22360 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e 73 74 *.** Value const
22370 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 63 65 64 raints (enforced
22380 20 76 69 61 20 61 73 73 65 72 74 28 29 29 3a 0a via assert()):.
22390 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 4c 45 4e ** OPFLAG_LEN
223a0 47 54 48 41 52 47 20 20 20 20 3d 3d 20 53 51 4c GTHARG == SQL
223b0 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 0a ITE_FUNC_LENGTH.
223c0 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 54 59 50 ** OPFLAG_TYP
223d0 45 4f 46 41 52 47 20 20 20 20 3d 3d 20 53 51 4c EOFARG == SQL
223e0 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 0a ITE_FUNC_TYPEOF.
223f0 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 42 55 4c ** OPFLAG_BUL
22400 4b 43 53 52 20 20 20 20 20 20 3d 3d 20 42 54 52 KCSR == BTR
22410 45 45 5f 42 55 4c 4b 4c 4f 41 44 0a 2a 2a 20 20 EE_BULKLOAD.**
22420 20 20 4f 50 46 4c 41 47 5f 53 45 45 4b 45 51 20 OPFLAG_SEEKEQ
22430 20 20 20 20 20 20 3d 3d 20 42 54 52 45 45 5f 53 == BTREE_S
22440 45 45 4b 5f 45 51 0a 2a 2a 20 20 20 20 4f 50 46 EEK_EQ.** OPF
22450 4c 41 47 5f 46 4f 52 44 45 4c 45 54 45 20 20 20 LAG_FORDELETE
22460 20 3d 3d 20 42 54 52 45 45 5f 46 4f 52 44 45 4c == BTREE_FORDEL
22470 45 54 45 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 ETE.** OPFLAG
22480 5f 53 41 56 45 50 4f 53 49 54 49 4f 4e 20 3d 3d _SAVEPOSITION ==
22490 20 42 54 52 45 45 5f 53 41 56 45 50 4f 53 49 54 BTREE_SAVEPOSIT
224a0 49 4f 4e 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 ION.** OPFLAG
224b0 5f 41 55 58 44 45 4c 45 54 45 20 20 20 20 3d 3d _AUXDELETE ==
224c0 20 42 54 52 45 45 5f 41 55 58 44 45 4c 45 54 45 BTREE_AUXDELETE
224d0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c .*/.#define OPFL
224e0 41 47 5f 4e 43 48 41 4e 47 45 20 20 20 20 20 20 AG_NCHANGE
224f0 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 49 0x01 /* OP_I
22500 6e 73 65 72 74 3a 20 53 65 74 20 74 6f 20 75 70 nsert: Set to up
22510 64 61 74 65 20 64 62 2d 3e 6e 43 68 61 6e 67 65 date db->nChange
22520 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 */.
22530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22540 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 73 6f /* Also
22550 20 75 73 65 64 20 69 6e 20 50 32 20 28 6e 6f 74 used in P2 (not
22560 20 50 35 29 20 6f 66 20 4f 50 5f 44 65 6c 65 74 P5) of OP_Delet
22570 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 e */.#define OPF
22580 4c 41 47 5f 4e 4f 43 48 4e 47 20 20 20 20 20 20 LAG_NOCHNG
22590 20 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 0x01 /* OP_
225a0 56 43 6f 6c 75 6d 6e 20 6e 6f 63 68 61 6e 67 65 VColumn nochange
225b0 20 66 6f 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 for UPDATE */.#
225c0 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 45 50 define OPFLAG_EP
225d0 48 45 4d 20 20 20 20 20 20 20 20 20 30 78 30 31 HEM 0x01
225e0 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e /* OP_Column
225f0 3a 20 45 70 68 65 6d 65 72 61 6c 20 6f 75 74 70 : Ephemeral outp
22600 75 74 20 69 73 20 6f 6b 20 2a 2f 0a 23 64 65 66 ut is ok */.#def
22610 69 6e 65 20 4f 50 46 4c 41 47 5f 4c 41 53 54 52 ine OPFLAG_LASTR
22620 4f 57 49 44 20 20 20 20 20 30 78 32 30 20 20 20 OWID 0x20
22630 20 2f 2a 20 53 65 74 20 74 6f 20 75 70 64 61 74 /* Set to updat
22640 65 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 64 20 e db->lastRowid
22650 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
22660 47 5f 49 53 55 50 44 41 54 45 20 20 20 20 20 20 G_ISUPDATE
22670 30 78 30 34 20 20 20 20 2f 2a 20 54 68 69 73 20 0x04 /* This
22680 4f 50 5f 49 6e 73 65 72 74 20 69 73 20 61 6e 20 OP_Insert is an
22690 73 71 6c 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 sql UPDATE */.#d
226a0 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 41 50 50 efine OPFLAG_APP
226b0 45 4e 44 20 20 20 20 20 20 20 20 30 78 30 38 20 END 0x08
226c0 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 6c 69 /* This is li
226d0 6b 65 6c 79 20 74 6f 20 62 65 20 61 6e 20 61 70 kely to be an ap
226e0 70 65 6e 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 pend */.#define
226f0 4f 50 46 4c 41 47 5f 55 53 45 53 45 45 4b 52 45 OPFLAG_USESEEKRE
22700 53 55 4c 54 20 30 78 31 30 20 20 20 20 2f 2a 20 SULT 0x10 /*
22710 54 72 79 20 74 6f 20 61 76 6f 69 64 20 61 20 73 Try to avoid a s
22720 65 65 6b 20 69 6e 20 42 74 72 65 65 49 6e 73 65 eek in BtreeInse
22730 72 74 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 rt() */.#define
22740 4f 50 46 4c 41 47 5f 49 53 4e 4f 4f 50 20 20 20 OPFLAG_ISNOOP
22750 20 20 20 20 20 30 78 34 30 20 20 20 20 2f 2a 20 0x40 /*
22760 4f 50 5f 44 65 6c 65 74 65 20 64 6f 65 73 20 70 OP_Delete does p
22770 72 65 2d 75 70 64 61 74 65 2d 68 6f 6f 6b 20 6f re-update-hook o
22780 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f nly */.#define O
22790 50 46 4c 41 47 5f 4c 45 4e 47 54 48 41 52 47 20 PFLAG_LENGTHARG
227a0 20 20 20 20 30 78 34 30 20 20 20 20 2f 2a 20 4f 0x40 /* O
227b0 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 P_Column only us
227c0 65 64 20 66 6f 72 20 6c 65 6e 67 74 68 28 29 20 ed for length()
227d0 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
227e0 47 5f 54 59 50 45 4f 46 41 52 47 20 20 20 20 20 G_TYPEOFARG
227f0 30 78 38 30 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 0x80 /* OP_Co
22800 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 65 64 20 66 lumn only used f
22810 6f 72 20 74 79 70 65 6f 66 28 29 20 2a 2f 0a 23 or typeof() */.#
22820 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 42 55 define OPFLAG_BU
22830 4c 4b 43 53 52 20 20 20 20 20 20 20 30 78 30 31 LKCSR 0x01
22840 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 2a 2a /* OP_Open**
22850 20 75 73 65 64 20 74 6f 20 6f 70 65 6e 20 62 75 used to open bu
22860 6c 6b 20 63 75 72 73 6f 72 20 2a 2f 0a 23 64 65 lk cursor */.#de
22870 66 69 6e 65 20 4f 50 46 4c 41 47 5f 53 45 45 4b fine OPFLAG_SEEK
22880 45 51 20 20 20 20 20 20 20 20 30 78 30 32 20 20 EQ 0x02
22890 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 2a 2a 20 63 /* OP_Open** c
228a0 75 72 73 6f 72 20 75 73 65 73 20 45 51 20 73 65 ursor uses EQ se
228b0 65 6b 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 ek only */.#defi
228c0 6e 65 20 4f 50 46 4c 41 47 5f 46 4f 52 44 45 4c ne OPFLAG_FORDEL
228d0 45 54 45 20 20 20 20 20 30 78 30 38 20 20 20 20 ETE 0x08
228e0 2f 2a 20 4f 50 5f 4f 70 65 6e 20 73 68 6f 75 6c /* OP_Open shoul
228f0 64 20 75 73 65 20 42 54 52 45 45 5f 46 4f 52 44 d use BTREE_FORD
22900 45 4c 45 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 ELETE */.#define
22910 20 4f 50 46 4c 41 47 5f 50 32 49 53 52 45 47 20 OPFLAG_P2ISREG
22920 20 20 20 20 20 20 30 78 31 30 20 20 20 20 2f 2a 0x10 /*
22930 20 50 32 20 74 6f 20 4f 50 5f 4f 70 65 6e 2a 2a P2 to OP_Open**
22940 20 69 73 20 61 20 72 65 67 69 73 74 65 72 20 6e is a register n
22950 75 6d 62 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 umber */.#define
22960 20 4f 50 46 4c 41 47 5f 50 45 52 4d 55 54 45 20 OPFLAG_PERMUTE
22970 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
22980 20 4f 50 5f 43 6f 6d 70 61 72 65 3a 20 75 73 65 OP_Compare: use
22990 20 74 68 65 20 70 65 72 6d 75 74 61 74 69 6f 6e the permutation
229a0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c */.#define OPFL
229b0 41 47 5f 53 41 56 45 50 4f 53 49 54 49 4f 4e 20 AG_SAVEPOSITION
229c0 20 30 78 30 32 20 20 20 20 2f 2a 20 4f 50 5f 44 0x02 /* OP_D
229d0 65 6c 65 74 65 2f 49 6e 73 65 72 74 3a 20 73 61 elete/Insert: sa
229e0 76 65 20 63 75 72 73 6f 72 20 70 6f 73 20 2a 2f ve cursor pos */
229f0 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
22a00 41 55 58 44 45 4c 45 54 45 20 20 20 20 20 30 78 AUXDELETE 0x
22a10 30 34 20 20 20 20 2f 2a 20 4f 50 5f 44 65 6c 65 04 /* OP_Dele
22a20 74 65 3a 20 69 6e 64 65 78 20 69 6e 20 61 20 44 te: index in a D
22a30 45 4c 45 54 45 20 6f 70 20 2a 2f 0a 23 64 65 66 ELETE op */.#def
22a40 69 6e 65 20 4f 50 46 4c 41 47 5f 4e 4f 43 48 4e ine OPFLAG_NOCHN
22a50 47 5f 4d 41 47 49 43 20 20 30 78 36 64 20 20 20 G_MAGIC 0x6d
22a60 20 2f 2a 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 /* OP_MakeRecor
22a70 64 3a 20 73 65 72 69 61 6c 74 79 70 65 20 31 30 d: serialtype 10
22a80 20 69 73 20 6f 6b 20 2a 2f 0a 0a 2f 2a 0a 20 2a is ok */../*. *
22a90 20 45 61 63 68 20 74 72 69 67 67 65 72 20 70 72 Each trigger pr
22aa0 65 73 65 6e 74 20 69 6e 20 74 68 65 20 64 61 74 esent in the dat
22ab0 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 abase schema is
22ac0 73 74 6f 72 65 64 20 61 73 20 61 6e 20 69 6e 73 stored as an ins
22ad0 74 61 6e 63 65 20 6f 66 0a 20 2a 20 73 74 72 75 tance of. * stru
22ae0 63 74 20 54 72 69 67 67 65 72 2e 0a 20 2a 0a 20 ct Trigger.. *.
22af0 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 69 6e * Pointers to in
22b00 73 74 61 6e 63 65 73 20 6f 66 20 73 74 72 75 63 stances of struc
22b10 74 20 54 72 69 67 67 65 72 20 61 72 65 20 73 74 t Trigger are st
22b20 6f 72 65 64 20 69 6e 20 74 77 6f 20 77 61 79 73 ored in two ways
22b30 2e 0a 20 2a 20 31 2e 20 49 6e 20 74 68 65 20 22 .. * 1. In the "
22b40 74 72 69 67 48 61 73 68 22 20 68 61 73 68 20 74 trigHash" hash t
22b50 61 62 6c 65 20 28 70 61 72 74 20 6f 66 20 74 68 able (part of th
22b60 65 20 73 71 6c 69 74 65 33 2a 20 74 68 61 74 20 e sqlite3* that
22b70 72 65 70 72 65 73 65 6e 74 73 20 74 68 65 0a 20 represents the.
22b80 2a 20 20 20 20 64 61 74 61 62 61 73 65 29 2e 20 * database).
22b90 54 68 69 73 20 61 6c 6c 6f 77 73 20 54 72 69 67 This allows Trig
22ba0 67 65 72 20 73 74 72 75 63 74 75 72 65 73 20 74 ger structures t
22bb0 6f 20 62 65 20 72 65 74 72 69 65 76 65 64 20 62 o be retrieved b
22bc0 79 20 6e 61 6d 65 2e 0a 20 2a 20 32 2e 20 41 6c y name.. * 2. Al
22bd0 6c 20 74 72 69 67 67 65 72 73 20 61 73 73 6f 63 l triggers assoc
22be0 69 61 74 65 64 20 77 69 74 68 20 61 20 73 69 6e iated with a sin
22bf0 67 6c 65 20 74 61 62 6c 65 20 66 6f 72 6d 20 61 gle table form a
22c00 20 6c 69 6e 6b 65 64 20 6c 69 73 74 2c 20 75 73 linked list, us
22c10 69 6e 67 20 74 68 65 0a 20 2a 20 20 20 20 70 4e ing the. * pN
22c20 65 78 74 20 6d 65 6d 62 65 72 20 6f 66 20 73 74 ext member of st
22c30 72 75 63 74 20 54 72 69 67 67 65 72 2e 20 41 20 ruct Trigger. A
22c40 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 66 pointer to the f
22c50 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 irst element of
22c60 74 68 65 0a 20 2a 20 20 20 20 6c 69 6e 6b 65 64 the. * linked
22c70 20 6c 69 73 74 20 69 73 20 73 74 6f 72 65 64 20 list is stored
22c80 61 73 20 74 68 65 20 22 70 54 72 69 67 67 65 72 as the "pTrigger
22c90 22 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 " member of the
22ca0 61 73 73 6f 63 69 61 74 65 64 0a 20 2a 20 20 20 associated. *
22cb0 20 73 74 72 75 63 74 20 54 61 62 6c 65 2e 0a 20 struct Table..
22cc0 2a 0a 20 2a 20 54 68 65 20 22 73 74 65 70 5f 6c *. * The "step_l
22cd0 69 73 74 22 20 6d 65 6d 62 65 72 20 70 6f 69 6e ist" member poin
22ce0 74 73 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 ts to the first
22cf0 65 6c 65 6d 65 6e 74 20 6f 66 20 61 20 6c 69 6e element of a lin
22d00 6b 65 64 20 6c 69 73 74 0a 20 2a 20 63 6f 6e 74 ked list. * cont
22d10 61 69 6e 69 6e 67 20 74 68 65 20 53 51 4c 20 73 aining the SQL s
22d20 74 61 74 65 6d 65 6e 74 73 20 73 70 65 63 69 66 tatements specif
22d30 69 65 64 20 61 73 20 74 68 65 20 74 72 69 67 67 ied as the trigg
22d40 65 72 20 70 72 6f 67 72 61 6d 2e 0a 20 2a 2f 0a er program.. */.
22d50 73 74 72 75 63 74 20 54 72 69 67 67 65 72 20 7b struct Trigger {
22d60 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 . char *zName;
22d70 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
22d80 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 72 e name of the tr
22d90 69 67 67 65 72 20 20 20 20 20 20 20 20 20 20 20 igger
22da0 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2f 0a */.
22db0 20 20 63 68 61 72 20 2a 74 61 62 6c 65 3b 20 20 char *table;
22dc0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
22dd0 20 74 61 62 6c 65 20 6f 72 20 76 69 65 77 20 74 table or view t
22de0 6f 20 77 68 69 63 68 20 74 68 65 20 74 72 69 67 o which the trig
22df0 67 65 72 20 61 70 70 6c 69 65 73 20 2a 2f 0a 20 ger applies */.
22e00 20 75 38 20 6f 70 3b 20 20 20 20 20 20 20 20 20 u8 op;
22e10 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 /* One
22e20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 2c 20 54 4b of TK_DELETE, TK
22e30 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e 53 45 _UPDATE, TK_INSE
22e40 52 54 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 RT */.
22e50 75 38 20 74 72 5f 74 6d 3b 20 20 20 20 20 20 20 u8 tr_tm;
22e60 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f /* One o
22e70 66 20 54 52 49 47 47 45 52 5f 42 45 46 4f 52 45 f TRIGGER_BEFORE
22e80 2c 20 54 52 49 47 47 45 52 5f 41 46 54 45 52 20 , TRIGGER_AFTER
22e90 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 68 65 6e */. Expr *pWhen
22ea0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
22eb0 54 68 65 20 57 48 45 4e 20 63 6c 61 75 73 65 20 The WHEN clause
22ec0 6f 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f of the expressio
22ed0 6e 20 28 6d 61 79 20 62 65 20 4e 55 4c 4c 29 20 n (may be NULL)
22ee0 2a 2f 0a 20 20 49 64 4c 69 73 74 20 2a 70 43 6f */. IdList *pCo
22ef0 6c 75 6d 6e 73 3b 20 20 20 20 20 20 20 2f 2a 20 lumns; /*
22f00 49 66 20 74 68 69 73 20 69 73 20 61 6e 20 55 50 If this is an UP
22f10 44 41 54 45 20 4f 46 20 3c 63 6f 6c 75 6d 6e 2d DATE OF <column-
22f20 6c 69 73 74 3e 20 74 72 69 67 67 65 72 2c 0a 20 list> trigger,.
22f30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22f40 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 the
22f50 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 69 73 <column-list> is
22f60 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a stored here */.
22f70 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d Schema *pSchem
22f80 61 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 63 68 a; /* Sch
22f90 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ema containing t
22fa0 68 65 20 74 72 69 67 67 65 72 20 2a 2f 0a 20 20 he trigger */.
22fb0 53 63 68 65 6d 61 20 2a 70 54 61 62 53 63 68 65 Schema *pTabSche
22fc0 6d 61 3b 20 20 20 20 20 2f 2a 20 53 63 68 65 6d ma; /* Schem
22fd0 61 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 a containing the
22fe0 20 74 61 62 6c 65 20 2a 2f 0a 20 20 54 72 69 67 table */. Trig
22ff0 67 65 72 53 74 65 70 20 2a 73 74 65 70 5f 6c 69 gerStep *step_li
23000 73 74 3b 20 2f 2a 20 4c 69 6e 6b 20 6c 69 73 74 st; /* Link list
23010 20 6f 66 20 74 72 69 67 67 65 72 20 70 72 6f 67 of trigger prog
23020 72 61 6d 20 73 74 65 70 73 20 20 20 20 20 20 20 ram steps
23030 20 20 20 20 20 20 2a 2f 0a 20 20 54 72 69 67 67 */. Trigg
23040 65 72 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 er *pNext;
23050 20 20 20 2f 2a 20 4e 65 78 74 20 74 72 69 67 67 /* Next trigg
23060 65 72 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 er associated wi
23070 74 68 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a th the table */.
23080 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 74 72 69 67 };../*.** A trig
23090 67 65 72 20 69 73 20 65 69 74 68 65 72 20 61 20 ger is either a
230a0 42 45 46 4f 52 45 20 6f 72 20 61 6e 20 41 46 54 BEFORE or an AFT
230b0 45 52 20 74 72 69 67 67 65 72 2e 20 20 54 68 65 ER trigger. The
230c0 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6e 73 74 following const
230d0 61 6e 74 73 0a 2a 2a 20 64 65 74 65 72 6d 69 6e ants.** determin
230e0 65 20 77 68 69 63 68 2e 0a 2a 2a 0a 2a 2a 20 49 e which..**.** I
230f0 66 20 74 68 65 72 65 20 61 72 65 20 6d 75 6c 74 f there are mult
23100 69 70 6c 65 20 74 72 69 67 67 65 72 73 2c 20 79 iple triggers, y
23110 6f 75 20 6d 69 67 68 74 20 6f 66 20 73 6f 6d 65 ou might of some
23120 20 42 45 46 4f 52 45 20 61 6e 64 20 73 6f 6d 65 BEFORE and some
23130 20 41 46 54 45 52 2e 0a 2a 2a 20 49 6e 20 74 68 AFTER..** In th
23140 61 74 20 63 61 73 65 73 2c 20 74 68 65 20 63 6f at cases, the co
23150 6e 73 74 61 6e 74 73 20 62 65 6c 6f 77 20 63 61 nstants below ca
23160 6e 20 62 65 20 4f 52 65 64 20 74 6f 67 65 74 68 n be ORed togeth
23170 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 54 er..*/.#define T
23180 52 49 47 47 45 52 5f 42 45 46 4f 52 45 20 20 31 RIGGER_BEFORE 1
23190 0a 23 64 65 66 69 6e 65 20 54 52 49 47 47 45 52 .#define TRIGGER
231a0 5f 41 46 54 45 52 20 20 20 32 0a 0a 2f 2a 0a 20 _AFTER 2../*.
231b0 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
231c0 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 53 struct TriggerS
231d0 74 65 70 20 69 73 20 75 73 65 64 20 74 6f 20 73 tep is used to s
231e0 74 6f 72 65 20 61 20 73 69 6e 67 6c 65 20 53 51 tore a single SQ
231f0 4c 20 73 74 61 74 65 6d 65 6e 74 0a 20 2a 20 74 L statement. * t
23200 68 61 74 20 69 73 20 61 20 70 61 72 74 20 6f 66 hat is a part of
23210 20 61 20 74 72 69 67 67 65 72 2d 70 72 6f 67 72 a trigger-progr
23220 61 6d 2e 0a 20 2a 0a 20 2a 20 49 6e 73 74 61 6e am.. *. * Instan
23230 63 65 73 20 6f 66 20 73 74 72 75 63 74 20 54 72 ces of struct Tr
23240 69 67 67 65 72 53 74 65 70 20 61 72 65 20 73 74 iggerStep are st
23250 6f 72 65 64 20 69 6e 20 61 20 73 69 6e 67 6c 79 ored in a singly
23260 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 28 6c 69 linked list (li
23270 6e 6b 65 64 0a 20 2a 20 75 73 69 6e 67 20 74 68 nked. * using th
23280 65 20 22 70 4e 65 78 74 22 20 6d 65 6d 62 65 72 e "pNext" member
23290 29 20 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 ) referenced by
232a0 74 68 65 20 22 73 74 65 70 5f 6c 69 73 74 22 20 the "step_list"
232b0 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 0a 20 2a member of the. *
232c0 20 61 73 73 6f 63 69 61 74 65 64 20 73 74 72 75 associated stru
232d0 63 74 20 54 72 69 67 67 65 72 20 69 6e 73 74 61 ct Trigger insta
232e0 6e 63 65 2e 20 54 68 65 20 66 69 72 73 74 20 65 nce. The first e
232f0 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 6c 69 lement of the li
23300 6e 6b 65 64 20 6c 69 73 74 20 69 73 0a 20 2a 20 nked list is. *
23310 74 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f the first step o
23320 66 20 74 68 65 20 74 72 69 67 67 65 72 2d 70 72 f the trigger-pr
23330 6f 67 72 61 6d 2e 0a 20 2a 0a 20 2a 20 54 68 65 ogram.. *. * The
23340 20 22 6f 70 22 20 6d 65 6d 62 65 72 20 69 6e 64 "op" member ind
23350 69 63 61 74 65 73 20 77 68 65 74 68 65 72 20 74 icates whether t
23360 68 69 73 20 69 73 20 61 20 22 44 45 4c 45 54 45 his is a "DELETE
23370 22 2c 20 22 49 4e 53 45 52 54 22 2c 20 22 55 50 ", "INSERT", "UP
23380 44 41 54 45 22 20 6f 72 0a 20 2a 20 22 53 45 4c DATE" or. * "SEL
23390 45 43 54 22 20 73 74 61 74 65 6d 65 6e 74 2e 20 ECT" statement.
233a0 54 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 20 The meanings of
233b0 74 68 65 20 6f 74 68 65 72 20 6d 65 6d 62 65 72 the other member
233c0 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 s is determined
233d0 62 79 20 74 68 65 0a 20 2a 20 76 61 6c 75 65 20 by the. * value
233e0 6f 66 20 22 6f 70 22 20 61 73 20 66 6f 6c 6c 6f of "op" as follo
233f0 77 73 3a 0a 20 2a 0a 20 2a 20 28 6f 70 20 3d 3d ws:. *. * (op ==
23400 20 54 4b 5f 49 4e 53 45 52 54 29 0a 20 2a 20 6f TK_INSERT). * o
23410 72 63 6f 6e 66 20 20 20 20 2d 3e 20 73 74 6f 72 rconf -> stor
23420 65 73 20 74 68 65 20 4f 4e 20 43 4f 4e 46 4c 49 es the ON CONFLI
23430 43 54 20 61 6c 67 6f 72 69 74 68 6d 0a 20 2a 20 CT algorithm. *
23440 70 53 65 6c 65 63 74 20 20 20 2d 3e 20 49 66 20 pSelect -> If
23450 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45 52 this is an INSER
23460 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 4c 45 43 T INTO ... SELEC
23470 54 20 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 2c T ... statement,
23480 20 74 68 65 6e 0a 20 2a 20 20 20 20 20 20 20 20 then. *
23490 20 20 20 20 20 20 74 68 69 73 20 73 74 6f 72 65 this store
234a0 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 s a pointer to t
234b0 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d he SELECT statem
234c0 65 6e 74 2e 20 4f 74 68 65 72 77 69 73 65 20 4e ent. Otherwise N
234d0 55 4c 4c 2e 0a 20 2a 20 7a 54 61 72 67 65 74 20 ULL.. * zTarget
234e0 20 20 2d 3e 20 44 65 71 75 6f 74 65 64 20 6e 61 -> Dequoted na
234f0 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 me of the table
23500 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 6f 2e 0a to insert into..
23510 20 2a 20 70 45 78 70 72 4c 69 73 74 20 2d 3e 20 * pExprList ->
23520 49 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e If this is an IN
23530 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 56 41 SERT INTO ... VA
23540 4c 55 45 53 20 2e 2e 2e 20 73 74 61 74 65 6d 65 LUES ... stateme
23550 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 20 20 20 20 nt, then. *
23560 20 20 20 20 20 20 20 20 20 74 68 69 73 20 73 74 this st
23570 6f 72 65 73 20 76 61 6c 75 65 73 20 74 6f 20 62 ores values to b
23580 65 20 69 6e 73 65 72 74 65 64 2e 20 4f 74 68 65 e inserted. Othe
23590 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a 20 70 rwise NULL.. * p
235a0 49 64 4c 69 73 74 20 20 20 2d 3e 20 49 66 20 74 IdList -> If t
235b0 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45 52 54 his is an INSERT
235c0 20 49 4e 54 4f 20 2e 2e 2e 20 28 3c 63 6f 6c 75 INTO ... (<colu
235d0 6d 6e 2d 6e 61 6d 65 73 3e 29 20 56 41 4c 55 45 mn-names>) VALUE
235e0 53 20 2e 2e 2e 0a 20 2a 20 20 20 20 20 20 20 20 S .... *
235f0 20 20 20 20 20 20 73 74 61 74 65 6d 65 6e 74 2c statement,
23600 20 74 68 65 6e 20 74 68 69 73 20 73 74 6f 72 65 then this store
23610 73 20 74 68 65 20 63 6f 6c 75 6d 6e 2d 6e 61 6d s the column-nam
23620 65 73 20 74 6f 20 62 65 0a 20 2a 20 20 20 20 20 es to be. *
23630 20 20 20 20 20 20 20 20 20 69 6e 73 65 72 74 65 inserte
23640 64 20 69 6e 74 6f 2e 0a 20 2a 0a 20 2a 20 28 6f d into.. *. * (o
23650 70 20 3d 3d 20 54 4b 5f 44 45 4c 45 54 45 29 0a p == TK_DELETE).
23660 20 2a 20 7a 54 61 72 67 65 74 20 20 20 2d 3e 20 * zTarget ->
23670 44 65 71 75 6f 74 65 64 20 6e 61 6d 65 20 6f 66 Dequoted name of
23680 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 64 65 the table to de
23690 6c 65 74 65 20 66 72 6f 6d 2e 0a 20 2a 20 70 57 lete from.. * pW
236a0 68 65 72 65 20 20 20 20 2d 3e 20 54 68 65 20 57 here -> The W
236b0 48 45 52 45 20 63 6c 61 75 73 65 20 6f 66 20 74 HERE clause of t
236c0 68 65 20 44 45 4c 45 54 45 20 73 74 61 74 65 6d he DELETE statem
236d0 65 6e 74 20 69 66 20 6f 6e 65 20 69 73 20 73 70 ent if one is sp
236e0 65 63 69 66 69 65 64 2e 0a 20 2a 20 20 20 20 20 ecified.. *
236f0 20 20 20 20 20 20 20 20 20 4f 74 68 65 72 77 69 Otherwi
23700 73 65 20 4e 55 4c 4c 2e 0a 20 2a 0a 20 2a 20 28 se NULL.. *. * (
23710 6f 70 20 3d 3d 20 54 4b 5f 55 50 44 41 54 45 29 op == TK_UPDATE)
23720 0a 20 2a 20 7a 54 61 72 67 65 74 20 20 20 2d 3e . * zTarget ->
23730 20 44 65 71 75 6f 74 65 64 20 6e 61 6d 65 20 6f Dequoted name o
23740 66 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 75 f the table to u
23750 70 64 61 74 65 2e 0a 20 2a 20 70 57 68 65 72 65 pdate.. * pWhere
23760 20 20 20 20 2d 3e 20 54 68 65 20 57 48 45 52 45 -> The WHERE
23770 20 63 6c 61 75 73 65 20 6f 66 20 74 68 65 20 55 clause of the U
23780 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20 PDATE statement
23790 69 66 20 6f 6e 65 20 69 73 20 73 70 65 63 69 66 if one is specif
237a0 69 65 64 2e 0a 20 2a 20 20 20 20 20 20 20 20 20 ied.. *
237b0 20 20 20 20 20 4f 74 68 65 72 77 69 73 65 20 4e Otherwise N
237c0 55 4c 4c 2e 0a 20 2a 20 70 45 78 70 72 4c 69 73 ULL.. * pExprLis
237d0 74 20 2d 3e 20 41 20 6c 69 73 74 20 6f 66 20 74 t -> A list of t
237e0 68 65 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 75 70 he columns to up
237f0 64 61 74 65 20 61 6e 64 20 74 68 65 20 65 78 70 date and the exp
23800 72 65 73 73 69 6f 6e 73 20 74 6f 20 75 70 64 61 ressions to upda
23810 74 65 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 te. *
23820 20 20 20 74 68 65 6d 20 74 6f 2e 20 53 65 65 20 them to. See
23830 73 71 6c 69 74 65 33 55 70 64 61 74 65 28 29 20 sqlite3Update()
23840 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 documentation of
23850 20 22 70 43 68 61 6e 67 65 73 22 0a 20 2a 20 20 "pChanges". *
23860 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 75 argu
23870 6d 65 6e 74 2e 0a 20 2a 0a 20 2a 2f 0a 73 74 72 ment.. *. */.str
23880 75 63 74 20 54 72 69 67 67 65 72 53 74 65 70 20 uct TriggerStep
23890 7b 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 20 20 {. u8 op;
238a0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 /* One
238b0 6f 66 20 54 4b 5f 44 45 4c 45 54 45 2c 20 54 4b of TK_DELETE, TK
238c0 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e 53 45 _UPDATE, TK_INSE
238d0 52 54 2c 20 54 4b 5f 53 45 4c 45 43 54 20 2a 2f RT, TK_SELECT */
238e0 0a 20 20 75 38 20 6f 72 63 6f 6e 66 3b 20 20 20 . u8 orconf;
238f0 20 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f 52 6f /* OE_Ro
23900 6c 6c 62 61 63 6b 20 65 74 63 2e 20 2a 2f 0a 20 llback etc. */.
23910 20 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 3b Trigger *pTrig;
23920 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 72 69 /* The tri
23930 67 67 65 72 20 74 68 61 74 20 74 68 69 73 20 73 gger that this s
23940 74 65 70 20 69 73 20 61 20 70 61 72 74 20 6f 66 tep is a part of
23950 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 53 */. Select *pS
23960 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 53 45 elect; /* SE
23970 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20 6f LECT statement o
23980 72 20 52 48 53 20 6f 66 20 49 4e 53 45 52 54 20 r RHS of INSERT
23990 49 4e 54 4f 20 53 45 4c 45 43 54 20 2e 2e 2e 20 INTO SELECT ...
239a0 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 61 72 67 */. char *zTarg
239b0 65 74 3b 20 20 20 20 20 20 20 2f 2a 20 54 61 72 et; /* Tar
239c0 67 65 74 20 74 61 62 6c 65 20 66 6f 72 20 44 45 get table for DE
239d0 4c 45 54 45 2c 20 55 50 44 41 54 45 2c 20 49 4e LETE, UPDATE, IN
239e0 53 45 52 54 20 2a 2f 0a 20 20 45 78 70 72 20 2a SERT */. Expr *
239f0 70 57 68 65 72 65 3b 20 20 20 20 20 20 20 20 2f pWhere; /
23a00 2a 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 * The WHERE clau
23a10 73 65 20 66 6f 72 20 44 45 4c 45 54 45 20 6f 72 se for DELETE or
23a20 20 55 50 44 41 54 45 20 73 74 65 70 73 20 2a 2f UPDATE steps */
23a30 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 45 78 . ExprList *pEx
23a40 70 72 4c 69 73 74 3b 20 2f 2a 20 53 45 54 20 63 prList; /* SET c
23a50 6c 61 75 73 65 20 66 6f 72 20 55 50 44 41 54 45 lause for UPDATE
23a60 20 2a 2f 0a 20 20 49 64 4c 69 73 74 20 2a 70 49 */. IdList *pI
23a70 64 4c 69 73 74 3b 20 20 20 20 20 2f 2a 20 43 6f dList; /* Co
23a80 6c 75 6d 6e 20 6e 61 6d 65 73 20 66 6f 72 20 49 lumn names for I
23a90 4e 53 45 52 54 20 2a 2f 0a 20 20 55 70 73 65 72 NSERT */. Upser
23aa0 74 20 2a 70 55 70 73 65 72 74 3b 20 20 20 20 20 t *pUpsert;
23ab0 2f 2a 20 55 70 73 65 72 74 20 63 6c 61 75 73 65 /* Upsert clause
23ac0 73 20 6f 6e 20 61 6e 20 49 4e 53 45 52 54 20 2a s on an INSERT *
23ad0 2f 0a 20 20 63 68 61 72 20 2a 7a 53 70 61 6e 3b /. char *zSpan;
23ae0 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 67 /* Orig
23af0 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 20 6f 66 inal SQL text of
23b00 20 74 68 69 73 20 63 6f 6d 6d 61 6e 64 20 2a 2f this command */
23b10 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 20 2a . TriggerStep *
23b20 70 4e 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 pNext; /* Next
23b30 69 6e 20 74 68 65 20 6c 69 6e 6b 2d 6c 69 73 74 in the link-list
23b40 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 74 65 */. TriggerSte
23b50 70 20 2a 70 4c 61 73 74 3b 20 20 2f 2a 20 4c 61 p *pLast; /* La
23b60 73 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 6c 69 st element in li
23b70 6e 6b 2d 6c 69 73 74 2e 20 56 61 6c 69 64 20 66 nk-list. Valid f
23b80 6f 72 20 31 73 74 20 65 6c 65 6d 20 6f 6e 6c 79 or 1st elem only
23b90 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 */.};../*.** Th
23ba0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 e following stru
23bb0 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 20 69 cture contains i
23bc0 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 nformation used
23bd0 62 79 20 74 68 65 20 73 71 6c 69 74 65 46 69 78 by the sqliteFix
23be0 2e 2e 2e 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 20 ....** routines
23bf0 61 73 20 74 68 65 79 20 77 61 6c 6b 20 74 68 65 as they walk the
23c00 20 70 61 72 73 65 20 74 72 65 65 20 74 6f 20 6d parse tree to m
23c10 61 6b 65 20 64 61 74 61 62 61 73 65 20 72 65 66 ake database ref
23c20 65 72 65 6e 63 65 73 0a 2a 2a 20 65 78 70 6c 69 erences.** expli
23c30 63 69 74 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 cit..*/.typedef
23c40 73 74 72 75 63 74 20 44 62 46 69 78 65 72 20 44 struct DbFixer D
23c50 62 46 69 78 65 72 3b 0a 73 74 72 75 63 74 20 44 bFixer;.struct D
23c60 62 46 69 78 65 72 20 7b 0a 20 20 50 61 72 73 65 bFixer {. Parse
23c70 20 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 2f *pParse; /
23c80 2a 20 54 68 65 20 70 61 72 73 69 6e 67 20 63 6f * The parsing co
23c90 6e 74 65 78 74 2e 20 20 45 72 72 6f 72 20 6d 65 ntext. Error me
23ca0 73 73 61 67 65 73 20 77 72 69 74 74 65 6e 20 68 ssages written h
23cb0 65 72 65 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 ere */. Schema
23cc0 2a 70 53 63 68 65 6d 61 3b 20 20 20 20 2f 2a 20 *pSchema; /*
23cd0 46 69 78 20 69 74 65 6d 73 20 74 6f 20 74 68 69 Fix items to thi
23ce0 73 20 73 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e s schema */. in
23cf0 74 20 62 56 61 72 4f 6e 6c 79 3b 20 20 20 20 20 t bVarOnly;
23d00 20 20 2f 2a 20 43 68 65 63 6b 20 66 6f 72 20 76 /* Check for v
23d10 61 72 69 61 62 6c 65 20 72 65 66 65 72 65 6e 63 ariable referenc
23d20 65 73 20 6f 6e 6c 79 20 2a 2f 0a 20 20 63 6f 6e es only */. con
23d30 73 74 20 63 68 61 72 20 2a 7a 44 62 3b 20 20 20 st char *zDb;
23d40 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 61 6c /* Make sure al
23d50 6c 20 6f 62 6a 65 63 74 73 20 61 72 65 20 63 6f l objects are co
23d60 6e 74 61 69 6e 65 64 20 69 6e 20 74 68 69 73 20 ntained in this
23d70 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 63 6f database */. co
23d80 6e 73 74 20 63 68 61 72 20 2a 7a 54 79 70 65 3b nst char *zType;
23d90 20 20 2f 2a 20 54 79 70 65 20 6f 66 20 74 68 65 /* Type of the
23da0 20 63 6f 6e 74 61 69 6e 65 72 20 2d 20 75 73 65 container - use
23db0 64 20 66 6f 72 20 65 72 72 6f 72 20 6d 65 73 73 d for error mess
23dc0 61 67 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 ages */. const
23dd0 54 6f 6b 65 6e 20 2a 70 4e 61 6d 65 3b 20 2f 2a Token *pName; /*
23de0 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e Name of the con
23df0 74 61 69 6e 65 72 20 2d 20 75 73 65 64 20 66 6f tainer - used fo
23e00 72 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 r error messages
23e10 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
23e20 20 6f 62 6a 65 63 74 65 64 20 75 73 65 64 20 74 objected used t
23e30 6f 20 61 63 63 75 6d 75 6c 61 74 65 20 74 68 65 o accumulate the
23e40 20 74 65 78 74 20 6f 66 20 61 20 73 74 72 69 6e text of a strin
23e50 67 20 77 68 65 72 65 20 77 65 0a 2a 2a 20 64 6f g where we.** do
23e60 20 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 not necessarily
23e70 20 6b 6e 6f 77 20 68 6f 77 20 62 69 67 20 74 68 know how big th
23e80 65 20 73 74 72 69 6e 67 20 77 69 6c 6c 20 62 65 e string will be
23e90 20 69 6e 20 74 68 65 20 65 6e 64 2e 0a 2a 2f 0a in the end..*/.
23ea0 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 73 struct sqlite3_s
23eb0 74 72 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a tr {. sqlite3 *
23ec0 64 62 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f db; /* O
23ed0 70 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 ptional database
23ee0 20 66 6f 72 20 6c 6f 6f 6b 61 73 69 64 65 2e 20 for lookaside.
23ef0 20 43 61 6e 20 62 65 20 4e 55 4c 4c 20 2a 2f 0a Can be NULL */.
23f00 20 20 63 68 61 72 20 2a 7a 54 65 78 74 3b 20 20 char *zText;
23f10 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 74 /* The st
23f20 72 69 6e 67 20 63 6f 6c 6c 65 63 74 65 64 20 73 ring collected s
23f30 6f 20 66 61 72 20 2a 2f 0a 20 20 75 33 32 20 20 o far */. u32
23f40 6e 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20 nAlloc;
23f50 2f 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 73 70 61 /* Amount of spa
23f60 63 65 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 ce allocated in
23f70 7a 54 65 78 74 20 2a 2f 0a 20 20 75 33 32 20 20 zText */. u32
23f80 6d 78 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 mxAlloc;
23f90 2f 2a 20 4d 61 78 69 6d 75 6d 20 61 6c 6c 6f 77 /* Maximum allow
23fa0 65 64 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 ed allocation.
23fb0 30 20 66 6f 72 20 6e 6f 20 6d 61 6c 6c 6f 63 20 0 for no malloc
23fc0 75 73 61 67 65 20 2a 2f 0a 20 20 75 33 32 20 20 usage */. u32
23fd0 6e 43 68 61 72 3b 20 20 20 20 20 20 20 20 20 20 nChar;
23fe0 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 74 68 65 /* Length of the
23ff0 20 73 74 72 69 6e 67 20 73 6f 20 66 61 72 20 2a string so far *
24000 2f 0a 20 20 75 38 20 20 20 61 63 63 45 72 72 6f /. u8 accErro
24010 72 3b 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 49 r; /* SQLI
24020 54 45 5f 4e 4f 4d 45 4d 20 6f 72 20 53 51 4c 49 TE_NOMEM or SQLI
24030 54 45 5f 54 4f 4f 42 49 47 20 2a 2f 0a 20 20 75 TE_TOOBIG */. u
24040 38 20 20 20 70 72 69 6e 74 66 46 6c 61 67 73 3b 8 printfFlags;
24050 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 /* SQLITE_PR
24060 49 4e 54 46 20 66 6c 61 67 73 20 62 65 6c 6f 77 INTF flags below
24070 20 2a 2f 0a 7d 3b 0a 23 64 65 66 69 6e 65 20 53 */.};.#define S
24080 51 4c 49 54 45 5f 50 52 49 4e 54 46 5f 49 4e 54 QLITE_PRINTF_INT
24090 45 52 4e 41 4c 20 30 78 30 31 20 20 2f 2a 20 49 ERNAL 0x01 /* I
240a0 6e 74 65 72 6e 61 6c 2d 75 73 65 2d 6f 6e 6c 79 nternal-use-only
240b0 20 63 6f 6e 76 65 72 74 65 72 73 20 61 6c 6c 6f converters allo
240c0 77 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 wed */.#define S
240d0 51 4c 49 54 45 5f 50 52 49 4e 54 46 5f 53 51 4c QLITE_PRINTF_SQL
240e0 46 55 4e 43 20 20 30 78 30 32 20 20 2f 2a 20 53 FUNC 0x02 /* S
240f0 51 4c 20 66 75 6e 63 74 69 6f 6e 20 61 72 67 75 QL function argu
24100 6d 65 6e 74 73 20 74 6f 20 56 58 50 72 69 6e 74 ments to VXPrint
24110 66 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c f */.#define SQL
24120 49 54 45 5f 50 52 49 4e 54 46 5f 4d 41 4c 4c 4f ITE_PRINTF_MALLO
24130 43 45 44 20 30 78 30 34 20 20 2f 2a 20 54 72 75 CED 0x04 /* Tru
24140 65 20 69 66 20 78 54 65 78 74 20 69 73 20 61 6c e if xText is al
24150 6c 6f 63 61 74 65 64 20 73 70 61 63 65 20 2a 2f located space */
24160 0a 0a 23 64 65 66 69 6e 65 20 69 73 4d 61 6c 6c ..#define isMall
24170 6f 63 65 64 28 58 29 20 20 28 28 28 58 29 2d 3e oced(X) (((X)->
24180 70 72 69 6e 74 66 46 6c 61 67 73 20 26 20 53 51 printfFlags & SQ
24190 4c 49 54 45 5f 50 52 49 4e 54 46 5f 4d 41 4c 4c LITE_PRINTF_MALL
241a0 4f 43 45 44 29 21 3d 30 29 0a 0a 0a 2f 2a 0a 2a OCED)!=0).../*.*
241b0 2a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 * A pointer to t
241c0 68 69 73 20 73 74 72 75 63 74 75 72 65 20 69 73 his structure is
241d0 20 75 73 65 64 20 74 6f 20 63 6f 6d 6d 75 6e 69 used to communi
241e0 63 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e cate information
241f0 0a 2a 2a 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 .** from sqlite3
24200 49 6e 69 74 20 61 6e 64 20 4f 50 5f 50 61 72 73 Init and OP_Pars
24210 65 53 63 68 65 6d 61 20 69 6e 74 6f 20 74 68 65 eSchema into the
24220 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c sqlite3InitCall
24230 62 61 63 6b 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 back..*/.typedef
24240 20 73 74 72 75 63 74 20 7b 0a 20 20 73 71 6c 69 struct {. sqli
24250 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 te3 *db;
24260 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 /* The database
24270 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 being initialize
24280 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a d */. char **pz
24290 45 72 72 4d 73 67 3b 20 20 20 20 2f 2a 20 45 72 ErrMsg; /* Er
242a0 72 6f 72 20 6d 65 73 73 61 67 65 20 73 74 6f 72 ror message stor
242b0 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 ed here */. int
242c0 20 69 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 iDb;
242d0 20 2f 2a 20 30 20 66 6f 72 20 6d 61 69 6e 20 64 /* 0 for main d
242e0 61 74 61 62 61 73 65 2e 20 20 31 20 66 6f 72 20 atabase. 1 for
242f0 54 45 4d 50 2c 20 32 2e 2e 20 66 6f 72 20 41 54 TEMP, 2.. for AT
24300 54 41 43 48 65 64 20 2a 2f 0a 20 20 69 6e 74 20 TACHed */. int
24310 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rc;
24320 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 73 /* Result code s
24330 74 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 tored here */.
24340 75 33 32 20 6d 49 6e 69 74 46 6c 61 67 73 3b 20 u32 mInitFlags;
24350 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 63 6f 6e /* Flags con
24360 74 72 6f 6c 6c 69 6e 67 20 65 72 72 6f 72 20 6d trolling error m
24370 65 73 73 61 67 65 73 20 2a 2f 0a 7d 20 49 6e 69 essages */.} Ini
24380 74 44 61 74 61 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c tData;../*.** Al
24390 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 lowed values for
243a0 20 6d 49 6e 69 74 46 6c 61 67 73 0a 2a 2f 0a 23 mInitFlags.*/.#
243b0 64 65 66 69 6e 65 20 49 4e 49 54 46 4c 41 47 5f define INITFLAG_
243c0 41 6c 74 65 72 54 61 62 6c 65 20 20 20 30 78 30 AlterTable 0x0
243d0 30 30 31 20 20 2f 2a 20 54 68 69 73 20 69 73 20 001 /* This is
243e0 61 20 72 65 70 61 72 73 65 20 61 66 74 65 72 20 a reparse after
243f0 41 4c 54 45 52 20 54 41 42 4c 45 20 2a 2f 0a 0a ALTER TABLE */..
24400 2f 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72 65 20 /*.** Structure
24410 63 6f 6e 74 61 69 6e 69 6e 67 20 67 6c 6f 62 61 containing globa
24420 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 l configuration
24430 64 61 74 61 20 66 6f 72 20 74 68 65 20 53 51 4c data for the SQL
24440 69 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a 2a 0a ite library..**.
24450 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 72 ** This structur
24460 65 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 20 e also contains
24470 73 6f 6d 65 20 73 74 61 74 65 20 69 6e 66 6f 72 some state infor
24480 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 mation..*/.struc
24490 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 67 20 t Sqlite3Config
244a0 7b 0a 20 20 69 6e 74 20 62 4d 65 6d 73 74 61 74 {. int bMemstat
244b0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
244c0 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f /* True to
244d0 20 65 6e 61 62 6c 65 20 6d 65 6d 6f 72 79 20 73 enable memory s
244e0 74 61 74 75 73 20 2a 2f 0a 20 20 69 6e 74 20 62 tatus */. int b
244f0 43 6f 72 65 4d 75 74 65 78 3b 20 20 20 20 20 20 CoreMutex;
24500 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24510 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 63 True to enable c
24520 6f 72 65 20 6d 75 74 65 78 69 6e 67 20 2a 2f 0a ore mutexing */.
24530 20 20 69 6e 74 20 62 46 75 6c 6c 4d 75 74 65 78 int bFullMutex
24540 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
24550 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 /* True to e
24560 6e 61 62 6c 65 20 66 75 6c 6c 20 6d 75 74 65 78 nable full mutex
24570 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 4f 70 ing */. int bOp
24580 65 6e 55 72 69 3b 20 20 20 20 20 20 20 20 20 20 enUri;
24590 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
245a0 75 65 20 74 6f 20 69 6e 74 65 72 70 72 65 74 20 ue to interpret
245b0 66 69 6c 65 6e 61 6d 65 73 20 61 73 20 55 52 49 filenames as URI
245c0 73 20 2a 2f 0a 20 20 69 6e 74 20 62 55 73 65 43 s */. int bUseC
245d0 69 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 is;
245e0 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 /* Use
245f0 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 65 73 covering indices
24600 20 66 6f 72 20 66 75 6c 6c 2d 73 63 61 6e 73 20 for full-scans
24610 2a 2f 0a 20 20 69 6e 74 20 62 53 6d 61 6c 6c 4d */. int bSmallM
24620 61 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20 20 alloc;
24630 20 20 20 20 20 20 20 2f 2a 20 41 76 6f 69 64 20 /* Avoid
24640 6c 61 72 67 65 20 6d 65 6d 6f 72 79 20 61 6c 6c large memory all
24650 6f 63 61 74 69 6f 6e 73 20 69 66 20 74 72 75 65 ocations if true
24660 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 53 74 72 6c */. int mxStrl
24670 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 en;
24680 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d /* Maxim
24690 75 6d 20 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 um string length
246a0 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 76 65 72 43 */. int neverC
246b0 6f 72 72 75 70 74 3b 20 20 20 20 20 20 20 20 20 orrupt;
246c0 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
246d0 61 73 65 20 69 73 20 61 6c 77 61 79 73 20 77 65 ase is always we
246e0 6c 6c 2d 66 6f 72 6d 65 64 20 2a 2f 0a 20 20 69 ll-formed */. i
246f0 6e 74 20 73 7a 4c 6f 6f 6b 61 73 69 64 65 3b 20 nt szLookaside;
24700 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24710 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b /* Default look
24720 61 73 69 64 65 20 62 75 66 66 65 72 20 73 69 7a aside buffer siz
24730 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 6f 6b e */. int nLook
24740 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 aside;
24750 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 /* Defa
24760 75 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 ult lookaside bu
24770 66 66 65 72 20 63 6f 75 6e 74 20 2a 2f 0a 20 20 ffer count */.
24780 69 6e 74 20 6e 53 74 6d 74 53 70 69 6c 6c 3b 20 int nStmtSpill;
24790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
247a0 20 20 2f 2a 20 53 74 6d 74 2d 6a 6f 75 72 6e 61 /* Stmt-journa
247b0 6c 20 73 70 69 6c 6c 2d 74 6f 2d 64 69 73 6b 20 l spill-to-disk
247c0 74 68 72 65 73 68 6f 6c 64 20 2a 2f 0a 20 20 73 threshold */. s
247d0 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f qlite3_mem_metho
247e0 64 73 20 6d 3b 20 20 20 20 20 20 20 20 20 20 20 ds m;
247f0 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d 65 /* Low-level me
24800 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 mory allocation
24810 69 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 73 interface */. s
24820 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 qlite3_mutex_met
24830 68 6f 64 73 20 6d 75 74 65 78 3b 20 20 20 20 20 hods mutex;
24840 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d 75 /* Low-level mu
24850 74 65 78 20 69 6e 74 65 72 66 61 63 65 20 2a 2f tex interface */
24860 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 . sqlite3_pcach
24870 65 5f 6d 65 74 68 6f 64 73 32 20 70 63 61 63 68 e_methods2 pcach
24880 65 32 3b 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 e2; /* Low-leve
24890 6c 20 70 61 67 65 2d 63 61 63 68 65 20 69 6e 74 l page-cache int
248a0 65 72 66 61 63 65 20 2a 2f 0a 20 20 76 6f 69 64 erface */. void
248b0 20 2a 70 48 65 61 70 3b 20 20 20 20 20 20 20 20 *pHeap;
248c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
248d0 20 48 65 61 70 20 73 74 6f 72 61 67 65 20 73 70 Heap storage sp
248e0 61 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 48 65 ace */. int nHe
248f0 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ap;
24900 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
24910 7a 65 20 6f 66 20 70 48 65 61 70 5b 5d 20 2a 2f ze of pHeap[] */
24920 0a 20 20 69 6e 74 20 6d 6e 52 65 71 2c 20 6d 78 . int mnReq, mx
24930 52 65 71 3b 20 20 20 20 20 20 20 20 20 20 20 20 Req;
24940 20 20 20 20 20 2f 2a 20 4d 69 6e 20 61 6e 64 20 /* Min and
24950 6d 61 78 20 68 65 61 70 20 72 65 71 75 65 73 74 max heap request
24960 73 20 73 69 7a 65 73 20 2a 2f 0a 20 20 73 71 6c s sizes */. sql
24970 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 ite3_int64 szMma
24980 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f p; /
24990 2a 20 6d 6d 61 70 28 29 20 73 70 61 63 65 20 70 * mmap() space p
249a0 65 72 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f 0a er open file */.
249b0 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
249c0 6d 78 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 20 mxMmap;
249d0 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 76 /* Maximum v
249e0 61 6c 75 65 20 66 6f 72 20 73 7a 4d 6d 61 70 20 alue for szMmap
249f0 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 50 61 67 65 */. void *pPage
24a00 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
24a10 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 20 63 /* Page c
24a20 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 ache memory */.
24a30 20 69 6e 74 20 73 7a 50 61 67 65 3b 20 20 20 20 int szPage;
24a40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24a50 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 65 61 /* Size of ea
24a60 63 68 20 70 61 67 65 20 69 6e 20 70 50 61 67 65 ch page in pPage
24a70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 61 67 [] */. int nPag
24a80 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
24a90 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
24aa0 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 6e 20 ber of pages in
24ab0 70 50 61 67 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 pPage[] */. int
24ac0 20 6d 78 50 61 72 73 65 72 53 74 61 63 6b 3b 20 mxParserStack;
24ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
24ae0 2a 20 6d 61 78 69 6d 75 6d 20 64 65 70 74 68 20 * maximum depth
24af0 6f 66 20 74 68 65 20 70 61 72 73 65 72 20 73 74 of the parser st
24b00 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 73 68 61 ack */. int sha
24b10 72 65 64 43 61 63 68 65 45 6e 61 62 6c 65 64 3b redCacheEnabled;
24b20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 74 72 /* tr
24b30 75 65 20 69 66 20 73 68 61 72 65 64 2d 63 61 63 ue if shared-cac
24b40 68 65 20 6d 6f 64 65 20 65 6e 61 62 6c 65 64 20 he mode enabled
24b50 2a 2f 0a 20 20 75 33 32 20 73 7a 50 6d 61 3b 20 */. u32 szPma;
24b60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24b70 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 /* Maximu
24b80 6d 20 53 6f 72 74 65 72 20 50 4d 41 20 73 69 7a m Sorter PMA siz
24b90 65 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 61 62 e */. /* The ab
24ba0 6f 76 65 20 6d 69 67 68 74 20 62 65 20 69 6e 69 ove might be ini
24bb0 74 69 61 6c 69 7a 65 64 20 74 6f 20 6e 6f 6e 2d tialized to non-
24bc0 7a 65 72 6f 2e 20 20 54 68 65 20 66 6f 6c 6c 6f zero. The follo
24bd0 77 69 6e 67 20 6e 65 65 64 20 74 6f 20 61 6c 77 wing need to alw
24be0 61 79 73 0a 20 20 2a 2a 20 69 6e 69 74 69 61 6c ays. ** initial
24bf0 6c 79 20 62 65 20 7a 65 72 6f 2c 20 68 6f 77 65 ly be zero, howe
24c00 76 65 72 2e 20 2a 2f 0a 20 20 69 6e 74 20 69 73 ver. */. int is
24c10 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 Init;
24c20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
24c30 72 75 65 20 61 66 74 65 72 20 69 6e 69 74 69 61 rue after initia
24c40 6c 69 7a 61 74 69 6f 6e 20 68 61 73 20 66 69 6e lization has fin
24c50 69 73 68 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 ished */. int i
24c60 6e 50 72 6f 67 72 65 73 73 3b 20 20 20 20 20 20 nProgress;
24c70 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24c80 54 72 75 65 20 77 68 69 6c 65 20 69 6e 69 74 69 True while initi
24c90 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 20 70 72 6f alization in pro
24ca0 67 72 65 73 73 20 2a 2f 0a 20 20 69 6e 74 20 69 gress */. int i
24cb0 73 4d 75 74 65 78 49 6e 69 74 3b 20 20 20 20 20 sMutexInit;
24cc0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24cd0 54 72 75 65 20 61 66 74 65 72 20 6d 75 74 65 78 True after mutex
24ce0 65 73 20 61 72 65 20 69 6e 69 74 69 61 6c 69 7a es are initializ
24cf0 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 4d 61 ed */. int isMa
24d00 6c 6c 6f 63 49 6e 69 74 3b 20 20 20 20 20 20 20 llocInit;
24d10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
24d20 65 20 61 66 74 65 72 20 6d 61 6c 6c 6f 63 20 69 e after malloc i
24d30 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f s initialized */
24d40 0a 20 20 69 6e 74 20 69 73 50 43 61 63 68 65 49 . int isPCacheI
24d50 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 nit;
24d60 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 66 74 /* True aft
24d70 65 72 20 6d 61 6c 6c 6f 63 20 69 73 20 69 6e 69 er malloc is ini
24d80 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 6e tialized */. in
24d90 74 20 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 3b t nRefInitMutex;
24da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24db0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 65 /* Number of use
24dc0 72 73 20 6f 66 20 70 49 6e 69 74 4d 75 74 65 78 rs of pInitMutex
24dd0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 */. sqlite3_mu
24de0 74 65 78 20 2a 70 49 6e 69 74 4d 75 74 65 78 3b tex *pInitMutex;
24df0 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 65 78 /* Mutex
24e00 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 65 33 used by sqlite3
24e10 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 2a 2f _initialize() */
24e20 0a 20 20 76 6f 69 64 20 28 2a 78 4c 6f 67 29 28 . void (*xLog)(
24e30 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 void*,int,const
24e40 63 68 61 72 2a 29 3b 20 2f 2a 20 46 75 6e 63 74 char*); /* Funct
24e50 69 6f 6e 20 66 6f 72 20 6c 6f 67 67 69 6e 67 20 ion for logging
24e60 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4c 6f 67 41 */. void *pLogA
24e70 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rg;
24e80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
24e90 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 st argument to x
24ea0 4c 6f 67 28 29 20 2a 2f 0a 23 69 66 64 65 66 20 Log() */.#ifdef
24eb0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 51 SQLITE_ENABLE_SQ
24ec0 4c 4c 4f 47 0a 20 20 76 6f 69 64 28 2a 78 53 71 LLOG. void(*xSq
24ed0 6c 6c 6f 67 29 28 76 6f 69 64 2a 2c 73 71 6c 69 llog)(void*,sqli
24ee0 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
24ef0 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 2a , int);. void *
24f00 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 23 65 6e 64 pSqllogArg;.#end
24f10 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 if.#ifdef SQLITE
24f20 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 0a 20 _VDBE_COVERAGE.
24f30 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e /* The followin
24f40 67 20 63 61 6c 6c 62 61 63 6b 20 28 69 66 20 6e g callback (if n
24f50 6f 74 20 4e 55 4c 4c 29 20 69 73 20 69 6e 76 6f ot NULL) is invo
24f60 6b 65 64 20 6f 6e 20 65 76 65 72 79 20 56 44 42 ked on every VDB
24f70 45 20 62 72 61 6e 63 68 0a 20 20 2a 2a 20 6f 70 E branch. ** op
24f80 65 72 61 74 69 6f 6e 2e 20 20 53 65 74 20 74 68 eration. Set th
24f90 65 20 63 61 6c 6c 62 61 63 6b 20 75 73 69 6e 67 e callback using
24fa0 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c SQLITE_TESTCTRL
24fb0 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 2e 0a _VDBE_COVERAGE..
24fc0 20 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 56 */. void (*xV
24fd0 64 62 65 42 72 61 6e 63 68 29 28 76 6f 69 64 2a dbeBranch)(void*
24fe0 2c 75 6e 73 69 67 6e 65 64 20 69 53 72 63 4c 69 ,unsigned iSrcLi
24ff0 6e 65 2c 75 38 20 65 54 68 69 73 2c 75 38 20 65 ne,u8 eThis,u8 e
25000 4d 78 29 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 Mx); /* Callbac
25010 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 56 64 k */. void *pVd
25020 62 65 42 72 61 6e 63 68 41 72 67 3b 20 20 20 20 beBranchArg;
25030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25050 20 2f 2a 20 31 73 74 20 61 72 67 75 6d 65 6e 74 /* 1st argument
25060 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 */.#endif.#ifnd
25070 65 66 20 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 ef SQLITE_UNTEST
25080 41 42 4c 45 0a 20 20 69 6e 74 20 28 2a 78 54 65 ABLE. int (*xTe
25090 73 74 43 61 6c 6c 62 61 63 6b 29 28 69 6e 74 29 stCallback)(int)
250a0 3b 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 76 6f ; /* Invo
250b0 6b 65 64 20 62 79 20 73 71 6c 69 74 65 33 46 61 ked by sqlite3Fa
250c0 75 6c 74 53 69 6d 28 29 20 2a 2f 0a 23 65 6e 64 ultSim() */.#end
250d0 69 66 0a 20 20 69 6e 74 20 62 4c 6f 63 61 6c 74 if. int bLocalt
250e0 69 6d 65 46 61 75 6c 74 3b 20 20 20 20 20 20 20 imeFault;
250f0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 /* True t
25100 6f 20 66 61 69 6c 20 6c 6f 63 61 6c 74 69 6d 65 o fail localtime
25110 28 29 20 63 61 6c 6c 73 20 2a 2f 0a 20 20 69 6e () calls */. in
25120 74 20 62 49 6e 74 65 72 6e 61 6c 46 75 6e 63 74 t bInternalFunct
25130 69 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 ions;
25140 2f 2a 20 49 6e 74 65 72 6e 61 6c 20 53 51 4c 20 /* Internal SQL
25150 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 76 69 functions are vi
25160 73 69 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 69 sible */. int i
25170 4f 6e 63 65 52 65 73 65 74 54 68 72 65 73 68 6f OnceResetThresho
25180 6c 64 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ld; /*
25190 57 68 65 6e 20 74 6f 20 72 65 73 65 74 20 4f 50 When to reset OP
251a0 5f 4f 6e 63 65 20 63 6f 75 6e 74 65 72 73 20 2a _Once counters *
251b0 2f 0a 20 20 75 33 32 20 73 7a 53 6f 72 74 65 72 /. u32 szSorter
251c0 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 Ref;
251d0 20 20 20 20 20 20 2f 2a 20 4d 69 6e 20 73 69 7a /* Min siz
251e0 65 20 69 6e 20 62 79 74 65 73 20 74 6f 20 75 73 e in bytes to us
251f0 65 20 73 6f 72 74 65 72 2d 72 65 66 73 20 2a 2f e sorter-refs */
25200 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .};../*.** This
25210 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 69 6e macro is used in
25220 73 69 64 65 20 6f 66 20 61 73 73 65 72 74 28 29 side of assert()
25230 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 69 statements to i
25240 6e 64 69 63 61 74 65 20 74 68 61 74 0a 2a 2a 20 ndicate that.**
25250 74 68 65 20 61 73 73 65 72 74 20 69 73 20 6f 6e the assert is on
25260 6c 79 20 76 61 6c 69 64 20 6f 6e 20 61 20 77 65 ly valid on a we
25270 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 ll-formed databa
25280 73 65 2e 20 20 49 6e 73 74 65 61 64 20 6f 66 3a se. Instead of:
25290 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 73 73 65 72 .**.** asser
252a0 74 28 20 58 20 29 3b 0a 2a 2a 0a 2a 2a 20 4f 6e t( X );.**.** On
252b0 65 20 77 72 69 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 e writes:.**.**
252c0 20 20 20 20 61 73 73 65 72 74 28 20 58 20 7c 7c assert( X ||
252d0 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 2a CORRUPT_DB );.*
252e0 2a 0a 2a 2a 20 43 4f 52 52 55 50 54 5f 44 42 20 *.** CORRUPT_DB
252f0 69 73 20 74 72 75 65 20 64 75 72 69 6e 67 20 6e is true during n
25300 6f 72 6d 61 6c 20 6f 70 65 72 61 74 69 6f 6e 2e ormal operation.
25310 20 20 43 4f 52 52 55 50 54 5f 44 42 20 64 6f 65 CORRUPT_DB doe
25320 73 20 6e 6f 74 20 69 6e 64 69 63 61 74 65 0a 2a s not indicate.*
25330 2a 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 * that the datab
25340 61 73 65 20 69 73 20 64 65 66 69 6e 69 74 65 6c ase is definitel
25350 79 20 63 6f 72 72 75 70 74 2c 20 6f 6e 6c 79 20 y corrupt, only
25360 74 68 61 74 20 69 74 20 6d 69 67 68 74 20 62 65 that it might be
25370 20 63 6f 72 72 75 70 74 2e 0a 2a 2a 20 46 6f 72 corrupt..** For
25380 20 6d 6f 73 74 20 74 65 73 74 20 63 61 73 65 73 most test cases
25390 2c 20 43 4f 52 52 55 50 54 5f 44 42 20 69 73 20 , CORRUPT_DB is
253a0 73 65 74 20 74 6f 20 66 61 6c 73 65 20 75 73 69 set to false usi
253b0 6e 67 20 61 20 73 70 65 63 69 61 6c 0a 2a 2a 20 ng a special.**
253c0 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
253d0 74 72 6f 6c 28 29 2e 20 20 54 68 69 73 20 65 6e trol(). This en
253e0 61 62 6c 65 73 20 61 73 73 65 72 74 28 29 20 73 ables assert() s
253f0 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 70 72 6f tatements to pro
25400 76 65 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 ve.** things tha
25410 74 20 61 72 65 20 61 6c 77 61 79 73 20 74 72 75 t are always tru
25420 65 20 66 6f 72 20 77 65 6c 6c 2d 66 6f 72 6d 65 e for well-forme
25430 64 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a d databases..*/.
25440 23 64 65 66 69 6e 65 20 43 4f 52 52 55 50 54 5f #define CORRUPT_
25450 44 42 20 20 28 73 71 6c 69 74 65 33 43 6f 6e 66 DB (sqlite3Conf
25460 69 67 2e 6e 65 76 65 72 43 6f 72 72 75 70 74 3d ig.neverCorrupt=
25470 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 74 65 =0)../*.** Conte
25480 78 74 20 70 6f 69 6e 74 65 72 20 70 61 73 73 65 xt pointer passe
25490 64 20 64 6f 77 6e 20 74 68 72 6f 75 67 68 20 74 d down through t
254a0 68 65 20 74 72 65 65 2d 77 61 6c 6b 2e 0a 2a 2f he tree-walk..*/
254b0 0a 73 74 72 75 63 74 20 57 61 6c 6b 65 72 20 7b .struct Walker {
254c0 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 . Parse *pParse
254d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
254e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
254f0 50 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 Parser context.
25500 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 45 78 70 */. int (*xExp
25510 72 43 61 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 rCallback)(Walke
25520 72 2a 2c 20 45 78 70 72 2a 29 3b 20 20 20 20 20 r*, Expr*);
25530 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 6f 72 20 /* Callback for
25540 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
25550 20 69 6e 74 20 28 2a 78 53 65 6c 65 63 74 43 61 int (*xSelectCa
25560 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 72 2a 2c llback)(Walker*,
25570 53 65 6c 65 63 74 2a 29 3b 20 20 2f 2a 20 43 61 Select*); /* Ca
25580 6c 6c 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 43 llback for SELEC
25590 54 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 Ts */. void (*x
255a0 53 65 6c 65 63 74 43 61 6c 6c 62 61 63 6b 32 29 SelectCallback2)
255b0 28 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 63 74 2a (Walker*,Select*
255c0 29 3b 2f 2a 20 53 65 63 6f 6e 64 20 63 61 6c 6c );/* Second call
255d0 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 43 54 73 back for SELECTs
255e0 20 2a 2f 0a 20 20 69 6e 74 20 77 61 6c 6b 65 72 */. int walker
255f0 44 65 70 74 68 3b 20 20 20 20 20 20 20 20 20 20 Depth;
25600 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25610 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 75 62 /* Number of sub
25620 71 75 65 72 69 65 73 20 2a 2f 0a 20 20 75 38 20 queries */. u8
25630 65 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 eCode;
25640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25650 20 20 20 20 20 20 20 2f 2a 20 41 20 73 6d 61 6c /* A smal
25660 6c 20 70 72 6f 63 65 73 73 69 6e 67 20 63 6f 64 l processing cod
25670 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 20 20 e */. union {
25680 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
256a0 20 2f 2a 20 45 78 74 72 61 20 64 61 74 61 20 66 /* Extra data f
256b0 6f 72 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 or callback */.
256c0 20 20 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 2a NameContext *
256d0 70 4e 43 3b 20 20 20 20 20 20 20 20 20 20 20 20 pNC;
256e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
256f0 4e 61 6d 69 6e 67 20 63 6f 6e 74 65 78 74 20 2a Naming context *
25700 2f 0a 20 20 20 20 69 6e 74 20 6e 3b 20 20 20 20 /. int n;
25710 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25730 2f 2a 20 41 20 63 6f 75 6e 74 65 72 20 2a 2f 0a /* A counter */.
25740 20 20 20 20 69 6e 74 20 69 43 75 72 3b 20 20 20 int iCur;
25750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
25770 20 41 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 A cursor number
25780 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 73 74 20 */. SrcList
25790 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 20 20 20 *pSrcList;
257a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
257b0 20 20 2f 2a 20 46 52 4f 4d 20 63 6c 61 75 73 65 /* FROM clause
257c0 20 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 53 */. struct S
257d0 72 63 43 6f 75 6e 74 20 2a 70 53 72 63 43 6f 75 rcCount *pSrcCou
257e0 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nt;
257f0 20 20 2f 2a 20 43 6f 75 6e 74 69 6e 67 20 63 6f /* Counting co
25800 6c 75 6d 6e 20 72 65 66 65 72 65 6e 63 65 73 20 lumn references
25810 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 43 43 */. struct CC
25820 75 72 48 69 6e 74 20 2a 70 43 43 75 72 48 69 6e urHint *pCCurHin
25830 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
25840 20 2f 2a 20 55 73 65 64 20 62 79 20 63 6f 64 65 /* Used by code
25850 43 75 72 73 6f 72 48 69 6e 74 28 29 20 2a 2f 0a CursorHint() */.
25860 20 20 20 20 69 6e 74 20 2a 61 69 43 6f 6c 3b 20 int *aiCol;
25870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
25890 20 61 72 72 61 79 20 6f 66 20 63 6f 6c 75 6d 6e array of column
258a0 20 69 6e 64 65 78 65 73 20 2a 2f 0a 20 20 20 20 indexes */.
258b0 73 74 72 75 63 74 20 49 64 78 43 6f 76 65 72 20 struct IdxCover
258c0 2a 70 49 64 78 43 6f 76 65 72 3b 20 20 20 20 20 *pIdxCover;
258d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 68 65 /* Che
258e0 63 6b 20 66 6f 72 20 69 6e 64 65 78 20 63 6f 76 ck for index cov
258f0 65 72 61 67 65 20 2a 2f 0a 20 20 20 20 73 74 72 erage */. str
25900 75 63 74 20 49 64 78 45 78 70 72 54 72 61 6e 73 uct IdxExprTrans
25910 20 2a 70 49 64 78 54 72 61 6e 73 3b 20 20 20 20 *pIdxTrans;
25920 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 76 65 72 /* Conver
25930 74 20 69 64 78 65 64 20 65 78 70 72 20 74 6f 20 t idxed expr to
25940 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 20 20 45 78 column */. Ex
25950 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 79 prList *pGroupBy
25960 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
25970 20 20 20 20 20 20 20 20 2f 2a 20 47 52 4f 55 50 /* GROUP
25980 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 BY clause */.
25990 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 Select *pSelec
259a0 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
259b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 /* H
259c0 41 56 49 4e 47 20 74 6f 20 57 48 45 52 45 20 63 AVING to WHERE c
259d0 6c 61 75 73 65 20 63 74 78 20 2a 2f 0a 20 20 20 lause ctx */.
259e0 20 73 74 72 75 63 74 20 57 69 6e 64 6f 77 52 65 struct WindowRe
259f0 77 72 69 74 65 20 2a 70 52 65 77 72 69 74 65 3b write *pRewrite;
25a00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 69 /* Wi
25a10 6e 64 6f 77 20 72 65 77 72 69 74 65 20 63 6f 6e ndow rewrite con
25a20 74 65 78 74 20 2a 2f 0a 20 20 20 20 73 74 72 75 text */. stru
25a30 63 74 20 57 68 65 72 65 43 6f 6e 73 74 20 2a 70 ct WhereConst *p
25a40 43 6f 6e 73 74 3b 20 20 20 20 20 20 20 20 20 20 Const;
25a50 20 20 20 20 20 20 2f 2a 20 57 48 45 52 45 20 63 /* WHERE c
25a60 6c 61 75 73 65 20 63 6f 6e 73 74 61 6e 74 73 20 lause constants
25a70 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 52 65 */. struct Re
25a80 6e 61 6d 65 43 74 78 20 2a 70 52 65 6e 61 6d 65 nameCtx *pRename
25a90 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
25aa0 20 2f 2a 20 52 45 4e 41 4d 45 20 43 4f 4c 55 4d /* RENAME COLUM
25ab0 4e 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 7d N context */. }
25ac0 20 75 3b 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 u;.};../* Forwa
25ad0 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 rd declarations
25ae0 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 */.int sqlite3Wa
25af0 6c 6b 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 lkExpr(Walker*,
25b00 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Expr*);.int sqli
25b10 74 65 33 57 61 6c 6b 45 78 70 72 4c 69 73 74 28 te3WalkExprList(
25b20 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 4c 69 73 Walker*, ExprLis
25b30 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
25b40 57 61 6c 6b 53 65 6c 65 63 74 28 57 61 6c 6b 65 WalkSelect(Walke
25b50 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e r*, Select*);.in
25b60 74 20 73 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c t sqlite3WalkSel
25b70 65 63 74 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c ectExpr(Walker*,
25b80 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 Select*);.int s
25b90 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 qlite3WalkSelect
25ba0 46 72 6f 6d 28 57 61 6c 6b 65 72 2a 2c 20 53 65 From(Walker*, Se
25bb0 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 lect*);.int sqli
25bc0 74 65 33 45 78 70 72 57 61 6c 6b 4e 6f 6f 70 28 te3ExprWalkNoop(
25bd0 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 2a 29 3b Walker*, Expr*);
25be0 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 65 6c 65 .int sqlite3Sele
25bf0 63 74 57 61 6c 6b 4e 6f 6f 70 28 57 61 6c 6b 65 ctWalkNoop(Walke
25c00 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e r*, Select*);.in
25c10 74 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 57 t sqlite3SelectW
25c20 61 6c 6b 46 61 69 6c 28 57 61 6c 6b 65 72 2a 2c alkFail(Walker*,
25c30 20 53 65 6c 65 63 74 2a 29 3b 0a 23 69 66 64 65 Select*);.#ifde
25c40 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 76 f SQLITE_DEBUG.v
25c50 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 oid sqlite3Selec
25c60 74 57 61 6c 6b 41 73 73 65 72 74 32 28 57 61 6c tWalkAssert2(Wal
25c70 6b 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a ker*, Select*);.
25c80 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 #endif../*.** Re
25c90 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 74 turn code from t
25ca0 68 65 20 70 61 72 73 65 2d 74 72 65 65 20 77 61 he parse-tree wa
25cb0 6c 6b 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 lking primitives
25cc0 20 61 6e 64 20 74 68 65 69 72 0a 2a 2a 20 63 61 and their.** ca
25cd0 6c 6c 62 61 63 6b 73 2e 0a 2a 2f 0a 23 64 65 66 llbacks..*/.#def
25ce0 69 6e 65 20 57 52 43 5f 43 6f 6e 74 69 6e 75 65 ine WRC_Continue
25cf0 20 20 20 20 30 20 20 20 2f 2a 20 43 6f 6e 74 69 0 /* Conti
25d00 6e 75 65 20 64 6f 77 6e 20 69 6e 74 6f 20 63 68 nue down into ch
25d10 69 6c 64 72 65 6e 20 2a 2f 0a 23 64 65 66 69 6e ildren */.#defin
25d20 65 20 57 52 43 5f 50 72 75 6e 65 20 20 20 20 20 e WRC_Prune
25d30 20 20 31 20 20 20 2f 2a 20 4f 6d 69 74 20 63 68 1 /* Omit ch
25d40 69 6c 64 72 65 6e 20 62 75 74 20 63 6f 6e 74 69 ildren but conti
25d50 6e 75 65 20 77 61 6c 6b 69 6e 67 20 73 69 62 6c nue walking sibl
25d60 69 6e 67 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ings */.#define
25d70 57 52 43 5f 41 62 6f 72 74 20 20 20 20 20 20 20 WRC_Abort
25d80 32 20 20 20 2f 2a 20 41 62 61 6e 64 6f 6e 20 74 2 /* Abandon t
25d90 68 65 20 74 72 65 65 20 77 61 6c 6b 20 2a 2f 0a he tree walk */.
25da0 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
25db0 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 ce of this struc
25dc0 74 75 72 65 20 72 65 70 72 65 73 65 6e 74 73 20 ture represents
25dd0 61 20 73 65 74 20 6f 66 20 6f 6e 65 20 6f 72 20 a set of one or
25de0 6d 6f 72 65 20 43 54 45 73 0a 2a 2a 20 28 63 6f more CTEs.** (co
25df0 6d 6d 6f 6e 20 74 61 62 6c 65 20 65 78 70 72 65 mmon table expre
25e00 73 73 69 6f 6e 73 29 20 63 72 65 61 74 65 64 20 ssions) created
25e10 62 79 20 61 20 73 69 6e 67 6c 65 20 57 49 54 48 by a single WITH
25e20 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 72 75 clause..*/.stru
25e30 63 74 20 57 69 74 68 20 7b 0a 20 20 69 6e 74 20 ct With {. int
25e40 6e 43 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 nCte;
25e50 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
25e60 75 6d 62 65 72 20 6f 66 20 43 54 45 73 20 69 6e umber of CTEs in
25e70 20 74 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 the WITH clause
25e80 20 2a 2f 0a 20 20 57 69 74 68 20 2a 70 4f 75 74 */. With *pOut
25e90 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 er;
25ea0 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 61 69 6e /* Contain
25eb0 69 6e 67 20 57 49 54 48 20 63 6c 61 75 73 65 2c ing WITH clause,
25ec0 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 73 74 or NULL */. st
25ed0 72 75 63 74 20 43 74 65 20 7b 20 20 20 20 20 20 ruct Cte {
25ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
25ef0 20 46 6f 72 20 65 61 63 68 20 43 54 45 20 69 6e For each CTE in
25f00 20 74 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 the WITH clause
25f10 2e 2e 2e 2e 20 2a 2f 0a 20 20 20 20 63 68 61 72 .... */. char
25f20 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 *zName;
25f30 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
25f40 61 6d 65 20 6f 66 20 74 68 69 73 20 43 54 45 20 ame of this CTE
25f50 2a 2f 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 */. ExprList
25f60 2a 70 43 6f 6c 73 3b 20 20 20 20 20 20 20 20 20 *pCols;
25f70 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
25f80 66 20 65 78 70 6c 69 63 69 74 20 63 6f 6c 75 6d f explicit colum
25f90 6e 20 6e 61 6d 65 73 2c 20 6f 72 20 4e 55 4c 4c n names, or NULL
25fa0 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a */. Select *
25fb0 70 53 65 6c 65 63 74 3b 20 20 20 20 20 20 20 20 pSelect;
25fc0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 /* The d
25fd0 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 69 efinition of thi
25fe0 73 20 43 54 45 20 2a 2f 0a 20 20 20 20 63 6f 6e s CTE */. con
25ff0 73 74 20 63 68 61 72 20 2a 7a 43 74 65 45 72 72 st char *zCteErr
26000 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
26010 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 6f Error message fo
26020 72 20 63 69 72 63 75 6c 61 72 20 72 65 66 65 72 r circular refer
26030 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 61 5b 31 ences */. } a[1
26040 5d 3b 0a 7d 3b 0a 0a 23 69 66 64 65 66 20 53 51 ];.};..#ifdef SQ
26050 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a LITE_DEBUG./*.**
26060 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
26070 74 68 65 20 54 72 65 65 56 69 65 77 20 6f 62 6a the TreeView obj
26080 65 63 74 20 69 73 20 75 73 65 64 20 66 6f 72 20 ect is used for
26090 70 72 69 6e 74 69 6e 67 20 74 68 65 20 63 6f 6e printing the con
260a0 74 65 6e 74 20 6f 66 0a 2a 2a 20 64 61 74 61 20 tent of.** data
260b0 73 74 72 75 63 74 75 72 65 73 20 6f 6e 20 73 71 structures on sq
260c0 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 lite3DebugPrintf
260d0 28 29 20 75 73 69 6e 67 20 61 20 74 72 65 65 2d () using a tree-
260e0 6c 69 6b 65 20 76 69 65 77 2e 0a 2a 2f 0a 73 74 like view..*/.st
260f0 72 75 63 74 20 54 72 65 65 56 69 65 77 20 7b 0a ruct TreeView {.
26100 20 20 69 6e 74 20 69 4c 65 76 65 6c 3b 20 20 20 int iLevel;
26110 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 /* Whi
26120 63 68 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 ch level of the
26130 74 72 65 65 20 77 65 20 61 72 65 20 6f 6e 20 2a tree we are on *
26140 2f 0a 20 20 75 38 20 20 62 4c 69 6e 65 5b 31 30 /. u8 bLine[10
26150 30 5d 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 44 0]; /* D
26160 72 61 77 20 76 65 72 74 69 63 61 6c 20 69 6e 20 raw vertical in
26170 63 6f 6c 75 6d 6e 20 69 20 69 66 20 62 4c 69 6e column i if bLin
26180 65 5b 69 5d 20 69 73 20 74 72 75 65 20 2a 2f 0a e[i] is true */.
26190 7d 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c };.#endif /* SQL
261a0 49 54 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a ITE_DEBUG */../*
261b0 0a 2a 2a 20 54 68 69 73 20 6f 62 6a 65 63 74 20 .** This object
261c0 69 73 20 75 73 65 64 20 69 6e 20 76 61 72 69 6f is used in vario
261d0 69 75 73 20 77 61 79 73 2c 20 61 6c 6c 20 72 65 ius ways, all re
261e0 6c 61 74 65 64 20 74 6f 20 77 69 6e 64 6f 77 20 lated to window
261f0 66 75 6e 63 74 69 6f 6e 73 0a 2a 2a 0a 2a 2a 20 functions.**.**
26200 20 20 28 31 29 20 41 20 73 69 6e 67 6c 65 20 69 (1) A single i
26210 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 nstance of this
26220 73 74 72 75 63 74 75 72 65 20 69 73 20 61 74 74 structure is att
26230 61 63 68 65 64 20 74 6f 20 74 68 65 0a 2a 2a 20 ached to the.**
26240 20 20 20 20 20 20 74 68 65 20 45 78 70 72 2e 70 the Expr.p
26250 57 69 6e 20 66 69 65 6c 64 20 66 6f 72 20 65 61 Win field for ea
26260 63 68 20 77 69 6e 64 6f 77 20 66 75 6e 63 74 69 ch window functi
26270 6f 6e 20 69 6e 20 61 6e 20 65 78 70 72 65 73 73 on in an express
26280 69 6f 6e 20 74 72 65 65 2e 0a 2a 2a 20 20 20 20 ion tree..**
26290 20 20 20 54 68 69 73 20 6f 62 6a 65 63 74 20 68 This object h
262a0 6f 6c 64 73 20 74 68 65 20 69 6e 66 6f 72 6d 61 olds the informa
262b0 74 69 6f 6e 20 63 6f 6e 74 61 69 6e 65 64 20 69 tion contained i
262c0 6e 20 74 68 65 20 4f 56 45 52 20 63 6c 61 75 73 n the OVER claus
262d0 65 2c 0a 2a 2a 20 20 20 20 20 20 20 70 6c 75 73 e,.** plus
262e0 20 61 64 64 69 74 69 6f 6e 61 6c 20 66 69 65 6c additional fiel
262f0 64 73 20 75 73 65 64 20 64 75 72 69 6e 67 20 63 ds used during c
26300 6f 64 65 20 67 65 6e 65 72 61 74 69 6f 6e 2e 0a ode generation..
26310 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 41 6c 6c 20 **.** (2) All
26320 77 69 6e 64 6f 77 20 66 75 6e 63 74 69 6f 6e 73 window functions
26330 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 53 45 4c in a single SEL
26340 45 43 54 20 66 6f 72 6d 20 61 20 6c 69 6e 6b 65 ECT form a linke
26350 64 2d 6c 69 73 74 0a 2a 2a 20 20 20 20 20 20 20 d-list.**
26360 61 74 74 61 63 68 65 64 20 74 6f 20 53 65 6c 65 attached to Sele
26370 63 74 2e 70 57 69 6e 2e 20 20 54 68 65 20 57 69 ct.pWin. The Wi
26380 6e 64 6f 77 2e 70 46 75 6e 63 20 61 6e 64 20 57 ndow.pFunc and W
26390 69 6e 64 6f 77 2e 70 45 78 70 72 0a 2a 2a 20 20 indow.pExpr.**
263a0 20 20 20 20 20 66 69 65 6c 64 73 20 70 6f 69 6e fields poin
263b0 74 20 62 61 63 6b 20 74 6f 20 74 68 65 20 65 78 t back to the ex
263c0 70 72 65 73 73 69 6f 6e 20 74 68 61 74 20 69 73 pression that is
263d0 20 74 68 65 20 77 69 6e 64 6f 77 20 66 75 6e 63 the window func
263e0 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 28 33 tion..**.** (3
263f0 29 20 54 68 65 20 74 65 72 6d 73 20 6f 66 20 74 ) The terms of t
26400 68 65 20 57 49 4e 44 4f 57 20 63 6c 61 75 73 65 he WINDOW clause
26410 20 6f 66 20 61 20 53 45 4c 45 43 54 20 61 72 65 of a SELECT are
26420 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 74 68 instances of th
26430 69 73 0a 2a 2a 20 20 20 20 20 20 20 6f 62 6a 65 is.** obje
26440 63 74 20 6f 6e 20 61 20 6c 69 6e 6b 65 64 20 6c ct on a linked l
26450 69 73 74 20 61 74 74 61 63 68 65 64 20 74 6f 20 ist attached to
26460 53 65 6c 65 63 74 2e 70 57 69 6e 44 65 66 6e 2e Select.pWinDefn.
26470 0a 2a 2a 0a 2a 2a 20 54 68 65 20 75 73 65 73 20 .**.** The uses
26480 28 31 29 20 61 6e 64 20 28 32 29 20 61 72 65 20 (1) and (2) are
26490 72 65 61 6c 6c 79 20 74 68 65 20 73 61 6d 65 20 really the same
264a0 57 69 6e 64 6f 77 20 6f 62 6a 65 63 74 20 74 68 Window object th
264b0 61 74 20 6a 75 73 74 20 68 61 70 70 65 6e 73 0a at just happens.
264c0 2a 2a 20 74 6f 20 62 65 20 61 63 63 65 73 73 69 ** to be accessi
264d0 62 6c 65 20 69 6e 20 74 77 6f 20 64 69 66 66 65 ble in two diffe
264e0 72 65 6e 74 20 77 61 79 73 2e 20 20 55 73 65 20 rent ways. Use
264f0 28 33 29 20 69 73 20 61 72 65 20 73 65 70 61 72 (3) is are separ
26500 61 74 65 20 6f 62 6a 65 63 74 73 2e 0a 2a 2f 0a ate objects..*/.
26510 73 74 72 75 63 74 20 57 69 6e 64 6f 77 20 7b 0a struct Window {.
26520 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
26530 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d /* Nam
26540 65 20 6f 66 20 77 69 6e 64 6f 77 20 28 6d 61 79 e of window (may
26550 20 62 65 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 45 be NULL) */. E
26560 78 70 72 4c 69 73 74 20 2a 70 50 61 72 74 69 74 xprList *pPartit
26570 69 6f 6e 3b 20 20 20 2f 2a 20 50 41 52 54 49 54 ion; /* PARTIT
26580 49 4f 4e 20 42 59 20 63 6c 61 75 73 65 20 2a 2f ION BY clause */
26590 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 . ExprList *pOr
265a0 64 65 72 42 79 3b 20 20 20 20 20 2f 2a 20 4f 52 derBy; /* OR
265b0 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 2a 2f DER BY clause */
265c0 0a 20 20 75 38 20 65 54 79 70 65 3b 20 20 20 20 . u8 eType;
265d0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 4b /* TK
265e0 5f 52 41 4e 47 45 20 6f 72 20 54 4b 5f 52 4f 57 _RANGE or TK_ROW
265f0 53 20 2a 2f 0a 20 20 75 38 20 65 53 74 61 72 74 S */. u8 eStart
26600 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
26610 2a 20 55 4e 42 4f 55 4e 44 45 44 2c 20 43 55 52 * UNBOUNDED, CUR
26620 52 45 4e 54 2c 20 50 52 45 43 45 44 49 4e 47 20 RENT, PRECEDING
26630 6f 72 20 46 4f 4c 4c 4f 57 49 4e 47 20 2a 2f 0a or FOLLOWING */.
26640 20 20 75 38 20 65 45 6e 64 3b 20 20 20 20 20 20 u8 eEnd;
26650 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 4e 42 /* UNB
26660 4f 55 4e 44 45 44 2c 20 43 55 52 52 45 4e 54 2c OUNDED, CURRENT,
26670 20 50 52 45 43 45 44 49 4e 47 20 6f 72 20 46 4f PRECEDING or FO
26680 4c 4c 4f 57 49 4e 47 20 2a 2f 0a 20 20 45 78 70 LLOWING */. Exp
26690 72 20 2a 70 53 74 61 72 74 3b 20 20 20 20 20 20 r *pStart;
266a0 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 /* Expressi
266b0 6f 6e 20 66 6f 72 20 22 3c 65 78 70 72 3e 20 50 on for "<expr> P
266c0 52 45 43 45 44 49 4e 47 22 20 2a 2f 0a 20 20 45 RECEDING" */. E
266d0 78 70 72 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 xpr *pEnd;
266e0 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 /* Expres
266f0 73 69 6f 6e 20 66 6f 72 20 22 3c 65 78 70 72 3e sion for "<expr>
26700 20 46 4f 4c 4c 4f 57 49 4e 47 22 20 2a 2f 0a 20 FOLLOWING" */.
26710 20 57 69 6e 64 6f 77 20 2a 70 4e 65 78 74 57 69 Window *pNextWi
26720 6e 3b 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 n; /* Next
26730 20 77 69 6e 64 6f 77 20 66 75 6e 63 74 69 6f 6e window function
26740 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 74 68 belonging to th
26750 69 73 20 53 45 4c 45 43 54 20 2a 2f 0a 20 20 45 is SELECT */. E
26760 78 70 72 20 2a 70 46 69 6c 74 65 72 3b 20 20 20 xpr *pFilter;
26770 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 49 /* The FI
26780 4c 54 45 52 20 65 78 70 72 65 73 73 69 6f 6e 20 LTER expression
26790 2a 2f 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 46 */. FuncDef *pF
267a0 75 6e 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 unc; /*
267b0 54 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a The function */.
267c0 20 20 69 6e 74 20 69 45 70 68 43 73 72 3b 20 20 int iEphCsr;
267d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 /* Par
267e0 74 69 74 69 6f 6e 20 62 75 66 66 65 72 20 6f 72 tition buffer or
267f0 20 50 65 65 72 20 62 75 66 66 65 72 20 2a 2f 0a Peer buffer */.
26800 20 20 69 6e 74 20 72 65 67 41 63 63 75 6d 3b 0a int regAccum;.
26810 20 20 69 6e 74 20 72 65 67 52 65 73 75 6c 74 3b int regResult;
26820 0a 20 20 69 6e 74 20 63 73 72 41 70 70 3b 20 20 . int csrApp;
26830 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 75 /* Fu
26840 6e 63 74 69 6f 6e 20 63 75 72 73 6f 72 20 28 75 nction cursor (u
26850 73 65 64 20 62 79 20 6d 69 6e 2f 6d 61 78 29 20 sed by min/max)
26860 2a 2f 0a 20 20 69 6e 74 20 72 65 67 41 70 70 3b */. int regApp;
26870 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
26880 46 75 6e 63 74 69 6f 6e 20 72 65 67 69 73 74 65 Function registe
26890 72 20 28 61 6c 73 6f 20 75 73 65 64 20 62 79 20 r (also used by
268a0 6d 69 6e 2f 6d 61 78 29 20 2a 2f 0a 20 20 69 6e min/max) */. in
268b0 74 20 72 65 67 50 61 72 74 3b 20 20 20 20 20 20 t regPart;
268c0 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 69 /* First i
268d0 6e 20 61 20 73 65 74 20 6f 66 20 72 65 67 69 73 n a set of regis
268e0 74 65 72 73 20 68 6f 6c 64 69 6e 67 20 50 41 52 ters holding PAR
268f0 54 49 54 49 4f 4e 20 42 59 0a 20 20 20 20 20 20 TITION BY.
26900 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26910 20 20 20 20 2a 2a 20 61 6e 64 20 4f 52 44 45 52 ** and ORDER
26920 20 42 59 20 76 61 6c 75 65 73 20 66 6f 72 20 74 BY values for t
26930 68 65 20 77 69 6e 64 6f 77 20 2a 2f 0a 20 20 45 he window */. E
26940 78 70 72 20 2a 70 4f 77 6e 65 72 3b 20 20 20 20 xpr *pOwner;
26950 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 /* Expres
26960 73 69 6f 6e 20 6f 62 6a 65 63 74 20 74 68 69 73 sion object this
26970 20 77 69 6e 64 6f 77 20 69 73 20 61 74 74 61 63 window is attac
26980 68 65 64 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 hed to */. int
26990 6e 42 75 66 66 65 72 43 6f 6c 3b 20 20 20 20 20 nBufferCol;
269a0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
269b0 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 62 75 66 66 columns in buff
269c0 65 72 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69 6e er table */. in
269d0 74 20 69 41 72 67 43 6f 6c 3b 20 20 20 20 20 20 t iArgCol;
269e0 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 /* Offset
269f0 6f 66 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e of first argumen
26a00 74 20 66 6f 72 20 74 68 69 73 20 66 75 6e 63 74 t for this funct
26a10 69 6f 6e 20 2a 2f 0a 7d 3b 0a 0a 23 69 66 6e 64 ion */.};..#ifnd
26a20 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
26a30 49 4e 44 4f 57 46 55 4e 43 0a 76 6f 69 64 20 73 INDOWFUNC.void s
26a40 71 6c 69 74 65 33 57 69 6e 64 6f 77 44 65 6c 65 qlite3WindowDele
26a50 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 57 69 6e te(sqlite3*, Win
26a60 64 6f 77 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 dow*);.void sqli
26a70 74 65 33 57 69 6e 64 6f 77 4c 69 73 74 44 65 6c te3WindowListDel
26a80 65 74 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c ete(sqlite3 *db,
26a90 20 57 69 6e 64 6f 77 20 2a 70 29 3b 0a 57 69 6e Window *p);.Win
26aa0 64 6f 77 20 2a 73 71 6c 69 74 65 33 57 69 6e 64 dow *sqlite3Wind
26ab0 6f 77 41 6c 6c 6f 63 28 50 61 72 73 65 2a 2c 20 owAlloc(Parse*,
26ac0 69 6e 74 2c 20 69 6e 74 2c 20 45 78 70 72 2a 2c int, int, Expr*,
26ad0 20 69 6e 74 20 2c 20 45 78 70 72 2a 29 3b 0a 76 int , Expr*);.v
26ae0 6f 69 64 20 73 71 6c 69 74 65 33 57 69 6e 64 6f oid sqlite3Windo
26af0 77 41 74 74 61 63 68 28 50 61 72 73 65 2a 2c 20 wAttach(Parse*,
26b00 45 78 70 72 2a 2c 20 57 69 6e 64 6f 77 2a 29 3b Expr*, Window*);
26b10 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 69 6e 64 .int sqlite3Wind
26b20 6f 77 43 6f 6d 70 61 72 65 28 50 61 72 73 65 2a owCompare(Parse*
26b30 2c 20 57 69 6e 64 6f 77 2a 2c 20 57 69 6e 64 6f , Window*, Windo
26b40 77 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 w*);.void sqlite
26b50 33 57 69 6e 64 6f 77 43 6f 64 65 49 6e 69 74 28 3WindowCodeInit(
26b60 50 61 72 73 65 2a 2c 20 57 69 6e 64 6f 77 2a 29 Parse*, Window*)
26b70 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 57 69 ;.void sqlite3Wi
26b80 6e 64 6f 77 43 6f 64 65 53 74 65 70 28 50 61 72 ndowCodeStep(Par
26b90 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 57 68 se*, Select*, Wh
26ba0 65 72 65 49 6e 66 6f 2a 2c 20 69 6e 74 2c 20 69 ereInfo*, int, i
26bb0 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
26bc0 57 69 6e 64 6f 77 52 65 77 72 69 74 65 28 50 61 WindowRewrite(Pa
26bd0 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a rse*, Select*);.
26be0 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 61 6e int sqlite3Expan
26bf0 64 53 75 62 71 75 65 72 79 28 50 61 72 73 65 2a dSubquery(Parse*
26c00 2c 20 73 74 72 75 63 74 20 53 72 63 4c 69 73 74 , struct SrcList
26c10 5f 69 74 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 _item*);.void sq
26c20 6c 69 74 65 33 57 69 6e 64 6f 77 55 70 64 61 74 lite3WindowUpdat
26c30 65 28 50 61 72 73 65 2a 2c 20 57 69 6e 64 6f 77 e(Parse*, Window
26c40 2a 2c 20 57 69 6e 64 6f 77 2a 2c 20 46 75 6e 63 *, Window*, Func
26c50 44 65 66 2a 29 3b 0a 57 69 6e 64 6f 77 20 2a 73 Def*);.Window *s
26c60 71 6c 69 74 65 33 57 69 6e 64 6f 77 44 75 70 28 qlite3WindowDup(
26c70 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 45 78 70 sqlite3 *db, Exp
26c80 72 20 2a 70 4f 77 6e 65 72 2c 20 57 69 6e 64 6f r *pOwner, Windo
26c90 77 20 2a 70 29 3b 0a 57 69 6e 64 6f 77 20 2a 73 w *p);.Window *s
26ca0 71 6c 69 74 65 33 57 69 6e 64 6f 77 4c 69 73 74 qlite3WindowList
26cb0 44 75 70 28 73 71 6c 69 74 65 33 20 2a 64 62 2c Dup(sqlite3 *db,
26cc0 20 57 69 6e 64 6f 77 20 2a 70 29 3b 0a 76 6f 69 Window *p);.voi
26cd0 64 20 73 71 6c 69 74 65 33 57 69 6e 64 6f 77 46 d sqlite3WindowF
26ce0 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a unctions(void);.
26cf0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
26d00 71 6c 69 74 65 33 57 69 6e 64 6f 77 44 65 6c 65 qlite3WindowDele
26d10 74 65 28 61 2c 62 29 0a 23 20 64 65 66 69 6e 65 te(a,b).# define
26d20 20 73 71 6c 69 74 65 33 57 69 6e 64 6f 77 46 75 sqlite3WindowFu
26d30 6e 63 74 69 6f 6e 73 28 29 0a 23 20 64 65 66 69 nctions().# defi
26d40 6e 65 20 73 71 6c 69 74 65 33 57 69 6e 64 6f 77 ne sqlite3Window
26d50 41 74 74 61 63 68 28 61 2c 62 2c 63 29 0a 23 65 Attach(a,b,c).#e
26d60 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 ndif../*.** Assu
26d70 6d 69 6e 67 20 7a 49 6e 20 70 6f 69 6e 74 73 20 ming zIn points
26d80 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 to the first byt
26d90 65 20 6f 66 20 61 20 55 54 46 2d 38 20 63 68 61 e of a UTF-8 cha
26da0 72 61 63 74 65 72 2c 0a 2a 2a 20 61 64 76 61 6e racter,.** advan
26db0 63 65 20 7a 49 6e 20 74 6f 20 70 6f 69 6e 74 20 ce zIn to point
26dc0 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 to the first byt
26dd0 65 20 6f 66 20 74 68 65 20 6e 65 78 74 20 55 54 e of the next UT
26de0 46 2d 38 20 63 68 61 72 61 63 74 65 72 2e 0a 2a F-8 character..*
26df0 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
26e00 5f 53 4b 49 50 5f 55 54 46 38 28 7a 49 6e 29 20 _SKIP_UTF8(zIn)
26e10 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
26e20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 69 66 28 \. if(
26e30 20 28 2a 28 7a 49 6e 2b 2b 29 29 3e 3d 30 78 63 (*(zIn++))>=0xc
26e40 30 20 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 0 ){
26e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26e60 20 20 5c 0a 20 20 20 20 77 68 69 6c 65 28 20 28 \. while( (
26e70 2a 7a 49 6e 20 26 20 30 78 63 30 29 3d 3d 30 78 *zIn & 0xc0)==0x
26e80 38 30 20 29 7b 20 7a 49 6e 2b 2b 3b 20 7d 20 20 80 ){ zIn++; }
26e90 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 7d \. }
26ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26ed0 20 20 20 20 5c 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 \.}../*.** T
26ee0 68 65 20 53 51 4c 49 54 45 5f 2a 5f 42 4b 50 54 he SQLITE_*_BKPT
26ef0 20 6d 61 63 72 6f 73 20 61 72 65 20 73 75 62 73 macros are subs
26f00 74 69 74 75 74 65 73 20 66 6f 72 20 74 68 65 20 titutes for the
26f10 65 72 72 6f 72 20 63 6f 64 65 73 20 77 69 74 68 error codes with
26f20 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 61 6d .** the same nam
26f30 65 20 62 75 74 20 77 69 74 68 6f 75 74 20 74 68 e but without th
26f40 65 20 5f 42 4b 50 54 20 73 75 66 66 69 78 2e 20 e _BKPT suffix.
26f50 20 54 68 65 73 65 20 6d 61 63 72 6f 73 20 69 6e These macros in
26f60 76 6f 6b 65 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 voke.** routines
26f70 20 74 68 61 74 20 72 65 70 6f 72 74 20 74 68 65 that report the
26f80 20 6c 69 6e 65 2d 6e 75 6d 62 65 72 20 6f 6e 20 line-number on
26f90 77 68 69 63 68 20 74 68 65 20 65 72 72 6f 72 20 which the error
26fa0 6f 72 69 67 69 6e 61 74 65 64 0a 2a 2a 20 75 73 originated.** us
26fb0 69 6e 67 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 ing sqlite3_log(
26fc0 29 2e 20 20 54 68 65 20 72 6f 75 74 69 6e 65 73 ). The routines
26fd0 20 61 6c 73 6f 20 70 72 6f 76 69 64 65 20 61 20 also provide a
26fe0 63 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 65 convenient place
26ff0 0a 2a 2a 20 74 6f 20 73 65 74 20 61 20 64 65 62 .** to set a deb
27000 75 67 67 65 72 20 62 72 65 61 6b 70 6f 69 6e 74 ugger breakpoint
27010 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
27020 52 65 70 6f 72 74 45 72 72 6f 72 28 69 6e 74 20 ReportError(int
27030 69 45 72 72 2c 20 69 6e 74 20 6c 69 6e 65 6e 6f iErr, int lineno
27040 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 , const char *zT
27050 79 70 65 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 ype);.int sqlite
27060 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 3CorruptError(in
27070 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d t);.int sqlite3M
27080 69 73 75 73 65 45 72 72 6f 72 28 69 6e 74 29 3b isuseError(int);
27090 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 61 6e 74 .int sqlite3Cant
270a0 6f 70 65 6e 45 72 72 6f 72 28 69 6e 74 29 3b 0a openError(int);.
270b0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 #define SQLITE_C
270c0 4f 52 52 55 50 54 5f 42 4b 50 54 20 73 71 6c 69 ORRUPT_BKPT sqli
270d0 74 65 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 te3CorruptError(
270e0 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e __LINE__).#defin
270f0 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f e SQLITE_MISUSE_
27100 42 4b 50 54 20 73 71 6c 69 74 65 33 4d 69 73 75 BKPT sqlite3Misu
27110 73 65 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f seError(__LINE__
27120 29 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 ).#define SQLITE
27130 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 20 73 _CANTOPEN_BKPT s
27140 71 6c 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 qlite3CantopenEr
27150 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 69 ror(__LINE__).#i
27160 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
27170 47 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4e G. int sqlite3N
27180 6f 6d 65 6d 45 72 72 6f 72 28 69 6e 74 29 3b 0a omemError(int);.
27190 20 20 69 6e 74 20 73 71 6c 69 74 65 33 49 6f 65 int sqlite3Ioe
271a0 72 72 6e 6f 6d 65 6d 45 72 72 6f 72 28 69 6e 74 rrnomemError(int
271b0 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
271c0 43 6f 72 72 75 70 74 50 67 6e 6f 45 72 72 6f 72 CorruptPgnoError
271d0 28 69 6e 74 2c 50 67 6e 6f 29 3b 0a 23 20 64 65 (int,Pgno);.# de
271e0 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 fine SQLITE_NOME
271f0 4d 5f 42 4b 50 54 20 73 71 6c 69 74 65 33 4e 6f M_BKPT sqlite3No
27200 6d 65 6d 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f memError(__LINE_
27210 5f 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 _).# define SQLI
27220 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 5f 42 TE_IOERR_NOMEM_B
27230 4b 50 54 20 73 71 6c 69 74 65 33 49 6f 65 72 72 KPT sqlite3Ioerr
27240 6e 6f 6d 65 6d 45 72 72 6f 72 28 5f 5f 4c 49 4e nomemError(__LIN
27250 45 5f 5f 29 0a 23 20 64 65 66 69 6e 65 20 53 51 E__).# define SQ
27260 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 47 4e LITE_CORRUPT_PGN
27270 4f 28 50 29 20 73 71 6c 69 74 65 33 43 6f 72 72 O(P) sqlite3Corr
27280 75 70 74 50 67 6e 6f 45 72 72 6f 72 28 5f 5f 4c uptPgnoError(__L
27290 49 4e 45 5f 5f 2c 28 50 29 29 0a 23 65 6c 73 65 INE__,(P)).#else
272a0 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
272b0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 53 51 4c 49 _NOMEM_BKPT SQLI
272c0 54 45 5f 4e 4f 4d 45 4d 0a 23 20 64 65 66 69 6e TE_NOMEM.# defin
272d0 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e e SQLITE_IOERR_N
272e0 4f 4d 45 4d 5f 42 4b 50 54 20 53 51 4c 49 54 45 OMEM_BKPT SQLITE
272f0 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 0a 23 20 64 _IOERR_NOMEM.# d
27300 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 4f 52 efine SQLITE_COR
27310 52 55 50 54 5f 50 47 4e 4f 28 50 29 20 73 71 6c RUPT_PGNO(P) sql
27320 69 74 65 33 43 6f 72 72 75 70 74 45 72 72 6f 72 ite3CorruptError
27330 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 65 6e 64 69 (__LINE__).#endi
27340 66 0a 0a 2f 2a 0a 2a 2a 20 46 54 53 33 20 61 6e f../*.** FTS3 an
27350 64 20 46 54 53 34 20 62 6f 74 68 20 72 65 71 75 d FTS4 both requ
27360 69 72 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c ire virtual tabl
27370 65 20 73 75 70 70 6f 72 74 0a 2a 2f 0a 23 69 66 e support.*/.#if
27380 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
27390 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
273a0 45 29 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 E).# undef SQLIT
273b0 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a 23 20 E_ENABLE_FTS3.#
273c0 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 undef SQLITE_ENA
273d0 42 4c 45 5f 46 54 53 34 0a 23 65 6e 64 69 66 0a BLE_FTS4.#endif.
273e0 0a 2f 2a 0a 2a 2a 20 46 54 53 34 20 69 73 20 72 ./*.** FTS4 is r
273f0 65 61 6c 6c 79 20 61 6e 20 65 78 74 65 6e 73 69 eally an extensi
27400 6f 6e 20 66 6f 72 20 46 54 53 33 2e 20 20 49 74 on for FTS3. It
27410 20 69 73 20 65 6e 61 62 6c 65 64 20 75 73 69 6e is enabled usin
27420 67 20 74 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f g the.** SQLITE_
27430 45 4e 41 42 4c 45 5f 46 54 53 33 20 6d 61 63 72 ENABLE_FTS3 macr
27440 6f 2e 20 20 42 75 74 20 74 6f 20 61 76 6f 69 64 o. But to avoid
27450 20 63 6f 6e 66 75 73 69 6f 6e 20 77 65 20 61 6c confusion we al
27460 73 6f 20 63 61 6c 6c 0a 2a 2a 20 74 68 65 20 53 so call.** the S
27470 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 QLITE_ENABLE_FTS
27480 34 20 6d 61 63 72 6f 20 74 6f 20 73 65 72 76 65 4 macro to serve
27490 20 61 73 20 61 6e 20 61 6c 69 61 73 20 66 6f 72 as an alias for
274a0 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
274b0 54 53 33 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 TS3..*/.#if defi
274c0 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
274d0 45 5f 46 54 53 34 29 20 26 26 20 21 64 65 66 69 E_FTS4) && !defi
274e0 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
274f0 45 5f 46 54 53 33 29 0a 23 20 64 65 66 69 6e 65 E_FTS3).# define
27500 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
27510 54 53 33 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a TS3 1.#endif../*
27520 0a 2a 2a 20 54 68 65 20 63 74 79 70 65 2e 68 20 .** The ctype.h
27530 68 65 61 64 65 72 20 69 73 20 6e 65 65 64 65 64 header is needed
27540 20 66 6f 72 20 6e 6f 6e 2d 41 53 43 49 49 20 73 for non-ASCII s
27550 79 73 74 65 6d 73 2e 20 20 49 74 20 69 73 20 61 ystems. It is a
27560 6c 73 6f 0a 2a 2a 20 6e 65 65 64 65 64 20 62 79 lso.** needed by
27570 20 46 54 53 33 20 77 68 65 6e 20 46 54 53 33 20 FTS3 when FTS3
27580 69 73 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 is included in t
27590 68 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 2e he amalgamation.
275a0 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 .*/.#if !defined
275b0 28 53 51 4c 49 54 45 5f 41 53 43 49 49 29 20 7c (SQLITE_ASCII) |
275c0 7c 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 | \. (defined
275d0 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 (SQLITE_ENABLE_F
275e0 54 53 33 29 20 26 26 20 64 65 66 69 6e 65 64 28 TS3) && defined(
275f0 53 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 SQLITE_AMALGAMAT
27600 49 4f 4e 29 29 0a 23 20 69 6e 63 6c 75 64 65 20 ION)).# include
27610 3c 63 74 79 70 65 2e 68 3e 0a 23 65 6e 64 69 66 <ctype.h>.#endif
27620 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ../*.** The foll
27630 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 6d 69 6d owing macros mim
27640 69 63 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 ic the standard
27650 6c 69 62 72 61 72 79 20 66 75 6e 63 74 69 6f 6e library function
27660 73 20 74 6f 75 70 70 65 72 28 29 2c 0a 2a 2a 20 s toupper(),.**
27670 69 73 73 70 61 63 65 28 29 2c 20 69 73 61 6c 6e isspace(), isaln
27680 75 6d 28 29 2c 20 69 73 64 69 67 69 74 28 29 20 um(), isdigit()
27690 61 6e 64 20 69 73 78 64 69 67 69 74 28 29 2c 20 and isxdigit(),
276a0 72 65 73 70 65 63 74 69 76 65 6c 79 2e 20 54 68 respectively. Th
276b0 65 0a 2a 2a 20 73 71 6c 69 74 65 20 76 65 72 73 e.** sqlite vers
276c0 69 6f 6e 73 20 6f 6e 6c 79 20 77 6f 72 6b 20 66 ions only work f
276d0 6f 72 20 41 53 43 49 49 20 63 68 61 72 61 63 74 or ASCII charact
276e0 65 72 73 2c 20 72 65 67 61 72 64 6c 65 73 73 20 ers, regardless
276f0 6f 66 20 6c 6f 63 61 6c 65 2e 0a 2a 2f 0a 23 69 of locale..*/.#i
27700 66 64 65 66 20 53 51 4c 49 54 45 5f 41 53 43 49 fdef SQLITE_ASCI
27710 49 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 I.# define sqlit
27720 65 33 54 6f 75 70 70 65 72 28 78 29 20 20 28 28 e3Toupper(x) ((
27730 78 29 26 7e 28 73 71 6c 69 74 65 33 43 74 79 70 x)&~(sqlite3Ctyp
27740 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 eMap[(unsigned c
27750 68 61 72 29 28 78 29 5d 26 30 78 32 30 29 29 0a har)(x)]&0x20)).
27760 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
27770 49 73 73 70 61 63 65 28 78 29 20 20 20 28 73 71 Isspace(x) (sq
27780 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
27790 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
277a0 5d 26 30 78 30 31 29 0a 23 20 64 65 66 69 6e 65 ]&0x01).# define
277b0 20 73 71 6c 69 74 65 33 49 73 61 6c 6e 75 6d 28 sqlite3Isalnum(
277c0 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 x) (sqlite3Cty
277d0 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
277e0 63 68 61 72 29 28 78 29 5d 26 30 78 30 36 29 0a char)(x)]&0x06).
277f0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
27800 49 73 61 6c 70 68 61 28 78 29 20 20 20 28 73 71 Isalpha(x) (sq
27810 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
27820 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
27830 5d 26 30 78 30 32 29 0a 23 20 64 65 66 69 6e 65 ]&0x02).# define
27840 20 73 71 6c 69 74 65 33 49 73 64 69 67 69 74 28 sqlite3Isdigit(
27850 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 x) (sqlite3Cty
27860 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
27870 63 68 61 72 29 28 78 29 5d 26 30 78 30 34 29 0a char)(x)]&0x04).
27880 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
27890 49 73 78 64 69 67 69 74 28 78 29 20 20 28 73 71 Isxdigit(x) (sq
278a0 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
278b0 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
278c0 5d 26 30 78 30 38 29 0a 23 20 64 65 66 69 6e 65 ]&0x08).# define
278d0 20 73 71 6c 69 74 65 33 54 6f 6c 6f 77 65 72 28 sqlite3Tolower(
278e0 78 29 20 20 20 28 73 71 6c 69 74 65 33 55 70 70 x) (sqlite3Upp
278f0 65 72 54 6f 4c 6f 77 65 72 5b 28 75 6e 73 69 67 erToLower[(unsig
27900 6e 65 64 20 63 68 61 72 29 28 78 29 5d 29 0a 23 ned char)(x)]).#
27910 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 define sqlite3I
27920 73 71 75 6f 74 65 28 78 29 20 20 20 28 73 71 6c squote(x) (sql
27930 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e ite3CtypeMap[(un
27940 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d signed char)(x)]
27950 26 30 78 38 30 29 0a 23 65 6c 73 65 0a 23 20 64 &0x80).#else.# d
27960 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f 75 efine sqlite3Tou
27970 70 70 65 72 28 78 29 20 20 20 74 6f 75 70 70 65 pper(x) touppe
27980 72 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 r((unsigned char
27990 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 )(x)).# define s
279a0 71 6c 69 74 65 33 49 73 73 70 61 63 65 28 78 29 qlite3Isspace(x)
279b0 20 20 20 69 73 73 70 61 63 65 28 28 75 6e 73 69 isspace((unsi
279c0 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 gned char)(x)).#
279d0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 define sqlite3I
279e0 73 61 6c 6e 75 6d 28 78 29 20 20 20 69 73 61 6c salnum(x) isal
279f0 6e 75 6d 28 28 75 6e 73 69 67 6e 65 64 20 63 68 num((unsigned ch
27a00 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 ar)(x)).# define
27a10 20 73 71 6c 69 74 65 33 49 73 61 6c 70 68 61 28 sqlite3Isalpha(
27a20 78 29 20 20 20 69 73 61 6c 70 68 61 28 28 75 6e x) isalpha((un
27a30 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 signed char)(x))
27a40 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
27a50 33 49 73 64 69 67 69 74 28 78 29 20 20 20 69 73 3Isdigit(x) is
27a60 64 69 67 69 74 28 28 75 6e 73 69 67 6e 65 64 20 digit((unsigned
27a70 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 char)(x)).# defi
27a80 6e 65 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 ne sqlite3Isxdig
27a90 69 74 28 78 29 20 20 69 73 78 64 69 67 69 74 28 it(x) isxdigit(
27aa0 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
27ab0 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c x)).# define sql
27ac0 69 74 65 33 54 6f 6c 6f 77 65 72 28 78 29 20 20 ite3Tolower(x)
27ad0 20 74 6f 6c 6f 77 65 72 28 28 75 6e 73 69 67 6e tolower((unsign
27ae0 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 ed char)(x)).# d
27af0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 71 efine sqlite3Isq
27b00 75 6f 74 65 28 78 29 20 20 20 28 28 78 29 3d 3d uote(x) ((x)==
27b10 27 22 27 7c 7c 28 78 29 3d 3d 27 5c 27 27 7c 7c '"'||(x)=='\''||
27b20 28 78 29 3d 3d 27 5b 27 7c 7c 28 78 29 3d 3d 27 (x)=='['||(x)=='
27b30 60 27 29 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 `').#endif.int s
27b40 71 6c 69 74 65 33 49 73 49 64 43 68 61 72 28 75 qlite3IsIdChar(u
27b50 38 29 3b 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 72 8);../*.** Inter
27b60 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 70 72 6f nal function pro
27b70 74 6f 74 79 70 65 73 0a 2a 2f 0a 69 6e 74 20 73 totypes.*/.int s
27b80 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 63 6f qlite3StrICmp(co
27b90 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 nst char*,const
27ba0 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 char*);.int sqli
27bb0 74 65 33 53 74 72 6c 65 6e 33 30 28 63 6f 6e 73 te3Strlen30(cons
27bc0 74 20 63 68 61 72 2a 29 3b 0a 23 64 65 66 69 6e t char*);.#defin
27bd0 65 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 e sqlite3Strlen3
27be0 30 4e 4e 28 43 29 20 28 73 74 72 6c 65 6e 28 43 0NN(C) (strlen(C
27bf0 29 26 30 78 33 66 66 66 66 66 66 66 29 0a 63 68 )&0x3fffffff).ch
27c00 61 72 20 2a 73 71 6c 69 74 65 33 43 6f 6c 75 6d ar *sqlite3Colum
27c10 6e 54 79 70 65 28 43 6f 6c 75 6d 6e 2a 2c 63 68 nType(Column*,ch
27c20 61 72 2a 29 3b 0a 23 64 65 66 69 6e 65 20 73 71 ar*);.#define sq
27c30 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 20 73 71 lite3StrNICmp sq
27c40 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d 70 0a 0a lite3_strnicmp..
27c50 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f int sqlite3Mallo
27c60 63 49 6e 69 74 28 76 6f 69 64 29 3b 0a 76 6f 69 cInit(void);.voi
27c70 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 45 d sqlite3MallocE
27c80 6e 64 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 2a nd(void);.void *
27c90 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 75 36 sqlite3Malloc(u6
27ca0 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 4);.void *sqlite
27cb0 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 75 36 34 29 3MallocZero(u64)
27cc0 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 ;.void *sqlite3D
27cd0 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 71 6c 69 bMallocZero(sqli
27ce0 74 65 33 2a 2c 20 75 36 34 29 3b 0a 76 6f 69 64 te3*, u64);.void
27cf0 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f *sqlite3DbMallo
27d00 63 52 61 77 28 73 71 6c 69 74 65 33 2a 2c 20 75 cRaw(sqlite3*, u
27d10 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 64);.void *sqlit
27d20 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 4e 4e 28 e3DbMallocRawNN(
27d30 73 71 6c 69 74 65 33 2a 2c 20 75 36 34 29 3b 0a sqlite3*, u64);.
27d40 63 68 61 72 20 2a 73 71 6c 69 74 65 33 44 62 53 char *sqlite3DbS
27d50 74 72 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 63 trDup(sqlite3*,c
27d60 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 63 68 61 onst char*);.cha
27d70 72 20 2a 73 71 6c 69 74 65 33 44 62 53 74 72 4e r *sqlite3DbStrN
27d80 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e Dup(sqlite3*,con
27d90 73 74 20 63 68 61 72 2a 2c 20 75 36 34 29 3b 0a st char*, u64);.
27da0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 44 62 53 char *sqlite3DbS
27db0 70 61 6e 44 75 70 28 73 71 6c 69 74 65 33 2a 2c panDup(sqlite3*,
27dc0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 const char*,cons
27dd0 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 2a t char*);.void *
27de0 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 76 sqlite3Realloc(v
27df0 6f 69 64 2a 2c 20 75 36 34 29 3b 0a 76 6f 69 64 oid*, u64);.void
27e00 20 2a 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c *sqlite3DbReall
27e10 6f 63 4f 72 46 72 65 65 28 73 71 6c 69 74 65 33 ocOrFree(sqlite3
27e20 20 2a 2c 20 76 6f 69 64 20 2a 2c 20 75 36 34 29 *, void *, u64)
27e30 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 ;.void *sqlite3D
27e40 62 52 65 61 6c 6c 6f 63 28 73 71 6c 69 74 65 33 bRealloc(sqlite3
27e50 20 2a 2c 20 76 6f 69 64 20 2a 2c 20 75 36 34 29 *, void *, u64)
27e60 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 62 ;.void sqlite3Db
27e70 46 72 65 65 28 73 71 6c 69 74 65 33 2a 2c 20 76 Free(sqlite3*, v
27e80 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 oid*);.void sqli
27e90 74 65 33 44 62 46 72 65 65 4e 4e 28 73 71 6c 69 te3DbFreeNN(sqli
27ea0 74 65 33 2a 2c 20 76 6f 69 64 2a 29 3b 0a 69 6e te3*, void*);.in
27eb0 74 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 t sqlite3MallocS
27ec0 69 7a 65 28 76 6f 69 64 2a 29 3b 0a 69 6e 74 20 ize(void*);.int
27ed0 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 53 sqlite3DbMallocS
27ee0 69 7a 65 28 73 71 6c 69 74 65 33 2a 2c 20 76 6f ize(sqlite3*, vo
27ef0 69 64 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 id*);.void *sqli
27f00 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69 6e te3PageMalloc(in
27f10 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
27f20 50 61 67 65 46 72 65 65 28 76 6f 69 64 2a 29 3b PageFree(void*);
27f30 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d .void sqlite3Mem
27f40 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69 64 29 SetDefault(void)
27f50 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
27f60 5f 55 4e 54 45 53 54 41 42 4c 45 0a 76 6f 69 64 _UNTESTABLE.void
27f70 20 73 71 6c 69 74 65 33 42 65 6e 69 67 6e 4d 61 sqlite3BenignMa
27f80 6c 6c 6f 63 48 6f 6f 6b 73 28 76 6f 69 64 20 28 llocHooks(void (
27f90 2a 29 28 76 6f 69 64 29 2c 20 76 6f 69 64 20 28 *)(void), void (
27fa0 2a 29 28 76 6f 69 64 29 29 3b 0a 23 65 6e 64 69 *)(void));.#endi
27fb0 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61 f.int sqlite3Hea
27fc0 70 4e 65 61 72 6c 79 46 75 6c 6c 28 76 6f 69 64 pNearlyFull(void
27fd0 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 20 73 79 73 );../*.** On sys
27fe0 74 65 6d 73 20 77 69 74 68 20 61 6d 70 6c 65 20 tems with ample
27ff0 73 74 61 63 6b 20 73 70 61 63 65 20 61 6e 64 20 stack space and
28000 74 68 61 74 20 73 75 70 70 6f 72 74 20 61 6c 6c that support all
28010 6f 63 61 28 29 2c 20 6d 61 6b 65 0a 2a 2a 20 75 oca(), make.** u
28020 73 65 20 6f 66 20 61 6c 6c 6f 63 61 28 29 20 74 se of alloca() t
28030 6f 20 6f 62 74 61 69 6e 20 73 70 61 63 65 20 66 o obtain space f
28040 6f 72 20 6c 61 72 67 65 20 61 75 74 6f 6d 61 74 or large automat
28050 69 63 20 6f 62 6a 65 63 74 73 2e 20 20 42 79 20 ic objects. By
28060 64 65 66 61 75 6c 74 2c 0a 2a 2a 20 6f 62 74 61 default,.** obta
28070 69 6e 20 73 70 61 63 65 20 66 72 6f 6d 20 6d 61 in space from ma
28080 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 lloc()..**.** Th
28090 65 20 61 6c 6c 6f 63 61 28 29 20 72 6f 75 74 69 e alloca() routi
280a0 6e 65 20 6e 65 76 65 72 20 72 65 74 75 72 6e 73 ne never returns
280b0 20 4e 55 4c 4c 2e 20 20 54 68 69 73 20 77 69 6c NULL. This wil
280c0 6c 20 63 61 75 73 65 20 63 6f 64 65 20 70 61 74 l cause code pat
280d0 68 73 0a 2a 2a 20 74 68 61 74 20 64 65 61 6c 20 hs.** that deal
280e0 77 69 74 68 20 73 71 6c 69 74 65 33 53 74 61 63 with sqlite3Stac
280f0 6b 41 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 kAlloc() failure
28100 73 20 74 6f 20 62 65 20 75 6e 72 65 61 63 68 61 s to be unreacha
28110 62 6c 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 ble..*/.#ifdef S
28120 51 4c 49 54 45 5f 55 53 45 5f 41 4c 4c 4f 43 41 QLITE_USE_ALLOCA
28130 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
28140 33 53 74 61 63 6b 41 6c 6c 6f 63 52 61 77 28 44 3StackAllocRaw(D
28150 2c 4e 29 20 20 20 61 6c 6c 6f 63 61 28 4e 29 0a ,N) alloca(N).
28160 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
28170 53 74 61 63 6b 41 6c 6c 6f 63 5a 65 72 6f 28 44 StackAllocZero(D
28180 2c 4e 29 20 20 6d 65 6d 73 65 74 28 61 6c 6c 6f ,N) memset(allo
28190 63 61 28 4e 29 2c 20 30 2c 20 4e 29 0a 23 20 64 ca(N), 0, N).# d
281a0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 efine sqlite3Sta
281b0 63 6b 46 72 65 65 28 44 2c 50 29 0a 23 65 6c 73 ckFree(D,P).#els
281c0 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 e.# define sqlit
281d0 65 33 53 74 61 63 6b 41 6c 6c 6f 63 52 61 77 28 e3StackAllocRaw(
281e0 44 2c 4e 29 20 20 20 73 71 6c 69 74 65 33 44 62 D,N) sqlite3Db
281f0 4d 61 6c 6c 6f 63 52 61 77 28 44 2c 4e 29 0a 23 MallocRaw(D,N).#
28200 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 define sqlite3S
28210 74 61 63 6b 41 6c 6c 6f 63 5a 65 72 6f 28 44 2c tackAllocZero(D,
28220 4e 29 20 20 73 71 6c 69 74 65 33 44 62 4d 61 6c N) sqlite3DbMal
28230 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 0a 23 20 64 locZero(D,N).# d
28240 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 efine sqlite3Sta
28250 63 6b 46 72 65 65 28 44 2c 50 29 20 20 20 20 20 ckFree(D,P)
28260 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
28270 44 2c 50 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 D,P).#endif../*
28280 44 6f 20 6e 6f 74 20 61 6c 6c 6f 77 20 62 6f 74 Do not allow bot
28290 68 20 4d 45 4d 53 59 53 35 20 61 6e 64 20 4d 45 h MEMSYS5 and ME
282a0 4d 53 59 53 33 20 74 6f 20 62 65 20 64 65 66 69 MSYS3 to be defi
282b0 6e 65 64 20 74 6f 67 65 74 68 65 72 2e 20 20 49 ned together. I
282c0 66 20 74 68 65 79 0a 2a 2a 20 61 72 65 2c 20 64 f they.** are, d
282d0 69 73 61 62 6c 65 20 4d 45 4d 53 59 53 33 0a 2a isable MEMSYS3.*
282e0 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
282f0 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 0a 63 ENABLE_MEMSYS5.c
28300 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 65 6d onst sqlite3_mem
28310 5f 6d 65 74 68 6f 64 73 20 2a 73 71 6c 69 74 65 _methods *sqlite
28320 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 35 28 76 3MemGetMemsys5(v
28330 6f 69 64 29 3b 0a 23 75 6e 64 65 66 20 53 51 4c oid);.#undef SQL
28340 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
28350 53 33 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 S3.#endif.#ifdef
28360 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d SQLITE_ENABLE_M
28370 45 4d 53 59 53 33 0a 63 6f 6e 73 74 20 73 71 6c EMSYS3.const sql
28380 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 ite3_mem_methods
28390 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d *sqlite3MemGetM
283a0 65 6d 73 79 73 33 28 76 6f 69 64 29 3b 0a 23 65 emsys3(void);.#e
283b0 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 65 66 20 53 ndif...#ifndef S
283c0 51 4c 49 54 45 5f 4d 55 54 45 58 5f 4f 4d 49 54 QLITE_MUTEX_OMIT
283d0 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
283e0 5f 6d 65 74 68 6f 64 73 20 63 6f 6e 73 74 20 2a _methods const *
283f0 73 71 6c 69 74 65 33 44 65 66 61 75 6c 74 4d 75 sqlite3DefaultMu
28400 74 65 78 28 76 6f 69 64 29 3b 0a 20 20 73 71 6c tex(void);. sql
28410 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f ite3_mutex_metho
28420 64 73 20 63 6f 6e 73 74 20 2a 73 71 6c 69 74 65 ds const *sqlite
28430 33 4e 6f 6f 70 4d 75 74 65 78 28 76 6f 69 64 29 3NoopMutex(void)
28440 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 ;. sqlite3_mute
28450 78 20 2a 73 71 6c 69 74 65 33 4d 75 74 65 78 41 x *sqlite3MutexA
28460 6c 6c 6f 63 28 69 6e 74 29 3b 0a 20 20 69 6e 74 lloc(int);. int
28470 20 73 71 6c 69 74 65 33 4d 75 74 65 78 49 6e 69 sqlite3MutexIni
28480 74 28 76 6f 69 64 29 3b 0a 20 20 69 6e 74 20 73 t(void);. int s
28490 71 6c 69 74 65 33 4d 75 74 65 78 45 6e 64 28 76 qlite3MutexEnd(v
284a0 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 oid);.#endif.#if
284b0 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
284c0 5f 4d 55 54 45 58 5f 4f 4d 49 54 29 20 26 26 20 _MUTEX_OMIT) &&
284d0 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
284e0 4d 55 54 45 58 5f 4e 4f 4f 50 29 0a 20 20 76 6f MUTEX_NOOP). vo
284f0 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79 id sqlite3Memory
28500 42 61 72 72 69 65 72 28 76 6f 69 64 29 3b 0a 23 Barrier(void);.#
28510 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
28520 6c 69 74 65 33 4d 65 6d 6f 72 79 42 61 72 72 69 lite3MemoryBarri
28530 65 72 28 29 0a 23 65 6e 64 69 66 0a 0a 73 71 6c er().#endif..sql
28540 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 74 ite3_int64 sqlit
28550 65 33 53 74 61 74 75 73 56 61 6c 75 65 28 69 6e e3StatusValue(in
28560 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
28570 53 74 61 74 75 73 55 70 28 69 6e 74 2c 20 69 6e StatusUp(int, in
28580 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
28590 53 74 61 74 75 73 44 6f 77 6e 28 69 6e 74 2c 20 StatusDown(int,
285a0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
285b0 65 33 53 74 61 74 75 73 48 69 67 68 77 61 74 65 e3StatusHighwate
285c0 72 28 69 6e 74 2c 20 69 6e 74 29 3b 0a 69 6e 74 r(int, int);.int
285d0 20 73 71 6c 69 74 65 33 4c 6f 6f 6b 61 73 69 64 sqlite3Lookasid
285e0 65 55 73 65 64 28 73 71 6c 69 74 65 33 2a 2c 69 eUsed(sqlite3*,i
285f0 6e 74 2a 29 3b 0a 0a 2f 2a 20 41 63 63 65 73 73 nt*);../* Access
28600 20 74 6f 20 6d 75 74 65 78 65 73 20 75 73 65 64 to mutexes used
28610 20 62 79 20 73 71 6c 69 74 65 33 5f 73 74 61 74 by sqlite3_stat
28620 75 73 28 29 20 2a 2f 0a 73 71 6c 69 74 65 33 5f us() */.sqlite3_
28630 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 50 63 mutex *sqlite3Pc
28640 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69 64 29 ache1Mutex(void)
28650 3b 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 ;.sqlite3_mutex
28660 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 4d 75 *sqlite3MallocMu
28670 74 65 78 28 76 6f 69 64 29 3b 0a 0a 23 69 66 20 tex(void);..#if
28680 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
28690 4e 41 42 4c 45 5f 4d 55 4c 54 49 54 48 52 45 41 NABLE_MULTITHREA
286a0 44 45 44 5f 43 48 45 43 4b 53 29 20 26 26 20 21 DED_CHECKS) && !
286b0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d defined(SQLITE_M
286c0 55 54 45 58 5f 4f 4d 49 54 29 0a 76 6f 69 64 20 UTEX_OMIT).void
286d0 73 71 6c 69 74 65 33 4d 75 74 65 78 57 61 72 6e sqlite3MutexWarn
286e0 4f 6e 43 6f 6e 74 65 6e 74 69 6f 6e 28 73 71 6c OnContention(sql
286f0 69 74 65 33 5f 6d 75 74 65 78 2a 29 3b 0a 23 65 ite3_mutex*);.#e
28700 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
28710 69 74 65 33 4d 75 74 65 78 57 61 72 6e 4f 6e 43 ite3MutexWarnOnC
28720 6f 6e 74 65 6e 74 69 6f 6e 28 78 29 0a 23 65 6e ontention(x).#en
28730 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c dif..#ifndef SQL
28740 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e ITE_OMIT_FLOATIN
28750 47 5f 50 4f 49 4e 54 0a 20 20 69 6e 74 20 73 71 G_POINT. int sq
28760 6c 69 74 65 33 49 73 4e 61 4e 28 64 6f 75 62 6c lite3IsNaN(doubl
28770 65 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 e);.#else.# defi
28780 6e 65 20 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 ne sqlite3IsNaN(
28790 58 29 20 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a X) 0.#endif../*
287a0 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
287b0 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
287c0 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 structure holds
287d0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f information abo
287e0 75 74 20 53 51 4c 0a 2a 2a 20 66 75 6e 63 74 69 ut SQL.** functi
287f0 6f 6e 73 20 61 72 67 75 6d 65 6e 74 73 20 74 68 ons arguments th
28800 61 74 20 61 72 65 20 74 68 65 20 70 61 72 61 6d at are the param
28810 65 74 65 72 73 20 74 6f 20 74 68 65 20 70 72 69 eters to the pri
28820 6e 74 66 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a ntf() function..
28830 2a 2f 0a 73 74 72 75 63 74 20 50 72 69 6e 74 66 */.struct Printf
28840 41 72 67 75 6d 65 6e 74 73 20 7b 0a 20 20 69 6e Arguments {. in
28850 74 20 6e 41 72 67 3b 20 20 20 20 20 20 20 20 20 t nArg;
28860 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 /* Total
28870 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 number of argume
28880 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 55 73 nts */. int nUs
28890 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ed;
288a0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 /* Number of a
288b0 72 67 75 6d 65 6e 74 73 20 75 73 65 64 20 73 6f rguments used so
288c0 20 66 61 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 far */. sqlite
288d0 33 5f 76 61 6c 75 65 20 2a 2a 61 70 41 72 67 3b 3_value **apArg;
288e0 20 20 20 2f 2a 20 54 68 65 20 61 72 67 75 6d 65 /* The argume
288f0 6e 74 20 76 61 6c 75 65 73 20 2a 2f 0a 7d 3b 0a nt values */.};.
28900 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4d 50 .char *sqlite3MP
28910 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c 63 rintf(sqlite3*,c
28920 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 onst char*, ...)
28930 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 ;.char *sqlite3V
28940 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a MPrintf(sqlite3*
28950 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 76 61 ,const char*, va
28960 5f 6c 69 73 74 29 3b 0a 23 69 66 20 64 65 66 69 _list);.#if defi
28970 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
28980 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c ) || defined(SQL
28990 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 41 43 ITE_HAVE_OS_TRAC
289a0 45 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 E). void sqlite
289b0 33 44 65 62 75 67 50 72 69 6e 74 66 28 63 6f 6e 3DebugPrintf(con
289c0 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a st char*, ...);.
289d0 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
289e0 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 0a ed(SQLITE_TEST).
289f0 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 54 void *sqlite3T
28a00 65 73 74 54 65 78 74 54 6f 50 74 72 28 63 6f 6e estTextToPtr(con
28a10 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 st char*);.#endi
28a20 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 f..#if defined(S
28a30 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 20 76 QLITE_DEBUG). v
28a40 6f 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 56 oid sqlite3TreeV
28a50 69 65 77 45 78 70 72 28 54 72 65 65 56 69 65 77 iewExpr(TreeView
28a60 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 2a 2c 20 *, const Expr*,
28a70 75 38 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 u8);. void sqli
28a80 74 65 33 54 72 65 65 56 69 65 77 42 61 72 65 45 te3TreeViewBareE
28a90 78 70 72 4c 69 73 74 28 54 72 65 65 56 69 65 77 xprList(TreeView
28aa0 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 4c 69 73 *, const ExprLis
28ab0 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 t*, const char*)
28ac0 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
28ad0 54 72 65 65 56 69 65 77 45 78 70 72 4c 69 73 74 TreeViewExprList
28ae0 28 54 72 65 65 56 69 65 77 2a 2c 20 63 6f 6e 73 (TreeView*, cons
28af0 74 20 45 78 70 72 4c 69 73 74 2a 2c 20 75 38 2c t ExprList*, u8,
28b00 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 const char*);.
28b10 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 65 void sqlite3Tre
28b20 65 56 69 65 77 53 72 63 4c 69 73 74 28 54 72 65 eViewSrcList(Tre
28b30 65 56 69 65 77 2a 2c 20 63 6f 6e 73 74 20 53 72 eView*, const Sr
28b40 63 4c 69 73 74 2a 29 3b 0a 20 20 76 6f 69 64 20 cList*);. void
28b50 73 71 6c 69 74 65 33 54 72 65 65 56 69 65 77 53 sqlite3TreeViewS
28b60 65 6c 65 63 74 28 54 72 65 65 56 69 65 77 2a 2c elect(TreeView*,
28b70 20 63 6f 6e 73 74 20 53 65 6c 65 63 74 2a 2c 20 const Select*,
28b80 75 38 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 u8);. void sqli
28b90 74 65 33 54 72 65 65 56 69 65 77 57 69 74 68 28 te3TreeViewWith(
28ba0 54 72 65 65 56 69 65 77 2a 2c 20 63 6f 6e 73 74 TreeView*, const
28bb0 20 57 69 74 68 2a 2c 20 75 38 29 3b 0a 23 69 66 With*, u8);.#if
28bc0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
28bd0 5f 57 49 4e 44 4f 57 46 55 4e 43 0a 20 20 76 6f _WINDOWFUNC. vo
28be0 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 56 69 id sqlite3TreeVi
28bf0 65 77 57 69 6e 64 6f 77 28 54 72 65 65 56 69 65 ewWindow(TreeVie
28c00 77 2a 2c 20 63 6f 6e 73 74 20 57 69 6e 64 6f 77 w*, const Window
28c10 2a 2c 20 75 38 29 3b 0a 20 20 76 6f 69 64 20 73 *, u8);. void s
28c20 71 6c 69 74 65 33 54 72 65 65 56 69 65 77 57 69 qlite3TreeViewWi
28c30 6e 46 75 6e 63 28 54 72 65 65 56 69 65 77 2a 2c nFunc(TreeView*,
28c40 20 63 6f 6e 73 74 20 57 69 6e 64 6f 77 2a 2c 20 const Window*,
28c50 75 38 29 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64 u8);.#endif.#end
28c60 69 66 0a 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 if...void sqlite
28c70 33 53 65 74 53 74 72 69 6e 67 28 63 68 61 72 20 3SetString(char
28c80 2a 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 63 6f **, sqlite3*, co
28c90 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
28ca0 20 73 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 sqlite3ErrorMsg
28cb0 28 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 (Parse*, const c
28cc0 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 64 har*, ...);.void
28cd0 20 73 71 6c 69 74 65 33 44 65 71 75 6f 74 65 28 sqlite3Dequote(
28ce0 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c char*);.void sql
28cf0 69 74 65 33 54 6f 6b 65 6e 49 6e 69 74 28 54 6f ite3TokenInit(To
28d00 6b 65 6e 2a 2c 63 68 61 72 2a 29 3b 0a 69 6e 74 ken*,char*);.int
28d10 20 73 71 6c 69 74 65 33 4b 65 79 77 6f 72 64 43 sqlite3KeywordC
28d20 6f 64 65 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e ode(const unsign
28d30 65 64 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a ed char*, int);.
28d40 69 6e 74 20 73 71 6c 69 74 65 33 52 75 6e 50 61 int sqlite3RunPa
28d50 72 73 65 72 28 50 61 72 73 65 2a 2c 20 63 6f 6e rser(Parse*, con
28d60 73 74 20 63 68 61 72 2a 2c 20 63 68 61 72 20 2a st char*, char *
28d70 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
28d80 46 69 6e 69 73 68 43 6f 64 69 6e 67 28 50 61 72 FinishCoding(Par
28d90 73 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 se*);.int sqlite
28da0 33 47 65 74 54 65 6d 70 52 65 67 28 50 61 72 73 3GetTempReg(Pars
28db0 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
28dc0 33 52 65 6c 65 61 73 65 54 65 6d 70 52 65 67 28 3ReleaseTempReg(
28dd0 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 69 6e 74 Parse*,int);.int
28de0 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d 70 52 sqlite3GetTempR
28df0 61 6e 67 65 28 50 61 72 73 65 2a 2c 69 6e 74 29 ange(Parse*,int)
28e00 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 ;.void sqlite3Re
28e10 6c 65 61 73 65 54 65 6d 70 52 61 6e 67 65 28 50 leaseTempRange(P
28e20 61 72 73 65 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a arse*,int,int);.
28e30 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 65 61 void sqlite3Clea
28e40 72 54 65 6d 70 52 65 67 43 61 63 68 65 28 50 61 rTempRegCache(Pa
28e50 72 73 65 2a 29 3b 0a 23 69 66 64 65 66 20 53 51 rse*);.#ifdef SQ
28e60 4c 49 54 45 5f 44 45 42 55 47 0a 69 6e 74 20 73 LITE_DEBUG.int s
28e70 71 6c 69 74 65 33 4e 6f 54 65 6d 70 73 49 6e 52 qlite3NoTempsInR
28e80 61 6e 67 65 28 50 61 72 73 65 2a 2c 69 6e 74 2c ange(Parse*,int,
28e90 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 45 78 70 int);.#endif.Exp
28ea0 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 41 6c r *sqlite3ExprAl
28eb0 6c 6f 63 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 loc(sqlite3*,int
28ec0 2c 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 2c 69 6e ,const Token*,in
28ed0 74 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 t);.Expr *sqlite
28ee0 33 45 78 70 72 28 73 71 6c 69 74 65 33 2a 2c 69 3Expr(sqlite3*,i
28ef0 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b nt,const char*);
28f00 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
28f10 72 41 74 74 61 63 68 53 75 62 74 72 65 65 73 28 rAttachSubtrees(
28f20 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 45 sqlite3*,Expr*,E
28f30 78 70 72 2a 2c 45 78 70 72 2a 29 3b 0a 45 78 70 xpr*,Expr*);.Exp
28f40 72 20 2a 73 71 6c 69 74 65 33 50 45 78 70 72 28 r *sqlite3PExpr(
28f50 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 45 78 70 Parse*, int, Exp
28f60 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 r*, Expr*);.void
28f70 20 73 71 6c 69 74 65 33 50 45 78 70 72 41 64 64 sqlite3PExprAdd
28f80 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c 20 45 Select(Parse*, E
28f90 78 70 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a xpr*, Select*);.
28fa0 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
28fb0 72 41 6e 64 28 73 71 6c 69 74 65 33 2a 2c 45 78 rAnd(sqlite3*,Ex
28fc0 70 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 45 78 70 pr*, Expr*);.Exp
28fd0 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 46 75 r *sqlite3ExprFu
28fe0 6e 63 74 69 6f 6e 28 50 61 72 73 65 2a 2c 45 78 nction(Parse*,Ex
28ff0 70 72 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 2c prList*, Token*,
29000 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
29010 74 65 33 45 78 70 72 41 73 73 69 67 6e 56 61 72 te3ExprAssignVar
29020 4e 75 6d 62 65 72 28 50 61 72 73 65 2a 2c 20 45 Number(Parse*, E
29030 78 70 72 2a 2c 20 75 33 32 29 3b 0a 76 6f 69 64 xpr*, u32);.void
29040 20 73 71 6c 69 74 65 33 45 78 70 72 44 65 6c 65 sqlite3ExprDele
29050 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 45 78 70 te(sqlite3*, Exp
29060 72 2a 29 3b 0a 45 78 70 72 4c 69 73 74 20 2a 73 r*);.ExprList *s
29070 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 41 70 qlite3ExprListAp
29080 70 65 6e 64 28 50 61 72 73 65 2a 2c 45 78 70 72 pend(Parse*,Expr
29090 4c 69 73 74 2a 2c 45 78 70 72 2a 29 3b 0a 45 78 List*,Expr*);.Ex
290a0 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 45 prList *sqlite3E
290b0 78 70 72 4c 69 73 74 41 70 70 65 6e 64 56 65 63 xprListAppendVec
290c0 74 6f 72 28 50 61 72 73 65 2a 2c 45 78 70 72 4c tor(Parse*,ExprL
290d0 69 73 74 2a 2c 49 64 4c 69 73 74 2a 2c 45 78 70 ist*,IdList*,Exp
290e0 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
290f0 33 45 78 70 72 4c 69 73 74 53 65 74 53 6f 72 74 3ExprListSetSort
29100 4f 72 64 65 72 28 45 78 70 72 4c 69 73 74 2a 2c Order(ExprList*,
29110 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
29120 65 33 45 78 70 72 4c 69 73 74 53 65 74 4e 61 6d e3ExprListSetNam
29130 65 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 e(Parse*,ExprLis
29140 74 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a t*,Token*,int);.
29150 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
29160 4c 69 73 74 53 65 74 53 70 61 6e 28 50 61 72 73 ListSetSpan(Pars
29170 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 63 6f 6e e*,ExprList*,con
29180 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 st char*,const c
29190 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 har*);.void sqli
291a0 74 65 33 45 78 70 72 4c 69 73 74 44 65 6c 65 74 te3ExprListDelet
291b0 65 28 73 71 6c 69 74 65 33 2a 2c 20 45 78 70 72 e(sqlite3*, Expr
291c0 4c 69 73 74 2a 29 3b 0a 75 33 32 20 73 71 6c 69 List*);.u32 sqli
291d0 74 65 33 45 78 70 72 4c 69 73 74 46 6c 61 67 73 te3ExprListFlags
291e0 28 63 6f 6e 73 74 20 45 78 70 72 4c 69 73 74 2a (const ExprList*
291f0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e );.int sqlite3In
29200 69 74 28 73 71 6c 69 74 65 33 2a 2c 20 63 68 61 it(sqlite3*, cha
29210 72 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 r**);.int sqlite
29220 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 3InitCallback(vo
29230 69 64 2a 2c 20 69 6e 74 2c 20 63 68 61 72 2a 2a id*, int, char**
29240 2c 20 63 68 61 72 2a 2a 29 3b 0a 69 6e 74 20 73 , char**);.int s
29250 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 73 71 qlite3InitOne(sq
29260 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 68 61 lite3*, int, cha
29270 72 2a 2a 2c 20 75 33 32 29 3b 0a 76 6f 69 64 20 r**, u32);.void
29280 73 71 6c 69 74 65 33 50 72 61 67 6d 61 28 50 61 sqlite3Pragma(Pa
29290 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
292a0 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a n*,Token*,int);.
292b0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
292c0 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
292d0 0a 4d 6f 64 75 6c 65 20 2a 73 71 6c 69 74 65 33 .Module *sqlite3
292e0 50 72 61 67 6d 61 56 74 61 62 52 65 67 69 73 74 PragmaVtabRegist
292f0 65 72 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 er(sqlite3*,cons
29300 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 29 3b 0a t char *zName);.
29310 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 #endif.void sqli
29320 74 65 33 52 65 73 65 74 41 6c 6c 53 63 68 65 6d te3ResetAllSchem
29330 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f 6e 28 73 asOfConnection(s
29340 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 qlite3*);.void s
29350 71 6c 69 74 65 33 52 65 73 65 74 4f 6e 65 53 63 qlite3ResetOneSc
29360 68 65 6d 61 28 73 71 6c 69 74 65 33 2a 2c 69 6e hema(sqlite3*,in
29370 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
29380 43 6f 6c 6c 61 70 73 65 44 61 74 61 62 61 73 65 CollapseDatabase
29390 41 72 72 61 79 28 73 71 6c 69 74 65 33 2a 29 3b Array(sqlite3*);
293a0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6d .void sqlite3Com
293b0 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 mitInternalChang
293c0 65 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f es(sqlite3*);.vo
293d0 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 id sqlite3Delete
293e0 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 73 71 6c 69 ColumnNames(sqli
293f0 74 65 33 2a 2c 54 61 62 6c 65 2a 29 3b 0a 69 6e te3*,Table*);.in
29400 74 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 73 t sqlite3Columns
29410 46 72 6f 6d 45 78 70 72 4c 69 73 74 28 50 61 72 FromExprList(Par
29420 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 31 se*,ExprList*,i1
29430 36 2a 2c 43 6f 6c 75 6d 6e 2a 2a 29 3b 0a 76 6f 6*,Column**);.vo
29440 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 id sqlite3Select
29450 41 64 64 43 6f 6c 75 6d 6e 54 79 70 65 41 6e 64 AddColumnTypeAnd
29460 43 6f 6c 6c 61 74 69 6f 6e 28 50 61 72 73 65 2a Collation(Parse*
29470 2c 54 61 62 6c 65 2a 2c 53 65 6c 65 63 74 2a 29 ,Table*,Select*)
29480 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 ;.Table *sqlite3
29490 52 65 73 75 6c 74 53 65 74 4f 66 53 65 6c 65 63 ResultSetOfSelec
294a0 74 28 50 61 72 73 65 2a 2c 53 65 6c 65 63 74 2a t(Parse*,Select*
294b0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4f );.void sqlite3O
294c0 70 65 6e 4d 61 73 74 65 72 54 61 62 6c 65 28 50 penMasterTable(P
294d0 61 72 73 65 20 2a 2c 20 69 6e 74 29 3b 0a 49 6e arse *, int);.In
294e0 64 65 78 20 2a 73 71 6c 69 74 65 33 50 72 69 6d dex *sqlite3Prim
294f0 61 72 79 4b 65 79 49 6e 64 65 78 28 54 61 62 6c aryKeyIndex(Tabl
29500 65 2a 29 3b 0a 69 31 36 20 73 71 6c 69 74 65 33 e*);.i16 sqlite3
29510 43 6f 6c 75 6d 6e 4f 66 49 6e 64 65 78 28 49 6e ColumnOfIndex(In
29520 64 65 78 2a 2c 20 69 31 36 29 3b 0a 76 6f 69 64 dex*, i16);.void
29530 20 73 71 6c 69 74 65 33 53 74 61 72 74 54 61 62 sqlite3StartTab
29540 6c 65 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a le(Parse*,Token*
29550 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 2c 69 6e 74 2c ,Token*,int,int,
29560 69 6e 74 2c 69 6e 74 29 3b 0a 23 69 66 20 53 51 int,int);.#if SQ
29570 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 48 49 44 44 LITE_ENABLE_HIDD
29580 45 4e 5f 43 4f 4c 55 4d 4e 53 0a 20 20 76 6f 69 EN_COLUMNS. voi
29590 64 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 50 d sqlite3ColumnP
295a0 72 6f 70 65 72 74 69 65 73 46 72 6f 6d 4e 61 6d ropertiesFromNam
295b0 65 28 54 61 62 6c 65 2a 2c 20 43 6f 6c 75 6d 6e e(Table*, Column
295c0 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 *);.#else.# defi
295d0 6e 65 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e ne sqlite3Column
295e0 50 72 6f 70 65 72 74 69 65 73 46 72 6f 6d 4e 61 PropertiesFromNa
295f0 6d 65 28 54 2c 43 29 20 2f 2a 20 6e 6f 2d 6f 70 me(T,C) /* no-op
29600 20 2a 2f 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 */.#endif.void
29610 73 71 6c 69 74 65 33 41 64 64 43 6f 6c 75 6d 6e sqlite3AddColumn
29620 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 (Parse*,Token*,T
29630 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c oken*);.void sql
29640 69 74 65 33 41 64 64 4e 6f 74 4e 75 6c 6c 28 50 ite3AddNotNull(P
29650 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 arse*, int);.voi
29660 64 20 73 71 6c 69 74 65 33 41 64 64 50 72 69 6d d sqlite3AddPrim
29670 61 72 79 4b 65 79 28 50 61 72 73 65 2a 2c 20 45 aryKey(Parse*, E
29680 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 xprList*, int, i
29690 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
296a0 71 6c 69 74 65 33 41 64 64 43 68 65 63 6b 43 6f qlite3AddCheckCo
296b0 6e 73 74 72 61 69 6e 74 28 50 61 72 73 65 2a 2c nstraint(Parse*,
296c0 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 Expr*);.void sq
296d0 6c 69 74 65 33 41 64 64 44 65 66 61 75 6c 74 56 lite3AddDefaultV
296e0 61 6c 75 65 28 50 61 72 73 65 2a 2c 45 78 70 72 alue(Parse*,Expr
296f0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f *,const char*,co
29700 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
29710 20 73 71 6c 69 74 65 33 41 64 64 43 6f 6c 6c 61 sqlite3AddColla
29720 74 65 54 79 70 65 28 50 61 72 73 65 2a 2c 20 54 teType(Parse*, T
29730 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c oken*);.void sql
29740 69 74 65 33 45 6e 64 54 61 62 6c 65 28 50 61 72 ite3EndTable(Par
29750 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e se*,Token*,Token
29760 2a 2c 75 38 2c 53 65 6c 65 63 74 2a 29 3b 0a 69 *,u8,Select*);.i
29770 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 55 nt sqlite3ParseU
29780 72 69 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 ri(const char*,c
29790 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 73 69 67 onst char*,unsig
297a0 6e 65 64 20 69 6e 74 2a 2c 0a 20 20 20 20 20 20 ned int*,.
297b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 sq
297c0 6c 69 74 65 33 5f 76 66 73 2a 2a 2c 63 68 61 72 lite3_vfs**,char
297d0 2a 2a 2c 63 68 61 72 20 2a 2a 29 3b 0a 42 74 72 **,char **);.Btr
297e0 65 65 20 2a 73 71 6c 69 74 65 33 44 62 4e 61 6d ee *sqlite3DbNam
297f0 65 54 6f 42 74 72 65 65 28 73 71 6c 69 74 65 33 eToBtree(sqlite3
29800 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a *,const char*);.
29810 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 .#ifdef SQLITE_U
29820 4e 54 45 53 54 41 42 4c 45 0a 23 20 64 65 66 69 NTESTABLE.# defi
29830 6e 65 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 ne sqlite3FaultS
29840 69 6d 28 58 29 20 53 51 4c 49 54 45 5f 4f 4b 0a im(X) SQLITE_OK.
29850 23 65 6c 73 65 0a 20 20 69 6e 74 20 73 71 6c 69 #else. int sqli
29860 74 65 33 46 61 75 6c 74 53 69 6d 28 69 6e 74 29 te3FaultSim(int)
29870 3b 0a 23 65 6e 64 69 66 0a 0a 42 69 74 76 65 63 ;.#endif..Bitvec
29880 20 2a 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 *sqlite3BitvecC
29890 72 65 61 74 65 28 75 33 32 29 3b 0a 69 6e 74 20 reate(u32);.int
298a0 73 71 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 sqlite3BitvecTes
298b0 74 28 42 69 74 76 65 63 2a 2c 20 75 33 32 29 3b t(Bitvec*, u32);
298c0 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 74 76 .int sqlite3Bitv
298d0 65 63 54 65 73 74 4e 6f 74 4e 75 6c 6c 28 42 69 ecTestNotNull(Bi
298e0 74 76 65 63 2a 2c 20 75 33 32 29 3b 0a 69 6e 74 tvec*, u32);.int
298f0 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 65 sqlite3BitvecSe
29900 74 28 42 69 74 76 65 63 2a 2c 20 75 33 32 29 3b t(Bitvec*, u32);
29910 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 69 74 .void sqlite3Bit
29920 76 65 63 43 6c 65 61 72 28 42 69 74 76 65 63 2a vecClear(Bitvec*
29930 2c 20 75 33 32 2c 20 76 6f 69 64 2a 29 3b 0a 76 , u32, void*);.v
29940 6f 69 64 20 73 71 6c 69 74 65 33 42 69 74 76 65 oid sqlite3Bitve
29950 63 44 65 73 74 72 6f 79 28 42 69 74 76 65 63 2a cDestroy(Bitvec*
29960 29 3b 0a 75 33 32 20 73 71 6c 69 74 65 33 42 69 );.u32 sqlite3Bi
29970 74 76 65 63 53 69 7a 65 28 42 69 74 76 65 63 2a tvecSize(Bitvec*
29980 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
29990 45 5f 55 4e 54 45 53 54 41 42 4c 45 0a 69 6e 74 E_UNTESTABLE.int
299a0 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 sqlite3BitvecBu
299b0 69 6c 74 69 6e 54 65 73 74 28 69 6e 74 2c 69 6e iltinTest(int,in
299c0 74 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 52 6f 77 t*);.#endif..Row
299d0 53 65 74 20 2a 73 71 6c 69 74 65 33 52 6f 77 53 Set *sqlite3RowS
299e0 65 74 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 etInit(sqlite3*)
299f0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f ;.void sqlite3Ro
29a00 77 53 65 74 44 65 6c 65 74 65 28 76 6f 69 64 2a wSetDelete(void*
29a10 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
29a20 6f 77 53 65 74 43 6c 65 61 72 28 76 6f 69 64 2a owSetClear(void*
29a30 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
29a40 6f 77 53 65 74 49 6e 73 65 72 74 28 52 6f 77 53 owSetInsert(RowS
29a50 65 74 2a 2c 20 69 36 34 29 3b 0a 69 6e 74 20 73 et*, i64);.int s
29a60 71 6c 69 74 65 33 52 6f 77 53 65 74 54 65 73 74 qlite3RowSetTest
29a70 28 52 6f 77 53 65 74 2a 2c 20 69 6e 74 20 69 42 (RowSet*, int iB
29a80 61 74 63 68 2c 20 69 36 34 29 3b 0a 69 6e 74 20 atch, i64);.int
29a90 73 71 6c 69 74 65 33 52 6f 77 53 65 74 4e 65 78 sqlite3RowSetNex
29aa0 74 28 52 6f 77 53 65 74 2a 2c 20 69 36 34 2a 29 t(RowSet*, i64*)
29ab0 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 ;..void sqlite3C
29ac0 72 65 61 74 65 56 69 65 77 28 50 61 72 73 65 2a reateView(Parse*
29ad0 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 54 ,Token*,Token*,T
29ae0 6f 6b 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c oken*,ExprList*,
29af0 53 65 6c 65 63 74 2a 2c 69 6e 74 2c 69 6e 74 29 Select*,int,int)
29b00 3b 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 ;..#if !defined(
29b10 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 45 57 SQLITE_OMIT_VIEW
29b20 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28 53 51 ) || !defined(SQ
29b30 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
29b40 4c 54 41 42 4c 45 29 0a 20 20 69 6e 74 20 73 71 LTABLE). int sq
29b50 6c 69 74 65 33 56 69 65 77 47 65 74 43 6f 6c 75 lite3ViewGetColu
29b60 6d 6e 4e 61 6d 65 73 28 50 61 72 73 65 2a 2c 54 mnNames(Parse*,T
29b70 61 62 6c 65 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 able*);.#else.#
29b80 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 69 define sqlite3Vi
29b90 65 77 47 65 74 43 6f 6c 75 6d 6e 4e 61 6d 65 73 ewGetColumnNames
29ba0 28 41 2c 42 29 20 30 0a 23 65 6e 64 69 66 0a 0a (A,B) 0.#endif..
29bb0 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 #if SQLITE_MAX_A
29bc0 54 54 41 43 48 45 44 3e 33 30 0a 20 20 69 6e 74 TTACHED>30. int
29bd0 20 73 71 6c 69 74 65 33 44 62 4d 61 73 6b 41 6c sqlite3DbMaskAl
29be0 6c 5a 65 72 6f 28 79 44 62 4d 61 73 6b 29 3b 0a lZero(yDbMask);.
29bf0 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 #endif.void sqli
29c00 74 65 33 44 72 6f 70 54 61 62 6c 65 28 50 61 72 te3DropTable(Par
29c10 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 69 se*, SrcList*, i
29c20 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
29c30 71 6c 69 74 65 33 43 6f 64 65 44 72 6f 70 54 61 qlite3CodeDropTa
29c40 62 6c 65 28 50 61 72 73 65 2a 2c 20 54 61 62 6c ble(Parse*, Tabl
29c50 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 e*, int, int);.v
29c60 6f 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 74 oid sqlite3Delet
29c70 65 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c eTable(sqlite3*,
29c80 20 54 61 62 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 Table*);.void s
29c90 71 6c 69 74 65 33 46 72 65 65 49 6e 64 65 78 28 qlite3FreeIndex(
29ca0 73 71 6c 69 74 65 33 2a 2c 20 49 6e 64 65 78 2a sqlite3*, Index*
29cb0 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
29cc0 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 43 52 45 E_OMIT_AUTOINCRE
29cd0 4d 45 4e 54 0a 20 20 76 6f 69 64 20 73 71 6c 69 MENT. void sqli
29ce0 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 te3Autoincrement
29cf0 42 65 67 69 6e 28 50 61 72 73 65 20 2a 70 50 61 Begin(Parse *pPa
29d00 72 73 65 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c rse);. void sql
29d10 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e ite3Autoincremen
29d20 74 45 6e 64 28 50 61 72 73 65 20 2a 70 50 61 72 tEnd(Parse *pPar
29d30 73 65 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 se);.#else.# def
29d40 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 6f 69 ine sqlite3Autoi
29d50 6e 63 72 65 6d 65 6e 74 42 65 67 69 6e 28 58 29 ncrementBegin(X)
29d60 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
29d70 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 3AutoincrementEn
29d80 64 28 58 29 0a 23 65 6e 64 69 66 0a 76 6f 69 64 d(X).#endif.void
29d90 20 73 71 6c 69 74 65 33 49 6e 73 65 72 74 28 50 sqlite3Insert(P
29da0 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c arse*, SrcList*,
29db0 20 53 65 6c 65 63 74 2a 2c 20 49 64 4c 69 73 74 Select*, IdList
29dc0 2a 2c 20 69 6e 74 2c 20 55 70 73 65 72 74 2a 29 *, int, Upsert*)
29dd0 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 41 ;.void *sqlite3A
29de0 72 72 61 79 41 6c 6c 6f 63 61 74 65 28 73 71 6c rrayAllocate(sql
29df0 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69 6e 74 2c ite3*,void*,int,
29e00 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a 49 64 4c 69 int*,int*);.IdLi
29e10 73 74 20 2a 73 71 6c 69 74 65 33 49 64 4c 69 73 st *sqlite3IdLis
29e20 74 41 70 70 65 6e 64 28 50 61 72 73 65 2a 2c 20 tAppend(Parse*,
29e30 49 64 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 29 IdList*, Token*)
29e40 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 64 4c ;.int sqlite3IdL
29e50 69 73 74 49 6e 64 65 78 28 49 64 4c 69 73 74 2a istIndex(IdList*
29e60 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 53 ,const char*);.S
29e70 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 53 rcList *sqlite3S
29e80 72 63 4c 69 73 74 45 6e 6c 61 72 67 65 28 73 71 rcListEnlarge(sq
29e90 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 74 2a lite3*, SrcList*
29ea0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 53 72 63 , int, int);.Src
29eb0 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 53 72 63 List *sqlite3Src
29ec0 4c 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 74 ListAppend(sqlit
29ed0 65 33 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 e3*, SrcList*, T
29ee0 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a oken*, Token*);.
29ef0 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 SrcList *sqlite3
29f00 53 72 63 4c 69 73 74 41 70 70 65 6e 64 46 72 6f SrcListAppendFro
29f10 6d 54 65 72 6d 28 50 61 72 73 65 2a 2c 20 53 72 mTerm(Parse*, Sr
29f20 63 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 cList*, Token*,
29f30 54 6f 6b 65 6e 2a 2c 0a 20 20 20 20 20 20 20 20 Token*,.
29f40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29f50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 6f To
29f60 6b 65 6e 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 45 ken*, Select*, E
29f70 78 70 72 2a 2c 20 49 64 4c 69 73 74 2a 29 3b 0a xpr*, IdList*);.
29f80 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c void sqlite3SrcL
29f90 69 73 74 49 6e 64 65 78 65 64 42 79 28 50 61 72 istIndexedBy(Par
29fa0 73 65 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c se *, SrcList *,
29fb0 20 54 6f 6b 65 6e 20 2a 29 3b 0a 76 6f 69 64 20 Token *);.void
29fc0 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 46 75 sqlite3SrcListFu
29fd0 6e 63 41 72 67 73 28 50 61 72 73 65 2a 2c 20 53 ncArgs(Parse*, S
29fe0 72 63 4c 69 73 74 2a 2c 20 45 78 70 72 4c 69 73 rcList*, ExprLis
29ff0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
2a000 49 6e 64 65 78 65 64 42 79 4c 6f 6f 6b 75 70 28 IndexedByLookup(
2a010 50 61 72 73 65 20 2a 2c 20 73 74 72 75 63 74 20 Parse *, struct
2a020 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 29 3b SrcList_item *);
2a030 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 .void sqlite3Src
2a040 4c 69 73 74 53 68 69 66 74 4a 6f 69 6e 54 79 70 ListShiftJoinTyp
2a050 65 28 53 72 63 4c 69 73 74 2a 29 3b 0a 76 6f 69 e(SrcList*);.voi
2a060 64 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 d sqlite3SrcList
2a070 41 73 73 69 67 6e 43 75 72 73 6f 72 73 28 50 61 AssignCursors(Pa
2a080 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b rse*, SrcList*);
2a090 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 49 64 4c .void sqlite3IdL
2a0a0 69 73 74 44 65 6c 65 74 65 28 73 71 6c 69 74 65 istDelete(sqlite
2a0b0 33 2a 2c 20 49 64 4c 69 73 74 2a 29 3b 0a 76 6f 3*, IdList*);.vo
2a0c0 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 id sqlite3SrcLis
2a0d0 74 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a tDelete(sqlite3*
2a0e0 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 49 6e 64 , SrcList*);.Ind
2a0f0 65 78 20 2a 73 71 6c 69 74 65 33 41 6c 6c 6f 63 ex *sqlite3Alloc
2a100 61 74 65 49 6e 64 65 78 4f 62 6a 65 63 74 28 73 ateIndexObject(s
2a110 71 6c 69 74 65 33 2a 2c 69 31 36 2c 69 6e 74 2c qlite3*,i16,int,
2a120 63 68 61 72 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 char**);.void sq
2a130 6c 69 74 65 33 43 72 65 61 74 65 49 6e 64 65 78 lite3CreateIndex
2a140 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 (Parse*,Token*,T
2a150 6f 6b 65 6e 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 oken*,SrcList*,E
2a160 78 70 72 4c 69 73 74 2a 2c 69 6e 74 2c 54 6f 6b xprList*,int,Tok
2a170 65 6e 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 en*,.
2a180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 45 E
2a190 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 xpr*, int, int,
2a1a0 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 u8);.void sqlite
2a1b0 33 44 72 6f 70 49 6e 64 65 78 28 50 61 72 73 65 3DropIndex(Parse
2a1c0 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 69 6e 74 *, SrcList*, int
2a1d0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 65 );.int sqlite3Se
2a1e0 6c 65 63 74 28 50 61 72 73 65 2a 2c 20 53 65 6c lect(Parse*, Sel
2a1f0 65 63 74 2a 2c 20 53 65 6c 65 63 74 44 65 73 74 ect*, SelectDest
2a200 2a 29 3b 0a 53 65 6c 65 63 74 20 2a 73 71 6c 69 *);.Select *sqli
2a210 74 65 33 53 65 6c 65 63 74 4e 65 77 28 50 61 72 te3SelectNew(Par
2a220 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 72 se*,ExprList*,Sr
2a230 63 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 70 cList*,Expr*,Exp
2a240 72 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 20 rList*,.
2a250 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a260 20 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a Expr*,ExprList*
2a270 2c 75 33 32 2c 45 78 70 72 2a 29 3b 0a 76 6f 69 ,u32,Expr*);.voi
2a280 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 d sqlite3SelectD
2a290 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 elete(sqlite3*,
2a2a0 53 65 6c 65 63 74 2a 29 3b 0a 54 61 62 6c 65 20 Select*);.Table
2a2b0 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 4c *sqlite3SrcListL
2a2c0 6f 6f 6b 75 70 28 50 61 72 73 65 2a 2c 20 53 72 ookup(Parse*, Sr
2a2d0 63 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c cList*);.int sql
2a2e0 69 74 65 33 49 73 52 65 61 64 4f 6e 6c 79 28 50 ite3IsReadOnly(P
2a2f0 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 arse*, Table*, i
2a300 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
2a310 33 4f 70 65 6e 54 61 62 6c 65 28 50 61 72 73 65 3OpenTable(Parse
2a320 2a 2c 20 69 6e 74 20 69 43 75 72 2c 20 69 6e 74 *, int iCur, int
2a330 20 69 44 62 2c 20 54 61 62 6c 65 2a 2c 20 69 6e iDb, Table*, in
2a340 74 29 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 t);.#if defined(
2a350 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 50 SQLITE_ENABLE_UP
2a360 44 41 54 45 5f 44 45 4c 45 54 45 5f 4c 49 4d 49 DATE_DELETE_LIMI
2a370 54 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 T) && !defined(S
2a380 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55 QLITE_OMIT_SUBQU
2a390 45 52 59 29 0a 45 78 70 72 20 2a 73 71 6c 69 74 ERY).Expr *sqlit
2a3a0 65 33 4c 69 6d 69 74 57 68 65 72 65 28 50 61 72 e3LimitWhere(Par
2a3b0 73 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 se*,SrcList*,Exp
2a3c0 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 r*,ExprList*,Exp
2a3d0 72 2a 2c 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 r*,char*);.#endi
2a3e0 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 f.void sqlite3De
2a3f0 6c 65 74 65 46 72 6f 6d 28 50 61 72 73 65 2a 2c leteFrom(Parse*,
2a400 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 70 72 2a SrcList*, Expr*
2a410 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 45 78 70 , ExprList*, Exp
2a420 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
2a430 33 55 70 64 61 74 65 28 50 61 72 73 65 2a 2c 20 3Update(Parse*,
2a440 53 72 63 4c 69 73 74 2a 2c 20 45 78 70 72 4c 69 SrcList*, ExprLi
2a450 73 74 2a 2c 45 78 70 72 2a 2c 69 6e 74 2c 45 78 st*,Expr*,int,Ex
2a460 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 0a 20 prList*,Expr*,.
2a470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a480 20 20 55 70 73 65 72 74 2a 29 3b 0a 57 68 65 72 Upsert*);.Wher
2a490 65 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 57 68 eInfo *sqlite3Wh
2a4a0 65 72 65 42 65 67 69 6e 28 50 61 72 73 65 2a 2c ereBegin(Parse*,
2a4b0 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 SrcList*,Expr*,E
2a4c0 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 4c 69 73 xprList*,ExprLis
2a4d0 74 2a 2c 75 31 36 2c 69 6e 74 29 3b 0a 76 6f 69 t*,u16,int);.voi
2a4e0 64 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 6e d sqlite3WhereEn
2a4f0 64 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 4c d(WhereInfo*);.L
2a500 6f 67 45 73 74 20 73 71 6c 69 74 65 33 57 68 65 ogEst sqlite3Whe
2a510 72 65 4f 75 74 70 75 74 52 6f 77 43 6f 75 6e 74 reOutputRowCount
2a520 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e (WhereInfo*);.in
2a530 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 t sqlite3WhereIs
2a540 44 69 73 74 69 6e 63 74 28 57 68 65 72 65 49 6e Distinct(WhereIn
2a550 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 fo*);.int sqlite
2a560 33 57 68 65 72 65 49 73 4f 72 64 65 72 65 64 28 3WhereIsOrdered(
2a570 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 WhereInfo*);.int
2a580 20 73 71 6c 69 74 65 33 57 68 65 72 65 4f 72 64 sqlite3WhereOrd
2a590 65 72 42 79 4c 69 6d 69 74 4f 70 74 4c 61 62 65 erByLimitOptLabe
2a5a0 6c 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 l(WhereInfo*);.i
2a5b0 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 nt sqlite3WhereI
2a5c0 73 53 6f 72 74 65 64 28 57 68 65 72 65 49 6e 66 sSorted(WhereInf
2a5d0 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 o*);.int sqlite3
2a5e0 57 68 65 72 65 43 6f 6e 74 69 6e 75 65 4c 61 62 WhereContinueLab
2a5f0 65 6c 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a el(WhereInfo*);.
2a600 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 int sqlite3Where
2a610 42 72 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 65 BreakLabel(Where
2a620 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Info*);.int sqli
2a630 74 65 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 73 te3WhereOkOnePas
2a640 73 28 57 68 65 72 65 49 6e 66 6f 2a 2c 20 69 6e s(WhereInfo*, in
2a650 74 2a 29 3b 0a 23 64 65 66 69 6e 65 20 4f 4e 45 t*);.#define ONE
2a660 50 41 53 53 5f 4f 46 46 20 20 20 20 20 20 30 20 PASS_OFF 0
2a670 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 6f 66 /* Use of
2a680 20 4f 4e 45 50 41 53 53 20 6e 6f 74 20 61 6c 6c ONEPASS not all
2a690 6f 77 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 owed */.#define
2a6a0 4f 4e 45 50 41 53 53 5f 53 49 4e 47 4c 45 20 20 ONEPASS_SINGLE
2a6b0 20 31 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 1 /* ONE
2a6c0 50 41 53 53 20 76 61 6c 69 64 20 66 6f 72 20 61 PASS valid for a
2a6d0 20 73 69 6e 67 6c 65 20 72 6f 77 20 75 70 64 61 single row upda
2a6e0 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 4e te */.#define ON
2a6f0 45 50 41 53 53 5f 4d 55 4c 54 49 20 20 20 20 32 EPASS_MULTI 2
2a700 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 50 41 /* ONEPA
2a710 53 53 20 69 73 20 76 61 6c 69 64 20 66 6f 72 20 SS is valid for
2a720 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f multiple rows */
2a730 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
2a740 72 43 6f 64 65 4c 6f 61 64 49 6e 64 65 78 43 6f rCodeLoadIndexCo
2a750 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 20 49 6e 64 lumn(Parse*, Ind
2a760 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 ex*, int, int, i
2a770 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
2a780 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 6d ExprCodeGetColum
2a790 6e 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a n(Parse*, Table*
2a7a0 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c , int, int, int,
2a7b0 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u8);.void sqlit
2a7c0 65 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c e3ExprCodeGetCol
2a7d0 75 6d 6e 4f 66 54 61 62 6c 65 28 56 64 62 65 2a umnOfTable(Vdbe*
2a7e0 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 , Table*, int, i
2a7f0 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
2a800 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 4d 6f qlite3ExprCodeMo
2a810 76 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 ve(Parse*, int,
2a820 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
2a830 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 28 sqlite3ExprCode(
2a840 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 Parse*, Expr*, i
2a850 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
2a860 33 45 78 70 72 43 6f 64 65 43 6f 70 79 28 50 61 3ExprCodeCopy(Pa
2a870 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 rse*, Expr*, int
2a880 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
2a890 78 70 72 43 6f 64 65 46 61 63 74 6f 72 61 62 6c xprCodeFactorabl
2a8a0 65 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c e(Parse*, Expr*,
2a8b0 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
2a8c0 65 33 45 78 70 72 43 6f 64 65 41 74 49 6e 69 74 e3ExprCodeAtInit
2a8d0 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 (Parse*, Expr*,
2a8e0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
2a8f0 33 45 78 70 72 43 6f 64 65 54 65 6d 70 28 50 61 3ExprCodeTemp(Pa
2a900 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 rse*, Expr*, int
2a910 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 *);.int sqlite3E
2a920 78 70 72 43 6f 64 65 54 61 72 67 65 74 28 50 61 xprCodeTarget(Pa
2a930 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 rse*, Expr*, int
2a940 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
2a950 78 70 72 43 6f 64 65 41 6e 64 43 61 63 68 65 28 xprCodeAndCache(
2a960 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 Parse*, Expr*, i
2a970 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
2a980 45 78 70 72 43 6f 64 65 45 78 70 72 4c 69 73 74 ExprCodeExprList
2a990 28 50 61 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 (Parse*, ExprLis
2a9a0 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 75 38 t*, int, int, u8
2a9b0 29 3b 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 );.#define SQLIT
2a9c0 45 5f 45 43 45 4c 5f 44 55 50 20 20 20 20 20 20 E_ECEL_DUP
2a9d0 30 78 30 31 20 20 2f 2a 20 44 65 65 70 2c 20 6e 0x01 /* Deep, n
2a9e0 6f 74 20 73 68 61 6c 6c 6f 77 20 63 6f 70 69 65 ot shallow copie
2a9f0 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
2aa00 49 54 45 5f 45 43 45 4c 5f 46 41 43 54 4f 52 20 ITE_ECEL_FACTOR
2aa10 20 20 30 78 30 32 20 20 2f 2a 20 46 61 63 74 6f 0x02 /* Facto
2aa20 72 20 6f 75 74 20 63 6f 6e 73 74 61 6e 74 20 74 r out constant t
2aa30 65 72 6d 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 erms */.#define
2aa40 53 51 4c 49 54 45 5f 45 43 45 4c 5f 52 45 46 20 SQLITE_ECEL_REF
2aa50 20 20 20 20 20 30 78 30 34 20 20 2f 2a 20 55 73 0x04 /* Us
2aa60 65 20 45 78 70 72 4c 69 73 74 2e 75 2e 78 2e 69 e ExprList.u.x.i
2aa70 4f 72 64 65 72 42 79 43 6f 6c 20 2a 2f 0a 23 64 OrderByCol */.#d
2aa80 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 efine SQLITE_ECE
2aa90 4c 5f 4f 4d 49 54 52 45 46 20 20 30 78 30 38 20 L_OMITREF 0x08
2aaa0 20 2f 2a 20 4f 6d 69 74 20 69 66 20 45 78 70 72 /* Omit if Expr
2aab0 4c 69 73 74 2e 75 2e 78 2e 69 4f 72 64 65 72 42 List.u.x.iOrderB
2aac0 79 43 6f 6c 20 2a 2f 0a 76 6f 69 64 20 73 71 6c yCol */.void sql
2aad0 69 74 65 33 45 78 70 72 49 66 54 72 75 65 28 50 ite3ExprIfTrue(P
2aae0 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e arse*, Expr*, in
2aaf0 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t, int);.void sq
2ab00 6c 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 65 lite3ExprIfFalse
2ab10 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 (Parse*, Expr*,
2ab20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
2ab30 73 71 6c 69 74 65 33 45 78 70 72 49 66 46 61 6c sqlite3ExprIfFal
2ab40 73 65 44 75 70 28 50 61 72 73 65 2a 2c 20 45 78 seDup(Parse*, Ex
2ab50 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a pr*, int, int);.
2ab60 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 46 69 Table *sqlite3Fi
2ab70 6e 64 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a ndTable(sqlite3*
2ab80 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f ,const char*, co
2ab90 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 64 65 66 nst char*);.#def
2aba0 69 6e 65 20 4c 4f 43 41 54 45 5f 56 49 45 57 20 ine LOCATE_VIEW
2abb0 20 20 20 30 78 30 31 0a 23 64 65 66 69 6e 65 20 0x01.#define
2abc0 4c 4f 43 41 54 45 5f 4e 4f 45 52 52 20 20 20 30 LOCATE_NOERR 0
2abd0 78 30 32 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 x02.Table *sqlit
2abe0 65 33 4c 6f 63 61 74 65 54 61 62 6c 65 28 50 61 e3LocateTable(Pa
2abf0 72 73 65 2a 2c 75 33 32 20 66 6c 61 67 73 2c 63 rse*,u32 flags,c
2ac00 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 onst char*, cons
2ac10 74 20 63 68 61 72 2a 29 3b 0a 54 61 62 6c 65 20 t char*);.Table
2ac20 2a 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 61 *sqlite3LocateTa
2ac30 62 6c 65 49 74 65 6d 28 50 61 72 73 65 2a 2c 75 bleItem(Parse*,u
2ac40 33 32 20 66 6c 61 67 73 2c 73 74 72 75 63 74 20 32 flags,struct
2ac50 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 29 3b SrcList_item *);
2ac60 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 46 .Index *sqlite3F
2ac70 69 6e 64 49 6e 64 65 78 28 73 71 6c 69 74 65 33 indIndex(sqlite3
2ac80 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 *,const char*, c
2ac90 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 onst char*);.voi
2aca0 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 d sqlite3UnlinkA
2acb0 6e 64 44 65 6c 65 74 65 54 61 62 6c 65 28 73 71 ndDeleteTable(sq
2acc0 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 lite3*,int,const
2acd0 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 char*);.void sq
2ace0 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 lite3UnlinkAndDe
2acf0 6c 65 74 65 49 6e 64 65 78 28 73 71 6c 69 74 65 leteIndex(sqlite
2ad00 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 3*,int,const cha
2ad10 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
2ad20 33 56 61 63 75 75 6d 28 50 61 72 73 65 2a 2c 54 3Vacuum(Parse*,T
2ad30 6f 6b 65 6e 2a 2c 45 78 70 72 2a 29 3b 0a 69 6e oken*,Expr*);.in
2ad40 74 20 73 71 6c 69 74 65 33 52 75 6e 56 61 63 75 t sqlite3RunVacu
2ad50 75 6d 28 63 68 61 72 2a 2a 2c 20 73 71 6c 69 74 um(char**, sqlit
2ad60 65 33 2a 2c 20 69 6e 74 2c 20 73 71 6c 69 74 65 e3*, int, sqlite
2ad70 33 5f 76 61 6c 75 65 2a 29 3b 0a 63 68 61 72 20 3_value*);.char
2ad80 2a 73 71 6c 69 74 65 33 4e 61 6d 65 46 72 6f 6d *sqlite3NameFrom
2ad90 54 6f 6b 65 6e 28 73 71 6c 69 74 65 33 2a 2c 20 Token(sqlite3*,
2ada0 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c Token*);.int sql
2adb0 69 74 65 33 45 78 70 72 43 6f 6d 70 61 72 65 28 ite3ExprCompare(
2adc0 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c 20 45 78 Parse*,Expr*, Ex
2add0 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 pr*, int);.int s
2ade0 71 6c 69 74 65 33 45 78 70 72 43 6f 6d 70 61 72 qlite3ExprCompar
2adf0 65 53 6b 69 70 28 45 78 70 72 2a 2c 20 45 78 70 eSkip(Expr*, Exp
2ae00 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
2ae10 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 6f 6d lite3ExprListCom
2ae20 70 61 72 65 28 45 78 70 72 4c 69 73 74 2a 2c 20 pare(ExprList*,
2ae30 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 3b ExprList*, int);
2ae40 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
2ae50 49 6d 70 6c 69 65 73 45 78 70 72 28 50 61 72 73 ImpliesExpr(Pars
2ae60 65 2a 2c 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c e*,Expr*, Expr*,
2ae70 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
2ae80 65 33 45 78 70 72 49 6d 70 6c 69 65 73 4e 6f 6e e3ExprImpliesNon
2ae90 4e 75 6c 6c 52 6f 77 28 45 78 70 72 2a 2c 69 6e NullRow(Expr*,in
2aea0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
2aeb0 45 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 72 65 ExprAnalyzeAggre
2aec0 67 61 74 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 gates(NameContex
2aed0 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 t*, Expr*);.void
2aee0 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 61 6c sqlite3ExprAnal
2aef0 79 7a 65 41 67 67 4c 69 73 74 28 4e 61 6d 65 43 yzeAggList(NameC
2af00 6f 6e 74 65 78 74 2a 2c 45 78 70 72 4c 69 73 74 ontext*,ExprList
2af10 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 *);.int sqlite3E
2af20 78 70 72 43 6f 76 65 72 65 64 42 79 49 6e 64 65 xprCoveredByInde
2af30 78 28 45 78 70 72 2a 2c 20 69 6e 74 20 69 43 75 x(Expr*, int iCu
2af40 72 2c 20 49 6e 64 65 78 20 2a 70 49 64 78 29 3b r, Index *pIdx);
2af50 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 75 6e 63 .int sqlite3Func
2af60 74 69 6f 6e 55 73 65 73 54 68 69 73 53 72 63 28 tionUsesThisSrc(
2af70 45 78 70 72 2a 2c 20 53 72 63 4c 69 73 74 2a 29 Expr*, SrcList*)
2af80 3b 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33 47 ;.Vdbe *sqlite3G
2af90 65 74 56 64 62 65 28 50 61 72 73 65 2a 29 3b 0a etVdbe(Parse*);.
2afa0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 55 #ifndef SQLITE_U
2afb0 4e 54 45 53 54 41 42 4c 45 0a 76 6f 69 64 20 73 NTESTABLE.void s
2afc0 71 6c 69 74 65 33 50 72 6e 67 53 61 76 65 53 74 qlite3PrngSaveSt
2afd0 61 74 65 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 ate(void);.void
2afe0 73 71 6c 69 74 65 33 50 72 6e 67 52 65 73 74 6f sqlite3PrngResto
2aff0 72 65 53 74 61 74 65 28 76 6f 69 64 29 3b 0a 23 reState(void);.#
2b000 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 endif.void sqlit
2b010 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 e3RollbackAll(sq
2b020 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 lite3*,int);.voi
2b030 64 20 73 71 6c 69 74 65 33 43 6f 64 65 56 65 72 d sqlite3CodeVer
2b040 69 66 79 53 63 68 65 6d 61 28 50 61 72 73 65 2a ifySchema(Parse*
2b050 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
2b060 69 74 65 33 43 6f 64 65 56 65 72 69 66 79 4e 61 ite3CodeVerifyNa
2b070 6d 65 64 53 63 68 65 6d 61 28 50 61 72 73 65 2a medSchema(Parse*
2b080 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 , const char *zD
2b090 62 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 b);.void sqlite3
2b0a0 42 65 67 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e BeginTransaction
2b0b0 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 (Parse*, int);.v
2b0c0 6f 69 64 20 73 71 6c 69 74 65 33 45 6e 64 54 72 oid sqlite3EndTr
2b0d0 61 6e 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a ansaction(Parse*
2b0e0 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
2b0f0 74 65 33 53 61 76 65 70 6f 69 6e 74 28 50 61 72 te3Savepoint(Par
2b100 73 65 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2a se*, int, Token*
2b110 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 );.void sqlite3C
2b120 6c 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 loseSavepoints(s
2b130 71 6c 69 74 65 33 20 2a 29 3b 0a 76 6f 69 64 20 qlite3 *);.void
2b140 73 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65 sqlite3LeaveMute
2b150 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28 xAndCloseZombie(
2b160 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 sqlite3*);.int s
2b170 71 6c 69 74 65 33 45 78 70 72 49 64 54 6f 54 72 qlite3ExprIdToTr
2b180 75 65 46 61 6c 73 65 28 45 78 70 72 2a 29 3b 0a ueFalse(Expr*);.
2b190 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 54 int sqlite3ExprT
2b1a0 72 75 74 68 56 61 6c 75 65 28 63 6f 6e 73 74 20 ruthValue(const
2b1b0 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Expr*);.int sqli
2b1c0 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 6e te3ExprIsConstan
2b1d0 74 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 t(Expr*);.int sq
2b1e0 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 lite3ExprIsConst
2b1f0 61 6e 74 4e 6f 74 4a 6f 69 6e 28 45 78 70 72 2a antNotJoin(Expr*
2b200 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
2b210 70 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 46 75 prIsConstantOrFu
2b220 6e 63 74 69 6f 6e 28 45 78 70 72 2a 2c 20 75 38 nction(Expr*, u8
2b230 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
2b240 70 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 47 72 prIsConstantOrGr
2b250 6f 75 70 42 79 28 50 61 72 73 65 2a 2c 20 45 78 oupBy(Parse*, Ex
2b260 70 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b pr*, ExprList*);
2b270 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
2b280 49 73 54 61 62 6c 65 43 6f 6e 73 74 61 6e 74 28 IsTableConstant(
2b290 45 78 70 72 2a 2c 69 6e 74 29 3b 0a 23 69 66 64 Expr*,int);.#ifd
2b2a0 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
2b2b0 5f 43 55 52 53 4f 52 5f 48 49 4e 54 53 0a 69 6e _CURSOR_HINTS.in
2b2c0 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6e t sqlite3ExprCon
2b2d0 74 61 69 6e 73 53 75 62 71 75 65 72 79 28 45 78 tainsSubquery(Ex
2b2e0 70 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 pr*);.#endif.int
2b2f0 20 73 71 6c 69 74 65 33 45 78 70 72 49 73 49 6e sqlite3ExprIsIn
2b300 74 65 67 65 72 28 45 78 70 72 2a 2c 20 69 6e 74 teger(Expr*, int
2b310 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 *);.int sqlite3E
2b320 78 70 72 43 61 6e 42 65 4e 75 6c 6c 28 63 6f 6e xprCanBeNull(con
2b330 73 74 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 st Expr*);.int s
2b340 71 6c 69 74 65 33 45 78 70 72 4e 65 65 64 73 4e qlite3ExprNeedsN
2b350 6f 41 66 66 69 6e 69 74 79 43 68 61 6e 67 65 28 oAffinityChange(
2b360 63 6f 6e 73 74 20 45 78 70 72 2a 2c 20 63 68 61 const Expr*, cha
2b370 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 r);.int sqlite3I
2b380 73 52 6f 77 69 64 28 63 6f 6e 73 74 20 63 68 61 sRowid(const cha
2b390 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
2b3a0 33 47 65 6e 65 72 61 74 65 52 6f 77 44 65 6c 65 3GenerateRowDele
2b3b0 74 65 28 0a 20 20 20 20 50 61 72 73 65 2a 2c 54 te(. Parse*,T
2b3c0 61 62 6c 65 2a 2c 54 72 69 67 67 65 72 2a 2c 69 able*,Trigger*,i
2b3d0 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 31 36 2c 75 nt,int,int,i16,u
2b3e0 38 2c 75 38 2c 75 38 2c 69 6e 74 29 3b 0a 76 6f 8,u8,u8,int);.vo
2b3f0 69 64 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 id sqlite3Genera
2b400 74 65 52 6f 77 49 6e 64 65 78 44 65 6c 65 74 65 teRowIndexDelete
2b410 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
2b420 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c int, int, int*,
2b430 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
2b440 65 33 47 65 6e 65 72 61 74 65 49 6e 64 65 78 4b e3GenerateIndexK
2b450 65 79 28 50 61 72 73 65 2a 2c 20 49 6e 64 65 78 ey(Parse*, Index
2b460 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 *, int, int, int
2b470 2c 20 69 6e 74 2a 2c 49 6e 64 65 78 2a 2c 69 6e , int*,Index*,in
2b480 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
2b490 52 65 73 6f 6c 76 65 50 61 72 74 49 64 78 4c 61 ResolvePartIdxLa
2b4a0 62 65 6c 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b bel(Parse*,int);
2b4b0 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
2b4c0 52 65 66 65 72 65 6e 63 65 73 55 70 64 61 74 65 ReferencesUpdate
2b4d0 64 43 6f 6c 75 6d 6e 28 45 78 70 72 2a 2c 69 6e dColumn(Expr*,in
2b4e0 74 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t*,int);.void sq
2b4f0 6c 69 74 65 33 47 65 6e 65 72 61 74 65 43 6f 6e lite3GenerateCon
2b500 73 74 72 61 69 6e 74 43 68 65 63 6b 73 28 50 61 straintChecks(Pa
2b510 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 69 6e 74 2a rse*,Table*,int*
2b520 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 ,int,int,int,int
2b530 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
2b540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b550 20 20 20 20 20 20 20 75 38 2c 75 38 2c 69 6e 74 u8,u8,int
2b560 2c 69 6e 74 2a 2c 69 6e 74 2a 2c 55 70 73 65 72 ,int*,int*,Upser
2b570 74 2a 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 t*);.#ifdef SQLI
2b580 54 45 5f 45 4e 41 42 4c 45 5f 4e 55 4c 4c 5f 54 TE_ENABLE_NULL_T
2b590 52 49 4d 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 RIM. void sqlit
2b5a0 65 33 53 65 74 4d 61 6b 65 52 65 63 6f 72 64 50 e3SetMakeRecordP
2b5b0 35 28 56 64 62 65 2a 2c 54 61 62 6c 65 2a 29 3b 5(Vdbe*,Table*);
2b5c0 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
2b5d0 73 71 6c 69 74 65 33 53 65 74 4d 61 6b 65 52 65 sqlite3SetMakeRe
2b5e0 63 6f 72 64 50 35 28 41 2c 42 29 0a 23 65 6e 64 cordP5(A,B).#end
2b5f0 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 if.void sqlite3C
2b600 6f 6d 70 6c 65 74 65 49 6e 73 65 72 74 69 6f 6e ompleteInsertion
2b610 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 69 (Parse*,Table*,i
2b620 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2a 2c nt,int,int,int*,
2b630 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a 69 6e int,int,int);.in
2b640 74 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 61 62 t sqlite3OpenTab
2b650 6c 65 41 6e 64 49 6e 64 69 63 65 73 28 50 61 72 leAndIndices(Par
2b660 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 se*, Table*, int
2b670 2c 20 75 38 2c 20 69 6e 74 2c 20 75 38 2a 2c 20 , u8, int, u8*,
2b680 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 76 6f 69 int*, int*);.voi
2b690 64 20 73 71 6c 69 74 65 33 42 65 67 69 6e 57 72 d sqlite3BeginWr
2b6a0 69 74 65 4f 70 65 72 61 74 69 6f 6e 28 50 61 72 iteOperation(Par
2b6b0 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a se*, int, int);.
2b6c0 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 75 6c 74 void sqlite3Mult
2b6d0 69 57 72 69 74 65 28 50 61 72 73 65 2a 29 3b 0a iWrite(Parse*);.
2b6e0 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 79 41 void sqlite3MayA
2b6f0 62 6f 72 74 28 50 61 72 73 65 2a 29 3b 0a 76 6f bort(Parse*);.vo
2b700 69 64 20 73 71 6c 69 74 65 33 48 61 6c 74 43 6f id sqlite3HaltCo
2b710 6e 73 74 72 61 69 6e 74 28 50 61 72 73 65 2a 2c nstraint(Parse*,
2b720 20 69 6e 74 2c 20 69 6e 74 2c 20 63 68 61 72 2a int, int, char*
2b730 2c 20 69 38 2c 20 75 38 29 3b 0a 76 6f 69 64 20 , i8, u8);.void
2b740 73 71 6c 69 74 65 33 55 6e 69 71 75 65 43 6f 6e sqlite3UniqueCon
2b750 73 74 72 61 69 6e 74 28 50 61 72 73 65 2a 2c 20 straint(Parse*,
2b760 69 6e 74 2c 20 49 6e 64 65 78 2a 29 3b 0a 76 6f int, Index*);.vo
2b770 69 64 20 73 71 6c 69 74 65 33 52 6f 77 69 64 43 id sqlite3RowidC
2b780 6f 6e 73 74 72 61 69 6e 74 28 50 61 72 73 65 2a onstraint(Parse*
2b790 2c 20 69 6e 74 2c 20 54 61 62 6c 65 2a 29 3b 0a , int, Table*);.
2b7a0 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
2b7b0 72 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 45 78 rDup(sqlite3*,Ex
2b7c0 70 72 2a 2c 69 6e 74 29 3b 0a 45 78 70 72 4c 69 pr*,int);.ExprLi
2b7d0 73 74 20 2a 73 71 6c 69 74 65 33 45 78 70 72 4c st *sqlite3ExprL
2b7e0 69 73 74 44 75 70 28 73 71 6c 69 74 65 33 2a 2c istDup(sqlite3*,
2b7f0 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 29 3b 0a ExprList*,int);.
2b800 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 SrcList *sqlite3
2b810 53 72 63 4c 69 73 74 44 75 70 28 73 71 6c 69 74 SrcListDup(sqlit
2b820 65 33 2a 2c 53 72 63 4c 69 73 74 2a 2c 69 6e 74 e3*,SrcList*,int
2b830 29 3b 0a 49 64 4c 69 73 74 20 2a 73 71 6c 69 74 );.IdList *sqlit
2b840 65 33 49 64 4c 69 73 74 44 75 70 28 73 71 6c 69 e3IdListDup(sqli
2b850 74 65 33 2a 2c 49 64 4c 69 73 74 2a 29 3b 0a 53 te3*,IdList*);.S
2b860 65 6c 65 63 74 20 2a 73 71 6c 69 74 65 33 53 65 elect *sqlite3Se
2b870 6c 65 63 74 44 75 70 28 73 71 6c 69 74 65 33 2a lectDup(sqlite3*
2b880 2c 53 65 6c 65 63 74 2a 2c 69 6e 74 29 3b 0a 46 ,Select*,int);.F
2b890 75 6e 63 44 65 66 20 2a 73 71 6c 69 74 65 33 46 uncDef *sqlite3F
2b8a0 75 6e 63 74 69 6f 6e 53 65 61 72 63 68 28 69 6e unctionSearch(in
2b8b0 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a t,const char*);.
2b8c0 76 6f 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 void sqlite3Inse
2b8d0 72 74 42 75 69 6c 74 69 6e 46 75 6e 63 73 28 46 rtBuiltinFuncs(F
2b8e0 75 6e 63 44 65 66 2a 2c 69 6e 74 29 3b 0a 46 75 uncDef*,int);.Fu
2b8f0 6e 63 44 65 66 20 2a 73 71 6c 69 74 65 33 46 69 ncDef *sqlite3Fi
2b900 6e 64 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 ndFunction(sqlit
2b910 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c e3*,const char*,
2b920 69 6e 74 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 int,u8,u8);.void
2b930 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 sqlite3Register
2b940 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 BuiltinFunctions
2b950 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c (void);.void sql
2b960 69 74 65 33 52 65 67 69 73 74 65 72 44 61 74 65 ite3RegisterDate
2b970 54 69 6d 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f TimeFunctions(vo
2b980 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 id);.void sqlite
2b990 33 52 65 67 69 73 74 65 72 50 65 72 43 6f 6e 6e 3RegisterPerConn
2b9a0 65 63 74 69 6f 6e 42 75 69 6c 74 69 6e 46 75 6e ectionBuiltinFun
2b9b0 63 74 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 ctions(sqlite3*)
2b9c0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 61 66 ;.int sqlite3Saf
2b9d0 65 74 79 43 68 65 63 6b 4f 6b 28 73 71 6c 69 74 etyCheckOk(sqlit
2b9e0 65 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 e3*);.int sqlite
2b9f0 33 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 3SafetyCheckSick
2ba00 4f 72 4f 6b 28 73 71 6c 69 74 65 33 2a 29 3b 0a OrOk(sqlite3*);.
2ba10 76 6f 69 64 20 73 71 6c 69 74 65 33 43 68 61 6e void sqlite3Chan
2ba20 67 65 43 6f 6f 6b 69 65 28 50 61 72 73 65 2a 2c geCookie(Parse*,
2ba30 20 69 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 int);..#if !def
2ba40 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
2ba50 5f 56 49 45 57 29 20 26 26 20 21 64 65 66 69 6e _VIEW) && !defin
2ba60 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 ed(SQLITE_OMIT_T
2ba70 52 49 47 47 45 52 29 0a 76 6f 69 64 20 73 71 6c RIGGER).void sql
2ba80 69 74 65 33 4d 61 74 65 72 69 61 6c 69 7a 65 56 ite3MaterializeV
2ba90 69 65 77 28 50 61 72 73 65 2a 2c 20 54 61 62 6c iew(Parse*, Tabl
2baa0 65 2a 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 4c e*, Expr*, ExprL
2bab0 69 73 74 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b ist*,Expr*,int);
2bac0 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 .#endif..#ifndef
2bad0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 SQLITE_OMIT_TRI
2bae0 47 47 45 52 0a 20 20 76 6f 69 64 20 73 71 6c 69 GGER. void sqli
2baf0 74 65 33 42 65 67 69 6e 54 72 69 67 67 65 72 28 te3BeginTrigger(
2bb00 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 54 Parse*, Token*,T
2bb10 6f 6b 65 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 49 64 oken*,int,int,Id
2bb20 4c 69 73 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 0a List*,SrcList*,.
2bb30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bb40 20 20 20 20 20 20 20 20 20 20 20 45 78 70 72 2a Expr*
2bb50 2c 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 76 6f ,int, int);. vo
2bb60 69 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 id sqlite3Finish
2bb70 54 72 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 Trigger(Parse*,
2bb80 54 72 69 67 67 65 72 53 74 65 70 2a 2c 20 54 6f TriggerStep*, To
2bb90 6b 65 6e 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 ken*);. void sq
2bba0 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 lite3DropTrigger
2bbb0 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 (Parse*, SrcList
2bbc0 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 *, int);. void
2bbd0 73 71 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 sqlite3DropTrigg
2bbe0 65 72 50 74 72 28 50 61 72 73 65 2a 2c 20 54 72 erPtr(Parse*, Tr
2bbf0 69 67 67 65 72 2a 29 3b 0a 20 20 54 72 69 67 67 igger*);. Trigg
2bc00 65 72 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 er *sqlite3Trigg
2bc10 65 72 73 45 78 69 73 74 28 50 61 72 73 65 20 2a ersExist(Parse *
2bc20 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 45 , Table*, int, E
2bc30 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 20 2a 70 xprList*, int *p
2bc40 4d 61 73 6b 29 3b 0a 20 20 54 72 69 67 67 65 72 Mask);. Trigger
2bc50 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 *sqlite3Trigger
2bc60 4c 69 73 74 28 50 61 72 73 65 20 2a 2c 20 54 61 List(Parse *, Ta
2bc70 62 6c 65 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 ble *);. void s
2bc80 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 qlite3CodeRowTri
2bc90 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 72 69 gger(Parse*, Tri
2bca0 67 67 65 72 20 2a 2c 20 69 6e 74 2c 20 45 78 70 gger *, int, Exp
2bcb0 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 54 61 62 rList*, int, Tab
2bcc0 6c 65 20 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 le *,.
2bcd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bce0 20 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 int, int, int)
2bcf0 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
2bd00 43 6f 64 65 52 6f 77 54 72 69 67 67 65 72 44 69 CodeRowTriggerDi
2bd10 72 65 63 74 28 50 61 72 73 65 20 2a 2c 20 54 72 rect(Parse *, Tr
2bd20 69 67 67 65 72 20 2a 2c 20 54 61 62 6c 65 20 2a igger *, Table *
2bd30 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 , int, int, int)
2bd40 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 56 ;. void sqliteV
2bd50 69 65 77 54 72 69 67 67 65 72 73 28 50 61 72 73 iewTriggers(Pars
2bd60 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 e*, Table*, Expr
2bd70 2a 2c 20 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 *, int, ExprList
2bd80 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 *);. void sqlit
2bd90 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 53 e3DeleteTriggerS
2bda0 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 tep(sqlite3*, Tr
2bdb0 69 67 67 65 72 53 74 65 70 2a 29 3b 0a 20 20 54 iggerStep*);. T
2bdc0 72 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 riggerStep *sqli
2bdd0 74 65 33 54 72 69 67 67 65 72 53 65 6c 65 63 74 te3TriggerSelect
2bde0 53 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 Step(sqlite3*,Se
2bdf0 6c 65 63 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 lect*,.
2be00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2be10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 c
2be20 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 onst char*,const
2be30 20 63 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 char*);. Trigg
2be40 65 72 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 erStep *sqlite3T
2be50 72 69 67 67 65 72 49 6e 73 65 72 74 53 74 65 70 riggerInsertStep
2be60 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 20 (Parse*,Token*,
2be70 49 64 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 IdList*,.
2be80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2be90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bea0 20 53 65 6c 65 63 74 2a 2c 75 38 2c 55 70 73 65 Select*,u8,Upse
2beb0 72 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 rt*,.
2bec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bed0 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
2bee0 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 st char*,const c
2bef0 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 har*);. Trigger
2bf00 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 Step *sqlite3Tri
2bf10 67 67 65 72 55 70 64 61 74 65 53 74 65 70 28 50 ggerUpdateStep(P
2bf20 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 45 78 70 arse*,Token*,Exp
2bf30 72 4c 69 73 74 2a 2c 20 45 78 70 72 2a 2c 20 75 rList*, Expr*, u
2bf40 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 8,.
2bf50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bf60 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 const
2bf70 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 char*,const cha
2bf80 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 r*);. TriggerSt
2bf90 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 ep *sqlite3Trigg
2bfa0 65 72 44 65 6c 65 74 65 53 74 65 70 28 50 61 72 erDeleteStep(Par
2bfb0 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 20 45 78 70 72 se*,Token*, Expr
2bfc0 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 *,.
2bfd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2bfe0 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 const
2bff0 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 char*,const cha
2c000 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 r*);. void sqli
2c010 74 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 te3DeleteTrigger
2c020 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 67 67 (sqlite3*, Trigg
2c030 65 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c er*);. void sql
2c040 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c ite3UnlinkAndDel
2c050 65 74 65 54 72 69 67 67 65 72 28 73 71 6c 69 74 eteTrigger(sqlit
2c060 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 e3*,int,const ch
2c070 61 72 2a 29 3b 0a 20 20 75 33 32 20 73 71 6c 69 ar*);. u32 sqli
2c080 74 65 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 73 te3TriggerColmas
2c090 6b 28 50 61 72 73 65 2a 2c 54 72 69 67 67 65 72 k(Parse*,Trigger
2c0a0 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 2c *,ExprList*,int,
2c0b0 69 6e 74 2c 54 61 62 6c 65 2a 2c 69 6e 74 29 3b int,Table*,int);
2c0c0 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2c0d0 33 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 3ParseToplevel(p
2c0e0 29 20 28 28 70 29 2d 3e 70 54 6f 70 6c 65 76 65 ) ((p)->pTopleve
2c0f0 6c 20 3f 20 28 70 29 2d 3e 70 54 6f 70 6c 65 76 l ? (p)->pToplev
2c100 65 6c 20 3a 20 28 70 29 29 0a 23 20 64 65 66 69 el : (p)).# defi
2c110 6e 65 20 73 71 6c 69 74 65 33 49 73 54 6f 70 6c ne sqlite3IsTopl
2c120 65 76 65 6c 28 70 29 20 28 28 70 29 2d 3e 70 54 evel(p) ((p)->pT
2c130 6f 70 6c 65 76 65 6c 3d 3d 30 29 0a 23 65 6c 73 oplevel==0).#els
2c140 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 e.# define sqlit
2c150 65 33 54 72 69 67 67 65 72 73 45 78 69 73 74 28 e3TriggersExist(
2c160 42 2c 43 2c 44 2c 45 2c 46 29 20 30 0a 23 20 64 B,C,D,E,F) 0.# d
2c170 65 66 69 6e 65 20 73 71 6c 69 74 65 33 44 65 6c efine sqlite3Del
2c180 65 74 65 54 72 69 67 67 65 72 28 41 2c 42 29 0a eteTrigger(A,B).
2c190 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
2c1a0 44 72 6f 70 54 72 69 67 67 65 72 50 74 72 28 41 DropTriggerPtr(A
2c1b0 2c 42 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ,B).# define sql
2c1c0 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c ite3UnlinkAndDel
2c1d0 65 74 65 54 72 69 67 67 65 72 28 41 2c 42 2c 43 eteTrigger(A,B,C
2c1e0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
2c1f0 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 65 72 e3CodeRowTrigger
2c200 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 2c 47 2c 48 (A,B,C,D,E,F,G,H
2c210 2c 49 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ,I).# define sql
2c220 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 ite3CodeRowTrigg
2c230 65 72 44 69 72 65 63 74 28 41 2c 42 2c 43 2c 44 erDirect(A,B,C,D
2c240 2c 45 2c 46 29 0a 23 20 64 65 66 69 6e 65 20 73 ,E,F).# define s
2c250 71 6c 69 74 65 33 54 72 69 67 67 65 72 4c 69 73 qlite3TriggerLis
2c260 74 28 58 2c 20 59 29 20 30 0a 23 20 64 65 66 69 t(X, Y) 0.# defi
2c270 6e 65 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 ne sqlite3ParseT
2c280 6f 70 6c 65 76 65 6c 28 70 29 20 70 0a 23 20 64 oplevel(p) p.# d
2c290 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 54 efine sqlite3IsT
2c2a0 6f 70 6c 65 76 65 6c 28 70 29 20 31 0a 23 20 64 oplevel(p) 1.# d
2c2b0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 72 69 efine sqlite3Tri
2c2c0 67 67 65 72 43 6f 6c 6d 61 73 6b 28 41 2c 42 2c ggerColmask(A,B,
2c2d0 43 2c 44 2c 45 2c 46 2c 47 29 20 30 0a 23 65 6e C,D,E,F,G) 0.#en
2c2e0 64 69 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 dif..int sqlite3
2c2f0 4a 6f 69 6e 54 79 70 65 28 50 61 72 73 65 2a 2c JoinType(Parse*,
2c300 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c Token*, Token*,
2c310 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 Token*);.void s
2c320 71 6c 69 74 65 33 43 72 65 61 74 65 46 6f 72 65 qlite3CreateFore
2c330 69 67 6e 4b 65 79 28 50 61 72 73 65 2a 2c 20 45 ignKey(Parse*, E
2c340 78 70 72 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a xprList*, Token*
2c350 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 , ExprList*, int
2c360 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 );.void sqlite3D
2c370 65 66 65 72 46 6f 72 65 69 67 6e 4b 65 79 28 50 eferForeignKey(P
2c380 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 23 69 66 arse*, int);.#if
2c390 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2c3a0 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 _AUTHORIZATION.
2c3b0 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 void sqlite3Aut
2c3c0 68 52 65 61 64 28 50 61 72 73 65 2a 2c 45 78 70 hRead(Parse*,Exp
2c3d0 72 2a 2c 53 63 68 65 6d 61 2a 2c 53 72 63 4c 69 r*,Schema*,SrcLi
2c3e0 73 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 st*);. int sqli
2c3f0 74 65 33 41 75 74 68 43 68 65 63 6b 28 50 61 72 te3AuthCheck(Par
2c400 73 65 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 63 se*,int, const c
2c410 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 har*, const char
2c420 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b *, const char*);
2c430 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 . void sqlite3A
2c440 75 74 68 43 6f 6e 74 65 78 74 50 75 73 68 28 50 uthContextPush(P
2c450 61 72 73 65 2a 2c 20 41 75 74 68 43 6f 6e 74 65 arse*, AuthConte
2c460 78 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a xt*, const char*
2c470 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
2c480 33 41 75 74 68 43 6f 6e 74 65 78 74 50 6f 70 28 3AuthContextPop(
2c490 41 75 74 68 43 6f 6e 74 65 78 74 2a 29 3b 0a 20 AuthContext*);.
2c4a0 20 69 6e 74 20 73 71 6c 69 74 65 33 41 75 74 68 int sqlite3Auth
2c4b0 52 65 61 64 43 6f 6c 28 50 61 72 73 65 2a 2c 20 ReadCol(Parse*,
2c4c0 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 63 6f const char *, co
2c4d0 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 6e 74 29 nst char *, int)
2c4e0 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ;.#else.# define
2c4f0 20 73 71 6c 69 74 65 33 41 75 74 68 52 65 61 64 sqlite3AuthRead
2c500 28 61 2c 62 2c 63 2c 64 29 0a 23 20 64 65 66 69 (a,b,c,d).# defi
2c510 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 43 68 ne sqlite3AuthCh
2c520 65 63 6b 28 61 2c 62 2c 63 2c 64 2c 65 29 20 20 eck(a,b,c,d,e)
2c530 20 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 64 65 SQLITE_OK.# de
2c540 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 fine sqlite3Auth
2c550 43 6f 6e 74 65 78 74 50 75 73 68 28 61 2c 62 2c ContextPush(a,b,
2c560 63 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 c).# define sqli
2c570 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 50 6f te3AuthContextPo
2c580 70 28 61 29 20 20 28 28 76 6f 69 64 29 28 61 29 p(a) ((void)(a)
2c590 29 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 ).#endif.void sq
2c5a0 6c 69 74 65 33 41 74 74 61 63 68 28 50 61 72 73 lite3Attach(Pars
2c5b0 65 2a 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a e*, Expr*, Expr*
2c5c0 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 , Expr*);.void s
2c5d0 71 6c 69 74 65 33 44 65 74 61 63 68 28 50 61 72 qlite3Detach(Par
2c5e0 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 se*, Expr*);.voi
2c5f0 64 20 73 71 6c 69 74 65 33 46 69 78 49 6e 69 74 d sqlite3FixInit
2c600 28 44 62 46 69 78 65 72 2a 2c 20 50 61 72 73 65 (DbFixer*, Parse
2c610 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 *, int, const ch
2c620 61 72 2a 2c 20 63 6f 6e 73 74 20 54 6f 6b 65 6e ar*, const Token
2c630 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 *);.int sqlite3F
2c640 69 78 53 72 63 4c 69 73 74 28 44 62 46 69 78 65 ixSrcList(DbFixe
2c650 72 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 69 r*, SrcList*);.i
2c660 6e 74 20 73 71 6c 69 74 65 33 46 69 78 53 65 6c nt sqlite3FixSel
2c670 65 63 74 28 44 62 46 69 78 65 72 2a 2c 20 53 65 ect(DbFixer*, Se
2c680 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 lect*);.int sqli
2c690 74 65 33 46 69 78 45 78 70 72 28 44 62 46 69 78 te3FixExpr(DbFix
2c6a0 65 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 69 6e 74 er*, Expr*);.int
2c6b0 20 73 71 6c 69 74 65 33 46 69 78 45 78 70 72 4c sqlite3FixExprL
2c6c0 69 73 74 28 44 62 46 69 78 65 72 2a 2c 20 45 78 ist(DbFixer*, Ex
2c6d0 70 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 prList*);.int sq
2c6e0 6c 69 74 65 33 46 69 78 54 72 69 67 67 65 72 53 lite3FixTriggerS
2c6f0 74 65 70 28 44 62 46 69 78 65 72 2a 2c 20 54 72 tep(DbFixer*, Tr
2c700 69 67 67 65 72 53 74 65 70 2a 29 3b 0a 69 6e 74 iggerStep*);.int
2c710 20 73 71 6c 69 74 65 33 41 74 6f 46 28 63 6f 6e sqlite3AtoF(con
2c720 73 74 20 63 68 61 72 20 2a 7a 2c 20 64 6f 75 62 st char *z, doub
2c730 6c 65 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 le*, int, u8);.i
2c740 6e 74 20 73 71 6c 69 74 65 33 47 65 74 49 6e 74 nt sqlite3GetInt
2c750 33 32 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 32(const char *,
2c760 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 int*);.int sqli
2c770 74 65 33 41 74 6f 69 28 63 6f 6e 73 74 20 63 68 te3Atoi(const ch
2c780 61 72 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 ar*);.#ifndef SQ
2c790 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a LITE_OMIT_UTF16.
2c7a0 69 6e 74 20 73 71 6c 69 74 65 33 55 74 66 31 36 int sqlite3Utf16
2c7b0 42 79 74 65 4c 65 6e 28 63 6f 6e 73 74 20 76 6f ByteLen(const vo
2c7c0 69 64 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e id *pData, int n
2c7d0 43 68 61 72 29 3b 0a 23 65 6e 64 69 66 0a 69 6e Char);.#endif.in
2c7e0 74 20 73 71 6c 69 74 65 33 55 74 66 38 43 68 61 t sqlite3Utf8Cha
2c7f0 72 4c 65 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 rLen(const char
2c800 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e 42 79 74 *pData, int nByt
2c810 65 29 3b 0a 75 33 32 20 73 71 6c 69 74 65 33 55 e);.u32 sqlite3U
2c820 74 66 38 52 65 61 64 28 63 6f 6e 73 74 20 75 38 tf8Read(const u8
2c830 2a 2a 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 **);.LogEst sqli
2c840 74 65 33 4c 6f 67 45 73 74 28 75 36 34 29 3b 0a te3LogEst(u64);.
2c850 4c 6f 67 45 73 74 20 73 71 6c 69 74 65 33 4c 6f LogEst sqlite3Lo
2c860 67 45 73 74 41 64 64 28 4c 6f 67 45 73 74 2c 4c gEstAdd(LogEst,L
2c870 6f 67 45 73 74 29 3b 0a 23 69 66 6e 64 65 66 20 ogEst);.#ifndef
2c880 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
2c890 55 41 4c 54 41 42 4c 45 0a 4c 6f 67 45 73 74 20 UALTABLE.LogEst
2c8a0 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 46 72 6f sqlite3LogEstFro
2c8b0 6d 44 6f 75 62 6c 65 28 64 6f 75 62 6c 65 29 3b mDouble(double);
2c8c0 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 .#endif.#if defi
2c8d0 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
2c8e0 45 5f 53 54 4d 54 5f 53 43 41 4e 53 54 41 54 55 E_STMT_SCANSTATU
2c8f0 53 29 20 7c 7c 20 5c 0a 20 20 20 20 64 65 66 69 S) || \. defi
2c900 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
2c910 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 E_STAT3_OR_STAT4
2c920 29 20 7c 7c 20 5c 0a 20 20 20 20 64 65 66 69 6e ) || \. defin
2c930 65 64 28 53 51 4c 49 54 45 5f 45 58 50 4c 41 49 ed(SQLITE_EXPLAI
2c940 4e 5f 45 53 54 49 4d 41 54 45 44 5f 52 4f 57 53 N_ESTIMATED_ROWS
2c950 29 0a 75 36 34 20 73 71 6c 69 74 65 33 4c 6f 67 ).u64 sqlite3Log
2c960 45 73 74 54 6f 49 6e 74 28 4c 6f 67 45 73 74 29 EstToInt(LogEst)
2c970 3b 0a 23 65 6e 64 69 66 0a 56 4c 69 73 74 20 2a ;.#endif.VList *
2c980 73 71 6c 69 74 65 33 56 4c 69 73 74 41 64 64 28 sqlite3VListAdd(
2c990 73 71 6c 69 74 65 33 2a 2c 56 4c 69 73 74 2a 2c sqlite3*,VList*,
2c9a0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 2c const char*,int,
2c9b0 69 6e 74 29 3b 0a 63 6f 6e 73 74 20 63 68 61 72 int);.const char
2c9c0 20 2a 73 71 6c 69 74 65 33 56 4c 69 73 74 4e 75 *sqlite3VListNu
2c9d0 6d 54 6f 4e 61 6d 65 28 56 4c 69 73 74 2a 2c 69 mToName(VList*,i
2c9e0 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
2c9f0 56 4c 69 73 74 4e 61 6d 65 54 6f 4e 75 6d 28 56 VListNameToNum(V
2ca00 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 List*,const char
2ca10 2a 2c 69 6e 74 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 *,int);../*.** R
2ca20 6f 75 74 69 6e 65 73 20 74 6f 20 72 65 61 64 20 outines to read
2ca30 61 6e 64 20 77 72 69 74 65 20 76 61 72 69 61 62 and write variab
2ca40 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 le-length intege
2ca50 72 73 2e 20 20 54 68 65 73 65 20 75 73 65 64 20 rs. These used
2ca60 74 6f 0a 2a 2a 20 62 65 20 64 65 66 69 6e 65 64 to.** be defined
2ca70 20 6c 6f 63 61 6c 6c 79 2c 20 62 75 74 20 6e 6f locally, but no
2ca80 77 20 77 65 20 75 73 65 20 74 68 65 20 76 61 72 w we use the var
2ca90 69 6e 74 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 int routines in
2caa0 74 68 65 20 75 74 69 6c 2e 63 0a 2a 2a 20 66 69 the util.c.** fi
2cab0 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 le..*/.int sqlit
2cac0 65 33 50 75 74 56 61 72 69 6e 74 28 75 6e 73 69 e3PutVarint(unsi
2cad0 67 6e 65 64 20 63 68 61 72 2a 2c 20 75 36 34 29 gned char*, u64)
2cae0 3b 0a 75 38 20 73 71 6c 69 74 65 33 47 65 74 56 ;.u8 sqlite3GetV
2caf0 61 72 69 6e 74 28 63 6f 6e 73 74 20 75 6e 73 69 arint(const unsi
2cb00 67 6e 65 64 20 63 68 61 72 20 2a 2c 20 75 36 34 gned char *, u64
2cb10 20 2a 29 3b 0a 75 38 20 73 71 6c 69 74 65 33 47 *);.u8 sqlite3G
2cb20 65 74 56 61 72 69 6e 74 33 32 28 63 6f 6e 73 74 etVarint32(const
2cb30 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
2cb40 2c 20 75 33 32 20 2a 29 3b 0a 69 6e 74 20 73 71 , u32 *);.int sq
2cb50 6c 69 74 65 33 56 61 72 69 6e 74 4c 65 6e 28 75 lite3VarintLen(u
2cb60 36 34 20 76 29 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 64 v);../*.** Th
2cb70 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 69 73 e common case is
2cb80 20 66 6f 72 20 61 20 76 61 72 69 6e 74 20 74 6f for a varint to
2cb90 20 62 65 20 61 20 73 69 6e 67 6c 65 20 62 79 74 be a single byt
2cba0 65 2e 20 20 54 68 65 79 20 66 6f 6c 6c 6f 77 69 e. They followi
2cbb0 6e 67 0a 2a 2a 20 6d 61 63 72 6f 73 20 68 61 6e ng.** macros han
2cbc0 64 6c 65 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 dle the common c
2cbd0 61 73 65 20 77 69 74 68 6f 75 74 20 61 20 70 72 ase without a pr
2cbe0 6f 63 65 64 75 72 65 20 63 61 6c 6c 2c 20 62 75 ocedure call, bu
2cbf0 74 20 74 68 65 6e 20 63 61 6c 6c 0a 2a 2a 20 74 t then call.** t
2cc00 68 65 20 70 72 6f 63 65 64 75 72 65 20 66 6f 72 he procedure for
2cc10 20 6c 61 72 67 65 72 20 76 61 72 69 6e 74 73 2e larger varints.
2cc20 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 67 65 74 56 .*/.#define getV
2cc30 61 72 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a arint32(A,B) \.
2cc40 20 20 28 75 38 29 28 28 2a 28 41 29 3c 28 75 38 (u8)((*(A)<(u8
2cc50 29 30 78 38 30 29 3f 28 28 42 29 3d 28 75 33 32 )0x80)?((B)=(u32
2cc60 29 2a 28 41 29 29 2c 31 3a 73 71 6c 69 74 65 33 )*(A)),1:sqlite3
2cc70 47 65 74 56 61 72 69 6e 74 33 32 28 28 41 29 2c GetVarint32((A),
2cc80 28 75 33 32 20 2a 29 26 28 42 29 29 29 0a 23 64 (u32 *)&(B))).#d
2cc90 65 66 69 6e 65 20 70 75 74 56 61 72 69 6e 74 33 efine putVarint3
2cca0 32 28 41 2c 42 29 20 20 5c 0a 20 20 28 75 38 29 2(A,B) \. (u8)
2ccb0 28 28 28 75 33 32 29 28 42 29 3c 28 75 33 32 29 (((u32)(B)<(u32)
2ccc0 30 78 38 30 29 3f 28 2a 28 41 29 3d 28 75 6e 73 0x80)?(*(A)=(uns
2ccd0 69 67 6e 65 64 20 63 68 61 72 29 28 42 29 29 2c igned char)(B)),
2cce0 31 3a 5c 0a 20 20 73 71 6c 69 74 65 33 50 75 74 1:\. sqlite3Put
2ccf0 56 61 72 69 6e 74 28 28 41 29 2c 28 42 29 29 29 Varint((A),(B)))
2cd00 0a 23 64 65 66 69 6e 65 20 67 65 74 56 61 72 69 .#define getVari
2cd10 6e 74 20 20 20 20 73 71 6c 69 74 65 33 47 65 74 nt sqlite3Get
2cd20 56 61 72 69 6e 74 0a 23 64 65 66 69 6e 65 20 70 Varint.#define p
2cd30 75 74 56 61 72 69 6e 74 20 20 20 20 73 71 6c 69 utVarint sqli
2cd40 74 65 33 50 75 74 56 61 72 69 6e 74 0a 0a 0a 63 te3PutVarint...c
2cd50 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
2cd60 65 33 49 6e 64 65 78 41 66 66 69 6e 69 74 79 53 e3IndexAffinityS
2cd70 74 72 28 73 71 6c 69 74 65 33 2a 2c 20 49 6e 64 tr(sqlite3*, Ind
2cd80 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ex*);.void sqlit
2cd90 65 33 54 61 62 6c 65 41 66 66 69 6e 69 74 79 28 e3TableAffinity(
2cda0 56 64 62 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 Vdbe*, Table*, i
2cdb0 6e 74 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 65 nt);.char sqlite
2cdc0 33 43 6f 6d 70 61 72 65 41 66 66 69 6e 69 74 79 3CompareAffinity
2cdd0 28 45 78 70 72 20 2a 70 45 78 70 72 2c 20 63 68 (Expr *pExpr, ch
2cde0 61 72 20 61 66 66 32 29 3b 0a 69 6e 74 20 73 71 ar aff2);.int sq
2cdf0 6c 69 74 65 33 49 6e 64 65 78 41 66 66 69 6e 69 lite3IndexAffini
2ce00 74 79 4f 6b 28 45 78 70 72 20 2a 70 45 78 70 72 tyOk(Expr *pExpr
2ce10 2c 20 63 68 61 72 20 69 64 78 5f 61 66 66 69 6e , char idx_affin
2ce20 69 74 79 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 ity);.char sqlit
2ce30 65 33 54 61 62 6c 65 43 6f 6c 75 6d 6e 41 66 66 e3TableColumnAff
2ce40 69 6e 69 74 79 28 54 61 62 6c 65 2a 2c 69 6e 74 inity(Table*,int
2ce50 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 65 33 45 );.char sqlite3E
2ce60 78 70 72 41 66 66 69 6e 69 74 79 28 45 78 70 72 xprAffinity(Expr
2ce70 20 2a 70 45 78 70 72 29 3b 0a 69 6e 74 20 73 71 *pExpr);.int sq
2ce80 6c 69 74 65 33 41 74 6f 69 36 34 28 63 6f 6e 73 lite3Atoi64(cons
2ce90 74 20 63 68 61 72 2a 2c 20 69 36 34 2a 2c 20 69 t char*, i64*, i
2cea0 6e 74 2c 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c nt, u8);.int sql
2ceb0 69 74 65 33 44 65 63 4f 72 48 65 78 54 6f 49 36 ite3DecOrHexToI6
2cec0 34 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 4(const char*, i
2ced0 36 34 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 64*);.void sqlit
2cee0 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 73 e3ErrorWithMsg(s
2cef0 71 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 6f qlite3*, int, co
2cf00 6e 73 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a nst char*,...);.
2cf10 76 6f 69 64 20 73 71 6c 69 74 65 33 45 72 72 6f void sqlite3Erro
2cf20 72 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 29 3b r(sqlite3*,int);
2cf30 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 79 73 .void sqlite3Sys
2cf40 74 65 6d 45 72 72 6f 72 28 73 71 6c 69 74 65 33 temError(sqlite3
2cf50 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 *,int);.void *sq
2cf60 6c 69 74 65 33 48 65 78 54 6f 42 6c 6f 62 28 73 lite3HexToBlob(s
2cf70 71 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 qlite3*, const c
2cf80 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 3b 0a har *z, int n);.
2cf90 75 38 20 73 71 6c 69 74 65 33 48 65 78 54 6f 49 u8 sqlite3HexToI
2cfa0 6e 74 28 69 6e 74 20 68 29 3b 0a 69 6e 74 20 73 nt(int h);.int s
2cfb0 71 6c 69 74 65 33 54 77 6f 50 61 72 74 4e 61 6d qlite3TwoPartNam
2cfc0 65 28 50 61 72 73 65 20 2a 2c 20 54 6f 6b 65 6e e(Parse *, Token
2cfd0 20 2a 2c 20 54 6f 6b 65 6e 20 2a 2c 20 54 6f 6b *, Token *, Tok
2cfe0 65 6e 20 2a 2a 29 3b 0a 0a 23 69 66 20 64 65 66 en **);..#if def
2cff0 69 6e 65 64 28 53 51 4c 49 54 45 5f 4e 45 45 44 ined(SQLITE_NEED
2d000 5f 45 52 52 5f 4e 41 4d 45 29 0a 63 6f 6e 73 74 _ERR_NAME).const
2d010 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 char *sqlite3Er
2d020 72 4e 61 6d 65 28 69 6e 74 29 3b 0a 23 65 6e 64 rName(int);.#end
2d030 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
2d040 45 5f 45 4e 41 42 4c 45 5f 44 45 53 45 52 49 41 E_ENABLE_DESERIA
2d050 4c 49 5a 45 0a 69 6e 74 20 73 71 6c 69 74 65 33 LIZE.int sqlite3
2d060 4d 65 6d 64 62 49 6e 69 74 28 76 6f 69 64 29 3b MemdbInit(void);
2d070 0a 23 65 6e 64 69 66 0a 0a 63 6f 6e 73 74 20 63 .#endif..const c
2d080 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 har *sqlite3ErrS
2d090 74 72 28 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c tr(int);.int sql
2d0a0 69 74 65 33 52 65 61 64 53 63 68 65 6d 61 28 50 ite3ReadSchema(P
2d0b0 61 72 73 65 20 2a 70 50 61 72 73 65 29 3b 0a 43 arse *pParse);.C
2d0c0 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 46 ollSeq *sqlite3F
2d0d0 69 6e 64 43 6f 6c 6c 53 65 71 28 73 71 6c 69 74 indCollSeq(sqlit
2d0e0 65 33 2a 2c 75 38 20 65 6e 63 2c 20 63 6f 6e 73 e3*,u8 enc, cons
2d0f0 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 69 6e t char*,int);.in
2d100 74 20 73 71 6c 69 74 65 33 49 73 42 69 6e 61 72 t sqlite3IsBinar
2d110 79 28 63 6f 6e 73 74 20 43 6f 6c 6c 53 65 71 2a y(const CollSeq*
2d120 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
2d130 74 65 33 4c 6f 63 61 74 65 43 6f 6c 6c 53 65 71 te3LocateCollSeq
2d140 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 (Parse *pParse,
2d150 63 6f 6e 73 74 20 63 68 61 72 2a 7a 4e 61 6d 65 const char*zName
2d160 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
2d170 74 65 33 45 78 70 72 43 6f 6c 6c 53 65 71 28 50 te3ExprCollSeq(P
2d180 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 45 78 arse *pParse, Ex
2d190 70 72 20 2a 70 45 78 70 72 29 3b 0a 43 6f 6c 6c pr *pExpr);.Coll
2d1a0 53 65 71 20 2a 73 71 6c 69 74 65 33 45 78 70 72 Seq *sqlite3Expr
2d1b0 4e 4e 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 NNCollSeq(Parse
2d1c0 2a 70 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 *pParse, Expr *p
2d1d0 45 78 70 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 Expr);.int sqlit
2d1e0 65 33 45 78 70 72 43 6f 6c 6c 53 65 71 4d 61 74 e3ExprCollSeqMat
2d1f0 63 68 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c ch(Parse*,Expr*,
2d200 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 Expr*);.Expr *sq
2d210 6c 69 74 65 33 45 78 70 72 41 64 64 43 6f 6c 6c lite3ExprAddColl
2d220 61 74 65 54 6f 6b 65 6e 28 50 61 72 73 65 20 2a ateToken(Parse *
2d230 70 50 61 72 73 65 2c 20 45 78 70 72 2a 2c 20 63 pParse, Expr*, c
2d240 6f 6e 73 74 20 54 6f 6b 65 6e 2a 2c 20 69 6e 74 onst Token*, int
2d250 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 );.Expr *sqlite3
2d260 45 78 70 72 41 64 64 43 6f 6c 6c 61 74 65 53 74 ExprAddCollateSt
2d270 72 69 6e 67 28 50 61 72 73 65 2a 2c 45 78 70 72 ring(Parse*,Expr
2d280 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a *,const char*);.
2d290 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
2d2a0 72 53 6b 69 70 43 6f 6c 6c 61 74 65 28 45 78 70 rSkipCollate(Exp
2d2b0 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
2d2c0 43 68 65 63 6b 43 6f 6c 6c 53 65 71 28 50 61 72 CheckCollSeq(Par
2d2d0 73 65 20 2a 2c 20 43 6f 6c 6c 53 65 71 20 2a 29 se *, CollSeq *)
2d2e0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 72 69 ;.int sqlite3Wri
2d2f0 74 61 62 6c 65 53 63 68 65 6d 61 28 73 71 6c 69 tableSchema(sqli
2d300 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 te3*);.int sqlit
2d310 65 33 43 68 65 63 6b 4f 62 6a 65 63 74 4e 61 6d e3CheckObjectNam
2d320 65 28 50 61 72 73 65 20 2a 2c 20 63 6f 6e 73 74 e(Parse *, const
2d330 20 63 68 61 72 20 2a 29 3b 0a 76 6f 69 64 20 73 char *);.void s
2d340 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61 qlite3VdbeSetCha
2d350 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 2c 20 nges(sqlite3 *,
2d360 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
2d370 33 41 64 64 49 6e 74 36 34 28 69 36 34 2a 2c 69 3AddInt64(i64*,i
2d380 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 64);.int sqlite3
2d390 53 75 62 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 SubInt64(i64*,i6
2d3a0 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 4);.int sqlite3M
2d3b0 75 6c 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 ulInt64(i64*,i64
2d3c0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 62 );.int sqlite3Ab
2d3d0 73 49 6e 74 33 32 28 69 6e 74 29 3b 0a 23 69 66 sInt32(int);.#if
2d3e0 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
2d3f0 45 5f 38 5f 33 5f 4e 41 4d 45 53 0a 76 6f 69 64 E_8_3_NAMES.void
2d400 20 73 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 sqlite3FileSuff
2d410 69 78 33 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c ix3(const char*,
2d420 20 63 68 61 72 2a 29 3b 0a 23 65 6c 73 65 0a 23 char*);.#else.#
2d430 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 define sqlite3F
2d440 69 6c 65 53 75 66 66 69 78 33 28 58 2c 59 29 0a ileSuffix3(X,Y).
2d450 23 65 6e 64 69 66 0a 75 38 20 73 71 6c 69 74 65 #endif.u8 sqlite
2d460 33 47 65 74 42 6f 6f 6c 65 61 6e 28 63 6f 6e 73 3GetBoolean(cons
2d470 74 20 63 68 61 72 20 2a 7a 2c 75 38 29 3b 0a 0a t char *z,u8);..
2d480 63 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 const void *sqli
2d490 74 65 33 56 61 6c 75 65 54 65 78 74 28 73 71 6c te3ValueText(sql
2d4a0 69 74 65 33 5f 76 61 6c 75 65 2a 2c 20 75 38 29 ite3_value*, u8)
2d4b0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 61 6c ;.int sqlite3Val
2d4c0 75 65 42 79 74 65 73 28 73 71 6c 69 74 65 33 5f ueBytes(sqlite3_
2d4d0 76 61 6c 75 65 2a 2c 20 75 38 29 3b 0a 76 6f 69 value*, u8);.voi
2d4e0 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 d sqlite3ValueSe
2d4f0 74 53 74 72 28 73 71 6c 69 74 65 33 5f 76 61 6c tStr(sqlite3_val
2d500 75 65 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 ue*, int, const
2d510 76 6f 69 64 20 2a 2c 75 38 2c 0a 20 20 20 20 20 void *,u8,.
2d520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d530 20 20 20 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a void(*)(void*
2d540 29 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 ));.void sqlite3
2d550 56 61 6c 75 65 53 65 74 4e 75 6c 6c 28 73 71 6c ValueSetNull(sql
2d560 69 74 65 33 5f 76 61 6c 75 65 2a 29 3b 0a 76 6f ite3_value*);.vo
2d570 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 id sqlite3ValueF
2d580 72 65 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 ree(sqlite3_valu
2d590 65 2a 29 3b 0a 73 71 6c 69 74 65 33 5f 76 61 6c e*);.sqlite3_val
2d5a0 75 65 20 2a 73 71 6c 69 74 65 33 56 61 6c 75 65 ue *sqlite3Value
2d5b0 4e 65 77 28 73 71 6c 69 74 65 33 20 2a 29 3b 0a New(sqlite3 *);.
2d5c0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
2d5d0 4d 49 54 5f 55 54 46 31 36 0a 63 68 61 72 20 2a MIT_UTF16.char *
2d5e0 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f 38 28 sqlite3Utf16to8(
2d5f0 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 sqlite3 *, const
2d600 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 75 38 29 void*, int, u8)
2d610 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c ;.#endif.int sql
2d620 69 74 65 33 56 61 6c 75 65 46 72 6f 6d 45 78 70 ite3ValueFromExp
2d630 72 28 73 71 6c 69 74 65 33 20 2a 2c 20 45 78 70 r(sqlite3 *, Exp
2d640 72 20 2a 2c 20 75 38 2c 20 75 38 2c 20 73 71 6c r *, u8, u8, sql
2d650 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 3b 0a ite3_value **);.
2d660 76 6f 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 void sqlite3Valu
2d670 65 41 70 70 6c 79 41 66 66 69 6e 69 74 79 28 73 eApplyAffinity(s
2d680 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2c 20 qlite3_value *,
2d690 75 38 2c 20 75 38 29 3b 0a 23 69 66 6e 64 65 66 u8, u8);.#ifndef
2d6a0 20 53 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 SQLITE_AMALGAMA
2d6b0 54 49 4f 4e 0a 65 78 74 65 72 6e 20 63 6f 6e 73 TION.extern cons
2d6c0 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 t unsigned char
2d6d0 73 71 6c 69 74 65 33 4f 70 63 6f 64 65 50 72 6f sqlite3OpcodePro
2d6e0 70 65 72 74 79 5b 5d 3b 0a 65 78 74 65 72 6e 20 perty[];.extern
2d6f0 63 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 const char sqlit
2d700 65 33 53 74 72 42 49 4e 41 52 59 5b 5d 3b 0a 65 e3StrBINARY[];.e
2d710 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e 73 69 xtern const unsi
2d720 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 74 65 gned char sqlite
2d730 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 5b 5d 3b 3UpperToLower[];
2d740 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e .extern const un
2d750 73 69 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 signed char sqli
2d760 74 65 33 43 74 79 70 65 4d 61 70 5b 5d 3b 0a 65 te3CtypeMap[];.e
2d770 78 74 65 72 6e 20 63 6f 6e 73 74 20 54 6f 6b 65 xtern const Toke
2d780 6e 20 73 71 6c 69 74 65 33 49 6e 74 54 6f 6b 65 n sqlite3IntToke
2d790 6e 73 5b 5d 3b 0a 65 78 74 65 72 6e 20 53 51 4c ns[];.extern SQL
2d7a0 49 54 45 5f 57 53 44 20 73 74 72 75 63 74 20 53 ITE_WSD struct S
2d7b0 71 6c 69 74 65 33 43 6f 6e 66 69 67 20 73 71 6c qlite3Config sql
2d7c0 69 74 65 33 43 6f 6e 66 69 67 3b 0a 65 78 74 65 ite3Config;.exte
2d7d0 72 6e 20 46 75 6e 63 44 65 66 48 61 73 68 20 73 rn FuncDefHash s
2d7e0 71 6c 69 74 65 33 42 75 69 6c 74 69 6e 46 75 6e qlite3BuiltinFun
2d7f0 63 74 69 6f 6e 73 3b 0a 23 69 66 6e 64 65 66 20 ctions;.#ifndef
2d800 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a SQLITE_OMIT_WSD.
2d810 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 extern int sqlit
2d820 65 33 50 65 6e 64 69 6e 67 42 79 74 65 3b 0a 23 e3PendingByte;.#
2d830 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 23 69 66 endif.#endif.#if
2d840 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 def VDBE_PROFILE
2d850 0a 65 78 74 65 72 6e 20 73 71 6c 69 74 65 33 5f .extern sqlite3_
2d860 75 69 6e 74 36 34 20 73 71 6c 69 74 65 33 4e 50 uint64 sqlite3NP
2d870 72 6f 66 69 6c 65 43 6e 74 3b 0a 23 65 6e 64 69 rofileCnt;.#endi
2d880 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f f.void sqlite3Ro
2d890 6f 74 50 61 67 65 4d 6f 76 65 64 28 73 71 6c 69 otPageMoved(sqli
2d8a0 74 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 te3*, int, int,
2d8b0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
2d8c0 65 33 52 65 69 6e 64 65 78 28 50 61 72 73 65 2a e3Reindex(Parse*
2d8d0 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a , Token*, Token*
2d8e0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
2d8f0 6c 74 65 72 46 75 6e 63 74 69 6f 6e 73 28 76 6f lterFunctions(vo
2d900 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 id);.void sqlite
2d910 33 41 6c 74 65 72 52 65 6e 61 6d 65 54 61 62 6c 3AlterRenameTabl
2d920 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 e(Parse*, SrcLis
2d930 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 t*, Token*);.voi
2d940 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 52 65 d sqlite3AlterRe
2d950 6e 61 6d 65 43 6f 6c 75 6d 6e 28 50 61 72 73 65 nameColumn(Parse
2d960 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b *, SrcList*, Tok
2d970 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e en*, Token*);.in
2d980 74 20 73 71 6c 69 74 65 33 47 65 74 54 6f 6b 65 t sqlite3GetToke
2d990 6e 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 n(const unsigned
2d9a0 20 63 68 61 72 20 2a 2c 20 69 6e 74 20 2a 29 3b char *, int *);
2d9b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4e 65 73 .void sqlite3Nes
2d9c0 74 65 64 50 61 72 73 65 28 50 61 72 73 65 2a 2c tedParse(Parse*,
2d9d0 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e const char*, ..
2d9e0 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .);.void sqlite3
2d9f0 45 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 ExpirePreparedSt
2da00 61 74 65 6d 65 6e 74 73 28 73 71 6c 69 74 65 33 atements(sqlite3
2da10 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
2da20 6c 69 74 65 33 43 6f 64 65 52 68 73 4f 66 49 4e lite3CodeRhsOfIN
2da30 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 (Parse*, Expr*,
2da40 69 6e 74 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 int, int);.int s
2da50 71 6c 69 74 65 33 43 6f 64 65 53 75 62 73 65 6c qlite3CodeSubsel
2da60 65 63 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 ect(Parse*, Expr
2da70 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2da80 53 65 6c 65 63 74 50 72 65 70 28 50 61 72 73 65 SelectPrep(Parse
2da90 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 4e 61 6d 65 *, Select*, Name
2daa0 43 6f 6e 74 65 78 74 2a 29 3b 0a 76 6f 69 64 20 Context*);.void
2dab0 73 71 6c 69 74 65 33 53 65 6c 65 63 74 57 72 6f sqlite3SelectWro
2dac0 6e 67 4e 75 6d 54 65 72 6d 73 45 72 72 6f 72 28 ngNumTermsError(
2dad0 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 53 Parse *pParse, S
2dae0 65 6c 65 63 74 20 2a 70 29 3b 0a 69 6e 74 20 73 elect *p);.int s
2daf0 71 6c 69 74 65 33 4d 61 74 63 68 53 70 61 6e 4e qlite3MatchSpanN
2db00 61 6d 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c ame(const char*,
2db10 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f const char*, co
2db20 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 nst char*, const
2db30 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c char*);.int sql
2db40 69 74 65 33 52 65 73 6f 6c 76 65 45 78 70 72 4e ite3ResolveExprN
2db50 61 6d 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 74 ames(NameContext
2db60 2a 2c 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 *, Expr*);.int s
2db70 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 45 78 70 qlite3ResolveExp
2db80 72 4c 69 73 74 4e 61 6d 65 73 28 4e 61 6d 65 43 rListNames(NameC
2db90 6f 6e 74 65 78 74 2a 2c 20 45 78 70 72 4c 69 73 ontext*, ExprLis
2dba0 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
2dbb0 33 52 65 73 6f 6c 76 65 53 65 6c 65 63 74 4e 61 3ResolveSelectNa
2dbc0 6d 65 73 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 mes(Parse*, Sele
2dbd0 63 74 2a 2c 20 4e 61 6d 65 43 6f 6e 74 65 78 74 ct*, NameContext
2dbe0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2dbf0 52 65 73 6f 6c 76 65 53 65 6c 66 52 65 66 65 72 ResolveSelfRefer
2dc00 65 6e 63 65 28 50 61 72 73 65 2a 2c 54 61 62 6c ence(Parse*,Tabl
2dc10 65 2a 2c 69 6e 74 2c 45 78 70 72 2a 2c 45 78 70 e*,int,Expr*,Exp
2dc20 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c rList*);.int sql
2dc30 69 74 65 33 52 65 73 6f 6c 76 65 4f 72 64 65 72 ite3ResolveOrder
2dc40 47 72 6f 75 70 42 79 28 50 61 72 73 65 2a 2c 20 GroupBy(Parse*,
2dc50 53 65 6c 65 63 74 2a 2c 20 45 78 70 72 4c 69 73 Select*, ExprLis
2dc60 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 t*, const char*)
2dc70 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f ;.void sqlite3Co
2dc80 6c 75 6d 6e 44 65 66 61 75 6c 74 28 56 64 62 65 lumnDefault(Vdbe
2dc90 20 2a 2c 20 54 61 62 6c 65 20 2a 2c 20 69 6e 74 *, Table *, int
2dca0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
2dcb0 69 74 65 33 41 6c 74 65 72 46 69 6e 69 73 68 41 ite3AlterFinishA
2dcc0 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 20 2a ddColumn(Parse *
2dcd0 2c 20 54 6f 6b 65 6e 20 2a 29 3b 0a 76 6f 69 64 , Token *);.void
2dce0 20 73 71 6c 69 74 65 33 41 6c 74 65 72 42 65 67 sqlite3AlterBeg
2dcf0 69 6e 41 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 inAddColumn(Pars
2dd00 65 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a 29 3b e *, SrcList *);
2dd10 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 52 65 .void *sqlite3Re
2dd20 6e 61 6d 65 54 6f 6b 65 6e 4d 61 70 28 50 61 72 nameTokenMap(Par
2dd30 73 65 2a 2c 20 76 6f 69 64 2a 2c 20 54 6f 6b 65 se*, void*, Toke
2dd40 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 n*);.void sqlite
2dd50 33 52 65 6e 61 6d 65 54 6f 6b 65 6e 52 65 6d 61 3RenameTokenRema
2dd60 70 28 50 61 72 73 65 2a 2c 20 76 6f 69 64 20 2a p(Parse*, void *
2dd70 70 54 6f 2c 20 76 6f 69 64 20 2a 70 46 72 6f 6d pTo, void *pFrom
2dd80 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
2dd90 65 6e 61 6d 65 45 78 70 72 55 6e 6d 61 70 28 50 enameExprUnmap(P
2dda0 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 arse*, Expr*);.v
2ddb0 6f 69 64 20 73 71 6c 69 74 65 33 52 65 6e 61 6d oid sqlite3Renam
2ddc0 65 45 78 70 72 6c 69 73 74 55 6e 6d 61 70 28 50 eExprlistUnmap(P
2ddd0 61 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a arse*, ExprList*
2dde0 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
2ddf0 74 65 33 47 65 74 43 6f 6c 6c 53 65 71 28 50 61 te3GetCollSeq(Pa
2de00 72 73 65 2a 2c 20 75 38 2c 20 43 6f 6c 6c 53 65 rse*, u8, CollSe
2de10 71 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a q *, const char*
2de20 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 65 33 41 );.char sqlite3A
2de30 66 66 69 6e 69 74 79 54 79 70 65 28 63 6f 6e 73 ffinityType(cons
2de40 74 20 63 68 61 72 2a 2c 20 43 6f 6c 75 6d 6e 2a t char*, Column*
2de50 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
2de60 6e 61 6c 79 7a 65 28 50 61 72 73 65 2a 2c 20 54 nalyze(Parse*, T
2de70 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a oken*, Token*);.
2de80 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b int sqlite3Invok
2de90 65 42 75 73 79 48 61 6e 64 6c 65 72 28 42 75 73 eBusyHandler(Bus
2dea0 79 48 61 6e 64 6c 65 72 2a 2c 20 73 71 6c 69 74 yHandler*, sqlit
2deb0 65 33 5f 66 69 6c 65 2a 29 3b 0a 69 6e 74 20 73 e3_file*);.int s
2dec0 71 6c 69 74 65 33 46 69 6e 64 44 62 28 73 71 6c qlite3FindDb(sql
2ded0 69 74 65 33 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a ite3*, Token*);.
2dee0 69 6e 74 20 73 71 6c 69 74 65 33 46 69 6e 64 44 int sqlite3FindD
2def0 62 4e 61 6d 65 28 73 71 6c 69 74 65 33 20 2a 2c bName(sqlite3 *,
2df00 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a const char *);.
2df10 69 6e 74 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 int sqlite3Analy
2df20 73 69 73 4c 6f 61 64 28 73 71 6c 69 74 65 33 2a sisLoad(sqlite3*
2df30 2c 69 6e 74 20 69 44 42 29 3b 0a 76 6f 69 64 20 ,int iDB);.void
2df40 73 71 6c 69 74 65 33 44 65 6c 65 74 65 49 6e 64 sqlite3DeleteInd
2df50 65 78 53 61 6d 70 6c 65 73 28 73 71 6c 69 74 65 exSamples(sqlite
2df60 33 2a 2c 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 3*,Index*);.void
2df70 20 73 71 6c 69 74 65 33 44 65 66 61 75 6c 74 52 sqlite3DefaultR
2df80 6f 77 45 73 74 28 49 6e 64 65 78 2a 29 3b 0a 76 owEst(Index*);.v
2df90 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 73 oid sqlite3Regis
2dfa0 74 65 72 4c 69 6b 65 46 75 6e 63 74 69 6f 6e 73 terLikeFunctions
2dfb0 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 29 3b (sqlite3*, int);
2dfc0 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 73 4c 69 .int sqlite3IsLi
2dfd0 6b 65 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 keFunction(sqlit
2dfe0 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 2a 2c 63 e3*,Expr*,int*,c
2dff0 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 har*);.void sqli
2e000 74 65 33 53 63 68 65 6d 61 43 6c 65 61 72 28 76 te3SchemaClear(v
2e010 6f 69 64 20 2a 29 3b 0a 53 63 68 65 6d 61 20 2a oid *);.Schema *
2e020 73 71 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74 sqlite3SchemaGet
2e030 28 73 71 6c 69 74 65 33 20 2a 2c 20 42 74 72 65 (sqlite3 *, Btre
2e040 65 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 e *);.int sqlite
2e050 33 53 63 68 65 6d 61 54 6f 49 6e 64 65 78 28 73 3SchemaToIndex(s
2e060 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 63 68 65 qlite3 *db, Sche
2e070 6d 61 20 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a ma *);.KeyInfo *
2e080 73 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 41 6c sqlite3KeyInfoAl
2e090 6c 6f 63 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 loc(sqlite3*,int
2e0a0 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
2e0b0 74 65 33 4b 65 79 49 6e 66 6f 55 6e 72 65 66 28 te3KeyInfoUnref(
2e0c0 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b 65 79 49 6e KeyInfo*);.KeyIn
2e0d0 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 6e fo *sqlite3KeyIn
2e0e0 66 6f 52 65 66 28 4b 65 79 49 6e 66 6f 2a 29 3b foRef(KeyInfo*);
2e0f0 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 65 .KeyInfo *sqlite
2e100 33 4b 65 79 49 6e 66 6f 4f 66 49 6e 64 65 78 28 3KeyInfoOfIndex(
2e110 50 61 72 73 65 2a 2c 20 49 6e 64 65 78 2a 29 3b Parse*, Index*);
2e120 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 65 .KeyInfo *sqlite
2e130 33 4b 65 79 49 6e 66 6f 46 72 6f 6d 45 78 70 72 3KeyInfoFromExpr
2e140 4c 69 73 74 28 50 61 72 73 65 2a 2c 20 45 78 70 List(Parse*, Exp
2e150 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 rList*, int, int
2e160 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 );..#ifdef SQLIT
2e170 45 5f 44 45 42 55 47 0a 69 6e 74 20 73 71 6c 69 E_DEBUG.int sqli
2e180 74 65 33 4b 65 79 49 6e 66 6f 49 73 57 72 69 74 te3KeyInfoIsWrit
2e190 65 61 62 6c 65 28 4b 65 79 49 6e 66 6f 2a 29 3b eable(KeyInfo*);
2e1a0 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 .#endif.int sqli
2e1b0 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 73 71 te3CreateFunc(sq
2e1c0 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 20 63 lite3 *, const c
2e1d0 68 61 72 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c har *, int, int,
2e1e0 20 76 6f 69 64 20 2a 2c 0a 20 20 76 6f 69 64 20 void *,. void
2e1f0 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 (*)(sqlite3_cont
2e200 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
2e210 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f _value **),. vo
2e220 69 64 20 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 id (*)(sqlite3_c
2e230 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
2e240 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 20 0a te3_value **), .
2e250 20 20 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 74 void (*)(sqlit
2e260 65 33 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 e3_context*),.
2e270 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 74 65 33 void (*)(sqlite3
2e280 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 76 6f _context*),. vo
2e290 69 64 20 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 id (*)(sqlite3_c
2e2a0 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
2e2b0 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 20 0a te3_value **), .
2e2c0 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 FuncDestructor
2e2d0 20 2a 70 44 65 73 74 72 75 63 74 6f 72 0a 29 3b *pDestructor.);
2e2e0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4e 6f 6f .void sqlite3Noo
2e2f0 70 44 65 73 74 72 75 63 74 6f 72 28 76 6f 69 64 pDestructor(void
2e300 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2e310 4f 6f 6d 46 61 75 6c 74 28 73 71 6c 69 74 65 33 OomFault(sqlite3
2e320 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2e330 4f 6f 6d 43 6c 65 61 72 28 73 71 6c 69 74 65 33 OomClear(sqlite3
2e340 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 *);.int sqlite3A
2e350 70 69 45 78 69 74 28 73 71 6c 69 74 65 33 20 2a piExit(sqlite3 *
2e360 64 62 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 db, int);.int sq
2e370 6c 69 74 65 33 4f 70 65 6e 54 65 6d 70 44 61 74 lite3OpenTempDat
2e380 61 62 61 73 65 28 50 61 72 73 65 20 2a 29 3b 0a abase(Parse *);.
2e390 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 72 .void sqlite3Str
2e3a0 41 63 63 75 6d 49 6e 69 74 28 53 74 72 41 63 63 AccumInit(StrAcc
2e3b0 75 6d 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 63 um*, sqlite3*, c
2e3c0 68 61 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b har*, int, int);
2e3d0 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 53 74 .char *sqlite3St
2e3e0 72 41 63 63 75 6d 46 69 6e 69 73 68 28 53 74 72 rAccumFinish(Str
2e3f0 41 63 63 75 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 Accum*);.void sq
2e400 6c 69 74 65 33 53 65 6c 65 63 74 44 65 73 74 49 lite3SelectDestI
2e410 6e 69 74 28 53 65 6c 65 63 74 44 65 73 74 2a 2c nit(SelectDest*,
2e420 69 6e 74 2c 69 6e 74 29 3b 0a 45 78 70 72 20 2a int,int);.Expr *
2e430 73 71 6c 69 74 65 33 43 72 65 61 74 65 43 6f 6c sqlite3CreateCol
2e440 75 6d 6e 45 78 70 72 28 73 71 6c 69 74 65 33 20 umnExpr(sqlite3
2e450 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 69 6e *, SrcList *, in
2e460 74 2c 20 69 6e 74 29 3b 0a 0a 76 6f 69 64 20 73 t, int);..void s
2e470 71 6c 69 74 65 33 42 61 63 6b 75 70 52 65 73 74 qlite3BackupRest
2e480 61 72 74 28 73 71 6c 69 74 65 33 5f 62 61 63 6b art(sqlite3_back
2e490 75 70 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 up *);.void sqli
2e4a0 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 65 28 te3BackupUpdate(
2e4b0 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a sqlite3_backup *
2e4c0 2c 20 50 67 6e 6f 2c 20 63 6f 6e 73 74 20 75 38 , Pgno, const u8
2e4d0 20 2a 29 3b 0a 0a 23 69 66 6e 64 65 66 20 53 51 *);..#ifndef SQ
2e4e0 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55 45 LITE_OMIT_SUBQUE
2e4f0 52 59 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 RY.int sqlite3Ex
2e500 70 72 43 68 65 63 6b 49 4e 28 50 61 72 73 65 2a prCheckIN(Parse*
2e510 2c 20 45 78 70 72 2a 29 3b 0a 23 65 6c 73 65 0a , Expr*);.#else.
2e520 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
2e530 45 78 70 72 43 68 65 63 6b 49 4e 28 78 2c 79 29 ExprCheckIN(x,y)
2e540 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 SQLITE_OK.#endi
2e550 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
2e560 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
2e570 5f 53 54 41 54 34 0a 76 6f 69 64 20 73 71 6c 69 _STAT4.void sqli
2e580 74 65 33 41 6e 61 6c 79 7a 65 46 75 6e 63 74 69 te3AnalyzeFuncti
2e590 6f 6e 73 28 76 6f 69 64 29 3b 0a 69 6e 74 20 73 ons(void);.int s
2e5a0 71 6c 69 74 65 33 53 74 61 74 34 50 72 6f 62 65 qlite3Stat4Probe
2e5b0 53 65 74 56 61 6c 75 65 28 0a 20 20 20 20 50 61 SetValue(. Pa
2e5c0 72 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 6e 70 61 rse*,Index*,Unpa
2e5d0 63 6b 65 64 52 65 63 6f 72 64 2a 2a 2c 45 78 70 ckedRecord**,Exp
2e5e0 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2a 29 r*,int,int,int*)
2e5f0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 ;.int sqlite3Sta
2e600 74 34 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 28 t4ValueFromExpr(
2e610 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 75 Parse*, Expr*, u
2e620 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 8, sqlite3_value
2e630 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 **);.void sqlite
2e640 33 53 74 61 74 34 50 72 6f 62 65 46 72 65 65 28 3Stat4ProbeFree(
2e650 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 29 UnpackedRecord*)
2e660 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 ;.int sqlite3Sta
2e670 74 34 43 6f 6c 75 6d 6e 28 73 71 6c 69 74 65 33 t4Column(sqlite3
2e680 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 *, const void*,
2e690 69 6e 74 2c 20 69 6e 74 2c 20 73 71 6c 69 74 65 int, int, sqlite
2e6a0 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 63 68 61 72 3_value**);.char
2e6b0 20 73 71 6c 69 74 65 33 49 6e 64 65 78 43 6f 6c sqlite3IndexCol
2e6c0 75 6d 6e 41 66 66 69 6e 69 74 79 28 73 71 6c 69 umnAffinity(sqli
2e6d0 74 65 33 2a 2c 20 49 6e 64 65 78 2a 2c 20 69 6e te3*, Index*, in
2e6e0 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a t);.#endif../*.*
2e6f0 2a 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 * The interface
2e700 74 6f 20 74 68 65 20 4c 45 4d 4f 4e 2d 67 65 6e to the LEMON-gen
2e710 65 72 61 74 65 64 20 70 61 72 73 65 72 0a 2a 2f erated parser.*/
2e720 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2e730 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a 20 20 76 AMALGAMATION. v
2e740 6f 69 64 20 2a 73 71 6c 69 74 65 33 50 61 72 73 oid *sqlite3Pars
2e750 65 72 41 6c 6c 6f 63 28 76 6f 69 64 2a 28 2a 29 erAlloc(void*(*)
2e760 28 75 36 34 29 2c 20 50 61 72 73 65 2a 29 3b 0a (u64), Parse*);.
2e770 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 void sqlite3Pa
2e780 72 73 65 72 46 72 65 65 28 76 6f 69 64 2a 2c 20 rserFree(void*,
2e790 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b void(*)(void*));
2e7a0 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c .#endif.void sql
2e7b0 69 74 65 33 50 61 72 73 65 72 28 76 6f 69 64 2a ite3Parser(void*
2e7c0 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 29 3b 0a 69 , int, Token);.i
2e7d0 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 nt sqlite3Parser
2e7e0 46 61 6c 6c 62 61 63 6b 28 69 6e 74 29 3b 0a 23 Fallback(int);.#
2e7f0 69 66 64 65 66 20 59 59 54 52 41 43 4b 4d 41 58 ifdef YYTRACKMAX
2e800 53 54 41 43 4b 44 45 50 54 48 0a 20 20 69 6e 74 STACKDEPTH. int
2e810 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 53 74 sqlite3ParserSt
2e820 61 63 6b 50 65 61 6b 28 76 6f 69 64 2a 29 3b 0a ackPeak(void*);.
2e830 23 65 6e 64 69 66 0a 0a 76 6f 69 64 20 73 71 6c #endif..void sql
2e840 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 ite3AutoLoadExte
2e850 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 nsions(sqlite3*)
2e860 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
2e870 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e _OMIT_LOAD_EXTEN
2e880 53 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c 69 SION. void sqli
2e890 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 6f te3CloseExtensio
2e8a0 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 ns(sqlite3*);.#e
2e8b0 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
2e8c0 69 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 ite3CloseExtensi
2e8d0 6f 6e 73 28 58 29 0a 23 65 6e 64 69 66 0a 0a 23 ons(X).#endif..#
2e8e0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
2e8f0 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a IT_SHARED_CACHE.
2e900 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 61 void sqlite3Ta
2e910 62 6c 65 4c 6f 63 6b 28 50 61 72 73 65 20 2a 2c bleLock(Parse *,
2e920 20 69 6e 74 2c 20 69 6e 74 2c 20 75 38 2c 20 63 int, int, u8, c
2e930 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 23 65 onst char *);.#e
2e940 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 lse. #define sq
2e950 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 76 lite3TableLock(v
2e960 2c 77 2c 78 2c 79 2c 7a 29 0a 23 65 6e 64 69 66 ,w,x,y,z).#endif
2e970 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
2e980 54 45 53 54 0a 20 20 69 6e 74 20 73 71 6c 69 74 TEST. int sqlit
2e990 65 33 55 74 66 38 54 6f 38 28 75 6e 73 69 67 6e e3Utf8To8(unsign
2e9a0 65 64 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 ed char*);.#endi
2e9b0 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
2e9c0 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
2e9d0 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c LE.# define sql
2e9e0 69 74 65 33 56 74 61 62 43 6c 65 61 72 28 59 29 ite3VtabClear(Y)
2e9f0 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 .# define sqlit
2ea00 65 33 56 74 61 62 53 79 6e 63 28 58 2c 59 29 20 e3VtabSync(X,Y)
2ea10 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 64 65 66 SQLITE_OK.# def
2ea20 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 52 ine sqlite3VtabR
2ea30 6f 6c 6c 62 61 63 6b 28 58 29 0a 23 20 20 64 65 ollback(X).# de
2ea40 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
2ea50 43 6f 6d 6d 69 74 28 58 29 0a 23 20 20 64 65 66 Commit(X).# def
2ea60 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 49 ine sqlite3VtabI
2ea70 6e 53 79 6e 63 28 64 62 29 20 30 0a 23 20 20 64 nSync(db) 0.# d
2ea80 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 efine sqlite3Vta
2ea90 62 4c 6f 63 6b 28 58 29 0a 23 20 20 64 65 66 69 bLock(X).# defi
2eaa0 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e ne sqlite3VtabUn
2eab0 6c 6f 63 6b 28 58 29 0a 23 20 20 64 65 66 69 6e lock(X).# defin
2eac0 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c e sqlite3VtabUnl
2ead0 6f 63 6b 4c 69 73 74 28 58 29 0a 23 20 20 64 65 ockList(X).# de
2eae0 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
2eaf0 53 61 76 65 70 6f 69 6e 74 28 58 2c 20 59 2c 20 Savepoint(X, Y,
2eb00 5a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 Z) SQLITE_OK.#
2eb10 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 65 define sqlite3Ge
2eb20 74 56 54 61 62 6c 65 28 58 2c 59 29 20 20 28 28 tVTable(X,Y) ((
2eb30 56 54 61 62 6c 65 2a 29 30 29 0a 23 65 6c 73 65 VTable*)0).#else
2eb40 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 . void sqlite3
2eb50 56 74 61 62 43 6c 65 61 72 28 73 71 6c 69 74 65 VtabClear(sqlite
2eb60 33 20 2a 64 62 2c 20 54 61 62 6c 65 2a 29 3b 0a 3 *db, Table*);.
2eb70 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 void sqlite3V
2eb80 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 73 71 tabDisconnect(sq
2eb90 6c 69 74 65 33 20 2a 64 62 2c 20 54 61 62 6c 65 lite3 *db, Table
2eba0 20 2a 70 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c *p);. int sql
2ebb0 69 74 65 33 56 74 61 62 53 79 6e 63 28 73 71 6c ite3VtabSync(sql
2ebc0 69 74 65 33 20 2a 64 62 2c 20 56 64 62 65 2a 29 ite3 *db, Vdbe*)
2ebd0 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 33 ;. int sqlite3
2ebe0 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 73 71 6c VtabRollback(sql
2ebf0 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 20 69 6e ite3 *db);. in
2ec00 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 6f 6d t sqlite3VtabCom
2ec10 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 mit(sqlite3 *db)
2ec20 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ;. void sqlite
2ec30 33 56 74 61 62 4c 6f 63 6b 28 56 54 61 62 6c 65 3VtabLock(VTable
2ec40 20 2a 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c *);. void sql
2ec50 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 56 ite3VtabUnlock(V
2ec60 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 76 6f 69 Table *);. voi
2ec70 64 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c d sqlite3VtabUnl
2ec80 6f 63 6b 4c 69 73 74 28 73 71 6c 69 74 65 33 2a ockList(sqlite3*
2ec90 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 );. int sqlite
2eca0 33 56 74 61 62 53 61 76 65 70 6f 69 6e 74 28 73 3VtabSavepoint(s
2ecb0 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 2c 20 69 qlite3 *, int, i
2ecc0 6e 74 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c nt);. void sql
2ecd0 69 74 65 33 56 74 61 62 49 6d 70 6f 72 74 45 72 ite3VtabImportEr
2ece0 72 6d 73 67 28 56 64 62 65 2a 2c 20 73 71 6c 69 rmsg(Vdbe*, sqli
2ecf0 74 65 33 5f 76 74 61 62 2a 29 3b 0a 20 20 20 56 te3_vtab*);. V
2ed00 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 47 65 Table *sqlite3Ge
2ed10 74 56 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a tVTable(sqlite3*
2ed20 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 20 4d 6f , Table*);. Mo
2ed30 64 75 6c 65 20 2a 73 71 6c 69 74 65 33 56 74 61 dule *sqlite3Vta
2ed40 62 43 72 65 61 74 65 4d 6f 64 75 6c 65 28 0a 20 bCreateModule(.
2ed50 20 20 20 20 73 71 6c 69 74 65 33 2a 2c 0a 20 20 sqlite3*,.
2ed60 20 20 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 0a const char*,.
2ed70 20 20 20 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 const sqlit
2ed80 65 33 5f 6d 6f 64 75 6c 65 2a 2c 0a 20 20 20 20 e3_module*,.
2ed90 20 76 6f 69 64 2a 2c 0a 20 20 20 20 20 76 6f 69 void*,. voi
2eda0 64 28 2a 29 28 76 6f 69 64 2a 29 0a 20 20 20 29 d(*)(void*). )
2edb0 3b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 ;.# define sqli
2edc0 74 65 33 56 74 61 62 49 6e 53 79 6e 63 28 64 62 te3VtabInSync(db
2edd0 29 20 28 28 64 62 29 2d 3e 6e 56 54 72 61 6e 73 ) ((db)->nVTrans
2ede0 3e 30 20 26 26 20 28 64 62 29 2d 3e 61 56 54 72 >0 && (db)->aVTr
2edf0 61 6e 73 3d 3d 30 29 0a 23 65 6e 64 69 66 0a 69 ans==0).#endif.i
2ee00 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 45 70 nt sqlite3VtabEp
2ee10 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 49 6e 69 74 onymousTableInit
2ee20 28 50 61 72 73 65 2a 2c 4d 6f 64 75 6c 65 2a 29 (Parse*,Module*)
2ee30 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 ;.void sqlite3Vt
2ee40 61 62 45 70 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 abEponymousTable
2ee50 43 6c 65 61 72 28 73 71 6c 69 74 65 33 2a 2c 4d Clear(sqlite3*,M
2ee60 6f 64 75 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 odule*);.void sq
2ee70 6c 69 74 65 33 56 74 61 62 4d 61 6b 65 57 72 69 lite3VtabMakeWri
2ee80 74 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 61 62 table(Parse*,Tab
2ee90 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 le*);.void sqlit
2eea0 65 33 56 74 61 62 42 65 67 69 6e 50 61 72 73 65 e3VtabBeginParse
2eeb0 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c (Parse*, Token*,
2eec0 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c Token*, Token*,
2eed0 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
2eee0 74 65 33 56 74 61 62 46 69 6e 69 73 68 50 61 72 te3VtabFinishPar
2eef0 73 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e se(Parse*, Token
2ef00 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2ef10 56 74 61 62 41 72 67 49 6e 69 74 28 50 61 72 73 VtabArgInit(Pars
2ef20 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
2ef30 33 56 74 61 62 41 72 67 45 78 74 65 6e 64 28 50 3VtabArgExtend(P
2ef40 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a arse*, Token*);.
2ef50 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 int sqlite3VtabC
2ef60 61 6c 6c 43 72 65 61 74 65 28 73 71 6c 69 74 65 allCreate(sqlite
2ef70 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 3*, int, const c
2ef80 68 61 72 20 2a 2c 20 63 68 61 72 20 2a 2a 29 3b har *, char **);
2ef90 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 .int sqlite3Vtab
2efa0 43 61 6c 6c 43 6f 6e 6e 65 63 74 28 50 61 72 73 CallConnect(Pars
2efb0 65 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 69 6e 74 e*, Table*);.int
2efc0 20 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c sqlite3VtabCall
2efd0 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 2a Destroy(sqlite3*
2efe0 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 , int, const cha
2eff0 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 r *);.int sqlite
2f000 33 56 74 61 62 42 65 67 69 6e 28 73 71 6c 69 74 3VtabBegin(sqlit
2f010 65 33 20 2a 2c 20 56 54 61 62 6c 65 20 2a 29 3b e3 *, VTable *);
2f020 0a 46 75 6e 63 44 65 66 20 2a 73 71 6c 69 74 65 .FuncDef *sqlite
2f030 33 56 74 61 62 4f 76 65 72 6c 6f 61 64 46 75 6e 3VtabOverloadFun
2f040 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 20 2a 2c ction(sqlite3 *,
2f050 46 75 6e 63 44 65 66 2a 2c 20 69 6e 74 20 6e 41 FuncDef*, int nA
2f060 72 67 2c 20 45 78 70 72 2a 29 3b 0a 73 71 6c 69 rg, Expr*);.sqli
2f070 74 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 te3_int64 sqlite
2f080 33 53 74 6d 74 43 75 72 72 65 6e 74 54 69 6d 65 3StmtCurrentTime
2f090 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
2f0a0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 *);.int sqlite3V
2f0b0 64 62 65 50 61 72 61 6d 65 74 65 72 49 6e 64 65 dbeParameterInde
2f0c0 78 28 56 64 62 65 2a 2c 20 63 6f 6e 73 74 20 63 x(Vdbe*, const c
2f0d0 68 61 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 har*, int);.int
2f0e0 73 71 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 sqlite3TransferB
2f0f0 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f indings(sqlite3_
2f100 73 74 6d 74 20 2a 2c 20 73 71 6c 69 74 65 33 5f stmt *, sqlite3_
2f110 73 74 6d 74 20 2a 29 3b 0a 76 6f 69 64 20 73 71 stmt *);.void sq
2f120 6c 69 74 65 33 50 61 72 73 65 72 52 65 73 65 74 lite3ParserReset
2f130 28 50 61 72 73 65 2a 29 3b 0a 23 69 66 64 65 66 (Parse*);.#ifdef
2f140 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4e SQLITE_ENABLE_N
2f150 4f 52 4d 41 4c 49 5a 45 0a 63 68 61 72 20 2a 73 ORMALIZE.char *s
2f160 71 6c 69 74 65 33 4e 6f 72 6d 61 6c 69 7a 65 28 qlite3Normalize(
2f170 56 64 62 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 Vdbe*, const cha
2f180 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 r*);.#endif.int
2f190 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 sqlite3Reprepare
2f1a0 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 (Vdbe*);.void sq
2f1b0 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 68 65 lite3ExprListChe
2f1c0 63 6b 4c 65 6e 67 74 68 28 50 61 72 73 65 2a 2c ckLength(Parse*,
2f1d0 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f 6e 73 ExprList*, cons
2f1e0 74 20 63 68 61 72 2a 29 3b 0a 43 6f 6c 6c 53 65 t char*);.CollSe
2f1f0 71 20 2a 73 71 6c 69 74 65 33 42 69 6e 61 72 79 q *sqlite3Binary
2f200 43 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 28 50 CompareCollSeq(P
2f210 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c 20 arse *, Expr *,
2f220 45 78 70 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c Expr *);.int sql
2f230 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 ite3TempInMemory
2f240 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 2a 29 (const sqlite3*)
2f250 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 ;.const char *sq
2f260 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4d 6f 64 65 lite3JournalMode
2f270 6e 61 6d 65 28 69 6e 74 29 3b 0a 23 69 66 6e 64 name(int);.#ifnd
2f280 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
2f290 41 4c 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 AL. int sqlite3
2f2a0 43 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 74 Checkpoint(sqlit
2f2b0 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 e3*, int, int, i
2f2c0 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 20 20 69 6e nt*, int*);. in
2f2d0 74 20 73 71 6c 69 74 65 33 57 61 6c 44 65 66 61 t sqlite3WalDefa
2f2e0 75 6c 74 48 6f 6f 6b 28 76 6f 69 64 2a 2c 73 71 ultHook(void*,sq
2f2f0 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
2f300 72 2a 2c 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a r*,int);.#endif.
2f310 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
2f320 4d 49 54 5f 43 54 45 0a 20 20 57 69 74 68 20 2a MIT_CTE. With *
2f330 73 71 6c 69 74 65 33 57 69 74 68 41 64 64 28 50 sqlite3WithAdd(P
2f340 61 72 73 65 2a 2c 57 69 74 68 2a 2c 54 6f 6b 65 arse*,With*,Toke
2f350 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 65 6c n*,ExprList*,Sel
2f360 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 ect*);. void sq
2f370 6c 69 74 65 33 57 69 74 68 44 65 6c 65 74 65 28 lite3WithDelete(
2f380 73 71 6c 69 74 65 33 2a 2c 57 69 74 68 2a 29 3b sqlite3*,With*);
2f390 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 57 . void sqlite3W
2f3a0 69 74 68 50 75 73 68 28 50 61 72 73 65 2a 2c 20 ithPush(Parse*,
2f3b0 57 69 74 68 2a 2c 20 75 38 29 3b 0a 23 65 6c 73 With*, u8);.#els
2f3c0 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 e.#define sqlite
2f3d0 33 57 69 74 68 50 75 73 68 28 78 2c 79 2c 7a 29 3WithPush(x,y,z)
2f3e0 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 .#define sqlite3
2f3f0 57 69 74 68 44 65 6c 65 74 65 28 78 2c 79 29 0a WithDelete(x,y).
2f400 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 #endif.#ifndef S
2f410 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 50 53 45 52 QLITE_OMIT_UPSER
2f420 54 0a 20 20 55 70 73 65 72 74 20 2a 73 71 6c 69 T. Upsert *sqli
2f430 74 65 33 55 70 73 65 72 74 4e 65 77 28 73 71 6c te3UpsertNew(sql
2f440 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a 2c ite3*,ExprList*,
2f450 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c Expr*,ExprList*,
2f460 45 78 70 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 Expr*);. void s
2f470 71 6c 69 74 65 33 55 70 73 65 72 74 44 65 6c 65 qlite3UpsertDele
2f480 74 65 28 73 71 6c 69 74 65 33 2a 2c 55 70 73 65 te(sqlite3*,Upse
2f490 72 74 2a 29 3b 0a 20 20 55 70 73 65 72 74 20 2a rt*);. Upsert *
2f4a0 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 75 70 sqlite3UpsertDup
2f4b0 28 73 71 6c 69 74 65 33 2a 2c 55 70 73 65 72 74 (sqlite3*,Upsert
2f4c0 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 *);. int sqlite
2f4d0 33 55 70 73 65 72 74 41 6e 61 6c 79 7a 65 54 61 3UpsertAnalyzeTa
2f4e0 72 67 65 74 28 50 61 72 73 65 2a 2c 53 72 63 4c rget(Parse*,SrcL
2f4f0 69 73 74 2a 2c 55 70 73 65 72 74 2a 29 3b 0a 20 ist*,Upsert*);.
2f500 20 76 6f 69 64 20 73 71 6c 69 74 65 33 55 70 73 void sqlite3Ups
2f510 65 72 74 44 6f 55 70 64 61 74 65 28 50 61 72 73 ertDoUpdate(Pars
2f520 65 2a 2c 55 70 73 65 72 74 2a 2c 54 61 62 6c 65 e*,Upsert*,Table
2f530 2a 2c 49 6e 64 65 78 2a 2c 69 6e 74 29 3b 0a 23 *,Index*,int);.#
2f540 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 73 71 6c else.#define sql
2f550 69 74 65 33 55 70 73 65 72 74 4e 65 77 28 76 2c ite3UpsertNew(v,
2f560 77 2c 78 2c 79 2c 7a 29 20 28 28 55 70 73 65 72 w,x,y,z) ((Upser
2f570 74 2a 29 30 29 0a 23 64 65 66 69 6e 65 20 73 71 t*)0).#define sq
2f580 6c 69 74 65 33 55 70 73 65 72 74 44 65 6c 65 74 lite3UpsertDelet
2f590 65 28 78 2c 79 29 0a 23 64 65 66 69 6e 65 20 73 e(x,y).#define s
2f5a0 71 6c 69 74 65 33 55 70 73 65 72 74 44 75 70 28 qlite3UpsertDup(
2f5b0 78 2c 79 29 20 20 20 20 20 20 20 28 28 55 70 73 x,y) ((Ups
2f5c0 65 72 74 2a 29 30 29 0a 23 65 6e 64 69 66 0a 0a ert*)0).#endif..
2f5d0 0a 2f 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e 73 ./* Declarations
2f5e0 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 69 for functions i
2f5f0 6e 20 66 6b 65 79 2e 63 2e 20 41 6c 6c 20 6f 66 n fkey.c. All of
2f600 20 74 68 65 73 65 20 61 72 65 20 72 65 70 6c 61 these are repla
2f610 63 65 64 20 62 79 0a 2a 2a 20 6e 6f 2d 6f 70 20 ced by.** no-op
2f620 6d 61 63 72 6f 73 20 69 66 20 4f 4d 49 54 5f 46 macros if OMIT_F
2f630 4f 52 45 49 47 4e 5f 4b 45 59 20 69 73 20 64 65 OREIGN_KEY is de
2f640 66 69 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 63 fined. In this c
2f650 61 73 65 20 6e 6f 20 66 6f 72 65 69 67 6e 0a 2a ase no foreign.*
2f660 2a 20 6b 65 79 20 66 75 6e 63 74 69 6f 6e 61 6c * key functional
2f670 69 74 79 20 69 73 20 61 76 61 69 6c 61 62 6c 65 ity is available
2f680 2e 20 49 66 20 4f 4d 49 54 5f 54 52 49 47 47 45 . If OMIT_TRIGGE
2f690 52 20 69 73 20 64 65 66 69 6e 65 64 20 62 75 74 R is defined but
2f6a0 0a 2a 2a 20 4f 4d 49 54 5f 46 4f 52 45 49 47 4e .** OMIT_FOREIGN
2f6b0 5f 4b 45 59 20 69 73 20 6e 6f 74 2c 20 6f 6e 6c _KEY is not, onl
2f6c0 79 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 66 75 y some of the fu
2f6d0 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f 2d 6f nctions are no-o
2f6e0 70 65 64 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 20 ped. In.** this
2f6f0 63 61 73 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 case foreign key
2f700 73 20 61 72 65 20 70 61 72 73 65 64 2c 20 62 75 s are parsed, bu
2f710 74 20 6e 6f 20 6f 74 68 65 72 20 66 75 6e 63 74 t no other funct
2f720 69 6f 6e 61 6c 69 74 79 20 69 73 0a 2a 2a 20 70 ionality is.** p
2f730 72 6f 76 69 64 65 64 20 28 65 6e 66 6f 72 63 65 rovided (enforce
2f740 6d 65 6e 74 20 6f 66 20 46 4b 20 63 6f 6e 73 74 ment of FK const
2f750 72 61 69 6e 74 73 20 72 65 71 75 69 72 65 73 20 raints requires
2f760 74 68 65 20 74 72 69 67 67 65 72 73 20 73 75 62 the triggers sub
2f770 2d 73 79 73 74 65 6d 29 2e 0a 2a 2f 0a 23 69 66 -system)..*/.#if
2f780 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
2f790 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 _OMIT_FOREIGN_KE
2f7a0 59 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 Y) && !defined(S
2f7b0 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 QLITE_OMIT_TRIGG
2f7c0 45 52 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 ER). void sqlit
2f7d0 65 33 46 6b 43 68 65 63 6b 28 50 61 72 73 65 2a e3FkCheck(Parse*
2f7e0 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 , Table*, int, i
2f7f0 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a nt, int*, int);.
2f800 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 46 6b void sqlite3Fk
2f810 44 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a DropTable(Parse*
2f820 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 54 61 62 , SrcList *, Tab
2f830 6c 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c le*);. void sql
2f840 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 50 61 ite3FkActions(Pa
2f850 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 78 rse*, Table*, Ex
2f860 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e prList*, int, in
2f870 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 69 6e 74 20 t*, int);. int
2f880 73 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72 65 sqlite3FkRequire
2f890 64 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a d(Parse*, Table*
2f8a0 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 , int*, int);.
2f8b0 75 33 32 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 u32 sqlite3FkOld
2f8c0 6d 61 73 6b 28 50 61 72 73 65 2a 2c 20 54 61 62 mask(Parse*, Tab
2f8d0 6c 65 2a 29 3b 0a 20 20 46 4b 65 79 20 2a 73 71 le*);. FKey *sq
2f8e0 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 65 lite3FkReference
2f8f0 73 28 54 61 62 6c 65 20 2a 29 3b 0a 23 65 6c 73 s(Table *);.#els
2f900 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 e. #define sqli
2f910 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 61 2c 62 te3FkActions(a,b
2f920 2c 63 2c 64 2c 65 2c 66 29 0a 20 20 23 64 65 66 ,c,d,e,f). #def
2f930 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 43 68 65 ine sqlite3FkChe
2f940 63 6b 28 61 2c 62 2c 63 2c 64 2c 65 2c 66 29 0a ck(a,b,c,d,e,f).
2f950 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
2f960 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 61 2c 62 3FkDropTable(a,b
2f970 2c 63 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 ,c). #define sq
2f980 6c 69 74 65 33 46 6b 4f 6c 64 6d 61 73 6b 28 61 lite3FkOldmask(a
2f990 2c 62 29 20 20 20 20 20 20 20 20 20 30 0a 20 20 ,b) 0.
2f9a0 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 #define sqlite3F
2f9b0 6b 52 65 71 75 69 72 65 64 28 61 2c 62 2c 63 2c kRequired(a,b,c,
2f9c0 64 29 20 20 20 20 30 0a 20 20 23 64 65 66 69 6e d) 0. #defin
2f9d0 65 20 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72 e sqlite3FkRefer
2f9e0 65 6e 63 65 73 28 61 29 20 20 20 20 20 20 20 20 ences(a)
2f9f0 30 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 0.#endif.#ifndef
2fa00 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 SQLITE_OMIT_FOR
2fa10 45 49 47 4e 5f 4b 45 59 0a 20 20 76 6f 69 64 20 EIGN_KEY. void
2fa20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 28 sqlite3FkDelete(
2fa30 73 71 6c 69 74 65 33 20 2a 2c 20 54 61 62 6c 65 sqlite3 *, Table
2fa40 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 *);. int sqlite
2fa50 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 50 3FkLocateIndex(P
2fa60 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 46 4b 65 arse*,Table*,FKe
2fa70 79 2a 2c 49 6e 64 65 78 2a 2a 2c 69 6e 74 2a 2a y*,Index**,int**
2fa80 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 );.#else. #defi
2fa90 6e 65 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 ne sqlite3FkDele
2faa0 74 65 28 61 2c 62 29 0a 20 20 23 64 65 66 69 6e te(a,b). #defin
2fab0 65 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 e sqlite3FkLocat
2fac0 65 49 6e 64 65 78 28 61 2c 62 2c 63 2c 64 2c 65 eIndex(a,b,c,d,e
2fad0 29 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a ).#endif.../*.**
2fae0 20 41 76 61 69 6c 61 62 6c 65 20 66 61 75 6c 74 Available fault
2faf0 20 69 6e 6a 65 63 74 6f 72 73 2e 20 20 53 68 6f injectors. Sho
2fb00 75 6c 64 20 62 65 20 6e 75 6d 62 65 72 65 64 20 uld be numbered
2fb10 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 30 beginning with 0
2fb20 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
2fb30 49 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 4f ITE_FAULTINJECTO
2fb40 52 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 30 0a 23 R_MALLOC 0.#
2fb50 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 41 define SQLITE_FA
2fb60 55 4c 54 49 4e 4a 45 43 54 4f 52 5f 43 4f 55 4e ULTINJECTOR_COUN
2fb70 54 20 20 20 20 20 20 31 0a 0a 2f 2a 0a 2a 2a 20 T 1../*.**
2fb80 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 6f The interface to
2fb90 20 74 68 65 20 63 6f 64 65 20 69 6e 20 66 61 75 the code in fau
2fba0 6c 74 2e 63 20 75 73 65 64 20 66 6f 72 20 69 64 lt.c used for id
2fbb0 65 6e 74 69 66 79 69 6e 67 20 22 62 65 6e 69 67 entifying "benig
2fbc0 6e 22 0a 2a 2a 20 6d 61 6c 6c 6f 63 20 66 61 69 n".** malloc fai
2fbd0 6c 75 72 65 73 2e 20 54 68 69 73 20 69 73 20 6f lures. This is o
2fbe0 6e 6c 79 20 70 72 65 73 65 6e 74 20 69 66 20 53 nly present if S
2fbf0 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c 45 QLITE_UNTESTABLE
2fc00 0a 2a 2a 20 69 73 20 6e 6f 74 20 64 65 66 69 6e .** is not defin
2fc10 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ed..*/.#ifndef S
2fc20 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c 45 QLITE_UNTESTABLE
2fc30 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 42 . void sqlite3B
2fc40 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 eginBenignMalloc
2fc50 28 76 6f 69 64 29 3b 0a 20 20 76 6f 69 64 20 73 (void);. void s
2fc60 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
2fc70 61 6c 6c 6f 63 28 76 6f 69 64 29 3b 0a 23 65 6c alloc(void);.#el
2fc80 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c se. #define sql
2fc90 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d ite3BeginBenignM
2fca0 61 6c 6c 6f 63 28 29 0a 20 20 23 64 65 66 69 6e alloc(). #defin
2fcb0 65 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 e sqlite3EndBeni
2fcc0 67 6e 4d 61 6c 6c 6f 63 28 29 0a 23 65 6e 64 69 gnMalloc().#endi
2fcd0 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 f../*.** Allowed
2fce0 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 20 66 return values f
2fcf0 72 6f 6d 20 73 71 6c 69 74 65 33 46 69 6e 64 49 rom sqlite3FindI
2fd00 6e 49 6e 64 65 78 28 29 0a 2a 2f 0a 23 64 65 66 nIndex().*/.#def
2fd10 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 52 4f 57 ine IN_INDEX_ROW
2fd20 49 44 20 20 20 20 20 20 20 20 31 20 20 20 2f 2a ID 1 /*
2fd30 20 53 65 61 72 63 68 20 74 68 65 20 72 6f 77 69 Search the rowi
2fd40 64 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 2a d of the table *
2fd50 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 /.#define IN_IND
2fd60 45 58 5f 45 50 48 20 20 20 20 20 20 20 20 20 20 EX_EPH
2fd70 32 20 20 20 2f 2a 20 53 65 61 72 63 68 20 61 6e 2 /* Search an
2fd80 20 65 70 68 65 6d 65 72 61 6c 20 62 2d 74 72 65 ephemeral b-tre
2fd90 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f e */.#define IN_
2fda0 49 4e 44 45 58 5f 49 4e 44 45 58 5f 41 53 43 20 INDEX_INDEX_ASC
2fdb0 20 20 20 33 20 20 20 2f 2a 20 45 78 69 73 74 69 3 /* Existi
2fdc0 6e 67 20 69 6e 64 65 78 20 41 53 43 45 4e 44 49 ng index ASCENDI
2fdd0 4e 47 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e NG */.#define IN
2fde0 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 44 45 53 _INDEX_INDEX_DES
2fdf0 43 20 20 20 34 20 20 20 2f 2a 20 45 78 69 73 74 C 4 /* Exist
2fe00 69 6e 67 20 69 6e 64 65 78 20 44 45 53 43 45 4e ing index DESCEN
2fe10 44 49 4e 47 20 2a 2f 0a 23 64 65 66 69 6e 65 20 DING */.#define
2fe20 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 20 20 20 IN_INDEX_NOOP
2fe30 20 20 20 20 20 20 35 20 20 20 2f 2a 20 4e 6f 20 5 /* No
2fe40 74 61 62 6c 65 20 61 76 61 69 6c 61 62 6c 65 2e table available.
2fe50 20 55 73 65 20 63 6f 6d 70 61 72 69 73 6f 6e 73 Use comparisons
2fe60 20 2a 2f 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 */./*.** Allowe
2fe70 64 20 66 6c 61 67 73 20 66 6f 72 20 74 68 65 20 d flags for the
2fe80 33 72 64 20 70 61 72 61 6d 65 74 65 72 20 74 6f 3rd parameter to
2fe90 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 49 6e sqlite3FindInIn
2fea0 64 65 78 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 6e dex()..*/.#defin
2feb0 65 20 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 5f e IN_INDEX_NOOP_
2fec0 4f 4b 20 20 20 20 20 30 78 30 30 30 31 20 20 2f OK 0x0001 /
2fed0 2a 20 4f 4b 20 74 6f 20 72 65 74 75 72 6e 20 49 * OK to return I
2fee0 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 20 2a 2f 0a N_INDEX_NOOP */.
2fef0 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 #define IN_INDEX
2ff00 5f 4d 45 4d 42 45 52 53 48 49 50 20 20 30 78 30 _MEMBERSHIP 0x0
2ff10 30 30 32 20 20 2f 2a 20 49 4e 20 6f 70 65 72 61 002 /* IN opera
2ff20 74 6f 72 20 75 73 65 64 20 66 6f 72 20 6d 65 6d tor used for mem
2ff30 62 65 72 73 68 69 70 20 74 65 73 74 20 2a 2f 0a bership test */.
2ff40 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 #define IN_INDEX
2ff50 5f 4c 4f 4f 50 20 20 20 20 20 20 20 20 30 78 30 _LOOP 0x0
2ff60 30 30 34 20 20 2f 2a 20 49 4e 20 6f 70 65 72 61 004 /* IN opera
2ff70 74 6f 72 20 75 73 65 64 20 61 73 20 61 20 6c 6f tor used as a lo
2ff80 6f 70 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 op */.int sqlite
2ff90 33 46 69 6e 64 49 6e 49 6e 64 65 78 28 50 61 72 3FindInIndex(Par
2ffa0 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c 20 75 33 se *, Expr *, u3
2ffb0 32 2c 20 69 6e 74 2a 2c 20 69 6e 74 2a 2c 20 69 2, int*, int*, i
2ffc0 6e 74 2a 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 nt*);..int sqlit
2ffd0 65 33 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 73 71 e3JournalOpen(sq
2ffe0 6c 69 74 65 33 5f 76 66 73 20 2a 2c 20 63 6f 6e lite3_vfs *, con
2fff0 73 74 20 63 68 61 72 20 2a 2c 20 73 71 6c 69 74 st char *, sqlit
30000 65 33 5f 66 69 6c 65 20 2a 2c 20 69 6e 74 2c 20 e3_file *, int,
30010 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
30020 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 73 71 6c 3JournalSize(sql
30030 69 74 65 33 5f 76 66 73 20 2a 29 3b 0a 23 69 66 ite3_vfs *);.#if
30040 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
30050 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
30060 49 54 45 29 20 5c 0a 20 7c 7c 20 64 65 66 69 6e ITE) \. || defin
30070 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
30080 5f 42 41 54 43 48 5f 41 54 4f 4d 49 43 5f 57 52 _BATCH_ATOMIC_WR
30090 49 54 45 29 0a 20 20 69 6e 74 20 73 71 6c 69 74 ITE). int sqlit
300a0 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 28 e3JournalCreate(
300b0 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 3b sqlite3_file *);
300c0 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 6c .#endif..int sql
300d0 69 74 65 33 4a 6f 75 72 6e 61 6c 49 73 49 6e 4d ite3JournalIsInM
300e0 65 6d 6f 72 79 28 73 71 6c 69 74 65 33 5f 66 69 emory(sqlite3_fi
300f0 6c 65 20 2a 70 29 3b 0a 76 6f 69 64 20 73 71 6c le *p);.void sql
30100 69 74 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c 4f 70 ite3MemJournalOp
30110 65 6e 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 en(sqlite3_file
30120 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);..void sqlite
30130 33 45 78 70 72 53 65 74 48 65 69 67 68 74 41 6e 3ExprSetHeightAn
30140 64 46 6c 61 67 73 28 50 61 72 73 65 20 2a 70 50 dFlags(Parse *pP
30150 61 72 73 65 2c 20 45 78 70 72 20 2a 70 29 3b 0a arse, Expr *p);.
30160 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 45 #if SQLITE_MAX_E
30170 58 50 52 5f 44 45 50 54 48 3e 30 0a 20 20 69 6e XPR_DEPTH>0. in
30180 74 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 45 t sqlite3SelectE
30190 78 70 72 48 65 69 67 68 74 28 53 65 6c 65 63 74 xprHeight(Select
301a0 20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 *);. int sqlit
301b0 65 33 45 78 70 72 43 68 65 63 6b 48 65 69 67 68 e3ExprCheckHeigh
301c0 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a t(Parse*, int);.
301d0 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 #else. #define
301e0 73 71 6c 69 74 65 33 53 65 6c 65 63 74 45 78 70 sqlite3SelectExp
301f0 72 48 65 69 67 68 74 28 78 29 20 30 0a 20 20 23 rHeight(x) 0. #
30200 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 78 define sqlite3Ex
30210 70 72 43 68 65 63 6b 48 65 69 67 68 74 28 78 2c prCheckHeight(x,
30220 79 29 0a 23 65 6e 64 69 66 0a 0a 75 33 32 20 73 y).#endif..u32 s
30230 71 6c 69 74 65 33 47 65 74 34 62 79 74 65 28 63 qlite3Get4byte(c
30240 6f 6e 73 74 20 75 38 2a 29 3b 0a 76 6f 69 64 20 onst u8*);.void
30250 73 71 6c 69 74 65 33 50 75 74 34 62 79 74 65 28 sqlite3Put4byte(
30260 75 38 2a 2c 20 75 33 32 29 3b 0a 0a 23 69 66 64 u8*, u32);..#ifd
30270 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
30280 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 0a 20 _UNLOCK_NOTIFY.
30290 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6e void sqlite3Con
302a0 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 73 nectionBlocked(s
302b0 71 6c 69 74 65 33 20 2a 2c 20 73 71 6c 69 74 65 qlite3 *, sqlite
302c0 33 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 3 *);. void sql
302d0 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 6e ite3ConnectionUn
302e0 6c 6f 63 6b 65 64 28 73 71 6c 69 74 65 33 20 2a locked(sqlite3 *
302f0 64 62 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 db);. void sqli
30300 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c 6f te3ConnectionClo
30310 73 65 64 28 73 71 6c 69 74 65 33 20 2a 64 62 29 sed(sqlite3 *db)
30320 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e ;.#else. #defin
30330 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 e sqlite3Connect
30340 69 6f 6e 42 6c 6f 63 6b 65 64 28 78 2c 79 29 0a ionBlocked(x,y).
30350 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
30360 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c 6f 63 3ConnectionUnloc
30370 6b 65 64 28 78 29 0a 20 20 23 64 65 66 69 6e 65 ked(x). #define
30380 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
30390 6f 6e 43 6c 6f 73 65 64 28 78 29 0a 23 65 6e 64 onClosed(x).#end
303a0 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
303b0 45 5f 44 45 42 55 47 0a 20 20 76 6f 69 64 20 73 E_DEBUG. void s
303c0 71 6c 69 74 65 33 50 61 72 73 65 72 54 72 61 63 qlite3ParserTrac
303d0 65 28 46 49 4c 45 2a 2c 20 63 68 61 72 20 2a 29 e(FILE*, char *)
303e0 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 ;.#endif.#if def
303f0 69 6e 65 64 28 59 59 43 4f 56 45 52 41 47 45 29 ined(YYCOVERAGE)
30400 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 50 61 . int sqlite3Pa
30410 72 73 65 72 43 6f 76 65 72 61 67 65 28 46 49 4c rserCoverage(FIL
30420 45 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a E*);.#endif../*.
30430 2a 2a 20 49 66 20 74 68 65 20 53 51 4c 49 54 45 ** If the SQLITE
30440 5f 45 4e 41 42 4c 45 20 49 4f 54 52 41 43 45 20 _ENABLE IOTRACE
30450 65 78 69 73 74 73 20 74 68 65 6e 20 74 68 65 20 exists then the
30460 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 0a global variable.
30470 2a 2a 20 73 71 6c 69 74 65 33 49 6f 54 72 61 63 ** sqlite3IoTrac
30480 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 e is a pointer t
30490 6f 20 61 20 70 72 69 6e 74 66 2d 6c 69 6b 65 20 o a printf-like
304a0 72 6f 75 74 69 6e 65 20 75 73 65 64 20 74 6f 0a routine used to.
304b0 2a 2a 20 70 72 69 6e 74 20 49 2f 4f 20 74 72 61 ** print I/O tra
304c0 63 69 6e 67 20 6d 65 73 73 61 67 65 73 2e 0a 2a cing messages..*
304d0 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
304e0 45 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45 0a 23 ENABLE_IOTRACE.#
304f0 20 64 65 66 69 6e 65 20 49 4f 54 52 41 43 45 28 define IOTRACE(
30500 41 29 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 A) if( sqlite3I
30510 6f 54 72 61 63 65 20 29 7b 20 73 71 6c 69 74 65 oTrace ){ sqlite
30520 33 49 6f 54 72 61 63 65 20 41 3b 20 7d 0a 20 20 3IoTrace A; }.
30530 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 void sqlite3Vdbe
30540 49 4f 54 72 61 63 65 53 71 6c 28 56 64 62 65 2a IOTraceSql(Vdbe*
30550 29 3b 0a 53 51 4c 49 54 45 5f 41 50 49 20 53 51 );.SQLITE_API SQ
30560 4c 49 54 45 5f 45 58 54 45 52 4e 20 76 6f 69 64 LITE_EXTERN void
30570 20 28 53 51 4c 49 54 45 5f 43 44 45 43 4c 20 2a (SQLITE_CDECL *
30580 73 71 6c 69 74 65 33 49 6f 54 72 61 63 65 29 28 sqlite3IoTrace)(
30590 63 6f 6e 73 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 const char*,...)
305a0 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ;.#else.# define
305b0 20 49 4f 54 52 41 43 45 28 41 29 0a 23 20 64 65 IOTRACE(A).# de
305c0 66 69 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 fine sqlite3Vdbe
305d0 49 4f 54 72 61 63 65 53 71 6c 28 58 29 0a 23 65 IOTraceSql(X).#e
305e0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 ndif../*.** Thes
305f0 65 20 72 6f 75 74 69 6e 65 73 20 61 72 65 20 61 e routines are a
30600 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 74 68 65 vailable for the
30610 20 6d 65 6d 32 2e 63 20 64 65 62 75 67 67 69 6e mem2.c debuggin
30620 67 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 g memory allocat
30630 6f 72 0a 2a 2a 20 6f 6e 6c 79 2e 20 20 54 68 65 or.** only. The
30640 79 20 61 72 65 20 75 73 65 64 20 74 6f 20 76 65 y are used to ve
30650 72 69 66 79 20 74 68 61 74 20 64 69 66 66 65 72 rify that differ
30660 65 6e 74 20 22 74 79 70 65 73 22 20 6f 66 20 6d ent "types" of m
30670 65 6d 6f 72 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 emory.** allocat
30680 69 6f 6e 73 20 61 72 65 20 70 72 6f 70 65 72 6c ions are properl
30690 79 20 74 72 61 63 6b 65 64 20 62 79 20 74 68 65 y tracked by the
306a0 20 73 79 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 system..**.** s
306b0 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 qlite3MemdebugSe
306c0 74 54 79 70 65 28 29 20 73 65 74 73 20 74 68 65 tType() sets the
306d0 20 22 74 79 70 65 22 20 6f 66 20 61 6e 20 61 6c "type" of an al
306e0 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 6f 6e 65 20 location to one
306f0 6f 66 0a 2a 2a 20 74 68 65 20 4d 45 4d 54 59 50 of.** the MEMTYP
30700 45 5f 2a 20 6d 61 63 72 6f 73 20 64 65 66 69 6e E_* macros defin
30710 65 64 20 62 65 6c 6f 77 2e 20 20 54 68 65 20 74 ed below. The t
30720 79 70 65 20 6d 75 73 74 20 62 65 20 61 20 62 69 ype must be a bi
30730 74 6d 61 73 6b 20 77 69 74 68 0a 2a 2a 20 61 20 tmask with.** a
30740 73 69 6e 67 6c 65 20 62 69 74 20 73 65 74 2e 0a single bit set..
30750 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d **.** sqlite3Mem
30760 64 65 62 75 67 48 61 73 54 79 70 65 28 29 20 72 debugHasType() r
30770 65 74 75 72 6e 73 20 74 72 75 65 20 69 66 20 61 eturns true if a
30780 6e 79 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 ny of the bits i
30790 6e 20 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 n its second.**
307a0 61 72 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 argument match t
307b0 68 65 20 74 79 70 65 20 73 65 74 20 62 79 20 74 he type set by t
307c0 68 65 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 he previous sqli
307d0 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 te3MemdebugSetTy
307e0 70 65 28 29 2e 0a 2a 2a 20 73 71 6c 69 74 65 33 pe()..** sqlite3
307f0 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 MemdebugHasType(
30800 29 20 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f ) is intended fo
30810 72 20 75 73 65 20 69 6e 73 69 64 65 20 61 73 73 r use inside ass
30820 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
30830 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 4d ..**.** sqlite3M
30840 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 29 20 emdebugNoType()
30850 72 65 74 75 72 6e 73 20 74 72 75 65 20 69 66 20 returns true if
30860 6e 6f 6e 65 20 6f 66 20 74 68 65 20 62 69 74 73 none of the bits
30870 20 69 6e 20 69 74 73 20 73 65 63 6f 6e 64 0a 2a in its second.*
30880 2a 20 61 72 67 75 6d 65 6e 74 20 6d 61 74 63 68 * argument match
30890 20 74 68 65 20 74 79 70 65 20 73 65 74 20 62 79 the type set by
308a0 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 71 the previous sq
308b0 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 lite3MemdebugSet
308c0 54 79 70 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 Type()..**.** Pe
308d0 72 68 61 70 73 20 74 68 65 20 6d 6f 73 74 20 69 rhaps the most i
308e0 6d 70 6f 72 74 61 6e 74 20 70 6f 69 6e 74 20 69 mportant point i
308f0 73 20 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 s the difference
30900 20 62 65 74 77 65 65 6e 20 4d 45 4d 54 59 50 45 between MEMTYPE
30910 5f 48 45 41 50 0a 2a 2a 20 61 6e 64 20 4d 45 4d _HEAP.** and MEM
30920 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 2e 20 TYPE_LOOKASIDE.
30930 20 49 66 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f If an allocatio
30940 6e 20 69 73 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f n is MEMTYPE_LOO
30950 4b 41 53 49 44 45 2c 20 74 68 61 74 20 6d 65 61 KASIDE, that mea
30960 6e 73 0a 2a 2a 20 69 74 20 6d 69 67 68 74 20 68 ns.** it might h
30970 61 76 65 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 ave been allocat
30980 65 64 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 2c ed by lookaside,
30990 20 65 78 63 65 70 74 20 74 68 65 20 61 6c 6c 6f except the allo
309a0 63 61 74 69 6f 6e 20 77 61 73 0a 2a 2a 20 74 6f cation was.** to
309b0 6f 20 6c 61 72 67 65 20 6f 72 20 6c 6f 6f 6b 61 o large or looka
309c0 73 69 64 65 20 77 61 73 20 61 6c 72 65 61 64 79 side was already
309d0 20 66 75 6c 6c 2e 20 20 49 74 20 69 73 20 69 6d full. It is im
309e0 70 6f 72 74 61 6e 74 20 74 6f 20 76 65 72 69 66 portant to verif
309f0 79 0a 2a 2a 20 74 68 61 74 20 61 6c 6c 6f 63 61 y.** that alloca
30a00 74 69 6f 6e 73 20 74 68 61 74 20 6d 69 67 68 74 tions that might
30a10 20 68 61 76 65 20 62 65 65 6e 20 73 61 74 69 73 have been satis
30a20 66 69 65 64 20 62 79 20 6c 6f 6f 6b 61 73 69 64 fied by lookasid
30a30 65 20 61 72 65 20 6e 6f 74 0a 2a 2a 20 70 61 73 e are not.** pas
30a40 73 65 64 20 62 61 63 6b 20 74 6f 20 6e 6f 6e 2d sed back to non-
30a50 6c 6f 6f 6b 61 73 69 64 65 20 66 72 65 65 28 29 lookaside free()
30a60 20 72 6f 75 74 69 6e 65 73 2e 20 20 41 73 73 65 routines. Asse
30a70 72 74 73 20 73 75 63 68 20 61 73 20 74 68 65 0a rts such as the.
30a80 2a 2a 20 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 ** example above
30a90 20 61 72 65 20 70 6c 61 63 65 64 20 6f 6e 20 74 are placed on t
30aa0 68 65 20 6e 6f 6e 2d 6c 6f 6f 6b 61 73 69 64 65 he non-lookaside
30ab0 20 66 72 65 65 28 29 20 72 6f 75 74 69 6e 65 73 free() routines
30ac0 20 74 6f 20 76 65 72 69 66 79 0a 2a 2a 20 74 68 to verify.** th
30ad0 69 73 20 63 6f 6e 73 74 72 61 69 6e 74 2e 0a 2a is constraint..*
30ae0 2a 0a 2a 2a 20 41 6c 6c 20 6f 66 20 74 68 69 73 *.** All of this
30af0 20 69 73 20 6e 6f 2d 6f 70 20 66 6f 72 20 61 20 is no-op for a
30b00 70 72 6f 64 75 63 74 69 6f 6e 20 62 75 69 6c 64 production build
30b10 2e 20 20 49 74 20 6f 6e 6c 79 20 63 6f 6d 65 73 . It only comes
30b20 20 69 6e 74 6f 0a 2a 2a 20 70 6c 61 79 20 77 68 into.** play wh
30b30 65 6e 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 45 en the SQLITE_ME
30b40 4d 44 45 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74 MDEBUG compile-t
30b50 69 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 ime option is us
30b60 65 64 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ed..*/.#ifdef SQ
30b70 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 0a 20 20 LITE_MEMDEBUG.
30b80 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 64 void sqlite3Memd
30b90 65 62 75 67 53 65 74 54 79 70 65 28 76 6f 69 64 ebugSetType(void
30ba0 2a 2c 75 38 29 3b 0a 20 20 69 6e 74 20 73 71 6c *,u8);. int sql
30bb0 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 ite3MemdebugHasT
30bc0 79 70 65 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 20 ype(void*,u8);.
30bd0 20 69 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 64 int sqlite3Memd
30be0 65 62 75 67 4e 6f 54 79 70 65 28 76 6f 69 64 2a ebugNoType(void*
30bf0 2c 75 38 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 ,u8);.#else.# de
30c00 66 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 fine sqlite3Memd
30c10 65 62 75 67 53 65 74 54 79 70 65 28 58 2c 59 29 ebugSetType(X,Y)
30c20 20 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 /* no-op */.#
30c30 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 define sqlite3Me
30c40 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 58 2c mdebugHasType(X,
30c50 59 29 20 20 31 0a 23 20 64 65 66 69 6e 65 20 73 Y) 1.# define s
30c60 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f qlite3MemdebugNo
30c70 54 79 70 65 28 58 2c 59 29 20 20 20 31 0a 23 65 Type(X,Y) 1.#e
30c80 6e 64 69 66 0a 23 64 65 66 69 6e 65 20 4d 45 4d ndif.#define MEM
30c90 54 59 50 45 5f 48 45 41 50 20 20 20 20 20 20 20 TYPE_HEAP
30ca0 30 78 30 31 20 20 2f 2a 20 47 65 6e 65 72 61 6c 0x01 /* General
30cb0 20 68 65 61 70 20 61 6c 6c 6f 63 61 74 69 6f 6e heap allocation
30cc0 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d s */.#define MEM
30cd0 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 20 TYPE_LOOKASIDE
30ce0 30 78 30 32 20 20 2f 2a 20 48 65 61 70 20 74 68 0x02 /* Heap th
30cf0 61 74 20 6d 69 67 68 74 20 68 61 76 65 20 62 65 at might have be
30d00 65 6e 20 6c 6f 6f 6b 61 73 69 64 65 20 2a 2f 0a en lookaside */.
30d10 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f #define MEMTYPE_
30d20 50 43 41 43 48 45 20 20 20 20 20 30 78 30 34 20 PCACHE 0x04
30d30 20 2f 2a 20 50 61 67 65 20 63 61 63 68 65 20 61 /* Page cache a
30d40 6c 6c 6f 63 61 74 69 6f 6e 73 20 2a 2f 0a 0a 2f llocations */../
30d50 2a 0a 2a 2a 20 54 68 72 65 61 64 69 6e 67 20 69 *.** Threading i
30d60 6e 74 65 72 66 61 63 65 0a 2a 2f 0a 23 69 66 20 nterface.*/.#if
30d70 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 SQLITE_MAX_WORKE
30d80 52 5f 54 48 52 45 41 44 53 3e 30 0a 69 6e 74 20 R_THREADS>0.int
30d90 73 71 6c 69 74 65 33 54 68 72 65 61 64 43 72 65 sqlite3ThreadCre
30da0 61 74 65 28 53 51 4c 69 74 65 54 68 72 65 61 64 ate(SQLiteThread
30db0 2a 2a 2c 76 6f 69 64 2a 28 2a 29 28 76 6f 69 64 **,void*(*)(void
30dc0 2a 29 2c 76 6f 69 64 2a 29 3b 0a 69 6e 74 20 73 *),void*);.int s
30dd0 71 6c 69 74 65 33 54 68 72 65 61 64 4a 6f 69 6e qlite3ThreadJoin
30de0 28 53 51 4c 69 74 65 54 68 72 65 61 64 2a 2c 20 (SQLiteThread*,
30df0 76 6f 69 64 2a 2a 29 3b 0a 23 65 6e 64 69 66 0a void**);.#endif.
30e00 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
30e10 49 54 45 5f 45 4e 41 42 4c 45 5f 44 42 50 41 47 ITE_ENABLE_DBPAG
30e20 45 5f 56 54 41 42 29 20 7c 7c 20 64 65 66 69 6e E_VTAB) || defin
30e30 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 0a ed(SQLITE_TEST).
30e40 69 6e 74 20 73 71 6c 69 74 65 33 44 62 70 61 67 int sqlite3Dbpag
30e50 65 52 65 67 69 73 74 65 72 28 73 71 6c 69 74 65 eRegister(sqlite
30e60 33 2a 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 3*);.#endif.#if
30e70 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
30e80 4e 41 42 4c 45 5f 44 42 53 54 41 54 5f 56 54 41 NABLE_DBSTAT_VTA
30e90 42 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 B) || defined(SQ
30ea0 4c 49 54 45 5f 54 45 53 54 29 0a 69 6e 74 20 73 LITE_TEST).int s
30eb0 71 6c 69 74 65 33 44 62 73 74 61 74 52 65 67 69 qlite3DbstatRegi
30ec0 73 74 65 72 28 73 71 6c 69 74 65 33 2a 29 3b 0a ster(sqlite3*);.
30ed0 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 6c 69 #endif..int sqli
30ee0 74 65 33 45 78 70 72 56 65 63 74 6f 72 53 69 7a te3ExprVectorSiz
30ef0 65 28 45 78 70 72 20 2a 70 45 78 70 72 29 3b 0a e(Expr *pExpr);.
30f00 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 int sqlite3ExprI
30f10 73 56 65 63 74 6f 72 28 45 78 70 72 20 2a 70 45 sVector(Expr *pE
30f20 78 70 72 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 xpr);.Expr *sqli
30f30 74 65 33 56 65 63 74 6f 72 46 69 65 6c 64 53 75 te3VectorFieldSu
30f40 62 65 78 70 72 28 45 78 70 72 2a 2c 20 69 6e 74 bexpr(Expr*, int
30f50 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 );.Expr *sqlite3
30f60 45 78 70 72 46 6f 72 56 65 63 74 6f 72 46 69 65 ExprForVectorFie
30f70 6c 64 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c ld(Parse*,Expr*,
30f80 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
30f90 65 33 56 65 63 74 6f 72 45 72 72 6f 72 4d 73 67 e3VectorErrorMsg
30fa0 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b (Parse*, Expr*);
30fb0 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
30fc0 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c 45 4f 50 54 _OMIT_COMPILEOPT
30fd0 49 4f 4e 5f 44 49 41 47 53 0a 63 6f 6e 73 74 20 ION_DIAGS.const
30fe0 63 68 61 72 20 2a 2a 73 71 6c 69 74 65 33 43 6f char **sqlite3Co
30ff0 6d 70 69 6c 65 4f 70 74 69 6f 6e 73 28 69 6e 74 mpileOptions(int
31000 20 2a 70 6e 4f 70 74 29 3b 0a 23 65 6e 64 69 66 *pnOpt);.#endif
31010 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 ..#endif /* SQLI
31020 54 45 49 4e 54 5f 48 20 2a 2f 0a TEINT_H */.