0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 49 6e 74 65 72 6e ******.** Intern
0180: 61 6c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 al interface def
0190: 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 53 51 4c initions for SQL
01a0: 69 74 65 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 6e 64 ite..**.*/.#ifnd
01b0: 65 66 20 53 51 4c 49 54 45 49 4e 54 5f 48 0a 23 ef SQLITEINT_H.#
01c0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 49 4e 54 define SQLITEINT
01d0: 5f 48 0a 0a 2f 2a 20 53 70 65 63 69 61 6c 20 43 _H../* Special C
01e0: 6f 6d 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 53 omments:.**.** S
01f0: 6f 6d 65 20 63 6f 6d 6d 65 6e 74 73 20 68 61 76 ome comments hav
0200: 65 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e e special meanin
0210: 67 20 74 6f 20 74 68 65 20 74 6f 6f 6c 73 20 74 g to the tools t
0220: 68 61 74 20 6d 65 61 73 75 72 65 20 74 65 73 74 hat measure test
0230: 0a 2a 2a 20 63 6f 76 65 72 61 67 65 3a 0a 2a 2a .** coverage:.**
0240: 0a 2a 2a 20 20 20 20 4e 4f 5f 54 45 53 54 20 20 .** NO_TEST
0250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0260: 20 20 20 2d 20 54 68 65 20 62 72 61 6e 63 68 65 - The branche
0270: 73 20 6f 6e 20 74 68 69 73 20 6c 69 6e 65 20 61 s on this line a
0280: 72 65 20 6e 6f 74 0a 2a 2a 20 20 20 20 20 20 20 re not.**
0290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
02a0: 20 20 20 20 20 20 20 20 20 20 20 6d 65 61 73 75 measu
02b0: 72 65 64 20 62 79 20 62 72 61 6e 63 68 20 63 6f red by branch co
02c0: 76 65 72 61 67 65 2e 20 20 54 68 69 73 20 69 73 verage. This is
02d0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
02e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
02f0: 20 20 20 20 20 75 73 65 64 20 6f 6e 20 6c 69 6e used on lin
0300: 65 73 20 6f 66 20 63 6f 64 65 20 74 68 61 74 20 es of code that
0310: 61 63 74 75 61 6c 6c 79 0a 2a 2a 20 20 20 20 20 actually.**
0320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0330: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6d 70 imp
0340: 6c 65 6d 65 6e 74 20 70 61 72 74 73 20 6f 66 20 lement parts of
0350: 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 6e 67 coverage testing
0360: 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 4f 50 54 49 4d ..**.** OPTIM
0370: 49 5a 41 54 49 4f 4e 2d 49 46 2d 54 52 55 45 20 IZATION-IF-TRUE
0380: 20 20 20 20 20 20 20 2d 20 54 68 69 73 20 62 72 - This br
0390: 61 6e 63 68 20 69 73 20 61 6c 6c 6f 77 65 64 20 anch is allowed
03a0: 74 6f 20 61 6c 77 61 79 20 62 65 20 66 61 6c 73 to alway be fals
03b0: 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
03c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
03d0: 20 20 20 20 20 20 61 6e 64 20 74 68 65 20 63 6f and the co
03e0: 72 72 65 63 74 20 61 6e 73 77 65 72 20 69 73 20 rrect answer is
03f0: 73 74 69 6c 6c 20 6f 62 74 61 69 6e 65 64 2c 0a still obtained,.
0400: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
0410: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0420: 20 20 20 20 74 68 6f 75 67 68 20 70 65 72 68 61 though perha
0430: 70 73 20 6d 6f 72 65 20 73 6c 6f 77 6c 79 2e 0a ps more slowly..
0440: 2a 2a 0a 2a 2a 20 20 20 20 4f 50 54 49 4d 49 5a **.** OPTIMIZ
0450: 41 54 49 4f 4e 2d 49 46 2d 46 41 4c 53 45 20 20 ATION-IF-FALSE
0460: 20 20 20 20 20 2d 20 54 68 69 73 20 62 72 61 6e - This bran
0470: 63 68 20 69 73 20 61 6c 6c 6f 77 65 64 20 74 6f ch is allowed to
0480: 20 61 6c 77 61 79 20 62 65 20 74 72 75 65 0a 2a alway be true.*
0490: 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
04a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
04b0: 20 20 20 61 6e 64 20 74 68 65 20 63 6f 72 72 65 and the corre
04c0: 63 74 20 61 6e 73 77 65 72 20 69 73 20 73 74 69 ct answer is sti
04d0: 6c 6c 20 6f 62 74 61 69 6e 65 64 2c 0a 2a 2a 20 ll obtained,.**
04e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
04f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0500: 20 74 68 6f 75 67 68 20 70 65 72 68 61 70 73 20 though perhaps
0510: 6d 6f 72 65 20 73 6c 6f 77 6c 79 2e 0a 2a 2a 0a more slowly..**.
0520: 2a 2a 20 20 20 20 50 52 45 56 45 4e 54 53 2d 48 ** PREVENTS-H
0530: 41 52 4d 4c 45 53 53 2d 4f 56 45 52 52 45 41 44 ARMLESS-OVERREAD
0540: 20 20 2d 20 54 68 69 73 20 62 72 61 6e 63 68 20 - This branch
0550: 70 72 65 76 65 6e 74 73 20 61 20 62 75 66 66 65 prevents a buffe
0560: 72 20 6f 76 65 72 72 65 61 64 0a 2a 2a 20 20 20 r overread.**
0570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
0590: 68 61 74 20 77 6f 75 6c 64 20 62 65 20 68 61 72 hat would be har
05a0: 6d 6c 65 73 73 20 61 6e 64 20 75 6e 64 65 74 65 mless and undete
05b0: 63 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 ctable.**
05c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
05d0: 20 20 20 20 20 20 20 20 20 20 20 69 66 20 69 74 if it
05e0: 20 64 69 64 20 6f 63 63 75 72 2e 20 20 0a 2a 2a did occur. .**
05f0: 0a 2a 2a 20 49 6e 20 61 6c 6c 20 63 61 73 65 73 .** In all cases
0600: 2c 20 74 68 65 20 73 70 65 63 69 61 6c 20 63 6f , the special co
0610: 6d 6d 65 6e 74 20 6d 75 73 74 20 62 65 20 65 6e mment must be en
0620: 63 6c 6f 73 65 64 20 69 6e 20 74 68 65 20 75 73 closed in the us
0630: 75 61 6c 0a 2a 2a 20 73 6c 61 73 68 2d 61 73 74 ual.** slash-ast
0640: 65 72 69 73 6b 2e 2e 2e 61 73 74 65 72 69 73 6b erisk...asterisk
0650: 2d 73 6c 61 73 68 20 63 6f 6d 6d 65 6e 74 20 6d -slash comment m
0660: 61 72 6b 73 2c 20 77 69 74 68 20 6e 6f 20 73 70 arks, with no sp
0670: 61 63 65 73 20 62 65 74 77 65 65 6e 20 74 68 65 aces between the
0680: 20 0a 2a 2a 20 61 73 74 65 72 69 73 6b 73 20 61 .** asterisks a
0690: 6e 64 20 74 68 65 20 63 6f 6d 6d 65 6e 74 20 74 nd the comment t
06a0: 65 78 74 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 4d ext..*/../*.** M
06b0: 61 6b 65 20 73 75 72 65 20 74 68 65 20 54 63 6c ake sure the Tcl
06c0: 20 63 61 6c 6c 69 6e 67 20 63 6f 6e 76 65 6e 74 calling convent
06d0: 69 6f 6e 20 6d 61 63 72 6f 20 69 73 20 64 65 66 ion macro is def
06e0: 69 6e 65 64 2e 20 20 54 68 69 73 20 6d 61 63 72 ined. This macr
06f0: 6f 20 69 73 0a 2a 2a 20 6f 6e 6c 79 20 75 73 65 o is.** only use
0700: 64 20 62 79 20 74 65 73 74 20 63 6f 64 65 20 61 d by test code a
0710: 6e 64 20 54 63 6c 20 69 6e 74 65 67 72 61 74 69 nd Tcl integrati
0720: 6f 6e 20 63 6f 64 65 2e 0a 2a 2f 0a 23 69 66 6e on code..*/.#ifn
0730: 64 65 66 20 53 51 4c 49 54 45 5f 54 43 4c 41 50 def SQLITE_TCLAP
0740: 49 0a 23 20 20 64 65 66 69 6e 65 20 53 51 4c 49 I.# define SQLI
0750: 54 45 5f 54 43 4c 41 50 49 0a 23 65 6e 64 69 66 TE_TCLAPI.#endif
0760: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 75 64 65 20 ../*.** Include
0770: 74 68 65 20 68 65 61 64 65 72 20 66 69 6c 65 20 the header file
0780: 75 73 65 64 20 74 6f 20 63 75 73 74 6f 6d 69 7a used to customiz
0790: 65 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 6f e the compiler o
07a0: 70 74 69 6f 6e 73 20 66 6f 72 20 4d 53 56 43 2e ptions for MSVC.
07b0: 0a 2a 2a 20 54 68 69 73 20 73 68 6f 75 6c 64 20 .** This should
07c0: 62 65 20 64 6f 6e 65 20 66 69 72 73 74 20 73 6f be done first so
07d0: 20 74 68 61 74 20 69 74 20 63 61 6e 20 73 75 63 that it can suc
07e0: 63 65 73 73 66 75 6c 6c 79 20 70 72 65 76 65 6e cessfully preven
07f0: 74 20 73 70 75 72 69 6f 75 73 0a 2a 2a 20 63 6f t spurious.** co
0800: 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e 67 73 20 mpiler warnings
0810: 64 75 65 20 74 6f 20 73 75 62 73 65 71 75 65 6e due to subsequen
0820: 74 20 63 6f 6e 74 65 6e 74 20 69 6e 20 74 68 69 t content in thi
0830: 73 20 66 69 6c 65 20 61 6e 64 20 6f 74 68 65 72 s file and other
0840: 20 66 69 6c 65 73 0a 2a 2a 20 74 68 61 74 20 61 files.** that a
0850: 72 65 20 69 6e 63 6c 75 64 65 64 20 62 79 20 74 re included by t
0860: 68 69 73 20 66 69 6c 65 2e 0a 2a 2f 0a 23 69 6e his file..*/.#in
0870: 63 6c 75 64 65 20 22 6d 73 76 63 2e 68 22 0a 0a clude "msvc.h"..
0880: 2f 2a 0a 2a 2a 20 53 70 65 63 69 61 6c 20 73 65 /*.** Special se
0890: 74 75 70 20 66 6f 72 20 56 78 57 6f 72 6b 73 0a tup for VxWorks.
08a0: 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 76 78 77 */.#include "vxw
08b0: 6f 72 6b 73 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 54 orks.h"../*.** T
08c0: 68 65 73 65 20 23 64 65 66 69 6e 65 73 20 73 68 hese #defines sh
08d0: 6f 75 6c 64 20 65 6e 61 62 6c 65 20 3e 32 47 42 ould enable >2GB
08e0: 20 66 69 6c 65 20 73 75 70 70 6f 72 74 20 6f 6e file support on
08f0: 20 50 4f 53 49 58 20 69 66 20 74 68 65 0a 2a 2a POSIX if the.**
0900: 20 75 6e 64 65 72 6c 79 69 6e 67 20 6f 70 65 72 underlying oper
0910: 61 74 69 6e 67 20 73 79 73 74 65 6d 20 73 75 70 ating system sup
0920: 70 6f 72 74 73 20 69 74 2e 20 20 49 66 20 74 68 ports it. If th
0930: 65 20 4f 53 20 6c 61 63 6b 73 0a 2a 2a 20 6c 61 e OS lacks.** la
0940: 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 rge file support
0950: 2c 20 6f 72 20 69 66 20 74 68 65 20 4f 53 20 69 , or if the OS i
0960: 73 20 77 69 6e 64 6f 77 73 2c 20 74 68 65 73 65 s windows, these
0970: 20 73 68 6f 75 6c 64 20 62 65 20 6e 6f 2d 6f 70 should be no-op
0980: 73 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 20 s..**.** Ticket
0990: 23 32 37 33 39 3a 20 20 54 68 65 20 5f 4c 41 52 #2739: The _LAR
09a0: 47 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 6d 61 GEFILE_SOURCE ma
09b0: 63 72 6f 20 6d 75 73 74 20 61 70 70 65 61 72 20 cro must appear
09c0: 62 65 66 6f 72 65 20 61 6e 79 0a 2a 2a 20 73 79 before any.** sy
09d0: 73 74 65 6d 20 23 69 6e 63 6c 75 64 65 73 2e 20 stem #includes.
09e0: 20 48 65 6e 63 65 2c 20 74 68 69 73 20 62 6c 6f Hence, this blo
09f0: 63 6b 20 6f 66 20 63 6f 64 65 20 6d 75 73 74 20 ck of code must
0a00: 62 65 20 74 68 65 20 76 65 72 79 20 66 69 72 73 be the very firs
0a10: 74 0a 2a 2a 20 63 6f 64 65 20 69 6e 20 61 6c 6c t.** code in all
0a20: 20 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 2a source files..*
0a30: 2a 0a 2a 2a 20 4c 61 72 67 65 20 66 69 6c 65 20 *.** Large file
0a40: 73 75 70 70 6f 72 74 20 63 61 6e 20 62 65 20 64 support can be d
0a50: 69 73 61 62 6c 65 64 20 75 73 69 6e 67 20 74 68 isabled using th
0a60: 65 20 2d 44 53 51 4c 49 54 45 5f 44 49 53 41 42 e -DSQLITE_DISAB
0a70: 4c 45 5f 4c 46 53 20 73 77 69 74 63 68 0a 2a 2a LE_LFS switch.**
0a80: 20 6f 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 on the compiler
0a90: 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2e 20 20 command line.
0aa0: 54 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 This is necessar
0ab0: 79 20 69 66 20 79 6f 75 20 61 72 65 20 63 6f 6d y if you are com
0ac0: 70 69 6c 69 6e 67 0a 2a 2a 20 6f 6e 20 61 20 72 piling.** on a r
0ad0: 65 63 65 6e 74 20 6d 61 63 68 69 6e 65 20 28 65 ecent machine (e
0ae0: 78 3a 20 52 65 64 20 48 61 74 20 37 2e 32 29 20 x: Red Hat 7.2)
0af0: 62 75 74 20 79 6f 75 20 77 61 6e 74 20 79 6f 75 but you want you
0b00: 72 20 63 6f 64 65 20 74 6f 20 77 6f 72 6b 0a 2a r code to work.*
0b10: 2a 20 6f 6e 20 61 6e 20 6f 6c 64 65 72 20 6d 61 * on an older ma
0b20: 63 68 69 6e 65 20 28 65 78 3a 20 52 65 64 20 48 chine (ex: Red H
0b30: 61 74 20 36 2e 30 29 2e 20 20 49 66 20 79 6f 75 at 6.0). If you
0b40: 20 63 6f 6d 70 69 6c 65 20 6f 6e 20 52 65 64 20 compile on Red
0b50: 48 61 74 20 37 2e 32 0a 2a 2a 20 77 69 74 68 6f Hat 7.2.** witho
0b60: 75 74 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 ut this option,
0b70: 4c 46 53 20 69 73 20 65 6e 61 62 6c 65 2e 20 20 LFS is enable.
0b80: 42 75 74 20 4c 46 53 20 64 6f 65 73 20 6e 6f 74 But LFS does not
0b90: 20 65 78 69 73 74 20 69 6e 20 74 68 65 20 6b 65 exist in the ke
0ba0: 72 6e 65 6c 0a 2a 2a 20 69 6e 20 52 65 64 20 48 rnel.** in Red H
0bb0: 61 74 20 36 2e 30 2c 20 73 6f 20 74 68 65 20 63 at 6.0, so the c
0bc0: 6f 64 65 20 77 6f 6e 27 74 20 77 6f 72 6b 2e 20 ode won't work.
0bd0: 20 48 65 6e 63 65 2c 20 66 6f 72 20 6d 61 78 69 Hence, for maxi
0be0: 6d 75 6d 20 62 69 6e 61 72 79 0a 2a 2a 20 70 6f mum binary.** po
0bf0: 72 74 61 62 69 6c 69 74 79 20 79 6f 75 20 73 68 rtability you sh
0c00: 6f 75 6c 64 20 6f 6d 69 74 20 4c 46 53 2e 0a 2a ould omit LFS..*
0c10: 2a 0a 2a 2a 20 54 68 65 20 70 72 65 76 69 6f 75 *.** The previou
0c20: 73 20 70 61 72 61 67 72 61 70 68 20 77 61 73 20 s paragraph was
0c30: 77 72 69 74 74 65 6e 20 69 6e 20 32 30 30 35 2e written in 2005.
0c40: 20 20 28 54 68 69 73 20 70 61 72 61 67 72 61 70 (This paragrap
0c50: 68 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 h is written.**
0c60: 6f 6e 20 32 30 30 38 2d 31 31 2d 32 38 2e 29 20 on 2008-11-28.)
0c70: 54 68 65 73 65 20 64 61 79 73 2c 20 61 6c 6c 20 These days, all
0c80: 4c 69 6e 75 78 20 6b 65 72 6e 65 6c 73 20 73 75 Linux kernels su
0c90: 70 70 6f 72 74 20 6c 61 72 67 65 20 66 69 6c 65 pport large file
0ca0: 73 2c 20 73 6f 0a 2a 2a 20 79 6f 75 20 73 68 6f s, so.** you sho
0cb0: 75 6c 64 20 70 72 6f 62 61 62 6c 79 20 6c 65 61 uld probably lea
0cc0: 76 65 20 4c 46 53 20 65 6e 61 62 6c 65 64 2e 20 ve LFS enabled.
0cd0: 20 42 75 74 20 73 6f 6d 65 20 65 6d 62 65 64 64 But some embedd
0ce0: 65 64 20 70 6c 61 74 66 6f 72 6d 73 20 6d 69 67 ed platforms mig
0cf0: 68 74 0a 2a 2a 20 6c 61 63 6b 20 4c 46 53 20 69 ht.** lack LFS i
0d00: 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 n which case the
0d10: 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f SQLITE_DISABLE_
0d20: 4c 46 53 20 6d 61 63 72 6f 20 6d 69 67 68 74 20 LFS macro might
0d30: 73 74 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2e still be useful.
0d40: 0a 2a 2a 0a 2a 2a 20 53 69 6d 69 6c 61 72 20 69 .**.** Similar i
0d50: 73 20 74 72 75 65 20 66 6f 72 20 4d 61 63 20 4f s true for Mac O
0d60: 53 20 58 2e 20 20 4c 46 53 20 69 73 20 6f 6e 6c S X. LFS is onl
0d70: 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 4d y supported on M
0d80: 61 63 20 4f 53 20 58 20 39 20 61 6e 64 20 6c 61 ac OS X 9 and la
0d90: 74 65 72 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ter..*/.#ifndef
0da0: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c SQLITE_DISABLE_L
0db0: 46 53 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 FS.# define _LAR
0dc0: 47 45 5f 46 49 4c 45 20 20 20 20 20 20 20 31 0a GE_FILE 1.
0dd0: 23 20 69 66 6e 64 65 66 20 5f 46 49 4c 45 5f 4f # ifndef _FILE_O
0de0: 46 46 53 45 54 5f 42 49 54 53 0a 23 20 20 20 64 FFSET_BITS.# d
0df0: 65 66 69 6e 65 20 5f 46 49 4c 45 5f 4f 46 46 53 efine _FILE_OFFS
0e00: 45 54 5f 42 49 54 53 20 36 34 0a 23 20 65 6e 64 ET_BITS 64.# end
0e10: 69 66 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 if.# define _LAR
0e20: 47 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 31 0a GEFILE_SOURCE 1.
0e30: 23 65 6e 64 69 66 0a 0a 2f 2a 20 54 68 65 20 47 #endif../* The G
0e40: 43 43 5f 56 45 52 53 49 4f 4e 20 61 6e 64 20 4d CC_VERSION and M
0e50: 53 56 43 5f 56 45 52 53 49 4f 4e 20 6d 61 63 72 SVC_VERSION macr
0e60: 6f 73 20 61 72 65 20 75 73 65 64 20 74 6f 0a 2a os are used to.*
0e70: 2a 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 6c 79 20 * conditionally
0e80: 69 6e 63 6c 75 64 65 20 6f 70 74 69 6d 69 7a 61 include optimiza
0e90: 74 69 6f 6e 73 20 66 6f 72 20 65 61 63 68 20 6f tions for each o
0ea0: 66 20 74 68 65 73 65 20 63 6f 6d 70 69 6c 65 72 f these compiler
0eb0: 73 2e 20 20 41 0a 2a 2a 20 76 61 6c 75 65 20 6f s. A.** value o
0ec0: 66 20 30 20 6d 65 61 6e 73 20 74 68 61 74 20 63 f 0 means that c
0ed0: 6f 6d 70 69 6c 65 72 20 69 73 20 6e 6f 74 20 62 ompiler is not b
0ee0: 65 69 6e 67 20 75 73 65 64 2e 20 20 54 68 65 0a eing used. The.
0ef0: 2a 2a 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c ** SQLITE_DISABL
0f00: 45 5f 49 4e 54 52 49 4e 53 49 43 20 6d 61 63 72 E_INTRINSIC macr
0f10: 6f 20 6d 65 61 6e 73 20 64 6f 20 6e 6f 74 20 75 o means do not u
0f20: 73 65 20 61 6e 79 20 63 6f 6d 70 69 6c 65 72 2d se any compiler-
0f30: 73 70 65 63 69 66 69 63 0a 2a 2a 20 6f 70 74 69 specific.** opti
0f40: 6d 69 7a 61 74 69 6f 6e 73 2c 20 61 6e 64 20 68 mizations, and h
0f50: 65 6e 63 65 20 73 65 74 20 61 6c 6c 20 63 6f 6d ence set all com
0f60: 70 69 6c 65 72 20 6d 61 63 72 6f 73 20 74 6f 20 piler macros to
0f70: 30 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 77 61 0.**.** There wa
0f80: 73 20 6f 6e 63 65 20 61 6c 73 6f 20 61 20 43 4c s once also a CL
0f90: 41 4e 47 5f 56 45 52 53 49 4f 4e 20 6d 61 63 72 ANG_VERSION macr
0fa0: 6f 2e 20 20 48 6f 77 65 76 65 72 2c 20 77 65 20 o. However, we
0fb0: 6c 65 61 72 6e 20 74 68 61 74 20 74 68 65 0a 2a learn that the.*
0fc0: 2a 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 * version number
0fd0: 73 20 69 6e 20 63 6c 61 6e 67 20 61 72 65 20 66 s in clang are f
0fe0: 6f 72 20 22 6d 61 72 6b 65 74 69 6e 67 22 20 6f or "marketing" o
0ff0: 6e 6c 79 20 61 6e 64 20 61 72 65 20 69 6e 63 6f nly and are inco
1000: 6e 73 69 73 74 65 6e 74 0a 2a 2a 20 61 6e 64 20 nsistent.** and
1010: 75 6e 72 65 6c 69 61 62 6c 65 2e 20 20 46 6f 72 unreliable. For
1020: 74 75 6e 61 74 65 6c 79 2c 20 61 6c 6c 20 76 65 tunately, all ve
1030: 72 73 69 6f 6e 73 20 6f 66 20 63 6c 61 6e 67 20 rsions of clang
1040: 61 6c 73 6f 20 72 65 63 6f 67 6e 69 7a 65 20 74 also recognize t
1050: 68 65 0a 2a 2a 20 67 63 63 20 76 65 72 73 69 6f he.** gcc versio
1060: 6e 20 6e 75 6d 62 65 72 73 20 61 6e 64 20 68 61 n numbers and ha
1070: 76 65 20 72 65 61 73 6f 6e 61 62 6c 65 20 73 65 ve reasonable se
1080: 74 74 69 6e 67 73 20 66 6f 72 20 67 63 63 20 76 ttings for gcc v
1090: 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 73 2c 0a ersion numbers,.
10a0: 2a 2a 20 73 6f 20 74 68 65 20 47 43 43 5f 56 45 ** so the GCC_VE
10b0: 52 53 49 4f 4e 20 6d 61 63 72 6f 20 77 69 6c 6c RSION macro will
10c0: 20 62 65 20 73 65 74 20 74 6f 20 61 20 63 6f 72 be set to a cor
10d0: 72 65 63 74 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 rect non-zero va
10e0: 6c 75 65 20 65 76 65 6e 0a 2a 2a 20 77 68 65 6e lue even.** when
10f0: 20 63 6f 6d 70 69 6c 69 6e 67 20 77 69 74 68 20 compiling with
1100: 63 6c 61 6e 67 2e 0a 2a 2f 0a 23 69 66 20 64 65 clang..*/.#if de
1110: 66 69 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 fined(__GNUC__)
1120: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
1130: 54 45 5f 44 49 53 41 42 4c 45 5f 49 4e 54 52 49 TE_DISABLE_INTRI
1140: 4e 53 49 43 29 0a 23 20 64 65 66 69 6e 65 20 47 NSIC).# define G
1150: 43 43 5f 56 45 52 53 49 4f 4e 20 28 5f 5f 47 4e CC_VERSION (__GN
1160: 55 43 5f 5f 2a 31 30 30 30 30 30 30 2b 5f 5f 47 UC__*1000000+__G
1170: 4e 55 43 5f 4d 49 4e 4f 52 5f 5f 2a 31 30 30 30 NUC_MINOR__*1000
1180: 2b 5f 5f 47 4e 55 43 5f 50 41 54 43 48 4c 45 56 +__GNUC_PATCHLEV
1190: 45 4c 5f 5f 29 0a 23 65 6c 73 65 0a 23 20 64 65 EL__).#else.# de
11a0: 66 69 6e 65 20 47 43 43 5f 56 45 52 53 49 4f 4e fine GCC_VERSION
11b0: 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 0.#endif.#if de
11c0: 66 69 6e 65 64 28 5f 4d 53 43 5f 56 45 52 29 20 fined(_MSC_VER)
11d0: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
11e0: 54 45 5f 44 49 53 41 42 4c 45 5f 49 4e 54 52 49 TE_DISABLE_INTRI
11f0: 4e 53 49 43 29 0a 23 20 64 65 66 69 6e 65 20 4d NSIC).# define M
1200: 53 56 43 5f 56 45 52 53 49 4f 4e 20 5f 4d 53 43 SVC_VERSION _MSC
1210: 5f 56 45 52 0a 23 65 6c 73 65 0a 23 20 64 65 66 _VER.#else.# def
1220: 69 6e 65 20 4d 53 56 43 5f 56 45 52 53 49 4f 4e ine MSVC_VERSION
1230: 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 4e 65 0.#endif../* Ne
1240: 65 64 65 64 20 66 6f 72 20 76 61 72 69 6f 75 73 eded for various
1250: 20 64 65 66 69 6e 69 74 69 6f 6e 73 2e 2e 2e 20 definitions...
1260: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f */.#if defined(_
1270: 5f 47 4e 55 43 5f 5f 29 20 26 26 20 21 64 65 66 _GNUC__) && !def
1280: 69 6e 65 64 28 5f 47 4e 55 5f 53 4f 55 52 43 45 ined(_GNU_SOURCE
1290: 29 0a 23 20 64 65 66 69 6e 65 20 5f 47 4e 55 5f ).# define _GNU_
12a0: 53 4f 55 52 43 45 0a 23 65 6e 64 69 66 0a 0a 23 SOURCE.#endif..#
12b0: 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 4f 70 65 if defined(__Ope
12c0: 6e 42 53 44 5f 5f 29 20 26 26 20 21 64 65 66 69 nBSD__) && !defi
12d0: 6e 65 64 28 5f 42 53 44 5f 53 4f 55 52 43 45 29 ned(_BSD_SOURCE)
12e0: 0a 23 20 64 65 66 69 6e 65 20 5f 42 53 44 5f 53 .# define _BSD_S
12f0: 4f 55 52 43 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a OURCE.#endif../*
1300: 0a 2a 2a 20 46 6f 72 20 4d 69 6e 47 57 2c 20 63 .** For MinGW, c
1310: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 77 heck to see if w
1320: 65 20 63 61 6e 20 69 6e 63 6c 75 64 65 20 74 68 e can include th
1330: 65 20 68 65 61 64 65 72 20 66 69 6c 65 20 63 6f e header file co
1340: 6e 74 61 69 6e 69 6e 67 20 69 74 73 0a 2a 2a 20 ntaining its.**
1350: 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 version informat
1360: 69 6f 6e 2c 20 61 6d 6f 6e 67 20 6f 74 68 65 72 ion, among other
1370: 20 74 68 69 6e 67 73 2e 20 20 4e 6f 72 6d 61 6c things. Normal
1380: 6c 79 2c 20 74 68 69 73 20 69 6e 74 65 72 6e 61 ly, this interna
1390: 6c 20 4d 69 6e 47 57 0a 2a 2a 20 68 65 61 64 65 l MinGW.** heade
13a0: 72 20 66 69 6c 65 20 77 6f 75 6c 64 20 5b 6f 6e r file would [on
13b0: 6c 79 5d 20 62 65 20 69 6e 63 6c 75 64 65 64 20 ly] be included
13c0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 automatically by
13d0: 20 6f 74 68 65 72 20 4d 69 6e 47 57 20 68 65 61 other MinGW hea
13e0: 64 65 72 0a 2a 2a 20 66 69 6c 65 73 3b 20 68 6f der.** files; ho
13f0: 77 65 76 65 72 2c 20 74 68 65 20 63 6f 6e 74 61 wever, the conta
1400: 69 6e 65 64 20 76 65 72 73 69 6f 6e 20 69 6e 66 ined version inf
1410: 6f 72 6d 61 74 69 6f 6e 20 69 73 20 6e 6f 77 20 ormation is now
1420: 72 65 71 75 69 72 65 64 20 62 79 20 74 68 69 73 required by this
1430: 0a 2a 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20 .** header file
1440: 74 6f 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 62 to work around b
1450: 69 6e 61 72 79 20 63 6f 6d 70 61 74 69 62 69 6c inary compatibil
1460: 69 74 79 20 69 73 73 75 65 73 20 28 73 65 65 20 ity issues (see
1470: 62 65 6c 6f 77 29 20 61 6e 64 0a 2a 2a 20 74 68 below) and.** th
1480: 69 73 20 69 73 20 74 68 65 20 6f 6e 6c 79 20 6b is is the only k
1490: 6e 6f 77 6e 20 77 61 79 20 74 6f 20 72 65 6c 69 nown way to reli
14a0: 61 62 6c 79 20 6f 62 74 61 69 6e 20 69 74 2e 20 ably obtain it.
14b0: 20 54 68 69 73 20 65 6e 74 69 72 65 20 23 69 66 This entire #if
14c0: 20 62 6c 6f 63 6b 0a 2a 2a 20 77 6f 75 6c 64 20 block.** would
14d0: 62 65 20 63 6f 6d 70 6c 65 74 65 6c 79 20 75 6e be completely un
14e0: 6e 65 63 65 73 73 61 72 79 20 69 66 20 74 68 65 necessary if the
14f0: 72 65 20 77 61 73 20 61 6e 79 20 6f 74 68 65 72 re was any other
1500: 20 77 61 79 20 6f 66 20 64 65 74 65 63 74 69 6e way of detectin
1510: 67 0a 2a 2a 20 4d 69 6e 47 57 20 76 69 61 20 74 g.** MinGW via t
1520: 68 65 69 72 20 70 72 65 70 72 6f 63 65 73 73 6f heir preprocesso
1530: 72 20 28 65 2e 67 2e 20 69 66 20 74 68 65 79 20 r (e.g. if they
1540: 63 75 73 74 6f 6d 69 7a 65 64 20 74 68 65 69 72 customized their
1550: 20 47 43 43 20 74 6f 20 64 65 66 69 6e 65 0a 2a GCC to define.*
1560: 2a 20 73 6f 6d 65 20 4d 69 6e 47 57 2d 73 70 65 * some MinGW-spe
1570: 63 69 66 69 63 20 6d 61 63 72 6f 73 29 2e 20 20 cific macros).
1580: 57 68 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 66 When compiling f
1590: 6f 72 20 4d 69 6e 47 57 2c 20 65 69 74 68 65 72 or MinGW, either
15a0: 20 74 68 65 0a 2a 2a 20 5f 48 41 56 45 5f 4d 49 the.** _HAVE_MI
15b0: 4e 47 57 5f 48 20 6f 72 20 5f 48 41 56 45 5f 5f NGW_H or _HAVE__
15c0: 4d 49 4e 47 57 5f 48 20 28 6e 6f 74 65 20 74 68 MINGW_H (note th
15d0: 65 20 65 78 74 72 61 20 75 6e 64 65 72 73 63 6f e extra undersco
15e0: 72 65 29 20 6d 61 63 72 6f 20 6d 75 73 74 20 62 re) macro must b
15f0: 65 0a 2a 2a 20 64 65 66 69 6e 65 64 3b 20 6f 74 e.** defined; ot
1600: 68 65 72 77 69 73 65 2c 20 64 65 74 65 63 74 69 herwise, detecti
1610: 6f 6e 20 6f 66 20 63 6f 6e 64 69 74 69 6f 6e 73 on of conditions
1620: 20 73 70 65 63 69 66 69 63 20 74 6f 20 4d 69 6e specific to Min
1630: 47 57 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 64 69 GW will be.** di
1640: 73 61 62 6c 65 64 2e 0a 2a 2f 0a 23 69 66 20 64 sabled..*/.#if d
1650: 65 66 69 6e 65 64 28 5f 48 41 56 45 5f 4d 49 4e efined(_HAVE_MIN
1660: 47 57 5f 48 29 0a 23 20 69 6e 63 6c 75 64 65 20 GW_H).# include
1670: 22 6d 69 6e 67 77 2e 68 22 0a 23 65 6c 69 66 20 "mingw.h".#elif
1680: 64 65 66 69 6e 65 64 28 5f 48 41 56 45 5f 5f 4d defined(_HAVE__M
1690: 49 4e 47 57 5f 48 29 0a 23 20 69 6e 63 6c 75 64 INGW_H).# includ
16a0: 65 20 22 5f 6d 69 6e 67 77 2e 68 22 0a 23 65 6e e "_mingw.h".#en
16b0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 4d dif../*.** For M
16c0: 69 6e 47 57 20 76 65 72 73 69 6f 6e 20 34 2e 78 inGW version 4.x
16d0: 20 28 61 6e 64 20 68 69 67 68 65 72 29 2c 20 63 (and higher), c
16e0: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 74 heck to see if t
16f0: 68 65 20 5f 55 53 45 5f 33 32 42 49 54 5f 54 49 he _USE_32BIT_TI
1700: 4d 45 5f 54 0a 2a 2a 20 64 65 66 69 6e 65 20 69 ME_T.** define i
1710: 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 6d 61 s required to ma
1720: 69 6e 74 61 69 6e 20 62 69 6e 61 72 79 20 63 6f intain binary co
1730: 6d 70 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 mpatibility with
1740: 20 74 68 65 20 4d 53 56 43 20 72 75 6e 74 69 6d the MSVC runtim
1750: 65 0a 2a 2a 20 6c 69 62 72 61 72 79 20 69 6e 20 e.** library in
1760: 75 73 65 20 28 65 2e 67 2e 20 66 6f 72 20 57 69 use (e.g. for Wi
1770: 6e 64 6f 77 73 20 58 50 29 2e 0a 2a 2f 0a 23 69 ndows XP)..*/.#i
1780: 66 20 21 64 65 66 69 6e 65 64 28 5f 55 53 45 5f f !defined(_USE_
1790: 33 32 42 49 54 5f 54 49 4d 45 5f 54 29 20 26 26 32BIT_TIME_T) &&
17a0: 20 21 64 65 66 69 6e 65 64 28 5f 55 53 45 5f 36 !defined(_USE_6
17b0: 34 42 49 54 5f 54 49 4d 45 5f 54 29 20 26 26 20 4BIT_TIME_T) &&
17c0: 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 28 5f 57 \. defined(_W
17d0: 49 4e 33 32 29 20 26 26 20 21 64 65 66 69 6e 65 IN32) && !define
17e0: 64 28 5f 57 49 4e 36 34 29 20 26 26 20 5c 0a 20 d(_WIN64) && \.
17f0: 20 20 20 64 65 66 69 6e 65 64 28 5f 5f 4d 49 4e defined(__MIN
1800: 47 57 5f 4d 41 4a 4f 52 5f 56 45 52 53 49 4f 4e GW_MAJOR_VERSION
1810: 29 20 26 26 20 5f 5f 4d 49 4e 47 57 5f 4d 41 4a ) && __MINGW_MAJ
1820: 4f 52 5f 56 45 52 53 49 4f 4e 20 3e 3d 20 34 20 OR_VERSION >= 4
1830: 26 26 20 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 && \. defined
1840: 28 5f 5f 4d 53 56 43 52 54 5f 5f 29 0a 23 20 64 (__MSVCRT__).# d
1850: 65 66 69 6e 65 20 5f 55 53 45 5f 33 32 42 49 54 efine _USE_32BIT
1860: 5f 54 49 4d 45 5f 54 0a 23 65 6e 64 69 66 0a 0a _TIME_T.#endif..
1870: 2f 2a 20 54 68 65 20 70 75 62 6c 69 63 20 53 51 /* The public SQ
1880: 4c 69 74 65 20 69 6e 74 65 72 66 61 63 65 2e 20 Lite interface.
1890: 20 54 68 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 The _FILE_OFFSE
18a0: 54 5f 42 49 54 53 20 6d 61 63 72 6f 20 6d 75 73 T_BITS macro mus
18b0: 74 20 61 70 70 65 61 72 0a 2a 2a 20 66 69 72 73 t appear.** firs
18c0: 74 20 69 6e 20 51 4e 58 2e 20 20 41 6c 73 6f 2c t in QNX. Also,
18d0: 20 74 68 65 20 5f 55 53 45 5f 33 32 42 49 54 5f the _USE_32BIT_
18e0: 54 49 4d 45 5f 54 20 6d 61 63 72 6f 20 6d 75 73 TIME_T macro mus
18f0: 74 20 61 70 70 65 61 72 20 66 69 72 73 74 20 66 t appear first f
1900: 6f 72 0a 2a 2a 20 4d 69 6e 47 57 2e 0a 2a 2f 0a or.** MinGW..*/.
1910: 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 #include "sqlite
1920: 33 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 3.h"../*.** Incl
1930: 75 64 65 20 74 68 65 20 63 6f 6e 66 69 67 75 72 ude the configur
1940: 61 74 69 6f 6e 20 68 65 61 64 65 72 20 6f 75 74 ation header out
1950: 70 75 74 20 62 79 20 27 63 6f 6e 66 69 67 75 72 put by 'configur
1960: 65 27 20 69 66 20 77 65 27 72 65 20 75 73 69 6e e' if we're usin
1970: 67 20 74 68 65 0a 2a 2a 20 61 75 74 6f 63 6f 6e g the.** autocon
1980: 66 2d 62 61 73 65 64 20 62 75 69 6c 64 0a 2a 2f f-based build.*/
1990: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 48 41 .#if defined(_HA
19a0: 56 45 5f 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 VE_SQLITE_CONFIG
19b0: 5f 48 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 _H) && !defined(
19c0: 53 51 4c 49 54 45 43 4f 4e 46 49 47 5f 48 29 0a SQLITECONFIG_H).
19d0: 23 69 6e 63 6c 75 64 65 20 22 63 6f 6e 66 69 67 #include "config
19e0: 2e 68 22 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .h".#define SQLI
19f0: 54 45 43 4f 4e 46 49 47 5f 48 20 31 0a 23 65 6e TECONFIG_H 1.#en
1a00: 64 69 66 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 dif..#include "s
1a10: 71 6c 69 74 65 4c 69 6d 69 74 2e 68 22 0a 0a 2f qliteLimit.h"../
1a20: 2a 20 44 69 73 61 62 6c 65 20 6e 75 69 73 61 6e * Disable nuisan
1a30: 63 65 20 77 61 72 6e 69 6e 67 73 20 6f 6e 20 42 ce warnings on B
1a40: 6f 72 6c 61 6e 64 20 63 6f 6d 70 69 6c 65 72 73 orland compilers
1a50: 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 */.#if defined(
1a60: 5f 5f 42 4f 52 4c 41 4e 44 43 5f 5f 29 0a 23 70 __BORLANDC__).#p
1a70: 72 61 67 6d 61 20 77 61 72 6e 20 2d 72 63 68 20 ragma warn -rch
1a80: 2f 2a 20 75 6e 72 65 61 63 68 61 62 6c 65 20 63 /* unreachable c
1a90: 6f 64 65 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 ode */.#pragma w
1aa0: 61 72 6e 20 2d 63 63 63 20 2f 2a 20 43 6f 6e 64 arn -ccc /* Cond
1ab0: 69 74 69 6f 6e 20 69 73 20 61 6c 77 61 79 73 20 ition is always
1ac0: 74 72 75 65 20 6f 72 20 66 61 6c 73 65 20 2a 2f true or false */
1ad0: 0a 23 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 61 .#pragma warn -a
1ae0: 75 73 20 2f 2a 20 41 73 73 69 67 6e 65 64 20 76 us /* Assigned v
1af0: 61 6c 75 65 20 69 73 20 6e 65 76 65 72 20 75 73 alue is never us
1b00: 65 64 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 ed */.#pragma wa
1b10: 72 6e 20 2d 63 73 75 20 2f 2a 20 43 6f 6d 70 61 rn -csu /* Compa
1b20: 72 69 6e 67 20 73 69 67 6e 65 64 20 61 6e 64 20 ring signed and
1b30: 75 6e 73 69 67 6e 65 64 20 2a 2f 0a 23 70 72 61 unsigned */.#pra
1b40: 67 6d 61 20 77 61 72 6e 20 2d 73 70 61 20 2f 2a gma warn -spa /*
1b50: 20 53 75 73 70 69 63 69 6f 75 73 20 70 6f 69 6e Suspicious poin
1b60: 74 65 72 20 61 72 69 74 68 6d 65 74 69 63 20 2a ter arithmetic *
1b70: 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 /.#endif../*.**
1b80: 49 6e 63 6c 75 64 65 20 73 74 61 6e 64 61 72 64 Include standard
1b90: 20 68 65 61 64 65 72 20 66 69 6c 65 73 20 61 73 header files as
1ba0: 20 6e 65 63 65 73 73 61 72 79 0a 2a 2f 0a 23 69 necessary.*/.#i
1bb0: 66 64 65 66 20 48 41 56 45 5f 53 54 44 49 4e 54 fdef HAVE_STDINT
1bc0: 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 _H.#include <std
1bd0: 69 6e 74 2e 68 3e 0a 23 65 6e 64 69 66 0a 23 69 int.h>.#endif.#i
1be0: 66 64 65 66 20 48 41 56 45 5f 49 4e 54 54 59 50 fdef HAVE_INTTYP
1bf0: 45 53 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c 69 ES_H.#include <i
1c00: 6e 74 74 79 70 65 73 2e 68 3e 0a 23 65 6e 64 69 nttypes.h>.#endi
1c10: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c f../*.** The fol
1c20: 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 lowing macros ar
1c30: 65 20 75 73 65 64 20 74 6f 20 63 61 73 74 20 70 e used to cast p
1c40: 6f 69 6e 74 65 72 73 20 74 6f 20 69 6e 74 65 67 ointers to integ
1c50: 65 72 73 20 61 6e 64 0a 2a 2a 20 69 6e 74 65 67 ers and.** integ
1c60: 65 72 73 20 74 6f 20 70 6f 69 6e 74 65 72 73 2e ers to pointers.
1c70: 20 20 54 68 65 20 77 61 79 20 79 6f 75 20 64 6f The way you do
1c80: 20 74 68 69 73 20 76 61 72 69 65 73 20 66 72 6f this varies fro
1c90: 6d 20 6f 6e 65 20 63 6f 6d 70 69 6c 65 72 0a 2a m one compiler.*
1ca0: 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 2c 20 73 * to the next, s
1cb0: 6f 20 77 65 20 68 61 76 65 20 64 65 76 65 6c 6f o we have develo
1cc0: 70 65 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e ped the followin
1cd0: 67 20 73 65 74 20 6f 66 20 23 69 66 20 73 74 61 g set of #if sta
1ce0: 74 65 6d 65 6e 74 73 0a 2a 2a 20 74 6f 20 67 65 tements.** to ge
1cf0: 6e 65 72 61 74 65 20 61 70 70 72 6f 70 72 69 61 nerate appropria
1d00: 74 65 20 6d 61 63 72 6f 73 20 66 6f 72 20 61 20 te macros for a
1d10: 77 69 64 65 20 72 61 6e 67 65 20 6f 66 20 63 6f wide range of co
1d20: 6d 70 69 6c 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 54 mpilers..**.** T
1d30: 68 65 20 63 6f 72 72 65 63 74 20 22 41 4e 53 49 he correct "ANSI
1d40: 22 20 77 61 79 20 74 6f 20 64 6f 20 74 68 69 73 " way to do this
1d50: 20 69 73 20 74 6f 20 75 73 65 20 74 68 65 20 69 is to use the i
1d60: 6e 74 70 74 72 5f 74 20 74 79 70 65 2e 0a 2a 2a ntptr_t type..**
1d70: 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c 79 2c 20 Unfortunately,
1d80: 74 68 61 74 20 74 79 70 65 64 65 66 20 69 73 20 that typedef is
1d90: 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e not available on
1da0: 20 61 6c 6c 20 63 6f 6d 70 69 6c 65 72 73 2c 20 all compilers,
1db0: 6f 72 0a 2a 2a 20 69 66 20 69 74 20 69 73 20 61 or.** if it is a
1dc0: 76 61 69 6c 61 62 6c 65 2c 20 69 74 20 72 65 71 vailable, it req
1dd0: 75 69 72 65 73 20 61 6e 20 23 69 6e 63 6c 75 64 uires an #includ
1de0: 65 20 6f 66 20 73 70 65 63 69 66 69 63 20 68 65 e of specific he
1df0: 61 64 65 72 73 0a 2a 2a 20 74 68 61 74 20 76 61 aders.** that va
1e00: 72 79 20 66 72 6f 6d 20 6f 6e 65 20 6d 61 63 68 ry from one mach
1e10: 69 6e 65 20 74 6f 20 74 68 65 20 6e 65 78 74 2e ine to the next.
1e20: 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 20 23 33 .**.** Ticket #3
1e30: 38 36 30 3a 20 20 54 68 65 20 6c 6c 76 6d 2d 67 860: The llvm-g
1e40: 63 63 2d 34 2e 32 20 63 6f 6d 70 69 6c 65 72 20 cc-4.2 compiler
1e50: 66 72 6f 6d 20 41 70 70 6c 65 20 63 68 6f 6b 65 from Apple choke
1e60: 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 28 28 76 6f s on.** the ((vo
1e70: 69 64 2a 29 26 28 28 63 68 61 72 2a 29 30 29 5b id*)&((char*)0)[
1e80: 58 5d 29 20 63 6f 6e 73 74 72 75 63 74 2e 20 20 X]) construct.
1e90: 42 75 74 20 4d 53 56 43 20 63 68 6f 6b 65 73 20 But MSVC chokes
1ea0: 6f 6e 20 28 28 76 6f 69 64 2a 29 28 58 29 29 2e on ((void*)(X)).
1eb0: 0a 2a 2a 20 53 6f 20 77 65 20 68 61 76 65 20 74 .** So we have t
1ec0: 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6d 61 63 o define the mac
1ed0: 72 6f 73 20 69 6e 20 64 69 66 66 65 72 65 6e 74 ros in different
1ee0: 20 77 61 79 73 20 64 65 70 65 6e 64 69 6e 67 20 ways depending
1ef0: 6f 6e 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 69 6c on the.** compil
1f00: 65 72 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e er..*/.#if defin
1f10: 65 64 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 50 ed(__PTRDIFF_TYP
1f20: 45 5f 5f 29 20 20 2f 2a 20 54 68 69 73 20 63 61 E__) /* This ca
1f30: 73 65 20 73 68 6f 75 6c 64 20 77 6f 72 6b 20 66 se should work f
1f40: 6f 72 20 47 43 43 20 2a 2f 0a 23 20 64 65 66 69 or GCC */.# defi
1f50: 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f ne SQLITE_INT_TO
1f60: 5f 50 54 52 28 58 29 20 20 28 28 76 6f 69 64 2a _PTR(X) ((void*
1f70: 29 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 50 45 )(__PTRDIFF_TYPE
1f80: 5f 5f 29 28 58 29 29 0a 23 20 64 65 66 69 6e 65 __)(X)).# define
1f90: 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 SQLITE_PTR_TO_I
1fa0: 4e 54 28 58 29 20 20 28 28 69 6e 74 29 28 5f 5f NT(X) ((int)(__
1fb0: 50 54 52 44 49 46 46 5f 54 59 50 45 5f 5f 29 28 PTRDIFF_TYPE__)(
1fc0: 58 29 29 0a 23 65 6c 69 66 20 21 64 65 66 69 6e X)).#elif !defin
1fd0: 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 20 20 20 ed(__GNUC__)
1fe0: 20 20 20 2f 2a 20 57 6f 72 6b 73 20 66 6f 72 20 /* Works for
1ff0: 63 6f 6d 70 69 6c 65 72 73 20 6f 74 68 65 72 20 compilers other
2000: 74 68 61 6e 20 4c 4c 56 4d 20 2a 2f 0a 23 20 64 than LLVM */.# d
2010: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 efine SQLITE_INT
2020: 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f _TO_PTR(X) ((vo
2030: 69 64 2a 29 26 28 28 63 68 61 72 2a 29 30 29 5b id*)&((char*)0)[
2040: 58 5d 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c X]).# define SQL
2050: 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 ITE_PTR_TO_INT(X
2060: 29 20 20 28 28 69 6e 74 29 28 28 28 63 68 61 72 ) ((int)(((char
2070: 2a 29 58 29 2d 28 63 68 61 72 2a 29 30 29 29 0a *)X)-(char*)0)).
2080: 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 48 41 #elif defined(HA
2090: 56 45 5f 53 54 44 49 4e 54 5f 48 29 20 20 20 2f VE_STDINT_H) /
20a0: 2a 20 55 73 65 20 74 68 69 73 20 63 61 73 65 20 * Use this case
20b0: 69 66 20 77 65 20 68 61 76 65 20 41 4e 53 49 20 if we have ANSI
20c0: 68 65 61 64 65 72 73 20 2a 2f 0a 23 20 64 65 66 headers */.# def
20d0: 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 ine SQLITE_INT_T
20e0: 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f 69 64 O_PTR(X) ((void
20f0: 2a 29 28 69 6e 74 70 74 72 5f 74 29 28 58 29 29 *)(intptr_t)(X))
2100: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
2110: 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 20 _PTR_TO_INT(X)
2120: 28 28 69 6e 74 29 28 69 6e 74 70 74 72 5f 74 29 ((int)(intptr_t)
2130: 28 58 29 29 0a 23 65 6c 73 65 20 20 20 20 20 20 (X)).#else
2140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2150: 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 65 73 /* Generates
2160: 20 61 20 77 61 72 6e 69 6e 67 20 2d 20 62 75 74 a warning - but
2170: 20 69 74 20 61 6c 77 61 79 73 20 77 6f 72 6b 73 it always works
2180: 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c */.# define SQL
2190: 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 ITE_INT_TO_PTR(X
21a0: 29 20 20 28 28 76 6f 69 64 2a 29 28 58 29 29 0a ) ((void*)(X)).
21b0: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
21c0: 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 20 28 PTR_TO_INT(X) (
21d0: 28 69 6e 74 29 28 58 29 29 0a 23 65 6e 64 69 66 (int)(X)).#endif
21e0: 0a 0a 2f 2a 0a 2a 2a 20 41 20 6d 61 63 72 6f 20 ../*.** A macro
21f0: 74 6f 20 68 69 6e 74 20 74 6f 20 74 68 65 20 63 to hint to the c
2200: 6f 6d 70 69 6c 65 72 20 74 68 61 74 20 61 20 66 ompiler that a f
2210: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 6e unction should n
2220: 6f 74 20 62 65 0a 2a 2a 20 69 6e 6c 69 6e 65 64 ot be.** inlined
2230: 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 ..*/.#if defined
2240: 28 5f 5f 47 4e 55 43 5f 5f 29 0a 23 20 20 64 65 (__GNUC__).# de
2250: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 49 4e fine SQLITE_NOIN
2260: 4c 49 4e 45 20 20 5f 5f 61 74 74 72 69 62 75 74 LINE __attribut
2270: 65 5f 5f 28 28 6e 6f 69 6e 6c 69 6e 65 29 29 0a e__((noinline)).
2280: 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 5f 4d #elif defined(_M
2290: 53 43 5f 56 45 52 29 20 26 26 20 5f 4d 53 43 5f SC_VER) && _MSC_
22a0: 56 45 52 3e 3d 31 33 31 30 0a 23 20 20 64 65 66 VER>=1310.# def
22b0: 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c ine SQLITE_NOINL
22c0: 49 4e 45 20 20 5f 5f 64 65 63 6c 73 70 65 63 28 INE __declspec(
22d0: 6e 6f 69 6e 6c 69 6e 65 29 0a 23 65 6c 73 65 0a noinline).#else.
22e0: 23 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 # define SQLITE
22f0: 5f 4e 4f 49 4e 4c 49 4e 45 0a 23 65 6e 64 69 66 _NOINLINE.#endif
2300: 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 73 75 72 ../*.** Make sur
2310: 65 20 74 68 61 74 20 74 68 65 20 63 6f 6d 70 69 e that the compi
2320: 6c 65 72 20 69 6e 74 72 69 6e 73 69 63 73 20 77 ler intrinsics w
2330: 65 20 64 65 73 69 72 65 20 61 72 65 20 65 6e 61 e desire are ena
2340: 62 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 63 6f 6d bled when.** com
2350: 70 69 6c 69 6e 67 20 77 69 74 68 20 61 6e 20 61 piling with an a
2360: 70 70 72 6f 70 72 69 61 74 65 20 76 65 72 73 69 ppropriate versi
2370: 6f 6e 20 6f 66 20 4d 53 56 43 20 75 6e 6c 65 73 on of MSVC unles
2380: 73 20 70 72 65 76 65 6e 74 65 64 20 62 79 0a 2a s prevented by.*
2390: 2a 20 74 68 65 20 53 51 4c 49 54 45 5f 44 49 53 * the SQLITE_DIS
23a0: 41 42 4c 45 5f 49 4e 54 52 49 4e 53 49 43 20 64 ABLE_INTRINSIC d
23b0: 65 66 69 6e 65 2e 0a 2a 2f 0a 23 69 66 20 21 64 efine..*/.#if !d
23c0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 49 efined(SQLITE_DI
23d0: 53 41 42 4c 45 5f 49 4e 54 52 49 4e 53 49 43 29 SABLE_INTRINSIC)
23e0: 0a 23 20 20 69 66 20 64 65 66 69 6e 65 64 28 5f .# if defined(_
23f0: 4d 53 43 5f 56 45 52 29 20 26 26 20 5f 4d 53 43 MSC_VER) && _MSC
2400: 5f 56 45 52 3e 3d 31 34 30 30 0a 23 20 20 20 20 _VER>=1400.#
2410: 69 66 20 21 64 65 66 69 6e 65 64 28 5f 57 49 4e if !defined(_WIN
2420: 33 32 5f 57 43 45 29 0a 23 20 20 20 20 20 20 69 32_WCE).# i
2430: 6e 63 6c 75 64 65 20 3c 69 6e 74 72 69 6e 2e 68 nclude <intrin.h
2440: 3e 0a 23 20 20 20 20 20 20 70 72 61 67 6d 61 20 >.# pragma
2450: 69 6e 74 72 69 6e 73 69 63 28 5f 62 79 74 65 73 intrinsic(_bytes
2460: 77 61 70 5f 75 73 68 6f 72 74 29 0a 23 20 20 20 wap_ushort).#
2470: 20 20 20 70 72 61 67 6d 61 20 69 6e 74 72 69 6e pragma intrin
2480: 73 69 63 28 5f 62 79 74 65 73 77 61 70 5f 75 6c sic(_byteswap_ul
2490: 6f 6e 67 29 0a 23 20 20 20 20 20 20 70 72 61 67 ong).# prag
24a0: 6d 61 20 69 6e 74 72 69 6e 73 69 63 28 5f 62 79 ma intrinsic(_by
24b0: 74 65 73 77 61 70 5f 75 69 6e 74 36 34 29 0a 23 teswap_uint64).#
24c0: 20 20 20 20 20 20 70 72 61 67 6d 61 20 69 6e 74 pragma int
24d0: 72 69 6e 73 69 63 28 5f 52 65 61 64 57 72 69 74 rinsic(_ReadWrit
24e0: 65 42 61 72 72 69 65 72 29 0a 23 20 20 20 20 65 eBarrier).# e
24f0: 6c 73 65 0a 23 20 20 20 20 20 20 69 6e 63 6c 75 lse.# inclu
2500: 64 65 20 3c 63 6d 6e 69 6e 74 72 69 6e 2e 68 3e de <cmnintrin.h>
2510: 0a 23 20 20 20 20 65 6e 64 69 66 0a 23 20 20 65 .# endif.# e
2520: 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a ndif.#endif../*.
2530: 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 54 48 ** The SQLITE_TH
2540: 52 45 41 44 53 41 46 45 20 6d 61 63 72 6f 20 6d READSAFE macro m
2550: 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 61 ust be defined a
2560: 73 20 30 2c 20 31 2c 20 6f 72 20 32 2e 0a 2a 2a s 0, 1, or 2..**
2570: 20 30 20 6d 65 61 6e 73 20 6d 75 74 65 78 65 73 0 means mutexes
2580: 20 61 72 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 are permanently
2590: 20 64 69 73 61 62 6c 65 20 61 6e 64 20 74 68 65 disable and the
25a0: 20 6c 69 62 72 61 72 79 20 69 73 20 6e 65 76 65 library is neve
25b0: 72 0a 2a 2a 20 74 68 72 65 61 64 73 61 66 65 2e r.** threadsafe.
25c0: 20 20 31 20 6d 65 61 6e 73 20 74 68 65 20 6c 69 1 means the li
25d0: 62 72 61 72 79 20 69 73 20 73 65 72 69 61 6c 69 brary is seriali
25e0: 7a 65 64 20 77 68 69 63 68 20 69 73 20 74 68 65 zed which is the
25f0: 20 68 69 67 68 65 73 74 0a 2a 2a 20 6c 65 76 65 highest.** leve
2600: 6c 20 6f 66 20 74 68 72 65 61 64 73 61 66 65 74 l of threadsafet
2610: 79 2e 20 20 32 20 6d 65 61 6e 73 20 74 68 65 20 y. 2 means the
2620: 6c 69 62 72 61 72 79 20 69 73 20 6d 75 6c 74 69 library is multi
2630: 74 68 72 65 61 64 65 64 20 2d 20 6d 75 6c 74 69 threaded - multi
2640: 70 6c 65 0a 2a 2a 20 74 68 72 65 61 64 73 20 63 ple.** threads c
2650: 61 6e 20 75 73 65 20 53 51 4c 69 74 65 20 61 73 an use SQLite as
2660: 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74 77 6f 20 long as no two
2670: 74 68 72 65 61 64 73 20 74 72 79 20 74 6f 20 75 threads try to u
2680: 73 65 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 64 se the same.** d
2690: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
26a0: 6f 6e 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 on at the same t
26b0: 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 4f 6c 64 65 72 ime..**.** Older
26c0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
26d0: 69 74 65 20 75 73 65 64 20 61 6e 20 6f 70 74 69 ite used an opti
26e0: 6f 6e 61 6c 20 54 48 52 45 41 44 53 41 46 45 20 onal THREADSAFE
26f0: 6d 61 63 72 6f 2e 0a 2a 2a 20 57 65 20 73 75 70 macro..** We sup
2700: 70 6f 72 74 20 74 68 61 74 20 66 6f 72 20 6c 65 port that for le
2710: 67 61 63 79 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 65 gacy..**.** To e
2720: 6e 73 75 72 65 20 74 68 61 74 20 74 68 65 20 63 nsure that the c
2730: 6f 72 72 65 63 74 20 76 61 6c 75 65 20 6f 66 20 orrect value of
2740: 22 54 48 52 45 41 44 53 41 46 45 22 20 69 73 20 "THREADSAFE" is
2750: 72 65 70 6f 72 74 65 64 20 77 68 65 6e 20 71 75 reported when qu
2760: 65 72 79 69 6e 67 0a 2a 2a 20 66 6f 72 20 63 6f erying.** for co
2770: 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f mpile-time optio
2780: 6e 73 20 61 74 20 72 75 6e 74 69 6d 65 20 28 65 ns at runtime (e
2790: 2e 67 2e 20 22 50 52 41 47 4d 41 20 63 6f 6d 70 .g. "PRAGMA comp
27a0: 69 6c 65 5f 6f 70 74 69 6f 6e 73 22 29 2c 20 74 ile_options"), t
27b0: 68 69 73 0a 2a 2a 20 6c 6f 67 69 63 20 69 73 20 his.** logic is
27c0: 70 61 72 74 69 61 6c 6c 79 20 72 65 70 6c 69 63 partially replic
27d0: 61 74 65 64 20 69 6e 20 63 74 69 6d 65 2e 63 2e ated in ctime.c.
27e0: 20 49 66 20 69 74 20 69 73 20 75 70 64 61 74 65 If it is update
27f0: 64 20 68 65 72 65 2c 20 69 74 20 73 68 6f 75 6c d here, it shoul
2800: 64 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 75 70 64 d.** also be upd
2810: 61 74 65 64 20 74 68 65 72 65 2e 0a 2a 2f 0a 23 ated there..*/.#
2820: 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
2830: 54 45 5f 54 48 52 45 41 44 53 41 46 45 29 0a 23 TE_THREADSAFE).#
2840: 20 69 66 20 64 65 66 69 6e 65 64 28 54 48 52 45 if defined(THRE
2850: 41 44 53 41 46 45 29 0a 23 20 20 20 64 65 66 69 ADSAFE).# defi
2860: 6e 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ne SQLITE_THREAD
2870: 53 41 46 45 20 54 48 52 45 41 44 53 41 46 45 0a SAFE THREADSAFE.
2880: 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 6e # else.# defin
2890: 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 e SQLITE_THREADS
28a0: 41 46 45 20 31 20 2f 2a 20 49 4d 50 3a 20 52 2d AFE 1 /* IMP: R-
28b0: 30 37 32 37 32 2d 32 32 33 30 39 20 2a 2f 0a 23 07272-22309 */.#
28c0: 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f endif.#endif../
28d0: 2a 0a 2a 2a 20 50 6f 77 65 72 73 61 66 65 20 6f *.** Powersafe o
28e0: 76 65 72 77 72 69 74 65 20 69 73 20 6f 6e 20 62 verwrite is on b
28f0: 79 20 64 65 66 61 75 6c 74 2e 20 20 42 75 74 20 y default. But
2900: 63 61 6e 20 62 65 20 74 75 72 6e 65 64 20 6f 66 can be turned of
2910: 66 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 2d f using.** the -
2920: 44 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 DSQLITE_POWERSAF
2930: 45 5f 4f 56 45 52 57 52 49 54 45 3d 30 20 63 6f E_OVERWRITE=0 co
2940: 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 6f mmand-line optio
2950: 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 n..*/.#ifndef SQ
2960: 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f LITE_POWERSAFE_O
2970: 56 45 52 57 52 49 54 45 0a 23 20 64 65 66 69 6e VERWRITE.# defin
2980: 65 20 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 e SQLITE_POWERSA
2990: 46 45 5f 4f 56 45 52 57 52 49 54 45 20 31 0a 23 FE_OVERWRITE 1.#
29a0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 56 49 endif../*.** EVI
29b0: 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 35 37 31 DENCE-OF: R-2571
29c0: 35 2d 33 37 30 37 32 20 4d 65 6d 6f 72 79 20 61 5-37072 Memory a
29d0: 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 74 69 73 llocation statis
29e0: 74 69 63 73 20 61 72 65 20 65 6e 61 62 6c 65 64 tics are enabled
29f0: 20 62 79 0a 2a 2a 20 64 65 66 61 75 6c 74 20 75 by.** default u
2a00: 6e 6c 65 73 73 20 53 51 4c 69 74 65 20 69 73 20 nless SQLite is
2a10: 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 20 53 51 compiled with SQ
2a20: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 45 4d LITE_DEFAULT_MEM
2a30: 53 54 41 54 55 53 3d 30 20 69 6e 0a 2a 2a 20 77 STATUS=0 in.** w
2a40: 68 69 63 68 20 63 61 73 65 20 6d 65 6d 6f 72 79 hich case memory
2a50: 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 74 allocation stat
2a60: 69 73 74 69 63 73 20 61 72 65 20 64 69 73 61 62 istics are disab
2a70: 6c 65 64 20 62 79 20 64 65 66 61 75 6c 74 2e 0a led by default..
2a80: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
2a90: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
2aa0: 45 4d 53 54 41 54 55 53 29 0a 23 20 64 65 66 69 EMSTATUS).# defi
2ab0: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
2ac0: 54 5f 4d 45 4d 53 54 41 54 55 53 20 31 0a 23 65 T_MEMSTATUS 1.#e
2ad0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 78 61 63 ndif../*.** Exac
2ae0: 74 6c 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 tly one of the f
2af0: 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 ollowing macros
2b00: 6d 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 must be defined
2b10: 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 73 in order to.** s
2b20: 70 65 63 69 66 79 20 77 68 69 63 68 20 6d 65 6d pecify which mem
2b30: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 ory allocation s
2b40: 75 62 73 79 73 74 65 6d 20 74 6f 20 75 73 65 2e ubsystem to use.
2b50: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 .**.** SQLIT
2b60: 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 20 E_SYSTEM_MALLOC
2b70: 20 20 20 20 20 20 20 20 20 2f 2f 20 55 73 65 20 // Use
2b80: 6e 6f 72 6d 61 6c 20 73 79 73 74 65 6d 20 6d 61 normal system ma
2b90: 6c 6c 6f 63 28 29 0a 2a 2a 20 20 20 20 20 53 51 lloc().** SQ
2ba0: 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f LITE_WIN32_MALLO
2bb0: 43 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 55 C // U
2bc0: 73 65 20 57 69 6e 33 32 20 6e 61 74 69 76 65 20 se Win32 native
2bd0: 68 65 61 70 20 41 50 49 0a 2a 2a 20 20 20 20 20 heap API.**
2be0: 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c SQLITE_ZERO_MALL
2bf0: 4f 43 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f OC //
2c00: 20 55 73 65 20 61 20 73 74 75 62 20 61 6c 6c 6f Use a stub allo
2c10: 63 61 74 6f 72 20 74 68 61 74 20 61 6c 77 61 79 cator that alway
2c20: 73 20 66 61 69 6c 73 0a 2a 2a 20 20 20 20 20 53 s fails.** S
2c30: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 20 20 QLITE_MEMDEBUG
2c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 //
2c50: 44 65 62 75 67 67 69 6e 67 20 76 65 72 73 69 6f Debugging versio
2c60: 6e 20 6f 66 20 73 79 73 74 65 6d 20 6d 61 6c 6c n of system mall
2c70: 6f 63 28 29 0a 2a 2a 0a 2a 2a 20 4f 6e 20 57 69 oc().**.** On Wi
2c80: 6e 64 6f 77 73 2c 20 69 66 20 74 68 65 20 53 51 ndows, if the SQ
2c90: 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f LITE_WIN32_MALLO
2ca0: 43 5f 56 41 4c 49 44 41 54 45 20 6d 61 63 72 6f C_VALIDATE macro
2cb0: 20 69 73 20 64 65 66 69 6e 65 64 20 61 6e 64 20 is defined and
2cc0: 74 68 65 0a 2a 2a 20 61 73 73 65 72 74 28 29 20 the.** assert()
2cd0: 6d 61 63 72 6f 20 69 73 20 65 6e 61 62 6c 65 64 macro is enabled
2ce0: 2c 20 65 61 63 68 20 63 61 6c 6c 20 69 6e 74 6f , each call into
2cf0: 20 74 68 65 20 57 69 6e 33 32 20 6e 61 74 69 76 the Win32 nativ
2d00: 65 20 68 65 61 70 20 73 75 62 73 79 73 74 65 6d e heap subsystem
2d10: 0a 2a 2a 20 77 69 6c 6c 20 63 61 75 73 65 20 48 .** will cause H
2d20: 65 61 70 56 61 6c 69 64 61 74 65 20 74 6f 20 62 eapValidate to b
2d30: 65 20 63 61 6c 6c 65 64 2e 20 20 49 66 20 68 65 e called. If he
2d40: 61 70 20 76 61 6c 69 64 61 74 69 6f 6e 20 73 68 ap validation sh
2d50: 6f 75 6c 64 20 66 61 69 6c 2c 20 61 6e 0a 2a 2a ould fail, an.**
2d60: 20 61 73 73 65 72 74 69 6f 6e 20 77 69 6c 6c 20 assertion will
2d70: 62 65 20 74 72 69 67 67 65 72 65 64 2e 0a 2a 2a be triggered..**
2d80: 0a 2a 2a 20 49 66 20 6e 6f 6e 65 20 6f 66 20 74 .** If none of t
2d90: 68 65 20 61 62 6f 76 65 20 61 72 65 20 64 65 66 he above are def
2da0: 69 6e 65 64 2c 20 74 68 65 6e 20 73 65 74 20 53 ined, then set S
2db0: 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c QLITE_SYSTEM_MAL
2dc0: 4c 4f 43 20 61 73 0a 2a 2a 20 74 68 65 20 64 65 LOC as.** the de
2dd0: 66 61 75 6c 74 2e 0a 2a 2f 0a 23 69 66 20 64 65 fault..*/.#if de
2de0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 53 59 53 fined(SQLITE_SYS
2df0: 54 45 4d 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 TEM_MALLOC) \.
2e00: 2b 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 + defined(SQLITE
2e10: 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 29 20 5c _WIN32_MALLOC) \
2e20: 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c . + defined(SQL
2e30: 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 29 ITE_ZERO_MALLOC)
2e40: 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 \. + defined(S
2e50: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 29 3e QLITE_MEMDEBUG)>
2e60: 31 0a 23 20 65 72 72 6f 72 20 22 54 77 6f 20 6f 1.# error "Two o
2e70: 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 66 6f r more of the fo
2e80: 6c 6c 6f 77 69 6e 67 20 63 6f 6d 70 69 6c 65 2d llowing compile-
2e90: 74 69 6d 65 20 63 6f 6e 66 69 67 75 72 61 74 69 time configurati
2ea0: 6f 6e 20 6f 70 74 69 6f 6e 73 5c 0a 20 61 72 65 on options\. are
2eb0: 20 64 65 66 69 6e 65 64 20 62 75 74 20 61 74 20 defined but at
2ec0: 6d 6f 73 74 20 6f 6e 65 20 69 73 20 61 6c 6c 6f most one is allo
2ed0: 77 65 64 3a 5c 0a 20 53 51 4c 49 54 45 5f 53 59 wed:\. SQLITE_SY
2ee0: 53 54 45 4d 5f 4d 41 4c 4c 4f 43 2c 20 53 51 4c STEM_MALLOC, SQL
2ef0: 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 ITE_WIN32_MALLOC
2f00: 2c 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 , SQLITE_MEMDEBU
2f10: 47 2c 5c 0a 20 53 51 4c 49 54 45 5f 5a 45 52 4f G,\. SQLITE_ZERO
2f20: 5f 4d 41 4c 4c 4f 43 22 0a 23 65 6e 64 69 66 0a _MALLOC".#endif.
2f30: 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
2f40: 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 TE_SYSTEM_MALLOC
2f50: 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 ) \. + defined(
2f60: 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c SQLITE_WIN32_MAL
2f70: 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e LOC) \. + defin
2f80: 65 64 28 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d ed(SQLITE_ZERO_M
2f90: 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 ALLOC) \. + def
2fa0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 45 4d 44 ined(SQLITE_MEMD
2fb0: 45 42 55 47 29 3d 3d 30 0a 23 20 64 65 66 69 6e EBUG)==0.# defin
2fc0: 65 20 53 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f e SQLITE_SYSTEM_
2fd0: 4d 41 4c 4c 4f 43 20 31 0a 23 65 6e 64 69 66 0a MALLOC 1.#endif.
2fe0: 0a 2f 2a 0a 2a 2a 20 49 66 20 53 51 4c 49 54 45 ./*.** If SQLITE
2ff0: 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d _MALLOC_SOFT_LIM
3000: 49 54 20 69 73 20 6e 6f 74 20 7a 65 72 6f 2c 20 IT is not zero,
3010: 74 68 65 6e 20 74 72 79 20 74 6f 20 6b 65 65 70 then try to keep
3020: 20 74 68 65 0a 2a 2a 20 73 69 7a 65 73 20 6f 66 the.** sizes of
3030: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
3040: 6f 6e 73 20 62 65 6c 6f 77 20 74 68 69 73 20 76 ons below this v
3050: 61 6c 75 65 20 77 68 65 72 65 20 70 6f 73 73 69 alue where possi
3060: 62 6c 65 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 ble..*/.#if !def
3070: 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 41 4c 4c ined(SQLITE_MALL
3080: 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 29 0a 23 OC_SOFT_LIMIT).#
3090: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d define SQLITE_M
30a0: 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 ALLOC_SOFT_LIMIT
30b0: 20 31 30 32 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 1024.#endif../*
30c0: 0a 2a 2a 20 57 65 20 6e 65 65 64 20 74 6f 20 64 .** We need to d
30d0: 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f 53 4f 55 efine _XOPEN_SOU
30e0: 52 43 45 20 61 73 20 66 6f 6c 6c 6f 77 73 20 69 RCE as follows i
30f0: 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 61 62 6c n order to enabl
3100: 65 0a 2a 2a 20 72 65 63 75 72 73 69 76 65 20 6d e.** recursive m
3110: 75 74 65 78 65 73 20 6f 6e 20 6d 6f 73 74 20 55 utexes on most U
3120: 6e 69 78 20 73 79 73 74 65 6d 73 20 61 6e 64 20 nix systems and
3130: 66 63 68 6d 6f 64 28 29 20 6f 6e 20 4f 70 65 6e fchmod() on Open
3140: 42 53 44 2e 0a 2a 2a 20 42 75 74 20 5f 58 4f 50 BSD..** But _XOP
3150: 45 4e 5f 53 4f 55 52 43 45 20 64 65 66 69 6e 65 EN_SOURCE define
3160: 20 63 61 75 73 65 73 20 70 72 6f 62 6c 65 6d 73 causes problems
3170: 20 66 6f 72 20 4d 61 63 20 4f 53 20 58 2c 20 73 for Mac OS X, s
3180: 6f 20 6f 6d 69 74 0a 2a 2a 20 69 74 2e 0a 2a 2f o omit.** it..*/
3190: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 5f 58 .#if !defined(_X
31a0: 4f 50 45 4e 5f 53 4f 55 52 43 45 29 20 26 26 20 OPEN_SOURCE) &&
31b0: 21 64 65 66 69 6e 65 64 28 5f 5f 44 41 52 57 49 !defined(__DARWI
31c0: 4e 5f 5f 29 20 26 26 20 21 64 65 66 69 6e 65 64 N__) && !defined
31d0: 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 23 20 20 64 (__APPLE__).# d
31e0: 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f 53 4f 55 efine _XOPEN_SOU
31f0: 52 43 45 20 36 30 30 0a 23 65 6e 64 69 66 0a 0a RCE 600.#endif..
3200: 2f 2a 0a 2a 2a 20 4e 44 45 42 55 47 20 61 6e 64 /*.** NDEBUG and
3210: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 61 72 SQLITE_DEBUG ar
3220: 65 20 6f 70 70 6f 73 69 74 65 73 2e 20 20 49 74 e opposites. It
3230: 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 73 20 62 should always b
3240: 65 20 74 72 75 65 20 74 68 61 74 0a 2a 2a 20 64 e true that.** d
3250: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 3d 3d efined(NDEBUG)==
3260: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
3270: 44 45 42 55 47 29 2e 20 20 49 66 20 74 68 69 73 DEBUG). If this
3280: 20 69 73 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c is not currentl
3290: 79 20 74 72 75 65 2c 0a 2a 2a 20 6d 61 6b 65 20 y true,.** make
32a0: 69 74 20 74 72 75 65 20 62 79 20 64 65 66 69 6e it true by defin
32b0: 69 6e 67 20 6f 72 20 75 6e 64 65 66 69 6e 69 6e ing or undefinin
32c0: 67 20 4e 44 45 42 55 47 2e 0a 2a 2a 0a 2a 2a 20 g NDEBUG..**.**
32d0: 53 65 74 74 69 6e 67 20 4e 44 45 42 55 47 20 6d Setting NDEBUG m
32e0: 61 6b 65 73 20 74 68 65 20 63 6f 64 65 20 73 6d akes the code sm
32f0: 61 6c 6c 65 72 20 61 6e 64 20 66 61 73 74 65 72 aller and faster
3300: 20 62 79 20 64 69 73 61 62 6c 69 6e 67 20 74 68 by disabling th
3310: 65 0a 2a 2a 20 61 73 73 65 72 74 28 29 20 73 74 e.** assert() st
3320: 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 atements in the
3330: 63 6f 64 65 2e 20 20 53 6f 20 77 65 20 77 61 6e code. So we wan
3340: 74 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 63 t the default ac
3350: 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 20 66 6f tion.** to be fo
3360: 72 20 4e 44 45 42 55 47 20 74 6f 20 62 65 20 73 r NDEBUG to be s
3370: 65 74 20 61 6e 64 20 4e 44 45 42 55 47 20 74 6f et and NDEBUG to
3380: 20 62 65 20 75 6e 64 65 66 69 6e 65 64 20 6f 6e be undefined on
3390: 6c 79 20 69 66 20 53 51 4c 49 54 45 5f 44 45 42 ly if SQLITE_DEB
33a0: 55 47 0a 2a 2a 20 69 73 20 73 65 74 2e 20 20 54 UG.** is set. T
33b0: 68 75 73 20 4e 44 45 42 55 47 20 62 65 63 6f 6d hus NDEBUG becom
33c0: 65 73 20 61 6e 20 6f 70 74 2d 69 6e 20 72 61 74 es an opt-in rat
33d0: 68 65 72 20 74 68 61 6e 20 61 6e 20 6f 70 74 2d her than an opt-
33e0: 6f 75 74 0a 2a 2a 20 66 65 61 74 75 72 65 2e 0a out.** feature..
33f0: 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
3400: 4e 44 45 42 55 47 29 20 26 26 20 21 64 65 66 69 NDEBUG) && !defi
3410: 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
3420: 29 0a 23 20 64 65 66 69 6e 65 20 4e 44 45 42 55 ).# define NDEBU
3430: 47 20 31 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 G 1.#endif.#if d
3440: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 20 26 efined(NDEBUG) &
3450: 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 & defined(SQLITE
3460: 5f 44 45 42 55 47 29 0a 23 20 75 6e 64 65 66 20 _DEBUG).# undef
3470: 4e 44 45 42 55 47 0a 23 65 6e 64 69 66 0a 0a 2f NDEBUG.#endif../
3480: 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 53 51 4c 49 *.** Enable SQLI
3490: 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 TE_ENABLE_EXPLAI
34a0: 4e 5f 43 4f 4d 4d 45 4e 54 53 20 69 66 20 53 51 N_COMMENTS if SQ
34b0: 4c 49 54 45 5f 44 45 42 55 47 20 69 73 20 74 75 LITE_DEBUG is tu
34c0: 72 6e 65 64 20 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 rned on..*/.#if
34d0: 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
34e0: 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 ENABLE_EXPLAIN_C
34f0: 4f 4d 4d 45 4e 54 53 29 20 26 26 20 64 65 66 69 OMMENTS) && defi
3500: 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
3510: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
3520: 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e E_ENABLE_EXPLAIN
3530: 5f 43 4f 4d 4d 45 4e 54 53 20 31 0a 23 65 6e 64 _COMMENTS 1.#end
3540: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 74 65 if../*.** The te
3550: 73 74 63 61 73 65 28 29 20 6d 61 63 72 6f 20 69 stcase() macro i
3560: 73 20 75 73 65 64 20 74 6f 20 61 69 64 20 69 6e s used to aid in
3570: 20 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 6e coverage testin
3580: 67 2e 20 20 57 68 65 6e 0a 2a 2a 20 64 6f 69 6e g. When.** doin
3590: 67 20 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 g coverage testi
35a0: 6e 67 2c 20 74 68 65 20 63 6f 6e 64 69 74 69 6f ng, the conditio
35b0: 6e 20 69 6e 73 69 64 65 20 74 68 65 20 61 72 67 n inside the arg
35c0: 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 65 73 74 ument to.** test
35d0: 63 61 73 65 28 29 20 6d 75 73 74 20 62 65 20 65 case() must be e
35e0: 76 61 6c 75 61 74 65 64 20 62 6f 74 68 20 74 72 valuated both tr
35f0: 75 65 20 61 6e 64 20 66 61 6c 73 65 20 69 6e 20 ue and false in
3600: 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 67 65 74 20 order to.** get
3610: 66 75 6c 6c 20 62 72 61 6e 63 68 20 63 6f 76 65 full branch cove
3620: 72 61 67 65 2e 20 20 54 68 65 20 74 65 73 74 63 rage. The testc
3630: 61 73 65 28 29 20 6d 61 63 72 6f 20 69 73 20 69 ase() macro is i
3640: 6e 73 65 72 74 65 64 0a 2a 2a 20 74 6f 20 68 65 nserted.** to he
3650: 6c 70 20 65 6e 73 75 72 65 20 61 64 65 71 75 61 lp ensure adequa
3660: 74 65 20 74 65 73 74 20 63 6f 76 65 72 61 67 65 te test coverage
3670: 20 69 6e 20 70 6c 61 63 65 73 20 77 68 65 72 65 in places where
3680: 20 73 69 6d 70 6c 65 0a 2a 2a 20 63 6f 6e 64 69 simple.** condi
3690: 74 69 6f 6e 2f 64 65 63 69 73 69 6f 6e 20 63 6f tion/decision co
36a0: 76 65 72 61 67 65 20 69 73 20 69 6e 61 64 65 71 verage is inadeq
36b0: 75 61 74 65 2e 20 20 46 6f 72 20 65 78 61 6d 70 uate. For examp
36c0: 6c 65 2c 20 74 65 73 74 63 61 73 65 28 29 0a 2a le, testcase().*
36d0: 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f * can be used to
36e0: 20 6d 61 6b 65 20 73 75 72 65 20 62 6f 75 6e 64 make sure bound
36f0: 61 72 79 20 76 61 6c 75 65 73 20 61 72 65 20 74 ary values are t
3700: 65 73 74 65 64 2e 20 20 46 6f 72 0a 2a 2a 20 62 ested. For.** b
3710: 69 74 6d 61 73 6b 20 74 65 73 74 73 2c 20 74 65 itmask tests, te
3720: 73 74 63 61 73 65 28 29 20 63 61 6e 20 62 65 20 stcase() can be
3730: 75 73 65 64 20 74 6f 20 6d 61 6b 65 20 73 75 72 used to make sur
3740: 65 20 65 61 63 68 20 62 69 74 0a 2a 2a 20 69 73 e each bit.** is
3750: 20 73 69 67 6e 69 66 69 63 61 6e 74 20 61 6e 64 significant and
3760: 20 75 73 65 64 20 61 74 20 6c 65 61 73 74 20 6f used at least o
3770: 6e 63 65 2e 20 20 4f 6e 20 73 77 69 74 63 68 20 nce. On switch
3780: 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 77 68 statements.** wh
3790: 65 72 65 20 6d 75 6c 74 69 70 6c 65 20 63 61 73 ere multiple cas
37a0: 65 73 20 67 6f 20 74 6f 20 74 68 65 20 73 61 6d es go to the sam
37b0: 65 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 2c e block of code,
37c0: 20 74 65 73 74 63 61 73 65 28 29 0a 2a 2a 20 63 testcase().** c
37d0: 61 6e 20 69 6e 73 75 72 65 20 74 68 61 74 20 61 an insure that a
37e0: 6c 6c 20 63 61 73 65 73 20 61 72 65 20 65 76 61 ll cases are eva
37f0: 6c 75 61 74 65 64 2e 0a 2a 2a 0a 2a 2f 0a 23 69 luated..**.*/.#i
3800: 66 64 65 66 20 53 51 4c 49 54 45 5f 43 4f 56 45 fdef SQLITE_COVE
3810: 52 41 47 45 5f 54 45 53 54 0a 20 20 76 6f 69 64 RAGE_TEST. void
3820: 20 73 71 6c 69 74 65 33 43 6f 76 65 72 61 67 65 sqlite3Coverage
3830: 28 69 6e 74 29 3b 0a 23 20 64 65 66 69 6e 65 20 (int);.# define
3840: 74 65 73 74 63 61 73 65 28 58 29 20 20 69 66 28 testcase(X) if(
3850: 20 58 20 29 7b 20 73 71 6c 69 74 65 33 43 6f 76 X ){ sqlite3Cov
3860: 65 72 61 67 65 28 5f 5f 4c 49 4e 45 5f 5f 29 3b erage(__LINE__);
3870: 20 7d 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e }.#else.# defin
3880: 65 20 74 65 73 74 63 61 73 65 28 58 29 0a 23 65 e testcase(X).#e
3890: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
38a0: 54 45 53 54 4f 4e 4c 59 20 6d 61 63 72 6f 20 69 TESTONLY macro i
38b0: 73 20 75 73 65 64 20 74 6f 20 65 6e 63 6c 6f 73 s used to enclos
38c0: 65 20 76 61 72 69 61 62 6c 65 20 64 65 63 6c 61 e variable decla
38d0: 72 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a 20 6f 74 rations or.** ot
38e0: 68 65 72 20 62 69 74 73 20 6f 66 20 63 6f 64 65 her bits of code
38f0: 20 74 68 61 74 20 61 72 65 20 6e 65 65 64 65 64 that are needed
3900: 20 74 6f 20 73 75 70 70 6f 72 74 20 74 68 65 20 to support the
3910: 61 72 67 75 6d 65 6e 74 73 0a 2a 2a 20 77 69 74 arguments.** wit
3920: 68 69 6e 20 74 65 73 74 63 61 73 65 28 29 20 61 hin testcase() a
3930: 6e 64 20 61 73 73 65 72 74 28 29 20 6d 61 63 72 nd assert() macr
3940: 6f 73 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 os..*/.#if !defi
3950: 6e 65 64 28 4e 44 45 42 55 47 29 20 7c 7c 20 64 ned(NDEBUG) || d
3960: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 43 4f efined(SQLITE_CO
3970: 56 45 52 41 47 45 5f 54 45 53 54 29 0a 23 20 64 VERAGE_TEST).# d
3980: 65 66 69 6e 65 20 54 45 53 54 4f 4e 4c 59 28 58 efine TESTONLY(X
3990: 29 20 20 58 0a 23 65 6c 73 65 0a 23 20 64 65 66 ) X.#else.# def
39a0: 69 6e 65 20 54 45 53 54 4f 4e 4c 59 28 58 29 0a ine TESTONLY(X).
39b0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6f #endif../*.** So
39c0: 6d 65 74 69 6d 65 73 20 77 65 20 6e 65 65 64 20 metimes we need
39d0: 61 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e 74 20 6f a small amount o
39e0: 66 20 63 6f 64 65 20 73 75 63 68 20 61 73 20 61 f code such as a
39f0: 20 76 61 72 69 61 62 6c 65 20 69 6e 69 74 69 61 variable initia
3a00: 6c 69 7a 61 74 69 6f 6e 0a 2a 2a 20 74 6f 20 73 lization.** to s
3a10: 65 74 75 70 20 66 6f 72 20 61 20 6c 61 74 65 72 etup for a later
3a20: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
3a30: 65 6e 74 2e 20 20 57 65 20 64 6f 20 6e 6f 74 20 ent. We do not
3a40: 77 61 6e 74 20 74 68 69 73 20 63 6f 64 65 20 74 want this code t
3a50: 6f 0a 2a 2a 20 61 70 70 65 61 72 20 77 68 65 6e o.** appear when
3a60: 20 61 73 73 65 72 74 28 29 20 69 73 20 64 69 73 assert() is dis
3a70: 61 62 6c 65 64 2e 20 20 54 68 65 20 66 6f 6c 6c abled. The foll
3a80: 6f 77 69 6e 67 20 6d 61 63 72 6f 20 69 73 20 74 owing macro is t
3a90: 68 65 72 65 66 6f 72 65 0a 2a 2a 20 75 73 65 64 herefore.** used
3aa0: 20 74 6f 20 63 6f 6e 74 61 69 6e 20 74 68 61 74 to contain that
3ab0: 20 73 65 74 75 70 20 63 6f 64 65 2e 20 20 54 68 setup code. Th
3ac0: 65 20 22 56 56 41 22 20 61 63 72 6f 6e 79 6d 20 e "VVA" acronym
3ad0: 73 74 61 6e 64 73 20 66 6f 72 0a 2a 2a 20 22 56 stands for.** "V
3ae0: 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 56 61 6c erification, Val
3af0: 69 64 61 74 69 6f 6e 2c 20 61 6e 64 20 41 63 63 idation, and Acc
3b00: 72 65 64 69 74 61 74 69 6f 6e 22 2e 20 20 49 6e reditation". In
3b10: 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 74 68 other words, th
3b20: 65 0a 2a 2a 20 63 6f 64 65 20 77 69 74 68 69 6e e.** code within
3b30: 20 56 56 41 5f 4f 4e 4c 59 28 29 20 77 69 6c 6c VVA_ONLY() will
3b40: 20 6f 6e 6c 79 20 72 75 6e 20 64 75 72 69 6e 67 only run during
3b50: 20 76 65 72 69 66 69 63 61 74 69 6f 6e 20 70 72 verification pr
3b60: 6f 63 65 73 73 65 73 2e 0a 2a 2f 0a 23 69 66 6e ocesses..*/.#ifn
3b70: 64 65 66 20 4e 44 45 42 55 47 0a 23 20 64 65 66 def NDEBUG.# def
3b80: 69 6e 65 20 56 56 41 5f 4f 4e 4c 59 28 58 29 20 ine VVA_ONLY(X)
3b90: 20 58 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e X.#else.# defin
3ba0: 65 20 56 56 41 5f 4f 4e 4c 59 28 58 29 0a 23 65 e VVA_ONLY(X).#e
3bb0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
3bc0: 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 56 45 52 ALWAYS and NEVER
3bd0: 20 6d 61 63 72 6f 73 20 73 75 72 72 6f 75 6e 64 macros surround
3be0: 20 62 6f 6f 6c 65 61 6e 20 65 78 70 72 65 73 73 boolean express
3bf0: 69 6f 6e 73 20 77 68 69 63 68 0a 2a 2a 20 61 72 ions which.** ar
3c00: 65 20 69 6e 74 65 6e 64 65 64 20 74 6f 20 61 6c e intended to al
3c10: 77 61 79 73 20 62 65 20 74 72 75 65 20 6f 72 20 ways be true or
3c20: 66 61 6c 73 65 2c 20 72 65 73 70 65 63 74 69 76 false, respectiv
3c30: 65 6c 79 2e 20 20 53 75 63 68 0a 2a 2a 20 65 78 ely. Such.** ex
3c40: 70 72 65 73 73 69 6f 6e 73 20 63 6f 75 6c 64 20 pressions could
3c50: 62 65 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 be omitted from
3c60: 74 68 65 20 63 6f 64 65 20 63 6f 6d 70 6c 65 74 the code complet
3c70: 65 6c 79 2e 20 20 42 75 74 20 74 68 65 79 0a 2a ely. But they.*
3c80: 2a 20 61 72 65 20 69 6e 63 6c 75 64 65 64 20 69 * are included i
3c90: 6e 20 61 20 66 65 77 20 63 61 73 65 73 20 69 6e n a few cases in
3ca0: 20 6f 72 64 65 72 20 74 6f 20 65 6e 68 61 6e 63 order to enhanc
3cb0: 65 20 74 68 65 20 72 65 73 69 6c 69 65 6e 63 65 e the resilience
3cc0: 0a 2a 2a 20 6f 66 20 53 51 4c 69 74 65 20 74 6f .** of SQLite to
3cd0: 20 75 6e 65 78 70 65 63 74 65 64 20 62 65 68 61 unexpected beha
3ce0: 76 69 6f 72 20 2d 20 74 6f 20 6d 61 6b 65 20 74 vior - to make t
3cf0: 68 65 20 63 6f 64 65 20 22 73 65 6c 66 2d 68 65 he code "self-he
3d00: 61 6c 69 6e 67 22 0a 2a 2a 20 6f 72 20 22 64 75 aling".** or "du
3d10: 63 74 69 6c 65 22 20 72 61 74 68 65 72 20 74 68 ctile" rather th
3d20: 61 6e 20 62 65 69 6e 67 20 22 62 72 69 74 74 6c an being "brittl
3d30: 65 22 20 61 6e 64 20 63 72 61 73 68 69 6e 67 20 e" and crashing
3d40: 61 74 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 at the first.**
3d50: 68 69 6e 74 20 6f 66 20 75 6e 70 6c 61 6e 6e 65 hint of unplanne
3d60: 64 20 62 65 68 61 76 69 6f 72 2e 0a 2a 2a 0a 2a d behavior..**.*
3d70: 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 * In other words
3d80: 2c 20 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 56 , ALWAYS and NEV
3d90: 45 52 20 61 72 65 20 61 64 64 65 64 20 66 6f 72 ER are added for
3da0: 20 64 65 66 65 6e 73 69 76 65 20 63 6f 64 65 2e defensive code.
3db0: 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 64 6f 69 6e .**.** When doin
3dc0: 67 20 63 6f 76 65 72 61 67 65 20 74 65 73 74 69 g coverage testi
3dd0: 6e 67 20 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 ng ALWAYS and NE
3de0: 56 45 52 20 61 72 65 20 68 61 72 64 2d 63 6f 64 VER are hard-cod
3df0: 65 64 20 74 6f 0a 2a 2a 20 62 65 20 74 72 75 65 ed to.** be true
3e00: 20 61 6e 64 20 66 61 6c 73 65 20 73 6f 20 74 68 and false so th
3e10: 61 74 20 74 68 65 20 75 6e 72 65 61 63 68 61 62 at the unreachab
3e20: 6c 65 20 63 6f 64 65 20 74 68 65 79 20 73 70 65 le code they spe
3e30: 63 69 66 79 20 77 69 6c 6c 0a 2a 2a 20 6e 6f 74 cify will.** not
3e40: 20 62 65 20 63 6f 75 6e 74 65 64 20 61 73 20 75 be counted as u
3e50: 6e 74 65 73 74 65 64 20 63 6f 64 65 2e 0a 2a 2f ntested code..*/
3e60: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
3e70: 49 54 45 5f 43 4f 56 45 52 41 47 45 5f 54 45 53 ITE_COVERAGE_TES
3e80: 54 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 T) || defined(SQ
3e90: 4c 49 54 45 5f 4d 55 54 41 54 49 4f 4e 5f 54 45 LITE_MUTATION_TE
3ea0: 53 54 29 0a 23 20 64 65 66 69 6e 65 20 41 4c 57 ST).# define ALW
3eb0: 41 59 53 28 58 29 20 20 20 20 20 20 28 31 29 0a AYS(X) (1).
3ec0: 23 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 58 # define NEVER(X
3ed0: 29 20 20 20 20 20 20 20 28 30 29 0a 23 65 6c 69 ) (0).#eli
3ee0: 66 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 f !defined(NDEBU
3ef0: 47 29 0a 23 20 64 65 66 69 6e 65 20 41 4c 57 41 G).# define ALWA
3f00: 59 53 28 58 29 20 20 20 20 20 20 28 28 58 29 3f YS(X) ((X)?
3f10: 31 3a 28 61 73 73 65 72 74 28 30 29 2c 30 29 29 1:(assert(0),0))
3f20: 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 .# define NEVER(
3f30: 58 29 20 20 20 20 20 20 20 28 28 58 29 3f 28 61 X) ((X)?(a
3f40: 73 73 65 72 74 28 30 29 2c 31 29 3a 30 29 0a 23 ssert(0),1):0).#
3f50: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 41 4c else.# define AL
3f60: 57 41 59 53 28 58 29 20 20 20 20 20 20 28 58 29 WAYS(X) (X)
3f70: 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 .# define NEVER(
3f80: 58 29 20 20 20 20 20 20 20 28 58 29 0a 23 65 6e X) (X).#en
3f90: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 20 dif../*.** Some
3fa0: 63 6f 6e 64 69 74 69 6f 6e 61 6c 73 20 61 72 65 conditionals are
3fb0: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 6f optimizations o
3fc0: 6e 6c 79 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 nly. In other w
3fd0: 6f 72 64 73 2c 20 69 66 20 74 68 65 0a 2a 2a 20 ords, if the.**
3fe0: 63 6f 6e 64 69 74 69 6f 6e 61 6c 73 20 61 72 65 conditionals are
3ff0: 20 72 65 70 6c 61 63 65 64 20 77 69 74 68 20 61 replaced with a
4000: 20 63 6f 6e 73 74 61 6e 74 20 31 20 28 74 72 75 constant 1 (tru
4010: 65 29 20 6f 72 20 30 20 28 66 61 6c 73 65 29 20 e) or 0 (false)
4020: 74 68 65 6e 0a 2a 2a 20 74 68 65 20 63 6f 72 72 then.** the corr
4030: 65 63 74 20 61 6e 73 77 65 72 20 69 73 20 73 74 ect answer is st
4040: 69 6c 6c 20 6f 62 74 61 69 6e 65 64 2c 20 74 68 ill obtained, th
4050: 6f 75 67 68 20 70 65 72 68 61 70 73 20 6e 6f 74 ough perhaps not
4060: 20 61 73 20 71 75 69 63 6b 6c 79 2e 0a 2a 2a 0a as quickly..**.
4070: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
4080: 20 6d 61 63 72 6f 73 20 6d 61 72 6b 20 74 68 65 macros mark the
4090: 73 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 se optimizations
40a0: 20 63 6f 6e 64 69 74 69 6f 6e 61 6c 73 2e 0a 2a conditionals..*
40b0: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 /.#if defined(SQ
40c0: 4c 49 54 45 5f 4d 55 54 41 54 49 4f 4e 5f 54 45 LITE_MUTATION_TE
40d0: 53 54 29 0a 23 20 64 65 66 69 6e 65 20 4f 4b 5f ST).# define OK_
40e0: 49 46 5f 41 4c 57 41 59 53 5f 54 52 55 45 28 58 IF_ALWAYS_TRUE(X
40f0: 29 20 20 28 31 29 0a 23 20 64 65 66 69 6e 65 20 ) (1).# define
4100: 4f 4b 5f 49 46 5f 41 4c 57 41 59 53 5f 46 41 4c OK_IF_ALWAYS_FAL
4110: 53 45 28 58 29 20 28 30 29 0a 23 65 6c 73 65 0a SE(X) (0).#else.
4120: 23 20 64 65 66 69 6e 65 20 4f 4b 5f 49 46 5f 41 # define OK_IF_A
4130: 4c 57 41 59 53 5f 54 52 55 45 28 58 29 20 20 28 LWAYS_TRUE(X) (
4140: 58 29 0a 23 20 64 65 66 69 6e 65 20 4f 4b 5f 49 X).# define OK_I
4150: 46 5f 41 4c 57 41 59 53 5f 46 41 4c 53 45 28 58 F_ALWAYS_FALSE(X
4160: 29 20 28 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a ) (X).#endif../*
4170: 0a 2a 2a 20 53 6f 6d 65 20 6d 61 6c 6c 6f 63 20 .** Some malloc
4180: 66 61 69 6c 75 72 65 73 20 61 72 65 20 6f 6e 6c failures are onl
4190: 79 20 70 6f 73 73 69 62 6c 65 20 69 66 20 53 51 y possible if SQ
41a0: 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 4c 4c 4f LITE_TEST_REALLO
41b0: 43 5f 53 54 52 45 53 53 20 69 73 0a 2a 2a 20 64 C_STRESS is.** d
41c0: 65 66 69 6e 65 64 2e 20 20 57 65 20 6e 65 65 64 efined. We need
41d0: 20 74 6f 20 64 65 66 65 6e 64 20 61 67 61 69 6e to defend again
41e0: 73 74 20 74 68 6f 73 65 20 66 61 69 6c 75 72 65 st those failure
41f0: 73 20 77 68 65 6e 20 74 65 73 74 69 6e 67 20 77 s when testing w
4200: 69 74 68 0a 2a 2a 20 53 51 4c 49 54 45 5f 54 45 ith.** SQLITE_TE
4210: 53 54 5f 52 45 41 4c 4c 4f 43 5f 53 54 52 45 53 ST_REALLOC_STRES
4220: 53 2c 20 62 75 74 20 77 65 20 64 6f 6e 27 74 20 S, but we don't
4230: 77 61 6e 74 20 74 68 65 20 75 6e 72 65 61 63 68 want the unreach
4240: 61 62 6c 65 20 62 72 61 6e 63 68 65 73 0a 2a 2a able branches.**
4250: 20 64 75 72 69 6e 67 20 61 20 6e 6f 72 6d 61 6c during a normal
4260: 20 62 75 69 6c 64 2e 20 20 54 68 65 20 66 6f 6c build. The fol
4270: 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 63 61 6e lowing macro can
4280: 20 62 65 20 75 73 65 64 20 74 6f 20 64 69 73 61 be used to disa
4290: 62 6c 65 20 74 65 73 74 73 0a 2a 2a 20 74 68 61 ble tests.** tha
42a0: 74 20 61 72 65 20 61 6c 77 61 79 73 20 66 61 6c t are always fal
42b0: 73 65 20 65 78 63 65 70 74 20 77 68 65 6e 20 53 se except when S
42c0: 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 4c 4c QLITE_TEST_REALL
42d0: 4f 43 5f 53 54 52 45 53 53 20 69 73 20 73 65 74 OC_STRESS is set
42e0: 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 ..*/.#if defined
42f0: 28 53 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 (SQLITE_TEST_REA
4300: 4c 4c 4f 43 5f 53 54 52 45 53 53 29 0a 23 20 64 LLOC_STRESS).# d
4310: 65 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 efine ONLY_IF_RE
4320: 41 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 ALLOC_STRESS(X)
4330: 20 28 58 29 0a 23 65 6c 69 66 20 21 64 65 66 69 (X).#elif !defi
4340: 6e 65 64 28 4e 44 45 42 55 47 29 0a 23 20 64 65 ned(NDEBUG).# de
4350: 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 41 fine ONLY_IF_REA
4360: 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 20 LLOC_STRESS(X)
4370: 28 28 58 29 3f 28 61 73 73 65 72 74 28 30 29 2c ((X)?(assert(0),
4380: 31 29 3a 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 1):0).#else.# de
4390: 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 41 fine ONLY_IF_REA
43a0: 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 20 LLOC_STRESS(X)
43b0: 28 30 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a (0).#endif../*.*
43c0: 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e 73 20 75 * Declarations u
43d0: 73 65 64 20 66 6f 72 20 74 72 61 63 69 6e 67 20 sed for tracing
43e0: 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 the operating sy
43f0: 73 74 65 6d 20 69 6e 74 65 72 66 61 63 65 73 2e stem interfaces.
4400: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
4410: 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 4f 53 5f SQLITE_FORCE_OS_
4420: 54 52 41 43 45 29 20 7c 7c 20 64 65 66 69 6e 65 TRACE) || define
4430: 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c d(SQLITE_TEST) |
4440: 7c 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 | \. (defined
4450: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 (SQLITE_DEBUG) &
4460: 26 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 & SQLITE_OS_WIN)
4470: 0a 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 . extern int sq
4480: 6c 69 74 65 33 4f 53 54 72 61 63 65 3b 0a 23 20 lite3OSTrace;.#
4490: 64 65 66 69 6e 65 20 4f 53 54 52 41 43 45 28 58 define OSTRACE(X
44a0: 29 20 20 20 20 20 20 20 20 20 20 69 66 28 20 73 ) if( s
44b0: 71 6c 69 74 65 33 4f 53 54 72 61 63 65 20 29 20 qlite3OSTrace )
44c0: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
44d0: 74 66 20 58 0a 23 20 64 65 66 69 6e 65 20 53 51 tf X.# define SQ
44e0: 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 41 LITE_HAVE_OS_TRA
44f0: 43 45 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e CE.#else.# defin
4500: 65 20 4f 53 54 52 41 43 45 28 58 29 0a 23 20 75 e OSTRACE(X).# u
4510: 6e 64 65 66 20 20 53 51 4c 49 54 45 5f 48 41 56 ndef SQLITE_HAV
4520: 45 5f 4f 53 5f 54 52 41 43 45 0a 23 65 6e 64 69 E_OS_TRACE.#endi
4530: 66 0a 0a 2f 2a 0a 2a 2a 20 49 73 20 74 68 65 20 f../*.** Is the
4540: 73 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 29 sqlite3ErrName()
4550: 20 66 75 6e 63 74 69 6f 6e 20 6e 65 65 64 65 64 function needed
4560: 20 69 6e 20 74 68 65 20 62 75 69 6c 64 3f 20 20 in the build?
4570: 43 75 72 72 65 6e 74 6c 79 2c 0a 2a 2a 20 69 74 Currently,.** it
4580: 20 69 73 20 6e 65 65 64 65 64 20 62 79 20 22 6d is needed by "m
4590: 75 74 65 78 5f 77 33 32 2e 63 22 20 28 77 68 65 utex_w32.c" (whe
45a0: 6e 20 64 65 62 75 67 67 69 6e 67 29 2c 20 22 6f n debugging), "o
45b0: 73 5f 77 69 6e 2e 63 22 20 28 77 68 65 6e 0a 2a s_win.c" (when.*
45c0: 2a 20 4f 53 54 52 41 43 45 20 69 73 20 65 6e 61 * OSTRACE is ena
45d0: 62 6c 65 64 29 2c 20 61 6e 64 20 62 79 20 73 65 bled), and by se
45e0: 76 65 72 61 6c 20 22 74 65 73 74 2a 2e 63 22 20 veral "test*.c"
45f0: 66 69 6c 65 73 20 28 77 68 69 63 68 20 61 72 65 files (which are
4600: 0a 2a 2a 20 63 6f 6d 70 69 6c 65 64 20 75 73 69 .** compiled usi
4610: 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 54 29 2e ng SQLITE_TEST).
4620: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
4630: 53 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 SQLITE_HAVE_OS_T
4640: 52 41 43 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 RACE) || defined
4650: 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c 7c (SQLITE_TEST) ||
4660: 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 28 \. (defined(
4670: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 26 SQLITE_DEBUG) &&
4680: 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 0a SQLITE_OS_WIN).
4690: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
46a0: 4e 45 45 44 5f 45 52 52 5f 4e 41 4d 45 0a 23 65 NEED_ERR_NAME.#e
46b0: 6c 73 65 0a 23 20 75 6e 64 65 66 20 20 53 51 4c lse.# undef SQL
46c0: 49 54 45 5f 4e 45 45 44 5f 45 52 52 5f 4e 41 4d ITE_NEED_ERR_NAM
46d0: 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 E.#endif../*.**
46e0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 SQLITE_ENABLE_EX
46f0: 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 20 69 PLAIN_COMMENTS i
4700: 73 20 69 6e 63 6f 6d 70 61 74 69 62 6c 65 20 77 s incompatible w
4710: 69 74 68 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ith SQLITE_OMIT_
4720: 45 58 50 4c 41 49 4e 0a 2a 2f 0a 23 69 66 64 65 EXPLAIN.*/.#ifde
4730: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 f SQLITE_OMIT_EX
4740: 50 4c 41 49 4e 0a 23 20 75 6e 64 65 66 20 53 51 PLAIN.# undef SQ
4750: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c LITE_ENABLE_EXPL
4760: 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 0a 23 65 6e AIN_COMMENTS.#en
4770: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 dif../*.** Retur
4780: 6e 20 74 72 75 65 20 28 6e 6f 6e 2d 7a 65 72 6f n true (non-zero
4790: 29 20 69 66 20 74 68 65 20 69 6e 70 75 74 20 69 ) if the input i
47a0: 73 20 61 6e 20 69 6e 74 65 67 65 72 20 74 68 61 s an integer tha
47b0: 74 20 69 73 20 74 6f 6f 20 6c 61 72 67 65 0a 2a t is too large.*
47c0: 2a 20 74 6f 20 66 69 74 20 69 6e 20 33 32 2d 62 * to fit in 32-b
47d0: 69 74 73 2e 20 20 54 68 69 73 20 6d 61 63 72 6f its. This macro
47e0: 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 65 20 is used inside
47f0: 6f 66 20 76 61 72 69 6f 75 73 20 74 65 73 74 63 of various testc
4800: 61 73 65 28 29 0a 2a 2a 20 6d 61 63 72 6f 73 20 ase().** macros
4810: 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 77 to verify that w
4820: 65 20 68 61 76 65 20 74 65 73 74 65 64 20 53 51 e have tested SQ
4830: 4c 69 74 65 20 66 6f 72 20 6c 61 72 67 65 2d 66 Lite for large-f
4840: 69 6c 65 20 73 75 70 70 6f 72 74 2e 0a 2a 2f 0a ile support..*/.
4850: 23 64 65 66 69 6e 65 20 49 53 5f 42 49 47 5f 49 #define IS_BIG_I
4860: 4e 54 28 58 29 20 20 28 28 28 58 29 26 7e 28 69 NT(X) (((X)&~(i
4870: 36 34 29 30 78 66 66 66 66 66 66 66 66 29 21 3d 64)0xffffffff)!=
4880: 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6d 61 0)../*.** The ma
4890: 63 72 6f 20 75 6e 6c 69 6b 65 6c 79 28 29 20 69 cro unlikely() i
48a0: 73 20 61 20 68 69 6e 74 20 74 68 61 74 20 73 75 s a hint that su
48b0: 72 72 6f 75 6e 64 73 20 61 20 62 6f 6f 6c 65 61 rrounds a boolea
48c0: 6e 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 n.** expression
48d0: 74 68 61 74 20 69 73 20 75 73 75 61 6c 6c 79 20 that is usually
48e0: 66 61 6c 73 65 2e 20 20 4d 61 63 72 6f 20 6c 69 false. Macro li
48f0: 6b 65 6c 79 28 29 20 73 75 72 72 6f 75 6e 64 73 kely() surrounds
4900: 0a 2a 2a 20 61 20 62 6f 6f 6c 65 61 6e 20 65 78 .** a boolean ex
4910: 70 72 65 73 73 69 6f 6e 20 74 68 61 74 20 69 73 pression that is
4920: 20 75 73 75 61 6c 6c 79 20 74 72 75 65 2e 20 20 usually true.
4930: 54 68 65 73 65 20 68 69 6e 74 73 20 63 6f 75 6c These hints coul
4940: 64 2c 0a 2a 2a 20 69 6e 20 74 68 65 6f 72 79 2c d,.** in theory,
4950: 20 62 65 20 75 73 65 64 20 62 79 20 74 68 65 20 be used by the
4960: 63 6f 6d 70 69 6c 65 72 20 74 6f 20 67 65 6e 65 compiler to gene
4970: 72 61 74 65 20 62 65 74 74 65 72 20 63 6f 64 65 rate better code
4980: 2c 20 62 75 74 0a 2a 2a 20 63 75 72 72 65 6e 74 , but.** current
4990: 6c 79 20 74 68 65 79 20 61 72 65 20 6a 75 73 74 ly they are just
49a0: 20 63 6f 6d 6d 65 6e 74 73 20 66 6f 72 20 68 75 comments for hu
49b0: 6d 61 6e 20 72 65 61 64 65 72 73 2e 0a 2a 2f 0a man readers..*/.
49c0: 23 64 65 66 69 6e 65 20 6c 69 6b 65 6c 79 28 58 #define likely(X
49d0: 29 20 20 20 20 28 58 29 0a 23 64 65 66 69 6e 65 ) (X).#define
49e0: 20 75 6e 6c 69 6b 65 6c 79 28 58 29 20 20 28 58 unlikely(X) (X
49f0: 29 0a 0a 23 69 6e 63 6c 75 64 65 20 22 68 61 73 )..#include "has
4a00: 68 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 70 h.h".#include "p
4a10: 61 72 73 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 arse.h".#include
4a20: 20 3c 73 74 64 69 6f 2e 68 3e 0a 23 69 6e 63 6c <stdio.h>.#incl
4a30: 75 64 65 20 3c 73 74 64 6c 69 62 2e 68 3e 0a 23 ude <stdlib.h>.#
4a40: 69 6e 63 6c 75 64 65 20 3c 73 74 72 69 6e 67 2e include <string.
4a50: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 61 73 73 h>.#include <ass
4a60: 65 72 74 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 ert.h>.#include
4a70: 3c 73 74 64 64 65 66 2e 68 3e 0a 0a 2f 2a 0a 2a <stddef.h>../*.*
4a80: 2a 20 55 73 65 20 61 20 6d 61 63 72 6f 20 74 6f * Use a macro to
4a90: 20 72 65 70 6c 61 63 65 20 6d 65 6d 63 70 79 28 replace memcpy(
4aa0: 29 20 69 66 20 63 6f 6d 70 69 6c 65 64 20 77 69 ) if compiled wi
4ab0: 74 68 20 53 51 4c 49 54 45 5f 49 4e 4c 49 4e 45 th SQLITE_INLINE
4ac0: 5f 4d 45 4d 43 50 59 2e 0a 2a 2a 20 54 68 69 73 _MEMCPY..** This
4ad0: 20 61 6c 6c 6f 77 73 20 62 65 74 74 65 72 20 6d allows better m
4ae0: 65 61 73 75 72 65 6d 65 6e 74 73 20 6f 66 20 77 easurements of w
4af0: 68 65 72 65 20 6d 65 6d 63 70 79 28 29 20 69 73 here memcpy() is
4b00: 20 75 73 65 64 20 77 68 65 6e 20 72 75 6e 6e 69 used when runni
4b10: 6e 67 0a 2a 2a 20 63 61 63 68 65 67 72 69 6e 64 ng.** cachegrind
4b20: 2e 20 20 42 75 74 20 74 68 69 73 20 6d 61 63 72 . But this macr
4b30: 6f 20 76 65 72 73 69 6f 6e 20 6f 66 20 6d 65 6d o version of mem
4b40: 63 70 79 28 29 20 69 73 20 76 65 72 79 20 73 6c cpy() is very sl
4b50: 6f 77 20 73 6f 20 69 74 0a 2a 2a 20 73 68 6f 75 ow so it.** shou
4b60: 6c 64 20 6e 6f 74 20 62 65 20 75 73 65 64 20 69 ld not be used i
4b70: 6e 20 70 72 6f 64 75 63 74 69 6f 6e 2e 20 20 54 n production. T
4b80: 68 69 73 20 69 73 20 61 20 70 65 72 66 6f 72 6d his is a perform
4b90: 61 6e 63 65 20 6d 65 61 73 75 72 65 6d 65 6e 74 ance measurement
4ba0: 0a 2a 2a 20 68 61 63 6b 20 6f 6e 6c 79 2e 0a 2a .** hack only..*
4bb0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
4bc0: 49 4e 4c 49 4e 45 5f 4d 45 4d 43 50 59 0a 23 20 INLINE_MEMCPY.#
4bd0: 64 65 66 69 6e 65 20 6d 65 6d 63 70 79 28 44 2c define memcpy(D,
4be0: 53 2c 4e 29 20 7b 63 68 61 72 2a 78 78 64 3d 28 S,N) {char*xxd=(
4bf0: 63 68 61 72 2a 29 28 44 29 3b 63 6f 6e 73 74 20 char*)(D);const
4c00: 63 68 61 72 2a 78 78 73 3d 28 63 6f 6e 73 74 20 char*xxs=(const
4c10: 63 68 61 72 2a 29 28 53 29 3b 5c 0a 20 20 20 20 char*)(S);\.
4c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4c30: 20 20 20 20 69 6e 74 20 78 78 6e 3d 28 4e 29 3b int xxn=(N);
4c40: 77 68 69 6c 65 28 78 78 6e 2d 2d 3e 30 29 2a 28 while(xxn-->0)*(
4c50: 78 78 64 2b 2b 29 3d 2a 28 78 78 73 2b 2b 29 3b xxd++)=*(xxs++);
4c60: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
4c70: 49 66 20 63 6f 6d 70 69 6c 69 6e 67 20 66 6f 72 If compiling for
4c80: 20 61 20 70 72 6f 63 65 73 73 6f 72 20 74 68 61 a processor tha
4c90: 74 20 6c 61 63 6b 73 20 66 6c 6f 61 74 69 6e 67 t lacks floating
4ca0: 20 70 6f 69 6e 74 20 73 75 70 70 6f 72 74 2c 0a point support,.
4cb0: 2a 2a 20 73 75 62 73 74 69 74 75 74 65 20 69 6e ** substitute in
4cc0: 74 65 67 65 72 20 66 6f 72 20 66 6c 6f 61 74 69 teger for floati
4cd0: 6e 67 2d 70 6f 69 6e 74 0a 2a 2f 0a 23 69 66 64 ng-point.*/.#ifd
4ce0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 ef SQLITE_OMIT_F
4cf0: 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 23 20 LOATING_POINT.#
4d00: 64 65 66 69 6e 65 20 64 6f 75 62 6c 65 20 73 71 define double sq
4d10: 6c 69 74 65 5f 69 6e 74 36 34 0a 23 20 64 65 66 lite_int64.# def
4d20: 69 6e 65 20 66 6c 6f 61 74 20 73 71 6c 69 74 65 ine float sqlite
4d30: 5f 69 6e 74 36 34 0a 23 20 64 65 66 69 6e 65 20 _int64.# define
4d40: 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 20 LONGDOUBLE_TYPE
4d50: 73 71 6c 69 74 65 5f 69 6e 74 36 34 0a 23 20 69 sqlite_int64.# i
4d60: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 42 49 47 fndef SQLITE_BIG
4d70: 5f 44 42 4c 0a 23 20 20 20 64 65 66 69 6e 65 20 _DBL.# define
4d80: 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c 20 28 SQLITE_BIG_DBL (
4d90: 28 28 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 29 ((sqlite3_int64)
4da0: 31 29 3c 3c 35 30 29 0a 23 20 65 6e 64 69 66 0a 1)<<50).# endif.
4db0: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
4dc0: 4f 4d 49 54 5f 44 41 54 45 54 49 4d 45 5f 46 55 OMIT_DATETIME_FU
4dd0: 4e 43 53 20 31 0a 23 20 64 65 66 69 6e 65 20 53 NCS 1.# define S
4de0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43 45 QLITE_OMIT_TRACE
4df0: 20 31 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 1.# undef SQLIT
4e00: 45 5f 4d 49 58 45 44 5f 45 4e 44 49 41 4e 5f 36 E_MIXED_ENDIAN_6
4e10: 34 42 49 54 5f 46 4c 4f 41 54 0a 23 20 75 6e 64 4BIT_FLOAT.# und
4e20: 65 66 20 53 51 4c 49 54 45 5f 48 41 56 45 5f 49 ef SQLITE_HAVE_I
4e30: 53 4e 41 4e 0a 23 65 6e 64 69 66 0a 23 69 66 6e SNAN.#endif.#ifn
4e40: 64 65 66 20 53 51 4c 49 54 45 5f 42 49 47 5f 44 def SQLITE_BIG_D
4e50: 42 4c 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 BL.# define SQLI
4e60: 54 45 5f 42 49 47 5f 44 42 4c 20 28 31 65 39 39 TE_BIG_DBL (1e99
4e70: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
4e80: 4f 4d 49 54 5f 54 45 4d 50 44 42 20 69 73 20 73 OMIT_TEMPDB is s
4e90: 65 74 20 74 6f 20 31 20 69 66 20 53 51 4c 49 54 et to 1 if SQLIT
4ea0: 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 20 69 73 E_OMIT_TEMPDB is
4eb0: 20 64 65 66 69 6e 65 64 2c 20 6f 72 20 30 0a 2a defined, or 0.*
4ec0: 2a 20 61 66 74 65 72 77 61 72 64 2e 20 48 61 76 * afterward. Hav
4ed0: 69 6e 67 20 74 68 69 73 20 6d 61 63 72 6f 20 61 ing this macro a
4ee0: 6c 6c 6f 77 73 20 75 73 20 74 6f 20 63 61 75 73 llows us to caus
4ef0: 65 20 74 68 65 20 43 20 63 6f 6d 70 69 6c 65 72 e the C compiler
4f00: 0a 2a 2a 20 74 6f 20 6f 6d 69 74 20 63 6f 64 65 .** to omit code
4f10: 20 75 73 65 64 20 62 79 20 54 45 4d 50 20 74 61 used by TEMP ta
4f20: 62 6c 65 73 20 77 69 74 68 6f 75 74 20 6d 65 73 bles without mes
4f30: 73 79 20 23 69 66 6e 64 65 66 20 73 74 61 74 65 sy #ifndef state
4f40: 6d 65 6e 74 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 ments..*/.#ifdef
4f50: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d SQLITE_OMIT_TEM
4f60: 50 44 42 0a 23 64 65 66 69 6e 65 20 4f 4d 49 54 PDB.#define OMIT
4f70: 5f 54 45 4d 50 44 42 20 31 0a 23 65 6c 73 65 0a _TEMPDB 1.#else.
4f80: 23 64 65 66 69 6e 65 20 4f 4d 49 54 5f 54 45 4d #define OMIT_TEM
4f90: 50 44 42 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a PDB 0.#endif../*
4fa0: 0a 2a 2a 20 54 68 65 20 22 66 69 6c 65 20 66 6f .** The "file fo
4fb0: 72 6d 61 74 22 20 6e 75 6d 62 65 72 20 69 73 20 rmat" number is
4fc0: 61 6e 20 69 6e 74 65 67 65 72 20 74 68 61 74 20 an integer that
4fd0: 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 20 77 is incremented w
4fe0: 68 65 6e 65 76 65 72 0a 2a 2a 20 74 68 65 20 56 henever.** the V
4ff0: 44 42 45 2d 6c 65 76 65 6c 20 66 69 6c 65 20 66 DBE-level file f
5000: 6f 72 6d 61 74 20 63 68 61 6e 67 65 73 2e 20 20 ormat changes.
5010: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 The following ma
5020: 63 72 6f 73 20 64 65 66 69 6e 65 20 74 68 65 0a cros define the.
5030: 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74 20 66 ** the default f
5040: 69 6c 65 20 66 6f 72 6d 61 74 20 66 6f 72 20 6e ile format for n
5050: 65 77 20 64 61 74 61 62 61 73 65 73 20 61 6e 64 ew databases and
5060: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 66 69 6c the maximum fil
5070: 65 20 66 6f 72 6d 61 74 0a 2a 2a 20 74 68 61 74 e format.** that
5080: 20 74 68 65 20 6c 69 62 72 61 72 79 20 63 61 6e the library can
5090: 20 72 65 61 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e read..*/.#defin
50a0: 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f 46 49 4c e SQLITE_MAX_FIL
50b0: 45 5f 46 4f 52 4d 41 54 20 34 0a 23 69 66 6e 64 E_FORMAT 4.#ifnd
50c0: 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ef SQLITE_DEFAUL
50d0: 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 0a 23 20 T_FILE_FORMAT.#
50e0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 define SQLITE_DE
50f0: 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 FAULT_FILE_FORMA
5100: 54 20 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a T 4.#endif../*.*
5110: 2a 20 44 65 74 65 72 6d 69 6e 65 20 77 68 65 74 * Determine whet
5120: 68 65 72 20 74 72 69 67 67 65 72 73 20 61 72 65 her triggers are
5130: 20 72 65 63 75 72 73 69 76 65 20 62 79 20 64 65 recursive by de
5140: 66 61 75 6c 74 2e 20 20 54 68 69 73 20 63 61 6e fault. This can
5150: 20 62 65 0a 2a 2a 20 63 68 61 6e 67 65 64 20 61 be.** changed a
5160: 74 20 72 75 6e 2d 74 69 6d 65 20 75 73 69 6e 67 t run-time using
5170: 20 61 20 70 72 61 67 6d 61 2e 0a 2a 2f 0a 23 69 a pragma..*/.#i
5180: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 fndef SQLITE_DEF
5190: 41 55 4c 54 5f 52 45 43 55 52 53 49 56 45 5f 54 AULT_RECURSIVE_T
51a0: 52 49 47 47 45 52 53 0a 23 20 64 65 66 69 6e 65 RIGGERS.# define
51b0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
51c0: 52 45 43 55 52 53 49 56 45 5f 54 52 49 47 47 45 RECURSIVE_TRIGGE
51d0: 52 53 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a RS 0.#endif../*.
51e0: 2a 2a 20 50 72 6f 76 69 64 65 20 61 20 64 65 66 ** Provide a def
51f0: 61 75 6c 74 20 76 61 6c 75 65 20 66 6f 72 20 53 ault value for S
5200: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
5210: 20 69 6e 20 63 61 73 65 20 69 74 20 69 73 20 6e in case it is n
5220: 6f 74 20 73 70 65 63 69 66 69 65 64 0a 2a 2a 20 ot specified.**
5230: 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c on the command-l
5240: 69 6e 65 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ine.*/.#ifndef S
5250: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
5260: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
5270: 5f 54 45 4d 50 5f 53 54 4f 52 45 20 31 0a 23 65 _TEMP_STORE 1.#e
5280: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 6e ndif../*.** If n
5290: 6f 20 76 61 6c 75 65 20 68 61 73 20 62 65 65 6e o value has been
52a0: 20 70 72 6f 76 69 64 65 64 20 66 6f 72 20 53 51 provided for SQ
52b0: 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f LITE_MAX_WORKER_
52c0: 54 48 52 45 41 44 53 2c 20 6f 72 20 69 66 0a 2a THREADS, or if.*
52d0: 2a 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 * SQLITE_TEMP_ST
52e0: 4f 52 45 20 69 73 20 73 65 74 20 74 6f 20 33 20 ORE is set to 3
52f0: 28 6e 65 76 65 72 20 75 73 65 20 74 65 6d 70 6f (never use tempo
5300: 72 61 72 79 20 66 69 6c 65 73 29 2c 20 73 65 74 rary files), set
5310: 20 69 74 0a 2a 2a 20 74 6f 20 7a 65 72 6f 2e 0a it.** to zero..
5320: 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 54 45 */.#if SQLITE_TE
5330: 4d 50 5f 53 54 4f 52 45 3d 3d 33 20 7c 7c 20 53 MP_STORE==3 || S
5340: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
5350: 3d 3d 30 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 ==0.# undef SQLI
5360: 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 TE_MAX_WORKER_TH
5370: 52 45 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 READS.# define S
5380: 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 QLITE_MAX_WORKER
5390: 5f 54 48 52 45 41 44 53 20 30 0a 23 65 6e 64 69 _THREADS 0.#endi
53a0: 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 f.#ifndef SQLITE
53b0: 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 _MAX_WORKER_THRE
53c0: 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c ADS.# define SQL
53d0: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
53e0: 48 52 45 41 44 53 20 38 0a 23 65 6e 64 69 66 0a HREADS 8.#endif.
53f0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
5400: 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 EFAULT_WORKER_TH
5410: 52 45 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 READS.# define S
5420: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f QLITE_DEFAULT_WO
5430: 52 4b 45 52 5f 54 48 52 45 41 44 53 20 30 0a 23 RKER_THREADS 0.#
5440: 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
5450: 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f _DEFAULT_WORKER_
5460: 54 48 52 45 41 44 53 3e 53 51 4c 49 54 45 5f 4d THREADS>SQLITE_M
5470: 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 AX_WORKER_THREAD
5480: 53 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 S.# undef SQLITE
5490: 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 _MAX_WORKER_THRE
54a0: 41 44 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c ADS.# define SQL
54b0: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
54c0: 48 52 45 41 44 53 20 53 51 4c 49 54 45 5f 44 45 HREADS SQLITE_DE
54d0: 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 52 FAULT_WORKER_THR
54e0: 45 41 44 53 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a EADS.#endif../*.
54f0: 2a 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 69 ** The default i
5500: 6e 69 74 69 61 6c 20 61 6c 6c 6f 63 61 74 69 6f nitial allocatio
5510: 6e 20 66 6f 72 20 74 68 65 20 70 61 67 65 63 61 n for the pageca
5520: 63 68 65 20 77 68 65 6e 20 75 73 69 6e 67 20 73 che when using s
5530: 65 70 61 72 61 74 65 0a 2a 2a 20 70 61 67 65 63 eparate.** pagec
5540: 61 63 68 65 73 20 66 6f 72 20 65 61 63 68 20 64 aches for each d
5550: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
5560: 6f 6e 2e 20 20 41 20 70 6f 73 69 74 69 76 65 20 on. A positive
5570: 6e 75 6d 62 65 72 20 69 73 20 74 68 65 0a 2a 2a number is the.**
5580: 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 number of pages
5590: 2e 20 20 41 20 6e 65 67 61 74 69 76 65 20 6e 75 . A negative nu
55a0: 6d 62 65 72 20 4e 20 74 72 61 6e 73 6c 61 74 69 mber N translati
55b0: 6f 6e 73 20 6d 65 61 6e 73 20 74 68 61 74 20 61 ons means that a
55c0: 20 62 75 66 66 65 72 0a 2a 2a 20 6f 66 20 2d 31 buffer.** of -1
55d0: 30 32 34 2a 4e 20 62 79 74 65 73 20 69 73 20 61 024*N bytes is a
55e0: 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 75 73 65 llocated and use
55f0: 64 20 66 6f 72 20 61 73 20 6d 61 6e 79 20 70 61 d for as many pa
5600: 67 65 73 20 61 73 20 69 74 20 77 69 6c 6c 20 68 ges as it will h
5610: 6f 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 64 old..**.** The d
5620: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20 efault value of
5630: 22 32 30 22 20 77 61 73 20 63 68 6f 6f 73 65 6e "20" was choosen
5640: 20 74 6f 20 6d 69 6e 69 6d 69 7a 65 20 74 68 65 to minimize the
5650: 20 72 75 6e 2d 74 69 6d 65 20 6f 66 20 74 68 65 run-time of the
5660: 0a 2a 2a 20 73 70 65 65 64 74 65 73 74 31 20 74 .** speedtest1 t
5670: 65 73 74 20 70 72 6f 67 72 61 6d 20 77 69 74 68 est program with
5680: 20 6f 70 74 69 6f 6e 73 3a 20 2d 2d 73 68 72 69 options: --shri
5690: 6e 6b 2d 6d 65 6d 6f 72 79 20 2d 2d 72 65 70 72 nk-memory --repr
56a0: 65 70 61 72 65 0a 2a 2f 0a 23 69 66 6e 64 65 66 epare.*/.#ifndef
56b0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
56c0: 50 43 41 43 48 45 5f 49 4e 49 54 53 5a 0a 23 20 PCACHE_INITSZ.#
56d0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 define SQLITE_DE
56e0: 46 41 55 4c 54 5f 50 43 41 43 48 45 5f 49 4e 49 FAULT_PCACHE_INI
56f0: 54 53 5a 20 32 30 0a 23 65 6e 64 69 66 0a 0a 2f TSZ 20.#endif../
5700: 2a 0a 2a 2a 20 44 65 66 61 75 6c 74 20 76 61 6c *.** Default val
5710: 75 65 20 66 6f 72 20 74 68 65 20 53 51 4c 49 54 ue for the SQLIT
5720: 45 5f 43 4f 4e 46 49 47 5f 53 4f 52 54 45 52 52 E_CONFIG_SORTERR
5730: 45 46 5f 53 49 5a 45 20 6f 70 74 69 6f 6e 2e 0a EF_SIZE option..
5740: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
5750: 45 5f 44 45 46 41 55 4c 54 5f 53 4f 52 54 45 52 E_DEFAULT_SORTER
5760: 52 45 46 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e REF_SIZE.# defin
5770: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
5780: 5f 53 4f 52 54 45 52 52 45 46 5f 53 49 5a 45 20 _SORTERREF_SIZE
5790: 30 78 37 66 66 66 66 66 66 66 0a 23 65 6e 64 69 0x7fffffff.#endi
57a0: 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 63 6f 6d f../*.** The com
57b0: 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e pile-time option
57c0: 73 20 53 51 4c 49 54 45 5f 4d 4d 41 50 5f 52 45 s SQLITE_MMAP_RE
57d0: 41 44 57 52 49 54 45 20 61 6e 64 20 0a 2a 2a 20 ADWRITE and .**
57e0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41 SQLITE_ENABLE_BA
57f0: 54 43 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 TCH_ATOMIC_WRITE
5800: 20 61 72 65 20 6e 6f 74 20 63 6f 6d 70 61 74 69 are not compati
5810: 62 6c 65 20 77 69 74 68 20 6f 6e 65 20 61 6e 6f ble with one ano
5820: 74 68 65 72 2e 0a 2a 2a 20 59 6f 75 20 6d 75 73 ther..** You mus
5830: 74 20 63 68 6f 6f 73 65 20 6f 6e 65 20 6f 72 20 t choose one or
5840: 74 68 65 20 6f 74 68 65 72 20 28 6f 72 20 6e 65 the other (or ne
5850: 69 74 68 65 72 29 20 62 75 74 20 6e 6f 74 20 62 ither) but not b
5860: 6f 74 68 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 oth..*/.#if defi
5870: 6e 65 64 28 53 51 4c 49 54 45 5f 4d 4d 41 50 5f ned(SQLITE_MMAP_
5880: 52 45 41 44 57 52 49 54 45 29 20 26 26 20 64 65 READWRITE) && de
5890: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
58a0: 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f 4d 49 43 BLE_BATCH_ATOMIC
58b0: 5f 57 52 49 54 45 29 0a 23 65 72 72 6f 72 20 43 _WRITE).#error C
58c0: 61 6e 6e 6f 74 20 75 73 65 20 62 6f 74 68 20 53 annot use both S
58d0: 51 4c 49 54 45 5f 4d 4d 41 50 5f 52 45 41 44 57 QLITE_MMAP_READW
58e0: 52 49 54 45 20 61 6e 64 20 53 51 4c 49 54 45 5f RITE and SQLITE_
58f0: 45 4e 41 42 4c 45 5f 42 41 54 43 48 5f 41 54 4f ENABLE_BATCH_ATO
5900: 4d 49 43 5f 57 52 49 54 45 0a 23 65 6e 64 69 66 MIC_WRITE.#endif
5910: 0a 0a 2f 2a 0a 2a 2a 20 47 43 43 20 64 6f 65 73 ../*.** GCC does
5920: 20 6e 6f 74 20 64 65 66 69 6e 65 20 74 68 65 20 not define the
5930: 6f 66 66 73 65 74 6f 66 28 29 20 6d 61 63 72 6f offsetof() macro
5940: 20 73 6f 20 77 65 27 6c 6c 20 68 61 76 65 20 74 so we'll have t
5950: 6f 20 64 6f 20 69 74 0a 2a 2a 20 6f 75 72 73 65 o do it.** ourse
5960: 6c 76 65 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 lves..*/.#ifndef
5970: 20 6f 66 66 73 65 74 6f 66 0a 23 64 65 66 69 6e offsetof.#defin
5980: 65 20 6f 66 66 73 65 74 6f 66 28 53 54 52 55 43 e offsetof(STRUC
5990: 54 55 52 45 2c 46 49 45 4c 44 29 20 28 28 69 6e TURE,FIELD) ((in
59a0: 74 29 28 28 63 68 61 72 2a 29 26 28 28 53 54 52 t)((char*)&((STR
59b0: 55 43 54 55 52 45 2a 29 30 29 2d 3e 46 49 45 4c UCTURE*)0)->FIEL
59c0: 44 29 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a D)).#endif../*.*
59d0: 2a 20 4d 61 63 72 6f 73 20 74 6f 20 63 6f 6d 70 * Macros to comp
59e0: 75 74 65 20 6d 69 6e 69 6d 75 6d 20 61 6e 64 20 ute minimum and
59f0: 6d 61 78 69 6d 75 6d 20 6f 66 20 74 77 6f 20 6e maximum of two n
5a00: 75 6d 62 65 72 73 2e 0a 2a 2f 0a 23 69 66 6e 64 umbers..*/.#ifnd
5a10: 65 66 20 4d 49 4e 0a 23 20 64 65 66 69 6e 65 20 ef MIN.# define
5a20: 4d 49 4e 28 41 2c 42 29 20 28 28 41 29 3c 28 42 MIN(A,B) ((A)<(B
5a30: 29 3f 28 41 29 3a 28 42 29 29 0a 23 65 6e 64 69 )?(A):(B)).#endi
5a40: 66 0a 23 69 66 6e 64 65 66 20 4d 41 58 0a 23 20 f.#ifndef MAX.#
5a50: 64 65 66 69 6e 65 20 4d 41 58 28 41 2c 42 29 20 define MAX(A,B)
5a60: 28 28 41 29 3e 28 42 29 3f 28 41 29 3a 28 42 29 ((A)>(B)?(A):(B)
5a70: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
5a80: 53 77 61 70 20 74 77 6f 20 6f 62 6a 65 63 74 73 Swap two objects
5a90: 20 6f 66 20 74 79 70 65 20 54 59 50 45 2e 0a 2a of type TYPE..*
5aa0: 2f 0a 23 64 65 66 69 6e 65 20 53 57 41 50 28 54 /.#define SWAP(T
5ab0: 59 50 45 2c 41 2c 42 29 20 7b 54 59 50 45 20 74 YPE,A,B) {TYPE t
5ac0: 3d 41 3b 20 41 3d 42 3b 20 42 3d 74 3b 7d 0a 0a =A; A=B; B=t;}..
5ad0: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 /*.** Check to s
5ae0: 65 65 20 69 66 20 74 68 69 73 20 6d 61 63 68 69 ee if this machi
5af0: 6e 65 20 75 73 65 73 20 45 42 43 44 49 43 2e 20 ne uses EBCDIC.
5b00: 20 28 59 65 73 2c 20 62 65 6c 69 65 76 65 20 69 (Yes, believe i
5b10: 74 20 6f 72 0a 2a 2a 20 6e 6f 74 2c 20 74 68 65 t or.** not, the
5b20: 72 65 20 61 72 65 20 73 74 69 6c 6c 20 6d 61 63 re are still mac
5b30: 68 69 6e 65 73 20 6f 75 74 20 74 68 65 72 65 20 hines out there
5b40: 74 68 61 74 20 75 73 65 20 45 42 43 44 49 43 2e that use EBCDIC.
5b50: 29 0a 2a 2f 0a 23 69 66 20 27 41 27 20 3d 3d 20 ).*/.#if 'A' ==
5b60: 27 5c 33 30 31 27 0a 23 20 64 65 66 69 6e 65 20 '\301'.# define
5b70: 53 51 4c 49 54 45 5f 45 42 43 44 49 43 20 31 0a SQLITE_EBCDIC 1.
5b80: 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53 #else.# define S
5b90: 51 4c 49 54 45 5f 41 53 43 49 49 20 31 0a 23 65 QLITE_ASCII 1.#e
5ba0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 ndif../*.** Inte
5bb0: 67 65 72 73 20 6f 66 20 6b 6e 6f 77 6e 20 73 69 gers of known si
5bc0: 7a 65 73 2e 20 20 54 68 65 73 65 20 74 79 70 65 zes. These type
5bd0: 64 65 66 73 20 6d 69 67 68 74 20 63 68 61 6e 67 defs might chang
5be0: 65 20 66 6f 72 20 61 72 63 68 69 74 65 63 74 75 e for architectu
5bf0: 72 65 73 0a 2a 2a 20 77 68 65 72 65 20 74 68 65 res.** where the
5c00: 20 73 69 7a 65 73 20 76 65 72 79 2e 20 20 50 72 sizes very. Pr
5c10: 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f eprocessor macro
5c20: 73 20 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 s are available
5c30: 73 6f 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 74 so that the.** t
5c40: 79 70 65 73 20 63 61 6e 20 62 65 20 63 6f 6e 76 ypes can be conv
5c50: 65 6e 69 65 6e 74 6c 79 20 72 65 64 65 66 69 6e eniently redefin
5c60: 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 79 ed at compile-ty
5c70: 70 65 2e 20 20 4c 69 6b 65 20 74 68 69 73 3a 0a pe. Like this:.
5c80: 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 20 63 63 **.** cc
5c90: 20 27 2d 44 55 49 4e 54 50 54 52 5f 54 59 50 45 '-DUINTPTR_TYPE
5ca0: 3d 6c 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 27 20 =long long int'
5cb0: 2e 2e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 55 ....*/.#ifndef U
5cc0: 49 4e 54 33 32 5f 54 59 50 45 0a 23 20 69 66 64 INT32_TYPE.# ifd
5cd0: 65 66 20 48 41 56 45 5f 55 49 4e 54 33 32 5f 54 ef HAVE_UINT32_T
5ce0: 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 33 .# define UINT3
5cf0: 32 5f 54 59 50 45 20 75 69 6e 74 33 32 5f 74 0a 2_TYPE uint32_t.
5d00: 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 # else.# define
5d10: 20 55 49 4e 54 33 32 5f 54 59 50 45 20 75 6e 73 UINT32_TYPE uns
5d20: 69 67 6e 65 64 20 69 6e 74 0a 23 20 65 6e 64 69 igned int.# endi
5d30: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
5d40: 20 55 49 4e 54 31 36 5f 54 59 50 45 0a 23 20 69 UINT16_TYPE.# i
5d50: 66 64 65 66 20 48 41 56 45 5f 55 49 4e 54 31 36 fdef HAVE_UINT16
5d60: 5f 54 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e _T.# define UIN
5d70: 54 31 36 5f 54 59 50 45 20 75 69 6e 74 31 36 5f T16_TYPE uint16_
5d80: 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 t.# else.# defi
5d90: 6e 65 20 55 49 4e 54 31 36 5f 54 59 50 45 20 75 ne UINT16_TYPE u
5da0: 6e 73 69 67 6e 65 64 20 73 68 6f 72 74 20 69 6e nsigned short in
5db0: 74 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 t.# endif.#endif
5dc0: 0a 23 69 66 6e 64 65 66 20 49 4e 54 31 36 5f 54 .#ifndef INT16_T
5dd0: 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 YPE.# ifdef HAVE
5de0: 5f 49 4e 54 31 36 5f 54 0a 23 20 20 64 65 66 69 _INT16_T.# defi
5df0: 6e 65 20 49 4e 54 31 36 5f 54 59 50 45 20 69 6e ne INT16_TYPE in
5e00: 74 31 36 5f 74 0a 23 20 65 6c 73 65 0a 23 20 20 t16_t.# else.#
5e10: 64 65 66 69 6e 65 20 49 4e 54 31 36 5f 54 59 50 define INT16_TYP
5e20: 45 20 73 68 6f 72 74 20 69 6e 74 0a 23 20 65 6e E short int.# en
5e30: 64 69 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 dif.#endif.#ifnd
5e40: 65 66 20 55 49 4e 54 38 5f 54 59 50 45 0a 23 20 ef UINT8_TYPE.#
5e50: 69 66 64 65 66 20 48 41 56 45 5f 55 49 4e 54 38 ifdef HAVE_UINT8
5e60: 5f 54 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e _T.# define UIN
5e70: 54 38 5f 54 59 50 45 20 75 69 6e 74 38 5f 74 0a T8_TYPE uint8_t.
5e80: 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 # else.# define
5e90: 20 55 49 4e 54 38 5f 54 59 50 45 20 75 6e 73 69 UINT8_TYPE unsi
5ea0: 67 6e 65 64 20 63 68 61 72 0a 23 20 65 6e 64 69 gned char.# endi
5eb0: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
5ec0: 20 49 4e 54 38 5f 54 59 50 45 0a 23 20 69 66 64 INT8_TYPE.# ifd
5ed0: 65 66 20 48 41 56 45 5f 49 4e 54 38 5f 54 0a 23 ef HAVE_INT8_T.#
5ee0: 20 20 64 65 66 69 6e 65 20 49 4e 54 38 5f 54 59 define INT8_TY
5ef0: 50 45 20 69 6e 74 38 5f 74 0a 23 20 65 6c 73 65 PE int8_t.# else
5f00: 0a 23 20 20 64 65 66 69 6e 65 20 49 4e 54 38 5f .# define INT8_
5f10: 54 59 50 45 20 73 69 67 6e 65 64 20 63 68 61 72 TYPE signed char
5f20: 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a .# endif.#endif.
5f30: 23 69 66 6e 64 65 66 20 4c 4f 4e 47 44 4f 55 42 #ifndef LONGDOUB
5f40: 4c 45 5f 54 59 50 45 0a 23 20 64 65 66 69 6e 65 LE_TYPE.# define
5f50: 20 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 LONGDOUBLE_TYPE
5f60: 20 6c 6f 6e 67 20 64 6f 75 62 6c 65 0a 23 65 6e long double.#en
5f70: 64 69 66 0a 74 79 70 65 64 65 66 20 73 71 6c 69 dif.typedef sqli
5f80: 74 65 5f 69 6e 74 36 34 20 69 36 34 3b 20 20 20 te_int64 i64;
5f90: 20 20 20 20 20 20 20 2f 2a 20 38 2d 62 79 74 65 /* 8-byte
5fa0: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 signed integer
5fb0: 2a 2f 0a 74 79 70 65 64 65 66 20 73 71 6c 69 74 */.typedef sqlit
5fc0: 65 5f 75 69 6e 74 36 34 20 75 36 34 3b 20 20 20 e_uint64 u64;
5fd0: 20 20 20 20 20 20 2f 2a 20 38 2d 62 79 74 65 20 /* 8-byte
5fe0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
5ff0: 20 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e 54 */.typedef UINT
6000: 33 32 5f 54 59 50 45 20 75 33 32 3b 20 20 20 20 32_TYPE u32;
6010: 20 20 20 20 20 20 20 2f 2a 20 34 2d 62 79 74 65 /* 4-byte
6020: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 unsigned intege
6030: 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e r */.typedef UIN
6040: 54 31 36 5f 54 59 50 45 20 75 31 36 3b 20 20 20 T16_TYPE u16;
6050: 20 20 20 20 20 20 20 20 2f 2a 20 32 2d 62 79 74 /* 2-byt
6060: 65 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 e unsigned integ
6070: 65 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e er */.typedef IN
6080: 54 31 36 5f 54 59 50 45 20 69 31 36 3b 20 20 20 T16_TYPE i16;
6090: 20 20 20 20 20 20 20 20 20 2f 2a 20 32 2d 62 79 /* 2-by
60a0: 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 te signed intege
60b0: 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e r */.typedef UIN
60c0: 54 38 5f 54 59 50 45 20 75 38 3b 20 20 20 20 20 T8_TYPE u8;
60d0: 20 20 20 20 20 20 20 20 2f 2a 20 31 2d 62 79 74 /* 1-byt
60e0: 65 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 e unsigned integ
60f0: 65 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e er */.typedef IN
6100: 54 38 5f 54 59 50 45 20 69 38 3b 20 20 20 20 20 T8_TYPE i8;
6110: 20 20 20 20 20 20 20 20 20 2f 2a 20 31 2d 62 79 /* 1-by
6120: 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 te signed intege
6130: 72 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 49 r */../*.** SQLI
6140: 54 45 5f 4d 41 58 5f 55 33 32 20 69 73 20 61 20 TE_MAX_U32 is a
6150: 75 36 34 20 63 6f 6e 73 74 61 6e 74 20 74 68 61 u64 constant tha
6160: 74 20 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d t is the maximum
6170: 20 75 36 34 20 76 61 6c 75 65 0a 2a 2a 20 74 68 u64 value.** th
6180: 61 74 20 63 61 6e 20 62 65 20 73 74 6f 72 65 64 at can be stored
6190: 20 69 6e 20 61 20 75 33 32 20 77 69 74 68 6f 75 in a u32 withou
61a0: 74 20 6c 6f 73 73 20 6f 66 20 64 61 74 61 2e 20 t loss of data.
61b0: 20 54 68 65 20 76 61 6c 75 65 0a 2a 2a 20 69 73 The value.** is
61c0: 20 30 78 30 30 30 30 30 30 30 30 66 66 66 66 66 0x00000000fffff
61d0: 66 66 66 2e 20 20 42 75 74 20 62 65 63 61 75 73 fff. But becaus
61e0: 65 20 6f 66 20 71 75 69 72 6b 73 20 6f 66 20 73 e of quirks of s
61f0: 6f 6d 65 20 63 6f 6d 70 69 6c 65 72 73 2c 20 77 ome compilers, w
6200: 65 0a 2a 2a 20 68 61 76 65 20 74 6f 20 73 70 65 e.** have to spe
6210: 63 69 66 79 20 74 68 65 20 76 61 6c 75 65 20 69 cify the value i
6220: 6e 20 74 68 65 20 6c 65 73 73 20 69 6e 74 75 69 n the less intui
6230: 74 69 76 65 20 6d 61 6e 6e 65 72 20 73 68 6f 77 tive manner show
6240: 6e 3a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 n:.*/.#define SQ
6250: 4c 49 54 45 5f 4d 41 58 5f 55 33 32 20 20 28 28 LITE_MAX_U32 ((
6260: 28 28 75 36 34 29 31 29 3c 3c 33 32 29 2d 31 29 ((u64)1)<<32)-1)
6270: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 ../*.** The data
6280: 74 79 70 65 20 75 73 65 64 20 74 6f 20 73 74 6f type used to sto
6290: 72 65 20 65 73 74 69 6d 61 74 65 73 20 6f 66 20 re estimates of
62a0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f the number of ro
62b0: 77 73 20 69 6e 20 61 0a 2a 2a 20 74 61 62 6c 65 ws in a.** table
62c0: 20 6f 72 20 69 6e 64 65 78 2e 20 20 54 68 69 73 or index. This
62d0: 20 69 73 20 61 6e 20 75 6e 73 69 67 6e 65 64 20 is an unsigned
62e0: 69 6e 74 65 67 65 72 20 74 79 70 65 2e 20 20 46 integer type. F
62f0: 6f 72 20 39 39 2e 39 25 20 6f 66 0a 2a 2a 20 74 or 99.9% of.** t
6300: 68 65 20 77 6f 72 6c 64 2c 20 61 20 33 32 2d 62 he world, a 32-b
6310: 69 74 20 69 6e 74 65 67 65 72 20 69 73 20 73 75 it integer is su
6320: 66 66 69 63 69 65 6e 74 2e 20 20 42 75 74 20 61 fficient. But a
6330: 20 36 34 2d 62 69 74 20 69 6e 74 65 67 65 72 0a 64-bit integer.
6340: 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 ** can be used a
6350: 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 69 t compile-time i
6360: 66 20 64 65 73 69 72 65 64 2e 0a 2a 2f 0a 23 69 f desired..*/.#i
6370: 66 64 65 66 20 53 51 4c 49 54 45 5f 36 34 42 49 fdef SQLITE_64BI
6380: 54 5f 53 54 41 54 53 0a 20 74 79 70 65 64 65 66 T_STATS. typedef
6390: 20 75 36 34 20 74 52 6f 77 63 6e 74 3b 20 20 20 u64 tRowcnt;
63a0: 20 2f 2a 20 36 34 2d 62 69 74 20 6f 6e 6c 79 20 /* 64-bit only
63b0: 69 66 20 72 65 71 75 65 73 74 65 64 20 61 74 20 if requested at
63c0: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 2a 2f 0a compile-time */.
63d0: 23 65 6c 73 65 0a 20 74 79 70 65 64 65 66 20 75 #else. typedef u
63e0: 33 32 20 74 52 6f 77 63 6e 74 3b 20 20 20 20 2f 32 tRowcnt; /
63f0: 2a 20 33 32 2d 62 69 74 20 69 73 20 74 68 65 20 * 32-bit is the
6400: 64 65 66 61 75 6c 74 20 2a 2f 0a 23 65 6e 64 69 default */.#endi
6410: 66 0a 0a 2f 2a 0a 2a 2a 20 45 73 74 69 6d 61 74 f../*.** Estimat
6420: 65 64 20 71 75 61 6e 74 69 74 69 65 73 20 75 73 ed quantities us
6430: 65 64 20 66 6f 72 20 71 75 65 72 79 20 70 6c 61 ed for query pla
6440: 6e 6e 69 6e 67 20 61 72 65 20 73 74 6f 72 65 64 nning are stored
6450: 20 61 73 20 31 36 2d 62 69 74 0a 2a 2a 20 6c 6f as 16-bit.** lo
6460: 67 61 72 69 74 68 6d 73 2e 20 20 46 6f 72 20 71 garithms. For q
6470: 75 61 6e 74 69 74 79 20 58 2c 20 74 68 65 20 76 uantity X, the v
6480: 61 6c 75 65 20 73 74 6f 72 65 64 20 69 73 20 31 alue stored is 1
6490: 30 2a 6c 6f 67 32 28 58 29 2e 20 20 54 68 69 73 0*log2(X). This
64a0: 0a 2a 2a 20 67 69 76 65 73 20 61 20 70 6f 73 73 .** gives a poss
64b0: 69 62 6c 65 20 72 61 6e 67 65 20 6f 66 20 76 61 ible range of va
64c0: 6c 75 65 73 20 6f 66 20 61 70 70 72 6f 78 69 6d lues of approxim
64d0: 61 74 65 6c 79 20 31 2e 30 65 39 38 36 20 74 6f ately 1.0e986 to
64e0: 20 31 65 2d 39 38 36 2e 0a 2a 2a 20 42 75 74 20 1e-986..** But
64f0: 74 68 65 20 61 6c 6c 6f 77 65 64 20 76 61 6c 75 the allowed valu
6500: 65 73 20 61 72 65 20 22 67 72 61 69 6e 79 22 2e es are "grainy".
6510: 20 20 4e 6f 74 20 65 76 65 72 79 20 76 61 6c 75 Not every valu
6520: 65 20 69 73 20 72 65 70 72 65 73 65 6e 74 61 62 e is representab
6530: 6c 65 2e 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 le..** For examp
6540: 6c 65 2c 20 71 75 61 6e 74 69 74 69 65 73 20 31 le, quantities 1
6550: 36 20 61 6e 64 20 31 37 20 61 72 65 20 62 6f 74 6 and 17 are bot
6560: 68 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 h represented by
6570: 20 61 20 4c 6f 67 45 73 74 0a 2a 2a 20 6f 66 20 a LogEst.** of
6580: 34 30 2e 20 20 48 6f 77 65 76 65 72 2c 20 73 69 40. However, si
6590: 6e 63 65 20 4c 6f 67 45 73 74 20 71 75 61 6e 74 nce LogEst quant
65a0: 69 74 69 65 73 20 61 72 65 20 73 75 70 70 6f 73 ities are suppos
65b0: 65 20 74 6f 20 62 65 20 65 73 74 69 6d 61 74 65 e to be estimate
65c0: 73 2c 0a 2a 2a 20 6e 6f 74 20 65 78 61 63 74 20 s,.** not exact
65d0: 76 61 6c 75 65 73 2c 20 74 68 69 73 20 69 6d 70 values, this imp
65e0: 72 65 63 69 73 69 6f 6e 20 69 73 20 6e 6f 74 20 recision is not
65f0: 61 20 70 72 6f 62 6c 65 6d 2e 0a 2a 2a 0a 2a 2a a problem..**.**
6600: 20 22 4c 6f 67 45 73 74 22 20 69 73 20 73 68 6f "LogEst" is sho
6610: 72 74 20 66 6f 72 20 22 4c 6f 67 61 72 69 74 68 rt for "Logarith
6620: 6d 69 63 20 45 73 74 69 6d 61 74 65 22 2e 0a 2a mic Estimate"..*
6630: 2a 0a 2a 2a 20 45 78 61 6d 70 6c 65 73 3a 0a 2a *.** Examples:.*
6640: 2a 20 20 20 20 20 20 31 20 2d 3e 20 30 20 20 20 * 1 -> 0
6650: 20 20 20 20 20 20 20 20 20 20 20 32 30 20 2d 3e 20 ->
6660: 20 34 33 20 20 20 20 20 20 20 20 20 20 31 30 30 43 100
6670: 30 30 20 2d 3e 20 31 33 32 0a 2a 2a 20 20 20 20 00 -> 132.**
6680: 20 20 32 20 2d 3e 20 31 30 20 20 20 20 20 20 20 2 -> 10
6690: 20 20 20 20 20 20 32 35 20 2d 3e 20 34 36 20 20 25 -> 46
66a0: 20 20 20 20 20 20 20 20 32 35 30 30 30 20 2d 3e 25000 ->
66b0: 20 31 34 36 0a 2a 2a 20 20 20 20 20 20 33 20 2d 146.** 3 -
66c0: 3e 20 31 36 20 20 20 20 20 20 20 20 20 20 20 20 > 16
66d0: 31 30 30 20 2d 3e 20 36 36 20 20 20 20 20 20 20 100 -> 66
66e0: 20 31 30 30 30 30 30 30 20 2d 3e 20 31 39 39 0a 1000000 -> 199.
66f0: 2a 2a 20 20 20 20 20 20 34 20 2d 3e 20 32 30 20 ** 4 -> 20
6700: 20 20 20 20 20 20 20 20 20 20 31 30 30 30 20 2d 1000 -
6710: 3e 20 39 39 20 20 20 20 20 20 20 20 31 30 34 38 > 99 1048
6720: 35 37 36 20 2d 3e 20 32 30 30 0a 2a 2a 20 20 20 576 -> 200.**
6730: 20 20 31 30 20 2d 3e 20 33 33 20 20 20 20 20 20 10 -> 33
6740: 20 20 20 20 20 31 30 32 34 20 2d 3e 20 31 30 30 1024 -> 100
6750: 20 20 20 20 34 32 39 34 39 36 37 32 39 36 20 2d 4294967296 -
6760: 3e 20 33 32 30 0a 2a 2a 0a 2a 2a 20 54 68 65 20 > 320.**.** The
6770: 4c 6f 67 45 73 74 20 63 61 6e 20 62 65 20 6e 65 LogEst can be ne
6780: 67 61 74 69 76 65 20 74 6f 20 69 6e 64 69 63 61 gative to indica
6790: 74 65 20 66 72 61 63 74 69 6f 6e 61 6c 20 76 61 te fractional va
67a0: 6c 75 65 73 2e 0a 2a 2a 20 45 78 61 6d 70 6c 65 lues..** Example
67b0: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 30 2e 35 20 s:.**.** 0.5
67c0: 2d 3e 20 2d 31 30 20 20 20 20 20 20 20 20 20 20 -> -10
67d0: 20 30 2e 31 20 2d 3e 20 2d 33 33 20 20 20 20 20 0.1 -> -33
67e0: 20 20 20 30 2e 30 36 32 35 20 2d 3e 20 2d 34 30 0.0625 -> -40
67f0: 0a 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e 54 31 .*/.typedef INT1
6800: 36 5f 54 59 50 45 20 4c 6f 67 45 73 74 3b 0a 0a 6_TYPE LogEst;..
6810: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 53 51 /*.** Set the SQ
6820: 4c 49 54 45 5f 50 54 52 53 49 5a 45 20 6d 61 63 LITE_PTRSIZE mac
6830: 72 6f 20 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 ro to the number
6840: 20 6f 66 20 62 79 74 65 73 20 69 6e 20 61 20 70 of bytes in a p
6850: 6f 69 6e 74 65 72 0a 2a 2f 0a 23 69 66 6e 64 65 ointer.*/.#ifnde
6860: 66 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 f SQLITE_PTRSIZE
6870: 0a 23 20 69 66 20 64 65 66 69 6e 65 64 28 5f 5f .# if defined(__
6880: 53 49 5a 45 4f 46 5f 50 4f 49 4e 54 45 52 5f 5f SIZEOF_POINTER__
6890: 29 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c ).# define SQL
68a0: 49 54 45 5f 50 54 52 53 49 5a 45 20 5f 5f 53 49 ITE_PTRSIZE __SI
68b0: 5a 45 4f 46 5f 50 4f 49 4e 54 45 52 5f 5f 0a 23 ZEOF_POINTER__.#
68c0: 20 65 6c 69 66 20 64 65 66 69 6e 65 64 28 69 33 elif defined(i3
68d0: 38 36 29 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 86) || defin
68e0: 65 64 28 5f 5f 69 33 38 36 5f 5f 29 20 20 20 7c ed(__i386__) |
68f0: 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f 49 58 38 | defined(_M_IX8
6900: 36 29 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 6) || \.
6910: 20 20 64 65 66 69 6e 65 64 28 5f 4d 5f 41 52 4d defined(_M_ARM
6920: 29 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f ) || defined(_
6930: 5f 61 72 6d 5f 5f 29 20 20 20 20 7c 7c 20 64 65 _arm__) || de
6940: 66 69 6e 65 64 28 5f 5f 78 38 36 29 0a 23 20 20 fined(__x86).#
6950: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 define SQLITE_P
6960: 54 52 53 49 5a 45 20 34 0a 23 20 65 6c 73 65 0a TRSIZE 4.# else.
6970: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
6980: 45 5f 50 54 52 53 49 5a 45 20 38 0a 23 20 65 6e E_PTRSIZE 8.# en
6990: 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 54 dif.#endif../* T
69a0: 68 65 20 75 70 74 72 20 74 79 70 65 20 69 73 20 he uptr type is
69b0: 61 6e 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 an unsigned inte
69c0: 67 65 72 20 6c 61 72 67 65 20 65 6e 6f 75 67 68 ger large enough
69d0: 20 74 6f 20 68 6f 6c 64 20 61 20 70 6f 69 6e 74 to hold a point
69e0: 65 72 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 er.*/.#if define
69f0: 64 28 48 41 56 45 5f 53 54 44 49 4e 54 5f 48 29 d(HAVE_STDINT_H)
6a00: 0a 20 20 74 79 70 65 64 65 66 20 75 69 6e 74 70 . typedef uintp
6a10: 74 72 5f 74 20 75 70 74 72 3b 0a 23 65 6c 69 66 tr_t uptr;.#elif
6a20: 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 3d SQLITE_PTRSIZE=
6a30: 3d 34 0a 20 20 74 79 70 65 64 65 66 20 75 33 32 =4. typedef u32
6a40: 20 75 70 74 72 3b 0a 23 65 6c 73 65 0a 20 20 74 uptr;.#else. t
6a50: 79 70 65 64 65 66 20 75 36 34 20 75 70 74 72 3b ypedef u64 uptr;
6a60: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
6a70: 68 65 20 53 51 4c 49 54 45 5f 57 49 54 48 49 4e he SQLITE_WITHIN
6a80: 28 50 2c 53 2c 45 29 20 6d 61 63 72 6f 20 63 68 (P,S,E) macro ch
6a90: 65 63 6b 73 20 74 6f 20 73 65 65 20 69 66 20 70 ecks to see if p
6aa0: 6f 69 6e 74 65 72 20 50 20 70 6f 69 6e 74 73 20 ointer P points
6ab0: 74 6f 0a 2a 2a 20 73 6f 6d 65 74 68 69 6e 67 20 to.** something
6ac0: 62 65 74 77 65 65 6e 20 53 20 28 69 6e 63 6c 75 between S (inclu
6ad0: 73 69 76 65 29 20 61 6e 64 20 45 20 28 65 78 63 sive) and E (exc
6ae0: 6c 75 73 69 76 65 29 2e 0a 2a 2a 0a 2a 2a 20 49 lusive)..**.** I
6af0: 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 53 n other words, S
6b00: 20 69 73 20 61 20 62 75 66 66 65 72 20 61 6e 64 is a buffer and
6b10: 20 45 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 E is a pointer
6b20: 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 to the first byt
6b30: 65 20 61 66 74 65 72 0a 2a 2a 20 74 68 65 20 65 e after.** the e
6b40: 6e 64 20 6f 66 20 62 75 66 66 65 72 20 53 2e 20 nd of buffer S.
6b50: 20 54 68 69 73 20 6d 61 63 72 6f 20 72 65 74 75 This macro retu
6b60: 72 6e 73 20 74 72 75 65 20 69 66 20 50 20 70 6f rns true if P po
6b70: 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 69 6e ints to somethin
6b80: 67 0a 2a 2a 20 63 6f 6e 74 61 69 6e 65 64 20 77 g.** contained w
6b90: 69 74 68 69 6e 20 74 68 65 20 62 75 66 66 65 72 ithin the buffer
6ba0: 20 53 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 S..*/.#define S
6bb0: 51 4c 49 54 45 5f 57 49 54 48 49 4e 28 50 2c 53 QLITE_WITHIN(P,S
6bc0: 2c 45 29 20 28 28 28 75 70 74 72 29 28 50 29 3e ,E) (((uptr)(P)>
6bd0: 3d 28 75 70 74 72 29 28 53 29 29 26 26 28 28 75 =(uptr)(S))&&((u
6be0: 70 74 72 29 28 50 29 3c 28 75 70 74 72 29 28 45 ptr)(P)<(uptr)(E
6bf0: 29 29 29 0a 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 ))).../*.** Macr
6c00: 6f 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 os to determine
6c10: 77 68 65 74 68 65 72 20 74 68 65 20 6d 61 63 68 whether the mach
6c20: 69 6e 65 20 69 73 20 62 69 67 20 6f 72 20 6c 69 ine is big or li
6c30: 74 74 6c 65 20 65 6e 64 69 61 6e 2c 0a 2a 2a 20 ttle endian,.**
6c40: 61 6e 64 20 77 68 65 74 68 65 72 20 6f 72 20 6e and whether or n
6c50: 6f 74 20 74 68 61 74 20 64 65 74 65 72 6d 69 6e ot that determin
6c60: 61 74 69 6f 6e 20 69 73 20 72 75 6e 2d 74 69 6d ation is run-tim
6c70: 65 20 6f 72 20 63 6f 6d 70 69 6c 65 2d 74 69 6d e or compile-tim
6c80: 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 62 65 73 e..**.** For bes
6c90: 74 20 70 65 72 66 6f 72 6d 61 6e 63 65 2c 20 61 t performance, a
6ca0: 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 n attempt is mad
6cb0: 65 20 74 6f 20 67 75 65 73 73 20 61 74 20 74 68 e to guess at th
6cc0: 65 20 62 79 74 65 2d 6f 72 64 65 72 0a 2a 2a 20 e byte-order.**
6cd0: 75 73 69 6e 67 20 43 2d 70 72 65 70 72 6f 63 65 using C-preproce
6ce0: 73 73 6f 72 20 6d 61 63 72 6f 73 2e 20 20 49 66 ssor macros. If
6cf0: 20 74 68 61 74 20 69 73 20 75 6e 73 75 63 63 65 that is unsucce
6d00: 73 73 66 75 6c 2c 20 6f 72 20 69 66 0a 2a 2a 20 ssful, or if.**
6d10: 2d 44 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 -DSQLITE_BYTEORD
6d20: 45 52 3d 30 20 69 73 20 73 65 74 2c 20 74 68 65 ER=0 is set, the
6d30: 6e 20 62 79 74 65 2d 6f 72 64 65 72 20 69 73 20 n byte-order is
6d40: 64 65 74 65 72 6d 69 6e 65 64 0a 2a 2a 20 61 74 determined.** at
6d50: 20 72 75 6e 2d 74 69 6d 65 2e 0a 2a 2f 0a 23 69 run-time..*/.#i
6d60: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 42 59 54 fndef SQLITE_BYT
6d70: 45 4f 52 44 45 52 0a 23 20 69 66 20 64 65 66 69 EORDER.# if defi
6d80: 6e 65 64 28 69 33 38 36 29 20 20 20 20 20 7c 7c ned(i386) ||
6d90: 20 64 65 66 69 6e 65 64 28 5f 5f 69 33 38 36 5f defined(__i386_
6da0: 5f 29 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 _) || defined(
6db0: 5f 4d 5f 49 58 38 36 29 20 7c 7c 20 20 20 20 5c _M_IX86) || \
6dc0: 0a 20 20 20 20 20 64 65 66 69 6e 65 64 28 5f 5f . defined(__
6dd0: 78 38 36 5f 36 34 29 20 7c 7c 20 64 65 66 69 6e x86_64) || defin
6de0: 65 64 28 5f 5f 78 38 36 5f 36 34 5f 5f 29 20 7c ed(__x86_64__) |
6df0: 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f 58 36 34 | defined(_M_X64
6e00: 29 20 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 ) || \.
6e10: 64 65 66 69 6e 65 64 28 5f 4d 5f 41 4d 44 36 34 defined(_M_AMD64
6e20: 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f ) || defined(_M_
6e30: 41 52 4d 29 20 20 20 20 20 7c 7c 20 64 65 66 69 ARM) || defi
6e40: 6e 65 64 28 5f 5f 78 38 36 29 20 20 20 7c 7c 20 ned(__x86) ||
6e50: 20 20 20 5c 0a 20 20 20 20 20 64 65 66 69 6e 65 \. define
6e60: 64 28 5f 5f 61 72 6d 5f 5f 29 0a 23 20 20 20 64 d(__arm__).# d
6e70: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 59 54 efine SQLITE_BYT
6e80: 45 4f 52 44 45 52 20 20 20 20 31 32 33 34 0a 23 EORDER 1234.#
6e90: 20 65 6c 69 66 20 64 65 66 69 6e 65 64 28 73 70 elif defined(sp
6ea0: 61 72 63 29 20 20 20 20 7c 7c 20 64 65 66 69 6e arc) || defin
6eb0: 65 64 28 5f 5f 70 70 63 5f 5f 29 0a 23 20 20 20 ed(__ppc__).#
6ec0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 59 define SQLITE_BY
6ed0: 54 45 4f 52 44 45 52 20 20 20 20 34 33 32 31 0a TEORDER 4321.
6ee0: 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 6e # else.# defin
6ef0: 65 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 e SQLITE_BYTEORD
6f00: 45 52 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e ER 0.# endif.#en
6f10: 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 5f 42 dif.#if SQLITE_B
6f20: 59 54 45 4f 52 44 45 52 3d 3d 34 33 32 31 0a 23 YTEORDER==4321.#
6f30: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 define SQLITE_B
6f40: 49 47 45 4e 44 49 41 4e 20 20 20 20 31 0a 23 20 IGENDIAN 1.#
6f50: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 define SQLITE_LI
6f60: 54 54 4c 45 45 4e 44 49 41 4e 20 30 0a 23 20 64 TTLEENDIAN 0.# d
6f70: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55 54 46 efine SQLITE_UTF
6f80: 31 36 4e 41 54 49 56 45 20 20 53 51 4c 49 54 45 16NATIVE SQLITE
6f90: 5f 55 54 46 31 36 42 45 0a 23 65 6c 69 66 20 53 _UTF16BE.#elif S
6fa0: 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 3d QLITE_BYTEORDER=
6fb0: 3d 31 32 33 34 0a 23 20 64 65 66 69 6e 65 20 53 =1234.# define S
6fc0: 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 QLITE_BIGENDIAN
6fd0: 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 53 51 0.# define SQ
6fe0: 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 LITE_LITTLEENDIA
6ff0: 4e 20 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c N 1.# define SQL
7000: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 ITE_UTF16NATIVE
7010: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 0a SQLITE_UTF16LE.
7020: 23 65 6c 73 65 0a 23 20 69 66 64 65 66 20 53 51 #else.# ifdef SQ
7030: 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f LITE_AMALGAMATIO
7040: 4e 0a 20 20 63 6f 6e 73 74 20 69 6e 74 20 73 71 N. const int sq
7050: 6c 69 74 65 33 6f 6e 65 20 3d 20 31 3b 0a 23 20 lite3one = 1;.#
7060: 65 6c 73 65 0a 20 20 65 78 74 65 72 6e 20 63 6f else. extern co
7070: 6e 73 74 20 69 6e 74 20 73 71 6c 69 74 65 33 6f nst int sqlite3o
7080: 6e 65 3b 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 ne;.# endif.# de
7090: 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 45 fine SQLITE_BIGE
70a0: 4e 44 49 41 4e 20 20 20 20 28 2a 28 63 68 61 72 NDIAN (*(char
70b0: 20 2a 29 28 26 73 71 6c 69 74 65 33 6f 6e 65 29 *)(&sqlite3one)
70c0: 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 53 51 ==0).# define SQ
70d0: 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 LITE_LITTLEENDIA
70e0: 4e 20 28 2a 28 63 68 61 72 20 2a 29 28 26 73 71 N (*(char *)(&sq
70f0: 6c 69 74 65 33 6f 6e 65 29 3d 3d 31 29 0a 23 20 lite3one)==1).#
7100: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55 54 define SQLITE_UT
7110: 46 31 36 4e 41 54 49 56 45 20 20 28 53 51 4c 49 F16NATIVE (SQLI
7120: 54 45 5f 42 49 47 45 4e 44 49 41 4e 3f 53 51 4c TE_BIGENDIAN?SQL
7130: 49 54 45 5f 55 54 46 31 36 42 45 3a 53 51 4c 49 ITE_UTF16BE:SQLI
7140: 54 45 5f 55 54 46 31 36 4c 45 29 0a 23 65 6e 64 TE_UTF16LE).#end
7150: 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 74 61 if../*.** Consta
7160: 6e 74 73 20 66 6f 72 20 74 68 65 20 6c 61 72 67 nts for the larg
7170: 65 73 74 20 61 6e 64 20 73 6d 61 6c 6c 65 73 74 est and smallest
7180: 20 70 6f 73 73 69 62 6c 65 20 36 34 2d 62 69 74 possible 64-bit
7190: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 73 signed integers
71a0: 2e 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 6f ..** These macro
71b0: 73 20 61 72 65 20 64 65 73 69 67 6e 65 64 20 74 s are designed t
71c0: 6f 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c 79 o work correctly
71d0: 20 6f 6e 20 62 6f 74 68 20 33 32 2d 62 69 74 20 on both 32-bit
71e0: 61 6e 64 20 36 34 2d 62 69 74 0a 2a 2a 20 63 6f and 64-bit.** co
71f0: 6d 70 69 6c 65 72 73 2e 0a 2a 2f 0a 23 64 65 66 mpilers..*/.#def
7200: 69 6e 65 20 4c 41 52 47 45 53 54 5f 49 4e 54 36 ine LARGEST_INT6
7210: 34 20 20 28 30 78 66 66 66 66 66 66 66 66 7c 28 4 (0xffffffff|(
7220: 28 28 69 36 34 29 30 78 37 66 66 66 66 66 66 66 ((i64)0x7fffffff
7230: 29 3c 3c 33 32 29 29 0a 23 64 65 66 69 6e 65 20 )<<32)).#define
7240: 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34 20 28 SMALLEST_INT64 (
7250: 28 28 69 36 34 29 2d 31 29 20 2d 20 4c 41 52 47 ((i64)-1) - LARG
7260: 45 53 54 5f 49 4e 54 36 34 29 0a 0a 2f 2a 0a 2a EST_INT64)../*.*
7270: 2a 20 52 6f 75 6e 64 20 75 70 20 61 20 6e 75 6d * Round up a num
7280: 62 65 72 20 74 6f 20 74 68 65 20 6e 65 78 74 20 ber to the next
7290: 6c 61 72 67 65 72 20 6d 75 6c 74 69 70 6c 65 20 larger multiple
72a0: 6f 66 20 38 2e 20 20 54 68 69 73 20 69 73 20 75 of 8. This is u
72b0: 73 65 64 0a 2a 2a 20 74 6f 20 66 6f 72 63 65 20 sed.** to force
72c0: 38 2d 62 79 74 65 20 61 6c 69 67 6e 6d 65 6e 74 8-byte alignment
72d0: 20 6f 6e 20 36 34 2d 62 69 74 20 61 72 63 68 69 on 64-bit archi
72e0: 74 65 63 74 75 72 65 73 2e 0a 2a 2f 0a 23 64 65 tectures..*/.#de
72f0: 66 69 6e 65 20 52 4f 55 4e 44 38 28 78 29 20 20 fine ROUND8(x)
7300: 20 20 20 28 28 28 78 29 2b 37 29 26 7e 37 29 0a (((x)+7)&~7).
7310: 0a 2f 2a 0a 2a 2a 20 52 6f 75 6e 64 20 64 6f 77 ./*.** Round dow
7320: 6e 20 74 6f 20 74 68 65 20 6e 65 61 72 65 73 74 n to the nearest
7330: 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 38 0a 2a multiple of 8.*
7340: 2f 0a 23 64 65 66 69 6e 65 20 52 4f 55 4e 44 44 /.#define ROUNDD
7350: 4f 57 4e 38 28 78 29 20 28 28 78 29 26 7e 37 29 OWN8(x) ((x)&~7)
7360: 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 65 72 74 20 74 ../*.** Assert t
7370: 68 61 74 20 74 68 65 20 70 6f 69 6e 74 65 72 20 hat the pointer
7380: 58 20 69 73 20 61 6c 69 67 6e 65 64 20 74 6f 20 X is aligned to
7390: 61 6e 20 38 2d 62 79 74 65 20 62 6f 75 6e 64 61 an 8-byte bounda
73a0: 72 79 2e 20 20 54 68 69 73 0a 2a 2a 20 6d 61 63 ry. This.** mac
73b0: 72 6f 20 69 73 20 75 73 65 64 20 6f 6e 6c 79 20 ro is used only
73c0: 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 29 20 within assert()
73d0: 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 74 to verify that t
73e0: 68 65 20 63 6f 64 65 20 67 65 74 73 0a 2a 2a 20 he code gets.**
73f0: 61 6c 6c 20 61 6c 69 67 6e 6d 65 6e 74 20 72 65 all alignment re
7400: 73 74 72 69 63 74 69 6f 6e 73 20 63 6f 72 72 65 strictions corre
7410: 63 74 2e 0a 2a 2a 0a 2a 2a 20 45 78 63 65 70 74 ct..**.** Except
7420: 2c 20 69 66 20 53 51 4c 49 54 45 5f 34 5f 42 59 , if SQLITE_4_BY
7430: 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f TE_ALIGNED_MALLO
7440: 43 20 69 73 20 64 65 66 69 6e 65 64 2c 20 74 68 C is defined, th
7450: 65 6e 20 74 68 65 0a 2a 2a 20 75 6e 64 65 72 6c en the.** underl
7460: 79 69 6e 67 20 6d 61 6c 6c 6f 63 28 29 20 69 6d ying malloc() im
7470: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d 69 67 plementation mig
7480: 68 74 20 72 65 74 75 72 6e 20 75 73 20 34 2d 62 ht return us 4-b
7490: 79 74 65 20 61 6c 69 67 6e 65 64 0a 2a 2a 20 70 yte aligned.** p
74a0: 6f 69 6e 74 65 72 73 2e 20 20 49 6e 20 74 68 61 ointers. In tha
74b0: 74 20 63 61 73 65 2c 20 6f 6e 6c 79 20 76 65 72 t case, only ver
74c0: 69 66 79 20 34 2d 62 79 74 65 20 61 6c 69 67 6e ify 4-byte align
74d0: 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 ment..*/.#ifdef
74e0: 53 51 4c 49 54 45 5f 34 5f 42 59 54 45 5f 41 4c SQLITE_4_BYTE_AL
74f0: 49 47 4e 45 44 5f 4d 41 4c 4c 4f 43 0a 23 20 64 IGNED_MALLOC.# d
7500: 65 66 69 6e 65 20 45 49 47 48 54 5f 42 59 54 45 efine EIGHT_BYTE
7510: 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20 20 _ALIGNMENT(X)
7520: 28 28 28 28 63 68 61 72 2a 29 28 58 29 20 2d 20 ((((char*)(X) -
7530: 28 63 68 61 72 2a 29 30 29 26 33 29 3d 3d 30 29 (char*)0)&3)==0)
7540: 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
7550: 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e EIGHT_BYTE_ALIGN
7560: 4d 45 4e 54 28 58 29 20 20 20 28 28 28 28 63 68 MENT(X) ((((ch
7570: 61 72 2a 29 28 58 29 20 2d 20 28 63 68 61 72 2a ar*)(X) - (char*
7580: 29 30 29 26 37 29 3d 3d 30 29 0a 23 65 6e 64 69 )0)&7)==0).#endi
7590: 66 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 61 62 6c 65 f../*.** Disable
75a0: 20 4d 4d 41 50 20 6f 6e 20 70 6c 61 74 66 6f 72 MMAP on platfor
75b0: 6d 73 20 77 68 65 72 65 20 69 74 20 69 73 20 6b ms where it is k
75c0: 6e 6f 77 6e 20 74 6f 20 6e 6f 74 20 77 6f 72 6b nown to not work
75d0: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
75e0: 5f 5f 4f 70 65 6e 42 53 44 5f 5f 29 20 7c 7c 20 __OpenBSD__) ||
75f0: 64 65 66 69 6e 65 64 28 5f 5f 51 4e 58 4e 54 4f defined(__QNXNTO
7600: 5f 5f 29 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 __).# undef SQLI
7610: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
7620: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
7630: 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 _MAX_MMAP_SIZE 0
7640: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 .#endif../*.** D
7650: 65 66 61 75 6c 74 20 6d 61 78 69 6d 75 6d 20 73 efault maximum s
7660: 69 7a 65 20 6f 66 20 6d 65 6d 6f 72 79 20 75 73 ize of memory us
7670: 65 64 20 62 79 20 6d 65 6d 6f 72 79 2d 6d 61 70 ed by memory-map
7680: 70 65 64 20 49 2f 4f 20 69 6e 20 74 68 65 20 56 ped I/O in the V
7690: 46 53 0a 2a 2f 0a 23 69 66 64 65 66 20 5f 5f 41 FS.*/.#ifdef __A
76a0: 50 50 4c 45 5f 5f 0a 23 20 69 6e 63 6c 75 64 65 PPLE__.# include
76b0: 20 3c 54 61 72 67 65 74 43 6f 6e 64 69 74 69 6f <TargetConditio
76c0: 6e 61 6c 73 2e 68 3e 0a 23 65 6e 64 69 66 0a 23 nals.h>.#endif.#
76d0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 ifndef SQLITE_MA
76e0: 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 69 66 X_MMAP_SIZE.# if
76f0: 20 64 65 66 69 6e 65 64 28 5f 5f 6c 69 6e 75 78 defined(__linux
7700: 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 6e __) \. || defin
7710: 65 64 28 5f 57 49 4e 33 32 29 20 5c 0a 20 20 7c ed(_WIN32) \. |
7720: 7c 20 28 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 | (defined(__APP
7730: 4c 45 5f 5f 29 20 26 26 20 64 65 66 69 6e 65 64 LE__) && defined
7740: 28 5f 5f 4d 41 43 48 5f 5f 29 29 20 5c 0a 20 20 (__MACH__)) \.
7750: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 73 75 6e || defined(__sun
7760: 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 ) \. || defined
7770: 28 5f 5f 46 72 65 65 42 53 44 5f 5f 29 20 5c 0a (__FreeBSD__) \.
7780: 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 44 || defined(__D
7790: 72 61 67 6f 6e 46 6c 79 5f 5f 29 0a 23 20 20 20 ragonFly__).#
77a0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 define SQLITE_MA
77b0: 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 78 37 66 X_MMAP_SIZE 0x7f
77c0: 66 66 30 30 30 30 20 20 2f 2a 20 32 31 34 37 34 ff0000 /* 21474
77d0: 31 38 31 31 32 20 2a 2f 0a 23 20 65 6c 73 65 0a 18112 */.# else.
77e0: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
77f0: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 E_MAX_MMAP_SIZE
7800: 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0.# endif.#endif
7810: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 65 66 61 ../*.** The defa
7820: 75 6c 74 20 4d 4d 41 50 5f 53 49 5a 45 20 69 73 ult MMAP_SIZE is
7830: 20 7a 65 72 6f 20 6f 6e 20 61 6c 6c 20 70 6c 61 zero on all pla
7840: 74 66 6f 72 6d 73 2e 20 20 4f 72 2c 20 65 76 65 tforms. Or, eve
7850: 6e 20 69 66 20 61 20 6c 61 72 67 65 72 0a 2a 2a n if a larger.**
7860: 20 64 65 66 61 75 6c 74 20 4d 4d 41 50 5f 53 49 default MMAP_SI
7870: 5a 45 20 69 73 20 73 70 65 63 69 66 69 65 64 20 ZE is specified
7880: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2c at compile-time,
7890: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 make sure that
78a0: 69 74 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 it does.** not e
78b0: 78 63 65 65 64 20 74 68 65 20 6d 61 78 69 6d 75 xceed the maximu
78c0: 6d 20 6d 6d 61 70 20 73 69 7a 65 2e 0a 2a 2f 0a m mmap size..*/.
78d0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
78e0: 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 EFAULT_MMAP_SIZE
78f0: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
7900: 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 _DEFAULT_MMAP_SI
7910: 5a 45 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 ZE 0.#endif.#if
7920: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
7930: 4d 41 50 5f 53 49 5a 45 3e 53 51 4c 49 54 45 5f MAP_SIZE>SQLITE_
7940: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 MAX_MMAP_SIZE.#
7950: 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 45 46 undef SQLITE_DEF
7960: 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 AULT_MMAP_SIZE.#
7970: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 define SQLITE_D
7980: 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 EFAULT_MMAP_SIZE
7990: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
79a0: 5f 53 49 5a 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a _SIZE.#endif../*
79b0: 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20 6f 66 20 .** Only one of
79c0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
79d0: 41 54 33 20 6f 72 20 53 51 4c 49 54 45 5f 45 4e AT3 or SQLITE_EN
79e0: 41 42 4c 45 5f 53 54 41 54 34 20 63 61 6e 20 62 ABLE_STAT4 can b
79f0: 65 20 64 65 66 69 6e 65 64 2e 0a 2a 2a 20 50 72 e defined..** Pr
7a00: 69 6f 72 69 74 79 20 69 73 20 67 69 76 65 6e 20 iority is given
7a10: 74 6f 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 to SQLITE_ENABLE
7a20: 5f 53 54 41 54 34 2e 20 20 49 66 20 65 69 74 68 _STAT4. If eith
7a30: 65 72 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 er are defined,
7a40: 61 6c 73 6f 0a 2a 2a 20 64 65 66 69 6e 65 20 53 also.** define S
7a50: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
7a60: 54 33 5f 4f 52 5f 53 54 41 54 34 0a 2a 2f 0a 23 T3_OR_STAT4.*/.#
7a70: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
7a80: 42 4c 45 5f 53 54 41 54 34 0a 23 20 75 6e 64 65 BLE_STAT4.# unde
7a90: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
7aa0: 53 54 41 54 33 0a 23 20 64 65 66 69 6e 65 20 53 STAT3.# define S
7ab0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
7ac0: 54 33 5f 4f 52 5f 53 54 41 54 34 20 31 0a 23 65 T3_OR_STAT4 1.#e
7ad0: 6c 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c lif SQLITE_ENABL
7ae0: 45 5f 53 54 41 54 33 0a 23 20 64 65 66 69 6e 65 E_STAT3.# define
7af0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
7b00: 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 20 31 0a TAT3_OR_STAT4 1.
7b10: 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 #elif SQLITE_ENA
7b20: 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 BLE_STAT3_OR_STA
7b30: 54 34 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 T4.# undef SQLIT
7b40: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f E_ENABLE_STAT3_O
7b50: 52 5f 53 54 41 54 34 0a 23 65 6e 64 69 66 0a 0a R_STAT4.#endif..
7b60: 2f 2a 0a 2a 2a 20 53 45 4c 45 43 54 54 52 41 43 /*.** SELECTTRAC
7b70: 45 5f 45 4e 41 42 4c 45 44 20 77 69 6c 6c 20 62 E_ENABLED will b
7b80: 65 20 65 69 74 68 65 72 20 31 20 6f 72 20 30 20 e either 1 or 0
7b90: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 depending on whe
7ba0: 74 68 65 72 20 6f 72 20 6e 6f 74 0a 2a 2a 20 74 ther or not.** t
7bb0: 68 65 20 53 65 6c 65 63 74 20 71 75 65 72 79 20 he Select query
7bc0: 67 65 6e 65 72 61 74 6f 72 20 74 72 61 63 69 6e generator tracin
7bd0: 67 20 6c 6f 67 69 63 20 69 73 20 74 75 72 6e 65 g logic is turne
7be0: 64 20 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 d on..*/.#if def
7bf0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
7c00: 4c 45 5f 53 45 4c 45 43 54 54 52 41 43 45 29 0a LE_SELECTTRACE).
7c10: 23 20 64 65 66 69 6e 65 20 53 45 4c 45 43 54 54 # define SELECTT
7c20: 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 31 0a 23 RACE_ENABLED 1.#
7c30: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53 45 else.# define SE
7c40: 4c 45 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 LECTTRACE_ENABLE
7c50: 44 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a D 0.#endif../*.*
7c60: 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
7c70: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
7c80: 74 72 75 63 74 75 72 65 20 69 73 20 75 73 65 64 tructure is used
7c90: 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 62 75 to store the bu
7ca0: 73 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 sy-handler.** ca
7cb0: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 20 67 69 76 llback for a giv
7cc0: 65 6e 20 73 71 6c 69 74 65 20 68 61 6e 64 6c 65 en sqlite handle
7cd0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 ..**.** The sqli
7ce0: 74 65 2e 62 75 73 79 48 61 6e 64 6c 65 72 20 6d te.busyHandler m
7cf0: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 73 71 6c ember of the sql
7d00: 69 74 65 20 73 74 72 75 63 74 20 63 6f 6e 74 61 ite struct conta
7d10: 69 6e 73 20 74 68 65 20 62 75 73 79 0a 2a 2a 20 ins the busy.**
7d20: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 74 68 65 callback for the
7d30: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
7d40: 2e 20 45 61 63 68 20 70 61 67 65 72 20 6f 70 65 . Each pager ope
7d50: 6e 65 64 20 76 69 61 20 74 68 65 20 73 71 6c 69 ned via the sqli
7d60: 74 65 0a 2a 2a 20 68 61 6e 64 6c 65 20 69 73 20 te.** handle is
7d70: 70 61 73 73 65 64 20 61 20 70 6f 69 6e 74 65 72 passed a pointer
7d80: 20 74 6f 20 73 71 6c 69 74 65 2e 62 75 73 79 48 to sqlite.busyH
7d90: 61 6e 64 6c 65 72 2e 20 54 68 65 20 62 75 73 79 andler. The busy
7da0: 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c -handler.** call
7db0: 62 61 63 6b 20 69 73 20 63 75 72 72 65 6e 74 6c back is currentl
7dc0: 79 20 69 6e 76 6f 6b 65 64 20 6f 6e 6c 79 20 66 y invoked only f
7dd0: 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 67 65 72 rom within pager
7de0: 2e 63 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 .c..*/.typedef s
7df0: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
7e00: 72 20 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a 73 r BusyHandler;.s
7e10: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
7e20: 72 20 7b 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 r {. int (*xBus
7e30: 79 48 61 6e 64 6c 65 72 29 28 76 6f 69 64 20 2a yHandler)(void *
7e40: 2c 69 6e 74 29 3b 20 20 2f 2a 20 54 68 65 20 62 ,int); /* The b
7e50: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a usy callback */.
7e60: 20 20 76 6f 69 64 20 2a 70 42 75 73 79 41 72 67 void *pBusyArg
7e70: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7e80: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
7e90: 20 74 6f 20 62 75 73 79 20 63 61 6c 6c 62 61 63 to busy callbac
7ea0: 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 73 79 k */. int nBusy
7eb0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7ec0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 63 72 /* Incr
7ed0: 65 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 emented with eac
7ee0: 68 20 62 75 73 79 20 63 61 6c 6c 20 2a 2f 0a 20 h busy call */.
7ef0: 20 75 38 20 62 45 78 74 72 61 46 69 6c 65 41 72 u8 bExtraFileAr
7f00: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
7f10: 20 20 20 2f 2a 20 49 6e 63 6c 75 64 65 20 73 71 /* Include sq
7f20: 6c 69 74 65 33 5f 66 69 6c 65 20 61 73 20 63 61 lite3_file as ca
7f30: 6c 6c 62 61 63 6b 20 61 72 67 20 2a 2f 0a 7d 3b llback arg */.};
7f40: 0a 0a 2f 2a 0a 2a 2a 20 4e 61 6d 65 20 6f 66 20 ../*.** Name of
7f50: 74 68 65 20 6d 61 73 74 65 72 20 64 61 74 61 62 the master datab
7f60: 61 73 65 20 74 61 62 6c 65 2e 20 20 54 68 65 20 ase table. The
7f70: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 master database
7f80: 74 61 62 6c 65 0a 2a 2a 20 69 73 20 61 20 73 70 table.** is a sp
7f90: 65 63 69 61 6c 20 74 61 62 6c 65 20 74 68 61 74 ecial table that
7fa0: 20 68 6f 6c 64 73 20 74 68 65 20 6e 61 6d 65 73 holds the names
7fb0: 20 61 6e 64 20 61 74 74 72 69 62 75 74 65 73 20 and attributes
7fc0: 6f 66 20 61 6c 6c 0a 2a 2a 20 75 73 65 72 20 74 of all.** user t
7fd0: 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 ables and indice
7fe0: 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 s..*/.#define MA
7ff0: 53 54 45 52 5f 4e 41 4d 45 20 20 20 20 20 20 20 STER_NAME
8000: 22 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 0a "sqlite_master".
8010: 23 64 65 66 69 6e 65 20 54 45 4d 50 5f 4d 41 53 #define TEMP_MAS
8020: 54 45 52 5f 4e 41 4d 45 20 20 22 73 71 6c 69 74 TER_NAME "sqlit
8030: 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 22 0a 0a e_temp_master"..
8040: 2f 2a 0a 2a 2a 20 54 68 65 20 72 6f 6f 74 2d 70 /*.** The root-p
8050: 61 67 65 20 6f 66 20 74 68 65 20 6d 61 73 74 65 age of the maste
8060: 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 r database table
8070: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 ..*/.#define MAS
8080: 54 45 52 5f 52 4f 4f 54 20 20 20 20 20 20 20 31 TER_ROOT 1
8090: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e 61 6d 65 ../*.** The name
80a0: 20 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 74 of the schema t
80b0: 61 62 6c 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 able..*/.#define
80c0: 20 53 43 48 45 4d 41 5f 54 41 42 4c 45 28 78 29 SCHEMA_TABLE(x)
80d0: 20 20 28 28 21 4f 4d 49 54 5f 54 45 4d 50 44 42 ((!OMIT_TEMPDB
80e0: 29 26 26 28 78 3d 3d 31 29 3f 54 45 4d 50 5f 4d )&&(x==1)?TEMP_M
80f0: 41 53 54 45 52 5f 4e 41 4d 45 3a 4d 41 53 54 45 ASTER_NAME:MASTE
8100: 52 5f 4e 41 4d 45 29 0a 0a 2f 2a 0a 2a 2a 20 41 R_NAME)../*.** A
8110: 20 63 6f 6e 76 65 6e 69 65 6e 63 65 20 6d 61 63 convenience mac
8120: 72 6f 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 ro that returns
8130: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6c the number of el
8140: 65 6d 65 6e 74 73 20 69 6e 0a 2a 2a 20 61 6e 20 ements in.** an
8150: 61 72 72 61 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e array..*/.#defin
8160: 65 20 41 72 72 61 79 53 69 7a 65 28 58 29 20 20 e ArraySize(X)
8170: 20 20 28 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 ((int)(sizeof(
8180: 58 29 2f 73 69 7a 65 6f 66 28 58 5b 30 5d 29 29 X)/sizeof(X[0]))
8190: 29 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 )../*.** Determi
81a0: 6e 65 20 69 66 20 74 68 65 20 61 72 67 75 6d 65 ne if the argume
81b0: 6e 74 20 69 73 20 61 20 70 6f 77 65 72 20 6f 66 nt is a power of
81c0: 20 74 77 6f 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 two.*/.#define
81d0: 49 73 50 6f 77 65 72 4f 66 54 77 6f 28 58 29 20 IsPowerOfTwo(X)
81e0: 28 28 28 58 29 26 28 28 58 29 2d 31 29 29 3d 3d (((X)&((X)-1))==
81f0: 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 0)../*.** The fo
8200: 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 65 20 61 73 llowing value as
8210: 20 61 20 64 65 73 74 72 75 63 74 6f 72 20 6d 65 a destructor me
8220: 61 6e 73 20 74 6f 20 75 73 65 20 73 71 6c 69 74 ans to use sqlit
8230: 65 33 44 62 46 72 65 65 28 29 2e 0a 2a 2a 20 54 e3DbFree()..** T
8240: 68 65 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 he sqlite3DbFree
8250: 28 29 20 72 6f 75 74 69 6e 65 20 72 65 71 75 69 () routine requi
8260: 72 65 73 20 74 77 6f 20 70 61 72 61 6d 65 74 65 res two paramete
8270: 72 73 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 rs instead of th
8280: 65 0a 2a 2a 20 6f 6e 65 20 70 61 72 61 6d 65 74 e.** one paramet
8290: 65 72 20 74 68 61 74 20 64 65 73 74 72 75 63 74 er that destruct
82a0: 6f 72 73 20 6e 6f 72 6d 61 6c 6c 79 20 77 61 6e ors normally wan
82b0: 74 2e 20 20 53 6f 20 77 65 20 68 61 76 65 20 74 t. So we have t
82c0: 6f 20 69 6e 74 72 6f 64 75 63 65 0a 2a 2a 20 74 o introduce.** t
82d0: 68 69 73 20 6d 61 67 69 63 20 76 61 6c 75 65 20 his magic value
82e0: 74 68 61 74 20 74 68 65 20 63 6f 64 65 20 6b 6e that the code kn
82f0: 6f 77 73 20 74 6f 20 68 61 6e 64 6c 65 20 64 69 ows to handle di
8300: 66 66 65 72 65 6e 74 6c 79 2e 20 20 41 6e 79 0a fferently. Any.
8310: 2a 2a 20 70 6f 69 6e 74 65 72 20 77 69 6c 6c 20 ** pointer will
8320: 77 6f 72 6b 20 68 65 72 65 20 61 73 20 6c 6f 6e work here as lon
8330: 67 20 61 73 20 69 74 20 69 73 20 64 69 73 74 69 g as it is disti
8340: 6e 63 74 20 66 72 6f 6d 20 53 51 4c 49 54 45 5f nct from SQLITE_
8350: 53 54 41 54 49 43 0a 2a 2a 20 61 6e 64 20 53 51 STATIC.** and SQ
8360: 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 2e 0a LITE_TRANSIENT..
8370: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
8380: 45 5f 44 59 4e 41 4d 49 43 20 20 20 28 28 73 71 E_DYNAMIC ((sq
8390: 6c 69 74 65 33 5f 64 65 73 74 72 75 63 74 6f 72 lite3_destructor
83a0: 5f 74 79 70 65 29 73 71 6c 69 74 65 33 4d 61 6c _type)sqlite3Mal
83b0: 6c 6f 63 53 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 locSize)../*.**
83c0: 57 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4d 49 54 When SQLITE_OMIT
83d0: 5f 57 53 44 20 69 73 20 64 65 66 69 6e 65 64 2c _WSD is defined,
83e0: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 it means that t
83f0: 68 65 20 74 61 72 67 65 74 20 70 6c 61 74 66 6f he target platfo
8400: 72 6d 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 73 rm does.** not s
8410: 75 70 70 6f 72 74 20 57 72 69 74 61 62 6c 65 20 upport Writable
8420: 53 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 Static Data (WSD
8430: 29 20 73 75 63 68 20 61 73 20 67 6c 6f 62 61 6c ) such as global
8440: 20 61 6e 64 20 73 74 61 74 69 63 20 76 61 72 69 and static vari
8450: 61 62 6c 65 73 2e 0a 2a 2a 20 41 6c 6c 20 76 61 ables..** All va
8460: 72 69 61 62 6c 65 73 20 6d 75 73 74 20 65 69 74 riables must eit
8470: 68 65 72 20 62 65 20 6f 6e 20 74 68 65 20 73 74 her be on the st
8480: 61 63 6b 20 6f 72 20 64 79 6e 61 6d 69 63 61 6c ack or dynamical
8490: 6c 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f ly allocated fro
84a0: 6d 0a 2a 2a 20 74 68 65 20 68 65 61 70 2e 20 20 m.** the heap.
84b0: 57 68 65 6e 20 57 53 44 20 69 73 20 75 6e 73 75 When WSD is unsu
84c0: 70 70 6f 72 74 65 64 2c 20 74 68 65 20 76 61 72 pported, the var
84d0: 69 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f iable declaratio
84e0: 6e 73 20 73 63 61 74 74 65 72 65 64 0a 2a 2a 20 ns scattered.**
84f0: 74 68 72 6f 75 67 68 6f 75 74 20 74 68 65 20 53 throughout the S
8500: 51 4c 69 74 65 20 63 6f 64 65 20 6d 75 73 74 20 QLite code must
8510: 62 65 63 6f 6d 65 20 63 6f 6e 73 74 61 6e 74 73 become constants
8520: 20 69 6e 73 74 65 61 64 2e 20 20 54 68 65 20 53 instead. The S
8530: 51 4c 49 54 45 5f 57 53 44 0a 2a 2a 20 6d 61 63 QLITE_WSD.** mac
8540: 72 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 ro is used for t
8550: 68 69 73 20 70 75 72 70 6f 73 65 2e 20 20 41 6e his purpose. An
8560: 64 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 66 d instead of ref
8570: 65 72 65 6e 63 69 6e 67 20 74 68 65 20 76 61 72 erencing the var
8580: 69 61 62 6c 65 0a 2a 2a 20 64 69 72 65 63 74 6c iable.** directl
8590: 79 2c 20 77 65 20 75 73 65 20 69 74 73 20 63 6f y, we use its co
85a0: 6e 73 74 61 6e 74 20 61 73 20 61 20 6b 65 79 20 nstant as a key
85b0: 74 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 72 75 to lookup the ru
85c0: 6e 2d 74 69 6d 65 20 61 6c 6c 6f 63 61 74 65 64 n-time allocated
85d0: 0a 2a 2a 20 62 75 66 66 65 72 20 74 68 61 74 20 .** buffer that
85e0: 68 6f 6c 64 73 20 72 65 61 6c 20 76 61 72 69 61 holds real varia
85f0: 62 6c 65 2e 20 20 54 68 65 20 63 6f 6e 73 74 61 ble. The consta
8600: 6e 74 20 69 73 20 61 6c 73 6f 20 74 68 65 20 69 nt is also the i
8610: 6e 69 74 69 61 6c 69 7a 65 72 0a 2a 2a 20 66 6f nitializer.** fo
8620: 72 20 74 68 65 20 72 75 6e 2d 74 69 6d 65 20 61 r the run-time a
8630: 6c 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e llocated buffer.
8640: 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 75 73 .**.** In the us
8650: 75 61 6c 20 63 61 73 65 20 77 68 65 72 65 20 57 ual case where W
8660: 53 44 20 69 73 20 73 75 70 70 6f 72 74 65 64 2c SD is supported,
8670: 20 74 68 65 20 53 51 4c 49 54 45 5f 57 53 44 20 the SQLITE_WSD
8680: 61 6e 64 20 47 4c 4f 42 41 4c 0a 2a 2a 20 6d 61 and GLOBAL.** ma
8690: 63 72 6f 73 20 62 65 63 6f 6d 65 20 6e 6f 2d 6f cros become no-o
86a0: 70 73 20 61 6e 64 20 68 61 76 65 20 7a 65 72 6f ps and have zero
86b0: 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70 performance imp
86c0: 61 63 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 act..*/.#ifdef S
86d0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 QLITE_OMIT_WSD.
86e0: 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f #define SQLITE_
86f0: 57 53 44 20 63 6f 6e 73 74 0a 20 20 23 64 65 66 WSD const. #def
8700: 69 6e 65 20 47 4c 4f 42 41 4c 28 74 2c 76 29 20 ine GLOBAL(t,v)
8710: 28 2a 28 74 2a 29 73 71 6c 69 74 65 33 5f 77 73 (*(t*)sqlite3_ws
8720: 64 5f 66 69 6e 64 28 28 76 6f 69 64 2a 29 26 28 d_find((void*)&(
8730: 76 29 2c 20 73 69 7a 65 6f 66 28 76 29 29 29 0a v), sizeof(v))).
8740: 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
8750: 33 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20 47 4c 3GlobalConfig GL
8760: 4f 42 41 4c 28 73 74 72 75 63 74 20 53 71 6c 69 OBAL(struct Sqli
8770: 74 65 33 43 6f 6e 66 69 67 2c 20 73 71 6c 69 74 te3Config, sqlit
8780: 65 33 43 6f 6e 66 69 67 29 0a 20 20 69 6e 74 20 e3Config). int
8790: 73 71 6c 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 sqlite3_wsd_init
87a0: 28 69 6e 74 20 4e 2c 20 69 6e 74 20 4a 29 3b 0a (int N, int J);.
87b0: 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f void *sqlite3_
87c0: 77 73 64 5f 66 69 6e 64 28 76 6f 69 64 20 2a 4b wsd_find(void *K
87d0: 2c 20 69 6e 74 20 4c 29 3b 0a 23 65 6c 73 65 0a , int L);.#else.
87e0: 20 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 #define SQLITE
87f0: 5f 57 53 44 0a 20 20 23 64 65 66 69 6e 65 20 47 _WSD. #define G
8800: 4c 4f 42 41 4c 28 74 2c 76 29 20 76 0a 20 20 23 LOBAL(t,v) v. #
8810: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 6c define sqlite3Gl
8820: 6f 62 61 6c 43 6f 6e 66 69 67 20 73 71 6c 69 74 obalConfig sqlit
8830: 65 33 43 6f 6e 66 69 67 0a 23 65 6e 64 69 66 0a e3Config.#endif.
8840: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
8850: 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 65 20 wing macros are
8860: 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 used to suppress
8870: 20 63 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e compiler warnin
8880: 67 73 20 61 6e 64 20 74 6f 0a 2a 2a 20 6d 61 6b gs and to.** mak
8890: 65 20 69 74 20 63 6c 65 61 72 20 74 6f 20 68 75 e it clear to hu
88a0: 6d 61 6e 20 72 65 61 64 65 72 73 20 77 68 65 6e man readers when
88b0: 20 61 20 66 75 6e 63 74 69 6f 6e 20 70 61 72 61 a function para
88c0: 6d 65 74 65 72 20 69 73 20 64 65 6c 69 62 65 72 meter is deliber
88d0: 61 74 65 6c 79 0a 2a 2a 20 6c 65 66 74 20 75 6e ately.** left un
88e0: 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 used within the
88f0: 62 6f 64 79 20 6f 66 20 61 20 66 75 6e 63 74 69 body of a functi
8900: 6f 6e 2e 20 54 68 69 73 20 75 73 75 61 6c 6c 79 on. This usually
8910: 20 68 61 70 70 65 6e 73 20 77 68 65 6e 0a 2a 2a happens when.**
8920: 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 a function is c
8930: 61 6c 6c 65 64 20 76 69 61 20 61 20 66 75 6e 63 alled via a func
8940: 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e 20 46 6f tion pointer. Fo
8950: 72 20 65 78 61 6d 70 6c 65 20 74 68 65 0a 2a 2a r example the.**
8960: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
8970: 6f 66 20 61 6e 20 53 51 4c 20 61 67 67 72 65 67 of an SQL aggreg
8980: 61 74 65 20 73 74 65 70 20 63 61 6c 6c 62 61 63 ate step callbac
8990: 6b 20 6d 61 79 20 6e 6f 74 20 75 73 65 20 74 68 k may not use th
89a0: 65 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69 e.** parameter i
89b0: 6e 64 69 63 61 74 69 6e 67 20 74 68 65 20 6e 75 ndicating the nu
89c0: 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
89d0: 73 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 s passed to the
89e0: 61 67 67 72 65 67 61 74 65 2c 0a 2a 2a 20 69 66 aggregate,.** if
89f0: 20 69 74 20 6b 6e 6f 77 73 20 74 68 61 74 20 74 it knows that t
8a00: 68 69 73 20 69 73 20 65 6e 66 6f 72 63 65 64 20 his is enforced
8a10: 65 6c 73 65 77 68 65 72 65 2e 0a 2a 2a 0a 2a 2a elsewhere..**.**
8a20: 20 57 68 65 6e 20 61 20 66 75 6e 63 74 69 6f 6e When a function
8a30: 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f parameter is no
8a40: 74 20 75 73 65 64 20 61 74 20 61 6c 6c 20 77 69 t used at all wi
8a50: 74 68 69 6e 20 74 68 65 20 62 6f 64 79 20 6f 66 thin the body of
8a60: 20 61 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 a function,.**
8a70: 69 74 20 69 73 20 67 65 6e 65 72 61 6c 6c 79 20 it is generally
8a80: 6e 61 6d 65 64 20 22 4e 6f 74 55 73 65 64 22 20 named "NotUsed"
8a90: 6f 72 20 22 4e 6f 74 55 73 65 64 32 22 20 74 6f or "NotUsed2" to
8aa0: 20 6d 61 6b 65 20 74 68 69 6e 67 73 20 65 76 65 make things eve
8ab0: 6e 20 63 6c 65 61 72 65 72 2e 0a 2a 2a 20 48 6f n clearer..** Ho
8ac0: 77 65 76 65 72 2c 20 74 68 65 73 65 20 6d 61 63 wever, these mac
8ad0: 72 6f 73 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 ros may also be
8ae0: 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 used to suppress
8af0: 20 77 61 72 6e 69 6e 67 73 20 72 65 6c 61 74 65 warnings relate
8b00: 64 20 74 6f 0a 2a 2a 20 70 61 72 61 6d 65 74 65 d to.** paramete
8b10: 72 73 20 74 68 61 74 20 6d 61 79 20 6f 72 20 6d rs that may or m
8b20: 61 79 20 6e 6f 74 20 62 65 20 75 73 65 64 20 64 ay not be used d
8b30: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f 6d 70 epending on comp
8b40: 69 6c 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 2e ilation options.
8b50: 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 .** For example
8b60: 74 68 6f 73 65 20 70 61 72 61 6d 65 74 65 72 73 those parameters
8b70: 20 6f 6e 6c 79 20 75 73 65 64 20 69 6e 20 61 73 only used in as
8b80: 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
8b90: 73 2e 20 49 6e 20 74 68 65 73 65 0a 2a 2a 20 63 s. In these.** c
8ba0: 61 73 65 73 20 74 68 65 20 70 61 72 61 6d 65 74 ases the paramet
8bb0: 65 72 73 20 61 72 65 20 6e 61 6d 65 64 20 61 73 ers are named as
8bc0: 20 70 65 72 20 74 68 65 20 75 73 75 61 6c 20 63 per the usual c
8bd0: 6f 6e 76 65 6e 74 69 6f 6e 73 2e 0a 2a 2f 0a 23 onventions..*/.#
8be0: 64 65 66 69 6e 65 20 55 4e 55 53 45 44 5f 50 41 define UNUSED_PA
8bf0: 52 41 4d 45 54 45 52 28 78 29 20 28 76 6f 69 64 RAMETER(x) (void
8c00: 29 28 78 29 0a 23 64 65 66 69 6e 65 20 55 4e 55 )(x).#define UNU
8c10: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 78 SED_PARAMETER2(x
8c20: 2c 79 29 20 55 4e 55 53 45 44 5f 50 41 52 41 4d ,y) UNUSED_PARAM
8c30: 45 54 45 52 28 78 29 2c 55 4e 55 53 45 44 5f 50 ETER(x),UNUSED_P
8c40: 41 52 41 4d 45 54 45 52 28 79 29 0a 0a 2f 2a 0a ARAMETER(y)../*.
8c50: 2a 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 ** Forward refer
8c60: 65 6e 63 65 73 20 74 6f 20 73 74 72 75 63 74 75 ences to structu
8c70: 72 65 73 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 res.*/.typedef s
8c80: 74 72 75 63 74 20 41 67 67 49 6e 66 6f 20 41 67 truct AggInfo Ag
8c90: 67 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 gInfo;.typedef s
8ca0: 74 72 75 63 74 20 41 75 74 68 43 6f 6e 74 65 78 truct AuthContex
8cb0: 74 20 41 75 74 68 43 6f 6e 74 65 78 74 3b 0a 74 t AuthContext;.t
8cc0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 41 75 ypedef struct Au
8cd0: 74 6f 69 6e 63 49 6e 66 6f 20 41 75 74 6f 69 6e toincInfo Autoin
8ce0: 63 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 cInfo;.typedef s
8cf0: 74 72 75 63 74 20 42 69 74 76 65 63 20 42 69 74 truct Bitvec Bit
8d00: 76 65 63 3b 0a 74 79 70 65 64 65 66 20 73 74 72 vec;.typedef str
8d10: 75 63 74 20 43 6f 6c 6c 53 65 71 20 43 6f 6c 6c uct CollSeq Coll
8d20: 53 65 71 3b 0a 74 79 70 65 64 65 66 20 73 74 72 Seq;.typedef str
8d30: 75 63 74 20 43 6f 6c 75 6d 6e 20 43 6f 6c 75 6d uct Column Colum
8d40: 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 n;.typedef struc
8d50: 74 20 44 62 20 44 62 3b 0a 74 79 70 65 64 65 66 t Db Db;.typedef
8d60: 20 73 74 72 75 63 74 20 53 63 68 65 6d 61 20 53 struct Schema S
8d70: 63 68 65 6d 61 3b 0a 74 79 70 65 64 65 66 20 73 chema;.typedef s
8d80: 74 72 75 63 74 20 45 78 70 72 20 45 78 70 72 3b truct Expr Expr;
8d90: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8da0: 45 78 70 72 4c 69 73 74 20 45 78 70 72 4c 69 73 ExprList ExprLis
8db0: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
8dc0: 74 20 46 4b 65 79 20 46 4b 65 79 3b 0a 74 79 70 t FKey FKey;.typ
8dd0: 65 64 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 edef struct Func
8de0: 44 65 73 74 72 75 63 74 6f 72 20 46 75 6e 63 44 Destructor FuncD
8df0: 65 73 74 72 75 63 74 6f 72 3b 0a 74 79 70 65 64 estructor;.typed
8e00: 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 44 65 ef struct FuncDe
8e10: 66 20 46 75 6e 63 44 65 66 3b 0a 74 79 70 65 64 f FuncDef;.typed
8e20: 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 44 65 ef struct FuncDe
8e30: 66 48 61 73 68 20 46 75 6e 63 44 65 66 48 61 73 fHash FuncDefHas
8e40: 68 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 h;.typedef struc
8e50: 74 20 49 64 4c 69 73 74 20 49 64 4c 69 73 74 3b t IdList IdList;
8e60: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8e70: 49 6e 64 65 78 20 49 6e 64 65 78 3b 0a 74 79 70 Index Index;.typ
8e80: 65 64 65 66 20 73 74 72 75 63 74 20 49 6e 64 65 edef struct Inde
8e90: 78 53 61 6d 70 6c 65 20 49 6e 64 65 78 53 61 6d xSample IndexSam
8ea0: 70 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ple;.typedef str
8eb0: 75 63 74 20 4b 65 79 43 6c 61 73 73 20 4b 65 79 uct KeyClass Key
8ec0: 43 6c 61 73 73 3b 0a 74 79 70 65 64 65 66 20 73 Class;.typedef s
8ed0: 74 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 4b 65 truct KeyInfo Ke
8ee0: 79 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 yInfo;.typedef s
8ef0: 74 72 75 63 74 20 4c 6f 6f 6b 61 73 69 64 65 20 truct Lookaside
8f00: 4c 6f 6f 6b 61 73 69 64 65 3b 0a 74 79 70 65 64 Lookaside;.typed
8f10: 65 66 20 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 ef struct Lookas
8f20: 69 64 65 53 6c 6f 74 20 4c 6f 6f 6b 61 73 69 64 ideSlot Lookasid
8f30: 65 53 6c 6f 74 3b 0a 74 79 70 65 64 65 66 20 73 eSlot;.typedef s
8f40: 74 72 75 63 74 20 4d 6f 64 75 6c 65 20 4d 6f 64 truct Module Mod
8f50: 75 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ule;.typedef str
8f60: 75 63 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 uct NameContext
8f70: 4e 61 6d 65 43 6f 6e 74 65 78 74 3b 0a 74 79 70 NameContext;.typ
8f80: 65 64 65 66 20 73 74 72 75 63 74 20 50 61 72 73 edef struct Pars
8f90: 65 20 50 61 72 73 65 3b 0a 74 79 70 65 64 65 66 e Parse;.typedef
8fa0: 20 73 74 72 75 63 74 20 50 72 65 55 70 64 61 74 struct PreUpdat
8fb0: 65 20 50 72 65 55 70 64 61 74 65 3b 0a 74 79 70 e PreUpdate;.typ
8fc0: 65 64 65 66 20 73 74 72 75 63 74 20 50 72 69 6e edef struct Prin
8fd0: 74 66 41 72 67 75 6d 65 6e 74 73 20 50 72 69 6e tfArguments Prin
8fe0: 74 66 41 72 67 75 6d 65 6e 74 73 3b 0a 74 79 70 tfArguments;.typ
8ff0: 65 64 65 66 20 73 74 72 75 63 74 20 52 6f 77 53 edef struct RowS
9000: 65 74 20 52 6f 77 53 65 74 3b 0a 74 79 70 65 64 et RowSet;.typed
9010: 65 66 20 73 74 72 75 63 74 20 53 61 76 65 70 6f ef struct Savepo
9020: 69 6e 74 20 53 61 76 65 70 6f 69 6e 74 3b 0a 74 int Savepoint;.t
9030: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 65 ypedef struct Se
9040: 6c 65 63 74 20 53 65 6c 65 63 74 3b 0a 74 79 70 lect Select;.typ
9050: 65 64 65 66 20 73 74 72 75 63 74 20 53 51 4c 69 edef struct SQLi
9060: 74 65 54 68 72 65 61 64 20 53 51 4c 69 74 65 54 teThread SQLiteT
9070: 68 72 65 61 64 3b 0a 74 79 70 65 64 65 66 20 73 hread;.typedef s
9080: 74 72 75 63 74 20 53 65 6c 65 63 74 44 65 73 74 truct SelectDest
9090: 20 53 65 6c 65 63 74 44 65 73 74 3b 0a 74 79 70 SelectDest;.typ
90a0: 65 64 65 66 20 73 74 72 75 63 74 20 53 72 63 4c edef struct SrcL
90b0: 69 73 74 20 53 72 63 4c 69 73 74 3b 0a 74 79 70 ist SrcList;.typ
90c0: 65 64 65 66 20 73 74 72 75 63 74 20 73 71 6c 69 edef struct sqli
90d0: 74 65 33 5f 73 74 72 20 53 74 72 41 63 63 75 6d te3_str StrAccum
90e0: 3b 20 2f 2a 20 49 6e 74 65 72 6e 61 6c 20 61 6c ; /* Internal al
90f0: 69 61 73 20 66 6f 72 20 73 71 6c 69 74 65 33 5f ias for sqlite3_
9100: 73 74 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 73 str */.typedef s
9110: 74 72 75 63 74 20 54 61 62 6c 65 20 54 61 62 6c truct Table Tabl
9120: 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 e;.typedef struc
9130: 74 20 54 61 62 6c 65 4c 6f 63 6b 20 54 61 62 6c t TableLock Tabl
9140: 65 4c 6f 63 6b 3b 0a 74 79 70 65 64 65 66 20 73 eLock;.typedef s
9150: 74 72 75 63 74 20 54 6f 6b 65 6e 20 54 6f 6b 65 truct Token Toke
9160: 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 n;.typedef struc
9170: 74 20 54 72 65 65 56 69 65 77 20 54 72 65 65 56 t TreeView TreeV
9180: 69 65 77 3b 0a 74 79 70 65 64 65 66 20 73 74 72 iew;.typedef str
9190: 75 63 74 20 54 72 69 67 67 65 72 20 54 72 69 67 uct Trigger Trig
91a0: 67 65 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ger;.typedef str
91b0: 75 63 74 20 54 72 69 67 67 65 72 50 72 67 20 54 uct TriggerPrg T
91c0: 72 69 67 67 65 72 50 72 67 3b 0a 74 79 70 65 64 riggerPrg;.typed
91d0: 65 66 20 73 74 72 75 63 74 20 54 72 69 67 67 65 ef struct Trigge
91e0: 72 53 74 65 70 20 54 72 69 67 67 65 72 53 74 65 rStep TriggerSte
91f0: 70 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 p;.typedef struc
9200: 74 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 t UnpackedRecord
9210: 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 3b UnpackedRecord;
9220: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
9230: 55 70 73 65 72 74 20 55 70 73 65 72 74 3b 0a 74 Upsert Upsert;.t
9240: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 56 54 ypedef struct VT
9250: 61 62 6c 65 20 56 54 61 62 6c 65 3b 0a 74 79 70 able VTable;.typ
9260: 65 64 65 66 20 73 74 72 75 63 74 20 56 74 61 62 edef struct Vtab
9270: 43 74 78 20 56 74 61 62 43 74 78 3b 0a 74 79 70 Ctx VtabCtx;.typ
9280: 65 64 65 66 20 73 74 72 75 63 74 20 57 61 6c 6b edef struct Walk
9290: 65 72 20 57 61 6c 6b 65 72 3b 0a 74 79 70 65 64 er Walker;.typed
92a0: 65 66 20 73 74 72 75 63 74 20 57 68 65 72 65 49 ef struct WhereI
92b0: 6e 66 6f 20 57 68 65 72 65 49 6e 66 6f 3b 0a 74 nfo WhereInfo;.t
92c0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 57 69 ypedef struct Wi
92d0: 74 68 20 57 69 74 68 3b 0a 0a 2f 2a 20 41 20 56 th With;../* A V
92e0: 4c 69 73 74 20 6f 62 6a 65 63 74 20 72 65 63 6f List object reco
92f0: 72 64 73 20 61 20 6d 61 70 70 69 6e 67 20 62 65 rds a mapping be
9300: 74 77 65 65 6e 20 70 61 72 61 6d 65 74 65 72 73 tween parameters
9310: 2f 76 61 72 69 61 62 6c 65 73 2f 77 69 6c 64 63 /variables/wildc
9320: 61 72 64 73 0a 2a 2a 20 69 6e 20 74 68 65 20 53 ards.** in the S
9330: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 28 73 75 QL statement (su
9340: 63 68 20 61 73 20 24 61 62 63 2c 20 40 70 71 72 ch as $abc, @pqr
9350: 2c 20 6f 72 20 3a 78 79 7a 29 20 61 6e 64 20 74 , or :xyz) and t
9360: 68 65 20 69 6e 74 65 67 65 72 0a 2a 2a 20 76 61 he integer.** va
9370: 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 20 61 73 riable number as
9380: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
9390: 61 74 20 70 61 72 61 6d 65 74 65 72 2e 20 20 53 at parameter. S
93a0: 65 65 20 74 68 65 20 66 6f 72 6d 61 74 20 64 65 ee the format de
93b0: 73 63 72 69 70 74 69 6f 6e 0a 2a 2a 20 6f 6e 20 scription.** on
93c0: 74 68 65 20 73 71 6c 69 74 65 33 56 4c 69 73 74 the sqlite3VList
93d0: 41 64 64 28 29 20 72 6f 75 74 69 6e 65 20 66 6f Add() routine fo
93e0: 72 20 6d 6f 72 65 20 69 6e 66 6f 72 6d 61 74 69 r more informati
93f0: 6f 6e 2e 20 20 41 20 56 4c 69 73 74 20 69 73 20 on. A VList is
9400: 72 65 61 6c 6c 79 0a 2a 2a 20 6a 75 73 74 20 61 really.** just a
9410: 6e 20 61 72 72 61 79 20 6f 66 20 69 6e 74 65 67 n array of integ
9420: 65 72 73 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 ers..*/.typedef
9430: 69 6e 74 20 56 4c 69 73 74 3b 0a 0a 2f 2a 0a 2a int VList;../*.*
9440: 2a 20 44 65 66 65 72 20 73 6f 75 72 63 69 6e 67 * Defer sourcing
9450: 20 76 64 62 65 2e 68 20 61 6e 64 20 62 74 72 65 vdbe.h and btre
9460: 65 2e 68 20 75 6e 74 69 6c 20 61 66 74 65 72 20 e.h until after
9470: 74 68 65 20 22 75 38 22 20 61 6e 64 0a 2a 2a 20 the "u8" and.**
9480: 22 42 75 73 79 48 61 6e 64 6c 65 72 22 20 74 79 "BusyHandler" ty
9490: 70 65 64 65 66 73 2e 20 76 64 62 65 2e 68 20 61 pedefs. vdbe.h a
94a0: 6c 73 6f 20 72 65 71 75 69 72 65 73 20 61 20 66 lso requires a f
94b0: 65 77 20 6f 66 20 74 68 65 20 6f 70 61 71 75 65 ew of the opaque
94c0: 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 79 70 65 .** pointer type
94d0: 73 20 28 69 2e 65 2e 20 46 75 6e 63 44 65 66 29 s (i.e. FuncDef)
94e0: 20 64 65 66 69 6e 65 64 20 61 62 6f 76 65 2e 0a defined above..
94f0: 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 62 74 72 */.#include "btr
9500: 65 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 ee.h".#include "
9510: 76 64 62 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 vdbe.h".#include
9520: 20 22 70 61 67 65 72 2e 68 22 0a 23 69 6e 63 6c "pager.h".#incl
9530: 75 64 65 20 22 70 63 61 63 68 65 2e 68 22 0a 23 ude "pcache.h".#
9540: 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 include "os.h".#
9550: 69 6e 63 6c 75 64 65 20 22 6d 75 74 65 78 2e 68 include "mutex.h
9560: 22 0a 0a 2f 2a 20 54 68 65 20 53 51 4c 49 54 45 "../* The SQLITE
9570: 5f 45 58 54 52 41 5f 44 55 52 41 42 4c 45 20 63 _EXTRA_DURABLE c
9580: 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 ompile-time opti
9590: 6f 6e 20 75 73 65 64 20 74 6f 20 73 65 74 20 74 on used to set t
95a0: 68 65 20 64 65 66 61 75 6c 74 0a 2a 2a 20 73 79 he default.** sy
95b0: 6e 63 68 72 6f 6e 6f 75 73 20 73 65 74 74 69 6e nchronous settin
95c0: 67 20 74 6f 20 45 58 54 52 41 2e 20 20 49 74 20 g to EXTRA. It
95d0: 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 73 75 70 is no longer sup
95e0: 70 6f 72 74 65 64 2e 0a 2a 2f 0a 23 69 66 64 65 ported..*/.#ifde
95f0: 66 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f 44 f SQLITE_EXTRA_D
9600: 55 52 41 42 4c 45 0a 23 20 77 61 72 6e 69 6e 67 URABLE.# warning
9610: 20 55 73 65 20 53 51 4c 49 54 45 5f 44 45 46 41 Use SQLITE_DEFA
9620: 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 3d ULT_SYNCHRONOUS=
9630: 33 20 69 6e 73 74 65 61 64 20 6f 66 20 53 51 4c 3 instead of SQL
9640: 49 54 45 5f 45 58 54 52 41 5f 44 55 52 41 42 4c ITE_EXTRA_DURABL
9650: 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 E.# define SQLIT
9660: 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 E_DEFAULT_SYNCHR
9670: 4f 4e 4f 55 53 20 33 0a 23 65 6e 64 69 66 0a 0a ONOUS 3.#endif..
9680: 2f 2a 0a 2a 2a 20 44 65 66 61 75 6c 74 20 73 79 /*.** Default sy
9690: 6e 63 68 72 6f 6e 6f 75 73 20 6c 65 76 65 6c 73 nchronous levels
96a0: 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 ..**.** Note tha
96b0: 74 20 28 66 6f 72 20 68 69 73 74 6f 72 63 61 6c t (for historcal
96c0: 20 72 65 61 73 6f 6e 73 29 20 74 68 65 20 50 41 reasons) the PA
96d0: 47 45 52 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 5f GER_SYNCHRONOUS_
96e0: 2a 20 6d 61 63 72 6f 73 20 64 69 66 66 65 72 0a * macros differ.
96f0: 2a 2a 20 66 72 6f 6d 20 74 68 65 20 53 51 4c 49 ** from the SQLI
9700: 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 TE_DEFAULT_SYNCH
9710: 52 4f 4e 4f 55 53 20 76 61 6c 75 65 20 62 79 20 RONOUS value by
9720: 31 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 20 20 1..**.**
9730: 20 20 20 50 41 47 45 52 5f 53 59 4e 43 48 52 4f PAGER_SYNCHRO
9740: 4e 4f 55 53 20 20 20 20 20 20 20 44 45 46 41 55 NOUS DEFAU
9750: 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 0a 2a LT_SYNCHRONOUS.*
9760: 2a 20 20 20 4f 46 46 20 20 20 20 20 20 20 20 20 * OFF
9770: 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20 20 1
9780: 20 20 20 20 20 20 20 20 20 20 20 20 30 0a 2a 2a 0.**
9790: 20 20 20 4e 4f 52 4d 41 4c 20 20 20 20 20 20 20 NORMAL
97a0: 20 32 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2
97b0: 20 20 20 20 20 20 20 20 20 20 20 31 0a 2a 2a 20 1.**
97c0: 20 20 46 55 4c 4c 20 20 20 20 20 20 20 20 20 20 FULL
97d0: 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 3
97e0: 20 20 20 20 20 20 20 20 20 20 32 0a 2a 2a 20 20 2.**
97f0: 20 45 58 54 52 41 20 20 20 20 20 20 20 20 20 34 EXTRA 4
9800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9810: 20 20 20 20 20 20 20 20 20 33 0a 2a 2a 0a 2a 2a 3.**.**
9820: 20 54 68 65 20 22 50 52 41 47 4d 41 20 73 79 6e The "PRAGMA syn
9830: 63 68 72 6f 6e 6f 75 73 22 20 73 74 61 74 65 6d chronous" statem
9840: 65 6e 74 20 61 6c 73 6f 20 75 73 65 73 20 74 68 ent also uses th
9850: 65 20 7a 65 72 6f 2d 62 61 73 65 64 20 6e 75 6d e zero-based num
9860: 62 65 72 73 2e 0a 2a 2a 20 49 6e 20 6f 74 68 65 bers..** In othe
9870: 72 20 77 6f 72 64 73 2c 20 74 68 65 20 7a 65 72 r words, the zer
9880: 6f 2d 62 61 73 65 64 20 6e 75 6d 62 65 72 73 20 o-based numbers
9890: 61 72 65 20 75 73 65 64 20 66 6f 72 20 61 6c 6c are used for all
98a0: 20 65 78 74 65 72 6e 61 6c 20 69 6e 74 65 72 66 external interf
98b0: 61 63 65 73 0a 2a 2a 20 61 6e 64 20 74 68 65 20 aces.** and the
98c0: 6f 6e 65 2d 62 61 73 65 64 20 76 61 6c 75 65 73 one-based values
98d0: 20 61 72 65 20 75 73 65 64 20 69 6e 74 65 72 6e are used intern
98e0: 61 6c 6c 79 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 ally..*/.#ifndef
98f0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
9900: 53 59 4e 43 48 52 4f 4e 4f 55 53 0a 23 20 64 65 SYNCHRONOUS.# de
9910: 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 fine SQLITE_DEFA
9920: 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 ULT_SYNCHRONOUS
9930: 32 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 2.#endif.#ifndef
9940: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
9950: 57 41 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 0a WAL_SYNCHRONOUS.
9960: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
9970: 44 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 4e 43 DEFAULT_WAL_SYNC
9980: 48 52 4f 4e 4f 55 53 20 53 51 4c 49 54 45 5f 44 HRONOUS SQLITE_D
9990: 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f EFAULT_SYNCHRONO
99a0: 55 53 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a US.#endif../*.**
99b0: 20 45 61 63 68 20 64 61 74 61 62 61 73 65 20 66 Each database f
99c0: 69 6c 65 20 74 6f 20 62 65 20 61 63 63 65 73 73 ile to be access
99d0: 65 64 20 62 79 20 74 68 65 20 73 79 73 74 65 6d ed by the system
99e0: 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a is an instance.
99f0: 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ** of the follow
9a00: 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 20 20 ing structure.
9a10: 54 68 65 72 65 20 61 72 65 20 6e 6f 72 6d 61 6c There are normal
9a20: 6c 79 20 74 77 6f 20 6f 66 20 74 68 65 73 65 20 ly two of these
9a30: 73 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 69 6e structures.** in
9a40: 20 74 68 65 20 73 71 6c 69 74 65 2e 61 44 62 5b the sqlite.aDb[
9a50: 5d 20 61 72 72 61 79 2e 20 20 61 44 62 5b 30 5d ] array. aDb[0]
9a60: 20 69 73 20 74 68 65 20 6d 61 69 6e 20 64 61 74 is the main dat
9a70: 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 0a 2a abase file and.*
9a80: 2a 20 61 44 62 5b 31 5d 20 69 73 20 74 68 65 20 * aDb[1] is the
9a90: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 75 73 database file us
9aa0: 65 64 20 74 6f 20 68 6f 6c 64 20 74 65 6d 70 6f ed to hold tempo
9ab0: 72 61 72 79 20 74 61 62 6c 65 73 2e 20 20 41 64 rary tables. Ad
9ac0: 64 69 74 69 6f 6e 61 6c 0a 2a 2a 20 64 61 74 61 ditional.** data
9ad0: 62 61 73 65 73 20 6d 61 79 20 62 65 20 61 74 74 bases may be att
9ae0: 61 63 68 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 ached..*/.struct
9af0: 20 44 62 20 7b 0a 20 20 63 68 61 72 20 2a 7a 44 Db {. char *zD
9b00: 62 53 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 bSName; /*
9b10: 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 64 61 74 Name of this dat
9b20: 61 62 61 73 65 2e 20 28 73 63 68 65 6d 61 20 6e abase. (schema n
9b30: 61 6d 65 2c 20 6e 6f 74 20 66 69 6c 65 6e 61 6d ame, not filenam
9b40: 65 29 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 e) */. Btree *p
9b50: 42 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 Bt; /*
9b60: 54 68 65 20 42 2a 54 72 65 65 20 73 74 72 75 63 The B*Tree struc
9b70: 74 75 72 65 20 66 6f 72 20 74 68 69 73 20 64 61 ture for this da
9b80: 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 tabase file */.
9b90: 20 75 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c u8 safety_level
9ba0: 3b 20 20 20 20 20 2f 2a 20 48 6f 77 20 61 67 67 ; /* How agg
9bb0: 72 65 73 73 69 76 65 20 61 74 20 73 79 6e 63 69 ressive at synci
9bc0: 6e 67 20 64 61 74 61 20 74 6f 20 64 69 73 6b 20 ng data to disk
9bd0: 2a 2f 0a 20 20 75 38 20 62 53 79 6e 63 53 65 74 */. u8 bSyncSet
9be0: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 ; /* Tru
9bf0: 65 20 69 66 20 22 50 52 41 47 4d 41 20 73 79 6e e if "PRAGMA syn
9c00: 63 68 72 6f 6e 6f 75 73 3d 4e 22 20 68 61 73 20 chronous=N" has
9c10: 62 65 65 6e 20 72 75 6e 20 2a 2f 0a 20 20 53 63 been run */. Sc
9c20: 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 hema *pSchema;
9c30: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
9c40: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
9c50: 20 28 70 6f 73 73 69 62 6c 79 20 73 68 61 72 65 (possibly share
9c60: 64 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 d) */.};../*.**
9c70: 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 An instance of t
9c80: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
9c90: 75 63 74 75 72 65 20 73 74 6f 72 65 73 20 61 20 ucture stores a
9ca0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e database schema.
9cb0: 0a 2a 2a 0a 2a 2a 20 4d 6f 73 74 20 53 63 68 65 .**.** Most Sche
9cc0: 6d 61 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 ma objects are a
9cd0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 ssociated with a
9ce0: 20 42 74 72 65 65 2e 20 20 54 68 65 20 65 78 63 Btree. The exc
9cf0: 65 70 74 69 6f 6e 20 69 73 0a 2a 2a 20 74 68 65 eption is.** the
9d00: 20 53 63 68 65 6d 61 20 66 6f 72 20 74 68 65 20 Schema for the
9d10: 54 45 4d 50 20 64 61 74 61 62 61 65 73 20 28 73 TEMP databaes (s
9d20: 71 6c 69 74 65 33 2e 61 44 62 5b 31 5d 29 20 77 qlite3.aDb[1]) w
9d30: 68 69 63 68 20 69 73 20 66 72 65 65 2d 73 74 61 hich is free-sta
9d40: 6e 64 69 6e 67 2e 0a 2a 2a 20 49 6e 20 73 68 61 nding..** In sha
9d50: 72 65 64 20 63 61 63 68 65 20 6d 6f 64 65 2c 20 red cache mode,
9d60: 61 20 73 69 6e 67 6c 65 20 53 63 68 65 6d 61 20 a single Schema
9d70: 6f 62 6a 65 63 74 20 63 61 6e 20 62 65 20 73 68 object can be sh
9d80: 61 72 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 ared by multiple
9d90: 0a 2a 2a 20 42 74 72 65 65 73 20 74 68 61 74 20 .** Btrees that
9da0: 72 65 66 65 72 20 74 6f 20 74 68 65 20 73 61 6d refer to the sam
9db0: 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 42 74 53 e underlying BtS
9dc0: 68 61 72 65 64 20 6f 62 6a 65 63 74 2e 0a 2a 2a hared object..**
9dd0: 0a 2a 2a 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 .** Schema objec
9de0: 74 73 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 ts are automatic
9df0: 61 6c 6c 79 20 64 65 61 6c 6c 6f 63 61 74 65 64 ally deallocated
9e00: 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 20 42 when the last B
9e10: 74 72 65 65 20 74 68 61 74 0a 2a 2a 20 72 65 66 tree that.** ref
9e20: 65 72 65 6e 63 65 73 20 74 68 65 6d 20 69 73 20 erences them is
9e30: 64 65 73 74 72 6f 79 65 64 2e 20 20 20 54 68 65 destroyed. The
9e40: 20 54 45 4d 50 20 53 63 68 65 6d 61 20 69 73 20 TEMP Schema is
9e50: 6d 61 6e 75 61 6c 6c 79 20 66 72 65 65 64 20 62 manually freed b
9e60: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6c 6f y.** sqlite3_clo
9e70: 73 65 28 29 2e 0a 2a 0a 2a 2a 20 41 20 74 68 72 se()..*.** A thr
9e80: 65 61 64 20 6d 75 73 74 20 62 65 20 68 6f 6c 64 ead must be hold
9e90: 69 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 ing a mutex on t
9ea0: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
9eb0: 20 42 74 72 65 65 20 69 6e 20 6f 72 64 65 72 0a Btree in order.
9ec0: 2a 2a 20 74 6f 20 61 63 63 65 73 73 20 53 63 68 ** to access Sch
9ed0: 65 6d 61 20 63 6f 6e 74 65 6e 74 2e 20 20 54 68 ema content. Th
9ee0: 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 is implies that
9ef0: 74 68 65 20 74 68 72 65 61 64 20 6d 75 73 74 20 the thread must
9f00: 61 6c 73 6f 20 62 65 0a 2a 2a 20 68 6f 6c 64 69 also be.** holdi
9f10: 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e 20 74 68 ng a mutex on th
9f20: 65 20 73 71 6c 69 74 65 33 20 63 6f 6e 6e 65 63 e sqlite3 connec
9f30: 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 74 68 61 tion pointer tha
9f40: 74 20 6f 77 6e 73 20 74 68 65 20 42 74 72 65 65 t owns the Btree
9f50: 2e 0a 2a 2a 20 46 6f 72 20 61 20 54 45 4d 50 20 ..** For a TEMP
9f60: 53 63 68 65 6d 61 2c 20 6f 6e 6c 79 20 74 68 65 Schema, only the
9f70: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 74 65 connection mute
9f80: 78 20 69 73 20 72 65 71 75 69 72 65 64 2e 0a 2a x is required..*
9f90: 2f 0a 73 74 72 75 63 74 20 53 63 68 65 6d 61 20 /.struct Schema
9fa0: 7b 0a 20 20 69 6e 74 20 73 63 68 65 6d 61 5f 63 {. int schema_c
9fb0: 6f 6f 6b 69 65 3b 20 20 20 2f 2a 20 44 61 74 61 ookie; /* Data
9fc0: 62 61 73 65 20 73 63 68 65 6d 61 20 76 65 72 73 base schema vers
9fd0: 69 6f 6e 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 ion number for t
9fe0: 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 69 6e his file */. in
9ff0: 74 20 69 47 65 6e 65 72 61 74 69 6f 6e 3b 20 20 t iGeneration;
a000: 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 69 6f 6e /* Generation
a010: 20 63 6f 75 6e 74 65 72 2e 20 20 49 6e 63 72 65 counter. Incre
a020: 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68 mented with each
a030: 20 63 68 61 6e 67 65 20 2a 2f 0a 20 20 48 61 73 change */. Has
a040: 68 20 74 62 6c 48 61 73 68 3b 20 20 20 20 20 20 h tblHash;
a050: 20 20 2f 2a 20 41 6c 6c 20 74 61 62 6c 65 73 20 /* All tables
a060: 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d 65 20 indexed by name
a070: 2a 2f 0a 20 20 48 61 73 68 20 69 64 78 48 61 73 */. Hash idxHas
a080: 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c h; /* All
a090: 20 28 6e 61 6d 65 64 29 20 69 6e 64 69 63 65 73 (named) indices
a0a0: 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d 65 indexed by name
a0b0: 20 2a 2f 0a 20 20 48 61 73 68 20 74 72 69 67 48 */. Hash trigH
a0c0: 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 41 6c ash; /* Al
a0d0: 6c 20 74 72 69 67 67 65 72 73 20 69 6e 64 65 78 l triggers index
a0e0: 65 64 20 62 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 ed by name */.
a0f0: 48 61 73 68 20 66 6b 65 79 48 61 73 68 3b 20 20 Hash fkeyHash;
a100: 20 20 20 20 20 2f 2a 20 41 6c 6c 20 66 6f 72 65 /* All fore
a110: 69 67 6e 20 6b 65 79 73 20 62 79 20 72 65 66 65 ign keys by refe
a120: 72 65 6e 63 65 64 20 74 61 62 6c 65 20 6e 61 6d renced table nam
a130: 65 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 53 e */. Table *pS
a140: 65 71 54 61 62 3b 20 20 20 20 20 20 2f 2a 20 54 eqTab; /* T
a150: 68 65 20 73 71 6c 69 74 65 5f 73 65 71 75 65 6e he sqlite_sequen
a160: 63 65 20 74 61 62 6c 65 20 75 73 65 64 20 62 79 ce table used by
a170: 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 20 2a AUTOINCREMENT *
a180: 2f 0a 20 20 75 38 20 66 69 6c 65 5f 66 6f 72 6d /. u8 file_form
a190: 61 74 3b 20 20 20 20 20 20 2f 2a 20 53 63 68 65 at; /* Sche
a1a0: 6d 61 20 66 6f 72 6d 61 74 20 76 65 72 73 69 6f ma format versio
a1b0: 6e 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 20 n for this file
a1c0: 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 20 */. u8 enc;
a1d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 /* Tex
a1e0: 74 20 65 6e 63 6f 64 69 6e 67 20 75 73 65 64 20 t encoding used
a1f0: 62 79 20 74 68 69 73 20 64 61 74 61 62 61 73 65 by this database
a200: 20 2a 2f 0a 20 20 75 31 36 20 73 63 68 65 6d 61 */. u16 schema
a210: 46 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 46 6c Flags; /* Fl
a220: 61 67 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 ags associated w
a230: 69 74 68 20 74 68 69 73 20 73 63 68 65 6d 61 20 ith this schema
a240: 2a 2f 0a 20 20 69 6e 74 20 63 61 63 68 65 5f 73 */. int cache_s
a250: 69 7a 65 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d ize; /* Num
a260: 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 6f 20 ber of pages to
a270: 75 73 65 20 69 6e 20 74 68 65 20 63 61 63 68 65 use in the cache
a280: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 */.};../*.** Th
a290: 65 73 65 20 6d 61 63 72 6f 73 20 63 61 6e 20 62 ese macros can b
a2a0: 65 20 75 73 65 64 20 74 6f 20 74 65 73 74 2c 20 e used to test,
a2b0: 73 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 62 69 set, or clear bi
a2c0: 74 73 20 69 6e 20 74 68 65 0a 2a 2a 20 44 62 2e ts in the.** Db.
a2d0: 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 20 66 pSchema->flags f
a2e0: 69 65 6c 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ield..*/.#define
a2f0: 20 44 62 48 61 73 50 72 6f 70 65 72 74 79 28 44 DbHasProperty(D
a300: 2c 49 2c 50 29 20 20 20 20 20 28 28 28 44 29 2d ,I,P) (((D)-
a310: 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d >aDb[I].pSchema-
a320: 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 28 50 29 >schemaFlags&(P)
a330: 29 3d 3d 28 50 29 29 0a 23 64 65 66 69 6e 65 20 )==(P)).#define
a340: 44 62 48 61 73 41 6e 79 50 72 6f 70 65 72 74 79 DbHasAnyProperty
a350: 28 44 2c 49 2c 50 29 20 20 28 28 28 44 29 2d 3e (D,I,P) (((D)->
a360: 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d 3e aDb[I].pSchema->
a370: 73 63 68 65 6d 61 46 6c 61 67 73 26 28 50 29 29 schemaFlags&(P))
a380: 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 44 62 53 !=0).#define DbS
a390: 65 74 50 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 etProperty(D,I,P
a3a0: 29 20 20 20 20 20 28 44 29 2d 3e 61 44 62 5b 49 ) (D)->aDb[I
a3b0: 5d 2e 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d ].pSchema->schem
a3c0: 61 46 6c 61 67 73 7c 3d 28 50 29 0a 23 64 65 66 aFlags|=(P).#def
a3d0: 69 6e 65 20 44 62 43 6c 65 61 72 50 72 6f 70 65 ine DbClearPrope
a3e0: 72 74 79 28 44 2c 49 2c 50 29 20 20 20 28 44 29 rty(D,I,P) (D)
a3f0: 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 ->aDb[I].pSchema
a400: 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 3d 7e ->schemaFlags&=~
a410: 28 50 29 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 (P)../*.** Allow
a420: 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 ed values for th
a430: 65 20 44 42 2e 70 53 63 68 65 6d 61 2d 3e 66 6c e DB.pSchema->fl
a440: 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a ags field..**.**
a450: 20 54 68 65 20 44 42 5f 53 63 68 65 6d 61 4c 6f The DB_SchemaLo
a460: 61 64 65 64 20 66 6c 61 67 20 69 73 20 73 65 74 aded flag is set
a470: 20 61 66 74 65 72 20 74 68 65 20 64 61 74 61 62 after the datab
a480: 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 62 ase schema has b
a490: 65 65 6e 0a 2a 2a 20 72 65 61 64 20 69 6e 74 6f een.** read into
a4a0: 20 69 6e 74 65 72 6e 61 6c 20 68 61 73 68 20 74 internal hash t
a4b0: 61 62 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 44 42 5f ables..**.** DB_
a4c0: 55 6e 72 65 73 65 74 56 69 65 77 73 20 6d 65 61 UnresetViews mea
a4d0: 6e 73 20 74 68 61 74 20 6f 6e 65 20 6f 72 20 6d ns that one or m
a4e0: 6f 72 65 20 76 69 65 77 73 20 68 61 76 65 20 63 ore views have c
a4f0: 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 68 61 74 olumn names that
a500: 0a 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 66 69 .** have been fi
a510: 6c 6c 65 64 20 6f 75 74 2e 20 20 49 66 20 74 68 lled out. If th
a520: 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 e schema changes
a530: 2c 20 74 68 65 73 65 20 63 6f 6c 75 6d 6e 20 6e , these column n
a540: 61 6d 65 73 20 6d 69 67 68 74 0a 2a 2a 20 63 68 ames might.** ch
a550: 61 6e 67 65 73 20 61 6e 64 20 73 6f 20 74 68 65 anges and so the
a560: 20 76 69 65 77 20 77 69 6c 6c 20 6e 65 65 64 20 view will need
a570: 74 6f 20 62 65 20 72 65 73 65 74 2e 0a 2a 2f 0a to be reset..*/.
a580: 23 64 65 66 69 6e 65 20 44 42 5f 53 63 68 65 6d #define DB_Schem
a590: 61 4c 6f 61 64 65 64 20 20 20 20 30 78 30 30 30 aLoaded 0x000
a5a0: 31 20 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 61 1 /* The schema
a5b0: 20 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 64 has been loaded
a5c0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 55 */.#define DB_U
a5d0: 6e 72 65 73 65 74 56 69 65 77 73 20 20 20 20 30 nresetViews 0
a5e0: 78 30 30 30 32 20 20 2f 2a 20 53 6f 6d 65 20 76 x0002 /* Some v
a5f0: 69 65 77 73 20 68 61 76 65 20 64 65 66 69 6e 65 iews have define
a600: 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 2a d column names *
a610: 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 45 6d 70 /.#define DB_Emp
a620: 74 79 20 20 20 20 20 20 20 20 20 20 20 30 78 30 ty 0x0
a630: 30 30 34 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 004 /* The file
a640: 20 69 73 20 65 6d 70 74 79 20 28 6c 65 6e 67 74 is empty (lengt
a650: 68 20 30 20 62 79 74 65 73 29 20 2a 2f 0a 23 64 h 0 bytes) */.#d
a660: 65 66 69 6e 65 20 44 42 5f 52 65 73 65 74 57 61 efine DB_ResetWa
a670: 6e 74 65 64 20 20 20 20 20 30 78 30 30 30 38 20 nted 0x0008
a680: 20 2f 2a 20 52 65 73 65 74 20 74 68 65 20 73 63 /* Reset the sc
a690: 68 65 6d 61 20 77 68 65 6e 20 6e 53 63 68 65 6d hema when nSchem
a6a0: 61 4c 6f 63 6b 3d 3d 30 20 2a 2f 0a 0a 2f 2a 0a aLock==0 */../*.
a6b0: 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 ** The number of
a6c0: 20 64 69 66 66 65 72 65 6e 74 20 6b 69 6e 64 73 different kinds
a6d0: 20 6f 66 20 74 68 69 6e 67 73 20 74 68 61 74 20 of things that
a6e0: 63 61 6e 20 62 65 20 6c 69 6d 69 74 65 64 0a 2a can be limited.*
a6f0: 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c 69 * using the sqli
a700: 74 65 33 5f 6c 69 6d 69 74 28 29 20 69 6e 74 65 te3_limit() inte
a710: 72 66 61 63 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e rface..*/.#defin
a720: 65 20 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 e SQLITE_N_LIMIT
a730: 20 28 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 57 (SQLITE_LIMIT_W
a740: 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 2b 31 29 ORKER_THREADS+1)
a750: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 69 64 ../*.** Lookasid
a760: 65 20 6d 61 6c 6c 6f 63 20 69 73 20 61 20 73 65 e malloc is a se
a770: 74 20 6f 66 20 66 69 78 65 64 2d 73 69 7a 65 20 t of fixed-size
a780: 62 75 66 66 65 72 73 20 74 68 61 74 20 63 61 6e buffers that can
a790: 20 62 65 20 75 73 65 64 0a 2a 2a 20 74 6f 20 73 be used.** to s
a7a0: 61 74 69 73 66 79 20 73 6d 61 6c 6c 20 74 72 61 atisfy small tra
a7b0: 6e 73 69 65 6e 74 20 6d 65 6d 6f 72 79 20 61 6c nsient memory al
a7c0: 6c 6f 63 61 74 69 6f 6e 20 72 65 71 75 65 73 74 location request
a7d0: 73 20 66 6f 72 20 6f 62 6a 65 63 74 73 0a 2a 2a s for objects.**
a7e0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
a7f0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 a particular da
a800: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
a810: 6e 2e 20 20 54 68 65 20 75 73 65 20 6f 66 0a 2a n. The use of.*
a820: 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c * lookaside mall
a830: 6f 63 20 70 72 6f 76 69 64 65 73 20 61 20 73 69 oc provides a si
a840: 67 6e 69 66 69 63 61 6e 74 20 70 65 72 66 6f 72 gnificant perfor
a850: 6d 61 6e 63 65 20 65 6e 68 61 6e 63 65 6d 65 6e mance enhancemen
a860: 74 0a 2a 2a 20 28 61 70 70 72 6f 78 20 31 30 25 t.** (approx 10%
a870: 29 20 62 79 20 61 76 6f 69 64 69 6e 67 20 6e 75 ) by avoiding nu
a880: 6d 65 72 6f 75 73 20 6d 61 6c 6c 6f 63 2f 66 72 merous malloc/fr
a890: 65 65 20 72 65 71 75 65 73 74 73 20 77 68 69 6c ee requests whil
a8a0: 65 20 70 61 72 73 69 6e 67 0a 2a 2a 20 53 51 4c e parsing.** SQL
a8b0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a statements..**.
a8c0: 2a 2a 20 54 68 65 20 4c 6f 6f 6b 61 73 69 64 65 ** The Lookaside
a8d0: 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 structure holds
a8e0: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 configuration i
a8f0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 nformation about
a900: 20 74 68 65 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 the.** lookasid
a910: 65 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 e malloc subsyst
a920: 65 6d 2e 20 20 45 61 63 68 20 61 76 61 69 6c 61 em. Each availa
a930: 62 6c 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 ble memory alloc
a940: 61 74 69 6f 6e 20 69 6e 0a 2a 2a 20 74 68 65 20 ation in.** the
a950: 6c 6f 6f 6b 61 73 69 64 65 20 73 75 62 73 79 73 lookaside subsys
a960: 74 65 6d 20 69 73 20 73 74 6f 72 65 64 20 6f 6e tem is stored on
a970: 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f a linked list o
a980: 66 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 0a f LookasideSlot.
a990: 2a 2a 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a ** objects..**.*
a9a0: 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 61 6c 6c 6f * Lookaside allo
a9b0: 63 61 74 69 6f 6e 73 20 61 72 65 20 6f 6e 6c 79 cations are only
a9c0: 20 61 6c 6c 6f 77 65 64 20 66 6f 72 20 6f 62 6a allowed for obj
a9d0: 65 63 74 73 20 74 68 61 74 20 61 72 65 20 61 73 ects that are as
a9e0: 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 sociated.** with
a9f0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 a particular da
aa00: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
aa10: 6e 2e 20 20 48 65 6e 63 65 2c 20 73 63 68 65 6d n. Hence, schem
aa20: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 a information ca
aa30: 6e 6e 6f 74 0a 2a 2a 20 62 65 20 73 74 6f 72 65 nnot.** be store
aa40: 64 20 69 6e 20 6c 6f 6f 6b 61 73 69 64 65 20 62 d in lookaside b
aa50: 65 63 61 75 73 65 20 69 6e 20 73 68 61 72 65 64 ecause in shared
aa60: 20 63 61 63 68 65 20 6d 6f 64 65 20 74 68 65 20 cache mode the
aa70: 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 schema informati
aa80: 6f 6e 0a 2a 2a 20 69 73 20 73 68 61 72 65 64 20 on.** is shared
aa90: 62 79 20 6d 75 6c 74 69 70 6c 65 20 64 61 74 61 by multiple data
aaa0: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
aab0: 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 20 77 68 . Therefore, wh
aac0: 69 6c 65 20 70 61 72 73 69 6e 67 0a 2a 2a 20 73 ile parsing.** s
aad0: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f chema informatio
aae0: 6e 2c 20 74 68 65 20 4c 6f 6f 6b 61 73 69 64 65 n, the Lookaside
aaf0: 2e 62 45 6e 61 62 6c 65 64 20 66 6c 61 67 20 69 .bEnabled flag i
ab00: 73 20 63 6c 65 61 72 65 64 20 73 6f 20 74 68 61 s cleared so tha
ab10: 74 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 61 t.** lookaside a
ab20: 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 20 6e llocations are n
ab30: 6f 74 20 75 73 65 64 20 74 6f 20 63 6f 6e 73 74 ot used to const
ab40: 72 75 63 74 20 74 68 65 20 73 63 68 65 6d 61 20 ruct the schema
ab50: 6f 62 6a 65 63 74 73 2e 0a 2a 2f 0a 73 74 72 75 objects..*/.stru
ab60: 63 74 20 4c 6f 6f 6b 61 73 69 64 65 20 7b 0a 20 ct Lookaside {.
ab70: 20 75 33 32 20 62 44 69 73 61 62 6c 65 3b 20 20 u32 bDisable;
ab80: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 6c 79 /* Only
ab90: 20 6f 70 65 72 61 74 65 20 74 68 65 20 6c 6f 6f operate the loo
aba0: 6b 61 73 69 64 65 20 77 68 65 6e 20 7a 65 72 6f kaside when zero
abb0: 20 2a 2f 0a 20 20 75 31 36 20 73 7a 3b 20 20 20 */. u16 sz;
abc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
abd0: 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 62 75 Size of each bu
abe0: 66 66 65 72 20 69 6e 20 62 79 74 65 73 20 2a 2f ffer in bytes */
abf0: 0a 20 20 75 38 20 62 4d 61 6c 6c 6f 63 65 64 3b . u8 bMalloced;
ac00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
ac10: 75 65 20 69 66 20 70 53 74 61 72 74 20 6f 62 74 ue if pStart obt
ac20: 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 ained from sqlit
ac30: 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 20 e3_malloc() */.
ac40: 20 75 33 32 20 6e 53 6c 6f 74 3b 20 20 20 20 20 u32 nSlot;
ac50: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
ac60: 65 72 20 6f 66 20 6c 6f 6f 6b 61 73 69 64 65 20 er of lookaside
ac70: 73 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65 64 20 slots allocated
ac80: 2a 2f 0a 20 20 75 33 32 20 61 6e 53 74 61 74 5b */. u32 anStat[
ac90: 33 5d 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 3]; /*
aca0: 30 3a 20 68 69 74 73 2e 20 20 31 3a 20 73 69 7a 0: hits. 1: siz
acb0: 65 20 6d 69 73 73 65 73 2e 20 20 32 3a 20 66 75 e misses. 2: fu
acc0: 6c 6c 20 6d 69 73 73 65 73 20 2a 2f 0a 20 20 4c ll misses */. L
acd0: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 49 ookasideSlot *pI
ace0: 6e 69 74 3b 20 20 20 2f 2a 20 4c 69 73 74 20 6f nit; /* List o
acf0: 66 20 62 75 66 66 65 72 73 20 6e 6f 74 20 70 72 f buffers not pr
ad00: 65 76 69 6f 75 73 6c 79 20 75 73 65 64 20 2a 2f eviously used */
ad10: 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 . LookasideSlot
ad20: 20 2a 70 46 72 65 65 3b 20 20 20 2f 2a 20 4c 69 *pFree; /* Li
ad30: 73 74 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 st of available
ad40: 62 75 66 66 65 72 73 20 2a 2f 0a 20 20 76 6f 69 buffers */. voi
ad50: 64 20 2a 70 53 74 61 72 74 3b 20 20 20 20 20 20 d *pStart;
ad60: 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 /* First by
ad70: 74 65 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 te of available
ad80: 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a memory space */.
ad90: 20 20 76 6f 69 64 20 2a 70 45 6e 64 3b 20 20 20 void *pEnd;
ada0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
adb0: 73 74 20 62 79 74 65 20 70 61 73 74 20 65 6e 64 st byte past end
adc0: 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 73 70 of available sp
add0: 61 63 65 20 2a 2f 0a 7d 3b 0a 73 74 72 75 63 74 ace */.};.struct
ade0: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 7b LookasideSlot {
adf0: 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 . LookasideSlot
ae00: 20 2a 70 4e 65 78 74 3b 20 20 20 20 2f 2a 20 4e *pNext; /* N
ae10: 65 78 74 20 62 75 66 66 65 72 20 69 6e 20 74 68 ext buffer in th
ae20: 65 20 6c 69 73 74 20 6f 66 20 66 72 65 65 20 62 e list of free b
ae30: 75 66 66 65 72 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a uffers */.};../*
ae40: 0a 2a 2a 20 41 20 68 61 73 68 20 74 61 62 6c 65 .** A hash table
ae50: 20 66 6f 72 20 62 75 69 6c 74 2d 69 6e 20 66 75 for built-in fu
ae60: 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f nction definitio
ae70: 6e 73 2e 20 20 28 41 70 70 6c 69 63 61 74 69 6f ns. (Applicatio
ae80: 6e 2d 64 65 66 69 6e 65 64 0a 2a 2a 20 66 75 6e n-defined.** fun
ae90: 63 74 69 6f 6e 73 20 75 73 65 20 61 20 72 65 67 ctions use a reg
aea0: 75 6c 61 72 20 74 61 62 6c 65 20 74 61 62 6c 65 ular table table
aeb0: 20 66 72 6f 6d 20 68 61 73 68 2e 68 2e 29 0a 2a from hash.h.).*
aec0: 2a 0a 2a 2a 20 48 61 73 68 20 65 61 63 68 20 46 *.** Hash each F
aed0: 75 6e 63 44 65 66 20 73 74 72 75 63 74 75 72 65 uncDef structure
aee0: 20 69 6e 74 6f 20 6f 6e 65 20 6f 66 20 74 68 65 into one of the
aef0: 20 46 75 6e 63 44 65 66 48 61 73 68 2e 61 5b 5d FuncDefHash.a[]
af00: 20 73 6c 6f 74 73 2e 0a 2a 2a 20 43 6f 6c 6c 69 slots..** Colli
af10: 73 69 6f 6e 73 20 61 72 65 20 6f 6e 20 74 68 65 sions are on the
af20: 20 46 75 6e 63 44 65 66 2e 75 2e 70 48 61 73 68 FuncDef.u.pHash
af30: 20 63 68 61 69 6e 2e 0a 2a 2f 0a 23 64 65 66 69 chain..*/.#defi
af40: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 48 ne SQLITE_FUNC_H
af50: 41 53 48 5f 53 5a 20 32 33 0a 73 74 72 75 63 74 ASH_SZ 23.struct
af60: 20 46 75 6e 63 44 65 66 48 61 73 68 20 7b 0a 20 FuncDefHash {.
af70: 20 46 75 6e 63 44 65 66 20 2a 61 5b 53 51 4c 49 FuncDef *a[SQLI
af80: 54 45 5f 46 55 4e 43 5f 48 41 53 48 5f 53 5a 5d TE_FUNC_HASH_SZ]
af90: 3b 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68 20 ; /* Hash
afa0: 74 61 62 6c 65 20 66 6f 72 20 66 75 6e 63 74 69 table for functi
afb0: 6f 6e 73 20 2a 2f 0a 7d 3b 0a 0a 23 69 66 64 65 ons */.};..#ifde
afc0: 66 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 f SQLITE_USER_AU
afd0: 54 48 45 4e 54 49 43 41 54 49 4f 4e 0a 2f 2a 0a THENTICATION./*.
afe0: 2a 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 68 ** Information h
aff0: 65 6c 64 20 69 6e 20 74 68 65 20 22 73 71 6c 69 eld in the "sqli
b000: 74 65 33 22 20 64 61 74 61 62 61 73 65 20 63 6f te3" database co
b010: 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63 74 20 nnection object
b020: 61 6e 64 20 75 73 65 64 0a 2a 2a 20 74 6f 20 6d and used.** to m
b030: 61 6e 61 67 65 20 75 73 65 72 20 61 75 74 68 65 anage user authe
b040: 6e 74 69 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 74 79 ntication..*/.ty
b050: 70 65 64 65 66 20 73 74 72 75 63 74 20 73 71 6c pedef struct sql
b060: 69 74 65 33 5f 75 73 65 72 61 75 74 68 20 73 71 ite3_userauth sq
b070: 6c 69 74 65 33 5f 75 73 65 72 61 75 74 68 3b 0a lite3_userauth;.
b080: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 75 struct sqlite3_u
b090: 73 65 72 61 75 74 68 20 7b 0a 20 20 75 38 20 61 serauth {. u8 a
b0a0: 75 74 68 4c 65 76 65 6c 3b 20 20 20 20 20 20 20 uthLevel;
b0b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
b0c0: 72 65 6e 74 20 61 75 74 68 65 6e 74 69 63 61 74 rent authenticat
b0d0: 69 6f 6e 20 6c 65 76 65 6c 20 2a 2f 0a 20 20 69 ion level */. i
b0e0: 6e 74 20 6e 41 75 74 68 50 57 3b 20 20 20 20 20 nt nAuthPW;
b0f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b100: 53 69 7a 65 20 6f 66 20 74 68 65 20 7a 41 75 74 Size of the zAut
b110: 68 50 57 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a hPW in bytes */.
b120: 20 20 63 68 61 72 20 2a 7a 41 75 74 68 50 57 3b char *zAuthPW;
b130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b140: 2f 2a 20 50 61 73 73 77 6f 72 64 20 75 73 65 64 /* Password used
b150: 20 74 6f 20 61 75 74 68 65 6e 74 69 63 61 74 65 to authenticate
b160: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 41 75 74 */. char *zAut
b170: 68 55 73 65 72 3b 20 20 20 20 20 20 20 20 20 20 hUser;
b180: 20 20 20 20 2f 2a 20 55 73 65 72 20 6e 61 6d 65 /* User name
b190: 20 75 73 65 64 20 74 6f 20 61 75 74 68 65 6e 74 used to authent
b1a0: 69 63 61 74 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 icate */.};../*
b1b0: 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 Allowed values f
b1c0: 6f 72 20 73 71 6c 69 74 65 33 5f 75 73 65 72 61 or sqlite3_usera
b1d0: 75 74 68 2e 61 75 74 68 4c 65 76 65 6c 20 2a 2f uth.authLevel */
b1e0: 0a 23 64 65 66 69 6e 65 20 55 41 55 54 48 5f 55 .#define UAUTH_U
b1f0: 6e 6b 6e 6f 77 6e 20 20 20 20 20 30 20 20 20 20 nknown 0
b200: 20 2f 2a 20 41 75 74 68 65 6e 74 69 63 61 74 69 /* Authenticati
b210: 6f 6e 20 6e 6f 74 20 79 65 74 20 63 68 65 63 6b on not yet check
b220: 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 41 ed */.#define UA
b230: 55 54 48 5f 46 61 69 6c 20 20 20 20 20 20 20 20 UTH_Fail
b240: 31 20 20 20 20 20 2f 2a 20 55 73 65 72 20 61 75 1 /* User au
b250: 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 66 61 69 thentication fai
b260: 6c 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 led */.#define U
b270: 41 55 54 48 5f 55 73 65 72 20 20 20 20 20 20 20 AUTH_User
b280: 20 32 20 20 20 20 20 2f 2a 20 41 75 74 68 65 6e 2 /* Authen
b290: 74 69 63 61 74 65 64 20 61 73 20 61 20 6e 6f 72 ticated as a nor
b2a0: 6d 61 6c 20 75 73 65 72 20 2a 2f 0a 23 64 65 66 mal user */.#def
b2b0: 69 6e 65 20 55 41 55 54 48 5f 41 64 6d 69 6e 20 ine UAUTH_Admin
b2c0: 20 20 20 20 20 20 33 20 20 20 20 20 2f 2a 20 41 3 /* A
b2d0: 75 74 68 65 6e 74 69 63 61 74 65 64 20 61 73 20 uthenticated as
b2e0: 61 6e 20 61 64 6d 69 6e 69 73 74 72 61 74 6f 72 an administrator
b2f0: 20 2a 2f 0a 0a 2f 2a 20 46 75 6e 63 74 69 6f 6e */../* Function
b300: 73 20 75 73 65 64 20 6f 6e 6c 79 20 62 79 20 75 s used only by u
b310: 73 65 72 20 61 75 74 68 6f 72 69 7a 61 74 69 6f ser authorizatio
b320: 6e 20 6c 6f 67 69 63 20 2a 2f 0a 69 6e 74 20 73 n logic */.int s
b330: 71 6c 69 74 65 33 55 73 65 72 41 75 74 68 54 61 qlite3UserAuthTa
b340: 62 6c 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 ble(const char*)
b350: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 73 65 ;.int sqlite3Use
b360: 72 41 75 74 68 43 68 65 63 6b 4c 6f 67 69 6e 28 rAuthCheckLogin(
b370: 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 sqlite3*,const c
b380: 68 61 72 2a 2c 75 38 2a 29 3b 0a 76 6f 69 64 20 har*,u8*);.void
b390: 73 71 6c 69 74 65 33 55 73 65 72 41 75 74 68 49 sqlite3UserAuthI
b3a0: 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 nit(sqlite3*);.v
b3b0: 6f 69 64 20 73 71 6c 69 74 65 33 43 72 79 70 74 oid sqlite3Crypt
b3c0: 46 75 6e 63 28 73 71 6c 69 74 65 33 5f 63 6f 6e Func(sqlite3_con
b3d0: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
b3e0: 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 0a 23 65 6e 3_value**);..#en
b3f0: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 55 53 dif /* SQLITE_US
b400: 45 52 5f 41 55 54 48 45 4e 54 49 43 41 54 49 4f ER_AUTHENTICATIO
b410: 4e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 74 79 70 65 N */../*.** type
b420: 64 65 66 20 66 6f 72 20 74 68 65 20 61 75 74 68 def for the auth
b430: 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61 orization callba
b440: 63 6b 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a ck function..*/.
b450: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 53 #ifdef SQLITE_US
b460: 45 52 5f 41 55 54 48 45 4e 54 49 43 41 54 49 4f ER_AUTHENTICATIO
b470: 4e 0a 20 20 74 79 70 65 64 65 66 20 69 6e 74 20 N. typedef int
b480: 28 2a 73 71 6c 69 74 65 33 5f 78 61 75 74 68 29 (*sqlite3_xauth)
b490: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 (void*,int,const
b4a0: 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 char*,const cha
b4b0: 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 0a r*,const char*,.
b4c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b4d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 c
b4e0: 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 onst char*, cons
b4f0: 74 20 63 68 61 72 2a 29 3b 0a 23 65 6c 73 65 0a t char*);.#else.
b500: 20 20 74 79 70 65 64 65 66 20 69 6e 74 20 28 2a typedef int (*
b510: 73 71 6c 69 74 65 33 5f 78 61 75 74 68 29 28 76 sqlite3_xauth)(v
b520: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 oid*,int,const c
b530: 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a har*,const char*
b540: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 0a 20 20 ,const char*,.
b550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b560: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
b570: 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 st char*);.#endi
b580: 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 f..#ifndef SQLIT
b590: 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 E_OMIT_DEPRECATE
b5a0: 44 0a 2f 2a 20 54 68 69 73 20 69 73 20 61 6e 20 D./* This is an
b5b0: 65 78 74 72 61 20 53 51 4c 49 54 45 5f 54 52 41 extra SQLITE_TRA
b5c0: 43 45 20 6d 61 63 72 6f 20 74 68 61 74 20 69 6e CE macro that in
b5d0: 64 69 63 61 74 65 73 20 22 6c 65 67 61 63 79 22 dicates "legacy"
b5e0: 20 74 72 61 63 69 6e 67 0a 2a 2a 20 69 6e 20 74 tracing.** in t
b5f0: 68 65 20 73 74 79 6c 65 20 6f 66 20 73 71 6c 69 he style of sqli
b600: 74 65 33 5f 74 72 61 63 65 28 29 0a 2a 2f 0a 23 te3_trace().*/.#
b610: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 52 define SQLITE_TR
b620: 41 43 45 5f 4c 45 47 41 43 59 20 20 30 78 38 30 ACE_LEGACY 0x80
b630: 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 53 .#else.#define S
b640: 51 4c 49 54 45 5f 54 52 41 43 45 5f 4c 45 47 41 QLITE_TRACE_LEGA
b650: 43 59 20 20 30 0a 23 65 6e 64 69 66 20 2f 2a 20 CY 0.#endif /*
b660: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 SQLITE_OMIT_DEPR
b670: 45 43 41 54 45 44 20 2a 2f 0a 0a 0a 2f 2a 0a 2a ECATED */.../*.*
b680: 2a 20 45 61 63 68 20 64 61 74 61 62 61 73 65 20 * Each database
b690: 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 61 6e connection is an
b6a0: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
b6b0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
b6c0: 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ture..*/.struct
b6d0: 73 71 6c 69 74 65 33 20 7b 0a 20 20 73 71 6c 69 sqlite3 {. sqli
b6e0: 74 65 33 5f 76 66 73 20 2a 70 56 66 73 3b 20 20 te3_vfs *pVfs;
b6f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 53 20 /* OS
b700: 49 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 73 Interface */. s
b710: 74 72 75 63 74 20 56 64 62 65 20 2a 70 56 64 62 truct Vdbe *pVdb
b720: 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 e; /*
b730: 4c 69 73 74 20 6f 66 20 61 63 74 69 76 65 20 76 List of active v
b740: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 73 20 irtual machines
b750: 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 44 */. CollSeq *pD
b760: 66 6c 74 43 6f 6c 6c 3b 20 20 20 20 20 20 20 20 fltColl;
b770: 20 20 20 2f 2a 20 54 68 65 20 64 65 66 61 75 6c /* The defaul
b780: 74 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 t collating sequ
b790: 65 6e 63 65 20 28 42 49 4e 41 52 59 29 20 2a 2f ence (BINARY) */
b7a0: 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 . sqlite3_mutex
b7b0: 20 2a 6d 75 74 65 78 3b 20 20 20 20 20 20 20 20 *mutex;
b7c0: 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 6d /* Connection m
b7d0: 75 74 65 78 20 2a 2f 0a 20 20 44 62 20 2a 61 44 utex */. Db *aD
b7e0: 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b;
b7f0: 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 62 /* All b
b800: 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 69 6e 74 ackends */. int
b810: 20 6e 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 nDb;
b820: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
b830: 6d 62 65 72 20 6f 66 20 62 61 63 6b 65 6e 64 73 mber of backends
b840: 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 currently in us
b850: 65 20 2a 2f 0a 20 20 75 33 32 20 6d 44 62 46 6c e */. u32 mDbFl
b860: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
b870: 20 20 20 20 20 2f 2a 20 66 6c 61 67 73 20 72 65 /* flags re
b880: 63 6f 72 64 69 6e 67 20 69 6e 74 65 72 6e 61 6c cording internal
b890: 20 73 74 61 74 65 20 2a 2f 0a 20 20 75 33 32 20 state */. u32
b8a0: 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 flags;
b8b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 6c 61 /* fla
b8c0: 67 73 20 73 65 74 74 61 62 6c 65 20 62 79 20 70 gs settable by p
b8d0: 72 61 67 6d 61 73 2e 20 53 65 65 20 62 65 6c 6f ragmas. See belo
b8e0: 77 20 2a 2f 0a 20 20 69 36 34 20 6c 61 73 74 52 w */. i64 lastR
b8f0: 6f 77 69 64 3b 20 20 20 20 20 20 20 20 20 20 20 owid;
b900: 20 20 20 20 20 2f 2a 20 52 4f 57 49 44 20 6f 66 /* ROWID of
b910: 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 most recent ins
b920: 65 72 74 20 28 73 65 65 20 61 62 6f 76 65 29 20 ert (see above)
b930: 2a 2f 0a 20 20 69 36 34 20 73 7a 4d 6d 61 70 3b */. i64 szMmap;
b940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b950: 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 6d 6d /* Default mm
b960: 61 70 5f 73 69 7a 65 20 73 65 74 74 69 6e 67 20 ap_size setting
b970: 2a 2f 0a 20 20 75 33 32 20 6e 53 63 68 65 6d 61 */. u32 nSchema
b980: 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 Lock;
b990: 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 72 65 73 /* Do not res
b9a0: 65 74 20 74 68 65 20 73 63 68 65 6d 61 20 77 68 et the schema wh
b9b0: 65 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 2a 2f 0a 20 en non-zero */.
b9c0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6f 70 unsigned int op
b9d0: 65 6e 46 6c 61 67 73 3b 20 20 20 20 20 20 20 2f enFlags; /
b9e0: 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 * Flags passed t
b9f0: 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f o sqlite3_vfs.xO
ba00: 70 65 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 65 pen() */. int e
ba10: 72 72 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 rrCode;
ba20: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 74 /* Most
ba30: 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f recent error co
ba40: 64 65 20 28 53 51 4c 49 54 45 5f 2a 29 20 2a 2f de (SQLITE_*) */
ba50: 0a 20 20 69 6e 74 20 65 72 72 4d 61 73 6b 3b 20 . int errMask;
ba60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ba70: 20 2f 2a 20 26 20 72 65 73 75 6c 74 20 63 6f 64 /* & result cod
ba80: 65 73 20 77 69 74 68 20 74 68 69 73 20 62 65 66 es with this bef
ba90: 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 2a 2f ore returning */
baa0: 0a 20 20 69 6e 74 20 69 53 79 73 45 72 72 6e 6f . int iSysErrno
bab0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
bac0: 20 2f 2a 20 45 72 72 6e 6f 20 76 61 6c 75 65 20 /* Errno value
bad0: 66 72 6f 6d 20 6c 61 73 74 20 73 79 73 74 65 6d from last system
bae0: 20 65 72 72 6f 72 20 2a 2f 0a 20 20 75 31 36 20 error */. u16
baf0: 64 62 4f 70 74 46 6c 61 67 73 3b 20 20 20 20 20 dbOptFlags;
bb00: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6c 61 /* Fla
bb10: 67 73 20 74 6f 20 65 6e 61 62 6c 65 2f 64 69 73 gs to enable/dis
bb20: 61 62 6c 65 20 6f 70 74 69 6d 69 7a 61 74 69 6f able optimizatio
bb30: 6e 73 20 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 ns */. u8 enc;
bb40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bb50: 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 65 6e /* Text en
bb60: 63 6f 64 69 6e 67 20 2a 2f 0a 20 20 75 38 20 61 coding */. u8 a
bb70: 75 74 6f 43 6f 6d 6d 69 74 3b 20 20 20 20 20 20 utoCommit;
bb80: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
bb90: 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61 auto-commit fla
bba0: 67 2e 20 2a 2f 0a 20 20 75 38 20 62 43 6f 6e 63 g. */. u8 bConc
bbb0: 75 72 72 65 6e 74 3b 20 20 20 20 20 20 20 20 20 urrent;
bbc0: 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 /* Current
bbd0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 transaction is
bbe0: 22 43 4f 4e 43 55 52 52 45 4e 54 22 20 2a 2f 0a "CONCURRENT" */.
bbf0: 20 20 75 38 20 74 65 6d 70 5f 73 74 6f 72 65 3b u8 temp_store;
bc00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bc10: 2f 2a 20 31 3a 20 66 69 6c 65 20 32 3a 20 6d 65 /* 1: file 2: me
bc20: 6d 6f 72 79 20 30 3a 20 64 65 66 61 75 6c 74 20 mory 0: default
bc30: 2a 2f 0a 20 20 75 38 20 6d 61 6c 6c 6f 63 46 61 */. u8 mallocFa
bc40: 69 6c 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 iled;
bc50: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 77 65 /* True if we
bc60: 20 68 61 76 65 20 73 65 65 6e 20 61 20 6d 61 6c have seen a mal
bc70: 6c 6f 63 20 66 61 69 6c 75 72 65 20 2a 2f 0a 20 loc failure */.
bc80: 20 75 38 20 62 42 65 6e 69 67 6e 4d 61 6c 6c 6f u8 bBenignMallo
bc90: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f c; /
bca0: 2a 20 44 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 * Do not require
bcb0: 20 4f 4f 4d 73 20 69 66 20 74 72 75 65 20 2a 2f OOMs if true */
bcc0: 0a 20 20 75 38 20 64 66 6c 74 4c 6f 63 6b 4d 6f . u8 dfltLockMo
bcd0: 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 de;
bce0: 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 63 6b /* Default lock
bcf0: 69 6e 67 2d 6d 6f 64 65 20 66 6f 72 20 61 74 74 ing-mode for att
bd00: 61 63 68 65 64 20 64 62 73 20 2a 2f 0a 20 20 73 ached dbs */. s
bd10: 69 67 6e 65 64 20 63 68 61 72 20 6e 65 78 74 41 igned char nextA
bd20: 75 74 6f 76 61 63 3b 20 20 20 20 20 20 2f 2a 20 utovac; /*
bd30: 41 75 74 6f 76 61 63 20 73 65 74 74 69 6e 67 20 Autovac setting
bd40: 61 66 74 65 72 20 56 41 43 55 55 4d 20 69 66 20 after VACUUM if
bd50: 3e 3d 30 20 2a 2f 0a 20 20 75 38 20 73 75 70 70 >=0 */. u8 supp
bd60: 72 65 73 73 45 72 72 3b 20 20 20 20 20 20 20 20 ressErr;
bd70: 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 /* Do not
bd80: 20 69 73 73 75 65 20 65 72 72 6f 72 20 6d 65 73 issue error mes
bd90: 73 61 67 65 73 20 69 66 20 74 72 75 65 20 2a 2f sages if true */
bda0: 0a 20 20 75 38 20 76 74 61 62 4f 6e 43 6f 6e 66 . u8 vtabOnConf
bdb0: 6c 69 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 lict;
bdc0: 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 /* Value to ret
bdd0: 75 72 6e 20 66 6f 72 20 73 33 5f 76 74 61 62 5f urn for s3_vtab_
bde0: 6f 6e 5f 63 6f 6e 66 6c 69 63 74 28 29 20 2a 2f on_conflict() */
bdf0: 0a 20 20 75 38 20 69 73 54 72 61 6e 73 61 63 74 . u8 isTransact
be00: 69 6f 6e 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 ionSavepoint;
be10: 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 20 /* True if the
be20: 6f 75 74 65 72 6d 6f 73 74 20 73 61 76 65 70 6f outermost savepo
be30: 69 6e 74 20 69 73 20 61 20 54 53 20 2a 2f 0a 20 int is a TS */.
be40: 20 75 38 20 6d 54 72 61 63 65 3b 20 20 20 20 20 u8 mTrace;
be50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
be60: 2a 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 53 * zero or more S
be70: 51 4c 49 54 45 5f 54 52 41 43 45 20 66 6c 61 67 QLITE_TRACE flag
be80: 73 20 2a 2f 0a 20 20 75 38 20 6e 6f 53 68 61 72 s */. u8 noShar
be90: 65 64 43 61 63 68 65 3b 20 20 20 20 20 20 20 20 edCache;
bea0: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
beb0: 6e 6f 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 no shared-cache
bec0: 62 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 75 38 backends */. u8
bed0: 20 6e 53 71 6c 45 78 65 63 3b 20 20 20 20 20 20 nSqlExec;
bee0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
bef0: 75 6d 62 65 72 20 6f 66 20 70 65 6e 64 69 6e 67 umber of pending
bf00: 20 4f 50 5f 53 71 6c 45 78 65 63 20 6f 70 63 6f OP_SqlExec opco
bf10: 64 65 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 78 des */. int nex
bf20: 74 50 61 67 65 73 69 7a 65 3b 20 20 20 20 20 20 tPagesize;
bf30: 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 73 69 /* Pagesi
bf40: 7a 65 20 61 66 74 65 72 20 56 41 43 55 55 4d 20 ze after VACUUM
bf50: 69 66 20 3e 30 20 2a 2f 0a 20 20 75 33 32 20 6d if >0 */. u32 m
bf60: 61 67 69 63 3b 20 20 20 20 20 20 20 20 20 20 20 agic;
bf70: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 67 69 /* Magi
bf80: 63 20 6e 75 6d 62 65 72 20 66 6f 72 20 64 65 74 c number for det
bf90: 65 63 74 20 6c 69 62 72 61 72 79 20 6d 69 73 75 ect library misu
bfa0: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 68 61 se */. int nCha
bfb0: 6e 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 nge;
bfc0: 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 72 /* Value r
bfd0: 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74 eturned by sqlit
bfe0: 65 33 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f 0a e3_changes() */.
bff0: 20 20 69 6e 74 20 6e 54 6f 74 61 6c 43 68 61 6e int nTotalChan
c000: 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
c010: 2f 2a 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 /* Value returne
c020: 64 20 62 79 20 73 71 6c 69 74 65 33 5f 74 6f 74 d by sqlite3_tot
c030: 61 6c 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f 0a al_changes() */.
c040: 20 20 69 6e 74 20 61 4c 69 6d 69 74 5b 53 51 4c int aLimit[SQL
c050: 49 54 45 5f 4e 5f 4c 49 4d 49 54 5d 3b 20 20 20 ITE_N_LIMIT];
c060: 2f 2a 20 4c 69 6d 69 74 73 20 2a 2f 0a 20 20 69 /* Limits */. i
c070: 6e 74 20 6e 4d 61 78 53 6f 72 74 65 72 4d 6d 61 nt nMaxSorterMma
c080: 70 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 p; /*
c090: 4d 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 Maximum size of
c0a0: 72 65 67 69 6f 6e 73 20 6d 61 70 70 65 64 20 62 regions mapped b
c0b0: 79 20 73 6f 72 74 65 72 20 2a 2f 0a 20 20 73 74 y sorter */. st
c0c0: 72 75 63 74 20 73 71 6c 69 74 65 33 49 6e 69 74 ruct sqlite3Init
c0d0: 49 6e 66 6f 20 7b 20 20 20 20 20 20 2f 2a 20 49 Info { /* I
c0e0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 nformation used
c0f0: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a during initializ
c100: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 ation */. int
c110: 20 6e 65 77 54 6e 75 6d 3b 20 20 20 20 20 20 20 newTnum;
c120: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 /* Root
c130: 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 62 65 page of table be
c140: 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 ing initialized
c150: 2a 2f 0a 20 20 20 20 75 38 20 69 44 62 3b 20 20 */. u8 iDb;
c160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c170: 20 20 20 2f 2a 20 57 68 69 63 68 20 64 62 20 66 /* Which db f
c180: 69 6c 65 20 69 73 20 62 65 69 6e 67 20 69 6e 69 ile is being ini
c190: 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 20 20 tialized */.
c1a0: 75 38 20 62 75 73 79 3b 20 20 20 20 20 20 20 20 u8 busy;
c1b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
c1c0: 52 55 45 20 69 66 20 63 75 72 72 65 6e 74 6c 79 RUE if currently
c1d0: 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 2a 2f initializing */
c1e0: 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 6f 72 . unsigned or
c1f0: 70 68 61 6e 54 72 69 67 67 65 72 20 3a 20 31 3b phanTrigger : 1;
c200: 20 2f 2a 20 4c 61 73 74 20 73 74 61 74 65 6d 65 /* Last stateme
c210: 6e 74 20 69 73 20 6f 72 70 68 61 6e 65 64 20 54 nt is orphaned T
c220: 45 4d 50 20 74 72 69 67 67 65 72 20 2a 2f 0a 20 EMP trigger */.
c230: 20 20 20 75 6e 73 69 67 6e 65 64 20 69 6d 70 6f unsigned impo
c240: 73 74 65 72 54 61 62 6c 65 20 3a 20 31 3b 20 2f sterTable : 1; /
c250: 2a 20 42 75 69 6c 64 69 6e 67 20 61 6e 20 69 6d * Building an im
c260: 70 6f 73 74 65 72 20 74 61 62 6c 65 20 2a 2f 0a poster table */.
c270: 20 20 20 20 75 6e 73 69 67 6e 65 64 20 72 65 6f unsigned reo
c280: 70 65 6e 4d 65 6d 64 62 20 3a 20 31 3b 20 20 20 penMemdb : 1;
c290: 2f 2a 20 41 54 54 41 43 48 20 69 73 20 72 65 61 /* ATTACH is rea
c2a0: 6c 6c 79 20 61 20 72 65 6f 70 65 6e 20 75 73 69 lly a reopen usi
c2b0: 6e 67 20 4d 65 6d 44 42 20 2a 2f 0a 20 20 7d 20 ng MemDB */. }
c2c0: 69 6e 69 74 3b 0a 20 20 69 6e 74 20 6e 56 64 62 init;. int nVdb
c2d0: 65 41 63 74 69 76 65 3b 20 20 20 20 20 20 20 20 eActive;
c2e0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
c2f0: 6f 66 20 56 44 42 45 73 20 63 75 72 72 65 6e 74 of VDBEs current
c300: 6c 79 20 72 75 6e 6e 69 6e 67 20 2a 2f 0a 20 20 ly running */.
c310: 69 6e 74 20 6e 56 64 62 65 52 65 61 64 3b 20 20 int nVdbeRead;
c320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c330: 20 4e 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 Number of activ
c340: 65 20 56 44 42 45 73 20 74 68 61 74 20 72 65 61 e VDBEs that rea
c350: 64 20 6f 72 20 77 72 69 74 65 20 2a 2f 0a 20 20 d or write */.
c360: 69 6e 74 20 6e 56 64 62 65 57 72 69 74 65 3b 20 int nVdbeWrite;
c370: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c380: 20 4e 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 Number of activ
c390: 65 20 56 44 42 45 73 20 74 68 61 74 20 72 65 61 e VDBEs that rea
c3a0: 64 20 61 6e 64 20 77 72 69 74 65 20 2a 2f 0a 20 d and write */.
c3b0: 20 69 6e 74 20 6e 56 64 62 65 45 78 65 63 3b 20 int nVdbeExec;
c3c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
c3d0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 * Number of nest
c3e0: 65 64 20 63 61 6c 6c 73 20 74 6f 20 56 64 62 65 ed calls to Vdbe
c3f0: 45 78 65 63 28 29 20 2a 2f 0a 20 20 69 6e 74 20 Exec() */. int
c400: 6e 56 44 65 73 74 72 6f 79 3b 20 20 20 20 20 20 nVDestroy;
c410: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
c420: 62 65 72 20 6f 66 20 61 63 74 69 76 65 20 4f 50 ber of active OP
c430: 5f 56 44 65 73 74 72 6f 79 20 6f 70 65 72 61 74 _VDestroy operat
c440: 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 ions */. int nE
c450: 78 74 65 6e 73 69 6f 6e 3b 20 20 20 20 20 20 20 xtension;
c460: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
c470: 72 20 6f 66 20 6c 6f 61 64 65 64 20 65 78 74 65 r of loaded exte
c480: 6e 73 69 6f 6e 73 20 2a 2f 0a 20 20 76 6f 69 64 nsions */. void
c490: 20 2a 2a 61 45 78 74 65 6e 73 69 6f 6e 3b 20 20 **aExtension;
c4a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 /* Arr
c4b0: 61 79 20 6f 66 20 73 68 61 72 65 64 20 6c 69 62 ay of shared lib
c4c0: 72 61 72 79 20 68 61 6e 64 6c 65 73 20 2a 2f 0a rary handles */.
c4d0: 20 20 69 6e 74 20 28 2a 78 54 72 61 63 65 29 28 int (*xTrace)(
c4e0: 75 33 32 2c 76 6f 69 64 2a 2c 76 6f 69 64 2a 2c u32,void*,void*,
c4f0: 76 6f 69 64 2a 29 3b 20 20 20 20 20 2f 2a 20 54 void*); /* T
c500: 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f race function */
c510: 0a 20 20 76 6f 69 64 20 2a 70 54 72 61 63 65 41 . void *pTraceA
c520: 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rg;
c530: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
c540: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 Argument to the
c550: 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 2a trace function *
c560: 2f 0a 20 20 76 6f 69 64 20 28 2a 78 50 72 6f 66 /. void (*xProf
c570: 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 ile)(void*,const
c580: 20 63 68 61 72 2a 2c 75 36 34 29 3b 20 20 2f 2a char*,u64); /*
c590: 20 50 72 6f 66 69 6c 69 6e 67 20 66 75 6e 63 74 Profiling funct
c5a0: 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ion */. void *p
c5b0: 50 72 6f 66 69 6c 65 41 72 67 3b 20 20 20 20 20 ProfileArg;
c5c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c5d0: 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 /* Argument t
c5e0: 6f 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 o profile functi
c5f0: 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 43 on */. void *pC
c600: 6f 6d 6d 69 74 41 72 67 3b 20 20 20 20 20 20 20 ommitArg;
c610: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
c620: 75 6d 65 6e 74 20 74 6f 20 78 43 6f 6d 6d 69 74 ument to xCommit
c630: 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 0a 20 20 Callback() */.
c640: 69 6e 74 20 28 2a 78 43 6f 6d 6d 69 74 43 61 6c int (*xCommitCal
c650: 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 3b 20 20 lback)(void*);
c660: 20 20 2f 2a 20 49 6e 76 6f 6b 65 64 20 61 74 20 /* Invoked at
c670: 65 76 65 72 79 20 63 6f 6d 6d 69 74 2e 20 2a 2f every commit. */
c680: 0a 20 20 76 6f 69 64 20 2a 70 52 6f 6c 6c 62 61 . void *pRollba
c690: 63 6b 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 ckArg;
c6a0: 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 /* Argument
c6b0: 20 74 6f 20 78 52 6f 6c 6c 62 61 63 6b 43 61 6c to xRollbackCal
c6c0: 6c 62 61 63 6b 28 29 20 2a 2f 0a 20 20 76 6f 69 lback() */. voi
c6d0: 64 20 28 2a 78 52 6f 6c 6c 62 61 63 6b 43 61 6c d (*xRollbackCal
c6e0: 6c 62 61 63 6b 29 28 76 6f 69 64 2a 29 3b 20 2f lback)(void*); /
c6f0: 2a 20 49 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 * Invoked at eve
c700: 72 79 20 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 ry commit. */.
c710: 76 6f 69 64 20 2a 70 55 70 64 61 74 65 41 72 67 void *pUpdateArg
c720: 3b 0a 20 20 76 6f 69 64 20 28 2a 78 55 70 64 61 ;. void (*xUpda
c730: 74 65 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 teCallback)(void
c740: 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 *,int, const cha
c750: 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 r*,const char*,s
c760: 71 6c 69 74 65 5f 69 6e 74 36 34 29 3b 0a 23 69 qlite_int64);.#i
c770: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
c780: 4c 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f LE_PREUPDATE_HOO
c790: 4b 0a 20 20 76 6f 69 64 20 2a 70 50 72 65 55 70 K. void *pPreUp
c7a0: 64 61 74 65 41 72 67 3b 20 20 20 20 20 20 20 20 dateArg;
c7b0: 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d /* First argum
c7c0: 65 6e 74 20 74 6f 20 78 50 72 65 55 70 64 61 74 ent to xPreUpdat
c7d0: 65 43 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 eCallback */. v
c7e0: 6f 69 64 20 28 2a 78 50 72 65 55 70 64 61 74 65 oid (*xPreUpdate
c7f0: 43 61 6c 6c 62 61 63 6b 29 28 20 20 20 2f 2a 20 Callback)( /*
c800: 52 65 67 69 73 74 65 72 65 64 20 75 73 69 6e 67 Registered using
c810: 20 73 71 6c 69 74 65 33 5f 70 72 65 75 70 64 61 sqlite3_preupda
c820: 74 65 5f 68 6f 6f 6b 28 29 20 2a 2f 0a 20 20 20 te_hook() */.
c830: 20 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c void*,sqlite3*,
c840: 69 6e 74 2c 63 68 61 72 20 63 6f 6e 73 74 2a 2c int,char const*,
c850: 63 68 61 72 20 63 6f 6e 73 74 2a 2c 73 71 6c 69 char const*,sqli
c860: 74 65 33 5f 69 6e 74 36 34 2c 73 71 6c 69 74 65 te3_int64,sqlite
c870: 33 5f 69 6e 74 36 34 0a 20 20 29 3b 0a 20 20 50 3_int64. );. P
c880: 72 65 55 70 64 61 74 65 20 2a 70 50 72 65 55 70 reUpdate *pPreUp
c890: 64 61 74 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 date; /*
c8a0: 43 6f 6e 74 65 78 74 20 66 6f 72 20 61 63 74 69 Context for acti
c8b0: 76 65 20 70 72 65 2d 75 70 64 61 74 65 20 63 61 ve pre-update ca
c8c0: 6c 6c 62 61 63 6b 20 2a 2f 0a 23 65 6e 64 69 66 llback */.#endif
c8d0: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c /* SQLITE_ENABL
c8e0: 45 5f 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b E_PREUPDATE_HOOK
c8f0: 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */.#ifndef SQLI
c900: 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 69 6e TE_OMIT_WAL. in
c910: 74 20 28 2a 78 57 61 6c 43 61 6c 6c 62 61 63 6b t (*xWalCallback
c920: 29 28 76 6f 69 64 20 2a 2c 20 73 71 6c 69 74 65 )(void *, sqlite
c930: 33 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 3 *, const char
c940: 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 *, int);. void
c950: 2a 70 57 61 6c 41 72 67 3b 0a 23 65 6e 64 69 66 *pWalArg;.#endif
c960: 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 . void(*xCollNe
c970: 65 64 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 eded)(void*,sqli
c980: 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 te3*,int eTextRe
c990: 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a p,const char*);.
c9a0: 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 void(*xCollNee
c9b0: 64 65 64 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c ded16)(void*,sql
c9c0: 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 ite3*,int eTextR
c9d0: 65 70 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 3b ep,const void*);
c9e0: 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 . void *pCollNe
c9f0: 65 64 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 ededArg;. sqlit
ca00: 65 33 5f 76 61 6c 75 65 20 2a 70 45 72 72 3b 20 e3_value *pErr;
ca10: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 74 /* Most
ca20: 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 6d 65 recent error me
ca30: 73 73 61 67 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e ssage */. union
ca40: 20 7b 0a 20 20 20 20 76 6f 6c 61 74 69 6c 65 20 {. volatile
ca50: 69 6e 74 20 69 73 49 6e 74 65 72 72 75 70 74 65 int isInterrupte
ca60: 64 3b 20 2f 2a 20 54 72 75 65 20 69 66 20 73 71 d; /* True if sq
ca70: 6c 69 74 65 33 5f 69 6e 74 65 72 72 75 70 74 20 lite3_interrupt
ca80: 68 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 has been called
ca90: 2a 2f 0a 20 20 20 20 64 6f 75 62 6c 65 20 6e 6f */. double no
caa0: 74 55 73 65 64 31 3b 20 20 20 20 20 20 20 20 20 tUsed1;
cab0: 20 20 20 2f 2a 20 53 70 61 63 65 72 20 2a 2f 0a /* Spacer */.
cac0: 20 20 7d 20 75 31 3b 0a 20 20 4c 6f 6f 6b 61 73 } u1;. Lookas
cad0: 69 64 65 20 6c 6f 6f 6b 61 73 69 64 65 3b 20 20 ide lookaside;
cae0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 6b 61 /* Looka
caf0: 73 69 64 65 20 6d 61 6c 6c 6f 63 20 63 6f 6e 66 side malloc conf
cb00: 69 67 75 72 61 74 69 6f 6e 20 2a 2f 0a 23 69 66 iguration */.#if
cb10: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
cb20: 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 _AUTHORIZATION.
cb30: 20 73 71 6c 69 74 65 33 5f 78 61 75 74 68 20 78 sqlite3_xauth x
cb40: 41 75 74 68 3b 20 20 20 20 20 20 20 20 20 20 2f Auth; /
cb50: 2a 20 41 63 63 65 73 73 20 61 75 74 68 6f 72 69 * Access authori
cb60: 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 zation function
cb70: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 75 74 68 */. void *pAuth
cb80: 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 Arg;
cb90: 20 20 20 2f 2a 20 31 73 74 20 61 72 67 75 6d 65 /* 1st argume
cba0: 6e 74 20 74 6f 20 74 68 65 20 61 63 63 65 73 73 nt to the access
cbb0: 20 61 75 74 68 20 66 75 6e 63 74 69 6f 6e 20 2a auth function *
cbc0: 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 /.#endif.#ifndef
cbd0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f SQLITE_OMIT_PRO
cbe0: 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 20 GRESS_CALLBACK.
cbf0: 20 69 6e 74 20 28 2a 78 50 72 6f 67 72 65 73 73 int (*xProgress
cc00: 29 28 76 6f 69 64 20 2a 29 3b 20 20 20 20 20 2f )(void *); /
cc10: 2a 20 54 68 65 20 70 72 6f 67 72 65 73 73 20 63 * The progress c
cc20: 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 allback */. voi
cc30: 64 20 2a 70 50 72 6f 67 72 65 73 73 41 72 67 3b d *pProgressArg;
cc40: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
cc50: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 70 72 gument to the pr
cc60: 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 ogress callback
cc70: 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 6e 50 */. unsigned nP
cc80: 72 6f 67 72 65 73 73 4f 70 73 3b 20 20 20 20 20 rogressOps;
cc90: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
cca0: 6f 70 63 6f 64 65 73 20 66 6f 72 20 70 72 6f 67 opcodes for prog
ccb0: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f ress callback */
ccc0: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
ccd0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
cce0: 55 41 4c 54 41 42 4c 45 0a 20 20 69 6e 74 20 6e UALTABLE. int n
ccf0: 56 54 72 61 6e 73 3b 20 20 20 20 20 20 20 20 20 VTrans;
cd00: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 6f /* Allo
cd10: 63 61 74 65 64 20 73 69 7a 65 20 6f 66 20 61 56 cated size of aV
cd20: 54 72 61 6e 73 20 2a 2f 0a 20 20 48 61 73 68 20 Trans */. Hash
cd30: 61 4d 6f 64 75 6c 65 3b 20 20 20 20 20 20 20 20 aModule;
cd40: 20 20 20 20 20 20 20 20 20 2f 2a 20 70 6f 70 75 /* popu
cd50: 6c 61 74 65 64 20 62 79 20 73 71 6c 69 74 65 33 lated by sqlite3
cd60: 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 _create_module()
cd70: 20 2a 2f 0a 20 20 56 74 61 62 43 74 78 20 2a 70 */. VtabCtx *p
cd80: 56 74 61 62 43 74 78 3b 20 20 20 20 20 20 20 20 VtabCtx;
cd90: 20 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74 20 66 /* Context f
cda0: 6f 72 20 61 63 74 69 76 65 20 76 74 61 62 20 63 or active vtab c
cdb0: 6f 6e 6e 65 63 74 2f 63 72 65 61 74 65 20 2a 2f onnect/create */
cdc0: 0a 20 20 56 54 61 62 6c 65 20 2a 2a 61 56 54 72 . VTable **aVTr
cdd0: 61 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ans;
cde0: 20 2f 2a 20 56 69 72 74 75 61 6c 20 74 61 62 6c /* Virtual tabl
cdf0: 65 73 20 77 69 74 68 20 6f 70 65 6e 20 74 72 61 es with open tra
ce00: 6e 73 61 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 56 nsactions */. V
ce10: 54 61 62 6c 65 20 2a 70 44 69 73 63 6f 6e 6e 65 Table *pDisconne
ce20: 63 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ct; /*
ce30: 44 69 73 63 6f 6e 6e 65 63 74 20 74 68 65 73 65 Disconnect these
ce40: 20 69 6e 20 6e 65 78 74 20 73 71 6c 69 74 65 33 in next sqlite3
ce50: 5f 70 72 65 70 61 72 65 28 29 20 2a 2f 0a 23 65 _prepare() */.#e
ce60: 6e 64 69 66 0a 20 20 48 61 73 68 20 61 46 75 6e ndif. Hash aFun
ce70: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
ce80: 20 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 /* Hash tab
ce90: 6c 65 20 6f 66 20 63 6f 6e 6e 65 63 74 69 6f 6e le of connection
cea0: 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 functions */.
ceb0: 48 61 73 68 20 61 43 6f 6c 6c 53 65 71 3b 20 20 Hash aCollSeq;
cec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
ced0: 20 41 6c 6c 20 63 6f 6c 6c 61 74 69 6e 67 20 73 All collating s
cee0: 65 71 75 65 6e 63 65 73 20 2a 2f 0a 20 20 42 75 equences */. Bu
cef0: 73 79 48 61 6e 64 6c 65 72 20 62 75 73 79 48 61 syHandler busyHa
cf00: 6e 64 6c 65 72 3b 20 20 20 20 20 20 2f 2a 20 42 ndler; /* B
cf10: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a usy callback */.
cf20: 20 20 44 62 20 61 44 62 53 74 61 74 69 63 5b 32 Db aDbStatic[2
cf30: 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ];
cf40: 2f 2a 20 53 74 61 74 69 63 20 73 70 61 63 65 20 /* Static space
cf50: 66 6f 72 20 74 68 65 20 32 20 64 65 66 61 75 6c for the 2 defaul
cf60: 74 20 62 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 t backends */.
cf70: 53 61 76 65 70 6f 69 6e 74 20 2a 70 53 61 76 65 Savepoint *pSave
cf80: 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 20 2f 2a point; /*
cf90: 20 4c 69 73 74 20 6f 66 20 61 63 74 69 76 65 20 List of active
cfa0: 73 61 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 savepoints */.
cfb0: 69 6e 74 20 62 75 73 79 54 69 6d 65 6f 75 74 3b int busyTimeout;
cfc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
cfd0: 20 42 75 73 79 20 68 61 6e 64 6c 65 72 20 74 69 Busy handler ti
cfe0: 6d 65 6f 75 74 2c 20 69 6e 20 6d 73 65 63 20 2a meout, in msec *
cff0: 2f 0a 20 20 69 6e 74 20 6e 53 61 76 65 70 6f 69 /. int nSavepoi
d000: 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nt;
d010: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e /* Number of n
d020: 6f 6e 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 on-transaction s
d030: 61 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 avepoints */. i
d040: 6e 74 20 6e 53 74 61 74 65 6d 65 6e 74 3b 20 20 nt nStatement;
d050: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
d060: 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 Number of nested
d070: 20 73 74 61 74 65 6d 65 6e 74 2d 74 72 61 6e 73 statement-trans
d080: 61 63 74 69 6f 6e 73 20 20 2a 2f 0a 20 20 69 36 actions */. i6
d090: 34 20 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 4 nDeferredCons;
d0a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
d0b0: 65 74 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 et deferred cons
d0c0: 74 72 61 69 6e 74 73 20 74 68 69 73 20 74 72 61 traints this tra
d0d0: 6e 73 61 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 69 nsaction. */. i
d0e0: 36 34 20 6e 44 65 66 65 72 72 65 64 49 6d 6d 43 64 nDeferredImmC
d0f0: 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ons; /*
d100: 4e 65 74 20 64 65 66 65 72 72 65 64 20 69 6d 6d Net deferred imm
d110: 65 64 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e ediate constrain
d120: 74 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 42 ts */. int *pnB
d130: 79 74 65 73 46 72 65 65 64 3b 20 20 20 20 20 20 ytesFreed;
d140: 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f 74 20 /* If not
d150: 4e 55 4c 4c 2c 20 69 6e 63 72 65 6d 65 6e 74 20 NULL, increment
d160: 74 68 69 73 20 69 6e 20 44 62 46 72 65 65 28 29 this in DbFree()
d170: 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
d180: 45 5f 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f E_ENABLE_UNLOCK_
d190: 4e 4f 54 49 46 59 0a 20 20 2f 2a 20 54 68 65 20 NOTIFY. /* The
d1a0: 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 62 following variab
d1b0: 6c 65 73 20 61 72 65 20 61 6c 6c 20 70 72 6f 74 les are all prot
d1c0: 65 63 74 65 64 20 62 79 20 74 68 65 20 53 54 41 ected by the STA
d1d0: 54 49 43 5f 4d 41 53 54 45 52 0a 20 20 2a 2a 20 TIC_MASTER. **
d1e0: 6d 75 74 65 78 2c 20 6e 6f 74 20 62 79 20 73 71 mutex, not by sq
d1f0: 6c 69 74 65 33 2e 6d 75 74 65 78 2e 20 54 68 65 lite3.mutex. The
d200: 79 20 61 72 65 20 75 73 65 64 20 62 79 20 63 6f y are used by co
d210: 64 65 20 69 6e 20 6e 6f 74 69 66 79 2e 63 2e 0a de in notify.c..
d220: 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 **. ** When X
d230: 2e 70 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 .pUnlockConnecti
d240: 6f 6e 3d 3d 59 2c 20 74 68 61 74 20 6d 65 61 6e on==Y, that mean
d250: 73 20 74 68 61 74 20 58 20 69 73 20 77 61 69 74 s that X is wait
d260: 69 6e 67 20 66 6f 72 20 59 20 74 6f 0a 20 20 2a ing for Y to. *
d270: 2a 20 75 6e 6c 6f 63 6b 20 73 6f 20 74 68 61 74 * unlock so that
d280: 20 69 74 20 63 61 6e 20 70 72 6f 63 65 65 64 2e it can proceed.
d290: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 . **. ** When
d2a0: 58 2e 70 42 6c 6f 63 6b 69 6e 67 43 6f 6e 6e 65 X.pBlockingConne
d2b0: 63 74 69 6f 6e 3d 3d 59 2c 20 74 68 61 74 20 6d ction==Y, that m
d2c0: 65 61 6e 73 20 74 68 61 74 20 73 6f 6d 65 74 68 eans that someth
d2d0: 69 6e 67 20 74 68 61 74 20 58 20 74 72 69 65 64 ing that X tried
d2e0: 0a 20 20 2a 2a 20 74 72 69 65 64 20 74 6f 20 64 . ** tried to d
d2f0: 6f 20 72 65 63 65 6e 74 6c 79 20 66 61 69 6c 65 o recently faile
d300: 64 20 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 d with an SQLITE
d310: 5f 4c 4f 43 4b 45 44 20 65 72 72 6f 72 20 64 75 _LOCKED error du
d320: 65 20 74 6f 20 6c 6f 63 6b 73 0a 20 20 2a 2a 20 e to locks. **
d330: 68 65 6c 64 20 62 79 20 59 2e 0a 20 20 2a 2f 0a held by Y.. */.
d340: 20 20 73 71 6c 69 74 65 33 20 2a 70 42 6c 6f 63 sqlite3 *pBloc
d350: 6b 69 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3b 20 kingConnection;
d360: 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 68 /* Connection th
d370: 61 74 20 63 61 75 73 65 64 20 53 51 4c 49 54 45 at caused SQLITE
d380: 5f 4c 4f 43 4b 45 44 20 2a 2f 0a 20 20 73 71 6c _LOCKED */. sql
d390: 69 74 65 33 20 2a 70 55 6e 6c 6f 63 6b 43 6f 6e ite3 *pUnlockCon
d3a0: 6e 65 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 nection;
d3b0: 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e /* Connection
d3c0: 20 74 6f 20 77 61 74 63 68 20 66 6f 72 20 75 6e to watch for un
d3d0: 6c 6f 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a lock */. void *
d3e0: 70 55 6e 6c 6f 63 6b 41 72 67 3b 20 20 20 20 20 pUnlockArg;
d3f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d400: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 /* Argument to x
d410: 55 6e 6c 6f 63 6b 4e 6f 74 69 66 79 20 2a 2f 0a UnlockNotify */.
d420: 20 20 76 6f 69 64 20 28 2a 78 55 6e 6c 6f 63 6b void (*xUnlock
d430: 4e 6f 74 69 66 79 29 28 76 6f 69 64 20 2a 2a 2c Notify)(void **,
d440: 20 69 6e 74 29 3b 20 20 2f 2a 20 55 6e 6c 6f 63 int); /* Unloc
d450: 6b 20 6e 6f 74 69 66 79 20 63 61 6c 6c 62 61 63 k notify callbac
d460: 6b 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a k */. sqlite3 *
d470: 70 4e 65 78 74 42 6c 6f 63 6b 65 64 3b 20 20 20 pNextBlocked;
d480: 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 /* Next in
d490: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 62 6c 6f 63 list of all bloc
d4a0: 6b 65 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 ked connections
d4b0: 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 */.#endif.#ifdef
d4c0: 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 SQLITE_USER_AUT
d4d0: 48 45 4e 54 49 43 41 54 49 4f 4e 0a 20 20 73 71 HENTICATION. sq
d4e0: 6c 69 74 65 33 5f 75 73 65 72 61 75 74 68 20 61 lite3_userauth a
d4f0: 75 74 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 55 uth; /* U
d500: 73 65 72 20 61 75 74 68 65 6e 74 69 63 61 74 69 ser authenticati
d510: 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a on information *
d520: 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a /.#endif.};../*.
d530: 2a 2a 20 41 20 6d 61 63 72 6f 20 74 6f 20 64 69 ** A macro to di
d540: 73 63 6f 76 65 72 20 74 68 65 20 65 6e 63 6f 64 scover the encod
d550: 69 6e 67 20 6f 66 20 61 20 64 61 74 61 62 61 73 ing of a databas
d560: 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 43 e..*/.#define SC
d570: 48 45 4d 41 5f 45 4e 43 28 64 62 29 20 28 28 64 HEMA_ENC(db) ((d
d580: 62 29 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 b)->aDb[0].pSche
d590: 6d 61 2d 3e 65 6e 63 29 0a 23 64 65 66 69 6e 65 ma->enc).#define
d5a0: 20 45 4e 43 28 64 62 29 20 20 20 20 20 20 20 20 ENC(db)
d5b0: 28 28 64 62 29 2d 3e 65 6e 63 29 0a 0a 2f 2a 0a ((db)->enc)../*.
d5c0: 2a 2a 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 ** Possible valu
d5d0: 65 73 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 es for the sqlit
d5e0: 65 33 2e 66 6c 61 67 73 2e 0a 2a 2a 0a 2a 2a 20 e3.flags..**.**
d5f0: 56 61 6c 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 Value constraint
d600: 73 20 28 65 6e 66 6f 72 63 65 64 20 76 69 61 20 s (enforced via
d610: 61 73 73 65 72 74 28 29 29 3a 0a 2a 2a 20 20 20 assert()):.**
d620: 20 20 20 53 51 4c 49 54 45 5f 46 75 6c 6c 46 53 SQLITE_FullFS
d630: 79 6e 63 20 20 20 20 20 3d 3d 20 50 41 47 45 52 ync == PAGER
d640: 5f 46 55 4c 4c 46 53 59 4e 43 0a 2a 2a 20 20 20 _FULLFSYNC.**
d650: 20 20 20 53 51 4c 49 54 45 5f 43 6b 70 74 46 75 SQLITE_CkptFu
d660: 6c 6c 46 53 79 6e 63 20 3d 3d 20 50 41 47 45 52 llFSync == PAGER
d670: 5f 43 4b 50 54 5f 46 55 4c 4c 46 53 59 4e 43 0a _CKPT_FULLFSYNC.
d680: 2a 2a 20 20 20 20 20 20 53 51 4c 49 54 45 5f 43 ** SQLITE_C
d690: 61 63 68 65 53 70 69 6c 6c 20 20 20 20 3d 3d 20 acheSpill ==
d6a0: 50 41 47 45 52 5f 43 41 43 48 45 5f 53 50 49 4c PAGER_CACHE_SPIL
d6b0: 4c 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c L.*/.#define SQL
d6c0: 49 54 45 5f 57 72 69 74 65 53 63 68 65 6d 61 20 ITE_WriteSchema
d6d0: 20 20 20 30 78 30 30 30 30 30 30 30 31 20 20 2f 0x00000001 /
d6e0: 2a 20 4f 4b 20 74 6f 20 75 70 64 61 74 65 20 53 * OK to update S
d6f0: 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 2a 2f 0a QLITE_MASTER */.
d700: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c #define SQLITE_L
d710: 65 67 61 63 79 46 69 6c 65 46 6d 74 20 20 30 78 egacyFileFmt 0x
d720: 30 30 30 30 30 30 30 32 20 20 2f 2a 20 43 72 65 00000002 /* Cre
d730: 61 74 65 20 6e 65 77 20 64 61 74 61 62 61 73 65 ate new database
d740: 73 20 69 6e 20 66 6f 72 6d 61 74 20 31 20 2a 2f s in format 1 */
d750: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
d760: 46 75 6c 6c 43 6f 6c 4e 61 6d 65 73 20 20 20 30 FullColNames 0
d770: 78 30 30 30 30 30 30 30 34 20 20 2f 2a 20 53 68 x00000004 /* Sh
d780: 6f 77 20 66 75 6c 6c 20 63 6f 6c 75 6d 6e 20 6e ow full column n
d790: 61 6d 65 73 20 6f 6e 20 53 45 4c 45 43 54 20 2a ames on SELECT *
d7a0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
d7b0: 5f 46 75 6c 6c 46 53 79 6e 63 20 20 20 20 20 20 _FullFSync
d7c0: 30 78 30 30 30 30 30 30 30 38 20 20 2f 2a 20 55 0x00000008 /* U
d7d0: 73 65 20 66 75 6c 6c 20 66 73 79 6e 63 20 6f 6e se full fsync on
d7e0: 20 74 68 65 20 62 61 63 6b 65 6e 64 20 2a 2f 0a the backend */.
d7f0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 #define SQLITE_C
d800: 6b 70 74 46 75 6c 6c 46 53 79 6e 63 20 20 30 78 kptFullFSync 0x
d810: 30 30 30 30 30 30 31 30 20 20 2f 2a 20 55 73 65 00000010 /* Use
d820: 20 66 75 6c 6c 20 66 73 79 6e 63 20 66 6f 72 20 full fsync for
d830: 63 68 65 63 6b 70 6f 69 6e 74 20 2a 2f 0a 23 64 checkpoint */.#d
d840: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 61 63 efine SQLITE_Cac
d850: 68 65 53 70 69 6c 6c 20 20 20 20 20 30 78 30 30 heSpill 0x00
d860: 30 30 30 30 32 30 20 20 2f 2a 20 4f 4b 20 74 6f 000020 /* OK to
d870: 20 73 70 69 6c 6c 20 70 61 67 65 72 20 63 61 63 spill pager cac
d880: 68 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 he */.#define SQ
d890: 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d LITE_ShortColNam
d8a0: 65 73 20 20 30 78 30 30 30 30 30 30 34 30 20 20 es 0x00000040
d8b0: 2f 2a 20 53 68 6f 77 20 73 68 6f 72 74 20 63 6f /* Show short co
d8c0: 6c 75 6d 6e 73 20 6e 61 6d 65 73 20 2a 2f 0a 23 lumns names */.#
d8d0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6f define SQLITE_Co
d8e0: 75 6e 74 52 6f 77 73 20 20 20 20 20 20 30 78 30 untRows 0x0
d8f0: 30 30 30 30 30 38 30 20 20 2f 2a 20 43 6f 75 6e 0000080 /* Coun
d900: 74 20 72 6f 77 73 20 63 68 61 6e 67 65 64 20 62 t rows changed b
d910: 79 20 49 4e 53 45 52 54 2c 20 2a 2f 0a 20 20 20 y INSERT, */.
d920: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d940: 20 20 20 20 20 20 20 2f 2a 20 20 20 44 45 4c 45 /* DELE
d950: 54 45 2c 20 6f 72 20 55 50 44 41 54 45 20 61 6e TE, or UPDATE an
d960: 64 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 20 20 d return */.
d970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d980: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d990: 20 20 20 20 20 20 2f 2a 20 20 20 74 68 65 20 63 /* the c
d9a0: 6f 75 6e 74 20 75 73 69 6e 67 20 61 20 63 61 6c ount using a cal
d9b0: 6c 62 61 63 6b 2e 20 2a 2f 0a 23 64 65 66 69 6e lback. */.#defin
d9c0: 65 20 53 51 4c 49 54 45 5f 4e 75 6c 6c 43 61 6c e SQLITE_NullCal
d9d0: 6c 62 61 63 6b 20 20 20 30 78 30 30 30 30 30 31 lback 0x000001
d9e0: 30 30 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 00 /* Invoke th
d9f0: 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20 e callback once
da00: 69 66 20 74 68 65 20 2a 2f 0a 20 20 20 20 20 20 if the */.
da10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
da20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
da30: 20 20 20 20 2f 2a 20 20 20 72 65 73 75 6c 74 20 /* result
da40: 73 65 74 20 69 73 20 65 6d 70 74 79 20 2a 2f 0a set is empty */.
da50: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 #define SQLITE_I
da60: 67 6e 6f 72 65 43 68 65 63 6b 73 20 20 20 30 78 gnoreChecks 0x
da70: 30 30 30 30 30 32 30 30 20 20 2f 2a 20 44 6f 20 00000200 /* Do
da80: 6e 6f 74 20 65 6e 66 6f 72 63 65 20 63 68 65 63 not enforce chec
da90: 6b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f k constraints */
daa0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
dab0: 52 65 61 64 55 6e 63 6f 6d 6d 69 74 20 20 20 30 ReadUncommit 0
dac0: 78 30 30 30 30 30 34 30 30 20 20 2f 2a 20 52 45 x00000400 /* RE
dad0: 41 44 20 55 4e 43 4f 4d 4d 49 54 54 45 44 20 69 AD UNCOMMITTED i
dae0: 6e 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 2a n shared-cache *
daf0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
db00: 5f 4e 6f 43 6b 70 74 4f 6e 43 6c 6f 73 65 20 20 _NoCkptOnClose
db10: 30 78 30 30 30 30 30 38 30 30 20 20 2f 2a 20 4e 0x00000800 /* N
db20: 6f 20 63 68 65 63 6b 70 6f 69 6e 74 20 6f 6e 20 o checkpoint on
db30: 63 6c 6f 73 65 28 29 2f 44 45 54 41 43 48 20 2a close()/DETACH *
db40: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
db50: 5f 52 65 76 65 72 73 65 4f 72 64 65 72 20 20 20 _ReverseOrder
db60: 30 78 30 30 30 30 31 30 30 30 20 20 2f 2a 20 52 0x00001000 /* R
db70: 65 76 65 72 73 65 20 75 6e 6f 72 64 65 72 65 64 everse unordered
db80: 20 53 45 4c 45 43 54 73 20 2a 2f 0a 23 64 65 66 SELECTs */.#def
db90: 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 63 54 72 ine SQLITE_RecTr
dba0: 69 67 67 65 72 73 20 20 20 20 30 78 30 30 30 30 iggers 0x0000
dbb0: 32 30 30 30 20 20 2f 2a 20 45 6e 61 62 6c 65 20 2000 /* Enable
dbc0: 72 65 63 75 72 73 69 76 65 20 74 72 69 67 67 65 recursive trigge
dbd0: 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 rs */.#define SQ
dbe0: 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 LITE_ForeignKeys
dbf0: 20 20 20 20 30 78 30 30 30 30 34 30 30 30 20 20 0x00004000
dc00: 2f 2a 20 45 6e 66 6f 72 63 65 20 66 6f 72 65 69 /* Enforce forei
dc10: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e gn key constrain
dc20: 74 73 20 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ts */.#define S
dc30: 51 4c 49 54 45 5f 41 75 74 6f 49 6e 64 65 78 20 QLITE_AutoIndex
dc40: 20 20 20 20 20 30 78 30 30 30 30 38 30 30 30 20 0x00008000
dc50: 20 2f 2a 20 45 6e 61 62 6c 65 20 61 75 74 6f 6d /* Enable autom
dc60: 61 74 69 63 20 69 6e 64 65 78 65 73 20 2a 2f 0a atic indexes */.
dc70: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c #define SQLITE_L
dc80: 6f 61 64 45 78 74 65 6e 73 69 6f 6e 20 20 30 78 oadExtension 0x
dc90: 30 30 30 31 30 30 30 30 20 20 2f 2a 20 45 6e 61 00010000 /* Ena
dca0: 62 6c 65 20 6c 6f 61 64 5f 65 78 74 65 6e 73 69 ble load_extensi
dcb0: 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 on */.#define SQ
dcc0: 4c 49 54 45 5f 4c 6f 61 64 45 78 74 46 75 6e 63 LITE_LoadExtFunc
dcd0: 20 20 20 20 30 78 30 30 30 32 30 30 30 30 20 20 0x00020000
dce0: 2f 2a 20 45 6e 61 62 6c 65 20 6c 6f 61 64 5f 65 /* Enable load_e
dcf0: 78 74 65 6e 73 69 6f 6e 28 29 20 53 51 4c 20 66 xtension() SQL f
dd00: 75 6e 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 unc */.#define S
dd10: 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 72 69 67 QLITE_EnableTrig
dd20: 67 65 72 20 20 30 78 30 30 30 34 30 30 30 30 20 ger 0x00040000
dd30: 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 62 /* True to enab
dd40: 6c 65 20 74 72 69 67 67 65 72 73 20 2a 2f 0a 23 le triggers */.#
dd50: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 65 define SQLITE_De
dd60: 66 65 72 46 4b 73 20 20 20 20 20 20 20 30 78 30 ferFKs 0x0
dd70: 30 30 38 30 30 30 30 20 20 2f 2a 20 44 65 66 65 0080000 /* Defe
dd80: 72 20 61 6c 6c 20 46 4b 20 63 6f 6e 73 74 72 61 r all FK constra
dd90: 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ints */.#define
dda0: 53 51 4c 49 54 45 5f 51 75 65 72 79 4f 6e 6c 79 SQLITE_QueryOnly
ddb0: 20 20 20 20 20 20 30 78 30 30 31 30 30 30 30 30 0x00100000
ddc0: 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 64 61 74 /* Disable dat
ddd0: 61 62 61 73 65 20 63 68 61 6e 67 65 73 20 2a 2f abase changes */
dde0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
ddf0: 43 65 6c 6c 53 69 7a 65 43 6b 20 20 20 20 20 30 CellSizeCk 0
de00: 78 30 30 32 30 30 30 30 30 20 20 2f 2a 20 43 68 x00200000 /* Ch
de10: 65 63 6b 20 62 74 72 65 65 20 63 65 6c 6c 20 73 eck btree cell s
de20: 69 7a 65 73 20 6f 6e 20 6c 6f 61 64 20 2a 2f 0a izes on load */.
de30: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
de40: 74 73 33 54 6f 6b 65 6e 69 7a 65 72 20 20 30 78 ts3Tokenizer 0x
de50: 30 30 34 30 30 30 30 30 20 20 2f 2a 20 45 6e 61 00400000 /* Ena
de60: 62 6c 65 20 66 74 73 33 5f 74 6f 6b 65 6e 69 7a ble fts3_tokeniz
de70: 65 72 28 32 29 20 2a 2f 0a 23 64 65 66 69 6e 65 er(2) */.#define
de80: 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 51 50 SQLITE_EnableQP
de90: 53 47 20 20 20 20 20 30 78 30 30 38 30 30 30 30 SG 0x0080000
dea0: 30 20 20 2f 2a 20 51 75 65 72 79 20 50 6c 61 6e 0 /* Query Plan
deb0: 6e 65 72 20 53 74 61 62 69 6c 69 74 79 20 47 75 ner Stability Gu
dec0: 61 72 61 6e 74 65 65 2a 2f 0a 23 64 65 66 69 6e arantee*/.#defin
ded0: 65 20 53 51 4c 49 54 45 5f 54 72 69 67 67 65 72 e SQLITE_Trigger
dee0: 45 51 50 20 20 20 20 20 30 78 30 31 30 30 30 30 EQP 0x010000
def0: 30 30 20 20 2f 2a 20 53 68 6f 77 20 74 72 69 67 00 /* Show trig
df00: 67 65 72 20 45 58 50 4c 41 49 4e 20 51 55 45 52 ger EXPLAIN QUER
df10: 59 20 50 4c 41 4e 20 2a 2f 0a 23 64 65 66 69 6e Y PLAN */.#defin
df20: 65 20 53 51 4c 49 54 45 5f 52 65 73 65 74 44 61 e SQLITE_ResetDa
df30: 74 61 62 61 73 65 20 20 30 78 30 32 30 30 30 30 tabase 0x020000
df40: 30 30 20 20 2f 2a 20 52 65 73 65 74 20 74 68 65 00 /* Reset the
df50: 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 0a 2f 2a database */../*
df60: 20 46 6c 61 67 73 20 75 73 65 64 20 6f 6e 6c 79 Flags used only
df70: 20 69 66 20 64 65 62 75 67 67 69 6e 67 20 2a 2f if debugging */
df80: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
df90: 45 42 55 47 0a 23 64 65 66 69 6e 65 20 53 51 4c EBUG.#define SQL
dfa0: 49 54 45 5f 53 71 6c 54 72 61 63 65 20 20 20 20 ITE_SqlTrace
dfb0: 20 20 20 30 78 30 38 30 30 30 30 30 30 20 20 2f 0x08000000 /
dfc0: 2a 20 44 65 62 75 67 20 70 72 69 6e 74 20 53 51 * Debug print SQ
dfd0: 4c 20 61 73 20 69 74 20 65 78 65 63 75 74 65 73 L as it executes
dfe0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
dff0: 54 45 5f 56 64 62 65 4c 69 73 74 69 6e 67 20 20 TE_VdbeListing
e000: 20 20 30 78 31 30 30 30 30 30 30 30 20 20 2f 2a 0x10000000 /*
e010: 20 44 65 62 75 67 20 6c 69 73 74 69 6e 67 73 20 Debug listings
e020: 6f 66 20 56 44 42 45 20 70 72 6f 67 72 61 6d 73 of VDBE programs
e030: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e040: 54 45 5f 56 64 62 65 54 72 61 63 65 20 20 20 20 TE_VdbeTrace
e050: 20 20 30 78 32 30 30 30 30 30 30 30 20 20 2f 2a 0x20000000 /*
e060: 20 54 72 75 65 20 74 6f 20 74 72 61 63 65 20 56 True to trace V
e070: 44 42 45 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f DBE execution */
e080: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e090: 56 64 62 65 41 64 64 6f 70 54 72 61 63 65 20 30 VdbeAddopTrace 0
e0a0: 78 34 30 30 30 30 30 30 30 20 20 2f 2a 20 54 72 x40000000 /* Tr
e0b0: 61 63 65 20 73 71 6c 69 74 65 33 56 64 62 65 41 ace sqlite3VdbeA
e0c0: 64 64 4f 70 28 29 20 63 61 6c 6c 73 20 2a 2f 0a ddOp() calls */.
e0d0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 #define SQLITE_V
e0e0: 64 62 65 45 51 50 20 20 20 20 20 20 20 20 30 78 dbeEQP 0x
e0f0: 38 30 30 30 30 30 30 30 20 20 2f 2a 20 44 65 62 80000000 /* Deb
e100: 75 67 20 45 58 50 4c 41 49 4e 20 51 55 45 52 59 ug EXPLAIN QUERY
e110: 20 50 4c 41 4e 20 2a 2f 0a 23 65 6e 64 69 66 0a PLAN */.#endif.
e120: 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 ./*.** Allowed v
e130: 61 6c 75 65 73 20 66 6f 72 20 73 71 6c 69 74 65 alues for sqlite
e140: 33 2e 6d 44 62 46 6c 61 67 73 0a 2a 2f 0a 23 64 3.mDbFlags.*/.#d
e150: 65 66 69 6e 65 20 44 42 46 4c 41 47 5f 53 63 68 efine DBFLAG_Sch
e160: 65 6d 61 43 68 61 6e 67 65 20 20 20 30 78 30 30 emaChange 0x00
e170: 30 31 20 20 2f 2a 20 55 6e 63 6f 6d 6d 69 74 74 01 /* Uncommitt
e180: 65 64 20 48 61 73 68 20 74 61 62 6c 65 20 63 68 ed Hash table ch
e190: 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 anges */.#define
e1a0: 20 44 42 46 4c 41 47 5f 50 72 65 66 65 72 42 75 DBFLAG_PreferBu
e1b0: 69 6c 74 69 6e 20 20 30 78 30 30 30 32 20 20 2f iltin 0x0002 /
e1c0: 2a 20 50 72 65 66 65 72 65 6e 63 65 20 74 6f 20 * Preference to
e1d0: 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 73 20 2a built-in funcs *
e1e0: 2f 0a 23 64 65 66 69 6e 65 20 44 42 46 4c 41 47 /.#define DBFLAG
e1f0: 5f 56 61 63 75 75 6d 20 20 20 20 20 20 20 20 20 _Vacuum
e200: 30 78 30 30 30 34 20 20 2f 2a 20 43 75 72 72 65 0x0004 /* Curre
e210: 6e 74 6c 79 20 69 6e 20 61 20 56 41 43 55 55 4d ntly in a VACUUM
e220: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 46 4c */.#define DBFL
e230: 41 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b AG_SchemaKnownOk
e240: 20 20 30 78 30 30 30 38 20 20 2f 2a 20 53 63 68 0x0008 /* Sch
e250: 65 6d 61 20 69 73 20 6b 6e 6f 77 6e 20 74 6f 20 ema is known to
e260: 62 65 20 76 61 6c 69 64 20 2a 2f 0a 0a 2f 2a 0a be valid */../*.
e270: 2a 2a 20 42 69 74 73 20 6f 66 20 74 68 65 20 73 ** Bits of the s
e280: 71 6c 69 74 65 33 2e 64 62 4f 70 74 46 6c 61 67 qlite3.dbOptFlag
e290: 73 20 66 69 65 6c 64 20 74 68 61 74 20 61 72 65 s field that are
e2a0: 20 75 73 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 used by the.**
e2b0: 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
e2c0: 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 trol(SQLITE_TEST
e2d0: 43 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 4f CTRL_OPTIMIZATIO
e2e0: 4e 53 2c 2e 2e 2e 29 20 69 6e 74 65 72 66 61 63 NS,...) interfac
e2f0: 65 20 74 6f 0a 2a 2a 20 73 65 6c 65 63 74 69 76 e to.** selectiv
e300: 65 6c 79 20 64 69 73 61 62 6c 65 20 76 61 72 69 ely disable vari
e310: 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ous optimization
e320: 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 s..*/.#define SQ
e330: 4c 49 54 45 5f 51 75 65 72 79 46 6c 61 74 74 65 LITE_QueryFlatte
e340: 6e 65 72 20 30 78 30 30 30 31 20 20 20 2f 2a 20 ner 0x0001 /*
e350: 51 75 65 72 79 20 66 6c 61 74 74 65 6e 69 6e 67 Query flattening
e360: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e370: 54 45 5f 43 6f 6c 75 6d 6e 43 61 63 68 65 20 20 TE_ColumnCache
e380: 20 20 30 78 30 30 30 32 20 20 20 2f 2a 20 43 6f 0x0002 /* Co
e390: 6c 75 6d 6e 20 63 61 63 68 65 20 2a 2f 0a 23 64 lumn cache */.#d
e3a0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 47 72 6f efine SQLITE_Gro
e3b0: 75 70 42 79 4f 72 64 65 72 20 20 20 30 78 30 30 upByOrder 0x00
e3c0: 30 34 20 20 20 2f 2a 20 47 52 4f 55 50 42 59 20 04 /* GROUPBY
e3d0: 63 6f 76 65 72 20 6f 66 20 4f 52 44 45 52 42 59 cover of ORDERBY
e3e0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e3f0: 54 45 5f 46 61 63 74 6f 72 4f 75 74 43 6f 6e 73 TE_FactorOutCons
e400: 74 20 30 78 30 30 30 38 20 20 20 2f 2a 20 43 6f t 0x0008 /* Co
e410: 6e 73 74 61 6e 74 20 66 61 63 74 6f 72 69 6e 67 nstant factoring
e420: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e430: 54 45 5f 44 69 73 74 69 6e 63 74 4f 70 74 20 20 TE_DistinctOpt
e440: 20 20 30 78 30 30 31 30 20 20 20 2f 2a 20 44 49 0x0010 /* DI
e450: 53 54 49 4e 43 54 20 75 73 69 6e 67 20 69 6e 64 STINCT using ind
e460: 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 exes */.#define
e470: 53 51 4c 49 54 45 5f 43 6f 76 65 72 49 64 78 53 SQLITE_CoverIdxS
e480: 63 61 6e 20 20 20 30 78 30 30 32 30 20 20 20 2f can 0x0020 /
e490: 2a 20 43 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 * Covering index
e4a0: 20 73 63 61 6e 73 20 2a 2f 0a 23 64 65 66 69 6e scans */.#defin
e4b0: 65 20 53 51 4c 49 54 45 5f 4f 72 64 65 72 42 79 e SQLITE_OrderBy
e4c0: 49 64 78 4a 6f 69 6e 20 30 78 30 30 34 30 20 20 IdxJoin 0x0040
e4d0: 20 2f 2a 20 4f 52 44 45 52 20 42 59 20 6f 66 20 /* ORDER BY of
e4e0: 6a 6f 69 6e 73 20 76 69 61 20 69 6e 64 65 78 20 joins via index
e4f0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
e500: 45 5f 54 72 61 6e 73 69 74 69 76 65 20 20 20 20 E_Transitive
e510: 20 30 78 30 30 38 30 20 20 20 2f 2a 20 54 72 61 0x0080 /* Tra
e520: 6e 73 69 74 69 76 65 20 63 6f 6e 73 74 72 61 69 nsitive constrai
e530: 6e 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 nts */.#define S
e540: 51 4c 49 54 45 5f 4f 6d 69 74 4e 6f 6f 70 4a 6f QLITE_OmitNoopJo
e550: 69 6e 20 20 20 30 78 30 31 30 30 20 20 20 2f 2a in 0x0100 /*
e560: 20 4f 6d 69 74 20 75 6e 75 73 65 64 20 74 61 62 Omit unused tab
e570: 6c 65 73 20 69 6e 20 6a 6f 69 6e 73 20 2a 2f 0a les in joins */.
e580: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 #define SQLITE_C
e590: 6f 75 6e 74 4f 66 56 69 65 77 20 20 20 20 30 78 ountOfView 0x
e5a0: 30 32 30 30 20 20 20 2f 2a 20 54 68 65 20 63 6f 0200 /* The co
e5b0: 75 6e 74 2d 6f 66 2d 76 69 65 77 20 6f 70 74 69 unt-of-view opti
e5c0: 6d 69 7a 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 mization */.#def
e5d0: 69 6e 65 20 53 51 4c 49 54 45 5f 43 75 72 73 6f ine SQLITE_Curso
e5e0: 72 48 69 6e 74 73 20 20 20 20 30 78 30 34 30 30 rHints 0x0400
e5f0: 20 20 20 2f 2a 20 41 64 64 20 4f 50 5f 43 75 72 /* Add OP_Cur
e600: 73 6f 72 48 69 6e 74 20 6f 70 63 6f 64 65 73 20 sorHint opcodes
e610: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
e620: 45 5f 53 74 61 74 33 34 20 20 20 20 20 20 20 20 E_Stat34
e630: 20 30 78 30 38 30 30 20 20 20 2f 2a 20 55 73 65 0x0800 /* Use
e640: 20 53 54 41 54 33 20 6f 72 20 53 54 41 54 34 20 STAT3 or STAT4
e650: 64 61 74 61 20 2a 2f 0a 20 20 20 2f 2a 20 54 48 data */. /* TH
e660: 33 20 65 78 70 65 63 74 73 20 74 68 65 20 53 74 3 expects the St
e670: 61 74 33 34 20 20 5e 5e 5e 5e 5e 5e 20 76 61 6c at34 ^^^^^^ val
e680: 75 65 20 74 6f 20 62 65 20 30 78 30 38 30 30 2e ue to be 0x0800.
e690: 20 20 44 6f 6e 27 74 20 63 68 61 6e 67 65 20 69 Don't change i
e6a0: 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c t */.#define SQL
e6b0: 49 54 45 5f 50 75 73 68 44 6f 77 6e 20 20 20 20 ITE_PushDown
e6c0: 20 20 20 30 78 31 30 30 30 20 20 20 2f 2a 20 54 0x1000 /* T
e6d0: 68 65 20 70 75 73 68 2d 64 6f 77 6e 20 6f 70 74 he push-down opt
e6e0: 69 6d 69 7a 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 imization */.#de
e6f0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 69 6d 70 fine SQLITE_Simp
e700: 6c 69 66 79 4a 6f 69 6e 20 20 20 30 78 32 30 30 lifyJoin 0x200
e710: 30 20 20 20 2f 2a 20 43 6f 6e 76 65 72 74 20 4c 0 /* Convert L
e720: 45 46 54 20 4a 4f 49 4e 20 74 6f 20 4a 4f 49 4e EFT JOIN to JOIN
e730: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e740: 54 45 5f 41 6c 6c 4f 70 74 73 20 20 20 20 20 20 TE_AllOpts
e750: 20 20 30 78 66 66 66 66 20 20 20 2f 2a 20 41 6c 0xffff /* Al
e760: 6c 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 20 l optimizations
e770: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 */../*.** Macros
e780: 20 66 6f 72 20 74 65 73 74 69 6e 67 20 77 68 65 for testing whe
e790: 74 68 65 72 20 6f 72 20 6e 6f 74 20 6f 70 74 69 ther or not opti
e7a0: 6d 69 7a 61 74 69 6f 6e 73 20 61 72 65 20 65 6e mizations are en
e7b0: 61 62 6c 65 64 20 6f 72 20 64 69 73 61 62 6c 65 abled or disable
e7c0: 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 70 d..*/.#define Op
e7d0: 74 69 6d 69 7a 61 74 69 6f 6e 44 69 73 61 62 6c timizationDisabl
e7e0: 65 64 28 64 62 2c 20 6d 61 73 6b 29 20 20 28 28 ed(db, mask) ((
e7f0: 28 64 62 29 2d 3e 64 62 4f 70 74 46 6c 61 67 73 (db)->dbOptFlags
e800: 26 28 6d 61 73 6b 29 29 21 3d 30 29 0a 23 64 65 &(mask))!=0).#de
e810: 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f fine Optimizatio
e820: 6e 45 6e 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 nEnabled(db, mas
e830: 6b 29 20 20 20 28 28 28 64 62 29 2d 3e 64 62 4f k) (((db)->dbO
e840: 70 74 46 6c 61 67 73 26 28 6d 61 73 6b 29 29 3d ptFlags&(mask))=
e850: 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 =0)../*.** Retur
e860: 6e 20 74 72 75 65 20 69 66 20 69 74 20 4f 4b 20 n true if it OK
e870: 74 6f 20 66 61 63 74 6f 72 20 63 6f 6e 73 74 61 to factor consta
e880: 6e 74 20 65 78 70 72 65 73 73 69 6f 6e 73 20 69 nt expressions i
e890: 6e 74 6f 20 74 68 65 20 69 6e 69 74 69 61 6c 69 nto the initiali
e8a0: 7a 61 74 69 6f 6e 0a 2a 2a 20 63 6f 64 65 2e 20 zation.** code.
e8b0: 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 The argument is
e8c0: 61 20 50 61 72 73 65 20 6f 62 6a 65 63 74 20 66 a Parse object f
e8d0: 6f 72 20 74 68 65 20 63 6f 64 65 20 67 65 6e 65 or the code gene
e8e0: 72 61 74 6f 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e rator..*/.#defin
e8f0: 65 20 43 6f 6e 73 74 46 61 63 74 6f 72 4f 6b 28 e ConstFactorOk(
e900: 50 29 20 28 28 50 29 2d 3e 6f 6b 43 6f 6e 73 74 P) ((P)->okConst
e910: 46 61 63 74 6f 72 29 0a 0a 2f 2a 0a 2a 2a 20 50 Factor)../*.** P
e920: 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 ossible values f
e930: 6f 72 20 74 68 65 20 73 71 6c 69 74 65 2e 6d 61 or the sqlite.ma
e940: 67 69 63 20 66 69 65 6c 64 2e 0a 2a 2a 20 54 68 gic field..** Th
e950: 65 20 6e 75 6d 62 65 72 73 20 61 72 65 20 6f 62 e numbers are ob
e960: 74 61 69 6e 65 64 20 61 74 20 72 61 6e 64 6f 6d tained at random
e970: 20 61 6e 64 20 68 61 76 65 20 6e 6f 20 73 70 65 and have no spe
e980: 63 69 61 6c 20 6d 65 61 6e 69 6e 67 2c 20 6f 74 cial meaning, ot
e990: 68 65 72 0a 2a 2a 20 74 68 61 6e 20 62 65 69 6e her.** than bein
e9a0: 67 20 64 69 73 74 69 6e 63 74 20 66 72 6f 6d 20 g distinct from
e9b0: 6f 6e 65 20 61 6e 6f 74 68 65 72 2e 0a 2a 2f 0a one another..*/.
e9c0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d #define SQLITE_M
e9d0: 41 47 49 43 5f 4f 50 45 4e 20 20 20 20 20 30 78 AGIC_OPEN 0x
e9e0: 61 30 32 39 61 36 39 37 20 20 2f 2a 20 44 61 74 a029a697 /* Dat
e9f0: 61 62 61 73 65 20 69 73 20 6f 70 65 6e 20 2a 2f abase is open */
ea00: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
ea10: 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 20 20 30 MAGIC_CLOSED 0
ea20: 78 39 66 33 63 32 64 33 33 20 20 2f 2a 20 44 61 x9f3c2d33 /* Da
ea30: 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 tabase is closed
ea40: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
ea50: 54 45 5f 4d 41 47 49 43 5f 53 49 43 4b 20 20 20 TE_MAGIC_SICK
ea60: 20 20 30 78 34 62 37 37 31 32 39 30 20 20 2f 2a 0x4b771290 /*
ea70: 20 45 72 72 6f 72 20 61 6e 64 20 61 77 61 69 74 Error and await
ea80: 69 6e 67 20 63 6c 6f 73 65 20 2a 2f 0a 23 64 65 ing close */.#de
ea90: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 fine SQLITE_MAGI
eaa0: 43 5f 42 55 53 59 20 20 20 20 20 30 78 66 30 33 C_BUSY 0xf03
eab0: 62 37 39 30 36 20 20 2f 2a 20 44 61 74 61 62 61 b7906 /* Databa
eac0: 73 65 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 se currently in
ead0: 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 use */.#define S
eae0: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f QLITE_MAGIC_ERRO
eaf0: 52 20 20 20 20 30 78 62 35 33 35 37 39 33 30 20 R 0xb5357930
eb00: 20 2f 2a 20 41 6e 20 53 51 4c 49 54 45 5f 4d 49 /* An SQLITE_MI
eb10: 53 55 53 45 20 65 72 72 6f 72 20 6f 63 63 75 72 SUSE error occur
eb20: 72 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 red */.#define S
eb30: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 QLITE_MAGIC_ZOMB
eb40: 49 45 20 20 20 30 78 36 34 63 66 66 63 37 66 20 IE 0x64cffc7f
eb50: 20 2f 2a 20 43 6c 6f 73 65 20 77 69 74 68 20 6c /* Close with l
eb60: 61 73 74 20 73 74 61 74 65 6d 65 6e 74 20 63 6c ast statement cl
eb70: 6f 73 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 ose */../*.** Ea
eb80: 63 68 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 ch SQL function
eb90: 69 73 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e is defined by an
eba0: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
ebb0: 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 following.** st
ebc0: 72 75 63 74 75 72 65 2e 20 20 46 6f 72 20 67 6c ructure. For gl
ebd0: 6f 62 61 6c 20 62 75 69 6c 74 2d 69 6e 20 66 75 obal built-in fu
ebe0: 6e 63 74 69 6f 6e 73 20 28 65 78 3a 20 73 75 62 nctions (ex: sub
ebf0: 73 74 72 28 29 2c 20 6d 61 78 28 29 2c 20 63 6f str(), max(), co
ec00: 75 6e 74 28 29 29 0a 2a 2a 20 61 20 70 6f 69 6e unt()).** a poin
ec10: 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 ter to this stru
ec20: 63 74 75 72 65 20 69 73 20 68 65 6c 64 20 69 6e cture is held in
ec30: 20 74 68 65 20 73 71 6c 69 74 65 33 42 75 69 6c the sqlite3Buil
ec40: 74 69 6e 46 75 6e 63 74 69 6f 6e 73 20 6f 62 6a tinFunctions obj
ec50: 65 63 74 2e 0a 2a 2a 20 46 6f 72 20 70 65 72 2d ect..** For per-
ec60: 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 70 70 6c 69 connection appli
ec70: 63 61 74 69 6f 6e 2d 64 65 66 69 6e 65 64 20 66 cation-defined f
ec80: 75 6e 63 74 69 6f 6e 73 2c 20 61 20 70 6f 69 6e unctions, a poin
ec90: 74 65 72 20 74 6f 20 74 68 69 73 0a 2a 2a 20 73 ter to this.** s
eca0: 74 72 75 63 74 75 72 65 20 69 73 20 68 65 6c 64 tructure is held
ecb0: 20 69 6e 20 74 68 65 20 64 62 2d 3e 61 48 61 73 in the db->aHas
ecc0: 68 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 2a 2a h hash table..**
ecd0: 0a 2a 2a 20 54 68 65 20 75 2e 70 48 61 73 68 20 .** The u.pHash
ece0: 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 62 79 field is used by
ecf0: 20 74 68 65 20 67 6c 6f 62 61 6c 20 62 75 69 6c the global buil
ed00: 74 2d 69 6e 73 2e 20 20 54 68 65 20 75 2e 70 44 t-ins. The u.pD
ed10: 65 73 74 72 75 63 74 6f 72 0a 2a 2a 20 66 69 65 estructor.** fie
ed20: 6c 64 20 69 73 20 75 73 65 64 20 62 79 20 70 65 ld is used by pe
ed30: 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 70 70 r-connection app
ed40: 2d 64 65 66 20 66 75 6e 63 74 69 6f 6e 73 2e 0a -def functions..
ed50: 2a 2f 0a 73 74 72 75 63 74 20 46 75 6e 63 44 65 */.struct FuncDe
ed60: 66 20 7b 0a 20 20 69 38 20 6e 41 72 67 3b 20 20 f {. i8 nArg;
ed70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
ed80: 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
ed90: 73 2e 20 20 2d 31 20 6d 65 61 6e 73 20 75 6e 6c s. -1 means unl
eda0: 69 6d 69 74 65 64 20 2a 2f 0a 20 20 75 31 36 20 imited */. u16
edb0: 66 75 6e 63 46 6c 61 67 73 3b 20 20 20 20 20 20 funcFlags;
edc0: 20 2f 2a 20 53 6f 6d 65 20 63 6f 6d 62 69 6e 61 /* Some combina
edd0: 74 69 6f 6e 20 6f 66 20 53 51 4c 49 54 45 5f 46 tion of SQLITE_F
ede0: 55 4e 43 5f 2a 20 2a 2f 0a 20 20 76 6f 69 64 20 UNC_* */. void
edf0: 2a 70 55 73 65 72 44 61 74 61 3b 20 20 20 20 20 *pUserData;
ee00: 2f 2a 20 55 73 65 72 20 64 61 74 61 20 70 61 72 /* User data par
ee10: 61 6d 65 74 65 72 20 2a 2f 0a 20 20 46 75 6e 63 ameter */. Func
ee20: 44 65 66 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 Def *pNext;
ee30: 20 2f 2a 20 4e 65 78 74 20 66 75 6e 63 74 69 6f /* Next functio
ee40: 6e 20 77 69 74 68 20 73 61 6d 65 20 6e 61 6d 65 n with same name
ee50: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 53 46 */. void (*xSF
ee60: 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e unc)(sqlite3_con
ee70: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
ee80: 33 5f 76 61 6c 75 65 2a 2a 29 3b 20 2f 2a 20 66 3_value**); /* f
ee90: 75 6e 63 20 6f 72 20 61 67 67 2d 73 74 65 70 20 unc or agg-step
eea0: 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46 69 6e */. void (*xFin
eeb0: 61 6c 69 7a 65 29 28 73 71 6c 69 74 65 33 5f 63 alize)(sqlite3_c
eec0: 6f 6e 74 65 78 74 2a 29 3b 20 20 20 20 20 20 20 ontext*);
eed0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 67 /* Ag
eee0: 67 20 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a 20 g finalizer */.
eef0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 const char *zNa
ef00: 6d 65 3b 20 20 20 2f 2a 20 53 51 4c 20 6e 61 6d me; /* SQL nam
ef10: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f e of the functio
ef20: 6e 2e 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a n. */. union {.
ef30: 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 48 61 FuncDef *pHa
ef40: 73 68 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 sh; /* Next
ef50: 20 77 69 74 68 20 61 20 64 69 66 66 65 72 65 6e with a differen
ef60: 74 20 6e 61 6d 65 20 62 75 74 20 74 68 65 20 73 t name but the s
ef70: 61 6d 65 20 68 61 73 68 20 2a 2f 0a 20 20 20 20 ame hash */.
ef80: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a FuncDestructor *
ef90: 70 44 65 73 74 72 75 63 74 6f 72 3b 20 20 20 2f pDestructor; /
efa0: 2a 20 52 65 66 65 72 65 6e 63 65 20 63 6f 75 6e * Reference coun
efb0: 74 65 64 20 64 65 73 74 72 75 63 74 6f 72 20 66 ted destructor f
efc0: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 7d 20 75 unction */. } u
efd0: 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 ;.};../*.** This
efe0: 20 73 74 72 75 63 74 75 72 65 20 65 6e 63 61 70 structure encap
eff0: 73 75 6c 61 74 65 73 20 61 20 75 73 65 72 2d 66 sulates a user-f
f000: 75 6e 63 74 69 6f 6e 20 64 65 73 74 72 75 63 74 unction destruct
f010: 6f 72 20 63 61 6c 6c 62 61 63 6b 20 28 61 73 0a or callback (as.
f020: 2a 2a 20 63 6f 6e 66 69 67 75 72 65 64 20 75 73 ** configured us
f030: 69 6e 67 20 63 72 65 61 74 65 5f 66 75 6e 63 74 ing create_funct
f040: 69 6f 6e 5f 76 32 28 29 29 20 61 6e 64 20 61 20 ion_v2()) and a
f050: 72 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 65 reference counte
f060: 72 2e 20 57 68 65 6e 0a 2a 2a 20 63 72 65 61 74 r. When.** creat
f070: 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 29 20 e_function_v2()
f080: 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 63 72 65 is called to cre
f090: 61 74 65 20 61 20 66 75 6e 63 74 69 6f 6e 20 77 ate a function w
f0a0: 69 74 68 20 61 20 64 65 73 74 72 75 63 74 6f 72 ith a destructor
f0b0: 2c 0a 2a 2a 20 61 20 73 69 6e 67 6c 65 20 6f 62 ,.** a single ob
f0c0: 6a 65 63 74 20 6f 66 20 74 68 69 73 20 74 79 70 ject of this typ
f0d0: 65 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 2e 20 e is allocated.
f0e0: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 2e 6e FuncDestructor.n
f0f0: 52 65 66 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a Ref is set to.**
f100: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 46 the number of F
f110: 75 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 20 63 uncDef objects c
f120: 72 65 61 74 65 64 20 28 65 69 74 68 65 72 20 31 reated (either 1
f130: 20 6f 72 20 33 2c 20 64 65 70 65 6e 64 69 6e 67 or 3, depending
f140: 20 6f 6e 20 77 68 65 74 68 65 72 0a 2a 2a 20 6f on whether.** o
f150: 72 20 6e 6f 74 20 74 68 65 20 73 70 65 63 69 66 r not the specif
f160: 69 65 64 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 ied encoding is
f170: 53 51 4c 49 54 45 5f 41 4e 59 29 2e 20 54 68 65 SQLITE_ANY). The
f180: 20 46 75 6e 63 44 65 66 2e 70 44 65 73 74 72 75 FuncDef.pDestru
f190: 63 74 6f 72 0a 2a 2a 20 6d 65 6d 62 65 72 20 6f ctor.** member o
f1a0: 66 20 65 61 63 68 20 6f 66 20 74 68 65 20 6e 65 f each of the ne
f1b0: 77 20 46 75 6e 63 44 65 66 20 6f 62 6a 65 63 74 w FuncDef object
f1c0: 73 20 69 73 20 73 65 74 20 74 6f 20 70 6f 69 6e s is set to poin
f1d0: 74 20 74 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 t to the allocat
f1e0: 65 64 0a 2a 2a 20 46 75 6e 63 44 65 73 74 72 75 ed.** FuncDestru
f1f0: 63 74 6f 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 ctor..**.** Ther
f200: 65 61 66 74 65 72 2c 20 77 68 65 6e 20 6f 6e 65 eafter, when one
f210: 20 6f 66 20 74 68 65 20 46 75 6e 63 44 65 66 20 of the FuncDef
f220: 6f 62 6a 65 63 74 73 20 69 73 20 64 65 6c 65 74 objects is delet
f230: 65 64 2c 20 74 68 65 20 72 65 66 65 72 65 6e 63 ed, the referenc
f240: 65 0a 2a 2a 20 63 6f 75 6e 74 20 6f 6e 20 74 68 e.** count on th
f250: 69 73 20 6f 62 6a 65 63 74 20 69 73 20 64 65 63 is object is dec
f260: 72 65 6d 65 6e 74 65 64 2e 20 57 68 65 6e 20 69 remented. When i
f270: 74 20 72 65 61 63 68 65 73 20 30 2c 20 74 68 65 t reaches 0, the
f280: 20 64 65 73 74 72 75 63 74 6f 72 0a 2a 2a 20 69 destructor.** i
f290: 73 20 69 6e 76 6f 6b 65 64 20 61 6e 64 20 74 68 s invoked and th
f2a0: 65 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 e FuncDestructor
f2b0: 20 73 74 72 75 63 74 75 72 65 20 66 72 65 65 64 structure freed
f2c0: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 46 75 6e 63 ..*/.struct Func
f2d0: 44 65 73 74 72 75 63 74 6f 72 20 7b 0a 20 20 69 Destructor {. i
f2e0: 6e 74 20 6e 52 65 66 3b 0a 20 20 76 6f 69 64 20 nt nRef;. void
f2f0: 28 2a 78 44 65 73 74 72 6f 79 29 28 76 6f 69 64 (*xDestroy)(void
f300: 20 2a 29 3b 0a 20 20 76 6f 69 64 20 2a 70 55 73 *);. void *pUs
f310: 65 72 44 61 74 61 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a erData;.};../*.*
f320: 2a 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 * Possible value
f330: 73 20 66 6f 72 20 46 75 6e 63 44 65 66 2e 66 6c s for FuncDef.fl
f340: 61 67 73 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 ags. Note that
f350: 74 68 65 20 5f 4c 45 4e 47 54 48 20 61 6e 64 20 the _LENGTH and
f360: 5f 54 59 50 45 4f 46 0a 2a 2a 20 76 61 6c 75 65 _TYPEOF.** value
f370: 73 20 6d 75 73 74 20 63 6f 72 72 65 73 70 6f 6e s must correspon
f380: 64 20 74 6f 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 d to OPFLAG_LENG
f390: 54 48 41 52 47 20 61 6e 64 20 4f 50 46 4c 41 47 THARG and OPFLAG
f3a0: 5f 54 59 50 45 4f 46 41 52 47 2e 20 20 41 6e 64 _TYPEOFARG. And
f3b0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f .** SQLITE_FUNC_
f3c0: 43 4f 4e 53 54 41 4e 54 20 6d 75 73 74 20 62 65 CONSTANT must be
f3d0: 20 74 68 65 20 73 61 6d 65 20 61 73 20 53 51 4c the same as SQL
f3e0: 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 ITE_DETERMINISTI
f3f0: 43 2e 20 20 54 68 65 72 65 0a 2a 2a 20 61 72 65 C. There.** are
f400: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
f410: 65 6e 74 73 20 69 6e 20 74 68 65 20 63 6f 64 65 ents in the code
f420: 20 74 6f 20 76 65 72 69 66 79 20 74 68 69 73 2e to verify this.
f430: 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e .**.** Value con
f440: 73 74 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 63 straints (enforc
f450: 65 64 20 76 69 61 20 61 73 73 65 72 74 28 29 29 ed via assert())
f460: 3a 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f :.** SQLITE_
f470: 46 55 4e 43 5f 4d 49 4e 4d 41 58 20 20 20 20 3d FUNC_MINMAX =
f480: 3d 20 20 4e 43 5f 4d 69 6e 4d 61 78 41 67 67 20 = NC_MinMaxAgg
f490: 20 20 20 20 20 3d 3d 20 53 46 5f 4d 69 6e 4d 61 == SF_MinMa
f4a0: 78 41 67 67 0a 2a 2a 20 20 20 20 20 53 51 4c 49 xAgg.** SQLI
f4b0: 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 20 20 TE_FUNC_LENGTH
f4c0: 20 20 3d 3d 20 20 4f 50 46 4c 41 47 5f 4c 45 4e == OPFLAG_LEN
f4d0: 47 54 48 41 52 47 0a 2a 2a 20 20 20 20 20 53 51 GTHARG.** SQ
f4e0: 4c 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 LITE_FUNC_TYPEOF
f4f0: 20 20 20 20 3d 3d 20 20 4f 50 46 4c 41 47 5f 54 == OPFLAG_T
f500: 59 50 45 4f 46 41 52 47 0a 2a 2a 20 20 20 20 20 YPEOFARG.**
f510: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 SQLITE_FUNC_CONS
f520: 54 41 4e 54 20 20 3d 3d 20 20 53 51 4c 49 54 45 TANT == SQLITE
f530: 5f 44 45 54 45 52 4d 49 4e 49 53 54 49 43 20 66 _DETERMINISTIC f
f540: 72 6f 6d 20 74 68 65 20 41 50 49 0a 2a 2a 20 20 rom the API.**
f550: 20 20 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 SQLITE_FUNC_E
f560: 4e 43 4d 41 53 4b 20 20 20 64 65 70 65 6e 64 73 NCMASK depends
f570: 20 6f 6e 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 on SQLITE_UTF*
f580: 6d 61 63 72 6f 73 20 69 6e 20 74 68 65 20 41 50 macros in the AP
f590: 49 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c I.*/.#define SQL
f5a0: 49 54 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b ITE_FUNC_ENCMASK
f5b0: 20 20 30 78 30 30 30 33 20 2f 2a 20 53 51 4c 49 0x0003 /* SQLI
f5c0: 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f TE_UTF8, SQLITE_
f5d0: 55 54 46 31 36 42 45 20 6f 72 20 55 54 46 31 36 UTF16BE or UTF16
f5e0: 4c 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 LE */.#define SQ
f5f0: 4c 49 54 45 5f 46 55 4e 43 5f 4c 49 4b 45 20 20 LITE_FUNC_LIKE
f600: 20 20 20 30 78 30 30 30 34 20 2f 2a 20 43 61 6e 0x0004 /* Can
f610: 64 69 64 61 74 65 20 66 6f 72 20 74 68 65 20 4c didate for the L
f620: 49 4b 45 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e IKE optimization
f630: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
f640: 54 45 5f 46 55 4e 43 5f 43 41 53 45 20 20 20 20 TE_FUNC_CASE
f650: 20 30 78 30 30 30 38 20 2f 2a 20 43 61 73 65 2d 0x0008 /* Case-
f660: 73 65 6e 73 69 74 69 76 65 20 4c 49 4b 45 2d 74 sensitive LIKE-t
f670: 79 70 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a ype function */.
f680: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
f690: 55 4e 43 5f 45 50 48 45 4d 20 20 20 20 30 78 30 UNC_EPHEM 0x0
f6a0: 30 31 30 20 2f 2a 20 45 70 68 65 6d 65 72 61 6c 010 /* Ephemeral
f6b0: 2e 20 20 44 65 6c 65 74 65 20 77 69 74 68 20 56 . Delete with V
f6c0: 44 42 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 DBE */.#define S
f6d0: 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 QLITE_FUNC_NEEDC
f6e0: 4f 4c 4c 20 30 78 30 30 32 30 20 2f 2a 20 73 71 OLL 0x0020 /* sq
f6f0: 6c 69 74 65 33 47 65 74 46 75 6e 63 43 6f 6c 6c lite3GetFuncColl
f700: 53 65 71 28 29 20 6d 69 67 68 74 20 62 65 20 63 Seq() might be c
f710: 61 6c 6c 65 64 2a 2f 0a 23 64 65 66 69 6e 65 20 alled*/.#define
f720: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 SQLITE_FUNC_LENG
f730: 54 48 20 20 20 30 78 30 30 34 30 20 2f 2a 20 42 TH 0x0040 /* B
f740: 75 69 6c 74 2d 69 6e 20 6c 65 6e 67 74 68 28 29 uilt-in length()
f750: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 function */.#de
f760: 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 fine SQLITE_FUNC
f770: 5f 54 59 50 45 4f 46 20 20 20 30 78 30 30 38 30 _TYPEOF 0x0080
f780: 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 74 79 70 /* Built-in typ
f790: 65 6f 66 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a eof() function *
f7a0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
f7b0: 5f 46 55 4e 43 5f 43 4f 55 4e 54 20 20 20 20 30 _FUNC_COUNT 0
f7c0: 78 30 31 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 x0100 /* Built-i
f7d0: 6e 20 63 6f 75 6e 74 28 2a 29 20 61 67 67 72 65 n count(*) aggre
f7e0: 67 61 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 gate */.#define
f7f0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 41 4c SQLITE_FUNC_COAL
f800: 45 53 43 45 20 30 78 30 32 30 30 20 2f 2a 20 42 ESCE 0x0200 /* B
f810: 75 69 6c 74 2d 69 6e 20 63 6f 61 6c 65 73 63 65 uilt-in coalesce
f820: 28 29 20 6f 72 20 69 66 6e 75 6c 6c 28 29 20 2a () or ifnull() *
f830: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
f840: 5f 46 55 4e 43 5f 55 4e 4c 49 4b 45 4c 59 20 30 _FUNC_UNLIKELY 0
f850: 78 30 34 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 x0400 /* Built-i
f860: 6e 20 75 6e 6c 69 6b 65 6c 79 28 29 20 66 75 6e n unlikely() fun
f870: 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 ction */.#define
f880: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e SQLITE_FUNC_CON
f890: 53 54 41 4e 54 20 30 78 30 38 30 30 20 2f 2a 20 STANT 0x0800 /*
f8a0: 43 6f 6e 73 74 61 6e 74 20 69 6e 70 75 74 73 20 Constant inputs
f8b0: 67 69 76 65 20 61 20 63 6f 6e 73 74 61 6e 74 20 give a constant
f8c0: 6f 75 74 70 75 74 20 2a 2f 0a 23 64 65 66 69 6e output */.#defin
f8d0: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4d 49 e SQLITE_FUNC_MI
f8e0: 4e 4d 41 58 20 20 20 30 78 31 30 30 30 20 2f 2a NMAX 0x1000 /*
f8f0: 20 54 72 75 65 20 66 6f 72 20 6d 69 6e 28 29 20 True for min()
f900: 61 6e 64 20 6d 61 78 28 29 20 61 67 67 72 65 67 and max() aggreg
f910: 61 74 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ates */.#define
f920: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c 4f 43 SQLITE_FUNC_SLOC
f930: 48 4e 47 20 20 30 78 32 30 30 30 20 2f 2a 20 22 HNG 0x2000 /* "
f940: 53 6c 6f 77 20 43 68 61 6e 67 65 22 2e 20 56 61 Slow Change". Va
f950: 6c 75 65 20 63 6f 6e 73 74 61 6e 74 20 64 75 72 lue constant dur
f960: 69 6e 67 20 61 0a 20 20 20 20 20 20 20 20 20 20 ing a.
f970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f980: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 69 6e ** sin
f990: 67 6c 65 20 71 75 65 72 79 20 2d 20 6d 69 67 68 gle query - migh
f9a0: 74 20 63 68 61 6e 67 65 20 6f 76 65 72 20 74 69 t change over ti
f9b0: 6d 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 me */.#define SQ
f9c0: 4c 49 54 45 5f 46 55 4e 43 5f 41 46 46 49 4e 49 LITE_FUNC_AFFINI
f9d0: 54 59 20 30 78 34 30 30 30 20 2f 2a 20 42 75 69 TY 0x4000 /* Bui
f9e0: 6c 74 2d 69 6e 20 61 66 66 69 6e 69 74 79 28 29 lt-in affinity()
f9f0: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 function */.#de
fa00: 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 fine SQLITE_FUNC
fa10: 5f 4f 46 46 53 45 54 20 20 20 30 78 38 30 30 30 _OFFSET 0x8000
fa20: 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 73 71 6c /* Built-in sql
fa30: 69 74 65 5f 6f 66 66 73 65 74 28 29 20 66 75 6e ite_offset() fun
fa40: 63 74 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 ction */../*.**
fa50: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 The following th
fa60: 72 65 65 20 6d 61 63 72 6f 73 2c 20 46 55 4e 43 ree macros, FUNC
fa70: 54 49 4f 4e 28 29 2c 20 4c 49 4b 45 46 55 4e 43 TION(), LIKEFUNC
fa80: 28 29 20 61 6e 64 20 41 47 47 52 45 47 41 54 45 () and AGGREGATE
fa90: 28 29 20 61 72 65 0a 2a 2a 20 75 73 65 64 20 74 () are.** used t
faa0: 6f 20 63 72 65 61 74 65 20 74 68 65 20 69 6e 69 o create the ini
fab0: 74 69 61 6c 69 7a 65 72 73 20 66 6f 72 20 74 68 tializers for th
fac0: 65 20 46 75 6e 63 44 65 66 20 73 74 72 75 63 74 e FuncDef struct
fad0: 75 72 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 55 ures..**.** FU
fae0: 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 NCTION(zName, nA
faf0: 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 rg, iArg, bNC, x
fb00: 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 55 73 65 Func).** Use
fb10: 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 d to create a sc
fb20: 61 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 alar function de
fb30: 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 finition of a fu
fb40: 6e 63 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 nction zName.**
fb50: 20 20 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 implemented
fb60: 62 79 20 43 20 66 75 6e 63 74 69 6f 6e 20 78 46 by C function xF
fb70: 75 6e 63 20 74 68 61 74 20 61 63 63 65 70 74 73 unc that accepts
fb80: 20 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 73 2e nArg arguments.
fb90: 20 54 68 65 0a 2a 2a 20 20 20 20 20 76 61 6c 75 The.** valu
fba0: 65 20 70 61 73 73 65 64 20 61 73 20 69 41 72 67 e passed as iArg
fbb0: 20 69 73 20 63 61 73 74 20 74 6f 20 61 20 28 76 is cast to a (v
fbc0: 6f 69 64 2a 29 20 61 6e 64 20 6d 61 64 65 20 61 oid*) and made a
fbd0: 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 20 20 20 20 vailable.**
fbe0: 61 73 20 74 68 65 20 75 73 65 72 2d 64 61 74 61 as the user-data
fbf0: 20 28 73 71 6c 69 74 65 33 5f 75 73 65 72 5f 64 (sqlite3_user_d
fc00: 61 74 61 28 29 29 20 66 6f 72 20 74 68 65 20 66 ata()) for the f
fc10: 75 6e 63 74 69 6f 6e 2e 20 49 66 0a 2a 2a 20 20 unction. If.**
fc20: 20 20 20 61 72 67 75 6d 65 6e 74 20 62 4e 43 20 argument bNC
fc30: 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 is true, then th
fc40: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 e SQLITE_FUNC_NE
fc50: 45 44 43 4f 4c 4c 20 66 6c 61 67 20 69 73 20 73 EDCOLL flag is s
fc60: 65 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 56 46 55 4e et..**.** VFUN
fc70: 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 CTION(zName, nAr
fc80: 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 g, iArg, bNC, xF
fc90: 75 6e 63 29 0a 2a 2a 20 20 20 20 20 4c 69 6b 65 unc).** Like
fca0: 20 46 55 4e 43 54 49 4f 4e 20 65 78 63 65 70 74 FUNCTION except
fcb0: 20 69 74 20 6f 6d 69 74 73 20 74 68 65 20 53 51 it omits the SQ
fcc0: 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 LITE_FUNC_CONSTA
fcd0: 4e 54 20 66 6c 61 67 2e 0a 2a 2a 0a 2a 2a 20 20 NT flag..**.**
fce0: 20 44 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 DFUNCTION(zName
fcf0: 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
fd00: 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 20 C, xFunc).**
fd10: 20 4c 69 6b 65 20 46 55 4e 43 54 49 4f 4e 20 65 Like FUNCTION e
fd20: 78 63 65 70 74 20 69 74 20 6f 6d 69 74 73 20 74 xcept it omits t
fd30: 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 he SQLITE_FUNC_C
fd40: 4f 4e 53 54 41 4e 54 20 66 6c 61 67 20 61 6e 64 ONSTANT flag and
fd50: 0a 2a 2a 20 20 20 20 20 61 64 64 73 20 74 68 65 .** adds the
fd60: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c 4f SQLITE_FUNC_SLO
fd70: 43 48 4e 47 20 66 6c 61 67 2e 20 20 55 73 65 64 CHNG flag. Used
fd80: 20 66 6f 72 20 64 61 74 65 20 26 20 74 69 6d 65 for date & time
fd90: 20 66 75 6e 63 74 69 6f 6e 73 0a 2a 2a 20 20 20 functions.**
fda0: 20 20 61 6e 64 20 66 75 6e 63 74 69 6f 6e 73 20 and functions
fdb0: 6c 69 6b 65 20 73 71 6c 69 74 65 5f 76 65 72 73 like sqlite_vers
fdc0: 69 6f 6e 28 29 20 74 68 61 74 20 63 61 6e 20 63 ion() that can c
fdd0: 68 61 6e 67 65 2c 20 62 75 74 20 6e 6f 74 20 64 hange, but not d
fde0: 75 72 69 6e 67 0a 2a 2a 20 20 20 20 20 61 20 73 uring.** a s
fdf0: 69 6e 67 6c 65 20 71 75 65 72 79 2e 20 20 54 68 ingle query. Th
fe00: 65 20 69 41 72 67 20 69 73 20 69 67 6e 6f 72 65 e iArg is ignore
fe10: 64 2e 20 20 54 68 65 20 75 73 65 72 2d 64 61 74 d. The user-dat
fe20: 61 20 69 73 20 61 6c 77 61 79 73 20 73 65 74 0a a is always set.
fe30: 2a 2a 20 20 20 20 20 74 6f 20 61 20 4e 55 4c 4c ** to a NULL
fe40: 20 70 6f 69 6e 74 65 72 2e 20 20 54 68 65 20 62 pointer. The b
fe50: 4e 43 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 NC parameter is
fe60: 6e 6f 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 not used..**.**
fe70: 20 20 50 55 52 45 5f 44 41 54 45 28 7a 4e 61 6d PURE_DATE(zNam
fe80: 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 e, nArg, iArg, b
fe90: 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 NC, xFunc).**
fea0: 20 20 55 73 65 64 20 66 6f 72 20 22 70 75 72 65 Used for "pure
feb0: 22 20 64 61 74 65 2f 74 69 6d 65 20 66 75 6e 63 " date/time func
fec0: 74 69 6f 6e 73 2c 20 74 68 69 73 20 6d 61 63 72 tions, this macr
fed0: 6f 20 69 73 20 6c 69 6b 65 20 44 46 55 4e 43 54 o is like DFUNCT
fee0: 49 4f 4e 0a 2a 2a 20 20 20 20 20 65 78 63 65 70 ION.** excep
fef0: 74 20 74 68 61 74 20 69 74 20 64 6f 65 73 20 73 t that it does s
ff00: 65 74 20 74 68 65 20 53 51 4c 49 54 45 5f 46 55 et the SQLITE_FU
ff10: 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 66 6c 61 67 NC_CONSTANT flag
ff20: 73 2e 20 20 69 41 72 67 20 69 73 0a 2a 2a 20 20 s. iArg is.**
ff30: 20 20 20 69 67 6e 6f 72 65 64 20 61 6e 64 20 74 ignored and t
ff40: 68 65 20 75 73 65 72 2d 64 61 74 61 20 66 6f 72 he user-data for
ff50: 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e 73 these functions
ff60: 20 69 73 20 73 65 74 20 74 6f 20 61 6e 20 0a 2a is set to an .*
ff70: 2a 20 20 20 20 20 61 72 62 69 74 72 61 72 79 20 * arbitrary
ff80: 6e 6f 6e 2d 4e 55 4c 4c 20 70 6f 69 6e 74 65 72 non-NULL pointer
ff90: 2e 20 20 54 68 65 20 62 4e 43 20 70 61 72 61 6d . The bNC param
ffa0: 65 74 65 72 20 69 73 20 6e 6f 74 20 75 73 65 64 eter is not used
ffb0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 41 47 47 52 45 47 ..**.** AGGREG
ffc0: 41 54 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c ATE(zName, nArg,
ffd0: 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 53 74 65 iArg, bNC, xSte
ffe0: 70 2c 20 78 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 p, xFinal).**
fff0: 20 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 Used to create
10000 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 an aggregate fu
10010 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f nction definitio
10020 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 n implemented by
10030 0a 2a 2a 20 20 20 20 20 74 68 65 20 43 20 66 75 .** the C fu
10040 6e 63 74 69 6f 6e 73 20 78 53 74 65 70 20 61 6e nctions xStep an
10050 64 20 78 46 69 6e 61 6c 2e 20 54 68 65 20 66 69 d xFinal. The fi
10060 72 73 74 20 66 6f 75 72 20 70 61 72 61 6d 65 74 rst four paramet
10070 65 72 73 0a 2a 2a 20 20 20 20 20 61 72 65 20 69 ers.** are i
10080 6e 74 65 72 70 72 65 74 65 64 20 69 6e 20 74 68 nterpreted in th
10090 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 e same way as th
100a0 65 20 66 69 72 73 74 20 34 20 70 61 72 61 6d 65 e first 4 parame
100b0 74 65 72 73 20 74 6f 0a 2a 2a 20 20 20 20 20 46 ters to.** F
100c0 55 4e 43 54 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a UNCTION()..**.**
100d0 20 20 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d LIKEFUNC(zNam
100e0 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 66 e, nArg, pArg, f
100f0 6c 61 67 73 29 0a 2a 2a 20 20 20 20 20 55 73 65 lags).** Use
10100 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 d to create a sc
10110 61 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 alar function de
10120 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 finition of a fu
10130 6e 63 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 nction zName.**
10140 20 20 20 20 74 68 61 74 20 61 63 63 65 70 74 73 that accepts
10150 20 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 73 20 nArg arguments
10160 61 6e 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 and is implement
10170 65 64 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 ed by a call to
10180 43 0a 2a 2a 20 20 20 20 20 66 75 6e 63 74 69 6f C.** functio
10190 6e 20 6c 69 6b 65 46 75 6e 63 2e 20 41 72 67 75 n likeFunc. Argu
101a0 6d 65 6e 74 20 70 41 72 67 20 69 73 20 63 61 73 ment pArg is cas
101b0 74 20 74 6f 20 61 20 28 76 6f 69 64 20 2a 29 20 t to a (void *)
101c0 61 6e 64 20 6d 61 64 65 0a 2a 2a 20 20 20 20 20 and made.**
101d0 61 76 61 69 6c 61 62 6c 65 20 61 73 20 74 68 65 available as the
101e0 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 72 2d 64 function user-d
101f0 61 74 61 20 28 73 71 6c 69 74 65 33 5f 75 73 65 ata (sqlite3_use
10200 72 5f 64 61 74 61 28 29 29 2e 20 54 68 65 0a 2a r_data()). The.*
10210 2a 20 20 20 20 20 46 75 6e 63 44 65 66 2e 66 6c * FuncDef.fl
10220 61 67 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 ags variable is
10230 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 set to the value
10240 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 66 passed as the f
10250 6c 61 67 73 0a 2a 2a 20 20 20 20 20 70 61 72 61 lags.** para
10260 6d 65 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e meter..*/.#defin
10270 65 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 e FUNCTION(zName
10280 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
10290 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e C, xFunc) \. {n
102a0 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 Arg, SQLITE_FUNC
102b0 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 _CONSTANT|SQLITE
102c0 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 _UTF8|(bNC*SQLIT
102d0 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 E_FUNC_NEEDCOLL)
102e0 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e , \. SQLITE_IN
102f0 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 T_TO_PTR(iArg),
10300 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 0, xFunc, 0, #zN
10310 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 ame, {0} }.#defi
10320 6e 65 20 56 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 ne VFUNCTION(zNa
10330 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 me, nArg, iArg,
10340 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 bNC, xFunc) \.
10350 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 {nArg, SQLITE_UT
10360 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 F8|(bNC*SQLITE_F
10370 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c UNC_NEEDCOLL), \
10380 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 . SQLITE_INT_T
10390 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 O_PTR(iArg), 0,
103a0 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 xFunc, 0, #zName
103b0 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 , {0} }.#define
103c0 44 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c DFUNCTION(zName,
103d0 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 nArg, iArg, bNC
103e0 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 , xFunc) \. {nA
103f0 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f rg, SQLITE_FUNC_
10400 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f 55 SLOCHNG|SQLITE_U
10410 54 46 38 2c 20 5c 0a 20 20 20 30 2c 20 30 2c 20 TF8, \. 0, 0,
10420 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 xFunc, 0, #zName
10430 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 , {0} }.#define
10440 50 55 52 45 5f 44 41 54 45 28 7a 4e 61 6d 65 2c PURE_DATE(zName,
10450 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 nArg, iArg, bNC
10460 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 , xFunc) \. {nA
10470 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f rg, SQLITE_FUNC_
10480 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f 55 SLOCHNG|SQLITE_U
10490 54 46 38 7c 53 51 4c 49 54 45 5f 46 55 4e 43 5f TF8|SQLITE_FUNC_
104a0 43 4f 4e 53 54 41 4e 54 2c 20 5c 0a 20 20 20 28 CONSTANT, \. (
104b0 76 6f 69 64 2a 29 26 73 71 6c 69 74 65 33 43 6f void*)&sqlite3Co
104c0 6e 66 69 67 2c 20 30 2c 20 78 46 75 6e 63 2c 20 nfig, 0, xFunc,
104d0 30 2c 20 23 7a 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0, #zName, {0} }
104e0 0a 23 64 65 66 69 6e 65 20 46 55 4e 43 54 49 4f .#define FUNCTIO
104f0 4e 32 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 N2(zName, nArg,
10500 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 iArg, bNC, xFunc
10510 2c 20 65 78 74 72 61 46 6c 61 67 73 29 20 5c 0a , extraFlags) \.
10520 20 20 7b 6e 41 72 67 2c 53 51 4c 49 54 45 5f 46 {nArg,SQLITE_F
10530 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c UNC_CONSTANT|SQL
10540 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 ITE_UTF8|(bNC*SQ
10550 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f LITE_FUNC_NEEDCO
10560 4c 4c 29 7c 65 78 74 72 61 46 6c 61 67 73 2c 5c LL)|extraFlags,\
10570 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 . SQLITE_INT_T
10580 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 O_PTR(iArg), 0,
10590 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 xFunc, 0, #zName
105a0 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 , {0} }.#define
105b0 53 54 52 5f 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 STR_FUNCTION(zNa
105c0 6d 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 me, nArg, pArg,
105d0 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 bNC, xFunc) \.
105e0 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 {nArg, SQLITE_FU
105f0 4e 43 5f 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 54 NC_SLOCHNG|SQLIT
10600 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 E_UTF8|(bNC*SQLI
10610 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
10620 29 2c 20 5c 0a 20 20 20 70 41 72 67 2c 20 30 2c ), \. pArg, 0,
10630 20 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d xFunc, 0, #zNam
10640 65 2c 20 7d 0a 23 64 65 66 69 6e 65 20 4c 49 4b e, }.#define LIK
10650 45 46 55 4e 43 28 7a 4e 61 6d 65 2c 20 6e 41 72 EFUNC(zName, nAr
10660 67 2c 20 61 72 67 2c 20 66 6c 61 67 73 29 20 5c g, arg, flags) \
10670 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 . {nArg, SQLITE
10680 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 _FUNC_CONSTANT|S
10690 51 4c 49 54 45 5f 55 54 46 38 7c 66 6c 61 67 73 QLITE_UTF8|flags
106a0 2c 20 5c 0a 20 20 20 28 76 6f 69 64 20 2a 29 61 , \. (void *)a
106b0 72 67 2c 20 30 2c 20 6c 69 6b 65 46 75 6e 63 2c rg, 0, likeFunc,
106c0 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 7b 30 7d 20 0, #zName, {0}
106d0 7d 0a 23 64 65 66 69 6e 65 20 41 47 47 52 45 47 }.#define AGGREG
106e0 41 54 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c ATE(zName, nArg,
106f0 20 61 72 67 2c 20 6e 63 2c 20 78 53 74 65 70 2c arg, nc, xStep,
10700 20 78 46 69 6e 61 6c 29 20 5c 0a 20 20 7b 6e 41 xFinal) \. {nA
10710 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 7c rg, SQLITE_UTF8|
10720 28 6e 63 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f (nc*SQLITE_FUNC_
10730 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 NEEDCOLL), \.
10740 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 SQLITE_INT_TO_PT
10750 52 28 61 72 67 29 2c 20 30 2c 20 78 53 74 65 70 R(arg), 0, xStep
10760 2c 78 46 69 6e 61 6c 2c 23 7a 4e 61 6d 65 2c 20 ,xFinal,#zName,
10770 7b 30 7d 7d 0a 23 64 65 66 69 6e 65 20 41 47 47 {0}}.#define AGG
10780 52 45 47 41 54 45 32 28 7a 4e 61 6d 65 2c 20 6e REGATE2(zName, n
10790 41 72 67 2c 20 61 72 67 2c 20 6e 63 2c 20 78 53 Arg, arg, nc, xS
107a0 74 65 70 2c 20 78 46 69 6e 61 6c 2c 20 65 78 74 tep, xFinal, ext
107b0 72 61 46 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 raFlags) \. {nA
107c0 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 7c rg, SQLITE_UTF8|
107d0 28 6e 63 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f (nc*SQLITE_FUNC_
107e0 4e 45 45 44 43 4f 4c 4c 29 7c 65 78 74 72 61 46 NEEDCOLL)|extraF
107f0 6c 61 67 73 2c 20 5c 0a 20 20 20 53 51 4c 49 54 lags, \. SQLIT
10800 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 61 72 67 E_INT_TO_PTR(arg
10810 29 2c 20 30 2c 20 78 53 74 65 70 2c 78 46 69 6e ), 0, xStep,xFin
10820 61 6c 2c 23 7a 4e 61 6d 65 2c 20 7b 30 7d 7d 0a al,#zName, {0}}.
10830 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 75 72 72 65 ./*.** All curre
10840 6e 74 20 73 61 76 65 70 6f 69 6e 74 73 20 61 72 nt savepoints ar
10850 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 6c 69 e stored in a li
10860 6e 6b 65 64 20 6c 69 73 74 20 73 74 61 72 74 69 nked list starti
10870 6e 67 20 61 74 0a 2a 2a 20 73 71 6c 69 74 65 33 ng at.** sqlite3
10880 2e 70 53 61 76 65 70 6f 69 6e 74 2e 20 54 68 65 .pSavepoint. The
10890 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 69 first element i
108a0 6e 20 74 68 65 20 6c 69 73 74 20 69 73 20 74 68 n the list is th
108b0 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 0a e most recently.
108c0 2a 2a 20 6f 70 65 6e 65 64 20 73 61 76 65 70 6f ** opened savepo
108d0 69 6e 74 2e 20 53 61 76 65 70 6f 69 6e 74 73 20 int. Savepoints
108e0 61 72 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 are added to the
108f0 20 6c 69 73 74 20 62 79 20 74 68 65 20 76 64 62 list by the vdb
10900 65 0a 2a 2a 20 4f 50 5f 53 61 76 65 70 6f 69 6e e.** OP_Savepoin
10910 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a t instruction..*
10920 2f 0a 73 74 72 75 63 74 20 53 61 76 65 70 6f 69 /.struct Savepoi
10930 6e 74 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 nt {. char *zNa
10940 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 me;
10950 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 61 /* Sa
10960 76 65 70 6f 69 6e 74 20 6e 61 6d 65 20 28 6e 75 vepoint name (nu
10970 6c 2d 74 65 72 6d 69 6e 61 74 65 64 29 20 2a 2f l-terminated) */
10980 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 65 64 . i64 nDeferred
10990 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 Cons;
109a0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
109b0 20 6f 66 20 64 65 66 65 72 72 65 64 20 66 6b 20 of deferred fk
109c0 76 69 6f 6c 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 violations */.
109d0 69 36 34 20 6e 44 65 66 65 72 72 65 64 49 6d 6d i64 nDeferredImm
109e0 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 Cons;
109f0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
10a00 20 64 65 66 65 72 72 65 64 20 69 6d 6d 20 66 6b deferred imm fk
10a10 2e 20 2a 2f 0a 20 20 53 61 76 65 70 6f 69 6e 74 . */. Savepoint
10a20 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 *pNext;
10a30 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
10a40 72 65 6e 74 20 73 61 76 65 70 6f 69 6e 74 20 28 rent savepoint (
10a50 69 66 20 61 6e 79 29 20 2a 2f 0a 7d 3b 0a 0a 2f if any) */.};../
10a60 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
10a70 6e 67 20 61 72 65 20 75 73 65 64 20 61 73 20 74 ng are used as t
10a80 68 65 20 73 65 63 6f 6e 64 20 70 61 72 61 6d 65 he second parame
10a90 74 65 72 20 74 6f 20 73 71 6c 69 74 65 33 53 61 ter to sqlite3Sa
10aa0 76 65 70 6f 69 6e 74 28 29 2c 0a 2a 2a 20 61 6e vepoint(),.** an
10ab0 64 20 61 73 20 74 68 65 20 50 31 20 61 72 67 75 d as the P1 argu
10ac0 6d 65 6e 74 20 74 6f 20 74 68 65 20 4f 50 5f 53 ment to the OP_S
10ad0 61 76 65 70 6f 69 6e 74 20 69 6e 73 74 72 75 63 avepoint instruc
10ae0 74 69 6f 6e 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 tion..*/.#define
10af0 20 53 41 56 45 50 4f 49 4e 54 5f 42 45 47 49 4e SAVEPOINT_BEGIN
10b00 20 20 20 20 20 20 30 0a 23 64 65 66 69 6e 65 20 0.#define
10b10 53 41 56 45 50 4f 49 4e 54 5f 52 45 4c 45 41 53 SAVEPOINT_RELEAS
10b20 45 20 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 E 1.#define S
10b30 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 41 43 AVEPOINT_ROLLBAC
10b40 4b 20 20 20 32 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 K 2.../*.** Ea
10b50 63 68 20 53 51 4c 69 74 65 20 6d 6f 64 75 6c 65 ch SQLite module
10b60 20 28 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 (virtual table
10b70 64 65 66 69 6e 69 74 69 6f 6e 29 20 69 73 20 64 definition) is d
10b80 65 66 69 6e 65 64 20 62 79 20 61 6e 0a 2a 2a 20 efined by an.**
10b90 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
10ba0 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
10bb0 75 72 65 2c 20 73 74 6f 72 65 64 20 69 6e 20 74 ure, stored in t
10bc0 68 65 20 73 71 6c 69 74 65 33 2e 61 4d 6f 64 75 he sqlite3.aModu
10bd0 6c 65 0a 2a 2a 20 68 61 73 68 20 74 61 62 6c 65 le.** hash table
10be0 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4d 6f 64 75 ..*/.struct Modu
10bf0 6c 65 20 7b 0a 20 20 63 6f 6e 73 74 20 73 71 6c le {. const sql
10c00 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f ite3_module *pMo
10c10 64 75 6c 65 3b 20 20 20 20 20 20 20 2f 2a 20 43 dule; /* C
10c20 61 6c 6c 62 61 63 6b 20 70 6f 69 6e 74 65 72 73 allback pointers
10c30 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
10c40 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 *zName;
10c50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 /* Na
10c60 6d 65 20 70 61 73 73 65 64 20 74 6f 20 63 72 65 me passed to cre
10c70 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a ate_module() */.
10c80 20 20 76 6f 69 64 20 2a 70 41 75 78 3b 20 20 20 void *pAux;
10c90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ca0 20 20 20 20 20 20 20 2f 2a 20 70 41 75 78 20 70 /* pAux p
10cb0 61 73 73 65 64 20 74 6f 20 63 72 65 61 74 65 5f assed to create_
10cc0 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a 20 20 76 6f module() */. vo
10cd0 69 64 20 28 2a 78 44 65 73 74 72 6f 79 29 28 76 id (*xDestroy)(v
10ce0 6f 69 64 20 2a 29 3b 20 20 20 20 20 20 20 20 20 oid *);
10cf0 20 20 20 2f 2a 20 4d 6f 64 75 6c 65 20 64 65 73 /* Module des
10d00 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e tructor function
10d10 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 45 70 */. Table *pEp
10d20 6f 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 oTab;
10d30 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 70 /* Ep
10d40 6f 6e 79 6d 6f 75 73 20 74 61 62 6c 65 20 66 6f onymous table fo
10d50 72 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 2a 2f r this module */
10d60 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 69 6e 66 6f 72 .};../*.** infor
10d70 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 65 61 63 mation about eac
10d80 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 61 6e 20 53 h column of an S
10d90 51 4c 20 74 61 62 6c 65 20 69 73 20 68 65 6c 64 QL table is held
10da0 20 69 6e 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a in an instance.
10db0 2a 2a 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 ** of this struc
10dc0 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ture..*/.struct
10dd0 43 6f 6c 75 6d 6e 20 7b 0a 20 20 63 68 61 72 20 Column {. char
10de0 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 2f 2a 20 4e *zName; /* N
10df0 61 6d 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 ame of this colu
10e00 6d 6e 2c 20 5c 30 30 30 2c 20 74 68 65 6e 20 74 mn, \000, then t
10e10 68 65 20 74 79 70 65 20 2a 2f 0a 20 20 45 78 70 he type */. Exp
10e20 72 20 2a 70 44 66 6c 74 3b 20 20 20 20 20 2f 2a r *pDflt; /*
10e30 20 44 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f Default value o
10e40 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f f this column */
10e50 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6c 6c 3b 20 . char *zColl;
10e60 20 20 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 /* Collating
10e70 20 73 65 71 75 65 6e 63 65 2e 20 20 49 66 20 4e sequence. If N
10e80 55 4c 4c 2c 20 75 73 65 20 74 68 65 20 64 65 66 ULL, use the def
10e90 61 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6e 6f 74 ault */. u8 not
10ea0 4e 75 6c 6c 3b 20 20 20 20 20 20 2f 2a 20 41 6e Null; /* An
10eb0 20 4f 45 5f 20 63 6f 64 65 20 66 6f 72 20 68 61 OE_ code for ha
10ec0 6e 64 6c 69 6e 67 20 61 20 4e 4f 54 20 4e 55 4c ndling a NOT NUL
10ed0 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a L constraint */.
10ee0 20 20 63 68 61 72 20 61 66 66 69 6e 69 74 79 3b char affinity;
10ef0 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 /* One of the
10f00 20 53 51 4c 49 54 45 5f 41 46 46 5f 2e 2e 2e 20 SQLITE_AFF_...
10f10 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 38 20 73 values */. u8 s
10f20 7a 45 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 zEst; /*
10f30 45 73 74 69 6d 61 74 65 64 20 73 69 7a 65 20 6f Estimated size o
10f40 66 20 76 61 6c 75 65 20 69 6e 20 74 68 69 73 20 f value in this
10f50 63 6f 6c 75 6d 6e 2e 20 73 69 7a 65 6f 66 28 49 column. sizeof(I
10f60 4e 54 29 3d 3d 31 20 2a 2f 0a 20 20 75 38 20 63 NT)==1 */. u8 c
10f70 6f 6c 46 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 olFlags; /*
10f80 42 6f 6f 6c 65 61 6e 20 70 72 6f 70 65 72 74 69 Boolean properti
10f90 65 73 2e 20 20 53 65 65 20 43 4f 4c 46 4c 41 47 es. See COLFLAG
10fa0 5f 20 64 65 66 69 6e 65 73 20 62 65 6c 6f 77 20 _ defines below
10fb0 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 */.};../* Allowe
10fc0 64 20 76 61 6c 75 65 73 20 66 6f 72 20 43 6f 6c d values for Col
10fd0 75 6d 6e 2e 63 6f 6c 46 6c 61 67 73 3a 0a 2a 2f umn.colFlags:.*/
10fe0 0a 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 .#define COLFLAG
10ff0 5f 50 52 49 4d 4b 45 59 20 20 30 78 30 30 30 31 _PRIMKEY 0x0001
11000 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 69 73 /* Column is
11010 20 70 61 72 74 20 6f 66 20 74 68 65 20 70 72 69 part of the pri
11020 6d 61 72 79 20 6b 65 79 20 2a 2f 0a 23 64 65 66 mary key */.#def
11030 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 ine COLFLAG_HIDD
11040 45 4e 20 20 20 30 78 30 30 30 32 20 20 20 20 2f EN 0x0002 /
11050 2a 20 41 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d * A hidden colum
11060 6e 20 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 n in a virtual t
11070 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 able */.#define
11080 43 4f 4c 46 4c 41 47 5f 48 41 53 54 59 50 45 20 COLFLAG_HASTYPE
11090 20 30 78 30 30 30 34 20 20 20 20 2f 2a 20 54 79 0x0004 /* Ty
110a0 70 65 20 6e 61 6d 65 20 66 6f 6c 6c 6f 77 73 20 pe name follows
110b0 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 2a 2f 0a 23 column name */.#
110c0 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 55 define COLFLAG_U
110d0 4e 49 51 55 45 20 20 20 30 78 30 30 30 38 20 20 NIQUE 0x0008
110e0 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 64 65 66 20 /* Column def
110f0 63 6f 6e 74 61 69 6e 73 20 22 55 4e 49 51 55 45 contains "UNIQUE
11100 22 20 6f 72 20 22 50 4b 22 20 2a 2f 0a 23 64 65 " or "PK" */.#de
11110 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 53 4f 52 fine COLFLAG_SOR
11120 54 45 52 52 45 46 20 30 78 30 30 31 30 20 20 20 TERREF 0x0010
11130 2f 2a 20 55 73 65 20 73 6f 72 74 65 72 2d 72 65 /* Use sorter-re
11140 66 73 20 77 69 74 68 20 74 68 69 73 20 63 6f 6c fs with this col
11150 75 6d 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 umn */../*.** A
11160 22 43 6f 6c 6c 61 74 69 6e 67 20 53 65 71 75 65 "Collating Seque
11170 6e 63 65 22 20 69 73 20 64 65 66 69 6e 65 64 20 nce" is defined
11180 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f by an instance o
11190 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a f the following.
111a0 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 20 43 6f ** structure. Co
111b0 6e 63 65 70 74 75 61 6c 6c 79 2c 20 61 20 63 6f nceptually, a co
111c0 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
111d0 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 6e consists of a n
111e0 61 6d 65 20 61 6e 64 0a 2a 2a 20 61 20 63 6f 6d ame and.** a com
111f0 70 61 72 69 73 6f 6e 20 72 6f 75 74 69 6e 65 20 parison routine
11200 74 68 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 that defines the
11210 20 6f 72 64 65 72 20 6f 66 20 74 68 61 74 20 73 order of that s
11220 65 71 75 65 6e 63 65 2e 0a 2a 2a 0a 2a 2a 20 49 equence..**.** I
11230 66 20 43 6f 6c 6c 53 65 71 2e 78 43 6d 70 20 69 f CollSeq.xCmp i
11240 73 20 4e 55 4c 4c 2c 20 69 74 20 6d 65 61 6e 73 s NULL, it means
11250 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 63 6f 6c that the.** col
11260 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 lating sequence
11270 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 20 49 is undefined. I
11280 6e 64 69 63 65 73 20 62 75 69 6c 74 20 6f 6e 20 ndices built on
11290 61 6e 20 75 6e 64 65 66 69 6e 65 64 0a 2a 2a 20 an undefined.**
112a0 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
112b0 63 65 20 6d 61 79 20 6e 6f 74 20 62 65 20 72 65 ce may not be re
112c0 61 64 20 6f 72 20 77 72 69 74 74 65 6e 2e 0a 2a ad or written..*
112d0 2f 0a 73 74 72 75 63 74 20 43 6f 6c 6c 53 65 71 /.struct CollSeq
112e0 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 {. char *zName
112f0 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 ; /* Na
11300 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 6c 61 74 me of the collat
11310 69 6e 67 20 73 65 71 75 65 6e 63 65 2c 20 55 54 ing sequence, UT
11320 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 F-8 encoded */.
11330 20 75 38 20 65 6e 63 3b 20 20 20 20 20 20 20 20 u8 enc;
11340 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 65 /* Text e
11350 6e 63 6f 64 69 6e 67 20 68 61 6e 64 6c 65 64 20 ncoding handled
11360 62 79 20 78 43 6d 70 28 29 20 2a 2f 0a 20 20 76 by xCmp() */. v
11370 6f 69 64 20 2a 70 55 73 65 72 3b 20 20 20 20 20 oid *pUser;
11380 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
11390 67 75 6d 65 6e 74 20 74 6f 20 78 43 6d 70 28 29 gument to xCmp()
113a0 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 6d 70 */. int (*xCmp
113b0 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 20 63 6f 6e )(void*,int, con
113c0 73 74 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 63 st void*, int, c
113d0 6f 6e 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 76 onst void*);. v
113e0 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 oid (*xDel)(void
113f0 2a 29 3b 20 20 2f 2a 20 44 65 73 74 72 75 63 74 *); /* Destruct
11400 6f 72 20 66 6f 72 20 70 55 73 65 72 20 2a 2f 0a or for pUser */.
11410 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 6f 72 74 };../*.** A sort
11420 20 6f 72 64 65 72 20 63 61 6e 20 62 65 20 65 69 order can be ei
11430 74 68 65 72 20 41 53 43 20 6f 72 20 44 45 53 43 ther ASC or DESC
11440 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
11450 49 54 45 5f 53 4f 5f 41 53 43 20 20 20 20 20 20 ITE_SO_ASC
11460 20 30 20 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 0 /* Sort in a
11470 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a scending order *
11480 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
11490 5f 53 4f 5f 44 45 53 43 20 20 20 20 20 20 31 20 _SO_DESC 1
114a0 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 65 /* Sort in asce
114b0 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 23 nding order */.#
114c0 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 4f define SQLITE_SO
114d0 5f 55 4e 44 45 46 49 4e 45 44 20 2d 31 20 2f 2a _UNDEFINED -1 /*
114e0 20 4e 6f 20 73 6f 72 74 20 6f 72 64 65 72 20 73 No sort order s
114f0 70 65 63 69 66 69 65 64 20 2a 2f 0a 0a 2f 2a 0a pecified */../*.
11500 2a 2a 20 43 6f 6c 75 6d 6e 20 61 66 66 69 6e 69 ** Column affini
11510 74 79 20 74 79 70 65 73 2e 0a 2a 2a 0a 2a 2a 20 ty types..**.**
11520 54 68 65 73 65 20 75 73 65 64 20 74 6f 20 68 61 These used to ha
11530 76 65 20 6d 6e 65 6d 6f 6e 69 63 20 6e 61 6d 65 ve mnemonic name
11540 20 6c 69 6b 65 20 27 69 27 20 66 6f 72 20 53 51 like 'i' for SQ
11550 4c 49 54 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 LITE_AFF_INTEGER
11560 20 61 6e 64 0a 2a 2a 20 27 74 27 20 66 6f 72 20 and.** 't' for
11570 53 51 4c 49 54 45 5f 41 46 46 5f 54 45 58 54 2e SQLITE_AFF_TEXT.
11580 20 20 42 75 74 20 77 65 20 63 61 6e 20 73 61 76 But we can sav
11590 65 20 61 20 6c 69 74 74 6c 65 20 73 70 61 63 65 e a little space
115a0 20 61 6e 64 20 69 6d 70 72 6f 76 65 0a 2a 2a 20 and improve.**
115b0 74 68 65 20 73 70 65 65 64 20 61 20 6c 69 74 74 the speed a litt
115c0 6c 65 20 62 79 20 6e 75 6d 62 65 72 69 6e 67 20 le by numbering
115d0 74 68 65 20 76 61 6c 75 65 73 20 63 6f 6e 73 65 the values conse
115e0 63 75 74 69 76 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 cutively..**.**
115f0 42 75 74 20 72 61 74 68 65 72 20 74 68 61 6e 20 But rather than
11600 73 74 61 72 74 20 77 69 74 68 20 30 20 6f 72 20 start with 0 or
11610 31 2c 20 77 65 20 62 65 67 69 6e 20 77 69 74 68 1, we begin with
11620 20 27 41 27 2e 20 20 54 68 61 74 20 77 61 79 2c 'A'. That way,
11630 0a 2a 2a 20 77 68 65 6e 20 6d 75 6c 74 69 70 6c .** when multipl
11640 65 20 61 66 66 69 6e 69 74 79 20 74 79 70 65 73 e affinity types
11650 20 61 72 65 20 63 6f 6e 63 61 74 65 6e 61 74 65 are concatenate
11660 64 20 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 d into a string
11670 61 6e 64 0a 2a 2a 20 75 73 65 64 20 61 73 20 74 and.** used as t
11680 68 65 20 50 34 20 6f 70 65 72 61 6e 64 2c 20 74 he P4 operand, t
11690 68 65 79 20 77 69 6c 6c 20 62 65 20 6d 6f 72 65 hey will be more
116a0 20 72 65 61 64 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a readable..**.**
116b0 20 4e 6f 74 65 20 61 6c 73 6f 20 74 68 61 74 20 Note also that
116c0 74 68 65 20 6e 75 6d 65 72 69 63 20 74 79 70 65 the numeric type
116d0 73 20 61 72 65 20 67 72 6f 75 70 65 64 20 74 6f s are grouped to
116e0 67 65 74 68 65 72 20 73 6f 20 74 68 61 74 20 74 gether so that t
116f0 65 73 74 69 6e 67 0a 2a 2a 20 66 6f 72 20 61 20 esting.** for a
11700 6e 75 6d 65 72 69 63 20 74 79 70 65 20 69 73 20 numeric type is
11710 61 20 73 69 6e 67 6c 65 20 63 6f 6d 70 61 72 69 a single compari
11720 73 6f 6e 2e 20 20 41 6e 64 20 74 68 65 20 42 4c son. And the BL
11730 4f 42 20 74 79 70 65 20 69 73 20 66 69 72 73 74 OB type is first
11740 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
11750 49 54 45 5f 41 46 46 5f 42 4c 4f 42 20 20 20 20 ITE_AFF_BLOB
11760 20 27 41 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 'A'.#define SQL
11770 49 54 45 5f 41 46 46 5f 54 45 58 54 20 20 20 20 ITE_AFF_TEXT
11780 20 27 42 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 'B'.#define SQL
11790 49 54 45 5f 41 46 46 5f 4e 55 4d 45 52 49 43 20 ITE_AFF_NUMERIC
117a0 20 27 43 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 'C'.#define SQL
117b0 49 54 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 20 ITE_AFF_INTEGER
117c0 20 27 44 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 'D'.#define SQL
117d0 49 54 45 5f 41 46 46 5f 52 45 41 4c 20 20 20 20 ITE_AFF_REAL
117e0 20 27 45 27 0a 0a 23 64 65 66 69 6e 65 20 73 71 'E'..#define sq
117f0 6c 69 74 65 33 49 73 4e 75 6d 65 72 69 63 41 66 lite3IsNumericAf
11800 66 69 6e 69 74 79 28 58 29 20 20 28 28 58 29 3e finity(X) ((X)>
11810 3d 53 51 4c 49 54 45 5f 41 46 46 5f 4e 55 4d 45 =SQLITE_AFF_NUME
11820 52 49 43 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 RIC)../*.** The
11830 53 51 4c 49 54 45 5f 41 46 46 5f 4d 41 53 4b 20 SQLITE_AFF_MASK
11840 76 61 6c 75 65 73 20 6d 61 73 6b 73 20 6f 66 66 values masks off
11850 20 74 68 65 20 73 69 67 6e 69 66 69 63 61 6e 74 the significant
11860 20 62 69 74 73 20 6f 66 20 61 6e 0a 2a 2a 20 61 bits of an.** a
11870 66 66 69 6e 69 74 79 20 76 61 6c 75 65 2e 0a 2a ffinity value..*
11880 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
11890 5f 41 46 46 5f 4d 41 53 4b 20 20 20 20 20 30 78 _AFF_MASK 0x
118a0 34 37 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 69 74 69 47../*.** Additi
118b0 6f 6e 61 6c 20 62 69 74 20 76 61 6c 75 65 73 20 onal bit values
118c0 74 68 61 74 20 63 61 6e 20 62 65 20 4f 52 65 64 that can be ORed
118d0 20 77 69 74 68 20 61 6e 20 61 66 66 69 6e 69 74 with an affinit
118e0 79 20 77 69 74 68 6f 75 74 0a 2a 2a 20 63 68 61 y without.** cha
118f0 6e 67 69 6e 67 20 74 68 65 20 61 66 66 69 6e 69 nging the affini
11900 74 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 53 51 ty..**.** The SQ
11910 4c 49 54 45 5f 4e 4f 54 4e 55 4c 4c 20 66 6c 61 LITE_NOTNULL fla
11920 67 20 69 73 20 61 20 63 6f 6d 62 69 6e 61 74 69 g is a combinati
11930 6f 6e 20 6f 66 20 4e 55 4c 4c 45 51 20 61 6e 64 on of NULLEQ and
11940 20 4a 55 4d 50 49 46 4e 55 4c 4c 2e 0a 2a 2a 20 JUMPIFNULL..**
11950 49 74 20 63 61 75 73 65 73 20 61 6e 20 61 73 73 It causes an ass
11960 65 72 74 28 29 20 74 6f 20 66 69 72 65 20 69 66 ert() to fire if
11970 20 65 69 74 68 65 72 20 6f 70 65 72 61 6e 64 20 either operand
11980 74 6f 20 61 20 63 6f 6d 70 61 72 69 73 6f 6e 0a to a comparison.
11990 2a 2a 20 6f 70 65 72 61 74 6f 72 20 69 73 20 4e ** operator is N
119a0 55 4c 4c 2e 20 20 49 74 20 69 73 20 61 64 64 65 ULL. It is adde
119b0 64 20 74 6f 20 63 65 72 74 61 69 6e 20 63 6f 6d d to certain com
119c0 70 61 72 69 73 6f 6e 20 6f 70 65 72 61 74 6f 72 parison operator
119d0 73 20 74 6f 0a 2a 2a 20 70 72 6f 76 65 20 74 68 s to.** prove th
119e0 61 74 20 74 68 65 20 6f 70 65 72 61 6e 64 73 20 at the operands
119f0 61 72 65 20 61 6c 77 61 79 73 20 4e 4f 54 20 4e are always NOT N
11a00 55 4c 4c 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ULL..*/.#define
11a10 53 51 4c 49 54 45 5f 4b 45 45 50 4e 55 4c 4c 20 SQLITE_KEEPNULL
11a20 20 20 20 20 30 78 30 38 20 20 2f 2a 20 55 73 65 0x08 /* Use
11a30 64 20 62 79 20 76 65 63 74 6f 72 20 3d 3d 20 6f d by vector == o
11a40 72 20 3c 3e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 r <> */.#define
11a50 53 51 4c 49 54 45 5f 4a 55 4d 50 49 46 4e 55 4c SQLITE_JUMPIFNUL
11a60 4c 20 20 20 30 78 31 30 20 20 2f 2a 20 6a 75 6d L 0x10 /* jum
11a70 70 73 20 69 66 20 65 69 74 68 65 72 20 6f 70 65 ps if either ope
11a80 72 61 6e 64 20 69 73 20 4e 55 4c 4c 20 2a 2f 0a rand is NULL */.
11a90 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
11aa0 54 4f 52 45 50 32 20 20 20 20 20 20 30 78 32 30 TOREP2 0x20
11ab0 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c /* Store resul
11ac0 74 20 69 6e 20 72 65 67 5b 50 32 5d 20 72 61 74 t in reg[P2] rat
11ad0 68 65 72 20 74 68 61 6e 20 6a 75 6d 70 20 2a 2f her than jump */
11ae0 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
11af0 4e 55 4c 4c 45 51 20 20 20 20 20 20 20 30 78 38 NULLEQ 0x8
11b00 30 20 20 2f 2a 20 4e 55 4c 4c 3d 4e 55 4c 4c 20 0 /* NULL=NULL
11b10 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
11b20 45 5f 4e 4f 54 4e 55 4c 4c 20 20 20 20 20 20 30 E_NOTNULL 0
11b30 78 39 30 20 20 2f 2a 20 41 73 73 65 72 74 20 74 x90 /* Assert t
11b40 68 61 74 20 6f 70 65 72 61 6e 64 73 20 61 72 65 hat operands are
11b50 20 6e 65 76 65 72 20 4e 55 4c 4c 20 2a 2f 0a 0a never NULL */..
11b60 2f 2a 0a 2a 2a 20 41 6e 20 6f 62 6a 65 63 74 20 /*.** An object
11b70 6f 66 20 74 68 69 73 20 74 79 70 65 20 69 73 20 of this type is
11b80 63 72 65 61 74 65 64 20 66 6f 72 20 65 61 63 68 created for each
11b90 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 70 virtual table p
11ba0 72 65 73 65 6e 74 20 69 6e 0a 2a 2a 20 74 68 65 resent in.** the
11bb0 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
11bc0 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 64 ..**.** If the d
11bd0 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 atabase schema i
11be0 73 20 73 68 61 72 65 64 2c 20 74 68 65 6e 20 74 s shared, then t
11bf0 68 65 72 65 20 69 73 20 6f 6e 65 20 69 6e 73 74 here is one inst
11c00 61 6e 63 65 20 6f 66 20 74 68 69 73 0a 2a 2a 20 ance of this.**
11c10 73 74 72 75 63 74 75 72 65 20 66 6f 72 20 65 61 structure for ea
11c20 63 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e ch database conn
11c30 65 63 74 69 6f 6e 20 28 73 71 6c 69 74 65 33 2a ection (sqlite3*
11c40 29 20 74 68 61 74 20 75 73 65 73 20 74 68 65 20 ) that uses the
11c50 73 68 61 72 65 64 0a 2a 2a 20 73 63 68 65 6d 61 shared.** schema
11c60 2e 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73 . This is becaus
11c70 65 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20 e each database
11c80 63 6f 6e 6e 65 63 74 69 6f 6e 20 72 65 71 75 69 connection requi
11c90 72 65 73 20 69 74 73 20 6f 77 6e 20 75 6e 69 71 res its own uniq
11ca0 75 65 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f ue.** instance o
11cb0 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 f the sqlite3_vt
11cc0 61 62 2a 20 68 61 6e 64 6c 65 20 75 73 65 64 20 ab* handle used
11cd0 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 76 69 to access the vi
11ce0 72 74 75 61 6c 20 74 61 62 6c 65 0a 2a 2a 20 69 rtual table.** i
11cf0 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 73 mplementation. s
11d00 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e qlite3_vtab* han
11d10 64 6c 65 73 20 63 61 6e 20 6e 6f 74 20 62 65 20 dles can not be
11d20 73 68 61 72 65 64 20 62 65 74 77 65 65 6e 0a 2a shared between.*
11d30 2a 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 * database conne
11d40 63 74 69 6f 6e 73 2c 20 65 76 65 6e 20 77 68 65 ctions, even whe
11d50 6e 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 n the rest of th
11d60 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 e in-memory data
11d70 62 61 73 65 0a 2a 2a 20 73 63 68 65 6d 61 20 69 base.** schema i
11d80 73 20 73 68 61 72 65 64 2c 20 61 73 20 74 68 65 s shared, as the
11d90 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
11da0 6f 66 74 65 6e 20 73 74 6f 72 65 73 20 74 68 65 often stores the
11db0 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
11dc0 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 70 nection handle p
11dd0 61 73 73 65 64 20 74 6f 20 69 74 20 76 69 61 20 assed to it via
11de0 74 68 65 20 78 43 6f 6e 6e 65 63 74 28 29 20 6f the xConnect() o
11df0 72 20 78 43 72 65 61 74 65 28 29 20 6d 65 74 68 r xCreate() meth
11e00 6f 64 0a 2a 2a 20 64 75 72 69 6e 67 20 69 6e 69 od.** during ini
11e10 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 74 65 tialization inte
11e20 72 6e 61 6c 6c 79 2e 20 54 68 69 73 20 64 61 74 rnally. This dat
11e30 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
11e40 20 68 61 6e 64 6c 65 20 6d 61 79 0a 2a 2a 20 74 handle may.** t
11e50 68 65 6e 20 62 65 20 75 73 65 64 20 62 79 20 74 hen be used by t
11e60 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 he virtual table
11e70 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
11e80 74 6f 20 61 63 63 65 73 73 20 72 65 61 6c 20 74 to access real t
11e90 61 62 6c 65 73 0a 2a 2a 20 77 69 74 68 69 6e 20 ables.** within
11ea0 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 53 6f the database. So
11eb0 20 74 68 61 74 20 74 68 65 79 20 61 70 70 65 61 that they appea
11ec0 72 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 r as part of the
11ed0 20 63 61 6c 6c 65 72 73 0a 2a 2a 20 74 72 61 6e callers.** tran
11ee0 73 61 63 74 69 6f 6e 2c 20 74 68 65 73 65 20 61 saction, these a
11ef0 63 63 65 73 73 65 73 20 6e 65 65 64 20 74 6f 20 ccesses need to
11f00 62 65 20 6d 61 64 65 20 76 69 61 20 74 68 65 20 be made via the
11f10 73 61 6d 65 20 64 61 74 61 62 61 73 65 0a 2a 2a same database.**
11f20 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 73 20 74 connection as t
11f30 68 61 74 20 75 73 65 64 20 74 6f 20 65 78 65 63 hat used to exec
11f40 75 74 65 20 53 51 4c 20 6f 70 65 72 61 74 69 6f ute SQL operatio
11f50 6e 73 20 6f 6e 20 74 68 65 20 76 69 72 74 75 61 ns on the virtua
11f60 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 41 l table..**.** A
11f70 6c 6c 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 74 ll VTable object
11f80 73 20 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e s that correspon
11f90 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 74 61 d to a single ta
11fa0 62 6c 65 20 69 6e 20 61 20 73 68 61 72 65 64 0a ble in a shared.
11fb0 2a 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 65 ** database sche
11fc0 6d 61 20 61 72 65 20 69 6e 69 74 69 61 6c 6c 79 ma are initially
11fd0 20 73 74 6f 72 65 64 20 69 6e 20 61 20 6c 69 6e stored in a lin
11fe0 6b 65 64 2d 6c 69 73 74 20 70 6f 69 6e 74 65 64 ked-list pointed
11ff0 20 74 6f 20 62 79 0a 2a 2a 20 74 68 65 20 54 61 to by.** the Ta
12000 62 6c 65 2e 70 56 54 61 62 6c 65 20 6d 65 6d 62 ble.pVTable memb
12010 65 72 20 76 61 72 69 61 62 6c 65 20 6f 66 20 74 er variable of t
12020 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 he corresponding
12030 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 2e 0a 2a Table object..*
12040 2a 20 57 68 65 6e 20 61 6e 20 73 71 6c 69 74 65 * When an sqlite
12050 33 5f 70 72 65 70 61 72 65 28 29 20 6f 70 65 72 3_prepare() oper
12060 61 74 69 6f 6e 20 69 73 20 72 65 71 75 69 72 65 ation is require
12070 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 20 d to access the
12080 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 virtual.** table
12090 2c 20 69 74 20 73 65 61 72 63 68 65 73 20 74 68 , it searches th
120a0 65 20 6c 69 73 74 20 66 6f 72 20 74 68 65 20 56 e list for the V
120b0 54 61 62 6c 65 20 74 68 61 74 20 63 6f 72 72 65 Table that corre
120c0 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 0a 2a 2a sponds to the.**
120d0 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
120e0 74 69 6f 6e 20 64 6f 69 6e 67 20 74 68 65 20 70 tion doing the p
120f0 72 65 70 61 72 69 6e 67 20 73 6f 20 61 73 20 74 reparing so as t
12100 6f 20 75 73 65 20 74 68 65 20 63 6f 72 72 65 63 o use the correc
12110 74 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 76 74 61 t.** sqlite3_vta
12120 62 2a 20 68 61 6e 64 6c 65 20 69 6e 20 74 68 65 b* handle in the
12130 20 63 6f 6d 70 69 6c 65 64 20 71 75 65 72 79 2e compiled query.
12140 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 6e 20 69 .**.** When an i
12150 6e 2d 6d 65 6d 6f 72 79 20 54 61 62 6c 65 20 6f n-memory Table o
12160 62 6a 65 63 74 20 69 73 20 64 65 6c 65 74 65 64 bject is deleted
12170 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 20 77 68 (for example wh
12180 65 6e 20 74 68 65 0a 2a 2a 20 73 63 68 65 6d 61 en the.** schema
12190 20 69 73 20 62 65 69 6e 67 20 72 65 6c 6f 61 64 is being reload
121a0 65 64 20 66 6f 72 20 73 6f 6d 65 20 72 65 61 73 ed for some reas
121b0 6f 6e 29 2c 20 74 68 65 20 56 54 61 62 6c 65 20 on), the VTable
121c0 6f 62 6a 65 63 74 73 20 61 72 65 20 6e 6f 74 0a objects are not.
121d0 2a 2a 20 64 65 6c 65 74 65 64 20 61 6e 64 20 74 ** deleted and t
121e0 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a he sqlite3_vtab*
121f0 20 68 61 6e 64 6c 65 73 20 61 72 65 20 6e 6f 74 handles are not
12200 20 78 44 69 73 63 6f 6e 6e 65 63 74 28 29 65 64 xDisconnect()ed
12210 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e .** immediately.
12220 20 49 6e 73 74 65 61 64 2c 20 74 68 65 79 20 61 Instead, they a
12230 72 65 20 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 re moved from th
12240 65 20 54 61 62 6c 65 2e 70 56 54 61 62 6c 65 20 e Table.pVTable
12250 6c 69 73 74 20 74 6f 0a 2a 2a 20 61 6e 6f 74 68 list to.** anoth
12260 65 72 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 68 er linked list h
12270 65 61 64 65 64 20 62 79 20 74 68 65 20 73 71 6c eaded by the sql
12280 69 74 65 33 2e 70 44 69 73 63 6f 6e 6e 65 63 74 ite3.pDisconnect
12290 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 0a 2a member of the.*
122a0 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 * corresponding
122b0 73 71 6c 69 74 65 33 20 73 74 72 75 63 74 75 72 sqlite3 structur
122c0 65 2e 20 54 68 65 79 20 61 72 65 20 74 68 65 6e e. They are then
122d0 20 64 65 6c 65 74 65 64 2f 78 44 69 73 63 6f 6e deleted/xDiscon
122e0 6e 65 63 74 65 64 0a 2a 2a 20 6e 65 78 74 20 74 nected.** next t
122f0 69 6d 65 20 61 20 73 74 61 74 65 6d 65 6e 74 20 ime a statement
12300 69 73 20 70 72 65 70 61 72 65 64 20 75 73 69 6e is prepared usin
12310 67 20 73 61 69 64 20 73 71 6c 69 74 65 33 2a 2e g said sqlite3*.
12320 20 54 68 69 73 20 69 73 20 64 6f 6e 65 0a 2a 2a This is done.**
12330 20 74 6f 20 61 76 6f 69 64 20 64 65 61 64 6c 6f to avoid deadlo
12340 63 6b 20 69 73 73 75 65 73 20 69 6e 76 6f 6c 76 ck issues involv
12350 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 73 71 6c ing multiple sql
12360 69 74 65 33 2e 6d 75 74 65 78 20 6d 75 74 65 78 ite3.mutex mutex
12370 65 73 2e 0a 2a 2a 20 52 65 66 65 72 20 74 6f 20 es..** Refer to
12380 63 6f 6d 6d 65 6e 74 73 20 61 62 6f 76 65 20 66 comments above f
12390 75 6e 63 74 69 6f 6e 20 73 71 6c 69 74 65 33 56 unction sqlite3V
123a0 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 29 20 tabUnlockList()
123b0 66 6f 72 20 61 6e 0a 2a 2a 20 65 78 70 6c 61 6e for an.** explan
123c0 61 74 69 6f 6e 20 61 73 20 74 6f 20 77 68 79 20 ation as to why
123d0 69 74 20 69 73 20 73 61 66 65 20 74 6f 20 61 64 it is safe to ad
123e0 64 20 61 6e 20 65 6e 74 72 79 20 74 6f 20 61 6e d an entry to an
123f0 20 73 71 6c 69 74 65 33 2e 70 44 69 73 63 6f 6e sqlite3.pDiscon
12400 6e 65 63 74 0a 2a 2a 20 6c 69 73 74 20 77 69 74 nect.** list wit
12410 68 6f 75 74 20 68 6f 6c 64 69 6e 67 20 74 68 65 hout holding the
12420 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 73 corresponding s
12430 71 6c 69 74 65 33 2e 6d 75 74 65 78 20 6d 75 74 qlite3.mutex mut
12440 65 78 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 65 ex..**.** The me
12450 6d 6f 72 79 20 66 6f 72 20 6f 62 6a 65 63 74 73 mory for objects
12460 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 69 73 of this type is
12470 20 61 6c 77 61 79 73 20 61 6c 6c 6f 63 61 74 65 always allocate
12480 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 44 d by.** sqlite3D
12490 62 4d 61 6c 6c 6f 63 28 29 2c 20 75 73 69 6e 67 bMalloc(), using
124a0 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 the connection
124b0 68 61 6e 64 6c 65 20 73 74 6f 72 65 64 20 69 6e handle stored in
124c0 20 56 54 61 62 6c 65 2e 64 62 20 61 73 0a 2a 2a VTable.db as.**
124d0 20 74 68 65 20 66 69 72 73 74 20 61 72 67 75 6d the first argum
124e0 65 6e 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56 ent..*/.struct V
124f0 54 61 62 6c 65 20 7b 0a 20 20 73 71 6c 69 74 65 Table {. sqlite
12500 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 20 3 *db;
12510 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
12520 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 73 73 6f 63 connection assoc
12530 69 61 74 65 64 20 77 69 74 68 20 74 68 69 73 20 iated with this
12540 74 61 62 6c 65 20 2a 2f 0a 20 20 4d 6f 64 75 6c table */. Modul
12550 65 20 2a 70 4d 6f 64 3b 20 20 20 20 20 20 20 20 e *pMod;
12560 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
12570 74 6f 20 6d 6f 64 75 6c 65 20 69 6d 70 6c 65 6d to module implem
12580 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 73 71 entation */. sq
12590 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 lite3_vtab *pVta
125a0 62 3b 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 b; /* Point
125b0 65 72 20 74 6f 20 76 74 61 62 20 69 6e 73 74 61 er to vtab insta
125c0 6e 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 nce */. int nRe
125d0 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 f;
125e0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
125f0 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 69 73 pointers to this
12600 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 structure */.
12610 75 38 20 62 43 6f 6e 73 74 72 61 69 6e 74 3b 20 u8 bConstraint;
12620 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
12630 65 20 69 66 20 63 6f 6e 73 74 72 61 69 6e 74 73 e if constraints
12640 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 20 2a are supported *
12650 2f 0a 20 20 69 6e 74 20 69 53 61 76 65 70 6f 69 /. int iSavepoi
12660 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a nt; /*
12670 20 44 65 70 74 68 20 6f 66 20 74 68 65 20 53 41 Depth of the SA
12680 56 45 50 4f 49 4e 54 20 73 74 61 63 6b 20 2a 2f VEPOINT stack */
12690 0a 20 20 56 54 61 62 6c 65 20 2a 70 4e 65 78 74 . VTable *pNext
126a0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
126b0 4e 65 78 74 20 69 6e 20 6c 69 6e 6b 65 64 20 6c Next in linked l
126c0 69 73 74 20 28 73 65 65 20 61 62 6f 76 65 29 20 ist (see above)
126d0 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 */.};../*.** The
126e0 20 73 63 68 65 6d 61 20 66 6f 72 20 65 61 63 68 schema for each
126f0 20 53 51 4c 20 74 61 62 6c 65 20 61 6e 64 20 76 SQL table and v
12700 69 65 77 20 69 73 20 72 65 70 72 65 73 65 6e 74 iew is represent
12710 65 64 20 69 6e 20 6d 65 6d 6f 72 79 0a 2a 2a 20 ed in memory.**
12720 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f by an instance o
12730 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
12740 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 structure..*/.st
12750 72 75 63 74 20 54 61 62 6c 65 20 7b 0a 20 20 63 ruct Table {. c
12760 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
12770 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
12780 68 65 20 74 61 62 6c 65 20 6f 72 20 76 69 65 77 he table or view
12790 20 2a 2f 0a 20 20 43 6f 6c 75 6d 6e 20 2a 61 43 */. Column *aC
127a0 6f 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 49 6e ol; /* In
127b0 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
127c0 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 each column */.
127d0 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 20 Index *pIndex;
127e0 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 /* List of
127f0 20 53 51 4c 20 69 6e 64 65 78 65 73 20 6f 6e 20 SQL indexes on
12800 74 68 69 73 20 74 61 62 6c 65 2e 20 2a 2f 0a 20 this table. */.
12810 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 Select *pSelect
12820 3b 20 20 20 20 20 2f 2a 20 4e 55 4c 4c 20 66 6f ; /* NULL fo
12830 72 20 74 61 62 6c 65 73 2e 20 20 50 6f 69 6e 74 r tables. Point
12840 73 20 74 6f 20 64 65 66 69 6e 69 74 69 6f 6e 20 s to definition
12850 69 66 20 61 20 76 69 65 77 2e 20 2a 2f 0a 20 20 if a view. */.
12860 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20 20 20 20 FKey *pFKey;
12870 20 20 20 20 20 2f 2a 20 4c 69 6e 6b 65 64 20 6c /* Linked l
12880 69 73 74 20 6f 66 20 61 6c 6c 20 66 6f 72 65 69 ist of all forei
12890 67 6e 20 6b 65 79 73 20 69 6e 20 74 68 69 73 20 gn keys in this
128a0 74 61 62 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 table */. char
128b0 2a 7a 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 20 *zColAff;
128c0 2f 2a 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 /* String defini
128d0 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 ng the affinity
128e0 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a of each column *
128f0 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 /. ExprList *pC
12900 68 65 63 6b 3b 20 20 20 20 2f 2a 20 41 6c 6c 20 heck; /* All
12910 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 CHECK constraint
12920 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 s */.
12930 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 /*
12940 20 2e 2e 2e 20 61 6c 73 6f 20 75 73 65 64 20 61 ... also used a
12950 73 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 6c 69 s column name li
12960 73 74 20 69 6e 20 61 20 56 49 45 57 20 2a 2f 0a st in a VIEW */.
12970 20 20 69 6e 74 20 74 6e 75 6d 3b 20 20 20 20 20 int tnum;
12980 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 20 42 /* Root B
12990 54 72 65 65 20 70 61 67 65 20 66 6f 72 20 74 68 Tree page for th
129a0 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 75 33 is table */. u3
129b0 32 20 6e 54 61 62 52 65 66 3b 20 20 20 20 20 20 2 nTabRef;
129c0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
129d0 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 68 69 73 pointers to this
129e0 20 54 61 62 6c 65 20 2a 2f 0a 20 20 75 33 32 20 Table */. u32
129f0 74 61 62 46 6c 61 67 73 3b 20 20 20 20 20 20 20 tabFlags;
12a00 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 54 46 5f 2a /* Mask of TF_*
12a10 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 69 31 36 values */. i16
12a20 20 69 50 4b 65 79 3b 20 20 20 20 20 20 20 20 20 iPKey;
12a30 20 20 2f 2a 20 49 66 20 6e 6f 74 20 6e 65 67 61 /* If not nega
12a40 74 69 76 65 2c 20 75 73 65 20 61 43 6f 6c 5b 69 tive, use aCol[i
12a50 50 4b 65 79 5d 20 61 73 20 74 68 65 20 72 6f 77 PKey] as the row
12a60 69 64 20 2a 2f 0a 20 20 69 31 36 20 6e 43 6f 6c id */. i16 nCol
12a70 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
12a80 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e Number of column
12a90 73 20 69 6e 20 74 68 69 73 20 74 61 62 6c 65 20 s in this table
12aa0 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 6e 52 6f 77 */. LogEst nRow
12ab0 4c 6f 67 45 73 74 3b 20 20 20 2f 2a 20 45 73 74 LogEst; /* Est
12ac0 69 6d 61 74 65 64 20 72 6f 77 73 20 69 6e 20 74 imated rows in t
12ad0 61 62 6c 65 20 2d 20 66 72 6f 6d 20 73 71 6c 69 able - from sqli
12ae0 74 65 5f 73 74 61 74 31 20 74 61 62 6c 65 20 2a te_stat1 table *
12af0 2f 0a 20 20 4c 6f 67 45 73 74 20 73 7a 54 61 62 /. LogEst szTab
12b00 52 6f 77 3b 20 20 20 20 20 2f 2a 20 45 73 74 69 Row; /* Esti
12b10 6d 61 74 65 64 20 73 69 7a 65 20 6f 66 20 65 61 mated size of ea
12b20 63 68 20 74 61 62 6c 65 20 72 6f 77 20 69 6e 20 ch table row in
12b30 62 79 74 65 73 20 2a 2f 0a 23 69 66 64 65 66 20 bytes */.#ifdef
12b40 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f SQLITE_ENABLE_CO
12b50 53 54 4d 55 4c 54 0a 20 20 4c 6f 67 45 73 74 20 STMULT. LogEst
12b60 63 6f 73 74 4d 75 6c 74 3b 20 20 20 20 20 2f 2a costMult; /*
12b70 20 43 6f 73 74 20 6d 75 6c 74 69 70 6c 69 65 72 Cost multiplier
12b80 20 66 6f 72 20 75 73 69 6e 67 20 74 68 69 73 20 for using this
12b90 74 61 62 6c 65 20 2a 2f 0a 23 65 6e 64 69 66 0a table */.#endif.
12ba0 20 20 75 38 20 6b 65 79 43 6f 6e 66 3b 20 20 20 u8 keyConf;
12bb0 20 20 20 20 20 20 20 2f 2a 20 57 68 61 74 20 74 /* What t
12bc0 6f 20 64 6f 20 69 6e 20 63 61 73 65 20 6f 66 20 o do in case of
12bd0 75 6e 69 71 75 65 6e 65 73 73 20 63 6f 6e 66 6c uniqueness confl
12be0 69 63 74 20 6f 6e 20 69 50 4b 65 79 20 2a 2f 0a ict on iPKey */.
12bf0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
12c00 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c 45 0a 20 MIT_ALTERTABLE.
12c10 20 69 6e 74 20 61 64 64 43 6f 6c 4f 66 66 73 65 int addColOffse
12c20 74 3b 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 t; /* Offset
12c30 69 6e 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 in CREATE TABLE
12c40 73 74 6d 74 20 74 6f 20 61 64 64 20 61 20 6e 65 stmt to add a ne
12c50 77 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 65 6e 64 w column */.#end
12c60 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
12c70 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 E_OMIT_VIRTUALTA
12c80 42 4c 45 0a 20 20 69 6e 74 20 6e 4d 6f 64 75 6c BLE. int nModul
12c90 65 41 72 67 3b 20 20 20 20 20 20 2f 2a 20 4e 75 eArg; /* Nu
12ca0 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
12cb0 73 20 74 6f 20 74 68 65 20 6d 6f 64 75 6c 65 20 s to the module
12cc0 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 61 7a 4d 6f */. char **azMo
12cd0 64 75 6c 65 41 72 67 3b 20 20 2f 2a 20 30 3a 20 duleArg; /* 0:
12ce0 6d 6f 64 75 6c 65 20 31 3a 20 73 63 68 65 6d 61 module 1: schema
12cf0 20 32 3a 20 76 74 61 62 20 6e 61 6d 65 20 33 2e 2: vtab name 3.
12d00 2e 2e 3a 20 61 72 67 73 20 2a 2f 0a 20 20 56 54 ..: args */. VT
12d10 61 62 6c 65 20 2a 70 56 54 61 62 6c 65 3b 20 20 able *pVTable;
12d20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 56 54 /* List of VT
12d30 61 62 6c 65 20 6f 62 6a 65 63 74 73 2e 20 2a 2f able objects. */
12d40 0a 23 65 6e 64 69 66 0a 20 20 54 72 69 67 67 65 .#endif. Trigge
12d50 72 20 2a 70 54 72 69 67 67 65 72 3b 20 20 20 2f r *pTrigger; /
12d60 2a 20 4c 69 73 74 20 6f 66 20 74 72 69 67 67 65 * List of trigge
12d70 72 73 20 73 74 6f 72 65 64 20 69 6e 20 70 53 63 rs stored in pSc
12d80 68 65 6d 61 20 2a 2f 0a 20 20 53 63 68 65 6d 61 hema */. Schema
12d90 20 2a 70 53 63 68 65 6d 61 3b 20 20 20 20 20 2f *pSchema; /
12da0 2a 20 53 63 68 65 6d 61 20 74 68 61 74 20 63 6f * Schema that co
12db0 6e 74 61 69 6e 73 20 74 68 69 73 20 74 61 62 6c ntains this tabl
12dc0 65 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 4e e */. Table *pN
12dd0 65 78 74 5a 6f 6d 62 69 65 3b 20 20 2f 2a 20 4e extZombie; /* N
12de0 65 78 74 20 6f 6e 20 74 68 65 20 50 61 72 73 65 ext on the Parse
12df0 2e 70 5a 6f 6d 62 69 65 54 61 62 20 6c 69 73 74 .pZombieTab list
12e00 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c */.};../*.** Al
12e10 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 lowed values for
12e20 20 54 61 62 6c 65 2e 74 61 62 46 6c 61 67 73 2e Table.tabFlags.
12e30 0a 2a 2a 0a 2a 2a 20 54 46 5f 4f 4f 4f 48 69 64 .**.** TF_OOOHid
12e40 64 65 6e 20 61 70 70 6c 69 65 73 20 74 6f 20 74 den applies to t
12e50 61 62 6c 65 73 20 6f 72 20 76 69 65 77 20 74 68 ables or view th
12e60 61 74 20 68 61 76 65 20 68 69 64 64 65 6e 20 63 at have hidden c
12e70 6f 6c 75 6d 6e 73 20 74 68 61 74 20 61 72 65 0a olumns that are.
12e80 2a 2a 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 6e ** followed by n
12e90 6f 6e 2d 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e on-hidden column
12ea0 73 2e 20 20 45 78 61 6d 70 6c 65 3a 20 20 22 43 s. Example: "C
12eb0 52 45 41 54 45 20 56 49 52 54 55 41 4c 20 54 41 REATE VIRTUAL TA
12ec0 42 4c 45 20 78 20 55 53 49 4e 47 0a 2a 2a 20 76 BLE x USING.** v
12ed0 74 61 62 31 28 61 20 48 49 44 44 45 4e 2c 20 62 tab1(a HIDDEN, b
12ee0 29 3b 22 2e 20 20 53 69 6e 63 65 20 22 62 22 20 );". Since "b"
12ef0 69 73 20 61 20 6e 6f 6e 2d 68 69 64 64 65 6e 20 is a non-hidden
12f00 63 6f 6c 75 6d 6e 20 62 75 74 20 22 61 22 20 69 column but "a" i
12f10 73 20 68 69 64 64 65 6e 2c 0a 2a 2a 20 74 68 65 s hidden,.** the
12f20 20 54 46 5f 4f 4f 4f 48 69 64 64 65 6e 20 61 74 TF_OOOHidden at
12f30 74 72 69 62 75 74 65 20 77 6f 75 6c 64 20 61 70 tribute would ap
12f40 70 6c 79 20 69 6e 20 74 68 69 73 20 63 61 73 65 ply in this case
12f50 2e 20 20 53 75 63 68 20 74 61 62 6c 65 73 20 72 . Such tables r
12f60 65 71 75 69 72 65 0a 2a 2a 20 73 70 65 63 69 61 equire.** specia
12f70 6c 20 68 61 6e 64 6c 69 6e 67 20 64 75 72 69 6e l handling durin
12f80 67 20 49 4e 53 45 52 54 20 70 72 6f 63 65 73 73 g INSERT process
12f90 69 6e 67 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ing..*/.#define
12fa0 54 46 5f 52 65 61 64 6f 6e 6c 79 20 20 20 20 20 TF_Readonly
12fb0 20 20 20 30 78 30 30 30 31 20 20 20 20 2f 2a 20 0x0001 /*
12fc0 52 65 61 64 2d 6f 6e 6c 79 20 73 79 73 74 65 6d Read-only system
12fd0 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e table */.#defin
12fe0 65 20 54 46 5f 45 70 68 65 6d 65 72 61 6c 20 20 e TF_Ephemeral
12ff0 20 20 20 20 20 30 78 30 30 30 32 20 20 20 20 2f 0x0002 /
13000 2a 20 41 6e 20 65 70 68 65 6d 65 72 61 6c 20 74 * An ephemeral t
13010 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 able */.#define
13020 54 46 5f 48 61 73 50 72 69 6d 61 72 79 4b 65 79 TF_HasPrimaryKey
13030 20 20 20 30 78 30 30 30 34 20 20 20 20 2f 2a 20 0x0004 /*
13040 54 61 62 6c 65 20 68 61 73 20 61 20 70 72 69 6d Table has a prim
13050 61 72 79 20 6b 65 79 20 2a 2f 0a 23 64 65 66 69 ary key */.#defi
13060 6e 65 20 54 46 5f 41 75 74 6f 69 6e 63 72 65 6d ne TF_Autoincrem
13070 65 6e 74 20 20 20 30 78 30 30 30 38 20 20 20 20 ent 0x0008
13080 2f 2a 20 49 6e 74 65 67 65 72 20 70 72 69 6d 61 /* Integer prima
13090 72 79 20 6b 65 79 20 69 73 20 61 75 74 6f 69 6e ry key is autoin
130a0 63 72 65 6d 65 6e 74 20 2a 2f 0a 23 64 65 66 69 crement */.#defi
130b0 6e 65 20 54 46 5f 48 61 73 53 74 61 74 31 20 20 ne TF_HasStat1
130c0 20 20 20 20 20 20 30 78 30 30 31 30 20 20 20 20 0x0010
130d0 2f 2a 20 6e 52 6f 77 4c 6f 67 45 73 74 20 73 65 /* nRowLogEst se
130e0 74 20 66 72 6f 6d 20 73 71 6c 69 74 65 5f 73 74 t from sqlite_st
130f0 61 74 31 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 at1 */.#define T
13100 46 5f 57 69 74 68 6f 75 74 52 6f 77 69 64 20 20 F_WithoutRowid
13110 20 20 30 78 30 30 32 30 20 20 20 20 2f 2a 20 4e 0x0020 /* N
13120 6f 20 72 6f 77 69 64 2e 20 20 50 52 49 4d 41 52 o rowid. PRIMAR
13130 59 20 4b 45 59 20 69 73 20 74 68 65 20 6b 65 79 Y KEY is the key
13140 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 4e */.#define TF_N
13150 6f 56 69 73 69 62 6c 65 52 6f 77 69 64 20 20 30 oVisibleRowid 0
13160 78 30 30 34 30 20 20 20 20 2f 2a 20 4e 6f 20 75 x0040 /* No u
13170 73 65 72 2d 76 69 73 69 62 6c 65 20 22 72 6f 77 ser-visible "row
13180 69 64 22 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 id" column */.#d
13190 65 66 69 6e 65 20 54 46 5f 4f 4f 4f 48 69 64 64 efine TF_OOOHidd
131a0 65 6e 20 20 20 20 20 20 20 30 78 30 30 38 30 20 en 0x0080
131b0 20 20 20 2f 2a 20 4f 75 74 2d 6f 66 2d 4f 72 64 /* Out-of-Ord
131c0 65 72 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e er hidden column
131d0 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f s */.#define TF_
131e0 53 74 61 74 73 55 73 65 64 20 20 20 20 20 20 20 StatsUsed
131f0 30 78 30 31 30 30 20 20 20 20 2f 2a 20 51 75 65 0x0100 /* Que
13200 72 79 20 70 6c 61 6e 6e 65 72 20 64 65 63 69 73 ry planner decis
13210 69 6f 6e 73 20 61 66 66 65 63 74 65 64 20 62 79 ions affected by
13220 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
13230 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13240 20 20 20 20 20 20 2a 2a 20 49 6e 64 65 78 2e 61 ** Index.a
13250 69 52 6f 77 4c 6f 67 45 73 74 5b 5d 20 76 61 6c iRowLogEst[] val
13260 75 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 ues */.#define T
13270 46 5f 48 61 73 4e 6f 74 4e 75 6c 6c 20 20 20 20 F_HasNotNull
13280 20 20 30 78 30 32 30 30 20 20 20 20 2f 2a 20 43 0x0200 /* C
13290 6f 6e 74 61 69 6e 73 20 4e 4f 54 20 4e 55 4c 4c ontains NOT NULL
132a0 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
132b0 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 74 6f 20 73 ./*.** Test to s
132c0 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f ee whether or no
132d0 74 20 61 20 74 61 62 6c 65 20 69 73 20 61 20 76 t a table is a v
132e0 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 20 54 irtual table. T
132f0 68 69 73 20 69 73 0a 2a 2a 20 64 6f 6e 65 20 61 his is.** done a
13300 73 20 61 20 6d 61 63 72 6f 20 73 6f 20 74 68 61 s a macro so tha
13310 74 20 69 74 20 77 69 6c 6c 20 62 65 20 6f 70 74 t it will be opt
13320 69 6d 69 7a 65 64 20 6f 75 74 20 77 68 65 6e 20 imized out when
13330 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 virtual.** table
13340 20 73 75 70 70 6f 72 74 20 69 73 20 6f 6d 69 74 support is omit
13350 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69 ted from the bui
13360 6c 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ld..*/.#ifndef S
13370 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 QLITE_OMIT_VIRTU
13380 41 4c 54 41 42 4c 45 0a 23 20 20 64 65 66 69 6e ALTABLE.# defin
13390 65 20 49 73 56 69 72 74 75 61 6c 28 58 29 20 20 e IsVirtual(X)
133a0 20 20 20 20 28 28 58 29 2d 3e 6e 4d 6f 64 75 6c ((X)->nModul
133b0 65 41 72 67 29 0a 23 65 6c 73 65 0a 23 20 20 64 eArg).#else.# d
133c0 65 66 69 6e 65 20 49 73 56 69 72 74 75 61 6c 28 efine IsVirtual(
133d0 58 29 20 20 20 20 20 20 30 0a 23 65 6e 64 69 66 X) 0.#endif
133e0 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 ../*.** Macros t
133f0 6f 20 64 65 74 65 72 6d 69 6e 65 20 69 66 20 61 o determine if a
13400 20 63 6f 6c 75 6d 6e 20 69 73 20 68 69 64 64 65 column is hidde
13410 6e 2e 20 20 49 73 4f 72 64 69 6e 61 72 79 48 69 n. IsOrdinaryHi
13420 64 64 65 6e 43 6f 6c 75 6d 6e 28 29 0a 2a 2a 20 ddenColumn().**
13430 6f 6e 6c 79 20 77 6f 72 6b 73 20 66 6f 72 20 6e only works for n
13440 6f 6e 2d 76 69 72 74 75 61 6c 20 74 61 62 6c 65 on-virtual table
13450 73 20 28 6f 72 64 69 6e 61 72 79 20 74 61 62 6c s (ordinary tabl
13460 65 73 20 61 6e 64 20 76 69 65 77 73 29 20 61 6e es and views) an
13470 64 20 69 73 0a 2a 2a 20 61 6c 77 61 79 73 20 66 d is.** always f
13480 61 6c 73 65 20 75 6e 6c 65 73 73 20 53 51 4c 49 alse unless SQLI
13490 54 45 5f 45 4e 41 42 4c 45 5f 48 49 44 44 45 4e TE_ENABLE_HIDDEN
134a0 5f 43 4f 4c 55 4d 4e 53 20 69 73 20 64 65 66 69 _COLUMNS is defi
134b0 6e 65 64 2e 20 20 54 68 65 0a 2a 2a 20 49 73 48 ned. The.** IsH
134c0 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 29 20 6d 61 iddenColumn() ma
134d0 63 72 6f 20 69 73 20 67 65 6e 65 72 61 6c 20 70 cro is general p
134e0 75 72 70 6f 73 65 2e 0a 2a 2f 0a 23 69 66 20 64 urpose..*/.#if d
134f0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e efined(SQLITE_EN
13500 41 42 4c 45 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 ABLE_HIDDEN_COLU
13510 4d 4e 53 29 0a 23 20 20 64 65 66 69 6e 65 20 49 MNS).# define I
13520 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 sHiddenColumn(X)
13530 20 20 20 20 20 20 20 20 20 28 28 28 58 29 2d 3e (((X)->
13540 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c colFlags & COLFL
13550 41 47 5f 48 49 44 44 45 4e 29 21 3d 30 29 0a 23 AG_HIDDEN)!=0).#
13560 20 20 64 65 66 69 6e 65 20 49 73 4f 72 64 69 6e define IsOrdin
13570 61 72 79 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 aryHiddenColumn(
13580 58 29 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c 61 X) (((X)->colFla
13590 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 44 gs & COLFLAG_HID
135a0 44 45 4e 29 21 3d 30 29 0a 23 65 6c 69 66 20 21 DEN)!=0).#elif !
135b0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
135c0 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
135d0 29 0a 23 20 20 64 65 66 69 6e 65 20 49 73 48 69 ).# define IsHi
135e0 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 20 ddenColumn(X)
135f0 20 20 20 20 20 20 28 28 28 58 29 2d 3e 63 6f 6c (((X)->col
13600 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f Flags & COLFLAG_
13610 48 49 44 44 45 4e 29 21 3d 30 29 0a 23 20 20 64 HIDDEN)!=0).# d
13620 65 66 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 efine IsOrdinary
13630 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 HiddenColumn(X)
13640 30 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 0.#else.# defin
13650 65 20 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e e IsHiddenColumn
13660 28 58 29 20 20 20 20 20 20 20 20 20 30 0a 23 20 (X) 0.#
13670 20 64 65 66 69 6e 65 20 49 73 4f 72 64 69 6e 61 define IsOrdina
13680 72 79 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 ryHiddenColumn(X
13690 29 20 30 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 20 ) 0.#endif.../*
136a0 44 6f 65 73 20 74 68 65 20 74 61 62 6c 65 20 68 Does the table h
136b0 61 76 65 20 61 20 72 6f 77 69 64 20 2a 2f 0a 23 ave a rowid */.#
136c0 64 65 66 69 6e 65 20 48 61 73 52 6f 77 69 64 28 define HasRowid(
136d0 58 29 20 20 20 20 20 28 28 28 58 29 2d 3e 74 61 X) (((X)->ta
136e0 62 46 6c 61 67 73 20 26 20 54 46 5f 57 69 74 68 bFlags & TF_With
136f0 6f 75 74 52 6f 77 69 64 29 3d 3d 30 29 0a 23 64 outRowid)==0).#d
13700 65 66 69 6e 65 20 56 69 73 69 62 6c 65 52 6f 77 efine VisibleRow
13710 69 64 28 58 29 20 28 28 28 58 29 2d 3e 74 61 62 id(X) (((X)->tab
13720 46 6c 61 67 73 20 26 20 54 46 5f 4e 6f 56 69 73 Flags & TF_NoVis
13730 69 62 6c 65 52 6f 77 69 64 29 3d 3d 30 29 0a 0a ibleRowid)==0)..
13740 2f 2a 0a 2a 2a 20 45 61 63 68 20 66 6f 72 65 69 /*.** Each forei
13750 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e gn key constrain
13760 74 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 t is an instance
13770 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
13780 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a g structure..**.
13790 2a 2a 20 41 20 66 6f 72 65 69 67 6e 20 6b 65 79 ** A foreign key
137a0 20 69 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 is associated w
137b0 69 74 68 20 74 77 6f 20 74 61 62 6c 65 73 2e 20 ith two tables.
137c0 20 54 68 65 20 22 66 72 6f 6d 22 20 74 61 62 6c The "from" tabl
137d0 65 20 69 73 0a 2a 2a 20 74 68 65 20 74 61 62 6c e is.** the tabl
137e0 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 e that contains
137f0 74 68 65 20 52 45 46 45 52 45 4e 43 45 53 20 63 the REFERENCES c
13800 6c 61 75 73 65 20 74 68 61 74 20 63 72 65 61 74 lause that creat
13810 65 73 20 74 68 65 20 66 6f 72 65 69 67 6e 0a 2a es the foreign.*
13820 2a 20 6b 65 79 2e 20 20 54 68 65 20 22 74 6f 22 * key. The "to"
13830 20 74 61 62 6c 65 20 69 73 20 74 68 65 20 74 61 table is the ta
13840 62 6c 65 20 74 68 61 74 20 69 73 20 6e 61 6d 65 ble that is name
13850 64 20 69 6e 20 74 68 65 20 52 45 46 45 52 45 4e d in the REFEREN
13860 43 45 53 20 63 6c 61 75 73 65 2e 0a 2a 2a 20 43 CES clause..** C
13870 6f 6e 73 69 64 65 72 20 74 68 69 73 20 65 78 61 onsider this exa
13880 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 mple:.**.**
13890 43 52 45 41 54 45 20 54 41 42 4c 45 20 65 78 31 CREATE TABLE ex1
138a0 28 0a 2a 2a 20 20 20 20 20 20 20 61 20 49 4e 54 (.** a INT
138b0 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 EGER PRIMARY KEY
138c0 2c 0a 2a 2a 20 20 20 20 20 20 20 62 20 49 4e 54 ,.** b INT
138d0 45 47 45 52 20 43 4f 4e 53 54 52 41 49 4e 54 20 EGER CONSTRAINT
138e0 66 6b 31 20 52 45 46 45 52 45 4e 43 45 53 20 65 fk1 REFERENCES e
138f0 78 32 28 78 29 0a 2a 2a 20 20 20 20 20 29 3b 0a x2(x).** );.
13900 2a 2a 0a 2a 2a 20 46 6f 72 20 66 6f 72 65 69 67 **.** For foreig
13910 6e 20 6b 65 79 20 22 66 6b 31 22 2c 20 74 68 65 n key "fk1", the
13920 20 66 72 6f 6d 2d 74 61 62 6c 65 20 69 73 20 22 from-table is "
13930 65 78 31 22 20 61 6e 64 20 74 68 65 20 74 6f 2d ex1" and the to-
13940 74 61 62 6c 65 20 69 73 20 22 65 78 32 22 2e 0a table is "ex2"..
13950 2a 2a 20 45 71 75 69 76 61 6c 65 6e 74 20 6e 61 ** Equivalent na
13960 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 66 mes:.**.** f
13970 72 6f 6d 2d 74 61 62 6c 65 20 3d 3d 20 63 68 69 rom-table == chi
13980 6c 64 2d 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 ld-table.**
13990 20 20 74 6f 2d 74 61 62 6c 65 20 3d 3d 20 70 61 to-table == pa
139a0 72 65 6e 74 2d 74 61 62 6c 65 0a 2a 2a 0a 2a 2a rent-table.**.**
139b0 20 45 61 63 68 20 52 45 46 45 52 45 4e 43 45 53 Each REFERENCES
139c0 20 63 6c 61 75 73 65 20 67 65 6e 65 72 61 74 65 clause generate
139d0 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 s an instance of
139e0 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
139f0 74 72 75 63 74 75 72 65 0a 2a 2a 20 77 68 69 63 tructure.** whic
13a00 68 20 69 73 20 61 74 74 61 63 68 65 64 20 74 6f h is attached to
13a10 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 2e the from-table.
13a20 20 20 54 68 65 20 74 6f 2d 74 61 62 6c 65 20 6e The to-table n
13a30 65 65 64 20 6e 6f 74 20 65 78 69 73 74 20 77 68 eed not exist wh
13a40 65 6e 0a 2a 2a 20 74 68 65 20 66 72 6f 6d 2d 74 en.** the from-t
13a50 61 62 6c 65 20 69 73 20 63 72 65 61 74 65 64 2e able is created.
13a60 20 20 54 68 65 20 65 78 69 73 74 65 6e 63 65 20 The existence
13a70 6f 66 20 74 68 65 20 74 6f 2d 74 61 62 6c 65 20 of the to-table
13a80 69 73 20 6e 6f 74 20 63 68 65 63 6b 65 64 2e 0a is not checked..
13a90 2a 2a 0a 2a 2a 20 54 68 65 20 6c 69 73 74 20 6f **.** The list o
13aa0 66 20 61 6c 6c 20 70 61 72 65 6e 74 73 20 66 6f f all parents fo
13ab0 72 20 63 68 69 6c 64 20 54 61 62 6c 65 20 58 20 r child Table X
13ac0 69 73 20 68 65 6c 64 20 61 74 20 58 2e 70 46 4b is held at X.pFK
13ad0 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 20 6c 69 73 74 ey..**.** A list
13ae0 20 6f 66 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e of all children
13af0 20 66 6f 72 20 61 20 74 61 62 6c 65 20 6e 61 6d for a table nam
13b00 65 64 20 5a 20 28 77 68 69 63 68 20 6d 69 67 68 ed Z (which migh
13b10 74 20 6e 6f 74 20 65 76 65 6e 20 65 78 69 73 74 t not even exist
13b20 29 0a 2a 2a 20 69 73 20 68 65 6c 64 20 69 6e 20 ).** is held in
13b30 53 63 68 65 6d 61 2e 66 6b 65 79 48 61 73 68 20 Schema.fkeyHash
13b40 77 69 74 68 20 61 20 68 61 73 68 20 6b 65 79 20 with a hash key
13b50 6f 66 20 5a 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 of Z..*/.struct
13b60 46 4b 65 79 20 7b 0a 20 20 54 61 62 6c 65 20 2a FKey {. Table *
13b70 70 46 72 6f 6d 3b 20 20 20 20 20 2f 2a 20 54 61 pFrom; /* Ta
13b80 62 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ble containing t
13b90 68 65 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c he REFERENCES cl
13ba0 61 75 73 65 20 28 61 6b 61 3a 20 43 68 69 6c 64 ause (aka: Child
13bb0 29 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 4e 65 ) */. FKey *pNe
13bc0 78 74 46 72 6f 6d 3b 20 20 2f 2a 20 4e 65 78 74 xtFrom; /* Next
13bd0 20 46 4b 65 79 20 77 69 74 68 20 74 68 65 20 73 FKey with the s
13be0 61 6d 65 20 69 6e 20 70 46 72 6f 6d 2e 20 4e 65 ame in pFrom. Ne
13bf0 78 74 20 70 61 72 65 6e 74 20 6f 66 20 70 46 72 xt parent of pFr
13c00 6f 6d 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 om */. char *zT
13c10 6f 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d o; /* Nam
13c20 65 20 6f 66 20 74 61 62 6c 65 20 74 68 61 74 20 e of table that
13c30 74 68 65 20 6b 65 79 20 70 6f 69 6e 74 73 20 74 the key points t
13c40 6f 20 28 61 6b 61 3a 20 50 61 72 65 6e 74 29 20 o (aka: Parent)
13c50 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 */. FKey *pNext
13c60 54 6f 3b 20 20 20 20 2f 2a 20 4e 65 78 74 20 77 To; /* Next w
13c70 69 74 68 20 74 68 65 20 73 61 6d 65 20 7a 54 6f ith the same zTo
13c80 2e 20 4e 65 78 74 20 63 68 69 6c 64 20 6f 66 20 . Next child of
13c90 7a 54 6f 2e 20 2a 2f 0a 20 20 46 4b 65 79 20 2a zTo. */. FKey *
13ca0 70 50 72 65 76 54 6f 3b 20 20 20 20 2f 2a 20 50 pPrevTo; /* P
13cb0 72 65 76 69 6f 75 73 20 77 69 74 68 20 74 68 65 revious with the
13cc0 20 73 61 6d 65 20 7a 54 6f 20 2a 2f 0a 20 20 69 same zTo */. i
13cd0 6e 74 20 6e 43 6f 6c 3b 20 20 20 20 20 20 20 20 nt nCol;
13ce0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f /* Number of co
13cf0 6c 75 6d 6e 73 20 69 6e 20 74 68 69 73 20 6b 65 lumns in this ke
13d00 79 20 2a 2f 0a 20 20 2f 2a 20 45 56 3a 20 52 2d y */. /* EV: R-
13d10 33 30 33 32 33 2d 32 31 39 31 37 20 2a 2f 0a 20 30323-21917 */.
13d20 20 75 38 20 69 73 44 65 66 65 72 72 65 64 3b 20 u8 isDeferred;
13d30 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
13d40 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 68 65 63 constraint chec
13d50 6b 69 6e 67 20 69 73 20 64 65 66 65 72 72 65 64 king is deferred
13d60 20 74 69 6c 6c 20 43 4f 4d 4d 49 54 20 2a 2f 0a till COMMIT */.
13d70 20 20 75 38 20 61 41 63 74 69 6f 6e 5b 32 5d 3b u8 aAction[2];
13d80 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 20 44 45 /* ON DE
13d90 4c 45 54 45 20 61 6e 64 20 4f 4e 20 55 50 44 41 LETE and ON UPDA
13da0 54 45 20 61 63 74 69 6f 6e 73 2c 20 72 65 73 70 TE actions, resp
13db0 65 63 74 69 76 65 6c 79 20 2a 2f 0a 20 20 54 72 ectively */. Tr
13dc0 69 67 67 65 72 20 2a 61 70 54 72 69 67 67 65 72 igger *apTrigger
13dd0 5b 32 5d 3b 2f 2a 20 54 72 69 67 67 65 72 73 20 [2];/* Triggers
13de0 66 6f 72 20 61 41 63 74 69 6f 6e 5b 5d 20 61 63 for aAction[] ac
13df0 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 74 72 75 63 tions */. struc
13e00 74 20 73 43 6f 6c 4d 61 70 20 7b 20 20 20 20 20 t sColMap {
13e10 20 2f 2a 20 4d 61 70 70 69 6e 67 20 6f 66 20 63 /* Mapping of c
13e20 6f 6c 75 6d 6e 73 20 69 6e 20 70 46 72 6f 6d 20 olumns in pFrom
13e30 74 6f 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 7a 54 to columns in zT
13e40 6f 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 46 72 o */. int iFr
13e50 6f 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f om; /
13e60 2a 20 49 6e 64 65 78 20 6f 66 20 63 6f 6c 75 6d * Index of colum
13e70 6e 20 69 6e 20 70 46 72 6f 6d 20 2a 2f 0a 20 20 n in pFrom */.
13e80 20 20 63 68 61 72 20 2a 7a 43 6f 6c 3b 20 20 20 char *zCol;
13e90 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
13ea0 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 7a 54 6f of column in zTo
13eb0 2e 20 20 49 66 20 4e 55 4c 4c 20 75 73 65 20 50 . If NULL use P
13ec0 52 49 4d 41 52 59 20 4b 45 59 20 2a 2f 0a 20 20 RIMARY KEY */.
13ed0 7d 20 61 43 6f 6c 5b 31 5d 3b 20 20 20 20 20 20 } aCol[1];
13ee0 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e 74 /* One ent
13ef0 72 79 20 66 6f 72 20 65 61 63 68 20 6f 66 20 6e ry for each of n
13f00 43 6f 6c 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 7d Col columns */.}
13f10 3b 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 69 74 65 20 ;../*.** SQLite
13f20 73 75 70 70 6f 72 74 73 20 6d 61 6e 79 20 64 69 supports many di
13f30 66 66 65 72 65 6e 74 20 77 61 79 73 20 74 6f 20 fferent ways to
13f40 72 65 73 6f 6c 76 65 20 61 20 63 6f 6e 73 74 72 resolve a constr
13f50 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 2e 20 20 aint.** error.
13f60 52 4f 4c 4c 42 41 43 4b 20 70 72 6f 63 65 73 73 ROLLBACK process
13f70 69 6e 67 20 6d 65 61 6e 73 20 74 68 61 74 20 61 ing means that a
13f80 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c constraint viol
13f90 61 74 69 6f 6e 0a 2a 2a 20 63 61 75 73 65 73 20 ation.** causes
13fa0 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e the operation in
13fb0 20 70 72 6f 63 65 73 73 20 74 6f 20 66 61 69 6c process to fail
13fc0 20 61 6e 64 20 66 6f 72 20 74 68 65 20 63 75 72 and for the cur
13fd0 72 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e rent transaction
13fe0 0a 2a 2a 20 74 6f 20 62 65 20 72 6f 6c 6c 65 64 .** to be rolled
13ff0 20 62 61 63 6b 2e 20 20 41 42 4f 52 54 20 70 72 back. ABORT pr
14000 6f 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 ocessing means t
14010 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 he operation in
14020 70 72 6f 63 65 73 73 0a 2a 2a 20 66 61 69 6c 73 process.** fails
14030 20 61 6e 64 20 61 6e 79 20 70 72 69 6f 72 20 63 and any prior c
14040 68 61 6e 67 65 73 20 66 72 6f 6d 20 74 68 61 74 hanges from that
14050 20 6f 6e 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 one operation a
14060 72 65 20 62 61 63 6b 65 64 20 6f 75 74 2c 0a 2a re backed out,.*
14070 2a 20 62 75 74 20 74 68 65 20 74 72 61 6e 73 61 * but the transa
14080 63 74 69 6f 6e 20 69 73 20 6e 6f 74 20 72 6f 6c ction is not rol
14090 6c 65 64 20 62 61 63 6b 2e 20 20 46 41 49 4c 20 led back. FAIL
140a0 70 72 6f 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 processing means
140b0 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 6f 70 65 that.** the ope
140c0 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 ration in progre
140d0 73 73 20 73 74 6f 70 73 20 61 6e 64 20 72 65 74 ss stops and ret
140e0 75 72 6e 73 20 61 6e 20 65 72 72 6f 72 20 63 6f urns an error co
140f0 64 65 2e 20 20 42 75 74 20 70 72 69 6f 72 0a 2a de. But prior.*
14100 2a 20 63 68 61 6e 67 65 73 20 64 75 65 20 74 6f * changes due to
14110 20 74 68 65 20 73 61 6d 65 20 6f 70 65 72 61 74 the same operat
14120 69 6f 6e 20 61 72 65 20 6e 6f 74 20 62 61 63 6b ion are not back
14130 65 64 20 6f 75 74 20 61 6e 64 20 6e 6f 20 72 6f ed out and no ro
14140 6c 6c 62 61 63 6b 0a 2a 2a 20 6f 63 63 75 72 73 llback.** occurs
14150 2e 20 20 49 47 4e 4f 52 45 20 6d 65 61 6e 73 20 . IGNORE means
14160 74 68 61 74 20 74 68 65 20 70 61 72 74 69 63 75 that the particu
14170 6c 61 72 20 72 6f 77 20 74 68 61 74 20 63 61 75 lar row that cau
14180 73 65 64 20 74 68 65 20 63 6f 6e 73 74 72 61 69 sed the constrai
14190 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 69 73 20 6e nt.** error is n
141a0 6f 74 20 69 6e 73 65 72 74 65 64 20 6f 72 20 75 ot inserted or u
141b0 70 64 61 74 65 64 2e 20 20 50 72 6f 63 65 73 73 pdated. Process
141c0 69 6e 67 20 63 6f 6e 74 69 6e 75 65 73 20 61 6e ing continues an
141d0 64 20 6e 6f 20 65 72 72 6f 72 0a 2a 2a 20 69 73 d no error.** is
141e0 20 72 65 74 75 72 6e 65 64 2e 20 20 52 45 50 4c returned. REPL
141f0 41 43 45 20 6d 65 61 6e 73 20 74 68 61 74 20 70 ACE means that p
14200 72 65 65 78 69 73 74 69 6e 67 20 64 61 74 61 62 reexisting datab
14210 61 73 65 20 72 6f 77 73 20 74 68 61 74 20 63 61 ase rows that ca
14220 75 73 65 64 0a 2a 2a 20 61 20 55 4e 49 51 55 45 used.** a UNIQUE
14230 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c constraint viol
14240 61 74 69 6f 6e 20 61 72 65 20 72 65 6d 6f 76 65 ation are remove
14250 64 20 73 6f 20 74 68 61 74 20 74 68 65 20 6e 65 d so that the ne
14260 77 20 69 6e 73 65 72 74 20 6f 72 0a 2a 2a 20 75 w insert or.** u
14270 70 64 61 74 65 20 63 61 6e 20 70 72 6f 63 65 65 pdate can procee
14280 64 2e 20 20 50 72 6f 63 65 73 73 69 6e 67 20 63 d. Processing c
14290 6f 6e 74 69 6e 75 65 73 20 61 6e 64 20 6e 6f 20 ontinues and no
142a0 65 72 72 6f 72 20 69 73 20 72 65 70 6f 72 74 65 error is reporte
142b0 64 2e 0a 2a 2a 0a 2a 2a 20 52 45 53 54 52 49 43 d..**.** RESTRIC
142c0 54 2c 20 53 45 54 4e 55 4c 4c 2c 20 61 6e 64 20 T, SETNULL, and
142d0 43 41 53 43 41 44 45 20 61 63 74 69 6f 6e 73 20 CASCADE actions
142e0 61 70 70 6c 79 20 6f 6e 6c 79 20 74 6f 20 66 6f apply only to fo
142f0 72 65 69 67 6e 20 6b 65 79 73 2e 0a 2a 2a 20 52 reign keys..** R
14300 45 53 54 52 49 43 54 20 69 73 20 74 68 65 20 73 ESTRICT is the s
14310 61 6d 65 20 61 73 20 41 42 4f 52 54 20 66 6f 72 ame as ABORT for
14320 20 49 4d 4d 45 44 49 41 54 45 20 66 6f 72 65 69 IMMEDIATE forei
14330 67 6e 20 6b 65 79 73 20 61 6e 64 20 74 68 65 0a gn keys and the.
14340 2a 2a 20 73 61 6d 65 20 61 73 20 52 4f 4c 4c 42 ** same as ROLLB
14350 41 43 4b 20 66 6f 72 20 44 45 46 45 52 52 45 44 ACK for DEFERRED
14360 20 6b 65 79 73 2e 20 20 53 45 54 4e 55 4c 4c 20 keys. SETNULL
14370 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 66 means that the f
14380 6f 72 65 69 67 6e 0a 2a 2a 20 6b 65 79 20 69 73 oreign.** key is
14390 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 20 20 43 set to NULL. C
143a0 41 53 43 41 44 45 20 6d 65 61 6e 73 20 74 68 61 ASCADE means tha
143b0 74 20 61 20 44 45 4c 45 54 45 20 6f 72 20 55 50 t a DELETE or UP
143c0 44 41 54 45 20 6f 66 20 74 68 65 0a 2a 2a 20 72 DATE of the.** r
143d0 65 66 65 72 65 6e 63 65 64 20 74 61 62 6c 65 20 eferenced table
143e0 72 6f 77 20 69 73 20 70 72 6f 70 61 67 61 74 65 row is propagate
143f0 64 20 69 6e 74 6f 20 74 68 65 20 72 6f 77 20 74 d into the row t
14400 68 61 74 20 68 6f 6c 64 73 20 74 68 65 0a 2a 2a hat holds the.**
14410 20 66 6f 72 65 69 67 6e 20 6b 65 79 2e 0a 2a 2a foreign key..**
14420 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
14430 67 20 73 79 6d 62 6f 6c 69 63 20 76 61 6c 75 65 g symbolic value
14440 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 72 65 s are used to re
14450 63 6f 72 64 20 77 68 69 63 68 20 74 79 70 65 0a cord which type.
14460 2a 2a 20 6f 66 20 61 63 74 69 6f 6e 20 74 6f 20 ** of action to
14470 74 61 6b 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 take..*/.#define
14480 20 4f 45 5f 4e 6f 6e 65 20 20 20 20 20 30 20 20 OE_None 0
14490 20 2f 2a 20 54 68 65 72 65 20 69 73 20 6e 6f 20 /* There is no
144a0 63 6f 6e 73 74 72 61 69 6e 74 20 74 6f 20 63 68 constraint to ch
144b0 65 63 6b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f eck */.#define O
144c0 45 5f 52 6f 6c 6c 62 61 63 6b 20 31 20 20 20 2f E_Rollback 1 /
144d0 2a 20 46 61 69 6c 20 74 68 65 20 6f 70 65 72 61 * Fail the opera
144e0 74 69 6f 6e 20 61 6e 64 20 72 6f 6c 6c 62 61 63 tion and rollbac
144f0 6b 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f k the transactio
14500 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f n */.#define OE_
14510 41 62 6f 72 74 20 20 20 20 32 20 20 20 2f 2a 20 Abort 2 /*
14520 42 61 63 6b 20 6f 75 74 20 63 68 61 6e 67 65 73 Back out changes
14530 20 62 75 74 20 64 6f 20 6e 6f 20 72 6f 6c 6c 62 but do no rollb
14540 61 63 6b 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 ack transaction
14550 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 46 61 */.#define OE_Fa
14560 69 6c 20 20 20 20 20 33 20 20 20 2f 2a 20 53 74 il 3 /* St
14570 6f 70 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e op the operation
14580 20 62 75 74 20 6c 65 61 76 65 20 61 6c 6c 20 70 but leave all p
14590 72 69 6f 72 20 63 68 61 6e 67 65 73 20 2a 2f 0a rior changes */.
145a0 23 64 65 66 69 6e 65 20 4f 45 5f 49 67 6e 6f 72 #define OE_Ignor
145b0 65 20 20 20 34 20 20 20 2f 2a 20 49 67 6e 6f 72 e 4 /* Ignor
145c0 65 20 74 68 65 20 65 72 72 6f 72 2e 20 44 6f 20 e the error. Do
145d0 6e 6f 74 20 64 6f 20 74 68 65 20 49 4e 53 45 52 not do the INSER
145e0 54 20 6f 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 T or UPDATE */.#
145f0 64 65 66 69 6e 65 20 4f 45 5f 52 65 70 6c 61 63 define OE_Replac
14600 65 20 20 35 20 20 20 2f 2a 20 44 65 6c 65 74 65 e 5 /* Delete
14610 20 65 78 69 73 74 69 6e 67 20 72 65 63 6f 72 64 existing record
14620 2c 20 74 68 65 6e 20 64 6f 20 49 4e 53 45 52 54 , then do INSERT
14630 20 6f 72 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 or UPDATE */.#d
14640 65 66 69 6e 65 20 4f 45 5f 55 70 64 61 74 65 20 efine OE_Update
14650 20 20 36 20 20 20 2f 2a 20 50 72 6f 63 65 73 73 6 /* Process
14660 20 61 73 20 61 20 44 4f 20 55 50 44 41 54 45 20 as a DO UPDATE
14670 69 6e 20 61 6e 20 75 70 73 65 72 74 20 2a 2f 0a in an upsert */.
14680 23 64 65 66 69 6e 65 20 4f 45 5f 52 65 73 74 72 #define OE_Restr
14690 69 63 74 20 37 20 20 20 2f 2a 20 4f 45 5f 41 62 ict 7 /* OE_Ab
146a0 6f 72 74 20 66 6f 72 20 49 4d 4d 45 44 49 41 54 ort for IMMEDIAT
146b0 45 2c 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b 20 66 E, OE_Rollback f
146c0 6f 72 20 44 45 46 45 52 52 45 44 20 2a 2f 0a 23 or DEFERRED */.#
146d0 64 65 66 69 6e 65 20 4f 45 5f 53 65 74 4e 75 6c define OE_SetNul
146e0 6c 20 20 38 20 20 20 2f 2a 20 53 65 74 20 74 68 l 8 /* Set th
146f0 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 61 e foreign key va
14700 6c 75 65 20 74 6f 20 4e 55 4c 4c 20 2a 2f 0a 23 lue to NULL */.#
14710 64 65 66 69 6e 65 20 4f 45 5f 53 65 74 44 66 6c define OE_SetDfl
14720 74 20 20 39 20 20 20 2f 2a 20 53 65 74 20 74 68 t 9 /* Set th
14730 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 61 e foreign key va
14740 6c 75 65 20 74 6f 20 69 74 73 20 64 65 66 61 75 lue to its defau
14750 6c 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 lt */.#define OE
14760 5f 43 61 73 63 61 64 65 20 20 31 30 20 20 2f 2a _Cascade 10 /*
14770 20 43 61 73 63 61 64 65 20 74 68 65 20 63 68 61 Cascade the cha
14780 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 nges */.#define
14790 4f 45 5f 44 65 66 61 75 6c 74 20 20 31 31 20 20 OE_Default 11
147a0 2f 2a 20 44 6f 20 77 68 61 74 65 76 65 72 20 74 /* Do whatever t
147b0 68 65 20 64 65 66 61 75 6c 74 20 61 63 74 69 6f he default actio
147c0 6e 20 69 73 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 n is */.../*.**
147d0 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 An instance of t
147e0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
147f0 75 63 74 75 72 65 20 69 73 20 70 61 73 73 65 64 ucture is passed
14800 20 61 73 20 74 68 65 20 66 69 72 73 74 0a 2a 2a as the first.**
14810 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 73 71 6c argument to sql
14820 69 74 65 33 56 64 62 65 4b 65 79 43 6f 6d 70 61 ite3VdbeKeyCompa
14830 72 65 20 61 6e 64 20 69 73 20 75 73 65 64 20 74 re and is used t
14840 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 65 0a 2a 2a o control the.**
14850 20 63 6f 6d 70 61 72 69 73 6f 6e 20 6f 66 20 74 comparison of t
14860 68 65 20 74 77 6f 20 69 6e 64 65 78 20 6b 65 79 he two index key
14870 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 s..**.** Note th
14880 61 74 20 61 53 6f 72 74 4f 72 64 65 72 5b 5d 20 at aSortOrder[]
14890 61 6e 64 20 61 43 6f 6c 6c 5b 5d 20 68 61 76 65 and aColl[] have
148a0 20 6e 46 69 65 6c 64 2b 31 20 73 6c 6f 74 73 2e nField+1 slots.
148b0 20 20 54 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e There.** are n
148c0 46 69 65 6c 64 20 73 6c 6f 74 73 20 66 6f 72 20 Field slots for
148d0 74 68 65 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 the columns of a
148e0 6e 20 69 6e 64 65 78 20 74 68 65 6e 20 6f 6e 65 n index then one
148f0 20 65 78 74 72 61 20 73 6c 6f 74 0a 2a 2a 20 66 extra slot.** f
14900 6f 72 20 74 68 65 20 72 6f 77 69 64 20 61 74 20 or the rowid at
14910 74 68 65 20 65 6e 64 2e 0a 2a 2f 0a 73 74 72 75 the end..*/.stru
14920 63 74 20 4b 65 79 49 6e 66 6f 20 7b 0a 20 20 75 ct KeyInfo {. u
14930 33 32 20 6e 52 65 66 3b 20 20 20 20 20 20 20 20 32 nRef;
14940 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
14950 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 74 68 references to th
14960 69 73 20 4b 65 79 49 6e 66 6f 20 6f 62 6a 65 63 is KeyInfo objec
14970 74 20 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 t */. u8 enc;
14980 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 /* Te
14990 78 74 20 65 6e 63 6f 64 69 6e 67 20 2d 20 6f 6e xt encoding - on
149a0 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f e of the SQLITE_
149b0 55 54 46 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 UTF* values */.
149c0 20 75 31 36 20 6e 4b 65 79 46 69 65 6c 64 3b 20 u16 nKeyField;
149d0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
149e0 66 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e f key columns in
149f0 20 74 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 the index */.
14a00 75 31 36 20 6e 41 6c 6c 46 69 65 6c 64 3b 20 20 u16 nAllField;
14a10 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 63 6f 6c /* Total col
14a20 75 6d 6e 73 2c 20 69 6e 63 6c 75 64 69 6e 67 20 umns, including
14a30 6b 65 79 20 70 6c 75 73 20 6f 74 68 65 72 73 20 key plus others
14a40 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 */. sqlite3 *db
14a50 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ; /* The
14a60 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
14a70 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 2a 61 53 6f ion */. u8 *aSo
14a80 72 74 4f 72 64 65 72 3b 20 20 20 20 20 2f 2a 20 rtOrder; /*
14a90 53 6f 72 74 20 6f 72 64 65 72 20 66 6f 72 20 65 Sort order for e
14aa0 61 63 68 20 63 6f 6c 75 6d 6e 2e 20 2a 2f 0a 20 ach column. */.
14ab0 20 43 6f 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 5b CollSeq *aColl[
14ac0 31 5d 3b 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 1]; /* Collatin
14ad0 67 20 73 65 71 75 65 6e 63 65 20 66 6f 72 20 65 g sequence for e
14ae0 61 63 68 20 74 65 72 6d 20 6f 66 20 74 68 65 20 ach term of the
14af0 6b 65 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a key */.};../*.**
14b00 20 54 68 69 73 20 6f 62 6a 65 63 74 20 68 6f 6c This object hol
14b10 64 73 20 61 20 72 65 63 6f 72 64 20 77 68 69 63 ds a record whic
14b20 68 20 68 61 73 20 62 65 65 6e 20 70 61 72 73 65 h has been parse
14b30 64 20 6f 75 74 20 69 6e 74 6f 20 69 6e 64 69 76 d out into indiv
14b40 69 64 75 61 6c 0a 2a 2a 20 66 69 65 6c 64 73 2c idual.** fields,
14b50 20 66 6f 72 20 74 68 65 20 70 75 72 70 6f 73 65 for the purpose
14b60 73 20 6f 66 20 64 6f 69 6e 67 20 61 20 63 6f 6d s of doing a com
14b70 70 61 72 69 73 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 parison..**.** A
14b80 20 72 65 63 6f 72 64 20 69 73 20 61 6e 20 6f 62 record is an ob
14b90 6a 65 63 74 20 74 68 61 74 20 63 6f 6e 74 61 69 ject that contai
14ba0 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 66 ns one or more f
14bb0 69 65 6c 64 73 20 6f 66 20 64 61 74 61 2e 0a 2a ields of data..*
14bc0 2a 20 52 65 63 6f 72 64 73 20 61 72 65 20 75 73 * Records are us
14bd0 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 ed to store the
14be0 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 74 61 62 content of a tab
14bf0 6c 65 20 72 6f 77 20 61 6e 64 20 74 6f 20 73 74 le row and to st
14c00 6f 72 65 0a 2a 2a 20 74 68 65 20 6b 65 79 20 6f ore.** the key o
14c10 66 20 61 6e 20 69 6e 64 65 78 2e 20 20 41 20 62 f an index. A b
14c20 6c 6f 62 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 lob encoding of
14c30 61 20 72 65 63 6f 72 64 20 69 73 20 63 72 65 61 a record is crea
14c40 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 4f 50 ted by.** the OP
14c50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f _MakeRecord opco
14c60 64 65 20 6f 66 20 74 68 65 20 56 44 42 45 20 61 de of the VDBE a
14c70 6e 64 20 69 73 20 64 69 73 61 73 73 65 6d 62 6c nd is disassembl
14c80 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 4f 50 5f ed by the.** OP_
14c90 43 6f 6c 75 6d 6e 20 6f 70 63 6f 64 65 2e 0a 2a Column opcode..*
14ca0 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
14cb0 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 of this object
14cc0 73 65 72 76 65 73 20 61 73 20 61 20 22 6b 65 79 serves as a "key
14cd0 22 20 66 6f 72 20 64 6f 69 6e 67 20 61 20 73 65 " for doing a se
14ce0 61 72 63 68 20 6f 6e 0a 2a 2a 20 61 6e 20 69 6e arch on.** an in
14cf0 64 65 78 20 62 2b 74 72 65 65 2e 20 54 68 65 20 dex b+tree. The
14d00 67 6f 61 6c 20 6f 66 20 74 68 65 20 73 65 61 72 goal of the sear
14d10 63 68 20 69 73 20 74 6f 20 66 69 6e 64 20 74 68 ch is to find th
14d20 65 20 65 6e 74 72 79 20 74 68 61 74 0a 2a 2a 20 e entry that.**
14d30 69 73 20 63 6c 6f 73 65 64 20 74 6f 20 74 68 65 is closed to the
14d40 20 6b 65 79 20 64 65 73 63 72 69 62 65 64 20 62 key described b
14d50 79 20 74 68 69 73 20 6f 62 6a 65 63 74 2e 20 20 y this object.
14d60 54 68 69 73 20 6f 62 6a 65 63 74 20 6d 69 67 68 This object migh
14d70 74 20 68 6f 6c 64 0a 2a 2a 20 6a 75 73 74 20 61 t hold.** just a
14d80 20 70 72 65 66 69 78 20 6f 66 20 74 68 65 20 6b prefix of the k
14d90 65 79 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 ey. The number
14da0 6f 66 20 66 69 65 6c 64 73 20 69 73 20 67 69 76 of fields is giv
14db0 65 6e 20 62 79 0a 2a 2a 20 70 4b 65 79 49 6e 66 en by.** pKeyInf
14dc0 6f 2d 3e 6e 46 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a o->nField..**.**
14dd0 20 54 68 65 20 72 31 20 61 6e 64 20 72 32 20 66 The r1 and r2 f
14de0 69 65 6c 64 73 20 61 72 65 20 74 68 65 20 76 61 ields are the va
14df0 6c 75 65 73 20 74 6f 20 72 65 74 75 72 6e 20 69 lues to return i
14e00 66 20 74 68 69 73 20 6b 65 79 20 69 73 20 6c 65 f this key is le
14e10 73 73 20 74 68 61 6e 0a 2a 2a 20 6f 72 20 67 72 ss than.** or gr
14e20 65 61 74 65 72 20 74 68 61 6e 20 61 20 6b 65 79 eater than a key
14e30 20 69 6e 20 74 68 65 20 62 74 72 65 65 2c 20 72 in the btree, r
14e40 65 73 70 65 63 74 69 76 65 6c 79 2e 20 20 54 68 espectively. Th
14e50 65 73 65 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 ese are normally
14e60 0a 2a 2a 20 2d 31 20 61 6e 64 20 2b 31 20 72 65 .** -1 and +1 re
14e70 73 70 65 63 74 69 76 65 6c 79 2c 20 62 75 74 20 spectively, but
14e80 6d 69 67 68 74 20 62 65 20 69 6e 76 65 72 74 65 might be inverte
14e90 64 20 74 6f 20 2b 31 20 61 6e 64 20 2d 31 20 69 d to +1 and -1 i
14ea0 66 20 74 68 65 20 62 2d 74 72 65 65 0a 2a 2a 20 f the b-tree.**
14eb0 69 73 20 69 6e 20 44 45 53 43 20 6f 72 64 65 72 is in DESC order
14ec0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6b 65 79 20 ..**.** The key
14ed0 63 6f 6d 70 61 72 69 73 6f 6e 20 66 75 6e 63 74 comparison funct
14ee0 69 6f 6e 73 20 61 63 74 75 61 6c 6c 79 20 72 65 ions actually re
14ef0 74 75 72 6e 20 64 65 66 61 75 6c 74 5f 72 63 20 turn default_rc
14f00 77 68 65 6e 20 74 68 65 79 20 66 69 6e 64 0a 2a when they find.*
14f10 2a 20 61 6e 20 65 71 75 61 6c 73 20 63 6f 6d 70 * an equals comp
14f20 61 72 69 73 6f 6e 2e 20 20 64 65 66 61 75 6c 74 arison. default
14f30 5f 72 63 20 63 61 6e 20 62 65 20 2d 31 2c 20 30 _rc can be -1, 0
14f40 2c 20 6f 72 20 2b 31 2e 20 20 49 66 20 74 68 65 , or +1. If the
14f50 72 65 20 61 72 65 0a 2a 2a 20 6d 75 6c 74 69 70 re are.** multip
14f60 6c 65 20 65 6e 74 72 69 65 73 20 69 6e 20 74 68 le entries in th
14f70 65 20 62 2d 74 72 65 65 20 77 69 74 68 20 74 68 e b-tree with th
14f80 65 20 73 61 6d 65 20 6b 65 79 20 28 77 68 65 6e e same key (when
14f90 20 6f 6e 6c 79 20 6c 6f 6f 6b 69 6e 67 0a 2a 2a only looking.**
14fa0 20 61 74 20 74 68 65 20 66 69 72 73 74 20 70 4b at the first pK
14fb0 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 73 2c eyInfo->nFields,
14fc0 29 20 74 68 65 6e 20 64 65 66 61 75 6c 74 5f 72 ) then default_r
14fd0 63 20 63 61 6e 20 62 65 20 73 65 74 20 74 6f 20 c can be set to
14fe0 2d 31 20 74 6f 0a 2a 2a 20 63 61 75 73 65 20 74 -1 to.** cause t
14ff0 68 65 20 73 65 61 72 63 68 20 74 6f 20 66 69 6e he search to fin
15000 64 20 74 68 65 20 6c 61 73 74 20 6d 61 74 63 68 d the last match
15010 2c 20 6f 72 20 2b 31 20 74 6f 20 63 61 75 73 65 , or +1 to cause
15020 20 74 68 65 20 73 65 61 72 63 68 20 74 6f 0a 2a the search to.*
15030 2a 20 66 69 6e 64 20 74 68 65 20 66 69 72 73 74 * find the first
15040 20 6d 61 74 63 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 match..**.** Th
15050 65 20 6b 65 79 20 63 6f 6d 70 61 72 69 73 6f 6e e key comparison
15060 20 66 75 6e 63 74 69 6f 6e 73 20 77 69 6c 6c 20 functions will
15070 73 65 74 20 65 71 53 65 65 6e 20 74 6f 20 74 72 set eqSeen to tr
15080 75 65 20 69 66 20 74 68 65 79 20 65 76 65 72 0a ue if they ever.
15090 2a 2a 20 67 65 74 20 61 6e 64 20 65 71 75 61 6c ** get and equal
150a0 20 72 65 73 75 6c 74 73 20 77 68 65 6e 20 63 6f results when co
150b0 6d 70 61 72 69 6e 67 20 74 68 69 73 20 73 74 72 mparing this str
150c0 75 63 74 75 72 65 20 74 6f 20 61 20 62 2d 74 72 ucture to a b-tr
150d0 65 65 20 72 65 63 6f 72 64 2e 0a 2a 2a 20 57 68 ee record..** Wh
150e0 65 6e 20 64 65 66 61 75 6c 74 5f 72 63 21 3d 30 en default_rc!=0
150f0 2c 20 74 68 65 20 73 65 61 72 63 68 20 6d 69 67 , the search mig
15100 68 74 20 65 6e 64 20 75 70 20 6f 6e 20 74 68 65 ht end up on the
15110 20 72 65 63 6f 72 64 20 69 6d 6d 65 64 69 61 74 record immediat
15120 65 6c 79 0a 2a 2a 20 62 65 66 6f 72 65 20 74 68 ely.** before th
15130 65 20 66 69 72 73 74 20 6d 61 74 63 68 20 6f 72 e first match or
15140 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 immediately aft
15150 65 72 20 74 68 65 20 6c 61 73 74 20 6d 61 74 63 er the last matc
15160 68 2e 20 20 54 68 65 0a 2a 2a 20 65 71 53 65 65 h. The.** eqSee
15170 6e 20 66 69 65 6c 64 20 77 69 6c 6c 20 69 6e 64 n field will ind
15180 69 63 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 icate whether or
15190 20 6e 6f 74 20 61 6e 20 65 78 61 63 74 20 6d 61 not an exact ma
151a0 74 63 68 20 65 78 69 73 74 73 20 69 6e 20 74 68 tch exists in th
151b0 65 0a 2a 2a 20 62 2d 74 72 65 65 2e 0a 2a 2f 0a e.** b-tree..*/.
151c0 73 74 72 75 63 74 20 55 6e 70 61 63 6b 65 64 52 struct UnpackedR
151d0 65 63 6f 72 64 20 7b 0a 20 20 4b 65 79 49 6e 66 ecord {. KeyInf
151e0 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 2f 2a o *pKeyInfo; /*
151f0 20 43 6f 6c 6c 61 74 69 6f 6e 20 61 6e 64 20 73 Collation and s
15200 6f 72 74 2d 6f 72 64 65 72 20 69 6e 66 6f 72 6d ort-order inform
15210 61 74 69 6f 6e 20 2a 2f 0a 20 20 4d 65 6d 20 2a ation */. Mem *
15220 61 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 2f aMem; /
15230 2a 20 56 61 6c 75 65 73 20 2a 2f 0a 20 20 75 31 * Values */. u1
15240 36 20 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 6 nField;
15250 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 /* Number of e
15260 6e 74 72 69 65 73 20 69 6e 20 61 70 4d 65 6d 5b ntries in apMem[
15270 5d 20 2a 2f 0a 20 20 69 38 20 64 65 66 61 75 6c ] */. i8 defaul
15280 74 5f 72 63 3b 20 20 20 20 20 20 2f 2a 20 43 6f t_rc; /* Co
15290 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20 mparison result
152a0 69 66 20 6b 65 79 73 20 61 72 65 20 65 71 75 61 if keys are equa
152b0 6c 20 2a 2f 0a 20 20 75 38 20 65 72 72 43 6f 64 l */. u8 errCod
152c0 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 e; /* Er
152d0 72 6f 72 20 64 65 74 65 63 74 65 64 20 62 79 20 ror detected by
152e0 78 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 20 28 xRecordCompare (
152f0 43 4f 52 52 55 50 54 20 6f 72 20 4e 4f 4d 45 4d CORRUPT or NOMEM
15300 29 20 2a 2f 0a 20 20 69 38 20 72 31 3b 20 20 20 ) */. i8 r1;
15310 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 /* Va
15320 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 69 66 lue to return if
15330 20 28 6c 68 73 20 3c 20 72 68 73 29 20 2a 2f 0a (lhs < rhs) */.
15340 20 20 69 38 20 72 32 3b 20 20 20 20 20 20 20 20 i8 r2;
15350 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 /* Value t
15360 6f 20 72 65 74 75 72 6e 20 69 66 20 28 6c 68 73 o return if (lhs
15370 20 3e 20 72 68 73 29 20 2a 2f 0a 20 20 75 38 20 > rhs) */. u8
15380 65 71 53 65 65 6e 3b 20 20 20 20 20 20 20 20 20 eqSeen;
15390 20 2f 2a 20 54 72 75 65 20 69 66 20 61 6e 20 65 /* True if an e
153a0 71 75 61 6c 69 74 79 20 63 6f 6d 70 61 72 69 73 quality comparis
153b0 6f 6e 20 68 61 73 20 62 65 65 6e 20 73 65 65 6e on has been seen
153c0 20 2a 2f 0a 7d 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 45 */.};.../*.** E
153d0 61 63 68 20 53 51 4c 20 69 6e 64 65 78 20 69 73 ach SQL index is
153e0 20 72 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 represented in
153f0 6d 65 6d 6f 72 79 20 62 79 20 61 6e 0a 2a 2a 20 memory by an.**
15400 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
15410 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
15420 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 ure..**.** The c
15430 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20 74 61 olumns of the ta
15440 62 6c 65 20 74 68 61 74 20 61 72 65 20 74 6f 20 ble that are to
15450 62 65 20 69 6e 64 65 78 65 64 20 61 72 65 20 64 be indexed are d
15460 65 73 63 72 69 62 65 64 0a 2a 2a 20 62 79 20 74 escribed.** by t
15470 68 65 20 61 69 43 6f 6c 75 6d 6e 5b 5d 20 66 69 he aiColumn[] fi
15480 65 6c 64 20 6f 66 20 74 68 69 73 20 73 74 72 75 eld of this stru
15490 63 74 75 72 65 2e 20 20 46 6f 72 20 65 78 61 6d cture. For exam
154a0 70 6c 65 2c 20 73 75 70 70 6f 73 65 0a 2a 2a 20 ple, suppose.**
154b0 77 65 20 68 61 76 65 20 74 68 65 20 66 6f 6c 6c we have the foll
154c0 6f 77 69 6e 67 20 74 61 62 6c 65 20 61 6e 64 20 owing table and
154d0 69 6e 64 65 78 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 index:.**.**
154e0 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 45 78 CREATE TABLE Ex
154f0 31 28 63 31 20 69 6e 74 2c 20 63 32 20 69 6e 74 1(c1 int, c2 int
15500 2c 20 63 33 20 74 65 78 74 29 3b 0a 2a 2a 20 20 , c3 text);.**
15510 20 20 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 CREATE INDEX
15520 45 78 32 20 4f 4e 20 45 78 31 28 63 33 2c 63 31 Ex2 ON Ex1(c3,c1
15530 29 3b 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 );.**.** In the
15540 54 61 62 6c 65 20 73 74 72 75 63 74 75 72 65 20 Table structure
15550 64 65 73 63 72 69 62 69 6e 67 20 45 78 31 2c 20 describing Ex1,
15560 6e 43 6f 6c 3d 3d 33 20 62 65 63 61 75 73 65 20 nCol==3 because
15570 74 68 65 72 65 20 61 72 65 0a 2a 2a 20 74 68 72 there are.** thr
15580 65 65 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 ee columns in th
15590 65 20 74 61 62 6c 65 2e 20 20 49 6e 20 74 68 65 e table. In the
155a0 20 49 6e 64 65 78 20 73 74 72 75 63 74 75 72 65 Index structure
155b0 20 64 65 73 63 72 69 62 69 6e 67 0a 2a 2a 20 45 describing.** E
155c0 78 32 2c 20 6e 43 6f 6c 75 6d 6e 3d 3d 32 20 73 x2, nColumn==2 s
155d0 69 6e 63 65 20 32 20 6f 66 20 74 68 65 20 33 20 ince 2 of the 3
155e0 63 6f 6c 75 6d 6e 73 20 6f 66 20 45 78 31 20 61 columns of Ex1 a
155f0 72 65 20 69 6e 64 65 78 65 64 2e 0a 2a 2a 20 54 re indexed..** T
15600 68 65 20 76 61 6c 75 65 20 6f 66 20 61 69 43 6f he value of aiCo
15610 6c 75 6d 6e 20 69 73 20 7b 32 2c 20 30 7d 2e 20 lumn is {2, 0}.
15620 20 61 69 43 6f 6c 75 6d 6e 5b 30 5d 3d 3d 32 20 aiColumn[0]==2
15630 62 65 63 61 75 73 65 20 74 68 65 0a 2a 2a 20 66 because the.** f
15640 69 72 73 74 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 irst column to b
15650 65 20 69 6e 64 65 78 65 64 20 28 63 33 29 20 68 e indexed (c3) h
15660 61 73 20 61 6e 20 69 6e 64 65 78 20 6f 66 20 32 as an index of 2
15670 20 69 6e 20 45 78 31 2e 61 43 6f 6c 5b 5d 2e 0a in Ex1.aCol[]..
15680 2a 2a 20 54 68 65 20 73 65 63 6f 6e 64 20 63 6f ** The second co
15690 6c 75 6d 6e 20 74 6f 20 62 65 20 69 6e 64 65 78 lumn to be index
156a0 65 64 20 28 63 31 29 20 68 61 73 20 61 6e 20 69 ed (c1) has an i
156b0 6e 64 65 78 20 6f 66 20 30 20 69 6e 0a 2a 2a 20 ndex of 0 in.**
156c0 45 78 31 2e 61 43 6f 6c 5b 5d 2c 20 68 65 6e 63 Ex1.aCol[], henc
156d0 65 20 45 78 32 2e 61 69 43 6f 6c 75 6d 6e 5b 31 e Ex2.aiColumn[1
156e0 5d 3d 3d 30 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 ]==0..**.** The
156f0 49 6e 64 65 78 2e 6f 6e 45 72 72 6f 72 20 66 69 Index.onError fi
15700 65 6c 64 20 64 65 74 65 72 6d 69 6e 65 73 20 77 eld determines w
15710 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 hether or not th
15720 65 20 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d 6e e indexed column
15730 73 0a 2a 2a 20 6d 75 73 74 20 62 65 20 75 6e 69 s.** must be uni
15740 71 75 65 20 61 6e 64 20 77 68 61 74 20 74 6f 20 que and what to
15750 64 6f 20 69 66 20 74 68 65 79 20 61 72 65 20 6e do if they are n
15760 6f 74 2e 20 20 57 68 65 6e 20 49 6e 64 65 78 2e ot. When Index.
15770 6f 6e 45 72 72 6f 72 3d 4f 45 5f 4e 6f 6e 65 2c onError=OE_None,
15780 0a 2a 2a 20 69 74 20 6d 65 61 6e 73 20 74 68 69 .** it means thi
15790 73 20 69 73 20 6e 6f 74 20 61 20 75 6e 69 71 75 s is not a uniqu
157a0 65 20 69 6e 64 65 78 2e 20 20 4f 74 68 65 72 77 e index. Otherw
157b0 69 73 65 20 69 74 20 69 73 20 61 20 75 6e 69 71 ise it is a uniq
157c0 75 65 20 69 6e 64 65 78 0a 2a 2a 20 61 6e 64 20 ue index.** and
157d0 74 68 65 20 76 61 6c 75 65 20 6f 66 20 49 6e 64 the value of Ind
157e0 65 78 2e 6f 6e 45 72 72 6f 72 20 69 6e 64 69 63 ex.onError indic
157f0 61 74 65 20 74 68 65 20 77 68 69 63 68 20 63 6f ate the which co
15800 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f nflict resolutio
15810 6e 0a 2a 2a 20 61 6c 67 6f 72 69 74 68 6d 20 74 n.** algorithm t
15820 6f 20 65 6d 70 6c 6f 79 20 77 68 65 6e 65 76 65 o employ wheneve
15830 72 20 61 6e 20 61 74 74 65 6d 70 74 20 69 73 20 r an attempt is
15840 6d 61 64 65 20 74 6f 20 69 6e 73 65 72 74 20 61 made to insert a
15850 20 6e 6f 6e 2d 75 6e 69 71 75 65 0a 2a 2a 20 65 non-unique.** e
15860 6c 65 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 57 68 lement..**.** Wh
15870 69 6c 65 20 70 61 72 73 69 6e 67 20 61 20 43 52 ile parsing a CR
15880 45 41 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 EATE TABLE or CR
15890 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 EATE INDEX state
158a0 6d 65 6e 74 20 69 6e 20 6f 72 64 65 72 20 74 6f ment in order to
158b0 0a 2a 2a 20 67 65 6e 65 72 61 74 65 20 56 44 42 .** generate VDB
158c0 45 20 63 6f 64 65 20 28 61 73 20 6f 70 70 6f 73 E code (as oppos
158d0 65 64 20 74 6f 20 70 61 72 73 69 6e 67 20 6f 6e ed to parsing on
158e0 65 20 72 65 61 64 20 66 72 6f 6d 20 61 6e 20 73 e read from an s
158f0 71 6c 69 74 65 5f 6d 61 73 74 65 72 0a 2a 2a 20 qlite_master.**
15900 74 61 62 6c 65 20 61 73 20 70 61 72 74 20 6f 66 table as part of
15910 20 70 61 72 73 69 6e 67 20 61 6e 20 65 78 69 73 parsing an exis
15920 74 69 6e 67 20 64 61 74 61 62 61 73 65 20 73 63 ting database sc
15930 68 65 6d 61 29 2c 20 74 72 61 6e 73 69 65 6e 74 hema), transient
15940 20 69 6e 73 74 61 6e 63 65 73 0a 2a 2a 20 6f 66 instances.** of
15950 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 this structure
15960 6d 61 79 20 62 65 20 63 72 65 61 74 65 64 2e 20 may be created.
15970 49 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 In this case the
15980 20 49 6e 64 65 78 2e 74 6e 75 6d 20 76 61 72 69 Index.tnum vari
15990 61 62 6c 65 20 69 73 0a 2a 2a 20 75 73 65 64 20 able is.** used
159a0 74 6f 20 73 74 6f 72 65 20 74 68 65 20 61 64 64 to store the add
159b0 72 65 73 73 20 6f 66 20 61 20 56 44 42 45 20 69 ress of a VDBE i
159c0 6e 73 74 72 75 63 74 69 6f 6e 2c 20 6e 6f 74 20 nstruction, not
159d0 61 20 64 61 74 61 62 61 73 65 20 70 61 67 65 0a a database page.
159e0 2a 2a 20 6e 75 6d 62 65 72 20 28 69 74 20 63 61 ** number (it ca
159f0 6e 6e 6f 74 20 2d 20 74 68 65 20 64 61 74 61 62 nnot - the datab
15a00 61 73 65 20 70 61 67 65 20 69 73 20 6e 6f 74 20 ase page is not
15a10 61 6c 6c 6f 63 61 74 65 64 20 75 6e 74 69 6c 20 allocated until
15a20 74 68 65 20 56 44 42 45 0a 2a 2a 20 70 72 6f 67 the VDBE.** prog
15a30 72 61 6d 20 69 73 20 65 78 65 63 75 74 65 64 29 ram is executed)
15a40 2e 20 53 65 65 20 63 6f 6e 76 65 72 74 54 6f 57 . See convertToW
15a50 69 74 68 6f 75 74 52 6f 77 69 64 54 61 62 6c 65 ithoutRowidTable
15a60 28 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a () for details..
15a70 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 78 20 */.struct Index
15a80 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b {. char *zName;
15a90 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
15aa0 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 69 6e 64 Name of this ind
15ab0 65 78 20 2a 2f 0a 20 20 69 31 36 20 2a 61 69 43 ex */. i16 *aiC
15ac0 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
15ad0 20 2f 2a 20 57 68 69 63 68 20 63 6f 6c 75 6d 6e /* Which column
15ae0 73 20 61 72 65 20 75 73 65 64 20 62 79 20 74 68 s are used by th
15af0 69 73 20 69 6e 64 65 78 2e 20 20 31 73 74 20 69 is index. 1st i
15b00 73 20 30 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 s 0 */. LogEst
15b10 2a 61 69 52 6f 77 4c 6f 67 45 73 74 3b 20 20 20 *aiRowLogEst;
15b20 20 20 2f 2a 20 46 72 6f 6d 20 41 4e 41 4c 59 5a /* From ANALYZ
15b30 45 3a 20 45 73 74 2e 20 72 6f 77 73 20 73 65 6c E: Est. rows sel
15b40 65 63 74 65 64 20 62 79 20 65 61 63 68 20 63 6f ected by each co
15b50 6c 75 6d 6e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 lumn */. Table
15b60 2a 70 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 *pTable;
15b70 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 61 /* The SQL ta
15b80 62 6c 65 20 62 65 69 6e 67 20 69 6e 64 65 78 65 ble being indexe
15b90 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f d */. char *zCo
15ba0 6c 41 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 lAff;
15bb0 2f 2a 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 /* String defini
15bc0 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 ng the affinity
15bd0 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a of each column *
15be0 2f 0a 20 20 49 6e 64 65 78 20 2a 70 4e 65 78 74 /. Index *pNext
15bf0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
15c00 54 68 65 20 6e 65 78 74 20 69 6e 64 65 78 20 61 The next index a
15c10 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
15c20 68 65 20 73 61 6d 65 20 74 61 62 6c 65 20 2a 2f he same table */
15c30 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 . Schema *pSche
15c40 6d 61 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ma; /* S
15c50 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 chema containing
15c60 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a 20 this index */.
15c70 20 75 38 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b u8 *aSortOrder;
15c80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 6f 72 /* for
15c90 20 65 61 63 68 20 63 6f 6c 75 6d 6e 3a 20 54 72 each column: Tr
15ca0 75 65 3d 3d 44 45 53 43 2c 20 46 61 6c 73 65 3d ue==DESC, False=
15cb0 3d 41 53 43 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 =ASC */. const
15cc0 63 68 61 72 20 2a 2a 61 7a 43 6f 6c 6c 3b 20 20 char **azColl;
15cd0 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 /* Array of c
15ce0 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
15cf0 65 20 6e 61 6d 65 73 20 66 6f 72 20 69 6e 64 65 e names for inde
15d00 78 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 50 61 x */. Expr *pPa
15d10 72 74 49 64 78 57 68 65 72 65 3b 20 20 20 20 20 rtIdxWhere;
15d20 2f 2a 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 /* WHERE clause
15d30 66 6f 72 20 70 61 72 74 69 61 6c 20 69 6e 64 69 for partial indi
15d40 63 65 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 ces */. ExprLis
15d50 74 20 2a 61 43 6f 6c 45 78 70 72 3b 20 20 20 20 t *aColExpr;
15d60 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 65 78 70 72 /* Column expr
15d70 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 essions */. int
15d80 20 74 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 20 tnum;
15d90 20 20 20 20 20 20 2f 2a 20 44 42 20 50 61 67 65 /* DB Page
15da0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 72 6f 6f 74 containing root
15db0 20 6f 66 20 74 68 69 73 20 69 6e 64 65 78 20 2a of this index *
15dc0 2f 0a 20 20 4c 6f 67 45 73 74 20 73 7a 49 64 78 /. LogEst szIdx
15dd0 52 6f 77 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 Row; /*
15de0 45 73 74 69 6d 61 74 65 64 20 61 76 65 72 61 67 Estimated averag
15df0 65 20 72 6f 77 20 73 69 7a 65 20 69 6e 20 62 79 e row size in by
15e00 74 65 73 20 2a 2f 0a 20 20 75 31 36 20 6e 4b 65 tes */. u16 nKe
15e10 79 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 yCol;
15e20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 /* Number of c
15e30 6f 6c 75 6d 6e 73 20 66 6f 72 6d 69 6e 67 20 74 olumns forming t
15e40 68 65 20 6b 65 79 20 2a 2f 0a 20 20 75 31 36 20 he key */. u16
15e50 6e 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 nColumn;
15e60 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
15e70 66 20 63 6f 6c 75 6d 6e 73 20 73 74 6f 72 65 64 f columns stored
15e80 20 69 6e 20 74 68 65 20 69 6e 64 65 78 20 2a 2f in the index */
15e90 0a 20 20 75 38 20 6f 6e 45 72 72 6f 72 3b 20 20 . u8 onError;
15ea0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
15eb0 45 5f 41 62 6f 72 74 2c 20 4f 45 5f 49 67 6e 6f E_Abort, OE_Igno
15ec0 72 65 2c 20 4f 45 5f 52 65 70 6c 61 63 65 2c 20 re, OE_Replace,
15ed0 6f 72 20 4f 45 5f 4e 6f 6e 65 20 2a 2f 0a 20 20 or OE_None */.
15ee0 75 6e 73 69 67 6e 65 64 20 69 64 78 54 79 70 65 unsigned idxType
15ef0 3a 32 3b 20 20 20 20 20 20 2f 2a 20 31 3d 3d 55 :2; /* 1==U
15f00 4e 49 51 55 45 2c 20 32 3d 3d 50 52 49 4d 41 52 NIQUE, 2==PRIMAR
15f10 59 20 4b 45 59 2c 20 30 3d 3d 43 52 45 41 54 45 Y KEY, 0==CREATE
15f20 20 49 4e 44 45 58 20 2a 2f 0a 20 20 75 6e 73 69 INDEX */. unsi
15f30 67 6e 65 64 20 62 55 6e 6f 72 64 65 72 65 64 3a gned bUnordered:
15f40 31 3b 20 20 20 2f 2a 20 55 73 65 20 74 68 69 73 1; /* Use this
15f50 20 69 6e 64 65 78 20 66 6f 72 20 3d 3d 20 6f 72 index for == or
15f60 20 49 4e 20 71 75 65 72 69 65 73 20 6f 6e 6c 79 IN queries only
15f70 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 75 */. unsigned u
15f80 6e 69 71 4e 6f 74 4e 75 6c 6c 3a 31 3b 20 20 2f niqNotNull:1; /
15f90 2a 20 54 72 75 65 20 69 66 20 55 4e 49 51 55 45 * True if UNIQUE
15fa0 20 61 6e 64 20 4e 4f 54 20 4e 55 4c 4c 20 66 6f and NOT NULL fo
15fb0 72 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73 20 2a 2f r all columns */
15fc0 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 73 52 65 . unsigned isRe
15fd0 73 69 7a 65 64 3a 31 3b 20 20 20 20 2f 2a 20 54 sized:1; /* T
15fe0 72 75 65 20 69 66 20 72 65 73 69 7a 65 49 6e 64 rue if resizeInd
15ff0 65 78 4f 62 6a 65 63 74 28 29 20 68 61 73 20 62 exObject() has b
16000 65 65 6e 20 63 61 6c 6c 65 64 20 2a 2f 0a 20 20 een called */.
16010 75 6e 73 69 67 6e 65 64 20 69 73 43 6f 76 65 72 unsigned isCover
16020 69 6e 67 3a 31 3b 20 20 20 2f 2a 20 54 72 75 65 ing:1; /* True
16030 20 69 66 20 74 68 69 73 20 69 73 20 61 20 63 6f if this is a co
16040 76 65 72 69 6e 67 20 69 6e 64 65 78 20 2a 2f 0a vering index */.
16050 20 20 75 6e 73 69 67 6e 65 64 20 6e 6f 53 6b 69 unsigned noSki
16060 70 53 63 61 6e 3a 31 3b 20 20 20 2f 2a 20 44 6f pScan:1; /* Do
16070 20 6e 6f 74 20 74 72 79 20 74 6f 20 75 73 65 20 not try to use
16080 73 6b 69 70 2d 73 63 61 6e 20 69 66 20 74 72 75 skip-scan if tru
16090 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 e */. unsigned
160a0 68 61 73 53 74 61 74 31 3a 31 3b 20 20 20 20 20 hasStat1:1;
160b0 2f 2a 20 61 69 52 6f 77 4c 6f 67 45 73 74 20 76 /* aiRowLogEst v
160c0 61 6c 75 65 73 20 63 6f 6d 65 20 66 72 6f 6d 20 alues come from
160d0 73 71 6c 69 74 65 5f 73 74 61 74 31 20 2a 2f 0a sqlite_stat1 */.
160e0 20 20 75 6e 73 69 67 6e 65 64 20 62 4e 6f 51 75 unsigned bNoQu
160f0 65 72 79 3a 31 3b 20 20 20 20 20 2f 2a 20 44 6f ery:1; /* Do
16100 20 6e 6f 74 20 75 73 65 20 74 68 69 73 20 69 6e not use this in
16110 64 65 78 20 74 6f 20 6f 70 74 69 6d 69 7a 65 20 dex to optimize
16120 71 75 65 72 69 65 73 20 2a 2f 0a 23 69 66 64 65 queries */.#ifde
16130 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
16140 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 STAT3_OR_STAT4.
16150 20 69 6e 74 20 6e 53 61 6d 70 6c 65 3b 20 20 20 int nSample;
16160 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
16170 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 ber of elements
16180 69 6e 20 61 53 61 6d 70 6c 65 5b 5d 20 2a 2f 0a in aSample[] */.
16190 20 20 69 6e 74 20 6e 53 61 6d 70 6c 65 43 6f 6c int nSampleCol
161a0 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 ; /* Si
161b0 7a 65 20 6f 66 20 49 6e 64 65 78 53 61 6d 70 6c ze of IndexSampl
161c0 65 2e 61 6e 45 71 5b 5d 20 61 6e 64 20 73 6f 20 e.anEq[] and so
161d0 6f 6e 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 on */. tRowcnt
161e0 2a 61 41 76 67 45 71 3b 20 20 20 20 20 20 20 20 *aAvgEq;
161f0 20 2f 2a 20 41 76 65 72 61 67 65 20 6e 45 71 20 /* Average nEq
16200 76 61 6c 75 65 73 20 66 6f 72 20 6b 65 79 73 20 values for keys
16210 6e 6f 74 20 69 6e 20 61 53 61 6d 70 6c 65 20 2a not in aSample *
16220 2f 0a 20 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 /. IndexSample
16230 2a 61 53 61 6d 70 6c 65 3b 20 20 20 20 2f 2a 20 *aSample; /*
16240 53 61 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 6c Samples of the l
16250 65 66 74 2d 6d 6f 73 74 20 6b 65 79 20 2a 2f 0a eft-most key */.
16260 20 20 74 52 6f 77 63 6e 74 20 2a 61 69 52 6f 77 tRowcnt *aiRow
16270 45 73 74 3b 20 20 20 20 20 20 20 2f 2a 20 4e 6f Est; /* No
16280 6e 2d 6c 6f 67 61 72 69 74 68 6d 69 63 20 73 74 n-logarithmic st
16290 61 74 31 20 64 61 74 61 20 66 6f 72 20 74 68 69 at1 data for thi
162a0 73 20 69 6e 64 65 78 20 2a 2f 0a 20 20 74 52 6f s index */. tRo
162b0 77 63 6e 74 20 6e 52 6f 77 45 73 74 30 3b 20 20 wcnt nRowEst0;
162c0 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6c 6f 67 /* Non-log
162d0 61 72 69 74 68 6d 69 63 20 6e 75 6d 62 65 72 20 arithmic number
162e0 6f 66 20 72 6f 77 73 20 69 6e 20 74 68 65 20 69 of rows in the i
162f0 6e 64 65 78 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d ndex */.#endif.}
16300 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 ;../*.** Allowed
16310 20 76 61 6c 75 65 73 20 66 6f 72 20 49 6e 64 65 values for Inde
16320 78 2e 69 64 78 54 79 70 65 0a 2a 2f 0a 23 64 65 x.idxType.*/.#de
16330 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 44 58 54 fine SQLITE_IDXT
16340 59 50 45 5f 41 50 50 44 45 46 20 20 20 20 20 20 YPE_APPDEF
16350 30 20 20 20 2f 2a 20 43 72 65 61 74 65 64 20 75 0 /* Created u
16360 73 69 6e 67 20 43 52 45 41 54 45 20 49 4e 44 45 sing CREATE INDE
16370 58 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c X */.#define SQL
16380 49 54 45 5f 49 44 58 54 59 50 45 5f 55 4e 49 51 ITE_IDXTYPE_UNIQ
16390 55 45 20 20 20 20 20 20 31 20 20 20 2f 2a 20 49 UE 1 /* I
163a0 6d 70 6c 65 6d 65 6e 74 73 20 61 20 55 4e 49 51 mplements a UNIQ
163b0 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f UE constraint */
163c0 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
163d0 49 44 58 54 59 50 45 5f 50 52 49 4d 41 52 59 4b IDXTYPE_PRIMARYK
163e0 45 59 20 20 32 20 20 20 2f 2a 20 49 73 20 74 68 EY 2 /* Is th
163f0 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 6f e PRIMARY KEY fo
16400 72 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 0a r the table */..
16410 2f 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 /* Return true i
16420 66 20 69 6e 64 65 78 20 58 20 69 73 20 61 20 50 f index X is a P
16430 52 49 4d 41 52 59 20 4b 45 59 20 69 6e 64 65 78 RIMARY KEY index
16440 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 73 50 72 */.#define IsPr
16450 69 6d 61 72 79 4b 65 79 49 6e 64 65 78 28 58 29 imaryKeyIndex(X)
16460 20 20 28 28 58 29 2d 3e 69 64 78 54 79 70 65 3d ((X)->idxType=
16470 3d 53 51 4c 49 54 45 5f 49 44 58 54 59 50 45 5f =SQLITE_IDXTYPE_
16480 50 52 49 4d 41 52 59 4b 45 59 29 0a 0a 2f 2a 20 PRIMARYKEY)../*
16490 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 Return true if i
164a0 6e 64 65 78 20 58 20 69 73 20 61 20 55 4e 49 51 ndex X is a UNIQ
164b0 55 45 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 UE index */.#def
164c0 69 6e 65 20 49 73 55 6e 69 71 75 65 49 6e 64 65 ine IsUniqueInde
164d0 78 28 58 29 20 20 20 20 20 20 28 28 58 29 2d 3e x(X) ((X)->
164e0 6f 6e 45 72 72 6f 72 21 3d 4f 45 5f 4e 6f 6e 65 onError!=OE_None
164f0 29 0a 0a 2f 2a 20 54 68 65 20 49 6e 64 65 78 2e )../* The Index.
16500 61 69 43 6f 6c 75 6d 6e 5b 5d 20 76 61 6c 75 65 aiColumn[] value
16510 73 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 70 s are normally p
16520 6f 73 69 74 69 76 65 20 69 6e 74 65 67 65 72 2e ositive integer.
16530 20 20 42 75 74 0a 2a 2a 20 74 68 65 72 65 20 61 But.** there a
16540 72 65 20 73 6f 6d 65 20 6e 65 67 61 74 69 76 65 re some negative
16550 20 76 61 6c 75 65 73 20 74 68 61 74 20 68 61 76 values that hav
16560 65 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e e special meanin
16570 67 3a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e g:.*/.#define XN
16580 5f 52 4f 57 49 44 20 20 20 20 20 28 2d 31 29 20 _ROWID (-1)
16590 20 20 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 /* Indexed c
165a0 6f 6c 75 6d 6e 20 69 73 20 74 68 65 20 72 6f 77 olumn is the row
165b0 69 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e id */.#define XN
165c0 5f 45 58 50 52 20 20 20 20 20 20 28 2d 32 29 20 _EXPR (-2)
165d0 20 20 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 /* Indexed c
165e0 6f 6c 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 olumn is an expr
165f0 65 73 73 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a ession */../*.**
16600 20 45 61 63 68 20 73 61 6d 70 6c 65 20 73 74 6f Each sample sto
16610 72 65 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 red in the sqlit
16620 65 5f 73 74 61 74 33 20 74 61 62 6c 65 20 69 73 e_stat3 table is
16630 20 72 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 represented in
16640 6d 65 6d 6f 72 79 0a 2a 2a 20 75 73 69 6e 67 20 memory.** using
16650 61 20 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 a structure of t
16660 68 69 73 20 74 79 70 65 2e 20 20 53 65 65 20 64 his type. See d
16670 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 20 ocumentation at
16680 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 0a 2a the top of the.*
16690 2a 20 61 6e 61 6c 79 7a 65 2e 63 20 73 6f 75 72 * analyze.c sour
166a0 63 65 20 66 69 6c 65 20 66 6f 72 20 61 64 64 69 ce file for addi
166b0 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 tional informati
166c0 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e on..*/.struct In
166d0 64 65 78 53 61 6d 70 6c 65 20 7b 0a 20 20 76 6f dexSample {. vo
166e0 69 64 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 id *p;
166f0 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 73 61 /* Pointer to sa
16700 6d 70 6c 65 64 20 72 65 63 6f 72 64 20 2a 2f 0a mpled record */.
16710 20 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 int n;
16720 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 /* Size of r
16730 65 63 6f 72 64 20 69 6e 20 62 79 74 65 73 20 2a ecord in bytes *
16740 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 45 /. tRowcnt *anE
16750 71 3b 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 q; /* Est. nu
16760 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 mber of rows whe
16770 72 65 20 74 68 65 20 6b 65 79 20 65 71 75 61 6c re the key equal
16780 73 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f s this sample */
16790 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 4c 74 . tRowcnt *anLt
167a0 3b 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d ; /* Est. num
167b0 62 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 ber of rows wher
167c0 65 20 6b 65 79 20 69 73 20 6c 65 73 73 20 74 68 e key is less th
167d0 61 6e 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a an this sample *
167e0 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 44 /. tRowcnt *anD
167f0 4c 74 3b 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 Lt; /* Est. nu
16800 6d 62 65 72 20 6f 66 20 64 69 73 74 69 6e 63 74 mber of distinct
16810 20 6b 65 79 73 20 6c 65 73 73 20 74 68 61 6e 20 keys less than
16820 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 7d this sample */.}
16830 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 6f ;../*.** Each to
16840 6b 65 6e 20 63 6f 6d 69 6e 67 20 6f 75 74 20 6f ken coming out o
16850 66 20 74 68 65 20 6c 65 78 65 72 20 69 73 20 61 f the lexer is a
16860 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a n instance of.**
16870 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 2e this structure.
16880 20 20 54 6f 6b 65 6e 73 20 61 72 65 20 61 6c 73 Tokens are als
16890 6f 20 75 73 65 64 20 61 73 20 70 61 72 74 20 6f o used as part o
168a0 66 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 2e f an expression.
168b0 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 69 66 20 54 .**.** Note if T
168c0 6f 6b 65 6e 2e 7a 3d 3d 30 20 74 68 65 6e 20 54 oken.z==0 then T
168d0 6f 6b 65 6e 2e 64 79 6e 20 61 6e 64 20 54 6f 6b oken.dyn and Tok
168e0 65 6e 2e 6e 20 61 72 65 20 75 6e 64 65 66 69 6e en.n are undefin
168f0 65 64 20 61 6e 64 0a 2a 2a 20 6d 61 79 20 63 6f ed and.** may co
16900 6e 74 61 69 6e 20 72 61 6e 64 6f 6d 20 76 61 6c ntain random val
16910 75 65 73 2e 20 20 44 6f 20 6e 6f 74 20 6d 61 6b ues. Do not mak
16920 65 20 61 6e 79 20 61 73 73 75 6d 70 74 69 6f 6e e any assumption
16930 73 20 61 62 6f 75 74 20 54 6f 6b 65 6e 2e 64 79 s about Token.dy
16940 6e 0a 2a 2a 20 61 6e 64 20 54 6f 6b 65 6e 2e 6e n.** and Token.n
16950 20 77 68 65 6e 20 54 6f 6b 65 6e 2e 7a 3d 3d 30 when Token.z==0
16960 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 54 6f 6b 65 ..*/.struct Toke
16970 6e 20 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 n {. const char
16980 20 2a 7a 3b 20 20 20 20 20 2f 2a 20 54 65 78 74 *z; /* Text
16990 20 6f 66 20 74 68 65 20 74 6f 6b 65 6e 2e 20 20 of the token.
169a0 4e 6f 74 20 4e 55 4c 4c 2d 74 65 72 6d 69 6e 61 Not NULL-termina
169b0 74 65 64 21 20 2a 2f 0a 20 20 75 6e 73 69 67 6e ted! */. unsign
169c0 65 64 20 69 6e 74 20 6e 3b 20 20 20 20 2f 2a 20 ed int n; /*
169d0 4e 75 6d 62 65 72 20 6f 66 20 63 68 61 72 61 63 Number of charac
169e0 74 65 72 73 20 69 6e 20 74 68 69 73 20 74 6f 6b ters in this tok
169f0 65 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 en */.};../*.**
16a00 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 An instance of t
16a10 68 69 73 20 73 74 72 75 63 74 75 72 65 20 63 6f his structure co
16a20 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 ntains informati
16a30 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e on needed to gen
16a40 65 72 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f erate.** code fo
16a50 72 20 61 20 53 45 4c 45 43 54 20 74 68 61 74 20 r a SELECT that
16a60 63 6f 6e 74 61 69 6e 73 20 61 67 67 72 65 67 61 contains aggrega
16a70 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a te functions..**
16a80 0a 2a 2a 20 49 66 20 45 78 70 72 2e 6f 70 3d 3d .** If Expr.op==
16a90 54 4b 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 6f 72 TK_AGG_COLUMN or
16aa0 20 54 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e TK_AGG_FUNCTION
16ab0 20 74 68 65 6e 20 45 78 70 72 2e 70 41 67 67 49 then Expr.pAggI
16ac0 6e 66 6f 20 69 73 20 61 0a 2a 2a 20 70 6f 69 6e nfo is a.** poin
16ad0 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 ter to this stru
16ae0 63 74 75 72 65 2e 20 20 54 68 65 20 45 78 70 72 cture. The Expr
16af0 2e 69 43 6f 6c 75 6d 6e 20 66 69 65 6c 64 20 69 .iColumn field i
16b00 73 20 74 68 65 20 69 6e 64 65 78 20 69 6e 0a 2a s the index in.*
16b10 2a 20 41 67 67 49 6e 66 6f 2e 61 43 6f 6c 5b 5d * AggInfo.aCol[]
16b20 20 6f 72 20 41 67 67 49 6e 66 6f 2e 61 46 75 6e or AggInfo.aFun
16b30 63 5b 5d 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 c[] of informati
16b40 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e on needed to gen
16b50 65 72 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f erate.** code fo
16b60 72 20 74 68 61 74 20 6e 6f 64 65 2e 0a 2a 2a 0a r that node..**.
16b70 2a 2a 20 41 67 67 49 6e 66 6f 2e 70 47 72 6f 75 ** AggInfo.pGrou
16b80 70 42 79 20 61 6e 64 20 41 67 67 49 6e 66 6f 2e pBy and AggInfo.
16b90 61 46 75 6e 63 2e 70 45 78 70 72 20 70 6f 69 6e aFunc.pExpr poin
16ba0 74 20 74 6f 20 66 69 65 6c 64 73 20 77 69 74 68 t to fields with
16bb0 69 6e 20 74 68 65 0a 2a 2a 20 6f 72 69 67 69 6e in the.** origin
16bc0 61 6c 20 53 65 6c 65 63 74 20 73 74 72 75 63 74 al Select struct
16bd0 75 72 65 20 74 68 61 74 20 64 65 73 63 72 69 62 ure that describ
16be0 65 73 20 74 68 65 20 53 45 4c 45 43 54 20 73 74 es the SELECT st
16bf0 61 74 65 6d 65 6e 74 2e 20 20 54 68 65 73 65 0a atement. These.
16c00 2a 2a 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f 74 ** fields do not
16c10 20 6e 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 need to be free
16c20 64 20 77 68 65 6e 20 64 65 61 6c 6c 6f 63 61 74 d when deallocat
16c30 69 6e 67 20 74 68 65 20 41 67 67 49 6e 66 6f 20 ing the AggInfo
16c40 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 structure..*/.st
16c50 72 75 63 74 20 41 67 67 49 6e 66 6f 20 7b 0a 20 ruct AggInfo {.
16c60 20 75 38 20 64 69 72 65 63 74 4d 6f 64 65 3b 20 u8 directMode;
16c70 20 20 20 20 20 20 20 20 20 2f 2a 20 44 69 72 65 /* Dire
16c80 63 74 20 72 65 6e 64 65 72 69 6e 67 20 6d 6f 64 ct rendering mod
16c90 65 20 6d 65 61 6e 73 20 74 61 6b 65 20 64 61 74 e means take dat
16ca0 61 20 64 69 72 65 63 74 6c 79 0a 20 20 20 20 20 a directly.
16cb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16cc0 20 20 20 20 20 2a 2a 20 66 72 6f 6d 20 73 6f 75 ** from sou
16cd0 72 63 65 20 74 61 62 6c 65 73 20 72 61 74 68 65 rce tables rathe
16ce0 72 20 74 68 61 6e 20 66 72 6f 6d 20 61 63 63 75 r than from accu
16cf0 6d 75 6c 61 74 6f 72 73 20 2a 2f 0a 20 20 75 38 mulators */. u8
16d00 20 75 73 65 53 6f 72 74 69 6e 67 49 64 78 3b 20 useSortingIdx;
16d10 20 20 20 20 20 20 2f 2a 20 49 6e 20 64 69 72 65 /* In dire
16d20 63 74 20 6d 6f 64 65 2c 20 72 65 66 65 72 65 6e ct mode, referen
16d30 63 65 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 ce the sorting i
16d40 6e 64 65 78 20 72 61 74 68 65 72 0a 20 20 20 20 ndex rather.
16d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16d60 20 20 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 68 ** than th
16d70 65 20 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a e source table *
16d80 2f 0a 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 49 /. int sortingI
16d90 64 78 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43 dx; /* C
16da0 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 ursor number of
16db0 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 the sorting inde
16dc0 78 20 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74 69 x */. int sorti
16dd0 6e 67 49 64 78 50 54 61 62 3b 20 20 20 20 20 2f ngIdxPTab; /
16de0 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 * Cursor number
16df0 6f 66 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 20 of pseudo-table
16e00 2a 2f 0a 20 20 69 6e 74 20 6e 53 6f 72 74 69 6e */. int nSortin
16e10 67 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a 20 gColumn; /*
16e20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e Number of column
16e30 73 20 69 6e 20 74 68 65 20 73 6f 72 74 69 6e 67 s in the sorting
16e40 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 index */. int
16e50 6d 6e 52 65 67 2c 20 6d 78 52 65 67 3b 20 20 20 mnReg, mxReg;
16e60 20 20 20 20 2f 2a 20 52 61 6e 67 65 20 6f 66 20 /* Range of
16e70 72 65 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 registers alloca
16e80 74 65 64 20 66 6f 72 20 61 43 6f 6c 20 61 6e 64 ted for aCol and
16e90 20 61 46 75 6e 63 20 2a 2f 0a 20 20 45 78 70 72 aFunc */. Expr
16ea0 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 79 3b 20 List *pGroupBy;
16eb0 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 /* The group
16ec0 20 62 79 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 by clause */.
16ed0 73 74 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 63 struct AggInfo_c
16ee0 6f 6c 20 7b 20 20 20 20 2f 2a 20 46 6f 72 20 65 ol { /* For e
16ef0 61 63 68 20 63 6f 6c 75 6d 6e 20 75 73 65 64 20 ach column used
16f00 69 6e 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 in source tables
16f10 20 2a 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 */. Table *p
16f20 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 Tab;
16f30 20 2f 2a 20 53 6f 75 72 63 65 20 74 61 62 6c 65 /* Source table
16f40 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 54 61 62 */. int iTab
16f50 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 le;
16f60 20 2f 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 /* Cursor numbe
16f70 72 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 r of the source
16f80 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 table */. int
16f90 20 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 iColumn;
16fa0 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 /* Column
16fb0 6e 75 6d 62 65 72 20 77 69 74 68 69 6e 20 74 68 number within th
16fc0 65 20 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a e source table *
16fd0 2f 0a 20 20 20 20 69 6e 74 20 69 53 6f 72 74 65 /. int iSorte
16fe0 72 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 2f rColumn; /
16ff0 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 * Column number
17000 69 6e 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 in the sorting i
17010 6e 64 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ndex */. int
17020 69 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 iMem;
17030 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c /* Memory l
17040 6f 63 61 74 69 6f 6e 20 74 68 61 74 20 61 63 74 ocation that act
17050 73 20 61 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 s as accumulator
17060 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 */. Expr *pE
17070 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 xpr;
17080 20 2f 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c /* The original
17090 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 expression */.
170a0 20 7d 20 2a 61 43 6f 6c 3b 0a 20 20 69 6e 74 20 } *aCol;. int
170b0 6e 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 nColumn;
170c0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
170d0 20 75 73 65 64 20 65 6e 74 72 69 65 73 20 69 6e used entries in
170e0 20 61 43 6f 6c 5b 5d 20 2a 2f 0a 20 20 69 6e 74 aCol[] */. int
170f0 20 6e 41 63 63 75 6d 75 6c 61 74 6f 72 3b 20 20 nAccumulator;
17100 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
17110 66 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 73 f columns that s
17120 68 6f 77 20 74 68 72 6f 75 67 68 20 74 6f 20 74 how through to t
17130 68 65 20 6f 75 74 70 75 74 2e 0a 20 20 20 20 20 he output..
17140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17150 20 20 20 20 20 2a 2a 20 41 64 64 69 74 69 6f 6e ** Addition
17160 61 6c 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 75 al columns are u
17170 73 65 64 20 6f 6e 6c 79 20 61 73 20 70 61 72 61 sed only as para
17180 6d 65 74 65 72 73 20 74 6f 0a 20 20 20 20 20 20 meters to.
17190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
171a0 20 20 20 20 2a 2a 20 61 67 67 72 65 67 61 74 65 ** aggregate
171b0 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 functions */.
171c0 73 74 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 66 struct AggInfo_f
171d0 75 6e 63 20 7b 20 20 20 2f 2a 20 46 6f 72 20 65 unc { /* For e
171e0 61 63 68 20 61 67 67 72 65 67 61 74 65 20 66 75 ach aggregate fu
171f0 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 45 78 nction */. Ex
17200 70 72 20 2a 70 45 78 70 72 3b 20 20 20 20 20 20 pr *pExpr;
17210 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 /* Expres
17220 73 69 6f 6e 20 65 6e 63 6f 64 69 6e 67 20 74 68 sion encoding th
17230 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 e function */.
17240 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 FuncDef *pFunc
17250 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ; /* Th
17260 65 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 e aggregate func
17270 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 tion implementat
17280 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 ion */. int i
17290 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 Mem;
172a0 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f /* Memory lo
172b0 63 61 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 cation that acts
172c0 20 61 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 as accumulator
172d0 2a 2f 0a 20 20 20 20 69 6e 74 20 69 44 69 73 74 */. int iDist
172e0 69 6e 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 inct;
172f0 2f 2a 20 45 70 68 65 6d 65 72 61 6c 20 74 61 62 /* Ephemeral tab
17300 6c 65 20 75 73 65 64 20 74 6f 20 65 6e 66 6f 72 le used to enfor
17310 63 65 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 20 ce DISTINCT */.
17320 20 7d 20 2a 61 46 75 6e 63 3b 0a 20 20 69 6e 74 } *aFunc;. int
17330 20 6e 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 nFunc;
17340 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
17350 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 46 75 f entries in aFu
17360 6e 63 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a nc[] */.};../*.*
17370 2a 20 54 68 65 20 64 61 74 61 74 79 70 65 20 79 * The datatype y
17380 6e 56 61 72 20 69 73 20 61 20 73 69 67 6e 65 64 nVar is a signed
17390 20 69 6e 74 65 67 65 72 2c 20 65 69 74 68 65 72 integer, either
173a0 20 31 36 2d 62 69 74 20 6f 72 20 33 32 2d 62 69 16-bit or 32-bi
173b0 74 2e 0a 2a 2a 20 55 73 75 61 6c 6c 79 20 69 74 t..** Usually it
173c0 20 69 73 20 31 36 2d 62 69 74 73 2e 20 20 42 75 is 16-bits. Bu
173d0 74 20 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f t if SQLITE_MAX_
173e0 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 20 VARIABLE_NUMBER
173f0 69 73 20 67 72 65 61 74 65 72 0a 2a 2a 20 74 68 is greater.** th
17400 61 6e 20 33 32 37 36 37 20 77 65 20 68 61 76 65 an 32767 we have
17410 20 74 6f 20 6d 61 6b 65 20 69 74 20 33 32 2d 62 to make it 32-b
17420 69 74 2e 20 20 31 36 2d 62 69 74 20 69 73 20 70 it. 16-bit is p
17430 72 65 66 65 72 72 65 64 20 62 65 63 61 75 73 65 referred because
17440 0a 2a 2a 20 69 74 20 75 73 65 73 20 6c 65 73 73 .** it uses less
17450 20 6d 65 6d 6f 72 79 20 69 6e 20 74 68 65 20 45 memory in the E
17460 78 70 72 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 xpr object, whic
17470 68 20 69 73 20 61 20 62 69 67 20 6d 65 6d 6f 72 h is a big memor
17480 79 20 75 73 65 72 0a 2a 2a 20 69 6e 20 73 79 73 y user.** in sys
17490 74 65 6d 73 20 77 69 74 68 20 6c 6f 74 73 20 6f tems with lots o
174a0 66 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 f prepared state
174b0 6d 65 6e 74 73 2e 20 20 41 6e 64 20 66 65 77 20 ments. And few
174c0 61 70 70 6c 69 63 61 74 69 6f 6e 73 0a 2a 2a 20 applications.**
174d0 6e 65 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 61 need more than a
174e0 62 6f 75 74 20 31 30 20 6f 72 20 32 30 20 76 61 bout 10 or 20 va
174f0 72 69 61 62 6c 65 73 2e 20 20 42 75 74 20 73 6f riables. But so
17500 6d 65 20 65 78 74 72 65 6d 65 20 75 73 65 72 73 me extreme users
17510 20 77 61 6e 74 0a 2a 2a 20 74 6f 20 68 61 76 65 want.** to have
17520 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d prepared statem
17530 65 6e 74 73 20 77 69 74 68 20 6f 76 65 72 20 33 ents with over 3
17540 32 37 36 37 20 76 61 72 69 61 62 6c 65 73 2c 20 2767 variables,
17550 61 6e 64 20 66 6f 72 20 74 68 65 6d 0a 2a 2a 20 and for them.**
17560 74 68 65 20 6f 70 74 69 6f 6e 20 69 73 20 61 76 the option is av
17570 61 69 6c 61 62 6c 65 20 28 61 74 20 63 6f 6d 70 ailable (at comp
17580 69 6c 65 2d 74 69 6d 65 29 2e 0a 2a 2f 0a 23 69 ile-time)..*/.#i
17590 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 f SQLITE_MAX_VAR
175a0 49 41 42 4c 45 5f 4e 55 4d 42 45 52 3c 3d 33 32 IABLE_NUMBER<=32
175b0 37 36 37 0a 74 79 70 65 64 65 66 20 69 31 36 20 767.typedef i16
175c0 79 6e 56 61 72 3b 0a 23 65 6c 73 65 0a 74 79 70 ynVar;.#else.typ
175d0 65 64 65 66 20 69 6e 74 20 79 6e 56 61 72 3b 0a edef int ynVar;.
175e0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 61 #endif../*.** Ea
175f0 63 68 20 6e 6f 64 65 20 6f 66 20 61 6e 20 65 78 ch node of an ex
17600 70 72 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 pression in the
17610 70 61 72 73 65 20 74 72 65 65 20 69 73 20 61 6e parse tree is an
17620 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 instance.** of
17630 74 68 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a this structure..
17640 2a 2a 0a 2a 2a 20 45 78 70 72 2e 6f 70 20 69 73 **.** Expr.op is
17650 20 74 68 65 20 6f 70 63 6f 64 65 2e 20 54 68 65 the opcode. The
17660 20 69 6e 74 65 67 65 72 20 70 61 72 73 65 72 20 integer parser
17670 74 6f 6b 65 6e 20 63 6f 64 65 73 20 61 72 65 20 token codes are
17680 72 65 75 73 65 64 0a 2a 2a 20 61 73 20 6f 70 63 reused.** as opc
17690 6f 64 65 73 20 68 65 72 65 2e 20 46 6f 72 20 65 odes here. For e
176a0 78 61 6d 70 6c 65 2c 20 74 68 65 20 70 61 72 73 xample, the pars
176b0 65 72 20 64 65 66 69 6e 65 73 20 54 4b 5f 47 45 er defines TK_GE
176c0 20 74 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 65 to be an intege
176d0 72 0a 2a 2a 20 63 6f 64 65 20 72 65 70 72 65 73 r.** code repres
176e0 65 6e 74 69 6e 67 20 74 68 65 20 22 3e 3d 22 20 enting the ">="
176f0 6f 70 65 72 61 74 6f 72 2e 20 54 68 69 73 20 73 operator. This s
17700 61 6d 65 20 69 6e 74 65 67 65 72 20 63 6f 64 65 ame integer code
17710 20 69 73 20 72 65 75 73 65 64 0a 2a 2a 20 74 6f is reused.** to
17720 20 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 67 represent the g
17730 72 65 61 74 65 72 2d 74 68 61 6e 2d 6f 72 2d 65 reater-than-or-e
17740 71 75 61 6c 2d 74 6f 20 6f 70 65 72 61 74 6f 72 qual-to operator
17750 20 69 6e 20 74 68 65 20 65 78 70 72 65 73 73 69 in the expressi
17760 6f 6e 0a 2a 2a 20 74 72 65 65 2e 0a 2a 2a 0a 2a on.** tree..**.*
17770 2a 20 49 66 20 74 68 65 20 65 78 70 72 65 73 73 * If the express
17780 69 6f 6e 20 69 73 20 61 6e 20 53 51 4c 20 6c 69 ion is an SQL li
17790 74 65 72 61 6c 20 28 54 4b 5f 49 4e 54 45 47 45 teral (TK_INTEGE
177a0 52 2c 20 54 4b 5f 46 4c 4f 41 54 2c 20 54 4b 5f R, TK_FLOAT, TK_
177b0 42 4c 4f 42 2c 0a 2a 2a 20 6f 72 20 54 4b 5f 53 BLOB,.** or TK_S
177c0 54 52 49 4e 47 29 2c 20 74 68 65 6e 20 45 78 70 TRING), then Exp
177d0 72 2e 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 r.token contains
177e0 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 the text of the
177f0 20 53 51 4c 20 6c 69 74 65 72 61 6c 2e 20 49 66 SQL literal. If
17800 0a 2a 2a 20 74 68 65 20 65 78 70 72 65 73 73 69 .** the expressi
17810 6f 6e 20 69 73 20 61 20 76 61 72 69 61 62 6c 65 on is a variable
17820 20 28 54 4b 5f 56 41 52 49 41 42 4c 45 29 2c 20 (TK_VARIABLE),
17830 74 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 then Expr.token
17840 63 6f 6e 74 61 69 6e 73 20 74 68 65 0a 2a 2a 20 contains the.**
17850 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 2e 20 46 variable name. F
17860 69 6e 61 6c 6c 79 2c 20 69 66 20 74 68 65 20 65 inally, if the e
17870 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 xpression is an
17880 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 28 54 4b SQL function (TK
17890 5f 46 55 4e 43 54 49 4f 4e 29 2c 0a 2a 2a 20 74 _FUNCTION),.** t
178a0 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 hen Expr.token c
178b0 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 ontains the name
178c0 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e of the function
178d0 2e 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e 70 52 69 ..**.** Expr.pRi
178e0 67 68 74 20 61 6e 64 20 45 78 70 72 2e 70 4c 65 ght and Expr.pLe
178f0 66 74 20 61 72 65 20 74 68 65 20 6c 65 66 74 20 ft are the left
17900 61 6e 64 20 72 69 67 68 74 20 73 75 62 65 78 70 and right subexp
17910 72 65 73 73 69 6f 6e 73 20 6f 66 20 61 0a 2a 2a ressions of a.**
17920 20 62 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 binary operator
17930 2e 20 45 69 74 68 65 72 20 6f 72 20 62 6f 74 68 . Either or both
17940 20 6d 61 79 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2a may be NULL..**
17950 0a 2a 2a 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 .** Expr.x.pList
17960 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 61 72 is a list of ar
17970 67 75 6d 65 6e 74 73 20 69 66 20 74 68 65 20 65 guments if the e
17980 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 xpression is an
17990 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a SQL function,.**
179a0 20 61 20 43 41 53 45 20 65 78 70 72 65 73 73 69 a CASE expressi
179b0 6f 6e 20 6f 72 20 61 6e 20 49 4e 20 65 78 70 72 on or an IN expr
179c0 65 73 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f ession of the fo
179d0 72 6d 20 22 3c 6c 68 73 3e 20 49 4e 20 28 3c 79 rm "<lhs> IN (<y
179e0 3e 2c 20 3c 7a 3e 2e 2e 2e 29 22 2e 0a 2a 2a 20 >, <z>...)"..**
179f0 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 Expr.x.pSelect i
17a00 73 20 75 73 65 64 20 69 66 20 74 68 65 20 65 78 s used if the ex
17a10 70 72 65 73 73 69 6f 6e 20 69 73 20 61 20 73 75 pression is a su
17a20 62 2d 73 65 6c 65 63 74 20 6f 72 20 61 6e 20 65 b-select or an e
17a30 78 70 72 65 73 73 69 6f 6e 20 6f 66 0a 2a 2a 20 xpression of.**
17a40 74 68 65 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 the form "<lhs>
17a50 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 IN (SELECT ...)"
17a60 2e 20 49 66 20 74 68 65 20 45 50 5f 78 49 73 53 . If the EP_xIsS
17a70 65 6c 65 63 74 20 62 69 74 20 69 73 20 73 65 74 elect bit is set
17a80 20 69 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e in the.** Expr.
17a90 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e flags mask, then
17aa0 20 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 Expr.x.pSelect
17ab0 69 73 20 76 61 6c 69 64 2e 20 4f 74 68 65 72 77 is valid. Otherw
17ac0 69 73 65 2c 20 45 78 70 72 2e 78 2e 70 4c 69 73 ise, Expr.x.pLis
17ad0 74 20 69 73 0a 2a 2a 20 76 61 6c 69 64 2e 0a 2a t is.** valid..*
17ae0 2a 0a 2a 2a 20 41 6e 20 65 78 70 72 65 73 73 69 *.** An expressi
17af0 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 49 on of the form I
17b00 44 20 6f 72 20 49 44 2e 49 44 20 72 65 66 65 72 D or ID.ID refer
17b10 73 20 74 6f 20 61 20 63 6f 6c 75 6d 6e 20 69 6e s to a column in
17b20 20 61 20 74 61 62 6c 65 2e 0a 2a 2a 20 46 6f 72 a table..** For
17b30 20 73 75 63 68 20 65 78 70 72 65 73 73 69 6f 6e such expression
17b40 73 2c 20 45 78 70 72 2e 6f 70 20 69 73 20 73 65 s, Expr.op is se
17b50 74 20 74 6f 20 54 4b 5f 43 4f 4c 55 4d 4e 20 61 t to TK_COLUMN a
17b60 6e 64 20 45 78 70 72 2e 69 54 61 62 6c 65 20 69 nd Expr.iTable i
17b70 73 0a 2a 2a 20 74 68 65 20 69 6e 74 65 67 65 72 s.** the integer
17b80 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f cursor number o
17b90 66 20 61 20 56 44 42 45 20 63 75 72 73 6f 72 20 f a VDBE cursor
17ba0 70 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 61 74 pointing to that
17bb0 20 74 61 62 6c 65 20 61 6e 64 0a 2a 2a 20 45 78 table and.** Ex
17bc0 70 72 2e 69 43 6f 6c 75 6d 6e 20 69 73 20 74 68 pr.iColumn is th
17bd0 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 e column number
17be0 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 63 for the specific
17bf0 20 63 6f 6c 75 6d 6e 2e 20 20 49 66 20 74 68 65 column. If the
17c00 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 69 .** expression i
17c10 73 20 75 73 65 64 20 61 73 20 61 20 72 65 73 75 s used as a resu
17c20 6c 74 20 69 6e 20 61 6e 20 61 67 67 72 65 67 61 lt in an aggrega
17c30 74 65 20 53 45 4c 45 43 54 2c 20 74 68 65 6e 20 te SELECT, then
17c40 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 the.** value is
17c50 61 6c 73 6f 20 73 74 6f 72 65 64 20 69 6e 20 74 also stored in t
17c60 68 65 20 45 78 70 72 2e 69 41 67 67 20 63 6f 6c he Expr.iAgg col
17c70 75 6d 6e 20 69 6e 20 74 68 65 20 61 67 67 72 65 umn in the aggre
17c80 67 61 74 65 20 73 6f 20 74 68 61 74 0a 2a 2a 20 gate so that.**
17c90 69 74 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 it can be access
17ca0 65 64 20 61 66 74 65 72 20 61 6c 6c 20 61 67 67 ed after all agg
17cb0 72 65 67 61 74 65 73 20 61 72 65 20 63 6f 6d 70 regates are comp
17cc0 75 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 uted..**.** If t
17cd0 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 he expression is
17ce0 20 61 6e 20 75 6e 62 6f 75 6e 64 20 76 61 72 69 an unbound vari
17cf0 61 62 6c 65 20 6d 61 72 6b 65 72 20 28 61 20 71 able marker (a q
17d00 75 65 73 74 69 6f 6e 20 6d 61 72 6b 0a 2a 2a 20 uestion mark.**
17d10 63 68 61 72 61 63 74 65 72 20 27 3f 27 20 69 6e character '?' in
17d20 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 the original SQ
17d30 4c 29 20 74 68 65 6e 20 74 68 65 20 45 78 70 72 L) then the Expr
17d40 2e 69 54 61 62 6c 65 20 68 6f 6c 64 73 20 74 68 .iTable holds th
17d50 65 20 69 6e 64 65 78 0a 2a 2a 20 6e 75 6d 62 65 e index.** numbe
17d60 72 20 66 6f 72 20 74 68 61 74 20 76 61 72 69 61 r for that varia
17d70 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ble..**.** If th
17d80 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 e expression is
17d90 61 20 73 75 62 71 75 65 72 79 20 74 68 65 6e 20 a subquery then
17da0 45 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 68 6f 6c Expr.iColumn hol
17db0 64 73 20 61 6e 20 69 6e 74 65 67 65 72 0a 2a 2a ds an integer.**
17dc0 20 72 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 register number
17dd0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 containing the
17de0 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 73 75 result of the su
17df0 62 71 75 65 72 79 2e 20 20 49 66 20 74 68 65 0a bquery. If the.
17e00 2a 2a 20 73 75 62 71 75 65 72 79 20 67 69 76 65 ** subquery give
17e10 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 72 65 73 s a constant res
17e20 75 6c 74 2c 20 74 68 65 6e 20 69 54 61 62 6c 65 ult, then iTable
17e30 20 69 73 20 2d 31 2e 20 20 49 66 20 74 68 65 20 is -1. If the
17e40 73 75 62 71 75 65 72 79 0a 2a 2a 20 67 69 76 65 subquery.** give
17e50 73 20 61 20 64 69 66 66 65 72 65 6e 74 20 61 6e s a different an
17e60 73 77 65 72 20 61 74 20 64 69 66 66 65 72 65 6e swer at differen
17e70 74 20 74 69 6d 65 73 20 64 75 72 69 6e 67 20 73 t times during s
17e80 74 61 74 65 6d 65 6e 74 20 70 72 6f 63 65 73 73 tatement process
17e90 69 6e 67 0a 2a 2a 20 74 68 65 6e 20 69 54 61 62 ing.** then iTab
17ea0 6c 65 20 69 73 20 74 68 65 20 61 64 64 72 65 73 le is the addres
17eb0 73 20 6f 66 20 61 20 73 75 62 72 6f 75 74 69 6e s of a subroutin
17ec0 65 20 74 68 61 74 20 63 6f 6d 70 75 74 65 73 20 e that computes
17ed0 74 68 65 20 73 75 62 71 75 65 72 79 2e 0a 2a 2a the subquery..**
17ee0 0a 2a 2a 20 49 66 20 74 68 65 20 45 78 70 72 20 .** If the Expr
17ef0 69 73 20 6f 66 20 74 79 70 65 20 4f 50 5f 43 6f is of type OP_Co
17f00 6c 75 6d 6e 2c 20 61 6e 64 20 74 68 65 20 74 61 lumn, and the ta
17f10 62 6c 65 20 69 74 20 69 73 20 73 65 6c 65 63 74 ble it is select
17f20 69 6e 67 20 66 72 6f 6d 0a 2a 2a 20 69 73 20 61 ing from.** is a
17f30 20 64 69 73 6b 20 74 61 62 6c 65 20 6f 72 20 74 disk table or t
17f40 68 65 20 22 6f 6c 64 2e 2a 22 20 70 73 65 75 64 he "old.*" pseud
17f50 6f 2d 74 61 62 6c 65 2c 20 74 68 65 6e 20 70 54 o-table, then pT
17f60 61 62 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 ab points to the
17f70 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e .** correspondin
17f80 67 20 74 61 62 6c 65 20 64 65 66 69 6e 69 74 69 g table definiti
17f90 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 4c 4c 4f 43 41 on..**.** ALLOCA
17fa0 54 49 4f 4e 20 4e 4f 54 45 53 3a 0a 2a 2a 0a 2a TION NOTES:.**.*
17fb0 2a 20 45 78 70 72 20 6f 62 6a 65 63 74 73 20 63 * Expr objects c
17fc0 61 6e 20 75 73 65 20 61 20 6c 6f 74 20 6f 66 20 an use a lot of
17fd0 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 69 6e 20 memory space in
17fe0 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e database schema.
17ff0 20 20 54 6f 0a 2a 2a 20 68 65 6c 70 20 72 65 64 To.** help red
18000 75 63 65 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 uce memory requi
18010 72 65 6d 65 6e 74 73 2c 20 73 6f 6d 65 74 69 6d rements, sometim
18020 65 73 20 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 es an Expr objec
18030 74 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 74 72 75 t will be.** tru
18040 6e 63 61 74 65 64 2e 20 20 41 6e 64 20 74 6f 20 ncated. And to
18050 72 65 64 75 63 65 20 74 68 65 20 6e 75 6d 62 65 reduce the numbe
18060 72 20 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f r of memory allo
18070 63 61 74 69 6f 6e 73 2c 20 73 6f 6d 65 74 69 6d cations, sometim
18080 65 73 0a 2a 2a 20 74 77 6f 20 6f 72 20 6d 6f 72 es.** two or mor
18090 65 20 45 78 70 72 20 6f 62 6a 65 63 74 73 20 77 e Expr objects w
180a0 69 6c 6c 20 62 65 20 73 74 6f 72 65 64 20 69 6e ill be stored in
180b0 20 61 20 73 69 6e 67 6c 65 20 6d 65 6d 6f 72 79 a single memory
180c0 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a 20 allocation,.**
180d0 74 6f 67 65 74 68 65 72 20 77 69 74 68 20 45 78 together with Ex
180e0 70 72 2e 7a 54 6f 6b 65 6e 20 73 74 72 69 6e 67 pr.zToken string
180f0 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 s..**.** If the
18100 45 50 5f 52 65 64 75 63 65 64 20 61 6e 64 20 45 EP_Reduced and E
18110 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 67 P_TokenOnly flag
18120 73 20 61 72 65 20 73 65 74 20 77 68 65 6e 0a 2a s are set when.*
18130 2a 20 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 74 * an Expr object
18140 20 69 73 20 74 72 75 6e 63 61 74 65 64 2e 20 20 is truncated.
18150 57 68 65 6e 20 45 50 5f 52 65 64 75 63 65 64 20 When EP_Reduced
18160 69 73 20 73 65 74 2c 20 74 68 65 6e 20 61 6c 6c is set, then all
18170 0a 2a 2a 20 74 68 65 20 63 68 69 6c 64 20 45 78 .** the child Ex
18180 70 72 20 6f 62 6a 65 63 74 73 20 69 6e 20 74 68 pr objects in th
18190 65 20 45 78 70 72 2e 70 4c 65 66 74 20 61 6e 64 e Expr.pLeft and
181a0 20 45 78 70 72 2e 70 52 69 67 68 74 20 73 75 62 Expr.pRight sub
181b0 74 72 65 65 73 0a 2a 2a 20 61 72 65 20 63 6f 6e trees.** are con
181c0 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 74 68 tained within th
181d0 65 20 73 61 6d 65 20 6d 65 6d 6f 72 79 20 61 6c e same memory al
181e0 6c 6f 63 61 74 69 6f 6e 2e 20 20 4e 6f 74 65 2c location. Note,
181f0 20 68 6f 77 65 76 65 72 2c 20 74 68 61 74 0a 2a however, that.*
18200 2a 20 74 68 65 20 73 75 62 74 72 65 65 73 20 69 * the subtrees i
18210 6e 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 6f n Expr.x.pList o
18220 72 20 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 r Expr.x.pSelect
18230 20 61 72 65 20 61 6c 77 61 79 73 20 73 65 70 61 are always sepa
18240 72 61 74 65 6c 79 0a 2a 2a 20 61 6c 6c 6f 63 61 rately.** alloca
18250 74 65 64 2c 20 72 65 67 61 72 64 6c 65 73 73 20 ted, regardless
18260 6f 66 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f of whether or no
18270 74 20 45 50 5f 52 65 64 75 63 65 64 20 69 73 20 t EP_Reduced is
18280 73 65 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 set..*/.struct E
18290 78 70 72 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 xpr {. u8 op;
182a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
182b0 2a 20 4f 70 65 72 61 74 69 6f 6e 20 70 65 72 66 * Operation perf
182c0 6f 72 6d 65 64 20 62 79 20 74 68 69 73 20 6e 6f ormed by this no
182d0 64 65 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 de */. char aff
182e0 69 6e 69 74 79 3b 20 20 20 20 20 20 20 20 20 2f inity; /
182f0 2a 20 54 68 65 20 61 66 66 69 6e 69 74 79 20 6f * The affinity o
18300 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6f 72 20 f the column or
18310 30 20 69 66 20 6e 6f 74 20 61 20 63 6f 6c 75 6d 0 if not a colum
18320 6e 20 2a 2f 0a 20 20 75 33 32 20 66 6c 61 67 73 n */. u32 flags
18330 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
18340 20 56 61 72 69 6f 75 73 20 66 6c 61 67 73 2e 20 Various flags.
18350 20 45 50 5f 2a 20 53 65 65 20 62 65 6c 6f 77 20 EP_* See below
18360 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 */. union {.
18370 20 63 68 61 72 20 2a 7a 54 6f 6b 65 6e 3b 20 20 char *zToken;
18380 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e /* Token
18390 20 76 61 6c 75 65 2e 20 5a 65 72 6f 20 74 65 72 value. Zero ter
183a0 6d 69 6e 61 74 65 64 20 61 6e 64 20 64 65 71 75 minated and dequ
183b0 6f 74 65 64 20 2a 2f 0a 20 20 20 20 69 6e 74 20 oted */. int
183c0 69 56 61 6c 75 65 3b 20 20 20 20 20 20 20 20 20 iValue;
183d0 20 20 20 2f 2a 20 4e 6f 6e 2d 6e 65 67 61 74 69 /* Non-negati
183e0 76 65 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 ve integer value
183f0 20 69 66 20 45 50 5f 49 6e 74 56 61 6c 75 65 20 if EP_IntValue
18400 2a 2f 0a 20 20 7d 20 75 3b 0a 0a 20 20 2f 2a 20 */. } u;.. /*
18410 49 66 20 74 68 65 20 45 50 5f 54 6f 6b 65 6e 4f If the EP_TokenO
18420 6e 6c 79 20 66 6c 61 67 20 69 73 20 73 65 74 20 nly flag is set
18430 69 6e 20 74 68 65 20 45 78 70 72 2e 66 6c 61 67 in the Expr.flag
18440 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 6e 6f 0a s mask, then no.
18450 20 20 2a 2a 20 73 70 61 63 65 20 69 73 20 61 6c ** space is al
18460 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 located for the
18470 66 69 65 6c 64 73 20 62 65 6c 6f 77 20 74 68 69 fields below thi
18480 73 20 70 6f 69 6e 74 2e 20 41 6e 20 61 74 74 65 s point. An atte
18490 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 61 63 63 65 mpt to. ** acce
184a0 73 73 20 74 68 65 6d 20 77 69 6c 6c 20 72 65 73 ss them will res
184b0 75 6c 74 20 69 6e 20 61 20 73 65 67 66 61 75 6c ult in a segfaul
184c0 74 20 6f 72 20 6d 61 6c 66 75 6e 63 74 69 6f 6e t or malfunction
184d0 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .. ************
184e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
184f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18500 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18510 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 45 78 *********/.. Ex
18520 70 72 20 2a 70 4c 65 66 74 3b 20 20 20 20 20 20 pr *pLeft;
18530 20 20 20 20 20 2f 2a 20 4c 65 66 74 20 73 75 62 /* Left sub
18540 6e 6f 64 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a node */. Expr *
18550 70 52 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 pRight;
18560 20 2f 2a 20 52 69 67 68 74 20 73 75 62 6e 6f 64 /* Right subnod
18570 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 e */. union {.
18580 20 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4c 69 ExprList *pLi
18590 73 74 3b 20 20 20 20 20 2f 2a 20 6f 70 20 3d 20 st; /* op =
185a0 49 4e 2c 20 45 58 49 53 54 53 2c 20 53 45 4c 45 IN, EXISTS, SELE
185b0 43 54 2c 20 43 41 53 45 2c 20 46 55 4e 43 54 49 CT, CASE, FUNCTI
185c0 4f 4e 2c 20 42 45 54 57 45 45 4e 20 2a 2f 0a 20 ON, BETWEEN */.
185d0 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 Select *pSele
185e0 63 74 3b 20 20 20 20 20 2f 2a 20 45 50 5f 78 49 ct; /* EP_xI
185f0 73 53 65 6c 65 63 74 20 61 6e 64 20 6f 70 20 3d sSelect and op =
18600 20 49 4e 2c 20 45 58 49 53 54 53 2c 20 53 45 4c IN, EXISTS, SEL
18610 45 43 54 20 2a 2f 0a 20 20 7d 20 78 3b 0a 0a 20 ECT */. } x;..
18620 20 2f 2a 20 49 66 20 74 68 65 20 45 50 5f 52 65 /* If the EP_Re
18630 64 75 63 65 64 20 66 6c 61 67 20 69 73 20 73 65 duced flag is se
18640 74 20 69 6e 20 74 68 65 20 45 78 70 72 2e 66 6c t in the Expr.fl
18650 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 6e ags mask, then n
18660 6f 0a 20 20 2a 2a 20 73 70 61 63 65 20 69 73 20 o. ** space is
18670 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 allocated for th
18680 65 20 66 69 65 6c 64 73 20 62 65 6c 6f 77 20 74 e fields below t
18690 68 69 73 20 70 6f 69 6e 74 2e 20 41 6e 20 61 74 his point. An at
186a0 74 65 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 61 63 tempt to. ** ac
186b0 63 65 73 73 20 74 68 65 6d 20 77 69 6c 6c 20 72 cess them will r
186c0 65 73 75 6c 74 20 69 6e 20 61 20 73 65 67 66 61 esult in a segfa
186d0 75 6c 74 20 6f 72 20 6d 61 6c 66 75 6e 63 74 69 ult or malfuncti
186e0 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a on.. **********
186f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18700 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18710 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
18720 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 23 69 ***********/..#i
18730 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 f SQLITE_MAX_EXP
18740 52 5f 44 45 50 54 48 3e 30 0a 20 20 69 6e 74 20 R_DEPTH>0. int
18750 6e 48 65 69 67 68 74 3b 20 20 20 20 20 20 20 20 nHeight;
18760 20 20 20 2f 2a 20 48 65 69 67 68 74 20 6f 66 20 /* Height of
18770 74 68 65 20 74 72 65 65 20 68 65 61 64 65 64 20 the tree headed
18780 62 79 20 74 68 69 73 20 6e 6f 64 65 20 2a 2f 0a by this node */.
18790 23 65 6e 64 69 66 0a 20 20 69 6e 74 20 69 54 61 #endif. int iTa
187a0 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ble;
187b0 2f 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 75 /* TK_COLUMN: cu
187c0 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 rsor number of t
187d0 61 62 6c 65 20 68 6f 6c 64 69 6e 67 20 63 6f 6c able holding col
187e0 75 6d 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 umn.
187f0 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 **
18800 54 4b 5f 52 45 47 49 53 54 45 52 3a 20 72 65 67 TK_REGISTER: reg
18810 69 73 74 65 72 20 6e 75 6d 62 65 72 0a 20 20 20 ister number.
18820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18830 20 20 20 20 20 20 2a 2a 20 54 4b 5f 54 52 49 47 ** TK_TRIG
18840 47 45 52 3a 20 31 20 2d 3e 20 6e 65 77 2c 20 30 GER: 1 -> new, 0
18850 20 2d 3e 20 6f 6c 64 0a 20 20 20 20 20 20 20 20 -> old.
18860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18870 20 2a 2a 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 3a ** EP_Unlikely:
18880 20 20 31 33 34 32 31 37 37 32 38 20 74 69 6d 65 134217728 time
18890 73 20 6c 69 6b 65 6c 69 68 6f 6f 64 0a 20 20 20 s likelihood.
188a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
188b0 20 20 20 20 20 20 2a 2a 20 54 4b 5f 53 45 4c 45 ** TK_SELE
188c0 43 54 3a 20 31 73 74 20 72 65 67 69 73 74 65 72 CT: 1st register
188d0 20 6f 66 20 72 65 73 75 6c 74 20 76 65 63 74 6f of result vecto
188e0 72 20 2a 2f 0a 20 20 79 6e 56 61 72 20 69 43 6f r */. ynVar iCo
188f0 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a lumn; /*
18900 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c 75 TK_COLUMN: colu
18910 6d 6e 20 69 6e 64 65 78 2e 20 20 2d 31 20 66 6f mn index. -1 fo
18920 72 20 72 6f 77 69 64 2e 0a 20 20 20 20 20 20 20 r rowid..
18930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18940 20 20 2a 2a 20 54 4b 5f 56 41 52 49 41 42 4c 45 ** TK_VARIABLE
18950 3a 20 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 : variable numbe
18960 72 20 28 61 6c 77 61 79 73 20 3e 3d 20 31 29 2e r (always >= 1).
18970 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
18980 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f ** TK_
18990 53 45 4c 45 43 54 5f 43 4f 4c 55 4d 4e 3a 20 63 SELECT_COLUMN: c
189a0 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 olumn of the res
189b0 75 6c 74 20 76 65 63 74 6f 72 20 2a 2f 0a 20 20 ult vector */.
189c0 69 31 36 20 69 41 67 67 3b 20 20 20 20 20 20 20 i16 iAgg;
189d0 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 /* Which
189e0 65 6e 74 72 79 20 69 6e 20 70 41 67 67 49 6e 66 entry in pAggInf
189f0 6f 2d 3e 61 43 6f 6c 5b 5d 20 6f 72 20 2d 3e 61 o->aCol[] or ->a
18a00 46 75 6e 63 5b 5d 20 2a 2f 0a 20 20 69 31 36 20 Func[] */. i16
18a10 69 52 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 3b iRightJoinTable;
18a20 20 20 20 2f 2a 20 49 66 20 45 50 5f 46 72 6f 6d /* If EP_From
18a30 4a 6f 69 6e 2c 20 74 68 65 20 72 69 67 68 74 20 Join, the right
18a40 74 61 62 6c 65 20 6f 66 20 74 68 65 20 6a 6f 69 table of the joi
18a50 6e 20 2a 2f 0a 20 20 75 38 20 6f 70 32 3b 20 20 n */. u8 op2;
18a60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
18a70 20 54 4b 5f 52 45 47 49 53 54 45 52 3a 20 6f 72 TK_REGISTER: or
18a80 69 67 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 iginal value of
18a90 45 78 70 72 2e 6f 70 0a 20 20 20 20 20 20 20 20 Expr.op.
18aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18ab0 20 2a 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 74 ** TK_COLUMN: t
18ac0 68 65 20 76 61 6c 75 65 20 6f 66 20 70 35 20 66 he value of p5 f
18ad0 6f 72 20 4f 50 5f 43 6f 6c 75 6d 6e 0a 20 20 20 or OP_Column.
18ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18af0 20 20 20 20 20 20 2a 2a 20 54 4b 5f 41 47 47 5f ** TK_AGG_
18b00 46 55 4e 43 54 49 4f 4e 3a 20 6e 65 73 74 69 6e FUNCTION: nestin
18b10 67 20 64 65 70 74 68 20 2a 2f 0a 20 20 41 67 67 g depth */. Agg
18b20 49 6e 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 Info *pAggInfo;
18b30 20 20 20 20 2f 2a 20 55 73 65 64 20 62 79 20 54 /* Used by T
18b40 4b 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 61 6e 64 K_AGG_COLUMN and
18b50 20 54 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e TK_AGG_FUNCTION
18b60 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 */. Table *pTa
18b70 62 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 b; /*
18b80 54 61 62 6c 65 20 66 6f 72 20 54 4b 5f 43 4f 4c Table for TK_COL
18b90 55 4d 4e 20 65 78 70 72 65 73 73 69 6f 6e 73 2e UMN expressions.
18ba0 20 20 43 61 6e 20 62 65 20 4e 55 4c 4c 0a 20 20 Can be NULL.
18bb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18bc0 20 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 61 20 ** for a
18bd0 63 6f 6c 75 6d 6e 20 6f 66 20 61 6e 20 69 6e 64 column of an ind
18be0 65 78 20 6f 6e 20 61 6e 20 65 78 70 72 65 73 73 ex on an express
18bf0 69 6f 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ion */.};../*.**
18c00 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 The following a
18c10 72 65 20 74 68 65 20 6d 65 61 6e 69 6e 67 73 20 re the meanings
18c20 6f 66 20 62 69 74 73 20 69 6e 20 74 68 65 20 45 of bits in the E
18c30 78 70 72 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e xpr.flags field.
18c40 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 46 .*/.#define EP_F
18c50 72 6f 6d 4a 6f 69 6e 20 20 30 78 30 30 30 30 30 romJoin 0x00000
18c60 31 20 2f 2a 20 4f 72 69 67 69 6e 61 74 65 73 20 1 /* Originates
18c70 69 6e 20 4f 4e 2f 55 53 49 4e 47 20 63 6c 61 75 in ON/USING clau
18c80 73 65 20 6f 66 20 6f 75 74 65 72 20 6a 6f 69 6e se of outer join
18c90 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 */.#define EP_A
18ca0 67 67 20 20 20 20 20 20 20 30 78 30 30 30 30 30 gg 0x00000
18cb0 32 20 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 6f 6e 2 /* Contains on
18cc0 65 20 6f 72 20 6d 6f 72 65 20 61 67 67 72 65 67 e or more aggreg
18cd0 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f ate functions */
18ce0 0a 23 64 65 66 69 6e 65 20 45 50 5f 48 61 73 46 .#define EP_HasF
18cf0 75 6e 63 20 20 20 30 78 30 30 30 30 30 34 20 2f unc 0x000004 /
18d00 2a 20 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f * Contains one o
18d10 72 20 6d 6f 72 65 20 66 75 6e 63 74 69 6f 6e 73 r more functions
18d20 20 6f 66 20 61 6e 79 20 6b 69 6e 64 20 2a 2f 0a of any kind */.
18d30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18d40 20 20 2f 2a 20 30 78 30 30 30 30 30 38 20 2f 2f /* 0x000008 //
18d50 20 61 76 61 69 6c 61 62 6c 65 20 66 6f 72 20 75 available for u
18d60 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 se */.#define EP
18d70 5f 44 69 73 74 69 6e 63 74 20 20 30 78 30 30 30 _Distinct 0x000
18d80 30 31 30 20 2f 2a 20 41 67 67 72 65 67 61 74 65 010 /* Aggregate
18d90 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 44 function with D
18da0 49 53 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 20 ISTINCT keyword
18db0 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 56 61 */.#define EP_Va
18dc0 72 53 65 6c 65 63 74 20 30 78 30 30 30 30 32 30 rSelect 0x000020
18dd0 20 2f 2a 20 70 53 65 6c 65 63 74 20 69 73 20 63 /* pSelect is c
18de0 6f 72 72 65 6c 61 74 65 64 2c 20 6e 6f 74 20 63 orrelated, not c
18df0 6f 6e 73 74 61 6e 74 20 2a 2f 0a 23 64 65 66 69 onstant */.#defi
18e00 6e 65 20 45 50 5f 44 62 6c 51 75 6f 74 65 64 20 ne EP_DblQuoted
18e10 30 78 30 30 30 30 34 30 20 2f 2a 20 74 6f 6b 65 0x000040 /* toke
18e20 6e 2e 7a 20 77 61 73 20 6f 72 69 67 69 6e 61 6c n.z was original
18e30 6c 79 20 69 6e 20 22 2e 2e 2e 22 20 2a 2f 0a 23 ly in "..." */.#
18e40 64 65 66 69 6e 65 20 45 50 5f 49 6e 66 69 78 46 define EP_InfixF
18e50 75 6e 63 20 30 78 30 30 30 30 38 30 20 2f 2a 20 unc 0x000080 /*
18e60 54 72 75 65 20 66 6f 72 20 61 6e 20 69 6e 66 69 True for an infi
18e70 78 20 66 75 6e 63 74 69 6f 6e 3a 20 4c 49 4b 45 x function: LIKE
18e80 2c 20 47 4c 4f 42 2c 20 65 74 63 20 2a 2f 0a 23 , GLOB, etc */.#
18e90 64 65 66 69 6e 65 20 45 50 5f 43 6f 6c 6c 61 74 define EP_Collat
18ea0 65 20 20 20 30 78 30 30 30 31 30 30 20 2f 2a 20 e 0x000100 /*
18eb0 54 72 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 Tree contains a
18ec0 54 4b 5f 43 4f 4c 4c 41 54 45 20 6f 70 65 72 61 TK_COLLATE opera
18ed0 74 6f 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 tor */.#define E
18ee0 50 5f 47 65 6e 65 72 69 63 20 20 20 30 78 30 30 P_Generic 0x00
18ef0 30 32 30 30 20 2f 2a 20 49 67 6e 6f 72 65 20 43 0200 /* Ignore C
18f00 4f 4c 4c 41 54 45 20 6f 72 20 61 66 66 69 6e 69 OLLATE or affini
18f10 74 79 20 6f 6e 20 74 68 69 73 20 74 72 65 65 20 ty on this tree
18f20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 49 6e */.#define EP_In
18f30 74 56 61 6c 75 65 20 20 30 78 30 30 30 34 30 30 tValue 0x000400
18f40 20 2f 2a 20 49 6e 74 65 67 65 72 20 76 61 6c 75 /* Integer valu
18f50 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 75 e contained in u
18f60 2e 69 56 61 6c 75 65 20 2a 2f 0a 23 64 65 66 69 .iValue */.#defi
18f70 6e 65 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 ne EP_xIsSelect
18f80 30 78 30 30 30 38 30 30 20 2f 2a 20 78 2e 70 53 0x000800 /* x.pS
18f90 65 6c 65 63 74 20 69 73 20 76 61 6c 69 64 20 28 elect is valid (
18fa0 6f 74 68 65 72 77 69 73 65 20 78 2e 70 4c 69 73 otherwise x.pLis
18fb0 74 20 69 73 29 20 2a 2f 0a 23 64 65 66 69 6e 65 t is) */.#define
18fc0 20 45 50 5f 53 6b 69 70 20 20 20 20 20 20 30 78 EP_Skip 0x
18fd0 30 30 31 30 30 30 20 2f 2a 20 43 4f 4c 4c 41 54 001000 /* COLLAT
18fe0 45 2c 20 41 53 2c 20 6f 72 20 55 4e 4c 49 4b 45 E, AS, or UNLIKE
18ff0 4c 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 LY */.#define EP
19000 5f 52 65 64 75 63 65 64 20 20 20 30 78 30 30 32 _Reduced 0x002
19010 30 30 30 20 2f 2a 20 45 78 70 72 20 73 74 72 75 000 /* Expr stru
19020 63 74 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 ct EXPR_REDUCEDS
19030 49 5a 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a IZE bytes only *
19040 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 54 6f 6b /.#define EP_Tok
19050 65 6e 4f 6e 6c 79 20 30 78 30 30 34 30 30 30 20 enOnly 0x004000
19060 2f 2a 20 45 78 70 72 20 73 74 72 75 63 74 20 45 /* Expr struct E
19070 58 50 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a XPR_TOKENONLYSIZ
19080 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a E bytes only */.
19090 23 64 65 66 69 6e 65 20 45 50 5f 53 74 61 74 69 #define EP_Stati
190a0 63 20 20 20 20 30 78 30 30 38 30 30 30 20 2f 2a c 0x008000 /*
190b0 20 48 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 Held in memory
190c0 6e 6f 74 20 6f 62 74 61 69 6e 65 64 20 66 72 6f not obtained fro
190d0 6d 20 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 23 64 m malloc() */.#d
190e0 65 66 69 6e 65 20 45 50 5f 4d 65 6d 54 6f 6b 65 efine EP_MemToke
190f0 6e 20 20 30 78 30 31 30 30 30 30 20 2f 2a 20 4e n 0x010000 /* N
19100 65 65 64 20 74 6f 20 73 71 6c 69 74 65 33 44 62 eed to sqlite3Db
19110 46 72 65 65 28 29 20 45 78 70 72 2e 7a 54 6f 6b Free() Expr.zTok
19120 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 en */.#define EP
19130 5f 4e 6f 52 65 64 75 63 65 20 20 30 78 30 32 30 _NoReduce 0x020
19140 30 30 30 20 2f 2a 20 43 61 6e 6e 6f 74 20 45 58 000 /* Cannot EX
19150 50 52 44 55 50 5f 52 45 44 55 43 45 20 74 68 69 PRDUP_REDUCE thi
19160 73 20 45 78 70 72 20 2a 2f 0a 23 64 65 66 69 6e s Expr */.#defin
19170 65 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 20 20 30 e EP_Unlikely 0
19180 78 30 34 30 30 30 30 20 2f 2a 20 75 6e 6c 69 6b x040000 /* unlik
19190 65 6c 79 28 29 20 6f 72 20 6c 69 6b 65 6c 69 68 ely() or likelih
191a0 6f 6f 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a ood() function *
191b0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 6f 6e /.#define EP_Con
191c0 73 74 46 75 6e 63 20 30 78 30 38 30 30 30 30 20 stFunc 0x080000
191d0 2f 2a 20 41 20 53 51 4c 49 54 45 5f 46 55 4e 43 /* A SQLITE_FUNC
191e0 5f 43 4f 4e 53 54 41 4e 54 20 6f 72 20 5f 53 4c _CONSTANT or _SL
191f0 4f 43 48 4e 47 20 66 75 6e 63 74 69 6f 6e 20 2a OCHNG function *
19200 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 61 6e /.#define EP_Can
19210 42 65 4e 75 6c 6c 20 30 78 31 30 30 30 30 30 20 BeNull 0x100000
19220 2f 2a 20 43 61 6e 20 62 65 20 6e 75 6c 6c 20 64 /* Can be null d
19230 65 73 70 69 74 65 20 4e 4f 54 20 4e 55 4c 4c 20 espite NOT NULL
19240 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 64 constraint */.#d
19250 65 66 69 6e 65 20 45 50 5f 53 75 62 71 75 65 72 efine EP_Subquer
19260 79 20 20 30 78 32 30 30 30 30 30 20 2f 2a 20 54 y 0x200000 /* T
19270 72 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 ree contains a T
19280 4b 5f 53 45 4c 45 43 54 20 6f 70 65 72 61 74 6f K_SELECT operato
19290 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f r */.#define EP_
192a0 41 6c 69 61 73 20 20 20 20 20 30 78 34 30 30 30 Alias 0x4000
192b0 30 30 20 2f 2a 20 49 73 20 61 6e 20 61 6c 69 61 00 /* Is an alia
192c0 73 20 66 6f 72 20 61 20 72 65 73 75 6c 74 20 73 s for a result s
192d0 65 74 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 65 et column */.#de
192e0 66 69 6e 65 20 45 50 5f 4c 65 61 66 20 20 20 20 fine EP_Leaf
192f0 20 20 30 78 38 30 30 30 30 30 20 2f 2a 20 45 78 0x800000 /* Ex
19300 70 72 2e 70 4c 65 66 74 2c 20 2e 70 52 69 67 68 pr.pLeft, .pRigh
19310 74 2c 20 2e 75 2e 70 53 65 6c 65 63 74 20 61 6c t, .u.pSelect al
19320 6c 20 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a l NULL */../*.**
19330 20 54 68 65 20 45 50 5f 50 72 6f 70 61 67 61 74 The EP_Propagat
19340 65 20 6d 61 73 6b 20 69 73 20 61 20 73 65 74 20 e mask is a set
19350 6f 66 20 70 72 6f 70 65 72 74 69 65 73 20 74 68 of properties th
19360 61 74 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 at automatically
19370 20 70 72 6f 70 61 67 61 74 65 0a 2a 2a 20 75 70 propagate.** up
19380 77 61 72 64 73 20 69 6e 74 6f 20 70 61 72 65 6e wards into paren
19390 74 20 6e 6f 64 65 73 2e 0a 2a 2f 0a 23 64 65 66 t nodes..*/.#def
193a0 69 6e 65 20 45 50 5f 50 72 6f 70 61 67 61 74 65 ine EP_Propagate
193b0 20 28 45 50 5f 43 6f 6c 6c 61 74 65 7c 45 50 5f (EP_Collate|EP_
193c0 53 75 62 71 75 65 72 79 7c 45 50 5f 48 61 73 46 Subquery|EP_HasF
193d0 75 6e 63 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 unc)../*.** Thes
193e0 65 20 6d 61 63 72 6f 73 20 63 61 6e 20 62 65 20 e macros can be
193f0 75 73 65 64 20 74 6f 20 74 65 73 74 2c 20 73 65 used to test, se
19400 74 2c 20 6f 72 20 63 6c 65 61 72 20 62 69 74 73 t, or clear bits
19410 20 69 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e in the.** Expr.
19420 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a flags field..*/.
19430 23 64 65 66 69 6e 65 20 45 78 70 72 48 61 73 50 #define ExprHasP
19440 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 20 roperty(E,P)
19450 20 28 28 28 45 29 2d 3e 66 6c 61 67 73 26 28 50 (((E)->flags&(P
19460 29 29 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 45 ))!=0).#define E
19470 78 70 72 48 61 73 41 6c 6c 50 72 6f 70 65 72 74 xprHasAllPropert
19480 79 28 45 2c 50 29 20 20 28 28 28 45 29 2d 3e 66 y(E,P) (((E)->f
19490 6c 61 67 73 26 28 50 29 29 3d 3d 28 50 29 29 0a lags&(P))==(P)).
194a0 23 64 65 66 69 6e 65 20 45 78 70 72 53 65 74 50 #define ExprSetP
194b0 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 20 roperty(E,P)
194c0 20 28 45 29 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 (E)->flags|=(P)
194d0 0a 23 64 65 66 69 6e 65 20 45 78 70 72 43 6c 65 .#define ExprCle
194e0 61 72 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 arProperty(E,P)
194f0 20 20 28 45 29 2d 3e 66 6c 61 67 73 26 3d 7e 28 (E)->flags&=~(
19500 50 29 0a 0a 2f 2a 20 54 68 65 20 45 78 70 72 53 P)../* The ExprS
19510 65 74 56 56 41 50 72 6f 70 65 72 74 79 28 29 20 etVVAProperty()
19520 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 66 6f macro is used fo
19530 72 20 56 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 r Verification,
19540 56 61 6c 69 64 61 74 69 6f 6e 2c 0a 2a 2a 20 61 Validation,.** a
19550 6e 64 20 41 63 63 72 65 64 69 74 61 74 69 6f 6e nd Accreditation
19560 20 6f 6e 6c 79 2e 20 20 49 74 20 77 6f 72 6b 73 only. It works
19570 20 6c 69 6b 65 20 45 78 70 72 53 65 74 50 72 6f like ExprSetPro
19580 70 65 72 74 79 28 29 20 64 75 72 69 6e 67 20 56 perty() during V
19590 56 41 0a 2a 2a 20 70 72 6f 63 65 73 73 65 73 20 VA.** processes
195a0 62 75 74 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 but is a no-op f
195b0 6f 72 20 64 65 6c 69 76 65 72 79 2e 0a 2a 2f 0a or delivery..*/.
195c0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
195d0 42 55 47 0a 23 20 64 65 66 69 6e 65 20 45 78 70 BUG.# define Exp
195e0 72 53 65 74 56 56 41 50 72 6f 70 65 72 74 79 28 rSetVVAProperty(
195f0 45 2c 50 29 20 20 28 45 29 2d 3e 66 6c 61 67 73 E,P) (E)->flags
19600 7c 3d 28 50 29 0a 23 65 6c 73 65 0a 23 20 64 65 |=(P).#else.# de
19610 66 69 6e 65 20 45 78 70 72 53 65 74 56 56 41 50 fine ExprSetVVAP
19620 72 6f 70 65 72 74 79 28 45 2c 50 29 0a 23 65 6e roperty(E,P).#en
19630 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f dif../*.** Macro
19640 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 s to determine t
19650 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
19660 65 73 20 72 65 71 75 69 72 65 64 20 62 79 20 61 es required by a
19670 20 6e 6f 72 6d 61 6c 20 45 78 70 72 0a 2a 2a 20 normal Expr.**
19680 73 74 72 75 63 74 2c 20 61 6e 20 45 78 70 72 20 struct, an Expr
19690 73 74 72 75 63 74 20 77 69 74 68 20 74 68 65 20 struct with the
196a0 45 50 5f 52 65 64 75 63 65 64 20 66 6c 61 67 20 EP_Reduced flag
196b0 73 65 74 20 69 6e 20 45 78 70 72 2e 66 6c 61 67 set in Expr.flag
196c0 73 0a 2a 2a 20 61 6e 64 20 61 6e 20 45 78 70 72 s.** and an Expr
196d0 20 73 74 72 75 63 74 20 77 69 74 68 20 74 68 65 struct with the
196e0 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c EP_TokenOnly fl
196f0 61 67 20 73 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 ag set..*/.#defi
19700 6e 65 20 45 58 50 52 5f 46 55 4c 4c 53 49 5a 45 ne EXPR_FULLSIZE
19710 20 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f sizeo
19720 66 28 45 78 70 72 29 20 20 20 20 20 20 20 20 20 f(Expr)
19730 20 20 2f 2a 20 46 75 6c 6c 20 73 69 7a 65 20 2a /* Full size *
19740 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 5f 52 /.#define EXPR_R
19750 45 44 55 43 45 44 53 49 5a 45 20 20 20 20 20 20 EDUCEDSIZE
19760 20 20 6f 66 66 73 65 74 6f 66 28 45 78 70 72 2c offsetof(Expr,
19770 69 54 61 62 6c 65 29 20 20 2f 2a 20 43 6f 6d 6d iTable) /* Comm
19780 6f 6e 20 66 65 61 74 75 72 65 73 20 2a 2f 0a 23 on features */.#
19790 64 65 66 69 6e 65 20 45 58 50 52 5f 54 4f 4b 45 define EXPR_TOKE
197a0 4e 4f 4e 4c 59 53 49 5a 45 20 20 20 20 20 20 6f NONLYSIZE o
197b0 66 66 73 65 74 6f 66 28 45 78 70 72 2c 70 4c 65 ffsetof(Expr,pLe
197c0 66 74 29 20 20 20 2f 2a 20 46 65 77 65 72 20 66 ft) /* Fewer f
197d0 65 61 74 75 72 65 73 20 2a 2f 0a 0a 2f 2a 0a 2a eatures */../*.*
197e0 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 * Flags passed t
197f0 6f 20 74 68 65 20 73 71 6c 69 74 65 33 45 78 70 o the sqlite3Exp
19800 72 44 75 70 28 29 20 66 75 6e 63 74 69 6f 6e 2e rDup() function.
19810 20 53 65 65 20 74 68 65 20 68 65 61 64 65 72 20 See the header
19820 63 6f 6d 6d 65 6e 74 0a 2a 2a 20 61 62 6f 76 65 comment.** above
19830 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 sqlite3ExprDup(
19840 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a ) for details..*
19850 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 44 55 /.#define EXPRDU
19860 50 5f 52 45 44 55 43 45 20 20 20 20 20 20 20 20 P_REDUCE
19870 20 30 78 30 30 30 31 20 20 2f 2a 20 55 73 65 64 0x0001 /* Used
19880 20 72 65 64 75 63 65 64 2d 73 69 7a 65 20 45 78 reduced-size Ex
19890 70 72 20 6e 6f 64 65 73 20 2a 2f 0a 0a 2f 2a 0a pr nodes */../*.
198a0 2a 2a 20 41 20 6c 69 73 74 20 6f 66 20 65 78 70 ** A list of exp
198b0 72 65 73 73 69 6f 6e 73 2e 20 20 45 61 63 68 20 ressions. Each
198c0 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 79 20 6f expression may o
198d0 70 74 69 6f 6e 61 6c 6c 79 20 68 61 76 65 20 61 ptionally have a
198e0 0a 2a 2a 20 6e 61 6d 65 2e 20 20 41 6e 20 65 78 .** name. An ex
198f0 70 72 2f 6e 61 6d 65 20 63 6f 6d 62 69 6e 61 74 pr/name combinat
19900 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 ion can be used
19910 69 6e 20 73 65 76 65 72 61 6c 20 77 61 79 73 2c in several ways,
19920 20 73 75 63 68 0a 2a 2a 20 61 73 20 74 68 65 20 such.** as the
19930 6c 69 73 74 20 6f 66 20 22 65 78 70 72 20 41 53 list of "expr AS
19940 20 49 44 22 20 66 69 65 6c 64 73 20 66 6f 6c 6c ID" fields foll
19950 6f 77 69 6e 67 20 61 20 22 53 45 4c 45 43 54 22 owing a "SELECT"
19960 20 6f 72 20 69 6e 20 74 68 65 0a 2a 2a 20 6c 69 or in the.** li
19970 73 74 20 6f 66 20 22 49 44 20 3d 20 65 78 70 72 st of "ID = expr
19980 22 20 69 74 65 6d 73 20 69 6e 20 61 6e 20 55 50 " items in an UP
19990 44 41 54 45 2e 20 20 41 20 6c 69 73 74 20 6f 66 DATE. A list of
199a0 20 65 78 70 72 65 73 73 69 6f 6e 73 20 63 61 6e expressions can
199b0 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 75 73 65 64 .** also be used
199c0 20 61 73 20 74 68 65 20 61 72 67 75 6d 65 6e 74 as the argument
199d0 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 to a function,
199e0 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 in which case th
199f0 65 20 61 2e 7a 4e 61 6d 65 0a 2a 2a 20 66 69 65 e a.zName.** fie
19a00 6c 64 20 69 73 20 6e 6f 74 20 75 73 65 64 2e 0a ld is not used..
19a10 2a 2a 0a 2a 2a 20 42 79 20 64 65 66 61 75 6c 74 **.** By default
19a20 20 74 68 65 20 45 78 70 72 2e 7a 53 70 61 6e 20 the Expr.zSpan
19a30 66 69 65 6c 64 20 68 6f 6c 64 73 20 61 20 68 75 field holds a hu
19a40 6d 61 6e 2d 72 65 61 64 61 62 6c 65 20 64 65 73 man-readable des
19a50 63 72 69 70 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 cription of.** t
19a60 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 74 68 he expression th
19a70 61 74 20 69 73 20 75 73 65 64 20 69 6e 20 74 68 at is used in th
19a80 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 e generation of
19a90 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 61 error messages a
19aa0 6e 64 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6c 61 62 nd.** column lab
19ab0 65 6c 73 2e 20 20 49 6e 20 74 68 69 73 20 63 61 els. In this ca
19ac0 73 65 2c 20 45 78 70 72 2e 7a 53 70 61 6e 20 69 se, Expr.zSpan i
19ad0 73 20 74 79 70 69 63 61 6c 6c 79 20 74 68 65 20 s typically the
19ae0 74 65 78 74 20 6f 66 20 61 0a 2a 2a 20 63 6f 6c text of a.** col
19af0 75 6d 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 61 umn expression a
19b00 73 20 69 74 20 65 78 69 73 74 73 20 69 6e 20 61 s it exists in a
19b10 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
19b20 74 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 66 0a t. However, if.
19b30 2a 2a 20 74 68 65 20 62 53 70 61 6e 49 73 54 61 ** the bSpanIsTa
19b40 62 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 b flag is set, t
19b50 68 65 6e 20 7a 53 70 61 6e 20 69 73 20 6f 76 65 hen zSpan is ove
19b60 72 6c 6f 61 64 65 64 20 74 6f 20 6d 65 61 6e 20 rloaded to mean
19b70 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 6f 66 20 74 the name.** of t
19b80 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e he result column
19b90 20 69 6e 20 74 68 65 20 66 6f 72 6d 3a 20 44 41 in the form: DA
19ba0 54 41 42 41 53 45 2e 54 41 42 4c 45 2e 43 4f 4c TABASE.TABLE.COL
19bb0 55 4d 4e 2e 20 20 54 68 69 73 20 6c 61 74 65 72 UMN. This later
19bc0 0a 2a 2a 20 66 6f 72 6d 20 69 73 20 75 73 65 64 .** form is used
19bd0 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 6f 6c 75 for name resolu
19be0 74 69 6f 6e 20 77 69 74 68 20 6e 65 73 74 65 64 tion with nested
19bf0 20 46 52 4f 4d 20 63 6c 61 75 73 65 73 2e 0a 2a FROM clauses..*
19c00 2f 0a 73 74 72 75 63 74 20 45 78 70 72 4c 69 73 /.struct ExprLis
19c10 74 20 7b 0a 20 20 69 6e 74 20 6e 45 78 70 72 3b t {. int nExpr;
19c20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
19c30 4e 75 6d 62 65 72 20 6f 66 20 65 78 70 72 65 73 Number of expres
19c40 73 69 6f 6e 73 20 6f 6e 20 74 68 65 20 6c 69 73 sions on the lis
19c50 74 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 45 78 t */. struct Ex
19c60 70 72 4c 69 73 74 5f 69 74 65 6d 20 7b 20 2f 2a prList_item { /*
19c70 20 46 6f 72 20 65 61 63 68 20 65 78 70 72 65 73 For each expres
19c80 73 69 6f 6e 20 69 6e 20 74 68 65 20 6c 69 73 74 sion in the list
19c90 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 */. Expr *pE
19ca0 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 xpr;
19cb0 2f 2a 20 54 68 65 20 70 61 72 73 65 20 74 72 65 /* The parse tre
19cc0 65 20 66 6f 72 20 74 68 69 73 20 65 78 70 72 65 e for this expre
19cd0 73 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 63 68 61 ssion */. cha
19ce0 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 r *zName;
19cf0 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 61 73 /* Token as
19d00 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
19d10 69 73 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f is expression */
19d20 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 70 61 6e . char *zSpan
19d30 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
19d40 4f 72 69 67 69 6e 61 6c 20 74 65 78 74 20 6f 66 Original text of
19d50 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 the expression
19d60 2a 2f 0a 20 20 20 20 75 38 20 73 6f 72 74 4f 72 */. u8 sortOr
19d70 64 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f der; /
19d80 2a 20 31 20 66 6f 72 20 44 45 53 43 20 6f 72 20 * 1 for DESC or
19d90 30 20 66 6f 72 20 41 53 43 20 2a 2f 0a 20 20 20 0 for ASC */.
19da0 20 75 6e 73 69 67 6e 65 64 20 64 6f 6e 65 20 3a unsigned done :
19db0 31 3b 20 20 20 20 20 20 20 2f 2a 20 41 20 66 6c 1; /* A fl
19dc0 61 67 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 ag to indicate w
19dd0 68 65 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 69 hen processing i
19de0 73 20 66 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 s finished */.
19df0 20 20 75 6e 73 69 67 6e 65 64 20 62 53 70 61 6e unsigned bSpan
19e00 49 73 54 61 62 20 3a 31 3b 20 2f 2a 20 7a 53 70 IsTab :1; /* zSp
19e10 61 6e 20 68 6f 6c 64 73 20 44 42 2e 54 41 42 4c an holds DB.TABL
19e20 45 2e 43 4f 4c 55 4d 4e 20 2a 2f 0a 20 20 20 20 E.COLUMN */.
19e30 75 6e 73 69 67 6e 65 64 20 72 65 75 73 61 62 6c unsigned reusabl
19e40 65 20 3a 31 3b 20 20 20 2f 2a 20 43 6f 6e 73 74 e :1; /* Const
19e50 61 6e 74 20 65 78 70 72 65 73 73 69 6f 6e 20 69 ant expression i
19e60 73 20 72 65 75 73 61 62 6c 65 20 2a 2f 0a 20 20 s reusable */.
19e70 20 20 75 6e 73 69 67 6e 65 64 20 62 53 6f 72 74 unsigned bSort
19e80 65 72 52 65 66 20 3a 31 3b 20 2f 2a 20 44 65 66 erRef :1; /* Def
19e90 65 72 20 65 76 61 6c 75 61 74 69 6f 6e 20 75 6e er evaluation un
19ea0 74 69 6c 20 61 66 74 65 72 20 73 6f 72 74 69 6e til after sortin
19eb0 67 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 20 7b g */. union {
19ec0 0a 20 20 20 20 20 20 73 74 72 75 63 74 20 7b 0a . struct {.
19ed0 20 20 20 20 20 20 20 20 75 31 36 20 69 4f 72 64 u16 iOrd
19ee0 65 72 42 79 43 6f 6c 3b 20 20 20 20 20 20 2f 2a erByCol; /*
19ef0 20 46 6f 72 20 4f 52 44 45 52 20 42 59 2c 20 63 For ORDER BY, c
19f00 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 olumn number in
19f10 72 65 73 75 6c 74 20 73 65 74 20 2a 2f 0a 20 20 result set */.
19f20 20 20 20 20 20 20 75 31 36 20 69 41 6c 69 61 73 u16 iAlias
19f30 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 ; /* I
19f40 6e 64 65 78 20 69 6e 74 6f 20 50 61 72 73 65 2e ndex into Parse.
19f50 61 41 6c 69 61 73 5b 5d 20 66 6f 72 20 7a 4e 61 aAlias[] for zNa
19f60 6d 65 20 2a 2f 0a 20 20 20 20 20 20 7d 20 78 3b me */. } x;
19f70 0a 20 20 20 20 20 20 69 6e 74 20 69 43 6f 6e 73 . int iCons
19f80 74 45 78 70 72 52 65 67 3b 20 20 20 20 20 20 2f tExprReg; /
19f90 2a 20 52 65 67 69 73 74 65 72 20 69 6e 20 77 68 * Register in wh
19fa0 69 63 68 20 45 78 70 72 20 76 61 6c 75 65 20 69 ich Expr value i
19fb0 73 20 63 61 63 68 65 64 20 2a 2f 0a 20 20 20 20 s cached */.
19fc0 7d 20 75 3b 0a 20 20 7d 20 61 5b 31 5d 3b 20 20 } u;. } a[1];
19fd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19fe0 2f 2a 20 4f 6e 65 20 73 6c 6f 74 20 66 6f 72 20 /* One slot for
19ff0 65 61 63 68 20 65 78 70 72 65 73 73 69 6f 6e 20 each expression
1a000 69 6e 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a 7d in the list */.}
1a010 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 ;../*.** An inst
1a020 61 6e 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 ance of this str
1a030 75 63 74 75 72 65 20 63 61 6e 20 68 6f 6c 64 20 ucture can hold
1a040 61 20 73 69 6d 70 6c 65 20 6c 69 73 74 20 6f 66 a simple list of
1a050 20 69 64 65 6e 74 69 66 69 65 72 73 2c 0a 2a 2a identifiers,.**
1a060 20 73 75 63 68 20 61 73 20 74 68 65 20 6c 69 73 such as the lis
1a070 74 20 22 61 2c 62 2c 63 22 20 69 6e 20 74 68 65 t "a,b,c" in the
1a080 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 following state
1a090 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 ments:.**.**
1a0a0 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 28 INSERT INTO t(
1a0b0 61 2c 62 2c 63 29 20 56 41 4c 55 45 53 20 2e 2e a,b,c) VALUES ..
1a0c0 2e 3b 0a 2a 2a 20 20 20 20 20 20 43 52 45 41 54 .;.** CREAT
1a0d0 45 20 49 4e 44 45 58 20 69 64 78 20 4f 4e 20 74 E INDEX idx ON t
1a0e0 28 61 2c 62 2c 63 29 3b 0a 2a 2a 20 20 20 20 20 (a,b,c);.**
1a0f0 20 43 52 45 41 54 45 20 54 52 49 47 47 45 52 20 CREATE TRIGGER
1a100 74 72 69 67 20 42 45 46 4f 52 45 20 55 50 44 41 trig BEFORE UPDA
1a110 54 45 20 4f 4e 20 74 28 61 2c 62 2c 63 29 20 2e TE ON t(a,b,c) .
1a120 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 64 ..;.**.** The Id
1a130 4c 69 73 74 2e 61 2e 69 64 78 20 66 69 65 6c 64 List.a.idx field
1a140 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 is used when th
1a150 65 20 49 64 4c 69 73 74 20 72 65 70 72 65 73 65 e IdList represe
1a160 6e 74 73 20 74 68 65 20 6c 69 73 74 20 6f 66 0a nts the list of.
1a170 2a 2a 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 ** column names
1a180 61 66 74 65 72 20 61 20 74 61 62 6c 65 20 6e 61 after a table na
1a190 6d 65 20 69 6e 20 61 6e 20 49 4e 53 45 52 54 20 me in an INSERT
1a1a0 73 74 61 74 65 6d 65 6e 74 2e 20 20 49 6e 20 74 statement. In t
1a1b0 68 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 0a he statement.**.
1a1c0 2a 2a 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e ** INSERT IN
1a1d0 54 4f 20 74 28 61 2c 62 2c 63 29 20 2e 2e 2e 0a TO t(a,b,c) ....
1a1e0 2a 2a 0a 2a 2a 20 49 66 20 22 61 22 20 69 73 20 **.** If "a" is
1a1f0 74 68 65 20 6b 2d 74 68 20 63 6f 6c 75 6d 6e 20 the k-th column
1a200 6f 66 20 74 61 62 6c 65 20 22 74 22 2c 20 74 68 of table "t", th
1a210 65 6e 20 49 64 4c 69 73 74 2e 61 5b 30 5d 2e 69 en IdList.a[0].i
1a220 64 78 3d 3d 6b 2e 0a 2a 2f 0a 73 74 72 75 63 74 dx==k..*/.struct
1a230 20 49 64 4c 69 73 74 20 7b 0a 20 20 73 74 72 75 IdList {. stru
1a240 63 74 20 49 64 4c 69 73 74 5f 69 74 65 6d 20 7b ct IdList_item {
1a250 0a 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 . char *zName
1a260 3b 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f ; /* Name o
1a270 66 20 74 68 65 20 69 64 65 6e 74 69 66 69 65 72 f the identifier
1a280 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 64 78 3b */. int idx;
1a290 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
1a2a0 65 78 20 69 6e 20 73 6f 6d 65 20 54 61 62 6c 65 ex in some Table
1a2b0 2e 61 43 6f 6c 5b 5d 20 6f 66 20 61 20 63 6f 6c .aCol[] of a col
1a2c0 75 6d 6e 20 6e 61 6d 65 64 20 7a 4e 61 6d 65 20 umn named zName
1a2d0 2a 2f 0a 20 20 7d 20 2a 61 3b 0a 20 20 69 6e 74 */. } *a;. int
1a2e0 20 6e 49 64 3b 20 20 20 20 20 20 20 20 20 2f 2a nId; /*
1a2f0 20 4e 75 6d 62 65 72 20 6f 66 20 69 64 65 6e 74 Number of ident
1a300 69 66 69 65 72 73 20 6f 6e 20 74 68 65 20 6c 69 ifiers on the li
1a310 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 st */.};../*.**
1a320 54 68 65 20 62 69 74 6d 61 73 6b 20 64 61 74 61 The bitmask data
1a330 74 79 70 65 20 64 65 66 69 6e 65 64 20 62 65 6c type defined bel
1a340 6f 77 20 69 73 20 75 73 65 64 20 66 6f 72 20 76 ow is used for v
1a350 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 arious optimizat
1a360 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e ions..**.** Chan
1a370 67 69 6e 67 20 74 68 69 73 20 66 72 6f 6d 20 61 ging this from a
1a380 20 36 34 2d 62 69 74 20 74 6f 20 61 20 33 32 2d 64-bit to a 32-
1a390 62 69 74 20 74 79 70 65 20 6c 69 6d 69 74 73 20 bit type limits
1a3a0 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a the number of.**
1a3b0 20 74 61 62 6c 65 73 20 69 6e 20 61 20 6a 6f 69 tables in a joi
1a3c0 6e 20 74 6f 20 33 32 20 69 6e 73 74 65 61 64 20 n to 32 instead
1a3d0 6f 66 20 36 34 2e 20 20 42 75 74 20 69 74 20 61 of 64. But it a
1a3e0 6c 73 6f 20 72 65 64 75 63 65 73 20 74 68 65 20 lso reduces the
1a3f0 73 69 7a 65 0a 2a 2a 20 6f 66 20 74 68 65 20 6c size.** of the l
1a400 69 62 72 61 72 79 20 62 79 20 37 33 38 20 62 79 ibrary by 738 by
1a410 74 65 73 20 6f 6e 20 69 78 38 36 2e 0a 2a 2f 0a tes on ix86..*/.
1a420 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 42 49 #ifdef SQLITE_BI
1a430 54 4d 41 53 4b 5f 54 59 50 45 0a 20 20 74 79 70 TMASK_TYPE. typ
1a440 65 64 65 66 20 53 51 4c 49 54 45 5f 42 49 54 4d edef SQLITE_BITM
1a450 41 53 4b 5f 54 59 50 45 20 42 69 74 6d 61 73 6b ASK_TYPE Bitmask
1a460 3b 0a 23 65 6c 73 65 0a 20 20 74 79 70 65 64 65 ;.#else. typede
1a470 66 20 75 36 34 20 42 69 74 6d 61 73 6b 3b 0a 23 f u64 Bitmask;.#
1a480 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 endif../*.** The
1a490 20 6e 75 6d 62 65 72 20 6f 66 20 62 69 74 73 20 number of bits
1a4a0 69 6e 20 61 20 42 69 74 6d 61 73 6b 2e 20 20 22 in a Bitmask. "
1a4b0 42 4d 53 22 20 6d 65 61 6e 73 20 22 42 69 74 4d BMS" means "BitM
1a4c0 61 73 6b 20 53 69 7a 65 22 2e 0a 2a 2f 0a 23 64 ask Size"..*/.#d
1a4d0 65 66 69 6e 65 20 42 4d 53 20 20 28 28 69 6e 74 efine BMS ((int
1a4e0 29 28 73 69 7a 65 6f 66 28 42 69 74 6d 61 73 6b )(sizeof(Bitmask
1a4f0 29 2a 38 29 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 62 )*8))../*.** A b
1a500 69 74 20 69 6e 20 61 20 42 69 74 6d 61 73 6b 0a it in a Bitmask.
1a510 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 4b 42 */.#define MASKB
1a520 49 54 28 6e 29 20 20 20 28 28 28 42 69 74 6d 61 IT(n) (((Bitma
1a530 73 6b 29 31 29 3c 3c 28 6e 29 29 0a 23 64 65 66 sk)1)<<(n)).#def
1a540 69 6e 65 20 4d 41 53 4b 42 49 54 33 32 28 6e 29 ine MASKBIT32(n)
1a550 20 28 28 28 75 6e 73 69 67 6e 65 64 20 69 6e 74 (((unsigned int
1a560 29 31 29 3c 3c 28 6e 29 29 0a 23 64 65 66 69 6e )1)<<(n)).#defin
1a570 65 20 41 4c 4c 42 49 54 53 20 20 20 20 20 20 28 e ALLBITS (
1a580 28 42 69 74 6d 61 73 6b 29 2d 31 29 0a 0a 2f 2a (Bitmask)-1)../*
1a590 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
1a5a0 67 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 g structure desc
1a5b0 72 69 62 65 73 20 74 68 65 20 46 52 4f 4d 20 63 ribes the FROM c
1a5c0 6c 61 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43 lause of a SELEC
1a5d0 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 T statement..**
1a5e0 45 61 63 68 20 74 61 62 6c 65 20 6f 72 20 73 75 Each table or su
1a5f0 62 71 75 65 72 79 20 69 6e 20 74 68 65 20 46 52 bquery in the FR
1a600 4f 4d 20 63 6c 61 75 73 65 20 69 73 20 61 20 73 OM clause is a s
1a610 65 70 61 72 61 74 65 20 65 6c 65 6d 65 6e 74 20 eparate element
1a620 6f 66 0a 2a 2a 20 74 68 65 20 53 72 63 4c 69 73 of.** the SrcLis
1a630 74 2e 61 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a t.a[] array..**.
1a640 2a 2a 20 57 69 74 68 20 74 68 65 20 61 64 64 69 ** With the addi
1a650 74 69 6f 6e 20 6f 66 20 6d 75 6c 74 69 70 6c 65 tion of multiple
1a660 20 64 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 database suppor
1a670 74 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 t, the following
1a680 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 63 61 structure.** ca
1a690 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 n also be used t
1a6a0 6f 20 64 65 73 63 72 69 62 65 20 61 20 70 61 72 o describe a par
1a6b0 74 69 63 75 6c 61 72 20 74 61 62 6c 65 20 73 75 ticular table su
1a6c0 63 68 20 61 73 20 74 68 65 20 74 61 62 6c 65 20 ch as the table
1a6d0 74 68 61 74 0a 2a 2a 20 69 73 20 6d 6f 64 69 66 that.** is modif
1a6e0 69 65 64 20 62 79 20 61 6e 20 49 4e 53 45 52 54 ied by an INSERT
1a6f0 2c 20 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 44 , DELETE, or UPD
1a700 41 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 ATE statement.
1a710 49 6e 20 73 74 61 6e 64 61 72 64 20 53 51 4c 2c In standard SQL,
1a720 0a 2a 2a 20 73 75 63 68 20 61 20 74 61 62 6c 65 .** such a table
1a730 20 6d 75 73 74 20 62 65 20 61 20 73 69 6d 70 6c must be a simpl
1a740 65 20 6e 61 6d 65 3a 20 49 44 2e 20 20 42 75 74 e name: ID. But
1a750 20 69 6e 20 53 51 4c 69 74 65 2c 20 74 68 65 20 in SQLite, the
1a760 74 61 62 6c 65 20 63 61 6e 0a 2a 2a 20 6e 6f 77 table can.** now
1a770 20 62 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 be identified b
1a780 79 20 61 20 64 61 74 61 62 61 73 65 20 6e 61 6d y a database nam
1a790 65 2c 20 61 20 64 6f 74 2c 20 74 68 65 6e 20 74 e, a dot, then t
1a7a0 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 3a 20 49 he table name: I
1a7b0 44 2e 49 44 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 D.ID..**.** The
1a7c0 6a 6f 69 6e 74 79 70 65 20 73 74 61 72 74 73 20 jointype starts
1a7d0 6f 75 74 20 73 68 6f 77 69 6e 67 20 74 68 65 20 out showing the
1a7e0 6a 6f 69 6e 20 74 79 70 65 20 62 65 74 77 65 65 join type betwee
1a7f0 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 n the current ta
1a800 62 6c 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 6e ble.** and the n
1a810 65 78 74 20 74 61 62 6c 65 20 6f 6e 20 74 68 65 ext table on the
1a820 20 6c 69 73 74 2e 20 20 54 68 65 20 70 61 72 73 list. The pars
1a830 65 72 20 62 75 69 6c 64 73 20 74 68 65 20 6c 69 er builds the li
1a840 73 74 20 74 68 69 73 20 77 61 79 2e 0a 2a 2a 20 st this way..**
1a850 42 75 74 20 73 71 6c 69 74 65 33 53 72 63 4c 69 But sqlite3SrcLi
1a860 73 74 53 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 stShiftJoinType(
1a870 29 20 6c 61 74 65 72 20 73 68 69 66 74 73 20 74 ) later shifts t
1a880 68 65 20 6a 6f 69 6e 74 79 70 65 73 20 73 6f 20 he jointypes so
1a890 74 68 61 74 20 65 61 63 68 0a 2a 2a 20 6a 6f 69 that each.** joi
1a8a0 6e 74 79 70 65 20 65 78 70 72 65 73 73 65 73 20 ntype expresses
1a8b0 74 68 65 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e the join between
1a8c0 20 74 68 65 20 74 61 62 6c 65 20 61 6e 64 20 74 the table and t
1a8d0 68 65 20 70 72 65 76 69 6f 75 73 20 74 61 62 6c he previous tabl
1a8e0 65 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 e..**.** In the
1a8f0 63 6f 6c 55 73 65 64 20 66 69 65 6c 64 2c 20 74 colUsed field, t
1a900 68 65 20 68 69 67 68 2d 6f 72 64 65 72 20 62 69 he high-order bi
1a910 74 20 28 62 69 74 20 36 33 29 20 69 73 20 73 65 t (bit 63) is se
1a920 74 20 69 66 20 74 68 65 20 74 61 62 6c 65 0a 2a t if the table.*
1a930 2a 20 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 * contains more
1a940 74 68 61 6e 20 36 33 20 63 6f 6c 75 6d 6e 73 20 than 63 columns
1a950 61 6e 64 20 74 68 65 20 36 34 2d 74 68 20 6f 72 and the 64-th or
1a960 20 6c 61 74 65 72 20 63 6f 6c 75 6d 6e 20 69 73 later column is
1a970 20 75 73 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 used..*/.struct
1a980 20 53 72 63 4c 69 73 74 20 7b 0a 20 20 69 6e 74 SrcList {. int
1a990 20 6e 53 72 63 3b 20 20 20 20 20 20 20 20 2f 2a nSrc; /*
1a9a0 20 4e 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 Number of table
1a9b0 73 20 6f 72 20 73 75 62 71 75 65 72 69 65 73 20 s or subqueries
1a9c0 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 in the FROM clau
1a9d0 73 65 20 2a 2f 0a 20 20 75 33 32 20 6e 41 6c 6c se */. u32 nAll
1a9e0 6f 63 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 oc; /* Numb
1a9f0 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 61 6c er of entries al
1aa00 6c 6f 63 61 74 65 64 20 69 6e 20 61 5b 5d 20 62 located in a[] b
1aa10 65 6c 6f 77 20 2a 2f 0a 20 20 73 74 72 75 63 74 elow */. struct
1aa20 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 7b 0a SrcList_item {.
1aa30 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 Schema *pSch
1aa40 65 6d 61 3b 20 20 2f 2a 20 53 63 68 65 6d 61 20 ema; /* Schema
1aa50 74 6f 20 77 68 69 63 68 20 74 68 69 73 20 69 74 to which this it
1aa60 65 6d 20 69 73 20 66 69 78 65 64 20 2a 2f 0a 20 em is fixed */.
1aa70 20 20 20 63 68 61 72 20 2a 7a 44 61 74 61 62 61 char *zDataba
1aa80 73 65 3b 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 se; /* Name of
1aa90 64 61 74 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 database holding
1aaa0 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 this table */.
1aab0 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 char *zName;
1aac0 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
1aad0 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 the table */.
1aae0 20 63 68 61 72 20 2a 7a 41 6c 69 61 73 3b 20 20 char *zAlias;
1aaf0 20 20 20 2f 2a 20 54 68 65 20 22 42 22 20 70 61 /* The "B" pa
1ab00 72 74 20 6f 66 20 61 20 22 41 20 41 53 20 42 22 rt of a "A AS B"
1ab10 20 70 68 72 61 73 65 2e 20 20 7a 4e 61 6d 65 20 phrase. zName
1ab20 69 73 20 74 68 65 20 22 41 22 20 2a 2f 0a 20 20 is the "A" */.
1ab30 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 Table *pTab;
1ab40 20 20 20 20 2f 2a 20 41 6e 20 53 51 4c 20 74 61 /* An SQL ta
1ab50 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e ble correspondin
1ab60 67 20 74 6f 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 g to zName */.
1ab70 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 Select *pSelec
1ab80 74 3b 20 20 2f 2a 20 41 20 53 45 4c 45 43 54 20 t; /* A SELECT
1ab90 73 74 61 74 65 6d 65 6e 74 20 75 73 65 64 20 69 statement used i
1aba0 6e 20 70 6c 61 63 65 20 6f 66 20 61 20 74 61 62 n place of a tab
1abb0 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 69 le name */. i
1abc0 6e 74 20 61 64 64 72 46 69 6c 6c 53 75 62 3b 20 nt addrFillSub;
1abd0 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 73 /* Address of s
1abe0 75 62 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 6e ubroutine to man
1abf0 69 66 65 73 74 20 61 20 73 75 62 71 75 65 72 79 ifest a subquery
1ac00 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 52 */. int regR
1ac10 65 74 75 72 6e 3b 20 20 20 20 2f 2a 20 52 65 67 eturn; /* Reg
1ac20 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 65 ister holding re
1ac30 74 75 72 6e 20 61 64 64 72 65 73 73 20 6f 66 20 turn address of
1ac40 61 64 64 72 46 69 6c 6c 53 75 62 20 2a 2f 0a 20 addrFillSub */.
1ac50 20 20 20 69 6e 74 20 72 65 67 52 65 73 75 6c 74 int regResult
1ac60 3b 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 ; /* Register
1ac70 73 20 68 6f 6c 64 69 6e 67 20 72 65 73 75 6c 74 s holding result
1ac80 73 20 6f 66 20 61 20 63 6f 2d 72 6f 75 74 69 6e s of a co-routin
1ac90 65 20 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 e */. struct
1aca0 7b 0a 20 20 20 20 20 20 75 38 20 6a 6f 69 6e 74 {. u8 joint
1acb0 79 70 65 3b 20 20 20 20 20 20 2f 2a 20 54 79 70 ype; /* Typ
1acc0 65 20 6f 66 20 6a 6f 69 6e 20 62 65 74 77 65 65 e of join betwee
1acd0 6e 20 74 68 69 73 20 74 61 62 6c 65 20 61 6e 64 n this table and
1ace0 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 2a 2f the previous */
1acf0 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 . unsigned
1ad00 6e 6f 74 49 6e 64 65 78 65 64 20 3a 31 3b 20 20 notIndexed :1;
1ad10 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 /* True if the
1ad20 72 65 20 69 73 20 61 20 4e 4f 54 20 49 4e 44 45 re is a NOT INDE
1ad30 58 45 44 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 XED clause */.
1ad40 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 73 49 unsigned isI
1ad50 6e 64 65 78 65 64 42 79 20 3a 31 3b 20 20 20 2f ndexedBy :1; /
1ad60 2a 20 54 72 75 65 20 69 66 20 74 68 65 72 65 20 * True if there
1ad70 69 73 20 61 6e 20 49 4e 44 45 58 45 44 20 42 59 is an INDEXED BY
1ad80 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 20 clause */.
1ad90 20 75 6e 73 69 67 6e 65 64 20 69 73 54 61 62 46 unsigned isTabF
1ada0 75 6e 63 20 3a 31 3b 20 20 20 20 20 2f 2a 20 54 unc :1; /* T
1adb0 72 75 65 20 69 66 20 74 61 62 6c 65 2d 76 61 6c rue if table-val
1adc0 75 65 64 2d 66 75 6e 63 74 69 6f 6e 20 73 79 6e ued-function syn
1add0 74 61 78 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 tax */. uns
1ade0 69 67 6e 65 64 20 69 73 43 6f 72 72 65 6c 61 74 igned isCorrelat
1adf0 65 64 20 3a 31 3b 20 20 2f 2a 20 54 72 75 65 20 ed :1; /* True
1ae00 69 66 20 73 75 62 2d 71 75 65 72 79 20 69 73 20 if sub-query is
1ae10 63 6f 72 72 65 6c 61 74 65 64 20 2a 2f 0a 20 20 correlated */.
1ae20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 76 69 61 unsigned via
1ae30 43 6f 72 6f 75 74 69 6e 65 20 3a 31 3b 20 20 2f Coroutine :1; /
1ae40 2a 20 49 6d 70 6c 65 6d 65 6e 74 65 64 20 61 73 * Implemented as
1ae50 20 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 2a 2f a co-routine */
1ae60 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 . unsigned
1ae70 69 73 52 65 63 75 72 73 69 76 65 20 3a 31 3b 20 isRecursive :1;
1ae80 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 72 65 /* True for re
1ae90 63 75 72 73 69 76 65 20 72 65 66 65 72 65 6e 63 cursive referenc
1aea0 65 20 69 6e 20 57 49 54 48 20 2a 2f 0a 20 20 20 e in WITH */.
1aeb0 20 7d 20 66 67 3b 0a 20 20 20 20 69 6e 74 20 69 } fg;. int i
1aec0 43 75 72 73 6f 72 3b 20 20 20 20 20 20 2f 2a 20 Cursor; /*
1aed0 54 68 65 20 56 44 42 45 20 63 75 72 73 6f 72 20 The VDBE cursor
1aee0 6e 75 6d 62 65 72 20 75 73 65 64 20 74 6f 20 61 number used to a
1aef0 63 63 65 73 73 20 74 68 69 73 20 74 61 62 6c 65 ccess this table
1af00 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 4f */. Expr *pO
1af10 6e 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 n; /* The
1af20 20 4f 4e 20 63 6c 61 75 73 65 20 6f 66 20 61 20 ON clause of a
1af30 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 49 64 4c 69 join */. IdLi
1af40 73 74 20 2a 70 55 73 69 6e 67 3b 20 20 20 2f 2a st *pUsing; /*
1af50 20 54 68 65 20 55 53 49 4e 47 20 63 6c 61 75 73 The USING claus
1af60 65 20 6f 66 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 e of a join */.
1af70 20 20 20 42 69 74 6d 61 73 6b 20 63 6f 6c 55 73 Bitmask colUs
1af80 65 64 3b 20 20 2f 2a 20 42 69 74 20 4e 20 28 31 ed; /* Bit N (1
1af90 3c 3c 4e 29 20 73 65 74 20 69 66 20 63 6f 6c 75 <<N) set if colu
1afa0 6d 6e 20 4e 20 6f 66 20 70 54 61 62 20 69 73 20 mn N of pTab is
1afb0 75 73 65 64 20 2a 2f 0a 20 20 20 20 75 6e 69 6f used */. unio
1afc0 6e 20 7b 0a 20 20 20 20 20 20 63 68 61 72 20 2a n {. char *
1afd0 7a 49 6e 64 65 78 65 64 42 79 3b 20 20 20 20 2f zIndexedBy; /
1afe0 2a 20 49 64 65 6e 74 69 66 69 65 72 20 66 72 6f * Identifier fro
1aff0 6d 20 22 49 4e 44 45 58 45 44 20 42 59 20 3c 7a m "INDEXED BY <z
1b000 49 6e 64 65 78 3e 22 20 63 6c 61 75 73 65 20 2a Index>" clause *
1b010 2f 0a 20 20 20 20 20 20 45 78 70 72 4c 69 73 74 /. ExprList
1b020 20 2a 70 46 75 6e 63 41 72 67 3b 20 20 2f 2a 20 *pFuncArg; /*
1b030 41 72 67 75 6d 65 6e 74 73 20 74 6f 20 74 61 62 Arguments to tab
1b040 6c 65 2d 76 61 6c 75 65 64 2d 66 75 6e 63 74 69 le-valued-functi
1b050 6f 6e 20 2a 2f 0a 20 20 20 20 7d 20 75 31 3b 0a on */. } u1;.
1b060 20 20 20 20 49 6e 64 65 78 20 2a 70 49 42 49 6e Index *pIBIn
1b070 64 65 78 3b 20 20 2f 2a 20 49 6e 64 65 78 20 73 dex; /* Index s
1b080 74 72 75 63 74 75 72 65 20 63 6f 72 72 65 73 70 tructure corresp
1b090 6f 6e 64 69 6e 67 20 74 6f 20 75 31 2e 7a 49 6e onding to u1.zIn
1b0a0 64 65 78 65 64 42 79 20 2a 2f 0a 20 20 7d 20 61 dexedBy */. } a
1b0b0 5b 31 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 [1];
1b0c0 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 20 66 6f /* One entry fo
1b0d0 72 20 65 61 63 68 20 69 64 65 6e 74 69 66 69 65 r each identifie
1b0e0 72 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 2a 2f r on the list */
1b0f0 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 72 6d 69 .};../*.** Permi
1b100 74 74 65 64 20 76 61 6c 75 65 73 20 6f 66 20 74 tted values of t
1b110 68 65 20 53 72 63 4c 69 73 74 2e 61 2e 6a 6f 69 he SrcList.a.joi
1b120 6e 74 79 70 65 20 66 69 65 6c 64 0a 2a 2f 0a 23 ntype field.*/.#
1b130 64 65 66 69 6e 65 20 4a 54 5f 49 4e 4e 45 52 20 define JT_INNER
1b140 20 20 20 20 30 78 30 30 30 31 20 20 20 20 2f 2a 0x0001 /*
1b150 20 41 6e 79 20 6b 69 6e 64 20 6f 66 20 69 6e 6e Any kind of inn
1b160 65 72 20 6f 72 20 63 72 6f 73 73 20 6a 6f 69 6e er or cross join
1b170 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 43 */.#define JT_C
1b180 52 4f 53 53 20 20 20 20 20 30 78 30 30 30 32 20 ROSS 0x0002
1b190 20 20 20 2f 2a 20 45 78 70 6c 69 63 69 74 20 75 /* Explicit u
1b1a0 73 65 20 6f 66 20 74 68 65 20 43 52 4f 53 53 20 se of the CROSS
1b1b0 6b 65 79 77 6f 72 64 20 2a 2f 0a 23 64 65 66 69 keyword */.#defi
1b1c0 6e 65 20 4a 54 5f 4e 41 54 55 52 41 4c 20 20 20 ne JT_NATURAL
1b1d0 30 78 30 30 30 34 20 20 20 20 2f 2a 20 54 72 75 0x0004 /* Tru
1b1e0 65 20 66 6f 72 20 61 20 22 6e 61 74 75 72 61 6c e for a "natural
1b1f0 22 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e " join */.#defin
1b200 65 20 4a 54 5f 4c 45 46 54 20 20 20 20 20 20 30 e JT_LEFT 0
1b210 78 30 30 30 38 20 20 20 20 2f 2a 20 4c 65 66 74 x0008 /* Left
1b220 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a 2f 0a 23 outer join */.#
1b230 64 65 66 69 6e 65 20 4a 54 5f 52 49 47 48 54 20 define JT_RIGHT
1b240 20 20 20 20 30 78 30 30 31 30 20 20 20 20 2f 2a 0x0010 /*
1b250 20 52 69 67 68 74 20 6f 75 74 65 72 20 6a 6f 69 Right outer joi
1b260 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f n */.#define JT_
1b270 4f 55 54 45 52 20 20 20 20 20 30 78 30 30 32 30 OUTER 0x0020
1b280 20 20 20 20 2f 2a 20 54 68 65 20 22 4f 55 54 45 /* The "OUTE
1b290 52 22 20 6b 65 79 77 6f 72 64 20 69 73 20 70 72 R" keyword is pr
1b2a0 65 73 65 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 esent */.#define
1b2b0 20 4a 54 5f 45 52 52 4f 52 20 20 20 20 20 30 78 JT_ERROR 0x
1b2c0 30 30 34 30 20 20 20 20 2f 2a 20 75 6e 6b 6e 6f 0040 /* unkno
1b2d0 77 6e 20 6f 72 20 75 6e 73 75 70 70 6f 72 74 65 wn or unsupporte
1b2e0 64 20 6a 6f 69 6e 20 74 79 70 65 20 2a 2f 0a 0a d join type */..
1b2f0 0a 2f 2a 0a 2a 2a 20 46 6c 61 67 73 20 61 70 70 ./*.** Flags app
1b300 72 6f 70 72 69 61 74 65 20 66 6f 72 20 74 68 65 ropriate for the
1b310 20 77 63 74 72 6c 46 6c 61 67 73 20 70 61 72 61 wctrlFlags para
1b320 6d 65 74 65 72 20 6f 66 20 73 71 6c 69 74 65 33 meter of sqlite3
1b330 57 68 65 72 65 42 65 67 69 6e 28 29 0a 2a 2a 20 WhereBegin().**
1b340 61 6e 64 20 74 68 65 20 57 68 65 72 65 49 6e 66 and the WhereInf
1b350 6f 2e 77 63 74 72 6c 46 6c 61 67 73 20 6d 65 6d o.wctrlFlags mem
1b360 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 ber..**.** Value
1b370 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 65 6e constraints (en
1b380 66 6f 72 63 65 64 20 76 69 61 20 61 73 73 65 72 forced via asser
1b390 74 28 29 29 3a 0a 2a 2a 20 20 20 20 20 57 48 45 t()):.** WHE
1b3a0 52 45 5f 55 53 45 5f 4c 49 4d 49 54 20 20 3d 3d RE_USE_LIMIT ==
1b3b0 20 53 46 5f 46 69 78 65 64 4c 69 6d 69 74 0a 2a SF_FixedLimit.*
1b3c0 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1b3d0 4f 52 44 45 52 42 59 5f 4e 4f 52 4d 41 4c 20 20 ORDERBY_NORMAL
1b3e0 20 30 78 30 30 30 30 20 2f 2a 20 4e 6f 2d 6f 70 0x0000 /* No-op
1b3f0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
1b400 45 5f 4f 52 44 45 52 42 59 5f 4d 49 4e 20 20 20 E_ORDERBY_MIN
1b410 20 20 20 30 78 30 30 30 31 20 2f 2a 20 4f 52 44 0x0001 /* ORD
1b420 45 52 20 42 59 20 70 72 6f 63 65 73 73 69 6e 67 ER BY processing
1b430 20 66 6f 72 20 6d 69 6e 28 29 20 66 75 6e 63 20 for min() func
1b440 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
1b450 5f 4f 52 44 45 52 42 59 5f 4d 41 58 20 20 20 20 _ORDERBY_MAX
1b460 20 20 30 78 30 30 30 32 20 2f 2a 20 4f 52 44 45 0x0002 /* ORDE
1b470 52 20 42 59 20 70 72 6f 63 65 73 73 69 6e 67 20 R BY processing
1b480 66 6f 72 20 6d 61 78 28 29 20 66 75 6e 63 20 2a for max() func *
1b490 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1b4a0 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 45 44 20 ONEPASS_DESIRED
1b4b0 20 30 78 30 30 30 34 20 2f 2a 20 57 61 6e 74 20 0x0004 /* Want
1b4c0 74 6f 20 64 6f 20 6f 6e 65 2d 70 61 73 73 20 55 to do one-pass U
1b4d0 50 44 41 54 45 2f 44 45 4c 45 54 45 20 2a 2f 0a PDATE/DELETE */.
1b4e0 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e #define WHERE_ON
1b4f0 45 50 41 53 53 5f 4d 55 4c 54 49 52 4f 57 20 30 EPASS_MULTIROW 0
1b500 78 30 30 30 38 20 2f 2a 20 4f 4e 45 50 41 53 53 x0008 /* ONEPASS
1b510 20 69 73 20 6f 6b 20 77 69 74 68 20 6d 75 6c 74 is ok with mult
1b520 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a 23 64 65 iple rows */.#de
1b530 66 69 6e 65 20 57 48 45 52 45 5f 44 55 50 4c 49 fine WHERE_DUPLI
1b540 43 41 54 45 53 5f 4f 4b 20 20 20 20 30 78 30 30 CATES_OK 0x00
1b550 31 30 20 2f 2a 20 4f 6b 20 74 6f 20 72 65 74 75 10 /* Ok to retu
1b560 72 6e 20 61 20 72 6f 77 20 6d 6f 72 65 20 74 68 rn a row more th
1b570 61 6e 20 6f 6e 63 65 20 2a 2f 0a 23 64 65 66 69 an once */.#defi
1b580 6e 65 20 57 48 45 52 45 5f 4f 52 5f 53 55 42 43 ne WHERE_OR_SUBC
1b590 4c 41 55 53 45 20 20 20 20 20 30 78 30 30 32 30 LAUSE 0x0020
1b5a0 20 2f 2a 20 50 72 6f 63 65 73 73 69 6e 67 20 61 /* Processing a
1b5b0 20 73 75 62 2d 57 48 45 52 45 20 61 73 20 70 61 sub-WHERE as pa
1b5c0 72 74 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 rt of.
1b5d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b5e0 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 ** t
1b5f0 68 65 20 4f 52 20 6f 70 74 69 6d 69 7a 61 74 69 he OR optimizati
1b600 6f 6e 20 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 on */.#define W
1b610 48 45 52 45 5f 47 52 4f 55 50 42 59 20 20 20 20 HERE_GROUPBY
1b620 20 20 20 20 20 20 30 78 30 30 34 30 20 2f 2a 20 0x0040 /*
1b630 70 4f 72 64 65 72 42 79 20 69 73 20 72 65 61 6c pOrderBy is real
1b640 6c 79 20 61 20 47 52 4f 55 50 20 42 59 20 2a 2f ly a GROUP BY */
1b650 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 .#define WHERE_D
1b660 49 53 54 49 4e 43 54 42 59 20 20 20 20 20 20 20 ISTINCTBY
1b670 30 78 30 30 38 30 20 2f 2a 20 70 4f 72 64 65 72 0x0080 /* pOrder
1b680 62 79 20 69 73 20 72 65 61 6c 6c 79 20 61 20 44 by is really a D
1b690 49 53 54 49 4e 43 54 20 63 6c 61 75 73 65 20 2a ISTINCT clause *
1b6a0 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1b6b0 57 41 4e 54 5f 44 49 53 54 49 4e 43 54 20 20 20 WANT_DISTINCT
1b6c0 20 30 78 30 31 30 30 20 2f 2a 20 41 6c 6c 20 6f 0x0100 /* All o
1b6d0 75 74 70 75 74 20 6e 65 65 64 73 20 74 6f 20 62 utput needs to b
1b6e0 65 20 64 69 73 74 69 6e 63 74 20 2a 2f 0a 23 64 e distinct */.#d
1b6f0 65 66 69 6e 65 20 57 48 45 52 45 5f 53 4f 52 54 efine WHERE_SORT
1b700 42 59 47 52 4f 55 50 20 20 20 20 20 20 30 78 30 BYGROUP 0x0
1b710 32 30 30 20 2f 2a 20 53 75 70 70 6f 72 74 20 73 200 /* Support s
1b720 71 6c 69 74 65 33 57 68 65 72 65 49 73 53 6f 72 qlite3WhereIsSor
1b730 74 65 64 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 ted() */.#define
1b740 20 57 48 45 52 45 5f 53 45 45 4b 5f 54 41 42 4c WHERE_SEEK_TABL
1b750 45 20 20 20 20 20 20 20 30 78 30 34 30 30 20 2f E 0x0400 /
1b760 2a 20 44 6f 20 6e 6f 74 20 64 65 66 65 72 20 73 * Do not defer s
1b770 65 65 6b 73 20 6f 6e 20 6d 61 69 6e 20 74 61 62 eeks on main tab
1b780 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 le */.#define WH
1b790 45 52 45 5f 4f 52 44 45 52 42 59 5f 4c 49 4d 49 ERE_ORDERBY_LIMI
1b7a0 54 20 20 20 20 30 78 30 38 30 30 20 2f 2a 20 4f T 0x0800 /* O
1b7b0 52 44 45 52 42 59 2b 4c 49 4d 49 54 20 6f 6e 20 RDERBY+LIMIT on
1b7c0 74 68 65 20 69 6e 6e 65 72 20 6c 6f 6f 70 20 2a the inner loop *
1b7d0 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1b7e0 53 45 45 4b 5f 55 4e 49 51 5f 54 41 42 4c 45 20 SEEK_UNIQ_TABLE
1b7f0 20 30 78 31 30 30 30 20 2f 2a 20 44 6f 20 6e 6f 0x1000 /* Do no
1b800 74 20 64 65 66 65 72 20 73 65 65 6b 73 20 69 66 t defer seeks if
1b810 20 75 6e 69 71 75 65 20 2a 2f 0a 20 20 20 20 20 unique */.
1b820 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b830 20 20 20 2f 2a 20 20 20 20 20 30 78 32 30 30 30 /* 0x2000
1b840 20 20 20 20 6e 6f 74 20 63 75 72 72 65 6e 74 6c not currentl
1b850 79 20 75 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e y used */.#defin
1b860 65 20 57 48 45 52 45 5f 55 53 45 5f 4c 49 4d 49 e WHERE_USE_LIMI
1b870 54 20 20 20 20 20 20 20 20 30 78 34 30 30 30 20 T 0x4000
1b880 2f 2a 20 55 73 65 20 74 68 65 20 4c 49 4d 49 54 /* Use the LIMIT
1b890 20 69 6e 20 63 6f 73 74 20 65 73 74 69 6d 61 74 in cost estimat
1b8a0 65 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 es */.
1b8b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1b8c0 20 20 20 20 20 30 78 38 30 30 30 20 20 20 20 6e 0x8000 n
1b8d0 6f 74 20 63 75 72 72 65 6e 74 6c 79 20 75 73 65 ot currently use
1b8e0 64 20 2a 2f 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 d */../* Allowed
1b8f0 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 20 66 return values f
1b900 72 6f 6d 20 73 71 6c 69 74 65 33 57 68 65 72 65 rom sqlite3Where
1b910 49 73 44 69 73 74 69 6e 63 74 28 29 0a 2a 2f 0a IsDistinct().*/.
1b920 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 #define WHERE_DI
1b930 53 54 49 4e 43 54 5f 4e 4f 4f 50 20 20 20 20 20 STINCT_NOOP
1b940 20 30 20 20 2f 2a 20 44 49 53 54 49 4e 43 54 20 0 /* DISTINCT
1b950 6b 65 79 77 6f 72 64 20 6e 6f 74 20 75 73 65 64 keyword not used
1b960 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
1b970 45 5f 44 49 53 54 49 4e 43 54 5f 55 4e 49 51 55 E_DISTINCT_UNIQU
1b980 45 20 20 20 20 31 20 20 2f 2a 20 4e 6f 20 64 75 E 1 /* No du
1b990 70 6c 69 63 61 74 65 73 20 2a 2f 0a 23 64 65 66 plicates */.#def
1b9a0 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e ine WHERE_DISTIN
1b9b0 43 54 5f 4f 52 44 45 52 45 44 20 20 20 32 20 20 CT_ORDERED 2
1b9c0 2f 2a 20 41 6c 6c 20 64 75 70 6c 69 63 61 74 65 /* All duplicate
1b9d0 73 20 61 72 65 20 61 64 6a 61 63 65 6e 74 20 2a s are adjacent *
1b9e0 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
1b9f0 44 49 53 54 49 4e 43 54 5f 55 4e 4f 52 44 45 52 DISTINCT_UNORDER
1ba00 45 44 20 33 20 20 2f 2a 20 44 75 70 6c 69 63 61 ED 3 /* Duplica
1ba10 74 65 73 20 61 72 65 20 73 63 61 74 74 65 72 65 tes are scattere
1ba20 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 4e 61 d */../*.** A Na
1ba30 6d 65 43 6f 6e 74 65 78 74 20 64 65 66 69 6e 65 meContext define
1ba40 73 20 61 20 63 6f 6e 74 65 78 74 20 69 6e 20 77 s a context in w
1ba50 68 69 63 68 20 74 6f 20 72 65 73 6f 6c 76 65 20 hich to resolve
1ba60 74 61 62 6c 65 20 61 6e 64 20 63 6f 6c 75 6d 6e table and column
1ba70 0a 2a 2a 20 6e 61 6d 65 73 2e 20 20 54 68 65 20 .** names. The
1ba80 63 6f 6e 74 65 78 74 20 63 6f 6e 73 69 73 74 73 context consists
1ba90 20 6f 66 20 61 20 6c 69 73 74 20 6f 66 20 74 61 of a list of ta
1baa0 62 6c 65 73 20 28 74 68 65 20 70 53 72 63 4c 69 bles (the pSrcLi
1bab0 73 74 29 20 66 69 65 6c 64 20 61 6e 64 0a 2a 2a st) field and.**
1bac0 20 61 20 6c 69 73 74 20 6f 66 20 6e 61 6d 65 64 a list of named
1bad0 20 65 78 70 72 65 73 73 69 6f 6e 20 28 70 45 4c expression (pEL
1bae0 69 73 74 29 2e 20 20 54 68 65 20 6e 61 6d 65 64 ist). The named
1baf0 20 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 expression list
1bb00 20 6d 61 79 0a 2a 2a 20 62 65 20 4e 55 4c 4c 2e may.** be NULL.
1bb10 20 20 54 68 65 20 70 53 72 63 20 63 6f 72 72 65 The pSrc corre
1bb20 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 46 52 sponds to the FR
1bb30 4f 4d 20 63 6c 61 75 73 65 20 6f 66 20 61 20 53 OM clause of a S
1bb40 45 4c 45 43 54 20 6f 72 0a 2a 2a 20 74 6f 20 74 ELECT or.** to t
1bb50 68 65 20 74 61 62 6c 65 20 62 65 69 6e 67 20 6f he table being o
1bb60 70 65 72 61 74 65 64 20 6f 6e 20 62 79 20 49 4e perated on by IN
1bb70 53 45 52 54 2c 20 55 50 44 41 54 45 2c 20 6f 72 SERT, UPDATE, or
1bb80 20 44 45 4c 45 54 45 2e 20 20 54 68 65 0a 2a 2a DELETE. The.**
1bb90 20 70 45 4c 69 73 74 20 63 6f 72 72 65 73 70 6f pEList correspo
1bba0 6e 64 73 20 74 6f 20 74 68 65 20 72 65 73 75 6c nds to the resul
1bbb0 74 20 73 65 74 20 6f 66 20 61 20 53 45 4c 45 43 t set of a SELEC
1bbc0 54 20 61 6e 64 20 69 73 20 4e 55 4c 4c 20 66 6f T and is NULL fo
1bbd0 72 0a 2a 2a 20 6f 74 68 65 72 20 73 74 61 74 65 r.** other state
1bbe0 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 4e 61 6d ments..**.** Nam
1bbf0 65 43 6f 6e 74 65 78 74 73 20 63 61 6e 20 62 65 eContexts can be
1bc00 20 6e 65 73 74 65 64 2e 20 20 57 68 65 6e 20 72 nested. When r
1bc10 65 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 73 2c 20 esolving names,
1bc20 74 68 65 20 69 6e 6e 65 72 2d 6d 6f 73 74 0a 2a the inner-most.*
1bc30 2a 20 63 6f 6e 74 65 78 74 20 69 73 20 73 65 61 * context is sea
1bc40 72 63 68 65 64 20 66 69 72 73 74 2e 20 20 49 66 rched first. If
1bc50 20 6e 6f 20 6d 61 74 63 68 20 69 73 20 66 6f 75 no match is fou
1bc60 6e 64 2c 20 74 68 65 20 6e 65 78 74 20 6f 75 74 nd, the next out
1bc70 65 72 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 69 73 er.** context is
1bc80 20 63 68 65 63 6b 65 64 2e 20 20 49 66 20 74 68 checked. If th
1bc90 65 72 65 20 69 73 20 73 74 69 6c 6c 20 6e 6f 20 ere is still no
1bca0 6d 61 74 63 68 2c 20 74 68 65 20 6e 65 78 74 20 match, the next
1bcb0 63 6f 6e 74 65 78 74 0a 2a 2a 20 69 73 20 63 68 context.** is ch
1bcc0 65 63 6b 65 64 2e 20 20 54 68 69 73 20 70 72 6f ecked. This pro
1bcd0 63 65 73 73 20 63 6f 6e 74 69 6e 75 65 73 20 75 cess continues u
1bce0 6e 74 69 6c 20 65 69 74 68 65 72 20 61 20 6d 61 ntil either a ma
1bcf0 74 63 68 20 69 73 20 66 6f 75 6e 64 0a 2a 2a 20 tch is found.**
1bd00 6f 72 20 61 6c 6c 20 63 6f 6e 74 65 78 74 73 20 or all contexts
1bd10 61 72 65 20 63 68 65 63 6b 2e 20 20 57 68 65 6e are check. When
1bd20 20 61 20 6d 61 74 63 68 20 69 73 20 66 6f 75 6e a match is foun
1bd30 64 2c 20 74 68 65 20 6e 52 65 66 20 6d 65 6d 62 d, the nRef memb
1bd40 65 72 20 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 6e er of.** the con
1bd50 74 65 78 74 20 63 6f 6e 74 61 69 6e 69 6e 67 20 text containing
1bd60 74 68 65 20 6d 61 74 63 68 20 69 73 20 69 6e 63 the match is inc
1bd70 72 65 6d 65 6e 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 remented..**.**
1bd80 45 61 63 68 20 73 75 62 71 75 65 72 79 20 67 65 Each subquery ge
1bd90 74 73 20 61 20 6e 65 77 20 4e 61 6d 65 43 6f 6e ts a new NameCon
1bda0 74 65 78 74 2e 20 20 54 68 65 20 70 4e 65 78 74 text. The pNext
1bdb0 20 66 69 65 6c 64 20 70 6f 69 6e 74 73 20 74 6f field points to
1bdc0 20 74 68 65 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 the.** NameCont
1bdd0 65 78 74 20 69 6e 20 74 68 65 20 70 61 72 65 6e ext in the paren
1bde0 74 20 71 75 65 72 79 2e 20 20 54 68 75 73 20 74 t query. Thus t
1bdf0 68 65 20 70 72 6f 63 65 73 73 20 6f 66 20 73 63 he process of sc
1be00 61 6e 6e 69 6e 67 20 74 68 65 0a 2a 2a 20 4e 61 anning the.** Na
1be10 6d 65 43 6f 6e 74 65 78 74 20 6c 69 73 74 20 63 meContext list c
1be20 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 73 65 orresponds to se
1be30 61 72 63 68 69 6e 67 20 74 68 72 6f 75 67 68 20 arching through
1be40 73 75 63 63 65 73 73 69 76 65 6c 79 20 6f 75 74 successively out
1be50 65 72 0a 2a 2a 20 73 75 62 71 75 65 72 69 65 73 er.** subqueries
1be60 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 6d looking for a m
1be70 61 74 63 68 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 atch..*/.struct
1be80 4e 61 6d 65 43 6f 6e 74 65 78 74 20 7b 0a 20 20 NameContext {.
1be90 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 Parse *pParse;
1bea0 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 72 73 /* The pars
1beb0 65 72 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 er */. SrcList
1bec0 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 2f 2a 20 *pSrcList; /*
1bed0 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 61 62 6c One or more tabl
1bee0 65 73 20 75 73 65 64 20 74 6f 20 72 65 73 6f 6c es used to resol
1bef0 76 65 20 6e 61 6d 65 73 20 2a 2f 0a 20 20 75 6e ve names */. un
1bf00 69 6f 6e 20 7b 0a 20 20 20 20 45 78 70 72 4c 69 ion {. ExprLi
1bf10 73 74 20 2a 70 45 4c 69 73 74 3b 20 20 20 20 2f st *pEList; /
1bf20 2a 20 4f 70 74 69 6f 6e 61 6c 20 6c 69 73 74 20 * Optional list
1bf30 6f 66 20 72 65 73 75 6c 74 2d 73 65 74 20 63 6f of result-set co
1bf40 6c 75 6d 6e 73 20 2a 2f 0a 20 20 20 20 41 67 67 lumns */. Agg
1bf50 49 6e 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 Info *pAggInfo;
1bf60 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e /* Information
1bf70 20 61 62 6f 75 74 20 61 67 67 72 65 67 61 74 65 about aggregate
1bf80 73 20 61 74 20 74 68 69 73 20 6c 65 76 65 6c 20 s at this level
1bf90 2a 2f 0a 20 20 20 20 55 70 73 65 72 74 20 2a 70 */. Upsert *p
1bfa0 55 70 73 65 72 74 3b 20 20 20 20 20 2f 2a 20 4f Upsert; /* O
1bfb0 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 N CONFLICT claus
1bfc0 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 e information fr
1bfd0 6f 6d 20 61 6e 20 75 70 73 65 72 74 20 2a 2f 0a om an upsert */.
1bfe0 20 20 7d 20 75 4e 43 3b 0a 20 20 4e 61 6d 65 43 } uNC;. NameC
1bff0 6f 6e 74 65 78 74 20 2a 70 4e 65 78 74 3b 20 20 ontext *pNext;
1c000 2f 2a 20 4e 65 78 74 20 6f 75 74 65 72 20 6e 61 /* Next outer na
1c010 6d 65 20 63 6f 6e 74 65 78 74 2e 20 20 4e 55 4c me context. NUL
1c020 4c 20 66 6f 72 20 6f 75 74 65 72 6d 6f 73 74 20 L for outermost
1c030 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 */. int nRef;
1c040 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1c050 62 65 72 20 6f 66 20 6e 61 6d 65 73 20 72 65 73 ber of names res
1c060 6f 6c 76 65 64 20 62 79 20 74 68 69 73 20 63 6f olved by this co
1c070 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 6e ntext */. int n
1c080 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 Err;
1c090 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 72 72 /* Number of err
1c0a0 6f 72 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 ors encountered
1c0b0 77 68 69 6c 65 20 72 65 73 6f 6c 76 69 6e 67 20 while resolving
1c0c0 6e 61 6d 65 73 20 2a 2f 0a 20 20 75 31 36 20 6e names */. u16 n
1c0d0 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 cFlags;
1c0e0 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 /* Zero or more
1c0f0 4e 43 5f 2a 20 66 6c 61 67 73 20 64 65 66 69 6e NC_* flags defin
1c100 65 64 20 62 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 0a ed below */.};..
1c110 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 /*.** Allowed va
1c120 6c 75 65 73 20 66 6f 72 20 74 68 65 20 4e 61 6d lues for the Nam
1c130 65 43 6f 6e 74 65 78 74 2c 20 6e 63 46 6c 61 67 eContext, ncFlag
1c140 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 56 s field..**.** V
1c150 61 6c 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 alue constraints
1c160 20 28 61 6c 6c 20 63 68 65 63 6b 65 64 20 76 69 (all checked vi
1c170 61 20 61 73 73 65 72 74 28 29 29 3a 0a 2a 2a 20 a assert()):.**
1c180 20 20 20 4e 43 5f 48 61 73 41 67 67 20 20 20 20 NC_HasAgg
1c190 3d 3d 20 53 46 5f 48 61 73 41 67 67 0a 2a 2a 20 == SF_HasAgg.**
1c1a0 20 20 20 4e 43 5f 4d 69 6e 4d 61 78 41 67 67 20 NC_MinMaxAgg
1c1b0 3d 3d 20 53 46 5f 4d 69 6e 4d 61 78 41 67 67 20 == SF_MinMaxAgg
1c1c0 3d 3d 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4d == SQLITE_FUNC_M
1c1d0 49 4e 4d 41 58 0a 2a 2a 0a 2a 2f 0a 23 64 65 66 INMAX.**.*/.#def
1c1e0 69 6e 65 20 4e 43 5f 41 6c 6c 6f 77 41 67 67 20 ine NC_AllowAgg
1c1f0 20 30 78 30 30 30 31 20 20 2f 2a 20 41 67 67 72 0x0001 /* Aggr
1c200 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 egate functions
1c210 61 72 65 20 61 6c 6c 6f 77 65 64 20 68 65 72 65 are allowed here
1c220 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 50 */.#define NC_P
1c230 61 72 74 49 64 78 20 20 20 30 78 30 30 30 32 20 artIdx 0x0002
1c240 20 2f 2a 20 54 72 75 65 20 69 66 20 72 65 73 6f /* True if reso
1c250 6c 76 69 6e 67 20 61 20 70 61 72 74 69 61 6c 20 lving a partial
1c260 69 6e 64 65 78 20 57 48 45 52 45 20 2a 2f 0a 23 index WHERE */.#
1c270 64 65 66 69 6e 65 20 4e 43 5f 49 73 43 68 65 63 define NC_IsChec
1c280 6b 20 20 20 30 78 30 30 30 34 20 20 2f 2a 20 54 k 0x0004 /* T
1c290 72 75 65 20 69 66 20 72 65 73 6f 6c 76 69 6e 67 rue if resolving
1c2a0 20 6e 61 6d 65 73 20 69 6e 20 61 20 43 48 45 43 names in a CHEC
1c2b0 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a K constraint */.
1c2c0 23 64 65 66 69 6e 65 20 4e 43 5f 49 6e 41 67 67 #define NC_InAgg
1c2d0 46 75 6e 63 20 30 78 30 30 30 38 20 20 2f 2a 20 Func 0x0008 /*
1c2e0 54 72 75 65 20 69 66 20 61 6e 61 6c 79 7a 69 6e True if analyzin
1c2f0 67 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 61 g arguments to a
1c300 6e 20 61 67 67 20 66 75 6e 63 20 2a 2f 0a 23 64 n agg func */.#d
1c310 65 66 69 6e 65 20 4e 43 5f 48 61 73 41 67 67 20 efine NC_HasAgg
1c320 20 20 20 30 78 30 30 31 30 20 20 2f 2a 20 4f 6e 0x0010 /* On
1c330 65 20 6f 72 20 6d 6f 72 65 20 61 67 67 72 65 67 e or more aggreg
1c340 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 73 65 ate functions se
1c350 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 en */.#define NC
1c360 5f 49 64 78 45 78 70 72 20 20 20 30 78 30 30 32 _IdxExpr 0x002
1c370 30 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 65 0 /* True if re
1c380 73 6f 6c 76 69 6e 67 20 63 6f 6c 75 6d 6e 73 20 solving columns
1c390 6f 66 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 of CREATE INDEX
1c3a0 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 56 61 */.#define NC_Va
1c3b0 72 53 65 6c 65 63 74 20 30 78 30 30 34 30 20 20 rSelect 0x0040
1c3c0 2f 2a 20 41 20 63 6f 72 72 65 6c 61 74 65 64 20 /* A correlated
1c3d0 73 75 62 71 75 65 72 79 20 68 61 73 20 62 65 65 subquery has bee
1c3e0 6e 20 73 65 65 6e 20 2a 2f 0a 23 64 65 66 69 6e n seen */.#defin
1c3f0 65 20 4e 43 5f 55 45 4c 69 73 74 20 20 20 20 30 e NC_UEList 0
1c400 78 30 30 38 30 20 20 2f 2a 20 54 72 75 65 20 69 x0080 /* True i
1c410 66 20 75 4e 43 2e 70 45 4c 69 73 74 20 69 73 20 f uNC.pEList is
1c420 75 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 used */.#define
1c430 4e 43 5f 55 41 67 67 49 6e 66 6f 20 20 30 78 30 NC_UAggInfo 0x0
1c440 31 30 30 20 20 2f 2a 20 54 72 75 65 20 69 66 20 100 /* True if
1c450 75 4e 43 2e 70 41 67 67 49 6e 66 6f 20 69 73 20 uNC.pAggInfo is
1c460 75 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 used */.#define
1c470 4e 43 5f 55 55 70 73 65 72 74 20 20 20 30 78 30 NC_UUpsert 0x0
1c480 32 30 30 20 20 2f 2a 20 54 72 75 65 20 69 66 20 200 /* True if
1c490 75 4e 43 2e 70 55 70 73 65 72 74 20 69 73 20 75 uNC.pUpsert is u
1c4a0 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e sed */.#define N
1c4b0 43 5f 4d 69 6e 4d 61 78 41 67 67 20 30 78 31 30 C_MinMaxAgg 0x10
1c4c0 30 30 20 20 2f 2a 20 6d 69 6e 2f 6d 61 78 20 61 00 /* min/max a
1c4d0 67 67 72 65 67 61 74 65 73 20 73 65 65 6e 2e 20 ggregates seen.
1c4e0 20 53 65 65 20 6e 6f 74 65 20 61 62 6f 76 65 20 See note above
1c4f0 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 43 6f */.#define NC_Co
1c500 6d 70 6c 65 78 20 20 20 30 78 32 30 30 30 20 20 mplex 0x2000
1c510 2f 2a 20 54 72 75 65 20 69 66 20 61 20 66 75 6e /* True if a fun
1c520 63 74 69 6f 6e 20 6f 72 20 73 75 62 71 75 65 72 ction or subquer
1c530 79 20 73 65 65 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a y seen */../*.**
1c540 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
1c550 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 62 the following ob
1c560 6a 65 63 74 20 64 65 73 63 72 69 62 65 73 20 61 ject describes a
1c570 20 73 69 6e 67 6c 65 20 4f 4e 20 43 4f 4e 46 4c single ON CONFL
1c580 49 43 54 0a 2a 2a 20 63 6c 61 75 73 65 20 69 6e ICT.** clause in
1c590 20 61 6e 20 75 70 73 65 72 74 2e 0a 2a 2a 0a 2a an upsert..**.*
1c5a0 2a 20 54 68 65 20 70 55 70 73 65 72 74 54 61 72 * The pUpsertTar
1c5b0 67 65 74 20 66 69 65 6c 64 20 69 73 20 6f 6e 6c get field is onl
1c5c0 79 20 73 65 74 20 69 66 20 74 68 65 20 4f 4e 20 y set if the ON
1c5d0 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 20 CONFLICT clause
1c5e0 69 6e 63 6c 75 64 65 73 0a 2a 2a 20 63 6f 6e 66 includes.** conf
1c5f0 6c 69 63 74 2d 74 61 72 67 65 74 20 63 6c 61 75 lict-target clau
1c600 73 65 2e 20 20 28 49 6e 20 22 4f 4e 20 43 4f 4e se. (In "ON CON
1c610 46 4c 49 43 54 28 61 2c 62 29 22 20 74 68 65 20 FLICT(a,b)" the
1c620 22 28 61 2c 62 29 22 20 69 73 20 74 68 65 0a 2a "(a,b)" is the.*
1c630 2a 20 63 6f 6e 66 6c 69 63 74 2d 74 61 72 67 65 * conflict-targe
1c640 74 20 63 6c 61 75 73 65 2e 29 20 20 54 68 65 20 t clause.) The
1c650 70 55 70 73 65 72 74 54 61 72 67 65 74 57 68 65 pUpsertTargetWhe
1c660 72 65 20 69 73 20 74 68 65 20 6f 70 74 69 6f 6e re is the option
1c670 61 6c 0a 2a 2a 20 57 48 45 52 45 20 63 6c 61 75 al.** WHERE clau
1c680 73 65 20 75 73 65 64 20 74 6f 20 69 64 65 6e 74 se used to ident
1c690 69 66 79 20 70 61 72 74 69 61 6c 20 75 6e 69 71 ify partial uniq
1c6a0 75 65 20 69 6e 64 65 78 65 73 2e 0a 2a 2a 0a 2a ue indexes..**.*
1c6b0 2a 20 70 55 70 73 65 72 74 53 65 74 20 69 73 20 * pUpsertSet is
1c6c0 74 68 65 20 6c 69 73 74 20 6f 66 20 63 6f 6c 75 the list of colu
1c6d0 6d 6e 3d 65 78 70 72 20 74 65 72 6d 73 20 6f 66 mn=expr terms of
1c6e0 20 74 68 65 20 55 50 44 41 54 45 20 73 74 61 74 the UPDATE stat
1c6f0 65 6d 65 6e 74 2e 20 0a 2a 2a 20 54 68 65 20 70 ement. .** The p
1c700 55 70 73 65 72 74 53 65 74 20 66 69 65 6c 64 20 UpsertSet field
1c710 69 73 20 4e 55 4c 4c 20 66 6f 72 20 61 20 4f 4e is NULL for a ON
1c720 20 43 4f 4e 46 4c 49 43 54 20 44 4f 20 4e 4f 54 CONFLICT DO NOT
1c730 48 49 4e 47 2e 20 20 54 68 65 0a 2a 2a 20 70 55 HING. The.** pU
1c740 70 73 65 72 74 57 68 65 72 65 20 69 73 20 74 68 psertWhere is th
1c750 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 66 e WHERE clause f
1c760 6f 72 20 74 68 65 20 55 50 44 41 54 45 20 61 6e or the UPDATE an
1c770 64 20 69 73 20 4e 55 4c 4c 20 69 66 20 74 68 65 d is NULL if the
1c780 0a 2a 2a 20 57 48 45 52 45 20 63 6c 61 75 73 65 .** WHERE clause
1c790 20 69 73 20 6f 6d 69 74 74 65 64 2e 0a 2a 2f 0a is omitted..*/.
1c7a0 73 74 72 75 63 74 20 55 70 73 65 72 74 20 7b 0a struct Upsert {.
1c7b0 20 20 45 78 70 72 4c 69 73 74 20 2a 70 55 70 73 ExprList *pUps
1c7c0 65 72 74 54 61 72 67 65 74 3b 20 20 2f 2a 20 4f ertTarget; /* O
1c7d0 70 74 69 6f 6e 61 6c 20 64 65 73 63 72 69 70 74 ptional descript
1c7e0 69 6f 6e 20 6f 66 20 63 6f 6e 66 6c 69 63 74 69 ion of conflicti
1c7f0 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 45 78 ng index */. Ex
1c800 70 72 20 2a 70 55 70 73 65 72 74 54 61 72 67 65 pr *pUpsertTarge
1c810 74 57 68 65 72 65 3b 20 2f 2a 20 57 48 45 52 45 tWhere; /* WHERE
1c820 20 63 6c 61 75 73 65 20 66 6f 72 20 70 61 72 74 clause for part
1c830 69 61 6c 20 69 6e 64 65 78 20 74 61 72 67 65 74 ial index target
1c840 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
1c850 2a 70 55 70 73 65 72 74 53 65 74 3b 20 20 20 20 *pUpsertSet;
1c860 20 2f 2a 20 54 68 65 20 53 45 54 20 63 6c 61 75 /* The SET clau
1c870 73 65 20 66 72 6f 6d 20 61 6e 20 4f 4e 20 43 4f se from an ON CO
1c880 4e 46 4c 49 43 54 20 55 50 44 41 54 45 20 2a 2f NFLICT UPDATE */
1c890 0a 20 20 45 78 70 72 20 2a 70 55 70 73 65 72 74 . Expr *pUpsert
1c8a0 57 68 65 72 65 3b 20 20 20 20 20 20 20 2f 2a 20 Where; /*
1c8b0 57 48 45 52 45 20 63 6c 61 75 73 65 20 66 6f 72 WHERE clause for
1c8c0 20 74 68 65 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 the ON CONFLICT
1c8d0 20 55 50 44 41 54 45 20 2a 2f 0a 20 20 2f 2a 20 UPDATE */. /*
1c8e0 54 68 65 20 66 69 65 6c 64 73 20 61 62 6f 76 65 The fields above
1c8f0 20 63 6f 6d 70 72 69 73 65 20 74 68 65 20 70 61 comprise the pa
1c900 72 73 65 20 74 72 65 65 20 66 6f 72 20 74 68 65 rse tree for the
1c910 20 75 70 73 65 72 74 20 63 6c 61 75 73 65 2e 0a upsert clause..
1c920 20 20 2a 2a 20 54 68 65 20 66 69 65 6c 64 73 20 ** The fields
1c930 62 65 6c 6f 77 20 61 72 65 20 75 73 65 64 20 74 below are used t
1c940 6f 20 74 72 61 6e 73 66 65 72 20 69 6e 66 6f 72 o transfer infor
1c950 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74 68 65 20 mation from the
1c960 49 4e 53 45 52 54 0a 20 20 2a 2a 20 70 72 6f 63 INSERT. ** proc
1c970 65 73 73 69 6e 67 20 64 6f 77 6e 20 69 6e 74 6f essing down into
1c980 20 74 68 65 20 55 50 44 41 54 45 20 70 72 6f 63 the UPDATE proc
1c990 65 73 73 69 6e 67 20 77 68 69 6c 65 20 67 65 6e essing while gen
1c9a0 65 72 61 74 69 6e 67 20 63 6f 64 65 2e 0a 20 20 erating code..
1c9b0 2a 2a 20 55 70 73 65 72 74 20 6f 77 6e 73 20 74 ** Upsert owns t
1c9c0 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 he memory alloca
1c9d0 74 65 64 20 61 62 6f 76 65 2c 20 62 75 74 20 6e ted above, but n
1c9e0 6f 74 20 74 68 65 20 6d 65 6d 6f 72 79 20 62 65 ot the memory be
1c9f0 6c 6f 77 2e 20 2a 2f 0a 20 20 49 6e 64 65 78 20 low. */. Index
1ca00 2a 70 55 70 73 65 72 74 49 64 78 3b 20 20 20 20 *pUpsertIdx;
1ca10 20 20 20 20 2f 2a 20 43 6f 6e 73 74 72 61 69 6e /* Constrain
1ca20 74 20 74 68 61 74 20 70 55 70 73 65 72 74 54 61 t that pUpsertTa
1ca30 72 67 65 74 20 69 64 65 6e 74 69 66 69 65 73 20 rget identifies
1ca40 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 55 */. SrcList *pU
1ca50 70 73 65 72 74 53 72 63 3b 20 20 20 20 20 20 2f psertSrc; /
1ca60 2a 20 54 61 62 6c 65 20 74 6f 20 62 65 20 75 70 * Table to be up
1ca70 64 61 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 72 dated */. int r
1ca80 65 67 44 61 74 61 3b 20 20 20 20 20 20 20 20 20 egData;
1ca90 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 72 65 /* First re
1caa0 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 61 gister holding a
1cab0 72 72 61 79 20 6f 66 20 56 41 4c 55 45 53 20 2a rray of VALUES *
1cac0 2f 0a 20 20 69 6e 74 20 69 44 61 74 61 43 75 72 /. int iDataCur
1cad0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
1cae0 20 49 6e 64 65 78 20 6f 66 20 74 68 65 20 64 61 Index of the da
1caf0 74 61 20 63 75 72 73 6f 72 20 2a 2f 0a 20 20 69 ta cursor */. i
1cb00 6e 74 20 69 49 64 78 43 75 72 3b 20 20 20 20 20 nt iIdxCur;
1cb10 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 /* Inde
1cb20 78 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 69 x of the first i
1cb30 6e 64 65 78 20 63 75 72 73 6f 72 20 2a 2f 0a 7d ndex cursor */.}
1cb40 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 ;../*.** An inst
1cb50 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
1cb60 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
1cb70 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 69 6e 66 contains all inf
1cb80 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 6e 65 65 64 ormation.** need
1cb90 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 63 ed to generate c
1cba0 6f 64 65 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 ode for a single
1cbb0 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
1cbc0 74 2e 0a 2a 2a 0a 2a 2a 20 53 65 65 20 74 68 65 t..**.** See the
1cbd0 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74 20 header comment
1cbe0 6f 6e 20 74 68 65 20 63 6f 6d 70 75 74 65 4c 69 on the computeLi
1cbf0 6d 69 74 52 65 67 69 73 74 65 72 73 28 29 20 72 mitRegisters() r
1cc00 6f 75 74 69 6e 65 20 66 6f 72 20 61 0a 2a 2a 20 outine for a.**
1cc10 64 65 74 61 69 6c 65 64 20 64 65 73 63 72 69 70 detailed descrip
1cc20 74 69 6f 6e 20 6f 66 20 74 68 65 20 6d 65 61 6e tion of the mean
1cc30 69 6e 67 20 6f 66 20 74 68 65 20 69 4c 69 6d 69 ing of the iLimi
1cc40 74 20 61 6e 64 20 69 4f 66 66 73 65 74 20 66 69 t and iOffset fi
1cc50 65 6c 64 73 2e 0a 2a 2a 0a 2a 2a 20 61 64 64 72 elds..**.** addr
1cc60 4f 70 65 6e 45 70 68 6d 5b 5d 20 65 6e 74 72 69 OpenEphm[] entri
1cc70 65 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 61 es contain the a
1cc80 64 64 72 65 73 73 20 6f 66 20 4f 50 5f 4f 70 65 ddress of OP_Ope
1cc90 6e 45 70 68 65 6d 65 72 61 6c 20 6f 70 63 6f 64 nEphemeral opcod
1cca0 65 73 2e 0a 2a 2a 20 54 68 65 73 65 20 61 64 64 es..** These add
1ccb0 72 65 73 73 65 73 20 6d 75 73 74 20 62 65 20 73 resses must be s
1ccc0 74 6f 72 65 64 20 73 6f 20 74 68 61 74 20 77 65 tored so that we
1ccd0 20 63 61 6e 20 67 6f 20 62 61 63 6b 20 61 6e 64 can go back and
1cce0 20 66 69 6c 6c 20 69 6e 0a 2a 2a 20 74 68 65 20 fill in.** the
1ccf0 50 34 5f 4b 45 59 49 4e 46 4f 20 61 6e 64 20 50 P4_KEYINFO and P
1cd00 32 20 70 61 72 61 6d 65 74 65 72 73 20 6c 61 74 2 parameters lat
1cd10 65 72 2e 20 20 4e 65 69 74 68 65 72 20 74 68 65 er. Neither the
1cd20 20 4b 65 79 49 6e 66 6f 20 6e 6f 72 0a 2a 2a 20 KeyInfo nor.**
1cd30 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f the number of co
1cd40 6c 75 6d 6e 73 20 69 6e 20 50 32 20 63 61 6e 20 lumns in P2 can
1cd50 62 65 20 63 6f 6d 70 75 74 65 64 20 61 74 20 74 be computed at t
1cd60 68 65 20 73 61 6d 65 20 74 69 6d 65 0a 2a 2a 20 he same time.**
1cd70 61 73 20 74 68 65 20 4f 50 5f 4f 70 65 6e 45 70 as the OP_OpenEp
1cd80 68 6d 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 hm instruction i
1cd90 73 20 63 6f 64 65 64 20 62 65 63 61 75 73 65 20 s coded because
1cda0 6e 6f 74 0a 2a 2a 20 65 6e 6f 75 67 68 20 69 6e not.** enough in
1cdb0 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
1cdc0 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20 71 75 65 the compound que
1cdd0 72 79 20 69 73 20 6b 6e 6f 77 6e 20 61 74 20 74 ry is known at t
1cde0 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2a 20 54 68 hat point..** Th
1cdf0 65 20 4b 65 79 49 6e 66 6f 20 66 6f 72 20 61 64 e KeyInfo for ad
1ce00 64 72 4f 70 65 6e 54 72 61 6e 5b 30 5d 20 61 6e drOpenTran[0] an
1ce10 64 20 5b 31 5d 20 63 6f 6e 74 61 69 6e 73 20 63 d [1] contains c
1ce20 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 ollating sequenc
1ce30 65 73 0a 2a 2a 20 66 6f 72 20 74 68 65 20 72 65 es.** for the re
1ce40 73 75 6c 74 20 73 65 74 2e 20 20 54 68 65 20 4b sult set. The K
1ce50 65 79 49 6e 66 6f 20 66 6f 72 20 61 64 64 72 4f eyInfo for addrO
1ce60 70 65 6e 45 70 68 6d 5b 32 5d 20 63 6f 6e 74 61 penEphm[2] conta
1ce70 69 6e 73 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a ins collating.**
1ce80 20 73 65 71 75 65 6e 63 65 73 20 66 6f 72 20 74 sequences for t
1ce90 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 he ORDER BY clau
1cea0 73 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 65 se..*/.struct Se
1ceb0 6c 65 63 74 20 7b 0a 20 20 45 78 70 72 4c 69 73 lect {. ExprLis
1cec0 74 20 2a 70 45 4c 69 73 74 3b 20 20 20 20 20 20 t *pEList;
1ced0 2f 2a 20 54 68 65 20 66 69 65 6c 64 73 20 6f 66 /* The fields of
1cee0 20 74 68 65 20 72 65 73 75 6c 74 20 2a 2f 0a 20 the result */.
1cef0 20 75 38 20 6f 70 3b 20 20 20 20 20 20 20 20 20 u8 op;
1cf00 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f /* One o
1cf10 66 3a 20 54 4b 5f 55 4e 49 4f 4e 20 54 4b 5f 41 f: TK_UNION TK_A
1cf20 4c 4c 20 54 4b 5f 49 4e 54 45 52 53 45 43 54 20 LL TK_INTERSECT
1cf30 54 4b 5f 45 58 43 45 50 54 20 2a 2f 0a 20 20 4c TK_EXCEPT */. L
1cf40 6f 67 45 73 74 20 6e 53 65 6c 65 63 74 52 6f 77 ogEst nSelectRow
1cf50 3b 20 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 ; /* Estimat
1cf60 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 ed number of res
1cf70 75 6c 74 20 72 6f 77 73 20 2a 2f 0a 20 20 75 33 ult rows */. u3
1cf80 32 20 73 65 6c 46 6c 61 67 73 3b 20 20 20 20 20 2 selFlags;
1cf90 20 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 /* Various
1cfa0 53 46 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 SF_* values */.
1cfb0 20 69 6e 74 20 69 4c 69 6d 69 74 2c 20 69 4f 66 int iLimit, iOf
1cfc0 66 73 65 74 3b 20 20 20 2f 2a 20 4d 65 6d 6f 72 fset; /* Memor
1cfd0 79 20 72 65 67 69 73 74 65 72 73 20 68 6f 6c 64 y registers hold
1cfe0 69 6e 67 20 4c 49 4d 49 54 20 26 20 4f 46 46 53 ing LIMIT & OFFS
1cff0 45 54 20 63 6f 75 6e 74 65 72 73 20 2a 2f 0a 23 ET counters */.#
1d000 69 66 20 53 45 4c 45 43 54 54 52 41 43 45 5f 45 if SELECTTRACE_E
1d010 4e 41 42 4c 45 44 0a 20 20 63 68 61 72 20 7a 53 NABLED. char zS
1d020 65 6c 4e 61 6d 65 5b 31 32 5d 3b 20 20 20 20 20 elName[12];
1d030 2f 2a 20 53 79 6d 62 6f 6c 69 63 20 6e 61 6d 65 /* Symbolic name
1d040 20 6f 66 20 74 68 69 73 20 53 45 4c 45 43 54 20 of this SELECT
1d050 75 73 65 20 66 6f 72 20 64 65 62 75 67 67 69 6e use for debuggin
1d060 67 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e g */.#endif. in
1d070 74 20 61 64 64 72 4f 70 65 6e 45 70 68 6d 5b 32 t addrOpenEphm[2
1d080 5d 3b 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 45 ]; /* OP_OpenE
1d090 70 68 65 6d 20 6f 70 63 6f 64 65 73 20 72 65 6c phem opcodes rel
1d0a0 61 74 65 64 20 74 6f 20 74 68 69 73 20 73 65 6c ated to this sel
1d0b0 65 63 74 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 ect */. SrcList
1d0c0 20 2a 70 53 72 63 3b 20 20 20 20 20 20 20 20 20 *pSrc;
1d0d0 2f 2a 20 54 68 65 20 46 52 4f 4d 20 63 6c 61 75 /* The FROM clau
1d0e0 73 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 se */. Expr *pW
1d0f0 68 65 72 65 3b 20 20 20 20 20 20 20 20 20 20 2f here; /
1d100 2a 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 * The WHERE clau
1d110 73 65 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 se */. ExprList
1d120 20 2a 70 47 72 6f 75 70 42 79 3b 20 20 20 20 2f *pGroupBy; /
1d130 2a 20 54 68 65 20 47 52 4f 55 50 20 42 59 20 63 * The GROUP BY c
1d140 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 20 lause */. Expr
1d150 2a 70 48 61 76 69 6e 67 3b 20 20 20 20 20 20 20 *pHaving;
1d160 20 20 2f 2a 20 54 68 65 20 48 41 56 49 4e 47 20 /* The HAVING
1d170 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 clause */. Expr
1d180 4c 69 73 74 20 2a 70 4f 72 64 65 72 42 79 3b 20 List *pOrderBy;
1d190 20 20 20 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 /* The ORDER
1d1a0 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 53 BY clause */. S
1d1b0 65 6c 65 63 74 20 2a 70 50 72 69 6f 72 3b 20 20 elect *pPrior;
1d1c0 20 20 20 20 20 20 2f 2a 20 50 72 69 6f 72 20 73 /* Prior s
1d1d0 65 6c 65 63 74 20 69 6e 20 61 20 63 6f 6d 70 6f elect in a compo
1d1e0 75 6e 64 20 73 65 6c 65 63 74 20 73 74 61 74 65 und select state
1d1f0 6d 65 6e 74 20 2a 2f 0a 20 20 53 65 6c 65 63 74 ment */. Select
1d200 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 *pNext;
1d210 20 2f 2a 20 4e 65 78 74 20 73 65 6c 65 63 74 20 /* Next select
1d220 74 6f 20 74 68 65 20 6c 65 66 74 20 69 6e 20 61 to the left in a
1d230 20 63 6f 6d 70 6f 75 6e 64 20 2a 2f 0a 20 20 45 compound */. E
1d240 78 70 72 20 2a 70 4c 69 6d 69 74 3b 20 20 20 20 xpr *pLimit;
1d250 20 20 20 20 20 20 2f 2a 20 4c 49 4d 49 54 20 65 /* LIMIT e
1d260 78 70 72 65 73 73 69 6f 6e 2e 20 4e 55 4c 4c 20 xpression. NULL
1d270 6d 65 61 6e 73 20 6e 6f 74 20 75 73 65 64 2e 20 means not used.
1d280 2a 2f 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 */. With *pWith
1d290 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 ; /* W
1d2a0 49 54 48 20 63 6c 61 75 73 65 20 61 74 74 61 63 ITH clause attac
1d2b0 68 65 64 20 74 6f 20 74 68 69 73 20 73 65 6c 65 hed to this sele
1d2c0 63 74 2e 20 4f 72 20 4e 55 4c 4c 2e 20 2a 2f 0a ct. Or NULL. */.
1d2d0 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 };../*.** Allowe
1d2e0 64 20 76 61 6c 75 65 73 20 66 6f 72 20 53 65 6c d values for Sel
1d2f0 65 63 74 2e 73 65 6c 46 6c 61 67 73 2e 20 20 54 ect.selFlags. T
1d300 68 65 20 22 53 46 22 20 70 72 65 66 69 78 20 73 he "SF" prefix s
1d310 74 61 6e 64 73 20 66 6f 72 0a 2a 2a 20 22 53 65 tands for.** "Se
1d320 6c 65 63 74 20 46 6c 61 67 22 2e 0a 2a 2a 0a 2a lect Flag"..**.*
1d330 2a 20 56 61 6c 75 65 20 63 6f 6e 73 74 72 61 69 * Value constrai
1d340 6e 74 73 20 28 61 6c 6c 20 63 68 65 63 6b 65 64 nts (all checked
1d350 20 76 69 61 20 61 73 73 65 72 74 28 29 29 0a 2a via assert()).*
1d360 2a 20 20 20 20 20 53 46 5f 48 61 73 41 67 67 20 * SF_HasAgg
1d370 20 20 20 20 3d 3d 20 4e 43 5f 48 61 73 41 67 67 == NC_HasAgg
1d380 0a 2a 2a 20 20 20 20 20 53 46 5f 4d 69 6e 4d 61 .** SF_MinMa
1d390 78 41 67 67 20 20 3d 3d 20 4e 43 5f 4d 69 6e 4d xAgg == NC_MinM
1d3a0 61 78 41 67 67 20 20 20 20 20 3d 3d 20 53 51 4c axAgg == SQL
1d3b0 49 54 45 5f 46 55 4e 43 5f 4d 49 4e 4d 41 58 0a ITE_FUNC_MINMAX.
1d3c0 2a 2a 20 20 20 20 20 53 46 5f 46 69 78 65 64 4c ** SF_FixedL
1d3d0 69 6d 69 74 20 3d 3d 20 57 48 45 52 45 5f 55 53 imit == WHERE_US
1d3e0 45 5f 4c 49 4d 49 54 0a 2a 2f 0a 23 64 65 66 69 E_LIMIT.*/.#defi
1d3f0 6e 65 20 53 46 5f 44 69 73 74 69 6e 63 74 20 20 ne SF_Distinct
1d400 20 20 20 20 20 30 78 30 30 30 30 31 20 20 2f 2a 0x00001 /*
1d410 20 4f 75 74 70 75 74 20 73 68 6f 75 6c 64 20 62 Output should b
1d420 65 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 23 64 e DISTINCT */.#d
1d430 65 66 69 6e 65 20 53 46 5f 41 6c 6c 20 20 20 20 efine SF_All
1d440 20 20 20 20 20 20 20 20 30 78 30 30 30 30 32 20 0x00002
1d450 20 2f 2a 20 49 6e 63 6c 75 64 65 73 20 74 68 65 /* Includes the
1d460 20 41 4c 4c 20 6b 65 79 77 6f 72 64 20 2a 2f 0a ALL keyword */.
1d470 23 64 65 66 69 6e 65 20 53 46 5f 52 65 73 6f 6c #define SF_Resol
1d480 76 65 64 20 20 20 20 20 20 20 30 78 30 30 30 30 ved 0x0000
1d490 34 20 20 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 4 /* Identifier
1d4a0 73 20 68 61 76 65 20 62 65 65 6e 20 72 65 73 6f s have been reso
1d4b0 6c 76 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 lved */.#define
1d4c0 53 46 5f 41 67 67 72 65 67 61 74 65 20 20 20 20 SF_Aggregate
1d4d0 20 20 30 78 30 30 30 30 38 20 20 2f 2a 20 43 6f 0x00008 /* Co
1d4e0 6e 74 61 69 6e 73 20 61 67 67 20 66 75 6e 63 74 ntains agg funct
1d4f0 69 6f 6e 73 20 6f 72 20 61 20 47 52 4f 55 50 20 ions or a GROUP
1d500 42 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 BY */.#define SF
1d510 5f 48 61 73 41 67 67 20 20 20 20 20 20 20 20 20 _HasAgg
1d520 30 78 30 30 30 31 30 20 20 2f 2a 20 43 6f 6e 74 0x00010 /* Cont
1d530 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 ains aggregate f
1d540 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 unctions */.#def
1d550 69 6e 65 20 53 46 5f 55 73 65 73 45 70 68 65 6d ine SF_UsesEphem
1d560 65 72 61 6c 20 20 30 78 30 30 30 32 30 20 20 2f eral 0x00020 /
1d570 2a 20 55 73 65 73 20 74 68 65 20 4f 70 65 6e 45 * Uses the OpenE
1d580 70 68 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 20 phemeral opcode
1d590 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 45 78 */.#define SF_Ex
1d5a0 70 61 6e 64 65 64 20 20 20 20 20 20 20 30 78 30 panded 0x0
1d5b0 30 30 34 30 20 20 2f 2a 20 73 71 6c 69 74 65 33 0040 /* sqlite3
1d5c0 53 65 6c 65 63 74 45 78 70 61 6e 64 28 29 20 63 SelectExpand() c
1d5d0 61 6c 6c 65 64 20 6f 6e 20 74 68 69 73 20 2a 2f alled on this */
1d5e0 0a 23 64 65 66 69 6e 65 20 53 46 5f 48 61 73 54 .#define SF_HasT
1d5f0 79 70 65 49 6e 66 6f 20 20 20 20 30 78 30 30 30 ypeInfo 0x000
1d600 38 30 20 20 2f 2a 20 46 52 4f 4d 20 73 75 62 71 80 /* FROM subq
1d610 75 65 72 69 65 73 20 68 61 76 65 20 54 61 62 6c ueries have Tabl
1d620 65 20 6d 65 74 61 64 61 74 61 20 2a 2f 0a 23 64 e metadata */.#d
1d630 65 66 69 6e 65 20 53 46 5f 43 6f 6d 70 6f 75 6e efine SF_Compoun
1d640 64 20 20 20 20 20 20 20 30 78 30 30 31 30 30 20 d 0x00100
1d650 20 2f 2a 20 50 61 72 74 20 6f 66 20 61 20 63 6f /* Part of a co
1d660 6d 70 6f 75 6e 64 20 71 75 65 72 79 20 2a 2f 0a mpound query */.
1d670 23 64 65 66 69 6e 65 20 53 46 5f 56 61 6c 75 65 #define SF_Value
1d680 73 20 20 20 20 20 20 20 20 20 30 78 30 30 32 30 s 0x0020
1d690 30 20 20 2f 2a 20 53 79 6e 74 68 65 73 69 7a 65 0 /* Synthesize
1d6a0 64 20 66 72 6f 6d 20 56 41 4c 55 45 53 20 63 6c d from VALUES cl
1d6b0 61 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ause */.#define
1d6c0 53 46 5f 4d 75 6c 74 69 56 61 6c 75 65 20 20 20 SF_MultiValue
1d6d0 20 20 30 78 30 30 34 30 30 20 20 2f 2a 20 53 69 0x00400 /* Si
1d6e0 6e 67 6c 65 20 56 41 4c 55 45 53 20 74 65 72 6d ngle VALUES term
1d6f0 20 77 69 74 68 20 6d 75 6c 74 69 70 6c 65 20 72 with multiple r
1d700 6f 77 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ows */.#define S
1d710 46 5f 4e 65 73 74 65 64 46 72 6f 6d 20 20 20 20 F_NestedFrom
1d720 20 30 78 30 30 38 30 30 20 20 2f 2a 20 50 61 72 0x00800 /* Par
1d730 74 20 6f 66 20 61 20 70 61 72 65 6e 74 68 65 73 t of a parenthes
1d740 69 7a 65 64 20 46 52 4f 4d 20 63 6c 61 75 73 65 ized FROM clause
1d750 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d */.#define SF_M
1d760 69 6e 4d 61 78 41 67 67 20 20 20 20 20 20 30 78 inMaxAgg 0x
1d770 30 31 30 30 30 20 20 2f 2a 20 41 67 67 72 65 67 01000 /* Aggreg
1d780 61 74 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6d ate containing m
1d790 69 6e 28 29 20 6f 72 20 6d 61 78 28 29 20 2a 2f in() or max() */
1d7a0 0a 23 64 65 66 69 6e 65 20 53 46 5f 52 65 63 75 .#define SF_Recu
1d7b0 72 73 69 76 65 20 20 20 20 20 20 30 78 30 32 30 rsive 0x020
1d7c0 30 30 20 20 2f 2a 20 54 68 65 20 72 65 63 75 72 00 /* The recur
1d7d0 73 69 76 65 20 70 61 72 74 20 6f 66 20 61 20 72 sive part of a r
1d7e0 65 63 75 72 73 69 76 65 20 43 54 45 20 2a 2f 0a ecursive CTE */.
1d7f0 23 64 65 66 69 6e 65 20 53 46 5f 46 69 78 65 64 #define SF_Fixed
1d800 4c 69 6d 69 74 20 20 20 20 20 30 78 30 34 30 30 Limit 0x0400
1d810 30 20 20 2f 2a 20 6e 53 65 6c 65 63 74 52 6f 77 0 /* nSelectRow
1d820 20 73 65 74 20 62 79 20 61 20 63 6f 6e 73 74 61 set by a consta
1d830 6e 74 20 4c 49 4d 49 54 20 2a 2f 0a 23 64 65 66 nt LIMIT */.#def
1d840 69 6e 65 20 53 46 5f 4d 61 79 62 65 43 6f 6e 76 ine SF_MaybeConv
1d850 65 72 74 20 20 20 30 78 30 38 30 30 30 20 20 2f ert 0x08000 /
1d860 2a 20 4e 65 65 64 20 63 6f 6e 76 65 72 74 43 6f * Need convertCo
1d870 6d 70 6f 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 mpoundSelectToSu
1d880 62 71 75 65 72 79 28 29 20 2a 2f 0a 23 64 65 66 bquery() */.#def
1d890 69 6e 65 20 53 46 5f 43 6f 6e 76 65 72 74 65 64 ine SF_Converted
1d8a0 20 20 20 20 20 20 30 78 31 30 30 30 30 20 20 2f 0x10000 /
1d8b0 2a 20 42 79 20 63 6f 6e 76 65 72 74 43 6f 6d 70 * By convertComp
1d8c0 6f 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 oundSelectToSubq
1d8d0 75 65 72 79 28 29 20 2a 2f 0a 23 64 65 66 69 6e uery() */.#defin
1d8e0 65 20 53 46 5f 49 6e 63 6c 75 64 65 48 69 64 64 e SF_IncludeHidd
1d8f0 65 6e 20 20 30 78 32 30 30 30 30 20 20 2f 2a 20 en 0x20000 /*
1d900 49 6e 63 6c 75 64 65 20 68 69 64 64 65 6e 20 63 Include hidden c
1d910 6f 6c 75 6d 6e 73 20 69 6e 20 6f 75 74 70 75 74 olumns in output
1d920 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 43 */.#define SF_C
1d930 6f 6d 70 6c 65 78 52 65 73 75 6c 74 20 20 30 78 omplexResult 0x
1d940 34 30 30 30 30 20 20 2f 2a 20 52 65 73 75 6c 74 40000 /* Result
1d950 20 63 6f 6e 74 61 69 6e 73 20 73 75 62 71 75 65 contains subque
1d960 72 79 20 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a ry or function *
1d970 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 72 65 73 /../*.** The res
1d980 75 6c 74 73 20 6f 66 20 61 20 53 45 4c 45 43 54 ults of a SELECT
1d990 20 63 61 6e 20 62 65 20 64 69 73 74 72 69 62 75 can be distribu
1d9a0 74 65 64 20 69 6e 20 73 65 76 65 72 61 6c 20 77 ted in several w
1d9b0 61 79 73 2c 20 61 73 20 64 65 66 69 6e 65 64 0a ays, as defined.
1d9c0 2a 2a 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 ** by one of the
1d9d0 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f following macro
1d9e0 73 2e 20 20 54 68 65 20 22 53 52 54 22 20 70 72 s. The "SRT" pr
1d9f0 65 66 69 78 20 6d 65 61 6e 73 20 22 53 45 4c 45 efix means "SELE
1da00 43 54 20 52 65 73 75 6c 74 0a 2a 2a 20 54 79 70 CT Result.** Typ
1da10 65 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 e"..**.** SR
1da20 54 5f 55 6e 69 6f 6e 20 20 20 20 20 20 20 53 74 T_Union St
1da30 6f 72 65 20 72 65 73 75 6c 74 73 20 61 73 20 61 ore results as a
1da40 20 6b 65 79 20 69 6e 20 61 20 74 65 6d 70 6f 72 key in a tempor
1da50 61 72 79 20 69 6e 64 65 78 0a 2a 2a 20 20 20 20 ary index.**
1da60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1da70 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 70 identified by p
1da80 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a Dest->iSDParm..*
1da90 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 45 78 63 *.** SRT_Exc
1daa0 65 70 74 20 20 20 20 20 20 52 65 6d 6f 76 65 20 ept Remove
1dab0 72 65 73 75 6c 74 73 20 66 72 6f 6d 20 74 68 65 results from the
1dac0 20 74 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 78 temporary index
1dad0 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e pDest->iSDParm.
1dae0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 45 .**.** SRT_E
1daf0 78 69 73 74 73 20 20 20 20 20 20 53 74 6f 72 65 xists Store
1db00 20 61 20 31 20 69 6e 20 6d 65 6d 6f 72 79 20 63 a 1 in memory c
1db10 65 6c 6c 20 70 44 65 73 74 2d 3e 69 53 44 50 61 ell pDest->iSDPa
1db20 72 6d 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 rm if the result
1db30 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1db40 20 20 20 20 20 20 20 20 73 65 74 20 69 73 20 6e set is n
1db50 6f 74 20 65 6d 70 74 79 2e 0a 2a 2a 0a 2a 2a 20 ot empty..**.**
1db60 20 20 20 20 53 52 54 5f 44 69 73 63 61 72 64 20 SRT_Discard
1db70 20 20 20 20 54 68 72 6f 77 20 74 68 65 20 72 65 Throw the re
1db80 73 75 6c 74 73 20 61 77 61 79 2e 20 20 54 68 69 sults away. Thi
1db90 73 20 69 73 20 75 73 65 64 20 62 79 20 53 45 4c s is used by SEL
1dba0 45 43 54 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ECT.**
1dbb0 20 20 20 20 20 20 20 20 20 20 20 73 74 61 74 65 state
1dbc0 6d 65 6e 74 73 20 77 69 74 68 69 6e 20 74 72 69 ments within tri
1dbd0 67 67 65 72 73 20 77 68 6f 73 65 20 6f 6e 6c 79 ggers whose only
1dbe0 20 70 75 72 70 6f 73 65 20 69 73 0a 2a 2a 20 20 purpose is.**
1dbf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dc00 20 20 20 74 68 65 20 73 69 64 65 2d 65 66 66 65 the side-effe
1dc10 63 74 73 20 6f 66 20 66 75 6e 63 74 69 6f 6e 73 cts of functions
1dc20 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 6f 66 20 74 ..**.** All of t
1dc30 68 65 20 61 62 6f 76 65 20 61 72 65 20 66 72 65 he above are fre
1dc40 65 20 74 6f 20 69 67 6e 6f 72 65 20 74 68 65 69 e to ignore thei
1dc50 72 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 r ORDER BY claus
1dc60 65 2e 20 54 68 6f 73 65 20 74 68 61 74 0a 2a 2a e. Those that.**
1dc70 20 66 6f 6c 6c 6f 77 20 6d 75 73 74 20 68 6f 6e follow must hon
1dc80 6f 72 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 or the ORDER BY
1dc90 63 6c 61 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 clause..**.**
1dca0 20 20 53 52 54 5f 4f 75 74 70 75 74 20 20 20 20 SRT_Output
1dcb0 20 20 47 65 6e 65 72 61 74 65 20 61 20 72 6f 77 Generate a row
1dcc0 20 6f 66 20 6f 75 74 70 75 74 20 28 75 73 69 6e of output (usin
1dcd0 67 20 74 68 65 20 4f 50 5f 52 65 73 75 6c 74 52 g the OP_ResultR
1dce0 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 ow.**
1dcf0 20 20 20 20 20 20 20 20 20 20 6f 70 63 6f 64 65 opcode
1dd00 29 20 66 6f 72 20 65 61 63 68 20 72 6f 77 20 69 ) for each row i
1dd10 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 n the result set
1dd20 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
1dd30 4d 65 6d 20 20 20 20 20 20 20 20 20 4f 6e 6c 79 Mem Only
1dd40 20 76 61 6c 69 64 20 69 66 20 74 68 65 20 72 65 valid if the re
1dd50 73 75 6c 74 20 69 73 20 61 20 73 69 6e 67 6c 65 sult is a single
1dd60 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 20 20 20 20 column..**
1dd70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dd80 53 74 6f 72 65 20 74 68 65 20 66 69 72 73 74 20 Store the first
1dd90 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 66 69 column of the fi
1dda0 72 73 74 20 72 65 73 75 6c 74 20 72 6f 77 0a 2a rst result row.*
1ddb0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1ddc0 20 20 20 20 20 20 69 6e 20 72 65 67 69 73 74 65 in registe
1ddd0 72 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d r pDest->iSDParm
1dde0 20 74 68 65 6e 20 61 62 61 6e 64 6f 6e 20 74 68 then abandon th
1ddf0 65 20 72 65 73 74 0a 2a 2a 20 20 20 20 20 20 20 e rest.**
1de00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f 66 of
1de10 20 74 68 65 20 71 75 65 72 79 2e 20 20 54 68 69 the query. Thi
1de20 73 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 69 6d s destination im
1de30 70 6c 69 65 73 20 22 4c 49 4d 49 54 20 31 22 2e plies "LIMIT 1".
1de40 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 53 .**.** SRT_S
1de50 65 74 20 20 20 20 20 20 20 20 20 54 68 65 20 72 et The r
1de60 65 73 75 6c 74 20 6d 75 73 74 20 62 65 20 61 20 esult must be a
1de70 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2e 20 20 single column.
1de80 53 74 6f 72 65 20 65 61 63 68 0a 2a 2a 20 20 20 Store each.**
1de90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dea0 20 20 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 20 row of result
1deb0 61 73 20 74 68 65 20 6b 65 79 20 69 6e 20 74 61 as the key in ta
1dec0 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 50 61 ble pDest->iSDPa
1ded0 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 rm..**
1dee0 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c 79 Apply
1def0 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 70 44 the affinity pD
1df00 65 73 74 2d 3e 61 66 66 53 64 73 74 20 62 65 66 est->affSdst bef
1df10 6f 72 65 20 73 74 6f 72 69 6e 67 0a 2a 2a 20 20 ore storing.**
1df20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1df30 20 20 20 72 65 73 75 6c 74 73 2e 20 20 55 73 65 results. Use
1df40 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 22 d to implement "
1df50 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 IN (SELECT ...)"
1df60 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
1df70 45 70 68 65 6d 54 61 62 20 20 20 20 43 72 65 61 EphemTab Crea
1df80 74 65 20 61 6e 20 74 65 6d 70 6f 72 61 72 79 20 te an temporary
1df90 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 table pDest->iSD
1dfa0 50 61 72 6d 20 61 6e 64 20 73 74 6f 72 65 0a 2a Parm and store.*
1dfb0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1dfc0 20 20 20 20 20 20 74 68 65 20 72 65 73 75 6c 74 the result
1dfd0 20 74 68 65 72 65 2e 20 54 68 65 20 63 75 72 73 there. The curs
1dfe0 6f 72 20 69 73 20 6c 65 66 74 20 6f 70 65 6e 20 or is left open
1dff0 61 66 74 65 72 0a 2a 2a 20 20 20 20 20 20 20 20 after.**
1e000 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 74 ret
1e010 75 72 6e 69 6e 67 2e 20 20 54 68 69 73 20 69 73 urning. This is
1e020 20 6c 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 20 like SRT_Table
1e030 65 78 63 65 70 74 20 74 68 61 74 0a 2a 2a 20 20 except that.**
1e040 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e050 20 20 20 74 68 69 73 20 64 65 73 74 69 6e 61 74 this destinat
1e060 69 6f 6e 20 75 73 65 73 20 4f 50 5f 4f 70 65 6e ion uses OP_Open
1e070 45 70 68 65 6d 65 72 61 6c 20 74 6f 20 63 72 65 Ephemeral to cre
1e080 61 74 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ate.**
1e090 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 74 the t
1e0a0 61 62 6c 65 20 66 69 72 73 74 2e 0a 2a 2a 0a 2a able first..**.*
1e0b0 2a 20 20 20 20 20 53 52 54 5f 43 6f 72 6f 75 74 * SRT_Corout
1e0c0 69 6e 65 20 20 20 47 65 6e 65 72 61 74 65 20 61 ine Generate a
1e0d0 20 63 6f 2d 72 6f 75 74 69 6e 65 20 74 68 61 74 co-routine that
1e0e0 20 72 65 74 75 72 6e 73 20 61 20 6e 65 77 20 72 returns a new r
1e0f0 6f 77 20 6f 66 0a 2a 2a 20 20 20 20 20 20 20 20 ow of.**
1e100 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 73 res
1e110 75 6c 74 73 20 65 61 63 68 20 74 69 6d 65 20 69 ults each time i
1e120 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 54 t is invoked. T
1e130 68 65 20 65 6e 74 72 79 20 70 6f 69 6e 74 0a 2a he entry point.*
1e140 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1e150 20 20 20 20 20 20 6f 66 20 74 68 65 20 63 6f 2d of the co-
1e160 72 6f 75 74 69 6e 65 20 69 73 20 73 74 6f 72 65 routine is store
1e170 64 20 69 6e 20 72 65 67 69 73 74 65 72 20 70 44 d in register pD
1e180 65 73 74 2d 3e 69 53 44 50 61 72 6d 0a 2a 2a 20 est->iSDParm.**
1e190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e1a0 20 20 20 20 61 6e 64 20 74 68 65 20 72 65 73 75 and the resu
1e1b0 6c 74 20 72 6f 77 20 69 73 20 73 74 6f 72 65 64 lt row is stored
1e1c0 20 69 6e 20 70 44 65 73 74 2d 3e 6e 44 65 73 74 in pDest->nDest
1e1d0 20 72 65 67 69 73 74 65 72 73 0a 2a 2a 20 20 20 registers.**
1e1e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e1f0 20 20 73 74 61 72 74 69 6e 67 20 77 69 74 68 20 starting with
1e200 70 44 65 73 74 2d 3e 69 53 64 73 74 2e 0a 2a 2a pDest->iSdst..**
1e210 0a 2a 2a 20 20 20 20 20 53 52 54 5f 54 61 62 6c .** SRT_Tabl
1e220 65 20 20 20 20 20 20 20 53 74 6f 72 65 20 72 65 e Store re
1e230 73 75 6c 74 73 20 69 6e 20 74 65 6d 70 6f 72 61 sults in tempora
1e240 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e ry table pDest->
1e250 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 iSDParm..**
1e260 53 52 54 5f 46 69 66 6f 20 20 20 20 20 20 20 20 SRT_Fifo
1e270 54 68 69 73 20 69 73 20 6c 69 6b 65 20 53 52 54 This is like SRT
1e280 5f 45 70 68 65 6d 54 61 62 20 65 78 63 65 70 74 _EphemTab except
1e290 20 74 68 61 74 20 74 68 65 20 74 61 62 6c 65 0a that the table.
1e2a0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1e2b0 20 20 20 20 20 20 20 69 73 20 61 73 73 75 6d 65 is assume
1e2c0 64 20 74 6f 20 61 6c 72 65 61 64 79 20 62 65 20 d to already be
1e2d0 6f 70 65 6e 2e 20 20 53 52 54 5f 46 69 66 6f 20 open. SRT_Fifo
1e2e0 68 61 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 has.**
1e2f0 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 61 the a
1e300 64 64 69 74 69 6f 6e 61 6c 20 70 72 6f 70 65 72 dditional proper
1e310 74 79 20 6f 66 20 62 65 69 6e 67 20 61 62 6c 65 ty of being able
1e320 20 74 6f 20 69 67 6e 6f 72 65 0a 2a 2a 20 20 20 to ignore.**
1e330 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e340 20 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 the ORDER BY c
1e350 6c 61 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 lause..**.**
1e360 20 53 52 54 5f 44 69 73 74 46 69 66 6f 20 20 20 SRT_DistFifo
1e370 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 69 Store results i
1e380 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 74 61 n a temporary ta
1e390 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 50 61 ble pDest->iSDPa
1e3a0 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 rm..**
1e3b0 20 20 20 20 20 20 20 20 20 20 20 42 75 74 20 61 But a
1e3c0 6c 73 6f 20 75 73 65 20 74 65 6d 70 6f 72 61 72 lso use temporar
1e3d0 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 y table pDest->i
1e3e0 53 44 50 61 72 6d 2b 31 20 61 73 0a 2a 2a 20 20 SDParm+1 as.**
1e3f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e400 20 20 20 61 20 72 65 63 6f 72 64 20 6f 66 20 61 a record of a
1e410 6c 6c 20 70 72 69 6f 72 20 72 65 73 75 6c 74 73 ll prior results
1e420 20 61 6e 64 20 69 67 6e 6f 72 65 20 61 6e 79 20 and ignore any
1e430 64 75 70 6c 69 63 61 74 65 0a 2a 2a 20 20 20 20 duplicate.**
1e440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e450 20 72 6f 77 73 2e 20 20 4e 61 6d 65 20 6d 65 61 rows. Name mea
1e460 6e 73 3a 20 20 22 44 69 73 74 69 6e 63 74 20 46 ns: "Distinct F
1e470 69 66 6f 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 ifo"..**.**
1e480 53 52 54 5f 51 75 65 75 65 20 20 20 20 20 20 20 SRT_Queue
1e490 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 69 6e Store results in
1e4a0 20 70 72 69 6f 72 69 74 79 20 71 75 65 75 65 20 priority queue
1e4b0 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 28 pDest->iSDParm (
1e4c0 72 65 61 6c 6c 79 0a 2a 2a 20 20 20 20 20 20 20 really.**
1e4d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e an
1e4e0 20 69 6e 64 65 78 29 2e 20 20 41 70 70 65 6e 64 index). Append
1e4f0 20 61 20 73 65 71 75 65 6e 63 65 20 6e 75 6d 62 a sequence numb
1e500 65 72 20 73 6f 20 74 68 61 74 20 61 6c 6c 20 65 er so that all e
1e510 6e 74 72 69 65 73 0a 2a 2a 20 20 20 20 20 20 20 ntries.**
1e520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 ar
1e530 65 20 64 69 73 74 69 6e 63 74 2e 0a 2a 2a 0a 2a e distinct..**.*
1e540 2a 20 20 20 20 20 53 52 54 5f 44 69 73 74 51 75 * SRT_DistQu
1e550 65 75 65 20 20 20 53 74 6f 72 65 20 72 65 73 75 eue Store resu
1e560 6c 74 73 20 69 6e 20 70 72 69 6f 72 69 74 79 20 lts in priority
1e570 71 75 65 75 65 20 70 44 65 73 74 2d 3e 69 53 44 queue pDest->iSD
1e580 50 61 72 6d 20 6f 6e 6c 79 20 69 66 0a 2a 2a 20 Parm only if.**
1e590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e5a0 20 20 20 20 74 68 65 20 73 61 6d 65 20 72 65 63 the same rec
1e5b0 6f 72 64 20 68 61 73 20 6e 65 76 65 72 20 62 65 ord has never be
1e5c0 65 6e 20 73 74 6f 72 65 64 20 62 65 66 6f 72 65 en stored before
1e5d0 2e 20 20 54 68 65 0a 2a 2a 20 20 20 20 20 20 20 . The.**
1e5e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e in
1e5f0 64 65 78 20 61 74 20 70 44 65 73 74 2d 3e 69 53 dex at pDest->iS
1e600 44 50 61 72 6d 2b 31 20 68 6f 6c 64 20 61 6c 6c DParm+1 hold all
1e610 20 70 72 69 6f 72 20 73 74 6f 72 65 73 2e 0a 2a prior stores..*
1e620 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 55 6e /.#define SRT_Un
1e630 69 6f 6e 20 20 20 20 20 20 20 20 31 20 20 2f 2a ion 1 /*
1e640 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 73 Store result as
1e650 20 6b 65 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 keys in an inde
1e660 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 x */.#define SRT
1e670 5f 45 78 63 65 70 74 20 20 20 20 20 20 20 32 20 _Except 2
1e680 20 2f 2a 20 52 65 6d 6f 76 65 20 72 65 73 75 6c /* Remove resul
1e690 74 20 66 72 6f 6d 20 61 20 55 4e 49 4f 4e 20 69 t from a UNION i
1e6a0 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ndex */.#define
1e6b0 53 52 54 5f 45 78 69 73 74 73 20 20 20 20 20 20 SRT_Exists
1e6c0 20 33 20 20 2f 2a 20 53 74 6f 72 65 20 31 20 69 3 /* Store 1 i
1e6d0 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 f the result is
1e6e0 6e 6f 74 20 65 6d 70 74 79 20 2a 2f 0a 23 64 65 not empty */.#de
1e6f0 66 69 6e 65 20 53 52 54 5f 44 69 73 63 61 72 64 fine SRT_Discard
1e700 20 20 20 20 20 20 34 20 20 2f 2a 20 44 6f 20 6e 4 /* Do n
1e710 6f 74 20 73 61 76 65 20 74 68 65 20 72 65 73 75 ot save the resu
1e720 6c 74 73 20 61 6e 79 77 68 65 72 65 20 2a 2f 0a lts anywhere */.
1e730 23 64 65 66 69 6e 65 20 53 52 54 5f 46 69 66 6f #define SRT_Fifo
1e740 20 20 20 20 20 20 20 20 20 35 20 20 2f 2a 20 53 5 /* S
1e750 74 6f 72 65 20 72 65 73 75 6c 74 20 61 73 20 64 tore result as d
1e760 61 74 61 20 77 69 74 68 20 61 6e 20 61 75 74 6f ata with an auto
1e770 6d 61 74 69 63 20 72 6f 77 69 64 20 2a 2f 0a 23 matic rowid */.#
1e780 64 65 66 69 6e 65 20 53 52 54 5f 44 69 73 74 46 define SRT_DistF
1e790 69 66 6f 20 20 20 20 20 36 20 20 2f 2a 20 4c 69 ifo 6 /* Li
1e7a0 6b 65 20 53 52 54 5f 46 69 66 6f 2c 20 62 75 74 ke SRT_Fifo, but
1e7b0 20 75 6e 69 71 75 65 20 72 65 73 75 6c 74 73 20 unique results
1e7c0 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 only */.#define
1e7d0 53 52 54 5f 51 75 65 75 65 20 20 20 20 20 20 20 SRT_Queue
1e7e0 20 37 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 7 /* Store res
1e7f0 75 6c 74 20 69 6e 20 61 6e 20 71 75 65 75 65 20 ult in an queue
1e800 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 44 */.#define SRT_D
1e810 69 73 74 51 75 65 75 65 20 20 20 20 38 20 20 2f istQueue 8 /
1e820 2a 20 4c 69 6b 65 20 53 52 54 5f 51 75 65 75 65 * Like SRT_Queue
1e830 2c 20 62 75 74 20 75 6e 69 71 75 65 20 72 65 73 , but unique res
1e840 75 6c 74 73 20 6f 6e 6c 79 20 2a 2f 0a 0a 2f 2a ults only */../*
1e850 20 54 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c The ORDER BY cl
1e860 61 75 73 65 20 69 73 20 69 67 6e 6f 72 65 64 20 ause is ignored
1e870 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 for all of the a
1e880 62 6f 76 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 bove */.#define
1e890 49 67 6e 6f 72 61 62 6c 65 4f 72 64 65 72 62 79 IgnorableOrderby
1e8a0 28 58 29 20 28 28 58 2d 3e 65 44 65 73 74 29 3c (X) ((X->eDest)<
1e8b0 3d 53 52 54 5f 44 69 73 74 51 75 65 75 65 29 0a =SRT_DistQueue).
1e8c0 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 4f 75 74 .#define SRT_Out
1e8d0 70 75 74 20 20 20 20 20 20 20 39 20 20 2f 2a 20 put 9 /*
1e8e0 4f 75 74 70 75 74 20 65 61 63 68 20 72 6f 77 20 Output each row
1e8f0 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a 23 64 65 of result */.#de
1e900 66 69 6e 65 20 53 52 54 5f 4d 65 6d 20 20 20 20 fine SRT_Mem
1e910 20 20 20 20 20 31 30 20 20 2f 2a 20 53 74 6f 72 10 /* Stor
1e920 65 20 72 65 73 75 6c 74 20 69 6e 20 61 20 6d 65 e result in a me
1e930 6d 6f 72 79 20 63 65 6c 6c 20 2a 2f 0a 23 64 65 mory cell */.#de
1e940 66 69 6e 65 20 53 52 54 5f 53 65 74 20 20 20 20 fine SRT_Set
1e950 20 20 20 20 20 31 31 20 20 2f 2a 20 53 74 6f 72 11 /* Stor
1e960 65 20 72 65 73 75 6c 74 73 20 61 73 20 6b 65 79 e results as key
1e970 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 2a 2f s in an index */
1e980 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 70 68 .#define SRT_Eph
1e990 65 6d 54 61 62 20 20 20 20 31 32 20 20 2f 2a 20 emTab 12 /*
1e9a0 43 72 65 61 74 65 20 74 72 61 6e 73 69 65 6e 74 Create transient
1e9b0 20 74 61 62 20 61 6e 64 20 73 74 6f 72 65 20 6c tab and store l
1e9c0 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 20 2a 2f ike SRT_Table */
1e9d0 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 43 6f 72 .#define SRT_Cor
1e9e0 6f 75 74 69 6e 65 20 20 20 31 33 20 20 2f 2a 20 outine 13 /*
1e9f0 47 65 6e 65 72 61 74 65 20 61 20 73 69 6e 67 6c Generate a singl
1ea00 65 20 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 20 e row of result
1ea10 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 54 */.#define SRT_T
1ea20 61 62 6c 65 20 20 20 20 20 20 20 31 34 20 20 2f able 14 /
1ea30 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 * Store result a
1ea40 73 20 64 61 74 61 20 77 69 74 68 20 61 6e 20 61 s data with an a
1ea50 75 74 6f 6d 61 74 69 63 20 72 6f 77 69 64 20 2a utomatic rowid *
1ea60 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 /../*.** An inst
1ea70 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a ance of this obj
1ea80 65 63 74 20 64 65 73 63 72 69 62 65 73 20 77 68 ect describes wh
1ea90 65 72 65 20 74 6f 20 70 75 74 20 6f 66 20 74 68 ere to put of th
1eaa0 65 20 72 65 73 75 6c 74 73 20 6f 66 0a 2a 2a 20 e results of.**
1eab0 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 a SELECT stateme
1eac0 6e 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 65 nt..*/.struct Se
1ead0 6c 65 63 74 44 65 73 74 20 7b 0a 20 20 75 38 20 lectDest {. u8
1eae0 65 44 65 73 74 3b 20 20 20 20 20 20 20 20 20 20 eDest;
1eaf0 20 20 2f 2a 20 48 6f 77 20 74 6f 20 64 69 73 70 /* How to disp
1eb00 6f 73 65 20 6f 66 20 74 68 65 20 72 65 73 75 6c ose of the resul
1eb10 74 73 2e 20 20 4f 6e 20 6f 66 20 53 52 54 5f 2a ts. On of SRT_*
1eb20 20 61 62 6f 76 65 2e 20 2a 2f 0a 20 20 69 6e 74 above. */. int
1eb30 20 69 53 44 50 61 72 6d 3b 20 20 20 20 20 20 20 iSDParm;
1eb40 20 20 2f 2a 20 41 20 70 61 72 61 6d 65 74 65 72 /* A parameter
1eb50 20 75 73 65 64 20 62 79 20 74 68 65 20 65 44 65 used by the eDe
1eb60 73 74 20 64 69 73 70 6f 73 61 6c 20 6d 65 74 68 st disposal meth
1eb70 6f 64 20 2a 2f 0a 20 20 69 6e 74 20 69 53 64 73 od */. int iSds
1eb80 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
1eb90 42 61 73 65 20 72 65 67 69 73 74 65 72 20 77 68 Base register wh
1eba0 65 72 65 20 72 65 73 75 6c 74 73 20 61 72 65 20 ere results are
1ebb0 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 69 6e 74 written */. int
1ebc0 20 6e 53 64 73 74 3b 20 20 20 20 20 20 20 20 20 nSdst;
1ebd0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 /* Number of r
1ebe0 65 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 egisters allocat
1ebf0 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 41 ed */. char *zA
1ec00 66 66 53 64 73 74 3b 20 20 20 20 20 20 2f 2a 20 ffSdst; /*
1ec10 41 66 66 69 6e 69 74 79 20 75 73 65 64 20 77 68 Affinity used wh
1ec20 65 6e 20 65 44 65 73 74 3d 3d 53 52 54 5f 53 65 en eDest==SRT_Se
1ec30 74 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 t */. ExprList
1ec40 2a 70 4f 72 64 65 72 42 79 3b 20 20 2f 2a 20 4b *pOrderBy; /* K
1ec50 65 79 20 63 6f 6c 75 6d 6e 73 20 66 6f 72 20 53 ey columns for S
1ec60 52 54 5f 51 75 65 75 65 20 61 6e 64 20 53 52 54 RT_Queue and SRT
1ec70 5f 44 69 73 74 51 75 65 75 65 20 2a 2f 0a 7d 3b _DistQueue */.};
1ec80 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 63 ../*.** During c
1ec90 6f 64 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f ode generation o
1eca0 66 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 61 f statements tha
1ecb0 74 20 64 6f 20 69 6e 73 65 72 74 73 20 69 6e 74 t do inserts int
1ecc0 6f 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 0a o AUTOINCREMENT.
1ecd0 2a 2a 20 74 61 62 6c 65 73 2c 20 74 68 65 20 66 ** tables, the f
1ece0 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 ollowing informa
1ecf0 74 69 6f 6e 20 69 73 20 61 74 74 61 63 68 65 64 tion is attached
1ed00 20 74 6f 20 74 68 65 20 54 61 62 6c 65 2e 75 2e to the Table.u.
1ed10 61 75 74 6f 49 6e 63 2e 70 0a 2a 2a 20 70 6f 69 autoInc.p.** poi
1ed20 6e 74 65 72 20 6f 66 20 65 61 63 68 20 61 75 74 nter of each aut
1ed30 6f 69 6e 63 72 65 6d 65 6e 74 20 74 61 62 6c 65 oincrement table
1ed40 20 74 6f 20 72 65 63 6f 72 64 20 73 6f 6d 65 20 to record some
1ed50 73 69 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e side information
1ed60 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 6f 64 that.** the cod
1ed70 65 20 67 65 6e 65 72 61 74 6f 72 20 6e 65 65 64 e generator need
1ed80 73 2e 20 20 57 65 20 68 61 76 65 20 74 6f 20 6b s. We have to k
1ed90 65 65 70 20 70 65 72 2d 74 61 62 6c 65 20 61 75 eep per-table au
1eda0 74 6f 69 6e 63 72 65 6d 65 6e 74 0a 2a 2a 20 69 toincrement.** i
1edb0 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 63 61 nformation in ca
1edc0 73 65 20 69 6e 73 65 72 74 73 20 61 72 65 20 64 se inserts are d
1edd0 6f 6e 65 20 77 69 74 68 69 6e 20 74 72 69 67 67 one within trigg
1ede0 65 72 73 2e 20 20 54 72 69 67 67 65 72 73 20 64 ers. Triggers d
1edf0 6f 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 6d 61 6c 6c o not.** normall
1ee00 79 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 68 65 y coordinate the
1ee10 69 72 20 61 63 74 69 76 69 74 69 65 73 2c 20 62 ir activities, b
1ee20 75 74 20 77 65 20 64 6f 20 6e 65 65 64 20 74 6f ut we do need to
1ee30 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 68 65 0a coordinate the.
1ee40 2a 2a 20 6c 6f 61 64 69 6e 67 20 61 6e 64 20 73 ** loading and s
1ee50 61 76 69 6e 67 20 6f 66 20 61 75 74 6f 69 6e 63 aving of autoinc
1ee60 72 65 6d 65 6e 74 20 69 6e 66 6f 72 6d 61 74 69 rement informati
1ee70 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 41 75 on..*/.struct Au
1ee80 74 6f 69 6e 63 49 6e 66 6f 20 7b 0a 20 20 41 75 toincInfo {. Au
1ee90 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 4e 65 78 74 toincInfo *pNext
1eea0 3b 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 66 6f ; /* Next info
1eeb0 20 62 6c 6f 63 6b 20 69 6e 20 61 20 6c 69 73 74 block in a list
1eec0 20 6f 66 20 74 68 65 6d 20 61 6c 6c 20 2a 2f 0a of them all */.
1eed0 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 Table *pTab;
1eee0 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 /* Table
1eef0 20 74 68 69 73 20 69 6e 66 6f 20 62 6c 6f 63 6b this info block
1ef00 20 72 65 66 65 72 73 20 74 6f 20 2a 2f 0a 20 20 refers to */.
1ef10 69 6e 74 20 69 44 62 3b 20 20 20 20 20 20 20 20 int iDb;
1ef20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 /* Index i
1ef30 6e 20 73 71 6c 69 74 65 33 2e 61 44 62 5b 5d 20 n sqlite3.aDb[]
1ef40 6f 66 20 64 61 74 61 62 61 73 65 20 68 6f 6c 64 of database hold
1ef50 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20 69 6e ing pTab */. in
1ef60 74 20 72 65 67 43 74 72 3b 20 20 20 20 20 20 20 t regCtr;
1ef70 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 72 65 /* Memory re
1ef80 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 74 gister holding t
1ef90 68 65 20 72 6f 77 69 64 20 63 6f 75 6e 74 65 72 he rowid counter
1efa0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 69 */.};../*.** Si
1efb0 7a 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e ze of the column
1efc0 20 63 61 63 68 65 0a 2a 2f 0a 23 69 66 6e 64 65 cache.*/.#ifnde
1efd0 66 20 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 f SQLITE_N_COLCA
1efe0 43 48 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c CHE.# define SQL
1eff0 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 20 31 ITE_N_COLCACHE 1
1f000 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 0.#endif../*.**
1f010 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 69 6e 73 At least one ins
1f020 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c tance of the fol
1f030 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 lowing structure
1f040 20 69 73 20 63 72 65 61 74 65 64 20 66 6f 72 20 is created for
1f050 65 61 63 68 0a 2a 2a 20 74 72 69 67 67 65 72 20 each.** trigger
1f060 74 68 61 74 20 6d 61 79 20 62 65 20 66 69 72 65 that may be fire
1f070 64 20 77 68 69 6c 65 20 70 61 72 73 69 6e 67 20 d while parsing
1f080 61 6e 20 49 4e 53 45 52 54 2c 20 55 50 44 41 54 an INSERT, UPDAT
1f090 45 20 6f 72 20 44 45 4c 45 54 45 0a 2a 2a 20 73 E or DELETE.** s
1f0a0 74 61 74 65 6d 65 6e 74 2e 20 41 6c 6c 20 73 75 tatement. All su
1f0b0 63 68 20 6f 62 6a 65 63 74 73 20 61 72 65 20 73 ch objects are s
1f0c0 74 6f 72 65 64 20 69 6e 20 74 68 65 20 6c 69 6e tored in the lin
1f0d0 6b 65 64 20 6c 69 73 74 20 68 65 61 64 65 64 20 ked list headed
1f0e0 61 74 0a 2a 2a 20 50 61 72 73 65 2e 70 54 72 69 at.** Parse.pTri
1f0f0 67 67 65 72 50 72 67 20 61 6e 64 20 64 65 6c 65 ggerPrg and dele
1f100 74 65 64 20 6f 6e 63 65 20 73 74 61 74 65 6d 65 ted once stateme
1f110 6e 74 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 68 nt compilation h
1f120 61 73 20 62 65 65 6e 0a 2a 2a 20 63 6f 6d 70 6c as been.** compl
1f130 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 56 64 eted..**.** A Vd
1f140 62 65 20 73 75 62 2d 70 72 6f 67 72 61 6d 20 74 be sub-program t
1f150 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 hat implements t
1f160 68 65 20 62 6f 64 79 20 61 6e 64 20 57 48 45 4e he body and WHEN
1f170 20 63 6c 61 75 73 65 20 6f 66 20 74 72 69 67 67 clause of trigg
1f180 65 72 0a 2a 2a 20 54 72 69 67 67 65 72 50 72 67 er.** TriggerPrg
1f190 2e 70 54 72 69 67 67 65 72 2c 20 61 73 73 75 6d .pTrigger, assum
1f1a0 69 6e 67 20 61 20 64 65 66 61 75 6c 74 20 4f 4e ing a default ON
1f1b0 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 CONFLICT clause
1f1c0 20 6f 66 0a 2a 2a 20 54 72 69 67 67 65 72 50 72 of.** TriggerPr
1f1d0 67 2e 6f 72 63 6f 6e 66 2c 20 69 73 20 73 74 6f g.orconf, is sto
1f1e0 72 65 64 20 69 6e 20 74 68 65 20 54 72 69 67 67 red in the Trigg
1f1f0 65 72 50 72 67 2e 70 50 72 6f 67 72 61 6d 20 76 erPrg.pProgram v
1f200 61 72 69 61 62 6c 65 2e 0a 2a 2a 20 54 68 65 20 ariable..** The
1f210 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 72 Parse.pTriggerPr
1f220 67 20 6c 69 73 74 20 6e 65 76 65 72 20 63 6f 6e g list never con
1f230 74 61 69 6e 73 20 74 77 6f 20 65 6e 74 72 69 65 tains two entrie
1f240 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 0a s with the same.
1f250 2a 2a 20 76 61 6c 75 65 73 20 66 6f 72 20 62 6f ** values for bo
1f260 74 68 20 70 54 72 69 67 67 65 72 20 61 6e 64 20 th pTrigger and
1f270 6f 72 63 6f 6e 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 orconf..**.** Th
1f280 65 20 54 72 69 67 67 65 72 50 72 67 2e 61 43 6f e TriggerPrg.aCo
1f290 6c 6d 61 73 6b 5b 30 5d 20 76 61 72 69 61 62 6c lmask[0] variabl
1f2a0 65 20 69 73 20 73 65 74 20 74 6f 20 61 20 6d 61 e is set to a ma
1f2b0 73 6b 20 6f 66 20 6f 6c 64 2e 2a 20 63 6f 6c 75 sk of old.* colu
1f2c0 6d 6e 73 0a 2a 2a 20 61 63 63 65 73 73 65 64 20 mns.** accessed
1f2d0 28 6f 72 20 73 65 74 20 74 6f 20 30 20 66 6f 72 (or set to 0 for
1f2e0 20 74 72 69 67 67 65 72 73 20 66 69 72 65 64 20 triggers fired
1f2f0 61 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20 49 as a result of I
1f300 4e 53 45 52 54 0a 2a 2a 20 73 74 61 74 65 6d 65 NSERT.** stateme
1f310 6e 74 73 29 2e 20 53 69 6d 69 6c 61 72 6c 79 2c nts). Similarly,
1f320 20 74 68 65 20 54 72 69 67 67 65 72 50 72 67 2e the TriggerPrg.
1f330 61 43 6f 6c 6d 61 73 6b 5b 31 5d 20 76 61 72 69 aColmask[1] vari
1f340 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f 0a 2a able is set to.*
1f350 2a 20 61 20 6d 61 73 6b 20 6f 66 20 6e 65 77 2e * a mask of new.
1f360 2a 20 63 6f 6c 75 6d 6e 73 20 75 73 65 64 20 62 * columns used b
1f370 79 20 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a 2a y the program..*
1f380 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 65 72 /.struct Trigger
1f390 50 72 67 20 7b 0a 20 20 54 72 69 67 67 65 72 20 Prg {. Trigger
1f3a0 2a 70 54 72 69 67 67 65 72 3b 20 20 20 20 20 20 *pTrigger;
1f3b0 2f 2a 20 54 72 69 67 67 65 72 20 74 68 69 73 20 /* Trigger this
1f3c0 70 72 6f 67 72 61 6d 20 77 61 73 20 63 6f 64 65 program was code
1f3d0 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 54 72 69 67 d from */. Trig
1f3e0 67 65 72 50 72 67 20 2a 70 4e 65 78 74 3b 20 20 gerPrg *pNext;
1f3f0 20 20 20 20 2f 2a 20 4e 65 78 74 20 65 6e 74 72 /* Next entr
1f400 79 20 69 6e 20 50 61 72 73 65 2e 70 54 72 69 67 y in Parse.pTrig
1f410 67 65 72 50 72 67 20 6c 69 73 74 20 2a 2f 0a 20 gerPrg list */.
1f420 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 70 50 72 SubProgram *pPr
1f430 6f 67 72 61 6d 3b 20 20 20 2f 2a 20 50 72 6f 67 ogram; /* Prog
1f440 72 61 6d 20 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 ram implementing
1f450 20 70 54 72 69 67 67 65 72 2f 6f 72 63 6f 6e 66 pTrigger/orconf
1f460 20 2a 2f 0a 20 20 69 6e 74 20 6f 72 63 6f 6e 66 */. int orconf
1f470 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
1f480 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 Default ON CONF
1f490 4c 49 43 54 20 70 6f 6c 69 63 79 20 2a 2f 0a 20 LICT policy */.
1f4a0 20 75 33 32 20 61 43 6f 6c 6d 61 73 6b 5b 32 5d u32 aColmask[2]
1f4b0 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b ; /* Mask
1f4c0 73 20 6f 66 20 6f 6c 64 2e 2a 2c 20 6e 65 77 2e s of old.*, new.
1f4d0 2a 20 63 6f 6c 75 6d 6e 73 20 61 63 63 65 73 73 * columns access
1f4e0 65 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 ed */.};../*.**
1f4f0 54 68 65 20 79 44 62 4d 61 73 6b 20 64 61 74 61 The yDbMask data
1f500 74 79 70 65 20 66 6f 72 20 74 68 65 20 62 69 74 type for the bit
1f510 6d 61 73 6b 20 6f 66 20 61 6c 6c 20 61 74 74 61 mask of all atta
1f520 63 68 65 64 20 64 61 74 61 62 61 73 65 73 2e 0a ched databases..
1f530 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 */.#if SQLITE_MA
1f540 58 5f 41 54 54 41 43 48 45 44 3e 33 30 0a 20 20 X_ATTACHED>30.
1f550 74 79 70 65 64 65 66 20 75 6e 73 69 67 6e 65 64 typedef unsigned
1f560 20 63 68 61 72 20 79 44 62 4d 61 73 6b 5b 28 53 char yDbMask[(S
1f570 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 QLITE_MAX_ATTACH
1f580 45 44 2b 39 29 2f 38 5d 3b 0a 23 20 64 65 66 69 ED+9)/8];.# defi
1f590 6e 65 20 44 62 4d 61 73 6b 54 65 73 74 28 4d 2c ne DbMaskTest(M,
1f5a0 49 29 20 20 20 20 28 28 28 4d 29 5b 28 49 29 2f I) (((M)[(I)/
1f5b0 38 5d 26 28 31 3c 3c 28 28 49 29 26 37 29 29 29 8]&(1<<((I)&7)))
1f5c0 21 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 44 62 !=0).# define Db
1f5d0 4d 61 73 6b 5a 65 72 6f 28 4d 29 20 20 20 20 20 MaskZero(M)
1f5e0 20 6d 65 6d 73 65 74 28 28 4d 29 2c 30 2c 73 69 memset((M),0,si
1f5f0 7a 65 6f 66 28 4d 29 29 0a 23 20 64 65 66 69 6e zeof(M)).# defin
1f600 65 20 44 62 4d 61 73 6b 53 65 74 28 4d 2c 49 29 e DbMaskSet(M,I)
1f610 20 20 20 20 20 28 4d 29 5b 28 49 29 2f 38 5d 7c (M)[(I)/8]|
1f620 3d 28 31 3c 3c 28 28 49 29 26 37 29 29 0a 23 20 =(1<<((I)&7)).#
1f630 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 41 6c 6c define DbMaskAll
1f640 5a 65 72 6f 28 4d 29 20 20 20 73 71 6c 69 74 65 Zero(M) sqlite
1f650 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 4d 3DbMaskAllZero(M
1f660 29 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 ).# define DbMas
1f670 6b 4e 6f 6e 5a 65 72 6f 28 4d 29 20 20 20 28 73 kNonZero(M) (s
1f680 71 6c 69 74 65 33 44 62 4d 61 73 6b 41 6c 6c 5a qlite3DbMaskAllZ
1f690 65 72 6f 28 4d 29 3d 3d 30 29 0a 23 65 6c 73 65 ero(M)==0).#else
1f6a0 0a 20 20 74 79 70 65 64 65 66 20 75 6e 73 69 67 . typedef unsig
1f6b0 6e 65 64 20 69 6e 74 20 79 44 62 4d 61 73 6b 3b ned int yDbMask;
1f6c0 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b .# define DbMask
1f6d0 54 65 73 74 28 4d 2c 49 29 20 20 20 20 28 28 28 Test(M,I) (((
1f6e0 4d 29 26 28 28 28 79 44 62 4d 61 73 6b 29 31 29 M)&(((yDbMask)1)
1f6f0 3c 3c 28 49 29 29 29 21 3d 30 29 0a 23 20 64 65 <<(I)))!=0).# de
1f700 66 69 6e 65 20 44 62 4d 61 73 6b 5a 65 72 6f 28 fine DbMaskZero(
1f710 4d 29 20 20 20 20 20 20 28 4d 29 3d 30 0a 23 20 M) (M)=0.#
1f720 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 53 65 74 define DbMaskSet
1f730 28 4d 2c 49 29 20 20 20 20 20 28 4d 29 7c 3d 28 (M,I) (M)|=(
1f740 28 28 79 44 62 4d 61 73 6b 29 31 29 3c 3c 28 49 ((yDbMask)1)<<(I
1f750 29 29 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 )).# define DbMa
1f760 73 6b 41 6c 6c 5a 65 72 6f 28 4d 29 20 20 20 28 skAllZero(M) (
1f770 4d 29 3d 3d 30 0a 23 20 64 65 66 69 6e 65 20 44 M)==0.# define D
1f780 62 4d 61 73 6b 4e 6f 6e 5a 65 72 6f 28 4d 29 20 bMaskNonZero(M)
1f790 20 20 28 4d 29 21 3d 30 0a 23 65 6e 64 69 66 0a (M)!=0.#endif.
1f7a0 0a 2f 2a 0a 2a 2a 20 41 6e 20 53 51 4c 20 70 61 ./*.** An SQL pa
1f7b0 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 20 41 rser context. A
1f7c0 20 63 6f 70 79 20 6f 66 20 74 68 69 73 20 73 74 copy of this st
1f7d0 72 75 63 74 75 72 65 20 69 73 20 70 61 73 73 65 ructure is passe
1f7e0 64 20 74 68 72 6f 75 67 68 0a 2a 2a 20 74 68 65 d through.** the
1f7f0 20 70 61 72 73 65 72 20 61 6e 64 20 64 6f 77 6e parser and down
1f800 20 69 6e 74 6f 20 61 6c 6c 20 74 68 65 20 70 61 into all the pa
1f810 72 73 65 72 20 61 63 74 69 6f 6e 20 72 6f 75 74 rser action rout
1f820 69 6e 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 0a ine in order to.
1f830 2a 2a 20 63 61 72 72 79 20 61 72 6f 75 6e 64 20 ** carry around
1f840 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 information that
1f850 20 69 73 20 67 6c 6f 62 61 6c 20 74 6f 20 74 68 is global to th
1f860 65 20 65 6e 74 69 72 65 20 70 61 72 73 65 2e 0a e entire parse..
1f870 2a 2a 0a 2a 2a 20 54 68 65 20 73 74 72 75 63 74 **.** The struct
1f880 75 72 65 20 69 73 20 64 69 76 69 64 65 64 20 69 ure is divided i
1f890 6e 74 6f 20 74 77 6f 20 70 61 72 74 73 2e 20 20 nto two parts.
1f8a0 57 68 65 6e 20 74 68 65 20 70 61 72 73 65 72 20 When the parser
1f8b0 61 6e 64 20 63 6f 64 65 0a 2a 2a 20 67 65 6e 65 and code.** gene
1f8c0 72 61 74 65 20 63 61 6c 6c 20 74 68 65 6d 73 65 rate call themse
1f8d0 6c 76 65 73 20 72 65 63 75 72 73 69 76 65 6c 79 lves recursively
1f8e0 2c 20 74 68 65 20 66 69 72 73 74 20 70 61 72 74 , the first part
1f8f0 20 6f 66 20 74 68 65 20 73 74 72 75 63 74 75 72 of the structur
1f900 65 0a 2a 2a 20 69 73 20 63 6f 6e 73 74 61 6e 74 e.** is constant
1f910 20 62 75 74 20 74 68 65 20 73 65 63 6f 6e 64 20 but the second
1f920 70 61 72 74 20 69 73 20 72 65 73 65 74 20 61 74 part is reset at
1f930 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 61 the beginning a
1f940 6e 64 20 65 6e 64 20 6f 66 0a 2a 2a 20 65 61 63 nd end of.** eac
1f950 68 20 72 65 63 75 72 73 69 6f 6e 2e 0a 2a 2a 0a h recursion..**.
1f960 2a 2a 20 54 68 65 20 6e 54 61 62 6c 65 4c 6f 63 ** The nTableLoc
1f970 6b 20 61 6e 64 20 61 54 61 62 6c 65 4c 6f 63 6b k and aTableLock
1f980 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 6f variables are o
1f990 6e 6c 79 20 75 73 65 64 20 69 66 20 74 68 65 20 nly used if the
1f9a0 73 68 61 72 65 64 2d 63 61 63 68 65 0a 2a 2a 20 shared-cache.**
1f9b0 66 65 61 74 75 72 65 20 69 73 20 65 6e 61 62 6c feature is enabl
1f9c0 65 64 20 28 69 66 20 73 71 6c 69 74 65 33 54 73 ed (if sqlite3Ts
1f9d0 64 28 29 2d 3e 75 73 65 53 68 61 72 65 64 44 61 d()->useSharedDa
1f9e0 74 61 20 69 73 20 74 72 75 65 29 2e 20 54 68 65 ta is true). The
1f9f0 79 20 61 72 65 0a 2a 2a 20 75 73 65 64 20 74 6f y are.** used to
1fa00 20 73 74 6f 72 65 20 74 68 65 20 73 65 74 20 6f store the set o
1fa10 66 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 20 72 65 f table-locks re
1fa20 71 75 69 72 65 64 20 62 79 20 74 68 65 20 73 74 quired by the st
1fa30 61 74 65 6d 65 6e 74 20 62 65 69 6e 67 0a 2a 2a atement being.**
1fa40 20 63 6f 6d 70 69 6c 65 64 2e 20 46 75 6e 63 74 compiled. Funct
1fa50 69 6f 6e 20 73 71 6c 69 74 65 33 54 61 62 6c 65 ion sqlite3Table
1fa60 4c 6f 63 6b 28 29 20 69 73 20 75 73 65 64 20 74 Lock() is used t
1fa70 6f 20 61 64 64 20 65 6e 74 72 69 65 73 20 74 6f o add entries to
1fa80 20 74 68 65 0a 2a 2a 20 6c 69 73 74 2e 0a 2a 2f the.** list..*/
1fa90 0a 73 74 72 75 63 74 20 50 61 72 73 65 20 7b 0a .struct Parse {.
1faa0 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 sqlite3 *db;
1fab0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d 61 /* The ma
1fac0 69 6e 20 64 61 74 61 62 61 73 65 20 73 74 72 75 in database stru
1fad0 63 74 75 72 65 20 2a 2f 0a 20 20 63 68 61 72 20 cture */. char
1fae0 2a 7a 45 72 72 4d 73 67 3b 20 20 20 20 20 20 20 *zErrMsg;
1faf0 2f 2a 20 41 6e 20 65 72 72 6f 72 20 6d 65 73 73 /* An error mess
1fb00 61 67 65 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 age */. Vdbe *p
1fb10 56 64 62 65 3b 20 20 20 20 20 20 20 20 20 2f 2a Vdbe; /*
1fb20 20 41 6e 20 65 6e 67 69 6e 65 20 66 6f 72 20 65 An engine for e
1fb30 78 65 63 75 74 69 6e 67 20 64 61 74 61 62 61 73 xecuting databas
1fb40 65 20 62 79 74 65 63 6f 64 65 20 2a 2f 0a 20 20 e bytecode */.
1fb50 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 int rc;
1fb60 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
1fb70 6f 64 65 20 66 72 6f 6d 20 65 78 65 63 75 74 69 ode from executi
1fb80 6f 6e 20 2a 2f 0a 20 20 75 38 20 63 6f 6c 4e 61 on */. u8 colNa
1fb90 6d 65 73 53 65 74 3b 20 20 20 20 20 20 2f 2a 20 mesSet; /*
1fba0 54 52 55 45 20 61 66 74 65 72 20 4f 50 5f 43 6f TRUE after OP_Co
1fbb0 6c 75 6d 6e 4e 61 6d 65 20 68 61 73 20 62 65 65 lumnName has bee
1fbc0 6e 20 69 73 73 75 65 64 20 74 6f 20 70 56 64 62 n issued to pVdb
1fbd0 65 20 2a 2f 0a 20 20 75 38 20 63 68 65 63 6b 53 e */. u8 checkS
1fbe0 63 68 65 6d 61 3b 20 20 20 20 20 20 2f 2a 20 43 chema; /* C
1fbf0 61 75 73 65 73 20 73 63 68 65 6d 61 20 63 6f 6f auses schema coo
1fc00 6b 69 65 20 63 68 65 63 6b 20 61 66 74 65 72 20 kie check after
1fc10 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 75 38 an error */. u8
1fc20 20 6e 65 73 74 65 64 3b 20 20 20 20 20 20 20 20 nested;
1fc30 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
1fc40 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f 20 nested calls to
1fc50 74 68 65 20 70 61 72 73 65 72 2f 63 6f 64 65 20 the parser/code
1fc60 67 65 6e 65 72 61 74 6f 72 20 2a 2f 0a 20 20 75 generator */. u
1fc70 38 20 6e 54 65 6d 70 52 65 67 3b 20 20 20 20 20 8 nTempReg;
1fc80 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1fc90 20 74 65 6d 70 6f 72 61 72 79 20 72 65 67 69 73 temporary regis
1fca0 74 65 72 73 20 69 6e 20 61 54 65 6d 70 52 65 67 ters in aTempReg
1fcb0 5b 5d 20 2a 2f 0a 20 20 75 38 20 69 73 4d 75 6c [] */. u8 isMul
1fcc0 74 69 57 72 69 74 65 3b 20 20 20 20 20 2f 2a 20 tiWrite; /*
1fcd0 54 72 75 65 20 69 66 20 73 74 61 74 65 6d 65 6e True if statemen
1fce0 74 20 6d 61 79 20 6d 6f 64 69 66 79 2f 69 6e 73 t may modify/ins
1fcf0 65 72 74 20 6d 75 6c 74 69 70 6c 65 20 72 6f 77 ert multiple row
1fd00 73 20 2a 2f 0a 20 20 75 38 20 6d 61 79 41 62 6f s */. u8 mayAbo
1fd10 72 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 rt; /* T
1fd20 72 75 65 20 69 66 20 73 74 61 74 65 6d 65 6e 74 rue if statement
1fd30 20 6d 61 79 20 74 68 72 6f 77 20 61 6e 20 41 42 may throw an AB
1fd40 4f 52 54 20 65 78 63 65 70 74 69 6f 6e 20 2a 2f ORT exception */
1fd50 0a 20 20 75 38 20 68 61 73 43 6f 6d 70 6f 75 6e . u8 hasCompoun
1fd60 64 3b 20 20 20 20 20 20 2f 2a 20 4e 65 65 64 20 d; /* Need
1fd70 74 6f 20 69 6e 76 6f 6b 65 20 63 6f 6e 76 65 72 to invoke conver
1fd80 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 74 54 tCompoundSelectT
1fd90 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f 0a 20 oSubquery() */.
1fda0 20 75 38 20 6f 6b 43 6f 6e 73 74 46 61 63 74 6f u8 okConstFacto
1fdb0 72 3b 20 20 20 20 2f 2a 20 4f 4b 20 74 6f 20 66 r; /* OK to f
1fdc0 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e 73 74 61 actor out consta
1fdd0 6e 74 73 20 2a 2f 0a 20 20 75 38 20 64 69 73 61 nts */. u8 disa
1fde0 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b 20 2f 2a bleLookaside; /*
1fdf0 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 Number of times
1fe00 20 6c 6f 6f 6b 61 73 69 64 65 20 68 61 73 20 62 lookaside has b
1fe10 65 65 6e 20 64 69 73 61 62 6c 65 64 20 2a 2f 0a een disabled */.
1fe20 20 20 75 38 20 6e 43 6f 6c 43 61 63 68 65 3b 20 u8 nColCache;
1fe30 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1fe40 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 of entries in a
1fe50 43 6f 6c 43 61 63 68 65 5b 5d 20 2a 2f 0a 20 20 ColCache[] */.
1fe60 69 6e 74 20 6e 52 61 6e 67 65 52 65 67 3b 20 20 int nRangeReg;
1fe70 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
1fe80 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 72 65 the temporary re
1fe90 67 69 73 74 65 72 20 62 6c 6f 63 6b 20 2a 2f 0a gister block */.
1fea0 20 20 69 6e 74 20 69 52 61 6e 67 65 52 65 67 3b int iRangeReg;
1feb0 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 /* First
1fec0 72 65 67 69 73 74 65 72 20 69 6e 20 74 65 6d 70 register in temp
1fed0 6f 72 61 72 79 20 72 65 67 69 73 74 65 72 20 62 orary register b
1fee0 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 lock */. int nE
1fef0 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f rr; /
1ff00 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 72 72 6f * Number of erro
1ff10 72 73 20 73 65 65 6e 20 2a 2f 0a 20 20 69 6e 74 rs seen */. int
1ff20 20 6e 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 nTab;
1ff30 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
1ff40 72 65 76 69 6f 75 73 6c 79 20 61 6c 6c 6f 63 61 reviously alloca
1ff50 74 65 64 20 56 44 42 45 20 63 75 72 73 6f 72 73 ted VDBE cursors
1ff60 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 3b 20 */. int nMem;
1ff70 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
1ff80 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20 63 mber of memory c
1ff90 65 6c 6c 73 20 75 73 65 64 20 73 6f 20 66 61 72 ells used so far
1ffa0 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 70 41 6c 6c */. int nOpAll
1ffb0 6f 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 oc; /* Nu
1ffc0 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 61 6c mber of slots al
1ffd0 6c 6f 63 61 74 65 64 20 66 6f 72 20 56 64 62 65 located for Vdbe
1ffe0 2e 61 4f 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 .aOp[] */. int
1fff0 73 7a 4f 70 41 6c 6c 6f 63 3b 20 20 20 20 20 20 szOpAlloc;
20000 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 6d /* Bytes of mem
20010 6f 72 79 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 ory space alloca
20020 74 65 64 20 66 6f 72 20 56 64 62 65 2e 61 4f 70 ted for Vdbe.aOp
20030 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 53 65 6c [] */. int iSel
20040 66 54 61 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 fTab; /*
20050 54 61 62 6c 65 20 61 73 73 6f 63 69 61 74 65 64 Table associated
20060 20 77 69 74 68 20 61 6e 20 69 6e 64 65 78 20 6f with an index o
20070 6e 20 65 78 70 72 2c 20 6f 72 20 6e 65 67 61 74 n expr, or negat
20080 69 76 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 ive.
20090 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 6f 66 ** of
200a0 20 74 68 65 20 62 61 73 65 20 72 65 67 69 73 74 the base regist
200b0 65 72 20 64 75 72 69 6e 67 20 63 68 65 63 6b 2d er during check-
200c0 63 6f 6e 73 74 72 61 69 6e 74 20 65 76 61 6c 20 constraint eval
200d0 2a 2f 0a 20 20 69 6e 74 20 69 43 61 63 68 65 4c */. int iCacheL
200e0 65 76 65 6c 3b 20 20 20 20 20 2f 2a 20 43 6f 6c evel; /* Col
200f0 43 61 63 68 65 20 76 61 6c 69 64 20 77 68 65 6e Cache valid when
20100 20 61 43 6f 6c 43 61 63 68 65 5b 5d 2e 69 4c 65 aColCache[].iLe
20110 76 65 6c 3c 3d 69 43 61 63 68 65 4c 65 76 65 6c vel<=iCacheLevel
20120 20 2a 2f 0a 20 20 69 6e 74 20 69 43 61 63 68 65 */. int iCache
20130 43 6e 74 3b 20 20 20 20 20 20 20 2f 2a 20 43 6f Cnt; /* Co
20140 75 6e 74 65 72 20 75 73 65 64 20 74 6f 20 67 65 unter used to ge
20150 6e 65 72 61 74 65 20 61 43 6f 6c 43 61 63 68 65 nerate aColCache
20160 5b 5d 2e 6c 72 75 20 76 61 6c 75 65 73 20 2a 2f [].lru values */
20170 0a 20 20 69 6e 74 20 6e 4c 61 62 65 6c 3b 20 20 . int nLabel;
20180 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
20190 72 20 6f 66 20 6c 61 62 65 6c 73 20 75 73 65 64 r of labels used
201a0 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 4c 61 62 65 */. int *aLabe
201b0 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 l; /* Sp
201c0 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 ace to hold the
201d0 6c 61 62 65 6c 73 20 2a 2f 0a 20 20 45 78 70 72 labels */. Expr
201e0 4c 69 73 74 20 2a 70 43 6f 6e 73 74 45 78 70 72 List *pConstExpr
201f0 3b 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 65 78 70 ;/* Constant exp
20200 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 54 6f ressions */. To
20210 6b 65 6e 20 63 6f 6e 73 74 72 61 69 6e 74 4e 61 ken constraintNa
20220 6d 65 3b 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 me;/* Name of th
20230 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 75 72 e constraint cur
20240 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 70 61 72 rently being par
20250 73 65 64 20 2a 2f 0a 20 20 79 44 62 4d 61 73 6b sed */. yDbMask
20260 20 77 72 69 74 65 4d 61 73 6b 3b 20 20 20 2f 2a writeMask; /*
20270 20 53 74 61 72 74 20 61 20 77 72 69 74 65 20 74 Start a write t
20280 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 68 ransaction on th
20290 65 73 65 20 64 61 74 61 62 61 73 65 73 20 2a 2f ese databases */
202a0 0a 20 20 79 44 62 4d 61 73 6b 20 63 6f 6f 6b 69 . yDbMask cooki
202b0 65 4d 61 73 6b 3b 20 20 2f 2a 20 42 69 74 6d 61 eMask; /* Bitma
202c0 73 6b 20 6f 66 20 73 63 68 65 6d 61 20 76 65 72 sk of schema ver
202d0 69 66 69 65 64 20 64 61 74 61 62 61 73 65 73 20 ified databases
202e0 2a 2f 0a 20 20 69 6e 74 20 72 65 67 52 6f 77 69 */. int regRowi
202f0 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 52 65 67 d; /* Reg
20300 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 6f ister holding ro
20310 77 69 64 20 6f 66 20 43 52 45 41 54 45 20 54 41 wid of CREATE TA
20320 42 4c 45 20 65 6e 74 72 79 20 2a 2f 0a 20 20 69 BLE entry */. i
20330 6e 74 20 72 65 67 52 6f 6f 74 3b 20 20 20 20 20 nt regRoot;
20340 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 /* Register
20350 68 6f 6c 64 69 6e 67 20 72 6f 6f 74 20 70 61 67 holding root pag
20360 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 6e 65 77 e number for new
20370 20 6f 62 6a 65 63 74 73 20 2a 2f 0a 20 20 69 6e objects */. in
20380 74 20 6e 4d 61 78 41 72 67 3b 20 20 20 20 20 20 t nMaxArg;
20390 20 20 20 2f 2a 20 4d 61 78 20 61 72 67 73 20 70 /* Max args p
203a0 61 73 73 65 64 20 74 6f 20 75 73 65 72 20 66 75 assed to user fu
203b0 6e 63 74 69 6f 6e 20 62 79 20 73 75 62 2d 70 72 nction by sub-pr
203c0 6f 67 72 61 6d 20 2a 2f 0a 23 69 66 20 53 45 4c ogram */.#if SEL
203d0 45 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 ECTTRACE_ENABLED
203e0 0a 20 20 69 6e 74 20 6e 53 65 6c 65 63 74 3b 20 . int nSelect;
203f0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
20400 72 20 6f 66 20 53 45 4c 45 43 54 20 73 74 61 74 r of SELECT stat
20410 65 6d 65 6e 74 73 20 73 65 65 6e 20 2a 2f 0a 23 ements seen */.#
20420 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 endif.#ifndef SQ
20430 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 LITE_OMIT_SHARED
20440 5f 43 41 43 48 45 0a 20 20 69 6e 74 20 6e 54 61 _CACHE. int nTa
20450 62 6c 65 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 bleLock;
20460 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 6f 63 /* Number of loc
20470 6b 73 20 69 6e 20 61 54 61 62 6c 65 4c 6f 63 6b ks in aTableLock
20480 20 2a 2f 0a 20 20 54 61 62 6c 65 4c 6f 63 6b 20 */. TableLock
20490 2a 61 54 61 62 6c 65 4c 6f 63 6b 3b 20 2f 2a 20 *aTableLock; /*
204a0 52 65 71 75 69 72 65 64 20 74 61 62 6c 65 20 6c Required table l
204b0 6f 63 6b 73 20 66 6f 72 20 73 68 61 72 65 64 2d ocks for shared-
204c0 63 61 63 68 65 20 6d 6f 64 65 20 2a 2f 0a 23 65 cache mode */.#e
204d0 6e 64 69 66 0a 20 20 41 75 74 6f 69 6e 63 49 6e ndif. AutoincIn
204e0 66 6f 20 2a 70 41 69 6e 63 3b 20 20 2f 2a 20 49 fo *pAinc; /* I
204f0 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 nformation about
20500 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 20 63 AUTOINCREMENT c
20510 6f 75 6e 74 65 72 73 20 2a 2f 0a 20 20 50 61 72 ounters */. Par
20520 73 65 20 2a 70 54 6f 70 6c 65 76 65 6c 3b 20 20 se *pToplevel;
20530 20 20 2f 2a 20 50 61 72 73 65 20 73 74 72 75 63 /* Parse struc
20540 74 75 72 65 20 66 6f 72 20 6d 61 69 6e 20 70 72 ture for main pr
20550 6f 67 72 61 6d 20 28 6f 72 20 4e 55 4c 4c 29 20 ogram (or NULL)
20560 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 72 69 */. Table *pTri
20570 67 67 65 72 54 61 62 3b 20 20 2f 2a 20 54 61 62 ggerTab; /* Tab
20580 6c 65 20 74 72 69 67 67 65 72 73 20 61 72 65 20 le triggers are
20590 62 65 69 6e 67 20 63 6f 64 65 64 20 66 6f 72 20 being coded for
205a0 2a 2f 0a 20 20 69 6e 74 20 61 64 64 72 43 72 54 */. int addrCrT
205b0 61 62 3b 20 20 20 20 20 20 20 2f 2a 20 41 64 64 ab; /* Add
205c0 72 65 73 73 20 6f 66 20 4f 50 5f 43 72 65 61 74 ress of OP_Creat
205d0 65 42 74 72 65 65 20 6f 70 63 6f 64 65 20 6f 6e eBtree opcode on
205e0 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 2a 2f CREATE TABLE */
205f0 0a 20 20 75 33 32 20 6e 51 75 65 72 79 4c 6f 6f . u32 nQueryLoo
20600 70 3b 20 20 20 20 20 20 2f 2a 20 45 73 74 20 6e p; /* Est n
20610 75 6d 62 65 72 20 6f 66 20 69 74 65 72 61 74 69 umber of iterati
20620 6f 6e 73 20 6f 66 20 61 20 71 75 65 72 79 20 28 ons of a query (
20630 31 30 2a 6c 6f 67 32 28 4e 29 29 20 2a 2f 0a 20 10*log2(N)) */.
20640 20 75 33 32 20 6f 6c 64 6d 61 73 6b 3b 20 20 20 u32 oldmask;
20650 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 /* Mask of
20660 20 6f 6c 64 2e 2a 20 63 6f 6c 75 6d 6e 73 20 72 old.* columns r
20670 65 66 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 75 eferenced */. u
20680 33 32 20 6e 65 77 6d 61 73 6b 3b 20 20 20 20 20 32 newmask;
20690 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 6e /* Mask of n
206a0 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 72 65 66 ew.* columns ref
206b0 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 75 38 20 erenced */. u8
206c0 65 54 72 69 67 67 65 72 4f 70 3b 20 20 20 20 20 eTriggerOp;
206d0 20 20 2f 2a 20 54 4b 5f 55 50 44 41 54 45 2c 20 /* TK_UPDATE,
206e0 54 4b 5f 49 4e 53 45 52 54 20 6f 72 20 54 4b 5f TK_INSERT or TK_
206f0 44 45 4c 45 54 45 20 2a 2f 0a 20 20 75 38 20 65 DELETE */. u8 e
20700 4f 72 63 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 Orconf;
20710 20 2f 2a 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 /* Default ON C
20720 4f 4e 46 4c 49 43 54 20 70 6f 6c 69 63 79 20 66 ONFLICT policy f
20730 6f 72 20 74 72 69 67 67 65 72 20 73 74 65 70 73 or trigger steps
20740 20 2a 2f 0a 20 20 75 38 20 64 69 73 61 62 6c 65 */. u8 disable
20750 54 72 69 67 67 65 72 73 3b 20 20 2f 2a 20 54 72 Triggers; /* Tr
20760 75 65 20 74 6f 20 64 69 73 61 62 6c 65 20 74 72 ue to disable tr
20770 69 67 67 65 72 73 20 2a 2f 0a 0a 20 20 2f 2a 2a iggers */.. /**
20780 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20790 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
207a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
207b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
207c0 2a 2a 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2a 20 46 69 ********. ** Fi
207d0 65 6c 64 73 20 61 62 6f 76 65 20 6d 75 73 74 20 elds above must
207e0 62 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 be initialized t
207f0 6f 20 7a 65 72 6f 2e 20 20 54 68 65 20 66 69 65 o zero. The fie
20800 6c 64 73 20 74 68 61 74 20 66 6f 6c 6c 6f 77 2c lds that follow,
20810 0a 20 20 2a 2a 20 64 6f 77 6e 20 74 6f 20 74 68 . ** down to th
20820 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74 e beginning of t
20830 68 65 20 72 65 63 75 72 73 69 76 65 20 73 65 63 he recursive sec
20840 74 69 6f 6e 2c 20 64 6f 20 6e 6f 74 20 6e 65 65 tion, do not nee
20850 64 20 74 6f 20 62 65 0a 20 20 2a 2a 20 69 6e 69 d to be. ** ini
20860 74 69 61 6c 69 7a 65 64 20 61 73 20 74 68 65 79 tialized as they
20870 20 77 69 6c 6c 20 62 65 20 73 65 74 20 62 65 66 will be set bef
20880 6f 72 65 20 62 65 69 6e 67 20 75 73 65 64 2e 20 ore being used.
20890 20 54 68 65 20 62 6f 75 6e 64 61 72 79 20 69 73 The boundary is
208a0 0a 20 20 2a 2a 20 64 65 74 65 72 6d 69 6e 65 64 . ** determined
208b0 20 62 79 20 6f 66 66 73 65 74 6f 66 28 50 61 72 by offsetof(Par
208c0 73 65 2c 61 43 6f 6c 43 61 63 68 65 29 2e 0a 20 se,aColCache)..
208d0 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***************
208e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
208f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20900 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20910 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 ***********/..
20920 73 74 72 75 63 74 20 79 43 6f 6c 43 61 63 68 65 struct yColCache
20930 20 7b 0a 20 20 20 20 69 6e 74 20 69 54 61 62 6c {. int iTabl
20940 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 e; /*
20950 54 61 62 6c 65 20 63 75 72 73 6f 72 20 6e 75 6d Table cursor num
20960 62 65 72 20 2a 2f 0a 20 20 20 20 69 31 36 20 69 ber */. i16 i
20970 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 Column;
20980 20 2f 2a 20 54 61 62 6c 65 20 63 6f 6c 75 6d 6e /* Table column
20990 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 20 20 75 number */. u
209a0 38 20 74 65 6d 70 52 65 67 3b 20 20 20 20 20 20 8 tempReg;
209b0 20 20 20 20 20 2f 2a 20 69 52 65 67 20 69 73 20 /* iReg is
209c0 61 20 74 65 6d 70 20 72 65 67 69 73 74 65 72 20 a temp register
209d0 74 68 61 74 20 6e 65 65 64 73 20 74 6f 20 62 65 that needs to be
209e0 20 66 72 65 65 64 20 2a 2f 0a 20 20 20 20 69 6e freed */. in
209f0 74 20 69 4c 65 76 65 6c 3b 20 20 20 20 20 20 20 t iLevel;
20a00 20 20 20 20 2f 2a 20 4e 65 73 74 69 6e 67 20 6c /* Nesting l
20a10 65 76 65 6c 20 2a 2f 0a 20 20 20 20 69 6e 74 20 evel */. int
20a20 69 52 65 67 3b 20 20 20 20 20 20 20 20 20 20 20 iReg;
20a30 20 20 2f 2a 20 52 65 67 20 77 69 74 68 20 76 61 /* Reg with va
20a40 6c 75 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 lue of this colu
20a50 6d 6e 2e 20 30 20 6d 65 61 6e 73 20 6e 6f 6e 65 mn. 0 means none
20a60 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6c 72 75 . */. int lru
20a70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
20a80 2a 20 4c 65 61 73 74 20 72 65 63 65 6e 74 6c 79 * Least recently
20a90 20 75 73 65 64 20 65 6e 74 72 79 20 68 61 73 20 used entry has
20aa0 74 68 65 20 73 6d 61 6c 6c 65 73 74 20 76 61 6c the smallest val
20ab0 75 65 20 2a 2f 0a 20 20 7d 20 61 43 6f 6c 43 61 ue */. } aColCa
20ac0 63 68 65 5b 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c che[SQLITE_N_COL
20ad0 43 41 43 48 45 5d 3b 20 20 2f 2a 20 4f 6e 65 20 CACHE]; /* One
20ae0 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 for each column
20af0 63 61 63 68 65 20 65 6e 74 72 79 20 2a 2f 0a 20 cache entry */.
20b00 20 69 6e 74 20 61 54 65 6d 70 52 65 67 5b 38 5d int aTempReg[8]
20b10 3b 20 20 20 20 20 20 20 20 2f 2a 20 48 6f 6c 64 ; /* Hold
20b20 69 6e 67 20 61 72 65 61 20 66 6f 72 20 74 65 6d ing area for tem
20b30 70 6f 72 61 72 79 20 72 65 67 69 73 74 65 72 73 porary registers
20b40 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 73 4e 61 6d */. Token sNam
20b50 65 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 2f 2a eToken; /*
20b60 20 54 6f 6b 65 6e 20 77 69 74 68 20 75 6e 71 75 Token with unqu
20b70 61 6c 69 66 69 65 64 20 73 63 68 65 6d 61 20 6f alified schema o
20b80 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 0a 20 bject name */..
20b90 20 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a /**************
20ba0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20bb0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20bc0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20bd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2a 20 **********. **
20be0 41 62 6f 76 65 20 69 73 20 63 6f 6e 73 74 61 6e Above is constan
20bf0 74 20 62 65 74 77 65 65 6e 20 72 65 63 75 72 73 t between recurs
20c00 69 6f 6e 73 2e 20 20 42 65 6c 6f 77 20 69 73 20 ions. Below is
20c10 72 65 73 65 74 20 62 65 66 6f 72 65 20 61 6e 64 reset before and
20c20 20 61 66 74 65 72 0a 20 20 2a 2a 20 65 61 63 68 after. ** each
20c30 20 72 65 63 75 72 73 69 6f 6e 2e 20 20 54 68 65 recursion. The
20c40 20 62 6f 75 6e 64 61 72 79 20 62 65 74 77 65 65 boundary betwee
20c50 6e 20 74 68 65 73 65 20 74 77 6f 20 72 65 67 69 n these two regi
20c60 6f 6e 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 ons is determine
20c70 64 0a 20 20 2a 2a 20 75 73 69 6e 67 20 6f 66 66 d. ** using off
20c80 73 65 74 6f 66 28 50 61 72 73 65 2c 73 4c 61 73 setof(Parse,sLas
20c90 74 54 6f 6b 65 6e 29 20 73 6f 20 74 68 65 20 73 tToken) so the s
20ca0 4c 61 73 74 54 6f 6b 65 6e 20 66 69 65 6c 64 20 LastToken field
20cb0 6d 75 73 74 20 62 65 20 74 68 65 0a 20 20 2a 2a must be the. **
20cc0 20 66 69 72 73 74 20 66 69 65 6c 64 20 69 6e 20 first field in
20cd0 74 68 65 20 72 65 63 75 72 73 69 76 65 20 72 65 the recursive re
20ce0 67 69 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a gion.. ********
20cf0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20d00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20d10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20d20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
20d30 2f 0a 0a 20 20 54 6f 6b 65 6e 20 73 4c 61 73 74 /.. Token sLast
20d40 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 2f 2a 20 Token; /*
20d50 54 68 65 20 6c 61 73 74 20 74 6f 6b 65 6e 20 70 The last token p
20d60 61 72 73 65 64 20 2a 2f 0a 20 20 79 6e 56 61 72 arsed */. ynVar
20d70 20 6e 56 61 72 3b 20 20 20 20 20 20 20 20 20 20 nVar;
20d80 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
20d90 66 20 27 3f 27 20 76 61 72 69 61 62 6c 65 73 20 f '?' variables
20da0 73 65 65 6e 20 69 6e 20 74 68 65 20 53 51 4c 20 seen in the SQL
20db0 73 6f 20 66 61 72 20 2a 2f 0a 20 20 75 38 20 69 so far */. u8 i
20dc0 50 6b 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 PkSortOrder;
20dd0 20 20 20 20 20 20 2f 2a 20 41 53 43 20 6f 72 20 /* ASC or
20de0 44 45 53 43 20 66 6f 72 20 49 4e 54 45 47 45 52 DESC for INTEGER
20df0 20 50 52 49 4d 41 52 59 20 4b 45 59 20 2a 2f 0a PRIMARY KEY */.
20e00 20 20 75 38 20 65 78 70 6c 61 69 6e 3b 20 20 20 u8 explain;
20e10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
20e20 72 75 65 20 69 66 20 74 68 65 20 45 58 50 4c 41 rue if the EXPLA
20e30 49 4e 20 66 6c 61 67 20 69 73 20 66 6f 75 6e 64 IN flag is found
20e40 20 6f 6e 20 74 68 65 20 71 75 65 72 79 20 2a 2f on the query */
20e50 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
20e60 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
20e70 45 0a 20 20 75 38 20 64 65 63 6c 61 72 65 56 74 E. u8 declareVt
20e80 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ab; /*
20e90 20 54 72 75 65 20 69 66 20 69 6e 73 69 64 65 20 True if inside
20ea0 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f sqlite3_declare_
20eb0 76 74 61 62 28 29 20 2a 2f 0a 20 20 69 6e 74 20 vtab() */. int
20ec0 6e 56 74 61 62 4c 6f 63 6b 3b 20 20 20 20 20 20 nVtabLock;
20ed0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
20ee0 6f 66 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 of virtual table
20ef0 73 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 23 65 6e s to lock */.#en
20f00 64 69 66 0a 20 20 69 6e 74 20 6e 48 65 69 67 68 dif. int nHeigh
20f10 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
20f20 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 74 72 /* Expression tr
20f30 65 65 20 68 65 69 67 68 74 20 6f 66 20 63 75 72 ee height of cur
20f40 72 65 6e 74 20 73 75 62 2d 73 65 6c 65 63 74 20 rent sub-select
20f50 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
20f60 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 E_OMIT_EXPLAIN.
20f70 20 69 6e 74 20 61 64 64 72 45 78 70 6c 61 69 6e int addrExplain
20f80 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 ; /* Ad
20f90 64 72 65 73 73 20 6f 66 20 63 75 72 72 65 6e 74 dress of current
20fa0 20 4f 50 5f 45 78 70 6c 61 69 6e 20 6f 70 63 6f OP_Explain opco
20fb0 64 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 56 de */.#endif. V
20fc0 4c 69 73 74 20 2a 70 56 4c 69 73 74 3b 20 20 20 List *pVList;
20fd0 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 70 70 /* Mapp
20fe0 69 6e 67 20 62 65 74 77 65 65 6e 20 76 61 72 69 ing between vari
20ff0 61 62 6c 65 20 6e 61 6d 65 73 20 61 6e 64 20 6e able names and n
21000 75 6d 62 65 72 73 20 2a 2f 0a 20 20 56 64 62 65 umbers */. Vdbe
21010 20 2a 70 52 65 70 72 65 70 61 72 65 3b 20 20 20 *pReprepare;
21020 20 20 20 20 20 20 2f 2a 20 56 4d 20 62 65 69 6e /* VM bein
21030 67 20 72 65 70 72 65 70 61 72 65 64 20 28 73 71 g reprepared (sq
21040 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 28 29 lite3Reprepare()
21050 29 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 ) */. const cha
21060 72 20 2a 7a 54 61 69 6c 3b 20 20 20 20 20 20 20 r *zTail;
21070 20 2f 2a 20 41 6c 6c 20 53 51 4c 20 74 65 78 74 /* All SQL text
21080 20 70 61 73 74 20 74 68 65 20 6c 61 73 74 20 73 past the last s
21090 65 6d 69 63 6f 6c 6f 6e 20 70 61 72 73 65 64 20 emicolon parsed
210a0 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 4e 65 77 */. Table *pNew
210b0 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 2f Table; /
210c0 2a 20 41 20 74 61 62 6c 65 20 62 65 69 6e 67 20 * A table being
210d0 63 6f 6e 73 74 72 75 63 74 65 64 20 62 79 20 43 constructed by C
210e0 52 45 41 54 45 20 54 41 42 4c 45 20 2a 2f 0a 20 REATE TABLE */.
210f0 20 54 72 69 67 67 65 72 20 2a 70 4e 65 77 54 72 Trigger *pNewTr
21100 69 67 67 65 72 3b 20 20 20 20 20 2f 2a 20 54 72 igger; /* Tr
21110 69 67 67 65 72 20 75 6e 64 65 72 20 63 6f 6e 73 igger under cons
21120 74 72 75 63 74 20 62 79 20 61 20 43 52 45 41 54 truct by a CREAT
21130 45 20 54 52 49 47 47 45 52 20 2a 2f 0a 20 20 63 E TRIGGER */. c
21140 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 75 74 68 onst char *zAuth
21150 43 6f 6e 74 65 78 74 3b 20 2f 2a 20 54 68 65 20 Context; /* The
21160 36 74 68 20 70 61 72 61 6d 65 74 65 72 20 74 6f 6th parameter to
21170 20 64 62 2d 3e 78 41 75 74 68 20 63 61 6c 6c 62 db->xAuth callb
21180 61 63 6b 73 20 2a 2f 0a 23 69 66 6e 64 65 66 20 acks */.#ifndef
21190 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
211a0 55 41 4c 54 41 42 4c 45 0a 20 20 54 6f 6b 65 6e UALTABLE. Token
211b0 20 73 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 sArg;
211c0 20 20 20 20 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 /* Complete
211d0 20 74 65 78 74 20 6f 66 20 61 20 6d 6f 64 75 6c text of a modul
211e0 65 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 20 20 e argument */.
211f0 54 61 62 6c 65 20 2a 2a 61 70 56 74 61 62 4c 6f Table **apVtabLo
21200 63 6b 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 ck; /* Poi
21210 6e 74 65 72 20 74 6f 20 76 69 72 74 75 61 6c 20 nter to virtual
21220 74 61 62 6c 65 73 20 6e 65 65 64 69 6e 67 20 6c tables needing l
21230 6f 63 6b 69 6e 67 20 2a 2f 0a 23 65 6e 64 69 66 ocking */.#endif
21240 0a 20 20 54 61 62 6c 65 20 2a 70 5a 6f 6d 62 69 . Table *pZombi
21250 65 54 61 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 eTab; /*
21260 4c 69 73 74 20 6f 66 20 54 61 62 6c 65 20 6f 62 List of Table ob
21270 6a 65 63 74 73 20 74 6f 20 64 65 6c 65 74 65 20 jects to delete
21280 61 66 74 65 72 20 63 6f 64 65 20 67 65 6e 20 2a after code gen *
21290 2f 0a 20 20 54 72 69 67 67 65 72 50 72 67 20 2a /. TriggerPrg *
212a0 70 54 72 69 67 67 65 72 50 72 67 3b 20 20 2f 2a pTriggerPrg; /*
212b0 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 Linked list of
212c0 63 6f 64 65 64 20 74 72 69 67 67 65 72 73 20 2a coded triggers *
212d0 2f 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 3b /. With *pWith;
212e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
212f0 20 43 75 72 72 65 6e 74 20 57 49 54 48 20 63 6c Current WITH cl
21300 61 75 73 65 2c 20 6f 72 20 4e 55 4c 4c 20 2a 2f ause, or NULL */
21310 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 54 6f . With *pWithTo
21320 46 72 65 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 Free; /*
21330 46 72 65 65 20 74 68 69 73 20 57 49 54 48 20 6f Free this WITH o
21340 62 6a 65 63 74 20 61 74 20 74 68 65 20 65 6e 64 bject at the end
21350 20 6f 66 20 74 68 65 20 70 61 72 73 65 20 2a 2f of the parse */
21360 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 69 7a 65 73 .};../*.** Sizes
21370 20 61 6e 64 20 70 6f 69 6e 74 65 72 73 20 6f 66 and pointers of
21380 20 76 61 72 69 6f 75 73 20 70 61 72 74 73 20 6f various parts o
21390 66 20 74 68 65 20 50 61 72 73 65 20 6f 62 6a 65 f the Parse obje
213a0 63 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 50 ct..*/.#define P
213b0 41 52 53 45 5f 48 44 52 5f 53 5a 20 6f 66 66 73 ARSE_HDR_SZ offs
213c0 65 74 6f 66 28 50 61 72 73 65 2c 61 43 6f 6c 43 etof(Parse,aColC
213d0 61 63 68 65 29 20 2f 2a 20 52 65 63 75 72 73 69 ache) /* Recursi
213e0 76 65 20 70 61 72 74 20 77 2f 6f 20 61 43 6f 6c ve part w/o aCol
213f0 43 61 63 68 65 2a 2f 0a 23 64 65 66 69 6e 65 20 Cache*/.#define
21400 50 41 52 53 45 5f 52 45 43 55 52 53 45 5f 53 5a PARSE_RECURSE_SZ
21410 20 6f 66 66 73 65 74 6f 66 28 50 61 72 73 65 2c offsetof(Parse,
21420 73 4c 61 73 74 54 6f 6b 65 6e 29 20 20 20 20 2f sLastToken) /
21430 2a 20 52 65 63 75 72 73 69 76 65 20 70 61 72 74 * Recursive part
21440 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 52 53 */.#define PARS
21450 45 5f 54 41 49 4c 5f 53 5a 20 28 73 69 7a 65 6f E_TAIL_SZ (sizeo
21460 66 28 50 61 72 73 65 29 2d 50 41 52 53 45 5f 52 f(Parse)-PARSE_R
21470 45 43 55 52 53 45 5f 53 5a 29 20 2f 2a 20 4e 6f ECURSE_SZ) /* No
21480 6e 2d 72 65 63 75 72 73 69 76 65 20 70 61 72 74 n-recursive part
21490 20 2a 2f 0a 23 64 65 66 69 6e 65 20 50 41 52 53 */.#define PARS
214a0 45 5f 54 41 49 4c 28 58 29 20 28 28 28 63 68 61 E_TAIL(X) (((cha
214b0 72 2a 29 28 58 29 29 2b 50 41 52 53 45 5f 52 45 r*)(X))+PARSE_RE
214c0 43 55 52 53 45 5f 53 5a 29 20 20 2f 2a 20 50 6f CURSE_SZ) /* Po
214d0 69 6e 74 65 72 20 74 6f 20 74 61 69 6c 20 2a 2f inter to tail */
214e0 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
214f0 72 75 65 20 69 66 20 63 75 72 72 65 6e 74 6c 79 rue if currently
21500 20 69 6e 73 69 64 65 20 61 6e 20 73 71 6c 69 74 inside an sqlit
21510 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 62 28 e3_declare_vtab(
21520 29 20 63 61 6c 6c 2e 0a 2a 2f 0a 23 69 66 64 65 ) call..*/.#ifde
21530 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
21540 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 23 64 65 RTUALTABLE. #de
21550 66 69 6e 65 20 49 4e 5f 44 45 43 4c 41 52 45 5f fine IN_DECLARE_
21560 56 54 41 42 20 30 0a 23 65 6c 73 65 0a 20 20 23 VTAB 0.#else. #
21570 64 65 66 69 6e 65 20 49 4e 5f 44 45 43 4c 41 52 define IN_DECLAR
21580 45 5f 56 54 41 42 20 28 70 50 61 72 73 65 2d 3e E_VTAB (pParse->
21590 64 65 63 6c 61 72 65 56 74 61 62 29 0a 23 65 6e declareVtab).#en
215a0 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e dif../*.** An in
215b0 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
215c0 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
215d0 65 20 63 61 6e 20 62 65 20 64 65 63 6c 61 72 65 e can be declare
215e0 64 20 6f 6e 20 61 20 73 74 61 63 6b 20 61 6e 64 d on a stack and
215f0 20 75 73 65 64 0a 2a 2a 20 74 6f 20 73 61 76 65 used.** to save
21600 20 74 68 65 20 50 61 72 73 65 2e 7a 41 75 74 68 the Parse.zAuth
21610 43 6f 6e 74 65 78 74 20 76 61 6c 75 65 20 73 6f Context value so
21620 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 that it can be
21630 72 65 73 74 6f 72 65 64 20 6c 61 74 65 72 2e 0a restored later..
21640 2a 2f 0a 73 74 72 75 63 74 20 41 75 74 68 43 6f */.struct AuthCo
21650 6e 74 65 78 74 20 7b 0a 20 20 63 6f 6e 73 74 20 ntext {. const
21660 63 68 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 65 char *zAuthConte
21670 78 74 3b 20 20 20 2f 2a 20 50 75 74 20 73 61 76 xt; /* Put sav
21680 65 64 20 50 61 72 73 65 2e 7a 41 75 74 68 43 6f ed Parse.zAuthCo
21690 6e 74 65 78 74 20 68 65 72 65 20 2a 2f 0a 20 20 ntext here */.
216a0 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 Parse *pParse;
216b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
216c0 68 65 20 50 61 72 73 65 20 73 74 72 75 63 74 75 he Parse structu
216d0 72 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 re */.};../*.**
216e0 42 69 74 66 69 65 6c 64 20 66 6c 61 67 73 20 66 Bitfield flags f
216f0 6f 72 20 50 35 20 76 61 6c 75 65 20 69 6e 20 76 or P5 value in v
21700 61 72 69 6f 75 73 20 6f 70 63 6f 64 65 73 2e 0a arious opcodes..
21710 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e 73 **.** Value cons
21720 74 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 63 65 traints (enforce
21730 64 20 76 69 61 20 61 73 73 65 72 74 28 29 29 3a d via assert()):
21740 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 4c 45 .** OPFLAG_LE
21750 4e 47 54 48 41 52 47 20 20 20 20 3d 3d 20 53 51 NGTHARG == SQ
21760 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 LITE_FUNC_LENGTH
21770 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 54 59 .** OPFLAG_TY
21780 50 45 4f 46 41 52 47 20 20 20 20 3d 3d 20 53 51 PEOFARG == SQ
21790 4c 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 LITE_FUNC_TYPEOF
217a0 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f 42 55 .** OPFLAG_BU
217b0 4c 4b 43 53 52 20 20 20 20 20 20 3d 3d 20 42 54 LKCSR == BT
217c0 52 45 45 5f 42 55 4c 4b 4c 4f 41 44 0a 2a 2a 20 REE_BULKLOAD.**
217d0 20 20 20 4f 50 46 4c 41 47 5f 53 45 45 4b 45 51 OPFLAG_SEEKEQ
217e0 20 20 20 20 20 20 20 3d 3d 20 42 54 52 45 45 5f == BTREE_
217f0 53 45 45 4b 5f 45 51 0a 2a 2a 20 20 20 20 4f 50 SEEK_EQ.** OP
21800 46 4c 41 47 5f 46 4f 52 44 45 4c 45 54 45 20 20 FLAG_FORDELETE
21810 20 20 3d 3d 20 42 54 52 45 45 5f 46 4f 52 44 45 == BTREE_FORDE
21820 4c 45 54 45 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 LETE.** OPFLA
21830 47 5f 53 41 56 45 50 4f 53 49 54 49 4f 4e 20 3d G_SAVEPOSITION =
21840 3d 20 42 54 52 45 45 5f 53 41 56 45 50 4f 53 49 = BTREE_SAVEPOSI
21850 54 49 4f 4e 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 TION.** OPFLA
21860 47 5f 41 55 58 44 45 4c 45 54 45 20 20 20 20 3d G_AUXDELETE =
21870 3d 20 42 54 52 45 45 5f 41 55 58 44 45 4c 45 54 = BTREE_AUXDELET
21880 45 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 E.*/.#define OPF
21890 4c 41 47 5f 4e 43 48 41 4e 47 45 20 20 20 20 20 LAG_NCHANGE
218a0 20 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 0x01 /* OP_
218b0 49 6e 73 65 72 74 3a 20 53 65 74 20 74 6f 20 75 Insert: Set to u
218c0 70 64 61 74 65 20 64 62 2d 3e 6e 43 68 61 6e 67 pdate db->nChang
218d0 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 e */.
218e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
218f0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 73 /* Als
21900 6f 20 75 73 65 64 20 69 6e 20 50 32 20 28 6e 6f o used in P2 (no
21910 74 20 50 35 29 20 6f 66 20 4f 50 5f 44 65 6c 65 t P5) of OP_Dele
21920 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 te */.#define OP
21930 46 4c 41 47 5f 45 50 48 45 4d 20 20 20 20 20 20 FLAG_EPHEM
21940 20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 0x01 /* OP
21950 5f 43 6f 6c 75 6d 6e 3a 20 45 70 68 65 6d 65 72 _Column: Ephemer
21960 61 6c 20 6f 75 74 70 75 74 20 69 73 20 6f 6b 20 al output is ok
21970 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
21980 47 5f 4c 41 53 54 52 4f 57 49 44 20 20 20 20 20 G_LASTROWID
21990 30 78 32 30 20 20 20 20 2f 2a 20 53 65 74 20 74 0x20 /* Set t
219a0 6f 20 75 70 64 61 74 65 20 64 62 2d 3e 6c 61 73 o update db->las
219b0 74 52 6f 77 69 64 20 2a 2f 0a 23 64 65 66 69 6e tRowid */.#defin
219c0 65 20 4f 50 46 4c 41 47 5f 49 53 55 50 44 41 54 e OPFLAG_ISUPDAT
219d0 45 20 20 20 20 20 20 30 78 30 34 20 20 20 20 2f E 0x04 /
219e0 2a 20 54 68 69 73 20 4f 50 5f 49 6e 73 65 72 74 * This OP_Insert
219f0 20 69 73 20 61 6e 20 73 71 6c 20 55 50 44 41 54 is an sql UPDAT
21a00 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 E */.#define OPF
21a10 4c 41 47 5f 41 50 50 45 4e 44 20 20 20 20 20 20 LAG_APPEND
21a20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 54 68 69 0x08 /* Thi
21a30 73 20 69 73 20 6c 69 6b 65 6c 79 20 74 6f 20 62 s is likely to b
21a40 65 20 61 6e 20 61 70 70 65 6e 64 20 2a 2f 0a 23 e an append */.#
21a50 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 55 53 define OPFLAG_US
21a60 45 53 45 45 4b 52 45 53 55 4c 54 20 30 78 31 30 ESEEKRESULT 0x10
21a70 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 61 76 /* Try to av
21a80 6f 69 64 20 61 20 73 65 65 6b 20 69 6e 20 42 74 oid a seek in Bt
21a90 72 65 65 49 6e 73 65 72 74 28 29 20 2a 2f 0a 23 reeInsert() */.#
21aa0 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 49 53 define OPFLAG_IS
21ab0 4e 4f 4f 50 20 20 20 20 20 20 20 20 30 78 34 30 NOOP 0x40
21ac0 20 20 20 20 2f 2a 20 4f 50 5f 44 65 6c 65 74 65 /* OP_Delete
21ad0 20 64 6f 65 73 20 70 72 65 2d 75 70 64 61 74 65 does pre-update
21ae0 2d 68 6f 6f 6b 20 6f 6e 6c 79 20 2a 2f 0a 23 64 -hook only */.#d
21af0 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 4c 45 4e efine OPFLAG_LEN
21b00 47 54 48 41 52 47 20 20 20 20 20 30 78 34 30 20 GTHARG 0x40
21b10 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 /* OP_Column
21b20 6f 6e 6c 79 20 75 73 65 64 20 66 6f 72 20 6c 65 only used for le
21b30 6e 67 74 68 28 29 20 2a 2f 0a 23 64 65 66 69 6e ngth() */.#defin
21b40 65 20 4f 50 46 4c 41 47 5f 54 59 50 45 4f 46 41 e OPFLAG_TYPEOFA
21b50 52 47 20 20 20 20 20 30 78 38 30 20 20 20 20 2f RG 0x80 /
21b60 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c 79 * OP_Column only
21b70 20 75 73 65 64 20 66 6f 72 20 74 79 70 65 6f 66 used for typeof
21b80 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 () */.#define OP
21b90 46 4c 41 47 5f 42 55 4c 4b 43 53 52 20 20 20 20 FLAG_BULKCSR
21ba0 20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 0x01 /* OP
21bb0 5f 4f 70 65 6e 2a 2a 20 75 73 65 64 20 74 6f 20 _Open** used to
21bc0 6f 70 65 6e 20 62 75 6c 6b 20 63 75 72 73 6f 72 open bulk cursor
21bd0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c */.#define OPFL
21be0 41 47 5f 53 45 45 4b 45 51 20 20 20 20 20 20 20 AG_SEEKEQ
21bf0 20 30 78 30 32 20 20 20 20 2f 2a 20 4f 50 5f 4f 0x02 /* OP_O
21c00 70 65 6e 2a 2a 20 63 75 72 73 6f 72 20 75 73 65 pen** cursor use
21c10 73 20 45 51 20 73 65 65 6b 20 6f 6e 6c 79 20 2a s EQ seek only *
21c20 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
21c30 5f 46 4f 52 44 45 4c 45 54 45 20 20 20 20 20 30 _FORDELETE 0
21c40 78 30 38 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 x08 /* OP_Ope
21c50 6e 20 73 68 6f 75 6c 64 20 75 73 65 20 42 54 52 n should use BTR
21c60 45 45 5f 46 4f 52 44 45 4c 45 54 45 20 2a 2f 0a EE_FORDELETE */.
21c70 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 50 #define OPFLAG_P
21c80 32 49 53 52 45 47 20 20 20 20 20 20 20 30 78 31 2ISREG 0x1
21c90 30 20 20 20 20 2f 2a 20 50 32 20 74 6f 20 4f 50 0 /* P2 to OP
21ca0 5f 4f 70 65 6e 2a 2a 20 69 73 20 61 20 72 65 67 _Open** is a reg
21cb0 69 73 74 65 72 20 6e 75 6d 62 65 72 20 2a 2f 0a ister number */.
21cc0 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 50 #define OPFLAG_P
21cd0 45 52 4d 55 54 45 20 20 20 20 20 20 20 30 78 30 ERMUTE 0x0
21ce0 31 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6d 70 61 1 /* OP_Compa
21cf0 72 65 3a 20 75 73 65 20 74 68 65 20 70 65 72 6d re: use the perm
21d00 75 74 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 utation */.#defi
21d10 6e 65 20 4f 50 46 4c 41 47 5f 53 41 56 45 50 4f ne OPFLAG_SAVEPO
21d20 53 49 54 49 4f 4e 20 20 30 78 30 32 20 20 20 20 SITION 0x02
21d30 2f 2a 20 4f 50 5f 44 65 6c 65 74 65 2f 49 6e 73 /* OP_Delete/Ins
21d40 65 72 74 3a 20 73 61 76 65 20 63 75 72 73 6f 72 ert: save cursor
21d50 20 70 6f 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 pos */.#define
21d60 4f 50 46 4c 41 47 5f 41 55 58 44 45 4c 45 54 45 OPFLAG_AUXDELETE
21d70 20 20 20 20 20 30 78 30 34 20 20 20 20 2f 2a 20 0x04 /*
21d80 4f 50 5f 44 65 6c 65 74 65 3a 20 69 6e 64 65 78 OP_Delete: index
21d90 20 69 6e 20 61 20 44 45 4c 45 54 45 20 6f 70 20 in a DELETE op
21da0 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
21db0 47 5f 4e 4f 43 48 4e 47 5f 4d 41 47 49 43 20 20 G_NOCHNG_MAGIC
21dc0 30 78 36 64 20 20 20 20 2f 2a 20 4f 50 5f 4d 61 0x6d /* OP_Ma
21dd0 6b 65 52 65 63 6f 72 64 3a 20 73 65 72 69 61 6c keRecord: serial
21de0 74 79 70 65 20 31 30 20 69 73 20 6f 6b 20 2a 2f type 10 is ok */
21df0 0a 0a 2f 2a 0a 20 2a 20 45 61 63 68 20 74 72 69 ../*. * Each tri
21e00 67 67 65 72 20 70 72 65 73 65 6e 74 20 69 6e 20 gger present in
21e10 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 the database sch
21e20 65 6d 61 20 69 73 20 73 74 6f 72 65 64 20 61 73 ema is stored as
21e30 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a an instance of.
21e40 20 2a 20 73 74 72 75 63 74 20 54 72 69 67 67 65 * struct Trigge
21e50 72 2e 0a 20 2a 0a 20 2a 20 50 6f 69 6e 74 65 72 r.. *. * Pointer
21e60 73 20 74 6f 20 69 6e 73 74 61 6e 63 65 73 20 6f s to instances o
21e70 66 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 f struct Trigger
21e80 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 74 are stored in t
21e90 77 6f 20 77 61 79 73 2e 0a 20 2a 20 31 2e 20 49 wo ways.. * 1. I
21ea0 6e 20 74 68 65 20 22 74 72 69 67 48 61 73 68 22 n the "trigHash"
21eb0 20 68 61 73 68 20 74 61 62 6c 65 20 28 70 61 72 hash table (par
21ec0 74 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 t of the sqlite3
21ed0 2a 20 74 68 61 74 20 72 65 70 72 65 73 65 6e 74 * that represent
21ee0 73 20 74 68 65 0a 20 2a 20 20 20 20 64 61 74 61 s the. * data
21ef0 62 61 73 65 29 2e 20 54 68 69 73 20 61 6c 6c 6f base). This allo
21f00 77 73 20 54 72 69 67 67 65 72 20 73 74 72 75 63 ws Trigger struc
21f10 74 75 72 65 73 20 74 6f 20 62 65 20 72 65 74 72 tures to be retr
21f20 69 65 76 65 64 20 62 79 20 6e 61 6d 65 2e 0a 20 ieved by name..
21f30 2a 20 32 2e 20 41 6c 6c 20 74 72 69 67 67 65 72 * 2. All trigger
21f40 73 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 s associated wit
21f50 68 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 h a single table
21f60 20 66 6f 72 6d 20 61 20 6c 69 6e 6b 65 64 20 6c form a linked l
21f70 69 73 74 2c 20 75 73 69 6e 67 20 74 68 65 0a 20 ist, using the.
21f80 2a 20 20 20 20 70 4e 65 78 74 20 6d 65 6d 62 65 * pNext membe
21f90 72 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 67 r of struct Trig
21fa0 67 65 72 2e 20 41 20 70 6f 69 6e 74 65 72 20 74 ger. A pointer t
21fb0 6f 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d o the first elem
21fc0 65 6e 74 20 6f 66 20 74 68 65 0a 20 2a 20 20 20 ent of the. *
21fd0 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 69 73 20 linked list is
21fe0 73 74 6f 72 65 64 20 61 73 20 74 68 65 20 22 70 stored as the "p
21ff0 54 72 69 67 67 65 72 22 20 6d 65 6d 62 65 72 20 Trigger" member
22000 6f 66 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 of the associate
22010 64 0a 20 2a 20 20 20 20 73 74 72 75 63 74 20 54 d. * struct T
22020 61 62 6c 65 2e 0a 20 2a 0a 20 2a 20 54 68 65 20 able.. *. * The
22030 22 73 74 65 70 5f 6c 69 73 74 22 20 6d 65 6d 62 "step_list" memb
22040 65 72 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 er points to the
22050 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f first element o
22060 66 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 0a f a linked list.
22070 20 2a 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 * containing th
22080 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 e SQL statements
22090 20 73 70 65 63 69 66 69 65 64 20 61 73 20 74 68 specified as th
220a0 65 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 e trigger progra
220b0 6d 2e 0a 20 2a 2f 0a 73 74 72 75 63 74 20 54 72 m.. */.struct Tr
220c0 69 67 67 65 72 20 7b 0a 20 20 63 68 61 72 20 2a igger {. char *
220d0 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 zName;
220e0 20 20 2f 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 /* The name of
220f0 20 74 68 65 20 74 72 69 67 67 65 72 20 20 20 20 the trigger
22100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22110 20 20 20 20 2a 2f 0a 20 20 63 68 61 72 20 2a 74 */. char *t
22120 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 able;
22130 20 2f 2a 20 54 68 65 20 74 61 62 6c 65 20 6f 72 /* The table or
22140 20 76 69 65 77 20 74 6f 20 77 68 69 63 68 20 74 view to which t
22150 68 65 20 74 72 69 67 67 65 72 20 61 70 70 6c 69 he trigger appli
22160 65 73 20 2a 2f 0a 20 20 75 38 20 6f 70 3b 20 20 es */. u8 op;
22170 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22180 2f 2a 20 4f 6e 65 20 6f 66 20 54 4b 5f 44 45 4c /* One of TK_DEL
22190 45 54 45 2c 20 54 4b 5f 55 50 44 41 54 45 2c 20 ETE, TK_UPDATE,
221a0 54 4b 5f 49 4e 53 45 52 54 20 20 20 20 20 20 20 TK_INSERT
221b0 20 20 2a 2f 0a 20 20 75 38 20 74 72 5f 74 6d 3b */. u8 tr_tm;
221c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
221d0 2a 20 4f 6e 65 20 6f 66 20 54 52 49 47 47 45 52 * One of TRIGGER
221e0 5f 42 45 46 4f 52 45 2c 20 54 52 49 47 47 45 52 _BEFORE, TRIGGER
221f0 5f 41 46 54 45 52 20 2a 2f 0a 20 20 45 78 70 72 _AFTER */. Expr
22200 20 2a 70 57 68 65 6e 3b 20 20 20 20 20 20 20 20 *pWhen;
22210 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 4e 20 /* The WHEN
22220 63 6c 61 75 73 65 20 6f 66 20 74 68 65 20 65 78 clause of the ex
22230 70 72 65 73 73 69 6f 6e 20 28 6d 61 79 20 62 65 pression (may be
22240 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 49 64 4c 69 NULL) */. IdLi
22250 73 74 20 2a 70 43 6f 6c 75 6d 6e 73 3b 20 20 20 st *pColumns;
22260 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69 /* If this i
22270 73 20 61 6e 20 55 50 44 41 54 45 20 4f 46 20 3c s an UPDATE OF <
22280 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 74 72 69 column-list> tri
22290 67 67 65 72 2c 0a 20 20 20 20 20 20 20 20 20 20 gger,.
222a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
222b0 20 20 20 74 68 65 20 3c 63 6f 6c 75 6d 6e 2d 6c the <column-l
222c0 69 73 74 3e 20 69 73 20 73 74 6f 72 65 64 20 68 ist> is stored h
222d0 65 72 65 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 ere */. Schema
222e0 2a 70 53 63 68 65 6d 61 3b 20 20 20 20 20 20 20 *pSchema;
222f0 20 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 /* Schema conta
22300 69 6e 69 6e 67 20 74 68 65 20 74 72 69 67 67 65 ining the trigge
22310 72 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 r */. Schema *p
22320 54 61 62 53 63 68 65 6d 61 3b 20 20 20 20 20 2f TabSchema; /
22330 2a 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e * Schema contain
22340 69 6e 67 20 74 68 65 20 74 61 62 6c 65 20 2a 2f ing the table */
22350 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 20 2a . TriggerStep *
22360 73 74 65 70 5f 6c 69 73 74 3b 20 2f 2a 20 4c 69 step_list; /* Li
22370 6e 6b 20 6c 69 73 74 20 6f 66 20 74 72 69 67 67 nk list of trigg
22380 65 72 20 70 72 6f 67 72 61 6d 20 73 74 65 70 73 er program steps
22390 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2f 0a */.
223a0 20 20 54 72 69 67 67 65 72 20 2a 70 4e 65 78 74 Trigger *pNext
223b0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 ; /* Nex
223c0 74 20 74 72 69 67 67 65 72 20 61 73 73 6f 63 69 t trigger associ
223d0 61 74 65 64 20 77 69 74 68 20 74 68 65 20 74 61 ated with the ta
223e0 62 6c 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ble */.};../*.**
223f0 20 41 20 74 72 69 67 67 65 72 20 69 73 20 65 69 A trigger is ei
22400 74 68 65 72 20 61 20 42 45 46 4f 52 45 20 6f 72 ther a BEFORE or
22410 20 61 6e 20 41 46 54 45 52 20 74 72 69 67 67 65 an AFTER trigge
22420 72 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e r. The followin
22430 67 20 63 6f 6e 73 74 61 6e 74 73 0a 2a 2a 20 64 g constants.** d
22440 65 74 65 72 6d 69 6e 65 20 77 68 69 63 68 2e 0a etermine which..
22450 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 **.** If there a
22460 72 65 20 6d 75 6c 74 69 70 6c 65 20 74 72 69 67 re multiple trig
22470 67 65 72 73 2c 20 79 6f 75 20 6d 69 67 68 74 20 gers, you might
22480 6f 66 20 73 6f 6d 65 20 42 45 46 4f 52 45 20 61 of some BEFORE a
22490 6e 64 20 73 6f 6d 65 20 41 46 54 45 52 2e 0a 2a nd some AFTER..*
224a0 2a 20 49 6e 20 74 68 61 74 20 63 61 73 65 73 2c * In that cases,
224b0 20 74 68 65 20 63 6f 6e 73 74 61 6e 74 73 20 62 the constants b
224c0 65 6c 6f 77 20 63 61 6e 20 62 65 20 4f 52 65 64 elow can be ORed
224d0 20 74 6f 67 65 74 68 65 72 2e 0a 2a 2f 0a 23 64 together..*/.#d
224e0 65 66 69 6e 65 20 54 52 49 47 47 45 52 5f 42 45 efine TRIGGER_BE
224f0 46 4f 52 45 20 20 31 0a 23 64 65 66 69 6e 65 20 FORE 1.#define
22500 54 52 49 47 47 45 52 5f 41 46 54 45 52 20 20 20 TRIGGER_AFTER
22510 32 0a 0a 2f 2a 0a 20 2a 20 41 6e 20 69 6e 73 74 2../*. * An inst
22520 61 6e 63 65 20 6f 66 20 73 74 72 75 63 74 20 54 ance of struct T
22530 72 69 67 67 65 72 53 74 65 70 20 69 73 20 75 73 riggerStep is us
22540 65 64 20 74 6f 20 73 74 6f 72 65 20 61 20 73 69 ed to store a si
22550 6e 67 6c 65 20 53 51 4c 20 73 74 61 74 65 6d 65 ngle SQL stateme
22560 6e 74 0a 20 2a 20 74 68 61 74 20 69 73 20 61 20 nt. * that is a
22570 70 61 72 74 20 6f 66 20 61 20 74 72 69 67 67 65 part of a trigge
22580 72 2d 70 72 6f 67 72 61 6d 2e 0a 20 2a 0a 20 2a r-program.. *. *
22590 20 49 6e 73 74 61 6e 63 65 73 20 6f 66 20 73 74 Instances of st
225a0 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 70 ruct TriggerStep
225b0 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 61 are stored in a
225c0 20 73 69 6e 67 6c 79 20 6c 69 6e 6b 65 64 20 6c singly linked l
225d0 69 73 74 20 28 6c 69 6e 6b 65 64 0a 20 2a 20 75 ist (linked. * u
225e0 73 69 6e 67 20 74 68 65 20 22 70 4e 65 78 74 22 sing the "pNext"
225f0 20 6d 65 6d 62 65 72 29 20 72 65 66 65 72 65 6e member) referen
22600 63 65 64 20 62 79 20 74 68 65 20 22 73 74 65 70 ced by the "step
22610 5f 6c 69 73 74 22 20 6d 65 6d 62 65 72 20 6f 66 _list" member of
22620 20 74 68 65 0a 20 2a 20 61 73 73 6f 63 69 61 74 the. * associat
22630 65 64 20 73 74 72 75 63 74 20 54 72 69 67 67 65 ed struct Trigge
22640 72 20 69 6e 73 74 61 6e 63 65 2e 20 54 68 65 20 r instance. The
22650 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 first element of
22660 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 the linked list
22670 20 69 73 0a 20 2a 20 74 68 65 20 66 69 72 73 74 is. * the first
22680 20 73 74 65 70 20 6f 66 20 74 68 65 20 74 72 69 step of the tri
22690 67 67 65 72 2d 70 72 6f 67 72 61 6d 2e 0a 20 2a gger-program.. *
226a0 0a 20 2a 20 54 68 65 20 22 6f 70 22 20 6d 65 6d . * The "op" mem
226b0 62 65 72 20 69 6e 64 69 63 61 74 65 73 20 77 68 ber indicates wh
226c0 65 74 68 65 72 20 74 68 69 73 20 69 73 20 61 20 ether this is a
226d0 22 44 45 4c 45 54 45 22 2c 20 22 49 4e 53 45 52 "DELETE", "INSER
226e0 54 22 2c 20 22 55 50 44 41 54 45 22 20 6f 72 0a T", "UPDATE" or.
226f0 20 2a 20 22 53 45 4c 45 43 54 22 20 73 74 61 74 * "SELECT" stat
22700 65 6d 65 6e 74 2e 20 54 68 65 20 6d 65 61 6e 69 ement. The meani
22710 6e 67 73 20 6f 66 20 74 68 65 20 6f 74 68 65 72 ngs of the other
22720 20 6d 65 6d 62 65 72 73 20 69 73 20 64 65 74 65 members is dete
22730 72 6d 69 6e 65 64 20 62 79 20 74 68 65 0a 20 2a rmined by the. *
22740 20 76 61 6c 75 65 20 6f 66 20 22 6f 70 22 20 61 value of "op" a
22750 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 2a 0a 20 2a s follows:. *. *
22760 20 28 6f 70 20 3d 3d 20 54 4b 5f 49 4e 53 45 52 (op == TK_INSER
22770 54 29 0a 20 2a 20 6f 72 63 6f 6e 66 20 20 20 20 T). * orconf
22780 2d 3e 20 73 74 6f 72 65 73 20 74 68 65 20 4f 4e -> stores the ON
22790 20 43 4f 4e 46 4c 49 43 54 20 61 6c 67 6f 72 69 CONFLICT algori
227a0 74 68 6d 0a 20 2a 20 70 53 65 6c 65 63 74 20 20 thm. * pSelect
227b0 20 2d 3e 20 49 66 20 74 68 69 73 20 69 73 20 61 -> If this is a
227c0 6e 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e n INSERT INTO ..
227d0 2e 20 53 45 4c 45 43 54 20 2e 2e 2e 20 73 74 61 . SELECT ... sta
227e0 74 65 6d 65 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 tement, then. *
227f0 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 thi
22800 73 20 73 74 6f 72 65 73 20 61 20 70 6f 69 6e 74 s stores a point
22810 65 72 20 74 6f 20 74 68 65 20 53 45 4c 45 43 54 er to the SELECT
22820 20 73 74 61 74 65 6d 65 6e 74 2e 20 4f 74 68 65 statement. Othe
22830 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a 20 7a rwise NULL.. * z
22840 54 61 72 67 65 74 20 20 20 2d 3e 20 44 65 71 75 Target -> Dequ
22850 6f 74 65 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 oted name of the
22860 20 74 61 62 6c 65 20 74 6f 20 69 6e 73 65 72 74 table to insert
22870 20 69 6e 74 6f 2e 0a 20 2a 20 70 45 78 70 72 4c into.. * pExprL
22880 69 73 74 20 2d 3e 20 49 66 20 74 68 69 73 20 69 ist -> If this i
22890 73 20 61 6e 20 49 4e 53 45 52 54 20 49 4e 54 4f s an INSERT INTO
228a0 20 2e 2e 2e 20 56 41 4c 55 45 53 20 2e 2e 2e 20 ... VALUES ...
228b0 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 6e 0a statement, then.
228c0 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
228d0 74 68 69 73 20 73 74 6f 72 65 73 20 76 61 6c 75 this stores valu
228e0 65 73 20 74 6f 20 62 65 20 69 6e 73 65 72 74 65 es to be inserte
228f0 64 2e 20 4f 74 68 65 72 77 69 73 65 20 4e 55 4c d. Otherwise NUL
22900 4c 2e 0a 20 2a 20 70 49 64 4c 69 73 74 20 20 20 L.. * pIdList
22910 2d 3e 20 49 66 20 74 68 69 73 20 69 73 20 61 6e -> If this is an
22920 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e INSERT INTO ...
22930 20 28 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 3e (<column-names>
22940 29 20 56 41 4c 55 45 53 20 2e 2e 2e 0a 20 2a 20 ) VALUES .... *
22950 20 20 20 20 20 20 20 20 20 20 20 20 20 73 74 61 sta
22960 74 65 6d 65 6e 74 2c 20 74 68 65 6e 20 74 68 69 tement, then thi
22970 73 20 73 74 6f 72 65 73 20 74 68 65 20 63 6f 6c s stores the col
22980 75 6d 6e 2d 6e 61 6d 65 73 20 74 6f 20 62 65 0a umn-names to be.
22990 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
229a0 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 2e 0a 20 inserted into..
229b0 2a 0a 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 44 *. * (op == TK_D
229c0 45 4c 45 54 45 29 0a 20 2a 20 7a 54 61 72 67 65 ELETE). * zTarge
229d0 74 20 20 20 2d 3e 20 44 65 71 75 6f 74 65 64 20 t -> Dequoted
229e0 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c name of the tabl
229f0 65 20 74 6f 20 64 65 6c 65 74 65 20 66 72 6f 6d e to delete from
22a00 2e 0a 20 2a 20 70 57 68 65 72 65 20 20 20 20 2d .. * pWhere -
22a10 3e 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 > The WHERE clau
22a20 73 65 20 6f 66 20 74 68 65 20 44 45 4c 45 54 45 se of the DELETE
22a30 20 73 74 61 74 65 6d 65 6e 74 20 69 66 20 6f 6e statement if on
22a40 65 20 69 73 20 73 70 65 63 69 66 69 65 64 2e 0a e is specified..
22a50 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
22a60 4f 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a Otherwise NULL..
22a70 20 2a 0a 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f *. * (op == TK_
22a80 55 50 44 41 54 45 29 0a 20 2a 20 7a 54 61 72 67 UPDATE). * zTarg
22a90 65 74 20 20 20 2d 3e 20 44 65 71 75 6f 74 65 64 et -> Dequoted
22aa0 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
22ab0 6c 65 20 74 6f 20 75 70 64 61 74 65 2e 0a 20 2a le to update.. *
22ac0 20 70 57 68 65 72 65 20 20 20 20 2d 3e 20 54 68 pWhere -> Th
22ad0 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 6f e WHERE clause o
22ae0 66 20 74 68 65 20 55 50 44 41 54 45 20 73 74 61 f the UPDATE sta
22af0 74 65 6d 65 6e 74 20 69 66 20 6f 6e 65 20 69 73 tement if one is
22b00 20 73 70 65 63 69 66 69 65 64 2e 0a 20 2a 20 20 specified.. *
22b10 20 20 20 20 20 20 20 20 20 20 20 20 4f 74 68 65 Othe
22b20 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a 20 70 rwise NULL.. * p
22b30 45 78 70 72 4c 69 73 74 20 2d 3e 20 41 20 6c 69 ExprList -> A li
22b40 73 74 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e st of the column
22b50 73 20 74 6f 20 75 70 64 61 74 65 20 61 6e 64 20 s to update and
22b60 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 the expressions
22b70 74 6f 20 75 70 64 61 74 65 0a 20 2a 20 20 20 20 to update. *
22b80 20 20 20 20 20 20 20 20 20 20 74 68 65 6d 20 74 them t
22b90 6f 2e 20 53 65 65 20 73 71 6c 69 74 65 33 55 70 o. See sqlite3Up
22ba0 64 61 74 65 28 29 20 64 6f 63 75 6d 65 6e 74 61 date() documenta
22bb0 74 69 6f 6e 20 6f 66 20 22 70 43 68 61 6e 67 65 tion of "pChange
22bc0 73 22 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 s". *
22bd0 20 20 20 61 72 67 75 6d 65 6e 74 2e 0a 20 2a 0a argument.. *.
22be0 20 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 */.struct Trigg
22bf0 65 72 53 74 65 70 20 7b 0a 20 20 75 38 20 6f 70 erStep {. u8 op
22c00 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
22c10 2f 2a 20 4f 6e 65 20 6f 66 20 54 4b 5f 44 45 4c /* One of TK_DEL
22c20 45 54 45 2c 20 54 4b 5f 55 50 44 41 54 45 2c 20 ETE, TK_UPDATE,
22c30 54 4b 5f 49 4e 53 45 52 54 2c 20 54 4b 5f 53 45 TK_INSERT, TK_SE
22c40 4c 45 43 54 20 2a 2f 0a 20 20 75 38 20 6f 72 63 LECT */. u8 orc
22c50 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 20 20 2f onf; /
22c60 2a 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b 20 65 74 * OE_Rollback et
22c70 63 2e 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 c. */. Trigger
22c80 2a 70 54 72 69 67 3b 20 20 20 20 20 20 2f 2a 20 *pTrig; /*
22c90 54 68 65 20 74 72 69 67 67 65 72 20 74 68 61 74 The trigger that
22ca0 20 74 68 69 73 20 73 74 65 70 20 69 73 20 61 20 this step is a
22cb0 70 61 72 74 20 6f 66 20 2a 2f 0a 20 20 53 65 6c part of */. Sel
22cc0 65 63 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 ect *pSelect;
22cd0 20 20 2f 2a 20 53 45 4c 45 43 54 20 73 74 61 74 /* SELECT stat
22ce0 65 6d 65 6e 74 20 6f 72 20 52 48 53 20 6f 66 20 ement or RHS of
22cf0 49 4e 53 45 52 54 20 49 4e 54 4f 20 53 45 4c 45 INSERT INTO SELE
22d00 43 54 20 2e 2e 2e 20 2a 2f 0a 20 20 63 68 61 72 CT ... */. char
22d10 20 2a 7a 54 61 72 67 65 74 3b 20 20 20 20 20 20 *zTarget;
22d20 20 2f 2a 20 54 61 72 67 65 74 20 74 61 62 6c 65 /* Target table
22d30 20 66 6f 72 20 44 45 4c 45 54 45 2c 20 55 50 44 for DELETE, UPD
22d40 41 54 45 2c 20 49 4e 53 45 52 54 20 2a 2f 0a 20 ATE, INSERT */.
22d50 20 45 78 70 72 20 2a 70 57 68 65 72 65 3b 20 20 Expr *pWhere;
22d60 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 /* The WHE
22d70 52 45 20 63 6c 61 75 73 65 20 66 6f 72 20 44 45 RE clause for DE
22d80 4c 45 54 45 20 6f 72 20 55 50 44 41 54 45 20 73 LETE or UPDATE s
22d90 74 65 70 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 teps */. ExprLi
22da0 73 74 20 2a 70 45 78 70 72 4c 69 73 74 3b 20 2f st *pExprList; /
22db0 2a 20 53 45 54 20 63 6c 61 75 73 65 20 66 6f 72 * SET clause for
22dc0 20 55 50 44 41 54 45 20 2a 2f 0a 20 20 49 64 4c UPDATE */. IdL
22dd0 69 73 74 20 2a 70 49 64 4c 69 73 74 3b 20 20 20 ist *pIdList;
22de0 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 /* Column name
22df0 73 20 66 6f 72 20 49 4e 53 45 52 54 20 2a 2f 0a s for INSERT */.
22e00 20 20 55 70 73 65 72 74 20 2a 70 55 70 73 65 72 Upsert *pUpser
22e10 74 3b 20 20 20 20 20 2f 2a 20 55 70 73 65 72 74 t; /* Upsert
22e20 20 63 6c 61 75 73 65 73 20 6f 6e 20 61 6e 20 49 clauses on an I
22e30 4e 53 45 52 54 20 2a 2f 0a 20 20 63 68 61 72 20 NSERT */. char
22e40 2a 7a 53 70 61 6e 3b 20 20 20 20 20 20 20 20 20 *zSpan;
22e50 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 53 51 4c 20 /* Original SQL
22e60 74 65 78 74 20 6f 66 20 74 68 69 73 20 63 6f 6d text of this com
22e70 6d 61 6e 64 20 2a 2f 0a 20 20 54 72 69 67 67 65 mand */. Trigge
22e80 72 53 74 65 70 20 2a 70 4e 65 78 74 3b 20 20 2f rStep *pNext; /
22e90 2a 20 4e 65 78 74 20 69 6e 20 74 68 65 20 6c 69 * Next in the li
22ea0 6e 6b 2d 6c 69 73 74 20 2a 2f 0a 20 20 54 72 69 nk-list */. Tri
22eb0 67 67 65 72 53 74 65 70 20 2a 70 4c 61 73 74 3b ggerStep *pLast;
22ec0 20 20 2f 2a 20 4c 61 73 74 20 65 6c 65 6d 65 6e /* Last elemen
22ed0 74 20 69 6e 20 6c 69 6e 6b 2d 6c 69 73 74 2e 20 t in link-list.
22ee0 56 61 6c 69 64 20 66 6f 72 20 31 73 74 20 65 6c Valid for 1st el
22ef0 65 6d 20 6f 6e 6c 79 20 2a 2f 0a 7d 3b 0a 0a 2f em only */.};../
22f00 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
22f10 6e 67 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e ng structure con
22f20 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f tains informatio
22f30 6e 20 75 73 65 64 20 62 79 20 74 68 65 20 73 71 n used by the sq
22f40 6c 69 74 65 46 69 78 2e 2e 2e 0a 2a 2a 20 72 6f liteFix....** ro
22f50 75 74 69 6e 65 73 20 61 73 20 74 68 65 79 20 77 utines as they w
22f60 61 6c 6b 20 74 68 65 20 70 61 72 73 65 20 74 72 alk the parse tr
22f70 65 65 20 74 6f 20 6d 61 6b 65 20 64 61 74 61 62 ee to make datab
22f80 61 73 65 20 72 65 66 65 72 65 6e 63 65 73 0a 2a ase references.*
22f90 2a 20 65 78 70 6c 69 63 69 74 2e 0a 2a 2f 0a 74 * explicit..*/.t
22fa0 79 70 65 64 65 66 20 73 74 72 75 63 74 20 44 62 ypedef struct Db
22fb0 46 69 78 65 72 20 44 62 46 69 78 65 72 3b 0a 73 Fixer DbFixer;.s
22fc0 74 72 75 63 74 20 44 62 46 69 78 65 72 20 7b 0a truct DbFixer {.
22fd0 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b Parse *pParse;
22fe0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 72 /* The par
22ff0 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e 20 20 45 sing context. E
23000 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 77 72 rror messages wr
23010 69 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a 20 20 itten here */.
23020 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b Schema *pSchema;
23030 20 20 20 20 2f 2a 20 46 69 78 20 69 74 65 6d 73 /* Fix items
23040 20 74 6f 20 74 68 69 73 20 73 63 68 65 6d 61 20 to this schema
23050 2a 2f 0a 20 20 69 6e 74 20 62 56 61 72 4f 6e 6c */. int bVarOnl
23060 79 3b 20 20 20 20 20 20 20 2f 2a 20 43 68 65 63 y; /* Chec
23070 6b 20 66 6f 72 20 76 61 72 69 61 62 6c 65 20 72 k for variable r
23080 65 66 65 72 65 6e 63 65 73 20 6f 6e 6c 79 20 2a eferences only *
23090 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
230a0 7a 44 62 3b 20 20 20 20 2f 2a 20 4d 61 6b 65 20 zDb; /* Make
230b0 73 75 72 65 20 61 6c 6c 20 6f 62 6a 65 63 74 73 sure all objects
230c0 20 61 72 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 are contained i
230d0 6e 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 n this database
230e0 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
230f0 2a 7a 54 79 70 65 3b 20 20 2f 2a 20 54 79 70 65 *zType; /* Type
23100 20 6f 66 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 of the containe
23110 72 20 2d 20 75 73 65 64 20 66 6f 72 20 65 72 72 r - used for err
23120 6f 72 20 6d 65 73 73 61 67 65 73 20 2a 2f 0a 20 or messages */.
23130 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 20 2a 70 4e const Token *pN
23140 61 6d 65 3b 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 ame; /* Name of
23150 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 2d 20 the container -
23160 75 73 65 64 20 66 6f 72 20 65 72 72 6f 72 20 6d used for error m
23170 65 73 73 61 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f essages */.};../
23180 2a 0a 2a 2a 20 41 6e 20 6f 62 6a 65 63 74 65 64 *.** An objected
23190 20 75 73 65 64 20 74 6f 20 61 63 63 75 6d 75 6c used to accumul
231a0 61 74 65 20 74 68 65 20 74 65 78 74 20 6f 66 20 ate the text of
231b0 61 20 73 74 72 69 6e 67 20 77 68 65 72 65 20 77 a string where w
231c0 65 0a 2a 2a 20 64 6f 20 6e 6f 74 20 6e 65 63 65 e.** do not nece
231d0 73 73 61 72 69 6c 79 20 6b 6e 6f 77 20 68 6f 77 ssarily know how
231e0 20 62 69 67 20 74 68 65 20 73 74 72 69 6e 67 20 big the string
231f0 77 69 6c 6c 20 62 65 20 69 6e 20 74 68 65 20 65 will be in the e
23200 6e 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73 71 nd..*/.struct sq
23210 6c 69 74 65 33 5f 73 74 72 20 7b 0a 20 20 73 71 lite3_str {. sq
23220 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 lite3 *db;
23230 20 20 20 2f 2a 20 4f 70 74 69 6f 6e 61 6c 20 64 /* Optional d
23240 61 74 61 62 61 73 65 20 66 6f 72 20 6c 6f 6f 6b atabase for look
23250 61 73 69 64 65 2e 20 20 43 61 6e 20 62 65 20 4e aside. Can be N
23260 55 4c 4c 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a ULL */. char *z
23270 54 65 78 74 3b 20 20 20 20 20 20 20 20 20 2f 2a Text; /*
23280 20 54 68 65 20 73 74 72 69 6e 67 20 63 6f 6c 6c The string coll
23290 65 63 74 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a ected so far */.
232a0 20 20 75 33 32 20 20 6e 41 6c 6c 6f 63 3b 20 20 u32 nAlloc;
232b0 20 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 /* Amount
232c0 20 6f 66 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 of space alloca
232d0 74 65 64 20 69 6e 20 7a 54 65 78 74 20 2a 2f 0a ted in zText */.
232e0 20 20 75 33 32 20 20 6d 78 41 6c 6c 6f 63 3b 20 u32 mxAlloc;
232f0 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 /* Maximu
23300 6d 20 61 6c 6c 6f 77 65 64 20 61 6c 6c 6f 63 61 m allowed alloca
23310 74 69 6f 6e 2e 20 20 30 20 66 6f 72 20 6e 6f 20 tion. 0 for no
23320 6d 61 6c 6c 6f 63 20 75 73 61 67 65 20 2a 2f 0a malloc usage */.
23330 20 20 75 33 32 20 20 6e 43 68 61 72 3b 20 20 20 u32 nChar;
23340 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 /* Length
23350 20 6f 66 20 74 68 65 20 73 74 72 69 6e 67 20 73 of the string s
23360 6f 20 66 61 72 20 2a 2f 0a 20 20 75 38 20 20 20 o far */. u8
23370 61 63 63 45 72 72 6f 72 3b 20 20 20 20 20 20 20 accError;
23380 2f 2a 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 /* SQLITE_NOMEM
23390 6f 72 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 or SQLITE_TOOBIG
233a0 20 2a 2f 0a 20 20 75 38 20 20 20 70 72 69 6e 74 */. u8 print
233b0 66 46 6c 61 67 73 3b 20 20 20 20 2f 2a 20 53 51 fFlags; /* SQ
233c0 4c 49 54 45 5f 50 52 49 4e 54 46 20 66 6c 61 67 LITE_PRINTF flag
233d0 73 20 62 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 23 64 s below */.};.#d
233e0 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 efine SQLITE_PRI
233f0 4e 54 46 5f 49 4e 54 45 52 4e 41 4c 20 30 78 30 NTF_INTERNAL 0x0
23400 31 20 20 2f 2a 20 49 6e 74 65 72 6e 61 6c 2d 75 1 /* Internal-u
23410 73 65 2d 6f 6e 6c 79 20 63 6f 6e 76 65 72 74 65 se-only converte
23420 72 73 20 61 6c 6c 6f 77 65 64 20 2a 2f 0a 23 64 rs allowed */.#d
23430 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 efine SQLITE_PRI
23440 4e 54 46 5f 53 51 4c 46 55 4e 43 20 20 30 78 30 NTF_SQLFUNC 0x0
23450 32 20 20 2f 2a 20 53 51 4c 20 66 75 6e 63 74 69 2 /* SQL functi
23460 6f 6e 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 on arguments to
23470 56 58 50 72 69 6e 74 66 20 2a 2f 0a 23 64 65 66 VXPrintf */.#def
23480 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 4e 54 ine SQLITE_PRINT
23490 46 5f 4d 41 4c 4c 4f 43 45 44 20 30 78 30 34 20 F_MALLOCED 0x04
234a0 20 2f 2a 20 54 72 75 65 20 69 66 20 78 54 65 78 /* True if xTex
234b0 74 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 73 t is allocated s
234c0 70 61 63 65 20 2a 2f 0a 0a 23 64 65 66 69 6e 65 pace */..#define
234d0 20 69 73 4d 61 6c 6c 6f 63 65 64 28 58 29 20 20 isMalloced(X)
234e0 28 28 28 58 29 2d 3e 70 72 69 6e 74 66 46 6c 61 (((X)->printfFla
234f0 67 73 20 26 20 53 51 4c 49 54 45 5f 50 52 49 4e gs & SQLITE_PRIN
23500 54 46 5f 4d 41 4c 4c 4f 43 45 44 29 21 3d 30 29 TF_MALLOCED)!=0)
23510 0a 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 .../*.** A point
23520 65 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 er to this struc
23530 74 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 ture is used to
23540 63 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e 66 6f communicate info
23550 72 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f 6d 20 rmation.** from
23560 73 71 6c 69 74 65 33 49 6e 69 74 20 61 6e 64 20 sqlite3Init and
23570 4f 50 5f 50 61 72 73 65 53 63 68 65 6d 61 20 69 OP_ParseSchema i
23580 6e 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 49 nto the sqlite3I
23590 6e 69 74 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a nitCallback..*/.
235a0 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 7b typedef struct {
235b0 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 . sqlite3 *db;
235c0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 /* The da
235d0 74 61 62 61 73 65 20 62 65 69 6e 67 20 69 6e 69 tabase being ini
235e0 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 tialized */. ch
235f0 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 ar **pzErrMsg;
23600 20 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 /* Error messa
23610 67 65 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a ge stored here *
23620 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 /. int iDb;
23630 20 20 20 20 20 20 20 20 2f 2a 20 30 20 66 6f 72 /* 0 for
23640 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 20 main database.
23650 20 31 20 66 6f 72 20 54 45 4d 50 2c 20 32 2e 2e 1 for TEMP, 2..
23660 20 66 6f 72 20 41 54 54 41 43 48 65 64 20 2a 2f for ATTACHed */
23670 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 . int rc;
23680 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 /* Result
23690 20 63 6f 64 65 20 73 74 6f 72 65 64 20 68 65 72 code stored her
236a0 65 20 2a 2f 0a 7d 20 49 6e 69 74 44 61 74 61 3b e */.} InitData;
236b0 0a 0a 2f 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72 ../*.** Structur
236c0 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 67 6c 6f e containing glo
236d0 62 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f bal configuratio
236e0 6e 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 53 n data for the S
236f0 51 4c 69 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a QLite library..*
23700 2a 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 *.** This struct
23710 75 72 65 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e ure also contain
23720 73 20 73 6f 6d 65 20 73 74 61 74 65 20 69 6e 66 s some state inf
23730 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 ormation..*/.str
23740 75 63 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 uct Sqlite3Confi
23750 67 20 7b 0a 20 20 69 6e 74 20 62 4d 65 6d 73 74 g {. int bMemst
23760 61 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 at;
23770 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
23780 74 6f 20 65 6e 61 62 6c 65 20 6d 65 6d 6f 72 79 to enable memory
23790 20 73 74 61 74 75 73 20 2a 2f 0a 20 20 69 6e 74 status */. int
237a0 20 62 43 6f 72 65 4d 75 74 65 78 3b 20 20 20 20 bCoreMutex;
237b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
237c0 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 * True to enable
237d0 20 63 6f 72 65 20 6d 75 74 65 78 69 6e 67 20 2a core mutexing *
237e0 2f 0a 20 20 69 6e 74 20 62 46 75 6c 6c 4d 75 74 /. int bFullMut
237f0 65 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ex;
23800 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f /* True to
23810 20 65 6e 61 62 6c 65 20 66 75 6c 6c 20 6d 75 74 enable full mut
23820 65 78 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 exing */. int b
23830 4f 70 65 6e 55 72 69 3b 20 20 20 20 20 20 20 20 OpenUri;
23840 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23850 54 72 75 65 20 74 6f 20 69 6e 74 65 72 70 72 65 True to interpre
23860 74 20 66 69 6c 65 6e 61 6d 65 73 20 61 73 20 55 t filenames as U
23870 52 49 73 20 2a 2f 0a 20 20 69 6e 74 20 62 55 73 RIs */. int bUs
23880 65 43 69 73 3b 20 20 20 20 20 20 20 20 20 20 20 eCis;
23890 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 /* Us
238a0 65 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 e covering indic
238b0 65 73 20 66 6f 72 20 66 75 6c 6c 2d 73 63 61 6e es for full-scan
238c0 73 20 2a 2f 0a 20 20 69 6e 74 20 62 53 6d 61 6c s */. int bSmal
238d0 6c 4d 61 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 lMalloc;
238e0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 76 6f 69 /* Avoi
238f0 64 20 6c 61 72 67 65 20 6d 65 6d 6f 72 79 20 61 d large memory a
23900 6c 6c 6f 63 61 74 69 6f 6e 73 20 69 66 20 74 72 llocations if tr
23910 75 65 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 53 74 ue */. int mxSt
23920 72 6c 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 rlen;
23930 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 /* Max
23940 69 6d 75 6d 20 73 74 72 69 6e 67 20 6c 65 6e 67 imum string leng
23950 74 68 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 76 65 th */. int neve
23960 72 43 6f 72 72 75 70 74 3b 20 20 20 20 20 20 20 rCorrupt;
23970 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 /* Dat
23980 61 62 61 73 65 20 69 73 20 61 6c 77 61 79 73 20 abase is always
23990 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 2a 2f 0a 20 well-formed */.
239a0 20 69 6e 74 20 73 7a 4c 6f 6f 6b 61 73 69 64 65 int szLookaside
239b0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
239c0 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f /* Default lo
239d0 6f 6b 61 73 69 64 65 20 62 75 66 66 65 72 20 73 okaside buffer s
239e0 69 7a 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f ize */. int nLo
239f0 6f 6b 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 okaside;
23a00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 /* De
23a10 66 61 75 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 fault lookaside
23a20 62 75 66 66 65 72 20 63 6f 75 6e 74 20 2a 2f 0a buffer count */.
23a30 20 20 69 6e 74 20 6e 53 74 6d 74 53 70 69 6c 6c int nStmtSpill
23a40 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
23a50 20 20 20 20 2f 2a 20 53 74 6d 74 2d 6a 6f 75 72 /* Stmt-jour
23a60 6e 61 6c 20 73 70 69 6c 6c 2d 74 6f 2d 64 69 73 nal spill-to-dis
23a70 6b 20 74 68 72 65 73 68 6f 6c 64 20 2a 2f 0a 20 k threshold */.
23a80 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 sqlite3_mem_met
23a90 68 6f 64 73 20 6d 3b 20 20 20 20 20 20 20 20 20 hods m;
23aa0 20 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 /* Low-level
23ab0 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
23ac0 6e 20 69 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 n interface */.
23ad0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d sqlite3_mutex_m
23ae0 65 74 68 6f 64 73 20 6d 75 74 65 78 3b 20 20 20 ethods mutex;
23af0 20 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 /* Low-level
23b00 6d 75 74 65 78 20 69 6e 74 65 72 66 61 63 65 20 mutex interface
23b10 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 */. sqlite3_pca
23b20 63 68 65 5f 6d 65 74 68 6f 64 73 32 20 70 63 61 che_methods2 pca
23b30 63 68 65 32 3b 20 20 2f 2a 20 4c 6f 77 2d 6c 65 che2; /* Low-le
23b40 76 65 6c 20 70 61 67 65 2d 63 61 63 68 65 20 69 vel page-cache i
23b50 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 76 6f nterface */. vo
23b60 69 64 20 2a 70 48 65 61 70 3b 20 20 20 20 20 20 id *pHeap;
23b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23b80 2f 2a 20 48 65 61 70 20 73 74 6f 72 61 67 65 20 /* Heap storage
23b90 73 70 61 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e space */. int n
23ba0 48 65 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 Heap;
23bb0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23bc0 53 69 7a 65 20 6f 66 20 70 48 65 61 70 5b 5d 20 Size of pHeap[]
23bd0 2a 2f 0a 20 20 69 6e 74 20 6d 6e 52 65 71 2c 20 */. int mnReq,
23be0 6d 78 52 65 71 3b 20 20 20 20 20 20 20 20 20 20 mxReq;
23bf0 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 20 61 6e /* Min an
23c00 64 20 6d 61 78 20 68 65 61 70 20 72 65 71 75 65 d max heap reque
23c10 73 74 73 20 73 69 7a 65 73 20 2a 2f 0a 20 20 73 sts sizes */. s
23c20 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d qlite3_int64 szM
23c30 6d 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 map;
23c40 20 2f 2a 20 6d 6d 61 70 28 29 20 73 70 61 63 65 /* mmap() space
23c50 20 70 65 72 20 6f 70 65 6e 20 66 69 6c 65 20 2a per open file *
23c60 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 /. sqlite3_int6
23c70 34 20 6d 78 4d 6d 61 70 3b 20 20 20 20 20 20 20 4 mxMmap;
23c80 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d /* Maximum
23c90 20 76 61 6c 75 65 20 66 6f 72 20 73 7a 4d 6d 61 value for szMma
23ca0 70 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 50 61 p */. void *pPa
23cb0 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
23cc0 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 /* Page
23cd0 20 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a 2f cache memory */
23ce0 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b 20 20 . int szPage;
23cf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23d00 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
23d10 65 61 63 68 20 70 61 67 65 20 69 6e 20 70 50 61 each page in pPa
23d20 67 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 50 ge[] */. int nP
23d30 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 age;
23d40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
23d50 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 69 umber of pages i
23d60 6e 20 70 50 61 67 65 5b 5d 20 2a 2f 0a 20 20 69 n pPage[] */. i
23d70 6e 74 20 6d 78 50 61 72 73 65 72 53 74 61 63 6b nt mxParserStack
23d80 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
23d90 20 2f 2a 20 6d 61 78 69 6d 75 6d 20 64 65 70 74 /* maximum dept
23da0 68 20 6f 66 20 74 68 65 20 70 61 72 73 65 72 20 h of the parser
23db0 73 74 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 73 stack */. int s
23dc0 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 6c 65 haredCacheEnable
23dd0 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 d; /*
23de0 74 72 75 65 20 69 66 20 73 68 61 72 65 64 2d 63 true if shared-c
23df0 61 63 68 65 20 6d 6f 64 65 20 65 6e 61 62 6c 65 ache mode enable
23e00 64 20 2a 2f 0a 20 20 75 33 32 20 73 7a 50 6d 61 d */. u32 szPma
23e10 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
23e20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 /* Maxi
23e30 6d 75 6d 20 53 6f 72 74 65 72 20 50 4d 41 20 73 mum Sorter PMA s
23e40 69 7a 65 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 ize */. /* The
23e50 61 62 6f 76 65 20 6d 69 67 68 74 20 62 65 20 69 above might be i
23e60 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 6e 6f nitialized to no
23e70 6e 2d 7a 65 72 6f 2e 20 20 54 68 65 20 66 6f 6c n-zero. The fol
23e80 6c 6f 77 69 6e 67 20 6e 65 65 64 20 74 6f 20 61 lowing need to a
23e90 6c 77 61 79 73 0a 20 20 2a 2a 20 69 6e 69 74 69 lways. ** initi
23ea0 61 6c 6c 79 20 62 65 20 7a 65 72 6f 2c 20 68 6f ally be zero, ho
23eb0 77 65 76 65 72 2e 20 2a 2f 0a 20 20 69 6e 74 20 wever. */. int
23ec0 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 isInit;
23ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
23ee0 20 54 72 75 65 20 61 66 74 65 72 20 69 6e 69 74 True after init
23ef0 69 61 6c 69 7a 61 74 69 6f 6e 20 68 61 73 20 66 ialization has f
23f00 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 69 6e 74 inished */. int
23f10 20 69 6e 50 72 6f 67 72 65 73 73 3b 20 20 20 20 inProgress;
23f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23f30 2a 20 54 72 75 65 20 77 68 69 6c 65 20 69 6e 69 * True while ini
23f40 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 20 70 tialization in p
23f50 72 6f 67 72 65 73 73 20 2a 2f 0a 20 20 69 6e 74 rogress */. int
23f60 20 69 73 4d 75 74 65 78 49 6e 69 74 3b 20 20 20 isMutexInit;
23f70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
23f80 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 75 74 * True after mut
23f90 65 78 65 73 20 61 72 65 20 69 6e 69 74 69 61 6c exes are initial
23fa0 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 ized */. int is
23fb0 4d 61 6c 6c 6f 63 49 6e 69 74 3b 20 20 20 20 20 MallocInit;
23fc0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
23fd0 72 75 65 20 61 66 74 65 72 20 6d 61 6c 6c 6f 63 rue after malloc
23fe0 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 is initialized
23ff0 2a 2f 0a 20 20 69 6e 74 20 69 73 50 43 61 63 68 */. int isPCach
24000 65 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 eInit;
24010 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 /* True a
24020 66 74 65 72 20 6d 61 6c 6c 6f 63 20 69 73 20 69 fter malloc is i
24030 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 nitialized */.
24040 69 6e 74 20 6e 52 65 66 49 6e 69 74 4d 75 74 65 int nRefInitMute
24050 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
24060 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
24070 73 65 72 73 20 6f 66 20 70 49 6e 69 74 4d 75 74 sers of pInitMut
24080 65 78 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ex */. sqlite3_
24090 6d 75 74 65 78 20 2a 70 49 6e 69 74 4d 75 74 65 mutex *pInitMute
240a0 78 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 x; /* Mut
240b0 65 78 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 ex used by sqlit
240c0 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 e3_initialize()
240d0 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 4c 6f 67 */. void (*xLog
240e0 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 )(void*,int,cons
240f0 74 20 63 68 61 72 2a 29 3b 20 2f 2a 20 46 75 6e t char*); /* Fun
24100 63 74 69 6f 6e 20 66 6f 72 20 6c 6f 67 67 69 6e ction for loggin
24110 67 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4c 6f g */. void *pLo
24120 67 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 gArg;
24130 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
24140 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f irst argument to
24150 20 78 4c 6f 67 28 29 20 2a 2f 0a 23 69 66 64 65 xLog() */.#ifde
24160 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
24170 53 51 4c 4c 4f 47 0a 20 20 76 6f 69 64 28 2a 78 SQLLOG. void(*x
24180 53 71 6c 6c 6f 67 29 28 76 6f 69 64 2a 2c 73 71 Sqllog)(void*,sq
24190 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
241a0 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 r*, int);. void
241b0 20 2a 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 23 65 *pSqllogArg;.#e
241c0 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 ndif.#ifdef SQLI
241d0 54 45 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 TE_VDBE_COVERAGE
241e0 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
241f0 69 6e 67 20 63 61 6c 6c 62 61 63 6b 20 28 69 66 ing callback (if
24200 20 6e 6f 74 20 4e 55 4c 4c 29 20 69 73 20 69 6e not NULL) is in
24210 76 6f 6b 65 64 20 6f 6e 20 65 76 65 72 79 20 56 voked on every V
24220 44 42 45 20 62 72 61 6e 63 68 0a 20 20 2a 2a 20 DBE branch. **
24230 6f 70 65 72 61 74 69 6f 6e 2e 20 20 53 65 74 20 operation. Set
24240 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 75 73 69 the callback usi
24250 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ng SQLITE_TESTCT
24260 52 4c 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 RL_VDBE_COVERAGE
24270 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a .. */. void (*
24280 78 56 64 62 65 42 72 61 6e 63 68 29 28 76 6f 69 xVdbeBranch)(voi
24290 64 2a 2c 69 6e 74 20 69 53 72 63 4c 69 6e 65 2c d*,int iSrcLine,
242a0 75 38 20 65 54 68 69 73 2c 75 38 20 65 4d 78 29 u8 eThis,u8 eMx)
242b0 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 2a ; /* Callback *
242c0 2f 0a 20 20 76 6f 69 64 20 2a 70 56 64 62 65 42 /. void *pVdbeB
242d0 72 61 6e 63 68 41 72 67 3b 20 20 20 20 20 20 20 ranchArg;
242e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
242f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
24300 20 31 73 74 20 61 72 67 75 6d 65 6e 74 20 2a 2f 1st argument */
24310 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
24320 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
24330 45 0a 20 20 69 6e 74 20 28 2a 78 54 65 73 74 43 E. int (*xTestC
24340 61 6c 6c 62 61 63 6b 29 28 69 6e 74 29 3b 20 20 allback)(int);
24350 20 20 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 64 /* Invoked
24360 20 62 79 20 73 71 6c 69 74 65 33 46 61 75 6c 74 by sqlite3Fault
24370 53 69 6d 28 29 20 2a 2f 0a 23 65 6e 64 69 66 0a Sim() */.#endif.
24380 20 20 69 6e 74 20 62 4c 6f 63 61 6c 74 69 6d 65 int bLocaltime
24390 46 61 75 6c 74 3b 20 20 20 20 20 20 20 20 20 20 Fault;
243a0 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 66 /* True to f
243b0 61 69 6c 20 6c 6f 63 61 6c 74 69 6d 65 28 29 20 ail localtime()
243c0 63 61 6c 6c 73 20 2a 2f 0a 20 20 69 6e 74 20 69 calls */. int i
243d0 4f 6e 63 65 52 65 73 65 74 54 68 72 65 73 68 6f OnceResetThresho
243e0 6c 64 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ld; /*
243f0 57 68 65 6e 20 74 6f 20 72 65 73 65 74 20 4f 50 When to reset OP
24400 5f 4f 6e 63 65 20 63 6f 75 6e 74 65 72 73 20 2a _Once counters *
24410 2f 0a 20 20 75 33 32 20 73 7a 53 6f 72 74 65 72 /. u32 szSorter
24420 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 Ref;
24430 20 20 20 20 20 20 2f 2a 20 4d 69 6e 20 73 69 7a /* Min siz
24440 65 20 69 6e 20 62 79 74 65 73 20 74 6f 20 75 73 e in bytes to us
24450 65 20 73 6f 72 74 65 72 2d 72 65 66 73 20 2a 2f e sorter-refs */
24460 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .};../*.** This
24470 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 69 6e macro is used in
24480 73 69 64 65 20 6f 66 20 61 73 73 65 72 74 28 29 side of assert()
24490 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 69 statements to i
244a0 6e 64 69 63 61 74 65 20 74 68 61 74 0a 2a 2a 20 ndicate that.**
244b0 74 68 65 20 61 73 73 65 72 74 20 69 73 20 6f 6e the assert is on
244c0 6c 79 20 76 61 6c 69 64 20 6f 6e 20 61 20 77 65 ly valid on a we
244d0 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 ll-formed databa
244e0 73 65 2e 20 20 49 6e 73 74 65 61 64 20 6f 66 3a se. Instead of:
244f0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 73 73 65 72 .**.** asser
24500 74 28 20 58 20 29 3b 0a 2a 2a 0a 2a 2a 20 4f 6e t( X );.**.** On
24510 65 20 77 72 69 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 e writes:.**.**
24520 20 20 20 20 61 73 73 65 72 74 28 20 58 20 7c 7c assert( X ||
24530 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 2a CORRUPT_DB );.*
24540 2a 0a 2a 2a 20 43 4f 52 52 55 50 54 5f 44 42 20 *.** CORRUPT_DB
24550 69 73 20 74 72 75 65 20 64 75 72 69 6e 67 20 6e is true during n
24560 6f 72 6d 61 6c 20 6f 70 65 72 61 74 69 6f 6e 2e ormal operation.
24570 20 20 43 4f 52 52 55 50 54 5f 44 42 20 64 6f 65 CORRUPT_DB doe
24580 73 20 6e 6f 74 20 69 6e 64 69 63 61 74 65 0a 2a s not indicate.*
24590 2a 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 * that the datab
245a0 61 73 65 20 69 73 20 64 65 66 69 6e 69 74 65 6c ase is definitel
245b0 79 20 63 6f 72 72 75 70 74 2c 20 6f 6e 6c 79 20 y corrupt, only
245c0 74 68 61 74 20 69 74 20 6d 69 67 68 74 20 62 65 that it might be
245d0 20 63 6f 72 72 75 70 74 2e 0a 2a 2a 20 46 6f 72 corrupt..** For
245e0 20 6d 6f 73 74 20 74 65 73 74 20 63 61 73 65 73 most test cases
245f0 2c 20 43 4f 52 52 55 50 54 5f 44 42 20 69 73 20 , CORRUPT_DB is
24600 73 65 74 20 74 6f 20 66 61 6c 73 65 20 75 73 69 set to false usi
24610 6e 67 20 61 20 73 70 65 63 69 61 6c 0a 2a 2a 20 ng a special.**
24620 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
24630 74 72 6f 6c 28 29 2e 20 20 54 68 69 73 20 65 6e trol(). This en
24640 61 62 6c 65 73 20 61 73 73 65 72 74 28 29 20 73 ables assert() s
24650 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 70 72 6f tatements to pro
24660 76 65 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 ve.** things tha
24670 74 20 61 72 65 20 61 6c 77 61 79 73 20 74 72 75 t are always tru
24680 65 20 66 6f 72 20 77 65 6c 6c 2d 66 6f 72 6d 65 e for well-forme
24690 64 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a d databases..*/.
246a0 23 64 65 66 69 6e 65 20 43 4f 52 52 55 50 54 5f #define CORRUPT_
246b0 44 42 20 20 28 73 71 6c 69 74 65 33 43 6f 6e 66 DB (sqlite3Conf
246c0 69 67 2e 6e 65 76 65 72 43 6f 72 72 75 70 74 3d ig.neverCorrupt=
246d0 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 74 65 =0)../*.** Conte
246e0 78 74 20 70 6f 69 6e 74 65 72 20 70 61 73 73 65 xt pointer passe
246f0 64 20 64 6f 77 6e 20 74 68 72 6f 75 67 68 20 74 d down through t
24700 68 65 20 74 72 65 65 2d 77 61 6c 6b 2e 0a 2a 2f he tree-walk..*/
24710 0a 73 74 72 75 63 74 20 57 61 6c 6b 65 72 20 7b .struct Walker {
24720 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 . Parse *pParse
24730 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
24740 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24750 50 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 Parser context.
24760 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 45 78 70 */. int (*xExp
24770 72 43 61 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 rCallback)(Walke
24780 72 2a 2c 20 45 78 70 72 2a 29 3b 20 20 20 20 20 r*, Expr*);
24790 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 6f 72 20 /* Callback for
247a0 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
247b0 20 69 6e 74 20 28 2a 78 53 65 6c 65 63 74 43 61 int (*xSelectCa
247c0 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 72 2a 2c llback)(Walker*,
247d0 53 65 6c 65 63 74 2a 29 3b 20 20 2f 2a 20 43 61 Select*); /* Ca
247e0 6c 6c 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 43 llback for SELEC
247f0 54 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 Ts */. void (*x
24800 53 65 6c 65 63 74 43 61 6c 6c 62 61 63 6b 32 29 SelectCallback2)
24810 28 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 63 74 2a (Walker*,Select*
24820 29 3b 2f 2a 20 53 65 63 6f 6e 64 20 63 61 6c 6c );/* Second call
24830 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 43 54 73 back for SELECTs
24840 20 2a 2f 0a 20 20 69 6e 74 20 77 61 6c 6b 65 72 */. int walker
24850 44 65 70 74 68 3b 20 20 20 20 20 20 20 20 20 20 Depth;
24860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24870 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 75 62 /* Number of sub
24880 71 75 65 72 69 65 73 20 2a 2f 0a 20 20 75 38 20 queries */. u8
24890 65 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 eCode;
248a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
248b0 20 20 20 20 20 20 20 2f 2a 20 41 20 73 6d 61 6c /* A smal
248c0 6c 20 70 72 6f 63 65 73 73 69 6e 67 20 63 6f 64 l processing cod
248d0 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 20 20 e */. union {
248e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
248f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24900 20 2f 2a 20 45 78 74 72 61 20 64 61 74 61 20 66 /* Extra data f
24910 6f 72 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 or callback */.
24920 20 20 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 2a NameContext *
24930 70 4e 43 3b 20 20 20 20 20 20 20 20 20 20 20 20 pNC;
24940 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24950 4e 61 6d 69 6e 67 20 63 6f 6e 74 65 78 74 20 2a Naming context *
24960 2f 0a 20 20 20 20 69 6e 74 20 6e 3b 20 20 20 20 /. int n;
24970 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24980 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24990 2f 2a 20 41 20 63 6f 75 6e 74 65 72 20 2a 2f 0a /* A counter */.
249a0 20 20 20 20 69 6e 74 20 69 43 75 72 3b 20 20 20 int iCur;
249b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
249c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
249d0 20 41 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 A cursor number
249e0 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 73 74 20 */. SrcList
249f0 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 20 20 20 *pSrcList;
24a00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24a10 20 20 2f 2a 20 46 52 4f 4d 20 63 6c 61 75 73 65 /* FROM clause
24a20 20 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 53 */. struct S
24a30 72 63 43 6f 75 6e 74 20 2a 70 53 72 63 43 6f 75 rcCount *pSrcCou
24a40 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nt;
24a50 20 20 2f 2a 20 43 6f 75 6e 74 69 6e 67 20 63 6f /* Counting co
24a60 6c 75 6d 6e 20 72 65 66 65 72 65 6e 63 65 73 20 lumn references
24a70 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 43 43 */. struct CC
24a80 75 72 48 69 6e 74 20 2a 70 43 43 75 72 48 69 6e urHint *pCCurHin
24a90 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
24aa0 20 2f 2a 20 55 73 65 64 20 62 79 20 63 6f 64 65 /* Used by code
24ab0 43 75 72 73 6f 72 48 69 6e 74 28 29 20 2a 2f 0a CursorHint() */.
24ac0 20 20 20 20 69 6e 74 20 2a 61 69 43 6f 6c 3b 20 int *aiCol;
24ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
24af0 20 61 72 72 61 79 20 6f 66 20 63 6f 6c 75 6d 6e array of column
24b00 20 69 6e 64 65 78 65 73 20 2a 2f 0a 20 20 20 20 indexes */.
24b10 73 74 72 75 63 74 20 49 64 78 43 6f 76 65 72 20 struct IdxCover
24b20 2a 70 49 64 78 43 6f 76 65 72 3b 20 20 20 20 20 *pIdxCover;
24b30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 68 65 /* Che
24b40 63 6b 20 66 6f 72 20 69 6e 64 65 78 20 63 6f 76 ck for index cov
24b50 65 72 61 67 65 20 2a 2f 0a 20 20 20 20 73 74 72 erage */. str
24b60 75 63 74 20 49 64 78 45 78 70 72 54 72 61 6e 73 uct IdxExprTrans
24b70 20 2a 70 49 64 78 54 72 61 6e 73 3b 20 20 20 20 *pIdxTrans;
24b80 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 76 65 72 /* Conver
24b90 74 20 69 64 78 65 64 20 65 78 70 72 20 74 6f 20 t idxed expr to
24ba0 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 20 20 45 78 column */. Ex
24bb0 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 79 prList *pGroupBy
24bc0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
24bd0 20 20 20 20 20 20 20 20 2f 2a 20 47 52 4f 55 50 /* GROUP
24be0 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 BY clause */.
24bf0 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 Select *pSelec
24c00 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
24c10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 /* H
24c20 41 56 49 4e 47 20 74 6f 20 57 48 45 52 45 20 63 AVING to WHERE c
24c30 6c 61 75 73 65 20 63 74 78 20 2a 2f 0a 20 20 7d lause ctx */. }
24c40 20 75 3b 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 u;.};../* Forwa
24c50 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 rd declarations
24c60 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 */.int sqlite3Wa
24c70 6c 6b 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 lkExpr(Walker*,
24c80 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Expr*);.int sqli
24c90 74 65 33 57 61 6c 6b 45 78 70 72 4c 69 73 74 28 te3WalkExprList(
24ca0 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 4c 69 73 Walker*, ExprLis
24cb0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
24cc0 57 61 6c 6b 53 65 6c 65 63 74 28 57 61 6c 6b 65 WalkSelect(Walke
24cd0 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e r*, Select*);.in
24ce0 74 20 73 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c t sqlite3WalkSel
24cf0 65 63 74 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c ectExpr(Walker*,
24d00 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 Select*);.int s
24d10 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 qlite3WalkSelect
24d20 46 72 6f 6d 28 57 61 6c 6b 65 72 2a 2c 20 53 65 From(Walker*, Se
24d30 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 lect*);.int sqli
24d40 74 65 33 45 78 70 72 57 61 6c 6b 4e 6f 6f 70 28 te3ExprWalkNoop(
24d50 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 2a 29 3b Walker*, Expr*);
24d60 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 65 6c 65 .int sqlite3Sele
24d70 63 74 57 61 6c 6b 4e 6f 6f 70 28 57 61 6c 6b 65 ctWalkNoop(Walke
24d80 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e r*, Select*);.in
24d90 74 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 57 t sqlite3SelectW
24da0 61 6c 6b 46 61 69 6c 28 57 61 6c 6b 65 72 2a 2c alkFail(Walker*,
24db0 20 53 65 6c 65 63 74 2a 29 3b 0a 23 69 66 64 65 Select*);.#ifde
24dc0 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 76 f SQLITE_DEBUG.v
24dd0 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 oid sqlite3Selec
24de0 74 57 61 6c 6b 41 73 73 65 72 74 32 28 57 61 6c tWalkAssert2(Wal
24df0 6b 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a ker*, Select*);.
24e00 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 #endif../*.** Re
24e10 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 74 turn code from t
24e20 68 65 20 70 61 72 73 65 2d 74 72 65 65 20 77 61 he parse-tree wa
24e30 6c 6b 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 lking primitives
24e40 20 61 6e 64 20 74 68 65 69 72 0a 2a 2a 20 63 61 and their.** ca
24e50 6c 6c 62 61 63 6b 73 2e 0a 2a 2f 0a 23 64 65 66 llbacks..*/.#def
24e60 69 6e 65 20 57 52 43 5f 43 6f 6e 74 69 6e 75 65 ine WRC_Continue
24e70 20 20 20 20 30 20 20 20 2f 2a 20 43 6f 6e 74 69 0 /* Conti
24e80 6e 75 65 20 64 6f 77 6e 20 69 6e 74 6f 20 63 68 nue down into ch
24e90 69 6c 64 72 65 6e 20 2a 2f 0a 23 64 65 66 69 6e ildren */.#defin
24ea0 65 20 57 52 43 5f 50 72 75 6e 65 20 20 20 20 20 e WRC_Prune
24eb0 20 20 31 20 20 20 2f 2a 20 4f 6d 69 74 20 63 68 1 /* Omit ch
24ec0 69 6c 64 72 65 6e 20 62 75 74 20 63 6f 6e 74 69 ildren but conti
24ed0 6e 75 65 20 77 61 6c 6b 69 6e 67 20 73 69 62 6c nue walking sibl
24ee0 69 6e 67 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ings */.#define
24ef0 57 52 43 5f 41 62 6f 72 74 20 20 20 20 20 20 20 WRC_Abort
24f00 32 20 20 20 2f 2a 20 41 62 61 6e 64 6f 6e 20 74 2 /* Abandon t
24f10 68 65 20 74 72 65 65 20 77 61 6c 6b 20 2a 2f 0a he tree walk */.
24f20 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
24f30 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 ce of this struc
24f40 74 75 72 65 20 72 65 70 72 65 73 65 6e 74 73 20 ture represents
24f50 61 20 73 65 74 20 6f 66 20 6f 6e 65 20 6f 72 20 a set of one or
24f60 6d 6f 72 65 20 43 54 45 73 0a 2a 2a 20 28 63 6f more CTEs.** (co
24f70 6d 6d 6f 6e 20 74 61 62 6c 65 20 65 78 70 72 65 mmon table expre
24f80 73 73 69 6f 6e 73 29 20 63 72 65 61 74 65 64 20 ssions) created
24f90 62 79 20 61 20 73 69 6e 67 6c 65 20 57 49 54 48 by a single WITH
24fa0 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 72 75 clause..*/.stru
24fb0 63 74 20 57 69 74 68 20 7b 0a 20 20 69 6e 74 20 ct With {. int
24fc0 6e 43 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 nCte;
24fd0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
24fe0 75 6d 62 65 72 20 6f 66 20 43 54 45 73 20 69 6e umber of CTEs in
24ff0 20 74 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 the WITH clause
25000 20 2a 2f 0a 20 20 57 69 74 68 20 2a 70 4f 75 74 */. With *pOut
25010 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 er;
25020 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 61 69 6e /* Contain
25030 69 6e 67 20 57 49 54 48 20 63 6c 61 75 73 65 2c ing WITH clause,
25040 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 73 74 or NULL */. st
25050 72 75 63 74 20 43 74 65 20 7b 20 20 20 20 20 20 ruct Cte {
25060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
25070 20 46 6f 72 20 65 61 63 68 20 43 54 45 20 69 6e For each CTE in
25080 20 74 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 the WITH clause
25090 2e 2e 2e 2e 20 2a 2f 0a 20 20 20 20 63 68 61 72 .... */. char
250a0 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 *zName;
250b0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
250c0 61 6d 65 20 6f 66 20 74 68 69 73 20 43 54 45 20 ame of this CTE
250d0 2a 2f 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 */. ExprList
250e0 2a 70 43 6f 6c 73 3b 20 20 20 20 20 20 20 20 20 *pCols;
250f0 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
25100 66 20 65 78 70 6c 69 63 69 74 20 63 6f 6c 75 6d f explicit colum
25110 6e 20 6e 61 6d 65 73 2c 20 6f 72 20 4e 55 4c 4c n names, or NULL
25120 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a */. Select *
25130 70 53 65 6c 65 63 74 3b 20 20 20 20 20 20 20 20 pSelect;
25140 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 /* The d
25150 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 69 efinition of thi
25160 73 20 43 54 45 20 2a 2f 0a 20 20 20 20 63 6f 6e s CTE */. con
25170 73 74 20 63 68 61 72 20 2a 7a 43 74 65 45 72 72 st char *zCteErr
25180 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
25190 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 6f Error message fo
251a0 72 20 63 69 72 63 75 6c 61 72 20 72 65 66 65 72 r circular refer
251b0 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 61 5b 31 ences */. } a[1
251c0 5d 3b 0a 7d 3b 0a 0a 23 69 66 64 65 66 20 53 51 ];.};..#ifdef SQ
251d0 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a LITE_DEBUG./*.**
251e0 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
251f0 74 68 65 20 54 72 65 65 56 69 65 77 20 6f 62 6a the TreeView obj
25200 65 63 74 20 69 73 20 75 73 65 64 20 66 6f 72 20 ect is used for
25210 70 72 69 6e 74 69 6e 67 20 74 68 65 20 63 6f 6e printing the con
25220 74 65 6e 74 20 6f 66 0a 2a 2a 20 64 61 74 61 20 tent of.** data
25230 73 74 72 75 63 74 75 72 65 73 20 6f 6e 20 73 71 structures on sq
25240 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 lite3DebugPrintf
25250 28 29 20 75 73 69 6e 67 20 61 20 74 72 65 65 2d () using a tree-
25260 6c 69 6b 65 20 76 69 65 77 2e 0a 2a 2f 0a 73 74 like view..*/.st
25270 72 75 63 74 20 54 72 65 65 56 69 65 77 20 7b 0a ruct TreeView {.
25280 20 20 69 6e 74 20 69 4c 65 76 65 6c 3b 20 20 20 int iLevel;
25290 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 /* Whi
252a0 63 68 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 ch level of the
252b0 74 72 65 65 20 77 65 20 61 72 65 20 6f 6e 20 2a tree we are on *
252c0 2f 0a 20 20 75 38 20 20 62 4c 69 6e 65 5b 31 30 /. u8 bLine[10
252d0 30 5d 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 44 0]; /* D
252e0 72 61 77 20 76 65 72 74 69 63 61 6c 20 69 6e 20 raw vertical in
252f0 63 6f 6c 75 6d 6e 20 69 20 69 66 20 62 4c 69 6e column i if bLin
25300 65 5b 69 5d 20 69 73 20 74 72 75 65 20 2a 2f 0a e[i] is true */.
25310 7d 3b 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c };.#endif /* SQL
25320 49 54 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a ITE_DEBUG */../*
25330 0a 2a 2a 20 41 73 73 75 6d 69 6e 67 20 7a 49 6e .** Assuming zIn
25340 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 66 points to the f
25350 69 72 73 74 20 62 79 74 65 20 6f 66 20 61 20 55 irst byte of a U
25360 54 46 2d 38 20 63 68 61 72 61 63 74 65 72 2c 0a TF-8 character,.
25370 2a 2a 20 61 64 76 61 6e 63 65 20 7a 49 6e 20 74 ** advance zIn t
25380 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 o point to the f
25390 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 irst byte of the
253a0 20 6e 65 78 74 20 55 54 46 2d 38 20 63 68 61 72 next UTF-8 char
253b0 61 63 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e acter..*/.#defin
253c0 65 20 53 51 4c 49 54 45 5f 53 4b 49 50 5f 55 54 e SQLITE_SKIP_UT
253d0 46 38 28 7a 49 6e 29 20 7b 20 20 20 20 20 20 20 F8(zIn) {
253e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
253f0 20 5c 0a 20 20 69 66 28 20 28 2a 28 7a 49 6e 2b \. if( (*(zIn+
25400 2b 29 29 3e 3d 30 78 63 30 20 29 7b 20 20 20 20 +))>=0xc0 ){
25410 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25420 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 20 \.
25430 77 68 69 6c 65 28 20 28 2a 7a 49 6e 20 26 20 30 while( (*zIn & 0
25440 78 63 30 29 3d 3d 30 78 38 30 20 29 7b 20 7a 49 xc0)==0x80 ){ zI
25450 6e 2b 2b 3b 20 7d 20 20 20 20 20 20 20 20 20 20 n++; }
25460 20 20 20 5c 0a 20 20 7d 20 20 20 20 20 20 20 20 \. }
25470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25490 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 7d 0a \.}.
254a0 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 ./*.** The SQLIT
254b0 45 5f 2a 5f 42 4b 50 54 20 6d 61 63 72 6f 73 20 E_*_BKPT macros
254c0 61 72 65 20 73 75 62 73 74 69 74 75 74 65 73 20 are substitutes
254d0 66 6f 72 20 74 68 65 20 65 72 72 6f 72 20 63 6f for the error co
254e0 64 65 73 20 77 69 74 68 0a 2a 2a 20 74 68 65 20 des with.** the
254f0 73 61 6d 65 20 6e 61 6d 65 20 62 75 74 20 77 69 same name but wi
25500 74 68 6f 75 74 20 74 68 65 20 5f 42 4b 50 54 20 thout the _BKPT
25510 73 75 66 66 69 78 2e 20 20 54 68 65 73 65 20 6d suffix. These m
25520 61 63 72 6f 73 20 69 6e 76 6f 6b 65 0a 2a 2a 20 acros invoke.**
25530 72 6f 75 74 69 6e 65 73 20 74 68 61 74 20 72 65 routines that re
25540 70 6f 72 74 20 74 68 65 20 6c 69 6e 65 2d 6e 75 port the line-nu
25550 6d 62 65 72 20 6f 6e 20 77 68 69 63 68 20 74 68 mber on which th
25560 65 20 65 72 72 6f 72 20 6f 72 69 67 69 6e 61 74 e error originat
25570 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 ed.** using sqli
25580 74 65 33 5f 6c 6f 67 28 29 2e 20 20 54 68 65 20 te3_log(). The
25590 72 6f 75 74 69 6e 65 73 20 61 6c 73 6f 20 70 72 routines also pr
255a0 6f 76 69 64 65 20 61 20 63 6f 6e 76 65 6e 69 65 ovide a convenie
255b0 6e 74 20 70 6c 61 63 65 0a 2a 2a 20 74 6f 20 73 nt place.** to s
255c0 65 74 20 61 20 64 65 62 75 67 67 65 72 20 62 72 et a debugger br
255d0 65 61 6b 70 6f 69 6e 74 2e 0a 2a 2f 0a 69 6e 74 eakpoint..*/.int
255e0 20 73 71 6c 69 74 65 33 52 65 70 6f 72 74 45 72 sqlite3ReportEr
255f0 72 6f 72 28 69 6e 74 20 69 45 72 72 2c 20 69 6e ror(int iErr, in
25600 74 20 6c 69 6e 65 6e 6f 2c 20 63 6f 6e 73 74 20 t lineno, const
25610 63 68 61 72 20 2a 7a 54 79 70 65 29 3b 0a 69 6e char *zType);.in
25620 74 20 73 71 6c 69 74 65 33 43 6f 72 72 75 70 74 t sqlite3Corrupt
25630 45 72 72 6f 72 28 69 6e 74 29 3b 0a 69 6e 74 20 Error(int);.int
25640 73 71 6c 69 74 65 33 4d 69 73 75 73 65 45 72 72 sqlite3MisuseErr
25650 6f 72 28 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c or(int);.int sql
25660 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f ite3CantopenErro
25670 72 28 69 6e 74 29 3b 0a 23 64 65 66 69 6e 65 20 r(int);.#define
25680 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
25690 4b 50 54 20 73 71 6c 69 74 65 33 43 6f 72 72 75 KPT sqlite3Corru
256a0 70 74 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f ptError(__LINE__
256b0 29 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 ).#define SQLITE
256c0 5f 4d 49 53 55 53 45 5f 42 4b 50 54 20 73 71 6c _MISUSE_BKPT sql
256d0 69 74 65 33 4d 69 73 75 73 65 45 72 72 6f 72 28 ite3MisuseError(
256e0 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e __LINE__).#defin
256f0 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 e SQLITE_CANTOPE
25700 4e 5f 42 4b 50 54 20 73 71 6c 69 74 65 33 43 61 N_BKPT sqlite3Ca
25710 6e 74 6f 70 65 6e 45 72 72 6f 72 28 5f 5f 4c 49 ntopenError(__LI
25720 4e 45 5f 5f 29 0a 23 69 66 64 65 66 20 53 51 4c NE__).#ifdef SQL
25730 49 54 45 5f 44 45 42 55 47 0a 20 20 69 6e 74 20 ITE_DEBUG. int
25740 73 71 6c 69 74 65 33 4e 6f 6d 65 6d 45 72 72 6f sqlite3NomemErro
25750 72 28 69 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 r(int);. int sq
25760 6c 69 74 65 33 49 6f 65 72 72 6e 6f 6d 65 6d 45 lite3IoerrnomemE
25770 72 72 6f 72 28 69 6e 74 29 3b 0a 20 20 69 6e 74 rror(int);. int
25780 20 73 71 6c 69 74 65 33 43 6f 72 72 75 70 74 50 sqlite3CorruptP
25790 67 6e 6f 45 72 72 6f 72 28 69 6e 74 2c 50 67 6e gnoError(int,Pgn
257a0 6f 29 3b 0a 23 20 64 65 66 69 6e 65 20 53 51 4c o);.# define SQL
257b0 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 73 ITE_NOMEM_BKPT s
257c0 71 6c 69 74 65 33 4e 6f 6d 65 6d 45 72 72 6f 72 qlite3NomemError
257d0 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 20 64 65 66 (__LINE__).# def
257e0 69 6e 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 ine SQLITE_IOERR
257f0 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 73 71 6c 69 _NOMEM_BKPT sqli
25800 74 65 33 49 6f 65 72 72 6e 6f 6d 65 6d 45 72 72 te3IoerrnomemErr
25810 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 20 64 or(__LINE__).# d
25820 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 4f 52 efine SQLITE_COR
25830 52 55 50 54 5f 50 47 4e 4f 28 50 29 20 73 71 6c RUPT_PGNO(P) sql
25840 69 74 65 33 43 6f 72 72 75 70 74 50 67 6e 6f 45 ite3CorruptPgnoE
25850 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 2c 28 50 rror(__LINE__,(P
25860 29 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e )).#else.# defin
25870 65 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 e SQLITE_NOMEM_B
25880 4b 50 54 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d KPT SQLITE_NOMEM
25890 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
258a0 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 5f 42 4b 50 _IOERR_NOMEM_BKP
258b0 54 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e T SQLITE_IOERR_N
258c0 4f 4d 45 4d 0a 23 20 64 65 66 69 6e 65 20 53 51 OMEM.# define SQ
258d0 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 50 47 4e LITE_CORRUPT_PGN
258e0 4f 28 50 29 20 73 71 6c 69 74 65 33 43 6f 72 72 O(P) sqlite3Corr
258f0 75 70 74 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f uptError(__LINE_
25900 5f 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a _).#endif../*.**
25910 20 46 54 53 33 20 61 6e 64 20 46 54 53 34 20 62 FTS3 and FTS4 b
25920 6f 74 68 20 72 65 71 75 69 72 65 20 76 69 72 74 oth require virt
25930 75 61 6c 20 74 61 62 6c 65 20 73 75 70 70 6f 72 ual table suppor
25940 74 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 t.*/.#if defined
25950 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 (SQLITE_OMIT_VIR
25960 54 55 41 4c 54 41 42 4c 45 29 0a 23 20 75 6e 64 TUALTABLE).# und
25970 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
25980 5f 46 54 53 33 0a 23 20 75 6e 64 65 66 20 53 51 _FTS3.# undef SQ
25990 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 LITE_ENABLE_FTS4
259a0 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 .#endif../*.** F
259b0 54 53 34 20 69 73 20 72 65 61 6c 6c 79 20 61 6e TS4 is really an
259c0 20 65 78 74 65 6e 73 69 6f 6e 20 66 6f 72 20 46 extension for F
259d0 54 53 33 2e 20 20 49 74 20 69 73 20 65 6e 61 62 TS3. It is enab
259e0 6c 65 64 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a led using the.**
259f0 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
25a00 54 53 33 20 6d 61 63 72 6f 2e 20 20 42 75 74 20 TS3 macro. But
25a10 74 6f 20 61 76 6f 69 64 20 63 6f 6e 66 75 73 69 to avoid confusi
25a20 6f 6e 20 77 65 20 61 6c 73 6f 20 63 61 6c 6c 0a on we also call.
25a30 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e ** the SQLITE_EN
25a40 41 42 4c 45 5f 46 54 53 34 20 6d 61 63 72 6f 20 ABLE_FTS4 macro
25a50 74 6f 20 73 65 72 76 65 20 61 73 20 61 6e 20 61 to serve as an a
25a60 6c 69 61 73 20 66 6f 72 20 53 51 4c 49 54 45 5f lias for SQLITE_
25a70 45 4e 41 42 4c 45 5f 46 54 53 33 2e 0a 2a 2f 0a ENABLE_FTS3..*/.
25a80 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
25a90 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 29 20 TE_ENABLE_FTS4)
25aa0 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
25ab0 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 29 0a TE_ENABLE_FTS3).
25ac0 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
25ad0 45 4e 41 42 4c 45 5f 46 54 53 33 20 31 0a 23 65 ENABLE_FTS3 1.#e
25ae0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
25af0 63 74 79 70 65 2e 68 20 68 65 61 64 65 72 20 69 ctype.h header i
25b00 73 20 6e 65 65 64 65 64 20 66 6f 72 20 6e 6f 6e s needed for non
25b10 2d 41 53 43 49 49 20 73 79 73 74 65 6d 73 2e 20 -ASCII systems.
25b20 20 49 74 20 69 73 20 61 6c 73 6f 0a 2a 2a 20 6e It is also.** n
25b30 65 65 64 65 64 20 62 79 20 46 54 53 33 20 77 68 eeded by FTS3 wh
25b40 65 6e 20 46 54 53 33 20 69 73 20 69 6e 63 6c 75 en FTS3 is inclu
25b50 64 65 64 20 69 6e 20 74 68 65 20 61 6d 61 6c 67 ded in the amalg
25b60 61 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 amation..*/.#if
25b70 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
25b80 41 53 43 49 49 29 20 7c 7c 20 5c 0a 20 20 20 20 ASCII) || \.
25b90 28 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f (defined(SQLITE_
25ba0 45 4e 41 42 4c 45 5f 46 54 53 33 29 20 26 26 20 ENABLE_FTS3) &&
25bb0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 41 defined(SQLITE_A
25bc0 4d 41 4c 47 41 4d 41 54 49 4f 4e 29 29 0a 23 20 MALGAMATION)).#
25bd0 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 include <ctype.h
25be0 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 >.#endif../*.**
25bf0 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 The following ma
25c00 63 72 6f 73 20 6d 69 6d 69 63 20 74 68 65 20 73 cros mimic the s
25c10 74 61 6e 64 61 72 64 20 6c 69 62 72 61 72 79 20 tandard library
25c20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 75 70 70 65 functions touppe
25c30 72 28 29 2c 0a 2a 2a 20 69 73 73 70 61 63 65 28 r(),.** isspace(
25c40 29 2c 20 69 73 61 6c 6e 75 6d 28 29 2c 20 69 73 ), isalnum(), is
25c50 64 69 67 69 74 28 29 20 61 6e 64 20 69 73 78 64 digit() and isxd
25c60 69 67 69 74 28 29 2c 20 72 65 73 70 65 63 74 69 igit(), respecti
25c70 76 65 6c 79 2e 20 54 68 65 0a 2a 2a 20 73 71 6c vely. The.** sql
25c80 69 74 65 20 76 65 72 73 69 6f 6e 73 20 6f 6e 6c ite versions onl
25c90 79 20 77 6f 72 6b 20 66 6f 72 20 41 53 43 49 49 y work for ASCII
25ca0 20 63 68 61 72 61 63 74 65 72 73 2c 20 72 65 67 characters, reg
25cb0 61 72 64 6c 65 73 73 20 6f 66 20 6c 6f 63 61 6c ardless of local
25cc0 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c e..*/.#ifdef SQL
25cd0 49 54 45 5f 41 53 43 49 49 0a 23 20 64 65 66 69 ITE_ASCII.# defi
25ce0 6e 65 20 73 71 6c 69 74 65 33 54 6f 75 70 70 65 ne sqlite3Touppe
25cf0 72 28 78 29 20 20 28 28 78 29 26 7e 28 73 71 6c r(x) ((x)&~(sql
25d00 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e ite3CtypeMap[(un
25d10 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d signed char)(x)]
25d20 26 30 78 32 30 29 29 0a 23 20 64 65 66 69 6e 65 &0x20)).# define
25d30 20 73 71 6c 69 74 65 33 49 73 73 70 61 63 65 28 sqlite3Isspace(
25d40 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 x) (sqlite3Cty
25d50 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
25d60 63 68 61 72 29 28 78 29 5d 26 30 78 30 31 29 0a char)(x)]&0x01).
25d70 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
25d80 49 73 61 6c 6e 75 6d 28 78 29 20 20 20 28 73 71 Isalnum(x) (sq
25d90 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
25da0 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
25db0 5d 26 30 78 30 36 29 0a 23 20 64 65 66 69 6e 65 ]&0x06).# define
25dc0 20 73 71 6c 69 74 65 33 49 73 61 6c 70 68 61 28 sqlite3Isalpha(
25dd0 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 x) (sqlite3Cty
25de0 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
25df0 63 68 61 72 29 28 78 29 5d 26 30 78 30 32 29 0a char)(x)]&0x02).
25e00 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
25e10 49 73 64 69 67 69 74 28 78 29 20 20 20 28 73 71 Isdigit(x) (sq
25e20 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
25e30 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
25e40 5d 26 30 78 30 34 29 0a 23 20 64 65 66 69 6e 65 ]&0x04).# define
25e50 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 sqlite3Isxdigit
25e60 28 78 29 20 20 28 73 71 6c 69 74 65 33 43 74 79 (x) (sqlite3Cty
25e70 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
25e80 63 68 61 72 29 28 78 29 5d 26 30 78 30 38 29 0a char)(x)]&0x08).
25e90 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
25ea0 54 6f 6c 6f 77 65 72 28 78 29 20 20 20 28 73 71 Tolower(x) (sq
25eb0 6c 69 74 65 33 55 70 70 65 72 54 6f 4c 6f 77 65 lite3UpperToLowe
25ec0 72 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 r[(unsigned char
25ed0 29 28 78 29 5d 29 0a 23 20 64 65 66 69 6e 65 20 )(x)]).# define
25ee0 73 71 6c 69 74 65 33 49 73 71 75 6f 74 65 28 78 sqlite3Isquote(x
25ef0 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 ) (sqlite3Ctyp
25f00 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 eMap[(unsigned c
25f10 68 61 72 29 28 78 29 5d 26 30 78 38 30 29 0a 23 har)(x)]&0x80).#
25f20 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
25f30 6c 69 74 65 33 54 6f 75 70 70 65 72 28 78 29 20 lite3Toupper(x)
25f40 20 20 74 6f 75 70 70 65 72 28 28 75 6e 73 69 67 toupper((unsig
25f50 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 ned char)(x)).#
25f60 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 define sqlite3Is
25f70 73 70 61 63 65 28 78 29 20 20 20 69 73 73 70 61 space(x) isspa
25f80 63 65 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ce((unsigned cha
25f90 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 r)(x)).# define
25fa0 73 71 6c 69 74 65 33 49 73 61 6c 6e 75 6d 28 78 sqlite3Isalnum(x
25fb0 29 20 20 20 69 73 61 6c 6e 75 6d 28 28 75 6e 73 ) isalnum((uns
25fc0 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a igned char)(x)).
25fd0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
25fe0 49 73 61 6c 70 68 61 28 78 29 20 20 20 69 73 61 Isalpha(x) isa
25ff0 6c 70 68 61 28 28 75 6e 73 69 67 6e 65 64 20 63 lpha((unsigned c
26000 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e har)(x)).# defin
26010 65 20 73 71 6c 69 74 65 33 49 73 64 69 67 69 74 e sqlite3Isdigit
26020 28 78 29 20 20 20 69 73 64 69 67 69 74 28 28 75 (x) isdigit((u
26030 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
26040 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
26050 65 33 49 73 78 64 69 67 69 74 28 78 29 20 20 69 e3Isxdigit(x) i
26060 73 78 64 69 67 69 74 28 28 75 6e 73 69 67 6e 65 sxdigit((unsigne
26070 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 d char)(x)).# de
26080 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f 6c 6f fine sqlite3Tolo
26090 77 65 72 28 78 29 20 20 20 74 6f 6c 6f 77 65 72 wer(x) tolower
260a0 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 ((unsigned char)
260b0 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 (x)).# define sq
260c0 6c 69 74 65 33 49 73 71 75 6f 74 65 28 78 29 20 lite3Isquote(x)
260d0 20 20 28 28 78 29 3d 3d 27 22 27 7c 7c 28 78 29 ((x)=='"'||(x)
260e0 3d 3d 27 5c 27 27 7c 7c 28 78 29 3d 3d 27 5b 27 =='\''||(x)=='['
260f0 7c 7c 28 78 29 3d 3d 27 60 27 29 0a 23 65 6e 64 ||(x)=='`').#end
26100 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
26110 45 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c 45 4f 50 E_OMIT_COMPILEOP
26120 54 49 4f 4e 5f 44 49 41 47 53 0a 69 6e 74 20 73 TION_DIAGS.int s
26130 71 6c 69 74 65 33 49 73 49 64 43 68 61 72 28 75 qlite3IsIdChar(u
26140 38 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 8);.#endif../*.*
26150 2a 20 49 6e 74 65 72 6e 61 6c 20 66 75 6e 63 74 * Internal funct
26160 69 6f 6e 20 70 72 6f 74 6f 74 79 70 65 73 0a 2a ion prototypes.*
26170 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 72 /.int sqlite3Str
26180 49 43 6d 70 28 63 6f 6e 73 74 20 63 68 61 72 2a ICmp(const char*
26190 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 ,const char*);.i
261a0 6e 74 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e nt sqlite3Strlen
261b0 33 30 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 30(const char*);
261c0 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 43 6f .char *sqlite3Co
261d0 6c 75 6d 6e 54 79 70 65 28 43 6f 6c 75 6d 6e 2a lumnType(Column*
261e0 2c 63 68 61 72 2a 29 3b 0a 23 64 65 66 69 6e 65 ,char*);.#define
261f0 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 sqlite3StrNICmp
26200 20 73 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d sqlite3_strnicm
26210 70 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 p..int sqlite3Ma
26220 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 29 3b 0a llocInit(void);.
26230 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c void sqlite3Mall
26240 6f 63 45 6e 64 28 76 6f 69 64 29 3b 0a 76 6f 69 ocEnd(void);.voi
26250 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 d *sqlite3Malloc
26260 28 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c (u64);.void *sql
26270 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 75 ite3MallocZero(u
26280 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 64);.void *sqlit
26290 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 e3DbMallocZero(s
262a0 71 6c 69 74 65 33 2a 2c 20 75 36 34 29 3b 0a 76 qlite3*, u64);.v
262b0 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 oid *sqlite3DbMa
262c0 6c 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33 2a llocRaw(sqlite3*
262d0 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 , u64);.void *sq
262e0 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 lite3DbMallocRaw
262f0 4e 4e 28 73 71 6c 69 74 65 33 2a 2c 20 75 36 34 NN(sqlite3*, u64
26300 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
26310 44 62 53 74 72 44 75 70 28 73 71 6c 69 74 65 33 DbStrDup(sqlite3
26320 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a *,const char*);.
26330 63 68 61 72 20 2a 73 71 6c 69 74 65 33 44 62 53 char *sqlite3DbS
26340 74 72 4e 44 75 70 28 73 71 6c 69 74 65 33 2a 2c trNDup(sqlite3*,
26350 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 75 36 34 const char*, u64
26360 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
26370 44 62 53 70 61 6e 44 75 70 28 73 71 6c 69 74 65 DbSpanDup(sqlite
26380 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 3*,const char*,c
26390 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 onst char*);.voi
263a0 64 20 2a 73 71 6c 69 74 65 33 52 65 61 6c 6c 6f d *sqlite3Reallo
263b0 63 28 76 6f 69 64 2a 2c 20 75 36 34 29 3b 0a 76 c(void*, u64);.v
263c0 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 52 65 oid *sqlite3DbRe
263d0 61 6c 6c 6f 63 4f 72 46 72 65 65 28 73 71 6c 69 allocOrFree(sqli
263e0 74 65 33 20 2a 2c 20 76 6f 69 64 20 2a 2c 20 75 te3 *, void *, u
263f0 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 64);.void *sqlit
26400 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 71 6c 69 e3DbRealloc(sqli
26410 74 65 33 20 2a 2c 20 76 6f 69 64 20 2a 2c 20 75 te3 *, void *, u
26420 36 34 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 64);.void sqlite
26430 33 44 62 46 72 65 65 28 73 71 6c 69 74 65 33 2a 3DbFree(sqlite3*
26440 2c 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 , void*);.void s
26450 71 6c 69 74 65 33 44 62 46 72 65 65 4e 4e 28 73 qlite3DbFreeNN(s
26460 71 6c 69 74 65 33 2a 2c 20 76 6f 69 64 2a 29 3b qlite3*, void*);
26470 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 6c 6c .int sqlite3Mall
26480 6f 63 53 69 7a 65 28 76 6f 69 64 2a 29 3b 0a 69 ocSize(void*);.i
26490 6e 74 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c nt sqlite3DbMall
264a0 6f 63 53 69 7a 65 28 73 71 6c 69 74 65 33 2a 2c ocSize(sqlite3*,
264b0 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 2a 73 void*);.void *s
264c0 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 qlite3PageMalloc
264d0 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 (int);.void sqli
264e0 74 65 33 50 61 67 65 46 72 65 65 28 76 6f 69 64 te3PageFree(void
264f0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
26500 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 28 76 6f MemSetDefault(vo
26510 69 64 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c id);.#ifndef SQL
26520 49 54 45 5f 55 4e 54 45 53 54 41 42 4c 45 0a 76 ITE_UNTESTABLE.v
26530 6f 69 64 20 73 71 6c 69 74 65 33 42 65 6e 69 67 oid sqlite3Benig
26540 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 76 6f 69 nMallocHooks(voi
26550 64 20 28 2a 29 28 76 6f 69 64 29 2c 20 76 6f 69 d (*)(void), voi
26560 64 20 28 2a 29 28 76 6f 69 64 29 29 3b 0a 23 65 d (*)(void));.#e
26570 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 ndif.int sqlite3
26580 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c 28 76 HeapNearlyFull(v
26590 6f 69 64 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 20 oid);../*.** On
265a0 73 79 73 74 65 6d 73 20 77 69 74 68 20 61 6d 70 systems with amp
265b0 6c 65 20 73 74 61 63 6b 20 73 70 61 63 65 20 61 le stack space a
265c0 6e 64 20 74 68 61 74 20 73 75 70 70 6f 72 74 20 nd that support
265d0 61 6c 6c 6f 63 61 28 29 2c 20 6d 61 6b 65 0a 2a alloca(), make.*
265e0 2a 20 75 73 65 20 6f 66 20 61 6c 6c 6f 63 61 28 * use of alloca(
265f0 29 20 74 6f 20 6f 62 74 61 69 6e 20 73 70 61 63 ) to obtain spac
26600 65 20 66 6f 72 20 6c 61 72 67 65 20 61 75 74 6f e for large auto
26610 6d 61 74 69 63 20 6f 62 6a 65 63 74 73 2e 20 20 matic objects.
26620 42 79 20 64 65 66 61 75 6c 74 2c 0a 2a 2a 20 6f By default,.** o
26630 62 74 61 69 6e 20 73 70 61 63 65 20 66 72 6f 6d btain space from
26640 20 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a malloc()..**.**
26650 20 54 68 65 20 61 6c 6c 6f 63 61 28 29 20 72 6f The alloca() ro
26660 75 74 69 6e 65 20 6e 65 76 65 72 20 72 65 74 75 utine never retu
26670 72 6e 73 20 4e 55 4c 4c 2e 20 20 54 68 69 73 20 rns NULL. This
26680 77 69 6c 6c 20 63 61 75 73 65 20 63 6f 64 65 20 will cause code
26690 70 61 74 68 73 0a 2a 2a 20 74 68 61 74 20 64 65 paths.** that de
266a0 61 6c 20 77 69 74 68 20 73 71 6c 69 74 65 33 53 al with sqlite3S
266b0 74 61 63 6b 41 6c 6c 6f 63 28 29 20 66 61 69 6c tackAlloc() fail
266c0 75 72 65 73 20 74 6f 20 62 65 20 75 6e 72 65 61 ures to be unrea
266d0 63 68 61 62 6c 65 2e 0a 2a 2f 0a 23 69 66 64 65 chable..*/.#ifde
266e0 66 20 53 51 4c 49 54 45 5f 55 53 45 5f 41 4c 4c f SQLITE_USE_ALL
266f0 4f 43 41 0a 23 20 64 65 66 69 6e 65 20 73 71 6c OCA.# define sql
26700 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 52 61 ite3StackAllocRa
26710 77 28 44 2c 4e 29 20 20 20 61 6c 6c 6f 63 61 28 w(D,N) alloca(
26720 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 N).# define sqli
26730 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 5a 65 72 te3StackAllocZer
26740 6f 28 44 2c 4e 29 20 20 6d 65 6d 73 65 74 28 61 o(D,N) memset(a
26750 6c 6c 6f 63 61 28 4e 29 2c 20 30 2c 20 4e 29 0a lloca(N), 0, N).
26760 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
26770 53 74 61 63 6b 46 72 65 65 28 44 2c 50 29 0a 23 StackFree(D,P).#
26780 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
26790 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 52 lite3StackAllocR
267a0 61 77 28 44 2c 4e 29 20 20 20 73 71 6c 69 74 65 aw(D,N) sqlite
267b0 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 44 2c 4e 3DbMallocRaw(D,N
267c0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
267d0 65 33 53 74 61 63 6b 41 6c 6c 6f 63 5a 65 72 6f e3StackAllocZero
267e0 28 44 2c 4e 29 20 20 73 71 6c 69 74 65 33 44 62 (D,N) sqlite3Db
267f0 4d 61 6c 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 0a MallocZero(D,N).
26800 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
26810 53 74 61 63 6b 46 72 65 65 28 44 2c 50 29 20 20 StackFree(D,P)
26820 20 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 sqlite3DbFr
26830 65 65 28 44 2c 50 29 0a 23 65 6e 64 69 66 0a 0a ee(D,P).#endif..
26840 2f 2a 20 44 6f 20 6e 6f 74 20 61 6c 6c 6f 77 20 /* Do not allow
26850 62 6f 74 68 20 4d 45 4d 53 59 53 35 20 61 6e 64 both MEMSYS5 and
26860 20 4d 45 4d 53 59 53 33 20 74 6f 20 62 65 20 64 MEMSYS3 to be d
26870 65 66 69 6e 65 64 20 74 6f 67 65 74 68 65 72 2e efined together.
26880 20 20 49 66 20 74 68 65 79 0a 2a 2a 20 61 72 65 If they.** are
26890 2c 20 64 69 73 61 62 6c 65 20 4d 45 4d 53 59 53 , disable MEMSYS
268a0 33 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 3.*/.#ifdef SQLI
268b0 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 TE_ENABLE_MEMSYS
268c0 35 0a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 5.const sqlite3_
268d0 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 2a 73 71 6c mem_methods *sql
268e0 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 ite3MemGetMemsys
268f0 35 28 76 6f 69 64 29 3b 0a 23 75 6e 64 65 66 20 5(void);.#undef
26900 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
26910 4d 53 59 53 33 0a 23 65 6e 64 69 66 0a 23 69 66 MSYS3.#endif.#if
26920 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
26930 45 5f 4d 45 4d 53 59 53 33 0a 63 6f 6e 73 74 20 E_MEMSYS3.const
26940 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
26950 6f 64 73 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 ods *sqlite3MemG
26960 65 74 4d 65 6d 73 79 73 33 28 76 6f 69 64 29 3b etMemsys3(void);
26970 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 65 .#endif...#ifnde
26980 66 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f 4f f SQLITE_MUTEX_O
26990 4d 49 54 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 MIT. sqlite3_mu
269a0 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 6f 6e 73 tex_methods cons
269b0 74 20 2a 73 71 6c 69 74 65 33 44 65 66 61 75 6c t *sqlite3Defaul
269c0 74 4d 75 74 65 78 28 76 6f 69 64 29 3b 0a 20 20 tMutex(void);.
269d0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 sqlite3_mutex_me
269e0 74 68 6f 64 73 20 63 6f 6e 73 74 20 2a 73 71 6c thods const *sql
269f0 69 74 65 33 4e 6f 6f 70 4d 75 74 65 78 28 76 6f ite3NoopMutex(vo
26a00 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d id);. sqlite3_m
26a10 75 74 65 78 20 2a 73 71 6c 69 74 65 33 4d 75 74 utex *sqlite3Mut
26a20 65 78 41 6c 6c 6f 63 28 69 6e 74 29 3b 0a 20 20 exAlloc(int);.
26a30 69 6e 74 20 73 71 6c 69 74 65 33 4d 75 74 65 78 int sqlite3Mutex
26a40 49 6e 69 74 28 76 6f 69 64 29 3b 0a 20 20 69 6e Init(void);. in
26a50 74 20 73 71 6c 69 74 65 33 4d 75 74 65 78 45 6e t sqlite3MutexEn
26a60 64 28 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a d(void);.#endif.
26a70 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
26a80 49 54 45 5f 4d 55 54 45 58 5f 4f 4d 49 54 29 20 ITE_MUTEX_OMIT)
26a90 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
26aa0 54 45 5f 4d 55 54 45 58 5f 4e 4f 4f 50 29 0a 20 TE_MUTEX_NOOP).
26ab0 20 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d void sqlite3Mem
26ac0 6f 72 79 42 61 72 72 69 65 72 28 76 6f 69 64 29 oryBarrier(void)
26ad0 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ;.#else.# define
26ae0 20 73 71 6c 69 74 65 33 4d 65 6d 6f 72 79 42 61 sqlite3MemoryBa
26af0 72 72 69 65 72 28 29 0a 23 65 6e 64 69 66 0a 0a rrier().#endif..
26b00 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 sqlite3_int64 sq
26b10 6c 69 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 lite3StatusValue
26b20 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 (int);.void sqli
26b30 74 65 33 53 74 61 74 75 73 55 70 28 69 6e 74 2c te3StatusUp(int,
26b40 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
26b50 74 65 33 53 74 61 74 75 73 44 6f 77 6e 28 69 6e te3StatusDown(in
26b60 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t, int);.void sq
26b70 6c 69 74 65 33 53 74 61 74 75 73 48 69 67 68 77 lite3StatusHighw
26b80 61 74 65 72 28 69 6e 74 2c 20 69 6e 74 29 3b 0a ater(int, int);.
26b90 69 6e 74 20 73 71 6c 69 74 65 33 4c 6f 6f 6b 61 int sqlite3Looka
26ba0 73 69 64 65 55 73 65 64 28 73 71 6c 69 74 65 33 sideUsed(sqlite3
26bb0 2a 2c 69 6e 74 2a 29 3b 0a 0a 2f 2a 20 41 63 63 *,int*);../* Acc
26bc0 65 73 73 20 74 6f 20 6d 75 74 65 78 65 73 20 75 ess to mutexes u
26bd0 73 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 73 sed by sqlite3_s
26be0 74 61 74 75 73 28 29 20 2a 2f 0a 73 71 6c 69 74 tatus() */.sqlit
26bf0 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 e3_mutex *sqlite
26c00 33 50 63 61 63 68 65 31 4d 75 74 65 78 28 76 6f 3Pcache1Mutex(vo
26c10 69 64 29 3b 0a 73 71 6c 69 74 65 33 5f 6d 75 74 id);.sqlite3_mut
26c20 65 78 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f ex *sqlite3Mallo
26c30 63 4d 75 74 65 78 28 76 6f 69 64 29 3b 0a 0a 23 cMutex(void);..#
26c40 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
26c50 45 5f 45 4e 41 42 4c 45 5f 4d 55 4c 54 49 54 48 E_ENABLE_MULTITH
26c60 52 45 41 44 45 44 5f 43 48 45 43 4b 53 29 20 26 READED_CHECKS) &
26c70 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 & !defined(SQLIT
26c80 45 5f 4d 55 54 45 58 5f 4f 4d 49 54 29 0a 76 6f E_MUTEX_OMIT).vo
26c90 69 64 20 73 71 6c 69 74 65 33 4d 75 74 65 78 57 id sqlite3MutexW
26ca0 61 72 6e 4f 6e 43 6f 6e 74 65 6e 74 69 6f 6e 28 arnOnContention(
26cb0 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 2a 29 3b sqlite3_mutex*);
26cc0 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
26cd0 73 71 6c 69 74 65 33 4d 75 74 65 78 57 61 72 6e sqlite3MutexWarn
26ce0 4f 6e 43 6f 6e 74 65 6e 74 69 6f 6e 28 78 29 0a OnContention(x).
26cf0 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
26d00 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 SQLITE_OMIT_FLOA
26d10 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 69 6e 74 TING_POINT. int
26d20 20 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 64 6f sqlite3IsNaN(do
26d30 75 62 6c 65 29 3b 0a 23 65 6c 73 65 0a 23 20 64 uble);.#else.# d
26d40 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 4e efine sqlite3IsN
26d50 61 4e 28 58 29 20 20 30 0a 23 65 6e 64 69 66 0a aN(X) 0.#endif.
26d60 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
26d70 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
26d80 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 68 6f ing structure ho
26d90 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 lds information
26da0 61 62 6f 75 74 20 53 51 4c 0a 2a 2a 20 66 75 6e about SQL.** fun
26db0 63 74 69 6f 6e 73 20 61 72 67 75 6d 65 6e 74 73 ctions arguments
26dc0 20 74 68 61 74 20 61 72 65 20 74 68 65 20 70 61 that are the pa
26dd0 72 61 6d 65 74 65 72 73 20 74 6f 20 74 68 65 20 rameters to the
26de0 70 72 69 6e 74 66 28 29 20 66 75 6e 63 74 69 6f printf() functio
26df0 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 72 69 n..*/.struct Pri
26e00 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 7b 0a 20 ntfArguments {.
26e10 20 69 6e 74 20 6e 41 72 67 3b 20 20 20 20 20 20 int nArg;
26e20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 /* Tot
26e30 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 al number of arg
26e40 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 uments */. int
26e50 6e 55 73 65 64 3b 20 20 20 20 20 20 20 20 20 20 nUsed;
26e60 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
26e70 66 20 61 72 67 75 6d 65 6e 74 73 20 75 73 65 64 f arguments used
26e80 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 73 71 6c so far */. sql
26e90 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 70 41 ite3_value **apA
26ea0 72 67 3b 20 20 20 2f 2a 20 54 68 65 20 61 72 67 rg; /* The arg
26eb0 75 6d 65 6e 74 20 76 61 6c 75 65 73 20 2a 2f 0a ument values */.
26ec0 7d 3b 0a 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 };..char *sqlite
26ed0 33 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 3MPrintf(sqlite3
26ee0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e *,const char*, .
26ef0 2e 2e 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 ..);.char *sqlit
26f00 65 33 56 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 e3VMPrintf(sqlit
26f10 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c e3*,const char*,
26f20 20 76 61 5f 6c 69 73 74 29 3b 0a 23 69 66 20 64 va_list);.#if d
26f30 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
26f40 42 55 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 BUG) || defined(
26f50 53 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 SQLITE_HAVE_OS_T
26f60 52 41 43 45 29 0a 20 20 76 6f 69 64 20 73 71 6c RACE). void sql
26f70 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
26f80 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e const char*, ...
26f90 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 );.#endif.#if de
26fa0 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 53 fined(SQLITE_TES
26fb0 54 29 0a 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 T). void *sqlit
26fc0 65 33 54 65 73 74 54 65 78 74 54 6f 50 74 72 28 e3TestTextToPtr(
26fd0 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 const char*);.#e
26fe0 6e 64 69 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 ndif..#if define
26ff0 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a d(SQLITE_DEBUG).
27000 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 void sqlite3Tr
27010 65 65 56 69 65 77 45 78 70 72 28 54 72 65 65 56 eeViewExpr(TreeV
27020 69 65 77 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 iew*, const Expr
27030 2a 2c 20 75 38 29 3b 0a 20 20 76 6f 69 64 20 73 *, u8);. void s
27040 71 6c 69 74 65 33 54 72 65 65 56 69 65 77 42 61 qlite3TreeViewBa
27050 72 65 45 78 70 72 4c 69 73 74 28 54 72 65 65 56 reExprList(TreeV
27060 69 65 77 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 iew*, const Expr
27070 4c 69 73 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 List*, const cha
27080 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 r*);. void sqli
27090 74 65 33 54 72 65 65 56 69 65 77 45 78 70 72 4c te3TreeViewExprL
270a0 69 73 74 28 54 72 65 65 56 69 65 77 2a 2c 20 63 ist(TreeView*, c
270b0 6f 6e 73 74 20 45 78 70 72 4c 69 73 74 2a 2c 20 onst ExprList*,
270c0 75 38 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 u8, const char*)
270d0 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
270e0 54 72 65 65 56 69 65 77 53 65 6c 65 63 74 28 54 TreeViewSelect(T
270f0 72 65 65 56 69 65 77 2a 2c 20 63 6f 6e 73 74 20 reeView*, const
27100 53 65 6c 65 63 74 2a 2c 20 75 38 29 3b 0a 20 20 Select*, u8);.
27110 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 void sqlite3Tree
27120 56 69 65 77 57 69 74 68 28 54 72 65 65 56 69 65 ViewWith(TreeVie
27130 77 2a 2c 20 63 6f 6e 73 74 20 57 69 74 68 2a 2c w*, const With*,
27140 20 75 38 29 3b 0a 23 65 6e 64 69 66 0a 0a 0a 76 u8);.#endif...v
27150 6f 69 64 20 73 71 6c 69 74 65 33 53 65 74 53 74 oid sqlite3SetSt
27160 72 69 6e 67 28 63 68 61 72 20 2a 2a 2c 20 73 71 ring(char **, sq
27170 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 lite3*, const ch
27180 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ar*);.void sqlit
27190 65 33 45 72 72 6f 72 4d 73 67 28 50 61 72 73 65 e3ErrorMsg(Parse
271a0 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 *, const char*,
271b0 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ...);.void sqlit
271c0 65 33 44 65 71 75 6f 74 65 28 63 68 61 72 2a 29 e3Dequote(char*)
271d0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 54 6f ;.void sqlite3To
271e0 6b 65 6e 49 6e 69 74 28 54 6f 6b 65 6e 2a 2c 63 kenInit(Token*,c
271f0 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 har*);.int sqlit
27200 65 33 4b 65 79 77 6f 72 64 43 6f 64 65 28 63 6f e3KeywordCode(co
27210 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 nst unsigned cha
27220 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
27230 6c 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 50 lite3RunParser(P
27240 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 arse*, const cha
27250 72 2a 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 76 6f r*, char **);.vo
27260 69 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 id sqlite3Finish
27270 43 6f 64 69 6e 67 28 50 61 72 73 65 2a 29 3b 0a Coding(Parse*);.
27280 69 6e 74 20 73 71 6c 69 74 65 33 47 65 74 54 65 int sqlite3GetTe
27290 6d 70 52 65 67 28 50 61 72 73 65 2a 29 3b 0a 76 mpReg(Parse*);.v
272a0 6f 69 64 20 73 71 6c 69 74 65 33 52 65 6c 65 61 oid sqlite3Relea
272b0 73 65 54 65 6d 70 52 65 67 28 50 61 72 73 65 2a seTempReg(Parse*
272c0 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ,int);.int sqlit
272d0 65 33 47 65 74 54 65 6d 70 52 61 6e 67 65 28 50 e3GetTempRange(P
272e0 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 arse*,int);.void
272f0 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 sqlite3ReleaseT
27300 65 6d 70 52 61 6e 67 65 28 50 61 72 73 65 2a 2c empRange(Parse*,
27310 69 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 int,int);.void s
27320 71 6c 69 74 65 33 43 6c 65 61 72 54 65 6d 70 52 qlite3ClearTempR
27330 65 67 43 61 63 68 65 28 50 61 72 73 65 2a 29 3b egCache(Parse*);
27340 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
27350 45 42 55 47 0a 69 6e 74 20 73 71 6c 69 74 65 33 EBUG.int sqlite3
27360 4e 6f 54 65 6d 70 73 49 6e 52 61 6e 67 65 28 50 NoTempsInRange(P
27370 61 72 73 65 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a arse*,int,int);.
27380 23 65 6e 64 69 66 0a 45 78 70 72 20 2a 73 71 6c #endif.Expr *sql
27390 69 74 65 33 45 78 70 72 41 6c 6c 6f 63 28 73 71 ite3ExprAlloc(sq
273a0 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 lite3*,int,const
273b0 20 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 45 78 Token*,int);.Ex
273c0 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 28 pr *sqlite3Expr(
273d0 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e sqlite3*,int,con
273e0 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 st char*);.void
273f0 73 71 6c 69 74 65 33 45 78 70 72 41 74 74 61 63 sqlite3ExprAttac
27400 68 53 75 62 74 72 65 65 73 28 73 71 6c 69 74 65 hSubtrees(sqlite
27410 33 2a 2c 45 78 70 72 2a 2c 45 78 70 72 2a 2c 45 3*,Expr*,Expr*,E
27420 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c xpr*);.Expr *sql
27430 69 74 65 33 50 45 78 70 72 28 50 61 72 73 65 2a ite3PExpr(Parse*
27440 2c 20 69 6e 74 2c 20 45 78 70 72 2a 2c 20 45 78 , int, Expr*, Ex
27450 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 pr*);.void sqlit
27460 65 33 50 45 78 70 72 41 64 64 53 65 6c 65 63 74 e3PExprAddSelect
27470 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 (Parse*, Expr*,
27480 53 65 6c 65 63 74 2a 29 3b 0a 45 78 70 72 20 2a Select*);.Expr *
27490 73 71 6c 69 74 65 33 45 78 70 72 41 6e 64 28 73 sqlite3ExprAnd(s
274a0 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 20 45 qlite3*,Expr*, E
274b0 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c xpr*);.Expr *sql
274c0 69 74 65 33 45 78 70 72 46 75 6e 63 74 69 6f 6e ite3ExprFunction
274d0 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 (Parse*,ExprList
274e0 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 *, Token*);.void
274f0 20 73 71 6c 69 74 65 33 45 78 70 72 41 73 73 69 sqlite3ExprAssi
27500 67 6e 56 61 72 4e 75 6d 62 65 72 28 50 61 72 73 gnVarNumber(Pars
27510 65 2a 2c 20 45 78 70 72 2a 2c 20 75 33 32 29 3b e*, Expr*, u32);
27520 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
27530 72 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a rDelete(sqlite3*
27540 2c 20 45 78 70 72 2a 29 3b 0a 45 78 70 72 4c 69 , Expr*);.ExprLi
27550 73 74 20 2a 73 71 6c 69 74 65 33 45 78 70 72 4c st *sqlite3ExprL
27560 69 73 74 41 70 70 65 6e 64 28 50 61 72 73 65 2a istAppend(Parse*
27570 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a ,ExprList*,Expr*
27580 29 3b 0a 45 78 70 72 4c 69 73 74 20 2a 73 71 6c );.ExprList *sql
27590 69 74 65 33 45 78 70 72 4c 69 73 74 41 70 70 65 ite3ExprListAppe
275a0 6e 64 56 65 63 74 6f 72 28 50 61 72 73 65 2a 2c ndVector(Parse*,
275b0 45 78 70 72 4c 69 73 74 2a 2c 49 64 4c 69 73 74 ExprList*,IdList
275c0 2a 2c 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 *,Expr*);.void s
275d0 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 53 65 qlite3ExprListSe
275e0 74 53 6f 72 74 4f 72 64 65 72 28 45 78 70 72 4c tSortOrder(ExprL
275f0 69 73 74 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 ist*,int);.void
27600 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 53 sqlite3ExprListS
27610 65 74 4e 61 6d 65 28 50 61 72 73 65 2a 2c 45 78 etName(Parse*,Ex
27620 70 72 4c 69 73 74 2a 2c 54 6f 6b 65 6e 2a 2c 69 prList*,Token*,i
27630 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
27640 33 45 78 70 72 4c 69 73 74 53 65 74 53 70 61 6e 3ExprListSetSpan
27650 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 (Parse*,ExprList
27660 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f *,const char*,co
27670 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
27680 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 sqlite3ExprList
27690 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c Delete(sqlite3*,
276a0 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a 75 33 32 ExprList*);.u32
276b0 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 sqlite3ExprList
276c0 46 6c 61 67 73 28 63 6f 6e 73 74 20 45 78 70 72 Flags(const Expr
276d0 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 List*);.int sqli
276e0 74 65 33 49 6e 69 74 28 73 71 6c 69 74 65 33 2a te3Init(sqlite3*
276f0 2c 20 63 68 61 72 2a 2a 29 3b 0a 69 6e 74 20 73 , char**);.int s
27700 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 qlite3InitCallba
27710 63 6b 28 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 63 ck(void*, int, c
27720 68 61 72 2a 2a 2c 20 63 68 61 72 2a 2a 29 3b 0a har**, char**);.
27730 76 6f 69 64 20 73 71 6c 69 74 65 33 50 72 61 67 void sqlite3Prag
27740 6d 61 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a ma(Parse*,Token*
27750 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 ,Token*,Token*,i
27760 6e 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c nt);.#ifndef SQL
27770 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
27780 54 41 42 4c 45 0a 4d 6f 64 75 6c 65 20 2a 73 71 TABLE.Module *sq
27790 6c 69 74 65 33 50 72 61 67 6d 61 56 74 61 62 52 lite3PragmaVtabR
277a0 65 67 69 73 74 65 72 28 73 71 6c 69 74 65 33 2a egister(sqlite3*
277b0 2c 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 ,const char *zNa
277c0 6d 65 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 64 me);.#endif.void
277d0 20 73 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c sqlite3ResetAll
277e0 53 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 SchemasOfConnect
277f0 69 6f 6e 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 ion(sqlite3*);.v
27800 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 65 74 oid sqlite3Reset
27810 4f 6e 65 53 63 68 65 6d 61 28 73 71 6c 69 74 65 OneSchema(sqlite
27820 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 3*,int);.void sq
27830 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 44 61 74 lite3CollapseDat
27840 61 62 61 73 65 41 72 72 61 79 28 73 71 6c 69 74 abaseArray(sqlit
27850 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 e3*);.void sqlit
27860 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c e3CommitInternal
27870 43 68 61 6e 67 65 73 28 73 71 6c 69 74 65 33 2a Changes(sqlite3*
27880 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 );.void sqlite3D
27890 65 6c 65 74 65 43 6f 6c 75 6d 6e 4e 61 6d 65 73 eleteColumnNames
278a0 28 73 71 6c 69 74 65 33 2a 2c 54 61 62 6c 65 2a (sqlite3*,Table*
278b0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f );.int sqlite3Co
278c0 6c 75 6d 6e 73 46 72 6f 6d 45 78 70 72 4c 69 73 lumnsFromExprLis
278d0 74 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 t(Parse*,ExprLis
278e0 74 2a 2c 69 31 36 2a 2c 43 6f 6c 75 6d 6e 2a 2a t*,i16*,Column**
278f0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
27900 65 6c 65 63 74 41 64 64 43 6f 6c 75 6d 6e 54 79 electAddColumnTy
27910 70 65 41 6e 64 43 6f 6c 6c 61 74 69 6f 6e 28 50 peAndCollation(P
27920 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 53 65 6c arse*,Table*,Sel
27930 65 63 74 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 ect*);.Table *sq
27940 6c 69 74 65 33 52 65 73 75 6c 74 53 65 74 4f 66 lite3ResultSetOf
27950 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c 53 65 Select(Parse*,Se
27960 6c 65 63 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c lect*);.void sql
27970 69 74 65 33 4f 70 65 6e 4d 61 73 74 65 72 54 61 ite3OpenMasterTa
27980 62 6c 65 28 50 61 72 73 65 20 2a 2c 20 69 6e 74 ble(Parse *, int
27990 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 );.Index *sqlite
279a0 33 50 72 69 6d 61 72 79 4b 65 79 49 6e 64 65 78 3PrimaryKeyIndex
279b0 28 54 61 62 6c 65 2a 29 3b 0a 69 31 36 20 73 71 (Table*);.i16 sq
279c0 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e 64 lite3ColumnOfInd
279d0 65 78 28 49 6e 64 65 78 2a 2c 20 69 31 36 29 3b ex(Index*, i16);
279e0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 .void sqlite3Sta
279f0 72 74 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 rtTable(Parse*,T
27a00 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 oken*,Token*,int
27a10 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a 23 ,int,int,int);.#
27a20 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 if SQLITE_ENABLE
27a30 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e 53 0a _HIDDEN_COLUMNS.
27a40 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
27a50 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 46 72 lumnPropertiesFr
27a60 6f 6d 4e 61 6d 65 28 54 61 62 6c 65 2a 2c 20 43 omName(Table*, C
27a70 6f 6c 75 6d 6e 2a 29 3b 0a 23 65 6c 73 65 0a 23 olumn*);.#else.#
27a80 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 43 define sqlite3C
27a90 6f 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 46 olumnPropertiesF
27aa0 72 6f 6d 4e 61 6d 65 28 54 2c 43 29 20 2f 2a 20 romName(T,C) /*
27ab0 6e 6f 2d 6f 70 20 2a 2f 0a 23 65 6e 64 69 66 0a no-op */.#endif.
27ac0 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 43 void sqlite3AddC
27ad0 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 54 6f 6b olumn(Parse*,Tok
27ae0 65 6e 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 en*,Token*);.voi
27af0 64 20 73 71 6c 69 74 65 33 41 64 64 4e 6f 74 4e d sqlite3AddNotN
27b00 75 6c 6c 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 ull(Parse*, int)
27b10 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 ;.void sqlite3Ad
27b20 64 50 72 69 6d 61 72 79 4b 65 79 28 50 61 72 73 dPrimaryKey(Pars
27b30 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 e*, ExprList*, i
27b40 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 nt, int, int);.v
27b50 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 43 68 oid sqlite3AddCh
27b60 65 63 6b 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 eckConstraint(Pa
27b70 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f rse*, Expr*);.vo
27b80 69 64 20 73 71 6c 69 74 65 33 41 64 64 44 65 66 id sqlite3AddDef
27b90 61 75 6c 74 56 61 6c 75 65 28 50 61 72 73 65 2a aultValue(Parse*
27ba0 2c 45 78 70 72 2a 2c 63 6f 6e 73 74 20 63 68 61 ,Expr*,const cha
27bb0 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b r*,const char*);
27bc0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 .void sqlite3Add
27bd0 43 6f 6c 6c 61 74 65 54 79 70 65 28 50 61 72 73 CollateType(Pars
27be0 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 e*, Token*);.voi
27bf0 64 20 73 71 6c 69 74 65 33 45 6e 64 54 61 62 6c d sqlite3EndTabl
27c00 65 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c e(Parse*,Token*,
27c10 54 6f 6b 65 6e 2a 2c 75 38 2c 53 65 6c 65 63 74 Token*,u8,Select
27c20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 *);.int sqlite3P
27c30 61 72 73 65 55 72 69 28 63 6f 6e 73 74 20 63 68 arseUri(const ch
27c40 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c ar*,const char*,
27c50 75 6e 73 69 67 6e 65 64 20 69 6e 74 2a 2c 0a 20 unsigned int*,.
27c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27c70 20 20 20 73 71 6c 69 74 65 33 5f 76 66 73 2a 2a sqlite3_vfs**
27c80 2c 63 68 61 72 2a 2a 2c 63 68 61 72 20 2a 2a 29 ,char**,char **)
27c90 3b 0a 42 74 72 65 65 20 2a 73 71 6c 69 74 65 33 ;.Btree *sqlite3
27ca0 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 73 71 DbNameToBtree(sq
27cb0 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
27cc0 72 2a 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c r*);..#ifdef SQL
27cd0 49 54 45 5f 55 4e 54 45 53 54 41 42 4c 45 0a 23 ITE_UNTESTABLE.#
27ce0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 define sqlite3F
27cf0 61 75 6c 74 53 69 6d 28 58 29 20 53 51 4c 49 54 aultSim(X) SQLIT
27d00 45 5f 4f 4b 0a 23 65 6c 73 65 0a 20 20 69 6e 74 E_OK.#else. int
27d10 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 69 6d sqlite3FaultSim
27d20 28 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 42 (int);.#endif..B
27d30 69 74 76 65 63 20 2a 73 71 6c 69 74 65 33 42 69 itvec *sqlite3Bi
27d40 74 76 65 63 43 72 65 61 74 65 28 75 33 32 29 3b tvecCreate(u32);
27d50 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 74 76 .int sqlite3Bitv
27d60 65 63 54 65 73 74 28 42 69 74 76 65 63 2a 2c 20 ecTest(Bitvec*,
27d70 75 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 u32);.int sqlite
27d80 33 42 69 74 76 65 63 54 65 73 74 4e 6f 74 4e 75 3BitvecTestNotNu
27d90 6c 6c 28 42 69 74 76 65 63 2a 2c 20 75 33 32 29 ll(Bitvec*, u32)
27da0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 74 ;.int sqlite3Bit
27db0 76 65 63 53 65 74 28 42 69 74 76 65 63 2a 2c 20 vecSet(Bitvec*,
27dc0 75 33 32 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u32);.void sqlit
27dd0 65 33 42 69 74 76 65 63 43 6c 65 61 72 28 42 69 e3BitvecClear(Bi
27de0 74 76 65 63 2a 2c 20 75 33 32 2c 20 76 6f 69 64 tvec*, u32, void
27df0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
27e00 42 69 74 76 65 63 44 65 73 74 72 6f 79 28 42 69 BitvecDestroy(Bi
27e10 74 76 65 63 2a 29 3b 0a 75 33 32 20 73 71 6c 69 tvec*);.u32 sqli
27e20 74 65 33 42 69 74 76 65 63 53 69 7a 65 28 42 69 te3BitvecSize(Bi
27e30 74 76 65 63 2a 29 3b 0a 23 69 66 6e 64 65 66 20 tvec*);.#ifndef
27e40 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
27e50 45 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 74 E.int sqlite3Bit
27e60 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 28 69 vecBuiltinTest(i
27e70 6e 74 2c 69 6e 74 2a 29 3b 0a 23 65 6e 64 69 66 nt,int*);.#endif
27e80 0a 0a 52 6f 77 53 65 74 20 2a 73 71 6c 69 74 65 ..RowSet *sqlite
27e90 33 52 6f 77 53 65 74 49 6e 69 74 28 73 71 6c 69 3RowSetInit(sqli
27ea0 74 65 33 2a 2c 20 76 6f 69 64 2a 2c 20 75 6e 73 te3*, void*, uns
27eb0 69 67 6e 65 64 20 69 6e 74 29 3b 0a 76 6f 69 64 igned int);.void
27ec0 20 73 71 6c 69 74 65 33 52 6f 77 53 65 74 43 6c sqlite3RowSetCl
27ed0 65 61 72 28 52 6f 77 53 65 74 2a 29 3b 0a 76 6f ear(RowSet*);.vo
27ee0 69 64 20 73 71 6c 69 74 65 33 52 6f 77 53 65 74 id sqlite3RowSet
27ef0 49 6e 73 65 72 74 28 52 6f 77 53 65 74 2a 2c 20 Insert(RowSet*,
27f00 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 i64);.int sqlite
27f10 33 52 6f 77 53 65 74 54 65 73 74 28 52 6f 77 53 3RowSetTest(RowS
27f20 65 74 2a 2c 20 69 6e 74 20 69 42 61 74 63 68 2c et*, int iBatch,
27f30 20 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 i64);.int sqlit
27f40 65 33 52 6f 77 53 65 74 4e 65 78 74 28 52 6f 77 e3RowSetNext(Row
27f50 53 65 74 2a 2c 20 69 36 34 2a 29 3b 0a 0a 76 6f Set*, i64*);..vo
27f60 69 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 id sqlite3Create
27f70 56 69 65 77 28 50 61 72 73 65 2a 2c 54 6f 6b 65 View(Parse*,Toke
27f80 6e 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a n*,Token*,Token*
27f90 2c 45 78 70 72 4c 69 73 74 2a 2c 53 65 6c 65 63 ,ExprList*,Selec
27fa0 74 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 0a 23 69 t*,int,int);..#i
27fb0 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
27fc0 45 5f 4f 4d 49 54 5f 56 49 45 57 29 20 7c 7c 20 E_OMIT_VIEW) ||
27fd0 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
27fe0 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
27ff0 45 29 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 E). int sqlite3
28000 56 69 65 77 47 65 74 43 6f 6c 75 6d 6e 4e 61 6d ViewGetColumnNam
28010 65 73 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a es(Parse*,Table*
28020 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e );.#else.# defin
28030 65 20 73 71 6c 69 74 65 33 56 69 65 77 47 65 74 e sqlite3ViewGet
28040 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 41 2c 42 29 ColumnNames(A,B)
28050 20 30 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 53 0.#endif..#if S
28060 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 QLITE_MAX_ATTACH
28070 45 44 3e 33 30 0a 20 20 69 6e 74 20 73 71 6c 69 ED>30. int sqli
28080 74 65 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f te3DbMaskAllZero
28090 28 79 44 62 4d 61 73 6b 29 3b 0a 23 65 6e 64 69 (yDbMask);.#endi
280a0 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 72 f.void sqlite3Dr
280b0 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 opTable(Parse*,
280c0 53 72 63 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 SrcList*, int, i
280d0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
280e0 33 43 6f 64 65 44 72 6f 70 54 61 62 6c 65 28 50 3CodeDropTable(P
280f0 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 arse*, Table*, i
28100 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
28110 71 6c 69 74 65 33 44 65 6c 65 74 65 54 61 62 6c qlite3DeleteTabl
28120 65 28 73 71 6c 69 74 65 33 2a 2c 20 54 61 62 6c e(sqlite3*, Tabl
28130 65 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c e*);.#ifndef SQL
28140 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 4e 43 ITE_OMIT_AUTOINC
28150 52 45 4d 45 4e 54 0a 20 20 76 6f 69 64 20 73 71 REMENT. void sq
28160 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 lite3Autoincreme
28170 6e 74 42 65 67 69 6e 28 50 61 72 73 65 20 2a 70 ntBegin(Parse *p
28180 50 61 72 73 65 29 3b 0a 20 20 76 6f 69 64 20 73 Parse);. void s
28190 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d qlite3Autoincrem
281a0 65 6e 74 45 6e 64 28 50 61 72 73 65 20 2a 70 50 entEnd(Parse *pP
281b0 61 72 73 65 29 3b 0a 23 65 6c 73 65 0a 23 20 64 arse);.#else.# d
281c0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 efine sqlite3Aut
281d0 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 69 6e 28 oincrementBegin(
281e0 58 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 X).# define sqli
281f0 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 te3Autoincrement
28200 45 6e 64 28 58 29 0a 23 65 6e 64 69 66 0a 76 6f End(X).#endif.vo
28210 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 74 id sqlite3Insert
28220 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 (Parse*, SrcList
28230 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 49 64 4c 69 *, Select*, IdLi
28240 73 74 2a 2c 20 69 6e 74 2c 20 55 70 73 65 72 74 st*, int, Upsert
28250 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 *);.void *sqlite
28260 33 41 72 72 61 79 41 6c 6c 6f 63 61 74 65 28 73 3ArrayAllocate(s
28270 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69 6e qlite3*,void*,in
28280 74 2c 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a 49 64 t,int*,int*);.Id
28290 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 64 4c List *sqlite3IdL
282a0 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 74 65 istAppend(sqlite
282b0 33 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 54 6f 6b 3*, IdList*, Tok
282c0 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 en*);.int sqlite
282d0 33 49 64 4c 69 73 74 49 6e 64 65 78 28 49 64 4c 3IdListIndex(IdL
282e0 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a ist*,const char*
282f0 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 );.SrcList *sqli
28300 74 65 33 53 72 63 4c 69 73 74 45 6e 6c 61 72 67 te3SrcListEnlarg
28310 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c e(sqlite3*, SrcL
28320 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b ist*, int, int);
28330 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 65 .SrcList *sqlite
28340 33 53 72 63 4c 69 73 74 41 70 70 65 6e 64 28 73 3SrcListAppend(s
28350 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 74 qlite3*, SrcList
28360 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e *, Token*, Token
28370 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c *);.SrcList *sql
28380 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e ite3SrcListAppen
28390 64 46 72 6f 6d 54 65 72 6d 28 50 61 72 73 65 2a dFromTerm(Parse*
283a0 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b 65 , SrcList*, Toke
283b0 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 0a 20 20 20 20 n*, Token*,.
283c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
283d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
283e0 20 20 54 6f 6b 65 6e 2a 2c 20 53 65 6c 65 63 74 Token*, Select
283f0 2a 2c 20 45 78 70 72 2a 2c 20 49 64 4c 69 73 74 *, Expr*, IdList
28400 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
28410 53 72 63 4c 69 73 74 49 6e 64 65 78 65 64 42 79 SrcListIndexedBy
28420 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c 69 73 (Parse *, SrcLis
28430 74 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b 0a 76 t *, Token *);.v
28440 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c 69 oid sqlite3SrcLi
28450 73 74 46 75 6e 63 41 72 67 73 28 50 61 72 73 65 stFuncArgs(Parse
28460 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 70 *, SrcList*, Exp
28470 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c rList*);.int sql
28480 69 74 65 33 49 6e 64 65 78 65 64 42 79 4c 6f 6f ite3IndexedByLoo
28490 6b 75 70 28 50 61 72 73 65 20 2a 2c 20 73 74 72 kup(Parse *, str
284a0 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d uct SrcList_item
284b0 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);.void sqlite
284c0 33 53 72 63 4c 69 73 74 53 68 69 66 74 4a 6f 69 3SrcListShiftJoi
284d0 6e 54 79 70 65 28 53 72 63 4c 69 73 74 2a 29 3b nType(SrcList*);
284e0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 .void sqlite3Src
284f0 4c 69 73 74 41 73 73 69 67 6e 43 75 72 73 6f 72 ListAssignCursor
28500 73 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 s(Parse*, SrcLis
28510 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
28520 33 49 64 4c 69 73 74 44 65 6c 65 74 65 28 73 71 3IdListDelete(sq
28530 6c 69 74 65 33 2a 2c 20 49 64 4c 69 73 74 2a 29 lite3*, IdList*)
28540 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 ;.void sqlite3Sr
28550 63 4c 69 73 74 44 65 6c 65 74 65 28 73 71 6c 69 cListDelete(sqli
28560 74 65 33 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b te3*, SrcList*);
28570 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 41 .Index *sqlite3A
28580 6c 6c 6f 63 61 74 65 49 6e 64 65 78 4f 62 6a 65 llocateIndexObje
28590 63 74 28 73 71 6c 69 74 65 33 2a 2c 69 31 36 2c ct(sqlite3*,i16,
285a0 69 6e 74 2c 63 68 61 72 2a 2a 29 3b 0a 76 6f 69 int,char**);.voi
285b0 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 49 d sqlite3CreateI
285c0 6e 64 65 78 28 50 61 72 73 65 2a 2c 54 6f 6b 65 ndex(Parse*,Toke
285d0 6e 2a 2c 54 6f 6b 65 6e 2a 2c 53 72 63 4c 69 73 n*,Token*,SrcLis
285e0 74 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 t*,ExprList*,int
285f0 2c 54 6f 6b 65 6e 2a 2c 0a 20 20 20 20 20 20 20 ,Token*,.
28600 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28610 20 20 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 Expr*, int, i
28620 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 nt, u8);.void sq
28630 6c 69 74 65 33 44 72 6f 70 49 6e 64 65 78 28 50 lite3DropIndex(P
28640 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c arse*, SrcList*,
28650 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
28660 65 33 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c e3Select(Parse*,
28670 20 53 65 6c 65 63 74 2a 2c 20 53 65 6c 65 63 74 Select*, Select
28680 44 65 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 2a Dest*);.Select *
28690 73 71 6c 69 74 65 33 53 65 6c 65 63 74 4e 65 77 sqlite3SelectNew
286a0 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 (Parse*,ExprList
286b0 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 2a *,SrcList*,Expr*
286c0 2c 45 78 70 72 4c 69 73 74 2a 2c 0a 20 20 20 20 ,ExprList*,.
286d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
286e0 20 20 20 20 20 45 78 70 72 2a 2c 45 78 70 72 4c Expr*,ExprL
286f0 69 73 74 2a 2c 75 33 32 2c 45 78 70 72 2a 29 3b ist*,u32,Expr*);
28700 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c .void sqlite3Sel
28710 65 63 74 44 65 6c 65 74 65 28 73 71 6c 69 74 65 ectDelete(sqlite
28720 33 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 54 61 3*, Select*);.Ta
28730 62 6c 65 20 2a 73 71 6c 69 74 65 33 53 72 63 4c ble *sqlite3SrcL
28740 69 73 74 4c 6f 6f 6b 75 70 28 50 61 72 73 65 2a istLookup(Parse*
28750 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 69 6e 74 , SrcList*);.int
28760 20 73 71 6c 69 74 65 33 49 73 52 65 61 64 4f 6e sqlite3IsReadOn
28770 6c 79 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 ly(Parse*, Table
28780 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
28790 6c 69 74 65 33 4f 70 65 6e 54 61 62 6c 65 28 50 lite3OpenTable(P
287a0 61 72 73 65 2a 2c 20 69 6e 74 20 69 43 75 72 2c arse*, int iCur,
287b0 20 69 6e 74 20 69 44 62 2c 20 54 61 62 6c 65 2a int iDb, Table*
287c0 2c 20 69 6e 74 29 3b 0a 23 69 66 20 64 65 66 69 , int);.#if defi
287d0 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
287e0 45 5f 55 50 44 41 54 45 5f 44 45 4c 45 54 45 5f E_UPDATE_DELETE_
287f0 4c 49 4d 49 54 29 20 26 26 20 21 64 65 66 69 6e LIMIT) && !defin
28800 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 ed(SQLITE_OMIT_S
28810 55 42 51 55 45 52 59 29 0a 45 78 70 72 20 2a 73 UBQUERY).Expr *s
28820 71 6c 69 74 65 33 4c 69 6d 69 74 57 68 65 72 65 qlite3LimitWhere
28830 28 50 61 72 73 65 2a 2c 53 72 63 4c 69 73 74 2a (Parse*,SrcList*
28840 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a ,Expr*,ExprList*
28850 2c 45 78 70 72 2a 2c 63 68 61 72 2a 29 3b 0a 23 ,Expr*,char*);.#
28860 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 endif.void sqlit
28870 65 33 44 65 6c 65 74 65 46 72 6f 6d 28 50 61 72 e3DeleteFrom(Par
28880 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 se*, SrcList*, E
28890 78 70 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c xpr*, ExprList*,
288a0 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 Expr*);.void sq
288b0 6c 69 74 65 33 55 70 64 61 74 65 28 50 61 72 73 lite3Update(Pars
288c0 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 e*, SrcList*, Ex
288d0 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 69 6e prList*,Expr*,in
288e0 74 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 t,ExprList*,Expr
288f0 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 *,.
28900 20 20 20 20 20 20 55 70 73 65 72 74 2a 29 3b 0a Upsert*);.
28910 57 68 65 72 65 49 6e 66 6f 20 2a 73 71 6c 69 74 WhereInfo *sqlit
28920 65 33 57 68 65 72 65 42 65 67 69 6e 28 50 61 72 e3WhereBegin(Par
28930 73 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 se*,SrcList*,Exp
28940 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 r*,ExprList*,Exp
28950 72 4c 69 73 74 2a 2c 75 31 36 2c 69 6e 74 29 3b rList*,u16,int);
28960 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 57 68 65 .void sqlite3Whe
28970 72 65 45 6e 64 28 57 68 65 72 65 49 6e 66 6f 2a reEnd(WhereInfo*
28980 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 65 );.LogEst sqlite
28990 33 57 68 65 72 65 4f 75 74 70 75 74 52 6f 77 43 3WhereOutputRowC
289a0 6f 75 6e 74 28 57 68 65 72 65 49 6e 66 6f 2a 29 ount(WhereInfo*)
289b0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 ;.int sqlite3Whe
289c0 72 65 49 73 44 69 73 74 69 6e 63 74 28 57 68 65 reIsDistinct(Whe
289d0 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 reInfo*);.int sq
289e0 6c 69 74 65 33 57 68 65 72 65 49 73 4f 72 64 65 lite3WhereIsOrde
289f0 72 65 64 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b red(WhereInfo*);
28a00 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 .int sqlite3Wher
28a10 65 4f 72 64 65 72 65 64 49 6e 6e 65 72 4c 6f 6f eOrderedInnerLoo
28a20 70 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 p(WhereInfo*);.i
28a30 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 nt sqlite3WhereI
28a40 73 53 6f 72 74 65 64 28 57 68 65 72 65 49 6e 66 sSorted(WhereInf
28a50 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 o*);.int sqlite3
28a60 57 68 65 72 65 43 6f 6e 74 69 6e 75 65 4c 61 62 WhereContinueLab
28a70 65 6c 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a el(WhereInfo*);.
28a80 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 int sqlite3Where
28a90 42 72 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 65 BreakLabel(Where
28aa0 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Info*);.int sqli
28ab0 74 65 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 73 te3WhereOkOnePas
28ac0 73 28 57 68 65 72 65 49 6e 66 6f 2a 2c 20 69 6e s(WhereInfo*, in
28ad0 74 2a 29 3b 0a 23 64 65 66 69 6e 65 20 4f 4e 45 t*);.#define ONE
28ae0 50 41 53 53 5f 4f 46 46 20 20 20 20 20 20 30 20 PASS_OFF 0
28af0 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 6f 66 /* Use of
28b00 20 4f 4e 45 50 41 53 53 20 6e 6f 74 20 61 6c 6c ONEPASS not all
28b10 6f 77 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 owed */.#define
28b20 4f 4e 45 50 41 53 53 5f 53 49 4e 47 4c 45 20 20 ONEPASS_SINGLE
28b30 20 31 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 1 /* ONE
28b40 50 41 53 53 20 76 61 6c 69 64 20 66 6f 72 20 61 PASS valid for a
28b50 20 73 69 6e 67 6c 65 20 72 6f 77 20 75 70 64 61 single row upda
28b60 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 4e te */.#define ON
28b70 45 50 41 53 53 5f 4d 55 4c 54 49 20 20 20 20 32 EPASS_MULTI 2
28b80 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 50 41 /* ONEPA
28b90 53 53 20 69 73 20 76 61 6c 69 64 20 66 6f 72 20 SS is valid for
28ba0 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f multiple rows */
28bb0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
28bc0 72 43 6f 64 65 4c 6f 61 64 49 6e 64 65 78 43 6f rCodeLoadIndexCo
28bd0 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 20 49 6e 64 lumn(Parse*, Ind
28be0 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 ex*, int, int, i
28bf0 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
28c00 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 6d ExprCodeGetColum
28c10 6e 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a n(Parse*, Table*
28c20 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c , int, int, int,
28c30 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u8);.void sqlit
28c40 65 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c e3ExprCodeGetCol
28c50 75 6d 6e 54 6f 52 65 67 28 50 61 72 73 65 2a 2c umnToReg(Parse*,
28c60 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e Table*, int, in
28c70 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t, int);.void sq
28c80 6c 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 74 lite3ExprCodeGet
28c90 43 6f 6c 75 6d 6e 4f 66 54 61 62 6c 65 28 56 64 ColumnOfTable(Vd
28ca0 62 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 be*, Table*, int
28cb0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
28cc0 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 d sqlite3ExprCod
28cd0 65 4d 6f 76 65 28 50 61 72 73 65 2a 2c 20 69 6e eMove(Parse*, in
28ce0 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f t, int, int);.vo
28cf0 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 61 id sqlite3ExprCa
28d00 63 68 65 53 74 6f 72 65 28 50 61 72 73 65 2a 2c cheStore(Parse*,
28d10 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
28d20 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
28d30 72 43 61 63 68 65 50 75 73 68 28 50 61 72 73 65 rCachePush(Parse
28d40 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
28d50 45 78 70 72 43 61 63 68 65 50 6f 70 28 50 61 72 ExprCachePop(Par
28d60 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
28d70 65 33 45 78 70 72 43 61 63 68 65 52 65 6d 6f 76 e3ExprCacheRemov
28d80 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 e(Parse*, int, i
28d90 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
28da0 33 45 78 70 72 43 61 63 68 65 43 6c 65 61 72 28 3ExprCacheClear(
28db0 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 Parse*);.void sq
28dc0 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 41 66 lite3ExprCacheAf
28dd0 66 69 6e 69 74 79 43 68 61 6e 67 65 28 50 61 72 finityChange(Par
28de0 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a se*, int, int);.
28df0 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
28e00 43 6f 64 65 28 50 61 72 73 65 2a 2c 20 45 78 70 Code(Parse*, Exp
28e10 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 r*, int);.void s
28e20 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 43 6f qlite3ExprCodeCo
28e30 70 79 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a py(Parse*, Expr*
28e40 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
28e50 69 74 65 33 45 78 70 72 43 6f 64 65 46 61 63 74 ite3ExprCodeFact
28e60 6f 72 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 45 orable(Parse*, E
28e70 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 xpr*, int);.int
28e80 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 41 sqlite3ExprCodeA
28e90 74 49 6e 69 74 28 50 61 72 73 65 2a 2c 20 45 78 tInit(Parse*, Ex
28ea0 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 pr*, int);.int s
28eb0 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 54 65 qlite3ExprCodeTe
28ec0 6d 70 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a mp(Parse*, Expr*
28ed0 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c , int*);.int sql
28ee0 69 74 65 33 45 78 70 72 43 6f 64 65 54 61 72 67 ite3ExprCodeTarg
28ef0 65 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a et(Parse*, Expr*
28f00 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
28f10 69 74 65 33 45 78 70 72 43 6f 64 65 41 6e 64 43 ite3ExprCodeAndC
28f20 61 63 68 65 28 50 61 72 73 65 2a 2c 20 45 78 70 ache(Parse*, Exp
28f30 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
28f40 6c 69 74 65 33 45 78 70 72 43 6f 64 65 45 78 70 lite3ExprCodeExp
28f50 72 4c 69 73 74 28 50 61 72 73 65 2a 2c 20 45 78 rList(Parse*, Ex
28f60 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e prList*, int, in
28f70 74 2c 20 75 38 29 3b 0a 23 64 65 66 69 6e 65 20 t, u8);.#define
28f80 53 51 4c 49 54 45 5f 45 43 45 4c 5f 44 55 50 20 SQLITE_ECEL_DUP
28f90 20 20 20 20 20 30 78 30 31 20 20 2f 2a 20 44 65 0x01 /* De
28fa0 65 70 2c 20 6e 6f 74 20 73 68 61 6c 6c 6f 77 20 ep, not shallow
28fb0 63 6f 70 69 65 73 20 2a 2f 0a 23 64 65 66 69 6e copies */.#defin
28fc0 65 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f 46 41 e SQLITE_ECEL_FA
28fd0 43 54 4f 52 20 20 20 30 78 30 32 20 20 2f 2a 20 CTOR 0x02 /*
28fe0 46 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e 73 74 Factor out const
28ff0 61 6e 74 20 74 65 72 6d 73 20 2a 2f 0a 23 64 65 ant terms */.#de
29000 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 4c fine SQLITE_ECEL
29010 5f 52 45 46 20 20 20 20 20 20 30 78 30 34 20 20 _REF 0x04
29020 2f 2a 20 55 73 65 20 45 78 70 72 4c 69 73 74 2e /* Use ExprList.
29030 75 2e 78 2e 69 4f 72 64 65 72 42 79 43 6f 6c 20 u.x.iOrderByCol
29040 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
29050 45 5f 45 43 45 4c 5f 4f 4d 49 54 52 45 46 20 20 E_ECEL_OMITREF
29060 30 78 30 38 20 20 2f 2a 20 4f 6d 69 74 20 69 66 0x08 /* Omit if
29070 20 45 78 70 72 4c 69 73 74 2e 75 2e 78 2e 69 4f ExprList.u.x.iO
29080 72 64 65 72 42 79 43 6f 6c 20 2a 2f 0a 76 6f 69 rderByCol */.voi
29090 64 20 73 71 6c 69 74 65 33 45 78 70 72 49 66 54 d sqlite3ExprIfT
290a0 72 75 65 28 50 61 72 73 65 2a 2c 20 45 78 70 72 rue(Parse*, Expr
290b0 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f *, int, int);.vo
290c0 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 49 66 id sqlite3ExprIf
290d0 46 61 6c 73 65 28 50 61 72 73 65 2a 2c 20 45 78 False(Parse*, Ex
290e0 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a pr*, int, int);.
290f0 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
29100 49 66 46 61 6c 73 65 44 75 70 28 50 61 72 73 65 IfFalseDup(Parse
29110 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 *, Expr*, int, i
29120 6e 74 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 nt);.Table *sqli
29130 74 65 33 46 69 6e 64 54 61 62 6c 65 28 73 71 6c te3FindTable(sql
29140 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 ite3*,const char
29150 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b *, const char*);
29160 0a 23 64 65 66 69 6e 65 20 4c 4f 43 41 54 45 5f .#define LOCATE_
29170 56 49 45 57 20 20 20 20 30 78 30 31 0a 23 64 65 VIEW 0x01.#de
29180 66 69 6e 65 20 4c 4f 43 41 54 45 5f 4e 4f 45 52 fine LOCATE_NOER
29190 52 20 20 20 30 78 30 32 0a 54 61 62 6c 65 20 2a R 0x02.Table *
291a0 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 61 62 sqlite3LocateTab
291b0 6c 65 28 50 61 72 73 65 2a 2c 75 33 32 20 66 6c le(Parse*,u32 fl
291c0 61 67 73 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c ags,const char*,
291d0 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 54 const char*);.T
291e0 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 4c 6f 63 able *sqlite3Loc
291f0 61 74 65 54 61 62 6c 65 49 74 65 6d 28 50 61 72 ateTableItem(Par
29200 73 65 2a 2c 75 33 32 20 66 6c 61 67 73 2c 73 74 se*,u32 flags,st
29210 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 ruct SrcList_ite
29220 6d 20 2a 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c m *);.Index *sql
29230 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28 73 71 ite3FindIndex(sq
29240 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
29250 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 r*, const char*)
29260 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e ;.void sqlite3Un
29270 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 54 61 62 linkAndDeleteTab
29280 6c 65 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c le(sqlite3*,int,
29290 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f const char*);.vo
292a0 69 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b id sqlite3Unlink
292b0 41 6e 64 44 65 6c 65 74 65 49 6e 64 65 78 28 73 AndDeleteIndex(s
292c0 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 qlite3*,int,cons
292d0 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 t char*);.void s
292e0 71 6c 69 74 65 33 56 61 63 75 75 6d 28 50 61 72 qlite3Vacuum(Par
292f0 73 65 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 se*,Token*);.int
29300 20 73 71 6c 69 74 65 33 52 75 6e 56 61 63 75 75 sqlite3RunVacuu
29310 6d 28 63 68 61 72 2a 2a 2c 20 73 71 6c 69 74 65 m(char**, sqlite
29320 33 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 2a 3*, int);.char *
29330 73 71 6c 69 74 65 33 4e 61 6d 65 46 72 6f 6d 54 sqlite3NameFromT
29340 6f 6b 65 6e 28 73 71 6c 69 74 65 33 2a 2c 20 54 oken(sqlite3*, T
29350 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 oken*);.int sqli
29360 74 65 33 45 78 70 72 43 6f 6d 70 61 72 65 28 50 te3ExprCompare(P
29370 61 72 73 65 2a 2c 45 78 70 72 2a 2c 20 45 78 70 arse*,Expr*, Exp
29380 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
29390 6c 69 74 65 33 45 78 70 72 43 6f 6d 70 61 72 65 lite3ExprCompare
293a0 53 6b 69 70 28 45 78 70 72 2a 2c 20 45 78 70 72 Skip(Expr*, Expr
293b0 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c *, int);.int sql
293c0 69 74 65 33 45 78 70 72 4c 69 73 74 43 6f 6d 70 ite3ExprListComp
293d0 61 72 65 28 45 78 70 72 4c 69 73 74 2a 2c 20 45 are(ExprList*, E
293e0 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 3b 0a xprList*, int);.
293f0 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 int sqlite3ExprI
29400 6d 70 6c 69 65 73 45 78 70 72 28 50 61 72 73 65 mpliesExpr(Parse
29410 2a 2c 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 *,Expr*, Expr*,
29420 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
29430 33 45 78 70 72 49 6d 70 6c 69 65 73 4e 6f 6e 4e 3ExprImpliesNonN
29440 75 6c 6c 52 6f 77 28 45 78 70 72 2a 2c 69 6e 74 ullRow(Expr*,int
29450 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
29460 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 72 65 67 xprAnalyzeAggreg
29470 61 74 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 74 ates(NameContext
29480 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 *, Expr*);.void
29490 73 71 6c 69 74 65 33 45 78 70 72 41 6e 61 6c 79 sqlite3ExprAnaly
294a0 7a 65 41 67 67 4c 69 73 74 28 4e 61 6d 65 43 6f zeAggList(NameCo
294b0 6e 74 65 78 74 2a 2c 45 78 70 72 4c 69 73 74 2a ntext*,ExprList*
294c0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
294d0 70 72 43 6f 76 65 72 65 64 42 79 49 6e 64 65 78 prCoveredByIndex
294e0 28 45 78 70 72 2a 2c 20 69 6e 74 20 69 43 75 72 (Expr*, int iCur
294f0 2c 20 49 6e 64 65 78 20 2a 70 49 64 78 29 3b 0a , Index *pIdx);.
29500 69 6e 74 20 73 71 6c 69 74 65 33 46 75 6e 63 74 int sqlite3Funct
29510 69 6f 6e 55 73 65 73 54 68 69 73 53 72 63 28 45 ionUsesThisSrc(E
29520 78 70 72 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b xpr*, SrcList*);
29530 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33 47 65 .Vdbe *sqlite3Ge
29540 74 56 64 62 65 28 50 61 72 73 65 2a 29 3b 0a 23 tVdbe(Parse*);.#
29550 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 55 4e ifndef SQLITE_UN
29560 54 45 53 54 41 42 4c 45 0a 76 6f 69 64 20 73 71 TESTABLE.void sq
29570 6c 69 74 65 33 50 72 6e 67 53 61 76 65 53 74 61 lite3PrngSaveSta
29580 74 65 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 te(void);.void s
29590 71 6c 69 74 65 33 50 72 6e 67 52 65 73 74 6f 72 qlite3PrngRestor
295a0 65 53 74 61 74 65 28 76 6f 69 64 29 3b 0a 23 65 eState(void);.#e
295b0 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 ndif.void sqlite
295c0 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 3RollbackAll(sql
295d0 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 ite3*,int);.void
295e0 20 73 71 6c 69 74 65 33 43 6f 64 65 56 65 72 69 sqlite3CodeVeri
295f0 66 79 53 63 68 65 6d 61 28 50 61 72 73 65 2a 2c fySchema(Parse*,
29600 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
29610 74 65 33 43 6f 64 65 56 65 72 69 66 79 4e 61 6d te3CodeVerifyNam
29620 65 64 53 63 68 65 6d 61 28 50 61 72 73 65 2a 2c edSchema(Parse*,
29630 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 const char *zDb
29640 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 );.void sqlite3B
29650 65 67 69 6e 54 72 61 6e 73 61 63 74 69 6f 6e 28 eginTransaction(
29660 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f Parse*, int);.vo
29670 69 64 20 73 71 6c 69 74 65 33 45 6e 64 54 72 61 id sqlite3EndTra
29680 6e 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a 2c nsaction(Parse*,
29690 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
296a0 65 33 53 61 76 65 70 6f 69 6e 74 28 50 61 72 73 e3Savepoint(Pars
296b0 65 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2a 29 e*, int, Token*)
296c0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6c ;.void sqlite3Cl
296d0 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 71 oseSavepoints(sq
296e0 6c 69 74 65 33 20 2a 29 3b 0a 76 6f 69 64 20 73 lite3 *);.void s
296f0 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65 78 qlite3LeaveMutex
29700 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28 73 AndCloseZombie(s
29710 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 qlite3*);.int sq
29720 6c 69 74 65 33 45 78 70 72 49 64 54 6f 54 72 75 lite3ExprIdToTru
29730 65 46 61 6c 73 65 28 45 78 70 72 2a 29 3b 0a 69 eFalse(Expr*);.i
29740 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 54 72 nt sqlite3ExprTr
29750 75 74 68 56 61 6c 75 65 28 63 6f 6e 73 74 20 45 uthValue(const E
29760 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 xpr*);.int sqlit
29770 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 6e 74 e3ExprIsConstant
29780 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c (Expr*);.int sql
29790 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 ite3ExprIsConsta
297a0 6e 74 4e 6f 74 4a 6f 69 6e 28 45 78 70 72 2a 29 ntNotJoin(Expr*)
297b0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 ;.int sqlite3Exp
297c0 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 46 75 6e rIsConstantOrFun
297d0 63 74 69 6f 6e 28 45 78 70 72 2a 2c 20 75 38 29 ction(Expr*, u8)
297e0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 ;.int sqlite3Exp
297f0 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 47 72 6f rIsConstantOrGro
29800 75 70 42 79 28 50 61 72 73 65 2a 2c 20 45 78 70 upBy(Parse*, Exp
29810 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a r*, ExprList*);.
29820 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 int sqlite3ExprI
29830 73 54 61 62 6c 65 43 6f 6e 73 74 61 6e 74 28 45 sTableConstant(E
29840 78 70 72 2a 2c 69 6e 74 29 3b 0a 23 69 66 64 65 xpr*,int);.#ifde
29850 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
29860 43 55 52 53 4f 52 5f 48 49 4e 54 53 0a 69 6e 74 CURSOR_HINTS.int
29870 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6e 74 sqlite3ExprCont
29880 61 69 6e 73 53 75 62 71 75 65 72 79 28 45 78 70 ainsSubquery(Exp
29890 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 r*);.#endif.int
298a0 73 71 6c 69 74 65 33 45 78 70 72 49 73 49 6e 74 sqlite3ExprIsInt
298b0 65 67 65 72 28 45 78 70 72 2a 2c 20 69 6e 74 2a eger(Expr*, int*
298c0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
298d0 70 72 43 61 6e 42 65 4e 75 6c 6c 28 63 6f 6e 73 prCanBeNull(cons
298e0 74 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 t Expr*);.int sq
298f0 6c 69 74 65 33 45 78 70 72 4e 65 65 64 73 4e 6f lite3ExprNeedsNo
29900 41 66 66 69 6e 69 74 79 43 68 61 6e 67 65 28 63 AffinityChange(c
29910 6f 6e 73 74 20 45 78 70 72 2a 2c 20 63 68 61 72 onst Expr*, char
29920 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 73 );.int sqlite3Is
29930 52 6f 77 69 64 28 63 6f 6e 73 74 20 63 68 61 72 Rowid(const char
29940 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
29950 47 65 6e 65 72 61 74 65 52 6f 77 44 65 6c 65 74 GenerateRowDelet
29960 65 28 0a 20 20 20 20 50 61 72 73 65 2a 2c 54 61 e(. Parse*,Ta
29970 62 6c 65 2a 2c 54 72 69 67 67 65 72 2a 2c 69 6e ble*,Trigger*,in
29980 74 2c 69 6e 74 2c 69 6e 74 2c 69 31 36 2c 75 38 t,int,int,i16,u8
29990 2c 75 38 2c 75 38 2c 69 6e 74 29 3b 0a 76 6f 69 ,u8,u8,int);.voi
299a0 64 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 74 d sqlite3Generat
299b0 65 52 6f 77 49 6e 64 65 78 44 65 6c 65 74 65 28 eRowIndexDelete(
299c0 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 Parse*, Table*,
299d0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 int, int, int*,
299e0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
299f0 33 47 65 6e 65 72 61 74 65 49 6e 64 65 78 4b 65 3GenerateIndexKe
29a00 79 28 50 61 72 73 65 2a 2c 20 49 6e 64 65 78 2a y(Parse*, Index*
29a10 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c , int, int, int,
29a20 20 69 6e 74 2a 2c 49 6e 64 65 78 2a 2c 69 6e 74 int*,Index*,int
29a30 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
29a40 65 73 6f 6c 76 65 50 61 72 74 49 64 78 4c 61 62 esolvePartIdxLab
29a50 65 6c 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a el(Parse*,int);.
29a60 76 6f 69 64 20 73 71 6c 69 74 65 33 47 65 6e 65 void sqlite3Gene
29a70 72 61 74 65 43 6f 6e 73 74 72 61 69 6e 74 43 68 rateConstraintCh
29a80 65 63 6b 73 28 50 61 72 73 65 2a 2c 54 61 62 6c ecks(Parse*,Tabl
29a90 65 2a 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 2c e*,int*,int,int,
29aa0 69 6e 74 2c 69 6e 74 2c 0a 20 20 20 20 20 20 20 int,int,.
29ab0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 75 38 u8
29ad0 2c 75 38 2c 69 6e 74 2c 69 6e 74 2a 2c 69 6e 74 ,u8,int,int*,int
29ae0 2a 2c 55 70 73 65 72 74 2a 29 3b 0a 23 69 66 64 *,Upsert*);.#ifd
29af0 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
29b00 5f 4e 55 4c 4c 5f 54 52 49 4d 0a 20 20 76 6f 69 _NULL_TRIM. voi
29b10 64 20 73 71 6c 69 74 65 33 53 65 74 4d 61 6b 65 d sqlite3SetMake
29b20 52 65 63 6f 72 64 50 35 28 56 64 62 65 2a 2c 54 RecordP5(Vdbe*,T
29b30 61 62 6c 65 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 able*);.#else.#
29b40 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 65 define sqlite3Se
29b50 74 4d 61 6b 65 52 65 63 6f 72 64 50 35 28 41 2c tMakeRecordP5(A,
29b60 42 29 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 B).#endif.void s
29b70 71 6c 69 74 65 33 43 6f 6d 70 6c 65 74 65 49 6e qlite3CompleteIn
29b80 73 65 72 74 69 6f 6e 28 50 61 72 73 65 2a 2c 54 sertion(Parse*,T
29b90 61 62 6c 65 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e able*,int,int,in
29ba0 74 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 2c 69 t,int*,int,int,i
29bb0 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
29bc0 4f 70 65 6e 54 61 62 6c 65 41 6e 64 49 6e 64 69 OpenTableAndIndi
29bd0 63 65 73 28 50 61 72 73 65 2a 2c 20 54 61 62 6c ces(Parse*, Tabl
29be0 65 2a 2c 20 69 6e 74 2c 20 75 38 2c 20 69 6e 74 e*, int, u8, int
29bf0 2c 20 75 38 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 , u8*, int*, int
29c00 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
29c10 42 65 67 69 6e 57 72 69 74 65 4f 70 65 72 61 74 BeginWriteOperat
29c20 69 6f 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c ion(Parse*, int,
29c30 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
29c40 74 65 33 4d 75 6c 74 69 57 72 69 74 65 28 50 61 te3MultiWrite(Pa
29c50 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 rse*);.void sqli
29c60 74 65 33 4d 61 79 41 62 6f 72 74 28 50 61 72 73 te3MayAbort(Pars
29c70 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
29c80 33 48 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 3HaltConstraint(
29c90 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 Parse*, int, int
29ca0 2c 20 63 68 61 72 2a 2c 20 69 38 2c 20 75 38 29 , char*, i8, u8)
29cb0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e ;.void sqlite3Un
29cc0 69 71 75 65 43 6f 6e 73 74 72 61 69 6e 74 28 50 iqueConstraint(P
29cd0 61 72 73 65 2a 2c 20 69 6e 74 2c 20 49 6e 64 65 arse*, int, Inde
29ce0 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 x*);.void sqlite
29cf0 33 52 6f 77 69 64 43 6f 6e 73 74 72 61 69 6e 74 3RowidConstraint
29d00 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 54 61 (Parse*, int, Ta
29d10 62 6c 65 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c ble*);.Expr *sql
29d20 69 74 65 33 45 78 70 72 44 75 70 28 73 71 6c 69 ite3ExprDup(sqli
29d30 74 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b te3*,Expr*,int);
29d40 0a 45 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 .ExprList *sqlit
29d50 65 33 45 78 70 72 4c 69 73 74 44 75 70 28 73 71 e3ExprListDup(sq
29d60 6c 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a lite3*,ExprList*
29d70 2c 69 6e 74 29 3b 0a 53 72 63 4c 69 73 74 20 2a ,int);.SrcList *
29d80 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 75 sqlite3SrcListDu
29d90 70 28 73 71 6c 69 74 65 33 2a 2c 53 72 63 4c 69 p(sqlite3*,SrcLi
29da0 73 74 2a 2c 69 6e 74 29 3b 0a 49 64 4c 69 73 74 st*,int);.IdList
29db0 20 2a 73 71 6c 69 74 65 33 49 64 4c 69 73 74 44 *sqlite3IdListD
29dc0 75 70 28 73 71 6c 69 74 65 33 2a 2c 49 64 4c 69 up(sqlite3*,IdLi
29dd0 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 2a 73 71 st*);.Select *sq
29de0 6c 69 74 65 33 53 65 6c 65 63 74 44 75 70 28 73 lite3SelectDup(s
29df0 71 6c 69 74 65 33 2a 2c 53 65 6c 65 63 74 2a 2c qlite3*,Select*,
29e00 69 6e 74 29 3b 0a 23 69 66 20 53 45 4c 45 43 54 int);.#if SELECT
29e10 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 76 6f TRACE_ENABLED.vo
29e20 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 id sqlite3Select
29e30 53 65 74 4e 61 6d 65 28 53 65 6c 65 63 74 2a 2c SetName(Select*,
29e40 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 const char*);.#e
29e50 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
29e60 69 74 65 33 53 65 6c 65 63 74 53 65 74 4e 61 6d ite3SelectSetNam
29e70 65 28 41 2c 42 29 0a 23 65 6e 64 69 66 0a 76 6f e(A,B).#endif.vo
29e80 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 74 id sqlite3Insert
29e90 42 75 69 6c 74 69 6e 46 75 6e 63 73 28 46 75 6e BuiltinFuncs(Fun
29ea0 63 44 65 66 2a 2c 69 6e 74 29 3b 0a 46 75 6e 63 cDef*,int);.Func
29eb0 44 65 66 20 2a 73 71 6c 69 74 65 33 46 69 6e 64 Def *sqlite3Find
29ec0 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 Function(sqlite3
29ed0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e *,const char*,in
29ee0 74 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 20 73 t,u8,u8);.void s
29ef0 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 75 qlite3RegisterBu
29f00 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 76 iltinFunctions(v
29f10 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 oid);.void sqlit
29f20 65 33 52 65 67 69 73 74 65 72 44 61 74 65 54 69 e3RegisterDateTi
29f30 6d 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 meFunctions(void
29f40 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
29f50 65 67 69 73 74 65 72 50 65 72 43 6f 6e 6e 65 63 egisterPerConnec
29f60 74 69 6f 6e 42 75 69 6c 74 69 6e 46 75 6e 63 74 tionBuiltinFunct
29f70 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a ions(sqlite3*);.
29f80 69 6e 74 20 73 71 6c 69 74 65 33 53 61 66 65 74 int sqlite3Safet
29f90 79 43 68 65 63 6b 4f 6b 28 73 71 6c 69 74 65 33 yCheckOk(sqlite3
29fa0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 *);.int sqlite3S
29fb0 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 afetyCheckSickOr
29fc0 4f 6b 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f Ok(sqlite3*);.vo
29fd0 69 64 20 73 71 6c 69 74 65 33 43 68 61 6e 67 65 id sqlite3Change
29fe0 43 6f 6f 6b 69 65 28 50 61 72 73 65 2a 2c 20 69 Cookie(Parse*, i
29ff0 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 69 6e nt);..#if !defin
2a000 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ed(SQLITE_OMIT_V
2a010 49 45 57 29 20 26 26 20 21 64 65 66 69 6e 65 64 IEW) && !defined
2a020 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 (SQLITE_OMIT_TRI
2a030 47 47 45 52 29 0a 76 6f 69 64 20 73 71 6c 69 74 GGER).void sqlit
2a040 65 33 4d 61 74 65 72 69 61 6c 69 7a 65 56 69 65 e3MaterializeVie
2a050 77 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a w(Parse*, Table*
2a060 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 4c 69 73 , Expr*, ExprLis
2a070 74 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b 0a 23 t*,Expr*,int);.#
2a080 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
2a090 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 QLITE_OMIT_TRIGG
2a0a0 45 52 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ER. void sqlite
2a0b0 33 42 65 67 69 6e 54 72 69 67 67 65 72 28 50 61 3BeginTrigger(Pa
2a0c0 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 54 6f 6b rse*, Token*,Tok
2a0d0 65 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 49 64 4c 69 en*,int,int,IdLi
2a0e0 73 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 0a 20 20 st*,SrcList*,.
2a0f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a100 20 20 20 20 20 20 20 20 20 45 78 70 72 2a 2c 69 Expr*,i
2a110 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 nt, int);. void
2a120 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 54 72 sqlite3FinishTr
2a130 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 72 igger(Parse*, Tr
2a140 69 67 67 65 72 53 74 65 70 2a 2c 20 54 6f 6b 65 iggerStep*, Toke
2a150 6e 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 n*);. void sqli
2a160 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 28 50 te3DropTrigger(P
2a170 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c arse*, SrcList*,
2a180 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 71 int);. void sq
2a190 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 lite3DropTrigger
2a1a0 50 74 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 Ptr(Parse*, Trig
2a1b0 67 65 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 ger*);. Trigger
2a1c0 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 *sqlite3Trigger
2a1d0 73 45 78 69 73 74 28 50 61 72 73 65 20 2a 2c 20 sExist(Parse *,
2a1e0 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 45 78 70 Table*, int, Exp
2a1f0 72 4c 69 73 74 2a 2c 20 69 6e 74 20 2a 70 4d 61 rList*, int *pMa
2a200 73 6b 29 3b 0a 20 20 54 72 69 67 67 65 72 20 2a sk);. Trigger *
2a210 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 4c 69 sqlite3TriggerLi
2a220 73 74 28 50 61 72 73 65 20 2a 2c 20 54 61 62 6c st(Parse *, Tabl
2a230 65 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c e *);. void sql
2a240 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 ite3CodeRowTrigg
2a250 65 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 67 er(Parse*, Trigg
2a260 65 72 20 2a 2c 20 69 6e 74 2c 20 45 78 70 72 4c er *, int, ExprL
2a270 69 73 74 2a 2c 20 69 6e 74 2c 20 54 61 62 6c 65 ist*, int, Table
2a280 20 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 *,.
2a290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a2a0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
2a2b0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
2a2c0 64 65 52 6f 77 54 72 69 67 67 65 72 44 69 72 65 deRowTriggerDire
2a2d0 63 74 28 50 61 72 73 65 20 2a 2c 20 54 72 69 67 ct(Parse *, Trig
2a2e0 67 65 72 20 2a 2c 20 54 61 62 6c 65 20 2a 2c 20 ger *, Table *,
2a2f0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
2a300 20 20 76 6f 69 64 20 73 71 6c 69 74 65 56 69 65 void sqliteVie
2a310 77 54 72 69 67 67 65 72 73 28 50 61 72 73 65 2a wTriggers(Parse*
2a320 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a 2c , Table*, Expr*,
2a330 20 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a 29 int, ExprList*)
2a340 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
2a350 44 65 6c 65 74 65 54 72 69 67 67 65 72 53 74 65 DeleteTriggerSte
2a360 70 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 67 p(sqlite3*, Trig
2a370 67 65 72 53 74 65 70 2a 29 3b 0a 20 20 54 72 69 gerStep*);. Tri
2a380 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 65 ggerStep *sqlite
2a390 33 54 72 69 67 67 65 72 53 65 6c 65 63 74 53 74 3TriggerSelectSt
2a3a0 65 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c 65 ep(sqlite3*,Sele
2a3b0 63 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ct*,.
2a3c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a3d0 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
2a3e0 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 st char*,const c
2a3f0 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 har*);. Trigger
2a400 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 Step *sqlite3Tri
2a410 67 67 65 72 49 6e 73 65 72 74 53 74 65 70 28 73 ggerInsertStep(s
2a420 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 qlite3*,Token*,
2a430 49 64 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 IdList*,.
2a440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a460 20 53 65 6c 65 63 74 2a 2c 75 38 2c 55 70 73 65 Select*,u8,Upse
2a470 72 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 rt*,.
2a480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a490 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
2a4a0 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 st char*,const c
2a4b0 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 har*);. Trigger
2a4c0 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 Step *sqlite3Tri
2a4d0 67 67 65 72 55 70 64 61 74 65 53 74 65 70 28 73 ggerUpdateStep(s
2a4e0 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 45 qlite3*,Token*,E
2a4f0 78 70 72 4c 69 73 74 2a 2c 20 45 78 70 72 2a 2c xprList*, Expr*,
2a500 20 75 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 u8,.
2a510 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a520 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
2a530 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 st char*,const c
2a540 68 61 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 har*);. Trigger
2a550 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 Step *sqlite3Tri
2a560 67 67 65 72 44 65 6c 65 74 65 53 74 65 70 28 73 ggerDeleteStep(s
2a570 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 qlite3*,Token*,
2a580 45 78 70 72 2a 2c 0a 20 20 20 20 20 20 20 20 20 Expr*,.
2a590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2a5a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 c
2a5b0 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 onst char*,const
2a5c0 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 char*);. void
2a5d0 73 71 6c 69 74 65 33 44 65 6c 65 74 65 54 72 69 sqlite3DeleteTri
2a5e0 67 67 65 72 28 73 71 6c 69 74 65 33 2a 2c 20 54 gger(sqlite3*, T
2a5f0 72 69 67 67 65 72 2a 29 3b 0a 20 20 76 6f 69 64 rigger*);. void
2a600 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 6e sqlite3UnlinkAn
2a610 64 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 73 dDeleteTrigger(s
2a620 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 qlite3*,int,cons
2a630 74 20 63 68 61 72 2a 29 3b 0a 20 20 75 33 32 20 t char*);. u32
2a640 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 43 6f sqlite3TriggerCo
2a650 6c 6d 61 73 6b 28 50 61 72 73 65 2a 2c 54 72 69 lmask(Parse*,Tri
2a660 67 67 65 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c gger*,ExprList*,
2a670 69 6e 74 2c 69 6e 74 2c 54 61 62 6c 65 2a 2c 69 int,int,Table*,i
2a680 6e 74 29 3b 0a 23 20 64 65 66 69 6e 65 20 73 71 nt);.# define sq
2a690 6c 69 74 65 33 50 61 72 73 65 54 6f 70 6c 65 76 lite3ParseToplev
2a6a0 65 6c 28 70 29 20 28 28 70 29 2d 3e 70 54 6f 70 el(p) ((p)->pTop
2a6b0 6c 65 76 65 6c 20 3f 20 28 70 29 2d 3e 70 54 6f level ? (p)->pTo
2a6c0 70 6c 65 76 65 6c 20 3a 20 28 70 29 29 0a 23 20 plevel : (p)).#
2a6d0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 define sqlite3Is
2a6e0 54 6f 70 6c 65 76 65 6c 28 70 29 20 28 28 70 29 Toplevel(p) ((p)
2a6f0 2d 3e 70 54 6f 70 6c 65 76 65 6c 3d 3d 30 29 0a ->pToplevel==0).
2a700 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
2a710 71 6c 69 74 65 33 54 72 69 67 67 65 72 73 45 78 qlite3TriggersEx
2a720 69 73 74 28 42 2c 43 2c 44 2c 45 2c 46 29 20 30 ist(B,C,D,E,F) 0
2a730 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2a740 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 41 3DeleteTrigger(A
2a750 2c 42 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ,B).# define sql
2a760 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 50 ite3DropTriggerP
2a770 74 72 28 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 tr(A,B).# define
2a780 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 6e sqlite3UnlinkAn
2a790 64 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 41 dDeleteTrigger(A
2a7a0 2c 42 2c 43 29 0a 23 20 64 65 66 69 6e 65 20 73 ,B,C).# define s
2a7b0 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 qlite3CodeRowTri
2a7c0 67 67 65 72 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 gger(A,B,C,D,E,F
2a7d0 2c 47 2c 48 2c 49 29 0a 23 20 64 65 66 69 6e 65 ,G,H,I).# define
2a7e0 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 sqlite3CodeRowT
2a7f0 72 69 67 67 65 72 44 69 72 65 63 74 28 41 2c 42 riggerDirect(A,B
2a800 2c 43 2c 44 2c 45 2c 46 29 0a 23 20 64 65 66 69 ,C,D,E,F).# defi
2a810 6e 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 ne sqlite3Trigge
2a820 72 4c 69 73 74 28 58 2c 20 59 29 20 30 0a 23 20 rList(X, Y) 0.#
2a830 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 50 61 define sqlite3Pa
2a840 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 29 20 70 rseToplevel(p) p
2a850 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2a860 33 49 73 54 6f 70 6c 65 76 65 6c 28 70 29 20 31 3IsToplevel(p) 1
2a870 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2a880 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 73 6b 28 3TriggerColmask(
2a890 41 2c 42 2c 43 2c 44 2c 45 2c 46 2c 47 29 20 30 A,B,C,D,E,F,G) 0
2a8a0 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 6c .#endif..int sql
2a8b0 69 74 65 33 4a 6f 69 6e 54 79 70 65 28 50 61 72 ite3JoinType(Par
2a8c0 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b se*, Token*, Tok
2a8d0 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f en*, Token*);.vo
2a8e0 69 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 id sqlite3Create
2a8f0 46 6f 72 65 69 67 6e 4b 65 79 28 50 61 72 73 65 ForeignKey(Parse
2a900 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 54 6f *, ExprList*, To
2a910 6b 65 6e 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c ken*, ExprList*,
2a920 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
2a930 74 65 33 44 65 66 65 72 46 6f 72 65 69 67 6e 4b te3DeferForeignK
2a940 65 79 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b ey(Parse*, int);
2a950 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2a960 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 OMIT_AUTHORIZATI
2a970 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ON. void sqlite
2a980 33 41 75 74 68 52 65 61 64 28 50 61 72 73 65 2a 3AuthRead(Parse*
2a990 2c 45 78 70 72 2a 2c 53 63 68 65 6d 61 2a 2c 53 ,Expr*,Schema*,S
2a9a0 72 63 4c 69 73 74 2a 29 3b 0a 20 20 69 6e 74 20 rcList*);. int
2a9b0 73 71 6c 69 74 65 33 41 75 74 68 43 68 65 63 6b sqlite3AuthCheck
2a9c0 28 50 61 72 73 65 2a 2c 69 6e 74 2c 20 63 6f 6e (Parse*,int, con
2a9d0 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
2a9e0 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 char*, const cha
2a9f0 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 r*);. void sqli
2aa00 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 50 75 te3AuthContextPu
2aa10 73 68 28 50 61 72 73 65 2a 2c 20 41 75 74 68 43 sh(Parse*, AuthC
2aa20 6f 6e 74 65 78 74 2a 2c 20 63 6f 6e 73 74 20 63 ontext*, const c
2aa30 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 har*);. void sq
2aa40 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 lite3AuthContext
2aa50 50 6f 70 28 41 75 74 68 43 6f 6e 74 65 78 74 2a Pop(AuthContext*
2aa60 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
2aa70 41 75 74 68 52 65 61 64 43 6f 6c 28 50 61 72 73 AuthReadCol(Pars
2aa80 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a e*, const char *
2aa90 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 , const char *,
2aaa0 69 6e 74 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 int);.#else.# de
2aab0 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 fine sqlite3Auth
2aac0 52 65 61 64 28 61 2c 62 2c 63 2c 64 29 0a 23 20 Read(a,b,c,d).#
2aad0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 define sqlite3Au
2aae0 74 68 43 68 65 63 6b 28 61 2c 62 2c 63 2c 64 2c thCheck(a,b,c,d,
2aaf0 65 29 20 20 20 20 53 51 4c 49 54 45 5f 4f 4b 0a e) SQLITE_OK.
2ab00 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
2ab10 41 75 74 68 43 6f 6e 74 65 78 74 50 75 73 68 28 AuthContextPush(
2ab20 61 2c 62 2c 63 29 0a 23 20 64 65 66 69 6e 65 20 a,b,c).# define
2ab30 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 65 sqlite3AuthConte
2ab40 78 74 50 6f 70 28 61 29 20 20 28 28 76 6f 69 64 xtPop(a) ((void
2ab50 29 28 61 29 29 0a 23 65 6e 64 69 66 0a 76 6f 69 )(a)).#endif.voi
2ab60 64 20 73 71 6c 69 74 65 33 41 74 74 61 63 68 28 d sqlite3Attach(
2ab70 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 45 Parse*, Expr*, E
2ab80 78 70 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f xpr*, Expr*);.vo
2ab90 69 64 20 73 71 6c 69 74 65 33 44 65 74 61 63 68 id sqlite3Detach
2aba0 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b (Parse*, Expr*);
2abb0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 69 78 .void sqlite3Fix
2abc0 49 6e 69 74 28 44 62 46 69 78 65 72 2a 2c 20 50 Init(DbFixer*, P
2abd0 61 72 73 65 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 arse*, int, cons
2abe0 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 54 t char*, const T
2abf0 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 oken*);.int sqli
2ac00 74 65 33 46 69 78 53 72 63 4c 69 73 74 28 44 62 te3FixSrcList(Db
2ac10 46 69 78 65 72 2a 2c 20 53 72 63 4c 69 73 74 2a Fixer*, SrcList*
2ac20 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 );.int sqlite3Fi
2ac30 78 53 65 6c 65 63 74 28 44 62 46 69 78 65 72 2a xSelect(DbFixer*
2ac40 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 , Select*);.int
2ac50 73 71 6c 69 74 65 33 46 69 78 45 78 70 72 28 44 sqlite3FixExpr(D
2ac60 62 46 69 78 65 72 2a 2c 20 45 78 70 72 2a 29 3b bFixer*, Expr*);
2ac70 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 45 .int sqlite3FixE
2ac80 78 70 72 4c 69 73 74 28 44 62 46 69 78 65 72 2a xprList(DbFixer*
2ac90 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a 69 6e , ExprList*);.in
2aca0 74 20 73 71 6c 69 74 65 33 46 69 78 54 72 69 67 t sqlite3FixTrig
2acb0 67 65 72 53 74 65 70 28 44 62 46 69 78 65 72 2a gerStep(DbFixer*
2acc0 2c 20 54 72 69 67 67 65 72 53 74 65 70 2a 29 3b , TriggerStep*);
2acd0 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 74 6f 46 .int sqlite3AtoF
2ace0 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 (const char *z,
2acf0 64 6f 75 62 6c 65 2a 2c 20 69 6e 74 2c 20 75 38 double*, int, u8
2ad00 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 65 );.int sqlite3Ge
2ad10 74 49 6e 74 33 32 28 63 6f 6e 73 74 20 63 68 61 tInt32(const cha
2ad20 72 20 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 r *, int*);.int
2ad30 73 71 6c 69 74 65 33 41 74 6f 69 28 63 6f 6e 73 sqlite3Atoi(cons
2ad40 74 20 63 68 61 72 2a 29 3b 0a 23 69 66 6e 64 65 t char*);.#ifnde
2ad50 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 f SQLITE_OMIT_UT
2ad60 46 31 36 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 F16.int sqlite3U
2ad70 74 66 31 36 42 79 74 65 4c 65 6e 28 63 6f 6e 73 tf16ByteLen(cons
2ad80 74 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 69 t void *pData, i
2ad90 6e 74 20 6e 43 68 61 72 29 3b 0a 23 65 6e 64 69 nt nChar);.#endi
2ada0 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 74 66 f.int sqlite3Utf
2adb0 38 43 68 61 72 4c 65 6e 28 63 6f 6e 73 74 20 63 8CharLen(const c
2adc0 68 61 72 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 har *pData, int
2add0 6e 42 79 74 65 29 3b 0a 75 33 32 20 73 71 6c 69 nByte);.u32 sqli
2ade0 74 65 33 55 74 66 38 52 65 61 64 28 63 6f 6e 73 te3Utf8Read(cons
2adf0 74 20 75 38 2a 2a 29 3b 0a 4c 6f 67 45 73 74 20 t u8**);.LogEst
2ae00 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 75 36 sqlite3LogEst(u6
2ae10 34 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 4);.LogEst sqlit
2ae20 65 33 4c 6f 67 45 73 74 41 64 64 28 4c 6f 67 45 e3LogEstAdd(LogE
2ae30 73 74 2c 4c 6f 67 45 73 74 29 3b 0a 23 69 66 6e st,LogEst);.#ifn
2ae40 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2ae50 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 4c 6f 67 VIRTUALTABLE.Log
2ae60 45 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 Est sqlite3LogEs
2ae70 74 46 72 6f 6d 44 6f 75 62 6c 65 28 64 6f 75 62 tFromDouble(doub
2ae80 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 le);.#endif.#if
2ae90 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
2aea0 4e 41 42 4c 45 5f 53 54 4d 54 5f 53 43 41 4e 53 NABLE_STMT_SCANS
2aeb0 54 41 54 55 53 29 20 7c 7c 20 5c 0a 20 20 20 20 TATUS) || \.
2aec0 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
2aed0 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 NABLE_STAT3_OR_S
2aee0 54 41 54 34 29 20 7c 7c 20 5c 0a 20 20 20 20 64 TAT4) || \. d
2aef0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 58 efined(SQLITE_EX
2af00 50 4c 41 49 4e 5f 45 53 54 49 4d 41 54 45 44 5f PLAIN_ESTIMATED_
2af10 52 4f 57 53 29 0a 75 36 34 20 73 71 6c 69 74 65 ROWS).u64 sqlite
2af20 33 4c 6f 67 45 73 74 54 6f 49 6e 74 28 4c 6f 67 3LogEstToInt(Log
2af30 45 73 74 29 3b 0a 23 65 6e 64 69 66 0a 56 4c 69 Est);.#endif.VLi
2af40 73 74 20 2a 73 71 6c 69 74 65 33 56 4c 69 73 74 st *sqlite3VList
2af50 41 64 64 28 73 71 6c 69 74 65 33 2a 2c 56 4c 69 Add(sqlite3*,VLi
2af60 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c st*,const char*,
2af70 69 6e 74 2c 69 6e 74 29 3b 0a 63 6f 6e 73 74 20 int,int);.const
2af80 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 4c 69 char *sqlite3VLi
2af90 73 74 4e 75 6d 54 6f 4e 61 6d 65 28 56 4c 69 73 stNumToName(VLis
2afa0 74 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c t*,int);.int sql
2afb0 69 74 65 33 56 4c 69 73 74 4e 61 6d 65 54 6f 4e ite3VListNameToN
2afc0 75 6d 28 56 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 um(VList*,const
2afd0 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 0a 2f 2a 0a char*,int);../*.
2afe0 2a 2a 20 52 6f 75 74 69 6e 65 73 20 74 6f 20 72 ** Routines to r
2aff0 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 76 61 ead and write va
2b000 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e riable-length in
2b010 74 65 67 65 72 73 2e 20 20 54 68 65 73 65 20 75 tegers. These u
2b020 73 65 64 20 74 6f 0a 2a 2a 20 62 65 20 64 65 66 sed to.** be def
2b030 69 6e 65 64 20 6c 6f 63 61 6c 6c 79 2c 20 62 75 ined locally, bu
2b040 74 20 6e 6f 77 20 77 65 20 75 73 65 20 74 68 65 t now we use the
2b050 20 76 61 72 69 6e 74 20 72 6f 75 74 69 6e 65 73 varint routines
2b060 20 69 6e 20 74 68 65 20 75 74 69 6c 2e 63 0a 2a in the util.c.*
2b070 2a 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 20 73 * file..*/.int s
2b080 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e 74 28 qlite3PutVarint(
2b090 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 2c 20 unsigned char*,
2b0a0 75 36 34 29 3b 0a 75 38 20 73 71 6c 69 74 65 33 u64);.u8 sqlite3
2b0b0 47 65 74 56 61 72 69 6e 74 28 63 6f 6e 73 74 20 GetVarint(const
2b0c0 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 2c unsigned char *,
2b0d0 20 75 36 34 20 2a 29 3b 0a 75 38 20 73 71 6c 69 u64 *);.u8 sqli
2b0e0 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 63 te3GetVarint32(c
2b0f0 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
2b100 61 72 20 2a 2c 20 75 33 32 20 2a 29 3b 0a 69 6e ar *, u32 *);.in
2b110 74 20 73 71 6c 69 74 65 33 56 61 72 69 6e 74 4c t sqlite3VarintL
2b120 65 6e 28 75 36 34 20 76 29 3b 0a 0a 2f 2a 0a 2a en(u64 v);../*.*
2b130 2a 20 54 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 * The common cas
2b140 65 20 69 73 20 66 6f 72 20 61 20 76 61 72 69 6e e is for a varin
2b150 74 20 74 6f 20 62 65 20 61 20 73 69 6e 67 6c 65 t to be a single
2b160 20 62 79 74 65 2e 20 20 54 68 65 79 20 66 6f 6c byte. They fol
2b170 6c 6f 77 69 6e 67 0a 2a 2a 20 6d 61 63 72 6f 73 lowing.** macros
2b180 20 68 61 6e 64 6c 65 20 74 68 65 20 63 6f 6d 6d handle the comm
2b190 6f 6e 20 63 61 73 65 20 77 69 74 68 6f 75 74 20 on case without
2b1a0 61 20 70 72 6f 63 65 64 75 72 65 20 63 61 6c 6c a procedure call
2b1b0 2c 20 62 75 74 20 74 68 65 6e 20 63 61 6c 6c 0a , but then call.
2b1c0 2a 2a 20 74 68 65 20 70 72 6f 63 65 64 75 72 65 ** the procedure
2b1d0 20 66 6f 72 20 6c 61 72 67 65 72 20 76 61 72 69 for larger vari
2b1e0 6e 74 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 nts..*/.#define
2b1f0 67 65 74 56 61 72 69 6e 74 33 32 28 41 2c 42 29 getVarint32(A,B)
2b200 20 20 5c 0a 20 20 28 75 38 29 28 28 2a 28 41 29 \. (u8)((*(A)
2b210 3c 28 75 38 29 30 78 38 30 29 3f 28 28 42 29 3d <(u8)0x80)?((B)=
2b220 28 75 33 32 29 2a 28 41 29 29 2c 31 3a 73 71 6c (u32)*(A)),1:sql
2b230 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 ite3GetVarint32(
2b240 28 41 29 2c 28 75 33 32 20 2a 29 26 28 42 29 29 (A),(u32 *)&(B))
2b250 29 0a 23 64 65 66 69 6e 65 20 70 75 74 56 61 72 ).#define putVar
2b260 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a 20 20 int32(A,B) \.
2b270 28 75 38 29 28 28 28 75 33 32 29 28 42 29 3c 28 (u8)(((u32)(B)<(
2b280 75 33 32 29 30 78 38 30 29 3f 28 2a 28 41 29 3d u32)0x80)?(*(A)=
2b290 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
2b2a0 42 29 29 2c 31 3a 5c 0a 20 20 73 71 6c 69 74 65 B)),1:\. sqlite
2b2b0 33 50 75 74 56 61 72 69 6e 74 28 28 41 29 2c 28 3PutVarint((A),(
2b2c0 42 29 29 29 0a 23 64 65 66 69 6e 65 20 67 65 74 B))).#define get
2b2d0 56 61 72 69 6e 74 20 20 20 20 73 71 6c 69 74 65 Varint sqlite
2b2e0 33 47 65 74 56 61 72 69 6e 74 0a 23 64 65 66 69 3GetVarint.#defi
2b2f0 6e 65 20 70 75 74 56 61 72 69 6e 74 20 20 20 20 ne putVarint
2b300 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e 74 sqlite3PutVarint
2b310 0a 0a 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 ...const char *s
2b320 71 6c 69 74 65 33 49 6e 64 65 78 41 66 66 69 6e qlite3IndexAffin
2b330 69 74 79 53 74 72 28 73 71 6c 69 74 65 33 2a 2c ityStr(sqlite3*,
2b340 20 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 Index*);.void s
2b350 71 6c 69 74 65 33 54 61 62 6c 65 41 66 66 69 6e qlite3TableAffin
2b360 69 74 79 28 56 64 62 65 2a 2c 20 54 61 62 6c 65 ity(Vdbe*, Table
2b370 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 73 71 *, int);.char sq
2b380 6c 69 74 65 33 43 6f 6d 70 61 72 65 41 66 66 69 lite3CompareAffi
2b390 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 72 nity(Expr *pExpr
2b3a0 2c 20 63 68 61 72 20 61 66 66 32 29 3b 0a 69 6e , char aff2);.in
2b3b0 74 20 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 t sqlite3IndexAf
2b3c0 66 69 6e 69 74 79 4f 6b 28 45 78 70 72 20 2a 70 finityOk(Expr *p
2b3d0 45 78 70 72 2c 20 63 68 61 72 20 69 64 78 5f 61 Expr, char idx_a
2b3e0 66 66 69 6e 69 74 79 29 3b 0a 63 68 61 72 20 73 ffinity);.char s
2b3f0 71 6c 69 74 65 33 54 61 62 6c 65 43 6f 6c 75 6d qlite3TableColum
2b400 6e 41 66 66 69 6e 69 74 79 28 54 61 62 6c 65 2a nAffinity(Table*
2b410 2c 69 6e 74 29 3b 0a 63 68 61 72 20 73 71 6c 69 ,int);.char sqli
2b420 74 65 33 45 78 70 72 41 66 66 69 6e 69 74 79 28 te3ExprAffinity(
2b430 45 78 70 72 20 2a 70 45 78 70 72 29 3b 0a 69 6e Expr *pExpr);.in
2b440 74 20 73 71 6c 69 74 65 33 41 74 6f 69 36 34 28 t sqlite3Atoi64(
2b450 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 36 34 const char*, i64
2b460 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 6e 74 *, int, u8);.int
2b470 20 73 71 6c 69 74 65 33 44 65 63 4f 72 48 65 78 sqlite3DecOrHex
2b480 54 6f 49 36 34 28 63 6f 6e 73 74 20 63 68 61 72 ToI64(const char
2b490 2a 2c 20 69 36 34 2a 29 3b 0a 76 6f 69 64 20 73 *, i64*);.void s
2b4a0 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d qlite3ErrorWithM
2b4b0 73 67 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 sg(sqlite3*, int
2b4c0 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 2e 2e , const char*,..
2b4d0 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .);.void sqlite3
2b4e0 45 72 72 6f 72 28 73 71 6c 69 74 65 33 2a 2c 69 Error(sqlite3*,i
2b4f0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
2b500 33 53 79 73 74 65 6d 45 72 72 6f 72 28 73 71 6c 3SystemError(sql
2b510 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 ite3*,int);.void
2b520 20 2a 73 71 6c 69 74 65 33 48 65 78 54 6f 42 6c *sqlite3HexToBl
2b530 6f 62 28 73 71 6c 69 74 65 33 2a 2c 20 63 6f 6e ob(sqlite3*, con
2b540 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 st char *z, int
2b550 6e 29 3b 0a 75 38 20 73 71 6c 69 74 65 33 48 65 n);.u8 sqlite3He
2b560 78 54 6f 49 6e 74 28 69 6e 74 20 68 29 3b 0a 69 xToInt(int h);.i
2b570 6e 74 20 73 71 6c 69 74 65 33 54 77 6f 50 61 72 nt sqlite3TwoPar
2b580 74 4e 61 6d 65 28 50 61 72 73 65 20 2a 2c 20 54 tName(Parse *, T
2b590 6f 6b 65 6e 20 2a 2c 20 54 6f 6b 65 6e 20 2a 2c oken *, Token *,
2b5a0 20 54 6f 6b 65 6e 20 2a 2a 29 3b 0a 0a 23 69 66 Token **);..#if
2b5b0 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
2b5c0 4e 45 45 44 5f 45 52 52 5f 4e 41 4d 45 29 0a 63 NEED_ERR_NAME).c
2b5d0 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
2b5e0 65 33 45 72 72 4e 61 6d 65 28 69 6e 74 29 3b 0a e3ErrName(int);.
2b5f0 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 #endif..#ifdef S
2b600 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 44 45 53 QLITE_ENABLE_DES
2b610 45 52 49 41 4c 49 5a 45 0a 69 6e 74 20 73 71 6c ERIALIZE.int sql
2b620 69 74 65 33 4d 65 6d 64 62 49 6e 69 74 28 76 6f ite3MemdbInit(vo
2b630 69 64 29 3b 0a 23 65 6e 64 69 66 0a 0a 63 6f 6e id);.#endif..con
2b640 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
2b650 45 72 72 53 74 72 28 69 6e 74 29 3b 0a 69 6e 74 ErrStr(int);.int
2b660 20 73 71 6c 69 74 65 33 52 65 61 64 53 63 68 65 sqlite3ReadSche
2b670 6d 61 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 ma(Parse *pParse
2b680 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
2b690 74 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 73 te3FindCollSeq(s
2b6a0 71 6c 69 74 65 33 2a 2c 75 38 20 65 6e 63 2c 20 qlite3*,u8 enc,
2b6b0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 const char*,int)
2b6c0 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 ;.CollSeq *sqlit
2b6d0 65 33 4c 6f 63 61 74 65 43 6f 6c 6c 53 65 71 28 e3LocateCollSeq(
2b6e0 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 63 Parse *pParse, c
2b6f0 6f 6e 73 74 20 63 68 61 72 2a 7a 4e 61 6d 65 29 onst char*zName)
2b700 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 ;.CollSeq *sqlit
2b710 65 33 45 78 70 72 43 6f 6c 6c 53 65 71 28 50 61 e3ExprCollSeq(Pa
2b720 72 73 65 20 2a 70 50 61 72 73 65 2c 20 45 78 70 rse *pParse, Exp
2b730 72 20 2a 70 45 78 70 72 29 3b 0a 43 6f 6c 6c 53 r *pExpr);.CollS
2b740 65 71 20 2a 73 71 6c 69 74 65 33 45 78 70 72 4e eq *sqlite3ExprN
2b750 4e 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a NCollSeq(Parse *
2b760 70 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 45 pParse, Expr *pE
2b770 78 70 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 xpr);.int sqlite
2b780 33 45 78 70 72 43 6f 6c 6c 53 65 71 4d 61 74 63 3ExprCollSeqMatc
2b790 68 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c 45 h(Parse*,Expr*,E
2b7a0 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c xpr*);.Expr *sql
2b7b0 69 74 65 33 45 78 70 72 41 64 64 43 6f 6c 6c 61 ite3ExprAddColla
2b7c0 74 65 54 6f 6b 65 6e 28 50 61 72 73 65 20 2a 70 teToken(Parse *p
2b7d0 50 61 72 73 65 2c 20 45 78 70 72 2a 2c 20 63 6f Parse, Expr*, co
2b7e0 6e 73 74 20 54 6f 6b 65 6e 2a 2c 20 69 6e 74 29 nst Token*, int)
2b7f0 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 ;.Expr *sqlite3E
2b800 78 70 72 41 64 64 43 6f 6c 6c 61 74 65 53 74 72 xprAddCollateStr
2b810 69 6e 67 28 50 61 72 73 65 2a 2c 45 78 70 72 2a ing(Parse*,Expr*
2b820 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 45 ,const char*);.E
2b830 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 xpr *sqlite3Expr
2b840 53 6b 69 70 43 6f 6c 6c 61 74 65 28 45 78 70 72 SkipCollate(Expr
2b850 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 *);.int sqlite3C
2b860 68 65 63 6b 43 6f 6c 6c 53 65 71 28 50 61 72 73 heckCollSeq(Pars
2b870 65 20 2a 2c 20 43 6f 6c 6c 53 65 71 20 2a 29 3b e *, CollSeq *);
2b880 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 .int sqlite3Chec
2b890 6b 4f 62 6a 65 63 74 4e 61 6d 65 28 50 61 72 73 kObjectName(Pars
2b8a0 65 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 e *, const char
2b8b0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2b8c0 56 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 73 VdbeSetChanges(s
2b8d0 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 29 3b 0a qlite3 *, int);.
2b8e0 69 6e 74 20 73 71 6c 69 74 65 33 41 64 64 49 6e int sqlite3AddIn
2b8f0 74 36 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 t64(i64*,i64);.i
2b900 6e 74 20 73 71 6c 69 74 65 33 53 75 62 49 6e 74 nt sqlite3SubInt
2b910 36 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 64(i64*,i64);.in
2b920 74 20 73 71 6c 69 74 65 33 4d 75 6c 49 6e 74 36 t sqlite3MulInt6
2b930 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 4(i64*,i64);.int
2b940 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 sqlite3AbsInt32
2b950 28 69 6e 74 29 3b 0a 23 69 66 64 65 66 20 53 51 (int);.#ifdef SQ
2b960 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 5f LITE_ENABLE_8_3_
2b970 4e 41 4d 45 53 0a 76 6f 69 64 20 73 71 6c 69 74 NAMES.void sqlit
2b980 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 63 6f e3FileSuffix3(co
2b990 6e 73 74 20 63 68 61 72 2a 2c 20 63 68 61 72 2a nst char*, char*
2b9a0 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e );.#else.# defin
2b9b0 65 20 73 71 6c 69 74 65 33 46 69 6c 65 53 75 66 e sqlite3FileSuf
2b9c0 66 69 78 33 28 58 2c 59 29 0a 23 65 6e 64 69 66 fix3(X,Y).#endif
2b9d0 0a 75 38 20 73 71 6c 69 74 65 33 47 65 74 42 6f .u8 sqlite3GetBo
2b9e0 6f 6c 65 61 6e 28 63 6f 6e 73 74 20 63 68 61 72 olean(const char
2b9f0 20 2a 7a 2c 75 38 29 3b 0a 0a 63 6f 6e 73 74 20 *z,u8);..const
2ba00 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 56 61 6c void *sqlite3Val
2ba10 75 65 54 65 78 74 28 73 71 6c 69 74 65 33 5f 76 ueText(sqlite3_v
2ba20 61 6c 75 65 2a 2c 20 75 38 29 3b 0a 69 6e 74 20 alue*, u8);.int
2ba30 73 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 sqlite3ValueByte
2ba40 73 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a s(sqlite3_value*
2ba50 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 , u8);.void sqli
2ba60 74 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 73 te3ValueSetStr(s
2ba70 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2c 20 69 qlite3_value*, i
2ba80 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a nt, const void *
2ba90 2c 75 38 2c 0a 20 20 20 20 20 20 20 20 20 20 20 ,u8,.
2baa0 20 20 20 20 20 20 20 20 20 20 20 20 20 76 6f 69 voi
2bab0 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f d(*)(void*));.vo
2bac0 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 id sqlite3ValueS
2bad0 65 74 4e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 76 etNull(sqlite3_v
2bae0 61 6c 75 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c alue*);.void sql
2baf0 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 73 71 ite3ValueFree(sq
2bb00 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 3b 0a 73 lite3_value*);.s
2bb10 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 73 71 qlite3_value *sq
2bb20 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 73 71 lite3ValueNew(sq
2bb30 6c 69 74 65 33 20 2a 29 3b 0a 23 69 66 6e 64 65 lite3 *);.#ifnde
2bb40 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 f SQLITE_OMIT_UT
2bb50 46 31 36 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 F16.char *sqlite
2bb60 33 55 74 66 31 36 74 6f 38 28 73 71 6c 69 74 65 3Utf16to8(sqlite
2bb70 33 20 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 3 *, const void*
2bb80 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 23 65 6e 64 , int, u8);.#end
2bb90 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 61 if.int sqlite3Va
2bba0 6c 75 65 46 72 6f 6d 45 78 70 72 28 73 71 6c 69 lueFromExpr(sqli
2bbb0 74 65 33 20 2a 2c 20 45 78 70 72 20 2a 2c 20 75 te3 *, Expr *, u
2bbc0 38 2c 20 75 38 2c 20 73 71 6c 69 74 65 33 5f 76 8, u8, sqlite3_v
2bbd0 61 6c 75 65 20 2a 2a 29 3b 0a 76 6f 69 64 20 73 alue **);.void s
2bbe0 71 6c 69 74 65 33 56 61 6c 75 65 41 70 70 6c 79 qlite3ValueApply
2bbf0 41 66 66 69 6e 69 74 79 28 73 71 6c 69 74 65 33 Affinity(sqlite3
2bc00 5f 76 61 6c 75 65 20 2a 2c 20 75 38 2c 20 75 38 _value *, u8, u8
2bc10 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 );.#ifndef SQLIT
2bc20 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a 65 E_AMALGAMATION.e
2bc30 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e 73 69 xtern const unsi
2bc40 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 74 65 gned char sqlite
2bc50 33 4f 70 63 6f 64 65 50 72 6f 70 65 72 74 79 5b 3OpcodeProperty[
2bc60 5d 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 ];.extern const
2bc70 63 68 61 72 20 73 71 6c 69 74 65 33 53 74 72 42 char sqlite3StrB
2bc80 49 4e 41 52 59 5b 5d 3b 0a 65 78 74 65 72 6e 20 INARY[];.extern
2bc90 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 const unsigned c
2bca0 68 61 72 20 73 71 6c 69 74 65 33 55 70 70 65 72 har sqlite3Upper
2bcb0 54 6f 4c 6f 77 65 72 5b 5d 3b 0a 65 78 74 65 72 ToLower[];.exter
2bcc0 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 n const unsigned
2bcd0 20 63 68 61 72 20 73 71 6c 69 74 65 33 43 74 79 char sqlite3Cty
2bce0 70 65 4d 61 70 5b 5d 3b 0a 65 78 74 65 72 6e 20 peMap[];.extern
2bcf0 63 6f 6e 73 74 20 54 6f 6b 65 6e 20 73 71 6c 69 const Token sqli
2bd00 74 65 33 49 6e 74 54 6f 6b 65 6e 73 5b 5d 3b 0a te3IntTokens[];.
2bd10 65 78 74 65 72 6e 20 53 51 4c 49 54 45 5f 57 53 extern SQLITE_WS
2bd20 44 20 73 74 72 75 63 74 20 53 71 6c 69 74 65 33 D struct Sqlite3
2bd30 43 6f 6e 66 69 67 20 73 71 6c 69 74 65 33 43 6f Config sqlite3Co
2bd40 6e 66 69 67 3b 0a 65 78 74 65 72 6e 20 46 75 6e nfig;.extern Fun
2bd50 63 44 65 66 48 61 73 68 20 73 71 6c 69 74 65 33 cDefHash sqlite3
2bd60 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 BuiltinFunctions
2bd70 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
2bd80 5f 4f 4d 49 54 5f 57 53 44 0a 65 78 74 65 72 6e _OMIT_WSD.extern
2bd90 20 69 6e 74 20 73 71 6c 69 74 65 33 50 65 6e 64 int sqlite3Pend
2bda0 69 6e 67 42 79 74 65 3b 0a 23 65 6e 64 69 66 0a ingByte;.#endif.
2bdb0 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 56 44 #endif.#ifdef VD
2bdc0 42 45 5f 50 52 4f 46 49 4c 45 0a 65 78 74 65 72 BE_PROFILE.exter
2bdd0 6e 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34 n sqlite3_uint64
2bde0 20 73 71 6c 69 74 65 33 4e 50 72 6f 66 69 6c 65 sqlite3NProfile
2bdf0 43 6e 74 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 64 Cnt;.#endif.void
2be00 20 73 71 6c 69 74 65 33 52 6f 6f 74 50 61 67 65 sqlite3RootPage
2be10 4d 6f 76 65 64 28 73 71 6c 69 74 65 33 2a 2c 20 Moved(sqlite3*,
2be20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
2be30 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 69 6e void sqlite3Rein
2be40 64 65 78 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 dex(Parse*, Toke
2be50 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 n*, Token*);.voi
2be60 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 46 75 d sqlite3AlterFu
2be70 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a 76 nctions(void);.v
2be80 6f 69 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 oid sqlite3Alter
2be90 52 65 6e 61 6d 65 54 61 62 6c 65 28 50 61 72 73 RenameTable(Pars
2bea0 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f e*, SrcList*, To
2beb0 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ken*);.int sqlit
2bec0 65 33 47 65 74 54 6f 6b 65 6e 28 63 6f 6e 73 74 e3GetToken(const
2bed0 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a unsigned char *
2bee0 2c 20 69 6e 74 20 2a 29 3b 0a 76 6f 69 64 20 73 , int *);.void s
2bef0 71 6c 69 74 65 33 4e 65 73 74 65 64 50 61 72 73 qlite3NestedPars
2bf00 65 28 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 e(Parse*, const
2bf10 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 char*, ...);.voi
2bf20 64 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 d sqlite3ExpireP
2bf30 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 reparedStatement
2bf40 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 s(sqlite3*);.int
2bf50 20 73 71 6c 69 74 65 33 43 6f 64 65 53 75 62 73 sqlite3CodeSubs
2bf60 65 6c 65 63 74 28 50 61 72 73 65 2a 2c 20 45 78 elect(Parse*, Ex
2bf70 70 72 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b pr *, int, int);
2bf80 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c .void sqlite3Sel
2bf90 65 63 74 50 72 65 70 28 50 61 72 73 65 2a 2c 20 ectPrep(Parse*,
2bfa0 53 65 6c 65 63 74 2a 2c 20 4e 61 6d 65 43 6f 6e Select*, NameCon
2bfb0 74 65 78 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c text*);.void sql
2bfc0 69 74 65 33 53 65 6c 65 63 74 57 72 6f 6e 67 4e ite3SelectWrongN
2bfd0 75 6d 54 65 72 6d 73 45 72 72 6f 72 28 50 61 72 umTermsError(Par
2bfe0 73 65 20 2a 70 50 61 72 73 65 2c 20 53 65 6c 65 se *pParse, Sele
2bff0 63 74 20 2a 70 29 3b 0a 69 6e 74 20 73 71 6c 69 ct *p);.int sqli
2c000 74 65 33 4d 61 74 63 68 53 70 61 6e 4e 61 6d 65 te3MatchSpanName
2c010 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f (const char*, co
2c020 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 nst char*, const
2c030 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 char*, const ch
2c040 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 ar*);.int sqlite
2c050 33 52 65 73 6f 6c 76 65 45 78 70 72 4e 61 6d 65 3ResolveExprName
2c060 73 28 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 2c 20 s(NameContext*,
2c070 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Expr*);.int sqli
2c080 74 65 33 52 65 73 6f 6c 76 65 45 78 70 72 4c 69 te3ResolveExprLi
2c090 73 74 4e 61 6d 65 73 28 4e 61 6d 65 43 6f 6e 74 stNames(NameCont
2c0a0 65 78 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 ext*, ExprList*)
2c0b0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 ;.void sqlite3Re
2c0c0 73 6f 6c 76 65 53 65 6c 65 63 74 4e 61 6d 65 73 solveSelectNames
2c0d0 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a (Parse*, Select*
2c0e0 2c 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 29 3b , NameContext*);
2c0f0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 .void sqlite3Res
2c100 6f 6c 76 65 53 65 6c 66 52 65 66 65 72 65 6e 63 olveSelfReferenc
2c110 65 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c e(Parse*,Table*,
2c120 69 6e 74 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 int,Expr*,ExprLi
2c130 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 st*);.int sqlite
2c140 33 52 65 73 6f 6c 76 65 4f 72 64 65 72 47 72 6f 3ResolveOrderGro
2c150 75 70 42 79 28 50 61 72 73 65 2a 2c 20 53 65 6c upBy(Parse*, Sel
2c160 65 63 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c ect*, ExprList*,
2c170 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 const char*);.v
2c180 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d oid sqlite3Colum
2c190 6e 44 65 66 61 75 6c 74 28 56 64 62 65 20 2a 2c nDefault(Vdbe *,
2c1a0 20 54 61 62 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 Table *, int, i
2c1b0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
2c1c0 33 41 6c 74 65 72 46 69 6e 69 73 68 41 64 64 43 3AlterFinishAddC
2c1d0 6f 6c 75 6d 6e 28 50 61 72 73 65 20 2a 2c 20 54 olumn(Parse *, T
2c1e0 6f 6b 65 6e 20 2a 29 3b 0a 76 6f 69 64 20 73 71 oken *);.void sq
2c1f0 6c 69 74 65 33 41 6c 74 65 72 42 65 67 69 6e 41 lite3AlterBeginA
2c200 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 20 2a ddColumn(Parse *
2c210 2c 20 53 72 63 4c 69 73 74 20 2a 29 3b 0a 43 6f , SrcList *);.Co
2c220 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 47 65 llSeq *sqlite3Ge
2c230 74 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 2a 2c tCollSeq(Parse*,
2c240 20 75 38 2c 20 43 6f 6c 6c 53 65 71 20 2a 2c 20 u8, CollSeq *,
2c250 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 63 68 const char*);.ch
2c260 61 72 20 73 71 6c 69 74 65 33 41 66 66 69 6e 69 ar sqlite3Affini
2c270 74 79 54 79 70 65 28 63 6f 6e 73 74 20 63 68 61 tyType(const cha
2c280 72 2a 2c 20 43 6f 6c 75 6d 6e 2a 29 3b 0a 76 6f r*, Column*);.vo
2c290 69 64 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 7a id sqlite3Analyz
2c2a0 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a e(Parse*, Token*
2c2b0 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 , Token*);.int s
2c2c0 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75 73 79 qlite3InvokeBusy
2c2d0 48 61 6e 64 6c 65 72 28 42 75 73 79 48 61 6e 64 Handler(BusyHand
2c2e0 6c 65 72 2a 2c 20 73 71 6c 69 74 65 33 5f 66 69 ler*, sqlite3_fi
2c2f0 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 le*);.int sqlite
2c300 33 46 69 6e 64 44 62 28 73 71 6c 69 74 65 33 2a 3FindDb(sqlite3*
2c310 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 , Token*);.int s
2c320 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d 65 qlite3FindDbName
2c330 28 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 (sqlite3 *, cons
2c340 74 20 63 68 61 72 20 2a 29 3b 0a 69 6e 74 20 73 t char *);.int s
2c350 71 6c 69 74 65 33 41 6e 61 6c 79 73 69 73 4c 6f qlite3AnalysisLo
2c360 61 64 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 ad(sqlite3*,int
2c370 69 44 42 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 iDB);.void sqlit
2c380 65 33 44 65 6c 65 74 65 49 6e 64 65 78 53 61 6d e3DeleteIndexSam
2c390 70 6c 65 73 28 73 71 6c 69 74 65 33 2a 2c 49 6e ples(sqlite3*,In
2c3a0 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 dex*);.void sqli
2c3b0 74 65 33 44 65 66 61 75 6c 74 52 6f 77 45 73 74 te3DefaultRowEst
2c3c0 28 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 (Index*);.void s
2c3d0 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 4c 69 qlite3RegisterLi
2c3e0 6b 65 46 75 6e 63 74 69 6f 6e 73 28 73 71 6c 69 keFunctions(sqli
2c3f0 74 65 33 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 te3*, int);.int
2c400 73 71 6c 69 74 65 33 49 73 4c 69 6b 65 46 75 6e sqlite3IsLikeFun
2c410 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a 2c 45 ction(sqlite3*,E
2c420 78 70 72 2a 2c 69 6e 74 2a 2c 63 68 61 72 2a 29 xpr*,int*,char*)
2c430 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 63 ;.void sqlite3Sc
2c440 68 65 6d 61 43 6c 65 61 72 28 76 6f 69 64 20 2a hemaClear(void *
2c450 29 3b 0a 53 63 68 65 6d 61 20 2a 73 71 6c 69 74 );.Schema *sqlit
2c460 65 33 53 63 68 65 6d 61 47 65 74 28 73 71 6c 69 e3SchemaGet(sqli
2c470 74 65 33 20 2a 2c 20 42 74 72 65 65 20 2a 29 3b te3 *, Btree *);
2c480 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68 65 .int sqlite3Sche
2c490 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74 65 maToIndex(sqlite
2c4a0 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a 29 3 *db, Schema *)
2c4b0 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 ;.KeyInfo *sqlit
2c4c0 65 33 4b 65 79 49 6e 66 6f 41 6c 6c 6f 63 28 73 e3KeyInfoAlloc(s
2c4d0 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 69 6e 74 29 qlite3*,int,int)
2c4e0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4b 65 ;.void sqlite3Ke
2c4f0 79 49 6e 66 6f 55 6e 72 65 66 28 4b 65 79 49 6e yInfoUnref(KeyIn
2c500 66 6f 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 fo*);.KeyInfo *s
2c510 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 52 65 66 qlite3KeyInfoRef
2c520 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b 65 79 49 (KeyInfo*);.KeyI
2c530 6e 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 nfo *sqlite3KeyI
2c540 6e 66 6f 4f 66 49 6e 64 65 78 28 50 61 72 73 65 nfoOfIndex(Parse
2c550 2a 2c 20 49 6e 64 65 78 2a 29 3b 0a 23 69 66 64 *, Index*);.#ifd
2c560 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
2c570 69 6e 74 20 73 71 6c 69 74 65 33 4b 65 79 49 6e int sqlite3KeyIn
2c580 66 6f 49 73 57 72 69 74 65 61 62 6c 65 28 4b 65 foIsWriteable(Ke
2c590 79 49 6e 66 6f 2a 29 3b 0a 23 65 6e 64 69 66 0a yInfo*);.#endif.
2c5a0 69 6e 74 20 73 71 6c 69 74 65 33 43 72 65 61 74 int sqlite3Creat
2c5b0 65 46 75 6e 63 28 73 71 6c 69 74 65 33 20 2a 2c eFunc(sqlite3 *,
2c5c0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 const char *, i
2c5d0 6e 74 2c 20 69 6e 74 2c 20 76 6f 69 64 20 2a 2c nt, int, void *,
2c5e0 0a 20 20 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 . void (*)(sqli
2c5f0 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 te3_context*,int
2c600 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a ,sqlite3_value *
2c610 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 29 28 73 *),. void (*)(s
2c620 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
2c630 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
2c640 65 20 2a 2a 29 2c 20 76 6f 69 64 20 28 2a 29 28 e **), void (*)(
2c650 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
2c660 29 2c 0a 20 20 46 75 6e 63 44 65 73 74 72 75 63 ),. FuncDestruc
2c670 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 tor *pDestructor
2c680 0a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .);.void sqlite3
2c690 4e 6f 6f 70 44 65 73 74 72 75 63 74 6f 72 28 76 NoopDestructor(v
2c6a0 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 oid*);.void sqli
2c6b0 74 65 33 4f 6f 6d 46 61 75 6c 74 28 73 71 6c 69 te3OomFault(sqli
2c6c0 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 te3*);.void sqli
2c6d0 74 65 33 4f 6f 6d 43 6c 65 61 72 28 73 71 6c 69 te3OomClear(sqli
2c6e0 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 te3*);.int sqlit
2c6f0 65 33 41 70 69 45 78 69 74 28 73 71 6c 69 74 65 e3ApiExit(sqlite
2c700 33 20 2a 64 62 2c 20 69 6e 74 29 3b 0a 69 6e 74 3 *db, int);.int
2c710 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 65 6d 70 sqlite3OpenTemp
2c720 44 61 74 61 62 61 73 65 28 50 61 72 73 65 20 2a Database(Parse *
2c730 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 );..void sqlite3
2c740 53 74 72 41 63 63 75 6d 49 6e 69 74 28 53 74 72 StrAccumInit(Str
2c750 41 63 63 75 6d 2a 2c 20 73 71 6c 69 74 65 33 2a Accum*, sqlite3*
2c760 2c 20 63 68 61 72 2a 2c 20 69 6e 74 2c 20 69 6e , char*, int, in
2c770 74 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 t);.char *sqlite
2c780 33 53 74 72 41 63 63 75 6d 46 69 6e 69 73 68 28 3StrAccumFinish(
2c790 53 74 72 41 63 63 75 6d 2a 29 3b 0a 76 6f 69 64 StrAccum*);.void
2c7a0 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65 sqlite3SelectDe
2c7b0 73 74 49 6e 69 74 28 53 65 6c 65 63 74 44 65 73 stInit(SelectDes
2c7c0 74 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 45 78 70 t*,int,int);.Exp
2c7d0 72 20 2a 73 71 6c 69 74 65 33 43 72 65 61 74 65 r *sqlite3Create
2c7e0 43 6f 6c 75 6d 6e 45 78 70 72 28 73 71 6c 69 74 ColumnExpr(sqlit
2c7f0 65 33 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c e3 *, SrcList *,
2c800 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 0a 76 6f 69 int, int);..voi
2c810 64 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 52 d sqlite3BackupR
2c820 65 73 74 61 72 74 28 73 71 6c 69 74 65 33 5f 62 estart(sqlite3_b
2c830 61 63 6b 75 70 20 2a 29 3b 0a 76 6f 69 64 20 73 ackup *);.void s
2c840 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 64 61 qlite3BackupUpda
2c850 74 65 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 te(sqlite3_backu
2c860 70 20 2a 2c 20 50 67 6e 6f 2c 20 63 6f 6e 73 74 p *, Pgno, const
2c870 20 75 38 20 2a 29 3b 0a 0a 23 69 66 6e 64 65 66 u8 *);..#ifndef
2c880 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 SQLITE_OMIT_SUB
2c890 51 55 45 52 59 0a 69 6e 74 20 73 71 6c 69 74 65 QUERY.int sqlite
2c8a0 33 45 78 70 72 43 68 65 63 6b 49 4e 28 50 61 72 3ExprCheckIN(Par
2c8b0 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 23 65 6c se*, Expr*);.#el
2c8c0 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 se.# define sqli
2c8d0 74 65 33 45 78 70 72 43 68 65 63 6b 49 4e 28 78 te3ExprCheckIN(x
2c8e0 2c 79 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 ,y) SQLITE_OK.#e
2c8f0 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c ndif..#ifdef SQL
2c900 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 ITE_ENABLE_STAT3
2c910 5f 4f 52 5f 53 54 41 54 34 0a 76 6f 69 64 20 73 _OR_STAT4.void s
2c920 71 6c 69 74 65 33 41 6e 61 6c 79 7a 65 46 75 6e qlite3AnalyzeFun
2c930 63 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a 69 6e ctions(void);.in
2c940 74 20 73 71 6c 69 74 65 33 53 74 61 74 34 50 72 t sqlite3Stat4Pr
2c950 6f 62 65 53 65 74 56 61 6c 75 65 28 0a 20 20 20 obeSetValue(.
2c960 20 50 61 72 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 Parse*,Index*,U
2c970 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 2a 2c npackedRecord**,
2c980 45 78 70 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e Expr*,int,int,in
2c990 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
2c9a0 53 74 61 74 34 56 61 6c 75 65 46 72 6f 6d 45 78 Stat4ValueFromEx
2c9b0 70 72 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a pr(Parse*, Expr*
2c9c0 2c 20 75 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 , u8, sqlite3_va
2c9d0 6c 75 65 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c lue**);.void sql
2c9e0 69 74 65 33 53 74 61 74 34 50 72 6f 62 65 46 72 ite3Stat4ProbeFr
2c9f0 65 65 28 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 ee(UnpackedRecor
2ca00 64 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 d*);.int sqlite3
2ca10 53 74 61 74 34 43 6f 6c 75 6d 6e 28 73 71 6c 69 Stat4Column(sqli
2ca20 74 65 33 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 te3*, const void
2ca30 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 73 71 6c *, int, int, sql
2ca40 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 63 ite3_value**);.c
2ca50 68 61 72 20 73 71 6c 69 74 65 33 49 6e 64 65 78 har sqlite3Index
2ca60 43 6f 6c 75 6d 6e 41 66 66 69 6e 69 74 79 28 73 ColumnAffinity(s
2ca70 71 6c 69 74 65 33 2a 2c 20 49 6e 64 65 78 2a 2c qlite3*, Index*,
2ca80 20 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f int);.#endif../
2ca90 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72 66 61 *.** The interfa
2caa0 63 65 20 74 6f 20 74 68 65 20 4c 45 4d 4f 4e 2d ce to the LEMON-
2cab0 67 65 6e 65 72 61 74 65 64 20 70 61 72 73 65 72 generated parser
2cac0 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .*/.#ifndef SQLI
2cad0 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a TE_AMALGAMATION.
2cae0 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 50 void *sqlite3P
2caf0 61 72 73 65 72 41 6c 6c 6f 63 28 76 6f 69 64 2a arserAlloc(void*
2cb00 28 2a 29 28 75 36 34 29 2c 20 50 61 72 73 65 2a (*)(u64), Parse*
2cb10 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
2cb20 33 50 61 72 73 65 72 46 72 65 65 28 76 6f 69 64 3ParserFree(void
2cb30 2a 2c 20 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a *, void(*)(void*
2cb40 29 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 ));.#endif.void
2cb50 73 71 6c 69 74 65 33 50 61 72 73 65 72 28 76 6f sqlite3Parser(vo
2cb60 69 64 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 29 id*, int, Token)
2cb70 3b 0a 23 69 66 64 65 66 20 59 59 54 52 41 43 4b ;.#ifdef YYTRACK
2cb80 4d 41 58 53 54 41 43 4b 44 45 50 54 48 0a 20 20 MAXSTACKDEPTH.
2cb90 69 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 int sqlite3Parse
2cba0 72 53 74 61 63 6b 50 65 61 6b 28 76 6f 69 64 2a rStackPeak(void*
2cbb0 29 3b 0a 23 65 6e 64 69 66 0a 0a 76 6f 69 64 20 );.#endif..void
2cbc0 73 71 6c 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 sqlite3AutoLoadE
2cbd0 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65 xtensions(sqlite
2cbe0 33 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 3*);.#ifndef SQL
2cbf0 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 ITE_OMIT_LOAD_EX
2cc00 54 45 4e 53 49 4f 4e 0a 20 20 76 6f 69 64 20 73 TENSION. void s
2cc10 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 74 65 6e qlite3CloseExten
2cc20 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b sions(sqlite3*);
2cc30 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
2cc40 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 74 65 sqlite3CloseExte
2cc50 6e 73 69 6f 6e 73 28 58 29 0a 23 65 6e 64 69 66 nsions(X).#endif
2cc60 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
2cc70 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 _OMIT_SHARED_CAC
2cc80 48 45 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 HE. void sqlite
2cc90 33 54 61 62 6c 65 4c 6f 63 6b 28 50 61 72 73 65 3TableLock(Parse
2cca0 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 75 38 *, int, int, u8
2ccb0 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b , const char *);
2ccc0 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
2ccd0 20 73 71 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 sqlite3TableLoc
2cce0 6b 28 76 2c 77 2c 78 2c 79 2c 7a 29 0a 23 65 6e k(v,w,x,y,z).#en
2ccf0 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
2cd00 54 45 5f 54 45 53 54 0a 20 20 69 6e 74 20 73 71 TE_TEST. int sq
2cd10 6c 69 74 65 33 55 74 66 38 54 6f 38 28 75 6e 73 lite3Utf8To8(uns
2cd20 69 67 6e 65 64 20 63 68 61 72 2a 29 3b 0a 23 65 igned char*);.#e
2cd30 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c ndif..#ifdef SQL
2cd40 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
2cd50 54 41 42 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 TABLE.# define
2cd60 73 71 6c 69 74 65 33 56 74 61 62 43 6c 65 61 72 sqlite3VtabClear
2cd70 28 59 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 (Y).# define sq
2cd80 6c 69 74 65 33 56 74 61 62 53 79 6e 63 28 58 2c lite3VtabSync(X,
2cd90 59 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 Y) SQLITE_OK.#
2cda0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 define sqlite3Vt
2cdb0 61 62 52 6f 6c 6c 62 61 63 6b 28 58 29 0a 23 20 abRollback(X).#
2cdc0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 define sqlite3V
2cdd0 74 61 62 43 6f 6d 6d 69 74 28 58 29 0a 23 20 20 tabCommit(X).#
2cde0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 define sqlite3Vt
2cdf0 61 62 49 6e 53 79 6e 63 28 64 62 29 20 30 0a 23 abInSync(db) 0.#
2ce00 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 define sqlite3
2ce10 56 74 61 62 4c 6f 63 6b 28 58 29 0a 23 20 20 64 VtabLock(X).# d
2ce20 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 efine sqlite3Vta
2ce30 62 55 6e 6c 6f 63 6b 28 58 29 0a 23 20 20 64 65 bUnlock(X).# de
2ce40 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
2ce50 55 6e 6c 6f 63 6b 4c 69 73 74 28 58 29 0a 23 20 UnlockList(X).#
2ce60 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 define sqlite3V
2ce70 74 61 62 53 61 76 65 70 6f 69 6e 74 28 58 2c 20 tabSavepoint(X,
2ce80 59 2c 20 5a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a Y, Z) SQLITE_OK.
2ce90 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 # define sqlite
2cea0 33 47 65 74 56 54 61 62 6c 65 28 58 2c 59 29 20 3GetVTable(X,Y)
2ceb0 20 28 28 56 54 61 62 6c 65 2a 29 30 29 0a 23 65 ((VTable*)0).#e
2cec0 6c 73 65 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 lse. void sqli
2ced0 74 65 33 56 74 61 62 43 6c 65 61 72 28 73 71 6c te3VtabClear(sql
2cee0 69 74 65 33 20 2a 64 62 2c 20 54 61 62 6c 65 2a ite3 *db, Table*
2cef0 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 );. void sqlit
2cf00 65 33 56 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 e3VtabDisconnect
2cf10 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 54 61 (sqlite3 *db, Ta
2cf20 62 6c 65 20 2a 70 29 3b 0a 20 20 20 69 6e 74 20 ble *p);. int
2cf30 73 71 6c 69 74 65 33 56 74 61 62 53 79 6e 63 28 sqlite3VtabSync(
2cf40 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 56 64 62 sqlite3 *db, Vdb
2cf50 65 2a 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 e*);. int sqli
2cf60 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 te3VtabRollback(
2cf70 73 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 sqlite3 *db);.
2cf80 20 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 int sqlite3Vtab
2cf90 43 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 2a Commit(sqlite3 *
2cfa0 64 62 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c db);. void sql
2cfb0 69 74 65 33 56 74 61 62 4c 6f 63 6b 28 56 54 61 ite3VtabLock(VTa
2cfc0 62 6c 65 20 2a 29 3b 0a 20 20 20 76 6f 69 64 20 ble *);. void
2cfd0 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 sqlite3VtabUnloc
2cfe0 6b 28 56 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 k(VTable *);.
2cff0 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 void sqlite3Vtab
2d000 55 6e 6c 6f 63 6b 4c 69 73 74 28 73 71 6c 69 74 UnlockList(sqlit
2d010 65 33 2a 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c e3*);. int sql
2d020 69 74 65 33 56 74 61 62 53 61 76 65 70 6f 69 6e ite3VtabSavepoin
2d030 74 28 73 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 t(sqlite3 *, int
2d040 2c 20 69 6e 74 29 3b 0a 20 20 20 76 6f 69 64 20 , int);. void
2d050 73 71 6c 69 74 65 33 56 74 61 62 49 6d 70 6f 72 sqlite3VtabImpor
2d060 74 45 72 72 6d 73 67 28 56 64 62 65 2a 2c 20 73 tErrmsg(Vdbe*, s
2d070 71 6c 69 74 65 33 5f 76 74 61 62 2a 29 3b 0a 20 qlite3_vtab*);.
2d080 20 20 56 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 VTable *sqlite
2d090 33 47 65 74 56 54 61 62 6c 65 28 73 71 6c 69 74 3GetVTable(sqlit
2d0a0 65 33 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 e3*, Table*);.
2d0b0 20 4d 6f 64 75 6c 65 20 2a 73 71 6c 69 74 65 33 Module *sqlite3
2d0c0 56 74 61 62 43 72 65 61 74 65 4d 6f 64 75 6c 65 VtabCreateModule
2d0d0 28 0a 20 20 20 20 20 73 71 6c 69 74 65 33 2a 2c (. sqlite3*,
2d0e0 0a 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 . const char
2d0f0 2a 2c 0a 20 20 20 20 20 63 6f 6e 73 74 20 73 71 *,. const sq
2d100 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 2a 2c 0a 20 lite3_module*,.
2d110 20 20 20 20 76 6f 69 64 2a 2c 0a 20 20 20 20 20 void*,.
2d120 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 0a 20 void(*)(void*).
2d130 20 20 29 3b 0a 23 20 20 64 65 66 69 6e 65 20 73 );.# define s
2d140 71 6c 69 74 65 33 56 74 61 62 49 6e 53 79 6e 63 qlite3VtabInSync
2d150 28 64 62 29 20 28 28 64 62 29 2d 3e 6e 56 54 72 (db) ((db)->nVTr
2d160 61 6e 73 3e 30 20 26 26 20 28 64 62 29 2d 3e 61 ans>0 && (db)->a
2d170 56 54 72 61 6e 73 3d 3d 30 29 0a 23 65 6e 64 69 VTrans==0).#endi
2d180 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 f.int sqlite3Vta
2d190 62 45 70 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 49 bEponymousTableI
2d1a0 6e 69 74 28 50 61 72 73 65 2a 2c 4d 6f 64 75 6c nit(Parse*,Modul
2d1b0 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
2d1c0 33 56 74 61 62 45 70 6f 6e 79 6d 6f 75 73 54 61 3VtabEponymousTa
2d1d0 62 6c 65 43 6c 65 61 72 28 73 71 6c 69 74 65 33 bleClear(sqlite3
2d1e0 2a 2c 4d 6f 64 75 6c 65 2a 29 3b 0a 76 6f 69 64 *,Module*);.void
2d1f0 20 73 71 6c 69 74 65 33 56 74 61 62 4d 61 6b 65 sqlite3VtabMake
2d200 57 72 69 74 61 62 6c 65 28 50 61 72 73 65 2a 2c Writable(Parse*,
2d210 54 61 62 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 Table*);.void sq
2d220 6c 69 74 65 33 56 74 61 62 42 65 67 69 6e 50 61 lite3VtabBeginPa
2d230 72 73 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 rse(Parse*, Toke
2d240 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 n*, Token*, Toke
2d250 6e 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 n*, int);.void s
2d260 71 6c 69 74 65 33 56 74 61 62 46 69 6e 69 73 68 qlite3VtabFinish
2d270 50 61 72 73 65 28 50 61 72 73 65 2a 2c 20 54 6f Parse(Parse*, To
2d280 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ken*);.void sqli
2d290 74 65 33 56 74 61 62 41 72 67 49 6e 69 74 28 50 te3VtabArgInit(P
2d2a0 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c arse*);.void sql
2d2b0 69 74 65 33 56 74 61 62 41 72 67 45 78 74 65 6e ite3VtabArgExten
2d2c0 64 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a d(Parse*, Token*
2d2d0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 );.int sqlite3Vt
2d2e0 61 62 43 61 6c 6c 43 72 65 61 74 65 28 73 71 6c abCallCreate(sql
2d2f0 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 ite3*, int, cons
2d300 74 20 63 68 61 72 20 2a 2c 20 63 68 61 72 20 2a t char *, char *
2d310 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 *);.int sqlite3V
2d320 74 61 62 43 61 6c 6c 43 6f 6e 6e 65 63 74 28 50 tabCallConnect(P
2d330 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a arse*, Table*);.
2d340 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 int sqlite3VtabC
2d350 61 6c 6c 44 65 73 74 72 6f 79 28 73 71 6c 69 74 allDestroy(sqlit
2d360 65 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 e3*, int, const
2d370 63 68 61 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c char *);.int sql
2d380 69 74 65 33 56 74 61 62 42 65 67 69 6e 28 73 71 ite3VtabBegin(sq
2d390 6c 69 74 65 33 20 2a 2c 20 56 54 61 62 6c 65 20 lite3 *, VTable
2d3a0 2a 29 3b 0a 46 75 6e 63 44 65 66 20 2a 73 71 6c *);.FuncDef *sql
2d3b0 69 74 65 33 56 74 61 62 4f 76 65 72 6c 6f 61 64 ite3VtabOverload
2d3c0 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 Function(sqlite3
2d3d0 20 2a 2c 46 75 6e 63 44 65 66 2a 2c 20 69 6e 74 *,FuncDef*, int
2d3e0 20 6e 41 72 67 2c 20 45 78 70 72 2a 29 3b 0a 73 nArg, Expr*);.s
2d3f0 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c qlite3_int64 sql
2d400 69 74 65 33 53 74 6d 74 43 75 72 72 65 6e 74 54 ite3StmtCurrentT
2d410 69 6d 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 ime(sqlite3_cont
2d420 65 78 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ext*);.int sqlit
2d430 65 33 56 64 62 65 50 61 72 61 6d 65 74 65 72 49 e3VdbeParameterI
2d440 6e 64 65 78 28 56 64 62 65 2a 2c 20 63 6f 6e 73 ndex(Vdbe*, cons
2d450 74 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a 69 t char*, int);.i
2d460 6e 74 20 73 71 6c 69 74 65 33 54 72 61 6e 73 66 nt sqlite3Transf
2d470 65 72 42 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 erBindings(sqlit
2d480 65 33 5f 73 74 6d 74 20 2a 2c 20 73 71 6c 69 74 e3_stmt *, sqlit
2d490 65 33 5f 73 74 6d 74 20 2a 29 3b 0a 76 6f 69 64 e3_stmt *);.void
2d4a0 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65 sqlite3ParserRe
2d4b0 73 65 74 28 50 61 72 73 65 2a 29 3b 0a 69 6e 74 set(Parse*);.int
2d4c0 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 sqlite3Reprepar
2d4d0 65 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 e(Vdbe*);.void s
2d4e0 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 68 qlite3ExprListCh
2d4f0 65 63 6b 4c 65 6e 67 74 68 28 50 61 72 73 65 2a eckLength(Parse*
2d500 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f 6e , ExprList*, con
2d510 73 74 20 63 68 61 72 2a 29 3b 0a 43 6f 6c 6c 53 st char*);.CollS
2d520 65 71 20 2a 73 71 6c 69 74 65 33 42 69 6e 61 72 eq *sqlite3Binar
2d530 79 43 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 28 yCompareCollSeq(
2d540 50 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c Parse *, Expr *,
2d550 20 45 78 70 72 20 2a 29 3b 0a 69 6e 74 20 73 71 Expr *);.int sq
2d560 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 lite3TempInMemor
2d570 79 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 2a y(const sqlite3*
2d580 29 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 );.const char *s
2d590 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4d 6f 64 qlite3JournalMod
2d5a0 65 6e 61 6d 65 28 69 6e 74 29 3b 0a 23 69 66 6e ename(int);.#ifn
2d5b0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2d5c0 57 41 4c 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 WAL. int sqlite
2d5d0 33 43 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 3Checkpoint(sqli
2d5e0 74 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 te3*, int, int,
2d5f0 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 20 20 69 int*, int*);. i
2d600 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 44 65 66 nt sqlite3WalDef
2d610 61 75 6c 74 48 6f 6f 6b 28 76 6f 69 64 2a 2c 73 aultHook(void*,s
2d620 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
2d630 61 72 2a 2c 69 6e 74 29 3b 0a 23 65 6e 64 69 66 ar*,int);.#endif
2d640 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2d650 4f 4d 49 54 5f 43 54 45 0a 20 20 57 69 74 68 20 OMIT_CTE. With
2d660 2a 73 71 6c 69 74 65 33 57 69 74 68 41 64 64 28 *sqlite3WithAdd(
2d670 50 61 72 73 65 2a 2c 57 69 74 68 2a 2c 54 6f 6b Parse*,With*,Tok
2d680 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 65 en*,ExprList*,Se
2d690 6c 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 73 lect*);. void s
2d6a0 71 6c 69 74 65 33 57 69 74 68 44 65 6c 65 74 65 qlite3WithDelete
2d6b0 28 73 71 6c 69 74 65 33 2a 2c 57 69 74 68 2a 29 (sqlite3*,With*)
2d6c0 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
2d6d0 57 69 74 68 50 75 73 68 28 50 61 72 73 65 2a 2c WithPush(Parse*,
2d6e0 20 57 69 74 68 2a 2c 20 75 38 29 3b 0a 23 65 6c With*, u8);.#el
2d6f0 73 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 se.#define sqlit
2d700 65 33 57 69 74 68 50 75 73 68 28 78 2c 79 2c 7a e3WithPush(x,y,z
2d710 29 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 ).#define sqlite
2d720 33 57 69 74 68 44 65 6c 65 74 65 28 78 2c 79 29 3WithDelete(x,y)
2d730 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
2d740 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 50 53 45 SQLITE_OMIT_UPSE
2d750 52 54 0a 20 20 55 70 73 65 72 74 20 2a 73 71 6c RT. Upsert *sql
2d760 69 74 65 33 55 70 73 65 72 74 4e 65 77 28 73 71 ite3UpsertNew(sq
2d770 6c 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a lite3*,ExprList*
2d780 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a ,Expr*,ExprList*
2d790 2c 45 78 70 72 2a 29 3b 0a 20 20 76 6f 69 64 20 ,Expr*);. void
2d7a0 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 65 6c sqlite3UpsertDel
2d7b0 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 55 70 73 ete(sqlite3*,Ups
2d7c0 65 72 74 2a 29 3b 0a 20 20 55 70 73 65 72 74 20 ert*);. Upsert
2d7d0 2a 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 75 *sqlite3UpsertDu
2d7e0 70 28 73 71 6c 69 74 65 33 2a 2c 55 70 73 65 72 p(sqlite3*,Upser
2d7f0 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 t*);. int sqlit
2d800 65 33 55 70 73 65 72 74 41 6e 61 6c 79 7a 65 54 e3UpsertAnalyzeT
2d810 61 72 67 65 74 28 50 61 72 73 65 2a 2c 53 72 63 arget(Parse*,Src
2d820 4c 69 73 74 2a 2c 55 70 73 65 72 74 2a 29 3b 0a List*,Upsert*);.
2d830 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 55 70 void sqlite3Up
2d840 73 65 72 74 44 6f 55 70 64 61 74 65 28 50 61 72 sertDoUpdate(Par
2d850 73 65 2a 2c 55 70 73 65 72 74 2a 2c 54 61 62 6c se*,Upsert*,Tabl
2d860 65 2a 2c 49 6e 64 65 78 2a 2c 69 6e 74 29 3b 0a e*,Index*,int);.
2d870 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 73 71 #else.#define sq
2d880 6c 69 74 65 33 55 70 73 65 72 74 4e 65 77 28 76 lite3UpsertNew(v
2d890 2c 77 2c 78 2c 79 2c 7a 29 20 28 28 55 70 73 65 ,w,x,y,z) ((Upse
2d8a0 72 74 2a 29 30 29 0a 23 64 65 66 69 6e 65 20 73 rt*)0).#define s
2d8b0 71 6c 69 74 65 33 55 70 73 65 72 74 44 65 6c 65 qlite3UpsertDele
2d8c0 74 65 28 78 2c 79 29 0a 23 64 65 66 69 6e 65 20 te(x,y).#define
2d8d0 73 71 6c 69 74 65 33 55 70 73 65 72 74 44 75 70 sqlite3UpsertDup
2d8e0 28 78 2c 79 29 20 20 20 20 20 20 20 28 28 55 70 (x,y) ((Up
2d8f0 73 65 72 74 2a 29 30 29 0a 23 65 6e 64 69 66 0a sert*)0).#endif.
2d900 0a 0a 2f 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e ../* Declaration
2d910 73 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 s for functions
2d920 69 6e 20 66 6b 65 79 2e 63 2e 20 41 6c 6c 20 6f in fkey.c. All o
2d930 66 20 74 68 65 73 65 20 61 72 65 20 72 65 70 6c f these are repl
2d940 61 63 65 64 20 62 79 0a 2a 2a 20 6e 6f 2d 6f 70 aced by.** no-op
2d950 20 6d 61 63 72 6f 73 20 69 66 20 4f 4d 49 54 5f macros if OMIT_
2d960 46 4f 52 45 49 47 4e 5f 4b 45 59 20 69 73 20 64 FOREIGN_KEY is d
2d970 65 66 69 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 efined. In this
2d980 63 61 73 65 20 6e 6f 20 66 6f 72 65 69 67 6e 0a case no foreign.
2d990 2a 2a 20 6b 65 79 20 66 75 6e 63 74 69 6f 6e 61 ** key functiona
2d9a0 6c 69 74 79 20 69 73 20 61 76 61 69 6c 61 62 6c lity is availabl
2d9b0 65 2e 20 49 66 20 4f 4d 49 54 5f 54 52 49 47 47 e. If OMIT_TRIGG
2d9c0 45 52 20 69 73 20 64 65 66 69 6e 65 64 20 62 75 ER is defined bu
2d9d0 74 0a 2a 2a 20 4f 4d 49 54 5f 46 4f 52 45 49 47 t.** OMIT_FOREIG
2d9e0 4e 5f 4b 45 59 20 69 73 20 6e 6f 74 2c 20 6f 6e N_KEY is not, on
2d9f0 6c 79 20 73 6f 6d 65 20 6f 66 20 74 68 65 20 66 ly some of the f
2da00 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f 2d unctions are no-
2da10 6f 70 65 64 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 oped. In.** this
2da20 20 63 61 73 65 20 66 6f 72 65 69 67 6e 20 6b 65 case foreign ke
2da30 79 73 20 61 72 65 20 70 61 72 73 65 64 2c 20 62 ys are parsed, b
2da40 75 74 20 6e 6f 20 6f 74 68 65 72 20 66 75 6e 63 ut no other func
2da50 74 69 6f 6e 61 6c 69 74 79 20 69 73 0a 2a 2a 20 tionality is.**
2da60 70 72 6f 76 69 64 65 64 20 28 65 6e 66 6f 72 63 provided (enforc
2da70 65 6d 65 6e 74 20 6f 66 20 46 4b 20 63 6f 6e 73 ement of FK cons
2da80 74 72 61 69 6e 74 73 20 72 65 71 75 69 72 65 73 traints requires
2da90 20 74 68 65 20 74 72 69 67 67 65 72 73 20 73 75 the triggers su
2daa0 62 2d 73 79 73 74 65 6d 29 2e 0a 2a 2f 0a 23 69 b-system)..*/.#i
2dab0 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
2dac0 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b E_OMIT_FOREIGN_K
2dad0 45 59 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 EY) && !defined(
2dae0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 SQLITE_OMIT_TRIG
2daf0 47 45 52 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 GER). void sqli
2db00 74 65 33 46 6b 43 68 65 63 6b 28 50 61 72 73 65 te3FkCheck(Parse
2db10 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 *, Table*, int,
2db20 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b int, int*, int);
2db30 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 46 . void sqlite3F
2db40 6b 44 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 kDropTable(Parse
2db50 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 54 61 *, SrcList *, Ta
2db60 62 6c 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 ble*);. void sq
2db70 6c 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 50 lite3FkActions(P
2db80 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 arse*, Table*, E
2db90 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 xprList*, int, i
2dba0 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 69 6e 74 nt*, int);. int
2dbb0 20 73 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72 sqlite3FkRequir
2dbc0 65 64 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 ed(Parse*, Table
2dbd0 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 *, int*, int);.
2dbe0 20 75 33 32 20 73 71 6c 69 74 65 33 46 6b 4f 6c u32 sqlite3FkOl
2dbf0 64 6d 61 73 6b 28 50 61 72 73 65 2a 2c 20 54 61 dmask(Parse*, Ta
2dc00 62 6c 65 2a 29 3b 0a 20 20 46 4b 65 79 20 2a 73 ble*);. FKey *s
2dc10 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 qlite3FkReferenc
2dc20 65 73 28 54 61 62 6c 65 20 2a 29 3b 0a 23 65 6c es(Table *);.#el
2dc30 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c se. #define sql
2dc40 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 61 2c ite3FkActions(a,
2dc50 62 2c 63 2c 64 2c 65 2c 66 29 0a 20 20 23 64 65 b,c,d,e,f). #de
2dc60 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 43 68 fine sqlite3FkCh
2dc70 65 63 6b 28 61 2c 62 2c 63 2c 64 2c 65 2c 66 29 eck(a,b,c,d,e,f)
2dc80 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
2dc90 65 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 61 2c e3FkDropTable(a,
2dca0 62 2c 63 29 0a 20 20 23 64 65 66 69 6e 65 20 73 b,c). #define s
2dcb0 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 61 73 6b 28 qlite3FkOldmask(
2dcc0 61 2c 62 29 20 20 20 20 20 20 20 20 20 30 0a 20 a,b) 0.
2dcd0 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
2dce0 46 6b 52 65 71 75 69 72 65 64 28 61 2c 62 2c 63 FkRequired(a,b,c
2dcf0 2c 64 29 20 20 20 20 30 0a 20 20 23 64 65 66 69 ,d) 0. #defi
2dd00 6e 65 20 73 71 6c 69 74 65 33 46 6b 52 65 66 65 ne sqlite3FkRefe
2dd10 72 65 6e 63 65 73 28 61 29 20 20 20 20 20 20 20 rences(a)
2dd20 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 0.#endif.#ifnde
2dd30 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f f SQLITE_OMIT_FO
2dd40 52 45 49 47 4e 5f 4b 45 59 0a 20 20 76 6f 69 64 REIGN_KEY. void
2dd50 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 sqlite3FkDelete
2dd60 28 73 71 6c 69 74 65 33 20 2a 2c 20 54 61 62 6c (sqlite3 *, Tabl
2dd70 65 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 e*);. int sqlit
2dd80 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 e3FkLocateIndex(
2dd90 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 46 4b Parse*,Table*,FK
2dda0 65 79 2a 2c 49 6e 64 65 78 2a 2a 2c 69 6e 74 2a ey*,Index**,int*
2ddb0 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 *);.#else. #def
2ddc0 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 44 65 6c ine sqlite3FkDel
2ddd0 65 74 65 28 61 2c 62 29 0a 20 20 23 64 65 66 69 ete(a,b). #defi
2dde0 6e 65 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 ne sqlite3FkLoca
2ddf0 74 65 49 6e 64 65 78 28 61 2c 62 2c 63 2c 64 2c teIndex(a,b,c,d,
2de00 65 29 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a e).#endif.../*.*
2de10 2a 20 41 76 61 69 6c 61 62 6c 65 20 66 61 75 6c * Available faul
2de20 74 20 69 6e 6a 65 63 74 6f 72 73 2e 20 20 53 68 t injectors. Sh
2de30 6f 75 6c 64 20 62 65 20 6e 75 6d 62 65 72 65 64 ould be numbered
2de40 20 62 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 beginning with
2de50 30 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 0..*/.#define SQ
2de60 4c 49 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 LITE_FAULTINJECT
2de70 4f 52 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 30 0a OR_MALLOC 0.
2de80 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
2de90 41 55 4c 54 49 4e 4a 45 43 54 4f 52 5f 43 4f 55 AULTINJECTOR_COU
2dea0 4e 54 20 20 20 20 20 20 31 0a 0a 2f 2a 0a 2a 2a NT 1../*.**
2deb0 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 The interface t
2dec0 6f 20 74 68 65 20 63 6f 64 65 20 69 6e 20 66 61 o the code in fa
2ded0 75 6c 74 2e 63 20 75 73 65 64 20 66 6f 72 20 69 ult.c used for i
2dee0 64 65 6e 74 69 66 79 69 6e 67 20 22 62 65 6e 69 dentifying "beni
2def0 67 6e 22 0a 2a 2a 20 6d 61 6c 6c 6f 63 20 66 61 gn".** malloc fa
2df00 69 6c 75 72 65 73 2e 20 54 68 69 73 20 69 73 20 ilures. This is
2df10 6f 6e 6c 79 20 70 72 65 73 65 6e 74 20 69 66 20 only present if
2df20 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
2df30 45 0a 2a 2a 20 69 73 20 6e 6f 74 20 64 65 66 69 E.** is not defi
2df40 6e 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ned..*/.#ifndef
2df50 53 51 4c 49 54 45 5f 55 4e 54 45 53 54 41 42 4c SQLITE_UNTESTABL
2df60 45 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 E. void sqlite3
2df70 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f BeginBenignMallo
2df80 63 28 76 6f 69 64 29 3b 0a 20 20 76 6f 69 64 20 c(void);. void
2df90 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e sqlite3EndBenign
2dfa0 4d 61 6c 6c 6f 63 28 76 6f 69 64 29 3b 0a 23 65 Malloc(void);.#e
2dfb0 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 lse. #define sq
2dfc0 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 6e lite3BeginBenign
2dfd0 4d 61 6c 6c 6f 63 28 29 0a 20 20 23 64 65 66 69 Malloc(). #defi
2dfe0 6e 65 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e ne sqlite3EndBen
2dff0 69 67 6e 4d 61 6c 6c 6f 63 28 29 0a 23 65 6e 64 ignMalloc().#end
2e000 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 if../*.** Allowe
2e010 64 20 72 65 74 75 72 6e 20 76 61 6c 75 65 73 20 d return values
2e020 66 72 6f 6d 20 73 71 6c 69 74 65 33 46 69 6e 64 from sqlite3Find
2e030 49 6e 49 6e 64 65 78 28 29 0a 2a 2f 0a 23 64 65 InIndex().*/.#de
2e040 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 52 4f fine IN_INDEX_RO
2e050 57 49 44 20 20 20 20 20 20 20 20 31 20 20 20 2f WID 1 /
2e060 2a 20 53 65 61 72 63 68 20 74 68 65 20 72 6f 77 * Search the row
2e070 69 64 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 id of the table
2e080 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e */.#define IN_IN
2e090 44 45 58 5f 45 50 48 20 20 20 20 20 20 20 20 20 DEX_EPH
2e0a0 20 32 20 20 20 2f 2a 20 53 65 61 72 63 68 20 61 2 /* Search a
2e0b0 6e 20 65 70 68 65 6d 65 72 61 6c 20 62 2d 74 72 n ephemeral b-tr
2e0c0 65 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e ee */.#define IN
2e0d0 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 41 53 43 _INDEX_INDEX_ASC
2e0e0 20 20 20 20 33 20 20 20 2f 2a 20 45 78 69 73 74 3 /* Exist
2e0f0 69 6e 67 20 69 6e 64 65 78 20 41 53 43 45 4e 44 ing index ASCEND
2e100 49 4e 47 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 ING */.#define I
2e110 4e 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 44 45 N_INDEX_INDEX_DE
2e120 53 43 20 20 20 34 20 20 20 2f 2a 20 45 78 69 73 SC 4 /* Exis
2e130 74 69 6e 67 20 69 6e 64 65 78 20 44 45 53 43 45 ting index DESCE
2e140 4e 44 49 4e 47 20 2a 2f 0a 23 64 65 66 69 6e 65 NDING */.#define
2e150 20 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 20 20 IN_INDEX_NOOP
2e160 20 20 20 20 20 20 20 35 20 20 20 2f 2a 20 4e 6f 5 /* No
2e170 20 74 61 62 6c 65 20 61 76 61 69 6c 61 62 6c 65 table available
2e180 2e 20 55 73 65 20 63 6f 6d 70 61 72 69 73 6f 6e . Use comparison
2e190 73 20 2a 2f 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 s */./*.** Allow
2e1a0 65 64 20 66 6c 61 67 73 20 66 6f 72 20 74 68 65 ed flags for the
2e1b0 20 33 72 64 20 70 61 72 61 6d 65 74 65 72 20 74 3rd parameter t
2e1c0 6f 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 49 o sqlite3FindInI
2e1d0 6e 64 65 78 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 ndex()..*/.#defi
2e1e0 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 ne IN_INDEX_NOOP
2e1f0 5f 4f 4b 20 20 20 20 20 30 78 30 30 30 31 20 20 _OK 0x0001
2e200 2f 2a 20 4f 4b 20 74 6f 20 72 65 74 75 72 6e 20 /* OK to return
2e210 49 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 20 2a 2f IN_INDEX_NOOP */
2e220 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 .#define IN_INDE
2e230 58 5f 4d 45 4d 42 45 52 53 48 49 50 20 20 30 78 X_MEMBERSHIP 0x
2e240 30 30 30 32 20 20 2f 2a 20 49 4e 20 6f 70 65 72 0002 /* IN oper
2e250 61 74 6f 72 20 75 73 65 64 20 66 6f 72 20 6d 65 ator used for me
2e260 6d 62 65 72 73 68 69 70 20 74 65 73 74 20 2a 2f mbership test */
2e270 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 .#define IN_INDE
2e280 58 5f 4c 4f 4f 50 20 20 20 20 20 20 20 20 30 78 X_LOOP 0x
2e290 30 30 30 34 20 20 2f 2a 20 49 4e 20 6f 70 65 72 0004 /* IN oper
2e2a0 61 74 6f 72 20 75 73 65 64 20 61 73 20 61 20 6c ator used as a l
2e2b0 6f 6f 70 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 oop */.int sqlit
2e2c0 65 33 46 69 6e 64 49 6e 49 6e 64 65 78 28 50 61 e3FindInIndex(Pa
2e2d0 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c 20 75 rse *, Expr *, u
2e2e0 33 32 2c 20 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 32, int*, int*);
2e2f0 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 ..int sqlite3Jou
2e300 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 rnalOpen(sqlite3
2e310 5f 76 66 73 20 2a 2c 20 63 6f 6e 73 74 20 63 68 _vfs *, const ch
2e320 61 72 20 2a 2c 20 73 71 6c 69 74 65 33 5f 66 69 ar *, sqlite3_fi
2e330 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b le *, int, int);
2e340 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 .int sqlite3Jour
2e350 6e 61 6c 53 69 7a 65 28 73 71 6c 69 74 65 33 5f nalSize(sqlite3_
2e360 76 66 73 20 2a 29 3b 0a 23 69 66 20 64 65 66 69 vfs *);.#if defi
2e370 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c ned(SQLITE_ENABL
2e380 45 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 29 20 E_ATOMIC_WRITE)
2e390 5c 0a 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 \. || defined(SQ
2e3a0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 42 41 54 43 LITE_ENABLE_BATC
2e3b0 48 5f 41 54 4f 4d 49 43 5f 57 52 49 54 45 29 0a H_ATOMIC_WRITE).
2e3c0 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 int sqlite3Jou
2e3d0 72 6e 61 6c 43 72 65 61 74 65 28 73 71 6c 69 74 rnalCreate(sqlit
2e3e0 65 33 5f 66 69 6c 65 20 2a 29 3b 0a 23 65 6e 64 e3_file *);.#end
2e3f0 69 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a if..int sqlite3J
2e400 6f 75 72 6e 61 6c 49 73 49 6e 4d 65 6d 6f 72 79 ournalIsInMemory
2e410 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 (sqlite3_file *p
2e420 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d );.void sqlite3M
2e430 65 6d 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 73 71 emJournalOpen(sq
2e440 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 3b 0a 0a lite3_file *);..
2e450 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
2e460 53 65 74 48 65 69 67 68 74 41 6e 64 46 6c 61 67 SetHeightAndFlag
2e470 73 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c s(Parse *pParse,
2e480 20 45 78 70 72 20 2a 70 29 3b 0a 23 69 66 20 53 Expr *p);.#if S
2e490 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f 44 QLITE_MAX_EXPR_D
2e4a0 45 50 54 48 3e 30 0a 20 20 69 6e 74 20 73 71 6c EPTH>0. int sql
2e4b0 69 74 65 33 53 65 6c 65 63 74 45 78 70 72 48 65 ite3SelectExprHe
2e4c0 69 67 68 74 28 53 65 6c 65 63 74 20 2a 29 3b 0a ight(Select *);.
2e4d0 20 20 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 int sqlite3Exp
2e4e0 72 43 68 65 63 6b 48 65 69 67 68 74 28 50 61 72 rCheckHeight(Par
2e4f0 73 65 2a 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 se*, int);.#else
2e500 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
2e510 65 33 53 65 6c 65 63 74 45 78 70 72 48 65 69 67 e3SelectExprHeig
2e520 68 74 28 78 29 20 30 0a 20 20 23 64 65 66 69 6e ht(x) 0. #defin
2e530 65 20 73 71 6c 69 74 65 33 45 78 70 72 43 68 65 e sqlite3ExprChe
2e540 63 6b 48 65 69 67 68 74 28 78 2c 79 29 0a 23 65 ckHeight(x,y).#e
2e550 6e 64 69 66 0a 0a 75 33 32 20 73 71 6c 69 74 65 ndif..u32 sqlite
2e560 33 47 65 74 34 62 79 74 65 28 63 6f 6e 73 74 20 3Get4byte(const
2e570 75 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u8*);.void sqlit
2e580 65 33 50 75 74 34 62 79 74 65 28 75 38 2a 2c 20 e3Put4byte(u8*,
2e590 75 33 32 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 u32);..#ifdef SQ
2e5a0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 4e 4c 4f LITE_ENABLE_UNLO
2e5b0 43 4b 5f 4e 4f 54 49 46 59 0a 20 20 76 6f 69 64 CK_NOTIFY. void
2e5c0 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
2e5d0 6f 6e 42 6c 6f 63 6b 65 64 28 73 71 6c 69 74 65 onBlocked(sqlite
2e5e0 33 20 2a 2c 20 73 71 6c 69 74 65 33 20 2a 29 3b 3 *, sqlite3 *);
2e5f0 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 . void sqlite3C
2e600 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c 6f 63 6b 65 onnectionUnlocke
2e610 64 28 73 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a d(sqlite3 *db);.
2e620 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
2e630 6e 6e 65 63 74 69 6f 6e 43 6c 6f 73 65 64 28 73 nnectionClosed(s
2e640 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a 23 65 6c qlite3 *db);.#el
2e650 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c se. #define sql
2e660 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c ite3ConnectionBl
2e670 6f 63 6b 65 64 28 78 2c 79 29 0a 20 20 23 64 65 ocked(x,y). #de
2e680 66 69 6e 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e fine sqlite3Conn
2e690 65 63 74 69 6f 6e 55 6e 6c 6f 63 6b 65 64 28 78 ectionUnlocked(x
2e6a0 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 ). #define sqli
2e6b0 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c 6f te3ConnectionClo
2e6c0 73 65 64 28 78 29 0a 23 65 6e 64 69 66 0a 0a 23 sed(x).#endif..#
2e6d0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
2e6e0 55 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 UG. void sqlite
2e6f0 33 50 61 72 73 65 72 54 72 61 63 65 28 46 49 4c 3ParserTrace(FIL
2e700 45 2a 2c 20 63 68 61 72 20 2a 29 3b 0a 23 65 6e E*, char *);.#en
2e710 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 dif.#if defined(
2e720 59 59 43 4f 56 45 52 41 47 45 29 0a 20 20 69 6e YYCOVERAGE). in
2e730 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 43 t sqlite3ParserC
2e740 6f 76 65 72 61 67 65 28 46 49 4c 45 2a 29 3b 0a overage(FILE*);.
2e750 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 #endif../*.** If
2e760 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 the SQLITE_ENAB
2e770 4c 45 20 49 4f 54 52 41 43 45 20 65 78 69 73 74 LE IOTRACE exist
2e780 73 20 74 68 65 6e 20 74 68 65 20 67 6c 6f 62 61 s then the globa
2e790 6c 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 73 71 l variable.** sq
2e7a0 6c 69 74 65 33 49 6f 54 72 61 63 65 20 69 73 20 lite3IoTrace is
2e7b0 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 70 a pointer to a p
2e7c0 72 69 6e 74 66 2d 6c 69 6b 65 20 72 6f 75 74 69 rintf-like routi
2e7d0 6e 65 20 75 73 65 64 20 74 6f 0a 2a 2a 20 70 72 ne used to.** pr
2e7e0 69 6e 74 20 49 2f 4f 20 74 72 61 63 69 6e 67 20 int I/O tracing
2e7f0 6d 65 73 73 61 67 65 73 2e 0a 2a 2f 0a 23 69 66 messages..*/.#if
2e800 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
2e810 45 5f 49 4f 54 52 41 43 45 0a 23 20 64 65 66 69 E_IOTRACE.# defi
2e820 6e 65 20 49 4f 54 52 41 43 45 28 41 29 20 20 69 ne IOTRACE(A) i
2e830 66 28 20 73 71 6c 69 74 65 33 49 6f 54 72 61 63 f( sqlite3IoTrac
2e840 65 20 29 7b 20 73 71 6c 69 74 65 33 49 6f 54 72 e ){ sqlite3IoTr
2e850 61 63 65 20 41 3b 20 7d 0a 20 20 76 6f 69 64 20 ace A; }. void
2e860 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 72 61 sqlite3VdbeIOTra
2e870 63 65 53 71 6c 28 56 64 62 65 2a 29 3b 0a 53 51 ceSql(Vdbe*);.SQ
2e880 4c 49 54 45 5f 41 50 49 20 53 51 4c 49 54 45 5f LITE_API SQLITE_
2e890 45 58 54 45 52 4e 20 76 6f 69 64 20 28 53 51 4c EXTERN void (SQL
2e8a0 49 54 45 5f 43 44 45 43 4c 20 2a 73 71 6c 69 74 ITE_CDECL *sqlit
2e8b0 65 33 49 6f 54 72 61 63 65 29 28 63 6f 6e 73 74 e3IoTrace)(const
2e8c0 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a 23 65 6c char*,...);.#el
2e8d0 73 65 0a 23 20 64 65 66 69 6e 65 20 49 4f 54 52 se.# define IOTR
2e8e0 41 43 45 28 41 29 0a 23 20 64 65 66 69 6e 65 20 ACE(A).# define
2e8f0 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 72 61 sqlite3VdbeIOTra
2e900 63 65 53 71 6c 28 58 29 0a 23 65 6e 64 69 66 0a ceSql(X).#endif.
2e910 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f 75 ./*.** These rou
2e920 74 69 6e 65 73 20 61 72 65 20 61 76 61 69 6c 61 tines are availa
2e930 62 6c 65 20 66 6f 72 20 74 68 65 20 6d 65 6d 32 ble for the mem2
2e940 2e 63 20 64 65 62 75 67 67 69 6e 67 20 6d 65 6d .c debugging mem
2e950 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 0a 2a 2a ory allocator.**
2e960 20 6f 6e 6c 79 2e 20 20 54 68 65 79 20 61 72 65 only. They are
2e970 20 75 73 65 64 20 74 6f 20 76 65 72 69 66 79 20 used to verify
2e980 74 68 61 74 20 64 69 66 66 65 72 65 6e 74 20 22 that different "
2e990 74 79 70 65 73 22 20 6f 66 20 6d 65 6d 6f 72 79 types" of memory
2e9a0 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 .** allocations
2e9b0 61 72 65 20 70 72 6f 70 65 72 6c 79 20 74 72 61 are properly tra
2e9c0 63 6b 65 64 20 62 79 20 74 68 65 20 73 79 73 74 cked by the syst
2e9d0 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 em..**.** sqlite
2e9e0 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 3MemdebugSetType
2e9f0 28 29 20 73 65 74 73 20 74 68 65 20 22 74 79 70 () sets the "typ
2ea00 65 22 20 6f 66 20 61 6e 20 61 6c 6c 6f 63 61 74 e" of an allocat
2ea10 69 6f 6e 20 74 6f 20 6f 6e 65 20 6f 66 0a 2a 2a ion to one of.**
2ea20 20 74 68 65 20 4d 45 4d 54 59 50 45 5f 2a 20 6d the MEMTYPE_* m
2ea30 61 63 72 6f 73 20 64 65 66 69 6e 65 64 20 62 65 acros defined be
2ea40 6c 6f 77 2e 20 20 54 68 65 20 74 79 70 65 20 6d low. The type m
2ea50 75 73 74 20 62 65 20 61 20 62 69 74 6d 61 73 6b ust be a bitmask
2ea60 20 77 69 74 68 0a 2a 2a 20 61 20 73 69 6e 67 6c with.** a singl
2ea70 65 20 62 69 74 20 73 65 74 2e 0a 2a 2a 0a 2a 2a e bit set..**.**
2ea80 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 sqlite3Memdebug
2ea90 48 61 73 54 79 70 65 28 29 20 72 65 74 75 72 6e HasType() return
2eaa0 73 20 74 72 75 65 20 69 66 20 61 6e 79 20 6f 66 s true if any of
2eab0 20 74 68 65 20 62 69 74 73 20 69 6e 20 69 74 73 the bits in its
2eac0 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 67 75 6d second.** argum
2ead0 65 6e 74 20 6d 61 74 63 68 20 74 68 65 20 74 79 ent match the ty
2eae0 70 65 20 73 65 74 20 62 79 20 74 68 65 20 70 72 pe set by the pr
2eaf0 65 76 69 6f 75 73 20 73 71 6c 69 74 65 33 4d 65 evious sqlite3Me
2eb00 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 29 2e mdebugSetType().
2eb10 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
2eb20 62 75 67 48 61 73 54 79 70 65 28 29 20 69 73 20 bugHasType() is
2eb30 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 65 intended for use
2eb40 20 69 6e 73 69 64 65 20 61 73 73 65 72 74 28 29 inside assert()
2eb50 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a statements..**.
2eb60 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 ** sqlite3Memdeb
2eb70 75 67 4e 6f 54 79 70 65 28 29 20 72 65 74 75 72 ugNoType() retur
2eb80 6e 73 20 74 72 75 65 20 69 66 20 6e 6f 6e 65 20 ns true if none
2eb90 6f 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 69 of the bits in i
2eba0 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 67 ts second.** arg
2ebb0 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 20 ument match the
2ebc0 74 79 70 65 20 73 65 74 20 62 79 20 74 68 65 20 type set by the
2ebd0 70 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 33 previous sqlite3
2ebe0 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 MemdebugSetType(
2ebf0 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 72 68 61 70 73 )..**.** Perhaps
2ec00 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 74 the most import
2ec10 61 6e 74 20 70 6f 69 6e 74 20 69 73 20 74 68 65 ant point is the
2ec20 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 77 difference betw
2ec30 65 65 6e 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 een MEMTYPE_HEAP
2ec40 0a 2a 2a 20 61 6e 64 20 4d 45 4d 54 59 50 45 5f .** and MEMTYPE_
2ec50 4c 4f 4f 4b 41 53 49 44 45 2e 20 20 49 66 20 61 LOOKASIDE. If a
2ec60 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 20 n allocation is
2ec70 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 MEMTYPE_LOOKASID
2ec80 45 2c 20 74 68 61 74 20 6d 65 61 6e 73 0a 2a 2a E, that means.**
2ec90 20 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 62 it might have b
2eca0 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 een allocated by
2ecb0 20 6c 6f 6f 6b 61 73 69 64 65 2c 20 65 78 63 65 lookaside, exce
2ecc0 70 74 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f pt the allocatio
2ecd0 6e 20 77 61 73 0a 2a 2a 20 74 6f 6f 20 6c 61 72 n was.** too lar
2ece0 67 65 20 6f 72 20 6c 6f 6f 6b 61 73 69 64 65 20 ge or lookaside
2ecf0 77 61 73 20 61 6c 72 65 61 64 79 20 66 75 6c 6c was already full
2ed00 2e 20 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 . It is importa
2ed10 6e 74 20 74 6f 20 76 65 72 69 66 79 0a 2a 2a 20 nt to verify.**
2ed20 74 68 61 74 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 that allocations
2ed30 20 74 68 61 74 20 6d 69 67 68 74 20 68 61 76 65 that might have
2ed40 20 62 65 65 6e 20 73 61 74 69 73 66 69 65 64 20 been satisfied
2ed50 62 79 20 6c 6f 6f 6b 61 73 69 64 65 20 61 72 65 by lookaside are
2ed60 20 6e 6f 74 0a 2a 2a 20 70 61 73 73 65 64 20 62 not.** passed b
2ed70 61 63 6b 20 74 6f 20 6e 6f 6e 2d 6c 6f 6f 6b 61 ack to non-looka
2ed80 73 69 64 65 20 66 72 65 65 28 29 20 72 6f 75 74 side free() rout
2ed90 69 6e 65 73 2e 20 20 41 73 73 65 72 74 73 20 73 ines. Asserts s
2eda0 75 63 68 20 61 73 20 74 68 65 0a 2a 2a 20 65 78 uch as the.** ex
2edb0 61 6d 70 6c 65 20 61 62 6f 76 65 20 61 72 65 20 ample above are
2edc0 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 20 6e 6f placed on the no
2edd0 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 72 65 65 n-lookaside free
2ede0 28 29 20 72 6f 75 74 69 6e 65 73 20 74 6f 20 76 () routines to v
2edf0 65 72 69 66 79 0a 2a 2a 20 74 68 69 73 20 63 6f erify.** this co
2ee00 6e 73 74 72 61 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 nstraint..**.**
2ee10 41 6c 6c 20 6f 66 20 74 68 69 73 20 69 73 20 6e All of this is n
2ee20 6f 2d 6f 70 20 66 6f 72 20 61 20 70 72 6f 64 75 o-op for a produ
2ee30 63 74 69 6f 6e 20 62 75 69 6c 64 2e 20 20 49 74 ction build. It
2ee40 20 6f 6e 6c 79 20 63 6f 6d 65 73 20 69 6e 74 6f only comes into
2ee50 0a 2a 2a 20 70 6c 61 79 20 77 68 65 6e 20 74 68 .** play when th
2ee60 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 e SQLITE_MEMDEBU
2ee70 47 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 6f G compile-time o
2ee80 70 74 69 6f 6e 20 69 73 20 75 73 65 64 2e 0a 2a ption is used..*
2ee90 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
2eea0 4d 45 4d 44 45 42 55 47 0a 20 20 76 6f 69 64 20 MEMDEBUG. void
2eeb0 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 sqlite3MemdebugS
2eec0 65 74 54 79 70 65 28 76 6f 69 64 2a 2c 75 38 29 etType(void*,u8)
2eed0 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4d ;. int sqlite3M
2eee0 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 76 emdebugHasType(v
2eef0 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 69 6e 74 20 oid*,u8);. int
2ef00 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e sqlite3MemdebugN
2ef10 6f 54 79 70 65 28 76 6f 69 64 2a 2c 75 38 29 3b oType(void*,u8);
2ef20 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
2ef30 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 53 sqlite3MemdebugS
2ef40 65 74 54 79 70 65 28 58 2c 59 29 20 20 2f 2a 20 etType(X,Y) /*
2ef50 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 64 65 66 69 6e no-op */.# defin
2ef60 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 e sqlite3Memdebu
2ef70 67 48 61 73 54 79 70 65 28 58 2c 59 29 20 20 31 gHasType(X,Y) 1
2ef80 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
2ef90 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 28 3MemdebugNoType(
2efa0 58 2c 59 29 20 20 20 31 0a 23 65 6e 64 69 66 0a X,Y) 1.#endif.
2efb0 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f #define MEMTYPE_
2efc0 48 45 41 50 20 20 20 20 20 20 20 30 78 30 31 20 HEAP 0x01
2efd0 20 2f 2a 20 47 65 6e 65 72 61 6c 20 68 65 61 70 /* General heap
2efe0 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 2a 2f 0a allocations */.
2eff0 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f #define MEMTYPE_
2f000 4c 4f 4f 4b 41 53 49 44 45 20 20 30 78 30 32 20 LOOKASIDE 0x02
2f010 20 2f 2a 20 48 65 61 70 20 74 68 61 74 20 6d 69 /* Heap that mi
2f020 67 68 74 20 68 61 76 65 20 62 65 65 6e 20 6c 6f ght have been lo
2f030 6f 6b 61 73 69 64 65 20 2a 2f 0a 23 64 65 66 69 okaside */.#defi
2f040 6e 65 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 ne MEMTYPE_PCACH
2f050 45 20 20 20 20 20 30 78 30 34 20 20 2f 2a 20 50 E 0x04 /* P
2f060 61 67 65 20 63 61 63 68 65 20 61 6c 6c 6f 63 61 age cache alloca
2f070 74 69 6f 6e 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 tions */../*.**
2f080 54 68 72 65 61 64 69 6e 67 20 69 6e 74 65 72 66 Threading interf
2f090 61 63 65 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 ace.*/.#if SQLIT
2f0a0 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 E_MAX_WORKER_THR
2f0b0 45 41 44 53 3e 30 0a 69 6e 74 20 73 71 6c 69 74 EADS>0.int sqlit
2f0c0 65 33 54 68 72 65 61 64 43 72 65 61 74 65 28 53 e3ThreadCreate(S
2f0d0 51 4c 69 74 65 54 68 72 65 61 64 2a 2a 2c 76 6f QLiteThread**,vo
2f0e0 69 64 2a 28 2a 29 28 76 6f 69 64 2a 29 2c 76 6f id*(*)(void*),vo
2f0f0 69 64 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 id*);.int sqlite
2f100 33 54 68 72 65 61 64 4a 6f 69 6e 28 53 51 4c 69 3ThreadJoin(SQLi
2f110 74 65 54 68 72 65 61 64 2a 2c 20 76 6f 69 64 2a teThread*, void*
2f120 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 *);.#endif..#if
2f130 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
2f140 4e 41 42 4c 45 5f 44 42 50 41 47 45 5f 56 54 41 NABLE_DBPAGE_VTA
2f150 42 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 B) || defined(SQ
2f160 4c 49 54 45 5f 54 45 53 54 29 0a 69 6e 74 20 73 LITE_TEST).int s
2f170 71 6c 69 74 65 33 44 62 70 61 67 65 52 65 67 69 qlite3DbpageRegi
2f180 73 74 65 72 28 73 71 6c 69 74 65 33 2a 29 3b 0a ster(sqlite3*);.
2f190 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e #endif.#if defin
2f1a0 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
2f1b0 5f 44 42 53 54 41 54 5f 56 54 41 42 29 20 7c 7c _DBSTAT_VTAB) ||
2f1c0 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
2f1d0 54 45 53 54 29 0a 69 6e 74 20 73 71 6c 69 74 65 TEST).int sqlite
2f1e0 33 44 62 73 74 61 74 52 65 67 69 73 74 65 72 28 3DbstatRegister(
2f1f0 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 6e 64 69 sqlite3*);.#endi
2f200 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 f..int sqlite3Ex
2f210 70 72 56 65 63 74 6f 72 53 69 7a 65 28 45 78 70 prVectorSize(Exp
2f220 72 20 2a 70 45 78 70 72 29 3b 0a 69 6e 74 20 73 r *pExpr);.int s
2f230 71 6c 69 74 65 33 45 78 70 72 49 73 56 65 63 74 qlite3ExprIsVect
2f240 6f 72 28 45 78 70 72 20 2a 70 45 78 70 72 29 3b or(Expr *pExpr);
2f250 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 56 65 .Expr *sqlite3Ve
2f260 63 74 6f 72 46 69 65 6c 64 53 75 62 65 78 70 72 ctorFieldSubexpr
2f270 28 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 45 78 (Expr*, int);.Ex
2f280 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 46 pr *sqlite3ExprF
2f290 6f 72 56 65 63 74 6f 72 46 69 65 6c 64 28 50 61 orVectorField(Pa
2f2a0 72 73 65 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b rse*,Expr*,int);
2f2b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 65 63 .void sqlite3Vec
2f2c0 74 6f 72 45 72 72 6f 72 4d 73 67 28 50 61 72 73 torErrorMsg(Pars
2f2d0 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 0a 23 69 66 e*, Expr*);..#if
2f2e0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2f2f0 5f 43 4f 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f 44 _COMPILEOPTION_D
2f300 49 41 47 53 0a 63 6f 6e 73 74 20 63 68 61 72 20 IAGS.const char
2f310 2a 2a 73 71 6c 69 74 65 33 43 6f 6d 70 69 6c 65 **sqlite3Compile
2f320 4f 70 74 69 6f 6e 73 28 69 6e 74 20 2a 70 6e 4f Options(int *pnO
2f330 70 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 65 6e pt);.#endif..#en
2f340 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 49 4e 54 dif /* SQLITEINT
2f350 5f 48 20 2a 2f 0a _H */.