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 6e 63 6c ite..**.*/.#incl
01b0: 75 64 65 20 22 73 71 6c 69 74 65 33 2e 68 22 0a ude "sqlite3.h".
01c0: 23 69 66 6e 64 65 66 20 5f 53 51 4c 49 54 45 49 #ifndef _SQLITEI
01d0: 4e 54 5f 48 5f 0a 23 64 65 66 69 6e 65 20 5f 53 NT_H_.#define _S
01e0: 51 4c 49 54 45 49 4e 54 5f 48 5f 0a 0a 2f 2a 0a QLITEINT_H_../*.
01f0: 2a 2a 20 54 68 65 73 65 20 23 64 65 66 69 6e 65 ** These #define
0200: 73 20 73 68 6f 75 6c 64 20 65 6e 61 62 6c 65 20 s should enable
0210: 3e 32 47 42 20 66 69 6c 65 20 73 75 70 70 6f 72 >2GB file suppor
0220: 74 20 6f 6e 20 50 4f 53 49 58 20 69 66 20 74 68 t on POSIX if th
0230: 65 0a 2a 2a 20 75 6e 64 65 72 6c 79 69 6e 67 20 e.** underlying
0240: 6f 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d operating system
0250: 20 73 75 70 70 6f 72 74 73 20 69 74 2e 20 20 49 supports it. I
0260: 66 20 74 68 65 20 4f 53 20 6c 61 63 6b 73 0a 2a f the OS lacks.*
0270: 2a 20 6c 61 72 67 65 20 66 69 6c 65 20 73 75 70 * large file sup
0280: 70 6f 72 74 2c 20 6f 72 20 69 66 20 74 68 65 20 port, or if the
0290: 4f 53 20 69 73 20 77 69 6e 64 6f 77 73 2c 20 74 OS is windows, t
02a0: 68 65 73 65 20 73 68 6f 75 6c 64 20 62 65 20 6e hese should be n
02b0: 6f 2d 6f 70 73 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 o-ops..**.** Tic
02c0: 6b 65 74 20 23 32 37 33 39 3a 20 20 54 68 65 20 ket #2739: The
02d0: 5f 4c 41 52 47 45 46 49 4c 45 5f 53 4f 55 52 43 _LARGEFILE_SOURC
02e0: 45 20 6d 61 63 72 6f 20 6d 75 73 74 20 61 70 70 E macro must app
02f0: 65 61 72 20 62 65 66 6f 72 65 20 61 6e 79 0a 2a ear before any.*
0300: 2a 20 73 79 73 74 65 6d 20 23 69 6e 63 6c 75 64 * system #includ
0310: 65 73 2e 20 20 48 65 6e 63 65 2c 20 74 68 69 73 es. Hence, this
0320: 20 62 6c 6f 63 6b 20 6f 66 20 63 6f 64 65 20 6d block of code m
0330: 75 73 74 20 62 65 20 74 68 65 20 76 65 72 79 20 ust be the very
0340: 66 69 72 73 74 0a 2a 2a 20 63 6f 64 65 20 69 6e first.** code in
0350: 20 61 6c 6c 20 73 6f 75 72 63 65 20 66 69 6c 65 all source file
0360: 73 2e 0a 2a 2a 0a 2a 2a 20 4c 61 72 67 65 20 66 s..**.** Large f
0370: 69 6c 65 20 73 75 70 70 6f 72 74 20 63 61 6e 20 ile support can
0380: 62 65 20 64 69 73 61 62 6c 65 64 20 75 73 69 6e be disabled usin
0390: 67 20 74 68 65 20 2d 44 53 51 4c 49 54 45 5f 44 g the -DSQLITE_D
03a0: 49 53 41 42 4c 45 5f 4c 46 53 20 73 77 69 74 63 ISABLE_LFS switc
03b0: 68 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 6f 6d 70 h.** on the comp
03c0: 69 6c 65 72 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e iler command lin
03d0: 65 2e 20 20 54 68 69 73 20 69 73 20 6e 65 63 65 e. This is nece
03e0: 73 73 61 72 79 20 69 66 20 79 6f 75 20 61 72 65 ssary if you are
03f0: 20 63 6f 6d 70 69 6c 69 6e 67 0a 2a 2a 20 6f 6e compiling.** on
0400: 20 61 20 72 65 63 65 6e 74 20 6d 61 63 68 69 6e a recent machin
0410: 65 20 28 65 78 3a 20 52 65 64 20 48 61 74 20 37 e (ex: Red Hat 7
0420: 2e 32 29 20 62 75 74 20 79 6f 75 20 77 61 6e 74 .2) but you want
0430: 20 79 6f 75 72 20 63 6f 64 65 20 74 6f 20 77 6f your code to wo
0440: 72 6b 0a 2a 2a 20 6f 6e 20 61 6e 20 6f 6c 64 65 rk.** on an olde
0450: 72 20 6d 61 63 68 69 6e 65 20 28 65 78 3a 20 52 r machine (ex: R
0460: 65 64 20 48 61 74 20 36 2e 30 29 2e 20 20 49 66 ed Hat 6.0). If
0470: 20 79 6f 75 20 63 6f 6d 70 69 6c 65 20 6f 6e 20 you compile on
0480: 52 65 64 20 48 61 74 20 37 2e 32 0a 2a 2a 20 77 Red Hat 7.2.** w
0490: 69 74 68 6f 75 74 20 74 68 69 73 20 6f 70 74 69 ithout this opti
04a0: 6f 6e 2c 20 4c 46 53 20 69 73 20 65 6e 61 62 6c on, LFS is enabl
04b0: 65 2e 20 20 42 75 74 20 4c 46 53 20 64 6f 65 73 e. But LFS does
04c0: 20 6e 6f 74 20 65 78 69 73 74 20 69 6e 20 74 68 not exist in th
04d0: 65 20 6b 65 72 6e 65 6c 0a 2a 2a 20 69 6e 20 52 e kernel.** in R
04e0: 65 64 20 48 61 74 20 36 2e 30 2c 20 73 6f 20 74 ed Hat 6.0, so t
04f0: 68 65 20 63 6f 64 65 20 77 6f 6e 27 74 20 77 6f he code won't wo
0500: 72 6b 2e 20 20 48 65 6e 63 65 2c 20 66 6f 72 20 rk. Hence, for
0510: 6d 61 78 69 6d 75 6d 20 62 69 6e 61 72 79 0a 2a maximum binary.*
0520: 2a 20 70 6f 72 74 61 62 69 6c 69 74 79 20 79 6f * portability yo
0530: 75 20 73 68 6f 75 6c 64 20 6f 6d 69 74 20 4c 46 u should omit LF
0540: 53 2e 0a 2a 2a 0a 2a 2a 20 53 69 6d 69 6c 61 72 S..**.** Similar
0550: 20 69 73 20 74 72 75 65 20 66 6f 72 20 4d 61 63 is true for Mac
0560: 20 4f 53 20 58 2e 20 20 4c 46 53 20 69 73 20 6f OS X. LFS is o
0570: 6e 6c 79 20 73 75 70 70 6f 72 74 65 64 20 6f 6e nly supported on
0580: 20 4d 61 63 20 4f 53 20 58 20 39 20 61 6e 64 20 Mac OS X 9 and
0590: 6c 61 74 65 72 2e 0a 2a 2f 0a 23 69 66 6e 64 65 later..*/.#ifnde
05a0: 66 20 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 f SQLITE_DISABLE
05b0: 5f 4c 46 53 0a 23 20 64 65 66 69 6e 65 20 5f 4c _LFS.# define _L
05c0: 41 52 47 45 5f 46 49 4c 45 20 20 20 20 20 20 20 ARGE_FILE
05d0: 31 0a 23 20 69 66 6e 64 65 66 20 5f 46 49 4c 45 1.# ifndef _FILE
05e0: 5f 4f 46 46 53 45 54 5f 42 49 54 53 0a 23 20 20 _OFFSET_BITS.#
05f0: 20 64 65 66 69 6e 65 20 5f 46 49 4c 45 5f 4f 46 define _FILE_OF
0600: 46 53 45 54 5f 42 49 54 53 20 36 34 0a 23 20 65 FSET_BITS 64.# e
0610: 6e 64 69 66 0a 23 20 64 65 66 69 6e 65 20 5f 4c ndif.# define _L
0620: 41 52 47 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 ARGEFILE_SOURCE
0630: 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 1.#endif../*.**
0640: 49 6e 63 6c 75 64 65 20 74 68 65 20 63 6f 6e 66 Include the conf
0650: 69 67 75 72 61 74 69 6f 6e 20 68 65 61 64 65 72 iguration header
0660: 20 6f 75 74 70 75 74 20 62 79 20 27 63 6f 6e 66 output by 'conf
0670: 69 67 75 72 65 27 20 69 66 20 77 65 27 72 65 20 igure' if we're
0680: 75 73 69 6e 67 20 74 68 65 0a 2a 2a 20 61 75 74 using the.** aut
0690: 6f 63 6f 6e 66 2d 62 61 73 65 64 20 62 75 69 6c oconf-based buil
06a0: 64 0a 2a 2f 0a 23 69 66 64 65 66 20 5f 48 41 56 d.*/.#ifdef _HAV
06b0: 45 5f 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f E_SQLITE_CONFIG_
06c0: 48 0a 23 69 6e 63 6c 75 64 65 20 22 63 6f 6e 66 H.#include "conf
06d0: 69 67 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 23 69 ig.h".#endif..#i
06e0: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 4c 69 nclude "sqliteLi
06f0: 6d 69 74 2e 68 22 0a 0a 2f 2a 20 44 69 73 61 62 mit.h"../* Disab
0700: 6c 65 20 6e 75 69 73 61 6e 63 65 20 77 61 72 6e le nuisance warn
0710: 69 6e 67 73 20 6f 6e 20 42 6f 72 6c 61 6e 64 20 ings on Borland
0720: 63 6f 6d 70 69 6c 65 72 73 20 2a 2f 0a 23 69 66 compilers */.#if
0730: 20 64 65 66 69 6e 65 64 28 5f 5f 42 4f 52 4c 41 defined(__BORLA
0740: 4e 44 43 5f 5f 29 0a 23 70 72 61 67 6d 61 20 77 NDC__).#pragma w
0750: 61 72 6e 20 2d 72 63 68 20 2f 2a 20 75 6e 72 65 arn -rch /* unre
0760: 61 63 68 61 62 6c 65 20 63 6f 64 65 20 2a 2f 0a achable code */.
0770: 23 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 63 63 #pragma warn -cc
0780: 63 20 2f 2a 20 43 6f 6e 64 69 74 69 6f 6e 20 69 c /* Condition i
0790: 73 20 61 6c 77 61 79 73 20 74 72 75 65 20 6f 72 s always true or
07a0: 20 66 61 6c 73 65 20 2a 2f 0a 23 70 72 61 67 6d false */.#pragm
07b0: 61 20 77 61 72 6e 20 2d 61 75 73 20 2f 2a 20 41 a warn -aus /* A
07c0: 73 73 69 67 6e 65 64 20 76 61 6c 75 65 20 69 73 ssigned value is
07d0: 20 6e 65 76 65 72 20 75 73 65 64 20 2a 2f 0a 23 never used */.#
07e0: 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 63 73 75 pragma warn -csu
07f0: 20 2f 2a 20 43 6f 6d 70 61 72 69 6e 67 20 73 69 /* Comparing si
0800: 67 6e 65 64 20 61 6e 64 20 75 6e 73 69 67 6e 65 gned and unsigne
0810: 64 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 72 d */.#pragma war
0820: 6e 20 2d 73 70 61 20 2f 2a 20 53 75 73 70 69 63 n -spa /* Suspic
0830: 69 6f 75 73 20 70 6f 69 6e 74 65 72 20 61 72 69 ious pointer ari
0840: 74 68 6d 65 74 69 63 20 2a 2f 0a 23 65 6e 64 69 thmetic */.#endi
0850: 66 0a 0a 2f 2a 20 4e 65 65 64 65 64 20 66 6f 72 f../* Needed for
0860: 20 76 61 72 69 6f 75 73 20 64 65 66 69 6e 69 74 various definit
0870: 69 6f 6e 73 2e 2e 2e 20 2a 2f 0a 23 69 66 6e 64 ions... */.#ifnd
0880: 65 66 20 5f 47 4e 55 5f 53 4f 55 52 43 45 0a 23 ef _GNU_SOURCE.#
0890: 20 64 65 66 69 6e 65 20 5f 47 4e 55 5f 53 4f 55 define _GNU_SOU
08a0: 52 43 45 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 RCE.#endif..#if
08b0: 64 65 66 69 6e 65 64 28 5f 5f 4f 70 65 6e 42 53 defined(__OpenBS
08c0: 44 5f 5f 29 20 26 26 20 21 64 65 66 69 6e 65 64 D__) && !defined
08d0: 28 5f 42 53 44 5f 53 4f 55 52 43 45 29 0a 23 20 (_BSD_SOURCE).#
08e0: 64 65 66 69 6e 65 20 5f 42 53 44 5f 53 4f 55 52 define _BSD_SOUR
08f0: 43 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a CE.#endif../*.**
0900: 20 49 6e 63 6c 75 64 65 20 73 74 61 6e 64 61 72 Include standar
0910: 64 20 68 65 61 64 65 72 20 66 69 6c 65 73 20 61 d header files a
0920: 73 20 6e 65 63 65 73 73 61 72 79 0a 2a 2f 0a 23 s necessary.*/.#
0930: 69 66 64 65 66 20 48 41 56 45 5f 53 54 44 49 4e ifdef HAVE_STDIN
0940: 54 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 T_H.#include <st
0950: 64 69 6e 74 2e 68 3e 0a 23 65 6e 64 69 66 0a 23 dint.h>.#endif.#
0960: 69 66 64 65 66 20 48 41 56 45 5f 49 4e 54 54 59 ifdef HAVE_INTTY
0970: 50 45 53 5f 48 0a 23 69 6e 63 6c 75 64 65 20 3c PES_H.#include <
0980: 69 6e 74 74 79 70 65 73 2e 68 3e 0a 23 65 6e 64 inttypes.h>.#end
0990: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f if../*.** The fo
09a0: 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 llowing macros a
09b0: 72 65 20 75 73 65 64 20 74 6f 20 63 61 73 74 20 re used to cast
09c0: 70 6f 69 6e 74 65 72 73 20 74 6f 20 69 6e 74 65 pointers to inte
09d0: 67 65 72 73 20 61 6e 64 0a 2a 2a 20 69 6e 74 65 gers and.** inte
09e0: 67 65 72 73 20 74 6f 20 70 6f 69 6e 74 65 72 73 gers to pointers
09f0: 2e 20 20 54 68 65 20 77 61 79 20 79 6f 75 20 64 . The way you d
0a00: 6f 20 74 68 69 73 20 76 61 72 69 65 73 20 66 72 o this varies fr
0a10: 6f 6d 20 6f 6e 65 20 63 6f 6d 70 69 6c 65 72 0a om one compiler.
0a20: 2a 2a 20 74 6f 20 74 68 65 20 6e 65 78 74 2c 20 ** to the next,
0a30: 73 6f 20 77 65 20 68 61 76 65 20 64 65 76 65 6c so we have devel
0a40: 6f 70 65 64 20 74 68 65 20 66 6f 6c 6c 6f 77 69 oped the followi
0a50: 6e 67 20 73 65 74 20 6f 66 20 23 69 66 20 73 74 ng set of #if st
0a60: 61 74 65 6d 65 6e 74 73 0a 2a 2a 20 74 6f 20 67 atements.** to g
0a70: 65 6e 65 72 61 74 65 20 61 70 70 72 6f 70 72 69 enerate appropri
0a80: 61 74 65 20 6d 61 63 72 6f 73 20 66 6f 72 20 61 ate macros for a
0a90: 20 77 69 64 65 20 72 61 6e 67 65 20 6f 66 20 63 wide range of c
0aa0: 6f 6d 70 69 6c 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 ompilers..**.**
0ab0: 54 68 65 20 63 6f 72 72 65 63 74 20 22 41 4e 53 The correct "ANS
0ac0: 49 22 20 77 61 79 20 74 6f 20 64 6f 20 74 68 69 I" way to do thi
0ad0: 73 20 69 73 20 74 6f 20 75 73 65 20 74 68 65 20 s is to use the
0ae0: 69 6e 74 70 74 72 5f 74 20 74 79 70 65 2e 20 0a intptr_t type. .
0af0: 2a 2a 20 55 6e 66 6f 72 74 75 6e 61 74 65 6c 79 ** Unfortunately
0b00: 2c 20 74 68 61 74 20 74 79 70 65 64 65 66 20 69 , that typedef i
0b10: 73 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c 65 20 s not available
0b20: 6f 6e 20 61 6c 6c 20 63 6f 6d 70 69 6c 65 72 73 on all compilers
0b30: 2c 20 6f 72 0a 2a 2a 20 69 66 20 69 74 20 69 73 , or.** if it is
0b40: 20 61 76 61 69 6c 61 62 6c 65 2c 20 69 74 20 72 available, it r
0b50: 65 71 75 69 72 65 73 20 61 6e 20 23 69 6e 63 6c equires an #incl
0b60: 75 64 65 20 6f 66 20 73 70 65 63 69 66 69 63 20 ude of specific
0b70: 68 65 61 64 65 72 73 0a 2a 2a 20 74 68 61 74 20 headers.** that
0b80: 76 61 72 79 20 66 72 6f 6d 20 6f 6e 65 20 6d 61 vary from one ma
0b90: 63 68 69 6e 65 20 74 6f 20 74 68 65 20 6e 65 78 chine to the nex
0ba0: 74 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 20 t..**.** Ticket
0bb0: 23 33 38 36 30 3a 20 20 54 68 65 20 6c 6c 76 6d #3860: The llvm
0bc0: 2d 67 63 63 2d 34 2e 32 20 63 6f 6d 70 69 6c 65 -gcc-4.2 compile
0bd0: 72 20 66 72 6f 6d 20 41 70 70 6c 65 20 63 68 6f r from Apple cho
0be0: 6b 65 73 20 6f 6e 0a 2a 2a 20 74 68 65 20 28 28 kes on.** the ((
0bf0: 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 30 void*)&((char*)0
0c00: 29 5b 58 5d 29 20 63 6f 6e 73 74 72 75 63 74 2e )[X]) construct.
0c10: 20 20 42 75 74 20 4d 53 56 43 20 63 68 6f 6b 65 But MSVC choke
0c20: 73 20 6f 6e 20 28 28 76 6f 69 64 2a 29 28 58 29 s on ((void*)(X)
0c30: 29 2e 0a 2a 2a 20 53 6f 20 77 65 20 68 61 76 65 )..** So we have
0c40: 20 74 6f 20 64 65 66 69 6e 65 20 74 68 65 20 6d to define the m
0c50: 61 63 72 6f 73 20 69 6e 20 64 69 66 66 65 72 65 acros in differe
0c60: 6e 74 20 77 61 79 73 20 64 65 70 65 6e 64 69 6e nt ways dependin
0c70: 67 20 6f 6e 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 g on the.** comp
0c80: 69 6c 65 72 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 iler..*/.#if def
0c90: 69 6e 65 64 28 5f 5f 50 54 52 44 49 46 46 5f 54 ined(__PTRDIFF_T
0ca0: 59 50 45 5f 5f 29 20 20 2f 2a 20 54 68 69 73 20 YPE__) /* This
0cb0: 63 61 73 65 20 73 68 6f 75 6c 64 20 77 6f 72 6b case should work
0cc0: 20 66 6f 72 20 47 43 43 20 2a 2f 0a 23 20 64 65 for GCC */.# de
0cd0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 5f fine SQLITE_INT_
0ce0: 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f 69 TO_PTR(X) ((voi
0cf0: 64 2a 29 28 5f 5f 50 54 52 44 49 46 46 5f 54 59 d*)(__PTRDIFF_TY
0d00: 50 45 5f 5f 29 28 58 29 29 0a 23 20 64 65 66 69 PE__)(X)).# defi
0d10: 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f ne SQLITE_PTR_TO
0d20: 5f 49 4e 54 28 58 29 20 20 28 28 69 6e 74 29 28 _INT(X) ((int)(
0d30: 5f 5f 50 54 52 44 49 46 46 5f 54 59 50 45 5f 5f __PTRDIFF_TYPE__
0d40: 29 28 58 29 29 0a 23 65 6c 69 66 20 21 64 65 66 )(X)).#elif !def
0d50: 69 6e 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 20 ined(__GNUC__)
0d60: 20 20 20 20 20 2f 2a 20 57 6f 72 6b 73 20 66 6f /* Works fo
0d70: 72 20 63 6f 6d 70 69 6c 65 72 73 20 6f 74 68 65 r compilers othe
0d80: 72 20 74 68 61 6e 20 4c 4c 56 4d 20 2a 2f 0a 23 r than LLVM */.#
0d90: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 define SQLITE_I
0da0: 4e 54 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 NT_TO_PTR(X) ((
0db0: 76 6f 69 64 2a 29 26 28 28 63 68 61 72 2a 29 30 void*)&((char*)0
0dc0: 29 5b 58 5d 29 0a 23 20 64 65 66 69 6e 65 20 53 )[X]).# define S
0dd0: 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 QLITE_PTR_TO_INT
0de0: 28 58 29 20 20 28 28 69 6e 74 29 28 28 28 63 68 (X) ((int)(((ch
0df0: 61 72 2a 29 58 29 2d 28 63 68 61 72 2a 29 30 29 ar*)X)-(char*)0)
0e00: 29 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 28 ).#elif defined(
0e10: 48 41 56 45 5f 53 54 44 49 4e 54 5f 48 29 20 20 HAVE_STDINT_H)
0e20: 20 2f 2a 20 55 73 65 20 74 68 69 73 20 63 61 73 /* Use this cas
0e30: 65 20 69 66 20 77 65 20 68 61 76 65 20 41 4e 53 e if we have ANS
0e40: 49 20 68 65 61 64 65 72 73 20 2a 2f 0a 23 20 64 I headers */.# d
0e50: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 efine SQLITE_INT
0e60: 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f _TO_PTR(X) ((vo
0e70: 69 64 2a 29 28 69 6e 74 70 74 72 5f 74 29 28 58 id*)(intptr_t)(X
0e80: 29 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 )).# define SQLI
0e90: 54 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 TE_PTR_TO_INT(X)
0ea0: 20 20 28 28 69 6e 74 29 28 69 6e 74 70 74 72 5f ((int)(intptr_
0eb0: 74 29 28 58 29 29 0a 23 65 6c 73 65 20 20 20 20 t)(X)).#else
0ec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0ed0: 20 20 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 /* Generat
0ee0: 65 73 20 61 20 77 61 72 6e 69 6e 67 20 2d 20 62 es a warning - b
0ef0: 75 74 20 69 74 20 61 6c 77 61 79 73 20 77 6f 72 ut it always wor
0f00: 6b 73 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 ks */.# define S
0f10: 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 QLITE_INT_TO_PTR
0f20: 28 58 29 20 20 28 28 76 6f 69 64 2a 29 28 58 29 (X) ((void*)(X)
0f30: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
0f40: 45 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 E_PTR_TO_INT(X)
0f50: 20 28 28 69 6e 74 29 28 58 29 29 0a 23 65 6e 64 ((int)(X)).#end
0f60: 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 if../*.** The SQ
0f70: 4c 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 LITE_THREADSAFE
0f80: 6d 61 63 72 6f 20 6d 75 73 74 20 62 65 20 64 65 macro must be de
0f90: 66 69 6e 65 64 20 61 73 20 30 2c 20 31 2c 20 6f fined as 0, 1, o
0fa0: 72 20 32 2e 0a 2a 2a 20 30 20 6d 65 61 6e 73 20 r 2..** 0 means
0fb0: 6d 75 74 65 78 65 73 20 61 72 65 20 70 65 72 6d mutexes are perm
0fc0: 61 6e 65 6e 74 6c 79 20 64 69 73 61 62 6c 65 20 anently disable
0fd0: 61 6e 64 20 74 68 65 20 6c 69 62 72 61 72 79 20 and the library
0fe0: 69 73 20 6e 65 76 65 72 0a 2a 2a 20 74 68 72 65 is never.** thre
0ff0: 61 64 73 61 66 65 2e 20 20 31 20 6d 65 61 6e 73 adsafe. 1 means
1000: 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 73 20 the library is
1010: 73 65 72 69 61 6c 69 7a 65 64 20 77 68 69 63 68 serialized which
1020: 20 69 73 20 74 68 65 20 68 69 67 68 65 73 74 0a is the highest.
1030: 2a 2a 20 6c 65 76 65 6c 20 6f 66 20 74 68 72 65 ** level of thre
1040: 61 64 73 61 66 65 74 79 2e 20 20 32 20 6d 65 61 adsafety. 2 mea
1050: 6e 73 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 ns the library i
1060: 73 20 6d 75 6c 74 69 74 68 72 65 61 64 65 64 20 s multithreaded
1070: 2d 20 6d 75 6c 74 69 70 6c 65 0a 2a 2a 20 74 68 - multiple.** th
1080: 72 65 61 64 73 20 63 61 6e 20 75 73 65 20 53 51 reads can use SQ
1090: 4c 69 74 65 20 61 73 20 6c 6f 6e 67 20 61 73 20 Lite as long as
10a0: 6e 6f 20 74 77 6f 20 74 68 72 65 61 64 73 20 74 no two threads t
10b0: 72 79 20 74 6f 20 75 73 65 20 74 68 65 20 73 61 ry to use the sa
10c0: 6d 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 me.** database c
10d0: 6f 6e 6e 65 63 74 69 6f 6e 20 61 74 20 74 68 65 onnection at the
10e0: 20 73 61 6d 65 20 74 69 6d 65 2e 0a 2a 2a 0a 2a same time..**.*
10f0: 2a 20 4f 6c 64 65 72 20 76 65 72 73 69 6f 6e 73 * Older versions
1100: 20 6f 66 20 53 51 4c 69 74 65 20 75 73 65 64 20 of SQLite used
1110: 61 6e 20 6f 70 74 69 6f 6e 61 6c 20 54 48 52 45 an optional THRE
1120: 41 44 53 41 46 45 20 6d 61 63 72 6f 2e 0a 2a 2a ADSAFE macro..**
1130: 20 57 65 20 73 75 70 70 6f 72 74 20 74 68 61 74 We support that
1140: 20 66 6f 72 20 6c 65 67 61 63 79 2e 0a 2a 2f 0a for legacy..*/.
1150: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
1160: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 29 0a ITE_THREADSAFE).
1170: 23 20 69 66 20 64 65 66 69 6e 65 64 28 54 48 52 # if defined(THR
1180: 45 41 44 53 41 46 45 29 0a 23 20 20 20 64 65 66 EADSAFE).# def
1190: 69 6e 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 ine SQLITE_THREA
11a0: 44 53 41 46 45 20 54 48 52 45 41 44 53 41 46 45 DSAFE THREADSAFE
11b0: 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 .# else.# defi
11c0: 6e 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 ne SQLITE_THREAD
11d0: 53 41 46 45 20 31 20 2f 2a 20 49 4d 50 3a 20 52 SAFE 1 /* IMP: R
11e0: 2d 30 37 32 37 32 2d 32 32 33 30 39 20 2a 2f 0a -07272-22309 */.
11f0: 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a # endif.#endif..
1200: 2f 2a 0a 2a 2a 20 50 6f 77 65 72 73 61 66 65 20 /*.** Powersafe
1210: 6f 76 65 72 77 72 69 74 65 20 69 73 20 6f 6e 20 overwrite is on
1220: 62 79 20 64 65 66 61 75 6c 74 2e 20 20 42 75 74 by default. But
1230: 20 63 61 6e 20 62 65 20 74 75 72 6e 65 64 20 6f can be turned o
1240: 66 66 20 75 73 69 6e 67 0a 2a 2a 20 74 68 65 20 ff using.** the
1250: 2d 44 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 -DSQLITE_POWERSA
1260: 46 45 5f 4f 56 45 52 57 52 49 54 45 3d 30 20 63 FE_OVERWRITE=0 c
1270: 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70 74 69 ommand-line opti
1280: 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 on..*/.#ifndef S
1290: 51 4c 49 54 45 5f 50 4f 57 45 52 53 41 46 45 5f QLITE_POWERSAFE_
12a0: 4f 56 45 52 57 52 49 54 45 0a 23 20 64 65 66 69 OVERWRITE.# defi
12b0: 6e 65 20 53 51 4c 49 54 45 5f 50 4f 57 45 52 53 ne SQLITE_POWERS
12c0: 41 46 45 5f 4f 56 45 52 57 52 49 54 45 20 31 0a AFE_OVERWRITE 1.
12d0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
12e0: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
12f0: 5f 4d 45 4d 53 54 41 54 55 53 20 6d 61 63 72 6f _MEMSTATUS macro
1300: 20 6d 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 must be defined
1310: 20 61 73 20 65 69 74 68 65 72 20 30 20 6f 72 20 as either 0 or
1320: 31 2e 0a 2a 2a 20 49 74 20 64 65 74 65 72 6d 69 1..** It determi
1330: 6e 65 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e nes whether or n
1340: 6f 74 20 74 68 65 20 66 65 61 74 75 72 65 73 20 ot the features
1350: 72 65 6c 61 74 65 64 20 74 6f 20 0a 2a 2a 20 53 related to .** S
1360: 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f 4d 45 4d QLITE_CONFIG_MEM
1370: 53 54 41 54 55 53 20 61 72 65 20 61 76 61 69 6c STATUS are avail
1380: 61 62 6c 65 20 62 79 20 64 65 66 61 75 6c 74 20 able by default
1390: 6f 72 20 6e 6f 74 2e 20 54 68 69 73 20 76 61 6c or not. This val
13a0: 75 65 20 63 61 6e 0a 2a 2a 20 62 65 20 6f 76 65 ue can.** be ove
13b0: 72 72 69 64 64 65 6e 20 61 74 20 72 75 6e 74 69 rridden at runti
13c0: 6d 65 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c me using the sql
13d0: 69 74 65 33 5f 63 6f 6e 66 69 67 28 29 20 41 50 ite3_config() AP
13e0: 49 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e I..*/.#if !defin
13f0: 65 64 28 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ed(SQLITE_DEFAUL
1400: 54 5f 4d 45 4d 53 54 41 54 55 53 29 0a 23 20 64 T_MEMSTATUS).# d
1410: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 efine SQLITE_DEF
1420: 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 20 31 AULT_MEMSTATUS 1
1430: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 .#endif../*.** E
1440: 78 61 63 74 6c 79 20 6f 6e 65 20 6f 66 20 74 68 xactly one of th
1450: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 e following macr
1460: 6f 73 20 6d 75 73 74 20 62 65 20 64 65 66 69 6e os must be defin
1470: 65 64 20 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a ed in order to.*
1480: 2a 20 73 70 65 63 69 66 79 20 77 68 69 63 68 20 * specify which
1490: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
14a0: 6e 20 73 75 62 73 79 73 74 65 6d 20 74 6f 20 75 n subsystem to u
14b0: 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 51 se..**.** SQ
14c0: 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c LITE_SYSTEM_MALL
14d0: 4f 43 20 20 20 20 20 20 20 20 20 20 2f 2f 20 55 OC // U
14e0: 73 65 20 6e 6f 72 6d 61 6c 20 73 79 73 74 65 6d se normal system
14f0: 20 6d 61 6c 6c 6f 63 28 29 0a 2a 2a 20 20 20 20 malloc().**
1500: 20 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 SQLITE_WIN32_MA
1510: 4c 4c 4f 43 20 20 20 20 20 20 20 20 20 20 20 2f LLOC /
1520: 2f 20 55 73 65 20 57 69 6e 33 32 20 6e 61 74 69 / Use Win32 nati
1530: 76 65 20 68 65 61 70 20 41 50 49 0a 2a 2a 20 20 ve heap API.**
1540: 20 20 20 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d SQLITE_ZERO_M
1550: 41 4c 4c 4f 43 20 20 20 20 20 20 20 20 20 20 20 ALLOC
1560: 20 2f 2f 20 55 73 65 20 61 20 73 74 75 62 20 61 // Use a stub a
1570: 6c 6c 6f 63 61 74 6f 72 20 74 68 61 74 20 61 6c llocator that al
1580: 77 61 79 73 20 66 61 69 6c 73 0a 2a 2a 20 20 20 ways fails.**
1590: 20 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 SQLITE_MEMDEBU
15a0: 47 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 G
15b0: 2f 2f 20 44 65 62 75 67 67 69 6e 67 20 76 65 72 // Debugging ver
15c0: 73 69 6f 6e 20 6f 66 20 73 79 73 74 65 6d 20 6d sion of system m
15d0: 61 6c 6c 6f 63 28 29 0a 2a 2a 0a 2a 2a 20 4f 6e alloc().**.** On
15e0: 20 57 69 6e 64 6f 77 73 2c 20 69 66 20 74 68 65 Windows, if the
15f0: 20 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 SQLITE_WIN32_MA
1600: 4c 4c 4f 43 5f 56 41 4c 49 44 41 54 45 20 6d 61 LLOC_VALIDATE ma
1610: 63 72 6f 20 69 73 20 64 65 66 69 6e 65 64 20 61 cro is defined a
1620: 6e 64 20 74 68 65 0a 2a 2a 20 61 73 73 65 72 74 nd the.** assert
1630: 28 29 20 6d 61 63 72 6f 20 69 73 20 65 6e 61 62 () macro is enab
1640: 6c 65 64 2c 20 65 61 63 68 20 63 61 6c 6c 20 69 led, each call i
1650: 6e 74 6f 20 74 68 65 20 57 69 6e 33 32 20 6e 61 nto the Win32 na
1660: 74 69 76 65 20 68 65 61 70 20 73 75 62 73 79 73 tive heap subsys
1670: 74 65 6d 0a 2a 2a 20 77 69 6c 6c 20 63 61 75 73 tem.** will caus
1680: 65 20 48 65 61 70 56 61 6c 69 64 61 74 65 20 74 e HeapValidate t
1690: 6f 20 62 65 20 63 61 6c 6c 65 64 2e 20 20 49 66 o be called. If
16a0: 20 68 65 61 70 20 76 61 6c 69 64 61 74 69 6f 6e heap validation
16b0: 20 73 68 6f 75 6c 64 20 66 61 69 6c 2c 20 61 6e should fail, an
16c0: 0a 2a 2a 20 61 73 73 65 72 74 69 6f 6e 20 77 69 .** assertion wi
16d0: 6c 6c 20 62 65 20 74 72 69 67 67 65 72 65 64 2e ll be triggered.
16e0: 0a 2a 2a 0a 2a 2a 20 49 66 20 6e 6f 6e 65 20 6f .**.** If none o
16f0: 66 20 74 68 65 20 61 62 6f 76 65 20 61 72 65 20 f the above are
1700: 64 65 66 69 6e 65 64 2c 20 74 68 65 6e 20 73 65 defined, then se
1710: 74 20 53 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f t SQLITE_SYSTEM_
1720: 4d 41 4c 4c 4f 43 20 61 73 0a 2a 2a 20 74 68 65 MALLOC as.** the
1730: 20 64 65 66 61 75 6c 74 2e 0a 2a 2f 0a 23 69 66 default..*/.#if
1740: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
1750: 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 29 20 5c SYSTEM_MALLOC) \
1760: 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c . + defined(SQL
1770: 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 ITE_WIN32_MALLOC
1780: 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 ) \. + defined(
1790: 53 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c SQLITE_ZERO_MALL
17a0: 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 OC) \. + define
17b0: 64 28 53 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 d(SQLITE_MEMDEBU
17c0: 47 29 3e 31 0a 23 20 65 72 72 6f 72 20 22 54 77 G)>1.# error "Tw
17d0: 6f 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 o or more of the
17e0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 6f 6d 70 69 following compi
17f0: 6c 65 2d 74 69 6d 65 20 63 6f 6e 66 69 67 75 72 le-time configur
1800: 61 74 69 6f 6e 20 6f 70 74 69 6f 6e 73 5c 0a 20 ation options\.
1810: 61 72 65 20 64 65 66 69 6e 65 64 20 62 75 74 20 are defined but
1820: 61 74 20 6d 6f 73 74 20 6f 6e 65 20 69 73 20 61 at most one is a
1830: 6c 6c 6f 77 65 64 3a 5c 0a 20 53 51 4c 49 54 45 llowed:\. SQLITE
1840: 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 2c 20 _SYSTEM_MALLOC,
1850: 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d 41 4c SQLITE_WIN32_MAL
1860: 4c 4f 43 2c 20 53 51 4c 49 54 45 5f 4d 45 4d 44 LOC, SQLITE_MEMD
1870: 45 42 55 47 2c 5c 0a 20 53 51 4c 49 54 45 5f 5a EBUG,\. SQLITE_Z
1880: 45 52 4f 5f 4d 41 4c 4c 4f 43 22 0a 23 65 6e 64 ERO_MALLOC".#end
1890: 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
18a0: 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c QLITE_SYSTEM_MAL
18b0: 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e LOC) \. + defin
18c0: 65 64 28 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f ed(SQLITE_WIN32_
18d0: 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 MALLOC) \. + de
18e0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 5a 45 52 fined(SQLITE_ZER
18f0: 4f 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 O_MALLOC) \. +
1900: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d defined(SQLITE_M
1910: 45 4d 44 45 42 55 47 29 3d 3d 30 0a 23 20 64 65 EMDEBUG)==0.# de
1920: 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 59 53 54 fine SQLITE_SYST
1930: 45 4d 5f 4d 41 4c 4c 4f 43 20 31 0a 23 65 6e 64 EM_MALLOC 1.#end
1940: 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 53 51 4c if../*.** If SQL
1950: 49 54 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f ITE_MALLOC_SOFT_
1960: 4c 49 4d 49 54 20 69 73 20 6e 6f 74 20 7a 65 72 LIMIT is not zer
1970: 6f 2c 20 74 68 65 6e 20 74 72 79 20 74 6f 20 6b o, then try to k
1980: 65 65 70 20 74 68 65 0a 2a 2a 20 73 69 7a 65 73 eep the.** sizes
1990: 20 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 of memory alloc
19a0: 61 74 69 6f 6e 73 20 62 65 6c 6f 77 20 74 68 69 ations below thi
19b0: 73 20 76 61 6c 75 65 20 77 68 65 72 65 20 70 6f s value where po
19c0: 73 73 69 62 6c 65 2e 0a 2a 2f 0a 23 69 66 20 21 ssible..*/.#if !
19d0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d defined(SQLITE_M
19e0: 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 ALLOC_SOFT_LIMIT
19f0: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
1a00: 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f 4c 49 E_MALLOC_SOFT_LI
1a10: 4d 49 54 20 31 30 32 34 0a 23 65 6e 64 69 66 0a MIT 1024.#endif.
1a20: 0a 2f 2a 0a 2a 2a 20 57 65 20 6e 65 65 64 20 74 ./*.** We need t
1a30: 6f 20 64 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f o define _XOPEN_
1a40: 53 4f 55 52 43 45 20 61 73 20 66 6f 6c 6c 6f 77 SOURCE as follow
1a50: 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e s in order to en
1a60: 61 62 6c 65 0a 2a 2a 20 72 65 63 75 72 73 69 76 able.** recursiv
1a70: 65 20 6d 75 74 65 78 65 73 20 6f 6e 20 6d 6f 73 e mutexes on mos
1a80: 74 20 55 6e 69 78 20 73 79 73 74 65 6d 73 20 61 t Unix systems a
1a90: 6e 64 20 66 63 68 6d 6f 64 28 29 20 6f 6e 20 4f nd fchmod() on O
1aa0: 70 65 6e 42 53 44 2e 0a 2a 2a 20 42 75 74 20 5f penBSD..** But _
1ab0: 58 4f 50 45 4e 5f 53 4f 55 52 43 45 20 64 65 66 XOPEN_SOURCE def
1ac0: 69 6e 65 20 63 61 75 73 65 73 20 70 72 6f 62 6c ine causes probl
1ad0: 65 6d 73 20 66 6f 72 20 4d 61 63 20 4f 53 20 58 ems for Mac OS X
1ae0: 2c 20 73 6f 20 6f 6d 69 74 0a 2a 2a 20 69 74 2e , so omit.** it.
1af0: 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 .*/.#if !defined
1b00: 28 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 45 29 20 (_XOPEN_SOURCE)
1b10: 26 26 20 21 64 65 66 69 6e 65 64 28 5f 5f 44 41 && !defined(__DA
1b20: 52 57 49 4e 5f 5f 29 20 26 26 20 21 64 65 66 69 RWIN__) && !defi
1b30: 6e 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 23 ned(__APPLE__).#
1b40: 20 20 64 65 66 69 6e 65 20 5f 58 4f 50 45 4e 5f define _XOPEN_
1b50: 53 4f 55 52 43 45 20 36 30 30 0a 23 65 6e 64 69 SOURCE 600.#endi
1b60: 66 0a 0a 2f 2a 0a 2a 2a 20 4e 44 45 42 55 47 20 f../*.** NDEBUG
1b70: 61 6e 64 20 53 51 4c 49 54 45 5f 44 45 42 55 47 and SQLITE_DEBUG
1b80: 20 61 72 65 20 6f 70 70 6f 73 69 74 65 73 2e 20 are opposites.
1b90: 20 49 74 20 73 68 6f 75 6c 64 20 61 6c 77 61 79 It should alway
1ba0: 73 20 62 65 20 74 72 75 65 20 74 68 61 74 0a 2a s be true that.*
1bb0: 2a 20 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 * defined(NDEBUG
1bc0: 29 3d 3d 21 64 65 66 69 6e 65 64 28 53 51 4c 49 )==!defined(SQLI
1bd0: 54 45 5f 44 45 42 55 47 29 2e 20 20 49 66 20 74 TE_DEBUG). If t
1be0: 68 69 73 20 69 73 20 6e 6f 74 20 63 75 72 72 65 his is not curre
1bf0: 6e 74 6c 79 20 74 72 75 65 2c 0a 2a 2a 20 6d 61 ntly true,.** ma
1c00: 6b 65 20 69 74 20 74 72 75 65 20 62 79 20 64 65 ke it true by de
1c10: 66 69 6e 69 6e 67 20 6f 72 20 75 6e 64 65 66 69 fining or undefi
1c20: 6e 69 6e 67 20 4e 44 45 42 55 47 2e 0a 2a 2a 0a ning NDEBUG..**.
1c30: 2a 2a 20 53 65 74 74 69 6e 67 20 4e 44 45 42 55 ** Setting NDEBU
1c40: 47 20 6d 61 6b 65 73 20 74 68 65 20 63 6f 64 65 G makes the code
1c50: 20 73 6d 61 6c 6c 65 72 20 61 6e 64 20 66 61 73 smaller and fas
1c60: 74 65 72 20 62 79 20 64 69 73 61 62 6c 69 6e 67 ter by disabling
1c70: 20 74 68 65 0a 2a 2a 20 61 73 73 65 72 74 28 29 the.** assert()
1c80: 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 statements in t
1c90: 68 65 20 63 6f 64 65 2e 20 20 53 6f 20 77 65 20 he code. So we
1ca0: 77 61 6e 74 20 74 68 65 20 64 65 66 61 75 6c 74 want the default
1cb0: 20 61 63 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 action.** to be
1cc0: 20 66 6f 72 20 4e 44 45 42 55 47 20 74 6f 20 62 for NDEBUG to b
1cd0: 65 20 73 65 74 20 61 6e 64 20 4e 44 45 42 55 47 e set and NDEBUG
1ce0: 20 74 6f 20 62 65 20 75 6e 64 65 66 69 6e 65 64 to be undefined
1cf0: 20 6f 6e 6c 79 20 69 66 20 53 51 4c 49 54 45 5f only if SQLITE_
1d00: 44 45 42 55 47 0a 2a 2a 20 69 73 20 73 65 74 2e DEBUG.** is set.
1d10: 20 20 54 68 75 73 20 4e 44 45 42 55 47 20 62 65 Thus NDEBUG be
1d20: 63 6f 6d 65 73 20 61 6e 20 6f 70 74 2d 69 6e 20 comes an opt-in
1d30: 72 61 74 68 65 72 20 74 68 61 6e 20 61 6e 20 6f rather than an o
1d40: 70 74 2d 6f 75 74 0a 2a 2a 20 66 65 61 74 75 72 pt-out.** featur
1d50: 65 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e e..*/.#if !defin
1d60: 65 64 28 4e 44 45 42 55 47 29 20 26 26 20 21 64 ed(NDEBUG) && !d
1d70: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 efined(SQLITE_DE
1d80: 42 55 47 29 20 0a 23 20 64 65 66 69 6e 65 20 4e BUG) .# define N
1d90: 44 45 42 55 47 20 31 0a 23 65 6e 64 69 66 0a 23 DEBUG 1.#endif.#
1da0: 69 66 20 64 65 66 69 6e 65 64 28 4e 44 45 42 55 if defined(NDEBU
1db0: 47 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 G) && defined(SQ
1dc0: 4c 49 54 45 5f 44 45 42 55 47 29 0a 23 20 75 6e LITE_DEBUG).# un
1dd0: 64 65 66 20 4e 44 45 42 55 47 0a 23 65 6e 64 69 def NDEBUG.#endi
1de0: 66 0a 0a 2f 2a 0a 2a 2a 20 45 6e 61 62 6c 65 20 f../*.** Enable
1df0: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 SQLITE_ENABLE_EX
1e00: 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 20 69 PLAIN_COMMENTS i
1e10: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 20 69 f SQLITE_DEBUG i
1e20: 73 20 74 75 72 6e 65 64 20 6f 6e 2e 0a 2a 2f 0a s turned on..*/.
1e30: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
1e40: 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 4c 41 ITE_ENABLE_EXPLA
1e50: 49 4e 5f 43 4f 4d 4d 45 4e 54 53 29 20 26 26 20 IN_COMMENTS) &&
1e60: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 defined(SQLITE_D
1e70: 45 42 55 47 29 0a 23 20 64 65 66 69 6e 65 20 53 EBUG).# define S
1e80: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 45 58 50 QLITE_ENABLE_EXP
1e90: 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 20 31 0a LAIN_COMMENTS 1.
1ea0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 #endif../*.** Th
1eb0: 65 20 74 65 73 74 63 61 73 65 28 29 20 6d 61 63 e testcase() mac
1ec0: 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20 61 69 ro is used to ai
1ed0: 64 20 69 6e 20 63 6f 76 65 72 61 67 65 20 74 65 d in coverage te
1ee0: 73 74 69 6e 67 2e 20 20 57 68 65 6e 20 0a 2a 2a sting. When .**
1ef0: 20 64 6f 69 6e 67 20 63 6f 76 65 72 61 67 65 20 doing coverage
1f00: 74 65 73 74 69 6e 67 2c 20 74 68 65 20 63 6f 6e testing, the con
1f10: 64 69 74 69 6f 6e 20 69 6e 73 69 64 65 20 74 68 dition inside th
1f20: 65 20 61 72 67 75 6d 65 6e 74 20 74 6f 0a 2a 2a e argument to.**
1f30: 20 74 65 73 74 63 61 73 65 28 29 20 6d 75 73 74 testcase() must
1f40: 20 62 65 20 65 76 61 6c 75 61 74 65 64 20 62 6f be evaluated bo
1f50: 74 68 20 74 72 75 65 20 61 6e 64 20 66 61 6c 73 th true and fals
1f60: 65 20 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a 2a e in order to.**
1f70: 20 67 65 74 20 66 75 6c 6c 20 62 72 61 6e 63 68 get full branch
1f80: 20 63 6f 76 65 72 61 67 65 2e 20 20 54 68 65 20 coverage. The
1f90: 74 65 73 74 63 61 73 65 28 29 20 6d 61 63 72 6f testcase() macro
1fa0: 20 69 73 20 69 6e 73 65 72 74 65 64 0a 2a 2a 20 is inserted.**
1fb0: 74 6f 20 68 65 6c 70 20 65 6e 73 75 72 65 20 61 to help ensure a
1fc0: 64 65 71 75 61 74 65 20 74 65 73 74 20 63 6f 76 dequate test cov
1fd0: 65 72 61 67 65 20 69 6e 20 70 6c 61 63 65 73 20 erage in places
1fe0: 77 68 65 72 65 20 73 69 6d 70 6c 65 0a 2a 2a 20 where simple.**
1ff0: 63 6f 6e 64 69 74 69 6f 6e 2f 64 65 63 69 73 69 condition/decisi
2000: 6f 6e 20 63 6f 76 65 72 61 67 65 20 69 73 20 69 on coverage is i
2010: 6e 61 64 65 71 75 61 74 65 2e 20 20 46 6f 72 20 nadequate. For
2020: 65 78 61 6d 70 6c 65 2c 20 74 65 73 74 63 61 73 example, testcas
2030: 65 28 29 0a 2a 2a 20 63 61 6e 20 62 65 20 75 73 e().** can be us
2040: 65 64 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 ed to make sure
2050: 62 6f 75 6e 64 61 72 79 20 76 61 6c 75 65 73 20 boundary values
2060: 61 72 65 20 74 65 73 74 65 64 2e 20 20 46 6f 72 are tested. For
2070: 0a 2a 2a 20 62 69 74 6d 61 73 6b 20 74 65 73 74 .** bitmask test
2080: 73 2c 20 74 65 73 74 63 61 73 65 28 29 20 63 61 s, testcase() ca
2090: 6e 20 62 65 20 75 73 65 64 20 74 6f 20 6d 61 6b n be used to mak
20a0: 65 20 73 75 72 65 20 65 61 63 68 20 62 69 74 0a e sure each bit.
20b0: 2a 2a 20 69 73 20 73 69 67 6e 69 66 69 63 61 6e ** is significan
20c0: 74 20 61 6e 64 20 75 73 65 64 20 61 74 20 6c 65 t and used at le
20d0: 61 73 74 20 6f 6e 63 65 2e 20 20 4f 6e 20 73 77 ast once. On sw
20e0: 69 74 63 68 20 73 74 61 74 65 6d 65 6e 74 73 0a itch statements.
20f0: 2a 2a 20 77 68 65 72 65 20 6d 75 6c 74 69 70 6c ** where multipl
2100: 65 20 63 61 73 65 73 20 67 6f 20 74 6f 20 74 68 e cases go to th
2110: 65 20 73 61 6d 65 20 62 6c 6f 63 6b 20 6f 66 20 e same block of
2120: 63 6f 64 65 2c 20 74 65 73 74 63 61 73 65 28 29 code, testcase()
2130: 0a 2a 2a 20 63 61 6e 20 69 6e 73 75 72 65 20 74 .** can insure t
2140: 68 61 74 20 61 6c 6c 20 63 61 73 65 73 20 61 72 hat all cases ar
2150: 65 20 65 76 61 6c 75 61 74 65 64 2e 0a 2a 2a 0a e evaluated..**.
2160: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
2170: 5f 43 4f 56 45 52 41 47 45 5f 54 45 53 54 0a 20 _COVERAGE_TEST.
2180: 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 76 void sqlite3Cov
2190: 65 72 61 67 65 28 69 6e 74 29 3b 0a 23 20 64 65 erage(int);.# de
21a0: 66 69 6e 65 20 74 65 73 74 63 61 73 65 28 58 29 fine testcase(X)
21b0: 20 20 69 66 28 20 58 20 29 7b 20 73 71 6c 69 74 if( X ){ sqlit
21c0: 65 33 43 6f 76 65 72 61 67 65 28 5f 5f 4c 49 4e e3Coverage(__LIN
21d0: 45 5f 5f 29 3b 20 7d 0a 23 65 6c 73 65 0a 23 20 E__); }.#else.#
21e0: 64 65 66 69 6e 65 20 74 65 73 74 63 61 73 65 28 define testcase(
21f0: 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a X).#endif../*.**
2200: 20 54 68 65 20 54 45 53 54 4f 4e 4c 59 20 6d 61 The TESTONLY ma
2210: 63 72 6f 20 69 73 20 75 73 65 64 20 74 6f 20 65 cro is used to e
2220: 6e 63 6c 6f 73 65 20 76 61 72 69 61 62 6c 65 20 nclose variable
2230: 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 6f 72 0a declarations or.
2240: 2a 2a 20 6f 74 68 65 72 20 62 69 74 73 20 6f 66 ** other bits of
2250: 20 63 6f 64 65 20 74 68 61 74 20 61 72 65 20 6e code that are n
2260: 65 65 64 65 64 20 74 6f 20 73 75 70 70 6f 72 74 eeded to support
2270: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 73 0a 2a the arguments.*
2280: 2a 20 77 69 74 68 69 6e 20 74 65 73 74 63 61 73 * within testcas
2290: 65 28 29 20 61 6e 64 20 61 73 73 65 72 74 28 29 e() and assert()
22a0: 20 6d 61 63 72 6f 73 2e 0a 2a 2f 0a 23 69 66 20 macros..*/.#if
22b0: 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 !defined(NDEBUG)
22c0: 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 || defined(SQLI
22d0: 54 45 5f 43 4f 56 45 52 41 47 45 5f 54 45 53 54 TE_COVERAGE_TEST
22e0: 29 0a 23 20 64 65 66 69 6e 65 20 54 45 53 54 4f ).# define TESTO
22f0: 4e 4c 59 28 58 29 20 20 58 0a 23 65 6c 73 65 0a NLY(X) X.#else.
2300: 23 20 64 65 66 69 6e 65 20 54 45 53 54 4f 4e 4c # define TESTONL
2310: 59 28 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a Y(X).#endif../*.
2320: 2a 2a 20 53 6f 6d 65 74 69 6d 65 73 20 77 65 20 ** Sometimes we
2330: 6e 65 65 64 20 61 20 73 6d 61 6c 6c 20 61 6d 6f need a small amo
2340: 75 6e 74 20 6f 66 20 63 6f 64 65 20 73 75 63 68 unt of code such
2350: 20 61 73 20 61 20 76 61 72 69 61 62 6c 65 20 69 as a variable i
2360: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 0a 2a 2a nitialization.**
2370: 20 74 6f 20 73 65 74 75 70 20 66 6f 72 20 61 20 to setup for a
2380: 6c 61 74 65 72 20 61 73 73 65 72 74 28 29 20 73 later assert() s
2390: 74 61 74 65 6d 65 6e 74 2e 20 20 57 65 20 64 6f tatement. We do
23a0: 20 6e 6f 74 20 77 61 6e 74 20 74 68 69 73 20 63 not want this c
23b0: 6f 64 65 20 74 6f 0a 2a 2a 20 61 70 70 65 61 72 ode to.** appear
23c0: 20 77 68 65 6e 20 61 73 73 65 72 74 28 29 20 69 when assert() i
23d0: 73 20 64 69 73 61 62 6c 65 64 2e 20 20 54 68 65 s disabled. The
23e0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f following macro
23f0: 20 69 73 20 74 68 65 72 65 66 6f 72 65 0a 2a 2a is therefore.**
2400: 20 75 73 65 64 20 74 6f 20 63 6f 6e 74 61 69 6e used to contain
2410: 20 74 68 61 74 20 73 65 74 75 70 20 63 6f 64 65 that setup code
2420: 2e 20 20 54 68 65 20 22 56 56 41 22 20 61 63 72 . The "VVA" acr
2430: 6f 6e 79 6d 20 73 74 61 6e 64 73 20 66 6f 72 0a onym stands for.
2440: 2a 2a 20 22 56 65 72 69 66 69 63 61 74 69 6f 6e ** "Verification
2450: 2c 20 56 61 6c 69 64 61 74 69 6f 6e 2c 20 61 6e , Validation, an
2460: 64 20 41 63 63 72 65 64 69 74 61 74 69 6f 6e 22 d Accreditation"
2470: 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 . In other word
2480: 73 2c 20 74 68 65 0a 2a 2a 20 63 6f 64 65 20 77 s, the.** code w
2490: 69 74 68 69 6e 20 56 56 41 5f 4f 4e 4c 59 28 29 ithin VVA_ONLY()
24a0: 20 77 69 6c 6c 20 6f 6e 6c 79 20 72 75 6e 20 64 will only run d
24b0: 75 72 69 6e 67 20 76 65 72 69 66 69 63 61 74 69 uring verificati
24c0: 6f 6e 20 70 72 6f 63 65 73 73 65 73 2e 0a 2a 2f on processes..*/
24d0: 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a .#ifndef NDEBUG.
24e0: 23 20 64 65 66 69 6e 65 20 56 56 41 5f 4f 4e 4c # define VVA_ONL
24f0: 59 28 58 29 20 20 58 0a 23 65 6c 73 65 0a 23 20 Y(X) X.#else.#
2500: 64 65 66 69 6e 65 20 56 56 41 5f 4f 4e 4c 59 28 define VVA_ONLY(
2510: 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a X).#endif../*.**
2520: 20 54 68 65 20 41 4c 57 41 59 53 20 61 6e 64 20 The ALWAYS and
2530: 4e 45 56 45 52 20 6d 61 63 72 6f 73 20 73 75 72 NEVER macros sur
2540: 72 6f 75 6e 64 20 62 6f 6f 6c 65 61 6e 20 65 78 round boolean ex
2550: 70 72 65 73 73 69 6f 6e 73 20 77 68 69 63 68 20 pressions which
2560: 0a 2a 2a 20 61 72 65 20 69 6e 74 65 6e 64 65 64 .** are intended
2570: 20 74 6f 20 61 6c 77 61 79 73 20 62 65 20 74 72 to always be tr
2580: 75 65 20 6f 72 20 66 61 6c 73 65 2c 20 72 65 73 ue or false, res
2590: 70 65 63 74 69 76 65 6c 79 2e 20 20 53 75 63 68 pectively. Such
25a0: 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 73 20 .** expressions
25b0: 63 6f 75 6c 64 20 62 65 20 6f 6d 69 74 74 65 64 could be omitted
25c0: 20 66 72 6f 6d 20 74 68 65 20 63 6f 64 65 20 63 from the code c
25d0: 6f 6d 70 6c 65 74 65 6c 79 2e 20 20 42 75 74 20 ompletely. But
25e0: 74 68 65 79 0a 2a 2a 20 61 72 65 20 69 6e 63 6c they.** are incl
25f0: 75 64 65 64 20 69 6e 20 61 20 66 65 77 20 63 61 uded in a few ca
2600: 73 65 73 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 ses in order to
2610: 65 6e 68 61 6e 63 65 20 74 68 65 20 72 65 73 69 enhance the resi
2620: 6c 69 65 6e 63 65 0a 2a 2a 20 6f 66 20 53 51 4c lience.** of SQL
2630: 69 74 65 20 74 6f 20 75 6e 65 78 70 65 63 74 65 ite to unexpecte
2640: 64 20 62 65 68 61 76 69 6f 72 20 2d 20 74 6f 20 d behavior - to
2650: 6d 61 6b 65 20 74 68 65 20 63 6f 64 65 20 22 73 make the code "s
2660: 65 6c 66 2d 68 65 61 6c 69 6e 67 22 0a 2a 2a 20 elf-healing".**
2670: 6f 72 20 22 64 75 63 74 69 6c 65 22 20 72 61 74 or "ductile" rat
2680: 68 65 72 20 74 68 61 6e 20 62 65 69 6e 67 20 22 her than being "
2690: 62 72 69 74 74 6c 65 22 20 61 6e 64 20 63 72 61 brittle" and cra
26a0: 73 68 69 6e 67 20 61 74 20 74 68 65 20 66 69 72 shing at the fir
26b0: 73 74 0a 2a 2a 20 68 69 6e 74 20 6f 66 20 75 6e st.** hint of un
26c0: 70 6c 61 6e 6e 65 64 20 62 65 68 61 76 69 6f 72 planned behavior
26d0: 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 6f 74 68 65 72 ..**.** In other
26e0: 20 77 6f 72 64 73 2c 20 41 4c 57 41 59 53 20 61 words, ALWAYS a
26f0: 6e 64 20 4e 45 56 45 52 20 61 72 65 20 61 64 64 nd NEVER are add
2700: 65 64 20 66 6f 72 20 64 65 66 65 6e 73 69 76 65 ed for defensive
2710: 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 code..**.** Whe
2720: 6e 20 64 6f 69 6e 67 20 63 6f 76 65 72 61 67 65 n doing coverage
2730: 20 74 65 73 74 69 6e 67 20 41 4c 57 41 59 53 20 testing ALWAYS
2740: 61 6e 64 20 4e 45 56 45 52 20 61 72 65 20 68 61 and NEVER are ha
2750: 72 64 2d 63 6f 64 65 64 20 74 6f 0a 2a 2a 20 62 rd-coded to.** b
2760: 65 20 74 72 75 65 20 61 6e 64 20 66 61 6c 73 65 e true and false
2770: 20 73 6f 20 74 68 61 74 20 74 68 65 20 75 6e 72 so that the unr
2780: 65 61 63 68 61 62 6c 65 20 63 6f 64 65 20 74 68 eachable code th
2790: 65 79 20 73 70 65 63 69 66 79 20 77 69 6c 6c 0a ey specify will.
27a0: 2a 2a 20 6e 6f 74 20 62 65 20 63 6f 75 6e 74 65 ** not be counte
27b0: 64 20 61 73 20 75 6e 74 65 73 74 65 64 20 63 6f d as untested co
27c0: 64 65 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e de..*/.#if defin
27d0: 65 64 28 53 51 4c 49 54 45 5f 43 4f 56 45 52 41 ed(SQLITE_COVERA
27e0: 47 45 5f 54 45 53 54 29 0a 23 20 64 65 66 69 6e GE_TEST).# defin
27f0: 65 20 41 4c 57 41 59 53 28 58 29 20 20 20 20 20 e ALWAYS(X)
2800: 20 28 31 29 0a 23 20 64 65 66 69 6e 65 20 4e 45 (1).# define NE
2810: 56 45 52 28 58 29 20 20 20 20 20 20 20 28 30 29 VER(X) (0)
2820: 0a 23 65 6c 69 66 20 21 64 65 66 69 6e 65 64 28 .#elif !defined(
2830: 4e 44 45 42 55 47 29 0a 23 20 64 65 66 69 6e 65 NDEBUG).# define
2840: 20 41 4c 57 41 59 53 28 58 29 20 20 20 20 20 20 ALWAYS(X)
2850: 28 28 58 29 3f 31 3a 28 61 73 73 65 72 74 28 30 ((X)?1:(assert(0
2860: 29 2c 30 29 29 0a 23 20 64 65 66 69 6e 65 20 4e ),0)).# define N
2870: 45 56 45 52 28 58 29 20 20 20 20 20 20 20 28 28 EVER(X) ((
2880: 58 29 3f 28 61 73 73 65 72 74 28 30 29 2c 31 29 X)?(assert(0),1)
2890: 3a 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 :0).#else.# defi
28a0: 6e 65 20 41 4c 57 41 59 53 28 58 29 20 20 20 20 ne ALWAYS(X)
28b0: 20 20 28 58 29 0a 23 20 64 65 66 69 6e 65 20 4e (X).# define N
28c0: 45 56 45 52 28 58 29 20 20 20 20 20 20 20 28 58 EVER(X) (X
28d0: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
28e0: 52 65 74 75 72 6e 20 74 72 75 65 20 28 6e 6f 6e Return true (non
28f0: 2d 7a 65 72 6f 29 20 69 66 20 74 68 65 20 69 6e -zero) if the in
2900: 70 75 74 20 69 73 20 61 20 69 6e 74 65 67 65 72 put is a integer
2910: 20 74 68 61 74 20 69 73 20 74 6f 6f 20 6c 61 72 that is too lar
2920: 67 65 0a 2a 2a 20 74 6f 20 66 69 74 20 69 6e 20 ge.** to fit in
2930: 33 32 2d 62 69 74 73 2e 20 20 54 68 69 73 20 6d 32-bits. This m
2940: 61 63 72 6f 20 69 73 20 75 73 65 64 20 69 6e 73 acro is used ins
2950: 69 64 65 20 6f 66 20 76 61 72 69 6f 75 73 20 74 ide of various t
2960: 65 73 74 63 61 73 65 28 29 0a 2a 2a 20 6d 61 63 estcase().** mac
2970: 72 6f 73 20 74 6f 20 76 65 72 69 66 79 20 74 68 ros to verify th
2980: 61 74 20 77 65 20 68 61 76 65 20 74 65 73 74 65 at we have teste
2990: 64 20 53 51 4c 69 74 65 20 66 6f 72 20 6c 61 72 d SQLite for lar
29a0: 67 65 2d 66 69 6c 65 20 73 75 70 70 6f 72 74 2e ge-file support.
29b0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 53 5f 42 .*/.#define IS_B
29c0: 49 47 5f 49 4e 54 28 58 29 20 20 28 28 28 58 29 IG_INT(X) (((X)
29d0: 26 7e 28 69 36 34 29 30 78 66 66 66 66 66 66 66 &~(i64)0xfffffff
29e0: 66 29 21 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 f)!=0)../*.** Th
29f0: 65 20 6d 61 63 72 6f 20 75 6e 6c 69 6b 65 6c 79 e macro unlikely
2a00: 28 29 20 69 73 20 61 20 68 69 6e 74 20 74 68 61 () is a hint tha
2a10: 74 20 73 75 72 72 6f 75 6e 64 73 20 61 20 62 6f t surrounds a bo
2a20: 6f 6c 65 61 6e 0a 2a 2a 20 65 78 70 72 65 73 73 olean.** express
2a30: 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73 75 61 ion that is usua
2a40: 6c 6c 79 20 66 61 6c 73 65 2e 20 20 4d 61 63 72 lly false. Macr
2a50: 6f 20 6c 69 6b 65 6c 79 28 29 20 73 75 72 72 6f o likely() surro
2a60: 75 6e 64 73 0a 2a 2a 20 61 20 62 6f 6f 6c 65 61 unds.** a boolea
2a70: 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 74 68 61 n expression tha
2a80: 74 20 69 73 20 75 73 75 61 6c 6c 79 20 74 72 75 t is usually tru
2a90: 65 2e 20 20 54 68 65 73 65 20 68 69 6e 74 73 20 e. These hints
2aa0: 63 6f 75 6c 64 2c 0a 2a 2a 20 69 6e 20 74 68 65 could,.** in the
2ab0: 6f 72 79 2c 20 62 65 20 75 73 65 64 20 62 79 20 ory, be used by
2ac0: 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 74 6f 20 the compiler to
2ad0: 67 65 6e 65 72 61 74 65 20 62 65 74 74 65 72 20 generate better
2ae0: 63 6f 64 65 2c 20 62 75 74 0a 2a 2a 20 63 75 72 code, but.** cur
2af0: 72 65 6e 74 6c 79 20 74 68 65 79 20 61 72 65 20 rently they are
2b00: 6a 75 73 74 20 63 6f 6d 6d 65 6e 74 73 20 66 6f just comments fo
2b10: 72 20 68 75 6d 61 6e 20 72 65 61 64 65 72 73 2e r human readers.
2b20: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 6c 69 6b 65 .*/.#define like
2b30: 6c 79 28 58 29 20 20 20 20 28 58 29 0a 23 64 65 ly(X) (X).#de
2b40: 66 69 6e 65 20 75 6e 6c 69 6b 65 6c 79 28 58 29 fine unlikely(X)
2b50: 20 20 28 58 29 0a 0a 23 69 6e 63 6c 75 64 65 20 (X)..#include
2b60: 22 68 61 73 68 2e 68 22 0a 23 69 6e 63 6c 75 64 "hash.h".#includ
2b70: 65 20 22 70 61 72 73 65 2e 68 22 0a 23 69 6e 63 e "parse.h".#inc
2b80: 6c 75 64 65 20 3c 73 74 64 69 6f 2e 68 3e 0a 23 lude <stdio.h>.#
2b90: 69 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69 62 2e include <stdlib.
2ba0: 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 72 h>.#include <str
2bb0: 69 6e 67 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 ing.h>.#include
2bc0: 3c 61 73 73 65 72 74 2e 68 3e 0a 23 69 6e 63 6c <assert.h>.#incl
2bd0: 75 64 65 20 3c 73 74 64 64 65 66 2e 68 3e 0a 0a ude <stddef.h>..
2be0: 2f 2a 0a 2a 2a 20 49 66 20 63 6f 6d 70 69 6c 69 /*.** If compili
2bf0: 6e 67 20 66 6f 72 20 61 20 70 72 6f 63 65 73 73 ng for a process
2c00: 6f 72 20 74 68 61 74 20 6c 61 63 6b 73 20 66 6c or that lacks fl
2c10: 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 73 75 70 oating point sup
2c20: 70 6f 72 74 2c 0a 2a 2a 20 73 75 62 73 74 69 74 port,.** substit
2c30: 75 74 65 20 69 6e 74 65 67 65 72 20 66 6f 72 20 ute integer for
2c40: 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 0a 2a floating-point.*
2c50: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
2c60: 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f OMIT_FLOATING_PO
2c70: 49 4e 54 0a 23 20 64 65 66 69 6e 65 20 64 6f 75 INT.# define dou
2c80: 62 6c 65 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 ble sqlite_int64
2c90: 0a 23 20 64 65 66 69 6e 65 20 66 6c 6f 61 74 20 .# define float
2ca0: 73 71 6c 69 74 65 5f 69 6e 74 36 34 0a 23 20 64 sqlite_int64.# d
2cb0: 65 66 69 6e 65 20 4c 4f 4e 47 44 4f 55 42 4c 45 efine LONGDOUBLE
2cc0: 5f 54 59 50 45 20 73 71 6c 69 74 65 5f 69 6e 74 _TYPE sqlite_int
2cd0: 36 34 0a 23 20 69 66 6e 64 65 66 20 53 51 4c 49 64.# ifndef SQLI
2ce0: 54 45 5f 42 49 47 5f 44 42 4c 0a 23 20 20 20 64 TE_BIG_DBL.# d
2cf0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 efine SQLITE_BIG
2d00: 5f 44 42 4c 20 28 28 28 73 71 6c 69 74 65 33 5f _DBL (((sqlite3_
2d10: 69 6e 74 36 34 29 31 29 3c 3c 35 30 29 0a 23 20 int64)1)<<50).#
2d20: 65 6e 64 69 66 0a 23 20 64 65 66 69 6e 65 20 53 endif.# define S
2d30: 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 41 54 45 54 QLITE_OMIT_DATET
2d40: 49 4d 45 5f 46 55 4e 43 53 20 31 0a 23 20 64 65 IME_FUNCS 1.# de
2d50: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 fine SQLITE_OMIT
2d60: 5f 54 52 41 43 45 20 31 0a 23 20 75 6e 64 65 66 _TRACE 1.# undef
2d70: 20 53 51 4c 49 54 45 5f 4d 49 58 45 44 5f 45 4e SQLITE_MIXED_EN
2d80: 44 49 41 4e 5f 36 34 42 49 54 5f 46 4c 4f 41 54 DIAN_64BIT_FLOAT
2d90: 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 5f .# undef SQLITE_
2da0: 48 41 56 45 5f 49 53 4e 41 4e 0a 23 65 6e 64 69 HAVE_ISNAN.#endi
2db0: 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 f.#ifndef SQLITE
2dc0: 5f 42 49 47 5f 44 42 4c 0a 23 20 64 65 66 69 6e _BIG_DBL.# defin
2dd0: 65 20 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c e SQLITE_BIG_DBL
2de0: 20 28 31 65 39 39 29 0a 23 65 6e 64 69 66 0a 0a (1e99).#endif..
2df0: 2f 2a 0a 2a 2a 20 4f 4d 49 54 5f 54 45 4d 50 44 /*.** OMIT_TEMPD
2e00: 42 20 69 73 20 73 65 74 20 74 6f 20 31 20 69 66 B is set to 1 if
2e10: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d SQLITE_OMIT_TEM
2e20: 50 44 42 20 69 73 20 64 65 66 69 6e 65 64 2c 20 PDB is defined,
2e30: 6f 72 20 30 0a 2a 2a 20 61 66 74 65 72 77 61 72 or 0.** afterwar
2e40: 64 2e 20 48 61 76 69 6e 67 20 74 68 69 73 20 6d d. Having this m
2e50: 61 63 72 6f 20 61 6c 6c 6f 77 73 20 75 73 20 74 acro allows us t
2e60: 6f 20 63 61 75 73 65 20 74 68 65 20 43 20 63 6f o cause the C co
2e70: 6d 70 69 6c 65 72 20 0a 2a 2a 20 74 6f 20 6f 6d mpiler .** to om
2e80: 69 74 20 63 6f 64 65 20 75 73 65 64 20 62 79 20 it code used by
2e90: 54 45 4d 50 20 74 61 62 6c 65 73 20 77 69 74 68 TEMP tables with
2ea0: 6f 75 74 20 6d 65 73 73 79 20 23 69 66 6e 64 65 out messy #ifnde
2eb0: 66 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2f f statements..*/
2ec0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
2ed0: 4d 49 54 5f 54 45 4d 50 44 42 0a 23 64 65 66 69 MIT_TEMPDB.#defi
2ee0: 6e 65 20 4f 4d 49 54 5f 54 45 4d 50 44 42 20 31 ne OMIT_TEMPDB 1
2ef0: 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 4f .#else.#define O
2f00: 4d 49 54 5f 54 45 4d 50 44 42 20 30 0a 23 65 6e MIT_TEMPDB 0.#en
2f10: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 22 dif../*.** The "
2f20: 66 69 6c 65 20 66 6f 72 6d 61 74 22 20 6e 75 6d file format" num
2f30: 62 65 72 20 69 73 20 61 6e 20 69 6e 74 65 67 65 ber is an intege
2f40: 72 20 74 68 61 74 20 69 73 20 69 6e 63 72 65 6d r that is increm
2f50: 65 6e 74 65 64 20 77 68 65 6e 65 76 65 72 0a 2a ented whenever.*
2f60: 2a 20 74 68 65 20 56 44 42 45 2d 6c 65 76 65 6c * the VDBE-level
2f70: 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 63 68 61 file format cha
2f80: 6e 67 65 73 2e 20 20 54 68 65 20 66 6f 6c 6c 6f nges. The follo
2f90: 77 69 6e 67 20 6d 61 63 72 6f 73 20 64 65 66 69 wing macros defi
2fa0: 6e 65 20 74 68 65 0a 2a 2a 20 74 68 65 20 64 65 ne the.** the de
2fb0: 66 61 75 6c 74 20 66 69 6c 65 20 66 6f 72 6d 61 fault file forma
2fc0: 74 20 66 6f 72 20 6e 65 77 20 64 61 74 61 62 61 t for new databa
2fd0: 73 65 73 20 61 6e 64 20 74 68 65 20 6d 61 78 69 ses and the maxi
2fe0: 6d 75 6d 20 66 69 6c 65 20 66 6f 72 6d 61 74 0a mum file format.
2ff0: 2a 2a 20 74 68 61 74 20 74 68 65 20 6c 69 62 72 ** that the libr
3000: 61 72 79 20 63 61 6e 20 72 65 61 64 2e 0a 2a 2f ary can read..*/
3010: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
3020: 4d 41 58 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 MAX_FILE_FORMAT
3030: 34 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 4.#ifndef SQLITE
3040: 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f _DEFAULT_FILE_FO
3050: 52 4d 41 54 0a 23 20 64 65 66 69 6e 65 20 53 51 RMAT.# define SQ
3060: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c LITE_DEFAULT_FIL
3070: 45 5f 46 4f 52 4d 41 54 20 34 0a 23 65 6e 64 69 E_FORMAT 4.#endi
3080: 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 f../*.** Determi
3090: 6e 65 20 77 68 65 74 68 65 72 20 74 72 69 67 67 ne whether trigg
30a0: 65 72 73 20 61 72 65 20 72 65 63 75 72 73 69 76 ers are recursiv
30b0: 65 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 54 e by default. T
30c0: 68 69 73 20 63 61 6e 20 62 65 0a 2a 2a 20 63 68 his can be.** ch
30d0: 61 6e 67 65 64 20 61 74 20 72 75 6e 2d 74 69 6d anged at run-tim
30e0: 65 20 75 73 69 6e 67 20 61 20 70 72 61 67 6d 61 e using a pragma
30f0: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
3100: 49 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 55 ITE_DEFAULT_RECU
3110: 52 53 49 56 45 5f 54 52 49 47 47 45 52 53 0a 23 RSIVE_TRIGGERS.#
3120: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 define SQLITE_D
3130: 45 46 41 55 4c 54 5f 52 45 43 55 52 53 49 56 45 EFAULT_RECURSIVE
3140: 5f 54 52 49 47 47 45 52 53 20 30 0a 23 65 6e 64 _TRIGGERS 0.#end
3150: 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 if../*.** Provid
3160: 65 20 61 20 64 65 66 61 75 6c 74 20 76 61 6c 75 e a default valu
3170: 65 20 66 6f 72 20 53 51 4c 49 54 45 5f 54 45 4d e for SQLITE_TEM
3180: 50 5f 53 54 4f 52 45 20 69 6e 20 63 61 73 65 20 P_STORE in case
3190: 69 74 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 it is not specif
31a0: 69 65 64 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 6f ied.** on the co
31b0: 6d 6d 61 6e 64 2d 6c 69 6e 65 0a 2a 2f 0a 23 69 mmand-line.*/.#i
31c0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 54 45 4d fndef SQLITE_TEM
31d0: 50 5f 53 54 4f 52 45 0a 23 20 64 65 66 69 6e 65 P_STORE.# define
31e0: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
31f0: 52 45 20 31 0a 23 20 64 65 66 69 6e 65 20 53 51 RE 1.# define SQ
3200: 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 5f LITE_TEMP_STORE_
3210: 78 63 20 31 20 20 2f 2a 20 45 78 63 6c 75 64 65 xc 1 /* Exclude
3220: 20 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a 2f from ctime.c */
3230: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 47 .#endif../*.** G
3240: 43 43 20 64 6f 65 73 20 6e 6f 74 20 64 65 66 69 CC does not defi
3250: 6e 65 20 74 68 65 20 6f 66 66 73 65 74 6f 66 28 ne the offsetof(
3260: 29 20 6d 61 63 72 6f 20 73 6f 20 77 65 27 6c 6c ) macro so we'll
3270: 20 68 61 76 65 20 74 6f 20 64 6f 20 69 74 0a 2a have to do it.*
3280: 2a 20 6f 75 72 73 65 6c 76 65 73 2e 0a 2a 2f 0a * ourselves..*/.
3290: 23 69 66 6e 64 65 66 20 6f 66 66 73 65 74 6f 66 #ifndef offsetof
32a0: 0a 23 64 65 66 69 6e 65 20 6f 66 66 73 65 74 6f .#define offseto
32b0: 66 28 53 54 52 55 43 54 55 52 45 2c 46 49 45 4c f(STRUCTURE,FIEL
32c0: 44 29 20 28 28 69 6e 74 29 28 28 63 68 61 72 2a D) ((int)((char*
32d0: 29 26 28 28 53 54 52 55 43 54 55 52 45 2a 29 30 )&((STRUCTURE*)0
32e0: 29 2d 3e 46 49 45 4c 44 29 29 0a 23 65 6e 64 69 )->FIELD)).#endi
32f0: 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 f../*.** Macros
3300: 74 6f 20 63 6f 6d 70 75 74 65 20 6d 69 6e 69 6d to compute minim
3310: 75 6d 20 61 6e 64 20 6d 61 78 69 6d 75 6d 20 6f um and maximum o
3320: 66 20 74 77 6f 20 6e 75 6d 62 65 72 73 2e 0a 2a f two numbers..*
3330: 2f 0a 23 64 65 66 69 6e 65 20 4d 49 4e 28 41 2c /.#define MIN(A,
3340: 42 29 20 28 28 41 29 3c 28 42 29 3f 28 41 29 3a B) ((A)<(B)?(A):
3350: 28 42 29 29 0a 23 64 65 66 69 6e 65 20 4d 41 58 (B)).#define MAX
3360: 28 41 2c 42 29 20 28 28 41 29 3e 28 42 29 3f 28 (A,B) ((A)>(B)?(
3370: 41 29 3a 28 42 29 29 0a 0a 2f 2a 0a 2a 2a 20 43 A):(B))../*.** C
3380: 68 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 74 heck to see if t
3390: 68 69 73 20 6d 61 63 68 69 6e 65 20 75 73 65 73 his machine uses
33a0: 20 45 42 43 44 49 43 2e 20 20 28 59 65 73 2c 20 EBCDIC. (Yes,
33b0: 62 65 6c 69 65 76 65 20 69 74 20 6f 72 0a 2a 2a believe it or.**
33c0: 20 6e 6f 74 2c 20 74 68 65 72 65 20 61 72 65 20 not, there are
33d0: 73 74 69 6c 6c 20 6d 61 63 68 69 6e 65 73 20 6f still machines o
33e0: 75 74 20 74 68 65 72 65 20 74 68 61 74 20 75 73 ut there that us
33f0: 65 20 45 42 43 44 49 43 2e 29 0a 2a 2f 0a 23 69 e EBCDIC.).*/.#i
3400: 66 20 27 41 27 20 3d 3d 20 27 5c 33 30 31 27 0a f 'A' == '\301'.
3410: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
3420: 45 42 43 44 49 43 20 31 0a 23 65 6c 73 65 0a 23 EBCDIC 1.#else.#
3430: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 define SQLITE_A
3440: 53 43 49 49 20 31 0a 23 65 6e 64 69 66 0a 0a 2f SCII 1.#endif../
3450: 2a 0a 2a 2a 20 49 6e 74 65 67 65 72 73 20 6f 66 *.** Integers of
3460: 20 6b 6e 6f 77 6e 20 73 69 7a 65 73 2e 20 20 54 known sizes. T
3470: 68 65 73 65 20 74 79 70 65 64 65 66 73 20 6d 69 hese typedefs mi
3480: 67 68 74 20 63 68 61 6e 67 65 20 66 6f 72 20 61 ght change for a
3490: 72 63 68 69 74 65 63 74 75 72 65 73 0a 2a 2a 20 rchitectures.**
34a0: 77 68 65 72 65 20 74 68 65 20 73 69 7a 65 73 20 where the sizes
34b0: 76 65 72 79 2e 20 20 50 72 65 70 72 6f 63 65 73 very. Preproces
34c0: 73 6f 72 20 6d 61 63 72 6f 73 20 61 72 65 20 61 sor macros are a
34d0: 76 61 69 6c 61 62 6c 65 20 73 6f 20 74 68 61 74 vailable so that
34e0: 20 74 68 65 0a 2a 2a 20 74 79 70 65 73 20 63 61 the.** types ca
34f0: 6e 20 62 65 20 63 6f 6e 76 65 6e 69 65 6e 74 6c n be convenientl
3500: 79 20 72 65 64 65 66 69 6e 65 64 20 61 74 20 63 y redefined at c
3510: 6f 6d 70 69 6c 65 2d 74 79 70 65 2e 20 20 4c 69 ompile-type. Li
3520: 6b 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 ke this:.**.**
3530: 20 20 20 20 20 20 20 63 63 20 27 2d 44 55 49 4e cc '-DUIN
3540: 54 50 54 52 5f 54 59 50 45 3d 6c 6f 6e 67 20 6c TPTR_TYPE=long l
3550: 6f 6e 67 20 69 6e 74 27 20 2e 2e 2e 0a 2a 2f 0a ong int' ....*/.
3560: 23 69 66 6e 64 65 66 20 55 49 4e 54 33 32 5f 54 #ifndef UINT32_T
3570: 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 YPE.# ifdef HAVE
3580: 5f 55 49 4e 54 33 32 5f 54 0a 23 20 20 64 65 66 _UINT32_T.# def
3590: 69 6e 65 20 55 49 4e 54 33 32 5f 54 59 50 45 20 ine UINT32_TYPE
35a0: 75 69 6e 74 33 32 5f 74 0a 23 20 65 6c 73 65 0a uint32_t.# else.
35b0: 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 33 32 # define UINT32
35c0: 5f 54 59 50 45 20 75 6e 73 69 67 6e 65 64 20 69 _TYPE unsigned i
35d0: 6e 74 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 nt.# endif.#endi
35e0: 66 0a 23 69 66 6e 64 65 66 20 55 49 4e 54 31 36 f.#ifndef UINT16
35f0: 5f 54 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 _TYPE.# ifdef HA
3600: 56 45 5f 55 49 4e 54 31 36 5f 54 0a 23 20 20 64 VE_UINT16_T.# d
3610: 65 66 69 6e 65 20 55 49 4e 54 31 36 5f 54 59 50 efine UINT16_TYP
3620: 45 20 75 69 6e 74 31 36 5f 74 0a 23 20 65 6c 73 E uint16_t.# els
3630: 65 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 e.# define UINT
3640: 31 36 5f 54 59 50 45 20 75 6e 73 69 67 6e 65 64 16_TYPE unsigned
3650: 20 73 68 6f 72 74 20 69 6e 74 0a 23 20 65 6e 64 short int.# end
3660: 69 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 if.#endif.#ifnde
3670: 66 20 49 4e 54 31 36 5f 54 59 50 45 0a 23 20 69 f INT16_TYPE.# i
3680: 66 64 65 66 20 48 41 56 45 5f 49 4e 54 31 36 5f fdef HAVE_INT16_
3690: 54 0a 23 20 20 64 65 66 69 6e 65 20 49 4e 54 31 T.# define INT1
36a0: 36 5f 54 59 50 45 20 69 6e 74 31 36 5f 74 0a 23 6_TYPE int16_t.#
36b0: 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 else.# define
36c0: 49 4e 54 31 36 5f 54 59 50 45 20 73 68 6f 72 74 INT16_TYPE short
36d0: 20 69 6e 74 0a 23 20 65 6e 64 69 66 0a 23 65 6e int.# endif.#en
36e0: 64 69 66 0a 23 69 66 6e 64 65 66 20 55 49 4e 54 dif.#ifndef UINT
36f0: 38 5f 54 59 50 45 0a 23 20 69 66 64 65 66 20 48 8_TYPE.# ifdef H
3700: 41 56 45 5f 55 49 4e 54 38 5f 54 0a 23 20 20 64 AVE_UINT8_T.# d
3710: 65 66 69 6e 65 20 55 49 4e 54 38 5f 54 59 50 45 efine UINT8_TYPE
3720: 20 75 69 6e 74 38 5f 74 0a 23 20 65 6c 73 65 0a uint8_t.# else.
3730: 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 38 5f # define UINT8_
3740: 54 59 50 45 20 75 6e 73 69 67 6e 65 64 20 63 68 TYPE unsigned ch
3750: 61 72 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 ar.# endif.#endi
3760: 66 0a 23 69 66 6e 64 65 66 20 49 4e 54 38 5f 54 f.#ifndef INT8_T
3770: 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 YPE.# ifdef HAVE
3780: 5f 49 4e 54 38 5f 54 0a 23 20 20 64 65 66 69 6e _INT8_T.# defin
3790: 65 20 49 4e 54 38 5f 54 59 50 45 20 69 6e 74 38 e INT8_TYPE int8
37a0: 5f 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 66 _t.# else.# def
37b0: 69 6e 65 20 49 4e 54 38 5f 54 59 50 45 20 73 69 ine INT8_TYPE si
37c0: 67 6e 65 64 20 63 68 61 72 0a 23 20 65 6e 64 69 gned char.# endi
37d0: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
37e0: 20 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 LONGDOUBLE_TYPE
37f0: 0a 23 20 64 65 66 69 6e 65 20 4c 4f 4e 47 44 4f .# define LONGDO
3800: 55 42 4c 45 5f 54 59 50 45 20 6c 6f 6e 67 20 64 UBLE_TYPE long d
3810: 6f 75 62 6c 65 0a 23 65 6e 64 69 66 0a 74 79 70 ouble.#endif.typ
3820: 65 64 65 66 20 73 71 6c 69 74 65 5f 69 6e 74 36 edef sqlite_int6
3830: 34 20 69 36 34 3b 20 20 20 20 20 20 20 20 20 20 4 i64;
3840: 2f 2a 20 38 2d 62 79 74 65 20 73 69 67 6e 65 64 /* 8-byte signed
3850: 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 integer */.type
3860: 64 65 66 20 73 71 6c 69 74 65 5f 75 69 6e 74 36 def sqlite_uint6
3870: 34 20 75 36 34 3b 20 20 20 20 20 20 20 20 20 2f 4 u64; /
3880: 2a 20 38 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 * 8-byte unsigne
3890: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 d integer */.typ
38a0: 65 64 65 66 20 55 49 4e 54 33 32 5f 54 59 50 45 edef UINT32_TYPE
38b0: 20 75 33 32 3b 20 20 20 20 20 20 20 20 20 20 20 u32;
38c0: 2f 2a 20 34 2d 62 79 74 65 20 75 6e 73 69 67 6e /* 4-byte unsign
38d0: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 ed integer */.ty
38e0: 70 65 64 65 66 20 55 49 4e 54 31 36 5f 54 59 50 pedef UINT16_TYP
38f0: 45 20 75 31 36 3b 20 20 20 20 20 20 20 20 20 20 E u16;
3900: 20 2f 2a 20 32 2d 62 79 74 65 20 75 6e 73 69 67 /* 2-byte unsig
3910: 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 ned integer */.t
3920: 79 70 65 64 65 66 20 49 4e 54 31 36 5f 54 59 50 ypedef INT16_TYP
3930: 45 20 69 31 36 3b 20 20 20 20 20 20 20 20 20 20 E i16;
3940: 20 20 2f 2a 20 32 2d 62 79 74 65 20 73 69 67 6e /* 2-byte sign
3950: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 ed integer */.ty
3960: 70 65 64 65 66 20 55 49 4e 54 38 5f 54 59 50 45 pedef UINT8_TYPE
3970: 20 75 38 3b 20 20 20 20 20 20 20 20 20 20 20 20 u8;
3980: 20 2f 2a 20 31 2d 62 79 74 65 20 75 6e 73 69 67 /* 1-byte unsig
3990: 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 ned integer */.t
39a0: 79 70 65 64 65 66 20 49 4e 54 38 5f 54 59 50 45 ypedef INT8_TYPE
39b0: 20 69 38 3b 20 20 20 20 20 20 20 20 20 20 20 20 i8;
39c0: 20 20 2f 2a 20 31 2d 62 79 74 65 20 73 69 67 6e /* 1-byte sign
39d0: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 0a 2f ed integer */../
39e0: 2a 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 41 58 5f *.** SQLITE_MAX_
39f0: 55 33 32 20 69 73 20 61 20 75 36 34 20 63 6f 6e U32 is a u64 con
3a00: 73 74 61 6e 74 20 74 68 61 74 20 69 73 20 74 68 stant that is th
3a10: 65 20 6d 61 78 69 6d 75 6d 20 75 36 34 20 76 61 e maximum u64 va
3a20: 6c 75 65 0a 2a 2a 20 74 68 61 74 20 63 61 6e 20 lue.** that can
3a30: 62 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 75 be stored in a u
3a40: 33 32 20 77 69 74 68 6f 75 74 20 6c 6f 73 73 20 32 without loss
3a50: 6f 66 20 64 61 74 61 2e 20 20 54 68 65 20 76 61 of data. The va
3a60: 6c 75 65 0a 2a 2a 20 69 73 20 30 78 30 30 30 30 lue.** is 0x0000
3a70: 30 30 30 30 66 66 66 66 66 66 66 66 2e 20 20 42 0000ffffffff. B
3a80: 75 74 20 62 65 63 61 75 73 65 20 6f 66 20 71 75 ut because of qu
3a90: 69 72 6b 73 20 6f 66 20 73 6f 6d 65 20 63 6f 6d irks of some com
3aa0: 70 69 6c 65 72 73 2c 20 77 65 0a 2a 2a 20 68 61 pilers, we.** ha
3ab0: 76 65 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 ve to specify th
3ac0: 65 20 76 61 6c 75 65 20 69 6e 20 74 68 65 20 6c e value in the l
3ad0: 65 73 73 20 69 6e 74 75 69 74 69 76 65 20 6d 61 ess intuitive ma
3ae0: 6e 6e 65 72 20 73 68 6f 77 6e 3a 0a 2a 2f 0a 23 nner shown:.*/.#
3af0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 define SQLITE_MA
3b00: 58 5f 55 33 32 20 20 28 28 28 28 75 36 34 29 31 X_U32 ((((u64)1
3b10: 29 3c 3c 33 32 29 2d 31 29 0a 0a 2f 2a 0a 2a 2a )<<32)-1)../*.**
3b20: 20 54 68 65 20 64 61 74 61 74 79 70 65 20 75 73 The datatype us
3b30: 65 64 20 74 6f 20 73 74 6f 72 65 20 65 73 74 69 ed to store esti
3b40: 6d 61 74 65 73 20 6f 66 20 74 68 65 20 6e 75 6d mates of the num
3b50: 62 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20 61 ber of rows in a
3b60: 0a 2a 2a 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 .** table or ind
3b70: 65 78 2e 20 20 54 68 69 73 20 69 73 20 61 6e 20 ex. This is an
3b80: 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
3b90: 20 74 79 70 65 2e 20 20 46 6f 72 20 39 39 2e 39 type. For 99.9
3ba0: 25 20 6f 66 0a 2a 2a 20 74 68 65 20 77 6f 72 6c % of.** the worl
3bb0: 64 2c 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65 d, a 32-bit inte
3bc0: 67 65 72 20 69 73 20 73 75 66 66 69 63 69 65 6e ger is sufficien
3bd0: 74 2e 20 20 42 75 74 20 61 20 36 34 2d 62 69 74 t. But a 64-bit
3be0: 20 69 6e 74 65 67 65 72 0a 2a 2a 20 63 61 6e 20 integer.** can
3bf0: 62 65 20 75 73 65 64 20 61 74 20 63 6f 6d 70 69 be used at compi
3c00: 6c 65 2d 74 69 6d 65 20 69 66 20 64 65 73 69 72 le-time if desir
3c10: 65 64 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ed..*/.#ifdef SQ
3c20: 4c 49 54 45 5f 36 34 42 49 54 5f 53 54 41 54 53 LITE_64BIT_STATS
3c30: 0a 20 74 79 70 65 64 65 66 20 75 36 34 20 74 52 . typedef u64 tR
3c40: 6f 77 63 6e 74 3b 20 20 20 20 2f 2a 20 36 34 2d owcnt; /* 64-
3c50: 62 69 74 20 6f 6e 6c 79 20 69 66 20 72 65 71 75 bit only if requ
3c60: 65 73 74 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 ested at compile
3c70: 2d 74 69 6d 65 20 2a 2f 0a 23 65 6c 73 65 0a 20 -time */.#else.
3c80: 74 79 70 65 64 65 66 20 75 33 32 20 74 52 6f 77 typedef u32 tRow
3c90: 63 6e 74 3b 20 20 20 20 2f 2a 20 33 32 2d 62 69 cnt; /* 32-bi
3ca0: 74 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 t is the default
3cb0: 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a */.#endif../*.*
3cc0: 2a 20 45 73 74 69 6d 61 74 65 64 20 71 75 61 6e * Estimated quan
3cd0: 74 69 74 69 65 73 20 75 73 65 64 20 66 6f 72 20 tities used for
3ce0: 71 75 65 72 79 20 70 6c 61 6e 6e 69 6e 67 20 61 query planning a
3cf0: 72 65 20 73 74 6f 72 65 64 20 61 73 20 31 36 2d re stored as 16-
3d00: 62 69 74 0a 2a 2a 20 6c 6f 67 61 72 69 74 68 6d bit.** logarithm
3d10: 73 2e 20 20 46 6f 72 20 71 75 61 6e 74 69 74 79 s. For quantity
3d20: 20 58 2c 20 74 68 65 20 76 61 6c 75 65 20 73 74 X, the value st
3d30: 6f 72 65 64 20 69 73 20 31 30 2a 6c 6f 67 32 28 ored is 10*log2(
3d40: 58 29 2e 20 20 54 68 69 73 0a 2a 2a 20 67 69 76 X). This.** giv
3d50: 65 73 20 61 20 70 6f 73 73 69 62 6c 65 20 72 61 es a possible ra
3d60: 6e 67 65 20 6f 66 20 76 61 6c 75 65 73 20 6f 66 nge of values of
3d70: 20 61 70 70 72 6f 78 69 6d 61 74 65 6c 79 20 31 approximately 1
3d80: 2e 30 65 39 38 36 20 74 6f 20 31 65 2d 39 38 36 .0e986 to 1e-986
3d90: 2e 0a 2a 2a 20 42 75 74 20 74 68 65 20 61 6c 6c ..** But the all
3da0: 6f 77 65 64 20 76 61 6c 75 65 73 20 61 72 65 20 owed values are
3db0: 22 67 72 61 69 6e 79 22 2e 20 20 4e 6f 74 20 65 "grainy". Not e
3dc0: 76 65 72 79 20 76 61 6c 75 65 20 69 73 20 72 65 very value is re
3dd0: 70 72 65 73 65 6e 74 61 62 6c 65 2e 0a 2a 2a 20 presentable..**
3de0: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 71 75 61 For example, qua
3df0: 6e 74 69 74 69 65 73 20 31 36 20 61 6e 64 20 31 ntities 16 and 1
3e00: 37 20 61 72 65 20 62 6f 74 68 20 72 65 70 72 65 7 are both repre
3e10: 73 65 6e 74 65 64 20 62 79 20 61 20 4c 6f 67 45 sented by a LogE
3e20: 73 74 0a 2a 2a 20 6f 66 20 34 30 2e 20 20 48 6f st.** of 40. Ho
3e30: 77 65 76 65 72 2c 20 73 69 6e 63 65 20 4c 6f 67 wever, since Log
3e40: 45 73 74 20 71 75 61 6e 74 61 74 69 74 65 73 20 Est quantatites
3e50: 61 72 65 20 73 75 70 70 6f 73 65 20 74 6f 20 62 are suppose to b
3e60: 65 20 65 73 74 69 6d 61 74 65 73 2c 0a 2a 2a 20 e estimates,.**
3e70: 6e 6f 74 20 65 78 61 63 74 20 76 61 6c 75 65 73 not exact values
3e80: 2c 20 74 68 69 73 20 69 6d 70 72 65 63 69 73 69 , this imprecisi
3e90: 6f 6e 20 69 73 20 6e 6f 74 20 61 20 70 72 6f 62 on is not a prob
3ea0: 6c 65 6d 2e 0a 2a 2a 0a 2a 2a 20 22 4c 6f 67 45 lem..**.** "LogE
3eb0: 73 74 22 20 69 73 20 73 68 6f 72 74 20 66 6f 72 st" is short for
3ec0: 20 22 4c 6f 67 61 72 69 74 68 69 6d 69 63 20 45 "Logarithimic E
3ed0: 73 74 69 6d 61 74 65 22 2e 0a 2a 2a 0a 2a 2a 20 stimate"..**.**
3ee0: 45 78 61 6d 70 6c 65 73 3a 0a 2a 2a 20 20 20 20 Examples:.**
3ef0: 20 20 31 20 2d 3e 20 30 20 20 20 20 20 20 20 20 1 -> 0
3f00: 20 20 20 20 20 20 32 30 20 2d 3e 20 34 33 20 20 20 -> 43
3f10: 20 20 20 20 20 20 20 20 31 30 30 30 30 20 2d 3e 10000 ->
3f20: 20 31 33 32 0a 2a 2a 20 20 20 20 20 20 32 20 2d 132.** 2 -
3f30: 3e 20 31 30 20 20 20 20 20 20 20 20 20 20 20 20 > 10
3f40: 20 32 35 20 2d 3e 20 34 36 20 20 20 20 20 20 20 25 -> 46
3f50: 20 20 20 32 35 30 30 30 20 2d 3e 20 31 34 36 0a 25000 -> 146.
3f60: 2a 2a 20 20 20 20 20 20 33 20 2d 3e 20 31 36 20 ** 3 -> 16
3f70: 20 20 20 20 20 20 20 20 20 20 20 31 30 30 20 2d 100 -
3f80: 3e 20 36 36 20 20 20 20 20 20 20 20 31 30 30 30 > 66 1000
3f90: 30 30 30 20 2d 3e 20 31 39 39 0a 2a 2a 20 20 20 000 -> 199.**
3fa0: 20 20 20 34 20 2d 3e 20 32 30 20 20 20 20 20 20 4 -> 20
3fb0: 20 20 20 20 20 31 30 30 30 20 2d 3e 20 39 39 20 1000 -> 99
3fc0: 20 20 20 20 20 20 20 31 30 34 38 35 37 36 20 2d 1048576 -
3fd0: 3e 20 32 30 30 0a 2a 2a 20 20 20 20 20 31 30 20 > 200.** 10
3fe0: 2d 3e 20 33 33 20 20 20 20 20 20 20 20 20 20 20 -> 33
3ff0: 31 30 32 34 20 2d 3e 20 31 30 30 20 20 20 20 34 1024 -> 100 4
4000: 32 39 34 39 36 37 32 39 36 20 2d 3e 20 33 32 30 294967296 -> 320
4010: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4c 6f 67 45 73 .**.** The LogEs
4020: 74 20 63 61 6e 20 62 65 20 6e 65 67 61 74 69 76 t can be negativ
4030: 65 20 74 6f 20 69 6e 64 69 63 61 74 65 20 66 72 e to indicate fr
4040: 61 63 74 69 6f 6e 61 6c 20 76 61 6c 75 65 73 2e actional values.
4050: 20 0a 2a 2a 20 45 78 61 6d 70 6c 65 73 3a 0a 2a .** Examples:.*
4060: 2a 0a 2a 2a 20 20 20 20 30 2e 35 20 2d 3e 20 2d *.** 0.5 -> -
4070: 31 30 20 20 20 20 20 20 20 20 20 20 20 30 2e 31 10 0.1
4080: 20 2d 3e 20 2d 33 33 20 20 20 20 20 20 20 20 30 -> -33 0
4090: 2e 30 36 32 35 20 2d 3e 20 2d 34 30 0a 2a 2f 0a .0625 -> -40.*/.
40a0: 74 79 70 65 64 65 66 20 49 4e 54 31 36 5f 54 59 typedef INT16_TY
40b0: 50 45 20 4c 6f 67 45 73 74 3b 0a 0a 2f 2a 0a 2a PE LogEst;../*.*
40c0: 2a 20 4d 61 63 72 6f 73 20 74 6f 20 64 65 74 65 * Macros to dete
40d0: 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 74 68 rmine whether th
40e0: 65 20 6d 61 63 68 69 6e 65 20 69 73 20 62 69 67 e machine is big
40f0: 20 6f 72 20 6c 69 74 74 6c 65 20 65 6e 64 69 61 or little endia
4100: 6e 2c 0a 2a 2a 20 65 76 61 6c 75 61 74 65 64 20 n,.** evaluated
4110: 61 74 20 72 75 6e 74 69 6d 65 2e 0a 2a 2f 0a 23 at runtime..*/.#
4120: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 41 4d 41 ifdef SQLITE_AMA
4130: 4c 47 41 4d 41 54 49 4f 4e 0a 63 6f 6e 73 74 20 LGAMATION.const
4140: 69 6e 74 20 73 71 6c 69 74 65 33 6f 6e 65 20 3d int sqlite3one =
4150: 20 31 3b 0a 23 65 6c 73 65 0a 65 78 74 65 72 6e 1;.#else.extern
4160: 20 63 6f 6e 73 74 20 69 6e 74 20 73 71 6c 69 74 const int sqlit
4170: 65 33 6f 6e 65 3b 0a 23 65 6e 64 69 66 0a 23 69 e3one;.#endif.#i
4180: 66 20 64 65 66 69 6e 65 64 28 69 33 38 36 29 20 f defined(i386)
4190: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 69 33 38 || defined(__i38
41a0: 36 5f 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 6__) || defined(
41b0: 5f 4d 5f 49 58 38 36 29 5c 0a 20 20 20 20 20 20 _M_IX86)\.
41c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
41d0: 20 20 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 || define
41e0: 64 28 5f 5f 78 38 36 5f 36 34 29 20 7c 7c 20 64 d(__x86_64) || d
41f0: 65 66 69 6e 65 64 28 5f 5f 78 38 36 5f 36 34 5f efined(__x86_64_
4200: 5f 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 _).# define SQLI
4210: 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 20 20 20 TE_BIGENDIAN
4220: 30 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 0.# define SQLIT
4230: 45 5f 4c 49 54 54 4c 45 45 4e 44 49 41 4e 20 31 E_LITTLEENDIAN 1
4240: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
4250: 5f 55 54 46 31 36 4e 41 54 49 56 45 20 20 53 51 _UTF16NATIVE SQ
4260: 4c 49 54 45 5f 55 54 46 31 36 4c 45 0a 23 65 6c LITE_UTF16LE.#el
4270: 73 65 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 se.# define SQLI
4280: 54 45 5f 42 49 47 45 4e 44 49 41 4e 20 20 20 20 TE_BIGENDIAN
4290: 28 2a 28 63 68 61 72 20 2a 29 28 26 73 71 6c 69 (*(char *)(&sqli
42a0: 74 65 33 6f 6e 65 29 3d 3d 30 29 0a 23 20 64 65 te3one)==0).# de
42b0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 54 54 fine SQLITE_LITT
42c0: 4c 45 45 4e 44 49 41 4e 20 28 2a 28 63 68 61 72 LEENDIAN (*(char
42d0: 20 2a 29 28 26 73 71 6c 69 74 65 33 6f 6e 65 29 *)(&sqlite3one)
42e0: 3d 3d 31 29 0a 23 20 64 65 66 69 6e 65 20 53 51 ==1).# define SQ
42f0: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
4300: 20 28 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 (SQLITE_BIGENDI
4310: 41 4e 3f 53 51 4c 49 54 45 5f 55 54 46 31 36 42 AN?SQLITE_UTF16B
4320: 45 3a 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 E:SQLITE_UTF16LE
4330: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
4340: 43 6f 6e 73 74 61 6e 74 73 20 66 6f 72 20 74 68 Constants for th
4350: 65 20 6c 61 72 67 65 73 74 20 61 6e 64 20 73 6d e largest and sm
4360: 61 6c 6c 65 73 74 20 70 6f 73 73 69 62 6c 65 20 allest possible
4370: 36 34 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 64-bit signed in
4380: 74 65 67 65 72 73 2e 0a 2a 2a 20 54 68 65 73 65 tegers..** These
4390: 20 6d 61 63 72 6f 73 20 61 72 65 20 64 65 73 69 macros are desi
43a0: 67 6e 65 64 20 74 6f 20 77 6f 72 6b 20 63 6f 72 gned to work cor
43b0: 72 65 63 74 6c 79 20 6f 6e 20 62 6f 74 68 20 33 rectly on both 3
43c0: 32 2d 62 69 74 20 61 6e 64 20 36 34 2d 62 69 74 2-bit and 64-bit
43d0: 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 73 2e 0a 2a .** compilers..*
43e0: 2f 0a 23 64 65 66 69 6e 65 20 4c 41 52 47 45 53 /.#define LARGES
43f0: 54 5f 49 4e 54 36 34 20 20 28 30 78 66 66 66 66 T_INT64 (0xffff
4400: 66 66 66 66 7c 28 28 28 69 36 34 29 30 78 37 66 ffff|(((i64)0x7f
4410: 66 66 66 66 66 66 29 3c 3c 33 32 29 29 0a 23 64 ffffff)<<32)).#d
4420: 65 66 69 6e 65 20 53 4d 41 4c 4c 45 53 54 5f 49 efine SMALLEST_I
4430: 4e 54 36 34 20 28 28 28 69 36 34 29 2d 31 29 20 NT64 (((i64)-1)
4440: 2d 20 4c 41 52 47 45 53 54 5f 49 4e 54 36 34 29 - LARGEST_INT64)
4450: 0a 0a 2f 2a 20 0a 2a 2a 20 52 6f 75 6e 64 20 75 ../* .** Round u
4460: 70 20 61 20 6e 75 6d 62 65 72 20 74 6f 20 74 68 p a number to th
4470: 65 20 6e 65 78 74 20 6c 61 72 67 65 72 20 6d 75 e next larger mu
4480: 6c 74 69 70 6c 65 20 6f 66 20 38 2e 20 20 54 68 ltiple of 8. Th
4490: 69 73 20 69 73 20 75 73 65 64 0a 2a 2a 20 74 6f is is used.** to
44a0: 20 66 6f 72 63 65 20 38 2d 62 79 74 65 20 61 6c force 8-byte al
44b0: 69 67 6e 6d 65 6e 74 20 6f 6e 20 36 34 2d 62 69 ignment on 64-bi
44c0: 74 20 61 72 63 68 69 74 65 63 74 75 72 65 73 2e t architectures.
44d0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 52 4f 55 4e .*/.#define ROUN
44e0: 44 38 28 78 29 20 20 20 20 20 28 28 28 78 29 2b D8(x) (((x)+
44f0: 37 29 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 52 6f 7)&~7)../*.** Ro
4500: 75 6e 64 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 und down to the
4510: 6e 65 61 72 65 73 74 20 6d 75 6c 74 69 70 6c 65 nearest multiple
4520: 20 6f 66 20 38 0a 2a 2f 0a 23 64 65 66 69 6e 65 of 8.*/.#define
4530: 20 52 4f 55 4e 44 44 4f 57 4e 38 28 78 29 20 28 ROUNDDOWN8(x) (
4540: 28 78 29 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 41 (x)&~7)../*.** A
4550: 73 73 65 72 74 20 74 68 61 74 20 74 68 65 20 70 ssert that the p
4560: 6f 69 6e 74 65 72 20 58 20 69 73 20 61 6c 69 67 ointer X is alig
4570: 6e 65 64 20 74 6f 20 61 6e 20 38 2d 62 79 74 65 ned to an 8-byte
4580: 20 62 6f 75 6e 64 61 72 79 2e 20 20 54 68 69 73 boundary. This
4590: 0a 2a 2a 20 6d 61 63 72 6f 20 69 73 20 75 73 65 .** macro is use
45a0: 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 d only within as
45b0: 73 65 72 74 28 29 20 74 6f 20 76 65 72 69 66 79 sert() to verify
45c0: 20 74 68 61 74 20 74 68 65 20 63 6f 64 65 20 67 that the code g
45d0: 65 74 73 0a 2a 2a 20 61 6c 6c 20 61 6c 69 67 6e ets.** all align
45e0: 6d 65 6e 74 20 72 65 73 74 72 69 63 74 69 6f 6e ment restriction
45f0: 73 20 63 6f 72 72 65 63 74 2e 0a 2a 2a 0a 2a 2a s correct..**.**
4600: 20 45 78 63 65 70 74 2c 20 69 66 20 53 51 4c 49 Except, if SQLI
4610: 54 45 5f 34 5f 42 59 54 45 5f 41 4c 49 47 4e 45 TE_4_BYTE_ALIGNE
4620: 44 5f 4d 41 4c 4c 4f 43 20 69 73 20 64 65 66 69 D_MALLOC is defi
4630: 6e 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 2a 2a ned, then the.**
4640: 20 75 6e 64 65 72 6c 79 69 6e 67 20 6d 61 6c 6c underlying mall
4650: 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 69 6f oc() implementio
4660: 6e 20 6d 69 67 68 74 20 72 65 74 75 72 6e 20 75 n might return u
4670: 73 20 34 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 s 4-byte aligned
4680: 0a 2a 2a 20 70 6f 69 6e 74 65 72 73 2e 20 20 49 .** pointers. I
4690: 6e 20 74 68 61 74 20 63 61 73 65 2c 20 6f 6e 6c n that case, onl
46a0: 79 20 76 65 72 69 66 79 20 34 2d 62 79 74 65 20 y verify 4-byte
46b0: 61 6c 69 67 6e 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 alignment..*/.#i
46c0: 66 64 65 66 20 53 51 4c 49 54 45 5f 34 5f 42 59 fdef SQLITE_4_BY
46d0: 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f TE_ALIGNED_MALLO
46e0: 43 0a 23 20 64 65 66 69 6e 65 20 45 49 47 48 54 C.# define EIGHT
46f0: 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 _BYTE_ALIGNMENT(
4700: 58 29 20 20 20 28 28 28 28 63 68 61 72 2a 29 28 X) ((((char*)(
4710: 58 29 20 2d 20 28 63 68 61 72 2a 29 30 29 26 33 X) - (char*)0)&3
4720: 29 3d 3d 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 )==0).#else.# de
4730: 66 69 6e 65 20 45 49 47 48 54 5f 42 59 54 45 5f fine EIGHT_BYTE_
4740: 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20 20 28 ALIGNMENT(X) (
4750: 28 28 28 63 68 61 72 2a 29 28 58 29 20 2d 20 28 (((char*)(X) - (
4760: 63 68 61 72 2a 29 30 29 26 37 29 3d 3d 30 29 0a char*)0)&7)==0).
4770: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 69 #endif../*.** Di
4780: 73 61 62 6c 65 20 4d 4d 41 50 20 6f 6e 20 70 6c sable MMAP on pl
4790: 61 74 66 6f 72 6d 73 20 77 68 65 72 65 20 69 74 atforms where it
47a0: 20 69 73 20 6b 6e 6f 77 6e 20 74 6f 20 6e 6f 74 is known to not
47b0: 20 77 6f 72 6b 0a 2a 2f 0a 23 69 66 20 64 65 66 work.*/.#if def
47c0: 69 6e 65 64 28 5f 5f 4f 70 65 6e 42 53 44 5f 5f ined(__OpenBSD__
47d0: 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 51 ) || defined(__Q
47e0: 4e 58 4e 54 4f 5f 5f 29 0a 23 20 75 6e 64 65 66 NXNTO__).# undef
47f0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
4800: 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 _SIZE.# define S
4810: 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
4820: 49 5a 45 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a IZE 0.#endif../*
4830: 0a 2a 2a 20 44 65 66 61 75 6c 74 20 6d 61 78 69 .** Default maxi
4840: 6d 75 6d 20 73 69 7a 65 20 6f 66 20 6d 65 6d 6f mum size of memo
4850: 72 79 20 75 73 65 64 20 62 79 20 6d 65 6d 6f 72 ry used by memor
4860: 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 69 6e 20 y-mapped I/O in
4870: 74 68 65 20 56 46 53 0a 2a 2f 0a 23 69 66 64 65 the VFS.*/.#ifde
4880: 66 20 5f 5f 41 50 50 4c 45 5f 5f 0a 23 20 69 6e f __APPLE__.# in
4890: 63 6c 75 64 65 20 3c 54 61 72 67 65 74 43 6f 6e clude <TargetCon
48a0: 64 69 74 69 6f 6e 61 6c 73 2e 68 3e 0a 23 20 69 ditionals.h>.# i
48b0: 66 20 54 41 52 47 45 54 5f 4f 53 5f 49 50 48 4f f TARGET_OS_IPHO
48c0: 4e 45 0a 23 20 20 20 75 6e 64 65 66 20 53 51 4c NE.# undef SQL
48d0: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
48e0: 45 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c E.# define SQL
48f0: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
4900: 45 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 E 0.# endif.#end
4910: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
4920: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a E_MAX_MMAP_SIZE.
4930: 23 20 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 6c # if defined(__l
4940: 69 6e 75 78 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 inux__) \. || d
4950: 65 66 69 6e 65 64 28 5f 57 49 4e 33 32 29 20 5c efined(_WIN32) \
4960: 0a 20 20 7c 7c 20 28 64 65 66 69 6e 65 64 28 5f . || (defined(_
4970: 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 64 65 66 _APPLE__) && def
4980: 69 6e 65 64 28 5f 5f 4d 41 43 48 5f 5f 29 29 20 ined(__MACH__))
4990: 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f \. || defined(_
49a0: 5f 73 75 6e 29 0a 23 20 20 20 64 65 66 69 6e 65 _sun).# define
49b0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
49c0: 5f 53 49 5a 45 20 30 78 37 66 66 66 30 30 30 30 _SIZE 0x7fff0000
49d0: 20 20 2f 2a 20 32 31 34 37 34 31 38 31 31 32 20 /* 2147418112
49e0: 2a 2f 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 */.# else.# de
49f0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f fine SQLITE_MAX_
4a00: 4d 4d 41 50 5f 53 49 5a 45 20 30 0a 23 20 65 6e MMAP_SIZE 0.# en
4a10: 64 69 66 0a 23 20 64 65 66 69 6e 65 20 53 51 4c dif.# define SQL
4a20: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
4a30: 45 5f 78 63 20 31 20 2f 2a 20 65 78 63 6c 75 64 E_xc 1 /* exclud
4a40: 65 20 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a e from ctime.c *
4a50: 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 /.#endif../*.**
4a60: 54 68 65 20 64 65 66 61 75 6c 74 20 4d 4d 41 50 The default MMAP
4a70: 5f 53 49 5a 45 20 69 73 20 7a 65 72 6f 20 6f 6e _SIZE is zero on
4a80: 20 61 6c 6c 20 70 6c 61 74 66 6f 72 6d 73 2e 20 all platforms.
4a90: 20 4f 72 2c 20 65 76 65 6e 20 69 66 20 61 20 6c Or, even if a l
4aa0: 61 72 67 65 72 0a 2a 2a 20 64 65 66 61 75 6c 74 arger.** default
4ab0: 20 4d 4d 41 50 5f 53 49 5a 45 20 69 73 20 73 70 MMAP_SIZE is sp
4ac0: 65 63 69 66 69 65 64 20 61 74 20 63 6f 6d 70 69 ecified at compi
4ad0: 6c 65 2d 74 69 6d 65 2c 20 6d 61 6b 65 20 73 75 le-time, make su
4ae0: 72 65 20 74 68 61 74 20 69 74 20 64 6f 65 73 0a re that it does.
4af0: 2a 2a 20 6e 6f 74 20 65 78 63 65 65 64 20 74 68 ** not exceed th
4b00: 65 20 6d 61 78 69 6d 75 6d 20 6d 6d 61 70 20 73 e maximum mmap s
4b10: 69 7a 65 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ize..*/.#ifndef
4b20: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
4b30: 4d 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e MAP_SIZE.# defin
4b40: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
4b50: 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 0a 23 20 64 _MMAP_SIZE 0.# d
4b60: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 efine SQLITE_DEF
4b70: 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 5f 78 AULT_MMAP_SIZE_x
4b80: 63 20 31 20 20 2f 2a 20 45 78 63 6c 75 64 65 20 c 1 /* Exclude
4b90: 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a 2f 0a from ctime.c */.
4ba0: 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
4bb0: 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 E_DEFAULT_MMAP_S
4bc0: 49 5a 45 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 4d IZE>SQLITE_MAX_M
4bd0: 4d 41 50 5f 53 49 5a 45 0a 23 20 75 6e 64 65 66 MAP_SIZE.# undef
4be0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
4bf0: 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 MMAP_SIZE.# defi
4c00: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
4c10: 54 5f 4d 4d 41 50 5f 53 49 5a 45 20 53 51 4c 49 T_MMAP_SIZE SQLI
4c20: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
4c30: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f .#endif../*.** O
4c40: 6e 6c 79 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 nly one of SQLIT
4c50: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 20 6f E_ENABLE_STAT3 o
4c60: 72 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f r SQLITE_ENABLE_
4c70: 53 54 41 54 34 20 63 61 6e 20 62 65 20 64 65 66 STAT4 can be def
4c80: 69 6e 65 64 2e 0a 2a 2a 20 50 72 69 6f 72 69 74 ined..** Priorit
4c90: 79 20 69 73 20 67 69 76 65 6e 20 74 6f 20 53 51 y is given to SQ
4ca0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
4cb0: 34 2e 20 20 49 66 20 65 69 74 68 65 72 20 61 72 4. If either ar
4cc0: 65 20 64 65 66 69 6e 65 64 2c 20 61 6c 73 6f 0a e defined, also.
4cd0: 2a 2a 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 ** define SQLITE
4ce0: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
4cf0: 5f 53 54 41 54 34 0a 2a 2f 0a 23 69 66 64 65 66 _STAT4.*/.#ifdef
4d00: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
4d10: 54 41 54 34 0a 23 20 75 6e 64 65 66 20 53 51 4c TAT4.# undef SQL
4d20: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 ITE_ENABLE_STAT3
4d30: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
4d40: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
4d50: 5f 53 54 41 54 34 20 31 0a 23 65 6c 69 66 20 53 _STAT4 1.#elif S
4d60: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
4d70: 54 33 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 T3.# define SQLI
4d80: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f TE_ENABLE_STAT3_
4d90: 4f 52 5f 53 54 41 54 34 20 31 0a 23 65 6c 69 66 OR_STAT4 1.#elif
4da0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
4db0: 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 23 20 TAT3_OR_STAT4.#
4dc0: 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 undef SQLITE_ENA
4dd0: 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 BLE_STAT3_OR_STA
4de0: 54 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a T4.#endif../*.**
4df0: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
4e00: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
4e10: 72 75 63 74 75 72 65 20 69 73 20 75 73 65 64 20 ructure is used
4e20: 74 6f 20 73 74 6f 72 65 20 74 68 65 20 62 75 73 to store the bus
4e30: 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c y-handler.** cal
4e40: 6c 62 61 63 6b 20 66 6f 72 20 61 20 67 69 76 65 lback for a give
4e50: 6e 20 73 71 6c 69 74 65 20 68 61 6e 64 6c 65 2e n sqlite handle.
4e60: 20 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 .**.** The sqli
4e70: 74 65 2e 62 75 73 79 48 61 6e 64 6c 65 72 20 6d te.busyHandler m
4e80: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 73 71 6c ember of the sql
4e90: 69 74 65 20 73 74 72 75 63 74 20 63 6f 6e 74 61 ite struct conta
4ea0: 69 6e 73 20 74 68 65 20 62 75 73 79 0a 2a 2a 20 ins the busy.**
4eb0: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 74 68 65 callback for the
4ec0: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
4ed0: 2e 20 45 61 63 68 20 70 61 67 65 72 20 6f 70 65 . Each pager ope
4ee0: 6e 65 64 20 76 69 61 20 74 68 65 20 73 71 6c 69 ned via the sqli
4ef0: 74 65 0a 2a 2a 20 68 61 6e 64 6c 65 20 69 73 20 te.** handle is
4f00: 70 61 73 73 65 64 20 61 20 70 6f 69 6e 74 65 72 passed a pointer
4f10: 20 74 6f 20 73 71 6c 69 74 65 2e 62 75 73 79 48 to sqlite.busyH
4f20: 61 6e 64 6c 65 72 2e 20 54 68 65 20 62 75 73 79 andler. The busy
4f30: 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c -handler.** call
4f40: 62 61 63 6b 20 69 73 20 63 75 72 72 65 6e 74 6c back is currentl
4f50: 79 20 69 6e 76 6f 6b 65 64 20 6f 6e 6c 79 20 66 y invoked only f
4f60: 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 67 65 72 rom within pager
4f70: 2e 63 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 .c..*/.typedef s
4f80: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
4f90: 72 20 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a 73 r BusyHandler;.s
4fa0: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
4fb0: 72 20 7b 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e r {. int (*xFun
4fc0: 63 29 28 76 6f 69 64 20 2a 2c 69 6e 74 29 3b 20 c)(void *,int);
4fd0: 20 2f 2a 20 54 68 65 20 62 75 73 79 20 63 61 6c /* The busy cal
4fe0: 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 lback */. void
4ff0: 2a 70 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 *pArg;
5000: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 /* First a
5010: 72 67 20 74 6f 20 62 75 73 79 20 63 61 6c 6c 62 rg to busy callb
5020: 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 ack */. int nBu
5030: 73 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 sy;
5040: 20 20 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 /* Increment
5050: 65 64 20 77 69 74 68 20 65 61 63 68 20 62 75 73 ed with each bus
5060: 79 20 63 61 6c 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a y call */.};../*
5070: 0a 2a 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 .** Name of the
5080: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 master database
5090: 74 61 62 6c 65 2e 20 20 54 68 65 20 6d 61 73 74 table. The mast
50a0: 65 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c er database tabl
50b0: 65 0a 2a 2a 20 69 73 20 61 20 73 70 65 63 69 61 e.** is a specia
50c0: 6c 20 74 61 62 6c 65 20 74 68 61 74 20 68 6f 6c l table that hol
50d0: 64 73 20 74 68 65 20 6e 61 6d 65 73 20 61 6e 64 ds the names and
50e0: 20 61 74 74 72 69 62 75 74 65 73 20 6f 66 20 61 attributes of a
50f0: 6c 6c 0a 2a 2a 20 75 73 65 72 20 74 61 62 6c 65 ll.** user table
5100: 73 20 61 6e 64 20 69 6e 64 69 63 65 73 2e 0a 2a s and indices..*
5110: 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 54 45 52 /.#define MASTER
5120: 5f 4e 41 4d 45 20 20 20 20 20 20 20 22 73 71 6c _NAME "sql
5130: 69 74 65 5f 6d 61 73 74 65 72 22 0a 23 64 65 66 ite_master".#def
5140: 69 6e 65 20 54 45 4d 50 5f 4d 41 53 54 45 52 5f ine TEMP_MASTER_
5150: 4e 41 4d 45 20 20 22 73 71 6c 69 74 65 5f 74 65 NAME "sqlite_te
5160: 6d 70 5f 6d 61 73 74 65 72 22 0a 0a 2f 2a 0a 2a mp_master"../*.*
5170: 2a 20 54 68 65 20 72 6f 6f 74 2d 70 61 67 65 20 * The root-page
5180: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 64 61 of the master da
5190: 74 61 62 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2f tabase table..*/
51a0: 0a 23 64 65 66 69 6e 65 20 4d 41 53 54 45 52 5f .#define MASTER_
51b0: 52 4f 4f 54 20 20 20 20 20 20 20 31 0a 0a 2f 2a ROOT 1../*
51c0: 0a 2a 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 .** The name of
51d0: 74 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 the schema table
51e0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 43 48 ..*/.#define SCH
51f0: 45 4d 41 5f 54 41 42 4c 45 28 78 29 20 20 28 28 EMA_TABLE(x) ((
5200: 21 4f 4d 49 54 5f 54 45 4d 50 44 42 29 26 26 28 !OMIT_TEMPDB)&&(
5210: 78 3d 3d 31 29 3f 54 45 4d 50 5f 4d 41 53 54 45 x==1)?TEMP_MASTE
5220: 52 5f 4e 41 4d 45 3a 4d 41 53 54 45 52 5f 4e 41 R_NAME:MASTER_NA
5230: 4d 45 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 6f 6e ME)../*.** A con
5240: 76 65 6e 69 65 6e 63 65 20 6d 61 63 72 6f 20 74 venience macro t
5250: 68 61 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 hat returns the
5260: 6e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e number of elemen
5270: 74 73 20 69 6e 0a 2a 2a 20 61 6e 20 61 72 72 61 ts in.** an arra
5280: 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 41 72 y..*/.#define Ar
5290: 72 61 79 53 69 7a 65 28 58 29 20 20 20 20 28 28 raySize(X) ((
52a0: 69 6e 74 29 28 73 69 7a 65 6f 66 28 58 29 2f 73 int)(sizeof(X)/s
52b0: 69 7a 65 6f 66 28 58 5b 30 5d 29 29 29 0a 0a 2f izeof(X[0])))../
52c0: 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 69 *.** Determine i
52d0: 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 69 f the argument i
52e0: 73 20 61 20 70 6f 77 65 72 20 6f 66 20 74 77 6f s a power of two
52f0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 73 50 6f .*/.#define IsPo
5300: 77 65 72 4f 66 54 77 6f 28 58 29 20 28 28 28 58 werOfTwo(X) (((X
5310: 29 26 28 28 58 29 2d 31 29 29 3d 3d 30 29 0a 0a )&((X)-1))==0)..
5320: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow
5330: 69 6e 67 20 76 61 6c 75 65 20 61 73 20 61 20 64 ing value as a d
5340: 65 73 74 72 75 63 74 6f 72 20 6d 65 61 6e 73 20 estructor means
5350: 74 6f 20 75 73 65 20 73 71 6c 69 74 65 33 44 62 to use sqlite3Db
5360: 46 72 65 65 28 29 2e 0a 2a 2a 20 54 68 65 20 73 Free()..** The s
5370: 71 6c 69 74 65 33 44 62 46 72 65 65 28 29 20 72 qlite3DbFree() r
5380: 6f 75 74 69 6e 65 20 72 65 71 75 69 72 65 73 20 outine requires
5390: 74 77 6f 20 70 61 72 61 6d 65 74 65 72 73 20 69 two parameters i
53a0: 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 0a 2a nstead of the .*
53b0: 2a 20 6f 6e 65 20 70 61 72 61 6d 65 74 65 72 20 * one parameter
53c0: 74 68 61 74 20 64 65 73 74 72 75 63 74 6f 72 73 that destructors
53d0: 20 6e 6f 72 6d 61 6c 6c 79 20 77 61 6e 74 2e 20 normally want.
53e0: 20 53 6f 20 77 65 20 68 61 76 65 20 74 6f 20 69 So we have to i
53f0: 6e 74 72 6f 64 75 63 65 20 0a 2a 2a 20 74 68 69 ntroduce .** thi
5400: 73 20 6d 61 67 69 63 20 76 61 6c 75 65 20 74 68 s magic value th
5410: 61 74 20 74 68 65 20 63 6f 64 65 20 6b 6e 6f 77 at the code know
5420: 73 20 74 6f 20 68 61 6e 64 6c 65 20 64 69 66 66 s to handle diff
5430: 65 72 65 6e 74 6c 79 2e 20 20 41 6e 79 20 0a 2a erently. Any .*
5440: 2a 20 70 6f 69 6e 74 65 72 20 77 69 6c 6c 20 77 * pointer will w
5450: 6f 72 6b 20 68 65 72 65 20 61 73 20 6c 6f 6e 67 ork here as long
5460: 20 61 73 20 69 74 20 69 73 20 64 69 73 74 69 6e as it is distin
5470: 63 74 20 66 72 6f 6d 20 53 51 4c 49 54 45 5f 53 ct from SQLITE_S
5480: 54 41 54 49 43 0a 2a 2a 20 61 6e 64 20 53 51 4c TATIC.** and SQL
5490: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 2e 0a 2a ITE_TRANSIENT..*
54a0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
54b0: 5f 44 59 4e 41 4d 49 43 20 20 20 28 28 73 71 6c _DYNAMIC ((sql
54c0: 69 74 65 33 5f 64 65 73 74 72 75 63 74 6f 72 5f ite3_destructor_
54d0: 74 79 70 65 29 73 71 6c 69 74 65 33 4d 61 6c 6c type)sqlite3Mall
54e0: 6f 63 53 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 57 ocSize)../*.** W
54f0: 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f hen SQLITE_OMIT_
5500: 57 53 44 20 69 73 20 64 65 66 69 6e 65 64 2c 20 WSD is defined,
5510: 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 it means that th
5520: 65 20 74 61 72 67 65 74 20 70 6c 61 74 66 6f 72 e target platfor
5530: 6d 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 73 75 m does.** not su
5540: 70 70 6f 72 74 20 57 72 69 74 61 62 6c 65 20 53 pport Writable S
5550: 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 29 tatic Data (WSD)
5560: 20 73 75 63 68 20 61 73 20 67 6c 6f 62 61 6c 20 such as global
5570: 61 6e 64 20 73 74 61 74 69 63 20 76 61 72 69 61 and static varia
5580: 62 6c 65 73 2e 0a 2a 2a 20 41 6c 6c 20 76 61 72 bles..** All var
5590: 69 61 62 6c 65 73 20 6d 75 73 74 20 65 69 74 68 iables must eith
55a0: 65 72 20 62 65 20 6f 6e 20 74 68 65 20 73 74 61 er be on the sta
55b0: 63 6b 20 6f 72 20 64 79 6e 61 6d 69 63 61 6c 6c ck or dynamicall
55c0: 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f 6d y allocated from
55d0: 0a 2a 2a 20 74 68 65 20 68 65 61 70 2e 20 20 57 .** the heap. W
55e0: 68 65 6e 20 57 53 44 20 69 73 20 75 6e 73 75 70 hen WSD is unsup
55f0: 70 6f 72 74 65 64 2c 20 74 68 65 20 76 61 72 69 ported, the vari
5600: 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f 6e able declaration
5610: 73 20 73 63 61 74 74 65 72 65 64 0a 2a 2a 20 74 s scattered.** t
5620: 68 72 6f 75 67 68 6f 75 74 20 74 68 65 20 53 51 hroughout the SQ
5630: 4c 69 74 65 20 63 6f 64 65 20 6d 75 73 74 20 62 Lite code must b
5640: 65 63 6f 6d 65 20 63 6f 6e 73 74 61 6e 74 73 20 ecome constants
5650: 69 6e 73 74 65 61 64 2e 20 20 54 68 65 20 53 51 instead. The SQ
5660: 4c 49 54 45 5f 57 53 44 0a 2a 2a 20 6d 61 63 72 LITE_WSD.** macr
5670: 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 o is used for th
5680: 69 73 20 70 75 72 70 6f 73 65 2e 20 20 41 6e 64 is purpose. And
5690: 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 66 65 instead of refe
56a0: 72 65 6e 63 69 6e 67 20 74 68 65 20 76 61 72 69 rencing the vari
56b0: 61 62 6c 65 0a 2a 2a 20 64 69 72 65 63 74 6c 79 able.** directly
56c0: 2c 20 77 65 20 75 73 65 20 69 74 73 20 63 6f 6e , we use its con
56d0: 73 74 61 6e 74 20 61 73 20 61 20 6b 65 79 20 74 stant as a key t
56e0: 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 72 75 6e o lookup the run
56f0: 2d 74 69 6d 65 20 61 6c 6c 6f 63 61 74 65 64 0a -time allocated.
5700: 2a 2a 20 62 75 66 66 65 72 20 74 68 61 74 20 68 ** buffer that h
5710: 6f 6c 64 73 20 72 65 61 6c 20 76 61 72 69 61 62 olds real variab
5720: 6c 65 2e 20 20 54 68 65 20 63 6f 6e 73 74 61 6e le. The constan
5730: 74 20 69 73 20 61 6c 73 6f 20 74 68 65 20 69 6e t is also the in
5740: 69 74 69 61 6c 69 7a 65 72 0a 2a 2a 20 66 6f 72 itializer.** for
5750: 20 74 68 65 20 72 75 6e 2d 74 69 6d 65 20 61 6c the run-time al
5760: 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e 0a located buffer..
5770: 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 75 73 75 **.** In the usu
5780: 61 6c 20 63 61 73 65 20 77 68 65 72 65 20 57 53 al case where WS
5790: 44 20 69 73 20 73 75 70 70 6f 72 74 65 64 2c 20 D is supported,
57a0: 74 68 65 20 53 51 4c 49 54 45 5f 57 53 44 20 61 the SQLITE_WSD a
57b0: 6e 64 20 47 4c 4f 42 41 4c 0a 2a 2a 20 6d 61 63 nd GLOBAL.** mac
57c0: 72 6f 73 20 62 65 63 6f 6d 65 20 6e 6f 2d 6f 70 ros become no-op
57d0: 73 20 61 6e 64 20 68 61 76 65 20 7a 65 72 6f 20 s and have zero
57e0: 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70 61 performance impa
57f0: 63 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ct..*/.#ifdef SQ
5800: 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 LITE_OMIT_WSD.
5810: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 57 #define SQLITE_W
5820: 53 44 20 63 6f 6e 73 74 0a 20 20 23 64 65 66 69 SD const. #defi
5830: 6e 65 20 47 4c 4f 42 41 4c 28 74 2c 76 29 20 28 ne GLOBAL(t,v) (
5840: 2a 28 74 2a 29 73 71 6c 69 74 65 33 5f 77 73 64 *(t*)sqlite3_wsd
5850: 5f 66 69 6e 64 28 28 76 6f 69 64 2a 29 26 28 76 _find((void*)&(v
5860: 29 2c 20 73 69 7a 65 6f 66 28 76 29 29 29 0a 20 ), sizeof(v))).
5870: 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
5880: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20 47 4c 4f GlobalConfig GLO
5890: 42 41 4c 28 73 74 72 75 63 74 20 53 71 6c 69 74 BAL(struct Sqlit
58a0: 65 33 43 6f 6e 66 69 67 2c 20 73 71 6c 69 74 65 e3Config, sqlite
58b0: 33 43 6f 6e 66 69 67 29 0a 20 20 69 6e 74 20 73 3Config). int s
58c0: 71 6c 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 28 qlite3_wsd_init(
58d0: 69 6e 74 20 4e 2c 20 69 6e 74 20 4a 29 3b 0a 20 int N, int J);.
58e0: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 77 void *sqlite3_w
58f0: 73 64 5f 66 69 6e 64 28 76 6f 69 64 20 2a 4b 2c sd_find(void *K,
5900: 20 69 6e 74 20 4c 29 3b 0a 23 65 6c 73 65 0a 20 int L);.#else.
5910: 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f #define SQLITE_
5920: 57 53 44 20 0a 20 20 23 64 65 66 69 6e 65 20 47 WSD . #define G
5930: 4c 4f 42 41 4c 28 74 2c 76 29 20 76 0a 20 20 23 LOBAL(t,v) v. #
5940: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 6c define sqlite3Gl
5950: 6f 62 61 6c 43 6f 6e 66 69 67 20 73 71 6c 69 74 obalConfig sqlit
5960: 65 33 43 6f 6e 66 69 67 0a 23 65 6e 64 69 66 0a e3Config.#endif.
5970: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
5980: 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 65 20 wing macros are
5990: 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 used to suppress
59a0: 20 63 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e compiler warnin
59b0: 67 73 20 61 6e 64 20 74 6f 0a 2a 2a 20 6d 61 6b gs and to.** mak
59c0: 65 20 69 74 20 63 6c 65 61 72 20 74 6f 20 68 75 e it clear to hu
59d0: 6d 61 6e 20 72 65 61 64 65 72 73 20 77 68 65 6e man readers when
59e0: 20 61 20 66 75 6e 63 74 69 6f 6e 20 70 61 72 61 a function para
59f0: 6d 65 74 65 72 20 69 73 20 64 65 6c 69 62 65 72 meter is deliber
5a00: 61 74 65 6c 79 20 0a 2a 2a 20 6c 65 66 74 20 75 ately .** left u
5a10: 6e 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 nused within the
5a20: 20 62 6f 64 79 20 6f 66 20 61 20 66 75 6e 63 74 body of a funct
5a30: 69 6f 6e 2e 20 54 68 69 73 20 75 73 75 61 6c 6c ion. This usuall
5a40: 79 20 68 61 70 70 65 6e 73 20 77 68 65 6e 0a 2a y happens when.*
5a50: 2a 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 * a function is
5a60: 63 61 6c 6c 65 64 20 76 69 61 20 61 20 66 75 6e called via a fun
5a70: 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e 20 46 ction pointer. F
5a80: 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65 20 0a or example the .
5a90: 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ** implementatio
5aa0: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 61 67 67 72 n of an SQL aggr
5ab0: 65 67 61 74 65 20 73 74 65 70 20 63 61 6c 6c 62 egate step callb
5ac0: 61 63 6b 20 6d 61 79 20 6e 6f 74 20 75 73 65 20 ack may not use
5ad0: 74 68 65 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 the.** parameter
5ae0: 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 65 20 indicating the
5af0: 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 number of argume
5b00: 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 74 68 nts passed to th
5b10: 65 20 61 67 67 72 65 67 61 74 65 2c 0a 2a 2a 20 e aggregate,.**
5b20: 69 66 20 69 74 20 6b 6e 6f 77 73 20 74 68 61 74 if it knows that
5b30: 20 74 68 69 73 20 69 73 20 65 6e 66 6f 72 63 65 this is enforce
5b40: 64 20 65 6c 73 65 77 68 65 72 65 2e 0a 2a 2a 0a d elsewhere..**.
5b50: 2a 2a 20 57 68 65 6e 20 61 20 66 75 6e 63 74 69 ** When a functi
5b60: 6f 6e 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 on parameter is
5b70: 6e 6f 74 20 75 73 65 64 20 61 74 20 61 6c 6c 20 not used at all
5b80: 77 69 74 68 69 6e 20 74 68 65 20 62 6f 64 79 20 within the body
5b90: 6f 66 20 61 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a of a function,.*
5ba0: 2a 20 69 74 20 69 73 20 67 65 6e 65 72 61 6c 6c * it is generall
5bb0: 79 20 6e 61 6d 65 64 20 22 4e 6f 74 55 73 65 64 y named "NotUsed
5bc0: 22 20 6f 72 20 22 4e 6f 74 55 73 65 64 32 22 20 " or "NotUsed2"
5bd0: 74 6f 20 6d 61 6b 65 20 74 68 69 6e 67 73 20 65 to make things e
5be0: 76 65 6e 20 63 6c 65 61 72 65 72 2e 0a 2a 2a 20 ven clearer..**
5bf0: 48 6f 77 65 76 65 72 2c 20 74 68 65 73 65 20 6d However, these m
5c00: 61 63 72 6f 73 20 6d 61 79 20 61 6c 73 6f 20 62 acros may also b
5c10: 65 20 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 e used to suppre
5c20: 73 73 20 77 61 72 6e 69 6e 67 73 20 72 65 6c 61 ss warnings rela
5c30: 74 65 64 20 74 6f 0a 2a 2a 20 70 61 72 61 6d 65 ted to.** parame
5c40: 74 65 72 73 20 74 68 61 74 20 6d 61 79 20 6f 72 ters that may or
5c50: 20 6d 61 79 20 6e 6f 74 20 62 65 20 75 73 65 64 may not be used
5c60: 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f depending on co
5c70: 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 74 69 6f 6e mpilation option
5c80: 73 2e 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c s..** For exampl
5c90: 65 20 74 68 6f 73 65 20 70 61 72 61 6d 65 74 65 e those paramete
5ca0: 72 73 20 6f 6e 6c 79 20 75 73 65 64 20 69 6e 20 rs only used in
5cb0: 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
5cc0: 6e 74 73 2e 20 49 6e 20 74 68 65 73 65 0a 2a 2a nts. In these.**
5cd0: 20 63 61 73 65 73 20 74 68 65 20 70 61 72 61 6d cases the param
5ce0: 65 74 65 72 73 20 61 72 65 20 6e 61 6d 65 64 20 eters are named
5cf0: 61 73 20 70 65 72 20 74 68 65 20 75 73 75 61 6c as per the usual
5d00: 20 63 6f 6e 76 65 6e 74 69 6f 6e 73 2e 0a 2a 2f conventions..*/
5d10: 0a 23 64 65 66 69 6e 65 20 55 4e 55 53 45 44 5f .#define UNUSED_
5d20: 50 41 52 41 4d 45 54 45 52 28 78 29 20 28 76 6f PARAMETER(x) (vo
5d30: 69 64 29 28 78 29 0a 23 64 65 66 69 6e 65 20 55 id)(x).#define U
5d40: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 NUSED_PARAMETER2
5d50: 28 78 2c 79 29 20 55 4e 55 53 45 44 5f 50 41 52 (x,y) UNUSED_PAR
5d60: 41 4d 45 54 45 52 28 78 29 2c 55 4e 55 53 45 44 AMETER(x),UNUSED
5d70: 5f 50 41 52 41 4d 45 54 45 52 28 79 29 0a 0a 2f _PARAMETER(y)../
5d80: 2a 0a 2a 2a 20 46 6f 72 77 61 72 64 20 72 65 66 *.** Forward ref
5d90: 65 72 65 6e 63 65 73 20 74 6f 20 73 74 72 75 63 erences to struc
5da0: 74 75 72 65 73 0a 2a 2f 0a 74 79 70 65 64 65 66 tures.*/.typedef
5db0: 20 73 74 72 75 63 74 20 41 67 67 49 6e 66 6f 20 struct AggInfo
5dc0: 41 67 67 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 AggInfo;.typedef
5dd0: 20 73 74 72 75 63 74 20 41 75 74 68 43 6f 6e 74 struct AuthCont
5de0: 65 78 74 20 41 75 74 68 43 6f 6e 74 65 78 74 3b ext AuthContext;
5df0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
5e00: 41 75 74 6f 69 6e 63 49 6e 66 6f 20 41 75 74 6f AutoincInfo Auto
5e10: 69 6e 63 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 incInfo;.typedef
5e20: 20 73 74 72 75 63 74 20 42 69 74 76 65 63 20 42 struct Bitvec B
5e30: 69 74 76 65 63 3b 0a 74 79 70 65 64 65 66 20 73 itvec;.typedef s
5e40: 74 72 75 63 74 20 43 6f 6c 6c 53 65 71 20 43 6f truct CollSeq Co
5e50: 6c 6c 53 65 71 3b 0a 74 79 70 65 64 65 66 20 73 llSeq;.typedef s
5e60: 74 72 75 63 74 20 43 6f 6c 75 6d 6e 20 43 6f 6c truct Column Col
5e70: 75 6d 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 umn;.typedef str
5e80: 75 63 74 20 44 62 20 44 62 3b 0a 74 79 70 65 64 uct Db Db;.typed
5e90: 65 66 20 73 74 72 75 63 74 20 53 63 68 65 6d 61 ef struct Schema
5ea0: 20 53 63 68 65 6d 61 3b 0a 74 79 70 65 64 65 66 Schema;.typedef
5eb0: 20 73 74 72 75 63 74 20 45 78 70 72 20 45 78 70 struct Expr Exp
5ec0: 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 r;.typedef struc
5ed0: 74 20 45 78 70 72 4c 69 73 74 20 45 78 70 72 4c t ExprList ExprL
5ee0: 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ist;.typedef str
5ef0: 75 63 74 20 45 78 70 72 53 70 61 6e 20 45 78 70 uct ExprSpan Exp
5f00: 72 53 70 61 6e 3b 0a 74 79 70 65 64 65 66 20 73 rSpan;.typedef s
5f10: 74 72 75 63 74 20 46 4b 65 79 20 46 4b 65 79 3b truct FKey FKey;
5f20: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
5f30: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 46 FuncDestructor F
5f40: 75 6e 63 44 65 73 74 72 75 63 74 6f 72 3b 0a 74 uncDestructor;.t
5f50: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 ypedef struct Fu
5f60: 6e 63 44 65 66 20 46 75 6e 63 44 65 66 3b 0a 74 ncDef FuncDef;.t
5f70: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 ypedef struct Fu
5f80: 6e 63 44 65 66 48 61 73 68 20 46 75 6e 63 44 65 ncDefHash FuncDe
5f90: 66 48 61 73 68 3b 0a 74 79 70 65 64 65 66 20 73 fHash;.typedef s
5fa0: 74 72 75 63 74 20 49 64 4c 69 73 74 20 49 64 4c truct IdList IdL
5fb0: 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ist;.typedef str
5fc0: 75 63 74 20 49 6e 64 65 78 20 49 6e 64 65 78 3b uct Index Index;
5fd0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
5fe0: 49 6e 64 65 78 53 61 6d 70 6c 65 20 49 6e 64 65 IndexSample Inde
5ff0: 78 53 61 6d 70 6c 65 3b 0a 74 79 70 65 64 65 66 xSample;.typedef
6000: 20 73 74 72 75 63 74 20 4b 65 79 43 6c 61 73 73 struct KeyClass
6010: 20 4b 65 79 43 6c 61 73 73 3b 0a 74 79 70 65 64 KeyClass;.typed
6020: 65 66 20 73 74 72 75 63 74 20 4b 65 79 49 6e 66 ef struct KeyInf
6030: 6f 20 4b 65 79 49 6e 66 6f 3b 0a 74 79 70 65 64 o KeyInfo;.typed
6040: 65 66 20 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 ef struct Lookas
6050: 69 64 65 20 4c 6f 6f 6b 61 73 69 64 65 3b 0a 74 ide Lookaside;.t
6060: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 4c 6f ypedef struct Lo
6070: 6f 6b 61 73 69 64 65 53 6c 6f 74 20 4c 6f 6f 6b okasideSlot Look
6080: 61 73 69 64 65 53 6c 6f 74 3b 0a 74 79 70 65 64 asideSlot;.typed
6090: 65 66 20 73 74 72 75 63 74 20 4d 6f 64 75 6c 65 ef struct Module
60a0: 20 4d 6f 64 75 6c 65 3b 0a 74 79 70 65 64 65 66 Module;.typedef
60b0: 20 73 74 72 75 63 74 20 4e 61 6d 65 43 6f 6e 74 struct NameCont
60c0: 65 78 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 3b ext NameContext;
60d0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
60e0: 50 61 72 73 65 20 50 61 72 73 65 3b 0a 74 79 70 Parse Parse;.typ
60f0: 65 64 65 66 20 73 74 72 75 63 74 20 50 72 69 6e edef struct Prin
6100: 74 66 41 72 67 75 6d 65 6e 74 73 20 50 72 69 6e tfArguments Prin
6110: 74 66 41 72 67 75 6d 65 6e 74 73 3b 0a 74 79 70 tfArguments;.typ
6120: 65 64 65 66 20 73 74 72 75 63 74 20 52 6f 77 53 edef struct RowS
6130: 65 74 20 52 6f 77 53 65 74 3b 0a 74 79 70 65 64 et RowSet;.typed
6140: 65 66 20 73 74 72 75 63 74 20 53 61 76 65 70 6f ef struct Savepo
6150: 69 6e 74 20 53 61 76 65 70 6f 69 6e 74 3b 0a 74 int Savepoint;.t
6160: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 65 ypedef struct Se
6170: 6c 65 63 74 20 53 65 6c 65 63 74 3b 0a 74 79 70 lect Select;.typ
6180: 65 64 65 66 20 73 74 72 75 63 74 20 53 65 6c 65 edef struct Sele
6190: 63 74 44 65 73 74 20 53 65 6c 65 63 74 44 65 73 ctDest SelectDes
61a0: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
61b0: 74 20 53 72 63 4c 69 73 74 20 53 72 63 4c 69 73 t SrcList SrcLis
61c0: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
61d0: 74 20 53 74 72 41 63 63 75 6d 20 53 74 72 41 63 t StrAccum StrAc
61e0: 63 75 6d 3b 0a 74 79 70 65 64 65 66 20 73 74 72 cum;.typedef str
61f0: 75 63 74 20 54 61 62 6c 65 20 54 61 62 6c 65 3b uct Table Table;
6200: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6210: 54 61 62 6c 65 4c 6f 63 6b 20 54 61 62 6c 65 4c TableLock TableL
6220: 6f 63 6b 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ock;.typedef str
6230: 75 63 74 20 54 6f 6b 65 6e 20 54 6f 6b 65 6e 3b uct Token Token;
6240: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6250: 54 72 69 67 67 65 72 20 54 72 69 67 67 65 72 3b Trigger Trigger;
6260: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6270: 54 72 69 67 67 65 72 50 72 67 20 54 72 69 67 67 TriggerPrg Trigg
6280: 65 72 50 72 67 3b 0a 74 79 70 65 64 65 66 20 73 erPrg;.typedef s
6290: 74 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 truct TriggerSte
62a0: 70 20 54 72 69 67 67 65 72 53 74 65 70 3b 0a 74 p TriggerStep;.t
62b0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 55 6e ypedef struct Un
62c0: 70 61 63 6b 65 64 52 65 63 6f 72 64 20 55 6e 70 packedRecord Unp
62d0: 61 63 6b 65 64 52 65 63 6f 72 64 3b 0a 74 79 70 ackedRecord;.typ
62e0: 65 64 65 66 20 73 74 72 75 63 74 20 56 54 61 62 edef struct VTab
62f0: 6c 65 20 56 54 61 62 6c 65 3b 0a 74 79 70 65 64 le VTable;.typed
6300: 65 66 20 73 74 72 75 63 74 20 56 74 61 62 43 74 ef struct VtabCt
6310: 78 20 56 74 61 62 43 74 78 3b 0a 74 79 70 65 64 x VtabCtx;.typed
6320: 65 66 20 73 74 72 75 63 74 20 57 61 6c 6b 65 72 ef struct Walker
6330: 20 57 61 6c 6b 65 72 3b 0a 74 79 70 65 64 65 66 Walker;.typedef
6340: 20 73 74 72 75 63 74 20 57 68 65 72 65 49 6e 66 struct WhereInf
6350: 6f 20 57 68 65 72 65 49 6e 66 6f 3b 0a 74 79 70 o WhereInfo;.typ
6360: 65 64 65 66 20 73 74 72 75 63 74 20 57 69 74 68 edef struct With
6370: 20 57 69 74 68 3b 0a 0a 2f 2a 0a 2a 2a 20 44 65 With;../*.** De
6380: 66 65 72 20 73 6f 75 72 63 69 6e 67 20 76 64 62 fer sourcing vdb
6390: 65 2e 68 20 61 6e 64 20 62 74 72 65 65 2e 68 20 e.h and btree.h
63a0: 75 6e 74 69 6c 20 61 66 74 65 72 20 74 68 65 20 until after the
63b0: 22 75 38 22 20 61 6e 64 20 0a 2a 2a 20 22 42 75 "u8" and .** "Bu
63c0: 73 79 48 61 6e 64 6c 65 72 22 20 74 79 70 65 64 syHandler" typed
63d0: 65 66 73 2e 20 76 64 62 65 2e 68 20 61 6c 73 6f efs. vdbe.h also
63e0: 20 72 65 71 75 69 72 65 73 20 61 20 66 65 77 20 requires a few
63f0: 6f 66 20 74 68 65 20 6f 70 61 71 75 65 0a 2a 2a of the opaque.**
6400: 20 70 6f 69 6e 74 65 72 20 74 79 70 65 73 20 28 pointer types (
6410: 69 2e 65 2e 20 46 75 6e 63 44 65 66 29 20 64 65 i.e. FuncDef) de
6420: 66 69 6e 65 64 20 61 62 6f 76 65 2e 0a 2a 2f 0a fined above..*/.
6430: 23 69 6e 63 6c 75 64 65 20 22 62 74 72 65 65 2e #include "btree.
6440: 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 76 64 62 h".#include "vdb
6450: 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 70 e.h".#include "p
6460: 61 67 65 72 2e 68 22 0a 23 69 6e 63 6c 75 64 65 ager.h".#include
6470: 20 22 70 63 61 63 68 65 2e 68 22 0a 0a 23 69 6e "pcache.h"..#in
6480: 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 69 6e clude "os.h".#in
6490: 63 6c 75 64 65 20 22 6d 75 74 65 78 2e 68 22 0a clude "mutex.h".
64a0: 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 64 61 74 ../*.** Each dat
64b0: 61 62 61 73 65 20 66 69 6c 65 20 74 6f 20 62 65 abase file to be
64c0: 20 61 63 63 65 73 73 65 64 20 62 79 20 74 68 65 accessed by the
64d0: 20 73 79 73 74 65 6d 20 69 73 20 61 6e 20 69 6e system is an in
64e0: 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 65 stance.** of the
64f0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
6500: 74 75 72 65 2e 20 20 54 68 65 72 65 20 61 72 65 ture. There are
6510: 20 6e 6f 72 6d 61 6c 6c 79 20 74 77 6f 20 6f 66 normally two of
6520: 20 74 68 65 73 65 20 73 74 72 75 63 74 75 72 65 these structure
6530: 73 0a 2a 2a 20 69 6e 20 74 68 65 20 73 71 6c 69 s.** in the sqli
6540: 74 65 2e 61 44 62 5b 5d 20 61 72 72 61 79 2e 20 te.aDb[] array.
6550: 20 61 44 62 5b 30 5d 20 69 73 20 74 68 65 20 6d aDb[0] is the m
6560: 61 69 6e 20 64 61 74 61 62 61 73 65 20 66 69 6c ain database fil
6570: 65 20 61 6e 64 0a 2a 2a 20 61 44 62 5b 31 5d 20 e and.** aDb[1]
6580: 69 73 20 74 68 65 20 64 61 74 61 62 61 73 65 20 is the database
6590: 66 69 6c 65 20 75 73 65 64 20 74 6f 20 68 6f 6c file used to hol
65a0: 64 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c d temporary tabl
65b0: 65 73 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c 0a es. Additional.
65c0: 2a 2a 20 64 61 74 61 62 61 73 65 73 20 6d 61 79 ** databases may
65d0: 20 62 65 20 61 74 74 61 63 68 65 64 2e 0a 2a 2f be attached..*/
65e0: 0a 73 74 72 75 63 74 20 44 62 20 7b 0a 20 20 63 .struct Db {. c
65f0: 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
6600: 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
6610: 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a his database */.
6620: 20 20 42 74 72 65 65 20 2a 70 42 74 3b 20 20 20 Btree *pBt;
6630: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 42 2a /* The B*
6640: 54 72 65 65 20 73 74 72 75 63 74 75 72 65 20 66 Tree structure f
6650: 6f 72 20 74 68 69 73 20 64 61 74 61 62 61 73 65 or this database
6660: 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 73 61 file */. u8 sa
6670: 66 65 74 79 5f 6c 65 76 65 6c 3b 20 20 20 20 20 fety_level;
6680: 2f 2a 20 48 6f 77 20 61 67 67 72 65 73 73 69 76 /* How aggressiv
6690: 65 20 61 74 20 73 79 6e 63 69 6e 67 20 64 61 74 e at syncing dat
66a0: 61 20 74 6f 20 64 69 73 6b 20 2a 2f 0a 20 20 53 a to disk */. S
66b0: 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 chema *pSchema;
66c0: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
66d0: 6f 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d o database schem
66e0: 61 20 28 70 6f 73 73 69 62 6c 79 20 73 68 61 72 a (possibly shar
66f0: 65 64 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ed) */.};../*.**
6700: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
6710: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
6720: 72 75 63 74 75 72 65 20 73 74 6f 72 65 73 20 61 ructure stores a
6730: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
6740: 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 73 74 20 53 63 68 ..**.** Most Sch
6750: 65 6d 61 20 6f 62 6a 65 63 74 73 20 61 72 65 20 ema objects are
6760: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
6770: 61 20 42 74 72 65 65 2e 20 20 54 68 65 20 65 78 a Btree. The ex
6780: 63 65 70 74 69 6f 6e 20 69 73 0a 2a 2a 20 74 68 ception is.** th
6790: 65 20 53 63 68 65 6d 61 20 66 6f 72 20 74 68 65 e Schema for the
67a0: 20 54 45 4d 50 20 64 61 74 61 62 61 65 73 20 28 TEMP databaes (
67b0: 73 71 6c 69 74 65 33 2e 61 44 62 5b 31 5d 29 20 sqlite3.aDb[1])
67c0: 77 68 69 63 68 20 69 73 20 66 72 65 65 2d 73 74 which is free-st
67d0: 61 6e 64 69 6e 67 2e 0a 2a 2a 20 49 6e 20 73 68 anding..** In sh
67e0: 61 72 65 64 20 63 61 63 68 65 20 6d 6f 64 65 2c ared cache mode,
67f0: 20 61 20 73 69 6e 67 6c 65 20 53 63 68 65 6d 61 a single Schema
6800: 20 6f 62 6a 65 63 74 20 63 61 6e 20 62 65 20 73 object can be s
6810: 68 61 72 65 64 20 62 79 20 6d 75 6c 74 69 70 6c hared by multipl
6820: 65 0a 2a 2a 20 42 74 72 65 65 73 20 74 68 61 74 e.** Btrees that
6830: 20 72 65 66 65 72 20 74 6f 20 74 68 65 20 73 61 refer to the sa
6840: 6d 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 42 74 me underlying Bt
6850: 53 68 61 72 65 64 20 6f 62 6a 65 63 74 2e 0a 2a Shared object..*
6860: 2a 20 0a 2a 2a 20 53 63 68 65 6d 61 20 6f 62 6a * .** Schema obj
6870: 65 63 74 73 20 61 72 65 20 61 75 74 6f 6d 61 74 ects are automat
6880: 69 63 61 6c 6c 79 20 64 65 61 6c 6c 6f 63 61 74 ically deallocat
6890: 65 64 20 77 68 65 6e 20 74 68 65 20 6c 61 73 74 ed when the last
68a0: 20 42 74 72 65 65 20 74 68 61 74 0a 2a 2a 20 72 Btree that.** r
68b0: 65 66 65 72 65 6e 63 65 73 20 74 68 65 6d 20 69 eferences them i
68c0: 73 20 64 65 73 74 72 6f 79 65 64 2e 20 20 20 54 s destroyed. T
68d0: 68 65 20 54 45 4d 50 20 53 63 68 65 6d 61 20 69 he TEMP Schema i
68e0: 73 20 6d 61 6e 75 61 6c 6c 79 20 66 72 65 65 64 s manually freed
68f0: 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 by.** sqlite3_c
6900: 6c 6f 73 65 28 29 2e 0a 2a 0a 2a 2a 20 41 20 74 lose()..*.** A t
6910: 68 72 65 61 64 20 6d 75 73 74 20 62 65 20 68 6f hread must be ho
6920: 6c 64 69 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e lding a mutex on
6930: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
6940: 6e 67 20 42 74 72 65 65 20 69 6e 20 6f 72 64 65 ng Btree in orde
6950: 72 0a 2a 2a 20 74 6f 20 61 63 63 65 73 73 20 53 r.** to access S
6960: 63 68 65 6d 61 20 63 6f 6e 74 65 6e 74 2e 20 20 chema content.
6970: 54 68 69 73 20 69 6d 70 6c 69 65 73 20 74 68 61 This implies tha
6980: 74 20 74 68 65 20 74 68 72 65 61 64 20 6d 75 73 t the thread mus
6990: 74 20 61 6c 73 6f 20 62 65 0a 2a 2a 20 68 6f 6c t also be.** hol
69a0: 64 69 6e 67 20 61 20 6d 75 74 65 78 20 6f 6e 20 ding a mutex on
69b0: 74 68 65 20 73 71 6c 69 74 65 33 20 63 6f 6e 6e the sqlite3 conn
69c0: 65 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 20 74 ection pointer t
69d0: 68 61 74 20 6f 77 6e 73 20 74 68 65 20 42 74 72 hat owns the Btr
69e0: 65 65 2e 0a 2a 2a 20 46 6f 72 20 61 20 54 45 4d ee..** For a TEM
69f0: 50 20 53 63 68 65 6d 61 2c 20 6f 6e 6c 79 20 74 P Schema, only t
6a00: 68 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6d 75 he connection mu
6a10: 74 65 78 20 69 73 20 72 65 71 75 69 72 65 64 2e tex is required.
6a20: 0a 2a 2f 0a 73 74 72 75 63 74 20 53 63 68 65 6d .*/.struct Schem
6a30: 61 20 7b 0a 20 20 69 6e 74 20 73 63 68 65 6d 61 a {. int schema
6a40: 5f 63 6f 6f 6b 69 65 3b 20 20 20 2f 2a 20 44 61 _cookie; /* Da
6a50: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 76 65 tabase schema ve
6a60: 72 73 69 6f 6e 20 6e 75 6d 62 65 72 20 66 6f 72 rsion number for
6a70: 20 74 68 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 this file */.
6a80: 69 6e 74 20 69 47 65 6e 65 72 61 74 69 6f 6e 3b int iGeneration;
6a90: 20 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 69 /* Generati
6aa0: 6f 6e 20 63 6f 75 6e 74 65 72 2e 20 20 49 6e 63 on counter. Inc
6ab0: 72 65 6d 65 6e 74 65 64 20 77 69 74 68 20 65 61 remented with ea
6ac0: 63 68 20 63 68 61 6e 67 65 20 2a 2f 0a 20 20 48 ch change */. H
6ad0: 61 73 68 20 74 62 6c 48 61 73 68 3b 20 20 20 20 ash tblHash;
6ae0: 20 20 20 20 2f 2a 20 41 6c 6c 20 74 61 62 6c 65 /* All table
6af0: 73 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d s indexed by nam
6b00: 65 20 2a 2f 0a 20 20 48 61 73 68 20 69 64 78 48 e */. Hash idxH
6b10: 61 73 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 ash; /* A
6b20: 6c 6c 20 28 6e 61 6d 65 64 29 20 69 6e 64 69 63 ll (named) indic
6b30: 65 73 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 es indexed by na
6b40: 6d 65 20 2a 2f 0a 20 20 48 61 73 68 20 74 72 69 me */. Hash tri
6b50: 67 48 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 gHash; /*
6b60: 41 6c 6c 20 74 72 69 67 67 65 72 73 20 69 6e 64 All triggers ind
6b70: 65 78 65 64 20 62 79 20 6e 61 6d 65 20 2a 2f 0a exed by name */.
6b80: 20 20 48 61 73 68 20 66 6b 65 79 48 61 73 68 3b Hash fkeyHash;
6b90: 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 66 6f /* All fo
6ba0: 72 65 69 67 6e 20 6b 65 79 73 20 62 79 20 72 65 reign keys by re
6bb0: 66 65 72 65 6e 63 65 64 20 74 61 62 6c 65 20 6e ferenced table n
6bc0: 61 6d 65 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a ame */. Table *
6bd0: 70 53 65 71 54 61 62 3b 20 20 20 20 20 20 2f 2a pSeqTab; /*
6be0: 20 54 68 65 20 73 71 6c 69 74 65 5f 73 65 71 75 The sqlite_sequ
6bf0: 65 6e 63 65 20 74 61 62 6c 65 20 75 73 65 64 20 ence table used
6c00: 62 79 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 by AUTOINCREMENT
6c10: 20 2a 2f 0a 20 20 75 38 20 66 69 6c 65 5f 66 6f */. u8 file_fo
6c20: 72 6d 61 74 3b 20 20 20 20 20 20 2f 2a 20 53 63 rmat; /* Sc
6c30: 68 65 6d 61 20 66 6f 72 6d 61 74 20 76 65 72 73 hema format vers
6c40: 69 6f 6e 20 66 6f 72 20 74 68 69 73 20 66 69 6c ion for this fil
6c50: 65 20 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 e */. u8 enc;
6c60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
6c70: 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 75 73 65 ext encoding use
6c80: 64 20 62 79 20 74 68 69 73 20 64 61 74 61 62 61 d by this databa
6c90: 73 65 20 2a 2f 0a 20 20 75 31 36 20 66 6c 61 67 se */. u16 flag
6ca0: 73 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 s; /*
6cb0: 46 6c 61 67 73 20 61 73 73 6f 63 69 61 74 65 64 Flags associated
6cc0: 20 77 69 74 68 20 74 68 69 73 20 73 63 68 65 6d with this schem
6cd0: 61 20 2a 2f 0a 20 20 69 6e 74 20 63 61 63 68 65 a */. int cache
6ce0: 5f 73 69 7a 65 3b 20 20 20 20 20 20 2f 2a 20 4e _size; /* N
6cf0: 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 20 74 umber of pages t
6d00: 6f 20 75 73 65 20 69 6e 20 74 68 65 20 63 61 63 o use in the cac
6d10: 68 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 he */.};../*.**
6d20: 54 68 65 73 65 20 6d 61 63 72 6f 73 20 63 61 6e These macros can
6d30: 20 62 65 20 75 73 65 64 20 74 6f 20 74 65 73 74 be used to test
6d40: 2c 20 73 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 , set, or clear
6d50: 62 69 74 73 20 69 6e 20 74 68 65 20 0a 2a 2a 20 bits in the .**
6d60: 44 62 2e 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 Db.pSchema->flag
6d70: 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 64 65 66 s field..*/.#def
6d80: 69 6e 65 20 44 62 48 61 73 50 72 6f 70 65 72 74 ine DbHasPropert
6d90: 79 28 44 2c 49 2c 50 29 20 20 20 20 20 28 28 28 y(D,I,P) (((
6da0: 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 D)->aDb[I].pSche
6db0: 6d 61 2d 3e 66 6c 61 67 73 26 28 50 29 29 3d 3d ma->flags&(P))==
6dc0: 28 50 29 29 0a 23 64 65 66 69 6e 65 20 44 62 48 (P)).#define DbH
6dd0: 61 73 41 6e 79 50 72 6f 70 65 72 74 79 28 44 2c asAnyProperty(D,
6de0: 49 2c 50 29 20 20 28 28 28 44 29 2d 3e 61 44 62 I,P) (((D)->aDb
6df0: 5b 49 5d 2e 70 53 63 68 65 6d 61 2d 3e 66 6c 61 [I].pSchema->fla
6e00: 67 73 26 28 50 29 29 21 3d 30 29 0a 23 64 65 66 gs&(P))!=0).#def
6e10: 69 6e 65 20 44 62 53 65 74 50 72 6f 70 65 72 74 ine DbSetPropert
6e20: 79 28 44 2c 49 2c 50 29 20 20 20 20 20 28 44 29 y(D,I,P) (D)
6e30: 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 ->aDb[I].pSchema
6e40: 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 0a 23 64 65 ->flags|=(P).#de
6e50: 66 69 6e 65 20 44 62 43 6c 65 61 72 50 72 6f 70 fine DbClearProp
6e60: 65 72 74 79 28 44 2c 49 2c 50 29 20 20 20 28 44 erty(D,I,P) (D
6e70: 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d )->aDb[I].pSchem
6e80: 61 2d 3e 66 6c 61 67 73 26 3d 7e 28 50 29 0a 0a a->flags&=~(P)..
6e90: 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 /*.** Allowed va
6ea0: 6c 75 65 73 20 66 6f 72 20 74 68 65 20 44 42 2e lues for the DB.
6eb0: 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 20 66 pSchema->flags f
6ec0: 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 ield..**.** The
6ed0: 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 DB_SchemaLoaded
6ee0: 66 6c 61 67 20 69 73 20 73 65 74 20 61 66 74 65 flag is set afte
6ef0: 72 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 r the database s
6f00: 63 68 65 6d 61 20 68 61 73 20 62 65 65 6e 0a 2a chema has been.*
6f10: 2a 20 72 65 61 64 20 69 6e 74 6f 20 69 6e 74 65 * read into inte
6f20: 72 6e 61 6c 20 68 61 73 68 20 74 61 62 6c 65 73 rnal hash tables
6f30: 2e 0a 2a 2a 0a 2a 2a 20 44 42 5f 55 6e 72 65 73 ..**.** DB_Unres
6f40: 65 74 56 69 65 77 73 20 6d 65 61 6e 73 20 74 68 etViews means th
6f50: 61 74 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 76 at one or more v
6f60: 69 65 77 73 20 68 61 76 65 20 63 6f 6c 75 6d 6e iews have column
6f70: 20 6e 61 6d 65 73 20 74 68 61 74 0a 2a 2a 20 68 names that.** h
6f80: 61 76 65 20 62 65 65 6e 20 66 69 6c 6c 65 64 20 ave been filled
6f90: 6f 75 74 2e 20 20 49 66 20 74 68 65 20 73 63 68 out. If the sch
6fa0: 65 6d 61 20 63 68 61 6e 67 65 73 2c 20 74 68 65 ema changes, the
6fb0: 73 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 se column names
6fc0: 6d 69 67 68 74 0a 2a 2a 20 63 68 61 6e 67 65 73 might.** changes
6fd0: 20 61 6e 64 20 73 6f 20 74 68 65 20 76 69 65 77 and so the view
6fe0: 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 62 65 will need to be
6ff0: 20 72 65 73 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 reset..*/.#defi
7000: 6e 65 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 ne DB_SchemaLoad
7010: 65 64 20 20 20 20 30 78 30 30 30 31 20 20 2f 2a ed 0x0001 /*
7020: 20 54 68 65 20 73 63 68 65 6d 61 20 68 61 73 20 The schema has
7030: 62 65 65 6e 20 6c 6f 61 64 65 64 20 2a 2f 0a 23 been loaded */.#
7040: 64 65 66 69 6e 65 20 44 42 5f 55 6e 72 65 73 65 define DB_Unrese
7050: 74 56 69 65 77 73 20 20 20 20 30 78 30 30 30 32 tViews 0x0002
7060: 20 20 2f 2a 20 53 6f 6d 65 20 76 69 65 77 73 20 /* Some views
7070: 68 61 76 65 20 64 65 66 69 6e 65 64 20 63 6f 6c have defined col
7080: 75 6d 6e 20 6e 61 6d 65 73 20 2a 2f 0a 23 64 65 umn names */.#de
7090: 66 69 6e 65 20 44 42 5f 45 6d 70 74 79 20 20 20 fine DB_Empty
70a0: 20 20 20 20 20 20 20 20 30 78 30 30 30 34 20 20 0x0004
70b0: 2f 2a 20 54 68 65 20 66 69 6c 65 20 69 73 20 65 /* The file is e
70c0: 6d 70 74 79 20 28 6c 65 6e 67 74 68 20 30 20 62 mpty (length 0 b
70d0: 79 74 65 73 29 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 ytes) */../*.**
70e0: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 64 69 The number of di
70f0: 66 66 65 72 65 6e 74 20 6b 69 6e 64 73 20 6f 66 fferent kinds of
7100: 20 74 68 69 6e 67 73 20 74 68 61 74 20 63 61 6e things that can
7110: 20 62 65 20 6c 69 6d 69 74 65 64 0a 2a 2a 20 75 be limited.** u
7120: 73 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65 33 sing the sqlite3
7130: 5f 6c 69 6d 69 74 28 29 20 69 6e 74 65 72 66 61 _limit() interfa
7140: 63 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ce..*/.#define S
7150: 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 20 28 53 QLITE_N_LIMIT (S
7160: 51 4c 49 54 45 5f 4c 49 4d 49 54 5f 54 52 49 47 QLITE_LIMIT_TRIG
7170: 47 45 52 5f 44 45 50 54 48 2b 31 29 0a 0a 2f 2a GER_DEPTH+1)../*
7180: 0a 2a 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 6d 61 .** Lookaside ma
7190: 6c 6c 6f 63 20 69 73 20 61 20 73 65 74 20 6f 66 lloc is a set of
71a0: 20 66 69 78 65 64 2d 73 69 7a 65 20 62 75 66 66 fixed-size buff
71b0: 65 72 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 ers that can be
71c0: 75 73 65 64 0a 2a 2a 20 74 6f 20 73 61 74 69 73 used.** to satis
71d0: 66 79 20 73 6d 61 6c 6c 20 74 72 61 6e 73 69 65 fy small transie
71e0: 6e 74 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 nt memory alloca
71f0: 74 69 6f 6e 20 72 65 71 75 65 73 74 73 20 66 6f tion requests fo
7200: 72 20 6f 62 6a 65 63 74 73 0a 2a 2a 20 61 73 73 r objects.** ass
7210: 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 70 ociated with a p
7220: 61 72 74 69 63 75 6c 61 72 20 64 61 74 61 62 61 articular databa
7230: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 se connection.
7240: 54 68 65 20 75 73 65 20 6f 66 0a 2a 2a 20 6c 6f The use of.** lo
7250: 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f 63 20 70 okaside malloc p
7260: 72 6f 76 69 64 65 73 20 61 20 73 69 67 6e 69 66 rovides a signif
7270: 69 63 61 6e 74 20 70 65 72 66 6f 72 6d 61 6e 63 icant performanc
7280: 65 20 65 6e 68 61 6e 63 65 6d 65 6e 74 0a 2a 2a e enhancement.**
7290: 20 28 61 70 70 72 6f 78 20 31 30 25 29 20 62 79 (approx 10%) by
72a0: 20 61 76 6f 69 64 69 6e 67 20 6e 75 6d 65 72 6f avoiding numero
72b0: 75 73 20 6d 61 6c 6c 6f 63 2f 66 72 65 65 20 72 us malloc/free r
72c0: 65 71 75 65 73 74 73 20 77 68 69 6c 65 20 70 61 equests while pa
72d0: 72 73 69 6e 67 0a 2a 2a 20 53 51 4c 20 73 74 61 rsing.** SQL sta
72e0: 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 tements..**.** T
72f0: 68 65 20 4c 6f 6f 6b 61 73 69 64 65 20 73 74 72 he Lookaside str
7300: 75 63 74 75 72 65 20 68 6f 6c 64 73 20 63 6f 6e ucture holds con
7310: 66 69 67 75 72 61 74 69 6f 6e 20 69 6e 66 6f 72 figuration infor
7320: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 mation about the
7330: 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 .** lookaside ma
7340: 6c 6c 6f 63 20 73 75 62 73 79 73 74 65 6d 2e 20 lloc subsystem.
7350: 20 45 61 63 68 20 61 76 61 69 6c 61 62 6c 65 20 Each available
7360: 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
7370: 6e 20 69 6e 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b n in.** the look
7380: 61 73 69 64 65 20 73 75 62 73 79 73 74 65 6d 20 aside subsystem
7390: 69 73 20 73 74 6f 72 65 64 20 6f 6e 20 61 20 6c is stored on a l
73a0: 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 4c 6f inked list of Lo
73b0: 6f 6b 61 73 69 64 65 53 6c 6f 74 0a 2a 2a 20 6f okasideSlot.** o
73c0: 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a 2a 20 4c 6f bjects..**.** Lo
73d0: 6f 6b 61 73 69 64 65 20 61 6c 6c 6f 63 61 74 69 okaside allocati
73e0: 6f 6e 73 20 61 72 65 20 6f 6e 6c 79 20 61 6c 6c ons are only all
73f0: 6f 77 65 64 20 66 6f 72 20 6f 62 6a 65 63 74 73 owed for objects
7400: 20 74 68 61 74 20 61 72 65 20 61 73 73 6f 63 69 that are associ
7410: 61 74 65 64 0a 2a 2a 20 77 69 74 68 20 61 20 70 ated.** with a p
7420: 61 72 74 69 63 75 6c 61 72 20 64 61 74 61 62 61 articular databa
7430: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 se connection.
7440: 48 65 6e 63 65 2c 20 73 63 68 65 6d 61 20 69 6e Hence, schema in
7450: 66 6f 72 6d 61 74 69 6f 6e 20 63 61 6e 6e 6f 74 formation cannot
7460: 0a 2a 2a 20 62 65 20 73 74 6f 72 65 64 20 69 6e .** be stored in
7470: 20 6c 6f 6f 6b 61 73 69 64 65 20 62 65 63 61 75 lookaside becau
7480: 73 65 20 69 6e 20 73 68 61 72 65 64 20 63 61 63 se in shared cac
7490: 68 65 20 6d 6f 64 65 20 74 68 65 20 73 63 68 65 he mode the sche
74a0: 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a ma information.*
74b0: 2a 20 69 73 20 73 68 61 72 65 64 20 62 79 20 6d * is shared by m
74c0: 75 6c 74 69 70 6c 65 20 64 61 74 61 62 61 73 65 ultiple database
74d0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 2e 20 20 54 connections. T
74e0: 68 65 72 65 66 6f 72 65 2c 20 77 68 69 6c 65 20 herefore, while
74f0: 70 61 72 73 69 6e 67 0a 2a 2a 20 73 63 68 65 6d parsing.** schem
7500: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 74 a information, t
7510: 68 65 20 4c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e he Lookaside.bEn
7520: 61 62 6c 65 64 20 66 6c 61 67 20 69 73 20 63 6c abled flag is cl
7530: 65 61 72 65 64 20 73 6f 20 74 68 61 74 0a 2a 2a eared so that.**
7540: 20 6c 6f 6f 6b 61 73 69 64 65 20 61 6c 6c 6f 63 lookaside alloc
7550: 61 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 75 ations are not u
7560: 73 65 64 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 sed to construct
7570: 20 74 68 65 20 73 63 68 65 6d 61 20 6f 62 6a 65 the schema obje
7580: 63 74 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4c cts..*/.struct L
7590: 6f 6f 6b 61 73 69 64 65 20 7b 0a 20 20 75 31 36 ookaside {. u16
75a0: 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20 sz;
75b0: 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
75c0: 65 61 63 68 20 62 75 66 66 65 72 20 69 6e 20 62 each buffer in b
75d0: 79 74 65 73 20 2a 2f 0a 20 20 75 38 20 62 45 6e ytes */. u8 bEn
75e0: 61 62 6c 65 64 3b 20 20 20 20 20 20 20 20 20 20 abled;
75f0: 20 20 2f 2a 20 46 61 6c 73 65 20 74 6f 20 64 69 /* False to di
7600: 73 61 62 6c 65 20 6e 65 77 20 6c 6f 6f 6b 61 73 sable new lookas
7610: 69 64 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 ide allocations
7620: 2a 2f 0a 20 20 75 38 20 62 4d 61 6c 6c 6f 63 65 */. u8 bMalloce
7630: 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 d; /*
7640: 54 72 75 65 20 69 66 20 70 53 74 61 72 74 20 6f True if pStart o
7650: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c btained from sql
7660: 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 20 2a 2f ite3_malloc() */
7670: 0a 20 20 69 6e 74 20 6e 4f 75 74 3b 20 20 20 20 . int nOut;
7680: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
7690: 6d 62 65 72 20 6f 66 20 62 75 66 66 65 72 73 20 mber of buffers
76a0: 63 75 72 72 65 6e 74 6c 79 20 63 68 65 63 6b 65 currently checke
76b0: 64 20 6f 75 74 20 2a 2f 0a 20 20 69 6e 74 20 6d d out */. int m
76c0: 78 4f 75 74 3b 20 20 20 20 20 20 20 20 20 20 20 xOut;
76d0: 20 20 20 2f 2a 20 48 69 67 68 77 61 74 65 72 20 /* Highwater
76e0: 6d 61 72 6b 20 66 6f 72 20 6e 4f 75 74 20 2a 2f mark for nOut */
76f0: 0a 20 20 69 6e 74 20 61 6e 53 74 61 74 5b 33 5d . int anStat[3]
7700: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 30 3a ; /* 0:
7710: 20 68 69 74 73 2e 20 20 31 3a 20 73 69 7a 65 20 hits. 1: size
7720: 6d 69 73 73 65 73 2e 20 20 32 3a 20 66 75 6c 6c misses. 2: full
7730: 20 6d 69 73 73 65 73 20 2a 2f 0a 20 20 4c 6f 6f misses */. Loo
7740: 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 46 72 65 kasideSlot *pFre
7750: 65 3b 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 e; /* List of
7760: 61 76 61 69 6c 61 62 6c 65 20 62 75 66 66 65 72 available buffer
7770: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 74 s */. void *pSt
7780: 61 72 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f art; /
7790: 2a 20 46 69 72 73 74 20 62 79 74 65 20 6f 66 20 * First byte of
77a0: 61 76 61 69 6c 61 62 6c 65 20 6d 65 6d 6f 72 79 available memory
77b0: 20 73 70 61 63 65 20 2a 2f 0a 20 20 76 6f 69 64 space */. void
77c0: 20 2a 70 45 6e 64 3b 20 20 20 20 20 20 20 20 20 *pEnd;
77d0: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 /* First byt
77e0: 65 20 70 61 73 74 20 65 6e 64 20 6f 66 20 61 76 e past end of av
77f0: 61 69 6c 61 62 6c 65 20 73 70 61 63 65 20 2a 2f ailable space */
7800: 0a 7d 3b 0a 73 74 72 75 63 74 20 4c 6f 6f 6b 61 .};.struct Looka
7810: 73 69 64 65 53 6c 6f 74 20 7b 0a 20 20 4c 6f 6f sideSlot {. Loo
7820: 6b 61 73 69 64 65 53 6c 6f 74 20 2a 70 4e 65 78 kasideSlot *pNex
7830: 74 3b 20 20 20 20 2f 2a 20 4e 65 78 74 20 62 75 t; /* Next bu
7840: 66 66 65 72 20 69 6e 20 74 68 65 20 6c 69 73 74 ffer in the list
7850: 20 6f 66 20 66 72 65 65 20 62 75 66 66 65 72 73 of free buffers
7860: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 */.};../*.** A
7870: 68 61 73 68 20 74 61 62 6c 65 20 66 6f 72 20 66 hash table for f
7880: 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 unction definiti
7890: 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 48 61 73 68 20 ons..**.** Hash
78a0: 65 61 63 68 20 46 75 6e 63 44 65 66 20 73 74 72 each FuncDef str
78b0: 75 63 74 75 72 65 20 69 6e 74 6f 20 6f 6e 65 20 ucture into one
78c0: 6f 66 20 74 68 65 20 46 75 6e 63 44 65 66 48 61 of the FuncDefHa
78d0: 73 68 2e 61 5b 5d 20 73 6c 6f 74 73 2e 0a 2a 2a sh.a[] slots..**
78e0: 20 43 6f 6c 6c 69 73 69 6f 6e 73 20 61 72 65 20 Collisions are
78f0: 6f 6e 20 74 68 65 20 46 75 6e 63 44 65 66 2e 70 on the FuncDef.p
7900: 48 61 73 68 20 63 68 61 69 6e 2e 0a 2a 2f 0a 73 Hash chain..*/.s
7910: 74 72 75 63 74 20 46 75 6e 63 44 65 66 48 61 73 truct FuncDefHas
7920: 68 20 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 61 h {. FuncDef *a
7930: 5b 32 33 5d 3b 20 20 20 20 20 20 20 2f 2a 20 48 [23]; /* H
7940: 61 73 68 20 74 61 62 6c 65 20 66 6f 72 20 66 75 ash table for fu
7950: 6e 63 74 69 6f 6e 73 20 2a 2f 0a 7d 3b 0a 0a 2f nctions */.};../
7960: 2a 0a 2a 2a 20 45 61 63 68 20 64 61 74 61 62 61 *.** Each databa
7970: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 se connection is
7980: 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 an instance of
7990: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
79a0: 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 ructure..*/.stru
79b0: 63 74 20 73 71 6c 69 74 65 33 20 7b 0a 20 20 73 ct sqlite3 {. s
79c0: 71 6c 69 74 65 33 5f 76 66 73 20 2a 70 56 66 73 qlite3_vfs *pVfs
79d0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
79e0: 4f 53 20 49 6e 74 65 72 66 61 63 65 20 2a 2f 0a OS Interface */.
79f0: 20 20 73 74 72 75 63 74 20 56 64 62 65 20 2a 70 struct Vdbe *p
7a00: 56 64 62 65 3b 20 20 20 20 20 20 20 20 20 20 20 Vdbe;
7a10: 2f 2a 20 4c 69 73 74 20 6f 66 20 61 63 74 69 76 /* List of activ
7a20: 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e e virtual machin
7a30: 65 73 20 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 20 es */. CollSeq
7a40: 2a 70 44 66 6c 74 43 6f 6c 6c 3b 20 20 20 20 20 *pDfltColl;
7a50: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 65 66 /* The def
7a60: 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6e 67 20 73 ault collating s
7a70: 65 71 75 65 6e 63 65 20 28 42 49 4e 41 52 59 29 equence (BINARY)
7a80: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 */. sqlite3_mu
7a90: 74 65 78 20 2a 6d 75 74 65 78 3b 20 20 20 20 20 tex *mutex;
7aa0: 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f /* Connectio
7ab0: 6e 20 6d 75 74 65 78 20 2a 2f 0a 20 20 44 62 20 n mutex */. Db
7ac0: 2a 61 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 *aDb;
7ad0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c /* Al
7ae0: 6c 20 62 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 l backends */.
7af0: 69 6e 74 20 6e 44 62 3b 20 20 20 20 20 20 20 20 int nDb;
7b00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7b10: 20 4e 75 6d 62 65 72 20 6f 66 20 62 61 63 6b 65 Number of backe
7b20: 6e 64 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e nds currently in
7b30: 20 75 73 65 20 2a 2f 0a 20 20 69 6e 74 20 66 6c use */. int fl
7b40: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
7b50: 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 73 63 65 /* Misce
7b60: 6c 6c 61 6e 65 6f 75 73 20 66 6c 61 67 73 2e 20 llaneous flags.
7b70: 53 65 65 20 62 65 6c 6f 77 20 2a 2f 0a 20 20 69 See below */. i
7b80: 36 34 20 6c 61 73 74 52 6f 77 69 64 3b 20 20 20 64 lastRowid;
7b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7ba0: 52 4f 57 49 44 20 6f 66 20 6d 6f 73 74 20 72 65 ROWID of most re
7bb0: 63 65 6e 74 20 69 6e 73 65 72 74 20 28 73 65 65 cent insert (see
7bc0: 20 61 62 6f 76 65 29 20 2a 2f 0a 20 20 69 36 34 above) */. i64
7bd0: 20 73 7a 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 szMmap;
7be0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 /* De
7bf0: 66 61 75 6c 74 20 6d 6d 61 70 5f 73 69 7a 65 20 fault mmap_size
7c00: 73 65 74 74 69 6e 67 20 2a 2f 0a 20 20 75 6e 73 setting */. uns
7c10: 69 67 6e 65 64 20 69 6e 74 20 6f 70 65 6e 46 6c igned int openFl
7c20: 61 67 73 3b 20 20 20 20 20 20 20 2f 2a 20 46 6c ags; /* Fl
7c30: 61 67 73 20 70 61 73 73 65 64 20 74 6f 20 73 71 ags passed to sq
7c40: 6c 69 74 65 33 5f 76 66 73 2e 78 4f 70 65 6e 28 lite3_vfs.xOpen(
7c50: 29 20 2a 2f 0a 20 20 69 6e 74 20 65 72 72 43 6f ) */. int errCo
7c60: 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 de;
7c70: 20 20 20 20 20 2f 2a 20 4d 6f 73 74 20 72 65 63 /* Most rec
7c80: 65 6e 74 20 65 72 72 6f 72 20 63 6f 64 65 20 28 ent error code (
7c90: 53 51 4c 49 54 45 5f 2a 29 20 2a 2f 0a 20 20 69 SQLITE_*) */. i
7ca0: 6e 74 20 65 72 72 4d 61 73 6b 3b 20 20 20 20 20 nt errMask;
7cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7cc0: 26 20 72 65 73 75 6c 74 20 63 6f 64 65 73 20 77 & result codes w
7cd0: 69 74 68 20 74 68 69 73 20 62 65 66 6f 72 65 20 ith this before
7ce0: 72 65 74 75 72 6e 69 6e 67 20 2a 2f 0a 20 20 75 returning */. u
7cf0: 31 36 20 64 62 4f 70 74 46 6c 61 67 73 3b 20 20 16 dbOptFlags;
7d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7d10: 46 6c 61 67 73 20 74 6f 20 65 6e 61 62 6c 65 2f Flags to enable/
7d20: 64 69 73 61 62 6c 65 20 6f 70 74 69 6d 69 7a 61 disable optimiza
7d30: 74 69 6f 6e 73 20 2a 2f 0a 20 20 75 38 20 61 75 tions */. u8 au
7d40: 74 6f 43 6f 6d 6d 69 74 3b 20 20 20 20 20 20 20 toCommit;
7d50: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
7d60: 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61 67 auto-commit flag
7d70: 2e 20 2a 2f 0a 20 20 75 38 20 74 65 6d 70 5f 73 . */. u8 temp_s
7d80: 74 6f 72 65 3b 20 20 20 20 20 20 20 20 20 20 20 tore;
7d90: 20 20 20 20 20 2f 2a 20 31 3a 20 66 69 6c 65 20 /* 1: file
7da0: 32 3a 20 6d 65 6d 6f 72 79 20 30 3a 20 64 65 66 2: memory 0: def
7db0: 61 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6d 61 6c ault */. u8 mal
7dc0: 6c 6f 63 46 61 69 6c 65 64 3b 20 20 20 20 20 20 locFailed;
7dd0: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
7de0: 69 66 20 77 65 20 68 61 76 65 20 73 65 65 6e 20 if we have seen
7df0: 61 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 a malloc failure
7e00: 20 2a 2f 0a 20 20 75 38 20 64 66 6c 74 4c 6f 63 */. u8 dfltLoc
7e10: 6b 4d 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 kMode;
7e20: 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c /* Default l
7e30: 6f 63 6b 69 6e 67 2d 6d 6f 64 65 20 66 6f 72 20 ocking-mode for
7e40: 61 74 74 61 63 68 65 64 20 64 62 73 20 2a 2f 0a attached dbs */.
7e50: 20 20 73 69 67 6e 65 64 20 63 68 61 72 20 6e 65 signed char ne
7e60: 78 74 41 75 74 6f 76 61 63 3b 20 20 20 20 20 20 xtAutovac;
7e70: 2f 2a 20 41 75 74 6f 76 61 63 20 73 65 74 74 69 /* Autovac setti
7e80: 6e 67 20 61 66 74 65 72 20 56 41 43 55 55 4d 20 ng after VACUUM
7e90: 69 66 20 3e 3d 30 20 2a 2f 0a 20 20 75 38 20 73 if >=0 */. u8 s
7ea0: 75 70 70 72 65 73 73 45 72 72 3b 20 20 20 20 20 uppressErr;
7eb0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 6f 20 /* Do
7ec0: 6e 6f 74 20 69 73 73 75 65 20 65 72 72 6f 72 20 not issue error
7ed0: 6d 65 73 73 61 67 65 73 20 69 66 20 74 72 75 65 messages if true
7ee0: 20 2a 2f 0a 20 20 75 38 20 76 74 61 62 4f 6e 43 */. u8 vtabOnC
7ef0: 6f 6e 66 6c 69 63 74 3b 20 20 20 20 20 20 20 20 onflict;
7f00: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 /* Value to
7f10: 72 65 74 75 72 6e 20 66 6f 72 20 73 33 5f 76 74 return for s3_vt
7f20: 61 62 5f 6f 6e 5f 63 6f 6e 66 6c 69 63 74 28 29 ab_on_conflict()
7f30: 20 2a 2f 0a 20 20 75 38 20 69 73 54 72 61 6e 73 */. u8 isTrans
7f40: 61 63 74 69 6f 6e 53 61 76 65 70 6f 69 6e 74 3b actionSavepoint;
7f50: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 /* True if t
7f60: 68 65 20 6f 75 74 65 72 6d 6f 73 74 20 73 61 76 he outermost sav
7f70: 65 70 6f 69 6e 74 20 69 73 20 61 20 54 53 20 2a epoint is a TS *
7f80: 2f 0a 20 20 69 6e 74 20 6e 65 78 74 50 61 67 65 /. int nextPage
7f90: 73 69 7a 65 3b 20 20 20 20 20 20 20 20 20 20 20 size;
7fa0: 20 20 2f 2a 20 50 61 67 65 73 69 7a 65 20 61 66 /* Pagesize af
7fb0: 74 65 72 20 56 41 43 55 55 4d 20 69 66 20 3e 30 ter VACUUM if >0
7fc0: 20 2a 2f 0a 20 20 75 33 32 20 6d 61 67 69 63 3b */. u32 magic;
7fd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7fe0: 20 20 20 20 2f 2a 20 4d 61 67 69 63 20 6e 75 6d /* Magic num
7ff0: 62 65 72 20 66 6f 72 20 64 65 74 65 63 74 20 6c ber for detect l
8000: 69 62 72 61 72 79 20 6d 69 73 75 73 65 20 2a 2f ibrary misuse */
8010: 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67 65 3b 20 . int nChange;
8020: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8030: 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 75 72 6e /* Value return
8040: 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 63 68 ed by sqlite3_ch
8050: 61 6e 67 65 73 28 29 20 2a 2f 0a 20 20 69 6e 74 anges() */. int
8060: 20 6e 54 6f 74 61 6c 43 68 61 6e 67 65 3b 20 20 nTotalChange;
8070: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 /* Va
8080: 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 lue returned by
8090: 73 71 6c 69 74 65 33 5f 74 6f 74 61 6c 5f 63 68 sqlite3_total_ch
80a0: 61 6e 67 65 73 28 29 20 2a 2f 0a 20 20 69 6e 74 anges() */. int
80b0: 20 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f 4e aLimit[SQLITE_N
80c0: 5f 4c 49 4d 49 54 5d 3b 20 20 20 2f 2a 20 4c 69 _LIMIT]; /* Li
80d0: 6d 69 74 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 mits */. struct
80e0: 20 73 71 6c 69 74 65 33 49 6e 69 74 49 6e 66 6f sqlite3InitInfo
80f0: 20 7b 20 20 20 20 20 20 2f 2a 20 49 6e 66 6f 72 { /* Infor
8100: 6d 61 74 69 6f 6e 20 75 73 65 64 20 64 75 72 69 mation used duri
8110: 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f ng initializatio
8120: 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 65 77 n */. int new
8130: 54 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 20 20 Tnum;
8140: 20 20 20 20 20 2f 2a 20 52 6f 6f 74 70 61 67 65 /* Rootpage
8150: 20 6f 66 20 74 61 62 6c 65 20 62 65 69 6e 67 20 of table being
8160: 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 initialized */.
8170: 20 20 20 75 38 20 69 44 62 3b 20 20 20 20 20 20 u8 iDb;
8180: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8190: 2a 20 57 68 69 63 68 20 64 62 20 66 69 6c 65 20 * Which db file
81a0: 69 73 20 62 65 69 6e 67 20 69 6e 69 74 69 61 6c is being initial
81b0: 69 7a 65 64 20 2a 2f 0a 20 20 20 20 75 38 20 62 ized */. u8 b
81c0: 75 73 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 usy;
81d0: 20 20 20 20 20 20 20 20 2f 2a 20 54 52 55 45 20 /* TRUE
81e0: 69 66 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 69 if currently ini
81f0: 74 69 61 6c 69 7a 69 6e 67 20 2a 2f 0a 20 20 20 tializing */.
8200: 20 75 38 20 6f 72 70 68 61 6e 54 72 69 67 67 65 u8 orphanTrigge
8210: 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 r; /*
8220: 4c 61 73 74 20 73 74 61 74 65 6d 65 6e 74 20 69 Last statement i
8230: 73 20 6f 72 70 68 61 6e 65 64 20 54 45 4d 50 20 s orphaned TEMP
8240: 74 72 69 67 67 65 72 20 2a 2f 0a 20 20 7d 20 69 trigger */. } i
8250: 6e 69 74 3b 0a 20 20 69 6e 74 20 6e 56 64 62 65 nit;. int nVdbe
8260: 41 63 74 69 76 65 3b 20 20 20 20 20 20 20 20 20 Active;
8270: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
8280: 66 20 56 44 42 45 73 20 63 75 72 72 65 6e 74 6c f VDBEs currentl
8290: 79 20 72 75 6e 6e 69 6e 67 20 2a 2f 0a 20 20 69 y running */. i
82a0: 6e 74 20 6e 56 64 62 65 52 65 61 64 3b 20 20 20 nt nVdbeRead;
82b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
82c0: 4e 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 65 Number of active
82d0: 20 56 44 42 45 73 20 74 68 61 74 20 72 65 61 64 VDBEs that read
82e0: 20 6f 72 20 77 72 69 74 65 20 2a 2f 0a 20 20 69 or write */. i
82f0: 6e 74 20 6e 56 64 62 65 57 72 69 74 65 3b 20 20 nt nVdbeWrite;
8300: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8310: 4e 75 6d 62 65 72 20 6f 66 20 61 63 74 69 76 65 Number of active
8320: 20 56 44 42 45 73 20 74 68 61 74 20 72 65 61 64 VDBEs that read
8330: 20 61 6e 64 20 77 72 69 74 65 20 2a 2f 0a 20 20 and write */.
8340: 69 6e 74 20 6e 56 64 62 65 45 78 65 63 3b 20 20 int nVdbeExec;
8350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
8360: 20 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 Number of neste
8370: 64 20 63 61 6c 6c 73 20 74 6f 20 56 64 62 65 45 d calls to VdbeE
8380: 78 65 63 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e xec() */. int n
8390: 45 78 74 65 6e 73 69 6f 6e 3b 20 20 20 20 20 20 Extension;
83a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
83b0: 65 72 20 6f 66 20 6c 6f 61 64 65 64 20 65 78 74 er of loaded ext
83c0: 65 6e 73 69 6f 6e 73 20 2a 2f 0a 20 20 76 6f 69 ensions */. voi
83d0: 64 20 2a 2a 61 45 78 74 65 6e 73 69 6f 6e 3b 20 d **aExtension;
83e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
83f0: 72 61 79 20 6f 66 20 73 68 61 72 65 64 20 6c 69 ray of shared li
8400: 62 72 61 72 79 20 68 61 6e 64 6c 65 73 20 2a 2f brary handles */
8410: 0a 20 20 76 6f 69 64 20 28 2a 78 54 72 61 63 65 . void (*xTrace
8420: 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 )(void*,const ch
8430: 61 72 2a 29 3b 20 20 20 20 20 20 20 20 2f 2a 20 ar*); /*
8440: 54 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 2a Trace function *
8450: 2f 0a 20 20 76 6f 69 64 20 2a 70 54 72 61 63 65 /. void *pTrace
8460: 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 Arg;
8470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
8480: 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 Argument to the
8490: 20 74 72 61 63 65 20 66 75 6e 63 74 69 6f 6e 20 trace function
84a0: 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 50 72 6f */. void (*xPro
84b0: 66 69 6c 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 file)(void*,cons
84c0: 74 20 63 68 61 72 2a 2c 75 36 34 29 3b 20 20 2f t char*,u64); /
84d0: 2a 20 50 72 6f 66 69 6c 69 6e 67 20 66 75 6e 63 * Profiling func
84e0: 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a tion */. void *
84f0: 70 50 72 6f 66 69 6c 65 41 72 67 3b 20 20 20 20 pProfileArg;
8500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8510: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
8520: 74 6f 20 70 72 6f 66 69 6c 65 20 66 75 6e 63 74 to profile funct
8530: 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ion */. void *p
8540: 43 6f 6d 6d 69 74 41 72 67 3b 20 20 20 20 20 20 CommitArg;
8550: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 /* Ar
8560: 67 75 6d 65 6e 74 20 74 6f 20 78 43 6f 6d 6d 69 gument to xCommi
8570: 74 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 20 20 tCallback() */
8580: 20 0a 20 20 69 6e 74 20 28 2a 78 43 6f 6d 6d 69 . int (*xCommi
8590: 74 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a tCallback)(void*
85a0: 29 3b 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 64 ); /* Invoked
85b0: 20 61 74 20 65 76 65 72 79 20 63 6f 6d 6d 69 74 at every commit
85c0: 2e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 52 6f . */. void *pRo
85d0: 6c 6c 62 61 63 6b 41 72 67 3b 20 20 20 20 20 20 llbackArg;
85e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 /* Argu
85f0: 6d 65 6e 74 20 74 6f 20 78 52 6f 6c 6c 62 61 63 ment to xRollbac
8600: 6b 43 61 6c 6c 62 61 63 6b 28 29 20 2a 2f 20 20 kCallback() */
8610: 20 0a 20 20 76 6f 69 64 20 28 2a 78 52 6f 6c 6c . void (*xRoll
8620: 62 61 63 6b 43 61 6c 6c 62 61 63 6b 29 28 76 6f backCallback)(vo
8630: 69 64 2a 29 3b 20 2f 2a 20 49 6e 76 6f 6b 65 64 id*); /* Invoked
8640: 20 61 74 20 65 76 65 72 79 20 63 6f 6d 6d 69 74 at every commit
8650: 2e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 55 70 . */. void *pUp
8660: 64 61 74 65 41 72 67 3b 0a 20 20 76 6f 69 64 20 dateArg;. void
8670: 28 2a 78 55 70 64 61 74 65 43 61 6c 6c 62 61 63 (*xUpdateCallbac
8680: 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 20 63 6f k)(void*,int, co
8690: 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 nst char*,const
86a0: 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f 69 6e 74 char*,sqlite_int
86b0: 36 34 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 64);.#ifndef SQL
86c0: 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 69 ITE_OMIT_WAL. i
86d0: 6e 74 20 28 2a 78 57 61 6c 43 61 6c 6c 62 61 63 nt (*xWalCallbac
86e0: 6b 29 28 76 6f 69 64 20 2a 2c 20 73 71 6c 69 74 k)(void *, sqlit
86f0: 65 33 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 e3 *, const char
8700: 20 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 *, int);. void
8710: 20 2a 70 57 61 6c 41 72 67 3b 0a 23 65 6e 64 69 *pWalArg;.#endi
8720: 66 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e f. void(*xCollN
8730: 65 65 64 65 64 29 28 76 6f 69 64 2a 2c 73 71 6c eeded)(void*,sql
8740: 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 52 ite3*,int eTextR
8750: 65 70 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b ep,const char*);
8760: 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c 6c 4e 65 . void(*xCollNe
8770: 65 64 65 64 31 36 29 28 76 6f 69 64 2a 2c 73 71 eded16)(void*,sq
8780: 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 78 74 lite3*,int eText
8790: 52 65 70 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 29 Rep,const void*)
87a0: 3b 0a 20 20 76 6f 69 64 20 2a 70 43 6f 6c 6c 4e ;. void *pCollN
87b0: 65 65 64 65 64 41 72 67 3b 0a 20 20 73 71 6c 69 eededArg;. sqli
87c0: 74 65 33 5f 76 61 6c 75 65 20 2a 70 45 72 72 3b te3_value *pErr;
87d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 /* Mos
87e0: 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 6d t recent error m
87f0: 65 73 73 61 67 65 20 2a 2f 0a 20 20 75 6e 69 6f essage */. unio
8800: 6e 20 7b 0a 20 20 20 20 76 6f 6c 61 74 69 6c 65 n {. volatile
8810: 20 69 6e 74 20 69 73 49 6e 74 65 72 72 75 70 74 int isInterrupt
8820: 65 64 3b 20 2f 2a 20 54 72 75 65 20 69 66 20 73 ed; /* True if s
8830: 71 6c 69 74 65 33 5f 69 6e 74 65 72 72 75 70 74 qlite3_interrupt
8840: 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 has been called
8850: 20 2a 2f 0a 20 20 20 20 64 6f 75 62 6c 65 20 6e */. double n
8860: 6f 74 55 73 65 64 31 3b 20 20 20 20 20 20 20 20 otUsed1;
8870: 20 20 20 20 2f 2a 20 53 70 61 63 65 72 20 2a 2f /* Spacer */
8880: 0a 20 20 7d 20 75 31 3b 0a 20 20 4c 6f 6f 6b 61 . } u1;. Looka
8890: 73 69 64 65 20 6c 6f 6f 6b 61 73 69 64 65 3b 20 side lookaside;
88a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f 6b /* Look
88b0: 61 73 69 64 65 20 6d 61 6c 6c 6f 63 20 63 6f 6e aside malloc con
88c0: 66 69 67 75 72 61 74 69 6f 6e 20 2a 2f 0a 23 69 figuration */.#i
88d0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
88e0: 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a T_AUTHORIZATION.
88f0: 20 20 69 6e 74 20 28 2a 78 41 75 74 68 29 28 76 int (*xAuth)(v
8900: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 oid*,int,const c
8910: 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a har*,const char*
8920: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e ,const char*,con
8930: 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 20 20 20 st char*);.
8940: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8950: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 63 /* Ac
8960: 63 65 73 73 20 61 75 74 68 6f 72 69 7a 61 74 69 cess authorizati
8970: 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 on function */.
8980: 20 76 6f 69 64 20 2a 70 41 75 74 68 41 72 67 3b void *pAuthArg;
8990: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
89a0: 2a 20 31 73 74 20 61 72 67 75 6d 65 6e 74 20 74 * 1st argument t
89b0: 6f 20 74 68 65 20 61 63 63 65 73 73 20 61 75 74 o the access aut
89c0: 68 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 65 h function */.#e
89d0: 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c ndif.#ifndef SQL
89e0: 49 54 45 5f 4f 4d 49 54 5f 50 52 4f 47 52 45 53 ITE_OMIT_PROGRES
89f0: 53 5f 43 41 4c 4c 42 41 43 4b 0a 20 20 69 6e 74 S_CALLBACK. int
8a00: 20 28 2a 78 50 72 6f 67 72 65 73 73 29 28 76 6f (*xProgress)(vo
8a10: 69 64 20 2a 29 3b 20 20 20 20 20 2f 2a 20 54 68 id *); /* Th
8a20: 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 e progress callb
8a30: 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ack */. void *p
8a40: 50 72 6f 67 72 65 73 73 41 72 67 3b 20 20 20 20 ProgressArg;
8a50: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 /* Argume
8a60: 6e 74 20 74 6f 20 74 68 65 20 70 72 6f 67 72 65 nt to the progre
8a70: 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 ss callback */.
8a80: 20 75 6e 73 69 67 6e 65 64 20 6e 50 72 6f 67 72 unsigned nProgr
8a90: 65 73 73 4f 70 73 3b 20 20 20 20 20 20 20 20 2f essOps; /
8aa0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6f 70 63 6f * Number of opco
8ab0: 64 65 73 20 66 6f 72 20 70 72 6f 67 72 65 73 73 des for progress
8ac0: 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 23 65 6e callback */.#en
8ad0: 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 dif.#ifndef SQLI
8ae0: 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
8af0: 41 42 4c 45 0a 20 20 69 6e 74 20 6e 56 54 72 61 ABLE. int nVTra
8b00: 6e 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ns;
8b10: 20 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 /* Allocate
8b20: 64 20 73 69 7a 65 20 6f 66 20 61 56 54 72 61 6e d size of aVTran
8b30: 73 20 2a 2f 0a 20 20 48 61 73 68 20 61 4d 6f 64 s */. Hash aMod
8b40: 75 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ule;
8b50: 20 20 20 20 20 2f 2a 20 70 6f 70 75 6c 61 74 65 /* populate
8b60: 64 20 62 79 20 73 71 6c 69 74 65 33 5f 63 72 65 d by sqlite3_cre
8b70: 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a ate_module() */.
8b80: 20 20 56 74 61 62 43 74 78 20 2a 70 56 74 61 62 VtabCtx *pVtab
8b90: 43 74 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 Ctx;
8ba0: 2f 2a 20 43 6f 6e 74 65 78 74 20 66 6f 72 20 61 /* Context for a
8bb0: 63 74 69 76 65 20 76 74 61 62 20 63 6f 6e 6e 65 ctive vtab conne
8bc0: 63 74 2f 63 72 65 61 74 65 20 2a 2f 0a 20 20 56 ct/create */. V
8bd0: 54 61 62 6c 65 20 2a 2a 61 56 54 72 61 6e 73 3b Table **aVTrans;
8be0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8bf0: 56 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 77 Virtual tables w
8c00: 69 74 68 20 6f 70 65 6e 20 74 72 61 6e 73 61 63 ith open transac
8c10: 74 69 6f 6e 73 20 2a 2f 0a 20 20 56 54 61 62 6c tions */. VTabl
8c20: 65 20 2a 70 44 69 73 63 6f 6e 6e 65 63 74 3b 20 e *pDisconnect;
8c30: 20 20 20 2f 2a 20 44 69 73 63 6f 6e 6e 65 63 74 /* Disconnect
8c40: 20 74 68 65 73 65 20 69 6e 20 6e 65 78 74 20 73 these in next s
8c50: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 qlite3_prepare()
8c60: 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 46 75 6e */.#endif. Fun
8c70: 63 44 65 66 48 61 73 68 20 61 46 75 6e 63 3b 20 cDefHash aFunc;
8c80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 61 /* Ha
8c90: 73 68 20 74 61 62 6c 65 20 6f 66 20 63 6f 6e 6e sh table of conn
8ca0: 65 63 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e 73 ection functions
8cb0: 20 2a 2f 0a 20 20 48 61 73 68 20 61 43 6f 6c 6c */. Hash aColl
8cc0: 53 65 71 3b 20 20 20 20 20 20 20 20 20 20 20 20 Seq;
8cd0: 20 20 20 20 2f 2a 20 41 6c 6c 20 63 6f 6c 6c 61 /* All colla
8ce0: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 20 2a ting sequences *
8cf0: 2f 0a 20 20 42 75 73 79 48 61 6e 64 6c 65 72 20 /. BusyHandler
8d00: 62 75 73 79 48 61 6e 64 6c 65 72 3b 20 20 20 20 busyHandler;
8d10: 20 20 2f 2a 20 42 75 73 79 20 63 61 6c 6c 62 61 /* Busy callba
8d20: 63 6b 20 2a 2f 0a 20 20 44 62 20 61 44 62 53 74 ck */. Db aDbSt
8d30: 61 74 69 63 5b 32 5d 3b 20 20 20 20 20 20 20 20 atic[2];
8d40: 20 20 20 20 20 20 2f 2a 20 53 74 61 74 69 63 20 /* Static
8d50: 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 32 20 space for the 2
8d60: 64 65 66 61 75 6c 74 20 62 61 63 6b 65 6e 64 73 default backends
8d70: 20 2a 2f 0a 20 20 53 61 76 65 70 6f 69 6e 74 20 */. Savepoint
8d80: 2a 70 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 *pSavepoint;
8d90: 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 61 /* List of a
8da0: 63 74 69 76 65 20 73 61 76 65 70 6f 69 6e 74 73 ctive savepoints
8db0: 20 2a 2f 0a 20 20 69 6e 74 20 62 75 73 79 54 69 */. int busyTi
8dc0: 6d 65 6f 75 74 3b 20 20 20 20 20 20 20 20 20 20 meout;
8dd0: 20 20 20 20 2f 2a 20 42 75 73 79 20 68 61 6e 64 /* Busy hand
8de0: 6c 65 72 20 74 69 6d 65 6f 75 74 2c 20 69 6e 20 ler timeout, in
8df0: 6d 73 65 63 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 msec */. int nS
8e00: 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 avepoint;
8e10: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
8e20: 72 20 6f 66 20 6e 6f 6e 2d 74 72 61 6e 73 61 63 r of non-transac
8e30: 74 69 6f 6e 20 73 61 76 65 70 6f 69 6e 74 73 20 tion savepoints
8e40: 2a 2f 0a 20 20 69 6e 74 20 6e 53 74 61 74 65 6d */. int nStatem
8e50: 65 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 ent;
8e60: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
8e70: 6e 65 73 74 65 64 20 73 74 61 74 65 6d 65 6e 74 nested statement
8e80: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 20 2a -transactions *
8e90: 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 65 /. i64 nDeferre
8ea0: 64 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 20 dCons;
8eb0: 20 20 2f 2a 20 4e 65 74 20 64 65 66 65 72 72 65 /* Net deferre
8ec0: 64 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 74 68 d constraints th
8ed0: 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 is transaction.
8ee0: 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 */. i64 nDeferr
8ef0: 65 64 49 6d 6d 43 6f 6e 73 3b 20 20 20 20 20 20 edImmCons;
8f00: 20 20 20 2f 2a 20 4e 65 74 20 64 65 66 65 72 72 /* Net deferr
8f10: 65 64 20 69 6d 6d 65 64 69 61 74 65 20 63 6f 6e ed immediate con
8f20: 73 74 72 61 69 6e 74 73 20 2a 2f 0a 20 20 69 6e straints */. in
8f30: 74 20 2a 70 6e 42 79 74 65 73 46 72 65 65 64 3b t *pnBytesFreed;
8f40: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
8f50: 66 20 6e 6f 74 20 4e 55 4c 4c 2c 20 69 6e 63 72 f not NULL, incr
8f60: 65 6d 65 6e 74 20 74 68 69 73 20 69 6e 20 44 62 ement this in Db
8f70: 46 72 65 65 28 29 20 2a 2f 0a 0a 23 69 66 64 65 Free() */..#ifde
8f80: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
8f90: 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 0a 20 20 UNLOCK_NOTIFY.
8fa0: 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 /* The following
8fb0: 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 20 61 variables are a
8fc0: 6c 6c 20 70 72 6f 74 65 63 74 65 64 20 62 79 20 ll protected by
8fd0: 74 68 65 20 53 54 41 54 49 43 5f 4d 41 53 54 45 the STATIC_MASTE
8fe0: 52 20 0a 20 20 2a 2a 20 6d 75 74 65 78 2c 20 6e R . ** mutex, n
8ff0: 6f 74 20 62 79 20 73 71 6c 69 74 65 33 2e 6d 75 ot by sqlite3.mu
9000: 74 65 78 2e 20 54 68 65 79 20 61 72 65 20 75 73 tex. They are us
9010: 65 64 20 62 79 20 63 6f 64 65 20 69 6e 20 6e 6f ed by code in no
9020: 74 69 66 79 2e 63 2e 20 0a 20 20 2a 2a 0a 20 20 tify.c. . **.
9030: 2a 2a 20 57 68 65 6e 20 58 2e 70 55 6e 6c 6f 63 ** When X.pUnloc
9040: 6b 43 6f 6e 6e 65 63 74 69 6f 6e 3d 3d 59 2c 20 kConnection==Y,
9050: 74 68 61 74 20 6d 65 61 6e 73 20 74 68 61 74 20 that means that
9060: 58 20 69 73 20 77 61 69 74 69 6e 67 20 66 6f 72 X is waiting for
9070: 20 59 20 74 6f 0a 20 20 2a 2a 20 75 6e 6c 6f 63 Y to. ** unloc
9080: 6b 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 6e k so that it can
9090: 20 70 72 6f 63 65 65 64 2e 0a 20 20 2a 2a 0a 20 proceed.. **.
90a0: 20 2a 2a 20 57 68 65 6e 20 58 2e 70 42 6c 6f 63 ** When X.pBloc
90b0: 6b 69 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3d 3d kingConnection==
90c0: 59 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 74 68 Y, that means th
90d0: 61 74 20 73 6f 6d 65 74 68 69 6e 67 20 74 68 61 at something tha
90e0: 74 20 58 20 74 72 69 65 64 0a 20 20 2a 2a 20 74 t X tried. ** t
90f0: 72 69 65 64 20 74 6f 20 64 6f 20 72 65 63 65 6e ried to do recen
9100: 74 6c 79 20 66 61 69 6c 65 64 20 77 69 74 68 20 tly failed with
9110: 61 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 an SQLITE_LOCKED
9120: 20 65 72 72 6f 72 20 64 75 65 20 74 6f 20 6c 6f error due to lo
9130: 63 6b 73 0a 20 20 2a 2a 20 68 65 6c 64 20 62 79 cks. ** held by
9140: 20 59 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 Y.. */. sqlit
9150: 65 33 20 2a 70 42 6c 6f 63 6b 69 6e 67 43 6f 6e e3 *pBlockingCon
9160: 6e 65 63 74 69 6f 6e 3b 20 2f 2a 20 43 6f 6e 6e nection; /* Conn
9170: 65 63 74 69 6f 6e 20 74 68 61 74 20 63 61 75 73 ection that caus
9180: 65 64 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 ed SQLITE_LOCKED
9190: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 */. sqlite3 *p
91a0: 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 6f 6e UnlockConnection
91b0: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 ; /* C
91c0: 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 77 61 74 onnection to wat
91d0: 63 68 20 66 6f 72 20 75 6e 6c 6f 63 6b 20 2a 2f ch for unlock */
91e0: 0a 20 20 76 6f 69 64 20 2a 70 55 6e 6c 6f 63 6b . void *pUnlock
91f0: 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 Arg;
9200: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 /* Argu
9210: 6d 65 6e 74 20 74 6f 20 78 55 6e 6c 6f 63 6b 4e ment to xUnlockN
9220: 6f 74 69 66 79 20 2a 2f 0a 20 20 76 6f 69 64 20 otify */. void
9230: 28 2a 78 55 6e 6c 6f 63 6b 4e 6f 74 69 66 79 29 (*xUnlockNotify)
9240: 28 76 6f 69 64 20 2a 2a 2c 20 69 6e 74 29 3b 20 (void **, int);
9250: 20 2f 2a 20 55 6e 6c 6f 63 6b 20 6e 6f 74 69 66 /* Unlock notif
9260: 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 y callback */.
9270: 73 71 6c 69 74 65 33 20 2a 70 4e 65 78 74 42 6c sqlite3 *pNextBl
9280: 6f 63 6b 65 64 3b 20 20 20 20 20 20 20 20 2f 2a ocked; /*
9290: 20 4e 65 78 74 20 69 6e 20 6c 69 73 74 20 6f 66 Next in list of
92a0: 20 61 6c 6c 20 62 6c 6f 63 6b 65 64 20 63 6f 6e all blocked con
92b0: 6e 65 63 74 69 6f 6e 73 20 2a 2f 0a 23 65 6e 64 nections */.#end
92c0: 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 6d if.};../*.** A m
92d0: 61 63 72 6f 20 74 6f 20 64 69 73 63 6f 76 65 72 acro to discover
92e0: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66 the encoding of
92f0: 20 61 20 64 61 74 61 62 61 73 65 2e 0a 2a 2f 0a a database..*/.
9300: 23 64 65 66 69 6e 65 20 45 4e 43 28 64 62 29 20 #define ENC(db)
9310: 28 28 64 62 29 2d 3e 61 44 62 5b 30 5d 2e 70 53 ((db)->aDb[0].pS
9320: 63 68 65 6d 61 2d 3e 65 6e 63 29 0a 0a 2f 2a 0a chema->enc)../*.
9330: 2a 2a 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 ** Possible valu
9340: 65 73 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 es for the sqlit
9350: 65 33 2e 66 6c 61 67 73 2e 0a 2a 2f 0a 23 64 65 e3.flags..*/.#de
9360: 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 62 65 fine SQLITE_Vdbe
9370: 54 72 61 63 65 20 20 20 20 20 20 30 78 30 30 30 Trace 0x000
9380: 30 30 30 30 31 20 20 2f 2a 20 54 72 75 65 20 74 00001 /* True t
9390: 6f 20 74 72 61 63 65 20 56 44 42 45 20 65 78 65 o trace VDBE exe
93a0: 63 75 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e cution */.#defin
93b0: 65 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 e SQLITE_InternC
93c0: 68 61 6e 67 65 73 20 20 30 78 30 30 30 30 30 30 hanges 0x000000
93d0: 30 32 20 20 2f 2a 20 55 6e 63 6f 6d 6d 69 74 74 02 /* Uncommitt
93e0: 65 64 20 48 61 73 68 20 74 61 62 6c 65 20 63 68 ed Hash table ch
93f0: 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 anges */.#define
9400: 20 53 51 4c 49 54 45 5f 46 75 6c 6c 46 53 79 6e SQLITE_FullFSyn
9410: 63 20 20 20 20 20 20 30 78 30 30 30 30 30 30 30 c 0x0000000
9420: 34 20 20 2f 2a 20 55 73 65 20 66 75 6c 6c 20 66 4 /* Use full f
9430: 73 79 6e 63 20 6f 6e 20 74 68 65 20 62 61 63 6b sync on the back
9440: 65 6e 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 end */.#define S
9450: 51 4c 49 54 45 5f 43 6b 70 74 46 75 6c 6c 46 53 QLITE_CkptFullFS
9460: 79 6e 63 20 20 30 78 30 30 30 30 30 30 30 38 20 ync 0x00000008
9470: 20 2f 2a 20 55 73 65 20 66 75 6c 6c 20 66 73 79 /* Use full fsy
9480: 6e 63 20 66 6f 72 20 63 68 65 63 6b 70 6f 69 6e nc for checkpoin
9490: 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c t */.#define SQL
94a0: 49 54 45 5f 43 61 63 68 65 53 70 69 6c 6c 20 20 ITE_CacheSpill
94b0: 20 20 20 30 78 30 30 30 30 30 30 31 30 20 20 2f 0x00000010 /
94c0: 2a 20 4f 4b 20 74 6f 20 73 70 69 6c 6c 20 70 61 * OK to spill pa
94d0: 67 65 72 20 63 61 63 68 65 20 2a 2f 0a 23 64 65 ger cache */.#de
94e0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 75 6c 6c fine SQLITE_Full
94f0: 43 6f 6c 4e 61 6d 65 73 20 20 20 30 78 30 30 30 ColNames 0x000
9500: 30 30 30 32 30 20 20 2f 2a 20 53 68 6f 77 20 66 00020 /* Show f
9510: 75 6c 6c 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 ull column names
9520: 20 6f 6e 20 53 45 4c 45 43 54 20 2a 2f 0a 23 64 on SELECT */.#d
9530: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 68 6f efine SQLITE_Sho
9540: 72 74 43 6f 6c 4e 61 6d 65 73 20 20 30 78 30 30 rtColNames 0x00
9550: 30 30 30 30 34 30 20 20 2f 2a 20 53 68 6f 77 20 000040 /* Show
9560: 73 68 6f 72 74 20 63 6f 6c 75 6d 6e 73 20 6e 61 short columns na
9570: 6d 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 mes */.#define S
9580: 51 4c 49 54 45 5f 43 6f 75 6e 74 52 6f 77 73 20 QLITE_CountRows
9590: 20 20 20 20 20 30 78 30 30 30 30 30 30 38 30 20 0x00000080
95a0: 20 2f 2a 20 43 6f 75 6e 74 20 72 6f 77 73 20 63 /* Count rows c
95b0: 68 61 6e 67 65 64 20 62 79 20 49 4e 53 45 52 54 hanged by INSERT
95c0: 2c 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 , */.
95d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
95e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
95f0: 2a 20 20 20 44 45 4c 45 54 45 2c 20 6f 72 20 55 * DELETE, or U
9600: 50 44 41 54 45 20 61 6e 64 20 72 65 74 75 72 6e PDATE and return
9610: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 */.
9620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
9640: 20 20 20 74 68 65 20 63 6f 75 6e 74 20 75 73 69 the count usi
9650: 6e 67 20 61 20 63 61 6c 6c 62 61 63 6b 2e 20 2a ng a callback. *
9660: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
9670: 5f 4e 75 6c 6c 43 61 6c 6c 62 61 63 6b 20 20 20 _NullCallback
9680: 30 78 30 30 30 30 30 31 30 30 20 20 2f 2a 20 49 0x00000100 /* I
9690: 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 nvoke the callba
96a0: 63 6b 20 6f 6e 63 65 20 69 66 20 74 68 65 20 2a ck once if the *
96b0: 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 /.
96c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
96d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 /*
96e0: 20 72 65 73 75 6c 74 20 73 65 74 20 69 73 20 65 result set is e
96f0: 6d 70 74 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 mpty */.#define
9700: 53 51 4c 49 54 45 5f 53 71 6c 54 72 61 63 65 20 SQLITE_SqlTrace
9710: 20 20 20 20 20 20 30 78 30 30 30 30 30 32 30 30 0x00000200
9720: 20 20 2f 2a 20 44 65 62 75 67 20 70 72 69 6e 74 /* Debug print
9730: 20 53 51 4c 20 61 73 20 69 74 20 65 78 65 63 75 SQL as it execu
9740: 74 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 tes */.#define S
9750: 51 4c 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e QLITE_VdbeListin
9760: 67 20 20 20 20 30 78 30 30 30 30 30 34 30 30 20 g 0x00000400
9770: 20 2f 2a 20 44 65 62 75 67 20 6c 69 73 74 69 6e /* Debug listin
9780: 67 73 20 6f 66 20 56 44 42 45 20 70 72 6f 67 72 gs of VDBE progr
9790: 61 6d 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ams */.#define S
97a0: 51 4c 49 54 45 5f 57 72 69 74 65 53 63 68 65 6d QLITE_WriteSchem
97b0: 61 20 20 20 20 30 78 30 30 30 30 30 38 30 30 20 a 0x00000800
97c0: 20 2f 2a 20 4f 4b 20 74 6f 20 75 70 64 61 74 65 /* OK to update
97d0: 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 2a SQLITE_MASTER *
97e0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
97f0: 5f 56 64 62 65 41 64 64 6f 70 54 72 61 63 65 20 _VdbeAddopTrace
9800: 30 78 30 30 30 30 31 30 30 30 20 20 2f 2a 20 54 0x00001000 /* T
9810: 72 61 63 65 20 73 71 6c 69 74 65 33 56 64 62 65 race sqlite3Vdbe
9820: 41 64 64 4f 70 28 29 20 63 61 6c 6c 73 20 2a 2f AddOp() calls */
9830: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
9840: 49 67 6e 6f 72 65 43 68 65 63 6b 73 20 20 20 30 IgnoreChecks 0
9850: 78 30 30 30 30 32 30 30 30 20 20 2f 2a 20 44 6f x00002000 /* Do
9860: 20 6e 6f 74 20 65 6e 66 6f 72 63 65 20 63 68 65 not enforce che
9870: 63 6b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a ck constraints *
9880: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
9890: 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 _ReadUncommitted
98a0: 20 30 78 30 30 30 34 30 30 30 20 20 2f 2a 20 46 0x0004000 /* F
98b0: 6f 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 or shared-cache
98c0: 6d 6f 64 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 mode */.#define
98d0: 53 51 4c 49 54 45 5f 4c 65 67 61 63 79 46 69 6c SQLITE_LegacyFil
98e0: 65 46 6d 74 20 20 30 78 30 30 30 30 38 30 30 30 eFmt 0x00008000
98f0: 20 20 2f 2a 20 43 72 65 61 74 65 20 6e 65 77 20 /* Create new
9900: 64 61 74 61 62 61 73 65 73 20 69 6e 20 66 6f 72 databases in for
9910: 6d 61 74 20 31 20 2a 2f 0a 23 64 65 66 69 6e 65 mat 1 */.#define
9920: 20 53 51 4c 49 54 45 5f 52 65 63 6f 76 65 72 79 SQLITE_Recovery
9930: 4d 6f 64 65 20 20 20 30 78 30 30 30 31 30 30 30 Mode 0x0001000
9940: 30 20 20 2f 2a 20 49 67 6e 6f 72 65 20 73 63 68 0 /* Ignore sch
9950: 65 6d 61 20 65 72 72 6f 72 73 20 2a 2f 0a 23 64 ema errors */.#d
9960: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 76 efine SQLITE_Rev
9970: 65 72 73 65 4f 72 64 65 72 20 20 20 30 78 30 30 erseOrder 0x00
9980: 30 32 30 30 30 30 20 20 2f 2a 20 52 65 76 65 72 020000 /* Rever
9990: 73 65 20 75 6e 6f 72 64 65 72 65 64 20 53 45 4c se unordered SEL
99a0: 45 43 54 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ECTs */.#define
99b0: 53 51 4c 49 54 45 5f 52 65 63 54 72 69 67 67 65 SQLITE_RecTrigge
99c0: 72 73 20 20 20 20 30 78 30 30 30 34 30 30 30 30 rs 0x00040000
99d0: 20 20 2f 2a 20 45 6e 61 62 6c 65 20 72 65 63 75 /* Enable recu
99e0: 72 73 69 76 65 20 74 72 69 67 67 65 72 73 20 2a rsive triggers *
99f0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
9a00: 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20 20 20 20 _ForeignKeys
9a10: 30 78 30 30 30 38 30 30 30 30 20 20 2f 2a 20 45 0x00080000 /* E
9a20: 6e 66 6f 72 63 65 20 66 6f 72 65 69 67 6e 20 6b nforce foreign k
9a30: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 20 ey constraints
9a40: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
9a50: 45 5f 41 75 74 6f 49 6e 64 65 78 20 20 20 20 20 E_AutoIndex
9a60: 20 30 78 30 30 31 30 30 30 30 30 20 20 2f 2a 20 0x00100000 /*
9a70: 45 6e 61 62 6c 65 20 61 75 74 6f 6d 61 74 69 63 Enable automatic
9a80: 20 69 6e 64 65 78 65 73 20 2a 2f 0a 23 64 65 66 indexes */.#def
9a90: 69 6e 65 20 53 51 4c 49 54 45 5f 50 72 65 66 65 ine SQLITE_Prefe
9aa0: 72 42 75 69 6c 74 69 6e 20 20 30 78 30 30 32 30 rBuiltin 0x0020
9ab0: 30 30 30 30 20 20 2f 2a 20 50 72 65 66 65 72 65 0000 /* Prefere
9ac0: 6e 63 65 20 74 6f 20 62 75 69 6c 74 2d 69 6e 20 nce to built-in
9ad0: 66 75 6e 63 73 20 2a 2f 0a 23 64 65 66 69 6e 65 funcs */.#define
9ae0: 20 53 51 4c 49 54 45 5f 4c 6f 61 64 45 78 74 65 SQLITE_LoadExte
9af0: 6e 73 69 6f 6e 20 20 30 78 30 30 34 30 30 30 30 nsion 0x0040000
9b00: 30 20 20 2f 2a 20 45 6e 61 62 6c 65 20 6c 6f 61 0 /* Enable loa
9b10: 64 5f 65 78 74 65 6e 73 69 6f 6e 20 2a 2f 0a 23 d_extension */.#
9b20: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 6e define SQLITE_En
9b30: 61 62 6c 65 54 72 69 67 67 65 72 20 20 30 78 30 ableTrigger 0x0
9b40: 30 38 30 30 30 30 30 20 20 2f 2a 20 54 72 75 65 0800000 /* True
9b50: 20 74 6f 20 65 6e 61 62 6c 65 20 74 72 69 67 67 to enable trigg
9b60: 65 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ers */.#define S
9b70: 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 20 20 QLITE_DeferFKs
9b80: 20 20 20 20 20 30 78 30 31 30 30 30 30 30 30 20 0x01000000
9b90: 20 2f 2a 20 44 65 66 65 72 20 61 6c 6c 20 46 4b /* Defer all FK
9ba0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
9bb0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 51 #define SQLITE_Q
9bc0: 75 65 72 79 4f 6e 6c 79 20 20 20 20 20 20 30 78 ueryOnly 0x
9bd0: 30 32 30 30 30 30 30 30 20 20 2f 2a 20 44 69 73 02000000 /* Dis
9be0: 61 62 6c 65 20 64 61 74 61 62 61 73 65 20 63 68 able database ch
9bf0: 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 anges */.#define
9c00: 20 53 51 4c 49 54 45 5f 56 64 62 65 45 51 50 20 SQLITE_VdbeEQP
9c10: 20 20 20 20 20 20 20 30 78 30 34 30 30 30 30 30 0x0400000
9c20: 30 20 20 2f 2a 20 44 65 62 75 67 20 45 58 50 4c 0 /* Debug EXPL
9c30: 41 49 4e 20 51 55 45 52 59 20 50 4c 41 4e 20 2a AIN QUERY PLAN *
9c40: 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69 74 73 20 6f /.../*.** Bits o
9c50: 66 20 74 68 65 20 73 71 6c 69 74 65 33 2e 64 62 f the sqlite3.db
9c60: 4f 70 74 46 6c 61 67 73 20 66 69 65 6c 64 20 74 OptFlags field t
9c70: 68 61 74 20 61 72 65 20 75 73 65 64 20 62 79 20 hat are used by
9c80: 74 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 74 the.** sqlite3_t
9c90: 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 51 4c 49 est_control(SQLI
9ca0: 54 45 5f 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 TE_TESTCTRL_OPTI
9cb0: 4d 49 5a 41 54 49 4f 4e 53 2c 2e 2e 2e 29 20 69 MIZATIONS,...) i
9cc0: 6e 74 65 72 66 61 63 65 20 74 6f 0a 2a 2a 20 73 nterface to.** s
9cd0: 65 6c 65 63 74 69 76 65 6c 79 20 64 69 73 61 62 electively disab
9ce0: 6c 65 20 76 61 72 69 6f 75 73 20 6f 70 74 69 6d le various optim
9cf0: 69 7a 61 74 69 6f 6e 73 2e 0a 2a 2f 0a 23 64 65 izations..*/.#de
9d00: 66 69 6e 65 20 53 51 4c 49 54 45 5f 51 75 65 72 fine SQLITE_Quer
9d10: 79 46 6c 61 74 74 65 6e 65 72 20 30 78 30 30 30 yFlattener 0x000
9d20: 31 20 20 20 2f 2a 20 51 75 65 72 79 20 66 6c 61 1 /* Query fla
9d30: 74 74 65 6e 69 6e 67 20 2a 2f 0a 23 64 65 66 69 ttening */.#defi
9d40: 6e 65 20 53 51 4c 49 54 45 5f 43 6f 6c 75 6d 6e ne SQLITE_Column
9d50: 43 61 63 68 65 20 20 20 20 30 78 30 30 30 32 20 Cache 0x0002
9d60: 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 63 61 63 68 /* Column cach
9d70: 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c e */.#define SQL
9d80: 49 54 45 5f 47 72 6f 75 70 42 79 4f 72 64 65 72 ITE_GroupByOrder
9d90: 20 20 20 30 78 30 30 30 34 20 20 20 2f 2a 20 47 0x0004 /* G
9da0: 52 4f 55 50 42 59 20 63 6f 76 65 72 20 6f 66 20 ROUPBY cover of
9db0: 4f 52 44 45 52 42 59 20 2a 2f 0a 23 64 65 66 69 ORDERBY */.#defi
9dc0: 6e 65 20 53 51 4c 49 54 45 5f 46 61 63 74 6f 72 ne SQLITE_Factor
9dd0: 4f 75 74 43 6f 6e 73 74 20 30 78 30 30 30 38 20 OutConst 0x0008
9de0: 20 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 66 61 /* Constant fa
9df0: 63 74 6f 72 69 6e 67 20 2a 2f 0a 2f 2a 20 20 20 ctoring */./*
9e00: 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 6f 74 not
9e10: 20 75 73 65 64 20 20 20 20 30 78 30 30 31 30 20 used 0x0010
9e20: 20 20 2f 2f 20 57 61 73 3a 20 53 51 4c 49 54 45 // Was: SQLITE
9e30: 5f 49 64 78 52 65 61 6c 41 73 49 6e 74 20 2a 2f _IdxRealAsInt */
9e40: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
9e50: 44 69 73 74 69 6e 63 74 4f 70 74 20 20 20 20 30 DistinctOpt 0
9e60: 78 30 30 32 30 20 20 20 2f 2a 20 44 49 53 54 49 x0020 /* DISTI
9e70: 4e 43 54 20 75 73 69 6e 67 20 69 6e 64 65 78 65 NCT using indexe
9e80: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
9e90: 49 54 45 5f 43 6f 76 65 72 49 64 78 53 63 61 6e ITE_CoverIdxScan
9ea0: 20 20 20 30 78 30 30 34 30 20 20 20 2f 2a 20 43 0x0040 /* C
9eb0: 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 20 73 63 overing index sc
9ec0: 61 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ans */.#define S
9ed0: 51 4c 49 54 45 5f 4f 72 64 65 72 42 79 49 64 78 QLITE_OrderByIdx
9ee0: 4a 6f 69 6e 20 30 78 30 30 38 30 20 20 20 2f 2a Join 0x0080 /*
9ef0: 20 4f 52 44 45 52 20 42 59 20 6f 66 20 6a 6f 69 ORDER BY of joi
9f00: 6e 73 20 76 69 61 20 69 6e 64 65 78 20 2a 2f 0a ns via index */.
9f10: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
9f20: 75 62 71 43 6f 72 6f 75 74 69 6e 65 20 20 30 78 ubqCoroutine 0x
9f30: 30 31 30 30 20 20 20 2f 2a 20 45 76 61 6c 75 61 0100 /* Evalua
9f40: 74 65 20 73 75 62 71 75 65 72 69 65 73 20 61 73 te subqueries as
9f50: 20 63 6f 72 6f 75 74 69 6e 65 73 20 2a 2f 0a 23 coroutines */.#
9f60: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 72 define SQLITE_Tr
9f70: 61 6e 73 69 74 69 76 65 20 20 20 20 20 30 78 30 ansitive 0x0
9f80: 32 30 30 20 20 20 2f 2a 20 54 72 61 6e 73 69 74 200 /* Transit
9f90: 69 76 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 ive constraints
9fa0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
9fb0: 45 5f 4f 6d 69 74 4e 6f 6f 70 4a 6f 69 6e 20 20 E_OmitNoopJoin
9fc0: 20 30 78 30 34 30 30 20 20 20 2f 2a 20 4f 6d 69 0x0400 /* Omi
9fd0: 74 20 75 6e 75 73 65 64 20 74 61 62 6c 65 73 20 t unused tables
9fe0: 69 6e 20 6a 6f 69 6e 73 20 2a 2f 0a 23 64 65 66 in joins */.#def
9ff0: 69 6e 65 20 53 51 4c 49 54 45 5f 53 74 61 74 33 ine SQLITE_Stat3
a000: 20 20 20 20 20 20 20 20 20 20 30 78 30 38 30 30 0x0800
a010: 20 20 20 2f 2a 20 55 73 65 20 74 68 65 20 53 51 /* Use the SQ
a020: 4c 49 54 45 5f 53 54 41 54 33 20 74 61 62 6c 65 LITE_STAT3 table
a030: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
a040: 54 45 5f 41 64 6a 75 73 74 4f 75 74 45 73 74 20 TE_AdjustOutEst
a050: 20 20 30 78 31 30 30 30 20 20 20 2f 2a 20 41 64 0x1000 /* Ad
a060: 6a 75 73 74 20 6f 75 74 70 75 74 20 65 73 74 69 just output esti
a070: 6d 61 74 65 73 20 75 73 69 6e 67 20 57 48 45 52 mates using WHER
a080: 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c E */.#define SQL
a090: 49 54 45 5f 41 6c 6c 4f 70 74 73 20 20 20 20 20 ITE_AllOpts
a0a0: 20 20 20 30 78 66 66 66 66 20 20 20 2f 2a 20 41 0xffff /* A
a0b0: 6c 6c 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 ll optimizations
a0c0: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f */../*.** Macro
a0d0: 73 20 66 6f 72 20 74 65 73 74 69 6e 67 20 77 68 s for testing wh
a0e0: 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 6f 70 74 ether or not opt
a0f0: 69 6d 69 7a 61 74 69 6f 6e 73 20 61 72 65 20 65 imizations are e
a100: 6e 61 62 6c 65 64 20 6f 72 20 64 69 73 61 62 6c nabled or disabl
a110: 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ed..*/.#ifndef S
a120: 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 QLITE_OMIT_BUILT
a130: 49 4e 5f 54 45 53 54 0a 23 64 65 66 69 6e 65 20 IN_TEST.#define
a140: 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 44 69 73 61 OptimizationDisa
a150: 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b 29 20 20 bled(db, mask)
a160: 28 28 28 64 62 29 2d 3e 64 62 4f 70 74 46 6c 61 (((db)->dbOptFla
a170: 67 73 26 28 6d 61 73 6b 29 29 21 3d 30 29 0a 23 gs&(mask))!=0).#
a180: 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 define Optimizat
a190: 69 6f 6e 45 6e 61 62 6c 65 64 28 64 62 2c 20 6d ionEnabled(db, m
a1a0: 61 73 6b 29 20 20 20 28 28 28 64 62 29 2d 3e 64 ask) (((db)->d
a1b0: 62 4f 70 74 46 6c 61 67 73 26 28 6d 61 73 6b 29 bOptFlags&(mask)
a1c0: 29 3d 3d 30 29 0a 23 65 6c 73 65 0a 23 64 65 66 )==0).#else.#def
a1d0: 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e ine Optimization
a1e0: 44 69 73 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 Disabled(db, mas
a1f0: 6b 29 20 20 30 0a 23 64 65 66 69 6e 65 20 4f 70 k) 0.#define Op
a200: 74 69 6d 69 7a 61 74 69 6f 6e 45 6e 61 62 6c 65 timizationEnable
a210: 64 28 64 62 2c 20 6d 61 73 6b 29 20 20 20 31 0a d(db, mask) 1.
a220: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 #endif../*.** Re
a230: 74 75 72 6e 20 74 72 75 65 20 69 66 20 69 74 20 turn true if it
a240: 4f 4b 20 74 6f 20 66 61 63 74 6f 72 20 63 6f 6e OK to factor con
a250: 73 74 61 6e 74 20 65 78 70 72 65 73 73 69 6f 6e stant expression
a260: 73 20 69 6e 74 6f 20 74 68 65 20 69 6e 69 74 69 s into the initi
a270: 61 6c 69 7a 61 74 69 6f 6e 0a 2a 2a 20 63 6f 64 alization.** cod
a280: 65 2e 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 e. The argument
a290: 69 73 20 61 20 50 61 72 73 65 20 6f 62 6a 65 63 is a Parse objec
a2a0: 74 20 66 6f 72 20 74 68 65 20 63 6f 64 65 20 67 t for the code g
a2b0: 65 6e 65 72 61 74 6f 72 2e 0a 2a 2f 0a 23 64 65 enerator..*/.#de
a2c0: 66 69 6e 65 20 43 6f 6e 73 74 46 61 63 74 6f 72 fine ConstFactor
a2d0: 4f 6b 28 50 29 20 5c 0a 20 20 28 28 50 29 2d 3e Ok(P) \. ((P)->
a2e0: 63 6f 6f 6b 69 65 47 6f 74 6f 3e 30 20 26 26 20 cookieGoto>0 &&
a2f0: 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 45 6e 61 62 OptimizationEnab
a300: 6c 65 64 28 28 50 29 2d 3e 64 62 2c 53 51 4c 49 led((P)->db,SQLI
a310: 54 45 5f 46 61 63 74 6f 72 4f 75 74 43 6f 6e 73 TE_FactorOutCons
a320: 74 29 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 t))../*.** Possi
a330: 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 20 74 ble values for t
a340: 68 65 20 73 71 6c 69 74 65 2e 6d 61 67 69 63 20 he sqlite.magic
a350: 66 69 65 6c 64 2e 0a 2a 2a 20 54 68 65 20 6e 75 field..** The nu
a360: 6d 62 65 72 73 20 61 72 65 20 6f 62 74 61 69 6e mbers are obtain
a370: 65 64 20 61 74 20 72 61 6e 64 6f 6d 20 61 6e 64 ed at random and
a380: 20 68 61 76 65 20 6e 6f 20 73 70 65 63 69 61 6c have no special
a390: 20 6d 65 61 6e 69 6e 67 2c 20 6f 74 68 65 72 0a meaning, other.
a3a0: 2a 2a 20 74 68 61 6e 20 62 65 69 6e 67 20 64 69 ** than being di
a3b0: 73 74 69 6e 63 74 20 66 72 6f 6d 20 6f 6e 65 20 stinct from one
a3c0: 61 6e 6f 74 68 65 72 2e 0a 2a 2f 0a 23 64 65 66 another..*/.#def
a3d0: 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 ine SQLITE_MAGIC
a3e0: 5f 4f 50 45 4e 20 20 20 20 20 30 78 61 30 32 39 _OPEN 0xa029
a3f0: 61 36 39 37 20 20 2f 2a 20 44 61 74 61 62 61 73 a697 /* Databas
a400: 65 20 69 73 20 6f 70 65 6e 20 2a 2f 0a 23 64 65 e is open */.#de
a410: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 fine SQLITE_MAGI
a420: 43 5f 43 4c 4f 53 45 44 20 20 20 30 78 39 66 33 C_CLOSED 0x9f3
a430: 63 32 64 33 33 20 20 2f 2a 20 44 61 74 61 62 61 c2d33 /* Databa
a440: 73 65 20 69 73 20 63 6c 6f 73 65 64 20 2a 2f 0a se is closed */.
a450: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d #define SQLITE_M
a460: 41 47 49 43 5f 53 49 43 4b 20 20 20 20 20 30 78 AGIC_SICK 0x
a470: 34 62 37 37 31 32 39 30 20 20 2f 2a 20 45 72 72 4b771290 /* Err
a480: 6f 72 20 61 6e 64 20 61 77 61 69 74 69 6e 67 20 or and awaiting
a490: 63 6c 6f 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 close */.#define
a4a0: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 SQLITE_MAGIC_BU
a4b0: 53 59 20 20 20 20 20 30 78 66 30 33 62 37 39 30 SY 0xf03b790
a4c0: 36 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6 /* Database c
a4d0: 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 urrently in use
a4e0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a4f0: 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 20 20 20 E_MAGIC_ERROR
a500: 20 30 78 62 35 33 35 37 39 33 30 20 20 2f 2a 20 0xb5357930 /*
a510: 41 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 An SQLITE_MISUSE
a520: 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 20 error occurred
a530: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a540: 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 20 20 E_MAGIC_ZOMBIE
a550: 20 30 78 36 34 63 66 66 63 37 66 20 20 2f 2a 20 0x64cffc7f /*
a560: 43 6c 6f 73 65 20 77 69 74 68 20 6c 61 73 74 20 Close with last
a570: 73 74 61 74 65 6d 65 6e 74 20 63 6c 6f 73 65 20 statement close
a580: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 */../*.** Each S
a590: 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 64 QL function is d
a5a0: 65 66 69 6e 65 64 20 62 79 20 61 6e 20 69 6e 73 efined by an ins
a5b0: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c tance of the fol
a5c0: 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74 lowing.** struct
a5d0: 75 72 65 2e 20 20 41 20 70 6f 69 6e 74 65 72 20 ure. A pointer
a5e0: 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 75 72 to this structur
a5f0: 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 e is stored in t
a600: 68 65 20 73 71 6c 69 74 65 2e 61 46 75 6e 63 0a he sqlite.aFunc.
a610: 2a 2a 20 68 61 73 68 20 74 61 62 6c 65 2e 20 20 ** hash table.
a620: 57 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 66 75 When multiple fu
a630: 6e 63 74 69 6f 6e 73 20 68 61 76 65 20 74 68 65 nctions have the
a640: 20 73 61 6d 65 20 6e 61 6d 65 2c 20 74 68 65 20 same name, the
a650: 68 61 73 68 20 74 61 62 6c 65 0a 2a 2a 20 70 6f hash table.** po
a660: 69 6e 74 73 20 74 6f 20 61 20 6c 69 6e 6b 65 64 ints to a linked
a670: 20 6c 69 73 74 20 6f 66 20 74 68 65 73 65 20 73 list of these s
a680: 74 72 75 63 74 75 72 65 73 2e 0a 2a 2f 0a 73 74 tructures..*/.st
a690: 72 75 63 74 20 46 75 6e 63 44 65 66 20 7b 0a 20 ruct FuncDef {.
a6a0: 20 69 31 36 20 6e 41 72 67 3b 20 20 20 20 20 20 i16 nArg;
a6b0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
a6c0: 6f 66 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 2d of arguments. -
a6d0: 31 20 6d 65 61 6e 73 20 75 6e 6c 69 6d 69 74 65 1 means unlimite
a6e0: 64 20 2a 2f 0a 20 20 75 31 36 20 66 75 6e 63 46 d */. u16 funcF
a6f0: 6c 61 67 73 3b 20 20 20 20 20 20 20 2f 2a 20 53 lags; /* S
a700: 6f 6d 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 ome combination
a710: 6f 66 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 2a of SQLITE_FUNC_*
a720: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 */. void *pUse
a730: 72 44 61 74 61 3b 20 20 20 20 20 2f 2a 20 55 73 rData; /* Us
a740: 65 72 20 64 61 74 61 20 70 61 72 61 6d 65 74 65 er data paramete
a750: 72 20 2a 2f 0a 20 20 46 75 6e 63 44 65 66 20 2a r */. FuncDef *
a760: 70 4e 65 78 74 3b 20 20 20 20 20 20 2f 2a 20 4e pNext; /* N
a770: 65 78 74 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 ext function wit
a780: 68 20 73 61 6d 65 20 6e 61 6d 65 20 2a 2f 0a 20 h same name */.
a790: 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 73 void (*xFunc)(s
a7a0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c qlite3_context*,
a7b0: 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 int,sqlite3_valu
a7c0: 65 2a 2a 29 3b 20 2f 2a 20 52 65 67 75 6c 61 72 e**); /* Regular
a7d0: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 function */. v
a7e0: 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 6c oid (*xStep)(sql
a7f0: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
a800: 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a t,sqlite3_value*
a810: 2a 29 3b 20 2f 2a 20 41 67 67 72 65 67 61 74 65 *); /* Aggregate
a820: 20 73 74 65 70 20 2a 2f 0a 20 20 76 6f 69 64 20 step */. void
a830: 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28 73 71 6c (*xFinalize)(sql
a840: 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 3b 20 ite3_context*);
a850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
a860: 2a 20 41 67 67 72 65 67 61 74 65 20 66 69 6e 61 * Aggregate fina
a870: 6c 69 7a 65 72 20 2a 2f 0a 20 20 63 68 61 72 20 lizer */. char
a880: 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 *zName;
a890: 2f 2a 20 53 51 4c 20 6e 61 6d 65 20 6f 66 20 74 /* SQL name of t
a8a0: 68 65 20 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a he function. */.
a8b0: 20 20 46 75 6e 63 44 65 66 20 2a 70 48 61 73 68 FuncDef *pHash
a8c0: 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 77 ; /* Next w
a8d0: 69 74 68 20 61 20 64 69 66 66 65 72 65 6e 74 20 ith a different
a8e0: 6e 61 6d 65 20 62 75 74 20 74 68 65 20 73 61 6d name but the sam
a8f0: 65 20 68 61 73 68 20 2a 2f 0a 20 20 46 75 6e 63 e hash */. Func
a900: 44 65 73 74 72 75 63 74 6f 72 20 2a 70 44 65 73 Destructor *pDes
a910: 74 72 75 63 74 6f 72 3b 20 20 20 2f 2a 20 52 65 tructor; /* Re
a920: 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 65 64 20 ference counted
a930: 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 74 destructor funct
a940: 69 6f 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ion */.};../*.**
a950: 20 54 68 69 73 20 73 74 72 75 63 74 75 72 65 20 This structure
a960: 65 6e 63 61 70 73 75 6c 61 74 65 73 20 61 20 75 encapsulates a u
a970: 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 73 ser-function des
a980: 74 72 75 63 74 6f 72 20 63 61 6c 6c 62 61 63 6b tructor callback
a990: 20 28 61 73 0a 2a 2a 20 63 6f 6e 66 69 67 75 72 (as.** configur
a9a0: 65 64 20 75 73 69 6e 67 20 63 72 65 61 74 65 5f ed using create_
a9b0: 66 75 6e 63 74 69 6f 6e 5f 76 32 28 29 29 20 61 function_v2()) a
a9c0: 6e 64 20 61 20 72 65 66 65 72 65 6e 63 65 20 63 nd a reference c
a9d0: 6f 75 6e 74 65 72 2e 20 57 68 65 6e 0a 2a 2a 20 ounter. When.**
a9e0: 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f create_function_
a9f0: 76 32 28 29 20 69 73 20 63 61 6c 6c 65 64 20 74 v2() is called t
aa00: 6f 20 63 72 65 61 74 65 20 61 20 66 75 6e 63 74 o create a funct
aa10: 69 6f 6e 20 77 69 74 68 20 61 20 64 65 73 74 72 ion with a destr
aa20: 75 63 74 6f 72 2c 0a 2a 2a 20 61 20 73 69 6e 67 uctor,.** a sing
aa30: 6c 65 20 6f 62 6a 65 63 74 20 6f 66 20 74 68 69 le object of thi
aa40: 73 20 74 79 70 65 20 69 73 20 61 6c 6c 6f 63 61 s type is alloca
aa50: 74 65 64 2e 20 46 75 6e 63 44 65 73 74 72 75 63 ted. FuncDestruc
aa60: 74 6f 72 2e 6e 52 65 66 20 69 73 20 73 65 74 20 tor.nRef is set
aa70: 74 6f 20 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 65 to .** the numbe
aa80: 72 20 6f 66 20 46 75 6e 63 44 65 66 20 6f 62 6a r of FuncDef obj
aa90: 65 63 74 73 20 63 72 65 61 74 65 64 20 28 65 69 ects created (ei
aaa0: 74 68 65 72 20 31 20 6f 72 20 33 2c 20 64 65 70 ther 1 or 3, dep
aab0: 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 ending on whethe
aac0: 72 0a 2a 2a 20 6f 72 20 6e 6f 74 20 74 68 65 20 r.** or not the
aad0: 73 70 65 63 69 66 69 65 64 20 65 6e 63 6f 64 69 specified encodi
aae0: 6e 67 20 69 73 20 53 51 4c 49 54 45 5f 41 4e 59 ng is SQLITE_ANY
aaf0: 29 2e 20 54 68 65 20 46 75 6e 63 44 65 66 2e 70 ). The FuncDef.p
ab00: 44 65 73 74 72 75 63 74 6f 72 0a 2a 2a 20 6d 65 Destructor.** me
ab10: 6d 62 65 72 20 6f 66 20 65 61 63 68 20 6f 66 20 mber of each of
ab20: 74 68 65 20 6e 65 77 20 46 75 6e 63 44 65 66 20 the new FuncDef
ab30: 6f 62 6a 65 63 74 73 20 69 73 20 73 65 74 20 74 objects is set t
ab40: 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 61 o point to the a
ab50: 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 46 75 6e 63 llocated.** Func
ab60: 44 65 73 74 72 75 63 74 6f 72 2e 0a 2a 2a 0a 2a Destructor..**.*
ab70: 2a 20 54 68 65 72 65 61 66 74 65 72 2c 20 77 68 * Thereafter, wh
ab80: 65 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 46 75 en one of the Fu
ab90: 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 20 69 73 ncDef objects is
aba0: 20 64 65 6c 65 74 65 64 2c 20 74 68 65 20 72 65 deleted, the re
abb0: 66 65 72 65 6e 63 65 0a 2a 2a 20 63 6f 75 6e 74 ference.** count
abc0: 20 6f 6e 20 74 68 69 73 20 6f 62 6a 65 63 74 20 on this object
abd0: 69 73 20 64 65 63 72 65 6d 65 6e 74 65 64 2e 20 is decremented.
abe0: 57 68 65 6e 20 69 74 20 72 65 61 63 68 65 73 20 When it reaches
abf0: 30 2c 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 0, the destructo
ac00: 72 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65 64 20 r.** is invoked
ac10: 61 6e 64 20 74 68 65 20 46 75 6e 63 44 65 73 74 and the FuncDest
ac20: 72 75 63 74 6f 72 20 73 74 72 75 63 74 75 72 65 ructor structure
ac30: 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 freed..*/.struc
ac40: 74 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 t FuncDestructor
ac50: 20 7b 0a 20 20 69 6e 74 20 6e 52 65 66 3b 0a 20 {. int nRef;.
ac60: 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 void (*xDestroy
ac70: 29 28 76 6f 69 64 20 2a 29 3b 0a 20 20 76 6f 69 )(void *);. voi
ac80: 64 20 2a 70 55 73 65 72 44 61 74 61 3b 0a 7d 3b d *pUserData;.};
ac90: 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c 65 ../*.** Possible
aca0: 20 76 61 6c 75 65 73 20 66 6f 72 20 46 75 6e 63 values for Func
acb0: 44 65 66 2e 66 6c 61 67 73 2e 20 20 4e 6f 74 65 Def.flags. Note
acc0: 20 74 68 61 74 20 74 68 65 20 5f 4c 45 4e 47 54 that the _LENGT
acd0: 48 20 61 6e 64 20 5f 54 59 50 45 4f 46 0a 2a 2a H and _TYPEOF.**
ace0: 20 76 61 6c 75 65 73 20 6d 75 73 74 20 63 6f 72 values must cor
acf0: 72 65 73 70 6f 6e 64 20 74 6f 20 4f 50 46 4c 41 respond to OPFLA
ad00: 47 5f 4c 45 4e 47 54 48 41 52 47 20 61 6e 64 20 G_LENGTHARG and
ad10: 4f 50 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 OPFLAG_TYPEOFARG
ad20: 2e 20 20 54 68 65 72 65 0a 2a 2a 20 61 72 65 20 . There.** are
ad30: 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
ad40: 6e 74 73 20 69 6e 20 74 68 65 20 63 6f 64 65 20 nts in the code
ad50: 74 6f 20 76 65 72 69 66 79 20 74 68 69 73 2e 0a to verify this..
ad60: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
ad70: 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 20 20 E_FUNC_ENCMASK
ad80: 30 78 30 30 33 20 2f 2a 20 53 51 4c 49 54 45 5f 0x003 /* SQLITE_
ad90: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 55 54 46 UTF8, SQLITE_UTF
ada0: 31 36 42 45 20 6f 72 20 55 54 46 31 36 4c 45 20 16BE or UTF16LE
adb0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
adc0: 45 5f 46 55 4e 43 5f 4c 49 4b 45 20 20 20 20 20 E_FUNC_LIKE
add0: 30 78 30 30 34 20 2f 2a 20 43 61 6e 64 69 64 61 0x004 /* Candida
ade0: 74 65 20 66 6f 72 20 74 68 65 20 4c 49 4b 45 20 te for the LIKE
adf0: 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 2a 2f 0a optimization */.
ae00: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
ae10: 55 4e 43 5f 43 41 53 45 20 20 20 20 20 30 78 30 UNC_CASE 0x0
ae20: 30 38 20 2f 2a 20 43 61 73 65 2d 73 65 6e 73 69 08 /* Case-sensi
ae30: 74 69 76 65 20 4c 49 4b 45 2d 74 79 70 65 20 66 tive LIKE-type f
ae40: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 unction */.#defi
ae50: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 ne SQLITE_FUNC_E
ae60: 50 48 45 4d 20 20 20 20 30 78 30 31 30 20 2f 2a PHEM 0x010 /*
ae70: 20 45 70 68 65 6d 65 72 61 6c 2e 20 20 44 65 6c Ephemeral. Del
ae80: 65 74 65 20 77 69 74 68 20 56 44 42 45 20 2a 2f ete with VDBE */
ae90: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
aea0: 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 20 30 78 FUNC_NEEDCOLL 0x
aeb0: 30 32 30 20 2f 2a 20 73 71 6c 69 74 65 33 47 65 020 /* sqlite3Ge
aec0: 74 46 75 6e 63 43 6f 6c 6c 53 65 71 28 29 20 6d tFuncCollSeq() m
aed0: 69 67 68 74 20 62 65 20 63 61 6c 6c 65 64 20 2a ight be called *
aee0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
aef0: 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 20 20 20 30 _FUNC_LENGTH 0
af00: 78 30 34 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e x040 /* Built-in
af10: 20 6c 65 6e 67 74 68 28 29 20 66 75 6e 63 74 69 length() functi
af20: 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 on */.#define SQ
af30: 4c 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 LITE_FUNC_TYPEOF
af40: 20 20 20 30 78 30 38 30 20 2f 2a 20 42 75 69 6c 0x080 /* Buil
af50: 74 2d 69 6e 20 74 79 70 65 6f 66 28 29 20 66 75 t-in typeof() fu
af60: 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e nction */.#defin
af70: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f e SQLITE_FUNC_CO
af80: 55 4e 54 20 20 20 20 30 78 31 30 30 20 2f 2a 20 UNT 0x100 /*
af90: 42 75 69 6c 74 2d 69 6e 20 63 6f 75 6e 74 28 2a Built-in count(*
afa0: 29 20 61 67 67 72 65 67 61 74 65 20 2a 2f 0a 23 ) aggregate */.#
afb0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 define SQLITE_FU
afc0: 4e 43 5f 43 4f 41 4c 45 53 43 45 20 30 78 32 30 NC_COALESCE 0x20
afd0: 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 63 6f 0 /* Built-in co
afe0: 61 6c 65 73 63 65 28 29 20 6f 72 20 69 66 6e 75 alesce() or ifnu
aff0: 6c 6c 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ll() */.#define
b000: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 55 4e 4c 49 SQLITE_FUNC_UNLI
b010: 4b 45 4c 59 20 30 78 34 30 30 20 2f 2a 20 42 75 KELY 0x400 /* Bu
b020: 69 6c 74 2d 69 6e 20 75 6e 6c 69 6b 65 6c 79 28 ilt-in unlikely(
b030: 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 ) function */.#d
b040: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
b050: 43 5f 43 4f 4e 53 54 41 4e 54 20 30 78 38 30 30 C_CONSTANT 0x800
b060: 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 69 6e 70 /* Constant inp
b070: 75 74 73 20 67 69 76 65 20 61 20 63 6f 6e 73 74 uts give a const
b080: 61 6e 74 20 6f 75 74 70 75 74 20 2a 2f 0a 0a 2f ant output */../
b090: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
b0a0: 6e 67 20 74 68 72 65 65 20 6d 61 63 72 6f 73 2c ng three macros,
b0b0: 20 46 55 4e 43 54 49 4f 4e 28 29 2c 20 4c 49 4b FUNCTION(), LIK
b0c0: 45 46 55 4e 43 28 29 20 61 6e 64 20 41 47 47 52 EFUNC() and AGGR
b0d0: 45 47 41 54 45 28 29 20 61 72 65 0a 2a 2a 20 75 EGATE() are.** u
b0e0: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 sed to create th
b0f0: 65 20 69 6e 69 74 69 61 6c 69 7a 65 72 73 20 66 e initializers f
b100: 6f 72 20 74 68 65 20 46 75 6e 63 44 65 66 20 73 or the FuncDef s
b110: 74 72 75 63 74 75 72 65 73 2e 0a 2a 2a 0a 2a 2a tructures..**.**
b120: 20 20 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d FUNCTION(zNam
b130: 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 e, nArg, iArg, b
b140: 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 NC, xFunc).**
b150: 20 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 Used to create
b160: 20 61 20 73 63 61 6c 61 72 20 66 75 6e 63 74 69 a scalar functi
b170: 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 on definition of
b180: 20 61 20 66 75 6e 63 74 69 6f 6e 20 7a 4e 61 6d a function zNam
b190: 65 20 0a 2a 2a 20 20 20 20 20 69 6d 70 6c 65 6d e .** implem
b1a0: 65 6e 74 65 64 20 62 79 20 43 20 66 75 6e 63 74 ented by C funct
b1b0: 69 6f 6e 20 78 46 75 6e 63 20 74 68 61 74 20 61 ion xFunc that a
b1c0: 63 63 65 70 74 73 20 6e 41 72 67 20 61 72 67 75 ccepts nArg argu
b1d0: 6d 65 6e 74 73 2e 20 54 68 65 0a 2a 2a 20 20 20 ments. The.**
b1e0: 20 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 61 value passed a
b1f0: 73 20 69 41 72 67 20 69 73 20 63 61 73 74 20 74 s iArg is cast t
b200: 6f 20 61 20 28 76 6f 69 64 2a 29 20 61 6e 64 20 o a (void*) and
b210: 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65 0a 2a made available.*
b220: 2a 20 20 20 20 20 61 73 20 74 68 65 20 75 73 65 * as the use
b230: 72 2d 64 61 74 61 20 28 73 71 6c 69 74 65 33 5f r-data (sqlite3_
b240: 75 73 65 72 5f 64 61 74 61 28 29 29 20 66 6f 72 user_data()) for
b250: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 20 49 the function. I
b260: 66 20 0a 2a 2a 20 20 20 20 20 61 72 67 75 6d 65 f .** argume
b270: 6e 74 20 62 4e 43 20 69 73 20 74 72 75 65 2c 20 nt bNC is true,
b280: 74 68 65 6e 20 74 68 65 20 53 51 4c 49 54 45 5f then the SQLITE_
b290: 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 20 66 6c FUNC_NEEDCOLL fl
b2a0: 61 67 20 69 73 20 73 65 74 2e 0a 2a 2a 0a 2a 2a ag is set..**.**
b2b0: 20 20 20 56 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 VFUNCTION(zNa
b2c0: 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 me, nArg, iArg,
b2d0: 62 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 bNC, xFunc).**
b2e0: 20 20 20 4c 69 6b 65 20 46 55 4e 43 54 49 4f 4e Like FUNCTION
b2f0: 20 65 78 63 65 70 74 20 69 74 20 6f 6d 69 74 73 except it omits
b300: 20 74 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 the SQLITE_FUNC
b310: 5f 43 4f 4e 53 54 41 4e 54 20 66 6c 61 67 2e 0a _CONSTANT flag..
b320: 2a 2a 0a 2a 2a 20 20 20 41 47 47 52 45 47 41 54 **.** AGGREGAT
b330: 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 E(zName, nArg, i
b340: 41 72 67 2c 20 62 4e 43 2c 20 78 53 74 65 70 2c Arg, bNC, xStep,
b350: 20 78 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 20 20 xFinal).**
b360: 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 Used to create a
b370: 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 n aggregate func
b380: 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 tion definition
b390: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 0a 2a implemented by.*
b3a0: 2a 20 20 20 20 20 74 68 65 20 43 20 66 75 6e 63 * the C func
b3b0: 74 69 6f 6e 73 20 78 53 74 65 70 20 61 6e 64 20 tions xStep and
b3c0: 78 46 69 6e 61 6c 2e 20 54 68 65 20 66 69 72 73 xFinal. The firs
b3d0: 74 20 66 6f 75 72 20 70 61 72 61 6d 65 74 65 72 t four parameter
b3e0: 73 0a 2a 2a 20 20 20 20 20 61 72 65 20 69 6e 74 s.** are int
b3f0: 65 72 70 72 65 74 65 64 20 69 6e 20 74 68 65 20 erpreted in the
b400: 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 20 same way as the
b410: 66 69 72 73 74 20 34 20 70 61 72 61 6d 65 74 65 first 4 paramete
b420: 72 73 20 74 6f 0a 2a 2a 20 20 20 20 20 46 55 4e rs to.** FUN
b430: 43 54 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a 20 20 CTION()..**.**
b440: 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d 65 2c LIKEFUNC(zName,
b450: 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 66 6c 61 nArg, pArg, fla
b460: 67 73 29 0a 2a 2a 20 20 20 20 20 55 73 65 64 20 gs).** Used
b470: 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 61 6c to create a scal
b480: 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 ar function defi
b490: 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 6e 63 nition of a func
b4a0: 74 69 6f 6e 20 7a 4e 61 6d 65 20 0a 2a 2a 20 20 tion zName .**
b4b0: 20 20 20 74 68 61 74 20 61 63 63 65 70 74 73 20 that accepts
b4c0: 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 73 20 61 nArg arguments a
b4d0: 6e 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 nd is implemente
b4e0: 64 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 43 d by a call to C
b4f0: 20 0a 2a 2a 20 20 20 20 20 66 75 6e 63 74 69 6f .** functio
b500: 6e 20 6c 69 6b 65 46 75 6e 63 2e 20 41 72 67 75 n likeFunc. Argu
b510: 6d 65 6e 74 20 70 41 72 67 20 69 73 20 63 61 73 ment pArg is cas
b520: 74 20 74 6f 20 61 20 28 76 6f 69 64 20 2a 29 20 t to a (void *)
b530: 61 6e 64 20 6d 61 64 65 0a 2a 2a 20 20 20 20 20 and made.**
b540: 61 76 61 69 6c 61 62 6c 65 20 61 73 20 74 68 65 available as the
b550: 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 72 2d 64 function user-d
b560: 61 74 61 20 28 73 71 6c 69 74 65 33 5f 75 73 65 ata (sqlite3_use
b570: 72 5f 64 61 74 61 28 29 29 2e 20 54 68 65 0a 2a r_data()). The.*
b580: 2a 20 20 20 20 20 46 75 6e 63 44 65 66 2e 66 6c * FuncDef.fl
b590: 61 67 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 ags variable is
b5a0: 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 set to the value
b5b0: 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 66 passed as the f
b5c0: 6c 61 67 73 0a 2a 2a 20 20 20 20 20 70 61 72 61 lags.** para
b5d0: 6d 65 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e meter..*/.#defin
b5e0: 65 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 e FUNCTION(zName
b5f0: 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
b600: 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e C, xFunc) \. {n
b610: 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 Arg, SQLITE_FUNC
b620: 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 _CONSTANT|SQLITE
b630: 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 _UTF8|(bNC*SQLIT
b640: 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 E_FUNC_NEEDCOLL)
b650: 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e , \. SQLITE_IN
b660: 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 T_TO_PTR(iArg),
b670: 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 20 0, xFunc, 0, 0,
b680: 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 #zName, 0, 0}.#d
b690: 65 66 69 6e 65 20 56 46 55 4e 43 54 49 4f 4e 28 efine VFUNCTION(
b6a0: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 zName, nArg, iAr
b6b0: 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c g, bNC, xFunc) \
b6c0: 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 . {nArg, SQLITE
b6d0: 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 _UTF8|(bNC*SQLIT
b6e0: 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 E_FUNC_NEEDCOLL)
b6f0: 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e , \. SQLITE_IN
b700: 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 T_TO_PTR(iArg),
b710: 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 20 0, xFunc, 0, 0,
b720: 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 #zName, 0, 0}.#d
b730: 65 66 69 6e 65 20 46 55 4e 43 54 49 4f 4e 32 28 efine FUNCTION2(
b740: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 zName, nArg, iAr
b750: 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 2c 20 65 g, bNC, xFunc, e
b760: 78 74 72 61 46 6c 61 67 73 29 20 5c 0a 20 20 7b xtraFlags) \. {
b770: 6e 41 72 67 2c 53 51 4c 49 54 45 5f 46 55 4e 43 nArg,SQLITE_FUNC
b780: 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 _CONSTANT|SQLITE
b790: 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 _UTF8|(bNC*SQLIT
b7a0: 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 E_FUNC_NEEDCOLL)
b7b0: 7c 65 78 74 72 61 46 6c 61 67 73 2c 5c 0a 20 20 |extraFlags,\.
b7c0: 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 SQLITE_INT_TO_P
b7d0: 54 52 28 69 41 72 67 29 2c 20 30 2c 20 78 46 75 TR(iArg), 0, xFu
b7e0: 6e 63 2c 20 30 2c 20 30 2c 20 23 7a 4e 61 6d 65 nc, 0, 0, #zName
b7f0: 2c 20 30 2c 20 30 7d 0a 23 64 65 66 69 6e 65 20 , 0, 0}.#define
b800: 53 54 52 5f 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 STR_FUNCTION(zNa
b810: 6d 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 me, nArg, pArg,
b820: 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 bNC, xFunc) \.
b830: 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 {nArg, SQLITE_FU
b840: 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 NC_CONSTANT|SQLI
b850: 54 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c TE_UTF8|(bNC*SQL
b860: 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c ITE_FUNC_NEEDCOL
b870: 4c 29 2c 20 5c 0a 20 20 20 70 41 72 67 2c 20 30 L), \. pArg, 0
b880: 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 20 23 , xFunc, 0, 0, #
b890: 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 65 zName, 0, 0}.#de
b8a0: 66 69 6e 65 20 4c 49 4b 45 46 55 4e 43 28 7a 4e fine LIKEFUNC(zN
b8b0: 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c 20 ame, nArg, arg,
b8c0: 66 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 67 flags) \. {nArg
b8d0: 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f , SQLITE_FUNC_CO
b8e0: 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 54 NSTANT|SQLITE_UT
b8f0: 46 38 7c 66 6c 61 67 73 2c 20 5c 0a 20 20 20 28 F8|flags, \. (
b900: 76 6f 69 64 20 2a 29 61 72 67 2c 20 30 2c 20 6c void *)arg, 0, l
b910: 69 6b 65 46 75 6e 63 2c 20 30 2c 20 30 2c 20 23 ikeFunc, 0, 0, #
b920: 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 65 zName, 0, 0}.#de
b930: 66 69 6e 65 20 41 47 47 52 45 47 41 54 45 28 7a fine AGGREGATE(z
b940: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c Name, nArg, arg,
b950: 20 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 6e nc, xStep, xFin
b960: 61 6c 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 al) \. {nArg, S
b970: 51 4c 49 54 45 5f 55 54 46 38 7c 28 6e 63 2a 53 QLITE_UTF8|(nc*S
b980: 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 QLITE_FUNC_NEEDC
b990: 4f 4c 4c 29 2c 20 5c 0a 20 20 20 53 51 4c 49 54 OLL), \. SQLIT
b9a0: 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 61 72 67 E_INT_TO_PTR(arg
b9b0: 29 2c 20 30 2c 20 30 2c 20 78 53 74 65 70 2c 78 ), 0, 0, xStep,x
b9c0: 46 69 6e 61 6c 2c 23 7a 4e 61 6d 65 2c 30 2c 30 Final,#zName,0,0
b9d0: 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 75 72 }../*.** All cur
b9e0: 72 65 6e 74 20 73 61 76 65 70 6f 69 6e 74 73 20 rent savepoints
b9f0: 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 are stored in a
ba00: 6c 69 6e 6b 65 64 20 6c 69 73 74 20 73 74 61 72 linked list star
ba10: 74 69 6e 67 20 61 74 0a 2a 2a 20 73 71 6c 69 74 ting at.** sqlit
ba20: 65 33 2e 70 53 61 76 65 70 6f 69 6e 74 2e 20 54 e3.pSavepoint. T
ba30: 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 he first element
ba40: 20 69 6e 20 74 68 65 20 6c 69 73 74 20 69 73 20 in the list is
ba50: 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c the most recentl
ba60: 79 0a 2a 2a 20 6f 70 65 6e 65 64 20 73 61 76 65 y.** opened save
ba70: 70 6f 69 6e 74 2e 20 53 61 76 65 70 6f 69 6e 74 point. Savepoint
ba80: 73 20 61 72 65 20 61 64 64 65 64 20 74 6f 20 74 s are added to t
ba90: 68 65 20 6c 69 73 74 20 62 79 20 74 68 65 20 76 he list by the v
baa0: 64 62 65 0a 2a 2a 20 4f 50 5f 53 61 76 65 70 6f dbe.** OP_Savepo
bab0: 69 6e 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e int instruction.
bac0: 0a 2a 2f 0a 73 74 72 75 63 74 20 53 61 76 65 70 .*/.struct Savep
bad0: 6f 69 6e 74 20 7b 0a 20 20 63 68 61 72 20 2a 7a oint {. char *z
bae0: 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 Name;
baf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
bb00: 53 61 76 65 70 6f 69 6e 74 20 6e 61 6d 65 20 28 Savepoint name (
bb10: 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 65 64 29 20 nul-terminated)
bb20: 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 */. i64 nDeferr
bb30: 65 64 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 edCons;
bb40: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
bb50: 65 72 20 6f 66 20 64 65 66 65 72 72 65 64 20 66 er of deferred f
bb60: 6b 20 76 69 6f 6c 61 74 69 6f 6e 73 20 2a 2f 0a k violations */.
bb70: 20 20 69 36 34 20 6e 44 65 66 65 72 72 65 64 49 i64 nDeferredI
bb80: 6d 6d 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 mmCons;
bb90: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
bba0: 6f 66 20 64 65 66 65 72 72 65 64 20 69 6d 6d 20 of deferred imm
bbb0: 66 6b 2e 20 2a 2f 0a 20 20 53 61 76 65 70 6f 69 fk. */. Savepoi
bbc0: 6e 74 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 nt *pNext;
bbd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
bbe0: 50 61 72 65 6e 74 20 73 61 76 65 70 6f 69 6e 74 Parent savepoint
bbf0: 20 28 69 66 20 61 6e 79 29 20 2a 2f 0a 7d 3b 0a (if any) */.};.
bc00: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
bc10: 77 69 6e 67 20 61 72 65 20 75 73 65 64 20 61 73 wing are used as
bc20: 20 74 68 65 20 73 65 63 6f 6e 64 20 70 61 72 61 the second para
bc30: 6d 65 74 65 72 20 74 6f 20 73 71 6c 69 74 65 33 meter to sqlite3
bc40: 53 61 76 65 70 6f 69 6e 74 28 29 2c 0a 2a 2a 20 Savepoint(),.**
bc50: 61 6e 64 20 61 73 20 74 68 65 20 50 31 20 61 72 and as the P1 ar
bc60: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 4f 50 gument to the OP
bc70: 5f 53 61 76 65 70 6f 69 6e 74 20 69 6e 73 74 72 _Savepoint instr
bc80: 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 64 65 66 69 uction..*/.#defi
bc90: 6e 65 20 53 41 56 45 50 4f 49 4e 54 5f 42 45 47 ne SAVEPOINT_BEG
bca0: 49 4e 20 20 20 20 20 20 30 0a 23 64 65 66 69 6e IN 0.#defin
bcb0: 65 20 53 41 56 45 50 4f 49 4e 54 5f 52 45 4c 45 e SAVEPOINT_RELE
bcc0: 41 53 45 20 20 20 20 31 0a 23 64 65 66 69 6e 65 ASE 1.#define
bcd0: 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c 42 SAVEPOINT_ROLLB
bce0: 41 43 4b 20 20 20 32 0a 0a 0a 2f 2a 0a 2a 2a 20 ACK 2.../*.**
bcf0: 45 61 63 68 20 53 51 4c 69 74 65 20 6d 6f 64 75 Each SQLite modu
bd00: 6c 65 20 28 76 69 72 74 75 61 6c 20 74 61 62 6c le (virtual tabl
bd10: 65 20 64 65 66 69 6e 69 74 69 6f 6e 29 20 69 73 e definition) is
bd20: 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 0a 2a defined by an.*
bd30: 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 * instance of th
bd40: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 e following stru
bd50: 63 74 75 72 65 2c 20 73 74 6f 72 65 64 20 69 6e cture, stored in
bd60: 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61 4d 6f the sqlite3.aMo
bd70: 64 75 6c 65 0a 2a 2a 20 68 61 73 68 20 74 61 62 dule.** hash tab
bd80: 6c 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4d 6f le..*/.struct Mo
bd90: 64 75 6c 65 20 7b 0a 20 20 63 6f 6e 73 74 20 73 dule {. const s
bda0: 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 qlite3_module *p
bdb0: 4d 6f 64 75 6c 65 3b 20 20 20 20 20 20 20 2f 2a Module; /*
bdc0: 20 43 61 6c 6c 62 61 63 6b 20 70 6f 69 6e 74 65 Callback pointe
bdd0: 72 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 rs */. const ch
bde0: 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 ar *zName;
bdf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
be00: 4e 61 6d 65 20 70 61 73 73 65 64 20 74 6f 20 63 Name passed to c
be10: 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a reate_module() *
be20: 2f 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 3b 20 /. void *pAux;
be30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
be40: 20 20 20 20 20 20 20 20 20 2f 2a 20 70 41 75 78 /* pAux
be50: 20 70 61 73 73 65 64 20 74 6f 20 63 72 65 61 74 passed to creat
be60: 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a 20 20 e_module() */.
be70: 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 29 void (*xDestroy)
be80: 28 76 6f 69 64 20 2a 29 3b 20 20 20 20 20 20 20 (void *);
be90: 20 20 20 20 20 2f 2a 20 4d 6f 64 75 6c 65 20 64 /* Module d
bea0: 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 estructor functi
beb0: 6f 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 on */.};../*.**
bec0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 information abou
bed0: 74 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 6f 66 t each column of
bee0: 20 61 6e 20 53 51 4c 20 74 61 62 6c 65 20 69 73 an SQL table is
bef0: 20 68 65 6c 64 20 69 6e 20 61 6e 20 69 6e 73 74 held in an inst
bf00: 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 69 73 20 ance.** of this
bf10: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 structure..*/.st
bf20: 72 75 63 74 20 43 6f 6c 75 6d 6e 20 7b 0a 20 20 ruct Column {.
bf30: 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 char *zName;
bf40: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 73 /* Name of this
bf50: 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 45 78 70 column */. Exp
bf60: 72 20 2a 70 44 66 6c 74 3b 20 20 20 20 20 2f 2a r *pDflt; /*
bf70: 20 44 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f Default value o
bf80: 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f f this column */
bf90: 0a 20 20 63 68 61 72 20 2a 7a 44 66 6c 74 3b 20 . char *zDflt;
bfa0: 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 /* Original
bfb0: 74 65 78 74 20 6f 66 20 74 68 65 20 64 65 66 61 text of the defa
bfc0: 75 6c 74 20 76 61 6c 75 65 20 2a 2f 0a 20 20 63 ult value */. c
bfd0: 68 61 72 20 2a 7a 54 79 70 65 3b 20 20 20 20 20 har *zType;
bfe0: 2f 2a 20 44 61 74 61 20 74 79 70 65 20 66 6f 72 /* Data type for
bff0: 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f 0a this column */.
c000: 20 20 63 68 61 72 20 2a 7a 43 6f 6c 6c 3b 20 20 char *zColl;
c010: 20 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 /* Collating
c020: 73 65 71 75 65 6e 63 65 2e 20 20 49 66 20 4e 55 sequence. If NU
c030: 4c 4c 2c 20 75 73 65 20 74 68 65 20 64 65 66 61 LL, use the defa
c040: 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6e 6f 74 4e ult */. u8 notN
c050: 75 6c 6c 3b 20 20 20 20 20 20 2f 2a 20 41 6e 20 ull; /* An
c060: 4f 45 5f 20 63 6f 64 65 20 66 6f 72 20 68 61 6e OE_ code for han
c070: 64 6c 69 6e 67 20 61 20 4e 4f 54 20 4e 55 4c 4c dling a NOT NULL
c080: 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 20 constraint */.
c090: 20 63 68 61 72 20 61 66 66 69 6e 69 74 79 3b 20 char affinity;
c0a0: 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20 /* One of the
c0b0: 53 51 4c 49 54 45 5f 41 46 46 5f 2e 2e 2e 20 76 SQLITE_AFF_... v
c0c0: 61 6c 75 65 73 20 2a 2f 0a 20 20 75 38 20 73 7a alues */. u8 sz
c0d0: 45 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 45 Est; /* E
c0e0: 73 74 69 6d 61 74 65 64 20 73 69 7a 65 20 6f 66 stimated size of
c0f0: 20 74 68 69 73 20 63 6f 6c 75 6d 6e 2e 20 20 49 this column. I
c100: 4e 54 3d 3d 31 20 2a 2f 0a 20 20 75 38 20 63 6f NT==1 */. u8 co
c110: 6c 46 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 42 lFlags; /* B
c120: 6f 6f 6c 65 61 6e 20 70 72 6f 70 65 72 74 69 65 oolean propertie
c130: 73 2e 20 20 53 65 65 20 43 4f 4c 46 4c 41 47 5f s. See COLFLAG_
c140: 20 64 65 66 69 6e 65 73 20 62 65 6c 6f 77 20 2a defines below *
c150: 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 /.};../* Allowed
c160: 20 76 61 6c 75 65 73 20 66 6f 72 20 43 6f 6c 75 values for Colu
c170: 6d 6e 2e 63 6f 6c 46 6c 61 67 73 3a 0a 2a 2f 0a mn.colFlags:.*/.
c180: 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f #define COLFLAG_
c190: 50 52 49 4d 4b 45 59 20 20 30 78 30 30 30 31 20 PRIMKEY 0x0001
c1a0: 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 69 73 20 /* Column is
c1b0: 70 61 72 74 20 6f 66 20 74 68 65 20 70 72 69 6d part of the prim
c1c0: 61 72 79 20 6b 65 79 20 2a 2f 0a 23 64 65 66 69 ary key */.#defi
c1d0: 6e 65 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 45 ne COLFLAG_HIDDE
c1e0: 4e 20 20 20 30 78 30 30 30 32 20 20 20 20 2f 2a N 0x0002 /*
c1f0: 20 41 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d 6e A hidden column
c200: 20 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 61 in a virtual ta
c210: 62 6c 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 ble */../*.** A
c220: 22 43 6f 6c 6c 61 74 69 6e 67 20 53 65 71 75 65 "Collating Seque
c230: 6e 63 65 22 20 69 73 20 64 65 66 69 6e 65 64 20 nce" is defined
c240: 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f by an instance o
c250: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a f the following.
c260: 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 20 43 6f ** structure. Co
c270: 6e 63 65 70 74 75 61 6c 6c 79 2c 20 61 20 63 6f nceptually, a co
c280: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
c290: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 6e consists of a n
c2a0: 61 6d 65 20 61 6e 64 0a 2a 2a 20 61 20 63 6f 6d ame and.** a com
c2b0: 70 61 72 69 73 6f 6e 20 72 6f 75 74 69 6e 65 20 parison routine
c2c0: 74 68 61 74 20 64 65 66 69 6e 65 73 20 74 68 65 that defines the
c2d0: 20 6f 72 64 65 72 20 6f 66 20 74 68 61 74 20 73 order of that s
c2e0: 65 71 75 65 6e 63 65 2e 0a 2a 2a 0a 2a 2a 20 49 equence..**.** I
c2f0: 66 20 43 6f 6c 6c 53 65 71 2e 78 43 6d 70 20 69 f CollSeq.xCmp i
c300: 73 20 4e 55 4c 4c 2c 20 69 74 20 6d 65 61 6e 73 s NULL, it means
c310: 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 63 6f 6c that the.** col
c320: 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 lating sequence
c330: 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 20 49 is undefined. I
c340: 6e 64 69 63 65 73 20 62 75 69 6c 74 20 6f 6e 20 ndices built on
c350: 61 6e 20 75 6e 64 65 66 69 6e 65 64 0a 2a 2a 20 an undefined.**
c360: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
c370: 63 65 20 6d 61 79 20 6e 6f 74 20 62 65 20 72 65 ce may not be re
c380: 61 64 20 6f 72 20 77 72 69 74 74 65 6e 2e 0a 2a ad or written..*
c390: 2f 0a 73 74 72 75 63 74 20 43 6f 6c 6c 53 65 71 /.struct CollSeq
c3a0: 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 {. char *zName
c3b0: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 ; /* Na
c3c0: 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 6c 61 74 me of the collat
c3d0: 69 6e 67 20 73 65 71 75 65 6e 63 65 2c 20 55 54 ing sequence, UT
c3e0: 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a 20 F-8 encoded */.
c3f0: 20 75 38 20 65 6e 63 3b 20 20 20 20 20 20 20 20 u8 enc;
c400: 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 65 /* Text e
c410: 6e 63 6f 64 69 6e 67 20 68 61 6e 64 6c 65 64 20 ncoding handled
c420: 62 79 20 78 43 6d 70 28 29 20 2a 2f 0a 20 20 76 by xCmp() */. v
c430: 6f 69 64 20 2a 70 55 73 65 72 3b 20 20 20 20 20 oid *pUser;
c440: 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
c450: 67 75 6d 65 6e 74 20 74 6f 20 78 43 6d 70 28 29 gument to xCmp()
c460: 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 6d 70 */. int (*xCmp
c470: 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 20 63 6f 6e )(void*,int, con
c480: 73 74 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 63 st void*, int, c
c490: 6f 6e 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 76 onst void*);. v
c4a0: 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 64 oid (*xDel)(void
c4b0: 2a 29 3b 20 20 2f 2a 20 44 65 73 74 72 75 63 74 *); /* Destruct
c4c0: 6f 72 20 66 6f 72 20 70 55 73 65 72 20 2a 2f 0a or for pUser */.
c4d0: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 6f 72 74 };../*.** A sort
c4e0: 20 6f 72 64 65 72 20 63 61 6e 20 62 65 20 65 69 order can be ei
c4f0: 74 68 65 72 20 41 53 43 20 6f 72 20 44 45 53 43 ther ASC or DESC
c500: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
c510: 49 54 45 5f 53 4f 5f 41 53 43 20 20 20 20 20 20 ITE_SO_ASC
c520: 20 30 20 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 0 /* Sort in a
c530: 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a scending order *
c540: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
c550: 5f 53 4f 5f 44 45 53 43 20 20 20 20 20 20 31 20 _SO_DESC 1
c560: 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 65 /* Sort in asce
c570: 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a 0a nding order */..
c580: 2f 2a 0a 2a 2a 20 43 6f 6c 75 6d 6e 20 61 66 66 /*.** Column aff
c590: 69 6e 69 74 79 20 74 79 70 65 73 2e 0a 2a 2a 0a inity types..**.
c5a0: 2a 2a 20 54 68 65 73 65 20 75 73 65 64 20 74 6f ** These used to
c5b0: 20 68 61 76 65 20 6d 6e 65 6d 6f 6e 69 63 20 6e have mnemonic n
c5c0: 61 6d 65 20 6c 69 6b 65 20 27 69 27 20 66 6f 72 ame like 'i' for
c5d0: 20 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 45 SQLITE_AFF_INTE
c5e0: 47 45 52 20 61 6e 64 0a 2a 2a 20 27 74 27 20 66 GER and.** 't' f
c5f0: 6f 72 20 53 51 4c 49 54 45 5f 41 46 46 5f 54 45 or SQLITE_AFF_TE
c600: 58 54 2e 20 20 42 75 74 20 77 65 20 63 61 6e 20 XT. But we can
c610: 73 61 76 65 20 61 20 6c 69 74 74 6c 65 20 73 70 save a little sp
c620: 61 63 65 20 61 6e 64 20 69 6d 70 72 6f 76 65 0a ace and improve.
c630: 2a 2a 20 74 68 65 20 73 70 65 65 64 20 61 20 6c ** the speed a l
c640: 69 74 74 6c 65 20 62 79 20 6e 75 6d 62 65 72 69 ittle by numberi
c650: 6e 67 20 74 68 65 20 76 61 6c 75 65 73 20 63 6f ng the values co
c660: 6e 73 65 63 75 74 69 76 65 6c 79 2e 20 20 0a 2a nsecutively. .*
c670: 2a 0a 2a 2a 20 42 75 74 20 72 61 74 68 65 72 20 *.** But rather
c680: 74 68 61 6e 20 73 74 61 72 74 20 77 69 74 68 20 than start with
c690: 30 20 6f 72 20 31 2c 20 77 65 20 62 65 67 69 6e 0 or 1, we begin
c6a0: 20 77 69 74 68 20 27 61 27 2e 20 20 54 68 61 74 with 'a'. That
c6b0: 20 77 61 79 2c 0a 2a 2a 20 77 68 65 6e 20 6d 75 way,.** when mu
c6c0: 6c 74 69 70 6c 65 20 61 66 66 69 6e 69 74 79 20 ltiple affinity
c6d0: 74 79 70 65 73 20 61 72 65 20 63 6f 6e 63 61 74 types are concat
c6e0: 65 6e 61 74 65 64 20 69 6e 74 6f 20 61 20 73 74 enated into a st
c6f0: 72 69 6e 67 20 61 6e 64 0a 2a 2a 20 75 73 65 64 ring and.** used
c700: 20 61 73 20 74 68 65 20 50 34 20 6f 70 65 72 61 as the P4 opera
c710: 6e 64 2c 20 74 68 65 79 20 77 69 6c 6c 20 62 65 nd, they will be
c720: 20 6d 6f 72 65 20 72 65 61 64 61 62 6c 65 2e 0a more readable..
c730: 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 61 6c 73 6f 20 **.** Note also
c740: 74 68 61 74 20 74 68 65 20 6e 75 6d 65 72 69 63 that the numeric
c750: 20 74 79 70 65 73 20 61 72 65 20 67 72 6f 75 70 types are group
c760: 65 64 20 74 6f 67 65 74 68 65 72 20 73 6f 20 74 ed together so t
c770: 68 61 74 20 74 65 73 74 69 6e 67 0a 2a 2a 20 66 hat testing.** f
c780: 6f 72 20 61 20 6e 75 6d 65 72 69 63 20 74 79 70 or a numeric typ
c790: 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20 63 6f e is a single co
c7a0: 6d 70 61 72 69 73 6f 6e 2e 0a 2a 2f 0a 23 64 65 mparison..*/.#de
c7b0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f fine SQLITE_AFF_
c7c0: 54 45 58 54 20 20 20 20 20 27 61 27 0a 23 64 65 TEXT 'a'.#de
c7d0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f fine SQLITE_AFF_
c7e0: 4e 4f 4e 45 20 20 20 20 20 27 62 27 0a 23 64 65 NONE 'b'.#de
c7f0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f fine SQLITE_AFF_
c800: 4e 55 4d 45 52 49 43 20 20 27 63 27 0a 23 64 65 NUMERIC 'c'.#de
c810: 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f fine SQLITE_AFF_
c820: 49 4e 54 45 47 45 52 20 20 27 64 27 0a 23 64 65 INTEGER 'd'.#de
c830: 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f fine SQLITE_AFF_
c840: 52 45 41 4c 20 20 20 20 20 27 65 27 0a 0a 23 64 REAL 'e'..#d
c850: 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 4e efine sqlite3IsN
c860: 75 6d 65 72 69 63 41 66 66 69 6e 69 74 79 28 58 umericAffinity(X
c870: 29 20 20 28 28 58 29 3e 3d 53 51 4c 49 54 45 5f ) ((X)>=SQLITE_
c880: 41 46 46 5f 4e 55 4d 45 52 49 43 29 0a 0a 2f 2a AFF_NUMERIC)../*
c890: 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 41 .** The SQLITE_A
c8a0: 46 46 5f 4d 41 53 4b 20 76 61 6c 75 65 73 20 6d FF_MASK values m
c8b0: 61 73 6b 73 20 6f 66 66 20 74 68 65 20 73 69 67 asks off the sig
c8c0: 6e 69 66 69 63 61 6e 74 20 62 69 74 73 20 6f 66 nificant bits of
c8d0: 20 61 6e 0a 2a 2a 20 61 66 66 69 6e 69 74 79 20 an.** affinity
c8e0: 76 61 6c 75 65 2e 20 0a 2a 2f 0a 23 64 65 66 69 value. .*/.#defi
c8f0: 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f 4d 41 ne SQLITE_AFF_MA
c900: 53 4b 20 20 20 20 20 30 78 36 37 0a 0a 2f 2a 0a SK 0x67../*.
c910: 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c 20 62 69 ** Additional bi
c920: 74 20 76 61 6c 75 65 73 20 74 68 61 74 20 63 61 t values that ca
c930: 6e 20 62 65 20 4f 52 65 64 20 77 69 74 68 20 61 n be ORed with a
c940: 6e 20 61 66 66 69 6e 69 74 79 20 77 69 74 68 6f n affinity witho
c950: 75 74 0a 2a 2a 20 63 68 61 6e 67 69 6e 67 20 74 ut.** changing t
c960: 68 65 20 61 66 66 69 6e 69 74 79 2e 0a 2a 2f 0a he affinity..*/.
c970: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4a #define SQLITE_J
c980: 55 4d 50 49 46 4e 55 4c 4c 20 20 20 30 78 30 38 UMPIFNULL 0x08
c990: 20 20 2f 2a 20 6a 75 6d 70 73 20 69 66 20 65 69 /* jumps if ei
c9a0: 74 68 65 72 20 6f 70 65 72 61 6e 64 20 69 73 20 ther operand is
c9b0: 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 69 6e 65 20 NULL */.#define
c9c0: 53 51 4c 49 54 45 5f 53 54 4f 52 45 50 32 20 20 SQLITE_STOREP2
c9d0: 20 20 20 20 30 78 31 30 20 20 2f 2a 20 53 74 6f 0x10 /* Sto
c9e0: 72 65 20 72 65 73 75 6c 74 20 69 6e 20 72 65 67 re result in reg
c9f0: 5b 50 32 5d 20 72 61 74 68 65 72 20 74 68 61 6e [P2] rather than
ca00: 20 6a 75 6d 70 20 2a 2f 0a 23 64 65 66 69 6e 65 jump */.#define
ca10: 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 45 51 20 20 SQLITE_NULLEQ
ca20: 20 20 20 20 20 30 78 38 30 20 20 2f 2a 20 4e 55 0x80 /* NU
ca30: 4c 4c 3d 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a 0a 2a LL=NULL */../*.*
ca40: 2a 20 41 6e 20 6f 62 6a 65 63 74 20 6f 66 20 74 * An object of t
ca50: 68 69 73 20 74 79 70 65 20 69 73 20 63 72 65 61 his type is crea
ca60: 74 65 64 20 66 6f 72 20 65 61 63 68 20 76 69 72 ted for each vir
ca70: 74 75 61 6c 20 74 61 62 6c 65 20 70 72 65 73 65 tual table prese
ca80: 6e 74 20 69 6e 0a 2a 2a 20 74 68 65 20 64 61 74 nt in.** the dat
ca90: 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 0a 2a abase schema. .*
caa0: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 *.** If the data
cab0: 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20 73 base schema is s
cac0: 68 61 72 65 64 2c 20 74 68 65 6e 20 74 68 65 72 hared, then ther
cad0: 65 20 69 73 20 6f 6e 65 20 69 6e 73 74 61 6e 63 e is one instanc
cae0: 65 20 6f 66 20 74 68 69 73 0a 2a 2a 20 73 74 72 e of this.** str
caf0: 75 63 74 75 72 65 20 66 6f 72 20 65 61 63 68 20 ucture for each
cb00: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
cb10: 69 6f 6e 20 28 73 71 6c 69 74 65 33 2a 29 20 74 ion (sqlite3*) t
cb20: 68 61 74 20 75 73 65 73 20 74 68 65 20 73 68 61 hat uses the sha
cb30: 72 65 64 0a 2a 2a 20 73 63 68 65 6d 61 2e 20 54 red.** schema. T
cb40: 68 69 73 20 69 73 20 62 65 63 61 75 73 65 20 65 his is because e
cb50: 61 63 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e ach database con
cb60: 6e 65 63 74 69 6f 6e 20 72 65 71 75 69 72 65 73 nection requires
cb70: 20 69 74 73 20 6f 77 6e 20 75 6e 69 71 75 65 0a its own unique.
cb80: 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 ** instance of t
cb90: 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a he sqlite3_vtab*
cba0: 20 68 61 6e 64 6c 65 20 75 73 65 64 20 74 6f 20 handle used to
cbb0: 61 63 63 65 73 73 20 74 68 65 20 76 69 72 74 75 access the virtu
cbc0: 61 6c 20 74 61 62 6c 65 20 0a 2a 2a 20 69 6d 70 al table .** imp
cbd0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 20 73 71 6c lementation. sql
cbe0: 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 6c ite3_vtab* handl
cbf0: 65 73 20 63 61 6e 20 6e 6f 74 20 62 65 20 73 68 es can not be sh
cc00: 61 72 65 64 20 62 65 74 77 65 65 6e 20 0a 2a 2a ared between .**
cc10: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 database connec
cc20: 74 69 6f 6e 73 2c 20 65 76 65 6e 20 77 68 65 6e tions, even when
cc30: 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 the rest of the
cc40: 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 in-memory datab
cc50: 61 73 65 20 0a 2a 2a 20 73 63 68 65 6d 61 20 69 ase .** schema i
cc60: 73 20 73 68 61 72 65 64 2c 20 61 73 20 74 68 65 s shared, as the
cc70: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
cc80: 6f 66 74 65 6e 20 73 74 6f 72 65 73 20 74 68 65 often stores the
cc90: 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e database.** con
cca0: 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 70 nection handle p
ccb0: 61 73 73 65 64 20 74 6f 20 69 74 20 76 69 61 20 assed to it via
ccc0: 74 68 65 20 78 43 6f 6e 6e 65 63 74 28 29 20 6f the xConnect() o
ccd0: 72 20 78 43 72 65 61 74 65 28 29 20 6d 65 74 68 r xCreate() meth
cce0: 6f 64 0a 2a 2a 20 64 75 72 69 6e 67 20 69 6e 69 od.** during ini
ccf0: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 74 65 tialization inte
cd00: 72 6e 61 6c 6c 79 2e 20 54 68 69 73 20 64 61 74 rnally. This dat
cd10: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
cd20: 20 68 61 6e 64 6c 65 20 6d 61 79 0a 2a 2a 20 74 handle may.** t
cd30: 68 65 6e 20 62 65 20 75 73 65 64 20 62 79 20 74 hen be used by t
cd40: 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 he virtual table
cd50: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
cd60: 74 6f 20 61 63 63 65 73 73 20 72 65 61 6c 20 74 to access real t
cd70: 61 62 6c 65 73 20 0a 2a 2a 20 77 69 74 68 69 6e ables .** within
cd80: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 53 the database. S
cd90: 6f 20 74 68 61 74 20 74 68 65 79 20 61 70 70 65 o that they appe
cda0: 61 72 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 ar as part of th
cdb0: 65 20 63 61 6c 6c 65 72 73 20 0a 2a 2a 20 74 72 e callers .** tr
cdc0: 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 73 65 ansaction, these
cdd0: 20 61 63 63 65 73 73 65 73 20 6e 65 65 64 20 74 accesses need t
cde0: 6f 20 62 65 20 6d 61 64 65 20 76 69 61 20 74 68 o be made via th
cdf0: 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 e same database
ce00: 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 .** connection a
ce10: 73 20 74 68 61 74 20 75 73 65 64 20 74 6f 20 65 s that used to e
ce20: 78 65 63 75 74 65 20 53 51 4c 20 6f 70 65 72 61 xecute SQL opera
ce30: 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 76 69 72 tions on the vir
ce40: 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a tual table..**.*
ce50: 2a 20 41 6c 6c 20 56 54 61 62 6c 65 20 6f 62 6a * All VTable obj
ce60: 65 63 74 73 20 74 68 61 74 20 63 6f 72 72 65 73 ects that corres
ce70: 70 6f 6e 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 pond to a single
ce80: 20 74 61 62 6c 65 20 69 6e 20 61 20 73 68 61 72 table in a shar
ce90: 65 64 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 73 ed.** database s
cea0: 63 68 65 6d 61 20 61 72 65 20 69 6e 69 74 69 61 chema are initia
ceb0: 6c 6c 79 20 73 74 6f 72 65 64 20 69 6e 20 61 20 lly stored in a
cec0: 6c 69 6e 6b 65 64 2d 6c 69 73 74 20 70 6f 69 6e linked-list poin
ced0: 74 65 64 20 74 6f 20 62 79 0a 2a 2a 20 74 68 65 ted to by.** the
cee0: 20 54 61 62 6c 65 2e 70 56 54 61 62 6c 65 20 6d Table.pVTable m
cef0: 65 6d 62 65 72 20 76 61 72 69 61 62 6c 65 20 6f ember variable o
cf00: 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 f the correspond
cf10: 69 6e 67 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 ing Table object
cf20: 2e 0a 2a 2a 20 57 68 65 6e 20 61 6e 20 73 71 6c ..** When an sql
cf30: 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 6f ite3_prepare() o
cf40: 70 65 72 61 74 69 6f 6e 20 69 73 20 72 65 71 75 peration is requ
cf50: 69 72 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 ired to access t
cf60: 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 he virtual.** ta
cf70: 62 6c 65 2c 20 69 74 20 73 65 61 72 63 68 65 73 ble, it searches
cf80: 20 74 68 65 20 6c 69 73 74 20 66 6f 72 20 74 68 the list for th
cf90: 65 20 56 54 61 62 6c 65 20 74 68 61 74 20 63 6f e VTable that co
cfa0: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 rresponds to the
cfb0: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f 6e .** database con
cfc0: 6e 65 63 74 69 6f 6e 20 64 6f 69 6e 67 20 74 68 nection doing th
cfd0: 65 20 70 72 65 70 61 72 69 6e 67 20 73 6f 20 61 e preparing so a
cfe0: 73 20 74 6f 20 75 73 65 20 74 68 65 20 63 6f 72 s to use the cor
cff0: 72 65 63 74 0a 2a 2a 20 73 71 6c 69 74 65 33 5f rect.** sqlite3_
d000: 76 74 61 62 2a 20 68 61 6e 64 6c 65 20 69 6e 20 vtab* handle in
d010: 74 68 65 20 63 6f 6d 70 69 6c 65 64 20 71 75 65 the compiled que
d020: 72 79 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 ry..**.** When a
d030: 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 54 61 62 6c n in-memory Tabl
d040: 65 20 6f 62 6a 65 63 74 20 69 73 20 64 65 6c 65 e object is dele
d050: 74 65 64 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 ted (for example
d060: 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 73 63 68 when the.** sch
d070: 65 6d 61 20 69 73 20 62 65 69 6e 67 20 72 65 6c ema is being rel
d080: 6f 61 64 65 64 20 66 6f 72 20 73 6f 6d 65 20 72 oaded for some r
d090: 65 61 73 6f 6e 29 2c 20 74 68 65 20 56 54 61 62 eason), the VTab
d0a0: 6c 65 20 6f 62 6a 65 63 74 73 20 61 72 65 20 6e le objects are n
d0b0: 6f 74 20 0a 2a 2a 20 64 65 6c 65 74 65 64 20 61 ot .** deleted a
d0c0: 6e 64 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 nd the sqlite3_v
d0d0: 74 61 62 2a 20 68 61 6e 64 6c 65 73 20 61 72 65 tab* handles are
d0e0: 20 6e 6f 74 20 78 44 69 73 63 6f 6e 6e 65 63 74 not xDisconnect
d0f0: 28 29 65 64 20 0a 2a 2a 20 69 6d 6d 65 64 69 61 ()ed .** immedia
d100: 74 65 6c 79 2e 20 49 6e 73 74 65 61 64 2c 20 74 tely. Instead, t
d110: 68 65 79 20 61 72 65 20 6d 6f 76 65 64 20 66 72 hey are moved fr
d120: 6f 6d 20 74 68 65 20 54 61 62 6c 65 2e 70 56 54 om the Table.pVT
d130: 61 62 6c 65 20 6c 69 73 74 20 74 6f 0a 2a 2a 20 able list to.**
d140: 61 6e 6f 74 68 65 72 20 6c 69 6e 6b 65 64 20 6c another linked l
d150: 69 73 74 20 68 65 61 64 65 64 20 62 79 20 74 68 ist headed by th
d160: 65 20 73 71 6c 69 74 65 33 2e 70 44 69 73 63 6f e sqlite3.pDisco
d170: 6e 6e 65 63 74 20 6d 65 6d 62 65 72 20 6f 66 20 nnect member of
d180: 74 68 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e the.** correspon
d190: 64 69 6e 67 20 73 71 6c 69 74 65 33 20 73 74 72 ding sqlite3 str
d1a0: 75 63 74 75 72 65 2e 20 54 68 65 79 20 61 72 65 ucture. They are
d1b0: 20 74 68 65 6e 20 64 65 6c 65 74 65 64 2f 78 44 then deleted/xD
d1c0: 69 73 63 6f 6e 6e 65 63 74 65 64 20 0a 2a 2a 20 isconnected .**
d1d0: 6e 65 78 74 20 74 69 6d 65 20 61 20 73 74 61 74 next time a stat
d1e0: 65 6d 65 6e 74 20 69 73 20 70 72 65 70 61 72 65 ement is prepare
d1f0: 64 20 75 73 69 6e 67 20 73 61 69 64 20 73 71 6c d using said sql
d200: 69 74 65 33 2a 2e 20 54 68 69 73 20 69 73 20 64 ite3*. This is d
d210: 6f 6e 65 0a 2a 2a 20 74 6f 20 61 76 6f 69 64 20 one.** to avoid
d220: 64 65 61 64 6c 6f 63 6b 20 69 73 73 75 65 73 20 deadlock issues
d230: 69 6e 76 6f 6c 76 69 6e 67 20 6d 75 6c 74 69 70 involving multip
d240: 6c 65 20 73 71 6c 69 74 65 33 2e 6d 75 74 65 78 le sqlite3.mutex
d250: 20 6d 75 74 65 78 65 73 2e 0a 2a 2a 20 52 65 66 mutexes..** Ref
d260: 65 72 20 74 6f 20 63 6f 6d 6d 65 6e 74 73 20 61 er to comments a
d270: 62 6f 76 65 20 66 75 6e 63 74 69 6f 6e 20 73 71 bove function sq
d280: 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c lite3VtabUnlockL
d290: 69 73 74 28 29 20 66 6f 72 20 61 6e 0a 2a 2a 20 ist() for an.**
d2a0: 65 78 70 6c 61 6e 61 74 69 6f 6e 20 61 73 20 74 explanation as t
d2b0: 6f 20 77 68 79 20 69 74 20 69 73 20 73 61 66 65 o why it is safe
d2c0: 20 74 6f 20 61 64 64 20 61 6e 20 65 6e 74 72 79 to add an entry
d2d0: 20 74 6f 20 61 6e 20 73 71 6c 69 74 65 33 2e 70 to an sqlite3.p
d2e0: 44 69 73 63 6f 6e 6e 65 63 74 0a 2a 2a 20 6c 69 Disconnect.** li
d2f0: 73 74 20 77 69 74 68 6f 75 74 20 68 6f 6c 64 69 st without holdi
d300: 6e 67 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e ng the correspon
d310: 64 69 6e 67 20 73 71 6c 69 74 65 33 2e 6d 75 74 ding sqlite3.mut
d320: 65 78 20 6d 75 74 65 78 2e 0a 2a 2a 0a 2a 2a 20 ex mutex..**.**
d330: 54 68 65 20 6d 65 6d 6f 72 79 20 66 6f 72 20 6f The memory for o
d340: 62 6a 65 63 74 73 20 6f 66 20 74 68 69 73 20 74 bjects of this t
d350: 79 70 65 20 69 73 20 61 6c 77 61 79 73 20 61 6c ype is always al
d360: 6c 6f 63 61 74 65 64 20 62 79 20 0a 2a 2a 20 73 located by .** s
d370: 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 28 29 qlite3DbMalloc()
d380: 2c 20 75 73 69 6e 67 20 74 68 65 20 63 6f 6e 6e , using the conn
d390: 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 73 74 ection handle st
d3a0: 6f 72 65 64 20 69 6e 20 56 54 61 62 6c 65 2e 64 ored in VTable.d
d3b0: 62 20 61 73 20 0a 2a 2a 20 74 68 65 20 66 69 72 b as .** the fir
d3c0: 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a st argument..*/.
d3d0: 73 74 72 75 63 74 20 56 54 61 62 6c 65 20 7b 0a struct VTable {.
d3e0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 sqlite3 *db;
d3f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
d400: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
d410: 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 on associated wi
d420: 74 68 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f th this table */
d430: 0a 20 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 3b . Module *pMod;
d440: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
d450: 50 6f 69 6e 74 65 72 20 74 6f 20 6d 6f 64 75 6c Pointer to modul
d460: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e e implementation
d470: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 */. sqlite3_vt
d480: 61 62 20 2a 70 56 74 61 62 3b 20 20 20 20 20 20 ab *pVtab;
d490: 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 76 74 /* Pointer to vt
d4a0: 61 62 20 69 6e 73 74 61 6e 63 65 20 2a 2f 0a 20 ab instance */.
d4b0: 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 int nRef;
d4c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
d4d0: 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 65 72 73 mber of pointers
d4e0: 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 75 to this structu
d4f0: 72 65 20 2a 2f 0a 20 20 75 38 20 62 43 6f 6e 73 re */. u8 bCons
d500: 74 72 61 69 6e 74 3b 20 20 20 20 20 20 20 20 20 traint;
d510: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 63 6f 6e /* True if con
d520: 73 74 72 61 69 6e 74 73 20 61 72 65 20 73 75 70 straints are sup
d530: 70 6f 72 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 ported */. int
d540: 69 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 20 iSavepoint;
d550: 20 20 20 20 20 20 2f 2a 20 44 65 70 74 68 20 6f /* Depth o
d560: 66 20 74 68 65 20 53 41 56 45 50 4f 49 4e 54 20 f the SAVEPOINT
d570: 73 74 61 63 6b 20 2a 2f 0a 20 20 56 54 61 62 6c stack */. VTabl
d580: 65 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 e *pNext;
d590: 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 /* Next in
d5a0: 6c 69 6e 6b 65 64 20 6c 69 73 74 20 28 73 65 65 linked list (see
d5b0: 20 61 62 6f 76 65 29 20 2a 2f 0a 7d 3b 0a 0a 2f above) */.};../
d5c0: 2a 0a 2a 2a 20 45 61 63 68 20 53 51 4c 20 74 61 *.** Each SQL ta
d5d0: 62 6c 65 20 69 73 20 72 65 70 72 65 73 65 6e 74 ble is represent
d5e0: 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 62 79 20 ed in memory by
d5f0: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
d600: 68 65 0a 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 he.** following
d610: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a structure..**.**
d620: 20 54 61 62 6c 65 2e 7a 4e 61 6d 65 20 69 73 20 Table.zName is
d630: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 the name of the
d640: 74 61 62 6c 65 2e 20 20 54 68 65 20 63 61 73 65 table. The case
d650: 20 6f 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c of the original
d660: 0a 2a 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 .** CREATE TABLE
d670: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73 74 statement is st
d680: 6f 72 65 64 2c 20 62 75 74 20 63 61 73 65 20 69 ored, but case i
d690: 73 20 6e 6f 74 20 73 69 67 6e 69 66 69 63 61 6e s not significan
d6a0: 74 20 66 6f 72 0a 2a 2a 20 63 6f 6d 70 61 72 69 t for.** compari
d6b0: 73 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 61 62 6c sons..**.** Tabl
d6c0: 65 2e 6e 43 6f 6c 20 69 73 20 74 68 65 20 6e 75 e.nCol is the nu
d6d0: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
d6e0: 69 6e 20 74 68 69 73 20 74 61 62 6c 65 2e 20 20 in this table.
d6f0: 54 61 62 6c 65 2e 61 43 6f 6c 20 69 73 20 61 0a Table.aCol is a.
d700: 2a 2a 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e ** pointer to an
d710: 20 61 72 72 61 79 20 6f 66 20 43 6f 6c 75 6d 6e array of Column
d720: 20 73 74 72 75 63 74 75 72 65 73 2c 20 6f 6e 65 structures, one
d730: 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e for each column
d740: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 74 ..**.** If the t
d750: 61 62 6c 65 20 68 61 73 20 61 6e 20 49 4e 54 45 able has an INTE
d760: 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 2c GER PRIMARY KEY,
d770: 20 74 68 65 6e 20 54 61 62 6c 65 2e 69 50 4b 65 then Table.iPKe
d780: 79 20 69 73 20 74 68 65 20 69 6e 64 65 78 20 6f y is the index o
d790: 66 0a 2a 2a 20 74 68 65 20 63 6f 6c 75 6d 6e 20 f.** the column
d7a0: 74 68 61 74 20 69 73 20 74 68 61 74 20 6b 65 79 that is that key
d7b0: 2e 20 20 20 4f 74 68 65 72 77 69 73 65 20 54 61 . Otherwise Ta
d7c0: 62 6c 65 2e 69 50 4b 65 79 20 69 73 20 6e 65 67 ble.iPKey is neg
d7d0: 61 74 69 76 65 2e 20 20 4e 6f 74 65 0a 2a 2a 20 ative. Note.**
d7e0: 74 68 61 74 20 74 68 65 20 64 61 74 61 74 79 70 that the datatyp
d7f0: 65 20 6f 66 20 74 68 65 20 50 52 49 4d 41 52 59 e of the PRIMARY
d800: 20 4b 45 59 20 6d 75 73 74 20 62 65 20 49 4e 54 KEY must be INT
d810: 45 47 45 52 20 66 6f 72 20 74 68 69 73 20 66 69 EGER for this fi
d820: 65 6c 64 20 74 6f 0a 2a 2a 20 62 65 20 73 65 74 eld to.** be set
d830: 2e 20 20 41 6e 20 49 4e 54 45 47 45 52 20 50 52 . An INTEGER PR
d840: 49 4d 41 52 59 20 4b 45 59 20 69 73 20 75 73 65 IMARY KEY is use
d850: 64 20 61 73 20 74 68 65 20 72 6f 77 69 64 20 66 d as the rowid f
d860: 6f 72 20 65 61 63 68 20 72 6f 77 20 6f 66 0a 2a or each row of.*
d870: 2a 20 74 68 65 20 74 61 62 6c 65 2e 20 20 49 66 * the table. If
d880: 20 61 20 74 61 62 6c 65 20 68 61 73 20 6e 6f 20 a table has no
d890: 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 INTEGER PRIMARY
d8a0: 4b 45 59 2c 20 74 68 65 6e 20 61 20 72 61 6e 64 KEY, then a rand
d8b0: 6f 6d 20 72 6f 77 69 64 0a 2a 2a 20 69 73 20 67 om rowid.** is g
d8c0: 65 6e 65 72 61 74 65 64 20 66 6f 72 20 65 61 63 enerated for eac
d8d0: 68 20 72 6f 77 20 6f 66 20 74 68 65 20 74 61 62 h row of the tab
d8e0: 6c 65 2e 20 20 54 46 5f 48 61 73 50 72 69 6d 61 le. TF_HasPrima
d8f0: 72 79 4b 65 79 20 69 73 20 73 65 74 20 69 66 0a ryKey is set if.
d900: 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 68 61 73 ** the table has
d910: 20 61 6e 79 20 50 52 49 4d 41 52 59 20 4b 45 59 any PRIMARY KEY
d920: 2c 20 49 4e 54 45 47 45 52 20 6f 72 20 6f 74 68 , INTEGER or oth
d930: 65 72 77 69 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 61 erwise..**.** Ta
d940: 62 6c 65 2e 74 6e 75 6d 20 69 73 20 74 68 65 20 ble.tnum is the
d950: 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 page number for
d960: 74 68 65 20 72 6f 6f 74 20 42 54 72 65 65 20 70 the root BTree p
d970: 61 67 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 age of the table
d980: 20 69 6e 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 in the.** datab
d990: 61 73 65 20 66 69 6c 65 2e 20 20 49 66 20 54 61 ase file. If Ta
d9a0: 62 6c 65 2e 69 44 62 20 69 73 20 74 68 65 20 69 ble.iDb is the i
d9b0: 6e 64 65 78 20 6f 66 20 74 68 65 20 64 61 74 61 ndex of the data
d9c0: 62 61 73 65 20 74 61 62 6c 65 20 62 61 63 6b 65 base table backe
d9d0: 6e 64 0a 2a 2a 20 69 6e 20 73 71 6c 69 74 65 2e nd.** in sqlite.
d9e0: 61 44 62 5b 5d 2e 20 20 30 20 69 73 20 66 6f 72 aDb[]. 0 is for
d9f0: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 the main databa
da00: 73 65 20 61 6e 64 20 31 20 69 73 20 66 6f 72 20 se and 1 is for
da10: 74 68 65 20 66 69 6c 65 20 74 68 61 74 0a 2a 2a the file that.**
da20: 20 68 6f 6c 64 73 20 74 65 6d 70 6f 72 61 72 79 holds temporary
da30: 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 tables and indi
da40: 63 65 73 2e 20 20 49 66 20 54 46 5f 45 70 68 65 ces. If TF_Ephe
da50: 6d 65 72 61 6c 20 69 73 20 73 65 74 0a 2a 2a 20 meral is set.**
da60: 74 68 65 6e 20 74 68 65 20 74 61 62 6c 65 20 69 then the table i
da70: 73 20 73 74 6f 72 65 64 20 69 6e 20 61 20 66 69 s stored in a fi
da80: 6c 65 20 74 68 61 74 20 69 73 20 61 75 74 6f 6d le that is autom
da90: 61 74 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 atically deleted
daa0: 0a 2a 2a 20 77 68 65 6e 20 74 68 65 20 56 44 42 .** when the VDB
dab0: 45 20 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 E cursor to the
dac0: 74 61 62 6c 65 20 69 73 20 63 6c 6f 73 65 64 2e table is closed.
dad0: 20 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 54 In this case T
dae0: 61 62 6c 65 2e 74 6e 75 6d 20 0a 2a 2a 20 72 65 able.tnum .** re
daf0: 66 65 72 73 20 56 44 42 45 20 63 75 72 73 6f 72 fers VDBE cursor
db00: 20 6e 75 6d 62 65 72 20 74 68 61 74 20 68 6f 6c number that hol
db10: 64 73 20 74 68 65 20 74 61 62 6c 65 20 6f 70 65 ds the table ope
db20: 6e 2c 20 6e 6f 74 20 74 6f 20 74 68 65 20 72 6f n, not to the ro
db30: 6f 74 0a 2a 2a 20 70 61 67 65 20 6e 75 6d 62 65 ot.** page numbe
db40: 72 2e 20 20 54 72 61 6e 73 69 65 6e 74 20 74 61 r. Transient ta
db50: 62 6c 65 73 20 61 72 65 20 75 73 65 64 20 74 6f bles are used to
db60: 20 68 6f 6c 64 20 74 68 65 20 72 65 73 75 6c 74 hold the result
db70: 73 20 6f 66 20 61 0a 2a 2a 20 73 75 62 2d 71 75 s of a.** sub-qu
db80: 65 72 79 20 74 68 61 74 20 61 70 70 65 61 72 73 ery that appears
db90: 20 69 6e 73 74 65 61 64 20 6f 66 20 61 20 72 65 instead of a re
dba0: 61 6c 20 74 61 62 6c 65 20 6e 61 6d 65 20 69 6e al table name in
dbb0: 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 the FROM clause
dbc0: 20 0a 2a 2a 20 6f 66 20 61 20 53 45 4c 45 43 54 .** of a SELECT
dbd0: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 statement..*/.s
dbe0: 74 72 75 63 74 20 54 61 62 6c 65 20 7b 0a 20 20 truct Table {.
dbf0: 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 char *zName;
dc00: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
dc10: 74 68 65 20 74 61 62 6c 65 20 6f 72 20 76 69 65 the table or vie
dc20: 77 20 2a 2f 0a 20 20 43 6f 6c 75 6d 6e 20 2a 61 w */. Column *a
dc30: 43 6f 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 49 Col; /* I
dc40: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 nformation about
dc50: 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a each column */.
dc60: 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b Index *pIndex;
dc70: 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
dc80: 66 20 53 51 4c 20 69 6e 64 65 78 65 73 20 6f 6e f SQL indexes on
dc90: 20 74 68 69 73 20 74 61 62 6c 65 2e 20 2a 2f 0a this table. */.
dca0: 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 Select *pSelec
dcb0: 74 3b 20 20 20 20 20 2f 2a 20 4e 55 4c 4c 20 66 t; /* NULL f
dcc0: 6f 72 20 74 61 62 6c 65 73 2e 20 20 50 6f 69 6e or tables. Poin
dcd0: 74 73 20 74 6f 20 64 65 66 69 6e 69 74 69 6f 6e ts to definition
dce0: 20 69 66 20 61 20 76 69 65 77 2e 20 2a 2f 0a 20 if a view. */.
dcf0: 20 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20 20 20 FKey *pFKey;
dd00: 20 20 20 20 20 20 2f 2a 20 4c 69 6e 6b 65 64 20 /* Linked
dd10: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 66 6f 72 65 list of all fore
dd20: 69 67 6e 20 6b 65 79 73 20 69 6e 20 74 68 69 73 ign keys in this
dd30: 20 74 61 62 6c 65 20 2a 2f 0a 20 20 63 68 61 72 table */. char
dd40: 20 2a 7a 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 *zColAff;
dd50: 20 2f 2a 20 53 74 72 69 6e 67 20 64 65 66 69 6e /* String defin
dd60: 69 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 ing the affinity
dd70: 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 of each column
dd80: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
dd90: 45 5f 4f 4d 49 54 5f 43 48 45 43 4b 0a 20 20 45 E_OMIT_CHECK. E
dda0: 78 70 72 4c 69 73 74 20 2a 70 43 68 65 63 6b 3b xprList *pCheck;
ddb0: 20 20 20 20 2f 2a 20 41 6c 6c 20 43 48 45 43 4b /* All CHECK
ddc0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
ddd0: 23 65 6e 64 69 66 0a 20 20 74 52 6f 77 63 6e 74 #endif. tRowcnt
dde0: 20 6e 52 6f 77 45 73 74 3b 20 20 20 20 20 2f 2a nRowEst; /*
ddf0: 20 45 73 74 69 6d 61 74 65 64 20 72 6f 77 73 20 Estimated rows
de00: 69 6e 20 74 61 62 6c 65 20 2d 20 66 72 6f 6d 20 in table - from
de10: 73 71 6c 69 74 65 5f 73 74 61 74 31 20 74 61 62 sqlite_stat1 tab
de20: 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 74 6e 75 6d le */. int tnum
de30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
de40: 52 6f 6f 74 20 42 54 72 65 65 20 6e 6f 64 65 20 Root BTree node
de50: 66 6f 72 20 74 68 69 73 20 74 61 62 6c 65 20 28 for this table (
de60: 73 65 65 20 6e 6f 74 65 20 61 62 6f 76 65 29 20 see note above)
de70: 2a 2f 0a 20 20 69 31 36 20 69 50 4b 65 79 3b 20 */. i16 iPKey;
de80: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 /* If
de90: 6e 6f 74 20 6e 65 67 61 74 69 76 65 2c 20 75 73 not negative, us
dea0: 65 20 61 43 6f 6c 5b 69 50 4b 65 79 5d 20 61 73 e aCol[iPKey] as
deb0: 20 74 68 65 20 70 72 69 6d 61 72 79 20 6b 65 79 the primary key
dec0: 20 2a 2f 0a 20 20 69 31 36 20 6e 43 6f 6c 3b 20 */. i16 nCol;
ded0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
dee0: 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
def0: 69 6e 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f in this table */
df00: 0a 20 20 75 31 36 20 6e 52 65 66 3b 20 20 20 20 . u16 nRef;
df10: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
df20: 72 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f r of pointers to
df30: 20 74 68 69 73 20 54 61 62 6c 65 20 2a 2f 0a 20 this Table */.
df40: 20 4c 6f 67 45 73 74 20 73 7a 54 61 62 52 6f 77 LogEst szTabRow
df50: 3b 20 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 ; /* Estimat
df60: 65 64 20 73 69 7a 65 20 6f 66 20 65 61 63 68 20 ed size of each
df70: 74 61 62 6c 65 20 72 6f 77 20 69 6e 20 62 79 74 table row in byt
df80: 65 73 20 2a 2f 0a 20 20 75 38 20 74 61 62 46 6c es */. u8 tabFl
df90: 61 67 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ags; /*
dfa0: 4d 61 73 6b 20 6f 66 20 54 46 5f 2a 20 76 61 6c Mask of TF_* val
dfb0: 75 65 73 20 2a 2f 0a 20 20 75 38 20 6b 65 79 43 ues */. u8 keyC
dfc0: 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 20 2f 2a onf; /*
dfd0: 20 57 68 61 74 20 74 6f 20 64 6f 20 69 6e 20 63 What to do in c
dfe0: 61 73 65 20 6f 66 20 75 6e 69 71 75 65 6e 65 73 ase of uniquenes
dff0: 73 20 63 6f 6e 66 6c 69 63 74 20 6f 6e 20 69 50 s conflict on iP
e000: 4b 65 79 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 Key */.#ifndef S
e010: 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 QLITE_OMIT_ALTER
e020: 54 41 42 4c 45 0a 20 20 69 6e 74 20 61 64 64 43 TABLE. int addC
e030: 6f 6c 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 olOffset; /*
e040: 4f 66 66 73 65 74 20 69 6e 20 43 52 45 41 54 45 Offset in CREATE
e050: 20 54 41 42 4c 45 20 73 74 6d 74 20 74 6f 20 61 TABLE stmt to a
e060: 64 64 20 61 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 dd a new column
e070: 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 */.#endif.#ifnde
e080: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
e090: 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69 6e 74 RTUALTABLE. int
e0a0: 20 6e 4d 6f 64 75 6c 65 41 72 67 3b 20 20 20 20 nModuleArg;
e0b0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 /* Number of a
e0c0: 72 67 75 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 rguments to the
e0d0: 6d 6f 64 75 6c 65 20 2a 2f 0a 20 20 63 68 61 72 module */. char
e0e0: 20 2a 2a 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 20 **azModuleArg;
e0f0: 20 2f 2a 20 54 65 78 74 20 6f 66 20 61 6c 6c 20 /* Text of all
e100: 6d 6f 64 75 6c 65 20 61 72 67 73 2e 20 5b 30 5d module args. [0]
e110: 20 69 73 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 is module name
e120: 2a 2f 0a 20 20 56 54 61 62 6c 65 20 2a 70 56 54 */. VTable *pVT
e130: 61 62 6c 65 3b 20 20 20 20 20 2f 2a 20 4c 69 73 able; /* Lis
e140: 74 20 6f 66 20 56 54 61 62 6c 65 20 6f 62 6a 65 t of VTable obje
e150: 63 74 73 2e 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 cts. */.#endif.
e160: 20 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 67 Trigger *pTrigg
e170: 65 72 3b 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 er; /* List of
e180: 20 74 72 69 67 67 65 72 73 20 73 74 6f 72 65 64 triggers stored
e190: 20 69 6e 20 70 53 63 68 65 6d 61 20 2a 2f 0a 20 in pSchema */.
e1a0: 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 Schema *pSchema
e1b0: 3b 20 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 ; /* Schema
e1c0: 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 that contains th
e1d0: 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 54 61 is table */. Ta
e1e0: 62 6c 65 20 2a 70 4e 65 78 74 5a 6f 6d 62 69 65 ble *pNextZombie
e1f0: 3b 20 20 2f 2a 20 4e 65 78 74 20 6f 6e 20 74 68 ; /* Next on th
e200: 65 20 50 61 72 73 65 2e 70 5a 6f 6d 62 69 65 54 e Parse.pZombieT
e210: 61 62 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f ab list */.};../
e220: 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c *.** Allowed val
e230: 75 65 73 20 66 6f 72 20 54 61 62 6c 65 2e 74 61 ues for Table.ta
e240: 62 46 6c 61 67 73 2e 0a 2a 2f 0a 23 64 65 66 69 bFlags..*/.#defi
e250: 6e 65 20 54 46 5f 52 65 61 64 6f 6e 6c 79 20 20 ne TF_Readonly
e260: 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
e270: 20 52 65 61 64 2d 6f 6e 6c 79 20 73 79 73 74 65 Read-only syste
e280: 6d 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 m table */.#defi
e290: 6e 65 20 54 46 5f 45 70 68 65 6d 65 72 61 6c 20 ne TF_Ephemeral
e2a0: 20 20 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 0x02 /*
e2b0: 20 41 6e 20 65 70 68 65 6d 65 72 61 6c 20 74 61 An ephemeral ta
e2c0: 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 ble */.#define T
e2d0: 46 5f 48 61 73 50 72 69 6d 61 72 79 4b 65 79 20 F_HasPrimaryKey
e2e0: 20 20 30 78 30 34 20 20 20 20 2f 2a 20 54 61 62 0x04 /* Tab
e2f0: 6c 65 20 68 61 73 20 61 20 70 72 69 6d 61 72 79 le has a primary
e300: 20 6b 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 key */.#define
e310: 54 46 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 TF_Autoincrement
e320: 20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 49 6e 0x08 /* In
e330: 74 65 67 65 72 20 70 72 69 6d 61 72 79 20 6b 65 teger primary ke
e340: 79 20 69 73 20 61 75 74 6f 69 6e 63 72 65 6d 65 y is autoincreme
e350: 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 nt */.#define TF
e360: 5f 56 69 72 74 75 61 6c 20 20 20 20 20 20 20 20 _Virtual
e370: 20 30 78 31 30 20 20 20 20 2f 2a 20 49 73 20 61 0x10 /* Is a
e380: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 2a virtual table *
e390: 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 57 69 74 /.#define TF_Wit
e3a0: 68 6f 75 74 52 6f 77 69 64 20 20 20 20 30 78 32 houtRowid 0x2
e3b0: 30 20 20 20 20 2f 2a 20 4e 6f 20 72 6f 77 69 64 0 /* No rowid
e3c0: 20 75 73 65 64 2e 20 50 52 49 4d 41 52 59 20 4b used. PRIMARY K
e3d0: 45 59 20 69 73 20 74 68 65 20 6b 65 79 20 2a 2f EY is the key */
e3e0: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 74 6f .../*.** Test to
e3f0: 20 73 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 see whether or
e400: 6e 6f 74 20 61 20 74 61 62 6c 65 20 69 73 20 61 not a table is a
e410: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 virtual table.
e420: 20 54 68 69 73 20 69 73 0a 2a 2a 20 64 6f 6e 65 This is.** done
e430: 20 61 73 20 61 20 6d 61 63 72 6f 20 73 6f 20 74 as a macro so t
e440: 68 61 74 20 69 74 20 77 69 6c 6c 20 62 65 20 6f hat it will be o
e450: 70 74 69 6d 69 7a 65 64 20 6f 75 74 20 77 68 65 ptimized out whe
e460: 6e 20 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 n virtual.** tab
e470: 6c 65 20 73 75 70 70 6f 72 74 20 69 73 20 6f 6d le support is om
e480: 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62 itted from the b
e490: 75 69 6c 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 uild..*/.#ifndef
e4a0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 SQLITE_OMIT_VIR
e4b0: 54 55 41 4c 54 41 42 4c 45 0a 23 20 20 64 65 66 TUALTABLE.# def
e4c0: 69 6e 65 20 49 73 56 69 72 74 75 61 6c 28 58 29 ine IsVirtual(X)
e4d0: 20 20 20 20 20 20 28 28 28 58 29 2d 3e 74 61 62 (((X)->tab
e4e0: 46 6c 61 67 73 20 26 20 54 46 5f 56 69 72 74 75 Flags & TF_Virtu
e4f0: 61 6c 29 21 3d 30 29 0a 23 20 20 64 65 66 69 6e al)!=0).# defin
e500: 65 20 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e e IsHiddenColumn
e510: 28 58 29 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c (X) (((X)->colFl
e520: 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 ags & COLFLAG_HI
e530: 44 44 45 4e 29 21 3d 30 29 0a 23 65 6c 73 65 0a DDEN)!=0).#else.
e540: 23 20 20 64 65 66 69 6e 65 20 49 73 56 69 72 74 # define IsVirt
e550: 75 61 6c 28 58 29 20 20 20 20 20 20 30 0a 23 20 ual(X) 0.#
e560: 20 64 65 66 69 6e 65 20 49 73 48 69 64 64 65 6e define IsHidden
e570: 43 6f 6c 75 6d 6e 28 58 29 20 30 0a 23 65 6e 64 Column(X) 0.#end
e580: 69 66 0a 0a 2f 2a 20 44 6f 65 73 20 74 68 65 20 if../* Does the
e590: 74 61 62 6c 65 20 68 61 76 65 20 61 20 72 6f 77 table have a row
e5a0: 69 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 48 61 id */.#define Ha
e5b0: 73 52 6f 77 69 64 28 58 29 20 20 20 20 20 28 28 sRowid(X) ((
e5c0: 28 58 29 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 (X)->tabFlags &
e5d0: 54 46 5f 57 69 74 68 6f 75 74 52 6f 77 69 64 29 TF_WithoutRowid)
e5e0: 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 ==0)../*.** Each
e5f0: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e foreign key con
e600: 73 74 72 61 69 6e 74 20 69 73 20 61 6e 20 69 6e straint is an in
e610: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
e620: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
e630: 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 66 6f 72 65 69 e..**.** A forei
e640: 67 6e 20 6b 65 79 20 69 73 20 61 73 73 6f 63 69 gn key is associ
e650: 61 74 65 64 20 77 69 74 68 20 74 77 6f 20 74 61 ated with two ta
e660: 62 6c 65 73 2e 20 20 54 68 65 20 22 66 72 6f 6d bles. The "from
e670: 22 20 74 61 62 6c 65 20 69 73 0a 2a 2a 20 74 68 " table is.** th
e680: 65 20 74 61 62 6c 65 20 74 68 61 74 20 63 6f 6e e table that con
e690: 74 61 69 6e 73 20 74 68 65 20 52 45 46 45 52 45 tains the REFERE
e6a0: 4e 43 45 53 20 63 6c 61 75 73 65 20 74 68 61 74 NCES clause that
e6b0: 20 63 72 65 61 74 65 73 20 74 68 65 20 66 6f 72 creates the for
e6c0: 65 69 67 6e 0a 2a 2a 20 6b 65 79 2e 20 20 54 68 eign.** key. Th
e6d0: 65 20 22 74 6f 22 20 74 61 62 6c 65 20 69 73 20 e "to" table is
e6e0: 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 the table that i
e6f0: 73 20 6e 61 6d 65 64 20 69 6e 20 74 68 65 20 52 s named in the R
e700: 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 EFERENCES clause
e710: 2e 0a 2a 2a 20 43 6f 6e 73 69 64 65 72 20 74 68 ..** Consider th
e720: 69 73 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a is example:.**.*
e730: 2a 20 20 20 20 20 43 52 45 41 54 45 20 54 41 42 * CREATE TAB
e740: 4c 45 20 65 78 31 28 0a 2a 2a 20 20 20 20 20 20 LE ex1(.**
e750: 20 61 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 a INTEGER PRIMA
e760: 52 59 20 4b 45 59 2c 0a 2a 2a 20 20 20 20 20 20 RY KEY,.**
e770: 20 62 20 49 4e 54 45 47 45 52 20 43 4f 4e 53 54 b INTEGER CONST
e780: 52 41 49 4e 54 20 66 6b 31 20 52 45 46 45 52 45 RAINT fk1 REFERE
e790: 4e 43 45 53 20 65 78 32 28 78 29 0a 2a 2a 20 20 NCES ex2(x).**
e7a0: 20 20 20 29 3b 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 );.**.** For
e7b0: 66 6f 72 65 69 67 6e 20 6b 65 79 20 22 66 6b 31 foreign key "fk1
e7c0: 22 2c 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 6c ", the from-tabl
e7d0: 65 20 69 73 20 22 65 78 31 22 20 61 6e 64 20 74 e is "ex1" and t
e7e0: 68 65 20 74 6f 2d 74 61 62 6c 65 20 69 73 20 22 he to-table is "
e7f0: 65 78 32 22 2e 0a 2a 2a 20 45 71 75 69 76 61 6c ex2"..** Equival
e800: 65 6e 74 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a ent names:.**.**
e810: 20 20 20 20 20 66 72 6f 6d 2d 74 61 62 6c 65 20 from-table
e820: 3d 3d 20 63 68 69 6c 64 2d 74 61 62 6c 65 0a 2a == child-table.*
e830: 2a 20 20 20 20 20 20 20 74 6f 2d 74 61 62 6c 65 * to-table
e840: 20 3d 3d 20 70 61 72 65 6e 74 2d 74 61 62 6c 65 == parent-table
e850: 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 52 45 46 45 .**.** Each REFE
e860: 52 45 4e 43 45 53 20 63 6c 61 75 73 65 20 67 65 RENCES clause ge
e870: 6e 65 72 61 74 65 73 20 61 6e 20 69 6e 73 74 61 nerates an insta
e880: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
e890: 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a wing structure.*
e8a0: 2a 20 77 68 69 63 68 20 69 73 20 61 74 74 61 63 * which is attac
e8b0: 68 65 64 20 74 6f 20 74 68 65 20 66 72 6f 6d 2d hed to the from-
e8c0: 74 61 62 6c 65 2e 20 20 54 68 65 20 74 6f 2d 74 table. The to-t
e8d0: 61 62 6c 65 20 6e 65 65 64 20 6e 6f 74 20 65 78 able need not ex
e8e0: 69 73 74 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 ist when.** the
e8f0: 66 72 6f 6d 2d 74 61 62 6c 65 20 69 73 20 63 72 from-table is cr
e900: 65 61 74 65 64 2e 20 20 54 68 65 20 65 78 69 73 eated. The exis
e910: 74 65 6e 63 65 20 6f 66 20 74 68 65 20 74 6f 2d tence of the to-
e920: 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 63 68 65 table is not che
e930: 63 6b 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 cked..**.** The
e940: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 70 61 72 65 list of all pare
e950: 6e 74 73 20 66 6f 72 20 63 68 69 6c 64 20 54 61 nts for child Ta
e960: 62 6c 65 20 58 20 69 73 20 68 65 6c 64 20 61 74 ble X is held at
e970: 20 58 2e 70 46 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 X.pFKey..**.**
e980: 41 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 63 68 A list of all ch
e990: 69 6c 64 72 65 6e 20 66 6f 72 20 61 20 74 61 62 ildren for a tab
e9a0: 6c 65 20 6e 61 6d 65 64 20 5a 20 28 77 68 69 63 le named Z (whic
e9b0: 68 20 6d 69 67 68 74 20 6e 6f 74 20 65 76 65 6e h might not even
e9c0: 20 65 78 69 73 74 29 0a 2a 2a 20 69 73 20 68 65 exist).** is he
e9d0: 6c 64 20 69 6e 20 53 63 68 65 6d 61 2e 66 6b 65 ld in Schema.fke
e9e0: 79 48 61 73 68 20 77 69 74 68 20 61 20 68 61 73 yHash with a has
e9f0: 68 20 6b 65 79 20 6f 66 20 5a 2e 0a 2a 2f 0a 73 h key of Z..*/.s
ea00: 74 72 75 63 74 20 46 4b 65 79 20 7b 0a 20 20 54 truct FKey {. T
ea10: 61 62 6c 65 20 2a 70 46 72 6f 6d 3b 20 20 20 20 able *pFrom;
ea20: 20 2f 2a 20 54 61 62 6c 65 20 63 6f 6e 74 61 69 /* Table contai
ea30: 6e 69 6e 67 20 74 68 65 20 52 45 46 45 52 45 4e ning the REFEREN
ea40: 43 45 53 20 63 6c 61 75 73 65 20 28 61 6b 61 3a CES clause (aka:
ea50: 20 43 68 69 6c 64 29 20 2a 2f 0a 20 20 46 4b 65 Child) */. FKe
ea60: 79 20 2a 70 4e 65 78 74 46 72 6f 6d 3b 20 20 2f y *pNextFrom; /
ea70: 2a 20 4e 65 78 74 20 46 4b 65 79 20 77 69 74 68 * Next FKey with
ea80: 20 74 68 65 20 73 61 6d 65 20 69 6e 20 70 46 72 the same in pFr
ea90: 6f 6d 2e 20 4e 65 78 74 20 70 61 72 65 6e 74 20 om. Next parent
eaa0: 6f 66 20 70 46 72 6f 6d 20 2a 2f 0a 20 20 63 68 of pFrom */. ch
eab0: 61 72 20 2a 7a 54 6f 3b 20 20 20 20 20 20 20 20 ar *zTo;
eac0: 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 61 62 6c 65 /* Name of table
ead0: 20 74 68 61 74 20 74 68 65 20 6b 65 79 20 70 6f that the key po
eae0: 69 6e 74 73 20 74 6f 20 28 61 6b 61 3a 20 50 61 ints to (aka: Pa
eaf0: 72 65 6e 74 29 20 2a 2f 0a 20 20 46 4b 65 79 20 rent) */. FKey
eb00: 2a 70 4e 65 78 74 54 6f 3b 20 20 20 20 2f 2a 20 *pNextTo; /*
eb10: 4e 65 78 74 20 77 69 74 68 20 74 68 65 20 73 61 Next with the sa
eb20: 6d 65 20 7a 54 6f 2e 20 4e 65 78 74 20 63 68 69 me zTo. Next chi
eb30: 6c 64 20 6f 66 20 7a 54 6f 2e 20 2a 2f 0a 20 20 ld of zTo. */.
eb40: 46 4b 65 79 20 2a 70 50 72 65 76 54 6f 3b 20 20 FKey *pPrevTo;
eb50: 20 20 2f 2a 20 50 72 65 76 69 6f 75 73 20 77 69 /* Previous wi
eb60: 74 68 20 74 68 65 20 73 61 6d 65 20 7a 54 6f 20 th the same zTo
eb70: 2a 2f 0a 20 20 69 6e 74 20 6e 43 6f 6c 3b 20 20 */. int nCol;
eb80: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
eb90: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 of columns in t
eba0: 68 69 73 20 6b 65 79 20 2a 2f 0a 20 20 2f 2a 20 his key */. /*
ebb0: 45 56 3a 20 52 2d 33 30 33 32 33 2d 32 31 39 31 EV: R-30323-2191
ebc0: 37 20 2a 2f 0a 20 20 75 38 20 69 73 44 65 66 65 7 */. u8 isDefe
ebd0: 72 72 65 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 rred; /* T
ebe0: 72 75 65 20 69 66 20 63 6f 6e 73 74 72 61 69 6e rue if constrain
ebf0: 74 20 63 68 65 63 6b 69 6e 67 20 69 73 20 64 65 t checking is de
ec00: 66 65 72 72 65 64 20 74 69 6c 6c 20 43 4f 4d 4d ferred till COMM
ec10: 49 54 20 2a 2f 0a 20 20 75 38 20 61 41 63 74 69 IT */. u8 aActi
ec20: 6f 6e 5b 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a on[2]; /*
ec30: 20 4f 4e 20 44 45 4c 45 54 45 20 61 6e 64 20 4f ON DELETE and O
ec40: 4e 20 55 50 44 41 54 45 20 61 63 74 69 6f 6e 73 N UPDATE actions
ec50: 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 20 2a , respectively *
ec60: 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 61 70 54 /. Trigger *apT
ec70: 72 69 67 67 65 72 5b 32 5d 3b 2f 2a 20 54 72 69 rigger[2];/* Tri
ec80: 67 67 65 72 73 20 66 6f 72 20 61 41 63 74 69 6f ggers for aActio
ec90: 6e 5b 5d 20 61 63 74 69 6f 6e 73 20 2a 2f 0a 20 n[] actions */.
eca0: 20 73 74 72 75 63 74 20 73 43 6f 6c 4d 61 70 20 struct sColMap
ecb0: 7b 20 20 20 20 20 20 2f 2a 20 4d 61 70 70 69 6e { /* Mappin
ecc0: 67 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 g of columns in
ecd0: 70 46 72 6f 6d 20 74 6f 20 63 6f 6c 75 6d 6e 73 pFrom to columns
ece0: 20 69 6e 20 7a 54 6f 20 2a 2f 0a 20 20 20 20 69 in zTo */. i
ecf0: 6e 74 20 69 46 72 6f 6d 3b 20 20 20 20 20 20 20 nt iFrom;
ed00: 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
ed10: 20 63 6f 6c 75 6d 6e 20 69 6e 20 70 46 72 6f 6d column in pFrom
ed20: 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 43 */. char *zC
ed30: 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ol; /*
ed40: 20 4e 61 6d 65 20 6f 66 20 63 6f 6c 75 6d 6e 20 Name of column
ed50: 69 6e 20 7a 54 6f 2e 20 20 49 66 20 4e 55 4c 4c in zTo. If NULL
ed60: 20 75 73 65 20 50 52 49 4d 41 52 59 20 4b 45 59 use PRIMARY KEY
ed70: 20 2a 2f 0a 20 20 7d 20 61 43 6f 6c 5b 31 5d 3b */. } aCol[1];
ed80: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
ed90: 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63 ne entry for eac
eda0: 68 20 6f 66 20 6e 43 6f 6c 20 63 6f 6c 75 6d 6e h of nCol column
edb0: 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 s */.};../*.** S
edc0: 51 4c 69 74 65 20 73 75 70 70 6f 72 74 73 20 6d QLite supports m
edd0: 61 6e 79 20 64 69 66 66 65 72 65 6e 74 20 77 61 any different wa
ede0: 79 73 20 74 6f 20 72 65 73 6f 6c 76 65 20 61 20 ys to resolve a
edf0: 63 6f 6e 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 constraint.** er
ee00: 72 6f 72 2e 20 20 52 4f 4c 4c 42 41 43 4b 20 70 ror. ROLLBACK p
ee10: 72 6f 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 rocessing means
ee20: 74 68 61 74 20 61 20 63 6f 6e 73 74 72 61 69 6e that a constrain
ee30: 74 20 76 69 6f 6c 61 74 69 6f 6e 0a 2a 2a 20 63 t violation.** c
ee40: 61 75 73 65 73 20 74 68 65 20 6f 70 65 72 61 74 auses the operat
ee50: 69 6f 6e 20 69 6e 20 70 72 6f 63 65 73 73 20 74 ion in process t
ee60: 6f 20 66 61 69 6c 20 61 6e 64 20 66 6f 72 20 74 o fail and for t
ee70: 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 he current trans
ee80: 61 63 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 20 action.** to be
ee90: 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 42 rolled back. AB
eea0: 4f 52 54 20 70 72 6f 63 65 73 73 69 6e 67 20 6d ORT processing m
eeb0: 65 61 6e 73 20 74 68 65 20 6f 70 65 72 61 74 69 eans the operati
eec0: 6f 6e 20 69 6e 20 70 72 6f 63 65 73 73 0a 2a 2a on in process.**
eed0: 20 66 61 69 6c 73 20 61 6e 64 20 61 6e 79 20 70 fails and any p
eee0: 72 69 6f 72 20 63 68 61 6e 67 65 73 20 66 72 6f rior changes fro
eef0: 6d 20 74 68 61 74 20 6f 6e 65 20 6f 70 65 72 61 m that one opera
ef00: 74 69 6f 6e 20 61 72 65 20 62 61 63 6b 65 64 20 tion are backed
ef10: 6f 75 74 2c 0a 2a 2a 20 62 75 74 20 74 68 65 20 out,.** but the
ef20: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e transaction is n
ef30: 6f 74 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 ot rolled back.
ef40: 20 46 41 49 4c 20 70 72 6f 63 65 73 73 69 6e 67 FAIL processing
ef50: 20 6d 65 61 6e 73 20 74 68 61 74 0a 2a 2a 20 74 means that.** t
ef60: 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 he operation in
ef70: 70 72 6f 67 72 65 73 73 20 73 74 6f 70 73 20 61 progress stops a
ef80: 6e 64 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 nd returns an er
ef90: 72 6f 72 20 63 6f 64 65 2e 20 20 42 75 74 20 70 ror code. But p
efa0: 72 69 6f 72 0a 2a 2a 20 63 68 61 6e 67 65 73 20 rior.** changes
efb0: 64 75 65 20 74 6f 20 74 68 65 20 73 61 6d 65 20 due to the same
efc0: 6f 70 65 72 61 74 69 6f 6e 20 61 72 65 20 6e 6f operation are no
efd0: 74 20 62 61 63 6b 65 64 20 6f 75 74 20 61 6e 64 t backed out and
efe0: 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a 20 no rollback.**
eff0: 6f 63 63 75 72 73 2e 20 20 49 47 4e 4f 52 45 20 occurs. IGNORE
f000: 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 70 means that the p
f010: 61 72 74 69 63 75 6c 61 72 20 72 6f 77 20 74 68 articular row th
f020: 61 74 20 63 61 75 73 65 64 20 74 68 65 20 63 6f at caused the co
f030: 6e 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f nstraint.** erro
f040: 72 20 69 73 20 6e 6f 74 20 69 6e 73 65 72 74 65 r is not inserte
f050: 64 20 6f 72 20 75 70 64 61 74 65 64 2e 20 20 50 d or updated. P
f060: 72 6f 63 65 73 73 69 6e 67 20 63 6f 6e 74 69 6e rocessing contin
f070: 75 65 73 20 61 6e 64 20 6e 6f 20 65 72 72 6f 72 ues and no error
f080: 0a 2a 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e .** is returned.
f090: 20 20 52 45 50 4c 41 43 45 20 6d 65 61 6e 73 20 REPLACE means
f0a0: 74 68 61 74 20 70 72 65 65 78 69 73 74 69 6e 67 that preexisting
f0b0: 20 64 61 74 61 62 61 73 65 20 72 6f 77 73 20 74 database rows t
f0c0: 68 61 74 20 63 61 75 73 65 64 0a 2a 2a 20 61 20 hat caused.** a
f0d0: 55 4e 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e UNIQUE constrain
f0e0: 74 20 76 69 6f 6c 61 74 69 6f 6e 20 61 72 65 20 t violation are
f0f0: 72 65 6d 6f 76 65 64 20 73 6f 20 74 68 61 74 20 removed so that
f100: 74 68 65 20 6e 65 77 20 69 6e 73 65 72 74 20 6f the new insert o
f110: 72 0a 2a 2a 20 75 70 64 61 74 65 20 63 61 6e 20 r.** update can
f120: 70 72 6f 63 65 65 64 2e 20 20 50 72 6f 63 65 73 proceed. Proces
f130: 73 69 6e 67 20 63 6f 6e 74 69 6e 75 65 73 20 61 sing continues a
f140: 6e 64 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72 nd no error is r
f150: 65 70 6f 72 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 52 eported..**.** R
f160: 45 53 54 52 49 43 54 2c 20 53 45 54 4e 55 4c 4c ESTRICT, SETNULL
f170: 2c 20 61 6e 64 20 43 41 53 43 41 44 45 20 61 63 , and CASCADE ac
f180: 74 69 6f 6e 73 20 61 70 70 6c 79 20 6f 6e 6c 79 tions apply only
f190: 20 74 6f 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 to foreign keys
f1a0: 2e 0a 2a 2a 20 52 45 53 54 52 49 43 54 20 69 73 ..** RESTRICT is
f1b0: 20 74 68 65 20 73 61 6d 65 20 61 73 20 41 42 4f the same as ABO
f1c0: 52 54 20 66 6f 72 20 49 4d 4d 45 44 49 41 54 45 RT for IMMEDIATE
f1d0: 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 61 6e foreign keys an
f1e0: 64 20 74 68 65 0a 2a 2a 20 73 61 6d 65 20 61 73 d the.** same as
f1f0: 20 52 4f 4c 4c 42 41 43 4b 20 66 6f 72 20 44 45 ROLLBACK for DE
f200: 46 45 52 52 45 44 20 6b 65 79 73 2e 20 20 53 45 FERRED keys. SE
f210: 54 4e 55 4c 4c 20 6d 65 61 6e 73 20 74 68 61 74 TNULL means that
f220: 20 74 68 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 the foreign.**
f230: 6b 65 79 20 69 73 20 73 65 74 20 74 6f 20 4e 55 key is set to NU
f240: 4c 4c 2e 20 20 43 41 53 43 41 44 45 20 6d 65 61 LL. CASCADE mea
f250: 6e 73 20 74 68 61 74 20 61 20 44 45 4c 45 54 45 ns that a DELETE
f260: 20 6f 72 20 55 50 44 41 54 45 20 6f 66 20 74 68 or UPDATE of th
f270: 65 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 64 20 e.** referenced
f280: 74 61 62 6c 65 20 72 6f 77 20 69 73 20 70 72 6f table row is pro
f290: 70 61 67 61 74 65 64 20 69 6e 74 6f 20 74 68 65 pagated into the
f2a0: 20 72 6f 77 20 74 68 61 74 20 68 6f 6c 64 73 20 row that holds
f2b0: 74 68 65 0a 2a 2a 20 66 6f 72 65 69 67 6e 20 6b the.** foreign k
f2c0: 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 54 68 65 20 66 ey..** .** The f
f2d0: 6f 6c 6c 6f 77 69 6e 67 20 73 79 6d 62 6f 6c 69 ollowing symboli
f2e0: 63 20 76 61 6c 75 65 73 20 61 72 65 20 75 73 65 c values are use
f2f0: 64 20 74 6f 20 72 65 63 6f 72 64 20 77 68 69 63 d to record whic
f300: 68 20 74 79 70 65 0a 2a 2a 20 6f 66 20 61 63 74 h type.** of act
f310: 69 6f 6e 20 74 6f 20 74 61 6b 65 2e 0a 2a 2f 0a ion to take..*/.
f320: 23 64 65 66 69 6e 65 20 4f 45 5f 4e 6f 6e 65 20 #define OE_None
f330: 20 20 20 20 30 20 20 20 2f 2a 20 54 68 65 72 65 0 /* There
f340: 20 69 73 20 6e 6f 20 63 6f 6e 73 74 72 61 69 6e is no constrain
f350: 74 20 74 6f 20 63 68 65 63 6b 20 2a 2f 0a 23 64 t to check */.#d
f360: 65 66 69 6e 65 20 4f 45 5f 52 6f 6c 6c 62 61 63 efine OE_Rollbac
f370: 6b 20 31 20 20 20 2f 2a 20 46 61 69 6c 20 74 68 k 1 /* Fail th
f380: 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 6e 64 20 e operation and
f390: 72 6f 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 rollback the tra
f3a0: 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 nsaction */.#def
f3b0: 69 6e 65 20 4f 45 5f 41 62 6f 72 74 20 20 20 20 ine OE_Abort
f3c0: 32 20 20 20 2f 2a 20 42 61 63 6b 20 6f 75 74 20 2 /* Back out
f3d0: 63 68 61 6e 67 65 73 20 62 75 74 20 64 6f 20 6e changes but do n
f3e0: 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 72 61 6e 73 o rollback trans
f3f0: 61 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e action */.#defin
f400: 65 20 4f 45 5f 46 61 69 6c 20 20 20 20 20 33 20 e OE_Fail 3
f410: 20 20 2f 2a 20 53 74 6f 70 20 74 68 65 20 6f 70 /* Stop the op
f420: 65 72 61 74 69 6f 6e 20 62 75 74 20 6c 65 61 76 eration but leav
f430: 65 20 61 6c 6c 20 70 72 69 6f 72 20 63 68 61 6e e all prior chan
f440: 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f ges */.#define O
f450: 45 5f 49 67 6e 6f 72 65 20 20 20 34 20 20 20 2f E_Ignore 4 /
f460: 2a 20 49 67 6e 6f 72 65 20 74 68 65 20 65 72 72 * Ignore the err
f470: 6f 72 2e 20 44 6f 20 6e 6f 74 20 64 6f 20 74 68 or. Do not do th
f480: 65 20 49 4e 53 45 52 54 20 6f 72 20 55 50 44 41 e INSERT or UPDA
f490: 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 TE */.#define OE
f4a0: 5f 52 65 70 6c 61 63 65 20 20 35 20 20 20 2f 2a _Replace 5 /*
f4b0: 20 44 65 6c 65 74 65 20 65 78 69 73 74 69 6e 67 Delete existing
f4c0: 20 72 65 63 6f 72 64 2c 20 74 68 65 6e 20 64 6f record, then do
f4d0: 20 49 4e 53 45 52 54 20 6f 72 20 55 50 44 41 54 INSERT or UPDAT
f4e0: 45 20 2a 2f 0a 0a 23 64 65 66 69 6e 65 20 4f 45 E */..#define OE
f4f0: 5f 52 65 73 74 72 69 63 74 20 36 20 20 20 2f 2a _Restrict 6 /*
f500: 20 4f 45 5f 41 62 6f 72 74 20 66 6f 72 20 49 4d OE_Abort for IM
f510: 4d 45 44 49 41 54 45 2c 20 4f 45 5f 52 6f 6c 6c MEDIATE, OE_Roll
f520: 62 61 63 6b 20 66 6f 72 20 44 45 46 45 52 52 45 back for DEFERRE
f530: 44 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f D */.#define OE_
f540: 53 65 74 4e 75 6c 6c 20 20 37 20 20 20 2f 2a 20 SetNull 7 /*
f550: 53 65 74 20 74 68 65 20 66 6f 72 65 69 67 6e 20 Set the foreign
f560: 6b 65 79 20 76 61 6c 75 65 20 74 6f 20 4e 55 4c key value to NUL
f570: 4c 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f L */.#define OE_
f580: 53 65 74 44 66 6c 74 20 20 38 20 20 20 2f 2a 20 SetDflt 8 /*
f590: 53 65 74 20 74 68 65 20 66 6f 72 65 69 67 6e 20 Set the foreign
f5a0: 6b 65 79 20 76 61 6c 75 65 20 74 6f 20 69 74 73 key value to its
f5b0: 20 64 65 66 61 75 6c 74 20 2a 2f 0a 23 64 65 66 default */.#def
f5c0: 69 6e 65 20 4f 45 5f 43 61 73 63 61 64 65 20 20 ine OE_Cascade
f5d0: 39 20 20 20 2f 2a 20 43 61 73 63 61 64 65 20 74 9 /* Cascade t
f5e0: 68 65 20 63 68 61 6e 67 65 73 20 2a 2f 0a 0a 23 he changes */..#
f5f0: 64 65 66 69 6e 65 20 4f 45 5f 44 65 66 61 75 6c define OE_Defaul
f600: 74 20 20 31 30 20 20 2f 2a 20 44 6f 20 77 68 61 t 10 /* Do wha
f610: 74 65 76 65 72 20 74 68 65 20 64 65 66 61 75 6c tever the defaul
f620: 74 20 61 63 74 69 6f 6e 20 69 73 20 2a 2f 0a 0a t action is */..
f630: 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
f640: 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
f650: 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 69 73 ing structure is
f660: 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 66 passed as the f
f670: 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 irst.** argument
f680: 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65 4b to sqlite3VdbeK
f690: 65 79 43 6f 6d 70 61 72 65 20 61 6e 64 20 69 73 eyCompare and is
f6a0: 20 75 73 65 64 20 74 6f 20 63 6f 6e 74 72 6f 6c used to control
f6b0: 20 74 68 65 20 0a 2a 2a 20 63 6f 6d 70 61 72 69 the .** compari
f6c0: 73 6f 6e 20 6f 66 20 74 68 65 20 74 77 6f 20 69 son of the two i
f6d0: 6e 64 65 78 20 6b 65 79 73 2e 0a 2a 2a 0a 2a 2a ndex keys..**.**
f6e0: 20 4e 6f 74 65 20 74 68 61 74 20 61 53 6f 72 74 Note that aSort
f6f0: 4f 72 64 65 72 5b 5d 20 61 6e 64 20 61 43 6f 6c Order[] and aCol
f700: 6c 5b 5d 20 68 61 76 65 20 6e 46 69 65 6c 64 2b l[] have nField+
f710: 31 20 73 6c 6f 74 73 2e 20 20 54 68 65 72 65 0a 1 slots. There.
f720: 2a 2a 20 61 72 65 20 6e 46 69 65 6c 64 20 73 6c ** are nField sl
f730: 6f 74 73 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 ots for the colu
f740: 6d 6e 73 20 6f 66 20 61 6e 20 69 6e 64 65 78 20 mns of an index
f750: 74 68 65 6e 20 6f 6e 65 20 65 78 74 72 61 20 73 then one extra s
f760: 6c 6f 74 0a 2a 2a 20 66 6f 72 20 74 68 65 20 72 lot.** for the r
f770: 6f 77 69 64 20 61 74 20 74 68 65 20 65 6e 64 2e owid at the end.
f780: 0a 2a 2f 0a 73 74 72 75 63 74 20 4b 65 79 49 6e .*/.struct KeyIn
f790: 66 6f 20 7b 0a 20 20 75 33 32 20 6e 52 65 66 3b fo {. u32 nRef;
f7a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
f7b0: 6d 62 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 mber of referenc
f7c0: 65 73 20 74 6f 20 74 68 69 73 20 4b 65 79 49 6e es to this KeyIn
f7d0: 66 6f 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 75 fo object */. u
f7e0: 38 20 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 8 enc;
f7f0: 20 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 /* Text encod
f800: 69 6e 67 20 2d 20 6f 6e 65 20 6f 66 20 74 68 65 ing - one of the
f810: 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 76 61 6c SQLITE_UTF* val
f820: 75 65 73 20 2a 2f 0a 20 20 75 31 36 20 6e 46 69 ues */. u16 nFi
f830: 65 6c 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 eld; /*
f840: 4e 75 6d 62 65 72 20 6f 66 20 6b 65 79 20 63 6f Number of key co
f850: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 69 6e 64 lumns in the ind
f860: 65 78 20 2a 2f 0a 20 20 75 31 36 20 6e 58 46 69 ex */. u16 nXFi
f870: 65 6c 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e eld; /* N
f880: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 umber of columns
f890: 20 62 65 79 6f 6e 64 20 74 68 65 20 6b 65 79 20 beyond the key
f8a0: 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 73 71 6c columns */. sql
f8b0: 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 ite3 *db;
f8c0: 20 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 /* The database
f8d0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 connection */.
f8e0: 20 75 38 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b u8 *aSortOrder;
f8f0: 20 20 20 20 20 2f 2a 20 53 6f 72 74 20 6f 72 64 /* Sort ord
f900: 65 72 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 er for each colu
f910: 6d 6e 2e 20 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 mn. */. CollSeq
f920: 20 2a 61 43 6f 6c 6c 5b 31 5d 3b 20 20 2f 2a 20 *aColl[1]; /*
f930: 43 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e Collating sequen
f940: 63 65 20 66 6f 72 20 65 61 63 68 20 74 65 72 6d ce for each term
f950: 20 6f 66 20 74 68 65 20 6b 65 79 20 2a 2f 0a 7d of the key */.}
f960: 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 ;../*.** An inst
f970: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
f980: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
f990: 68 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f holds informatio
f9a0: 6e 20 61 62 6f 75 74 20 61 0a 2a 2a 20 73 69 6e n about a.** sin
f9b0: 67 6c 65 20 69 6e 64 65 78 20 72 65 63 6f 72 64 gle index record
f9c0: 20 74 68 61 74 20 68 61 73 20 61 6c 72 65 61 64 that has alread
f9d0: 79 20 62 65 65 6e 20 70 61 72 73 65 64 20 6f 75 y been parsed ou
f9e0: 74 20 69 6e 74 6f 20 69 6e 64 69 76 69 64 75 61 t into individua
f9f0: 6c 0a 2a 2a 20 76 61 6c 75 65 73 2e 0a 2a 2a 0a l.** values..**.
fa00: 2a 2a 20 41 20 72 65 63 6f 72 64 20 69 73 20 61 ** A record is a
fa10: 6e 20 6f 62 6a 65 63 74 20 74 68 61 74 20 63 6f n object that co
fa20: 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f ntains one or mo
fa30: 72 65 20 66 69 65 6c 64 73 20 6f 66 20 64 61 74 re fields of dat
fa40: 61 2e 0a 2a 2a 20 52 65 63 6f 72 64 73 20 61 72 a..** Records ar
fa50: 65 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 e used to store
fa60: 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 the content of a
fa70: 20 74 61 62 6c 65 20 72 6f 77 20 61 6e 64 20 74 table row and t
fa80: 6f 20 73 74 6f 72 65 0a 2a 2a 20 74 68 65 20 6b o store.** the k
fa90: 65 79 20 6f 66 20 61 6e 20 69 6e 64 65 78 2e 20 ey of an index.
faa0: 20 41 20 62 6c 6f 62 20 65 6e 63 6f 64 69 6e 67 A blob encoding
fab0: 20 6f 66 20 61 20 72 65 63 6f 72 64 20 69 73 20 of a record is
fac0: 63 72 65 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 created by.** th
fad0: 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 e OP_MakeRecord
fae0: 6f 70 63 6f 64 65 20 6f 66 20 74 68 65 20 56 44 opcode of the VD
faf0: 42 45 20 61 6e 64 20 69 73 20 64 69 73 61 73 73 BE and is disass
fb00: 65 6d 62 6c 65 64 20 62 79 20 74 68 65 0a 2a 2a embled by the.**
fb10: 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 70 63 6f 64 OP_Column opcod
fb20: 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74 e..**.** This st
fb30: 72 75 63 74 75 72 65 20 68 6f 6c 64 73 20 61 20 ructure holds a
fb40: 72 65 63 6f 72 64 20 74 68 61 74 20 68 61 73 20 record that has
fb50: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 64 69 73 already been dis
fb60: 61 73 73 65 6d 62 6c 65 64 0a 2a 2a 20 69 6e 74 assembled.** int
fb70: 6f 20 69 74 73 20 63 6f 6e 73 74 69 74 75 65 6e o its constituen
fb80: 74 20 66 69 65 6c 64 73 2e 0a 2a 2f 0a 73 74 72 t fields..*/.str
fb90: 75 63 74 20 55 6e 70 61 63 6b 65 64 52 65 63 6f uct UnpackedReco
fba0: 72 64 20 7b 0a 20 20 4b 65 79 49 6e 66 6f 20 2a rd {. KeyInfo *
fbb0: 70 4b 65 79 49 6e 66 6f 3b 20 20 2f 2a 20 43 6f pKeyInfo; /* Co
fbc0: 6c 6c 61 74 69 6f 6e 20 61 6e 64 20 73 6f 72 74 llation and sort
fbd0: 2d 6f 72 64 65 72 20 69 6e 66 6f 72 6d 61 74 69 -order informati
fbe0: 6f 6e 20 2a 2f 0a 20 20 75 31 36 20 6e 46 69 65 on */. u16 nFie
fbf0: 6c 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ld; /* N
fc00: 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 umber of entries
fc10: 20 69 6e 20 61 70 4d 65 6d 5b 5d 20 2a 2f 0a 20 in apMem[] */.
fc20: 20 75 38 20 66 6c 61 67 73 3b 20 20 20 20 20 20 u8 flags;
fc30: 20 20 20 20 20 2f 2a 20 42 6f 6f 6c 65 61 6e 20 /* Boolean
fc40: 73 65 74 74 69 6e 67 73 2e 20 20 55 4e 50 41 43 settings. UNPAC
fc50: 4b 45 44 5f 2e 2e 2e 20 62 65 6c 6f 77 20 2a 2f KED_... below */
fc60: 0a 20 20 4d 65 6d 20 2a 61 4d 65 6d 3b 20 20 20 . Mem *aMem;
fc70: 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 73 /* Values
fc80: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c */.};../*.** Al
fc90: 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 6f 66 20 lowed values of
fca0: 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2e 66 UnpackedRecord.f
fcb0: 6c 61 67 73 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 lags.*/.#define
fcc0: 55 4e 50 41 43 4b 45 44 5f 49 4e 43 52 4b 45 59 UNPACKED_INCRKEY
fcd0: 20 20 20 20 20 20 20 30 78 30 31 20 20 2f 2a 20 0x01 /*
fce0: 4d 61 6b 65 20 74 68 69 73 20 6b 65 79 20 61 6e Make this key an
fcf0: 20 65 70 73 69 6c 6f 6e 20 6c 61 72 67 65 72 20 epsilon larger
fd00: 2a 2f 0a 23 64 65 66 69 6e 65 20 55 4e 50 41 43 */.#define UNPAC
fd10: 4b 45 44 5f 50 52 45 46 49 58 5f 4d 41 54 43 48 KED_PREFIX_MATCH
fd20: 20 20 30 78 30 32 20 20 2f 2a 20 41 20 70 72 65 0x02 /* A pre
fd30: 66 69 78 20 6d 61 74 63 68 20 69 73 20 63 6f 6e fix match is con
fd40: 73 69 64 65 72 65 64 20 4f 4b 20 2a 2f 0a 0a 2f sidered OK */../
fd50: 2a 0a 2a 2a 20 45 61 63 68 20 53 51 4c 20 69 6e *.** Each SQL in
fd60: 64 65 78 20 69 73 20 72 65 70 72 65 73 65 6e 74 dex is represent
fd70: 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 62 79 20 ed in memory by
fd80: 61 6e 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f an.** instance o
fd90: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
fda0: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a structure..**.**
fdb0: 20 54 68 65 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 The columns of
fdc0: 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 61 the table that a
fdd0: 72 65 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 re to be indexed
fde0: 20 61 72 65 20 64 65 73 63 72 69 62 65 64 0a 2a are described.*
fdf0: 2a 20 62 79 20 74 68 65 20 61 69 43 6f 6c 75 6d * by the aiColum
fe00: 6e 5b 5d 20 66 69 65 6c 64 20 6f 66 20 74 68 69 n[] field of thi
fe10: 73 20 73 74 72 75 63 74 75 72 65 2e 20 20 46 6f s structure. Fo
fe20: 72 20 65 78 61 6d 70 6c 65 2c 20 73 75 70 70 6f r example, suppo
fe30: 73 65 0a 2a 2a 20 77 65 20 68 61 76 65 20 74 68 se.** we have th
fe40: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c e following tabl
fe50: 65 20 61 6e 64 20 69 6e 64 65 78 3a 0a 2a 2a 0a e and index:.**.
fe60: 2a 2a 20 20 20 20 20 43 52 45 41 54 45 20 54 41 ** CREATE TA
fe70: 42 4c 45 20 45 78 31 28 63 31 20 69 6e 74 2c 20 BLE Ex1(c1 int,
fe80: 63 32 20 69 6e 74 2c 20 63 33 20 74 65 78 74 29 c2 int, c3 text)
fe90: 3b 0a 2a 2a 20 20 20 20 20 43 52 45 41 54 45 20 ;.** CREATE
fea0: 49 4e 44 45 58 20 45 78 32 20 4f 4e 20 45 78 31 INDEX Ex2 ON Ex1
feb0: 28 63 33 2c 63 31 29 3b 0a 2a 2a 0a 2a 2a 20 49 (c3,c1);.**.** I
fec0: 6e 20 74 68 65 20 54 61 62 6c 65 20 73 74 72 75 n the Table stru
fed0: 63 74 75 72 65 20 64 65 73 63 72 69 62 69 6e 67 cture describing
fee0: 20 45 78 31 2c 20 6e 43 6f 6c 3d 3d 33 20 62 65 Ex1, nCol==3 be
fef0: 63 61 75 73 65 20 74 68 65 72 65 20 61 72 65 0a cause there are.
ff00: 2a 2a 20 74 68 72 65 65 20 63 6f 6c 75 6d 6e 73 ** three columns
ff10: 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e 20 20 in the table.
ff20: 49 6e 20 74 68 65 20 49 6e 64 65 78 20 73 74 72 In the Index str
ff30: 75 63 74 75 72 65 20 64 65 73 63 72 69 62 69 6e ucture describin
ff40: 67 0a 2a 2a 20 45 78 32 2c 20 6e 43 6f 6c 75 6d g.** Ex2, nColum
ff50: 6e 3d 3d 32 20 73 69 6e 63 65 20 32 20 6f 66 20 n==2 since 2 of
ff60: 74 68 65 20 33 20 63 6f 6c 75 6d 6e 73 20 6f 66 the 3 columns of
ff70: 20 45 78 31 20 61 72 65 20 69 6e 64 65 78 65 64 Ex1 are indexed
ff80: 2e 0a 2a 2a 20 54 68 65 20 76 61 6c 75 65 20 6f ..** The value o
ff90: 66 20 61 69 43 6f 6c 75 6d 6e 20 69 73 20 7b 32 f aiColumn is {2
ffa0: 2c 20 30 7d 2e 20 20 61 69 43 6f 6c 75 6d 6e 5b , 0}. aiColumn[
ffb0: 30 5d 3d 3d 32 20 62 65 63 61 75 73 65 20 74 68 0]==2 because th
ffc0: 65 20 0a 2a 2a 20 66 69 72 73 74 20 63 6f 6c 75 e .** first colu
ffd0: 6d 6e 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 mn to be indexed
ffe0: 20 28 63 33 29 20 68 61 73 20 61 6e 20 69 6e 64 (c3) has an ind
fff0: 65 78 20 6f 66 20 32 20 69 6e 20 45 78 31 2e 61 ex of 2 in Ex1.a
10000 43 6f 6c 5b 5d 2e 0a 2a 2a 20 54 68 65 20 73 65 Col[]..** The se
10010 63 6f 6e 64 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 cond column to b
10020 65 20 69 6e 64 65 78 65 64 20 28 63 31 29 20 68 e indexed (c1) h
10030 61 73 20 61 6e 20 69 6e 64 65 78 20 6f 66 20 30 as an index of 0
10040 20 69 6e 0a 2a 2a 20 45 78 31 2e 61 43 6f 6c 5b in.** Ex1.aCol[
10050 5d 2c 20 68 65 6e 63 65 20 45 78 32 2e 61 69 43 ], hence Ex2.aiC
10060 6f 6c 75 6d 6e 5b 31 5d 3d 3d 30 2e 0a 2a 2a 0a olumn[1]==0..**.
10070 2a 2a 20 54 68 65 20 49 6e 64 65 78 2e 6f 6e 45 ** The Index.onE
10080 72 72 6f 72 20 66 69 65 6c 64 20 64 65 74 65 72 rror field deter
10090 6d 69 6e 65 73 20 77 68 65 74 68 65 72 20 6f 72 mines whether or
100a0 20 6e 6f 74 20 74 68 65 20 69 6e 64 65 78 65 64 not the indexed
100b0 20 63 6f 6c 75 6d 6e 73 0a 2a 2a 20 6d 75 73 74 columns.** must
100c0 20 62 65 20 75 6e 69 71 75 65 20 61 6e 64 20 77 be unique and w
100d0 68 61 74 20 74 6f 20 64 6f 20 69 66 20 74 68 65 hat to do if the
100e0 79 20 61 72 65 20 6e 6f 74 2e 20 20 57 68 65 6e y are not. When
100f0 20 49 6e 64 65 78 2e 6f 6e 45 72 72 6f 72 3d 4f Index.onError=O
10100 45 5f 4e 6f 6e 65 2c 0a 2a 2a 20 69 74 20 6d 65 E_None,.** it me
10110 61 6e 73 20 74 68 69 73 20 69 73 20 6e 6f 74 20 ans this is not
10120 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 a unique index.
10130 20 4f 74 68 65 72 77 69 73 65 20 69 74 20 69 73 Otherwise it is
10140 20 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 0a a unique index.
10150 2a 2a 20 61 6e 64 20 74 68 65 20 76 61 6c 75 65 ** and the value
10160 20 6f 66 20 49 6e 64 65 78 2e 6f 6e 45 72 72 6f of Index.onErro
10170 72 20 69 6e 64 69 63 61 74 65 20 74 68 65 20 77 r indicate the w
10180 68 69 63 68 20 63 6f 6e 66 6c 69 63 74 20 72 65 hich conflict re
10190 73 6f 6c 75 74 69 6f 6e 20 0a 2a 2a 20 61 6c 67 solution .** alg
101a0 6f 72 69 74 68 6d 20 74 6f 20 65 6d 70 6c 6f 79 orithm to employ
101b0 20 77 68 65 6e 65 76 65 72 20 61 6e 20 61 74 74 whenever an att
101c0 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 empt is made to
101d0 69 6e 73 65 72 74 20 61 20 6e 6f 6e 2d 75 6e 69 insert a non-uni
101e0 71 75 65 0a 2a 2a 20 65 6c 65 6d 65 6e 74 2e 0a que.** element..
101f0 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 78 20 */.struct Index
10200 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b {. char *zName;
10210 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
10220 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 69 6e 64 Name of this ind
10230 65 78 20 2a 2f 0a 20 20 69 31 36 20 2a 61 69 43 ex */. i16 *aiC
10240 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
10250 20 2f 2a 20 57 68 69 63 68 20 63 6f 6c 75 6d 6e /* Which column
10260 73 20 61 72 65 20 75 73 65 64 20 62 79 20 74 68 s are used by th
10270 69 73 20 69 6e 64 65 78 2e 20 20 31 73 74 20 69 is index. 1st i
10280 73 20 30 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 s 0 */. tRowcnt
10290 20 2a 61 69 52 6f 77 45 73 74 3b 20 20 20 20 20 *aiRowEst;
102a0 20 20 2f 2a 20 46 72 6f 6d 20 41 4e 41 4c 59 5a /* From ANALYZ
102b0 45 3a 20 45 73 74 2e 20 72 6f 77 73 20 73 65 6c E: Est. rows sel
102c0 65 63 74 65 64 20 62 79 20 65 61 63 68 20 63 6f ected by each co
102d0 6c 75 6d 6e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 lumn */. Table
102e0 2a 70 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 *pTable;
102f0 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 74 61 /* The SQL ta
10300 62 6c 65 20 62 65 69 6e 67 20 69 6e 64 65 78 65 ble being indexe
10310 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f d */. char *zCo
10320 6c 41 66 66 3b 20 20 20 20 20 20 20 20 20 20 20 lAff;
10330 2f 2a 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 /* String defini
10340 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 ng the affinity
10350 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a of each column *
10360 2f 0a 20 20 49 6e 64 65 78 20 2a 70 4e 65 78 74 /. Index *pNext
10370 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
10380 54 68 65 20 6e 65 78 74 20 69 6e 64 65 78 20 61 The next index a
10390 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
103a0 68 65 20 73 61 6d 65 20 74 61 62 6c 65 20 2a 2f he same table */
103b0 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 . Schema *pSche
103c0 6d 61 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 ma; /* S
103d0 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 chema containing
103e0 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a 20 this index */.
103f0 20 75 38 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b u8 *aSortOrder;
10400 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 6f 72 /* for
10410 20 65 61 63 68 20 63 6f 6c 75 6d 6e 3a 20 54 72 each column: Tr
10420 75 65 3d 3d 44 45 53 43 2c 20 46 61 6c 73 65 3d ue==DESC, False=
10430 3d 41 53 43 20 2a 2f 0a 20 20 63 68 61 72 20 2a =ASC */. char *
10440 2a 61 7a 43 6f 6c 6c 3b 20 20 20 20 20 20 20 20 *azColl;
10450 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 63 /* Array of c
10460 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 ollation sequenc
10470 65 20 6e 61 6d 65 73 20 66 6f 72 20 69 6e 64 65 e names for inde
10480 78 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 50 61 x */. Expr *pPa
10490 72 74 49 64 78 57 68 65 72 65 3b 20 20 20 20 20 rtIdxWhere;
104a0 2f 2a 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 /* WHERE clause
104b0 66 6f 72 20 70 61 72 74 69 61 6c 20 69 6e 64 69 for partial indi
104c0 63 65 73 20 2a 2f 0a 20 20 4b 65 79 49 6e 66 6f ces */. KeyInfo
104d0 20 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 20 20 20 *pKeyInfo;
104e0 20 20 2f 2a 20 41 20 4b 65 79 49 6e 66 6f 20 6f /* A KeyInfo o
104f0 62 6a 65 63 74 20 73 75 69 74 61 62 6c 65 20 66 bject suitable f
10500 6f 72 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f or this index */
10510 0a 20 20 69 6e 74 20 74 6e 75 6d 3b 20 20 20 20 . int tnum;
10520 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
10530 42 20 50 61 67 65 20 63 6f 6e 74 61 69 6e 69 6e B Page containin
10540 67 20 72 6f 6f 74 20 6f 66 20 74 68 69 73 20 69 g root of this i
10550 6e 64 65 78 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 ndex */. LogEst
10560 20 73 7a 49 64 78 52 6f 77 3b 20 20 20 20 20 20 szIdxRow;
10570 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 /* Estimated
10580 61 76 65 72 61 67 65 20 72 6f 77 20 73 69 7a 65 average row size
10590 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 in bytes */. u
105a0 31 36 20 6e 4b 65 79 43 6f 6c 3b 20 20 20 20 20 16 nKeyCol;
105b0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
105c0 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 66 6f 72 r of columns for
105d0 6d 69 6e 67 20 74 68 65 20 6b 65 79 20 2a 2f 0a ming the key */.
105e0 20 20 75 31 36 20 6e 43 6f 6c 75 6d 6e 3b 20 20 u16 nColumn;
105f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
10600 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
10610 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 69 6e stored in the in
10620 64 65 78 20 2a 2f 0a 20 20 75 38 20 6f 6e 45 72 dex */. u8 onEr
10630 72 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 ror;
10640 20 20 2f 2a 20 4f 45 5f 41 62 6f 72 74 2c 20 4f /* OE_Abort, O
10650 45 5f 49 67 6e 6f 72 65 2c 20 4f 45 5f 52 65 70 E_Ignore, OE_Rep
10660 6c 61 63 65 2c 20 6f 72 20 4f 45 5f 4e 6f 6e 65 lace, or OE_None
10670 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 61 */. unsigned a
10680 75 74 6f 49 6e 64 65 78 3a 32 3b 20 20 20 20 2f utoIndex:2; /
10690 2a 20 31 3d 3d 55 4e 49 51 55 45 2c 20 32 3d 3d * 1==UNIQUE, 2==
106a0 50 52 49 4d 41 52 59 20 4b 45 59 2c 20 30 3d 3d PRIMARY KEY, 0==
106b0 43 52 45 41 54 45 20 49 4e 44 45 58 20 2a 2f 0a CREATE INDEX */.
106c0 20 20 75 6e 73 69 67 6e 65 64 20 62 55 6e 6f 72 unsigned bUnor
106d0 64 65 72 65 64 3a 31 3b 20 20 20 2f 2a 20 55 73 dered:1; /* Us
106e0 65 20 74 68 69 73 20 69 6e 64 65 78 20 66 6f 72 e this index for
106f0 20 3d 3d 20 6f 72 20 49 4e 20 71 75 65 72 69 65 == or IN querie
10700 73 20 6f 6e 6c 79 20 2a 2f 0a 20 20 75 6e 73 69 s only */. unsi
10710 67 6e 65 64 20 75 6e 69 71 4e 6f 74 4e 75 6c 6c gned uniqNotNull
10720 3a 31 3b 20 20 2f 2a 20 54 72 75 65 20 69 66 20 :1; /* True if
10730 55 4e 49 51 55 45 20 61 6e 64 20 4e 4f 54 20 4e UNIQUE and NOT N
10740 55 4c 4c 20 66 6f 72 20 61 6c 6c 20 63 6f 6c 75 ULL for all colu
10750 6d 6e 73 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 mns */. unsigne
10760 64 20 69 73 52 65 73 69 7a 65 64 3a 31 3b 20 20 d isResized:1;
10770 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 65 73 /* True if res
10780 69 7a 65 49 6e 64 65 78 4f 62 6a 65 63 74 28 29 izeIndexObject()
10790 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c 65 64 has been called
107a0 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 */. unsigned i
107b0 73 43 6f 76 65 72 69 6e 67 3a 31 3b 20 20 20 2f sCovering:1; /
107c0 2a 20 54 72 75 65 20 69 66 20 74 68 69 73 20 69 * True if this i
107d0 73 20 61 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 s a covering ind
107e0 65 78 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c ex */.#ifdef SQL
107f0 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 ITE_ENABLE_STAT3
10800 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 6e 74 20 _OR_STAT4. int
10810 6e 53 61 6d 70 6c 65 3b 20 20 20 20 20 20 20 20 nSample;
10820 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
10830 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e 20 61 53 f elements in aS
10840 61 6d 70 6c 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 ample[] */. int
10850 20 6e 53 61 6d 70 6c 65 43 6f 6c 3b 20 20 20 20 nSampleCol;
10860 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
10870 20 49 6e 64 65 78 53 61 6d 70 6c 65 2e 61 6e 45 IndexSample.anE
10880 71 5b 5d 20 61 6e 64 20 73 6f 20 6f 6e 20 2a 2f q[] and so on */
10890 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 41 76 67 . tRowcnt *aAvg
108a0 45 71 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 Eq; /* A
108b0 76 65 72 61 67 65 20 6e 45 71 20 76 61 6c 75 65 verage nEq value
108c0 73 20 66 6f 72 20 6b 65 79 73 20 6e 6f 74 20 69 s for keys not i
108d0 6e 20 61 53 61 6d 70 6c 65 20 2a 2f 0a 20 20 49 n aSample */. I
108e0 6e 64 65 78 53 61 6d 70 6c 65 20 2a 61 53 61 6d ndexSample *aSam
108f0 70 6c 65 3b 20 20 20 20 2f 2a 20 53 61 6d 70 6c ple; /* Sampl
10900 65 73 20 6f 66 20 74 68 65 20 6c 65 66 74 2d 6d es of the left-m
10910 6f 73 74 20 6b 65 79 20 2a 2f 0a 23 65 6e 64 69 ost key */.#endi
10920 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 f.};../*.** Each
10930 20 73 61 6d 70 6c 65 20 73 74 6f 72 65 64 20 69 sample stored i
10940 6e 20 74 68 65 20 73 71 6c 69 74 65 5f 73 74 61 n the sqlite_sta
10950 74 33 20 74 61 62 6c 65 20 69 73 20 72 65 70 72 t3 table is repr
10960 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 6d 6f 72 esented in memor
10970 79 20 0a 2a 2a 20 75 73 69 6e 67 20 61 20 73 74 y .** using a st
10980 72 75 63 74 75 72 65 20 6f 66 20 74 68 69 73 20 ructure of this
10990 74 79 70 65 2e 20 20 53 65 65 20 64 6f 63 75 6d type. See docum
109a0 65 6e 74 61 74 69 6f 6e 20 61 74 20 74 68 65 20 entation at the
109b0 74 6f 70 20 6f 66 20 74 68 65 0a 2a 2a 20 61 6e top of the.** an
109c0 61 6c 79 7a 65 2e 63 20 73 6f 75 72 63 65 20 66 alyze.c source f
109d0 69 6c 65 20 66 6f 72 20 61 64 64 69 74 69 6f 6e ile for addition
109e0 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a al information..
109f0 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 78 53 */.struct IndexS
10a00 61 6d 70 6c 65 20 7b 0a 20 20 76 6f 69 64 20 2a ample {. void *
10a10 70 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 p; /* P
10a20 6f 69 6e 74 65 72 20 74 6f 20 73 61 6d 70 6c 65 ointer to sample
10a30 64 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 69 6e d record */. in
10a40 74 20 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 t n;
10a50 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65 63 6f 72 /* Size of recor
10a60 64 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 d in bytes */.
10a70 74 52 6f 77 63 6e 74 20 2a 61 6e 45 71 3b 20 20 tRowcnt *anEq;
10a80 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 65 72 /* Est. number
10a90 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 20 74 of rows where t
10aa0 68 65 20 6b 65 79 20 65 71 75 61 6c 73 20 74 68 he key equals th
10ab0 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 20 20 74 is sample */. t
10ac0 52 6f 77 63 6e 74 20 2a 61 6e 4c 74 3b 20 20 20 Rowcnt *anLt;
10ad0 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 65 72 20 /* Est. number
10ae0 6f 66 20 72 6f 77 73 20 77 68 65 72 65 20 6b 65 of rows where ke
10af0 79 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 74 y is less than t
10b00 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 20 20 his sample */.
10b10 74 52 6f 77 63 6e 74 20 2a 61 6e 44 4c 74 3b 20 tRowcnt *anDLt;
10b20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 65 72 /* Est. number
10b30 20 6f 66 20 64 69 73 74 69 6e 63 74 20 6b 65 79 of distinct key
10b40 73 20 6c 65 73 73 20 74 68 61 6e 20 74 68 69 73 s less than this
10b50 20 73 61 6d 70 6c 65 20 2a 2f 0a 7d 3b 0a 0a 2f sample */.};../
10b60 2a 0a 2a 2a 20 45 61 63 68 20 74 6f 6b 65 6e 20 *.** Each token
10b70 63 6f 6d 69 6e 67 20 6f 75 74 20 6f 66 20 74 68 coming out of th
10b80 65 20 6c 65 78 65 72 20 69 73 20 61 6e 20 69 6e e lexer is an in
10b90 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74 68 69 stance of.** thi
10ba0 73 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 6f s structure. To
10bb0 6b 65 6e 73 20 61 72 65 20 61 6c 73 6f 20 75 73 kens are also us
10bc0 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 61 6e ed as part of an
10bd0 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2a 2a 0a expression..**.
10be0 2a 2a 20 4e 6f 74 65 20 69 66 20 54 6f 6b 65 6e ** Note if Token
10bf0 2e 7a 3d 3d 30 20 74 68 65 6e 20 54 6f 6b 65 6e .z==0 then Token
10c00 2e 64 79 6e 20 61 6e 64 20 54 6f 6b 65 6e 2e 6e .dyn and Token.n
10c10 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 20 61 are undefined a
10c20 6e 64 0a 2a 2a 20 6d 61 79 20 63 6f 6e 74 61 69 nd.** may contai
10c30 6e 20 72 61 6e 64 6f 6d 20 76 61 6c 75 65 73 2e n random values.
10c40 20 20 44 6f 20 6e 6f 74 20 6d 61 6b 65 20 61 6e Do not make an
10c50 79 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 61 62 y assumptions ab
10c60 6f 75 74 20 54 6f 6b 65 6e 2e 64 79 6e 0a 2a 2a out Token.dyn.**
10c70 20 61 6e 64 20 54 6f 6b 65 6e 2e 6e 20 77 68 65 and Token.n whe
10c80 6e 20 54 6f 6b 65 6e 2e 7a 3d 3d 30 2e 0a 2a 2f n Token.z==0..*/
10c90 0a 73 74 72 75 63 74 20 54 6f 6b 65 6e 20 7b 0a .struct Token {.
10ca0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 3b const char *z;
10cb0 20 20 20 20 20 2f 2a 20 54 65 78 74 20 6f 66 20 /* Text of
10cc0 74 68 65 20 74 6f 6b 65 6e 2e 20 20 4e 6f 74 20 the token. Not
10cd0 4e 55 4c 4c 2d 74 65 72 6d 69 6e 61 74 65 64 21 NULL-terminated!
10ce0 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 */. unsigned i
10cf0 6e 74 20 6e 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 nt n; /* Numb
10d00 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 72 73 er of characters
10d10 20 69 6e 20 74 68 69 73 20 74 6f 6b 65 6e 20 2a in this token *
10d20 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 /.};../*.** An i
10d30 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 nstance of this
10d40 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 structure contai
10d50 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6e ns information n
10d60 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 61 74 eeded to generat
10d70 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 61 20 e.** code for a
10d80 53 45 4c 45 43 54 20 74 68 61 74 20 63 6f 6e 74 SELECT that cont
10d90 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 ains aggregate f
10da0 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 unctions..**.**
10db0 49 66 20 45 78 70 72 2e 6f 70 3d 3d 54 4b 5f 41 If Expr.op==TK_A
10dc0 47 47 5f 43 4f 4c 55 4d 4e 20 6f 72 20 54 4b 5f GG_COLUMN or TK_
10dd0 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 74 68 65 AGG_FUNCTION the
10de0 6e 20 45 78 70 72 2e 70 41 67 67 49 6e 66 6f 20 n Expr.pAggInfo
10df0 69 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 is a.** pointer
10e00 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 75 72 to this structur
10e10 65 2e 20 20 54 68 65 20 45 78 70 72 2e 69 43 6f e. The Expr.iCo
10e20 6c 75 6d 6e 20 66 69 65 6c 64 20 69 73 20 74 68 lumn field is th
10e30 65 20 69 6e 64 65 78 20 69 6e 0a 2a 2a 20 41 67 e index in.** Ag
10e40 67 49 6e 66 6f 2e 61 43 6f 6c 5b 5d 20 6f 72 20 gInfo.aCol[] or
10e50 41 67 67 49 6e 66 6f 2e 61 46 75 6e 63 5b 5d 20 AggInfo.aFunc[]
10e60 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6e of information n
10e70 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 61 74 eeded to generat
10e80 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 74 68 e.** code for th
10e90 61 74 20 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 at node..**.** A
10ea0 67 67 49 6e 66 6f 2e 70 47 72 6f 75 70 42 79 20 ggInfo.pGroupBy
10eb0 61 6e 64 20 41 67 67 49 6e 66 6f 2e 61 46 75 6e and AggInfo.aFun
10ec0 63 2e 70 45 78 70 72 20 70 6f 69 6e 74 20 74 6f c.pExpr point to
10ed0 20 66 69 65 6c 64 73 20 77 69 74 68 69 6e 20 74 fields within t
10ee0 68 65 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c 20 53 he.** original S
10ef0 65 6c 65 63 74 20 73 74 72 75 63 74 75 72 65 20 elect structure
10f00 74 68 61 74 20 64 65 73 63 72 69 62 65 73 20 74 that describes t
10f10 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d he SELECT statem
10f20 65 6e 74 2e 20 20 54 68 65 73 65 0a 2a 2a 20 66 ent. These.** f
10f30 69 65 6c 64 73 20 64 6f 20 6e 6f 74 20 6e 65 65 ields do not nee
10f40 64 20 74 6f 20 62 65 20 66 72 65 65 64 20 77 68 d to be freed wh
10f50 65 6e 20 64 65 61 6c 6c 6f 63 61 74 69 6e 67 20 en deallocating
10f60 74 68 65 20 41 67 67 49 6e 66 6f 20 73 74 72 75 the AggInfo stru
10f70 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 cture..*/.struct
10f80 20 41 67 67 49 6e 66 6f 20 7b 0a 20 20 75 38 20 AggInfo {. u8
10f90 64 69 72 65 63 74 4d 6f 64 65 3b 20 20 20 20 20 directMode;
10fa0 20 20 20 20 20 2f 2a 20 44 69 72 65 63 74 20 72 /* Direct r
10fb0 65 6e 64 65 72 69 6e 67 20 6d 6f 64 65 20 6d 65 endering mode me
10fc0 61 6e 73 20 74 61 6b 65 20 64 61 74 61 20 64 69 ans take data di
10fd0 72 65 63 74 6c 79 0a 20 20 20 20 20 20 20 20 20 rectly.
10fe0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10ff0 20 2a 2a 20 66 72 6f 6d 20 73 6f 75 72 63 65 20 ** from source
11000 74 61 62 6c 65 73 20 72 61 74 68 65 72 20 74 68 tables rather th
11010 61 6e 20 66 72 6f 6d 20 61 63 63 75 6d 75 6c 61 an from accumula
11020 74 6f 72 73 20 2a 2f 0a 20 20 75 38 20 75 73 65 tors */. u8 use
11030 53 6f 72 74 69 6e 67 49 64 78 3b 20 20 20 20 20 SortingIdx;
11040 20 20 2f 2a 20 49 6e 20 64 69 72 65 63 74 20 6d /* In direct m
11050 6f 64 65 2c 20 72 65 66 65 72 65 6e 63 65 20 74 ode, reference t
11060 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 he sorting index
11070 20 72 61 74 68 65 72 0a 20 20 20 20 20 20 20 20 rather.
11080 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11090 20 20 2a 2a 20 74 68 61 6e 20 74 68 65 20 73 6f ** than the so
110a0 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 urce table */.
110b0 69 6e 74 20 73 6f 72 74 69 6e 67 49 64 78 3b 20 int sortingIdx;
110c0 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f /* Curso
110d0 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 r number of the
110e0 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 20 2a 2f sorting index */
110f0 0a 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 49 64 . int sortingId
11100 78 50 54 61 62 3b 20 20 20 20 20 2f 2a 20 43 75 xPTab; /* Cu
11110 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 70 rsor number of p
11120 73 65 75 64 6f 2d 74 61 62 6c 65 20 2a 2f 0a 20 seudo-table */.
11130 20 69 6e 74 20 6e 53 6f 72 74 69 6e 67 43 6f 6c int nSortingCol
11140 75 6d 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 6d 62 umn; /* Numb
11150 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e er of columns in
11160 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
11170 65 78 20 2a 2f 0a 20 20 69 6e 74 20 6d 6e 52 65 ex */. int mnRe
11180 67 2c 20 6d 78 52 65 67 3b 20 20 20 20 20 20 20 g, mxReg;
11190 2f 2a 20 52 61 6e 67 65 20 6f 66 20 72 65 67 69 /* Range of regi
111a0 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 65 64 20 sters allocated
111b0 66 6f 72 20 61 43 6f 6c 20 61 6e 64 20 61 46 75 for aCol and aFu
111c0 6e 63 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 nc */. ExprList
111d0 20 2a 70 47 72 6f 75 70 42 79 3b 20 20 20 20 20 *pGroupBy;
111e0 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 62 79 20 /* The group by
111f0 63 6c 61 75 73 65 20 2a 2f 0a 20 20 73 74 72 75 clause */. stru
11200 63 74 20 41 67 67 49 6e 66 6f 5f 63 6f 6c 20 7b ct AggInfo_col {
11210 20 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 /* For each
11220 63 6f 6c 75 6d 6e 20 75 73 65 64 20 69 6e 20 73 column used in s
11230 6f 75 72 63 65 20 74 61 62 6c 65 73 20 2a 2f 0a ource tables */.
11240 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b Table *pTab;
11250 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
11260 53 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a Source table */.
11270 20 20 20 20 69 6e 74 20 69 54 61 62 6c 65 3b 20 int iTable;
11280 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
11290 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 Cursor number of
112a0 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 62 6c the source tabl
112b0 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 43 6f e */. int iCo
112c0 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 lumn;
112d0 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 /* Column numb
112e0 65 72 20 77 69 74 68 69 6e 20 74 68 65 20 73 6f er within the so
112f0 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 urce table */.
11300 20 20 69 6e 74 20 69 53 6f 72 74 65 72 43 6f 6c int iSorterCol
11310 75 6d 6e 3b 20 20 20 20 20 20 20 2f 2a 20 43 6f umn; /* Co
11320 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 74 lumn number in t
11330 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 he sorting index
11340 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d 65 6d */. int iMem
11350 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
11360 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 74 /* Memory locat
11370 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 61 73 ion that acts as
11380 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f 0a accumulator */.
11390 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 72 3b Expr *pExpr;
113a0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
113b0 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 65 78 70 The original exp
113c0 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 7d 20 2a ression */. } *
113d0 61 43 6f 6c 3b 0a 20 20 69 6e 74 20 6e 43 6f 6c aCol;. int nCol
113e0 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 umn;
113f0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 65 /* Number of use
11400 64 20 65 6e 74 72 69 65 73 20 69 6e 20 61 43 6f d entries in aCo
11410 6c 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 63 l[] */. int nAc
11420 63 75 6d 75 6c 61 74 6f 72 3b 20 20 20 20 20 20 cumulator;
11430 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f /* Number of co
11440 6c 75 6d 6e 73 20 74 68 61 74 20 73 68 6f 77 20 lumns that show
11450 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 20 6f through to the o
11460 75 74 70 75 74 2e 0a 20 20 20 20 20 20 20 20 20 utput..
11470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11480 20 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c 20 63 ** Additional c
11490 6f 6c 75 6d 6e 73 20 61 72 65 20 75 73 65 64 20 olumns are used
114a0 6f 6e 6c 79 20 61 73 20 70 61 72 61 6d 65 74 65 only as paramete
114b0 72 73 20 74 6f 0a 20 20 20 20 20 20 20 20 20 20 rs to.
114c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
114d0 2a 2a 20 61 67 67 72 65 67 61 74 65 20 66 75 6e ** aggregate fun
114e0 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 74 72 75 ctions */. stru
114f0 63 74 20 41 67 67 49 6e 66 6f 5f 66 75 6e 63 20 ct AggInfo_func
11500 7b 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 68 20 { /* For each
11510 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
11520 6f 6e 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a on */. Expr *
11530 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 pExpr;
11540 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e /* Expression
11550 20 65 6e 63 6f 64 69 6e 67 20 74 68 65 20 66 75 encoding the fu
11560 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 46 75 nction */. Fu
11570 6e 63 44 65 66 20 2a 70 46 75 6e 63 3b 20 20 20 ncDef *pFunc;
11580 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 61 67 /* The ag
11590 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e gregate function
115a0 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
115b0 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d 65 6d 3b */. int iMem;
115c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
115d0 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 /* Memory locati
115e0 6f 6e 20 74 68 61 74 20 61 63 74 73 20 61 73 20 on that acts as
115f0 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f 0a 20 accumulator */.
11600 20 20 20 69 6e 74 20 69 44 69 73 74 69 6e 63 74 int iDistinct
11610 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 ; /* E
11620 70 68 65 6d 65 72 61 6c 20 74 61 62 6c 65 20 75 phemeral table u
11630 73 65 64 20 74 6f 20 65 6e 66 6f 72 63 65 20 44 sed to enforce D
11640 49 53 54 49 4e 43 54 20 2a 2f 0a 20 20 7d 20 2a ISTINCT */. } *
11650 61 46 75 6e 63 3b 0a 20 20 69 6e 74 20 6e 46 75 aFunc;. int nFu
11660 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nc;
11670 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e /* Number of en
11680 74 72 69 65 73 20 69 6e 20 61 46 75 6e 63 5b 5d tries in aFunc[]
11690 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 */.};../*.** Th
116a0 65 20 64 61 74 61 74 79 70 65 20 79 6e 56 61 72 e datatype ynVar
116b0 20 69 73 20 61 20 73 69 67 6e 65 64 20 69 6e 74 is a signed int
116c0 65 67 65 72 2c 20 65 69 74 68 65 72 20 31 36 2d eger, either 16-
116d0 62 69 74 20 6f 72 20 33 32 2d 62 69 74 2e 0a 2a bit or 32-bit..*
116e0 2a 20 55 73 75 61 6c 6c 79 20 69 74 20 69 73 20 * Usually it is
116f0 31 36 2d 62 69 74 73 2e 20 20 42 75 74 20 69 66 16-bits. But if
11700 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 SQLITE_MAX_VARI
11710 41 42 4c 45 5f 4e 55 4d 42 45 52 20 69 73 20 67 ABLE_NUMBER is g
11720 72 65 61 74 65 72 0a 2a 2a 20 74 68 61 6e 20 33 reater.** than 3
11730 32 37 36 37 20 77 65 20 68 61 76 65 20 74 6f 20 2767 we have to
11740 6d 61 6b 65 20 69 74 20 33 32 2d 62 69 74 2e 20 make it 32-bit.
11750 20 31 36 2d 62 69 74 20 69 73 20 70 72 65 66 65 16-bit is prefe
11760 72 72 65 64 20 62 65 63 61 75 73 65 0a 2a 2a 20 rred because.**
11770 69 74 20 75 73 65 73 20 6c 65 73 73 20 6d 65 6d it uses less mem
11780 6f 72 79 20 69 6e 20 74 68 65 20 45 78 70 72 20 ory in the Expr
11790 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 69 73 object, which is
117a0 20 61 20 62 69 67 20 6d 65 6d 6f 72 79 20 75 73 a big memory us
117b0 65 72 0a 2a 2a 20 69 6e 20 73 79 73 74 65 6d 73 er.** in systems
117c0 20 77 69 74 68 20 6c 6f 74 73 20 6f 66 20 70 72 with lots of pr
117d0 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 epared statement
117e0 73 2e 20 20 41 6e 64 20 66 65 77 20 61 70 70 6c s. And few appl
117f0 69 63 61 74 69 6f 6e 73 0a 2a 2a 20 6e 65 65 64 ications.** need
11800 20 6d 6f 72 65 20 74 68 61 6e 20 61 62 6f 75 74 more than about
11810 20 31 30 20 6f 72 20 32 30 20 76 61 72 69 61 62 10 or 20 variab
11820 6c 65 73 2e 20 20 42 75 74 20 73 6f 6d 65 20 65 les. But some e
11830 78 74 72 65 6d 65 20 75 73 65 72 73 20 77 61 6e xtreme users wan
11840 74 0a 2a 2a 20 74 6f 20 68 61 76 65 20 70 72 65 t.** to have pre
11850 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 pared statements
11860 20 77 69 74 68 20 6f 76 65 72 20 33 32 37 36 37 with over 32767
11870 20 76 61 72 69 61 62 6c 65 73 2c 20 61 6e 64 20 variables, and
11880 66 6f 72 20 74 68 65 6d 0a 2a 2a 20 74 68 65 20 for them.** the
11890 6f 70 74 69 6f 6e 20 69 73 20 61 76 61 69 6c 61 option is availa
118a0 62 6c 65 20 28 61 74 20 63 6f 6d 70 69 6c 65 2d ble (at compile-
118b0 74 69 6d 65 29 2e 0a 2a 2f 0a 23 69 66 20 53 51 time)..*/.#if SQ
118c0 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 42 4c LITE_MAX_VARIABL
118d0 45 5f 4e 55 4d 42 45 52 3c 3d 33 32 37 36 37 0a E_NUMBER<=32767.
118e0 74 79 70 65 64 65 66 20 69 31 36 20 79 6e 56 61 typedef i16 ynVa
118f0 72 3b 0a 23 65 6c 73 65 0a 74 79 70 65 64 65 66 r;.#else.typedef
11900 20 69 6e 74 20 79 6e 56 61 72 3b 0a 23 65 6e 64 int ynVar;.#end
11910 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 6e if../*.** Each n
11920 6f 64 65 20 6f 66 20 61 6e 20 65 78 70 72 65 73 ode of an expres
11930 73 69 6f 6e 20 69 6e 20 74 68 65 20 70 61 72 73 sion in the pars
11940 65 20 74 72 65 65 20 69 73 20 61 6e 20 69 6e 73 e tree is an ins
11950 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 69 73 tance.** of this
11960 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a structure..**.*
11970 2a 20 45 78 70 72 2e 6f 70 20 69 73 20 74 68 65 * Expr.op is the
11980 20 6f 70 63 6f 64 65 2e 20 54 68 65 20 69 6e 74 opcode. The int
11990 65 67 65 72 20 70 61 72 73 65 72 20 74 6f 6b 65 eger parser toke
119a0 6e 20 63 6f 64 65 73 20 61 72 65 20 72 65 75 73 n codes are reus
119b0 65 64 0a 2a 2a 20 61 73 20 6f 70 63 6f 64 65 73 ed.** as opcodes
119c0 20 68 65 72 65 2e 20 46 6f 72 20 65 78 61 6d 70 here. For examp
119d0 6c 65 2c 20 74 68 65 20 70 61 72 73 65 72 20 64 le, the parser d
119e0 65 66 69 6e 65 73 20 54 4b 5f 47 45 20 74 6f 20 efines TK_GE to
119f0 62 65 20 61 6e 20 69 6e 74 65 67 65 72 0a 2a 2a be an integer.**
11a00 20 63 6f 64 65 20 72 65 70 72 65 73 65 6e 74 69 code representi
11a10 6e 67 20 74 68 65 20 22 3e 3d 22 20 6f 70 65 72 ng the ">=" oper
11a20 61 74 6f 72 2e 20 54 68 69 73 20 73 61 6d 65 20 ator. This same
11a30 69 6e 74 65 67 65 72 20 63 6f 64 65 20 69 73 20 integer code is
11a40 72 65 75 73 65 64 0a 2a 2a 20 74 6f 20 72 65 70 reused.** to rep
11a50 72 65 73 65 6e 74 20 74 68 65 20 67 72 65 61 74 resent the great
11a60 65 72 2d 74 68 61 6e 2d 6f 72 2d 65 71 75 61 6c er-than-or-equal
11a70 2d 74 6f 20 6f 70 65 72 61 74 6f 72 20 69 6e 20 -to operator in
11a80 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 0a 2a the expression.*
11a90 2a 20 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 * tree..**.** If
11aa0 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 the expression
11ab0 69 73 20 61 6e 20 53 51 4c 20 6c 69 74 65 72 61 is an SQL litera
11ac0 6c 20 28 54 4b 5f 49 4e 54 45 47 45 52 2c 20 54 l (TK_INTEGER, T
11ad0 4b 5f 46 4c 4f 41 54 2c 20 54 4b 5f 42 4c 4f 42 K_FLOAT, TK_BLOB
11ae0 2c 20 0a 2a 2a 20 6f 72 20 54 4b 5f 53 54 52 49 , .** or TK_STRI
11af0 4e 47 29 2c 20 74 68 65 6e 20 45 78 70 72 2e 74 NG), then Expr.t
11b00 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 oken contains th
11b10 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 53 51 e text of the SQ
11b20 4c 20 6c 69 74 65 72 61 6c 2e 20 49 66 0a 2a 2a L literal. If.**
11b30 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 the expression
11b40 69 73 20 61 20 76 61 72 69 61 62 6c 65 20 28 54 is a variable (T
11b50 4b 5f 56 41 52 49 41 42 4c 45 29 2c 20 74 68 65 K_VARIABLE), the
11b60 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e n Expr.token con
11b70 74 61 69 6e 73 20 74 68 65 20 0a 2a 2a 20 76 61 tains the .** va
11b80 72 69 61 62 6c 65 20 6e 61 6d 65 2e 20 46 69 6e riable name. Fin
11b90 61 6c 6c 79 2c 20 69 66 20 74 68 65 20 65 78 70 ally, if the exp
11ba0 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 ression is an SQ
11bb0 4c 20 66 75 6e 63 74 69 6f 6e 20 28 54 4b 5f 46 L function (TK_F
11bc0 55 4e 43 54 49 4f 4e 29 2c 0a 2a 2a 20 74 68 65 UNCTION),.** the
11bd0 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e n Expr.token con
11be0 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 20 6f tains the name o
11bf0 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 0a f the function..
11c00 2a 2a 0a 2a 2a 20 45 78 70 72 2e 70 52 69 67 68 **.** Expr.pRigh
11c10 74 20 61 6e 64 20 45 78 70 72 2e 70 4c 65 66 74 t and Expr.pLeft
11c20 20 61 72 65 20 74 68 65 20 6c 65 66 74 20 61 6e are the left an
11c30 64 20 72 69 67 68 74 20 73 75 62 65 78 70 72 65 d right subexpre
11c40 73 73 69 6f 6e 73 20 6f 66 20 61 0a 2a 2a 20 62 ssions of a.** b
11c50 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 2e 20 inary operator.
11c60 45 69 74 68 65 72 20 6f 72 20 62 6f 74 68 20 6d Either or both m
11c70 61 79 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a ay be NULL..**.*
11c80 2a 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 69 * Expr.x.pList i
11c90 73 20 61 20 6c 69 73 74 20 6f 66 20 61 72 67 75 s a list of argu
11ca0 6d 65 6e 74 73 20 69 66 20 74 68 65 20 65 78 70 ments if the exp
11cb0 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 ression is an SQ
11cc0 4c 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a 20 61 L function,.** a
11cd0 20 43 41 53 45 20 65 78 70 72 65 73 73 69 6f 6e CASE expression
11ce0 20 6f 72 20 61 6e 20 49 4e 20 65 78 70 72 65 73 or an IN expres
11cf0 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d sion of the form
11d00 20 22 3c 6c 68 73 3e 20 49 4e 20 28 3c 79 3e 2c "<lhs> IN (<y>,
11d10 20 3c 7a 3e 2e 2e 2e 29 22 2e 0a 2a 2a 20 45 78 <z>...)"..** Ex
11d20 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 73 20 pr.x.pSelect is
11d30 75 73 65 64 20 69 66 20 74 68 65 20 65 78 70 72 used if the expr
11d40 65 73 73 69 6f 6e 20 69 73 20 61 20 73 75 62 2d ession is a sub-
11d50 73 65 6c 65 63 74 20 6f 72 20 61 6e 20 65 78 70 select or an exp
11d60 72 65 73 73 69 6f 6e 20 6f 66 0a 2a 2a 20 74 68 ression of.** th
11d70 65 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 49 4e e form "<lhs> IN
11d80 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 2e 20 (SELECT ...)".
11d90 49 66 20 74 68 65 20 45 50 5f 78 49 73 53 65 6c If the EP_xIsSel
11da0 65 63 74 20 62 69 74 20 69 73 20 73 65 74 20 69 ect bit is set i
11db0 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e 66 6c n the.** Expr.fl
11dc0 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 45 ags mask, then E
11dd0 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 73 xpr.x.pSelect is
11de0 20 76 61 6c 69 64 2e 20 4f 74 68 65 72 77 69 73 valid. Otherwis
11df0 65 2c 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 e, Expr.x.pList
11e00 69 73 20 0a 2a 2a 20 76 61 6c 69 64 2e 0a 2a 2a is .** valid..**
11e10 0a 2a 2a 20 41 6e 20 65 78 70 72 65 73 73 69 6f .** An expressio
11e20 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 49 44 n of the form ID
11e30 20 6f 72 20 49 44 2e 49 44 20 72 65 66 65 72 73 or ID.ID refers
11e40 20 74 6f 20 61 20 63 6f 6c 75 6d 6e 20 69 6e 20 to a column in
11e50 61 20 74 61 62 6c 65 2e 0a 2a 2a 20 46 6f 72 20 a table..** For
11e60 73 75 63 68 20 65 78 70 72 65 73 73 69 6f 6e 73 such expressions
11e70 2c 20 45 78 70 72 2e 6f 70 20 69 73 20 73 65 74 , Expr.op is set
11e80 20 74 6f 20 54 4b 5f 43 4f 4c 55 4d 4e 20 61 6e to TK_COLUMN an
11e90 64 20 45 78 70 72 2e 69 54 61 62 6c 65 20 69 73 d Expr.iTable is
11ea0 0a 2a 2a 20 74 68 65 20 69 6e 74 65 67 65 72 20 .** the integer
11eb0 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 cursor number of
11ec0 20 61 20 56 44 42 45 20 63 75 72 73 6f 72 20 70 a VDBE cursor p
11ed0 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 61 74 20 ointing to that
11ee0 74 61 62 6c 65 20 61 6e 64 0a 2a 2a 20 45 78 70 table and.** Exp
11ef0 72 2e 69 43 6f 6c 75 6d 6e 20 69 73 20 74 68 65 r.iColumn is the
11f00 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 66 column number f
11f10 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 63 20 or the specific
11f20 63 6f 6c 75 6d 6e 2e 20 20 49 66 20 74 68 65 0a column. If the.
11f30 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 ** expression is
11f40 20 75 73 65 64 20 61 73 20 61 20 72 65 73 75 6c used as a resul
11f50 74 20 69 6e 20 61 6e 20 61 67 67 72 65 67 61 74 t in an aggregat
11f60 65 20 53 45 4c 45 43 54 2c 20 74 68 65 6e 20 74 e SELECT, then t
11f70 68 65 0a 2a 2a 20 76 61 6c 75 65 20 69 73 20 61 he.** value is a
11f80 6c 73 6f 20 73 74 6f 72 65 64 20 69 6e 20 74 68 lso stored in th
11f90 65 20 45 78 70 72 2e 69 41 67 67 20 63 6f 6c 75 e Expr.iAgg colu
11fa0 6d 6e 20 69 6e 20 74 68 65 20 61 67 67 72 65 67 mn in the aggreg
11fb0 61 74 65 20 73 6f 20 74 68 61 74 0a 2a 2a 20 69 ate so that.** i
11fc0 74 20 63 61 6e 20 62 65 20 61 63 63 65 73 73 65 t can be accesse
11fd0 64 20 61 66 74 65 72 20 61 6c 6c 20 61 67 67 72 d after all aggr
11fe0 65 67 61 74 65 73 20 61 72 65 20 63 6f 6d 70 75 egates are compu
11ff0 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ted..**.** If th
12000 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 e expression is
12010 61 6e 20 75 6e 62 6f 75 6e 64 20 76 61 72 69 61 an unbound varia
12020 62 6c 65 20 6d 61 72 6b 65 72 20 28 61 20 71 75 ble marker (a qu
12030 65 73 74 69 6f 6e 20 6d 61 72 6b 20 0a 2a 2a 20 estion mark .**
12040 63 68 61 72 61 63 74 65 72 20 27 3f 27 20 69 6e character '?' in
12050 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 the original SQ
12060 4c 29 20 74 68 65 6e 20 74 68 65 20 45 78 70 72 L) then the Expr
12070 2e 69 54 61 62 6c 65 20 68 6f 6c 64 73 20 74 68 .iTable holds th
12080 65 20 69 6e 64 65 78 20 0a 2a 2a 20 6e 75 6d 62 e index .** numb
12090 65 72 20 66 6f 72 20 74 68 61 74 20 76 61 72 69 er for that vari
120a0 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 able..**.** If t
120b0 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 he expression is
120c0 20 61 20 73 75 62 71 75 65 72 79 20 74 68 65 6e a subquery then
120d0 20 45 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 68 6f Expr.iColumn ho
120e0 6c 64 73 20 61 6e 20 69 6e 74 65 67 65 72 0a 2a lds an integer.*
120f0 2a 20 72 65 67 69 73 74 65 72 20 6e 75 6d 62 65 * register numbe
12100 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 r containing the
12110 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 73 result of the s
12120 75 62 71 75 65 72 79 2e 20 20 49 66 20 74 68 65 ubquery. If the
12130 0a 2a 2a 20 73 75 62 71 75 65 72 79 20 67 69 76 .** subquery giv
12140 65 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 72 65 es a constant re
12150 73 75 6c 74 2c 20 74 68 65 6e 20 69 54 61 62 6c sult, then iTabl
12160 65 20 69 73 20 2d 31 2e 20 20 49 66 20 74 68 65 e is -1. If the
12170 20 73 75 62 71 75 65 72 79 0a 2a 2a 20 67 69 76 subquery.** giv
12180 65 73 20 61 20 64 69 66 66 65 72 65 6e 74 20 61 es a different a
12190 6e 73 77 65 72 20 61 74 20 64 69 66 66 65 72 65 nswer at differe
121a0 6e 74 20 74 69 6d 65 73 20 64 75 72 69 6e 67 20 nt times during
121b0 73 74 61 74 65 6d 65 6e 74 20 70 72 6f 63 65 73 statement proces
121c0 73 69 6e 67 0a 2a 2a 20 74 68 65 6e 20 69 54 61 sing.** then iTa
121d0 62 6c 65 20 69 73 20 74 68 65 20 61 64 64 72 65 ble is the addre
121e0 73 73 20 6f 66 20 61 20 73 75 62 72 6f 75 74 69 ss of a subrouti
121f0 6e 65 20 74 68 61 74 20 63 6f 6d 70 75 74 65 73 ne that computes
12200 20 74 68 65 20 73 75 62 71 75 65 72 79 2e 0a 2a the subquery..*
12210 2a 0a 2a 2a 20 49 66 20 74 68 65 20 45 78 70 72 *.** If the Expr
12220 20 69 73 20 6f 66 20 74 79 70 65 20 4f 50 5f 43 is of type OP_C
12230 6f 6c 75 6d 6e 2c 20 61 6e 64 20 74 68 65 20 74 olumn, and the t
12240 61 62 6c 65 20 69 74 20 69 73 20 73 65 6c 65 63 able it is selec
12250 74 69 6e 67 20 66 72 6f 6d 0a 2a 2a 20 69 73 20 ting from.** is
12260 61 20 64 69 73 6b 20 74 61 62 6c 65 20 6f 72 20 a disk table or
12270 74 68 65 20 22 6f 6c 64 2e 2a 22 20 70 73 65 75 the "old.*" pseu
12280 64 6f 2d 74 61 62 6c 65 2c 20 74 68 65 6e 20 70 do-table, then p
12290 54 61 62 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 Tab points to th
122a0 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 e.** correspondi
122b0 6e 67 20 74 61 62 6c 65 20 64 65 66 69 6e 69 74 ng table definit
122c0 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 4c 4c 4f 43 ion..**.** ALLOC
122d0 41 54 49 4f 4e 20 4e 4f 54 45 53 3a 0a 2a 2a 0a ATION NOTES:.**.
122e0 2a 2a 20 45 78 70 72 20 6f 62 6a 65 63 74 73 20 ** Expr objects
122f0 63 61 6e 20 75 73 65 20 61 20 6c 6f 74 20 6f 66 can use a lot of
12300 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 69 6e memory space in
12310 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
12320 2e 20 20 54 6f 0a 2a 2a 20 68 65 6c 70 20 72 65 . To.** help re
12330 64 75 63 65 20 6d 65 6d 6f 72 79 20 72 65 71 75 duce memory requ
12340 69 72 65 6d 65 6e 74 73 2c 20 73 6f 6d 65 74 69 irements, someti
12350 6d 65 73 20 61 6e 20 45 78 70 72 20 6f 62 6a 65 mes an Expr obje
12360 63 74 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 74 72 ct will be.** tr
12370 75 6e 63 61 74 65 64 2e 20 20 41 6e 64 20 74 6f uncated. And to
12380 20 72 65 64 75 63 65 20 74 68 65 20 6e 75 6d 62 reduce the numb
12390 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20 61 6c 6c er of memory all
123a0 6f 63 61 74 69 6f 6e 73 2c 20 73 6f 6d 65 74 69 ocations, someti
123b0 6d 65 73 0a 2a 2a 20 74 77 6f 20 6f 72 20 6d 6f mes.** two or mo
123c0 72 65 20 45 78 70 72 20 6f 62 6a 65 63 74 73 20 re Expr objects
123d0 77 69 6c 6c 20 62 65 20 73 74 6f 72 65 64 20 69 will be stored i
123e0 6e 20 61 20 73 69 6e 67 6c 65 20 6d 65 6d 6f 72 n a single memor
123f0 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 0a 2a 2a y allocation,.**
12400 20 74 6f 67 65 74 68 65 72 20 77 69 74 68 20 45 together with E
12410 78 70 72 2e 7a 54 6f 6b 65 6e 20 73 74 72 69 6e xpr.zToken strin
12420 67 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 gs..**.** If the
12430 20 45 50 5f 52 65 64 75 63 65 64 20 61 6e 64 20 EP_Reduced and
12440 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 EP_TokenOnly fla
12450 67 73 20 61 72 65 20 73 65 74 20 77 68 65 6e 0a gs are set when.
12460 2a 2a 20 61 6e 20 45 78 70 72 20 6f 62 6a 65 63 ** an Expr objec
12470 74 20 69 73 20 74 72 75 6e 63 61 74 65 64 2e 20 t is truncated.
12480 20 57 68 65 6e 20 45 50 5f 52 65 64 75 63 65 64 When EP_Reduced
12490 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 61 6c is set, then al
124a0 6c 0a 2a 2a 20 74 68 65 20 63 68 69 6c 64 20 45 l.** the child E
124b0 78 70 72 20 6f 62 6a 65 63 74 73 20 69 6e 20 74 xpr objects in t
124c0 68 65 20 45 78 70 72 2e 70 4c 65 66 74 20 61 6e he Expr.pLeft an
124d0 64 20 45 78 70 72 2e 70 52 69 67 68 74 20 73 75 d Expr.pRight su
124e0 62 74 72 65 65 73 0a 2a 2a 20 61 72 65 20 63 6f btrees.** are co
124f0 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e 20 74 ntained within t
12500 68 65 20 73 61 6d 65 20 6d 65 6d 6f 72 79 20 61 he same memory a
12510 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 4e 6f 74 65 llocation. Note
12520 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 61 74 0a , however, that.
12530 2a 2a 20 74 68 65 20 73 75 62 74 72 65 65 73 20 ** the subtrees
12540 69 6e 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 20 in Expr.x.pList
12550 6f 72 20 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 or Expr.x.pSelec
12560 74 20 61 72 65 20 61 6c 77 61 79 73 20 73 65 70 t are always sep
12570 61 72 61 74 65 6c 79 0a 2a 2a 20 61 6c 6c 6f 63 arately.** alloc
12580 61 74 65 64 2c 20 72 65 67 61 72 64 6c 65 73 73 ated, regardless
12590 20 6f 66 20 77 68 65 74 68 65 72 20 6f 72 20 6e of whether or n
125a0 6f 74 20 45 50 5f 52 65 64 75 63 65 64 20 69 73 ot EP_Reduced is
125b0 20 73 65 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 set..*/.struct
125c0 45 78 70 72 20 7b 0a 20 20 75 38 20 6f 70 3b 20 Expr {. u8 op;
125d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
125e0 2f 2a 20 4f 70 65 72 61 74 69 6f 6e 20 70 65 72 /* Operation per
125f0 66 6f 72 6d 65 64 20 62 79 20 74 68 69 73 20 6e formed by this n
12600 6f 64 65 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 ode */. char af
12610 66 69 6e 69 74 79 3b 20 20 20 20 20 20 20 20 20 finity;
12620 2f 2a 20 54 68 65 20 61 66 66 69 6e 69 74 79 20 /* The affinity
12630 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6f 72 of the column or
12640 20 30 20 69 66 20 6e 6f 74 20 61 20 63 6f 6c 75 0 if not a colu
12650 6d 6e 20 2a 2f 0a 20 20 75 33 32 20 66 6c 61 67 mn */. u32 flag
12660 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f s; /
12670 2a 20 56 61 72 69 6f 75 73 20 66 6c 61 67 73 2e * Various flags.
12680 20 20 45 50 5f 2a 20 53 65 65 20 62 65 6c 6f 77 EP_* See below
12690 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 */. union {.
126a0 20 20 63 68 61 72 20 2a 7a 54 6f 6b 65 6e 3b 20 char *zToken;
126b0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 /* Toke
126c0 6e 20 76 61 6c 75 65 2e 20 5a 65 72 6f 20 74 65 n value. Zero te
126d0 72 6d 69 6e 61 74 65 64 20 61 6e 64 20 64 65 71 rminated and deq
126e0 75 6f 74 65 64 20 2a 2f 0a 20 20 20 20 69 6e 74 uoted */. int
126f0 20 69 56 61 6c 75 65 3b 20 20 20 20 20 20 20 20 iValue;
12700 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6e 65 67 61 74 /* Non-negat
12710 69 76 65 20 69 6e 74 65 67 65 72 20 76 61 6c 75 ive integer valu
12720 65 20 69 66 20 45 50 5f 49 6e 74 56 61 6c 75 65 e if EP_IntValue
12730 20 2a 2f 0a 20 20 7d 20 75 3b 0a 0a 20 20 2f 2a */. } u;.. /*
12740 20 49 66 20 74 68 65 20 45 50 5f 54 6f 6b 65 6e If the EP_Token
12750 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 73 65 74 Only flag is set
12760 20 69 6e 20 74 68 65 20 45 78 70 72 2e 66 6c 61 in the Expr.fla
12770 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 6e 6f gs mask, then no
12780 0a 20 20 2a 2a 20 73 70 61 63 65 20 69 73 20 61 . ** space is a
12790 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 llocated for the
127a0 20 66 69 65 6c 64 73 20 62 65 6c 6f 77 20 74 68 fields below th
127b0 69 73 20 70 6f 69 6e 74 2e 20 41 6e 20 61 74 74 is point. An att
127c0 65 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 61 63 63 empt to. ** acc
127d0 65 73 73 20 74 68 65 6d 20 77 69 6c 6c 20 72 65 ess them will re
127e0 73 75 6c 74 20 69 6e 20 61 20 73 65 67 66 61 75 sult in a segfau
127f0 6c 74 20 6f 72 20 6d 61 6c 66 75 6e 63 74 69 6f lt or malfunctio
12800 6e 2e 20 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a n. . **********
12810 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12820 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12830 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12840 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 ***********/..
12850 45 78 70 72 20 2a 70 4c 65 66 74 3b 20 20 20 20 Expr *pLeft;
12860 20 20 20 20 20 20 20 2f 2a 20 4c 65 66 74 20 73 /* Left s
12870 75 62 6e 6f 64 65 20 2a 2f 0a 20 20 45 78 70 72 ubnode */. Expr
12880 20 2a 70 52 69 67 68 74 3b 20 20 20 20 20 20 20 *pRight;
12890 20 20 20 2f 2a 20 52 69 67 68 74 20 73 75 62 6e /* Right subn
128a0 6f 64 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b ode */. union {
128b0 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 2a 70 . ExprList *p
128c0 4c 69 73 74 3b 20 20 20 20 20 2f 2a 20 6f 70 20 List; /* op
128d0 3d 20 49 4e 2c 20 45 58 49 53 54 53 2c 20 53 45 = IN, EXISTS, SE
128e0 4c 45 43 54 2c 20 43 41 53 45 2c 20 46 55 4e 43 LECT, CASE, FUNC
128f0 54 49 4f 4e 2c 20 42 45 54 57 45 45 4e 20 2a 2f TION, BETWEEN */
12900 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65 . Select *pSe
12910 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 45 50 5f lect; /* EP_
12920 78 49 73 53 65 6c 65 63 74 20 61 6e 64 20 6f 70 xIsSelect and op
12930 20 3d 20 49 4e 2c 20 45 58 49 53 54 53 2c 20 53 = IN, EXISTS, S
12940 45 4c 45 43 54 20 2a 2f 0a 20 20 7d 20 78 3b 0a ELECT */. } x;.
12950 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 45 50 5f . /* If the EP_
12960 52 65 64 75 63 65 64 20 66 6c 61 67 20 69 73 20 Reduced flag is
12970 73 65 74 20 69 6e 20 74 68 65 20 45 78 70 72 2e set in the Expr.
12980 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e flags mask, then
12990 20 6e 6f 0a 20 20 2a 2a 20 73 70 61 63 65 20 69 no. ** space i
129a0 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 s allocated for
129b0 74 68 65 20 66 69 65 6c 64 73 20 62 65 6c 6f 77 the fields below
129c0 20 74 68 69 73 20 70 6f 69 6e 74 2e 20 41 6e 20 this point. An
129d0 61 74 74 65 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 attempt to. **
129e0 61 63 63 65 73 73 20 74 68 65 6d 20 77 69 6c 6c access them will
129f0 20 72 65 73 75 6c 74 20 69 6e 20 61 20 73 65 67 result in a seg
12a00 66 61 75 6c 74 20 6f 72 20 6d 61 6c 66 75 6e 63 fault or malfunc
12a10 74 69 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a tion.. ********
12a20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12a30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12a40 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12a50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a *************/..
12a60 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 45 #if SQLITE_MAX_E
12a70 58 50 52 5f 44 45 50 54 48 3e 30 0a 20 20 69 6e XPR_DEPTH>0. in
12a80 74 20 6e 48 65 69 67 68 74 3b 20 20 20 20 20 20 t nHeight;
12a90 20 20 20 20 20 2f 2a 20 48 65 69 67 68 74 20 6f /* Height o
12aa0 66 20 74 68 65 20 74 72 65 65 20 68 65 61 64 65 f the tree heade
12ab0 64 20 62 79 20 74 68 69 73 20 6e 6f 64 65 20 2a d by this node *
12ac0 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e 74 20 69 /.#endif. int i
12ad0 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 Table;
12ae0 20 20 2f 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 /* TK_COLUMN:
12af0 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 cursor number of
12b00 20 74 61 62 6c 65 20 68 6f 6c 64 69 6e 67 20 63 table holding c
12b10 6f 6c 75 6d 6e 0a 20 20 20 20 20 20 20 20 20 20 olumn.
12b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
12b30 2a 20 54 4b 5f 52 45 47 49 53 54 45 52 3a 20 72 * TK_REGISTER: r
12b40 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 0a 20 egister number.
12b50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12b60 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f 54 52 ** TK_TR
12b70 49 47 47 45 52 3a 20 31 20 2d 3e 20 6e 65 77 2c IGGER: 1 -> new,
12b80 20 30 20 2d 3e 20 6f 6c 64 0a 20 20 20 20 20 20 0 -> old.
12b90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12ba0 20 20 20 2a 2a 20 45 50 5f 55 6e 6c 69 6b 65 6c ** EP_Unlikel
12bb0 79 3a 20 20 31 30 30 30 20 74 69 6d 65 73 20 6c y: 1000 times l
12bc0 69 6b 65 6c 69 68 6f 6f 64 20 2a 2f 0a 20 20 79 ikelihood */. y
12bd0 6e 56 61 72 20 69 43 6f 6c 75 6d 6e 3b 20 20 20 nVar iColumn;
12be0 20 20 20 20 20 20 2f 2a 20 54 4b 5f 43 4f 4c 55 /* TK_COLU
12bf0 4d 4e 3a 20 63 6f 6c 75 6d 6e 20 69 6e 64 65 78 MN: column index
12c00 2e 20 20 2d 31 20 66 6f 72 20 72 6f 77 69 64 2e . -1 for rowid.
12c10 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
12c20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f ** TK_
12c30 56 41 52 49 41 42 4c 45 3a 20 76 61 72 69 61 62 VARIABLE: variab
12c40 6c 65 20 6e 75 6d 62 65 72 20 28 61 6c 77 61 79 le number (alway
12c50 73 20 3e 3d 20 31 29 2e 20 2a 2f 0a 20 20 69 31 s >= 1). */. i1
12c60 36 20 69 41 67 67 3b 20 20 20 20 20 20 20 20 20 6 iAgg;
12c70 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 65 6e /* Which en
12c80 74 72 79 20 69 6e 20 70 41 67 67 49 6e 66 6f 2d try in pAggInfo-
12c90 3e 61 43 6f 6c 5b 5d 20 6f 72 20 2d 3e 61 46 75 >aCol[] or ->aFu
12ca0 6e 63 5b 5d 20 2a 2f 0a 20 20 69 31 36 20 69 52 nc[] */. i16 iR
12cb0 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 3b 20 20 ightJoinTable;
12cc0 20 2f 2a 20 49 66 20 45 50 5f 46 72 6f 6d 4a 6f /* If EP_FromJo
12cd0 69 6e 2c 20 74 68 65 20 72 69 67 68 74 20 74 61 in, the right ta
12ce0 62 6c 65 20 6f 66 20 74 68 65 20 6a 6f 69 6e 20 ble of the join
12cf0 2a 2f 0a 20 20 75 38 20 6f 70 32 3b 20 20 20 20 */. u8 op2;
12d00 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
12d10 4b 5f 52 45 47 49 53 54 45 52 3a 20 6f 72 69 67 K_REGISTER: orig
12d20 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 45 78 inal value of Ex
12d30 70 72 2e 6f 70 0a 20 20 20 20 20 20 20 20 20 20 pr.op.
12d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
12d50 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 74 68 65 * TK_COLUMN: the
12d60 20 76 61 6c 75 65 20 6f 66 20 70 35 20 66 6f 72 value of p5 for
12d70 20 4f 50 5f 43 6f 6c 75 6d 6e 0a 20 20 20 20 20 OP_Column.
12d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12d90 20 20 20 20 2a 2a 20 54 4b 5f 41 47 47 5f 46 55 ** TK_AGG_FU
12da0 4e 43 54 49 4f 4e 3a 20 6e 65 73 74 69 6e 67 20 NCTION: nesting
12db0 64 65 70 74 68 20 2a 2f 0a 20 20 41 67 67 49 6e depth */. AggIn
12dc0 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 20 20 fo *pAggInfo;
12dd0 20 20 2f 2a 20 55 73 65 64 20 62 79 20 54 4b 5f /* Used by TK_
12de0 41 47 47 5f 43 4f 4c 55 4d 4e 20 61 6e 64 20 54 AGG_COLUMN and T
12df0 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 2a K_AGG_FUNCTION *
12e00 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b /. Table *pTab;
12e10 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 /* Ta
12e20 62 6c 65 20 66 6f 72 20 54 4b 5f 43 4f 4c 55 4d ble for TK_COLUM
12e30 4e 20 65 78 70 72 65 73 73 69 6f 6e 73 2e 20 2a N expressions. *
12e40 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 /.};../*.** The
12e50 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 68 following are th
12e60 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 20 62 69 e meanings of bi
12e70 74 73 20 69 6e 20 74 68 65 20 45 78 70 72 2e 66 ts in the Expr.f
12e80 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 lags field..*/.#
12e90 64 65 66 69 6e 65 20 45 50 5f 46 72 6f 6d 4a 6f define EP_FromJo
12ea0 69 6e 20 20 30 78 30 30 30 30 30 31 20 2f 2a 20 in 0x000001 /*
12eb0 4f 72 69 67 69 6e 61 74 65 64 20 69 6e 20 4f 4e Originated in ON
12ec0 20 6f 72 20 55 53 49 4e 47 20 63 6c 61 75 73 65 or USING clause
12ed0 20 6f 66 20 61 20 6a 6f 69 6e 20 2a 2f 0a 23 64 of a join */.#d
12ee0 65 66 69 6e 65 20 45 50 5f 41 67 67 20 20 20 20 efine EP_Agg
12ef0 20 20 20 30 78 30 30 30 30 30 32 20 2f 2a 20 43 0x000002 /* C
12f00 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d ontains one or m
12f10 6f 72 65 20 61 67 67 72 65 67 61 74 65 20 66 75 ore aggregate fu
12f20 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 nctions */.#defi
12f30 6e 65 20 45 50 5f 52 65 73 6f 6c 76 65 64 20 20 ne EP_Resolved
12f40 30 78 30 30 30 30 30 34 20 2f 2a 20 49 44 73 20 0x000004 /* IDs
12f50 68 61 76 65 20 62 65 65 6e 20 72 65 73 6f 6c 76 have been resolv
12f60 65 64 20 74 6f 20 43 4f 4c 55 4d 4e 73 20 2a 2f ed to COLUMNs */
12f70 0a 23 64 65 66 69 6e 65 20 45 50 5f 45 72 72 6f .#define EP_Erro
12f80 72 20 20 20 20 20 30 78 30 30 30 30 30 38 20 2f r 0x000008 /
12f90 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 63 6f 6e * Expression con
12fa0 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 tains one or mor
12fb0 65 20 65 72 72 6f 72 73 20 2a 2f 0a 23 64 65 66 e errors */.#def
12fc0 69 6e 65 20 45 50 5f 44 69 73 74 69 6e 63 74 20 ine EP_Distinct
12fd0 20 30 78 30 30 30 30 31 30 20 2f 2a 20 41 67 67 0x000010 /* Agg
12fe0 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 20 regate function
12ff0 77 69 74 68 20 44 49 53 54 49 4e 43 54 20 6b 65 with DISTINCT ke
13000 79 77 6f 72 64 20 2a 2f 0a 23 64 65 66 69 6e 65 yword */.#define
13010 20 45 50 5f 56 61 72 53 65 6c 65 63 74 20 30 78 EP_VarSelect 0x
13020 30 30 30 30 32 30 20 2f 2a 20 70 53 65 6c 65 63 000020 /* pSelec
13030 74 20 69 73 20 63 6f 72 72 65 6c 61 74 65 64 2c t is correlated,
13040 20 6e 6f 74 20 63 6f 6e 73 74 61 6e 74 20 2a 2f not constant */
13050 0a 23 64 65 66 69 6e 65 20 45 50 5f 44 62 6c 51 .#define EP_DblQ
13060 75 6f 74 65 64 20 30 78 30 30 30 30 34 30 20 2f uoted 0x000040 /
13070 2a 20 74 6f 6b 65 6e 2e 7a 20 77 61 73 20 6f 72 * token.z was or
13080 69 67 69 6e 61 6c 6c 79 20 69 6e 20 22 2e 2e 2e iginally in "...
13090 22 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f " */.#define EP_
130a0 49 6e 66 69 78 46 75 6e 63 20 30 78 30 30 30 30 InfixFunc 0x0000
130b0 38 30 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 61 80 /* True for a
130c0 6e 20 69 6e 66 69 78 20 66 75 6e 63 74 69 6f 6e n infix function
130d0 3a 20 4c 49 4b 45 2c 20 47 4c 4f 42 2c 20 65 74 : LIKE, GLOB, et
130e0 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f c */.#define EP_
130f0 43 6f 6c 6c 61 74 65 20 20 20 30 78 30 30 30 31 Collate 0x0001
13100 30 30 20 2f 2a 20 54 72 65 65 20 63 6f 6e 74 61 00 /* Tree conta
13110 69 6e 73 20 61 20 54 4b 5f 43 4f 4c 4c 41 54 45 ins a TK_COLLATE
13120 20 6f 70 65 61 72 74 6f 72 20 2a 2f 0a 20 20 20 opeartor */.
13130 20 20 20 2f 2a 20 75 6e 75 73 65 64 20 20 20 20 /* unused
13140 20 20 30 78 30 30 30 32 30 30 20 2a 2f 0a 23 64 0x000200 */.#d
13150 65 66 69 6e 65 20 45 50 5f 49 6e 74 56 61 6c 75 efine EP_IntValu
13160 65 20 20 30 78 30 30 30 34 30 30 20 2f 2a 20 49 e 0x000400 /* I
13170 6e 74 65 67 65 72 20 76 61 6c 75 65 20 63 6f 6e nteger value con
13180 74 61 69 6e 65 64 20 69 6e 20 75 2e 69 56 61 6c tained in u.iVal
13190 75 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 ue */.#define EP
131a0 5f 78 49 73 53 65 6c 65 63 74 20 30 78 30 30 30 _xIsSelect 0x000
131b0 38 30 30 20 2f 2a 20 78 2e 70 53 65 6c 65 63 74 800 /* x.pSelect
131c0 20 69 73 20 76 61 6c 69 64 20 28 6f 74 68 65 72 is valid (other
131d0 77 69 73 65 20 78 2e 70 4c 69 73 74 20 69 73 29 wise x.pList is)
131e0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 53 */.#define EP_S
131f0 6b 69 70 20 20 20 20 20 20 30 78 30 30 31 30 30 kip 0x00100
13200 30 20 2f 2a 20 43 4f 4c 4c 41 54 45 2c 20 41 53 0 /* COLLATE, AS
13210 2c 20 6f 72 20 55 4e 4c 49 4b 45 4c 59 20 2a 2f , or UNLIKELY */
13220 0a 23 64 65 66 69 6e 65 20 45 50 5f 52 65 64 75 .#define EP_Redu
13230 63 65 64 20 20 20 30 78 30 30 32 30 30 30 20 2f ced 0x002000 /
13240 2a 20 45 78 70 72 20 73 74 72 75 63 74 20 45 58 * Expr struct EX
13250 50 52 5f 52 45 44 55 43 45 44 53 49 5a 45 20 62 PR_REDUCEDSIZE b
13260 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 ytes only */.#de
13270 66 69 6e 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c fine EP_TokenOnl
13280 79 20 30 78 30 30 34 30 30 30 20 2f 2a 20 45 78 y 0x004000 /* Ex
13290 70 72 20 73 74 72 75 63 74 20 45 58 50 52 5f 54 pr struct EXPR_T
132a0 4f 4b 45 4e 4f 4e 4c 59 53 49 5a 45 20 62 79 74 OKENONLYSIZE byt
132b0 65 73 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 es only */.#defi
132c0 6e 65 20 45 50 5f 53 74 61 74 69 63 20 20 20 20 ne EP_Static
132d0 30 78 30 30 38 30 30 30 20 2f 2a 20 48 65 6c 64 0x008000 /* Held
132e0 20 69 6e 20 6d 65 6d 6f 72 79 20 6e 6f 74 20 6f in memory not o
132f0 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 6d 61 6c btained from mal
13300 6c 6f 63 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 loc() */.#define
13310 20 45 50 5f 4d 65 6d 54 6f 6b 65 6e 20 20 30 78 EP_MemToken 0x
13320 30 31 30 30 30 30 20 2f 2a 20 4e 65 65 64 20 74 010000 /* Need t
13330 6f 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 o sqlite3DbFree(
13340 29 20 45 78 70 72 2e 7a 54 6f 6b 65 6e 20 2a 2f ) Expr.zToken */
13350 0a 23 64 65 66 69 6e 65 20 45 50 5f 4e 6f 52 65 .#define EP_NoRe
13360 64 75 63 65 20 20 30 78 30 32 30 30 30 30 20 2f duce 0x020000 /
13370 2a 20 43 61 6e 6e 6f 74 20 45 58 50 52 44 55 50 * Cannot EXPRDUP
13380 5f 52 45 44 55 43 45 20 74 68 69 73 20 45 78 70 _REDUCE this Exp
13390 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f r */.#define EP_
133a0 55 6e 6c 69 6b 65 6c 79 20 20 30 78 30 34 30 30 Unlikely 0x0400
133b0 30 30 20 2f 2a 20 75 6e 6c 69 6b 65 6c 79 28 29 00 /* unlikely()
133c0 20 6f 72 20 6c 69 6b 65 6c 69 68 6f 6f 64 28 29 or likelihood()
133d0 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 function */.#de
133e0 66 69 6e 65 20 45 50 5f 43 6f 6e 73 74 61 6e 74 fine EP_Constant
133f0 20 20 30 78 30 38 30 30 30 30 20 2f 2a 20 4e 6f 0x080000 /* No
13400 64 65 20 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 de is a constant
13410 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 */../*.** These
13420 20 6d 61 63 72 6f 73 20 63 61 6e 20 62 65 20 75 macros can be u
13430 73 65 64 20 74 6f 20 74 65 73 74 2c 20 73 65 74 sed to test, set
13440 2c 20 6f 72 20 63 6c 65 61 72 20 62 69 74 73 20 , or clear bits
13450 69 6e 20 74 68 65 20 0a 2a 2a 20 45 78 70 72 2e in the .** Expr.
13460 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a flags field..*/.
13470 23 64 65 66 69 6e 65 20 45 78 70 72 48 61 73 50 #define ExprHasP
13480 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 20 roperty(E,P)
13490 20 28 28 28 45 29 2d 3e 66 6c 61 67 73 26 28 50 (((E)->flags&(P
134a0 29 29 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 45 ))!=0).#define E
134b0 78 70 72 48 61 73 41 6c 6c 50 72 6f 70 65 72 74 xprHasAllPropert
134c0 79 28 45 2c 50 29 20 20 28 28 28 45 29 2d 3e 66 y(E,P) (((E)->f
134d0 6c 61 67 73 26 28 50 29 29 3d 3d 28 50 29 29 0a lags&(P))==(P)).
134e0 23 64 65 66 69 6e 65 20 45 78 70 72 53 65 74 50 #define ExprSetP
134f0 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 20 roperty(E,P)
13500 20 28 45 29 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 (E)->flags|=(P)
13510 0a 23 64 65 66 69 6e 65 20 45 78 70 72 43 6c 65 .#define ExprCle
13520 61 72 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 arProperty(E,P)
13530 20 20 28 45 29 2d 3e 66 6c 61 67 73 26 3d 7e 28 (E)->flags&=~(
13540 50 29 0a 0a 2f 2a 20 54 68 65 20 45 78 70 72 53 P)../* The ExprS
13550 65 74 56 56 41 50 72 6f 70 65 72 74 79 28 29 20 etVVAProperty()
13560 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 66 6f macro is used fo
13570 72 20 56 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 r Verification,
13580 56 61 6c 69 64 61 74 69 6f 6e 2c 0a 2a 2a 20 61 Validation,.** a
13590 6e 64 20 41 63 63 72 65 64 69 74 61 74 69 6f 6e nd Accreditation
135a0 20 6f 6e 6c 79 2e 20 20 49 74 20 77 6f 72 6b 73 only. It works
135b0 20 6c 69 6b 65 20 45 78 70 72 53 65 74 50 72 6f like ExprSetPro
135c0 70 65 72 74 79 28 29 20 64 75 72 69 6e 67 20 56 perty() during V
135d0 56 41 0a 2a 2a 20 70 72 6f 63 65 73 73 65 73 20 VA.** processes
135e0 62 75 74 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 but is a no-op f
135f0 6f 72 20 64 65 6c 69 76 65 72 79 2e 0a 2a 2f 0a or delivery..*/.
13600 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
13610 42 55 47 0a 23 20 64 65 66 69 6e 65 20 45 78 70 BUG.# define Exp
13620 72 53 65 74 56 56 41 50 72 6f 70 65 72 74 79 28 rSetVVAProperty(
13630 45 2c 50 29 20 20 28 45 29 2d 3e 66 6c 61 67 73 E,P) (E)->flags
13640 7c 3d 28 50 29 0a 23 65 6c 73 65 0a 23 20 64 65 |=(P).#else.# de
13650 66 69 6e 65 20 45 78 70 72 53 65 74 56 56 41 50 fine ExprSetVVAP
13660 72 6f 70 65 72 74 79 28 45 2c 50 29 0a 23 65 6e roperty(E,P).#en
13670 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f dif../*.** Macro
13680 73 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 s to determine t
13690 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 he number of byt
136a0 65 73 20 72 65 71 75 69 72 65 64 20 62 79 20 61 es required by a
136b0 20 6e 6f 72 6d 61 6c 20 45 78 70 72 20 0a 2a 2a normal Expr .**
136c0 20 73 74 72 75 63 74 2c 20 61 6e 20 45 78 70 72 struct, an Expr
136d0 20 73 74 72 75 63 74 20 77 69 74 68 20 74 68 65 struct with the
136e0 20 45 50 5f 52 65 64 75 63 65 64 20 66 6c 61 67 EP_Reduced flag
136f0 20 73 65 74 20 69 6e 20 45 78 70 72 2e 66 6c 61 set in Expr.fla
13700 67 73 20 0a 2a 2a 20 61 6e 64 20 61 6e 20 45 78 gs .** and an Ex
13710 70 72 20 73 74 72 75 63 74 20 77 69 74 68 20 74 pr struct with t
13720 68 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 he EP_TokenOnly
13730 66 6c 61 67 20 73 65 74 2e 0a 2a 2f 0a 23 64 65 flag set..*/.#de
13740 66 69 6e 65 20 45 58 50 52 5f 46 55 4c 4c 53 49 fine EXPR_FULLSI
13750 5a 45 20 20 20 20 20 20 20 20 20 20 20 73 69 7a ZE siz
13760 65 6f 66 28 45 78 70 72 29 20 20 20 20 20 20 20 eof(Expr)
13770 20 20 20 20 2f 2a 20 46 75 6c 6c 20 73 69 7a 65 /* Full size
13780 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 */.#define EXPR
13790 5f 52 45 44 55 43 45 44 53 49 5a 45 20 20 20 20 _REDUCEDSIZE
137a0 20 20 20 20 6f 66 66 73 65 74 6f 66 28 45 78 70 offsetof(Exp
137b0 72 2c 69 54 61 62 6c 65 29 20 20 2f 2a 20 43 6f r,iTable) /* Co
137c0 6d 6d 6f 6e 20 66 65 61 74 75 72 65 73 20 2a 2f mmon features */
137d0 0a 23 64 65 66 69 6e 65 20 45 58 50 52 5f 54 4f .#define EXPR_TO
137e0 4b 45 4e 4f 4e 4c 59 53 49 5a 45 20 20 20 20 20 KENONLYSIZE
137f0 20 6f 66 66 73 65 74 6f 66 28 45 78 70 72 2c 70 offsetof(Expr,p
13800 4c 65 66 74 29 20 20 20 2f 2a 20 46 65 77 65 72 Left) /* Fewer
13810 20 66 65 61 74 75 72 65 73 20 2a 2f 0a 0a 2f 2a features */../*
13820 0a 2a 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 .** Flags passed
13830 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 45 to the sqlite3E
13840 78 70 72 44 75 70 28 29 20 66 75 6e 63 74 69 6f xprDup() functio
13850 6e 2e 20 53 65 65 20 74 68 65 20 68 65 61 64 65 n. See the heade
13860 72 20 63 6f 6d 6d 65 6e 74 20 0a 2a 2a 20 61 62 r comment .** ab
13870 6f 76 65 20 73 71 6c 69 74 65 33 45 78 70 72 44 ove sqlite3ExprD
13880 75 70 28 29 20 66 6f 72 20 64 65 74 61 69 6c 73 up() for details
13890 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 ..*/.#define EXP
138a0 52 44 55 50 5f 52 45 44 55 43 45 20 20 20 20 20 RDUP_REDUCE
138b0 20 20 20 20 30 78 30 30 30 31 20 20 2f 2a 20 55 0x0001 /* U
138c0 73 65 64 20 72 65 64 75 63 65 64 2d 73 69 7a 65 sed reduced-size
138d0 20 45 78 70 72 20 6e 6f 64 65 73 20 2a 2f 0a 0a Expr nodes */..
138e0 2f 2a 0a 2a 2a 20 41 20 6c 69 73 74 20 6f 66 20 /*.** A list of
138f0 65 78 70 72 65 73 73 69 6f 6e 73 2e 20 20 45 61 expressions. Ea
13900 63 68 20 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 ch expression ma
13910 79 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 68 61 76 y optionally hav
13920 65 20 61 0a 2a 2a 20 6e 61 6d 65 2e 20 20 41 6e e a.** name. An
13930 20 65 78 70 72 2f 6e 61 6d 65 20 63 6f 6d 62 69 expr/name combi
13940 6e 61 74 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 nation can be us
13950 65 64 20 69 6e 20 73 65 76 65 72 61 6c 20 77 61 ed in several wa
13960 79 73 2c 20 73 75 63 68 0a 2a 2a 20 61 73 20 74 ys, such.** as t
13970 68 65 20 6c 69 73 74 20 6f 66 20 22 65 78 70 72 he list of "expr
13980 20 41 53 20 49 44 22 20 66 69 65 6c 64 73 20 66 AS ID" fields f
13990 6f 6c 6c 6f 77 69 6e 67 20 61 20 22 53 45 4c 45 ollowing a "SELE
139a0 43 54 22 20 6f 72 20 69 6e 20 74 68 65 0a 2a 2a CT" or in the.**
139b0 20 6c 69 73 74 20 6f 66 20 22 49 44 20 3d 20 65 list of "ID = e
139c0 78 70 72 22 20 69 74 65 6d 73 20 69 6e 20 61 6e xpr" items in an
139d0 20 55 50 44 41 54 45 2e 20 20 41 20 6c 69 73 74 UPDATE. A list
139e0 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e 73 20 of expressions
139f0 63 61 6e 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 75 can.** also be u
13a00 73 65 64 20 61 73 20 74 68 65 20 61 72 67 75 6d sed as the argum
13a10 65 6e 74 20 74 6f 20 61 20 66 75 6e 63 74 69 6f ent to a functio
13a20 6e 2c 20 69 6e 20 77 68 69 63 68 20 63 61 73 65 n, in which case
13a30 20 74 68 65 20 61 2e 7a 4e 61 6d 65 0a 2a 2a 20 the a.zName.**
13a40 66 69 65 6c 64 20 69 73 20 6e 6f 74 20 75 73 65 field is not use
13a50 64 2e 0a 2a 2a 0a 2a 2a 20 42 79 20 64 65 66 61 d..**.** By defa
13a60 75 6c 74 20 74 68 65 20 45 78 70 72 2e 7a 53 70 ult the Expr.zSp
13a70 61 6e 20 66 69 65 6c 64 20 68 6f 6c 64 73 20 61 an field holds a
13a80 20 68 75 6d 61 6e 2d 72 65 61 64 61 62 6c 65 20 human-readable
13a90 64 65 73 63 72 69 70 74 69 6f 6e 20 6f 66 0a 2a description of.*
13aa0 2a 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e * the expression
13ab0 20 74 68 61 74 20 69 73 20 75 73 65 64 20 69 6e that is used in
13ac0 20 74 68 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 the generation
13ad0 6f 66 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 of error message
13ae0 73 20 61 6e 64 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 s and.** column
13af0 6c 61 62 65 6c 73 2e 20 20 49 6e 20 74 68 69 73 labels. In this
13b00 20 63 61 73 65 2c 20 45 78 70 72 2e 7a 53 70 61 case, Expr.zSpa
13b10 6e 20 69 73 20 74 79 70 69 63 61 6c 6c 79 20 74 n is typically t
13b20 68 65 20 74 65 78 74 20 6f 66 20 61 0a 2a 2a 20 he text of a.**
13b30 63 6f 6c 75 6d 6e 20 65 78 70 72 65 73 73 69 6f column expressio
13b40 6e 20 61 73 20 69 74 20 65 78 69 73 74 73 20 69 n as it exists i
13b50 6e 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 n a SELECT state
13b60 6d 65 6e 74 2e 20 20 48 6f 77 65 76 65 72 2c 20 ment. However,
13b70 69 66 0a 2a 2a 20 74 68 65 20 62 53 70 61 6e 49 if.** the bSpanI
13b80 73 54 61 62 20 66 6c 61 67 20 69 73 20 73 65 74 sTab flag is set
13b90 2c 20 74 68 65 6e 20 7a 53 70 61 6e 20 69 73 20 , then zSpan is
13ba0 6f 76 65 72 6c 6f 61 64 65 64 20 74 6f 20 6d 65 overloaded to me
13bb0 61 6e 20 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 6f an the name.** o
13bc0 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6c f the result col
13bd0 75 6d 6e 20 69 6e 20 74 68 65 20 66 6f 72 6d 3a umn in the form:
13be0 20 44 41 54 41 42 41 53 45 2e 54 41 42 4c 45 2e DATABASE.TABLE.
13bf0 43 4f 4c 55 4d 4e 2e 20 20 54 68 69 73 20 6c 61 COLUMN. This la
13c00 74 65 72 0a 2a 2a 20 66 6f 72 6d 20 69 73 20 75 ter.** form is u
13c10 73 65 64 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 sed for name res
13c20 6f 6c 75 74 69 6f 6e 20 77 69 74 68 20 6e 65 73 olution with nes
13c30 74 65 64 20 46 52 4f 4d 20 63 6c 61 75 73 65 73 ted FROM clauses
13c40 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 70 72 ..*/.struct Expr
13c50 4c 69 73 74 20 7b 0a 20 20 69 6e 74 20 6e 45 78 List {. int nEx
13c60 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 pr;
13c70 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 78 70 /* Number of exp
13c80 72 65 73 73 69 6f 6e 73 20 6f 6e 20 74 68 65 20 ressions on the
13c90 6c 69 73 74 20 2a 2f 0a 20 20 69 6e 74 20 69 45 list */. int iE
13ca0 43 75 72 73 6f 72 3b 20 20 20 20 20 20 20 20 20 Cursor;
13cb0 20 2f 2a 20 56 44 42 45 20 43 75 72 73 6f 72 20 /* VDBE Cursor
13cc0 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 associated with
13cd0 74 68 69 73 20 45 78 70 72 4c 69 73 74 20 2a 2f this ExprList */
13ce0 0a 20 20 73 74 72 75 63 74 20 45 78 70 72 4c 69 . struct ExprLi
13cf0 73 74 5f 69 74 65 6d 20 7b 20 2f 2a 20 46 6f 72 st_item { /* For
13d00 20 65 61 63 68 20 65 78 70 72 65 73 73 69 6f 6e each expression
13d10 20 69 6e 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a in the list */.
13d20 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 72 3b Expr *pExpr;
13d30 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
13d40 68 65 20 6c 69 73 74 20 6f 66 20 65 78 70 72 65 he list of expre
13d50 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 20 20 63 68 ssions */. ch
13d60 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 ar *zName;
13d70 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 61 /* Token a
13d80 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
13d90 68 69 73 20 65 78 70 72 65 73 73 69 6f 6e 20 2a his expression *
13da0 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 53 70 61 /. char *zSpa
13db0 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a n; /*
13dc0 20 4f 72 69 67 69 6e 61 6c 20 74 65 78 74 20 6f Original text o
13dd0 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e f the expression
13de0 20 2a 2f 0a 20 20 20 20 75 38 20 73 6f 72 74 4f */. u8 sortO
13df0 72 64 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 rder;
13e00 2f 2a 20 31 20 66 6f 72 20 44 45 53 43 20 6f 72 /* 1 for DESC or
13e10 20 30 20 66 6f 72 20 41 53 43 20 2a 2f 0a 20 20 0 for ASC */.
13e20 20 20 75 6e 73 69 67 6e 65 64 20 64 6f 6e 65 20 unsigned done
13e30 3a 31 3b 20 20 20 20 20 20 20 2f 2a 20 41 20 66 :1; /* A f
13e40 6c 61 67 20 74 6f 20 69 6e 64 69 63 61 74 65 20 lag to indicate
13e50 77 68 65 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 when processing
13e60 69 73 20 66 69 6e 69 73 68 65 64 20 2a 2f 0a 20 is finished */.
13e70 20 20 20 75 6e 73 69 67 6e 65 64 20 62 53 70 61 unsigned bSpa
13e80 6e 49 73 54 61 62 20 3a 31 3b 20 2f 2a 20 7a 53 nIsTab :1; /* zS
13e90 70 61 6e 20 68 6f 6c 64 73 20 44 42 2e 54 41 42 pan holds DB.TAB
13ea0 4c 45 2e 43 4f 4c 55 4d 4e 20 2a 2f 0a 20 20 20 LE.COLUMN */.
13eb0 20 75 6e 73 69 67 6e 65 64 20 72 65 75 73 61 62 unsigned reusab
13ec0 6c 65 20 3a 31 3b 20 20 20 2f 2a 20 43 6f 6e 73 le :1; /* Cons
13ed0 74 61 6e 74 20 65 78 70 72 65 73 73 69 6f 6e 20 tant expression
13ee0 69 73 20 72 65 75 73 61 62 6c 65 20 2a 2f 0a 20 is reusable */.
13ef0 20 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 20 union {.
13f00 20 73 74 72 75 63 74 20 7b 0a 20 20 20 20 20 20 struct {.
13f10 20 20 75 31 36 20 69 4f 72 64 65 72 42 79 43 6f u16 iOrderByCo
13f20 6c 3b 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 4f l; /* For O
13f30 52 44 45 52 20 42 59 2c 20 63 6f 6c 75 6d 6e 20 RDER BY, column
13f40 6e 75 6d 62 65 72 20 69 6e 20 72 65 73 75 6c 74 number in result
13f50 20 73 65 74 20 2a 2f 0a 20 20 20 20 20 20 20 20 set */.
13f60 75 31 36 20 69 41 6c 69 61 73 3b 20 20 20 20 20 u16 iAlias;
13f70 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 /* Index i
13f80 6e 74 6f 20 50 61 72 73 65 2e 61 41 6c 69 61 73 nto Parse.aAlias
13f90 5b 5d 20 66 6f 72 20 7a 4e 61 6d 65 20 2a 2f 0a [] for zName */.
13fa0 20 20 20 20 20 20 7d 20 78 3b 0a 20 20 20 20 20 } x;.
13fb0 20 69 6e 74 20 69 43 6f 6e 73 74 45 78 70 72 52 int iConstExprR
13fc0 65 67 3b 20 20 20 20 20 20 2f 2a 20 52 65 67 69 eg; /* Regi
13fd0 73 74 65 72 20 69 6e 20 77 68 69 63 68 20 45 78 ster in which Ex
13fe0 70 72 20 76 61 6c 75 65 20 69 73 20 63 61 63 68 pr value is cach
13ff0 65 64 20 2a 2f 0a 20 20 20 20 7d 20 75 3b 0a 20 ed */. } u;.
14000 20 7d 20 2a 61 3b 20 20 20 20 20 20 20 20 20 20 } *a;
14010 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 /* Alloc
14020 20 61 20 70 6f 77 65 72 20 6f 66 20 74 77 6f 20 a power of two
14030 67 72 65 61 74 65 72 20 6f 72 20 65 71 75 61 6c greater or equal
14040 20 74 6f 20 6e 45 78 70 72 20 2a 2f 0a 7d 3b 0a to nExpr */.};.
14050 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
14060 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 ce of this struc
14070 74 75 72 65 20 69 73 20 75 73 65 64 20 62 79 20 ture is used by
14080 74 68 65 20 70 61 72 73 65 72 20 74 6f 20 72 65 the parser to re
14090 63 6f 72 64 20 62 6f 74 68 0a 2a 2a 20 74 68 65 cord both.** the
140a0 20 70 61 72 73 65 20 74 72 65 65 20 66 6f 72 20 parse tree for
140b0 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 61 6e an expression an
140c0 64 20 74 68 65 20 73 70 61 6e 20 6f 66 20 69 6e d the span of in
140d0 70 75 74 20 74 65 78 74 20 66 6f 72 20 61 6e 0a put text for an.
140e0 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2a ** expression..*
140f0 2f 0a 73 74 72 75 63 74 20 45 78 70 72 53 70 61 /.struct ExprSpa
14100 6e 20 7b 0a 20 20 45 78 70 72 20 2a 70 45 78 70 n {. Expr *pExp
14110 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 r; /* T
14120 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 70 61 he expression pa
14130 72 73 65 20 74 72 65 65 20 2a 2f 0a 20 20 63 6f rse tree */. co
14140 6e 73 74 20 63 68 61 72 20 2a 7a 53 74 61 72 74 nst char *zStart
14150 3b 20 20 20 2f 2a 20 46 69 72 73 74 20 63 68 61 ; /* First cha
14160 72 61 63 74 65 72 20 6f 66 20 69 6e 70 75 74 20 racter of input
14170 74 65 78 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 text */. const
14180 63 68 61 72 20 2a 7a 45 6e 64 3b 20 20 20 20 20 char *zEnd;
14190 2f 2a 20 4f 6e 65 20 63 68 61 72 61 63 74 65 72 /* One character
141a0 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f 66 past the end of
141b0 20 69 6e 70 75 74 20 74 65 78 74 20 2a 2f 0a 7d input text */.}
141c0 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 ;../*.** An inst
141d0 61 6e 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 ance of this str
141e0 75 63 74 75 72 65 20 63 61 6e 20 68 6f 6c 64 20 ucture can hold
141f0 61 20 73 69 6d 70 6c 65 20 6c 69 73 74 20 6f 66 a simple list of
14200 20 69 64 65 6e 74 69 66 69 65 72 73 2c 0a 2a 2a identifiers,.**
14210 20 73 75 63 68 20 61 73 20 74 68 65 20 6c 69 73 such as the lis
14220 74 20 22 61 2c 62 2c 63 22 20 69 6e 20 74 68 65 t "a,b,c" in the
14230 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 following state
14240 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 ments:.**.**
14250 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 28 INSERT INTO t(
14260 61 2c 62 2c 63 29 20 56 41 4c 55 45 53 20 2e 2e a,b,c) VALUES ..
14270 2e 3b 0a 2a 2a 20 20 20 20 20 20 43 52 45 41 54 .;.** CREAT
14280 45 20 49 4e 44 45 58 20 69 64 78 20 4f 4e 20 74 E INDEX idx ON t
14290 28 61 2c 62 2c 63 29 3b 0a 2a 2a 20 20 20 20 20 (a,b,c);.**
142a0 20 43 52 45 41 54 45 20 54 52 49 47 47 45 52 20 CREATE TRIGGER
142b0 74 72 69 67 20 42 45 46 4f 52 45 20 55 50 44 41 trig BEFORE UPDA
142c0 54 45 20 4f 4e 20 74 28 61 2c 62 2c 63 29 20 2e TE ON t(a,b,c) .
142d0 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 64 ..;.**.** The Id
142e0 4c 69 73 74 2e 61 2e 69 64 78 20 66 69 65 6c 64 List.a.idx field
142f0 20 69 73 20 75 73 65 64 20 77 68 65 6e 20 74 68 is used when th
14300 65 20 49 64 4c 69 73 74 20 72 65 70 72 65 73 65 e IdList represe
14310 6e 74 73 20 74 68 65 20 6c 69 73 74 20 6f 66 0a nts the list of.
14320 2a 2a 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 ** column names
14330 61 66 74 65 72 20 61 20 74 61 62 6c 65 20 6e 61 after a table na
14340 6d 65 20 69 6e 20 61 6e 20 49 4e 53 45 52 54 20 me in an INSERT
14350 73 74 61 74 65 6d 65 6e 74 2e 20 20 49 6e 20 74 statement. In t
14360 68 65 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 0a he statement.**.
14370 2a 2a 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e ** INSERT IN
14380 54 4f 20 74 28 61 2c 62 2c 63 29 20 2e 2e 2e 0a TO t(a,b,c) ....
14390 2a 2a 0a 2a 2a 20 49 66 20 22 61 22 20 69 73 20 **.** If "a" is
143a0 74 68 65 20 6b 2d 74 68 20 63 6f 6c 75 6d 6e 20 the k-th column
143b0 6f 66 20 74 61 62 6c 65 20 22 74 22 2c 20 74 68 of table "t", th
143c0 65 6e 20 49 64 4c 69 73 74 2e 61 5b 30 5d 2e 69 en IdList.a[0].i
143d0 64 78 3d 3d 6b 2e 0a 2a 2f 0a 73 74 72 75 63 74 dx==k..*/.struct
143e0 20 49 64 4c 69 73 74 20 7b 0a 20 20 73 74 72 75 IdList {. stru
143f0 63 74 20 49 64 4c 69 73 74 5f 69 74 65 6d 20 7b ct IdList_item {
14400 0a 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 . char *zName
14410 3b 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f ; /* Name o
14420 66 20 74 68 65 20 69 64 65 6e 74 69 66 69 65 72 f the identifier
14430 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 64 78 3b */. int idx;
14440 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
14450 65 78 20 69 6e 20 73 6f 6d 65 20 54 61 62 6c 65 ex in some Table
14460 2e 61 43 6f 6c 5b 5d 20 6f 66 20 61 20 63 6f 6c .aCol[] of a col
14470 75 6d 6e 20 6e 61 6d 65 64 20 7a 4e 61 6d 65 20 umn named zName
14480 2a 2f 0a 20 20 7d 20 2a 61 3b 0a 20 20 69 6e 74 */. } *a;. int
14490 20 6e 49 64 3b 20 20 20 20 20 20 20 20 20 2f 2a nId; /*
144a0 20 4e 75 6d 62 65 72 20 6f 66 20 69 64 65 6e 74 Number of ident
144b0 69 66 69 65 72 73 20 6f 6e 20 74 68 65 20 6c 69 ifiers on the li
144c0 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 st */.};../*.**
144d0 54 68 65 20 62 69 74 6d 61 73 6b 20 64 61 74 61 The bitmask data
144e0 74 79 70 65 20 64 65 66 69 6e 65 64 20 62 65 6c type defined bel
144f0 6f 77 20 69 73 20 75 73 65 64 20 66 6f 72 20 76 ow is used for v
14500 61 72 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 arious optimizat
14510 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e ions..**.** Chan
14520 67 69 6e 67 20 74 68 69 73 20 66 72 6f 6d 20 61 ging this from a
14530 20 36 34 2d 62 69 74 20 74 6f 20 61 20 33 32 2d 64-bit to a 32-
14540 62 69 74 20 74 79 70 65 20 6c 69 6d 69 74 73 20 bit type limits
14550 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a the number of.**
14560 20 74 61 62 6c 65 73 20 69 6e 20 61 20 6a 6f 69 tables in a joi
14570 6e 20 74 6f 20 33 32 20 69 6e 73 74 65 61 64 20 n to 32 instead
14580 6f 66 20 36 34 2e 20 20 42 75 74 20 69 74 20 61 of 64. But it a
14590 6c 73 6f 20 72 65 64 75 63 65 73 20 74 68 65 20 lso reduces the
145a0 73 69 7a 65 0a 2a 2a 20 6f 66 20 74 68 65 20 6c size.** of the l
145b0 69 62 72 61 72 79 20 62 79 20 37 33 38 20 62 79 ibrary by 738 by
145c0 74 65 73 20 6f 6e 20 69 78 38 36 2e 0a 2a 2f 0a tes on ix86..*/.
145d0 74 79 70 65 64 65 66 20 75 36 34 20 42 69 74 6d typedef u64 Bitm
145e0 61 73 6b 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ask;../*.** The
145f0 6e 75 6d 62 65 72 20 6f 66 20 62 69 74 73 20 69 number of bits i
14600 6e 20 61 20 42 69 74 6d 61 73 6b 2e 20 20 22 42 n a Bitmask. "B
14610 4d 53 22 20 6d 65 61 6e 73 20 22 42 69 74 4d 61 MS" means "BitMa
14620 73 6b 20 53 69 7a 65 22 2e 0a 2a 2f 0a 23 64 65 sk Size"..*/.#de
14630 66 69 6e 65 20 42 4d 53 20 20 28 28 69 6e 74 29 fine BMS ((int)
14640 28 73 69 7a 65 6f 66 28 42 69 74 6d 61 73 6b 29 (sizeof(Bitmask)
14650 2a 38 29 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 62 69 *8))../*.** A bi
14660 74 20 69 6e 20 61 20 42 69 74 6d 61 73 6b 0a 2a t in a Bitmask.*
14670 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 4b 42 49 /.#define MASKBI
14680 54 28 6e 29 20 20 20 28 28 28 42 69 74 6d 61 73 T(n) (((Bitmas
14690 6b 29 31 29 3c 3c 28 6e 29 29 0a 0a 2f 2a 0a 2a k)1)<<(n))../*.*
146a0 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
146b0 73 74 72 75 63 74 75 72 65 20 64 65 73 63 72 69 structure descri
146c0 62 65 73 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 bes the FROM cla
146d0 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43 54 20 use of a SELECT
146e0 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 45 61 statement..** Ea
146f0 63 68 20 74 61 62 6c 65 20 6f 72 20 73 75 62 71 ch table or subq
14700 75 65 72 79 20 69 6e 20 74 68 65 20 46 52 4f 4d uery in the FROM
14710 20 63 6c 61 75 73 65 20 69 73 20 61 20 73 65 70 clause is a sep
14720 61 72 61 74 65 20 65 6c 65 6d 65 6e 74 20 6f 66 arate element of
14730 0a 2a 2a 20 74 68 65 20 53 72 63 4c 69 73 74 2e .** the SrcList.
14740 61 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a 2a 2a a[] array..**.**
14750 20 57 69 74 68 20 74 68 65 20 61 64 64 69 74 69 With the additi
14760 6f 6e 20 6f 66 20 6d 75 6c 74 69 70 6c 65 20 64 on of multiple d
14770 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 74 2c atabase support,
14780 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
14790 74 72 75 63 74 75 72 65 0a 2a 2a 20 63 61 6e 20 tructure.** can
147a0 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 6f 20 also be used to
147b0 64 65 73 63 72 69 62 65 20 61 20 70 61 72 74 69 describe a parti
147c0 63 75 6c 61 72 20 74 61 62 6c 65 20 73 75 63 68 cular table such
147d0 20 61 73 20 74 68 65 20 74 61 62 6c 65 20 74 68 as the table th
147e0 61 74 0a 2a 2a 20 69 73 20 6d 6f 64 69 66 69 65 at.** is modifie
147f0 64 20 62 79 20 61 6e 20 49 4e 53 45 52 54 2c 20 d by an INSERT,
14800 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 44 41 54 DELETE, or UPDAT
14810 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 49 6e E statement. In
14820 20 73 74 61 6e 64 61 72 64 20 53 51 4c 2c 0a 2a standard SQL,.*
14830 2a 20 73 75 63 68 20 61 20 74 61 62 6c 65 20 6d * such a table m
14840 75 73 74 20 62 65 20 61 20 73 69 6d 70 6c 65 20 ust be a simple
14850 6e 61 6d 65 3a 20 49 44 2e 20 20 42 75 74 20 69 name: ID. But i
14860 6e 20 53 51 4c 69 74 65 2c 20 74 68 65 20 74 61 n SQLite, the ta
14870 62 6c 65 20 63 61 6e 0a 2a 2a 20 6e 6f 77 20 62 ble can.** now b
14880 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 e identified by
14890 61 20 64 61 74 61 62 61 73 65 20 6e 61 6d 65 2c a database name,
148a0 20 61 20 64 6f 74 2c 20 74 68 65 6e 20 74 68 65 a dot, then the
148b0 20 74 61 62 6c 65 20 6e 61 6d 65 3a 20 49 44 2e table name: ID.
148c0 49 44 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6a 6f ID..**.** The jo
148d0 69 6e 74 79 70 65 20 73 74 61 72 74 73 20 6f 75 intype starts ou
148e0 74 20 73 68 6f 77 69 6e 67 20 74 68 65 20 6a 6f t showing the jo
148f0 69 6e 20 74 79 70 65 20 62 65 74 77 65 65 6e 20 in type between
14900 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 62 6c the current tabl
14910 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 6e 65 78 e.** and the nex
14920 74 20 74 61 62 6c 65 20 6f 6e 20 74 68 65 20 6c t table on the l
14930 69 73 74 2e 20 20 54 68 65 20 70 61 72 73 65 72 ist. The parser
14940 20 62 75 69 6c 64 73 20 74 68 65 20 6c 69 73 74 builds the list
14950 20 74 68 69 73 20 77 61 79 2e 0a 2a 2a 20 42 75 this way..** Bu
14960 74 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 t sqlite3SrcList
14970 53 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 29 20 ShiftJoinType()
14980 6c 61 74 65 72 20 73 68 69 66 74 73 20 74 68 65 later shifts the
14990 20 6a 6f 69 6e 74 79 70 65 73 20 73 6f 20 74 68 jointypes so th
149a0 61 74 20 65 61 63 68 0a 2a 2a 20 6a 6f 69 6e 74 at each.** joint
149b0 79 70 65 20 65 78 70 72 65 73 73 65 73 20 74 68 ype expresses th
149c0 65 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e 20 74 e join between t
149d0 68 65 20 74 61 62 6c 65 20 61 6e 64 20 74 68 65 he table and the
149e0 20 70 72 65 76 69 6f 75 73 20 74 61 62 6c 65 2e previous table.
149f0 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 63 6f .**.** In the co
14a00 6c 55 73 65 64 20 66 69 65 6c 64 2c 20 74 68 65 lUsed field, the
14a10 20 68 69 67 68 2d 6f 72 64 65 72 20 62 69 74 20 high-order bit
14a20 28 62 69 74 20 36 33 29 20 69 73 20 73 65 74 20 (bit 63) is set
14a30 69 66 20 74 68 65 20 74 61 62 6c 65 0a 2a 2a 20 if the table.**
14a40 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 74 68 contains more th
14a50 61 6e 20 36 33 20 63 6f 6c 75 6d 6e 73 20 61 6e an 63 columns an
14a60 64 20 74 68 65 20 36 34 2d 74 68 20 6f 72 20 6c d the 64-th or l
14a70 61 74 65 72 20 63 6f 6c 75 6d 6e 20 69 73 20 75 ater column is u
14a80 73 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 sed..*/.struct S
14a90 72 63 4c 69 73 74 20 7b 0a 20 20 75 38 20 6e 53 rcList {. u8 nS
14aa0 72 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 rc; /* Nu
14ab0 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 73 20 6f mber of tables o
14ac0 72 20 73 75 62 71 75 65 72 69 65 73 20 69 6e 20 r subqueries in
14ad0 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 the FROM clause
14ae0 2a 2f 0a 20 20 75 38 20 6e 41 6c 6c 6f 63 3b 20 */. u8 nAlloc;
14af0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
14b00 66 20 65 6e 74 72 69 65 73 20 61 6c 6c 6f 63 61 f entries alloca
14b10 74 65 64 20 69 6e 20 61 5b 5d 20 62 65 6c 6f 77 ted in a[] below
14b20 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 53 72 63 */. struct Src
14b30 4c 69 73 74 5f 69 74 65 6d 20 7b 0a 20 20 20 20 List_item {.
14b40 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b Schema *pSchema;
14b50 20 20 2f 2a 20 53 63 68 65 6d 61 20 74 6f 20 77 /* Schema to w
14b60 68 69 63 68 20 74 68 69 73 20 69 74 65 6d 20 69 hich this item i
14b70 73 20 66 69 78 65 64 20 2a 2f 0a 20 20 20 20 63 s fixed */. c
14b80 68 61 72 20 2a 7a 44 61 74 61 62 61 73 65 3b 20 har *zDatabase;
14b90 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 61 74 61 /* Name of data
14ba0 62 61 73 65 20 68 6f 6c 64 69 6e 67 20 74 68 69 base holding thi
14bb0 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 63 s table */. c
14bc0 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
14bd0 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
14be0 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 63 68 61 table */. cha
14bf0 72 20 2a 7a 41 6c 69 61 73 3b 20 20 20 20 20 2f r *zAlias; /
14c00 2a 20 54 68 65 20 22 42 22 20 70 61 72 74 20 6f * The "B" part o
14c10 66 20 61 20 22 41 20 41 53 20 42 22 20 70 68 72 f a "A AS B" phr
14c20 61 73 65 2e 20 20 7a 4e 61 6d 65 20 69 73 20 74 ase. zName is t
14c30 68 65 20 22 41 22 20 2a 2f 0a 20 20 20 20 54 61 he "A" */. Ta
14c40 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 ble *pTab;
14c50 2f 2a 20 41 6e 20 53 51 4c 20 74 61 62 6c 65 20 /* An SQL table
14c60 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f corresponding to
14c70 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 20 20 53 65 zName */. Se
14c80 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 lect *pSelect;
14c90 2f 2a 20 41 20 53 45 4c 45 43 54 20 73 74 61 74 /* A SELECT stat
14ca0 65 6d 65 6e 74 20 75 73 65 64 20 69 6e 20 70 6c ement used in pl
14cb0 61 63 65 20 6f 66 20 61 20 74 61 62 6c 65 20 6e ace of a table n
14cc0 61 6d 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 61 ame */. int a
14cd0 64 64 72 46 69 6c 6c 53 75 62 3b 20 20 2f 2a 20 ddrFillSub; /*
14ce0 41 64 64 72 65 73 73 20 6f 66 20 73 75 62 72 6f Address of subro
14cf0 75 74 69 6e 65 20 74 6f 20 6d 61 6e 69 66 65 73 utine to manifes
14d00 74 20 61 20 73 75 62 71 75 65 72 79 20 2a 2f 0a t a subquery */.
14d10 20 20 20 20 69 6e 74 20 72 65 67 52 65 74 75 72 int regRetur
14d20 6e 3b 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 n; /* Registe
14d30 72 20 68 6f 6c 64 69 6e 67 20 72 65 74 75 72 6e r holding return
14d40 20 61 64 64 72 65 73 73 20 6f 66 20 61 64 64 72 address of addr
14d50 46 69 6c 6c 53 75 62 20 2a 2f 0a 20 20 20 20 75 FillSub */. u
14d60 38 20 6a 6f 69 6e 74 79 70 65 3b 20 20 20 20 20 8 jointype;
14d70 20 2f 2a 20 54 79 70 65 20 6f 66 20 6a 6f 69 6e /* Type of join
14d80 20 62 65 74 77 65 65 6e 20 74 68 69 73 20 61 62 between this ab
14d90 6c 65 20 61 6e 64 20 74 68 65 20 70 72 65 76 69 le and the previ
14da0 6f 75 73 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 ous */. unsig
14db0 6e 65 64 20 6e 6f 74 49 6e 64 65 78 65 64 20 3a ned notIndexed :
14dc0 31 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 1; /* True if
14dd0 20 74 68 65 72 65 20 69 73 20 61 20 4e 4f 54 20 there is a NOT
14de0 49 4e 44 45 58 45 44 20 63 6c 61 75 73 65 20 2a INDEXED clause *
14df0 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 /. unsigned i
14e00 73 43 6f 72 72 65 6c 61 74 65 64 20 3a 31 3b 20 sCorrelated :1;
14e10 20 2f 2a 20 54 72 75 65 20 69 66 20 73 75 62 2d /* True if sub-
14e20 71 75 65 72 79 20 69 73 20 63 6f 72 72 65 6c 61 query is correla
14e30 74 65 64 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 ted */. unsig
14e40 6e 65 64 20 76 69 61 43 6f 72 6f 75 74 69 6e 65 ned viaCoroutine
14e50 20 3a 31 3b 20 20 2f 2a 20 49 6d 70 6c 65 6d 65 :1; /* Impleme
14e60 6e 74 65 64 20 61 73 20 61 20 63 6f 2d 72 6f 75 nted as a co-rou
14e70 74 69 6e 65 20 2a 2f 0a 20 20 20 20 75 6e 73 69 tine */. unsi
14e80 67 6e 65 64 20 69 73 52 65 63 75 72 73 69 76 65 gned isRecursive
14e90 20 3a 31 3b 20 20 20 2f 2a 20 54 72 75 65 20 66 :1; /* True f
14ea0 6f 72 20 72 65 63 75 72 73 69 76 65 20 72 65 66 or recursive ref
14eb0 65 72 65 6e 63 65 20 69 6e 20 57 49 54 48 20 2a erence in WITH *
14ec0 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
14ed0 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 _OMIT_EXPLAIN.
14ee0 20 20 75 38 20 69 53 65 6c 65 63 74 49 64 3b 20 u8 iSelectId;
14ef0 20 20 20 20 2f 2a 20 49 66 20 70 53 65 6c 65 63 /* If pSelec
14f00 74 21 3d 30 2c 20 74 68 65 20 69 64 20 6f 66 20 t!=0, the id of
14f10 74 68 65 20 73 75 62 2d 73 65 6c 65 63 74 20 69 the sub-select i
14f20 6e 20 45 51 50 20 2a 2f 0a 23 65 6e 64 69 66 0a n EQP */.#endif.
14f30 20 20 20 20 69 6e 74 20 69 43 75 72 73 6f 72 3b int iCursor;
14f40 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56 44 42 /* The VDB
14f50 45 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 E cursor number
14f60 75 73 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 used to access t
14f70 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 his table */.
14f80 20 45 78 70 72 20 2a 70 4f 6e 3b 20 20 20 20 20 Expr *pOn;
14f90 20 20 20 2f 2a 20 54 68 65 20 4f 4e 20 63 6c 61 /* The ON cla
14fa0 75 73 65 20 6f 66 20 61 20 6a 6f 69 6e 20 2a 2f use of a join */
14fb0 0a 20 20 20 20 49 64 4c 69 73 74 20 2a 70 55 73 . IdList *pUs
14fc0 69 6e 67 3b 20 20 20 2f 2a 20 54 68 65 20 55 53 ing; /* The US
14fd0 49 4e 47 20 63 6c 61 75 73 65 20 6f 66 20 61 20 ING clause of a
14fe0 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 42 69 74 6d join */. Bitm
14ff0 61 73 6b 20 63 6f 6c 55 73 65 64 3b 20 20 2f 2a ask colUsed; /*
15000 20 42 69 74 20 4e 20 28 31 3c 3c 4e 29 20 73 65 Bit N (1<<N) se
15010 74 20 69 66 20 63 6f 6c 75 6d 6e 20 4e 20 6f 66 t if column N of
15020 20 70 54 61 62 20 69 73 20 75 73 65 64 20 2a 2f pTab is used */
15030 0a 20 20 20 20 63 68 61 72 20 2a 7a 49 6e 64 65 . char *zInde
15040 78 3b 20 20 20 20 20 2f 2a 20 49 64 65 6e 74 69 x; /* Identi
15050 66 69 65 72 20 66 72 6f 6d 20 22 49 4e 44 45 58 fier from "INDEX
15060 45 44 20 42 59 20 3c 7a 49 6e 64 65 78 3e 22 20 ED BY <zIndex>"
15070 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 49 6e clause */. In
15080 64 65 78 20 2a 70 49 6e 64 65 78 3b 20 20 20 20 dex *pIndex;
15090 2f 2a 20 49 6e 64 65 78 20 73 74 72 75 63 74 75 /* Index structu
150a0 72 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 re corresponding
150b0 20 74 6f 20 7a 49 6e 64 65 78 2c 20 69 66 20 61 to zIndex, if a
150c0 6e 79 20 2a 2f 0a 20 20 7d 20 61 5b 31 5d 3b 20 ny */. } a[1];
150d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
150e0 6e 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63 ne entry for eac
150f0 68 20 69 64 65 6e 74 69 66 69 65 72 20 6f 6e 20 h identifier on
15100 74 68 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a the list */.};..
15110 2f 2a 0a 2a 2a 20 50 65 72 6d 69 74 74 65 64 20 /*.** Permitted
15120 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 53 72 values of the Sr
15130 63 4c 69 73 74 2e 61 2e 6a 6f 69 6e 74 79 70 65 cList.a.jointype
15140 20 66 69 65 6c 64 0a 2a 2f 0a 23 64 65 66 69 6e field.*/.#defin
15150 65 20 4a 54 5f 49 4e 4e 45 52 20 20 20 20 20 30 e JT_INNER 0
15160 78 30 30 30 31 20 20 20 20 2f 2a 20 41 6e 79 20 x0001 /* Any
15170 6b 69 6e 64 20 6f 66 20 69 6e 6e 65 72 20 6f 72 kind of inner or
15180 20 63 72 6f 73 73 20 6a 6f 69 6e 20 2a 2f 0a 23 cross join */.#
15190 64 65 66 69 6e 65 20 4a 54 5f 43 52 4f 53 53 20 define JT_CROSS
151a0 20 20 20 20 30 78 30 30 30 32 20 20 20 20 2f 2a 0x0002 /*
151b0 20 45 78 70 6c 69 63 69 74 20 75 73 65 20 6f 66 Explicit use of
151c0 20 74 68 65 20 43 52 4f 53 53 20 6b 65 79 77 6f the CROSS keywo
151d0 72 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 rd */.#define JT
151e0 5f 4e 41 54 55 52 41 4c 20 20 20 30 78 30 30 30 _NATURAL 0x000
151f0 34 20 20 20 20 2f 2a 20 54 72 75 65 20 66 6f 72 4 /* True for
15200 20 61 20 22 6e 61 74 75 72 61 6c 22 20 6a 6f 69 a "natural" joi
15210 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f n */.#define JT_
15220 4c 45 46 54 20 20 20 20 20 20 30 78 30 30 30 38 LEFT 0x0008
15230 20 20 20 20 2f 2a 20 4c 65 66 74 20 6f 75 74 65 /* Left oute
15240 72 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e r join */.#defin
15250 65 20 4a 54 5f 52 49 47 48 54 20 20 20 20 20 30 e JT_RIGHT 0
15260 78 30 30 31 30 20 20 20 20 2f 2a 20 52 69 67 68 x0010 /* Righ
15270 74 20 6f 75 74 65 72 20 6a 6f 69 6e 20 2a 2f 0a t outer join */.
15280 23 64 65 66 69 6e 65 20 4a 54 5f 4f 55 54 45 52 #define JT_OUTER
15290 20 20 20 20 20 30 78 30 30 32 30 20 20 20 20 2f 0x0020 /
152a0 2a 20 54 68 65 20 22 4f 55 54 45 52 22 20 6b 65 * The "OUTER" ke
152b0 79 77 6f 72 64 20 69 73 20 70 72 65 73 65 6e 74 yword is present
152c0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 45 */.#define JT_E
152d0 52 52 4f 52 20 20 20 20 20 30 78 30 30 34 30 20 RROR 0x0040
152e0 20 20 20 2f 2a 20 75 6e 6b 6e 6f 77 6e 20 6f 72 /* unknown or
152f0 20 75 6e 73 75 70 70 6f 72 74 65 64 20 6a 6f 69 unsupported joi
15300 6e 20 74 79 70 65 20 2a 2f 0a 0a 0a 2f 2a 0a 2a n type */.../*.*
15310 2a 20 46 6c 61 67 73 20 61 70 70 72 6f 70 72 69 * Flags appropri
15320 61 74 65 20 66 6f 72 20 74 68 65 20 77 63 74 72 ate for the wctr
15330 6c 46 6c 61 67 73 20 70 61 72 61 6d 65 74 65 72 lFlags parameter
15340 20 6f 66 20 73 71 6c 69 74 65 33 57 68 65 72 65 of sqlite3Where
15350 42 65 67 69 6e 28 29 0a 2a 2a 20 61 6e 64 20 74 Begin().** and t
15360 68 65 20 57 68 65 72 65 49 6e 66 6f 2e 77 63 74 he WhereInfo.wct
15370 72 6c 46 6c 61 67 73 20 6d 65 6d 62 65 72 2e 0a rlFlags member..
15380 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
15390 5f 4f 52 44 45 52 42 59 5f 4e 4f 52 4d 41 4c 20 _ORDERBY_NORMAL
153a0 20 20 30 78 30 30 30 30 20 2f 2a 20 4e 6f 2d 6f 0x0000 /* No-o
153b0 70 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 p */.#define WHE
153c0 52 45 5f 4f 52 44 45 52 42 59 5f 4d 49 4e 20 20 RE_ORDERBY_MIN
153d0 20 20 20 20 30 78 30 30 30 31 20 2f 2a 20 4f 52 0x0001 /* OR
153e0 44 45 52 20 42 59 20 70 72 6f 63 65 73 73 69 6e DER BY processin
153f0 67 20 66 6f 72 20 6d 69 6e 28 29 20 66 75 6e 63 g for min() func
15400 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
15410 45 5f 4f 52 44 45 52 42 59 5f 4d 41 58 20 20 20 E_ORDERBY_MAX
15420 20 20 20 30 78 30 30 30 32 20 2f 2a 20 4f 52 44 0x0002 /* ORD
15430 45 52 20 42 59 20 70 72 6f 63 65 73 73 69 6e 67 ER BY processing
15440 20 66 6f 72 20 6d 61 78 28 29 20 66 75 6e 63 20 for max() func
15450 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
15460 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 45 44 _ONEPASS_DESIRED
15470 20 20 30 78 30 30 30 34 20 2f 2a 20 57 61 6e 74 0x0004 /* Want
15480 20 74 6f 20 64 6f 20 6f 6e 65 2d 70 61 73 73 20 to do one-pass
15490 55 50 44 41 54 45 2f 44 45 4c 45 54 45 20 2a 2f UPDATE/DELETE */
154a0 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 .#define WHERE_D
154b0 55 50 4c 49 43 41 54 45 53 5f 4f 4b 20 20 20 20 UPLICATES_OK
154c0 30 78 30 30 30 38 20 2f 2a 20 4f 6b 20 74 6f 20 0x0008 /* Ok to
154d0 72 65 74 75 72 6e 20 61 20 72 6f 77 20 6d 6f 72 return a row mor
154e0 65 20 74 68 61 6e 20 6f 6e 63 65 20 2a 2f 0a 23 e than once */.#
154f0 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4d 49 define WHERE_OMI
15500 54 5f 4f 50 45 4e 5f 43 4c 4f 53 45 20 20 30 78 T_OPEN_CLOSE 0x
15510 30 30 31 30 20 2f 2a 20 54 61 62 6c 65 20 63 75 0010 /* Table cu
15520 72 73 6f 72 73 20 61 72 65 20 61 6c 72 65 61 64 rsors are alread
15530 79 20 6f 70 65 6e 20 2a 2f 0a 23 64 65 66 69 6e y open */.#defin
15540 65 20 57 48 45 52 45 5f 46 4f 52 43 45 5f 54 41 e WHERE_FORCE_TA
15550 42 4c 45 20 20 20 20 20 20 30 78 30 30 32 30 20 BLE 0x0020
15560 2f 2a 20 44 6f 20 6e 6f 74 20 75 73 65 20 61 6e /* Do not use an
15570 20 69 6e 64 65 78 2d 6f 6e 6c 79 20 73 65 61 72 index-only sear
15580 63 68 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 ch */.#define WH
15590 45 52 45 5f 4f 4e 45 54 41 42 4c 45 5f 4f 4e 4c ERE_ONETABLE_ONL
155a0 59 20 20 20 20 30 78 30 30 34 30 20 2f 2a 20 4f Y 0x0040 /* O
155b0 6e 6c 79 20 63 6f 64 65 20 74 68 65 20 31 73 74 nly code the 1st
155c0 20 74 61 62 6c 65 20 69 6e 20 70 54 61 62 4c 69 table in pTabLi
155d0 73 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 st */.#define WH
155e0 45 52 45 5f 41 4e 44 5f 4f 4e 4c 59 20 20 20 20 ERE_AND_ONLY
155f0 20 20 20 20 20 30 78 30 30 38 30 20 2f 2a 20 44 0x0080 /* D
15600 6f 6e 27 74 20 75 73 65 20 69 6e 64 69 63 65 73 on't use indices
15610 20 66 6f 72 20 4f 52 20 74 65 72 6d 73 20 2a 2f for OR terms */
15620 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 47 .#define WHERE_G
15630 52 4f 55 50 42 59 20 20 20 20 20 20 20 20 20 20 ROUPBY
15640 30 78 30 31 30 30 20 2f 2a 20 70 4f 72 64 65 72 0x0100 /* pOrder
15650 42 79 20 69 73 20 72 65 61 6c 6c 79 20 61 20 47 By is really a G
15660 52 4f 55 50 20 42 59 20 2a 2f 0a 23 64 65 66 69 ROUP BY */.#defi
15670 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 ne WHERE_DISTINC
15680 54 42 59 20 20 20 20 20 20 20 30 78 30 32 30 30 TBY 0x0200
15690 20 2f 2a 20 70 4f 72 64 65 72 62 79 20 69 73 20 /* pOrderby is
156a0 72 65 61 6c 6c 79 20 61 20 44 49 53 54 49 4e 43 really a DISTINC
156b0 54 20 63 6c 61 75 73 65 20 2a 2f 0a 23 64 65 66 T clause */.#def
156c0 69 6e 65 20 57 48 45 52 45 5f 57 41 4e 54 5f 44 ine WHERE_WANT_D
156d0 49 53 54 49 4e 43 54 20 20 20 20 30 78 30 34 30 ISTINCT 0x040
156e0 30 20 2f 2a 20 41 6c 6c 20 6f 75 74 70 75 74 20 0 /* All output
156f0 6e 65 65 64 73 20 74 6f 20 62 65 20 64 69 73 74 needs to be dist
15700 69 6e 63 74 20 2a 2f 0a 0a 2f 2a 20 41 6c 6c 6f inct */../* Allo
15710 77 65 64 20 72 65 74 75 72 6e 20 76 61 6c 75 65 wed return value
15720 73 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 57 68 s from sqlite3Wh
15730 65 72 65 49 73 44 69 73 74 69 6e 63 74 28 29 0a ereIsDistinct().
15740 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
15750 5f 44 49 53 54 49 4e 43 54 5f 4e 4f 4f 50 20 20 _DISTINCT_NOOP
15760 20 20 20 20 30 20 20 2f 2a 20 44 49 53 54 49 4e 0 /* DISTIN
15770 43 54 20 6b 65 79 77 6f 72 64 20 6e 6f 74 20 75 CT keyword not u
15780 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 sed */.#define W
15790 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 55 4e HERE_DISTINCT_UN
157a0 49 51 55 45 20 20 20 20 31 20 20 2f 2a 20 4e 6f IQUE 1 /* No
157b0 20 64 75 70 6c 69 63 61 74 65 73 20 2a 2f 0a 23 duplicates */.#
157c0 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 53 define WHERE_DIS
157d0 54 49 4e 43 54 5f 4f 52 44 45 52 45 44 20 20 20 TINCT_ORDERED
157e0 32 20 20 2f 2a 20 41 6c 6c 20 64 75 70 6c 69 63 2 /* All duplic
157f0 61 74 65 73 20 61 72 65 20 61 64 6a 61 63 65 6e ates are adjacen
15800 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 t */.#define WHE
15810 52 45 5f 44 49 53 54 49 4e 43 54 5f 55 4e 4f 52 RE_DISTINCT_UNOR
15820 44 45 52 45 44 20 33 20 20 2f 2a 20 44 75 70 6c DERED 3 /* Dupl
15830 69 63 61 74 65 73 20 61 72 65 20 73 63 61 74 74 icates are scatt
15840 65 72 65 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 ered */../*.** A
15850 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 64 65 66 NameContext def
15860 69 6e 65 73 20 61 20 63 6f 6e 74 65 78 74 20 69 ines a context i
15870 6e 20 77 68 69 63 68 20 74 6f 20 72 65 73 6f 6c n which to resol
15880 76 65 20 74 61 62 6c 65 20 61 6e 64 20 63 6f 6c ve table and col
15890 75 6d 6e 0a 2a 2a 20 6e 61 6d 65 73 2e 20 20 54 umn.** names. T
158a0 68 65 20 63 6f 6e 74 65 78 74 20 63 6f 6e 73 69 he context consi
158b0 73 74 73 20 6f 66 20 61 20 6c 69 73 74 20 6f 66 sts of a list of
158c0 20 74 61 62 6c 65 73 20 28 74 68 65 20 70 53 72 tables (the pSr
158d0 63 4c 69 73 74 29 20 66 69 65 6c 64 20 61 6e 64 cList) field and
158e0 0a 2a 2a 20 61 20 6c 69 73 74 20 6f 66 20 6e 61 .** a list of na
158f0 6d 65 64 20 65 78 70 72 65 73 73 69 6f 6e 20 28 med expression (
15900 70 45 4c 69 73 74 29 2e 20 20 54 68 65 20 6e 61 pEList). The na
15910 6d 65 64 20 65 78 70 72 65 73 73 69 6f 6e 20 6c med expression l
15920 69 73 74 20 6d 61 79 0a 2a 2a 20 62 65 20 4e 55 ist may.** be NU
15930 4c 4c 2e 20 20 54 68 65 20 70 53 72 63 20 63 6f LL. The pSrc co
15940 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 rresponds to the
15950 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 6f 66 20 FROM clause of
15960 61 20 53 45 4c 45 43 54 20 6f 72 0a 2a 2a 20 74 a SELECT or.** t
15970 6f 20 74 68 65 20 74 61 62 6c 65 20 62 65 69 6e o the table bein
15980 67 20 6f 70 65 72 61 74 65 64 20 6f 6e 20 62 79 g operated on by
15990 20 49 4e 53 45 52 54 2c 20 55 50 44 41 54 45 2c INSERT, UPDATE,
159a0 20 6f 72 20 44 45 4c 45 54 45 2e 20 20 54 68 65 or DELETE. The
159b0 0a 2a 2a 20 70 45 4c 69 73 74 20 63 6f 72 72 65 .** pEList corre
159c0 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 72 65 sponds to the re
159d0 73 75 6c 74 20 73 65 74 20 6f 66 20 61 20 53 45 sult set of a SE
159e0 4c 45 43 54 20 61 6e 64 20 69 73 20 4e 55 4c 4c LECT and is NULL
159f0 20 66 6f 72 0a 2a 2a 20 6f 74 68 65 72 20 73 74 for.** other st
15a00 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 atements..**.**
15a10 4e 61 6d 65 43 6f 6e 74 65 78 74 73 20 63 61 6e NameContexts can
15a20 20 62 65 20 6e 65 73 74 65 64 2e 20 20 57 68 65 be nested. Whe
15a30 6e 20 72 65 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 n resolving name
15a40 73 2c 20 74 68 65 20 69 6e 6e 65 72 2d 6d 6f 73 s, the inner-mos
15a50 74 20 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 69 73 t .** context is
15a60 20 73 65 61 72 63 68 65 64 20 66 69 72 73 74 2e searched first.
15a70 20 20 49 66 20 6e 6f 20 6d 61 74 63 68 20 69 73 If no match is
15a80 20 66 6f 75 6e 64 2c 20 74 68 65 20 6e 65 78 74 found, the next
15a90 20 6f 75 74 65 72 0a 2a 2a 20 63 6f 6e 74 65 78 outer.** contex
15aa0 74 20 69 73 20 63 68 65 63 6b 65 64 2e 20 20 49 t is checked. I
15ab0 66 20 74 68 65 72 65 20 69 73 20 73 74 69 6c 6c f there is still
15ac0 20 6e 6f 20 6d 61 74 63 68 2c 20 74 68 65 20 6e no match, the n
15ad0 65 78 74 20 63 6f 6e 74 65 78 74 0a 2a 2a 20 69 ext context.** i
15ae0 73 20 63 68 65 63 6b 65 64 2e 20 20 54 68 69 73 s checked. This
15af0 20 70 72 6f 63 65 73 73 20 63 6f 6e 74 69 6e 75 process continu
15b00 65 73 20 75 6e 74 69 6c 20 65 69 74 68 65 72 20 es until either
15b10 61 20 6d 61 74 63 68 20 69 73 20 66 6f 75 6e 64 a match is found
15b20 0a 2a 2a 20 6f 72 20 61 6c 6c 20 63 6f 6e 74 65 .** or all conte
15b30 78 74 73 20 61 72 65 20 63 68 65 63 6b 2e 20 20 xts are check.
15b40 57 68 65 6e 20 61 20 6d 61 74 63 68 20 69 73 20 When a match is
15b50 66 6f 75 6e 64 2c 20 74 68 65 20 6e 52 65 66 20 found, the nRef
15b60 6d 65 6d 62 65 72 20 6f 66 0a 2a 2a 20 74 68 65 member of.** the
15b70 20 63 6f 6e 74 65 78 74 20 63 6f 6e 74 61 69 6e context contain
15b80 69 6e 67 20 74 68 65 20 6d 61 74 63 68 20 69 73 ing the match is
15b90 20 69 6e 63 72 65 6d 65 6e 74 65 64 2e 20 0a 2a incremented. .*
15ba0 2a 0a 2a 2a 20 45 61 63 68 20 73 75 62 71 75 65 *.** Each subque
15bb0 72 79 20 67 65 74 73 20 61 20 6e 65 77 20 4e 61 ry gets a new Na
15bc0 6d 65 43 6f 6e 74 65 78 74 2e 20 20 54 68 65 20 meContext. The
15bd0 70 4e 65 78 74 20 66 69 65 6c 64 20 70 6f 69 6e pNext field poin
15be0 74 73 20 74 6f 20 74 68 65 0a 2a 2a 20 4e 61 6d ts to the.** Nam
15bf0 65 43 6f 6e 74 65 78 74 20 69 6e 20 74 68 65 20 eContext in the
15c00 70 61 72 65 6e 74 20 71 75 65 72 79 2e 20 20 54 parent query. T
15c10 68 75 73 20 74 68 65 20 70 72 6f 63 65 73 73 20 hus the process
15c20 6f 66 20 73 63 61 6e 6e 69 6e 67 20 74 68 65 0a of scanning the.
15c30 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 6c ** NameContext l
15c40 69 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 ist corresponds
15c50 74 6f 20 73 65 61 72 63 68 69 6e 67 20 74 68 72 to searching thr
15c60 6f 75 67 68 20 73 75 63 63 65 73 73 69 76 65 6c ough successivel
15c70 79 20 6f 75 74 65 72 0a 2a 2a 20 73 75 62 71 75 y outer.** subqu
15c80 65 72 69 65 73 20 6c 6f 6f 6b 69 6e 67 20 66 6f eries looking fo
15c90 72 20 61 20 6d 61 74 63 68 2e 0a 2a 2f 0a 73 74 r a match..*/.st
15ca0 72 75 63 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 ruct NameContext
15cb0 20 7b 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 {. Parse *pPar
15cc0 73 65 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 se; /* The
15cd0 20 70 61 72 73 65 72 20 2a 2f 0a 20 20 53 72 63 parser */. Src
15ce0 4c 69 73 74 20 2a 70 53 72 63 4c 69 73 74 3b 20 List *pSrcList;
15cf0 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 65 /* One or more
15d00 20 74 61 62 6c 65 73 20 75 73 65 64 20 74 6f 20 tables used to
15d10 72 65 73 6f 6c 76 65 20 6e 61 6d 65 73 20 2a 2f resolve names */
15d20 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 45 4c . ExprList *pEL
15d30 69 73 74 3b 20 20 20 20 2f 2a 20 4f 70 74 69 6f ist; /* Optio
15d40 6e 61 6c 20 6c 69 73 74 20 6f 66 20 72 65 73 75 nal list of resu
15d50 6c 74 2d 73 65 74 20 63 6f 6c 75 6d 6e 73 20 2a lt-set columns *
15d60 2f 0a 20 20 41 67 67 49 6e 66 6f 20 2a 70 41 67 /. AggInfo *pAg
15d70 67 49 6e 66 6f 3b 20 20 20 2f 2a 20 49 6e 66 6f gInfo; /* Info
15d80 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 67 rmation about ag
15d90 67 72 65 67 61 74 65 73 20 61 74 20 74 68 69 73 gregates at this
15da0 20 6c 65 76 65 6c 20 2a 2f 0a 20 20 4e 61 6d 65 level */. Name
15db0 43 6f 6e 74 65 78 74 20 2a 70 4e 65 78 74 3b 20 Context *pNext;
15dc0 20 2f 2a 20 4e 65 78 74 20 6f 75 74 65 72 20 6e /* Next outer n
15dd0 61 6d 65 20 63 6f 6e 74 65 78 74 2e 20 20 4e 55 ame context. NU
15de0 4c 4c 20 66 6f 72 20 6f 75 74 65 72 6d 6f 73 74 LL for outermost
15df0 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b 20 */. int nRef;
15e00 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
15e10 6d 62 65 72 20 6f 66 20 6e 61 6d 65 73 20 72 65 mber of names re
15e20 73 6f 6c 76 65 64 20 62 79 20 74 68 69 73 20 63 solved by this c
15e30 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 ontext */. int
15e40 6e 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 nErr;
15e50 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 72 /* Number of er
15e60 72 6f 72 73 20 65 6e 63 6f 75 6e 74 65 72 65 64 rors encountered
15e70 20 77 68 69 6c 65 20 72 65 73 6f 6c 76 69 6e 67 while resolving
15e80 20 6e 61 6d 65 73 20 2a 2f 0a 20 20 75 38 20 6e names */. u8 n
15e90 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 cFlags;
15ea0 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 /* Zero or more
15eb0 20 4e 43 5f 2a 20 66 6c 61 67 73 20 64 65 66 69 NC_* flags defi
15ec0 6e 65 64 20 62 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a ned below */.};.
15ed0 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 ./*.** Allowed v
15ee0 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 4e 61 alues for the Na
15ef0 6d 65 43 6f 6e 74 65 78 74 2c 20 6e 63 46 6c 61 meContext, ncFla
15f00 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 64 65 gs field..*/.#de
15f10 66 69 6e 65 20 4e 43 5f 41 6c 6c 6f 77 41 67 67 fine NC_AllowAgg
15f20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 41 67 67 0x01 /* Agg
15f30 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 regate functions
15f40 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 68 65 72 are allowed her
15f50 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f e */.#define NC_
15f60 48 61 73 41 67 67 20 20 20 20 30 78 30 32 20 20 HasAgg 0x02
15f70 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 65 /* One or more
15f80 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 aggregate funct
15f90 69 6f 6e 73 20 73 65 65 6e 20 2a 2f 0a 23 64 65 ions seen */.#de
15fa0 66 69 6e 65 20 4e 43 5f 49 73 43 68 65 63 6b 20 fine NC_IsCheck
15fb0 20 20 30 78 30 34 20 20 20 20 2f 2a 20 54 72 75 0x04 /* Tru
15fc0 65 20 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 6e e if resolving n
15fd0 61 6d 65 73 20 69 6e 20 61 20 43 48 45 43 4b 20 ames in a CHECK
15fe0 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 64 constraint */.#d
15ff0 65 66 69 6e 65 20 4e 43 5f 49 6e 41 67 67 46 75 efine NC_InAggFu
16000 6e 63 20 30 78 30 38 20 20 20 20 2f 2a 20 54 72 nc 0x08 /* Tr
16010 75 65 20 69 66 20 61 6e 61 6c 79 7a 69 6e 67 20 ue if analyzing
16020 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 61 6e 20 arguments to an
16030 61 67 67 20 66 75 6e 63 20 2a 2f 0a 23 64 65 66 agg func */.#def
16040 69 6e 65 20 4e 43 5f 50 61 72 74 49 64 78 20 20 ine NC_PartIdx
16050 20 30 78 31 30 20 20 20 20 2f 2a 20 54 72 75 65 0x10 /* True
16060 20 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 61 20 if resolving a
16070 70 61 72 74 69 61 6c 20 69 6e 64 65 78 20 57 48 partial index WH
16080 45 52 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e ERE */../*.** An
16090 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
160a0 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
160b0 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 20 61 6c ture contains al
160c0 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a l information.**
160d0 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
160e0 61 74 65 20 63 6f 64 65 20 66 6f 72 20 61 20 73 ate code for a s
160f0 69 6e 67 6c 65 20 53 45 4c 45 43 54 20 73 74 61 ingle SELECT sta
16100 74 65 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 6e 4c tement..**.** nL
16110 69 6d 69 74 20 69 73 20 73 65 74 20 74 6f 20 2d imit is set to -
16120 31 20 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f 1 if there is no
16130 20 4c 49 4d 49 54 20 63 6c 61 75 73 65 2e 20 20 LIMIT clause.
16140 6e 4f 66 66 73 65 74 20 69 73 20 73 65 74 20 74 nOffset is set t
16150 6f 20 30 2e 0a 2a 2a 20 49 66 20 74 68 65 72 65 o 0..** If there
16160 20 69 73 20 61 20 4c 49 4d 49 54 20 63 6c 61 75 is a LIMIT clau
16170 73 65 2c 20 74 68 65 20 70 61 72 73 65 72 20 73 se, the parser s
16180 65 74 73 20 6e 4c 69 6d 69 74 20 74 6f 20 74 68 ets nLimit to th
16190 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 0a 2a e value of the.*
161a0 2a 20 6c 69 6d 69 74 20 61 6e 64 20 6e 4f 66 66 * limit and nOff
161b0 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 set to the value
161c0 20 6f 66 20 74 68 65 20 6f 66 66 73 65 74 20 28 of the offset (
161d0 6f 72 20 30 20 69 66 20 74 68 65 72 65 20 69 73 or 0 if there is
161e0 20 6e 6f 74 0a 2a 2a 20 6f 66 66 73 65 74 29 2e not.** offset).
161f0 20 20 42 75 74 20 6c 61 74 65 72 20 6f 6e 2c 20 But later on,
16200 6e 4c 69 6d 69 74 20 61 6e 64 20 6e 4f 66 66 73 nLimit and nOffs
16210 65 74 20 62 65 63 6f 6d 65 20 74 68 65 20 6d 65 et become the me
16220 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e 73 0a 2a mory locations.*
16230 2a 20 69 6e 20 74 68 65 20 56 44 42 45 20 74 68 * in the VDBE th
16240 61 74 20 72 65 63 6f 72 64 20 74 68 65 20 6c 69 at record the li
16250 6d 69 74 20 61 6e 64 20 6f 66 66 73 65 74 20 63 mit and offset c
16260 6f 75 6e 74 65 72 73 2e 0a 2a 2a 0a 2a 2a 20 61 ounters..**.** a
16270 64 64 72 4f 70 65 6e 45 70 68 6d 5b 5d 20 65 6e ddrOpenEphm[] en
16280 74 72 69 65 73 20 63 6f 6e 74 61 69 6e 20 74 68 tries contain th
16290 65 20 61 64 64 72 65 73 73 20 6f 66 20 4f 50 5f e address of OP_
162a0 4f 70 65 6e 45 70 68 65 6d 65 72 61 6c 20 6f 70 OpenEphemeral op
162b0 63 6f 64 65 73 2e 0a 2a 2a 20 54 68 65 73 65 20 codes..** These
162c0 61 64 64 72 65 73 73 65 73 20 6d 75 73 74 20 62 addresses must b
162d0 65 20 73 74 6f 72 65 64 20 73 6f 20 74 68 61 74 e stored so that
162e0 20 77 65 20 63 61 6e 20 67 6f 20 62 61 63 6b 20 we can go back
162f0 61 6e 64 20 66 69 6c 6c 20 69 6e 0a 2a 2a 20 74 and fill in.** t
16300 68 65 20 50 34 5f 4b 45 59 49 4e 46 4f 20 61 6e he P4_KEYINFO an
16310 64 20 50 32 20 70 61 72 61 6d 65 74 65 72 73 20 d P2 parameters
16320 6c 61 74 65 72 2e 20 20 4e 65 69 74 68 65 72 20 later. Neither
16330 74 68 65 20 4b 65 79 49 6e 66 6f 20 6e 6f 72 0a the KeyInfo nor.
16340 2a 2a 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 ** the number of
16350 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 50 32 20 63 columns in P2 c
16360 61 6e 20 62 65 20 63 6f 6d 70 75 74 65 64 20 61 an be computed a
16370 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 0a t the same time.
16380 2a 2a 20 61 73 20 74 68 65 20 4f 50 5f 4f 70 65 ** as the OP_Ope
16390 6e 45 70 68 6d 20 69 6e 73 74 72 75 63 74 69 6f nEphm instructio
163a0 6e 20 69 73 20 63 6f 64 65 64 20 62 65 63 61 75 n is coded becau
163b0 73 65 20 6e 6f 74 0a 2a 2a 20 65 6e 6f 75 67 68 se not.** enough
163c0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f information abo
163d0 75 74 20 74 68 65 20 63 6f 6d 70 6f 75 6e 64 20 ut the compound
163e0 71 75 65 72 79 20 69 73 20 6b 6e 6f 77 6e 20 61 query is known a
163f0 74 20 74 68 61 74 20 70 6f 69 6e 74 2e 0a 2a 2a t that point..**
16400 20 54 68 65 20 4b 65 79 49 6e 66 6f 20 66 6f 72 The KeyInfo for
16410 20 61 64 64 72 4f 70 65 6e 54 72 61 6e 5b 30 5d addrOpenTran[0]
16420 20 61 6e 64 20 5b 31 5d 20 63 6f 6e 74 61 69 6e and [1] contain
16430 73 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 s collating sequ
16440 65 6e 63 65 73 0a 2a 2a 20 66 6f 72 20 74 68 65 ences.** for the
16450 20 72 65 73 75 6c 74 20 73 65 74 2e 20 20 54 68 result set. Th
16460 65 20 4b 65 79 49 6e 66 6f 20 66 6f 72 20 61 64 e KeyInfo for ad
16470 64 72 4f 70 65 6e 45 70 68 6d 5b 32 5d 20 63 6f drOpenEphm[2] co
16480 6e 74 61 69 6e 73 20 63 6f 6c 6c 61 74 69 6e 67 ntains collating
16490 0a 2a 2a 20 73 65 71 75 65 6e 63 65 73 20 66 6f .** sequences fo
164a0 72 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 r the ORDER BY c
164b0 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 lause..*/.struct
164c0 20 53 65 6c 65 63 74 20 7b 0a 20 20 45 78 70 72 Select {. Expr
164d0 4c 69 73 74 20 2a 70 45 4c 69 73 74 3b 20 20 20 List *pEList;
164e0 20 20 20 2f 2a 20 54 68 65 20 66 69 65 6c 64 73 /* The fields
164f0 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 2a of the result *
16500 2f 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 20 20 /. u8 op;
16510 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e /* On
16520 65 20 6f 66 3a 20 54 4b 5f 55 4e 49 4f 4e 20 54 e of: TK_UNION T
16530 4b 5f 41 4c 4c 20 54 4b 5f 49 4e 54 45 52 53 45 K_ALL TK_INTERSE
16540 43 54 20 54 4b 5f 45 58 43 45 50 54 20 2a 2f 0a CT TK_EXCEPT */.
16550 20 20 75 31 36 20 73 65 6c 46 6c 61 67 73 3b 20 u16 selFlags;
16560 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 72 69 /* Vari
16570 6f 75 73 20 53 46 5f 2a 20 76 61 6c 75 65 73 20 ous SF_* values
16580 2a 2f 0a 20 20 69 6e 74 20 69 4c 69 6d 69 74 2c */. int iLimit,
16590 20 69 4f 66 66 73 65 74 3b 20 20 20 2f 2a 20 4d iOffset; /* M
165a0 65 6d 6f 72 79 20 72 65 67 69 73 74 65 72 73 20 emory registers
165b0 68 6f 6c 64 69 6e 67 20 4c 49 4d 49 54 20 26 20 holding LIMIT &
165c0 4f 46 46 53 45 54 20 63 6f 75 6e 74 65 72 73 20 OFFSET counters
165d0 2a 2f 0a 20 20 69 6e 74 20 61 64 64 72 4f 70 65 */. int addrOpe
165e0 6e 45 70 68 6d 5b 33 5d 3b 20 20 20 2f 2a 20 4f nEphm[3]; /* O
165f0 50 5f 4f 70 65 6e 45 70 68 65 6d 20 6f 70 63 6f P_OpenEphem opco
16600 64 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 74 des related to t
16610 68 69 73 20 73 65 6c 65 63 74 20 2a 2f 0a 20 20 his select */.
16620 75 36 34 20 6e 53 65 6c 65 63 74 52 6f 77 3b 20 u64 nSelectRow;
16630 20 20 20 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 /* Estima
16640 74 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 ted number of re
16650 73 75 6c 74 20 72 6f 77 73 20 2a 2f 0a 20 20 53 sult rows */. S
16660 72 63 4c 69 73 74 20 2a 70 53 72 63 3b 20 20 20 rcList *pSrc;
16670 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 52 4f /* The FRO
16680 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 M clause */. Ex
16690 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 20 pr *pWhere;
166a0 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 /* The WHER
166b0 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 E clause */. Ex
166c0 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 79 prList *pGroupBy
166d0 3b 20 20 20 20 2f 2a 20 54 68 65 20 47 52 4f 55 ; /* The GROU
166e0 50 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 P BY clause */.
166f0 20 45 78 70 72 20 2a 70 48 61 76 69 6e 67 3b 20 Expr *pHaving;
16700 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 48 /* The H
16710 41 56 49 4e 47 20 63 6c 61 75 73 65 20 2a 2f 0a AVING clause */.
16720 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 64 ExprList *pOrd
16730 65 72 42 79 3b 20 20 20 20 2f 2a 20 54 68 65 20 erBy; /* The
16740 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 ORDER BY clause
16750 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 50 72 */. Select *pPr
16760 69 6f 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 50 ior; /* P
16770 72 69 6f 72 20 73 65 6c 65 63 74 20 69 6e 20 61 rior select in a
16780 20 63 6f 6d 70 6f 75 6e 64 20 73 65 6c 65 63 74 compound select
16790 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 statement */.
167a0 53 65 6c 65 63 74 20 2a 70 4e 65 78 74 3b 20 20 Select *pNext;
167b0 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 73 /* Next s
167c0 65 6c 65 63 74 20 74 6f 20 74 68 65 20 6c 65 66 elect to the lef
167d0 74 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 t in a compound
167e0 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 52 69 */. Select *pRi
167f0 67 68 74 6d 6f 73 74 3b 20 20 20 20 2f 2a 20 52 ghtmost; /* R
16800 69 67 68 74 2d 6d 6f 73 74 20 73 65 6c 65 63 74 ight-most select
16810 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 73 in a compound s
16820 65 6c 65 63 74 20 73 74 61 74 65 6d 65 6e 74 20 elect statement
16830 2a 2f 0a 20 20 45 78 70 72 20 2a 70 4c 69 6d 69 */. Expr *pLimi
16840 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c t; /* L
16850 49 4d 49 54 20 65 78 70 72 65 73 73 69 6f 6e 2e IMIT expression.
16860 20 4e 55 4c 4c 20 6d 65 61 6e 73 20 6e 6f 74 20 NULL means not
16870 75 73 65 64 2e 20 2a 2f 0a 20 20 45 78 70 72 20 used. */. Expr
16880 2a 70 4f 66 66 73 65 74 3b 20 20 20 20 20 20 20 *pOffset;
16890 20 20 2f 2a 20 4f 46 46 53 45 54 20 65 78 70 72 /* OFFSET expr
168a0 65 73 73 69 6f 6e 2e 20 4e 55 4c 4c 20 6d 65 61 ession. NULL mea
168b0 6e 73 20 6e 6f 74 20 75 73 65 64 2e 20 2a 2f 0a ns not used. */.
168c0 20 20 57 69 74 68 20 2a 70 57 69 74 68 3b 20 20 With *pWith;
168d0 20 20 20 20 20 20 20 20 20 2f 2a 20 57 49 54 48 /* WITH
168e0 20 63 6c 61 75 73 65 20 61 74 74 61 63 68 65 64 clause attached
168f0 20 74 6f 20 74 68 69 73 20 73 65 6c 65 63 74 2e to this select.
16900 20 4f 72 20 4e 55 4c 4c 2e 20 2a 2f 0a 7d 3b 0a Or NULL. */.};.
16910 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 ./*.** Allowed v
16920 61 6c 75 65 73 20 66 6f 72 20 53 65 6c 65 63 74 alues for Select
16930 2e 73 65 6c 46 6c 61 67 73 2e 20 20 54 68 65 20 .selFlags. The
16940 22 53 46 22 20 70 72 65 66 69 78 20 73 74 61 6e "SF" prefix stan
16950 64 73 20 66 6f 72 0a 2a 2a 20 22 53 65 6c 65 63 ds for.** "Selec
16960 74 20 46 6c 61 67 22 2e 0a 2a 2f 0a 23 64 65 66 t Flag"..*/.#def
16970 69 6e 65 20 53 46 5f 44 69 73 74 69 6e 63 74 20 ine SF_Distinct
16980 20 20 20 20 20 20 20 30 78 30 30 30 31 20 20 2f 0x0001 /
16990 2a 20 4f 75 74 70 75 74 20 73 68 6f 75 6c 64 20 * Output should
169a0 62 65 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 23 be DISTINCT */.#
169b0 64 65 66 69 6e 65 20 53 46 5f 52 65 73 6f 6c 76 define SF_Resolv
169c0 65 64 20 20 20 20 20 20 20 20 30 78 30 30 30 32 ed 0x0002
169d0 20 20 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 73 /* Identifiers
169e0 20 68 61 76 65 20 62 65 65 6e 20 72 65 73 6f 6c have been resol
169f0 76 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ved */.#define S
16a00 46 5f 41 67 67 72 65 67 61 74 65 20 20 20 20 20 F_Aggregate
16a10 20 20 30 78 30 30 30 34 20 20 2f 2a 20 43 6f 6e 0x0004 /* Con
16a20 74 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 20 tains aggregate
16a30 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 functions */.#de
16a40 66 69 6e 65 20 53 46 5f 55 73 65 73 45 70 68 65 fine SF_UsesEphe
16a50 6d 65 72 61 6c 20 20 20 30 78 30 30 30 38 20 20 meral 0x0008
16a60 2f 2a 20 55 73 65 73 20 74 68 65 20 4f 70 65 6e /* Uses the Open
16a70 45 70 68 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 Ephemeral opcode
16a80 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 45 */.#define SF_E
16a90 78 70 61 6e 64 65 64 20 20 20 20 20 20 20 20 30 xpanded 0
16aa0 78 30 30 31 30 20 20 2f 2a 20 73 71 6c 69 74 65 x0010 /* sqlite
16ab0 33 53 65 6c 65 63 74 45 78 70 61 6e 64 28 29 20 3SelectExpand()
16ac0 63 61 6c 6c 65 64 20 6f 6e 20 74 68 69 73 20 2a called on this *
16ad0 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 48 61 73 /.#define SF_Has
16ae0 54 79 70 65 49 6e 66 6f 20 20 20 20 20 30 78 30 TypeInfo 0x0
16af0 30 32 30 20 20 2f 2a 20 46 52 4f 4d 20 73 75 62 020 /* FROM sub
16b00 71 75 65 72 69 65 73 20 68 61 76 65 20 54 61 62 queries have Tab
16b10 6c 65 20 6d 65 74 61 64 61 74 61 20 2a 2f 0a 23 le metadata */.#
16b20 64 65 66 69 6e 65 20 53 46 5f 55 73 65 53 6f 72 define SF_UseSor
16b30 74 65 72 20 20 20 20 20 20 20 30 78 30 30 34 30 ter 0x0040
16b40 20 20 2f 2a 20 53 6f 72 74 20 75 73 69 6e 67 20 /* Sort using
16b50 61 20 73 6f 72 74 65 72 20 2a 2f 0a 23 64 65 66 a sorter */.#def
16b60 69 6e 65 20 53 46 5f 56 61 6c 75 65 73 20 20 20 ine SF_Values
16b70 20 20 20 20 20 20 20 30 78 30 30 38 30 20 20 2f 0x0080 /
16b80 2a 20 53 79 6e 74 68 65 73 69 7a 65 64 20 66 72 * Synthesized fr
16b90 6f 6d 20 56 41 4c 55 45 53 20 63 6c 61 75 73 65 om VALUES clause
16ba0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d */.#define SF_M
16bb0 61 74 65 72 69 61 6c 69 7a 65 20 20 20 20 20 30 aterialize 0
16bc0 78 30 31 30 30 20 20 2f 2a 20 46 6f 72 63 65 20 x0100 /* Force
16bd0 6d 61 74 65 72 69 61 6c 69 7a 61 74 69 6f 6e 20 materialization
16be0 6f 66 20 76 69 65 77 73 20 2a 2f 0a 23 64 65 66 of views */.#def
16bf0 69 6e 65 20 53 46 5f 4e 65 73 74 65 64 46 72 6f ine SF_NestedFro
16c00 6d 20 20 20 20 20 20 30 78 30 32 30 30 20 20 2f m 0x0200 /
16c10 2a 20 50 61 72 74 20 6f 66 20 61 20 70 61 72 65 * Part of a pare
16c20 6e 74 68 65 73 69 7a 65 64 20 46 52 4f 4d 20 63 nthesized FROM c
16c30 6c 61 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 lause */.#define
16c40 20 53 46 5f 4d 61 79 62 65 43 6f 6e 76 65 72 74 SF_MaybeConvert
16c50 20 20 20 20 30 78 30 34 30 30 20 20 2f 2a 20 4e 0x0400 /* N
16c60 65 65 64 20 63 6f 6e 76 65 72 74 43 6f 6d 70 6f eed convertCompo
16c70 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 75 undSelectToSubqu
16c80 65 72 79 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 ery() */.#define
16c90 20 53 46 5f 52 65 63 75 72 73 69 76 65 20 20 20 SF_Recursive
16ca0 20 20 20 20 30 78 30 38 30 30 20 20 2f 2a 20 54 0x0800 /* T
16cb0 68 65 20 72 65 63 75 72 73 69 76 65 20 70 61 72 he recursive par
16cc0 74 20 6f 66 20 61 20 72 65 63 75 72 73 69 76 65 t of a recursive
16cd0 20 43 54 45 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 CTE */.../*.**
16ce0 54 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 61 The results of a
16cf0 20 53 45 4c 45 43 54 20 63 61 6e 20 62 65 20 64 SELECT can be d
16d00 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 73 65 istributed in se
16d10 76 65 72 61 6c 20 77 61 79 73 2c 20 61 73 20 64 veral ways, as d
16d20 65 66 69 6e 65 64 0a 2a 2a 20 62 79 20 6f 6e 65 efined.** by one
16d30 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
16d40 67 20 6d 61 63 72 6f 73 2e 20 20 54 68 65 20 22 g macros. The "
16d50 53 52 54 22 20 70 72 65 66 69 78 20 6d 65 61 6e SRT" prefix mean
16d60 73 20 22 53 45 4c 45 43 54 20 52 65 73 75 6c 74 s "SELECT Result
16d70 0a 2a 2a 20 54 79 70 65 22 2e 0a 2a 2a 0a 2a 2a .** Type"..**.**
16d80 20 20 20 20 20 53 52 54 5f 55 6e 69 6f 6e 20 20 SRT_Union
16d90 20 20 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c Store resul
16da0 74 73 20 61 73 20 61 20 6b 65 79 20 69 6e 20 61 ts as a key in a
16db0 20 74 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 78 temporary index
16dc0 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 .**
16dd0 20 20 20 20 20 20 20 20 20 69 64 65 6e 74 69 66 identif
16de0 69 65 64 20 62 79 20 70 44 65 73 74 2d 3e 69 53 ied by pDest->iS
16df0 44 50 61 72 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 DParm..**.**
16e00 20 53 52 54 5f 45 78 63 65 70 74 20 20 20 20 20 SRT_Except
16e10 20 52 65 6d 6f 76 65 20 72 65 73 75 6c 74 73 20 Remove results
16e20 66 72 6f 6d 20 74 68 65 20 74 65 6d 70 6f 72 61 from the tempora
16e30 72 79 20 69 6e 64 65 78 20 70 44 65 73 74 2d 3e ry index pDest->
16e40 69 53 44 50 61 72 6d 2e 0a 2a 2a 0a 2a 2a 20 20 iSDParm..**.**
16e50 20 20 20 53 52 54 5f 45 78 69 73 74 73 20 20 20 SRT_Exists
16e60 20 20 20 53 74 6f 72 65 20 61 20 31 20 69 6e 20 Store a 1 in
16e70 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 70 44 65 73 memory cell pDes
16e80 74 2d 3e 69 53 44 50 61 72 6d 20 69 66 20 74 68 t->iSDParm if th
16e90 65 20 72 65 73 75 6c 74 0a 2a 2a 20 20 20 20 20 e result.**
16ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16eb0 73 65 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 set is not empty
16ec0 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
16ed0 44 69 73 63 61 72 64 20 20 20 20 20 54 68 72 6f Discard Thro
16ee0 77 20 74 68 65 20 72 65 73 75 6c 74 73 20 61 77 w the results aw
16ef0 61 79 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 ay. This is use
16f00 64 20 62 79 20 53 45 4c 45 43 54 0a 2a 2a 20 20 d by SELECT.**
16f10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16f20 20 20 20 73 74 61 74 65 6d 65 6e 74 73 20 77 69 statements wi
16f30 74 68 69 6e 20 74 72 69 67 67 65 72 73 20 77 68 thin triggers wh
16f40 6f 73 65 20 6f 6e 6c 79 20 70 75 72 70 6f 73 65 ose only purpose
16f50 20 69 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 is.**
16f60 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 73 the s
16f70 69 64 65 2d 65 66 66 65 63 74 73 20 6f 66 20 66 ide-effects of f
16f80 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 unctions..**.**
16f90 41 6c 6c 20 6f 66 20 74 68 65 20 61 62 6f 76 65 All of the above
16fa0 20 61 72 65 20 66 72 65 65 20 74 6f 20 69 67 6e are free to ign
16fb0 6f 72 65 20 74 68 65 69 72 20 4f 52 44 45 52 20 ore their ORDER
16fc0 42 59 20 63 6c 61 75 73 65 2e 20 54 68 6f 73 65 BY clause. Those
16fd0 20 74 68 61 74 0a 2a 2a 20 66 6f 6c 6c 6f 77 20 that.** follow
16fe0 6d 75 73 74 20 68 6f 6e 6f 72 20 74 68 65 20 4f must honor the O
16ff0 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2e 0a RDER BY clause..
17000 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 4f 75 **.** SRT_Ou
17010 74 70 75 74 20 20 20 20 20 20 47 65 6e 65 72 61 tput Genera
17020 74 65 20 61 20 72 6f 77 20 6f 66 20 6f 75 74 70 te a row of outp
17030 75 74 20 28 75 73 69 6e 67 20 74 68 65 20 4f 50 ut (using the OP
17040 5f 52 65 73 75 6c 74 52 6f 77 0a 2a 2a 20 20 20 _ResultRow.**
17050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17060 20 20 6f 70 63 6f 64 65 29 20 66 6f 72 20 65 61 opcode) for ea
17070 63 68 20 72 6f 77 20 69 6e 20 74 68 65 20 72 65 ch row in the re
17080 73 75 6c 74 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 sult set..**.**
17090 20 20 20 20 53 52 54 5f 4d 65 6d 20 20 20 20 20 SRT_Mem
170a0 20 20 20 20 4f 6e 6c 79 20 76 61 6c 69 64 20 69 Only valid i
170b0 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 f the result is
170c0 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2e a single column.
170d0 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
170e0 20 20 20 20 20 20 20 20 53 74 6f 72 65 20 74 68 Store th
170f0 65 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e 20 6f e first column o
17100 66 20 74 68 65 20 66 69 72 73 74 20 72 65 73 75 f the first resu
17110 6c 74 20 72 6f 77 0a 2a 2a 20 20 20 20 20 20 20 lt row.**
17120 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e in
17130 20 72 65 67 69 73 74 65 72 20 70 44 65 73 74 2d register pDest-
17140 3e 69 53 44 50 61 72 6d 20 74 68 65 6e 20 61 62 >iSDParm then ab
17150 61 6e 64 6f 6e 20 74 68 65 20 72 65 73 74 0a 2a andon the rest.*
17160 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
17170 20 20 20 20 20 20 6f 66 20 74 68 65 20 71 75 65 of the que
17180 72 79 2e 20 20 54 68 69 73 20 64 65 73 74 69 6e ry. This destin
17190 61 74 69 6f 6e 20 69 6d 70 6c 69 65 73 20 22 4c ation implies "L
171a0 49 4d 49 54 20 31 22 2e 0a 2a 2a 0a 2a 2a 20 20 IMIT 1"..**.**
171b0 20 20 20 53 52 54 5f 53 65 74 20 20 20 20 20 20 SRT_Set
171c0 20 20 20 54 68 65 20 72 65 73 75 6c 74 20 6d 75 The result mu
171d0 73 74 20 62 65 20 61 20 73 69 6e 67 6c 65 20 63 st be a single c
171e0 6f 6c 75 6d 6e 2e 20 20 53 74 6f 72 65 20 65 61 olumn. Store ea
171f0 63 68 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 ch.**
17200 20 20 20 20 20 20 20 20 20 20 72 6f 77 20 6f 66 row of
17210 20 72 65 73 75 6c 74 20 61 73 20 74 68 65 20 6b result as the k
17220 65 79 20 69 6e 20 74 61 62 6c 65 20 70 44 65 73 ey in table pDes
17230 74 2d 3e 69 53 44 50 61 72 6d 2e 20 0a 2a 2a 20 t->iSDParm. .**
17240 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17250 20 20 20 20 41 70 70 6c 79 20 74 68 65 20 61 66 Apply the af
17260 66 69 6e 69 74 79 20 70 44 65 73 74 2d 3e 61 66 finity pDest->af
17270 66 53 64 73 74 20 62 65 66 6f 72 65 20 73 74 6f fSdst before sto
17280 72 69 6e 67 0a 2a 2a 20 20 20 20 20 20 20 20 20 ring.**
17290 20 20 20 20 20 20 20 20 20 20 20 20 72 65 73 75 resu
172a0 6c 74 73 2e 20 20 55 73 65 64 20 74 6f 20 69 6d lts. Used to im
172b0 70 6c 65 6d 65 6e 74 20 22 49 4e 20 28 53 45 4c plement "IN (SEL
172c0 45 43 54 20 2e 2e 2e 29 22 2e 0a 2a 2a 0a 2a 2a ECT ...)"..**.**
172d0 20 20 20 20 20 53 52 54 5f 54 61 62 6c 65 20 20 SRT_Table
172e0 20 20 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c Store resul
172f0 74 73 20 69 6e 20 74 65 6d 70 6f 72 61 72 79 20 ts in temporary
17300 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 table pDest->iSD
17310 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 Parm..**
17320 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68 69 Thi
17330 73 20 69 73 20 6c 69 6b 65 20 53 52 54 5f 45 70 s is like SRT_Ep
17340 68 65 6d 54 61 62 20 65 78 63 65 70 74 20 74 68 hemTab except th
17350 61 74 20 74 68 65 20 74 61 62 6c 65 0a 2a 2a 20 at the table.**
17360 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17370 20 20 20 20 69 73 20 61 73 73 75 6d 65 64 20 74 is assumed t
17380 6f 20 61 6c 72 65 61 64 79 20 62 65 20 6f 70 65 o already be ope
17390 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 n..**.** SRT
173a0 5f 45 70 68 65 6d 54 61 62 20 20 20 20 43 72 65 _EphemTab Cre
173b0 61 74 65 20 61 6e 20 74 65 6d 70 6f 72 61 72 79 ate an temporary
173c0 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 table pDest->iS
173d0 44 50 61 72 6d 20 61 6e 64 20 73 74 6f 72 65 0a DParm and store.
173e0 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
173f0 20 20 20 20 20 20 20 74 68 65 20 72 65 73 75 6c the resul
17400 74 20 74 68 65 72 65 2e 20 54 68 65 20 63 75 72 t there. The cur
17410 73 6f 72 20 69 73 20 6c 65 66 74 20 6f 70 65 6e sor is left open
17420 20 61 66 74 65 72 0a 2a 2a 20 20 20 20 20 20 20 after.**
17430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
17440 74 75 72 6e 69 6e 67 2e 20 20 54 68 69 73 20 69 turning. This i
17450 73 20 6c 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 s like SRT_Table
17460 20 65 78 63 65 70 74 20 74 68 61 74 0a 2a 2a 20 except that.**
17470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17480 20 20 20 20 74 68 69 73 20 64 65 73 74 69 6e 61 this destina
17490 74 69 6f 6e 20 75 73 65 73 20 4f 50 5f 4f 70 65 tion uses OP_Ope
174a0 6e 45 70 68 65 6d 65 72 61 6c 20 74 6f 20 63 72 nEphemeral to cr
174b0 65 61 74 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 eate.**
174c0 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 the
174d0 74 61 62 6c 65 20 66 69 72 73 74 2e 0a 2a 2a 0a table first..**.
174e0 2a 2a 20 20 20 20 20 53 52 54 5f 43 6f 72 6f 75 ** SRT_Corou
174f0 74 69 6e 65 20 20 20 47 65 6e 65 72 61 74 65 20 tine Generate
17500 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 74 68 61 a co-routine tha
17510 74 20 72 65 74 75 72 6e 73 20 61 20 6e 65 77 20 t returns a new
17520 72 6f 77 20 6f 66 0a 2a 2a 20 20 20 20 20 20 20 row of.**
17530 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65 re
17540 73 75 6c 74 73 20 65 61 63 68 20 74 69 6d 65 20 sults each time
17550 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 20 it is invoked.
17560 54 68 65 20 65 6e 74 72 79 20 70 6f 69 6e 74 0a The entry point.
17570 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
17580 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 63 6f of the co
17590 2d 72 6f 75 74 69 6e 65 20 69 73 20 73 74 6f 72 -routine is stor
175a0 65 64 20 69 6e 20 72 65 67 69 73 74 65 72 20 70 ed in register p
175b0 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 0a 2a 2a Dest->iSDParm.**
175c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
175d0 20 20 20 20 20 61 6e 64 20 74 68 65 20 72 65 73 and the res
175e0 75 6c 74 20 72 6f 77 20 69 73 20 73 74 6f 72 65 ult row is store
175f0 64 20 69 6e 20 70 44 65 73 74 2d 3e 6e 44 65 73 d in pDest->nDes
17600 74 20 72 65 67 69 73 74 65 72 73 0a 2a 2a 20 20 t registers.**
17610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17620 20 20 20 73 74 61 72 74 69 6e 67 20 77 69 74 68 starting with
17630 20 70 44 65 73 74 2d 3e 69 53 64 73 74 2e 0a 2a pDest->iSdst..*
17640 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 44 69 73 *.** SRT_Dis
17650 74 54 61 62 6c 65 20 20 20 53 74 6f 72 65 20 72 tTable Store r
17660 65 73 75 6c 74 73 20 69 6e 20 61 20 74 65 6d 70 esults in a temp
17670 6f 72 61 72 79 20 74 61 62 6c 65 20 70 44 65 73 orary table pDes
17680 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 20 t->iSDParm..**
17690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
176a0 20 20 20 42 75 74 20 61 6c 73 6f 20 75 73 65 20 But also use
176b0 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 20 temporary table
176c0 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2b 31 pDest->iSDParm+1
176d0 20 61 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 as.**
176e0 20 20 20 20 20 20 20 20 20 20 20 61 20 72 65 63 a rec
176f0 6f 72 64 20 6f 66 20 61 6c 6c 20 70 72 69 6f 72 ord of all prior
17700 20 72 65 73 75 6c 74 73 20 61 6e 64 20 69 67 6e results and ign
17710 6f 72 65 20 61 6e 79 20 64 75 70 6c 69 63 61 74 ore any duplicat
17720 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
17730 20 20 20 20 20 20 20 20 20 72 6f 77 73 2e 20 20 rows.
17740 4e 61 6d 65 20 6d 65 61 6e 73 3a 20 20 22 44 69 Name means: "Di
17750 73 74 69 6e 63 74 20 54 61 62 6c 65 22 2e 0a 2a stinct Table"..*
17760 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 55 6e /.#define SRT_Un
17770 69 6f 6e 20 20 20 20 20 20 20 20 31 20 20 2f 2a ion 1 /*
17780 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 73 Store result as
17790 20 6b 65 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 keys in an inde
177a0 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 x */.#define SRT
177b0 5f 45 78 63 65 70 74 20 20 20 20 20 20 20 32 20 _Except 2
177c0 20 2f 2a 20 52 65 6d 6f 76 65 20 72 65 73 75 6c /* Remove resul
177d0 74 20 66 72 6f 6d 20 61 20 55 4e 49 4f 4e 20 69 t from a UNION i
177e0 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ndex */.#define
177f0 53 52 54 5f 45 78 69 73 74 73 20 20 20 20 20 20 SRT_Exists
17800 20 33 20 20 2f 2a 20 53 74 6f 72 65 20 31 20 69 3 /* Store 1 i
17810 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 f the result is
17820 6e 6f 74 20 65 6d 70 74 79 20 2a 2f 0a 23 64 65 not empty */.#de
17830 66 69 6e 65 20 53 52 54 5f 44 69 73 63 61 72 64 fine SRT_Discard
17840 20 20 20 20 20 20 34 20 20 2f 2a 20 44 6f 20 6e 4 /* Do n
17850 6f 74 20 73 61 76 65 20 74 68 65 20 72 65 73 75 ot save the resu
17860 6c 74 73 20 61 6e 79 77 68 65 72 65 20 2a 2f 0a lts anywhere */.
17870 0a 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 42 59 ./* The ORDER BY
17880 20 63 6c 61 75 73 65 20 69 73 20 69 67 6e 6f 72 clause is ignor
17890 65 64 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 ed for all of th
178a0 65 20 61 62 6f 76 65 20 2a 2f 0a 23 64 65 66 69 e above */.#defi
178b0 6e 65 20 49 67 6e 6f 72 61 62 6c 65 4f 72 64 65 ne IgnorableOrde
178c0 72 62 79 28 58 29 20 28 28 58 2d 3e 65 44 65 73 rby(X) ((X->eDes
178d0 74 29 3c 3d 53 52 54 5f 44 69 73 63 61 72 64 29 t)<=SRT_Discard)
178e0 0a 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 4f 75 ..#define SRT_Ou
178f0 74 70 75 74 20 20 20 20 20 20 20 35 20 20 2f 2a tput 5 /*
17900 20 4f 75 74 70 75 74 20 65 61 63 68 20 72 6f 77 Output each row
17910 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a 23 64 of result */.#d
17920 65 66 69 6e 65 20 53 52 54 5f 4d 65 6d 20 20 20 efine SRT_Mem
17930 20 20 20 20 20 20 20 36 20 20 2f 2a 20 53 74 6f 6 /* Sto
17940 72 65 20 72 65 73 75 6c 74 20 69 6e 20 61 20 6d re result in a m
17950 65 6d 6f 72 79 20 63 65 6c 6c 20 2a 2f 0a 23 64 emory cell */.#d
17960 65 66 69 6e 65 20 53 52 54 5f 53 65 74 20 20 20 efine SRT_Set
17970 20 20 20 20 20 20 20 37 20 20 2f 2a 20 53 74 6f 7 /* Sto
17980 72 65 20 72 65 73 75 6c 74 73 20 61 73 20 6b 65 re results as ke
17990 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 2a ys in an index *
179a0 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 54 61 /.#define SRT_Ta
179b0 62 6c 65 20 20 20 20 20 20 20 20 38 20 20 2f 2a ble 8 /*
179c0 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 73 Store result as
179d0 20 64 61 74 61 20 77 69 74 68 20 61 6e 20 61 75 data with an au
179e0 74 6f 6d 61 74 69 63 20 72 6f 77 69 64 20 2a 2f tomatic rowid */
179f0 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 70 68 .#define SRT_Eph
17a00 65 6d 54 61 62 20 20 20 20 20 39 20 20 2f 2a 20 emTab 9 /*
17a10 43 72 65 61 74 65 20 74 72 61 6e 73 69 65 6e 74 Create transient
17a20 20 74 61 62 20 61 6e 64 20 73 74 6f 72 65 20 6c tab and store l
17a30 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 20 2a 2f ike SRT_Table */
17a40 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 43 6f 72 .#define SRT_Cor
17a50 6f 75 74 69 6e 65 20 20 20 31 30 20 20 2f 2a 20 outine 10 /*
17a60 47 65 6e 65 72 61 74 65 20 61 20 73 69 6e 67 6c Generate a singl
17a70 65 20 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 20 e row of result
17a80 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 44 */.#define SRT_D
17a90 69 73 74 54 61 62 6c 65 20 20 20 31 31 20 20 2f istTable 11 /
17aa0 2a 20 4c 69 6b 65 20 53 52 54 5f 54 41 42 4c 45 * Like SRT_TABLE
17ab0 2c 20 62 75 74 20 75 6e 69 71 75 65 20 72 65 73 , but unique res
17ac0 75 6c 74 73 20 6f 6e 6c 79 20 2a 2f 0a 0a 2f 2a ults only */../*
17ad0 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
17ae0 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 74 20 64 of this object d
17af0 65 73 63 72 69 62 65 73 20 77 68 65 72 65 20 74 escribes where t
17b00 6f 20 70 75 74 20 6f 66 20 74 68 65 20 72 65 73 o put of the res
17b10 75 6c 74 73 20 6f 66 0a 2a 2a 20 61 20 53 45 4c ults of.** a SEL
17b20 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a ECT statement..*
17b30 2f 0a 73 74 72 75 63 74 20 53 65 6c 65 63 74 44 /.struct SelectD
17b40 65 73 74 20 7b 0a 20 20 75 38 20 65 44 65 73 74 est {. u8 eDest
17b50 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 48 6f 77 ; /* How
17b60 20 74 6f 20 64 69 73 70 6f 73 65 20 6f 66 20 74 to dispose of t
17b70 68 65 20 72 65 73 75 6c 74 73 2e 20 20 4f 6e 20 he results. On
17b80 6f 66 20 53 52 54 5f 2a 20 61 62 6f 76 65 2e 20 of SRT_* above.
17b90 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 53 64 73 */. char affSds
17ba0 74 3b 20 20 20 20 20 2f 2a 20 41 66 66 69 6e 69 t; /* Affini
17bb0 74 79 20 75 73 65 64 20 77 68 65 6e 20 65 44 65 ty used when eDe
17bc0 73 74 3d 3d 53 52 54 5f 53 65 74 20 2a 2f 0a 20 st==SRT_Set */.
17bd0 20 69 6e 74 20 69 53 44 50 61 72 6d 3b 20 20 20 int iSDParm;
17be0 20 20 20 2f 2a 20 41 20 70 61 72 61 6d 65 74 65 /* A paramete
17bf0 72 20 75 73 65 64 20 62 79 20 74 68 65 20 65 44 r used by the eD
17c00 65 73 74 20 64 69 73 70 6f 73 61 6c 20 6d 65 74 est disposal met
17c10 68 6f 64 20 2a 2f 0a 20 20 69 6e 74 20 69 53 64 hod */. int iSd
17c20 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 42 61 st; /* Ba
17c30 73 65 20 72 65 67 69 73 74 65 72 20 77 68 65 72 se register wher
17c40 65 20 72 65 73 75 6c 74 73 20 61 72 65 20 77 72 e results are wr
17c50 69 74 74 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e itten */. int n
17c60 53 64 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 Sdst; /*
17c70 4e 75 6d 62 65 72 20 6f 66 20 72 65 67 69 73 74 Number of regist
17c80 65 72 73 20 61 6c 6c 6f 63 61 74 65 64 20 2a 2f ers allocated */
17c90 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e .};../*.** Durin
17ca0 67 20 63 6f 64 65 20 67 65 6e 65 72 61 74 69 6f g code generatio
17cb0 6e 20 6f 66 20 73 74 61 74 65 6d 65 6e 74 73 20 n of statements
17cc0 74 68 61 74 20 64 6f 20 69 6e 73 65 72 74 73 20 that do inserts
17cd0 69 6e 74 6f 20 41 55 54 4f 49 4e 43 52 45 4d 45 into AUTOINCREME
17ce0 4e 54 20 0a 2a 2a 20 74 61 62 6c 65 73 2c 20 74 NT .** tables, t
17cf0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 he following inf
17d00 6f 72 6d 61 74 69 6f 6e 20 69 73 20 61 74 74 61 ormation is atta
17d10 63 68 65 64 20 74 6f 20 74 68 65 20 54 61 62 6c ched to the Tabl
17d20 65 2e 75 2e 61 75 74 6f 49 6e 63 2e 70 0a 2a 2a e.u.autoInc.p.**
17d30 20 70 6f 69 6e 74 65 72 20 6f 66 20 65 61 63 68 pointer of each
17d40 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 20 74 autoincrement t
17d50 61 62 6c 65 20 74 6f 20 72 65 63 6f 72 64 20 73 able to record s
17d60 6f 6d 65 20 73 69 64 65 20 69 6e 66 6f 72 6d 61 ome side informa
17d70 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 68 65 tion that.** the
17d80 20 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 20 code generator
17d90 6e 65 65 64 73 2e 20 20 57 65 20 68 61 76 65 20 needs. We have
17da0 74 6f 20 6b 65 65 70 20 70 65 72 2d 74 61 62 6c to keep per-tabl
17db0 65 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 0a e autoincrement.
17dc0 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 ** information i
17dd0 6e 20 63 61 73 65 20 69 6e 73 65 72 74 73 20 61 n case inserts a
17de0 72 65 20 64 6f 77 6e 20 77 69 74 68 69 6e 20 74 re down within t
17df0 72 69 67 67 65 72 73 2e 20 20 54 72 69 67 67 65 riggers. Trigge
17e00 72 73 20 64 6f 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 rs do not.** nor
17e10 6d 61 6c 6c 79 20 63 6f 6f 72 64 69 6e 61 74 65 mally coordinate
17e20 20 74 68 65 69 72 20 61 63 74 69 76 69 74 69 65 their activitie
17e30 73 2c 20 62 75 74 20 77 65 20 64 6f 20 6e 65 65 s, but we do nee
17e40 64 20 74 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 d to coordinate
17e50 74 68 65 0a 2a 2a 20 6c 6f 61 64 69 6e 67 20 61 the.** loading a
17e60 6e 64 20 73 61 76 69 6e 67 20 6f 66 20 61 75 74 nd saving of aut
17e70 6f 69 6e 63 72 65 6d 65 6e 74 20 69 6e 66 6f 72 oincrement infor
17e80 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 mation..*/.struc
17e90 74 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 7b 0a t AutoincInfo {.
17ea0 20 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 AutoincInfo *p
17eb0 4e 65 78 74 3b 20 20 20 2f 2a 20 4e 65 78 74 20 Next; /* Next
17ec0 69 6e 66 6f 20 62 6c 6f 63 6b 20 69 6e 20 61 20 info block in a
17ed0 6c 69 73 74 20 6f 66 20 74 68 65 6d 20 61 6c 6c list of them all
17ee0 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 */. Table *pTa
17ef0 62 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 b; /* T
17f00 61 62 6c 65 20 74 68 69 73 20 69 6e 66 6f 20 62 able this info b
17f10 6c 6f 63 6b 20 72 65 66 65 72 73 20 74 6f 20 2a lock refers to *
17f20 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 /. int iDb;
17f30 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
17f40 65 78 20 69 6e 20 73 71 6c 69 74 65 33 2e 61 44 ex in sqlite3.aD
17f50 62 5b 5d 20 6f 66 20 64 61 74 61 62 61 73 65 20 b[] of database
17f60 68 6f 6c 64 69 6e 67 20 70 54 61 62 20 2a 2f 0a holding pTab */.
17f70 20 20 69 6e 74 20 72 65 67 43 74 72 3b 20 20 20 int regCtr;
17f80 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 /* Memor
17f90 79 20 72 65 67 69 73 74 65 72 20 68 6f 6c 64 69 y register holdi
17fa0 6e 67 20 74 68 65 20 72 6f 77 69 64 20 63 6f 75 ng the rowid cou
17fb0 6e 74 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a nter */.};../*.*
17fc0 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 63 6f * Size of the co
17fd0 6c 75 6d 6e 20 63 61 63 68 65 0a 2a 2f 0a 23 69 lumn cache.*/.#i
17fe0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4e 5f 43 fndef SQLITE_N_C
17ff0 4f 4c 43 41 43 48 45 0a 23 20 64 65 66 69 6e 65 OLCACHE.# define
18000 20 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 SQLITE_N_COLCAC
18010 48 45 20 31 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a HE 10.#endif../*
18020 0a 2a 2a 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 .** At least one
18030 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
18040 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
18050 74 75 72 65 20 69 73 20 63 72 65 61 74 65 64 20 ture is created
18060 66 6f 72 20 65 61 63 68 20 0a 2a 2a 20 74 72 69 for each .** tri
18070 67 67 65 72 20 74 68 61 74 20 6d 61 79 20 62 65 gger that may be
18080 20 66 69 72 65 64 20 77 68 69 6c 65 20 70 61 72 fired while par
18090 73 69 6e 67 20 61 6e 20 49 4e 53 45 52 54 2c 20 sing an INSERT,
180a0 55 50 44 41 54 45 20 6f 72 20 44 45 4c 45 54 45 UPDATE or DELETE
180b0 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 2e 20 41 .** statement. A
180c0 6c 6c 20 73 75 63 68 20 6f 62 6a 65 63 74 73 20 ll such objects
180d0 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 are stored in th
180e0 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 68 65 e linked list he
180f0 61 64 65 64 20 61 74 0a 2a 2a 20 50 61 72 73 65 aded at.** Parse
18100 2e 70 54 72 69 67 67 65 72 50 72 67 20 61 6e 64 .pTriggerPrg and
18110 20 64 65 6c 65 74 65 64 20 6f 6e 63 65 20 73 74 deleted once st
18120 61 74 65 6d 65 6e 74 20 63 6f 6d 70 69 6c 61 74 atement compilat
18130 69 6f 6e 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 ion has been.**
18140 63 6f 6d 70 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a completed..**.**
18150 20 41 20 56 64 62 65 20 73 75 62 2d 70 72 6f 67 A Vdbe sub-prog
18160 72 61 6d 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 ram that impleme
18170 6e 74 73 20 74 68 65 20 62 6f 64 79 20 61 6e 64 nts the body and
18180 20 57 48 45 4e 20 63 6c 61 75 73 65 20 6f 66 20 WHEN clause of
18190 74 72 69 67 67 65 72 0a 2a 2a 20 54 72 69 67 67 trigger.** Trigg
181a0 65 72 50 72 67 2e 70 54 72 69 67 67 65 72 2c 20 erPrg.pTrigger,
181b0 61 73 73 75 6d 69 6e 67 20 61 20 64 65 66 61 75 assuming a defau
181c0 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 lt ON CONFLICT c
181d0 6c 61 75 73 65 20 6f 66 0a 2a 2a 20 54 72 69 67 lause of.** Trig
181e0 67 65 72 50 72 67 2e 6f 72 63 6f 6e 66 2c 20 69 gerPrg.orconf, i
181f0 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 s stored in the
18200 54 72 69 67 67 65 72 50 72 67 2e 70 50 72 6f 67 TriggerPrg.pProg
18210 72 61 6d 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2a ram variable..**
18220 20 54 68 65 20 50 61 72 73 65 2e 70 54 72 69 67 The Parse.pTrig
18230 67 65 72 50 72 67 20 6c 69 73 74 20 6e 65 76 65 gerPrg list neve
18240 72 20 63 6f 6e 74 61 69 6e 73 20 74 77 6f 20 65 r contains two e
18250 6e 74 72 69 65 73 20 77 69 74 68 20 74 68 65 20 ntries with the
18260 73 61 6d 65 0a 2a 2a 20 76 61 6c 75 65 73 20 66 same.** values f
18270 6f 72 20 62 6f 74 68 20 70 54 72 69 67 67 65 72 or both pTrigger
18280 20 61 6e 64 20 6f 72 63 6f 6e 66 2e 0a 2a 2a 0a and orconf..**.
18290 2a 2a 20 54 68 65 20 54 72 69 67 67 65 72 50 72 ** The TriggerPr
182a0 67 2e 61 43 6f 6c 6d 61 73 6b 5b 30 5d 20 76 61 g.aColmask[0] va
182b0 72 69 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f riable is set to
182c0 20 61 20 6d 61 73 6b 20 6f 66 20 6f 6c 64 2e 2a a mask of old.*
182d0 20 63 6f 6c 75 6d 6e 73 0a 2a 2a 20 61 63 63 65 columns.** acce
182e0 73 73 65 64 20 28 6f 72 20 73 65 74 20 74 6f 20 ssed (or set to
182f0 30 20 66 6f 72 20 74 72 69 67 67 65 72 73 20 66 0 for triggers f
18300 69 72 65 64 20 61 73 20 61 20 72 65 73 75 6c 74 ired as a result
18310 20 6f 66 20 49 4e 53 45 52 54 20 0a 2a 2a 20 73 of INSERT .** s
18320 74 61 74 65 6d 65 6e 74 73 29 2e 20 53 69 6d 69 tatements). Simi
18330 6c 61 72 6c 79 2c 20 74 68 65 20 54 72 69 67 67 larly, the Trigg
18340 65 72 50 72 67 2e 61 43 6f 6c 6d 61 73 6b 5b 31 erPrg.aColmask[1
18350 5d 20 76 61 72 69 61 62 6c 65 20 69 73 20 73 65 ] variable is se
18360 74 20 74 6f 0a 2a 2a 20 61 20 6d 61 73 6b 20 6f t to.** a mask o
18370 66 20 6e 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 f new.* columns
18380 75 73 65 64 20 62 79 20 74 68 65 20 70 72 6f 67 used by the prog
18390 72 61 6d 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 54 ram..*/.struct T
183a0 72 69 67 67 65 72 50 72 67 20 7b 0a 20 20 54 72 riggerPrg {. Tr
183b0 69 67 67 65 72 20 2a 70 54 72 69 67 67 65 72 3b igger *pTrigger;
183c0 20 20 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 /* Trigger
183d0 20 74 68 69 73 20 70 72 6f 67 72 61 6d 20 77 61 this program wa
183e0 73 20 63 6f 64 65 64 20 66 72 6f 6d 20 2a 2f 0a s coded from */.
183f0 20 20 54 72 69 67 67 65 72 50 72 67 20 2a 70 4e TriggerPrg *pN
18400 65 78 74 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 ext; /* Nex
18410 74 20 65 6e 74 72 79 20 69 6e 20 50 61 72 73 65 t entry in Parse
18420 2e 70 54 72 69 67 67 65 72 50 72 67 20 6c 69 73 .pTriggerPrg lis
18430 74 20 2a 2f 0a 20 20 53 75 62 50 72 6f 67 72 61 t */. SubProgra
18440 6d 20 2a 70 50 72 6f 67 72 61 6d 3b 20 20 20 2f m *pProgram; /
18450 2a 20 50 72 6f 67 72 61 6d 20 69 6d 70 6c 65 6d * Program implem
18460 65 6e 74 69 6e 67 20 70 54 72 69 67 67 65 72 2f enting pTrigger/
18470 6f 72 63 6f 6e 66 20 2a 2f 0a 20 20 69 6e 74 20 orconf */. int
18480 6f 72 63 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 orconf;
18490 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 4f /* Default O
184a0 4e 20 43 4f 4e 46 4c 49 43 54 20 70 6f 6c 69 63 N CONFLICT polic
184b0 79 20 2a 2f 0a 20 20 75 33 32 20 61 43 6f 6c 6d y */. u32 aColm
184c0 61 73 6b 5b 32 5d 3b 20 20 20 20 20 20 20 20 2f ask[2]; /
184d0 2a 20 4d 61 73 6b 73 20 6f 66 20 6f 6c 64 2e 2a * Masks of old.*
184e0 2c 20 6e 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 , new.* columns
184f0 61 63 63 65 73 73 65 64 20 2a 2f 0a 7d 3b 0a 0a accessed */.};..
18500 2f 2a 0a 2a 2a 20 54 68 65 20 79 44 62 4d 61 73 /*.** The yDbMas
18510 6b 20 64 61 74 61 74 79 70 65 20 66 6f 72 20 74 k datatype for t
18520 68 65 20 62 69 74 6d 61 73 6b 20 6f 66 20 61 6c he bitmask of al
18530 6c 20 61 74 74 61 63 68 65 64 20 64 61 74 61 62 l attached datab
18540 61 73 65 73 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c ases..*/.#if SQL
18550 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 ITE_MAX_ATTACHED
18560 3e 33 30 0a 20 20 74 79 70 65 64 65 66 20 73 71 >30. typedef sq
18570 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 79 44 62 lite3_uint64 yDb
18580 4d 61 73 6b 3b 0a 23 65 6c 73 65 0a 20 20 74 79 Mask;.#else. ty
18590 70 65 64 65 66 20 75 6e 73 69 67 6e 65 64 20 69 pedef unsigned i
185a0 6e 74 20 79 44 62 4d 61 73 6b 3b 0a 23 65 6e 64 nt yDbMask;.#end
185b0 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 53 51 4c if../*.** An SQL
185c0 20 70 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e parser context.
185d0 20 20 41 20 63 6f 70 79 20 6f 66 20 74 68 69 73 A copy of this
185e0 20 73 74 72 75 63 74 75 72 65 20 69 73 20 70 61 structure is pa
185f0 73 73 65 64 20 74 68 72 6f 75 67 68 0a 2a 2a 20 ssed through.**
18600 74 68 65 20 70 61 72 73 65 72 20 61 6e 64 20 64 the parser and d
18610 6f 77 6e 20 69 6e 74 6f 20 61 6c 6c 20 74 68 65 own into all the
18620 20 70 61 72 73 65 72 20 61 63 74 69 6f 6e 20 72 parser action r
18630 6f 75 74 69 6e 65 20 69 6e 20 6f 72 64 65 72 20 outine in order
18640 74 6f 0a 2a 2a 20 63 61 72 72 79 20 61 72 6f 75 to.** carry arou
18650 6e 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 nd information t
18660 68 61 74 20 69 73 20 67 6c 6f 62 61 6c 20 74 6f hat is global to
18670 20 74 68 65 20 65 6e 74 69 72 65 20 70 61 72 73 the entire pars
18680 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 74 72 e..**.** The str
18690 75 63 74 75 72 65 20 69 73 20 64 69 76 69 64 65 ucture is divide
186a0 64 20 69 6e 74 6f 20 74 77 6f 20 70 61 72 74 73 d into two parts
186b0 2e 20 20 57 68 65 6e 20 74 68 65 20 70 61 72 73 . When the pars
186c0 65 72 20 61 6e 64 20 63 6f 64 65 0a 2a 2a 20 67 er and code.** g
186d0 65 6e 65 72 61 74 65 20 63 61 6c 6c 20 74 68 65 enerate call the
186e0 6d 73 65 6c 76 65 73 20 72 65 63 75 72 73 69 76 mselves recursiv
186f0 65 6c 79 2c 20 74 68 65 20 66 69 72 73 74 20 70 ely, the first p
18700 61 72 74 20 6f 66 20 74 68 65 20 73 74 72 75 63 art of the struc
18710 74 75 72 65 0a 2a 2a 20 69 73 20 63 6f 6e 73 74 ture.** is const
18720 61 6e 74 20 62 75 74 20 74 68 65 20 73 65 63 6f ant but the seco
18730 6e 64 20 70 61 72 74 20 69 73 20 72 65 73 65 74 nd part is reset
18740 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e at the beginnin
18750 67 20 61 6e 64 20 65 6e 64 20 6f 66 0a 2a 2a 20 g and end of.**
18760 65 61 63 68 20 72 65 63 75 72 73 69 6f 6e 2e 0a each recursion..
18770 2a 2a 0a 2a 2a 20 54 68 65 20 6e 54 61 62 6c 65 **.** The nTable
18780 4c 6f 63 6b 20 61 6e 64 20 61 54 61 62 6c 65 4c Lock and aTableL
18790 6f 63 6b 20 76 61 72 69 61 62 6c 65 73 20 61 72 ock variables ar
187a0 65 20 6f 6e 6c 79 20 75 73 65 64 20 69 66 20 74 e only used if t
187b0 68 65 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 he shared-cache
187c0 0a 2a 2a 20 66 65 61 74 75 72 65 20 69 73 20 65 .** feature is e
187d0 6e 61 62 6c 65 64 20 28 69 66 20 73 71 6c 69 74 nabled (if sqlit
187e0 65 33 54 73 64 28 29 2d 3e 75 73 65 53 68 61 72 e3Tsd()->useShar
187f0 65 64 44 61 74 61 20 69 73 20 74 72 75 65 29 2e edData is true).
18800 20 54 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 65 They are.** use
18810 64 20 74 6f 20 73 74 6f 72 65 20 74 68 65 20 73 d to store the s
18820 65 74 20 6f 66 20 74 61 62 6c 65 2d 6c 6f 63 6b et of table-lock
18830 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 68 s required by th
18840 65 20 73 74 61 74 65 6d 65 6e 74 20 62 65 69 6e e statement bein
18850 67 0a 2a 2a 20 63 6f 6d 70 69 6c 65 64 2e 20 46 g.** compiled. F
18860 75 6e 63 74 69 6f 6e 20 73 71 6c 69 74 65 33 54 unction sqlite3T
18870 61 62 6c 65 4c 6f 63 6b 28 29 20 69 73 20 75 73 ableLock() is us
18880 65 64 20 74 6f 20 61 64 64 20 65 6e 74 72 69 65 ed to add entrie
18890 73 20 74 6f 20 74 68 65 0a 2a 2a 20 6c 69 73 74 s to the.** list
188a0 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 61 72 73 ..*/.struct Pars
188b0 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 e {. sqlite3 *d
188c0 62 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 b; /* Th
188d0 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 e main database
188e0 73 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 63 structure */. c
188f0 68 61 72 20 2a 7a 45 72 72 4d 73 67 3b 20 20 20 har *zErrMsg;
18900 20 20 20 20 2f 2a 20 41 6e 20 65 72 72 6f 72 20 /* An error
18910 6d 65 73 73 61 67 65 20 2a 2f 0a 20 20 56 64 62 message */. Vdb
18920 65 20 2a 70 56 64 62 65 3b 20 20 20 20 20 20 20 e *pVdbe;
18930 20 20 2f 2a 20 41 6e 20 65 6e 67 69 6e 65 20 66 /* An engine f
18940 6f 72 20 65 78 65 63 75 74 69 6e 67 20 64 61 74 or executing dat
18950 61 62 61 73 65 20 62 79 74 65 63 6f 64 65 20 2a abase bytecode *
18960 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 /. int rc;
18970 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
18980 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 65 78 65 rn code from exe
18990 63 75 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 63 cution */. u8 c
189a0 6f 6c 4e 61 6d 65 73 53 65 74 3b 20 20 20 20 20 olNamesSet;
189b0 20 2f 2a 20 54 52 55 45 20 61 66 74 65 72 20 4f /* TRUE after O
189c0 50 5f 43 6f 6c 75 6d 6e 4e 61 6d 65 20 68 61 73 P_ColumnName has
189d0 20 62 65 65 6e 20 69 73 73 75 65 64 20 74 6f 20 been issued to
189e0 70 56 64 62 65 20 2a 2f 0a 20 20 75 38 20 63 68 pVdbe */. u8 ch
189f0 65 63 6b 53 63 68 65 6d 61 3b 20 20 20 20 20 20 eckSchema;
18a00 2f 2a 20 43 61 75 73 65 73 20 73 63 68 65 6d 61 /* Causes schema
18a10 20 63 6f 6f 6b 69 65 20 63 68 65 63 6b 20 61 66 cookie check af
18a20 74 65 72 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a ter an error */.
18a30 20 20 75 38 20 6e 65 73 74 65 64 3b 20 20 20 20 u8 nested;
18a40 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
18a50 20 6f 66 20 6e 65 73 74 65 64 20 63 61 6c 6c 73 of nested calls
18a60 20 74 6f 20 74 68 65 20 70 61 72 73 65 72 2f 63 to the parser/c
18a70 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 20 2a 2f ode generator */
18a80 0a 20 20 75 38 20 6e 54 65 6d 70 52 65 67 3b 20 . u8 nTempReg;
18a90 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
18aa0 72 20 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 72 r of temporary r
18ab0 65 67 69 73 74 65 72 73 20 69 6e 20 61 54 65 6d egisters in aTem
18ac0 70 52 65 67 5b 5d 20 2a 2f 0a 20 20 75 38 20 6e pReg[] */. u8 n
18ad0 54 65 6d 70 49 6e 55 73 65 3b 20 20 20 20 20 20 TempInUse;
18ae0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 54 /* Number of aT
18af0 65 6d 70 52 65 67 5b 5d 20 63 75 72 72 65 6e 74 empReg[] current
18b00 6c 79 20 63 68 65 63 6b 65 64 20 6f 75 74 20 2a ly checked out *
18b10 2f 0a 20 20 75 38 20 6e 43 6f 6c 43 61 63 68 65 /. u8 nColCache
18b20 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 ; /* Numb
18b30 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e er of entries in
18b40 20 61 43 6f 6c 43 61 63 68 65 5b 5d 20 2a 2f 0a aColCache[] */.
18b50 20 20 75 38 20 69 43 6f 6c 43 61 63 68 65 3b 20 u8 iColCache;
18b60 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 65 /* Next e
18b70 6e 74 72 79 20 69 6e 20 61 43 6f 6c 43 61 63 68 ntry in aColCach
18b80 65 5b 5d 20 74 6f 20 72 65 70 6c 61 63 65 20 2a e[] to replace *
18b90 2f 0a 20 20 75 38 20 69 73 4d 75 6c 74 69 57 72 /. u8 isMultiWr
18ba0 69 74 65 3b 20 20 20 20 20 2f 2a 20 54 72 75 65 ite; /* True
18bb0 20 69 66 20 73 74 61 74 65 6d 65 6e 74 20 6d 61 if statement ma
18bc0 79 20 6d 6f 64 69 66 79 2f 69 6e 73 65 72 74 20 y modify/insert
18bd0 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f multiple rows */
18be0 0a 20 20 75 38 20 6d 61 79 41 62 6f 72 74 3b 20 . u8 mayAbort;
18bf0 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
18c00 69 66 20 73 74 61 74 65 6d 65 6e 74 20 6d 61 79 if statement may
18c10 20 74 68 72 6f 77 20 61 6e 20 41 42 4f 52 54 20 throw an ABORT
18c20 65 78 63 65 70 74 69 6f 6e 20 2a 2f 0a 20 20 75 exception */. u
18c30 38 20 68 61 73 43 6f 6d 70 6f 75 6e 64 3b 20 20 8 hasCompound;
18c40 20 20 20 20 2f 2a 20 4e 65 65 64 20 74 6f 20 69 /* Need to i
18c50 6e 76 6f 6b 65 20 63 6f 6e 76 65 72 74 43 6f 6d nvoke convertCom
18c60 70 6f 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 poundSelectToSub
18c70 71 75 65 72 79 28 29 20 2a 2f 0a 20 20 69 6e 74 query() */. int
18c80 20 61 54 65 6d 70 52 65 67 5b 38 5d 3b 20 20 20 aTempReg[8];
18c90 20 20 2f 2a 20 48 6f 6c 64 69 6e 67 20 61 72 65 /* Holding are
18ca0 61 20 66 6f 72 20 74 65 6d 70 6f 72 61 72 79 20 a for temporary
18cb0 72 65 67 69 73 74 65 72 73 20 2a 2f 0a 20 20 69 registers */. i
18cc0 6e 74 20 6e 52 61 6e 67 65 52 65 67 3b 20 20 20 nt nRangeReg;
18cd0 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 /* Size of t
18ce0 68 65 20 74 65 6d 70 6f 72 61 72 79 20 72 65 67 he temporary reg
18cf0 69 73 74 65 72 20 62 6c 6f 63 6b 20 2a 2f 0a 20 ister block */.
18d00 20 69 6e 74 20 69 52 61 6e 67 65 52 65 67 3b 20 int iRangeReg;
18d10 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 72 /* First r
18d20 65 67 69 73 74 65 72 20 69 6e 20 74 65 6d 70 6f egister in tempo
18d30 72 61 72 79 20 72 65 67 69 73 74 65 72 20 62 6c rary register bl
18d40 6f 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 72 ock */. int nEr
18d50 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a r; /*
18d60 20 4e 75 6d 62 65 72 20 6f 66 20 65 72 72 6f 72 Number of error
18d70 73 20 73 65 65 6e 20 2a 2f 0a 20 20 69 6e 74 20 s seen */. int
18d80 6e 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 nTab;
18d90 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 72 /* Number of pr
18da0 65 76 69 6f 75 73 6c 79 20 61 6c 6c 6f 63 61 74 eviously allocat
18db0 65 64 20 56 44 42 45 20 63 75 72 73 6f 72 73 20 ed VDBE cursors
18dc0 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 3b 20 20 */. int nMem;
18dd0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
18de0 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20 63 65 ber of memory ce
18df0 6c 6c 73 20 75 73 65 64 20 73 6f 20 66 61 72 20 lls used so far
18e00 2a 2f 0a 20 20 69 6e 74 20 6e 53 65 74 3b 20 20 */. int nSet;
18e10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
18e20 62 65 72 20 6f 66 20 73 65 74 73 20 75 73 65 64 ber of sets used
18e30 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 69 6e 74 so far */. int
18e40 20 6e 4f 6e 63 65 3b 20 20 20 20 20 20 20 20 20 nOnce;
18e50 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 4f /* Number of O
18e60 50 5f 4f 6e 63 65 20 69 6e 73 74 72 75 63 74 69 P_Once instructi
18e70 6f 6e 73 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 ons so far */.
18e80 69 6e 74 20 6e 4f 70 41 6c 6c 6f 63 3b 20 20 20 int nOpAlloc;
18e90 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
18ea0 66 20 73 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65 f slots allocate
18eb0 64 20 66 6f 72 20 56 64 62 65 2e 61 4f 70 5b 5d d for Vdbe.aOp[]
18ec0 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 65 6c */. int nLabel
18ed0 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 ; /* Nu
18ee0 6d 62 65 72 20 6f 66 20 6c 61 62 65 6c 73 20 75 mber of labels u
18ef0 73 65 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 4c sed */. int *aL
18f00 61 62 65 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a abel; /*
18f10 20 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 Space to hold t
18f20 68 65 20 6c 61 62 65 6c 73 20 2a 2f 0a 20 20 69 he labels */. i
18f30 6e 74 20 69 46 69 78 65 64 4f 70 3b 20 20 20 20 nt iFixedOp;
18f40 20 20 20 20 2f 2a 20 4e 65 76 65 72 20 62 61 63 /* Never bac
18f50 6b 20 6f 75 74 20 6f 70 63 6f 64 65 73 20 69 46 k out opcodes iF
18f60 69 78 65 64 4f 70 2d 31 20 6f 72 20 65 61 72 6c ixedOp-1 or earl
18f70 69 65 72 20 2a 2f 0a 20 20 69 6e 74 20 63 6b 42 ier */. int ckB
18f80 61 73 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ase; /*
18f90 20 42 61 73 65 20 72 65 67 69 73 74 65 72 20 6f Base register o
18fa0 66 20 64 61 74 61 20 64 75 72 69 6e 67 20 63 68 f data during ch
18fb0 65 63 6b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 eck constraints
18fc0 2a 2f 0a 20 20 69 6e 74 20 69 50 61 72 74 49 64 */. int iPartId
18fd0 78 54 61 62 3b 20 20 20 20 20 2f 2a 20 54 61 62 xTab; /* Tab
18fe0 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 le corresponding
18ff0 20 74 6f 20 61 20 70 61 72 74 69 61 6c 20 69 6e to a partial in
19000 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 69 43 61 dex */. int iCa
19010 63 68 65 4c 65 76 65 6c 3b 20 20 20 20 20 2f 2a cheLevel; /*
19020 20 43 6f 6c 43 61 63 68 65 20 76 61 6c 69 64 20 ColCache valid
19030 77 68 65 6e 20 61 43 6f 6c 43 61 63 68 65 5b 5d when aColCache[]
19040 2e 69 4c 65 76 65 6c 3c 3d 69 43 61 63 68 65 4c .iLevel<=iCacheL
19050 65 76 65 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 43 evel */. int iC
19060 61 63 68 65 43 6e 74 3b 20 20 20 20 20 20 20 2f acheCnt; /
19070 2a 20 43 6f 75 6e 74 65 72 20 75 73 65 64 20 74 * Counter used t
19080 6f 20 67 65 6e 65 72 61 74 65 20 61 43 6f 6c 43 o generate aColC
19090 61 63 68 65 5b 5d 2e 6c 72 75 20 76 61 6c 75 65 ache[].lru value
190a0 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 79 43 s */. struct yC
190b0 6f 6c 43 61 63 68 65 20 7b 0a 20 20 20 20 69 6e olCache {. in
190c0 74 20 69 54 61 62 6c 65 3b 20 20 20 20 20 20 20 t iTable;
190d0 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 63 75 72 /* Table cur
190e0 73 6f 72 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 sor number */.
190f0 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e 3b 20 20 int iColumn;
19100 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 /* Table
19110 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 2a column number *
19120 2f 0a 20 20 20 20 75 38 20 74 65 6d 70 52 65 67 /. u8 tempReg
19130 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 69 ; /* i
19140 52 65 67 20 69 73 20 61 20 74 65 6d 70 20 72 65 Reg is a temp re
19150 67 69 73 74 65 72 20 74 68 61 74 20 6e 65 65 64 gister that need
19160 73 20 74 6f 20 62 65 20 66 72 65 65 64 20 2a 2f s to be freed */
19170 0a 20 20 20 20 69 6e 74 20 69 4c 65 76 65 6c 3b . int iLevel;
19180 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 /* Ne
19190 73 74 69 6e 67 20 6c 65 76 65 6c 20 2a 2f 0a 20 sting level */.
191a0 20 20 20 69 6e 74 20 69 52 65 67 3b 20 20 20 20 int iReg;
191b0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 67 20 /* Reg
191c0 77 69 74 68 20 76 61 6c 75 65 20 6f 66 20 74 68 with value of th
191d0 69 73 20 63 6f 6c 75 6d 6e 2e 20 30 20 6d 65 61 is column. 0 mea
191e0 6e 73 20 6e 6f 6e 65 2e 20 2a 2f 0a 20 20 20 20 ns none. */.
191f0 69 6e 74 20 6c 72 75 3b 20 20 20 20 20 20 20 20 int lru;
19200 20 20 20 20 20 20 2f 2a 20 4c 65 61 73 74 20 72 /* Least r
19210 65 63 65 6e 74 6c 79 20 75 73 65 64 20 65 6e 74 ecently used ent
19220 72 79 20 68 61 73 20 74 68 65 20 73 6d 61 6c 6c ry has the small
19230 65 73 74 20 76 61 6c 75 65 20 2a 2f 0a 20 20 7d est value */. }
19240 20 61 43 6f 6c 43 61 63 68 65 5b 53 51 4c 49 54 aColCache[SQLIT
19250 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 5d 3b 20 20 E_N_COLCACHE];
19260 2f 2a 20 4f 6e 65 20 66 6f 72 20 65 61 63 68 20 /* One for each
19270 63 6f 6c 75 6d 6e 20 63 61 63 68 65 20 65 6e 74 column cache ent
19280 72 79 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 ry */. ExprList
19290 20 2a 70 43 6f 6e 73 74 45 78 70 72 3b 2f 2a 20 *pConstExpr;/*
192a0 43 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 73 Constant express
192b0 69 6f 6e 73 20 2a 2f 0a 20 20 79 44 62 4d 61 73 ions */. yDbMas
192c0 6b 20 77 72 69 74 65 4d 61 73 6b 3b 20 20 20 2f k writeMask; /
192d0 2a 20 53 74 61 72 74 20 61 20 77 72 69 74 65 20 * Start a write
192e0 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 74 transaction on t
192f0 68 65 73 65 20 64 61 74 61 62 61 73 65 73 20 2a hese databases *
19300 2f 0a 20 20 79 44 62 4d 61 73 6b 20 63 6f 6f 6b /. yDbMask cook
19310 69 65 4d 61 73 6b 3b 20 20 2f 2a 20 42 69 74 6d ieMask; /* Bitm
19320 61 73 6b 20 6f 66 20 73 63 68 65 6d 61 20 76 65 ask of schema ve
19330 72 69 66 69 65 64 20 64 61 74 61 62 61 73 65 73 rified databases
19340 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 65 */. int cookie
19350 47 6f 74 6f 3b 20 20 20 20 20 20 2f 2a 20 41 64 Goto; /* Ad
19360 64 72 65 73 73 20 6f 66 20 4f 50 5f 47 6f 74 6f dress of OP_Goto
19370 20 74 6f 20 63 6f 6f 6b 69 65 20 76 65 72 69 66 to cookie verif
19380 69 65 72 20 73 75 62 72 6f 75 74 69 6e 65 20 2a ier subroutine *
19390 2f 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 65 56 61 /. int cookieVa
193a0 6c 75 65 5b 53 51 4c 49 54 45 5f 4d 41 58 5f 41 lue[SQLITE_MAX_A
193b0 54 54 41 43 48 45 44 2b 32 5d 3b 20 20 2f 2a 20 TTACHED+2]; /*
193c0 56 61 6c 75 65 73 20 6f 66 20 63 6f 6f 6b 69 65 Values of cookie
193d0 73 20 74 6f 20 76 65 72 69 66 79 20 2a 2f 0a 20 s to verify */.
193e0 20 69 6e 74 20 72 65 67 52 6f 77 69 64 3b 20 20 int regRowid;
193f0 20 20 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 /* Registe
19400 72 20 68 6f 6c 64 69 6e 67 20 72 6f 77 69 64 20 r holding rowid
19410 6f 66 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 of CREATE TABLE
19420 65 6e 74 72 79 20 2a 2f 0a 20 20 69 6e 74 20 72 entry */. int r
19430 65 67 52 6f 6f 74 3b 20 20 20 20 20 20 20 20 20 egRoot;
19440 2f 2a 20 52 65 67 69 73 74 65 72 20 68 6f 6c 64 /* Register hold
19450 69 6e 67 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 ing root page nu
19460 6d 62 65 72 20 66 6f 72 20 6e 65 77 20 6f 62 6a mber for new obj
19470 65 63 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d ects */. int nM
19480 61 78 41 72 67 3b 20 20 20 20 20 20 20 20 20 2f axArg; /
19490 2a 20 4d 61 78 20 61 72 67 73 20 70 61 73 73 65 * Max args passe
194a0 64 20 74 6f 20 75 73 65 72 20 66 75 6e 63 74 69 d to user functi
194b0 6f 6e 20 62 79 20 73 75 62 2d 70 72 6f 67 72 61 on by sub-progra
194c0 6d 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 63 6f 6e m */. Token con
194d0 73 74 72 61 69 6e 74 4e 61 6d 65 3b 2f 2a 20 4e straintName;/* N
194e0 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 73 74 ame of the const
194f0 72 61 69 6e 74 20 63 75 72 72 65 6e 74 6c 79 20 raint currently
19500 62 65 69 6e 67 20 70 61 72 73 65 64 20 2a 2f 0a being parsed */.
19510 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
19520 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 MIT_SHARED_CACHE
19530 0a 20 20 69 6e 74 20 6e 54 61 62 6c 65 4c 6f 63 . int nTableLoc
19540 6b 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d k; /* Num
19550 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 69 6e 20 ber of locks in
19560 61 54 61 62 6c 65 4c 6f 63 6b 20 2a 2f 0a 20 20 aTableLock */.
19570 54 61 62 6c 65 4c 6f 63 6b 20 2a 61 54 61 62 6c TableLock *aTabl
19580 65 4c 6f 63 6b 3b 20 2f 2a 20 52 65 71 75 69 72 eLock; /* Requir
19590 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b 73 20 66 ed table locks f
195a0 6f 72 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 or shared-cache
195b0 6d 6f 64 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 mode */.#endif.
195c0 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 41 AutoincInfo *pA
195d0 69 6e 63 3b 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 inc; /* Informa
195e0 74 69 6f 6e 20 61 62 6f 75 74 20 41 55 54 4f 49 tion about AUTOI
195f0 4e 43 52 45 4d 45 4e 54 20 63 6f 75 6e 74 65 72 NCREMENT counter
19600 73 20 2a 2f 0a 0a 20 20 2f 2a 20 49 6e 66 6f 72 s */.. /* Infor
19610 6d 61 74 69 6f 6e 20 75 73 65 64 20 77 68 69 6c mation used whil
19620 65 20 63 6f 64 69 6e 67 20 74 72 69 67 67 65 72 e coding trigger
19630 20 70 72 6f 67 72 61 6d 73 2e 20 2a 2f 0a 20 20 programs. */.
19640 50 61 72 73 65 20 2a 70 54 6f 70 6c 65 76 65 6c Parse *pToplevel
19650 3b 20 20 20 20 2f 2a 20 50 61 72 73 65 20 73 74 ; /* Parse st
19660 72 75 63 74 75 72 65 20 66 6f 72 20 6d 61 69 6e ructure for main
19670 20 70 72 6f 67 72 61 6d 20 28 6f 72 20 4e 55 4c program (or NUL
19680 4c 29 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 L) */. Table *p
19690 54 72 69 67 67 65 72 54 61 62 3b 20 20 2f 2a 20 TriggerTab; /*
196a0 54 61 62 6c 65 20 74 72 69 67 67 65 72 73 20 61 Table triggers a
196b0 72 65 20 62 65 69 6e 67 20 63 6f 64 65 64 20 66 re being coded f
196c0 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 61 64 64 72 or */. int addr
196d0 43 72 54 61 62 3b 20 20 20 20 20 20 20 2f 2a 20 CrTab; /*
196e0 41 64 64 72 65 73 73 20 6f 66 20 4f 50 5f 43 72 Address of OP_Cr
196f0 65 61 74 65 54 61 62 6c 65 20 6f 70 63 6f 64 65 eateTable opcode
19700 20 6f 6e 20 43 52 45 41 54 45 20 54 41 42 4c 45 on CREATE TABLE
19710 20 2a 2f 0a 20 20 69 6e 74 20 61 64 64 72 53 6b */. int addrSk
19720 69 70 50 4b 3b 20 20 20 20 20 20 2f 2a 20 41 64 ipPK; /* Ad
19730 64 72 65 73 73 20 6f 66 20 69 6e 73 74 72 75 63 dress of instruc
19740 74 69 6f 6e 20 74 6f 20 73 6b 69 70 20 50 52 49 tion to skip PRI
19750 4d 41 52 59 20 4b 45 59 20 69 6e 64 65 78 20 2a MARY KEY index *
19760 2f 0a 20 20 75 33 32 20 6e 51 75 65 72 79 4c 6f /. u32 nQueryLo
19770 6f 70 3b 20 20 20 20 20 20 2f 2a 20 45 73 74 20 op; /* Est
19780 6e 75 6d 62 65 72 20 6f 66 20 69 74 65 72 61 74 number of iterat
19790 69 6f 6e 73 20 6f 66 20 61 20 71 75 65 72 79 20 ions of a query
197a0 28 31 30 2a 6c 6f 67 32 28 4e 29 29 20 2a 2f 0a (10*log2(N)) */.
197b0 20 20 75 33 32 20 6f 6c 64 6d 61 73 6b 3b 20 20 u32 oldmask;
197c0 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f /* Mask o
197d0 66 20 6f 6c 64 2e 2a 20 63 6f 6c 75 6d 6e 73 20 f old.* columns
197e0 72 65 66 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 referenced */.
197f0 75 33 32 20 6e 65 77 6d 61 73 6b 3b 20 20 20 20 u32 newmask;
19800 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 /* Mask of
19810 6e 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 72 65 new.* columns re
19820 66 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 75 38 ferenced */. u8
19830 20 65 54 72 69 67 67 65 72 4f 70 3b 20 20 20 20 eTriggerOp;
19840 20 20 20 2f 2a 20 54 4b 5f 55 50 44 41 54 45 2c /* TK_UPDATE,
19850 20 54 4b 5f 49 4e 53 45 52 54 20 6f 72 20 54 4b TK_INSERT or TK
19860 5f 44 45 4c 45 54 45 20 2a 2f 0a 20 20 75 38 20 _DELETE */. u8
19870 65 4f 72 63 6f 6e 66 3b 20 20 20 20 20 20 20 20 eOrconf;
19880 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 4f 4e 20 /* Default ON
19890 43 4f 4e 46 4c 49 43 54 20 70 6f 6c 69 63 79 20 CONFLICT policy
198a0 66 6f 72 20 74 72 69 67 67 65 72 20 73 74 65 70 for trigger step
198b0 73 20 2a 2f 0a 20 20 75 38 20 64 69 73 61 62 6c s */. u8 disabl
198c0 65 54 72 69 67 67 65 72 73 3b 20 20 2f 2a 20 54 eTriggers; /* T
198d0 72 75 65 20 74 6f 20 64 69 73 61 62 6c 65 20 74 rue to disable t
198e0 72 69 67 67 65 72 73 20 2a 2f 0a 0a 20 20 2f 2a riggers */.. /*
198f0 20 41 62 6f 76 65 20 69 73 20 63 6f 6e 73 74 61 Above is consta
19900 6e 74 20 62 65 74 77 65 65 6e 20 72 65 63 75 72 nt between recur
19910 73 69 6f 6e 73 2e 20 20 42 65 6c 6f 77 20 69 73 sions. Below is
19920 20 72 65 73 65 74 20 62 65 66 6f 72 65 20 61 6e reset before an
19930 64 20 61 66 74 65 72 0a 20 20 2a 2a 20 65 61 63 d after. ** eac
19940 68 20 72 65 63 75 72 73 69 6f 6e 20 2a 2f 0a 0a h recursion */..
19950 20 20 69 6e 74 20 6e 56 61 72 3b 20 20 20 20 20 int nVar;
19960 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
19970 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 76 61 72 umber of '?' var
19980 69 61 62 6c 65 73 20 73 65 65 6e 20 69 6e 20 74 iables seen in t
19990 68 65 20 53 51 4c 20 73 6f 20 66 61 72 20 2a 2f he SQL so far */
199a0 0a 20 20 69 6e 74 20 6e 7a 56 61 72 3b 20 20 20 . int nzVar;
199b0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
199c0 4e 75 6d 62 65 72 20 6f 66 20 61 76 61 69 6c 61 Number of availa
199d0 62 6c 65 20 73 6c 6f 74 73 20 69 6e 20 61 7a 56 ble slots in azV
199e0 61 72 5b 5d 20 2a 2f 0a 20 20 75 38 20 69 50 6b ar[] */. u8 iPk
199f0 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 20 20 SortOrder;
19a00 20 20 20 20 2f 2a 20 41 53 43 20 6f 72 20 44 45 /* ASC or DE
19a10 53 43 20 66 6f 72 20 49 4e 54 45 47 45 52 20 50 SC for INTEGER P
19a20 52 49 4d 41 52 59 20 4b 45 59 20 2a 2f 0a 20 20 RIMARY KEY */.
19a30 75 38 20 65 78 70 6c 61 69 6e 3b 20 20 20 20 20 u8 explain;
19a40 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 /* Tru
19a50 65 20 69 66 20 74 68 65 20 45 58 50 4c 41 49 4e e if the EXPLAIN
19a60 20 66 6c 61 67 20 69 73 20 66 6f 75 6e 64 20 6f flag is found o
19a70 6e 20 74 68 65 20 71 75 65 72 79 20 2a 2f 0a 23 n the query */.#
19a80 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
19a90 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
19aa0 20 20 75 38 20 64 65 63 6c 61 72 65 56 74 61 62 u8 declareVtab
19ab0 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 ; /* T
19ac0 72 75 65 20 69 66 20 69 6e 73 69 64 65 20 73 71 rue if inside sq
19ad0 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f 76 74 lite3_declare_vt
19ae0 61 62 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 ab() */. int nV
19af0 74 61 62 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 tabLock;
19b00 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
19b10 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 virtual tables
19b20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 23 65 6e 64 69 to lock */.#endi
19b30 66 0a 20 20 69 6e 74 20 6e 41 6c 69 61 73 3b 20 f. int nAlias;
19b40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
19b50 20 4e 75 6d 62 65 72 20 6f 66 20 61 6c 69 61 73 Number of alias
19b60 65 64 20 72 65 73 75 6c 74 20 73 65 74 20 63 6f ed result set co
19b70 6c 75 6d 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 6e lumns */. int n
19b80 48 65 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 Height;
19b90 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 /* Expressi
19ba0 6f 6e 20 74 72 65 65 20 68 65 69 67 68 74 20 6f on tree height o
19bb0 66 20 63 75 72 72 65 6e 74 20 73 75 62 2d 73 65 f current sub-se
19bc0 6c 65 63 74 20 2a 2f 0a 23 69 66 6e 64 65 66 20 lect */.#ifndef
19bd0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c SQLITE_OMIT_EXPL
19be0 41 49 4e 0a 20 20 69 6e 74 20 69 53 65 6c 65 63 AIN. int iSelec
19bf0 74 49 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 tId;
19c00 2f 2a 20 49 44 20 6f 66 20 63 75 72 72 65 6e 74 /* ID of current
19c10 20 73 65 6c 65 63 74 20 66 6f 72 20 45 58 50 4c select for EXPL
19c20 41 49 4e 20 6f 75 74 70 75 74 20 2a 2f 0a 20 20 AIN output */.
19c30 69 6e 74 20 69 4e 65 78 74 53 65 6c 65 63 74 49 int iNextSelectI
19c40 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 d; /* Nex
19c50 74 20 61 76 61 69 6c 61 62 6c 65 20 73 65 6c 65 t available sele
19c60 63 74 20 49 44 20 66 6f 72 20 45 58 50 4c 41 49 ct ID for EXPLAI
19c70 4e 20 6f 75 74 70 75 74 20 2a 2f 0a 23 65 6e 64 N output */.#end
19c80 69 66 0a 20 20 63 68 61 72 20 2a 2a 61 7a 56 61 if. char **azVa
19c90 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f r; /
19ca0 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f 20 6e 61 * Pointers to na
19cb0 6d 65 73 20 6f 66 20 70 61 72 61 6d 65 74 65 72 mes of parameter
19cc0 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 52 65 s */. Vdbe *pRe
19cd0 70 72 65 70 61 72 65 3b 20 20 20 20 20 20 20 20 prepare;
19ce0 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 72 65 70 /* VM being rep
19cf0 72 65 70 61 72 65 64 20 28 73 71 6c 69 74 65 33 repared (sqlite3
19d00 52 65 70 72 65 70 61 72 65 28 29 29 20 2a 2f 0a Reprepare()) */.
19d10 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 const char *zT
19d20 61 69 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 ail; /* A
19d30 6c 6c 20 53 51 4c 20 74 65 78 74 20 70 61 73 74 ll SQL text past
19d40 20 74 68 65 20 6c 61 73 74 20 73 65 6d 69 63 6f the last semico
19d50 6c 6f 6e 20 70 61 72 73 65 64 20 2a 2f 0a 20 20 lon parsed */.
19d60 54 61 62 6c 65 20 2a 70 4e 65 77 54 61 62 6c 65 Table *pNewTable
19d70 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 74 ; /* A t
19d80 61 62 6c 65 20 62 65 69 6e 67 20 63 6f 6e 73 74 able being const
19d90 72 75 63 74 65 64 20 62 79 20 43 52 45 41 54 45 ructed by CREATE
19da0 20 54 41 42 4c 45 20 2a 2f 0a 20 20 54 72 69 67 TABLE */. Trig
19db0 67 65 72 20 2a 70 4e 65 77 54 72 69 67 67 65 72 ger *pNewTrigger
19dc0 3b 20 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 ; /* Trigger
19dd0 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 75 63 74 under construct
19de0 20 62 79 20 61 20 43 52 45 41 54 45 20 54 52 49 by a CREATE TRI
19df0 47 47 45 52 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 GGER */. const
19e00 63 68 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 65 char *zAuthConte
19e10 78 74 3b 20 2f 2a 20 54 68 65 20 36 74 68 20 70 xt; /* The 6th p
19e20 61 72 61 6d 65 74 65 72 20 74 6f 20 64 62 2d 3e arameter to db->
19e30 78 41 75 74 68 20 63 61 6c 6c 62 61 63 6b 73 20 xAuth callbacks
19e40 2a 2f 0a 20 20 54 6f 6b 65 6e 20 73 4e 61 6d 65 */. Token sName
19e50 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 20 20 2f Token; /
19e60 2a 20 54 6f 6b 65 6e 20 77 69 74 68 20 75 6e 71 * Token with unq
19e70 75 61 6c 69 66 69 65 64 20 73 63 68 65 6d 61 20 ualified schema
19e80 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a 2f 0a 20 object name */.
19e90 20 54 6f 6b 65 6e 20 73 4c 61 73 74 54 6f 6b 65 Token sLastToke
19ea0 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 n; /* Th
19eb0 65 20 6c 61 73 74 20 74 6f 6b 65 6e 20 70 61 72 e last token par
19ec0 73 65 64 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 sed */.#ifndef S
19ed0 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 QLITE_OMIT_VIRTU
19ee0 41 4c 54 41 42 4c 45 0a 20 20 54 6f 6b 65 6e 20 ALTABLE. Token
19ef0 73 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 sArg;
19f00 20 20 20 20 2f 2a 20 43 6f 6d 70 6c 65 74 65 20 /* Complete
19f10 74 65 78 74 20 6f 66 20 61 20 6d 6f 64 75 6c 65 text of a module
19f20 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 20 20 54 argument */. T
19f30 61 62 6c 65 20 2a 2a 61 70 56 74 61 62 4c 6f 63 able **apVtabLoc
19f40 6b 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e k; /* Poin
19f50 74 65 72 20 74 6f 20 76 69 72 74 75 61 6c 20 74 ter to virtual t
19f60 61 62 6c 65 73 20 6e 65 65 64 69 6e 67 20 6c 6f ables needing lo
19f70 63 6b 69 6e 67 20 2a 2f 0a 23 65 6e 64 69 66 0a cking */.#endif.
19f80 20 20 54 61 62 6c 65 20 2a 70 5a 6f 6d 62 69 65 Table *pZombie
19f90 54 61 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c Tab; /* L
19fa0 69 73 74 20 6f 66 20 54 61 62 6c 65 20 6f 62 6a ist of Table obj
19fb0 65 63 74 73 20 74 6f 20 64 65 6c 65 74 65 20 61 ects to delete a
19fc0 66 74 65 72 20 63 6f 64 65 20 67 65 6e 20 2a 2f fter code gen */
19fd0 0a 20 20 54 72 69 67 67 65 72 50 72 67 20 2a 70 . TriggerPrg *p
19fe0 54 72 69 67 67 65 72 50 72 67 3b 20 20 2f 2a 20 TriggerPrg; /*
19ff0 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 63 Linked list of c
1a000 6f 64 65 64 20 74 72 69 67 67 65 72 73 20 2a 2f oded triggers */
1a010 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 3b 20 . With *pWith;
1a020 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1a030 43 75 72 72 65 6e 74 20 57 49 54 48 20 63 6c 61 Current WITH cla
1a040 75 73 65 2c 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a use, or NULL */.
1a050 20 20 75 38 20 62 46 72 65 65 57 69 74 68 3b 20 u8 bFreeWith;
1a060 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1a070 72 75 65 20 69 66 20 70 57 69 74 68 20 73 68 6f rue if pWith sho
1a080 75 6c 64 20 62 65 20 66 72 65 65 64 20 77 69 74 uld be freed wit
1a090 68 20 70 61 72 73 65 72 20 2a 2f 0a 7d 3b 0a 0a h parser */.};..
1a0a0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 /*.** Return tru
1a0b0 65 20 69 66 20 63 75 72 72 65 6e 74 6c 79 20 69 e if currently i
1a0c0 6e 73 69 64 65 20 61 6e 20 73 71 6c 69 74 65 33 nside an sqlite3
1a0d0 5f 64 65 63 6c 61 72 65 5f 76 74 61 62 28 29 20 _declare_vtab()
1a0e0 63 61 6c 6c 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 call..*/.#ifdef
1a0f0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
1a100 55 41 4c 54 41 42 4c 45 0a 20 20 23 64 65 66 69 UALTABLE. #defi
1a110 6e 65 20 49 4e 5f 44 45 43 4c 41 52 45 5f 56 54 ne IN_DECLARE_VT
1a120 41 42 20 30 0a 23 65 6c 73 65 0a 20 20 23 64 65 AB 0.#else. #de
1a130 66 69 6e 65 20 49 4e 5f 44 45 43 4c 41 52 45 5f fine IN_DECLARE_
1a140 56 54 41 42 20 28 70 50 61 72 73 65 2d 3e 64 65 VTAB (pParse->de
1a150 63 6c 61 72 65 56 74 61 62 29 0a 23 65 6e 64 69 clareVtab).#endi
1a160 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 f../*.** An inst
1a170 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
1a180 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
1a190 63 61 6e 20 62 65 20 64 65 63 6c 61 72 65 64 20 can be declared
1a1a0 6f 6e 20 61 20 73 74 61 63 6b 20 61 6e 64 20 75 on a stack and u
1a1b0 73 65 64 0a 2a 2a 20 74 6f 20 73 61 76 65 20 74 sed.** to save t
1a1c0 68 65 20 50 61 72 73 65 2e 7a 41 75 74 68 43 6f he Parse.zAuthCo
1a1d0 6e 74 65 78 74 20 76 61 6c 75 65 20 73 6f 20 74 ntext value so t
1a1e0 68 61 74 20 69 74 20 63 61 6e 20 62 65 20 72 65 hat it can be re
1a1f0 73 74 6f 72 65 64 20 6c 61 74 65 72 2e 0a 2a 2f stored later..*/
1a200 0a 73 74 72 75 63 74 20 41 75 74 68 43 6f 6e 74 .struct AuthCont
1a210 65 78 74 20 7b 0a 20 20 63 6f 6e 73 74 20 63 68 ext {. const ch
1a220 61 72 20 2a 7a 41 75 74 68 43 6f 6e 74 65 78 74 ar *zAuthContext
1a230 3b 20 20 20 2f 2a 20 50 75 74 20 73 61 76 65 64 ; /* Put saved
1a240 20 50 61 72 73 65 2e 7a 41 75 74 68 43 6f 6e 74 Parse.zAuthCont
1a250 65 78 74 20 68 65 72 65 20 2a 2f 0a 20 20 50 61 ext here */. Pa
1a260 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 20 20 rse *pParse;
1a270 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
1a280 20 50 61 72 73 65 20 73 74 72 75 63 74 75 72 65 Parse structure
1a290 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 42 69 */.};../*.** Bi
1a2a0 74 66 69 65 6c 64 20 66 6c 61 67 73 20 66 6f 72 tfield flags for
1a2b0 20 50 35 20 76 61 6c 75 65 20 69 6e 20 76 61 72 P5 value in var
1a2c0 69 6f 75 73 20 6f 70 63 6f 64 65 73 2e 0a 2a 2f ious opcodes..*/
1a2d0 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
1a2e0 4e 43 48 41 4e 47 45 20 20 20 20 20 20 20 30 78 NCHANGE 0x
1a2f0 30 31 20 20 20 20 2f 2a 20 53 65 74 20 74 6f 20 01 /* Set to
1a300 75 70 64 61 74 65 20 64 62 2d 3e 6e 43 68 61 6e update db->nChan
1a310 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 ge */.#define OP
1a320 46 4c 41 47 5f 4c 41 53 54 52 4f 57 49 44 20 20 FLAG_LASTROWID
1a330 20 20 20 30 78 30 32 20 20 20 20 2f 2a 20 53 65 0x02 /* Se
1a340 74 20 74 6f 20 75 70 64 61 74 65 20 64 62 2d 3e t to update db->
1a350 6c 61 73 74 52 6f 77 69 64 20 2a 2f 0a 23 64 65 lastRowid */.#de
1a360 66 69 6e 65 20 4f 50 46 4c 41 47 5f 49 53 55 50 fine OPFLAG_ISUP
1a370 44 41 54 45 20 20 20 20 20 20 30 78 30 34 20 20 DATE 0x04
1a380 20 20 2f 2a 20 54 68 69 73 20 4f 50 5f 49 6e 73 /* This OP_Ins
1a390 65 72 74 20 69 73 20 61 6e 20 73 71 6c 20 55 50 ert is an sql UP
1a3a0 44 41 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 DATE */.#define
1a3b0 4f 50 46 4c 41 47 5f 41 50 50 45 4e 44 20 20 20 OPFLAG_APPEND
1a3c0 20 20 20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 0x08 /*
1a3d0 54 68 69 73 20 69 73 20 6c 69 6b 65 6c 79 20 74 This is likely t
1a3e0 6f 20 62 65 20 61 6e 20 61 70 70 65 6e 64 20 2a o be an append *
1a3f0 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
1a400 5f 55 53 45 53 45 45 4b 52 45 53 55 4c 54 20 30 _USESEEKRESULT 0
1a410 78 31 30 20 20 20 20 2f 2a 20 54 72 79 20 74 6f x10 /* Try to
1a420 20 61 76 6f 69 64 20 61 20 73 65 65 6b 20 69 6e avoid a seek in
1a430 20 42 74 72 65 65 49 6e 73 65 72 74 28 29 20 2a BtreeInsert() *
1a440 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
1a450 5f 43 4c 45 41 52 43 41 43 48 45 20 20 20 20 30 _CLEARCACHE 0
1a460 78 32 30 20 20 20 20 2f 2a 20 43 6c 65 61 72 20 x20 /* Clear
1a470 70 73 65 75 64 6f 2d 74 61 62 6c 65 20 63 61 63 pseudo-table cac
1a480 68 65 20 69 6e 20 4f 50 5f 43 6f 6c 75 6d 6e 20 he in OP_Column
1a490 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
1a4a0 47 5f 4c 45 4e 47 54 48 41 52 47 20 20 20 20 20 G_LENGTHARG
1a4b0 30 78 34 30 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 0x40 /* OP_Co
1a4c0 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 65 64 20 66 lumn only used f
1a4d0 6f 72 20 6c 65 6e 67 74 68 28 29 20 2a 2f 0a 23 or length() */.#
1a4e0 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 54 59 define OPFLAG_TY
1a4f0 50 45 4f 46 41 52 47 20 20 20 20 20 30 78 38 30 PEOFARG 0x80
1a500 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e /* OP_Column
1a510 20 6f 6e 6c 79 20 75 73 65 64 20 66 6f 72 20 74 only used for t
1a520 79 70 65 6f 66 28 29 20 2a 2f 0a 23 64 65 66 69 ypeof() */.#defi
1a530 6e 65 20 4f 50 46 4c 41 47 5f 42 55 4c 4b 43 53 ne OPFLAG_BULKCS
1a540 52 20 20 20 20 20 20 20 30 78 30 31 20 20 20 20 R 0x01
1a550 2f 2a 20 4f 50 5f 4f 70 65 6e 2a 2a 20 75 73 65 /* OP_Open** use
1a560 64 20 74 6f 20 6f 70 65 6e 20 62 75 6c 6b 20 63 d to open bulk c
1a570 75 72 73 6f 72 20 2a 2f 0a 23 64 65 66 69 6e 65 ursor */.#define
1a580 20 4f 50 46 4c 41 47 5f 50 32 49 53 52 45 47 20 OPFLAG_P2ISREG
1a590 20 20 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 0x02 /*
1a5a0 20 50 32 20 74 6f 20 4f 50 5f 4f 70 65 6e 2a 2a P2 to OP_Open**
1a5b0 20 69 73 20 61 20 72 65 67 69 73 74 65 72 20 6e is a register n
1a5c0 75 6d 62 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 umber */.#define
1a5d0 20 4f 50 46 4c 41 47 5f 50 45 52 4d 55 54 45 20 OPFLAG_PERMUTE
1a5e0 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
1a5f0 20 4f 50 5f 43 6f 6d 70 61 72 65 3a 20 75 73 65 OP_Compare: use
1a600 20 74 68 65 20 70 65 72 6d 75 74 61 74 69 6f 6e the permutation
1a610 20 2a 2f 0a 0a 2f 2a 0a 20 2a 20 45 61 63 68 20 */../*. * Each
1a620 74 72 69 67 67 65 72 20 70 72 65 73 65 6e 74 20 trigger present
1a630 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
1a640 73 63 68 65 6d 61 20 69 73 20 73 74 6f 72 65 64 schema is stored
1a650 20 61 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 as an instance
1a660 6f 66 0a 20 2a 20 73 74 72 75 63 74 20 54 72 69 of. * struct Tri
1a670 67 67 65 72 2e 20 0a 20 2a 0a 20 2a 20 50 6f 69 gger. . *. * Poi
1a680 6e 74 65 72 73 20 74 6f 20 69 6e 73 74 61 6e 63 nters to instanc
1a690 65 73 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 es of struct Tri
1a6a0 67 67 65 72 20 61 72 65 20 73 74 6f 72 65 64 20 gger are stored
1a6b0 69 6e 20 74 77 6f 20 77 61 79 73 2e 0a 20 2a 20 in two ways.. *
1a6c0 31 2e 20 49 6e 20 74 68 65 20 22 74 72 69 67 48 1. In the "trigH
1a6d0 61 73 68 22 20 68 61 73 68 20 74 61 62 6c 65 20 ash" hash table
1a6e0 28 70 61 72 74 20 6f 66 20 74 68 65 20 73 71 6c (part of the sql
1a6f0 69 74 65 33 2a 20 74 68 61 74 20 72 65 70 72 65 ite3* that repre
1a700 73 65 6e 74 73 20 74 68 65 20 0a 20 2a 20 20 20 sents the . *
1a710 20 64 61 74 61 62 61 73 65 29 2e 20 54 68 69 73 database). This
1a720 20 61 6c 6c 6f 77 73 20 54 72 69 67 67 65 72 20 allows Trigger
1a730 73 74 72 75 63 74 75 72 65 73 20 74 6f 20 62 65 structures to be
1a740 20 72 65 74 72 69 65 76 65 64 20 62 79 20 6e 61 retrieved by na
1a750 6d 65 2e 0a 20 2a 20 32 2e 20 41 6c 6c 20 74 72 me.. * 2. All tr
1a760 69 67 67 65 72 73 20 61 73 73 6f 63 69 61 74 65 iggers associate
1a770 64 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 d with a single
1a780 74 61 62 6c 65 20 66 6f 72 6d 20 61 20 6c 69 6e table form a lin
1a790 6b 65 64 20 6c 69 73 74 2c 20 75 73 69 6e 67 20 ked list, using
1a7a0 74 68 65 0a 20 2a 20 20 20 20 70 4e 65 78 74 20 the. * pNext
1a7b0 6d 65 6d 62 65 72 20 6f 66 20 73 74 72 75 63 74 member of struct
1a7c0 20 54 72 69 67 67 65 72 2e 20 41 20 70 6f 69 6e Trigger. A poin
1a7d0 74 65 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 ter to the first
1a7e0 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 0a element of the.
1a7f0 20 2a 20 20 20 20 6c 69 6e 6b 65 64 20 6c 69 73 * linked lis
1a800 74 20 69 73 20 73 74 6f 72 65 64 20 61 73 20 74 t is stored as t
1a810 68 65 20 22 70 54 72 69 67 67 65 72 22 20 6d 65 he "pTrigger" me
1a820 6d 62 65 72 20 6f 66 20 74 68 65 20 61 73 73 6f mber of the asso
1a830 63 69 61 74 65 64 0a 20 2a 20 20 20 20 73 74 72 ciated. * str
1a840 75 63 74 20 54 61 62 6c 65 2e 0a 20 2a 0a 20 2a uct Table.. *. *
1a850 20 54 68 65 20 22 73 74 65 70 5f 6c 69 73 74 22 The "step_list"
1a860 20 6d 65 6d 62 65 72 20 70 6f 69 6e 74 73 20 74 member points t
1a870 6f 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d o the first elem
1a880 65 6e 74 20 6f 66 20 61 20 6c 69 6e 6b 65 64 20 ent of a linked
1a890 6c 69 73 74 0a 20 2a 20 63 6f 6e 74 61 69 6e 69 list. * containi
1a8a0 6e 67 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 ng the SQL state
1a8b0 6d 65 6e 74 73 20 73 70 65 63 69 66 69 65 64 20 ments specified
1a8c0 61 73 20 74 68 65 20 74 72 69 67 67 65 72 20 70 as the trigger p
1a8d0 72 6f 67 72 61 6d 2e 0a 20 2a 2f 0a 73 74 72 75 rogram.. */.stru
1a8e0 63 74 20 54 72 69 67 67 65 72 20 7b 0a 20 20 63 ct Trigger {. c
1a8f0 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
1a900 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 /* The na
1a910 6d 65 20 6f 66 20 74 68 65 20 74 72 69 67 67 65 me of the trigge
1a920 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
1a930 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 63 68 */. ch
1a940 61 72 20 2a 74 61 62 6c 65 3b 20 20 20 20 20 20 ar *table;
1a950 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 61 62 /* The tab
1a960 6c 65 20 6f 72 20 76 69 65 77 20 74 6f 20 77 68 le or view to wh
1a970 69 63 68 20 74 68 65 20 74 72 69 67 67 65 72 20 ich the trigger
1a980 61 70 70 6c 69 65 73 20 2a 2f 0a 20 20 75 38 20 applies */. u8
1a990 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 op;
1a9a0 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 /* One of T
1a9b0 4b 5f 44 45 4c 45 54 45 2c 20 54 4b 5f 55 50 44 K_DELETE, TK_UPD
1a9c0 41 54 45 2c 20 54 4b 5f 49 4e 53 45 52 54 20 20 ATE, TK_INSERT
1a9d0 20 20 20 20 20 20 20 2a 2f 0a 20 20 75 38 20 74 */. u8 t
1a9e0 72 5f 74 6d 3b 20 20 20 20 20 20 20 20 20 20 20 r_tm;
1a9f0 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 52 /* One of TR
1aa00 49 47 47 45 52 5f 42 45 46 4f 52 45 2c 20 54 52 IGGER_BEFORE, TR
1aa10 49 47 47 45 52 5f 41 46 54 45 52 20 2a 2f 0a 20 IGGER_AFTER */.
1aa20 20 45 78 70 72 20 2a 70 57 68 65 6e 3b 20 20 20 Expr *pWhen;
1aa30 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
1aa40 57 48 45 4e 20 63 6c 61 75 73 65 20 6f 66 20 74 WHEN clause of t
1aa50 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 28 6d he expression (m
1aa60 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a 2f 0a 20 ay be NULL) */.
1aa70 20 49 64 4c 69 73 74 20 2a 70 43 6f 6c 75 6d 6e IdList *pColumn
1aa80 73 3b 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 s; /* If t
1aa90 68 69 73 20 69 73 20 61 6e 20 55 50 44 41 54 45 his is an UPDATE
1aaa0 20 4f 46 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 OF <column-list
1aab0 3e 20 74 72 69 67 67 65 72 2c 0a 20 20 20 20 20 > trigger,.
1aac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1aad0 20 20 20 20 20 20 20 20 74 68 65 20 3c 63 6f 6c the <col
1aae0 75 6d 6e 2d 6c 69 73 74 3e 20 69 73 20 73 74 6f umn-list> is sto
1aaf0 72 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 53 63 red here */. Sc
1ab00 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 hema *pSchema;
1ab10 20 20 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 /* Schema
1ab20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 74 containing the t
1ab30 72 69 67 67 65 72 20 2a 2f 0a 20 20 53 63 68 65 rigger */. Sche
1ab40 6d 61 20 2a 70 54 61 62 53 63 68 65 6d 61 3b 20 ma *pTabSchema;
1ab50 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 63 6f /* Schema co
1ab60 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 74 61 62 ntaining the tab
1ab70 6c 65 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 le */. TriggerS
1ab80 74 65 70 20 2a 73 74 65 70 5f 6c 69 73 74 3b 20 tep *step_list;
1ab90 2f 2a 20 4c 69 6e 6b 20 6c 69 73 74 20 6f 66 20 /* Link list of
1aba0 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 20 trigger program
1abb0 73 74 65 70 73 20 20 20 20 20 20 20 20 20 20 20 steps
1abc0 20 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 2a */. Trigger *
1abd0 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 2f pNext; /
1abe0 2a 20 4e 65 78 74 20 74 72 69 67 67 65 72 20 61 * Next trigger a
1abf0 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
1ac00 68 65 20 74 61 62 6c 65 20 2a 2f 0a 7d 3b 0a 0a he table */.};..
1ac10 2f 2a 0a 2a 2a 20 41 20 74 72 69 67 67 65 72 20 /*.** A trigger
1ac20 69 73 20 65 69 74 68 65 72 20 61 20 42 45 46 4f is either a BEFO
1ac30 52 45 20 6f 72 20 61 6e 20 41 46 54 45 52 20 74 RE or an AFTER t
1ac40 72 69 67 67 65 72 2e 20 20 54 68 65 20 66 6f 6c rigger. The fol
1ac50 6c 6f 77 69 6e 67 20 63 6f 6e 73 74 61 6e 74 73 lowing constants
1ac60 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 20 77 68 .** determine wh
1ac70 69 63 68 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ich. .**.** If t
1ac80 68 65 72 65 20 61 72 65 20 6d 75 6c 74 69 70 6c here are multipl
1ac90 65 20 74 72 69 67 67 65 72 73 2c 20 79 6f 75 20 e triggers, you
1aca0 6d 69 67 68 74 20 6f 66 20 73 6f 6d 65 20 42 45 might of some BE
1acb0 46 4f 52 45 20 61 6e 64 20 73 6f 6d 65 20 41 46 FORE and some AF
1acc0 54 45 52 2e 0a 2a 2a 20 49 6e 20 74 68 61 74 20 TER..** In that
1acd0 63 61 73 65 73 2c 20 74 68 65 20 63 6f 6e 73 74 cases, the const
1ace0 61 6e 74 73 20 62 65 6c 6f 77 20 63 61 6e 20 62 ants below can b
1acf0 65 20 4f 52 65 64 20 74 6f 67 65 74 68 65 72 2e e ORed together.
1ad00 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 54 52 49 47 .*/.#define TRIG
1ad10 47 45 52 5f 42 45 46 4f 52 45 20 20 31 0a 23 64 GER_BEFORE 1.#d
1ad20 65 66 69 6e 65 20 54 52 49 47 47 45 52 5f 41 46 efine TRIGGER_AF
1ad30 54 45 52 20 20 20 32 0a 0a 2f 2a 0a 20 2a 20 41 TER 2../*. * A
1ad40 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 73 74 n instance of st
1ad50 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 70 ruct TriggerStep
1ad60 20 69 73 20 75 73 65 64 20 74 6f 20 73 74 6f 72 is used to stor
1ad70 65 20 61 20 73 69 6e 67 6c 65 20 53 51 4c 20 73 e a single SQL s
1ad80 74 61 74 65 6d 65 6e 74 0a 20 2a 20 74 68 61 74 tatement. * that
1ad90 20 69 73 20 61 20 70 61 72 74 20 6f 66 20 61 20 is a part of a
1ada0 74 72 69 67 67 65 72 2d 70 72 6f 67 72 61 6d 2e trigger-program.
1adb0 20 0a 20 2a 0a 20 2a 20 49 6e 73 74 61 6e 63 65 . *. * Instance
1adc0 73 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 67 s of struct Trig
1add0 67 65 72 53 74 65 70 20 61 72 65 20 73 74 6f 72 gerStep are stor
1ade0 65 64 20 69 6e 20 61 20 73 69 6e 67 6c 79 20 6c ed in a singly l
1adf0 69 6e 6b 65 64 20 6c 69 73 74 20 28 6c 69 6e 6b inked list (link
1ae00 65 64 0a 20 2a 20 75 73 69 6e 67 20 74 68 65 20 ed. * using the
1ae10 22 70 4e 65 78 74 22 20 6d 65 6d 62 65 72 29 20 "pNext" member)
1ae20 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 74 68 referenced by th
1ae30 65 20 22 73 74 65 70 5f 6c 69 73 74 22 20 6d 65 e "step_list" me
1ae40 6d 62 65 72 20 6f 66 20 74 68 65 20 0a 20 2a 20 mber of the . *
1ae50 61 73 73 6f 63 69 61 74 65 64 20 73 74 72 75 63 associated struc
1ae60 74 20 54 72 69 67 67 65 72 20 69 6e 73 74 61 6e t Trigger instan
1ae70 63 65 2e 20 54 68 65 20 66 69 72 73 74 20 65 6c ce. The first el
1ae80 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 6c 69 6e ement of the lin
1ae90 6b 65 64 20 6c 69 73 74 20 69 73 0a 20 2a 20 74 ked list is. * t
1aea0 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f 66 he first step of
1aeb0 20 74 68 65 20 74 72 69 67 67 65 72 2d 70 72 6f the trigger-pro
1aec0 67 72 61 6d 2e 0a 20 2a 20 0a 20 2a 20 54 68 65 gram.. * . * The
1aed0 20 22 6f 70 22 20 6d 65 6d 62 65 72 20 69 6e 64 "op" member ind
1aee0 69 63 61 74 65 73 20 77 68 65 74 68 65 72 20 74 icates whether t
1aef0 68 69 73 20 69 73 20 61 20 22 44 45 4c 45 54 45 his is a "DELETE
1af00 22 2c 20 22 49 4e 53 45 52 54 22 2c 20 22 55 50 ", "INSERT", "UP
1af10 44 41 54 45 22 20 6f 72 0a 20 2a 20 22 53 45 4c DATE" or. * "SEL
1af20 45 43 54 22 20 73 74 61 74 65 6d 65 6e 74 2e 20 ECT" statement.
1af30 54 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 20 The meanings of
1af40 74 68 65 20 6f 74 68 65 72 20 6d 65 6d 62 65 72 the other member
1af50 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 s is determined
1af60 62 79 20 74 68 65 20 0a 20 2a 20 76 61 6c 75 65 by the . * value
1af70 20 6f 66 20 22 6f 70 22 20 61 73 20 66 6f 6c 6c of "op" as foll
1af80 6f 77 73 3a 0a 20 2a 0a 20 2a 20 28 6f 70 20 3d ows:. *. * (op =
1af90 3d 20 54 4b 5f 49 4e 53 45 52 54 29 0a 20 2a 20 = TK_INSERT). *
1afa0 6f 72 63 6f 6e 66 20 20 20 20 2d 3e 20 73 74 6f orconf -> sto
1afb0 72 65 73 20 74 68 65 20 4f 4e 20 43 4f 4e 46 4c res the ON CONFL
1afc0 49 43 54 20 61 6c 67 6f 72 69 74 68 6d 0a 20 2a ICT algorithm. *
1afd0 20 70 53 65 6c 65 63 74 20 20 20 2d 3e 20 49 66 pSelect -> If
1afe0 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45 this is an INSE
1aff0 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 4c 45 RT INTO ... SELE
1b000 43 54 20 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 CT ... statement
1b010 2c 20 74 68 65 6e 0a 20 2a 20 20 20 20 20 20 20 , then. *
1b020 20 20 20 20 20 20 20 74 68 69 73 20 73 74 6f 72 this stor
1b030 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 es a pointer to
1b040 74 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 the SELECT state
1b050 6d 65 6e 74 2e 20 4f 74 68 65 72 77 69 73 65 20 ment. Otherwise
1b060 4e 55 4c 4c 2e 0a 20 2a 20 74 61 72 67 65 74 20 NULL.. * target
1b070 20 20 20 2d 3e 20 41 20 74 6f 6b 65 6e 20 68 6f -> A token ho
1b080 6c 64 69 6e 67 20 74 68 65 20 71 75 6f 74 65 64 lding the quoted
1b090 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
1b0a0 6c 65 20 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 le to insert int
1b0b0 6f 2e 0a 20 2a 20 70 45 78 70 72 4c 69 73 74 20 o.. * pExprList
1b0c0 2d 3e 20 49 66 20 74 68 69 73 20 69 73 20 61 6e -> If this is an
1b0d0 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e INSERT INTO ...
1b0e0 20 56 41 4c 55 45 53 20 2e 2e 2e 20 73 74 61 74 VALUES ... stat
1b0f0 65 6d 65 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 20 ement, then. *
1b100 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 this
1b110 20 73 74 6f 72 65 73 20 76 61 6c 75 65 73 20 74 stores values t
1b120 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 20 4f o be inserted. O
1b130 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 therwise NULL..
1b140 2a 20 70 49 64 4c 69 73 74 20 20 20 2d 3e 20 49 * pIdList -> I
1b150 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 f this is an INS
1b160 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 28 3c 63 ERT INTO ... (<c
1b170 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 3e 29 20 56 41 olumn-names>) VA
1b180 4c 55 45 53 20 2e 2e 2e 20 0a 20 2a 20 20 20 20 LUES ... . *
1b190 20 20 20 20 20 20 20 20 20 20 73 74 61 74 65 6d statem
1b1a0 65 6e 74 2c 20 74 68 65 6e 20 74 68 69 73 20 73 ent, then this s
1b1b0 74 6f 72 65 73 20 74 68 65 20 63 6f 6c 75 6d 6e tores the column
1b1c0 2d 6e 61 6d 65 73 20 74 6f 20 62 65 0a 20 2a 20 -names to be. *
1b1d0 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 73 ins
1b1e0 65 72 74 65 64 20 69 6e 74 6f 2e 0a 20 2a 0a 20 erted into.. *.
1b1f0 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 44 45 4c 45 * (op == TK_DELE
1b200 54 45 29 0a 20 2a 20 74 61 72 67 65 74 20 20 20 TE). * target
1b210 20 2d 3e 20 41 20 74 6f 6b 65 6e 20 68 6f 6c 64 -> A token hold
1b220 69 6e 67 20 74 68 65 20 71 75 6f 74 65 64 20 6e ing the quoted n
1b230 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 ame of the table
1b240 20 74 6f 20 64 65 6c 65 74 65 20 66 72 6f 6d 2e to delete from.
1b250 0a 20 2a 20 70 57 68 65 72 65 20 20 20 20 2d 3e . * pWhere ->
1b260 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 The WHERE claus
1b270 65 20 6f 66 20 74 68 65 20 44 45 4c 45 54 45 20 e of the DELETE
1b280 73 74 61 74 65 6d 65 6e 74 20 69 66 20 6f 6e 65 statement if one
1b290 20 69 73 20 73 70 65 63 69 66 69 65 64 2e 0a 20 is specified..
1b2a0 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4f * O
1b2b0 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 therwise NULL..
1b2c0 2a 20 0a 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f * . * (op == TK_
1b2d0 55 50 44 41 54 45 29 0a 20 2a 20 74 61 72 67 65 UPDATE). * targe
1b2e0 74 20 20 20 20 2d 3e 20 41 20 74 6f 6b 65 6e 20 t -> A token
1b2f0 68 6f 6c 64 69 6e 67 20 74 68 65 20 71 75 6f 74 holding the quot
1b300 65 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 ed name of the t
1b310 61 62 6c 65 20 74 6f 20 75 70 64 61 74 65 20 72 able to update r
1b320 6f 77 73 20 6f 66 2e 0a 20 2a 20 70 57 68 65 72 ows of.. * pWher
1b330 65 20 20 20 20 2d 3e 20 54 68 65 20 57 48 45 52 e -> The WHER
1b340 45 20 63 6c 61 75 73 65 20 6f 66 20 74 68 65 20 E clause of the
1b350 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 UPDATE statement
1b360 20 69 66 20 6f 6e 65 20 69 73 20 73 70 65 63 69 if one is speci
1b370 66 69 65 64 2e 0a 20 2a 20 20 20 20 20 20 20 20 fied.. *
1b380 20 20 20 20 20 20 4f 74 68 65 72 77 69 73 65 20 Otherwise
1b390 4e 55 4c 4c 2e 0a 20 2a 20 70 45 78 70 72 4c 69 NULL.. * pExprLi
1b3a0 73 74 20 2d 3e 20 41 20 6c 69 73 74 20 6f 66 20 st -> A list of
1b3b0 74 68 65 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 75 the columns to u
1b3c0 70 64 61 74 65 20 61 6e 64 20 74 68 65 20 65 78 pdate and the ex
1b3d0 70 72 65 73 73 69 6f 6e 73 20 74 6f 20 75 70 64 pressions to upd
1b3e0 61 74 65 0a 20 2a 20 20 20 20 20 20 20 20 20 20 ate. *
1b3f0 20 20 20 20 74 68 65 6d 20 74 6f 2e 20 53 65 65 them to. See
1b400 20 73 71 6c 69 74 65 33 55 70 64 61 74 65 28 29 sqlite3Update()
1b410 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f documentation o
1b420 66 20 22 70 43 68 61 6e 67 65 73 22 0a 20 2a 20 f "pChanges". *
1b430 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 arg
1b440 75 6d 65 6e 74 2e 0a 20 2a 20 0a 20 2a 2f 0a 73 ument.. * . */.s
1b450 74 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 truct TriggerSte
1b460 70 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 p {. u8 op;
1b470 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e /* On
1b480 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 2c 20 e of TK_DELETE,
1b490 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e TK_UPDATE, TK_IN
1b4a0 53 45 52 54 2c 20 54 4b 5f 53 45 4c 45 43 54 20 SERT, TK_SELECT
1b4b0 2a 2f 0a 20 20 75 38 20 6f 72 63 6f 6e 66 3b 20 */. u8 orconf;
1b4c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f /* OE_
1b4d0 52 6f 6c 6c 62 61 63 6b 20 65 74 63 2e 20 2a 2f Rollback etc. */
1b4e0 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 72 69 . Trigger *pTri
1b4f0 67 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 g; /* The t
1b500 72 69 67 67 65 72 20 74 68 61 74 20 74 68 69 73 rigger that this
1b510 20 73 74 65 70 20 69 73 20 61 20 70 61 72 74 20 step is a part
1b520 6f 66 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a of */. Select *
1b530 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 pSelect; /*
1b540 53 45 4c 45 43 54 20 73 74 61 74 6d 65 6e 74 20 SELECT statment
1b550 6f 72 20 52 48 53 20 6f 66 20 49 4e 53 45 52 54 or RHS of INSERT
1b560 20 49 4e 54 4f 20 2e 2e 20 53 45 4c 45 43 54 20 INTO .. SELECT
1b570 2e 2e 2e 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 74 ... */. Token t
1b580 61 72 67 65 74 3b 20 20 20 20 20 20 20 20 2f 2a arget; /*
1b590 20 54 61 72 67 65 74 20 74 61 62 6c 65 20 66 6f Target table fo
1b5a0 72 20 44 45 4c 45 54 45 2c 20 55 50 44 41 54 45 r DELETE, UPDATE
1b5b0 2c 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 45 78 , INSERT */. Ex
1b5c0 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 20 pr *pWhere;
1b5d0 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 45 20 /* The WHERE
1b5e0 63 6c 61 75 73 65 20 66 6f 72 20 44 45 4c 45 54 clause for DELET
1b5f0 45 20 6f 72 20 55 50 44 41 54 45 20 73 74 65 70 E or UPDATE step
1b600 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
1b610 2a 70 45 78 70 72 4c 69 73 74 3b 20 2f 2a 20 53 *pExprList; /* S
1b620 45 54 20 63 6c 61 75 73 65 20 66 6f 72 20 55 50 ET clause for UP
1b630 44 41 54 45 2e 20 2a 2f 0a 20 20 49 64 4c 69 73 DATE. */. IdLis
1b640 74 20 2a 70 49 64 4c 69 73 74 3b 20 20 20 20 20 t *pIdList;
1b650 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 /* Column names
1b660 66 6f 72 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 for INSERT */.
1b670 54 72 69 67 67 65 72 53 74 65 70 20 2a 70 4e 65 TriggerStep *pNe
1b680 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 xt; /* Next in
1b690 74 68 65 20 6c 69 6e 6b 2d 6c 69 73 74 20 2a 2f the link-list */
1b6a0 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 20 2a . TriggerStep *
1b6b0 70 4c 61 73 74 3b 20 20 2f 2a 20 4c 61 73 74 20 pLast; /* Last
1b6c0 65 6c 65 6d 65 6e 74 20 69 6e 20 6c 69 6e 6b 2d element in link-
1b6d0 6c 69 73 74 2e 20 56 61 6c 69 64 20 66 6f 72 20 list. Valid for
1b6e0 31 73 74 20 65 6c 65 6d 20 6f 6e 6c 79 20 2a 2f 1st elem only */
1b6f0 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 .};../*.** The f
1b700 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
1b710 72 65 20 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f re contains info
1b720 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 62 79 20 rmation used by
1b730 74 68 65 20 73 71 6c 69 74 65 46 69 78 2e 2e 2e the sqliteFix...
1b740 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 20 61 73 20 .** routines as
1b750 74 68 65 79 20 77 61 6c 6b 20 74 68 65 20 70 61 they walk the pa
1b760 72 73 65 20 74 72 65 65 20 74 6f 20 6d 61 6b 65 rse tree to make
1b770 20 64 61 74 61 62 61 73 65 20 72 65 66 65 72 65 database refere
1b780 6e 63 65 73 0a 2a 2a 20 65 78 70 6c 69 63 69 74 nces.** explicit
1b790 2e 20 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 . .*/.typedef s
1b7a0 74 72 75 63 74 20 44 62 46 69 78 65 72 20 44 62 truct DbFixer Db
1b7b0 46 69 78 65 72 3b 0a 73 74 72 75 63 74 20 44 62 Fixer;.struct Db
1b7c0 46 69 78 65 72 20 7b 0a 20 20 50 61 72 73 65 20 Fixer {. Parse
1b7d0 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 2f 2a *pParse; /*
1b7e0 20 54 68 65 20 70 61 72 73 69 6e 67 20 63 6f 6e The parsing con
1b7f0 74 65 78 74 2e 20 20 45 72 72 6f 72 20 6d 65 73 text. Error mes
1b800 73 61 67 65 73 20 77 72 69 74 74 65 6e 20 68 65 sages written he
1b810 72 65 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a re */. Schema *
1b820 70 53 63 68 65 6d 61 3b 20 20 20 20 2f 2a 20 46 pSchema; /* F
1b830 69 78 20 69 74 65 6d 73 20 74 6f 20 74 68 69 73 ix items to this
1b840 20 73 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 schema */. int
1b850 20 62 56 61 72 4f 6e 6c 79 3b 20 20 20 20 20 20 bVarOnly;
1b860 20 2f 2a 20 43 68 65 63 6b 20 66 6f 72 20 76 61 /* Check for va
1b870 72 69 61 62 6c 65 20 72 65 66 65 72 65 6e 63 65 riable reference
1b880 73 20 6f 6e 6c 79 20 2a 2f 0a 20 20 63 6f 6e 73 s only */. cons
1b890 74 20 63 68 61 72 20 2a 7a 44 62 3b 20 20 20 20 t char *zDb;
1b8a0 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 61 6c 6c /* Make sure all
1b8b0 20 6f 62 6a 65 63 74 73 20 61 72 65 20 63 6f 6e objects are con
1b8c0 74 61 69 6e 65 64 20 69 6e 20 74 68 69 73 20 64 tained in this d
1b8d0 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 63 6f 6e atabase */. con
1b8e0 73 74 20 63 68 61 72 20 2a 7a 54 79 70 65 3b 20 st char *zType;
1b8f0 20 2f 2a 20 54 79 70 65 20 6f 66 20 74 68 65 20 /* Type of the
1b900 63 6f 6e 74 61 69 6e 65 72 20 2d 20 75 73 65 64 container - used
1b910 20 66 6f 72 20 65 72 72 6f 72 20 6d 65 73 73 61 for error messa
1b920 67 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 54 ges */. const T
1b930 6f 6b 65 6e 20 2a 70 4e 61 6d 65 3b 20 2f 2a 20 oken *pName; /*
1b940 4e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 74 Name of the cont
1b950 61 69 6e 65 72 20 2d 20 75 73 65 64 20 66 6f 72 ainer - used for
1b960 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 error messages
1b970 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 */.};../*.** An
1b980 6f 62 6a 65 63 74 65 64 20 75 73 65 64 20 74 6f objected used to
1b990 20 61 63 63 75 6d 75 6c 61 74 65 20 74 68 65 20 accumulate the
1b9a0 74 65 78 74 20 6f 66 20 61 20 73 74 72 69 6e 67 text of a string
1b9b0 20 77 68 65 72 65 20 77 65 0a 2a 2a 20 64 6f 20 where we.** do
1b9c0 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 not necessarily
1b9d0 6b 6e 6f 77 20 68 6f 77 20 62 69 67 20 74 68 65 know how big the
1b9e0 20 73 74 72 69 6e 67 20 77 69 6c 6c 20 62 65 20 string will be
1b9f0 69 6e 20 74 68 65 20 65 6e 64 2e 0a 2a 2f 0a 73 in the end..*/.s
1ba00 74 72 75 63 74 20 53 74 72 41 63 63 75 6d 20 7b truct StrAccum {
1ba10 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 . sqlite3 *db;
1ba20 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 74 69 6f /* Optio
1ba30 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 6f 72 nal database for
1ba40 20 6c 6f 6f 6b 61 73 69 64 65 2e 20 20 43 61 6e lookaside. Can
1ba50 20 62 65 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 68 be NULL */. ch
1ba60 61 72 20 2a 7a 42 61 73 65 3b 20 20 20 20 20 20 ar *zBase;
1ba70 20 20 20 2f 2a 20 41 20 62 61 73 65 20 61 6c 6c /* A base all
1ba80 6f 63 61 74 69 6f 6e 2e 20 20 4e 6f 74 20 66 72 ocation. Not fr
1ba90 6f 6d 20 6d 61 6c 6c 6f 63 2e 20 2a 2f 0a 20 20 om malloc. */.
1baa0 63 68 61 72 20 2a 7a 54 65 78 74 3b 20 20 20 20 char *zText;
1bab0 20 20 20 20 20 2f 2a 20 54 68 65 20 73 74 72 69 /* The stri
1bac0 6e 67 20 63 6f 6c 6c 65 63 74 65 64 20 73 6f 20 ng collected so
1bad0 66 61 72 20 2a 2f 0a 20 20 69 6e 74 20 20 6e 43 far */. int nC
1bae0 68 61 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a har; /*
1baf0 20 4c 65 6e 67 74 68 20 6f 66 20 74 68 65 20 73 Length of the s
1bb00 74 72 69 6e 67 20 73 6f 20 66 61 72 20 2a 2f 0a tring so far */.
1bb10 20 20 69 6e 74 20 20 6e 41 6c 6c 6f 63 3b 20 20 int nAlloc;
1bb20 20 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 /* Amount
1bb30 20 6f 66 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 of space alloca
1bb40 74 65 64 20 69 6e 20 7a 54 65 78 74 20 2a 2f 0a ted in zText */.
1bb50 20 20 69 6e 74 20 20 6d 78 41 6c 6c 6f 63 3b 20 int mxAlloc;
1bb60 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 /* Maximu
1bb70 6d 20 61 6c 6c 6f 77 65 64 20 73 74 72 69 6e 67 m allowed string
1bb80 20 6c 65 6e 67 74 68 20 2a 2f 0a 20 20 75 38 20 length */. u8
1bb90 20 20 75 73 65 4d 61 6c 6c 6f 63 3b 20 20 20 20 useMalloc;
1bba0 20 20 2f 2a 20 30 3a 20 6e 6f 6e 65 2c 20 20 31 /* 0: none, 1
1bbb0 3a 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f : sqlite3DbMallo
1bbc0 63 2c 20 20 32 3a 20 73 71 6c 69 74 65 33 5f 6d c, 2: sqlite3_m
1bbd0 61 6c 6c 6f 63 20 2a 2f 0a 20 20 75 38 20 20 20 alloc */. u8
1bbe0 61 63 63 45 72 72 6f 72 3b 20 20 20 20 20 20 20 accError;
1bbf0 2f 2a 20 53 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 /* STRACCUM_NOME
1bc00 4d 20 6f 72 20 53 54 52 41 43 43 55 4d 5f 54 4f M or STRACCUM_TO
1bc10 4f 42 49 47 20 2a 2f 0a 7d 3b 0a 23 64 65 66 69 OBIG */.};.#defi
1bc20 6e 65 20 53 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 ne STRACCUM_NOME
1bc30 4d 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 54 M 1.#define ST
1bc40 52 41 43 43 55 4d 5f 54 4f 4f 42 49 47 20 20 32 RACCUM_TOOBIG 2
1bc50 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 ../*.** A pointe
1bc60 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
1bc70 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 63 ure is used to c
1bc80 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e 66 6f 72 ommunicate infor
1bc90 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f 6d 20 73 mation.** from s
1bca0 71 6c 69 74 65 33 49 6e 69 74 20 61 6e 64 20 4f qlite3Init and O
1bcb0 50 5f 50 61 72 73 65 53 63 68 65 6d 61 20 69 6e P_ParseSchema in
1bcc0 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 49 6e to the sqlite3In
1bcd0 69 74 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74 itCallback..*/.t
1bce0 79 70 65 64 65 66 20 73 74 72 75 63 74 20 7b 0a ypedef struct {.
1bcf0 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 sqlite3 *db;
1bd00 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
1bd10 61 62 61 73 65 20 62 65 69 6e 67 20 69 6e 69 74 abase being init
1bd20 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 61 ialized */. cha
1bd30 72 20 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 20 r **pzErrMsg;
1bd40 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 /* Error messag
1bd50 65 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f e stored here */
1bd60 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20 . int iDb;
1bd70 20 20 20 20 20 20 20 2f 2a 20 30 20 66 6f 72 20 /* 0 for
1bd80 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 20 20 main database.
1bd90 31 20 66 6f 72 20 54 45 4d 50 2c 20 32 2e 2e 20 1 for TEMP, 2..
1bda0 66 6f 72 20 41 54 54 41 43 48 65 64 20 2a 2f 0a for ATTACHed */.
1bdb0 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
1bdc0 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
1bdd0 63 6f 64 65 20 73 74 6f 72 65 64 20 68 65 72 65 code stored here
1bde0 20 2a 2f 0a 7d 20 49 6e 69 74 44 61 74 61 3b 0a */.} InitData;.
1bdf0 0a 2f 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72 65 ./*.** Structure
1be00 20 63 6f 6e 74 61 69 6e 69 6e 67 20 67 6c 6f 62 containing glob
1be10 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e al configuration
1be20 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 53 51 data for the SQ
1be30 4c 69 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a 2a Lite library..**
1be40 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 .** This structu
1be50 72 65 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 re also contains
1be60 20 73 6f 6d 65 20 73 74 61 74 65 20 69 6e 66 6f some state info
1be70 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 rmation..*/.stru
1be80 63 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 67 ct Sqlite3Config
1be90 20 7b 0a 20 20 69 6e 74 20 62 4d 65 6d 73 74 61 {. int bMemsta
1bea0 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
1beb0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 /* True t
1bec0 6f 20 65 6e 61 62 6c 65 20 6d 65 6d 6f 72 79 20 o enable memory
1bed0 73 74 61 74 75 73 20 2a 2f 0a 20 20 69 6e 74 20 status */. int
1bee0 62 43 6f 72 65 4d 75 74 65 78 3b 20 20 20 20 20 bCoreMutex;
1bef0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1bf00 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 True to enable
1bf10 63 6f 72 65 20 6d 75 74 65 78 69 6e 67 20 2a 2f core mutexing */
1bf20 0a 20 20 69 6e 74 20 62 46 75 6c 6c 4d 75 74 65 . int bFullMute
1bf30 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
1bf40 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 /* True to
1bf50 65 6e 61 62 6c 65 20 66 75 6c 6c 20 6d 75 74 65 enable full mute
1bf60 78 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 4f xing */. int bO
1bf70 70 65 6e 55 72 69 3b 20 20 20 20 20 20 20 20 20 penUri;
1bf80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1bf90 72 75 65 20 74 6f 20 69 6e 74 65 72 70 72 65 74 rue to interpret
1bfa0 20 66 69 6c 65 6e 61 6d 65 73 20 61 73 20 55 52 filenames as UR
1bfb0 49 73 20 2a 2f 0a 20 20 69 6e 74 20 62 55 73 65 Is */. int bUse
1bfc0 43 69 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 Cis;
1bfd0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 /* Use
1bfe0 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 65 covering indice
1bff0 73 20 66 6f 72 20 66 75 6c 6c 2d 73 63 61 6e 73 s for full-scans
1c000 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 53 74 72 6c */. int mxStrl
1c010 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 en;
1c020 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d /* Maxim
1c030 75 6d 20 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 um string length
1c040 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 76 65 72 43 */. int neverC
1c050 6f 72 72 75 70 74 3b 20 20 20 20 20 20 20 20 20 orrupt;
1c060 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1c070 61 73 65 20 69 73 20 61 6c 77 61 79 73 20 77 65 ase is always we
1c080 6c 6c 2d 66 6f 72 6d 65 64 20 2a 2f 0a 20 20 69 ll-formed */. i
1c090 6e 74 20 73 7a 4c 6f 6f 6b 61 73 69 64 65 3b 20 nt szLookaside;
1c0a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c0b0 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b /* Default look
1c0c0 61 73 69 64 65 20 62 75 66 66 65 72 20 73 69 7a aside buffer siz
1c0d0 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 6f 6b e */. int nLook
1c0e0 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 aside;
1c0f0 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 /* Defa
1c100 75 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 ult lookaside bu
1c110 66 66 65 72 20 63 6f 75 6e 74 20 2a 2f 0a 20 20 ffer count */.
1c120 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
1c130 6f 64 73 20 6d 3b 20 20 20 20 20 20 20 20 20 20 ods m;
1c140 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d /* Low-level m
1c150 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
1c160 20 69 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 interface */.
1c170 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 sqlite3_mutex_me
1c180 74 68 6f 64 73 20 6d 75 74 65 78 3b 20 20 20 20 thods mutex;
1c190 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d /* Low-level m
1c1a0 75 74 65 78 20 69 6e 74 65 72 66 61 63 65 20 2a utex interface *
1c1b0 2f 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 /. sqlite3_pcac
1c1c0 68 65 5f 6d 65 74 68 6f 64 73 32 20 70 63 61 63 he_methods2 pcac
1c1d0 68 65 32 3b 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 he2; /* Low-lev
1c1e0 65 6c 20 70 61 67 65 2d 63 61 63 68 65 20 69 6e el page-cache in
1c1f0 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 76 6f 69 terface */. voi
1c200 64 20 2a 70 48 65 61 70 3b 20 20 20 20 20 20 20 d *pHeap;
1c210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1c220 2a 20 48 65 61 70 20 73 74 6f 72 61 67 65 20 73 * Heap storage s
1c230 70 61 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 48 pace */. int nH
1c240 65 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 eap;
1c250 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
1c260 69 7a 65 20 6f 66 20 70 48 65 61 70 5b 5d 20 2a ize of pHeap[] *
1c270 2f 0a 20 20 69 6e 74 20 6d 6e 52 65 71 2c 20 6d /. int mnReq, m
1c280 78 52 65 71 3b 20 20 20 20 20 20 20 20 20 20 20 xReq;
1c290 20 20 20 20 20 20 2f 2a 20 4d 69 6e 20 61 6e 64 /* Min and
1c2a0 20 6d 61 78 20 68 65 61 70 20 72 65 71 75 65 73 max heap reques
1c2b0 74 73 20 73 69 7a 65 73 20 2a 2f 0a 20 20 73 71 ts sizes */. sq
1c2c0 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d lite3_int64 szMm
1c2d0 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ap;
1c2e0 2f 2a 20 6d 6d 61 70 28 29 20 73 70 61 63 65 20 /* mmap() space
1c2f0 70 65 72 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f per open file */
1c300 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 . sqlite3_int64
1c310 20 6d 78 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 mxMmap;
1c320 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 /* Maximum
1c330 76 61 6c 75 65 20 66 6f 72 20 73 7a 4d 6d 61 70 value for szMmap
1c340 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 63 72 */. void *pScr
1c350 61 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 atch;
1c360 20 20 20 20 20 20 20 20 2f 2a 20 53 63 72 61 74 /* Scrat
1c370 63 68 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69 ch memory */. i
1c380 6e 74 20 73 7a 53 63 72 61 74 63 68 3b 20 20 20 nt szScratch;
1c390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c3a0 20 2f 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 /* Size of each
1c3b0 20 73 63 72 61 74 63 68 20 62 75 66 66 65 72 20 scratch buffer
1c3c0 2a 2f 0a 20 20 69 6e 74 20 6e 53 63 72 61 74 63 */. int nScratc
1c3d0 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
1c3e0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1c3f0 20 6f 66 20 73 63 72 61 74 63 68 20 62 75 66 66 of scratch buff
1c400 65 72 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ers */. void *p
1c410 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
1c420 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
1c430 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 ge cache memory
1c440 2a 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b */. int szPage;
1c450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c460 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
1c470 66 20 65 61 63 68 20 70 61 67 65 20 69 6e 20 70 f each page in p
1c480 50 61 67 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 Page[] */. int
1c490 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 nPage;
1c4a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1c4b0 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
1c4c0 20 69 6e 20 70 50 61 67 65 5b 5d 20 2a 2f 0a 20 in pPage[] */.
1c4d0 20 69 6e 74 20 6d 78 50 61 72 73 65 72 53 74 61 int mxParserSta
1c4e0 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ck;
1c4f0 20 20 20 2f 2a 20 6d 61 78 69 6d 75 6d 20 64 65 /* maximum de
1c500 70 74 68 20 6f 66 20 74 68 65 20 70 61 72 73 65 pth of the parse
1c510 72 20 73 74 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 r stack */. int
1c520 20 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 sharedCacheEnab
1c530 6c 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f led; /
1c540 2a 20 74 72 75 65 20 69 66 20 73 68 61 72 65 64 * true if shared
1c550 2d 63 61 63 68 65 20 6d 6f 64 65 20 65 6e 61 62 -cache mode enab
1c560 6c 65 64 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 led */. /* The
1c570 61 62 6f 76 65 20 6d 69 67 68 74 20 62 65 20 69 above might be i
1c580 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 6e 6f nitialized to no
1c590 6e 2d 7a 65 72 6f 2e 20 20 54 68 65 20 66 6f 6c n-zero. The fol
1c5a0 6c 6f 77 69 6e 67 20 6e 65 65 64 20 74 6f 20 61 lowing need to a
1c5b0 6c 77 61 79 73 0a 20 20 2a 2a 20 69 6e 69 74 69 lways. ** initi
1c5c0 61 6c 6c 79 20 62 65 20 7a 65 72 6f 2c 20 68 6f ally be zero, ho
1c5d0 77 65 76 65 72 2e 20 2a 2f 0a 20 20 69 6e 74 20 wever. */. int
1c5e0 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 isInit;
1c5f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1c600 20 54 72 75 65 20 61 66 74 65 72 20 69 6e 69 74 True after init
1c610 69 61 6c 69 7a 61 74 69 6f 6e 20 68 61 73 20 66 ialization has f
1c620 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 69 6e 74 inished */. int
1c630 20 69 6e 50 72 6f 67 72 65 73 73 3b 20 20 20 20 inProgress;
1c640 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1c650 2a 20 54 72 75 65 20 77 68 69 6c 65 20 69 6e 69 * True while ini
1c660 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 20 70 tialization in p
1c670 72 6f 67 72 65 73 73 20 2a 2f 0a 20 20 69 6e 74 rogress */. int
1c680 20 69 73 4d 75 74 65 78 49 6e 69 74 3b 20 20 20 isMutexInit;
1c690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1c6a0 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 75 74 * True after mut
1c6b0 65 78 65 73 20 61 72 65 20 69 6e 69 74 69 61 6c exes are initial
1c6c0 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 ized */. int is
1c6d0 4d 61 6c 6c 6f 63 49 6e 69 74 3b 20 20 20 20 20 MallocInit;
1c6e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1c6f0 72 75 65 20 61 66 74 65 72 20 6d 61 6c 6c 6f 63 rue after malloc
1c700 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 is initialized
1c710 2a 2f 0a 20 20 69 6e 74 20 69 73 50 43 61 63 68 */. int isPCach
1c720 65 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 eInit;
1c730 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 /* True a
1c740 66 74 65 72 20 6d 61 6c 6c 6f 63 20 69 73 20 69 fter malloc is i
1c750 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 nitialized */.
1c760 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 70 sqlite3_mutex *p
1c770 49 6e 69 74 4d 75 74 65 78 3b 20 20 20 20 20 20 InitMutex;
1c780 20 20 2f 2a 20 4d 75 74 65 78 20 75 73 65 64 20 /* Mutex used
1c790 62 79 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 69 by sqlite3_initi
1c7a0 61 6c 69 7a 65 28 29 20 2a 2f 0a 20 20 69 6e 74 alize() */. int
1c7b0 20 6e 52 65 66 49 6e 69 74 4d 75 74 65 78 3b 20 nRefInitMutex;
1c7c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1c7d0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 73 65 72 * Number of user
1c7e0 73 20 6f 66 20 70 49 6e 69 74 4d 75 74 65 78 20 s of pInitMutex
1c7f0 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 4c 6f 67 */. void (*xLog
1c800 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 )(void*,int,cons
1c810 74 20 63 68 61 72 2a 29 3b 20 2f 2a 20 46 75 6e t char*); /* Fun
1c820 63 74 69 6f 6e 20 66 6f 72 20 6c 6f 67 67 69 6e ction for loggin
1c830 67 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4c 6f g */. void *pLo
1c840 67 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 gArg;
1c850 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
1c860 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f irst argument to
1c870 20 78 4c 6f 67 28 29 20 2a 2f 0a 20 20 69 6e 74 xLog() */. int
1c880 20 62 4c 6f 63 61 6c 74 69 6d 65 46 61 75 6c 74 bLocaltimeFault
1c890 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
1c8a0 2a 20 54 72 75 65 20 74 6f 20 66 61 69 6c 20 6c * True to fail l
1c8b0 6f 63 61 6c 74 69 6d 65 28 29 20 63 61 6c 6c 73 ocaltime() calls
1c8c0 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
1c8d0 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a E_ENABLE_SQLLOG.
1c8e0 20 20 76 6f 69 64 28 2a 78 53 71 6c 6c 6f 67 29 void(*xSqllog)
1c8f0 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c (void*,sqlite3*,
1c900 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 const char*, int
1c910 29 3b 0a 20 20 76 6f 69 64 20 2a 70 53 71 6c 6c );. void *pSqll
1c920 6f 67 41 72 67 3b 0a 23 65 6e 64 69 66 0a 7d 3b ogArg;.#endif.};
1c930 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 6d 61 63 ../*.** This mac
1c940 72 6f 20 69 73 20 75 73 65 64 20 69 6e 73 69 64 ro is used insid
1c950 65 20 6f 66 20 61 73 73 65 72 74 28 29 20 73 74 e of assert() st
1c960 61 74 65 6d 65 6e 74 73 20 74 6f 20 69 6e 64 69 atements to indi
1c970 63 61 74 65 20 74 68 61 74 0a 2a 2a 20 74 68 65 cate that.** the
1c980 20 61 73 73 65 72 74 20 69 73 20 6f 6e 6c 79 20 assert is only
1c990 76 61 6c 69 64 20 6f 6e 20 61 20 77 65 6c 6c 2d valid on a well-
1c9a0 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 2e formed database.
1c9b0 20 20 49 6e 73 74 65 61 64 20 6f 66 3a 0a 2a 2a Instead of:.**
1c9c0 0a 2a 2a 20 20 20 20 20 61 73 73 65 72 74 28 20 .** assert(
1c9d0 58 20 29 3b 0a 2a 2a 0a 2a 2a 20 4f 6e 65 20 77 X );.**.** One w
1c9e0 72 69 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 rites:.**.**
1c9f0 20 61 73 73 65 72 74 28 20 58 20 7c 7c 20 43 4f assert( X || CO
1ca00 52 52 55 50 54 5f 44 42 20 29 3b 0a 2a 2a 0a 2a RRUPT_DB );.**.*
1ca10 2a 20 43 4f 52 52 55 50 54 5f 44 42 20 69 73 20 * CORRUPT_DB is
1ca20 74 72 75 65 20 64 75 72 69 6e 67 20 6e 6f 72 6d true during norm
1ca30 61 6c 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 43 al operation. C
1ca40 4f 52 52 55 50 54 5f 44 42 20 64 6f 65 73 20 6e ORRUPT_DB does n
1ca50 6f 74 20 69 6e 64 69 63 61 74 65 0a 2a 2a 20 74 ot indicate.** t
1ca60 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73 65 hat the database
1ca70 20 69 73 20 64 65 66 69 6e 69 74 65 6c 79 20 63 is definitely c
1ca80 6f 72 72 75 70 74 2c 20 6f 6e 6c 79 20 74 68 61 orrupt, only tha
1ca90 74 20 69 74 20 6d 69 67 68 74 20 62 65 20 63 6f t it might be co
1caa0 72 72 75 70 74 2e 0a 2a 2a 20 46 6f 72 20 6d 6f rrupt..** For mo
1cab0 73 74 20 74 65 73 74 20 63 61 73 65 73 2c 20 43 st test cases, C
1cac0 4f 52 52 55 50 54 5f 44 42 20 69 73 20 73 65 74 ORRUPT_DB is set
1cad0 20 74 6f 20 66 61 6c 73 65 20 75 73 69 6e 67 20 to false using
1cae0 61 20 73 70 65 63 69 61 6c 0a 2a 2a 20 73 71 6c a special.** sql
1caf0 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
1cb00 6c 28 29 2e 20 20 54 68 69 73 20 65 6e 61 62 6c l(). This enabl
1cb10 65 73 20 61 73 73 65 72 74 28 29 20 73 74 61 74 es assert() stat
1cb20 65 6d 65 6e 74 73 20 74 6f 20 70 72 6f 76 65 0a ements to prove.
1cb30 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 74 20 61 ** things that a
1cb40 72 65 20 61 6c 77 61 79 73 20 74 72 75 65 20 66 re always true f
1cb50 6f 72 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 or well-formed d
1cb60 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a 23 64 65 atabases..*/.#de
1cb70 66 69 6e 65 20 43 4f 52 52 55 50 54 5f 44 42 20 fine CORRUPT_DB
1cb80 20 28 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 2e (sqlite3Config.
1cb90 6e 65 76 65 72 43 6f 72 72 75 70 74 3d 3d 30 29 neverCorrupt==0)
1cba0 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 74 65 78 74 20 ../*.** Context
1cbb0 70 6f 69 6e 74 65 72 20 70 61 73 73 65 64 20 64 pointer passed d
1cbc0 6f 77 6e 20 74 68 72 6f 75 67 68 20 74 68 65 20 own through the
1cbd0 74 72 65 65 2d 77 61 6c 6b 2e 0a 2a 2f 0a 73 74 tree-walk..*/.st
1cbe0 72 75 63 74 20 57 61 6c 6b 65 72 20 7b 0a 20 20 ruct Walker {.
1cbf0 69 6e 74 20 28 2a 78 45 78 70 72 43 61 6c 6c 62 int (*xExprCallb
1cc00 61 63 6b 29 28 57 61 6c 6b 65 72 2a 2c 20 45 78 ack)(Walker*, Ex
1cc10 70 72 2a 29 3b 20 20 20 20 20 2f 2a 20 43 61 6c pr*); /* Cal
1cc20 6c 62 61 63 6b 20 66 6f 72 20 65 78 70 72 65 73 lback for expres
1cc30 73 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 28 sions */. int (
1cc40 2a 78 53 65 6c 65 63 74 43 61 6c 6c 62 61 63 6b *xSelectCallback
1cc50 29 28 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 63 74 )(Walker*,Select
1cc60 2a 29 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b *); /* Callback
1cc70 20 66 6f 72 20 53 45 4c 45 43 54 73 20 2a 2f 0a for SELECTs */.
1cc80 20 20 76 6f 69 64 20 28 2a 78 53 65 6c 65 63 74 void (*xSelect
1cc90 43 61 6c 6c 62 61 63 6b 32 29 28 57 61 6c 6b 65 Callback2)(Walke
1cca0 72 2a 2c 53 65 6c 65 63 74 2a 29 3b 2f 2a 20 53 r*,Select*);/* S
1ccb0 65 63 6f 6e 64 20 63 61 6c 6c 62 61 63 6b 20 66 econd callback f
1ccc0 6f 72 20 53 45 4c 45 43 54 73 20 2a 2f 0a 20 20 or SELECTs */.
1ccd0 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 Parse *pParse;
1cce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ccf0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 /* Par
1cd00 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 20 2a 2f ser context. */
1cd10 0a 20 20 69 6e 74 20 77 61 6c 6b 65 72 44 65 70 . int walkerDep
1cd20 74 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 th;
1cd30 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1cd40 4e 75 6d 62 65 72 20 6f 66 20 73 75 62 71 75 65 Number of subque
1cd50 72 69 65 73 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 ries */. union
1cd60 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
1cd70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cd80 20 20 20 20 2f 2a 20 45 78 74 72 61 20 64 61 74 /* Extra dat
1cd90 61 20 66 6f 72 20 63 61 6c 6c 62 61 63 6b 20 2a a for callback *
1cda0 2f 0a 20 20 20 20 4e 61 6d 65 43 6f 6e 74 65 78 /. NameContex
1cdb0 74 20 2a 70 4e 43 3b 20 20 20 20 20 20 20 20 20 t *pNC;
1cdc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1cdd0 20 2f 2a 20 4e 61 6d 69 6e 67 20 63 6f 6e 74 65 /* Naming conte
1cde0 78 74 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 3b xt */. int i;
1cdf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ce00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ce10 20 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 /* Integer
1ce20 76 61 6c 75 65 20 2a 2f 0a 20 20 20 20 53 72 63 value */. Src
1ce30 4c 69 73 74 20 2a 70 53 72 63 4c 69 73 74 3b 20 List *pSrcList;
1ce40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ce50 20 20 20 20 20 20 20 20 2f 2a 20 46 52 4f 4d 20 /* FROM
1ce60 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 73 74 clause */. st
1ce70 72 75 63 74 20 53 72 63 43 6f 75 6e 74 20 2a 70 ruct SrcCount *p
1ce80 53 72 63 43 6f 75 6e 74 3b 20 20 20 20 20 20 20 SrcCount;
1ce90 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e /* Coun
1cea0 74 69 6e 67 20 63 6f 6c 75 6d 6e 20 72 65 66 65 ting column refe
1ceb0 72 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 75 3b rences */. } u;
1cec0 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 .};../* Forward
1ced0 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 2a 2f 0a declarations */.
1cee0 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 6b 45 int sqlite3WalkE
1cef0 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 xpr(Walker*, Exp
1cf00 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
1cf10 57 61 6c 6b 45 78 70 72 4c 69 73 74 28 57 61 6c WalkExprList(Wal
1cf20 6b 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 ker*, ExprList*)
1cf30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c ;.int sqlite3Wal
1cf40 6b 53 65 6c 65 63 74 28 57 61 6c 6b 65 72 2a 2c kSelect(Walker*,
1cf50 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 Select*);.int s
1cf60 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 qlite3WalkSelect
1cf70 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 53 65 Expr(Walker*, Se
1cf80 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 lect*);.int sqli
1cf90 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 46 72 6f te3WalkSelectFro
1cfa0 6d 28 57 61 6c 6b 65 72 2a 2c 20 53 65 6c 65 63 m(Walker*, Selec
1cfb0 74 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 t*);../*.** Retu
1cfc0 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 65 rn code from the
1cfd0 20 70 61 72 73 65 2d 74 72 65 65 20 77 61 6c 6b parse-tree walk
1cfe0 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 20 61 ing primitives a
1cff0 6e 64 20 74 68 65 69 72 0a 2a 2a 20 63 61 6c 6c nd their.** call
1d000 62 61 63 6b 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e backs..*/.#defin
1d010 65 20 57 52 43 5f 43 6f 6e 74 69 6e 75 65 20 20 e WRC_Continue
1d020 20 20 30 20 20 20 2f 2a 20 43 6f 6e 74 69 6e 75 0 /* Continu
1d030 65 20 64 6f 77 6e 20 69 6e 74 6f 20 63 68 69 6c e down into chil
1d040 64 72 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 dren */.#define
1d050 57 52 43 5f 50 72 75 6e 65 20 20 20 20 20 20 20 WRC_Prune
1d060 31 20 20 20 2f 2a 20 4f 6d 69 74 20 63 68 69 6c 1 /* Omit chil
1d070 64 72 65 6e 20 62 75 74 20 63 6f 6e 74 69 6e 75 dren but continu
1d080 65 20 77 61 6c 6b 69 6e 67 20 73 69 62 6c 69 6e e walking siblin
1d090 67 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 52 gs */.#define WR
1d0a0 43 5f 41 62 6f 72 74 20 20 20 20 20 20 20 32 20 C_Abort 2
1d0b0 20 20 2f 2a 20 41 62 61 6e 64 6f 6e 20 74 68 65 /* Abandon the
1d0c0 20 74 72 65 65 20 77 61 6c 6b 20 2a 2f 0a 0a 2f tree walk */../
1d0d0 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
1d0e0 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 of this structu
1d0f0 72 65 20 72 65 70 72 65 73 65 6e 74 73 20 61 20 re represents a
1d100 73 65 74 20 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f set of one or mo
1d110 72 65 20 43 54 45 73 0a 2a 2a 20 28 63 6f 6d 6d re CTEs.** (comm
1d120 6f 6e 20 74 61 62 6c 65 20 65 78 70 72 65 73 73 on table express
1d130 69 6f 6e 73 29 20 63 72 65 61 74 65 64 20 62 79 ions) created by
1d140 20 61 20 73 69 6e 67 6c 65 20 57 49 54 48 20 63 a single WITH c
1d150 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 lause..*/.struct
1d160 20 57 69 74 68 20 7b 0a 20 20 69 6e 74 20 6e 43 With {. int nC
1d170 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 te;
1d180 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1d190 62 65 72 20 6f 66 20 43 54 45 73 20 69 6e 20 74 ber of CTEs in t
1d1a0 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 20 2a he WITH clause *
1d1b0 2f 0a 20 20 57 69 74 68 20 2a 70 4f 75 74 65 72 /. With *pOuter
1d1c0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1d1d0 20 20 20 20 2f 2a 20 43 6f 6e 74 61 69 6e 69 6e /* Containin
1d1e0 67 20 57 49 54 48 20 63 6c 61 75 73 65 2c 20 6f g WITH clause, o
1d1f0 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 73 74 72 75 r NULL */. stru
1d200 63 74 20 43 74 65 20 7b 20 20 20 20 20 20 20 20 ct Cte {
1d210 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
1d220 6f 72 20 65 61 63 68 20 43 54 45 20 69 6e 20 74 or each CTE in t
1d230 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 2e 2e he WITH clause..
1d240 2e 2e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a .. */. char *
1d250 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 zName;
1d260 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d /* Nam
1d270 65 20 6f 66 20 74 68 69 73 20 43 54 45 20 2a 2f e of this CTE */
1d280 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 2a 70 . ExprList *p
1d290 43 6f 6c 73 3b 20 20 20 20 20 20 20 20 20 20 20 Cols;
1d2a0 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
1d2b0 65 78 70 6c 69 63 69 74 20 63 6f 6c 75 6d 6e 20 explicit column
1d2c0 6e 61 6d 65 73 2c 20 6f 72 20 4e 55 4c 4c 20 2a names, or NULL *
1d2d0 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 /. Select *pS
1d2e0 65 6c 65 63 74 3b 20 20 20 20 20 20 20 20 20 20 elect;
1d2f0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 65 66 /* The def
1d300 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 inition of this
1d310 43 54 45 20 2a 2f 0a 20 20 20 20 63 6f 6e 73 74 CTE */. const
1d320 20 63 68 61 72 20 2a 7a 45 72 72 3b 20 20 20 20 char *zErr;
1d330 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 /* Er
1d340 72 6f 72 20 6d 65 73 73 61 67 65 20 66 6f 72 20 ror message for
1d350 63 69 72 63 75 6c 61 72 20 72 65 66 65 72 65 6e circular referen
1d360 63 65 73 20 2a 2f 0a 20 20 7d 20 61 5b 31 5d 3b ces */. } a[1];
1d370 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 6d .};../*.** Assum
1d380 69 6e 67 20 7a 49 6e 20 70 6f 69 6e 74 73 20 74 ing zIn points t
1d390 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 o the first byte
1d3a0 20 6f 66 20 61 20 55 54 46 2d 38 20 63 68 61 72 of a UTF-8 char
1d3b0 61 63 74 65 72 2c 0a 2a 2a 20 61 64 76 61 6e 63 acter,.** advanc
1d3c0 65 20 7a 49 6e 20 74 6f 20 70 6f 69 6e 74 20 74 e zIn to point t
1d3d0 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 65 o the first byte
1d3e0 20 6f 66 20 74 68 65 20 6e 65 78 74 20 55 54 46 of the next UTF
1d3f0 2d 38 20 63 68 61 72 61 63 74 65 72 2e 0a 2a 2f -8 character..*/
1d400 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
1d410 53 4b 49 50 5f 55 54 46 38 28 7a 49 6e 29 20 7b SKIP_UTF8(zIn) {
1d420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d430 20 20 20 20 20 20 20 20 5c 0a 20 20 69 66 28 20 \. if(
1d440 28 2a 28 7a 49 6e 2b 2b 29 29 3e 3d 30 78 63 30 (*(zIn++))>=0xc0
1d450 20 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 ){
1d460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d470 20 5c 0a 20 20 20 20 77 68 69 6c 65 28 20 28 2a \. while( (*
1d480 7a 49 6e 20 26 20 30 78 63 30 29 3d 3d 30 78 38 zIn & 0xc0)==0x8
1d490 30 20 29 7b 20 7a 49 6e 2b 2b 3b 20 7d 20 20 20 0 ){ zIn++; }
1d4a0 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 7d 20 \. }
1d4b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d4c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d4d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d4e0 20 20 20 5c 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 \.}../*.** Th
1d4f0 65 20 53 51 4c 49 54 45 5f 2a 5f 42 4b 50 54 20 e SQLITE_*_BKPT
1d500 6d 61 63 72 6f 73 20 61 72 65 20 73 75 62 73 74 macros are subst
1d510 69 74 75 74 65 73 20 66 6f 72 20 74 68 65 20 65 itutes for the e
1d520 72 72 6f 72 20 63 6f 64 65 73 20 77 69 74 68 0a rror codes with.
1d530 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 ** the same name
1d540 20 62 75 74 20 77 69 74 68 6f 75 74 20 74 68 65 but without the
1d550 20 5f 42 4b 50 54 20 73 75 66 66 69 78 2e 20 20 _BKPT suffix.
1d560 54 68 65 73 65 20 6d 61 63 72 6f 73 20 69 6e 76 These macros inv
1d570 6f 6b 65 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 20 oke.** routines
1d580 74 68 61 74 20 72 65 70 6f 72 74 20 74 68 65 20 that report the
1d590 6c 69 6e 65 2d 6e 75 6d 62 65 72 20 6f 6e 20 77 line-number on w
1d5a0 68 69 63 68 20 74 68 65 20 65 72 72 6f 72 20 6f hich the error o
1d5b0 72 69 67 69 6e 61 74 65 64 0a 2a 2a 20 75 73 69 riginated.** usi
1d5c0 6e 67 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 29 ng sqlite3_log()
1d5d0 2e 20 20 54 68 65 20 72 6f 75 74 69 6e 65 73 20 . The routines
1d5e0 61 6c 73 6f 20 70 72 6f 76 69 64 65 20 61 20 63 also provide a c
1d5f0 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 65 0a onvenient place.
1d600 2a 2a 20 74 6f 20 73 65 74 20 61 20 64 65 62 75 ** to set a debu
1d610 67 67 65 72 20 62 72 65 61 6b 70 6f 69 6e 74 2e gger breakpoint.
1d620 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 .*/.int sqlite3C
1d630 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 74 29 orruptError(int)
1d640 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 69 73 ;.int sqlite3Mis
1d650 75 73 65 45 72 72 6f 72 28 69 6e 74 29 3b 0a 69 useError(int);.i
1d660 6e 74 20 73 71 6c 69 74 65 33 43 61 6e 74 6f 70 nt sqlite3Cantop
1d670 65 6e 45 72 72 6f 72 28 69 6e 74 29 3b 0a 23 64 enError(int);.#d
1d680 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 4f 52 efine SQLITE_COR
1d690 52 55 50 54 5f 42 4b 50 54 20 73 71 6c 69 74 65 RUPT_BKPT sqlite
1d6a0 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 5f 5f 3CorruptError(__
1d6b0 4c 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e 65 20 LINE__).#define
1d6c0 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
1d6d0 50 54 20 73 71 6c 69 74 65 33 4d 69 73 75 73 65 PT sqlite3Misuse
1d6e0 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a Error(__LINE__).
1d6f0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 #define SQLITE_C
1d700 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 20 73 71 6c ANTOPEN_BKPT sql
1d710 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f ite3CantopenErro
1d720 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 0a 0a 2f 2a r(__LINE__).../*
1d730 0a 2a 2a 20 46 54 53 34 20 69 73 20 72 65 61 6c .** FTS4 is real
1d740 6c 79 20 61 6e 20 65 78 74 65 6e 73 69 6f 6e 20 ly an extension
1d750 66 6f 72 20 46 54 53 33 2e 20 20 49 74 20 69 73 for FTS3. It is
1d760 20 65 6e 61 62 6c 65 64 20 75 73 69 6e 67 20 74 enabled using t
1d770 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 45 4e 41 he.** SQLITE_ENA
1d780 42 4c 45 5f 46 54 53 33 20 6d 61 63 72 6f 2e 20 BLE_FTS3 macro.
1d790 20 42 75 74 20 74 6f 20 61 76 6f 69 64 20 63 6f But to avoid co
1d7a0 6e 66 75 73 69 6f 6e 20 77 65 20 61 6c 73 6f 20 nfusion we also
1d7b0 61 6c 6c 0a 2a 2a 20 74 68 65 20 53 51 4c 49 54 all.** the SQLIT
1d7c0 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 20 6d 61 E_ENABLE_FTS4 ma
1d7d0 63 72 6f 20 74 6f 20 73 65 72 76 65 20 61 73 20 cro to serve as
1d7e0 61 6e 20 61 6c 69 73 73 65 20 66 6f 72 20 53 51 an alisse for SQ
1d7f0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 LITE_ENABLE_FTS3
1d800 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 ..*/.#if defined
1d810 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 (SQLITE_ENABLE_F
1d820 54 53 34 29 20 26 26 20 21 64 65 66 69 6e 65 64 TS4) && !defined
1d830 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 (SQLITE_ENABLE_F
1d840 54 53 33 29 0a 23 20 64 65 66 69 6e 65 20 53 51 TS3).# define SQ
1d850 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 LITE_ENABLE_FTS3
1d860 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
1d870 68 65 20 63 74 79 70 65 2e 68 20 68 65 61 64 65 he ctype.h heade
1d880 72 20 69 73 20 6e 65 65 64 65 64 20 66 6f 72 20 r is needed for
1d890 6e 6f 6e 2d 41 53 43 49 49 20 73 79 73 74 65 6d non-ASCII system
1d8a0 73 2e 20 20 49 74 20 69 73 20 61 6c 73 6f 0a 2a s. It is also.*
1d8b0 2a 20 6e 65 65 64 65 64 20 62 79 20 46 54 53 33 * needed by FTS3
1d8c0 20 77 68 65 6e 20 46 54 53 33 20 69 73 20 69 6e when FTS3 is in
1d8d0 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 61 6d cluded in the am
1d8e0 61 6c 67 61 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 23 algamation..*/.#
1d8f0 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 if !defined(SQLI
1d900 54 45 5f 41 53 43 49 49 29 20 7c 7c 20 5c 0a 20 TE_ASCII) || \.
1d910 20 20 20 28 64 65 66 69 6e 65 64 28 53 51 4c 49 (defined(SQLI
1d920 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 29 20 TE_ENABLE_FTS3)
1d930 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 && defined(SQLIT
1d940 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 29 29 E_AMALGAMATION))
1d950 0a 23 20 69 6e 63 6c 75 64 65 20 3c 63 74 79 70 .# include <ctyp
1d960 65 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a e.h>.#endif../*.
1d970 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
1d980 20 6d 61 63 72 6f 73 20 6d 69 6d 69 63 20 74 68 macros mimic th
1d990 65 20 73 74 61 6e 64 61 72 64 20 6c 69 62 72 61 e standard libra
1d9a0 72 79 20 66 75 6e 63 74 69 6f 6e 73 20 74 6f 75 ry functions tou
1d9b0 70 70 65 72 28 29 2c 0a 2a 2a 20 69 73 73 70 61 pper(),.** isspa
1d9c0 63 65 28 29 2c 20 69 73 61 6c 6e 75 6d 28 29 2c ce(), isalnum(),
1d9d0 20 69 73 64 69 67 69 74 28 29 20 61 6e 64 20 69 isdigit() and i
1d9e0 73 78 64 69 67 69 74 28 29 2c 20 72 65 73 70 65 sxdigit(), respe
1d9f0 63 74 69 76 65 6c 79 2e 20 54 68 65 0a 2a 2a 20 ctively. The.**
1da00 73 71 6c 69 74 65 20 76 65 72 73 69 6f 6e 73 20 sqlite versions
1da10 6f 6e 6c 79 20 77 6f 72 6b 20 66 6f 72 20 41 53 only work for AS
1da20 43 49 49 20 63 68 61 72 61 63 74 65 72 73 2c 20 CII characters,
1da30 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 6c 6f regardless of lo
1da40 63 61 6c 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 cale..*/.#ifdef
1da50 53 51 4c 49 54 45 5f 41 53 43 49 49 0a 23 20 64 SQLITE_ASCII.# d
1da60 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f 75 efine sqlite3Tou
1da70 70 70 65 72 28 78 29 20 20 28 28 78 29 26 7e 28 pper(x) ((x)&~(
1da80 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b sqlite3CtypeMap[
1da90 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
1daa0 78 29 5d 26 30 78 32 30 29 29 0a 23 20 64 65 66 x)]&0x20)).# def
1dab0 69 6e 65 20 73 71 6c 69 74 65 33 49 73 73 70 61 ine sqlite3Isspa
1dac0 63 65 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 ce(x) (sqlite3
1dad0 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e CtypeMap[(unsign
1dae0 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 ed char)(x)]&0x0
1daf0 31 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 1).# define sqli
1db00 74 65 33 49 73 61 6c 6e 75 6d 28 78 29 20 20 20 te3Isalnum(x)
1db10 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 (sqlite3CtypeMap
1db20 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 [(unsigned char)
1db30 28 78 29 5d 26 30 78 30 36 29 0a 23 20 64 65 66 (x)]&0x06).# def
1db40 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 6c 70 ine sqlite3Isalp
1db50 68 61 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 ha(x) (sqlite3
1db60 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e CtypeMap[(unsign
1db70 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 ed char)(x)]&0x0
1db80 32 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 2).# define sqli
1db90 74 65 33 49 73 64 69 67 69 74 28 78 29 20 20 20 te3Isdigit(x)
1dba0 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 (sqlite3CtypeMap
1dbb0 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 [(unsigned char)
1dbc0 28 78 29 5d 26 30 78 30 34 29 0a 23 20 64 65 66 (x)]&0x04).# def
1dbd0 69 6e 65 20 73 71 6c 69 74 65 33 49 73 78 64 69 ine sqlite3Isxdi
1dbe0 67 69 74 28 78 29 20 20 28 73 71 6c 69 74 65 33 git(x) (sqlite3
1dbf0 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e CtypeMap[(unsign
1dc00 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 ed char)(x)]&0x0
1dc10 38 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 8).# define sqli
1dc20 74 65 33 54 6f 6c 6f 77 65 72 28 78 29 20 20 20 te3Tolower(x)
1dc30 28 73 71 6c 69 74 65 33 55 70 70 65 72 54 6f 4c (sqlite3UpperToL
1dc40 6f 77 65 72 5b 28 75 6e 73 69 67 6e 65 64 20 63 ower[(unsigned c
1dc50 68 61 72 29 28 78 29 5d 29 0a 23 65 6c 73 65 0a har)(x)]).#else.
1dc60 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
1dc70 54 6f 75 70 70 65 72 28 78 29 20 20 20 74 6f 75 Toupper(x) tou
1dc80 70 70 65 72 28 28 75 6e 73 69 67 6e 65 64 20 63 pper((unsigned c
1dc90 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e har)(x)).# defin
1dca0 65 20 73 71 6c 69 74 65 33 49 73 73 70 61 63 65 e sqlite3Isspace
1dcb0 28 78 29 20 20 20 69 73 73 70 61 63 65 28 28 75 (x) isspace((u
1dcc0 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
1dcd0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
1dce0 65 33 49 73 61 6c 6e 75 6d 28 78 29 20 20 20 69 e3Isalnum(x) i
1dcf0 73 61 6c 6e 75 6d 28 28 75 6e 73 69 67 6e 65 64 salnum((unsigned
1dd00 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 char)(x)).# def
1dd10 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 6c 70 ine sqlite3Isalp
1dd20 68 61 28 78 29 20 20 20 69 73 61 6c 70 68 61 28 ha(x) isalpha(
1dd30 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
1dd40 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c x)).# define sql
1dd50 69 74 65 33 49 73 64 69 67 69 74 28 78 29 20 20 ite3Isdigit(x)
1dd60 20 69 73 64 69 67 69 74 28 28 75 6e 73 69 67 6e isdigit((unsign
1dd70 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 ed char)(x)).# d
1dd80 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 78 efine sqlite3Isx
1dd90 64 69 67 69 74 28 78 29 20 20 69 73 78 64 69 67 digit(x) isxdig
1dda0 69 74 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 it((unsigned cha
1ddb0 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 r)(x)).# define
1ddc0 73 71 6c 69 74 65 33 54 6f 6c 6f 77 65 72 28 78 sqlite3Tolower(x
1ddd0 29 20 20 20 74 6f 6c 6f 77 65 72 28 28 75 6e 73 ) tolower((uns
1dde0 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a igned char)(x)).
1ddf0 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e #endif../*.** In
1de00 74 65 72 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 ternal function
1de10 70 72 6f 74 6f 74 79 70 65 73 0a 2a 2f 0a 23 64 prototypes.*/.#d
1de20 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 72 efine sqlite3Str
1de30 49 43 6d 70 20 73 71 6c 69 74 65 33 5f 73 74 72 ICmp sqlite3_str
1de40 69 63 6d 70 0a 69 6e 74 20 73 71 6c 69 74 65 33 icmp.int sqlite3
1de50 53 74 72 6c 65 6e 33 30 28 63 6f 6e 73 74 20 63 Strlen30(const c
1de60 68 61 72 2a 29 3b 0a 23 64 65 66 69 6e 65 20 73 har*);.#define s
1de70 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 20 73 qlite3StrNICmp s
1de80 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d 70 0a qlite3_strnicmp.
1de90 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 6c 6c .int sqlite3Mall
1dea0 6f 63 49 6e 69 74 28 76 6f 69 64 29 3b 0a 76 6f ocInit(void);.vo
1deb0 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 id sqlite3Malloc
1dec0 45 6e 64 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 End(void);.void
1ded0 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 69 *sqlite3Malloc(i
1dee0 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 nt);.void *sqlit
1def0 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 69 6e 74 e3MallocZero(int
1df00 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 );.void *sqlite3
1df10 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 71 6c DbMallocZero(sql
1df20 69 74 65 33 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 ite3*, int);.voi
1df30 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c d *sqlite3DbMall
1df40 6f 63 52 61 77 28 73 71 6c 69 74 65 33 2a 2c 20 ocRaw(sqlite3*,
1df50 69 6e 74 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 int);.char *sqli
1df60 74 65 33 44 62 53 74 72 44 75 70 28 73 71 6c 69 te3DbStrDup(sqli
1df70 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
1df80 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
1df90 44 62 53 74 72 4e 44 75 70 28 73 71 6c 69 74 65 DbStrNDup(sqlite
1dfa0 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 3*,const char*,
1dfb0 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 int);.void *sqli
1dfc0 74 65 33 52 65 61 6c 6c 6f 63 28 76 6f 69 64 2a te3Realloc(void*
1dfd0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 , int);.void *sq
1dfe0 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 4f 72 lite3DbReallocOr
1dff0 46 72 65 65 28 73 71 6c 69 74 65 33 20 2a 2c 20 Free(sqlite3 *,
1e000 76 6f 69 64 20 2a 2c 20 69 6e 74 29 3b 0a 76 6f void *, int);.vo
1e010 69 64 20 2a 73 71 6c 69 74 65 33 44 62 52 65 61 id *sqlite3DbRea
1e020 6c 6c 6f 63 28 73 71 6c 69 74 65 33 20 2a 2c 20 lloc(sqlite3 *,
1e030 76 6f 69 64 20 2a 2c 20 69 6e 74 29 3b 0a 76 6f void *, int);.vo
1e040 69 64 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 id sqlite3DbFree
1e050 28 73 71 6c 69 74 65 33 2a 2c 20 76 6f 69 64 2a (sqlite3*, void*
1e060 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 );.int sqlite3Ma
1e070 6c 6c 6f 63 53 69 7a 65 28 76 6f 69 64 2a 29 3b llocSize(void*);
1e080 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 62 4d 61 .int sqlite3DbMa
1e090 6c 6c 6f 63 53 69 7a 65 28 73 71 6c 69 74 65 33 llocSize(sqlite3
1e0a0 2a 2c 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 *, void*);.void
1e0b0 2a 73 71 6c 69 74 65 33 53 63 72 61 74 63 68 4d *sqlite3ScratchM
1e0c0 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 alloc(int);.void
1e0d0 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 68 46 sqlite3ScratchF
1e0e0 72 65 65 28 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 ree(void*);.void
1e0f0 20 2a 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c *sqlite3PageMal
1e100 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 loc(int);.void s
1e110 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 76 qlite3PageFree(v
1e120 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 oid*);.void sqli
1e130 74 65 33 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 te3MemSetDefault
1e140 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c (void);.void sql
1e150 69 74 65 33 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 ite3BenignMalloc
1e160 48 6f 6f 6b 73 28 76 6f 69 64 20 28 2a 29 28 76 Hooks(void (*)(v
1e170 6f 69 64 29 2c 20 76 6f 69 64 20 28 2a 29 28 76 oid), void (*)(v
1e180 6f 69 64 29 29 3b 0a 69 6e 74 20 73 71 6c 69 74 oid));.int sqlit
1e190 65 33 48 65 61 70 4e 65 61 72 6c 79 46 75 6c 6c e3HeapNearlyFull
1e1a0 28 76 6f 69 64 29 3b 0a 0a 2f 2a 0a 2a 2a 20 4f (void);../*.** O
1e1b0 6e 20 73 79 73 74 65 6d 73 20 77 69 74 68 20 61 n systems with a
1e1c0 6d 70 6c 65 20 73 74 61 63 6b 20 73 70 61 63 65 mple stack space
1e1d0 20 61 6e 64 20 74 68 61 74 20 73 75 70 70 6f 72 and that suppor
1e1e0 74 20 61 6c 6c 6f 63 61 28 29 2c 20 6d 61 6b 65 t alloca(), make
1e1f0 0a 2a 2a 20 75 73 65 20 6f 66 20 61 6c 6c 6f 63 .** use of alloc
1e200 61 28 29 20 74 6f 20 6f 62 74 61 69 6e 20 73 70 a() to obtain sp
1e210 61 63 65 20 66 6f 72 20 6c 61 72 67 65 20 61 75 ace for large au
1e220 74 6f 6d 61 74 69 63 20 6f 62 6a 65 63 74 73 2e tomatic objects.
1e230 20 20 42 79 20 64 65 66 61 75 6c 74 2c 0a 2a 2a By default,.**
1e240 20 6f 62 74 61 69 6e 20 73 70 61 63 65 20 66 72 obtain space fr
1e250 6f 6d 20 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 0a om malloc()..**.
1e260 2a 2a 20 54 68 65 20 61 6c 6c 6f 63 61 28 29 20 ** The alloca()
1e270 72 6f 75 74 69 6e 65 20 6e 65 76 65 72 20 72 65 routine never re
1e280 74 75 72 6e 73 20 4e 55 4c 4c 2e 20 20 54 68 69 turns NULL. Thi
1e290 73 20 77 69 6c 6c 20 63 61 75 73 65 20 63 6f 64 s will cause cod
1e2a0 65 20 70 61 74 68 73 0a 2a 2a 20 74 68 61 74 20 e paths.** that
1e2b0 64 65 61 6c 20 77 69 74 68 20 73 71 6c 69 74 65 deal with sqlite
1e2c0 33 53 74 61 63 6b 41 6c 6c 6f 63 28 29 20 66 61 3StackAlloc() fa
1e2d0 69 6c 75 72 65 73 20 74 6f 20 62 65 20 75 6e 72 ilures to be unr
1e2e0 65 61 63 68 61 62 6c 65 2e 0a 2a 2f 0a 23 69 66 eachable..*/.#if
1e2f0 64 65 66 20 53 51 4c 49 54 45 5f 55 53 45 5f 41 def SQLITE_USE_A
1e300 4c 4c 4f 43 41 0a 23 20 64 65 66 69 6e 65 20 73 LLOCA.# define s
1e310 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 qlite3StackAlloc
1e320 52 61 77 28 44 2c 4e 29 20 20 20 61 6c 6c 6f 63 Raw(D,N) alloc
1e330 61 28 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 a(N).# define sq
1e340 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 5a lite3StackAllocZ
1e350 65 72 6f 28 44 2c 4e 29 20 20 6d 65 6d 73 65 74 ero(D,N) memset
1e360 28 61 6c 6c 6f 63 61 28 4e 29 2c 20 30 2c 20 4e (alloca(N), 0, N
1e370 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
1e380 65 33 53 74 61 63 6b 46 72 65 65 28 44 2c 50 29 e3StackFree(D,P)
1e390 20 20 20 20 20 20 20 0a 23 65 6c 73 65 0a 23 20 .#else.#
1e3a0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 define sqlite3St
1e3b0 61 63 6b 41 6c 6c 6f 63 52 61 77 28 44 2c 4e 29 ackAllocRaw(D,N)
1e3c0 20 20 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c sqlite3DbMall
1e3d0 6f 63 52 61 77 28 44 2c 4e 29 0a 23 20 64 65 66 ocRaw(D,N).# def
1e3e0 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b ine sqlite3Stack
1e3f0 41 6c 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 20 20 AllocZero(D,N)
1e400 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a sqlite3DbMallocZ
1e410 65 72 6f 28 44 2c 4e 29 0a 23 20 64 65 66 69 6e ero(D,N).# defin
1e420 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b 46 72 e sqlite3StackFr
1e430 65 65 28 44 2c 50 29 20 20 20 20 20 20 20 73 71 ee(D,P) sq
1e440 6c 69 74 65 33 44 62 46 72 65 65 28 44 2c 50 29 lite3DbFree(D,P)
1e450 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
1e460 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 SQLITE_ENABLE_ME
1e470 4d 53 59 53 33 0a 63 6f 6e 73 74 20 73 71 6c 69 MSYS3.const sqli
1e480 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 te3_mem_methods
1e490 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 *sqlite3MemGetMe
1e4a0 6d 73 79 73 33 28 76 6f 69 64 29 3b 0a 23 65 6e msys3(void);.#en
1e4b0 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 54 dif.#ifdef SQLIT
1e4c0 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 35 E_ENABLE_MEMSYS5
1e4d0 0a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d .const sqlite3_m
1e4e0 65 6d 5f 6d 65 74 68 6f 64 73 20 2a 73 71 6c 69 em_methods *sqli
1e4f0 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 35 te3MemGetMemsys5
1e500 28 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 0a (void);.#endif..
1e510 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
1e520 4d 55 54 45 58 5f 4f 4d 49 54 0a 20 20 73 71 6c MUTEX_OMIT. sql
1e530 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 6f ite3_mutex_metho
1e540 64 73 20 63 6f 6e 73 74 20 2a 73 71 6c 69 74 65 ds const *sqlite
1e550 33 44 65 66 61 75 6c 74 4d 75 74 65 78 28 76 6f 3DefaultMutex(vo
1e560 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d id);. sqlite3_m
1e570 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 6f 6e utex_methods con
1e580 73 74 20 2a 73 71 6c 69 74 65 33 4e 6f 6f 70 4d st *sqlite3NoopM
1e590 75 74 65 78 28 76 6f 69 64 29 3b 0a 20 20 73 71 utex(void);. sq
1e5a0 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 6c lite3_mutex *sql
1e5b0 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 69 ite3MutexAlloc(i
1e5c0 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 nt);. int sqlit
1e5d0 65 33 4d 75 74 65 78 49 6e 69 74 28 76 6f 69 64 e3MutexInit(void
1e5e0 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
1e5f0 4d 75 74 65 78 45 6e 64 28 76 6f 69 64 29 3b 0a MutexEnd(void);.
1e600 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 6c 69 #endif..int sqli
1e610 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 28 69 te3StatusValue(i
1e620 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
1e630 33 53 74 61 74 75 73 41 64 64 28 69 6e 74 2c 20 3StatusAdd(int,
1e640 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
1e650 65 33 53 74 61 74 75 73 53 65 74 28 69 6e 74 2c e3StatusSet(int,
1e660 20 69 6e 74 29 3b 0a 0a 23 69 66 6e 64 65 66 20 int);..#ifndef
1e670 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 SQLITE_OMIT_FLOA
1e680 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 69 6e 74 TING_POINT. int
1e690 20 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 64 6f sqlite3IsNaN(do
1e6a0 75 62 6c 65 29 3b 0a 23 65 6c 73 65 0a 23 20 64 uble);.#else.# d
1e6b0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 4e efine sqlite3IsN
1e6c0 61 4e 28 58 29 20 20 30 0a 23 65 6e 64 69 66 0a aN(X) 0.#endif.
1e6d0 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
1e6e0 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
1e6f0 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 68 6f ing structure ho
1e700 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 lds information
1e710 61 62 6f 75 74 20 53 51 4c 0a 2a 2a 20 66 75 6e about SQL.** fun
1e720 63 74 69 6f 6e 73 20 61 72 67 75 6d 65 6e 74 73 ctions arguments
1e730 20 74 68 61 74 20 61 72 65 20 74 68 65 20 70 61 that are the pa
1e740 72 61 6d 65 74 65 72 73 20 74 6f 20 74 68 65 20 rameters to the
1e750 70 72 69 6e 74 66 28 29 20 66 75 6e 63 74 69 6f printf() functio
1e760 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 72 69 n..*/.struct Pri
1e770 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 7b 0a 20 ntfArguments {.
1e780 20 69 6e 74 20 6e 41 72 67 3b 20 20 20 20 20 20 int nArg;
1e790 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 74 /* Tot
1e7a0 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 al number of arg
1e7b0 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 uments */. int
1e7c0 6e 55 73 65 64 3b 20 20 20 20 20 20 20 20 20 20 nUsed;
1e7d0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1e7e0 66 20 61 72 67 75 6d 65 6e 74 73 20 75 73 65 64 f arguments used
1e7f0 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 73 71 6c so far */. sql
1e800 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 70 41 ite3_value **apA
1e810 72 67 3b 20 20 20 2f 2a 20 54 68 65 20 61 72 67 rg; /* The arg
1e820 75 6d 65 6e 74 20 76 61 6c 75 65 73 20 2a 2f 0a ument values */.
1e830 7d 3b 0a 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 };..#define SQLI
1e840 54 45 5f 50 52 49 4e 54 46 5f 49 4e 54 45 52 4e TE_PRINTF_INTERN
1e850 41 4c 20 30 78 30 31 0a 23 64 65 66 69 6e 65 20 AL 0x01.#define
1e860 53 51 4c 49 54 45 5f 50 52 49 4e 54 46 5f 53 51 SQLITE_PRINTF_SQ
1e870 4c 46 55 4e 43 20 20 30 78 30 32 0a 76 6f 69 64 LFUNC 0x02.void
1e880 20 73 71 6c 69 74 65 33 56 58 50 72 69 6e 74 66 sqlite3VXPrintf
1e890 28 53 74 72 41 63 63 75 6d 2a 2c 20 75 33 32 2c (StrAccum*, u32,
1e8a0 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 76 61 const char*, va
1e8b0 5f 6c 69 73 74 29 3b 0a 76 6f 69 64 20 73 71 6c _list);.void sql
1e8c0 69 74 65 33 58 50 72 69 6e 74 66 28 53 74 72 41 ite3XPrintf(StrA
1e8d0 63 63 75 6d 2a 2c 20 75 33 32 2c 20 63 6f 6e 73 ccum*, u32, cons
1e8e0 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 63 t char*, ...);.c
1e8f0 68 61 72 20 2a 73 71 6c 69 74 65 33 4d 50 72 69 har *sqlite3MPri
1e900 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e ntf(sqlite3*,con
1e910 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a st char*, ...);.
1e920 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 4d 50 char *sqlite3VMP
1e930 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c 63 rintf(sqlite3*,c
1e940 6f 6e 73 74 20 63 68 61 72 2a 2c 20 76 61 5f 6c onst char*, va_l
1e950 69 73 74 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 ist);.char *sqli
1e960 74 65 33 4d 41 70 70 65 6e 64 66 28 73 71 6c 69 te3MAppendf(sqli
1e970 74 65 33 2a 2c 63 68 61 72 2a 2c 63 6f 6e 73 74 te3*,char*,const
1e980 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a 23 69 66 char*,...);.#if
1e990 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
1e9a0 54 45 53 54 29 20 7c 7c 20 64 65 66 69 6e 65 64 TEST) || defined
1e9b0 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 (SQLITE_DEBUG).
1e9c0 20 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 62 void sqlite3Deb
1e9d0 75 67 50 72 69 6e 74 66 28 63 6f 6e 73 74 20 63 ugPrintf(const c
1e9e0 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 23 65 6e 64 har*, ...);.#end
1e9f0 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 if.#if defined(S
1ea00 51 4c 49 54 45 5f 54 45 53 54 29 0a 20 20 76 6f QLITE_TEST). vo
1ea10 69 64 20 2a 73 71 6c 69 74 65 33 54 65 73 74 54 id *sqlite3TestT
1ea20 65 78 74 54 6f 50 74 72 28 63 6f 6e 73 74 20 63 extToPtr(const c
1ea30 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f har*);.#endif../
1ea40 2a 20 4f 75 74 70 75 74 20 66 6f 72 6d 61 74 74 * Output formatt
1ea50 69 6e 67 20 66 6f 72 20 53 51 4c 49 54 45 5f 54 ing for SQLITE_T
1ea60 45 53 54 43 54 52 4c 5f 45 58 50 4c 41 49 4e 20 ESTCTRL_EXPLAIN
1ea70 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 */.#if defined(S
1ea80 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 54 52 45 QLITE_ENABLE_TRE
1ea90 45 5f 45 58 50 4c 41 49 4e 29 0a 20 20 76 6f 69 E_EXPLAIN). voi
1eaa0 64 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e d sqlite3Explain
1eab0 42 65 67 69 6e 28 56 64 62 65 2a 29 3b 0a 20 20 Begin(Vdbe*);.
1eac0 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 6c void sqlite3Expl
1ead0 61 69 6e 50 72 69 6e 74 66 28 56 64 62 65 2a 2c ainPrintf(Vdbe*,
1eae0 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e const char*, ..
1eaf0 2e 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 .);. void sqlit
1eb00 65 33 45 78 70 6c 61 69 6e 4e 4c 28 56 64 62 65 e3ExplainNL(Vdbe
1eb10 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 *);. void sqlit
1eb20 65 33 45 78 70 6c 61 69 6e 50 75 73 68 28 56 64 e3ExplainPush(Vd
1eb30 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c be*);. void sql
1eb40 69 74 65 33 45 78 70 6c 61 69 6e 50 6f 70 28 56 ite3ExplainPop(V
1eb50 64 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 dbe*);. void sq
1eb60 6c 69 74 65 33 45 78 70 6c 61 69 6e 46 69 6e 69 lite3ExplainFini
1eb70 73 68 28 56 64 62 65 2a 29 3b 0a 20 20 76 6f 69 sh(Vdbe*);. voi
1eb80 64 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e d sqlite3Explain
1eb90 53 65 6c 65 63 74 28 56 64 62 65 2a 2c 20 53 65 Select(Vdbe*, Se
1eba0 6c 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 73 lect*);. void s
1ebb0 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 45 78 70 qlite3ExplainExp
1ebc0 72 28 56 64 62 65 2a 2c 20 45 78 70 72 2a 29 3b r(Vdbe*, Expr*);
1ebd0 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 45 . void sqlite3E
1ebe0 78 70 6c 61 69 6e 45 78 70 72 4c 69 73 74 28 56 xplainExprList(V
1ebf0 64 62 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 dbe*, ExprList*)
1ec00 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a ;. const char *
1ec10 73 71 6c 69 74 65 33 56 64 62 65 45 78 70 6c 61 sqlite3VdbeExpla
1ec20 6e 61 74 69 6f 6e 28 56 64 62 65 2a 29 3b 0a 23 nation(Vdbe*);.#
1ec30 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
1ec40 6c 69 74 65 33 45 78 70 6c 61 69 6e 42 65 67 69 lite3ExplainBegi
1ec50 6e 28 58 29 0a 23 20 64 65 66 69 6e 65 20 73 71 n(X).# define sq
1ec60 6c 69 74 65 33 45 78 70 6c 61 69 6e 53 65 6c 65 lite3ExplainSele
1ec70 63 74 28 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 ct(A,B).# define
1ec80 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 45 sqlite3ExplainE
1ec90 78 70 72 28 41 2c 42 29 0a 23 20 64 65 66 69 6e xpr(A,B).# defin
1eca0 65 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e e sqlite3Explain
1ecb0 45 78 70 72 4c 69 73 74 28 41 2c 42 29 0a 23 20 ExprList(A,B).#
1ecc0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 78 define sqlite3Ex
1ecd0 70 6c 61 69 6e 46 69 6e 69 73 68 28 58 29 0a 23 plainFinish(X).#
1ece0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 define sqlite3V
1ecf0 64 62 65 45 78 70 6c 61 6e 61 74 69 6f 6e 28 58 dbeExplanation(X
1ed00 29 20 30 0a 23 65 6e 64 69 66 0a 0a 0a 76 6f 69 ) 0.#endif...voi
1ed10 64 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 d sqlite3SetStri
1ed20 6e 67 28 63 68 61 72 20 2a 2a 2c 20 73 71 6c 69 ng(char **, sqli
1ed30 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 te3*, const char
1ed40 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 *, ...);.void sq
1ed50 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28 50 61 lite3ErrorMsg(Pa
1ed60 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 rse*, const char
1ed70 2a 2c 20 2e 2e 2e 29 3b 0a 69 6e 74 20 73 71 6c *, ...);.int sql
1ed80 69 74 65 33 44 65 71 75 6f 74 65 28 63 68 61 72 ite3Dequote(char
1ed90 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4b *);.int sqlite3K
1eda0 65 79 77 6f 72 64 43 6f 64 65 28 63 6f 6e 73 74 eywordCode(const
1edb0 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 2c unsigned char*,
1edc0 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
1edd0 65 33 52 75 6e 50 61 72 73 65 72 28 50 61 72 73 e3RunParser(Pars
1ede0 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c e*, const char*,
1edf0 20 63 68 61 72 20 2a 2a 29 3b 0a 76 6f 69 64 20 char **);.void
1ee00 73 71 6c 69 74 65 33 46 69 6e 69 73 68 43 6f 64 sqlite3FinishCod
1ee10 69 6e 67 28 50 61 72 73 65 2a 29 3b 0a 69 6e 74 ing(Parse*);.int
1ee20 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d 70 52 sqlite3GetTempR
1ee30 65 67 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 eg(Parse*);.void
1ee40 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 sqlite3ReleaseT
1ee50 65 6d 70 52 65 67 28 50 61 72 73 65 2a 2c 69 6e empReg(Parse*,in
1ee60 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 t);.int sqlite3G
1ee70 65 74 54 65 6d 70 52 61 6e 67 65 28 50 61 72 73 etTempRange(Pars
1ee80 65 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 e*,int);.void sq
1ee90 6c 69 74 65 33 52 65 6c 65 61 73 65 54 65 6d 70 lite3ReleaseTemp
1eea0 52 61 6e 67 65 28 50 61 72 73 65 2a 2c 69 6e 74 Range(Parse*,int
1eeb0 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
1eec0 74 65 33 43 6c 65 61 72 54 65 6d 70 52 65 67 43 te3ClearTempRegC
1eed0 61 63 68 65 28 50 61 72 73 65 2a 29 3b 0a 45 78 ache(Parse*);.Ex
1eee0 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 41 pr *sqlite3ExprA
1eef0 6c 6c 6f 63 28 73 71 6c 69 74 65 33 2a 2c 69 6e lloc(sqlite3*,in
1ef00 74 2c 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 2c 69 t,const Token*,i
1ef10 6e 74 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 nt);.Expr *sqlit
1ef20 65 33 45 78 70 72 28 73 71 6c 69 74 65 33 2a 2c e3Expr(sqlite3*,
1ef30 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 int,const char*)
1ef40 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
1ef50 70 72 41 74 74 61 63 68 53 75 62 74 72 65 65 73 prAttachSubtrees
1ef60 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c (sqlite3*,Expr*,
1ef70 45 78 70 72 2a 2c 45 78 70 72 2a 29 3b 0a 45 78 Expr*,Expr*);.Ex
1ef80 70 72 20 2a 73 71 6c 69 74 65 33 50 45 78 70 72 pr *sqlite3PExpr
1ef90 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 45 78 (Parse*, int, Ex
1efa0 70 72 2a 2c 20 45 78 70 72 2a 2c 20 63 6f 6e 73 pr*, Expr*, cons
1efb0 74 20 54 6f 6b 65 6e 2a 29 3b 0a 45 78 70 72 20 t Token*);.Expr
1efc0 2a 73 71 6c 69 74 65 33 45 78 70 72 41 6e 64 28 *sqlite3ExprAnd(
1efd0 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 20 sqlite3*,Expr*,
1efe0 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 Expr*);.Expr *sq
1eff0 6c 69 74 65 33 45 78 70 72 46 75 6e 63 74 69 6f lite3ExprFunctio
1f000 6e 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 n(Parse*,ExprLis
1f010 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 t*, Token*);.voi
1f020 64 20 73 71 6c 69 74 65 33 45 78 70 72 41 73 73 d sqlite3ExprAss
1f030 69 67 6e 56 61 72 4e 75 6d 62 65 72 28 50 61 72 ignVarNumber(Par
1f040 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 se*, Expr*);.voi
1f050 64 20 73 71 6c 69 74 65 33 45 78 70 72 44 65 6c d sqlite3ExprDel
1f060 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 45 78 ete(sqlite3*, Ex
1f070 70 72 2a 29 3b 0a 45 78 70 72 4c 69 73 74 20 2a pr*);.ExprList *
1f080 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 41 sqlite3ExprListA
1f090 70 70 65 6e 64 28 50 61 72 73 65 2a 2c 45 78 70 ppend(Parse*,Exp
1f0a0 72 4c 69 73 74 2a 2c 45 78 70 72 2a 29 3b 0a 76 rList*,Expr*);.v
1f0b0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 4c oid sqlite3ExprL
1f0c0 69 73 74 53 65 74 4e 61 6d 65 28 50 61 72 73 65 istSetName(Parse
1f0d0 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 54 6f 6b 65 *,ExprList*,Toke
1f0e0 6e 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 n*,int);.void sq
1f0f0 6c 69 74 65 33 45 78 70 72 4c 69 73 74 53 65 74 lite3ExprListSet
1f100 53 70 61 6e 28 50 61 72 73 65 2a 2c 45 78 70 72 Span(Parse*,Expr
1f110 4c 69 73 74 2a 2c 45 78 70 72 53 70 61 6e 2a 29 List*,ExprSpan*)
1f120 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
1f130 70 72 4c 69 73 74 44 65 6c 65 74 65 28 73 71 6c prListDelete(sql
1f140 69 74 65 33 2a 2c 20 45 78 70 72 4c 69 73 74 2a ite3*, ExprList*
1f150 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e );.int sqlite3In
1f160 69 74 28 73 71 6c 69 74 65 33 2a 2c 20 63 68 61 it(sqlite3*, cha
1f170 72 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 r**);.int sqlite
1f180 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 3InitCallback(vo
1f190 69 64 2a 2c 20 69 6e 74 2c 20 63 68 61 72 2a 2a id*, int, char**
1f1a0 2c 20 63 68 61 72 2a 2a 29 3b 0a 76 6f 69 64 20 , char**);.void
1f1b0 73 71 6c 69 74 65 33 50 72 61 67 6d 61 28 50 61 sqlite3Pragma(Pa
1f1c0 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
1f1d0 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a n*,Token*,int);.
1f1e0 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 65 void sqlite3Rese
1f1f0 74 41 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e tAllSchemasOfCon
1f200 6e 65 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a nection(sqlite3*
1f210 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
1f220 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 73 71 esetOneSchema(sq
1f230 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 lite3*,int);.voi
1f240 64 20 73 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 d sqlite3Collaps
1f250 65 44 61 74 61 62 61 73 65 41 72 72 61 79 28 73 eDatabaseArray(s
1f260 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 qlite3*);.void s
1f270 71 6c 69 74 65 33 42 65 67 69 6e 50 61 72 73 65 qlite3BeginParse
1f280 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 76 6f (Parse*,int);.vo
1f290 69 64 20 73 71 6c 69 74 65 33 43 6f 6d 6d 69 74 id sqlite3Commit
1f2a0 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 InternalChanges(
1f2b0 73 71 6c 69 74 65 33 2a 29 3b 0a 54 61 62 6c 65 sqlite3*);.Table
1f2c0 20 2a 73 71 6c 69 74 65 33 52 65 73 75 6c 74 53 *sqlite3ResultS
1f2d0 65 74 4f 66 53 65 6c 65 63 74 28 50 61 72 73 65 etOfSelect(Parse
1f2e0 2a 2c 53 65 6c 65 63 74 2a 29 3b 0a 76 6f 69 64 *,Select*);.void
1f2f0 20 73 71 6c 69 74 65 33 4f 70 65 6e 4d 61 73 74 sqlite3OpenMast
1f300 65 72 54 61 62 6c 65 28 50 61 72 73 65 20 2a 2c erTable(Parse *,
1f310 20 69 6e 74 29 3b 0a 49 6e 64 65 78 20 2a 73 71 int);.Index *sq
1f320 6c 69 74 65 33 50 72 69 6d 61 72 79 4b 65 79 49 lite3PrimaryKeyI
1f330 6e 64 65 78 28 54 61 62 6c 65 2a 29 3b 0a 69 31 ndex(Table*);.i1
1f340 36 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 6 sqlite3ColumnO
1f350 66 49 6e 64 65 78 28 49 6e 64 65 78 2a 2c 20 69 fIndex(Index*, i
1f360 31 36 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 16);.void sqlite
1f370 33 53 74 61 72 74 54 61 62 6c 65 28 50 61 72 73 3StartTable(Pars
1f380 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a e*,Token*,Token*
1f390 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 ,int,int,int,int
1f3a0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
1f3b0 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c ddColumn(Parse*,
1f3c0 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 Token*);.void sq
1f3d0 6c 69 74 65 33 41 64 64 4e 6f 74 4e 75 6c 6c 28 lite3AddNotNull(
1f3e0 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f Parse*, int);.vo
1f3f0 69 64 20 73 71 6c 69 74 65 33 41 64 64 50 72 69 id sqlite3AddPri
1f400 6d 61 72 79 4b 65 79 28 50 61 72 73 65 2a 2c 20 maryKey(Parse*,
1f410 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 ExprList*, int,
1f420 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
1f430 73 71 6c 69 74 65 33 41 64 64 43 68 65 63 6b 43 sqlite3AddCheckC
1f440 6f 6e 73 74 72 61 69 6e 74 28 50 61 72 73 65 2a onstraint(Parse*
1f450 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 , Expr*);.void s
1f460 71 6c 69 74 65 33 41 64 64 43 6f 6c 75 6d 6e 54 qlite3AddColumnT
1f470 79 70 65 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e ype(Parse*,Token
1f480 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
1f490 41 64 64 44 65 66 61 75 6c 74 56 61 6c 75 65 28 AddDefaultValue(
1f4a0 50 61 72 73 65 2a 2c 45 78 70 72 53 70 61 6e 2a Parse*,ExprSpan*
1f4b0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
1f4c0 64 64 43 6f 6c 6c 61 74 65 54 79 70 65 28 50 61 ddCollateType(Pa
1f4d0 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 rse*, Token*);.v
1f4e0 6f 69 64 20 73 71 6c 69 74 65 33 45 6e 64 54 61 oid sqlite3EndTa
1f4f0 62 6c 65 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e ble(Parse*,Token
1f500 2a 2c 54 6f 6b 65 6e 2a 2c 75 38 2c 53 65 6c 65 *,Token*,u8,Sele
1f510 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 ct*);.int sqlite
1f520 33 50 61 72 73 65 55 72 69 28 63 6f 6e 73 74 20 3ParseUri(const
1f530 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 char*,const char
1f540 2a 2c 75 6e 73 69 67 6e 65 64 20 69 6e 74 2a 2c *,unsigned int*,
1f550 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
1f560 20 20 20 20 20 73 71 6c 69 74 65 33 5f 76 66 73 sqlite3_vfs
1f570 2a 2a 2c 63 68 61 72 2a 2a 2c 63 68 61 72 20 2a **,char**,char *
1f580 2a 29 3b 0a 42 74 72 65 65 20 2a 73 71 6c 69 74 *);.Btree *sqlit
1f590 65 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 e3DbNameToBtree(
1f5a0 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 sqlite3*,const c
1f5b0 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 har*);.int sqlit
1f5c0 65 33 43 6f 64 65 4f 6e 63 65 28 50 61 72 73 65 e3CodeOnce(Parse
1f5d0 20 2a 29 3b 0a 0a 42 69 74 76 65 63 20 2a 73 71 *);..Bitvec *sq
1f5e0 6c 69 74 65 33 42 69 74 76 65 63 43 72 65 61 74 lite3BitvecCreat
1f5f0 65 28 75 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 e(u32);.int sqli
1f600 74 65 33 42 69 74 76 65 63 54 65 73 74 28 42 69 te3BitvecTest(Bi
1f610 74 76 65 63 2a 2c 20 75 33 32 29 3b 0a 69 6e 74 tvec*, u32);.int
1f620 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 65 sqlite3BitvecSe
1f630 74 28 42 69 74 76 65 63 2a 2c 20 75 33 32 29 3b t(Bitvec*, u32);
1f640 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 69 74 .void sqlite3Bit
1f650 76 65 63 43 6c 65 61 72 28 42 69 74 76 65 63 2a vecClear(Bitvec*
1f660 2c 20 75 33 32 2c 20 76 6f 69 64 2a 29 3b 0a 76 , u32, void*);.v
1f670 6f 69 64 20 73 71 6c 69 74 65 33 42 69 74 76 65 oid sqlite3Bitve
1f680 63 44 65 73 74 72 6f 79 28 42 69 74 76 65 63 2a cDestroy(Bitvec*
1f690 29 3b 0a 75 33 32 20 73 71 6c 69 74 65 33 42 69 );.u32 sqlite3Bi
1f6a0 74 76 65 63 53 69 7a 65 28 42 69 74 76 65 63 2a tvecSize(Bitvec*
1f6b0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 );.int sqlite3Bi
1f6c0 74 76 65 63 42 75 69 6c 74 69 6e 54 65 73 74 28 tvecBuiltinTest(
1f6d0 69 6e 74 2c 69 6e 74 2a 29 3b 0a 0a 52 6f 77 53 int,int*);..RowS
1f6e0 65 74 20 2a 73 71 6c 69 74 65 33 52 6f 77 53 65 et *sqlite3RowSe
1f6f0 74 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 2c 20 tInit(sqlite3*,
1f700 76 6f 69 64 2a 2c 20 75 6e 73 69 67 6e 65 64 20 void*, unsigned
1f710 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
1f720 65 33 52 6f 77 53 65 74 43 6c 65 61 72 28 52 6f e3RowSetClear(Ro
1f730 77 53 65 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c wSet*);.void sql
1f740 69 74 65 33 52 6f 77 53 65 74 49 6e 73 65 72 74 ite3RowSetInsert
1f750 28 52 6f 77 53 65 74 2a 2c 20 69 36 34 29 3b 0a (RowSet*, i64);.
1f760 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 53 65 int sqlite3RowSe
1f770 74 54 65 73 74 28 52 6f 77 53 65 74 2a 2c 20 75 tTest(RowSet*, u
1f780 38 20 69 42 61 74 63 68 2c 20 69 36 34 29 3b 0a 8 iBatch, i64);.
1f790 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 53 65 int sqlite3RowSe
1f7a0 74 4e 65 78 74 28 52 6f 77 53 65 74 2a 2c 20 69 tNext(RowSet*, i
1f7b0 36 34 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 64*);..void sqli
1f7c0 74 65 33 43 72 65 61 74 65 56 69 65 77 28 50 61 te3CreateView(Pa
1f7d0 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
1f7e0 6e 2a 2c 54 6f 6b 65 6e 2a 2c 53 65 6c 65 63 74 n*,Token*,Select
1f7f0 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 0a 23 69 66 *,int,int);..#if
1f800 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
1f810 5f 4f 4d 49 54 5f 56 49 45 57 29 20 7c 7c 20 21 _OMIT_VIEW) || !
1f820 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
1f830 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
1f840 29 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 56 ). int sqlite3V
1f850 69 65 77 47 65 74 43 6f 6c 75 6d 6e 4e 61 6d 65 iewGetColumnName
1f860 73 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 29 s(Parse*,Table*)
1f870 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ;.#else.# define
1f880 20 73 71 6c 69 74 65 33 56 69 65 77 47 65 74 43 sqlite3ViewGetC
1f890 6f 6c 75 6d 6e 4e 61 6d 65 73 28 41 2c 42 29 20 olumnNames(A,B)
1f8a0 30 0a 23 65 6e 64 69 66 0a 0a 76 6f 69 64 20 73 0.#endif..void s
1f8b0 71 6c 69 74 65 33 44 72 6f 70 54 61 62 6c 65 28 qlite3DropTable(
1f8c0 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
1f8d0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
1f8e0 64 20 73 71 6c 69 74 65 33 43 6f 64 65 44 72 6f d sqlite3CodeDro
1f8f0 70 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 54 pTable(Parse*, T
1f900 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 able*, int, int)
1f910 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 ;.void sqlite3De
1f920 6c 65 74 65 54 61 62 6c 65 28 73 71 6c 69 74 65 leteTable(sqlite
1f930 33 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 23 69 66 3*, Table*);.#if
1f940 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
1f950 5f 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 0a 20 _AUTOINCREMENT.
1f960 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 void sqlite3Aut
1f970 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 69 6e 28 oincrementBegin(
1f980 50 61 72 73 65 20 2a 70 50 61 72 73 65 29 3b 0a Parse *pParse);.
1f990 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 void sqlite3Au
1f9a0 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 64 28 50 toincrementEnd(P
1f9b0 61 72 73 65 20 2a 70 50 61 72 73 65 29 3b 0a 23 arse *pParse);.#
1f9c0 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
1f9d0 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 lite3Autoincreme
1f9e0 6e 74 42 65 67 69 6e 28 58 29 0a 23 20 64 65 66 ntBegin(X).# def
1f9f0 69 6e 65 20 73 71 6c 69 74 65 33 41 75 74 6f 69 ine sqlite3Autoi
1fa00 6e 63 72 65 6d 65 6e 74 45 6e 64 28 58 29 0a 23 ncrementEnd(X).#
1fa10 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 endif.int sqlite
1fa20 33 43 6f 64 65 43 6f 72 6f 75 74 69 6e 65 28 50 3CodeCoroutine(P
1fa30 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 arse*, Select*,
1fa40 53 65 6c 65 63 74 44 65 73 74 2a 29 3b 0a 76 6f SelectDest*);.vo
1fa50 69 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 74 id sqlite3Insert
1fa60 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 (Parse*, SrcList
1fa70 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 49 64 4c 69 *, Select*, IdLi
1fa80 73 74 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 st*, int);.void
1fa90 2a 73 71 6c 69 74 65 33 41 72 72 61 79 41 6c 6c *sqlite3ArrayAll
1faa0 6f 63 61 74 65 28 73 71 6c 69 74 65 33 2a 2c 76 ocate(sqlite3*,v
1fab0 6f 69 64 2a 2c 69 6e 74 2c 69 6e 74 2a 2c 69 6e oid*,int,int*,in
1fac0 74 2a 29 3b 0a 49 64 4c 69 73 74 20 2a 73 71 6c t*);.IdList *sql
1fad0 69 74 65 33 49 64 4c 69 73 74 41 70 70 65 6e 64 ite3IdListAppend
1fae0 28 73 71 6c 69 74 65 33 2a 2c 20 49 64 4c 69 73 (sqlite3*, IdLis
1faf0 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 t*, Token*);.int
1fb00 20 73 71 6c 69 74 65 33 49 64 4c 69 73 74 49 6e sqlite3IdListIn
1fb10 64 65 78 28 49 64 4c 69 73 74 2a 2c 63 6f 6e 73 dex(IdList*,cons
1fb20 74 20 63 68 61 72 2a 29 3b 0a 53 72 63 4c 69 73 t char*);.SrcLis
1fb30 74 20 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 73 t *sqlite3SrcLis
1fb40 74 45 6e 6c 61 72 67 65 28 73 71 6c 69 74 65 33 tEnlarge(sqlite3
1fb50 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 69 6e 74 *, SrcList*, int
1fb60 2c 20 69 6e 74 29 3b 0a 53 72 63 4c 69 73 74 20 , int);.SrcList
1fb70 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 41 *sqlite3SrcListA
1fb80 70 70 65 6e 64 28 73 71 6c 69 74 65 33 2a 2c 20 ppend(sqlite3*,
1fb90 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a SrcList*, Token*
1fba0 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 53 72 63 4c 69 , Token*);.SrcLi
1fbb0 73 74 20 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 st *sqlite3SrcLi
1fbc0 73 74 41 70 70 65 6e 64 46 72 6f 6d 54 65 72 6d stAppendFromTerm
1fbd0 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 (Parse*, SrcList
1fbe0 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e *, Token*, Token
1fbf0 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 *,.
1fc00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fc10 20 20 20 20 20 20 20 20 20 54 6f 6b 65 6e 2a 2c Token*,
1fc20 20 53 65 6c 65 63 74 2a 2c 20 45 78 70 72 2a 2c Select*, Expr*,
1fc30 20 49 64 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 20 IdList*);.void
1fc40 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 49 6e sqlite3SrcListIn
1fc50 64 65 78 65 64 42 79 28 50 61 72 73 65 20 2a 2c dexedBy(Parse *,
1fc60 20 53 72 63 4c 69 73 74 20 2a 2c 20 54 6f 6b 65 SrcList *, Toke
1fc70 6e 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 n *);.int sqlite
1fc80 33 49 6e 64 65 78 65 64 42 79 4c 6f 6f 6b 75 70 3IndexedByLookup
1fc90 28 50 61 72 73 65 20 2a 2c 20 73 74 72 75 63 74 (Parse *, struct
1fca0 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 29 SrcList_item *)
1fcb0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 ;.void sqlite3Sr
1fcc0 63 4c 69 73 74 53 68 69 66 74 4a 6f 69 6e 54 79 cListShiftJoinTy
1fcd0 70 65 28 53 72 63 4c 69 73 74 2a 29 3b 0a 76 6f pe(SrcList*);.vo
1fce0 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 id sqlite3SrcLis
1fcf0 74 41 73 73 69 67 6e 43 75 72 73 6f 72 73 28 50 tAssignCursors(P
1fd00 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 29 arse*, SrcList*)
1fd10 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 49 64 ;.void sqlite3Id
1fd20 4c 69 73 74 44 65 6c 65 74 65 28 73 71 6c 69 74 ListDelete(sqlit
1fd30 65 33 2a 2c 20 49 64 4c 69 73 74 2a 29 3b 0a 76 e3*, IdList*);.v
1fd40 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 4c 69 oid sqlite3SrcLi
1fd50 73 74 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 stDelete(sqlite3
1fd60 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 49 6e *, SrcList*);.In
1fd70 64 65 78 20 2a 73 71 6c 69 74 65 33 41 6c 6c 6f dex *sqlite3Allo
1fd80 63 61 74 65 49 6e 64 65 78 4f 62 6a 65 63 74 28 cateIndexObject(
1fd90 73 71 6c 69 74 65 33 2a 2c 69 31 36 2c 69 6e 74 sqlite3*,i16,int
1fda0 2c 63 68 61 72 2a 2a 29 3b 0a 49 6e 64 65 78 20 ,char**);.Index
1fdb0 2a 73 71 6c 69 74 65 33 43 72 65 61 74 65 49 6e *sqlite3CreateIn
1fdc0 64 65 78 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e dex(Parse*,Token
1fdd0 2a 2c 54 6f 6b 65 6e 2a 2c 53 72 63 4c 69 73 74 *,Token*,SrcList
1fde0 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 2c *,ExprList*,int,
1fdf0 54 6f 6b 65 6e 2a 2c 0a 20 20 20 20 20 20 20 20 Token*,.
1fe00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fe10 20 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e Expr*, int, in
1fe20 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
1fe30 44 72 6f 70 49 6e 64 65 78 28 50 61 72 73 65 2a DropIndex(Parse*
1fe40 2c 20 53 72 63 4c 69 73 74 2a 2c 20 69 6e 74 29 , SrcList*, int)
1fe50 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 65 6c ;.int sqlite3Sel
1fe60 65 63 74 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 ect(Parse*, Sele
1fe70 63 74 2a 2c 20 53 65 6c 65 63 74 44 65 73 74 2a ct*, SelectDest*
1fe80 29 3b 0a 53 65 6c 65 63 74 20 2a 73 71 6c 69 74 );.Select *sqlit
1fe90 65 33 53 65 6c 65 63 74 4e 65 77 28 50 61 72 73 e3SelectNew(Pars
1fea0 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 72 63 e*,ExprList*,Src
1feb0 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 70 72 List*,Expr*,Expr
1fec0 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 List*,.
1fed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1fee0 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c Expr*,ExprList*,
1fef0 75 31 36 2c 45 78 70 72 2a 2c 45 78 70 72 2a 29 u16,Expr*,Expr*)
1ff00 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 ;.void sqlite3Se
1ff10 6c 65 63 74 44 65 6c 65 74 65 28 73 71 6c 69 74 lectDelete(sqlit
1ff20 65 33 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 54 e3*, Select*);.T
1ff30 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 53 72 63 able *sqlite3Src
1ff40 4c 69 73 74 4c 6f 6f 6b 75 70 28 50 61 72 73 65 ListLookup(Parse
1ff50 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 69 6e *, SrcList*);.in
1ff60 74 20 73 71 6c 69 74 65 33 49 73 52 65 61 64 4f t sqlite3IsReadO
1ff70 6e 6c 79 28 50 61 72 73 65 2a 2c 20 54 61 62 6c nly(Parse*, Tabl
1ff80 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 e*, int);.void s
1ff90 71 6c 69 74 65 33 4f 70 65 6e 54 61 62 6c 65 28 qlite3OpenTable(
1ffa0 50 61 72 73 65 2a 2c 20 69 6e 74 20 69 43 75 72 Parse*, int iCur
1ffb0 2c 20 69 6e 74 20 69 44 62 2c 20 54 61 62 6c 65 , int iDb, Table
1ffc0 2a 2c 20 69 6e 74 29 3b 0a 23 69 66 20 64 65 66 *, int);.#if def
1ffd0 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
1ffe0 4c 45 5f 55 50 44 41 54 45 5f 44 45 4c 45 54 45 LE_UPDATE_DELETE
1fff0 5f 4c 49 4d 49 54 29 20 26 26 20 21 64 65 66 69 _LIMIT) && !defi
20000 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
20010 53 55 42 51 55 45 52 59 29 0a 45 78 70 72 20 2a SUBQUERY).Expr *
20020 73 71 6c 69 74 65 33 4c 69 6d 69 74 57 68 65 72 sqlite3LimitWher
20030 65 28 50 61 72 73 65 2a 2c 53 72 63 4c 69 73 74 e(Parse*,SrcList
20040 2a 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 *,Expr*,ExprList
20050 2a 2c 45 78 70 72 2a 2c 45 78 70 72 2a 2c 63 68 *,Expr*,Expr*,ch
20060 61 72 2a 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 ar*);.#endif.voi
20070 64 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 46 d sqlite3DeleteF
20080 72 6f 6d 28 50 61 72 73 65 2a 2c 20 53 72 63 4c rom(Parse*, SrcL
20090 69 73 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f ist*, Expr*);.vo
200a0 69 64 20 73 71 6c 69 74 65 33 55 70 64 61 74 65 id sqlite3Update
200b0 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 (Parse*, SrcList
200c0 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 45 78 *, ExprList*, Ex
200d0 70 72 2a 2c 20 69 6e 74 29 3b 0a 57 68 65 72 65 pr*, int);.Where
200e0 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 57 68 65 Info *sqlite3Whe
200f0 72 65 42 65 67 69 6e 28 50 61 72 73 65 2a 2c 53 reBegin(Parse*,S
20100 72 63 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 rcList*,Expr*,Ex
20110 70 72 4c 69 73 74 2a 2c 45 78 70 72 4c 69 73 74 prList*,ExprList
20120 2a 2c 75 31 36 2c 69 6e 74 29 3b 0a 76 6f 69 64 *,u16,int);.void
20130 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 6e 64 sqlite3WhereEnd
20140 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 75 36 (WhereInfo*);.u6
20150 34 20 73 71 6c 69 74 65 33 57 68 65 72 65 4f 75 4 sqlite3WhereOu
20160 74 70 75 74 52 6f 77 43 6f 75 6e 74 28 57 68 65 tputRowCount(Whe
20170 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 reInfo*);.int sq
20180 6c 69 74 65 33 57 68 65 72 65 49 73 44 69 73 74 lite3WhereIsDist
20190 69 6e 63 74 28 57 68 65 72 65 49 6e 66 6f 2a 29 inct(WhereInfo*)
201a0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 65 ;.int sqlite3Whe
201b0 72 65 49 73 4f 72 64 65 72 65 64 28 57 68 65 72 reIsOrdered(Wher
201c0 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c eInfo*);.int sql
201d0 69 74 65 33 57 68 65 72 65 43 6f 6e 74 69 6e 75 ite3WhereContinu
201e0 65 4c 61 62 65 6c 28 57 68 65 72 65 49 6e 66 6f eLabel(WhereInfo
201f0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 *);.int sqlite3W
20200 68 65 72 65 42 72 65 61 6b 4c 61 62 65 6c 28 57 hereBreakLabel(W
20210 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 hereInfo*);.int
20220 73 71 6c 69 74 65 33 57 68 65 72 65 4f 6b 4f 6e sqlite3WhereOkOn
20230 65 50 61 73 73 28 57 68 65 72 65 49 6e 66 6f 2a ePass(WhereInfo*
20240 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c , int*);.int sql
20250 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 74 43 ite3ExprCodeGetC
20260 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 20 54 61 olumn(Parse*, Ta
20270 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 ble*, int, int,
20280 69 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 int, u8);.void s
20290 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 qlite3ExprCodeGe
202a0 74 43 6f 6c 75 6d 6e 4f 66 54 61 62 6c 65 28 56 tColumnOfTable(V
202b0 64 62 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e dbe*, Table*, in
202c0 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f t, int, int);.vo
202d0 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f id sqlite3ExprCo
202e0 64 65 4d 6f 76 65 28 50 61 72 73 65 2a 2c 20 69 deMove(Parse*, i
202f0 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 nt, int, int);.v
20300 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
20310 61 63 68 65 53 74 6f 72 65 28 50 61 72 73 65 2a acheStore(Parse*
20320 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 , int, int, int)
20330 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
20340 70 72 43 61 63 68 65 50 75 73 68 28 50 61 72 73 prCachePush(Pars
20350 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
20360 33 45 78 70 72 43 61 63 68 65 50 6f 70 28 50 61 3ExprCachePop(Pa
20370 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 rse*, int);.void
20380 20 73 71 6c 69 74 65 33 45 78 70 72 43 61 63 68 sqlite3ExprCach
20390 65 52 65 6d 6f 76 65 28 50 61 72 73 65 2a 2c 20 eRemove(Parse*,
203a0 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
203b0 73 71 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 sqlite3ExprCache
203c0 43 6c 65 61 72 28 50 61 72 73 65 2a 29 3b 0a 76 Clear(Parse*);.v
203d0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
203e0 61 63 68 65 41 66 66 69 6e 69 74 79 43 68 61 6e acheAffinityChan
203f0 67 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 ge(Parse*, int,
20400 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
20410 33 45 78 70 72 43 6f 64 65 28 50 61 72 73 65 2a 3ExprCode(Parse*
20420 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 , Expr*, int);.v
20430 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
20440 6f 64 65 41 74 49 6e 69 74 28 50 61 72 73 65 2a odeAtInit(Parse*
20450 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 75 38 , Expr*, int, u8
20460 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
20470 70 72 43 6f 64 65 54 65 6d 70 28 50 61 72 73 65 prCodeTemp(Parse
20480 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2a 29 3b *, Expr*, int*);
20490 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
204a0 43 6f 64 65 54 61 72 67 65 74 28 50 61 72 73 65 CodeTarget(Parse
204b0 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a *, Expr*, int);.
204c0 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 int sqlite3ExprC
204d0 6f 64 65 41 6e 64 43 61 63 68 65 28 50 61 72 73 odeAndCache(Pars
204e0 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b e*, Expr*, int);
204f0 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
20500 43 6f 64 65 45 78 70 72 4c 69 73 74 28 50 61 72 CodeExprList(Par
20510 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 se*, ExprList*,
20520 69 6e 74 2c 20 75 38 29 3b 0a 23 64 65 66 69 6e int, u8);.#defin
20530 65 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f 44 55 e SQLITE_ECEL_DU
20540 50 20 20 20 20 20 20 30 78 30 31 20 20 2f 2a 20 P 0x01 /*
20550 44 65 65 70 2c 20 6e 6f 74 20 73 68 61 6c 6c 6f Deep, not shallo
20560 77 20 63 6f 70 69 65 73 20 2a 2f 0a 23 64 65 66 w copies */.#def
20570 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f ine SQLITE_ECEL_
20580 46 41 43 54 4f 52 20 20 20 30 78 30 32 20 20 2f FACTOR 0x02 /
20590 2a 20 46 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e * Factor out con
205a0 73 74 61 6e 74 20 74 65 72 6d 73 20 2a 2f 0a 76 stant terms */.v
205b0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 49 oid sqlite3ExprI
205c0 66 54 72 75 65 28 50 61 72 73 65 2a 2c 20 45 78 fTrue(Parse*, Ex
205d0 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a pr*, int, int);.
205e0 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
205f0 49 66 46 61 6c 73 65 28 50 61 72 73 65 2a 2c 20 IfFalse(Parse*,
20600 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 Expr*, int, int)
20610 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 ;.Table *sqlite3
20620 46 69 6e 64 54 61 62 6c 65 28 73 71 6c 69 74 65 FindTable(sqlite
20630 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 3*,const char*,
20640 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 54 61 const char*);.Ta
20650 62 6c 65 20 2a 73 71 6c 69 74 65 33 4c 6f 63 61 ble *sqlite3Loca
20660 74 65 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 69 teTable(Parse*,i
20670 6e 74 20 69 73 56 69 65 77 2c 63 6f 6e 73 74 20 nt isView,const
20680 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 char*, const cha
20690 72 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 r*);.Table *sqli
206a0 74 65 33 4c 6f 63 61 74 65 54 61 62 6c 65 49 74 te3LocateTableIt
206b0 65 6d 28 50 61 72 73 65 2a 2c 69 6e 74 20 69 73 em(Parse*,int is
206c0 56 69 65 77 2c 73 74 72 75 63 74 20 53 72 63 4c View,struct SrcL
206d0 69 73 74 5f 69 74 65 6d 20 2a 29 3b 0a 49 6e 64 ist_item *);.Ind
206e0 65 78 20 2a 73 71 6c 69 74 65 33 46 69 6e 64 49 ex *sqlite3FindI
206f0 6e 64 65 78 28 73 71 6c 69 74 65 33 2a 2c 63 6f ndex(sqlite3*,co
20700 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 nst char*, const
20710 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 char*);.void sq
20720 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 lite3UnlinkAndDe
20730 6c 65 74 65 54 61 62 6c 65 28 73 71 6c 69 74 65 leteTable(sqlite
20740 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 3*,int,const cha
20750 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
20760 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 3UnlinkAndDelete
20770 49 6e 64 65 78 28 73 71 6c 69 74 65 33 2a 2c 69 Index(sqlite3*,i
20780 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b nt,const char*);
20790 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 61 63 .void sqlite3Vac
207a0 75 75 6d 28 50 61 72 73 65 2a 29 3b 0a 69 6e 74 uum(Parse*);.int
207b0 20 73 71 6c 69 74 65 33 52 75 6e 56 61 63 75 75 sqlite3RunVacuu
207c0 6d 28 63 68 61 72 2a 2a 2c 20 73 71 6c 69 74 65 m(char**, sqlite
207d0 33 2a 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 3*);.char *sqlit
207e0 65 33 4e 61 6d 65 46 72 6f 6d 54 6f 6b 65 6e 28 e3NameFromToken(
207f0 73 71 6c 69 74 65 33 2a 2c 20 54 6f 6b 65 6e 2a sqlite3*, Token*
20800 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
20810 70 72 43 6f 6d 70 61 72 65 28 45 78 70 72 2a 2c prCompare(Expr*,
20820 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e Expr*, int);.in
20830 74 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 t sqlite3ExprLis
20840 74 43 6f 6d 70 61 72 65 28 45 78 70 72 4c 69 73 tCompare(ExprLis
20850 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 t*, ExprList*, i
20860 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
20870 45 78 70 72 49 6d 70 6c 69 65 73 45 78 70 72 28 ExprImpliesExpr(
20880 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 69 6e Expr*, Expr*, in
20890 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
208a0 45 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 72 65 ExprAnalyzeAggre
208b0 67 61 74 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 gates(NameContex
208c0 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 t*, Expr*);.void
208d0 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 61 6c sqlite3ExprAnal
208e0 79 7a 65 41 67 67 4c 69 73 74 28 4e 61 6d 65 43 yzeAggList(NameC
208f0 6f 6e 74 65 78 74 2a 2c 45 78 70 72 4c 69 73 74 ontext*,ExprList
20900 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 *);.int sqlite3F
20910 75 6e 63 74 69 6f 6e 55 73 65 73 54 68 69 73 53 unctionUsesThisS
20920 72 63 28 45 78 70 72 2a 2c 20 53 72 63 4c 69 73 rc(Expr*, SrcLis
20930 74 2a 29 3b 0a 56 64 62 65 20 2a 73 71 6c 69 74 t*);.Vdbe *sqlit
20940 65 33 47 65 74 56 64 62 65 28 50 61 72 73 65 2a e3GetVdbe(Parse*
20950 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 );.void sqlite3P
20960 72 6e 67 53 61 76 65 53 74 61 74 65 28 76 6f 69 rngSaveState(voi
20970 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 d);.void sqlite3
20980 50 72 6e 67 52 65 73 74 6f 72 65 53 74 61 74 65 PrngRestoreState
20990 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c (void);.void sql
209a0 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 ite3RollbackAll(
209b0 73 71 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 sqlite3*,int);.v
209c0 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 56 oid sqlite3CodeV
209d0 65 72 69 66 79 53 63 68 65 6d 61 28 50 61 72 73 erifySchema(Pars
209e0 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 e*, int);.void s
209f0 71 6c 69 74 65 33 43 6f 64 65 56 65 72 69 66 79 qlite3CodeVerify
20a00 4e 61 6d 65 64 53 63 68 65 6d 61 28 50 61 72 73 NamedSchema(Pars
20a10 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a e*, const char *
20a20 7a 44 62 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 zDb);.void sqlit
20a30 65 33 42 65 67 69 6e 54 72 61 6e 73 61 63 74 69 e3BeginTransacti
20a40 6f 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b on(Parse*, int);
20a50 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6d .void sqlite3Com
20a60 6d 69 74 54 72 61 6e 73 61 63 74 69 6f 6e 28 50 mitTransaction(P
20a70 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c arse*);.void sql
20a80 69 74 65 33 52 6f 6c 6c 62 61 63 6b 54 72 61 6e ite3RollbackTran
20a90 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a 29 3b saction(Parse*);
20aa0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 61 76 .void sqlite3Sav
20ab0 65 70 6f 69 6e 74 28 50 61 72 73 65 2a 2c 20 69 epoint(Parse*, i
20ac0 6e 74 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 nt, Token*);.voi
20ad0 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 53 61 d sqlite3CloseSa
20ae0 76 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 65 33 vepoints(sqlite3
20af0 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);.void sqlite
20b00 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 43 6c 3LeaveMutexAndCl
20b10 6f 73 65 5a 6f 6d 62 69 65 28 73 71 6c 69 74 65 oseZombie(sqlite
20b20 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 3*);.int sqlite3
20b30 45 78 70 72 49 73 43 6f 6e 73 74 61 6e 74 28 45 ExprIsConstant(E
20b40 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 xpr*);.int sqlit
20b50 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 6e 74 e3ExprIsConstant
20b60 4e 6f 74 4a 6f 69 6e 28 45 78 70 72 2a 29 3b 0a NotJoin(Expr*);.
20b70 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 int sqlite3ExprI
20b80 73 43 6f 6e 73 74 61 6e 74 4f 72 46 75 6e 63 74 sConstantOrFunct
20b90 69 6f 6e 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 ion(Expr*);.int
20ba0 73 71 6c 69 74 65 33 45 78 70 72 49 73 49 6e 74 sqlite3ExprIsInt
20bb0 65 67 65 72 28 45 78 70 72 2a 2c 20 69 6e 74 2a eger(Expr*, int*
20bc0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
20bd0 70 72 43 61 6e 42 65 4e 75 6c 6c 28 63 6f 6e 73 prCanBeNull(cons
20be0 74 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 t Expr*);.void s
20bf0 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 49 73 qlite3ExprCodeIs
20c00 4e 75 6c 6c 4a 75 6d 70 28 56 64 62 65 2a 2c 20 NullJump(Vdbe*,
20c10 63 6f 6e 73 74 20 45 78 70 72 2a 2c 20 69 6e 74 const Expr*, int
20c20 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 , int);.int sqli
20c30 74 65 33 45 78 70 72 4e 65 65 64 73 4e 6f 41 66 te3ExprNeedsNoAf
20c40 66 69 6e 69 74 79 43 68 61 6e 67 65 28 63 6f 6e finityChange(con
20c50 73 74 20 45 78 70 72 2a 2c 20 63 68 61 72 29 3b st Expr*, char);
20c60 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 73 52 6f .int sqlite3IsRo
20c70 77 69 64 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 wid(const char*)
20c80 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 65 ;.void sqlite3Ge
20c90 6e 65 72 61 74 65 52 6f 77 44 65 6c 65 74 65 28 nerateRowDelete(
20ca0 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 54 72 Parse*,Table*,Tr
20cb0 69 67 67 65 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 igger*,int,int,i
20cc0 6e 74 2c 69 31 36 2c 75 38 2c 75 38 2c 75 38 29 nt,i16,u8,u8,u8)
20cd0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 65 ;.void sqlite3Ge
20ce0 6e 65 72 61 74 65 52 6f 77 49 6e 64 65 78 44 65 nerateRowIndexDe
20cf0 6c 65 74 65 28 50 61 72 73 65 2a 2c 20 54 61 62 lete(Parse*, Tab
20d00 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 le*, int, int, i
20d10 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 nt*);.int sqlite
20d20 33 47 65 6e 65 72 61 74 65 49 6e 64 65 78 4b 65 3GenerateIndexKe
20d30 79 28 50 61 72 73 65 2a 2c 20 49 6e 64 65 78 2a y(Parse*, Index*
20d40 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c , int, int, int,
20d50 20 69 6e 74 2a 2c 49 6e 64 65 78 2a 2c 69 6e 74 int*,Index*,int
20d60 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 );.void sqlite3G
20d70 65 6e 65 72 61 74 65 43 6f 6e 73 74 72 61 69 6e enerateConstrain
20d80 74 43 68 65 63 6b 73 28 50 61 72 73 65 2a 2c 54 tChecks(Parse*,T
20d90 61 62 6c 65 2a 2c 69 6e 74 2a 2c 69 6e 74 2c 69 able*,int*,int,i
20da0 6e 74 2c 69 6e 74 2c 69 6e 74 2c 0a 20 20 20 20 nt,int,int,.
20db0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20dc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20dd0 20 75 38 2c 75 38 2c 69 6e 74 2c 69 6e 74 2a 29 u8,u8,int,int*)
20de0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f ;.void sqlite3Co
20df0 6d 70 6c 65 74 65 49 6e 73 65 72 74 69 6f 6e 28 mpleteInsertion(
20e00 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 69 6e Parse*,Table*,in
20e10 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2a 2c 69 t,int,int,int*,i
20e20 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a 69 6e 74 nt,int,int);.int
20e30 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 61 62 6c sqlite3OpenTabl
20e40 65 41 6e 64 49 6e 64 69 63 65 73 28 50 61 72 73 eAndIndices(Pars
20e50 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c e*, Table*, int,
20e60 20 69 6e 74 2c 20 75 38 2a 2c 20 69 6e 74 2a 2c int, u8*, int*,
20e70 20 69 6e 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c int*);.void sql
20e80 69 74 65 33 42 65 67 69 6e 57 72 69 74 65 4f 70 ite3BeginWriteOp
20e90 65 72 61 74 69 6f 6e 28 50 61 72 73 65 2a 2c 20 eration(Parse*,
20ea0 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
20eb0 73 71 6c 69 74 65 33 4d 75 6c 74 69 57 72 69 74 sqlite3MultiWrit
20ec0 65 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 e(Parse*);.void
20ed0 73 71 6c 69 74 65 33 4d 61 79 41 62 6f 72 74 28 sqlite3MayAbort(
20ee0 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 Parse*);.void sq
20ef0 6c 69 74 65 33 48 61 6c 74 43 6f 6e 73 74 72 61 lite3HaltConstra
20f00 69 6e 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c int(Parse*, int,
20f10 20 69 6e 74 2c 20 63 68 61 72 2a 2c 20 69 38 2c int, char*, i8,
20f20 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u8);.void sqlit
20f30 65 33 55 6e 69 71 75 65 43 6f 6e 73 74 72 61 69 e3UniqueConstrai
20f40 6e 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 nt(Parse*, int,
20f50 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 Index*);.void sq
20f60 6c 69 74 65 33 52 6f 77 69 64 43 6f 6e 73 74 72 lite3RowidConstr
20f70 61 69 6e 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 aint(Parse*, int
20f80 2c 20 54 61 62 6c 65 2a 29 3b 0a 45 78 70 72 20 , Table*);.Expr
20f90 2a 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 *sqlite3ExprDup(
20fa0 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 69 sqlite3*,Expr*,i
20fb0 6e 74 29 3b 0a 45 78 70 72 4c 69 73 74 20 2a 73 nt);.ExprList *s
20fc0 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 44 75 qlite3ExprListDu
20fd0 70 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 4c p(sqlite3*,ExprL
20fe0 69 73 74 2a 2c 69 6e 74 29 3b 0a 53 72 63 4c 69 ist*,int);.SrcLi
20ff0 73 74 20 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 st *sqlite3SrcLi
21000 73 74 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 53 stDup(sqlite3*,S
21010 72 63 4c 69 73 74 2a 2c 69 6e 74 29 3b 0a 49 64 rcList*,int);.Id
21020 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 64 4c List *sqlite3IdL
21030 69 73 74 44 75 70 28 73 71 6c 69 74 65 33 2a 2c istDup(sqlite3*,
21040 49 64 4c 69 73 74 2a 29 3b 0a 53 65 6c 65 63 74 IdList*);.Select
21050 20 2a 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 *sqlite3SelectD
21060 75 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c 65 up(sqlite3*,Sele
21070 63 74 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 ct*,int);.void s
21080 71 6c 69 74 65 33 46 75 6e 63 44 65 66 49 6e 73 qlite3FuncDefIns
21090 65 72 74 28 46 75 6e 63 44 65 66 48 61 73 68 2a ert(FuncDefHash*
210a0 2c 20 46 75 6e 63 44 65 66 2a 29 3b 0a 46 75 6e , FuncDef*);.Fun
210b0 63 44 65 66 20 2a 73 71 6c 69 74 65 33 46 69 6e cDef *sqlite3Fin
210c0 64 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 dFunction(sqlite
210d0 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 3*,const char*,i
210e0 6e 74 2c 69 6e 74 2c 75 38 2c 75 38 29 3b 0a 76 nt,int,u8,u8);.v
210f0 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 73 oid sqlite3Regis
21100 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 terBuiltinFuncti
21110 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 ons(sqlite3*);.v
21120 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 73 oid sqlite3Regis
21130 74 65 72 44 61 74 65 54 69 6d 65 46 75 6e 63 74 terDateTimeFunct
21140 69 6f 6e 73 28 76 6f 69 64 29 3b 0a 76 6f 69 64 ions(void);.void
21150 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 sqlite3Register
21160 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 28 GlobalFunctions(
21170 76 6f 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74 void);.int sqlit
21180 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 e3SafetyCheckOk(
21190 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 sqlite3*);.int s
211a0 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 qlite3SafetyChec
211b0 6b 53 69 63 6b 4f 72 4f 6b 28 73 71 6c 69 74 65 kSickOrOk(sqlite
211c0 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 3*);.void sqlite
211d0 33 43 68 61 6e 67 65 43 6f 6f 6b 69 65 28 50 61 3ChangeCookie(Pa
211e0 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 0a 23 69 66 rse*, int);..#if
211f0 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
21200 5f 4f 4d 49 54 5f 56 49 45 57 29 20 26 26 20 21 _OMIT_VIEW) && !
21210 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f defined(SQLITE_O
21220 4d 49 54 5f 54 52 49 47 47 45 52 29 0a 76 6f 69 MIT_TRIGGER).voi
21230 64 20 73 71 6c 69 74 65 33 4d 61 74 65 72 69 61 d sqlite3Materia
21240 6c 69 7a 65 56 69 65 77 28 50 61 72 73 65 2a 2c lizeView(Parse*,
21250 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a 2c 20 Table*, Expr*,
21260 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 int);.#endif..#i
21270 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
21280 54 5f 54 52 49 47 47 45 52 0a 20 20 76 6f 69 64 T_TRIGGER. void
21290 20 73 71 6c 69 74 65 33 42 65 67 69 6e 54 72 69 sqlite3BeginTri
212a0 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 6f 6b gger(Parse*, Tok
212b0 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 2c 69 en*,Token*,int,i
212c0 6e 74 2c 49 64 4c 69 73 74 2a 2c 53 72 63 4c 69 nt,IdList*,SrcLi
212d0 73 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 st*,.
212e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
212f0 45 78 70 72 2a 2c 69 6e 74 2c 20 69 6e 74 29 3b Expr*,int, int);
21300 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 46 . void sqlite3F
21310 69 6e 69 73 68 54 72 69 67 67 65 72 28 50 61 72 inishTrigger(Par
21320 73 65 2a 2c 20 54 72 69 67 67 65 72 53 74 65 70 se*, TriggerStep
21330 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 20 20 76 6f *, Token*);. vo
21340 69 64 20 73 71 6c 69 74 65 33 44 72 6f 70 54 72 id sqlite3DropTr
21350 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 53 72 igger(Parse*, Sr
21360 63 4c 69 73 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 cList*, int);.
21370 76 6f 69 64 20 73 71 6c 69 74 65 33 44 72 6f 70 void sqlite3Drop
21380 54 72 69 67 67 65 72 50 74 72 28 50 61 72 73 65 TriggerPtr(Parse
21390 2a 2c 20 54 72 69 67 67 65 72 2a 29 3b 0a 20 20 *, Trigger*);.
213a0 54 72 69 67 67 65 72 20 2a 73 71 6c 69 74 65 33 Trigger *sqlite3
213b0 54 72 69 67 67 65 72 73 45 78 69 73 74 28 50 61 TriggersExist(Pa
213c0 72 73 65 20 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 rse *, Table*, i
213d0 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 nt, ExprList*, i
213e0 6e 74 20 2a 70 4d 61 73 6b 29 3b 0a 20 20 54 72 nt *pMask);. Tr
213f0 69 67 67 65 72 20 2a 73 71 6c 69 74 65 33 54 72 igger *sqlite3Tr
21400 69 67 67 65 72 4c 69 73 74 28 50 61 72 73 65 20 iggerList(Parse
21410 2a 2c 20 54 61 62 6c 65 20 2a 29 3b 0a 20 20 76 *, Table *);. v
21420 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 52 oid sqlite3CodeR
21430 6f 77 54 72 69 67 67 65 72 28 50 61 72 73 65 2a owTrigger(Parse*
21440 2c 20 54 72 69 67 67 65 72 20 2a 2c 20 69 6e 74 , Trigger *, int
21450 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 , ExprList*, int
21460 2c 20 54 61 62 6c 65 20 2a 2c 0a 20 20 20 20 20 , Table *,.
21470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21480 20 20 20 20 20 20 20 69 6e 74 2c 20 69 6e 74 2c int, int,
21490 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 71 int);. void sq
214a0 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 lite3CodeRowTrig
214b0 67 65 72 44 69 72 65 63 74 28 50 61 72 73 65 20 gerDirect(Parse
214c0 2a 2c 20 54 72 69 67 67 65 72 20 2a 2c 20 54 61 *, Trigger *, Ta
214d0 62 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c ble *, int, int,
214e0 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 71 int);. void sq
214f0 6c 69 74 65 56 69 65 77 54 72 69 67 67 65 72 73 liteViewTriggers
21500 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
21510 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 45 78 70 Expr*, int, Exp
21520 72 4c 69 73 74 2a 29 3b 0a 20 20 76 6f 69 64 20 rList*);. void
21530 73 71 6c 69 74 65 33 44 65 6c 65 74 65 54 72 69 sqlite3DeleteTri
21540 67 67 65 72 53 74 65 70 28 73 71 6c 69 74 65 33 ggerStep(sqlite3
21550 2a 2c 20 54 72 69 67 67 65 72 53 74 65 70 2a 29 *, TriggerStep*)
21560 3b 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 20 ;. TriggerStep
21570 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 53 *sqlite3TriggerS
21580 65 6c 65 63 74 53 74 65 70 28 73 71 6c 69 74 65 electStep(sqlite
21590 33 2a 2c 53 65 6c 65 63 74 2a 29 3b 0a 20 20 54 3*,Select*);. T
215a0 72 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 riggerStep *sqli
215b0 74 65 33 54 72 69 67 67 65 72 49 6e 73 65 72 74 te3TriggerInsert
215c0 53 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 6f Step(sqlite3*,To
215d0 6b 65 6e 2a 2c 20 49 64 4c 69 73 74 2a 2c 0a 20 ken*, IdList*,.
215e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
215f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21600 20 20 20 20 20 20 20 53 65 6c 65 63 74 2a 2c 75 Select*,u
21610 38 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 65 8);. TriggerSte
21620 70 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 p *sqlite3Trigge
21630 72 55 70 64 61 74 65 53 74 65 70 28 73 71 6c 69 rUpdateStep(sqli
21640 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 45 78 70 72 te3*,Token*,Expr
21650 4c 69 73 74 2a 2c 20 45 78 70 72 2a 2c 20 75 38 List*, Expr*, u8
21660 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 );. TriggerStep
21670 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 *sqlite3Trigger
21680 44 65 6c 65 74 65 53 74 65 70 28 73 71 6c 69 74 DeleteStep(sqlit
21690 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 45 78 70 72 e3*,Token*, Expr
216a0 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 *);. void sqlit
216b0 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 28 e3DeleteTrigger(
216c0 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 67 67 65 sqlite3*, Trigge
216d0 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 r*);. void sqli
216e0 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 te3UnlinkAndDele
216f0 74 65 54 72 69 67 67 65 72 28 73 71 6c 69 74 65 teTrigger(sqlite
21700 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 3*,int,const cha
21710 72 2a 29 3b 0a 20 20 75 33 32 20 73 71 6c 69 74 r*);. u32 sqlit
21720 65 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 73 6b e3TriggerColmask
21730 28 50 61 72 73 65 2a 2c 54 72 69 67 67 65 72 2a (Parse*,Trigger*
21740 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 2c 69 ,ExprList*,int,i
21750 6e 74 2c 54 61 62 6c 65 2a 2c 69 6e 74 29 3b 0a nt,Table*,int);.
21760 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
21770 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 29 ParseToplevel(p)
21780 20 28 28 70 29 2d 3e 70 54 6f 70 6c 65 76 65 6c ((p)->pToplevel
21790 20 3f 20 28 70 29 2d 3e 70 54 6f 70 6c 65 76 65 ? (p)->pTopleve
217a0 6c 20 3a 20 28 70 29 29 0a 23 65 6c 73 65 0a 23 l : (p)).#else.#
217b0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 define sqlite3T
217c0 72 69 67 67 65 72 73 45 78 69 73 74 28 42 2c 43 riggersExist(B,C
217d0 2c 44 2c 45 2c 46 29 20 30 0a 23 20 64 65 66 69 ,D,E,F) 0.# defi
217e0 6e 65 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 ne sqlite3Delete
217f0 54 72 69 67 67 65 72 28 41 2c 42 29 0a 23 20 64 Trigger(A,B).# d
21800 65 66 69 6e 65 20 73 71 6c 69 74 65 33 44 72 6f efine sqlite3Dro
21810 70 54 72 69 67 67 65 72 50 74 72 28 41 2c 42 29 pTriggerPtr(A,B)
21820 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
21830 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 3UnlinkAndDelete
21840 54 72 69 67 67 65 72 28 41 2c 42 2c 43 29 0a 23 Trigger(A,B,C).#
21850 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 43 define sqlite3C
21860 6f 64 65 52 6f 77 54 72 69 67 67 65 72 28 41 2c odeRowTrigger(A,
21870 42 2c 43 2c 44 2c 45 2c 46 2c 47 2c 48 2c 49 29 B,C,D,E,F,G,H,I)
21880 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
21890 33 43 6f 64 65 52 6f 77 54 72 69 67 67 65 72 44 3CodeRowTriggerD
218a0 69 72 65 63 74 28 41 2c 42 2c 43 2c 44 2c 45 2c irect(A,B,C,D,E,
218b0 46 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 F).# define sqli
218c0 74 65 33 54 72 69 67 67 65 72 4c 69 73 74 28 58 te3TriggerList(X
218d0 2c 20 59 29 20 30 0a 23 20 64 65 66 69 6e 65 20 , Y) 0.# define
218e0 73 71 6c 69 74 65 33 50 61 72 73 65 54 6f 70 6c sqlite3ParseTopl
218f0 65 76 65 6c 28 70 29 20 70 0a 23 20 64 65 66 69 evel(p) p.# defi
21900 6e 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 ne sqlite3Trigge
21910 72 43 6f 6c 6d 61 73 6b 28 41 2c 42 2c 43 2c 44 rColmask(A,B,C,D
21920 2c 45 2c 46 2c 47 29 20 30 0a 23 65 6e 64 69 66 ,E,F,G) 0.#endif
21930 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 69 ..int sqlite3Joi
21940 6e 54 79 70 65 28 50 61 72 73 65 2a 2c 20 54 6f nType(Parse*, To
21950 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f ken*, Token*, To
21960 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ken*);.void sqli
21970 74 65 33 43 72 65 61 74 65 46 6f 72 65 69 67 6e te3CreateForeign
21980 4b 65 79 28 50 61 72 73 65 2a 2c 20 45 78 70 72 Key(Parse*, Expr
21990 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 45 List*, Token*, E
219a0 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 3b 0a xprList*, int);.
219b0 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 66 65 void sqlite3Defe
219c0 72 46 6f 72 65 69 67 6e 4b 65 79 28 50 61 72 73 rForeignKey(Pars
219d0 65 2a 2c 20 69 6e 74 29 3b 0a 23 69 66 6e 64 65 e*, int);.#ifnde
219e0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
219f0 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 76 6f THORIZATION. vo
21a00 69 64 20 73 71 6c 69 74 65 33 41 75 74 68 52 65 id sqlite3AuthRe
21a10 61 64 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c ad(Parse*,Expr*,
21a20 53 63 68 65 6d 61 2a 2c 53 72 63 4c 69 73 74 2a Schema*,SrcList*
21a30 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
21a40 41 75 74 68 43 68 65 63 6b 28 50 61 72 73 65 2a AuthCheck(Parse*
21a50 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 ,int, const char
21a60 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 *, const char*,
21a70 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 const char*);.
21a80 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 68 void sqlite3Auth
21a90 43 6f 6e 74 65 78 74 50 75 73 68 28 50 61 72 73 ContextPush(Pars
21aa0 65 2a 2c 20 41 75 74 68 43 6f 6e 74 65 78 74 2a e*, AuthContext*
21ab0 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a , const char*);.
21ac0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 void sqlite3Au
21ad0 74 68 43 6f 6e 74 65 78 74 50 6f 70 28 41 75 74 thContextPop(Aut
21ae0 68 43 6f 6e 74 65 78 74 2a 29 3b 0a 20 20 69 6e hContext*);. in
21af0 74 20 73 71 6c 69 74 65 33 41 75 74 68 52 65 61 t sqlite3AuthRea
21b00 64 43 6f 6c 28 50 61 72 73 65 2a 2c 20 63 6f 6e dCol(Parse*, con
21b10 73 74 20 63 68 61 72 20 2a 2c 20 63 6f 6e 73 74 st char *, const
21b20 20 63 68 61 72 20 2a 2c 20 69 6e 74 29 3b 0a 23 char *, int);.#
21b30 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 else.# define sq
21b40 6c 69 74 65 33 41 75 74 68 52 65 61 64 28 61 2c lite3AuthRead(a,
21b50 62 2c 63 2c 64 29 0a 23 20 64 65 66 69 6e 65 20 b,c,d).# define
21b60 73 71 6c 69 74 65 33 41 75 74 68 43 68 65 63 6b sqlite3AuthCheck
21b70 28 61 2c 62 2c 63 2c 64 2c 65 29 20 20 20 20 53 (a,b,c,d,e) S
21b80 51 4c 49 54 45 5f 4f 4b 0a 23 20 64 65 66 69 6e QLITE_OK.# defin
21b90 65 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e e sqlite3AuthCon
21ba0 74 65 78 74 50 75 73 68 28 61 2c 62 2c 63 29 0a textPush(a,b,c).
21bb0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
21bc0 41 75 74 68 43 6f 6e 74 65 78 74 50 6f 70 28 61 AuthContextPop(a
21bd0 29 20 20 28 28 76 6f 69 64 29 28 61 29 29 0a 23 ) ((void)(a)).#
21be0 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 endif.void sqlit
21bf0 65 33 41 74 74 61 63 68 28 50 61 72 73 65 2a 2c e3Attach(Parse*,
21c00 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 45 Expr*, Expr*, E
21c10 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
21c20 74 65 33 44 65 74 61 63 68 28 50 61 72 73 65 2a te3Detach(Parse*
21c30 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 , Expr*);.void s
21c40 71 6c 69 74 65 33 46 69 78 49 6e 69 74 28 44 62 qlite3FixInit(Db
21c50 46 69 78 65 72 2a 2c 20 50 61 72 73 65 2a 2c 20 Fixer*, Parse*,
21c60 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a int, const char*
21c70 2c 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 29 3b , const Token*);
21c80 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 53 .int sqlite3FixS
21c90 72 63 4c 69 73 74 28 44 62 46 69 78 65 72 2a 2c rcList(DbFixer*,
21ca0 20 53 72 63 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 SrcList*);.int
21cb0 73 71 6c 69 74 65 33 46 69 78 53 65 6c 65 63 74 sqlite3FixSelect
21cc0 28 44 62 46 69 78 65 72 2a 2c 20 53 65 6c 65 63 (DbFixer*, Selec
21cd0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
21ce0 46 69 78 45 78 70 72 28 44 62 46 69 78 65 72 2a FixExpr(DbFixer*
21cf0 2c 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 , Expr*);.int sq
21d00 6c 69 74 65 33 46 69 78 45 78 70 72 4c 69 73 74 lite3FixExprList
21d10 28 44 62 46 69 78 65 72 2a 2c 20 45 78 70 72 4c (DbFixer*, ExprL
21d20 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ist*);.int sqlit
21d30 65 33 46 69 78 54 72 69 67 67 65 72 53 74 65 70 e3FixTriggerStep
21d40 28 44 62 46 69 78 65 72 2a 2c 20 54 72 69 67 67 (DbFixer*, Trigg
21d50 65 72 53 74 65 70 2a 29 3b 0a 69 6e 74 20 73 71 erStep*);.int sq
21d60 6c 69 74 65 33 41 74 6f 46 28 63 6f 6e 73 74 20 lite3AtoF(const
21d70 63 68 61 72 20 2a 7a 2c 20 64 6f 75 62 6c 65 2a char *z, double*
21d80 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 6e 74 20 , int, u8);.int
21d90 73 71 6c 69 74 65 33 47 65 74 49 6e 74 33 32 28 sqlite3GetInt32(
21da0 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 6e const char *, in
21db0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
21dc0 41 74 6f 69 28 63 6f 6e 73 74 20 63 68 61 72 2a Atoi(const char*
21dd0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 74 );.int sqlite3Ut
21de0 66 31 36 42 79 74 65 4c 65 6e 28 63 6f 6e 73 74 f16ByteLen(const
21df0 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 69 6e void *pData, in
21e00 74 20 6e 43 68 61 72 29 3b 0a 69 6e 74 20 73 71 t nChar);.int sq
21e10 6c 69 74 65 33 55 74 66 38 43 68 61 72 4c 65 6e lite3Utf8CharLen
21e20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 70 44 61 (const char *pDa
21e30 74 61 2c 20 69 6e 74 20 6e 42 79 74 65 29 3b 0a ta, int nByte);.
21e40 75 33 32 20 73 71 6c 69 74 65 33 55 74 66 38 52 u32 sqlite3Utf8R
21e50 65 61 64 28 63 6f 6e 73 74 20 75 38 2a 2a 29 3b ead(const u8**);
21e60 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 65 33 4c .LogEst sqlite3L
21e70 6f 67 45 73 74 28 75 36 34 29 3b 0a 4c 6f 67 45 ogEst(u64);.LogE
21e80 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 st sqlite3LogEst
21e90 41 64 64 28 4c 6f 67 45 73 74 2c 4c 6f 67 45 73 Add(LogEst,LogEs
21ea0 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 t);.#ifndef SQLI
21eb0 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
21ec0 41 42 4c 45 0a 4c 6f 67 45 73 74 20 73 71 6c 69 ABLE.LogEst sqli
21ed0 74 65 33 4c 6f 67 45 73 74 46 72 6f 6d 44 6f 75 te3LogEstFromDou
21ee0 62 6c 65 28 64 6f 75 62 6c 65 29 3b 0a 23 65 6e ble(double);.#en
21ef0 64 69 66 0a 75 36 34 20 73 71 6c 69 74 65 33 4c dif.u64 sqlite3L
21f00 6f 67 45 73 74 54 6f 49 6e 74 28 4c 6f 67 45 73 ogEstToInt(LogEs
21f10 74 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 69 t);../*.** Routi
21f20 6e 65 73 20 74 6f 20 72 65 61 64 20 61 6e 64 20 nes to read and
21f30 77 72 69 74 65 20 76 61 72 69 61 62 6c 65 2d 6c write variable-l
21f40 65 6e 67 74 68 20 69 6e 74 65 67 65 72 73 2e 20 ength integers.
21f50 20 54 68 65 73 65 20 75 73 65 64 20 74 6f 0a 2a These used to.*
21f60 2a 20 62 65 20 64 65 66 69 6e 65 64 20 6c 6f 63 * be defined loc
21f70 61 6c 6c 79 2c 20 62 75 74 20 6e 6f 77 20 77 65 ally, but now we
21f80 20 75 73 65 20 74 68 65 20 76 61 72 69 6e 74 20 use the varint
21f90 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 65 20 routines in the
21fa0 75 74 69 6c 2e 63 0a 2a 2a 20 66 69 6c 65 2e 20 util.c.** file.
21fb0 20 43 6f 64 65 20 73 68 6f 75 6c 64 20 75 73 65 Code should use
21fc0 20 74 68 65 20 4d 41 43 52 4f 20 66 6f 72 6d 73 the MACRO forms
21fd0 20 62 65 6c 6f 77 2c 20 61 73 20 74 68 65 20 56 below, as the V
21fe0 61 72 69 6e 74 33 32 20 76 65 72 73 69 6f 6e 73 arint32 versions
21ff0 0a 2a 2a 20 61 72 65 20 63 6f 64 65 64 20 74 6f .** are coded to
22000 20 61 73 73 75 6d 65 20 74 68 65 20 73 69 6e 67 assume the sing
22010 6c 65 20 62 79 74 65 20 63 61 73 65 20 69 73 20 le byte case is
22020 61 6c 72 65 61 64 79 20 68 61 6e 64 6c 65 64 20 already handled
22030 28 77 68 69 63 68 20 0a 2a 2a 20 74 68 65 20 4d (which .** the M
22040 41 43 52 4f 20 66 6f 72 6d 20 64 6f 65 73 29 2e ACRO form does).
22050 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 .*/.int sqlite3P
22060 75 74 56 61 72 69 6e 74 28 75 6e 73 69 67 6e 65 utVarint(unsigne
22070 64 20 63 68 61 72 2a 2c 20 75 36 34 29 3b 0a 69 d char*, u64);.i
22080 6e 74 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 nt sqlite3PutVar
22090 69 6e 74 33 32 28 75 6e 73 69 67 6e 65 64 20 63 int32(unsigned c
220a0 68 61 72 2a 2c 20 75 33 32 29 3b 0a 75 38 20 73 har*, u32);.u8 s
220b0 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 28 qlite3GetVarint(
220c0 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 const unsigned c
220d0 68 61 72 20 2a 2c 20 75 36 34 20 2a 29 3b 0a 75 har *, u64 *);.u
220e0 38 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 8 sqlite3GetVari
220f0 6e 74 33 32 28 63 6f 6e 73 74 20 75 6e 73 69 67 nt32(const unsig
22100 6e 65 64 20 63 68 61 72 20 2a 2c 20 75 33 32 20 ned char *, u32
22110 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 *);.int sqlite3V
22120 61 72 69 6e 74 4c 65 6e 28 75 36 34 20 76 29 3b arintLen(u64 v);
22130 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 ../*.** The head
22140 65 72 20 6f 66 20 61 20 72 65 63 6f 72 64 20 63 er of a record c
22150 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 73 65 71 onsists of a seq
22160 75 65 6e 63 65 20 76 61 72 69 61 62 6c 65 2d 6c uence variable-l
22170 65 6e 67 74 68 20 69 6e 74 65 67 65 72 73 2e 0a ength integers..
22180 2a 2a 20 54 68 65 73 65 20 69 6e 74 65 67 65 72 ** These integer
22190 73 20 61 72 65 20 61 6c 6d 6f 73 74 20 61 6c 77 s are almost alw
221a0 61 79 73 20 73 6d 61 6c 6c 20 61 6e 64 20 61 72 ays small and ar
221b0 65 20 65 6e 63 6f 64 65 64 20 61 73 20 61 20 73 e encoded as a s
221c0 69 6e 67 6c 65 20 62 79 74 65 2e 0a 2a 2a 20 54 ingle byte..** T
221d0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 he following mac
221e0 72 6f 73 20 74 61 6b 65 20 61 64 76 61 6e 74 61 ros take advanta
221f0 67 65 20 74 68 69 73 20 66 61 63 74 20 74 6f 20 ge this fact to
22200 70 72 6f 76 69 64 65 20 61 20 66 61 73 74 20 65 provide a fast e
22210 6e 63 6f 64 65 0a 2a 2a 20 61 6e 64 20 64 65 63 ncode.** and dec
22220 6f 64 65 20 6f 66 20 74 68 65 20 69 6e 74 65 67 ode of the integ
22230 65 72 73 20 69 6e 20 61 20 72 65 63 6f 72 64 20 ers in a record
22240 68 65 61 64 65 72 2e 20 20 49 74 20 69 73 20 66 header. It is f
22250 61 73 74 65 72 20 66 6f 72 20 74 68 65 20 63 6f aster for the co
22260 6d 6d 6f 6e 0a 2a 2a 20 63 61 73 65 20 77 68 65 mmon.** case whe
22270 72 65 20 74 68 65 20 69 6e 74 65 67 65 72 20 69 re the integer i
22280 73 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65 2e s a single byte.
22290 20 20 49 74 20 69 73 20 61 20 6c 69 74 74 6c 65 It is a little
222a0 20 73 6c 6f 77 65 72 20 77 68 65 6e 20 74 68 65 slower when the
222b0 0a 2a 2a 20 69 6e 74 65 67 65 72 20 69 73 20 74 .** integer is t
222c0 77 6f 20 6f 72 20 6d 6f 72 65 20 62 79 74 65 73 wo or more bytes
222d0 2e 20 20 42 75 74 20 6f 76 65 72 61 6c 6c 20 69 . But overall i
222e0 74 20 69 73 20 66 61 73 74 65 72 2e 0a 2a 2a 0a t is faster..**.
222f0 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
22300 20 65 78 70 72 65 73 73 69 6f 6e 73 20 61 72 65 expressions are
22310 20 65 71 75 69 76 61 6c 65 6e 74 3a 0a 2a 2a 0a equivalent:.**.
22320 2a 2a 20 20 20 20 20 78 20 3d 20 73 71 6c 69 74 ** x = sqlit
22330 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 20 41 e3GetVarint32( A
22340 2c 20 26 42 20 29 3b 0a 2a 2a 20 20 20 20 20 78 , &B );.** x
22350 20 3d 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 = sqlite3PutVar
22360 69 6e 74 33 32 28 20 41 2c 20 42 20 29 3b 0a 2a int32( A, B );.*
22370 2a 0a 2a 2a 20 20 20 20 20 78 20 3d 20 67 65 74 *.** x = get
22380 56 61 72 69 6e 74 33 32 28 20 41 2c 20 42 20 29 Varint32( A, B )
22390 3b 0a 2a 2a 20 20 20 20 20 78 20 3d 20 70 75 74 ;.** x = put
223a0 56 61 72 69 6e 74 33 32 28 20 41 2c 20 42 20 29 Varint32( A, B )
223b0 3b 0a 2a 2a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ;.**.*/.#define
223c0 67 65 74 56 61 72 69 6e 74 33 32 28 41 2c 42 29 getVarint32(A,B)
223d0 20 20 5c 0a 20 20 28 75 38 29 28 28 2a 28 41 29 \. (u8)((*(A)
223e0 3c 28 75 38 29 30 78 38 30 29 3f 28 28 42 29 3d <(u8)0x80)?((B)=
223f0 28 75 33 32 29 2a 28 41 29 29 2c 31 3a 73 71 6c (u32)*(A)),1:sql
22400 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 ite3GetVarint32(
22410 28 41 29 2c 28 75 33 32 20 2a 29 26 28 42 29 29 (A),(u32 *)&(B))
22420 29 0a 23 64 65 66 69 6e 65 20 70 75 74 56 61 72 ).#define putVar
22430 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a 20 20 int32(A,B) \.
22440 28 75 38 29 28 28 28 75 33 32 29 28 42 29 3c 28 (u8)(((u32)(B)<(
22450 75 33 32 29 30 78 38 30 29 3f 28 2a 28 41 29 3d u32)0x80)?(*(A)=
22460 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
22470 42 29 29 2c 31 3a 5c 0a 20 20 73 71 6c 69 74 65 B)),1:\. sqlite
22480 33 50 75 74 56 61 72 69 6e 74 33 32 28 28 41 29 3PutVarint32((A)
22490 2c 28 42 29 29 29 0a 23 64 65 66 69 6e 65 20 67 ,(B))).#define g
224a0 65 74 56 61 72 69 6e 74 20 20 20 20 73 71 6c 69 etVarint sqli
224b0 74 65 33 47 65 74 56 61 72 69 6e 74 0a 23 64 65 te3GetVarint.#de
224c0 66 69 6e 65 20 70 75 74 56 61 72 69 6e 74 20 20 fine putVarint
224d0 20 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 sqlite3PutVari
224e0 6e 74 0a 0a 0a 63 6f 6e 73 74 20 63 68 61 72 20 nt...const char
224f0 2a 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 66 *sqlite3IndexAff
22500 69 6e 69 74 79 53 74 72 28 56 64 62 65 20 2a 2c inityStr(Vdbe *,
22510 20 49 6e 64 65 78 20 2a 29 3b 0a 76 6f 69 64 20 Index *);.void
22520 73 71 6c 69 74 65 33 54 61 62 6c 65 41 66 66 69 sqlite3TableAffi
22530 6e 69 74 79 53 74 72 28 56 64 62 65 20 2a 2c 20 nityStr(Vdbe *,
22540 54 61 62 6c 65 20 2a 29 3b 0a 63 68 61 72 20 73 Table *);.char s
22550 71 6c 69 74 65 33 43 6f 6d 70 61 72 65 41 66 66 qlite3CompareAff
22560 69 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 inity(Expr *pExp
22570 72 2c 20 63 68 61 72 20 61 66 66 32 29 3b 0a 69 r, char aff2);.i
22580 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 65 78 41 nt sqlite3IndexA
22590 66 66 69 6e 69 74 79 4f 6b 28 45 78 70 72 20 2a ffinityOk(Expr *
225a0 70 45 78 70 72 2c 20 63 68 61 72 20 69 64 78 5f pExpr, char idx_
225b0 61 66 66 69 6e 69 74 79 29 3b 0a 63 68 61 72 20 affinity);.char
225c0 73 71 6c 69 74 65 33 45 78 70 72 41 66 66 69 6e sqlite3ExprAffin
225d0 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 72 29 ity(Expr *pExpr)
225e0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 74 6f ;.int sqlite3Ato
225f0 69 36 34 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c i64(const char*,
22600 20 69 36 34 2a 2c 20 69 6e 74 2c 20 75 38 29 3b i64*, int, u8);
22610 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 72 72 .void sqlite3Err
22620 6f 72 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 or(sqlite3*, int
22630 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 2e 2e , const char*,..
22640 2e 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .);.void *sqlite
22650 33 48 65 78 54 6f 42 6c 6f 62 28 73 71 6c 69 74 3HexToBlob(sqlit
22660 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 e3*, const char
22670 2a 7a 2c 20 69 6e 74 20 6e 29 3b 0a 75 38 20 73 *z, int n);.u8 s
22680 71 6c 69 74 65 33 48 65 78 54 6f 49 6e 74 28 69 qlite3HexToInt(i
22690 6e 74 20 68 29 3b 0a 69 6e 74 20 73 71 6c 69 74 nt h);.int sqlit
226a0 65 33 54 77 6f 50 61 72 74 4e 61 6d 65 28 50 61 e3TwoPartName(Pa
226b0 72 73 65 20 2a 2c 20 54 6f 6b 65 6e 20 2a 2c 20 rse *, Token *,
226c0 54 6f 6b 65 6e 20 2a 2c 20 54 6f 6b 65 6e 20 2a Token *, Token *
226d0 2a 29 3b 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 *);..#if defined
226e0 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 0a 63 (SQLITE_TEST) .c
226f0 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
22700 65 33 45 72 72 4e 61 6d 65 28 69 6e 74 29 3b 0a e3ErrName(int);.
22710 23 65 6e 64 69 66 0a 0a 63 6f 6e 73 74 20 63 68 #endif..const ch
22720 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 74 ar *sqlite3ErrSt
22730 72 28 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 r(int);.int sqli
22740 74 65 33 52 65 61 64 53 63 68 65 6d 61 28 50 61 te3ReadSchema(Pa
22750 72 73 65 20 2a 70 50 61 72 73 65 29 3b 0a 43 6f rse *pParse);.Co
22760 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 46 69 llSeq *sqlite3Fi
22770 6e 64 43 6f 6c 6c 53 65 71 28 73 71 6c 69 74 65 ndCollSeq(sqlite
22780 33 2a 2c 75 38 20 65 6e 63 2c 20 63 6f 6e 73 74 3*,u8 enc, const
22790 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 43 6f 6c char*,int);.Col
227a0 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 4c 6f 63 lSeq *sqlite3Loc
227b0 61 74 65 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 ateCollSeq(Parse
227c0 20 2a 70 50 61 72 73 65 2c 20 63 6f 6e 73 74 20 *pParse, const
227d0 63 68 61 72 2a 7a 4e 61 6d 65 29 3b 0a 43 6f 6c char*zName);.Col
227e0 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 45 78 70 lSeq *sqlite3Exp
227f0 72 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a rCollSeq(Parse *
22800 70 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 45 pParse, Expr *pE
22810 78 70 72 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 xpr);.Expr *sqli
22820 74 65 33 45 78 70 72 41 64 64 43 6f 6c 6c 61 74 te3ExprAddCollat
22830 65 54 6f 6b 65 6e 28 50 61 72 73 65 20 2a 70 50 eToken(Parse *pP
22840 61 72 73 65 2c 20 45 78 70 72 2a 2c 20 54 6f 6b arse, Expr*, Tok
22850 65 6e 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 en*);.Expr *sqli
22860 74 65 33 45 78 70 72 41 64 64 43 6f 6c 6c 61 74 te3ExprAddCollat
22870 65 53 74 72 69 6e 67 28 50 61 72 73 65 2a 2c 45 eString(Parse*,E
22880 78 70 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a xpr*,const char*
22890 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 );.Expr *sqlite3
228a0 45 78 70 72 53 6b 69 70 43 6f 6c 6c 61 74 65 28 ExprSkipCollate(
228b0 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 Expr*);.int sqli
228c0 74 65 33 43 68 65 63 6b 43 6f 6c 6c 53 65 71 28 te3CheckCollSeq(
228d0 50 61 72 73 65 20 2a 2c 20 43 6f 6c 6c 53 65 71 Parse *, CollSeq
228e0 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 *);.int sqlite3
228f0 43 68 65 63 6b 4f 62 6a 65 63 74 4e 61 6d 65 28 CheckObjectName(
22900 50 61 72 73 65 20 2a 2c 20 63 6f 6e 73 74 20 63 Parse *, const c
22910 68 61 72 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c har *);.void sql
22920 69 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 ite3VdbeSetChang
22930 65 73 28 73 71 6c 69 74 65 33 20 2a 2c 20 69 6e es(sqlite3 *, in
22940 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 t);.int sqlite3A
22950 64 64 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 ddInt64(i64*,i64
22960 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 75 );.int sqlite3Su
22970 62 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 29 bInt64(i64*,i64)
22980 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 75 6c ;.int sqlite3Mul
22990 49 6e 74 36 34 28 69 36 34 2a 2c 69 36 34 29 3b Int64(i64*,i64);
229a0 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 62 73 49 .int sqlite3AbsI
229b0 6e 74 33 32 28 69 6e 74 29 3b 0a 23 69 66 64 65 nt32(int);.#ifde
229c0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
229d0 38 5f 33 5f 4e 41 4d 45 53 0a 76 6f 69 64 20 73 8_3_NAMES.void s
229e0 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 qlite3FileSuffix
229f0 33 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 3(const char*, c
22a00 68 61 72 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 har*);.#else.# d
22a10 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 69 6c efine sqlite3Fil
22a20 65 53 75 66 66 69 78 33 28 58 2c 59 29 0a 23 65 eSuffix3(X,Y).#e
22a30 6e 64 69 66 0a 75 38 20 73 71 6c 69 74 65 33 47 ndif.u8 sqlite3G
22a40 65 74 42 6f 6f 6c 65 61 6e 28 63 6f 6e 73 74 20 etBoolean(const
22a50 63 68 61 72 20 2a 7a 2c 69 6e 74 29 3b 0a 0a 63 char *z,int);..c
22a60 6f 6e 73 74 20 76 6f 69 64 20 2a 73 71 6c 69 74 onst void *sqlit
22a70 65 33 56 61 6c 75 65 54 65 78 74 28 73 71 6c 69 e3ValueText(sqli
22a80 74 65 33 5f 76 61 6c 75 65 2a 2c 20 75 38 29 3b te3_value*, u8);
22a90 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 61 6c 75 .int sqlite3Valu
22aa0 65 42 79 74 65 73 28 73 71 6c 69 74 65 33 5f 76 eBytes(sqlite3_v
22ab0 61 6c 75 65 2a 2c 20 75 38 29 3b 0a 76 6f 69 64 alue*, u8);.void
22ac0 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 sqlite3ValueSet
22ad0 53 74 72 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 Str(sqlite3_valu
22ae0 65 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 76 e*, int, const v
22af0 6f 69 64 20 2a 2c 75 38 2c 20 0a 20 20 20 20 20 oid *,u8, .
22b00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22b10 20 20 20 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a void(*)(void*
22b20 29 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 ));.void sqlite3
22b30 56 61 6c 75 65 53 65 74 4e 75 6c 6c 28 73 71 6c ValueSetNull(sql
22b40 69 74 65 33 5f 76 61 6c 75 65 2a 29 3b 0a 76 6f ite3_value*);.vo
22b50 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 id sqlite3ValueF
22b60 72 65 65 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 ree(sqlite3_valu
22b70 65 2a 29 3b 0a 73 71 6c 69 74 65 33 5f 76 61 6c e*);.sqlite3_val
22b80 75 65 20 2a 73 71 6c 69 74 65 33 56 61 6c 75 65 ue *sqlite3Value
22b90 4e 65 77 28 73 71 6c 69 74 65 33 20 2a 29 3b 0a New(sqlite3 *);.
22ba0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 55 74 66 char *sqlite3Utf
22bb0 31 36 74 6f 38 28 73 71 6c 69 74 65 33 20 2a 2c 16to8(sqlite3 *,
22bc0 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 69 6e const void*, in
22bd0 74 2c 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 t, u8);.int sqli
22be0 74 65 33 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 te3ValueFromExpr
22bf0 28 73 71 6c 69 74 65 33 20 2a 2c 20 45 78 70 72 (sqlite3 *, Expr
22c00 20 2a 2c 20 75 38 2c 20 75 38 2c 20 73 71 6c 69 *, u8, u8, sqli
22c10 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 3b 0a 76 te3_value **);.v
22c20 6f 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 oid sqlite3Value
22c30 41 70 70 6c 79 41 66 66 69 6e 69 74 79 28 73 71 ApplyAffinity(sq
22c40 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2c 20 75 lite3_value *, u
22c50 38 2c 20 75 38 29 3b 0a 23 69 66 6e 64 65 66 20 8, u8);.#ifndef
22c60 53 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 SQLITE_AMALGAMAT
22c70 49 4f 4e 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 ION.extern const
22c80 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 73 unsigned char s
22c90 71 6c 69 74 65 33 4f 70 63 6f 64 65 50 72 6f 70 qlite3OpcodeProp
22ca0 65 72 74 79 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 erty[];.extern c
22cb0 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
22cc0 61 72 20 73 71 6c 69 74 65 33 55 70 70 65 72 54 ar sqlite3UpperT
22cd0 6f 4c 6f 77 65 72 5b 5d 3b 0a 65 78 74 65 72 6e oLower[];.extern
22ce0 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 const unsigned
22cf0 63 68 61 72 20 73 71 6c 69 74 65 33 43 74 79 70 char sqlite3Ctyp
22d00 65 4d 61 70 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 eMap[];.extern c
22d10 6f 6e 73 74 20 54 6f 6b 65 6e 20 73 71 6c 69 74 onst Token sqlit
22d20 65 33 49 6e 74 54 6f 6b 65 6e 73 5b 5d 3b 0a 65 e3IntTokens[];.e
22d30 78 74 65 72 6e 20 53 51 4c 49 54 45 5f 57 53 44 xtern SQLITE_WSD
22d40 20 73 74 72 75 63 74 20 53 71 6c 69 74 65 33 43 struct Sqlite3C
22d50 6f 6e 66 69 67 20 73 71 6c 69 74 65 33 43 6f 6e onfig sqlite3Con
22d60 66 69 67 3b 0a 65 78 74 65 72 6e 20 53 51 4c 49 fig;.extern SQLI
22d70 54 45 5f 57 53 44 20 46 75 6e 63 44 65 66 48 61 TE_WSD FuncDefHa
22d80 73 68 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c sh sqlite3Global
22d90 46 75 6e 63 74 69 6f 6e 73 3b 0a 23 69 66 6e 64 Functions;.#ifnd
22da0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
22db0 53 44 0a 65 78 74 65 72 6e 20 69 6e 74 20 73 71 SD.extern int sq
22dc0 6c 69 74 65 33 50 65 6e 64 69 6e 67 42 79 74 65 lite3PendingByte
22dd0 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a ;.#endif.#endif.
22de0 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f 6f 74 void sqlite3Root
22df0 50 61 67 65 4d 6f 76 65 64 28 73 71 6c 69 74 65 PageMoved(sqlite
22e00 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 3*, int, int, in
22e10 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
22e20 52 65 69 6e 64 65 78 28 50 61 72 73 65 2a 2c 20 Reindex(Parse*,
22e30 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b Token*, Token*);
22e40 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 6c 74 .void sqlite3Alt
22e50 65 72 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 erFunctions(void
22e60 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
22e70 6c 74 65 72 52 65 6e 61 6d 65 54 61 62 6c 65 28 lterRenameTable(
22e80 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
22e90 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 , Token*);.int s
22ea0 71 6c 69 74 65 33 47 65 74 54 6f 6b 65 6e 28 63 qlite3GetToken(c
22eb0 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
22ec0 61 72 20 2a 2c 20 69 6e 74 20 2a 29 3b 0a 76 6f ar *, int *);.vo
22ed0 69 64 20 73 71 6c 69 74 65 33 4e 65 73 74 65 64 id sqlite3Nested
22ee0 50 61 72 73 65 28 50 61 72 73 65 2a 2c 20 63 6f Parse(Parse*, co
22ef0 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b nst char*, ...);
22f00 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
22f10 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74 65 irePreparedState
22f20 6d 65 6e 74 73 28 73 71 6c 69 74 65 33 2a 29 3b ments(sqlite3*);
22f30 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 64 65 .int sqlite3Code
22f40 53 75 62 73 65 6c 65 63 74 28 50 61 72 73 65 20 Subselect(Parse
22f50 2a 2c 20 45 78 70 72 20 2a 2c 20 69 6e 74 2c 20 *, Expr *, int,
22f60 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
22f70 65 33 53 65 6c 65 63 74 50 72 65 70 28 50 61 72 e3SelectPrep(Par
22f80 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 4e 61 se*, Select*, Na
22f90 6d 65 43 6f 6e 74 65 78 74 2a 29 3b 0a 69 6e 74 meContext*);.int
22fa0 20 73 71 6c 69 74 65 33 4d 61 74 63 68 53 70 61 sqlite3MatchSpa
22fb0 6e 4e 61 6d 65 28 63 6f 6e 73 74 20 63 68 61 72 nName(const char
22fc0 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 *, const char*,
22fd0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
22fe0 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 st char*);.int s
22ff0 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 45 78 70 qlite3ResolveExp
23000 72 4e 61 6d 65 73 28 4e 61 6d 65 43 6f 6e 74 65 rNames(NameConte
23010 78 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 xt*, Expr*);.voi
23020 64 20 73 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 d sqlite3Resolve
23030 53 65 6c 65 63 74 4e 61 6d 65 73 28 50 61 72 73 SelectNames(Pars
23040 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 4e 61 6d e*, Select*, Nam
23050 65 43 6f 6e 74 65 78 74 2a 29 3b 0a 76 6f 69 64 eContext*);.void
23060 20 73 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 53 sqlite3ResolveS
23070 65 6c 66 52 65 66 65 72 65 6e 63 65 28 50 61 72 elfReference(Par
23080 73 65 2a 2c 54 61 62 6c 65 2a 2c 69 6e 74 2c 45 se*,Table*,int,E
23090 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a 29 3b xpr*,ExprList*);
230a0 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 73 6f .int sqlite3Reso
230b0 6c 76 65 4f 72 64 65 72 47 72 6f 75 70 42 79 28 lveOrderGroupBy(
230c0 50 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c Parse*, Select*,
230d0 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f 6e 73 ExprList*, cons
230e0 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 t char*);.void s
230f0 71 6c 69 74 65 33 43 6f 6c 75 6d 6e 44 65 66 61 qlite3ColumnDefa
23100 75 6c 74 28 56 64 62 65 20 2a 2c 20 54 61 62 6c ult(Vdbe *, Tabl
23110 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a e *, int, int);.
23120 76 6f 69 64 20 73 71 6c 69 74 65 33 41 6c 74 65 void sqlite3Alte
23130 72 46 69 6e 69 73 68 41 64 64 43 6f 6c 75 6d 6e rFinishAddColumn
23140 28 50 61 72 73 65 20 2a 2c 20 54 6f 6b 65 6e 20 (Parse *, Token
23150 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
23160 41 6c 74 65 72 42 65 67 69 6e 41 64 64 43 6f 6c AlterBeginAddCol
23170 75 6d 6e 28 50 61 72 73 65 20 2a 2c 20 53 72 63 umn(Parse *, Src
23180 4c 69 73 74 20 2a 29 3b 0a 43 6f 6c 6c 53 65 71 List *);.CollSeq
23190 20 2a 73 71 6c 69 74 65 33 47 65 74 43 6f 6c 6c *sqlite3GetColl
231a0 53 65 71 28 50 61 72 73 65 2a 2c 20 75 38 2c 20 Seq(Parse*, u8,
231b0 43 6f 6c 6c 53 65 71 20 2a 2c 20 63 6f 6e 73 74 CollSeq *, const
231c0 20 63 68 61 72 2a 29 3b 0a 63 68 61 72 20 73 71 char*);.char sq
231d0 6c 69 74 65 33 41 66 66 69 6e 69 74 79 54 79 70 lite3AffinityTyp
231e0 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 75 e(const char*, u
231f0 38 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 8*);.void sqlite
23200 33 41 6e 61 6c 79 7a 65 28 50 61 72 73 65 2a 2c 3Analyze(Parse*,
23210 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 Token*, Token*)
23220 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 76 ;.int sqlite3Inv
23230 6f 6b 65 42 75 73 79 48 61 6e 64 6c 65 72 28 42 okeBusyHandler(B
23240 75 73 79 48 61 6e 64 6c 65 72 2a 29 3b 0a 69 6e usyHandler*);.in
23250 74 20 73 71 6c 69 74 65 33 46 69 6e 64 44 62 28 t sqlite3FindDb(
23260 73 71 6c 69 74 65 33 2a 2c 20 54 6f 6b 65 6e 2a sqlite3*, Token*
23270 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 );.int sqlite3Fi
23280 6e 64 44 62 4e 61 6d 65 28 73 71 6c 69 74 65 33 ndDbName(sqlite3
23290 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a *, const char *
232a0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 6e );.int sqlite3An
232b0 61 6c 79 73 69 73 4c 6f 61 64 28 73 71 6c 69 74 alysisLoad(sqlit
232c0 65 33 2a 2c 69 6e 74 20 69 44 42 29 3b 0a 76 6f e3*,int iDB);.vo
232d0 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 id sqlite3Delete
232e0 49 6e 64 65 78 53 61 6d 70 6c 65 73 28 73 71 6c IndexSamples(sql
232f0 69 74 65 33 2a 2c 49 6e 64 65 78 2a 29 3b 0a 76 ite3*,Index*);.v
23300 6f 69 64 20 73 71 6c 69 74 65 33 44 65 66 61 75 oid sqlite3Defau
23310 6c 74 52 6f 77 45 73 74 28 49 6e 64 65 78 2a 29 ltRowEst(Index*)
23320 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 ;.void sqlite3Re
23330 67 69 73 74 65 72 4c 69 6b 65 46 75 6e 63 74 69 gisterLikeFuncti
23340 6f 6e 73 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e ons(sqlite3*, in
23350 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 t);.int sqlite3I
23360 73 4c 69 6b 65 46 75 6e 63 74 69 6f 6e 28 73 71 sLikeFunction(sq
23370 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 lite3*,Expr*,int
23380 2a 2c 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 *,char*);.void s
23390 71 6c 69 74 65 33 4d 69 6e 69 6d 75 6d 46 69 6c qlite3MinimumFil
233a0 65 46 6f 72 6d 61 74 28 50 61 72 73 65 2a 2c 20 eFormat(Parse*,
233b0 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
233c0 73 71 6c 69 74 65 33 53 63 68 65 6d 61 43 6c 65 sqlite3SchemaCle
233d0 61 72 28 76 6f 69 64 20 2a 29 3b 0a 53 63 68 65 ar(void *);.Sche
233e0 6d 61 20 2a 73 71 6c 69 74 65 33 53 63 68 65 6d ma *sqlite3Schem
233f0 61 47 65 74 28 73 71 6c 69 74 65 33 20 2a 2c 20 aGet(sqlite3 *,
23400 42 74 72 65 65 20 2a 29 3b 0a 69 6e 74 20 73 71 Btree *);.int sq
23410 6c 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 lite3SchemaToInd
23420 65 78 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 ex(sqlite3 *db,
23430 53 63 68 65 6d 61 20 2a 29 3b 0a 4b 65 79 49 6e Schema *);.KeyIn
23440 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 6e fo *sqlite3KeyIn
23450 66 6f 41 6c 6c 6f 63 28 73 71 6c 69 74 65 33 2a foAlloc(sqlite3*
23460 2c 69 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 ,int,int);.void
23470 73 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 55 6e sqlite3KeyInfoUn
23480 72 65 66 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b ref(KeyInfo*);.K
23490 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 4b eyInfo *sqlite3K
234a0 65 79 49 6e 66 6f 52 65 66 28 4b 65 79 49 6e 66 eyInfoRef(KeyInf
234b0 6f 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 o*);.KeyInfo *sq
234c0 6c 69 74 65 33 4b 65 79 49 6e 66 6f 4f 66 49 6e lite3KeyInfoOfIn
234d0 64 65 78 28 50 61 72 73 65 2a 2c 20 49 6e 64 65 dex(Parse*, Inde
234e0 78 2a 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 x*);.#ifdef SQLI
234f0 54 45 5f 44 45 42 55 47 0a 69 6e 74 20 73 71 6c TE_DEBUG.int sql
23500 69 74 65 33 4b 65 79 49 6e 66 6f 49 73 57 72 69 ite3KeyInfoIsWri
23510 74 65 61 62 6c 65 28 4b 65 79 49 6e 66 6f 2a 29 teable(KeyInfo*)
23520 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c ;.#endif.int sql
23530 69 74 65 33 43 72 65 61 74 65 46 75 6e 63 28 73 ite3CreateFunc(s
23540 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 20 qlite3 *, const
23550 63 68 61 72 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 char *, int, int
23560 2c 20 76 6f 69 64 20 2a 2c 20 0a 20 20 76 6f 69 , void *, . voi
23570 64 20 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f d (*)(sqlite3_co
23580 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 ntext*,int,sqlit
23590 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c 0a 20 20 e3_value **),.
235a0 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 74 65 33 void (*)(sqlite3
235b0 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 _context*,int,sq
235c0 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 29 2c lite3_value **),
235d0 20 76 6f 69 64 20 28 2a 29 28 73 71 6c 69 74 65 void (*)(sqlite
235e0 33 5f 63 6f 6e 74 65 78 74 2a 29 2c 0a 20 20 46 3_context*),. F
235f0 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 uncDestructor *p
23600 44 65 73 74 72 75 63 74 6f 72 0a 29 3b 0a 69 6e Destructor.);.in
23610 74 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 t sqlite3ApiExit
23620 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e (sqlite3 *db, in
23630 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f t);.int sqlite3O
23640 70 65 6e 54 65 6d 70 44 61 74 61 62 61 73 65 28 penTempDatabase(
23650 50 61 72 73 65 20 2a 29 3b 0a 0a 76 6f 69 64 20 Parse *);..void
23660 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d 49 sqlite3StrAccumI
23670 6e 69 74 28 53 74 72 41 63 63 75 6d 2a 2c 20 63 nit(StrAccum*, c
23680 68 61 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b har*, int, int);
23690 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 72 .void sqlite3Str
236a0 41 63 63 75 6d 41 70 70 65 6e 64 28 53 74 72 41 AccumAppend(StrA
236b0 63 63 75 6d 2a 2c 63 6f 6e 73 74 20 63 68 61 72 ccum*,const char
236c0 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c *,int);.void sql
236d0 69 74 65 33 53 74 72 41 63 63 75 6d 41 70 70 65 ite3StrAccumAppe
236e0 6e 64 41 6c 6c 28 53 74 72 41 63 63 75 6d 2a 2c ndAll(StrAccum*,
236f0 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f const char*);.vo
23700 69 64 20 73 71 6c 69 74 65 33 41 70 70 65 6e 64 id sqlite3Append
23710 53 70 61 63 65 28 53 74 72 41 63 63 75 6d 2a 2c Space(StrAccum*,
23720 69 6e 74 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 int);.char *sqli
23730 74 65 33 53 74 72 41 63 63 75 6d 46 69 6e 69 73 te3StrAccumFinis
23740 68 28 53 74 72 41 63 63 75 6d 2a 29 3b 0a 76 6f h(StrAccum*);.vo
23750 69 64 20 73 71 6c 69 74 65 33 53 74 72 41 63 63 id sqlite3StrAcc
23760 75 6d 52 65 73 65 74 28 53 74 72 41 63 63 75 6d umReset(StrAccum
23770 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
23780 53 65 6c 65 63 74 44 65 73 74 49 6e 69 74 28 53 SelectDestInit(S
23790 65 6c 65 63 74 44 65 73 74 2a 2c 69 6e 74 2c 69 electDest*,int,i
237a0 6e 74 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 nt);.Expr *sqlit
237b0 65 33 43 72 65 61 74 65 43 6f 6c 75 6d 6e 45 78 e3CreateColumnEx
237c0 70 72 28 73 71 6c 69 74 65 33 20 2a 2c 20 53 72 pr(sqlite3 *, Sr
237d0 63 4c 69 73 74 20 2a 2c 20 69 6e 74 2c 20 69 6e cList *, int, in
237e0 74 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 t);..void sqlite
237f0 33 42 61 63 6b 75 70 52 65 73 74 61 72 74 28 73 3BackupRestart(s
23800 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 20 2a 29 qlite3_backup *)
23810 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 61 ;.void sqlite3Ba
23820 63 6b 75 70 55 70 64 61 74 65 28 73 71 6c 69 74 ckupUpdate(sqlit
23830 65 33 5f 62 61 63 6b 75 70 20 2a 2c 20 50 67 6e e3_backup *, Pgn
23840 6f 2c 20 63 6f 6e 73 74 20 75 38 20 2a 29 3b 0a o, const u8 *);.
23850 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
23860 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 NABLE_STAT3_OR_S
23870 54 41 54 34 0a 76 6f 69 64 20 73 71 6c 69 74 65 TAT4.void sqlite
23880 33 41 6e 61 6c 79 7a 65 46 75 6e 63 74 69 6f 6e 3AnalyzeFunction
23890 73 28 76 6f 69 64 29 3b 0a 69 6e 74 20 73 71 6c s(void);.int sql
238a0 69 74 65 33 53 74 61 74 34 50 72 6f 62 65 53 65 ite3Stat4ProbeSe
238b0 74 56 61 6c 75 65 28 50 61 72 73 65 2a 2c 49 6e tValue(Parse*,In
238c0 64 65 78 2a 2c 55 6e 70 61 63 6b 65 64 52 65 63 dex*,UnpackedRec
238d0 6f 72 64 2a 2a 2c 45 78 70 72 2a 2c 75 38 2c 69 ord**,Expr*,u8,i
238e0 6e 74 2c 69 6e 74 2a 29 3b 0a 76 6f 69 64 20 73 nt,int*);.void s
238f0 71 6c 69 74 65 33 53 74 61 74 34 50 72 6f 62 65 qlite3Stat4Probe
23900 46 72 65 65 28 55 6e 70 61 63 6b 65 64 52 65 63 Free(UnpackedRec
23910 6f 72 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f ord*);.#endif../
23920 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72 66 61 *.** The interfa
23930 63 65 20 74 6f 20 74 68 65 20 4c 45 4d 4f 4e 2d ce to the LEMON-
23940 67 65 6e 65 72 61 74 65 64 20 70 61 72 73 65 72 generated parser
23950 0a 2a 2f 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 .*/.void *sqlite
23960 33 50 61 72 73 65 72 41 6c 6c 6f 63 28 76 6f 69 3ParserAlloc(voi
23970 64 2a 28 2a 29 28 73 69 7a 65 5f 74 29 29 3b 0a d*(*)(size_t));.
23980 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 72 73 void sqlite3Pars
23990 65 72 46 72 65 65 28 76 6f 69 64 2a 2c 20 76 6f erFree(void*, vo
239a0 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b 0a 76 id(*)(void*));.v
239b0 6f 69 64 20 73 71 6c 69 74 65 33 50 61 72 73 65 oid sqlite3Parse
239c0 72 28 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 54 6f r(void*, int, To
239d0 6b 65 6e 2c 20 50 61 72 73 65 2a 29 3b 0a 23 69 ken, Parse*);.#i
239e0 66 64 65 66 20 59 59 54 52 41 43 4b 4d 41 58 53 fdef YYTRACKMAXS
239f0 54 41 43 4b 44 45 50 54 48 0a 20 20 69 6e 74 20 TACKDEPTH. int
23a00 73 71 6c 69 74 65 33 50 61 72 73 65 72 53 74 61 sqlite3ParserSta
23a10 63 6b 50 65 61 6b 28 76 6f 69 64 2a 29 3b 0a 23 ckPeak(void*);.#
23a20 65 6e 64 69 66 0a 0a 76 6f 69 64 20 73 71 6c 69 endif..void sqli
23a30 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 74 65 6e te3AutoLoadExten
23a40 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b sions(sqlite3*);
23a50 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
23a60 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 45 4e 53 OMIT_LOAD_EXTENS
23a70 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 ION. void sqlit
23a80 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 6f 6e e3CloseExtension
23a90 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 6c s(sqlite3*);.#el
23aa0 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 se.# define sqli
23ab0 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 69 6f te3CloseExtensio
23ac0 6e 73 28 58 29 0a 23 65 6e 64 69 66 0a 0a 23 69 ns(X).#endif..#i
23ad0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
23ae0 54 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 T_SHARED_CACHE.
23af0 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 61 62 void sqlite3Tab
23b00 6c 65 4c 6f 63 6b 28 50 61 72 73 65 20 2a 2c 20 leLock(Parse *,
23b10 69 6e 74 2c 20 69 6e 74 2c 20 75 38 2c 20 63 6f int, int, u8, co
23b20 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 23 65 6c nst char *);.#el
23b30 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c se. #define sql
23b40 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 76 2c ite3TableLock(v,
23b50 77 2c 78 2c 79 2c 7a 29 0a 23 65 6e 64 69 66 0a w,x,y,z).#endif.
23b60 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 .#ifdef SQLITE_T
23b70 45 53 54 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 EST. int sqlite
23b80 33 55 74 66 38 54 6f 38 28 75 6e 73 69 67 6e 65 3Utf8To8(unsigne
23b90 64 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 d char*);.#endif
23ba0 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
23bb0 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c OMIT_VIRTUALTABL
23bc0 45 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 E.# define sqli
23bd0 74 65 33 56 74 61 62 43 6c 65 61 72 28 59 29 0a te3VtabClear(Y).
23be0 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 # define sqlite
23bf0 33 56 74 61 62 53 79 6e 63 28 58 2c 59 29 20 53 3VtabSync(X,Y) S
23c00 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 64 65 66 69 QLITE_OK.# defi
23c10 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 52 6f ne sqlite3VtabRo
23c20 6c 6c 62 61 63 6b 28 58 29 0a 23 20 20 64 65 66 llback(X).# def
23c30 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 43 ine sqlite3VtabC
23c40 6f 6d 6d 69 74 28 58 29 0a 23 20 20 64 65 66 69 ommit(X).# defi
23c50 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 49 6e ne sqlite3VtabIn
23c60 53 79 6e 63 28 64 62 29 20 30 0a 23 20 20 64 65 Sync(db) 0.# de
23c70 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
23c80 4c 6f 63 6b 28 58 29 20 0a 23 20 20 64 65 66 69 Lock(X) .# defi
23c90 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e ne sqlite3VtabUn
23ca0 6c 6f 63 6b 28 58 29 0a 23 20 20 64 65 66 69 6e lock(X).# defin
23cb0 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c e sqlite3VtabUnl
23cc0 6f 63 6b 4c 69 73 74 28 58 29 0a 23 20 20 64 65 ockList(X).# de
23cd0 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
23ce0 53 61 76 65 70 6f 69 6e 74 28 58 2c 20 59 2c 20 Savepoint(X, Y,
23cf0 5a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 Z) SQLITE_OK.#
23d00 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 65 define sqlite3Ge
23d10 74 56 54 61 62 6c 65 28 58 2c 59 29 20 20 28 28 tVTable(X,Y) ((
23d20 56 54 61 62 6c 65 2a 29 30 29 0a 23 65 6c 73 65 VTable*)0).#else
23d30 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 . void sqlite3
23d40 56 74 61 62 43 6c 65 61 72 28 73 71 6c 69 74 65 VtabClear(sqlite
23d50 33 20 2a 64 62 2c 20 54 61 62 6c 65 2a 29 3b 0a 3 *db, Table*);.
23d60 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 void sqlite3V
23d70 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 73 71 tabDisconnect(sq
23d80 6c 69 74 65 33 20 2a 64 62 2c 20 54 61 62 6c 65 lite3 *db, Table
23d90 20 2a 70 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c *p);. int sql
23da0 69 74 65 33 56 74 61 62 53 79 6e 63 28 73 71 6c ite3VtabSync(sql
23db0 69 74 65 33 20 2a 64 62 2c 20 56 64 62 65 2a 29 ite3 *db, Vdbe*)
23dc0 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 33 ;. int sqlite3
23dd0 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 73 71 6c VtabRollback(sql
23de0 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 20 69 6e ite3 *db);. in
23df0 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 6f 6d t sqlite3VtabCom
23e00 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 mit(sqlite3 *db)
23e10 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ;. void sqlite
23e20 33 56 74 61 62 4c 6f 63 6b 28 56 54 61 62 6c 65 3VtabLock(VTable
23e30 20 2a 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c *);. void sql
23e40 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 56 ite3VtabUnlock(V
23e50 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 76 6f 69 Table *);. voi
23e60 64 20 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c d sqlite3VtabUnl
23e70 6f 63 6b 4c 69 73 74 28 73 71 6c 69 74 65 33 2a ockList(sqlite3*
23e80 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 );. int sqlite
23e90 33 56 74 61 62 53 61 76 65 70 6f 69 6e 74 28 73 3VtabSavepoint(s
23ea0 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 2c 20 69 qlite3 *, int, i
23eb0 6e 74 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c nt);. void sql
23ec0 69 74 65 33 56 74 61 62 49 6d 70 6f 72 74 45 72 ite3VtabImportEr
23ed0 72 6d 73 67 28 56 64 62 65 2a 2c 20 73 71 6c 69 rmsg(Vdbe*, sqli
23ee0 74 65 33 5f 76 74 61 62 2a 29 3b 0a 20 20 20 56 te3_vtab*);. V
23ef0 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 47 65 Table *sqlite3Ge
23f00 74 56 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a tVTable(sqlite3*
23f10 2c 20 54 61 62 6c 65 2a 29 3b 0a 23 20 20 64 65 , Table*);.# de
23f20 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
23f30 49 6e 53 79 6e 63 28 64 62 29 20 28 28 64 62 29 InSync(db) ((db)
23f40 2d 3e 6e 56 54 72 61 6e 73 3e 30 20 26 26 20 28 ->nVTrans>0 && (
23f50 64 62 29 2d 3e 61 56 54 72 61 6e 73 3d 3d 30 29 db)->aVTrans==0)
23f60 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c .#endif.void sql
23f70 69 74 65 33 56 74 61 62 4d 61 6b 65 57 72 69 74 ite3VtabMakeWrit
23f80 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 61 62 6c able(Parse*,Tabl
23f90 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
23fa0 33 56 74 61 62 42 65 67 69 6e 50 61 72 73 65 28 3VtabBeginParse(
23fb0 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 Parse*, Token*,
23fc0 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 Token*, Token*,
23fd0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
23fe0 65 33 56 74 61 62 46 69 6e 69 73 68 50 61 72 73 e3VtabFinishPars
23ff0 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a e(Parse*, Token*
24000 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 );.void sqlite3V
24010 74 61 62 41 72 67 49 6e 69 74 28 50 61 72 73 65 tabArgInit(Parse
24020 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
24030 56 74 61 62 41 72 67 45 78 74 65 6e 64 28 50 61 VtabArgExtend(Pa
24040 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 rse*, Token*);.i
24050 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 61 nt sqlite3VtabCa
24060 6c 6c 43 72 65 61 74 65 28 73 71 6c 69 74 65 33 llCreate(sqlite3
24070 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 *, int, const ch
24080 61 72 20 2a 2c 20 63 68 61 72 20 2a 2a 29 3b 0a ar *, char **);.
24090 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 int sqlite3VtabC
240a0 61 6c 6c 43 6f 6e 6e 65 63 74 28 50 61 72 73 65 allConnect(Parse
240b0 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 69 6e 74 20 *, Table*);.int
240c0 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 44 sqlite3VtabCallD
240d0 65 73 74 72 6f 79 28 73 71 6c 69 74 65 33 2a 2c estroy(sqlite3*,
240e0 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 int, const char
240f0 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 *);.int sqlite3
24100 56 74 61 62 42 65 67 69 6e 28 73 71 6c 69 74 65 VtabBegin(sqlite
24110 33 20 2a 2c 20 56 54 61 62 6c 65 20 2a 29 3b 0a 3 *, VTable *);.
24120 46 75 6e 63 44 65 66 20 2a 73 71 6c 69 74 65 33 FuncDef *sqlite3
24130 56 74 61 62 4f 76 65 72 6c 6f 61 64 46 75 6e 63 VtabOverloadFunc
24140 74 69 6f 6e 28 73 71 6c 69 74 65 33 20 2a 2c 46 tion(sqlite3 *,F
24150 75 6e 63 44 65 66 2a 2c 20 69 6e 74 20 6e 41 72 uncDef*, int nAr
24160 67 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 g, Expr*);.void
24170 73 71 6c 69 74 65 33 49 6e 76 61 6c 69 64 46 75 sqlite3InvalidFu
24180 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 5f 63 nction(sqlite3_c
24190 6f 6e 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 ontext*,int,sqli
241a0 74 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 73 71 te3_value**);.sq
241b0 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 71 6c 69 lite3_int64 sqli
241c0 74 65 33 53 74 6d 74 43 75 72 72 65 6e 74 54 69 te3StmtCurrentTi
241d0 6d 65 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 me(sqlite3_conte
241e0 78 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 xt*);.int sqlite
241f0 33 56 64 62 65 50 61 72 61 6d 65 74 65 72 49 6e 3VdbeParameterIn
24200 64 65 78 28 56 64 62 65 2a 2c 20 63 6f 6e 73 74 dex(Vdbe*, const
24210 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e char*, int);.in
24220 74 20 73 71 6c 69 74 65 33 54 72 61 6e 73 66 65 t sqlite3Transfe
24230 72 42 69 6e 64 69 6e 67 73 28 73 71 6c 69 74 65 rBindings(sqlite
24240 33 5f 73 74 6d 74 20 2a 2c 20 73 71 6c 69 74 65 3_stmt *, sqlite
24250 33 5f 73 74 6d 74 20 2a 29 3b 0a 76 6f 69 64 20 3_stmt *);.void
24260 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65 73 sqlite3ParserRes
24270 65 74 28 50 61 72 73 65 2a 29 3b 0a 69 6e 74 20 et(Parse*);.int
24280 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 sqlite3Reprepare
24290 28 56 64 62 65 2a 29 3b 0a 76 6f 69 64 20 73 71 (Vdbe*);.void sq
242a0 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 68 65 lite3ExprListChe
242b0 63 6b 4c 65 6e 67 74 68 28 50 61 72 73 65 2a 2c ckLength(Parse*,
242c0 20 45 78 70 72 4c 69 73 74 2a 2c 20 63 6f 6e 73 ExprList*, cons
242d0 74 20 63 68 61 72 2a 29 3b 0a 43 6f 6c 6c 53 65 t char*);.CollSe
242e0 71 20 2a 73 71 6c 69 74 65 33 42 69 6e 61 72 79 q *sqlite3Binary
242f0 43 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 28 50 CompareCollSeq(P
24300 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c 20 arse *, Expr *,
24310 45 78 70 72 20 2a 29 3b 0a 69 6e 74 20 73 71 6c Expr *);.int sql
24320 69 74 65 33 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 ite3TempInMemory
24330 28 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 2a 29 (const sqlite3*)
24340 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 ;.const char *sq
24350 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4d 6f 64 65 lite3JournalMode
24360 6e 61 6d 65 28 69 6e 74 29 3b 0a 23 69 66 6e 64 name(int);.#ifnd
24370 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
24380 41 4c 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 AL. int sqlite3
24390 43 68 65 63 6b 70 6f 69 6e 74 28 73 71 6c 69 74 Checkpoint(sqlit
243a0 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 e3*, int, int, i
243b0 6e 74 2a 2c 20 69 6e 74 2a 29 3b 0a 20 20 69 6e nt*, int*);. in
243c0 74 20 73 71 6c 69 74 65 33 57 61 6c 44 65 66 61 t sqlite3WalDefa
243d0 75 6c 74 48 6f 6f 6b 28 76 6f 69 64 2a 2c 73 71 ultHook(void*,sq
243e0 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
243f0 72 2a 2c 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a r*,int);.#endif.
24400 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
24410 4d 49 54 5f 43 54 45 0a 20 20 57 69 74 68 20 2a MIT_CTE. With *
24420 73 71 6c 69 74 65 33 57 69 74 68 41 64 64 28 50 sqlite3WithAdd(P
24430 61 72 73 65 2a 2c 57 69 74 68 2a 2c 54 6f 6b 65 arse*,With*,Toke
24440 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 65 6c n*,ExprList*,Sel
24450 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 ect*);. void sq
24460 6c 69 74 65 33 57 69 74 68 44 65 6c 65 74 65 28 lite3WithDelete(
24470 73 71 6c 69 74 65 33 2a 2c 57 69 74 68 2a 29 3b sqlite3*,With*);
24480 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 57 . void sqlite3W
24490 69 74 68 50 75 73 68 28 50 61 72 73 65 2a 2c 20 ithPush(Parse*,
244a0 57 69 74 68 2a 2c 20 75 38 29 3b 0a 23 65 6c 73 With*, u8);.#els
244b0 65 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 e.#define sqlite
244c0 33 57 69 74 68 50 75 73 68 28 78 2c 79 2c 7a 29 3WithPush(x,y,z)
244d0 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 .#define sqlite3
244e0 57 69 74 68 44 65 6c 65 74 65 28 78 2c 79 29 0a WithDelete(x,y).
244f0 23 65 6e 64 69 66 0a 0a 2f 2a 20 44 65 63 6c 61 #endif../* Decla
24500 72 61 74 69 6f 6e 73 20 66 6f 72 20 66 75 6e 63 rations for func
24510 74 69 6f 6e 73 20 69 6e 20 66 6b 65 79 2e 63 2e tions in fkey.c.
24520 20 41 6c 6c 20 6f 66 20 74 68 65 73 65 20 61 72 All of these ar
24530 65 20 72 65 70 6c 61 63 65 64 20 62 79 0a 2a 2a e replaced by.**
24540 20 6e 6f 2d 6f 70 20 6d 61 63 72 6f 73 20 69 66 no-op macros if
24550 20 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 OMIT_FOREIGN_KE
24560 59 20 69 73 20 64 65 66 69 6e 65 64 2e 20 49 6e Y is defined. In
24570 20 74 68 69 73 20 63 61 73 65 20 6e 6f 20 66 6f this case no fo
24580 72 65 69 67 6e 0a 2a 2a 20 6b 65 79 20 66 75 6e reign.** key fun
24590 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 20 61 76 ctionality is av
245a0 61 69 6c 61 62 6c 65 2e 20 49 66 20 4f 4d 49 54 ailable. If OMIT
245b0 5f 54 52 49 47 47 45 52 20 69 73 20 64 65 66 69 _TRIGGER is defi
245c0 6e 65 64 20 62 75 74 0a 2a 2a 20 4f 4d 49 54 5f ned but.** OMIT_
245d0 46 4f 52 45 49 47 4e 5f 4b 45 59 20 69 73 20 6e FOREIGN_KEY is n
245e0 6f 74 2c 20 6f 6e 6c 79 20 73 6f 6d 65 20 6f 66 ot, only some of
245f0 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 the functions a
24600 72 65 20 6e 6f 2d 6f 70 65 64 2e 20 49 6e 0a 2a re no-oped. In.*
24610 2a 20 74 68 69 73 20 63 61 73 65 20 66 6f 72 65 * this case fore
24620 69 67 6e 20 6b 65 79 73 20 61 72 65 20 70 61 72 ign keys are par
24630 73 65 64 2c 20 62 75 74 20 6e 6f 20 6f 74 68 65 sed, but no othe
24640 72 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 r functionality
24650 69 73 20 0a 2a 2a 20 70 72 6f 76 69 64 65 64 20 is .** provided
24660 28 65 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66 20 (enforcement of
24670 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 72 FK constraints r
24680 65 71 75 69 72 65 73 20 74 68 65 20 74 72 69 67 equires the trig
24690 67 65 72 73 20 73 75 62 2d 73 79 73 74 65 6d 29 gers sub-system)
246a0 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 ..*/.#if !define
246b0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f d(SQLITE_OMIT_FO
246c0 52 45 49 47 4e 5f 4b 45 59 29 20 26 26 20 21 64 REIGN_KEY) && !d
246d0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
246e0 49 54 5f 54 52 49 47 47 45 52 29 0a 20 20 76 6f IT_TRIGGER). vo
246f0 69 64 20 73 71 6c 69 74 65 33 46 6b 43 68 65 63 id sqlite3FkChec
24700 6b 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a k(Parse*, Table*
24710 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a , int, int, int*
24720 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 , int);. void s
24730 71 6c 69 74 65 33 46 6b 44 72 6f 70 54 61 62 6c qlite3FkDropTabl
24740 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 e(Parse*, SrcLis
24750 74 20 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 t *, Table*);.
24760 76 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 41 63 void sqlite3FkAc
24770 74 69 6f 6e 73 28 50 61 72 73 65 2a 2c 20 54 61 tions(Parse*, Ta
24780 62 6c 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c ble*, ExprList*,
24790 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 int, int*, int)
247a0 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 46 ;. int sqlite3F
247b0 6b 52 65 71 75 69 72 65 64 28 50 61 72 73 65 2a kRequired(Parse*
247c0 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2a 2c 20 , Table*, int*,
247d0 69 6e 74 29 3b 0a 20 20 75 33 32 20 73 71 6c 69 int);. u32 sqli
247e0 74 65 33 46 6b 4f 6c 64 6d 61 73 6b 28 50 61 72 te3FkOldmask(Par
247f0 73 65 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 se*, Table*);.
24800 46 4b 65 79 20 2a 73 71 6c 69 74 65 33 46 6b 52 FKey *sqlite3FkR
24810 65 66 65 72 65 6e 63 65 73 28 54 61 62 6c 65 20 eferences(Table
24820 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 *);.#else. #def
24830 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 41 63 74 ine sqlite3FkAct
24840 69 6f 6e 73 28 61 2c 62 2c 63 2c 64 2c 65 2c 66 ions(a,b,c,d,e,f
24850 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 ). #define sqli
24860 74 65 33 46 6b 43 68 65 63 6b 28 61 2c 62 2c 63 te3FkCheck(a,b,c
24870 2c 64 2c 65 2c 66 29 0a 20 20 23 64 65 66 69 6e ,d,e,f). #defin
24880 65 20 73 71 6c 69 74 65 33 46 6b 44 72 6f 70 54 e sqlite3FkDropT
24890 61 62 6c 65 28 61 2c 62 2c 63 29 0a 20 20 23 64 able(a,b,c). #d
248a0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 4f efine sqlite3FkO
248b0 6c 64 6d 61 73 6b 28 61 2c 62 29 20 20 20 20 20 ldmask(a,b)
248c0 20 20 20 20 30 0a 20 20 23 64 65 66 69 6e 65 20 0. #define
248d0 73 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72 65 sqlite3FkRequire
248e0 64 28 61 2c 62 2c 63 2c 64 29 20 20 20 20 30 0a d(a,b,c,d) 0.
248f0 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 #endif.#ifndef S
24900 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 QLITE_OMIT_FOREI
24910 47 4e 5f 4b 45 59 0a 20 20 76 6f 69 64 20 73 71 GN_KEY. void sq
24920 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 28 73 71 lite3FkDelete(sq
24930 6c 69 74 65 33 20 2a 2c 20 54 61 62 6c 65 2a 29 lite3 *, Table*)
24940 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 46 ;. int sqlite3F
24950 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 50 61 72 kLocateIndex(Par
24960 73 65 2a 2c 54 61 62 6c 65 2a 2c 46 4b 65 79 2a se*,Table*,FKey*
24970 2c 49 6e 64 65 78 2a 2a 2c 69 6e 74 2a 2a 29 3b ,Index**,int**);
24980 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
24990 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 sqlite3FkDelete
249a0 28 61 2c 62 29 0a 20 20 23 64 65 66 69 6e 65 20 (a,b). #define
249b0 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 sqlite3FkLocateI
249c0 6e 64 65 78 28 61 2c 62 2c 63 2c 64 2c 65 29 0a ndex(a,b,c,d,e).
249d0 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 41 #endif.../*.** A
249e0 76 61 69 6c 61 62 6c 65 20 66 61 75 6c 74 20 69 vailable fault i
249f0 6e 6a 65 63 74 6f 72 73 2e 20 20 53 68 6f 75 6c njectors. Shoul
24a00 64 20 62 65 20 6e 75 6d 62 65 72 65 64 20 62 65 d be numbered be
24a10 67 69 6e 6e 69 6e 67 20 77 69 74 68 20 30 2e 0a ginning with 0..
24a20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
24a30 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 4f 52 5f E_FAULTINJECTOR_
24a40 4d 41 4c 4c 4f 43 20 20 20 20 20 30 0a 23 64 65 MALLOC 0.#de
24a50 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 41 55 4c fine SQLITE_FAUL
24a60 54 49 4e 4a 45 43 54 4f 52 5f 43 4f 55 4e 54 20 TINJECTOR_COUNT
24a70 20 20 20 20 20 31 0a 0a 2f 2a 0a 2a 2a 20 54 68 1../*.** Th
24a80 65 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 74 e interface to t
24a90 68 65 20 63 6f 64 65 20 69 6e 20 66 61 75 6c 74 he code in fault
24aa0 2e 63 20 75 73 65 64 20 66 6f 72 20 69 64 65 6e .c used for iden
24ab0 74 69 66 79 69 6e 67 20 22 62 65 6e 69 67 6e 22 tifying "benign"
24ac0 0a 2a 2a 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 .** malloc failu
24ad0 72 65 73 2e 20 54 68 69 73 20 69 73 20 6f 6e 6c res. This is onl
24ae0 79 20 70 72 65 73 65 6e 74 20 69 66 20 53 51 4c y present if SQL
24af0 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e ITE_OMIT_BUILTIN
24b00 5f 54 45 53 54 0a 2a 2a 20 69 73 20 6e 6f 74 20 _TEST.** is not
24b10 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66 6e defined..*/.#ifn
24b20 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
24b30 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 20 20 76 BUILTIN_TEST. v
24b40 6f 69 64 20 73 71 6c 69 74 65 33 42 65 67 69 6e oid sqlite3Begin
24b50 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 76 6f 69 BenignMalloc(voi
24b60 64 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 d);. void sqlit
24b70 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f e3EndBenignMallo
24b80 63 28 76 6f 69 64 29 3b 0a 23 65 6c 73 65 0a 20 c(void);.#else.
24b90 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
24ba0 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f BeginBenignMallo
24bb0 63 28 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 c(). #define sq
24bc0 6c 69 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 lite3EndBenignMa
24bd0 6c 6c 6f 63 28 29 0a 23 65 6e 64 69 66 0a 0a 23 lloc().#endif..#
24be0 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f define IN_INDEX_
24bf0 52 4f 57 49 44 20 20 20 20 20 20 20 20 20 20 20 ROWID
24c00 31 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 1.#define IN_IND
24c10 45 58 5f 45 50 48 20 20 20 20 20 20 20 20 20 20 EX_EPH
24c20 20 20 20 32 0a 23 64 65 66 69 6e 65 20 49 4e 5f 2.#define IN_
24c30 49 4e 44 45 58 5f 49 4e 44 45 58 5f 41 53 43 20 INDEX_INDEX_ASC
24c40 20 20 20 20 20 20 33 0a 23 64 65 66 69 6e 65 20 3.#define
24c50 49 4e 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 44 IN_INDEX_INDEX_D
24c60 45 53 43 20 20 20 20 20 20 34 0a 69 6e 74 20 73 ESC 4.int s
24c70 71 6c 69 74 65 33 46 69 6e 64 49 6e 49 6e 64 65 qlite3FindInInde
24c80 78 28 50 61 72 73 65 20 2a 2c 20 45 78 70 72 20 x(Parse *, Expr
24c90 2a 2c 20 69 6e 74 2a 29 3b 0a 0a 23 69 66 64 65 *, int*);..#ifde
24ca0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
24cb0 41 54 4f 4d 49 43 5f 57 52 49 54 45 0a 20 20 69 ATOMIC_WRITE. i
24cc0 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 nt sqlite3Journa
24cd0 6c 4f 70 65 6e 28 73 71 6c 69 74 65 33 5f 76 66 lOpen(sqlite3_vf
24ce0 73 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 s *, const char
24cf0 2a 2c 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 *, sqlite3_file
24d00 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 *, int, int);.
24d10 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e int sqlite3Journ
24d20 61 6c 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 76 alSize(sqlite3_v
24d30 66 73 20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c fs *);. int sql
24d40 69 74 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 ite3JournalCreat
24d50 65 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a e(sqlite3_file *
24d60 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
24d70 4a 6f 75 72 6e 61 6c 45 78 69 73 74 73 28 73 71 JournalExists(sq
24d80 6c 69 74 65 33 5f 66 69 6c 65 20 2a 70 29 3b 0a lite3_file *p);.
24d90 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 #else. #define
24da0 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 sqlite3JournalSi
24db0 7a 65 28 70 56 66 73 29 20 28 28 70 56 66 73 29 ze(pVfs) ((pVfs)
24dc0 2d 3e 73 7a 4f 73 46 69 6c 65 29 0a 20 20 23 64 ->szOsFile). #d
24dd0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4a 6f 75 efine sqlite3Jou
24de0 72 6e 61 6c 45 78 69 73 74 73 28 70 29 20 31 0a rnalExists(p) 1.
24df0 23 65 6e 64 69 66 0a 0a 76 6f 69 64 20 73 71 6c #endif..void sql
24e00 69 74 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c 4f 70 ite3MemJournalOp
24e10 65 6e 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 en(sqlite3_file
24e20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d *);.int sqlite3M
24e30 65 6d 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 76 6f emJournalSize(vo
24e40 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 id);.int sqlite3
24e50 49 73 4d 65 6d 4a 6f 75 72 6e 61 6c 28 73 71 6c IsMemJournal(sql
24e60 69 74 65 33 5f 66 69 6c 65 20 2a 29 3b 0a 0a 23 ite3_file *);..#
24e70 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 if SQLITE_MAX_EX
24e80 50 52 5f 44 45 50 54 48 3e 30 0a 20 20 76 6f 69 PR_DEPTH>0. voi
24e90 64 20 73 71 6c 69 74 65 33 45 78 70 72 53 65 74 d sqlite3ExprSet
24ea0 48 65 69 67 68 74 28 50 61 72 73 65 20 2a 70 50 Height(Parse *pP
24eb0 61 72 73 65 2c 20 45 78 70 72 20 2a 70 29 3b 0a arse, Expr *p);.
24ec0 20 20 69 6e 74 20 73 71 6c 69 74 65 33 53 65 6c int sqlite3Sel
24ed0 65 63 74 45 78 70 72 48 65 69 67 68 74 28 53 65 ectExprHeight(Se
24ee0 6c 65 63 74 20 2a 29 3b 0a 20 20 69 6e 74 20 73 lect *);. int s
24ef0 71 6c 69 74 65 33 45 78 70 72 43 68 65 63 6b 48 qlite3ExprCheckH
24f00 65 69 67 68 74 28 50 61 72 73 65 2a 2c 20 69 6e eight(Parse*, in
24f10 74 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 t);.#else. #def
24f20 69 6e 65 20 73 71 6c 69 74 65 33 45 78 70 72 53 ine sqlite3ExprS
24f30 65 74 48 65 69 67 68 74 28 78 2c 79 29 0a 20 20 etHeight(x,y).
24f40 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 #define sqlite3S
24f50 65 6c 65 63 74 45 78 70 72 48 65 69 67 68 74 28 electExprHeight(
24f60 78 29 20 30 0a 20 20 23 64 65 66 69 6e 65 20 73 x) 0. #define s
24f70 71 6c 69 74 65 33 45 78 70 72 43 68 65 63 6b 48 qlite3ExprCheckH
24f80 65 69 67 68 74 28 78 2c 79 29 0a 23 65 6e 64 69 eight(x,y).#endi
24f90 66 0a 0a 75 33 32 20 73 71 6c 69 74 65 33 47 65 f..u32 sqlite3Ge
24fa0 74 34 62 79 74 65 28 63 6f 6e 73 74 20 75 38 2a t4byte(const u8*
24fb0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 );.void sqlite3P
24fc0 75 74 34 62 79 74 65 28 75 38 2a 2c 20 75 33 32 ut4byte(u8*, u32
24fd0 29 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 );..#ifdef SQLIT
24fe0 45 5f 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f E_ENABLE_UNLOCK_
24ff0 4e 4f 54 49 46 59 0a 20 20 76 6f 69 64 20 73 71 NOTIFY. void sq
25000 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 lite3ConnectionB
25010 6c 6f 63 6b 65 64 28 73 71 6c 69 74 65 33 20 2a locked(sqlite3 *
25020 2c 20 73 71 6c 69 74 65 33 20 2a 29 3b 0a 20 20 , sqlite3 *);.
25030 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6e 6e void sqlite3Conn
25040 65 63 74 69 6f 6e 55 6e 6c 6f 63 6b 65 64 28 73 ectionUnlocked(s
25050 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 76 qlite3 *db);. v
25060 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 oid sqlite3Conne
25070 63 74 69 6f 6e 43 6c 6f 73 65 64 28 73 71 6c 69 ctionClosed(sqli
25080 74 65 33 20 2a 64 62 29 3b 0a 23 65 6c 73 65 0a te3 *db);.#else.
25090 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
250a0 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 3ConnectionBlock
250b0 65 64 28 78 2c 79 29 0a 20 20 23 64 65 66 69 6e ed(x,y). #defin
250c0 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 e sqlite3Connect
250d0 69 6f 6e 55 6e 6c 6f 63 6b 65 64 28 78 29 0a 20 ionUnlocked(x).
250e0 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
250f0 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c 6f 73 65 64 ConnectionClosed
25100 28 78 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 (x).#endif..#ifd
25110 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
25120 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 void sqlite3Pa
25130 72 73 65 72 54 72 61 63 65 28 46 49 4c 45 2a 2c rserTrace(FILE*,
25140 20 63 68 61 72 20 2a 29 3b 0a 23 65 6e 64 69 66 char *);.#endif
25150 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53 ../*.** If the S
25160 51 4c 49 54 45 5f 45 4e 41 42 4c 45 20 49 4f 54 QLITE_ENABLE IOT
25170 52 41 43 45 20 65 78 69 73 74 73 20 74 68 65 6e RACE exists then
25180 20 74 68 65 20 67 6c 6f 62 61 6c 20 76 61 72 69 the global vari
25190 61 62 6c 65 0a 2a 2a 20 73 71 6c 69 74 65 33 49 able.** sqlite3I
251a0 6f 54 72 61 63 65 20 69 73 20 61 20 70 6f 69 6e oTrace is a poin
251b0 74 65 72 20 74 6f 20 61 20 70 72 69 6e 74 66 2d ter to a printf-
251c0 6c 69 6b 65 20 72 6f 75 74 69 6e 65 20 75 73 65 like routine use
251d0 64 20 74 6f 0a 2a 2a 20 70 72 69 6e 74 20 49 2f d to.** print I/
251e0 4f 20 74 72 61 63 69 6e 67 20 6d 65 73 73 61 67 O tracing messag
251f0 65 73 2e 20 0a 2a 2f 0a 23 69 66 64 65 66 20 53 es. .*/.#ifdef S
25200 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 QLITE_ENABLE_IOT
25210 52 41 43 45 0a 23 20 64 65 66 69 6e 65 20 49 4f RACE.# define IO
25220 54 52 41 43 45 28 41 29 20 20 69 66 28 20 73 71 TRACE(A) if( sq
25230 6c 69 74 65 33 49 6f 54 72 61 63 65 20 29 7b 20 lite3IoTrace ){
25240 73 71 6c 69 74 65 33 49 6f 54 72 61 63 65 20 41 sqlite3IoTrace A
25250 3b 20 7d 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 ; }. void sqlit
25260 65 33 56 64 62 65 49 4f 54 72 61 63 65 53 71 6c e3VdbeIOTraceSql
25270 28 56 64 62 65 2a 29 3b 0a 53 51 4c 49 54 45 5f (Vdbe*);.SQLITE_
25280 45 58 54 45 52 4e 20 76 6f 69 64 20 28 2a 73 71 EXTERN void (*sq
25290 6c 69 74 65 33 49 6f 54 72 61 63 65 29 28 63 6f lite3IoTrace)(co
252a0 6e 73 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a nst char*,...);.
252b0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 49 #else.# define I
252c0 4f 54 52 41 43 45 28 41 29 0a 23 20 64 65 66 69 OTRACE(A).# defi
252d0 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f ne sqlite3VdbeIO
252e0 54 72 61 63 65 53 71 6c 28 58 29 0a 23 65 6e 64 TraceSql(X).#end
252f0 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 if../*.** These
25300 72 6f 75 74 69 6e 65 73 20 61 72 65 20 61 76 61 routines are ava
25310 69 6c 61 62 6c 65 20 66 6f 72 20 74 68 65 20 6d ilable for the m
25320 65 6d 32 2e 63 20 64 65 62 75 67 67 69 6e 67 20 em2.c debugging
25330 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 memory allocator
25340 0a 2a 2a 20 6f 6e 6c 79 2e 20 20 54 68 65 79 20 .** only. They
25350 61 72 65 20 75 73 65 64 20 74 6f 20 76 65 72 69 are used to veri
25360 66 79 20 74 68 61 74 20 64 69 66 66 65 72 65 6e fy that differen
25370 74 20 22 74 79 70 65 73 22 20 6f 66 20 6d 65 6d t "types" of mem
25380 6f 72 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f ory.** allocatio
25390 6e 73 20 61 72 65 20 70 72 6f 70 65 72 6c 79 20 ns are properly
253a0 74 72 61 63 6b 65 64 20 62 79 20 74 68 65 20 73 tracked by the s
253b0 79 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c ystem..**.** sql
253c0 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 ite3MemdebugSetT
253d0 79 70 65 28 29 20 73 65 74 73 20 74 68 65 20 22 ype() sets the "
253e0 74 79 70 65 22 20 6f 66 20 61 6e 20 61 6c 6c 6f type" of an allo
253f0 63 61 74 69 6f 6e 20 74 6f 20 6f 6e 65 20 6f 66 cation to one of
25400 0a 2a 2a 20 74 68 65 20 4d 45 4d 54 59 50 45 5f .** the MEMTYPE_
25410 2a 20 6d 61 63 72 6f 73 20 64 65 66 69 6e 65 64 * macros defined
25420 20 62 65 6c 6f 77 2e 20 20 54 68 65 20 74 79 70 below. The typ
25430 65 20 6d 75 73 74 20 62 65 20 61 20 62 69 74 6d e must be a bitm
25440 61 73 6b 20 77 69 74 68 0a 2a 2a 20 61 20 73 69 ask with.** a si
25450 6e 67 6c 65 20 62 69 74 20 73 65 74 2e 0a 2a 2a ngle bit set..**
25460 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
25470 62 75 67 48 61 73 54 79 70 65 28 29 20 72 65 74 bugHasType() ret
25480 75 72 6e 73 20 74 72 75 65 20 69 66 20 61 6e 79 urns true if any
25490 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 of the bits in
254a0 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 its second.** ar
254b0 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 gument match the
254c0 20 74 79 70 65 20 73 65 74 20 62 79 20 74 68 65 type set by the
254d0 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 previous sqlite
254e0 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 3MemdebugSetType
254f0 28 29 2e 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 ()..** sqlite3Me
25500 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 29 20 mdebugHasType()
25510 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 is intended for
25520 75 73 65 20 69 6e 73 69 64 65 20 61 73 73 65 72 use inside asser
25530 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a t() statements..
25540 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d **.** sqlite3Mem
25550 64 65 62 75 67 4e 6f 54 79 70 65 28 29 20 72 65 debugNoType() re
25560 74 75 72 6e 73 20 74 72 75 65 20 69 66 20 6e 6f turns true if no
25570 6e 65 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 ne of the bits i
25580 6e 20 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 n its second.**
25590 61 72 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 argument match t
255a0 68 65 20 74 79 70 65 20 73 65 74 20 62 79 20 74 he type set by t
255b0 68 65 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 he previous sqli
255c0 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 te3MemdebugSetTy
255d0 70 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 72 68 pe()..**.** Perh
255e0 61 70 73 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 aps the most imp
255f0 6f 72 74 61 6e 74 20 70 6f 69 6e 74 20 69 73 20 ortant point is
25600 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 the difference b
25610 65 74 77 65 65 6e 20 4d 45 4d 54 59 50 45 5f 48 etween MEMTYPE_H
25620 45 41 50 0a 2a 2a 20 61 6e 64 20 4d 45 4d 54 59 EAP.** and MEMTY
25630 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 2e 20 20 49 PE_LOOKASIDE. I
25640 66 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 f an allocation
25650 69 73 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 is MEMTYPE_LOOKA
25660 53 49 44 45 2c 20 74 68 61 74 20 6d 65 61 6e 73 SIDE, that means
25670 0a 2a 2a 20 69 74 20 6d 69 67 68 74 20 68 61 76 .** it might hav
25680 65 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 e been allocated
25690 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 2c 20 65 by lookaside, e
256a0 78 63 65 70 74 20 74 68 65 20 61 6c 6c 6f 63 61 xcept the alloca
256b0 74 69 6f 6e 20 77 61 73 0a 2a 2a 20 74 6f 6f 20 tion was.** too
256c0 6c 61 72 67 65 20 6f 72 20 6c 6f 6f 6b 61 73 69 large or lookasi
256d0 64 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 66 de was already f
256e0 75 6c 6c 2e 20 20 49 74 20 69 73 20 69 6d 70 6f ull. It is impo
256f0 72 74 61 6e 74 20 74 6f 20 76 65 72 69 66 79 0a rtant to verify.
25700 2a 2a 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 69 ** that allocati
25710 6f 6e 73 20 74 68 61 74 20 6d 69 67 68 74 20 68 ons that might h
25720 61 76 65 20 62 65 65 6e 20 73 61 74 69 73 66 69 ave been satisfi
25730 65 64 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 20 ed by lookaside
25740 61 72 65 20 6e 6f 74 0a 2a 2a 20 70 61 73 73 65 are not.** passe
25750 64 20 62 61 63 6b 20 74 6f 20 6e 6f 6e 2d 6c 6f d back to non-lo
25760 6f 6b 61 73 69 64 65 20 66 72 65 65 28 29 20 72 okaside free() r
25770 6f 75 74 69 6e 65 73 2e 20 20 41 73 73 65 72 74 outines. Assert
25780 73 20 73 75 63 68 20 61 73 20 74 68 65 0a 2a 2a s such as the.**
25790 20 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 20 61 example above a
257a0 72 65 20 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 re placed on the
257b0 20 6e 6f 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 non-lookaside f
257c0 72 65 65 28 29 20 72 6f 75 74 69 6e 65 73 20 74 ree() routines t
257d0 6f 20 76 65 72 69 66 79 0a 2a 2a 20 74 68 69 73 o verify.** this
257e0 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20 0a 2a 2a constraint. .**
257f0 0a 2a 2a 20 41 6c 6c 20 6f 66 20 74 68 69 73 20 .** All of this
25800 69 73 20 6e 6f 2d 6f 70 20 66 6f 72 20 61 20 70 is no-op for a p
25810 72 6f 64 75 63 74 69 6f 6e 20 62 75 69 6c 64 2e roduction build.
25820 20 20 49 74 20 6f 6e 6c 79 20 63 6f 6d 65 73 20 It only comes
25830 69 6e 74 6f 0a 2a 2a 20 70 6c 61 79 20 77 68 65 into.** play whe
25840 6e 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 45 4d n the SQLITE_MEM
25850 44 45 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74 69 DEBUG compile-ti
25860 6d 65 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 me option is use
25870 64 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c d..*/.#ifdef SQL
25880 49 54 45 5f 4d 45 4d 44 45 42 55 47 0a 20 20 76 ITE_MEMDEBUG. v
25890 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 oid sqlite3Memde
258a0 62 75 67 53 65 74 54 79 70 65 28 76 6f 69 64 2a bugSetType(void*
258b0 2c 75 38 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 ,u8);. int sqli
258c0 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 te3MemdebugHasTy
258d0 70 65 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 pe(void*,u8);.
258e0 69 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 int sqlite3Memde
258f0 62 75 67 4e 6f 54 79 70 65 28 76 6f 69 64 2a 2c bugNoType(void*,
25900 75 38 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 u8);.#else.# def
25910 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 ine sqlite3Memde
25920 62 75 67 53 65 74 54 79 70 65 28 58 2c 59 29 20 bugSetType(X,Y)
25930 20 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 64 /* no-op */.# d
25940 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d efine sqlite3Mem
25950 64 65 62 75 67 48 61 73 54 79 70 65 28 58 2c 59 debugHasType(X,Y
25960 29 20 20 31 0a 23 20 64 65 66 69 6e 65 20 73 71 ) 1.# define sq
25970 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 lite3MemdebugNoT
25980 79 70 65 28 58 2c 59 29 20 20 20 31 0a 23 65 6e ype(X,Y) 1.#en
25990 64 69 66 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 dif.#define MEMT
259a0 59 50 45 5f 48 45 41 50 20 20 20 20 20 20 20 30 YPE_HEAP 0
259b0 78 30 31 20 20 2f 2a 20 47 65 6e 65 72 61 6c 20 x01 /* General
259c0 68 65 61 70 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 heap allocations
259d0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 */.#define MEMT
259e0 59 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 20 30 YPE_LOOKASIDE 0
259f0 78 30 32 20 20 2f 2a 20 4d 69 67 68 74 20 68 61 x02 /* Might ha
25a00 76 65 20 62 65 65 6e 20 6c 6f 6f 6b 61 73 69 64 ve been lookasid
25a10 65 20 6d 65 6d 6f 72 79 20 2a 2f 0a 23 64 65 66 e memory */.#def
25a20 69 6e 65 20 4d 45 4d 54 59 50 45 5f 53 43 52 41 ine MEMTYPE_SCRA
25a30 54 43 48 20 20 20 20 30 78 30 34 20 20 2f 2a 20 TCH 0x04 /*
25a40 53 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 Scratch allocati
25a50 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d ons */.#define M
25a60 45 4d 54 59 50 45 5f 50 43 41 43 48 45 20 20 20 EMTYPE_PCACHE
25a70 20 20 30 78 30 38 20 20 2f 2a 20 50 61 67 65 20 0x08 /* Page
25a80 63 61 63 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e cache allocation
25a90 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d s */.#define MEM
25aa0 54 59 50 45 5f 44 42 20 20 20 20 20 20 20 20 20 TYPE_DB
25ab0 30 78 31 30 20 20 2f 2a 20 55 73 65 73 20 73 71 0x10 /* Uses sq
25ac0 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 2c 20 6e lite3DbMalloc, n
25ad0 6f 74 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 ot sqlite_malloc
25ae0 20 2a 2f 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 5f */..#endif /* _
25af0 53 51 4c 49 54 45 49 4e 54 5f 48 5f 20 2a 2f 0a SQLITEINT_H_ */.