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 4d 61 6b 65 20 73 75 72 ../*.** Make sur
0770: 65 20 74 68 61 74 20 72 61 6e 64 5f 73 28 29 20 e that rand_s()
0780: 69 73 20 61 76 61 69 6c 61 62 6c 65 20 6f 6e 20 is available on
0790: 57 69 6e 64 6f 77 73 20 73 79 73 74 65 6d 73 20 Windows systems
07a0: 77 69 74 68 20 4d 53 56 43 20 32 30 30 35 0a 2a with MSVC 2005.*
07b0: 2a 20 6f 72 20 68 69 67 68 65 72 2e 0a 2a 2f 0a * or higher..*/.
07c0: 23 69 66 20 64 65 66 69 6e 65 64 28 5f 4d 53 43 #if defined(_MSC
07d0: 5f 56 45 52 29 20 26 26 20 5f 4d 53 43 5f 56 45 _VER) && _MSC_VE
07e0: 52 3e 3d 31 34 30 30 0a 23 20 20 64 65 66 69 6e R>=1400.# defin
07f0: 65 20 5f 43 52 54 5f 52 41 4e 44 5f 53 0a 23 65 e _CRT_RAND_S.#e
0800: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c ndif../*.** Incl
0810: 75 64 65 20 74 68 65 20 68 65 61 64 65 72 20 66 ude the header f
0820: 69 6c 65 20 75 73 65 64 20 74 6f 20 63 75 73 74 ile used to cust
0830: 6f 6d 69 7a 65 20 74 68 65 20 63 6f 6d 70 69 6c omize the compil
0840: 65 72 20 6f 70 74 69 6f 6e 73 20 66 6f 72 20 4d er options for M
0850: 53 56 43 2e 0a 2a 2a 20 54 68 69 73 20 73 68 6f SVC..** This sho
0860: 75 6c 64 20 62 65 20 64 6f 6e 65 20 66 69 72 73 uld be done firs
0870: 74 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e t so that it can
0880: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 70 72 successfully pr
0890: 65 76 65 6e 74 20 73 70 75 72 69 6f 75 73 0a 2a event spurious.*
08a0: 2a 20 63 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 * compiler warni
08b0: 6e 67 73 20 64 75 65 20 74 6f 20 73 75 62 73 65 ngs due to subse
08c0: 71 75 65 6e 74 20 63 6f 6e 74 65 6e 74 20 69 6e quent content in
08d0: 20 74 68 69 73 20 66 69 6c 65 20 61 6e 64 20 6f this file and o
08e0: 74 68 65 72 20 66 69 6c 65 73 0a 2a 2a 20 74 68 ther files.** th
08f0: 61 74 20 61 72 65 20 69 6e 63 6c 75 64 65 64 20 at are included
0900: 62 79 20 74 68 69 73 20 66 69 6c 65 2e 0a 2a 2f by this file..*/
0910: 0a 23 69 6e 63 6c 75 64 65 20 22 6d 73 76 63 2e .#include "msvc.
0920: 68 22 0a 0a 2f 2a 0a 2a 2a 20 53 70 65 63 69 61 h"../*.** Specia
0930: 6c 20 73 65 74 75 70 20 66 6f 72 20 56 78 57 6f l setup for VxWo
0940: 72 6b 73 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 rks.*/.#include
0950: 22 76 78 77 6f 72 6b 73 2e 68 22 0a 0a 2f 2a 0a "vxworks.h"../*.
0960: 2a 2a 20 54 68 65 73 65 20 23 64 65 66 69 6e 65 ** These #define
0970: 73 20 73 68 6f 75 6c 64 20 65 6e 61 62 6c 65 20 s should enable
0980: 3e 32 47 42 20 66 69 6c 65 20 73 75 70 70 6f 72 >2GB file suppor
0990: 74 20 6f 6e 20 50 4f 53 49 58 20 69 66 20 74 68 t on POSIX if th
09a0: 65 0a 2a 2a 20 75 6e 64 65 72 6c 79 69 6e 67 20 e.** underlying
09b0: 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d operating system
09c0: 20 73 75 70 70 6f 72 74 73 20 69 74 2e 20 20 49 supports it. I
09d0: 66 20 74 68 65 20 4f 53 20 6c 61 63 6b 73 0a 2a f the OS lacks.*
09e0: 2a 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 * large file sup
09f0: 70 6f 72 74 2c 20 6f 72 20 69 66 20 74 68 65 20 port, or if the
0a00: 4f 53 20 69 73 20 77 69 6e 64 6f 77 73 2c 20 74 OS is windows, t
0a10: 68 65 73 65 20 73 68 6f 75 6c 64 20 62 65 20 6e hese should be n
0a20: 6f 2d 6f 70 73 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 o-ops..**.** Tic
0a30: 6b 65 74 20 23 32 37 33 39 3a 20 20 54 68 65 20 ket #2739: The
0a40: 5f 4c 41 52 47 45 46 49 4c 45 5f 53 4f 55 52 43 _LARGEFILE_SOURC
0a50: 45 20 6d 61 63 72 6f 20 6d 75 73 74 20 61 70 70 E macro must app
0a60: 65 61 72 20 62 65 66 6f 72 65 20 61 6e 79 0a 2a ear before any.*
0a70: 2a 20 73 79 73 74 65 6d 20 23 69 6e 63 6c 75 64 * system #includ
0a80: 65 73 2e 20 20 48 65 6e 63 65 2c 20 74 68 69 73 es. Hence, this
0a90: 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 6d block of code m
0aa0: 75 73 74 20 62 65 20 74 68 65 20 76 65 72 79 20 ust be the very
0ab0: 66 69 72 73 74 0a 2a 2a 20 63 6f 64 65 20 69 6e first.** code in
0ac0: 20 61 6c 6c 20 73 6f 75 72 63 65 20 66 69 6c 65 all source file
0ad0: 73 2e 0a 2a 2a 0a 2a 2a 20 4c 61 72 67 65 20 66 s..**.** Large f
0ae0: 69 6c 65 20 73 75 70 70 6f 72 74 20 63 61 6e 20 ile support can
0af0: 62 65 20 64 69 73 61 62 6c 65 64 20 75 73 69 6e be disabled usin
0b00: 67 20 74 68 65 20 2d 44 53 51 4c 49 54 45 5f 44 g the -DSQLITE_D
0b10: 49 53 41 42 4c 45 5f 4c 46 53 20 73 77 69 74 63 ISABLE_LFS switc
0b20: 68 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 6f 6d 70 h.** on the comp
0b30: 69 6c 65 72 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e iler command lin
0b40: 65 2e 20 20 54 68 69 73 20 69 73 20 6e 65 63 65 e. This is nece
0b50: 73 73 61 72 79 20 69 66 20 79 6f 75 20 61 72 65 ssary if you are
0b60: 20 63 6f 6d 70 69 6c 69 6e 67 0a 2a 2a 20 6f 6e compiling.** on
0b70: 20 61 20 72 65 63 65 6e 74 20 6d 61 63 68 69 6e a recent machin
0b80: 65 20 28 65 78 3a 20 52 65 64 20 48 61 74 20 37 e (ex: Red Hat 7
0b90: 2e 32 29 20 62 75 74 20 79 6f 75 20 77 61 6e 74 .2) but you want
0ba0: 20 79 6f 75 72 20 63 6f 64 65 20 74 6f 20 77 6f your code to wo
0bb0: 72 6b 0a 2a 2a 20 6f 6e 20 61 6e 20 6f 6c 64 65 rk.** on an olde
0bc0: 72 20 6d 61 63 68 69 6e 65 20 28 65 78 3a 20 52 r machine (ex: R
0bd0: 65 64 20 48 61 74 20 36 2e 30 29 2e 20 20 49 66 ed Hat 6.0). If
0be0: 20 79 6f 75 20 63 6f 6d 70 69 6c 65 20 6f 6e 20 you compile on
0bf0: 52 65 64 20 48 61 74 20 37 2e 32 0a 2a 2a 20 77 Red Hat 7.2.** w
0c00: 69 74 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 ithout this opti
0c10: 6f 6e 2c 20 4c 46 53 20 69 73 20 65 6e 61 62 6c on, LFS is enabl
0c20: 65 2e 20 20 42 75 74 20 4c 46 53 20 64 6f 65 73 e. But LFS does
0c30: 20 6e 6f 74 20 65 78 69 73 74 20 69 6e 20 74 68 not exist in th
0c40: 65 20 6b 65 72 6e 65 6c 0a 2a 2a 20 69 6e 20 52 e kernel.** in R
0c50: 65 64 20 48 61 74 20 36 2e 30 2c 20 73 6f 20 74 ed Hat 6.0, so t
0c60: 68 65 20 63 6f 64 65 20 77 6f 6e 27 74 20 77 6f he code won't wo
0c70: 72 6b 2e 20 20 48 65 6e 63 65 2c 20 66 6f 72 20 rk. Hence, for
0c80: 6d 61 78 69 6d 75 6d 20 62 69 6e 61 72 79 0a 2a maximum binary.*
0c90: 2a 20 70 6f 72 74 61 62 69 6c 69 74 79 20 79 6f * portability yo
0ca0: 75 20 73 68 6f 75 6c 64 20 6f 6d 69 74 20 4c 46 u should omit LF
0cb0: 53 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 70 72 65 S..**.** The pre
0cc0: 76 69 6f 75 73 20 70 61 72 61 67 72 61 70 68 20 vious paragraph
0cd0: 77 61 73 20 77 72 69 74 74 65 6e 20 69 6e 20 32 was written in 2
0ce0: 30 30 35 2e 20 20 28 54 68 69 73 20 70 61 72 61 005. (This para
0cf0: 67 72 61 70 68 20 69 73 20 77 72 69 74 74 65 6e graph is written
0d00: 0a 2a 2a 20 6f 6e 20 32 30 30 38 2d 31 31 2d 32 .** on 2008-11-2
0d10: 38 2e 29 20 54 68 65 73 65 20 64 61 79 73 2c 20 8.) These days,
0d20: 61 6c 6c 20 4c 69 6e 75 78 20 6b 65 72 6e 65 6c all Linux kernel
0d30: 73 20 73 75 70 70 6f 72 74 20 6c 61 72 67 65 20 s support large
0d40: 66 69 6c 65 73 2c 20 73 6f 0a 2a 2a 20 79 6f 75 files, so.** you
0d50: 20 73 68 6f 75 6c 64 20 70 72 6f 62 61 62 6c 79 should probably
0d60: 20 6c 65 61 76 65 20 4c 46 53 20 65 6e 61 62 6c leave LFS enabl
0d70: 65 64 2e 20 20 42 75 74 20 73 6f 6d 65 20 65 6d ed. But some em
0d80: 62 65 64 64 65 64 20 70 6c 61 74 66 6f 72 6d 73 bedded platforms
0d90: 20 6d 69 67 68 74 0a 2a 2a 20 6c 61 63 6b 20 4c might.** lack L
0da0: 46 53 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 FS in which case
0db0: 20 74 68 65 20 53 51 4c 49 54 45 5f 44 49 53 41 the SQLITE_DISA
0dc0: 42 4c 45 5f 4c 46 53 20 6d 61 63 72 6f 20 6d 69 BLE_LFS macro mi
0dd0: 67 68 74 20 73 74 69 6c 6c 20 62 65 20 75 73 65 ght still be use
0de0: 66 75 6c 2e 0a 2a 2a 0a 2a 2a 20 53 69 6d 69 6c ful..**.** Simil
0df0: 61 72 20 69 73 20 74 72 75 65 20 66 6f 72 20 4d ar is true for M
0e00: 61 63 20 4f 53 20 58 2e 20 20 4c 46 53 20 69 73 ac OS X. LFS is
0e10: 20 6f 6e 6c 79 20 73 75 70 70 6f 72 74 65 64 20 only supported
0e20: 6f 6e 20 4d 61 63 20 4f 53 20 58 20 39 20 61 6e on Mac OS X 9 an
0e30: 64 20 6c 61 74 65 72 2e 0a 2a 2f 0a 23 69 66 6e d later..*/.#ifn
0e40: 64 65 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 def SQLITE_DISAB
0e50: 4c 45 5f 4c 46 53 0a 23 20 64 65 66 69 6e 65 20 LE_LFS.# define
0e60: 5f 4c 41 52 47 45 5f 46 49 4c 45 20 20 20 20 20 _LARGE_FILE
0e70: 20 20 31 0a 23 20 69 66 6e 64 65 66 20 5f 46 49 1.# ifndef _FI
0e80: 4c 45 5f 4f 46 46 53 45 54 5f 42 49 54 53 0a 23 LE_OFFSET_BITS.#
0e90: 20 20 20 64 65 66 69 6e 65 20 5f 46 49 4c 45 5f define _FILE_
0ea0: 4f 46 46 53 45 54 5f 42 49 54 53 20 36 34 0a 23 OFFSET_BITS 64.#
0eb0: 20 65 6e 64 69 66 0a 23 20 64 65 66 69 6e 65 20 endif.# define
0ec0: 5f 4c 41 52 47 45 46 49 4c 45 5f 53 4f 55 52 43 _LARGEFILE_SOURC
0ed0: 45 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 57 E 1.#endif../* W
0ee0: 68 61 74 20 76 65 72 73 69 6f 6e 20 6f 66 20 47 hat version of G
0ef0: 43 43 20 69 73 20 62 65 69 6e 67 20 75 73 65 64 CC is being used
0f00: 2e 20 20 30 20 6d 65 61 6e 73 20 47 43 43 20 69 . 0 means GCC i
0f10: 73 20 6e 6f 74 20 62 65 69 6e 67 20 75 73 65 64 s not being used
0f20: 20 2a 2f 0a 23 69 66 64 65 66 20 5f 5f 47 4e 55 */.#ifdef __GNU
0f30: 43 5f 5f 0a 23 20 64 65 66 69 6e 65 20 47 43 43 C__.# define GCC
0f40: 5f 56 45 52 53 49 4f 4e 20 28 5f 5f 47 4e 55 43 _VERSION (__GNUC
0f50: 5f 5f 2a 31 30 30 30 30 30 30 2b 5f 5f 47 4e 55 __*1000000+__GNU
0f60: 43 5f 4d 49 4e 4f 52 5f 5f 2a 31 30 30 30 2b 5f C_MINOR__*1000+_
0f70: 5f 47 4e 55 43 5f 50 41 54 43 48 4c 45 56 45 4c _GNUC_PATCHLEVEL
0f80: 5f 5f 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 __).#else.# defi
0f90: 6e 65 20 47 43 43 5f 56 45 52 53 49 4f 4e 20 30 ne GCC_VERSION 0
0fa0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 4e 65 65 64 .#endif../* Need
0fb0: 65 64 20 66 6f 72 20 76 61 72 69 6f 75 73 20 64 ed for various d
0fc0: 65 66 69 6e 69 74 69 6f 6e 73 2e 2e 2e 20 2a 2f efinitions... */
0fd0: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 47 .#if defined(__G
0fe0: 4e 55 43 5f 5f 29 20 26 26 20 21 64 65 66 69 6e NUC__) && !defin
0ff0: 65 64 28 5f 47 4e 55 5f 53 4f 55 52 43 45 29 0a ed(_GNU_SOURCE).
1000: 23 20 64 65 66 69 6e 65 20 5f 47 4e 55 5f 53 4f # define _GNU_SO
1010: 55 52 43 45 0a 23 65 6e 64 69 66 0a 0a 23 69 66 URCE.#endif..#if
1020: 20 64 65 66 69 6e 65 64 28 5f 5f 4f 70 65 6e 42 defined(__OpenB
1030: 53 44 5f 5f 29 20 26 26 20 21 64 65 66 69 6e 65 SD__) && !define
1040: 64 28 5f 42 53 44 5f 53 4f 55 52 43 45 29 0a 23 d(_BSD_SOURCE).#
1050: 20 64 65 66 69 6e 65 20 5f 42 53 44 5f 53 4f 55 define _BSD_SOU
1060: 52 43 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a RCE.#endif../*.*
1070: 2a 20 46 6f 72 20 4d 69 6e 47 57 2c 20 63 68 65 * For MinGW, che
1080: 63 6b 20 74 6f 20 73 65 65 20 69 66 20 77 65 20 ck to see if we
1090: 63 61 6e 20 69 6e 63 6c 75 64 65 20 74 68 65 20 can include the
10a0: 68 65 61 64 65 72 20 66 69 6c 65 20 63 6f 6e 74 header file cont
10b0: 61 69 6e 69 6e 67 20 69 74 73 0a 2a 2a 20 76 65 aining its.** ve
10c0: 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f rsion informatio
10d0: 6e 2c 20 61 6d 6f 6e 67 20 6f 74 68 65 72 20 74 n, among other t
10e0: 68 69 6e 67 73 2e 20 20 4e 6f 72 6d 61 6c 6c 79 hings. Normally
10f0: 2c 20 74 68 69 73 20 69 6e 74 65 72 6e 61 6c 20 , this internal
1100: 4d 69 6e 47 57 0a 2a 2a 20 68 65 61 64 65 72 20 MinGW.** header
1110: 66 69 6c 65 20 77 6f 75 6c 64 20 5b 6f 6e 6c 79 file would [only
1120: 5d 20 62 65 20 69 6e 63 6c 75 64 65 64 20 61 75 ] be included au
1130: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 20 6f tomatically by o
1140: 74 68 65 72 20 4d 69 6e 47 57 20 68 65 61 64 65 ther MinGW heade
1150: 72 0a 2a 2a 20 66 69 6c 65 73 3b 20 68 6f 77 65 r.** files; howe
1160: 76 65 72 2c 20 74 68 65 20 63 6f 6e 74 61 69 6e ver, the contain
1170: 65 64 20 76 65 72 73 69 6f 6e 20 69 6e 66 6f 72 ed version infor
1180: 6d 61 74 69 6f 6e 20 69 73 20 6e 6f 77 20 72 65 mation is now re
1190: 71 75 69 72 65 64 20 62 79 20 74 68 69 73 0a 2a quired by this.*
11a0: 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20 74 6f * header file to
11b0: 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 62 69 6e work around bin
11c0: 61 72 79 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 ary compatibilit
11d0: 79 20 69 73 73 75 65 73 20 28 73 65 65 20 62 65 y issues (see be
11e0: 6c 6f 77 29 20 61 6e 64 0a 2a 2a 20 74 68 69 73 low) and.** this
11f0: 20 69 73 20 74 68 65 20 6f 6e 6c 79 20 6b 6e 6f is the only kno
1200: 77 6e 20 77 61 79 20 74 6f 20 72 65 6c 69 61 62 wn way to reliab
1210: 6c 79 20 6f 62 74 61 69 6e 20 69 74 2e 20 20 54 ly obtain it. T
1220: 68 69 73 20 65 6e 74 69 72 65 20 23 69 66 20 62 his entire #if b
1230: 6c 6f 63 6b 0a 2a 2a 20 77 6f 75 6c 64 20 62 65 lock.** would be
1240: 20 63 6f 6d 70 6c 65 74 65 6c 79 20 75 6e 6e 65 completely unne
1250: 63 65 73 73 61 72 79 20 69 66 20 74 68 65 72 65 cessary if there
1260: 20 77 61 73 20 61 6e 79 20 6f 74 68 65 72 20 77 was any other w
1270: 61 79 20 6f 66 20 64 65 74 65 63 74 69 6e 67 0a ay of detecting.
1280: 2a 2a 20 4d 69 6e 47 57 20 76 69 61 20 74 68 65 ** MinGW via the
1290: 69 72 20 70 72 65 70 72 6f 63 65 73 73 6f 72 20 ir preprocessor
12a0: 28 65 2e 67 2e 20 69 66 20 74 68 65 79 20 63 75 (e.g. if they cu
12b0: 73 74 6f 6d 69 7a 65 64 20 74 68 65 69 72 20 47 stomized their G
12c0: 43 43 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a 20 CC to define.**
12d0: 73 6f 6d 65 20 4d 69 6e 47 57 2d 73 70 65 63 69 some MinGW-speci
12e0: 66 69 63 20 6d 61 63 72 6f 73 29 2e 20 20 57 68 fic macros). Wh
12f0: 65 6e 20 63 6f 6d 70 69 6c 69 6e 67 20 66 6f 72 en compiling for
1300: 20 4d 69 6e 47 57 2c 20 65 69 74 68 65 72 20 74 MinGW, either t
1310: 68 65 0a 2a 2a 20 5f 48 41 56 45 5f 4d 49 4e 47 he.** _HAVE_MING
1320: 57 5f 48 20 6f 72 20 5f 48 41 56 45 5f 5f 4d 49 W_H or _HAVE__MI
1330: 4e 47 57 5f 48 20 28 6e 6f 74 65 20 74 68 65 20 NGW_H (note the
1340: 65 78 74 72 61 20 75 6e 64 65 72 73 63 6f 72 65 extra underscore
1350: 29 20 6d 61 63 72 6f 20 6d 75 73 74 20 62 65 0a ) macro must be.
1360: 2a 2a 20 64 65 66 69 6e 65 64 3b 20 6f 74 68 65 ** defined; othe
1370: 72 77 69 73 65 2c 20 64 65 74 65 63 74 69 6f 6e rwise, detection
1380: 20 6f 66 20 63 6f 6e 64 69 74 69 6f 6e 73 20 73 of conditions s
1390: 70 65 63 69 66 69 63 20 74 6f 20 4d 69 6e 47 57 pecific to MinGW
13a0: 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 64 69 73 61 will be.** disa
13b0: 62 6c 65 64 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 bled..*/.#if def
13c0: 69 6e 65 64 28 5f 48 41 56 45 5f 4d 49 4e 47 57 ined(_HAVE_MINGW
13d0: 5f 48 29 0a 23 20 69 6e 63 6c 75 64 65 20 22 6d _H).# include "m
13e0: 69 6e 67 77 2e 68 22 0a 23 65 6c 69 66 20 64 65 ingw.h".#elif de
13f0: 66 69 6e 65 64 28 5f 48 41 56 45 5f 5f 4d 49 4e fined(_HAVE__MIN
1400: 47 57 5f 48 29 0a 23 20 69 6e 63 6c 75 64 65 20 GW_H).# include
1410: 22 5f 6d 69 6e 67 77 2e 68 22 0a 23 65 6e 64 69 "_mingw.h".#endi
1420: 66 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 4d 69 6e f../*.** For Min
1430: 47 57 20 76 65 72 73 69 6f 6e 20 34 2e 78 20 28 GW version 4.x (
1440: 61 6e 64 20 68 69 67 68 65 72 29 2c 20 63 68 65 and higher), che
1450: 63 6b 20 74 6f 20 73 65 65 20 69 66 20 74 68 65 ck to see if the
1460: 20 5f 55 53 45 5f 33 32 42 49 54 5f 54 49 4d 45 _USE_32BIT_TIME
1470: 5f 54 0a 2a 2a 20 64 65 66 69 6e 65 20 69 73 20 _T.** define is
1480: 72 65 71 75 69 72 65 64 20 74 6f 20 6d 61 69 6e required to main
1490: 74 61 69 6e 20 62 69 6e 61 72 79 20 63 6f 6d 70 tain binary comp
14a0: 61 74 69 62 69 6c 69 74 79 20 77 69 74 68 20 74 atibility with t
14b0: 68 65 20 4d 53 56 43 20 72 75 6e 74 69 6d 65 0a he MSVC runtime.
14c0: 2a 2a 20 6c 69 62 72 61 72 79 20 69 6e 20 75 73 ** library in us
14d0: 65 20 28 65 2e 67 2e 20 66 6f 72 20 57 69 6e 64 e (e.g. for Wind
14e0: 6f 77 73 20 58 50 29 2e 0a 2a 2f 0a 23 69 66 20 ows XP)..*/.#if
14f0: 21 64 65 66 69 6e 65 64 28 5f 55 53 45 5f 33 32 !defined(_USE_32
1500: 42 49 54 5f 54 49 4d 45 5f 54 29 20 26 26 20 21 BIT_TIME_T) && !
1510: 64 65 66 69 6e 65 64 28 5f 55 53 45 5f 36 34 42 defined(_USE_64B
1520: 49 54 5f 54 49 4d 45 5f 54 29 20 26 26 20 5c 0a IT_TIME_T) && \.
1530: 20 20 20 20 64 65 66 69 6e 65 64 28 5f 57 49 4e defined(_WIN
1540: 33 32 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 32) && !defined(
1550: 5f 57 49 4e 36 34 29 20 26 26 20 5c 0a 20 20 20 _WIN64) && \.
1560: 20 64 65 66 69 6e 65 64 28 5f 5f 4d 49 4e 47 57 defined(__MINGW
1570: 5f 4d 41 4a 4f 52 5f 56 45 52 53 49 4f 4e 29 20 _MAJOR_VERSION)
1580: 26 26 20 5f 5f 4d 49 4e 47 57 5f 4d 41 4a 4f 52 && __MINGW_MAJOR
1590: 5f 56 45 52 53 49 4f 4e 20 3e 3d 20 34 20 26 26 _VERSION >= 4 &&
15a0: 20 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 28 5f \. defined(_
15b0: 5f 4d 53 56 43 52 54 5f 5f 29 0a 23 20 64 65 66 _MSVCRT__).# def
15c0: 69 6e 65 20 5f 55 53 45 5f 33 32 42 49 54 5f 54 ine _USE_32BIT_T
15d0: 49 4d 45 5f 54 0a 23 65 6e 64 69 66 0a 0a 2f 2a IME_T.#endif../*
15e0: 20 54 68 65 20 70 75 62 6c 69 63 20 53 51 4c 69 The public SQLi
15f0: 74 65 20 69 6e 74 65 72 66 61 63 65 2e 20 20 54 te interface. T
1600: 68 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 54 5f he _FILE_OFFSET_
1610: 42 49 54 53 20 6d 61 63 72 6f 20 6d 75 73 74 20 BITS macro must
1620: 61 70 70 65 61 72 0a 2a 2a 20 66 69 72 73 74 20 appear.** first
1630: 69 6e 20 51 4e 58 2e 20 20 41 6c 73 6f 2c 20 74 in QNX. Also, t
1640: 68 65 20 5f 55 53 45 5f 33 32 42 49 54 5f 54 49 he _USE_32BIT_TI
1650: 4d 45 5f 54 20 6d 61 63 72 6f 20 6d 75 73 74 20 ME_T macro must
1660: 61 70 70 65 61 72 20 66 69 72 73 74 20 66 6f 72 appear first for
1670: 0a 2a 2a 20 4d 69 6e 47 57 2e 0a 2a 2f 0a 23 69 .** MinGW..*/.#i
1680: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 33 2e nclude "sqlite3.
1690: 68 22 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 75 64 h"../*.** Includ
16a0: 65 20 74 68 65 20 63 6f 6e 66 69 67 75 72 61 74 e the configurat
16b0: 69 6f 6e 20 68 65 61 64 65 72 20 6f 75 74 70 75 ion header outpu
16c0: 74 20 62 79 20 27 63 6f 6e 66 69 67 75 72 65 27 t by 'configure'
16d0: 20 69 66 20 77 65 27 72 65 20 75 73 69 6e 67 20 if we're using
16e0: 74 68 65 0a 2a 2a 20 61 75 74 6f 63 6f 6e 66 2d the.** autoconf-
16f0: 62 61 73 65 64 20 62 75 69 6c 64 0a 2a 2f 0a 23 based build.*/.#
1700: 69 66 64 65 66 20 5f 48 41 56 45 5f 53 51 4c 49 ifdef _HAVE_SQLI
1710: 54 45 5f 43 4f 4e 46 49 47 5f 48 0a 23 69 6e 63 TE_CONFIG_H.#inc
1720: 6c 75 64 65 20 22 63 6f 6e 66 69 67 2e 68 22 0a lude "config.h".
1730: 23 65 6e 64 69 66 0a 0a 23 69 6e 63 6c 75 64 65 #endif..#include
1740: 20 22 73 71 6c 69 74 65 4c 69 6d 69 74 2e 68 22 "sqliteLimit.h"
1750: 0a 0a 2f 2a 20 44 69 73 61 62 6c 65 20 6e 75 69 ../* Disable nui
1760: 73 61 6e 63 65 20 77 61 72 6e 69 6e 67 73 20 6f sance warnings o
1770: 6e 20 42 6f 72 6c 61 6e 64 20 63 6f 6d 70 69 6c n Borland compil
1780: 65 72 73 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e ers */.#if defin
1790: 65 64 28 5f 5f 42 4f 52 4c 41 4e 44 43 5f 5f 29 ed(__BORLANDC__)
17a0: 0a 23 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 72 .#pragma warn -r
17b0: 63 68 20 2f 2a 20 75 6e 72 65 61 63 68 61 62 6c ch /* unreachabl
17c0: 65 20 63 6f 64 65 20 2a 2f 0a 23 70 72 61 67 6d e code */.#pragm
17d0: 61 20 77 61 72 6e 20 2d 63 63 63 20 2f 2a 20 43 a warn -ccc /* C
17e0: 6f 6e 64 69 74 69 6f 6e 20 69 73 20 61 6c 77 61 ondition is alwa
17f0: 79 73 20 74 72 75 65 20 6f 72 20 66 61 6c 73 65 ys true or false
1800: 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 72 6e */.#pragma warn
1810: 20 2d 61 75 73 20 2f 2a 20 41 73 73 69 67 6e 65 -aus /* Assigne
1820: 64 20 76 61 6c 75 65 20 69 73 20 6e 65 76 65 72 d value is never
1830: 20 75 73 65 64 20 2a 2f 0a 23 70 72 61 67 6d 61 used */.#pragma
1840: 20 77 61 72 6e 20 2d 63 73 75 20 2f 2a 20 43 6f warn -csu /* Co
1850: 6d 70 61 72 69 6e 67 20 73 69 67 6e 65 64 20 61 mparing signed a
1860: 6e 64 20 75 6e 73 69 67 6e 65 64 20 2a 2f 0a 23 nd unsigned */.#
1870: 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 73 70 61 pragma warn -spa
1880: 20 2f 2a 20 53 75 73 70 69 63 69 6f 75 73 20 70 /* Suspicious p
1890: 6f 69 6e 74 65 72 20 61 72 69 74 68 6d 65 74 69 ointer arithmeti
18a0: 63 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a c */.#endif../*.
18b0: 2a 2a 20 49 6e 63 6c 75 64 65 20 73 74 61 6e 64 ** Include stand
18c0: 61 72 64 20 68 65 61 64 65 72 20 66 69 6c 65 73 ard header files
18d0: 20 61 73 20 6e 65 63 65 73 73 61 72 79 0a 2a 2f as necessary.*/
18e0: 0a 23 69 66 64 65 66 20 48 41 56 45 5f 53 54 44 .#ifdef HAVE_STD
18f0: 49 4e 54 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c INT_H.#include <
1900: 73 74 64 69 6e 74 2e 68 3e 0a 23 65 6e 64 69 66 stdint.h>.#endif
1910: 0a 23 69 66 64 65 66 20 48 41 56 45 5f 49 4e 54 .#ifdef HAVE_INT
1920: 54 59 50 45 53 5f 48 0a 23 69 6e 63 6c 75 64 65 TYPES_H.#include
1930: 20 3c 69 6e 74 74 79 70 65 73 2e 68 3e 0a 23 65 <inttypes.h>.#e
1940: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
1950: 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 following macros
1960: 20 61 72 65 20 75 73 65 64 20 74 6f 20 63 61 73 are used to cas
1970: 74 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 69 6e t pointers to in
1980: 74 65 67 65 72 73 20 61 6e 64 0a 2a 2a 20 69 6e tegers and.** in
1990: 74 65 67 65 72 73 20 74 6f 20 70 6f 69 6e 74 65 tegers to pointe
19a0: 72 73 2e 20 20 54 68 65 20 77 61 79 20 79 6f 75 rs. The way you
19b0: 20 64 6f 20 74 68 69 73 20 76 61 72 69 65 73 20 do this varies
19c0: 66 72 6f 6d 20 6f 6e 65 20 63 6f 6d 70 69 6c 65 from one compile
19d0: 72 0a 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 r.** to the next
19e0: 2c 20 73 6f 20 77 65 20 68 61 76 65 20 64 65 76 , so we have dev
19f0: 65 6c 6f 70 65 64 20 74 68 65 20 66 6f 6c 6c 6f eloped the follo
1a00: 77 69 6e 67 20 73 65 74 20 6f 66 20 23 69 66 20 wing set of #if
1a10: 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 74 6f statements.** to
1a20: 20 67 65 6e 65 72 61 74 65 20 61 70 70 72 6f 70 generate approp
1a30: 72 69 61 74 65 20 6d 61 63 72 6f 73 20 66 6f 72 riate macros for
1a40: 20 61 20 77 69 64 65 20 72 61 6e 67 65 20 6f 66 a wide range of
1a50: 20 63 6f 6d 70 69 6c 65 72 73 2e 0a 2a 2a 0a 2a compilers..**.*
1a60: 2a 20 54 68 65 20 63 6f 72 72 65 63 74 20 22 41 * The correct "A
1a70: 4e 53 49 22 20 77 61 79 20 74 6f 20 64 6f 20 74 NSI" way to do t
1a80: 68 69 73 20 69 73 20 74 6f 20 75 73 65 20 74 68 his is to use th
1a90: 65 20 69 6e 74 70 74 72 5f 74 20 74 79 70 65 2e e intptr_t type.
1aa0: 0a 2a 2a 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c .** Unfortunatel
1ab0: 79 2c 20 74 68 61 74 20 74 79 70 65 64 65 66 20 y, that typedef
1ac0: 69 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 is not available
1ad0: 20 6f 6e 20 61 6c 6c 20 63 6f 6d 70 69 6c 65 72 on all compiler
1ae0: 73 2c 20 6f 72 0a 2a 2a 20 69 66 20 69 74 20 69 s, or.** if it i
1af0: 73 20 61 76 61 69 6c 61 62 6c 65 2c 20 69 74 20 s available, it
1b00: 72 65 71 75 69 72 65 73 20 61 6e 20 23 69 6e 63 requires an #inc
1b10: 6c 75 64 65 20 6f 66 20 73 70 65 63 69 66 69 63 lude of specific
1b20: 20 68 65 61 64 65 72 73 0a 2a 2a 20 74 68 61 74 headers.** that
1b30: 20 76 61 72 79 20 66 72 6f 6d 20 6f 6e 65 20 6d vary from one m
1b40: 61 63 68 69 6e 65 20 74 6f 20 74 68 65 20 6e 65 achine to the ne
1b50: 78 74 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 xt..**.** Ticket
1b60: 20 23 33 38 36 30 3a 20 20 54 68 65 20 6c 6c 76 #3860: The llv
1b70: 6d 2d 67 63 63 2d 34 2e 32 20 63 6f 6d 70 69 6c m-gcc-4.2 compil
1b80: 65 72 20 66 72 6f 6d 20 41 70 70 6c 65 20 63 68 er from Apple ch
1b90: 6f 6b 65 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 28 okes on.** the (
1ba0: 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 (void*)&((char*)
1bb0: 30 29 5b 58 5d 29 20 63 6f 6e 73 74 72 75 63 74 0)[X]) construct
1bc0: 2e 20 20 42 75 74 20 4d 53 56 43 20 63 68 6f 6b . But MSVC chok
1bd0: 65 73 20 6f 6e 20 28 28 76 6f 69 64 2a 29 28 58 es on ((void*)(X
1be0: 29 29 2e 0a 2a 2a 20 53 6f 20 77 65 20 68 61 76 ))..** So we hav
1bf0: 65 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 e to define the
1c00: 6d 61 63 72 6f 73 20 69 6e 20 64 69 66 66 65 72 macros in differ
1c10: 65 6e 74 20 77 61 79 73 20 64 65 70 65 6e 64 69 ent ways dependi
1c20: 6e 67 20 6f 6e 20 74 68 65 0a 2a 2a 20 63 6f 6d ng on the.** com
1c30: 70 69 6c 65 72 2e 0a 2a 2f 0a 23 69 66 20 64 65 piler..*/.#if de
1c40: 66 69 6e 65 64 28 5f 5f 50 54 52 44 49 46 46 5f fined(__PTRDIFF_
1c50: 54 59 50 45 5f 5f 29 20 20 2f 2a 20 54 68 69 73 TYPE__) /* This
1c60: 20 63 61 73 65 20 73 68 6f 75 6c 64 20 77 6f 72 case should wor
1c70: 6b 20 66 6f 72 20 47 43 43 20 2a 2f 0a 23 20 64 k for GCC */.# d
1c80: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 efine SQLITE_INT
1c90: 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f _TO_PTR(X) ((vo
1ca0: 69 64 2a 29 28 5f 5f 50 54 52 44 49 46 46 5f 54 id*)(__PTRDIFF_T
1cb0: 59 50 45 5f 5f 29 28 58 29 29 0a 23 20 64 65 66 YPE__)(X)).# def
1cc0: 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 ine SQLITE_PTR_T
1cd0: 4f 5f 49 4e 54 28 58 29 20 20 28 28 69 6e 74 29 O_INT(X) ((int)
1ce0: 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 50 45 5f (__PTRDIFF_TYPE_
1cf0: 5f 29 28 58 29 29 0a 23 65 6c 69 66 20 21 64 65 _)(X)).#elif !de
1d00: 66 69 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 fined(__GNUC__)
1d10: 20 20 20 20 20 20 2f 2a 20 57 6f 72 6b 73 20 66 /* Works f
1d20: 6f 72 20 63 6f 6d 70 69 6c 65 72 73 20 6f 74 68 or compilers oth
1d30: 65 72 20 74 68 61 6e 20 4c 4c 56 4d 20 2a 2f 0a er than LLVM */.
1d40: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
1d50: 49 4e 54 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 INT_TO_PTR(X) (
1d60: 28 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 (void*)&((char*)
1d70: 30 29 5b 58 5d 29 0a 23 20 64 65 66 69 6e 65 20 0)[X]).# define
1d80: 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e SQLITE_PTR_TO_IN
1d90: 54 28 58 29 20 20 28 28 69 6e 74 29 28 28 28 63 T(X) ((int)(((c
1da0: 68 61 72 2a 29 58 29 2d 28 63 68 61 72 2a 29 30 har*)X)-(char*)0
1db0: 29 29 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 )).#elif defined
1dc0: 28 48 41 56 45 5f 53 54 44 49 4e 54 5f 48 29 20 (HAVE_STDINT_H)
1dd0: 20 20 2f 2a 20 55 73 65 20 74 68 69 73 20 63 61 /* Use this ca
1de0: 73 65 20 69 66 20 77 65 20 68 61 76 65 20 41 4e se if we have AN
1df0: 53 49 20 68 65 61 64 65 72 73 20 2a 2f 0a 23 20 SI headers */.#
1e00: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e define SQLITE_IN
1e10: 54 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 T_TO_PTR(X) ((v
1e20: 6f 69 64 2a 29 28 69 6e 74 70 74 72 5f 74 29 28 oid*)(intptr_t)(
1e30: 58 29 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c X)).# define SQL
1e40: 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 ITE_PTR_TO_INT(X
1e50: 29 20 20 28 28 69 6e 74 29 28 69 6e 74 70 74 72 ) ((int)(intptr
1e60: 5f 74 29 28 58 29 29 0a 23 65 6c 73 65 20 20 20 _t)(X)).#else
1e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e80: 20 20 20 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 /* Genera
1e90: 74 65 73 20 61 20 77 61 72 6e 69 6e 67 20 2d 20 tes a warning -
1ea0: 62 75 74 20 69 74 20 61 6c 77 61 79 73 20 77 6f but it always wo
1eb0: 72 6b 73 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 rks */.# define
1ec0: 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 SQLITE_INT_TO_PT
1ed0: 52 28 58 29 20 20 28 28 76 6f 69 64 2a 29 28 58 R(X) ((void*)(X
1ee0: 29 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 )).# define SQLI
1ef0: 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 TE_PTR_TO_INT(X)
1f00: 20 20 28 28 69 6e 74 29 28 58 29 29 0a 23 65 6e ((int)(X)).#en
1f10: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 20 6d 61 63 dif../*.** A mac
1f20: 72 6f 20 74 6f 20 68 69 6e 74 20 74 6f 20 74 68 ro to hint to th
1f30: 65 20 63 6f 6d 70 69 6c 65 72 20 74 68 61 74 20 e compiler that
1f40: 61 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c a function shoul
1f50: 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 69 6e 6c 69 d not be.** inli
1f60: 6e 65 64 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 ned..*/.#if defi
1f70: 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 0a 23 20 ned(__GNUC__).#
1f80: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e define SQLITE_N
1f90: 4f 49 4e 4c 49 4e 45 20 20 5f 5f 61 74 74 72 69 OINLINE __attri
1fa0: 62 75 74 65 5f 5f 28 28 6e 6f 69 6e 6c 69 6e 65 bute__((noinline
1fb0: 29 29 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 )).#elif defined
1fc0: 28 5f 4d 53 43 5f 56 45 52 29 20 26 26 20 5f 4d (_MSC_VER) && _M
1fd0: 53 43 5f 56 45 52 3e 3d 31 33 31 30 0a 23 20 20 SC_VER>=1310.#
1fe0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f define SQLITE_NO
1ff0: 49 4e 4c 49 4e 45 20 20 5f 5f 64 65 63 6c 73 70 INLINE __declsp
2000: 65 63 28 6e 6f 69 6e 6c 69 6e 65 29 0a 23 65 6c ec(noinline).#el
2010: 73 65 0a 23 20 20 64 65 66 69 6e 65 20 53 51 4c se.# define SQL
2020: 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 0a 23 65 6e ITE_NOINLINE.#en
2030: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 6b 65 20 dif../*.** Make
2040: 73 75 72 65 20 74 68 61 74 20 74 68 65 20 63 6f sure that the co
2050: 6d 70 69 6c 65 72 20 69 6e 74 72 69 6e 73 69 63 mpiler intrinsic
2060: 73 20 77 65 20 64 65 73 69 72 65 20 61 72 65 20 s we desire are
2070: 65 6e 61 62 6c 65 64 20 77 68 65 6e 0a 2a 2a 20 enabled when.**
2080: 63 6f 6d 70 69 6c 69 6e 67 20 77 69 74 68 20 61 compiling with a
2090: 6e 20 61 70 70 72 6f 70 72 69 61 74 65 20 76 65 n appropriate ve
20a0: 72 73 69 6f 6e 20 6f 66 20 4d 53 56 43 20 75 6e rsion of MSVC un
20b0: 6c 65 73 73 20 70 72 65 76 65 6e 74 65 64 20 62 less prevented b
20c0: 79 0a 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f y.** the SQLITE_
20d0: 44 49 53 41 42 4c 45 5f 49 4e 54 52 49 4e 53 49 DISABLE_INTRINSI
20e0: 43 20 64 65 66 69 6e 65 2e 0a 2a 2f 0a 23 69 66 C define..*/.#if
20f0: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
2100: 5f 44 49 53 41 42 4c 45 5f 49 4e 54 52 49 4e 53 _DISABLE_INTRINS
2110: 49 43 29 0a 23 20 20 69 66 20 64 65 66 69 6e 65 IC).# if define
2120: 64 28 5f 4d 53 43 5f 56 45 52 29 20 26 26 20 5f d(_MSC_VER) && _
2130: 4d 53 43 5f 56 45 52 3e 3d 31 34 30 30 0a 23 20 MSC_VER>=1400.#
2140: 20 20 20 69 66 20 21 64 65 66 69 6e 65 64 28 5f if !defined(_
2150: 57 49 4e 33 32 5f 57 43 45 29 0a 23 20 20 20 20 WIN32_WCE).#
2160: 20 20 69 6e 63 6c 75 64 65 20 3c 69 6e 74 72 69 include <intri
2170: 6e 2e 68 3e 0a 23 20 20 20 20 20 20 70 72 61 67 n.h>.# prag
2180: 6d 61 20 69 6e 74 72 69 6e 73 69 63 28 5f 62 79 ma intrinsic(_by
2190: 74 65 73 77 61 70 5f 75 73 68 6f 72 74 29 0a 23 teswap_ushort).#
21a0: 20 20 20 20 20 20 70 72 61 67 6d 61 20 69 6e 74 pragma int
21b0: 72 69 6e 73 69 63 28 5f 62 79 74 65 73 77 61 70 rinsic(_byteswap
21c0: 5f 75 6c 6f 6e 67 29 0a 23 20 20 20 20 20 20 70 _ulong).# p
21d0: 72 61 67 6d 61 20 69 6e 74 72 69 6e 73 69 63 28 ragma intrinsic(
21e0: 5f 52 65 61 64 57 72 69 74 65 42 61 72 72 69 65 _ReadWriteBarrie
21f0: 72 29 0a 23 20 20 20 20 65 6c 73 65 0a 23 20 20 r).# else.#
2200: 20 20 20 20 69 6e 63 6c 75 64 65 20 3c 63 6d 6e include <cmn
2210: 69 6e 74 72 69 6e 2e 68 3e 0a 23 20 20 20 20 65 intrin.h>.# e
2220: 6e 64 69 66 0a 23 20 20 65 6e 64 69 66 0a 23 65 ndif.# endif.#e
2230: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
2240: 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 SQLITE_THREADSAF
2250: 45 20 6d 61 63 72 6f 20 6d 75 73 74 20 62 65 20 E macro must be
2260: 64 65 66 69 6e 65 64 20 61 73 20 30 2c 20 31 2c defined as 0, 1,
2270: 20 6f 72 20 32 2e 0a 2a 2a 20 30 20 6d 65 61 6e or 2..** 0 mean
2280: 73 20 6d 75 74 65 78 65 73 20 61 72 65 20 70 65 s mutexes are pe
2290: 72 6d 61 6e 65 6e 74 6c 79 20 64 69 73 61 62 6c rmanently disabl
22a0: 65 20 61 6e 64 20 74 68 65 20 6c 69 62 72 61 72 e and the librar
22b0: 79 20 69 73 20 6e 65 76 65 72 0a 2a 2a 20 74 68 y is never.** th
22c0: 72 65 61 64 73 61 66 65 2e 20 20 31 20 6d 65 61 readsafe. 1 mea
22d0: 6e 73 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 ns the library i
22e0: 73 20 73 65 72 69 61 6c 69 7a 65 64 20 77 68 69 s serialized whi
22f0: 63 68 20 69 73 20 74 68 65 20 68 69 67 68 65 73 ch is the highes
2300: 74 0a 2a 2a 20 6c 65 76 65 6c 20 6f 66 20 74 68 t.** level of th
2310: 72 65 61 64 73 61 66 65 74 79 2e 20 20 32 20 6d readsafety. 2 m
2320: 65 61 6e 73 20 74 68 65 20 6c 69 62 72 61 72 79 eans the library
2330: 20 69 73 20 6d 75 6c 74 69 74 68 72 65 61 64 65 is multithreade
2340: 64 20 2d 20 6d 75 6c 74 69 70 6c 65 0a 2a 2a 20 d - multiple.**
2350: 74 68 72 65 61 64 73 20 63 61 6e 20 75 73 65 20 threads can use
2360: 53 51 4c 69 74 65 20 61 73 20 6c 6f 6e 67 20 61 SQLite as long a
2370: 73 20 6e 6f 20 74 77 6f 20 74 68 72 65 61 64 73 s no two threads
2380: 20 74 72 79 20 74 6f 20 75 73 65 20 74 68 65 20 try to use the
2390: 73 61 6d 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 same.** database
23a0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 74 20 74 connection at t
23b0: 68 65 20 73 61 6d 65 20 74 69 6d 65 2e 0a 2a 2a he same time..**
23c0: 0a 2a 2a 20 4f 6c 64 65 72 20 76 65 72 73 69 6f .** Older versio
23d0: 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 75 73 65 ns of SQLite use
23e0: 64 20 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 54 48 d an optional TH
23f0: 52 45 41 44 53 41 46 45 20 6d 61 63 72 6f 2e 0a READSAFE macro..
2400: 2a 2a 20 57 65 20 73 75 70 70 6f 72 74 20 74 68 ** We support th
2410: 61 74 20 66 6f 72 20 6c 65 67 61 63 79 2e 0a 2a at for legacy..*
2420: 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 /.#if !defined(S
2430: 51 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 QLITE_THREADSAFE
2440: 29 0a 23 20 69 66 20 64 65 66 69 6e 65 64 28 54 ).# if defined(T
2450: 48 52 45 41 44 53 41 46 45 29 0a 23 20 20 20 64 HREADSAFE).# d
2460: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 48 52 efine SQLITE_THR
2470: 45 41 44 53 41 46 45 20 54 48 52 45 41 44 53 41 EADSAFE THREADSA
2480: 46 45 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 FE.# else.# de
2490: 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 48 52 45 fine SQLITE_THRE
24a0: 41 44 53 41 46 45 20 31 20 2f 2a 20 49 4d 50 3a ADSAFE 1 /* IMP:
24b0: 20 52 2d 30 37 32 37 32 2d 32 32 33 30 39 20 2a R-07272-22309 *
24c0: 2f 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 /.# endif.#endif
24d0: 0a 0a 2f 2a 0a 2a 2a 20 50 6f 77 65 72 73 61 66 ../*.** Powersaf
24e0: 65 20 6f 76 65 72 77 72 69 74 65 20 69 73 20 6f e overwrite is o
24f0: 6e 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 42 n by default. B
2500: 75 74 20 63 61 6e 20 62 65 20 74 75 72 6e 65 64 ut can be turned
2510: 20 6f 66 66 20 75 73 69 6e 67 0a 2a 2a 20 74 68 off using.** th
2520: 65 20 2d 44 53 51 4c 49 54 45 5f 50 4f 57 45 52 e -DSQLITE_POWER
2530: 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 3d 30 SAFE_OVERWRITE=0
2540: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 command-line op
2550: 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 tion..*/.#ifndef
2560: 20 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 SQLITE_POWERSAF
2570: 45 5f 4f 56 45 52 57 52 49 54 45 0a 23 20 64 65 E_OVERWRITE.# de
2580: 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 4f 57 45 fine SQLITE_POWE
2590: 52 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 20 RSAFE_OVERWRITE
25a0: 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 1.#endif../*.**
25b0: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 32 EVIDENCE-OF: R-2
25c0: 35 37 31 35 2d 33 37 30 37 32 20 4d 65 6d 6f 72 5715-37072 Memor
25d0: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 74 61 y allocation sta
25e0: 74 69 73 74 69 63 73 20 61 72 65 20 65 6e 61 62 tistics are enab
25f0: 6c 65 64 20 62 79 0a 2a 2a 20 64 65 66 61 75 6c led by.** defaul
2600: 74 20 75 6e 6c 65 73 73 20 53 51 4c 69 74 65 20 t unless SQLite
2610: 69 73 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 is compiled with
2620: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
2630: 4d 45 4d 53 54 41 54 55 53 3d 30 20 69 6e 0a 2a MEMSTATUS=0 in.*
2640: 2a 20 77 68 69 63 68 20 63 61 73 65 20 6d 65 6d * which case mem
2650: 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 73 ory allocation s
2660: 74 61 74 69 73 74 69 63 73 20 61 72 65 20 64 69 tatistics are di
2670: 73 61 62 6c 65 64 20 62 79 20 64 65 66 61 75 6c sabled by defaul
2680: 74 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e t..*/.#if !defin
2690: 65 64 28 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ed(SQLITE_DEFAUL
26a0: 54 5f 4d 45 4d 53 54 41 54 55 53 29 0a 23 20 64 T_MEMSTATUS).# d
26b0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 efine SQLITE_DEF
26c0: 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 20 31 AULT_MEMSTATUS 1
26d0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 .#endif../*.** E
26e0: 78 61 63 74 6c 79 20 6f 6e 65 20 6f 66 20 74 68 xactly one of th
26f0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 e following macr
2700: 6f 73 20 6d 75 73 74 20 62 65 20 64 65 66 69 6e os must be defin
2710: 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a ed in order to.*
2720: 2a 20 73 70 65 63 69 66 79 20 77 68 69 63 68 20 * specify which
2730: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
2740: 6e 20 73 75 62 73 79 73 74 65 6d 20 74 6f 20 75 n subsystem to u
2750: 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 se..**.** SQ
2760: 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c LITE_SYSTEM_MALL
2770: 4f 43 20 20 20 20 20 20 20 20 20 20 2f 2f 20 55 OC // U
2780: 73 65 20 6e 6f 72 6d 61 6c 20 73 79 73 74 65 6d se normal system
2790: 20 6d 61 6c 6c 6f 63 28 29 0a 2a 2a 20 20 20 20 malloc().**
27a0: 20 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 SQLITE_WIN32_MA
27b0: 4c 4c 4f 43 20 20 20 20 20 20 20 20 20 20 20 2f LLOC /
27c0: 2f 20 55 73 65 20 57 69 6e 33 32 20 6e 61 74 69 / Use Win32 nati
27d0: 76 65 20 68 65 61 70 20 41 50 49 0a 2a 2a 20 20 ve heap API.**
27e0: 20 20 20 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d SQLITE_ZERO_M
27f0: 41 4c 4c 4f 43 20 20 20 20 20 20 20 20 20 20 20 ALLOC
2800: 20 2f 2f 20 55 73 65 20 61 20 73 74 75 62 20 61 // Use a stub a
2810: 6c 6c 6f 63 61 74 6f 72 20 74 68 61 74 20 61 6c llocator that al
2820: 77 61 79 73 20 66 61 69 6c 73 0a 2a 2a 20 20 20 ways fails.**
2830: 20 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 SQLITE_MEMDEBU
2840: 47 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 G
2850: 2f 2f 20 44 65 62 75 67 67 69 6e 67 20 76 65 72 // Debugging ver
2860: 73 69 6f 6e 20 6f 66 20 73 79 73 74 65 6d 20 6d sion of system m
2870: 61 6c 6c 6f 63 28 29 0a 2a 2a 0a 2a 2a 20 4f 6e alloc().**.** On
2880: 20 57 69 6e 64 6f 77 73 2c 20 69 66 20 74 68 65 Windows, if the
2890: 20 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 SQLITE_WIN32_MA
28a0: 4c 4c 4f 43 5f 56 41 4c 49 44 41 54 45 20 6d 61 LLOC_VALIDATE ma
28b0: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 20 61 cro is defined a
28c0: 6e 64 20 74 68 65 0a 2a 2a 20 61 73 73 65 72 74 nd the.** assert
28d0: 28 29 20 6d 61 63 72 6f 20 69 73 20 65 6e 61 62 () macro is enab
28e0: 6c 65 64 2c 20 65 61 63 68 20 63 61 6c 6c 20 69 led, each call i
28f0: 6e 74 6f 20 74 68 65 20 57 69 6e 33 32 20 6e 61 nto the Win32 na
2900: 74 69 76 65 20 68 65 61 70 20 73 75 62 73 79 73 tive heap subsys
2910: 74 65 6d 0a 2a 2a 20 77 69 6c 6c 20 63 61 75 73 tem.** will caus
2920: 65 20 48 65 61 70 56 61 6c 69 64 61 74 65 20 74 e HeapValidate t
2930: 6f 20 62 65 20 63 61 6c 6c 65 64 2e 20 20 49 66 o be called. If
2940: 20 68 65 61 70 20 76 61 6c 69 64 61 74 69 6f 6e heap validation
2950: 20 73 68 6f 75 6c 64 20 66 61 69 6c 2c 20 61 6e should fail, an
2960: 0a 2a 2a 20 61 73 73 65 72 74 69 6f 6e 20 77 69 .** assertion wi
2970: 6c 6c 20 62 65 20 74 72 69 67 67 65 72 65 64 2e ll be triggered.
2980: 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 6e 65 20 6f .**.** If none o
2990: 66 20 74 68 65 20 61 62 6f 76 65 20 61 72 65 20 f the above are
29a0: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 73 65 defined, then se
29b0: 74 20 53 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f t SQLITE_SYSTEM_
29c0: 4d 41 4c 4c 4f 43 20 61 73 0a 2a 2a 20 74 68 65 MALLOC as.** the
29d0: 20 64 65 66 61 75 6c 74 2e 0a 2a 2f 0a 23 69 66 default..*/.#if
29e0: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
29f0: 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 29 20 5c SYSTEM_MALLOC) \
2a00: 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c . + defined(SQL
2a10: 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 ITE_WIN32_MALLOC
2a20: 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 ) \. + defined(
2a30: 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c SQLITE_ZERO_MALL
2a40: 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 OC) \. + define
2a50: 64 28 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 d(SQLITE_MEMDEBU
2a60: 47 29 3e 31 0a 23 20 65 72 72 6f 72 20 22 54 77 G)>1.# error "Tw
2a70: 6f 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 o or more of the
2a80: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 70 69 following compi
2a90: 6c 65 2d 74 69 6d 65 20 63 6f 6e 66 69 67 75 72 le-time configur
2aa0: 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 5c 0a 20 ation options\.
2ab0: 61 72 65 20 64 65 66 69 6e 65 64 20 62 75 74 20 are defined but
2ac0: 61 74 20 6d 6f 73 74 20 6f 6e 65 20 69 73 20 61 at most one is a
2ad0: 6c 6c 6f 77 65 64 3a 5c 0a 20 53 51 4c 49 54 45 llowed:\. SQLITE
2ae0: 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 2c 20 _SYSTEM_MALLOC,
2af0: 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c SQLITE_WIN32_MAL
2b00: 4c 4f 43 2c 20 53 51 4c 49 54 45 5f 4d 45 4d 44 LOC, SQLITE_MEMD
2b10: 45 42 55 47 2c 5c 0a 20 53 51 4c 49 54 45 5f 5a EBUG,\. SQLITE_Z
2b20: 45 52 4f 5f 4d 41 4c 4c 4f 43 22 0a 23 65 6e 64 ERO_MALLOC".#end
2b30: 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
2b40: 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c QLITE_SYSTEM_MAL
2b50: 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e LOC) \. + defin
2b60: 65 64 28 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f ed(SQLITE_WIN32_
2b70: 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 MALLOC) \. + de
2b80: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 5a 45 52 fined(SQLITE_ZER
2b90: 4f 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 O_MALLOC) \. +
2ba0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d defined(SQLITE_M
2bb0: 45 4d 44 45 42 55 47 29 3d 3d 30 0a 23 20 64 65 EMDEBUG)==0.# de
2bc0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 59 53 54 fine SQLITE_SYST
2bd0: 45 4d 5f 4d 41 4c 4c 4f 43 20 31 0a 23 65 6e 64 EM_MALLOC 1.#end
2be0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 53 51 4c if../*.** If SQL
2bf0: 49 54 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f ITE_MALLOC_SOFT_
2c00: 4c 49 4d 49 54 20 69 73 20 6e 6f 74 20 7a 65 72 LIMIT is not zer
2c10: 6f 2c 20 74 68 65 6e 20 74 72 79 20 74 6f 20 6b o, then try to k
2c20: 65 65 70 20 74 68 65 0a 2a 2a 20 73 69 7a 65 73 eep the.** sizes
2c30: 20 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 of memory alloc
2c40: 61 74 69 6f 6e 73 20 62 65 6c 6f 77 20 74 68 69 ations below thi
2c50: 73 20 76 61 6c 75 65 20 77 68 65 72 65 20 70 6f s value where po
2c60: 73 73 69 62 6c 65 2e 0a 2a 2f 0a 23 69 66 20 21 ssible..*/.#if !
2c70: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d defined(SQLITE_M
2c80: 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 ALLOC_SOFT_LIMIT
2c90: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
2ca0: 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 E_MALLOC_SOFT_LI
2cb0: 4d 49 54 20 31 30 32 34 0a 23 65 6e 64 69 66 0a MIT 1024.#endif.
2cc0: 0a 2f 2a 0a 2a 2a 20 57 65 20 6e 65 65 64 20 74 ./*.** We need t
2cd0: 6f 20 64 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f o define _XOPEN_
2ce0: 53 4f 55 52 43 45 20 61 73 20 66 6f 6c 6c 6f 77 SOURCE as follow
2cf0: 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e s in order to en
2d00: 61 62 6c 65 0a 2a 2a 20 72 65 63 75 72 73 69 76 able.** recursiv
2d10: 65 20 6d 75 74 65 78 65 73 20 6f 6e 20 6d 6f 73 e mutexes on mos
2d20: 74 20 55 6e 69 78 20 73 79 73 74 65 6d 73 20 61 t Unix systems a
2d30: 6e 64 20 66 63 68 6d 6f 64 28 29 20 6f 6e 20 4f nd fchmod() on O
2d40: 70 65 6e 42 53 44 2e 0a 2a 2a 20 42 75 74 20 5f penBSD..** But _
2d50: 58 4f 50 45 4e 5f 53 4f 55 52 43 45 20 64 65 66 XOPEN_SOURCE def
2d60: 69 6e 65 20 63 61 75 73 65 73 20 70 72 6f 62 6c ine causes probl
2d70: 65 6d 73 20 66 6f 72 20 4d 61 63 20 4f 53 20 58 ems for Mac OS X
2d80: 2c 20 73 6f 20 6f 6d 69 74 0a 2a 2a 20 69 74 2e , so omit.** it.
2d90: 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 .*/.#if !defined
2da0: 28 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 45 29 20 (_XOPEN_SOURCE)
2db0: 26 26 20 21 64 65 66 69 6e 65 64 28 5f 5f 44 41 && !defined(__DA
2dc0: 52 57 49 4e 5f 5f 29 20 26 26 20 21 64 65 66 69 RWIN__) && !defi
2dd0: 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 23 ned(__APPLE__).#
2de0: 20 20 64 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f define _XOPEN_
2df0: 53 4f 55 52 43 45 20 36 30 30 0a 23 65 6e 64 69 SOURCE 600.#endi
2e00: 66 0a 0a 2f 2a 0a 2a 2a 20 4e 44 45 42 55 47 20 f../*.** NDEBUG
2e10: 61 6e 64 20 53 51 4c 49 54 45 5f 44 45 42 55 47 and SQLITE_DEBUG
2e20: 20 61 72 65 20 6f 70 70 6f 73 69 74 65 73 2e 20 are opposites.
2e30: 20 49 74 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 It should alway
2e40: 73 20 62 65 20 74 72 75 65 20 74 68 61 74 0a 2a s be true that.*
2e50: 2a 20 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 * defined(NDEBUG
2e60: 29 3d 3d 21 64 65 66 69 6e 65 64 28 53 51 4c 49 )==!defined(SQLI
2e70: 54 45 5f 44 45 42 55 47 29 2e 20 20 49 66 20 74 TE_DEBUG). If t
2e80: 68 69 73 20 69 73 20 6e 6f 74 20 63 75 72 72 65 his is not curre
2e90: 6e 74 6c 79 20 74 72 75 65 2c 0a 2a 2a 20 6d 61 ntly true,.** ma
2ea0: 6b 65 20 69 74 20 74 72 75 65 20 62 79 20 64 65 ke it true by de
2eb0: 66 69 6e 69 6e 67 20 6f 72 20 75 6e 64 65 66 69 fining or undefi
2ec0: 6e 69 6e 67 20 4e 44 45 42 55 47 2e 0a 2a 2a 0a ning NDEBUG..**.
2ed0: 2a 2a 20 53 65 74 74 69 6e 67 20 4e 44 45 42 55 ** Setting NDEBU
2ee0: 47 20 6d 61 6b 65 73 20 74 68 65 20 63 6f 64 65 G makes the code
2ef0: 20 73 6d 61 6c 6c 65 72 20 61 6e 64 20 66 61 73 smaller and fas
2f00: 74 65 72 20 62 79 20 64 69 73 61 62 6c 69 6e 67 ter by disabling
2f10: 20 74 68 65 0a 2a 2a 20 61 73 73 65 72 74 28 29 the.** assert()
2f20: 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 statements in t
2f30: 68 65 20 63 6f 64 65 2e 20 20 53 6f 20 77 65 20 he code. So we
2f40: 77 61 6e 74 20 74 68 65 20 64 65 66 61 75 6c 74 want the default
2f50: 20 61 63 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 action.** to be
2f60: 20 66 6f 72 20 4e 44 45 42 55 47 20 74 6f 20 62 for NDEBUG to b
2f70: 65 20 73 65 74 20 61 6e 64 20 4e 44 45 42 55 47 e set and NDEBUG
2f80: 20 74 6f 20 62 65 20 75 6e 64 65 66 69 6e 65 64 to be undefined
2f90: 20 6f 6e 6c 79 20 69 66 20 53 51 4c 49 54 45 5f only if SQLITE_
2fa0: 44 45 42 55 47 0a 2a 2a 20 69 73 20 73 65 74 2e DEBUG.** is set.
2fb0: 20 20 54 68 75 73 20 4e 44 45 42 55 47 20 62 65 Thus NDEBUG be
2fc0: 63 6f 6d 65 73 20 61 6e 20 6f 70 74 2d 69 6e 20 comes an opt-in
2fd0: 72 61 74 68 65 72 20 74 68 61 6e 20 61 6e 20 6f rather than an o
2fe0: 70 74 2d 6f 75 74 0a 2a 2a 20 66 65 61 74 75 72 pt-out.** featur
2ff0: 65 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e e..*/.#if !defin
3000: 65 64 28 4e 44 45 42 55 47 29 20 26 26 20 21 64 ed(NDEBUG) && !d
3010: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
3020: 42 55 47 29 0a 23 20 64 65 66 69 6e 65 20 4e 44 BUG).# define ND
3030: 45 42 55 47 20 31 0a 23 65 6e 64 69 66 0a 23 69 EBUG 1.#endif.#i
3040: 66 20 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 f defined(NDEBUG
3050: 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c ) && defined(SQL
3060: 49 54 45 5f 44 45 42 55 47 29 0a 23 20 75 6e 64 ITE_DEBUG).# und
3070: 65 66 20 4e 44 45 42 55 47 0a 23 65 6e 64 69 66 ef NDEBUG.#endif
3080: 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 53 ../*.** Enable S
3090: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 QLITE_ENABLE_EXP
30a0: 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 20 69 66 LAIN_COMMENTS if
30b0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 69 73 SQLITE_DEBUG is
30c0: 20 74 75 72 6e 65 64 20 6f 6e 2e 0a 2a 2f 0a 23 turned on..*/.#
30d0: 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
30e0: 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 TE_ENABLE_EXPLAI
30f0: 4e 5f 43 4f 4d 4d 45 4e 54 53 29 20 26 26 20 64 N_COMMENTS) && d
3100: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
3110: 42 55 47 29 0a 23 20 64 65 66 69 6e 65 20 53 51 BUG).# define SQ
3120: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c LITE_ENABLE_EXPL
3130: 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 20 31 0a 23 AIN_COMMENTS 1.#
3140: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 endif../*.** The
3150: 20 74 65 73 74 63 61 73 65 28 29 20 6d 61 63 72 testcase() macr
3160: 6f 20 69 73 20 75 73 65 64 20 74 6f 20 61 69 64 o is used to aid
3170: 20 69 6e 20 63 6f 76 65 72 61 67 65 20 74 65 73 in coverage tes
3180: 74 69 6e 67 2e 20 20 57 68 65 6e 0a 2a 2a 20 64 ting. When.** d
3190: 6f 69 6e 67 20 63 6f 76 65 72 61 67 65 20 74 65 oing coverage te
31a0: 73 74 69 6e 67 2c 20 74 68 65 20 63 6f 6e 64 69 sting, the condi
31b0: 74 69 6f 6e 20 69 6e 73 69 64 65 20 74 68 65 20 tion inside the
31c0: 61 72 67 75 6d 65 6e 74 20 74 6f 0a 2a 2a 20 74 argument to.** t
31d0: 65 73 74 63 61 73 65 28 29 20 6d 75 73 74 20 62 estcase() must b
31e0: 65 20 65 76 61 6c 75 61 74 65 64 20 62 6f 74 68 e evaluated both
31f0: 20 74 72 75 65 20 61 6e 64 20 66 61 6c 73 65 20 true and false
3200: 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 67 in order to.** g
3210: 65 74 20 66 75 6c 6c 20 62 72 61 6e 63 68 20 63 et full branch c
3220: 6f 76 65 72 61 67 65 2e 20 20 54 68 65 20 74 65 overage. The te
3230: 73 74 63 61 73 65 28 29 20 6d 61 63 72 6f 20 69 stcase() macro i
3240: 73 20 69 6e 73 65 72 74 65 64 0a 2a 2a 20 74 6f s inserted.** to
3250: 20 68 65 6c 70 20 65 6e 73 75 72 65 20 61 64 65 help ensure ade
3260: 71 75 61 74 65 20 74 65 73 74 20 63 6f 76 65 72 quate test cover
3270: 61 67 65 20 69 6e 20 70 6c 61 63 65 73 20 77 68 age in places wh
3280: 65 72 65 20 73 69 6d 70 6c 65 0a 2a 2a 20 63 6f ere simple.** co
3290: 6e 64 69 74 69 6f 6e 2f 64 65 63 69 73 69 6f 6e ndition/decision
32a0: 20 63 6f 76 65 72 61 67 65 20 69 73 20 69 6e 61 coverage is ina
32b0: 64 65 71 75 61 74 65 2e 20 20 46 6f 72 20 65 78 dequate. For ex
32c0: 61 6d 70 6c 65 2c 20 74 65 73 74 63 61 73 65 28 ample, testcase(
32d0: 29 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 65 64 ).** can be used
32e0: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 62 6f to make sure bo
32f0: 75 6e 64 61 72 79 20 76 61 6c 75 65 73 20 61 72 undary values ar
3300: 65 20 74 65 73 74 65 64 2e 20 20 46 6f 72 0a 2a e tested. For.*
3310: 2a 20 62 69 74 6d 61 73 6b 20 74 65 73 74 73 2c * bitmask tests,
3320: 20 74 65 73 74 63 61 73 65 28 29 20 63 61 6e 20 testcase() can
3330: 62 65 20 75 73 65 64 20 74 6f 20 6d 61 6b 65 20 be used to make
3340: 73 75 72 65 20 65 61 63 68 20 62 69 74 0a 2a 2a sure each bit.**
3350: 20 69 73 20 73 69 67 6e 69 66 69 63 61 6e 74 20 is significant
3360: 61 6e 64 20 75 73 65 64 20 61 74 20 6c 65 61 73 and used at leas
3370: 74 20 6f 6e 63 65 2e 20 20 4f 6e 20 73 77 69 74 t once. On swit
3380: 63 68 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a ch statements.**
3390: 20 77 68 65 72 65 20 6d 75 6c 74 69 70 6c 65 20 where multiple
33a0: 63 61 73 65 73 20 67 6f 20 74 6f 20 74 68 65 20 cases go to the
33b0: 73 61 6d 65 20 62 6c 6f 63 6b 20 6f 66 20 63 6f same block of co
33c0: 64 65 2c 20 74 65 73 74 63 61 73 65 28 29 0a 2a de, testcase().*
33d0: 2a 20 63 61 6e 20 69 6e 73 75 72 65 20 74 68 61 * can insure tha
33e0: 74 20 61 6c 6c 20 63 61 73 65 73 20 61 72 65 20 t all cases are
33f0: 65 76 61 6c 75 61 74 65 64 2e 0a 2a 2a 0a 2a 2f evaluated..**.*/
3400: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 43 .#ifdef SQLITE_C
3410: 4f 56 45 52 41 47 45 5f 54 45 53 54 0a 20 20 76 OVERAGE_TEST. v
3420: 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 76 65 72 oid sqlite3Cover
3430: 61 67 65 28 69 6e 74 29 3b 0a 23 20 64 65 66 69 age(int);.# defi
3440: 6e 65 20 74 65 73 74 63 61 73 65 28 58 29 20 20 ne testcase(X)
3450: 69 66 28 20 58 20 29 7b 20 73 71 6c 69 74 65 33 if( X ){ sqlite3
3460: 43 6f 76 65 72 61 67 65 28 5f 5f 4c 49 4e 45 5f Coverage(__LINE_
3470: 5f 29 3b 20 7d 0a 23 65 6c 73 65 0a 23 20 64 65 _); }.#else.# de
3480: 66 69 6e 65 20 74 65 73 74 63 61 73 65 28 58 29 fine testcase(X)
3490: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
34a0: 68 65 20 54 45 53 54 4f 4e 4c 59 20 6d 61 63 72 he TESTONLY macr
34b0: 6f 20 69 73 20 75 73 65 64 20 74 6f 20 65 6e 63 o is used to enc
34c0: 6c 6f 73 65 20 76 61 72 69 61 62 6c 65 20 64 65 lose variable de
34d0: 63 6c 61 72 61 74 69 6f 6e 73 20 6f 72 0a 2a 2a clarations or.**
34e0: 20 6f 74 68 65 72 20 62 69 74 73 20 6f 66 20 63 other bits of c
34f0: 6f 64 65 20 74 68 61 74 20 61 72 65 20 6e 65 65 ode that are nee
3500: 64 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20 74 ded to support t
3510: 68 65 20 61 72 67 75 6d 65 6e 74 73 0a 2a 2a 20 he arguments.**
3520: 77 69 74 68 69 6e 20 74 65 73 74 63 61 73 65 28 within testcase(
3530: 29 20 61 6e 64 20 61 73 73 65 72 74 28 29 20 6d ) and assert() m
3540: 61 63 72 6f 73 2e 0a 2a 2f 0a 23 69 66 20 21 64 acros..*/.#if !d
3550: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 20 7c efined(NDEBUG) |
3560: 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 | defined(SQLITE
3570: 5f 43 4f 56 45 52 41 47 45 5f 54 45 53 54 29 0a _COVERAGE_TEST).
3580: 23 20 64 65 66 69 6e 65 20 54 45 53 54 4f 4e 4c # define TESTONL
3590: 59 28 58 29 20 20 58 0a 23 65 6c 73 65 0a 23 20 Y(X) X.#else.#
35a0: 64 65 66 69 6e 65 20 54 45 53 54 4f 4e 4c 59 28 define TESTONLY(
35b0: 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a X).#endif../*.**
35c0: 20 53 6f 6d 65 74 69 6d 65 73 20 77 65 20 6e 65 Sometimes we ne
35d0: 65 64 20 61 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e ed a small amoun
35e0: 74 20 6f 66 20 63 6f 64 65 20 73 75 63 68 20 61 t of code such a
35f0: 73 20 61 20 76 61 72 69 61 62 6c 65 20 69 6e 69 s a variable ini
3600: 74 69 61 6c 69 7a 61 74 69 6f 6e 0a 2a 2a 20 74 tialization.** t
3610: 6f 20 73 65 74 75 70 20 66 6f 72 20 61 20 6c 61 o setup for a la
3620: 74 65 72 20 61 73 73 65 72 74 28 29 20 73 74 61 ter assert() sta
3630: 74 65 6d 65 6e 74 2e 20 20 57 65 20 64 6f 20 6e tement. We do n
3640: 6f 74 20 77 61 6e 74 20 74 68 69 73 20 63 6f 64 ot want this cod
3650: 65 20 74 6f 0a 2a 2a 20 61 70 70 65 61 72 20 77 e to.** appear w
3660: 68 65 6e 20 61 73 73 65 72 74 28 29 20 69 73 20 hen assert() is
3670: 64 69 73 61 62 6c 65 64 2e 20 20 54 68 65 20 66 disabled. The f
3680: 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 69 ollowing macro i
3690: 73 20 74 68 65 72 65 66 6f 72 65 0a 2a 2a 20 75 s therefore.** u
36a0: 73 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e 20 74 sed to contain t
36b0: 68 61 74 20 73 65 74 75 70 20 63 6f 64 65 2e 20 hat setup code.
36c0: 20 54 68 65 20 22 56 56 41 22 20 61 63 72 6f 6e The "VVA" acron
36d0: 79 6d 20 73 74 61 6e 64 73 20 66 6f 72 0a 2a 2a ym stands for.**
36e0: 20 22 56 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 "Verification,
36f0: 56 61 6c 69 64 61 74 69 6f 6e 2c 20 61 6e 64 20 Validation, and
3700: 41 63 63 72 65 64 69 74 61 74 69 6f 6e 22 2e 20 Accreditation".
3710: 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c In other words,
3720: 20 74 68 65 0a 2a 2a 20 63 6f 64 65 20 77 69 74 the.** code wit
3730: 68 69 6e 20 56 56 41 5f 4f 4e 4c 59 28 29 20 77 hin VVA_ONLY() w
3740: 69 6c 6c 20 6f 6e 6c 79 20 72 75 6e 20 64 75 72 ill only run dur
3750: 69 6e 67 20 76 65 72 69 66 69 63 61 74 69 6f 6e ing verification
3760: 20 70 72 6f 63 65 73 73 65 73 2e 0a 2a 2f 0a 23 processes..*/.#
3770: 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 23 20 ifndef NDEBUG.#
3780: 64 65 66 69 6e 65 20 56 56 41 5f 4f 4e 4c 59 28 define VVA_ONLY(
3790: 58 29 20 20 58 0a 23 65 6c 73 65 0a 23 20 64 65 X) X.#else.# de
37a0: 66 69 6e 65 20 56 56 41 5f 4f 4e 4c 59 28 58 29 fine VVA_ONLY(X)
37b0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
37c0: 68 65 20 41 4c 57 41 59 53 20 61 6e 64 20 4e 45 he ALWAYS and NE
37d0: 56 45 52 20 6d 61 63 72 6f 73 20 73 75 72 72 6f VER macros surro
37e0: 75 6e 64 20 62 6f 6f 6c 65 61 6e 20 65 78 70 72 und boolean expr
37f0: 65 73 73 69 6f 6e 73 20 77 68 69 63 68 0a 2a 2a essions which.**
3800: 20 61 72 65 20 69 6e 74 65 6e 64 65 64 20 74 6f are intended to
3810: 20 61 6c 77 61 79 73 20 62 65 20 74 72 75 65 20 always be true
3820: 6f 72 20 66 61 6c 73 65 2c 20 72 65 73 70 65 63 or false, respec
3830: 74 69 76 65 6c 79 2e 20 20 53 75 63 68 0a 2a 2a tively. Such.**
3840: 20 65 78 70 72 65 73 73 69 6f 6e 73 20 63 6f 75 expressions cou
3850: 6c 64 20 62 65 20 6f 6d 69 74 74 65 64 20 66 72 ld be omitted fr
3860: 6f 6d 20 74 68 65 20 63 6f 64 65 20 63 6f 6d 70 om the code comp
3870: 6c 65 74 65 6c 79 2e 20 20 42 75 74 20 74 68 65 letely. But the
3880: 79 0a 2a 2a 20 61 72 65 20 69 6e 63 6c 75 64 65 y.** are include
3890: 64 20 69 6e 20 61 20 66 65 77 20 63 61 73 65 73 d in a few cases
38a0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 68 in order to enh
38b0: 61 6e 63 65 20 74 68 65 20 72 65 73 69 6c 69 65 ance the resilie
38c0: 6e 63 65 0a 2a 2a 20 6f 66 20 53 51 4c 69 74 65 nce.** of SQLite
38d0: 20 74 6f 20 75 6e 65 78 70 65 63 74 65 64 20 62 to unexpected b
38e0: 65 68 61 76 69 6f 72 20 2d 20 74 6f 20 6d 61 6b ehavior - to mak
38f0: 65 20 74 68 65 20 63 6f 64 65 20 22 73 65 6c 66 e the code "self
3900: 2d 68 65 61 6c 69 6e 67 22 0a 2a 2a 20 6f 72 20 -healing".** or
3910: 22 64 75 63 74 69 6c 65 22 20 72 61 74 68 65 72 "ductile" rather
3920: 20 74 68 61 6e 20 62 65 69 6e 67 20 22 62 72 69 than being "bri
3930: 74 74 6c 65 22 20 61 6e 64 20 63 72 61 73 68 69 ttle" and crashi
3940: 6e 67 20 61 74 20 74 68 65 20 66 69 72 73 74 0a ng at the first.
3950: 2a 2a 20 68 69 6e 74 20 6f 66 20 75 6e 70 6c 61 ** hint of unpla
3960: 6e 6e 65 64 20 62 65 68 61 76 69 6f 72 2e 0a 2a nned behavior..*
3970: 2a 0a 2a 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f *.** In other wo
3980: 72 64 73 2c 20 41 4c 57 41 59 53 20 61 6e 64 20 rds, ALWAYS and
3990: 4e 45 56 45 52 20 61 72 65 20 61 64 64 65 64 20 NEVER are added
39a0: 66 6f 72 20 64 65 66 65 6e 73 69 76 65 20 63 6f for defensive co
39b0: 64 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 64 de..**.** When d
39c0: 6f 69 6e 67 20 63 6f 76 65 72 61 67 65 20 74 65 oing coverage te
39d0: 73 74 69 6e 67 20 41 4c 57 41 59 53 20 61 6e 64 sting ALWAYS and
39e0: 20 4e 45 56 45 52 20 61 72 65 20 68 61 72 64 2d NEVER are hard-
39f0: 63 6f 64 65 64 20 74 6f 0a 2a 2a 20 62 65 20 74 coded to.** be t
3a00: 72 75 65 20 61 6e 64 20 66 61 6c 73 65 20 73 6f rue and false so
3a10: 20 74 68 61 74 20 74 68 65 20 75 6e 72 65 61 63 that the unreac
3a20: 68 61 62 6c 65 20 63 6f 64 65 20 74 68 65 79 20 hable code they
3a30: 73 70 65 63 69 66 79 20 77 69 6c 6c 0a 2a 2a 20 specify will.**
3a40: 6e 6f 74 20 62 65 20 63 6f 75 6e 74 65 64 20 61 not be counted a
3a50: 73 20 75 6e 74 65 73 74 65 64 20 63 6f 64 65 2e s untested code.
3a60: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
3a70: 53 51 4c 49 54 45 5f 43 4f 56 45 52 41 47 45 5f SQLITE_COVERAGE_
3a80: 54 45 53 54 29 20 7c 7c 20 64 65 66 69 6e 65 64 TEST) || defined
3a90: 28 53 51 4c 49 54 45 5f 4d 55 54 41 54 49 4f 4e (SQLITE_MUTATION
3aa0: 5f 54 45 53 54 29 0a 23 20 64 65 66 69 6e 65 20 _TEST).# define
3ab0: 41 4c 57 41 59 53 28 58 29 20 20 20 20 20 20 28 ALWAYS(X) (
3ac0: 31 29 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 45 1).# define NEVE
3ad0: 52 28 58 29 20 20 20 20 20 20 20 28 30 29 0a 23 R(X) (0).#
3ae0: 65 6c 69 66 20 21 64 65 66 69 6e 65 64 28 4e 44 elif !defined(ND
3af0: 45 42 55 47 29 0a 23 20 64 65 66 69 6e 65 20 41 EBUG).# define A
3b00: 4c 57 41 59 53 28 58 29 20 20 20 20 20 20 28 28 LWAYS(X) ((
3b10: 58 29 3f 31 3a 28 61 73 73 65 72 74 28 30 29 2c X)?1:(assert(0),
3b20: 30 29 29 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 0)).# define NEV
3b30: 45 52 28 58 29 20 20 20 20 20 20 20 28 28 58 29 ER(X) ((X)
3b40: 3f 28 61 73 73 65 72 74 28 30 29 2c 31 29 3a 30 ?(assert(0),1):0
3b50: 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ).#else.# define
3b60: 20 41 4c 57 41 59 53 28 58 29 20 20 20 20 20 20 ALWAYS(X)
3b70: 28 58 29 0a 23 20 64 65 66 69 6e 65 20 4e 45 56 (X).# define NEV
3b80: 45 52 28 58 29 20 20 20 20 20 20 20 28 58 29 0a ER(X) (X).
3b90: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 6f #endif../*.** So
3ba0: 6d 65 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 me malloc failur
3bb0: 65 73 20 61 72 65 20 6f 6e 6c 79 20 70 6f 73 73 es are only poss
3bc0: 69 62 6c 65 20 69 66 20 53 51 4c 49 54 45 5f 54 ible if SQLITE_T
3bd0: 45 53 54 5f 52 45 41 4c 4c 4f 43 5f 53 54 52 45 EST_REALLOC_STRE
3be0: 53 53 20 69 73 0a 2a 2a 20 64 65 66 69 6e 65 64 SS is.** defined
3bf0: 2e 20 20 57 65 20 6e 65 65 64 20 74 6f 20 64 65 . We need to de
3c00: 66 65 6e 64 20 61 67 61 69 6e 73 74 20 74 68 6f fend against tho
3c10: 73 65 20 66 61 69 6c 75 72 65 73 20 77 68 65 6e se failures when
3c20: 20 74 65 73 74 69 6e 67 20 77 69 74 68 0a 2a 2a testing with.**
3c30: 20 53 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 SQLITE_TEST_REA
3c40: 4c 4c 4f 43 5f 53 54 52 45 53 53 2c 20 62 75 74 LLOC_STRESS, but
3c50: 20 77 65 20 64 6f 6e 27 74 20 77 61 6e 74 20 74 we don't want t
3c60: 68 65 20 75 6e 72 65 61 63 68 61 62 6c 65 20 62 he unreachable b
3c70: 72 61 6e 63 68 65 73 0a 2a 2a 20 64 75 72 69 6e ranches.** durin
3c80: 67 20 61 20 6e 6f 72 6d 61 6c 20 62 75 69 6c 64 g a normal build
3c90: 2e 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 . The following
3ca0: 20 6d 61 63 72 6f 20 63 61 6e 20 62 65 20 75 73 macro can be us
3cb0: 65 64 20 74 6f 20 64 69 73 61 62 6c 65 20 74 65 ed to disable te
3cc0: 73 74 73 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 sts.** that are
3cd0: 61 6c 77 61 79 73 20 66 61 6c 73 65 20 65 78 63 always false exc
3ce0: 65 70 74 20 77 68 65 6e 20 53 51 4c 49 54 45 5f ept when SQLITE_
3cf0: 54 45 53 54 5f 52 45 41 4c 4c 4f 43 5f 53 54 52 TEST_REALLOC_STR
3d00: 45 53 53 20 69 73 20 73 65 74 2e 0a 2a 2f 0a 23 ESS is set..*/.#
3d10: 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
3d20: 45 5f 54 45 53 54 5f 52 45 41 4c 4c 4f 43 5f 53 E_TEST_REALLOC_S
3d30: 54 52 45 53 53 29 0a 23 20 64 65 66 69 6e 65 20 TRESS).# define
3d40: 4f 4e 4c 59 5f 49 46 5f 52 45 41 4c 4c 4f 43 5f ONLY_IF_REALLOC_
3d50: 53 54 52 45 53 53 28 58 29 20 20 28 58 29 0a 23 STRESS(X) (X).#
3d60: 65 6c 69 66 20 21 64 65 66 69 6e 65 64 28 4e 44 elif !defined(ND
3d70: 45 42 55 47 29 0a 23 20 64 65 66 69 6e 65 20 4f EBUG).# define O
3d80: 4e 4c 59 5f 49 46 5f 52 45 41 4c 4c 4f 43 5f 53 NLY_IF_REALLOC_S
3d90: 54 52 45 53 53 28 58 29 20 20 28 28 58 29 3f 28 TRESS(X) ((X)?(
3da0: 61 73 73 65 72 74 28 30 29 2c 31 29 3a 30 29 0a assert(0),1):0).
3db0: 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 4f #else.# define O
3dc0: 4e 4c 59 5f 49 46 5f 52 45 41 4c 4c 4f 43 5f 53 NLY_IF_REALLOC_S
3dd0: 54 52 45 53 53 28 58 29 20 20 28 30 29 0a 23 65 TRESS(X) (0).#e
3de0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 63 6c ndif../*.** Decl
3df0: 61 72 61 74 69 6f 6e 73 20 75 73 65 64 20 66 6f arations used fo
3e00: 72 20 74 72 61 63 69 6e 67 20 74 68 65 20 6f 70 r tracing the op
3e10: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20 69 erating system i
3e20: 6e 74 65 72 66 61 63 65 73 2e 0a 2a 2f 0a 23 69 nterfaces..*/.#i
3e30: 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
3e40: 5f 46 4f 52 43 45 5f 4f 53 5f 54 52 41 43 45 29 _FORCE_OS_TRACE)
3e50: 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 || defined(SQLI
3e60: 54 45 5f 54 45 53 54 29 20 7c 7c 20 5c 0a 20 20 TE_TEST) || \.
3e70: 20 20 28 64 65 66 69 6e 65 64 28 53 51 4c 49 54 (defined(SQLIT
3e80: 45 5f 44 45 42 55 47 29 20 26 26 20 53 51 4c 49 E_DEBUG) && SQLI
3e90: 54 45 5f 4f 53 5f 57 49 4e 29 0a 20 20 65 78 74 TE_OS_WIN). ext
3ea0: 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 4f ern int sqlite3O
3eb0: 53 54 72 61 63 65 3b 0a 23 20 64 65 66 69 6e 65 STrace;.# define
3ec0: 20 4f 53 54 52 41 43 45 28 58 29 20 20 20 20 20 OSTRACE(X)
3ed0: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
3ee0: 4f 53 54 72 61 63 65 20 29 20 73 71 6c 69 74 65 OSTrace ) sqlite
3ef0: 33 44 65 62 75 67 50 72 69 6e 74 66 20 58 0a 23 3DebugPrintf X.#
3f00: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 48 define SQLITE_H
3f10: 41 56 45 5f 4f 53 5f 54 52 41 43 45 0a 23 65 6c AVE_OS_TRACE.#el
3f20: 73 65 0a 23 20 64 65 66 69 6e 65 20 4f 53 54 52 se.# define OSTR
3f30: 41 43 45 28 58 29 0a 23 20 75 6e 64 65 66 20 20 ACE(X).# undef
3f40: 53 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 SQLITE_HAVE_OS_T
3f50: 52 41 43 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a RACE.#endif../*.
3f60: 2a 2a 20 49 73 20 74 68 65 20 73 71 6c 69 74 65 ** Is the sqlite
3f70: 33 45 72 72 4e 61 6d 65 28 29 20 66 75 6e 63 74 3ErrName() funct
3f80: 69 6f 6e 20 6e 65 65 64 65 64 20 69 6e 20 74 68 ion needed in th
3f90: 65 20 62 75 69 6c 64 3f 20 20 43 75 72 72 65 6e e build? Curren
3fa0: 74 6c 79 2c 0a 2a 2a 20 69 74 20 69 73 20 6e 65 tly,.** it is ne
3fb0: 65 64 65 64 20 62 79 20 22 6d 75 74 65 78 5f 77 eded by "mutex_w
3fc0: 33 32 2e 63 22 20 28 77 68 65 6e 20 64 65 62 75 32.c" (when debu
3fd0: 67 67 69 6e 67 29 2c 20 22 6f 73 5f 77 69 6e 2e gging), "os_win.
3fe0: 63 22 20 28 77 68 65 6e 0a 2a 2a 20 4f 53 54 52 c" (when.** OSTR
3ff0: 41 43 45 20 69 73 20 65 6e 61 62 6c 65 64 29 2c ACE is enabled),
4000: 20 61 6e 64 20 62 79 20 73 65 76 65 72 61 6c 20 and by several
4010: 22 74 65 73 74 2a 2e 63 22 20 66 69 6c 65 73 20 "test*.c" files
4020: 28 77 68 69 63 68 20 61 72 65 0a 2a 2a 20 63 6f (which are.** co
4030: 6d 70 69 6c 65 64 20 75 73 69 6e 67 20 53 51 4c mpiled using SQL
4040: 49 54 45 5f 54 45 53 54 29 2e 0a 2a 2f 0a 23 69 ITE_TEST)..*/.#i
4050: 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
4060: 5f 48 41 56 45 5f 4f 53 5f 54 52 41 43 45 29 20 _HAVE_OS_TRACE)
4070: 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 || defined(SQLIT
4080: 45 5f 54 45 53 54 29 20 7c 7c 20 5c 0a 20 20 20 E_TEST) || \.
4090: 20 28 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 (defined(SQLITE
40a0: 5f 44 45 42 55 47 29 20 26 26 20 53 51 4c 49 54 _DEBUG) && SQLIT
40b0: 45 5f 4f 53 5f 57 49 4e 29 0a 23 20 64 65 66 69 E_OS_WIN).# defi
40c0: 6e 65 20 53 51 4c 49 54 45 5f 4e 45 45 44 5f 45 ne SQLITE_NEED_E
40d0: 52 52 5f 4e 41 4d 45 0a 23 65 6c 73 65 0a 23 20 RR_NAME.#else.#
40e0: 75 6e 64 65 66 20 20 53 51 4c 49 54 45 5f 4e 45 undef SQLITE_NE
40f0: 45 44 5f 45 52 52 5f 4e 41 4d 45 0a 23 65 6e 64 ED_ERR_NAME.#end
4100: 69 66 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 49 54 45 if../*.** SQLITE
4110: 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e 5f _ENABLE_EXPLAIN_
4120: 43 4f 4d 4d 45 4e 54 53 20 69 73 20 69 6e 63 6f COMMENTS is inco
4130: 6d 70 61 74 69 62 6c 65 20 77 69 74 68 20 53 51 mpatible with SQ
4140: 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 LITE_OMIT_EXPLAI
4150: 4e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 N.*/.#ifdef SQLI
4160: 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a TE_OMIT_EXPLAIN.
4170: 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 # undef SQLITE_E
4180: 4e 41 42 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 4f NABLE_EXPLAIN_CO
4190: 4d 4d 45 4e 54 53 0a 23 65 6e 64 69 66 0a 0a 2f MMENTS.#endif../
41a0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 *.** Return true
41b0: 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 69 66 20 74 (non-zero) if t
41c0: 68 65 20 69 6e 70 75 74 20 69 73 20 61 6e 20 69 he input is an i
41d0: 6e 74 65 67 65 72 20 74 68 61 74 20 69 73 20 74 nteger that is t
41e0: 6f 6f 20 6c 61 72 67 65 0a 2a 2a 20 74 6f 20 66 oo large.** to f
41f0: 69 74 20 69 6e 20 33 32 2d 62 69 74 73 2e 20 20 it in 32-bits.
4200: 54 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 This macro is us
4210: 65 64 20 69 6e 73 69 64 65 20 6f 66 20 76 61 72 ed inside of var
4220: 69 6f 75 73 20 74 65 73 74 63 61 73 65 28 29 0a ious testcase().
4230: 2a 2a 20 6d 61 63 72 6f 73 20 74 6f 20 76 65 72 ** macros to ver
4240: 69 66 79 20 74 68 61 74 20 77 65 20 68 61 76 65 ify that we have
4250: 20 74 65 73 74 65 64 20 53 51 4c 69 74 65 20 66 tested SQLite f
4260: 6f 72 20 6c 61 72 67 65 2d 66 69 6c 65 20 73 75 or large-file su
4270: 70 70 6f 72 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e pport..*/.#defin
4280: 65 20 49 53 5f 42 49 47 5f 49 4e 54 28 58 29 20 e IS_BIG_INT(X)
4290: 20 28 28 28 58 29 26 7e 28 69 36 34 29 30 78 66 (((X)&~(i64)0xf
42a0: 66 66 66 66 66 66 66 29 21 3d 30 29 0a 0a 2f 2a fffffff)!=0)../*
42b0: 0a 2a 2a 20 54 68 65 20 6d 61 63 72 6f 20 75 6e .** The macro un
42c0: 6c 69 6b 65 6c 79 28 29 20 69 73 20 61 20 68 69 likely() is a hi
42d0: 6e 74 20 74 68 61 74 20 73 75 72 72 6f 75 6e 64 nt that surround
42e0: 73 20 61 20 62 6f 6f 6c 65 61 6e 0a 2a 2a 20 65 s a boolean.** e
42f0: 78 70 72 65 73 73 69 6f 6e 20 74 68 61 74 20 69 xpression that i
4300: 73 20 75 73 75 61 6c 6c 79 20 66 61 6c 73 65 2e s usually false.
4310: 20 20 4d 61 63 72 6f 20 6c 69 6b 65 6c 79 28 29 Macro likely()
4320: 20 73 75 72 72 6f 75 6e 64 73 0a 2a 2a 20 61 20 surrounds.** a
4330: 62 6f 6f 6c 65 61 6e 20 65 78 70 72 65 73 73 69 boolean expressi
4340: 6f 6e 20 74 68 61 74 20 69 73 20 75 73 75 61 6c on that is usual
4350: 6c 79 20 74 72 75 65 2e 20 20 54 68 65 73 65 20 ly true. These
4360: 68 69 6e 74 73 20 63 6f 75 6c 64 2c 0a 2a 2a 20 hints could,.**
4370: 69 6e 20 74 68 65 6f 72 79 2c 20 62 65 20 75 73 in theory, be us
4380: 65 64 20 62 79 20 74 68 65 20 63 6f 6d 70 69 6c ed by the compil
4390: 65 72 20 74 6f 20 67 65 6e 65 72 61 74 65 20 62 er to generate b
43a0: 65 74 74 65 72 20 63 6f 64 65 2c 20 62 75 74 0a etter code, but.
43b0: 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20 74 68 65 ** currently the
43c0: 79 20 61 72 65 20 6a 75 73 74 20 63 6f 6d 6d 65 y are just comme
43d0: 6e 74 73 20 66 6f 72 20 68 75 6d 61 6e 20 72 65 nts for human re
43e0: 61 64 65 72 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e aders..*/.#defin
43f0: 65 20 6c 69 6b 65 6c 79 28 58 29 20 20 20 20 28 e likely(X) (
4400: 58 29 0a 23 64 65 66 69 6e 65 20 75 6e 6c 69 6b X).#define unlik
4410: 65 6c 79 28 58 29 20 20 28 58 29 0a 0a 23 69 6e ely(X) (X)..#in
4420: 63 6c 75 64 65 20 22 68 61 73 68 2e 68 22 0a 23 clude "hash.h".#
4430: 69 6e 63 6c 75 64 65 20 22 70 61 72 73 65 2e 68 include "parse.h
4440: 22 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 69 ".#include <stdi
4450: 6f 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 o.h>.#include <s
4460: 74 64 6c 69 62 2e 68 3e 0a 23 69 6e 63 6c 75 64 tdlib.h>.#includ
4470: 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 23 69 6e e <string.h>.#in
4480: 63 6c 75 64 65 20 3c 61 73 73 65 72 74 2e 68 3e clude <assert.h>
4490: 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 64 65 .#include <stdde
44a0: 66 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 63 f.h>../*.** If c
44b0: 6f 6d 70 69 6c 69 6e 67 20 66 6f 72 20 61 20 70 ompiling for a p
44c0: 72 6f 63 65 73 73 6f 72 20 74 68 61 74 20 6c 61 rocessor that la
44d0: 63 6b 73 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 cks floating poi
44e0: 6e 74 20 73 75 70 70 6f 72 74 2c 0a 2a 2a 20 73 nt support,.** s
44f0: 75 62 73 74 69 74 75 74 65 20 69 6e 74 65 67 65 ubstitute intege
4500: 72 20 66 6f 72 20 66 6c 6f 61 74 69 6e 67 2d 70 r for floating-p
4510: 6f 69 6e 74 0a 2a 2f 0a 23 69 66 64 65 66 20 53 oint.*/.#ifdef S
4520: 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 QLITE_OMIT_FLOAT
4530: 49 4e 47 5f 50 4f 49 4e 54 0a 23 20 64 65 66 69 ING_POINT.# defi
4540: 6e 65 20 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 ne double sqlite
4550: 5f 69 6e 74 36 34 0a 23 20 64 65 66 69 6e 65 20 _int64.# define
4560: 66 6c 6f 61 74 20 73 71 6c 69 74 65 5f 69 6e 74 float sqlite_int
4570: 36 34 0a 23 20 64 65 66 69 6e 65 20 4c 4f 4e 47 64.# define LONG
4580: 44 4f 55 42 4c 45 5f 54 59 50 45 20 73 71 6c 69 DOUBLE_TYPE sqli
4590: 74 65 5f 69 6e 74 36 34 0a 23 20 69 66 6e 64 65 te_int64.# ifnde
45a0: 66 20 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c f SQLITE_BIG_DBL
45b0: 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 .# define SQLI
45c0: 54 45 5f 42 49 47 5f 44 42 4c 20 28 28 28 73 71 TE_BIG_DBL (((sq
45d0: 6c 69 74 65 33 5f 69 6e 74 36 34 29 31 29 3c 3c lite3_int64)1)<<
45e0: 35 30 29 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 50).# endif.# de
45f0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fine SQLITE_OMIT
4600: 5f 44 41 54 45 54 49 4d 45 5f 46 55 4e 43 53 20 _DATETIME_FUNCS
4610: 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 1.# define SQLIT
4620: 45 5f 4f 4d 49 54 5f 54 52 41 43 45 20 31 0a 23 E_OMIT_TRACE 1.#
4630: 20 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 4d 49 undef SQLITE_MI
4640: 58 45 44 5f 45 4e 44 49 41 4e 5f 36 34 42 49 54 XED_ENDIAN_64BIT
4650: 5f 46 4c 4f 41 54 0a 23 20 75 6e 64 65 66 20 53 _FLOAT.# undef S
4660: 51 4c 49 54 45 5f 48 41 56 45 5f 49 53 4e 41 4e QLITE_HAVE_ISNAN
4670: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
4680: 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c 0a 23 SQLITE_BIG_DBL.#
4690: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 define SQLITE_B
46a0: 49 47 5f 44 42 4c 20 28 31 65 39 39 29 0a 23 65 IG_DBL (1e99).#e
46b0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f 4d 49 54 ndif../*.** OMIT
46c0: 5f 54 45 4d 50 44 42 20 69 73 20 73 65 74 20 74 _TEMPDB is set t
46d0: 6f 20 31 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d o 1 if SQLITE_OM
46e0: 49 54 5f 54 45 4d 50 44 42 20 69 73 20 64 65 66 IT_TEMPDB is def
46f0: 69 6e 65 64 2c 20 6f 72 20 30 0a 2a 2a 20 61 66 ined, or 0.** af
4700: 74 65 72 77 61 72 64 2e 20 48 61 76 69 6e 67 20 terward. Having
4710: 74 68 69 73 20 6d 61 63 72 6f 20 61 6c 6c 6f 77 this macro allow
4720: 73 20 75 73 20 74 6f 20 63 61 75 73 65 20 74 68 s us to cause th
4730: 65 20 43 20 63 6f 6d 70 69 6c 65 72 0a 2a 2a 20 e C compiler.**
4740: 74 6f 20 6f 6d 69 74 20 63 6f 64 65 20 75 73 65 to omit code use
4750: 64 20 62 79 20 54 45 4d 50 20 74 61 62 6c 65 73 d by TEMP tables
4760: 20 77 69 74 68 6f 75 74 20 6d 65 73 73 79 20 23 without messy #
4770: 69 66 6e 64 65 66 20 73 74 61 74 65 6d 65 6e 74 ifndef statement
4780: 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c s..*/.#ifdef SQL
4790: 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 0a ITE_OMIT_TEMPDB.
47a0: 23 64 65 66 69 6e 65 20 4f 4d 49 54 5f 54 45 4d #define OMIT_TEM
47b0: 50 44 42 20 31 0a 23 65 6c 73 65 0a 23 64 65 66 PDB 1.#else.#def
47c0: 69 6e 65 20 4f 4d 49 54 5f 54 45 4d 50 44 42 20 ine OMIT_TEMPDB
47d0: 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 0.#endif../*.**
47e0: 54 68 65 20 22 66 69 6c 65 20 66 6f 72 6d 61 74 The "file format
47f0: 22 20 6e 75 6d 62 65 72 20 69 73 20 61 6e 20 69 " number is an i
4800: 6e 74 65 67 65 72 20 74 68 61 74 20 69 73 20 69 nteger that is i
4810: 6e 63 72 65 6d 65 6e 74 65 64 20 77 68 65 6e 65 ncremented whene
4820: 76 65 72 0a 2a 2a 20 74 68 65 20 56 44 42 45 2d ver.** the VDBE-
4830: 6c 65 76 65 6c 20 66 69 6c 65 20 66 6f 72 6d 61 level file forma
4840: 74 20 63 68 61 6e 67 65 73 2e 20 20 54 68 65 20 t changes. The
4850: 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 following macros
4860: 20 64 65 66 69 6e 65 20 74 68 65 0a 2a 2a 20 74 define the.** t
4870: 68 65 20 64 65 66 61 75 6c 74 20 66 69 6c 65 20 he default file
4880: 66 6f 72 6d 61 74 20 66 6f 72 20 6e 65 77 20 64 format for new d
4890: 61 74 61 62 61 73 65 73 20 61 6e 64 20 74 68 65 atabases and the
48a0: 20 6d 61 78 69 6d 75 6d 20 66 69 6c 65 20 66 6f maximum file fo
48b0: 72 6d 61 74 0a 2a 2a 20 74 68 61 74 20 74 68 65 rmat.** that the
48c0: 20 6c 69 62 72 61 72 79 20 63 61 6e 20 72 65 61 library can rea
48d0: 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 d..*/.#define SQ
48e0: 4c 49 54 45 5f 4d 41 58 5f 46 49 4c 45 5f 46 4f LITE_MAX_FILE_FO
48f0: 52 4d 41 54 20 34 0a 23 69 66 6e 64 65 66 20 53 RMAT 4.#ifndef S
4900: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 QLITE_DEFAULT_FI
4910: 4c 45 5f 46 4f 52 4d 41 54 0a 23 20 64 65 66 69 LE_FORMAT.# defi
4920: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
4930: 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 34 0a T_FILE_FORMAT 4.
4940: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 #endif../*.** De
4950: 74 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 termine whether
4960: 74 72 69 67 67 65 72 73 20 61 72 65 20 72 65 63 triggers are rec
4970: 75 72 73 69 76 65 20 62 79 20 64 65 66 61 75 6c ursive by defaul
4980: 74 2e 20 20 54 68 69 73 20 63 61 6e 20 62 65 0a t. This can be.
4990: 2a 2a 20 63 68 61 6e 67 65 64 20 61 74 20 72 75 ** changed at ru
49a0: 6e 2d 74 69 6d 65 20 75 73 69 6e 67 20 61 20 70 n-time using a p
49b0: 72 61 67 6d 61 2e 0a 2a 2f 0a 23 69 66 6e 64 65 ragma..*/.#ifnde
49c0: 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 f SQLITE_DEFAULT
49d0: 5f 52 45 43 55 52 53 49 56 45 5f 54 52 49 47 47 _RECURSIVE_TRIGG
49e0: 45 52 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c ERS.# define SQL
49f0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 55 ITE_DEFAULT_RECU
4a00: 52 53 49 56 45 5f 54 52 49 47 47 45 52 53 20 30 RSIVE_TRIGGERS 0
4a10: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 .#endif../*.** P
4a20: 72 6f 76 69 64 65 20 61 20 64 65 66 61 75 6c 74 rovide a default
4a30: 20 76 61 6c 75 65 20 66 6f 72 20 53 51 4c 49 54 value for SQLIT
4a40: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 20 69 6e 20 E_TEMP_STORE in
4a50: 63 61 73 65 20 69 74 20 69 73 20 6e 6f 74 20 73 case it is not s
4a60: 70 65 63 69 66 69 65 64 0a 2a 2a 20 6f 6e 20 74 pecified.** on t
4a70: 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 0a he command-line.
4a80: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
4a90: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 0a 23 20 64 E_TEMP_STORE.# d
4aa0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 45 4d efine SQLITE_TEM
4ab0: 50 5f 53 54 4f 52 45 20 31 0a 23 20 64 65 66 69 P_STORE 1.# defi
4ac0: 6e 65 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 ne SQLITE_TEMP_S
4ad0: 54 4f 52 45 5f 78 63 20 31 20 20 2f 2a 20 45 78 TORE_xc 1 /* Ex
4ae0: 63 6c 75 64 65 20 66 72 6f 6d 20 63 74 69 6d 65 clude from ctime
4af0: 2e 63 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a .c */.#endif../*
4b00: 0a 2a 2a 20 49 66 20 6e 6f 20 76 61 6c 75 65 20 .** If no value
4b10: 68 61 73 20 62 65 65 6e 20 70 72 6f 76 69 64 65 has been provide
4b20: 64 20 66 6f 72 20 53 51 4c 49 54 45 5f 4d 41 58 d for SQLITE_MAX
4b30: 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 2c _WORKER_THREADS,
4b40: 20 6f 72 20 69 66 0a 2a 2a 20 53 51 4c 49 54 45 or if.** SQLITE
4b50: 5f 54 45 4d 50 5f 53 54 4f 52 45 20 69 73 20 73 _TEMP_STORE is s
4b60: 65 74 20 74 6f 20 33 20 28 6e 65 76 65 72 20 75 et to 3 (never u
4b70: 73 65 20 74 65 6d 70 6f 72 61 72 79 20 66 69 6c se temporary fil
4b80: 65 73 29 2c 20 73 65 74 20 69 74 0a 2a 2a 20 74 es), set it.** t
4b90: 6f 20 7a 65 72 6f 2e 0a 2a 2f 0a 23 69 66 20 53 o zero..*/.#if S
4ba0: 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 QLITE_TEMP_STORE
4bb0: 3d 3d 33 20 7c 7c 20 53 51 4c 49 54 45 5f 54 48 ==3 || SQLITE_TH
4bc0: 52 45 41 44 53 41 46 45 3d 3d 30 0a 23 20 75 6e READSAFE==0.# un
4bd0: 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 def SQLITE_MAX_W
4be0: 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 0a 23 20 ORKER_THREADS.#
4bf0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 define SQLITE_MA
4c00: 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 X_WORKER_THREADS
4c10: 20 30 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 0.#endif.#ifnde
4c20: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 f SQLITE_MAX_WOR
4c30: 4b 45 52 5f 54 48 52 45 41 44 53 0a 23 20 64 65 KER_THREADS.# de
4c40: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f fine SQLITE_MAX_
4c50: 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 20 38 WORKER_THREADS 8
4c60: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
4c70: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 SQLITE_DEFAULT_W
4c80: 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 0a 23 20 ORKER_THREADS.#
4c90: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 define SQLITE_DE
4ca0: 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f 54 48 52 FAULT_WORKER_THR
4cb0: 45 41 44 53 20 30 0a 23 65 6e 64 69 66 0a 23 69 EADS 0.#endif.#i
4cc0: 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 f SQLITE_DEFAULT
4cd0: 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 3e _WORKER_THREADS>
4ce0: 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 SQLITE_MAX_WORKE
4cf0: 52 5f 54 48 52 45 41 44 53 0a 23 20 75 6e 64 65 R_THREADS.# unde
4d00: 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 f SQLITE_MAX_WOR
4d10: 4b 45 52 5f 54 48 52 45 41 44 53 0a 23 20 64 65 KER_THREADS.# de
4d20: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f fine SQLITE_MAX_
4d30: 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 20 53 WORKER_THREADS S
4d40: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f QLITE_DEFAULT_WO
4d50: 52 4b 45 52 5f 54 48 52 45 41 44 53 0a 23 65 6e RKER_THREADS.#en
4d60: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 dif../*.** The d
4d70: 65 66 61 75 6c 74 20 69 6e 69 74 69 61 6c 20 61 efault initial a
4d80: 6c 6c 6f 63 61 74 69 6f 6e 20 66 6f 72 20 74 68 llocation for th
4d90: 65 20 70 61 67 65 63 61 63 68 65 20 77 68 65 6e e pagecache when
4da0: 20 75 73 69 6e 67 20 73 65 70 61 72 61 74 65 0a using separate.
4db0: 2a 2a 20 70 61 67 65 63 61 63 68 65 73 20 66 6f ** pagecaches fo
4dc0: 72 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20 r each database
4dd0: 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 41 20 70 connection. A p
4de0: 6f 73 69 74 69 76 65 20 6e 75 6d 62 65 72 20 69 ositive number i
4df0: 73 20 74 68 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 s the.** number
4e00: 6f 66 20 70 61 67 65 73 2e 20 20 41 20 6e 65 67 of pages. A neg
4e10: 61 74 69 76 65 20 6e 75 6d 62 65 72 20 4e 20 74 ative number N t
4e20: 72 61 6e 73 6c 61 74 69 6f 6e 73 20 6d 65 61 6e ranslations mean
4e30: 73 20 74 68 61 74 20 61 20 62 75 66 66 65 72 0a s that a buffer.
4e40: 2a 2a 20 6f 66 20 2d 31 30 32 34 2a 4e 20 62 79 ** of -1024*N by
4e50: 74 65 73 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 tes is allocated
4e60: 20 61 6e 64 20 75 73 65 64 20 66 6f 72 20 61 73 and used for as
4e70: 20 6d 61 6e 79 20 70 61 67 65 73 20 61 73 20 69 many pages as i
4e80: 74 20 77 69 6c 6c 20 68 6f 6c 64 2e 0a 2a 2f 0a t will hold..*/.
4e90: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
4ea0: 45 46 41 55 4c 54 5f 50 43 41 43 48 45 5f 49 4e EFAULT_PCACHE_IN
4eb0: 49 54 53 5a 0a 23 20 64 65 66 69 6e 65 20 53 51 ITSZ.# define SQ
4ec0: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 50 43 41 LITE_DEFAULT_PCA
4ed0: 43 48 45 5f 49 4e 49 54 53 5a 20 31 30 30 0a 23 CHE_INITSZ 100.#
4ee0: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 43 43 endif../*.** GCC
4ef0: 20 64 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e 65 does not define
4f00: 20 74 68 65 20 6f 66 66 73 65 74 6f 66 28 29 20 the offsetof()
4f10: 6d 61 63 72 6f 20 73 6f 20 77 65 27 6c 6c 20 68 macro so we'll h
4f20: 61 76 65 20 74 6f 20 64 6f 20 69 74 0a 2a 2a 20 ave to do it.**
4f30: 6f 75 72 73 65 6c 76 65 73 2e 0a 2a 2f 0a 23 69 ourselves..*/.#i
4f40: 66 6e 64 65 66 20 6f 66 66 73 65 74 6f 66 0a 23 fndef offsetof.#
4f50: 64 65 66 69 6e 65 20 6f 66 66 73 65 74 6f 66 28 define offsetof(
4f60: 53 54 52 55 43 54 55 52 45 2c 46 49 45 4c 44 29 STRUCTURE,FIELD)
4f70: 20 28 28 69 6e 74 29 28 28 63 68 61 72 2a 29 26 ((int)((char*)&
4f80: 28 28 53 54 52 55 43 54 55 52 45 2a 29 30 29 2d ((STRUCTURE*)0)-
4f90: 3e 46 49 45 4c 44 29 29 0a 23 65 6e 64 69 66 0a >FIELD)).#endif.
4fa0: 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 6f ./*.** Macros to
4fb0: 20 63 6f 6d 70 75 74 65 20 6d 69 6e 69 6d 75 6d compute minimum
4fc0: 20 61 6e 64 20 6d 61 78 69 6d 75 6d 20 6f 66 20 and maximum of
4fd0: 74 77 6f 20 6e 75 6d 62 65 72 73 2e 0a 2a 2f 0a two numbers..*/.
4fe0: 23 69 66 6e 64 65 66 20 4d 49 4e 0a 23 20 64 65 #ifndef MIN.# de
4ff0: 66 69 6e 65 20 4d 49 4e 28 41 2c 42 29 20 28 28 fine MIN(A,B) ((
5000: 41 29 3c 28 42 29 3f 28 41 29 3a 28 42 29 29 0a A)<(B)?(A):(B)).
5010: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 4d #endif.#ifndef M
5020: 41 58 0a 23 20 64 65 66 69 6e 65 20 4d 41 58 28 AX.# define MAX(
5030: 41 2c 42 29 20 28 28 41 29 3e 28 42 29 3f 28 41 A,B) ((A)>(B)?(A
5040: 29 3a 28 42 29 29 0a 23 65 6e 64 69 66 0a 0a 2f ):(B)).#endif../
5050: 2a 0a 2a 2a 20 53 77 61 70 20 74 77 6f 20 6f 62 *.** Swap two ob
5060: 6a 65 63 74 73 20 6f 66 20 74 79 70 65 20 54 59 jects of type TY
5070: 50 45 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 PE..*/.#define S
5080: 57 41 50 28 54 59 50 45 2c 41 2c 42 29 20 7b 54 WAP(TYPE,A,B) {T
5090: 59 50 45 20 74 3d 41 3b 20 41 3d 42 3b 20 42 3d YPE t=A; A=B; B=
50a0: 74 3b 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b t;}../*.** Check
50b0: 20 74 6f 20 73 65 65 20 69 66 20 74 68 69 73 20 to see if this
50c0: 6d 61 63 68 69 6e 65 20 75 73 65 73 20 45 42 43 machine uses EBC
50d0: 44 49 43 2e 20 20 28 59 65 73 2c 20 62 65 6c 69 DIC. (Yes, beli
50e0: 65 76 65 20 69 74 20 6f 72 0a 2a 2a 20 6e 6f 74 eve it or.** not
50f0: 2c 20 74 68 65 72 65 20 61 72 65 20 73 74 69 6c , there are stil
5100: 6c 20 6d 61 63 68 69 6e 65 73 20 6f 75 74 20 74 l machines out t
5110: 68 65 72 65 20 74 68 61 74 20 75 73 65 20 45 42 here that use EB
5120: 43 44 49 43 2e 29 0a 2a 2f 0a 23 69 66 20 27 41 CDIC.).*/.#if 'A
5130: 27 20 3d 3d 20 27 5c 33 30 31 27 0a 23 20 64 65 ' == '\301'.# de
5140: 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 42 43 44 fine SQLITE_EBCD
5150: 49 43 20 31 0a 23 65 6c 73 65 0a 23 20 64 65 66 IC 1.#else.# def
5160: 69 6e 65 20 53 51 4c 49 54 45 5f 41 53 43 49 49 ine SQLITE_ASCII
5170: 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 1.#endif../*.**
5180: 20 49 6e 74 65 67 65 72 73 20 6f 66 20 6b 6e 6f Integers of kno
5190: 77 6e 20 73 69 7a 65 73 2e 20 20 54 68 65 73 65 wn sizes. These
51a0: 20 74 79 70 65 64 65 66 73 20 6d 69 67 68 74 20 typedefs might
51b0: 63 68 61 6e 67 65 20 66 6f 72 20 61 72 63 68 69 change for archi
51c0: 74 65 63 74 75 72 65 73 0a 2a 2a 20 77 68 65 72 tectures.** wher
51d0: 65 20 74 68 65 20 73 69 7a 65 73 20 76 65 72 79 e the sizes very
51e0: 2e 20 20 50 72 65 70 72 6f 63 65 73 73 6f 72 20 . Preprocessor
51f0: 6d 61 63 72 6f 73 20 61 72 65 20 61 76 61 69 6c macros are avail
5200: 61 62 6c 65 20 73 6f 20 74 68 61 74 20 74 68 65 able so that the
5210: 0a 2a 2a 20 74 79 70 65 73 20 63 61 6e 20 62 65 .** types can be
5220: 20 63 6f 6e 76 65 6e 69 65 6e 74 6c 79 20 72 65 conveniently re
5230: 64 65 66 69 6e 65 64 20 61 74 20 63 6f 6d 70 69 defined at compi
5240: 6c 65 2d 74 79 70 65 2e 20 20 4c 69 6b 65 20 74 le-type. Like t
5250: 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 his:.**.**
5260: 20 20 20 63 63 20 27 2d 44 55 49 4e 54 50 54 52 cc '-DUINTPTR
5270: 5f 54 59 50 45 3d 6c 6f 6e 67 20 6c 6f 6e 67 20 _TYPE=long long
5280: 69 6e 74 27 20 2e 2e 2e 0a 2a 2f 0a 23 69 66 6e int' ....*/.#ifn
5290: 64 65 66 20 55 49 4e 54 33 32 5f 54 59 50 45 0a def UINT32_TYPE.
52a0: 23 20 69 66 64 65 66 20 48 41 56 45 5f 55 49 4e # ifdef HAVE_UIN
52b0: 54 33 32 5f 54 0a 23 20 20 64 65 66 69 6e 65 20 T32_T.# define
52c0: 55 49 4e 54 33 32 5f 54 59 50 45 20 75 69 6e 74 UINT32_TYPE uint
52d0: 33 32 5f 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 32_t.# else.# d
52e0: 65 66 69 6e 65 20 55 49 4e 54 33 32 5f 54 59 50 efine UINT32_TYP
52f0: 45 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 0a 23 E unsigned int.#
5300: 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 23 69 endif.#endif.#i
5310: 66 6e 64 65 66 20 55 49 4e 54 31 36 5f 54 59 50 fndef UINT16_TYP
5320: 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 5f 55 E.# ifdef HAVE_U
5330: 49 4e 54 31 36 5f 54 0a 23 20 20 64 65 66 69 6e INT16_T.# defin
5340: 65 20 55 49 4e 54 31 36 5f 54 59 50 45 20 75 69 e UINT16_TYPE ui
5350: 6e 74 31 36 5f 74 0a 23 20 65 6c 73 65 0a 23 20 nt16_t.# else.#
5360: 20 64 65 66 69 6e 65 20 55 49 4e 54 31 36 5f 54 define UINT16_T
5370: 59 50 45 20 75 6e 73 69 67 6e 65 64 20 73 68 6f YPE unsigned sho
5380: 72 74 20 69 6e 74 0a 23 20 65 6e 64 69 66 0a 23 rt int.# endif.#
5390: 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 49 4e endif.#ifndef IN
53a0: 54 31 36 5f 54 59 50 45 0a 23 20 69 66 64 65 66 T16_TYPE.# ifdef
53b0: 20 48 41 56 45 5f 49 4e 54 31 36 5f 54 0a 23 20 HAVE_INT16_T.#
53c0: 20 64 65 66 69 6e 65 20 49 4e 54 31 36 5f 54 59 define INT16_TY
53d0: 50 45 20 69 6e 74 31 36 5f 74 0a 23 20 65 6c 73 PE int16_t.# els
53e0: 65 0a 23 20 20 64 65 66 69 6e 65 20 49 4e 54 31 e.# define INT1
53f0: 36 5f 54 59 50 45 20 73 68 6f 72 74 20 69 6e 74 6_TYPE short int
5400: 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a .# endif.#endif.
5410: 23 69 66 6e 64 65 66 20 55 49 4e 54 38 5f 54 59 #ifndef UINT8_TY
5420: 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 5f PE.# ifdef HAVE_
5430: 55 49 4e 54 38 5f 54 0a 23 20 20 64 65 66 69 6e UINT8_T.# defin
5440: 65 20 55 49 4e 54 38 5f 54 59 50 45 20 75 69 6e e UINT8_TYPE uin
5450: 74 38 5f 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 t8_t.# else.# d
5460: 65 66 69 6e 65 20 55 49 4e 54 38 5f 54 59 50 45 efine UINT8_TYPE
5470: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 0a 23 unsigned char.#
5480: 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 23 69 endif.#endif.#i
5490: 66 6e 64 65 66 20 49 4e 54 38 5f 54 59 50 45 0a fndef INT8_TYPE.
54a0: 23 20 69 66 64 65 66 20 48 41 56 45 5f 49 4e 54 # ifdef HAVE_INT
54b0: 38 5f 54 0a 23 20 20 64 65 66 69 6e 65 20 49 4e 8_T.# define IN
54c0: 54 38 5f 54 59 50 45 20 69 6e 74 38 5f 74 0a 23 T8_TYPE int8_t.#
54d0: 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 else.# define
54e0: 49 4e 54 38 5f 54 59 50 45 20 73 69 67 6e 65 64 INT8_TYPE signed
54f0: 20 63 68 61 72 0a 23 20 65 6e 64 69 66 0a 23 65 char.# endif.#e
5500: 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 4c 4f 4e ndif.#ifndef LON
5510: 47 44 4f 55 42 4c 45 5f 54 59 50 45 0a 23 20 64 GDOUBLE_TYPE.# d
5520: 65 66 69 6e 65 20 4c 4f 4e 47 44 4f 55 42 4c 45 efine LONGDOUBLE
5530: 5f 54 59 50 45 20 6c 6f 6e 67 20 64 6f 75 62 6c _TYPE long doubl
5540: 65 0a 23 65 6e 64 69 66 0a 74 79 70 65 64 65 66 e.#endif.typedef
5550: 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 20 69 36 sqlite_int64 i6
5560: 34 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 38 4; /* 8
5570: 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 6e 74 -byte signed int
5580: 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 65 66 20 eger */.typedef
5590: 73 71 6c 69 74 65 5f 75 69 6e 74 36 34 20 75 36 sqlite_uint64 u6
55a0: 34 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 38 2d 4; /* 8-
55b0: 62 79 74 65 20 75 6e 73 69 67 6e 65 64 20 69 6e byte unsigned in
55c0: 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 65 66 teger */.typedef
55d0: 20 55 49 4e 54 33 32 5f 54 59 50 45 20 75 33 32 UINT32_TYPE u32
55e0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 34 ; /* 4
55f0: 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 64 20 69 -byte unsigned i
5600: 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 65 nteger */.typede
5610: 66 20 55 49 4e 54 31 36 5f 54 59 50 45 20 75 31 f UINT16_TYPE u1
5620: 36 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 6; /*
5630: 32 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 64 20 2-byte unsigned
5640: 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 integer */.typed
5650: 65 66 20 49 4e 54 31 36 5f 54 59 50 45 20 69 31 ef INT16_TYPE i1
5660: 36 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 6; /*
5670: 20 32 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 2-byte signed i
5680: 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 65 nteger */.typede
5690: 66 20 55 49 4e 54 38 5f 54 59 50 45 20 75 38 3b f UINT8_TYPE u8;
56a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
56b0: 31 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 64 20 1-byte unsigned
56c0: 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 integer */.typed
56d0: 65 66 20 49 4e 54 38 5f 54 59 50 45 20 69 38 3b ef INT8_TYPE i8;
56e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
56f0: 20 31 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 1-byte signed i
5700: 6e 74 65 67 65 72 20 2a 2f 0a 0a 2f 2a 0a 2a 2a nteger */../*.**
5710: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 55 33 32 20 SQLITE_MAX_U32
5720: 69 73 20 61 20 75 36 34 20 63 6f 6e 73 74 61 6e is a u64 constan
5730: 74 20 74 68 61 74 20 69 73 20 74 68 65 20 6d 61 t that is the ma
5740: 78 69 6d 75 6d 20 75 36 34 20 76 61 6c 75 65 0a ximum u64 value.
5750: 2a 2a 20 74 68 61 74 20 63 61 6e 20 62 65 20 73 ** that can be s
5760: 74 6f 72 65 64 20 69 6e 20 61 20 75 33 32 20 77 tored in a u32 w
5770: 69 74 68 6f 75 74 20 6c 6f 73 73 20 6f 66 20 64 ithout loss of d
5780: 61 74 61 2e 20 20 54 68 65 20 76 61 6c 75 65 0a ata. The value.
5790: 2a 2a 20 69 73 20 30 78 30 30 30 30 30 30 30 30 ** is 0x00000000
57a0: 66 66 66 66 66 66 66 66 2e 20 20 42 75 74 20 62 ffffffff. But b
57b0: 65 63 61 75 73 65 20 6f 66 20 71 75 69 72 6b 73 ecause of quirks
57c0: 20 6f 66 20 73 6f 6d 65 20 63 6f 6d 70 69 6c 65 of some compile
57d0: 72 73 2c 20 77 65 0a 2a 2a 20 68 61 76 65 20 74 rs, we.** have t
57e0: 6f 20 73 70 65 63 69 66 79 20 74 68 65 20 76 61 o specify the va
57f0: 6c 75 65 20 69 6e 20 74 68 65 20 6c 65 73 73 20 lue in the less
5800: 69 6e 74 75 69 74 69 76 65 20 6d 61 6e 6e 65 72 intuitive manner
5810: 20 73 68 6f 77 6e 3a 0a 2a 2f 0a 23 64 65 66 69 shown:.*/.#defi
5820: 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f 55 33 ne SQLITE_MAX_U3
5830: 32 20 20 28 28 28 28 75 36 34 29 31 29 3c 3c 33 2 ((((u64)1)<<3
5840: 32 29 2d 31 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 2)-1)../*.** The
5850: 20 64 61 74 61 74 79 70 65 20 75 73 65 64 20 74 datatype used t
5860: 6f 20 73 74 6f 72 65 20 65 73 74 69 6d 61 74 65 o store estimate
5870: 73 20 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 s of the number
5880: 6f 66 20 72 6f 77 73 20 69 6e 20 61 0a 2a 2a 20 of rows in a.**
5890: 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 table or index.
58a0: 20 54 68 69 73 20 69 73 20 61 6e 20 75 6e 73 69 This is an unsi
58b0: 67 6e 65 64 20 69 6e 74 65 67 65 72 20 74 79 70 gned integer typ
58c0: 65 2e 20 20 46 6f 72 20 39 39 2e 39 25 20 6f 66 e. For 99.9% of
58d0: 0a 2a 2a 20 74 68 65 20 77 6f 72 6c 64 2c 20 61 .** the world, a
58e0: 20 33 32 2d 62 69 74 20 69 6e 74 65 67 65 72 20 32-bit integer
58f0: 69 73 20 73 75 66 66 69 63 69 65 6e 74 2e 20 20 is sufficient.
5900: 42 75 74 20 61 20 36 34 2d 62 69 74 20 69 6e 74 But a 64-bit int
5910: 65 67 65 72 0a 2a 2a 20 63 61 6e 20 62 65 20 75 eger.** can be u
5920: 73 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 sed at compile-t
5930: 69 6d 65 20 69 66 20 64 65 73 69 72 65 64 2e 0a ime if desired..
5940: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
5950: 5f 36 34 42 49 54 5f 53 54 41 54 53 0a 20 74 79 _64BIT_STATS. ty
5960: 70 65 64 65 66 20 75 36 34 20 74 52 6f 77 63 6e pedef u64 tRowcn
5970: 74 3b 20 20 20 20 2f 2a 20 36 34 2d 62 69 74 20 t; /* 64-bit
5980: 6f 6e 6c 79 20 69 66 20 72 65 71 75 65 73 74 65 only if requeste
5990: 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d d at compile-tim
59a0: 65 20 2a 2f 0a 23 65 6c 73 65 0a 20 74 79 70 65 e */.#else. type
59b0: 64 65 66 20 75 33 32 20 74 52 6f 77 63 6e 74 3b def u32 tRowcnt;
59c0: 20 20 20 20 2f 2a 20 33 32 2d 62 69 74 20 69 73 /* 32-bit is
59d0: 20 74 68 65 20 64 65 66 61 75 6c 74 20 2a 2f 0a the default */.
59e0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 73 #endif../*.** Es
59f0: 74 69 6d 61 74 65 64 20 71 75 61 6e 74 69 74 69 timated quantiti
5a00: 65 73 20 75 73 65 64 20 66 6f 72 20 71 75 65 72 es used for quer
5a10: 79 20 70 6c 61 6e 6e 69 6e 67 20 61 72 65 20 73 y planning are s
5a20: 74 6f 72 65 64 20 61 73 20 31 36 2d 62 69 74 0a tored as 16-bit.
5a30: 2a 2a 20 6c 6f 67 61 72 69 74 68 6d 73 2e 20 20 ** logarithms.
5a40: 46 6f 72 20 71 75 61 6e 74 69 74 79 20 58 2c 20 For quantity X,
5a50: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 the value stored
5a60: 20 69 73 20 31 30 2a 6c 6f 67 32 28 58 29 2e 20 is 10*log2(X).
5a70: 20 54 68 69 73 0a 2a 2a 20 67 69 76 65 73 20 61 This.** gives a
5a80: 20 70 6f 73 73 69 62 6c 65 20 72 61 6e 67 65 20 possible range
5a90: 6f 66 20 76 61 6c 75 65 73 20 6f 66 20 61 70 70 of values of app
5aa0: 72 6f 78 69 6d 61 74 65 6c 79 20 31 2e 30 65 39 roximately 1.0e9
5ab0: 38 36 20 74 6f 20 31 65 2d 39 38 36 2e 0a 2a 2a 86 to 1e-986..**
5ac0: 20 42 75 74 20 74 68 65 20 61 6c 6c 6f 77 65 64 But the allowed
5ad0: 20 76 61 6c 75 65 73 20 61 72 65 20 22 67 72 61 values are "gra
5ae0: 69 6e 79 22 2e 20 20 4e 6f 74 20 65 76 65 72 79 iny". Not every
5af0: 20 76 61 6c 75 65 20 69 73 20 72 65 70 72 65 73 value is repres
5b00: 65 6e 74 61 62 6c 65 2e 0a 2a 2a 20 46 6f 72 20 entable..** For
5b10: 65 78 61 6d 70 6c 65 2c 20 71 75 61 6e 74 69 74 example, quantit
5b20: 69 65 73 20 31 36 20 61 6e 64 20 31 37 20 61 72 ies 16 and 17 ar
5b30: 65 20 62 6f 74 68 20 72 65 70 72 65 73 65 6e 74 e both represent
5b40: 65 64 20 62 79 20 61 20 4c 6f 67 45 73 74 0a 2a ed by a LogEst.*
5b50: 2a 20 6f 66 20 34 30 2e 20 20 48 6f 77 65 76 65 * of 40. Howeve
5b60: 72 2c 20 73 69 6e 63 65 20 4c 6f 67 45 73 74 20 r, since LogEst
5b70: 71 75 61 6e 74 69 74 69 65 73 20 61 72 65 20 73 quantities are s
5b80: 75 70 70 6f 73 65 20 74 6f 20 62 65 20 65 73 74 uppose to be est
5b90: 69 6d 61 74 65 73 2c 0a 2a 2a 20 6e 6f 74 20 65 imates,.** not e
5ba0: 78 61 63 74 20 76 61 6c 75 65 73 2c 20 74 68 69 xact values, thi
5bb0: 73 20 69 6d 70 72 65 63 69 73 69 6f 6e 20 69 73 s imprecision is
5bc0: 20 6e 6f 74 20 61 20 70 72 6f 62 6c 65 6d 2e 0a not a problem..
5bd0: 2a 2a 0a 2a 2a 20 22 4c 6f 67 45 73 74 22 20 69 **.** "LogEst" i
5be0: 73 20 73 68 6f 72 74 20 66 6f 72 20 22 4c 6f 67 s short for "Log
5bf0: 61 72 69 74 68 6d 69 63 20 45 73 74 69 6d 61 74 arithmic Estimat
5c00: 65 22 2e 0a 2a 2a 0a 2a 2a 20 45 78 61 6d 70 6c e"..**.** Exampl
5c10: 65 73 3a 0a 2a 2a 20 20 20 20 20 20 31 20 2d 3e es:.** 1 ->
5c20: 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0
5c30: 32 30 20 2d 3e 20 34 33 20 20 20 20 20 20 20 20 20 -> 43
5c40: 20 20 31 30 30 30 30 20 2d 3e 20 31 33 32 0a 2a 10000 -> 132.*
5c50: 2a 20 20 20 20 20 20 32 20 2d 3e 20 31 30 20 20 * 2 -> 10
5c60: 20 20 20 20 20 20 20 20 20 20 20 32 35 20 2d 3e 25 ->
5c70: 20 34 36 20 20 20 20 20 20 20 20 20 20 32 35 30 46 250
5c80: 30 30 20 2d 3e 20 31 34 36 0a 2a 2a 20 20 20 20 00 -> 146.**
5c90: 20 20 33 20 2d 3e 20 31 36 20 20 20 20 20 20 20 3 -> 16
5ca0: 20 20 20 20 20 31 30 30 20 2d 3e 20 36 36 20 20 100 -> 66
5cb0: 20 20 20 20 20 20 31 30 30 30 30 30 30 20 2d 3e 1000000 ->
5cc0: 20 31 39 39 0a 2a 2a 20 20 20 20 20 20 34 20 2d 199.** 4 -
5cd0: 3e 20 32 30 20 20 20 20 20 20 20 20 20 20 20 31 > 20 1
5ce0: 30 30 30 20 2d 3e 20 39 39 20 20 20 20 20 20 20 000 -> 99
5cf0: 20 31 30 34 38 35 37 36 20 2d 3e 20 32 30 30 0a 1048576 -> 200.
5d00: 2a 2a 20 20 20 20 20 31 30 20 2d 3e 20 33 33 20 ** 10 -> 33
5d10: 20 20 20 20 20 20 20 20 20 20 31 30 32 34 20 2d 1024 -
5d20: 3e 20 31 30 30 20 20 20 20 34 32 39 34 39 36 37 > 100 4294967
5d30: 32 39 36 20 2d 3e 20 33 32 30 0a 2a 2a 0a 2a 2a 296 -> 320.**.**
5d40: 20 54 68 65 20 4c 6f 67 45 73 74 20 63 61 6e 20 The LogEst can
5d50: 62 65 20 6e 65 67 61 74 69 76 65 20 74 6f 20 69 be negative to i
5d60: 6e 64 69 63 61 74 65 20 66 72 61 63 74 69 6f 6e ndicate fraction
5d70: 61 6c 20 76 61 6c 75 65 73 2e 0a 2a 2a 20 45 78 al values..** Ex
5d80: 61 6d 70 6c 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 amples:.**.**
5d90: 20 30 2e 35 20 2d 3e 20 2d 31 30 20 20 20 20 20 0.5 -> -10
5da0: 20 20 20 20 20 20 30 2e 31 20 2d 3e 20 2d 33 33 0.1 -> -33
5db0: 20 20 20 20 20 20 20 20 30 2e 30 36 32 35 20 2d 0.0625 -
5dc0: 3e 20 2d 34 30 0a 2a 2f 0a 74 79 70 65 64 65 66 > -40.*/.typedef
5dd0: 20 49 4e 54 31 36 5f 54 59 50 45 20 4c 6f 67 45 INT16_TYPE LogE
5de0: 73 74 3b 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 st;../*.** Set t
5df0: 68 65 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a he SQLITE_PTRSIZ
5e00: 45 20 6d 61 63 72 6f 20 74 6f 20 74 68 65 20 6e E macro to the n
5e10: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 umber of bytes i
5e20: 6e 20 61 20 70 6f 69 6e 74 65 72 0a 2a 2f 0a 23 n a pointer.*/.#
5e30: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 50 54 ifndef SQLITE_PT
5e40: 52 53 49 5a 45 0a 23 20 69 66 20 64 65 66 69 6e RSIZE.# if defin
5e50: 65 64 28 5f 5f 53 49 5a 45 4f 46 5f 50 4f 49 4e ed(__SIZEOF_POIN
5e60: 54 45 52 5f 5f 29 0a 23 20 20 20 64 65 66 69 6e TER__).# defin
5e70: 65 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 e SQLITE_PTRSIZE
5e80: 20 5f 5f 53 49 5a 45 4f 46 5f 50 4f 49 4e 54 45 __SIZEOF_POINTE
5e90: 52 5f 5f 0a 23 20 65 6c 69 66 20 64 65 66 69 6e R__.# elif defin
5ea0: 65 64 28 69 33 38 36 29 20 20 20 20 20 7c 7c 20 ed(i386) ||
5eb0: 64 65 66 69 6e 65 64 28 5f 5f 69 33 38 36 5f 5f defined(__i386__
5ec0: 29 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f ) || defined(_
5ed0: 4d 5f 49 58 38 36 29 20 7c 7c 20 20 20 20 5c 0a M_IX86) || \.
5ee0: 20 20 20 20 20 20 20 64 65 66 69 6e 65 64 28 5f defined(_
5ef0: 4d 5f 41 52 4d 29 20 20 20 7c 7c 20 64 65 66 69 M_ARM) || defi
5f00: 6e 65 64 28 5f 5f 61 72 6d 5f 5f 29 20 20 20 20 ned(__arm__)
5f10: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 78 38 36 || defined(__x86
5f20: 29 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c ).# define SQL
5f30: 49 54 45 5f 50 54 52 53 49 5a 45 20 34 0a 23 20 ITE_PTRSIZE 4.#
5f40: 65 6c 73 65 0a 23 20 20 20 64 65 66 69 6e 65 20 else.# define
5f50: 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 20 38 SQLITE_PTRSIZE 8
5f60: 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a .# endif.#endif.
5f70: 0a 2f 2a 20 54 68 65 20 75 70 74 72 20 74 79 70 ./* The uptr typ
5f80: 65 20 69 73 20 61 6e 20 75 6e 73 69 67 6e 65 64 e is an unsigned
5f90: 20 69 6e 74 65 67 65 72 20 6c 61 72 67 65 20 65 integer large e
5fa0: 6e 6f 75 67 68 20 74 6f 20 68 6f 6c 64 20 61 20 nough to hold a
5fb0: 70 6f 69 6e 74 65 72 0a 2a 2f 0a 23 69 66 20 64 pointer.*/.#if d
5fc0: 65 66 69 6e 65 64 28 48 41 56 45 5f 53 54 44 49 efined(HAVE_STDI
5fd0: 4e 54 5f 48 29 0a 20 20 74 79 70 65 64 65 66 20 NT_H). typedef
5fe0: 75 69 6e 74 70 74 72 5f 74 20 75 70 74 72 3b 0a uintptr_t uptr;.
5ff0: 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 50 54 52 #elif SQLITE_PTR
6000: 53 49 5a 45 3d 3d 34 0a 20 20 74 79 70 65 64 65 SIZE==4. typede
6010: 66 20 75 33 32 20 75 70 74 72 3b 0a 23 65 6c 73 f u32 uptr;.#els
6020: 65 0a 20 20 74 79 70 65 64 65 66 20 75 36 34 20 e. typedef u64
6030: 75 70 74 72 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a uptr;.#endif../*
6040: 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 57 .** The SQLITE_W
6050: 49 54 48 49 4e 28 50 2c 53 2c 45 29 20 6d 61 63 ITHIN(P,S,E) mac
6060: 72 6f 20 63 68 65 63 6b 73 20 74 6f 20 73 65 65 ro checks to see
6070: 20 69 66 20 70 6f 69 6e 74 65 72 20 50 20 70 6f if pointer P po
6080: 69 6e 74 73 20 74 6f 0a 2a 2a 20 73 6f 6d 65 74 ints to.** somet
6090: 68 69 6e 67 20 62 65 74 77 65 65 6e 20 53 20 28 hing between S (
60a0: 69 6e 63 6c 75 73 69 76 65 29 20 61 6e 64 20 45 inclusive) and E
60b0: 20 28 65 78 63 6c 75 73 69 76 65 29 2e 0a 2a 2a (exclusive)..**
60c0: 0a 2a 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 .** In other wor
60d0: 64 73 2c 20 53 20 69 73 20 61 20 62 75 66 66 65 ds, S is a buffe
60e0: 72 20 61 6e 64 20 45 20 69 73 20 61 20 70 6f 69 r and E is a poi
60f0: 6e 74 65 72 20 74 6f 20 74 68 65 20 66 69 72 73 nter to the firs
6100: 74 20 62 79 74 65 20 61 66 74 65 72 0a 2a 2a 20 t byte after.**
6110: 74 68 65 20 65 6e 64 20 6f 66 20 62 75 66 66 65 the end of buffe
6120: 72 20 53 2e 20 20 54 68 69 73 20 6d 61 63 72 6f r S. This macro
6130: 20 72 65 74 75 72 6e 73 20 74 72 75 65 20 69 66 returns true if
6140: 20 50 20 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d P points to som
6150: 65 74 68 69 6e 67 0a 2a 2a 20 63 6f 6e 74 61 69 ething.** contai
6160: 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 62 ned within the b
6170: 75 66 66 65 72 20 53 2e 0a 2a 2f 0a 23 64 65 66 uffer S..*/.#def
6180: 69 6e 65 20 53 51 4c 49 54 45 5f 57 49 54 48 49 ine SQLITE_WITHI
6190: 4e 28 50 2c 53 2c 45 29 20 28 28 28 75 70 74 72 N(P,S,E) (((uptr
61a0: 29 28 50 29 3e 3d 28 75 70 74 72 29 28 53 29 29 )(P)>=(uptr)(S))
61b0: 26 26 28 28 75 70 74 72 29 28 50 29 3c 28 75 70 &&((uptr)(P)<(up
61c0: 74 72 29 28 45 29 29 29 0a 0a 0a 2f 2a 0a 2a 2a tr)(E))).../*.**
61d0: 20 4d 61 63 72 6f 73 20 74 6f 20 64 65 74 65 72 Macros to deter
61e0: 6d 69 6e 65 20 77 68 65 74 68 65 72 20 74 68 65 mine whether the
61f0: 20 6d 61 63 68 69 6e 65 20 69 73 20 62 69 67 20 machine is big
6200: 6f 72 20 6c 69 74 74 6c 65 20 65 6e 64 69 61 6e or little endian
6210: 2c 0a 2a 2a 20 61 6e 64 20 77 68 65 74 68 65 72 ,.** and whether
6220: 20 6f 72 20 6e 6f 74 20 74 68 61 74 20 64 65 74 or not that det
6230: 65 72 6d 69 6e 61 74 69 6f 6e 20 69 73 20 72 75 ermination is ru
6240: 6e 2d 74 69 6d 65 20 6f 72 20 63 6f 6d 70 69 6c n-time or compil
6250: 65 2d 74 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f e-time..**.** Fo
6260: 72 20 62 65 73 74 20 70 65 72 66 6f 72 6d 61 6e r best performan
6270: 63 65 2c 20 61 6e 20 61 74 74 65 6d 70 74 20 69 ce, an attempt i
6280: 73 20 6d 61 64 65 20 74 6f 20 67 75 65 73 73 20 s made to guess
6290: 61 74 20 74 68 65 20 62 79 74 65 2d 6f 72 64 65 at the byte-orde
62a0: 72 0a 2a 2a 20 75 73 69 6e 67 20 43 2d 70 72 65 r.** using C-pre
62b0: 70 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 73 processor macros
62c0: 2e 20 20 49 66 20 74 68 61 74 20 69 73 20 75 6e . If that is un
62d0: 73 75 63 63 65 73 73 66 75 6c 2c 20 6f 72 20 69 successful, or i
62e0: 66 0a 2a 2a 20 2d 44 53 51 4c 49 54 45 5f 52 55 f.** -DSQLITE_RU
62f0: 4e 54 49 4d 45 5f 42 59 54 45 4f 52 44 45 52 3d NTIME_BYTEORDER=
6300: 31 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 62 1 is set, then b
6310: 79 74 65 2d 6f 72 64 65 72 20 69 73 20 64 65 74 yte-order is det
6320: 65 72 6d 69 6e 65 64 0a 2a 2a 20 61 74 20 72 75 ermined.** at ru
6330: 6e 2d 74 69 6d 65 2e 0a 2a 2f 0a 23 69 66 20 28 n-time..*/.#if (
6340: 64 65 66 69 6e 65 64 28 69 33 38 36 29 20 20 20 defined(i386)
6350: 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 69 || defined(__i
6360: 33 38 36 5f 5f 29 20 20 20 7c 7c 20 64 65 66 69 386__) || defi
6370: 6e 65 64 28 5f 4d 5f 49 58 38 36 29 20 7c 7c 20 ned(_M_IX86) ||
6380: 20 20 20 5c 0a 20 20 20 20 20 64 65 66 69 6e 65 \. define
6390: 64 28 5f 5f 78 38 36 5f 36 34 29 20 7c 7c 20 64 d(__x86_64) || d
63a0: 65 66 69 6e 65 64 28 5f 5f 78 38 36 5f 36 34 5f efined(__x86_64_
63b0: 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4d _) || defined(_M
63c0: 5f 58 36 34 29 20 20 7c 7c 20 20 20 20 5c 0a 20 _X64) || \.
63d0: 20 20 20 20 64 65 66 69 6e 65 64 28 5f 4d 5f 41 defined(_M_A
63e0: 4d 44 36 34 29 20 7c 7c 20 64 65 66 69 6e 65 64 MD64) || defined
63f0: 28 5f 4d 5f 41 52 4d 29 20 20 20 20 20 7c 7c 20 (_M_ARM) ||
6400: 64 65 66 69 6e 65 64 28 5f 5f 78 38 36 29 20 20 defined(__x86)
6410: 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 64 65 || \. de
6420: 66 69 6e 65 64 28 5f 5f 61 72 6d 5f 5f 29 29 20 fined(__arm__))
6430: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
6440: 54 45 5f 52 55 4e 54 49 4d 45 5f 42 59 54 45 4f TE_RUNTIME_BYTEO
6450: 52 44 45 52 29 0a 23 20 64 65 66 69 6e 65 20 53 RDER).# define S
6460: 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 20 QLITE_BYTEORDER
6470: 20 20 20 31 32 33 34 0a 23 20 64 65 66 69 6e 65 1234.# define
6480: 20 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 SQLITE_BIGENDIA
6490: 4e 20 20 20 20 30 0a 23 20 64 65 66 69 6e 65 20 N 0.# define
64a0: 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 SQLITE_LITTLEEND
64b0: 49 41 4e 20 31 0a 23 20 64 65 66 69 6e 65 20 53 IAN 1.# define S
64c0: 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 QLITE_UTF16NATIV
64d0: 45 20 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c E SQLITE_UTF16L
64e0: 45 0a 23 65 6e 64 69 66 0a 23 69 66 20 28 64 65 E.#endif.#if (de
64f0: 66 69 6e 65 64 28 73 70 61 72 63 29 20 20 20 20 fined(sparc)
6500: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 70 70 63 || defined(__ppc
6510: 5f 5f 29 29 20 20 5c 0a 20 20 20 20 26 26 20 21 __)) \. && !
6520: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 52 defined(SQLITE_R
6530: 55 4e 54 49 4d 45 5f 42 59 54 45 4f 52 44 45 52 UNTIME_BYTEORDER
6540: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
6550: 45 5f 42 59 54 45 4f 52 44 45 52 20 20 20 20 34 E_BYTEORDER 4
6560: 33 32 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 321.# define SQL
6570: 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 20 20 ITE_BIGENDIAN
6580: 20 31 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 1.# define SQLI
6590: 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 4e 20 TE_LITTLEENDIAN
65a0: 30 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 0.# define SQLIT
65b0: 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 20 53 E_UTF16NATIVE S
65c0: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 0a 23 65 QLITE_UTF16BE.#e
65d0: 6e 64 69 66 0a 23 69 66 20 21 64 65 66 69 6e 65 ndif.#if !define
65e0: 64 28 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 d(SQLITE_BYTEORD
65f0: 45 52 29 0a 23 20 69 66 64 65 66 20 53 51 4c 49 ER).# ifdef SQLI
6600: 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a TE_AMALGAMATION.
6610: 20 20 63 6f 6e 73 74 20 69 6e 74 20 73 71 6c 69 const int sqli
6620: 74 65 33 6f 6e 65 20 3d 20 31 3b 0a 23 20 65 6c te3one = 1;.# el
6630: 73 65 0a 20 20 65 78 74 65 72 6e 20 63 6f 6e 73 se. extern cons
6640: 74 20 69 6e 74 20 73 71 6c 69 74 65 33 6f 6e 65 t int sqlite3one
6650: 3b 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 66 69 ;.# endif.# defi
6660: 6e 65 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 ne SQLITE_BYTEOR
6670: 44 45 52 20 20 20 20 30 20 20 20 20 20 2f 2a 20 DER 0 /*
6680: 30 20 6d 65 61 6e 73 20 22 75 6e 6b 6e 6f 77 6e 0 means "unknown
6690: 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 at compile-time
66a0: 22 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 " */.# define SQ
66b0: 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 20 LITE_BIGENDIAN
66c0: 20 20 28 2a 28 63 68 61 72 20 2a 29 28 26 73 71 (*(char *)(&sq
66d0: 6c 69 74 65 33 6f 6e 65 29 3d 3d 30 29 0a 23 20 lite3one)==0).#
66e0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 define SQLITE_LI
66f0: 54 54 4c 45 45 4e 44 49 41 4e 20 28 2a 28 63 68 TTLEENDIAN (*(ch
6700: 61 72 20 2a 29 28 26 73 71 6c 69 74 65 33 6f 6e ar *)(&sqlite3on
6710: 65 29 3d 3d 31 29 0a 23 20 64 65 66 69 6e 65 20 e)==1).# define
6720: 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 SQLITE_UTF16NATI
6730: 56 45 20 20 28 53 51 4c 49 54 45 5f 42 49 47 45 VE (SQLITE_BIGE
6740: 4e 44 49 41 4e 3f 53 51 4c 49 54 45 5f 55 54 46 NDIAN?SQLITE_UTF
6750: 31 36 42 45 3a 53 51 4c 49 54 45 5f 55 54 46 31 16BE:SQLITE_UTF1
6760: 36 4c 45 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 6LE).#endif../*.
6770: 2a 2a 20 43 6f 6e 73 74 61 6e 74 73 20 66 6f 72 ** Constants for
6780: 20 74 68 65 20 6c 61 72 67 65 73 74 20 61 6e 64 the largest and
6790: 20 73 6d 61 6c 6c 65 73 74 20 70 6f 73 73 69 62 smallest possib
67a0: 6c 65 20 36 34 2d 62 69 74 20 73 69 67 6e 65 64 le 64-bit signed
67b0: 20 69 6e 74 65 67 65 72 73 2e 0a 2a 2a 20 54 68 integers..** Th
67c0: 65 73 65 20 6d 61 63 72 6f 73 20 61 72 65 20 64 ese macros are d
67d0: 65 73 69 67 6e 65 64 20 74 6f 20 77 6f 72 6b 20 esigned to work
67e0: 63 6f 72 72 65 63 74 6c 79 20 6f 6e 20 62 6f 74 correctly on bot
67f0: 68 20 33 32 2d 62 69 74 20 61 6e 64 20 36 34 2d h 32-bit and 64-
6800: 62 69 74 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 73 bit.** compilers
6810: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4c 41 52 ..*/.#define LAR
6820: 47 45 53 54 5f 49 4e 54 36 34 20 20 28 30 78 66 GEST_INT64 (0xf
6830: 66 66 66 66 66 66 66 7c 28 28 28 69 36 34 29 30 fffffff|(((i64)0
6840: 78 37 66 66 66 66 66 66 66 29 3c 3c 33 32 29 29 x7fffffff)<<32))
6850: 0a 23 64 65 66 69 6e 65 20 53 4d 41 4c 4c 45 53 .#define SMALLES
6860: 54 5f 49 4e 54 36 34 20 28 28 28 69 36 34 29 2d T_INT64 (((i64)-
6870: 31 29 20 2d 20 4c 41 52 47 45 53 54 5f 49 4e 54 1) - LARGEST_INT
6880: 36 34 29 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 6e 64 64)../*.** Round
6890: 20 75 70 20 61 20 6e 75 6d 62 65 72 20 74 6f 20 up a number to
68a0: 74 68 65 20 6e 65 78 74 20 6c 61 72 67 65 72 20 the next larger
68b0: 6d 75 6c 74 69 70 6c 65 20 6f 66 20 38 2e 20 20 multiple of 8.
68c0: 54 68 69 73 20 69 73 20 75 73 65 64 0a 2a 2a 20 This is used.**
68d0: 74 6f 20 66 6f 72 63 65 20 38 2d 62 79 74 65 20 to force 8-byte
68e0: 61 6c 69 67 6e 6d 65 6e 74 20 6f 6e 20 36 34 2d alignment on 64-
68f0: 62 69 74 20 61 72 63 68 69 74 65 63 74 75 72 65 bit architecture
6900: 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 52 4f s..*/.#define RO
6910: 55 4e 44 38 28 78 29 20 20 20 20 20 28 28 28 78 UND8(x) (((x
6920: 29 2b 37 29 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 )+7)&~7)../*.**
6930: 52 6f 75 6e 64 20 64 6f 77 6e 20 74 6f 20 74 68 Round down to th
6940: 65 20 6e 65 61 72 65 73 74 20 6d 75 6c 74 69 70 e nearest multip
6950: 6c 65 20 6f 66 20 38 0a 2a 2f 0a 23 64 65 66 69 le of 8.*/.#defi
6960: 6e 65 20 52 4f 55 4e 44 44 4f 57 4e 38 28 78 29 ne ROUNDDOWN8(x)
6970: 20 28 28 78 29 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a ((x)&~7)../*.**
6980: 20 41 73 73 65 72 74 20 74 68 61 74 20 74 68 65 Assert that the
6990: 20 70 6f 69 6e 74 65 72 20 58 20 69 73 20 61 6c pointer X is al
69a0: 69 67 6e 65 64 20 74 6f 20 61 6e 20 38 2d 62 79 igned to an 8-by
69b0: 74 65 20 62 6f 75 6e 64 61 72 79 2e 20 20 54 68 te boundary. Th
69c0: 69 73 0a 2a 2a 20 6d 61 63 72 6f 20 69 73 20 75 is.** macro is u
69d0: 73 65 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 sed only within
69e0: 61 73 73 65 72 74 28 29 20 74 6f 20 76 65 72 69 assert() to veri
69f0: 66 79 20 74 68 61 74 20 74 68 65 20 63 6f 64 65 fy that the code
6a00: 20 67 65 74 73 0a 2a 2a 20 61 6c 6c 20 61 6c 69 gets.** all ali
6a10: 67 6e 6d 65 6e 74 20 72 65 73 74 72 69 63 74 69 gnment restricti
6a20: 6f 6e 73 20 63 6f 72 72 65 63 74 2e 0a 2a 2a 0a ons correct..**.
6a30: 2a 2a 20 45 78 63 65 70 74 2c 20 69 66 20 53 51 ** Except, if SQ
6a40: 4c 49 54 45 5f 34 5f 42 59 54 45 5f 41 4c 49 47 LITE_4_BYTE_ALIG
6a50: 4e 45 44 5f 4d 41 4c 4c 4f 43 20 69 73 20 64 65 NED_MALLOC is de
6a60: 66 69 6e 65 64 2c 20 74 68 65 6e 20 74 68 65 0a fined, then the.
6a70: 2a 2a 20 75 6e 64 65 72 6c 79 69 6e 67 20 6d 61 ** underlying ma
6a80: 6c 6c 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 lloc() implement
6a90: 61 74 69 6f 6e 20 6d 69 67 68 74 20 72 65 74 75 ation might retu
6aa0: 72 6e 20 75 73 20 34 2d 62 79 74 65 20 61 6c 69 rn us 4-byte ali
6ab0: 67 6e 65 64 0a 2a 2a 20 70 6f 69 6e 74 65 72 73 gned.** pointers
6ac0: 2e 20 20 49 6e 20 74 68 61 74 20 63 61 73 65 2c . In that case,
6ad0: 20 6f 6e 6c 79 20 76 65 72 69 66 79 20 34 2d 62 only verify 4-b
6ae0: 79 74 65 20 61 6c 69 67 6e 6d 65 6e 74 2e 0a 2a yte alignment..*
6af0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
6b00: 34 5f 42 59 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 4_BYTE_ALIGNED_M
6b10: 41 4c 4c 4f 43 0a 23 20 64 65 66 69 6e 65 20 45 ALLOC.# define E
6b20: 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e 4d IGHT_BYTE_ALIGNM
6b30: 45 4e 54 28 58 29 20 20 20 28 28 28 28 63 68 61 ENT(X) ((((cha
6b40: 72 2a 29 28 58 29 20 2d 20 28 63 68 61 72 2a 29 r*)(X) - (char*)
6b50: 30 29 26 33 29 3d 3d 30 29 0a 23 65 6c 73 65 0a 0)&3)==0).#else.
6b60: 23 20 64 65 66 69 6e 65 20 45 49 47 48 54 5f 42 # define EIGHT_B
6b70: 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 29 YTE_ALIGNMENT(X)
6b80: 20 20 20 28 28 28 28 63 68 61 72 2a 29 28 58 29 ((((char*)(X)
6b90: 20 2d 20 28 63 68 61 72 2a 29 30 29 26 37 29 3d - (char*)0)&7)=
6ba0: 3d 30 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a =0).#endif../*.*
6bb0: 2a 20 44 69 73 61 62 6c 65 20 4d 4d 41 50 20 6f * Disable MMAP o
6bc0: 6e 20 70 6c 61 74 66 6f 72 6d 73 20 77 68 65 72 n platforms wher
6bd0: 65 20 69 74 20 69 73 20 6b 6e 6f 77 6e 20 74 6f e it is known to
6be0: 20 6e 6f 74 20 77 6f 72 6b 0a 2a 2f 0a 23 69 66 not work.*/.#if
6bf0: 20 64 65 66 69 6e 65 64 28 5f 5f 4f 70 65 6e 42 defined(__OpenB
6c00: 53 44 5f 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 SD__) || defined
6c10: 28 5f 5f 51 4e 58 4e 54 4f 5f 5f 29 0a 23 20 75 (__QNXNTO__).# u
6c20: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f ndef SQLITE_MAX_
6c30: 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 MMAP_SIZE.# defi
6c40: 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d ne SQLITE_MAX_MM
6c50: 41 50 5f 53 49 5a 45 20 30 0a 23 65 6e 64 69 66 AP_SIZE 0.#endif
6c60: 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 61 75 6c 74 20 ../*.** Default
6c70: 6d 61 78 69 6d 75 6d 20 73 69 7a 65 20 6f 66 20 maximum size of
6c80: 6d 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 6d memory used by m
6c90: 65 6d 6f 72 79 2d 6d 61 70 70 65 64 20 49 2f 4f emory-mapped I/O
6ca0: 20 69 6e 20 74 68 65 20 56 46 53 0a 2a 2f 0a 23 in the VFS.*/.#
6cb0: 69 66 64 65 66 20 5f 5f 41 50 50 4c 45 5f 5f 0a ifdef __APPLE__.
6cc0: 23 20 69 6e 63 6c 75 64 65 20 3c 54 61 72 67 65 # include <Targe
6cd0: 74 43 6f 6e 64 69 74 69 6f 6e 61 6c 73 2e 68 3e tConditionals.h>
6ce0: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
6cf0: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
6d00: 53 49 5a 45 0a 23 20 69 66 20 64 65 66 69 6e 65 SIZE.# if define
6d10: 64 28 5f 5f 6c 69 6e 75 78 5f 5f 29 20 5c 0a 20 d(__linux__) \.
6d20: 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 57 49 4e || defined(_WIN
6d30: 33 32 29 20 5c 0a 20 20 7c 7c 20 28 64 65 66 69 32) \. || (defi
6d40: 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 20 26 ned(__APPLE__) &
6d50: 26 20 64 65 66 69 6e 65 64 28 5f 5f 4d 41 43 48 & defined(__MACH
6d60: 5f 5f 29 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 __)) \. || defi
6d70: 6e 65 64 28 5f 5f 73 75 6e 29 20 5c 0a 20 20 7c ned(__sun) \. |
6d80: 7c 20 64 65 66 69 6e 65 64 28 5f 5f 46 72 65 65 | defined(__Free
6d90: 42 53 44 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 65 BSD__) \. || de
6da0: 66 69 6e 65 64 28 5f 5f 44 72 61 67 6f 6e 46 6c fined(__DragonFl
6db0: 79 5f 5f 29 0a 23 20 20 20 64 65 66 69 6e 65 20 y__).# define
6dc0: 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f SQLITE_MAX_MMAP_
6dd0: 53 49 5a 45 20 30 78 37 66 66 66 30 30 30 30 20 SIZE 0x7fff0000
6de0: 20 2f 2a 20 32 31 34 37 34 31 38 31 31 32 20 2a /* 2147418112 *
6df0: 2f 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 /.# else.# def
6e00: 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d ine SQLITE_MAX_M
6e10: 4d 41 50 5f 53 49 5a 45 20 30 0a 23 20 65 6e 64 MAP_SIZE 0.# end
6e20: 69 66 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 if.# define SQLI
6e30: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
6e40: 5f 78 63 20 31 20 2f 2a 20 65 78 63 6c 75 64 65 _xc 1 /* exclude
6e50: 20 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a 2f from ctime.c */
6e60: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
6e70: 68 65 20 64 65 66 61 75 6c 74 20 4d 4d 41 50 5f he default MMAP_
6e80: 53 49 5a 45 20 69 73 20 7a 65 72 6f 20 6f 6e 20 SIZE is zero on
6e90: 61 6c 6c 20 70 6c 61 74 66 6f 72 6d 73 2e 20 20 all platforms.
6ea0: 4f 72 2c 20 65 76 65 6e 20 69 66 20 61 20 6c 61 Or, even if a la
6eb0: 72 67 65 72 0a 2a 2a 20 64 65 66 61 75 6c 74 20 rger.** default
6ec0: 4d 4d 41 50 5f 53 49 5a 45 20 69 73 20 73 70 65 MMAP_SIZE is spe
6ed0: 63 69 66 69 65 64 20 61 74 20 63 6f 6d 70 69 6c cified at compil
6ee0: 65 2d 74 69 6d 65 2c 20 6d 61 6b 65 20 73 75 72 e-time, make sur
6ef0: 65 20 74 68 61 74 20 69 74 20 64 6f 65 73 0a 2a e that it does.*
6f00: 2a 20 6e 6f 74 20 65 78 63 65 65 64 20 74 68 65 * not exceed the
6f10: 20 6d 61 78 69 6d 75 6d 20 6d 6d 61 70 20 73 69 maximum mmap si
6f20: 7a 65 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ze..*/.#ifndef S
6f30: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d QLITE_DEFAULT_MM
6f40: 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e 65 AP_SIZE.# define
6f50: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
6f60: 4d 4d 41 50 5f 53 49 5a 45 20 30 0a 23 20 64 65 MMAP_SIZE 0.# de
6f70: 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 fine SQLITE_DEFA
6f80: 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 5f 78 63 ULT_MMAP_SIZE_xc
6f90: 20 31 20 20 2f 2a 20 45 78 63 6c 75 64 65 20 66 1 /* Exclude f
6fa0: 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a 2f 0a 23 rom ctime.c */.#
6fb0: 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 45 endif.#if SQLITE
6fc0: 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 _DEFAULT_MMAP_SI
6fd0: 5a 45 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d ZE>SQLITE_MAX_MM
6fe0: 41 50 5f 53 49 5a 45 0a 23 20 75 6e 64 65 66 20 AP_SIZE.# undef
6ff0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
7000: 4d 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e MAP_SIZE.# defin
7010: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
7020: 5f 4d 4d 41 50 5f 53 49 5a 45 20 53 51 4c 49 54 _MMAP_SIZE SQLIT
7030: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a E_MAX_MMAP_SIZE.
7040: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f 6e #endif../*.** On
7050: 6c 79 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 45 ly one of SQLITE
7060: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 20 6f 72 _ENABLE_STAT3 or
7070: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
7080: 54 41 54 34 20 63 61 6e 20 62 65 20 64 65 66 69 TAT4 can be defi
7090: 6e 65 64 2e 0a 2a 2a 20 50 72 69 6f 72 69 74 79 ned..** Priority
70a0: 20 69 73 20 67 69 76 65 6e 20 74 6f 20 53 51 4c is given to SQL
70b0: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 ITE_ENABLE_STAT4
70c0: 2e 20 20 49 66 20 65 69 74 68 65 72 20 61 72 65 . If either are
70d0: 20 64 65 66 69 6e 65 64 2c 20 61 6c 73 6f 0a 2a defined, also.*
70e0: 2a 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f * define SQLITE_
70f0: 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f ENABLE_STAT3_OR_
7100: 53 54 41 54 34 0a 2a 2f 0a 23 69 66 64 65 66 20 STAT4.*/.#ifdef
7110: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
7120: 41 54 34 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 AT4.# undef SQLI
7130: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 0a TE_ENABLE_STAT3.
7140: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
7150: 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f ENABLE_STAT3_OR_
7160: 53 54 41 54 34 20 31 0a 23 65 6c 69 66 20 53 51 STAT4 1.#elif SQ
7170: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
7180: 33 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 3.# define SQLIT
7190: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f E_ENABLE_STAT3_O
71a0: 52 5f 53 54 41 54 34 20 31 0a 23 65 6c 69 66 20 R_STAT4 1.#elif
71b0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
71c0: 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 23 20 75 AT3_OR_STAT4.# u
71d0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 ndef SQLITE_ENAB
71e0: 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 LE_STAT3_OR_STAT
71f0: 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4.#endif../*.**
7200: 53 45 4c 45 43 54 54 52 41 43 45 5f 45 4e 41 42 SELECTTRACE_ENAB
7210: 4c 45 44 20 77 69 6c 6c 20 62 65 20 65 69 74 68 LED will be eith
7220: 65 72 20 31 20 6f 72 20 30 20 64 65 70 65 6e 64 er 1 or 0 depend
7230: 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 72 20 6f ing on whether o
7240: 72 20 6e 6f 74 0a 2a 2a 20 74 68 65 20 53 65 6c r not.** the Sel
7250: 65 63 74 20 71 75 65 72 79 20 67 65 6e 65 72 61 ect query genera
7260: 74 6f 72 20 74 72 61 63 69 6e 67 20 6c 6f 67 69 tor tracing logi
7270: 63 20 69 73 20 74 75 72 6e 65 64 20 6f 6e 2e 0a c is turned on..
7280: 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
7290: 51 4c 49 54 45 5f 44 45 42 55 47 29 20 7c 7c 20 QLITE_DEBUG) ||
72a0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 defined(SQLITE_E
72b0: 4e 41 42 4c 45 5f 53 45 4c 45 43 54 54 52 41 43 NABLE_SELECTTRAC
72c0: 45 29 0a 23 20 64 65 66 69 6e 65 20 53 45 4c 45 E).# define SELE
72d0: 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 CTTRACE_ENABLED
72e0: 31 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 1.#else.# define
72f0: 20 53 45 4c 45 43 54 54 52 41 43 45 5f 45 4e 41 SELECTTRACE_ENA
7300: 42 4c 45 44 20 30 0a 23 65 6e 64 69 66 0a 0a 2f BLED 0.#endif../
7310: 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
7320: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
7330: 67 20 73 74 72 75 63 74 75 72 65 20 69 73 20 75 g structure is u
7340: 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 sed to store the
7350: 20 62 75 73 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a busy-handler.**
7360: 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 61 20 callback for a
7370: 67 69 76 65 6e 20 73 71 6c 69 74 65 20 68 61 6e given sqlite han
7380: 64 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 dle..**.** The s
7390: 71 6c 69 74 65 2e 62 75 73 79 48 61 6e 64 6c 65 qlite.busyHandle
73a0: 72 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 65 20 r member of the
73b0: 73 71 6c 69 74 65 20 73 74 72 75 63 74 20 63 6f sqlite struct co
73c0: 6e 74 61 69 6e 73 20 74 68 65 20 62 75 73 79 0a ntains the busy.
73d0: 2a 2a 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 ** callback for
73e0: 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61 6e the database han
73f0: 64 6c 65 2e 20 45 61 63 68 20 70 61 67 65 72 20 dle. Each pager
7400: 6f 70 65 6e 65 64 20 76 69 61 20 74 68 65 20 73 opened via the s
7410: 71 6c 69 74 65 0a 2a 2a 20 68 61 6e 64 6c 65 20 qlite.** handle
7420: 69 73 20 70 61 73 73 65 64 20 61 20 70 6f 69 6e is passed a poin
7430: 74 65 72 20 74 6f 20 73 71 6c 69 74 65 2e 62 75 ter to sqlite.bu
7440: 73 79 48 61 6e 64 6c 65 72 2e 20 54 68 65 20 62 syHandler. The b
7450: 75 73 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 usy-handler.** c
7460: 61 6c 6c 62 61 63 6b 20 69 73 20 63 75 72 72 65 allback is curre
7470: 6e 74 6c 79 20 69 6e 76 6f 6b 65 64 20 6f 6e 6c ntly invoked onl
7480: 79 20 66 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 y from within pa
7490: 67 65 72 2e 63 2e 0a 2a 2f 0a 74 79 70 65 64 65 ger.c..*/.typede
74a0: 66 20 73 74 72 75 63 74 20 42 75 73 79 48 61 6e f struct BusyHan
74b0: 64 6c 65 72 20 42 75 73 79 48 61 6e 64 6c 65 72 dler BusyHandler
74c0: 3b 0a 73 74 72 75 63 74 20 42 75 73 79 48 61 6e ;.struct BusyHan
74d0: 64 6c 65 72 20 7b 0a 20 20 69 6e 74 20 28 2a 78 dler {. int (*x
74e0: 46 75 6e 63 29 28 76 6f 69 64 20 2a 2c 69 6e 74 Func)(void *,int
74f0: 29 3b 20 20 2f 2a 20 54 68 65 20 62 75 73 79 20 ); /* The busy
7500: 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f callback */. vo
7510: 69 64 20 2a 70 41 72 67 3b 20 20 20 20 20 20 20 id *pArg;
7520: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 /* Firs
7530: 74 20 61 72 67 20 74 6f 20 62 75 73 79 20 63 61 t arg to busy ca
7540: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 llback */. int
7550: 6e 42 75 73 79 3b 20 20 20 20 20 20 20 20 20 20 nBusy;
7560: 20 20 20 20 20 20 20 2f 2a 20 49 6e 63 72 65 6d /* Increm
7570: 65 6e 74 65 64 20 77 69 74 68 20 65 61 63 68 20 ented with each
7580: 62 75 73 79 20 63 61 6c 6c 20 2a 2f 0a 7d 3b 0a busy call */.};.
7590: 0a 2f 2a 0a 2a 2a 20 4e 61 6d 65 20 6f 66 20 74 ./*.** Name of t
75a0: 68 65 20 6d 61 73 74 65 72 20 64 61 74 61 62 61 he master databa
75b0: 73 65 20 74 61 62 6c 65 2e 20 20 54 68 65 20 6d se table. The m
75c0: 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 74 aster database t
75d0: 61 62 6c 65 0a 2a 2a 20 69 73 20 61 20 73 70 65 able.** is a spe
75e0: 63 69 61 6c 20 74 61 62 6c 65 20 74 68 61 74 20 cial table that
75f0: 68 6f 6c 64 73 20 74 68 65 20 6e 61 6d 65 73 20 holds the names
7600: 61 6e 64 20 61 74 74 72 69 62 75 74 65 73 20 6f and attributes o
7610: 66 20 61 6c 6c 0a 2a 2a 20 75 73 65 72 20 74 61 f all.** user ta
7620: 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 73 bles and indices
7630: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 ..*/.#define MAS
7640: 54 45 52 5f 4e 41 4d 45 20 20 20 20 20 20 20 22 TER_NAME "
7650: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 22 0a 23 sqlite_master".#
7660: 64 65 66 69 6e 65 20 54 45 4d 50 5f 4d 41 53 54 define TEMP_MAST
7670: 45 52 5f 4e 41 4d 45 20 20 22 73 71 6c 69 74 65 ER_NAME "sqlite
7680: 5f 74 65 6d 70 5f 6d 61 73 74 65 72 22 0a 0a 2f _temp_master"../
7690: 2a 0a 2a 2a 20 54 68 65 20 72 6f 6f 74 2d 70 61 *.** The root-pa
76a0: 67 65 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 ge of the master
76b0: 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e database table.
76c0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 54 .*/.#define MAST
76d0: 45 52 5f 52 4f 4f 54 20 20 20 20 20 20 20 31 0a ER_ROOT 1.
76e0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e 61 6d 65 20 ./*.** The name
76f0: 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 74 61 of the schema ta
7700: 62 6c 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ble..*/.#define
7710: 53 43 48 45 4d 41 5f 54 41 42 4c 45 28 78 29 20 SCHEMA_TABLE(x)
7720: 20 28 28 21 4f 4d 49 54 5f 54 45 4d 50 44 42 29 ((!OMIT_TEMPDB)
7730: 26 26 28 78 3d 3d 31 29 3f 54 45 4d 50 5f 4d 41 &&(x==1)?TEMP_MA
7740: 53 54 45 52 5f 4e 41 4d 45 3a 4d 41 53 54 45 52 STER_NAME:MASTER
7750: 5f 4e 41 4d 45 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 _NAME)../*.** A
7760: 63 6f 6e 76 65 6e 69 65 6e 63 65 20 6d 61 63 72 convenience macr
7770: 6f 20 74 68 61 74 20 72 65 74 75 72 6e 73 20 74 o that returns t
7780: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6c 65 he number of ele
7790: 6d 65 6e 74 73 20 69 6e 0a 2a 2a 20 61 6e 20 61 ments in.** an a
77a0: 72 72 61 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 rray..*/.#define
77b0: 20 41 72 72 61 79 53 69 7a 65 28 58 29 20 20 20 ArraySize(X)
77c0: 20 28 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 58 ((int)(sizeof(X
77d0: 29 2f 73 69 7a 65 6f 66 28 58 5b 30 5d 29 29 29 )/sizeof(X[0])))
77e0: 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 6e ../*.** Determin
77f0: 65 20 69 66 20 74 68 65 20 61 72 67 75 6d 65 6e e if the argumen
7800: 74 20 69 73 20 61 20 70 6f 77 65 72 20 6f 66 20 t is a power of
7810: 74 77 6f 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 two.*/.#define I
7820: 73 50 6f 77 65 72 4f 66 54 77 6f 28 58 29 20 28 sPowerOfTwo(X) (
7830: 28 28 58 29 26 28 28 58 29 2d 31 29 29 3d 3d 30 ((X)&((X)-1))==0
7840: 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c )../*.** The fol
7850: 6c 6f 77 69 6e 67 20 76 61 6c 75 65 20 61 73 20 lowing value as
7860: 61 20 64 65 73 74 72 75 63 74 6f 72 20 6d 65 61 a destructor mea
7870: 6e 73 20 74 6f 20 75 73 65 20 73 71 6c 69 74 65 ns to use sqlite
7880: 33 44 62 46 72 65 65 28 29 2e 0a 2a 2a 20 54 68 3DbFree()..** Th
7890: 65 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 e sqlite3DbFree(
78a0: 29 20 72 6f 75 74 69 6e 65 20 72 65 71 75 69 72 ) routine requir
78b0: 65 73 20 74 77 6f 20 70 61 72 61 6d 65 74 65 72 es two parameter
78c0: 73 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 s instead of the
78d0: 0a 2a 2a 20 6f 6e 65 20 70 61 72 61 6d 65 74 65 .** one paramete
78e0: 72 20 74 68 61 74 20 64 65 73 74 72 75 63 74 6f r that destructo
78f0: 72 73 20 6e 6f 72 6d 61 6c 6c 79 20 77 61 6e 74 rs normally want
7900: 2e 20 20 53 6f 20 77 65 20 68 61 76 65 20 74 6f . So we have to
7910: 20 69 6e 74 72 6f 64 75 63 65 0a 2a 2a 20 74 68 introduce.** th
7920: 69 73 20 6d 61 67 69 63 20 76 61 6c 75 65 20 74 is magic value t
7930: 68 61 74 20 74 68 65 20 63 6f 64 65 20 6b 6e 6f hat the code kno
7940: 77 73 20 74 6f 20 68 61 6e 64 6c 65 20 64 69 66 ws to handle dif
7950: 66 65 72 65 6e 74 6c 79 2e 20 20 41 6e 79 0a 2a ferently. Any.*
7960: 2a 20 70 6f 69 6e 74 65 72 20 77 69 6c 6c 20 77 * pointer will w
7970: 6f 72 6b 20 68 65 72 65 20 61 73 20 6c 6f 6e 67 ork here as long
7980: 20 61 73 20 69 74 20 69 73 20 64 69 73 74 69 6e as it is distin
7990: 63 74 20 66 72 6f 6d 20 53 51 4c 49 54 45 5f 53 ct from SQLITE_S
79a0: 54 41 54 49 43 0a 2a 2a 20 61 6e 64 20 53 51 4c TATIC.** and SQL
79b0: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 2e 0a 2a ITE_TRANSIENT..*
79c0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
79d0: 5f 44 59 4e 41 4d 49 43 20 20 20 28 28 73 71 6c _DYNAMIC ((sql
79e0: 69 74 65 33 5f 64 65 73 74 72 75 63 74 6f 72 5f ite3_destructor_
79f0: 74 79 70 65 29 73 71 6c 69 74 65 33 4d 61 6c 6c type)sqlite3Mall
7a00: 6f 63 53 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 57 ocSize)../*.** W
7a10: 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f hen SQLITE_OMIT_
7a20: 57 53 44 20 69 73 20 64 65 66 69 6e 65 64 2c 20 WSD is defined,
7a30: 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 it means that th
7a40: 65 20 74 61 72 67 65 74 20 70 6c 61 74 66 6f 72 e target platfor
7a50: 6d 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 73 75 m does.** not su
7a60: 70 70 6f 72 74 20 57 72 69 74 61 62 6c 65 20 53 pport Writable S
7a70: 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 29 tatic Data (WSD)
7a80: 20 73 75 63 68 20 61 73 20 67 6c 6f 62 61 6c 20 such as global
7a90: 61 6e 64 20 73 74 61 74 69 63 20 76 61 72 69 61 and static varia
7aa0: 62 6c 65 73 2e 0a 2a 2a 20 41 6c 6c 20 76 61 72 bles..** All var
7ab0: 69 61 62 6c 65 73 20 6d 75 73 74 20 65 69 74 68 iables must eith
7ac0: 65 72 20 62 65 20 6f 6e 20 74 68 65 20 73 74 61 er be on the sta
7ad0: 63 6b 20 6f 72 20 64 79 6e 61 6d 69 63 61 6c 6c ck or dynamicall
7ae0: 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f 6d y allocated from
7af0: 0a 2a 2a 20 74 68 65 20 68 65 61 70 2e 20 20 57 .** the heap. W
7b00: 68 65 6e 20 57 53 44 20 69 73 20 75 6e 73 75 70 hen WSD is unsup
7b10: 70 6f 72 74 65 64 2c 20 74 68 65 20 76 61 72 69 ported, the vari
7b20: 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f 6e able declaration
7b30: 73 20 73 63 61 74 74 65 72 65 64 0a 2a 2a 20 74 s scattered.** t
7b40: 68 72 6f 75 67 68 6f 75 74 20 74 68 65 20 53 51 hroughout the SQ
7b50: 4c 69 74 65 20 63 6f 64 65 20 6d 75 73 74 20 62 Lite code must b
7b60: 65 63 6f 6d 65 20 63 6f 6e 73 74 61 6e 74 73 20 ecome constants
7b70: 69 6e 73 74 65 61 64 2e 20 20 54 68 65 20 53 51 instead. The SQ
7b80: 4c 49 54 45 5f 57 53 44 0a 2a 2a 20 6d 61 63 72 LITE_WSD.** macr
7b90: 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 o is used for th
7ba0: 69 73 20 70 75 72 70 6f 73 65 2e 20 20 41 6e 64 is purpose. And
7bb0: 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 66 65 instead of refe
7bc0: 72 65 6e 63 69 6e 67 20 74 68 65 20 76 61 72 69 rencing the vari
7bd0: 61 62 6c 65 0a 2a 2a 20 64 69 72 65 63 74 6c 79 able.** directly
7be0: 2c 20 77 65 20 75 73 65 20 69 74 73 20 63 6f 6e , we use its con
7bf0: 73 74 61 6e 74 20 61 73 20 61 20 6b 65 79 20 74 stant as a key t
7c00: 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 72 75 6e o lookup the run
7c10: 2d 74 69 6d 65 20 61 6c 6c 6f 63 61 74 65 64 0a -time allocated.
7c20: 2a 2a 20 62 75 66 66 65 72 20 74 68 61 74 20 68 ** buffer that h
7c30: 6f 6c 64 73 20 72 65 61 6c 20 76 61 72 69 61 62 olds real variab
7c40: 6c 65 2e 20 20 54 68 65 20 63 6f 6e 73 74 61 6e le. The constan
7c50: 74 20 69 73 20 61 6c 73 6f 20 74 68 65 20 69 6e t is also the in
7c60: 69 74 69 61 6c 69 7a 65 72 0a 2a 2a 20 66 6f 72 itializer.** for
7c70: 20 74 68 65 20 72 75 6e 2d 74 69 6d 65 20 61 6c the run-time al
7c80: 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e 0a located buffer..
7c90: 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 75 73 75 **.** In the usu
7ca0: 61 6c 20 63 61 73 65 20 77 68 65 72 65 20 57 53 al case where WS
7cb0: 44 20 69 73 20 73 75 70 70 6f 72 74 65 64 2c 20 D is supported,
7cc0: 74 68 65 20 53 51 4c 49 54 45 5f 57 53 44 20 61 the SQLITE_WSD a
7cd0: 6e 64 20 47 4c 4f 42 41 4c 0a 2a 2a 20 6d 61 63 nd GLOBAL.** mac
7ce0: 72 6f 73 20 62 65 63 6f 6d 65 20 6e 6f 2d 6f 70 ros become no-op
7cf0: 73 20 61 6e 64 20 68 61 76 65 20 7a 65 72 6f 20 s and have zero
7d00: 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70 61 performance impa
7d10: 63 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ct..*/.#ifdef SQ
7d20: 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 LITE_OMIT_WSD.
7d30: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 57 #define SQLITE_W
7d40: 53 44 20 63 6f 6e 73 74 0a 20 20 23 64 65 66 69 SD const. #defi
7d50: 6e 65 20 47 4c 4f 42 41 4c 28 74 2c 76 29 20 28 ne GLOBAL(t,v) (
7d60: 2a 28 74 2a 29 73 71 6c 69 74 65 33 5f 77 73 64 *(t*)sqlite3_wsd
7d70: 5f 66 69 6e 64 28 28 76 6f 69 64 2a 29 26 28 76 _find((void*)&(v
7d80: 29 2c 20 73 69 7a 65 6f 66 28 76 29 29 29 0a 20 ), sizeof(v))).
7d90: 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
7da0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20 47 4c 4f GlobalConfig GLO
7db0: 42 41 4c 28 73 74 72 75 63 74 20 53 71 6c 69 74 BAL(struct Sqlit
7dc0: 65 33 43 6f 6e 66 69 67 2c 20 73 71 6c 69 74 65 e3Config, sqlite
7dd0: 33 43 6f 6e 66 69 67 29 0a 20 20 69 6e 74 20 73 3Config). int s
7de0: 71 6c 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 28 qlite3_wsd_init(
7df0: 69 6e 74 20 4e 2c 20 69 6e 74 20 4a 29 3b 0a 20 int N, int J);.
7e00: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 77 void *sqlite3_w
7e10: 73 64 5f 66 69 6e 64 28 76 6f 69 64 20 2a 4b 2c sd_find(void *K,
7e20: 20 69 6e 74 20 4c 29 3b 0a 23 65 6c 73 65 0a 20 int L);.#else.
7e30: 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f #define SQLITE_
7e40: 57 53 44 0a 20 20 23 64 65 66 69 6e 65 20 47 4c WSD. #define GL
7e50: 4f 42 41 4c 28 74 2c 76 29 20 76 0a 20 20 23 64 OBAL(t,v) v. #d
7e60: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 6c 6f efine sqlite3Glo
7e70: 62 61 6c 43 6f 6e 66 69 67 20 73 71 6c 69 74 65 balConfig sqlite
7e80: 33 43 6f 6e 66 69 67 0a 23 65 6e 64 69 66 0a 0a 3Config.#endif..
7e90: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow
7ea0: 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 65 20 75 ing macros are u
7eb0: 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 20 sed to suppress
7ec0: 63 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e 67 compiler warning
7ed0: 73 20 61 6e 64 20 74 6f 0a 2a 2a 20 6d 61 6b 65 s and to.** make
7ee0: 20 69 74 20 63 6c 65 61 72 20 74 6f 20 68 75 6d it clear to hum
7ef0: 61 6e 20 72 65 61 64 65 72 73 20 77 68 65 6e 20 an readers when
7f00: 61 20 66 75 6e 63 74 69 6f 6e 20 70 61 72 61 6d a function param
7f10: 65 74 65 72 20 69 73 20 64 65 6c 69 62 65 72 61 eter is delibera
7f20: 74 65 6c 79 0a 2a 2a 20 6c 65 66 74 20 75 6e 75 tely.** left unu
7f30: 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 62 sed within the b
7f40: 6f 64 79 20 6f 66 20 61 20 66 75 6e 63 74 69 6f ody of a functio
7f50: 6e 2e 20 54 68 69 73 20 75 73 75 61 6c 6c 79 20 n. This usually
7f60: 68 61 70 70 65 6e 73 20 77 68 65 6e 0a 2a 2a 20 happens when.**
7f70: 61 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 a function is ca
7f80: 6c 6c 65 64 20 76 69 61 20 61 20 66 75 6e 63 74 lled via a funct
7f90: 69 6f 6e 20 70 6f 69 6e 74 65 72 2e 20 46 6f 72 ion pointer. For
7fa0: 20 65 78 61 6d 70 6c 65 20 74 68 65 0a 2a 2a 20 example the.**
7fb0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f implementation o
7fc0: 66 20 61 6e 20 53 51 4c 20 61 67 67 72 65 67 61 f an SQL aggrega
7fd0: 74 65 20 73 74 65 70 20 63 61 6c 6c 62 61 63 6b te step callback
7fe0: 20 6d 61 79 20 6e 6f 74 20 75 73 65 20 74 68 65 may not use the
7ff0: 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 69 6e .** parameter in
8000: 64 69 63 61 74 69 6e 67 20 74 68 65 20 6e 75 6d dicating the num
8010: 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 ber of arguments
8020: 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 61 passed to the a
8030: 67 67 72 65 67 61 74 65 2c 0a 2a 2a 20 69 66 20 ggregate,.** if
8040: 69 74 20 6b 6e 6f 77 73 20 74 68 61 74 20 74 68 it knows that th
8050: 69 73 20 69 73 20 65 6e 66 6f 72 63 65 64 20 65 is is enforced e
8060: 6c 73 65 77 68 65 72 65 2e 0a 2a 2a 0a 2a 2a 20 lsewhere..**.**
8070: 57 68 65 6e 20 61 20 66 75 6e 63 74 69 6f 6e 20 When a function
8080: 70 61 72 61 6d 65 74 65 72 20 69 73 20 6e 6f 74 parameter is not
8090: 20 75 73 65 64 20 61 74 20 61 6c 6c 20 77 69 74 used at all wit
80a0: 68 69 6e 20 74 68 65 20 62 6f 64 79 20 6f 66 20 hin the body of
80b0: 61 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 69 a function,.** i
80c0: 74 20 69 73 20 67 65 6e 65 72 61 6c 6c 79 20 6e t is generally n
80d0: 61 6d 65 64 20 22 4e 6f 74 55 73 65 64 22 20 6f amed "NotUsed" o
80e0: 72 20 22 4e 6f 74 55 73 65 64 32 22 20 74 6f 20 r "NotUsed2" to
80f0: 6d 61 6b 65 20 74 68 69 6e 67 73 20 65 76 65 6e make things even
8100: 20 63 6c 65 61 72 65 72 2e 0a 2a 2a 20 48 6f 77 clearer..** How
8110: 65 76 65 72 2c 20 74 68 65 73 65 20 6d 61 63 72 ever, these macr
8120: 6f 73 20 6d 61 79 20 61 6c 73 6f 20 62 65 20 75 os may also be u
8130: 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 20 sed to suppress
8140: 77 61 72 6e 69 6e 67 73 20 72 65 6c 61 74 65 64 warnings related
8150: 20 74 6f 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 to.** parameter
8160: 73 20 74 68 61 74 20 6d 61 79 20 6f 72 20 6d 61 s that may or ma
8170: 79 20 6e 6f 74 20 62 65 20 75 73 65 64 20 64 65 y not be used de
8180: 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f 6d 70 69 pending on compi
8190: 6c 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 2e 0a lation options..
81a0: 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 20 74 ** For example t
81b0: 68 6f 73 65 20 70 61 72 61 6d 65 74 65 72 73 20 hose parameters
81c0: 6f 6e 6c 79 20 75 73 65 64 20 69 6e 20 61 73 73 only used in ass
81d0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
81e0: 2e 20 49 6e 20 74 68 65 73 65 0a 2a 2a 20 63 61 . In these.** ca
81f0: 73 65 73 20 74 68 65 20 70 61 72 61 6d 65 74 65 ses the paramete
8200: 72 73 20 61 72 65 20 6e 61 6d 65 64 20 61 73 20 rs are named as
8210: 70 65 72 20 74 68 65 20 75 73 75 61 6c 20 63 6f per the usual co
8220: 6e 76 65 6e 74 69 6f 6e 73 2e 0a 2a 2f 0a 23 64 nventions..*/.#d
8230: 65 66 69 6e 65 20 55 4e 55 53 45 44 5f 50 41 52 efine UNUSED_PAR
8240: 41 4d 45 54 45 52 28 78 29 20 28 76 6f 69 64 29 AMETER(x) (void)
8250: 28 78 29 0a 23 64 65 66 69 6e 65 20 55 4e 55 53 (x).#define UNUS
8260: 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 78 2c ED_PARAMETER2(x,
8270: 79 29 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 y) UNUSED_PARAME
8280: 54 45 52 28 78 29 2c 55 4e 55 53 45 44 5f 50 41 TER(x),UNUSED_PA
8290: 52 41 4d 45 54 45 52 28 79 29 0a 0a 2f 2a 0a 2a RAMETER(y)../*.*
82a0: 2a 20 46 6f 72 77 61 72 64 20 72 65 66 65 72 65 * Forward refere
82b0: 6e 63 65 73 20 74 6f 20 73 74 72 75 63 74 75 72 nces to structur
82c0: 65 73 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 es.*/.typedef st
82d0: 72 75 63 74 20 41 67 67 49 6e 66 6f 20 41 67 67 ruct AggInfo Agg
82e0: 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 74 Info;.typedef st
82f0: 72 75 63 74 20 41 75 74 68 43 6f 6e 74 65 78 74 ruct AuthContext
8300: 20 41 75 74 68 43 6f 6e 74 65 78 74 3b 0a 74 79 AuthContext;.ty
8310: 70 65 64 65 66 20 73 74 72 75 63 74 20 41 75 74 pedef struct Aut
8320: 6f 69 6e 63 49 6e 66 6f 20 41 75 74 6f 69 6e 63 oincInfo Autoinc
8330: 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 73 74 Info;.typedef st
8340: 72 75 63 74 20 42 69 74 76 65 63 20 42 69 74 76 ruct Bitvec Bitv
8350: 65 63 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 ec;.typedef stru
8360: 63 74 20 43 6f 6c 6c 53 65 71 20 43 6f 6c 6c 53 ct CollSeq CollS
8370: 65 71 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 eq;.typedef stru
8380: 63 74 20 43 6f 6c 75 6d 6e 20 43 6f 6c 75 6d 6e ct Column Column
8390: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 ;.typedef struct
83a0: 20 44 62 20 44 62 3b 0a 74 79 70 65 64 65 66 20 Db Db;.typedef
83b0: 73 74 72 75 63 74 20 53 63 68 65 6d 61 20 53 63 struct Schema Sc
83c0: 68 65 6d 61 3b 0a 74 79 70 65 64 65 66 20 73 74 hema;.typedef st
83d0: 72 75 63 74 20 45 78 70 72 20 45 78 70 72 3b 0a ruct Expr Expr;.
83e0: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 45 typedef struct E
83f0: 78 70 72 4c 69 73 74 20 45 78 70 72 4c 69 73 74 xprList ExprList
8400: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 ;.typedef struct
8410: 20 45 78 70 72 53 70 61 6e 20 45 78 70 72 53 70 ExprSpan ExprSp
8420: 61 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 an;.typedef stru
8430: 63 74 20 46 4b 65 79 20 46 4b 65 79 3b 0a 74 79 ct FKey FKey;.ty
8440: 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 6e pedef struct Fun
8450: 63 44 65 73 74 72 75 63 74 6f 72 20 46 75 6e 63 cDestructor Func
8460: 44 65 73 74 72 75 63 74 6f 72 3b 0a 74 79 70 65 Destructor;.type
8470: 64 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 44 def struct FuncD
8480: 65 66 20 46 75 6e 63 44 65 66 3b 0a 74 79 70 65 ef FuncDef;.type
8490: 64 65 66 20 73 74 72 75 63 74 20 46 75 6e 63 44 def struct FuncD
84a0: 65 66 48 61 73 68 20 46 75 6e 63 44 65 66 48 61 efHash FuncDefHa
84b0: 73 68 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 sh;.typedef stru
84c0: 63 74 20 49 64 4c 69 73 74 20 49 64 4c 69 73 74 ct IdList IdList
84d0: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 ;.typedef struct
84e0: 20 49 6e 64 65 78 20 49 6e 64 65 78 3b 0a 74 79 Index Index;.ty
84f0: 70 65 64 65 66 20 73 74 72 75 63 74 20 49 6e 64 pedef struct Ind
8500: 65 78 53 61 6d 70 6c 65 20 49 6e 64 65 78 53 61 exSample IndexSa
8510: 6d 70 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 mple;.typedef st
8520: 72 75 63 74 20 4b 65 79 43 6c 61 73 73 20 4b 65 ruct KeyClass Ke
8530: 79 43 6c 61 73 73 3b 0a 74 79 70 65 64 65 66 20 yClass;.typedef
8540: 73 74 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 4b struct KeyInfo K
8550: 65 79 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 20 eyInfo;.typedef
8560: 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 69 64 65 struct Lookaside
8570: 20 4c 6f 6f 6b 61 73 69 64 65 3b 0a 74 79 70 65 Lookaside;.type
8580: 64 65 66 20 73 74 72 75 63 74 20 4c 6f 6f 6b 61 def struct Looka
8590: 73 69 64 65 53 6c 6f 74 20 4c 6f 6f 6b 61 73 69 sideSlot Lookasi
85a0: 64 65 53 6c 6f 74 3b 0a 74 79 70 65 64 65 66 20 deSlot;.typedef
85b0: 73 74 72 75 63 74 20 4d 6f 64 75 6c 65 20 4d 6f struct Module Mo
85c0: 64 75 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 dule;.typedef st
85d0: 72 75 63 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 ruct NameContext
85e0: 20 4e 61 6d 65 43 6f 6e 74 65 78 74 3b 0a 74 79 NameContext;.ty
85f0: 70 65 64 65 66 20 73 74 72 75 63 74 20 50 61 72 pedef struct Par
8600: 73 65 20 50 61 72 73 65 3b 0a 74 79 70 65 64 65 se Parse;.typede
8610: 66 20 73 74 72 75 63 74 20 50 72 65 55 70 64 61 f struct PreUpda
8620: 74 65 20 50 72 65 55 70 64 61 74 65 3b 0a 74 79 te PreUpdate;.ty
8630: 70 65 64 65 66 20 73 74 72 75 63 74 20 50 72 69 pedef struct Pri
8640: 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 50 72 69 ntfArguments Pri
8650: 6e 74 66 41 72 67 75 6d 65 6e 74 73 3b 0a 74 79 ntfArguments;.ty
8660: 70 65 64 65 66 20 73 74 72 75 63 74 20 52 6f 77 pedef struct Row
8670: 53 65 74 20 52 6f 77 53 65 74 3b 0a 74 79 70 65 Set RowSet;.type
8680: 64 65 66 20 73 74 72 75 63 74 20 53 61 76 65 70 def struct Savep
8690: 6f 69 6e 74 20 53 61 76 65 70 6f 69 6e 74 3b 0a oint Savepoint;.
86a0: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 typedef struct S
86b0: 65 6c 65 63 74 20 53 65 6c 65 63 74 3b 0a 74 79 elect Select;.ty
86c0: 70 65 64 65 66 20 73 74 72 75 63 74 20 53 51 4c pedef struct SQL
86d0: 69 74 65 54 68 72 65 61 64 20 53 51 4c 69 74 65 iteThread SQLite
86e0: 54 68 72 65 61 64 3b 0a 74 79 70 65 64 65 66 20 Thread;.typedef
86f0: 73 74 72 75 63 74 20 53 65 6c 65 63 74 44 65 73 struct SelectDes
8700: 74 20 53 65 6c 65 63 74 44 65 73 74 3b 0a 74 79 t SelectDest;.ty
8710: 70 65 64 65 66 20 73 74 72 75 63 74 20 53 72 63 pedef struct Src
8720: 4c 69 73 74 20 53 72 63 4c 69 73 74 3b 0a 74 79 List SrcList;.ty
8730: 70 65 64 65 66 20 73 74 72 75 63 74 20 53 74 72 pedef struct Str
8740: 41 63 63 75 6d 20 53 74 72 41 63 63 75 6d 3b 0a Accum StrAccum;.
8750: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 54 typedef struct T
8760: 61 62 6c 65 20 54 61 62 6c 65 3b 0a 74 79 70 65 able Table;.type
8770: 64 65 66 20 73 74 72 75 63 74 20 54 61 62 6c 65 def struct Table
8780: 4c 6f 63 6b 20 54 61 62 6c 65 4c 6f 63 6b 3b 0a Lock TableLock;.
8790: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 54 typedef struct T
87a0: 6f 6b 65 6e 20 54 6f 6b 65 6e 3b 0a 74 79 70 65 oken Token;.type
87b0: 64 65 66 20 73 74 72 75 63 74 20 54 72 65 65 56 def struct TreeV
87c0: 69 65 77 20 54 72 65 65 56 69 65 77 3b 0a 74 79 iew TreeView;.ty
87d0: 70 65 64 65 66 20 73 74 72 75 63 74 20 54 72 69 pedef struct Tri
87e0: 67 67 65 72 20 54 72 69 67 67 65 72 3b 0a 74 79 gger Trigger;.ty
87f0: 70 65 64 65 66 20 73 74 72 75 63 74 20 54 72 69 pedef struct Tri
8800: 67 67 65 72 50 72 67 20 54 72 69 67 67 65 72 50 ggerPrg TriggerP
8810: 72 67 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 rg;.typedef stru
8820: 63 74 20 54 72 69 67 67 65 72 53 74 65 70 20 54 ct TriggerStep T
8830: 72 69 67 67 65 72 53 74 65 70 3b 0a 74 79 70 65 riggerStep;.type
8840: 64 65 66 20 73 74 72 75 63 74 20 55 6e 70 61 63 def struct Unpac
8850: 6b 65 64 52 65 63 6f 72 64 20 55 6e 70 61 63 6b kedRecord Unpack
8860: 65 64 52 65 63 6f 72 64 3b 0a 74 79 70 65 64 65 edRecord;.typede
8870: 66 20 73 74 72 75 63 74 20 56 54 61 62 6c 65 20 f struct VTable
8880: 56 54 61 62 6c 65 3b 0a 74 79 70 65 64 65 66 20 VTable;.typedef
8890: 73 74 72 75 63 74 20 56 74 61 62 43 74 78 20 56 struct VtabCtx V
88a0: 74 61 62 43 74 78 3b 0a 74 79 70 65 64 65 66 20 tabCtx;.typedef
88b0: 73 74 72 75 63 74 20 57 61 6c 6b 65 72 20 57 61 struct Walker Wa
88c0: 6c 6b 65 72 3b 0a 74 79 70 65 64 65 66 20 73 74 lker;.typedef st
88d0: 72 75 63 74 20 57 68 65 72 65 49 6e 66 6f 20 57 ruct WhereInfo W
88e0: 68 65 72 65 49 6e 66 6f 3b 0a 74 79 70 65 64 65 hereInfo;.typede
88f0: 66 20 73 74 72 75 63 74 20 57 69 74 68 20 57 69 f struct With Wi
8900: 74 68 3b 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 65 72 th;../*.** Defer
8910: 20 73 6f 75 72 63 69 6e 67 20 76 64 62 65 2e 68 sourcing vdbe.h
8920: 20 61 6e 64 20 62 74 72 65 65 2e 68 20 75 6e 74 and btree.h unt
8930: 69 6c 20 61 66 74 65 72 20 74 68 65 20 22 75 38 il after the "u8
8940: 22 20 61 6e 64 0a 2a 2a 20 22 42 75 73 79 48 61 " and.** "BusyHa
8950: 6e 64 6c 65 72 22 20 74 79 70 65 64 65 66 73 2e ndler" typedefs.
8960: 20 76 64 62 65 2e 68 20 61 6c 73 6f 20 72 65 71 vdbe.h also req
8970: 75 69 72 65 73 20 61 20 66 65 77 20 6f 66 20 74 uires a few of t
8980: 68 65 20 6f 70 61 71 75 65 0a 2a 2a 20 70 6f 69 he opaque.** poi
8990: 6e 74 65 72 20 74 79 70 65 73 20 28 69 2e 65 2e nter types (i.e.
89a0: 20 46 75 6e 63 44 65 66 29 20 64 65 66 69 6e 65 FuncDef) define
89b0: 64 20 61 62 6f 76 65 2e 0a 2a 2f 0a 23 69 6e 63 d above..*/.#inc
89c0: 6c 75 64 65 20 22 62 74 72 65 65 2e 68 22 0a 23 lude "btree.h".#
89d0: 69 6e 63 6c 75 64 65 20 22 76 64 62 65 2e 68 22 include "vdbe.h"
89e0: 0a 23 69 6e 63 6c 75 64 65 20 22 70 61 67 65 72 .#include "pager
89f0: 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 70 63 .h".#include "pc
8a00: 61 63 68 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 ache.h".#include
8a10: 20 22 6f 73 2e 68 22 0a 23 69 6e 63 6c 75 64 65 "os.h".#include
8a20: 20 22 6d 75 74 65 78 2e 68 22 0a 0a 2f 2a 20 54 "mutex.h"../* T
8a30: 68 65 20 53 51 4c 49 54 45 5f 45 58 54 52 41 5f he SQLITE_EXTRA_
8a40: 44 55 52 41 42 4c 45 20 63 6f 6d 70 69 6c 65 2d DURABLE compile-
8a50: 74 69 6d 65 20 6f 70 74 69 6f 6e 20 75 73 65 64 time option used
8a60: 20 74 6f 20 73 65 74 20 74 68 65 20 64 65 66 61 to set the defa
8a70: 75 6c 74 0a 2a 2a 20 73 79 6e 63 68 72 6f 6e 6f ult.** synchrono
8a80: 75 73 20 73 65 74 74 69 6e 67 20 74 6f 20 45 58 us setting to EX
8a90: 54 52 41 2e 20 20 49 74 20 69 73 20 6e 6f 20 6c TRA. It is no l
8aa0: 6f 6e 67 65 72 20 73 75 70 70 6f 72 74 65 64 2e onger supported.
8ab0: 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
8ac0: 45 5f 45 58 54 52 41 5f 44 55 52 41 42 4c 45 0a E_EXTRA_DURABLE.
8ad0: 23 20 77 61 72 6e 69 6e 67 20 55 73 65 20 53 51 # warning Use SQ
8ae0: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e LITE_DEFAULT_SYN
8af0: 43 48 52 4f 4e 4f 55 53 3d 33 20 69 6e 73 74 65 CHRONOUS=3 inste
8b00: 61 64 20 6f 66 20 53 51 4c 49 54 45 5f 45 58 54 ad of SQLITE_EXT
8b10: 52 41 5f 44 55 52 41 42 4c 45 0a 23 20 64 65 66 RA_DURABLE.# def
8b20: 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 ine SQLITE_DEFAU
8b30: 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 33 LT_SYNCHRONOUS 3
8b40: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 .#endif../*.** D
8b50: 65 66 61 75 6c 74 20 73 79 6e 63 68 72 6f 6e 6f efault synchrono
8b60: 75 73 20 6c 65 76 65 6c 73 2e 0a 2a 2a 0a 2a 2a us levels..**.**
8b70: 20 4e 6f 74 65 20 74 68 61 74 20 28 66 6f 72 20 Note that (for
8b80: 68 69 73 74 6f 72 63 61 6c 20 72 65 61 73 6f 6e historcal reason
8b90: 73 29 20 74 68 65 20 50 41 47 45 52 5f 53 59 4e s) the PAGER_SYN
8ba0: 43 48 52 4f 4e 4f 55 53 5f 2a 20 6d 61 63 72 6f CHRONOUS_* macro
8bb0: 73 20 64 69 66 66 65 72 0a 2a 2a 20 66 72 6f 6d s differ.** from
8bc0: 20 74 68 65 20 53 51 4c 49 54 45 5f 44 45 46 41 the SQLITE_DEFA
8bd0: 55 4c 54 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 ULT_SYNCHRONOUS
8be0: 76 61 6c 75 65 20 62 79 20 31 2e 0a 2a 2a 0a 2a value by 1..**.*
8bf0: 2a 20 20 20 20 20 20 20 20 20 20 20 50 41 47 45 * PAGE
8c00: 52 5f 53 59 4e 43 48 52 4f 4e 4f 55 53 20 20 20 R_SYNCHRONOUS
8c10: 20 20 20 20 44 45 46 41 55 4c 54 5f 53 59 4e 43 DEFAULT_SYNC
8c20: 48 52 4f 4e 4f 55 53 0a 2a 2a 20 20 20 4f 46 46 HRONOUS.** OFF
8c30: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20 1
8c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8c50: 20 20 20 20 20 30 0a 2a 2a 20 20 20 4e 4f 52 4d 0.** NORM
8c60: 41 4c 20 20 20 20 20 20 20 20 32 20 20 20 20 20 AL 2
8c70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8c80: 20 20 20 20 31 0a 2a 2a 20 20 20 46 55 4c 4c 20 1.** FULL
8c90: 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20 20 3
8ca0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8cb0: 20 20 20 32 0a 2a 2a 20 20 20 45 58 54 52 41 20 2.** EXTRA
8cc0: 20 20 20 20 20 20 20 20 34 20 20 20 20 20 20 20 4
8cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8ce0: 20 20 33 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22 50 3.**.** The "P
8cf0: 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f 75 RAGMA synchronou
8d00: 73 22 20 73 74 61 74 65 6d 65 6e 74 20 61 6c 73 s" statement als
8d10: 6f 20 75 73 65 73 20 74 68 65 20 7a 65 72 6f 2d o uses the zero-
8d20: 62 61 73 65 64 20 6e 75 6d 62 65 72 73 2e 0a 2a based numbers..*
8d30: 2a 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 * In other words
8d40: 2c 20 74 68 65 20 7a 65 72 6f 2d 62 61 73 65 64 , the zero-based
8d50: 20 6e 75 6d 62 65 72 73 20 61 72 65 20 75 73 65 numbers are use
8d60: 64 20 66 6f 72 20 61 6c 6c 20 65 78 74 65 72 6e d for all extern
8d70: 61 6c 20 69 6e 74 65 72 66 61 63 65 73 0a 2a 2a al interfaces.**
8d80: 20 61 6e 64 20 74 68 65 20 6f 6e 65 2d 62 61 73 and the one-bas
8d90: 65 64 20 76 61 6c 75 65 73 20 61 72 65 20 75 73 ed values are us
8da0: 65 64 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 0a 2a ed internally..*
8db0: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
8dc0: 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f _DEFAULT_SYNCHRO
8dd0: 4e 4f 55 53 0a 23 20 64 65 66 69 6e 65 20 53 51 NOUS.# define SQ
8de0: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 53 59 4e LITE_DEFAULT_SYN
8df0: 43 48 52 4f 4e 4f 55 53 20 28 50 41 47 45 52 5f CHRONOUS (PAGER_
8e00: 53 59 4e 43 48 52 4f 4e 4f 55 53 5f 46 55 4c 4c SYNCHRONOUS_FULL
8e10: 2d 31 29 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 -1).#endif.#ifnd
8e20: 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ef SQLITE_DEFAUL
8e30: 54 5f 57 41 4c 5f 53 59 4e 43 48 52 4f 4e 4f 55 T_WAL_SYNCHRONOU
8e40: 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 S.# define SQLIT
8e50: 45 5f 44 45 46 41 55 4c 54 5f 57 41 4c 5f 53 59 E_DEFAULT_WAL_SY
8e60: 4e 43 48 52 4f 4e 4f 55 53 20 53 51 4c 49 54 45 NCHRONOUS SQLITE
8e70: 5f 44 45 46 41 55 4c 54 5f 53 59 4e 43 48 52 4f _DEFAULT_SYNCHRO
8e80: 4e 4f 55 53 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a NOUS.#endif../*.
8e90: 2a 2a 20 45 61 63 68 20 64 61 74 61 62 61 73 65 ** Each database
8ea0: 20 66 69 6c 65 20 74 6f 20 62 65 20 61 63 63 65 file to be acce
8eb0: 73 73 65 64 20 62 79 20 74 68 65 20 73 79 73 74 ssed by the syst
8ec0: 65 6d 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 em is an instanc
8ed0: 65 0a 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c e.** of the foll
8ee0: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e owing structure.
8ef0: 20 20 54 68 65 72 65 20 61 72 65 20 6e 6f 72 6d There are norm
8f00: 61 6c 6c 79 20 74 77 6f 20 6f 66 20 74 68 65 73 ally two of thes
8f10: 65 20 73 74 72 75 63 74 75 72 65 73 0a 2a 2a 20 e structures.**
8f20: 69 6e 20 74 68 65 20 73 71 6c 69 74 65 2e 61 44 in the sqlite.aD
8f30: 62 5b 5d 20 61 72 72 61 79 2e 20 20 61 44 62 5b b[] array. aDb[
8f40: 30 5d 20 69 73 20 74 68 65 20 6d 61 69 6e 20 64 0] is the main d
8f50: 61 74 61 62 61 73 65 20 66 69 6c 65 20 61 6e 64 atabase file and
8f60: 0a 2a 2a 20 61 44 62 5b 31 5d 20 69 73 20 74 68 .** aDb[1] is th
8f70: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 e database file
8f80: 75 73 65 64 20 74 6f 20 68 6f 6c 64 20 74 65 6d used to hold tem
8f90: 70 6f 72 61 72 79 20 74 61 62 6c 65 73 2e 20 20 porary tables.
8fa0: 41 64 64 69 74 69 6f 6e 61 6c 0a 2a 2a 20 64 61 Additional.** da
8fb0: 74 61 62 61 73 65 73 20 6d 61 79 20 62 65 20 61 tabases may be a
8fc0: 74 74 61 63 68 65 64 2e 0a 2a 2f 0a 73 74 72 75 ttached..*/.stru
8fd0: 63 74 20 44 62 20 7b 0a 20 20 63 68 61 72 20 2a ct Db {. char *
8fe0: 7a 44 62 53 4e 61 6d 65 3b 20 20 20 20 20 20 2f zDbSName; /
8ff0: 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 64 * Name of this d
9000: 61 74 61 62 61 73 65 2e 20 28 73 63 68 65 6d 61 atabase. (schema
9010: 20 6e 61 6d 65 2c 20 6e 6f 74 20 66 69 6c 65 6e name, not filen
9020: 61 6d 65 29 20 2a 2f 0a 20 20 42 74 72 65 65 20 ame) */. Btree
9030: 2a 70 42 74 3b 20 20 20 20 20 20 20 20 20 20 2f *pBt; /
9040: 2a 20 54 68 65 20 42 2a 54 72 65 65 20 73 74 72 * The B*Tree str
9050: 75 63 74 75 72 65 20 66 6f 72 20 74 68 69 73 20 ucture for this
9060: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f database file */
9070: 0a 20 20 75 38 20 73 61 66 65 74 79 5f 6c 65 76 . u8 safety_lev
9080: 65 6c 3b 20 20 20 20 20 2f 2a 20 48 6f 77 20 61 el; /* How a
9090: 67 67 72 65 73 73 69 76 65 20 61 74 20 73 79 6e ggressive at syn
90a0: 63 69 6e 67 20 64 61 74 61 20 74 6f 20 64 69 73 cing data to dis
90b0: 6b 20 2a 2f 0a 20 20 75 38 20 62 53 79 6e 63 53 k */. u8 bSyncS
90c0: 65 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 et; /* T
90d0: 72 75 65 20 69 66 20 22 50 52 41 47 4d 41 20 73 rue if "PRAGMA s
90e0: 79 6e 63 68 72 6f 6e 6f 75 73 3d 4e 22 20 68 61 ynchronous=N" ha
90f0: 73 20 62 65 65 6e 20 72 75 6e 20 2a 2f 0a 20 20 s been run */.
9100: 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b Schema *pSchema;
9110: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
9120: 74 6f 20 64 61 74 61 62 61 73 65 20 73 63 68 65 to database sche
9130: 6d 61 20 28 70 6f 73 73 69 62 6c 79 20 73 68 61 ma (possibly sha
9140: 72 65 64 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a red) */.};../*.*
9150: 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
9160: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
9170: 74 72 75 63 74 75 72 65 20 73 74 6f 72 65 73 20 tructure stores
9180: 61 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d a database schem
9190: 61 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 73 74 20 53 63 a..**.** Most Sc
91a0: 68 65 6d 61 20 6f 62 6a 65 63 74 73 20 61 72 65 hema objects are
91b0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
91c0: 20 61 20 42 74 72 65 65 2e 20 20 54 68 65 20 65 a Btree. The e
91d0: 78 63 65 70 74 69 6f 6e 20 69 73 0a 2a 2a 20 74 xception is.** t
91e0: 68 65 20 53 63 68 65 6d 61 20 66 6f 72 20 74 68 he Schema for th
91f0: 65 20 54 45 4d 50 20 64 61 74 61 62 61 65 73 20 e TEMP databaes
9200: 28 73 71 6c 69 74 65 33 2e 61 44 62 5b 31 5d 29 (sqlite3.aDb[1])
9210: 20 77 68 69 63 68 20 69 73 20 66 72 65 65 2d 73 which is free-s
9220: 74 61 6e 64 69 6e 67 2e 0a 2a 2a 20 49 6e 20 73 tanding..** In s
9230: 68 61 72 65 64 20 63 61 63 68 65 20 6d 6f 64 65 hared cache mode
9240: 2c 20 61 20 73 69 6e 67 6c 65 20 53 63 68 65 6d , a single Schem
9250: 61 20 6f 62 6a 65 63 74 20 63 61 6e 20 62 65 20 a object can be
9260: 73 68 61 72 65 64 20 62 79 20 6d 75 6c 74 69 70 shared by multip
9270: 6c 65 0a 2a 2a 20 42 74 72 65 65 73 20 74 68 61 le.** Btrees tha
9280: 74 20 72 65 66 65 72 20 74 6f 20 74 68 65 20 73 t refer to the s
9290: 61 6d 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 42 ame underlying B
92a0: 74 53 68 61 72 65 64 20 6f 62 6a 65 63 74 2e 0a tShared object..
92b0: 2a 2a 0a 2a 2a 20 53 63 68 65 6d 61 20 6f 62 6a **.** Schema obj
92c0: 65 63 74 73 20 61 72 65 20 61 75 74 6f 6d 61 74 ects are automat
92d0: 69 63 61 6c 6c 79 20 64 65 61 6c 6c 6f 63 61 74 ically deallocat
92e0: 65 64 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 ed when the last
92f0: 20 42 74 72 65 65 20 74 68 61 74 0a 2a 2a 20 72 Btree that.** r
9300: 65 66 65 72 65 6e 63 65 73 20 74 68 65 6d 20 69 eferences them i
9310: 73 20 64 65 73 74 72 6f 79 65 64 2e 20 20 20 54 s destroyed. T
9320: 68 65 20 54 45 4d 50 20 53 63 68 65 6d 61 20 69 he TEMP Schema i
9330: 73 20 6d 61 6e 75 61 6c 6c 79 20 66 72 65 65 64 s manually freed
9340: 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 by.** sqlite3_c
9350: 6c 6f 73 65 28 29 2e 0a 2a 0a 2a 2a 20 41 20 74 lose()..*.** A t
9360: 68 72 65 61 64 20 6d 75 73 74 20 62 65 20 68 6f hread must be ho
9370: 6c 64 69 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e lding a mutex on
9380: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
9390: 6e 67 20 42 74 72 65 65 20 69 6e 20 6f 72 64 65 ng Btree in orde
93a0: 72 0a 2a 2a 20 74 6f 20 61 63 63 65 73 73 20 53 r.** to access S
93b0: 63 68 65 6d 61 20 63 6f 6e 74 65 6e 74 2e 20 20 chema content.
93c0: 54 68 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 This implies tha
93d0: 74 20 74 68 65 20 74 68 72 65 61 64 20 6d 75 73 t the thread mus
93e0: 74 20 61 6c 73 6f 20 62 65 0a 2a 2a 20 68 6f 6c t also be.** hol
93f0: 64 69 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e 20 ding a mutex on
9400: 74 68 65 20 73 71 6c 69 74 65 33 20 63 6f 6e 6e the sqlite3 conn
9410: 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 74 ection pointer t
9420: 68 61 74 20 6f 77 6e 73 20 74 68 65 20 42 74 72 hat owns the Btr
9430: 65 65 2e 0a 2a 2a 20 46 6f 72 20 61 20 54 45 4d ee..** For a TEM
9440: 50 20 53 63 68 65 6d 61 2c 20 6f 6e 6c 79 20 74 P Schema, only t
9450: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 he connection mu
9460: 74 65 78 20 69 73 20 72 65 71 75 69 72 65 64 2e tex is required.
9470: 0a 2a 2f 0a 73 74 72 75 63 74 20 53 63 68 65 6d .*/.struct Schem
9480: 61 20 7b 0a 20 20 69 6e 74 20 73 63 68 65 6d 61 a {. int schema
9490: 5f 63 6f 6f 6b 69 65 3b 20 20 20 2f 2a 20 44 61 _cookie; /* Da
94a0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 76 65 tabase schema ve
94b0: 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 66 6f 72 rsion number for
94c0: 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 this file */.
94d0: 69 6e 74 20 69 47 65 6e 65 72 61 74 69 6f 6e 3b int iGeneration;
94e0: 20 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 69 /* Generati
94f0: 6f 6e 20 63 6f 75 6e 74 65 72 2e 20 20 49 6e 63 on counter. Inc
9500: 72 65 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 remented with ea
9510: 63 68 20 63 68 61 6e 67 65 20 2a 2f 0a 20 20 48 ch change */. H
9520: 61 73 68 20 74 62 6c 48 61 73 68 3b 20 20 20 20 ash tblHash;
9530: 20 20 20 20 2f 2a 20 41 6c 6c 20 74 61 62 6c 65 /* All table
9540: 73 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d s indexed by nam
9550: 65 20 2a 2f 0a 20 20 48 61 73 68 20 69 64 78 48 e */. Hash idxH
9560: 61 73 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 ash; /* A
9570: 6c 6c 20 28 6e 61 6d 65 64 29 20 69 6e 64 69 63 ll (named) indic
9580: 65 73 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 es indexed by na
9590: 6d 65 20 2a 2f 0a 20 20 48 61 73 68 20 74 72 69 me */. Hash tri
95a0: 67 48 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 gHash; /*
95b0: 41 6c 6c 20 74 72 69 67 67 65 72 73 20 69 6e 64 All triggers ind
95c0: 65 78 65 64 20 62 79 20 6e 61 6d 65 20 2a 2f 0a exed by name */.
95d0: 20 20 48 61 73 68 20 66 6b 65 79 48 61 73 68 3b Hash fkeyHash;
95e0: 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 66 6f /* All fo
95f0: 72 65 69 67 6e 20 6b 65 79 73 20 62 79 20 72 65 reign keys by re
9600: 66 65 72 65 6e 63 65 64 20 74 61 62 6c 65 20 6e ferenced table n
9610: 61 6d 65 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a ame */. Table *
9620: 70 53 65 71 54 61 62 3b 20 20 20 20 20 20 2f 2a pSeqTab; /*
9630: 20 54 68 65 20 73 71 6c 69 74 65 5f 73 65 71 75 The sqlite_sequ
9640: 65 6e 63 65 20 74 61 62 6c 65 20 75 73 65 64 20 ence table used
9650: 62 79 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 by AUTOINCREMENT
9660: 20 2a 2f 0a 20 20 75 38 20 66 69 6c 65 5f 66 6f */. u8 file_fo
9670: 72 6d 61 74 3b 20 20 20 20 20 20 2f 2a 20 53 63 rmat; /* Sc
9680: 68 65 6d 61 20 66 6f 72 6d 61 74 20 76 65 72 73 hema format vers
9690: 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 66 69 6c ion for this fil
96a0: 65 20 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 e */. u8 enc;
96b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
96c0: 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 75 73 65 ext encoding use
96d0: 64 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 d by this databa
96e0: 73 65 20 2a 2f 0a 20 20 75 31 36 20 73 63 68 65 se */. u16 sche
96f0: 6d 61 46 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 maFlags; /*
9700: 46 6c 61 67 73 20 61 73 73 6f 63 69 61 74 65 64 Flags associated
9710: 20 77 69 74 68 20 74 68 69 73 20 73 63 68 65 6d with this schem
9720: 61 20 2a 2f 0a 20 20 69 6e 74 20 63 61 63 68 65 a */. int cache
9730: 5f 73 69 7a 65 3b 20 20 20 20 20 20 2f 2a 20 4e _size; /* N
9740: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 umber of pages t
9750: 6f 20 75 73 65 20 69 6e 20 74 68 65 20 63 61 63 o use in the cac
9760: 68 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 he */.};../*.**
9770: 54 68 65 73 65 20 6d 61 63 72 6f 73 20 63 61 6e These macros can
9780: 20 62 65 20 75 73 65 64 20 74 6f 20 74 65 73 74 be used to test
9790: 2c 20 73 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 , set, or clear
97a0: 62 69 74 73 20 69 6e 20 74 68 65 0a 2a 2a 20 44 bits in the.** D
97b0: 62 2e 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 b.pSchema->flags
97c0: 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 64 65 66 69 field..*/.#defi
97d0: 6e 65 20 44 62 48 61 73 50 72 6f 70 65 72 74 79 ne DbHasProperty
97e0: 28 44 2c 49 2c 50 29 20 20 20 20 20 28 28 28 44 (D,I,P) (((D
97f0: 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d )->aDb[I].pSchem
9800: 61 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 28 a->schemaFlags&(
9810: 50 29 29 3d 3d 28 50 29 29 0a 23 64 65 66 69 6e P))==(P)).#defin
9820: 65 20 44 62 48 61 73 41 6e 79 50 72 6f 70 65 72 e DbHasAnyProper
9830: 74 79 28 44 2c 49 2c 50 29 20 20 28 28 28 44 29 ty(D,I,P) (((D)
9840: 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 ->aDb[I].pSchema
9850: 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 28 50 ->schemaFlags&(P
9860: 29 29 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 44 ))!=0).#define D
9870: 62 53 65 74 50 72 6f 70 65 72 74 79 28 44 2c 49 bSetProperty(D,I
9880: 2c 50 29 20 20 20 20 20 28 44 29 2d 3e 61 44 62 ,P) (D)->aDb
9890: 5b 49 5d 2e 70 53 63 68 65 6d 61 2d 3e 73 63 68 [I].pSchema->sch
98a0: 65 6d 61 46 6c 61 67 73 7c 3d 28 50 29 0a 23 64 emaFlags|=(P).#d
98b0: 65 66 69 6e 65 20 44 62 43 6c 65 61 72 50 72 6f efine DbClearPro
98c0: 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 20 28 perty(D,I,P) (
98d0: 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 D)->aDb[I].pSche
98e0: 6d 61 2d 3e 73 63 68 65 6d 61 46 6c 61 67 73 26 ma->schemaFlags&
98f0: 3d 7e 28 50 29 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c =~(P)../*.** All
9900: 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 owed values for
9910: 74 68 65 20 44 42 2e 70 53 63 68 65 6d 61 2d 3e the DB.pSchema->
9920: 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a flags field..**.
9930: 2a 2a 20 54 68 65 20 44 42 5f 53 63 68 65 6d 61 ** The DB_Schema
9940: 4c 6f 61 64 65 64 20 66 6c 61 67 20 69 73 20 73 Loaded flag is s
9950: 65 74 20 61 66 74 65 72 20 74 68 65 20 64 61 74 et after the dat
9960: 61 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 abase schema has
9970: 20 62 65 65 6e 0a 2a 2a 20 72 65 61 64 20 69 6e been.** read in
9980: 74 6f 20 69 6e 74 65 72 6e 61 6c 20 68 61 73 68 to internal hash
9990: 20 74 61 62 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 44 tables..**.** D
99a0: 42 5f 55 6e 72 65 73 65 74 56 69 65 77 73 20 6d B_UnresetViews m
99b0: 65 61 6e 73 20 74 68 61 74 20 6f 6e 65 20 6f 72 eans that one or
99c0: 20 6d 6f 72 65 20 76 69 65 77 73 20 68 61 76 65 more views have
99d0: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 68 column names th
99e0: 61 74 0a 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 at.** have been
99f0: 66 69 6c 6c 65 64 20 6f 75 74 2e 20 20 49 66 20 filled out. If
9a00: 74 68 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 the schema chang
9a10: 65 73 2c 20 74 68 65 73 65 20 63 6f 6c 75 6d 6e es, these column
9a20: 20 6e 61 6d 65 73 20 6d 69 67 68 74 0a 2a 2a 20 names might.**
9a30: 63 68 61 6e 67 65 73 20 61 6e 64 20 73 6f 20 74 changes and so t
9a40: 68 65 20 76 69 65 77 20 77 69 6c 6c 20 6e 65 65 he view will nee
9a50: 64 20 74 6f 20 62 65 20 72 65 73 65 74 2e 0a 2a d to be reset..*
9a60: 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 53 63 68 /.#define DB_Sch
9a70: 65 6d 61 4c 6f 61 64 65 64 20 20 20 20 30 78 30 emaLoaded 0x0
9a80: 30 30 31 20 20 2f 2a 20 54 68 65 20 73 63 68 65 001 /* The sche
9a90: 6d 61 20 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 ma has been load
9aa0: 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 ed */.#define DB
9ab0: 5f 55 6e 72 65 73 65 74 56 69 65 77 73 20 20 20 _UnresetViews
9ac0: 20 30 78 30 30 30 32 20 20 2f 2a 20 53 6f 6d 65 0x0002 /* Some
9ad0: 20 76 69 65 77 73 20 68 61 76 65 20 64 65 66 69 views have defi
9ae0: 6e 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 ned column names
9af0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 45 */.#define DB_E
9b00: 6d 70 74 79 20 20 20 20 20 20 20 20 20 20 20 30 mpty 0
9b10: 78 30 30 30 34 20 20 2f 2a 20 54 68 65 20 66 69 x0004 /* The fi
9b20: 6c 65 20 69 73 20 65 6d 70 74 79 20 28 6c 65 6e le is empty (len
9b30: 67 74 68 20 30 20 62 79 74 65 73 29 20 2a 2f 0a gth 0 bytes) */.
9b40: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 ./*.** The numbe
9b50: 72 20 6f 66 20 64 69 66 66 65 72 65 6e 74 20 6b r of different k
9b60: 69 6e 64 73 20 6f 66 20 74 68 69 6e 67 73 20 74 inds of things t
9b70: 68 61 74 20 63 61 6e 20 62 65 20 6c 69 6d 69 74 hat can be limit
9b80: 65 64 0a 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 ed.** using the
9b90: 73 71 6c 69 74 65 33 5f 6c 69 6d 69 74 28 29 20 sqlite3_limit()
9ba0: 69 6e 74 65 72 66 61 63 65 2e 0a 2a 2f 0a 23 64 interface..*/.#d
9bb0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 5f 4c efine SQLITE_N_L
9bc0: 49 4d 49 54 20 28 53 51 4c 49 54 45 5f 4c 49 4d IMIT (SQLITE_LIM
9bd0: 49 54 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 IT_WORKER_THREAD
9be0: 53 2b 31 29 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 6b S+1)../*.** Look
9bf0: 61 73 69 64 65 20 6d 61 6c 6c 6f 63 20 69 73 20 aside malloc is
9c00: 61 20 73 65 74 20 6f 66 20 66 69 78 65 64 2d 73 a set of fixed-s
9c10: 69 7a 65 20 62 75 66 66 65 72 73 20 74 68 61 74 ize buffers that
9c20: 20 63 61 6e 20 62 65 20 75 73 65 64 0a 2a 2a 20 can be used.**
9c30: 74 6f 20 73 61 74 69 73 66 79 20 73 6d 61 6c 6c to satisfy small
9c40: 20 74 72 61 6e 73 69 65 6e 74 20 6d 65 6d 6f 72 transient memor
9c50: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 65 71 y allocation req
9c60: 75 65 73 74 73 20 66 6f 72 20 6f 62 6a 65 63 74 uests for object
9c70: 73 0a 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 s.** associated
9c80: 77 69 74 68 20 61 20 70 61 72 74 69 63 75 6c 61 with a particula
9c90: 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 r database conne
9ca0: 63 74 69 6f 6e 2e 20 20 54 68 65 20 75 73 65 20 ction. The use
9cb0: 6f 66 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 of.** lookaside
9cc0: 6d 61 6c 6c 6f 63 20 70 72 6f 76 69 64 65 73 20 malloc provides
9cd0: 61 20 73 69 67 6e 69 66 69 63 61 6e 74 20 70 65 a significant pe
9ce0: 72 66 6f 72 6d 61 6e 63 65 20 65 6e 68 61 6e 63 rformance enhanc
9cf0: 65 6d 65 6e 74 0a 2a 2a 20 28 61 70 70 72 6f 78 ement.** (approx
9d00: 20 31 30 25 29 20 62 79 20 61 76 6f 69 64 69 6e 10%) by avoidin
9d10: 67 20 6e 75 6d 65 72 6f 75 73 20 6d 61 6c 6c 6f g numerous mallo
9d20: 63 2f 66 72 65 65 20 72 65 71 75 65 73 74 73 20 c/free requests
9d30: 77 68 69 6c 65 20 70 61 72 73 69 6e 67 0a 2a 2a while parsing.**
9d40: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e SQL statements.
9d50: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4c 6f 6f 6b 61 .**.** The Looka
9d60: 73 69 64 65 20 73 74 72 75 63 74 75 72 65 20 68 side structure h
9d70: 6f 6c 64 73 20 63 6f 6e 66 69 67 75 72 61 74 69 olds configurati
9d80: 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 on information a
9d90: 62 6f 75 74 20 74 68 65 0a 2a 2a 20 6c 6f 6f 6b bout the.** look
9da0: 61 73 69 64 65 20 6d 61 6c 6c 6f 63 20 73 75 62 aside malloc sub
9db0: 73 79 73 74 65 6d 2e 20 20 45 61 63 68 20 61 76 system. Each av
9dc0: 61 69 6c 61 62 6c 65 20 6d 65 6d 6f 72 79 20 61 ailable memory a
9dd0: 6c 6c 6f 63 61 74 69 6f 6e 20 69 6e 0a 2a 2a 20 llocation in.**
9de0: 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 73 75 the lookaside su
9df0: 62 73 79 73 74 65 6d 20 69 73 20 73 74 6f 72 65 bsystem is store
9e00: 64 20 6f 6e 20 61 20 6c 69 6e 6b 65 64 20 6c 69 d on a linked li
9e10: 73 74 20 6f 66 20 4c 6f 6f 6b 61 73 69 64 65 53 st of LookasideS
9e20: 6c 6f 74 0a 2a 2a 20 6f 62 6a 65 63 74 73 2e 0a lot.** objects..
9e30: 2a 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 **.** Lookaside
9e40: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 20 allocations are
9e50: 6f 6e 6c 79 20 61 6c 6c 6f 77 65 64 20 66 6f 72 only allowed for
9e60: 20 6f 62 6a 65 63 74 73 20 74 68 61 74 20 61 72 objects that ar
9e70: 65 20 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 e associated.**
9e80: 77 69 74 68 20 61 20 70 61 72 74 69 63 75 6c 61 with a particula
9e90: 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 r database conne
9ea0: 63 74 69 6f 6e 2e 20 20 48 65 6e 63 65 2c 20 73 ction. Hence, s
9eb0: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f chema informatio
9ec0: 6e 20 63 61 6e 6e 6f 74 0a 2a 2a 20 62 65 20 73 n cannot.** be s
9ed0: 74 6f 72 65 64 20 69 6e 20 6c 6f 6f 6b 61 73 69 tored in lookasi
9ee0: 64 65 20 62 65 63 61 75 73 65 20 69 6e 20 73 68 de because in sh
9ef0: 61 72 65 64 20 63 61 63 68 65 20 6d 6f 64 65 20 ared cache mode
9f00: 74 68 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 the schema infor
9f10: 6d 61 74 69 6f 6e 0a 2a 2a 20 69 73 20 73 68 61 mation.** is sha
9f20: 72 65 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 20 red by multiple
9f30: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
9f40: 69 6f 6e 73 2e 20 20 54 68 65 72 65 66 6f 72 65 ions. Therefore
9f50: 2c 20 77 68 69 6c 65 20 70 61 72 73 69 6e 67 0a , while parsing.
9f60: 2a 2a 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d ** schema inform
9f70: 61 74 69 6f 6e 2c 20 74 68 65 20 4c 6f 6f 6b 61 ation, the Looka
9f80: 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 20 66 6c side.bEnabled fl
9f90: 61 67 20 69 73 20 63 6c 65 61 72 65 64 20 73 6f ag is cleared so
9fa0: 20 74 68 61 74 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 that.** lookasi
9fb0: 64 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 de allocations a
9fc0: 72 65 20 6e 6f 74 20 75 73 65 64 20 74 6f 20 63 re not used to c
9fd0: 6f 6e 73 74 72 75 63 74 20 74 68 65 20 73 63 68 onstruct the sch
9fe0: 65 6d 61 20 6f 62 6a 65 63 74 73 2e 0a 2a 2f 0a ema objects..*/.
9ff0: 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 69 64 65 struct Lookaside
a000: 20 7b 0a 20 20 75 33 32 20 62 44 69 73 61 62 6c {. u32 bDisabl
a010: 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 e; /*
a020: 4f 6e 6c 79 20 6f 70 65 72 61 74 65 20 74 68 65 Only operate the
a030: 20 6c 6f 6f 6b 61 73 69 64 65 20 77 68 65 6e 20 lookaside when
a040: 7a 65 72 6f 20 2a 2f 0a 20 20 75 31 36 20 73 7a zero */. u16 sz
a050: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
a060: 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 /* Size of eac
a070: 68 20 62 75 66 66 65 72 20 69 6e 20 62 79 74 65 h buffer in byte
a080: 73 20 2a 2f 0a 20 20 75 38 20 62 4d 61 6c 6c 6f s */. u8 bMallo
a090: 63 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f ced; /
a0a0: 2a 20 54 72 75 65 20 69 66 20 70 53 74 61 72 74 * True if pStart
a0b0: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 obtained from s
a0c0: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 qlite3_malloc()
a0d0: 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74 3b 20 20 */. int nOut;
a0e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
a0f0: 4e 75 6d 62 65 72 20 6f 66 20 62 75 66 66 65 72 Number of buffer
a100: 73 20 63 75 72 72 65 6e 74 6c 79 20 63 68 65 63 s currently chec
a110: 6b 65 64 20 6f 75 74 20 2a 2f 0a 20 20 69 6e 74 ked out */. int
a120: 20 6d 78 4f 75 74 3b 20 20 20 20 20 20 20 20 20 mxOut;
a130: 20 20 20 20 20 2f 2a 20 48 69 67 68 77 61 74 65 /* Highwate
a140: 72 20 6d 61 72 6b 20 66 6f 72 20 6e 4f 75 74 20 r mark for nOut
a150: 2a 2f 0a 20 20 69 6e 74 20 61 6e 53 74 61 74 5b */. int anStat[
a160: 33 5d 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 3]; /*
a170: 30 3a 20 68 69 74 73 2e 20 20 31 3a 20 73 69 7a 0: hits. 1: siz
a180: 65 20 6d 69 73 73 65 73 2e 20 20 32 3a 20 66 75 e misses. 2: fu
a190: 6c 6c 20 6d 69 73 73 65 73 20 2a 2f 0a 20 20 4c ll misses */. L
a1a0: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 46 ookasideSlot *pF
a1b0: 72 65 65 3b 20 20 20 2f 2a 20 4c 69 73 74 20 6f ree; /* List o
a1c0: 66 20 61 76 61 69 6c 61 62 6c 65 20 62 75 66 66 f available buff
a1d0: 65 72 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ers */. void *p
a1e0: 53 74 61 72 74 3b 20 20 20 20 20 20 20 20 20 20 Start;
a1f0: 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f /* First byte o
a200: 66 20 61 76 61 69 6c 61 62 6c 65 20 6d 65 6d 6f f available memo
a210: 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 20 76 6f ry space */. vo
a220: 69 64 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 20 id *pEnd;
a230: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 /* First b
a240: 79 74 65 20 70 61 73 74 20 65 6e 64 20 6f 66 20 yte past end of
a250: 61 76 61 69 6c 61 62 6c 65 20 73 70 61 63 65 20 available space
a260: 2a 2f 0a 7d 3b 0a 73 74 72 75 63 74 20 4c 6f 6f */.};.struct Loo
a270: 6b 61 73 69 64 65 53 6c 6f 74 20 7b 0a 20 20 4c kasideSlot {. L
a280: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 4e ookasideSlot *pN
a290: 65 78 74 3b 20 20 20 20 2f 2a 20 4e 65 78 74 20 ext; /* Next
a2a0: 62 75 66 66 65 72 20 69 6e 20 74 68 65 20 6c 69 buffer in the li
a2b0: 73 74 20 6f 66 20 66 72 65 65 20 62 75 66 66 65 st of free buffe
a2c0: 72 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 rs */.};../*.**
a2d0: 41 20 68 61 73 68 20 74 61 62 6c 65 20 66 6f 72 A hash table for
a2e0: 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 built-in functi
a2f0: 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 73 2e 20 on definitions.
a300: 20 28 41 70 70 6c 69 63 61 74 69 6f 6e 2d 64 65 (Application-de
a310: 66 69 6e 65 64 0a 2a 2a 20 66 75 6e 63 74 69 6f fined.** functio
a320: 6e 73 20 75 73 65 20 61 20 72 65 67 75 6c 61 72 ns use a regular
a330: 20 74 61 62 6c 65 20 74 61 62 6c 65 20 66 72 6f table table fro
a340: 6d 20 68 61 73 68 2e 68 2e 29 0a 2a 2a 0a 2a 2a m hash.h.).**.**
a350: 20 48 61 73 68 20 65 61 63 68 20 46 75 6e 63 44 Hash each FuncD
a360: 65 66 20 73 74 72 75 63 74 75 72 65 20 69 6e 74 ef structure int
a370: 6f 20 6f 6e 65 20 6f 66 20 74 68 65 20 46 75 6e o one of the Fun
a380: 63 44 65 66 48 61 73 68 2e 61 5b 5d 20 73 6c 6f cDefHash.a[] slo
a390: 74 73 2e 0a 2a 2a 20 43 6f 6c 6c 69 73 69 6f 6e ts..** Collision
a3a0: 73 20 61 72 65 20 6f 6e 20 74 68 65 20 46 75 6e s are on the Fun
a3b0: 63 44 65 66 2e 75 2e 70 48 61 73 68 20 63 68 61 cDef.u.pHash cha
a3c0: 69 6e 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 in..*/.#define S
a3d0: 51 4c 49 54 45 5f 46 55 4e 43 5f 48 41 53 48 5f QLITE_FUNC_HASH_
a3e0: 53 5a 20 32 33 0a 73 74 72 75 63 74 20 46 75 6e SZ 23.struct Fun
a3f0: 63 44 65 66 48 61 73 68 20 7b 0a 20 20 46 75 6e cDefHash {. Fun
a400: 63 44 65 66 20 2a 61 5b 53 51 4c 49 54 45 5f 46 cDef *a[SQLITE_F
a410: 55 4e 43 5f 48 41 53 48 5f 53 5a 5d 3b 20 20 20 UNC_HASH_SZ];
a420: 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c /* Hash tabl
a430: 65 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 e for functions
a440: 2a 2f 0a 7d 3b 0a 0a 23 69 66 64 65 66 20 53 51 */.};..#ifdef SQ
a450: 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 48 45 4e LITE_USER_AUTHEN
a460: 54 49 43 41 54 49 4f 4e 0a 2f 2a 0a 2a 2a 20 49 TICATION./*.** I
a470: 6e 66 6f 72 6d 61 74 69 6f 6e 20 68 65 6c 64 20 nformation held
a480: 69 6e 20 74 68 65 20 22 73 71 6c 69 74 65 33 22 in the "sqlite3"
a490: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
a4a0: 74 69 6f 6e 20 6f 62 6a 65 63 74 20 61 6e 64 20 tion object and
a4b0: 75 73 65 64 0a 2a 2a 20 74 6f 20 6d 61 6e 61 67 used.** to manag
a4c0: 65 20 75 73 65 72 20 61 75 74 68 65 6e 74 69 63 e user authentic
a4d0: 61 74 69 6f 6e 2e 0a 2a 2f 0a 74 79 70 65 64 65 ation..*/.typede
a4e0: 66 20 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 f struct sqlite3
a4f0: 5f 75 73 65 72 61 75 74 68 20 73 71 6c 69 74 65 _userauth sqlite
a500: 33 5f 75 73 65 72 61 75 74 68 3b 0a 73 74 72 75 3_userauth;.stru
a510: 63 74 20 73 71 6c 69 74 65 33 5f 75 73 65 72 61 ct sqlite3_usera
a520: 75 74 68 20 7b 0a 20 20 75 38 20 61 75 74 68 4c uth {. u8 authL
a530: 65 76 65 6c 3b 20 20 20 20 20 20 20 20 20 20 20 evel;
a540: 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 /* Current
a550: 20 61 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 authentication
a560: 6c 65 76 65 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e level */. int n
a570: 41 75 74 68 50 57 3b 20 20 20 20 20 20 20 20 20 AuthPW;
a580: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
a590: 20 6f 66 20 74 68 65 20 7a 41 75 74 68 50 57 20 of the zAuthPW
a5a0: 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 63 68 in bytes */. ch
a5b0: 61 72 20 2a 7a 41 75 74 68 50 57 3b 20 20 20 20 ar *zAuthPW;
a5c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
a5d0: 61 73 73 77 6f 72 64 20 75 73 65 64 20 74 6f 20 assword used to
a5e0: 61 75 74 68 65 6e 74 69 63 61 74 65 20 2a 2f 0a authenticate */.
a5f0: 20 20 63 68 61 72 20 2a 7a 41 75 74 68 55 73 65 char *zAuthUse
a600: 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
a610: 2f 2a 20 55 73 65 72 20 6e 61 6d 65 20 75 73 65 /* User name use
a620: 64 20 74 6f 20 61 75 74 68 65 6e 74 69 63 61 74 d to authenticat
a630: 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f e */.};../* Allo
a640: 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 73 wed values for s
a650: 71 6c 69 74 65 33 5f 75 73 65 72 61 75 74 68 2e qlite3_userauth.
a660: 61 75 74 68 4c 65 76 65 6c 20 2a 2f 0a 23 64 65 authLevel */.#de
a670: 66 69 6e 65 20 55 41 55 54 48 5f 55 6e 6b 6e 6f fine UAUTH_Unkno
a680: 77 6e 20 20 20 20 20 30 20 20 20 20 20 2f 2a 20 wn 0 /*
a690: 41 75 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 6e Authentication n
a6a0: 6f 74 20 79 65 74 20 63 68 65 63 6b 65 64 20 2a ot yet checked *
a6b0: 2f 0a 23 64 65 66 69 6e 65 20 55 41 55 54 48 5f /.#define UAUTH_
a6c0: 46 61 69 6c 20 20 20 20 20 20 20 20 31 20 20 20 Fail 1
a6d0: 20 20 2f 2a 20 55 73 65 72 20 61 75 74 68 65 6e /* User authen
a6e0: 74 69 63 61 74 69 6f 6e 20 66 61 69 6c 65 64 20 tication failed
a6f0: 2a 2f 0a 23 64 65 66 69 6e 65 20 55 41 55 54 48 */.#define UAUTH
a700: 5f 55 73 65 72 20 20 20 20 20 20 20 20 32 20 20 _User 2
a710: 20 20 20 2f 2a 20 41 75 74 68 65 6e 74 69 63 61 /* Authentica
a720: 74 65 64 20 61 73 20 61 20 6e 6f 72 6d 61 6c 20 ted as a normal
a730: 75 73 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 user */.#define
a740: 55 41 55 54 48 5f 41 64 6d 69 6e 20 20 20 20 20 UAUTH_Admin
a750: 20 20 33 20 20 20 20 20 2f 2a 20 41 75 74 68 65 3 /* Authe
a760: 6e 74 69 63 61 74 65 64 20 61 73 20 61 6e 20 61 nticated as an a
a770: 64 6d 69 6e 69 73 74 72 61 74 6f 72 20 2a 2f 0a dministrator */.
a780: 0a 2f 2a 20 46 75 6e 63 74 69 6f 6e 73 20 75 73 ./* Functions us
a790: 65 64 20 6f 6e 6c 79 20 62 79 20 75 73 65 72 20 ed only by user
a7a0: 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 6c 6f authorization lo
a7b0: 67 69 63 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 gic */.int sqlit
a7c0: 65 33 55 73 65 72 41 75 74 68 54 61 62 6c 65 28 e3UserAuthTable(
a7d0: 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e const char*);.in
a7e0: 74 20 73 71 6c 69 74 65 33 55 73 65 72 41 75 74 t sqlite3UserAut
a7f0: 68 43 68 65 63 6b 4c 6f 67 69 6e 28 73 71 6c 69 hCheckLogin(sqli
a800: 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
a810: 2c 75 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,u8*);.void sqli
a820: 74 65 33 55 73 65 72 41 75 74 68 49 6e 69 74 28 te3UserAuthInit(
a830: 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 sqlite3*);.void
a840: 73 71 6c 69 74 65 33 43 72 79 70 74 46 75 6e 63 sqlite3CryptFunc
a850: 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
a860: 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
a870: 6c 75 65 2a 2a 29 3b 0a 0a 23 65 6e 64 69 66 20 lue**);..#endif
a880: 2f 2a 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 /* SQLITE_USER_A
a890: 55 54 48 45 4e 54 49 43 41 54 49 4f 4e 20 2a 2f UTHENTICATION */
a8a0: 0a 0a 2f 2a 0a 2a 2a 20 74 79 70 65 64 65 66 20 ../*.** typedef
a8b0: 66 6f 72 20 74 68 65 20 61 75 74 68 6f 72 69 7a for the authoriz
a8c0: 61 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b 20 66 ation callback f
a8d0: 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 64 unction..*/.#ifd
a8e0: 65 66 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 ef SQLITE_USER_A
a8f0: 55 54 48 45 4e 54 49 43 41 54 49 4f 4e 0a 20 20 UTHENTICATION.
a900: 74 79 70 65 64 65 66 20 69 6e 74 20 28 2a 73 71 typedef int (*sq
a910: 6c 69 74 65 33 5f 78 61 75 74 68 29 28 76 6f 69 lite3_xauth)(voi
a920: 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 d*,int,const cha
a930: 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 r*,const char*,c
a940: 6f 6e 73 74 20 63 68 61 72 2a 2c 0a 20 20 20 20 onst char*,.
a950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a960: 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 const
a970: 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 char*, const ch
a980: 61 72 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 74 79 ar*);.#else. ty
a990: 70 65 64 65 66 20 69 6e 74 20 28 2a 73 71 6c 69 pedef int (*sqli
a9a0: 74 65 33 5f 78 61 75 74 68 29 28 76 6f 69 64 2a te3_xauth)(void*
a9b0: 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a ,int,const char*
a9c0: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e ,const char*,con
a9d0: 73 74 20 63 68 61 72 2a 2c 0a 20 20 20 20 20 20 st char*,.
a9e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a9f0: 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 const c
aa00: 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 har*);.#endif..#
aa10: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
aa20: 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 2f 2a IT_DEPRECATED./*
aa30: 20 54 68 69 73 20 69 73 20 61 6e 20 65 78 74 72 This is an extr
aa40: 61 20 53 51 4c 49 54 45 5f 54 52 41 43 45 20 6d a SQLITE_TRACE m
aa50: 61 63 72 6f 20 74 68 61 74 20 69 6e 64 69 63 61 acro that indica
aa60: 74 65 73 20 22 6c 65 67 61 63 79 22 20 74 72 61 tes "legacy" tra
aa70: 63 69 6e 67 0a 2a 2a 20 69 6e 20 74 68 65 20 73 cing.** in the s
aa80: 74 79 6c 65 20 6f 66 20 73 71 6c 69 74 65 33 5f tyle of sqlite3_
aa90: 74 72 61 63 65 28 29 0a 2a 2f 0a 23 64 65 66 69 trace().*/.#defi
aaa0: 6e 65 20 53 51 4c 49 54 45 5f 54 52 41 43 45 5f ne SQLITE_TRACE_
aab0: 4c 45 47 41 43 59 20 20 30 78 38 30 0a 23 65 6c LEGACY 0x80.#el
aac0: 73 65 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 se.#define SQLIT
aad0: 45 5f 54 52 41 43 45 5f 4c 45 47 41 43 59 20 20 E_TRACE_LEGACY
aae0: 30 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 0.#endif /* SQLI
aaf0: 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 TE_OMIT_DEPRECAT
ab00: 45 44 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 ED */.../*.** Ea
ab10: 63 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e ch database conn
ab20: 65 63 74 69 6f 6e 20 69 73 20 61 6e 20 69 6e 73 ection is an ins
ab30: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c tance of the fol
ab40: 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 lowing structure
ab50: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73 71 6c 69 ..*/.struct sqli
ab60: 74 65 33 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f te3 {. sqlite3_
ab70: 76 66 73 20 2a 70 56 66 73 3b 20 20 20 20 20 20 vfs *pVfs;
ab80: 20 20 20 20 20 20 2f 2a 20 4f 53 20 49 6e 74 65 /* OS Inte
ab90: 72 66 61 63 65 20 2a 2f 0a 20 20 73 74 72 75 63 rface */. struc
aba0: 74 20 56 64 62 65 20 2a 70 56 64 62 65 3b 20 20 t Vdbe *pVdbe;
abb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 /* List
abc0: 20 6f 66 20 61 63 74 69 76 65 20 76 69 72 74 75 of active virtu
abd0: 61 6c 20 6d 61 63 68 69 6e 65 73 20 2a 2f 0a 20 al machines */.
abe0: 20 43 6f 6c 6c 53 65 71 20 2a 70 44 66 6c 74 43 CollSeq *pDfltC
abf0: 6f 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 2f oll; /
ac00: 2a 20 54 68 65 20 64 65 66 61 75 6c 74 20 63 6f * The default co
ac10: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
ac20: 20 28 42 49 4e 41 52 59 29 20 2a 2f 0a 20 20 73 (BINARY) */. s
ac30: 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 qlite3_mutex *mu
ac40: 74 65 78 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 tex; /*
ac50: 43 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 74 65 78 Connection mutex
ac60: 20 2a 2f 0a 20 20 44 62 20 2a 61 44 62 3b 20 20 */. Db *aDb;
ac70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ac80: 20 20 20 20 2f 2a 20 41 6c 6c 20 62 61 63 6b 65 /* All backe
ac90: 6e 64 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 44 62 nds */. int nDb
aca0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
acb0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
acc0: 20 6f 66 20 62 61 63 6b 65 6e 64 73 20 63 75 72 of backends cur
acd0: 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 2a 2f rently in use */
ace0: 0a 20 20 69 6e 74 20 66 6c 61 67 73 3b 20 20 20 . int flags;
acf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ad00: 20 2f 2a 20 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 /* Miscellaneou
ad10: 73 20 66 6c 61 67 73 2e 20 53 65 65 20 62 65 6c s flags. See bel
ad20: 6f 77 20 2a 2f 0a 20 20 69 36 34 20 6c 61 73 74 ow */. i64 last
ad30: 52 6f 77 69 64 3b 20 20 20 20 20 20 20 20 20 20 Rowid;
ad40: 20 20 20 20 20 20 2f 2a 20 52 4f 57 49 44 20 6f /* ROWID o
ad50: 66 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 69 6e f most recent in
ad60: 73 65 72 74 20 28 73 65 65 20 61 62 6f 76 65 29 sert (see above)
ad70: 20 2a 2f 0a 20 20 69 36 34 20 73 7a 4d 6d 61 70 */. i64 szMmap
ad80: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
ad90: 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 6d /* Default m
ada0: 6d 61 70 5f 73 69 7a 65 20 73 65 74 74 69 6e 67 map_size setting
adb0: 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 */. unsigned i
adc0: 6e 74 20 6f 70 65 6e 46 6c 61 67 73 3b 20 20 20 nt openFlags;
add0: 20 20 20 20 2f 2a 20 46 6c 61 67 73 20 70 61 73 /* Flags pas
ade0: 73 65 64 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 sed to sqlite3_v
adf0: 66 73 2e 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 fs.xOpen() */.
ae00: 69 6e 74 20 65 72 72 43 6f 64 65 3b 20 20 20 20 int errCode;
ae10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
ae20: 20 4d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 Most recent err
ae30: 6f 72 20 63 6f 64 65 20 28 53 51 4c 49 54 45 5f or code (SQLITE_
ae40: 2a 29 20 2a 2f 0a 20 20 69 6e 74 20 65 72 72 4d *) */. int errM
ae50: 61 73 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 ask;
ae60: 20 20 20 20 20 20 2f 2a 20 26 20 72 65 73 75 6c /* & resul
ae70: 74 20 63 6f 64 65 73 20 77 69 74 68 20 74 68 69 t codes with thi
ae80: 73 20 62 65 66 6f 72 65 20 72 65 74 75 72 6e 69 s before returni
ae90: 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 69 53 79 73 ng */. int iSys
aea0: 45 72 72 6e 6f 3b 20 20 20 20 20 20 20 20 20 20 Errno;
aeb0: 20 20 20 20 20 20 2f 2a 20 45 72 72 6e 6f 20 76 /* Errno v
aec0: 61 6c 75 65 20 66 72 6f 6d 20 6c 61 73 74 20 73 alue from last s
aed0: 79 73 74 65 6d 20 65 72 72 6f 72 20 2a 2f 0a 20 ystem error */.
aee0: 20 75 31 36 20 64 62 4f 70 74 46 6c 61 67 73 3b u16 dbOptFlags;
aef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
af00: 2a 20 46 6c 61 67 73 20 74 6f 20 65 6e 61 62 6c * Flags to enabl
af10: 65 2f 64 69 73 61 62 6c 65 20 6f 70 74 69 6d 69 e/disable optimi
af20: 7a 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 75 38 20 zations */. u8
af30: 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 enc;
af40: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 /* Te
af50: 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a 2f 0a 20 xt encoding */.
af60: 20 75 38 20 61 75 74 6f 43 6f 6d 6d 69 74 3b 20 u8 autoCommit;
af70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
af80: 2a 20 54 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 * The auto-commi
af90: 74 20 66 6c 61 67 2e 20 2a 2f 0a 20 20 75 38 20 t flag. */. u8
afa0: 74 65 6d 70 5f 73 74 6f 72 65 3b 20 20 20 20 20 temp_store;
afb0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 3a /* 1:
afc0: 20 66 69 6c 65 20 32 3a 20 6d 65 6d 6f 72 79 20 file 2: memory
afd0: 30 3a 20 64 65 66 61 75 6c 74 20 2a 2f 0a 20 20 0: default */.
afe0: 75 38 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 3b u8 mallocFailed;
aff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
b000: 20 54 72 75 65 20 69 66 20 77 65 20 68 61 76 65 True if we have
b010: 20 73 65 65 6e 20 61 20 6d 61 6c 6c 6f 63 20 66 seen a malloc f
b020: 61 69 6c 75 72 65 20 2a 2f 0a 20 20 75 38 20 62 ailure */. u8 b
b030: 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 3b 20 20 20 BenignMalloc;
b040: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 /* Do
b050: 6e 6f 74 20 72 65 71 75 69 72 65 20 4f 4f 4d 73 not require OOMs
b060: 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 20 75 38 if true */. u8
b070: 20 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 3b 20 20 dfltLockMode;
b080: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
b090: 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 2d 6d efault locking-m
b0a0: 6f 64 65 20 66 6f 72 20 61 74 74 61 63 68 65 64 ode for attached
b0b0: 20 64 62 73 20 2a 2f 0a 20 20 73 69 67 6e 65 64 dbs */. signed
b0c0: 20 63 68 61 72 20 6e 65 78 74 41 75 74 6f 76 61 char nextAutova
b0d0: 63 3b 20 20 20 20 20 20 2f 2a 20 41 75 74 6f 76 c; /* Autov
b0e0: 61 63 20 73 65 74 74 69 6e 67 20 61 66 74 65 72 ac setting after
b0f0: 20 56 41 43 55 55 4d 20 69 66 20 3e 3d 30 20 2a VACUUM if >=0 *
b100: 2f 0a 20 20 75 38 20 73 75 70 70 72 65 73 73 45 /. u8 suppressE
b110: 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rr;
b120: 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 69 73 73 75 /* Do not issu
b130: 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 e error messages
b140: 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 20 75 38 if true */. u8
b150: 20 76 74 61 62 4f 6e 43 6f 6e 66 6c 69 63 74 3b vtabOnConflict;
b160: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
b170: 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 66 alue to return f
b180: 6f 72 20 73 33 5f 76 74 61 62 5f 6f 6e 5f 63 6f or s3_vtab_on_co
b190: 6e 66 6c 69 63 74 28 29 20 2a 2f 0a 20 20 75 38 nflict() */. u8
b1a0: 20 69 73 54 72 61 6e 73 61 63 74 69 6f 6e 53 61 isTransactionSa
b1b0: 76 65 70 6f 69 6e 74 3b 20 20 20 20 2f 2a 20 54 vepoint; /* T
b1c0: 72 75 65 20 69 66 20 74 68 65 20 6f 75 74 65 72 rue if the outer
b1d0: 6d 6f 73 74 20 73 61 76 65 70 6f 69 6e 74 20 69 most savepoint i
b1e0: 73 20 61 20 54 53 20 2a 2f 0a 20 20 75 38 20 6d s a TS */. u8 m
b1f0: 54 72 61 63 65 3b 20 20 20 20 20 20 20 20 20 20 Trace;
b200: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 7a 65 72 /* zer
b210: 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 o or more SQLITE
b220: 5f 54 52 41 43 45 20 66 6c 61 67 73 20 2a 2f 0a _TRACE flags */.
b230: 20 20 69 6e 74 20 6e 65 78 74 50 61 67 65 73 69 int nextPagesi
b240: 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ze;
b250: 2f 2a 20 50 61 67 65 73 69 7a 65 20 61 66 74 65 /* Pagesize afte
b260: 72 20 56 41 43 55 55 4d 20 69 66 20 3e 30 20 2a r VACUUM if >0 *
b270: 2f 0a 20 20 75 33 32 20 6d 61 67 69 63 3b 20 20 /. u32 magic;
b280: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b290: 20 20 2f 2a 20 4d 61 67 69 63 20 6e 75 6d 62 65 /* Magic numbe
b2a0: 72 20 66 6f 72 20 64 65 74 65 63 74 20 6c 69 62 r for detect lib
b2b0: 72 61 72 79 20 6d 69 73 75 73 65 20 2a 2f 0a 20 rary misuse */.
b2c0: 20 69 6e 74 20 6e 43 68 61 6e 67 65 3b 20 20 20 int nChange;
b2d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
b2e0: 2a 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 * Value returned
b2f0: 20 62 79 20 73 71 6c 69 74 65 33 5f 63 68 61 6e by sqlite3_chan
b300: 67 65 73 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e ges() */. int n
b310: 54 6f 74 61 6c 43 68 61 6e 67 65 3b 20 20 20 20 TotalChange;
b320: 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 /* Valu
b330: 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 73 71 e returned by sq
b340: 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e lite3_total_chan
b350: 67 65 73 28 29 20 2a 2f 0a 20 20 69 6e 74 20 61 ges() */. int a
b360: 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4e 5f 4c Limit[SQLITE_N_L
b370: 49 4d 49 54 5d 3b 20 20 20 2f 2a 20 4c 69 6d 69 IMIT]; /* Limi
b380: 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 78 ts */. int nMax
b390: 53 6f 72 74 65 72 4d 6d 61 70 3b 20 20 20 20 20 SorterMmap;
b3a0: 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d /* Maximum
b3b0: 20 73 69 7a 65 20 6f 66 20 72 65 67 69 6f 6e 73 size of regions
b3c0: 20 6d 61 70 70 65 64 20 62 79 20 73 6f 72 74 65 mapped by sorte
b3d0: 72 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 73 71 r */. struct sq
b3e0: 6c 69 74 65 33 49 6e 69 74 49 6e 66 6f 20 7b 20 lite3InitInfo {
b3f0: 20 20 20 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 /* Informat
b400: 69 6f 6e 20 75 73 65 64 20 64 75 72 69 6e 67 20 ion used during
b410: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 2a initialization *
b420: 2f 0a 20 20 20 20 69 6e 74 20 6e 65 77 54 6e 75 /. int newTnu
b430: 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 m;
b440: 20 20 2f 2a 20 52 6f 6f 74 70 61 67 65 20 6f 66 /* Rootpage of
b450: 20 74 61 62 6c 65 20 62 65 69 6e 67 20 69 6e 69 table being ini
b460: 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 20 20 tialized */.
b470: 75 38 20 69 44 62 3b 20 20 20 20 20 20 20 20 20 u8 iDb;
b480: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 /* W
b490: 68 69 63 68 20 64 62 20 66 69 6c 65 20 69 73 20 hich db file is
b4a0: 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 being initialize
b4b0: 64 20 2a 2f 0a 20 20 20 20 75 38 20 62 75 73 79 d */. u8 busy
b4c0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
b4d0: 20 20 20 20 20 2f 2a 20 54 52 55 45 20 69 66 20 /* TRUE if
b4e0: 63 75 72 72 65 6e 74 6c 79 20 69 6e 69 74 69 61 currently initia
b4f0: 6c 69 7a 69 6e 67 20 2a 2f 0a 20 20 20 20 75 38 lizing */. u8
b500: 20 6f 72 70 68 61 6e 54 72 69 67 67 65 72 3b 20 orphanTrigger;
b510: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 /* Las
b520: 74 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 6f t statement is o
b530: 72 70 68 61 6e 65 64 20 54 45 4d 50 20 74 72 69 rphaned TEMP tri
b540: 67 67 65 72 20 2a 2f 0a 20 20 20 20 75 38 20 69 gger */. u8 i
b550: 6d 70 6f 73 74 65 72 54 61 62 6c 65 3b 20 20 20 mposterTable;
b560: 20 20 20 20 20 20 20 20 2f 2a 20 42 75 69 6c 64 /* Build
b570: 69 6e 67 20 61 6e 20 69 6d 70 6f 73 74 65 72 20 ing an imposter
b580: 74 61 62 6c 65 20 2a 2f 0a 20 20 7d 20 69 6e 69 table */. } ini
b590: 74 3b 0a 20 20 69 6e 74 20 6e 56 64 62 65 41 63 t;. int nVdbeAc
b5a0: 74 69 76 65 3b 20 20 20 20 20 20 20 20 20 20 20 tive;
b5b0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
b5c0: 56 44 42 45 73 20 63 75 72 72 65 6e 74 6c 79 20 VDBEs currently
b5d0: 72 75 6e 6e 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 running */. int
b5e0: 20 6e 56 64 62 65 52 65 61 64 3b 20 20 20 20 20 nVdbeRead;
b5f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
b600: 6d 62 65 72 20 6f 66 20 61 63 74 69 76 65 20 56 mber of active V
b610: 44 42 45 73 20 74 68 61 74 20 72 65 61 64 20 6f DBEs that read o
b620: 72 20 77 72 69 74 65 20 2a 2f 0a 20 20 69 6e 74 r write */. int
b630: 20 6e 56 64 62 65 57 72 69 74 65 3b 20 20 20 20 nVdbeWrite;
b640: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
b650: 6d 62 65 72 20 6f 66 20 61 63 74 69 76 65 20 56 mber of active V
b660: 44 42 45 73 20 74 68 61 74 20 72 65 61 64 20 61 DBEs that read a
b670: 6e 64 20 77 72 69 74 65 20 2a 2f 0a 20 20 69 6e nd write */. in
b680: 74 20 6e 56 64 62 65 45 78 65 63 3b 20 20 20 20 t nVdbeExec;
b690: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
b6a0: 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 20 umber of nested
b6b0: 63 61 6c 6c 73 20 74 6f 20 56 64 62 65 45 78 65 calls to VdbeExe
b6c0: 63 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 44 c() */. int nVD
b6d0: 65 73 74 72 6f 79 3b 20 20 20 20 20 20 20 20 20 estroy;
b6e0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
b6f0: 20 6f 66 20 61 63 74 69 76 65 20 4f 50 5f 56 44 of active OP_VD
b700: 65 73 74 72 6f 79 20 6f 70 65 72 61 74 69 6f 6e estroy operation
b710: 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 78 74 65 s */. int nExte
b720: 6e 73 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 nsion;
b730: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
b740: 66 20 6c 6f 61 64 65 64 20 65 78 74 65 6e 73 69 f loaded extensi
b750: 6f 6e 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 2a ons */. void **
b760: 61 45 78 74 65 6e 73 69 6f 6e 3b 20 20 20 20 20 aExtension;
b770: 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 /* Array
b780: 6f 66 20 73 68 61 72 65 64 20 6c 69 62 72 61 72 of shared librar
b790: 79 20 68 61 6e 64 6c 65 73 20 2a 2f 0a 20 20 69 y handles */. i
b7a0: 6e 74 20 28 2a 78 54 72 61 63 65 29 28 75 33 32 nt (*xTrace)(u32
b7b0: 2c 76 6f 69 64 2a 2c 76 6f 69 64 2a 2c 76 6f 69 ,void*,void*,voi
b7c0: 64 2a 29 3b 20 20 20 20 20 2f 2a 20 54 72 61 63 d*); /* Trac
b7d0: 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 e function */.
b7e0: 76 6f 69 64 20 2a 70 54 72 61 63 65 41 72 67 3b void *pTraceArg;
b7f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b800: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
b810: 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 74 72 61 ument to the tra
b820: 63 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 ce function */.
b830: 20 76 6f 69 64 20 28 2a 78 50 72 6f 66 69 6c 65 void (*xProfile
b840: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 )(void*,const ch
b850: 61 72 2a 2c 75 36 34 29 3b 20 20 2f 2a 20 50 72 ar*,u64); /* Pr
b860: 6f 66 69 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e ofiling function
b870: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 50 72 6f */. void *pPro
b880: 66 69 6c 65 41 72 67 3b 20 20 20 20 20 20 20 20 fileArg;
b890: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b8a0: 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 70 /* Argument to p
b8b0: 72 6f 66 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 rofile function
b8c0: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6d 6d */. void *pComm
b8d0: 69 74 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 itArg;
b8e0: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 /* Argume
b8f0: 6e 74 20 74 6f 20 78 43 6f 6d 6d 69 74 43 61 6c nt to xCommitCal
b900: 6c 62 61 63 6b 28 29 20 2a 2f 0a 20 20 69 6e 74 lback() */. int
b910: 20 28 2a 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 (*xCommitCallba
b920: 63 6b 29 28 76 6f 69 64 2a 29 3b 20 20 20 20 2f ck)(void*); /
b930: 2a 20 49 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 * Invoked at eve
b940: 72 79 20 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 ry commit. */.
b950: 76 6f 69 64 20 2a 70 52 6f 6c 6c 62 61 63 6b 41 void *pRollbackA
b960: 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rg;
b970: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f /* Argument to
b980: 20 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 xRollbackCallba
b990: 63 6b 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 28 ck() */. void (
b9a0: 2a 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 *xRollbackCallba
b9b0: 63 6b 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 49 ck)(void*); /* I
b9c0: 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 nvoked at every
b9d0: 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 commit. */. voi
b9e0: 64 20 2a 70 55 70 64 61 74 65 41 72 67 3b 0a 20 d *pUpdateArg;.
b9f0: 20 76 6f 69 64 20 28 2a 78 55 70 64 61 74 65 43 void (*xUpdateC
ba00: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 allback)(void*,i
ba10: 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c nt, const char*,
ba20: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 const char*,sqli
ba30: 74 65 5f 69 6e 74 36 34 29 3b 0a 23 69 66 64 65 te_int64);.#ifde
ba40: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
ba50: 50 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a 20 PREUPDATE_HOOK.
ba60: 20 76 6f 69 64 20 2a 70 50 72 65 55 70 64 61 74 void *pPreUpdat
ba70: 65 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 2f eArg; /
ba80: 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 * First argument
ba90: 20 74 6f 20 78 50 72 65 55 70 64 61 74 65 43 61 to xPreUpdateCa
baa0: 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 llback */. void
bab0: 20 28 2a 78 50 72 65 55 70 64 61 74 65 43 61 6c (*xPreUpdateCal
bac0: 6c 62 61 63 6b 29 28 20 20 20 2f 2a 20 52 65 67 lback)( /* Reg
bad0: 69 73 74 65 72 65 64 20 75 73 69 6e 67 20 73 71 istered using sq
bae0: 6c 69 74 65 33 5f 70 72 65 75 70 64 61 74 65 5f lite3_preupdate_
baf0: 68 6f 6f 6b 28 29 20 2a 2f 0a 20 20 20 20 76 6f hook() */. vo
bb00: 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 id*,sqlite3*,int
bb10: 2c 63 68 61 72 20 63 6f 6e 73 74 2a 2c 63 68 61 ,char const*,cha
bb20: 72 20 63 6f 6e 73 74 2a 2c 73 71 6c 69 74 65 33 r const*,sqlite3
bb30: 5f 69 6e 74 36 34 2c 73 71 6c 69 74 65 33 5f 69 _int64,sqlite3_i
bb40: 6e 74 36 34 0a 20 20 29 3b 0a 20 20 50 72 65 55 nt64. );. PreU
bb50: 70 64 61 74 65 20 2a 70 50 72 65 55 70 64 61 74 pdate *pPreUpdat
bb60: 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e e; /* Con
bb70: 74 65 78 74 20 66 6f 72 20 61 63 74 69 76 65 20 text for active
bb80: 70 72 65 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 pre-update callb
bb90: 61 63 6b 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a ack */.#endif /*
bba0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 SQLITE_ENABLE_P
bbb0: 52 45 55 50 44 41 54 45 5f 48 4f 4f 4b 20 2a 2f REUPDATE_HOOK */
bbc0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
bbd0: 4f 4d 49 54 5f 57 41 4c 0a 20 20 69 6e 74 20 28 OMIT_WAL. int (
bbe0: 2a 78 57 61 6c 43 61 6c 6c 62 61 63 6b 29 28 76 *xWalCallback)(v
bbf0: 6f 69 64 20 2a 2c 20 73 71 6c 69 74 65 33 20 2a oid *, sqlite3 *
bc00: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 , const char *,
bc10: 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 2a 70 57 int);. void *pW
bc20: 61 6c 41 72 67 3b 0a 23 65 6e 64 69 66 0a 20 20 alArg;.#endif.
bc30: 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 void(*xCollNeede
bc40: 64 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 d)(void*,sqlite3
bc50: 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 *,int eTextRep,c
bc60: 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 onst char*);. v
bc70: 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 oid(*xCollNeeded
bc80: 31 36 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 16)(void*,sqlite
bc90: 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 3*,int eTextRep,
bca0: 63 6f 6e 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 const void*);.
bcb0: 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 void *pCollNeede
bcc0: 64 41 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f dArg;. sqlite3_
bcd0: 76 61 6c 75 65 20 2a 70 45 72 72 3b 20 20 20 20 value *pErr;
bce0: 20 20 20 20 20 20 2f 2a 20 4d 6f 73 74 20 72 65 /* Most re
bcf0: 63 65 6e 74 20 65 72 72 6f 72 20 6d 65 73 73 61 cent error messa
bd00: 67 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a ge */. union {.
bd10: 20 20 20 20 76 6f 6c 61 74 69 6c 65 20 69 6e 74 volatile int
bd20: 20 69 73 49 6e 74 65 72 72 75 70 74 65 64 3b 20 isInterrupted;
bd30: 2f 2a 20 54 72 75 65 20 69 66 20 73 71 6c 69 74 /* True if sqlit
bd40: 65 33 5f 69 6e 74 65 72 72 75 70 74 20 68 61 73 e3_interrupt has
bd50: 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 2a 2f 0a been called */.
bd60: 20 20 20 20 64 6f 75 62 6c 65 20 6e 6f 74 55 73 double notUs
bd70: 65 64 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 ed1;
bd80: 2f 2a 20 53 70 61 63 65 72 20 2a 2f 0a 20 20 7d /* Spacer */. }
bd90: 20 75 31 3b 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 u1;. Lookaside
bda0: 20 6c 6f 6f 6b 61 73 69 64 65 3b 20 20 20 20 20 lookaside;
bdb0: 20 20 20 20 20 2f 2a 20 4c 6f 6f 6b 61 73 69 64 /* Lookasid
bdc0: 65 20 6d 61 6c 6c 6f 63 20 63 6f 6e 66 69 67 75 e malloc configu
bdd0: 72 61 74 69 6f 6e 20 2a 2f 0a 23 69 66 6e 64 65 ration */.#ifnde
bde0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
bdf0: 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 73 71 THORIZATION. sq
be00: 6c 69 74 65 33 5f 78 61 75 74 68 20 78 41 75 74 lite3_xauth xAut
be10: 68 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 h; /* A
be20: 63 63 65 73 73 20 61 75 74 68 6f 72 69 7a 61 74 ccess authorizat
be30: 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a ion function */.
be40: 20 20 76 6f 69 64 20 2a 70 41 75 74 68 41 72 67 void *pAuthArg
be50: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
be60: 2f 2a 20 31 73 74 20 61 72 67 75 6d 65 6e 74 20 /* 1st argument
be70: 74 6f 20 74 68 65 20 61 63 63 65 73 73 20 61 75 to the access au
be80: 74 68 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 th function */.#
be90: 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 endif.#ifndef SQ
bea0: 4c 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 LITE_OMIT_PROGRE
beb0: 53 53 5f 43 41 4c 4c 42 41 43 4b 0a 20 20 69 6e SS_CALLBACK. in
bec0: 74 20 28 2a 78 50 72 6f 67 72 65 73 73 29 28 76 t (*xProgress)(v
bed0: 6f 69 64 20 2a 29 3b 20 20 20 20 20 2f 2a 20 54 oid *); /* T
bee0: 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c he progress call
bef0: 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a back */. void *
bf00: 70 50 72 6f 67 72 65 73 73 41 72 67 3b 20 20 20 pProgressArg;
bf10: 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d /* Argum
bf20: 65 6e 74 20 74 6f 20 74 68 65 20 70 72 6f 67 72 ent to the progr
bf30: 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a ess callback */.
bf40: 20 20 75 6e 73 69 67 6e 65 64 20 6e 50 72 6f 67 unsigned nProg
bf50: 72 65 73 73 4f 70 73 3b 20 20 20 20 20 20 20 20 ressOps;
bf60: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6f 70 63 /* Number of opc
bf70: 6f 64 65 73 20 66 6f 72 20 70 72 6f 67 72 65 73 odes for progres
bf80: 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 23 65 s callback */.#e
bf90: 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c ndif.#ifndef SQL
bfa0: 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
bfb0: 54 41 42 4c 45 0a 20 20 69 6e 74 20 6e 56 54 72 TABLE. int nVTr
bfc0: 61 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ans;
bfd0: 20 20 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 /* Allocat
bfe0: 65 64 20 73 69 7a 65 20 6f 66 20 61 56 54 72 61 ed size of aVTra
bff0: 6e 73 20 2a 2f 0a 20 20 48 61 73 68 20 61 4d 6f ns */. Hash aMo
c000: 64 75 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 dule;
c010: 20 20 20 20 20 20 2f 2a 20 70 6f 70 75 6c 61 74 /* populat
c020: 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 63 72 ed by sqlite3_cr
c030: 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f eate_module() */
c040: 0a 20 20 56 74 61 62 43 74 78 20 2a 70 56 74 61 . VtabCtx *pVta
c050: 62 43 74 78 3b 20 20 20 20 20 20 20 20 20 20 20 bCtx;
c060: 20 2f 2a 20 43 6f 6e 74 65 78 74 20 66 6f 72 20 /* Context for
c070: 61 63 74 69 76 65 20 76 74 61 62 20 63 6f 6e 6e active vtab conn
c080: 65 63 74 2f 63 72 65 61 74 65 20 2a 2f 0a 20 20 ect/create */.
c090: 56 54 61 62 6c 65 20 2a 2a 61 56 54 72 61 6e 73 VTable **aVTrans
c0a0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
c0b0: 20 56 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 Virtual tables
c0c0: 77 69 74 68 20 6f 70 65 6e 20 74 72 61 6e 73 61 with open transa
c0d0: 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 56 54 61 62 ctions */. VTab
c0e0: 6c 65 20 2a 70 44 69 73 63 6f 6e 6e 65 63 74 3b le *pDisconnect;
c0f0: 20 20 20 20 2f 2a 20 44 69 73 63 6f 6e 6e 65 63 /* Disconnec
c100: 74 20 74 68 65 73 65 20 69 6e 20 6e 65 78 74 20 t these in next
c110: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 sqlite3_prepare(
c120: 29 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 48 61 ) */.#endif. Ha
c130: 73 68 20 61 46 75 6e 63 3b 20 20 20 20 20 20 20 sh aFunc;
c140: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 /* H
c150: 61 73 68 20 74 61 62 6c 65 20 6f 66 20 63 6f 6e ash table of con
c160: 6e 65 63 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e nection function
c170: 73 20 2a 2f 0a 20 20 48 61 73 68 20 61 43 6f 6c s */. Hash aCol
c180: 6c 53 65 71 3b 20 20 20 20 20 20 20 20 20 20 20 lSeq;
c190: 20 20 20 20 20 2f 2a 20 41 6c 6c 20 63 6f 6c 6c /* All coll
c1a0: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20 ating sequences
c1b0: 2a 2f 0a 20 20 42 75 73 79 48 61 6e 64 6c 65 72 */. BusyHandler
c1c0: 20 62 75 73 79 48 61 6e 64 6c 65 72 3b 20 20 20 busyHandler;
c1d0: 20 20 20 2f 2a 20 42 75 73 79 20 63 61 6c 6c 62 /* Busy callb
c1e0: 61 63 6b 20 2a 2f 0a 20 20 44 62 20 61 44 62 53 ack */. Db aDbS
c1f0: 74 61 74 69 63 5b 32 5d 3b 20 20 20 20 20 20 20 tatic[2];
c200: 20 20 20 20 20 20 20 2f 2a 20 53 74 61 74 69 63 /* Static
c210: 20 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 32 space for the 2
c220: 20 64 65 66 61 75 6c 74 20 62 61 63 6b 65 6e 64 default backend
c230: 73 20 2a 2f 0a 20 20 53 61 76 65 70 6f 69 6e 74 s */. Savepoint
c240: 20 2a 70 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 *pSavepoint;
c250: 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
c260: 61 63 74 69 76 65 20 73 61 76 65 70 6f 69 6e 74 active savepoint
c270: 73 20 2a 2f 0a 20 20 69 6e 74 20 62 75 73 79 54 s */. int busyT
c280: 69 6d 65 6f 75 74 3b 20 20 20 20 20 20 20 20 20 imeout;
c290: 20 20 20 20 20 2f 2a 20 42 75 73 79 20 68 61 6e /* Busy han
c2a0: 64 6c 65 72 20 74 69 6d 65 6f 75 74 2c 20 69 6e dler timeout, in
c2b0: 20 6d 73 65 63 20 2a 2f 0a 20 20 69 6e 74 20 6e msec */. int n
c2c0: 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 20 20 Savepoint;
c2d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
c2e0: 65 72 20 6f 66 20 6e 6f 6e 2d 74 72 61 6e 73 61 er of non-transa
c2f0: 63 74 69 6f 6e 20 73 61 76 65 70 6f 69 6e 74 73 ction savepoints
c300: 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 74 61 74 65 */. int nState
c310: 6d 65 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 ment;
c320: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
c330: 20 6e 65 73 74 65 64 20 73 74 61 74 65 6d 65 6e nested statemen
c340: 74 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 20 t-transactions
c350: 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 */. i64 nDeferr
c360: 65 64 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 edCons;
c370: 20 20 20 2f 2a 20 4e 65 74 20 64 65 66 65 72 72 /* Net deferr
c380: 65 64 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 74 ed constraints t
c390: 68 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e his transaction.
c3a0: 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 */. i64 nDefer
c3b0: 72 65 64 49 6d 6d 43 6f 6e 73 3b 20 20 20 20 20 redImmCons;
c3c0: 20 20 20 20 2f 2a 20 4e 65 74 20 64 65 66 65 72 /* Net defer
c3d0: 72 65 64 20 69 6d 6d 65 64 69 61 74 65 20 63 6f red immediate co
c3e0: 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 20 20 69 nstraints */. i
c3f0: 6e 74 20 2a 70 6e 42 79 74 65 73 46 72 65 65 64 nt *pnBytesFreed
c400: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
c410: 49 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 69 6e 63 If not NULL, inc
c420: 72 65 6d 65 6e 74 20 74 68 69 73 20 69 6e 20 44 rement this in D
c430: 62 46 72 65 65 28 29 20 2a 2f 0a 23 69 66 64 65 bFree() */.#ifde
c440: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
c450: 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 0a 20 20 UNLOCK_NOTIFY.
c460: 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 /* The following
c470: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 61 variables are a
c480: 6c 6c 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 ll protected by
c490: 74 68 65 20 53 54 41 54 49 43 5f 4d 41 53 54 45 the STATIC_MASTE
c4a0: 52 0a 20 20 2a 2a 20 6d 75 74 65 78 2c 20 6e 6f R. ** mutex, no
c4b0: 74 20 62 79 20 73 71 6c 69 74 65 33 2e 6d 75 74 t by sqlite3.mut
c4c0: 65 78 2e 20 54 68 65 79 20 61 72 65 20 75 73 65 ex. They are use
c4d0: 64 20 62 79 20 63 6f 64 65 20 69 6e 20 6e 6f 74 d by code in not
c4e0: 69 66 79 2e 63 2e 0a 20 20 2a 2a 0a 20 20 2a 2a ify.c.. **. **
c4f0: 20 57 68 65 6e 20 58 2e 70 55 6e 6c 6f 63 6b 43 When X.pUnlockC
c500: 6f 6e 6e 65 63 74 69 6f 6e 3d 3d 59 2c 20 74 68 onnection==Y, th
c510: 61 74 20 6d 65 61 6e 73 20 74 68 61 74 20 58 20 at means that X
c520: 69 73 20 77 61 69 74 69 6e 67 20 66 6f 72 20 59 is waiting for Y
c530: 20 74 6f 0a 20 20 2a 2a 20 75 6e 6c 6f 63 6b 20 to. ** unlock
c540: 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 70 so that it can p
c550: 72 6f 63 65 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a roceed.. **. *
c560: 2a 20 57 68 65 6e 20 58 2e 70 42 6c 6f 63 6b 69 * When X.pBlocki
c570: 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3d 3d 59 2c ngConnection==Y,
c580: 20 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 74 that means that
c590: 20 73 6f 6d 65 74 68 69 6e 67 20 74 68 61 74 20 something that
c5a0: 58 20 74 72 69 65 64 0a 20 20 2a 2a 20 74 72 69 X tried. ** tri
c5b0: 65 64 20 74 6f 20 64 6f 20 72 65 63 65 6e 74 6c ed to do recentl
c5c0: 79 20 66 61 69 6c 65 64 20 77 69 74 68 20 61 6e y failed with an
c5d0: 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 65 SQLITE_LOCKED e
c5e0: 72 72 6f 72 20 64 75 65 20 74 6f 20 6c 6f 63 6b rror due to lock
c5f0: 73 0a 20 20 2a 2a 20 68 65 6c 64 20 62 79 20 59 s. ** held by Y
c600: 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 .. */. sqlite3
c610: 20 2a 70 42 6c 6f 63 6b 69 6e 67 43 6f 6e 6e 65 *pBlockingConne
c620: 63 74 69 6f 6e 3b 20 2f 2a 20 43 6f 6e 6e 65 63 ction; /* Connec
c630: 74 69 6f 6e 20 74 68 61 74 20 63 61 75 73 65 64 tion that caused
c640: 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 2a SQLITE_LOCKED *
c650: 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 55 6e /. sqlite3 *pUn
c660: 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 6f 6e 3b 20 lockConnection;
c670: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e /* Con
c680: 6e 65 63 74 69 6f 6e 20 74 6f 20 77 61 74 63 68 nection to watch
c690: 20 66 6f 72 20 75 6e 6c 6f 63 6b 20 2a 2f 0a 20 for unlock */.
c6a0: 20 76 6f 69 64 20 2a 70 55 6e 6c 6f 63 6b 41 72 void *pUnlockAr
c6b0: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
c6c0: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 /* Argume
c6d0: 6e 74 20 74 6f 20 78 55 6e 6c 6f 63 6b 4e 6f 74 nt to xUnlockNot
c6e0: 69 66 79 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a ify */. void (*
c6f0: 78 55 6e 6c 6f 63 6b 4e 6f 74 69 66 79 29 28 76 xUnlockNotify)(v
c700: 6f 69 64 20 2a 2a 2c 20 69 6e 74 29 3b 20 20 2f oid **, int); /
c710: 2a 20 55 6e 6c 6f 63 6b 20 6e 6f 74 69 66 79 20 * Unlock notify
c720: 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 73 71 callback */. sq
c730: 6c 69 74 65 33 20 2a 70 4e 65 78 74 42 6c 6f 63 lite3 *pNextBloc
c740: 6b 65 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e ked; /* N
c750: 65 78 74 20 69 6e 20 6c 69 73 74 20 6f 66 20 61 ext in list of a
c760: 6c 6c 20 62 6c 6f 63 6b 65 64 20 63 6f 6e 6e 65 ll blocked conne
c770: 63 74 69 6f 6e 73 20 2a 2f 0a 23 65 6e 64 69 66 ctions */.#endif
c780: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 .#ifdef SQLITE_U
c790: 53 45 52 5f 41 55 54 48 45 4e 54 49 43 41 54 49 SER_AUTHENTICATI
c7a0: 4f 4e 0a 20 20 73 71 6c 69 74 65 33 5f 75 73 65 ON. sqlite3_use
c7b0: 72 61 75 74 68 20 61 75 74 68 3b 20 20 20 20 20 rauth auth;
c7c0: 20 20 20 2f 2a 20 55 73 65 72 20 61 75 74 68 65 /* User authe
c7d0: 6e 74 69 63 61 74 69 6f 6e 20 69 6e 66 6f 72 6d ntication inform
c7e0: 61 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a ation */.#endif.
c7f0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 6d 61 63 72 };../*.** A macr
c800: 6f 20 74 6f 20 64 69 73 63 6f 76 65 72 20 74 68 o to discover th
c810: 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 61 20 e encoding of a
c820: 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a 23 64 65 database..*/.#de
c830: 66 69 6e 65 20 53 43 48 45 4d 41 5f 45 4e 43 28 fine SCHEMA_ENC(
c840: 64 62 29 20 28 28 64 62 29 2d 3e 61 44 62 5b 30 db) ((db)->aDb[0
c850: 5d 2e 70 53 63 68 65 6d 61 2d 3e 65 6e 63 29 0a ].pSchema->enc).
c860: 23 64 65 66 69 6e 65 20 45 4e 43 28 64 62 29 20 #define ENC(db)
c870: 20 20 20 20 20 20 20 28 28 64 62 29 2d 3e 65 6e ((db)->en
c880: 63 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 c)../*.** Possib
c890: 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 le values for th
c8a0: 65 20 73 71 6c 69 74 65 33 2e 66 6c 61 67 73 2e e sqlite3.flags.
c8b0: 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e .**.** Value con
c8c0: 73 74 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 63 straints (enforc
c8d0: 65 64 20 76 69 61 20 61 73 73 65 72 74 28 29 29 ed via assert())
c8e0: 3a 0a 2a 2a 20 20 20 20 20 20 53 51 4c 49 54 45 :.** SQLITE
c8f0: 5f 46 75 6c 6c 46 53 79 6e 63 20 20 20 20 20 3d _FullFSync =
c900: 3d 20 50 41 47 45 52 5f 46 55 4c 4c 46 53 59 4e = PAGER_FULLFSYN
c910: 43 0a 2a 2a 20 20 20 20 20 20 53 51 4c 49 54 45 C.** SQLITE
c920: 5f 43 6b 70 74 46 75 6c 6c 46 53 79 6e 63 20 3d _CkptFullFSync =
c930: 3d 20 50 41 47 45 52 5f 43 4b 50 54 5f 46 55 4c = PAGER_CKPT_FUL
c940: 4c 46 53 59 4e 43 0a 2a 2a 20 20 20 20 20 20 53 LFSYNC.** S
c950: 51 4c 49 54 45 5f 43 61 63 68 65 53 70 69 6c 6c QLITE_CacheSpill
c960: 20 20 20 20 3d 3d 20 50 41 47 45 52 5f 43 41 43 == PAGER_CAC
c970: 48 45 5f 53 50 49 4c 4c 0a 2a 2f 0a 23 64 65 66 HE_SPILL.*/.#def
c980: 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 62 65 54 ine SQLITE_VdbeT
c990: 72 61 63 65 20 20 20 20 20 20 30 78 30 30 30 30 race 0x0000
c9a0: 30 30 30 31 20 20 2f 2a 20 54 72 75 65 20 74 6f 0001 /* True to
c9b0: 20 74 72 61 63 65 20 56 44 42 45 20 65 78 65 63 trace VDBE exec
c9c0: 75 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 ution */.#define
c9d0: 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 SQLITE_InternCh
c9e0: 61 6e 67 65 73 20 20 30 78 30 30 30 30 30 30 30 anges 0x0000000
c9f0: 32 20 20 2f 2a 20 55 6e 63 6f 6d 6d 69 74 74 65 2 /* Uncommitte
ca00: 64 20 48 61 73 68 20 74 61 62 6c 65 20 63 68 61 d Hash table cha
ca10: 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 nges */.#define
ca20: 53 51 4c 49 54 45 5f 46 75 6c 6c 43 6f 6c 4e 61 SQLITE_FullColNa
ca30: 6d 65 73 20 20 20 30 78 30 30 30 30 30 30 30 34 mes 0x00000004
ca40: 20 20 2f 2a 20 53 68 6f 77 20 66 75 6c 6c 20 63 /* Show full c
ca50: 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 6f 6e 20 53 olumn names on S
ca60: 45 4c 45 43 54 20 2a 2f 0a 23 64 65 66 69 6e 65 ELECT */.#define
ca70: 20 53 51 4c 49 54 45 5f 46 75 6c 6c 46 53 79 6e SQLITE_FullFSyn
ca80: 63 20 20 20 20 20 20 30 78 30 30 30 30 30 30 30 c 0x0000000
ca90: 38 20 20 2f 2a 20 55 73 65 20 66 75 6c 6c 20 66 8 /* Use full f
caa0: 73 79 6e 63 20 6f 6e 20 74 68 65 20 62 61 63 6b sync on the back
cab0: 65 6e 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 end */.#define S
cac0: 51 4c 49 54 45 5f 43 6b 70 74 46 75 6c 6c 46 53 QLITE_CkptFullFS
cad0: 79 6e 63 20 20 30 78 30 30 30 30 30 30 31 30 20 ync 0x00000010
cae0: 20 2f 2a 20 55 73 65 20 66 75 6c 6c 20 66 73 79 /* Use full fsy
caf0: 6e 63 20 66 6f 72 20 63 68 65 63 6b 70 6f 69 6e nc for checkpoin
cb00: 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c t */.#define SQL
cb10: 49 54 45 5f 43 61 63 68 65 53 70 69 6c 6c 20 20 ITE_CacheSpill
cb20: 20 20 20 30 78 30 30 30 30 30 30 32 30 20 20 2f 0x00000020 /
cb30: 2a 20 4f 4b 20 74 6f 20 73 70 69 6c 6c 20 70 61 * OK to spill pa
cb40: 67 65 72 20 63 61 63 68 65 20 2a 2f 0a 23 64 65 ger cache */.#de
cb50: 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 68 6f 72 fine SQLITE_Shor
cb60: 74 43 6f 6c 4e 61 6d 65 73 20 20 30 78 30 30 30 tColNames 0x000
cb70: 30 30 30 34 30 20 20 2f 2a 20 53 68 6f 77 20 73 00040 /* Show s
cb80: 68 6f 72 74 20 63 6f 6c 75 6d 6e 73 20 6e 61 6d hort columns nam
cb90: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
cba0: 4c 49 54 45 5f 43 6f 75 6e 74 52 6f 77 73 20 20 LITE_CountRows
cbb0: 20 20 20 20 30 78 30 30 30 30 30 30 38 30 20 20 0x00000080
cbc0: 2f 2a 20 43 6f 75 6e 74 20 72 6f 77 73 20 63 68 /* Count rows ch
cbd0: 61 6e 67 65 64 20 62 79 20 49 4e 53 45 52 54 2c anged by INSERT,
cbe0: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 */.
cbf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cc00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
cc10: 20 20 20 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 DELETE, or UP
cc20: 44 41 54 45 20 61 6e 64 20 72 65 74 75 72 6e 20 DATE and return
cc30: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 */.
cc40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
cc50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
cc60: 20 20 74 68 65 20 63 6f 75 6e 74 20 75 73 69 6e the count usin
cc70: 67 20 61 20 63 61 6c 6c 62 61 63 6b 2e 20 2a 2f g a callback. */
cc80: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
cc90: 4e 75 6c 6c 43 61 6c 6c 62 61 63 6b 20 20 20 30 NullCallback 0
cca0: 78 30 30 30 30 30 31 30 30 20 20 2f 2a 20 49 6e x00000100 /* In
ccb0: 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63 voke the callbac
ccc0: 6b 20 6f 6e 63 65 20 69 66 20 74 68 65 20 2a 2f k once if the */
ccd0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
cce0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ccf0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 20 /*
cd00: 72 65 73 75 6c 74 20 73 65 74 20 69 73 20 65 6d result set is em
cd10: 70 74 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 pty */.#define S
cd20: 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65 20 20 QLITE_SqlTrace
cd30: 20 20 20 20 20 30 78 30 30 30 30 30 32 30 30 20 0x00000200
cd40: 20 2f 2a 20 44 65 62 75 67 20 70 72 69 6e 74 20 /* Debug print
cd50: 53 51 4c 20 61 73 20 69 74 20 65 78 65 63 75 74 SQL as it execut
cd60: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
cd70: 4c 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e 67 LITE_VdbeListing
cd80: 20 20 20 20 30 78 30 30 30 30 30 34 30 30 20 20 0x00000400
cd90: 2f 2a 20 44 65 62 75 67 20 6c 69 73 74 69 6e 67 /* Debug listing
cda0: 73 20 6f 66 20 56 44 42 45 20 70 72 6f 67 72 61 s of VDBE progra
cdb0: 6d 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ms */.#define SQ
cdc0: 4c 49 54 45 5f 57 72 69 74 65 53 63 68 65 6d 61 LITE_WriteSchema
cdd0: 20 20 20 20 30 78 30 30 30 30 30 38 30 30 20 20 0x00000800
cde0: 2f 2a 20 4f 4b 20 74 6f 20 75 70 64 61 74 65 20 /* OK to update
cdf0: 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 2a 2f SQLITE_MASTER */
ce00: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
ce10: 56 64 62 65 41 64 64 6f 70 54 72 61 63 65 20 30 VdbeAddopTrace 0
ce20: 78 30 30 30 30 31 30 30 30 20 20 2f 2a 20 54 72 x00001000 /* Tr
ce30: 61 63 65 20 73 71 6c 69 74 65 33 56 64 62 65 41 ace sqlite3VdbeA
ce40: 64 64 4f 70 28 29 20 63 61 6c 6c 73 20 2a 2f 0a ddOp() calls */.
ce50: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 #define SQLITE_I
ce60: 67 6e 6f 72 65 43 68 65 63 6b 73 20 20 20 30 78 gnoreChecks 0x
ce70: 30 30 30 30 32 30 30 30 20 20 2f 2a 20 44 6f 20 00002000 /* Do
ce80: 6e 6f 74 20 65 6e 66 6f 72 63 65 20 63 68 65 63 not enforce chec
ce90: 6b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f k constraints */
cea0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
ceb0: 52 65 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 20 ReadUncommitted
cec0: 30 78 30 30 30 34 30 30 30 20 20 2f 2a 20 46 6f 0x0004000 /* Fo
ced0: 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d r shared-cache m
cee0: 6f 64 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ode */.#define S
cef0: 51 4c 49 54 45 5f 4c 65 67 61 63 79 46 69 6c 65 QLITE_LegacyFile
cf00: 46 6d 74 20 20 30 78 30 30 30 30 38 30 30 30 20 Fmt 0x00008000
cf10: 20 2f 2a 20 43 72 65 61 74 65 20 6e 65 77 20 64 /* Create new d
cf20: 61 74 61 62 61 73 65 73 20 69 6e 20 66 6f 72 6d atabases in form
cf30: 61 74 20 31 20 2a 2f 0a 23 64 65 66 69 6e 65 20 at 1 */.#define
cf40: 53 51 4c 49 54 45 5f 52 65 63 6f 76 65 72 79 4d SQLITE_RecoveryM
cf50: 6f 64 65 20 20 20 30 78 30 30 30 31 30 30 30 30 ode 0x00010000
cf60: 20 20 2f 2a 20 49 67 6e 6f 72 65 20 73 63 68 65 /* Ignore sche
cf70: 6d 61 20 65 72 72 6f 72 73 20 2a 2f 0a 23 64 65 ma errors */.#de
cf80: 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 76 65 fine SQLITE_Reve
cf90: 72 73 65 4f 72 64 65 72 20 20 20 30 78 30 30 30 rseOrder 0x000
cfa0: 32 30 30 30 30 20 20 2f 2a 20 52 65 76 65 72 73 20000 /* Revers
cfb0: 65 20 75 6e 6f 72 64 65 72 65 64 20 53 45 4c 45 e unordered SELE
cfc0: 43 54 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 CTs */.#define S
cfd0: 51 4c 49 54 45 5f 52 65 63 54 72 69 67 67 65 72 QLITE_RecTrigger
cfe0: 73 20 20 20 20 30 78 30 30 30 34 30 30 30 30 20 s 0x00040000
cff0: 20 2f 2a 20 45 6e 61 62 6c 65 20 72 65 63 75 72 /* Enable recur
d000: 73 69 76 65 20 74 72 69 67 67 65 72 73 20 2a 2f sive triggers */
d010: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
d020: 46 6f 72 65 69 67 6e 4b 65 79 73 20 20 20 20 30 ForeignKeys 0
d030: 78 30 30 30 38 30 30 30 30 20 20 2f 2a 20 45 6e x00080000 /* En
d040: 66 6f 72 63 65 20 66 6f 72 65 69 67 6e 20 6b 65 force foreign ke
d050: 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 20 2a y constraints *
d060: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
d070: 5f 41 75 74 6f 49 6e 64 65 78 20 20 20 20 20 20 _AutoIndex
d080: 30 78 30 30 31 30 30 30 30 30 20 20 2f 2a 20 45 0x00100000 /* E
d090: 6e 61 62 6c 65 20 61 75 74 6f 6d 61 74 69 63 20 nable automatic
d0a0: 69 6e 64 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 indexes */.#defi
d0b0: 6e 65 20 53 51 4c 49 54 45 5f 50 72 65 66 65 72 ne SQLITE_Prefer
d0c0: 42 75 69 6c 74 69 6e 20 20 30 78 30 30 32 30 30 Builtin 0x00200
d0d0: 30 30 30 20 20 2f 2a 20 50 72 65 66 65 72 65 6e 000 /* Preferen
d0e0: 63 65 20 74 6f 20 62 75 69 6c 74 2d 69 6e 20 66 ce to built-in f
d0f0: 75 6e 63 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 uncs */.#define
d100: 53 51 4c 49 54 45 5f 4c 6f 61 64 45 78 74 65 6e SQLITE_LoadExten
d110: 73 69 6f 6e 20 20 30 78 30 30 34 30 30 30 30 30 sion 0x00400000
d120: 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6c 6f 61 64 /* Enable load
d130: 5f 65 78 74 65 6e 73 69 6f 6e 20 2a 2f 0a 23 64 _extension */.#d
d140: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 6f 61 efine SQLITE_Loa
d150: 64 45 78 74 46 75 6e 63 20 20 20 20 30 78 30 30 dExtFunc 0x00
d160: 38 30 30 30 30 30 20 20 2f 2a 20 45 6e 61 62 6c 800000 /* Enabl
d170: 65 20 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f 6e e load_extension
d180: 28 29 20 53 51 4c 20 66 75 6e 63 20 2a 2f 0a 23 () SQL func */.#
d190: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 6e define SQLITE_En
d1a0: 61 62 6c 65 54 72 69 67 67 65 72 20 20 30 78 30 ableTrigger 0x0
d1b0: 31 30 30 30 30 30 30 20 20 2f 2a 20 54 72 75 65 1000000 /* True
d1c0: 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 69 67 67 to enable trigg
d1d0: 65 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ers */.#define S
d1e0: 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 20 20 QLITE_DeferFKs
d1f0: 20 20 20 20 20 30 78 30 32 30 30 30 30 30 30 20 0x02000000
d200: 20 2f 2a 20 44 65 66 65 72 20 61 6c 6c 20 46 4b /* Defer all FK
d210: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
d220: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 51 #define SQLITE_Q
d230: 75 65 72 79 4f 6e 6c 79 20 20 20 20 20 20 30 78 ueryOnly 0x
d240: 30 34 30 30 30 30 30 30 20 20 2f 2a 20 44 69 73 04000000 /* Dis
d250: 61 62 6c 65 20 64 61 74 61 62 61 73 65 20 63 68 able database ch
d260: 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 anges */.#define
d270: 20 53 51 4c 49 54 45 5f 56 64 62 65 45 51 50 20 SQLITE_VdbeEQP
d280: 20 20 20 20 20 20 20 30 78 30 38 30 30 30 30 30 0x0800000
d290: 30 20 20 2f 2a 20 44 65 62 75 67 20 45 58 50 4c 0 /* Debug EXPL
d2a0: 41 49 4e 20 51 55 45 52 59 20 50 4c 41 4e 20 2a AIN QUERY PLAN *
d2b0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
d2c0: 5f 56 61 63 75 75 6d 20 20 20 20 20 20 20 20 20 _Vacuum
d2d0: 30 78 31 30 30 30 30 30 30 30 20 20 2f 2a 20 43 0x10000000 /* C
d2e0: 75 72 72 65 6e 74 6c 79 20 69 6e 20 61 20 56 41 urrently in a VA
d2f0: 43 55 55 4d 20 2a 2f 0a 23 64 65 66 69 6e 65 20 CUUM */.#define
d300: 53 51 4c 49 54 45 5f 43 65 6c 6c 53 69 7a 65 43 SQLITE_CellSizeC
d310: 6b 20 20 20 20 20 30 78 32 30 30 30 30 30 30 30 k 0x20000000
d320: 20 20 2f 2a 20 43 68 65 63 6b 20 62 74 72 65 65 /* Check btree
d330: 20 63 65 6c 6c 20 73 69 7a 65 73 20 6f 6e 20 6c cell sizes on l
d340: 6f 61 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 oad */.#define S
d350: 51 4c 49 54 45 5f 46 74 73 33 54 6f 6b 65 6e 69 QLITE_Fts3Tokeni
d360: 7a 65 72 20 20 30 78 34 30 30 30 30 30 30 30 20 zer 0x40000000
d370: 20 2f 2a 20 45 6e 61 62 6c 65 20 66 74 73 33 5f /* Enable fts3_
d380: 74 6f 6b 65 6e 69 7a 65 72 28 32 29 20 2a 2f 0a tokenizer(2) */.
d390: 0a 0a 2f 2a 0a 2a 2a 20 42 69 74 73 20 6f 66 20 ../*.** Bits of
d3a0: 74 68 65 20 73 71 6c 69 74 65 33 2e 64 62 4f 70 the sqlite3.dbOp
d3b0: 74 46 6c 61 67 73 20 66 69 65 6c 64 20 74 68 61 tFlags field tha
d3c0: 74 20 61 72 65 20 75 73 65 64 20 62 79 20 74 68 t are used by th
d3d0: 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 e.** sqlite3_tes
d3e0: 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 54 45 t_control(SQLITE
d3f0: 5f 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 _TESTCTRL_OPTIMI
d400: 5a 41 54 49 4f 4e 53 2c 2e 2e 2e 29 20 69 6e 74 ZATIONS,...) int
d410: 65 72 66 61 63 65 20 74 6f 0a 2a 2a 20 73 65 6c erface to.** sel
d420: 65 63 74 69 76 65 6c 79 20 64 69 73 61 62 6c 65 ectively disable
d430: 20 76 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 7a various optimiz
d440: 61 74 69 6f 6e 73 2e 0a 2a 2f 0a 23 64 65 66 69 ations..*/.#defi
d450: 6e 65 20 53 51 4c 49 54 45 5f 51 75 65 72 79 46 ne SQLITE_QueryF
d460: 6c 61 74 74 65 6e 65 72 20 30 78 30 30 30 31 20 lattener 0x0001
d470: 20 20 2f 2a 20 51 75 65 72 79 20 66 6c 61 74 74 /* Query flatt
d480: 65 6e 69 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 ening */.#define
d490: 20 53 51 4c 49 54 45 5f 43 6f 6c 75 6d 6e 43 61 SQLITE_ColumnCa
d4a0: 63 68 65 20 20 20 20 30 78 30 30 30 32 20 20 20 che 0x0002
d4b0: 2f 2a 20 43 6f 6c 75 6d 6e 20 63 61 63 68 65 20 /* Column cache
d4c0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
d4d0: 45 5f 47 72 6f 75 70 42 79 4f 72 64 65 72 20 20 E_GroupByOrder
d4e0: 20 30 78 30 30 30 34 20 20 20 2f 2a 20 47 52 4f 0x0004 /* GRO
d4f0: 55 50 42 59 20 63 6f 76 65 72 20 6f 66 20 4f 52 UPBY cover of OR
d500: 44 45 52 42 59 20 2a 2f 0a 23 64 65 66 69 6e 65 DERBY */.#define
d510: 20 53 51 4c 49 54 45 5f 46 61 63 74 6f 72 4f 75 SQLITE_FactorOu
d520: 74 43 6f 6e 73 74 20 30 78 30 30 30 38 20 20 20 tConst 0x0008
d530: 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 66 61 63 74 /* Constant fact
d540: 6f 72 69 6e 67 20 2a 2f 0a 2f 2a 20 20 20 20 20 oring */./*
d550: 20 20 20 20 20 20 20 20 20 20 20 6e 6f 74 20 75 not u
d560: 73 65 64 20 20 20 20 30 78 30 30 31 30 20 20 20 sed 0x0010
d570: 2f 2f 20 57 61 73 3a 20 53 51 4c 49 54 45 5f 49 // Was: SQLITE_I
d580: 64 78 52 65 61 6c 41 73 49 6e 74 20 2a 2f 0a 23 dxRealAsInt */.#
d590: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 69 define SQLITE_Di
d5a0: 73 74 69 6e 63 74 4f 70 74 20 20 20 20 30 78 30 stinctOpt 0x0
d5b0: 30 32 30 20 20 20 2f 2a 20 44 49 53 54 49 4e 43 020 /* DISTINC
d5c0: 54 20 75 73 69 6e 67 20 69 6e 64 65 78 65 73 20 T using indexes
d5d0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
d5e0: 45 5f 43 6f 76 65 72 49 64 78 53 63 61 6e 20 20 E_CoverIdxScan
d5f0: 20 30 78 30 30 34 30 20 20 20 2f 2a 20 43 6f 76 0x0040 /* Cov
d600: 65 72 69 6e 67 20 69 6e 64 65 78 20 73 63 61 6e ering index scan
d610: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
d620: 49 54 45 5f 4f 72 64 65 72 42 79 49 64 78 4a 6f ITE_OrderByIdxJo
d630: 69 6e 20 30 78 30 30 38 30 20 20 20 2f 2a 20 4f in 0x0080 /* O
d640: 52 44 45 52 20 42 59 20 6f 66 20 6a 6f 69 6e 73 RDER BY of joins
d650: 20 76 69 61 20 69 6e 64 65 78 20 2a 2f 0a 23 64 via index */.#d
d660: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 75 62 efine SQLITE_Sub
d670: 71 43 6f 72 6f 75 74 69 6e 65 20 20 30 78 30 31 qCoroutine 0x01
d680: 30 30 20 20 20 2f 2a 20 45 76 61 6c 75 61 74 65 00 /* Evaluate
d690: 20 73 75 62 71 75 65 72 69 65 73 20 61 73 20 63 subqueries as c
d6a0: 6f 72 6f 75 74 69 6e 65 73 20 2a 2f 0a 23 64 65 oroutines */.#de
d6b0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 72 61 6e fine SQLITE_Tran
d6c0: 73 69 74 69 76 65 20 20 20 20 20 30 78 30 32 30 sitive 0x020
d6d0: 30 20 20 20 2f 2a 20 54 72 61 6e 73 69 74 69 76 0 /* Transitiv
d6e0: 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f e constraints */
d6f0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
d700: 4f 6d 69 74 4e 6f 6f 70 4a 6f 69 6e 20 20 20 30 OmitNoopJoin 0
d710: 78 30 34 30 30 20 20 20 2f 2a 20 4f 6d 69 74 20 x0400 /* Omit
d720: 75 6e 75 73 65 64 20 74 61 62 6c 65 73 20 69 6e unused tables in
d730: 20 6a 6f 69 6e 73 20 2a 2f 0a 23 64 65 66 69 6e joins */.#defin
d740: 65 20 53 51 4c 49 54 45 5f 53 74 61 74 33 34 20 e SQLITE_Stat34
d750: 20 20 20 20 20 20 20 20 30 78 30 38 30 30 20 20 0x0800
d760: 20 2f 2a 20 55 73 65 20 53 54 41 54 33 20 6f 72 /* Use STAT3 or
d770: 20 53 54 41 54 34 20 64 61 74 61 20 2a 2f 0a 23 STAT4 data */.#
d780: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 75 define SQLITE_Cu
d790: 72 73 6f 72 48 69 6e 74 73 20 20 20 20 30 78 32 rsorHints 0x2
d7a0: 30 30 30 20 20 20 2f 2a 20 41 64 64 20 4f 50 5f 000 /* Add OP_
d7b0: 43 75 72 73 6f 72 48 69 6e 74 20 6f 70 63 6f 64 CursorHint opcod
d7c0: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
d7d0: 4c 49 54 45 5f 41 6c 6c 4f 70 74 73 20 20 20 20 LITE_AllOpts
d7e0: 20 20 20 20 30 78 66 66 66 66 20 20 20 2f 2a 20 0xffff /*
d7f0: 41 6c 6c 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e All optimization
d800: 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 s */../*.** Macr
d810: 6f 73 20 66 6f 72 20 74 65 73 74 69 6e 67 20 77 os for testing w
d820: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 6f 70 hether or not op
d830: 74 69 6d 69 7a 61 74 69 6f 6e 73 20 61 72 65 20 timizations are
d840: 65 6e 61 62 6c 65 64 20 6f 72 20 64 69 73 61 62 enabled or disab
d850: 6c 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 led..*/.#ifndef
d860: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c SQLITE_OMIT_BUIL
d870: 54 49 4e 5f 54 45 53 54 0a 23 64 65 66 69 6e 65 TIN_TEST.#define
d880: 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 44 69 73 OptimizationDis
d890: 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b 29 20 abled(db, mask)
d8a0: 20 28 28 28 64 62 29 2d 3e 64 62 4f 70 74 46 6c (((db)->dbOptFl
d8b0: 61 67 73 26 28 6d 61 73 6b 29 29 21 3d 30 29 0a ags&(mask))!=0).
d8c0: 23 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 #define Optimiza
d8d0: 74 69 6f 6e 45 6e 61 62 6c 65 64 28 64 62 2c 20 tionEnabled(db,
d8e0: 6d 61 73 6b 29 20 20 20 28 28 28 64 62 29 2d 3e mask) (((db)->
d8f0: 64 62 4f 70 74 46 6c 61 67 73 26 28 6d 61 73 6b dbOptFlags&(mask
d900: 29 29 3d 3d 30 29 0a 23 65 6c 73 65 0a 23 64 65 ))==0).#else.#de
d910: 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f fine Optimizatio
d920: 6e 44 69 73 61 62 6c 65 64 28 64 62 2c 20 6d 61 nDisabled(db, ma
d930: 73 6b 29 20 20 30 0a 23 64 65 66 69 6e 65 20 4f sk) 0.#define O
d940: 70 74 69 6d 69 7a 61 74 69 6f 6e 45 6e 61 62 6c ptimizationEnabl
d950: 65 64 28 64 62 2c 20 6d 61 73 6b 29 20 20 20 31 ed(db, mask) 1
d960: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 .#endif../*.** R
d970: 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 eturn true if it
d980: 20 4f 4b 20 74 6f 20 66 61 63 74 6f 72 20 63 6f OK to factor co
d990: 6e 73 74 61 6e 74 20 65 78 70 72 65 73 73 69 6f nstant expressio
d9a0: 6e 73 20 69 6e 74 6f 20 74 68 65 20 69 6e 69 74 ns into the init
d9b0: 69 61 6c 69 7a 61 74 69 6f 6e 0a 2a 2a 20 63 6f ialization.** co
d9c0: 64 65 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 de. The argument
d9d0: 20 69 73 20 61 20 50 61 72 73 65 20 6f 62 6a 65 is a Parse obje
d9e0: 63 74 20 66 6f 72 20 74 68 65 20 63 6f 64 65 20 ct for the code
d9f0: 67 65 6e 65 72 61 74 6f 72 2e 0a 2a 2f 0a 23 64 generator..*/.#d
da00: 65 66 69 6e 65 20 43 6f 6e 73 74 46 61 63 74 6f efine ConstFacto
da10: 72 4f 6b 28 50 29 20 28 28 50 29 2d 3e 6f 6b 43 rOk(P) ((P)->okC
da20: 6f 6e 73 74 46 61 63 74 6f 72 29 0a 0a 2f 2a 0a onstFactor)../*.
da30: 2a 2a 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 ** Possible valu
da40: 65 73 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 es for the sqlit
da50: 65 2e 6d 61 67 69 63 20 66 69 65 6c 64 2e 0a 2a e.magic field..*
da60: 2a 20 54 68 65 20 6e 75 6d 62 65 72 73 20 61 72 * The numbers ar
da70: 65 20 6f 62 74 61 69 6e 65 64 20 61 74 20 72 61 e obtained at ra
da80: 6e 64 6f 6d 20 61 6e 64 20 68 61 76 65 20 6e 6f ndom and have no
da90: 20 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e 67 special meaning
daa0: 2c 20 6f 74 68 65 72 0a 2a 2a 20 74 68 61 6e 20 , other.** than
dab0: 62 65 69 6e 67 20 64 69 73 74 69 6e 63 74 20 66 being distinct f
dac0: 72 6f 6d 20 6f 6e 65 20 61 6e 6f 74 68 65 72 2e rom one another.
dad0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .*/.#define SQLI
dae0: 54 45 5f 4d 41 47 49 43 5f 4f 50 45 4e 20 20 20 TE_MAGIC_OPEN
daf0: 20 20 30 78 61 30 32 39 61 36 39 37 20 20 2f 2a 0xa029a697 /*
db00: 20 44 61 74 61 62 61 73 65 20 69 73 20 6f 70 65 Database is ope
db10: 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c n */.#define SQL
db20: 49 54 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 ITE_MAGIC_CLOSED
db30: 20 20 20 30 78 39 66 33 63 32 64 33 33 20 20 2f 0x9f3c2d33 /
db40: 2a 20 44 61 74 61 62 61 73 65 20 69 73 20 63 6c * Database is cl
db50: 6f 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 osed */.#define
db60: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 53 49 43 SQLITE_MAGIC_SIC
db70: 4b 20 20 20 20 20 30 78 34 62 37 37 31 32 39 30 K 0x4b771290
db80: 20 20 2f 2a 20 45 72 72 6f 72 20 61 6e 64 20 61 /* Error and a
db90: 77 61 69 74 69 6e 67 20 63 6c 6f 73 65 20 2a 2f waiting close */
dba0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
dbb0: 4d 41 47 49 43 5f 42 55 53 59 20 20 20 20 20 30 MAGIC_BUSY 0
dbc0: 78 66 30 33 62 37 39 30 36 20 20 2f 2a 20 44 61 xf03b7906 /* Da
dbd0: 74 61 62 61 73 65 20 63 75 72 72 65 6e 74 6c 79 tabase currently
dbe0: 20 69 6e 20 75 73 65 20 2a 2f 0a 23 64 65 66 69 in use */.#defi
dbf0: 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f ne SQLITE_MAGIC_
dc00: 45 52 52 4f 52 20 20 20 20 30 78 62 35 33 35 37 ERROR 0xb5357
dc10: 39 33 30 20 20 2f 2a 20 41 6e 20 53 51 4c 49 54 930 /* An SQLIT
dc20: 45 5f 4d 49 53 55 53 45 20 65 72 72 6f 72 20 6f E_MISUSE error o
dc30: 63 63 75 72 72 65 64 20 2a 2f 0a 23 64 65 66 69 ccurred */.#defi
dc40: 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f ne SQLITE_MAGIC_
dc50: 5a 4f 4d 42 49 45 20 20 20 30 78 36 34 63 66 66 ZOMBIE 0x64cff
dc60: 63 37 66 20 20 2f 2a 20 43 6c 6f 73 65 20 77 69 c7f /* Close wi
dc70: 74 68 20 6c 61 73 74 20 73 74 61 74 65 6d 65 6e th last statemen
dc80: 74 20 63 6c 6f 73 65 20 2a 2f 0a 0a 2f 2a 0a 2a t close */../*.*
dc90: 2a 20 45 61 63 68 20 53 51 4c 20 66 75 6e 63 74 * Each SQL funct
dca0: 69 6f 6e 20 69 73 20 64 65 66 69 6e 65 64 20 62 ion is defined b
dcb0: 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 y an instance of
dcc0: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a the following.*
dcd0: 2a 20 73 74 72 75 63 74 75 72 65 2e 20 20 46 6f * structure. Fo
dce0: 72 20 67 6c 6f 62 61 6c 20 62 75 69 6c 74 2d 69 r global built-i
dcf0: 6e 20 66 75 6e 63 74 69 6f 6e 73 20 28 65 78 3a n functions (ex:
dd00: 20 73 75 62 73 74 72 28 29 2c 20 6d 61 78 28 29 substr(), max()
dd10: 2c 20 63 6f 75 6e 74 28 29 29 0a 2a 2a 20 61 20 , count()).** a
dd20: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 20 pointer to this
dd30: 73 74 72 75 63 74 75 72 65 20 69 73 20 68 65 6c structure is hel
dd40: 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 33 d in the sqlite3
dd50: 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 BuiltinFunctions
dd60: 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 46 6f 72 20 object..** For
dd70: 70 65 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 per-connection a
dd80: 70 70 6c 69 63 61 74 69 6f 6e 2d 64 65 66 69 6e pplication-defin
dd90: 65 64 20 66 75 6e 63 74 69 6f 6e 73 2c 20 61 20 ed functions, a
dda0: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 0a pointer to this.
ddb0: 2a 2a 20 73 74 72 75 63 74 75 72 65 20 69 73 20 ** structure is
ddc0: 68 65 6c 64 20 69 6e 20 74 68 65 20 64 62 2d 3e held in the db->
ddd0: 61 48 61 73 68 20 68 61 73 68 20 74 61 62 6c 65 aHash hash table
dde0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 75 2e 70 48 ..**.** The u.pH
ddf0: 61 73 68 20 66 69 65 6c 64 20 69 73 20 75 73 65 ash field is use
de00: 64 20 62 79 20 74 68 65 20 67 6c 6f 62 61 6c 20 d by the global
de10: 62 75 69 6c 74 2d 69 6e 73 2e 20 20 54 68 65 20 built-ins. The
de20: 75 2e 70 44 65 73 74 72 75 63 74 6f 72 0a 2a 2a u.pDestructor.**
de30: 20 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 62 field is used b
de40: 79 20 70 65 72 2d 63 6f 6e 6e 65 63 74 69 6f 6e y per-connection
de50: 20 61 70 70 2d 64 65 66 20 66 75 6e 63 74 69 6f app-def functio
de60: 6e 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 46 75 ns..*/.struct Fu
de70: 6e 63 44 65 66 20 7b 0a 20 20 69 38 20 6e 41 72 ncDef {. i8 nAr
de80: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f g; /
de90: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 * Number of argu
dea0: 6d 65 6e 74 73 2e 20 20 2d 31 20 6d 65 61 6e 73 ments. -1 means
deb0: 20 75 6e 6c 69 6d 69 74 65 64 20 2a 2f 0a 20 20 unlimited */.
dec0: 75 31 36 20 66 75 6e 63 46 6c 61 67 73 3b 20 20 u16 funcFlags;
ded0: 20 20 20 20 20 2f 2a 20 53 6f 6d 65 20 63 6f 6d /* Some com
dee0: 62 69 6e 61 74 69 6f 6e 20 6f 66 20 53 51 4c 49 bination of SQLI
def0: 54 45 5f 46 55 4e 43 5f 2a 20 2a 2f 0a 20 20 76 TE_FUNC_* */. v
df00: 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 3b 20 oid *pUserData;
df10: 20 20 20 20 2f 2a 20 55 73 65 72 20 64 61 74 61 /* User data
df20: 20 70 61 72 61 6d 65 74 65 72 20 2a 2f 0a 20 20 parameter */.
df30: 46 75 6e 63 44 65 66 20 2a 70 4e 65 78 74 3b 20 FuncDef *pNext;
df40: 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 66 75 6e /* Next fun
df50: 63 74 69 6f 6e 20 77 69 74 68 20 73 61 6d 65 20 ction with same
df60: 6e 61 6d 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28 name */. void (
df70: 2a 78 53 46 75 6e 63 29 28 73 71 6c 69 74 65 33 *xSFunc)(sqlite3
df80: 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
df90: 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 20 lite3_value**);
dfa0: 2f 2a 20 66 75 6e 63 20 6f 72 20 61 67 67 2d 73 /* func or agg-s
dfb0: 74 65 70 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a tep */. void (*
dfc0: 78 46 69 6e 61 6c 69 7a 65 29 28 73 71 6c 69 74 xFinalize)(sqlit
dfd0: 65 33 5f 63 6f 6e 74 65 78 74 2a 29 3b 20 20 20 e3_context*);
dfe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
dff0: 2a 20 41 67 67 20 66 69 6e 61 6c 69 7a 65 72 20 * Agg finalizer
e000: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
e010: 2a 7a 4e 61 6d 65 3b 20 20 20 2f 2a 20 53 51 4c *zName; /* SQL
e020: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 75 6e name of the fun
e030: 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 75 6e 69 6f ction. */. unio
e040: 6e 20 7b 0a 20 20 20 20 46 75 6e 63 44 65 66 20 n {. FuncDef
e050: 2a 70 48 61 73 68 3b 20 20 20 20 20 20 2f 2a 20 *pHash; /*
e060: 4e 65 78 74 20 77 69 74 68 20 61 20 64 69 66 66 Next with a diff
e070: 65 72 65 6e 74 20 6e 61 6d 65 20 62 75 74 20 74 erent name but t
e080: 68 65 20 73 61 6d 65 20 68 61 73 68 20 2a 2f 0a he same hash */.
e090: 20 20 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 FuncDestruct
e0a0: 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f 72 3b or *pDestructor;
e0b0: 20 20 20 2f 2a 20 52 65 66 65 72 65 6e 63 65 20 /* Reference
e0c0: 63 6f 75 6e 74 65 64 20 64 65 73 74 72 75 63 74 counted destruct
e0d0: 6f 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 or function */.
e0e0: 20 7d 20 75 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 } u;.};../*.**
e0f0: 54 68 69 73 20 73 74 72 75 63 74 75 72 65 20 65 This structure e
e100: 6e 63 61 70 73 75 6c 61 74 65 73 20 61 20 75 73 ncapsulates a us
e110: 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 73 74 er-function dest
e120: 72 75 63 74 6f 72 20 63 61 6c 6c 62 61 63 6b 20 ructor callback
e130: 28 61 73 0a 2a 2a 20 63 6f 6e 66 69 67 75 72 65 (as.** configure
e140: 64 20 75 73 69 6e 67 20 63 72 65 61 74 65 5f 66 d using create_f
e150: 75 6e 63 74 69 6f 6e 5f 76 32 28 29 29 20 61 6e unction_v2()) an
e160: 64 20 61 20 72 65 66 65 72 65 6e 63 65 20 63 6f d a reference co
e170: 75 6e 74 65 72 2e 20 57 68 65 6e 0a 2a 2a 20 63 unter. When.** c
e180: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 reate_function_v
e190: 32 28 29 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 2() is called to
e1a0: 20 63 72 65 61 74 65 20 61 20 66 75 6e 63 74 69 create a functi
e1b0: 6f 6e 20 77 69 74 68 20 61 20 64 65 73 74 72 75 on with a destru
e1c0: 63 74 6f 72 2c 0a 2a 2a 20 61 20 73 69 6e 67 6c ctor,.** a singl
e1d0: 65 20 6f 62 6a 65 63 74 20 6f 66 20 74 68 69 73 e object of this
e1e0: 20 74 79 70 65 20 69 73 20 61 6c 6c 6f 63 61 74 type is allocat
e1f0: 65 64 2e 20 46 75 6e 63 44 65 73 74 72 75 63 74 ed. FuncDestruct
e200: 6f 72 2e 6e 52 65 66 20 69 73 20 73 65 74 20 74 or.nRef is set t
e210: 6f 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 65 72 20 o.** the number
e220: 6f 66 20 46 75 6e 63 44 65 66 20 6f 62 6a 65 63 of FuncDef objec
e230: 74 73 20 63 72 65 61 74 65 64 20 28 65 69 74 68 ts created (eith
e240: 65 72 20 31 20 6f 72 20 33 2c 20 64 65 70 65 6e er 1 or 3, depen
e250: 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 72 0a ding on whether.
e260: 2a 2a 20 6f 72 20 6e 6f 74 20 74 68 65 20 73 70 ** or not the sp
e270: 65 63 69 66 69 65 64 20 65 6e 63 6f 64 69 6e 67 ecified encoding
e280: 20 69 73 20 53 51 4c 49 54 45 5f 41 4e 59 29 2e is SQLITE_ANY).
e290: 20 54 68 65 20 46 75 6e 63 44 65 66 2e 70 44 65 The FuncDef.pDe
e2a0: 73 74 72 75 63 74 6f 72 0a 2a 2a 20 6d 65 6d 62 structor.** memb
e2b0: 65 72 20 6f 66 20 65 61 63 68 20 6f 66 20 74 68 er of each of th
e2c0: 65 20 6e 65 77 20 46 75 6e 63 44 65 66 20 6f 62 e new FuncDef ob
e2d0: 6a 65 63 74 73 20 69 73 20 73 65 74 20 74 6f 20 jects is set to
e2e0: 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 61 6c 6c point to the all
e2f0: 6f 63 61 74 65 64 0a 2a 2a 20 46 75 6e 63 44 65 ocated.** FuncDe
e300: 73 74 72 75 63 74 6f 72 2e 0a 2a 2a 0a 2a 2a 20 structor..**.**
e310: 54 68 65 72 65 61 66 74 65 72 2c 20 77 68 65 6e Thereafter, when
e320: 20 6f 6e 65 20 6f 66 20 74 68 65 20 46 75 6e 63 one of the Func
e330: 44 65 66 20 6f 62 6a 65 63 74 73 20 69 73 20 64 Def objects is d
e340: 65 6c 65 74 65 64 2c 20 74 68 65 20 72 65 66 65 eleted, the refe
e350: 72 65 6e 63 65 0a 2a 2a 20 63 6f 75 6e 74 20 6f rence.** count o
e360: 6e 20 74 68 69 73 20 6f 62 6a 65 63 74 20 69 73 n this object is
e370: 20 64 65 63 72 65 6d 65 6e 74 65 64 2e 20 57 68 decremented. Wh
e380: 65 6e 20 69 74 20 72 65 61 63 68 65 73 20 30 2c en it reaches 0,
e390: 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 72 0a the destructor.
e3a0: 2a 2a 20 69 73 20 69 6e 76 6f 6b 65 64 20 61 6e ** is invoked an
e3b0: 64 20 74 68 65 20 46 75 6e 63 44 65 73 74 72 75 d the FuncDestru
e3c0: 63 74 6f 72 20 73 74 72 75 63 74 75 72 65 20 66 ctor structure f
e3d0: 72 65 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 reed..*/.struct
e3e0: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 7b FuncDestructor {
e3f0: 0a 20 20 69 6e 74 20 6e 52 65 66 3b 0a 20 20 76 . int nRef;. v
e400: 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 29 28 oid (*xDestroy)(
e410: 76 6f 69 64 20 2a 29 3b 0a 20 20 76 6f 69 64 20 void *);. void
e420: 2a 70 55 73 65 72 44 61 74 61 3b 0a 7d 3b 0a 0a *pUserData;.};..
e430: 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c 65 20 76 /*.** Possible v
e440: 61 6c 75 65 73 20 66 6f 72 20 46 75 6e 63 44 65 alues for FuncDe
e450: 66 2e 66 6c 61 67 73 2e 20 20 4e 6f 74 65 20 74 f.flags. Note t
e460: 68 61 74 20 74 68 65 20 5f 4c 45 4e 47 54 48 20 hat the _LENGTH
e470: 61 6e 64 20 5f 54 59 50 45 4f 46 0a 2a 2a 20 76 and _TYPEOF.** v
e480: 61 6c 75 65 73 20 6d 75 73 74 20 63 6f 72 72 65 alues must corre
e490: 73 70 6f 6e 64 20 74 6f 20 4f 50 46 4c 41 47 5f spond to OPFLAG_
e4a0: 4c 45 4e 47 54 48 41 52 47 20 61 6e 64 20 4f 50 LENGTHARG and OP
e4b0: 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 2e 20 FLAG_TYPEOFARG.
e4c0: 20 41 6e 64 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 And.** SQLITE_F
e4d0: 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 6d 75 73 UNC_CONSTANT mus
e4e0: 74 20 62 65 20 74 68 65 20 73 61 6d 65 20 61 73 t be the same as
e4f0: 20 53 51 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e SQLITE_DETERMIN
e500: 49 53 54 49 43 2e 20 20 54 68 65 72 65 0a 2a 2a ISTIC. There.**
e510: 20 61 72 65 20 61 73 73 65 72 74 28 29 20 73 74 are assert() st
e520: 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 68 65 20 atements in the
e530: 63 6f 64 65 20 74 6f 20 76 65 72 69 66 79 20 74 code to verify t
e540: 68 69 73 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 his..**.** Value
e550: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 65 6e constraints (en
e560: 66 6f 72 63 65 64 20 76 69 61 20 61 73 73 65 72 forced via asser
e570: 74 28 29 29 3a 0a 2a 2a 20 20 20 20 20 53 51 4c t()):.** SQL
e580: 49 54 45 5f 46 55 4e 43 5f 4d 49 4e 4d 41 58 20 ITE_FUNC_MINMAX
e590: 20 20 20 3d 3d 20 20 4e 43 5f 4d 69 6e 4d 61 78 == NC_MinMax
e5a0: 41 67 67 20 20 20 20 20 20 3d 3d 20 53 46 5f 4d Agg == SF_M
e5b0: 69 6e 4d 61 78 41 67 67 0a 2a 2a 20 20 20 20 20 inMaxAgg.**
e5c0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 SQLITE_FUNC_LENG
e5d0: 54 48 20 20 20 20 3d 3d 20 20 4f 50 46 4c 41 47 TH == OPFLAG
e5e0: 5f 4c 45 4e 47 54 48 41 52 47 0a 2a 2a 20 20 20 _LENGTHARG.**
e5f0: 20 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 54 59 SQLITE_FUNC_TY
e600: 50 45 4f 46 20 20 20 20 3d 3d 20 20 4f 50 46 4c PEOF == OPFL
e610: 41 47 5f 54 59 50 45 4f 46 41 52 47 0a 2a 2a 20 AG_TYPEOFARG.**
e620: 20 20 20 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f SQLITE_FUNC_
e630: 43 4f 4e 53 54 41 4e 54 20 20 3d 3d 20 20 53 51 CONSTANT == SQ
e640: 4c 49 54 45 5f 44 45 54 45 52 4d 49 4e 49 53 54 LITE_DETERMINIST
e650: 49 43 20 66 72 6f 6d 20 74 68 65 20 41 50 49 0a IC from the API.
e660: 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 46 55 ** SQLITE_FU
e670: 4e 43 5f 45 4e 43 4d 41 53 4b 20 20 20 64 65 70 NC_ENCMASK dep
e680: 65 6e 64 73 20 6f 6e 20 53 51 4c 49 54 45 5f 55 ends on SQLITE_U
e690: 54 46 2a 20 6d 61 63 72 6f 73 20 69 6e 20 74 68 TF* macros in th
e6a0: 65 20 41 50 49 0a 2a 2f 0a 23 64 65 66 69 6e 65 e API.*/.#define
e6b0: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 SQLITE_FUNC_ENC
e6c0: 4d 41 53 4b 20 20 30 78 30 30 30 33 20 2f 2a 20 MASK 0x0003 /*
e6d0: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c SQLITE_UTF8, SQL
e6e0: 49 54 45 5f 55 54 46 31 36 42 45 20 6f 72 20 55 ITE_UTF16BE or U
e6f0: 54 46 31 36 4c 45 20 2a 2f 0a 23 64 65 66 69 6e TF16LE */.#defin
e700: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 49 e SQLITE_FUNC_LI
e710: 4b 45 20 20 20 20 20 30 78 30 30 30 34 20 2f 2a KE 0x0004 /*
e720: 20 43 61 6e 64 69 64 61 74 65 20 66 6f 72 20 74 Candidate for t
e730: 68 65 20 4c 49 4b 45 20 6f 70 74 69 6d 69 7a 61 he LIKE optimiza
e740: 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tion */.#define
e750: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 41 53 45 SQLITE_FUNC_CASE
e760: 20 20 20 20 20 30 78 30 30 30 38 20 2f 2a 20 43 0x0008 /* C
e770: 61 73 65 2d 73 65 6e 73 69 74 69 76 65 20 4c 49 ase-sensitive LI
e780: 4b 45 2d 74 79 70 65 20 66 75 6e 63 74 69 6f 6e KE-type function
e790: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
e7a0: 54 45 5f 46 55 4e 43 5f 45 50 48 45 4d 20 20 20 TE_FUNC_EPHEM
e7b0: 20 30 78 30 30 31 30 20 2f 2a 20 45 70 68 65 6d 0x0010 /* Ephem
e7c0: 65 72 61 6c 2e 20 20 44 65 6c 65 74 65 20 77 69 eral. Delete wi
e7d0: 74 68 20 56 44 42 45 20 2a 2f 0a 23 64 65 66 69 th VDBE */.#defi
e7e0: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e ne SQLITE_FUNC_N
e7f0: 45 45 44 43 4f 4c 4c 20 30 78 30 30 32 30 20 2f EEDCOLL 0x0020 /
e800: 2a 20 73 71 6c 69 74 65 33 47 65 74 46 75 6e 63 * sqlite3GetFunc
e810: 43 6f 6c 6c 53 65 71 28 29 20 6d 69 67 68 74 20 CollSeq() might
e820: 62 65 20 63 61 6c 6c 65 64 2a 2f 0a 23 64 65 66 be called*/.#def
e830: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
e840: 4c 45 4e 47 54 48 20 20 20 30 78 30 30 34 30 20 LENGTH 0x0040
e850: 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 6c 65 6e 67 /* Built-in leng
e860: 74 68 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f th() function */
e870: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
e880: 46 55 4e 43 5f 54 59 50 45 4f 46 20 20 20 30 78 FUNC_TYPEOF 0x
e890: 30 30 38 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 0080 /* Built-in
e8a0: 20 74 79 70 65 6f 66 28 29 20 66 75 6e 63 74 69 typeof() functi
e8b0: 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 on */.#define SQ
e8c0: 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 55 4e 54 20 LITE_FUNC_COUNT
e8d0: 20 20 20 30 78 30 31 30 30 20 2f 2a 20 42 75 69 0x0100 /* Bui
e8e0: 6c 74 2d 69 6e 20 63 6f 75 6e 74 28 2a 29 20 61 lt-in count(*) a
e8f0: 67 67 72 65 67 61 74 65 20 2a 2f 0a 23 64 65 66 ggregate */.#def
e900: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
e910: 43 4f 41 4c 45 53 43 45 20 30 78 30 32 30 30 20 COALESCE 0x0200
e920: 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 63 6f 61 6c /* Built-in coal
e930: 65 73 63 65 28 29 20 6f 72 20 69 66 6e 75 6c 6c esce() or ifnull
e940: 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 () */.#define SQ
e950: 4c 49 54 45 5f 46 55 4e 43 5f 55 4e 4c 49 4b 45 LITE_FUNC_UNLIKE
e960: 4c 59 20 30 78 30 34 30 30 20 2f 2a 20 42 75 69 LY 0x0400 /* Bui
e970: 6c 74 2d 69 6e 20 75 6e 6c 69 6b 65 6c 79 28 29 lt-in unlikely()
e980: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 function */.#de
e990: 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 fine SQLITE_FUNC
e9a0: 5f 43 4f 4e 53 54 41 4e 54 20 30 78 30 38 30 30 _CONSTANT 0x0800
e9b0: 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 69 6e 70 /* Constant inp
e9c0: 75 74 73 20 67 69 76 65 20 61 20 63 6f 6e 73 74 uts give a const
e9d0: 61 6e 74 20 6f 75 74 70 75 74 20 2a 2f 0a 23 64 ant output */.#d
e9e0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
e9f0: 43 5f 4d 49 4e 4d 41 58 20 20 20 30 78 31 30 30 C_MINMAX 0x100
ea00: 30 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 6d 69 0 /* True for mi
ea10: 6e 28 29 20 61 6e 64 20 6d 61 78 28 29 20 61 67 n() and max() ag
ea20: 67 72 65 67 61 74 65 73 20 2a 2f 0a 23 64 65 66 gregates */.#def
ea30: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
ea40: 53 4c 4f 43 48 4e 47 20 20 30 78 32 30 30 30 20 SLOCHNG 0x2000
ea50: 2f 2a 20 22 53 6c 6f 77 20 43 68 61 6e 67 65 22 /* "Slow Change"
ea60: 2e 20 56 61 6c 75 65 20 63 6f 6e 73 74 61 6e 74 . Value constant
ea70: 20 64 75 72 69 6e 67 20 61 0a 20 20 20 20 20 20 during a.
ea80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ea90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a **
eaa0: 20 73 69 6e 67 6c 65 20 71 75 65 72 79 20 2d 20 single query -
eab0: 6d 69 67 68 74 20 63 68 61 6e 67 65 20 6f 76 65 might change ove
eac0: 72 20 74 69 6d 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a r time */../*.**
ead0: 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 The following t
eae0: 68 72 65 65 20 6d 61 63 72 6f 73 2c 20 46 55 4e hree macros, FUN
eaf0: 43 54 49 4f 4e 28 29 2c 20 4c 49 4b 45 46 55 4e CTION(), LIKEFUN
eb00: 43 28 29 20 61 6e 64 20 41 47 47 52 45 47 41 54 C() and AGGREGAT
eb10: 45 28 29 20 61 72 65 0a 2a 2a 20 75 73 65 64 20 E() are.** used
eb20: 74 6f 20 63 72 65 61 74 65 20 74 68 65 20 69 6e to create the in
eb30: 69 74 69 61 6c 69 7a 65 72 73 20 66 6f 72 20 74 itializers for t
eb40: 68 65 20 46 75 6e 63 44 65 66 20 73 74 72 75 63 he FuncDef struc
eb50: 74 75 72 65 73 2e 0a 2a 2a 0a 2a 2a 20 20 20 46 tures..**.** F
eb60: 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e UNCTION(zName, n
eb70: 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 Arg, iArg, bNC,
eb80: 78 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 55 73 xFunc).** Us
eb90: 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 73 ed to create a s
eba0: 63 61 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 calar function d
ebb0: 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 efinition of a f
ebc0: 75 6e 63 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a unction zName.**
ebd0: 20 20 20 20 20 69 6d 70 6c 65 6d 65 6e 74 65 64 implemented
ebe0: 20 62 79 20 43 20 66 75 6e 63 74 69 6f 6e 20 78 by C function x
ebf0: 46 75 6e 63 20 74 68 61 74 20 61 63 63 65 70 74 Func that accept
ec00: 73 20 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 73 s nArg arguments
ec10: 2e 20 54 68 65 0a 2a 2a 20 20 20 20 20 76 61 6c . The.** val
ec20: 75 65 20 70 61 73 73 65 64 20 61 73 20 69 41 72 ue passed as iAr
ec30: 67 20 69 73 20 63 61 73 74 20 74 6f 20 61 20 28 g is cast to a (
ec40: 76 6f 69 64 2a 29 20 61 6e 64 20 6d 61 64 65 20 void*) and made
ec50: 61 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 20 20 20 available.**
ec60: 20 61 73 20 74 68 65 20 75 73 65 72 2d 64 61 74 as the user-dat
ec70: 61 20 28 73 71 6c 69 74 65 33 5f 75 73 65 72 5f a (sqlite3_user_
ec80: 64 61 74 61 28 29 29 20 66 6f 72 20 74 68 65 20 data()) for the
ec90: 66 75 6e 63 74 69 6f 6e 2e 20 49 66 0a 2a 2a 20 function. If.**
eca0: 20 20 20 20 61 72 67 75 6d 65 6e 74 20 62 4e 43 argument bNC
ecb0: 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74 is true, then t
ecc0: 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e he SQLITE_FUNC_N
ecd0: 45 45 44 43 4f 4c 4c 20 66 6c 61 67 20 69 73 20 EEDCOLL flag is
ece0: 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 56 46 55 set..**.** VFU
ecf0: 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 NCTION(zName, nA
ed00: 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 rg, iArg, bNC, x
ed10: 46 75 6e 63 29 0a 2a 2a 20 20 20 20 20 4c 69 6b Func).** Lik
ed20: 65 20 46 55 4e 43 54 49 4f 4e 20 65 78 63 65 70 e FUNCTION excep
ed30: 74 20 69 74 20 6f 6d 69 74 73 20 74 68 65 20 53 t it omits the S
ed40: 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 QLITE_FUNC_CONST
ed50: 41 4e 54 20 66 6c 61 67 2e 0a 2a 2a 0a 2a 2a 20 ANT flag..**.**
ed60: 20 20 44 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d DFUNCTION(zNam
ed70: 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 e, nArg, iArg, b
ed80: 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 NC, xFunc).**
ed90: 20 20 4c 69 6b 65 20 46 55 4e 43 54 49 4f 4e 20 Like FUNCTION
eda0: 65 78 63 65 70 74 20 69 74 20 6f 6d 69 74 73 20 except it omits
edb0: 74 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f the SQLITE_FUNC_
edc0: 43 4f 4e 53 54 41 4e 54 20 66 6c 61 67 20 61 6e CONSTANT flag an
edd0: 64 0a 2a 2a 20 20 20 20 20 61 64 64 73 20 74 68 d.** adds th
ede0: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c e SQLITE_FUNC_SL
edf0: 4f 43 48 4e 47 20 66 6c 61 67 2e 20 20 55 73 65 OCHNG flag. Use
ee00: 64 20 66 6f 72 20 64 61 74 65 20 26 20 74 69 6d d for date & tim
ee10: 65 20 66 75 6e 63 74 69 6f 6e 73 0a 2a 2a 20 20 e functions.**
ee20: 20 20 20 61 6e 64 20 66 75 6e 63 74 69 6f 6e 73 and functions
ee30: 20 6c 69 6b 65 20 73 71 6c 69 74 65 5f 76 65 72 like sqlite_ver
ee40: 73 69 6f 6e 28 29 20 74 68 61 74 20 63 61 6e 20 sion() that can
ee50: 63 68 61 6e 67 65 2c 20 62 75 74 20 6e 6f 74 20 change, but not
ee60: 64 75 72 69 6e 67 0a 2a 2a 20 20 20 20 20 61 20 during.** a
ee70: 73 69 6e 67 6c 65 20 71 75 65 72 79 2e 0a 2a 2a single query..**
ee80: 0a 2a 2a 20 20 20 41 47 47 52 45 47 41 54 45 28 .** AGGREGATE(
ee90: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 zName, nArg, iAr
eea0: 67 2c 20 62 4e 43 2c 20 78 53 74 65 70 2c 20 78 g, bNC, xStep, x
eeb0: 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 20 20 55 73 Final).** Us
eec0: 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 6e 20 ed to create an
eed0: 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
eee0: 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 6d on definition im
eef0: 70 6c 65 6d 65 6e 74 65 64 20 62 79 0a 2a 2a 20 plemented by.**
ef00: 20 20 20 20 74 68 65 20 43 20 66 75 6e 63 74 69 the C functi
ef10: 6f 6e 73 20 78 53 74 65 70 20 61 6e 64 20 78 46 ons xStep and xF
ef20: 69 6e 61 6c 2e 20 54 68 65 20 66 69 72 73 74 20 inal. The first
ef30: 66 6f 75 72 20 70 61 72 61 6d 65 74 65 72 73 0a four parameters.
ef40: 2a 2a 20 20 20 20 20 61 72 65 20 69 6e 74 65 72 ** are inter
ef50: 70 72 65 74 65 64 20 69 6e 20 74 68 65 20 73 61 preted in the sa
ef60: 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 66 69 me way as the fi
ef70: 72 73 74 20 34 20 70 61 72 61 6d 65 74 65 72 73 rst 4 parameters
ef80: 20 74 6f 0a 2a 2a 20 20 20 20 20 46 55 4e 43 54 to.** FUNCT
ef90: 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 4c ION()..**.** L
efa0: 49 4b 45 46 55 4e 43 28 7a 4e 61 6d 65 2c 20 6e IKEFUNC(zName, n
efb0: 41 72 67 2c 20 70 41 72 67 2c 20 66 6c 61 67 73 Arg, pArg, flags
efc0: 29 0a 2a 2a 20 20 20 20 20 55 73 65 64 20 74 6f ).** Used to
efd0: 20 63 72 65 61 74 65 20 61 20 73 63 61 6c 61 72 create a scalar
efe0: 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 function defini
eff0: 74 69 6f 6e 20 6f 66 20 61 20 66 75 6e 63 74 69 tion of a functi
f000: 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 20 20 20 20 on zName.**
f010: 74 68 61 74 20 61 63 63 65 70 74 73 20 6e 41 72 that accepts nAr
f020: 67 20 61 72 67 75 6d 65 6e 74 73 20 61 6e 64 20 g arguments and
f030: 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 is implemented b
f040: 79 20 61 20 63 61 6c 6c 20 74 6f 20 43 0a 2a 2a y a call to C.**
f050: 20 20 20 20 20 66 75 6e 63 74 69 6f 6e 20 6c 69 function li
f060: 6b 65 46 75 6e 63 2e 20 41 72 67 75 6d 65 6e 74 keFunc. Argument
f070: 20 70 41 72 67 20 69 73 20 63 61 73 74 20 74 6f pArg is cast to
f080: 20 61 20 28 76 6f 69 64 20 2a 29 20 61 6e 64 20 a (void *) and
f090: 6d 61 64 65 0a 2a 2a 20 20 20 20 20 61 76 61 69 made.** avai
f0a0: 6c 61 62 6c 65 20 61 73 20 74 68 65 20 66 75 6e lable as the fun
f0b0: 63 74 69 6f 6e 20 75 73 65 72 2d 64 61 74 61 20 ction user-data
f0c0: 28 73 71 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 (sqlite3_user_da
f0d0: 74 61 28 29 29 2e 20 54 68 65 0a 2a 2a 20 20 20 ta()). The.**
f0e0: 20 20 46 75 6e 63 44 65 66 2e 66 6c 61 67 73 20 FuncDef.flags
f0f0: 76 61 72 69 61 62 6c 65 20 69 73 20 73 65 74 20 variable is set
f100: 74 6f 20 74 68 65 20 76 61 6c 75 65 20 70 61 73 to the value pas
f110: 73 65 64 20 61 73 20 74 68 65 20 66 6c 61 67 73 sed as the flags
f120: 0a 2a 2a 20 20 20 20 20 70 61 72 61 6d 65 74 65 .** paramete
f130: 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 46 55 r..*/.#define FU
f140: 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 NCTION(zName, nA
f150: 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 rg, iArg, bNC, x
f160: 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 2c Func) \. {nArg,
f170: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e SQLITE_FUNC_CON
f180: 53 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 54 46 STANT|SQLITE_UTF
f190: 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 55 8|(bNC*SQLITE_FU
f1a0: 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a NC_NEEDCOLL), \.
f1b0: 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f SQLITE_INT_TO
f1c0: 5f 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 78 _PTR(iArg), 0, x
f1d0: 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c Func, 0, #zName,
f1e0: 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 56 {0} }.#define V
f1f0: 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 FUNCTION(zName,
f200: 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c nArg, iArg, bNC,
f210: 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 xFunc) \. {nAr
f220: 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 g, SQLITE_UTF8|(
f230: 62 4e 43 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f bNC*SQLITE_FUNC_
f240: 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 NEEDCOLL), \.
f250: 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 SQLITE_INT_TO_PT
f260: 52 28 69 41 72 67 29 2c 20 30 2c 20 78 46 75 6e R(iArg), 0, xFun
f270: 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 7b 30 c, 0, #zName, {0
f280: 7d 20 7d 0a 23 64 65 66 69 6e 65 20 44 46 55 4e } }.#define DFUN
f290: 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 CTION(zName, nAr
f2a0: 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 g, iArg, bNC, xF
f2b0: 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 unc) \. {nArg,
f2c0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c 4f 43 SQLITE_FUNC_SLOC
f2d0: 48 4e 47 7c 53 51 4c 49 54 45 5f 55 54 46 38 7c HNG|SQLITE_UTF8|
f2e0: 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 55 4e 43 (bNC*SQLITE_FUNC
f2f0: 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 _NEEDCOLL), \.
f300: 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 SQLITE_INT_TO_P
f310: 54 52 28 69 41 72 67 29 2c 20 30 2c 20 78 46 75 TR(iArg), 0, xFu
f320: 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 7b nc, 0, #zName, {
f330: 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 46 55 4e 0} }.#define FUN
f340: 43 54 49 4f 4e 32 28 7a 4e 61 6d 65 2c 20 6e 41 CTION2(zName, nA
f350: 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 rg, iArg, bNC, x
f360: 46 75 6e 63 2c 20 65 78 74 72 61 46 6c 61 67 73 Func, extraFlags
f370: 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 53 51 4c 49 ) \. {nArg,SQLI
f380: 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 TE_FUNC_CONSTANT
f390: 7c 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 4e |SQLITE_UTF8|(bN
f3a0: 43 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 C*SQLITE_FUNC_NE
f3b0: 45 44 43 4f 4c 4c 29 7c 65 78 74 72 61 46 6c 61 EDCOLL)|extraFla
f3c0: 67 73 2c 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 gs,\. SQLITE_I
f3d0: 4e 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c NT_TO_PTR(iArg),
f3e0: 20 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 23 7a 0, xFunc, 0, #z
f3f0: 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 Name, {0} }.#def
f400: 69 6e 65 20 53 54 52 5f 46 55 4e 43 54 49 4f 4e ine STR_FUNCTION
f410: 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 70 41 (zName, nArg, pA
f420: 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 20 rg, bNC, xFunc)
f430: 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 \. {nArg, SQLIT
f440: 45 5f 46 55 4e 43 5f 53 4c 4f 43 48 4e 47 7c 53 E_FUNC_SLOCHNG|S
f450: 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 2a QLITE_UTF8|(bNC*
f460: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 SQLITE_FUNC_NEED
f470: 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 70 41 72 67 COLL), \. pArg
f480: 2c 20 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 23 , 0, xFunc, 0, #
f490: 7a 4e 61 6d 65 2c 20 7d 0a 23 64 65 66 69 6e 65 zName, }.#define
f4a0: 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d 65 2c LIKEFUNC(zName,
f4b0: 20 6e 41 72 67 2c 20 61 72 67 2c 20 66 6c 61 67 nArg, arg, flag
f4c0: 73 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 s) \. {nArg, SQ
f4d0: 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 LITE_FUNC_CONSTA
f4e0: 4e 54 7c 53 51 4c 49 54 45 5f 55 54 46 38 7c 66 NT|SQLITE_UTF8|f
f4f0: 6c 61 67 73 2c 20 5c 0a 20 20 20 28 76 6f 69 64 lags, \. (void
f500: 20 2a 29 61 72 67 2c 20 30 2c 20 6c 69 6b 65 46 *)arg, 0, likeF
f510: 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 unc, 0, #zName,
f520: 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 41 47 {0} }.#define AG
f530: 47 52 45 47 41 54 45 28 7a 4e 61 6d 65 2c 20 6e GREGATE(zName, n
f540: 41 72 67 2c 20 61 72 67 2c 20 6e 63 2c 20 78 53 Arg, arg, nc, xS
f550: 74 65 70 2c 20 78 46 69 6e 61 6c 29 20 5c 0a 20 tep, xFinal) \.
f560: 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 {nArg, SQLITE_U
f570: 54 46 38 7c 28 6e 63 2a 53 51 4c 49 54 45 5f 46 TF8|(nc*SQLITE_F
f580: 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c UNC_NEEDCOLL), \
f590: 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 . SQLITE_INT_T
f5a0: 4f 5f 50 54 52 28 61 72 67 29 2c 20 30 2c 20 78 O_PTR(arg), 0, x
f5b0: 53 74 65 70 2c 78 46 69 6e 61 6c 2c 23 7a 4e 61 Step,xFinal,#zNa
f5c0: 6d 65 2c 20 7b 30 7d 7d 0a 23 64 65 66 69 6e 65 me, {0}}.#define
f5d0: 20 41 47 47 52 45 47 41 54 45 32 28 7a 4e 61 6d AGGREGATE2(zNam
f5e0: 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c 20 6e 63 e, nArg, arg, nc
f5f0: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 2c , xStep, xFinal,
f600: 20 65 78 74 72 61 46 6c 61 67 73 29 20 5c 0a 20 extraFlags) \.
f610: 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 {nArg, SQLITE_U
f620: 54 46 38 7c 28 6e 63 2a 53 51 4c 49 54 45 5f 46 TF8|(nc*SQLITE_F
f630: 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 7c 65 78 UNC_NEEDCOLL)|ex
f640: 74 72 61 46 6c 61 67 73 2c 20 5c 0a 20 20 20 53 traFlags, \. S
f650: 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 QLITE_INT_TO_PTR
f660: 28 61 72 67 29 2c 20 30 2c 20 78 53 74 65 70 2c (arg), 0, xStep,
f670: 78 46 69 6e 61 6c 2c 23 7a 4e 61 6d 65 2c 20 7b xFinal,#zName, {
f680: 30 7d 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 0}}../*.** All c
f690: 75 72 72 65 6e 74 20 73 61 76 65 70 6f 69 6e 74 urrent savepoint
f6a0: 73 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 s are stored in
f6b0: 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 73 74 a linked list st
f6c0: 61 72 74 69 6e 67 20 61 74 0a 2a 2a 20 73 71 6c arting at.** sql
f6d0: 69 74 65 33 2e 70 53 61 76 65 70 6f 69 6e 74 2e ite3.pSavepoint.
f6e0: 20 54 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 The first eleme
f6f0: 6e 74 20 69 6e 20 74 68 65 20 6c 69 73 74 20 69 nt in the list i
f700: 73 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e s the most recen
f710: 74 6c 79 0a 2a 2a 20 6f 70 65 6e 65 64 20 73 61 tly.** opened sa
f720: 76 65 70 6f 69 6e 74 2e 20 53 61 76 65 70 6f 69 vepoint. Savepoi
f730: 6e 74 73 20 61 72 65 20 61 64 64 65 64 20 74 6f nts are added to
f740: 20 74 68 65 20 6c 69 73 74 20 62 79 20 74 68 65 the list by the
f750: 20 76 64 62 65 0a 2a 2a 20 4f 50 5f 53 61 76 65 vdbe.** OP_Save
f760: 70 6f 69 6e 74 20 69 6e 73 74 72 75 63 74 69 6f point instructio
f770: 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 61 76 n..*/.struct Sav
f780: 65 70 6f 69 6e 74 20 7b 0a 20 20 63 68 61 72 20 epoint {. char
f790: 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 *zName;
f7a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
f7b0: 2a 20 53 61 76 65 70 6f 69 6e 74 20 6e 61 6d 65 * Savepoint name
f7c0: 20 28 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 65 64 (nul-terminated
f7d0: 29 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 ) */. i64 nDefe
f7e0: 72 72 65 64 43 6f 6e 73 3b 20 20 20 20 20 20 20 rredCons;
f7f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
f800: 6d 62 65 72 20 6f 66 20 64 65 66 65 72 72 65 64 mber of deferred
f810: 20 66 6b 20 76 69 6f 6c 61 74 69 6f 6e 73 20 2a fk violations *
f820: 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 65 /. i64 nDeferre
f830: 64 49 6d 6d 43 6f 6e 73 3b 20 20 20 20 20 20 20 dImmCons;
f840: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
f850: 72 20 6f 66 20 64 65 66 65 72 72 65 64 20 69 6d r of deferred im
f860: 6d 20 66 6b 2e 20 2a 2f 0a 20 20 53 61 76 65 70 m fk. */. Savep
f870: 6f 69 6e 74 20 2a 70 4e 65 78 74 3b 20 20 20 20 oint *pNext;
f880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
f890: 2a 20 50 61 72 65 6e 74 20 73 61 76 65 70 6f 69 * Parent savepoi
f8a0: 6e 74 20 28 69 66 20 61 6e 79 29 20 2a 2f 0a 7d nt (if any) */.}
f8b0: 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c ;../*.** The fol
f8c0: 6c 6f 77 69 6e 67 20 61 72 65 20 75 73 65 64 20 lowing are used
f8d0: 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 70 61 as the second pa
f8e0: 72 61 6d 65 74 65 72 20 74 6f 20 73 71 6c 69 74 rameter to sqlit
f8f0: 65 33 53 61 76 65 70 6f 69 6e 74 28 29 2c 0a 2a e3Savepoint(),.*
f900: 2a 20 61 6e 64 20 61 73 20 74 68 65 20 50 31 20 * and as the P1
f910: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 argument to the
f920: 4f 50 5f 53 61 76 65 70 6f 69 6e 74 20 69 6e 73 OP_Savepoint ins
f930: 74 72 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 64 65 truction..*/.#de
f940: 66 69 6e 65 20 53 41 56 45 50 4f 49 4e 54 5f 42 fine SAVEPOINT_B
f950: 45 47 49 4e 20 20 20 20 20 20 30 0a 23 64 65 66 EGIN 0.#def
f960: 69 6e 65 20 53 41 56 45 50 4f 49 4e 54 5f 52 45 ine SAVEPOINT_RE
f970: 4c 45 41 53 45 20 20 20 20 31 0a 23 64 65 66 69 LEASE 1.#defi
f980: 6e 65 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c ne SAVEPOINT_ROL
f990: 4c 42 41 43 4b 20 20 20 32 0a 0a 0a 2f 2a 0a 2a LBACK 2.../*.*
f9a0: 2a 20 45 61 63 68 20 53 51 4c 69 74 65 20 6d 6f * Each SQLite mo
f9b0: 64 75 6c 65 20 28 76 69 72 74 75 61 6c 20 74 61 dule (virtual ta
f9c0: 62 6c 65 20 64 65 66 69 6e 69 74 69 6f 6e 29 20 ble definition)
f9d0: 69 73 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e is defined by an
f9e0: 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 .** instance of
f9f0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
fa00: 72 75 63 74 75 72 65 2c 20 73 74 6f 72 65 64 20 ructure, stored
fa10: 69 6e 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61 in the sqlite3.a
fa20: 4d 6f 64 75 6c 65 0a 2a 2a 20 68 61 73 68 20 74 Module.** hash t
fa30: 61 62 6c 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 able..*/.struct
fa40: 4d 6f 64 75 6c 65 20 7b 0a 20 20 63 6f 6e 73 74 Module {. const
fa50: 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 sqlite3_module
fa60: 2a 70 4d 6f 64 75 6c 65 3b 20 20 20 20 20 20 20 *pModule;
fa70: 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 70 6f 69 6e /* Callback poin
fa80: 74 65 72 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 ters */. const
fa90: 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 char *zName;
faa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
fab0: 2a 20 4e 61 6d 65 20 70 61 73 73 65 64 20 74 6f * Name passed to
fac0: 20 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 create_module()
fad0: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 */. void *pAux
fae0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
faf0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 41 /* pA
fb00: 75 78 20 70 61 73 73 65 64 20 74 6f 20 63 72 65 ux passed to cre
fb10: 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a ate_module() */.
fb20: 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f void (*xDestro
fb30: 79 29 28 76 6f 69 64 20 2a 29 3b 20 20 20 20 20 y)(void *);
fb40: 20 20 20 20 20 20 20 2f 2a 20 4d 6f 64 75 6c 65 /* Module
fb50: 20 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 destructor func
fb60: 74 69 6f 6e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 tion */. Table
fb70: 2a 70 45 70 6f 54 61 62 3b 20 20 20 20 20 20 20 *pEpoTab;
fb80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
fb90: 2a 20 45 70 6f 6e 79 6d 6f 75 73 20 74 61 62 6c * Eponymous tabl
fba0: 65 20 66 6f 72 20 74 68 69 73 20 6d 6f 64 75 6c e for this modul
fbb0: 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 69 e */.};../*.** i
fbc0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 nformation about
fbd0: 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 each column of
fbe0: 61 6e 20 53 51 4c 20 74 61 62 6c 65 20 69 73 20 an SQL table is
fbf0: 68 65 6c 64 20 69 6e 20 61 6e 20 69 6e 73 74 61 held in an insta
fc00: 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 69 73 20 73 nce.** of this s
fc10: 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 tructure..*/.str
fc20: 75 63 74 20 43 6f 6c 75 6d 6e 20 7b 0a 20 20 63 uct Column {. c
fc30: 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
fc40: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 /* Name of this
fc50: 63 6f 6c 75 6d 6e 2c 20 5c 30 30 30 2c 20 74 68 column, \000, th
fc60: 65 6e 20 74 68 65 20 74 79 70 65 20 2a 2f 0a 20 en the type */.
fc70: 20 45 78 70 72 20 2a 70 44 66 6c 74 3b 20 20 20 Expr *pDflt;
fc80: 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 76 61 6c /* Default val
fc90: 75 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 6d ue of this colum
fca0: 6e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f n */. char *zCo
fcb0: 6c 6c 3b 20 20 20 20 20 2f 2a 20 43 6f 6c 6c 61 ll; /* Colla
fcc0: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 2e 20 20 ting sequence.
fcd0: 49 66 20 4e 55 4c 4c 2c 20 75 73 65 20 74 68 65 If NULL, use the
fce0: 20 64 65 66 61 75 6c 74 20 2a 2f 0a 20 20 75 38 default */. u8
fcf0: 20 6e 6f 74 4e 75 6c 6c 3b 20 20 20 20 20 20 2f notNull; /
fd00: 2a 20 41 6e 20 4f 45 5f 20 63 6f 64 65 20 66 6f * An OE_ code fo
fd10: 72 20 68 61 6e 64 6c 69 6e 67 20 61 20 4e 4f 54 r handling a NOT
fd20: 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 NULL constraint
fd30: 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 69 6e */. char affin
fd40: 69 74 79 3b 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 ity; /* One of
fd50: 20 74 68 65 20 53 51 4c 49 54 45 5f 41 46 46 5f the SQLITE_AFF_
fd60: 2e 2e 2e 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 ... values */.
fd70: 75 38 20 73 7a 45 73 74 3b 20 20 20 20 20 20 20 u8 szEst;
fd80: 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 73 69 /* Estimated si
fd90: 7a 65 20 6f 66 20 76 61 6c 75 65 20 69 6e 20 74 ze of value in t
fda0: 68 69 73 20 63 6f 6c 75 6d 6e 2e 20 73 69 7a 65 his column. size
fdb0: 6f 66 28 49 4e 54 29 3d 3d 31 20 2a 2f 0a 20 20 of(INT)==1 */.
fdc0: 75 38 20 63 6f 6c 46 6c 61 67 73 3b 20 20 20 20 u8 colFlags;
fdd0: 20 2f 2a 20 42 6f 6f 6c 65 61 6e 20 70 72 6f 70 /* Boolean prop
fde0: 65 72 74 69 65 73 2e 20 20 53 65 65 20 43 4f 4c erties. See COL
fdf0: 46 4c 41 47 5f 20 64 65 66 69 6e 65 73 20 62 65 FLAG_ defines be
fe00: 6c 6f 77 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c low */.};../* Al
fe10: 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 lowed values for
fe20: 20 43 6f 6c 75 6d 6e 2e 63 6f 6c 46 6c 61 67 73 Column.colFlags
fe30: 3a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f 4c :.*/.#define COL
fe40: 46 4c 41 47 5f 50 52 49 4d 4b 45 59 20 20 30 78 FLAG_PRIMKEY 0x
fe50: 30 30 30 31 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 0001 /* Colum
fe60: 6e 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 n is part of the
fe70: 20 70 72 69 6d 61 72 79 20 6b 65 79 20 2a 2f 0a primary key */.
fe80: 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f #define COLFLAG_
fe90: 48 49 44 44 45 4e 20 20 20 30 78 30 30 30 32 20 HIDDEN 0x0002
fea0: 20 20 20 2f 2a 20 41 20 68 69 64 64 65 6e 20 63 /* A hidden c
feb0: 6f 6c 75 6d 6e 20 69 6e 20 61 20 76 69 72 74 75 olumn in a virtu
fec0: 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 al table */.#def
fed0: 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 48 41 53 54 ine COLFLAG_HAST
fee0: 59 50 45 20 20 30 78 30 30 30 34 20 20 20 20 2f YPE 0x0004 /
fef0: 2a 20 54 79 70 65 20 6e 61 6d 65 20 66 6f 6c 6c * Type name foll
ff00: 6f 77 73 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 ows column name
ff10: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 22 43 6f 6c */../*.** A "Col
ff20: 6c 61 74 69 6e 67 20 53 65 71 75 65 6e 63 65 22 lating Sequence"
ff30: 20 69 73 20 64 65 66 69 6e 65 64 20 62 79 20 61 is defined by a
ff40: 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
ff50: 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 e following.** s
ff60: 74 72 75 63 74 75 72 65 2e 20 43 6f 6e 63 65 70 tructure. Concep
ff70: 74 75 61 6c 6c 79 2c 20 61 20 63 6f 6c 6c 61 74 tually, a collat
ff80: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 63 6f 6e ing sequence con
ff90: 73 69 73 74 73 20 6f 66 20 61 20 6e 61 6d 65 20 sists of a name
ffa0: 61 6e 64 0a 2a 2a 20 61 20 63 6f 6d 70 61 72 69 and.** a compari
ffb0: 73 6f 6e 20 72 6f 75 74 69 6e 65 20 74 68 61 74 son routine that
ffc0: 20 64 65 66 69 6e 65 73 20 74 68 65 20 6f 72 64 defines the ord
ffd0: 65 72 20 6f 66 20 74 68 61 74 20 73 65 71 75 65 er of that seque
ffe0: 6e 63 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 43 6f nce..**.** If Co
fff0: 6c 6c 53 65 71 2e 78 43 6d 70 20 69 73 20 4e 55 llSeq.xCmp is NU
10000 4c 4c 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 61 LL, it means tha
10010 74 20 74 68 65 0a 2a 2a 20 63 6f 6c 6c 61 74 69 t the.** collati
10020 6e 67 20 73 65 71 75 65 6e 63 65 20 69 73 20 75 ng sequence is u
10030 6e 64 65 66 69 6e 65 64 2e 20 20 49 6e 64 69 63 ndefined. Indic
10040 65 73 20 62 75 69 6c 74 20 6f 6e 20 61 6e 20 75 es built on an u
10050 6e 64 65 66 69 6e 65 64 0a 2a 2a 20 63 6f 6c 6c ndefined.** coll
10060 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 6d ating sequence m
10070 61 79 20 6e 6f 74 20 62 65 20 72 65 61 64 20 6f ay not be read o
10080 72 20 77 72 69 74 74 65 6e 2e 0a 2a 2f 0a 73 74 r written..*/.st
10090 72 75 63 74 20 43 6f 6c 6c 53 65 71 20 7b 0a 20 ruct CollSeq {.
100a0 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 char *zName;
100b0 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
100c0 66 20 74 68 65 20 63 6f 6c 6c 61 74 69 6e 67 20 f the collating
100d0 73 65 71 75 65 6e 63 65 2c 20 55 54 46 2d 38 20 sequence, UTF-8
100e0 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 20 75 38 20 encoded */. u8
100f0 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 enc;
10100 20 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 /* Text encod
10110 69 6e 67 20 68 61 6e 64 6c 65 64 20 62 79 20 78 ing handled by x
10120 43 6d 70 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 Cmp() */. void
10130 2a 70 55 73 65 72 3b 20 20 20 20 20 20 20 20 20 *pUser;
10140 20 2f 2a 20 46 69 72 73 74 20 61 72 67 75 6d 65 /* First argume
10150 6e 74 20 74 6f 20 78 43 6d 70 28 29 20 2a 2f 0a nt to xCmp() */.
10160 20 20 69 6e 74 20 28 2a 78 43 6d 70 29 28 76 6f int (*xCmp)(vo
10170 69 64 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 76 id*,int, const v
10180 6f 69 64 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 oid*, int, const
10190 20 76 6f 69 64 2a 29 3b 0a 20 20 76 6f 69 64 20 void*);. void
101a0 28 2a 78 44 65 6c 29 28 76 6f 69 64 2a 29 3b 20 (*xDel)(void*);
101b0 20 2f 2a 20 44 65 73 74 72 75 63 74 6f 72 20 66 /* Destructor f
101c0 6f 72 20 70 55 73 65 72 20 2a 2f 0a 7d 3b 0a 0a or pUser */.};..
101d0 2f 2a 0a 2a 2a 20 41 20 73 6f 72 74 20 6f 72 64 /*.** A sort ord
101e0 65 72 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 er can be either
101f0 20 41 53 43 20 6f 72 20 44 45 53 43 2e 0a 2a 2f ASC or DESC..*/
10200 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
10210 53 4f 5f 41 53 43 20 20 20 20 20 20 20 30 20 20 SO_ASC 0
10220 2f 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 65 6e /* Sort in ascen
10230 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 23 64 ding order */.#d
10240 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 4f 5f efine SQLITE_SO_
10250 44 45 53 43 20 20 20 20 20 20 31 20 20 2f 2a 20 DESC 1 /*
10260 53 6f 72 74 20 69 6e 20 61 73 63 65 6e 64 69 6e Sort in ascendin
10270 67 20 6f 72 64 65 72 20 2a 2f 0a 23 64 65 66 69 g order */.#defi
10280 6e 65 20 53 51 4c 49 54 45 5f 53 4f 5f 55 4e 44 ne SQLITE_SO_UND
10290 45 46 49 4e 45 44 20 2d 31 20 2f 2a 20 4e 6f 20 EFINED -1 /* No
102a0 73 6f 72 74 20 6f 72 64 65 72 20 73 70 65 63 69 sort order speci
102b0 66 69 65 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 fied */../*.** C
102c0 6f 6c 75 6d 6e 20 61 66 66 69 6e 69 74 79 20 74 olumn affinity t
102d0 79 70 65 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 ypes..**.** Thes
102e0 65 20 75 73 65 64 20 74 6f 20 68 61 76 65 20 6d e used to have m
102f0 6e 65 6d 6f 6e 69 63 20 6e 61 6d 65 20 6c 69 6b nemonic name lik
10300 65 20 27 69 27 20 66 6f 72 20 53 51 4c 49 54 45 e 'i' for SQLITE
10310 5f 41 46 46 5f 49 4e 54 45 47 45 52 20 61 6e 64 _AFF_INTEGER and
10320 0a 2a 2a 20 27 74 27 20 66 6f 72 20 53 51 4c 49 .** 't' for SQLI
10330 54 45 5f 41 46 46 5f 54 45 58 54 2e 20 20 42 75 TE_AFF_TEXT. Bu
10340 74 20 77 65 20 63 61 6e 20 73 61 76 65 20 61 20 t we can save a
10350 6c 69 74 74 6c 65 20 73 70 61 63 65 20 61 6e 64 little space and
10360 20 69 6d 70 72 6f 76 65 0a 2a 2a 20 74 68 65 20 improve.** the
10370 73 70 65 65 64 20 61 20 6c 69 74 74 6c 65 20 62 speed a little b
10380 79 20 6e 75 6d 62 65 72 69 6e 67 20 74 68 65 20 y numbering the
10390 76 61 6c 75 65 73 20 63 6f 6e 73 65 63 75 74 69 values consecuti
103a0 76 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 42 75 74 20 vely..**.** But
103b0 72 61 74 68 65 72 20 74 68 61 6e 20 73 74 61 72 rather than star
103c0 74 20 77 69 74 68 20 30 20 6f 72 20 31 2c 20 77 t with 0 or 1, w
103d0 65 20 62 65 67 69 6e 20 77 69 74 68 20 27 41 27 e begin with 'A'
103e0 2e 20 20 54 68 61 74 20 77 61 79 2c 0a 2a 2a 20 . That way,.**
103f0 77 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 61 66 when multiple af
10400 66 69 6e 69 74 79 20 74 79 70 65 73 20 61 72 65 finity types are
10410 20 63 6f 6e 63 61 74 65 6e 61 74 65 64 20 69 6e concatenated in
10420 74 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 0a to a string and.
10430 2a 2a 20 75 73 65 64 20 61 73 20 74 68 65 20 50 ** used as the P
10440 34 20 6f 70 65 72 61 6e 64 2c 20 74 68 65 79 20 4 operand, they
10450 77 69 6c 6c 20 62 65 20 6d 6f 72 65 20 72 65 61 will be more rea
10460 64 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 dable..**.** Not
10470 65 20 61 6c 73 6f 20 74 68 61 74 20 74 68 65 20 e also that the
10480 6e 75 6d 65 72 69 63 20 74 79 70 65 73 20 61 72 numeric types ar
10490 65 20 67 72 6f 75 70 65 64 20 74 6f 67 65 74 68 e grouped togeth
104a0 65 72 20 73 6f 20 74 68 61 74 20 74 65 73 74 69 er so that testi
104b0 6e 67 0a 2a 2a 20 66 6f 72 20 61 20 6e 75 6d 65 ng.** for a nume
104c0 72 69 63 20 74 79 70 65 20 69 73 20 61 20 73 69 ric type is a si
104d0 6e 67 6c 65 20 63 6f 6d 70 61 72 69 73 6f 6e 2e ngle comparison.
104e0 20 20 41 6e 64 20 74 68 65 20 42 4c 4f 42 20 74 And the BLOB t
104f0 79 70 65 20 69 73 20 66 69 72 73 74 2e 0a 2a 2f ype is first..*/
10500 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
10510 41 46 46 5f 42 4c 4f 42 20 20 20 20 20 27 41 27 AFF_BLOB 'A'
10520 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
10530 41 46 46 5f 54 45 58 54 20 20 20 20 20 27 42 27 AFF_TEXT 'B'
10540 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
10550 41 46 46 5f 4e 55 4d 45 52 49 43 20 20 27 43 27 AFF_NUMERIC 'C'
10560 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
10570 41 46 46 5f 49 4e 54 45 47 45 52 20 20 27 44 27 AFF_INTEGER 'D'
10580 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
10590 41 46 46 5f 52 45 41 4c 20 20 20 20 20 27 45 27 AFF_REAL 'E'
105a0 0a 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 ..#define sqlite
105b0 33 49 73 4e 75 6d 65 72 69 63 41 66 66 69 6e 69 3IsNumericAffini
105c0 74 79 28 58 29 20 20 28 28 58 29 3e 3d 53 51 4c ty(X) ((X)>=SQL
105d0 49 54 45 5f 41 46 46 5f 4e 55 4d 45 52 49 43 29 ITE_AFF_NUMERIC)
105e0 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 ../*.** The SQLI
105f0 54 45 5f 41 46 46 5f 4d 41 53 4b 20 76 61 6c 75 TE_AFF_MASK valu
10600 65 73 20 6d 61 73 6b 73 20 6f 66 66 20 74 68 65 es masks off the
10610 20 73 69 67 6e 69 66 69 63 61 6e 74 20 62 69 74 significant bit
10620 73 20 6f 66 20 61 6e 0a 2a 2a 20 61 66 66 69 6e s of an.** affin
10630 69 74 79 20 76 61 6c 75 65 2e 0a 2a 2f 0a 23 64 ity value..*/.#d
10640 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 efine SQLITE_AFF
10650 5f 4d 41 53 4b 20 20 20 20 20 30 78 34 37 0a 0a _MASK 0x47..
10660 2f 2a 0a 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c /*.** Additional
10670 20 62 69 74 20 76 61 6c 75 65 73 20 74 68 61 74 bit values that
10680 20 63 61 6e 20 62 65 20 4f 52 65 64 20 77 69 74 can be ORed wit
10690 68 20 61 6e 20 61 66 66 69 6e 69 74 79 20 77 69 h an affinity wi
106a0 74 68 6f 75 74 0a 2a 2a 20 63 68 61 6e 67 69 6e thout.** changin
106b0 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 2e 0a g the affinity..
106c0 2a 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 **.** The SQLITE
106d0 5f 4e 4f 54 4e 55 4c 4c 20 66 6c 61 67 20 69 73 _NOTNULL flag is
106e0 20 61 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 6f a combination o
106f0 66 20 4e 55 4c 4c 45 51 20 61 6e 64 20 4a 55 4d f NULLEQ and JUM
10700 50 49 46 4e 55 4c 4c 2e 0a 2a 2a 20 49 74 20 63 PIFNULL..** It c
10710 61 75 73 65 73 20 61 6e 20 61 73 73 65 72 74 28 auses an assert(
10720 29 20 74 6f 20 66 69 72 65 20 69 66 20 65 69 74 ) to fire if eit
10730 68 65 72 20 6f 70 65 72 61 6e 64 20 74 6f 20 61 her operand to a
10740 20 63 6f 6d 70 61 72 69 73 6f 6e 0a 2a 2a 20 6f comparison.** o
10750 70 65 72 61 74 6f 72 20 69 73 20 4e 55 4c 4c 2e perator is NULL.
10760 20 20 49 74 20 69 73 20 61 64 64 65 64 20 74 6f It is added to
10770 20 63 65 72 74 61 69 6e 20 63 6f 6d 70 61 72 69 certain compari
10780 73 6f 6e 20 6f 70 65 72 61 74 6f 72 73 20 74 6f son operators to
10790 0a 2a 2a 20 70 72 6f 76 65 20 74 68 61 74 20 74 .** prove that t
107a0 68 65 20 6f 70 65 72 61 6e 64 73 20 61 72 65 20 he operands are
107b0 61 6c 77 61 79 73 20 4e 4f 54 20 4e 55 4c 4c 2e always NOT NULL.
107c0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .*/.#define SQLI
107d0 54 45 5f 4b 45 45 50 4e 55 4c 4c 20 20 20 20 20 TE_KEEPNULL
107e0 30 78 30 38 20 20 2f 2a 20 55 73 65 64 20 62 79 0x08 /* Used by
107f0 20 76 65 63 74 6f 72 20 3d 3d 20 6f 72 20 3c 3e vector == or <>
10800 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
10810 54 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c 20 20 20 TE_JUMPIFNULL
10820 30 78 31 30 20 20 2f 2a 20 6a 75 6d 70 73 20 69 0x10 /* jumps i
10830 66 20 65 69 74 68 65 72 20 6f 70 65 72 61 6e 64 f either operand
10840 20 69 73 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 is NULL */.#def
10850 69 6e 65 20 53 51 4c 49 54 45 5f 53 54 4f 52 45 ine SQLITE_STORE
10860 50 32 20 20 20 20 20 20 30 78 32 30 20 20 2f 2a P2 0x20 /*
10870 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 69 6e Store result in
10880 20 72 65 67 5b 50 32 5d 20 72 61 74 68 65 72 20 reg[P2] rather
10890 74 68 61 6e 20 6a 75 6d 70 20 2a 2f 0a 23 64 65 than jump */.#de
108a0 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 55 4c 4c fine SQLITE_NULL
108b0 45 51 20 20 20 20 20 20 20 30 78 38 30 20 20 2f EQ 0x80 /
108c0 2a 20 4e 55 4c 4c 3d 4e 55 4c 4c 20 2a 2f 0a 23 * NULL=NULL */.#
108d0 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f define SQLITE_NO
108e0 54 4e 55 4c 4c 20 20 20 20 20 20 30 78 39 30 20 TNULL 0x90
108f0 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61 74 20 /* Assert that
10900 6f 70 65 72 61 6e 64 73 20 61 72 65 20 6e 65 76 operands are nev
10910 65 72 20 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a 0a 2a er NULL */../*.*
10920 2a 20 41 6e 20 6f 62 6a 65 63 74 20 6f 66 20 74 * An object of t
10930 68 69 73 20 74 79 70 65 20 69 73 20 63 72 65 61 his type is crea
10940 74 65 64 20 66 6f 72 20 65 61 63 68 20 76 69 72 ted for each vir
10950 74 75 61 6c 20 74 61 62 6c 65 20 70 72 65 73 65 tual table prese
10960 6e 74 20 69 6e 0a 2a 2a 20 74 68 65 20 64 61 74 nt in.** the dat
10970 61 62 61 73 65 20 73 63 68 65 6d 61 2e 0a 2a 2a abase schema..**
10980 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 .** If the datab
10990 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 73 68 ase schema is sh
109a0 61 72 65 64 2c 20 74 68 65 6e 20 74 68 65 72 65 ared, then there
109b0 20 69 73 20 6f 6e 65 20 69 6e 73 74 61 6e 63 65 is one instance
109c0 20 6f 66 20 74 68 69 73 0a 2a 2a 20 73 74 72 75 of this.** stru
109d0 63 74 75 72 65 20 66 6f 72 20 65 61 63 68 20 64 cture for each d
109e0 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
109f0 6f 6e 20 28 73 71 6c 69 74 65 33 2a 29 20 74 68 on (sqlite3*) th
10a00 61 74 20 75 73 65 73 20 74 68 65 20 73 68 61 72 at uses the shar
10a10 65 64 0a 2a 2a 20 73 63 68 65 6d 61 2e 20 54 68 ed.** schema. Th
10a20 69 73 20 69 73 20 62 65 63 61 75 73 65 20 65 61 is is because ea
10a30 63 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e ch database conn
10a40 65 63 74 69 6f 6e 20 72 65 71 75 69 72 65 73 20 ection requires
10a50 69 74 73 20 6f 77 6e 20 75 6e 69 71 75 65 0a 2a its own unique.*
10a60 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 * instance of th
10a70 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 e sqlite3_vtab*
10a80 68 61 6e 64 6c 65 20 75 73 65 64 20 74 6f 20 61 handle used to a
10a90 63 63 65 73 73 20 74 68 65 20 76 69 72 74 75 61 ccess the virtua
10aa0 6c 20 74 61 62 6c 65 0a 2a 2a 20 69 6d 70 6c 65 l table.** imple
10ab0 6d 65 6e 74 61 74 69 6f 6e 2e 20 73 71 6c 69 74 mentation. sqlit
10ac0 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 6c 65 73 e3_vtab* handles
10ad0 20 63 61 6e 20 6e 6f 74 20 62 65 20 73 68 61 72 can not be shar
10ae0 65 64 20 62 65 74 77 65 65 6e 0a 2a 2a 20 64 61 ed between.** da
10af0 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
10b00 6e 73 2c 20 65 76 65 6e 20 77 68 65 6e 20 74 68 ns, even when th
10b10 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 69 6e e rest of the in
10b20 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 65 -memory database
10b30 0a 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 73 68 .** schema is sh
10b40 61 72 65 64 2c 20 61 73 20 74 68 65 20 69 6d 70 ared, as the imp
10b50 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 74 65 lementation ofte
10b60 6e 20 73 74 6f 72 65 73 20 74 68 65 20 64 61 74 n stores the dat
10b70 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 63 74 abase.** connect
10b80 69 6f 6e 20 68 61 6e 64 6c 65 20 70 61 73 73 65 ion handle passe
10b90 64 20 74 6f 20 69 74 20 76 69 61 20 74 68 65 20 d to it via the
10ba0 78 43 6f 6e 6e 65 63 74 28 29 20 6f 72 20 78 43 xConnect() or xC
10bb0 72 65 61 74 65 28 29 20 6d 65 74 68 6f 64 0a 2a reate() method.*
10bc0 2a 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c * during initial
10bd0 69 7a 61 74 69 6f 6e 20 69 6e 74 65 72 6e 61 6c ization internal
10be0 6c 79 2e 20 54 68 69 73 20 64 61 74 61 62 61 73 ly. This databas
10bf0 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e e connection han
10c00 64 6c 65 20 6d 61 79 0a 2a 2a 20 74 68 65 6e 20 dle may.** then
10c10 62 65 20 75 73 65 64 20 62 79 20 74 68 65 20 76 be used by the v
10c20 69 72 74 75 61 6c 20 74 61 62 6c 65 20 69 6d 70 irtual table imp
10c30 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 74 6f 20 61 lementation to a
10c40 63 63 65 73 73 20 72 65 61 6c 20 74 61 62 6c 65 ccess real table
10c50 73 0a 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 s.** within the
10c60 64 61 74 61 62 61 73 65 2e 20 53 6f 20 74 68 61 database. So tha
10c70 74 20 74 68 65 79 20 61 70 70 65 61 72 20 61 73 t they appear as
10c80 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 61 6c part of the cal
10c90 6c 65 72 73 0a 2a 2a 20 74 72 61 6e 73 61 63 74 lers.** transact
10ca0 69 6f 6e 2c 20 74 68 65 73 65 20 61 63 63 65 73 ion, these acces
10cb0 73 65 73 20 6e 65 65 64 20 74 6f 20 62 65 20 6d ses need to be m
10cc0 61 64 65 20 76 69 61 20 74 68 65 20 73 61 6d 65 ade via the same
10cd0 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
10ce0 6e 65 63 74 69 6f 6e 20 61 73 20 74 68 61 74 20 nection as that
10cf0 75 73 65 64 20 74 6f 20 65 78 65 63 75 74 65 20 used to execute
10d00 53 51 4c 20 6f 70 65 72 61 74 69 6f 6e 73 20 6f SQL operations o
10d10 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 n the virtual ta
10d20 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 56 ble..**.** All V
10d30 54 61 62 6c 65 20 6f 62 6a 65 63 74 73 20 74 68 Table objects th
10d40 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f at correspond to
10d50 20 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 a single table
10d60 69 6e 20 61 20 73 68 61 72 65 64 0a 2a 2a 20 64 in a shared.** d
10d70 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 61 atabase schema a
10d80 72 65 20 69 6e 69 74 69 61 6c 6c 79 20 73 74 6f re initially sto
10d90 72 65 64 20 69 6e 20 61 20 6c 69 6e 6b 65 64 2d red in a linked-
10da0 6c 69 73 74 20 70 6f 69 6e 74 65 64 20 74 6f 20 list pointed to
10db0 62 79 0a 2a 2a 20 74 68 65 20 54 61 62 6c 65 2e by.** the Table.
10dc0 70 56 54 61 62 6c 65 20 6d 65 6d 62 65 72 20 76 pVTable member v
10dd0 61 72 69 61 62 6c 65 20 6f 66 20 74 68 65 20 63 ariable of the c
10de0 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 54 61 62 orresponding Tab
10df0 6c 65 20 6f 62 6a 65 63 74 2e 0a 2a 2a 20 57 68 le object..** Wh
10e00 65 6e 20 61 6e 20 73 71 6c 69 74 65 33 5f 70 72 en an sqlite3_pr
10e10 65 70 61 72 65 28 29 20 6f 70 65 72 61 74 69 6f epare() operatio
10e20 6e 20 69 73 20 72 65 71 75 69 72 65 64 20 74 6f n is required to
10e30 20 61 63 63 65 73 73 20 74 68 65 20 76 69 72 74 access the virt
10e40 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 2c 20 69 74 ual.** table, it
10e50 20 73 65 61 72 63 68 65 73 20 74 68 65 20 6c 69 searches the li
10e60 73 74 20 66 6f 72 20 74 68 65 20 56 54 61 62 6c st for the VTabl
10e70 65 20 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e e that correspon
10e80 64 73 20 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 ds to the.** dat
10e90 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
10ea0 20 64 6f 69 6e 67 20 74 68 65 20 70 72 65 70 61 doing the prepa
10eb0 72 69 6e 67 20 73 6f 20 61 73 20 74 6f 20 75 73 ring so as to us
10ec0 65 20 74 68 65 20 63 6f 72 72 65 63 74 0a 2a 2a e the correct.**
10ed0 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 sqlite3_vtab* h
10ee0 61 6e 64 6c 65 20 69 6e 20 74 68 65 20 63 6f 6d andle in the com
10ef0 70 69 6c 65 64 20 71 75 65 72 79 2e 0a 2a 2a 0a piled query..**.
10f00 2a 2a 20 57 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 ** When an in-me
10f10 6d 6f 72 79 20 54 61 62 6c 65 20 6f 62 6a 65 63 mory Table objec
10f20 74 20 69 73 20 64 65 6c 65 74 65 64 20 28 66 6f t is deleted (fo
10f30 72 20 65 78 61 6d 70 6c 65 20 77 68 65 6e 20 74 r example when t
10f40 68 65 0a 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 he.** schema is
10f50 62 65 69 6e 67 20 72 65 6c 6f 61 64 65 64 20 66 being reloaded f
10f60 6f 72 20 73 6f 6d 65 20 72 65 61 73 6f 6e 29 2c or some reason),
10f70 20 74 68 65 20 56 54 61 62 6c 65 20 6f 62 6a 65 the VTable obje
10f80 63 74 73 20 61 72 65 20 6e 6f 74 0a 2a 2a 20 64 cts are not.** d
10f90 65 6c 65 74 65 64 20 61 6e 64 20 74 68 65 20 73 eleted and the s
10fa0 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e qlite3_vtab* han
10fb0 64 6c 65 73 20 61 72 65 20 6e 6f 74 20 78 44 69 dles are not xDi
10fc0 73 63 6f 6e 6e 65 63 74 28 29 65 64 0a 2a 2a 20 sconnect()ed.**
10fd0 69 6d 6d 65 64 69 61 74 65 6c 79 2e 20 49 6e 73 immediately. Ins
10fe0 74 65 61 64 2c 20 74 68 65 79 20 61 72 65 20 6d tead, they are m
10ff0 6f 76 65 64 20 66 72 6f 6d 20 74 68 65 20 54 61 oved from the Ta
11000 62 6c 65 2e 70 56 54 61 62 6c 65 20 6c 69 73 74 ble.pVTable list
11010 20 74 6f 0a 2a 2a 20 61 6e 6f 74 68 65 72 20 6c to.** another l
11020 69 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 64 65 inked list heade
11030 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 65 33 d by the sqlite3
11040 2e 70 44 69 73 63 6f 6e 6e 65 63 74 20 6d 65 6d .pDisconnect mem
11050 62 65 72 20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f ber of the.** co
11060 72 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c 69 rresponding sqli
11070 74 65 33 20 73 74 72 75 63 74 75 72 65 2e 20 54 te3 structure. T
11080 68 65 79 20 61 72 65 20 74 68 65 6e 20 64 65 6c hey are then del
11090 65 74 65 64 2f 78 44 69 73 63 6f 6e 6e 65 63 74 eted/xDisconnect
110a0 65 64 0a 2a 2a 20 6e 65 78 74 20 74 69 6d 65 20 ed.** next time
110b0 61 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 70 a statement is p
110c0 72 65 70 61 72 65 64 20 75 73 69 6e 67 20 73 61 repared using sa
110d0 69 64 20 73 71 6c 69 74 65 33 2a 2e 20 54 68 69 id sqlite3*. Thi
110e0 73 20 69 73 20 64 6f 6e 65 0a 2a 2a 20 74 6f 20 s is done.** to
110f0 61 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b 20 69 avoid deadlock i
11100 73 73 75 65 73 20 69 6e 76 6f 6c 76 69 6e 67 20 ssues involving
11110 6d 75 6c 74 69 70 6c 65 20 73 71 6c 69 74 65 33 multiple sqlite3
11120 2e 6d 75 74 65 78 20 6d 75 74 65 78 65 73 2e 0a .mutex mutexes..
11130 2a 2a 20 52 65 66 65 72 20 74 6f 20 63 6f 6d 6d ** Refer to comm
11140 65 6e 74 73 20 61 62 6f 76 65 20 66 75 6e 63 74 ents above funct
11150 69 6f 6e 20 73 71 6c 69 74 65 33 56 74 61 62 55 ion sqlite3VtabU
11160 6e 6c 6f 63 6b 4c 69 73 74 28 29 20 66 6f 72 20 nlockList() for
11170 61 6e 0a 2a 2a 20 65 78 70 6c 61 6e 61 74 69 6f an.** explanatio
11180 6e 20 61 73 20 74 6f 20 77 68 79 20 69 74 20 69 n as to why it i
11190 73 20 73 61 66 65 20 74 6f 20 61 64 64 20 61 6e s safe to add an
111a0 20 65 6e 74 72 79 20 74 6f 20 61 6e 20 73 71 6c entry to an sql
111b0 69 74 65 33 2e 70 44 69 73 63 6f 6e 6e 65 63 74 ite3.pDisconnect
111c0 0a 2a 2a 20 6c 69 73 74 20 77 69 74 68 6f 75 74 .** list without
111d0 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 63 6f 72 holding the cor
111e0 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c 69 74 responding sqlit
111f0 65 33 2e 6d 75 74 65 78 20 6d 75 74 65 78 2e 0a e3.mutex mutex..
11200 2a 2a 0a 2a 2a 20 54 68 65 20 6d 65 6d 6f 72 79 **.** The memory
11210 20 66 6f 72 20 6f 62 6a 65 63 74 73 20 6f 66 20 for objects of
11220 74 68 69 73 20 74 79 70 65 20 69 73 20 61 6c 77 this type is alw
11230 61 79 73 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 ays allocated by
11240 0a 2a 2a 20 73 71 6c 69 74 65 33 44 62 4d 61 6c .** sqlite3DbMal
11250 6c 6f 63 28 29 2c 20 75 73 69 6e 67 20 74 68 65 loc(), using the
11260 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 connection hand
11270 6c 65 20 73 74 6f 72 65 64 20 69 6e 20 56 54 61 le stored in VTa
11280 62 6c 65 2e 64 62 20 61 73 0a 2a 2a 20 74 68 65 ble.db as.** the
11290 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e first argument.
112a0 0a 2a 2f 0a 73 74 72 75 63 74 20 56 54 61 62 6c .*/.struct VTabl
112b0 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 e {. sqlite3 *d
112c0 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b;
112d0 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e /* Database conn
112e0 65 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65 ection associate
112f0 64 20 77 69 74 68 20 74 68 69 73 20 74 61 62 6c d with this tabl
11300 65 20 2a 2f 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 e */. Module *p
11310 4d 6f 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 Mod;
11320 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 6d /* Pointer to m
11330 6f 64 75 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 odule implementa
11340 74 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 tion */. sqlite
11350 33 5f 76 74 61 62 20 2a 70 56 74 61 62 3b 20 20 3_vtab *pVtab;
11360 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
11370 6f 20 76 74 61 62 20 69 6e 73 74 61 6e 63 65 20 o vtab instance
11380 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 20 */. int nRef;
11390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
113a0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e * Number of poin
113b0 74 65 72 73 20 74 6f 20 74 68 69 73 20 73 74 72 ters to this str
113c0 75 63 74 75 72 65 20 2a 2f 0a 20 20 75 38 20 62 ucture */. u8 b
113d0 43 6f 6e 73 74 72 61 69 6e 74 3b 20 20 20 20 20 Constraint;
113e0 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
113f0 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 72 65 constraints are
11400 20 73 75 70 70 6f 72 74 65 64 20 2a 2f 0a 20 20 supported */.
11410 69 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 3b 20 int iSavepoint;
11420 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 70 /* Dep
11430 74 68 20 6f 66 20 74 68 65 20 53 41 56 45 50 4f th of the SAVEPO
11440 49 4e 54 20 73 74 61 63 6b 20 2a 2f 0a 20 20 56 INT stack */. V
11450 54 61 62 6c 65 20 2a 70 4e 65 78 74 3b 20 20 20 Table *pNext;
11460 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 /* Next
11470 20 69 6e 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 in linked list
11480 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f 0a 7d (see above) */.}
11490 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 63 68 ;../*.** The sch
114a0 65 6d 61 20 66 6f 72 20 65 61 63 68 20 53 51 4c ema for each SQL
114b0 20 74 61 62 6c 65 20 61 6e 64 20 76 69 65 77 20 table and view
114c0 69 73 20 72 65 70 72 65 73 65 6e 74 65 64 20 69 is represented i
114d0 6e 20 6d 65 6d 6f 72 79 0a 2a 2a 20 62 79 20 61 n memory.** by a
114e0 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
114f0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 e following stru
11500 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 cture..*/.struct
11510 20 54 61 62 6c 65 20 7b 0a 20 20 63 68 61 72 20 Table {. char
11520 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 *zName;
11530 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 74 /* Name of the t
11540 61 62 6c 65 20 6f 72 20 76 69 65 77 20 2a 2f 0a able or view */.
11550 20 20 43 6f 6c 75 6d 6e 20 2a 61 43 6f 6c 3b 20 Column *aCol;
11560 20 20 20 20 20 20 20 2f 2a 20 49 6e 66 6f 72 6d /* Inform
11570 61 74 69 6f 6e 20 61 62 6f 75 74 20 65 61 63 68 ation about each
11580 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 49 6e 64 column */. Ind
11590 65 78 20 2a 70 49 6e 64 65 78 3b 20 20 20 20 20 ex *pIndex;
115a0 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 53 51 4c /* List of SQL
115b0 20 69 6e 64 65 78 65 73 20 6f 6e 20 74 68 69 73 indexes on this
115c0 20 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 53 65 6c table. */. Sel
115d0 65 63 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 ect *pSelect;
115e0 20 20 2f 2a 20 4e 55 4c 4c 20 66 6f 72 20 74 61 /* NULL for ta
115f0 62 6c 65 73 2e 20 20 50 6f 69 6e 74 73 20 74 6f bles. Points to
11600 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 66 20 61 definition if a
11610 20 76 69 65 77 2e 20 2a 2f 0a 20 20 46 4b 65 79 view. */. FKey
11620 20 2a 70 46 4b 65 79 3b 20 20 20 20 20 20 20 20 *pFKey;
11630 20 2f 2a 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 /* Linked list
11640 6f 66 20 61 6c 6c 20 66 6f 72 65 69 67 6e 20 6b of all foreign k
11650 65 79 73 20 69 6e 20 74 68 69 73 20 74 61 62 6c eys in this tabl
11660 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f e */. char *zCo
11670 6c 41 66 66 3b 20 20 20 20 20 20 20 2f 2a 20 53 lAff; /* S
11680 74 72 69 6e 67 20 64 65 66 69 6e 69 6e 67 20 74 tring defining t
11690 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 65 he affinity of e
116a0 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 ach column */.
116b0 45 78 70 72 4c 69 73 74 20 2a 70 43 68 65 63 6b ExprList *pCheck
116c0 3b 20 20 20 20 2f 2a 20 41 6c 6c 20 43 48 45 43 ; /* All CHEC
116d0 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f K constraints */
116e0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
116f0 20 20 20 20 20 20 20 20 2f 2a 20 20 20 2e 2e 2e /* ...
11700 20 61 6c 73 6f 20 75 73 65 64 20 61 73 20 63 6f also used as co
11710 6c 75 6d 6e 20 6e 61 6d 65 20 6c 69 73 74 20 69 lumn name list i
11720 6e 20 61 20 56 49 45 57 20 2a 2f 0a 20 20 69 6e n a VIEW */. in
11730 74 20 74 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 t tnum;
11740 20 20 20 2f 2a 20 52 6f 6f 74 20 42 54 72 65 65 /* Root BTree
11750 20 70 61 67 65 20 66 6f 72 20 74 68 69 73 20 74 page for this t
11760 61 62 6c 65 20 2a 2f 0a 20 20 69 31 36 20 69 50 able */. i16 iP
11770 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 2f Key; /
11780 2a 20 49 66 20 6e 6f 74 20 6e 65 67 61 74 69 76 * If not negativ
11790 65 2c 20 75 73 65 20 61 43 6f 6c 5b 69 50 4b 65 e, use aCol[iPKe
117a0 79 5d 20 61 73 20 74 68 65 20 72 6f 77 69 64 20 y] as the rowid
117b0 2a 2f 0a 20 20 69 31 36 20 6e 43 6f 6c 3b 20 20 */. i16 nCol;
117c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
117d0 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 ber of columns i
117e0 6e 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a n this table */.
117f0 20 20 75 31 36 20 6e 52 65 66 3b 20 20 20 20 20 u16 nRef;
11800 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
11810 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 of pointers to
11820 74 68 69 73 20 54 61 62 6c 65 20 2a 2f 0a 20 20 this Table */.
11830 4c 6f 67 45 73 74 20 6e 52 6f 77 4c 6f 67 45 73 LogEst nRowLogEs
11840 74 3b 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 t; /* Estimate
11850 64 20 72 6f 77 73 20 69 6e 20 74 61 62 6c 65 20 d rows in table
11860 2d 20 66 72 6f 6d 20 73 71 6c 69 74 65 5f 73 74 - from sqlite_st
11870 61 74 31 20 74 61 62 6c 65 20 2a 2f 0a 20 20 4c at1 table */. L
11880 6f 67 45 73 74 20 73 7a 54 61 62 52 6f 77 3b 20 ogEst szTabRow;
11890 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 /* Estimated
118a0 20 73 69 7a 65 20 6f 66 20 65 61 63 68 20 74 61 size of each ta
118b0 62 6c 65 20 72 6f 77 20 69 6e 20 62 79 74 65 73 ble row in bytes
118c0 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
118d0 45 5f 45 4e 41 42 4c 45 5f 43 4f 53 54 4d 55 4c E_ENABLE_COSTMUL
118e0 54 0a 20 20 4c 6f 67 45 73 74 20 63 6f 73 74 4d T. LogEst costM
118f0 75 6c 74 3b 20 20 20 20 20 2f 2a 20 43 6f 73 74 ult; /* Cost
11900 20 6d 75 6c 74 69 70 6c 69 65 72 20 66 6f 72 20 multiplier for
11910 75 73 69 6e 67 20 74 68 69 73 20 74 61 62 6c 65 using this table
11920 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 75 38 20 */.#endif. u8
11930 74 61 62 46 6c 61 67 73 3b 20 20 20 20 20 20 20 tabFlags;
11940 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 54 46 5f /* Mask of TF_
11950 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 38 * values */. u8
11960 20 6b 65 79 43 6f 6e 66 3b 20 20 20 20 20 20 20 keyConf;
11970 20 20 20 2f 2a 20 57 68 61 74 20 74 6f 20 64 6f /* What to do
11980 20 69 6e 20 63 61 73 65 20 6f 66 20 75 6e 69 71 in case of uniq
11990 75 65 6e 65 73 73 20 63 6f 6e 66 6c 69 63 74 20 ueness conflict
119a0 6f 6e 20 69 50 4b 65 79 20 2a 2f 0a 23 69 66 6e on iPKey */.#ifn
119b0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
119c0 41 4c 54 45 52 54 41 42 4c 45 0a 20 20 69 6e 74 ALTERTABLE. int
119d0 20 61 64 64 43 6f 6c 4f 66 66 73 65 74 3b 20 20 addColOffset;
119e0 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 20 43 /* Offset in C
119f0 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 6d 74 REATE TABLE stmt
11a00 20 74 6f 20 61 64 64 20 61 20 6e 65 77 20 63 6f to add a new co
11a10 6c 75 6d 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 lumn */.#endif.#
11a20 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
11a30 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
11a40 20 20 69 6e 74 20 6e 4d 6f 64 75 6c 65 41 72 67 int nModuleArg
11a50 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 ; /* Number
11a60 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 6f of arguments to
11a70 20 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f 0a 20 the module */.
11a80 20 63 68 61 72 20 2a 2a 61 7a 4d 6f 64 75 6c 65 char **azModule
11a90 41 72 67 3b 20 20 2f 2a 20 30 3a 20 6d 6f 64 75 Arg; /* 0: modu
11aa0 6c 65 20 31 3a 20 73 63 68 65 6d 61 20 32 3a 20 le 1: schema 2:
11ab0 76 74 61 62 20 6e 61 6d 65 20 33 2e 2e 2e 3a 20 vtab name 3...:
11ac0 61 72 67 73 20 2a 2f 0a 20 20 56 54 61 62 6c 65 args */. VTable
11ad0 20 2a 70 56 54 61 62 6c 65 3b 20 20 20 20 20 2f *pVTable; /
11ae0 2a 20 4c 69 73 74 20 6f 66 20 56 54 61 62 6c 65 * List of VTable
11af0 20 6f 62 6a 65 63 74 73 2e 20 2a 2f 0a 23 65 6e objects. */.#en
11b00 64 69 66 0a 20 20 54 72 69 67 67 65 72 20 2a 70 dif. Trigger *p
11b10 54 72 69 67 67 65 72 3b 20 20 20 2f 2a 20 4c 69 Trigger; /* Li
11b20 73 74 20 6f 66 20 74 72 69 67 67 65 72 73 20 73 st of triggers s
11b30 74 6f 72 65 64 20 69 6e 20 70 53 63 68 65 6d 61 tored in pSchema
11b40 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 */. Schema *pS
11b50 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 53 63 chema; /* Sc
11b60 68 65 6d 61 20 74 68 61 74 20 63 6f 6e 74 61 69 hema that contai
11b70 6e 73 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f ns this table */
11b80 0a 20 20 54 61 62 6c 65 20 2a 70 4e 65 78 74 5a . Table *pNextZ
11b90 6f 6d 62 69 65 3b 20 20 2f 2a 20 4e 65 78 74 20 ombie; /* Next
11ba0 6f 6e 20 74 68 65 20 50 61 72 73 65 2e 70 5a 6f on the Parse.pZo
11bb0 6d 62 69 65 54 61 62 20 6c 69 73 74 20 2a 2f 0a mbieTab list */.
11bc0 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 };../*.** Allowe
11bd0 64 20 76 61 6c 75 65 73 20 66 6f 72 20 54 61 62 d values for Tab
11be0 6c 65 2e 74 61 62 46 6c 61 67 73 2e 0a 2a 2a 0a le.tabFlags..**.
11bf0 2a 2a 20 54 46 5f 4f 4f 4f 48 69 64 64 65 6e 20 ** TF_OOOHidden
11c00 61 70 70 6c 69 65 73 20 74 6f 20 74 61 62 6c 65 applies to table
11c10 73 20 6f 72 20 76 69 65 77 20 74 68 61 74 20 68 s or view that h
11c20 61 76 65 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d ave hidden colum
11c30 6e 73 20 74 68 61 74 20 61 72 65 0a 2a 2a 20 66 ns that are.** f
11c40 6f 6c 6c 6f 77 65 64 20 62 79 20 6e 6f 6e 2d 68 ollowed by non-h
11c50 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 2e 20 20 idden columns.
11c60 45 78 61 6d 70 6c 65 3a 20 20 22 43 52 45 41 54 Example: "CREAT
11c70 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20 E VIRTUAL TABLE
11c80 78 20 55 53 49 4e 47 0a 2a 2a 20 76 74 61 62 31 x USING.** vtab1
11c90 28 61 20 48 49 44 44 45 4e 2c 20 62 29 3b 22 2e (a HIDDEN, b);".
11ca0 20 20 53 69 6e 63 65 20 22 62 22 20 69 73 20 61 Since "b" is a
11cb0 20 6e 6f 6e 2d 68 69 64 64 65 6e 20 63 6f 6c 75 non-hidden colu
11cc0 6d 6e 20 62 75 74 20 22 61 22 20 69 73 20 68 69 mn but "a" is hi
11cd0 64 64 65 6e 2c 0a 2a 2a 20 74 68 65 20 54 46 5f dden,.** the TF_
11ce0 4f 4f 4f 48 69 64 64 65 6e 20 61 74 74 72 69 62 OOOHidden attrib
11cf0 75 74 65 20 77 6f 75 6c 64 20 61 70 70 6c 79 20 ute would apply
11d00 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 53 in this case. S
11d10 75 63 68 20 74 61 62 6c 65 73 20 72 65 71 75 69 uch tables requi
11d20 72 65 0a 2a 2a 20 73 70 65 63 69 61 6c 20 68 61 re.** special ha
11d30 6e 64 6c 69 6e 67 20 64 75 72 69 6e 67 20 49 4e ndling during IN
11d40 53 45 52 54 20 70 72 6f 63 65 73 73 69 6e 67 2e SERT processing.
11d50 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 52 .*/.#define TF_R
11d60 65 61 64 6f 6e 6c 79 20 20 20 20 20 20 20 20 30 eadonly 0
11d70 78 30 31 20 20 20 20 2f 2a 20 52 65 61 64 2d 6f x01 /* Read-o
11d80 6e 6c 79 20 73 79 73 74 65 6d 20 74 61 62 6c 65 nly system table
11d90 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 45 */.#define TF_E
11da0 70 68 65 6d 65 72 61 6c 20 20 20 20 20 20 20 30 phemeral 0
11db0 78 30 32 20 20 20 20 2f 2a 20 41 6e 20 65 70 68 x02 /* An eph
11dc0 65 6d 65 72 61 6c 20 74 61 62 6c 65 20 2a 2f 0a emeral table */.
11dd0 23 64 65 66 69 6e 65 20 54 46 5f 48 61 73 50 72 #define TF_HasPr
11de0 69 6d 61 72 79 4b 65 79 20 20 20 30 78 30 34 20 imaryKey 0x04
11df0 20 20 20 2f 2a 20 54 61 62 6c 65 20 68 61 73 20 /* Table has
11e00 61 20 70 72 69 6d 61 72 79 20 6b 65 79 20 2a 2f a primary key */
11e10 0a 23 64 65 66 69 6e 65 20 54 46 5f 41 75 74 6f .#define TF_Auto
11e20 69 6e 63 72 65 6d 65 6e 74 20 20 20 30 78 30 38 increment 0x08
11e30 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 70 /* Integer p
11e40 72 69 6d 61 72 79 20 6b 65 79 20 69 73 20 61 75 rimary key is au
11e50 74 6f 69 6e 63 72 65 6d 65 6e 74 20 2a 2f 0a 23 toincrement */.#
11e60 64 65 66 69 6e 65 20 54 46 5f 56 69 72 74 75 61 define TF_Virtua
11e70 6c 20 20 20 20 20 20 20 20 20 30 78 31 30 20 20 l 0x10
11e80 20 20 2f 2a 20 49 73 20 61 20 76 69 72 74 75 61 /* Is a virtua
11e90 6c 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 l table */.#defi
11ea0 6e 65 20 54 46 5f 57 69 74 68 6f 75 74 52 6f 77 ne TF_WithoutRow
11eb0 69 64 20 20 20 20 30 78 32 30 20 20 20 20 2f 2a id 0x20 /*
11ec0 20 4e 6f 20 72 6f 77 69 64 2e 20 20 50 52 49 4d No rowid. PRIM
11ed0 41 52 59 20 4b 45 59 20 69 73 20 74 68 65 20 6b ARY KEY is the k
11ee0 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 ey */.#define TF
11ef0 5f 4e 6f 56 69 73 69 62 6c 65 52 6f 77 69 64 20 _NoVisibleRowid
11f00 20 30 78 34 30 20 20 20 20 2f 2a 20 4e 6f 20 75 0x40 /* No u
11f10 73 65 72 2d 76 69 73 69 62 6c 65 20 22 72 6f 77 ser-visible "row
11f20 69 64 22 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 id" column */.#d
11f30 65 66 69 6e 65 20 54 46 5f 4f 4f 4f 48 69 64 64 efine TF_OOOHidd
11f40 65 6e 20 20 20 20 20 20 20 30 78 38 30 20 20 20 en 0x80
11f50 20 2f 2a 20 4f 75 74 2d 6f 66 2d 4f 72 64 65 72 /* Out-of-Order
11f60 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e 73 20 hidden columns
11f70 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 */.../*.** Test
11f80 74 6f 20 73 65 65 20 77 68 65 74 68 65 72 20 6f to see whether o
11f90 72 20 6e 6f 74 20 61 20 74 61 62 6c 65 20 69 73 r not a table is
11fa0 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 a virtual table
11fb0 2e 20 20 54 68 69 73 20 69 73 0a 2a 2a 20 64 6f . This is.** do
11fc0 6e 65 20 61 73 20 61 20 6d 61 63 72 6f 20 73 6f ne as a macro so
11fd0 20 74 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 that it will be
11fe0 20 6f 70 74 69 6d 69 7a 65 64 20 6f 75 74 20 77 optimized out w
11ff0 68 65 6e 20 76 69 72 74 75 61 6c 0a 2a 2a 20 74 hen virtual.** t
12000 61 62 6c 65 20 73 75 70 70 6f 72 74 20 69 73 20 able support is
12010 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 omitted from the
12020 20 62 75 69 6c 64 2e 0a 2a 2f 0a 23 69 66 6e 64 build..*/.#ifnd
12030 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ef SQLITE_OMIT_V
12040 49 52 54 55 41 4c 54 41 42 4c 45 0a 23 20 20 64 IRTUALTABLE.# d
12050 65 66 69 6e 65 20 49 73 56 69 72 74 75 61 6c 28 efine IsVirtual(
12060 58 29 20 20 20 20 20 20 28 28 28 58 29 2d 3e 74 X) (((X)->t
12070 61 62 46 6c 61 67 73 20 26 20 54 46 5f 56 69 72 abFlags & TF_Vir
12080 74 75 61 6c 29 21 3d 30 29 0a 23 65 6c 73 65 0a tual)!=0).#else.
12090 23 20 20 64 65 66 69 6e 65 20 49 73 56 69 72 74 # define IsVirt
120a0 75 61 6c 28 58 29 20 20 20 20 20 20 30 0a 23 65 ual(X) 0.#e
120b0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 ndif../*.** Macr
120c0 6f 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 os to determine
120d0 69 66 20 61 20 63 6f 6c 75 6d 6e 20 69 73 20 68 if a column is h
120e0 69 64 64 65 6e 2e 20 20 49 73 4f 72 64 69 6e 61 idden. IsOrdina
120f0 72 79 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 29 ryHiddenColumn()
12100 0a 2a 2a 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 66 .** only works f
12110 6f 72 20 6e 6f 6e 2d 76 69 72 74 75 61 6c 20 74 or non-virtual t
12120 61 62 6c 65 73 20 28 6f 72 64 69 6e 61 72 79 20 ables (ordinary
12130 74 61 62 6c 65 73 20 61 6e 64 20 76 69 65 77 73 tables and views
12140 29 20 61 6e 64 20 69 73 0a 2a 2a 20 61 6c 77 61 ) and is.** alwa
12150 79 73 20 66 61 6c 73 65 20 75 6e 6c 65 73 73 20 ys false unless
12160 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 48 49 SQLITE_ENABLE_HI
12170 44 44 45 4e 5f 43 4f 4c 55 4d 4e 53 20 69 73 20 DDEN_COLUMNS is
12180 64 65 66 69 6e 65 64 2e 20 20 54 68 65 0a 2a 2a defined. The.**
12190 20 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 IsHiddenColumn(
121a0 29 20 6d 61 63 72 6f 20 69 73 20 67 65 6e 65 72 ) macro is gener
121b0 61 6c 20 70 75 72 70 6f 73 65 2e 0a 2a 2f 0a 23 al purpose..*/.#
121c0 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
121d0 45 5f 45 4e 41 42 4c 45 5f 48 49 44 44 45 4e 5f E_ENABLE_HIDDEN_
121e0 43 4f 4c 55 4d 4e 53 29 0a 23 20 20 64 65 66 69 COLUMNS).# defi
121f0 6e 65 20 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d ne IsHiddenColum
12200 6e 28 58 29 20 20 20 20 20 20 20 20 20 28 28 28 n(X) (((
12210 58 29 2d 3e 63 6f 6c 46 6c 61 67 73 20 26 20 43 X)->colFlags & C
12220 4f 4c 46 4c 41 47 5f 48 49 44 44 45 4e 29 21 3d OLFLAG_HIDDEN)!=
12230 30 29 0a 23 20 20 64 65 66 69 6e 65 20 49 73 4f 0).# define IsO
12240 72 64 69 6e 61 72 79 48 69 64 64 65 6e 43 6f 6c rdinaryHiddenCol
12250 75 6d 6e 28 58 29 20 28 28 28 58 29 2d 3e 63 6f umn(X) (((X)->co
12260 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 lFlags & COLFLAG
12270 5f 48 49 44 44 45 4e 29 21 3d 30 29 0a 23 65 6c _HIDDEN)!=0).#el
12280 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
12290 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
122a0 41 42 4c 45 29 0a 23 20 20 64 65 66 69 6e 65 20 ABLE).# define
122b0 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 IsHiddenColumn(X
122c0 29 20 20 20 20 20 20 20 20 20 28 28 28 58 29 2d ) (((X)-
122d0 3e 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 >colFlags & COLF
122e0 4c 41 47 5f 48 49 44 44 45 4e 29 21 3d 30 29 0a LAG_HIDDEN)!=0).
122f0 23 20 20 64 65 66 69 6e 65 20 49 73 4f 72 64 69 # define IsOrdi
12300 6e 61 72 79 48 69 64 64 65 6e 43 6f 6c 75 6d 6e naryHiddenColumn
12310 28 58 29 20 30 0a 23 65 6c 73 65 0a 23 20 20 64 (X) 0.#else.# d
12320 65 66 69 6e 65 20 49 73 48 69 64 64 65 6e 43 6f efine IsHiddenCo
12330 6c 75 6d 6e 28 58 29 20 20 20 20 20 20 20 20 20 lumn(X)
12340 30 0a 23 20 20 64 65 66 69 6e 65 20 49 73 4f 72 0.# define IsOr
12350 64 69 6e 61 72 79 48 69 64 64 65 6e 43 6f 6c 75 dinaryHiddenColu
12360 6d 6e 28 58 29 20 30 0a 23 65 6e 64 69 66 0a 0a mn(X) 0.#endif..
12370 0a 2f 2a 20 44 6f 65 73 20 74 68 65 20 74 61 62 ./* Does the tab
12380 6c 65 20 68 61 76 65 20 61 20 72 6f 77 69 64 20 le have a rowid
12390 2a 2f 0a 23 64 65 66 69 6e 65 20 48 61 73 52 6f */.#define HasRo
123a0 77 69 64 28 58 29 20 20 20 20 20 28 28 28 58 29 wid(X) (((X)
123b0 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f ->tabFlags & TF_
123c0 57 69 74 68 6f 75 74 52 6f 77 69 64 29 3d 3d 30 WithoutRowid)==0
123d0 29 0a 23 64 65 66 69 6e 65 20 56 69 73 69 62 6c ).#define Visibl
123e0 65 52 6f 77 69 64 28 58 29 20 28 28 28 58 29 2d eRowid(X) (((X)-
123f0 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f 4e >tabFlags & TF_N
12400 6f 56 69 73 69 62 6c 65 52 6f 77 69 64 29 3d 3d oVisibleRowid)==
12410 30 29 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 66 0)../*.** Each f
12420 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 oreign key const
12430 72 61 69 6e 74 20 69 73 20 61 6e 20 69 6e 73 74 raint is an inst
12440 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
12450 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e owing structure.
12460 0a 2a 2a 0a 2a 2a 20 41 20 66 6f 72 65 69 67 6e .**.** A foreign
12470 20 6b 65 79 20 69 73 20 61 73 73 6f 63 69 61 74 key is associat
12480 65 64 20 77 69 74 68 20 74 77 6f 20 74 61 62 6c ed with two tabl
12490 65 73 2e 20 20 54 68 65 20 22 66 72 6f 6d 22 20 es. The "from"
124a0 74 61 62 6c 65 20 69 73 0a 2a 2a 20 74 68 65 20 table is.** the
124b0 74 61 62 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 table that conta
124c0 69 6e 73 20 74 68 65 20 52 45 46 45 52 45 4e 43 ins the REFERENC
124d0 45 53 20 63 6c 61 75 73 65 20 74 68 61 74 20 63 ES clause that c
124e0 72 65 61 74 65 73 20 74 68 65 20 66 6f 72 65 69 reates the forei
124f0 67 6e 0a 2a 2a 20 6b 65 79 2e 20 20 54 68 65 20 gn.** key. The
12500 22 74 6f 22 20 74 61 62 6c 65 20 69 73 20 74 68 "to" table is th
12510 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 73 20 e table that is
12520 6e 61 6d 65 64 20 69 6e 20 74 68 65 20 52 45 46 named in the REF
12530 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 2e 0a ERENCES clause..
12540 2a 2a 20 43 6f 6e 73 69 64 65 72 20 74 68 69 73 ** Consider this
12550 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 example:.**.**
12560 20 20 20 20 43 52 45 41 54 45 20 54 41 42 4c 45 CREATE TABLE
12570 20 65 78 31 28 0a 2a 2a 20 20 20 20 20 20 20 61 ex1(.** a
12580 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 INTEGER PRIMARY
12590 20 4b 45 59 2c 0a 2a 2a 20 20 20 20 20 20 20 62 KEY,.** b
125a0 20 49 4e 54 45 47 45 52 20 43 4f 4e 53 54 52 41 INTEGER CONSTRA
125b0 49 4e 54 20 66 6b 31 20 52 45 46 45 52 45 4e 43 INT fk1 REFERENC
125c0 45 53 20 65 78 32 28 78 29 0a 2a 2a 20 20 20 20 ES ex2(x).**
125d0 20 29 3b 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 66 6f );.**.** For fo
125e0 72 65 69 67 6e 20 6b 65 79 20 22 66 6b 31 22 2c reign key "fk1",
125f0 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 20 the from-table
12600 69 73 20 22 65 78 31 22 20 61 6e 64 20 74 68 65 is "ex1" and the
12610 20 74 6f 2d 74 61 62 6c 65 20 69 73 20 22 65 78 to-table is "ex
12620 32 22 2e 0a 2a 2a 20 45 71 75 69 76 61 6c 65 6e 2"..** Equivalen
12630 74 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 t names:.**.**
12640 20 20 20 66 72 6f 6d 2d 74 61 62 6c 65 20 3d 3d from-table ==
12650 20 63 68 69 6c 64 2d 74 61 62 6c 65 0a 2a 2a 20 child-table.**
12660 20 20 20 20 20 20 74 6f 2d 74 61 62 6c 65 20 3d to-table =
12670 3d 20 70 61 72 65 6e 74 2d 74 61 62 6c 65 0a 2a = parent-table.*
12680 2a 0a 2a 2a 20 45 61 63 68 20 52 45 46 45 52 45 *.** Each REFERE
12690 4e 43 45 53 20 63 6c 61 75 73 65 20 67 65 6e 65 NCES clause gene
126a0 72 61 74 65 73 20 61 6e 20 69 6e 73 74 61 6e 63 rates an instanc
126b0 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
126c0 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 ng structure.**
126d0 77 68 69 63 68 20 69 73 20 61 74 74 61 63 68 65 which is attache
126e0 64 20 74 6f 20 74 68 65 20 66 72 6f 6d 2d 74 61 d to the from-ta
126f0 62 6c 65 2e 20 20 54 68 65 20 74 6f 2d 74 61 62 ble. The to-tab
12700 6c 65 20 6e 65 65 64 20 6e 6f 74 20 65 78 69 73 le need not exis
12710 74 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 66 72 t when.** the fr
12720 6f 6d 2d 74 61 62 6c 65 20 69 73 20 63 72 65 61 om-table is crea
12730 74 65 64 2e 20 20 54 68 65 20 65 78 69 73 74 65 ted. The existe
12740 6e 63 65 20 6f 66 20 74 68 65 20 74 6f 2d 74 61 nce of the to-ta
12750 62 6c 65 20 69 73 20 6e 6f 74 20 63 68 65 63 6b ble is not check
12760 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 69 ed..**.** The li
12770 73 74 20 6f 66 20 61 6c 6c 20 70 61 72 65 6e 74 st of all parent
12780 73 20 66 6f 72 20 63 68 69 6c 64 20 54 61 62 6c s for child Tabl
12790 65 20 58 20 69 73 20 68 65 6c 64 20 61 74 20 58 e X is held at X
127a0 2e 70 46 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 20 .pFKey..**.** A
127b0 6c 69 73 74 20 6f 66 20 61 6c 6c 20 63 68 69 6c list of all chil
127c0 64 72 65 6e 20 66 6f 72 20 61 20 74 61 62 6c 65 dren for a table
127d0 20 6e 61 6d 65 64 20 5a 20 28 77 68 69 63 68 20 named Z (which
127e0 6d 69 67 68 74 20 6e 6f 74 20 65 76 65 6e 20 65 might not even e
127f0 78 69 73 74 29 0a 2a 2a 20 69 73 20 68 65 6c 64 xist).** is held
12800 20 69 6e 20 53 63 68 65 6d 61 2e 66 6b 65 79 48 in Schema.fkeyH
12810 61 73 68 20 77 69 74 68 20 61 20 68 61 73 68 20 ash with a hash
12820 6b 65 79 20 6f 66 20 5a 2e 0a 2a 2f 0a 73 74 72 key of Z..*/.str
12830 75 63 74 20 46 4b 65 79 20 7b 0a 20 20 54 61 62 uct FKey {. Tab
12840 6c 65 20 2a 70 46 72 6f 6d 3b 20 20 20 20 20 2f le *pFrom; /
12850 2a 20 54 61 62 6c 65 20 63 6f 6e 74 61 69 6e 69 * Table containi
12860 6e 67 20 74 68 65 20 52 45 46 45 52 45 4e 43 45 ng the REFERENCE
12870 53 20 63 6c 61 75 73 65 20 28 61 6b 61 3a 20 43 S clause (aka: C
12880 68 69 6c 64 29 20 2a 2f 0a 20 20 46 4b 65 79 20 hild) */. FKey
12890 2a 70 4e 65 78 74 46 72 6f 6d 3b 20 20 2f 2a 20 *pNextFrom; /*
128a0 4e 65 78 74 20 46 4b 65 79 20 77 69 74 68 20 74 Next FKey with t
128b0 68 65 20 73 61 6d 65 20 69 6e 20 70 46 72 6f 6d he same in pFrom
128c0 2e 20 4e 65 78 74 20 70 61 72 65 6e 74 20 6f 66 . Next parent of
128d0 20 70 46 72 6f 6d 20 2a 2f 0a 20 20 63 68 61 72 pFrom */. char
128e0 20 2a 7a 54 6f 3b 20 20 20 20 20 20 20 20 2f 2a *zTo; /*
128f0 20 4e 61 6d 65 20 6f 66 20 74 61 62 6c 65 20 74 Name of table t
12900 68 61 74 20 74 68 65 20 6b 65 79 20 70 6f 69 6e hat the key poin
12910 74 73 20 74 6f 20 28 61 6b 61 3a 20 50 61 72 65 ts to (aka: Pare
12920 6e 74 29 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 nt) */. FKey *p
12930 4e 65 78 74 54 6f 3b 20 20 20 20 2f 2a 20 4e 65 NextTo; /* Ne
12940 78 74 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 xt with the same
12950 20 7a 54 6f 2e 20 4e 65 78 74 20 63 68 69 6c 64 zTo. Next child
12960 20 6f 66 20 7a 54 6f 2e 20 2a 2f 0a 20 20 46 4b of zTo. */. FK
12970 65 79 20 2a 70 50 72 65 76 54 6f 3b 20 20 20 20 ey *pPrevTo;
12980 2f 2a 20 50 72 65 76 69 6f 75 73 20 77 69 74 68 /* Previous with
12990 20 74 68 65 20 73 61 6d 65 20 7a 54 6f 20 2a 2f the same zTo */
129a0 0a 20 20 69 6e 74 20 6e 43 6f 6c 3b 20 20 20 20 . int nCol;
129b0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
129c0 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 69 f columns in thi
129d0 73 20 6b 65 79 20 2a 2f 0a 20 20 2f 2a 20 45 56 s key */. /* EV
129e0 3a 20 52 2d 33 30 33 32 33 2d 32 31 39 31 37 20 : R-30323-21917
129f0 2a 2f 0a 20 20 75 38 20 69 73 44 65 66 65 72 72 */. u8 isDeferr
12a00 65 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 72 75 ed; /* Tru
12a10 65 20 69 66 20 63 6f 6e 73 74 72 61 69 6e 74 20 e if constraint
12a20 63 68 65 63 6b 69 6e 67 20 69 73 20 64 65 66 65 checking is defe
12a30 72 72 65 64 20 74 69 6c 6c 20 43 4f 4d 4d 49 54 rred till COMMIT
12a40 20 2a 2f 0a 20 20 75 38 20 61 41 63 74 69 6f 6e */. u8 aAction
12a50 5b 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f [2]; /* O
12a60 4e 20 44 45 4c 45 54 45 20 61 6e 64 20 4f 4e 20 N DELETE and ON
12a70 55 50 44 41 54 45 20 61 63 74 69 6f 6e 73 2c 20 UPDATE actions,
12a80 72 65 73 70 65 63 74 69 76 65 6c 79 20 2a 2f 0a respectively */.
12a90 20 20 54 72 69 67 67 65 72 20 2a 61 70 54 72 69 Trigger *apTri
12aa0 67 67 65 72 5b 32 5d 3b 2f 2a 20 54 72 69 67 67 gger[2];/* Trigg
12ab0 65 72 73 20 66 6f 72 20 61 41 63 74 69 6f 6e 5b ers for aAction[
12ac0 5d 20 61 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 ] actions */. s
12ad0 74 72 75 63 74 20 73 43 6f 6c 4d 61 70 20 7b 20 truct sColMap {
12ae0 20 20 20 20 20 2f 2a 20 4d 61 70 70 69 6e 67 20 /* Mapping
12af0 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 70 46 of columns in pF
12b00 72 6f 6d 20 74 6f 20 63 6f 6c 75 6d 6e 73 20 69 rom to columns i
12b10 6e 20 7a 54 6f 20 2a 2f 0a 20 20 20 20 69 6e 74 n zTo */. int
12b20 20 69 46 72 6f 6d 3b 20 20 20 20 20 20 20 20 20 iFrom;
12b30 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 63 /* Index of c
12b40 6f 6c 75 6d 6e 20 69 6e 20 70 46 72 6f 6d 20 2a olumn in pFrom *
12b50 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 43 6f 6c /. char *zCol
12b60 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ; /* N
12b70 61 6d 65 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e ame of column in
12b80 20 7a 54 6f 2e 20 20 49 66 20 4e 55 4c 4c 20 75 zTo. If NULL u
12b90 73 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 2a se PRIMARY KEY *
12ba0 2f 0a 20 20 7d 20 61 43 6f 6c 5b 31 5d 3b 20 20 /. } aCol[1];
12bb0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 /* One
12bc0 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63 68 20 entry for each
12bd0 6f 66 20 6e 43 6f 6c 20 63 6f 6c 75 6d 6e 73 20 of nCol columns
12be0 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c */.};../*.** SQL
12bf0 69 74 65 20 73 75 70 70 6f 72 74 73 20 6d 61 6e ite supports man
12c00 79 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 y different ways
12c10 20 74 6f 20 72 65 73 6f 6c 76 65 20 61 20 63 6f to resolve a co
12c20 6e 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f nstraint.** erro
12c30 72 2e 20 20 52 4f 4c 4c 42 41 43 4b 20 70 72 6f r. ROLLBACK pro
12c40 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 68 cessing means th
12c50 61 74 20 61 20 63 6f 6e 73 74 72 61 69 6e 74 20 at a constraint
12c60 76 69 6f 6c 61 74 69 6f 6e 0a 2a 2a 20 63 61 75 violation.** cau
12c70 73 65 73 20 74 68 65 20 6f 70 65 72 61 74 69 6f ses the operatio
12c80 6e 20 69 6e 20 70 72 6f 63 65 73 73 20 74 6f 20 n in process to
12c90 66 61 69 6c 20 61 6e 64 20 66 6f 72 20 74 68 65 fail and for the
12ca0 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 current transac
12cb0 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 20 72 6f tion.** to be ro
12cc0 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 42 4f 52 lled back. ABOR
12cd0 54 20 70 72 6f 63 65 73 73 69 6e 67 20 6d 65 61 T processing mea
12ce0 6e 73 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e ns the operation
12cf0 20 69 6e 20 70 72 6f 63 65 73 73 0a 2a 2a 20 66 in process.** f
12d00 61 69 6c 73 20 61 6e 64 20 61 6e 79 20 70 72 69 ails and any pri
12d10 6f 72 20 63 68 61 6e 67 65 73 20 66 72 6f 6d 20 or changes from
12d20 74 68 61 74 20 6f 6e 65 20 6f 70 65 72 61 74 69 that one operati
12d30 6f 6e 20 61 72 65 20 62 61 63 6b 65 64 20 6f 75 on are backed ou
12d40 74 2c 0a 2a 2a 20 62 75 74 20 74 68 65 20 74 72 t,.** but the tr
12d50 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f 74 ansaction is not
12d60 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 46 rolled back. F
12d70 41 49 4c 20 70 72 6f 63 65 73 73 69 6e 67 20 6d AIL processing m
12d80 65 61 6e 73 20 74 68 61 74 0a 2a 2a 20 74 68 65 eans that.** the
12d90 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 operation in pr
12da0 6f 67 72 65 73 73 20 73 74 6f 70 73 20 61 6e 64 ogress stops and
12db0 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f returns an erro
12dc0 72 20 63 6f 64 65 2e 20 20 42 75 74 20 70 72 69 r code. But pri
12dd0 6f 72 0a 2a 2a 20 63 68 61 6e 67 65 73 20 64 75 or.** changes du
12de0 65 20 74 6f 20 74 68 65 20 73 61 6d 65 20 6f 70 e to the same op
12df0 65 72 61 74 69 6f 6e 20 61 72 65 20 6e 6f 74 20 eration are not
12e00 62 61 63 6b 65 64 20 6f 75 74 20 61 6e 64 20 6e backed out and n
12e10 6f 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a 20 6f 63 o rollback.** oc
12e20 63 75 72 73 2e 20 20 49 47 4e 4f 52 45 20 6d 65 curs. IGNORE me
12e30 61 6e 73 20 74 68 61 74 20 74 68 65 20 70 61 72 ans that the par
12e40 74 69 63 75 6c 61 72 20 72 6f 77 20 74 68 61 74 ticular row that
12e50 20 63 61 75 73 65 64 20 74 68 65 20 63 6f 6e 73 caused the cons
12e60 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 traint.** error
12e70 69 73 20 6e 6f 74 20 69 6e 73 65 72 74 65 64 20 is not inserted
12e80 6f 72 20 75 70 64 61 74 65 64 2e 20 20 50 72 6f or updated. Pro
12e90 63 65 73 73 69 6e 67 20 63 6f 6e 74 69 6e 75 65 cessing continue
12ea0 73 20 61 6e 64 20 6e 6f 20 65 72 72 6f 72 0a 2a s and no error.*
12eb0 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 * is returned.
12ec0 52 45 50 4c 41 43 45 20 6d 65 61 6e 73 20 74 68 REPLACE means th
12ed0 61 74 20 70 72 65 65 78 69 73 74 69 6e 67 20 64 at preexisting d
12ee0 61 74 61 62 61 73 65 20 72 6f 77 73 20 74 68 61 atabase rows tha
12ef0 74 20 63 61 75 73 65 64 0a 2a 2a 20 61 20 55 4e t caused.** a UN
12f00 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 IQUE constraint
12f10 76 69 6f 6c 61 74 69 6f 6e 20 61 72 65 20 72 65 violation are re
12f20 6d 6f 76 65 64 20 73 6f 20 74 68 61 74 20 74 68 moved so that th
12f30 65 20 6e 65 77 20 69 6e 73 65 72 74 20 6f 72 0a e new insert or.
12f40 2a 2a 20 75 70 64 61 74 65 20 63 61 6e 20 70 72 ** update can pr
12f50 6f 63 65 65 64 2e 20 20 50 72 6f 63 65 73 73 69 oceed. Processi
12f60 6e 67 20 63 6f 6e 74 69 6e 75 65 73 20 61 6e 64 ng continues and
12f70 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72 65 70 no error is rep
12f80 6f 72 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 52 45 53 orted..**.** RES
12f90 54 52 49 43 54 2c 20 53 45 54 4e 55 4c 4c 2c 20 TRICT, SETNULL,
12fa0 61 6e 64 20 43 41 53 43 41 44 45 20 61 63 74 69 and CASCADE acti
12fb0 6f 6e 73 20 61 70 70 6c 79 20 6f 6e 6c 79 20 74 ons apply only t
12fc0 6f 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 2e 0a o foreign keys..
12fd0 2a 2a 20 52 45 53 54 52 49 43 54 20 69 73 20 74 ** RESTRICT is t
12fe0 68 65 20 73 61 6d 65 20 61 73 20 41 42 4f 52 54 he same as ABORT
12ff0 20 66 6f 72 20 49 4d 4d 45 44 49 41 54 45 20 66 for IMMEDIATE f
13000 6f 72 65 69 67 6e 20 6b 65 79 73 20 61 6e 64 20 oreign keys and
13010 74 68 65 0a 2a 2a 20 73 61 6d 65 20 61 73 20 52 the.** same as R
13020 4f 4c 4c 42 41 43 4b 20 66 6f 72 20 44 45 46 45 OLLBACK for DEFE
13030 52 52 45 44 20 6b 65 79 73 2e 20 20 53 45 54 4e RRED keys. SETN
13040 55 4c 4c 20 6d 65 61 6e 73 20 74 68 61 74 20 74 ULL means that t
13050 68 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 6b 65 he foreign.** ke
13060 79 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c y is set to NULL
13070 2e 20 20 43 41 53 43 41 44 45 20 6d 65 61 6e 73 . CASCADE means
13080 20 74 68 61 74 20 61 20 44 45 4c 45 54 45 20 6f that a DELETE o
13090 72 20 55 50 44 41 54 45 20 6f 66 20 74 68 65 0a r UPDATE of the.
130a0 2a 2a 20 72 65 66 65 72 65 6e 63 65 64 20 74 61 ** referenced ta
130b0 62 6c 65 20 72 6f 77 20 69 73 20 70 72 6f 70 61 ble row is propa
130c0 67 61 74 65 64 20 69 6e 74 6f 20 74 68 65 20 72 gated into the r
130d0 6f 77 20 74 68 61 74 20 68 6f 6c 64 73 20 74 68 ow that holds th
130e0 65 0a 2a 2a 20 66 6f 72 65 69 67 6e 20 6b 65 79 e.** foreign key
130f0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ..**.** The foll
13100 6f 77 69 6e 67 20 73 79 6d 62 6f 6c 69 63 20 76 owing symbolic v
13110 61 6c 75 65 73 20 61 72 65 20 75 73 65 64 20 74 alues are used t
13120 6f 20 72 65 63 6f 72 64 20 77 68 69 63 68 20 74 o record which t
13130 79 70 65 0a 2a 2a 20 6f 66 20 61 63 74 69 6f 6e ype.** of action
13140 20 74 6f 20 74 61 6b 65 2e 0a 2a 2f 0a 23 64 65 to take..*/.#de
13150 66 69 6e 65 20 4f 45 5f 4e 6f 6e 65 20 20 20 20 fine OE_None
13160 20 30 20 20 20 2f 2a 20 54 68 65 72 65 20 69 73 0 /* There is
13170 20 6e 6f 20 63 6f 6e 73 74 72 61 69 6e 74 20 74 no constraint t
13180 6f 20 63 68 65 63 6b 20 2a 2f 0a 23 64 65 66 69 o check */.#defi
13190 6e 65 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b 20 31 ne OE_Rollback 1
131a0 20 20 20 2f 2a 20 46 61 69 6c 20 74 68 65 20 6f /* Fail the o
131b0 70 65 72 61 74 69 6f 6e 20 61 6e 64 20 72 6f 6c peration and rol
131c0 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 61 lback the transa
131d0 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 ction */.#define
131e0 20 4f 45 5f 41 62 6f 72 74 20 20 20 20 32 20 20 OE_Abort 2
131f0 20 2f 2a 20 42 61 63 6b 20 6f 75 74 20 63 68 61 /* Back out cha
13200 6e 67 65 73 20 62 75 74 20 64 6f 20 6e 6f 20 72 nges but do no r
13210 6f 6c 6c 62 61 63 6b 20 74 72 61 6e 73 61 63 74 ollback transact
13220 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ion */.#define O
13230 45 5f 46 61 69 6c 20 20 20 20 20 33 20 20 20 2f E_Fail 3 /
13240 2a 20 53 74 6f 70 20 74 68 65 20 6f 70 65 72 61 * Stop the opera
13250 74 69 6f 6e 20 62 75 74 20 6c 65 61 76 65 20 61 tion but leave a
13260 6c 6c 20 70 72 69 6f 72 20 63 68 61 6e 67 65 73 ll prior changes
13270 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 49 */.#define OE_I
13280 67 6e 6f 72 65 20 20 20 34 20 20 20 2f 2a 20 49 gnore 4 /* I
13290 67 6e 6f 72 65 20 74 68 65 20 65 72 72 6f 72 2e gnore the error.
132a0 20 44 6f 20 6e 6f 74 20 64 6f 20 74 68 65 20 49 Do not do the I
132b0 4e 53 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 NSERT or UPDATE
132c0 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 52 65 */.#define OE_Re
132d0 70 6c 61 63 65 20 20 35 20 20 20 2f 2a 20 44 65 place 5 /* De
132e0 6c 65 74 65 20 65 78 69 73 74 69 6e 67 20 72 65 lete existing re
132f0 63 6f 72 64 2c 20 74 68 65 6e 20 64 6f 20 49 4e cord, then do IN
13300 53 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 2a SERT or UPDATE *
13310 2f 0a 0a 23 64 65 66 69 6e 65 20 4f 45 5f 52 65 /..#define OE_Re
13320 73 74 72 69 63 74 20 36 20 20 20 2f 2a 20 4f 45 strict 6 /* OE
13330 5f 41 62 6f 72 74 20 66 6f 72 20 49 4d 4d 45 44 _Abort for IMMED
13340 49 41 54 45 2c 20 4f 45 5f 52 6f 6c 6c 62 61 63 IATE, OE_Rollbac
13350 6b 20 66 6f 72 20 44 45 46 45 52 52 45 44 20 2a k for DEFERRED *
13360 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 53 65 74 /.#define OE_Set
13370 4e 75 6c 6c 20 20 37 20 20 20 2f 2a 20 53 65 74 Null 7 /* Set
13380 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 the foreign key
13390 20 76 61 6c 75 65 20 74 6f 20 4e 55 4c 4c 20 2a value to NULL *
133a0 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 53 65 74 /.#define OE_Set
133b0 44 66 6c 74 20 20 38 20 20 20 2f 2a 20 53 65 74 Dflt 8 /* Set
133c0 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 the foreign key
133d0 20 76 61 6c 75 65 20 74 6f 20 69 74 73 20 64 65 value to its de
133e0 66 61 75 6c 74 20 2a 2f 0a 23 64 65 66 69 6e 65 fault */.#define
133f0 20 4f 45 5f 43 61 73 63 61 64 65 20 20 39 20 20 OE_Cascade 9
13400 20 2f 2a 20 43 61 73 63 61 64 65 20 74 68 65 20 /* Cascade the
13410 63 68 61 6e 67 65 73 20 2a 2f 0a 0a 23 64 65 66 changes */..#def
13420 69 6e 65 20 4f 45 5f 44 65 66 61 75 6c 74 20 20 ine OE_Default
13430 31 30 20 20 2f 2a 20 44 6f 20 77 68 61 74 65 76 10 /* Do whatev
13440 65 72 20 74 68 65 20 64 65 66 61 75 6c 74 20 61 er the default a
13450 63 74 69 6f 6e 20 69 73 20 2a 2f 0a 0a 0a 2f 2a ction is */.../*
13460 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
13470 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
13480 20 73 74 72 75 63 74 75 72 65 20 69 73 20 70 61 structure is pa
13490 73 73 65 64 20 61 73 20 74 68 65 20 66 69 72 73 ssed as the firs
134a0 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 6f t.** argument to
134b0 20 73 71 6c 69 74 65 33 56 64 62 65 4b 65 79 43 sqlite3VdbeKeyC
134c0 6f 6d 70 61 72 65 20 61 6e 64 20 69 73 20 75 73 ompare and is us
134d0 65 64 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 68 ed to control th
134e0 65 0a 2a 2a 20 63 6f 6d 70 61 72 69 73 6f 6e 20 e.** comparison
134f0 6f 66 20 74 68 65 20 74 77 6f 20 69 6e 64 65 78 of the two index
13500 20 6b 65 79 73 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 keys..**.** Not
13510 65 20 74 68 61 74 20 61 53 6f 72 74 4f 72 64 65 e that aSortOrde
13520 72 5b 5d 20 61 6e 64 20 61 43 6f 6c 6c 5b 5d 20 r[] and aColl[]
13530 68 61 76 65 20 6e 46 69 65 6c 64 2b 31 20 73 6c have nField+1 sl
13540 6f 74 73 2e 20 20 54 68 65 72 65 0a 2a 2a 20 61 ots. There.** a
13550 72 65 20 6e 46 69 65 6c 64 20 73 6c 6f 74 73 20 re nField slots
13560 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 73 20 for the columns
13570 6f 66 20 61 6e 20 69 6e 64 65 78 20 74 68 65 6e of an index then
13580 20 6f 6e 65 20 65 78 74 72 61 20 73 6c 6f 74 0a one extra slot.
13590 2a 2a 20 66 6f 72 20 74 68 65 20 72 6f 77 69 64 ** for the rowid
135a0 20 61 74 20 74 68 65 20 65 6e 64 2e 0a 2a 2f 0a at the end..*/.
135b0 73 74 72 75 63 74 20 4b 65 79 49 6e 66 6f 20 7b struct KeyInfo {
135c0 0a 20 20 75 33 32 20 6e 52 65 66 3b 20 20 20 20 . u32 nRef;
135d0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
135e0 20 6f 66 20 72 65 66 65 72 65 6e 63 65 73 20 74 of references t
135f0 6f 20 74 68 69 73 20 4b 65 79 49 6e 66 6f 20 6f o this KeyInfo o
13600 62 6a 65 63 74 20 2a 2f 0a 20 20 75 38 20 65 6e bject */. u8 en
13610 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f c; /
13620 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 * Text encoding
13630 2d 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c - one of the SQL
13640 49 54 45 5f 55 54 46 2a 20 76 61 6c 75 65 73 20 ITE_UTF* values
13650 2a 2f 0a 20 20 75 31 36 20 6e 46 69 65 6c 64 3b */. u16 nField;
13660 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
13670 65 72 20 6f 66 20 6b 65 79 20 63 6f 6c 75 6d 6e er of key column
13680 73 20 69 6e 20 74 68 65 20 69 6e 64 65 78 20 2a s in the index *
13690 2f 0a 20 20 75 31 36 20 6e 58 46 69 65 6c 64 3b /. u16 nXField;
136a0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
136b0 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 62 65 79 r of columns bey
136c0 6f 6e 64 20 74 68 65 20 6b 65 79 20 63 6f 6c 75 ond the key colu
136d0 6d 6e 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 mns */. sqlite3
136e0 20 2a 64 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 *db; /*
136f0 54 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e The database con
13700 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 nection */. u8
13710 2a 61 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 *aSortOrder;
13720 20 2f 2a 20 53 6f 72 74 20 6f 72 64 65 72 20 66 /* Sort order f
13730 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2e 20 or each column.
13740 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 61 43 */. CollSeq *aC
13750 6f 6c 6c 5b 31 5d 3b 20 20 2f 2a 20 43 6f 6c 6c oll[1]; /* Coll
13760 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 66 ating sequence f
13770 6f 72 20 65 61 63 68 20 74 65 72 6d 20 6f 66 20 or each term of
13780 74 68 65 20 6b 65 79 20 2a 2f 0a 7d 3b 0a 0a 2f the key */.};../
13790 2a 0a 2a 2a 20 54 68 69 73 20 6f 62 6a 65 63 74 *.** This object
137a0 20 68 6f 6c 64 73 20 61 20 72 65 63 6f 72 64 20 holds a record
137b0 77 68 69 63 68 20 68 61 73 20 62 65 65 6e 20 70 which has been p
137c0 61 72 73 65 64 20 6f 75 74 20 69 6e 74 6f 20 69 arsed out into i
137d0 6e 64 69 76 69 64 75 61 6c 0a 2a 2a 20 66 69 65 ndividual.** fie
137e0 6c 64 73 2c 20 66 6f 72 20 74 68 65 20 70 75 72 lds, for the pur
137f0 70 6f 73 65 73 20 6f 66 20 64 6f 69 6e 67 20 61 poses of doing a
13800 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 0a 2a 2a 0a comparison..**.
13810 2a 2a 20 41 20 72 65 63 6f 72 64 20 69 73 20 61 ** A record is a
13820 6e 20 6f 62 6a 65 63 74 20 74 68 61 74 20 63 6f n object that co
13830 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f ntains one or mo
13840 72 65 20 66 69 65 6c 64 73 20 6f 66 20 64 61 74 re fields of dat
13850 61 2e 0a 2a 2a 20 52 65 63 6f 72 64 73 20 61 72 a..** Records ar
13860 65 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 e used to store
13870 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 the content of a
13880 20 74 61 62 6c 65 20 72 6f 77 20 61 6e 64 20 74 table row and t
13890 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 68 65 20 6b o store.** the k
138a0 65 79 20 6f 66 20 61 6e 20 69 6e 64 65 78 2e 20 ey of an index.
138b0 20 41 20 62 6c 6f 62 20 65 6e 63 6f 64 69 6e 67 A blob encoding
138c0 20 6f 66 20 61 20 72 65 63 6f 72 64 20 69 73 20 of a record is
138d0 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 created by.** th
138e0 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 e OP_MakeRecord
138f0 6f 70 63 6f 64 65 20 6f 66 20 74 68 65 20 56 44 opcode of the VD
13900 42 45 20 61 6e 64 20 69 73 20 64 69 73 61 73 73 BE and is disass
13910 65 6d 62 6c 65 64 20 62 79 20 74 68 65 0a 2a 2a embled by the.**
13920 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 70 63 6f 64 OP_Column opcod
13930 65 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 e..**.** An inst
13940 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a ance of this obj
13950 65 63 74 20 73 65 72 76 65 73 20 61 73 20 61 20 ect serves as a
13960 22 6b 65 79 22 20 66 6f 72 20 64 6f 69 6e 67 20 "key" for doing
13970 61 20 73 65 61 72 63 68 20 6f 6e 0a 2a 2a 20 61 a search on.** a
13980 6e 20 69 6e 64 65 78 20 62 2b 74 72 65 65 2e 20 n index b+tree.
13990 54 68 65 20 67 6f 61 6c 20 6f 66 20 74 68 65 20 The goal of the
139a0 73 65 61 72 63 68 20 69 73 20 74 6f 20 66 69 6e search is to fin
139b0 64 20 74 68 65 20 65 6e 74 72 79 20 74 68 61 74 d the entry that
139c0 0a 2a 2a 20 69 73 20 63 6c 6f 73 65 64 20 74 6f .** is closed to
139d0 20 74 68 65 20 6b 65 79 20 64 65 73 63 72 69 62 the key describ
139e0 65 64 20 62 79 20 74 68 69 73 20 6f 62 6a 65 63 ed by this objec
139f0 74 2e 20 20 54 68 69 73 20 6f 62 6a 65 63 74 20 t. This object
13a00 6d 69 67 68 74 20 68 6f 6c 64 0a 2a 2a 20 6a 75 might hold.** ju
13a10 73 74 20 61 20 70 72 65 66 69 78 20 6f 66 20 74 st a prefix of t
13a20 68 65 20 6b 65 79 2e 20 20 54 68 65 20 6e 75 6d he key. The num
13a30 62 65 72 20 6f 66 20 66 69 65 6c 64 73 20 69 73 ber of fields is
13a40 20 67 69 76 65 6e 20 62 79 0a 2a 2a 20 70 4b 65 given by.** pKe
13a50 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 2e 0a 2a yInfo->nField..*
13a60 2a 0a 2a 2a 20 54 68 65 20 72 31 20 61 6e 64 20 *.** The r1 and
13a70 72 32 20 66 69 65 6c 64 73 20 61 72 65 20 74 68 r2 fields are th
13a80 65 20 76 61 6c 75 65 73 20 74 6f 20 72 65 74 75 e values to retu
13a90 72 6e 20 69 66 20 74 68 69 73 20 6b 65 79 20 69 rn if this key i
13aa0 73 20 6c 65 73 73 20 74 68 61 6e 0a 2a 2a 20 6f s less than.** o
13ab0 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 61 r greater than a
13ac0 20 6b 65 79 20 69 6e 20 74 68 65 20 62 74 72 65 key in the btre
13ad0 65 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e e, respectively.
13ae0 20 20 54 68 65 73 65 20 61 72 65 20 6e 6f 72 6d These are norm
13af0 61 6c 6c 79 0a 2a 2a 20 2d 31 20 61 6e 64 20 2b ally.** -1 and +
13b00 31 20 72 65 73 70 65 63 74 69 76 65 6c 79 2c 20 1 respectively,
13b10 62 75 74 20 6d 69 67 68 74 20 62 65 20 69 6e 76 but might be inv
13b20 65 72 74 65 64 20 74 6f 20 2b 31 20 61 6e 64 20 erted to +1 and
13b30 2d 31 20 69 66 20 74 68 65 20 62 2d 74 72 65 65 -1 if the b-tree
13b40 0a 2a 2a 20 69 73 20 69 6e 20 44 45 53 43 20 6f .** is in DESC o
13b50 72 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 rder..**.** The
13b60 6b 65 79 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 key comparison f
13b70 75 6e 63 74 69 6f 6e 73 20 61 63 74 75 61 6c 6c unctions actuall
13b80 79 20 72 65 74 75 72 6e 20 64 65 66 61 75 6c 74 y return default
13b90 5f 72 63 20 77 68 65 6e 20 74 68 65 79 20 66 69 _rc when they fi
13ba0 6e 64 0a 2a 2a 20 61 6e 20 65 71 75 61 6c 73 20 nd.** an equals
13bb0 63 6f 6d 70 61 72 69 73 6f 6e 2e 20 20 64 65 66 comparison. def
13bc0 61 75 6c 74 5f 72 63 20 63 61 6e 20 62 65 20 2d ault_rc can be -
13bd0 31 2c 20 30 2c 20 6f 72 20 2b 31 2e 20 20 49 66 1, 0, or +1. If
13be0 20 74 68 65 72 65 20 61 72 65 0a 2a 2a 20 6d 75 there are.** mu
13bf0 6c 74 69 70 6c 65 20 65 6e 74 72 69 65 73 20 69 ltiple entries i
13c00 6e 20 74 68 65 20 62 2d 74 72 65 65 20 77 69 74 n the b-tree wit
13c10 68 20 74 68 65 20 73 61 6d 65 20 6b 65 79 20 28 h the same key (
13c20 77 68 65 6e 20 6f 6e 6c 79 20 6c 6f 6f 6b 69 6e when only lookin
13c30 67 0a 2a 2a 20 61 74 20 74 68 65 20 66 69 72 73 g.** at the firs
13c40 74 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 t pKeyInfo->nFie
13c50 6c 64 73 2c 29 20 74 68 65 6e 20 64 65 66 61 75 lds,) then defau
13c60 6c 74 5f 72 63 20 63 61 6e 20 62 65 20 73 65 74 lt_rc can be set
13c70 20 74 6f 20 2d 31 20 74 6f 0a 2a 2a 20 63 61 75 to -1 to.** cau
13c80 73 65 20 74 68 65 20 73 65 61 72 63 68 20 74 6f se the search to
13c90 20 66 69 6e 64 20 74 68 65 20 6c 61 73 74 20 6d find the last m
13ca0 61 74 63 68 2c 20 6f 72 20 2b 31 20 74 6f 20 63 atch, or +1 to c
13cb0 61 75 73 65 20 74 68 65 20 73 65 61 72 63 68 20 ause the search
13cc0 74 6f 0a 2a 2a 20 66 69 6e 64 20 74 68 65 20 66 to.** find the f
13cd0 69 72 73 74 20 6d 61 74 63 68 2e 0a 2a 2a 0a 2a irst match..**.*
13ce0 2a 20 54 68 65 20 6b 65 79 20 63 6f 6d 70 61 72 * The key compar
13cf0 69 73 6f 6e 20 66 75 6e 63 74 69 6f 6e 73 20 77 ison functions w
13d00 69 6c 6c 20 73 65 74 20 65 71 53 65 65 6e 20 74 ill set eqSeen t
13d10 6f 20 74 72 75 65 20 69 66 20 74 68 65 79 20 65 o true if they e
13d20 76 65 72 0a 2a 2a 20 67 65 74 20 61 6e 64 20 65 ver.** get and e
13d30 71 75 61 6c 20 72 65 73 75 6c 74 73 20 77 68 65 qual results whe
13d40 6e 20 63 6f 6d 70 61 72 69 6e 67 20 74 68 69 73 n comparing this
13d50 20 73 74 72 75 63 74 75 72 65 20 74 6f 20 61 20 structure to a
13d60 62 2d 74 72 65 65 20 72 65 63 6f 72 64 2e 0a 2a b-tree record..*
13d70 2a 20 57 68 65 6e 20 64 65 66 61 75 6c 74 5f 72 * When default_r
13d80 63 21 3d 30 2c 20 74 68 65 20 73 65 61 72 63 68 c!=0, the search
13d90 20 6d 69 67 68 74 20 65 6e 64 20 75 70 20 6f 6e might end up on
13da0 20 74 68 65 20 72 65 63 6f 72 64 20 69 6d 6d 65 the record imme
13db0 64 69 61 74 65 6c 79 0a 2a 2a 20 62 65 66 6f 72 diately.** befor
13dc0 65 20 74 68 65 20 66 69 72 73 74 20 6d 61 74 63 e the first matc
13dd0 68 20 6f 72 20 69 6d 6d 65 64 69 61 74 65 6c 79 h or immediately
13de0 20 61 66 74 65 72 20 74 68 65 20 6c 61 73 74 20 after the last
13df0 6d 61 74 63 68 2e 20 20 54 68 65 0a 2a 2a 20 65 match. The.** e
13e00 71 53 65 65 6e 20 66 69 65 6c 64 20 77 69 6c 6c qSeen field will
13e10 20 69 6e 64 69 63 61 74 65 20 77 68 65 74 68 65 indicate whethe
13e20 72 20 6f 72 20 6e 6f 74 20 61 6e 20 65 78 61 63 r or not an exac
13e30 74 20 6d 61 74 63 68 20 65 78 69 73 74 73 20 69 t match exists i
13e40 6e 20 74 68 65 0a 2a 2a 20 62 2d 74 72 65 65 2e n the.** b-tree.
13e50 0a 2a 2f 0a 73 74 72 75 63 74 20 55 6e 70 61 63 .*/.struct Unpac
13e60 6b 65 64 52 65 63 6f 72 64 20 7b 0a 20 20 4b 65 kedRecord {. Ke
13e70 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b yInfo *pKeyInfo;
13e80 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6f 6e 20 61 /* Collation a
13e90 6e 64 20 73 6f 72 74 2d 6f 72 64 65 72 20 69 6e nd sort-order in
13ea0 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 20 20 4d formation */. M
13eb0 65 6d 20 2a 61 4d 65 6d 3b 20 20 20 20 20 20 20 em *aMem;
13ec0 20 20 20 2f 2a 20 56 61 6c 75 65 73 20 2a 2f 0a /* Values */.
13ed0 20 20 75 31 36 20 6e 46 69 65 6c 64 3b 20 20 20 u16 nField;
13ee0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
13ef0 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 70 of entries in ap
13f00 4d 65 6d 5b 5d 20 2a 2f 0a 20 20 69 38 20 64 65 Mem[] */. i8 de
13f10 66 61 75 6c 74 5f 72 63 3b 20 20 20 20 20 20 2f fault_rc; /
13f20 2a 20 43 6f 6d 70 61 72 69 73 6f 6e 20 72 65 73 * Comparison res
13f30 75 6c 74 20 69 66 20 6b 65 79 73 20 61 72 65 20 ult if keys are
13f40 65 71 75 61 6c 20 2a 2f 0a 20 20 75 38 20 65 72 equal */. u8 er
13f50 72 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 2f rCode; /
13f60 2a 20 45 72 72 6f 72 20 64 65 74 65 63 74 65 64 * Error detected
13f70 20 62 79 20 78 52 65 63 6f 72 64 43 6f 6d 70 61 by xRecordCompa
13f80 72 65 20 28 43 4f 52 52 55 50 54 20 6f 72 20 4e re (CORRUPT or N
13f90 4f 4d 45 4d 29 20 2a 2f 0a 20 20 69 38 20 72 31 OMEM) */. i8 r1
13fa0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
13fb0 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72 * Value to retur
13fc0 6e 20 69 66 20 28 6c 68 73 20 3e 20 72 68 73 29 n if (lhs > rhs)
13fd0 20 2a 2f 0a 20 20 69 38 20 72 32 3b 20 20 20 20 */. i8 r2;
13fe0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c /* Val
13ff0 75 65 20 74 6f 20 72 65 74 75 72 6e 20 69 66 20 ue to return if
14000 28 72 68 73 20 3c 20 6c 68 73 29 20 2a 2f 0a 20 (rhs < lhs) */.
14010 20 75 38 20 65 71 53 65 65 6e 3b 20 20 20 20 20 u8 eqSeen;
14020 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 /* True if
14030 61 6e 20 65 71 75 61 6c 69 74 79 20 63 6f 6d 70 an equality comp
14040 61 72 69 73 6f 6e 20 68 61 73 20 62 65 65 6e 20 arison has been
14050 73 65 65 6e 20 2a 2f 0a 7d 3b 0a 0a 0a 2f 2a 0a seen */.};.../*.
14060 2a 2a 20 45 61 63 68 20 53 51 4c 20 69 6e 64 65 ** Each SQL inde
14070 78 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 64 x is represented
14080 20 69 6e 20 6d 65 6d 6f 72 79 20 62 79 20 61 6e in memory by an
14090 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 .** instance of
140a0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
140b0 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 ructure..**.** T
140c0 68 65 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 he columns of th
140d0 65 20 74 61 62 6c 65 20 74 68 61 74 20 61 72 65 e table that are
140e0 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 20 61 to be indexed a
140f0 72 65 20 64 65 73 63 72 69 62 65 64 0a 2a 2a 20 re described.**
14100 62 79 20 74 68 65 20 61 69 43 6f 6c 75 6d 6e 5b by the aiColumn[
14110 5d 20 66 69 65 6c 64 20 6f 66 20 74 68 69 73 20 ] field of this
14120 73 74 72 75 63 74 75 72 65 2e 20 20 46 6f 72 20 structure. For
14130 65 78 61 6d 70 6c 65 2c 20 73 75 70 70 6f 73 65 example, suppose
14140 0a 2a 2a 20 77 65 20 68 61 76 65 20 74 68 65 20 .** we have the
14150 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 following table
14160 61 6e 64 20 69 6e 64 65 78 3a 0a 2a 2a 0a 2a 2a and index:.**.**
14170 20 20 20 20 20 43 52 45 41 54 45 20 54 41 42 4c CREATE TABL
14180 45 20 45 78 31 28 63 31 20 69 6e 74 2c 20 63 32 E Ex1(c1 int, c2
14190 20 69 6e 74 2c 20 63 33 20 74 65 78 74 29 3b 0a int, c3 text);.
141a0 2a 2a 20 20 20 20 20 43 52 45 41 54 45 20 49 4e ** CREATE IN
141b0 44 45 58 20 45 78 32 20 4f 4e 20 45 78 31 28 63 DEX Ex2 ON Ex1(c
141c0 33 2c 63 31 29 3b 0a 2a 2a 0a 2a 2a 20 49 6e 20 3,c1);.**.** In
141d0 74 68 65 20 54 61 62 6c 65 20 73 74 72 75 63 74 the Table struct
141e0 75 72 65 20 64 65 73 63 72 69 62 69 6e 67 20 45 ure describing E
141f0 78 31 2c 20 6e 43 6f 6c 3d 3d 33 20 62 65 63 61 x1, nCol==3 beca
14200 75 73 65 20 74 68 65 72 65 20 61 72 65 0a 2a 2a use there are.**
14210 20 74 68 72 65 65 20 63 6f 6c 75 6d 6e 73 20 69 three columns i
14220 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 20 49 6e n the table. In
14230 20 74 68 65 20 49 6e 64 65 78 20 73 74 72 75 63 the Index struc
14240 74 75 72 65 20 64 65 73 63 72 69 62 69 6e 67 0a ture describing.
14250 2a 2a 20 45 78 32 2c 20 6e 43 6f 6c 75 6d 6e 3d ** Ex2, nColumn=
14260 3d 32 20 73 69 6e 63 65 20 32 20 6f 66 20 74 68 =2 since 2 of th
14270 65 20 33 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 45 e 3 columns of E
14280 78 31 20 61 72 65 20 69 6e 64 65 78 65 64 2e 0a x1 are indexed..
14290 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 6f 66 20 ** The value of
142a0 61 69 43 6f 6c 75 6d 6e 20 69 73 20 7b 32 2c 20 aiColumn is {2,
142b0 30 7d 2e 20 20 61 69 43 6f 6c 75 6d 6e 5b 30 5d 0}. aiColumn[0]
142c0 3d 3d 32 20 62 65 63 61 75 73 65 20 74 68 65 0a ==2 because the.
142d0 2a 2a 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e 20 ** first column
142e0 74 6f 20 62 65 20 69 6e 64 65 78 65 64 20 28 63 to be indexed (c
142f0 33 29 20 68 61 73 20 61 6e 20 69 6e 64 65 78 20 3) has an index
14300 6f 66 20 32 20 69 6e 20 45 78 31 2e 61 43 6f 6c of 2 in Ex1.aCol
14310 5b 5d 2e 0a 2a 2a 20 54 68 65 20 73 65 63 6f 6e []..** The secon
14320 64 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 69 d column to be i
14330 6e 64 65 78 65 64 20 28 63 31 29 20 68 61 73 20 ndexed (c1) has
14340 61 6e 20 69 6e 64 65 78 20 6f 66 20 30 20 69 6e an index of 0 in
14350 0a 2a 2a 20 45 78 31 2e 61 43 6f 6c 5b 5d 2c 20 .** Ex1.aCol[],
14360 68 65 6e 63 65 20 45 78 32 2e 61 69 43 6f 6c 75 hence Ex2.aiColu
14370 6d 6e 5b 31 5d 3d 3d 30 2e 0a 2a 2a 0a 2a 2a 20 mn[1]==0..**.**
14380 54 68 65 20 49 6e 64 65 78 2e 6f 6e 45 72 72 6f The Index.onErro
14390 72 20 66 69 65 6c 64 20 64 65 74 65 72 6d 69 6e r field determin
143a0 65 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f es whether or no
143b0 74 20 74 68 65 20 69 6e 64 65 78 65 64 20 63 6f t the indexed co
143c0 6c 75 6d 6e 73 0a 2a 2a 20 6d 75 73 74 20 62 65 lumns.** must be
143d0 20 75 6e 69 71 75 65 20 61 6e 64 20 77 68 61 74 unique and what
143e0 20 74 6f 20 64 6f 20 69 66 20 74 68 65 79 20 61 to do if they a
143f0 72 65 20 6e 6f 74 2e 20 20 57 68 65 6e 20 49 6e re not. When In
14400 64 65 78 2e 6f 6e 45 72 72 6f 72 3d 4f 45 5f 4e dex.onError=OE_N
14410 6f 6e 65 2c 0a 2a 2a 20 69 74 20 6d 65 61 6e 73 one,.** it means
14420 20 74 68 69 73 20 69 73 20 6e 6f 74 20 61 20 75 this is not a u
14430 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 20 4f 74 nique index. Ot
14440 68 65 72 77 69 73 65 20 69 74 20 69 73 20 61 20 herwise it is a
14450 75 6e 69 71 75 65 20 69 6e 64 65 78 0a 2a 2a 20 unique index.**
14460 61 6e 64 20 74 68 65 20 76 61 6c 75 65 20 6f 66 and the value of
14470 20 49 6e 64 65 78 2e 6f 6e 45 72 72 6f 72 20 69 Index.onError i
14480 6e 64 69 63 61 74 65 20 74 68 65 20 77 68 69 63 ndicate the whic
14490 68 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c h conflict resol
144a0 75 74 69 6f 6e 0a 2a 2a 20 61 6c 67 6f 72 69 74 ution.** algorit
144b0 68 6d 20 74 6f 20 65 6d 70 6c 6f 79 20 77 68 65 hm to employ whe
144c0 6e 65 76 65 72 20 61 6e 20 61 74 74 65 6d 70 74 never an attempt
144d0 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e 73 65 is made to inse
144e0 72 74 20 61 20 6e 6f 6e 2d 75 6e 69 71 75 65 0a rt a non-unique.
144f0 2a 2a 20 65 6c 65 6d 65 6e 74 2e 0a 2a 2a 0a 2a ** element..**.*
14500 2a 20 57 68 69 6c 65 20 70 61 72 73 69 6e 67 20 * While parsing
14510 61 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 6f a CREATE TABLE o
14520 72 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 73 r CREATE INDEX s
14530 74 61 74 65 6d 65 6e 74 20 69 6e 20 6f 72 64 65 tatement in orde
14540 72 20 74 6f 0a 2a 2a 20 67 65 6e 65 72 61 74 65 r to.** generate
14550 20 56 44 42 45 20 63 6f 64 65 20 28 61 73 20 6f VDBE code (as o
14560 70 70 6f 73 65 64 20 74 6f 20 70 61 72 73 69 6e pposed to parsin
14570 67 20 6f 6e 65 20 72 65 61 64 20 66 72 6f 6d 20 g one read from
14580 61 6e 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 an sqlite_master
14590 0a 2a 2a 20 74 61 62 6c 65 20 61 73 20 70 61 72 .** table as par
145a0 74 20 6f 66 20 70 61 72 73 69 6e 67 20 61 6e 20 t of parsing an
145b0 65 78 69 73 74 69 6e 67 20 64 61 74 61 62 61 73 existing databas
145c0 65 20 73 63 68 65 6d 61 29 2c 20 74 72 61 6e 73 e schema), trans
145d0 69 65 6e 74 20 69 6e 73 74 61 6e 63 65 73 0a 2a ient instances.*
145e0 2a 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 * of this struct
145f0 75 72 65 20 6d 61 79 20 62 65 20 63 72 65 61 74 ure may be creat
14600 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 ed. In this case
14610 20 74 68 65 20 49 6e 64 65 78 2e 74 6e 75 6d 20 the Index.tnum
14620 76 61 72 69 61 62 6c 65 20 69 73 0a 2a 2a 20 75 variable is.** u
14630 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 sed to store the
14640 20 61 64 64 72 65 73 73 20 6f 66 20 61 20 56 44 address of a VD
14650 42 45 20 69 6e 73 74 72 75 63 74 69 6f 6e 2c 20 BE instruction,
14660 6e 6f 74 20 61 20 64 61 74 61 62 61 73 65 20 70 not a database p
14670 61 67 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 28 69 age.** number (i
14680 74 20 63 61 6e 6e 6f 74 20 2d 20 74 68 65 20 64 t cannot - the d
14690 61 74 61 62 61 73 65 20 70 61 67 65 20 69 73 20 atabase page is
146a0 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 64 20 75 6e not allocated un
146b0 74 69 6c 20 74 68 65 20 56 44 42 45 0a 2a 2a 20 til the VDBE.**
146c0 70 72 6f 67 72 61 6d 20 69 73 20 65 78 65 63 75 program is execu
146d0 74 65 64 29 2e 20 53 65 65 20 63 6f 6e 76 65 72 ted). See conver
146e0 74 54 6f 57 69 74 68 6f 75 74 52 6f 77 69 64 54 tToWithoutRowidT
146f0 61 62 6c 65 28 29 20 66 6f 72 20 64 65 74 61 69 able() for detai
14700 6c 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e ls..*/.struct In
14710 64 65 78 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e dex {. char *zN
14720 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ame;
14730 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 73 /* Name of this
14740 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 31 36 20 index */. i16
14750 2a 61 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 *aiColumn;
14760 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 63 6f /* Which co
14770 6c 75 6d 6e 73 20 61 72 65 20 75 73 65 64 20 62 lumns are used b
14780 79 20 74 68 69 73 20 69 6e 64 65 78 2e 20 20 31 y this index. 1
14790 73 74 20 69 73 20 30 20 2a 2f 0a 20 20 4c 6f 67 st is 0 */. Log
147a0 45 73 74 20 2a 61 69 52 6f 77 4c 6f 67 45 73 74 Est *aiRowLogEst
147b0 3b 20 20 20 20 20 2f 2a 20 46 72 6f 6d 20 41 4e ; /* From AN
147c0 41 4c 59 5a 45 3a 20 45 73 74 2e 20 72 6f 77 73 ALYZE: Est. rows
147d0 20 73 65 6c 65 63 74 65 64 20 62 79 20 65 61 63 selected by eac
147e0 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 54 61 h column */. Ta
147f0 62 6c 65 20 2a 70 54 61 62 6c 65 3b 20 20 20 20 ble *pTable;
14800 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 /* The SQ
14810 4c 20 74 61 62 6c 65 20 62 65 69 6e 67 20 69 6e L table being in
14820 64 65 78 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 dexed */. char
14830 2a 7a 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 20 *zColAff;
14840 20 20 20 20 2f 2a 20 53 74 72 69 6e 67 20 64 65 /* String de
14850 66 69 6e 69 6e 67 20 74 68 65 20 61 66 66 69 6e fining the affin
14860 69 74 79 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 ity of each colu
14870 6d 6e 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 mn */. Index *p
14880 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 Next;
14890 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 69 6e 64 /* The next ind
148a0 65 78 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 ex associated wi
148b0 74 68 20 74 68 65 20 73 61 6d 65 20 74 61 62 6c th the same tabl
148c0 65 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 e */. Schema *p
148d0 53 63 68 65 6d 61 3b 20 20 20 20 20 20 20 20 20 Schema;
148e0 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 69 /* Schema contai
148f0 6e 69 6e 67 20 74 68 69 73 20 69 6e 64 65 78 20 ning this index
14900 2a 2f 0a 20 20 75 38 20 2a 61 53 6f 72 74 4f 72 */. u8 *aSortOr
14910 64 65 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a der; /*
14920 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e for each column
14930 3a 20 54 72 75 65 3d 3d 44 45 53 43 2c 20 46 61 : True==DESC, Fa
14940 6c 73 65 3d 3d 41 53 43 20 2a 2f 0a 20 20 63 6f lse==ASC */. co
14950 6e 73 74 20 63 68 61 72 20 2a 2a 61 7a 43 6f 6c nst char **azCol
14960 6c 3b 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 l; /* Array
14970 6f 66 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 of collation seq
14980 75 65 6e 63 65 20 6e 61 6d 65 73 20 66 6f 72 20 uence names for
14990 69 6e 64 65 78 20 2a 2f 0a 20 20 45 78 70 72 20 index */. Expr
149a0 2a 70 50 61 72 74 49 64 78 57 68 65 72 65 3b 20 *pPartIdxWhere;
149b0 20 20 20 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 /* WHERE cla
149c0 75 73 65 20 66 6f 72 20 70 61 72 74 69 61 6c 20 use for partial
149d0 69 6e 64 69 63 65 73 20 2a 2f 0a 20 20 45 78 70 indices */. Exp
149e0 72 4c 69 73 74 20 2a 61 43 6f 6c 45 78 70 72 3b rList *aColExpr;
149f0 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 /* Column
14a00 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
14a10 20 69 6e 74 20 74 6e 75 6d 3b 20 20 20 20 20 20 int tnum;
14a20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 42 20 /* DB
14a30 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 Page containing
14a40 72 6f 6f 74 20 6f 66 20 74 68 69 73 20 69 6e 64 root of this ind
14a50 65 78 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 73 ex */. LogEst s
14a60 7a 49 64 78 52 6f 77 3b 20 20 20 20 20 20 20 20 zIdxRow;
14a70 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 61 76 /* Estimated av
14a80 65 72 61 67 65 20 72 6f 77 20 73 69 7a 65 20 69 erage row size i
14a90 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 31 36 n bytes */. u16
14aa0 20 6e 4b 65 79 43 6f 6c 3b 20 20 20 20 20 20 20 nKeyCol;
14ab0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
14ac0 6f 66 20 63 6f 6c 75 6d 6e 73 20 66 6f 72 6d 69 of columns formi
14ad0 6e 67 20 74 68 65 20 6b 65 79 20 2a 2f 0a 20 20 ng the key */.
14ae0 75 31 36 20 6e 43 6f 6c 75 6d 6e 3b 20 20 20 20 u16 nColumn;
14af0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
14b00 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 73 74 er of columns st
14b10 6f 72 65 64 20 69 6e 20 74 68 65 20 69 6e 64 65 ored in the inde
14b20 78 20 2a 2f 0a 20 20 75 38 20 6f 6e 45 72 72 6f x */. u8 onErro
14b30 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
14b40 2f 2a 20 4f 45 5f 41 62 6f 72 74 2c 20 4f 45 5f /* OE_Abort, OE_
14b50 49 67 6e 6f 72 65 2c 20 4f 45 5f 52 65 70 6c 61 Ignore, OE_Repla
14b60 63 65 2c 20 6f 72 20 4f 45 5f 4e 6f 6e 65 20 2a ce, or OE_None *
14b70 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 64 78 /. unsigned idx
14b80 54 79 70 65 3a 32 3b 20 20 20 20 20 20 2f 2a 20 Type:2; /*
14b90 31 3d 3d 55 4e 49 51 55 45 2c 20 32 3d 3d 50 52 1==UNIQUE, 2==PR
14ba0 49 4d 41 52 59 20 4b 45 59 2c 20 30 3d 3d 43 52 IMARY KEY, 0==CR
14bb0 45 41 54 45 20 49 4e 44 45 58 20 2a 2f 0a 20 20 EATE INDEX */.
14bc0 75 6e 73 69 67 6e 65 64 20 62 55 6e 6f 72 64 65 unsigned bUnorde
14bd0 72 65 64 3a 31 3b 20 20 20 2f 2a 20 55 73 65 20 red:1; /* Use
14be0 74 68 69 73 20 69 6e 64 65 78 20 66 6f 72 20 3d this index for =
14bf0 3d 20 6f 72 20 49 4e 20 71 75 65 72 69 65 73 20 = or IN queries
14c00 6f 6e 6c 79 20 2a 2f 0a 20 20 75 6e 73 69 67 6e only */. unsign
14c10 65 64 20 75 6e 69 71 4e 6f 74 4e 75 6c 6c 3a 31 ed uniqNotNull:1
14c20 3b 20 20 2f 2a 20 54 72 75 65 20 69 66 20 55 4e ; /* True if UN
14c30 49 51 55 45 20 61 6e 64 20 4e 4f 54 20 4e 55 4c IQUE and NOT NUL
14c40 4c 20 66 6f 72 20 61 6c 6c 20 63 6f 6c 75 6d 6e L for all column
14c50 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 s */. unsigned
14c60 69 73 52 65 73 69 7a 65 64 3a 31 3b 20 20 20 20 isResized:1;
14c70 2f 2a 20 54 72 75 65 20 69 66 20 72 65 73 69 7a /* True if resiz
14c80 65 49 6e 64 65 78 4f 62 6a 65 63 74 28 29 20 68 eIndexObject() h
14c90 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 20 2a as been called *
14ca0 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 73 43 /. unsigned isC
14cb0 6f 76 65 72 69 6e 67 3a 31 3b 20 20 20 2f 2a 20 overing:1; /*
14cc0 54 72 75 65 20 69 66 20 74 68 69 73 20 69 73 20 True if this is
14cd0 61 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 a covering index
14ce0 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 6e */. unsigned n
14cf0 6f 53 6b 69 70 53 63 61 6e 3a 31 3b 20 20 20 2f oSkipScan:1; /
14d00 2a 20 44 6f 20 6e 6f 74 20 74 72 79 20 74 6f 20 * Do not try to
14d10 75 73 65 20 73 6b 69 70 2d 73 63 61 6e 20 69 66 use skip-scan if
14d20 20 74 72 75 65 20 2a 2f 0a 23 69 66 64 65 66 20 true */.#ifdef
14d30 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 SQLITE_ENABLE_ST
14d40 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 AT3_OR_STAT4. i
14d50 6e 74 20 6e 53 61 6d 70 6c 65 3b 20 20 20 20 20 nt nSample;
14d60 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
14d70 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e r of elements in
14d80 20 61 53 61 6d 70 6c 65 5b 5d 20 2a 2f 0a 20 20 aSample[] */.
14d90 69 6e 74 20 6e 53 61 6d 70 6c 65 43 6f 6c 3b 20 int nSampleCol;
14da0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
14db0 20 6f 66 20 49 6e 64 65 78 53 61 6d 70 6c 65 2e of IndexSample.
14dc0 61 6e 45 71 5b 5d 20 61 6e 64 20 73 6f 20 6f 6e anEq[] and so on
14dd0 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 */. tRowcnt *a
14de0 41 76 67 45 71 3b 20 20 20 20 20 20 20 20 20 2f AvgEq; /
14df0 2a 20 41 76 65 72 61 67 65 20 6e 45 71 20 76 61 * Average nEq va
14e00 6c 75 65 73 20 66 6f 72 20 6b 65 79 73 20 6e 6f lues for keys no
14e10 74 20 69 6e 20 61 53 61 6d 70 6c 65 20 2a 2f 0a t in aSample */.
14e20 20 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 2a 61 IndexSample *a
14e30 53 61 6d 70 6c 65 3b 20 20 20 20 2f 2a 20 53 61 Sample; /* Sa
14e40 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 6c 65 66 mples of the lef
14e50 74 2d 6d 6f 73 74 20 6b 65 79 20 2a 2f 0a 20 20 t-most key */.
14e60 74 52 6f 77 63 6e 74 20 2a 61 69 52 6f 77 45 73 tRowcnt *aiRowEs
14e70 74 3b 20 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d t; /* Non-
14e80 6c 6f 67 61 72 69 74 68 6d 69 63 20 73 74 61 74 logarithmic stat
14e90 31 20 64 61 74 61 20 66 6f 72 20 74 68 69 73 20 1 data for this
14ea0 69 6e 64 65 78 20 2a 2f 0a 20 20 74 52 6f 77 63 index */. tRowc
14eb0 6e 74 20 6e 52 6f 77 45 73 74 30 3b 20 20 20 20 nt nRowEst0;
14ec0 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6c 6f 67 61 72 /* Non-logar
14ed0 69 74 68 6d 69 63 20 6e 75 6d 62 65 72 20 6f 66 ithmic number of
14ee0 20 72 6f 77 73 20 69 6e 20 74 68 65 20 69 6e 64 rows in the ind
14ef0 65 78 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a ex */.#endif.};.
14f00 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 ./*.** Allowed v
14f10 61 6c 75 65 73 20 66 6f 72 20 49 6e 64 65 78 2e alues for Index.
14f20 69 64 78 54 79 70 65 0a 2a 2f 0a 23 64 65 66 69 idxType.*/.#defi
14f30 6e 65 20 53 51 4c 49 54 45 5f 49 44 58 54 59 50 ne SQLITE_IDXTYP
14f40 45 5f 41 50 50 44 45 46 20 20 20 20 20 20 30 20 E_APPDEF 0
14f50 20 20 2f 2a 20 43 72 65 61 74 65 64 20 75 73 69 /* Created usi
14f60 6e 67 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 ng CREATE INDEX
14f70 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
14f80 45 5f 49 44 58 54 59 50 45 5f 55 4e 49 51 55 45 E_IDXTYPE_UNIQUE
14f90 20 20 20 20 20 20 31 20 20 20 2f 2a 20 49 6d 70 1 /* Imp
14fa0 6c 65 6d 65 6e 74 73 20 61 20 55 4e 49 51 55 45 lements a UNIQUE
14fb0 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 constraint */.#
14fc0 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 44 define SQLITE_ID
14fd0 58 54 59 50 45 5f 50 52 49 4d 41 52 59 4b 45 59 XTYPE_PRIMARYKEY
14fe0 20 20 32 20 20 20 2f 2a 20 49 73 20 74 68 65 20 2 /* Is the
14ff0 50 52 49 4d 41 52 59 20 4b 45 59 20 66 6f 72 20 PRIMARY KEY for
15000 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 0a 2f 2a the table */../*
15010 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 20 Return true if
15020 69 6e 64 65 78 20 58 20 69 73 20 61 20 50 52 49 index X is a PRI
15030 4d 41 52 59 20 4b 45 59 20 69 6e 64 65 78 20 2a MARY KEY index *
15040 2f 0a 23 64 65 66 69 6e 65 20 49 73 50 72 69 6d /.#define IsPrim
15050 61 72 79 4b 65 79 49 6e 64 65 78 28 58 29 20 20 aryKeyIndex(X)
15060 28 28 58 29 2d 3e 69 64 78 54 79 70 65 3d 3d 53 ((X)->idxType==S
15070 51 4c 49 54 45 5f 49 44 58 54 59 50 45 5f 50 52 QLITE_IDXTYPE_PR
15080 49 4d 41 52 59 4b 45 59 29 0a 0a 2f 2a 20 52 65 IMARYKEY)../* Re
15090 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 6e 64 turn true if ind
150a0 65 78 20 58 20 69 73 20 61 20 55 4e 49 51 55 45 ex X is a UNIQUE
150b0 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e index */.#defin
150c0 65 20 49 73 55 6e 69 71 75 65 49 6e 64 65 78 28 e IsUniqueIndex(
150d0 58 29 20 20 20 20 20 20 28 28 58 29 2d 3e 6f 6e X) ((X)->on
150e0 45 72 72 6f 72 21 3d 4f 45 5f 4e 6f 6e 65 29 0a Error!=OE_None).
150f0 0a 2f 2a 20 54 68 65 20 49 6e 64 65 78 2e 61 69 ./* The Index.ai
15100 43 6f 6c 75 6d 6e 5b 5d 20 76 61 6c 75 65 73 20 Column[] values
15110 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 70 6f 73 are normally pos
15120 69 74 69 76 65 20 69 6e 74 65 67 65 72 2e 20 20 itive integer.
15130 42 75 74 0a 2a 2a 20 74 68 65 72 65 20 61 72 65 But.** there are
15140 20 73 6f 6d 65 20 6e 65 67 61 74 69 76 65 20 76 some negative v
15150 61 6c 75 65 73 20 74 68 61 74 20 68 61 76 65 20 alues that have
15160 73 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e 67 3a special meaning:
15170 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e 5f 52 .*/.#define XN_R
15180 4f 57 49 44 20 20 20 20 20 28 2d 31 29 20 20 20 OWID (-1)
15190 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f 6c /* Indexed col
151a0 75 6d 6e 20 69 73 20 74 68 65 20 72 6f 77 69 64 umn is the rowid
151b0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 58 4e 5f 45 */.#define XN_E
151c0 58 50 52 20 20 20 20 20 20 28 2d 32 29 20 20 20 XPR (-2)
151d0 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f 6c /* Indexed col
151e0 75 6d 6e 20 69 73 20 61 6e 20 65 78 70 72 65 73 umn is an expres
151f0 73 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 sion */../*.** E
15200 61 63 68 20 73 61 6d 70 6c 65 20 73 74 6f 72 65 ach sample store
15210 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 5f d in the sqlite_
15220 73 74 61 74 33 20 74 61 62 6c 65 20 69 73 20 72 stat3 table is r
15230 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 epresented in me
15240 6d 6f 72 79 0a 2a 2a 20 75 73 69 6e 67 20 61 20 mory.** using a
15250 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 69 structure of thi
15260 73 20 74 79 70 65 2e 20 20 53 65 65 20 64 6f 63 s type. See doc
15270 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 20 74 68 umentation at th
15280 65 20 74 6f 70 20 6f 66 20 74 68 65 0a 2a 2a 20 e top of the.**
15290 61 6e 61 6c 79 7a 65 2e 63 20 73 6f 75 72 63 65 analyze.c source
152a0 20 66 69 6c 65 20 66 6f 72 20 61 64 64 69 74 69 file for additi
152b0 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e onal information
152c0 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 ..*/.struct Inde
152d0 78 53 61 6d 70 6c 65 20 7b 0a 20 20 76 6f 69 64 xSample {. void
152e0 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 2f 2a *p; /*
152f0 20 50 6f 69 6e 74 65 72 20 74 6f 20 73 61 6d 70 Pointer to samp
15300 6c 65 64 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 led record */.
15310 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20 20 int n;
15320 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65 63 /* Size of rec
15330 6f 72 64 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a ord in bytes */.
15340 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 45 71 3b tRowcnt *anEq;
15350 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 /* Est. numb
15360 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 er of rows where
15370 20 74 68 65 20 6b 65 79 20 65 71 75 61 6c 73 20 the key equals
15380 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 20 this sample */.
15390 20 74 52 6f 77 63 6e 74 20 2a 61 6e 4c 74 3b 20 tRowcnt *anLt;
153a0 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 65 /* Est. numbe
153b0 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 20 r of rows where
153c0 6b 65 79 20 69 73 20 6c 65 73 73 20 74 68 61 6e key is less than
153d0 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a this sample */.
153e0 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 44 4c 74 tRowcnt *anDLt
153f0 3b 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 ; /* Est. numb
15400 65 72 20 6f 66 20 64 69 73 74 69 6e 63 74 20 6b er of distinct k
15410 65 79 73 20 6c 65 73 73 20 74 68 61 6e 20 74 68 eys less than th
15420 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 7d 3b 0a is sample */.};.
15430 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 6f 6b 65 ./*.** Each toke
15440 6e 20 63 6f 6d 69 6e 67 20 6f 75 74 20 6f 66 20 n coming out of
15450 74 68 65 20 6c 65 78 65 72 20 69 73 20 61 6e 20 the lexer is an
15460 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74 instance of.** t
15470 68 69 73 20 73 74 72 75 63 74 75 72 65 2e 20 20 his structure.
15480 54 6f 6b 65 6e 73 20 61 72 65 20 61 6c 73 6f 20 Tokens are also
15490 75 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 used as part of
154a0 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2a an expression..*
154b0 2a 0a 2a 2a 20 4e 6f 74 65 20 69 66 20 54 6f 6b *.** Note if Tok
154c0 65 6e 2e 7a 3d 3d 30 20 74 68 65 6e 20 54 6f 6b en.z==0 then Tok
154d0 65 6e 2e 64 79 6e 20 61 6e 64 20 54 6f 6b 65 6e en.dyn and Token
154e0 2e 6e 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 .n are undefined
154f0 20 61 6e 64 0a 2a 2a 20 6d 61 79 20 63 6f 6e 74 and.** may cont
15500 61 69 6e 20 72 61 6e 64 6f 6d 20 76 61 6c 75 65 ain random value
15510 73 2e 20 20 44 6f 20 6e 6f 74 20 6d 61 6b 65 20 s. Do not make
15520 61 6e 79 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 any assumptions
15530 61 62 6f 75 74 20 54 6f 6b 65 6e 2e 64 79 6e 0a about Token.dyn.
15540 2a 2a 20 61 6e 64 20 54 6f 6b 65 6e 2e 6e 20 77 ** and Token.n w
15550 68 65 6e 20 54 6f 6b 65 6e 2e 7a 3d 3d 30 2e 0a hen Token.z==0..
15560 2a 2f 0a 73 74 72 75 63 74 20 54 6f 6b 65 6e 20 */.struct Token
15570 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
15580 7a 3b 20 20 20 20 20 2f 2a 20 54 65 78 74 20 6f z; /* Text o
15590 66 20 74 68 65 20 74 6f 6b 65 6e 2e 20 20 4e 6f f the token. No
155a0 74 20 4e 55 4c 4c 2d 74 65 72 6d 69 6e 61 74 65 t NULL-terminate
155b0 64 21 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 d! */. unsigned
155c0 20 69 6e 74 20 6e 3b 20 20 20 20 2f 2a 20 4e 75 int n; /* Nu
155d0 6d 62 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 mber of characte
155e0 72 73 20 69 6e 20 74 68 69 73 20 74 6f 6b 65 6e rs in this token
155f0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
15600 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 instance of thi
15610 73 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 s structure cont
15620 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ains information
15630 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
15640 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 ate.** code for
15650 61 20 53 45 4c 45 43 54 20 74 68 61 74 20 63 6f a SELECT that co
15660 6e 74 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 ntains aggregate
15670 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a functions..**.*
15680 2a 20 49 66 20 45 78 70 72 2e 6f 70 3d 3d 54 4b * If Expr.op==TK
15690 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 6f 72 20 54 _AGG_COLUMN or T
156a0 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 74 K_AGG_FUNCTION t
156b0 68 65 6e 20 45 78 70 72 2e 70 41 67 67 49 6e 66 hen Expr.pAggInf
156c0 6f 20 69 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 o is a.** pointe
156d0 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
156e0 75 72 65 2e 20 20 54 68 65 20 45 78 70 72 2e 69 ure. The Expr.i
156f0 43 6f 6c 75 6d 6e 20 66 69 65 6c 64 20 69 73 20 Column field is
15700 74 68 65 20 69 6e 64 65 78 20 69 6e 0a 2a 2a 20 the index in.**
15710 41 67 67 49 6e 66 6f 2e 61 43 6f 6c 5b 5d 20 6f AggInfo.aCol[] o
15720 72 20 41 67 67 49 6e 66 6f 2e 61 46 75 6e 63 5b r AggInfo.aFunc[
15730 5d 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ] of information
15740 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
15750 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 ate.** code for
15760 74 68 61 74 20 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a that node..**.**
15770 20 41 67 67 49 6e 66 6f 2e 70 47 72 6f 75 70 42 AggInfo.pGroupB
15780 79 20 61 6e 64 20 41 67 67 49 6e 66 6f 2e 61 46 y and AggInfo.aF
15790 75 6e 63 2e 70 45 78 70 72 20 70 6f 69 6e 74 20 unc.pExpr point
157a0 74 6f 20 66 69 65 6c 64 73 20 77 69 74 68 69 6e to fields within
157b0 20 74 68 65 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c the.** original
157c0 20 53 65 6c 65 63 74 20 73 74 72 75 63 74 75 72 Select structur
157d0 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 e that describes
157e0 20 74 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 the SELECT stat
157f0 65 6d 65 6e 74 2e 20 20 54 68 65 73 65 0a 2a 2a ement. These.**
15800 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f 74 20 6e fields do not n
15810 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 64 20 eed to be freed
15820 77 68 65 6e 20 64 65 61 6c 6c 6f 63 61 74 69 6e when deallocatin
15830 67 20 74 68 65 20 41 67 67 49 6e 66 6f 20 73 74 g the AggInfo st
15840 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 ructure..*/.stru
15850 63 74 20 41 67 67 49 6e 66 6f 20 7b 0a 20 20 75 ct AggInfo {. u
15860 38 20 64 69 72 65 63 74 4d 6f 64 65 3b 20 20 20 8 directMode;
15870 20 20 20 20 20 20 20 2f 2a 20 44 69 72 65 63 74 /* Direct
15880 20 72 65 6e 64 65 72 69 6e 67 20 6d 6f 64 65 20 rendering mode
15890 6d 65 61 6e 73 20 74 61 6b 65 20 64 61 74 61 20 means take data
158a0 64 69 72 65 63 74 6c 79 0a 20 20 20 20 20 20 20 directly.
158b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
158c0 20 20 20 2a 2a 20 66 72 6f 6d 20 73 6f 75 72 63 ** from sourc
158d0 65 20 74 61 62 6c 65 73 20 72 61 74 68 65 72 20 e tables rather
158e0 74 68 61 6e 20 66 72 6f 6d 20 61 63 63 75 6d 75 than from accumu
158f0 6c 61 74 6f 72 73 20 2a 2f 0a 20 20 75 38 20 75 lators */. u8 u
15900 73 65 53 6f 72 74 69 6e 67 49 64 78 3b 20 20 20 seSortingIdx;
15910 20 20 20 20 2f 2a 20 49 6e 20 64 69 72 65 63 74 /* In direct
15920 20 6d 6f 64 65 2c 20 72 65 66 65 72 65 6e 63 65 mode, reference
15930 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
15940 65 78 20 72 61 74 68 65 72 0a 20 20 20 20 20 20 ex rather.
15950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15960 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 68 65 20 ** than the
15970 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a source table */.
15980 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 49 64 78 int sortingIdx
15990 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 ; /* Cur
159a0 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 sor number of th
159b0 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 20 e sorting index
159c0 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 */. int sorting
159d0 49 64 78 50 54 61 62 3b 20 20 20 20 20 2f 2a 20 IdxPTab; /*
159e0 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 Cursor number of
159f0 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 20 2a 2f pseudo-table */
15a00 0a 20 20 69 6e 74 20 6e 53 6f 72 74 69 6e 67 43 . int nSortingC
15a10 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 olumn; /* Nu
15a20 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
15a30 69 6e 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 in the sorting i
15a40 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 6d 6e ndex */. int mn
15a50 52 65 67 2c 20 6d 78 52 65 67 3b 20 20 20 20 20 Reg, mxReg;
15a60 20 20 2f 2a 20 52 61 6e 67 65 20 6f 66 20 72 65 /* Range of re
15a70 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 65 gisters allocate
15a80 64 20 66 6f 72 20 61 43 6f 6c 20 61 6e 64 20 61 d for aCol and a
15a90 46 75 6e 63 20 2a 2f 0a 20 20 45 78 70 72 4c 69 Func */. ExprLi
15aa0 73 74 20 2a 70 47 72 6f 75 70 42 79 3b 20 20 20 st *pGroupBy;
15ab0 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 62 /* The group b
15ac0 79 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 73 74 y clause */. st
15ad0 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 63 6f 6c ruct AggInfo_col
15ae0 20 7b 20 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 { /* For eac
15af0 68 20 63 6f 6c 75 6d 6e 20 75 73 65 64 20 69 6e h column used in
15b00 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 2a source tables *
15b10 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 /. Table *pTa
15b20 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f b; /
15b30 2a 20 53 6f 75 72 63 65 20 74 61 62 6c 65 20 2a * Source table *
15b40 2f 0a 20 20 20 20 69 6e 74 20 69 54 61 62 6c 65 /. int iTable
15b50 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
15b60 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 * Cursor number
15b70 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 of the source ta
15b80 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 ble */. int i
15b90 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 Column;
15ba0 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 /* Column nu
15bb0 6d 62 65 72 20 77 69 74 68 69 6e 20 74 68 65 20 mber within the
15bc0 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a source table */.
15bd0 20 20 20 20 69 6e 74 20 69 53 6f 72 74 65 72 43 int iSorterC
15be0 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 2f 2a 20 olumn; /*
15bf0 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e Column number in
15c00 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
15c10 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d ex */. int iM
15c20 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 em;
15c30 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 /* Memory loc
15c40 61 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 ation that acts
15c50 61 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a as accumulator *
15c60 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 /. Expr *pExp
15c70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f r; /
15c80 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 65 * The original e
15c90 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 7d xpression */. }
15ca0 20 2a 61 43 6f 6c 3b 0a 20 20 69 6e 74 20 6e 43 *aCol;. int nC
15cb0 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
15cc0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
15cd0 73 65 64 20 65 6e 74 72 69 65 73 20 69 6e 20 61 sed entries in a
15ce0 43 6f 6c 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e Col[] */. int n
15cf0 41 63 63 75 6d 75 6c 61 74 6f 72 3b 20 20 20 20 Accumulator;
15d00 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
15d10 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 73 68 6f columns that sho
15d20 77 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 w through to the
15d30 20 6f 75 74 70 75 74 2e 0a 20 20 20 20 20 20 20 output..
15d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15d50 20 20 20 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c ** Additional
15d60 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 75 73 65 columns are use
15d70 64 20 6f 6e 6c 79 20 61 73 20 70 61 72 61 6d 65 d only as parame
15d80 74 65 72 73 20 74 6f 0a 20 20 20 20 20 20 20 20 ters to.
15d90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15da0 20 20 2a 2a 20 61 67 67 72 65 67 61 74 65 20 66 ** aggregate f
15db0 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 74 unctions */. st
15dc0 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 66 75 6e ruct AggInfo_fun
15dd0 63 20 7b 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 c { /* For eac
15de0 68 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 h aggregate func
15df0 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 45 78 70 72 tion */. Expr
15e00 20 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 *pExpr;
15e10 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 /* Expressi
15e20 6f 6e 20 65 6e 63 6f 64 69 6e 67 20 74 68 65 20 on encoding the
15e30 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 function */.
15e40 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 3b 20 FuncDef *pFunc;
15e50 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
15e60 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
15e70 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f on implementatio
15e80 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d 65 n */. int iMe
15e90 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 m;
15ea0 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 /* Memory loca
15eb0 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 61 tion that acts a
15ec0 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f s accumulator */
15ed0 0a 20 20 20 20 69 6e 74 20 69 44 69 73 74 69 6e . int iDistin
15ee0 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ct; /*
15ef0 20 45 70 68 65 6d 65 72 61 6c 20 74 61 62 6c 65 Ephemeral table
15f00 20 75 73 65 64 20 74 6f 20 65 6e 66 6f 72 63 65 used to enforce
15f10 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 20 20 7d DISTINCT */. }
15f20 20 2a 61 46 75 6e 63 3b 0a 20 20 69 6e 74 20 6e *aFunc;. int n
15f30 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 Func;
15f40 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
15f50 65 6e 74 72 69 65 73 20 69 6e 20 61 46 75 6e 63 entries in aFunc
15f60 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 [] */.};../*.**
15f70 54 68 65 20 64 61 74 61 74 79 70 65 20 79 6e 56 The datatype ynV
15f80 61 72 20 69 73 20 61 20 73 69 67 6e 65 64 20 69 ar is a signed i
15f90 6e 74 65 67 65 72 2c 20 65 69 74 68 65 72 20 31 nteger, either 1
15fa0 36 2d 62 69 74 20 6f 72 20 33 32 2d 62 69 74 2e 6-bit or 32-bit.
15fb0 0a 2a 2a 20 55 73 75 61 6c 6c 79 20 69 74 20 69 .** Usually it i
15fc0 73 20 31 36 2d 62 69 74 73 2e 20 20 42 75 74 20 s 16-bits. But
15fd0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 if SQLITE_MAX_VA
15fe0 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 20 69 73 RIABLE_NUMBER is
15ff0 20 67 72 65 61 74 65 72 0a 2a 2a 20 74 68 61 6e greater.** than
16000 20 33 32 37 36 37 20 77 65 20 68 61 76 65 20 74 32767 we have t
16010 6f 20 6d 61 6b 65 20 69 74 20 33 32 2d 62 69 74 o make it 32-bit
16020 2e 20 20 31 36 2d 62 69 74 20 69 73 20 70 72 65 . 16-bit is pre
16030 66 65 72 72 65 64 20 62 65 63 61 75 73 65 0a 2a ferred because.*
16040 2a 20 69 74 20 75 73 65 73 20 6c 65 73 73 20 6d * it uses less m
16050 65 6d 6f 72 79 20 69 6e 20 74 68 65 20 45 78 70 emory in the Exp
16060 72 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 r object, which
16070 69 73 20 61 20 62 69 67 20 6d 65 6d 6f 72 79 20 is a big memory
16080 75 73 65 72 0a 2a 2a 20 69 6e 20 73 79 73 74 65 user.** in syste
16090 6d 73 20 77 69 74 68 20 6c 6f 74 73 20 6f 66 20 ms with lots of
160a0 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 prepared stateme
160b0 6e 74 73 2e 20 20 41 6e 64 20 66 65 77 20 61 70 nts. And few ap
160c0 70 6c 69 63 61 74 69 6f 6e 73 0a 2a 2a 20 6e 65 plications.** ne
160d0 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 61 62 6f ed more than abo
160e0 75 74 20 31 30 20 6f 72 20 32 30 20 76 61 72 69 ut 10 or 20 vari
160f0 61 62 6c 65 73 2e 20 20 42 75 74 20 73 6f 6d 65 ables. But some
16100 20 65 78 74 72 65 6d 65 20 75 73 65 72 73 20 77 extreme users w
16110 61 6e 74 0a 2a 2a 20 74 6f 20 68 61 76 65 20 70 ant.** to have p
16120 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e repared statemen
16130 74 73 20 77 69 74 68 20 6f 76 65 72 20 33 32 37 ts with over 327
16140 36 37 20 76 61 72 69 61 62 6c 65 73 2c 20 61 6e 67 variables, an
16150 64 20 66 6f 72 20 74 68 65 6d 0a 2a 2a 20 74 68 d for them.** th
16160 65 20 6f 70 74 69 6f 6e 20 69 73 20 61 76 61 69 e option is avai
16170 6c 61 62 6c 65 20 28 61 74 20 63 6f 6d 70 69 6c lable (at compil
16180 65 2d 74 69 6d 65 29 2e 0a 2a 2f 0a 23 69 66 20 e-time)..*/.#if
16190 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 SQLITE_MAX_VARIA
161a0 42 4c 45 5f 4e 55 4d 42 45 52 3c 3d 33 32 37 36 BLE_NUMBER<=3276
161b0 37 0a 74 79 70 65 64 65 66 20 69 31 36 20 79 6e 7.typedef i16 yn
161c0 56 61 72 3b 0a 23 65 6c 73 65 0a 74 79 70 65 64 Var;.#else.typed
161d0 65 66 20 69 6e 74 20 79 6e 56 61 72 3b 0a 23 65 ef int ynVar;.#e
161e0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 ndif../*.** Each
161f0 20 6e 6f 64 65 20 6f 66 20 61 6e 20 65 78 70 72 node of an expr
16200 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 70 61 ession in the pa
16210 72 73 65 20 74 72 65 65 20 69 73 20 61 6e 20 69 rse tree is an i
16220 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 nstance.** of th
16230 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a is structure..**
16240 0a 2a 2a 20 45 78 70 72 2e 6f 70 20 69 73 20 74 .** Expr.op is t
16250 68 65 20 6f 70 63 6f 64 65 2e 20 54 68 65 20 69 he opcode. The i
16260 6e 74 65 67 65 72 20 70 61 72 73 65 72 20 74 6f nteger parser to
16270 6b 65 6e 20 63 6f 64 65 73 20 61 72 65 20 72 65 ken codes are re
16280 75 73 65 64 0a 2a 2a 20 61 73 20 6f 70 63 6f 64 used.** as opcod
16290 65 73 20 68 65 72 65 2e 20 46 6f 72 20 65 78 61 es here. For exa
162a0 6d 70 6c 65 2c 20 74 68 65 20 70 61 72 73 65 72 mple, the parser
162b0 20 64 65 66 69 6e 65 73 20 54 4b 5f 47 45 20 74 defines TK_GE t
162c0 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 0a o be an integer.
162d0 2a 2a 20 63 6f 64 65 20 72 65 70 72 65 73 65 6e ** code represen
162e0 74 69 6e 67 20 74 68 65 20 22 3e 3d 22 20 6f 70 ting the ">=" op
162f0 65 72 61 74 6f 72 2e 20 54 68 69 73 20 73 61 6d erator. This sam
16300 65 20 69 6e 74 65 67 65 72 20 63 6f 64 65 20 69 e integer code i
16310 73 20 72 65 75 73 65 64 0a 2a 2a 20 74 6f 20 72 s reused.** to r
16320 65 70 72 65 73 65 6e 74 20 74 68 65 20 67 72 65 epresent the gre
16330 61 74 65 72 2d 74 68 61 6e 2d 6f 72 2d 65 71 75 ater-than-or-equ
16340 61 6c 2d 74 6f 20 6f 70 65 72 61 74 6f 72 20 69 al-to operator i
16350 6e 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e n the expression
16360 0a 2a 2a 20 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 .** tree..**.**
16370 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f If the expressio
16380 6e 20 69 73 20 61 6e 20 53 51 4c 20 6c 69 74 65 n is an SQL lite
16390 72 61 6c 20 28 54 4b 5f 49 4e 54 45 47 45 52 2c ral (TK_INTEGER,
163a0 20 54 4b 5f 46 4c 4f 41 54 2c 20 54 4b 5f 42 4c TK_FLOAT, TK_BL
163b0 4f 42 2c 0a 2a 2a 20 6f 72 20 54 4b 5f 53 54 52 OB,.** or TK_STR
163c0 49 4e 47 29 2c 20 74 68 65 6e 20 45 78 70 72 2e ING), then Expr.
163d0 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 20 74 token contains t
163e0 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 53 he text of the S
163f0 51 4c 20 6c 69 74 65 72 61 6c 2e 20 49 66 0a 2a QL literal. If.*
16400 2a 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e * the expression
16410 20 69 73 20 61 20 76 61 72 69 61 62 6c 65 20 28 is a variable (
16420 54 4b 5f 56 41 52 49 41 42 4c 45 29 2c 20 74 68 TK_VARIABLE), th
16430 65 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f en Expr.token co
16440 6e 74 61 69 6e 73 20 74 68 65 0a 2a 2a 20 76 61 ntains the.** va
16450 72 69 61 62 6c 65 20 6e 61 6d 65 2e 20 46 69 6e riable name. Fin
16460 61 6c 6c 79 2c 20 69 66 20 74 68 65 20 65 78 70 ally, if the exp
16470 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 ression is an SQ
16480 4c 20 66 75 6e 63 74 69 6f 6e 20 28 54 4b 5f 46 L function (TK_F
16490 55 4e 43 54 49 4f 4e 29 2c 0a 2a 2a 20 74 68 65 UNCTION),.** the
164a0 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e n Expr.token con
164b0 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 20 6f tains the name o
164c0 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 0a f the function..
164d0 2a 2a 0a 2a 2a 20 45 78 70 72 2e 70 52 69 67 68 **.** Expr.pRigh
164e0 74 20 61 6e 64 20 45 78 70 72 2e 70 4c 65 66 74 t and Expr.pLeft
164f0 20 61 72 65 20 74 68 65 20 6c 65 66 74 20 61 6e are the left an
16500 64 20 72 69 67 68 74 20 73 75 62 65 78 70 72 65 d right subexpre
16510 73 73 69 6f 6e 73 20 6f 66 20 61 0a 2a 2a 20 62 ssions of a.** b
16520 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 2e 20 inary operator.
16530 45 69 74 68 65 72 20 6f 72 20 62 6f 74 68 20 6d Either or both m
16540 61 79 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a ay be NULL..**.*
16550 2a 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 69 * Expr.x.pList i
16560 73 20 61 20 6c 69 73 74 20 6f 66 20 61 72 67 75 s a list of argu
16570 6d 65 6e 74 73 20 69 66 20 74 68 65 20 65 78 70 ments if the exp
16580 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 ression is an SQ
16590 4c 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 61 L function,.** a
165a0 20 43 41 53 45 20 65 78 70 72 65 73 73 69 6f 6e CASE expression
165b0 20 6f 72 20 61 6e 20 49 4e 20 65 78 70 72 65 73 or an IN expres
165c0 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d sion of the form
165d0 20 22 3c 6c 68 73 3e 20 49 4e 20 28 3c 79 3e 2c "<lhs> IN (<y>,
165e0 20 3c 7a 3e 2e 2e 2e 29 22 2e 0a 2a 2a 20 45 78 <z>...)"..** Ex
165f0 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 73 20 pr.x.pSelect is
16600 75 73 65 64 20 69 66 20 74 68 65 20 65 78 70 72 used if the expr
16610 65 73 73 69 6f 6e 20 69 73 20 61 20 73 75 62 2d ession is a sub-
16620 73 65 6c 65 63 74 20 6f 72 20 61 6e 20 65 78 70 select or an exp
16630 72 65 73 73 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 ression of.** th
16640 65 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 49 4e e form "<lhs> IN
16650 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 2e 20 (SELECT ...)".
16660 49 66 20 74 68 65 20 45 50 5f 78 49 73 53 65 6c If the EP_xIsSel
16670 65 63 74 20 62 69 74 20 69 73 20 73 65 74 20 69 ect bit is set i
16680 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e 66 6c n the.** Expr.fl
16690 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 45 ags mask, then E
166a0 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 73 xpr.x.pSelect is
166b0 20 76 61 6c 69 64 2e 20 4f 74 68 65 72 77 69 73 valid. Otherwis
166c0 65 2c 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 e, Expr.x.pList
166d0 69 73 0a 2a 2a 20 76 61 6c 69 64 2e 0a 2a 2a 0a is.** valid..**.
166e0 2a 2a 20 41 6e 20 65 78 70 72 65 73 73 69 6f 6e ** An expression
166f0 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 49 44 20 of the form ID
16700 6f 72 20 49 44 2e 49 44 20 72 65 66 65 72 73 20 or ID.ID refers
16710 74 6f 20 61 20 63 6f 6c 75 6d 6e 20 69 6e 20 61 to a column in a
16720 20 74 61 62 6c 65 2e 0a 2a 2a 20 46 6f 72 20 73 table..** For s
16730 75 63 68 20 65 78 70 72 65 73 73 69 6f 6e 73 2c uch expressions,
16740 20 45 78 70 72 2e 6f 70 20 69 73 20 73 65 74 20 Expr.op is set
16750 74 6f 20 54 4b 5f 43 4f 4c 55 4d 4e 20 61 6e 64 to TK_COLUMN and
16760 20 45 78 70 72 2e 69 54 61 62 6c 65 20 69 73 0a Expr.iTable is.
16770 2a 2a 20 74 68 65 20 69 6e 74 65 67 65 72 20 63 ** the integer c
16780 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 ursor number of
16790 61 20 56 44 42 45 20 63 75 72 73 6f 72 20 70 6f a VDBE cursor po
167a0 69 6e 74 69 6e 67 20 74 6f 20 74 68 61 74 20 74 inting to that t
167b0 61 62 6c 65 20 61 6e 64 0a 2a 2a 20 45 78 70 72 able and.** Expr
167c0 2e 69 43 6f 6c 75 6d 6e 20 69 73 20 74 68 65 20 .iColumn is the
167d0 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 66 6f column number fo
167e0 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 63 r the specific c
167f0 6f 6c 75 6d 6e 2e 20 20 49 66 20 74 68 65 0a 2a olumn. If the.*
16800 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 * expression is
16810 75 73 65 64 20 61 73 20 61 20 72 65 73 75 6c 74 used as a result
16820 20 69 6e 20 61 6e 20 61 67 67 72 65 67 61 74 65 in an aggregate
16830 20 53 45 4c 45 43 54 2c 20 74 68 65 6e 20 74 68 SELECT, then th
16840 65 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 61 6c e.** value is al
16850 73 6f 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 so stored in the
16860 20 45 78 70 72 2e 69 41 67 67 20 63 6f 6c 75 6d Expr.iAgg colum
16870 6e 20 69 6e 20 74 68 65 20 61 67 67 72 65 67 61 n in the aggrega
16880 74 65 20 73 6f 20 74 68 61 74 0a 2a 2a 20 69 74 te so that.** it
16890 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 65 64 can be accessed
168a0 20 61 66 74 65 72 20 61 6c 6c 20 61 67 67 72 65 after all aggre
168b0 67 61 74 65 73 20 61 72 65 20 63 6f 6d 70 75 74 gates are comput
168c0 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ed..**.** If the
168d0 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 expression is a
168e0 6e 20 75 6e 62 6f 75 6e 64 20 76 61 72 69 61 62 n unbound variab
168f0 6c 65 20 6d 61 72 6b 65 72 20 28 61 20 71 75 65 le marker (a que
16900 73 74 69 6f 6e 20 6d 61 72 6b 0a 2a 2a 20 63 68 stion mark.** ch
16910 61 72 61 63 74 65 72 20 27 3f 27 20 69 6e 20 74 aracter '?' in t
16920 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 29 he original SQL)
16930 20 74 68 65 6e 20 74 68 65 20 45 78 70 72 2e 69 then the Expr.i
16940 54 61 62 6c 65 20 68 6f 6c 64 73 20 74 68 65 20 Table holds the
16950 69 6e 64 65 78 0a 2a 2a 20 6e 75 6d 62 65 72 20 index.** number
16960 66 6f 72 20 74 68 61 74 20 76 61 72 69 61 62 6c for that variabl
16970 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 e..**.** If the
16980 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 20 expression is a
16990 73 75 62 71 75 65 72 79 20 74 68 65 6e 20 45 78 subquery then Ex
169a0 70 72 2e 69 43 6f 6c 75 6d 6e 20 68 6f 6c 64 73 pr.iColumn holds
169b0 20 61 6e 20 69 6e 74 65 67 65 72 0a 2a 2a 20 72 an integer.** r
169c0 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 20 63 egister number c
169d0 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 72 65 ontaining the re
169e0 73 75 6c 74 20 6f 66 20 74 68 65 20 73 75 62 71 sult of the subq
169f0 75 65 72 79 2e 20 20 49 66 20 74 68 65 0a 2a 2a uery. If the.**
16a00 20 73 75 62 71 75 65 72 79 20 67 69 76 65 73 20 subquery gives
16a10 61 20 63 6f 6e 73 74 61 6e 74 20 72 65 73 75 6c a constant resul
16a20 74 2c 20 74 68 65 6e 20 69 54 61 62 6c 65 20 69 t, then iTable i
16a30 73 20 2d 31 2e 20 20 49 66 20 74 68 65 20 73 75 s -1. If the su
16a40 62 71 75 65 72 79 0a 2a 2a 20 67 69 76 65 73 20 bquery.** gives
16a50 61 20 64 69 66 66 65 72 65 6e 74 20 61 6e 73 77 a different answ
16a60 65 72 20 61 74 20 64 69 66 66 65 72 65 6e 74 20 er at different
16a70 74 69 6d 65 73 20 64 75 72 69 6e 67 20 73 74 61 times during sta
16a80 74 65 6d 65 6e 74 20 70 72 6f 63 65 73 73 69 6e tement processin
16a90 67 0a 2a 2a 20 74 68 65 6e 20 69 54 61 62 6c 65 g.** then iTable
16aa0 20 69 73 20 74 68 65 20 61 64 64 72 65 73 73 20 is the address
16ab0 6f 66 20 61 20 73 75 62 72 6f 75 74 69 6e 65 20 of a subroutine
16ac0 74 68 61 74 20 63 6f 6d 70 75 74 65 73 20 74 68 that computes th
16ad0 65 20 73 75 62 71 75 65 72 79 2e 0a 2a 2a 0a 2a e subquery..**.*
16ae0 2a 20 49 66 20 74 68 65 20 45 78 70 72 20 69 73 * If the Expr is
16af0 20 6f 66 20 74 79 70 65 20 4f 50 5f 43 6f 6c 75 of type OP_Colu
16b00 6d 6e 2c 20 61 6e 64 20 74 68 65 20 74 61 62 6c mn, and the tabl
16b10 65 20 69 74 20 69 73 20 73 65 6c 65 63 74 69 6e e it is selectin
16b20 67 20 66 72 6f 6d 0a 2a 2a 20 69 73 20 61 20 64 g from.** is a d
16b30 69 73 6b 20 74 61 62 6c 65 20 6f 72 20 74 68 65 isk table or the
16b40 20 22 6f 6c 64 2e 2a 22 20 70 73 65 75 64 6f 2d "old.*" pseudo-
16b50 74 61 62 6c 65 2c 20 74 68 65 6e 20 70 54 61 62 table, then pTab
16b60 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a points to the.*
16b70 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 * corresponding
16b80 74 61 62 6c 65 20 64 65 66 69 6e 69 74 69 6f 6e table definition
16b90 2e 0a 2a 2a 0a 2a 2a 20 41 4c 4c 4f 43 41 54 49 ..**.** ALLOCATI
16ba0 4f 4e 20 4e 4f 54 45 53 3a 0a 2a 2a 0a 2a 2a 20 ON NOTES:.**.**
16bb0 45 78 70 72 20 6f 62 6a 65 63 74 73 20 63 61 6e Expr objects can
16bc0 20 75 73 65 20 61 20 6c 6f 74 20 6f 66 20 6d 65 use a lot of me
16bd0 6d 6f 72 79 20 73 70 61 63 65 20 69 6e 20 64 61 mory space in da
16be0 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 20 tabase schema.
16bf0 54 6f 0a 2a 2a 20 68 65 6c 70 20 72 65 64 75 63 To.** help reduc
16c00 65 20 6d 65 6d 6f 72 79 20 72 65 71 75 69 72 65 e memory require
16c10 6d 65 6e 74 73 2c 20 73 6f 6d 65 74 69 6d 65 73 ments, sometimes
16c20 20 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 74 20 an Expr object
16c30 77 69 6c 6c 20 62 65 0a 2a 2a 20 74 72 75 6e 63 will be.** trunc
16c40 61 74 65 64 2e 20 20 41 6e 64 20 74 6f 20 72 65 ated. And to re
16c50 64 75 63 65 20 74 68 65 20 6e 75 6d 62 65 72 20 duce the number
16c60 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 of memory alloca
16c70 74 69 6f 6e 73 2c 20 73 6f 6d 65 74 69 6d 65 73 tions, sometimes
16c80 0a 2a 2a 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 .** two or more
16c90 45 78 70 72 20 6f 62 6a 65 63 74 73 20 77 69 6c Expr objects wil
16ca0 6c 20 62 65 20 73 74 6f 72 65 64 20 69 6e 20 61 l be stored in a
16cb0 20 73 69 6e 67 6c 65 20 6d 65 6d 6f 72 79 20 61 single memory a
16cc0 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a 20 74 6f llocation,.** to
16cd0 67 65 74 68 65 72 20 77 69 74 68 20 45 78 70 72 gether with Expr
16ce0 2e 7a 54 6f 6b 65 6e 20 73 74 72 69 6e 67 73 2e .zToken strings.
16cf0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 45 50 .**.** If the EP
16d00 5f 52 65 64 75 63 65 64 20 61 6e 64 20 45 50 5f _Reduced and EP_
16d10 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 67 73 20 TokenOnly flags
16d20 61 72 65 20 73 65 74 20 77 68 65 6e 0a 2a 2a 20 are set when.**
16d30 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 74 20 69 an Expr object i
16d40 73 20 74 72 75 6e 63 61 74 65 64 2e 20 20 57 68 s truncated. Wh
16d50 65 6e 20 45 50 5f 52 65 64 75 63 65 64 20 69 73 en EP_Reduced is
16d60 20 73 65 74 2c 20 74 68 65 6e 20 61 6c 6c 0a 2a set, then all.*
16d70 2a 20 74 68 65 20 63 68 69 6c 64 20 45 78 70 72 * the child Expr
16d80 20 6f 62 6a 65 63 74 73 20 69 6e 20 74 68 65 20 objects in the
16d90 45 78 70 72 2e 70 4c 65 66 74 20 61 6e 64 20 45 Expr.pLeft and E
16da0 78 70 72 2e 70 52 69 67 68 74 20 73 75 62 74 72 xpr.pRight subtr
16db0 65 65 73 0a 2a 2a 20 61 72 65 20 63 6f 6e 74 61 ees.** are conta
16dc0 69 6e 65 64 20 77 69 74 68 69 6e 20 74 68 65 20 ined within the
16dd0 73 61 6d 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f same memory allo
16de0 63 61 74 69 6f 6e 2e 20 20 4e 6f 74 65 2c 20 68 cation. Note, h
16df0 6f 77 65 76 65 72 2c 20 74 68 61 74 0a 2a 2a 20 owever, that.**
16e00 74 68 65 20 73 75 62 74 72 65 65 73 20 69 6e 20 the subtrees in
16e10 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 6f 72 20 Expr.x.pList or
16e20 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 61 Expr.x.pSelect a
16e30 72 65 20 61 6c 77 61 79 73 20 73 65 70 61 72 61 re always separa
16e40 74 65 6c 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 65 tely.** allocate
16e50 64 2c 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 d, regardless of
16e60 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
16e70 45 50 5f 52 65 64 75 63 65 64 20 69 73 20 73 65 EP_Reduced is se
16e80 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 70 t..*/.struct Exp
16e90 72 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 r {. u8 op;
16ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
16eb0 4f 70 65 72 61 74 69 6f 6e 20 70 65 72 66 6f 72 Operation perfor
16ec0 6d 65 64 20 62 79 20 74 68 69 73 20 6e 6f 64 65 med by this node
16ed0 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 69 6e */. char affin
16ee0 69 74 79 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ity; /*
16ef0 54 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 The affinity of
16f00 74 68 65 20 63 6f 6c 75 6d 6e 20 6f 72 20 30 20 the column or 0
16f10 69 66 20 6e 6f 74 20 61 20 63 6f 6c 75 6d 6e 20 if not a column
16f20 2a 2f 0a 20 20 75 33 32 20 66 6c 61 67 73 3b 20 */. u32 flags;
16f30 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
16f40 61 72 69 6f 75 73 20 66 6c 61 67 73 2e 20 20 45 arious flags. E
16f50 50 5f 2a 20 53 65 65 20 62 65 6c 6f 77 20 2a 2f P_* See below */
16f60 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 63 . union {. c
16f70 68 61 72 20 2a 7a 54 6f 6b 65 6e 3b 20 20 20 20 har *zToken;
16f80 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 76 /* Token v
16f90 61 6c 75 65 2e 20 5a 65 72 6f 20 74 65 72 6d 69 alue. Zero termi
16fa0 6e 61 74 65 64 20 61 6e 64 20 64 65 71 75 6f 74 nated and dequot
16fb0 65 64 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 56 ed */. int iV
16fc0 61 6c 75 65 3b 20 20 20 20 20 20 20 20 20 20 20 alue;
16fd0 20 2f 2a 20 4e 6f 6e 2d 6e 65 67 61 74 69 76 65 /* Non-negative
16fe0 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65 20 69 integer value i
16ff0 66 20 45 50 5f 49 6e 74 56 61 6c 75 65 20 2a 2f f EP_IntValue */
17000 0a 20 20 7d 20 75 3b 0a 0a 20 20 2f 2a 20 49 66 . } u;.. /* If
17010 20 74 68 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c the EP_TokenOnl
17020 79 20 66 6c 61 67 20 69 73 20 73 65 74 20 69 6e y flag is set in
17030 20 74 68 65 20 45 78 70 72 2e 66 6c 61 67 73 20 the Expr.flags
17040 6d 61 73 6b 2c 20 74 68 65 6e 20 6e 6f 0a 20 20 mask, then no.
17050 2a 2a 20 73 70 61 63 65 20 69 73 20 61 6c 6c 6f ** space is allo
17060 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 66 69 cated for the fi
17070 65 6c 64 73 20 62 65 6c 6f 77 20 74 68 69 73 20 elds below this
17080 70 6f 69 6e 74 2e 20 41 6e 20 61 74 74 65 6d 70 point. An attemp
17090 74 20 74 6f 0a 20 20 2a 2a 20 61 63 63 65 73 73 t to. ** access
170a0 20 74 68 65 6d 20 77 69 6c 6c 20 72 65 73 75 6c them will resul
170b0 74 20 69 6e 20 61 20 73 65 67 66 61 75 6c 74 20 t in a segfault
170c0 6f 72 20 6d 61 6c 66 75 6e 63 74 69 6f 6e 2e 0a or malfunction..
170d0 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a **************
170e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
170f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
17100 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
17110 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 45 78 70 72 *******/.. Expr
17120 20 2a 70 4c 65 66 74 3b 20 20 20 20 20 20 20 20 *pLeft;
17130 20 20 20 2f 2a 20 4c 65 66 74 20 73 75 62 6e 6f /* Left subno
17140 64 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 52 de */. Expr *pR
17150 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 20 2f ight; /
17160 2a 20 52 69 67 68 74 20 73 75 62 6e 6f 64 65 20 * Right subnode
17170 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 */. union {.
17180 20 45 78 70 72 4c 69 73 74 20 2a 70 4c 69 73 74 ExprList *pList
17190 3b 20 20 20 20 20 2f 2a 20 6f 70 20 3d 20 49 4e ; /* op = IN
171a0 2c 20 45 58 49 53 54 53 2c 20 53 45 4c 45 43 54 , EXISTS, SELECT
171b0 2c 20 43 41 53 45 2c 20 46 55 4e 43 54 49 4f 4e , CASE, FUNCTION
171c0 2c 20 42 45 54 57 45 45 4e 20 2a 2f 0a 20 20 20 , BETWEEN */.
171d0 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 Select *pSelect
171e0 3b 20 20 20 20 20 2f 2a 20 45 50 5f 78 49 73 53 ; /* EP_xIsS
171f0 65 6c 65 63 74 20 61 6e 64 20 6f 70 20 3d 20 49 elect and op = I
17200 4e 2c 20 45 58 49 53 54 53 2c 20 53 45 4c 45 43 N, EXISTS, SELEC
17210 54 20 2a 2f 0a 20 20 7d 20 78 3b 0a 0a 20 20 2f T */. } x;.. /
17220 2a 20 49 66 20 74 68 65 20 45 50 5f 52 65 64 75 * If the EP_Redu
17230 63 65 64 20 66 6c 61 67 20 69 73 20 73 65 74 20 ced flag is set
17240 69 6e 20 74 68 65 20 45 78 70 72 2e 66 6c 61 67 in the Expr.flag
17250 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 6e 6f 0a s mask, then no.
17260 20 20 2a 2a 20 73 70 61 63 65 20 69 73 20 61 6c ** space is al
17270 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 located for the
17280 66 69 65 6c 64 73 20 62 65 6c 6f 77 20 74 68 69 fields below thi
17290 73 20 70 6f 69 6e 74 2e 20 41 6e 20 61 74 74 65 s point. An atte
172a0 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 61 63 63 65 mpt to. ** acce
172b0 73 73 20 74 68 65 6d 20 77 69 6c 6c 20 72 65 73 ss them will res
172c0 75 6c 74 20 69 6e 20 61 20 73 65 67 66 61 75 6c ult in a segfaul
172d0 74 20 6f 72 20 6d 61 6c 66 75 6e 63 74 69 6f 6e t or malfunction
172e0 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a .. ************
172f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
17300 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
17310 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
17320 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 23 69 66 20 *********/..#if
17330 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 5f SQLITE_MAX_EXPR_
17340 44 45 50 54 48 3e 30 0a 20 20 69 6e 74 20 6e 48 DEPTH>0. int nH
17350 65 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 20 eight;
17360 20 2f 2a 20 48 65 69 67 68 74 20 6f 66 20 74 68 /* Height of th
17370 65 20 74 72 65 65 20 68 65 61 64 65 64 20 62 79 e tree headed by
17380 20 74 68 69 73 20 6e 6f 64 65 20 2a 2f 0a 23 65 this node */.#e
17390 6e 64 69 66 0a 20 20 69 6e 74 20 69 54 61 62 6c ndif. int iTabl
173a0 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
173b0 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 75 72 73 TK_COLUMN: curs
173c0 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 61 62 or number of tab
173d0 6c 65 20 68 6f 6c 64 69 6e 67 20 63 6f 6c 75 6d le holding colum
173e0 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 n.
173f0 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b ** TK
17400 5f 52 45 47 49 53 54 45 52 3a 20 72 65 67 69 73 _REGISTER: regis
17410 74 65 72 20 6e 75 6d 62 65 72 0a 20 20 20 20 20 ter number.
17420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17430 20 20 20 20 2a 2a 20 54 4b 5f 54 52 49 47 47 45 ** TK_TRIGGE
17440 52 3a 20 31 20 2d 3e 20 6e 65 77 2c 20 30 20 2d R: 1 -> new, 0 -
17450 3e 20 6f 6c 64 0a 20 20 20 20 20 20 20 20 20 20 > old.
17460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
17470 2a 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 3a 20 20 * EP_Unlikely:
17480 31 33 34 32 31 37 37 32 38 20 74 69 6d 65 73 20 134217728 times
17490 6c 69 6b 65 6c 69 68 6f 6f 64 0a 20 20 20 20 20 likelihood.
174a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
174b0 20 20 20 20 2a 2a 20 54 4b 5f 53 45 4c 45 43 54 ** TK_SELECT
174c0 3a 20 31 73 74 20 72 65 67 69 73 74 65 72 20 6f : 1st register o
174d0 66 20 72 65 73 75 6c 74 20 76 65 63 74 6f 72 20 f result vector
174e0 2a 2f 0a 20 20 79 6e 56 61 72 20 69 43 6f 6c 75 */. ynVar iColu
174f0 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 mn; /* T
17500 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c 75 6d 6e K_COLUMN: column
17510 20 69 6e 64 65 78 2e 20 20 2d 31 20 66 6f 72 20 index. -1 for
17520 72 6f 77 69 64 2e 0a 20 20 20 20 20 20 20 20 20 rowid..
17530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17540 2a 2a 20 54 4b 5f 56 41 52 49 41 42 4c 45 3a 20 ** TK_VARIABLE:
17550 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 20 variable number
17560 28 61 6c 77 61 79 73 20 3e 3d 20 31 29 2e 0a 20 (always >= 1)..
17570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17580 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f 53 45 ** TK_SE
17590 4c 45 43 54 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c LECT_COLUMN: col
175a0 75 6d 6e 20 6f 66 20 74 68 65 20 72 65 73 75 6c umn of the resul
175b0 74 20 76 65 63 74 6f 72 20 2a 2f 0a 20 20 69 31 t vector */. i1
175c0 36 20 69 41 67 67 3b 20 20 20 20 20 20 20 20 20 6 iAgg;
175d0 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 65 6e /* Which en
175e0 74 72 79 20 69 6e 20 70 41 67 67 49 6e 66 6f 2d try in pAggInfo-
175f0 3e 61 43 6f 6c 5b 5d 20 6f 72 20 2d 3e 61 46 75 >aCol[] or ->aFu
17600 6e 63 5b 5d 20 2a 2f 0a 20 20 69 31 36 20 69 52 nc[] */. i16 iR
17610 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 3b 20 20 ightJoinTable;
17620 20 2f 2a 20 49 66 20 45 50 5f 46 72 6f 6d 4a 6f /* If EP_FromJo
17630 69 6e 2c 20 74 68 65 20 72 69 67 68 74 20 74 61 in, the right ta
17640 62 6c 65 20 6f 66 20 74 68 65 20 6a 6f 69 6e 20 ble of the join
17650 2a 2f 0a 20 20 75 38 20 6f 70 32 3b 20 20 20 20 */. u8 op2;
17660 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
17670 4b 5f 52 45 47 49 53 54 45 52 3a 20 6f 72 69 67 K_REGISTER: orig
17680 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 45 78 inal value of Ex
17690 70 72 2e 6f 70 0a 20 20 20 20 20 20 20 20 20 20 pr.op.
176a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
176b0 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 74 68 65 * TK_COLUMN: the
176c0 20 76 61 6c 75 65 20 6f 66 20 70 35 20 66 6f 72 value of p5 for
176d0 20 4f 50 5f 43 6f 6c 75 6d 6e 0a 20 20 20 20 20 OP_Column.
176e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
176f0 20 20 20 20 2a 2a 20 54 4b 5f 41 47 47 5f 46 55 ** TK_AGG_FU
17700 4e 43 54 49 4f 4e 3a 20 6e 65 73 74 69 6e 67 20 NCTION: nesting
17710 64 65 70 74 68 20 2a 2f 0a 20 20 41 67 67 49 6e depth */. AggIn
17720 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 20 20 fo *pAggInfo;
17730 20 20 2f 2a 20 55 73 65 64 20 62 79 20 54 4b 5f /* Used by TK_
17740 41 47 47 5f 43 4f 4c 55 4d 4e 20 61 6e 64 20 54 AGG_COLUMN and T
17750 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 2a K_AGG_FUNCTION *
17760 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b /. Table *pTab;
17770 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 /* Ta
17780 62 6c 65 20 66 6f 72 20 54 4b 5f 43 4f 4c 55 4d ble for TK_COLUM
17790 4e 20 65 78 70 72 65 73 73 69 6f 6e 73 2e 20 2a N expressions. *
177a0 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 /.};../*.** The
177b0 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 68 following are th
177c0 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 20 62 69 e meanings of bi
177d0 74 73 20 69 6e 20 74 68 65 20 45 78 70 72 2e 66 ts in the Expr.f
177e0 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 lags field..*/.#
177f0 64 65 66 69 6e 65 20 45 50 5f 46 72 6f 6d 4a 6f define EP_FromJo
17800 69 6e 20 20 30 78 30 30 30 30 30 31 20 2f 2a 20 in 0x000001 /*
17810 4f 72 69 67 69 6e 61 74 65 73 20 69 6e 20 4f 4e Originates in ON
17820 2f 55 53 49 4e 47 20 63 6c 61 75 73 65 20 6f 66 /USING clause of
17830 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a 2f 0a 23 outer join */.#
17840 64 65 66 69 6e 65 20 45 50 5f 41 67 67 20 20 20 define EP_Agg
17850 20 20 20 20 30 78 30 30 30 30 30 32 20 2f 2a 20 0x000002 /*
17860 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 Contains one or
17870 6d 6f 72 65 20 61 67 67 72 65 67 61 74 65 20 66 more aggregate f
17880 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 unctions */.#def
17890 69 6e 65 20 45 50 5f 52 65 73 6f 6c 76 65 64 20 ine EP_Resolved
178a0 20 30 78 30 30 30 30 30 34 20 2f 2a 20 49 44 73 0x000004 /* IDs
178b0 20 68 61 76 65 20 62 65 65 6e 20 72 65 73 6f 6c have been resol
178c0 76 65 64 20 74 6f 20 43 4f 4c 55 4d 4e 73 20 2a ved to COLUMNs *
178d0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 45 72 72 /.#define EP_Err
178e0 6f 72 20 20 20 20 20 30 78 30 30 30 30 30 38 20 or 0x000008
178f0 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 63 6f /* Expression co
17900 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f ntains one or mo
17910 72 65 20 65 72 72 6f 72 73 20 2a 2f 0a 23 64 65 re errors */.#de
17920 66 69 6e 65 20 45 50 5f 44 69 73 74 69 6e 63 74 fine EP_Distinct
17930 20 20 30 78 30 30 30 30 31 30 20 2f 2a 20 41 67 0x000010 /* Ag
17940 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e gregate function
17950 20 77 69 74 68 20 44 49 53 54 49 4e 43 54 20 6b with DISTINCT k
17960 65 79 77 6f 72 64 20 2a 2f 0a 23 64 65 66 69 6e eyword */.#defin
17970 65 20 45 50 5f 56 61 72 53 65 6c 65 63 74 20 30 e EP_VarSelect 0
17980 78 30 30 30 30 32 30 20 2f 2a 20 70 53 65 6c 65 x000020 /* pSele
17990 63 74 20 69 73 20 63 6f 72 72 65 6c 61 74 65 64 ct is correlated
179a0 2c 20 6e 6f 74 20 63 6f 6e 73 74 61 6e 74 20 2a , not constant *
179b0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 44 62 6c /.#define EP_Dbl
179c0 51 75 6f 74 65 64 20 30 78 30 30 30 30 34 30 20 Quoted 0x000040
179d0 2f 2a 20 74 6f 6b 65 6e 2e 7a 20 77 61 73 20 6f /* token.z was o
179e0 72 69 67 69 6e 61 6c 6c 79 20 69 6e 20 22 2e 2e riginally in "..
179f0 2e 22 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 ." */.#define EP
17a00 5f 49 6e 66 69 78 46 75 6e 63 20 30 78 30 30 30 _InfixFunc 0x000
17a10 30 38 30 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 080 /* True for
17a20 61 6e 20 69 6e 66 69 78 20 66 75 6e 63 74 69 6f an infix functio
17a30 6e 3a 20 4c 49 4b 45 2c 20 47 4c 4f 42 2c 20 65 n: LIKE, GLOB, e
17a40 74 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 tc */.#define EP
17a50 5f 43 6f 6c 6c 61 74 65 20 20 20 30 78 30 30 30 _Collate 0x000
17a60 31 30 30 20 2f 2a 20 54 72 65 65 20 63 6f 6e 74 100 /* Tree cont
17a70 61 69 6e 73 20 61 20 54 4b 5f 43 4f 4c 4c 41 54 ains a TK_COLLAT
17a80 45 20 6f 70 65 72 61 74 6f 72 20 2a 2f 0a 23 64 E operator */.#d
17a90 65 66 69 6e 65 20 45 50 5f 47 65 6e 65 72 69 63 efine EP_Generic
17aa0 20 20 20 30 78 30 30 30 32 30 30 20 2f 2a 20 49 0x000200 /* I
17ab0 67 6e 6f 72 65 20 43 4f 4c 4c 41 54 45 20 6f 72 gnore COLLATE or
17ac0 20 61 66 66 69 6e 69 74 79 20 6f 6e 20 74 68 69 affinity on thi
17ad0 73 20 74 72 65 65 20 2a 2f 0a 23 64 65 66 69 6e s tree */.#defin
17ae0 65 20 45 50 5f 49 6e 74 56 61 6c 75 65 20 20 30 e EP_IntValue 0
17af0 78 30 30 30 34 30 30 20 2f 2a 20 49 6e 74 65 67 x000400 /* Integ
17b00 65 72 20 76 61 6c 75 65 20 63 6f 6e 74 61 69 6e er value contain
17b10 65 64 20 69 6e 20 75 2e 69 56 61 6c 75 65 20 2a ed in u.iValue *
17b20 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 78 49 73 /.#define EP_xIs
17b30 53 65 6c 65 63 74 20 30 78 30 30 30 38 30 30 20 Select 0x000800
17b40 2f 2a 20 78 2e 70 53 65 6c 65 63 74 20 69 73 20 /* x.pSelect is
17b50 76 61 6c 69 64 20 28 6f 74 68 65 72 77 69 73 65 valid (otherwise
17b60 20 78 2e 70 4c 69 73 74 20 69 73 29 20 2a 2f 0a x.pList is) */.
17b70 23 64 65 66 69 6e 65 20 45 50 5f 53 6b 69 70 20 #define EP_Skip
17b80 20 20 20 20 20 30 78 30 30 31 30 30 30 20 2f 2a 0x001000 /*
17b90 20 43 4f 4c 4c 41 54 45 2c 20 41 53 2c 20 6f 72 COLLATE, AS, or
17ba0 20 55 4e 4c 49 4b 45 4c 59 20 2a 2f 0a 23 64 65 UNLIKELY */.#de
17bb0 66 69 6e 65 20 45 50 5f 52 65 64 75 63 65 64 20 fine EP_Reduced
17bc0 20 20 30 78 30 30 32 30 30 30 20 2f 2a 20 45 78 0x002000 /* Ex
17bd0 70 72 20 73 74 72 75 63 74 20 45 58 50 52 5f 52 pr struct EXPR_R
17be0 45 44 55 43 45 44 53 49 5a 45 20 62 79 74 65 73 EDUCEDSIZE bytes
17bf0 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 only */.#define
17c00 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 30 78 EP_TokenOnly 0x
17c10 30 30 34 30 30 30 20 2f 2a 20 45 78 70 72 20 73 004000 /* Expr s
17c20 74 72 75 63 74 20 45 58 50 52 5f 54 4f 4b 45 4e truct EXPR_TOKEN
17c30 4f 4e 4c 59 53 49 5a 45 20 62 79 74 65 73 20 6f ONLYSIZE bytes o
17c40 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 nly */.#define E
17c50 50 5f 53 74 61 74 69 63 20 20 20 20 30 78 30 30 P_Static 0x00
17c60 38 30 30 30 20 2f 2a 20 48 65 6c 64 20 69 6e 20 8000 /* Held in
17c70 6d 65 6d 6f 72 79 20 6e 6f 74 20 6f 62 74 61 69 memory not obtai
17c80 6e 65 64 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 28 ned from malloc(
17c90 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f ) */.#define EP_
17ca0 4d 65 6d 54 6f 6b 65 6e 20 20 30 78 30 31 30 30 MemToken 0x0100
17cb0 30 30 20 2f 2a 20 4e 65 65 64 20 74 6f 20 73 71 00 /* Need to sq
17cc0 6c 69 74 65 33 44 62 46 72 65 65 28 29 20 45 78 lite3DbFree() Ex
17cd0 70 72 2e 7a 54 6f 6b 65 6e 20 2a 2f 0a 23 64 65 pr.zToken */.#de
17ce0 66 69 6e 65 20 45 50 5f 4e 6f 52 65 64 75 63 65 fine EP_NoReduce
17cf0 20 20 30 78 30 32 30 30 30 30 20 2f 2a 20 43 61 0x020000 /* Ca
17d00 6e 6e 6f 74 20 45 58 50 52 44 55 50 5f 52 45 44 nnot EXPRDUP_RED
17d10 55 43 45 20 74 68 69 73 20 45 78 70 72 20 2a 2f UCE this Expr */
17d20 0a 23 64 65 66 69 6e 65 20 45 50 5f 55 6e 6c 69 .#define EP_Unli
17d30 6b 65 6c 79 20 20 30 78 30 34 30 30 30 30 20 2f kely 0x040000 /
17d40 2a 20 75 6e 6c 69 6b 65 6c 79 28 29 20 6f 72 20 * unlikely() or
17d50 6c 69 6b 65 6c 69 68 6f 6f 64 28 29 20 66 75 6e likelihood() fun
17d60 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 ction */.#define
17d70 20 45 50 5f 43 6f 6e 73 74 46 75 6e 63 20 30 78 EP_ConstFunc 0x
17d80 30 38 30 30 30 30 20 2f 2a 20 41 20 53 51 4c 49 080000 /* A SQLI
17d90 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 TE_FUNC_CONSTANT
17da0 20 6f 72 20 5f 53 4c 4f 43 48 4e 47 20 66 75 6e or _SLOCHNG fun
17db0 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 ction */.#define
17dc0 20 45 50 5f 43 61 6e 42 65 4e 75 6c 6c 20 30 78 EP_CanBeNull 0x
17dd0 31 30 30 30 30 30 20 2f 2a 20 43 61 6e 20 62 65 100000 /* Can be
17de0 20 6e 75 6c 6c 20 64 65 73 70 69 74 65 20 4e 4f null despite NO
17df0 54 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e T NULL constrain
17e00 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f t */.#define EP_
17e10 53 75 62 71 75 65 72 79 20 20 30 78 32 30 30 30 Subquery 0x2000
17e20 30 30 20 2f 2a 20 54 72 65 65 20 63 6f 6e 74 61 00 /* Tree conta
17e30 69 6e 73 20 61 20 54 4b 5f 53 45 4c 45 43 54 20 ins a TK_SELECT
17e40 6f 70 65 72 61 74 6f 72 20 2a 2f 0a 23 64 65 66 operator */.#def
17e50 69 6e 65 20 45 50 5f 41 6c 69 61 73 20 20 20 20 ine EP_Alias
17e60 20 30 78 34 30 30 30 30 30 20 2f 2a 20 49 73 20 0x400000 /* Is
17e70 61 6e 20 61 6c 69 61 73 20 66 6f 72 20 61 20 72 an alias for a r
17e80 65 73 75 6c 74 20 73 65 74 20 63 6f 6c 75 6d 6e esult set column
17e90 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 62 69 */../*.** Combi
17ea0 6e 61 74 69 6f 6e 73 20 6f 66 20 74 77 6f 20 6f nations of two o
17eb0 72 20 6d 6f 72 65 20 45 50 5f 2a 20 66 6c 61 67 r more EP_* flag
17ec0 73 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f s.*/.#define EP_
17ed0 50 72 6f 70 61 67 61 74 65 20 28 45 50 5f 43 6f Propagate (EP_Co
17ee0 6c 6c 61 74 65 7c 45 50 5f 53 75 62 71 75 65 72 llate|EP_Subquer
17ef0 79 29 20 2f 2a 20 50 72 6f 70 61 67 61 74 65 20 y) /* Propagate
17f00 74 68 65 73 65 20 62 69 74 73 20 75 70 20 74 72 these bits up tr
17f10 65 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 ee */../*.** The
17f20 73 65 20 6d 61 63 72 6f 73 20 63 61 6e 20 62 65 se macros can be
17f30 20 75 73 65 64 20 74 6f 20 74 65 73 74 2c 20 73 used to test, s
17f40 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 62 69 74 et, or clear bit
17f50 73 20 69 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 s in the.** Expr
17f60 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f .flags field..*/
17f70 0a 23 64 65 66 69 6e 65 20 45 78 70 72 48 61 73 .#define ExprHas
17f80 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 Property(E,P)
17f90 20 20 28 28 28 45 29 2d 3e 66 6c 61 67 73 26 28 (((E)->flags&(
17fa0 50 29 29 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 P))!=0).#define
17fb0 45 78 70 72 48 61 73 41 6c 6c 50 72 6f 70 65 72 ExprHasAllProper
17fc0 74 79 28 45 2c 50 29 20 20 28 28 28 45 29 2d 3e ty(E,P) (((E)->
17fd0 66 6c 61 67 73 26 28 50 29 29 3d 3d 28 50 29 29 flags&(P))==(P))
17fe0 0a 23 64 65 66 69 6e 65 20 45 78 70 72 53 65 74 .#define ExprSet
17ff0 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 Property(E,P)
18000 20 20 28 45 29 2d 3e 66 6c 61 67 73 7c 3d 28 50 (E)->flags|=(P
18010 29 0a 23 64 65 66 69 6e 65 20 45 78 70 72 43 6c ).#define ExprCl
18020 65 61 72 50 72 6f 70 65 72 74 79 28 45 2c 50 29 earProperty(E,P)
18030 20 20 20 28 45 29 2d 3e 66 6c 61 67 73 26 3d 7e (E)->flags&=~
18040 28 50 29 0a 0a 2f 2a 20 54 68 65 20 45 78 70 72 (P)../* The Expr
18050 53 65 74 56 56 41 50 72 6f 70 65 72 74 79 28 29 SetVVAProperty()
18060 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 66 macro is used f
18070 6f 72 20 56 65 72 69 66 69 63 61 74 69 6f 6e 2c or Verification,
18080 20 56 61 6c 69 64 61 74 69 6f 6e 2c 0a 2a 2a 20 Validation,.**
18090 61 6e 64 20 41 63 63 72 65 64 69 74 61 74 69 6f and Accreditatio
180a0 6e 20 6f 6e 6c 79 2e 20 20 49 74 20 77 6f 72 6b n only. It work
180b0 73 20 6c 69 6b 65 20 45 78 70 72 53 65 74 50 72 s like ExprSetPr
180c0 6f 70 65 72 74 79 28 29 20 64 75 72 69 6e 67 20 operty() during
180d0 56 56 41 0a 2a 2a 20 70 72 6f 63 65 73 73 65 73 VVA.** processes
180e0 20 62 75 74 20 69 73 20 61 20 6e 6f 2d 6f 70 20 but is a no-op
180f0 66 6f 72 20 64 65 6c 69 76 65 72 79 2e 0a 2a 2f for delivery..*/
18100 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
18110 45 42 55 47 0a 23 20 64 65 66 69 6e 65 20 45 78 EBUG.# define Ex
18120 70 72 53 65 74 56 56 41 50 72 6f 70 65 72 74 79 prSetVVAProperty
18130 28 45 2c 50 29 20 20 28 45 29 2d 3e 66 6c 61 67 (E,P) (E)->flag
18140 73 7c 3d 28 50 29 0a 23 65 6c 73 65 0a 23 20 64 s|=(P).#else.# d
18150 65 66 69 6e 65 20 45 78 70 72 53 65 74 56 56 41 efine ExprSetVVA
18160 50 72 6f 70 65 72 74 79 28 45 2c 50 29 0a 23 65 Property(E,P).#e
18170 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 ndif../*.** Macr
18180 6f 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 os to determine
18190 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 the number of by
181a0 74 65 73 20 72 65 71 75 69 72 65 64 20 62 79 20 tes required by
181b0 61 20 6e 6f 72 6d 61 6c 20 45 78 70 72 0a 2a 2a a normal Expr.**
181c0 20 73 74 72 75 63 74 2c 20 61 6e 20 45 78 70 72 struct, an Expr
181d0 20 73 74 72 75 63 74 20 77 69 74 68 20 74 68 65 struct with the
181e0 20 45 50 5f 52 65 64 75 63 65 64 20 66 6c 61 67 EP_Reduced flag
181f0 20 73 65 74 20 69 6e 20 45 78 70 72 2e 66 6c 61 set in Expr.fla
18200 67 73 0a 2a 2a 20 61 6e 64 20 61 6e 20 45 78 70 gs.** and an Exp
18210 72 20 73 74 72 75 63 74 20 77 69 74 68 20 74 68 r struct with th
18220 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 e EP_TokenOnly f
18230 6c 61 67 20 73 65 74 2e 0a 2a 2f 0a 23 64 65 66 lag set..*/.#def
18240 69 6e 65 20 45 58 50 52 5f 46 55 4c 4c 53 49 5a ine EXPR_FULLSIZ
18250 45 20 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 E size
18260 6f 66 28 45 78 70 72 29 20 20 20 20 20 20 20 20 of(Expr)
18270 20 20 20 2f 2a 20 46 75 6c 6c 20 73 69 7a 65 20 /* Full size
18280 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 5f */.#define EXPR_
18290 52 45 44 55 43 45 44 53 49 5a 45 20 20 20 20 20 REDUCEDSIZE
182a0 20 20 20 6f 66 66 73 65 74 6f 66 28 45 78 70 72 offsetof(Expr
182b0 2c 69 54 61 62 6c 65 29 20 20 2f 2a 20 43 6f 6d ,iTable) /* Com
182c0 6d 6f 6e 20 66 65 61 74 75 72 65 73 20 2a 2f 0a mon features */.
182d0 23 64 65 66 69 6e 65 20 45 58 50 52 5f 54 4f 4b #define EXPR_TOK
182e0 45 4e 4f 4e 4c 59 53 49 5a 45 20 20 20 20 20 20 ENONLYSIZE
182f0 6f 66 66 73 65 74 6f 66 28 45 78 70 72 2c 70 4c offsetof(Expr,pL
18300 65 66 74 29 20 20 20 2f 2a 20 46 65 77 65 72 20 eft) /* Fewer
18310 66 65 61 74 75 72 65 73 20 2a 2f 0a 0a 2f 2a 0a features */../*.
18320 2a 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 ** Flags passed
18330 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 45 78 to the sqlite3Ex
18340 70 72 44 75 70 28 29 20 66 75 6e 63 74 69 6f 6e prDup() function
18350 2e 20 53 65 65 20 74 68 65 20 68 65 61 64 65 72 . See the header
18360 20 63 6f 6d 6d 65 6e 74 0a 2a 2a 20 61 62 6f 76 comment.** abov
18370 65 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 e sqlite3ExprDup
18380 28 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a () for details..
18390 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 44 */.#define EXPRD
183a0 55 50 5f 52 45 44 55 43 45 20 20 20 20 20 20 20 UP_REDUCE
183b0 20 20 30 78 30 30 30 31 20 20 2f 2a 20 55 73 65 0x0001 /* Use
183c0 64 20 72 65 64 75 63 65 64 2d 73 69 7a 65 20 45 d reduced-size E
183d0 78 70 72 20 6e 6f 64 65 73 20 2a 2f 0a 0a 2f 2a xpr nodes */../*
183e0 0a 2a 2a 20 41 20 6c 69 73 74 20 6f 66 20 65 78 .** A list of ex
183f0 70 72 65 73 73 69 6f 6e 73 2e 20 20 45 61 63 68 pressions. Each
18400 20 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 79 20 expression may
18410 6f 70 74 69 6f 6e 61 6c 6c 79 20 68 61 76 65 20 optionally have
18420 61 0a 2a 2a 20 6e 61 6d 65 2e 20 20 41 6e 20 65 a.** name. An e
18430 78 70 72 2f 6e 61 6d 65 20 63 6f 6d 62 69 6e 61 xpr/name combina
18440 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 tion can be used
18450 20 69 6e 20 73 65 76 65 72 61 6c 20 77 61 79 73 in several ways
18460 2c 20 73 75 63 68 0a 2a 2a 20 61 73 20 74 68 65 , such.** as the
18470 20 6c 69 73 74 20 6f 66 20 22 65 78 70 72 20 41 list of "expr A
18480 53 20 49 44 22 20 66 69 65 6c 64 73 20 66 6f 6c S ID" fields fol
18490 6c 6f 77 69 6e 67 20 61 20 22 53 45 4c 45 43 54 lowing a "SELECT
184a0 22 20 6f 72 20 69 6e 20 74 68 65 0a 2a 2a 20 6c " or in the.** l
184b0 69 73 74 20 6f 66 20 22 49 44 20 3d 20 65 78 70 ist of "ID = exp
184c0 72 22 20 69 74 65 6d 73 20 69 6e 20 61 6e 20 55 r" items in an U
184d0 50 44 41 54 45 2e 20 20 41 20 6c 69 73 74 20 6f PDATE. A list o
184e0 66 20 65 78 70 72 65 73 73 69 6f 6e 73 20 63 61 f expressions ca
184f0 6e 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 75 73 65 n.** also be use
18500 64 20 61 73 20 74 68 65 20 61 72 67 75 6d 65 6e d as the argumen
18510 74 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 2c t to a function,
18520 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 in which case t
18530 68 65 20 61 2e 7a 4e 61 6d 65 0a 2a 2a 20 66 69 he a.zName.** fi
18540 65 6c 64 20 69 73 20 6e 6f 74 20 75 73 65 64 2e eld is not used.
18550 0a 2a 2a 0a 2a 2a 20 42 79 20 64 65 66 61 75 6c .**.** By defaul
18560 74 20 74 68 65 20 45 78 70 72 2e 7a 53 70 61 6e t the Expr.zSpan
18570 20 66 69 65 6c 64 20 68 6f 6c 64 73 20 61 20 68 field holds a h
18580 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65 20 64 65 uman-readable de
18590 73 63 72 69 70 74 69 6f 6e 20 6f 66 0a 2a 2a 20 scription of.**
185a0 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 74 the expression t
185b0 68 61 74 20 69 73 20 75 73 65 64 20 69 6e 20 74 hat is used in t
185c0 68 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 he generation of
185d0 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 error messages
185e0 61 6e 64 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6c 61 and.** column la
185f0 62 65 6c 73 2e 20 20 49 6e 20 74 68 69 73 20 63 bels. In this c
18600 61 73 65 2c 20 45 78 70 72 2e 7a 53 70 61 6e 20 ase, Expr.zSpan
18610 69 73 20 74 79 70 69 63 61 6c 6c 79 20 74 68 65 is typically the
18620 20 74 65 78 74 20 6f 66 20 61 0a 2a 2a 20 63 6f text of a.** co
18630 6c 75 6d 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 lumn expression
18640 61 73 20 69 74 20 65 78 69 73 74 73 20 69 6e 20 as it exists in
18650 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 a SELECT stateme
18660 6e 74 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 66 nt. However, if
18670 0a 2a 2a 20 74 68 65 20 62 53 70 61 6e 49 73 54 .** the bSpanIsT
18680 61 62 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 ab flag is set,
18690 74 68 65 6e 20 7a 53 70 61 6e 20 69 73 20 6f 76 then zSpan is ov
186a0 65 72 6c 6f 61 64 65 64 20 74 6f 20 6d 65 61 6e erloaded to mean
186b0 20 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 6f 66 20 the name.** of
186c0 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d the result colum
186d0 6e 20 69 6e 20 74 68 65 20 66 6f 72 6d 3a 20 44 n in the form: D
186e0 41 54 41 42 41 53 45 2e 54 41 42 4c 45 2e 43 4f ATABASE.TABLE.CO
186f0 4c 55 4d 4e 2e 20 20 54 68 69 73 20 6c 61 74 65 LUMN. This late
18700 72 0a 2a 2a 20 66 6f 72 6d 20 69 73 20 75 73 65 r.** form is use
18710 64 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 6f 6c d for name resol
18720 75 74 69 6f 6e 20 77 69 74 68 20 6e 65 73 74 65 ution with neste
18730 64 20 46 52 4f 4d 20 63 6c 61 75 73 65 73 2e 0a d FROM clauses..
18740 2a 2f 0a 73 74 72 75 63 74 20 45 78 70 72 4c 69 */.struct ExprLi
18750 73 74 20 7b 0a 20 20 69 6e 74 20 6e 45 78 70 72 st {. int nExpr
18760 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
18770 20 4e 75 6d 62 65 72 20 6f 66 20 65 78 70 72 65 Number of expre
18780 73 73 69 6f 6e 73 20 6f 6e 20 74 68 65 20 6c 69 ssions on the li
18790 73 74 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 45 st */. struct E
187a0 78 70 72 4c 69 73 74 5f 69 74 65 6d 20 7b 20 2f xprList_item { /
187b0 2a 20 46 6f 72 20 65 61 63 68 20 65 78 70 72 65 * For each expre
187c0 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 6c 69 73 ssion in the lis
187d0 74 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 t */. Expr *p
187e0 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 Expr;
187f0 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 /* The list of
18800 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
18810 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 char *zName;
18820 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f /* To
18830 6b 65 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 ken associated w
18840 69 74 68 20 74 68 69 73 20 65 78 70 72 65 73 73 ith this express
18850 69 6f 6e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 ion */. char
18860 2a 7a 53 70 61 6e 3b 20 20 20 20 20 20 20 20 20 *zSpan;
18870 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 74 /* Original t
18880 65 78 74 20 6f 66 20 74 68 65 20 65 78 70 72 65 ext of the expre
18890 73 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 75 38 20 ssion */. u8
188a0 73 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 20 20 sortOrder;
188b0 20 20 20 20 20 2f 2a 20 31 20 66 6f 72 20 44 45 /* 1 for DE
188c0 53 43 20 6f 72 20 30 20 66 6f 72 20 41 53 43 20 SC or 0 for ASC
188d0 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 */. unsigned
188e0 64 6f 6e 65 20 3a 31 3b 20 20 20 20 20 20 20 2f done :1; /
188f0 2a 20 41 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 * A flag to indi
18900 63 61 74 65 20 77 68 65 6e 20 70 72 6f 63 65 73 cate when proces
18910 73 69 6e 67 20 69 73 20 66 69 6e 69 73 68 65 64 sing is finished
18920 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 */. unsigned
18930 20 62 53 70 61 6e 49 73 54 61 62 20 3a 31 3b 20 bSpanIsTab :1;
18940 2f 2a 20 7a 53 70 61 6e 20 68 6f 6c 64 73 20 44 /* zSpan holds D
18950 42 2e 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 20 2a B.TABLE.COLUMN *
18960 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 72 /. unsigned r
18970 65 75 73 61 62 6c 65 20 3a 31 3b 20 20 20 2f 2a eusable :1; /*
18980 20 43 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 Constant expres
18990 73 69 6f 6e 20 69 73 20 72 65 75 73 61 62 6c 65 sion is reusable
189a0 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 20 7b 0a */. union {.
189b0 20 20 20 20 20 20 73 74 72 75 63 74 20 7b 0a 20 struct {.
189c0 20 20 20 20 20 20 20 75 31 36 20 69 4f 72 64 65 u16 iOrde
189d0 72 42 79 43 6f 6c 3b 20 20 20 20 20 20 2f 2a 20 rByCol; /*
189e0 46 6f 72 20 4f 52 44 45 52 20 42 59 2c 20 63 6f For ORDER BY, co
189f0 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 72 lumn number in r
18a00 65 73 75 6c 74 20 73 65 74 20 2a 2f 0a 20 20 20 esult set */.
18a10 20 20 20 20 20 75 31 36 20 69 41 6c 69 61 73 3b u16 iAlias;
18a20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
18a30 64 65 78 20 69 6e 74 6f 20 50 61 72 73 65 2e 61 dex into Parse.a
18a40 41 6c 69 61 73 5b 5d 20 66 6f 72 20 7a 4e 61 6d Alias[] for zNam
18a50 65 20 2a 2f 0a 20 20 20 20 20 20 7d 20 78 3b 0a e */. } x;.
18a60 20 20 20 20 20 20 69 6e 74 20 69 43 6f 6e 73 74 int iConst
18a70 45 78 70 72 52 65 67 3b 20 20 20 20 20 20 2f 2a ExprReg; /*
18a80 20 52 65 67 69 73 74 65 72 20 69 6e 20 77 68 69 Register in whi
18a90 63 68 20 45 78 70 72 20 76 61 6c 75 65 20 69 73 ch Expr value is
18aa0 20 63 61 63 68 65 64 20 2a 2f 0a 20 20 20 20 7d cached */. }
18ab0 20 75 3b 0a 20 20 7d 20 2a 61 3b 20 20 20 20 20 u;. } *a;
18ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
18ad0 41 6c 6c 6f 63 20 61 20 70 6f 77 65 72 20 6f 66 Alloc a power of
18ae0 20 74 77 6f 20 67 72 65 61 74 65 72 20 6f 72 20 two greater or
18af0 65 71 75 61 6c 20 74 6f 20 6e 45 78 70 72 20 2a equal to nExpr *
18b00 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 /.};../*.** An i
18b10 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 nstance of this
18b20 73 74 72 75 63 74 75 72 65 20 69 73 20 75 73 65 structure is use
18b30 64 20 62 79 20 74 68 65 20 70 61 72 73 65 72 20 d by the parser
18b40 74 6f 20 72 65 63 6f 72 64 20 62 6f 74 68 0a 2a to record both.*
18b50 2a 20 74 68 65 20 70 61 72 73 65 20 74 72 65 65 * the parse tree
18b60 20 66 6f 72 20 61 6e 20 65 78 70 72 65 73 73 69 for an expressi
18b70 6f 6e 20 61 6e 64 20 74 68 65 20 73 70 61 6e 20 on and the span
18b80 6f 66 20 69 6e 70 75 74 20 74 65 78 74 20 66 6f of input text fo
18b90 72 20 61 6e 0a 2a 2a 20 65 78 70 72 65 73 73 69 r an.** expressi
18ba0 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 on..*/.struct Ex
18bb0 70 72 53 70 61 6e 20 7b 0a 20 20 45 78 70 72 20 prSpan {. Expr
18bc0 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 *pExpr;
18bd0 20 2f 2a 20 54 68 65 20 65 78 70 72 65 73 73 69 /* The expressi
18be0 6f 6e 20 70 61 72 73 65 20 74 72 65 65 20 2a 2f on parse tree */
18bf0 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
18c00 53 74 61 72 74 3b 20 20 20 2f 2a 20 46 69 72 73 Start; /* Firs
18c10 74 20 63 68 61 72 61 63 74 65 72 20 6f 66 20 69 t character of i
18c20 6e 70 75 74 20 74 65 78 74 20 2a 2f 0a 20 20 63 nput text */. c
18c30 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 6e 64 3b onst char *zEnd;
18c40 20 20 20 20 20 2f 2a 20 4f 6e 65 20 63 68 61 72 /* One char
18c50 61 63 74 65 72 20 70 61 73 74 20 74 68 65 20 65 acter past the e
18c60 6e 64 20 6f 66 20 69 6e 70 75 74 20 74 65 78 74 nd of input text
18c70 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
18c80 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 instance of thi
18c90 73 20 73 74 72 75 63 74 75 72 65 20 63 61 6e 20 s structure can
18ca0 68 6f 6c 64 20 61 20 73 69 6d 70 6c 65 20 6c 69 hold a simple li
18cb0 73 74 20 6f 66 20 69 64 65 6e 74 69 66 69 65 72 st of identifier
18cc0 73 2c 0a 2a 2a 20 73 75 63 68 20 61 73 20 74 68 s,.** such as th
18cd0 65 20 6c 69 73 74 20 22 61 2c 62 2c 63 22 20 69 e list "a,b,c" i
18ce0 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 n the following
18cf0 73 74 61 74 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a statements:.**.*
18d00 2a 20 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e * INSERT IN
18d10 54 4f 20 74 28 61 2c 62 2c 63 29 20 56 41 4c 55 TO t(a,b,c) VALU
18d20 45 53 20 2e 2e 2e 3b 0a 2a 2a 20 20 20 20 20 20 ES ...;.**
18d30 43 52 45 41 54 45 20 49 4e 44 45 58 20 69 64 78 CREATE INDEX idx
18d40 20 4f 4e 20 74 28 61 2c 62 2c 63 29 3b 0a 2a 2a ON t(a,b,c);.**
18d50 20 20 20 20 20 20 43 52 45 41 54 45 20 54 52 49 CREATE TRI
18d60 47 47 45 52 20 74 72 69 67 20 42 45 46 4f 52 45 GGER trig BEFORE
18d70 20 55 50 44 41 54 45 20 4f 4e 20 74 28 61 2c 62 UPDATE ON t(a,b
18d80 2c 63 29 20 2e 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 ,c) ...;.**.** T
18d90 68 65 20 49 64 4c 69 73 74 2e 61 2e 69 64 78 20 he IdList.a.idx
18da0 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 77 68 field is used wh
18db0 65 6e 20 74 68 65 20 49 64 4c 69 73 74 20 72 65 en the IdList re
18dc0 70 72 65 73 65 6e 74 73 20 74 68 65 20 6c 69 73 presents the lis
18dd0 74 20 6f 66 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6e t of.** column n
18de0 61 6d 65 73 20 61 66 74 65 72 20 61 20 74 61 62 ames after a tab
18df0 6c 65 20 6e 61 6d 65 20 69 6e 20 61 6e 20 49 4e le name in an IN
18e00 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 SERT statement.
18e10 20 49 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e In the statemen
18e20 74 0a 2a 2a 0a 2a 2a 20 20 20 20 20 49 4e 53 45 t.**.** INSE
18e30 52 54 20 49 4e 54 4f 20 74 28 61 2c 62 2c 63 29 RT INTO t(a,b,c)
18e40 20 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 22 61 ....**.** If "a
18e50 22 20 69 73 20 74 68 65 20 6b 2d 74 68 20 63 6f " is the k-th co
18e60 6c 75 6d 6e 20 6f 66 20 74 61 62 6c 65 20 22 74 lumn of table "t
18e70 22 2c 20 74 68 65 6e 20 49 64 4c 69 73 74 2e 61 ", then IdList.a
18e80 5b 30 5d 2e 69 64 78 3d 3d 6b 2e 0a 2a 2f 0a 73 [0].idx==k..*/.s
18e90 74 72 75 63 74 20 49 64 4c 69 73 74 20 7b 0a 20 truct IdList {.
18ea0 20 73 74 72 75 63 74 20 49 64 4c 69 73 74 5f 69 struct IdList_i
18eb0 74 65 6d 20 7b 0a 20 20 20 20 63 68 61 72 20 2a tem {. char *
18ec0 7a 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 4e zName; /* N
18ed0 61 6d 65 20 6f 66 20 74 68 65 20 69 64 65 6e 74 ame of the ident
18ee0 69 66 69 65 72 20 2a 2f 0a 20 20 20 20 69 6e 74 ifier */. int
18ef0 20 69 64 78 3b 20 20 20 20 20 20 20 20 20 20 2f idx; /
18f00 2a 20 49 6e 64 65 78 20 69 6e 20 73 6f 6d 65 20 * Index in some
18f10 54 61 62 6c 65 2e 61 43 6f 6c 5b 5d 20 6f 66 20 Table.aCol[] of
18f20 61 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 64 20 7a a column named z
18f30 4e 61 6d 65 20 2a 2f 0a 20 20 7d 20 2a 61 3b 0a Name */. } *a;.
18f40 20 20 69 6e 74 20 6e 49 64 3b 20 20 20 20 20 20 int nId;
18f50 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
18f60 69 64 65 6e 74 69 66 69 65 72 73 20 6f 6e 20 74 identifiers on t
18f70 68 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f he list */.};../
18f80 2a 0a 2a 2a 20 54 68 65 20 62 69 74 6d 61 73 6b *.** The bitmask
18f90 20 64 61 74 61 74 79 70 65 20 64 65 66 69 6e 65 datatype define
18fa0 64 20 62 65 6c 6f 77 20 69 73 20 75 73 65 64 20 d below is used
18fb0 66 6f 72 20 76 61 72 69 6f 75 73 20 6f 70 74 69 for various opti
18fc0 6d 69 7a 61 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a mizations..**.**
18fd0 20 43 68 61 6e 67 69 6e 67 20 74 68 69 73 20 66 Changing this f
18fe0 72 6f 6d 20 61 20 36 34 2d 62 69 74 20 74 6f 20 rom a 64-bit to
18ff0 61 20 33 32 2d 62 69 74 20 74 79 70 65 20 6c 69 a 32-bit type li
19000 6d 69 74 73 20 74 68 65 20 6e 75 6d 62 65 72 20 mits the number
19010 6f 66 0a 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 of.** tables in
19020 61 20 6a 6f 69 6e 20 74 6f 20 33 32 20 69 6e 73 a join to 32 ins
19030 74 65 61 64 20 6f 66 20 36 34 2e 20 20 42 75 74 tead of 64. But
19040 20 69 74 20 61 6c 73 6f 20 72 65 64 75 63 65 73 it also reduces
19050 20 74 68 65 20 73 69 7a 65 0a 2a 2a 20 6f 66 20 the size.** of
19060 74 68 65 20 6c 69 62 72 61 72 79 20 62 79 20 37 the library by 7
19070 33 38 20 62 79 74 65 73 20 6f 6e 20 69 78 38 36 38 bytes on ix86
19080 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
19090 54 45 5f 42 49 54 4d 41 53 4b 5f 54 59 50 45 0a TE_BITMASK_TYPE.
190a0 20 20 74 79 70 65 64 65 66 20 53 51 4c 49 54 45 typedef SQLITE
190b0 5f 42 49 54 4d 41 53 4b 5f 54 59 50 45 20 42 69 _BITMASK_TYPE Bi
190c0 74 6d 61 73 6b 3b 0a 23 65 6c 73 65 0a 20 20 74 tmask;.#else. t
190d0 79 70 65 64 65 66 20 75 36 34 20 42 69 74 6d 61 ypedef u64 Bitma
190e0 73 6b 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a sk;.#endif../*.*
190f0 2a 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 * The number of
19100 62 69 74 73 20 69 6e 20 61 20 42 69 74 6d 61 73 bits in a Bitmas
19110 6b 2e 20 20 22 42 4d 53 22 20 6d 65 61 6e 73 20 k. "BMS" means
19120 22 42 69 74 4d 61 73 6b 20 53 69 7a 65 22 2e 0a "BitMask Size"..
19130 2a 2f 0a 23 64 65 66 69 6e 65 20 42 4d 53 20 20 */.#define BMS
19140 28 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 42 69 ((int)(sizeof(Bi
19150 74 6d 61 73 6b 29 2a 38 29 29 0a 0a 2f 2a 0a 2a tmask)*8))../*.*
19160 2a 20 41 20 62 69 74 20 69 6e 20 61 20 42 69 74 * A bit in a Bit
19170 6d 61 73 6b 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 mask.*/.#define
19180 4d 41 53 4b 42 49 54 28 6e 29 20 20 20 28 28 28 MASKBIT(n) (((
19190 42 69 74 6d 61 73 6b 29 31 29 3c 3c 28 6e 29 29 Bitmask)1)<<(n))
191a0 0a 23 64 65 66 69 6e 65 20 4d 41 53 4b 42 49 54 .#define MASKBIT
191b0 33 32 28 6e 29 20 28 28 28 75 6e 73 69 67 6e 65 32(n) (((unsigne
191c0 64 20 69 6e 74 29 31 29 3c 3c 28 6e 29 29 0a 23 d int)1)<<(n)).#
191d0 64 65 66 69 6e 65 20 41 4c 4c 42 49 54 53 20 20 define ALLBITS
191e0 20 20 20 20 28 28 42 69 74 6d 61 73 6b 29 2d 31 ((Bitmask)-1
191f0 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c )../*.** The fol
19200 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 lowing structure
19210 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20 46 describes the F
19220 52 4f 4d 20 63 6c 61 75 73 65 20 6f 66 20 61 20 ROM clause of a
19230 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 SELECT statement
19240 2e 0a 2a 2a 20 45 61 63 68 20 74 61 62 6c 65 20 ..** Each table
19250 6f 72 20 73 75 62 71 75 65 72 79 20 69 6e 20 74 or subquery in t
19260 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 69 he FROM clause i
19270 73 20 61 20 73 65 70 61 72 61 74 65 20 65 6c 65 s a separate ele
19280 6d 65 6e 74 20 6f 66 0a 2a 2a 20 74 68 65 20 53 ment of.** the S
19290 72 63 4c 69 73 74 2e 61 5b 5d 20 61 72 72 61 79 rcList.a[] array
192a0 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 68 20 74 68 65 ..**.** With the
192b0 20 61 64 64 69 74 69 6f 6e 20 6f 66 20 6d 75 6c addition of mul
192c0 74 69 70 6c 65 20 64 61 74 61 62 61 73 65 20 73 tiple database s
192d0 75 70 70 6f 72 74 2c 20 74 68 65 20 66 6f 6c 6c upport, the foll
192e0 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 0a owing structure.
192f0 2a 2a 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 75 ** can also be u
19300 73 65 64 20 74 6f 20 64 65 73 63 72 69 62 65 20 sed to describe
19310 61 20 70 61 72 74 69 63 75 6c 61 72 20 74 61 62 a particular tab
19320 6c 65 20 73 75 63 68 20 61 73 20 74 68 65 20 74 le such as the t
19330 61 62 6c 65 20 74 68 61 74 0a 2a 2a 20 69 73 20 able that.** is
19340 6d 6f 64 69 66 69 65 64 20 62 79 20 61 6e 20 49 modified by an I
19350 4e 53 45 52 54 2c 20 44 45 4c 45 54 45 2c 20 6f NSERT, DELETE, o
19360 72 20 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 r UPDATE stateme
19370 6e 74 2e 20 20 49 6e 20 73 74 61 6e 64 61 72 64 nt. In standard
19380 20 53 51 4c 2c 0a 2a 2a 20 73 75 63 68 20 61 20 SQL,.** such a
19390 74 61 62 6c 65 20 6d 75 73 74 20 62 65 20 61 20 table must be a
193a0 73 69 6d 70 6c 65 20 6e 61 6d 65 3a 20 49 44 2e simple name: ID.
193b0 20 20 42 75 74 20 69 6e 20 53 51 4c 69 74 65 2c But in SQLite,
193c0 20 74 68 65 20 74 61 62 6c 65 20 63 61 6e 0a 2a the table can.*
193d0 2a 20 6e 6f 77 20 62 65 20 69 64 65 6e 74 69 66 * now be identif
193e0 69 65 64 20 62 79 20 61 20 64 61 74 61 62 61 73 ied by a databas
193f0 65 20 6e 61 6d 65 2c 20 61 20 64 6f 74 2c 20 74 e name, a dot, t
19400 68 65 6e 20 74 68 65 20 74 61 62 6c 65 20 6e 61 hen the table na
19410 6d 65 3a 20 49 44 2e 49 44 2e 0a 2a 2a 0a 2a 2a me: ID.ID..**.**
19420 20 54 68 65 20 6a 6f 69 6e 74 79 70 65 20 73 74 The jointype st
19430 61 72 74 73 20 6f 75 74 20 73 68 6f 77 69 6e 67 arts out showing
19440 20 74 68 65 20 6a 6f 69 6e 20 74 79 70 65 20 62 the join type b
19450 65 74 77 65 65 6e 20 74 68 65 20 63 75 72 72 65 etween the curre
19460 6e 74 20 74 61 62 6c 65 0a 2a 2a 20 61 6e 64 20 nt table.** and
19470 74 68 65 20 6e 65 78 74 20 74 61 62 6c 65 20 6f the next table o
19480 6e 20 74 68 65 20 6c 69 73 74 2e 20 20 54 68 65 n the list. The
19490 20 70 61 72 73 65 72 20 62 75 69 6c 64 73 20 74 parser builds t
194a0 68 65 20 6c 69 73 74 20 74 68 69 73 20 77 61 79 he list this way
194b0 2e 0a 2a 2a 20 42 75 74 20 73 71 6c 69 74 65 33 ..** But sqlite3
194c0 53 72 63 4c 69 73 74 53 68 69 66 74 4a 6f 69 6e SrcListShiftJoin
194d0 54 79 70 65 28 29 20 6c 61 74 65 72 20 73 68 69 Type() later shi
194e0 66 74 73 20 74 68 65 20 6a 6f 69 6e 74 79 70 65 fts the jointype
194f0 73 20 73 6f 20 74 68 61 74 20 65 61 63 68 0a 2a s so that each.*
19500 2a 20 6a 6f 69 6e 74 79 70 65 20 65 78 70 72 65 * jointype expre
19510 73 73 65 73 20 74 68 65 20 6a 6f 69 6e 20 62 65 sses the join be
19520 74 77 65 65 6e 20 74 68 65 20 74 61 62 6c 65 20 tween the table
19530 61 6e 64 20 74 68 65 20 70 72 65 76 69 6f 75 73 and the previous
19540 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 6e table..**.** In
19550 20 74 68 65 20 63 6f 6c 55 73 65 64 20 66 69 65 the colUsed fie
19560 6c 64 2c 20 74 68 65 20 68 69 67 68 2d 6f 72 64 ld, the high-ord
19570 65 72 20 62 69 74 20 28 62 69 74 20 36 33 29 20 er bit (bit 63)
19580 69 73 20 73 65 74 20 69 66 20 74 68 65 20 74 61 is set if the ta
19590 62 6c 65 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 ble.** contains
195a0 6d 6f 72 65 20 74 68 61 6e 20 36 33 20 63 6f 6c more than 63 col
195b0 75 6d 6e 73 20 61 6e 64 20 74 68 65 20 36 34 2d umns and the 64-
195c0 74 68 20 6f 72 20 6c 61 74 65 72 20 63 6f 6c 75 th or later colu
195d0 6d 6e 20 69 73 20 75 73 65 64 2e 0a 2a 2f 0a 73 mn is used..*/.s
195e0 74 72 75 63 74 20 53 72 63 4c 69 73 74 20 7b 0a truct SrcList {.
195f0 20 20 69 6e 74 20 6e 53 72 63 3b 20 20 20 20 20 int nSrc;
19600 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
19610 74 61 62 6c 65 73 20 6f 72 20 73 75 62 71 75 65 tables or subque
19620 72 69 65 73 20 69 6e 20 74 68 65 20 46 52 4f 4d ries in the FROM
19630 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 75 33 32 clause */. u32
19640 20 6e 41 6c 6c 6f 63 3b 20 20 20 20 20 20 2f 2a nAlloc; /*
19650 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 Number of entri
19660 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 es allocated in
19670 61 5b 5d 20 62 65 6c 6f 77 20 2a 2f 0a 20 20 73 a[] below */. s
19680 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 truct SrcList_it
19690 65 6d 20 7b 0a 20 20 20 20 53 63 68 65 6d 61 20 em {. Schema
196a0 2a 70 53 63 68 65 6d 61 3b 20 20 2f 2a 20 53 63 *pSchema; /* Sc
196b0 68 65 6d 61 20 74 6f 20 77 68 69 63 68 20 74 68 hema to which th
196c0 69 73 20 69 74 65 6d 20 69 73 20 66 69 78 65 64 is item is fixed
196d0 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 44 */. char *zD
196e0 61 74 61 62 61 73 65 3b 20 20 2f 2a 20 4e 61 6d atabase; /* Nam
196f0 65 20 6f 66 20 64 61 74 61 62 61 73 65 20 68 6f e of database ho
19700 6c 64 69 6e 67 20 74 68 69 73 20 74 61 62 6c 65 lding this table
19710 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 4e */. char *zN
19720 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 4e 61 6d ame; /* Nam
19730 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 2a e of the table *
19740 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 41 6c 69 /. char *zAli
19750 61 73 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 22 as; /* The "
19760 42 22 20 70 61 72 74 20 6f 66 20 61 20 22 41 20 B" part of a "A
19770 41 53 20 42 22 20 70 68 72 61 73 65 2e 20 20 7a AS B" phrase. z
19780 4e 61 6d 65 20 69 73 20 74 68 65 20 22 41 22 20 Name is the "A"
19790 2a 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 */. Table *pT
197a0 61 62 3b 20 20 20 20 20 20 2f 2a 20 41 6e 20 53 ab; /* An S
197b0 51 4c 20 74 61 62 6c 65 20 63 6f 72 72 65 73 70 QL table corresp
197c0 6f 6e 64 69 6e 67 20 74 6f 20 7a 4e 61 6d 65 20 onding to zName
197d0 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 */. Select *p
197e0 53 65 6c 65 63 74 3b 20 20 2f 2a 20 41 20 53 45 Select; /* A SE
197f0 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20 75 LECT statement u
19800 73 65 64 20 69 6e 20 70 6c 61 63 65 20 6f 66 20 sed in place of
19810 61 20 74 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a a table name */.
19820 20 20 20 20 69 6e 74 20 61 64 64 72 46 69 6c 6c int addrFill
19830 53 75 62 3b 20 20 2f 2a 20 41 64 64 72 65 73 73 Sub; /* Address
19840 20 6f 66 20 73 75 62 72 6f 75 74 69 6e 65 20 74 of subroutine t
19850 6f 20 6d 61 6e 69 66 65 73 74 20 61 20 73 75 62 o manifest a sub
19860 71 75 65 72 79 20 2a 2f 0a 20 20 20 20 69 6e 74 query */. int
19870 20 72 65 67 52 65 74 75 72 6e 3b 20 20 20 20 2f regReturn; /
19880 2a 20 52 65 67 69 73 74 65 72 20 68 6f 6c 64 69 * Register holdi
19890 6e 67 20 72 65 74 75 72 6e 20 61 64 64 72 65 73 ng return addres
198a0 73 20 6f 66 20 61 64 64 72 46 69 6c 6c 53 75 62 s of addrFillSub
198b0 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 52 */. int regR
198c0 65 73 75 6c 74 3b 20 20 20 20 2f 2a 20 52 65 67 esult; /* Reg
198d0 69 73 74 65 72 73 20 68 6f 6c 64 69 6e 67 20 72 isters holding r
198e0 65 73 75 6c 74 73 20 6f 66 20 61 20 63 6f 2d 72 esults of a co-r
198f0 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 20 20 73 74 outine */. st
19900 72 75 63 74 20 7b 0a 20 20 20 20 20 20 75 38 20 ruct {. u8
19910 6a 6f 69 6e 74 79 70 65 3b 20 20 20 20 20 20 2f jointype; /
19920 2a 20 54 79 70 65 20 6f 66 20 6a 6f 69 6e 20 62 * Type of join b
19930 65 74 77 65 65 6e 20 74 68 69 73 20 74 61 62 6c etween this tabl
19940 65 20 61 6e 64 20 74 68 65 20 70 72 65 76 69 6f e and the previo
19950 75 73 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 us */. unsi
19960 67 6e 65 64 20 6e 6f 74 49 6e 64 65 78 65 64 20 gned notIndexed
19970 3a 31 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69 :1; /* True i
19980 66 20 74 68 65 72 65 20 69 73 20 61 20 4e 4f 54 f there is a NOT
19990 20 49 4e 44 45 58 45 44 20 63 6c 61 75 73 65 20 INDEXED clause
199a0 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 */. unsigne
199b0 64 20 69 73 49 6e 64 65 78 65 64 42 79 20 3a 31 d isIndexedBy :1
199c0 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 ; /* True if t
199d0 68 65 72 65 20 69 73 20 61 6e 20 49 4e 44 45 58 here is an INDEX
199e0 45 44 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a ED BY clause */.
199f0 20 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 unsigned i
19a00 73 54 61 62 46 75 6e 63 20 3a 31 3b 20 20 20 20 sTabFunc :1;
19a10 20 2f 2a 20 54 72 75 65 20 69 66 20 74 61 62 6c /* True if tabl
19a20 65 2d 76 61 6c 75 65 64 2d 66 75 6e 63 74 69 6f e-valued-functio
19a30 6e 20 73 79 6e 74 61 78 20 2a 2f 0a 20 20 20 20 n syntax */.
19a40 20 20 75 6e 73 69 67 6e 65 64 20 69 73 43 6f 72 unsigned isCor
19a50 72 65 6c 61 74 65 64 20 3a 31 3b 20 20 2f 2a 20 related :1; /*
19a60 54 72 75 65 20 69 66 20 73 75 62 2d 71 75 65 72 True if sub-quer
19a70 79 20 69 73 20 63 6f 72 72 65 6c 61 74 65 64 20 y is correlated
19a80 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 */. unsigne
19a90 64 20 76 69 61 43 6f 72 6f 75 74 69 6e 65 20 3a d viaCoroutine :
19aa0 31 3b 20 20 2f 2a 20 49 6d 70 6c 65 6d 65 6e 74 1; /* Implement
19ab0 65 64 20 61 73 20 61 20 63 6f 2d 72 6f 75 74 69 ed as a co-routi
19ac0 6e 65 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 ne */. unsi
19ad0 67 6e 65 64 20 69 73 52 65 63 75 72 73 69 76 65 gned isRecursive
19ae0 20 3a 31 3b 20 20 20 2f 2a 20 54 72 75 65 20 66 :1; /* True f
19af0 6f 72 20 72 65 63 75 72 73 69 76 65 20 72 65 66 or recursive ref
19b00 65 72 65 6e 63 65 20 69 6e 20 57 49 54 48 20 2a erence in WITH *
19b10 2f 0a 20 20 20 20 7d 20 66 67 3b 0a 23 69 66 6e /. } fg;.#ifn
19b20 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
19b30 45 58 50 4c 41 49 4e 0a 20 20 20 20 75 38 20 69 EXPLAIN. u8 i
19b40 53 65 6c 65 63 74 49 64 3b 20 20 20 20 20 2f 2a SelectId; /*
19b50 20 49 66 20 70 53 65 6c 65 63 74 21 3d 30 2c 20 If pSelect!=0,
19b60 74 68 65 20 69 64 20 6f 66 20 74 68 65 20 73 75 the id of the su
19b70 62 2d 73 65 6c 65 63 74 20 69 6e 20 45 51 50 20 b-select in EQP
19b80 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 6e */.#endif. in
19b90 74 20 69 43 75 72 73 6f 72 3b 20 20 20 20 20 20 t iCursor;
19ba0 2f 2a 20 54 68 65 20 56 44 42 45 20 63 75 72 73 /* The VDBE curs
19bb0 6f 72 20 6e 75 6d 62 65 72 20 75 73 65 64 20 74 or number used t
19bc0 6f 20 61 63 63 65 73 73 20 74 68 69 73 20 74 61 o access this ta
19bd0 62 6c 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 ble */. Expr
19be0 2a 70 4f 6e 3b 20 20 20 20 20 20 20 20 2f 2a 20 *pOn; /*
19bf0 54 68 65 20 4f 4e 20 63 6c 61 75 73 65 20 6f 66 The ON clause of
19c00 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 49 a join */. I
19c10 64 4c 69 73 74 20 2a 70 55 73 69 6e 67 3b 20 20 dList *pUsing;
19c20 20 2f 2a 20 54 68 65 20 55 53 49 4e 47 20 63 6c /* The USING cl
19c30 61 75 73 65 20 6f 66 20 61 20 6a 6f 69 6e 20 2a ause of a join *
19c40 2f 0a 20 20 20 20 42 69 74 6d 61 73 6b 20 63 6f /. Bitmask co
19c50 6c 55 73 65 64 3b 20 20 2f 2a 20 42 69 74 20 4e lUsed; /* Bit N
19c60 20 28 31 3c 3c 4e 29 20 73 65 74 20 69 66 20 63 (1<<N) set if c
19c70 6f 6c 75 6d 6e 20 4e 20 6f 66 20 70 54 61 62 20 olumn N of pTab
19c80 69 73 20 75 73 65 64 20 2a 2f 0a 20 20 20 20 75 is used */. u
19c90 6e 69 6f 6e 20 7b 0a 20 20 20 20 20 20 63 68 61 nion {. cha
19ca0 72 20 2a 7a 49 6e 64 65 78 65 64 42 79 3b 20 20 r *zIndexedBy;
19cb0 20 20 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 20 /* Identifier
19cc0 66 72 6f 6d 20 22 49 4e 44 45 58 45 44 20 42 59 from "INDEXED BY
19cd0 20 3c 7a 49 6e 64 65 78 3e 22 20 63 6c 61 75 73 <zIndex>" claus
19ce0 65 20 2a 2f 0a 20 20 20 20 20 20 45 78 70 72 4c e */. ExprL
19cf0 69 73 74 20 2a 70 46 75 6e 63 41 72 67 3b 20 20 ist *pFuncArg;
19d00 2f 2a 20 41 72 67 75 6d 65 6e 74 73 20 74 6f 20 /* Arguments to
19d10 74 61 62 6c 65 2d 76 61 6c 75 65 64 2d 66 75 6e table-valued-fun
19d20 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 7d 20 75 ction */. } u
19d30 31 3b 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 1;. Index *pI
19d40 42 49 6e 64 65 78 3b 20 20 2f 2a 20 49 6e 64 65 BIndex; /* Inde
19d50 78 20 73 74 72 75 63 74 75 72 65 20 63 6f 72 72 x structure corr
19d60 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 75 31 2e esponding to u1.
19d70 7a 49 6e 64 65 78 65 64 42 79 20 2a 2f 0a 20 20 zIndexedBy */.
19d80 7d 20 61 5b 31 5d 3b 20 20 20 20 20 20 20 20 20 } a[1];
19d90 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 /* One entry
19da0 20 66 6f 72 20 65 61 63 68 20 69 64 65 6e 74 69 for each identi
19db0 66 69 65 72 20 6f 6e 20 74 68 65 20 6c 69 73 74 fier on the list
19dc0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 50 65 */.};../*.** Pe
19dd0 72 6d 69 74 74 65 64 20 76 61 6c 75 65 73 20 6f rmitted values o
19de0 66 20 74 68 65 20 53 72 63 4c 69 73 74 2e 61 2e f the SrcList.a.
19df0 6a 6f 69 6e 74 79 70 65 20 66 69 65 6c 64 0a 2a jointype field.*
19e00 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 49 4e 4e /.#define JT_INN
19e10 45 52 20 20 20 20 20 30 78 30 30 30 31 20 20 20 ER 0x0001
19e20 20 2f 2a 20 41 6e 79 20 6b 69 6e 64 20 6f 66 20 /* Any kind of
19e30 69 6e 6e 65 72 20 6f 72 20 63 72 6f 73 73 20 6a inner or cross j
19e40 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a oin */.#define J
19e50 54 5f 43 52 4f 53 53 20 20 20 20 20 30 78 30 30 T_CROSS 0x00
19e60 30 32 20 20 20 20 2f 2a 20 45 78 70 6c 69 63 69 02 /* Explici
19e70 74 20 75 73 65 20 6f 66 20 74 68 65 20 43 52 4f t use of the CRO
19e80 53 53 20 6b 65 79 77 6f 72 64 20 2a 2f 0a 23 64 SS keyword */.#d
19e90 65 66 69 6e 65 20 4a 54 5f 4e 41 54 55 52 41 4c efine JT_NATURAL
19ea0 20 20 20 30 78 30 30 30 34 20 20 20 20 2f 2a 20 0x0004 /*
19eb0 54 72 75 65 20 66 6f 72 20 61 20 22 6e 61 74 75 True for a "natu
19ec0 72 61 6c 22 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 ral" join */.#de
19ed0 66 69 6e 65 20 4a 54 5f 4c 45 46 54 20 20 20 20 fine JT_LEFT
19ee0 20 20 30 78 30 30 30 38 20 20 20 20 2f 2a 20 4c 0x0008 /* L
19ef0 65 66 74 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a eft outer join *
19f00 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 52 49 47 /.#define JT_RIG
19f10 48 54 20 20 20 20 20 30 78 30 30 31 30 20 20 20 HT 0x0010
19f20 20 2f 2a 20 52 69 67 68 74 20 6f 75 74 65 72 20 /* Right outer
19f30 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 join */.#define
19f40 4a 54 5f 4f 55 54 45 52 20 20 20 20 20 30 78 30 JT_OUTER 0x0
19f50 30 32 30 20 20 20 20 2f 2a 20 54 68 65 20 22 4f 020 /* The "O
19f60 55 54 45 52 22 20 6b 65 79 77 6f 72 64 20 69 73 UTER" keyword is
19f70 20 70 72 65 73 65 6e 74 20 2a 2f 0a 23 64 65 66 present */.#def
19f80 69 6e 65 20 4a 54 5f 45 52 52 4f 52 20 20 20 20 ine JT_ERROR
19f90 20 30 78 30 30 34 30 20 20 20 20 2f 2a 20 75 6e 0x0040 /* un
19fa0 6b 6e 6f 77 6e 20 6f 72 20 75 6e 73 75 70 70 6f known or unsuppo
19fb0 72 74 65 64 20 6a 6f 69 6e 20 74 79 70 65 20 2a rted join type *
19fc0 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6c 61 67 73 20 /.../*.** Flags
19fd0 61 70 70 72 6f 70 72 69 61 74 65 20 66 6f 72 20 appropriate for
19fe0 74 68 65 20 77 63 74 72 6c 46 6c 61 67 73 20 70 the wctrlFlags p
19ff0 61 72 61 6d 65 74 65 72 20 6f 66 20 73 71 6c 69 arameter of sqli
1a000 74 65 33 57 68 65 72 65 42 65 67 69 6e 28 29 0a te3WhereBegin().
1a010 2a 2a 20 61 6e 64 20 74 68 65 20 57 68 65 72 65 ** and the Where
1a020 49 6e 66 6f 2e 77 63 74 72 6c 46 6c 61 67 73 20 Info.wctrlFlags
1a030 6d 65 6d 62 65 72 2e 0a 2a 2a 0a 2a 2a 20 56 61 member..**.** Va
1a040 6c 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 lue constraints
1a050 28 65 6e 66 6f 72 63 65 64 20 76 69 61 20 61 73 (enforced via as
1a060 73 65 72 74 28 29 29 3a 0a 2a 2a 20 20 20 20 20 sert()):.**
1a070 57 48 45 52 45 5f 55 53 45 5f 4c 49 4d 49 54 20 WHERE_USE_LIMIT
1a080 20 3d 3d 20 53 46 5f 46 69 78 65 64 4c 69 6d 69 == SF_FixedLimi
1a090 74 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 t.*/.#define WHE
1a0a0 52 45 5f 4f 52 44 45 52 42 59 5f 4e 4f 52 4d 41 RE_ORDERBY_NORMA
1a0b0 4c 20 20 20 30 78 30 30 30 30 20 2f 2a 20 4e 6f L 0x0000 /* No
1a0c0 2d 6f 70 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 -op */.#define W
1a0d0 48 45 52 45 5f 4f 52 44 45 52 42 59 5f 4d 49 4e HERE_ORDERBY_MIN
1a0e0 20 20 20 20 20 20 30 78 30 30 30 31 20 2f 2a 20 0x0001 /*
1a0f0 4f 52 44 45 52 20 42 59 20 70 72 6f 63 65 73 73 ORDER BY process
1a100 69 6e 67 20 66 6f 72 20 6d 69 6e 28 29 20 66 75 ing for min() fu
1a110 6e 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 nc */.#define WH
1a120 45 52 45 5f 4f 52 44 45 52 42 59 5f 4d 41 58 20 ERE_ORDERBY_MAX
1a130 20 20 20 20 20 30 78 30 30 30 32 20 2f 2a 20 4f 0x0002 /* O
1a140 52 44 45 52 20 42 59 20 70 72 6f 63 65 73 73 69 RDER BY processi
1a150 6e 67 20 66 6f 72 20 6d 61 78 28 29 20 66 75 6e ng for max() fun
1a160 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 c */.#define WHE
1a170 52 45 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 RE_ONEPASS_DESIR
1a180 45 44 20 20 30 78 30 30 30 34 20 2f 2a 20 57 61 ED 0x0004 /* Wa
1a190 6e 74 20 74 6f 20 64 6f 20 6f 6e 65 2d 70 61 73 nt to do one-pas
1a1a0 73 20 55 50 44 41 54 45 2f 44 45 4c 45 54 45 20 s UPDATE/DELETE
1a1b0 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
1a1c0 5f 4f 4e 45 50 41 53 53 5f 4d 55 4c 54 49 52 4f _ONEPASS_MULTIRO
1a1d0 57 20 30 78 30 30 30 38 20 2f 2a 20 4f 4e 45 50 W 0x0008 /* ONEP
1a1e0 41 53 53 20 69 73 20 6f 6b 20 77 69 74 68 20 6d ASS is ok with m
1a1f0 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a ultiple rows */.
1a200 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 55 #define WHERE_DU
1a210 50 4c 49 43 41 54 45 53 5f 4f 4b 20 20 20 20 30 PLICATES_OK 0
1a220 78 30 30 31 30 20 2f 2a 20 4f 6b 20 74 6f 20 72 x0010 /* Ok to r
1a230 65 74 75 72 6e 20 61 20 72 6f 77 20 6d 6f 72 65 eturn a row more
1a240 20 74 68 61 6e 20 6f 6e 63 65 20 2a 2f 0a 23 64 than once */.#d
1a250 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 5f 53 efine WHERE_OR_S
1a260 55 42 43 4c 41 55 53 45 20 20 20 20 20 30 78 30 UBCLAUSE 0x0
1a270 30 32 30 20 2f 2a 20 50 72 6f 63 65 73 73 69 6e 020 /* Processin
1a280 67 20 61 20 73 75 62 2d 57 48 45 52 45 20 61 73 g a sub-WHERE as
1a290 20 70 61 72 74 20 6f 66 0a 20 20 20 20 20 20 20 part of.
1a2a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a2b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
1a2c0 2a 20 74 68 65 20 4f 52 20 6f 70 74 69 6d 69 7a * the OR optimiz
1a2d0 61 74 69 6f 6e 20 20 2a 2f 0a 23 64 65 66 69 6e ation */.#defin
1a2e0 65 20 57 48 45 52 45 5f 47 52 4f 55 50 42 59 20 e WHERE_GROUPBY
1a2f0 20 20 20 20 20 20 20 20 20 30 78 30 30 34 30 20 0x0040
1a300 2f 2a 20 70 4f 72 64 65 72 42 79 20 69 73 20 72 /* pOrderBy is r
1a310 65 61 6c 6c 79 20 61 20 47 52 4f 55 50 20 42 59 eally a GROUP BY
1a320 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
1a330 45 5f 44 49 53 54 49 4e 43 54 42 59 20 20 20 20 E_DISTINCTBY
1a340 20 20 20 30 78 30 30 38 30 20 2f 2a 20 70 4f 72 0x0080 /* pOr
1a350 64 65 72 62 79 20 69 73 20 72 65 61 6c 6c 79 20 derby is really
1a360 61 20 44 49 53 54 49 4e 43 54 20 63 6c 61 75 73 a DISTINCT claus
1a370 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 e */.#define WHE
1a380 52 45 5f 57 41 4e 54 5f 44 49 53 54 49 4e 43 54 RE_WANT_DISTINCT
1a390 20 20 20 20 30 78 30 31 30 30 20 2f 2a 20 41 6c 0x0100 /* Al
1a3a0 6c 20 6f 75 74 70 75 74 20 6e 65 65 64 73 20 74 l output needs t
1a3b0 6f 20 62 65 20 64 69 73 74 69 6e 63 74 20 2a 2f o be distinct */
1a3c0 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 53 .#define WHERE_S
1a3d0 4f 52 54 42 59 47 52 4f 55 50 20 20 20 20 20 20 ORTBYGROUP
1a3e0 30 78 30 32 30 30 20 2f 2a 20 53 75 70 70 6f 72 0x0200 /* Suppor
1a3f0 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 t sqlite3WhereIs
1a400 53 6f 72 74 65 64 28 29 20 2a 2f 0a 23 64 65 66 Sorted() */.#def
1a410 69 6e 65 20 57 48 45 52 45 5f 53 45 45 4b 5f 54 ine WHERE_SEEK_T
1a420 41 42 4c 45 20 20 20 20 20 20 20 30 78 30 34 30 ABLE 0x040
1a430 30 20 2f 2a 20 44 6f 20 6e 6f 74 20 64 65 66 65 0 /* Do not defe
1a440 72 20 73 65 65 6b 73 20 6f 6e 20 6d 61 69 6e 20 r seeks on main
1a450 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 table */.#define
1a460 20 57 48 45 52 45 5f 4f 52 44 45 52 42 59 5f 4c WHERE_ORDERBY_L
1a470 49 4d 49 54 20 20 20 20 30 78 30 38 30 30 20 2f IMIT 0x0800 /
1a480 2a 20 4f 52 44 45 52 42 59 2b 4c 49 4d 49 54 20 * ORDERBY+LIMIT
1a490 6f 6e 20 74 68 65 20 69 6e 6e 65 72 20 6c 6f 6f on the inner loo
1a4a0 70 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 p */.
1a4b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1a4c0 20 20 20 20 30 78 31 30 30 30 20 20 20 20 6e 6f 0x1000 no
1a4d0 74 20 63 75 72 72 65 6e 74 6c 79 20 75 73 65 64 t currently used
1a4e0 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 */.
1a4f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 /*
1a500 20 20 20 30 78 32 30 30 30 20 20 20 20 6e 6f 74 0x2000 not
1a510 20 63 75 72 72 65 6e 74 6c 79 20 75 73 65 64 20 currently used
1a520 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
1a530 5f 55 53 45 5f 4c 49 4d 49 54 20 20 20 20 20 20 _USE_LIMIT
1a540 20 20 30 78 34 30 30 30 20 2f 2a 20 55 73 65 20 0x4000 /* Use
1a550 74 68 65 20 4c 49 4d 49 54 20 69 6e 20 63 6f 73 the LIMIT in cos
1a560 74 20 65 73 74 69 6d 61 74 65 73 20 2a 2f 0a 20 t estimates */.
1a570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1a580 20 20 20 20 20 20 20 2f 2a 20 20 20 20 20 30 78 /* 0x
1a590 38 30 30 30 20 20 20 20 6e 6f 74 20 63 75 72 72 8000 not curr
1a5a0 65 6e 74 6c 79 20 75 73 65 64 20 2a 2f 0a 0a 2f ently used */../
1a5b0 2a 20 41 6c 6c 6f 77 65 64 20 72 65 74 75 72 6e * Allowed return
1a5c0 20 76 61 6c 75 65 73 20 66 72 6f 6d 20 73 71 6c values from sql
1a5d0 69 74 65 33 57 68 65 72 65 49 73 44 69 73 74 69 ite3WhereIsDisti
1a5e0 6e 63 74 28 29 0a 2a 2f 0a 23 64 65 66 69 6e 65 nct().*/.#define
1a5f0 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f WHERE_DISTINCT_
1a600 4e 4f 4f 50 20 20 20 20 20 20 30 20 20 2f 2a 20 NOOP 0 /*
1a610 44 49 53 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 DISTINCT keyword
1a620 20 6e 6f 74 20 75 73 65 64 20 2a 2f 0a 23 64 65 not used */.#de
1a630 66 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 fine WHERE_DISTI
1a640 4e 43 54 5f 55 4e 49 51 55 45 20 20 20 20 31 20 NCT_UNIQUE 1
1a650 20 2f 2a 20 4e 6f 20 64 75 70 6c 69 63 61 74 65 /* No duplicate
1a660 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 s */.#define WHE
1a670 52 45 5f 44 49 53 54 49 4e 43 54 5f 4f 52 44 45 RE_DISTINCT_ORDE
1a680 52 45 44 20 20 20 32 20 20 2f 2a 20 41 6c 6c 20 RED 2 /* All
1a690 64 75 70 6c 69 63 61 74 65 73 20 61 72 65 20 61 duplicates are a
1a6a0 64 6a 61 63 65 6e 74 20 2a 2f 0a 23 64 65 66 69 djacent */.#defi
1a6b0 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 ne WHERE_DISTINC
1a6c0 54 5f 55 4e 4f 52 44 45 52 45 44 20 33 20 20 2f T_UNORDERED 3 /
1a6d0 2a 20 44 75 70 6c 69 63 61 74 65 73 20 61 72 65 * Duplicates are
1a6e0 20 73 63 61 74 74 65 72 65 64 20 2a 2f 0a 0a 2f scattered */../
1a6f0 2a 0a 2a 2a 20 41 20 4e 61 6d 65 43 6f 6e 74 65 *.** A NameConte
1a700 78 74 20 64 65 66 69 6e 65 73 20 61 20 63 6f 6e xt defines a con
1a710 74 65 78 74 20 69 6e 20 77 68 69 63 68 20 74 6f text in which to
1a720 20 72 65 73 6f 6c 76 65 20 74 61 62 6c 65 20 61 resolve table a
1a730 6e 64 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6e 61 6d nd column.** nam
1a740 65 73 2e 20 20 54 68 65 20 63 6f 6e 74 65 78 74 es. The context
1a750 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 6c consists of a l
1a760 69 73 74 20 6f 66 20 74 61 62 6c 65 73 20 28 74 ist of tables (t
1a770 68 65 20 70 53 72 63 4c 69 73 74 29 20 66 69 65 he pSrcList) fie
1a780 6c 64 20 61 6e 64 0a 2a 2a 20 61 20 6c 69 73 74 ld and.** a list
1a790 20 6f 66 20 6e 61 6d 65 64 20 65 78 70 72 65 73 of named expres
1a7a0 73 69 6f 6e 20 28 70 45 4c 69 73 74 29 2e 20 20 sion (pEList).
1a7b0 54 68 65 20 6e 61 6d 65 64 20 65 78 70 72 65 73 The named expres
1a7c0 73 69 6f 6e 20 6c 69 73 74 20 6d 61 79 0a 2a 2a sion list may.**
1a7d0 20 62 65 20 4e 55 4c 4c 2e 20 20 54 68 65 20 70 be NULL. The p
1a7e0 53 72 63 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 Src corresponds
1a7f0 74 6f 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 to the FROM clau
1a800 73 65 20 6f 66 20 61 20 53 45 4c 45 43 54 20 6f se of a SELECT o
1a810 72 0a 2a 2a 20 74 6f 20 74 68 65 20 74 61 62 6c r.** to the tabl
1a820 65 20 62 65 69 6e 67 20 6f 70 65 72 61 74 65 64 e being operated
1a830 20 6f 6e 20 62 79 20 49 4e 53 45 52 54 2c 20 55 on by INSERT, U
1a840 50 44 41 54 45 2c 20 6f 72 20 44 45 4c 45 54 45 PDATE, or DELETE
1a850 2e 20 20 54 68 65 0a 2a 2a 20 70 45 4c 69 73 74 . The.** pEList
1a860 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 corresponds to
1a870 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f the result set o
1a880 66 20 61 20 53 45 4c 45 43 54 20 61 6e 64 20 69 f a SELECT and i
1a890 73 20 4e 55 4c 4c 20 66 6f 72 0a 2a 2a 20 6f 74 s NULL for.** ot
1a8a0 68 65 72 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a her statements..
1a8b0 2a 2a 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 **.** NameContex
1a8c0 74 73 20 63 61 6e 20 62 65 20 6e 65 73 74 65 64 ts can be nested
1a8d0 2e 20 20 57 68 65 6e 20 72 65 73 6f 6c 76 69 6e . When resolvin
1a8e0 67 20 6e 61 6d 65 73 2c 20 74 68 65 20 69 6e 6e g names, the inn
1a8f0 65 72 2d 6d 6f 73 74 0a 2a 2a 20 63 6f 6e 74 65 er-most.** conte
1a900 78 74 20 69 73 20 73 65 61 72 63 68 65 64 20 66 xt is searched f
1a910 69 72 73 74 2e 20 20 49 66 20 6e 6f 20 6d 61 74 irst. If no mat
1a920 63 68 20 69 73 20 66 6f 75 6e 64 2c 20 74 68 65 ch is found, the
1a930 20 6e 65 78 74 20 6f 75 74 65 72 0a 2a 2a 20 63 next outer.** c
1a940 6f 6e 74 65 78 74 20 69 73 20 63 68 65 63 6b 65 ontext is checke
1a950 64 2e 20 20 49 66 20 74 68 65 72 65 20 69 73 20 d. If there is
1a960 73 74 69 6c 6c 20 6e 6f 20 6d 61 74 63 68 2c 20 still no match,
1a970 74 68 65 20 6e 65 78 74 20 63 6f 6e 74 65 78 74 the next context
1a980 0a 2a 2a 20 69 73 20 63 68 65 63 6b 65 64 2e 20 .** is checked.
1a990 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 63 6f This process co
1a9a0 6e 74 69 6e 75 65 73 20 75 6e 74 69 6c 20 65 69 ntinues until ei
1a9b0 74 68 65 72 20 61 20 6d 61 74 63 68 20 69 73 20 ther a match is
1a9c0 66 6f 75 6e 64 0a 2a 2a 20 6f 72 20 61 6c 6c 20 found.** or all
1a9d0 63 6f 6e 74 65 78 74 73 20 61 72 65 20 63 68 65 contexts are che
1a9e0 63 6b 2e 20 20 57 68 65 6e 20 61 20 6d 61 74 63 ck. When a matc
1a9f0 68 20 69 73 20 66 6f 75 6e 64 2c 20 74 68 65 20 h is found, the
1aa00 6e 52 65 66 20 6d 65 6d 62 65 72 20 6f 66 0a 2a nRef member of.*
1aa10 2a 20 74 68 65 20 63 6f 6e 74 65 78 74 20 63 6f * the context co
1aa20 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6d 61 74 ntaining the mat
1aa30 63 68 20 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 ch is incremente
1aa40 64 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 73 75 d..**.** Each su
1aa50 62 71 75 65 72 79 20 67 65 74 73 20 61 20 6e 65 bquery gets a ne
1aa60 77 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2e 20 20 w NameContext.
1aa70 54 68 65 20 70 4e 65 78 74 20 66 69 65 6c 64 20 The pNext field
1aa80 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a 2a points to the.**
1aa90 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 69 6e 20 NameContext in
1aaa0 74 68 65 20 70 61 72 65 6e 74 20 71 75 65 72 79 the parent query
1aab0 2e 20 20 54 68 75 73 20 74 68 65 20 70 72 6f 63 . Thus the proc
1aac0 65 73 73 20 6f 66 20 73 63 61 6e 6e 69 6e 67 20 ess of scanning
1aad0 74 68 65 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 the.** NameConte
1aae0 78 74 20 6c 69 73 74 20 63 6f 72 72 65 73 70 6f xt list correspo
1aaf0 6e 64 73 20 74 6f 20 73 65 61 72 63 68 69 6e 67 nds to searching
1ab00 20 74 68 72 6f 75 67 68 20 73 75 63 63 65 73 73 through success
1ab10 69 76 65 6c 79 20 6f 75 74 65 72 0a 2a 2a 20 73 ively outer.** s
1ab20 75 62 71 75 65 72 69 65 73 20 6c 6f 6f 6b 69 6e ubqueries lookin
1ab30 67 20 66 6f 72 20 61 20 6d 61 74 63 68 2e 0a 2a g for a match..*
1ab40 2f 0a 73 74 72 75 63 74 20 4e 61 6d 65 43 6f 6e /.struct NameCon
1ab50 74 65 78 74 20 7b 0a 20 20 50 61 72 73 65 20 2a text {. Parse *
1ab60 70 50 61 72 73 65 3b 20 20 20 20 20 20 20 2f 2a pParse; /*
1ab70 20 54 68 65 20 70 61 72 73 65 72 20 2a 2f 0a 20 The parser */.
1ab80 20 53 72 63 4c 69 73 74 20 2a 70 53 72 63 4c 69 SrcList *pSrcLi
1ab90 73 74 3b 20 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 st; /* One or
1aba0 6d 6f 72 65 20 74 61 62 6c 65 73 20 75 73 65 64 more tables used
1abb0 20 74 6f 20 72 65 73 6f 6c 76 65 20 6e 61 6d 65 to resolve name
1abc0 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
1abd0 2a 70 45 4c 69 73 74 3b 20 20 20 20 2f 2a 20 4f *pEList; /* O
1abe0 70 74 69 6f 6e 61 6c 20 6c 69 73 74 20 6f 66 20 ptional list of
1abf0 72 65 73 75 6c 74 2d 73 65 74 20 63 6f 6c 75 6d result-set colum
1ac00 6e 73 20 2a 2f 0a 20 20 41 67 67 49 6e 66 6f 20 ns */. AggInfo
1ac10 2a 70 41 67 67 49 6e 66 6f 3b 20 20 20 2f 2a 20 *pAggInfo; /*
1ac20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 Information abou
1ac30 74 20 61 67 67 72 65 67 61 74 65 73 20 61 74 20 t aggregates at
1ac40 74 68 69 73 20 6c 65 76 65 6c 20 2a 2f 0a 20 20 this level */.
1ac50 4e 61 6d 65 43 6f 6e 74 65 78 74 20 2a 70 4e 65 NameContext *pNe
1ac60 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 6f 75 74 xt; /* Next out
1ac70 65 72 20 6e 61 6d 65 20 63 6f 6e 74 65 78 74 2e er name context.
1ac80 20 20 4e 55 4c 4c 20 66 6f 72 20 6f 75 74 65 72 NULL for outer
1ac90 6d 6f 73 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 most */. int nR
1aca0 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ef; /
1acb0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e 61 6d 65 * Number of name
1acc0 73 20 72 65 73 6f 6c 76 65 64 20 62 79 20 74 68 s resolved by th
1acd0 69 73 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 is context */.
1ace0 69 6e 74 20 6e 45 72 72 3b 20 20 20 20 20 20 20 int nErr;
1acf0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1ad00 66 20 65 72 72 6f 72 73 20 65 6e 63 6f 75 6e 74 f errors encount
1ad10 65 72 65 64 20 77 68 69 6c 65 20 72 65 73 6f 6c ered while resol
1ad20 76 69 6e 67 20 6e 61 6d 65 73 20 2a 2f 0a 20 20 ving names */.
1ad30 75 31 36 20 6e 63 46 6c 61 67 73 3b 20 20 20 20 u16 ncFlags;
1ad40 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 /* Zero or
1ad50 6d 6f 72 65 20 4e 43 5f 2a 20 66 6c 61 67 73 20 more NC_* flags
1ad60 64 65 66 69 6e 65 64 20 62 65 6c 6f 77 20 2a 2f defined below */
1ad70 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 .};../*.** Allow
1ad80 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 ed values for th
1ad90 65 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2c 20 6e e NameContext, n
1ada0 63 46 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2a cFlags field..**
1adb0 0a 2a 2a 20 56 61 6c 75 65 20 63 6f 6e 73 74 72 .** Value constr
1adc0 61 69 6e 74 73 20 28 61 6c 6c 20 63 68 65 63 6b aints (all check
1add0 65 64 20 76 69 61 20 61 73 73 65 72 74 28 29 29 ed via assert())
1ade0 3a 0a 2a 2a 20 20 20 20 4e 43 5f 48 61 73 41 67 :.** NC_HasAg
1adf0 67 20 20 20 20 3d 3d 20 53 46 5f 48 61 73 41 67 g == SF_HasAg
1ae00 67 0a 2a 2a 20 20 20 20 4e 43 5f 4d 69 6e 4d 61 g.** NC_MinMa
1ae10 78 41 67 67 20 3d 3d 20 53 46 5f 4d 69 6e 4d 61 xAgg == SF_MinMa
1ae20 78 41 67 67 20 3d 3d 20 53 51 4c 49 54 45 5f 46 xAgg == SQLITE_F
1ae30 55 4e 43 5f 4d 49 4e 4d 41 58 0a 2a 2a 0a 2a 2f UNC_MINMAX.**.*/
1ae40 0a 23 64 65 66 69 6e 65 20 4e 43 5f 41 6c 6c 6f .#define NC_Allo
1ae50 77 41 67 67 20 20 30 78 30 30 30 31 20 20 2f 2a wAgg 0x0001 /*
1ae60 20 41 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 Aggregate funct
1ae70 69 6f 6e 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 ions are allowed
1ae80 20 68 65 72 65 20 2a 2f 0a 23 64 65 66 69 6e 65 here */.#define
1ae90 20 4e 43 5f 50 61 72 74 49 64 78 20 20 20 30 78 NC_PartIdx 0x
1aea0 30 30 30 32 20 20 2f 2a 20 54 72 75 65 20 69 66 0002 /* True if
1aeb0 20 72 65 73 6f 6c 76 69 6e 67 20 61 20 70 61 72 resolving a par
1aec0 74 69 61 6c 20 69 6e 64 65 78 20 57 48 45 52 45 tial index WHERE
1aed0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 49 */.#define NC_I
1aee0 73 43 68 65 63 6b 20 20 20 30 78 30 30 30 34 20 sCheck 0x0004
1aef0 20 2f 2a 20 54 72 75 65 20 69 66 20 72 65 73 6f /* True if reso
1af00 6c 76 69 6e 67 20 6e 61 6d 65 73 20 69 6e 20 61 lving names in a
1af10 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e CHECK constrain
1af20 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f t */.#define NC_
1af30 49 6e 41 67 67 46 75 6e 63 20 30 78 30 30 30 38 InAggFunc 0x0008
1af40 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 6e 61 /* True if ana
1af50 6c 79 7a 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 lyzing arguments
1af60 20 74 6f 20 61 6e 20 61 67 67 20 66 75 6e 63 20 to an agg func
1af70 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 48 61 */.#define NC_Ha
1af80 73 41 67 67 20 20 20 20 30 78 30 30 31 30 20 20 sAgg 0x0010
1af90 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 61 /* One or more a
1afa0 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f ggregate functio
1afb0 6e 73 20 73 65 65 6e 20 2a 2f 0a 23 64 65 66 69 ns seen */.#defi
1afc0 6e 65 20 4e 43 5f 49 64 78 45 78 70 72 20 20 20 ne NC_IdxExpr
1afd0 30 78 30 30 32 30 20 20 2f 2a 20 54 72 75 65 20 0x0020 /* True
1afe0 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 63 6f 6c if resolving col
1aff0 75 6d 6e 73 20 6f 66 20 43 52 45 41 54 45 20 49 umns of CREATE I
1b000 4e 44 45 58 20 2a 2f 0a 23 64 65 66 69 6e 65 20 NDEX */.#define
1b010 4e 43 5f 56 61 72 53 65 6c 65 63 74 20 30 78 30 NC_VarSelect 0x0
1b020 30 34 30 20 20 2f 2a 20 41 20 63 6f 72 72 65 6c 040 /* A correl
1b030 61 74 65 64 20 73 75 62 71 75 65 72 79 20 68 61 ated subquery ha
1b040 73 20 62 65 65 6e 20 73 65 65 6e 20 2a 2f 0a 23 s been seen */.#
1b050 64 65 66 69 6e 65 20 4e 43 5f 4d 69 6e 4d 61 78 define NC_MinMax
1b060 41 67 67 20 30 78 31 30 30 30 20 20 2f 2a 20 6d Agg 0x1000 /* m
1b070 69 6e 2f 6d 61 78 20 61 67 67 72 65 67 61 74 65 in/max aggregate
1b080 73 20 73 65 65 6e 2e 20 20 53 65 65 20 6e 6f 74 s seen. See not
1b090 65 20 61 62 6f 76 65 20 2a 2f 0a 0a 2f 2a 0a 2a e above */../*.*
1b0a0 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
1b0b0 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
1b0c0 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e tructure contain
1b0d0 73 20 61 6c 6c 20 69 6e 66 6f 72 6d 61 74 69 6f s all informatio
1b0e0 6e 0a 2a 2a 20 6e 65 65 64 65 64 20 74 6f 20 67 n.** needed to g
1b0f0 65 6e 65 72 61 74 65 20 63 6f 64 65 20 66 6f 72 enerate code for
1b100 20 61 20 73 69 6e 67 6c 65 20 53 45 4c 45 43 54 a single SELECT
1b110 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 0a 2a statement..**.*
1b120 2a 20 6e 4c 69 6d 69 74 20 69 73 20 73 65 74 20 * nLimit is set
1b130 74 6f 20 2d 31 20 69 66 20 74 68 65 72 65 20 69 to -1 if there i
1b140 73 20 6e 6f 20 4c 49 4d 49 54 20 63 6c 61 75 73 s no LIMIT claus
1b150 65 2e 20 20 6e 4f 66 66 73 65 74 20 69 73 20 73 e. nOffset is s
1b160 65 74 20 74 6f 20 30 2e 0a 2a 2a 20 49 66 20 74 et to 0..** If t
1b170 68 65 72 65 20 69 73 20 61 20 4c 49 4d 49 54 20 here is a LIMIT
1b180 63 6c 61 75 73 65 2c 20 74 68 65 20 70 61 72 73 clause, the pars
1b190 65 72 20 73 65 74 73 20 6e 4c 69 6d 69 74 20 74 er sets nLimit t
1b1a0 6f 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 o the value of t
1b1b0 68 65 0a 2a 2a 20 6c 69 6d 69 74 20 61 6e 64 20 he.** limit and
1b1c0 6e 4f 66 66 73 65 74 20 74 6f 20 74 68 65 20 76 nOffset to the v
1b1d0 61 6c 75 65 20 6f 66 20 74 68 65 20 6f 66 66 73 alue of the offs
1b1e0 65 74 20 28 6f 72 20 30 20 69 66 20 74 68 65 72 et (or 0 if ther
1b1f0 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 6f 66 66 73 e is not.** offs
1b200 65 74 29 2e 20 20 42 75 74 20 6c 61 74 65 72 20 et). But later
1b210 6f 6e 2c 20 6e 4c 69 6d 69 74 20 61 6e 64 20 6e on, nLimit and n
1b220 4f 66 66 73 65 74 20 62 65 63 6f 6d 65 20 74 68 Offset become th
1b230 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f e memory locatio
1b240 6e 73 0a 2a 2a 20 69 6e 20 74 68 65 20 56 44 42 ns.** in the VDB
1b250 45 20 74 68 61 74 20 72 65 63 6f 72 64 20 74 68 E that record th
1b260 65 20 6c 69 6d 69 74 20 61 6e 64 20 6f 66 66 73 e limit and offs
1b270 65 74 20 63 6f 75 6e 74 65 72 73 2e 0a 2a 2a 0a et counters..**.
1b280 2a 2a 20 61 64 64 72 4f 70 65 6e 45 70 68 6d 5b ** addrOpenEphm[
1b290 5d 20 65 6e 74 72 69 65 73 20 63 6f 6e 74 61 69 ] entries contai
1b2a0 6e 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66 n the address of
1b2b0 20 4f 50 5f 4f 70 65 6e 45 70 68 65 6d 65 72 61 OP_OpenEphemera
1b2c0 6c 20 6f 70 63 6f 64 65 73 2e 0a 2a 2a 20 54 68 l opcodes..** Th
1b2d0 65 73 65 20 61 64 64 72 65 73 73 65 73 20 6d 75 ese addresses mu
1b2e0 73 74 20 62 65 20 73 74 6f 72 65 64 20 73 6f 20 st be stored so
1b2f0 74 68 61 74 20 77 65 20 63 61 6e 20 67 6f 20 62 that we can go b
1b300 61 63 6b 20 61 6e 64 20 66 69 6c 6c 20 69 6e 0a ack and fill in.
1b310 2a 2a 20 74 68 65 20 50 34 5f 4b 45 59 49 4e 46 ** the P4_KEYINF
1b320 4f 20 61 6e 64 20 50 32 20 70 61 72 61 6d 65 74 O and P2 paramet
1b330 65 72 73 20 6c 61 74 65 72 2e 20 20 4e 65 69 74 ers later. Neit
1b340 68 65 72 20 74 68 65 20 4b 65 79 49 6e 66 6f 20 her the KeyInfo
1b350 6e 6f 72 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 65 nor.** the numbe
1b360 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 r of columns in
1b370 50 32 20 63 61 6e 20 62 65 20 63 6f 6d 70 75 74 P2 can be comput
1b380 65 64 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 ed at the same t
1b390 69 6d 65 0a 2a 2a 20 61 73 20 74 68 65 20 4f 50 ime.** as the OP
1b3a0 5f 4f 70 65 6e 45 70 68 6d 20 69 6e 73 74 72 75 _OpenEphm instru
1b3b0 63 74 69 6f 6e 20 69 73 20 63 6f 64 65 64 20 62 ction is coded b
1b3c0 65 63 61 75 73 65 20 6e 6f 74 0a 2a 2a 20 65 6e ecause not.** en
1b3d0 6f 75 67 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ough information
1b3e0 20 61 62 6f 75 74 20 74 68 65 20 63 6f 6d 70 6f about the compo
1b3f0 75 6e 64 20 71 75 65 72 79 20 69 73 20 6b 6e 6f und query is kno
1b400 77 6e 20 61 74 20 74 68 61 74 20 70 6f 69 6e 74 wn at that point
1b410 2e 0a 2a 2a 20 54 68 65 20 4b 65 79 49 6e 66 6f ..** The KeyInfo
1b420 20 66 6f 72 20 61 64 64 72 4f 70 65 6e 54 72 61 for addrOpenTra
1b430 6e 5b 30 5d 20 61 6e 64 20 5b 31 5d 20 63 6f 6e n[0] and [1] con
1b440 74 61 69 6e 73 20 63 6f 6c 6c 61 74 69 6e 67 20 tains collating
1b450 73 65 71 75 65 6e 63 65 73 0a 2a 2a 20 66 6f 72 sequences.** for
1b460 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e the result set.
1b470 20 20 54 68 65 20 4b 65 79 49 6e 66 6f 20 66 6f The KeyInfo fo
1b480 72 20 61 64 64 72 4f 70 65 6e 45 70 68 6d 5b 32 r addrOpenEphm[2
1b490 5d 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6c 6c 61 ] contains colla
1b4a0 74 69 6e 67 0a 2a 2a 20 73 65 71 75 65 6e 63 65 ting.** sequence
1b4b0 73 20 66 6f 72 20 74 68 65 20 4f 52 44 45 52 20 s for the ORDER
1b4c0 42 59 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 BY clause..*/.st
1b4d0 72 75 63 74 20 53 65 6c 65 63 74 20 7b 0a 20 20 ruct Select {.
1b4e0 45 78 70 72 4c 69 73 74 20 2a 70 45 4c 69 73 74 ExprList *pEList
1b4f0 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 66 69 ; /* The fi
1b500 65 6c 64 73 20 6f 66 20 74 68 65 20 72 65 73 75 elds of the resu
1b510 6c 74 20 2a 2f 0a 20 20 75 38 20 6f 70 3b 20 20 lt */. u8 op;
1b520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1b530 2a 20 4f 6e 65 20 6f 66 3a 20 54 4b 5f 55 4e 49 * One of: TK_UNI
1b540 4f 4e 20 54 4b 5f 41 4c 4c 20 54 4b 5f 49 4e 54 ON TK_ALL TK_INT
1b550 45 52 53 45 43 54 20 54 4b 5f 45 58 43 45 50 54 ERSECT TK_EXCEPT
1b560 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 6e 53 65 */. LogEst nSe
1b570 6c 65 63 74 52 6f 77 3b 20 20 20 20 20 2f 2a 20 lectRow; /*
1b580 45 73 74 69 6d 61 74 65 64 20 6e 75 6d 62 65 72 Estimated number
1b590 20 6f 66 20 72 65 73 75 6c 74 20 72 6f 77 73 20 of result rows
1b5a0 2a 2f 0a 20 20 75 33 32 20 73 65 6c 46 6c 61 67 */. u32 selFlag
1b5b0 73 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 s; /* V
1b5c0 61 72 69 6f 75 73 20 53 46 5f 2a 20 76 61 6c 75 arious SF_* valu
1b5d0 65 73 20 2a 2f 0a 20 20 69 6e 74 20 69 4c 69 6d es */. int iLim
1b5e0 69 74 2c 20 69 4f 66 66 73 65 74 3b 20 20 20 2f it, iOffset; /
1b5f0 2a 20 4d 65 6d 6f 72 79 20 72 65 67 69 73 74 65 * Memory registe
1b600 72 73 20 68 6f 6c 64 69 6e 67 20 4c 49 4d 49 54 rs holding LIMIT
1b610 20 26 20 4f 46 46 53 45 54 20 63 6f 75 6e 74 65 & OFFSET counte
1b620 72 73 20 2a 2f 0a 23 69 66 20 53 45 4c 45 43 54 rs */.#if SELECT
1b630 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 20 20 TRACE_ENABLED.
1b640 63 68 61 72 20 7a 53 65 6c 4e 61 6d 65 5b 31 32 char zSelName[12
1b650 5d 3b 20 20 20 20 20 2f 2a 20 53 79 6d 62 6f 6c ]; /* Symbol
1b660 69 63 20 6e 61 6d 65 20 6f 66 20 74 68 69 73 20 ic name of this
1b670 53 45 4c 45 43 54 20 75 73 65 20 66 6f 72 20 64 SELECT use for d
1b680 65 62 75 67 67 69 6e 67 20 2a 2f 0a 23 65 6e 64 ebugging */.#end
1b690 69 66 0a 20 20 69 6e 74 20 61 64 64 72 4f 70 65 if. int addrOpe
1b6a0 6e 45 70 68 6d 5b 32 5d 3b 20 20 20 2f 2a 20 4f nEphm[2]; /* O
1b6b0 50 5f 4f 70 65 6e 45 70 68 65 6d 20 6f 70 63 6f P_OpenEphem opco
1b6c0 64 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 des related to t
1b6d0 68 69 73 20 73 65 6c 65 63 74 20 2a 2f 0a 20 20 his select */.
1b6e0 53 72 63 4c 69 73 74 20 2a 70 53 72 63 3b 20 20 SrcList *pSrc;
1b6f0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 52 /* The FR
1b700 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 OM clause */. E
1b710 78 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 xpr *pWhere;
1b720 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 /* The WHE
1b730 52 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 RE clause */. E
1b740 78 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 xprList *pGroupB
1b750 79 3b 20 20 20 20 2f 2a 20 54 68 65 20 47 52 4f y; /* The GRO
1b760 55 50 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a UP BY clause */.
1b770 20 20 45 78 70 72 20 2a 70 48 61 76 69 6e 67 3b Expr *pHaving;
1b780 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
1b790 48 41 56 49 4e 47 20 63 6c 61 75 73 65 20 2a 2f HAVING clause */
1b7a0 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 . ExprList *pOr
1b7b0 64 65 72 42 79 3b 20 20 20 20 2f 2a 20 54 68 65 derBy; /* The
1b7c0 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 ORDER BY clause
1b7d0 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 50 */. Select *pP
1b7e0 72 69 6f 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 rior; /*
1b7f0 50 72 69 6f 72 20 73 65 6c 65 63 74 20 69 6e 20 Prior select in
1b800 61 20 63 6f 6d 70 6f 75 6e 64 20 73 65 6c 65 63 a compound selec
1b810 74 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 t statement */.
1b820 20 53 65 6c 65 63 74 20 2a 70 4e 65 78 74 3b 20 Select *pNext;
1b830 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 /* Next
1b840 73 65 6c 65 63 74 20 74 6f 20 74 68 65 20 6c 65 select to the le
1b850 66 74 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 ft in a compound
1b860 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 4c 69 6d */. Expr *pLim
1b870 69 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 it; /*
1b880 4c 49 4d 49 54 20 65 78 70 72 65 73 73 69 6f 6e LIMIT expression
1b890 2e 20 4e 55 4c 4c 20 6d 65 61 6e 73 20 6e 6f 74 . NULL means not
1b8a0 20 75 73 65 64 2e 20 2a 2f 0a 20 20 45 78 70 72 used. */. Expr
1b8b0 20 2a 70 4f 66 66 73 65 74 3b 20 20 20 20 20 20 *pOffset;
1b8c0 20 20 20 2f 2a 20 4f 46 46 53 45 54 20 65 78 70 /* OFFSET exp
1b8d0 72 65 73 73 69 6f 6e 2e 20 4e 55 4c 4c 20 6d 65 ression. NULL me
1b8e0 61 6e 73 20 6e 6f 74 20 75 73 65 64 2e 20 2a 2f ans not used. */
1b8f0 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 3b 20 . With *pWith;
1b900 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 49 54 /* WIT
1b910 48 20 63 6c 61 75 73 65 20 61 74 74 61 63 68 65 H clause attache
1b920 64 20 74 6f 20 74 68 69 73 20 73 65 6c 65 63 74 d to this select
1b930 2e 20 4f 72 20 4e 55 4c 4c 2e 20 2a 2f 0a 7d 3b . Or NULL. */.};
1b940 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 ../*.** Allowed
1b950 76 61 6c 75 65 73 20 66 6f 72 20 53 65 6c 65 63 values for Selec
1b960 74 2e 73 65 6c 46 6c 61 67 73 2e 20 20 54 68 65 t.selFlags. The
1b970 20 22 53 46 22 20 70 72 65 66 69 78 20 73 74 61 "SF" prefix sta
1b980 6e 64 73 20 66 6f 72 0a 2a 2a 20 22 53 65 6c 65 nds for.** "Sele
1b990 63 74 20 46 6c 61 67 22 2e 0a 2a 2a 0a 2a 2a 20 ct Flag"..**.**
1b9a0 56 61 6c 75 65 20 63 6f 6e 73 74 72 61 69 6e 74 Value constraint
1b9b0 73 20 28 61 6c 6c 20 63 68 65 63 6b 65 64 20 76 s (all checked v
1b9c0 69 61 20 61 73 73 65 72 74 28 29 29 0a 2a 2a 20 ia assert()).**
1b9d0 20 20 20 20 53 46 5f 48 61 73 41 67 67 20 20 20 SF_HasAgg
1b9e0 20 20 3d 3d 20 4e 43 5f 48 61 73 41 67 67 0a 2a == NC_HasAgg.*
1b9f0 2a 20 20 20 20 20 53 46 5f 4d 69 6e 4d 61 78 41 * SF_MinMaxA
1ba00 67 67 20 20 3d 3d 20 4e 43 5f 4d 69 6e 4d 61 78 gg == NC_MinMax
1ba10 41 67 67 20 20 20 20 20 3d 3d 20 53 51 4c 49 54 Agg == SQLIT
1ba20 45 5f 46 55 4e 43 5f 4d 49 4e 4d 41 58 0a 2a 2a E_FUNC_MINMAX.**
1ba30 20 20 20 20 20 53 46 5f 46 69 78 65 64 4c 69 6d SF_FixedLim
1ba40 69 74 20 3d 3d 20 57 48 45 52 45 5f 55 53 45 5f it == WHERE_USE_
1ba50 4c 49 4d 49 54 0a 2a 2f 0a 23 64 65 66 69 6e 65 LIMIT.*/.#define
1ba60 20 53 46 5f 44 69 73 74 69 6e 63 74 20 20 20 20 SF_Distinct
1ba70 20 20 20 30 78 30 30 30 30 31 20 20 2f 2a 20 4f 0x00001 /* O
1ba80 75 74 70 75 74 20 73 68 6f 75 6c 64 20 62 65 20 utput should be
1ba90 44 49 53 54 49 4e 43 54 20 2a 2f 0a 23 64 65 66 DISTINCT */.#def
1baa0 69 6e 65 20 53 46 5f 41 6c 6c 20 20 20 20 20 20 ine SF_All
1bab0 20 20 20 20 20 20 30 78 30 30 30 30 32 20 20 2f 0x00002 /
1bac0 2a 20 49 6e 63 6c 75 64 65 73 20 74 68 65 20 41 * Includes the A
1bad0 4c 4c 20 6b 65 79 77 6f 72 64 20 2a 2f 0a 23 64 LL keyword */.#d
1bae0 65 66 69 6e 65 20 53 46 5f 52 65 73 6f 6c 76 65 efine SF_Resolve
1baf0 64 20 20 20 20 20 20 20 30 78 30 30 30 30 34 20 d 0x00004
1bb00 20 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 73 20 /* Identifiers
1bb10 68 61 76 65 20 62 65 65 6e 20 72 65 73 6f 6c 76 have been resolv
1bb20 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 ed */.#define SF
1bb30 5f 41 67 67 72 65 67 61 74 65 20 20 20 20 20 20 _Aggregate
1bb40 30 78 30 30 30 30 38 20 20 2f 2a 20 43 6f 6e 74 0x00008 /* Cont
1bb50 61 69 6e 73 20 61 67 67 20 66 75 6e 63 74 69 6f ains agg functio
1bb60 6e 73 20 6f 72 20 61 20 47 52 4f 55 50 20 42 59 ns or a GROUP BY
1bb70 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 48 */.#define SF_H
1bb80 61 73 41 67 67 20 20 20 20 20 20 20 20 20 30 78 asAgg 0x
1bb90 30 30 30 31 30 20 20 2f 2a 20 43 6f 6e 74 61 69 00010 /* Contai
1bba0 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 75 6e ns aggregate fun
1bbb0 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 6e ctions */.#defin
1bbc0 65 20 53 46 5f 55 73 65 73 45 70 68 65 6d 65 72 e SF_UsesEphemer
1bbd0 61 6c 20 20 30 78 30 30 30 32 30 20 20 2f 2a 20 al 0x00020 /*
1bbe0 55 73 65 73 20 74 68 65 20 4f 70 65 6e 45 70 68 Uses the OpenEph
1bbf0 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 20 2a 2f emeral opcode */
1bc00 0a 23 64 65 66 69 6e 65 20 53 46 5f 45 78 70 61 .#define SF_Expa
1bc10 6e 64 65 64 20 20 20 20 20 20 20 30 78 30 30 30 nded 0x000
1bc20 34 30 20 20 2f 2a 20 73 71 6c 69 74 65 33 53 65 40 /* sqlite3Se
1bc30 6c 65 63 74 45 78 70 61 6e 64 28 29 20 63 61 6c lectExpand() cal
1bc40 6c 65 64 20 6f 6e 20 74 68 69 73 20 2a 2f 0a 23 led on this */.#
1bc50 64 65 66 69 6e 65 20 53 46 5f 48 61 73 54 79 70 define SF_HasTyp
1bc60 65 49 6e 66 6f 20 20 20 20 30 78 30 30 30 38 30 eInfo 0x00080
1bc70 20 20 2f 2a 20 46 52 4f 4d 20 73 75 62 71 75 65 /* FROM subque
1bc80 72 69 65 73 20 68 61 76 65 20 54 61 62 6c 65 20 ries have Table
1bc90 6d 65 74 61 64 61 74 61 20 2a 2f 0a 23 64 65 66 metadata */.#def
1bca0 69 6e 65 20 53 46 5f 43 6f 6d 70 6f 75 6e 64 20 ine SF_Compound
1bcb0 20 20 20 20 20 20 30 78 30 30 31 30 30 20 20 2f 0x00100 /
1bcc0 2a 20 50 61 72 74 20 6f 66 20 61 20 63 6f 6d 70 * Part of a comp
1bcd0 6f 75 6e 64 20 71 75 65 72 79 20 2a 2f 0a 23 64 ound query */.#d
1bce0 65 66 69 6e 65 20 53 46 5f 56 61 6c 75 65 73 20 efine SF_Values
1bcf0 20 20 20 20 20 20 20 20 30 78 30 30 32 30 30 20 0x00200
1bd00 20 2f 2a 20 53 79 6e 74 68 65 73 69 7a 65 64 20 /* Synthesized
1bd10 66 72 6f 6d 20 56 41 4c 55 45 53 20 63 6c 61 75 from VALUES clau
1bd20 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 se */.#define SF
1bd30 5f 4d 75 6c 74 69 56 61 6c 75 65 20 20 20 20 20 _MultiValue
1bd40 30 78 30 30 34 30 30 20 20 2f 2a 20 53 69 6e 67 0x00400 /* Sing
1bd50 6c 65 20 56 41 4c 55 45 53 20 74 65 72 6d 20 77 le VALUES term w
1bd60 69 74 68 20 6d 75 6c 74 69 70 6c 65 20 72 6f 77 ith multiple row
1bd70 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f s */.#define SF_
1bd80 4e 65 73 74 65 64 46 72 6f 6d 20 20 20 20 20 30 NestedFrom 0
1bd90 78 30 30 38 30 30 20 20 2f 2a 20 50 61 72 74 20 x00800 /* Part
1bda0 6f 66 20 61 20 70 61 72 65 6e 74 68 65 73 69 7a of a parenthesiz
1bdb0 65 64 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a ed FROM clause *
1bdc0 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d 69 6e /.#define SF_Min
1bdd0 4d 61 78 41 67 67 20 20 20 20 20 20 30 78 30 31 MaxAgg 0x01
1bde0 30 30 30 20 20 2f 2a 20 41 67 67 72 65 67 61 74 000 /* Aggregat
1bdf0 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 6d 69 6e e containing min
1be00 28 29 20 6f 72 20 6d 61 78 28 29 20 2a 2f 0a 23 () or max() */.#
1be10 64 65 66 69 6e 65 20 53 46 5f 52 65 63 75 72 73 define SF_Recurs
1be20 69 76 65 20 20 20 20 20 20 30 78 30 32 30 30 30 ive 0x02000
1be30 20 20 2f 2a 20 54 68 65 20 72 65 63 75 72 73 69 /* The recursi
1be40 76 65 20 70 61 72 74 20 6f 66 20 61 20 72 65 63 ve part of a rec
1be50 75 72 73 69 76 65 20 43 54 45 20 2a 2f 0a 23 64 ursive CTE */.#d
1be60 65 66 69 6e 65 20 53 46 5f 46 69 78 65 64 4c 69 efine SF_FixedLi
1be70 6d 69 74 20 20 20 20 20 30 78 30 34 30 30 30 20 mit 0x04000
1be80 20 2f 2a 20 6e 53 65 6c 65 63 74 52 6f 77 20 73 /* nSelectRow s
1be90 65 74 20 62 79 20 61 20 63 6f 6e 73 74 61 6e 74 et by a constant
1bea0 20 4c 49 4d 49 54 20 2a 2f 0a 23 64 65 66 69 6e LIMIT */.#defin
1beb0 65 20 53 46 5f 4d 61 79 62 65 43 6f 6e 76 65 72 e SF_MaybeConver
1bec0 74 20 20 20 30 78 30 38 30 30 30 20 20 2f 2a 20 t 0x08000 /*
1bed0 4e 65 65 64 20 63 6f 6e 76 65 72 74 43 6f 6d 70 Need convertComp
1bee0 6f 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 oundSelectToSubq
1bef0 75 65 72 79 28 29 20 2a 2f 0a 23 64 65 66 69 6e uery() */.#defin
1bf00 65 20 53 46 5f 43 6f 6e 76 65 72 74 65 64 20 20 e SF_Converted
1bf10 20 20 20 20 30 78 31 30 30 30 30 20 20 2f 2a 20 0x10000 /*
1bf20 42 79 20 63 6f 6e 76 65 72 74 43 6f 6d 70 6f 75 By convertCompou
1bf30 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 75 65 ndSelectToSubque
1bf40 72 79 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ry() */.#define
1bf50 53 46 5f 49 6e 63 6c 75 64 65 48 69 64 64 65 6e SF_IncludeHidden
1bf60 20 20 30 78 32 30 30 30 30 20 20 2f 2a 20 49 6e 0x20000 /* In
1bf70 63 6c 75 64 65 20 68 69 64 64 65 6e 20 63 6f 6c clude hidden col
1bf80 75 6d 6e 73 20 69 6e 20 6f 75 74 70 75 74 20 2a umns in output *
1bf90 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 72 65 /.../*.** The re
1bfa0 73 75 6c 74 73 20 6f 66 20 61 20 53 45 4c 45 43 sults of a SELEC
1bfb0 54 20 63 61 6e 20 62 65 20 64 69 73 74 72 69 62 T can be distrib
1bfc0 75 74 65 64 20 69 6e 20 73 65 76 65 72 61 6c 20 uted in several
1bfd0 77 61 79 73 2c 20 61 73 20 64 65 66 69 6e 65 64 ways, as defined
1bfe0 0a 2a 2a 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 .** by one of th
1bff0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 e following macr
1c000 6f 73 2e 20 20 54 68 65 20 22 53 52 54 22 20 70 os. The "SRT" p
1c010 72 65 66 69 78 20 6d 65 61 6e 73 20 22 53 45 4c refix means "SEL
1c020 45 43 54 20 52 65 73 75 6c 74 0a 2a 2a 20 54 79 ECT Result.** Ty
1c030 70 65 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 pe"..**.** S
1c040 52 54 5f 55 6e 69 6f 6e 20 20 20 20 20 20 20 53 RT_Union S
1c050 74 6f 72 65 20 72 65 73 75 6c 74 73 20 61 73 20 tore results as
1c060 61 20 6b 65 79 20 69 6e 20 61 20 74 65 6d 70 6f a key in a tempo
1c070 72 61 72 79 20 69 6e 64 65 78 0a 2a 2a 20 20 20 rary index.**
1c080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c090 20 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 identified by
1c0a0 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e 0a pDest->iSDParm..
1c0b0 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 45 78 **.** SRT_Ex
1c0c0 63 65 70 74 20 20 20 20 20 20 52 65 6d 6f 76 65 cept Remove
1c0d0 20 72 65 73 75 6c 74 73 20 66 72 6f 6d 20 74 68 results from th
1c0e0 65 20 74 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 e temporary inde
1c0f0 78 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d x pDest->iSDParm
1c100 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
1c110 45 78 69 73 74 73 20 20 20 20 20 20 53 74 6f 72 Exists Stor
1c120 65 20 61 20 31 20 69 6e 20 6d 65 6d 6f 72 79 20 e a 1 in memory
1c130 63 65 6c 6c 20 70 44 65 73 74 2d 3e 69 53 44 50 cell pDest->iSDP
1c140 61 72 6d 20 69 66 20 74 68 65 20 72 65 73 75 6c arm if the resul
1c150 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 t.**
1c160 20 20 20 20 20 20 20 20 20 73 65 74 20 69 73 20 set is
1c170 6e 6f 74 20 65 6d 70 74 79 2e 0a 2a 2a 0a 2a 2a not empty..**.**
1c180 20 20 20 20 20 53 52 54 5f 44 69 73 63 61 72 64 SRT_Discard
1c190 20 20 20 20 20 54 68 72 6f 77 20 74 68 65 20 72 Throw the r
1c1a0 65 73 75 6c 74 73 20 61 77 61 79 2e 20 20 54 68 esults away. Th
1c1b0 69 73 20 69 73 20 75 73 65 64 20 62 79 20 53 45 is is used by SE
1c1c0 4c 45 43 54 0a 2a 2a 20 20 20 20 20 20 20 20 20 LECT.**
1c1d0 20 20 20 20 20 20 20 20 20 20 20 20 73 74 61 74 stat
1c1e0 65 6d 65 6e 74 73 20 77 69 74 68 69 6e 20 74 72 ements within tr
1c1f0 69 67 67 65 72 73 20 77 68 6f 73 65 20 6f 6e 6c iggers whose onl
1c200 79 20 70 75 72 70 6f 73 65 20 69 73 0a 2a 2a 20 y purpose is.**
1c210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c220 20 20 20 20 74 68 65 20 73 69 64 65 2d 65 66 66 the side-eff
1c230 65 63 74 73 20 6f 66 20 66 75 6e 63 74 69 6f 6e ects of function
1c240 73 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 6f 66 20 s..**.** All of
1c250 74 68 65 20 61 62 6f 76 65 20 61 72 65 20 66 72 the above are fr
1c260 65 65 20 74 6f 20 69 67 6e 6f 72 65 20 74 68 65 ee to ignore the
1c270 69 72 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 ir ORDER BY clau
1c280 73 65 2e 20 54 68 6f 73 65 20 74 68 61 74 0a 2a se. Those that.*
1c290 2a 20 66 6f 6c 6c 6f 77 20 6d 75 73 74 20 68 6f * follow must ho
1c2a0 6e 6f 72 20 74 68 65 20 4f 52 44 45 52 20 42 59 nor the ORDER BY
1c2b0 20 63 6c 61 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 clause..**.**
1c2c0 20 20 20 53 52 54 5f 4f 75 74 70 75 74 20 20 20 SRT_Output
1c2d0 20 20 20 47 65 6e 65 72 61 74 65 20 61 20 72 6f Generate a ro
1c2e0 77 20 6f 66 20 6f 75 74 70 75 74 20 28 75 73 69 w of output (usi
1c2f0 6e 67 20 74 68 65 20 4f 50 5f 52 65 73 75 6c 74 ng the OP_Result
1c300 52 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 Row.**
1c310 20 20 20 20 20 20 20 20 20 20 20 6f 70 63 6f 64 opcod
1c320 65 29 20 66 6f 72 20 65 61 63 68 20 72 6f 77 20 e) for each row
1c330 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 in the result se
1c340 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 t..**.** SRT
1c350 5f 4d 65 6d 20 20 20 20 20 20 20 20 20 4f 6e 6c _Mem Onl
1c360 79 20 76 61 6c 69 64 20 69 66 20 74 68 65 20 72 y valid if the r
1c370 65 73 75 6c 74 20 69 73 20 61 20 73 69 6e 67 6c esult is a singl
1c380 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 20 20 20 e column..**
1c390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c3a0 20 53 74 6f 72 65 20 74 68 65 20 66 69 72 73 74 Store the first
1c3b0 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 66 column of the f
1c3c0 69 72 73 74 20 72 65 73 75 6c 74 20 72 6f 77 0a irst result row.
1c3d0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1c3e0 20 20 20 20 20 20 20 69 6e 20 72 65 67 69 73 74 in regist
1c3f0 65 72 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 er pDest->iSDPar
1c400 6d 20 74 68 65 6e 20 61 62 61 6e 64 6f 6e 20 74 m then abandon t
1c410 68 65 20 72 65 73 74 0a 2a 2a 20 20 20 20 20 20 he rest.**
1c420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f o
1c430 66 20 74 68 65 20 71 75 65 72 79 2e 20 20 54 68 f the query. Th
1c440 69 73 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 69 is destination i
1c450 6d 70 6c 69 65 73 20 22 4c 49 4d 49 54 20 31 22 mplies "LIMIT 1"
1c460 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
1c470 53 65 74 20 20 20 20 20 20 20 20 20 54 68 65 20 Set The
1c480 72 65 73 75 6c 74 20 6d 75 73 74 20 62 65 20 61 result must be a
1c490 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2e 20 single column.
1c4a0 20 53 74 6f 72 65 20 65 61 63 68 0a 2a 2a 20 20 Store each.**
1c4b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c4c0 20 20 20 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 row of result
1c4d0 20 61 73 20 74 68 65 20 6b 65 79 20 69 6e 20 74 as the key in t
1c4e0 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 50 able pDest->iSDP
1c4f0 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 arm..**
1c500 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 6c Appl
1c510 79 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 70 y the affinity p
1c520 44 65 73 74 2d 3e 61 66 66 53 64 73 74 20 62 65 Dest->affSdst be
1c530 66 6f 72 65 20 73 74 6f 72 69 6e 67 0a 2a 2a 20 fore storing.**
1c540 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c550 20 20 20 20 72 65 73 75 6c 74 73 2e 20 20 55 73 results. Us
1c560 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 ed to implement
1c570 22 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 "IN (SELECT ...)
1c580 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 "..**.** SRT
1c590 5f 45 70 68 65 6d 54 61 62 20 20 20 20 43 72 65 _EphemTab Cre
1c5a0 61 74 65 20 61 6e 20 74 65 6d 70 6f 72 61 72 79 ate an temporary
1c5b0 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 table pDest->iS
1c5c0 44 50 61 72 6d 20 61 6e 64 20 73 74 6f 72 65 0a DParm and store.
1c5d0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1c5e0 20 20 20 20 20 20 20 74 68 65 20 72 65 73 75 6c the resul
1c5f0 74 20 74 68 65 72 65 2e 20 54 68 65 20 63 75 72 t there. The cur
1c600 73 6f 72 20 69 73 20 6c 65 66 74 20 6f 70 65 6e sor is left open
1c610 20 61 66 74 65 72 0a 2a 2a 20 20 20 20 20 20 20 after.**
1c620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
1c630 74 75 72 6e 69 6e 67 2e 20 20 54 68 69 73 20 69 turning. This i
1c640 73 20 6c 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 s like SRT_Table
1c650 20 65 78 63 65 70 74 20 74 68 61 74 0a 2a 2a 20 except that.**
1c660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c670 20 20 20 20 74 68 69 73 20 64 65 73 74 69 6e 61 this destina
1c680 74 69 6f 6e 20 75 73 65 73 20 4f 50 5f 4f 70 65 tion uses OP_Ope
1c690 6e 45 70 68 65 6d 65 72 61 6c 20 74 6f 20 63 72 nEphemeral to cr
1c6a0 65 61 74 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 eate.**
1c6b0 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 the
1c6c0 74 61 62 6c 65 20 66 69 72 73 74 2e 0a 2a 2a 0a table first..**.
1c6d0 2a 2a 20 20 20 20 20 53 52 54 5f 43 6f 72 6f 75 ** SRT_Corou
1c6e0 74 69 6e 65 20 20 20 47 65 6e 65 72 61 74 65 20 tine Generate
1c6f0 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 74 68 61 a co-routine tha
1c700 74 20 72 65 74 75 72 6e 73 20 61 20 6e 65 77 20 t returns a new
1c710 72 6f 77 20 6f 66 0a 2a 2a 20 20 20 20 20 20 20 row of.**
1c720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
1c730 73 75 6c 74 73 20 65 61 63 68 20 74 69 6d 65 20 sults each time
1c740 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 it is invoked.
1c750 54 68 65 20 65 6e 74 72 79 20 70 6f 69 6e 74 0a The entry point.
1c760 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
1c770 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 63 6f of the co
1c780 2d 72 6f 75 74 69 6e 65 20 69 73 20 73 74 6f 72 -routine is stor
1c790 65 64 20 69 6e 20 72 65 67 69 73 74 65 72 20 70 ed in register p
1c7a0 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 0a 2a 2a Dest->iSDParm.**
1c7b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c7c0 20 20 20 20 20 61 6e 64 20 74 68 65 20 72 65 73 and the res
1c7d0 75 6c 74 20 72 6f 77 20 69 73 20 73 74 6f 72 65 ult row is store
1c7e0 64 20 69 6e 20 70 44 65 73 74 2d 3e 6e 44 65 73 d in pDest->nDes
1c7f0 74 20 72 65 67 69 73 74 65 72 73 0a 2a 2a 20 20 t registers.**
1c800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c810 20 20 20 73 74 61 72 74 69 6e 67 20 77 69 74 68 starting with
1c820 20 70 44 65 73 74 2d 3e 69 53 64 73 74 2e 0a 2a pDest->iSdst..*
1c830 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 54 61 62 *.** SRT_Tab
1c840 6c 65 20 20 20 20 20 20 20 53 74 6f 72 65 20 72 le Store r
1c850 65 73 75 6c 74 73 20 69 6e 20 74 65 6d 70 6f 72 esults in tempor
1c860 61 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d ary table pDest-
1c870 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 >iSDParm..**
1c880 20 53 52 54 5f 46 69 66 6f 20 20 20 20 20 20 20 SRT_Fifo
1c890 20 54 68 69 73 20 69 73 20 6c 69 6b 65 20 53 52 This is like SR
1c8a0 54 5f 45 70 68 65 6d 54 61 62 20 65 78 63 65 70 T_EphemTab excep
1c8b0 74 20 74 68 61 74 20 74 68 65 20 74 61 62 6c 65 t that the table
1c8c0 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1c8d0 20 20 20 20 20 20 20 20 69 73 20 61 73 73 75 6d is assum
1c8e0 65 64 20 74 6f 20 61 6c 72 65 61 64 79 20 62 65 ed to already be
1c8f0 20 6f 70 65 6e 2e 20 20 53 52 54 5f 46 69 66 6f open. SRT_Fifo
1c900 20 68 61 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 has.**
1c910 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 the
1c920 61 64 64 69 74 69 6f 6e 61 6c 20 70 72 6f 70 65 additional prope
1c930 72 74 79 20 6f 66 20 62 65 69 6e 67 20 61 62 6c rty of being abl
1c940 65 20 74 6f 20 69 67 6e 6f 72 65 0a 2a 2a 20 20 e to ignore.**
1c950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c960 20 20 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 the ORDER BY
1c970 63 6c 61 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 clause..**.**
1c980 20 20 53 52 54 5f 44 69 73 74 46 69 66 6f 20 20 SRT_DistFifo
1c990 20 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 Store results
1c9a0 69 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 74 in a temporary t
1c9b0 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 50 able pDest->iSDP
1c9c0 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 arm..**
1c9d0 20 20 20 20 20 20 20 20 20 20 20 20 42 75 74 20 But
1c9e0 61 6c 73 6f 20 75 73 65 20 74 65 6d 70 6f 72 61 also use tempora
1c9f0 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e ry table pDest->
1ca00 69 53 44 50 61 72 6d 2b 31 20 61 73 0a 2a 2a 20 iSDParm+1 as.**
1ca10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ca20 20 20 20 20 61 20 72 65 63 6f 72 64 20 6f 66 20 a record of
1ca30 61 6c 6c 20 70 72 69 6f 72 20 72 65 73 75 6c 74 all prior result
1ca40 73 20 61 6e 64 20 69 67 6e 6f 72 65 20 61 6e 79 s and ignore any
1ca50 20 64 75 70 6c 69 63 61 74 65 0a 2a 2a 20 20 20 duplicate.**
1ca60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ca70 20 20 72 6f 77 73 2e 20 20 4e 61 6d 65 20 6d 65 rows. Name me
1ca80 61 6e 73 3a 20 20 22 44 69 73 74 69 6e 63 74 20 ans: "Distinct
1ca90 46 69 66 6f 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 Fifo"..**.**
1caa0 20 53 52 54 5f 51 75 65 75 65 20 20 20 20 20 20 SRT_Queue
1cab0 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 69 Store results i
1cac0 6e 20 70 72 69 6f 72 69 74 79 20 71 75 65 75 65 n priority queue
1cad0 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 pDest->iSDParm
1cae0 28 72 65 61 6c 6c 79 0a 2a 2a 20 20 20 20 20 20 (really.**
1caf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 a
1cb00 6e 20 69 6e 64 65 78 29 2e 20 20 41 70 70 65 6e n index). Appen
1cb10 64 20 61 20 73 65 71 75 65 6e 63 65 20 6e 75 6d d a sequence num
1cb20 62 65 72 20 73 6f 20 74 68 61 74 20 61 6c 6c 20 ber so that all
1cb30 65 6e 74 72 69 65 73 0a 2a 2a 20 20 20 20 20 20 entries.**
1cb40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 a
1cb50 72 65 20 64 69 73 74 69 6e 63 74 2e 0a 2a 2a 0a re distinct..**.
1cb60 2a 2a 20 20 20 20 20 53 52 54 5f 44 69 73 74 51 ** SRT_DistQ
1cb70 75 65 75 65 20 20 20 53 74 6f 72 65 20 72 65 73 ueue Store res
1cb80 75 6c 74 73 20 69 6e 20 70 72 69 6f 72 69 74 79 ults in priority
1cb90 20 71 75 65 75 65 20 70 44 65 73 74 2d 3e 69 53 queue pDest->iS
1cba0 44 50 61 72 6d 20 6f 6e 6c 79 20 69 66 0a 2a 2a DParm only if.**
1cbb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cbc0 20 20 20 20 20 74 68 65 20 73 61 6d 65 20 72 65 the same re
1cbd0 63 6f 72 64 20 68 61 73 20 6e 65 76 65 72 20 62 cord has never b
1cbe0 65 65 6e 20 73 74 6f 72 65 64 20 62 65 66 6f 72 een stored befor
1cbf0 65 2e 20 20 54 68 65 0a 2a 2a 20 20 20 20 20 20 e. The.**
1cc00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
1cc10 6e 64 65 78 20 61 74 20 70 44 65 73 74 2d 3e 69 ndex at pDest->i
1cc20 53 44 50 61 72 6d 2b 31 20 68 6f 6c 64 20 61 6c SDParm+1 hold al
1cc30 6c 20 70 72 69 6f 72 20 73 74 6f 72 65 73 2e 0a l prior stores..
1cc40 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 55 */.#define SRT_U
1cc50 6e 69 6f 6e 20 20 20 20 20 20 20 20 31 20 20 2f nion 1 /
1cc60 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 * Store result a
1cc70 73 20 6b 65 79 73 20 69 6e 20 61 6e 20 69 6e 64 s keys in an ind
1cc80 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 ex */.#define SR
1cc90 54 5f 45 78 63 65 70 74 20 20 20 20 20 20 20 32 T_Except 2
1cca0 20 20 2f 2a 20 52 65 6d 6f 76 65 20 72 65 73 75 /* Remove resu
1ccb0 6c 74 20 66 72 6f 6d 20 61 20 55 4e 49 4f 4e 20 lt from a UNION
1ccc0 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 index */.#define
1ccd0 20 53 52 54 5f 45 78 69 73 74 73 20 20 20 20 20 SRT_Exists
1cce0 20 20 33 20 20 2f 2a 20 53 74 6f 72 65 20 31 20 3 /* Store 1
1ccf0 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 if the result is
1cd00 20 6e 6f 74 20 65 6d 70 74 79 20 2a 2f 0a 23 64 not empty */.#d
1cd10 65 66 69 6e 65 20 53 52 54 5f 44 69 73 63 61 72 efine SRT_Discar
1cd20 64 20 20 20 20 20 20 34 20 20 2f 2a 20 44 6f 20 d 4 /* Do
1cd30 6e 6f 74 20 73 61 76 65 20 74 68 65 20 72 65 73 not save the res
1cd40 75 6c 74 73 20 61 6e 79 77 68 65 72 65 20 2a 2f ults anywhere */
1cd50 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 46 69 66 .#define SRT_Fif
1cd60 6f 20 20 20 20 20 20 20 20 20 35 20 20 2f 2a 20 o 5 /*
1cd70 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 73 20 Store result as
1cd80 64 61 74 61 20 77 69 74 68 20 61 6e 20 61 75 74 data with an aut
1cd90 6f 6d 61 74 69 63 20 72 6f 77 69 64 20 2a 2f 0a omatic rowid */.
1cda0 23 64 65 66 69 6e 65 20 53 52 54 5f 44 69 73 74 #define SRT_Dist
1cdb0 46 69 66 6f 20 20 20 20 20 36 20 20 2f 2a 20 4c Fifo 6 /* L
1cdc0 69 6b 65 20 53 52 54 5f 46 69 66 6f 2c 20 62 75 ike SRT_Fifo, bu
1cdd0 74 20 75 6e 69 71 75 65 20 72 65 73 75 6c 74 73 t unique results
1cde0 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 only */.#define
1cdf0 20 53 52 54 5f 51 75 65 75 65 20 20 20 20 20 20 SRT_Queue
1ce00 20 20 37 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 7 /* Store re
1ce10 73 75 6c 74 20 69 6e 20 61 6e 20 71 75 65 75 65 sult in an queue
1ce20 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f */.#define SRT_
1ce30 44 69 73 74 51 75 65 75 65 20 20 20 20 38 20 20 DistQueue 8
1ce40 2f 2a 20 4c 69 6b 65 20 53 52 54 5f 51 75 65 75 /* Like SRT_Queu
1ce50 65 2c 20 62 75 74 20 75 6e 69 71 75 65 20 72 65 e, but unique re
1ce60 73 75 6c 74 73 20 6f 6e 6c 79 20 2a 2f 0a 0a 2f sults only */../
1ce70 2a 20 54 68 65 20 4f 52 44 45 52 20 42 59 20 63 * The ORDER BY c
1ce80 6c 61 75 73 65 20 69 73 20 69 67 6e 6f 72 65 64 lause is ignored
1ce90 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 20 for all of the
1cea0 61 62 6f 76 65 20 2a 2f 0a 23 64 65 66 69 6e 65 above */.#define
1ceb0 20 49 67 6e 6f 72 61 62 6c 65 4f 72 64 65 72 62 IgnorableOrderb
1cec0 79 28 58 29 20 28 28 58 2d 3e 65 44 65 73 74 29 y(X) ((X->eDest)
1ced0 3c 3d 53 52 54 5f 44 69 73 74 51 75 65 75 65 29 <=SRT_DistQueue)
1cee0 0a 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 4f 75 ..#define SRT_Ou
1cef0 74 70 75 74 20 20 20 20 20 20 20 39 20 20 2f 2a tput 9 /*
1cf00 20 4f 75 74 70 75 74 20 65 61 63 68 20 72 6f 77 Output each row
1cf10 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a 23 64 of result */.#d
1cf20 65 66 69 6e 65 20 53 52 54 5f 4d 65 6d 20 20 20 efine SRT_Mem
1cf30 20 20 20 20 20 20 31 30 20 20 2f 2a 20 53 74 6f 10 /* Sto
1cf40 72 65 20 72 65 73 75 6c 74 20 69 6e 20 61 20 6d re result in a m
1cf50 65 6d 6f 72 79 20 63 65 6c 6c 20 2a 2f 0a 23 64 emory cell */.#d
1cf60 65 66 69 6e 65 20 53 52 54 5f 53 65 74 20 20 20 efine SRT_Set
1cf70 20 20 20 20 20 20 31 31 20 20 2f 2a 20 53 74 6f 11 /* Sto
1cf80 72 65 20 72 65 73 75 6c 74 73 20 61 73 20 6b 65 re results as ke
1cf90 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 2a ys in an index *
1cfa0 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 70 /.#define SRT_Ep
1cfb0 68 65 6d 54 61 62 20 20 20 20 31 32 20 20 2f 2a hemTab 12 /*
1cfc0 20 43 72 65 61 74 65 20 74 72 61 6e 73 69 65 6e Create transien
1cfd0 74 20 74 61 62 20 61 6e 64 20 73 74 6f 72 65 20 t tab and store
1cfe0 6c 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 20 2a like SRT_Table *
1cff0 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 43 6f /.#define SRT_Co
1d000 72 6f 75 74 69 6e 65 20 20 20 31 33 20 20 2f 2a routine 13 /*
1d010 20 47 65 6e 65 72 61 74 65 20 61 20 73 69 6e 67 Generate a sing
1d020 6c 65 20 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 le row of result
1d030 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f */.#define SRT_
1d040 54 61 62 6c 65 20 20 20 20 20 20 20 31 34 20 20 Table 14
1d050 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 /* Store result
1d060 61 73 20 64 61 74 61 20 77 69 74 68 20 61 6e 20 as data with an
1d070 61 75 74 6f 6d 61 74 69 63 20 72 6f 77 69 64 20 automatic rowid
1d080 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 */../*.** An ins
1d090 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f 62 tance of this ob
1d0a0 6a 65 63 74 20 64 65 73 63 72 69 62 65 73 20 77 ject describes w
1d0b0 68 65 72 65 20 74 6f 20 70 75 74 20 6f 66 20 74 here to put of t
1d0c0 68 65 20 72 65 73 75 6c 74 73 20 6f 66 0a 2a 2a he results of.**
1d0d0 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d a SELECT statem
1d0e0 65 6e 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 ent..*/.struct S
1d0f0 65 6c 65 63 74 44 65 73 74 20 7b 0a 20 20 75 38 electDest {. u8
1d100 20 65 44 65 73 74 3b 20 20 20 20 20 20 20 20 20 eDest;
1d110 20 20 20 2f 2a 20 48 6f 77 20 74 6f 20 64 69 73 /* How to dis
1d120 70 6f 73 65 20 6f 66 20 74 68 65 20 72 65 73 75 pose of the resu
1d130 6c 74 73 2e 20 20 4f 6e 20 6f 66 20 53 52 54 5f lts. On of SRT_
1d140 2a 20 61 62 6f 76 65 2e 20 2a 2f 0a 20 20 63 68 * above. */. ch
1d150 61 72 20 2a 7a 41 66 66 53 64 73 74 3b 20 20 20 ar *zAffSdst;
1d160 20 20 20 2f 2a 20 41 66 66 69 6e 69 74 79 20 75 /* Affinity u
1d170 73 65 64 20 77 68 65 6e 20 65 44 65 73 74 3d 3d sed when eDest==
1d180 53 52 54 5f 53 65 74 20 2a 2f 0a 20 20 69 6e 74 SRT_Set */. int
1d190 20 69 53 44 50 61 72 6d 3b 20 20 20 20 20 20 20 iSDParm;
1d1a0 20 20 2f 2a 20 41 20 70 61 72 61 6d 65 74 65 72 /* A parameter
1d1b0 20 75 73 65 64 20 62 79 20 74 68 65 20 65 44 65 used by the eDe
1d1c0 73 74 20 64 69 73 70 6f 73 61 6c 20 6d 65 74 68 st disposal meth
1d1d0 6f 64 20 2a 2f 0a 20 20 69 6e 74 20 69 53 64 73 od */. int iSds
1d1e0 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
1d1f0 42 61 73 65 20 72 65 67 69 73 74 65 72 20 77 68 Base register wh
1d200 65 72 65 20 72 65 73 75 6c 74 73 20 61 72 65 20 ere results are
1d210 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 69 6e 74 written */. int
1d220 20 6e 53 64 73 74 3b 20 20 20 20 20 20 20 20 20 nSdst;
1d230 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 /* Number of r
1d240 65 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 egisters allocat
1d250 65 64 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 ed */. ExprList
1d260 20 2a 70 4f 72 64 65 72 42 79 3b 20 20 2f 2a 20 *pOrderBy; /*
1d270 4b 65 79 20 63 6f 6c 75 6d 6e 73 20 66 6f 72 20 Key columns for
1d280 53 52 54 5f 51 75 65 75 65 20 61 6e 64 20 53 52 SRT_Queue and SR
1d290 54 5f 44 69 73 74 51 75 65 75 65 20 2a 2f 0a 7d T_DistQueue */.}
1d2a0 3b 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 20 ;../*.** During
1d2b0 63 6f 64 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 code generation
1d2c0 6f 66 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68 of statements th
1d2d0 61 74 20 64 6f 20 69 6e 73 65 72 74 73 20 69 6e at do inserts in
1d2e0 74 6f 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 to AUTOINCREMENT
1d2f0 0a 2a 2a 20 74 61 62 6c 65 73 2c 20 74 68 65 20 .** tables, the
1d300 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d following inform
1d310 61 74 69 6f 6e 20 69 73 20 61 74 74 61 63 68 65 ation is attache
1d320 64 20 74 6f 20 74 68 65 20 54 61 62 6c 65 2e 75 d to the Table.u
1d330 2e 61 75 74 6f 49 6e 63 2e 70 0a 2a 2a 20 70 6f .autoInc.p.** po
1d340 69 6e 74 65 72 20 6f 66 20 65 61 63 68 20 61 75 inter of each au
1d350 74 6f 69 6e 63 72 65 6d 65 6e 74 20 74 61 62 6c toincrement tabl
1d360 65 20 74 6f 20 72 65 63 6f 72 64 20 73 6f 6d 65 e to record some
1d370 20 73 69 64 65 20 69 6e 66 6f 72 6d 61 74 69 6f side informatio
1d380 6e 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 6f n that.** the co
1d390 64 65 20 67 65 6e 65 72 61 74 6f 72 20 6e 65 65 de generator nee
1d3a0 64 73 2e 20 20 57 65 20 68 61 76 65 20 74 6f 20 ds. We have to
1d3b0 6b 65 65 70 20 70 65 72 2d 74 61 62 6c 65 20 61 keep per-table a
1d3c0 75 74 6f 69 6e 63 72 65 6d 65 6e 74 0a 2a 2a 20 utoincrement.**
1d3d0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 63 information in c
1d3e0 61 73 65 20 69 6e 73 65 72 74 73 20 61 72 65 20 ase inserts are
1d3f0 64 6f 6e 65 20 77 69 74 68 69 6e 20 74 72 69 67 done within trig
1d400 67 65 72 73 2e 20 20 54 72 69 67 67 65 72 73 20 gers. Triggers
1d410 64 6f 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 6d 61 6c do not.** normal
1d420 6c 79 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 68 ly coordinate th
1d430 65 69 72 20 61 63 74 69 76 69 74 69 65 73 2c 20 eir activities,
1d440 62 75 74 20 77 65 20 64 6f 20 6e 65 65 64 20 74 but we do need t
1d450 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 68 65 o coordinate the
1d460 0a 2a 2a 20 6c 6f 61 64 69 6e 67 20 61 6e 64 20 .** loading and
1d470 73 61 76 69 6e 67 20 6f 66 20 61 75 74 6f 69 6e saving of autoin
1d480 63 72 65 6d 65 6e 74 20 69 6e 66 6f 72 6d 61 74 crement informat
1d490 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 41 ion..*/.struct A
1d4a0 75 74 6f 69 6e 63 49 6e 66 6f 20 7b 0a 20 20 41 utoincInfo {. A
1d4b0 75 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 4e 65 78 utoincInfo *pNex
1d4c0 74 3b 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 66 t; /* Next inf
1d4d0 6f 20 62 6c 6f 63 6b 20 69 6e 20 61 20 6c 69 73 o block in a lis
1d4e0 74 20 6f 66 20 74 68 65 6d 20 61 6c 6c 20 2a 2f t of them all */
1d4f0 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 . Table *pTab;
1d500 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c /* Tabl
1d510 65 20 74 68 69 73 20 69 6e 66 6f 20 62 6c 6f 63 e this info bloc
1d520 6b 20 72 65 66 65 72 73 20 74 6f 20 2a 2f 0a 20 k refers to */.
1d530 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20 20 20 int iDb;
1d540 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 /* Index
1d550 69 6e 20 73 71 6c 69 74 65 33 2e 61 44 62 5b 5d in sqlite3.aDb[]
1d560 20 6f 66 20 64 61 74 61 62 61 73 65 20 68 6f 6c of database hol
1d570 64 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20 69 ding pTab */. i
1d580 6e 74 20 72 65 67 43 74 72 3b 20 20 20 20 20 20 nt regCtr;
1d590 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 72 /* Memory r
1d5a0 65 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 egister holding
1d5b0 74 68 65 20 72 6f 77 69 64 20 63 6f 75 6e 74 65 the rowid counte
1d5c0 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 r */.};../*.** S
1d5d0 69 7a 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d ize of the colum
1d5e0 6e 20 63 61 63 68 65 0a 2a 2f 0a 23 69 66 6e 64 n cache.*/.#ifnd
1d5f0 65 66 20 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 ef SQLITE_N_COLC
1d600 41 43 48 45 0a 23 20 64 65 66 69 6e 65 20 53 51 ACHE.# define SQ
1d610 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 20 LITE_N_COLCACHE
1d620 31 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 10.#endif../*.**
1d630 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 69 6e At least one in
1d640 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
1d650 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
1d660 65 20 69 73 20 63 72 65 61 74 65 64 20 66 6f 72 e is created for
1d670 20 65 61 63 68 0a 2a 2a 20 74 72 69 67 67 65 72 each.** trigger
1d680 20 74 68 61 74 20 6d 61 79 20 62 65 20 66 69 72 that may be fir
1d690 65 64 20 77 68 69 6c 65 20 70 61 72 73 69 6e 67 ed while parsing
1d6a0 20 61 6e 20 49 4e 53 45 52 54 2c 20 55 50 44 41 an INSERT, UPDA
1d6b0 54 45 20 6f 72 20 44 45 4c 45 54 45 0a 2a 2a 20 TE or DELETE.**
1d6c0 73 74 61 74 65 6d 65 6e 74 2e 20 41 6c 6c 20 73 statement. All s
1d6d0 75 63 68 20 6f 62 6a 65 63 74 73 20 61 72 65 20 uch objects are
1d6e0 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 6c 69 stored in the li
1d6f0 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 64 65 64 nked list headed
1d700 20 61 74 0a 2a 2a 20 50 61 72 73 65 2e 70 54 72 at.** Parse.pTr
1d710 69 67 67 65 72 50 72 67 20 61 6e 64 20 64 65 6c iggerPrg and del
1d720 65 74 65 64 20 6f 6e 63 65 20 73 74 61 74 65 6d eted once statem
1d730 65 6e 74 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 ent compilation
1d740 68 61 73 20 62 65 65 6e 0a 2a 2a 20 63 6f 6d 70 has been.** comp
1d750 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 56 leted..**.** A V
1d760 64 62 65 20 73 75 62 2d 70 72 6f 67 72 61 6d 20 dbe sub-program
1d770 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 that implements
1d780 74 68 65 20 62 6f 64 79 20 61 6e 64 20 57 48 45 the body and WHE
1d790 4e 20 63 6c 61 75 73 65 20 6f 66 20 74 72 69 67 N clause of trig
1d7a0 67 65 72 0a 2a 2a 20 54 72 69 67 67 65 72 50 72 ger.** TriggerPr
1d7b0 67 2e 70 54 72 69 67 67 65 72 2c 20 61 73 73 75 g.pTrigger, assu
1d7c0 6d 69 6e 67 20 61 20 64 65 66 61 75 6c 74 20 4f ming a default O
1d7d0 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 N CONFLICT claus
1d7e0 65 20 6f 66 0a 2a 2a 20 54 72 69 67 67 65 72 50 e of.** TriggerP
1d7f0 72 67 2e 6f 72 63 6f 6e 66 2c 20 69 73 20 73 74 rg.orconf, is st
1d800 6f 72 65 64 20 69 6e 20 74 68 65 20 54 72 69 67 ored in the Trig
1d810 67 65 72 50 72 67 2e 70 50 72 6f 67 72 61 6d 20 gerPrg.pProgram
1d820 76 61 72 69 61 62 6c 65 2e 0a 2a 2a 20 54 68 65 variable..** The
1d830 20 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 Parse.pTriggerP
1d840 72 67 20 6c 69 73 74 20 6e 65 76 65 72 20 63 6f rg list never co
1d850 6e 74 61 69 6e 73 20 74 77 6f 20 65 6e 74 72 69 ntains two entri
1d860 65 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 es with the same
1d870 0a 2a 2a 20 76 61 6c 75 65 73 20 66 6f 72 20 62 .** values for b
1d880 6f 74 68 20 70 54 72 69 67 67 65 72 20 61 6e 64 oth pTrigger and
1d890 20 6f 72 63 6f 6e 66 2e 0a 2a 2a 0a 2a 2a 20 54 orconf..**.** T
1d8a0 68 65 20 54 72 69 67 67 65 72 50 72 67 2e 61 43 he TriggerPrg.aC
1d8b0 6f 6c 6d 61 73 6b 5b 30 5d 20 76 61 72 69 61 62 olmask[0] variab
1d8c0 6c 65 20 69 73 20 73 65 74 20 74 6f 20 61 20 6d le is set to a m
1d8d0 61 73 6b 20 6f 66 20 6f 6c 64 2e 2a 20 63 6f 6c ask of old.* col
1d8e0 75 6d 6e 73 0a 2a 2a 20 61 63 63 65 73 73 65 64 umns.** accessed
1d8f0 20 28 6f 72 20 73 65 74 20 74 6f 20 30 20 66 6f (or set to 0 fo
1d900 72 20 74 72 69 67 67 65 72 73 20 66 69 72 65 64 r triggers fired
1d910 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20 as a result of
1d920 49 4e 53 45 52 54 0a 2a 2a 20 73 74 61 74 65 6d INSERT.** statem
1d930 65 6e 74 73 29 2e 20 53 69 6d 69 6c 61 72 6c 79 ents). Similarly
1d940 2c 20 74 68 65 20 54 72 69 67 67 65 72 50 72 67 , the TriggerPrg
1d950 2e 61 43 6f 6c 6d 61 73 6b 5b 31 5d 20 76 61 72 .aColmask[1] var
1d960 69 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f 0a iable is set to.
1d970 2a 2a 20 61 20 6d 61 73 6b 20 6f 66 20 6e 65 77 ** a mask of new
1d980 2e 2a 20 63 6f 6c 75 6d 6e 73 20 75 73 65 64 20 .* columns used
1d990 62 79 20 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a by the program..
1d9a0 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 65 */.struct Trigge
1d9b0 72 50 72 67 20 7b 0a 20 20 54 72 69 67 67 65 72 rPrg {. Trigger
1d9c0 20 2a 70 54 72 69 67 67 65 72 3b 20 20 20 20 20 *pTrigger;
1d9d0 20 2f 2a 20 54 72 69 67 67 65 72 20 74 68 69 73 /* Trigger this
1d9e0 20 70 72 6f 67 72 61 6d 20 77 61 73 20 63 6f 64 program was cod
1d9f0 65 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 54 72 69 ed from */. Tri
1da00 67 67 65 72 50 72 67 20 2a 70 4e 65 78 74 3b 20 ggerPrg *pNext;
1da10 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 65 6e 74 /* Next ent
1da20 72 79 20 69 6e 20 50 61 72 73 65 2e 70 54 72 69 ry in Parse.pTri
1da30 67 67 65 72 50 72 67 20 6c 69 73 74 20 2a 2f 0a ggerPrg list */.
1da40 20 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 70 50 SubProgram *pP
1da50 72 6f 67 72 61 6d 3b 20 20 20 2f 2a 20 50 72 6f rogram; /* Pro
1da60 67 72 61 6d 20 69 6d 70 6c 65 6d 65 6e 74 69 6e gram implementin
1da70 67 20 70 54 72 69 67 67 65 72 2f 6f 72 63 6f 6e g pTrigger/orcon
1da80 66 20 2a 2f 0a 20 20 69 6e 74 20 6f 72 63 6f 6e f */. int orcon
1da90 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f f; /
1daa0 2a 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 4f 4e * Default ON CON
1dab0 46 4c 49 43 54 20 70 6f 6c 69 63 79 20 2a 2f 0a FLICT policy */.
1dac0 20 20 75 33 32 20 61 43 6f 6c 6d 61 73 6b 5b 32 u32 aColmask[2
1dad0 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 ]; /* Mas
1dae0 6b 73 20 6f 66 20 6f 6c 64 2e 2a 2c 20 6e 65 77 ks of old.*, new
1daf0 2e 2a 20 63 6f 6c 75 6d 6e 73 20 61 63 63 65 73 .* columns acces
1db00 73 65 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a sed */.};../*.**
1db10 20 54 68 65 20 79 44 62 4d 61 73 6b 20 64 61 74 The yDbMask dat
1db20 61 74 79 70 65 20 66 6f 72 20 74 68 65 20 62 69 atype for the bi
1db30 74 6d 61 73 6b 20 6f 66 20 61 6c 6c 20 61 74 74 tmask of all att
1db40 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73 2e ached databases.
1db50 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d .*/.#if SQLITE_M
1db60 41 58 5f 41 54 54 41 43 48 45 44 3e 33 30 0a 20 AX_ATTACHED>30.
1db70 20 74 79 70 65 64 65 66 20 75 6e 73 69 67 6e 65 typedef unsigne
1db80 64 20 63 68 61 72 20 79 44 62 4d 61 73 6b 5b 28 d char yDbMask[(
1db90 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 SQLITE_MAX_ATTAC
1dba0 48 45 44 2b 39 29 2f 38 5d 3b 0a 23 20 64 65 66 HED+9)/8];.# def
1dbb0 69 6e 65 20 44 62 4d 61 73 6b 54 65 73 74 28 4d ine DbMaskTest(M
1dbc0 2c 49 29 20 20 20 20 28 28 28 4d 29 5b 28 49 29 ,I) (((M)[(I)
1dbd0 2f 38 5d 26 28 31 3c 3c 28 28 49 29 26 37 29 29 /8]&(1<<((I)&7))
1dbe0 29 21 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 44 )!=0).# define D
1dbf0 62 4d 61 73 6b 5a 65 72 6f 28 4d 29 20 20 20 20 bMaskZero(M)
1dc00 20 20 6d 65 6d 73 65 74 28 28 4d 29 2c 30 2c 73 memset((M),0,s
1dc10 69 7a 65 6f 66 28 4d 29 29 0a 23 20 64 65 66 69 izeof(M)).# defi
1dc20 6e 65 20 44 62 4d 61 73 6b 53 65 74 28 4d 2c 49 ne DbMaskSet(M,I
1dc30 29 20 20 20 20 20 28 4d 29 5b 28 49 29 2f 38 5d ) (M)[(I)/8]
1dc40 7c 3d 28 31 3c 3c 28 28 49 29 26 37 29 29 0a 23 |=(1<<((I)&7)).#
1dc50 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 41 6c define DbMaskAl
1dc60 6c 5a 65 72 6f 28 4d 29 20 20 20 73 71 6c 69 74 lZero(M) sqlit
1dc70 65 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 e3DbMaskAllZero(
1dc80 4d 29 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 M).# define DbMa
1dc90 73 6b 4e 6f 6e 5a 65 72 6f 28 4d 29 20 20 20 28 skNonZero(M) (
1dca0 73 71 6c 69 74 65 33 44 62 4d 61 73 6b 41 6c 6c sqlite3DbMaskAll
1dcb0 5a 65 72 6f 28 4d 29 3d 3d 30 29 0a 23 65 6c 73 Zero(M)==0).#els
1dcc0 65 0a 20 20 74 79 70 65 64 65 66 20 75 6e 73 69 e. typedef unsi
1dcd0 67 6e 65 64 20 69 6e 74 20 79 44 62 4d 61 73 6b gned int yDbMask
1dce0 3b 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 ;.# define DbMas
1dcf0 6b 54 65 73 74 28 4d 2c 49 29 20 20 20 20 28 28 kTest(M,I) ((
1dd00 28 4d 29 26 28 28 28 79 44 62 4d 61 73 6b 29 31 (M)&(((yDbMask)1
1dd10 29 3c 3c 28 49 29 29 29 21 3d 30 29 0a 23 20 64 )<<(I)))!=0).# d
1dd20 65 66 69 6e 65 20 44 62 4d 61 73 6b 5a 65 72 6f efine DbMaskZero
1dd30 28 4d 29 20 20 20 20 20 20 28 4d 29 3d 30 0a 23 (M) (M)=0.#
1dd40 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 53 65 define DbMaskSe
1dd50 74 28 4d 2c 49 29 20 20 20 20 20 28 4d 29 7c 3d t(M,I) (M)|=
1dd60 28 28 28 79 44 62 4d 61 73 6b 29 31 29 3c 3c 28 (((yDbMask)1)<<(
1dd70 49 29 29 0a 23 20 64 65 66 69 6e 65 20 44 62 4d I)).# define DbM
1dd80 61 73 6b 41 6c 6c 5a 65 72 6f 28 4d 29 20 20 20 askAllZero(M)
1dd90 28 4d 29 3d 3d 30 0a 23 20 64 65 66 69 6e 65 20 (M)==0.# define
1dda0 44 62 4d 61 73 6b 4e 6f 6e 5a 65 72 6f 28 4d 29 DbMaskNonZero(M)
1ddb0 20 20 20 28 4d 29 21 3d 30 0a 23 65 6e 64 69 66 (M)!=0.#endif
1ddc0 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 53 51 4c 20 70 ../*.** An SQL p
1ddd0 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 20 arser context.
1dde0 41 20 63 6f 70 79 20 6f 66 20 74 68 69 73 20 73 A copy of this s
1ddf0 74 72 75 63 74 75 72 65 20 69 73 20 70 61 73 73 tructure is pass
1de00 65 64 20 74 68 72 6f 75 67 68 0a 2a 2a 20 74 68 ed through.** th
1de10 65 20 70 61 72 73 65 72 20 61 6e 64 20 64 6f 77 e parser and dow
1de20 6e 20 69 6e 74 6f 20 61 6c 6c 20 74 68 65 20 70 n into all the p
1de30 61 72 73 65 72 20 61 63 74 69 6f 6e 20 72 6f 75 arser action rou
1de40 74 69 6e 65 20 69 6e 20 6f 72 64 65 72 20 74 6f tine in order to
1de50 0a 2a 2a 20 63 61 72 72 79 20 61 72 6f 75 6e 64 .** carry around
1de60 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 information tha
1de70 74 20 69 73 20 67 6c 6f 62 61 6c 20 74 6f 20 74 t is global to t
1de80 68 65 20 65 6e 74 69 72 65 20 70 61 72 73 65 2e he entire parse.
1de90 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 74 72 75 63 .**.** The struc
1dea0 74 75 72 65 20 69 73 20 64 69 76 69 64 65 64 20 ture is divided
1deb0 69 6e 74 6f 20 74 77 6f 20 70 61 72 74 73 2e 20 into two parts.
1dec0 20 57 68 65 6e 20 74 68 65 20 70 61 72 73 65 72 When the parser
1ded0 20 61 6e 64 20 63 6f 64 65 0a 2a 2a 20 67 65 6e and code.** gen
1dee0 65 72 61 74 65 20 63 61 6c 6c 20 74 68 65 6d 73 erate call thems
1def0 65 6c 76 65 73 20 72 65 63 75 72 73 69 76 65 6c elves recursivel
1df00 79 2c 20 74 68 65 20 66 69 72 73 74 20 70 61 72 y, the first par
1df10 74 20 6f 66 20 74 68 65 20 73 74 72 75 63 74 75 t of the structu
1df20 72 65 0a 2a 2a 20 69 73 20 63 6f 6e 73 74 61 6e re.** is constan
1df30 74 20 62 75 74 20 74 68 65 20 73 65 63 6f 6e 64 t but the second
1df40 20 70 61 72 74 20 69 73 20 72 65 73 65 74 20 61 part is reset a
1df50 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 t the beginning
1df60 61 6e 64 20 65 6e 64 20 6f 66 0a 2a 2a 20 65 61 and end of.** ea
1df70 63 68 20 72 65 63 75 72 73 69 6f 6e 2e 0a 2a 2a ch recursion..**
1df80 0a 2a 2a 20 54 68 65 20 6e 54 61 62 6c 65 4c 6f .** The nTableLo
1df90 63 6b 20 61 6e 64 20 61 54 61 62 6c 65 4c 6f 63 ck and aTableLoc
1dfa0 6b 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 k variables are
1dfb0 6f 6e 6c 79 20 75 73 65 64 20 69 66 20 74 68 65 only used if the
1dfc0 20 73 68 61 72 65 64 2d 63 61 63 68 65 0a 2a 2a shared-cache.**
1dfd0 20 66 65 61 74 75 72 65 20 69 73 20 65 6e 61 62 feature is enab
1dfe0 6c 65 64 20 28 69 66 20 73 71 6c 69 74 65 33 54 led (if sqlite3T
1dff0 73 64 28 29 2d 3e 75 73 65 53 68 61 72 65 64 44 sd()->useSharedD
1e000 61 74 61 20 69 73 20 74 72 75 65 29 2e 20 54 68 ata is true). Th
1e010 65 79 20 61 72 65 0a 2a 2a 20 75 73 65 64 20 74 ey are.** used t
1e020 6f 20 73 74 6f 72 65 20 74 68 65 20 73 65 74 20 o store the set
1e030 6f 66 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 20 72 of table-locks r
1e040 65 71 75 69 72 65 64 20 62 79 20 74 68 65 20 73 equired by the s
1e050 74 61 74 65 6d 65 6e 74 20 62 65 69 6e 67 0a 2a tatement being.*
1e060 2a 20 63 6f 6d 70 69 6c 65 64 2e 20 46 75 6e 63 * compiled. Func
1e070 74 69 6f 6e 20 73 71 6c 69 74 65 33 54 61 62 6c tion sqlite3Tabl
1e080 65 4c 6f 63 6b 28 29 20 69 73 20 75 73 65 64 20 eLock() is used
1e090 74 6f 20 61 64 64 20 65 6e 74 72 69 65 73 20 74 to add entries t
1e0a0 6f 20 74 68 65 0a 2a 2a 20 6c 69 73 74 2e 0a 2a o the.** list..*
1e0b0 2f 0a 73 74 72 75 63 74 20 50 61 72 73 65 20 7b /.struct Parse {
1e0c0 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 . sqlite3 *db;
1e0d0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d /* The m
1e0e0 61 69 6e 20 64 61 74 61 62 61 73 65 20 73 74 72 ain database str
1e0f0 75 63 74 75 72 65 20 2a 2f 0a 20 20 63 68 61 72 ucture */. char
1e100 20 2a 7a 45 72 72 4d 73 67 3b 20 20 20 20 20 20 *zErrMsg;
1e110 20 2f 2a 20 41 6e 20 65 72 72 6f 72 20 6d 65 73 /* An error mes
1e120 73 61 67 65 20 2a 2f 0a 20 20 56 64 62 65 20 2a sage */. Vdbe *
1e130 70 56 64 62 65 3b 20 20 20 20 20 20 20 20 20 2f pVdbe; /
1e140 2a 20 41 6e 20 65 6e 67 69 6e 65 20 66 6f 72 20 * An engine for
1e150 65 78 65 63 75 74 69 6e 67 20 64 61 74 61 62 61 executing databa
1e160 73 65 20 62 79 74 65 63 6f 64 65 20 2a 2f 0a 20 se bytecode */.
1e170 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 int rc;
1e180 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 /* Return
1e190 63 6f 64 65 20 66 72 6f 6d 20 65 78 65 63 75 74 code from execut
1e1a0 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 63 6f 6c 4e ion */. u8 colN
1e1b0 61 6d 65 73 53 65 74 3b 20 20 20 20 20 20 2f 2a amesSet; /*
1e1c0 20 54 52 55 45 20 61 66 74 65 72 20 4f 50 5f 43 TRUE after OP_C
1e1d0 6f 6c 75 6d 6e 4e 61 6d 65 20 68 61 73 20 62 65 olumnName has be
1e1e0 65 6e 20 69 73 73 75 65 64 20 74 6f 20 70 56 64 en issued to pVd
1e1f0 62 65 20 2a 2f 0a 20 20 75 38 20 63 68 65 63 6b be */. u8 check
1e200 53 63 68 65 6d 61 3b 20 20 20 20 20 20 2f 2a 20 Schema; /*
1e210 43 61 75 73 65 73 20 73 63 68 65 6d 61 20 63 6f Causes schema co
1e220 6f 6b 69 65 20 63 68 65 63 6b 20 61 66 74 65 72 okie check after
1e230 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 75 an error */. u
1e240 38 20 6e 65 73 74 65 64 3b 20 20 20 20 20 20 20 8 nested;
1e250 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1e260 20 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f nested calls to
1e270 20 74 68 65 20 70 61 72 73 65 72 2f 63 6f 64 65 the parser/code
1e280 20 67 65 6e 65 72 61 74 6f 72 20 2a 2f 0a 20 20 generator */.
1e290 75 38 20 6e 54 65 6d 70 52 65 67 3b 20 20 20 20 u8 nTempReg;
1e2a0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1e2b0 66 20 74 65 6d 70 6f 72 61 72 79 20 72 65 67 69 f temporary regi
1e2c0 73 74 65 72 73 20 69 6e 20 61 54 65 6d 70 52 65 sters in aTempRe
1e2d0 67 5b 5d 20 2a 2f 0a 20 20 75 38 20 69 73 4d 75 g[] */. u8 isMu
1e2e0 6c 74 69 57 72 69 74 65 3b 20 20 20 20 20 2f 2a ltiWrite; /*
1e2f0 20 54 72 75 65 20 69 66 20 73 74 61 74 65 6d 65 True if stateme
1e300 6e 74 20 6d 61 79 20 6d 6f 64 69 66 79 2f 69 6e nt may modify/in
1e310 73 65 72 74 20 6d 75 6c 74 69 70 6c 65 20 72 6f sert multiple ro
1e320 77 73 20 2a 2f 0a 20 20 75 38 20 6d 61 79 41 62 ws */. u8 mayAb
1e330 6f 72 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ort; /*
1e340 54 72 75 65 20 69 66 20 73 74 61 74 65 6d 65 6e True if statemen
1e350 74 20 6d 61 79 20 74 68 72 6f 77 20 61 6e 20 41 t may throw an A
1e360 42 4f 52 54 20 65 78 63 65 70 74 69 6f 6e 20 2a BORT exception *
1e370 2f 0a 20 20 75 38 20 68 61 73 43 6f 6d 70 6f 75 /. u8 hasCompou
1e380 6e 64 3b 20 20 20 20 20 20 2f 2a 20 4e 65 65 64 nd; /* Need
1e390 20 74 6f 20 69 6e 76 6f 6b 65 20 63 6f 6e 76 65 to invoke conve
1e3a0 72 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 74 rtCompoundSelect
1e3b0 54 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f 0a ToSubquery() */.
1e3c0 20 20 75 38 20 6f 6b 43 6f 6e 73 74 46 61 63 74 u8 okConstFact
1e3d0 6f 72 3b 20 20 20 20 2f 2a 20 4f 4b 20 74 6f 20 or; /* OK to
1e3e0 66 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e 73 74 factor out const
1e3f0 61 6e 74 73 20 2a 2f 0a 20 20 75 38 20 64 69 73 ants */. u8 dis
1e400 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b 20 2f ableLookaside; /
1e410 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 * Number of time
1e420 73 20 6c 6f 6f 6b 61 73 69 64 65 20 68 61 73 20 s lookaside has
1e430 62 65 65 6e 20 64 69 73 61 62 6c 65 64 20 2a 2f been disabled */
1e440 0a 20 20 75 38 20 6e 43 6f 6c 43 61 63 68 65 3b . u8 nColCache;
1e450 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1e460 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 r of entries in
1e470 61 43 6f 6c 43 61 63 68 65 5b 5d 20 2a 2f 0a 20 aColCache[] */.
1e480 20 69 6e 74 20 61 54 65 6d 70 52 65 67 5b 38 5d int aTempReg[8]
1e490 3b 20 20 20 20 20 2f 2a 20 48 6f 6c 64 69 6e 67 ; /* Holding
1e4a0 20 61 72 65 61 20 66 6f 72 20 74 65 6d 70 6f 72 area for tempor
1e4b0 61 72 79 20 72 65 67 69 73 74 65 72 73 20 2a 2f ary registers */
1e4c0 0a 20 20 69 6e 74 20 6e 52 61 6e 67 65 52 65 67 . int nRangeReg
1e4d0 3b 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 ; /* Size
1e4e0 6f 66 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 of the temporary
1e4f0 20 72 65 67 69 73 74 65 72 20 62 6c 6f 63 6b 20 register block
1e500 2a 2f 0a 20 20 69 6e 74 20 69 52 61 6e 67 65 52 */. int iRangeR
1e510 65 67 3b 20 20 20 20 20 20 20 2f 2a 20 46 69 72 eg; /* Fir
1e520 73 74 20 72 65 67 69 73 74 65 72 20 69 6e 20 74 st register in t
1e530 65 6d 70 6f 72 61 72 79 20 72 65 67 69 73 74 65 emporary registe
1e540 72 20 62 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e 74 r block */. int
1e550 20 6e 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 nErr;
1e560 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 /* Number of e
1e570 72 72 6f 72 73 20 73 65 65 6e 20 2a 2f 0a 20 20 rrors seen */.
1e580 69 6e 74 20 6e 54 61 62 3b 20 20 20 20 20 20 20 int nTab;
1e590 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1e5a0 66 20 70 72 65 76 69 6f 75 73 6c 79 20 61 6c 6c f previously all
1e5b0 6f 63 61 74 65 64 20 56 44 42 45 20 63 75 72 73 ocated VDBE curs
1e5c0 6f 72 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 ors */. int nMe
1e5d0 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a m; /*
1e5e0 20 4e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 Number of memor
1e5f0 79 20 63 65 6c 6c 73 20 75 73 65 64 20 73 6f 20 y cells used so
1e600 66 61 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 65 far */. int nSe
1e610 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a t; /*
1e620 20 4e 75 6d 62 65 72 20 6f 66 20 73 65 74 73 20 Number of sets
1e630 75 73 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 used so far */.
1e640 20 69 6e 74 20 6e 4f 6e 63 65 3b 20 20 20 20 20 int nOnce;
1e650 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
1e660 6f 66 20 4f 50 5f 4f 6e 63 65 20 69 6e 73 74 72 of OP_Once instr
1e670 75 63 74 69 6f 6e 73 20 73 6f 20 66 61 72 20 2a uctions so far *
1e680 2f 0a 20 20 69 6e 74 20 6e 4f 70 41 6c 6c 6f 63 /. int nOpAlloc
1e690 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 ; /* Numb
1e6a0 65 72 20 6f 66 20 73 6c 6f 74 73 20 61 6c 6c 6f er of slots allo
1e6b0 63 61 74 65 64 20 66 6f 72 20 56 64 62 65 2e 61 cated for Vdbe.a
1e6c0 4f 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 73 7a Op[] */. int sz
1e6d0 4f 70 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 2f OpAlloc; /
1e6e0 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 6d 6f 72 * Bytes of memor
1e6f0 79 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 y space allocate
1e700 64 20 66 6f 72 20 56 64 62 65 2e 61 4f 70 5b 5d d for Vdbe.aOp[]
1e710 20 2a 2f 0a 20 20 69 6e 74 20 69 46 69 78 65 64 */. int iFixed
1e720 4f 70 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 Op; /* Ne
1e730 76 65 72 20 62 61 63 6b 20 6f 75 74 20 6f 70 63 ver back out opc
1e740 6f 64 65 73 20 69 46 69 78 65 64 4f 70 2d 31 20 odes iFixedOp-1
1e750 6f 72 20 65 61 72 6c 69 65 72 20 2a 2f 0a 20 20 or earlier */.
1e760 69 6e 74 20 63 6b 42 61 73 65 3b 20 20 20 20 20 int ckBase;
1e770 20 20 20 20 20 2f 2a 20 42 61 73 65 20 72 65 67 /* Base reg
1e780 69 73 74 65 72 20 6f 66 20 64 61 74 61 20 64 75 ister of data du
1e790 72 69 6e 67 20 63 68 65 63 6b 20 63 6f 6e 73 74 ring check const
1e7a0 72 61 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 raints */. int
1e7b0 69 53 65 6c 66 54 61 62 3b 20 20 20 20 20 20 20 iSelfTab;
1e7c0 20 2f 2a 20 54 61 62 6c 65 20 6f 66 20 61 6e 20 /* Table of an
1e7d0 69 6e 64 65 78 20 77 68 6f 73 65 20 65 78 70 72 index whose expr
1e7e0 73 20 61 72 65 20 62 65 69 6e 67 20 63 6f 64 65 s are being code
1e7f0 64 20 2a 2f 0a 20 20 69 6e 74 20 69 43 61 63 68 d */. int iCach
1e800 65 4c 65 76 65 6c 3b 20 20 20 20 20 2f 2a 20 43 eLevel; /* C
1e810 6f 6c 43 61 63 68 65 20 76 61 6c 69 64 20 77 68 olCache valid wh
1e820 65 6e 20 61 43 6f 6c 43 61 63 68 65 5b 5d 2e 69 en aColCache[].i
1e830 4c 65 76 65 6c 3c 3d 69 43 61 63 68 65 4c 65 76 Level<=iCacheLev
1e840 65 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 43 61 63 el */. int iCac
1e850 68 65 43 6e 74 3b 20 20 20 20 20 20 20 2f 2a 20 heCnt; /*
1e860 43 6f 75 6e 74 65 72 20 75 73 65 64 20 74 6f 20 Counter used to
1e870 67 65 6e 65 72 61 74 65 20 61 43 6f 6c 43 61 63 generate aColCac
1e880 68 65 5b 5d 2e 6c 72 75 20 76 61 6c 75 65 73 20 he[].lru values
1e890 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 65 6c 3b */. int nLabel;
1e8a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1e8b0 62 65 72 20 6f 66 20 6c 61 62 65 6c 73 20 75 73 ber of labels us
1e8c0 65 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 4c 61 ed */. int *aLa
1e8d0 62 65 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 bel; /*
1e8e0 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 Space to hold th
1e8f0 65 20 6c 61 62 65 6c 73 20 2a 2f 0a 20 20 73 74 e labels */. st
1e900 72 75 63 74 20 79 43 6f 6c 43 61 63 68 65 20 7b ruct yColCache {
1e910 0a 20 20 20 20 69 6e 74 20 69 54 61 62 6c 65 3b . int iTable;
1e920 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 /* Ta
1e930 62 6c 65 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 ble cursor numbe
1e940 72 20 2a 2f 0a 20 20 20 20 69 31 36 20 69 43 6f r */. i16 iCo
1e950 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 2f lumn; /
1e960 2a 20 54 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 6e * Table column n
1e970 75 6d 62 65 72 20 2a 2f 0a 20 20 20 20 75 38 20 umber */. u8
1e980 74 65 6d 70 52 65 67 3b 20 20 20 20 20 20 20 20 tempReg;
1e990 20 20 20 2f 2a 20 69 52 65 67 20 69 73 20 61 20 /* iReg is a
1e9a0 74 65 6d 70 20 72 65 67 69 73 74 65 72 20 74 68 temp register th
1e9b0 61 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 66 at needs to be f
1e9c0 72 65 65 64 20 2a 2f 0a 20 20 20 20 69 6e 74 20 reed */. int
1e9d0 69 4c 65 76 65 6c 3b 20 20 20 20 20 20 20 20 20 iLevel;
1e9e0 20 20 2f 2a 20 4e 65 73 74 69 6e 67 20 6c 65 76 /* Nesting lev
1e9f0 65 6c 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 52 el */. int iR
1ea00 65 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 eg;
1ea10 2f 2a 20 52 65 67 20 77 69 74 68 20 76 61 6c 75 /* Reg with valu
1ea20 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e e of this column
1ea30 2e 20 30 20 6d 65 61 6e 73 20 6e 6f 6e 65 2e 20 . 0 means none.
1ea40 2a 2f 0a 20 20 20 20 69 6e 74 20 6c 72 75 3b 20 */. int lru;
1ea50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1ea60 4c 65 61 73 74 20 72 65 63 65 6e 74 6c 79 20 75 Least recently u
1ea70 73 65 64 20 65 6e 74 72 79 20 68 61 73 20 74 68 sed entry has th
1ea80 65 20 73 6d 61 6c 6c 65 73 74 20 76 61 6c 75 65 e smallest value
1ea90 20 2a 2f 0a 20 20 7d 20 61 43 6f 6c 43 61 63 68 */. } aColCach
1eaa0 65 5b 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 e[SQLITE_N_COLCA
1eab0 43 48 45 5d 3b 20 20 2f 2a 20 4f 6e 65 20 66 6f CHE]; /* One fo
1eac0 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 63 61 r each column ca
1ead0 63 68 65 20 65 6e 74 72 79 20 2a 2f 0a 20 20 45 che entry */. E
1eae0 78 70 72 4c 69 73 74 20 2a 70 43 6f 6e 73 74 45 xprList *pConstE
1eaf0 78 70 72 3b 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 xpr;/* Constant
1eb00 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
1eb10 20 54 6f 6b 65 6e 20 63 6f 6e 73 74 72 61 69 6e Token constrain
1eb20 74 4e 61 6d 65 3b 2f 2a 20 4e 61 6d 65 20 6f 66 tName;/* Name of
1eb30 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 the constraint
1eb40 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 currently being
1eb50 70 61 72 73 65 64 20 2a 2f 0a 20 20 79 44 62 4d parsed */. yDbM
1eb60 61 73 6b 20 77 72 69 74 65 4d 61 73 6b 3b 20 20 ask writeMask;
1eb70 20 2f 2a 20 53 74 61 72 74 20 61 20 77 72 69 74 /* Start a writ
1eb80 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e e transaction on
1eb90 20 74 68 65 73 65 20 64 61 74 61 62 61 73 65 73 these databases
1eba0 20 2a 2f 0a 20 20 79 44 62 4d 61 73 6b 20 63 6f */. yDbMask co
1ebb0 6f 6b 69 65 4d 61 73 6b 3b 20 20 2f 2a 20 42 69 okieMask; /* Bi
1ebc0 74 6d 61 73 6b 20 6f 66 20 73 63 68 65 6d 61 20 tmask of schema
1ebd0 76 65 72 69 66 69 65 64 20 64 61 74 61 62 61 73 verified databas
1ebe0 65 73 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6f 6b es */. int cook
1ebf0 69 65 56 61 6c 75 65 5b 53 51 4c 49 54 45 5f 4d ieValue[SQLITE_M
1ec00 41 58 5f 41 54 54 41 43 48 45 44 2b 32 5d 3b 20 AX_ATTACHED+2];
1ec10 20 2f 2a 20 56 61 6c 75 65 73 20 6f 66 20 63 6f /* Values of co
1ec20 6f 6b 69 65 73 20 74 6f 20 76 65 72 69 66 79 20 okies to verify
1ec30 2a 2f 0a 20 20 69 6e 74 20 72 65 67 52 6f 77 69 */. int regRowi
1ec40 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 52 65 67 d; /* Reg
1ec50 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 6f ister holding ro
1ec60 77 69 64 20 6f 66 20 43 52 45 41 54 45 20 54 41 wid of CREATE TA
1ec70 42 4c 45 20 65 6e 74 72 79 20 2a 2f 0a 20 20 69 BLE entry */. i
1ec80 6e 74 20 72 65 67 52 6f 6f 74 3b 20 20 20 20 20 nt regRoot;
1ec90 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 /* Register
1eca0 68 6f 6c 64 69 6e 67 20 72 6f 6f 74 20 70 61 67 holding root pag
1ecb0 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 6e 65 77 e number for new
1ecc0 20 6f 62 6a 65 63 74 73 20 2a 2f 0a 20 20 69 6e objects */. in
1ecd0 74 20 6e 4d 61 78 41 72 67 3b 20 20 20 20 20 20 t nMaxArg;
1ece0 20 20 20 2f 2a 20 4d 61 78 20 61 72 67 73 20 70 /* Max args p
1ecf0 61 73 73 65 64 20 74 6f 20 75 73 65 72 20 66 75 assed to user fu
1ed00 6e 63 74 69 6f 6e 20 62 79 20 73 75 62 2d 70 72 nction by sub-pr
1ed10 6f 67 72 61 6d 20 2a 2f 0a 23 69 66 20 53 45 4c ogram */.#if SEL
1ed20 45 43 54 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 ECTTRACE_ENABLED
1ed30 0a 20 20 69 6e 74 20 6e 53 65 6c 65 63 74 3b 20 . int nSelect;
1ed40 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1ed50 72 20 6f 66 20 53 45 4c 45 43 54 20 73 74 61 74 r of SELECT stat
1ed60 65 6d 65 6e 74 73 20 73 65 65 6e 20 2a 2f 0a 20 ements seen */.
1ed70 20 69 6e 74 20 6e 53 65 6c 65 63 74 49 6e 64 65 int nSelectInde
1ed80 6e 74 3b 20 20 20 2f 2a 20 48 6f 77 20 66 61 72 nt; /* How far
1ed90 20 74 6f 20 69 6e 64 65 6e 74 20 53 45 4c 45 43 to indent SELEC
1eda0 54 54 52 41 43 45 28 29 20 6f 75 74 70 75 74 20 TTRACE() output
1edb0 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 */.#endif.#ifnde
1edc0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 f SQLITE_OMIT_SH
1edd0 41 52 45 44 5f 43 41 43 48 45 0a 20 20 69 6e 74 ARED_CACHE. int
1ede0 20 6e 54 61 62 6c 65 4c 6f 63 6b 3b 20 20 20 20 nTableLock;
1edf0 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1ee00 20 6c 6f 63 6b 73 20 69 6e 20 61 54 61 62 6c 65 locks in aTable
1ee10 4c 6f 63 6b 20 2a 2f 0a 20 20 54 61 62 6c 65 4c Lock */. TableL
1ee20 6f 63 6b 20 2a 61 54 61 62 6c 65 4c 6f 63 6b 3b ock *aTableLock;
1ee30 20 2f 2a 20 52 65 71 75 69 72 65 64 20 74 61 62 /* Required tab
1ee40 6c 65 20 6c 6f 63 6b 73 20 66 6f 72 20 73 68 61 le locks for sha
1ee50 72 65 64 2d 63 61 63 68 65 20 6d 6f 64 65 20 2a red-cache mode *
1ee60 2f 0a 23 65 6e 64 69 66 0a 20 20 41 75 74 6f 69 /.#endif. Autoi
1ee70 6e 63 49 6e 66 6f 20 2a 70 41 69 6e 63 3b 20 20 ncInfo *pAinc;
1ee80 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 /* Information a
1ee90 62 6f 75 74 20 41 55 54 4f 49 4e 43 52 45 4d 45 bout AUTOINCREME
1eea0 4e 54 20 63 6f 75 6e 74 65 72 73 20 2a 2f 0a 0a NT counters */..
1eeb0 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e /* Information
1eec0 20 75 73 65 64 20 77 68 69 6c 65 20 63 6f 64 69 used while codi
1eed0 6e 67 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 ng trigger progr
1eee0 61 6d 73 2e 20 2a 2f 0a 20 20 50 61 72 73 65 20 ams. */. Parse
1eef0 2a 70 54 6f 70 6c 65 76 65 6c 3b 20 20 20 20 2f *pToplevel; /
1ef00 2a 20 50 61 72 73 65 20 73 74 72 75 63 74 75 72 * Parse structur
1ef10 65 20 66 6f 72 20 6d 61 69 6e 20 70 72 6f 67 72 e for main progr
1ef20 61 6d 20 28 6f 72 20 4e 55 4c 4c 29 20 2a 2f 0a am (or NULL) */.
1ef30 20 20 54 61 62 6c 65 20 2a 70 54 72 69 67 67 65 Table *pTrigge
1ef40 72 54 61 62 3b 20 20 2f 2a 20 54 61 62 6c 65 20 rTab; /* Table
1ef50 74 72 69 67 67 65 72 73 20 61 72 65 20 62 65 69 triggers are bei
1ef60 6e 67 20 63 6f 64 65 64 20 66 6f 72 20 2a 2f 0a ng coded for */.
1ef70 20 20 69 6e 74 20 61 64 64 72 43 72 54 61 62 3b int addrCrTab;
1ef80 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 /* Addres
1ef90 73 20 6f 66 20 4f 50 5f 43 72 65 61 74 65 54 61 s of OP_CreateTa
1efa0 62 6c 65 20 6f 70 63 6f 64 65 20 6f 6e 20 43 52 ble opcode on CR
1efb0 45 41 54 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 EATE TABLE */.
1efc0 75 33 32 20 6e 51 75 65 72 79 4c 6f 6f 70 3b 20 u32 nQueryLoop;
1efd0 20 20 20 20 20 2f 2a 20 45 73 74 20 6e 75 6d 62 /* Est numb
1efe0 65 72 20 6f 66 20 69 74 65 72 61 74 69 6f 6e 73 er of iterations
1eff0 20 6f 66 20 61 20 71 75 65 72 79 20 28 31 30 2a of a query (10*
1f000 6c 6f 67 32 28 4e 29 29 20 2a 2f 0a 20 20 75 33 log2(N)) */. u3
1f010 32 20 6f 6c 64 6d 61 73 6b 3b 20 20 20 20 20 20 2 oldmask;
1f020 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 6f 6c /* Mask of ol
1f030 64 2e 2a 20 63 6f 6c 75 6d 6e 73 20 72 65 66 65 d.* columns refe
1f040 72 65 6e 63 65 64 20 2a 2f 0a 20 20 75 33 32 20 renced */. u32
1f050 6e 65 77 6d 61 73 6b 3b 20 20 20 20 20 20 20 20 newmask;
1f060 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 6e 65 77 2e /* Mask of new.
1f070 2a 20 63 6f 6c 75 6d 6e 73 20 72 65 66 65 72 65 * columns refere
1f080 6e 63 65 64 20 2a 2f 0a 20 20 75 38 20 65 54 72 nced */. u8 eTr
1f090 69 67 67 65 72 4f 70 3b 20 20 20 20 20 20 20 2f iggerOp; /
1f0a0 2a 20 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f * TK_UPDATE, TK_
1f0b0 49 4e 53 45 52 54 20 6f 72 20 54 4b 5f 44 45 4c INSERT or TK_DEL
1f0c0 45 54 45 20 2a 2f 0a 20 20 75 38 20 65 4f 72 63 ETE */. u8 eOrc
1f0d0 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 20 2f 2a onf; /*
1f0e0 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 Default ON CONF
1f0f0 4c 49 43 54 20 70 6f 6c 69 63 79 20 66 6f 72 20 LICT policy for
1f100 74 72 69 67 67 65 72 20 73 74 65 70 73 20 2a 2f trigger steps */
1f110 0a 20 20 75 38 20 64 69 73 61 62 6c 65 54 72 69 . u8 disableTri
1f120 67 67 65 72 73 3b 20 20 2f 2a 20 54 72 75 65 20 ggers; /* True
1f130 74 6f 20 64 69 73 61 62 6c 65 20 74 72 69 67 67 to disable trigg
1f140 65 72 73 20 2a 2f 0a 0a 20 20 2f 2a 2a 2a 2a 2a ers */.. /*****
1f150 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f160 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f170 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f180 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f190 2a 2a 2a 0a 20 20 2a 2a 20 41 62 6f 76 65 20 69 ***. ** Above i
1f1a0 73 20 63 6f 6e 73 74 61 6e 74 20 62 65 74 77 65 s constant betwe
1f1b0 65 6e 20 72 65 63 75 72 73 69 6f 6e 73 2e 20 20 en recursions.
1f1c0 42 65 6c 6f 77 20 69 73 20 72 65 73 65 74 20 62 Below is reset b
1f1d0 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65 72 0a efore and after.
1f1e0 20 20 2a 2a 20 65 61 63 68 20 72 65 63 75 72 73 ** each recurs
1f1f0 69 6f 6e 2e 20 20 54 68 65 20 62 6f 75 6e 64 61 ion. The bounda
1f200 72 79 20 62 65 74 77 65 65 6e 20 74 68 65 73 65 ry between these
1f210 20 74 77 6f 20 72 65 67 69 6f 6e 73 20 69 73 20 two regions is
1f220 64 65 74 65 72 6d 69 6e 65 64 0a 20 20 2a 2a 20 determined. **
1f230 75 73 69 6e 67 20 6f 66 66 73 65 74 6f 66 28 50 using offsetof(P
1f240 61 72 73 65 2c 6e 56 61 72 29 20 73 6f 20 74 68 arse,nVar) so th
1f250 65 20 6e 56 61 72 20 66 69 65 6c 64 20 6d 75 73 e nVar field mus
1f260 74 20 62 65 20 74 68 65 20 66 69 72 73 74 20 66 t be the first f
1f270 69 65 6c 64 0a 20 20 2a 2a 20 69 6e 20 74 68 65 ield. ** in the
1f280 20 72 65 63 75 72 73 69 76 65 20 72 65 67 69 6f recursive regio
1f290 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a n.. ***********
1f2a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f2b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f2c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1f2d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a *************/..
1f2e0 20 20 79 6e 56 61 72 20 6e 56 61 72 3b 20 20 20 ynVar nVar;
1f2f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1f300 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 76 61 72 umber of '?' var
1f310 69 61 62 6c 65 73 20 73 65 65 6e 20 69 6e 20 74 iables seen in t
1f320 68 65 20 53 51 4c 20 73 6f 20 66 61 72 20 2a 2f he SQL so far */
1f330 0a 20 20 69 6e 74 20 6e 7a 56 61 72 3b 20 20 20 . int nzVar;
1f340 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f350 4e 75 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 Number of availa
1f360 62 6c 65 20 73 6c 6f 74 73 20 69 6e 20 61 7a 56 ble slots in azV
1f370 61 72 5b 5d 20 2a 2f 0a 20 20 75 38 20 69 50 6b ar[] */. u8 iPk
1f380 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 20 20 SortOrder;
1f390 20 20 20 20 2f 2a 20 41 53 43 20 6f 72 20 44 45 /* ASC or DE
1f3a0 53 43 20 66 6f 72 20 49 4e 54 45 47 45 52 20 50 SC for INTEGER P
1f3b0 52 49 4d 41 52 59 20 4b 45 59 20 2a 2f 0a 20 20 RIMARY KEY */.
1f3c0 75 38 20 65 78 70 6c 61 69 6e 3b 20 20 20 20 20 u8 explain;
1f3d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
1f3e0 65 20 69 66 20 74 68 65 20 45 58 50 4c 41 49 4e e if the EXPLAIN
1f3f0 20 66 6c 61 67 20 69 73 20 66 6f 75 6e 64 20 6f flag is found o
1f400 6e 20 74 68 65 20 71 75 65 72 79 20 2a 2f 0a 23 n the query */.#
1f410 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1f420 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
1f430 20 20 75 38 20 64 65 63 6c 61 72 65 56 74 61 62 u8 declareVtab
1f440 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 ; /* T
1f450 72 75 65 20 69 66 20 69 6e 73 69 64 65 20 73 71 rue if inside sq
1f460 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 lite3_declare_vt
1f470 61 62 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 ab() */. int nV
1f480 74 61 62 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 tabLock;
1f490 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
1f4a0 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
1f4b0 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 23 65 6e 64 69 to lock */.#endi
1f4c0 66 0a 20 20 69 6e 74 20 6e 41 6c 69 61 73 3b 20 f. int nAlias;
1f4d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1f4e0 20 4e 75 6d 62 65 72 20 6f 66 20 61 6c 69 61 73 Number of alias
1f4f0 65 64 20 72 65 73 75 6c 74 20 73 65 74 20 63 6f ed result set co
1f500 6c 75 6d 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 6e lumns */. int n
1f510 48 65 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 Height;
1f520 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 /* Expressi
1f530 6f 6e 20 74 72 65 65 20 68 65 69 67 68 74 20 6f on tree height o
1f540 66 20 63 75 72 72 65 6e 74 20 73 75 62 2d 73 65 f current sub-se
1f550 6c 65 63 74 20 2a 2f 0a 23 69 66 6e 64 65 66 20 lect */.#ifndef
1f560 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c SQLITE_OMIT_EXPL
1f570 41 49 4e 0a 20 20 69 6e 74 20 69 53 65 6c 65 63 AIN. int iSelec
1f580 74 49 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 tId;
1f590 2f 2a 20 49 44 20 6f 66 20 63 75 72 72 65 6e 74 /* ID of current
1f5a0 20 73 65 6c 65 63 74 20 66 6f 72 20 45 58 50 4c select for EXPL
1f5b0 41 49 4e 20 6f 75 74 70 75 74 20 2a 2f 0a 20 20 AIN output */.
1f5c0 69 6e 74 20 69 4e 65 78 74 53 65 6c 65 63 74 49 int iNextSelectI
1f5d0 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 d; /* Nex
1f5e0 74 20 61 76 61 69 6c 61 62 6c 65 20 73 65 6c 65 t available sele
1f5f0 63 74 20 49 44 20 66 6f 72 20 45 58 50 4c 41 49 ct ID for EXPLAI
1f600 4e 20 6f 75 74 70 75 74 20 2a 2f 0a 23 65 6e 64 N output */.#end
1f610 69 66 0a 20 20 63 68 61 72 20 2a 2a 61 7a 56 61 if. char **azVa
1f620 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f r; /
1f630 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 6e 61 * Pointers to na
1f640 6d 65 73 20 6f 66 20 70 61 72 61 6d 65 74 65 72 mes of parameter
1f650 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 52 65 s */. Vdbe *pRe
1f660 70 72 65 70 61 72 65 3b 20 20 20 20 20 20 20 20 prepare;
1f670 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 72 65 70 /* VM being rep
1f680 72 65 70 61 72 65 64 20 28 73 71 6c 69 74 65 33 repared (sqlite3
1f690 52 65 70 72 65 70 61 72 65 28 29 29 20 2a 2f 0a Reprepare()) */.
1f6a0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 const char *zT
1f6b0 61 69 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 ail; /* A
1f6c0 6c 6c 20 53 51 4c 20 74 65 78 74 20 70 61 73 74 ll SQL text past
1f6d0 20 74 68 65 20 6c 61 73 74 20 73 65 6d 69 63 6f the last semico
1f6e0 6c 6f 6e 20 70 61 72 73 65 64 20 2a 2f 0a 20 20 lon parsed */.
1f6f0 54 61 62 6c 65 20 2a 70 4e 65 77 54 61 62 6c 65 Table *pNewTable
1f700 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 74 ; /* A t
1f710 61 62 6c 65 20 62 65 69 6e 67 20 63 6f 6e 73 74 able being const
1f720 72 75 63 74 65 64 20 62 79 20 43 52 45 41 54 45 ructed by CREATE
1f730 20 54 41 42 4c 45 20 2a 2f 0a 20 20 54 72 69 67 TABLE */. Trig
1f740 67 65 72 20 2a 70 4e 65 77 54 72 69 67 67 65 72 ger *pNewTrigger
1f750 3b 20 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 ; /* Trigger
1f760 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 75 63 74 under construct
1f770 20 62 79 20 61 20 43 52 45 41 54 45 20 54 52 49 by a CREATE TRI
1f780 47 47 45 52 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 GGER */. const
1f790 63 68 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 65 char *zAuthConte
1f7a0 78 74 3b 20 2f 2a 20 54 68 65 20 36 74 68 20 70 xt; /* The 6th p
1f7b0 61 72 61 6d 65 74 65 72 20 74 6f 20 64 62 2d 3e arameter to db->
1f7c0 78 41 75 74 68 20 63 61 6c 6c 62 61 63 6b 73 20 xAuth callbacks
1f7d0 2a 2f 0a 20 20 54 6f 6b 65 6e 20 73 4e 61 6d 65 */. Token sName
1f7e0 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 20 20 2f Token; /
1f7f0 2a 20 54 6f 6b 65 6e 20 77 69 74 68 20 75 6e 71 * Token with unq
1f800 75 61 6c 69 66 69 65 64 20 73 63 68 65 6d 61 20 ualified schema
1f810 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 object name */.
1f820 20 54 6f 6b 65 6e 20 73 4c 61 73 74 54 6f 6b 65 Token sLastToke
1f830 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 n; /* Th
1f840 65 20 6c 61 73 74 20 74 6f 6b 65 6e 20 70 61 72 e last token par
1f850 73 65 64 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 sed */.#ifndef S
1f860 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 QLITE_OMIT_VIRTU
1f870 41 4c 54 41 42 4c 45 0a 20 20 54 6f 6b 65 6e 20 ALTABLE. Token
1f880 73 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 sArg;
1f890 20 20 20 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 /* Complete
1f8a0 74 65 78 74 20 6f 66 20 61 20 6d 6f 64 75 6c 65 text of a module
1f8b0 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 20 20 54 argument */. T
1f8c0 61 62 6c 65 20 2a 2a 61 70 56 74 61 62 4c 6f 63 able **apVtabLoc
1f8d0 6b 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e k; /* Poin
1f8e0 74 65 72 20 74 6f 20 76 69 72 74 75 61 6c 20 74 ter to virtual t
1f8f0 61 62 6c 65 73 20 6e 65 65 64 69 6e 67 20 6c 6f ables needing lo
1f900 63 6b 69 6e 67 20 2a 2f 0a 23 65 6e 64 69 66 0a cking */.#endif.
1f910 20 20 54 61 62 6c 65 20 2a 70 5a 6f 6d 62 69 65 Table *pZombie
1f920 54 61 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c Tab; /* L
1f930 69 73 74 20 6f 66 20 54 61 62 6c 65 20 6f 62 6a ist of Table obj
1f940 65 63 74 73 20 74 6f 20 64 65 6c 65 74 65 20 61 ects to delete a
1f950 66 74 65 72 20 63 6f 64 65 20 67 65 6e 20 2a 2f fter code gen */
1f960 0a 20 20 54 72 69 67 67 65 72 50 72 67 20 2a 70 . TriggerPrg *p
1f970 54 72 69 67 67 65 72 50 72 67 3b 20 20 2f 2a 20 TriggerPrg; /*
1f980 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 63 Linked list of c
1f990 6f 64 65 64 20 74 72 69 67 67 65 72 73 20 2a 2f oded triggers */
1f9a0 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 3b 20 . With *pWith;
1f9b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1f9c0 43 75 72 72 65 6e 74 20 57 49 54 48 20 63 6c 61 Current WITH cla
1f9d0 75 73 65 2c 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a use, or NULL */.
1f9e0 20 20 57 69 74 68 20 2a 70 57 69 74 68 54 6f 46 With *pWithToF
1f9f0 72 65 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 ree; /* F
1fa00 72 65 65 20 74 68 69 73 20 57 49 54 48 20 6f 62 ree this WITH ob
1fa10 6a 65 63 74 20 61 74 20 74 68 65 20 65 6e 64 20 ject at the end
1fa20 6f 66 20 74 68 65 20 70 61 72 73 65 20 2a 2f 0a of the parse */.
1fa30 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e };../*.** Return
1fa40 20 74 72 75 65 20 69 66 20 63 75 72 72 65 6e 74 true if current
1fa50 6c 79 20 69 6e 73 69 64 65 20 61 6e 20 73 71 6c ly inside an sql
1fa60 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 61 ite3_declare_vta
1fa70 62 28 29 20 63 61 6c 6c 2e 0a 2a 2f 0a 23 69 66 b() call..*/.#if
1fa80 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
1fa90 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 23 VIRTUALTABLE. #
1faa0 64 65 66 69 6e 65 20 49 4e 5f 44 45 43 4c 41 52 define IN_DECLAR
1fab0 45 5f 56 54 41 42 20 30 0a 23 65 6c 73 65 0a 20 E_VTAB 0.#else.
1fac0 20 23 64 65 66 69 6e 65 20 49 4e 5f 44 45 43 4c #define IN_DECL
1fad0 41 52 45 5f 56 54 41 42 20 28 70 50 61 72 73 65 ARE_VTAB (pParse
1fae0 2d 3e 64 65 63 6c 61 72 65 56 74 61 62 29 0a 23 ->declareVtab).#
1faf0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 endif../*.** An
1fb00 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
1fb10 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
1fb20 75 72 65 20 63 61 6e 20 62 65 20 64 65 63 6c 61 ure can be decla
1fb30 72 65 64 20 6f 6e 20 61 20 73 74 61 63 6b 20 61 red on a stack a
1fb40 6e 64 20 75 73 65 64 0a 2a 2a 20 74 6f 20 73 61 nd used.** to sa
1fb50 76 65 20 74 68 65 20 50 61 72 73 65 2e 7a 41 75 ve the Parse.zAu
1fb60 74 68 43 6f 6e 74 65 78 74 20 76 61 6c 75 65 20 thContext value
1fb70 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e 20 62 so that it can b
1fb80 65 20 72 65 73 74 6f 72 65 64 20 6c 61 74 65 72 e restored later
1fb90 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 41 75 74 68 ..*/.struct Auth
1fba0 43 6f 6e 74 65 78 74 20 7b 0a 20 20 63 6f 6e 73 Context {. cons
1fbb0 74 20 63 68 61 72 20 2a 7a 41 75 74 68 43 6f 6e t char *zAuthCon
1fbc0 74 65 78 74 3b 20 20 20 2f 2a 20 50 75 74 20 73 text; /* Put s
1fbd0 61 76 65 64 20 50 61 72 73 65 2e 7a 41 75 74 68 aved Parse.zAuth
1fbe0 43 6f 6e 74 65 78 74 20 68 65 72 65 20 2a 2f 0a Context here */.
1fbf0 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b Parse *pParse;
1fc00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1fc10 20 54 68 65 20 50 61 72 73 65 20 73 74 72 75 63 The Parse struc
1fc20 74 75 72 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a ture */.};../*.*
1fc30 2a 20 42 69 74 66 69 65 6c 64 20 66 6c 61 67 73 * Bitfield flags
1fc40 20 66 6f 72 20 50 35 20 76 61 6c 75 65 20 69 6e for P5 value in
1fc50 20 76 61 72 69 6f 75 73 20 6f 70 63 6f 64 65 73 various opcodes
1fc60 2e 0a 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 63 6f ..**.** Value co
1fc70 6e 73 74 72 61 69 6e 74 73 20 28 65 6e 66 6f 72 nstraints (enfor
1fc80 63 65 64 20 76 69 61 20 61 73 73 65 72 74 28 29 ced via assert()
1fc90 29 3a 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f ):.** OPFLAG_
1fca0 4c 45 4e 47 54 48 41 52 47 20 20 20 20 3d 3d 20 LENGTHARG ==
1fcb0 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 SQLITE_FUNC_LENG
1fcc0 54 48 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f TH.** OPFLAG_
1fcd0 54 59 50 45 4f 46 41 52 47 20 20 20 20 3d 3d 20 TYPEOFARG ==
1fce0 53 51 4c 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 SQLITE_FUNC_TYPE
1fcf0 4f 46 0a 2a 2a 20 20 20 20 4f 50 46 4c 41 47 5f OF.** OPFLAG_
1fd00 42 55 4c 4b 43 53 52 20 20 20 20 20 20 3d 3d 20 BULKCSR ==
1fd10 42 54 52 45 45 5f 42 55 4c 4b 4c 4f 41 44 0a 2a BTREE_BULKLOAD.*
1fd20 2a 20 20 20 20 4f 50 46 4c 41 47 5f 53 45 45 4b * OPFLAG_SEEK
1fd30 45 51 20 20 20 20 20 20 20 3d 3d 20 42 54 52 45 EQ == BTRE
1fd40 45 5f 53 45 45 4b 5f 45 51 0a 2a 2a 20 20 20 20 E_SEEK_EQ.**
1fd50 4f 50 46 4c 41 47 5f 46 4f 52 44 45 4c 45 54 45 OPFLAG_FORDELETE
1fd60 20 20 20 20 3d 3d 20 42 54 52 45 45 5f 46 4f 52 == BTREE_FOR
1fd70 44 45 4c 45 54 45 0a 2a 2a 20 20 20 20 4f 50 46 DELETE.** OPF
1fd80 4c 41 47 5f 53 41 56 45 50 4f 53 49 54 49 4f 4e LAG_SAVEPOSITION
1fd90 20 3d 3d 20 42 54 52 45 45 5f 53 41 56 45 50 4f == BTREE_SAVEPO
1fda0 53 49 54 49 4f 4e 0a 2a 2a 20 20 20 20 4f 50 46 SITION.** OPF
1fdb0 4c 41 47 5f 41 55 58 44 45 4c 45 54 45 20 20 20 LAG_AUXDELETE
1fdc0 20 3d 3d 20 42 54 52 45 45 5f 41 55 58 44 45 4c == BTREE_AUXDEL
1fdd0 45 54 45 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ETE.*/.#define O
1fde0 50 46 4c 41 47 5f 4e 43 48 41 4e 47 45 20 20 20 PFLAG_NCHANGE
1fdf0 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 0x01 /* O
1fe00 50 5f 49 6e 73 65 72 74 3a 20 53 65 74 20 74 6f P_Insert: Set to
1fe10 20 75 70 64 61 74 65 20 64 62 2d 3e 6e 43 68 61 update db->nCha
1fe20 6e 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 nge */.
1fe30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fe40 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
1fe50 6c 73 6f 20 75 73 65 64 20 69 6e 20 50 32 20 28 lso used in P2 (
1fe60 6e 6f 74 20 50 35 29 20 6f 66 20 4f 50 5f 44 65 not P5) of OP_De
1fe70 6c 65 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 lete */.#define
1fe80 4f 50 46 4c 41 47 5f 45 50 48 45 4d 20 20 20 20 OPFLAG_EPHEM
1fe90 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 0x01 /*
1fea0 4f 50 5f 43 6f 6c 75 6d 6e 3a 20 45 70 68 65 6d OP_Column: Ephem
1feb0 65 72 61 6c 20 6f 75 74 70 75 74 20 69 73 20 6f eral output is o
1fec0 6b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 k */.#define OPF
1fed0 4c 41 47 5f 4c 41 53 54 52 4f 57 49 44 20 20 20 LAG_LASTROWID
1fee0 20 20 30 78 30 32 20 20 20 20 2f 2a 20 53 65 74 0x02 /* Set
1fef0 20 74 6f 20 75 70 64 61 74 65 20 64 62 2d 3e 6c to update db->l
1ff00 61 73 74 52 6f 77 69 64 20 2a 2f 0a 23 64 65 66 astRowid */.#def
1ff10 69 6e 65 20 4f 50 46 4c 41 47 5f 49 53 55 50 44 ine OPFLAG_ISUPD
1ff20 41 54 45 20 20 20 20 20 20 30 78 30 34 20 20 20 ATE 0x04
1ff30 20 2f 2a 20 54 68 69 73 20 4f 50 5f 49 6e 73 65 /* This OP_Inse
1ff40 72 74 20 69 73 20 61 6e 20 73 71 6c 20 55 50 44 rt is an sql UPD
1ff50 41 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ATE */.#define O
1ff60 50 46 4c 41 47 5f 41 50 50 45 4e 44 20 20 20 20 PFLAG_APPEND
1ff70 20 20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 54 0x08 /* T
1ff80 68 69 73 20 69 73 20 6c 69 6b 65 6c 79 20 74 6f his is likely to
1ff90 20 62 65 20 61 6e 20 61 70 70 65 6e 64 20 2a 2f be an append */
1ffa0 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
1ffb0 55 53 45 53 45 45 4b 52 45 53 55 4c 54 20 30 78 USESEEKRESULT 0x
1ffc0 31 30 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 10 /* Try to
1ffd0 61 76 6f 69 64 20 61 20 73 65 65 6b 20 69 6e 20 avoid a seek in
1ffe0 42 74 72 65 65 49 6e 73 65 72 74 28 29 20 2a 2f BtreeInsert() */
1fff0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
20000 4e 41 42 4c 45 5f 50 52 45 55 50 44 41 54 45 5f NABLE_PREUPDATE_
20010 48 4f 4f 4b 0a 23 64 65 66 69 6e 65 20 4f 50 46 HOOK.#define OPF
20020 4c 41 47 5f 49 53 4e 4f 4f 50 20 20 20 20 20 20 LAG_ISNOOP
20030 20 20 30 78 34 30 20 20 20 20 2f 2a 20 4f 50 5f 0x40 /* OP_
20040 44 65 6c 65 74 65 20 64 6f 65 73 20 70 72 65 2d Delete does pre-
20050 75 70 64 61 74 65 2d 68 6f 6f 6b 20 6f 6e 6c 79 update-hook only
20060 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 */.#endif.#defi
20070 6e 65 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 48 ne OPFLAG_LENGTH
20080 41 52 47 20 20 20 20 20 30 78 34 30 20 20 20 20 ARG 0x40
20090 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c /* OP_Column onl
200a0 79 20 75 73 65 64 20 66 6f 72 20 6c 65 6e 67 74 y used for lengt
200b0 68 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f h() */.#define O
200c0 50 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 20 PFLAG_TYPEOFARG
200d0 20 20 20 20 30 78 38 30 20 20 20 20 2f 2a 20 4f 0x80 /* O
200e0 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 P_Column only us
200f0 65 64 20 66 6f 72 20 74 79 70 65 6f 66 28 29 20 ed for typeof()
20100 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
20110 47 5f 42 55 4c 4b 43 53 52 20 20 20 20 20 20 20 G_BULKCSR
20120 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 0x01 /* OP_Op
20130 65 6e 2a 2a 20 75 73 65 64 20 74 6f 20 6f 70 65 en** used to ope
20140 6e 20 62 75 6c 6b 20 63 75 72 73 6f 72 20 2a 2f n bulk cursor */
20150 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
20160 53 45 45 4b 45 51 20 20 20 20 20 20 20 20 30 78 SEEKEQ 0x
20170 30 32 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 02 /* OP_Open
20180 2a 2a 20 63 75 72 73 6f 72 20 75 73 65 73 20 45 ** cursor uses E
20190 51 20 73 65 65 6b 20 6f 6e 6c 79 20 2a 2f 0a 23 Q seek only */.#
201a0 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 46 4f define OPFLAG_FO
201b0 52 44 45 4c 45 54 45 20 20 20 20 20 30 78 30 38 RDELETE 0x08
201c0 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 20 73 /* OP_Open s
201d0 68 6f 75 6c 64 20 75 73 65 20 42 54 52 45 45 5f hould use BTREE_
201e0 46 4f 52 44 45 4c 45 54 45 20 2a 2f 0a 23 64 65 FORDELETE */.#de
201f0 66 69 6e 65 20 4f 50 46 4c 41 47 5f 50 32 49 53 fine OPFLAG_P2IS
20200 52 45 47 20 20 20 20 20 20 20 30 78 31 30 20 20 REG 0x10
20210 20 20 2f 2a 20 50 32 20 74 6f 20 4f 50 5f 4f 70 /* P2 to OP_Op
20220 65 6e 2a 2a 20 69 73 20 61 20 72 65 67 69 73 74 en** is a regist
20230 65 72 20 6e 75 6d 62 65 72 20 2a 2f 0a 23 64 65 er number */.#de
20240 66 69 6e 65 20 4f 50 46 4c 41 47 5f 50 45 52 4d fine OPFLAG_PERM
20250 55 54 45 20 20 20 20 20 20 20 30 78 30 31 20 20 UTE 0x01
20260 20 20 2f 2a 20 4f 50 5f 43 6f 6d 70 61 72 65 3a /* OP_Compare:
20270 20 75 73 65 20 74 68 65 20 70 65 72 6d 75 74 61 use the permuta
20280 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tion */.#define
20290 4f 50 46 4c 41 47 5f 53 41 56 45 50 4f 53 49 54 OPFLAG_SAVEPOSIT
202a0 49 4f 4e 20 20 30 78 30 32 20 20 20 20 2f 2a 20 ION 0x02 /*
202b0 4f 50 5f 44 65 6c 65 74 65 3a 20 6b 65 65 70 20 OP_Delete: keep
202c0 63 75 72 73 6f 72 20 70 6f 73 69 74 69 6f 6e 20 cursor position
202d0 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
202e0 47 5f 41 55 58 44 45 4c 45 54 45 20 20 20 20 20 G_AUXDELETE
202f0 30 78 30 34 20 20 20 20 2f 2a 20 4f 50 5f 44 65 0x04 /* OP_De
20300 6c 65 74 65 3a 20 69 6e 64 65 78 20 69 6e 20 61 lete: index in a
20310 20 44 45 4c 45 54 45 20 6f 70 20 2a 2f 0a 0a 2f DELETE op */../
20320 2a 0a 20 2a 20 45 61 63 68 20 74 72 69 67 67 65 *. * Each trigge
20330 72 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 r present in the
20340 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
20350 20 69 73 20 73 74 6f 72 65 64 20 61 73 20 61 6e is stored as an
20360 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 20 2a 20 instance of. *
20370 73 74 72 75 63 74 20 54 72 69 67 67 65 72 2e 0a struct Trigger..
20380 20 2a 0a 20 2a 20 50 6f 69 6e 74 65 72 73 20 74 *. * Pointers t
20390 6f 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 73 o instances of s
203a0 74 72 75 63 74 20 54 72 69 67 67 65 72 20 61 72 truct Trigger ar
203b0 65 20 73 74 6f 72 65 64 20 69 6e 20 74 77 6f 20 e stored in two
203c0 77 61 79 73 2e 0a 20 2a 20 31 2e 20 49 6e 20 74 ways.. * 1. In t
203d0 68 65 20 22 74 72 69 67 48 61 73 68 22 20 68 61 he "trigHash" ha
203e0 73 68 20 74 61 62 6c 65 20 28 70 61 72 74 20 6f sh table (part o
203f0 66 20 74 68 65 20 73 71 6c 69 74 65 33 2a 20 74 f the sqlite3* t
20400 68 61 74 20 72 65 70 72 65 73 65 6e 74 73 20 74 hat represents t
20410 68 65 0a 20 2a 20 20 20 20 64 61 74 61 62 61 73 he. * databas
20420 65 29 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 e). This allows
20430 54 72 69 67 67 65 72 20 73 74 72 75 63 74 75 72 Trigger structur
20440 65 73 20 74 6f 20 62 65 20 72 65 74 72 69 65 76 es to be retriev
20450 65 64 20 62 79 20 6e 61 6d 65 2e 0a 20 2a 20 32 ed by name.. * 2
20460 2e 20 41 6c 6c 20 74 72 69 67 67 65 72 73 20 61 . All triggers a
20470 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 ssociated with a
20480 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 66 6f single table fo
20490 72 6d 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 rm a linked list
204a0 2c 20 75 73 69 6e 67 20 74 68 65 0a 20 2a 20 20 , using the. *
204b0 20 20 70 4e 65 78 74 20 6d 65 6d 62 65 72 20 6f pNext member o
204c0 66 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 f struct Trigger
204d0 2e 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 . A pointer to t
204e0 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 he first element
204f0 20 6f 66 20 74 68 65 0a 20 2a 20 20 20 20 6c 69 of the. * li
20500 6e 6b 65 64 20 6c 69 73 74 20 69 73 20 73 74 6f nked list is sto
20510 72 65 64 20 61 73 20 74 68 65 20 22 70 54 72 69 red as the "pTri
20520 67 67 65 72 22 20 6d 65 6d 62 65 72 20 6f 66 20 gger" member of
20530 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20 the associated.
20540 2a 20 20 20 20 73 74 72 75 63 74 20 54 61 62 6c * struct Tabl
20550 65 2e 0a 20 2a 0a 20 2a 20 54 68 65 20 22 73 74 e.. *. * The "st
20560 65 70 5f 6c 69 73 74 22 20 6d 65 6d 62 65 72 20 ep_list" member
20570 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 66 69 points to the fi
20580 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 61 rst element of a
20590 20 6c 69 6e 6b 65 64 20 6c 69 73 74 0a 20 2a 20 linked list. *
205a0 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 53 containing the S
205b0 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 73 70 QL statements sp
205c0 65 63 69 66 69 65 64 20 61 73 20 74 68 65 20 74 ecified as the t
205d0 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 2e 0a rigger program..
205e0 20 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 */.struct Trigg
205f0 65 72 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 er {. char *zNa
20600 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f me; /
20610 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 * The name of th
20620 65 20 74 72 69 67 67 65 72 20 20 20 20 20 20 20 e trigger
20630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20640 20 2a 2f 0a 20 20 63 68 61 72 20 2a 74 61 62 6c */. char *tabl
20650 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
20660 20 54 68 65 20 74 61 62 6c 65 20 6f 72 20 76 69 The table or vi
20670 65 77 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 ew to which the
20680 74 72 69 67 67 65 72 20 61 70 70 6c 69 65 73 20 trigger applies
20690 2a 2f 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 20 */. u8 op;
206a0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
206b0 4f 6e 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 One of TK_DELETE
206c0 2c 20 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f , TK_UPDATE, TK_
206d0 49 4e 53 45 52 54 20 20 20 20 20 20 20 20 20 2a INSERT *
206e0 2f 0a 20 20 75 38 20 74 72 5f 74 6d 3b 20 20 20 /. u8 tr_tm;
206f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
20700 6e 65 20 6f 66 20 54 52 49 47 47 45 52 5f 42 45 ne of TRIGGER_BE
20710 46 4f 52 45 2c 20 54 52 49 47 47 45 52 5f 41 46 FORE, TRIGGER_AF
20720 54 45 52 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 TER */. Expr *p
20730 57 68 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 When;
20740 20 2f 2a 20 54 68 65 20 57 48 45 4e 20 63 6c 61 /* The WHEN cla
20750 75 73 65 20 6f 66 20 74 68 65 20 65 78 70 72 65 use of the expre
20760 73 73 69 6f 6e 20 28 6d 61 79 20 62 65 20 4e 55 ssion (may be NU
20770 4c 4c 29 20 2a 2f 0a 20 20 49 64 4c 69 73 74 20 LL) */. IdList
20780 2a 70 43 6f 6c 75 6d 6e 73 3b 20 20 20 20 20 20 *pColumns;
20790 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 /* If this is a
207a0 6e 20 55 50 44 41 54 45 20 4f 46 20 3c 63 6f 6c n UPDATE OF <col
207b0 75 6d 6e 2d 6c 69 73 74 3e 20 74 72 69 67 67 65 umn-list> trigge
207c0 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 r,.
207d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
207e0 74 68 65 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 the <column-list
207f0 3e 20 69 73 20 73 74 6f 72 65 64 20 68 65 72 65 > is stored here
20800 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 */. Schema *pS
20810 63 68 65 6d 61 3b 20 20 20 20 20 20 20 20 2f 2a chema; /*
20820 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 Schema containi
20830 6e 67 20 74 68 65 20 74 72 69 67 67 65 72 20 2a ng the trigger *
20840 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 54 61 62 /. Schema *pTab
20850 53 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 53 Schema; /* S
20860 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 chema containing
20870 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 the table */.
20880 54 72 69 67 67 65 72 53 74 65 70 20 2a 73 74 65 TriggerStep *ste
20890 70 5f 6c 69 73 74 3b 20 2f 2a 20 4c 69 6e 6b 20 p_list; /* Link
208a0 6c 69 73 74 20 6f 66 20 74 72 69 67 67 65 72 20 list of trigger
208b0 70 72 6f 67 72 61 6d 20 73 74 65 70 73 20 20 20 program steps
208c0 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 54 */. T
208d0 72 69 67 67 65 72 20 2a 70 4e 65 78 74 3b 20 20 rigger *pNext;
208e0 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 74 /* Next t
208f0 72 69 67 67 65 72 20 61 73 73 6f 63 69 61 74 65 rigger associate
20900 64 20 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 d with the table
20910 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 */.};../*.** A
20920 74 72 69 67 67 65 72 20 69 73 20 65 69 74 68 65 trigger is eithe
20930 72 20 61 20 42 45 46 4f 52 45 20 6f 72 20 61 6e r a BEFORE or an
20940 20 41 46 54 45 52 20 74 72 69 67 67 65 72 2e 20 AFTER trigger.
20950 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 The following c
20960 6f 6e 73 74 61 6e 74 73 0a 2a 2a 20 64 65 74 65 onstants.** dete
20970 72 6d 69 6e 65 20 77 68 69 63 68 2e 0a 2a 2a 0a rmine which..**.
20980 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 ** If there are
20990 6d 75 6c 74 69 70 6c 65 20 74 72 69 67 67 65 72 multiple trigger
209a0 73 2c 20 79 6f 75 20 6d 69 67 68 74 20 6f 66 20 s, you might of
209b0 73 6f 6d 65 20 42 45 46 4f 52 45 20 61 6e 64 20 some BEFORE and
209c0 73 6f 6d 65 20 41 46 54 45 52 2e 0a 2a 2a 20 49 some AFTER..** I
209d0 6e 20 74 68 61 74 20 63 61 73 65 73 2c 20 74 68 n that cases, th
209e0 65 20 63 6f 6e 73 74 61 6e 74 73 20 62 65 6c 6f e constants belo
209f0 77 20 63 61 6e 20 62 65 20 4f 52 65 64 20 74 6f w can be ORed to
20a00 67 65 74 68 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 gether..*/.#defi
20a10 6e 65 20 54 52 49 47 47 45 52 5f 42 45 46 4f 52 ne TRIGGER_BEFOR
20a20 45 20 20 31 0a 23 64 65 66 69 6e 65 20 54 52 49 E 1.#define TRI
20a30 47 47 45 52 5f 41 46 54 45 52 20 20 20 32 0a 0a GGER_AFTER 2..
20a40 2f 2a 0a 20 2a 20 41 6e 20 69 6e 73 74 61 6e 63 /*. * An instanc
20a50 65 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 67 e of struct Trig
20a60 67 65 72 53 74 65 70 20 69 73 20 75 73 65 64 20 gerStep is used
20a70 74 6f 20 73 74 6f 72 65 20 61 20 73 69 6e 67 6c to store a singl
20a80 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 0a e SQL statement.
20a90 20 2a 20 74 68 61 74 20 69 73 20 61 20 70 61 72 * that is a par
20aa0 74 20 6f 66 20 61 20 74 72 69 67 67 65 72 2d 70 t of a trigger-p
20ab0 72 6f 67 72 61 6d 2e 0a 20 2a 0a 20 2a 20 49 6e rogram.. *. * In
20ac0 73 74 61 6e 63 65 73 20 6f 66 20 73 74 72 75 63 stances of struc
20ad0 74 20 54 72 69 67 67 65 72 53 74 65 70 20 61 72 t TriggerStep ar
20ae0 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 73 69 e stored in a si
20af0 6e 67 6c 79 20 6c 69 6e 6b 65 64 20 6c 69 73 74 ngly linked list
20b00 20 28 6c 69 6e 6b 65 64 0a 20 2a 20 75 73 69 6e (linked. * usin
20b10 67 20 74 68 65 20 22 70 4e 65 78 74 22 20 6d 65 g the "pNext" me
20b20 6d 62 65 72 29 20 72 65 66 65 72 65 6e 63 65 64 mber) referenced
20b30 20 62 79 20 74 68 65 20 22 73 74 65 70 5f 6c 69 by the "step_li
20b40 73 74 22 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 st" member of th
20b50 65 0a 20 2a 20 61 73 73 6f 63 69 61 74 65 64 20 e. * associated
20b60 73 74 72 75 63 74 20 54 72 69 67 67 65 72 20 69 struct Trigger i
20b70 6e 73 74 61 6e 63 65 2e 20 54 68 65 20 66 69 72 nstance. The fir
20b80 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 st element of th
20b90 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 69 73 e linked list is
20ba0 0a 20 2a 20 74 68 65 20 66 69 72 73 74 20 73 74 . * the first st
20bb0 65 70 20 6f 66 20 74 68 65 20 74 72 69 67 67 65 ep of the trigge
20bc0 72 2d 70 72 6f 67 72 61 6d 2e 0a 20 2a 0a 20 2a r-program.. *. *
20bd0 20 54 68 65 20 22 6f 70 22 20 6d 65 6d 62 65 72 The "op" member
20be0 20 69 6e 64 69 63 61 74 65 73 20 77 68 65 74 68 indicates wheth
20bf0 65 72 20 74 68 69 73 20 69 73 20 61 20 22 44 45 er this is a "DE
20c00 4c 45 54 45 22 2c 20 22 49 4e 53 45 52 54 22 2c LETE", "INSERT",
20c10 20 22 55 50 44 41 54 45 22 20 6f 72 0a 20 2a 20 "UPDATE" or. *
20c20 22 53 45 4c 45 43 54 22 20 73 74 61 74 65 6d 65 "SELECT" stateme
20c30 6e 74 2e 20 54 68 65 20 6d 65 61 6e 69 6e 67 73 nt. The meanings
20c40 20 6f 66 20 74 68 65 20 6f 74 68 65 72 20 6d 65 of the other me
20c50 6d 62 65 72 73 20 69 73 20 64 65 74 65 72 6d 69 mbers is determi
20c60 6e 65 64 20 62 79 20 74 68 65 0a 20 2a 20 76 61 ned by the. * va
20c70 6c 75 65 20 6f 66 20 22 6f 70 22 20 61 73 20 66 lue of "op" as f
20c80 6f 6c 6c 6f 77 73 3a 0a 20 2a 0a 20 2a 20 28 6f ollows:. *. * (o
20c90 70 20 3d 3d 20 54 4b 5f 49 4e 53 45 52 54 29 0a p == TK_INSERT).
20ca0 20 2a 20 6f 72 63 6f 6e 66 20 20 20 20 2d 3e 20 * orconf ->
20cb0 73 74 6f 72 65 73 20 74 68 65 20 4f 4e 20 43 4f stores the ON CO
20cc0 4e 46 4c 49 43 54 20 61 6c 67 6f 72 69 74 68 6d NFLICT algorithm
20cd0 0a 20 2a 20 70 53 65 6c 65 63 74 20 20 20 2d 3e . * pSelect ->
20ce0 20 49 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 If this is an I
20cf0 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 NSERT INTO ... S
20d00 45 4c 45 43 54 20 2e 2e 2e 20 73 74 61 74 65 6d ELECT ... statem
20d10 65 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 20 20 20 ent, then. *
20d20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 20 73 this s
20d30 74 6f 72 65 73 20 61 20 70 6f 69 6e 74 65 72 20 tores a pointer
20d40 74 6f 20 74 68 65 20 53 45 4c 45 43 54 20 73 74 to the SELECT st
20d50 61 74 65 6d 65 6e 74 2e 20 4f 74 68 65 72 77 69 atement. Otherwi
20d60 73 65 20 4e 55 4c 4c 2e 0a 20 2a 20 7a 54 61 72 se NULL.. * zTar
20d70 67 65 74 20 20 20 2d 3e 20 44 65 71 75 6f 74 65 get -> Dequote
20d80 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 d name of the ta
20d90 62 6c 65 20 74 6f 20 69 6e 73 65 72 74 20 69 6e ble to insert in
20da0 74 6f 2e 0a 20 2a 20 70 45 78 70 72 4c 69 73 74 to.. * pExprList
20db0 20 2d 3e 20 49 66 20 74 68 69 73 20 69 73 20 61 -> If this is a
20dc0 6e 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e n INSERT INTO ..
20dd0 2e 20 56 41 4c 55 45 53 20 2e 2e 2e 20 73 74 61 . VALUES ... sta
20de0 74 65 6d 65 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 tement, then. *
20df0 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 thi
20e00 73 20 73 74 6f 72 65 73 20 76 61 6c 75 65 73 20 s stores values
20e10 74 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 20 to be inserted.
20e20 4f 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a Otherwise NULL..
20e30 20 2a 20 70 49 64 4c 69 73 74 20 20 20 2d 3e 20 * pIdList ->
20e40 49 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e If this is an IN
20e50 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 28 3c SERT INTO ... (<
20e60 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 3e 29 20 56 column-names>) V
20e70 41 4c 55 45 53 20 2e 2e 2e 0a 20 2a 20 20 20 20 ALUES .... *
20e80 20 20 20 20 20 20 20 20 20 20 73 74 61 74 65 6d statem
20e90 65 6e 74 2c 20 74 68 65 6e 20 74 68 69 73 20 73 ent, then this s
20ea0 74 6f 72 65 73 20 74 68 65 20 63 6f 6c 75 6d 6e tores the column
20eb0 2d 6e 61 6d 65 73 20 74 6f 20 62 65 0a 20 2a 20 -names to be. *
20ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 73 ins
20ed0 65 72 74 65 64 20 69 6e 74 6f 2e 0a 20 2a 0a 20 erted into.. *.
20ee0 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 44 45 4c 45 * (op == TK_DELE
20ef0 54 45 29 0a 20 2a 20 7a 54 61 72 67 65 74 20 20 TE). * zTarget
20f00 20 2d 3e 20 44 65 71 75 6f 74 65 64 20 6e 61 6d -> Dequoted nam
20f10 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 e of the table t
20f20 6f 20 64 65 6c 65 74 65 20 66 72 6f 6d 2e 0a 20 o delete from..
20f30 2a 20 70 57 68 65 72 65 20 20 20 20 2d 3e 20 54 * pWhere -> T
20f40 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 he WHERE clause
20f50 6f 66 20 74 68 65 20 44 45 4c 45 54 45 20 73 74 of the DELETE st
20f60 61 74 65 6d 65 6e 74 20 69 66 20 6f 6e 65 20 69 atement if one i
20f70 73 20 73 70 65 63 69 66 69 65 64 2e 0a 20 2a 20 s specified.. *
20f80 20 20 20 20 20 20 20 20 20 20 20 20 20 4f 74 68 Oth
20f90 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a 0a erwise NULL.. *.
20fa0 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 55 50 44 * (op == TK_UPD
20fb0 41 54 45 29 0a 20 2a 20 7a 54 61 72 67 65 74 20 ATE). * zTarget
20fc0 20 20 2d 3e 20 44 65 71 75 6f 74 65 64 20 6e 61 -> Dequoted na
20fd0 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 me of the table
20fe0 74 6f 20 75 70 64 61 74 65 2e 0a 20 2a 20 70 57 to update.. * pW
20ff0 68 65 72 65 20 20 20 20 2d 3e 20 54 68 65 20 57 here -> The W
21000 48 45 52 45 20 63 6c 61 75 73 65 20 6f 66 20 74 HERE clause of t
21010 68 65 20 55 50 44 41 54 45 20 73 74 61 74 65 6d he UPDATE statem
21020 65 6e 74 20 69 66 20 6f 6e 65 20 69 73 20 73 70 ent if one is sp
21030 65 63 69 66 69 65 64 2e 0a 20 2a 20 20 20 20 20 ecified.. *
21040 20 20 20 20 20 20 20 20 20 4f 74 68 65 72 77 69 Otherwi
21050 73 65 20 4e 55 4c 4c 2e 0a 20 2a 20 70 45 78 70 se NULL.. * pExp
21060 72 4c 69 73 74 20 2d 3e 20 41 20 6c 69 73 74 20 rList -> A list
21070 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 73 20 74 of the columns t
21080 6f 20 75 70 64 61 74 65 20 61 6e 64 20 74 68 65 o update and the
21090 20 65 78 70 72 65 73 73 69 6f 6e 73 20 74 6f 20 expressions to
210a0 75 70 64 61 74 65 0a 20 2a 20 20 20 20 20 20 20 update. *
210b0 20 20 20 20 20 20 20 74 68 65 6d 20 74 6f 2e 20 them to.
210c0 53 65 65 20 73 71 6c 69 74 65 33 55 70 64 61 74 See sqlite3Updat
210d0 65 28 29 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f e() documentatio
210e0 6e 20 6f 66 20 22 70 43 68 61 6e 67 65 73 22 0a n of "pChanges".
210f0 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
21100 61 72 67 75 6d 65 6e 74 2e 0a 20 2a 0a 20 2a 2f argument.. *. */
21110 0a 73 74 72 75 63 74 20 54 72 69 67 67 65 72 53 .struct TriggerS
21120 74 65 70 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 tep {. u8 op;
21130 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
21140 4f 6e 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 One of TK_DELETE
21150 2c 20 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f , TK_UPDATE, TK_
21160 49 4e 53 45 52 54 2c 20 54 4b 5f 53 45 4c 45 43 INSERT, TK_SELEC
21170 54 20 2a 2f 0a 20 20 75 38 20 6f 72 63 6f 6e 66 T */. u8 orconf
21180 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f ; /* O
21190 45 5f 52 6f 6c 6c 62 61 63 6b 20 65 74 63 2e 20 E_Rollback etc.
211a0 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 */. Trigger *pT
211b0 72 69 67 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 rig; /* The
211c0 20 74 72 69 67 67 65 72 20 74 68 61 74 20 74 68 trigger that th
211d0 69 73 20 73 74 65 70 20 69 73 20 61 20 70 61 72 is step is a par
211e0 74 20 6f 66 20 2a 2f 0a 20 20 53 65 6c 65 63 74 t of */. Select
211f0 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f *pSelect; /
21200 2a 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 * SELECT stateme
21210 6e 74 20 6f 72 20 52 48 53 20 6f 66 20 49 4e 53 nt or RHS of INS
21220 45 52 54 20 49 4e 54 4f 20 53 45 4c 45 43 54 20 ERT INTO SELECT
21230 2e 2e 2e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a ... */. char *z
21240 54 61 72 67 65 74 3b 20 20 20 20 20 20 20 2f 2a Target; /*
21250 20 54 61 72 67 65 74 20 74 61 62 6c 65 20 66 6f Target table fo
21260 72 20 44 45 4c 45 54 45 2c 20 55 50 44 41 54 45 r DELETE, UPDATE
21270 2c 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 45 78 , INSERT */. Ex
21280 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 20 pr *pWhere;
21290 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 45 20 /* The WHERE
212a0 63 6c 61 75 73 65 20 66 6f 72 20 44 45 4c 45 54 clause for DELET
212b0 45 20 6f 72 20 55 50 44 41 54 45 20 73 74 65 70 E or UPDATE step
212c0 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
212d0 2a 70 45 78 70 72 4c 69 73 74 3b 20 2f 2a 20 53 *pExprList; /* S
212e0 45 54 20 63 6c 61 75 73 65 20 66 6f 72 20 55 50 ET clause for UP
212f0 44 41 54 45 2e 20 2a 2f 0a 20 20 49 64 4c 69 73 DATE. */. IdLis
21300 74 20 2a 70 49 64 4c 69 73 74 3b 20 20 20 20 20 t *pIdList;
21310 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 /* Column names
21320 66 6f 72 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 for INSERT */.
21330 54 72 69 67 67 65 72 53 74 65 70 20 2a 70 4e 65 TriggerStep *pNe
21340 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 xt; /* Next in
21350 74 68 65 20 6c 69 6e 6b 2d 6c 69 73 74 20 2a 2f the link-list */
21360 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 20 2a . TriggerStep *
21370 70 4c 61 73 74 3b 20 20 2f 2a 20 4c 61 73 74 20 pLast; /* Last
21380 65 6c 65 6d 65 6e 74 20 69 6e 20 6c 69 6e 6b 2d element in link-
21390 6c 69 73 74 2e 20 56 61 6c 69 64 20 66 6f 72 20 list. Valid for
213a0 31 73 74 20 65 6c 65 6d 20 6f 6e 6c 79 20 2a 2f 1st elem only */
213b0 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 .};../*.** The f
213c0 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
213d0 72 65 20 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f re contains info
213e0 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 62 79 20 rmation used by
213f0 74 68 65 20 73 71 6c 69 74 65 46 69 78 2e 2e 2e the sqliteFix...
21400 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 20 61 73 20 .** routines as
21410 74 68 65 79 20 77 61 6c 6b 20 74 68 65 20 70 61 they walk the pa
21420 72 73 65 20 74 72 65 65 20 74 6f 20 6d 61 6b 65 rse tree to make
21430 20 64 61 74 61 62 61 73 65 20 72 65 66 65 72 65 database refere
21440 6e 63 65 73 0a 2a 2a 20 65 78 70 6c 69 63 69 74 nces.** explicit
21450 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 ..*/.typedef str
21460 75 63 74 20 44 62 46 69 78 65 72 20 44 62 46 69 uct DbFixer DbFi
21470 78 65 72 3b 0a 73 74 72 75 63 74 20 44 62 46 69 xer;.struct DbFi
21480 78 65 72 20 7b 0a 20 20 50 61 72 73 65 20 2a 70 xer {. Parse *p
21490 50 61 72 73 65 3b 20 20 20 20 20 20 2f 2a 20 54 Parse; /* T
214a0 68 65 20 70 61 72 73 69 6e 67 20 63 6f 6e 74 65 he parsing conte
214b0 78 74 2e 20 20 45 72 72 6f 72 20 6d 65 73 73 61 xt. Error messa
214c0 67 65 73 20 77 72 69 74 74 65 6e 20 68 65 72 65 ges written here
214d0 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 */. Schema *pS
214e0 63 68 65 6d 61 3b 20 20 20 20 2f 2a 20 46 69 78 chema; /* Fix
214f0 20 69 74 65 6d 73 20 74 6f 20 74 68 69 73 20 73 items to this s
21500 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 20 62 chema */. int b
21510 56 61 72 4f 6e 6c 79 3b 20 20 20 20 20 20 20 2f VarOnly; /
21520 2a 20 43 68 65 63 6b 20 66 6f 72 20 76 61 72 69 * Check for vari
21530 61 62 6c 65 20 72 65 66 65 72 65 6e 63 65 73 20 able references
21540 6f 6e 6c 79 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 only */. const
21550 63 68 61 72 20 2a 7a 44 62 3b 20 20 20 20 2f 2a char *zDb; /*
21560 20 4d 61 6b 65 20 73 75 72 65 20 61 6c 6c 20 6f Make sure all o
21570 62 6a 65 63 74 73 20 61 72 65 20 63 6f 6e 74 61 bjects are conta
21580 69 6e 65 64 20 69 6e 20 74 68 69 73 20 64 61 74 ined in this dat
21590 61 62 61 73 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 abase */. const
215a0 20 63 68 61 72 20 2a 7a 54 79 70 65 3b 20 20 2f char *zType; /
215b0 2a 20 54 79 70 65 20 6f 66 20 74 68 65 20 63 6f * Type of the co
215c0 6e 74 61 69 6e 65 72 20 2d 20 75 73 65 64 20 66 ntainer - used f
215d0 6f 72 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 or error message
215e0 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 54 6f 6b s */. const Tok
215f0 65 6e 20 2a 70 4e 61 6d 65 3b 20 2f 2a 20 4e 61 en *pName; /* Na
21600 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 74 61 69 me of the contai
21610 6e 65 72 20 2d 20 75 73 65 64 20 66 6f 72 20 65 ner - used for e
21620 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 2a 2f rror messages */
21630 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 6f 62 .};../*.** An ob
21640 6a 65 63 74 65 64 20 75 73 65 64 20 74 6f 20 61 jected used to a
21650 63 63 75 6d 75 6c 61 74 65 20 74 68 65 20 74 65 ccumulate the te
21660 78 74 20 6f 66 20 61 20 73 74 72 69 6e 67 20 77 xt of a string w
21670 68 65 72 65 20 77 65 0a 2a 2a 20 64 6f 20 6e 6f here we.** do no
21680 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 6b 6e t necessarily kn
21690 6f 77 20 68 6f 77 20 62 69 67 20 74 68 65 20 73 ow how big the s
216a0 74 72 69 6e 67 20 77 69 6c 6c 20 62 65 20 69 6e tring will be in
216b0 20 74 68 65 20 65 6e 64 2e 0a 2a 2f 0a 73 74 72 the end..*/.str
216c0 75 63 74 20 53 74 72 41 63 63 75 6d 20 7b 0a 20 uct StrAccum {.
216d0 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 sqlite3 *db;
216e0 20 20 20 20 20 20 2f 2a 20 4f 70 74 69 6f 6e 61 /* Optiona
216f0 6c 20 64 61 74 61 62 61 73 65 20 66 6f 72 20 6c l database for l
21700 6f 6f 6b 61 73 69 64 65 2e 20 20 43 61 6e 20 62 ookaside. Can b
21710 65 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 68 61 72 e NULL */. char
21720 20 2a 7a 42 61 73 65 3b 20 20 20 20 20 20 20 20 *zBase;
21730 20 2f 2a 20 41 20 62 61 73 65 20 61 6c 6c 6f 63 /* A base alloc
21740 61 74 69 6f 6e 2e 20 20 4e 6f 74 20 66 72 6f 6d ation. Not from
21750 20 6d 61 6c 6c 6f 63 2e 20 2a 2f 0a 20 20 63 68 malloc. */. ch
21760 61 72 20 2a 7a 54 65 78 74 3b 20 20 20 20 20 20 ar *zText;
21770 20 20 20 2f 2a 20 54 68 65 20 73 74 72 69 6e 67 /* The string
21780 20 63 6f 6c 6c 65 63 74 65 64 20 73 6f 20 66 61 collected so fa
21790 72 20 2a 2f 0a 20 20 75 33 32 20 20 6e 43 68 61 r */. u32 nCha
217a0 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c r; /* L
217b0 65 6e 67 74 68 20 6f 66 20 74 68 65 20 73 74 72 ength of the str
217c0 69 6e 67 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 ing so far */.
217d0 75 33 32 20 20 6e 41 6c 6c 6f 63 3b 20 20 20 20 u32 nAlloc;
217e0 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 6f /* Amount o
217f0 66 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 74 65 f space allocate
21800 64 20 69 6e 20 7a 54 65 78 74 20 2a 2f 0a 20 20 d in zText */.
21810 75 33 32 20 20 6d 78 41 6c 6c 6f 63 3b 20 20 20 u32 mxAlloc;
21820 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 /* Maximum
21830 61 6c 6c 6f 77 65 64 20 61 6c 6c 6f 63 61 74 69 allowed allocati
21840 6f 6e 2e 20 20 30 20 66 6f 72 20 6e 6f 20 6d 61 on. 0 for no ma
21850 6c 6c 6f 63 20 75 73 61 67 65 20 2a 2f 0a 20 20 lloc usage */.
21860 75 38 20 20 20 61 63 63 45 72 72 6f 72 3b 20 20 u8 accError;
21870 20 20 20 20 20 2f 2a 20 53 54 52 41 43 43 55 4d /* STRACCUM
21880 5f 4e 4f 4d 45 4d 20 6f 72 20 53 54 52 41 43 43 _NOMEM or STRACC
21890 55 4d 5f 54 4f 4f 42 49 47 20 2a 2f 0a 20 20 75 UM_TOOBIG */. u
218a0 38 20 20 20 70 72 69 6e 74 66 46 6c 61 67 73 3b 8 printfFlags;
218b0 20 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 50 52 /* SQLITE_PR
218c0 49 4e 54 46 20 66 6c 61 67 73 20 62 65 6c 6f 77 INTF flags below
218d0 20 2a 2f 0a 7d 3b 0a 23 64 65 66 69 6e 65 20 53 */.};.#define S
218e0 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 4d 20 20 20 TRACCUM_NOMEM
218f0 31 0a 23 64 65 66 69 6e 65 20 53 54 52 41 43 43 1.#define STRACC
21900 55 4d 5f 54 4f 4f 42 49 47 20 20 32 0a 23 64 65 UM_TOOBIG 2.#de
21910 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 4e fine SQLITE_PRIN
21920 54 46 5f 49 4e 54 45 52 4e 41 4c 20 30 78 30 31 TF_INTERNAL 0x01
21930 20 20 2f 2a 20 49 6e 74 65 72 6e 61 6c 2d 75 73 /* Internal-us
21940 65 2d 6f 6e 6c 79 20 63 6f 6e 76 65 72 74 65 72 e-only converter
21950 73 20 61 6c 6c 6f 77 65 64 20 2a 2f 0a 23 64 65 s allowed */.#de
21960 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 4e fine SQLITE_PRIN
21970 54 46 5f 53 51 4c 46 55 4e 43 20 20 30 78 30 32 TF_SQLFUNC 0x02
21980 20 20 2f 2a 20 53 51 4c 20 66 75 6e 63 74 69 6f /* SQL functio
21990 6e 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 56 n arguments to V
219a0 58 50 72 69 6e 74 66 20 2a 2f 0a 23 64 65 66 69 XPrintf */.#defi
219b0 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 4e 54 46 ne SQLITE_PRINTF
219c0 5f 4d 41 4c 4c 4f 43 45 44 20 30 78 30 34 20 20 _MALLOCED 0x04
219d0 2f 2a 20 54 72 75 65 20 69 66 20 78 54 65 78 74 /* True if xText
219e0 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 73 70 is allocated sp
219f0 61 63 65 20 2a 2f 0a 0a 23 64 65 66 69 6e 65 20 ace */..#define
21a00 69 73 4d 61 6c 6c 6f 63 65 64 28 58 29 20 20 28 isMalloced(X) (
21a10 28 28 58 29 2d 3e 70 72 69 6e 74 66 46 6c 61 67 ((X)->printfFlag
21a20 73 20 26 20 53 51 4c 49 54 45 5f 50 52 49 4e 54 s & SQLITE_PRINT
21a30 46 5f 4d 41 4c 4c 4f 43 45 44 29 21 3d 30 29 0a F_MALLOCED)!=0).
21a40 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 ../*.** A pointe
21a50 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
21a60 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 63 ure is used to c
21a70 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e 66 6f 72 ommunicate infor
21a80 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f 6d 20 73 mation.** from s
21a90 71 6c 69 74 65 33 49 6e 69 74 20 61 6e 64 20 4f qlite3Init and O
21aa0 50 5f 50 61 72 73 65 53 63 68 65 6d 61 20 69 6e P_ParseSchema in
21ab0 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 49 6e to the sqlite3In
21ac0 69 74 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74 itCallback..*/.t
21ad0 79 70 65 64 65 66 20 73 74 72 75 63 74 20 7b 0a ypedef struct {.
21ae0 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 sqlite3 *db;
21af0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
21b00 61 62 61 73 65 20 62 65 69 6e 67 20 69 6e 69 74 abase being init
21b10 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 61 ialized */. cha
21b20 72 20 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 20 r **pzErrMsg;
21b30 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 /* Error messag
21b40 65 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f e stored here */
21b50 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20 . int iDb;
21b60 20 20 20 20 20 20 20 2f 2a 20 30 20 66 6f 72 20 /* 0 for
21b70 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 20 20 main database.
21b80 31 20 66 6f 72 20 54 45 4d 50 2c 20 32 2e 2e 20 1 for TEMP, 2..
21b90 66 6f 72 20 41 54 54 41 43 48 65 64 20 2a 2f 0a for ATTACHed */.
21ba0 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
21bb0 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
21bc0 63 6f 64 65 20 73 74 6f 72 65 64 20 68 65 72 65 code stored here
21bd0 20 2a 2f 0a 7d 20 49 6e 69 74 44 61 74 61 3b 0a */.} InitData;.
21be0 0a 2f 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72 65 ./*.** Structure
21bf0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 67 6c 6f 62 containing glob
21c00 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e al configuration
21c10 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 53 51 data for the SQ
21c20 4c 69 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a 2a Lite library..**
21c30 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 .** This structu
21c40 72 65 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 re also contains
21c50 20 73 6f 6d 65 20 73 74 61 74 65 20 69 6e 66 6f some state info
21c60 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 rmation..*/.stru
21c70 63 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 67 ct Sqlite3Config
21c80 20 7b 0a 20 20 69 6e 74 20 62 4d 65 6d 73 74 61 {. int bMemsta
21c90 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
21ca0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 /* True t
21cb0 6f 20 65 6e 61 62 6c 65 20 6d 65 6d 6f 72 79 20 o enable memory
21cc0 73 74 61 74 75 73 20 2a 2f 0a 20 20 69 6e 74 20 status */. int
21cd0 62 43 6f 72 65 4d 75 74 65 78 3b 20 20 20 20 20 bCoreMutex;
21ce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
21cf0 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 True to enable
21d00 63 6f 72 65 20 6d 75 74 65 78 69 6e 67 20 2a 2f core mutexing */
21d10 0a 20 20 69 6e 74 20 62 46 75 6c 6c 4d 75 74 65 . int bFullMute
21d20 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
21d30 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 /* True to
21d40 65 6e 61 62 6c 65 20 66 75 6c 6c 20 6d 75 74 65 enable full mute
21d50 78 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 4f xing */. int bO
21d60 70 65 6e 55 72 69 3b 20 20 20 20 20 20 20 20 20 penUri;
21d70 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
21d80 72 75 65 20 74 6f 20 69 6e 74 65 72 70 72 65 74 rue to interpret
21d90 20 66 69 6c 65 6e 61 6d 65 73 20 61 73 20 55 52 filenames as UR
21da0 49 73 20 2a 2f 0a 20 20 69 6e 74 20 62 55 73 65 Is */. int bUse
21db0 43 69 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 Cis;
21dc0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 /* Use
21dd0 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 65 covering indice
21de0 73 20 66 6f 72 20 66 75 6c 6c 2d 73 63 61 6e 73 s for full-scans
21df0 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 53 74 72 6c */. int mxStrl
21e00 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 en;
21e10 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d /* Maxim
21e20 75 6d 20 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 um string length
21e30 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 76 65 72 43 */. int neverC
21e40 6f 72 72 75 70 74 3b 20 20 20 20 20 20 20 20 20 orrupt;
21e50 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
21e60 61 73 65 20 69 73 20 61 6c 77 61 79 73 20 77 65 ase is always we
21e70 6c 6c 2d 66 6f 72 6d 65 64 20 2a 2f 0a 20 20 69 ll-formed */. i
21e80 6e 74 20 73 7a 4c 6f 6f 6b 61 73 69 64 65 3b 20 nt szLookaside;
21e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21ea0 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b /* Default look
21eb0 61 73 69 64 65 20 62 75 66 66 65 72 20 73 69 7a aside buffer siz
21ec0 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 6f 6b e */. int nLook
21ed0 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 aside;
21ee0 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 /* Defa
21ef0 75 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 ult lookaside bu
21f00 66 66 65 72 20 63 6f 75 6e 74 20 2a 2f 0a 20 20 ffer count */.
21f10 69 6e 74 20 6e 53 74 6d 74 53 70 69 6c 6c 3b 20 int nStmtSpill;
21f20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21f30 20 20 2f 2a 20 53 74 6d 74 2d 6a 6f 75 72 6e 61 /* Stmt-journa
21f40 6c 20 73 70 69 6c 6c 2d 74 6f 2d 64 69 73 6b 20 l spill-to-disk
21f50 74 68 72 65 73 68 6f 6c 64 20 2a 2f 0a 20 20 73 threshold */. s
21f60 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f qlite3_mem_metho
21f70 64 73 20 6d 3b 20 20 20 20 20 20 20 20 20 20 20 ds m;
21f80 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d 65 /* Low-level me
21f90 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 mory allocation
21fa0 69 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 73 interface */. s
21fb0 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 qlite3_mutex_met
21fc0 68 6f 64 73 20 6d 75 74 65 78 3b 20 20 20 20 20 hods mutex;
21fd0 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d 75 /* Low-level mu
21fe0 74 65 78 20 69 6e 74 65 72 66 61 63 65 20 2a 2f tex interface */
21ff0 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 68 . sqlite3_pcach
22000 65 5f 6d 65 74 68 6f 64 73 32 20 70 63 61 63 68 e_methods2 pcach
22010 65 32 3b 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 e2; /* Low-leve
22020 6c 20 70 61 67 65 2d 63 61 63 68 65 20 69 6e 74 l page-cache int
22030 65 72 66 61 63 65 20 2a 2f 0a 20 20 76 6f 69 64 erface */. void
22040 20 2a 70 48 65 61 70 3b 20 20 20 20 20 20 20 20 *pHeap;
22050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
22060 20 48 65 61 70 20 73 74 6f 72 61 67 65 20 73 70 Heap storage sp
22070 61 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 48 65 ace */. int nHe
22080 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ap;
22090 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
220a0 7a 65 20 6f 66 20 70 48 65 61 70 5b 5d 20 2a 2f ze of pHeap[] */
220b0 0a 20 20 69 6e 74 20 6d 6e 52 65 71 2c 20 6d 78 . int mnReq, mx
220c0 52 65 71 3b 20 20 20 20 20 20 20 20 20 20 20 20 Req;
220d0 20 20 20 20 20 2f 2a 20 4d 69 6e 20 61 6e 64 20 /* Min and
220e0 6d 61 78 20 68 65 61 70 20 72 65 71 75 65 73 74 max heap request
220f0 73 20 73 69 7a 65 73 20 2a 2f 0a 20 20 73 71 6c s sizes */. sql
22100 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d 61 ite3_int64 szMma
22110 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f p; /
22120 2a 20 6d 6d 61 70 28 29 20 73 70 61 63 65 20 70 * mmap() space p
22130 65 72 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f 0a er open file */.
22140 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 sqlite3_int64
22150 6d 78 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 20 mxMmap;
22160 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 76 /* Maximum v
22170 61 6c 75 65 20 66 6f 72 20 73 7a 4d 6d 61 70 20 alue for szMmap
22180 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 63 72 61 */. void *pScra
22190 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 tch;
221a0 20 20 20 20 20 20 20 2f 2a 20 53 63 72 61 74 63 /* Scratc
221b0 68 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69 6e h memory */. in
221c0 74 20 73 7a 53 63 72 61 74 63 68 3b 20 20 20 20 t szScratch;
221d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
221e0 2f 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 /* Size of each
221f0 73 63 72 61 74 63 68 20 62 75 66 66 65 72 20 2a scratch buffer *
22200 2f 0a 20 20 69 6e 74 20 6e 53 63 72 61 74 63 68 /. int nScratch
22210 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
22220 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
22230 6f 66 20 73 63 72 61 74 63 68 20 62 75 66 66 65 of scratch buffe
22240 72 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 50 rs */. void *pP
22250 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 age;
22260 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 /* Pag
22270 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 2a e cache memory *
22280 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b 20 /. int szPage;
22290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
222a0 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
222b0 20 65 61 63 68 20 70 61 67 65 20 69 6e 20 70 50 each page in pP
222c0 61 67 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e age[] */. int n
222d0 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
222e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
222f0 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 Number of pages
22300 69 6e 20 70 50 61 67 65 5b 5d 20 2a 2f 0a 20 20 in pPage[] */.
22310 69 6e 74 20 6d 78 50 61 72 73 65 72 53 74 61 63 int mxParserStac
22320 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 k;
22330 20 20 2f 2a 20 6d 61 78 69 6d 75 6d 20 64 65 70 /* maximum dep
22340 74 68 20 6f 66 20 74 68 65 20 70 61 72 73 65 72 th of the parser
22350 20 73 74 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 stack */. int
22360 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 6c sharedCacheEnabl
22370 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ed; /*
22380 20 74 72 75 65 20 69 66 20 73 68 61 72 65 64 2d true if shared-
22390 63 61 63 68 65 20 6d 6f 64 65 20 65 6e 61 62 6c cache mode enabl
223a0 65 64 20 2a 2f 0a 20 20 75 33 32 20 73 7a 50 6d ed */. u32 szPm
223b0 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 a;
223c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 /* Max
223d0 69 6d 75 6d 20 53 6f 72 74 65 72 20 50 4d 41 20 imum Sorter PMA
223e0 73 69 7a 65 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 size */. /* The
223f0 20 61 62 6f 76 65 20 6d 69 67 68 74 20 62 65 20 above might be
22400 69 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 6e initialized to n
22410 6f 6e 2d 7a 65 72 6f 2e 20 20 54 68 65 20 66 6f on-zero. The fo
22420 6c 6c 6f 77 69 6e 67 20 6e 65 65 64 20 74 6f 20 llowing need to
22430 61 6c 77 61 79 73 0a 20 20 2a 2a 20 69 6e 69 74 always. ** init
22440 69 61 6c 6c 79 20 62 65 20 7a 65 72 6f 2c 20 68 ially be zero, h
22450 6f 77 65 76 65 72 2e 20 2a 2f 0a 20 20 69 6e 74 owever. */. int
22460 20 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20 20 isInit;
22470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
22480 2a 20 54 72 75 65 20 61 66 74 65 72 20 69 6e 69 * True after ini
22490 74 69 61 6c 69 7a 61 74 69 6f 6e 20 68 61 73 20 tialization has
224a0 66 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 69 6e finished */. in
224b0 74 20 69 6e 50 72 6f 67 72 65 73 73 3b 20 20 20 t inProgress;
224c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
224d0 2f 2a 20 54 72 75 65 20 77 68 69 6c 65 20 69 6e /* True while in
224e0 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 20 itialization in
224f0 70 72 6f 67 72 65 73 73 20 2a 2f 0a 20 20 69 6e progress */. in
22500 74 20 69 73 4d 75 74 65 78 49 6e 69 74 3b 20 20 t isMutexInit;
22510 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22520 2f 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 75 /* True after mu
22530 74 65 78 65 73 20 61 72 65 20 69 6e 69 74 69 61 texes are initia
22540 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 lized */. int i
22550 73 4d 61 6c 6c 6f 63 49 6e 69 74 3b 20 20 20 20 sMallocInit;
22560 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
22570 54 72 75 65 20 61 66 74 65 72 20 6d 61 6c 6c 6f True after mallo
22580 63 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 c is initialized
22590 20 2a 2f 0a 20 20 69 6e 74 20 69 73 50 43 61 63 */. int isPCac
225a0 68 65 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 heInit;
225b0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
225c0 61 66 74 65 72 20 6d 61 6c 6c 6f 63 20 69 73 20 after malloc is
225d0 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 initialized */.
225e0 20 69 6e 74 20 6e 52 65 66 49 6e 69 74 4d 75 74 int nRefInitMut
225f0 65 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ex;
22600 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
22610 75 73 65 72 73 20 6f 66 20 70 49 6e 69 74 4d 75 users of pInitMu
22620 74 65 78 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 tex */. sqlite3
22630 5f 6d 75 74 65 78 20 2a 70 49 6e 69 74 4d 75 74 _mutex *pInitMut
22640 65 78 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 ex; /* Mu
22650 74 65 78 20 75 73 65 64 20 62 79 20 73 71 6c 69 tex used by sqli
22660 74 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 te3_initialize()
22670 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 4c 6f */. void (*xLo
22680 67 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e g)(void*,int,con
22690 73 74 20 63 68 61 72 2a 29 3b 20 2f 2a 20 46 75 st char*); /* Fu
226a0 6e 63 74 69 6f 6e 20 66 6f 72 20 6c 6f 67 67 69 nction for loggi
226b0 6e 67 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4c ng */. void *pL
226c0 6f 67 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 ogArg;
226d0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
226e0 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 First argument t
226f0 6f 20 78 4c 6f 67 28 29 20 2a 2f 0a 23 69 66 64 o xLog() */.#ifd
22700 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
22710 5f 53 51 4c 4c 4f 47 0a 20 20 76 6f 69 64 28 2a _SQLLOG. void(*
22720 78 53 71 6c 6c 6f 67 29 28 76 6f 69 64 2a 2c 73 xSqllog)(void*,s
22730 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
22740 61 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 ar*, int);. voi
22750 64 20 2a 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 23 d *pSqllogArg;.#
22760 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c endif.#ifdef SQL
22770 49 54 45 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 ITE_VDBE_COVERAG
22780 45 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f E. /* The follo
22790 77 69 6e 67 20 63 61 6c 6c 62 61 63 6b 20 28 69 wing callback (i
227a0 66 20 6e 6f 74 20 4e 55 4c 4c 29 20 69 73 20 69 f not NULL) is i
227b0 6e 76 6f 6b 65 64 20 6f 6e 20 65 76 65 72 79 20 nvoked on every
227c0 56 44 42 45 20 62 72 61 6e 63 68 0a 20 20 2a 2a VDBE branch. **
227d0 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 53 65 74 operation. Set
227e0 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 75 73 the callback us
227f0 69 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 54 43 ing SQLITE_TESTC
22800 54 52 4c 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 TRL_VDBE_COVERAG
22810 45 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 20 28 E.. */. void (
22820 2a 78 56 64 62 65 42 72 61 6e 63 68 29 28 76 6f *xVdbeBranch)(vo
22830 69 64 2a 2c 69 6e 74 20 69 53 72 63 4c 69 6e 65 id*,int iSrcLine
22840 2c 75 38 20 65 54 68 69 73 2c 75 38 20 65 4d 78 ,u8 eThis,u8 eMx
22850 29 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 ); /* Callback
22860 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 56 64 62 65 */. void *pVdbe
22870 42 72 61 6e 63 68 41 72 67 3b 20 20 20 20 20 20 BranchArg;
22880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
228a0 2a 20 31 73 74 20 61 72 67 75 6d 65 6e 74 20 2a * 1st argument *
228b0 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 /.#endif.#ifndef
228c0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 SQLITE_OMIT_BUI
228d0 4c 54 49 4e 5f 54 45 53 54 0a 20 20 69 6e 74 20 LTIN_TEST. int
228e0 28 2a 78 54 65 73 74 43 61 6c 6c 62 61 63 6b 29 (*xTestCallback)
228f0 28 69 6e 74 29 3b 20 20 20 20 20 20 20 20 2f 2a (int); /*
22900 20 49 6e 76 6f 6b 65 64 20 62 79 20 73 71 6c 69 Invoked by sqli
22910 74 65 33 46 61 75 6c 74 53 69 6d 28 29 20 2a 2f te3FaultSim() */
22920 0a 23 65 6e 64 69 66 0a 20 20 69 6e 74 20 62 4c .#endif. int bL
22930 6f 63 61 6c 74 69 6d 65 46 61 75 6c 74 3b 20 20 ocaltimeFault;
22940 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
22950 72 75 65 20 74 6f 20 66 61 69 6c 20 6c 6f 63 61 rue to fail loca
22960 6c 74 69 6d 65 28 29 20 63 61 6c 6c 73 20 2a 2f ltime() calls */
22970 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 .};../*.** This
22980 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 69 6e macro is used in
22990 73 69 64 65 20 6f 66 20 61 73 73 65 72 74 28 29 side of assert()
229a0 20 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 69 statements to i
229b0 6e 64 69 63 61 74 65 20 74 68 61 74 0a 2a 2a 20 ndicate that.**
229c0 74 68 65 20 61 73 73 65 72 74 20 69 73 20 6f 6e the assert is on
229d0 6c 79 20 76 61 6c 69 64 20 6f 6e 20 61 20 77 65 ly valid on a we
229e0 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 ll-formed databa
229f0 73 65 2e 20 20 49 6e 73 74 65 61 64 20 6f 66 3a se. Instead of:
22a00 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 73 73 65 72 .**.** asser
22a10 74 28 20 58 20 29 3b 0a 2a 2a 0a 2a 2a 20 4f 6e t( X );.**.** On
22a20 65 20 77 72 69 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 e writes:.**.**
22a30 20 20 20 20 61 73 73 65 72 74 28 20 58 20 7c 7c assert( X ||
22a40 20 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 2a CORRUPT_DB );.*
22a50 2a 0a 2a 2a 20 43 4f 52 52 55 50 54 5f 44 42 20 *.** CORRUPT_DB
22a60 69 73 20 74 72 75 65 20 64 75 72 69 6e 67 20 6e is true during n
22a70 6f 72 6d 61 6c 20 6f 70 65 72 61 74 69 6f 6e 2e ormal operation.
22a80 20 20 43 4f 52 52 55 50 54 5f 44 42 20 64 6f 65 CORRUPT_DB doe
22a90 73 20 6e 6f 74 20 69 6e 64 69 63 61 74 65 0a 2a s not indicate.*
22aa0 2a 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 * that the datab
22ab0 61 73 65 20 69 73 20 64 65 66 69 6e 69 74 65 6c ase is definitel
22ac0 79 20 63 6f 72 72 75 70 74 2c 20 6f 6e 6c 79 20 y corrupt, only
22ad0 74 68 61 74 20 69 74 20 6d 69 67 68 74 20 62 65 that it might be
22ae0 20 63 6f 72 72 75 70 74 2e 0a 2a 2a 20 46 6f 72 corrupt..** For
22af0 20 6d 6f 73 74 20 74 65 73 74 20 63 61 73 65 73 most test cases
22b00 2c 20 43 4f 52 52 55 50 54 5f 44 42 20 69 73 20 , CORRUPT_DB is
22b10 73 65 74 20 74 6f 20 66 61 6c 73 65 20 75 73 69 set to false usi
22b20 6e 67 20 61 20 73 70 65 63 69 61 6c 0a 2a 2a 20 ng a special.**
22b30 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e sqlite3_test_con
22b40 74 72 6f 6c 28 29 2e 20 20 54 68 69 73 20 65 6e trol(). This en
22b50 61 62 6c 65 73 20 61 73 73 65 72 74 28 29 20 73 ables assert() s
22b60 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 70 72 6f tatements to pro
22b70 76 65 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 ve.** things tha
22b80 74 20 61 72 65 20 61 6c 77 61 79 73 20 74 72 75 t are always tru
22b90 65 20 66 6f 72 20 77 65 6c 6c 2d 66 6f 72 6d 65 e for well-forme
22ba0 64 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a d databases..*/.
22bb0 23 64 65 66 69 6e 65 20 43 4f 52 52 55 50 54 5f #define CORRUPT_
22bc0 44 42 20 20 28 73 71 6c 69 74 65 33 43 6f 6e 66 DB (sqlite3Conf
22bd0 69 67 2e 6e 65 76 65 72 43 6f 72 72 75 70 74 3d ig.neverCorrupt=
22be0 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 74 65 =0)../*.** Conte
22bf0 78 74 20 70 6f 69 6e 74 65 72 20 70 61 73 73 65 xt pointer passe
22c00 64 20 64 6f 77 6e 20 74 68 72 6f 75 67 68 20 74 d down through t
22c10 68 65 20 74 72 65 65 2d 77 61 6c 6b 2e 0a 2a 2f he tree-walk..*/
22c20 0a 73 74 72 75 63 74 20 57 61 6c 6b 65 72 20 7b .struct Walker {
22c30 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 . Parse *pParse
22c40 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
22c50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
22c60 50 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 Parser context.
22c70 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 45 78 70 */. int (*xExp
22c80 72 43 61 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 rCallback)(Walke
22c90 72 2a 2c 20 45 78 70 72 2a 29 3b 20 20 20 20 20 r*, Expr*);
22ca0 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 6f 72 20 /* Callback for
22cb0 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
22cc0 20 69 6e 74 20 28 2a 78 53 65 6c 65 63 74 43 61 int (*xSelectCa
22cd0 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 72 2a 2c llback)(Walker*,
22ce0 53 65 6c 65 63 74 2a 29 3b 20 20 2f 2a 20 43 61 Select*); /* Ca
22cf0 6c 6c 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 43 llback for SELEC
22d00 54 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 Ts */. void (*x
22d10 53 65 6c 65 63 74 43 61 6c 6c 62 61 63 6b 32 29 SelectCallback2)
22d20 28 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 63 74 2a (Walker*,Select*
22d30 29 3b 2f 2a 20 53 65 63 6f 6e 64 20 63 61 6c 6c );/* Second call
22d40 62 61 63 6b 20 66 6f 72 20 53 45 4c 45 43 54 73 back for SELECTs
22d50 20 2a 2f 0a 20 20 69 6e 74 20 77 61 6c 6b 65 72 */. int walker
22d60 44 65 70 74 68 3b 20 20 20 20 20 20 20 20 20 20 Depth;
22d70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22d80 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 75 62 /* Number of sub
22d90 71 75 65 72 69 65 73 20 2a 2f 0a 20 20 75 38 20 queries */. u8
22da0 65 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 eCode;
22db0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22dc0 20 20 20 20 20 20 20 2f 2a 20 41 20 73 6d 61 6c /* A smal
22dd0 6c 20 70 72 6f 63 65 73 73 69 6e 67 20 63 6f 64 l processing cod
22de0 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 20 20 e */. union {
22df0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22e10 20 2f 2a 20 45 78 74 72 61 20 64 61 74 61 20 66 /* Extra data f
22e20 6f 72 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 or callback */.
22e30 20 20 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 2a NameContext *
22e40 70 4e 43 3b 20 20 20 20 20 20 20 20 20 20 20 20 pNC;
22e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
22e60 20 4e 61 6d 69 6e 67 20 63 6f 6e 74 65 78 74 20 Naming context
22e70 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 3b 20 20 20 */. int n;
22e80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22e90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22ea0 20 20 2f 2a 20 41 20 63 6f 75 6e 74 65 72 20 2a /* A counter *
22eb0 2f 0a 20 20 20 20 69 6e 74 20 69 43 75 72 3b 20 /. int iCur;
22ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22ed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22ee0 20 2f 2a 20 41 20 63 75 72 73 6f 72 20 6e 75 6d /* A cursor num
22ef0 62 65 72 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 ber */. SrcLi
22f00 73 74 20 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 st *pSrcList;
22f10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22f20 20 20 20 20 20 20 2f 2a 20 46 52 4f 4d 20 63 6c /* FROM cl
22f30 61 75 73 65 20 2a 2f 0a 20 20 20 20 73 74 72 75 ause */. stru
22f40 63 74 20 53 72 63 43 6f 75 6e 74 20 2a 70 53 72 ct SrcCount *pSr
22f50 63 43 6f 75 6e 74 3b 20 20 20 20 20 20 20 20 20 cCount;
22f60 20 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e 74 69 /* Counti
22f70 6e 67 20 63 6f 6c 75 6d 6e 20 72 65 66 65 72 65 ng column refere
22f80 6e 63 65 73 20 2a 2f 0a 20 20 20 20 73 74 72 75 nces */. stru
22f90 63 74 20 43 43 75 72 48 69 6e 74 20 2a 70 43 43 ct CCurHint *pCC
22fa0 75 72 48 69 6e 74 3b 20 20 20 20 20 20 20 20 20 urHint;
22fb0 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 62 /* Used b
22fc0 79 20 63 6f 64 65 43 75 72 73 6f 72 48 69 6e 74 y codeCursorHint
22fd0 28 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20 2a 61 () */. int *a
22fe0 69 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 iCol;
22ff0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23000 20 20 20 20 20 2f 2a 20 61 72 72 61 79 20 6f 66 /* array of
23010 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 65 73 20 column indexes
23020 2a 2f 0a 20 20 20 20 73 74 72 75 63 74 20 49 64 */. struct Id
23030 78 43 6f 76 65 72 20 2a 70 49 64 78 43 6f 76 65 xCover *pIdxCove
23040 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r;
23050 20 20 2f 2a 20 43 68 65 63 6b 20 66 6f 72 20 69 /* Check for i
23060 6e 64 65 78 20 63 6f 76 65 72 61 67 65 20 2a 2f ndex coverage */
23070 0a 20 20 7d 20 75 3b 0a 7d 3b 0a 0a 2f 2a 20 46 . } u;.};../* F
23080 6f 72 77 61 72 64 20 64 65 63 6c 61 72 61 74 69 orward declarati
23090 6f 6e 73 20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ons */.int sqlit
230a0 65 33 57 61 6c 6b 45 78 70 72 28 57 61 6c 6b 65 e3WalkExpr(Walke
230b0 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 r*, Expr*);.int
230c0 73 71 6c 69 74 65 33 57 61 6c 6b 45 78 70 72 4c sqlite3WalkExprL
230d0 69 73 74 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 ist(Walker*, Exp
230e0 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c rList*);.int sql
230f0 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 28 57 ite3WalkSelect(W
23100 61 6c 6b 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 alker*, Select*)
23110 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c ;.int sqlite3Wal
23120 6b 53 65 6c 65 63 74 45 78 70 72 28 57 61 6c 6b kSelectExpr(Walk
23130 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 er*, Select*);.i
23140 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 6b 53 65 nt sqlite3WalkSe
23150 6c 65 63 74 46 72 6f 6d 28 57 61 6c 6b 65 72 2a lectFrom(Walker*
23160 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 , Select*);.int
23170 73 71 6c 69 74 65 33 45 78 70 72 57 61 6c 6b 4e sqlite3ExprWalkN
23180 6f 6f 70 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 oop(Walker*, Exp
23190 72 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 r*);../*.** Retu
231a0 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 65 rn code from the
231b0 20 70 61 72 73 65 2d 74 72 65 65 20 77 61 6c 6b parse-tree walk
231c0 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 20 61 ing primitives a
231d0 6e 64 20 74 68 65 69 72 0a 2a 2a 20 63 61 6c 6c nd their.** call
231e0 62 61 63 6b 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e backs..*/.#defin
231f0 65 20 57 52 43 5f 43 6f 6e 74 69 6e 75 65 20 20 e WRC_Continue
23200 20 20 30 20 20 20 2f 2a 20 43 6f 6e 74 69 6e 75 0 /* Continu
23210 65 20 64 6f 77 6e 20 69 6e 74 6f 20 63 68 69 6c e down into chil
23220 64 72 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 dren */.#define
23230 57 52 43 5f 50 72 75 6e 65 20 20 20 20 20 20 20 WRC_Prune
23240 31 20 20 20 2f 2a 20 4f 6d 69 74 20 63 68 69 6c 1 /* Omit chil
23250 64 72 65 6e 20 62 75 74 20 63 6f 6e 74 69 6e 75 dren but continu
23260 65 20 77 61 6c 6b 69 6e 67 20 73 69 62 6c 69 6e e walking siblin
23270 67 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 52 gs */.#define WR
23280 43 5f 41 62 6f 72 74 20 20 20 20 20 20 20 32 20 C_Abort 2
23290 20 20 2f 2a 20 41 62 61 6e 64 6f 6e 20 74 68 65 /* Abandon the
232a0 20 74 72 65 65 20 77 61 6c 6b 20 2a 2f 0a 0a 2f tree walk */../
232b0 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
232c0 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 of this structu
232d0 72 65 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 re represents a
232e0 73 65 74 20 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f set of one or mo
232f0 72 65 20 43 54 45 73 0a 2a 2a 20 28 63 6f 6d 6d re CTEs.** (comm
23300 6f 6e 20 74 61 62 6c 65 20 65 78 70 72 65 73 73 on table express
23310 69 6f 6e 73 29 20 63 72 65 61 74 65 64 20 62 79 ions) created by
23320 20 61 20 73 69 6e 67 6c 65 20 57 49 54 48 20 63 a single WITH c
23330 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 lause..*/.struct
23340 20 57 69 74 68 20 7b 0a 20 20 69 6e 74 20 6e 43 With {. int nC
23350 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 te;
23360 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
23370 62 65 72 20 6f 66 20 43 54 45 73 20 69 6e 20 74 ber of CTEs in t
23380 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 20 2a he WITH clause *
23390 2f 0a 20 20 57 69 74 68 20 2a 70 4f 75 74 65 72 /. With *pOuter
233a0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
233b0 20 20 20 20 2f 2a 20 43 6f 6e 74 61 69 6e 69 6e /* Containin
233c0 67 20 57 49 54 48 20 63 6c 61 75 73 65 2c 20 6f g WITH clause, o
233d0 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 73 74 72 75 r NULL */. stru
233e0 63 74 20 43 74 65 20 7b 20 20 20 20 20 20 20 20 ct Cte {
233f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
23400 6f 72 20 65 61 63 68 20 43 54 45 20 69 6e 20 74 or each CTE in t
23410 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 2e 2e he WITH clause..
23420 2e 2e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a .. */. char *
23430 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 zName;
23440 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d /* Nam
23450 65 20 6f 66 20 74 68 69 73 20 43 54 45 20 2a 2f e of this CTE */
23460 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 2a 70 . ExprList *p
23470 43 6f 6c 73 3b 20 20 20 20 20 20 20 20 20 20 20 Cols;
23480 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
23490 65 78 70 6c 69 63 69 74 20 63 6f 6c 75 6d 6e 20 explicit column
234a0 6e 61 6d 65 73 2c 20 6f 72 20 4e 55 4c 4c 20 2a names, or NULL *
234b0 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 /. Select *pS
234c0 65 6c 65 63 74 3b 20 20 20 20 20 20 20 20 20 20 elect;
234d0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 65 66 /* The def
234e0 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 inition of this
234f0 43 54 45 20 2a 2f 0a 20 20 20 20 63 6f 6e 73 74 CTE */. const
23500 20 63 68 61 72 20 2a 7a 43 74 65 45 72 72 3b 20 char *zCteErr;
23510 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 /* Er
23520 72 6f 72 20 6d 65 73 73 61 67 65 20 66 6f 72 20 ror message for
23530 63 69 72 63 75 6c 61 72 20 72 65 66 65 72 65 6e circular referen
23540 63 65 73 20 2a 2f 0a 20 20 7d 20 61 5b 31 5d 3b ces */. } a[1];
23550 0a 7d 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 .};..#ifdef SQLI
23560 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 41 TE_DEBUG./*.** A
23570 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
23580 65 20 54 72 65 65 56 69 65 77 20 6f 62 6a 65 63 e TreeView objec
23590 74 20 69 73 20 75 73 65 64 20 66 6f 72 20 70 72 t is used for pr
235a0 69 6e 74 69 6e 67 20 74 68 65 20 63 6f 6e 74 65 inting the conte
235b0 6e 74 20 6f 66 0a 2a 2a 20 64 61 74 61 20 73 74 nt of.** data st
235c0 72 75 63 74 75 72 65 73 20 6f 6e 20 73 71 6c 69 ructures on sqli
235d0 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 29 te3DebugPrintf()
235e0 20 75 73 69 6e 67 20 61 20 74 72 65 65 2d 6c 69 using a tree-li
235f0 6b 65 20 76 69 65 77 2e 0a 2a 2f 0a 73 74 72 75 ke view..*/.stru
23600 63 74 20 54 72 65 65 56 69 65 77 20 7b 0a 20 20 ct TreeView {.
23610 69 6e 74 20 69 4c 65 76 65 6c 3b 20 20 20 20 20 int iLevel;
23620 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68 /* Which
23630 20 6c 65 76 65 6c 20 6f 66 20 74 68 65 20 74 72 level of the tr
23640 65 65 20 77 65 20 61 72 65 20 6f 6e 20 2a 2f 0a ee we are on */.
23650 20 20 75 38 20 20 62 4c 69 6e 65 5b 31 30 30 5d u8 bLine[100]
23660 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 44 72 61 ; /* Dra
23670 77 20 76 65 72 74 69 63 61 6c 20 69 6e 20 63 6f w vertical in co
23680 6c 75 6d 6e 20 69 20 69 66 20 62 4c 69 6e 65 5b lumn i if bLine[
23690 69 5d 20 69 73 20 74 72 75 65 20 2a 2f 0a 7d 3b i] is true */.};
236a0 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
236b0 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 2f 2a 0a 2a E_DEBUG */../*.*
236c0 2a 20 41 73 73 75 6d 69 6e 67 20 7a 49 6e 20 70 * Assuming zIn p
236d0 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 66 69 72 oints to the fir
236e0 73 74 20 62 79 74 65 20 6f 66 20 61 20 55 54 46 st byte of a UTF
236f0 2d 38 20 63 68 61 72 61 63 74 65 72 2c 0a 2a 2a -8 character,.**
23700 20 61 64 76 61 6e 63 65 20 7a 49 6e 20 74 6f 20 advance zIn to
23710 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 66 69 72 point to the fir
23720 73 74 20 62 79 74 65 20 6f 66 20 74 68 65 20 6e st byte of the n
23730 65 78 74 20 55 54 46 2d 38 20 63 68 61 72 61 63 ext UTF-8 charac
23740 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ter..*/.#define
23750 53 51 4c 49 54 45 5f 53 4b 49 50 5f 55 54 46 38 SQLITE_SKIP_UTF8
23760 28 7a 49 6e 29 20 7b 20 20 20 20 20 20 20 20 20 (zIn) {
23770 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 5c \
23780 0a 20 20 69 66 28 20 28 2a 28 7a 49 6e 2b 2b 29 . if( (*(zIn++)
23790 29 3e 3d 30 78 63 30 20 29 7b 20 20 20 20 20 20 )>=0xc0 ){
237a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
237b0 20 20 20 20 20 20 20 20 5c 0a 20 20 20 20 77 68 \. wh
237c0 69 6c 65 28 20 28 2a 7a 49 6e 20 26 20 30 78 63 ile( (*zIn & 0xc
237d0 30 29 3d 3d 30 78 38 30 20 29 7b 20 7a 49 6e 2b 0)==0x80 ){ zIn+
237e0 2b 3b 20 7d 20 20 20 20 20 20 20 20 20 20 20 20 +; }
237f0 20 5c 0a 20 20 7d 20 20 20 20 20 20 20 20 20 20 \. }
23800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23810 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23820 20 20 20 20 20 20 20 20 20 20 5c 0a 7d 0a 0a 2f \.}../
23830 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f *.** The SQLITE_
23840 2a 5f 42 4b 50 54 20 6d 61 63 72 6f 73 20 61 72 *_BKPT macros ar
23850 65 20 73 75 62 73 74 69 74 75 74 65 73 20 66 6f e substitutes fo
23860 72 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64 65 r the error code
23870 73 20 77 69 74 68 0a 2a 2a 20 74 68 65 20 73 61 s with.** the sa
23880 6d 65 20 6e 61 6d 65 20 62 75 74 20 77 69 74 68 me name but with
23890 6f 75 74 20 74 68 65 20 5f 42 4b 50 54 20 73 75 out the _BKPT su
238a0 66 66 69 78 2e 20 20 54 68 65 73 65 20 6d 61 63 ffix. These mac
238b0 72 6f 73 20 69 6e 76 6f 6b 65 0a 2a 2a 20 72 6f ros invoke.** ro
238c0 75 74 69 6e 65 73 20 74 68 61 74 20 72 65 70 6f utines that repo
238d0 72 74 20 74 68 65 20 6c 69 6e 65 2d 6e 75 6d 62 rt the line-numb
238e0 65 72 20 6f 6e 20 77 68 69 63 68 20 74 68 65 20 er on which the
238f0 65 72 72 6f 72 20 6f 72 69 67 69 6e 61 74 65 64 error originated
23900 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69 74 65 .** using sqlite
23910 33 5f 6c 6f 67 28 29 2e 20 20 54 68 65 20 72 6f 3_log(). The ro
23920 75 74 69 6e 65 73 20 61 6c 73 6f 20 70 72 6f 76 utines also prov
23930 69 64 65 20 61 20 63 6f 6e 76 65 6e 69 65 6e 74 ide a convenient
23940 20 70 6c 61 63 65 0a 2a 2a 20 74 6f 20 73 65 74 place.** to set
23950 20 61 20 64 65 62 75 67 67 65 72 20 62 72 65 61 a debugger brea
23960 6b 70 6f 69 6e 74 2e 0a 2a 2f 0a 69 6e 74 20 73 kpoint..*/.int s
23970 71 6c 69 74 65 33 43 6f 72 72 75 70 74 45 72 72 qlite3CorruptErr
23980 6f 72 28 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c or(int);.int sql
23990 69 74 65 33 4d 69 73 75 73 65 45 72 72 6f 72 28 ite3MisuseError(
239a0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
239b0 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f 72 28 69 3CantopenError(i
239c0 6e 74 29 3b 0a 23 64 65 66 69 6e 65 20 53 51 4c nt);.#define SQL
239d0 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 ITE_CORRUPT_BKPT
239e0 20 73 71 6c 69 74 65 33 43 6f 72 72 75 70 74 45 sqlite3CorruptE
239f0 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 rror(__LINE__).#
23a00 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 49 define SQLITE_MI
23a10 53 55 53 45 5f 42 4b 50 54 20 73 71 6c 69 74 65 SUSE_BKPT sqlite
23a20 33 4d 69 73 75 73 65 45 72 72 6f 72 28 5f 5f 4c 3MisuseError(__L
23a30 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e 65 20 53 INE__).#define S
23a40 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 5f 42 QLITE_CANTOPEN_B
23a50 4b 50 54 20 73 71 6c 69 74 65 33 43 61 6e 74 6f KPT sqlite3Canto
23a60 70 65 6e 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f penError(__LINE_
23a70 5f 29 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 _).#ifdef SQLITE
23a80 5f 44 45 42 55 47 0a 20 20 69 6e 74 20 73 71 6c _DEBUG. int sql
23a90 69 74 65 33 4e 6f 6d 65 6d 45 72 72 6f 72 28 69 ite3NomemError(i
23aa0 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 nt);. int sqlit
23ab0 65 33 49 6f 65 72 72 6e 6f 6d 65 6d 45 72 72 6f e3IoerrnomemErro
23ac0 72 28 69 6e 74 29 3b 0a 23 20 64 65 66 69 6e 65 r(int);.# define
23ad0 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b SQLITE_NOMEM_BK
23ae0 50 54 20 73 71 6c 69 74 65 33 4e 6f 6d 65 6d 45 PT sqlite3NomemE
23af0 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 rror(__LINE__).#
23b00 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 define SQLITE_I
23b10 4f 45 52 52 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 OERR_NOMEM_BKPT
23b20 73 71 6c 69 74 65 33 49 6f 65 72 72 6e 6f 6d 65 sqlite3Ioerrnome
23b30 6d 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 mError(__LINE__)
23b40 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
23b50 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 SQLITE_NOMEM_BKP
23b60 54 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 0a 23 T SQLITE_NOMEM.#
23b70 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 define SQLITE_I
23b80 4f 45 52 52 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 OERR_NOMEM_BKPT
23b90 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d SQLITE_IOERR_NOM
23ba0 45 4d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a EM.#endif../*.**
23bb0 20 46 54 53 33 20 61 6e 64 20 46 54 53 34 20 62 FTS3 and FTS4 b
23bc0 6f 74 68 20 72 65 71 75 69 72 65 20 76 69 72 74 oth require virt
23bd0 75 61 6c 20 74 61 62 6c 65 20 73 75 70 70 6f 72 ual table suppor
23be0 74 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 t.*/.#if defined
23bf0 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 (SQLITE_OMIT_VIR
23c00 54 55 41 4c 54 41 42 4c 45 29 0a 23 20 75 6e 64 TUALTABLE).# und
23c10 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
23c20 5f 46 54 53 33 0a 23 20 75 6e 64 65 66 20 53 51 _FTS3.# undef SQ
23c30 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 LITE_ENABLE_FTS4
23c40 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 .#endif../*.** F
23c50 54 53 34 20 69 73 20 72 65 61 6c 6c 79 20 61 6e TS4 is really an
23c60 20 65 78 74 65 6e 73 69 6f 6e 20 66 6f 72 20 46 extension for F
23c70 54 53 33 2e 20 20 49 74 20 69 73 20 65 6e 61 62 TS3. It is enab
23c80 6c 65 64 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a led using the.**
23c90 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
23ca0 54 53 33 20 6d 61 63 72 6f 2e 20 20 42 75 74 20 TS3 macro. But
23cb0 74 6f 20 61 76 6f 69 64 20 63 6f 6e 66 75 73 69 to avoid confusi
23cc0 6f 6e 20 77 65 20 61 6c 73 6f 20 63 61 6c 6c 0a on we also call.
23cd0 2a 2a 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e ** the SQLITE_EN
23ce0 41 42 4c 45 5f 46 54 53 34 20 6d 61 63 72 6f 20 ABLE_FTS4 macro
23cf0 74 6f 20 73 65 72 76 65 20 61 73 20 61 6e 20 61 to serve as an a
23d00 6c 69 61 73 20 66 6f 72 20 53 51 4c 49 54 45 5f lias for SQLITE_
23d10 45 4e 41 42 4c 45 5f 46 54 53 33 2e 0a 2a 2f 0a ENABLE_FTS3..*/.
23d20 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 #if defined(SQLI
23d30 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 29 20 TE_ENABLE_FTS4)
23d40 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
23d50 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 29 0a TE_ENABLE_FTS3).
23d60 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
23d70 45 4e 41 42 4c 45 5f 46 54 53 33 20 31 0a 23 65 ENABLE_FTS3 1.#e
23d80 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
23d90 63 74 79 70 65 2e 68 20 68 65 61 64 65 72 20 69 ctype.h header i
23da0 73 20 6e 65 65 64 65 64 20 66 6f 72 20 6e 6f 6e s needed for non
23db0 2d 41 53 43 49 49 20 73 79 73 74 65 6d 73 2e 20 -ASCII systems.
23dc0 20 49 74 20 69 73 20 61 6c 73 6f 0a 2a 2a 20 6e It is also.** n
23dd0 65 65 64 65 64 20 62 79 20 46 54 53 33 20 77 68 eeded by FTS3 wh
23de0 65 6e 20 46 54 53 33 20 69 73 20 69 6e 63 6c 75 en FTS3 is inclu
23df0 64 65 64 20 69 6e 20 74 68 65 20 61 6d 61 6c 67 ded in the amalg
23e00 61 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 amation..*/.#if
23e10 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
23e20 41 53 43 49 49 29 20 7c 7c 20 5c 0a 20 20 20 20 ASCII) || \.
23e30 28 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f (defined(SQLITE_
23e40 45 4e 41 42 4c 45 5f 46 54 53 33 29 20 26 26 20 ENABLE_FTS3) &&
23e50 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 41 defined(SQLITE_A
23e60 4d 41 4c 47 41 4d 41 54 49 4f 4e 29 29 0a 23 20 MALGAMATION)).#
23e70 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 include <ctype.h
23e80 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 >.#endif../*.**
23e90 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 The following ma
23ea0 63 72 6f 73 20 6d 69 6d 69 63 20 74 68 65 20 73 cros mimic the s
23eb0 74 61 6e 64 61 72 64 20 6c 69 62 72 61 72 79 20 tandard library
23ec0 66 75 6e 63 74 69 6f 6e 73 20 74 6f 75 70 70 65 functions touppe
23ed0 72 28 29 2c 0a 2a 2a 20 69 73 73 70 61 63 65 28 r(),.** isspace(
23ee0 29 2c 20 69 73 61 6c 6e 75 6d 28 29 2c 20 69 73 ), isalnum(), is
23ef0 64 69 67 69 74 28 29 20 61 6e 64 20 69 73 78 64 digit() and isxd
23f00 69 67 69 74 28 29 2c 20 72 65 73 70 65 63 74 69 igit(), respecti
23f10 76 65 6c 79 2e 20 54 68 65 0a 2a 2a 20 73 71 6c vely. The.** sql
23f20 69 74 65 20 76 65 72 73 69 6f 6e 73 20 6f 6e 6c ite versions onl
23f30 79 20 77 6f 72 6b 20 66 6f 72 20 41 53 43 49 49 y work for ASCII
23f40 20 63 68 61 72 61 63 74 65 72 73 2c 20 72 65 67 characters, reg
23f50 61 72 64 6c 65 73 73 20 6f 66 20 6c 6f 63 61 6c ardless of local
23f60 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c e..*/.#ifdef SQL
23f70 49 54 45 5f 41 53 43 49 49 0a 23 20 64 65 66 69 ITE_ASCII.# defi
23f80 6e 65 20 73 71 6c 69 74 65 33 54 6f 75 70 70 65 ne sqlite3Touppe
23f90 72 28 78 29 20 20 28 28 78 29 26 7e 28 73 71 6c r(x) ((x)&~(sql
23fa0 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e ite3CtypeMap[(un
23fb0 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d signed char)(x)]
23fc0 26 30 78 32 30 29 29 0a 23 20 64 65 66 69 6e 65 &0x20)).# define
23fd0 20 73 71 6c 69 74 65 33 49 73 73 70 61 63 65 28 sqlite3Isspace(
23fe0 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 x) (sqlite3Cty
23ff0 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
24000 63 68 61 72 29 28 78 29 5d 26 30 78 30 31 29 0a char)(x)]&0x01).
24010 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
24020 49 73 61 6c 6e 75 6d 28 78 29 20 20 20 28 73 71 Isalnum(x) (sq
24030 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
24040 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
24050 5d 26 30 78 30 36 29 0a 23 20 64 65 66 69 6e 65 ]&0x06).# define
24060 20 73 71 6c 69 74 65 33 49 73 61 6c 70 68 61 28 sqlite3Isalpha(
24070 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 x) (sqlite3Cty
24080 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
24090 63 68 61 72 29 28 78 29 5d 26 30 78 30 32 29 0a char)(x)]&0x02).
240a0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
240b0 49 73 64 69 67 69 74 28 78 29 20 20 20 28 73 71 Isdigit(x) (sq
240c0 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 28 75 lite3CtypeMap[(u
240d0 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
240e0 5d 26 30 78 30 34 29 0a 23 20 64 65 66 69 6e 65 ]&0x04).# define
240f0 20 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 sqlite3Isxdigit
24100 28 78 29 20 20 28 73 71 6c 69 74 65 33 43 74 79 (x) (sqlite3Cty
24110 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 peMap[(unsigned
24120 63 68 61 72 29 28 78 29 5d 26 30 78 30 38 29 0a char)(x)]&0x08).
24130 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
24140 54 6f 6c 6f 77 65 72 28 78 29 20 20 20 28 73 71 Tolower(x) (sq
24150 6c 69 74 65 33 55 70 70 65 72 54 6f 4c 6f 77 65 lite3UpperToLowe
24160 72 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 r[(unsigned char
24170 29 28 78 29 5d 29 0a 23 20 64 65 66 69 6e 65 20 )(x)]).# define
24180 73 71 6c 69 74 65 33 49 73 71 75 6f 74 65 28 78 sqlite3Isquote(x
24190 29 20 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 ) (sqlite3Ctyp
241a0 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 eMap[(unsigned c
241b0 68 61 72 29 28 78 29 5d 26 30 78 38 30 29 0a 23 har)(x)]&0x80).#
241c0 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
241d0 6c 69 74 65 33 54 6f 75 70 70 65 72 28 78 29 20 lite3Toupper(x)
241e0 20 20 74 6f 75 70 70 65 72 28 28 75 6e 73 69 67 toupper((unsig
241f0 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 ned char)(x)).#
24200 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 define sqlite3Is
24210 73 70 61 63 65 28 78 29 20 20 20 69 73 73 70 61 space(x) isspa
24220 63 65 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ce((unsigned cha
24230 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 r)(x)).# define
24240 73 71 6c 69 74 65 33 49 73 61 6c 6e 75 6d 28 78 sqlite3Isalnum(x
24250 29 20 20 20 69 73 61 6c 6e 75 6d 28 28 75 6e 73 ) isalnum((uns
24260 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a igned char)(x)).
24270 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
24280 49 73 61 6c 70 68 61 28 78 29 20 20 20 69 73 61 Isalpha(x) isa
24290 6c 70 68 61 28 28 75 6e 73 69 67 6e 65 64 20 63 lpha((unsigned c
242a0 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e har)(x)).# defin
242b0 65 20 73 71 6c 69 74 65 33 49 73 64 69 67 69 74 e sqlite3Isdigit
242c0 28 78 29 20 20 20 69 73 64 69 67 69 74 28 28 75 (x) isdigit((u
242d0 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
242e0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
242f0 65 33 49 73 78 64 69 67 69 74 28 78 29 20 20 69 e3Isxdigit(x) i
24300 73 78 64 69 67 69 74 28 28 75 6e 73 69 67 6e 65 sxdigit((unsigne
24310 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 d char)(x)).# de
24320 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f 6c 6f fine sqlite3Tolo
24330 77 65 72 28 78 29 20 20 20 74 6f 6c 6f 77 65 72 wer(x) tolower
24340 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 ((unsigned char)
24350 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 (x)).# define sq
24360 6c 69 74 65 33 49 73 71 75 6f 74 65 28 78 29 20 lite3Isquote(x)
24370 20 20 28 28 78 29 3d 3d 27 22 27 7c 7c 28 78 29 ((x)=='"'||(x)
24380 3d 3d 27 5c 27 27 7c 7c 28 78 29 3d 3d 27 5b 27 =='\''||(x)=='['
24390 7c 7c 28 78 29 3d 3d 27 60 27 29 0a 23 65 6e 64 ||(x)=='`').#end
243a0 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
243b0 45 5f 4f 4d 49 54 5f 43 4f 4d 50 49 4c 45 4f 50 E_OMIT_COMPILEOP
243c0 54 49 4f 4e 5f 44 49 41 47 53 0a 69 6e 74 20 73 TION_DIAGS.int s
243d0 71 6c 69 74 65 33 49 73 49 64 43 68 61 72 28 75 qlite3IsIdChar(u
243e0 38 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 8);.#endif../*.*
243f0 2a 20 49 6e 74 65 72 6e 61 6c 20 66 75 6e 63 74 * Internal funct
24400 69 6f 6e 20 70 72 6f 74 6f 74 79 70 65 73 0a 2a ion prototypes.*
24410 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 72 /.int sqlite3Str
24420 49 43 6d 70 28 63 6f 6e 73 74 20 63 68 61 72 2a ICmp(const char*
24430 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 ,const char*);.i
24440 6e 74 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e nt sqlite3Strlen
24450 33 30 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 30(const char*);
24460 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 43 6f .char *sqlite3Co
24470 6c 75 6d 6e 54 79 70 65 28 43 6f 6c 75 6d 6e 2a lumnType(Column*
24480 2c 63 68 61 72 2a 29 3b 0a 23 64 65 66 69 6e 65 ,char*);.#define
24490 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 sqlite3StrNICmp
244a0 20 73 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d sqlite3_strnicm
244b0 70 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 p..int sqlite3Ma
244c0 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 29 3b 0a llocInit(void);.
244d0 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c void sqlite3Mall
244e0 6f 63 45 6e 64 28 76 6f 69 64 29 3b 0a 76 6f 69 ocEnd(void);.voi
244f0 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 d *sqlite3Malloc
24500 28 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c (u64);.void *sql
24510 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 75 ite3MallocZero(u
24520 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 64);.void *sqlit
24530 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 e3DbMallocZero(s
24540 71 6c 69 74 65 33 2a 2c 20 75 36 34 29 3b 0a 76 qlite3*, u64);.v
24550 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 oid *sqlite3DbMa
24560 6c 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33 2a llocRaw(sqlite3*
24570 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 , u64);.void *sq
24580 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 lite3DbMallocRaw
24590 4e 4e 28 73 71 6c 69 74 65 33 2a 2c 20 75 36 34 NN(sqlite3*, u64
245a0 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
245b0 44 62 53 74 72 44 75 70 28 73 71 6c 69 74 65 33 DbStrDup(sqlite3
245c0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a *,const char*);.
245d0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 44 62 53 char *sqlite3DbS
245e0 74 72 4e 44 75 70 28 73 71 6c 69 74 65 33 2a 2c trNDup(sqlite3*,
245f0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 75 36 34 const char*, u64
24600 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 );.void *sqlite3
24610 52 65 61 6c 6c 6f 63 28 76 6f 69 64 2a 2c 20 75 Realloc(void*, u
24620 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 64);.void *sqlit
24630 65 33 44 62 52 65 61 6c 6c 6f 63 4f 72 46 72 65 e3DbReallocOrFre
24640 65 28 73 71 6c 69 74 65 33 20 2a 2c 20 76 6f 69 e(sqlite3 *, voi
24650 64 20 2a 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 d *, u64);.void
24660 2a 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f *sqlite3DbReallo
24670 63 28 73 71 6c 69 74 65 33 20 2a 2c 20 76 6f 69 c(sqlite3 *, voi
24680 64 20 2a 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 d *, u64);.void
24690 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 73 71 sqlite3DbFree(sq
246a0 6c 69 74 65 33 2a 2c 20 76 6f 69 64 2a 29 3b 0a lite3*, void*);.
246b0 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f int sqlite3Mallo
246c0 63 53 69 7a 65 28 76 6f 69 64 2a 29 3b 0a 69 6e cSize(void*);.in
246d0 74 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f t sqlite3DbMallo
246e0 63 53 69 7a 65 28 73 71 6c 69 74 65 33 2a 2c 20 cSize(sqlite3*,
246f0 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 void*);.void *sq
24700 6c 69 74 65 33 53 63 72 61 74 63 68 4d 61 6c 6c lite3ScratchMall
24710 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 oc(int);.void sq
24720 6c 69 74 65 33 53 63 72 61 74 63 68 46 72 65 65 lite3ScratchFree
24730 28 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 2a 73 (void*);.void *s
24740 71 6c 69 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 qlite3PageMalloc
24750 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 (int);.void sqli
24760 74 65 33 50 61 67 65 46 72 65 65 28 76 6f 69 64 te3PageFree(void
24770 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
24780 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 28 76 6f MemSetDefault(vo
24790 69 64 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c id);.#ifndef SQL
247a0 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e ITE_OMIT_BUILTIN
247b0 5f 54 45 53 54 0a 76 6f 69 64 20 73 71 6c 69 74 _TEST.void sqlit
247c0 65 33 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 48 6f e3BenignMallocHo
247d0 6f 6b 73 28 76 6f 69 64 20 28 2a 29 28 76 6f 69 oks(void (*)(voi
247e0 64 29 2c 20 76 6f 69 64 20 28 2a 29 28 76 6f 69 d), void (*)(voi
247f0 64 29 29 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 d));.#endif.int
24800 73 71 6c 69 74 65 33 48 65 61 70 4e 65 61 72 6c sqlite3HeapNearl
24810 79 46 75 6c 6c 28 76 6f 69 64 29 3b 0a 0a 2f 2a yFull(void);../*
24820 0a 2a 2a 20 4f 6e 20 73 79 73 74 65 6d 73 20 77 .** On systems w
24830 69 74 68 20 61 6d 70 6c 65 20 73 74 61 63 6b 20 ith ample stack
24840 73 70 61 63 65 20 61 6e 64 20 74 68 61 74 20 73 space and that s
24850 75 70 70 6f 72 74 20 61 6c 6c 6f 63 61 28 29 2c upport alloca(),
24860 20 6d 61 6b 65 0a 2a 2a 20 75 73 65 20 6f 66 20 make.** use of
24870 61 6c 6c 6f 63 61 28 29 20 74 6f 20 6f 62 74 61 alloca() to obta
24880 69 6e 20 73 70 61 63 65 20 66 6f 72 20 6c 61 72 in space for lar
24890 67 65 20 61 75 74 6f 6d 61 74 69 63 20 6f 62 6a ge automatic obj
248a0 65 63 74 73 2e 20 20 42 79 20 64 65 66 61 75 6c ects. By defaul
248b0 74 2c 0a 2a 2a 20 6f 62 74 61 69 6e 20 73 70 61 t,.** obtain spa
248c0 63 65 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 28 29 ce from malloc()
248d0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 6c 6c 6f ..**.** The allo
248e0 63 61 28 29 20 72 6f 75 74 69 6e 65 20 6e 65 76 ca() routine nev
248f0 65 72 20 72 65 74 75 72 6e 73 20 4e 55 4c 4c 2e er returns NULL.
24900 20 20 54 68 69 73 20 77 69 6c 6c 20 63 61 75 73 This will caus
24910 65 20 63 6f 64 65 20 70 61 74 68 73 0a 2a 2a 20 e code paths.**
24920 74 68 61 74 20 64 65 61 6c 20 77 69 74 68 20 73 that deal with s
24930 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 qlite3StackAlloc
24940 28 29 20 66 61 69 6c 75 72 65 73 20 74 6f 20 62 () failures to b
24950 65 20 75 6e 72 65 61 63 68 61 62 6c 65 2e 0a 2a e unreachable..*
24960 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
24970 55 53 45 5f 41 4c 4c 4f 43 41 0a 23 20 64 65 66 USE_ALLOCA.# def
24980 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b ine sqlite3Stack
24990 41 6c 6c 6f 63 52 61 77 28 44 2c 4e 29 20 20 20 AllocRaw(D,N)
249a0 61 6c 6c 6f 63 61 28 4e 29 0a 23 20 64 65 66 69 alloca(N).# defi
249b0 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b 41 ne sqlite3StackA
249c0 6c 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 20 20 6d llocZero(D,N) m
249d0 65 6d 73 65 74 28 61 6c 6c 6f 63 61 28 4e 29 2c emset(alloca(N),
249e0 20 30 2c 20 4e 29 0a 23 20 64 65 66 69 6e 65 20 0, N).# define
249f0 73 71 6c 69 74 65 33 53 74 61 63 6b 46 72 65 65 sqlite3StackFree
24a00 28 44 2c 50 29 0a 23 65 6c 73 65 0a 23 20 64 65 (D,P).#else.# de
24a10 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 fine sqlite3Stac
24a20 6b 41 6c 6c 6f 63 52 61 77 28 44 2c 4e 29 20 20 kAllocRaw(D,N)
24a30 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 sqlite3DbMalloc
24a40 52 61 77 28 44 2c 4e 29 0a 23 20 64 65 66 69 6e Raw(D,N).# defin
24a50 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c e sqlite3StackAl
24a60 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 20 20 73 71 locZero(D,N) sq
24a70 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 lite3DbMallocZer
24a80 6f 28 44 2c 4e 29 0a 23 20 64 65 66 69 6e 65 20 o(D,N).# define
24a90 73 71 6c 69 74 65 33 53 74 61 63 6b 46 72 65 65 sqlite3StackFree
24aa0 28 44 2c 50 29 20 20 20 20 20 20 20 73 71 6c 69 (D,P) sqli
24ab0 74 65 33 44 62 46 72 65 65 28 44 2c 50 29 0a 23 te3DbFree(D,P).#
24ac0 65 6e 64 69 66 0a 0a 2f 2a 20 44 6f 20 6e 6f 74 endif../* Do not
24ad0 20 61 6c 6c 6f 77 20 62 6f 74 68 20 4d 45 4d 53 allow both MEMS
24ae0 59 53 35 20 61 6e 64 20 4d 45 4d 53 59 53 33 20 YS5 and MEMSYS3
24af0 74 6f 20 62 65 20 64 65 66 69 6e 65 64 20 74 6f to be defined to
24b00 67 65 74 68 65 72 2e 20 20 49 66 20 74 68 65 79 gether. If they
24b10 0a 2a 2a 20 61 72 65 2c 20 64 69 73 61 62 6c 65 .** are, disable
24b20 20 4d 45 4d 53 59 53 33 0a 2a 2f 0a 23 69 66 64 MEMSYS3.*/.#ifd
24b30 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
24b40 5f 4d 45 4d 53 59 53 35 0a 63 6f 6e 73 74 20 73 _MEMSYS5.const s
24b50 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f qlite3_mem_metho
24b60 64 73 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 ds *sqlite3MemGe
24b70 74 4d 65 6d 73 79 73 35 28 76 6f 69 64 29 3b 0a tMemsys5(void);.
24b80 23 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #undef SQLITE_EN
24b90 41 42 4c 45 5f 4d 45 4d 53 59 53 33 0a 23 65 6e ABLE_MEMSYS3.#en
24ba0 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 dif.#ifdef SQLIT
24bb0 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 E_ENABLE_MEMSYS3
24bc0 0a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d .const sqlite3_m
24bd0 65 6d 5f 6d 65 74 68 6f 64 73 20 2a 73 71 6c 69 em_methods *sqli
24be0 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 33 te3MemGetMemsys3
24bf0 28 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 0a (void);.#endif..
24c00 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
24c10 4d 55 54 45 58 5f 4f 4d 49 54 0a 20 20 73 71 6c MUTEX_OMIT. sql
24c20 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f ite3_mutex_metho
24c30 64 73 20 63 6f 6e 73 74 20 2a 73 71 6c 69 74 65 ds const *sqlite
24c40 33 44 65 66 61 75 6c 74 4d 75 74 65 78 28 76 6f 3DefaultMutex(vo
24c50 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d id);. sqlite3_m
24c60 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 6f 6e utex_methods con
24c70 73 74 20 2a 73 71 6c 69 74 65 33 4e 6f 6f 70 4d st *sqlite3NoopM
24c80 75 74 65 78 28 76 6f 69 64 29 3b 0a 20 20 73 71 utex(void);. sq
24c90 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c lite3_mutex *sql
24ca0 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 69 ite3MutexAlloc(i
24cb0 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 nt);. int sqlit
24cc0 65 33 4d 75 74 65 78 49 6e 69 74 28 76 6f 69 64 e3MutexInit(void
24cd0 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
24ce0 4d 75 74 65 78 45 6e 64 28 76 6f 69 64 29 3b 0a MutexEnd(void);.
24cf0 23 65 6e 64 69 66 0a 23 69 66 20 21 64 65 66 69 #endif.#if !defi
24d00 6e 65 64 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 ned(SQLITE_MUTEX
24d10 5f 4f 4d 49 54 29 20 26 26 20 21 64 65 66 69 6e _OMIT) && !defin
24d20 65 64 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f ed(SQLITE_MUTEX_
24d30 4e 4f 4f 50 29 0a 20 20 76 6f 69 64 20 73 71 6c NOOP). void sql
24d40 69 74 65 33 4d 65 6d 6f 72 79 42 61 72 72 69 65 ite3MemoryBarrie
24d50 72 28 76 6f 69 64 29 3b 0a 23 65 6c 73 65 0a 23 r(void);.#else.#
24d60 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4d define sqlite3M
24d70 65 6d 6f 72 79 42 61 72 72 69 65 72 28 29 0a 23 emoryBarrier().#
24d80 65 6e 64 69 66 0a 0a 73 71 6c 69 74 65 33 5f 69 endif..sqlite3_i
24d90 6e 74 36 34 20 73 71 6c 69 74 65 33 53 74 61 74 nt64 sqlite3Stat
24da0 75 73 56 61 6c 75 65 28 69 6e 74 29 3b 0a 76 6f usValue(int);.vo
24db0 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 id sqlite3Status
24dc0 55 70 28 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f Up(int, int);.vo
24dd0 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 75 73 id sqlite3Status
24de0 44 6f 77 6e 28 69 6e 74 2c 20 69 6e 74 29 3b 0a Down(int, int);.
24df0 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 void sqlite3Stat
24e00 75 73 48 69 67 68 77 61 74 65 72 28 69 6e 74 2c usHighwater(int,
24e10 20 69 6e 74 29 3b 0a 0a 2f 2a 20 41 63 63 65 73 int);../* Acces
24e20 73 20 74 6f 20 6d 75 74 65 78 65 73 20 75 73 65 s to mutexes use
24e30 64 20 62 79 20 73 71 6c 69 74 65 33 5f 73 74 61 d by sqlite3_sta
24e40 74 75 73 28 29 20 2a 2f 0a 73 71 6c 69 74 65 33 tus() */.sqlite3
24e50 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 50 _mutex *sqlite3P
24e60 63 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69 64 cache1Mutex(void
24e70 29 3b 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 );.sqlite3_mutex
24e80 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 4d *sqlite3MallocM
24e90 75 74 65 78 28 76 6f 69 64 29 3b 0a 0a 23 69 66 utex(void);..#if
24ea0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
24eb0 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a _FLOATING_POINT.
24ec0 20 20 69 6e 74 20 73 71 6c 69 74 65 33 49 73 4e int sqlite3IsN
24ed0 61 4e 28 64 6f 75 62 6c 65 29 3b 0a 23 65 6c 73 aN(double);.#els
24ee0 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 e.# define sqlit
24ef0 65 33 49 73 4e 61 4e 28 58 29 20 20 30 0a 23 65 e3IsNaN(X) 0.#e
24f00 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 ndif../*.** An i
24f10 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 nstance of the f
24f20 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
24f30 72 65 20 68 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 re holds informa
24f40 74 69 6f 6e 20 61 62 6f 75 74 20 53 51 4c 0a 2a tion about SQL.*
24f50 2a 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 67 75 * functions argu
24f60 6d 65 6e 74 73 20 74 68 61 74 20 61 72 65 20 74 ments that are t
24f70 68 65 20 70 61 72 61 6d 65 74 65 72 73 20 74 6f he parameters to
24f80 20 74 68 65 20 70 72 69 6e 74 66 28 29 20 66 75 the printf() fu
24f90 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 nction..*/.struc
24fa0 74 20 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 t PrintfArgument
24fb0 73 20 7b 0a 20 20 69 6e 74 20 6e 41 72 67 3b 20 s {. int nArg;
24fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
24fd0 2a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f * Total number o
24fe0 66 20 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 f arguments */.
24ff0 20 69 6e 74 20 6e 55 73 65 64 3b 20 20 20 20 20 int nUsed;
25000 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
25010 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 ber of arguments
25020 20 75 73 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a used so far */.
25030 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 sqlite3_value
25040 2a 2a 61 70 41 72 67 3b 20 20 20 2f 2a 20 54 68 **apArg; /* Th
25050 65 20 61 72 67 75 6d 65 6e 74 20 76 61 6c 75 65 e argument value
25060 73 20 2a 2f 0a 7d 3b 0a 0a 76 6f 69 64 20 73 71 s */.};..void sq
25070 6c 69 74 65 33 56 58 50 72 69 6e 74 66 28 53 74 lite3VXPrintf(St
25080 72 41 63 63 75 6d 2a 2c 20 63 6f 6e 73 74 20 63 rAccum*, const c
25090 68 61 72 2a 2c 20 76 61 5f 6c 69 73 74 29 3b 0a har*, va_list);.
250a0 76 6f 69 64 20 73 71 6c 69 74 65 33 58 50 72 69 void sqlite3XPri
250b0 6e 74 66 28 53 74 72 41 63 63 75 6d 2a 2c 20 63 ntf(StrAccum*, c
250c0 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 onst char*, ...)
250d0 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4d ;.char *sqlite3M
250e0 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c Printf(sqlite3*,
250f0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e const char*, ...
25100 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
25110 56 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 VMPrintf(sqlite3
25120 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 76 *,const char*, v
25130 61 5f 6c 69 73 74 29 3b 0a 23 69 66 20 64 65 66 a_list);.#if def
25140 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 ined(SQLITE_DEBU
25150 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 G) || defined(SQ
25160 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 41 LITE_HAVE_OS_TRA
25170 43 45 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 CE). void sqlit
25180 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 63 6f e3DebugPrintf(co
25190 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b nst char*, ...);
251a0 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 .#endif.#if defi
251b0 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 ned(SQLITE_TEST)
251c0 0a 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 . void *sqlite3
251d0 54 65 73 74 54 65 78 74 54 6f 50 74 72 28 63 6f TestTextToPtr(co
251e0 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 nst char*);.#end
251f0 69 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 if..#if defined(
25200 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 20 SQLITE_DEBUG).
25210 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 void sqlite3Tree
25220 56 69 65 77 45 78 70 72 28 54 72 65 65 56 69 65 ViewExpr(TreeVie
25230 77 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 2a 2c w*, const Expr*,
25240 20 75 38 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c u8);. void sql
25250 69 74 65 33 54 72 65 65 56 69 65 77 42 61 72 65 ite3TreeViewBare
25260 45 78 70 72 4c 69 73 74 28 54 72 65 65 56 69 65 ExprList(TreeVie
25270 77 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 4c 69 w*, const ExprLi
25280 73 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a st*, const char*
25290 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
252a0 33 54 72 65 65 56 69 65 77 45 78 70 72 4c 69 73 3TreeViewExprLis
252b0 74 28 54 72 65 65 56 69 65 77 2a 2c 20 63 6f 6e t(TreeView*, con
252c0 73 74 20 45 78 70 72 4c 69 73 74 2a 2c 20 75 38 st ExprList*, u8
252d0 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a , const char*);.
252e0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 void sqlite3Tr
252f0 65 65 56 69 65 77 53 65 6c 65 63 74 28 54 72 65 eeViewSelect(Tre
25300 65 56 69 65 77 2a 2c 20 63 6f 6e 73 74 20 53 65 eView*, const Se
25310 6c 65 63 74 2a 2c 20 75 38 29 3b 0a 20 20 76 6f lect*, u8);. vo
25320 69 64 20 73 71 6c 69 74 65 33 54 72 65 65 56 69 id sqlite3TreeVi
25330 65 77 57 69 74 68 28 54 72 65 65 56 69 65 77 2a ewWith(TreeView*
25340 2c 20 63 6f 6e 73 74 20 57 69 74 68 2a 2c 20 75 , const With*, u
25350 38 29 3b 0a 23 65 6e 64 69 66 0a 0a 0a 76 6f 69 8);.#endif...voi
25360 64 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 d sqlite3SetStri
25370 6e 67 28 63 68 61 72 20 2a 2a 2c 20 73 71 6c 69 ng(char **, sqli
25380 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 te3*, const char
25390 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
253a0 45 72 72 6f 72 4d 73 67 28 50 61 72 73 65 2a 2c ErrorMsg(Parse*,
253b0 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e const char*, ..
253c0 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .);.void sqlite3
253d0 44 65 71 75 6f 74 65 28 63 68 61 72 2a 29 3b 0a Dequote(char*);.
253e0 76 6f 69 64 20 73 71 6c 69 74 65 33 54 6f 6b 65 void sqlite3Toke
253f0 6e 49 6e 69 74 28 54 6f 6b 65 6e 2a 2c 63 68 61 nInit(Token*,cha
25400 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
25410 4b 65 79 77 6f 72 64 43 6f 64 65 28 63 6f 6e 73 KeywordCode(cons
25420 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a t unsigned char*
25430 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 , int);.int sqli
25440 74 65 33 52 75 6e 50 61 72 73 65 72 28 50 61 72 te3RunParser(Par
25450 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a se*, const char*
25460 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 76 6f 69 64 , char **);.void
25470 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 43 6f sqlite3FinishCo
25480 64 69 6e 67 28 50 61 72 73 65 2a 29 3b 0a 69 6e ding(Parse*);.in
25490 74 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d 70 t sqlite3GetTemp
254a0 52 65 67 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 Reg(Parse*);.voi
254b0 64 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 d sqlite3Release
254c0 54 65 6d 70 52 65 67 28 50 61 72 73 65 2a 2c 69 TempReg(Parse*,i
254d0 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
254e0 47 65 74 54 65 6d 70 52 61 6e 67 65 28 50 61 72 GetTempRange(Par
254f0 73 65 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 se*,int);.void s
25500 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 65 6d qlite3ReleaseTem
25510 70 52 61 6e 67 65 28 50 61 72 73 65 2a 2c 69 6e pRange(Parse*,in
25520 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c t,int);.void sql
25530 69 74 65 33 43 6c 65 61 72 54 65 6d 70 52 65 67 ite3ClearTempReg
25540 43 61 63 68 65 28 50 61 72 73 65 2a 29 3b 0a 23 Cache(Parse*);.#
25550 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
25560 55 47 0a 69 6e 74 20 73 71 6c 69 74 65 33 4e 6f UG.int sqlite3No
25570 54 65 6d 70 73 49 6e 52 61 6e 67 65 28 50 61 72 TempsInRange(Par
25580 73 65 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 23 65 se*,int,int);.#e
25590 6e 64 69 66 0a 45 78 70 72 20 2a 73 71 6c 69 74 ndif.Expr *sqlit
255a0 65 33 45 78 70 72 41 6c 6c 6f 63 28 73 71 6c 69 e3ExprAlloc(sqli
255b0 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 54 te3*,int,const T
255c0 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 45 78 70 72 oken*,int);.Expr
255d0 20 2a 73 71 6c 69 74 65 33 45 78 70 72 28 73 71 *sqlite3Expr(sq
255e0 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 lite3*,int,const
255f0 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 char*);.void sq
25600 6c 69 74 65 33 45 78 70 72 41 74 74 61 63 68 53 lite3ExprAttachS
25610 75 62 74 72 65 65 73 28 73 71 6c 69 74 65 33 2a ubtrees(sqlite3*
25620 2c 45 78 70 72 2a 2c 45 78 70 72 2a 2c 45 78 70 ,Expr*,Expr*,Exp
25630 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 r*);.Expr *sqlit
25640 65 33 50 45 78 70 72 28 50 61 72 73 65 2a 2c 20 e3PExpr(Parse*,
25650 69 6e 74 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 int, Expr*, Expr
25660 2a 2c 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 29 *, const Token*)
25670 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 45 ;.void sqlite3PE
25680 78 70 72 41 64 64 53 65 6c 65 63 74 28 50 61 72 xprAddSelect(Par
25690 73 65 2a 2c 20 45 78 70 72 2a 2c 20 53 65 6c 65 se*, Expr*, Sele
256a0 63 74 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 ct*);.Expr *sqli
256b0 74 65 33 45 78 70 72 41 6e 64 28 73 71 6c 69 74 te3ExprAnd(sqlit
256c0 65 33 2a 2c 45 78 70 72 2a 2c 20 45 78 70 72 2a e3*,Expr*, Expr*
256d0 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 );.Expr *sqlite3
256e0 45 78 70 72 46 75 6e 63 74 69 6f 6e 28 50 61 72 ExprFunction(Par
256f0 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 20 54 se*,ExprList*, T
25700 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c oken*);.void sql
25710 69 74 65 33 45 78 70 72 41 73 73 69 67 6e 56 61 ite3ExprAssignVa
25720 72 4e 75 6d 62 65 72 28 50 61 72 73 65 2a 2c 20 rNumber(Parse*,
25730 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c Expr*);.void sql
25740 69 74 65 33 45 78 70 72 44 65 6c 65 74 65 28 73 ite3ExprDelete(s
25750 71 6c 69 74 65 33 2a 2c 20 45 78 70 72 2a 29 3b qlite3*, Expr*);
25760 0a 45 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 .ExprList *sqlit
25770 65 33 45 78 70 72 4c 69 73 74 41 70 70 65 6e 64 e3ExprListAppend
25780 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 (Parse*,ExprList
25790 2a 2c 45 78 70 72 2a 29 3b 0a 45 78 70 72 4c 69 *,Expr*);.ExprLi
257a0 73 74 20 2a 73 71 6c 69 74 65 33 45 78 70 72 4c st *sqlite3ExprL
257b0 69 73 74 41 70 70 65 6e 64 56 65 63 74 6f 72 28 istAppendVector(
257c0 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a Parse*,ExprList*
257d0 2c 49 64 4c 69 73 74 2a 2c 45 78 70 72 2a 29 3b ,IdList*,Expr*);
257e0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
257f0 72 4c 69 73 74 53 65 74 53 6f 72 74 4f 72 64 65 rListSetSortOrde
25800 72 28 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 29 r(ExprList*,int)
25810 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
25820 70 72 4c 69 73 74 53 65 74 4e 61 6d 65 28 50 61 prListSetName(Pa
25830 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 54 rse*,ExprList*,T
25840 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 oken*,int);.void
25850 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 sqlite3ExprList
25860 53 65 74 53 70 61 6e 28 50 61 72 73 65 2a 2c 45 SetSpan(Parse*,E
25870 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 53 70 61 xprList*,ExprSpa
25880 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 n*);.void sqlite
25890 33 45 78 70 72 4c 69 73 74 44 65 6c 65 74 65 28 3ExprListDelete(
258a0 73 71 6c 69 74 65 33 2a 2c 20 45 78 70 72 4c 69 sqlite3*, ExprLi
258b0 73 74 2a 29 3b 0a 75 33 32 20 73 71 6c 69 74 65 st*);.u32 sqlite
258c0 33 45 78 70 72 4c 69 73 74 46 6c 61 67 73 28 63 3ExprListFlags(c
258d0 6f 6e 73 74 20 45 78 70 72 4c 69 73 74 2a 29 3b onst ExprList*);
258e0 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 69 74 .int sqlite3Init
258f0 28 73 71 6c 69 74 65 33 2a 2c 20 63 68 61 72 2a (sqlite3*, char*
25900 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 *);.int sqlite3I
25910 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 69 64 nitCallback(void
25920 2a 2c 20 69 6e 74 2c 20 63 68 61 72 2a 2a 2c 20 *, int, char**,
25930 63 68 61 72 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 char**);.void sq
25940 6c 69 74 65 33 50 72 61 67 6d 61 28 50 61 72 73 lite3Pragma(Pars
25950 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a e*,Token*,Token*
25960 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 76 6f ,Token*,int);.vo
25970 69 64 20 73 71 6c 69 74 65 33 52 65 73 65 74 41 id sqlite3ResetA
25980 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 llSchemasOfConne
25990 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a 29 3b ction(sqlite3*);
259a0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 .void sqlite3Res
259b0 65 74 4f 6e 65 53 63 68 65 6d 61 28 73 71 6c 69 etOneSchema(sqli
259c0 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 te3*,int);.void
259d0 73 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 65 44 sqlite3CollapseD
259e0 61 74 61 62 61 73 65 41 72 72 61 79 28 73 71 6c atabaseArray(sql
259f0 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c ite3*);.void sql
25a00 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e ite3CommitIntern
25a10 61 6c 43 68 61 6e 67 65 73 28 73 71 6c 69 74 65 alChanges(sqlite
25a20 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 3*);.void sqlite
25a30 33 44 65 6c 65 74 65 43 6f 6c 75 6d 6e 4e 61 6d 3DeleteColumnNam
25a40 65 73 28 73 71 6c 69 74 65 33 2a 2c 54 61 62 6c es(sqlite3*,Tabl
25a50 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 e*);.int sqlite3
25a60 43 6f 6c 75 6d 6e 73 46 72 6f 6d 45 78 70 72 4c ColumnsFromExprL
25a70 69 73 74 28 50 61 72 73 65 2a 2c 45 78 70 72 4c ist(Parse*,ExprL
25a80 69 73 74 2a 2c 69 31 36 2a 2c 43 6f 6c 75 6d 6e ist*,i16*,Column
25a90 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 **);.void sqlite
25aa0 33 53 65 6c 65 63 74 41 64 64 43 6f 6c 75 6d 6e 3SelectAddColumn
25ab0 54 79 70 65 41 6e 64 43 6f 6c 6c 61 74 69 6f 6e TypeAndCollation
25ac0 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 53 (Parse*,Table*,S
25ad0 65 6c 65 63 74 2a 29 3b 0a 54 61 62 6c 65 20 2a elect*);.Table *
25ae0 73 71 6c 69 74 65 33 52 65 73 75 6c 74 53 65 74 sqlite3ResultSet
25af0 4f 66 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c OfSelect(Parse*,
25b00 53 65 6c 65 63 74 2a 29 3b 0a 76 6f 69 64 20 73 Select*);.void s
25b10 71 6c 69 74 65 33 4f 70 65 6e 4d 61 73 74 65 72 qlite3OpenMaster
25b20 54 61 62 6c 65 28 50 61 72 73 65 20 2a 2c 20 69 Table(Parse *, i
25b30 6e 74 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 nt);.Index *sqli
25b40 74 65 33 50 72 69 6d 61 72 79 4b 65 79 49 6e 64 te3PrimaryKeyInd
25b50 65 78 28 54 61 62 6c 65 2a 29 3b 0a 69 31 36 20 ex(Table*);.i16
25b60 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 sqlite3ColumnOfI
25b70 6e 64 65 78 28 49 6e 64 65 78 2a 2c 20 69 31 36 ndex(Index*, i16
25b80 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
25b90 74 61 72 74 54 61 62 6c 65 28 50 61 72 73 65 2a tartTable(Parse*
25ba0 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 ,Token*,Token*,i
25bb0 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b nt,int,int,int);
25bc0 0a 23 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 .#if SQLITE_ENAB
25bd0 4c 45 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e LE_HIDDEN_COLUMN
25be0 53 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 S. void sqlite3
25bf0 43 6f 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 ColumnProperties
25c00 46 72 6f 6d 4e 61 6d 65 28 54 61 62 6c 65 2a 2c FromName(Table*,
25c10 20 43 6f 6c 75 6d 6e 2a 29 3b 0a 23 65 6c 73 65 Column*);.#else
25c20 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
25c30 33 43 6f 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 3ColumnPropertie
25c40 73 46 72 6f 6d 4e 61 6d 65 28 54 2c 43 29 20 2f sFromName(T,C) /
25c50 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 65 6e 64 69 * no-op */.#endi
25c60 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 f.void sqlite3Ad
25c70 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 54 dColumn(Parse*,T
25c80 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 76 oken*,Token*);.v
25c90 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 4e 6f oid sqlite3AddNo
25ca0 74 4e 75 6c 6c 28 50 61 72 73 65 2a 2c 20 69 6e tNull(Parse*, in
25cb0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
25cc0 41 64 64 50 72 69 6d 61 72 79 4b 65 79 28 50 61 AddPrimaryKey(Pa
25cd0 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c rse*, ExprList*,
25ce0 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
25cf0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 .void sqlite3Add
25d00 43 68 65 63 6b 43 6f 6e 73 74 72 61 69 6e 74 28 CheckConstraint(
25d10 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a Parse*, Expr*);.
25d20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 44 void sqlite3AddD
25d30 65 66 61 75 6c 74 56 61 6c 75 65 28 50 61 72 73 efaultValue(Pars
25d40 65 2a 2c 45 78 70 72 53 70 61 6e 2a 29 3b 0a 76 e*,ExprSpan*);.v
25d50 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 43 6f oid sqlite3AddCo
25d60 6c 6c 61 74 65 54 79 70 65 28 50 61 72 73 65 2a llateType(Parse*
25d70 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 , Token*);.void
25d80 73 71 6c 69 74 65 33 45 6e 64 54 61 62 6c 65 28 sqlite3EndTable(
25d90 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f Parse*,Token*,To
25da0 6b 65 6e 2a 2c 75 38 2c 53 65 6c 65 63 74 2a 29 ken*,u8,Select*)
25db0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 72 ;.int sqlite3Par
25dc0 73 65 55 72 69 28 63 6f 6e 73 74 20 63 68 61 72 seUri(const char
25dd0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e *,const char*,un
25de0 73 69 67 6e 65 64 20 69 6e 74 2a 2c 0a 20 20 20 signed int*,.
25df0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25e00 20 73 71 6c 69 74 65 33 5f 76 66 73 2a 2a 2c 63 sqlite3_vfs**,c
25e10 68 61 72 2a 2a 2c 63 68 61 72 20 2a 2a 29 3b 0a har**,char **);.
25e20 42 74 72 65 65 20 2a 73 71 6c 69 74 65 33 44 62 Btree *sqlite3Db
25e30 4e 61 6d 65 54 6f 42 74 72 65 65 28 73 71 6c 69 NameToBtree(sqli
25e40 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
25e50 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f );.int sqlite3Co
25e60 64 65 4f 6e 63 65 28 50 61 72 73 65 20 2a 29 3b deOnce(Parse *);
25e70 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
25e80 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 OMIT_BUILTIN_TES
25e90 54 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 T.# define sqlit
25ea0 65 33 46 61 75 6c 74 53 69 6d 28 58 29 20 53 51 e3FaultSim(X) SQ
25eb0 4c 49 54 45 5f 4f 4b 0a 23 65 6c 73 65 0a 20 20 LITE_OK.#else.
25ec0 69 6e 74 20 73 71 6c 69 74 65 33 46 61 75 6c 74 int sqlite3Fault
25ed0 53 69 6d 28 69 6e 74 29 3b 0a 23 65 6e 64 69 66 Sim(int);.#endif
25ee0 0a 0a 42 69 74 76 65 63 20 2a 73 71 6c 69 74 65 ..Bitvec *sqlite
25ef0 33 42 69 74 76 65 63 43 72 65 61 74 65 28 75 33 3BitvecCreate(u3
25f00 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 2);.int sqlite3B
25f10 69 74 76 65 63 54 65 73 74 28 42 69 74 76 65 63 itvecTest(Bitvec
25f20 2a 2c 20 75 33 32 29 3b 0a 69 6e 74 20 73 71 6c *, u32);.int sql
25f30 69 74 65 33 42 69 74 76 65 63 54 65 73 74 4e 6f ite3BitvecTestNo
25f40 74 4e 75 6c 6c 28 42 69 74 76 65 63 2a 2c 20 75 tNull(Bitvec*, u
25f50 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 32);.int sqlite3
25f60 42 69 74 76 65 63 53 65 74 28 42 69 74 76 65 63 BitvecSet(Bitvec
25f70 2a 2c 20 75 33 32 29 3b 0a 76 6f 69 64 20 73 71 *, u32);.void sq
25f80 6c 69 74 65 33 42 69 74 76 65 63 43 6c 65 61 72 lite3BitvecClear
25f90 28 42 69 74 76 65 63 2a 2c 20 75 33 32 2c 20 76 (Bitvec*, u32, v
25fa0 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 oid*);.void sqli
25fb0 74 65 33 42 69 74 76 65 63 44 65 73 74 72 6f 79 te3BitvecDestroy
25fc0 28 42 69 74 76 65 63 2a 29 3b 0a 75 33 32 20 73 (Bitvec*);.u32 s
25fd0 71 6c 69 74 65 33 42 69 74 76 65 63 53 69 7a 65 qlite3BitvecSize
25fe0 28 42 69 74 76 65 63 2a 29 3b 0a 23 69 66 6e 64 (Bitvec*);.#ifnd
25ff0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 ef SQLITE_OMIT_B
26000 55 49 4c 54 49 4e 5f 54 45 53 54 0a 69 6e 74 20 UILTIN_TEST.int
26010 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 69 sqlite3BitvecBui
26020 6c 74 69 6e 54 65 73 74 28 69 6e 74 2c 69 6e 74 ltinTest(int,int
26030 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 52 6f 77 53 *);.#endif..RowS
26040 65 74 20 2a 73 71 6c 69 74 65 33 52 6f 77 53 65 et *sqlite3RowSe
26050 74 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 2c 20 tInit(sqlite3*,
26060 76 6f 69 64 2a 2c 20 75 6e 73 69 67 6e 65 64 20 void*, unsigned
26070 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
26080 65 33 52 6f 77 53 65 74 43 6c 65 61 72 28 52 6f e3RowSetClear(Ro
26090 77 53 65 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c wSet*);.void sql
260a0 69 74 65 33 52 6f 77 53 65 74 49 6e 73 65 72 74 ite3RowSetInsert
260b0 28 52 6f 77 53 65 74 2a 2c 20 69 36 34 29 3b 0a (RowSet*, i64);.
260c0 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 53 65 int sqlite3RowSe
260d0 74 54 65 73 74 28 52 6f 77 53 65 74 2a 2c 20 69 tTest(RowSet*, i
260e0 6e 74 20 69 42 61 74 63 68 2c 20 69 36 34 29 3b nt iBatch, i64);
260f0 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 53 .int sqlite3RowS
26100 65 74 4e 65 78 74 28 52 6f 77 53 65 74 2a 2c 20 etNext(RowSet*,
26110 69 36 34 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c i64*);..void sql
26120 69 74 65 33 43 72 65 61 74 65 56 69 65 77 28 50 ite3CreateView(P
26130 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b arse*,Token*,Tok
26140 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 45 78 70 72 4c en*,Token*,ExprL
26150 69 73 74 2a 2c 53 65 6c 65 63 74 2a 2c 69 6e 74 ist*,Select*,int
26160 2c 69 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 ,int);..#if !def
26170 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
26180 5f 56 49 45 57 29 20 7c 7c 20 21 64 65 66 69 6e _VIEW) || !defin
26190 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ed(SQLITE_OMIT_V
261a0 49 52 54 55 41 4c 54 41 42 4c 45 29 0a 20 20 69 IRTUALTABLE). i
261b0 6e 74 20 73 71 6c 69 74 65 33 56 69 65 77 47 65 nt sqlite3ViewGe
261c0 74 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 50 61 72 tColumnNames(Par
261d0 73 65 2a 2c 54 61 62 6c 65 2a 29 3b 0a 23 65 6c se*,Table*);.#el
261e0 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 se.# define sqli
261f0 74 65 33 56 69 65 77 47 65 74 43 6f 6c 75 6d 6e te3ViewGetColumn
26200 4e 61 6d 65 73 28 41 2c 42 29 20 30 0a 23 65 6e Names(A,B) 0.#en
26210 64 69 66 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f dif..#if SQLITE_
26220 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 33 30 0a MAX_ATTACHED>30.
26230 20 20 69 6e 74 20 73 71 6c 69 74 65 33 44 62 4d int sqlite3DbM
26240 61 73 6b 41 6c 6c 5a 65 72 6f 28 79 44 62 4d 61 askAllZero(yDbMa
26250 73 6b 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 64 sk);.#endif.void
26260 20 73 71 6c 69 74 65 33 44 72 6f 70 54 61 62 6c sqlite3DropTabl
26270 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 e(Parse*, SrcLis
26280 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 t*, int, int);.v
26290 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 44 oid sqlite3CodeD
262a0 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a 2c ropTable(Parse*,
262b0 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e Table*, int, in
262c0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
262d0 44 65 6c 65 74 65 54 61 62 6c 65 28 73 71 6c 69 DeleteTable(sqli
262e0 74 65 33 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 23 te3*, Table*);.#
262f0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
26300 49 54 5f 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 IT_AUTOINCREMENT
26310 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 . void sqlite3A
26320 75 74 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 69 utoincrementBegi
26330 6e 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 29 n(Parse *pParse)
26340 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
26350 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 64 AutoincrementEnd
26360 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 29 3b (Parse *pParse);
26370 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
26380 73 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 sqlite3Autoincre
26390 6d 65 6e 74 42 65 67 69 6e 28 58 29 0a 23 20 64 mentBegin(X).# d
263a0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 efine sqlite3Aut
263b0 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 64 28 58 29 oincrementEnd(X)
263c0 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c .#endif.void sql
263d0 69 74 65 33 49 6e 73 65 72 74 28 50 61 72 73 65 ite3Insert(Parse
263e0 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 53 65 6c *, SrcList*, Sel
263f0 65 63 74 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 69 ect*, IdList*, i
26400 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 nt);.void *sqlit
26410 65 33 41 72 72 61 79 41 6c 6c 6f 63 61 74 65 28 e3ArrayAllocate(
26420 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69 sqlite3*,void*,i
26430 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a 49 nt,int*,int*);.I
26440 64 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 64 dList *sqlite3Id
26450 4c 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 74 ListAppend(sqlit
26460 65 33 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 54 6f e3*, IdList*, To
26470 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ken*);.int sqlit
26480 65 33 49 64 4c 69 73 74 49 6e 64 65 78 28 49 64 e3IdListIndex(Id
26490 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 List*,const char
264a0 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c *);.SrcList *sql
264b0 69 74 65 33 53 72 63 4c 69 73 74 45 6e 6c 61 72 ite3SrcListEnlar
264c0 67 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 ge(sqlite3*, Src
264d0 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 List*, int, int)
264e0 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 ;.SrcList *sqlit
264f0 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e 64 28 e3SrcListAppend(
26500 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 sqlite3*, SrcLis
26510 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 t*, Token*, Toke
26520 6e 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 n*);.SrcList *sq
26530 6c 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 lite3SrcListAppe
26540 6e 64 46 72 6f 6d 54 65 72 6d 28 50 61 72 73 65 ndFromTerm(Parse
26550 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b *, SrcList*, Tok
26560 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 0a 20 20 20 en*, Token*,.
26570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26590 20 20 20 54 6f 6b 65 6e 2a 2c 20 53 65 6c 65 63 Token*, Selec
265a0 74 2a 2c 20 45 78 70 72 2a 2c 20 49 64 4c 69 73 t*, Expr*, IdLis
265b0 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
265c0 33 53 72 63 4c 69 73 74 49 6e 64 65 78 65 64 42 3SrcListIndexedB
265d0 79 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c 69 y(Parse *, SrcLi
265e0 73 74 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b 0a st *, Token *);.
265f0 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c void sqlite3SrcL
26600 69 73 74 46 75 6e 63 41 72 67 73 28 50 61 72 73 istFuncArgs(Pars
26610 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 e*, SrcList*, Ex
26620 70 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 prList*);.int sq
26630 6c 69 74 65 33 49 6e 64 65 78 65 64 42 79 4c 6f lite3IndexedByLo
26640 6f 6b 75 70 28 50 61 72 73 65 20 2a 2c 20 73 74 okup(Parse *, st
26650 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 ruct SrcList_ite
26660 6d 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 m *);.void sqlit
26670 65 33 53 72 63 4c 69 73 74 53 68 69 66 74 4a 6f e3SrcListShiftJo
26680 69 6e 54 79 70 65 28 53 72 63 4c 69 73 74 2a 29 inType(SrcList*)
26690 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 ;.void sqlite3Sr
266a0 63 4c 69 73 74 41 73 73 69 67 6e 43 75 72 73 6f cListAssignCurso
266b0 72 73 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 rs(Parse*, SrcLi
266c0 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 st*);.void sqlit
266d0 65 33 49 64 4c 69 73 74 44 65 6c 65 74 65 28 73 e3IdListDelete(s
266e0 71 6c 69 74 65 33 2a 2c 20 49 64 4c 69 73 74 2a qlite3*, IdList*
266f0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
26700 72 63 4c 69 73 74 44 65 6c 65 74 65 28 73 71 6c rcListDelete(sql
26710 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 74 2a 29 ite3*, SrcList*)
26720 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 ;.Index *sqlite3
26730 41 6c 6c 6f 63 61 74 65 49 6e 64 65 78 4f 62 6a AllocateIndexObj
26740 65 63 74 28 73 71 6c 69 74 65 33 2a 2c 69 31 36 ect(sqlite3*,i16
26750 2c 69 6e 74 2c 63 68 61 72 2a 2a 29 3b 0a 76 6f ,int,char**);.vo
26760 69 64 20 73 71 6c 69 74 65 33 43 72 65 61 74 65 id sqlite3Create
26770 49 6e 64 65 78 28 50 61 72 73 65 2a 2c 54 6f 6b Index(Parse*,Tok
26780 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 53 72 63 4c 69 en*,Token*,SrcLi
26790 73 74 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e st*,ExprList*,in
267a0 74 2c 54 6f 6b 65 6e 2a 2c 0a 20 20 20 20 20 20 t,Token*,.
267b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
267c0 20 20 20 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 Expr*, int,
267d0 69 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 int, u8);.void s
267e0 71 6c 69 74 65 33 44 72 6f 70 49 6e 64 65 78 28 qlite3DropIndex(
267f0 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
26800 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 , int);.int sqli
26810 74 65 33 53 65 6c 65 63 74 28 50 61 72 73 65 2a te3Select(Parse*
26820 2c 20 53 65 6c 65 63 74 2a 2c 20 53 65 6c 65 63 , Select*, Selec
26830 74 44 65 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 tDest*);.Select
26840 2a 73 71 6c 69 74 65 33 53 65 6c 65 63 74 4e 65 *sqlite3SelectNe
26850 77 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 w(Parse*,ExprLis
26860 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 t*,SrcList*,Expr
26870 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 0a 20 20 20 *,ExprList*,.
26880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26890 20 20 20 20 20 20 45 78 70 72 2a 2c 45 78 70 72 Expr*,Expr
268a0 4c 69 73 74 2a 2c 75 33 32 2c 45 78 70 72 2a 2c List*,u32,Expr*,
268b0 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c Expr*);.void sql
268c0 69 74 65 33 53 65 6c 65 63 74 44 65 6c 65 74 65 ite3SelectDelete
268d0 28 73 71 6c 69 74 65 33 2a 2c 20 53 65 6c 65 63 (sqlite3*, Selec
268e0 74 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 t*);.Table *sqli
268f0 74 65 33 53 72 63 4c 69 73 74 4c 6f 6f 6b 75 70 te3SrcListLookup
26900 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 (Parse*, SrcList
26910 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 *);.int sqlite3I
26920 73 52 65 61 64 4f 6e 6c 79 28 50 61 72 73 65 2a sReadOnly(Parse*
26930 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 29 3b 0a , Table*, int);.
26940 76 6f 69 64 20 73 71 6c 69 74 65 33 4f 70 65 6e void sqlite3Open
26950 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 69 6e Table(Parse*, in
26960 74 20 69 43 75 72 2c 20 69 6e 74 20 69 44 62 2c t iCur, int iDb,
26970 20 54 61 62 6c 65 2a 2c 20 69 6e 74 29 3b 0a 23 Table*, int);.#
26980 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
26990 45 5f 45 4e 41 42 4c 45 5f 55 50 44 41 54 45 5f E_ENABLE_UPDATE_
269a0 44 45 4c 45 54 45 5f 4c 49 4d 49 54 29 20 26 26 DELETE_LIMIT) &&
269b0 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
269c0 5f 4f 4d 49 54 5f 53 55 42 51 55 45 52 59 29 0a _OMIT_SUBQUERY).
269d0 45 78 70 72 20 2a 73 71 6c 69 74 65 33 4c 69 6d Expr *sqlite3Lim
269e0 69 74 57 68 65 72 65 28 50 61 72 73 65 2a 2c 53 itWhere(Parse*,S
269f0 72 63 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 rcList*,Expr*,Ex
26a00 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 prList*,Expr*,Ex
26a10 70 72 2a 2c 63 68 61 72 2a 29 3b 0a 23 65 6e 64 pr*,char*);.#end
26a20 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 if.void sqlite3D
26a30 65 6c 65 74 65 46 72 6f 6d 28 50 61 72 73 65 2a eleteFrom(Parse*
26a40 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 70 72 , SrcList*, Expr
26a50 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
26a60 55 70 64 61 74 65 28 50 61 72 73 65 2a 2c 20 53 Update(Parse*, S
26a70 72 63 4c 69 73 74 2a 2c 20 45 78 70 72 4c 69 73 rcList*, ExprLis
26a80 74 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b t*, Expr*, int);
26a90 0a 57 68 65 72 65 49 6e 66 6f 20 2a 73 71 6c 69 .WhereInfo *sqli
26aa0 74 65 33 57 68 65 72 65 42 65 67 69 6e 28 50 61 te3WhereBegin(Pa
26ab0 72 73 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 rse*,SrcList*,Ex
26ac0 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 pr*,ExprList*,Ex
26ad0 70 72 4c 69 73 74 2a 2c 75 31 36 2c 69 6e 74 29 prList*,u16,int)
26ae0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 57 68 ;.void sqlite3Wh
26af0 65 72 65 45 6e 64 28 57 68 65 72 65 49 6e 66 6f ereEnd(WhereInfo
26b00 2a 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 *);.LogEst sqlit
26b10 65 33 57 68 65 72 65 4f 75 74 70 75 74 52 6f 77 e3WhereOutputRow
26b20 43 6f 75 6e 74 28 57 68 65 72 65 49 6e 66 6f 2a Count(WhereInfo*
26b30 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 );.int sqlite3Wh
26b40 65 72 65 49 73 44 69 73 74 69 6e 63 74 28 57 68 ereIsDistinct(Wh
26b50 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 ereInfo*);.int s
26b60 71 6c 69 74 65 33 57 68 65 72 65 49 73 4f 72 64 qlite3WhereIsOrd
26b70 65 72 65 64 28 57 68 65 72 65 49 6e 66 6f 2a 29 ered(WhereInfo*)
26b80 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 ;.int sqlite3Whe
26b90 72 65 4f 72 64 65 72 65 64 49 6e 6e 65 72 4c 6f reOrderedInnerLo
26ba0 6f 70 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a op(WhereInfo*);.
26bb0 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 int sqlite3Where
26bc0 49 73 53 6f 72 74 65 64 28 57 68 65 72 65 49 6e IsSorted(WhereIn
26bd0 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 fo*);.int sqlite
26be0 33 57 68 65 72 65 43 6f 6e 74 69 6e 75 65 4c 61 3WhereContinueLa
26bf0 62 65 6c 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b bel(WhereInfo*);
26c00 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 .int sqlite3Wher
26c10 65 42 72 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 eBreakLabel(Wher
26c20 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c eInfo*);.int sql
26c30 69 74 65 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 ite3WhereOkOnePa
26c40 73 73 28 57 68 65 72 65 49 6e 66 6f 2a 2c 20 69 ss(WhereInfo*, i
26c50 6e 74 2a 29 3b 0a 23 64 65 66 69 6e 65 20 4f 4e nt*);.#define ON
26c60 45 50 41 53 53 5f 4f 46 46 20 20 20 20 20 20 30 EPASS_OFF 0
26c70 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 20 6f /* Use o
26c80 66 20 4f 4e 45 50 41 53 53 20 6e 6f 74 20 61 6c f ONEPASS not al
26c90 6c 6f 77 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 lowed */.#define
26ca0 20 4f 4e 45 50 41 53 53 5f 53 49 4e 47 4c 45 20 ONEPASS_SINGLE
26cb0 20 20 31 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 1 /* ON
26cc0 45 50 41 53 53 20 76 61 6c 69 64 20 66 6f 72 20 EPASS valid for
26cd0 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 75 70 64 a single row upd
26ce0 61 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ate */.#define O
26cf0 4e 45 50 41 53 53 5f 4d 55 4c 54 49 20 20 20 20 NEPASS_MULTI
26d00 32 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 50 2 /* ONEP
26d10 41 53 53 20 69 73 20 76 61 6c 69 64 20 66 6f 72 ASS is valid for
26d20 20 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a multiple rows *
26d30 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 /.void sqlite3Ex
26d40 70 72 43 6f 64 65 4c 6f 61 64 49 6e 64 65 78 43 prCodeLoadIndexC
26d50 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 20 49 6e olumn(Parse*, In
26d60 64 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 dex*, int, int,
26d70 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
26d80 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 3ExprCodeGetColu
26d90 6d 6e 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 mn(Parse*, Table
26da0 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 *, int, int, int
26db0 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 , u8);.void sqli
26dc0 74 65 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f te3ExprCodeGetCo
26dd0 6c 75 6d 6e 54 6f 52 65 67 28 50 61 72 73 65 2a lumnToReg(Parse*
26de0 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 , Table*, int, i
26df0 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
26e00 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 qlite3ExprCodeGe
26e10 74 43 6f 6c 75 6d 6e 4f 66 54 61 62 6c 65 28 56 tColumnOfTable(V
26e20 64 62 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e dbe*, Table*, in
26e30 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f t, int, int);.vo
26e40 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f id sqlite3ExprCo
26e50 64 65 4d 6f 76 65 28 50 61 72 73 65 2a 2c 20 69 deMove(Parse*, i
26e60 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 nt, int, int);.v
26e70 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
26e80 61 63 68 65 53 74 6f 72 65 28 50 61 72 73 65 2a acheStore(Parse*
26e90 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 , int, int, int)
26ea0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
26eb0 70 72 43 61 63 68 65 50 75 73 68 28 50 61 72 73 prCachePush(Pars
26ec0 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
26ed0 33 45 78 70 72 43 61 63 68 65 50 6f 70 28 50 61 3ExprCachePop(Pa
26ee0 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 rse*);.void sqli
26ef0 74 65 33 45 78 70 72 43 61 63 68 65 52 65 6d 6f te3ExprCacheRemo
26f00 76 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 ve(Parse*, int,
26f10 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
26f20 65 33 45 78 70 72 43 61 63 68 65 43 6c 65 61 72 e3ExprCacheClear
26f30 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 (Parse*);.void s
26f40 71 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 41 qlite3ExprCacheA
26f50 66 66 69 6e 69 74 79 43 68 61 6e 67 65 28 50 61 ffinityChange(Pa
26f60 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b rse*, int, int);
26f70 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
26f80 72 43 6f 64 65 28 50 61 72 73 65 2a 2c 20 45 78 rCode(Parse*, Ex
26f90 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 pr*, int);.void
26fa0 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 43 sqlite3ExprCodeC
26fb0 6f 70 79 28 50 61 72 73 65 2a 2c 20 45 78 70 72 opy(Parse*, Expr
26fc0 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
26fd0 6c 69 74 65 33 45 78 70 72 43 6f 64 65 46 61 63 lite3ExprCodeFac
26fe0 74 6f 72 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 torable(Parse*,
26ff0 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 Expr*, int);.voi
27000 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 d sqlite3ExprCod
27010 65 41 74 49 6e 69 74 28 50 61 72 73 65 2a 2c 20 eAtInit(Parse*,
27020 45 78 70 72 2a 2c 20 69 6e 74 2c 20 75 38 29 3b Expr*, int, u8);
27030 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
27040 43 6f 64 65 54 65 6d 70 28 50 61 72 73 65 2a 2c CodeTemp(Parse*,
27050 20 45 78 70 72 2a 2c 20 69 6e 74 2a 29 3b 0a 69 Expr*, int*);.i
27060 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f nt sqlite3ExprCo
27070 64 65 54 61 72 67 65 74 28 50 61 72 73 65 2a 2c deTarget(Parse*,
27080 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f Expr*, int);.vo
27090 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f id sqlite3ExprCo
270a0 64 65 41 6e 64 43 61 63 68 65 28 50 61 72 73 65 deAndCache(Parse
270b0 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a *, Expr*, int);.
270c0 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 int sqlite3ExprC
270d0 6f 64 65 45 78 70 72 4c 69 73 74 28 50 61 72 73 odeExprList(Pars
270e0 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 e*, ExprList*, i
270f0 6e 74 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 23 64 nt, int, u8);.#d
27100 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 efine SQLITE_ECE
27110 4c 5f 44 55 50 20 20 20 20 20 20 30 78 30 31 20 L_DUP 0x01
27120 20 2f 2a 20 44 65 65 70 2c 20 6e 6f 74 20 73 68 /* Deep, not sh
27130 61 6c 6c 6f 77 20 63 6f 70 69 65 73 20 2a 2f 0a allow copies */.
27140 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 #define SQLITE_E
27150 43 45 4c 5f 46 41 43 54 4f 52 20 20 20 30 78 30 CEL_FACTOR 0x0
27160 32 20 20 2f 2a 20 46 61 63 74 6f 72 20 6f 75 74 2 /* Factor out
27170 20 63 6f 6e 73 74 61 6e 74 20 74 65 72 6d 73 20 constant terms
27180 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
27190 45 5f 45 43 45 4c 5f 52 45 46 20 20 20 20 20 20 E_ECEL_REF
271a0 30 78 30 34 20 20 2f 2a 20 55 73 65 20 45 78 70 0x04 /* Use Exp
271b0 72 4c 69 73 74 2e 75 2e 78 2e 69 4f 72 64 65 72 rList.u.x.iOrder
271c0 42 79 43 6f 6c 20 2a 2f 0a 76 6f 69 64 20 73 71 ByCol */.void sq
271d0 6c 69 74 65 33 45 78 70 72 49 66 54 72 75 65 28 lite3ExprIfTrue(
271e0 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 Parse*, Expr*, i
271f0 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
27200 71 6c 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 qlite3ExprIfFals
27210 65 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c e(Parse*, Expr*,
27220 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 int, int);.void
27230 20 73 71 6c 69 74 65 33 45 78 70 72 49 66 46 61 sqlite3ExprIfFa
27240 6c 73 65 44 75 70 28 50 61 72 73 65 2a 2c 20 45 lseDup(Parse*, E
27250 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b xpr*, int, int);
27260 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 46 .Table *sqlite3F
27270 69 6e 64 54 61 62 6c 65 28 73 71 6c 69 74 65 33 indTable(sqlite3
27280 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 *,const char*, c
27290 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 64 65 onst char*);.#de
272a0 66 69 6e 65 20 4c 4f 43 41 54 45 5f 56 49 45 57 fine LOCATE_VIEW
272b0 20 20 20 20 30 78 30 31 0a 23 64 65 66 69 6e 65 0x01.#define
272c0 20 4c 4f 43 41 54 45 5f 4e 4f 45 52 52 20 20 20 LOCATE_NOERR
272d0 30 78 30 32 0a 54 61 62 6c 65 20 2a 73 71 6c 69 0x02.Table *sqli
272e0 74 65 33 4c 6f 63 61 74 65 54 61 62 6c 65 28 50 te3LocateTable(P
272f0 61 72 73 65 2a 2c 75 33 32 20 66 6c 61 67 73 2c arse*,u32 flags,
27300 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
27310 73 74 20 63 68 61 72 2a 29 3b 0a 54 61 62 6c 65 st char*);.Table
27320 20 2a 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 *sqlite3LocateT
27330 61 62 6c 65 49 74 65 6d 28 50 61 72 73 65 2a 2c ableItem(Parse*,
27340 75 33 32 20 66 6c 61 67 73 2c 73 74 72 75 63 74 u32 flags,struct
27350 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 29 SrcList_item *)
27360 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 ;.Index *sqlite3
27370 46 69 6e 64 49 6e 64 65 78 28 73 71 6c 69 74 65 FindIndex(sqlite
27380 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 3*,const char*,
27390 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f const char*);.vo
273a0 69 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b id sqlite3Unlink
273b0 41 6e 64 44 65 6c 65 74 65 54 61 62 6c 65 28 73 AndDeleteTable(s
273c0 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 qlite3*,int,cons
273d0 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 t char*);.void s
273e0 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 qlite3UnlinkAndD
273f0 65 6c 65 74 65 49 6e 64 65 78 28 73 71 6c 69 74 eleteIndex(sqlit
27400 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 e3*,int,const ch
27410 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ar*);.void sqlit
27420 65 33 56 61 63 75 75 6d 28 50 61 72 73 65 2a 2c e3Vacuum(Parse*,
27430 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c Token*);.int sql
27440 69 74 65 33 52 75 6e 56 61 63 75 75 6d 28 63 68 ite3RunVacuum(ch
27450 61 72 2a 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 ar**, sqlite3*,
27460 69 6e 74 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 int);.char *sqli
27470 74 65 33 4e 61 6d 65 46 72 6f 6d 54 6f 6b 65 6e te3NameFromToken
27480 28 73 71 6c 69 74 65 33 2a 2c 20 54 6f 6b 65 6e (sqlite3*, Token
27490 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 *);.int sqlite3E
274a0 78 70 72 43 6f 6d 70 61 72 65 28 45 78 70 72 2a xprCompare(Expr*
274b0 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 , Expr*, int);.i
274c0 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 nt sqlite3ExprLi
274d0 73 74 43 6f 6d 70 61 72 65 28 45 78 70 72 4c 69 stCompare(ExprLi
274e0 73 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 st*, ExprList*,
274f0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
27500 33 45 78 70 72 49 6d 70 6c 69 65 73 45 78 70 72 3ExprImpliesExpr
27510 28 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 69 (Expr*, Expr*, i
27520 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
27530 33 45 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 72 3ExprAnalyzeAggr
27540 65 67 61 74 65 73 28 4e 61 6d 65 43 6f 6e 74 65 egates(NameConte
27550 78 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 xt*, Expr*);.voi
27560 64 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 61 d sqlite3ExprAna
27570 6c 79 7a 65 41 67 67 4c 69 73 74 28 4e 61 6d 65 lyzeAggList(Name
27580 43 6f 6e 74 65 78 74 2a 2c 45 78 70 72 4c 69 73 Context*,ExprLis
27590 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
275a0 45 78 70 72 43 6f 76 65 72 65 64 42 79 49 6e 64 ExprCoveredByInd
275b0 65 78 28 45 78 70 72 2a 2c 20 69 6e 74 20 69 43 ex(Expr*, int iC
275c0 75 72 2c 20 49 6e 64 65 78 20 2a 70 49 64 78 29 ur, Index *pIdx)
275d0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 75 6e ;.int sqlite3Fun
275e0 63 74 69 6f 6e 55 73 65 73 54 68 69 73 53 72 63 ctionUsesThisSrc
275f0 28 45 78 70 72 2a 2c 20 53 72 63 4c 69 73 74 2a (Expr*, SrcList*
27600 29 3b 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33 );.Vdbe *sqlite3
27610 47 65 74 56 64 62 65 28 50 61 72 73 65 2a 29 3b GetVdbe(Parse*);
27620 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
27630 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 OMIT_BUILTIN_TES
27640 54 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 72 T.void sqlite3Pr
27650 6e 67 53 61 76 65 53 74 61 74 65 28 76 6f 69 64 ngSaveState(void
27660 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 );.void sqlite3P
27670 72 6e 67 52 65 73 74 6f 72 65 53 74 61 74 65 28 rngRestoreState(
27680 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 76 6f void);.#endif.vo
27690 69 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 id sqlite3Rollba
276a0 63 6b 41 6c 6c 28 73 71 6c 69 74 65 33 2a 2c 69 ckAll(sqlite3*,i
276b0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
276c0 33 43 6f 64 65 56 65 72 69 66 79 53 63 68 65 6d 3CodeVerifySchem
276d0 61 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a a(Parse*, int);.
276e0 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 void sqlite3Code
276f0 56 65 72 69 66 79 4e 61 6d 65 64 53 63 68 65 6d VerifyNamedSchem
27700 61 28 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 a(Parse*, const
27710 63 68 61 72 20 2a 7a 44 62 29 3b 0a 76 6f 69 64 char *zDb);.void
27720 20 73 71 6c 69 74 65 33 42 65 67 69 6e 54 72 61 sqlite3BeginTra
27730 6e 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a 2c nsaction(Parse*,
27740 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
27750 74 65 33 43 6f 6d 6d 69 74 54 72 61 6e 73 61 63 te3CommitTransac
27760 74 69 6f 6e 28 50 61 72 73 65 2a 29 3b 0a 76 6f tion(Parse*);.vo
27770 69 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 id sqlite3Rollba
27780 63 6b 54 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 ckTransaction(Pa
27790 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 rse*);.void sqli
277a0 74 65 33 53 61 76 65 70 6f 69 6e 74 28 50 61 72 te3Savepoint(Par
277b0 73 65 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2a se*, int, Token*
277c0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 );.void sqlite3C
277d0 6c 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 loseSavepoints(s
277e0 71 6c 69 74 65 33 20 2a 29 3b 0a 76 6f 69 64 20 qlite3 *);.void
277f0 73 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65 sqlite3LeaveMute
27800 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28 xAndCloseZombie(
27810 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 sqlite3*);.int s
27820 71 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 qlite3ExprIsCons
27830 74 61 6e 74 28 45 78 70 72 2a 29 3b 0a 69 6e 74 tant(Expr*);.int
27840 20 73 71 6c 69 74 65 33 45 78 70 72 49 73 43 6f sqlite3ExprIsCo
27850 6e 73 74 61 6e 74 4e 6f 74 4a 6f 69 6e 28 45 78 nstantNotJoin(Ex
27860 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 pr*);.int sqlite
27870 33 45 78 70 72 49 73 43 6f 6e 73 74 61 6e 74 4f 3ExprIsConstantO
27880 72 46 75 6e 63 74 69 6f 6e 28 45 78 70 72 2a 2c rFunction(Expr*,
27890 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 u8);.int sqlite
278a0 33 45 78 70 72 49 73 54 61 62 6c 65 43 6f 6e 73 3ExprIsTableCons
278b0 74 61 6e 74 28 45 78 70 72 2a 2c 69 6e 74 29 3b tant(Expr*,int);
278c0 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
278d0 4e 41 42 4c 45 5f 43 55 52 53 4f 52 5f 48 49 4e NABLE_CURSOR_HIN
278e0 54 53 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 TS.int sqlite3Ex
278f0 70 72 43 6f 6e 74 61 69 6e 73 53 75 62 71 75 65 prContainsSubque
27900 72 79 28 45 78 70 72 2a 29 3b 0a 23 65 6e 64 69 ry(Expr*);.#endi
27910 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 f.int sqlite3Exp
27920 72 49 73 49 6e 74 65 67 65 72 28 45 78 70 72 2a rIsInteger(Expr*
27930 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c , int*);.int sql
27940 69 74 65 33 45 78 70 72 43 61 6e 42 65 4e 75 6c ite3ExprCanBeNul
27950 6c 28 63 6f 6e 73 74 20 45 78 70 72 2a 29 3b 0a l(const Expr*);.
27960 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 4e int sqlite3ExprN
27970 65 65 64 73 4e 6f 41 66 66 69 6e 69 74 79 43 68 eedsNoAffinityCh
27980 61 6e 67 65 28 63 6f 6e 73 74 20 45 78 70 72 2a ange(const Expr*
27990 2c 20 63 68 61 72 29 3b 0a 69 6e 74 20 73 71 6c , char);.int sql
279a0 69 74 65 33 49 73 52 6f 77 69 64 28 63 6f 6e 73 ite3IsRowid(cons
279b0 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 t char*);.void s
279c0 71 6c 69 74 65 33 47 65 6e 65 72 61 74 65 52 6f qlite3GenerateRo
279d0 77 44 65 6c 65 74 65 28 0a 20 20 20 20 50 61 72 wDelete(. Par
279e0 73 65 2a 2c 54 61 62 6c 65 2a 2c 54 72 69 67 67 se*,Table*,Trigg
279f0 65 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c er*,int,int,int,
27a00 69 31 36 2c 75 38 2c 75 38 2c 75 38 2c 69 6e 74 i16,u8,u8,u8,int
27a10 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 );.void sqlite3G
27a20 65 6e 65 72 61 74 65 52 6f 77 49 6e 64 65 78 44 enerateRowIndexD
27a30 65 6c 65 74 65 28 50 61 72 73 65 2a 2c 20 54 61 elete(Parse*, Ta
27a40 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 ble*, int, int,
27a50 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 int*, int);.int
27a60 73 71 6c 69 74 65 33 47 65 6e 65 72 61 74 65 49 sqlite3GenerateI
27a70 6e 64 65 78 4b 65 79 28 50 61 72 73 65 2a 2c 20 ndexKey(Parse*,
27a80 49 6e 64 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 Index*, int, int
27a90 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c 49 6e 64 65 , int, int*,Inde
27aa0 78 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 x*,int);.void sq
27ab0 6c 69 74 65 33 52 65 73 6f 6c 76 65 50 61 72 74 lite3ResolvePart
27ac0 49 64 78 4c 61 62 65 6c 28 50 61 72 73 65 2a 2c IdxLabel(Parse*,
27ad0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
27ae0 65 33 47 65 6e 65 72 61 74 65 43 6f 6e 73 74 72 e3GenerateConstr
27af0 61 69 6e 74 43 68 65 63 6b 73 28 50 61 72 73 65 aintChecks(Parse
27b00 2a 2c 54 61 62 6c 65 2a 2c 69 6e 74 2a 2c 69 6e *,Table*,int*,in
27b10 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 0a 20 t,int,int,int,.
27b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27b30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
27b40 20 20 20 20 75 38 2c 75 38 2c 69 6e 74 2c 69 6e u8,u8,int,in
27b50 74 2a 2c 69 6e 74 2a 29 3b 0a 76 6f 69 64 20 73 t*,int*);.void s
27b60 71 6c 69 74 65 33 43 6f 6d 70 6c 65 74 65 49 6e qlite3CompleteIn
27b70 73 65 72 74 69 6f 6e 28 50 61 72 73 65 2a 2c 54 sertion(Parse*,T
27b80 61 62 6c 65 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e able*,int,int,in
27b90 74 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 2c 69 t,int*,int,int,i
27ba0 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
27bb0 4f 70 65 6e 54 61 62 6c 65 41 6e 64 49 6e 64 69 OpenTableAndIndi
27bc0 63 65 73 28 50 61 72 73 65 2a 2c 20 54 61 62 6c ces(Parse*, Tabl
27bd0 65 2a 2c 20 69 6e 74 2c 20 75 38 2c 20 69 6e 74 e*, int, u8, int
27be0 2c 20 75 38 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 , u8*, int*, int
27bf0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
27c00 42 65 67 69 6e 57 72 69 74 65 4f 70 65 72 61 74 BeginWriteOperat
27c10 69 6f 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c ion(Parse*, int,
27c20 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
27c30 74 65 33 4d 75 6c 74 69 57 72 69 74 65 28 50 61 te3MultiWrite(Pa
27c40 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 rse*);.void sqli
27c50 74 65 33 4d 61 79 41 62 6f 72 74 28 50 61 72 73 te3MayAbort(Pars
27c60 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
27c70 33 48 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 3HaltConstraint(
27c80 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 Parse*, int, int
27c90 2c 20 63 68 61 72 2a 2c 20 69 38 2c 20 75 38 29 , char*, i8, u8)
27ca0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e ;.void sqlite3Un
27cb0 69 71 75 65 43 6f 6e 73 74 72 61 69 6e 74 28 50 iqueConstraint(P
27cc0 61 72 73 65 2a 2c 20 69 6e 74 2c 20 49 6e 64 65 arse*, int, Inde
27cd0 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 x*);.void sqlite
27ce0 33 52 6f 77 69 64 43 6f 6e 73 74 72 61 69 6e 74 3RowidConstraint
27cf0 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 54 61 (Parse*, int, Ta
27d00 62 6c 65 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c ble*);.Expr *sql
27d10 69 74 65 33 45 78 70 72 44 75 70 28 73 71 6c 69 ite3ExprDup(sqli
27d20 74 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b te3*,Expr*,int);
27d30 0a 45 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 .ExprList *sqlit
27d40 65 33 45 78 70 72 4c 69 73 74 44 75 70 28 73 71 e3ExprListDup(sq
27d50 6c 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a lite3*,ExprList*
27d60 2c 69 6e 74 29 3b 0a 53 72 63 4c 69 73 74 20 2a ,int);.SrcList *
27d70 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 75 sqlite3SrcListDu
27d80 70 28 73 71 6c 69 74 65 33 2a 2c 53 72 63 4c 69 p(sqlite3*,SrcLi
27d90 73 74 2a 2c 69 6e 74 29 3b 0a 49 64 4c 69 73 74 st*,int);.IdList
27da0 20 2a 73 71 6c 69 74 65 33 49 64 4c 69 73 74 44 *sqlite3IdListD
27db0 75 70 28 73 71 6c 69 74 65 33 2a 2c 49 64 4c 69 up(sqlite3*,IdLi
27dc0 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 2a 73 71 st*);.Select *sq
27dd0 6c 69 74 65 33 53 65 6c 65 63 74 44 75 70 28 73 lite3SelectDup(s
27de0 71 6c 69 74 65 33 2a 2c 53 65 6c 65 63 74 2a 2c qlite3*,Select*,
27df0 69 6e 74 29 3b 0a 23 69 66 20 53 45 4c 45 43 54 int);.#if SELECT
27e00 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 76 6f TRACE_ENABLED.vo
27e10 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 id sqlite3Select
27e20 53 65 74 4e 61 6d 65 28 53 65 6c 65 63 74 2a 2c SetName(Select*,
27e30 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 const char*);.#e
27e40 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
27e50 69 74 65 33 53 65 6c 65 63 74 53 65 74 4e 61 6d ite3SelectSetNam
27e60 65 28 41 2c 42 29 0a 23 65 6e 64 69 66 0a 76 6f e(A,B).#endif.vo
27e70 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 74 id sqlite3Insert
27e80 42 75 69 6c 74 69 6e 46 75 6e 63 73 28 46 75 6e BuiltinFuncs(Fun
27e90 63 44 65 66 2a 2c 69 6e 74 29 3b 0a 46 75 6e 63 cDef*,int);.Func
27ea0 44 65 66 20 2a 73 71 6c 69 74 65 33 46 69 6e 64 Def *sqlite3Find
27eb0 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 Function(sqlite3
27ec0 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e *,const char*,in
27ed0 74 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 20 73 t,u8,u8);.void s
27ee0 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 75 qlite3RegisterBu
27ef0 69 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 76 iltinFunctions(v
27f00 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 oid);.void sqlit
27f10 65 33 52 65 67 69 73 74 65 72 44 61 74 65 54 69 e3RegisterDateTi
27f20 6d 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 meFunctions(void
27f30 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
27f40 65 67 69 73 74 65 72 50 65 72 43 6f 6e 6e 65 63 egisterPerConnec
27f50 74 69 6f 6e 42 75 69 6c 74 69 6e 46 75 6e 63 74 tionBuiltinFunct
27f60 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a ions(sqlite3*);.
27f70 69 6e 74 20 73 71 6c 69 74 65 33 53 61 66 65 74 int sqlite3Safet
27f80 79 43 68 65 63 6b 4f 6b 28 73 71 6c 69 74 65 33 yCheckOk(sqlite3
27f90 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 *);.int sqlite3S
27fa0 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 afetyCheckSickOr
27fb0 4f 6b 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f Ok(sqlite3*);.vo
27fc0 69 64 20 73 71 6c 69 74 65 33 43 68 61 6e 67 65 id sqlite3Change
27fd0 43 6f 6f 6b 69 65 28 50 61 72 73 65 2a 2c 20 69 Cookie(Parse*, i
27fe0 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 69 6e nt);..#if !defin
27ff0 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ed(SQLITE_OMIT_V
28000 49 45 57 29 20 26 26 20 21 64 65 66 69 6e 65 64 IEW) && !defined
28010 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 (SQLITE_OMIT_TRI
28020 47 47 45 52 29 0a 76 6f 69 64 20 73 71 6c 69 74 GGER).void sqlit
28030 65 33 4d 61 74 65 72 69 61 6c 69 7a 65 56 69 65 e3MaterializeVie
28040 77 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a w(Parse*, Table*
28050 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 23 , Expr*, int);.#
28060 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
28070 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 QLITE_OMIT_TRIGG
28080 45 52 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ER. void sqlite
28090 33 42 65 67 69 6e 54 72 69 67 67 65 72 28 50 61 3BeginTrigger(Pa
280a0 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 54 6f 6b rse*, Token*,Tok
280b0 65 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 49 64 4c 69 en*,int,int,IdLi
280c0 73 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 0a 20 20 st*,SrcList*,.
280d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
280e0 20 20 20 20 20 20 20 20 20 45 78 70 72 2a 2c 69 Expr*,i
280f0 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 nt, int);. void
28100 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 54 72 sqlite3FinishTr
28110 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 72 igger(Parse*, Tr
28120 69 67 67 65 72 53 74 65 70 2a 2c 20 54 6f 6b 65 iggerStep*, Toke
28130 6e 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 n*);. void sqli
28140 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 28 50 te3DropTrigger(P
28150 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c arse*, SrcList*,
28160 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 71 int);. void sq
28170 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 lite3DropTrigger
28180 50 74 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 Ptr(Parse*, Trig
28190 67 65 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 ger*);. Trigger
281a0 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 *sqlite3Trigger
281b0 73 45 78 69 73 74 28 50 61 72 73 65 20 2a 2c 20 sExist(Parse *,
281c0 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 45 78 70 Table*, int, Exp
281d0 72 4c 69 73 74 2a 2c 20 69 6e 74 20 2a 70 4d 61 rList*, int *pMa
281e0 73 6b 29 3b 0a 20 20 54 72 69 67 67 65 72 20 2a sk);. Trigger *
281f0 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 4c 69 sqlite3TriggerLi
28200 73 74 28 50 61 72 73 65 20 2a 2c 20 54 61 62 6c st(Parse *, Tabl
28210 65 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c e *);. void sql
28220 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 ite3CodeRowTrigg
28230 65 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 67 er(Parse*, Trigg
28240 65 72 20 2a 2c 20 69 6e 74 2c 20 45 78 70 72 4c er *, int, ExprL
28250 69 73 74 2a 2c 20 69 6e 74 2c 20 54 61 62 6c 65 ist*, int, Table
28260 20 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 *,.
28270 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28280 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
28290 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
282a0 64 65 52 6f 77 54 72 69 67 67 65 72 44 69 72 65 deRowTriggerDire
282b0 63 74 28 50 61 72 73 65 20 2a 2c 20 54 72 69 67 ct(Parse *, Trig
282c0 67 65 72 20 2a 2c 20 54 61 62 6c 65 20 2a 2c 20 ger *, Table *,
282d0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
282e0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 56 69 65 void sqliteVie
282f0 77 54 72 69 67 67 65 72 73 28 50 61 72 73 65 2a wTriggers(Parse*
28300 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a 2c , Table*, Expr*,
28310 20 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a 29 int, ExprList*)
28320 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
28330 44 65 6c 65 74 65 54 72 69 67 67 65 72 53 74 65 DeleteTriggerSte
28340 70 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 67 p(sqlite3*, Trig
28350 67 65 72 53 74 65 70 2a 29 3b 0a 20 20 54 72 69 gerStep*);. Tri
28360 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 65 ggerStep *sqlite
28370 33 54 72 69 67 67 65 72 53 65 6c 65 63 74 53 74 3TriggerSelectSt
28380 65 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c 65 ep(sqlite3*,Sele
28390 63 74 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 53 ct*);. TriggerS
283a0 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 67 tep *sqlite3Trig
283b0 67 65 72 49 6e 73 65 72 74 53 74 65 70 28 73 71 gerInsertStep(sq
283c0 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 49 lite3*,Token*, I
283d0 64 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 20 dList*,.
283e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
283f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28400 53 65 6c 65 63 74 2a 2c 75 38 29 3b 0a 20 20 54 Select*,u8);. T
28410 72 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 riggerStep *sqli
28420 74 65 33 54 72 69 67 67 65 72 55 70 64 61 74 65 te3TriggerUpdate
28430 53 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 6f Step(sqlite3*,To
28440 6b 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 20 ken*,ExprList*,
28450 45 78 70 72 2a 2c 20 75 38 29 3b 0a 20 20 54 72 Expr*, u8);. Tr
28460 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 iggerStep *sqlit
28470 65 33 54 72 69 67 67 65 72 44 65 6c 65 74 65 53 e3TriggerDeleteS
28480 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 6f 6b tep(sqlite3*,Tok
28490 65 6e 2a 2c 20 45 78 70 72 2a 29 3b 0a 20 20 76 en*, Expr*);. v
284a0 6f 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 74 oid sqlite3Delet
284b0 65 54 72 69 67 67 65 72 28 73 71 6c 69 74 65 33 eTrigger(sqlite3
284c0 2a 2c 20 54 72 69 67 67 65 72 2a 29 3b 0a 20 20 *, Trigger*);.
284d0 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 void sqlite3Unli
284e0 6e 6b 41 6e 64 44 65 6c 65 74 65 54 72 69 67 67 nkAndDeleteTrigg
284f0 65 72 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c er(sqlite3*,int,
28500 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 const char*);.
28510 75 33 32 20 73 71 6c 69 74 65 33 54 72 69 67 67 u32 sqlite3Trigg
28520 65 72 43 6f 6c 6d 61 73 6b 28 50 61 72 73 65 2a erColmask(Parse*
28530 2c 54 72 69 67 67 65 72 2a 2c 45 78 70 72 4c 69 ,Trigger*,ExprLi
28540 73 74 2a 2c 69 6e 74 2c 69 6e 74 2c 54 61 62 6c st*,int,int,Tabl
28550 65 2a 2c 69 6e 74 29 3b 0a 23 20 64 65 66 69 6e e*,int);.# defin
28560 65 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 6f e sqlite3ParseTo
28570 70 6c 65 76 65 6c 28 70 29 20 28 28 70 29 2d 3e plevel(p) ((p)->
28580 70 54 6f 70 6c 65 76 65 6c 20 3f 20 28 70 29 2d pToplevel ? (p)-
28590 3e 70 54 6f 70 6c 65 76 65 6c 20 3a 20 28 70 29 >pToplevel : (p)
285a0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
285b0 65 33 49 73 54 6f 70 6c 65 76 65 6c 28 70 29 20 e3IsToplevel(p)
285c0 28 28 70 29 2d 3e 70 54 6f 70 6c 65 76 65 6c 3d ((p)->pToplevel=
285d0 3d 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 =0).#else.# defi
285e0 6e 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 ne sqlite3Trigge
285f0 72 73 45 78 69 73 74 28 42 2c 43 2c 44 2c 45 2c rsExist(B,C,D,E,
28600 46 29 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 F) 0.# define sq
28610 6c 69 74 65 33 44 65 6c 65 74 65 54 72 69 67 67 lite3DeleteTrigg
28620 65 72 28 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 er(A,B).# define
28630 20 73 71 6c 69 74 65 33 44 72 6f 70 54 72 69 67 sqlite3DropTrig
28640 67 65 72 50 74 72 28 41 2c 42 29 0a 23 20 64 65 gerPtr(A,B).# de
28650 66 69 6e 65 20 73 71 6c 69 74 65 33 55 6e 6c 69 fine sqlite3Unli
28660 6e 6b 41 6e 64 44 65 6c 65 74 65 54 72 69 67 67 nkAndDeleteTrigg
28670 65 72 28 41 2c 42 2c 43 29 0a 23 20 64 65 66 69 er(A,B,C).# defi
28680 6e 65 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f ne sqlite3CodeRo
28690 77 54 72 69 67 67 65 72 28 41 2c 42 2c 43 2c 44 wTrigger(A,B,C,D
286a0 2c 45 2c 46 2c 47 2c 48 2c 49 29 0a 23 20 64 65 ,E,F,G,H,I).# de
286b0 66 69 6e 65 20 73 71 6c 69 74 65 33 43 6f 64 65 fine sqlite3Code
286c0 52 6f 77 54 72 69 67 67 65 72 44 69 72 65 63 74 RowTriggerDirect
286d0 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 29 0a 23 20 (A,B,C,D,E,F).#
286e0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 72 define sqlite3Tr
286f0 69 67 67 65 72 4c 69 73 74 28 58 2c 20 59 29 20 iggerList(X, Y)
28700 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 0.# define sqlit
28710 65 33 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 e3ParseToplevel(
28720 70 29 20 70 0a 23 20 64 65 66 69 6e 65 20 73 71 p) p.# define sq
28730 6c 69 74 65 33 49 73 54 6f 70 6c 65 76 65 6c 28 lite3IsToplevel(
28740 70 29 20 31 0a 23 20 64 65 66 69 6e 65 20 73 71 p) 1.# define sq
28750 6c 69 74 65 33 54 72 69 67 67 65 72 43 6f 6c 6d lite3TriggerColm
28760 61 73 6b 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 2c ask(A,B,C,D,E,F,
28770 47 29 20 30 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 G) 0.#endif..int
28780 20 73 71 6c 69 74 65 33 4a 6f 69 6e 54 79 70 65 sqlite3JoinType
28790 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c (Parse*, Token*,
287a0 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 Token*, Token*)
287b0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 72 ;.void sqlite3Cr
287c0 65 61 74 65 46 6f 72 65 69 67 6e 4b 65 79 28 50 eateForeignKey(P
287d0 61 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a arse*, ExprList*
287e0 2c 20 54 6f 6b 65 6e 2a 2c 20 45 78 70 72 4c 69 , Token*, ExprLi
287f0 73 74 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 st*, int);.void
28800 73 71 6c 69 74 65 33 44 65 66 65 72 46 6f 72 65 sqlite3DeferFore
28810 69 67 6e 4b 65 79 28 50 61 72 73 65 2a 2c 20 69 ignKey(Parse*, i
28820 6e 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c nt);.#ifndef SQL
28830 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 ITE_OMIT_AUTHORI
28840 5a 41 54 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 ZATION. void sq
28850 6c 69 74 65 33 41 75 74 68 52 65 61 64 28 50 61 lite3AuthRead(Pa
28860 72 73 65 2a 2c 45 78 70 72 2a 2c 53 63 68 65 6d rse*,Expr*,Schem
28870 61 2a 2c 53 72 63 4c 69 73 74 2a 29 3b 0a 20 20 a*,SrcList*);.
28880 69 6e 74 20 73 71 6c 69 74 65 33 41 75 74 68 43 int sqlite3AuthC
28890 68 65 63 6b 28 50 61 72 73 65 2a 2c 69 6e 74 2c heck(Parse*,int,
288a0 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f const char*, co
288b0 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 nst char*, const
288c0 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 char*);. void
288d0 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 65 sqlite3AuthConte
288e0 78 74 50 75 73 68 28 50 61 72 73 65 2a 2c 20 41 xtPush(Parse*, A
288f0 75 74 68 43 6f 6e 74 65 78 74 2a 2c 20 63 6f 6e uthContext*, con
28900 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 st char*);. voi
28910 64 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e d sqlite3AuthCon
28920 74 65 78 74 50 6f 70 28 41 75 74 68 43 6f 6e 74 textPop(AuthCont
28930 65 78 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c ext*);. int sql
28940 69 74 65 33 41 75 74 68 52 65 61 64 43 6f 6c 28 ite3AuthReadCol(
28950 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 Parse*, const ch
28960 61 72 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 ar *, const char
28970 20 2a 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 0a *, int);.#else.
28980 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
28990 41 75 74 68 52 65 61 64 28 61 2c 62 2c 63 2c 64 AuthRead(a,b,c,d
289a0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
289b0 65 33 41 75 74 68 43 68 65 63 6b 28 61 2c 62 2c e3AuthCheck(a,b,
289c0 63 2c 64 2c 65 29 20 20 20 20 53 51 4c 49 54 45 c,d,e) SQLITE
289d0 5f 4f 4b 0a 23 20 64 65 66 69 6e 65 20 73 71 6c _OK.# define sql
289e0 69 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 50 ite3AuthContextP
289f0 75 73 68 28 61 2c 62 2c 63 29 0a 23 20 64 65 66 ush(a,b,c).# def
28a00 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 43 ine sqlite3AuthC
28a10 6f 6e 74 65 78 74 50 6f 70 28 61 29 20 20 28 28 ontextPop(a) ((
28a20 76 6f 69 64 29 28 61 29 29 0a 23 65 6e 64 69 66 void)(a)).#endif
28a30 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 74 74 .void sqlite3Att
28a40 61 63 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 ach(Parse*, Expr
28a50 2a 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 29 *, Expr*, Expr*)
28a60 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 ;.void sqlite3De
28a70 74 61 63 68 28 50 61 72 73 65 2a 2c 20 45 78 70 tach(Parse*, Exp
28a80 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
28a90 33 46 69 78 49 6e 69 74 28 44 62 46 69 78 65 72 3FixInit(DbFixer
28aa0 2a 2c 20 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 *, Parse*, int,
28ab0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
28ac0 73 74 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 st Token*);.int
28ad0 73 71 6c 69 74 65 33 46 69 78 53 72 63 4c 69 73 sqlite3FixSrcLis
28ae0 74 28 44 62 46 69 78 65 72 2a 2c 20 53 72 63 4c t(DbFixer*, SrcL
28af0 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ist*);.int sqlit
28b00 65 33 46 69 78 53 65 6c 65 63 74 28 44 62 46 69 e3FixSelect(DbFi
28b10 78 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a xer*, Select*);.
28b20 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 45 78 int sqlite3FixEx
28b30 70 72 28 44 62 46 69 78 65 72 2a 2c 20 45 78 70 pr(DbFixer*, Exp
28b40 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
28b50 46 69 78 45 78 70 72 4c 69 73 74 28 44 62 46 69 FixExprList(DbFi
28b60 78 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 xer*, ExprList*)
28b70 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 ;.int sqlite3Fix
28b80 54 72 69 67 67 65 72 53 74 65 70 28 44 62 46 69 TriggerStep(DbFi
28b90 78 65 72 2a 2c 20 54 72 69 67 67 65 72 53 74 65 xer*, TriggerSte
28ba0 70 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 p*);.int sqlite3
28bb0 41 74 6f 46 28 63 6f 6e 73 74 20 63 68 61 72 20 AtoF(const char
28bc0 2a 7a 2c 20 64 6f 75 62 6c 65 2a 2c 20 69 6e 74 *z, double*, int
28bd0 2c 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 , u8);.int sqlit
28be0 65 33 47 65 74 49 6e 74 33 32 28 63 6f 6e 73 74 e3GetInt32(const
28bf0 20 63 68 61 72 20 2a 2c 20 69 6e 74 2a 29 3b 0a char *, int*);.
28c00 69 6e 74 20 73 71 6c 69 74 65 33 41 74 6f 69 28 int sqlite3Atoi(
28c10 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e const char*);.in
28c20 74 20 73 71 6c 69 74 65 33 55 74 66 31 36 42 79 t sqlite3Utf16By
28c30 74 65 4c 65 6e 28 63 6f 6e 73 74 20 76 6f 69 64 teLen(const void
28c40 20 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e 43 68 *pData, int nCh
28c50 61 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 ar);.int sqlite3
28c60 55 74 66 38 43 68 61 72 4c 65 6e 28 63 6f 6e 73 Utf8CharLen(cons
28c70 74 20 63 68 61 72 20 2a 70 44 61 74 61 2c 20 69 t char *pData, i
28c80 6e 74 20 6e 42 79 74 65 29 3b 0a 75 33 32 20 73 nt nByte);.u32 s
28c90 71 6c 69 74 65 33 55 74 66 38 52 65 61 64 28 63 qlite3Utf8Read(c
28ca0 6f 6e 73 74 20 75 38 2a 2a 29 3b 0a 4c 6f 67 45 onst u8**);.LogE
28cb0 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 st sqlite3LogEst
28cc0 28 75 36 34 29 3b 0a 4c 6f 67 45 73 74 20 73 71 (u64);.LogEst sq
28cd0 6c 69 74 65 33 4c 6f 67 45 73 74 41 64 64 28 4c lite3LogEstAdd(L
28ce0 6f 67 45 73 74 2c 4c 6f 67 45 73 74 29 3b 0a 23 ogEst,LogEst);.#
28cf0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
28d00 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
28d10 4c 6f 67 45 73 74 20 73 71 6c 69 74 65 33 4c 6f LogEst sqlite3Lo
28d20 67 45 73 74 46 72 6f 6d 44 6f 75 62 6c 65 28 64 gEstFromDouble(d
28d30 6f 75 62 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 23 ouble);.#endif.#
28d40 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
28d50 45 5f 45 4e 41 42 4c 45 5f 53 54 4d 54 5f 53 43 E_ENABLE_STMT_SC
28d60 41 4e 53 54 41 54 55 53 29 20 7c 7c 20 5c 0a 20 ANSTATUS) || \.
28d70 20 20 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 defined(SQLIT
28d80 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f E_ENABLE_STAT3_O
28d90 52 5f 53 54 41 54 34 29 20 7c 7c 20 5c 0a 20 20 R_STAT4) || \.
28da0 20 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 defined(SQLITE
28db0 5f 45 58 50 4c 41 49 4e 5f 45 53 54 49 4d 41 54 _EXPLAIN_ESTIMAT
28dc0 45 44 5f 52 4f 57 53 29 0a 75 36 34 20 73 71 6c ED_ROWS).u64 sql
28dd0 69 74 65 33 4c 6f 67 45 73 74 54 6f 49 6e 74 28 ite3LogEstToInt(
28de0 4c 6f 67 45 73 74 29 3b 0a 23 65 6e 64 69 66 0a LogEst);.#endif.
28df0 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 ./*.** Routines
28e00 74 6f 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 to read and writ
28e10 65 20 76 61 72 69 61 62 6c 65 2d 6c 65 6e 67 74 e variable-lengt
28e20 68 20 69 6e 74 65 67 65 72 73 2e 20 20 54 68 65 h integers. The
28e30 73 65 20 75 73 65 64 20 74 6f 0a 2a 2a 20 62 65 se used to.** be
28e40 20 64 65 66 69 6e 65 64 20 6c 6f 63 61 6c 6c 79 defined locally
28e50 2c 20 62 75 74 20 6e 6f 77 20 77 65 20 75 73 65 , but now we use
28e60 20 74 68 65 20 76 61 72 69 6e 74 20 72 6f 75 74 the varint rout
28e70 69 6e 65 73 20 69 6e 20 74 68 65 20 75 74 69 6c ines in the util
28e80 2e 63 0a 2a 2a 20 66 69 6c 65 2e 0a 2a 2f 0a 69 .c.** file..*/.i
28e90 6e 74 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 nt sqlite3PutVar
28ea0 69 6e 74 28 75 6e 73 69 67 6e 65 64 20 63 68 61 int(unsigned cha
28eb0 72 2a 2c 20 75 36 34 29 3b 0a 75 38 20 73 71 6c r*, u64);.u8 sql
28ec0 69 74 65 33 47 65 74 56 61 72 69 6e 74 28 63 6f ite3GetVarint(co
28ed0 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 nst unsigned cha
28ee0 72 20 2a 2c 20 75 36 34 20 2a 29 3b 0a 75 38 20 r *, u64 *);.u8
28ef0 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 sqlite3GetVarint
28f00 33 32 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 32(const unsigne
28f10 64 20 63 68 61 72 20 2a 2c 20 75 33 32 20 2a 29 d char *, u32 *)
28f20 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 61 72 ;.int sqlite3Var
28f30 69 6e 74 4c 65 6e 28 75 36 34 20 76 29 3b 0a 0a intLen(u64 v);..
28f40 2f 2a 0a 2a 2a 20 54 68 65 20 63 6f 6d 6d 6f 6e /*.** The common
28f50 20 63 61 73 65 20 69 73 20 66 6f 72 20 61 20 76 case is for a v
28f60 61 72 69 6e 74 20 74 6f 20 62 65 20 61 20 73 69 arint to be a si
28f70 6e 67 6c 65 20 62 79 74 65 2e 20 20 54 68 65 79 ngle byte. They
28f80 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 6d 61 following.** ma
28f90 63 72 6f 73 20 68 61 6e 64 6c 65 20 74 68 65 20 cros handle the
28fa0 63 6f 6d 6d 6f 6e 20 63 61 73 65 20 77 69 74 68 common case with
28fb0 6f 75 74 20 61 20 70 72 6f 63 65 64 75 72 65 20 out a procedure
28fc0 63 61 6c 6c 2c 20 62 75 74 20 74 68 65 6e 20 63 call, but then c
28fd0 61 6c 6c 0a 2a 2a 20 74 68 65 20 70 72 6f 63 65 all.** the proce
28fe0 64 75 72 65 20 66 6f 72 20 6c 61 72 67 65 72 20 dure for larger
28ff0 76 61 72 69 6e 74 73 2e 0a 2a 2f 0a 23 64 65 66 varints..*/.#def
29000 69 6e 65 20 67 65 74 56 61 72 69 6e 74 33 32 28 ine getVarint32(
29010 41 2c 42 29 20 20 5c 0a 20 20 28 75 38 29 28 28 A,B) \. (u8)((
29020 2a 28 41 29 3c 28 75 38 29 30 78 38 30 29 3f 28 *(A)<(u8)0x80)?(
29030 28 42 29 3d 28 75 33 32 29 2a 28 41 29 29 2c 31 (B)=(u32)*(A)),1
29040 3a 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e :sqlite3GetVarin
29050 74 33 32 28 28 41 29 2c 28 75 33 32 20 2a 29 26 t32((A),(u32 *)&
29060 28 42 29 29 29 0a 23 64 65 66 69 6e 65 20 70 75 (B))).#define pu
29070 74 56 61 72 69 6e 74 33 32 28 41 2c 42 29 20 20 tVarint32(A,B)
29080 5c 0a 20 20 28 75 38 29 28 28 28 75 33 32 29 28 \. (u8)(((u32)(
29090 42 29 3c 28 75 33 32 29 30 78 38 30 29 3f 28 2a B)<(u32)0x80)?(*
290a0 28 41 29 3d 28 75 6e 73 69 67 6e 65 64 20 63 68 (A)=(unsigned ch
290b0 61 72 29 28 42 29 29 2c 31 3a 5c 0a 20 20 73 71 ar)(B)),1:\. sq
290c0 6c 69 74 65 33 50 75 74 56 61 72 69 6e 74 28 28 lite3PutVarint((
290d0 41 29 2c 28 42 29 29 29 0a 23 64 65 66 69 6e 65 A),(B))).#define
290e0 20 67 65 74 56 61 72 69 6e 74 20 20 20 20 73 71 getVarint sq
290f0 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 0a 23 lite3GetVarint.#
29100 64 65 66 69 6e 65 20 70 75 74 56 61 72 69 6e 74 define putVarint
29110 20 20 20 20 73 71 6c 69 74 65 33 50 75 74 56 61 sqlite3PutVa
29120 72 69 6e 74 0a 0a 0a 63 6f 6e 73 74 20 63 68 61 rint...const cha
29130 72 20 2a 73 71 6c 69 74 65 33 49 6e 64 65 78 41 r *sqlite3IndexA
29140 66 66 69 6e 69 74 79 53 74 72 28 73 71 6c 69 74 ffinityStr(sqlit
29150 65 33 2a 2c 20 49 6e 64 65 78 2a 29 3b 0a 76 6f e3*, Index*);.vo
29160 69 64 20 73 71 6c 69 74 65 33 54 61 62 6c 65 41 id sqlite3TableA
29170 66 66 69 6e 69 74 79 28 56 64 62 65 2a 2c 20 54 ffinity(Vdbe*, T
29180 61 62 6c 65 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 able*, int);.cha
29190 72 20 73 71 6c 69 74 65 33 43 6f 6d 70 61 72 65 r sqlite3Compare
291a0 41 66 66 69 6e 69 74 79 28 45 78 70 72 20 2a 70 Affinity(Expr *p
291b0 45 78 70 72 2c 20 63 68 61 72 20 61 66 66 32 29 Expr, char aff2)
291c0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 ;.int sqlite3Ind
291d0 65 78 41 66 66 69 6e 69 74 79 4f 6b 28 45 78 70 exAffinityOk(Exp
291e0 72 20 2a 70 45 78 70 72 2c 20 63 68 61 72 20 69 r *pExpr, char i
291f0 64 78 5f 61 66 66 69 6e 69 74 79 29 3b 0a 63 68 dx_affinity);.ch
29200 61 72 20 73 71 6c 69 74 65 33 54 61 62 6c 65 43 ar sqlite3TableC
29210 6f 6c 75 6d 6e 41 66 66 69 6e 69 74 79 28 54 61 olumnAffinity(Ta
29220 62 6c 65 2a 2c 69 6e 74 29 3b 0a 63 68 61 72 20 ble*,int);.char
29230 73 71 6c 69 74 65 33 45 78 70 72 41 66 66 69 6e sqlite3ExprAffin
29240 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 72 29 ity(Expr *pExpr)
29250 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 74 6f ;.int sqlite3Ato
29260 69 36 34 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c i64(const char*,
29270 20 69 36 34 2a 2c 20 69 6e 74 2c 20 75 38 29 3b i64*, int, u8);
29280 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 65 63 4f .int sqlite3DecO
29290 72 48 65 78 54 6f 49 36 34 28 63 6f 6e 73 74 20 rHexToI64(const
292a0 63 68 61 72 2a 2c 20 69 36 34 2a 29 3b 0a 76 6f char*, i64*);.vo
292b0 69 64 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 id sqlite3ErrorW
292c0 69 74 68 4d 73 67 28 73 71 6c 69 74 65 33 2a 2c ithMsg(sqlite3*,
292d0 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 int, const char
292e0 2a 2c 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 6c *,...);.void sql
292f0 69 74 65 33 45 72 72 6f 72 28 73 71 6c 69 74 65 ite3Error(sqlite
29300 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 3*,int);.void sq
29310 6c 69 74 65 33 53 79 73 74 65 6d 45 72 72 6f 72 lite3SystemError
29320 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a (sqlite3*,int);.
29330 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 48 65 78 void *sqlite3Hex
29340 54 6f 42 6c 6f 62 28 73 71 6c 69 74 65 33 2a 2c ToBlob(sqlite3*,
29350 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 const char *z,
29360 69 6e 74 20 6e 29 3b 0a 75 38 20 73 71 6c 69 74 int n);.u8 sqlit
29370 65 33 48 65 78 54 6f 49 6e 74 28 69 6e 74 20 68 e3HexToInt(int h
29380 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 77 );.int sqlite3Tw
29390 6f 50 61 72 74 4e 61 6d 65 28 50 61 72 73 65 20 oPartName(Parse
293a0 2a 2c 20 54 6f 6b 65 6e 20 2a 2c 20 54 6f 6b 65 *, Token *, Toke
293b0 6e 20 2a 2c 20 54 6f 6b 65 6e 20 2a 2a 29 3b 0a n *, Token **);.
293c0 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c .#if defined(SQL
293d0 49 54 45 5f 4e 45 45 44 5f 45 52 52 5f 4e 41 4d ITE_NEED_ERR_NAM
293e0 45 29 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 E).const char *s
293f0 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 69 6e qlite3ErrName(in
29400 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 63 6f 6e 73 t);.#endif..cons
29410 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 45 t char *sqlite3E
29420 72 72 53 74 72 28 69 6e 74 29 3b 0a 69 6e 74 20 rrStr(int);.int
29430 73 71 6c 69 74 65 33 52 65 61 64 53 63 68 65 6d sqlite3ReadSchem
29440 61 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 29 a(Parse *pParse)
29450 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 ;.CollSeq *sqlit
29460 65 33 46 69 6e 64 43 6f 6c 6c 53 65 71 28 73 71 e3FindCollSeq(sq
29470 6c 69 74 65 33 2a 2c 75 38 20 65 6e 63 2c 20 63 lite3*,u8 enc, c
29480 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b onst char*,int);
29490 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 .CollSeq *sqlite
294a0 33 4c 6f 63 61 74 65 43 6f 6c 6c 53 65 71 28 50 3LocateCollSeq(P
294b0 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 63 6f arse *pParse, co
294c0 6e 73 74 20 63 68 61 72 2a 7a 4e 61 6d 65 29 3b nst char*zName);
294d0 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 .CollSeq *sqlite
294e0 33 45 78 70 72 43 6f 6c 6c 53 65 71 28 50 61 72 3ExprCollSeq(Par
294f0 73 65 20 2a 70 50 61 72 73 65 2c 20 45 78 70 72 se *pParse, Expr
29500 20 2a 70 45 78 70 72 29 3b 0a 45 78 70 72 20 2a *pExpr);.Expr *
29510 73 71 6c 69 74 65 33 45 78 70 72 41 64 64 43 6f sqlite3ExprAddCo
29520 6c 6c 61 74 65 54 6f 6b 65 6e 28 50 61 72 73 65 llateToken(Parse
29530 20 2a 70 50 61 72 73 65 2c 20 45 78 70 72 2a 2c *pParse, Expr*,
29540 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 2c 20 69 const Token*, i
29550 6e 74 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 nt);.Expr *sqlit
29560 65 33 45 78 70 72 41 64 64 43 6f 6c 6c 61 74 65 e3ExprAddCollate
29570 53 74 72 69 6e 67 28 50 61 72 73 65 2a 2c 45 78 String(Parse*,Ex
29580 70 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 pr*,const char*)
29590 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 ;.Expr *sqlite3E
295a0 78 70 72 53 6b 69 70 43 6f 6c 6c 61 74 65 28 45 xprSkipCollate(E
295b0 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 xpr*);.int sqlit
295c0 65 33 43 68 65 63 6b 43 6f 6c 6c 53 65 71 28 50 e3CheckCollSeq(P
295d0 61 72 73 65 20 2a 2c 20 43 6f 6c 6c 53 65 71 20 arse *, CollSeq
295e0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 *);.int sqlite3C
295f0 68 65 63 6b 4f 62 6a 65 63 74 4e 61 6d 65 28 50 heckObjectName(P
29600 61 72 73 65 20 2a 2c 20 63 6f 6e 73 74 20 63 68 arse *, const ch
29610 61 72 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ar *);.void sqli
29620 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65 te3VdbeSetChange
29630 73 28 73 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 s(sqlite3 *, int
29640 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 64 );.int sqlite3Ad
29650 64 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 29 dInt64(i64*,i64)
29660 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 75 62 ;.int sqlite3Sub
29670 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 29 3b Int64(i64*,i64);
29680 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 75 6c 49 .int sqlite3MulI
29690 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a nt64(i64*,i64);.
296a0 69 6e 74 20 73 71 6c 69 74 65 33 41 62 73 49 6e int sqlite3AbsIn
296b0 74 33 32 28 69 6e 74 29 3b 0a 23 69 66 64 65 66 t32(int);.#ifdef
296c0 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 38 SQLITE_ENABLE_8
296d0 5f 33 5f 4e 41 4d 45 53 0a 76 6f 69 64 20 73 71 _3_NAMES.void sq
296e0 6c 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 lite3FileSuffix3
296f0 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 68 (const char*, ch
29700 61 72 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 ar*);.#else.# de
29710 66 69 6e 65 20 73 71 6c 69 74 65 33 46 69 6c 65 fine sqlite3File
29720 53 75 66 66 69 78 33 28 58 2c 59 29 0a 23 65 6e Suffix3(X,Y).#en
29730 64 69 66 0a 75 38 20 73 71 6c 69 74 65 33 47 65 dif.u8 sqlite3Ge
29740 74 42 6f 6f 6c 65 61 6e 28 63 6f 6e 73 74 20 63 tBoolean(const c
29750 68 61 72 20 2a 7a 2c 75 38 29 3b 0a 0a 63 6f 6e har *z,u8);..con
29760 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 st void *sqlite3
29770 56 61 6c 75 65 54 65 78 74 28 73 71 6c 69 74 65 ValueText(sqlite
29780 33 5f 76 61 6c 75 65 2a 2c 20 75 38 29 3b 0a 69 3_value*, u8);.i
29790 6e 74 20 73 71 6c 69 74 65 33 56 61 6c 75 65 42 nt sqlite3ValueB
297a0 79 74 65 73 28 73 71 6c 69 74 65 33 5f 76 61 6c ytes(sqlite3_val
297b0 75 65 2a 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 ue*, u8);.void s
297c0 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 53 74 qlite3ValueSetSt
297d0 72 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a r(sqlite3_value*
297e0 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69 , int, const voi
297f0 64 20 2a 2c 75 38 2c 0a 20 20 20 20 20 20 20 20 d *,u8,.
29800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29810 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b void(*)(void*));
29820 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 61 6c .void sqlite3Val
29830 75 65 53 65 74 4e 75 6c 6c 28 73 71 6c 69 74 65 ueSetNull(sqlite
29840 33 5f 76 61 6c 75 65 2a 29 3b 0a 76 6f 69 64 20 3_value*);.void
29850 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 sqlite3ValueFree
29860 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 (sqlite3_value*)
29870 3b 0a 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 ;.sqlite3_value
29880 2a 73 71 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 *sqlite3ValueNew
29890 28 73 71 6c 69 74 65 33 20 2a 29 3b 0a 63 68 61 (sqlite3 *);.cha
298a0 72 20 2a 73 71 6c 69 74 65 33 55 74 66 31 36 74 r *sqlite3Utf16t
298b0 6f 38 28 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f o8(sqlite3 *, co
298c0 6e 73 74 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 nst void*, int,
298d0 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 u8);.int sqlite3
298e0 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 28 73 71 ValueFromExpr(sq
298f0 6c 69 74 65 33 20 2a 2c 20 45 78 70 72 20 2a 2c lite3 *, Expr *,
29900 20 75 38 2c 20 75 38 2c 20 73 71 6c 69 74 65 33 u8, u8, sqlite3
29910 5f 76 61 6c 75 65 20 2a 2a 29 3b 0a 76 6f 69 64 _value **);.void
29920 20 73 71 6c 69 74 65 33 56 61 6c 75 65 41 70 70 sqlite3ValueApp
29930 6c 79 41 66 66 69 6e 69 74 79 28 73 71 6c 69 74 lyAffinity(sqlit
29940 65 33 5f 76 61 6c 75 65 20 2a 2c 20 75 38 2c 20 e3_value *, u8,
29950 75 38 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c u8);.#ifndef SQL
29960 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e ITE_AMALGAMATION
29970 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e .extern const un
29980 73 69 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 signed char sqli
29990 74 65 33 4f 70 63 6f 64 65 50 72 6f 70 65 72 74 te3OpcodePropert
299a0 79 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 y[];.extern cons
299b0 74 20 63 68 61 72 20 73 71 6c 69 74 65 33 53 74 t char sqlite3St
299c0 72 42 49 4e 41 52 59 5b 5d 3b 0a 65 78 74 65 72 rBINARY[];.exter
299d0 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 n const unsigned
299e0 20 63 68 61 72 20 73 71 6c 69 74 65 33 55 70 70 char sqlite3Upp
299f0 65 72 54 6f 4c 6f 77 65 72 5b 5d 3b 0a 65 78 74 erToLower[];.ext
29a00 65 72 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e ern const unsign
29a10 65 64 20 63 68 61 72 20 73 71 6c 69 74 65 33 43 ed char sqlite3C
29a20 74 79 70 65 4d 61 70 5b 5d 3b 0a 65 78 74 65 72 typeMap[];.exter
29a30 6e 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 20 73 71 n const Token sq
29a40 6c 69 74 65 33 49 6e 74 54 6f 6b 65 6e 73 5b 5d lite3IntTokens[]
29a50 3b 0a 65 78 74 65 72 6e 20 53 51 4c 49 54 45 5f ;.extern SQLITE_
29a60 57 53 44 20 73 74 72 75 63 74 20 53 71 6c 69 74 WSD struct Sqlit
29a70 65 33 43 6f 6e 66 69 67 20 73 71 6c 69 74 65 33 e3Config sqlite3
29a80 43 6f 6e 66 69 67 3b 0a 65 78 74 65 72 6e 20 46 Config;.extern F
29a90 75 6e 63 44 65 66 48 61 73 68 20 73 71 6c 69 74 uncDefHash sqlit
29aa0 65 33 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 6f e3BuiltinFunctio
29ab0 6e 73 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 ns;.#ifndef SQLI
29ac0 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 65 78 74 65 TE_OMIT_WSD.exte
29ad0 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 50 65 rn int sqlite3Pe
29ae0 6e 64 69 6e 67 42 79 74 65 3b 0a 23 65 6e 64 69 ndingByte;.#endi
29af0 66 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 f.#endif.void sq
29b00 6c 69 74 65 33 52 6f 6f 74 50 61 67 65 4d 6f 76 lite3RootPageMov
29b10 65 64 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 ed(sqlite3*, int
29b20 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
29b30 64 20 73 71 6c 69 74 65 33 52 65 69 6e 64 65 78 d sqlite3Reindex
29b40 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c (Parse*, Token*,
29b50 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 Token*);.void s
29b60 71 6c 69 74 65 33 41 6c 74 65 72 46 75 6e 63 74 qlite3AlterFunct
29b70 69 6f 6e 73 28 76 6f 69 64 29 3b 0a 76 6f 69 64 ions(void);.void
29b80 20 73 71 6c 69 74 65 33 41 6c 74 65 72 52 65 6e sqlite3AlterRen
29b90 61 6d 65 54 61 62 6c 65 28 50 61 72 73 65 2a 2c ameTable(Parse*,
29ba0 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e SrcList*, Token
29bb0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 *);.int sqlite3G
29bc0 65 74 54 6f 6b 65 6e 28 63 6f 6e 73 74 20 75 6e etToken(const un
29bd0 73 69 67 6e 65 64 20 63 68 61 72 20 2a 2c 20 69 signed char *, i
29be0 6e 74 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 nt *);.void sqli
29bf0 74 65 33 4e 65 73 74 65 64 50 61 72 73 65 28 50 te3NestedParse(P
29c00 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 arse*, const cha
29c10 72 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 r*, ...);.void s
29c20 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 70 qlite3ExpirePrep
29c30 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 73 aredStatements(s
29c40 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 qlite3*);.int sq
29c50 6c 69 74 65 33 43 6f 64 65 53 75 62 73 65 6c 65 lite3CodeSubsele
29c60 63 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 20 ct(Parse*, Expr
29c70 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f *, int, int);.vo
29c80 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 id sqlite3Select
29c90 50 72 65 70 28 50 61 72 73 65 2a 2c 20 53 65 6c Prep(Parse*, Sel
29ca0 65 63 74 2a 2c 20 4e 61 6d 65 43 6f 6e 74 65 78 ect*, NameContex
29cb0 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
29cc0 33 53 65 6c 65 63 74 57 72 6f 6e 67 4e 75 6d 54 3SelectWrongNumT
29cd0 65 72 6d 73 45 72 72 6f 72 28 50 61 72 73 65 20 ermsError(Parse
29ce0 2a 70 50 61 72 73 65 2c 20 53 65 6c 65 63 74 20 *pParse, Select
29cf0 2a 70 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 *p);.int sqlite3
29d00 4d 61 74 63 68 53 70 61 6e 4e 61 6d 65 28 63 6f MatchSpanName(co
29d10 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 nst char*, const
29d20 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 char*, const ch
29d30 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a ar*, const char*
29d40 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 );.int sqlite3Re
29d50 73 6f 6c 76 65 45 78 70 72 4e 61 6d 65 73 28 4e solveExprNames(N
29d60 61 6d 65 43 6f 6e 74 65 78 74 2a 2c 20 45 78 70 ameContext*, Exp
29d70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
29d80 52 65 73 6f 6c 76 65 45 78 70 72 4c 69 73 74 4e ResolveExprListN
29d90 61 6d 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 74 ames(NameContext
29da0 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a 76 *, ExprList*);.v
29db0 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 6f 6c oid sqlite3Resol
29dc0 76 65 53 65 6c 65 63 74 4e 61 6d 65 73 28 50 61 veSelectNames(Pa
29dd0 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 4e rse*, Select*, N
29de0 61 6d 65 43 6f 6e 74 65 78 74 2a 29 3b 0a 76 6f ameContext*);.vo
29df0 69 64 20 73 71 6c 69 74 65 33 52 65 73 6f 6c 76 id sqlite3Resolv
29e00 65 53 65 6c 66 52 65 66 65 72 65 6e 63 65 28 50 eSelfReference(P
29e10 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 69 6e 74 arse*,Table*,int
29e20 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a ,Expr*,ExprList*
29e30 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 );.int sqlite3Re
29e40 73 6f 6c 76 65 4f 72 64 65 72 47 72 6f 75 70 42 solveOrderGroupB
29e50 79 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 y(Parse*, Select
29e60 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f *, ExprList*, co
29e70 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
29e80 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 44 65 sqlite3ColumnDe
29e90 66 61 75 6c 74 28 56 64 62 65 20 2a 2c 20 54 61 fault(Vdbe *, Ta
29ea0 62 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 ble *, int, int)
29eb0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 6c ;.void sqlite3Al
29ec0 74 65 72 46 69 6e 69 73 68 41 64 64 43 6f 6c 75 terFinishAddColu
29ed0 6d 6e 28 50 61 72 73 65 20 2a 2c 20 54 6f 6b 65 mn(Parse *, Toke
29ee0 6e 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 n *);.void sqlit
29ef0 65 33 41 6c 74 65 72 42 65 67 69 6e 41 64 64 43 e3AlterBeginAddC
29f00 6f 6c 75 6d 6e 28 50 61 72 73 65 20 2a 2c 20 53 olumn(Parse *, S
29f10 72 63 4c 69 73 74 20 2a 29 3b 0a 43 6f 6c 6c 53 rcList *);.CollS
29f20 65 71 20 2a 73 71 6c 69 74 65 33 47 65 74 43 6f eq *sqlite3GetCo
29f30 6c 6c 53 65 71 28 50 61 72 73 65 2a 2c 20 75 38 llSeq(Parse*, u8
29f40 2c 20 43 6f 6c 6c 53 65 71 20 2a 2c 20 63 6f 6e , CollSeq *, con
29f50 73 74 20 63 68 61 72 2a 29 3b 0a 63 68 61 72 20 st char*);.char
29f60 73 71 6c 69 74 65 33 41 66 66 69 6e 69 74 79 54 sqlite3AffinityT
29f70 79 70 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c ype(const char*,
29f80 20 75 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 u8*);.void sqli
29f90 74 65 33 41 6e 61 6c 79 7a 65 28 50 61 72 73 65 te3Analyze(Parse
29fa0 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e *, Token*, Token
29fb0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 *);.int sqlite3I
29fc0 6e 76 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 nvokeBusyHandler
29fd0 28 42 75 73 79 48 61 6e 64 6c 65 72 2a 29 3b 0a (BusyHandler*);.
29fe0 69 6e 74 20 73 71 6c 69 74 65 33 46 69 6e 64 44 int sqlite3FindD
29ff0 62 28 73 71 6c 69 74 65 33 2a 2c 20 54 6f 6b 65 b(sqlite3*, Toke
2a000 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 n*);.int sqlite3
2a010 46 69 6e 64 44 62 4e 61 6d 65 28 73 71 6c 69 74 FindDbName(sqlit
2a020 65 33 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 e3 *, const char
2a030 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 *);.int sqlite3
2a040 41 6e 61 6c 79 73 69 73 4c 6f 61 64 28 73 71 6c AnalysisLoad(sql
2a050 69 74 65 33 2a 2c 69 6e 74 20 69 44 42 29 3b 0a ite3*,int iDB);.
2a060 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 void sqlite3Dele
2a070 74 65 49 6e 64 65 78 53 61 6d 70 6c 65 73 28 73 teIndexSamples(s
2a080 71 6c 69 74 65 33 2a 2c 49 6e 64 65 78 2a 29 3b qlite3*,Index*);
2a090 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 66 .void sqlite3Def
2a0a0 61 75 6c 74 52 6f 77 45 73 74 28 49 6e 64 65 78 aultRowEst(Index
2a0b0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2a0c0 52 65 67 69 73 74 65 72 4c 69 6b 65 46 75 6e 63 RegisterLikeFunc
2a0d0 74 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 2c 20 tions(sqlite3*,
2a0e0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
2a0f0 33 49 73 4c 69 6b 65 46 75 6e 63 74 69 6f 6e 28 3IsLikeFunction(
2a100 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 69 sqlite3*,Expr*,i
2a110 6e 74 2a 2c 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nt*,char*);.void
2a120 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 43 6c sqlite3SchemaCl
2a130 65 61 72 28 76 6f 69 64 20 2a 29 3b 0a 53 63 68 ear(void *);.Sch
2a140 65 6d 61 20 2a 73 71 6c 69 74 65 33 53 63 68 65 ema *sqlite3Sche
2a150 6d 61 47 65 74 28 73 71 6c 69 74 65 33 20 2a 2c maGet(sqlite3 *,
2a160 20 42 74 72 65 65 20 2a 29 3b 0a 69 6e 74 20 73 Btree *);.int s
2a170 71 6c 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e qlite3SchemaToIn
2a180 64 65 78 28 73 71 6c 69 74 65 33 20 2a 64 62 2c dex(sqlite3 *db,
2a190 20 53 63 68 65 6d 61 20 2a 29 3b 0a 4b 65 79 49 Schema *);.KeyI
2a1a0 6e 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 nfo *sqlite3KeyI
2a1b0 6e 66 6f 41 6c 6c 6f 63 28 73 71 6c 69 74 65 33 nfoAlloc(sqlite3
2a1c0 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 *,int,int);.void
2a1d0 20 73 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 55 sqlite3KeyInfoU
2a1e0 6e 72 65 66 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a nref(KeyInfo*);.
2a1f0 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 KeyInfo *sqlite3
2a200 4b 65 79 49 6e 66 6f 52 65 66 28 4b 65 79 49 6e KeyInfoRef(KeyIn
2a210 66 6f 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 fo*);.KeyInfo *s
2a220 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 4f 66 49 qlite3KeyInfoOfI
2a230 6e 64 65 78 28 50 61 72 73 65 2a 2c 20 49 6e 64 ndex(Parse*, Ind
2a240 65 78 2a 29 3b 0a 23 69 66 64 65 66 20 53 51 4c ex*);.#ifdef SQL
2a250 49 54 45 5f 44 45 42 55 47 0a 69 6e 74 20 73 71 ITE_DEBUG.int sq
2a260 6c 69 74 65 33 4b 65 79 49 6e 66 6f 49 73 57 72 lite3KeyInfoIsWr
2a270 69 74 65 61 62 6c 65 28 4b 65 79 49 6e 66 6f 2a iteable(KeyInfo*
2a280 29 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 );.#endif.int sq
2a290 6c 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 lite3CreateFunc(
2a2a0 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 sqlite3 *, const
2a2b0 20 63 68 61 72 20 2a 2c 20 69 6e 74 2c 20 69 6e char *, int, in
2a2c0 74 2c 20 76 6f 69 64 20 2a 2c 0a 20 20 76 6f 69 t, void *,. voi
2a2d0 64 20 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f d (*)(sqlite3_co
2a2e0 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 ntext*,int,sqlit
2a2f0 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 e3_value **),.
2a300 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 74 65 33 void (*)(sqlite3
2a310 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
2a320 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c lite3_value **),
2a330 20 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 74 65 void (*)(sqlite
2a340 33 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 46 3_context*),. F
2a350 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 uncDestructor *p
2a360 44 65 73 74 72 75 63 74 6f 72 0a 29 3b 0a 76 6f Destructor.);.vo
2a370 69 64 20 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 id sqlite3OomFau
2a380 6c 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f lt(sqlite3*);.vo
2a390 69 64 20 73 71 6c 69 74 65 33 4f 6f 6d 43 6c 65 id sqlite3OomCle
2a3a0 61 72 28 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e ar(sqlite3*);.in
2a3b0 74 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 t sqlite3ApiExit
2a3c0 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e (sqlite3 *db, in
2a3d0 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f t);.int sqlite3O
2a3e0 70 65 6e 54 65 6d 70 44 61 74 61 62 61 73 65 28 penTempDatabase(
2a3f0 50 61 72 73 65 20 2a 29 3b 0a 0a 76 6f 69 64 20 Parse *);..void
2a400 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d 49 sqlite3StrAccumI
2a410 6e 69 74 28 53 74 72 41 63 63 75 6d 2a 2c 20 73 nit(StrAccum*, s
2a420 71 6c 69 74 65 33 2a 2c 20 63 68 61 72 2a 2c 20 qlite3*, char*,
2a430 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
2a440 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d 41 sqlite3StrAccumA
2a450 70 70 65 6e 64 28 53 74 72 41 63 63 75 6d 2a 2c ppend(StrAccum*,
2a460 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 const char*,int)
2a470 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 ;.void sqlite3St
2a480 72 41 63 63 75 6d 41 70 70 65 6e 64 41 6c 6c 28 rAccumAppendAll(
2a490 53 74 72 41 63 63 75 6d 2a 2c 63 6f 6e 73 74 20 StrAccum*,const
2a4a0 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c char*);.void sql
2a4b0 69 74 65 33 41 70 70 65 6e 64 43 68 61 72 28 53 ite3AppendChar(S
2a4c0 74 72 41 63 63 75 6d 2a 2c 69 6e 74 2c 63 68 61 trAccum*,int,cha
2a4d0 72 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 r);.char *sqlite
2a4e0 33 53 74 72 41 63 63 75 6d 46 69 6e 69 73 68 28 3StrAccumFinish(
2a4f0 53 74 72 41 63 63 75 6d 2a 29 3b 0a 76 6f 69 64 StrAccum*);.void
2a500 20 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d sqlite3StrAccum
2a510 52 65 73 65 74 28 53 74 72 41 63 63 75 6d 2a 29 Reset(StrAccum*)
2a520 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 ;.void sqlite3Se
2a530 6c 65 63 74 44 65 73 74 49 6e 69 74 28 53 65 6c lectDestInit(Sel
2a540 65 63 74 44 65 73 74 2a 2c 69 6e 74 2c 69 6e 74 ectDest*,int,int
2a550 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 );.Expr *sqlite3
2a560 43 72 65 61 74 65 43 6f 6c 75 6d 6e 45 78 70 72 CreateColumnExpr
2a570 28 73 71 6c 69 74 65 33 20 2a 2c 20 53 72 63 4c (sqlite3 *, SrcL
2a580 69 73 74 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 ist *, int, int)
2a590 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 ;..void sqlite3B
2a5a0 61 63 6b 75 70 52 65 73 74 61 72 74 28 73 71 6c ackupRestart(sql
2a5b0 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 29 3b 0a ite3_backup *);.
2a5c0 76 6f 69 64 20 73 71 6c 69 74 65 33 42 61 63 6b void sqlite3Back
2a5d0 75 70 55 70 64 61 74 65 28 73 71 6c 69 74 65 33 upUpdate(sqlite3
2a5e0 5f 62 61 63 6b 75 70 20 2a 2c 20 50 67 6e 6f 2c _backup *, Pgno,
2a5f0 20 63 6f 6e 73 74 20 75 38 20 2a 29 3b 0a 0a 23 const u8 *);..#
2a600 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
2a610 49 54 5f 53 55 42 51 55 45 52 59 0a 69 6e 74 20 IT_SUBQUERY.int
2a620 73 71 6c 69 74 65 33 45 78 70 72 43 68 65 63 6b sqlite3ExprCheck
2a630 49 4e 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a IN(Parse*, Expr*
2a640 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e );.#else.# defin
2a650 65 20 73 71 6c 69 74 65 33 45 78 70 72 43 68 65 e sqlite3ExprChe
2a660 63 6b 49 4e 28 78 2c 79 29 20 53 51 4c 49 54 45 ckIN(x,y) SQLITE
2a670 5f 4f 4b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 _OK.#endif.int s
2a680 71 6c 69 74 65 33 45 78 70 72 43 68 65 63 6b 43 qlite3ExprCheckC
2a690 6f 6d 70 61 72 69 73 6f 6e 28 50 61 72 73 65 2a omparison(Parse*
2a6a0 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 29 3b , Expr*, Expr*);
2a6b0 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
2a6c0 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f ENABLE_STAT3_OR_
2a6d0 53 54 41 54 34 0a 76 6f 69 64 20 73 71 6c 69 74 STAT4.void sqlit
2a6e0 65 33 41 6e 61 6c 79 7a 65 46 75 6e 63 74 69 6f e3AnalyzeFunctio
2a6f0 6e 73 28 76 6f 69 64 29 3b 0a 69 6e 74 20 73 71 ns(void);.int sq
2a700 6c 69 74 65 33 53 74 61 74 34 50 72 6f 62 65 53 lite3Stat4ProbeS
2a710 65 74 56 61 6c 75 65 28 0a 20 20 20 20 50 61 72 etValue(. Par
2a720 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 6e 70 61 63 se*,Index*,Unpac
2a730 6b 65 64 52 65 63 6f 72 64 2a 2a 2c 45 78 70 72 kedRecord**,Expr
2a740 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2a 29 3b *,int,int,int*);
2a750 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 74 .int sqlite3Stat
2a760 34 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 28 50 4ValueFromExpr(P
2a770 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 75 38 arse*, Expr*, u8
2a780 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a , sqlite3_value*
2a790 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
2a7a0 53 74 61 74 34 50 72 6f 62 65 46 72 65 65 28 55 Stat4ProbeFree(U
2a7b0 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 29 3b npackedRecord*);
2a7c0 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 74 .int sqlite3Stat
2a7d0 34 43 6f 6c 75 6d 6e 28 73 71 6c 69 74 65 33 2a 4Column(sqlite3*
2a7e0 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 69 , const void*, i
2a7f0 6e 74 2c 20 69 6e 74 2c 20 73 71 6c 69 74 65 33 nt, int, sqlite3
2a800 5f 76 61 6c 75 65 2a 2a 29 3b 0a 63 68 61 72 20 _value**);.char
2a810 73 71 6c 69 74 65 33 49 6e 64 65 78 43 6f 6c 75 sqlite3IndexColu
2a820 6d 6e 41 66 66 69 6e 69 74 79 28 73 71 6c 69 74 mnAffinity(sqlit
2a830 65 33 2a 2c 20 49 6e 64 65 78 2a 2c 20 69 6e 74 e3*, Index*, int
2a840 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a );.#endif../*.**
2a850 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 The interface t
2a860 6f 20 74 68 65 20 4c 45 4d 4f 4e 2d 67 65 6e 65 o the LEMON-gene
2a870 72 61 74 65 64 20 70 61 72 73 65 72 0a 2a 2f 0a rated parser.*/.
2a880 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 50 61 72 void *sqlite3Par
2a890 73 65 72 41 6c 6c 6f 63 28 76 6f 69 64 2a 28 2a serAlloc(void*(*
2a8a0 29 28 75 36 34 29 29 3b 0a 76 6f 69 64 20 73 71 )(u64));.void sq
2a8b0 6c 69 74 65 33 50 61 72 73 65 72 46 72 65 65 28 lite3ParserFree(
2a8c0 76 6f 69 64 2a 2c 20 76 6f 69 64 28 2a 29 28 76 void*, void(*)(v
2a8d0 6f 69 64 2a 29 29 3b 0a 76 6f 69 64 20 73 71 6c oid*));.void sql
2a8e0 69 74 65 33 50 61 72 73 65 72 28 76 6f 69 64 2a ite3Parser(void*
2a8f0 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2c 20 50 61 , int, Token, Pa
2a900 72 73 65 2a 29 3b 0a 23 69 66 64 65 66 20 59 59 rse*);.#ifdef YY
2a910 54 52 41 43 4b 4d 41 58 53 54 41 43 4b 44 45 50 TRACKMAXSTACKDEP
2a920 54 48 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 TH. int sqlite3
2a930 50 61 72 73 65 72 53 74 61 63 6b 50 65 61 6b 28 ParserStackPeak(
2a940 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a void*);.#endif..
2a950 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 6f void sqlite3Auto
2a960 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 73 LoadExtensions(s
2a970 71 6c 69 74 65 33 2a 29 3b 0a 23 69 66 6e 64 65 qlite3*);.#ifnde
2a980 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f f SQLITE_OMIT_LO
2a990 41 44 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 76 AD_EXTENSION. v
2a9a0 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 oid sqlite3Close
2a9b0 45 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 74 Extensions(sqlit
2a9c0 65 33 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 e3*);.#else.# de
2a9d0 66 69 6e 65 20 73 71 6c 69 74 65 33 43 6c 6f 73 fine sqlite3Clos
2a9e0 65 45 78 74 65 6e 73 69 6f 6e 73 28 58 29 0a 23 eExtensions(X).#
2a9f0 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 endif..#ifndef S
2aa00 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 QLITE_OMIT_SHARE
2aa10 44 5f 43 41 43 48 45 0a 20 20 76 6f 69 64 20 73 D_CACHE. void s
2aa20 71 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 qlite3TableLock(
2aa30 50 61 72 73 65 20 2a 2c 20 69 6e 74 2c 20 69 6e Parse *, int, in
2aa40 74 2c 20 75 38 2c 20 63 6f 6e 73 74 20 63 68 61 t, u8, const cha
2aa50 72 20 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 r *);.#else. #d
2aa60 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 61 62 efine sqlite3Tab
2aa70 6c 65 4c 6f 63 6b 28 76 2c 77 2c 78 2c 79 2c 7a leLock(v,w,x,y,z
2aa80 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 ).#endif..#ifdef
2aa90 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 SQLITE_TEST. i
2aaa0 6e 74 20 73 71 6c 69 74 65 33 55 74 66 38 54 6f nt sqlite3Utf8To
2aab0 38 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 8(unsigned char*
2aac0 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 );.#endif..#ifde
2aad0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
2aae0 52 54 55 41 4c 54 41 42 4c 45 0a 23 20 20 64 65 RTUALTABLE.# de
2aaf0 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
2ab00 43 6c 65 61 72 28 59 29 0a 23 20 20 64 65 66 69 Clear(Y).# defi
2ab10 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 53 79 ne sqlite3VtabSy
2ab20 6e 63 28 58 2c 59 29 20 53 51 4c 49 54 45 5f 4f nc(X,Y) SQLITE_O
2ab30 4b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 K.# define sqli
2ab40 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 te3VtabRollback(
2ab50 58 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c X).# define sql
2ab60 69 74 65 33 56 74 61 62 43 6f 6d 6d 69 74 28 58 ite3VtabCommit(X
2ab70 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 ).# define sqli
2ab80 74 65 33 56 74 61 62 49 6e 53 79 6e 63 28 64 62 te3VtabInSync(db
2ab90 29 20 30 0a 23 20 20 64 65 66 69 6e 65 20 73 71 ) 0.# define sq
2aba0 6c 69 74 65 33 56 74 61 62 4c 6f 63 6b 28 58 29 lite3VtabLock(X)
2abb0 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 .# define sqlit
2abc0 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 58 29 0a e3VtabUnlock(X).
2abd0 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 # define sqlite
2abe0 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 3VtabUnlockList(
2abf0 58 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c X).# define sql
2ac00 69 74 65 33 56 74 61 62 53 61 76 65 70 6f 69 6e ite3VtabSavepoin
2ac10 74 28 58 2c 20 59 2c 20 5a 29 20 53 51 4c 49 54 t(X, Y, Z) SQLIT
2ac20 45 5f 4f 4b 0a 23 20 20 64 65 66 69 6e 65 20 73 E_OK.# define s
2ac30 71 6c 69 74 65 33 47 65 74 56 54 61 62 6c 65 28 qlite3GetVTable(
2ac40 58 2c 59 29 20 20 28 28 56 54 61 62 6c 65 2a 29 X,Y) ((VTable*)
2ac50 30 29 0a 23 65 6c 73 65 0a 20 20 20 76 6f 69 64 0).#else. void
2ac60 20 73 71 6c 69 74 65 33 56 74 61 62 43 6c 65 61 sqlite3VtabClea
2ac70 72 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 54 r(sqlite3 *db, T
2ac80 61 62 6c 65 2a 29 3b 0a 20 20 20 76 6f 69 64 20 able*);. void
2ac90 73 71 6c 69 74 65 33 56 74 61 62 44 69 73 63 6f sqlite3VtabDisco
2aca0 6e 6e 65 63 74 28 73 71 6c 69 74 65 33 20 2a 64 nnect(sqlite3 *d
2acb0 62 2c 20 54 61 62 6c 65 20 2a 70 29 3b 0a 20 20 b, Table *p);.
2acc0 20 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 int sqlite3Vtab
2acd0 53 79 6e 63 28 73 71 6c 69 74 65 33 20 2a 64 62 Sync(sqlite3 *db
2ace0 2c 20 56 64 62 65 2a 29 3b 0a 20 20 20 69 6e 74 , Vdbe*);. int
2acf0 20 73 71 6c 69 74 65 33 56 74 61 62 52 6f 6c 6c sqlite3VtabRoll
2ad00 62 61 63 6b 28 73 71 6c 69 74 65 33 20 2a 64 62 back(sqlite3 *db
2ad10 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 );. int sqlite
2ad20 33 56 74 61 62 43 6f 6d 6d 69 74 28 73 71 6c 69 3VtabCommit(sqli
2ad30 74 65 33 20 2a 64 62 29 3b 0a 20 20 20 76 6f 69 te3 *db);. voi
2ad40 64 20 73 71 6c 69 74 65 33 56 74 61 62 4c 6f 63 d sqlite3VtabLoc
2ad50 6b 28 56 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 k(VTable *);.
2ad60 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 void sqlite3Vtab
2ad70 55 6e 6c 6f 63 6b 28 56 54 61 62 6c 65 20 2a 29 Unlock(VTable *)
2ad80 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ;. void sqlite
2ad90 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 3VtabUnlockList(
2ada0 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 69 6e sqlite3*);. in
2adb0 74 20 73 71 6c 69 74 65 33 56 74 61 62 53 61 76 t sqlite3VtabSav
2adc0 65 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a epoint(sqlite3 *
2add0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 20 , int, int);.
2ade0 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 void sqlite3Vtab
2adf0 49 6d 70 6f 72 74 45 72 72 6d 73 67 28 56 64 62 ImportErrmsg(Vdb
2ae00 65 2a 2c 20 73 71 6c 69 74 65 33 5f 76 74 61 62 e*, sqlite3_vtab
2ae10 2a 29 3b 0a 20 20 20 56 54 61 62 6c 65 20 2a 73 *);. VTable *s
2ae20 71 6c 69 74 65 33 47 65 74 56 54 61 62 6c 65 28 qlite3GetVTable(
2ae30 73 71 6c 69 74 65 33 2a 2c 20 54 61 62 6c 65 2a sqlite3*, Table*
2ae40 29 3b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c );.# define sql
2ae50 69 74 65 33 56 74 61 62 49 6e 53 79 6e 63 28 64 ite3VtabInSync(d
2ae60 62 29 20 28 28 64 62 29 2d 3e 6e 56 54 72 61 6e b) ((db)->nVTran
2ae70 73 3e 30 20 26 26 20 28 64 62 29 2d 3e 61 56 54 s>0 && (db)->aVT
2ae80 72 61 6e 73 3d 3d 30 29 0a 23 65 6e 64 69 66 0a rans==0).#endif.
2ae90 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 45 int sqlite3VtabE
2aea0 70 6f 6e 79 6d 6f 75 73 54 61 62 6c 65 49 6e 69 ponymousTableIni
2aeb0 74 28 50 61 72 73 65 2a 2c 4d 6f 64 75 6c 65 2a t(Parse*,Module*
2aec0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 );.void sqlite3V
2aed0 74 61 62 45 70 6f 6e 79 6d 6f 75 73 54 61 62 6c tabEponymousTabl
2aee0 65 43 6c 65 61 72 28 73 71 6c 69 74 65 33 2a 2c eClear(sqlite3*,
2aef0 4d 6f 64 75 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 Module*);.void s
2af00 71 6c 69 74 65 33 56 74 61 62 4d 61 6b 65 57 72 qlite3VtabMakeWr
2af10 69 74 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 61 itable(Parse*,Ta
2af20 62 6c 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ble*);.void sqli
2af30 74 65 33 56 74 61 62 42 65 67 69 6e 50 61 72 73 te3VtabBeginPars
2af40 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a e(Parse*, Token*
2af50 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a , Token*, Token*
2af60 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
2af70 69 74 65 33 56 74 61 62 46 69 6e 69 73 68 50 61 ite3VtabFinishPa
2af80 72 73 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 rse(Parse*, Toke
2af90 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 n*);.void sqlite
2afa0 33 56 74 61 62 41 72 67 49 6e 69 74 28 50 61 72 3VtabArgInit(Par
2afb0 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
2afc0 65 33 56 74 61 62 41 72 67 45 78 74 65 6e 64 28 e3VtabArgExtend(
2afd0 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b Parse*, Token*);
2afe0 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 .int sqlite3Vtab
2aff0 43 61 6c 6c 43 72 65 61 74 65 28 73 71 6c 69 74 CallCreate(sqlit
2b000 65 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 e3*, int, const
2b010 63 68 61 72 20 2a 2c 20 63 68 61 72 20 2a 2a 29 char *, char **)
2b020 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 ;.int sqlite3Vta
2b030 62 43 61 6c 6c 43 6f 6e 6e 65 63 74 28 50 61 72 bCallConnect(Par
2b040 73 65 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 69 6e se*, Table*);.in
2b050 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c t sqlite3VtabCal
2b060 6c 44 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 lDestroy(sqlite3
2b070 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 *, int, const ch
2b080 61 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ar *);.int sqlit
2b090 65 33 56 74 61 62 42 65 67 69 6e 28 73 71 6c 69 e3VtabBegin(sqli
2b0a0 74 65 33 20 2a 2c 20 56 54 61 62 6c 65 20 2a 29 te3 *, VTable *)
2b0b0 3b 0a 46 75 6e 63 44 65 66 20 2a 73 71 6c 69 74 ;.FuncDef *sqlit
2b0c0 65 33 56 74 61 62 4f 76 65 72 6c 6f 61 64 46 75 e3VtabOverloadFu
2b0d0 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 20 2a nction(sqlite3 *
2b0e0 2c 46 75 6e 63 44 65 66 2a 2c 20 69 6e 74 20 6e ,FuncDef*, int n
2b0f0 41 72 67 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 Arg, Expr*);.voi
2b100 64 20 73 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 d sqlite3Invalid
2b110 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 Function(sqlite3
2b120 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
2b130 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a lite3_value**);.
2b140 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 sqlite3_int64 sq
2b150 6c 69 74 65 33 53 74 6d 74 43 75 72 72 65 6e 74 lite3StmtCurrent
2b160 54 69 6d 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e Time(sqlite3_con
2b170 74 65 78 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 text*);.int sqli
2b180 74 65 33 56 64 62 65 50 61 72 61 6d 65 74 65 72 te3VdbeParameter
2b190 49 6e 64 65 78 28 56 64 62 65 2a 2c 20 63 6f 6e Index(Vdbe*, con
2b1a0 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a st char*, int);.
2b1b0 69 6e 74 20 73 71 6c 69 74 65 33 54 72 61 6e 73 int sqlite3Trans
2b1c0 66 65 72 42 69 6e 64 69 6e 67 73 28 73 71 6c 69 ferBindings(sqli
2b1d0 74 65 33 5f 73 74 6d 74 20 2a 2c 20 73 71 6c 69 te3_stmt *, sqli
2b1e0 74 65 33 5f 73 74 6d 74 20 2a 29 3b 0a 76 6f 69 te3_stmt *);.voi
2b1f0 64 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 d sqlite3ParserR
2b200 65 73 65 74 28 50 61 72 73 65 2a 29 3b 0a 69 6e eset(Parse*);.in
2b210 74 20 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 t sqlite3Reprepa
2b220 72 65 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 re(Vdbe*);.void
2b230 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 sqlite3ExprListC
2b240 68 65 63 6b 4c 65 6e 67 74 68 28 50 61 72 73 65 heckLength(Parse
2b250 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f *, ExprList*, co
2b260 6e 73 74 20 63 68 61 72 2a 29 3b 0a 43 6f 6c 6c nst char*);.Coll
2b270 53 65 71 20 2a 73 71 6c 69 74 65 33 42 69 6e 61 Seq *sqlite3Bina
2b280 72 79 43 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 ryCompareCollSeq
2b290 28 50 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a (Parse *, Expr *
2b2a0 2c 20 45 78 70 72 20 2a 29 3b 0a 69 6e 74 20 73 , Expr *);.int s
2b2b0 71 6c 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f qlite3TempInMemo
2b2c0 72 79 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 ry(const sqlite3
2b2d0 2a 29 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a *);.const char *
2b2e0 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4d 6f sqlite3JournalMo
2b2f0 64 65 6e 61 6d 65 28 69 6e 74 29 3b 0a 23 69 66 dename(int);.#if
2b300 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2b310 5f 57 41 4c 0a 20 20 69 6e 74 20 73 71 6c 69 74 _WAL. int sqlit
2b320 65 33 43 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c e3Checkpoint(sql
2b330 69 74 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c ite3*, int, int,
2b340 20 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 20 20 int*, int*);.
2b350 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 44 65 int sqlite3WalDe
2b360 66 61 75 6c 74 48 6f 6f 6b 28 76 6f 69 64 2a 2c faultHook(void*,
2b370 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 sqlite3*,const c
2b380 68 61 72 2a 2c 69 6e 74 29 3b 0a 23 65 6e 64 69 har*,int);.#endi
2b390 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 f.#ifndef SQLITE
2b3a0 5f 4f 4d 49 54 5f 43 54 45 0a 20 20 57 69 74 68 _OMIT_CTE. With
2b3b0 20 2a 73 71 6c 69 74 65 33 57 69 74 68 41 64 64 *sqlite3WithAdd
2b3c0 28 50 61 72 73 65 2a 2c 57 69 74 68 2a 2c 54 6f (Parse*,With*,To
2b3d0 6b 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 ken*,ExprList*,S
2b3e0 65 6c 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 elect*);. void
2b3f0 73 71 6c 69 74 65 33 57 69 74 68 44 65 6c 65 74 sqlite3WithDelet
2b400 65 28 73 71 6c 69 74 65 33 2a 2c 57 69 74 68 2a e(sqlite3*,With*
2b410 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
2b420 33 57 69 74 68 50 75 73 68 28 50 61 72 73 65 2a 3WithPush(Parse*
2b430 2c 20 57 69 74 68 2a 2c 20 75 38 29 3b 0a 23 65 , With*, u8);.#e
2b440 6c 73 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 lse.#define sqli
2b450 74 65 33 57 69 74 68 50 75 73 68 28 78 2c 79 2c te3WithPush(x,y,
2b460 7a 29 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 z).#define sqlit
2b470 65 33 57 69 74 68 44 65 6c 65 74 65 28 78 2c 79 e3WithDelete(x,y
2b480 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 44 65 63 ).#endif../* Dec
2b490 6c 61 72 61 74 69 6f 6e 73 20 66 6f 72 20 66 75 larations for fu
2b4a0 6e 63 74 69 6f 6e 73 20 69 6e 20 66 6b 65 79 2e nctions in fkey.
2b4b0 63 2e 20 41 6c 6c 20 6f 66 20 74 68 65 73 65 20 c. All of these
2b4c0 61 72 65 20 72 65 70 6c 61 63 65 64 20 62 79 0a are replaced by.
2b4d0 2a 2a 20 6e 6f 2d 6f 70 20 6d 61 63 72 6f 73 20 ** no-op macros
2b4e0 69 66 20 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f if OMIT_FOREIGN_
2b4f0 4b 45 59 20 69 73 20 64 65 66 69 6e 65 64 2e 20 KEY is defined.
2b500 49 6e 20 74 68 69 73 20 63 61 73 65 20 6e 6f 20 In this case no
2b510 66 6f 72 65 69 67 6e 0a 2a 2a 20 6b 65 79 20 66 foreign.** key f
2b520 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 20 unctionality is
2b530 61 76 61 69 6c 61 62 6c 65 2e 20 49 66 20 4f 4d available. If OM
2b540 49 54 5f 54 52 49 47 47 45 52 20 69 73 20 64 65 IT_TRIGGER is de
2b550 66 69 6e 65 64 20 62 75 74 0a 2a 2a 20 4f 4d 49 fined but.** OMI
2b560 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 20 69 73 T_FOREIGN_KEY is
2b570 20 6e 6f 74 2c 20 6f 6e 6c 79 20 73 6f 6d 65 20 not, only some
2b580 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 73 of the functions
2b590 20 61 72 65 20 6e 6f 2d 6f 70 65 64 2e 20 49 6e are no-oped. In
2b5a0 0a 2a 2a 20 74 68 69 73 20 63 61 73 65 20 66 6f .** this case fo
2b5b0 72 65 69 67 6e 20 6b 65 79 73 20 61 72 65 20 70 reign keys are p
2b5c0 61 72 73 65 64 2c 20 62 75 74 20 6e 6f 20 6f 74 arsed, but no ot
2b5d0 68 65 72 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 her functionalit
2b5e0 79 20 69 73 0a 2a 2a 20 70 72 6f 76 69 64 65 64 y is.** provided
2b5f0 20 28 65 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66 (enforcement of
2b600 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 FK constraints
2b610 72 65 71 75 69 72 65 73 20 74 68 65 20 74 72 69 requires the tri
2b620 67 67 65 72 73 20 73 75 62 2d 73 79 73 74 65 6d ggers sub-system
2b630 29 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e )..*/.#if !defin
2b640 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 ed(SQLITE_OMIT_F
2b650 4f 52 45 49 47 4e 5f 4b 45 59 29 20 26 26 20 21 OREIGN_KEY) && !
2b660 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
2b670 4d 49 54 5f 54 52 49 47 47 45 52 29 0a 20 20 76 MIT_TRIGGER). v
2b680 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 43 68 65 oid sqlite3FkChe
2b690 63 6b 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 ck(Parse*, Table
2b6a0 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 *, int, int, int
2b6b0 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 *, int);. void
2b6c0 73 71 6c 69 74 65 33 46 6b 44 72 6f 70 54 61 62 sqlite3FkDropTab
2b6d0 6c 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 le(Parse*, SrcLi
2b6e0 73 74 20 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 st *, Table*);.
2b6f0 20 76 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 41 void sqlite3FkA
2b700 63 74 69 6f 6e 73 28 50 61 72 73 65 2a 2c 20 54 ctions(Parse*, T
2b710 61 62 6c 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a able*, ExprList*
2b720 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 , int, int*, int
2b730 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
2b740 46 6b 52 65 71 75 69 72 65 64 28 50 61 72 73 65 FkRequired(Parse
2b750 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2a 2c *, Table*, int*,
2b760 20 69 6e 74 29 3b 0a 20 20 75 33 32 20 73 71 6c int);. u32 sql
2b770 69 74 65 33 46 6b 4f 6c 64 6d 61 73 6b 28 50 61 ite3FkOldmask(Pa
2b780 72 73 65 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 rse*, Table*);.
2b790 20 46 4b 65 79 20 2a 73 71 6c 69 74 65 33 46 6b FKey *sqlite3Fk
2b7a0 52 65 66 65 72 65 6e 63 65 73 28 54 61 62 6c 65 References(Table
2b7b0 20 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 *);.#else. #de
2b7c0 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 41 63 fine sqlite3FkAc
2b7d0 74 69 6f 6e 73 28 61 2c 62 2c 63 2c 64 2c 65 2c tions(a,b,c,d,e,
2b7e0 66 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c f). #define sql
2b7f0 69 74 65 33 46 6b 43 68 65 63 6b 28 61 2c 62 2c ite3FkCheck(a,b,
2b800 63 2c 64 2c 65 2c 66 29 0a 20 20 23 64 65 66 69 c,d,e,f). #defi
2b810 6e 65 20 73 71 6c 69 74 65 33 46 6b 44 72 6f 70 ne sqlite3FkDrop
2b820 54 61 62 6c 65 28 61 2c 62 2c 63 29 0a 20 20 23 Table(a,b,c). #
2b830 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b define sqlite3Fk
2b840 4f 6c 64 6d 61 73 6b 28 61 2c 62 29 20 20 20 20 Oldmask(a,b)
2b850 20 20 20 20 20 30 0a 20 20 23 64 65 66 69 6e 65 0. #define
2b860 20 73 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72 sqlite3FkRequir
2b870 65 64 28 61 2c 62 2c 63 2c 64 29 20 20 20 20 30 ed(a,b,c,d) 0
2b880 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
2b890 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 SQLITE_OMIT_FORE
2b8a0 49 47 4e 5f 4b 45 59 0a 20 20 76 6f 69 64 20 73 IGN_KEY. void s
2b8b0 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 28 73 qlite3FkDelete(s
2b8c0 71 6c 69 74 65 33 20 2a 2c 20 54 61 62 6c 65 2a qlite3 *, Table*
2b8d0 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
2b8e0 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 50 61 FkLocateIndex(Pa
2b8f0 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 46 4b 65 79 rse*,Table*,FKey
2b900 2a 2c 49 6e 64 65 78 2a 2a 2c 69 6e 74 2a 2a 29 *,Index**,int**)
2b910 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e ;.#else. #defin
2b920 65 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 e sqlite3FkDelet
2b930 65 28 61 2c 62 29 0a 20 20 23 64 65 66 69 6e 65 e(a,b). #define
2b940 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 sqlite3FkLocate
2b950 49 6e 64 65 78 28 61 2c 62 2c 63 2c 64 2c 65 29 Index(a,b,c,d,e)
2b960 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 .#endif.../*.**
2b970 41 76 61 69 6c 61 62 6c 65 20 66 61 75 6c 74 20 Available fault
2b980 69 6e 6a 65 63 74 6f 72 73 2e 20 20 53 68 6f 75 injectors. Shou
2b990 6c 64 20 62 65 20 6e 75 6d 62 65 72 65 64 20 62 ld be numbered b
2b9a0 65 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 30 2e eginning with 0.
2b9b0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .*/.#define SQLI
2b9c0 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 4f 52 TE_FAULTINJECTOR
2b9d0 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 30 0a 23 64 _MALLOC 0.#d
2b9e0 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 41 55 efine SQLITE_FAU
2b9f0 4c 54 49 4e 4a 45 43 54 4f 52 5f 43 4f 55 4e 54 LTINJECTOR_COUNT
2ba00 20 20 20 20 20 20 31 0a 0a 2f 2a 0a 2a 2a 20 54 1../*.** T
2ba10 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 he interface to
2ba20 74 68 65 20 63 6f 64 65 20 69 6e 20 66 61 75 6c the code in faul
2ba30 74 2e 63 20 75 73 65 64 20 66 6f 72 20 69 64 65 t.c used for ide
2ba40 6e 74 69 66 79 69 6e 67 20 22 62 65 6e 69 67 6e ntifying "benign
2ba50 22 0a 2a 2a 20 6d 61 6c 6c 6f 63 20 66 61 69 6c ".** malloc fail
2ba60 75 72 65 73 2e 20 54 68 69 73 20 69 73 20 6f 6e ures. This is on
2ba70 6c 79 20 70 72 65 73 65 6e 74 20 69 66 20 53 51 ly present if SQ
2ba80 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 LITE_OMIT_BUILTI
2ba90 4e 5f 54 45 53 54 0a 2a 2a 20 69 73 20 6e 6f 74 N_TEST.** is not
2baa0 20 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66 defined..*/.#if
2bab0 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
2bac0 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 20 20 _BUILTIN_TEST.
2bad0 76 6f 69 64 20 73 71 6c 69 74 65 33 42 65 67 69 void sqlite3Begi
2bae0 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 76 6f nBenignMalloc(vo
2baf0 69 64 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 id);. void sqli
2bb00 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c te3EndBenignMall
2bb10 6f 63 28 76 6f 69 64 29 3b 0a 23 65 6c 73 65 0a oc(void);.#else.
2bb20 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
2bb30 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 3BeginBenignMall
2bb40 6f 63 28 29 0a 20 20 23 64 65 66 69 6e 65 20 73 oc(). #define s
2bb50 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d qlite3EndBenignM
2bb60 61 6c 6c 6f 63 28 29 0a 23 65 6e 64 69 66 0a 0a alloc().#endif..
2bb70 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 72 65 /*.** Allowed re
2bb80 74 75 72 6e 20 76 61 6c 75 65 73 20 66 72 6f 6d turn values from
2bb90 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 49 6e sqlite3FindInIn
2bba0 64 65 78 28 29 0a 2a 2f 0a 23 64 65 66 69 6e 65 dex().*/.#define
2bbb0 20 49 4e 5f 49 4e 44 45 58 5f 52 4f 57 49 44 20 IN_INDEX_ROWID
2bbc0 20 20 20 20 20 20 20 31 20 20 20 2f 2a 20 53 65 1 /* Se
2bbd0 61 72 63 68 20 74 68 65 20 72 6f 77 69 64 20 6f arch the rowid o
2bbe0 66 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 23 f the table */.#
2bbf0 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f define IN_INDEX_
2bc00 45 50 48 20 20 20 20 20 20 20 20 20 20 32 20 20 EPH 2
2bc10 20 2f 2a 20 53 65 61 72 63 68 20 61 6e 20 65 70 /* Search an ep
2bc20 68 65 6d 65 72 61 6c 20 62 2d 74 72 65 65 20 2a hemeral b-tree *
2bc30 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 /.#define IN_IND
2bc40 45 58 5f 49 4e 44 45 58 5f 41 53 43 20 20 20 20 EX_INDEX_ASC
2bc50 33 20 20 20 2f 2a 20 45 78 69 73 74 69 6e 67 20 3 /* Existing
2bc60 69 6e 64 65 78 20 41 53 43 45 4e 44 49 4e 47 20 index ASCENDING
2bc70 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e */.#define IN_IN
2bc80 44 45 58 5f 49 4e 44 45 58 5f 44 45 53 43 20 20 DEX_INDEX_DESC
2bc90 20 34 20 20 20 2f 2a 20 45 78 69 73 74 69 6e 67 4 /* Existing
2bca0 20 69 6e 64 65 78 20 44 45 53 43 45 4e 44 49 4e index DESCENDIN
2bcb0 47 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f G */.#define IN_
2bcc0 49 4e 44 45 58 5f 4e 4f 4f 50 20 20 20 20 20 20 INDEX_NOOP
2bcd0 20 20 20 35 20 20 20 2f 2a 20 4e 6f 20 74 61 62 5 /* No tab
2bce0 6c 65 20 61 76 61 69 6c 61 62 6c 65 2e 20 55 73 le available. Us
2bcf0 65 20 63 6f 6d 70 61 72 69 73 6f 6e 73 20 2a 2f e comparisons */
2bd00 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 66 ./*.** Allowed f
2bd10 6c 61 67 73 20 66 6f 72 20 74 68 65 20 33 72 64 lags for the 3rd
2bd20 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 73 71 parameter to sq
2bd30 6c 69 74 65 33 46 69 6e 64 49 6e 49 6e 64 65 78 lite3FindInIndex
2bd40 28 29 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 ()..*/.#define I
2bd50 4e 5f 49 4e 44 45 58 5f 4e 4f 4f 50 5f 4f 4b 20 N_INDEX_NOOP_OK
2bd60 20 20 20 20 30 78 30 30 30 31 20 20 2f 2a 20 4f 0x0001 /* O
2bd70 4b 20 74 6f 20 72 65 74 75 72 6e 20 49 4e 5f 49 K to return IN_I
2bd80 4e 44 45 58 5f 4e 4f 4f 50 20 2a 2f 0a 23 64 65 NDEX_NOOP */.#de
2bd90 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 4d 45 fine IN_INDEX_ME
2bda0 4d 42 45 52 53 48 49 50 20 20 30 78 30 30 30 32 MBERSHIP 0x0002
2bdb0 20 20 2f 2a 20 49 4e 20 6f 70 65 72 61 74 6f 72 /* IN operator
2bdc0 20 75 73 65 64 20 66 6f 72 20 6d 65 6d 62 65 72 used for member
2bdd0 73 68 69 70 20 74 65 73 74 20 2a 2f 0a 23 64 65 ship test */.#de
2bde0 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 4c 4f fine IN_INDEX_LO
2bdf0 4f 50 20 20 20 20 20 20 20 20 30 78 30 30 30 34 OP 0x0004
2be00 20 20 2f 2a 20 49 4e 20 6f 70 65 72 61 74 6f 72 /* IN operator
2be10 20 75 73 65 64 20 61 73 20 61 20 6c 6f 6f 70 20 used as a loop
2be20 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 */.int sqlite3Fi
2be30 6e 64 49 6e 49 6e 64 65 78 28 50 61 72 73 65 20 ndInIndex(Parse
2be40 2a 2c 20 45 78 70 72 20 2a 2c 20 75 33 32 2c 20 *, Expr *, u32,
2be50 69 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 0a 69 6e int*, int*);..in
2be60 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c t sqlite3Journal
2be70 4f 70 65 6e 28 73 71 6c 69 74 65 33 5f 76 66 73 Open(sqlite3_vfs
2be80 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a *, const char *
2be90 2c 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a , sqlite3_file *
2bea0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 69 6e 74 , int, int);.int
2beb0 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 sqlite3JournalS
2bec0 69 7a 65 28 73 71 6c 69 74 65 33 5f 76 66 73 20 ize(sqlite3_vfs
2bed0 2a 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 *);.#ifdef SQLIT
2bee0 45 5f 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f E_ENABLE_ATOMIC_
2bef0 57 52 49 54 45 0a 20 20 69 6e 74 20 73 71 6c 69 WRITE. int sqli
2bf00 74 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 te3JournalCreate
2bf10 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 (sqlite3_file *)
2bf20 3b 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 ;.#endif..int sq
2bf30 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 49 73 49 6e lite3JournalIsIn
2bf40 4d 65 6d 6f 72 79 28 73 71 6c 69 74 65 33 5f 66 Memory(sqlite3_f
2bf50 69 6c 65 20 2a 70 29 3b 0a 76 6f 69 64 20 73 71 ile *p);.void sq
2bf60 6c 69 74 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c 4f lite3MemJournalO
2bf70 70 65 6e 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 pen(sqlite3_file
2bf80 20 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 *);..void sqlit
2bf90 65 33 45 78 70 72 53 65 74 48 65 69 67 68 74 41 e3ExprSetHeightA
2bfa0 6e 64 46 6c 61 67 73 28 50 61 72 73 65 20 2a 70 ndFlags(Parse *p
2bfb0 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 29 3b Parse, Expr *p);
2bfc0 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
2bfd0 45 58 50 52 5f 44 45 50 54 48 3e 30 0a 20 20 69 EXPR_DEPTH>0. i
2bfe0 6e 74 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 nt sqlite3Select
2bff0 45 78 70 72 48 65 69 67 68 74 28 53 65 6c 65 63 ExprHeight(Selec
2c000 74 20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 t *);. int sqli
2c010 74 65 33 45 78 70 72 43 68 65 63 6b 48 65 69 67 te3ExprCheckHeig
2c020 68 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b ht(Parse*, int);
2c030 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
2c040 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 45 78 sqlite3SelectEx
2c050 70 72 48 65 69 67 68 74 28 78 29 20 30 0a 20 20 prHeight(x) 0.
2c060 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 #define sqlite3E
2c070 78 70 72 43 68 65 63 6b 48 65 69 67 68 74 28 78 xprCheckHeight(x
2c080 2c 79 29 0a 23 65 6e 64 69 66 0a 0a 75 33 32 20 ,y).#endif..u32
2c090 73 71 6c 69 74 65 33 47 65 74 34 62 79 74 65 28 sqlite3Get4byte(
2c0a0 63 6f 6e 73 74 20 75 38 2a 29 3b 0a 76 6f 69 64 const u8*);.void
2c0b0 20 73 71 6c 69 74 65 33 50 75 74 34 62 79 74 65 sqlite3Put4byte
2c0c0 28 75 38 2a 2c 20 75 33 32 29 3b 0a 0a 23 69 66 (u8*, u32);..#if
2c0d0 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
2c0e0 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 0a E_UNLOCK_NOTIFY.
2c0f0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
2c100 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 nnectionBlocked(
2c110 73 71 6c 69 74 65 33 20 2a 2c 20 73 71 6c 69 74 sqlite3 *, sqlit
2c120 65 33 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 e3 *);. void sq
2c130 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 lite3ConnectionU
2c140 6e 6c 6f 63 6b 65 64 28 73 71 6c 69 74 65 33 20 nlocked(sqlite3
2c150 2a 64 62 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c *db);. void sql
2c160 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c ite3ConnectionCl
2c170 6f 73 65 64 28 73 71 6c 69 74 65 33 20 2a 64 62 osed(sqlite3 *db
2c180 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 );.#else. #defi
2c190 6e 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 ne sqlite3Connec
2c1a0 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 78 2c 79 29 tionBlocked(x,y)
2c1b0 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
2c1c0 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c 6f e3ConnectionUnlo
2c1d0 63 6b 65 64 28 78 29 0a 20 20 23 64 65 66 69 6e cked(x). #defin
2c1e0 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 e sqlite3Connect
2c1f0 69 6f 6e 43 6c 6f 73 65 64 28 78 29 0a 23 65 6e ionClosed(x).#en
2c200 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
2c210 54 45 5f 44 45 42 55 47 0a 20 20 76 6f 69 64 20 TE_DEBUG. void
2c220 73 71 6c 69 74 65 33 50 61 72 73 65 72 54 72 61 sqlite3ParserTra
2c230 63 65 28 46 49 4c 45 2a 2c 20 63 68 61 72 20 2a ce(FILE*, char *
2c240 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a );.#endif../*.**
2c250 20 49 66 20 74 68 65 20 53 51 4c 49 54 45 5f 45 If the SQLITE_E
2c260 4e 41 42 4c 45 20 49 4f 54 52 41 43 45 20 65 78 NABLE IOTRACE ex
2c270 69 73 74 73 20 74 68 65 6e 20 74 68 65 20 67 6c ists then the gl
2c280 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 0a 2a 2a obal variable.**
2c290 20 73 71 6c 69 74 65 33 49 6f 54 72 61 63 65 20 sqlite3IoTrace
2c2a0 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
2c2b0 61 20 70 72 69 6e 74 66 2d 6c 69 6b 65 20 72 6f a printf-like ro
2c2c0 75 74 69 6e 65 20 75 73 65 64 20 74 6f 0a 2a 2a utine used to.**
2c2d0 20 70 72 69 6e 74 20 49 2f 4f 20 74 72 61 63 69 print I/O traci
2c2e0 6e 67 20 6d 65 73 73 61 67 65 73 2e 0a 2a 2f 0a ng messages..*/.
2c2f0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
2c300 41 42 4c 45 5f 49 4f 54 52 41 43 45 0a 23 20 64 ABLE_IOTRACE.# d
2c310 65 66 69 6e 65 20 49 4f 54 52 41 43 45 28 41 29 efine IOTRACE(A)
2c320 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 6f 54 if( sqlite3IoT
2c330 72 61 63 65 20 29 7b 20 73 71 6c 69 74 65 33 49 race ){ sqlite3I
2c340 6f 54 72 61 63 65 20 41 3b 20 7d 0a 20 20 76 6f oTrace A; }. vo
2c350 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f id sqlite3VdbeIO
2c360 54 72 61 63 65 53 71 6c 28 56 64 62 65 2a 29 3b TraceSql(Vdbe*);
2c370 0a 53 51 4c 49 54 45 5f 41 50 49 20 53 51 4c 49 .SQLITE_API SQLI
2c380 54 45 5f 45 58 54 45 52 4e 20 76 6f 69 64 20 28 TE_EXTERN void (
2c390 53 51 4c 49 54 45 5f 43 44 45 43 4c 20 2a 73 71 SQLITE_CDECL *sq
2c3a0 6c 69 74 65 33 49 6f 54 72 61 63 65 29 28 63 6f lite3IoTrace)(co
2c3b0 6e 73 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a nst char*,...);.
2c3c0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 49 #else.# define I
2c3d0 4f 54 52 41 43 45 28 41 29 0a 23 20 64 65 66 69 OTRACE(A).# defi
2c3e0 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f ne sqlite3VdbeIO
2c3f0 54 72 61 63 65 53 71 6c 28 58 29 0a 23 65 6e 64 TraceSql(X).#end
2c400 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 if../*.** These
2c410 72 6f 75 74 69 6e 65 73 20 61 72 65 20 61 76 61 routines are ava
2c420 69 6c 61 62 6c 65 20 66 6f 72 20 74 68 65 20 6d ilable for the m
2c430 65 6d 32 2e 63 20 64 65 62 75 67 67 69 6e 67 20 em2.c debugging
2c440 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 memory allocator
2c450 0a 2a 2a 20 6f 6e 6c 79 2e 20 20 54 68 65 79 20 .** only. They
2c460 61 72 65 20 75 73 65 64 20 74 6f 20 76 65 72 69 are used to veri
2c470 66 79 20 74 68 61 74 20 64 69 66 66 65 72 65 6e fy that differen
2c480 74 20 22 74 79 70 65 73 22 20 6f 66 20 6d 65 6d t "types" of mem
2c490 6f 72 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f ory.** allocatio
2c4a0 6e 73 20 61 72 65 20 70 72 6f 70 65 72 6c 79 20 ns are properly
2c4b0 74 72 61 63 6b 65 64 20 62 79 20 74 68 65 20 73 tracked by the s
2c4c0 79 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c ystem..**.** sql
2c4d0 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 ite3MemdebugSetT
2c4e0 79 70 65 28 29 20 73 65 74 73 20 74 68 65 20 22 ype() sets the "
2c4f0 74 79 70 65 22 20 6f 66 20 61 6e 20 61 6c 6c 6f type" of an allo
2c500 63 61 74 69 6f 6e 20 74 6f 20 6f 6e 65 20 6f 66 cation to one of
2c510 0a 2a 2a 20 74 68 65 20 4d 45 4d 54 59 50 45 5f .** the MEMTYPE_
2c520 2a 20 6d 61 63 72 6f 73 20 64 65 66 69 6e 65 64 * macros defined
2c530 20 62 65 6c 6f 77 2e 20 20 54 68 65 20 74 79 70 below. The typ
2c540 65 20 6d 75 73 74 20 62 65 20 61 20 62 69 74 6d e must be a bitm
2c550 61 73 6b 20 77 69 74 68 0a 2a 2a 20 61 20 73 69 ask with.** a si
2c560 6e 67 6c 65 20 62 69 74 20 73 65 74 2e 0a 2a 2a ngle bit set..**
2c570 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
2c580 62 75 67 48 61 73 54 79 70 65 28 29 20 72 65 74 bugHasType() ret
2c590 75 72 6e 73 20 74 72 75 65 20 69 66 20 61 6e 79 urns true if any
2c5a0 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 of the bits in
2c5b0 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 its second.** ar
2c5c0 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 gument match the
2c5d0 20 74 79 70 65 20 73 65 74 20 62 79 20 74 68 65 type set by the
2c5e0 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 previous sqlite
2c5f0 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 3MemdebugSetType
2c600 28 29 2e 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 ()..** sqlite3Me
2c610 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 29 20 mdebugHasType()
2c620 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 is intended for
2c630 75 73 65 20 69 6e 73 69 64 65 20 61 73 73 65 72 use inside asser
2c640 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a t() statements..
2c650 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d **.** sqlite3Mem
2c660 64 65 62 75 67 4e 6f 54 79 70 65 28 29 20 72 65 debugNoType() re
2c670 74 75 72 6e 73 20 74 72 75 65 20 69 66 20 6e 6f turns true if no
2c680 6e 65 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 ne of the bits i
2c690 6e 20 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 n its second.**
2c6a0 61 72 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 argument match t
2c6b0 68 65 20 74 79 70 65 20 73 65 74 20 62 79 20 74 he type set by t
2c6c0 68 65 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 he previous sqli
2c6d0 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 te3MemdebugSetTy
2c6e0 70 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 72 68 pe()..**.** Perh
2c6f0 61 70 73 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 aps the most imp
2c700 6f 72 74 61 6e 74 20 70 6f 69 6e 74 20 69 73 20 ortant point is
2c710 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 the difference b
2c720 65 74 77 65 65 6e 20 4d 45 4d 54 59 50 45 5f 48 etween MEMTYPE_H
2c730 45 41 50 0a 2a 2a 20 61 6e 64 20 4d 45 4d 54 59 EAP.** and MEMTY
2c740 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 2e 20 20 49 PE_LOOKASIDE. I
2c750 66 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 f an allocation
2c760 69 73 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 is MEMTYPE_LOOKA
2c770 53 49 44 45 2c 20 74 68 61 74 20 6d 65 61 6e 73 SIDE, that means
2c780 0a 2a 2a 20 69 74 20 6d 69 67 68 74 20 68 61 76 .** it might hav
2c790 65 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 e been allocated
2c7a0 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 2c 20 65 by lookaside, e
2c7b0 78 63 65 70 74 20 74 68 65 20 61 6c 6c 6f 63 61 xcept the alloca
2c7c0 74 69 6f 6e 20 77 61 73 0a 2a 2a 20 74 6f 6f 20 tion was.** too
2c7d0 6c 61 72 67 65 20 6f 72 20 6c 6f 6f 6b 61 73 69 large or lookasi
2c7e0 64 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 66 de was already f
2c7f0 75 6c 6c 2e 20 20 49 74 20 69 73 20 69 6d 70 6f ull. It is impo
2c800 72 74 61 6e 74 20 74 6f 20 76 65 72 69 66 79 0a rtant to verify.
2c810 2a 2a 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 69 ** that allocati
2c820 6f 6e 73 20 74 68 61 74 20 6d 69 67 68 74 20 68 ons that might h
2c830 61 76 65 20 62 65 65 6e 20 73 61 74 69 73 66 69 ave been satisfi
2c840 65 64 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 20 ed by lookaside
2c850 61 72 65 20 6e 6f 74 0a 2a 2a 20 70 61 73 73 65 are not.** passe
2c860 64 20 62 61 63 6b 20 74 6f 20 6e 6f 6e 2d 6c 6f d back to non-lo
2c870 6f 6b 61 73 69 64 65 20 66 72 65 65 28 29 20 72 okaside free() r
2c880 6f 75 74 69 6e 65 73 2e 20 20 41 73 73 65 72 74 outines. Assert
2c890 73 20 73 75 63 68 20 61 73 20 74 68 65 0a 2a 2a s such as the.**
2c8a0 20 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 20 61 example above a
2c8b0 72 65 20 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 re placed on the
2c8c0 20 6e 6f 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 non-lookaside f
2c8d0 72 65 65 28 29 20 72 6f 75 74 69 6e 65 73 20 74 ree() routines t
2c8e0 6f 20 76 65 72 69 66 79 0a 2a 2a 20 74 68 69 73 o verify.** this
2c8f0 20 63 6f 6e 73 74 72 61 69 6e 74 2e 0a 2a 2a 0a constraint..**.
2c900 2a 2a 20 41 6c 6c 20 6f 66 20 74 68 69 73 20 69 ** All of this i
2c910 73 20 6e 6f 2d 6f 70 20 66 6f 72 20 61 20 70 72 s no-op for a pr
2c920 6f 64 75 63 74 69 6f 6e 20 62 75 69 6c 64 2e 20 oduction build.
2c930 20 49 74 20 6f 6e 6c 79 20 63 6f 6d 65 73 20 69 It only comes i
2c940 6e 74 6f 0a 2a 2a 20 70 6c 61 79 20 77 68 65 6e nto.** play when
2c950 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44 the SQLITE_MEMD
2c960 45 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74 69 6d EBUG compile-tim
2c970 65 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 e option is used
2c980 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
2c990 54 45 5f 4d 45 4d 44 45 42 55 47 0a 20 20 76 6f TE_MEMDEBUG. vo
2c9a0 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 id sqlite3Memdeb
2c9b0 75 67 53 65 74 54 79 70 65 28 76 6f 69 64 2a 2c ugSetType(void*,
2c9c0 75 38 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 u8);. int sqlit
2c9d0 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 e3MemdebugHasTyp
2c9e0 65 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 69 e(void*,u8);. i
2c9f0 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 nt sqlite3Memdeb
2ca00 75 67 4e 6f 54 79 70 65 28 76 6f 69 64 2a 2c 75 ugNoType(void*,u
2ca10 38 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 8);.#else.# defi
2ca20 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 ne sqlite3Memdeb
2ca30 75 67 53 65 74 54 79 70 65 28 58 2c 59 29 20 20 ugSetType(X,Y)
2ca40 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 64 65 /* no-op */.# de
2ca50 66 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 fine sqlite3Memd
2ca60 65 62 75 67 48 61 73 54 79 70 65 28 58 2c 59 29 ebugHasType(X,Y)
2ca70 20 20 31 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 1.# define sql
2ca80 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 ite3MemdebugNoTy
2ca90 70 65 28 58 2c 59 29 20 20 20 31 0a 23 65 6e 64 pe(X,Y) 1.#end
2caa0 69 66 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 if.#define MEMTY
2cab0 50 45 5f 48 45 41 50 20 20 20 20 20 20 20 30 78 PE_HEAP 0x
2cac0 30 31 20 20 2f 2a 20 47 65 6e 65 72 61 6c 20 68 01 /* General h
2cad0 65 61 70 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 eap allocations
2cae0 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 */.#define MEMTY
2caf0 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 20 30 78 PE_LOOKASIDE 0x
2cb00 30 32 20 20 2f 2a 20 48 65 61 70 20 74 68 61 74 02 /* Heap that
2cb10 20 6d 69 67 68 74 20 68 61 76 65 20 62 65 65 6e might have been
2cb20 20 6c 6f 6f 6b 61 73 69 64 65 20 2a 2f 0a 23 64 lookaside */.#d
2cb30 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f 53 43 efine MEMTYPE_SC
2cb40 52 41 54 43 48 20 20 20 20 30 78 30 34 20 20 2f RATCH 0x04 /
2cb50 2a 20 53 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 * Scratch alloca
2cb60 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 tions */.#define
2cb70 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 20 MEMTYPE_PCACHE
2cb80 20 20 20 20 30 78 30 38 20 20 2f 2a 20 50 61 67 0x08 /* Pag
2cb90 65 20 63 61 63 68 65 20 61 6c 6c 6f 63 61 74 69 e cache allocati
2cba0 6f 6e 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 ons */../*.** Th
2cbb0 72 65 61 64 69 6e 67 20 69 6e 74 65 72 66 61 63 reading interfac
2cbc0 65 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f e.*/.#if SQLITE_
2cbd0 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 MAX_WORKER_THREA
2cbe0 44 53 3e 30 0a 69 6e 74 20 73 71 6c 69 74 65 33 DS>0.int sqlite3
2cbf0 54 68 72 65 61 64 43 72 65 61 74 65 28 53 51 4c ThreadCreate(SQL
2cc00 69 74 65 54 68 72 65 61 64 2a 2a 2c 76 6f 69 64 iteThread**,void
2cc10 2a 28 2a 29 28 76 6f 69 64 2a 29 2c 76 6f 69 64 *(*)(void*),void
2cc20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 *);.int sqlite3T
2cc30 68 72 65 61 64 4a 6f 69 6e 28 53 51 4c 69 74 65 hreadJoin(SQLite
2cc40 54 68 72 65 61 64 2a 2c 20 76 6f 69 64 2a 2a 29 Thread*, void**)
2cc50 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 65 ;.#endif..#if de
2cc60 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
2cc70 42 4c 45 5f 44 42 53 54 41 54 5f 56 54 41 42 29 BLE_DBSTAT_VTAB)
2cc80 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 || defined(SQLI
2cc90 54 45 5f 54 45 53 54 29 0a 69 6e 74 20 73 71 6c TE_TEST).int sql
2cca0 69 74 65 33 44 62 73 74 61 74 52 65 67 69 73 74 ite3DbstatRegist
2ccb0 65 72 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 er(sqlite3*);.#e
2ccc0 6e 64 69 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 ndif..int sqlite
2ccd0 33 45 78 70 72 56 65 63 74 6f 72 53 69 7a 65 28 3ExprVectorSize(
2cce0 45 78 70 72 20 2a 70 45 78 70 72 29 3b 0a 69 6e Expr *pExpr);.in
2ccf0 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 73 56 t sqlite3ExprIsV
2cd00 65 63 74 6f 72 28 45 78 70 72 20 2a 70 45 78 70 ector(Expr *pExp
2cd10 72 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 r);.Expr *sqlite
2cd20 33 56 65 63 74 6f 72 46 69 65 6c 64 53 75 62 65 3VectorFieldSube
2cd30 78 70 72 28 45 78 70 72 2a 2c 20 69 6e 74 29 3b xpr(Expr*, int);
2cd40 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 .Expr *sqlite3Ex
2cd50 70 72 46 6f 72 56 65 63 74 6f 72 46 69 65 6c 64 prForVectorField
2cd60 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c 69 6e (Parse*,Expr*,in
2cd70 74 29 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53 t);..#endif /* S
2cd80 51 4c 49 54 45 49 4e 54 5f 48 20 2a 2f 0a QLITEINT_H */.