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 0a 2f 2a o WhereInfo;../*
6360: 0a 2a 2a 20 44 65 66 65 72 20 73 6f 75 72 63 69 .** Defer sourci
6370: 6e 67 20 76 64 62 65 2e 68 20 61 6e 64 20 62 74 ng vdbe.h and bt
6380: 72 65 65 2e 68 20 75 6e 74 69 6c 20 61 66 74 65 ree.h until afte
6390: 72 20 74 68 65 20 22 75 38 22 20 61 6e 64 20 0a r the "u8" and .
63a0: 2a 2a 20 22 42 75 73 79 48 61 6e 64 6c 65 72 22 ** "BusyHandler"
63b0: 20 74 79 70 65 64 65 66 73 2e 20 76 64 62 65 2e typedefs. vdbe.
63c0: 68 20 61 6c 73 6f 20 72 65 71 75 69 72 65 73 20 h also requires
63d0: 61 20 66 65 77 20 6f 66 20 74 68 65 20 6f 70 61 a few of the opa
63e0: 71 75 65 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 que.** pointer t
63f0: 79 70 65 73 20 28 69 2e 65 2e 20 46 75 6e 63 44 ypes (i.e. FuncD
6400: 65 66 29 20 64 65 66 69 6e 65 64 20 61 62 6f 76 ef) defined abov
6410: 65 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 e..*/.#include "
6420: 62 74 72 65 65 2e 68 22 0a 23 69 6e 63 6c 75 64 btree.h".#includ
6430: 65 20 22 76 64 62 65 2e 68 22 0a 23 69 6e 63 6c e "vdbe.h".#incl
6440: 75 64 65 20 22 70 61 67 65 72 2e 68 22 0a 23 69 ude "pager.h".#i
6450: 6e 63 6c 75 64 65 20 22 70 63 61 63 68 65 2e 68 nclude "pcache.h
6460: 22 0a 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e "..#include "os.
6470: 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 6d 75 74 h".#include "mut
6480: 65 78 2e 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 ex.h".../*.** Ea
6490: 63 68 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 ch database file
64a0: 20 74 6f 20 62 65 20 61 63 63 65 73 73 65 64 20 to be accessed
64b0: 62 79 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 by the system is
64c0: 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 an instance.**
64d0: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
64e0: 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 65 structure. The
64f0: 72 65 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 re are normally
6500: 74 77 6f 20 6f 66 20 74 68 65 73 65 20 73 74 72 two of these str
6510: 75 63 74 75 72 65 73 0a 2a 2a 20 69 6e 20 74 68 uctures.** in th
6520: 65 20 73 71 6c 69 74 65 2e 61 44 62 5b 5d 20 61 e sqlite.aDb[] a
6530: 72 72 61 79 2e 20 20 61 44 62 5b 30 5d 20 69 73 rray. aDb[0] is
6540: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 the main databa
6550: 73 65 20 66 69 6c 65 20 61 6e 64 0a 2a 2a 20 61 se file and.** a
6560: 44 62 5b 31 5d 20 69 73 20 74 68 65 20 64 61 74 Db[1] is the dat
6570: 61 62 61 73 65 20 66 69 6c 65 20 75 73 65 64 20 abase file used
6580: 74 6f 20 68 6f 6c 64 20 74 65 6d 70 6f 72 61 72 to hold temporar
6590: 79 20 74 61 62 6c 65 73 2e 20 20 41 64 64 69 74 y tables. Addit
65a0: 69 6f 6e 61 6c 0a 2a 2a 20 64 61 74 61 62 61 73 ional.** databas
65b0: 65 73 20 6d 61 79 20 62 65 20 61 74 74 61 63 68 es may be attach
65c0: 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 44 62 ed..*/.struct Db
65d0: 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 {. char *zName
65e0: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d ; /* Nam
65f0: 65 20 6f 66 20 74 68 69 73 20 64 61 74 61 62 61 e of this databa
6600: 73 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 se */. Btree *p
6610: 42 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 Bt; /*
6620: 54 68 65 20 42 2a 54 72 65 65 20 73 74 72 75 63 The B*Tree struc
6630: 74 75 72 65 20 66 6f 72 20 74 68 69 73 20 64 61 ture for this da
6640: 74 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 tabase file */.
6650: 20 75 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c u8 safety_level
6660: 3b 20 20 20 20 20 2f 2a 20 48 6f 77 20 61 67 67 ; /* How agg
6670: 72 65 73 73 69 76 65 20 61 74 20 73 79 6e 63 69 ressive at synci
6680: 6e 67 20 64 61 74 61 20 74 6f 20 64 69 73 6b 20 ng data to disk
6690: 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 */. Schema *pSc
66a0: 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 50 6f 69 hema; /* Poi
66b0: 6e 74 65 72 20 74 6f 20 64 61 74 61 62 61 73 65 nter to database
66c0: 20 73 63 68 65 6d 61 20 28 70 6f 73 73 69 62 6c schema (possibl
66d0: 79 20 73 68 61 72 65 64 29 20 2a 2f 0a 7d 3b 0a y shared) */.};.
66e0: 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
66f0: 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
6700: 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 73 74 ing structure st
6710: 6f 72 65 73 20 61 20 64 61 74 61 62 61 73 65 20 ores a database
6720: 73 63 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 4d 6f schema..**.** Mo
6730: 73 74 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 74 st Schema object
6740: 73 20 61 72 65 20 61 73 73 6f 63 69 61 74 65 64 s are associated
6750: 20 77 69 74 68 20 61 20 42 74 72 65 65 2e 20 20 with a Btree.
6760: 54 68 65 20 65 78 63 65 70 74 69 6f 6e 20 69 73 The exception is
6770: 0a 2a 2a 20 74 68 65 20 53 63 68 65 6d 61 20 66 .** the Schema f
6780: 6f 72 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 or the TEMP data
6790: 62 61 65 73 20 28 73 71 6c 69 74 65 33 2e 61 44 baes (sqlite3.aD
67a0: 62 5b 31 5d 29 20 77 68 69 63 68 20 69 73 20 66 b[1]) which is f
67b0: 72 65 65 2d 73 74 61 6e 64 69 6e 67 2e 0a 2a 2a ree-standing..**
67c0: 20 49 6e 20 73 68 61 72 65 64 20 63 61 63 68 65 In shared cache
67d0: 20 6d 6f 64 65 2c 20 61 20 73 69 6e 67 6c 65 20 mode, a single
67e0: 53 63 68 65 6d 61 20 6f 62 6a 65 63 74 20 63 61 Schema object ca
67f0: 6e 20 62 65 20 73 68 61 72 65 64 20 62 79 20 6d n be shared by m
6800: 75 6c 74 69 70 6c 65 0a 2a 2a 20 42 74 72 65 65 ultiple.** Btree
6810: 73 20 74 68 61 74 20 72 65 66 65 72 20 74 6f 20 s that refer to
6820: 74 68 65 20 73 61 6d 65 20 75 6e 64 65 72 6c 79 the same underly
6830: 69 6e 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a ing BtShared obj
6840: 65 63 74 2e 0a 2a 2a 20 0a 2a 2a 20 53 63 68 65 ect..** .** Sche
6850: 6d 61 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 ma objects are a
6860: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 61 utomatically dea
6870: 6c 6c 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68 llocated when th
6880: 65 20 6c 61 73 74 20 42 74 72 65 65 20 74 68 61 e last Btree tha
6890: 74 0a 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 20 t.** references
68a0: 74 68 65 6d 20 69 73 20 64 65 73 74 72 6f 79 65 them is destroye
68b0: 64 2e 20 20 20 54 68 65 20 54 45 4d 50 20 53 63 d. The TEMP Sc
68c0: 68 65 6d 61 20 69 73 20 6d 61 6e 75 61 6c 6c 79 hema is manually
68d0: 20 66 72 65 65 64 20 62 79 0a 2a 2a 20 73 71 6c freed by.** sql
68e0: 69 74 65 33 5f 63 6c 6f 73 65 28 29 2e 0a 2a 0a ite3_close()..*.
68f0: 2a 2a 20 41 20 74 68 72 65 61 64 20 6d 75 73 74 ** A thread must
6900: 20 62 65 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 be holding a mu
6910: 74 65 78 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 tex on the corre
6920: 73 70 6f 6e 64 69 6e 67 20 42 74 72 65 65 20 69 sponding Btree i
6930: 6e 20 6f 72 64 65 72 0a 2a 2a 20 74 6f 20 61 63 n order.** to ac
6940: 63 65 73 73 20 53 63 68 65 6d 61 20 63 6f 6e 74 cess Schema cont
6950: 65 6e 74 2e 20 20 54 68 69 73 20 69 6d 70 6c 69 ent. This impli
6960: 65 73 20 74 68 61 74 20 74 68 65 20 74 68 72 65 es that the thre
6970: 61 64 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 0a ad must also be.
6980: 2a 2a 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 74 ** holding a mut
6990: 65 78 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 65 ex on the sqlite
69a0: 33 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 3 connection poi
69b0: 6e 74 65 72 20 74 68 61 74 20 6f 77 6e 73 20 74 nter that owns t
69c0: 68 65 20 42 74 72 65 65 2e 0a 2a 2a 20 46 6f 72 he Btree..** For
69d0: 20 61 20 54 45 4d 50 20 53 63 68 65 6d 61 2c 20 a TEMP Schema,
69e0: 6f 6e 6c 79 20 74 68 65 20 63 6f 6e 6e 65 63 74 only the connect
69f0: 69 6f 6e 20 6d 75 74 65 78 20 69 73 20 72 65 71 ion mutex is req
6a00: 75 69 72 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 uired..*/.struct
6a10: 20 53 63 68 65 6d 61 20 7b 0a 20 20 69 6e 74 20 Schema {. int
6a20: 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 3b 20 20 schema_cookie;
6a30: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 73 63 68 /* Database sch
6a40: 65 6d 61 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 ema version numb
6a50: 65 72 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 er for this file
6a60: 20 2a 2f 0a 20 20 69 6e 74 20 69 47 65 6e 65 72 */. int iGener
6a70: 61 74 69 6f 6e 3b 20 20 20 20 20 2f 2a 20 47 65 ation; /* Ge
6a80: 6e 65 72 61 74 69 6f 6e 20 63 6f 75 6e 74 65 72 neration counter
6a90: 2e 20 20 49 6e 63 72 65 6d 65 6e 74 65 64 20 77 . Incremented w
6aa0: 69 74 68 20 65 61 63 68 20 63 68 61 6e 67 65 20 ith each change
6ab0: 2a 2f 0a 20 20 48 61 73 68 20 74 62 6c 48 61 73 */. Hash tblHas
6ac0: 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c h; /* All
6ad0: 20 74 61 62 6c 65 73 20 69 6e 64 65 78 65 64 20 tables indexed
6ae0: 62 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 73 by name */. Has
6af0: 68 20 69 64 78 48 61 73 68 3b 20 20 20 20 20 20 h idxHash;
6b00: 20 20 2f 2a 20 41 6c 6c 20 28 6e 61 6d 65 64 29 /* All (named)
6b10: 20 69 6e 64 69 63 65 73 20 69 6e 64 65 78 65 64 indices indexed
6b20: 20 62 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 by name */. Ha
6b30: 73 68 20 74 72 69 67 48 61 73 68 3b 20 20 20 20 sh trigHash;
6b40: 20 20 20 2f 2a 20 41 6c 6c 20 74 72 69 67 67 65 /* All trigge
6b50: 72 73 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 rs indexed by na
6b60: 6d 65 20 2a 2f 0a 20 20 48 61 73 68 20 66 6b 65 me */. Hash fke
6b70: 79 48 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 yHash; /*
6b80: 41 6c 6c 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 All foreign keys
6b90: 20 62 79 20 72 65 66 65 72 65 6e 63 65 64 20 74 by referenced t
6ba0: 61 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 54 able name */. T
6bb0: 61 62 6c 65 20 2a 70 53 65 71 54 61 62 3b 20 20 able *pSeqTab;
6bc0: 20 20 20 20 2f 2a 20 54 68 65 20 73 71 6c 69 74 /* The sqlit
6bd0: 65 5f 73 65 71 75 65 6e 63 65 20 74 61 62 6c 65 e_sequence table
6be0: 20 75 73 65 64 20 62 79 20 41 55 54 4f 49 4e 43 used by AUTOINC
6bf0: 52 45 4d 45 4e 54 20 2a 2f 0a 20 20 75 38 20 66 REMENT */. u8 f
6c00: 69 6c 65 5f 66 6f 72 6d 61 74 3b 20 20 20 20 20 ile_format;
6c10: 20 2f 2a 20 53 63 68 65 6d 61 20 66 6f 72 6d 61 /* Schema forma
6c20: 74 20 76 65 72 73 69 6f 6e 20 66 6f 72 20 74 68 t version for th
6c30: 69 73 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 is file */. u8
6c40: 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 enc;
6c50: 20 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 /* Text encodi
6c60: 6e 67 20 75 73 65 64 20 62 79 20 74 68 69 73 20 ng used by this
6c70: 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 31 database */. u1
6c80: 36 20 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 6 flags;
6c90: 20 20 20 2f 2a 20 46 6c 61 67 73 20 61 73 73 6f /* Flags asso
6ca0: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69 73 ciated with this
6cb0: 20 73 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 schema */. int
6cc0: 20 63 61 63 68 65 5f 73 69 7a 65 3b 20 20 20 20 cache_size;
6cd0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 /* Number of p
6ce0: 61 67 65 73 20 74 6f 20 75 73 65 20 69 6e 20 74 ages to use in t
6cf0: 68 65 20 63 61 63 68 65 20 2a 2f 0a 7d 3b 0a 0a he cache */.};..
6d00: 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 /*.** These macr
6d10: 6f 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 os can be used t
6d20: 6f 20 74 65 73 74 2c 20 73 65 74 2c 20 6f 72 20 o test, set, or
6d30: 63 6c 65 61 72 20 62 69 74 73 20 69 6e 20 74 68 clear bits in th
6d40: 65 20 0a 2a 2a 20 44 62 2e 70 53 63 68 65 6d 61 e .** Db.pSchema
6d50: 2d 3e 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a ->flags field..*
6d60: 2f 0a 23 64 65 66 69 6e 65 20 44 62 48 61 73 50 /.#define DbHasP
6d70: 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 roperty(D,I,P)
6d80: 20 20 20 28 28 28 44 29 2d 3e 61 44 62 5b 49 5d (((D)->aDb[I]
6d90: 2e 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 26 .pSchema->flags&
6da0: 28 50 29 29 3d 3d 28 50 29 29 0a 23 64 65 66 69 (P))==(P)).#defi
6db0: 6e 65 20 44 62 48 61 73 41 6e 79 50 72 6f 70 65 ne DbHasAnyPrope
6dc0: 72 74 79 28 44 2c 49 2c 50 29 20 20 28 28 28 44 rty(D,I,P) (((D
6dd0: 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d )->aDb[I].pSchem
6de0: 61 2d 3e 66 6c 61 67 73 26 28 50 29 29 21 3d 30 a->flags&(P))!=0
6df0: 29 0a 23 64 65 66 69 6e 65 20 44 62 53 65 74 50 ).#define DbSetP
6e00: 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 roperty(D,I,P)
6e10: 20 20 20 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 (D)->aDb[I].p
6e20: 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 7c 3d 28 Schema->flags|=(
6e30: 50 29 0a 23 64 65 66 69 6e 65 20 44 62 43 6c 65 P).#define DbCle
6e40: 61 72 50 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 arProperty(D,I,P
6e50: 29 20 20 20 28 44 29 2d 3e 61 44 62 5b 49 5d 2e ) (D)->aDb[I].
6e60: 70 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 26 3d pSchema->flags&=
6e70: 7e 28 50 29 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f ~(P)../*.** Allo
6e80: 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 wed values for t
6e90: 68 65 20 44 42 2e 70 53 63 68 65 6d 61 2d 3e 66 he DB.pSchema->f
6ea0: 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a 2a lags field..**.*
6eb0: 2a 20 54 68 65 20 44 42 5f 53 63 68 65 6d 61 4c * The DB_SchemaL
6ec0: 6f 61 64 65 64 20 66 6c 61 67 20 69 73 20 73 65 oaded flag is se
6ed0: 74 20 61 66 74 65 72 20 74 68 65 20 64 61 74 61 t after the data
6ee0: 62 61 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 base schema has
6ef0: 62 65 65 6e 0a 2a 2a 20 72 65 61 64 20 69 6e 74 been.** read int
6f00: 6f 20 69 6e 74 65 72 6e 61 6c 20 68 61 73 68 20 o internal hash
6f10: 74 61 62 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 44 42 tables..**.** DB
6f20: 5f 55 6e 72 65 73 65 74 56 69 65 77 73 20 6d 65 _UnresetViews me
6f30: 61 6e 73 20 74 68 61 74 20 6f 6e 65 20 6f 72 20 ans that one or
6f40: 6d 6f 72 65 20 76 69 65 77 73 20 68 61 76 65 20 more views have
6f50: 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 68 61 column names tha
6f60: 74 0a 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 66 t.** have been f
6f70: 69 6c 6c 65 64 20 6f 75 74 2e 20 20 49 66 20 74 illed out. If t
6f80: 68 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 he schema change
6f90: 73 2c 20 74 68 65 73 65 20 63 6f 6c 75 6d 6e 20 s, these column
6fa0: 6e 61 6d 65 73 20 6d 69 67 68 74 0a 2a 2a 20 63 names might.** c
6fb0: 68 61 6e 67 65 73 20 61 6e 64 20 73 6f 20 74 68 hanges and so th
6fc0: 65 20 76 69 65 77 20 77 69 6c 6c 20 6e 65 65 64 e view will need
6fd0: 20 74 6f 20 62 65 20 72 65 73 65 74 2e 0a 2a 2f to be reset..*/
6fe0: 0a 23 64 65 66 69 6e 65 20 44 42 5f 53 63 68 65 .#define DB_Sche
6ff0: 6d 61 4c 6f 61 64 65 64 20 20 20 20 30 78 30 30 maLoaded 0x00
7000: 30 31 20 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 01 /* The schem
7010: 61 20 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 a has been loade
7020: 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f d */.#define DB_
7030: 55 6e 72 65 73 65 74 56 69 65 77 73 20 20 20 20 UnresetViews
7040: 30 78 30 30 30 32 20 20 2f 2a 20 53 6f 6d 65 20 0x0002 /* Some
7050: 76 69 65 77 73 20 68 61 76 65 20 64 65 66 69 6e views have defin
7060: 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 ed column names
7070: 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 45 6d */.#define DB_Em
7080: 70 74 79 20 20 20 20 20 20 20 20 20 20 20 30 78 pty 0x
7090: 30 30 30 34 20 20 2f 2a 20 54 68 65 20 66 69 6c 0004 /* The fil
70a0: 65 20 69 73 20 65 6d 70 74 79 20 28 6c 65 6e 67 e is empty (leng
70b0: 74 68 20 30 20 62 79 74 65 73 29 20 2a 2f 0a 0a th 0 bytes) */..
70c0: 2f 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72 /*.** The number
70d0: 20 6f 66 20 64 69 66 66 65 72 65 6e 74 20 6b 69 of different ki
70e0: 6e 64 73 20 6f 66 20 74 68 69 6e 67 73 20 74 68 nds of things th
70f0: 61 74 20 63 61 6e 20 62 65 20 6c 69 6d 69 74 65 at can be limite
7100: 64 0a 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 d.** using the s
7110: 71 6c 69 74 65 33 5f 6c 69 6d 69 74 28 29 20 69 qlite3_limit() i
7120: 6e 74 65 72 66 61 63 65 2e 0a 2a 2f 0a 23 64 65 nterface..*/.#de
7130: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 5f 4c 49 fine SQLITE_N_LI
7140: 4d 49 54 20 28 53 51 4c 49 54 45 5f 4c 49 4d 49 MIT (SQLITE_LIMI
7150: 54 5f 54 52 49 47 47 45 52 5f 44 45 50 54 48 2b T_TRIGGER_DEPTH+
7160: 31 29 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 1)../*.** Lookas
7170: 69 64 65 20 6d 61 6c 6c 6f 63 20 69 73 20 61 20 ide malloc is a
7180: 73 65 74 20 6f 66 20 66 69 78 65 64 2d 73 69 7a set of fixed-siz
7190: 65 20 62 75 66 66 65 72 73 20 74 68 61 74 20 63 e buffers that c
71a0: 61 6e 20 62 65 20 75 73 65 64 0a 2a 2a 20 74 6f an be used.** to
71b0: 20 73 61 74 69 73 66 79 20 73 6d 61 6c 6c 20 74 satisfy small t
71c0: 72 61 6e 73 69 65 6e 74 20 6d 65 6d 6f 72 79 20 ransient memory
71d0: 61 6c 6c 6f 63 61 74 69 6f 6e 20 72 65 71 75 65 allocation reque
71e0: 73 74 73 20 66 6f 72 20 6f 62 6a 65 63 74 73 0a sts for objects.
71f0: 2a 2a 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 ** associated wi
7200: 74 68 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 th a particular
7210: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
7220: 69 6f 6e 2e 20 20 54 68 65 20 75 73 65 20 6f 66 ion. The use of
7230: 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 .** lookaside ma
7240: 6c 6c 6f 63 20 70 72 6f 76 69 64 65 73 20 61 20 lloc provides a
7250: 73 69 67 6e 69 66 69 63 61 6e 74 20 70 65 72 66 significant perf
7260: 6f 72 6d 61 6e 63 65 20 65 6e 68 61 6e 63 65 6d ormance enhancem
7270: 65 6e 74 0a 2a 2a 20 28 61 70 70 72 6f 78 20 31 ent.** (approx 1
7280: 30 25 29 20 62 79 20 61 76 6f 69 64 69 6e 67 20 0%) by avoiding
7290: 6e 75 6d 65 72 6f 75 73 20 6d 61 6c 6c 6f 63 2f numerous malloc/
72a0: 66 72 65 65 20 72 65 71 75 65 73 74 73 20 77 68 free requests wh
72b0: 69 6c 65 20 70 61 72 73 69 6e 67 0a 2a 2a 20 53 ile parsing.** S
72c0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a QL statements..*
72d0: 2a 0a 2a 2a 20 54 68 65 20 4c 6f 6f 6b 61 73 69 *.** The Lookasi
72e0: 64 65 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c de structure hol
72f0: 64 73 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e ds configuration
7300: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f information abo
7310: 75 74 20 74 68 65 0a 2a 2a 20 6c 6f 6f 6b 61 73 ut the.** lookas
7320: 69 64 65 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 ide malloc subsy
7330: 73 74 65 6d 2e 20 20 45 61 63 68 20 61 76 61 69 stem. Each avai
7340: 6c 61 62 6c 65 20 6d 65 6d 6f 72 79 20 61 6c 6c lable memory all
7350: 6f 63 61 74 69 6f 6e 20 69 6e 0a 2a 2a 20 74 68 ocation in.** th
7360: 65 20 6c 6f 6f 6b 61 73 69 64 65 20 73 75 62 73 e lookaside subs
7370: 79 73 74 65 6d 20 69 73 20 73 74 6f 72 65 64 20 ystem is stored
7380: 6f 6e 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 on a linked list
7390: 20 6f 66 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f of LookasideSlo
73a0: 74 0a 2a 2a 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a t.** objects..**
73b0: 0a 2a 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 61 6c .** Lookaside al
73c0: 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 20 6f 6e locations are on
73d0: 6c 79 20 61 6c 6c 6f 77 65 64 20 66 6f 72 20 6f ly allowed for o
73e0: 62 6a 65 63 74 73 20 74 68 61 74 20 61 72 65 20 bjects that are
73f0: 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 associated.** wi
7400: 74 68 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 th a particular
7410: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
7420: 69 6f 6e 2e 20 20 48 65 6e 63 65 2c 20 73 63 68 ion. Hence, sch
7430: 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ema information
7440: 63 61 6e 6e 6f 74 0a 2a 2a 20 62 65 20 73 74 6f cannot.** be sto
7450: 72 65 64 20 69 6e 20 6c 6f 6f 6b 61 73 69 64 65 red in lookaside
7460: 20 62 65 63 61 75 73 65 20 69 6e 20 73 68 61 72 because in shar
7470: 65 64 20 63 61 63 68 65 20 6d 6f 64 65 20 74 68 ed cache mode th
7480: 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 e schema informa
7490: 74 69 6f 6e 0a 2a 2a 20 69 73 20 73 68 61 72 65 tion.** is share
74a0: 64 20 62 79 20 6d 75 6c 74 69 70 6c 65 20 64 61 d by multiple da
74b0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
74c0: 6e 73 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 20 ns. Therefore,
74d0: 77 68 69 6c 65 20 70 61 72 73 69 6e 67 0a 2a 2a while parsing.**
74e0: 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 schema informat
74f0: 69 6f 6e 2c 20 74 68 65 20 4c 6f 6f 6b 61 73 69 ion, the Lookasi
7500: 64 65 2e 62 45 6e 61 62 6c 65 64 20 66 6c 61 67 de.bEnabled flag
7510: 20 69 73 20 63 6c 65 61 72 65 64 20 73 6f 20 74 is cleared so t
7520: 68 61 74 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 hat.** lookaside
7530: 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 allocations are
7540: 20 6e 6f 74 20 75 73 65 64 20 74 6f 20 63 6f 6e not used to con
7550: 73 74 72 75 63 74 20 74 68 65 20 73 63 68 65 6d struct the schem
7560: 61 20 6f 62 6a 65 63 74 73 2e 0a 2a 2f 0a 73 74 a objects..*/.st
7570: 72 75 63 74 20 4c 6f 6f 6b 61 73 69 64 65 20 7b ruct Lookaside {
7580: 0a 20 20 75 31 36 20 73 7a 3b 20 20 20 20 20 20 . u16 sz;
7590: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 /* Si
75a0: 7a 65 20 6f 66 20 65 61 63 68 20 62 75 66 66 65 ze of each buffe
75b0: 72 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 r in bytes */.
75c0: 75 38 20 62 45 6e 61 62 6c 65 64 3b 20 20 20 20 u8 bEnabled;
75d0: 20 20 20 20 20 20 20 20 2f 2a 20 46 61 6c 73 65 /* False
75e0: 20 74 6f 20 64 69 73 61 62 6c 65 20 6e 65 77 20 to disable new
75f0: 6c 6f 6f 6b 61 73 69 64 65 20 61 6c 6c 6f 63 61 lookaside alloca
7600: 74 69 6f 6e 73 20 2a 2f 0a 20 20 75 38 20 62 4d tions */. u8 bM
7610: 61 6c 6c 6f 63 65 64 3b 20 20 20 20 20 20 20 20 alloced;
7620: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 70 53 /* True if pS
7630: 74 61 72 74 20 6f 62 74 61 69 6e 65 64 20 66 72 tart obtained fr
7640: 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f om sqlite3_mallo
7650: 63 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 c() */. int nOu
7660: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
7670: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 75 /* Number of bu
7680: 66 66 65 72 73 20 63 75 72 72 65 6e 74 6c 79 20 ffers currently
7690: 63 68 65 63 6b 65 64 20 6f 75 74 20 2a 2f 0a 20 checked out */.
76a0: 20 69 6e 74 20 6d 78 4f 75 74 3b 20 20 20 20 20 int mxOut;
76b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 69 67 68 /* High
76c0: 77 61 74 65 72 20 6d 61 72 6b 20 66 6f 72 20 6e water mark for n
76d0: 4f 75 74 20 2a 2f 0a 20 20 69 6e 74 20 61 6e 53 Out */. int anS
76e0: 74 61 74 5b 33 5d 3b 20 20 20 20 20 20 20 20 20 tat[3];
76f0: 20 2f 2a 20 30 3a 20 68 69 74 73 2e 20 20 31 3a /* 0: hits. 1:
7700: 20 73 69 7a 65 20 6d 69 73 73 65 73 2e 20 20 32 size misses. 2
7710: 3a 20 66 75 6c 6c 20 6d 69 73 73 65 73 20 2a 2f : full misses */
7720: 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 . LookasideSlot
7730: 20 2a 70 46 72 65 65 3b 20 20 20 2f 2a 20 4c 69 *pFree; /* Li
7740: 73 74 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 st of available
7750: 62 75 66 66 65 72 73 20 2a 2f 0a 20 20 76 6f 69 buffers */. voi
7760: 64 20 2a 70 53 74 61 72 74 3b 20 20 20 20 20 20 d *pStart;
7770: 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 /* First by
7780: 74 65 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 te of available
7790: 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a memory space */.
77a0: 20 20 76 6f 69 64 20 2a 70 45 6e 64 3b 20 20 20 void *pEnd;
77b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
77c0: 73 74 20 62 79 74 65 20 70 61 73 74 20 65 6e 64 st byte past end
77d0: 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 73 70 of available sp
77e0: 61 63 65 20 2a 2f 0a 7d 3b 0a 73 74 72 75 63 74 ace */.};.struct
77f0: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 7b LookasideSlot {
7800: 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 . LookasideSlot
7810: 20 2a 70 4e 65 78 74 3b 20 20 20 20 2f 2a 20 4e *pNext; /* N
7820: 65 78 74 20 62 75 66 66 65 72 20 69 6e 20 74 68 ext buffer in th
7830: 65 20 6c 69 73 74 20 6f 66 20 66 72 65 65 20 62 e list of free b
7840: 75 66 66 65 72 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a uffers */.};../*
7850: 0a 2a 2a 20 41 20 68 61 73 68 20 74 61 62 6c 65 .** A hash table
7860: 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 for function de
7870: 66 69 6e 69 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a finitions..**.**
7880: 20 48 61 73 68 20 65 61 63 68 20 46 75 6e 63 44 Hash each FuncD
7890: 65 66 20 73 74 72 75 63 74 75 72 65 20 69 6e 74 ef structure int
78a0: 6f 20 6f 6e 65 20 6f 66 20 74 68 65 20 46 75 6e o one of the Fun
78b0: 63 44 65 66 48 61 73 68 2e 61 5b 5d 20 73 6c 6f cDefHash.a[] slo
78c0: 74 73 2e 0a 2a 2a 20 43 6f 6c 6c 69 73 69 6f 6e ts..** Collision
78d0: 73 20 61 72 65 20 6f 6e 20 74 68 65 20 46 75 6e s are on the Fun
78e0: 63 44 65 66 2e 70 48 61 73 68 20 63 68 61 69 6e cDef.pHash chain
78f0: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 46 75 6e 63 ..*/.struct Func
7900: 44 65 66 48 61 73 68 20 7b 0a 20 20 46 75 6e 63 DefHash {. Func
7910: 44 65 66 20 2a 61 5b 32 33 5d 3b 20 20 20 20 20 Def *a[23];
7920: 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 /* Hash table
7930: 66 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f for functions */
7940: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 .};../*.** Each
7950: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
7960: 69 6f 6e 20 69 73 20 61 6e 20 69 6e 73 74 61 6e ion is an instan
7970: 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
7980: 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a ing structure..*
7990: 2f 0a 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 /.struct sqlite3
79a0: 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 {. sqlite3_vfs
79b0: 20 2a 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 *pVfs;
79c0: 20 20 20 2f 2a 20 4f 53 20 49 6e 74 65 72 66 61 /* OS Interfa
79d0: 63 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 56 ce */. struct V
79e0: 64 62 65 20 2a 70 56 64 62 65 3b 20 20 20 20 20 dbe *pVdbe;
79f0: 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 /* List of
7a00: 20 61 63 74 69 76 65 20 76 69 72 74 75 61 6c 20 active virtual
7a10: 6d 61 63 68 69 6e 65 73 20 2a 2f 0a 20 20 43 6f machines */. Co
7a20: 6c 6c 53 65 71 20 2a 70 44 66 6c 74 43 6f 6c 6c llSeq *pDfltColl
7a30: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 ; /* T
7a40: 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 he default colla
7a50: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 20 28 42 ting sequence (B
7a60: 49 4e 41 52 59 29 20 2a 2f 0a 20 20 73 71 6c 69 INARY) */. sqli
7a70: 74 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 te3_mutex *mutex
7a80: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e ; /* Con
7a90: 6e 65 63 74 69 6f 6e 20 6d 75 74 65 78 20 2a 2f nection mutex */
7aa0: 0a 20 20 44 62 20 2a 61 44 62 3b 20 20 20 20 20 . Db *aDb;
7ab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7ac0: 20 2f 2a 20 41 6c 6c 20 62 61 63 6b 65 6e 64 73 /* All backends
7ad0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 44 62 3b 20 20 */. int nDb;
7ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7af0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
7b00: 20 62 61 63 6b 65 6e 64 73 20 63 75 72 72 65 6e backends curren
7b10: 74 6c 79 20 69 6e 20 75 73 65 20 2a 2f 0a 20 20 tly in use */.
7b20: 69 6e 74 20 66 6c 61 67 73 3b 20 20 20 20 20 20 int flags;
7b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7b40: 20 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 66 Miscellaneous f
7b50: 6c 61 67 73 2e 20 53 65 65 20 62 65 6c 6f 77 20 lags. See below
7b60: 2a 2f 0a 20 20 69 36 34 20 6c 61 73 74 52 6f 77 */. i64 lastRow
7b70: 69 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 id;
7b80: 20 20 20 2f 2a 20 52 4f 57 49 44 20 6f 66 20 6d /* ROWID of m
7b90: 6f 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 ost recent inser
7ba0: 74 20 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f t (see above) */
7bb0: 0a 20 20 69 36 34 20 73 7a 4d 6d 61 70 3b 20 20 . i64 szMmap;
7bc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7bd0: 20 2f 2a 20 44 65 66 61 75 6c 74 20 6d 6d 61 70 /* Default mmap
7be0: 5f 73 69 7a 65 20 73 65 74 74 69 6e 67 20 2a 2f _size setting */
7bf0: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 . unsigned int
7c00: 6f 70 65 6e 46 6c 61 67 73 3b 20 20 20 20 20 20 openFlags;
7c10: 20 2f 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 /* Flags passed
7c20: 20 74 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e to sqlite3_vfs.
7c30: 78 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 xOpen() */. int
7c40: 20 65 72 72 43 6f 64 65 3b 20 20 20 20 20 20 20 errCode;
7c50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f /* Mo
7c60: 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 st recent error
7c70: 63 6f 64 65 20 28 53 51 4c 49 54 45 5f 2a 29 20 code (SQLITE_*)
7c80: 2a 2f 0a 20 20 69 6e 74 20 65 72 72 4d 61 73 6b */. int errMask
7c90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7ca0: 20 20 20 2f 2a 20 26 20 72 65 73 75 6c 74 20 63 /* & result c
7cb0: 6f 64 65 73 20 77 69 74 68 20 74 68 69 73 20 62 odes with this b
7cc0: 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 efore returning
7cd0: 2a 2f 0a 20 20 75 31 36 20 64 62 4f 70 74 46 6c */. u16 dbOptFl
7ce0: 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
7cf0: 20 20 20 2f 2a 20 46 6c 61 67 73 20 74 6f 20 65 /* Flags to e
7d00: 6e 61 62 6c 65 2f 64 69 73 61 62 6c 65 20 6f 70 nable/disable op
7d10: 74 69 6d 69 7a 61 74 69 6f 6e 73 20 2a 2f 0a 20 timizations */.
7d20: 20 75 38 20 61 75 74 6f 43 6f 6d 6d 69 74 3b 20 u8 autoCommit;
7d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
7d40: 2a 20 54 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 * The auto-commi
7d50: 74 20 66 6c 61 67 2e 20 2a 2f 0a 20 20 75 38 20 t flag. */. u8
7d60: 74 65 6d 70 5f 73 74 6f 72 65 3b 20 20 20 20 20 temp_store;
7d70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 31 3a /* 1:
7d80: 20 66 69 6c 65 20 32 3a 20 6d 65 6d 6f 72 79 20 file 2: memory
7d90: 30 3a 20 64 65 66 61 75 6c 74 20 2a 2f 0a 20 20 0: default */.
7da0: 75 38 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 3b u8 mallocFailed;
7db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
7dc0: 20 54 72 75 65 20 69 66 20 77 65 20 68 61 76 65 True if we have
7dd0: 20 73 65 65 6e 20 61 20 6d 61 6c 6c 6f 63 20 66 seen a malloc f
7de0: 61 69 6c 75 72 65 20 2a 2f 0a 20 20 75 38 20 64 ailure */. u8 d
7df0: 66 6c 74 4c 6f 63 6b 4d 6f 64 65 3b 20 20 20 20 fltLockMode;
7e00: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 /* Def
7e10: 61 75 6c 74 20 6c 6f 63 6b 69 6e 67 2d 6d 6f 64 ault locking-mod
7e20: 65 20 66 6f 72 20 61 74 74 61 63 68 65 64 20 64 e for attached d
7e30: 62 73 20 2a 2f 0a 20 20 73 69 67 6e 65 64 20 63 bs */. signed c
7e40: 68 61 72 20 6e 65 78 74 41 75 74 6f 76 61 63 3b har nextAutovac;
7e50: 20 20 20 20 20 20 2f 2a 20 41 75 74 6f 76 61 63 /* Autovac
7e60: 20 73 65 74 74 69 6e 67 20 61 66 74 65 72 20 56 setting after V
7e70: 41 43 55 55 4d 20 69 66 20 3e 3d 30 20 2a 2f 0a ACUUM if >=0 */.
7e80: 20 20 75 38 20 73 75 70 70 72 65 73 73 45 72 72 u8 suppressErr
7e90: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
7ea0: 2f 2a 20 44 6f 20 6e 6f 74 20 69 73 73 75 65 20 /* Do not issue
7eb0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69 error messages i
7ec0: 66 20 74 72 75 65 20 2a 2f 0a 20 20 75 38 20 76 f true */. u8 v
7ed0: 74 61 62 4f 6e 43 6f 6e 66 6c 69 63 74 3b 20 20 tabOnConflict;
7ee0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c /* Val
7ef0: 75 65 20 74 6f 20 72 65 74 75 72 6e 20 66 6f 72 ue to return for
7f00: 20 73 33 5f 76 74 61 62 5f 6f 6e 5f 63 6f 6e 66 s3_vtab_on_conf
7f10: 6c 69 63 74 28 29 20 2a 2f 0a 20 20 75 38 20 69 lict() */. u8 i
7f20: 73 54 72 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 sTransactionSave
7f30: 70 6f 69 6e 74 3b 20 20 20 20 2f 2a 20 54 72 75 point; /* Tru
7f40: 65 20 69 66 20 74 68 65 20 6f 75 74 65 72 6d 6f e if the outermo
7f50: 73 74 20 73 61 76 65 70 6f 69 6e 74 20 69 73 20 st savepoint is
7f60: 61 20 54 53 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 a TS */. int ne
7f70: 78 74 50 61 67 65 73 69 7a 65 3b 20 20 20 20 20 xtPagesize;
7f80: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 67 65 73 /* Pages
7f90: 69 7a 65 20 61 66 74 65 72 20 56 41 43 55 55 4d ize after VACUUM
7fa0: 20 69 66 20 3e 30 20 2a 2f 0a 20 20 75 33 32 20 if >0 */. u32
7fb0: 6d 61 67 69 63 3b 20 20 20 20 20 20 20 20 20 20 magic;
7fc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 67 /* Mag
7fd0: 69 63 20 6e 75 6d 62 65 72 20 66 6f 72 20 64 65 ic number for de
7fe0: 74 65 63 74 20 6c 69 62 72 61 72 79 20 6d 69 73 tect library mis
7ff0: 75 73 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 68 use */. int nCh
8000: 61 6e 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 ange;
8010: 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 /* Value
8020: 72 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 returned by sqli
8030: 74 65 33 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f te3_changes() */
8040: 0a 20 20 69 6e 74 20 6e 54 6f 74 61 6c 43 68 61 . int nTotalCha
8050: 6e 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 nge;
8060: 20 2f 2a 20 56 61 6c 75 65 20 72 65 74 75 72 6e /* Value return
8070: 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 74 6f ed by sqlite3_to
8080: 74 61 6c 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f tal_changes() */
8090: 0a 20 20 69 6e 74 20 61 4c 69 6d 69 74 5b 53 51 . int aLimit[SQ
80a0: 4c 49 54 45 5f 4e 5f 4c 49 4d 49 54 5d 3b 20 20 LITE_N_LIMIT];
80b0: 20 2f 2a 20 4c 69 6d 69 74 73 20 2a 2f 0a 20 20 /* Limits */.
80c0: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 49 6e struct sqlite3In
80d0: 69 74 49 6e 66 6f 20 7b 20 20 20 20 20 20 2f 2a itInfo { /*
80e0: 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 Information use
80f0: 64 20 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c d during initial
8100: 69 7a 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 ization */. i
8110: 6e 74 20 6e 65 77 54 6e 75 6d 3b 20 20 20 20 20 nt newTnum;
8120: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f /* Ro
8130: 6f 74 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 otpage of table
8140: 62 65 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 being initialize
8150: 64 20 2a 2f 0a 20 20 20 20 75 38 20 69 44 62 3b d */. u8 iDb;
8160: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8170: 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 64 62 /* Which db
8180: 20 66 69 6c 65 20 69 73 20 62 65 69 6e 67 20 69 file is being i
8190: 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 nitialized */.
81a0: 20 20 75 38 20 62 75 73 79 3b 20 20 20 20 20 20 u8 busy;
81b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
81c0: 20 54 52 55 45 20 69 66 20 63 75 72 72 65 6e 74 TRUE if current
81d0: 6c 79 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 ly initializing
81e0: 2a 2f 0a 20 20 20 20 75 38 20 6f 72 70 68 61 6e */. u8 orphan
81f0: 54 72 69 67 67 65 72 3b 20 20 20 20 20 20 20 20 Trigger;
8200: 20 20 20 2f 2a 20 4c 61 73 74 20 73 74 61 74 65 /* Last state
8210: 6d 65 6e 74 20 69 73 20 6f 72 70 68 61 6e 65 64 ment is orphaned
8220: 20 54 45 4d 50 20 74 72 69 67 67 65 72 20 2a 2f TEMP trigger */
8230: 0a 20 20 7d 20 69 6e 69 74 3b 0a 20 20 69 6e 74 . } init;. int
8240: 20 6e 56 64 62 65 41 63 74 69 76 65 3b 20 20 20 nVdbeActive;
8250: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
8260: 6d 62 65 72 20 6f 66 20 56 44 42 45 73 20 63 75 mber of VDBEs cu
8270: 72 72 65 6e 74 6c 79 20 72 75 6e 6e 69 6e 67 20 rrently running
8280: 2a 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 52 65 */. int nVdbeRe
8290: 61 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ad;
82a0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
82b0: 61 63 74 69 76 65 20 56 44 42 45 73 20 74 68 61 active VDBEs tha
82c0: 74 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 t read or write
82d0: 2a 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 57 72 */. int nVdbeWr
82e0: 69 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ite;
82f0: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
8300: 61 63 74 69 76 65 20 56 44 42 45 73 20 74 68 61 active VDBEs tha
8310: 74 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 t read and write
8320: 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 45 */. int nVdbeE
8330: 78 65 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 xec;
8340: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
8350: 20 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f nested calls to
8360: 20 56 64 62 65 45 78 65 63 28 29 20 2a 2f 0a 20 VdbeExec() */.
8370: 20 69 6e 74 20 6e 45 78 74 65 6e 73 69 6f 6e 3b int nExtension;
8380: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8390: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 6f 61 64 * Number of load
83a0: 65 64 20 65 78 74 65 6e 73 69 6f 6e 73 20 2a 2f ed extensions */
83b0: 0a 20 20 76 6f 69 64 20 2a 2a 61 45 78 74 65 6e . void **aExten
83c0: 73 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 20 sion;
83d0: 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 73 68 61 /* Array of sha
83e0: 72 65 64 20 6c 69 62 72 61 72 79 20 68 61 6e 64 red library hand
83f0: 6c 65 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a les */. void (*
8400: 78 54 72 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f xTrace)(void*,co
8410: 6e 73 74 20 63 68 61 72 2a 29 3b 20 20 20 20 20 nst char*);
8420: 20 20 20 2f 2a 20 54 72 61 63 65 20 66 75 6e 63 /* Trace func
8430: 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a tion */. void *
8440: 70 54 72 61 63 65 41 72 67 3b 20 20 20 20 20 20 pTraceArg;
8450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8460: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
8470: 74 6f 20 74 68 65 20 74 72 61 63 65 20 66 75 6e to the trace fun
8480: 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 ction */. void
8490: 28 2a 78 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 (*xProfile)(void
84a0: 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 36 *,const char*,u6
84b0: 34 29 3b 20 20 2f 2a 20 50 72 6f 66 69 6c 69 6e 4); /* Profilin
84c0: 67 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 g function */.
84d0: 76 6f 69 64 20 2a 70 50 72 6f 66 69 6c 65 41 72 void *pProfileAr
84e0: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
84f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 /* Arg
8500: 75 6d 65 6e 74 20 74 6f 20 70 72 6f 66 69 6c 65 ument to profile
8510: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 function */. v
8520: 6f 69 64 20 2a 70 43 6f 6d 6d 69 74 41 72 67 3b oid *pCommitArg;
8530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8540: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
8550: 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 xCommitCallback(
8560: 29 20 2a 2f 20 20 20 0a 20 20 69 6e 74 20 28 2a ) */ . int (*
8570: 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 29 xCommitCallback)
8580: 28 76 6f 69 64 2a 29 3b 20 20 20 20 2f 2a 20 49 (void*); /* I
8590: 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 nvoked at every
85a0: 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 commit. */. voi
85b0: 64 20 2a 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b d *pRollbackArg;
85c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
85d0: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 52 * Argument to xR
85e0: 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 ollbackCallback(
85f0: 29 20 2a 2f 20 20 20 0a 20 20 76 6f 69 64 20 28 ) */ . void (
8600: 2a 78 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 *xRollbackCallba
8610: 63 6b 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 49 ck)(void*); /* I
8620: 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 nvoked at every
8630: 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 commit. */. voi
8640: 64 20 2a 70 55 70 64 61 74 65 41 72 67 3b 0a 20 d *pUpdateArg;.
8650: 20 76 6f 69 64 20 28 2a 78 55 70 64 61 74 65 43 void (*xUpdateC
8660: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 allback)(void*,i
8670: 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c nt, const char*,
8680: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 const char*,sqli
8690: 74 65 5f 69 6e 74 36 34 29 3b 0a 23 69 66 6e 64 te_int64);.#ifnd
86a0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 ef SQLITE_OMIT_W
86b0: 41 4c 0a 20 20 69 6e 74 20 28 2a 78 57 61 6c 43 AL. int (*xWalC
86c0: 61 6c 6c 62 61 63 6b 29 28 76 6f 69 64 20 2a 2c allback)(void *,
86d0: 20 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 sqlite3 *, cons
86e0: 74 20 63 68 61 72 20 2a 2c 20 69 6e 74 29 3b 0a t char *, int);.
86f0: 20 20 76 6f 69 64 20 2a 70 57 61 6c 41 72 67 3b void *pWalArg;
8700: 0a 23 65 6e 64 69 66 0a 20 20 76 6f 69 64 28 2a .#endif. void(*
8710: 78 43 6f 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 xCollNeeded)(voi
8720: 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 d*,sqlite3*,int
8730: 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 eTextRep,const c
8740: 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 28 2a 78 har*);. void(*x
8750: 43 6f 6c 6c 4e 65 65 64 65 64 31 36 29 28 76 6f CollNeeded16)(vo
8760: 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 id*,sqlite3*,int
8770: 20 65 54 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 eTextRep,const
8780: 76 6f 69 64 2a 29 3b 0a 20 20 76 6f 69 64 20 2a void*);. void *
8790: 70 43 6f 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a pCollNeededArg;.
87a0: 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 sqlite3_value
87b0: 2a 70 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 *pErr;
87c0: 2f 2a 20 4d 6f 73 74 20 72 65 63 65 6e 74 20 65 /* Most recent e
87d0: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a 2f 0a rror message */.
87e0: 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 76 6f union {. vo
87f0: 6c 61 74 69 6c 65 20 69 6e 74 20 69 73 49 6e 74 latile int isInt
8800: 65 72 72 75 70 74 65 64 3b 20 2f 2a 20 54 72 75 errupted; /* Tru
8810: 65 20 69 66 20 73 71 6c 69 74 65 33 5f 69 6e 74 e if sqlite3_int
8820: 65 72 72 75 70 74 20 68 61 73 20 62 65 65 6e 20 errupt has been
8830: 63 61 6c 6c 65 64 20 2a 2f 0a 20 20 20 20 64 6f called */. do
8840: 75 62 6c 65 20 6e 6f 74 55 73 65 64 31 3b 20 20 uble notUsed1;
8850: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61 /* Spa
8860: 63 65 72 20 2a 2f 0a 20 20 7d 20 75 31 3b 0a 20 cer */. } u1;.
8870: 20 4c 6f 6f 6b 61 73 69 64 65 20 6c 6f 6f 6b 61 Lookaside looka
8880: 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 2f side; /
8890: 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c * Lookaside mall
88a0: 6f 63 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e oc configuration
88b0: 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */.#ifndef SQLI
88c0: 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a TE_OMIT_AUTHORIZ
88d0: 41 54 49 4f 4e 0a 20 20 69 6e 74 20 28 2a 78 41 ATION. int (*xA
88e0: 75 74 68 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 uth)(void*,int,c
88f0: 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 onst char*,const
8900: 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 char*,const cha
8910: 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b r*,const char*);
8920: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
8930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8940: 20 2f 2a 20 41 63 63 65 73 73 20 61 75 74 68 6f /* Access autho
8950: 72 69 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f rization functio
8960: 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 75 n */. void *pAu
8970: 74 68 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 thArg;
8980: 20 20 20 20 20 2f 2a 20 31 73 74 20 61 72 67 75 /* 1st argu
8990: 6d 65 6e 74 20 74 6f 20 74 68 65 20 61 63 63 65 ment to the acce
89a0: 73 73 20 61 75 74 68 20 66 75 6e 63 74 69 6f 6e ss auth function
89b0: 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 */.#endif.#ifnd
89c0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 50 ef SQLITE_OMIT_P
89d0: 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 43 4b ROGRESS_CALLBACK
89e0: 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 72 65 . int (*xProgre
89f0: 73 73 29 28 76 6f 69 64 20 2a 29 3b 20 20 20 20 ss)(void *);
8a00: 20 2f 2a 20 54 68 65 20 70 72 6f 67 72 65 73 73 /* The progress
8a10: 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 callback */. v
8a20: 6f 69 64 20 2a 70 50 72 6f 67 72 65 73 73 41 72 oid *pProgressAr
8a30: 67 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 g; /*
8a40: 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 Argument to the
8a50: 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 progress callbac
8a60: 6b 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 k */. unsigned
8a70: 6e 50 72 6f 67 72 65 73 73 4f 70 73 3b 20 20 20 nProgressOps;
8a80: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
8a90: 66 20 6f 70 63 6f 64 65 73 20 66 6f 72 20 70 72 f opcodes for pr
8aa0: 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 ogress callback
8ab0: 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 */.#endif.#ifnde
8ac0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
8ad0: 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69 6e 74 RTUALTABLE. int
8ae0: 20 6e 56 54 72 61 6e 73 3b 20 20 20 20 20 20 20 nVTrans;
8af0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c /* Al
8b00: 6c 6f 63 61 74 65 64 20 73 69 7a 65 20 6f 66 20 located size of
8b10: 61 56 54 72 61 6e 73 20 2a 2f 0a 20 20 48 61 73 aVTrans */. Has
8b20: 68 20 61 4d 6f 64 75 6c 65 3b 20 20 20 20 20 20 h aModule;
8b30: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 6f /* po
8b40: 70 75 6c 61 74 65 64 20 62 79 20 73 71 6c 69 74 pulated by sqlit
8b50: 65 33 5f 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 e3_create_module
8b60: 28 29 20 2a 2f 0a 20 20 56 74 61 62 43 74 78 20 () */. VtabCtx
8b70: 2a 70 56 74 61 62 43 74 78 3b 20 20 20 20 20 20 *pVtabCtx;
8b80: 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74 /* Context
8b90: 20 66 6f 72 20 61 63 74 69 76 65 20 76 74 61 62 for active vtab
8ba0: 20 63 6f 6e 6e 65 63 74 2f 63 72 65 61 74 65 20 connect/create
8bb0: 2a 2f 0a 20 20 56 54 61 62 6c 65 20 2a 2a 61 56 */. VTable **aV
8bc0: 54 72 61 6e 73 3b 20 20 20 20 20 20 20 20 20 20 Trans;
8bd0: 20 20 20 2f 2a 20 56 69 72 74 75 61 6c 20 74 61 /* Virtual ta
8be0: 62 6c 65 73 20 77 69 74 68 20 6f 70 65 6e 20 74 bles with open t
8bf0: 72 61 6e 73 61 63 74 69 6f 6e 73 20 2a 2f 0a 20 ransactions */.
8c00: 20 56 54 61 62 6c 65 20 2a 70 44 69 73 63 6f 6e VTable *pDiscon
8c10: 6e 65 63 74 3b 20 20 20 20 2f 2a 20 44 69 73 63 nect; /* Disc
8c20: 6f 6e 6e 65 63 74 20 74 68 65 73 65 20 69 6e 20 onnect these in
8c30: 6e 65 78 74 20 73 71 6c 69 74 65 33 5f 70 72 65 next sqlite3_pre
8c40: 70 61 72 65 28 29 20 2a 2f 0a 23 65 6e 64 69 66 pare() */.#endif
8c50: 0a 20 20 46 75 6e 63 44 65 66 48 61 73 68 20 61 . FuncDefHash a
8c60: 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 Func;
8c70: 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 6f /* Hash table o
8c80: 66 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 66 75 6e f connection fun
8c90: 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 48 61 73 68 ctions */. Hash
8ca0: 20 61 43 6f 6c 6c 53 65 71 3b 20 20 20 20 20 20 aCollSeq;
8cb0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c /* All
8cc0: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 collating seque
8cd0: 6e 63 65 73 20 2a 2f 0a 20 20 42 75 73 79 48 61 nces */. BusyHa
8ce0: 6e 64 6c 65 72 20 62 75 73 79 48 61 6e 64 6c 65 ndler busyHandle
8cf0: 72 3b 20 20 20 20 20 20 2f 2a 20 42 75 73 79 20 r; /* Busy
8d00: 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 44 62 callback */. Db
8d10: 20 61 44 62 53 74 61 74 69 63 5b 32 5d 3b 20 20 aDbStatic[2];
8d20: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
8d30: 74 61 74 69 63 20 73 70 61 63 65 20 66 6f 72 20 tatic space for
8d40: 74 68 65 20 32 20 64 65 66 61 75 6c 74 20 62 61 the 2 default ba
8d50: 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 53 61 76 65 ckends */. Save
8d60: 70 6f 69 6e 74 20 2a 70 53 61 76 65 70 6f 69 6e point *pSavepoin
8d70: 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 t; /* Lis
8d80: 74 20 6f 66 20 61 63 74 69 76 65 20 73 61 76 65 t of active save
8d90: 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 points */. int
8da0: 62 75 73 79 54 69 6d 65 6f 75 74 3b 20 20 20 20 busyTimeout;
8db0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 75 73 /* Bus
8dc0: 79 20 68 61 6e 64 6c 65 72 20 74 69 6d 65 6f 75 y handler timeou
8dd0: 74 2c 20 69 6e 20 6d 73 65 63 20 2a 2f 0a 20 20 t, in msec */.
8de0: 69 6e 74 20 6e 53 61 76 65 70 6f 69 6e 74 3b 20 int nSavepoint;
8df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
8e00: 20 4e 75 6d 62 65 72 20 6f 66 20 6e 6f 6e 2d 74 Number of non-t
8e10: 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 65 70 ransaction savep
8e20: 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 20 6e oints */. int n
8e30: 53 74 61 74 65 6d 65 6e 74 3b 20 20 20 20 20 20 Statement;
8e40: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
8e50: 65 72 20 6f 66 20 6e 65 73 74 65 64 20 73 74 61 er of nested sta
8e60: 74 65 6d 65 6e 74 2d 74 72 61 6e 73 61 63 74 69 tement-transacti
8e70: 6f 6e 73 20 20 2a 2f 0a 20 20 69 36 34 20 6e 44 ons */. i64 nD
8e80: 65 66 65 72 72 65 64 43 6f 6e 73 3b 20 20 20 20 eferredCons;
8e90: 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 74 20 64 /* Net d
8ea0: 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 eferred constrai
8eb0: 6e 74 73 20 74 68 69 73 20 74 72 61 6e 73 61 63 nts this transac
8ec0: 74 69 6f 6e 2e 20 2a 2f 0a 20 20 69 36 34 20 6e tion. */. i64 n
8ed0: 44 65 66 65 72 72 65 64 49 6d 6d 43 6f 6e 73 3b DeferredImmCons;
8ee0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 74 20 /* Net
8ef0: 64 65 66 65 72 72 65 64 20 69 6d 6d 65 64 69 61 deferred immedia
8f00: 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a te constraints *
8f10: 2f 0a 20 20 69 6e 74 20 2a 70 6e 42 79 74 65 73 /. int *pnBytes
8f20: 46 72 65 65 64 3b 20 20 20 20 20 20 20 20 20 20 Freed;
8f30: 20 20 2f 2a 20 49 66 20 6e 6f 74 20 4e 55 4c 4c /* If not NULL
8f40: 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 69 73 , increment this
8f50: 20 69 6e 20 44 62 46 72 65 65 28 29 20 2a 2f 0a in DbFree() */.
8f60: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
8f70: 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 NABLE_UNLOCK_NOT
8f80: 49 46 59 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c IFY. /* The fol
8f90: 6c 6f 77 69 6e 67 20 76 61 72 69 61 62 6c 65 73 lowing variables
8fa0: 20 61 72 65 20 61 6c 6c 20 70 72 6f 74 65 63 74 are all protect
8fb0: 65 64 20 62 79 20 74 68 65 20 53 54 41 54 49 43 ed by the STATIC
8fc0: 5f 4d 41 53 54 45 52 20 0a 20 20 2a 2a 20 6d 75 _MASTER . ** mu
8fd0: 74 65 78 2c 20 6e 6f 74 20 62 79 20 73 71 6c 69 tex, not by sqli
8fe0: 74 65 33 2e 6d 75 74 65 78 2e 20 54 68 65 79 20 te3.mutex. They
8ff0: 61 72 65 20 75 73 65 64 20 62 79 20 63 6f 64 65 are used by code
9000: 20 69 6e 20 6e 6f 74 69 66 79 2e 63 2e 20 0a 20 in notify.c. .
9010: 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 2e **. ** When X.
9020: 70 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 6f pUnlockConnectio
9030: 6e 3d 3d 59 2c 20 74 68 61 74 20 6d 65 61 6e 73 n==Y, that means
9040: 20 74 68 61 74 20 58 20 69 73 20 77 61 69 74 69 that X is waiti
9050: 6e 67 20 66 6f 72 20 59 20 74 6f 0a 20 20 2a 2a ng for Y to. **
9060: 20 75 6e 6c 6f 63 6b 20 73 6f 20 74 68 61 74 20 unlock so that
9070: 69 74 20 63 61 6e 20 70 72 6f 63 65 65 64 2e 0a it can proceed..
9080: 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 **. ** When X
9090: 2e 70 42 6c 6f 63 6b 69 6e 67 43 6f 6e 6e 65 63 .pBlockingConnec
90a0: 74 69 6f 6e 3d 3d 59 2c 20 74 68 61 74 20 6d 65 tion==Y, that me
90b0: 61 6e 73 20 74 68 61 74 20 73 6f 6d 65 74 68 69 ans that somethi
90c0: 6e 67 20 74 68 61 74 20 58 20 74 72 69 65 64 0a ng that X tried.
90d0: 20 20 2a 2a 20 74 72 69 65 64 20 74 6f 20 64 6f ** tried to do
90e0: 20 72 65 63 65 6e 74 6c 79 20 66 61 69 6c 65 64 recently failed
90f0: 20 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f with an SQLITE_
9100: 4c 4f 43 4b 45 44 20 65 72 72 6f 72 20 64 75 65 LOCKED error due
9110: 20 74 6f 20 6c 6f 63 6b 73 0a 20 20 2a 2a 20 68 to locks. ** h
9120: 65 6c 64 20 62 79 20 59 2e 0a 20 20 2a 2f 0a 20 eld by Y.. */.
9130: 20 73 71 6c 69 74 65 33 20 2a 70 42 6c 6f 63 6b sqlite3 *pBlock
9140: 69 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3b 20 2f ingConnection; /
9150: 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 68 61 * Connection tha
9160: 74 20 63 61 75 73 65 64 20 53 51 4c 49 54 45 5f t caused SQLITE_
9170: 4c 4f 43 4b 45 44 20 2a 2f 0a 20 20 73 71 6c 69 LOCKED */. sqli
9180: 74 65 33 20 2a 70 55 6e 6c 6f 63 6b 43 6f 6e 6e te3 *pUnlockConn
9190: 65 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 ection;
91a0: 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 /* Connection
91b0: 74 6f 20 77 61 74 63 68 20 66 6f 72 20 75 6e 6c to watch for unl
91c0: 6f 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ock */. void *p
91d0: 55 6e 6c 6f 63 6b 41 72 67 3b 20 20 20 20 20 20 UnlockArg;
91e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
91f0: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 55 * Argument to xU
9200: 6e 6c 6f 63 6b 4e 6f 74 69 66 79 20 2a 2f 0a 20 nlockNotify */.
9210: 20 76 6f 69 64 20 28 2a 78 55 6e 6c 6f 63 6b 4e void (*xUnlockN
9220: 6f 74 69 66 79 29 28 76 6f 69 64 20 2a 2a 2c 20 otify)(void **,
9230: 69 6e 74 29 3b 20 20 2f 2a 20 55 6e 6c 6f 63 6b int); /* Unlock
9240: 20 6e 6f 74 69 66 79 20 63 61 6c 6c 62 61 63 6b notify callback
9250: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 */. sqlite3 *p
9260: 4e 65 78 74 42 6c 6f 63 6b 65 64 3b 20 20 20 20 NextBlocked;
9270: 20 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 6c /* Next in l
9280: 69 73 74 20 6f 66 20 61 6c 6c 20 62 6c 6f 63 6b ist of all block
9290: 65 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a ed connections *
92a0: 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a /.#endif.};../*.
92b0: 2a 2a 20 41 20 6d 61 63 72 6f 20 74 6f 20 64 69 ** A macro to di
92c0: 73 63 6f 76 65 72 20 74 68 65 20 65 6e 63 6f 64 scover the encod
92d0: 69 6e 67 20 6f 66 20 61 20 64 61 74 61 62 61 73 ing of a databas
92e0: 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 4e e..*/.#define EN
92f0: 43 28 64 62 29 20 28 28 64 62 29 2d 3e 61 44 62 C(db) ((db)->aDb
9300: 5b 30 5d 2e 70 53 63 68 65 6d 61 2d 3e 65 6e 63 [0].pSchema->enc
9310: 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c )../*.** Possibl
9320: 65 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 e values for the
9330: 20 73 71 6c 69 74 65 33 2e 66 6c 61 67 73 2e 0a sqlite3.flags..
9340: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
9350: 45 5f 56 64 62 65 54 72 61 63 65 20 20 20 20 20 E_VdbeTrace
9360: 20 30 78 30 30 30 30 30 30 30 31 20 20 2f 2a 20 0x00000001 /*
9370: 54 72 75 65 20 74 6f 20 74 72 61 63 65 20 56 44 True to trace VD
9380: 42 45 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f 0a BE execution */.
9390: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 #define SQLITE_I
93a0: 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 20 30 78 nternChanges 0x
93b0: 30 30 30 30 30 30 30 32 20 20 2f 2a 20 55 6e 63 00000002 /* Unc
93c0: 6f 6d 6d 69 74 74 65 64 20 48 61 73 68 20 74 61 ommitted Hash ta
93d0: 62 6c 65 20 63 68 61 6e 67 65 73 20 2a 2f 0a 23 ble changes */.#
93e0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 75 define SQLITE_Fu
93f0: 6c 6c 46 53 79 6e 63 20 20 20 20 20 20 30 78 30 llFSync 0x0
9400: 30 30 30 30 30 30 34 20 20 2f 2a 20 55 73 65 20 0000004 /* Use
9410: 66 75 6c 6c 20 66 73 79 6e 63 20 6f 6e 20 74 68 full fsync on th
9420: 65 20 62 61 63 6b 65 6e 64 20 2a 2f 0a 23 64 65 e backend */.#de
9430: 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6b 70 74 fine SQLITE_Ckpt
9440: 46 75 6c 6c 46 53 79 6e 63 20 20 30 78 30 30 30 FullFSync 0x000
9450: 30 30 30 30 38 20 20 2f 2a 20 55 73 65 20 66 75 00008 /* Use fu
9460: 6c 6c 20 66 73 79 6e 63 20 66 6f 72 20 63 68 65 ll fsync for che
9470: 63 6b 70 6f 69 6e 74 20 2a 2f 0a 23 64 65 66 69 ckpoint */.#defi
9480: 6e 65 20 53 51 4c 49 54 45 5f 43 61 63 68 65 53 ne SQLITE_CacheS
9490: 70 69 6c 6c 20 20 20 20 20 30 78 30 30 30 30 30 pill 0x00000
94a0: 30 31 30 20 20 2f 2a 20 4f 4b 20 74 6f 20 73 70 010 /* OK to sp
94b0: 69 6c 6c 20 70 61 67 65 72 20 63 61 63 68 65 20 ill pager cache
94c0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
94d0: 45 5f 46 75 6c 6c 43 6f 6c 4e 61 6d 65 73 20 20 E_FullColNames
94e0: 20 30 78 30 30 30 30 30 30 32 30 20 20 2f 2a 20 0x00000020 /*
94f0: 53 68 6f 77 20 66 75 6c 6c 20 63 6f 6c 75 6d 6e Show full column
9500: 20 6e 61 6d 65 73 20 6f 6e 20 53 45 4c 45 43 54 names on SELECT
9510: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
9520: 54 45 5f 53 68 6f 72 74 43 6f 6c 4e 61 6d 65 73 TE_ShortColNames
9530: 20 20 30 78 30 30 30 30 30 30 34 30 20 20 2f 2a 0x00000040 /*
9540: 20 53 68 6f 77 20 73 68 6f 72 74 20 63 6f 6c 75 Show short colu
9550: 6d 6e 73 20 6e 61 6d 65 73 20 2a 2f 0a 23 64 65 mns names */.#de
9560: 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6f 75 6e fine SQLITE_Coun
9570: 74 52 6f 77 73 20 20 20 20 20 20 30 78 30 30 30 tRows 0x000
9580: 30 30 30 38 30 20 20 2f 2a 20 43 6f 75 6e 74 20 00080 /* Count
9590: 72 6f 77 73 20 63 68 61 6e 67 65 64 20 62 79 20 rows changed by
95a0: 49 4e 53 45 52 54 2c 20 2a 2f 0a 20 20 20 20 20 INSERT, */.
95b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
95c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
95d0: 20 20 20 20 20 2f 2a 20 20 20 44 45 4c 45 54 45 /* DELETE
95e0: 2c 20 6f 72 20 55 50 44 41 54 45 20 61 6e 64 20 , or UPDATE and
95f0: 72 65 74 75 72 6e 20 2a 2f 0a 20 20 20 20 20 20 return */.
9600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9620: 20 20 20 20 2f 2a 20 20 20 74 68 65 20 63 6f 75 /* the cou
9630: 6e 74 20 75 73 69 6e 67 20 61 20 63 61 6c 6c 62 nt using a callb
9640: 61 63 6b 2e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ack. */.#define
9650: 53 51 4c 49 54 45 5f 4e 75 6c 6c 43 61 6c 6c 62 SQLITE_NullCallb
9660: 61 63 6b 20 20 20 30 78 30 30 30 30 30 31 30 30 ack 0x00000100
9670: 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 65 20 /* Invoke the
9680: 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20 69 66 callback once if
9690: 20 74 68 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 the */.
96a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
96b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
96c0: 20 20 2f 2a 20 20 20 72 65 73 75 6c 74 20 73 65 /* result se
96d0: 74 20 69 73 20 65 6d 70 74 79 20 2a 2f 0a 23 64 t is empty */.#d
96e0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 71 6c efine SQLITE_Sql
96f0: 54 72 61 63 65 20 20 20 20 20 20 20 30 78 30 30 Trace 0x00
9700: 30 30 30 32 30 30 20 20 2f 2a 20 44 65 62 75 67 000200 /* Debug
9710: 20 70 72 69 6e 74 20 53 51 4c 20 61 73 20 69 74 print SQL as it
9720: 20 65 78 65 63 75 74 65 73 20 2a 2f 0a 23 64 65 executes */.#de
9730: 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 62 65 fine SQLITE_Vdbe
9740: 4c 69 73 74 69 6e 67 20 20 20 20 30 78 30 30 30 Listing 0x000
9750: 30 30 34 30 30 20 20 2f 2a 20 44 65 62 75 67 20 00400 /* Debug
9760: 6c 69 73 74 69 6e 67 73 20 6f 66 20 56 44 42 45 listings of VDBE
9770: 20 70 72 6f 67 72 61 6d 73 20 2a 2f 0a 23 64 65 programs */.#de
9780: 66 69 6e 65 20 53 51 4c 49 54 45 5f 57 72 69 74 fine SQLITE_Writ
9790: 65 53 63 68 65 6d 61 20 20 20 20 30 78 30 30 30 eSchema 0x000
97a0: 30 30 38 30 30 20 20 2f 2a 20 4f 4b 20 74 6f 20 00800 /* OK to
97b0: 75 70 64 61 74 65 20 53 51 4c 49 54 45 5f 4d 41 update SQLITE_MA
97c0: 53 54 45 52 20 2a 2f 0a 23 64 65 66 69 6e 65 20 STER */.#define
97d0: 53 51 4c 49 54 45 5f 56 64 62 65 41 64 64 6f 70 SQLITE_VdbeAddop
97e0: 54 72 61 63 65 20 30 78 30 30 30 30 31 30 30 30 Trace 0x00001000
97f0: 20 20 2f 2a 20 54 72 61 63 65 20 73 71 6c 69 74 /* Trace sqlit
9800: 65 33 56 64 62 65 41 64 64 4f 70 28 29 20 63 61 e3VdbeAddOp() ca
9810: 6c 6c 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 lls */.#define S
9820: 51 4c 49 54 45 5f 49 67 6e 6f 72 65 43 68 65 63 QLITE_IgnoreChec
9830: 6b 73 20 20 20 30 78 30 30 30 30 32 30 30 30 20 ks 0x00002000
9840: 20 2f 2a 20 44 6f 20 6e 6f 74 20 65 6e 66 6f 72 /* Do not enfor
9850: 63 65 20 63 68 65 63 6b 20 63 6f 6e 73 74 72 61 ce check constra
9860: 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ints */.#define
9870: 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d SQLITE_ReadUncom
9880: 6d 69 74 74 65 64 20 30 78 30 30 30 34 30 30 30 mitted 0x0004000
9890: 20 20 2f 2a 20 46 6f 72 20 73 68 61 72 65 64 2d /* For shared-
98a0: 63 61 63 68 65 20 6d 6f 64 65 20 2a 2f 0a 23 64 cache mode */.#d
98b0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 65 67 efine SQLITE_Leg
98c0: 61 63 79 46 69 6c 65 46 6d 74 20 20 30 78 30 30 acyFileFmt 0x00
98d0: 30 30 38 30 30 30 20 20 2f 2a 20 43 72 65 61 74 008000 /* Creat
98e0: 65 20 6e 65 77 20 64 61 74 61 62 61 73 65 73 20 e new databases
98f0: 69 6e 20 66 6f 72 6d 61 74 20 31 20 2a 2f 0a 23 in format 1 */.#
9900: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 define SQLITE_Re
9910: 63 6f 76 65 72 79 4d 6f 64 65 20 20 20 30 78 30 coveryMode 0x0
9920: 30 30 31 30 30 30 30 20 20 2f 2a 20 49 67 6e 6f 0010000 /* Igno
9930: 72 65 20 73 63 68 65 6d 61 20 65 72 72 6f 72 73 re schema errors
9940: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
9950: 54 45 5f 52 65 76 65 72 73 65 4f 72 64 65 72 20 TE_ReverseOrder
9960: 20 20 30 78 30 30 30 32 30 30 30 30 20 20 2f 2a 0x00020000 /*
9970: 20 52 65 76 65 72 73 65 20 75 6e 6f 72 64 65 72 Reverse unorder
9980: 65 64 20 53 45 4c 45 43 54 73 20 2a 2f 0a 23 64 ed SELECTs */.#d
9990: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 63 efine SQLITE_Rec
99a0: 54 72 69 67 67 65 72 73 20 20 20 20 30 78 30 30 Triggers 0x00
99b0: 30 34 30 30 30 30 20 20 2f 2a 20 45 6e 61 62 6c 040000 /* Enabl
99c0: 65 20 72 65 63 75 72 73 69 76 65 20 74 72 69 67 e recursive trig
99d0: 67 65 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 gers */.#define
99e0: 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 SQLITE_ForeignKe
99f0: 79 73 20 20 20 20 30 78 30 30 30 38 30 30 30 30 ys 0x00080000
9a00: 20 20 2f 2a 20 45 6e 66 6f 72 63 65 20 66 6f 72 /* Enforce for
9a10: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 eign key constra
9a20: 69 6e 74 73 20 20 2a 2f 0a 23 64 65 66 69 6e 65 ints */.#define
9a30: 20 53 51 4c 49 54 45 5f 41 75 74 6f 49 6e 64 65 SQLITE_AutoInde
9a40: 78 20 20 20 20 20 20 30 78 30 30 31 30 30 30 30 x 0x0010000
9a50: 30 20 20 2f 2a 20 45 6e 61 62 6c 65 20 61 75 74 0 /* Enable aut
9a60: 6f 6d 61 74 69 63 20 69 6e 64 65 78 65 73 20 2a omatic indexes *
9a70: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
9a80: 5f 50 72 65 66 65 72 42 75 69 6c 74 69 6e 20 20 _PreferBuiltin
9a90: 30 78 30 30 32 30 30 30 30 30 20 20 2f 2a 20 50 0x00200000 /* P
9aa0: 72 65 66 65 72 65 6e 63 65 20 74 6f 20 62 75 69 reference to bui
9ab0: 6c 74 2d 69 6e 20 66 75 6e 63 73 20 2a 2f 0a 23 lt-in funcs */.#
9ac0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 6f define SQLITE_Lo
9ad0: 61 64 45 78 74 65 6e 73 69 6f 6e 20 20 30 78 30 adExtension 0x0
9ae0: 30 34 30 30 30 30 30 20 20 2f 2a 20 45 6e 61 62 0400000 /* Enab
9af0: 6c 65 20 6c 6f 61 64 5f 65 78 74 65 6e 73 69 6f le load_extensio
9b00: 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c n */.#define SQL
9b10: 49 54 45 5f 45 6e 61 62 6c 65 54 72 69 67 67 65 ITE_EnableTrigge
9b20: 72 20 20 30 78 30 30 38 30 30 30 30 30 20 20 2f r 0x00800000 /
9b30: 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 * True to enable
9b40: 20 74 72 69 67 67 65 72 73 20 2a 2f 0a 23 64 65 triggers */.#de
9b50: 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 65 66 65 fine SQLITE_Defe
9b60: 72 46 4b 73 20 20 20 20 20 20 20 30 78 30 31 30 rFKs 0x010
9b70: 30 30 30 30 30 20 20 2f 2a 20 44 65 66 65 72 20 00000 /* Defer
9b80: 61 6c 6c 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e all FK constrain
9b90: 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ts */.#define SQ
9ba0: 4c 49 54 45 5f 51 75 65 72 79 4f 6e 6c 79 20 20 LITE_QueryOnly
9bb0: 20 20 20 20 30 78 30 32 30 30 30 30 30 30 20 20 0x02000000
9bc0: 2f 2a 20 44 69 73 61 62 6c 65 20 64 61 74 61 62 /* Disable datab
9bd0: 61 73 65 20 63 68 61 6e 67 65 73 20 2a 2f 0a 23 ase changes */.#
9be0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 define SQLITE_Vd
9bf0: 62 65 45 51 50 20 20 20 20 20 20 20 20 30 78 30 beEQP 0x0
9c00: 34 30 30 30 30 30 30 20 20 2f 2a 20 44 65 62 75 4000000 /* Debu
9c10: 67 20 45 58 50 4c 41 49 4e 20 51 55 45 52 59 20 g EXPLAIN QUERY
9c20: 50 4c 41 4e 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 PLAN */.../*.**
9c30: 42 69 74 73 20 6f 66 20 74 68 65 20 73 71 6c 69 Bits of the sqli
9c40: 74 65 33 2e 64 62 4f 70 74 46 6c 61 67 73 20 66 te3.dbOptFlags f
9c50: 69 65 6c 64 20 74 68 61 74 20 61 72 65 20 75 73 ield that are us
9c60: 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 73 71 6c ed by the.** sql
9c70: 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f ite3_test_contro
9c80: 6c 28 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 l(SQLITE_TESTCTR
9c90: 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 4f 4e 53 2c L_OPTIMIZATIONS,
9ca0: 2e 2e 2e 29 20 69 6e 74 65 72 66 61 63 65 20 74 ...) interface t
9cb0: 6f 0a 2a 2a 20 73 65 6c 65 63 74 69 76 65 6c 79 o.** selectively
9cc0: 20 64 69 73 61 62 6c 65 20 76 61 72 69 6f 75 73 disable various
9cd0: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 2e 0a optimizations..
9ce0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
9cf0: 45 5f 51 75 65 72 79 46 6c 61 74 74 65 6e 65 72 E_QueryFlattener
9d00: 20 30 78 30 30 30 31 20 20 20 2f 2a 20 51 75 65 0x0001 /* Que
9d10: 72 79 20 66 6c 61 74 74 65 6e 69 6e 67 20 2a 2f ry flattening */
9d20: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
9d30: 43 6f 6c 75 6d 6e 43 61 63 68 65 20 20 20 20 30 ColumnCache 0
9d40: 78 30 30 30 32 20 20 20 2f 2a 20 43 6f 6c 75 6d x0002 /* Colum
9d50: 6e 20 63 61 63 68 65 20 2a 2f 0a 23 64 65 66 69 n cache */.#defi
9d60: 6e 65 20 53 51 4c 49 54 45 5f 47 72 6f 75 70 42 ne SQLITE_GroupB
9d70: 79 4f 72 64 65 72 20 20 20 30 78 30 30 30 34 20 yOrder 0x0004
9d80: 20 20 2f 2a 20 47 52 4f 55 50 42 59 20 63 6f 76 /* GROUPBY cov
9d90: 65 72 20 6f 66 20 4f 52 44 45 52 42 59 20 2a 2f er of ORDERBY */
9da0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
9db0: 46 61 63 74 6f 72 4f 75 74 43 6f 6e 73 74 20 30 FactorOutConst 0
9dc0: 78 30 30 30 38 20 20 20 2f 2a 20 43 6f 6e 73 74 x0008 /* Const
9dd0: 61 6e 74 20 66 61 63 74 6f 72 69 6e 67 20 2a 2f ant factoring */
9de0: 0a 2f 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 ./*
9df0: 20 20 20 6e 6f 74 20 75 73 65 64 20 20 20 20 30 not used 0
9e00: 78 30 30 31 30 20 20 20 2f 2f 20 57 61 73 3a 20 x0010 // Was:
9e10: 53 51 4c 49 54 45 5f 49 64 78 52 65 61 6c 41 73 SQLITE_IdxRealAs
9e20: 49 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 Int */.#define S
9e30: 51 4c 49 54 45 5f 44 69 73 74 69 6e 63 74 4f 70 QLITE_DistinctOp
9e40: 74 20 20 20 20 30 78 30 30 32 30 20 20 20 2f 2a t 0x0020 /*
9e50: 20 44 49 53 54 49 4e 43 54 20 75 73 69 6e 67 20 DISTINCT using
9e60: 69 6e 64 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 indexes */.#defi
9e70: 6e 65 20 53 51 4c 49 54 45 5f 43 6f 76 65 72 49 ne SQLITE_CoverI
9e80: 64 78 53 63 61 6e 20 20 20 30 78 30 30 34 30 20 dxScan 0x0040
9e90: 20 20 2f 2a 20 43 6f 76 65 72 69 6e 67 20 69 6e /* Covering in
9ea0: 64 65 78 20 73 63 61 6e 73 20 2a 2f 0a 23 64 65 dex scans */.#de
9eb0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 72 64 65 fine SQLITE_Orde
9ec0: 72 42 79 49 64 78 4a 6f 69 6e 20 30 78 30 30 38 rByIdxJoin 0x008
9ed0: 30 20 20 20 2f 2a 20 4f 52 44 45 52 20 42 59 20 0 /* ORDER BY
9ee0: 6f 66 20 6a 6f 69 6e 73 20 76 69 61 20 69 6e 64 of joins via ind
9ef0: 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ex */.#define SQ
9f00: 4c 49 54 45 5f 53 75 62 71 43 6f 72 6f 75 74 69 LITE_SubqCorouti
9f10: 6e 65 20 20 30 78 30 31 30 30 20 20 20 2f 2a 20 ne 0x0100 /*
9f20: 45 76 61 6c 75 61 74 65 20 73 75 62 71 75 65 72 Evaluate subquer
9f30: 69 65 73 20 61 73 20 63 6f 72 6f 75 74 69 6e 65 ies as coroutine
9f40: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
9f50: 49 54 45 5f 54 72 61 6e 73 69 74 69 76 65 20 20 ITE_Transitive
9f60: 20 20 20 30 78 30 32 30 30 20 20 20 2f 2a 20 54 0x0200 /* T
9f70: 72 61 6e 73 69 74 69 76 65 20 63 6f 6e 73 74 72 ransitive constr
9f80: 61 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 aints */.#define
9f90: 20 53 51 4c 49 54 45 5f 4f 6d 69 74 4e 6f 6f 70 SQLITE_OmitNoop
9fa0: 4a 6f 69 6e 20 20 20 30 78 30 34 30 30 20 20 20 Join 0x0400
9fb0: 2f 2a 20 4f 6d 69 74 20 75 6e 75 73 65 64 20 74 /* Omit unused t
9fc0: 61 62 6c 65 73 20 69 6e 20 6a 6f 69 6e 73 20 2a ables in joins *
9fd0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
9fe0: 5f 53 74 61 74 33 20 20 20 20 20 20 20 20 20 20 _Stat3
9ff0: 30 78 30 38 30 30 20 20 20 2f 2a 20 55 73 65 20 0x0800 /* Use
a000: 74 68 65 20 53 51 4c 49 54 45 5f 53 54 41 54 33 the SQLITE_STAT3
a010: 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e table */.#defin
a020: 65 20 53 51 4c 49 54 45 5f 41 64 6a 75 73 74 4f e SQLITE_AdjustO
a030: 75 74 45 73 74 20 20 20 30 78 31 30 30 30 20 20 utEst 0x1000
a040: 20 2f 2a 20 41 64 6a 75 73 74 20 6f 75 74 70 75 /* Adjust outpu
a050: 74 20 65 73 74 69 6d 61 74 65 73 20 75 73 69 6e t estimates usin
a060: 67 20 57 48 45 52 45 20 2a 2f 0a 23 64 65 66 69 g WHERE */.#defi
a070: 6e 65 20 53 51 4c 49 54 45 5f 41 6c 6c 4f 70 74 ne SQLITE_AllOpt
a080: 73 20 20 20 20 20 20 20 20 30 78 66 66 66 66 20 s 0xffff
a090: 20 20 2f 2a 20 41 6c 6c 20 6f 70 74 69 6d 69 7a /* All optimiz
a0a0: 61 74 69 6f 6e 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a ations */../*.**
a0b0: 20 4d 61 63 72 6f 73 20 66 6f 72 20 74 65 73 74 Macros for test
a0c0: 69 6e 67 20 77 68 65 74 68 65 72 20 6f 72 20 6e ing whether or n
a0d0: 6f 74 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 ot optimizations
a0e0: 20 61 72 65 20 65 6e 61 62 6c 65 64 20 6f 72 20 are enabled or
a0f0: 64 69 73 61 62 6c 65 64 2e 0a 2a 2f 0a 23 69 66 disabled..*/.#if
a100: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
a110: 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 23 64 _BUILTIN_TEST.#d
a120: 65 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 efine Optimizati
a130: 6f 6e 44 69 73 61 62 6c 65 64 28 64 62 2c 20 6d onDisabled(db, m
a140: 61 73 6b 29 20 20 28 28 28 64 62 29 2d 3e 64 62 ask) (((db)->db
a150: 4f 70 74 46 6c 61 67 73 26 28 6d 61 73 6b 29 29 OptFlags&(mask))
a160: 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 4f 70 74 !=0).#define Opt
a170: 69 6d 69 7a 61 74 69 6f 6e 45 6e 61 62 6c 65 64 imizationEnabled
a180: 28 64 62 2c 20 6d 61 73 6b 29 20 20 20 28 28 28 (db, mask) (((
a190: 64 62 29 2d 3e 64 62 4f 70 74 46 6c 61 67 73 26 db)->dbOptFlags&
a1a0: 28 6d 61 73 6b 29 29 3d 3d 30 29 0a 23 65 6c 73 (mask))==0).#els
a1b0: 65 0a 23 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 e.#define Optimi
a1c0: 7a 61 74 69 6f 6e 44 69 73 61 62 6c 65 64 28 64 zationDisabled(d
a1d0: 62 2c 20 6d 61 73 6b 29 20 20 30 0a 23 64 65 66 b, mask) 0.#def
a1e0: 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e ine Optimization
a1f0: 45 6e 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b Enabled(db, mask
a200: 29 20 20 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a ) 1.#endif../*
a210: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 .** Return true
a220: 69 66 20 69 74 20 4f 4b 20 74 6f 20 66 61 63 74 if it OK to fact
a230: 6f 72 20 63 6f 6e 73 74 61 6e 74 20 65 78 70 72 or constant expr
a240: 65 73 73 69 6f 6e 73 20 69 6e 74 6f 20 74 68 65 essions into the
a250: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 0a initialization.
a260: 2a 2a 20 63 6f 64 65 2e 20 54 68 65 20 61 72 67 ** code. The arg
a270: 75 6d 65 6e 74 20 69 73 20 61 20 50 61 72 73 65 ument is a Parse
a280: 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 65 20 object for the
a290: 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 2e 0a code generator..
a2a0: 2a 2f 0a 23 64 65 66 69 6e 65 20 43 6f 6e 73 74 */.#define Const
a2b0: 46 61 63 74 6f 72 4f 6b 28 50 29 20 5c 0a 20 20 FactorOk(P) \.
a2c0: 28 28 50 29 2d 3e 63 6f 6f 6b 69 65 47 6f 74 6f ((P)->cookieGoto
a2d0: 3e 30 20 26 26 20 4f 70 74 69 6d 69 7a 61 74 69 >0 && Optimizati
a2e0: 6f 6e 45 6e 61 62 6c 65 64 28 28 50 29 2d 3e 64 onEnabled((P)->d
a2f0: 62 2c 53 51 4c 49 54 45 5f 46 61 63 74 6f 72 4f b,SQLITE_FactorO
a300: 75 74 43 6f 6e 73 74 29 29 0a 0a 2f 2a 0a 2a 2a utConst))../*.**
a310: 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 Possible values
a320: 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 65 2e for the sqlite.
a330: 6d 61 67 69 63 20 66 69 65 6c 64 2e 0a 2a 2a 20 magic field..**
a340: 54 68 65 20 6e 75 6d 62 65 72 73 20 61 72 65 20 The numbers are
a350: 6f 62 74 61 69 6e 65 64 20 61 74 20 72 61 6e 64 obtained at rand
a360: 6f 6d 20 61 6e 64 20 68 61 76 65 20 6e 6f 20 73 om and have no s
a370: 70 65 63 69 61 6c 20 6d 65 61 6e 69 6e 67 2c 20 pecial meaning,
a380: 6f 74 68 65 72 0a 2a 2a 20 74 68 61 6e 20 62 65 other.** than be
a390: 69 6e 67 20 64 69 73 74 69 6e 63 74 20 66 72 6f ing distinct fro
a3a0: 6d 20 6f 6e 65 20 61 6e 6f 74 68 65 72 2e 0a 2a m one another..*
a3b0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
a3c0: 5f 4d 41 47 49 43 5f 4f 50 45 4e 20 20 20 20 20 _MAGIC_OPEN
a3d0: 30 78 61 30 32 39 61 36 39 37 20 20 2f 2a 20 44 0xa029a697 /* D
a3e0: 61 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e 20 atabase is open
a3f0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a400: 45 5f 4d 41 47 49 43 5f 43 4c 4f 53 45 44 20 20 E_MAGIC_CLOSED
a410: 20 30 78 39 66 33 63 32 64 33 33 20 20 2f 2a 20 0x9f3c2d33 /*
a420: 44 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73 Database is clos
a430: 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ed */.#define SQ
a440: 4c 49 54 45 5f 4d 41 47 49 43 5f 53 49 43 4b 20 LITE_MAGIC_SICK
a450: 20 20 20 20 30 78 34 62 37 37 31 32 39 30 20 20 0x4b771290
a460: 2f 2a 20 45 72 72 6f 72 20 61 6e 64 20 61 77 61 /* Error and awa
a470: 69 74 69 6e 67 20 63 6c 6f 73 65 20 2a 2f 0a 23 iting close */.#
a480: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 define SQLITE_MA
a490: 47 49 43 5f 42 55 53 59 20 20 20 20 20 30 78 66 GIC_BUSY 0xf
a4a0: 30 33 62 37 39 30 36 20 20 2f 2a 20 44 61 74 61 03b7906 /* Data
a4b0: 62 61 73 65 20 63 75 72 72 65 6e 74 6c 79 20 69 base currently i
a4c0: 6e 20 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 n use */.#define
a4d0: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 45 52 SQLITE_MAGIC_ER
a4e0: 52 4f 52 20 20 20 20 30 78 62 35 33 35 37 39 33 ROR 0xb535793
a4f0: 30 20 20 2f 2a 20 41 6e 20 53 51 4c 49 54 45 5f 0 /* An SQLITE_
a500: 4d 49 53 55 53 45 20 65 72 72 6f 72 20 6f 63 63 MISUSE error occ
a510: 75 72 72 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 urred */.#define
a520: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 5a 4f SQLITE_MAGIC_ZO
a530: 4d 42 49 45 20 20 20 30 78 36 34 63 66 66 63 37 MBIE 0x64cffc7
a540: 66 20 20 2f 2a 20 43 6c 6f 73 65 20 77 69 74 68 f /* Close with
a550: 20 6c 61 73 74 20 73 74 61 74 65 6d 65 6e 74 20 last statement
a560: 63 6c 6f 73 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 close */../*.**
a570: 45 61 63 68 20 53 51 4c 20 66 75 6e 63 74 69 6f Each SQL functio
a580: 6e 20 69 73 20 64 65 66 69 6e 65 64 20 62 79 20 n is defined by
a590: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
a5a0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 he following.**
a5b0: 73 74 72 75 63 74 75 72 65 2e 20 20 41 20 70 6f structure. A po
a5c0: 69 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 inter to this st
a5d0: 72 75 63 74 75 72 65 20 69 73 20 73 74 6f 72 65 ructure is store
a5e0: 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 2e d in the sqlite.
a5f0: 61 46 75 6e 63 0a 2a 2a 20 68 61 73 68 20 74 61 aFunc.** hash ta
a600: 62 6c 65 2e 20 20 57 68 65 6e 20 6d 75 6c 74 69 ble. When multi
a610: 70 6c 65 20 66 75 6e 63 74 69 6f 6e 73 20 68 61 ple functions ha
a620: 76 65 20 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 ve the same name
a630: 2c 20 74 68 65 20 68 61 73 68 20 74 61 62 6c 65 , the hash table
a640: 0a 2a 2a 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 .** points to a
a650: 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 74 linked list of t
a660: 68 65 73 65 20 73 74 72 75 63 74 75 72 65 73 2e hese structures.
a670: 0a 2a 2f 0a 73 74 72 75 63 74 20 46 75 6e 63 44 .*/.struct FuncD
a680: 65 66 20 7b 0a 20 20 69 31 36 20 6e 41 72 67 3b ef {. i16 nArg;
a690: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
a6a0: 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e umber of argumen
a6b0: 74 73 2e 20 20 2d 31 20 6d 65 61 6e 73 20 75 6e ts. -1 means un
a6c0: 6c 69 6d 69 74 65 64 20 2a 2f 0a 20 20 75 31 36 limited */. u16
a6d0: 20 66 75 6e 63 46 6c 61 67 73 3b 20 20 20 20 20 funcFlags;
a6e0: 20 20 2f 2a 20 53 6f 6d 65 20 63 6f 6d 62 69 6e /* Some combin
a6f0: 61 74 69 6f 6e 20 6f 66 20 53 51 4c 49 54 45 5f ation of SQLITE_
a700: 46 55 4e 43 5f 2a 20 2a 2f 0a 20 20 76 6f 69 64 FUNC_* */. void
a710: 20 2a 70 55 73 65 72 44 61 74 61 3b 20 20 20 20 *pUserData;
a720: 20 2f 2a 20 55 73 65 72 20 64 61 74 61 20 70 61 /* User data pa
a730: 72 61 6d 65 74 65 72 20 2a 2f 0a 20 20 46 75 6e rameter */. Fun
a740: 63 44 65 66 20 2a 70 4e 65 78 74 3b 20 20 20 20 cDef *pNext;
a750: 20 20 2f 2a 20 4e 65 78 74 20 66 75 6e 63 74 69 /* Next functi
a760: 6f 6e 20 77 69 74 68 20 73 61 6d 65 20 6e 61 6d on with same nam
a770: 65 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 46 e */. void (*xF
a780: 75 6e 63 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e unc)(sqlite3_con
a790: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
a7a0: 33 5f 76 61 6c 75 65 2a 2a 29 3b 20 2f 2a 20 52 3_value**); /* R
a7b0: 65 67 75 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 egular function
a7c0: 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 53 74 65 */. void (*xSte
a7d0: 70 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 p)(sqlite3_conte
a7e0: 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
a7f0: 76 61 6c 75 65 2a 2a 29 3b 20 2f 2a 20 41 67 67 value**); /* Agg
a800: 72 65 67 61 74 65 20 73 74 65 70 20 2a 2f 0a 20 regate step */.
a810: 20 76 6f 69 64 20 28 2a 78 46 69 6e 61 6c 69 7a void (*xFinaliz
a820: 65 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 e)(sqlite3_conte
a830: 78 74 2a 29 3b 20 20 20 20 20 20 20 20 20 20 20 xt*);
a840: 20 20 20 20 20 2f 2a 20 41 67 67 72 65 67 61 74 /* Aggregat
a850: 65 20 66 69 6e 61 6c 69 7a 65 72 20 2a 2f 0a 20 e finalizer */.
a860: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 char *zName;
a870: 20 20 20 20 20 20 2f 2a 20 53 51 4c 20 6e 61 6d /* SQL nam
a880: 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f e of the functio
a890: 6e 2e 20 2a 2f 0a 20 20 46 75 6e 63 44 65 66 20 n. */. FuncDef
a8a0: 2a 70 48 61 73 68 3b 20 20 20 20 20 20 2f 2a 20 *pHash; /*
a8b0: 4e 65 78 74 20 77 69 74 68 20 61 20 64 69 66 66 Next with a diff
a8c0: 65 72 65 6e 74 20 6e 61 6d 65 20 62 75 74 20 74 erent name but t
a8d0: 68 65 20 73 61 6d 65 20 68 61 73 68 20 2a 2f 0a he same hash */.
a8e0: 20 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 FuncDestructor
a8f0: 20 2a 70 44 65 73 74 72 75 63 74 6f 72 3b 20 20 *pDestructor;
a900: 20 2f 2a 20 52 65 66 65 72 65 6e 63 65 20 63 6f /* Reference co
a910: 75 6e 74 65 64 20 64 65 73 74 72 75 63 74 6f 72 unted destructor
a920: 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 7d 3b 0a function */.};.
a930: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 ./*.** This stru
a940: 63 74 75 72 65 20 65 6e 63 61 70 73 75 6c 61 74 cture encapsulat
a950: 65 73 20 61 20 75 73 65 72 2d 66 75 6e 63 74 69 es a user-functi
a960: 6f 6e 20 64 65 73 74 72 75 63 74 6f 72 20 63 61 on destructor ca
a970: 6c 6c 62 61 63 6b 20 28 61 73 0a 2a 2a 20 63 6f llback (as.** co
a980: 6e 66 69 67 75 72 65 64 20 75 73 69 6e 67 20 63 nfigured using c
a990: 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 reate_function_v
a9a0: 32 28 29 29 20 61 6e 64 20 61 20 72 65 66 65 72 2()) and a refer
a9b0: 65 6e 63 65 20 63 6f 75 6e 74 65 72 2e 20 57 68 ence counter. Wh
a9c0: 65 6e 0a 2a 2a 20 63 72 65 61 74 65 5f 66 75 6e en.** create_fun
a9d0: 63 74 69 6f 6e 5f 76 32 28 29 20 69 73 20 63 61 ction_v2() is ca
a9e0: 6c 6c 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 lled to create a
a9f0: 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 function with a
aa00: 20 64 65 73 74 72 75 63 74 6f 72 2c 0a 2a 2a 20 destructor,.**
aa10: 61 20 73 69 6e 67 6c 65 20 6f 62 6a 65 63 74 20 a single object
aa20: 6f 66 20 74 68 69 73 20 74 79 70 65 20 69 73 20 of this type is
aa30: 61 6c 6c 6f 63 61 74 65 64 2e 20 46 75 6e 63 44 allocated. FuncD
aa40: 65 73 74 72 75 63 74 6f 72 2e 6e 52 65 66 20 69 estructor.nRef i
aa50: 73 20 73 65 74 20 74 6f 20 0a 2a 2a 20 74 68 65 s set to .** the
aa60: 20 6e 75 6d 62 65 72 20 6f 66 20 46 75 6e 63 44 number of FuncD
aa70: 65 66 20 6f 62 6a 65 63 74 73 20 63 72 65 61 74 ef objects creat
aa80: 65 64 20 28 65 69 74 68 65 72 20 31 20 6f 72 20 ed (either 1 or
aa90: 33 2c 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 3, depending on
aaa0: 77 68 65 74 68 65 72 0a 2a 2a 20 6f 72 20 6e 6f whether.** or no
aab0: 74 20 74 68 65 20 73 70 65 63 69 66 69 65 64 20 t the specified
aac0: 65 6e 63 6f 64 69 6e 67 20 69 73 20 53 51 4c 49 encoding is SQLI
aad0: 54 45 5f 41 4e 59 29 2e 20 54 68 65 20 46 75 6e TE_ANY). The Fun
aae0: 63 44 65 66 2e 70 44 65 73 74 72 75 63 74 6f 72 cDef.pDestructor
aaf0: 0a 2a 2a 20 6d 65 6d 62 65 72 20 6f 66 20 65 61 .** member of ea
ab00: 63 68 20 6f 66 20 74 68 65 20 6e 65 77 20 46 75 ch of the new Fu
ab10: 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 20 69 73 ncDef objects is
ab20: 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f set to point to
ab30: 20 74 68 65 20 61 6c 6c 6f 63 61 74 65 64 0a 2a the allocated.*
ab40: 2a 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 * FuncDestructor
ab50: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 61 66 74 ..**.** Thereaft
ab60: 65 72 2c 20 77 68 65 6e 20 6f 6e 65 20 6f 66 20 er, when one of
ab70: 74 68 65 20 46 75 6e 63 44 65 66 20 6f 62 6a 65 the FuncDef obje
ab80: 63 74 73 20 69 73 20 64 65 6c 65 74 65 64 2c 20 cts is deleted,
ab90: 74 68 65 20 72 65 66 65 72 65 6e 63 65 0a 2a 2a the reference.**
aba0: 20 63 6f 75 6e 74 20 6f 6e 20 74 68 69 73 20 6f count on this o
abb0: 62 6a 65 63 74 20 69 73 20 64 65 63 72 65 6d 65 bject is decreme
abc0: 6e 74 65 64 2e 20 57 68 65 6e 20 69 74 20 72 65 nted. When it re
abd0: 61 63 68 65 73 20 30 2c 20 74 68 65 20 64 65 73 aches 0, the des
abe0: 74 72 75 63 74 6f 72 0a 2a 2a 20 69 73 20 69 6e tructor.** is in
abf0: 76 6f 6b 65 64 20 61 6e 64 20 74 68 65 20 46 75 voked and the Fu
ac00: 6e 63 44 65 73 74 72 75 63 74 6f 72 20 73 74 72 ncDestructor str
ac10: 75 63 74 75 72 65 20 66 72 65 65 64 2e 0a 2a 2f ucture freed..*/
ac20: 0a 73 74 72 75 63 74 20 46 75 6e 63 44 65 73 74 .struct FuncDest
ac30: 72 75 63 74 6f 72 20 7b 0a 20 20 69 6e 74 20 6e ructor {. int n
ac40: 52 65 66 3b 0a 20 20 76 6f 69 64 20 28 2a 78 44 Ref;. void (*xD
ac50: 65 73 74 72 6f 79 29 28 76 6f 69 64 20 2a 29 3b estroy)(void *);
ac60: 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 61 . void *pUserDa
ac70: 74 61 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 50 6f ta;.};../*.** Po
ac80: 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f ssible values fo
ac90: 72 20 46 75 6e 63 44 65 66 2e 66 6c 61 67 73 2e r FuncDef.flags.
aca0: 20 20 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 Note that the
acb0: 5f 4c 45 4e 47 54 48 20 61 6e 64 20 5f 54 59 50 _LENGTH and _TYP
acc0: 45 4f 46 0a 2a 2a 20 76 61 6c 75 65 73 20 6d 75 EOF.** values mu
acd0: 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f st correspond to
ace0: 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 48 41 52 OPFLAG_LENGTHAR
acf0: 47 20 61 6e 64 20 4f 50 46 4c 41 47 5f 54 59 50 G and OPFLAG_TYP
ad00: 45 4f 46 41 52 47 2e 20 20 54 68 65 72 65 0a 2a EOFARG. There.*
ad10: 2a 20 61 72 65 20 61 73 73 65 72 74 28 29 20 73 * are assert() s
ad20: 74 61 74 65 6d 65 6e 74 73 20 69 6e 20 74 68 65 tatements in the
ad30: 20 63 6f 64 65 20 74 6f 20 76 65 72 69 66 79 20 code to verify
ad40: 74 68 69 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 this..*/.#define
ad50: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 4e 43 SQLITE_FUNC_ENC
ad60: 4d 41 53 4b 20 20 30 78 30 30 33 20 2f 2a 20 53 MASK 0x003 /* S
ad70: 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 QLITE_UTF8, SQLI
ad80: 54 45 5f 55 54 46 31 36 42 45 20 6f 72 20 55 54 TE_UTF16BE or UT
ad90: 46 31 36 4c 45 20 2a 2f 0a 23 64 65 66 69 6e 65 F16LE */.#define
ada0: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 49 4b SQLITE_FUNC_LIK
adb0: 45 20 20 20 20 20 30 78 30 30 34 20 2f 2a 20 43 E 0x004 /* C
adc0: 61 6e 64 69 64 61 74 65 20 66 6f 72 20 74 68 65 andidate for the
add0: 20 4c 49 4b 45 20 6f 70 74 69 6d 69 7a 61 74 69 LIKE optimizati
ade0: 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 on */.#define SQ
adf0: 4c 49 54 45 5f 46 55 4e 43 5f 43 41 53 45 20 20 LITE_FUNC_CASE
ae00: 20 20 20 30 78 30 30 38 20 2f 2a 20 43 61 73 65 0x008 /* Case
ae10: 2d 73 65 6e 73 69 74 69 76 65 20 4c 49 4b 45 2d -sensitive LIKE-
ae20: 74 79 70 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f type function */
ae30: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
ae40: 46 55 4e 43 5f 45 50 48 45 4d 20 20 20 20 30 78 FUNC_EPHEM 0x
ae50: 30 31 30 20 2f 2a 20 45 70 68 65 6d 65 72 61 6c 010 /* Ephemeral
ae60: 2e 20 20 44 65 6c 65 74 65 20 77 69 74 68 20 56 . Delete with V
ae70: 44 42 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 DBE */.#define S
ae80: 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 QLITE_FUNC_NEEDC
ae90: 4f 4c 4c 20 30 78 30 32 30 20 2f 2a 20 73 71 6c OLL 0x020 /* sql
aea0: 69 74 65 33 47 65 74 46 75 6e 63 43 6f 6c 6c 53 ite3GetFuncCollS
aeb0: 65 71 28 29 20 6d 69 67 68 74 20 62 65 20 63 61 eq() might be ca
aec0: 6c 6c 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 lled */.#define
aed0: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4c 45 4e 47 SQLITE_FUNC_LENG
aee0: 54 48 20 20 20 30 78 30 34 30 20 2f 2a 20 42 75 TH 0x040 /* Bu
aef0: 69 6c 74 2d 69 6e 20 6c 65 6e 67 74 68 28 29 20 ilt-in length()
af00: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 function */.#def
af10: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
af20: 54 59 50 45 4f 46 20 20 20 30 78 30 38 30 20 2f TYPEOF 0x080 /
af30: 2a 20 42 75 69 6c 74 2d 69 6e 20 74 79 70 65 6f * Built-in typeo
af40: 66 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a f() function */.
af50: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
af60: 55 4e 43 5f 43 4f 55 4e 54 20 20 20 20 30 78 31 UNC_COUNT 0x1
af70: 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 63 00 /* Built-in c
af80: 6f 75 6e 74 28 2a 29 20 61 67 67 72 65 67 61 74 ount(*) aggregat
af90: 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c e */.#define SQL
afa0: 49 54 45 5f 46 55 4e 43 5f 43 4f 41 4c 45 53 43 ITE_FUNC_COALESC
afb0: 45 20 30 78 32 30 30 20 2f 2a 20 42 75 69 6c 74 E 0x200 /* Built
afc0: 2d 69 6e 20 63 6f 61 6c 65 73 63 65 28 29 20 6f -in coalesce() o
afd0: 72 20 69 66 6e 75 6c 6c 28 29 20 2a 2f 0a 23 64 r ifnull() */.#d
afe0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
aff0: 43 5f 55 4e 4c 49 4b 45 4c 59 20 30 78 34 30 30 C_UNLIKELY 0x400
b000: 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 75 6e 6c /* Built-in unl
b010: 69 6b 65 6c 79 28 29 20 66 75 6e 63 74 69 6f 6e ikely() function
b020: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
b030: 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 TE_FUNC_CONSTANT
b040: 20 30 78 38 30 30 20 2f 2a 20 43 6f 6e 73 74 61 0x800 /* Consta
b050: 6e 74 20 69 6e 70 75 74 73 20 67 69 76 65 20 61 nt inputs give a
b060: 20 63 6f 6e 73 74 61 6e 74 20 6f 75 74 70 75 74 constant output
b070: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 */../*.** The f
b080: 6f 6c 6c 6f 77 69 6e 67 20 74 68 72 65 65 20 6d ollowing three m
b090: 61 63 72 6f 73 2c 20 46 55 4e 43 54 49 4f 4e 28 acros, FUNCTION(
b0a0: 29 2c 20 4c 49 4b 45 46 55 4e 43 28 29 20 61 6e ), LIKEFUNC() an
b0b0: 64 20 41 47 47 52 45 47 41 54 45 28 29 20 61 72 d AGGREGATE() ar
b0c0: 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 63 72 65 e.** used to cre
b0d0: 61 74 65 20 74 68 65 20 69 6e 69 74 69 61 6c 69 ate the initiali
b0e0: 7a 65 72 73 20 66 6f 72 20 74 68 65 20 46 75 6e zers for the Fun
b0f0: 63 44 65 66 20 73 74 72 75 63 74 75 72 65 73 2e cDef structures.
b100: 0a 2a 2a 0a 2a 2a 20 20 20 46 55 4e 43 54 49 4f .**.** FUNCTIO
b110: 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 N(zName, nArg, i
b120: 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 Arg, bNC, xFunc)
b130: 0a 2a 2a 20 20 20 20 20 55 73 65 64 20 74 6f 20 .** Used to
b140: 63 72 65 61 74 65 20 61 20 73 63 61 6c 61 72 20 create a scalar
b150: 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 function definit
b160: 69 6f 6e 20 6f 66 20 61 20 66 75 6e 63 74 69 6f ion of a functio
b170: 6e 20 7a 4e 61 6d 65 20 0a 2a 2a 20 20 20 20 20 n zName .**
b180: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 43 implemented by C
b190: 20 66 75 6e 63 74 69 6f 6e 20 78 46 75 6e 63 20 function xFunc
b1a0: 74 68 61 74 20 61 63 63 65 70 74 73 20 6e 41 72 that accepts nAr
b1b0: 67 20 61 72 67 75 6d 65 6e 74 73 2e 20 54 68 65 g arguments. The
b1c0: 0a 2a 2a 20 20 20 20 20 76 61 6c 75 65 20 70 61 .** value pa
b1d0: 73 73 65 64 20 61 73 20 69 41 72 67 20 69 73 20 ssed as iArg is
b1e0: 63 61 73 74 20 74 6f 20 61 20 28 76 6f 69 64 2a cast to a (void*
b1f0: 29 20 61 6e 64 20 6d 61 64 65 20 61 76 61 69 6c ) and made avail
b200: 61 62 6c 65 0a 2a 2a 20 20 20 20 20 61 73 20 74 able.** as t
b210: 68 65 20 75 73 65 72 2d 64 61 74 61 20 28 73 71 he user-data (sq
b220: 6c 69 74 65 33 5f 75 73 65 72 5f 64 61 74 61 28 lite3_user_data(
b230: 29 29 20 66 6f 72 20 74 68 65 20 66 75 6e 63 74 )) for the funct
b240: 69 6f 6e 2e 20 49 66 20 0a 2a 2a 20 20 20 20 20 ion. If .**
b250: 61 72 67 75 6d 65 6e 74 20 62 4e 43 20 69 73 20 argument bNC is
b260: 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20 53 true, then the S
b270: 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 QLITE_FUNC_NEEDC
b280: 4f 4c 4c 20 66 6c 61 67 20 69 73 20 73 65 74 2e OLL flag is set.
b290: 0a 2a 2a 0a 2a 2a 20 20 20 56 46 55 4e 43 54 49 .**.** VFUNCTI
b2a0: 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 ON(zName, nArg,
b2b0: 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 iArg, bNC, xFunc
b2c0: 29 0a 2a 2a 20 20 20 20 20 4c 69 6b 65 20 46 55 ).** Like FU
b2d0: 4e 43 54 49 4f 4e 20 65 78 63 65 70 74 20 69 74 NCTION except it
b2e0: 20 6f 6d 69 74 73 20 74 68 65 20 53 51 4c 49 54 omits the SQLIT
b2f0: 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 E_FUNC_CONSTANT
b300: 66 6c 61 67 2e 0a 2a 2a 0a 2a 2a 20 20 20 41 47 flag..**.** AG
b310: 47 52 45 47 41 54 45 28 7a 4e 61 6d 65 2c 20 6e GREGATE(zName, n
b320: 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 Arg, iArg, bNC,
b330: 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 0a 2a xStep, xFinal).*
b340: 2a 20 20 20 20 20 55 73 65 64 20 74 6f 20 63 72 * Used to cr
b350: 65 61 74 65 20 61 6e 20 61 67 67 72 65 67 61 74 eate an aggregat
b360: 65 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e e function defin
b370: 69 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 ition implemente
b380: 64 20 62 79 0a 2a 2a 20 20 20 20 20 74 68 65 20 d by.** the
b390: 43 20 66 75 6e 63 74 69 6f 6e 73 20 78 53 74 65 C functions xSte
b3a0: 70 20 61 6e 64 20 78 46 69 6e 61 6c 2e 20 54 68 p and xFinal. Th
b3b0: 65 20 66 69 72 73 74 20 66 6f 75 72 20 70 61 72 e first four par
b3c0: 61 6d 65 74 65 72 73 0a 2a 2a 20 20 20 20 20 61 ameters.** a
b3d0: 72 65 20 69 6e 74 65 72 70 72 65 74 65 64 20 69 re interpreted i
b3e0: 6e 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 n the same way a
b3f0: 73 20 74 68 65 20 66 69 72 73 74 20 34 20 70 61 s the first 4 pa
b400: 72 61 6d 65 74 65 72 73 20 74 6f 0a 2a 2a 20 20 rameters to.**
b410: 20 20 20 46 55 4e 43 54 49 4f 4e 28 29 2e 0a 2a FUNCTION()..*
b420: 2a 0a 2a 2a 20 20 20 4c 49 4b 45 46 55 4e 43 28 *.** LIKEFUNC(
b430: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 70 41 72 zName, nArg, pAr
b440: 67 2c 20 66 6c 61 67 73 29 0a 2a 2a 20 20 20 20 g, flags).**
b450: 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 Used to create
b460: 61 20 73 63 61 6c 61 72 20 66 75 6e 63 74 69 6f a scalar functio
b470: 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 n definition of
b480: 61 20 66 75 6e 63 74 69 6f 6e 20 7a 4e 61 6d 65 a function zName
b490: 20 0a 2a 2a 20 20 20 20 20 74 68 61 74 20 61 63 .** that ac
b4a0: 63 65 70 74 73 20 6e 41 72 67 20 61 72 67 75 6d cepts nArg argum
b4b0: 65 6e 74 73 20 61 6e 64 20 69 73 20 69 6d 70 6c ents and is impl
b4c0: 65 6d 65 6e 74 65 64 20 62 79 20 61 20 63 61 6c emented by a cal
b4d0: 6c 20 74 6f 20 43 20 0a 2a 2a 20 20 20 20 20 66 l to C .** f
b4e0: 75 6e 63 74 69 6f 6e 20 6c 69 6b 65 46 75 6e 63 unction likeFunc
b4f0: 2e 20 41 72 67 75 6d 65 6e 74 20 70 41 72 67 20 . Argument pArg
b500: 69 73 20 63 61 73 74 20 74 6f 20 61 20 28 76 6f is cast to a (vo
b510: 69 64 20 2a 29 20 61 6e 64 20 6d 61 64 65 0a 2a id *) and made.*
b520: 2a 20 20 20 20 20 61 76 61 69 6c 61 62 6c 65 20 * available
b530: 61 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 as the function
b540: 75 73 65 72 2d 64 61 74 61 20 28 73 71 6c 69 74 user-data (sqlit
b550: 65 33 5f 75 73 65 72 5f 64 61 74 61 28 29 29 2e e3_user_data()).
b560: 20 54 68 65 0a 2a 2a 20 20 20 20 20 46 75 6e 63 The.** Func
b570: 44 65 66 2e 66 6c 61 67 73 20 76 61 72 69 61 62 Def.flags variab
b580: 6c 65 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 le is set to the
b590: 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 61 73 value passed as
b5a0: 20 74 68 65 20 66 6c 61 67 73 0a 2a 2a 20 20 20 the flags.**
b5b0: 20 20 70 61 72 61 6d 65 74 65 72 2e 0a 2a 2f 0a parameter..*/.
b5c0: 23 64 65 66 69 6e 65 20 46 55 4e 43 54 49 4f 4e #define FUNCTION
b5d0: 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 (zName, nArg, iA
b5e0: 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 20 rg, bNC, xFunc)
b5f0: 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 \. {nArg, SQLIT
b600: 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c E_FUNC_CONSTANT|
b610: 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 SQLITE_UTF8|(bNC
b620: 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 *SQLITE_FUNC_NEE
b630: 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 53 51 4c DCOLL), \. SQL
b640: 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 69 ITE_INT_TO_PTR(i
b650: 41 72 67 29 2c 20 30 2c 20 78 46 75 6e 63 2c 20 Arg), 0, xFunc,
b660: 30 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 30 2c 0, 0, #zName, 0,
b670: 20 30 7d 0a 23 64 65 66 69 6e 65 20 56 46 55 4e 0}.#define VFUN
b680: 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 CTION(zName, nAr
b690: 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 g, iArg, bNC, xF
b6a0: 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 unc) \. {nArg,
b6b0: 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 SQLITE_UTF8|(bNC
b6c0: 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 *SQLITE_FUNC_NEE
b6d0: 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 53 51 4c DCOLL), \. SQL
b6e0: 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 69 ITE_INT_TO_PTR(i
b6f0: 41 72 67 29 2c 20 30 2c 20 78 46 75 6e 63 2c 20 Arg), 0, xFunc,
b700: 30 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 30 2c 0, 0, #zName, 0,
b710: 20 30 7d 0a 23 64 65 66 69 6e 65 20 46 55 4e 43 0}.#define FUNC
b720: 54 49 4f 4e 32 28 7a 4e 61 6d 65 2c 20 6e 41 72 TION2(zName, nAr
b730: 67 2c 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 46 g, iArg, bNC, xF
b740: 75 6e 63 2c 20 65 78 74 72 61 46 6c 61 67 73 29 unc, extraFlags)
b750: 20 5c 0a 20 20 7b 6e 41 72 67 2c 53 51 4c 49 54 \. {nArg,SQLIT
b760: 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c E_FUNC_CONSTANT|
b770: 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 SQLITE_UTF8|(bNC
b780: 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 *SQLITE_FUNC_NEE
b790: 44 43 4f 4c 4c 29 7c 65 78 74 72 61 46 6c 61 67 DCOLL)|extraFlag
b7a0: 73 2c 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e s,\. SQLITE_IN
b7b0: 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 T_TO_PTR(iArg),
b7c0: 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 20 0, xFunc, 0, 0,
b7d0: 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 #zName, 0, 0}.#d
b7e0: 65 66 69 6e 65 20 53 54 52 5f 46 55 4e 43 54 49 efine STR_FUNCTI
b7f0: 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 ON(zName, nArg,
b800: 70 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 pArg, bNC, xFunc
b810: 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c ) \. {nArg, SQL
b820: 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e ITE_FUNC_CONSTAN
b830: 54 7c 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 62 T|SQLITE_UTF8|(b
b840: 4e 43 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e NC*SQLITE_FUNC_N
b850: 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 70 EEDCOLL), \. p
b860: 41 72 67 2c 20 30 2c 20 78 46 75 6e 63 2c 20 30 Arg, 0, xFunc, 0
b870: 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 30 2c 20 , 0, #zName, 0,
b880: 30 7d 0a 23 64 65 66 69 6e 65 20 4c 49 4b 45 46 0}.#define LIKEF
b890: 55 4e 43 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c UNC(zName, nArg,
b8a0: 20 61 72 67 2c 20 66 6c 61 67 73 29 20 5c 0a 20 arg, flags) \.
b8b0: 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 {nArg, SQLITE_F
b8c0: 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c UNC_CONSTANT|SQL
b8d0: 49 54 45 5f 55 54 46 38 7c 66 6c 61 67 73 2c 20 ITE_UTF8|flags,
b8e0: 5c 0a 20 20 20 28 76 6f 69 64 20 2a 29 61 72 67 \. (void *)arg
b8f0: 2c 20 30 2c 20 6c 69 6b 65 46 75 6e 63 2c 20 30 , 0, likeFunc, 0
b900: 2c 20 30 2c 20 23 7a 4e 61 6d 65 2c 20 30 2c 20 , 0, #zName, 0,
b910: 30 7d 0a 23 64 65 66 69 6e 65 20 41 47 47 52 45 0}.#define AGGRE
b920: 47 41 54 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 GATE(zName, nArg
b930: 2c 20 61 72 67 2c 20 6e 63 2c 20 78 53 74 65 70 , arg, nc, xStep
b940: 2c 20 78 46 69 6e 61 6c 29 20 5c 0a 20 20 7b 6e , xFinal) \. {n
b950: 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 Arg, SQLITE_UTF8
b960: 7c 28 6e 63 2a 53 51 4c 49 54 45 5f 46 55 4e 43 |(nc*SQLITE_FUNC
b970: 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 _NEEDCOLL), \.
b980: 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 SQLITE_INT_TO_P
b990: 54 52 28 61 72 67 29 2c 20 30 2c 20 30 2c 20 78 TR(arg), 0, 0, x
b9a0: 53 74 65 70 2c 78 46 69 6e 61 6c 2c 23 7a 4e 61 Step,xFinal,#zNa
b9b0: 6d 65 2c 30 2c 30 7d 0a 0a 2f 2a 0a 2a 2a 20 41 me,0,0}../*.** A
b9c0: 6c 6c 20 63 75 72 72 65 6e 74 20 73 61 76 65 70 ll current savep
b9d0: 6f 69 6e 74 73 20 61 72 65 20 73 74 6f 72 65 64 oints are stored
b9e0: 20 69 6e 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 in a linked lis
b9f0: 74 20 73 74 61 72 74 69 6e 67 20 61 74 0a 2a 2a t starting at.**
ba00: 20 73 71 6c 69 74 65 33 2e 70 53 61 76 65 70 6f sqlite3.pSavepo
ba10: 69 6e 74 2e 20 54 68 65 20 66 69 72 73 74 20 65 int. The first e
ba20: 6c 65 6d 65 6e 74 20 69 6e 20 74 68 65 20 6c 69 lement in the li
ba30: 73 74 20 69 73 20 74 68 65 20 6d 6f 73 74 20 72 st is the most r
ba40: 65 63 65 6e 74 6c 79 0a 2a 2a 20 6f 70 65 6e 65 ecently.** opene
ba50: 64 20 73 61 76 65 70 6f 69 6e 74 2e 20 53 61 76 d savepoint. Sav
ba60: 65 70 6f 69 6e 74 73 20 61 72 65 20 61 64 64 65 epoints are adde
ba70: 64 20 74 6f 20 74 68 65 20 6c 69 73 74 20 62 79 d to the list by
ba80: 20 74 68 65 20 76 64 62 65 0a 2a 2a 20 4f 50 5f the vdbe.** OP_
ba90: 53 61 76 65 70 6f 69 6e 74 20 69 6e 73 74 72 75 Savepoint instru
baa0: 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 ction..*/.struct
bab0: 20 53 61 76 65 70 6f 69 6e 74 20 7b 0a 20 20 63 Savepoint {. c
bac0: 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
bad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bae0: 20 20 20 2f 2a 20 53 61 76 65 70 6f 69 6e 74 20 /* Savepoint
baf0: 6e 61 6d 65 20 28 6e 75 6c 2d 74 65 72 6d 69 6e name (nul-termin
bb00: 61 74 65 64 29 20 2a 2f 0a 20 20 69 36 34 20 6e ated) */. i64 n
bb10: 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 20 20 20 DeferredCons;
bb20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
bb30: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 65 66 65 * Number of defe
bb40: 72 72 65 64 20 66 6b 20 76 69 6f 6c 61 74 69 6f rred fk violatio
bb50: 6e 73 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 ns */. i64 nDef
bb60: 65 72 72 65 64 49 6d 6d 43 6f 6e 73 3b 20 20 20 erredImmCons;
bb70: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
bb80: 75 6d 62 65 72 20 6f 66 20 64 65 66 65 72 72 65 umber of deferre
bb90: 64 20 69 6d 6d 20 66 6b 2e 20 2a 2f 0a 20 20 53 d imm fk. */. S
bba0: 61 76 65 70 6f 69 6e 74 20 2a 70 4e 65 78 74 3b avepoint *pNext;
bbb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bbc0: 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 73 61 76 /* Parent sav
bbd0: 65 70 6f 69 6e 74 20 28 69 66 20 61 6e 79 29 20 epoint (if any)
bbe0: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 */.};../*.** The
bbf0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 75 following are u
bc00: 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e sed as the secon
bc10: 64 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 73 d parameter to s
bc20: 71 6c 69 74 65 33 53 61 76 65 70 6f 69 6e 74 28 qlite3Savepoint(
bc30: 29 2c 0a 2a 2a 20 61 6e 64 20 61 73 20 74 68 65 ),.** and as the
bc40: 20 50 31 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 P1 argument to
bc50: 74 68 65 20 4f 50 5f 53 61 76 65 70 6f 69 6e 74 the OP_Savepoint
bc60: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2f instruction..*/
bc70: 0a 23 64 65 66 69 6e 65 20 53 41 56 45 50 4f 49 .#define SAVEPOI
bc80: 4e 54 5f 42 45 47 49 4e 20 20 20 20 20 20 30 0a NT_BEGIN 0.
bc90: 23 64 65 66 69 6e 65 20 53 41 56 45 50 4f 49 4e #define SAVEPOIN
bca0: 54 5f 52 45 4c 45 41 53 45 20 20 20 20 31 0a 23 T_RELEASE 1.#
bcb0: 64 65 66 69 6e 65 20 53 41 56 45 50 4f 49 4e 54 define SAVEPOINT
bcc0: 5f 52 4f 4c 4c 42 41 43 4b 20 20 20 32 0a 0a 0a _ROLLBACK 2...
bcd0: 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 51 4c 69 74 /*.** Each SQLit
bce0: 65 20 6d 6f 64 75 6c 65 20 28 76 69 72 74 75 61 e module (virtua
bcf0: 6c 20 74 61 62 6c 65 20 64 65 66 69 6e 69 74 69 l table definiti
bd00: 6f 6e 29 20 69 73 20 64 65 66 69 6e 65 64 20 62 on) is defined b
bd10: 79 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 y an.** instance
bd20: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
bd30: 67 20 73 74 72 75 63 74 75 72 65 2c 20 73 74 6f g structure, sto
bd40: 72 65 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 red in the sqlit
bd50: 65 33 2e 61 4d 6f 64 75 6c 65 0a 2a 2a 20 68 61 e3.aModule.** ha
bd60: 73 68 20 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 72 sh table..*/.str
bd70: 75 63 74 20 4d 6f 64 75 6c 65 20 7b 0a 20 20 63 uct Module {. c
bd80: 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 onst sqlite3_mod
bd90: 75 6c 65 20 2a 70 4d 6f 64 75 6c 65 3b 20 20 20 ule *pModule;
bda0: 20 20 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 /* Callback
bdb0: 70 6f 69 6e 74 65 72 73 20 2a 2f 0a 20 20 63 6f pointers */. co
bdc0: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b nst char *zName;
bdd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bde0: 20 20 20 2f 2a 20 4e 61 6d 65 20 70 61 73 73 65 /* Name passe
bdf0: 64 20 74 6f 20 63 72 65 61 74 65 5f 6d 6f 64 75 d to create_modu
be00: 6c 65 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 2a le() */. void *
be10: 70 41 75 78 3b 20 20 20 20 20 20 20 20 20 20 20 pAux;
be20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
be30: 2a 20 70 41 75 78 20 70 61 73 73 65 64 20 74 6f * pAux passed to
be40: 20 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 create_module()
be50: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 */. void (*xDe
be60: 73 74 72 6f 79 29 28 76 6f 69 64 20 2a 29 3b 20 stroy)(void *);
be70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f /* Mo
be80: 64 75 6c 65 20 64 65 73 74 72 75 63 74 6f 72 20 dule destructor
be90: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 7d 3b 0a 0a function */.};..
bea0: 2f 2a 0a 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f /*.** informatio
beb0: 6e 20 61 62 6f 75 74 20 65 61 63 68 20 63 6f 6c n about each col
bec0: 75 6d 6e 20 6f 66 20 61 6e 20 53 51 4c 20 74 61 umn of an SQL ta
bed0: 62 6c 65 20 69 73 20 68 65 6c 64 20 69 6e 20 61 ble is held in a
bee0: 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 n instance.** of
bef0: 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 2e this structure.
bf00: 0a 2a 2f 0a 73 74 72 75 63 74 20 43 6f 6c 75 6d .*/.struct Colum
bf10: 6e 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d n {. char *zNam
bf20: 65 3b 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f e; /* Name o
bf30: 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f f this column */
bf40: 0a 20 20 45 78 70 72 20 2a 70 44 66 6c 74 3b 20 . Expr *pDflt;
bf50: 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 76 /* Default v
bf60: 61 6c 75 65 20 6f 66 20 74 68 69 73 20 63 6f 6c alue of this col
bf70: 75 6d 6e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a umn */. char *z
bf80: 44 66 6c 74 3b 20 20 20 20 20 2f 2a 20 4f 72 69 Dflt; /* Ori
bf90: 67 69 6e 61 6c 20 74 65 78 74 20 6f 66 20 74 68 ginal text of th
bfa0: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 e default value
bfb0: 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 79 70 65 */. char *zType
bfc0: 3b 20 20 20 20 20 2f 2a 20 44 61 74 61 20 74 79 ; /* Data ty
bfd0: 70 65 20 66 6f 72 20 74 68 69 73 20 63 6f 6c 75 pe for this colu
bfe0: 6d 6e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 mn */. char *zC
bff0: 6f 6c 6c 3b 20 20 20 20 20 2f 2a 20 43 6f 6c 6c oll; /* Coll
c000: 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 2e 20 ating sequence.
c010: 20 49 66 20 4e 55 4c 4c 2c 20 75 73 65 20 74 68 If NULL, use th
c020: 65 20 64 65 66 61 75 6c 74 20 2a 2f 0a 20 20 75 e default */. u
c030: 38 20 6e 6f 74 4e 75 6c 6c 3b 20 20 20 20 20 20 8 notNull;
c040: 2f 2a 20 41 6e 20 4f 45 5f 20 63 6f 64 65 20 66 /* An OE_ code f
c050: 6f 72 20 68 61 6e 64 6c 69 6e 67 20 61 20 4e 4f or handling a NO
c060: 54 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e T NULL constrain
c070: 74 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 69 t */. char affi
c080: 6e 69 74 79 3b 20 20 20 2f 2a 20 4f 6e 65 20 6f nity; /* One o
c090: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 41 46 46 f the SQLITE_AFF
c0a0: 5f 2e 2e 2e 20 76 61 6c 75 65 73 20 2a 2f 0a 20 _... values */.
c0b0: 20 75 38 20 73 7a 45 73 74 3b 20 20 20 20 20 20 u8 szEst;
c0c0: 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 73 /* Estimated s
c0d0: 69 7a 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 ize of this colu
c0e0: 6d 6e 2e 20 20 49 4e 54 3d 3d 31 20 2a 2f 0a 20 mn. INT==1 */.
c0f0: 20 75 38 20 63 6f 6c 46 6c 61 67 73 3b 20 20 20 u8 colFlags;
c100: 20 20 2f 2a 20 42 6f 6f 6c 65 61 6e 20 70 72 6f /* Boolean pro
c110: 70 65 72 74 69 65 73 2e 20 20 53 65 65 20 43 4f perties. See CO
c120: 4c 46 4c 41 47 5f 20 64 65 66 69 6e 65 73 20 62 LFLAG_ defines b
c130: 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 elow */.};../* A
c140: 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f llowed values fo
c150: 72 20 43 6f 6c 75 6d 6e 2e 63 6f 6c 46 6c 61 67 r Column.colFlag
c160: 73 3a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f s:.*/.#define CO
c170: 4c 46 4c 41 47 5f 50 52 49 4d 4b 45 59 20 20 30 LFLAG_PRIMKEY 0
c180: 78 30 30 30 31 20 20 20 20 2f 2a 20 43 6f 6c 75 x0001 /* Colu
c190: 6d 6e 20 69 73 20 70 61 72 74 20 6f 66 20 74 68 mn is part of th
c1a0: 65 20 70 72 69 6d 61 72 79 20 6b 65 79 20 2a 2f e primary key */
c1b0: 0a 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 .#define COLFLAG
c1c0: 5f 48 49 44 44 45 4e 20 20 20 30 78 30 30 30 32 _HIDDEN 0x0002
c1d0: 20 20 20 20 2f 2a 20 41 20 68 69 64 64 65 6e 20 /* A hidden
c1e0: 63 6f 6c 75 6d 6e 20 69 6e 20 61 20 76 69 72 74 column in a virt
c1f0: 75 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 0a 2f 2a ual table */../*
c200: 0a 2a 2a 20 41 20 22 43 6f 6c 6c 61 74 69 6e 67 .** A "Collating
c210: 20 53 65 71 75 65 6e 63 65 22 20 69 73 20 64 65 Sequence" is de
c220: 66 69 6e 65 64 20 62 79 20 61 6e 20 69 6e 73 74 fined by an inst
c230: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
c240: 6f 77 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74 75 owing.** structu
c250: 72 65 2e 20 43 6f 6e 63 65 70 74 75 61 6c 6c 79 re. Conceptually
c260: 2c 20 61 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 , a collating se
c270: 71 75 65 6e 63 65 20 63 6f 6e 73 69 73 74 73 20 quence consists
c280: 6f 66 20 61 20 6e 61 6d 65 20 61 6e 64 0a 2a 2a of a name and.**
c290: 20 61 20 63 6f 6d 70 61 72 69 73 6f 6e 20 72 6f a comparison ro
c2a0: 75 74 69 6e 65 20 74 68 61 74 20 64 65 66 69 6e utine that defin
c2b0: 65 73 20 74 68 65 20 6f 72 64 65 72 20 6f 66 20 es the order of
c2c0: 74 68 61 74 20 73 65 71 75 65 6e 63 65 2e 0a 2a that sequence..*
c2d0: 2a 0a 2a 2a 20 49 66 20 43 6f 6c 6c 53 65 71 2e *.** If CollSeq.
c2e0: 78 43 6d 70 20 69 73 20 4e 55 4c 4c 2c 20 69 74 xCmp is NULL, it
c2f0: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 0a means that the.
c300: 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 ** collating seq
c310: 75 65 6e 63 65 20 69 73 20 75 6e 64 65 66 69 6e uence is undefin
c320: 65 64 2e 20 20 49 6e 64 69 63 65 73 20 62 75 69 ed. Indices bui
c330: 6c 74 20 6f 6e 20 61 6e 20 75 6e 64 65 66 69 6e lt on an undefin
c340: 65 64 0a 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 ed.** collating
c350: 73 65 71 75 65 6e 63 65 20 6d 61 79 20 6e 6f 74 sequence may not
c360: 20 62 65 20 72 65 61 64 20 6f 72 20 77 72 69 74 be read or writ
c370: 74 65 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 43 ten..*/.struct C
c380: 6f 6c 6c 53 65 71 20 7b 0a 20 20 63 68 61 72 20 ollSeq {. char
c390: 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 *zName;
c3a0: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 /* Name of the
c3b0: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
c3c0: 63 65 2c 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 ce, UTF-8 encode
c3d0: 64 20 2a 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 d */. u8 enc;
c3e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
c3f0: 54 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 68 61 Text encoding ha
c400: 6e 64 6c 65 64 20 62 79 20 78 43 6d 70 28 29 20 ndled by xCmp()
c410: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 */. void *pUser
c420: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 ; /* Fi
c430: 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 rst argument to
c440: 78 43 6d 70 28 29 20 2a 2f 0a 20 20 69 6e 74 20 xCmp() */. int
c450: 28 2a 78 43 6d 70 29 28 76 6f 69 64 2a 2c 69 6e (*xCmp)(void*,in
c460: 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 t, const void*,
c470: 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a int, const void*
c480: 29 3b 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 6c );. void (*xDel
c490: 29 28 76 6f 69 64 2a 29 3b 20 20 2f 2a 20 44 65 )(void*); /* De
c4a0: 73 74 72 75 63 74 6f 72 20 66 6f 72 20 70 55 73 structor for pUs
c4b0: 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 er */.};../*.**
c4c0: 41 20 73 6f 72 74 20 6f 72 64 65 72 20 63 61 6e A sort order can
c4d0: 20 62 65 20 65 69 74 68 65 72 20 41 53 43 20 6f be either ASC o
c4e0: 72 20 44 45 53 43 2e 0a 2a 2f 0a 23 64 65 66 69 r DESC..*/.#defi
c4f0: 6e 65 20 53 51 4c 49 54 45 5f 53 4f 5f 41 53 43 ne SQLITE_SO_ASC
c500: 20 20 20 20 20 20 20 30 20 20 2f 2a 20 53 6f 72 0 /* Sor
c510: 74 20 69 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f t in ascending o
c520: 72 64 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 rder */.#define
c530: 53 51 4c 49 54 45 5f 53 4f 5f 44 45 53 43 20 20 SQLITE_SO_DESC
c540: 20 20 20 20 31 20 20 2f 2a 20 53 6f 72 74 20 69 1 /* Sort i
c550: 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 n ascending orde
c560: 72 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6c 75 r */../*.** Colu
c570: 6d 6e 20 61 66 66 69 6e 69 74 79 20 74 79 70 65 mn affinity type
c580: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 75 s..**.** These u
c590: 73 65 64 20 74 6f 20 68 61 76 65 20 6d 6e 65 6d sed to have mnem
c5a0: 6f 6e 69 63 20 6e 61 6d 65 20 6c 69 6b 65 20 27 onic name like '
c5b0: 69 27 20 66 6f 72 20 53 51 4c 49 54 45 5f 41 46 i' for SQLITE_AF
c5c0: 46 5f 49 4e 54 45 47 45 52 20 61 6e 64 0a 2a 2a F_INTEGER and.**
c5d0: 20 27 74 27 20 66 6f 72 20 53 51 4c 49 54 45 5f 't' for SQLITE_
c5e0: 41 46 46 5f 54 45 58 54 2e 20 20 42 75 74 20 77 AFF_TEXT. But w
c5f0: 65 20 63 61 6e 20 73 61 76 65 20 61 20 6c 69 74 e can save a lit
c600: 74 6c 65 20 73 70 61 63 65 20 61 6e 64 20 69 6d tle space and im
c610: 70 72 6f 76 65 0a 2a 2a 20 74 68 65 20 73 70 65 prove.** the spe
c620: 65 64 20 61 20 6c 69 74 74 6c 65 20 62 79 20 6e ed a little by n
c630: 75 6d 62 65 72 69 6e 67 20 74 68 65 20 76 61 6c umbering the val
c640: 75 65 73 20 63 6f 6e 73 65 63 75 74 69 76 65 6c ues consecutivel
c650: 79 2e 20 20 0a 2a 2a 0a 2a 2a 20 42 75 74 20 72 y. .**.** But r
c660: 61 74 68 65 72 20 74 68 61 6e 20 73 74 61 72 74 ather than start
c670: 20 77 69 74 68 20 30 20 6f 72 20 31 2c 20 77 65 with 0 or 1, we
c680: 20 62 65 67 69 6e 20 77 69 74 68 20 27 61 27 2e begin with 'a'.
c690: 20 20 54 68 61 74 20 77 61 79 2c 0a 2a 2a 20 77 That way,.** w
c6a0: 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 61 66 66 hen multiple aff
c6b0: 69 6e 69 74 79 20 74 79 70 65 73 20 61 72 65 20 inity types are
c6c0: 63 6f 6e 63 61 74 65 6e 61 74 65 64 20 69 6e 74 concatenated int
c6d0: 6f 20 61 20 73 74 72 69 6e 67 20 61 6e 64 0a 2a o a string and.*
c6e0: 2a 20 75 73 65 64 20 61 73 20 74 68 65 20 50 34 * used as the P4
c6f0: 20 6f 70 65 72 61 6e 64 2c 20 74 68 65 79 20 77 operand, they w
c700: 69 6c 6c 20 62 65 20 6d 6f 72 65 20 72 65 61 64 ill be more read
c710: 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 able..**.** Note
c720: 20 61 6c 73 6f 20 74 68 61 74 20 74 68 65 20 6e also that the n
c730: 75 6d 65 72 69 63 20 74 79 70 65 73 20 61 72 65 umeric types are
c740: 20 67 72 6f 75 70 65 64 20 74 6f 67 65 74 68 65 grouped togethe
c750: 72 20 73 6f 20 74 68 61 74 20 74 65 73 74 69 6e r so that testin
c760: 67 0a 2a 2a 20 66 6f 72 20 61 20 6e 75 6d 65 72 g.** for a numer
c770: 69 63 20 74 79 70 65 20 69 73 20 61 20 73 69 6e ic type is a sin
c780: 67 6c 65 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 0a gle comparison..
c790: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
c7a0: 45 5f 41 46 46 5f 54 45 58 54 20 20 20 20 20 27 E_AFF_TEXT '
c7b0: 61 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 a'.#define SQLIT
c7c0: 45 5f 41 46 46 5f 4e 4f 4e 45 20 20 20 20 20 27 E_AFF_NONE '
c7d0: 62 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 b'.#define SQLIT
c7e0: 45 5f 41 46 46 5f 4e 55 4d 45 52 49 43 20 20 27 E_AFF_NUMERIC '
c7f0: 63 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 c'.#define SQLIT
c800: 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 20 20 27 E_AFF_INTEGER '
c810: 64 27 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 d'.#define SQLIT
c820: 45 5f 41 46 46 5f 52 45 41 4c 20 20 20 20 20 27 E_AFF_REAL '
c830: 65 27 0a 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 e'..#define sqli
c840: 74 65 33 49 73 4e 75 6d 65 72 69 63 41 66 66 69 te3IsNumericAffi
c850: 6e 69 74 79 28 58 29 20 20 28 28 58 29 3e 3d 53 nity(X) ((X)>=S
c860: 51 4c 49 54 45 5f 41 46 46 5f 4e 55 4d 45 52 49 QLITE_AFF_NUMERI
c870: 43 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 C)../*.** The SQ
c880: 4c 49 54 45 5f 41 46 46 5f 4d 41 53 4b 20 76 61 LITE_AFF_MASK va
c890: 6c 75 65 73 20 6d 61 73 6b 73 20 6f 66 66 20 74 lues masks off t
c8a0: 68 65 20 73 69 67 6e 69 66 69 63 61 6e 74 20 62 he significant b
c8b0: 69 74 73 20 6f 66 20 61 6e 0a 2a 2a 20 61 66 66 its of an.** aff
c8c0: 69 6e 69 74 79 20 76 61 6c 75 65 2e 20 0a 2a 2f inity value. .*/
c8d0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
c8e0: 41 46 46 5f 4d 41 53 4b 20 20 20 20 20 30 78 36 AFF_MASK 0x6
c8f0: 37 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 69 74 69 6f 7../*.** Additio
c900: 6e 61 6c 20 62 69 74 20 76 61 6c 75 65 73 20 74 nal bit values t
c910: 68 61 74 20 63 61 6e 20 62 65 20 4f 52 65 64 20 hat can be ORed
c920: 77 69 74 68 20 61 6e 20 61 66 66 69 6e 69 74 79 with an affinity
c930: 20 77 69 74 68 6f 75 74 0a 2a 2a 20 63 68 61 6e without.** chan
c940: 67 69 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 ging the affinit
c950: 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 y..*/.#define SQ
c960: 4c 49 54 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c 20 LITE_JUMPIFNULL
c970: 20 20 30 78 30 38 20 20 2f 2a 20 6a 75 6d 70 73 0x08 /* jumps
c980: 20 69 66 20 65 69 74 68 65 72 20 6f 70 65 72 61 if either opera
c990: 6e 64 20 69 73 20 4e 55 4c 4c 20 2a 2f 0a 23 64 nd is NULL */.#d
c9a0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 54 4f efine SQLITE_STO
c9b0: 52 45 50 32 20 20 20 20 20 20 30 78 31 30 20 20 REP2 0x10
c9c0: 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 /* Store result
c9d0: 69 6e 20 72 65 67 5b 50 32 5d 20 72 61 74 68 65 in reg[P2] rathe
c9e0: 72 20 74 68 61 6e 20 6a 75 6d 70 20 2a 2f 0a 23 r than jump */.#
c9f0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 55 define SQLITE_NU
ca00: 4c 4c 45 51 20 20 20 20 20 20 20 30 78 38 30 20 LLEQ 0x80
ca10: 20 2f 2a 20 4e 55 4c 4c 3d 4e 55 4c 4c 20 2a 2f /* NULL=NULL */
ca20: 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 6f 62 6a 65 63 ../*.** An objec
ca30: 74 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 69 t of this type i
ca40: 73 20 63 72 65 61 74 65 64 20 66 6f 72 20 65 61 s created for ea
ca50: 63 68 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ch virtual table
ca60: 20 70 72 65 73 65 6e 74 20 69 6e 0a 2a 2a 20 74 present in.** t
ca70: 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 he database sche
ca80: 6d 61 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ma. .**.** If th
ca90: 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d e database schem
caa0: 61 20 69 73 20 73 68 61 72 65 64 2c 20 74 68 65 a is shared, the
cab0: 6e 20 74 68 65 72 65 20 69 73 20 6f 6e 65 20 69 n there is one i
cac0: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 0a nstance of this.
cad0: 2a 2a 20 73 74 72 75 63 74 75 72 65 20 66 6f 72 ** structure for
cae0: 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20 63 each database c
caf0: 6f 6e 6e 65 63 74 69 6f 6e 20 28 73 71 6c 69 74 onnection (sqlit
cb00: 65 33 2a 29 20 74 68 61 74 20 75 73 65 73 20 74 e3*) that uses t
cb10: 68 65 20 73 68 61 72 65 64 0a 2a 2a 20 73 63 68 he shared.** sch
cb20: 65 6d 61 2e 20 54 68 69 73 20 69 73 20 62 65 63 ema. This is bec
cb30: 61 75 73 65 20 65 61 63 68 20 64 61 74 61 62 61 ause each databa
cb40: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 72 65 se connection re
cb50: 71 75 69 72 65 73 20 69 74 73 20 6f 77 6e 20 75 quires its own u
cb60: 6e 69 71 75 65 0a 2a 2a 20 69 6e 73 74 61 6e 63 nique.** instanc
cb70: 65 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 e of the sqlite3
cb80: 5f 76 74 61 62 2a 20 68 61 6e 64 6c 65 20 75 73 _vtab* handle us
cb90: 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 ed to access the
cba0: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 0a virtual table .
cbb0: 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ** implementatio
cbc0: 6e 2e 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a n. sqlite3_vtab*
cbd0: 20 68 61 6e 64 6c 65 73 20 63 61 6e 20 6e 6f 74 handles can not
cbe0: 20 62 65 20 73 68 61 72 65 64 20 62 65 74 77 65 be shared betwe
cbf0: 65 6e 20 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 en .** database
cc00: 63 6f 6e 6e 65 63 74 69 6f 6e 73 2c 20 65 76 65 connections, eve
cc10: 6e 20 77 68 65 6e 20 74 68 65 20 72 65 73 74 20 n when the rest
cc20: 6f 66 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 of the in-memory
cc30: 20 64 61 74 61 62 61 73 65 20 0a 2a 2a 20 73 63 database .** sc
cc40: 68 65 6d 61 20 69 73 20 73 68 61 72 65 64 2c 20 hema is shared,
cc50: 61 73 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 as the implement
cc60: 61 74 69 6f 6e 20 6f 66 74 65 6e 20 73 74 6f 72 ation often stor
cc70: 65 73 20 74 68 65 20 64 61 74 61 62 61 73 65 0a es the database.
cc80: 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 ** connection ha
cc90: 6e 64 6c 65 20 70 61 73 73 65 64 20 74 6f 20 69 ndle passed to i
cca0: 74 20 76 69 61 20 74 68 65 20 78 43 6f 6e 6e 65 t via the xConne
ccb0: 63 74 28 29 20 6f 72 20 78 43 72 65 61 74 65 28 ct() or xCreate(
ccc0: 29 20 6d 65 74 68 6f 64 0a 2a 2a 20 64 75 72 69 ) method.** duri
ccd0: 6e 67 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f ng initializatio
cce0: 6e 20 69 6e 74 65 72 6e 61 6c 6c 79 2e 20 54 68 n internally. Th
ccf0: 69 73 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e is database conn
cd00: 65 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 6d 61 ection handle ma
cd10: 79 0a 2a 2a 20 74 68 65 6e 20 62 65 20 75 73 65 y.** then be use
cd20: 64 20 62 79 20 74 68 65 20 76 69 72 74 75 61 6c d by the virtual
cd30: 20 74 61 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 table implement
cd40: 61 74 69 6f 6e 20 74 6f 20 61 63 63 65 73 73 20 ation to access
cd50: 72 65 61 6c 20 74 61 62 6c 65 73 20 0a 2a 2a 20 real tables .**
cd60: 77 69 74 68 69 6e 20 74 68 65 20 64 61 74 61 62 within the datab
cd70: 61 73 65 2e 20 53 6f 20 74 68 61 74 20 74 68 65 ase. So that the
cd80: 79 20 61 70 70 65 61 72 20 61 73 20 70 61 72 74 y appear as part
cd90: 20 6f 66 20 74 68 65 20 63 61 6c 6c 65 72 73 20 of the callers
cda0: 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c .** transaction,
cdb0: 20 74 68 65 73 65 20 61 63 63 65 73 73 65 73 20 these accesses
cdc0: 6e 65 65 64 20 74 6f 20 62 65 20 6d 61 64 65 20 need to be made
cdd0: 76 69 61 20 74 68 65 20 73 61 6d 65 20 64 61 74 via the same dat
cde0: 61 62 61 73 65 20 0a 2a 2a 20 63 6f 6e 6e 65 63 abase .** connec
cdf0: 74 69 6f 6e 20 61 73 20 74 68 61 74 20 75 73 65 tion as that use
ce00: 64 20 74 6f 20 65 78 65 63 75 74 65 20 53 51 4c d to execute SQL
ce10: 20 6f 70 65 72 61 74 69 6f 6e 73 20 6f 6e 20 74 operations on t
ce20: 68 65 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 he virtual table
ce30: 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 56 54 61 62 ..**.** All VTab
ce40: 6c 65 20 6f 62 6a 65 63 74 73 20 74 68 61 74 20 le objects that
ce50: 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 61 20 correspond to a
ce60: 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 69 6e 20 single table in
ce70: 61 20 73 68 61 72 65 64 0a 2a 2a 20 64 61 74 61 a shared.** data
ce80: 62 61 73 65 20 73 63 68 65 6d 61 20 61 72 65 20 base schema are
ce90: 69 6e 69 74 69 61 6c 6c 79 20 73 74 6f 72 65 64 initially stored
cea0: 20 69 6e 20 61 20 6c 69 6e 6b 65 64 2d 6c 69 73 in a linked-lis
ceb0: 74 20 70 6f 69 6e 74 65 64 20 74 6f 20 62 79 0a t pointed to by.
cec0: 2a 2a 20 74 68 65 20 54 61 62 6c 65 2e 70 56 54 ** the Table.pVT
ced0: 61 62 6c 65 20 6d 65 6d 62 65 72 20 76 61 72 69 able member vari
cee0: 61 62 6c 65 20 6f 66 20 74 68 65 20 63 6f 72 72 able of the corr
cef0: 65 73 70 6f 6e 64 69 6e 67 20 54 61 62 6c 65 20 esponding Table
cf00: 6f 62 6a 65 63 74 2e 0a 2a 2a 20 57 68 65 6e 20 object..** When
cf10: 61 6e 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 an sqlite3_prepa
cf20: 72 65 28 29 20 6f 70 65 72 61 74 69 6f 6e 20 69 re() operation i
cf30: 73 20 72 65 71 75 69 72 65 64 20 74 6f 20 61 63 s required to ac
cf40: 63 65 73 73 20 74 68 65 20 76 69 72 74 75 61 6c cess the virtual
cf50: 0a 2a 2a 20 74 61 62 6c 65 2c 20 69 74 20 73 65 .** table, it se
cf60: 61 72 63 68 65 73 20 74 68 65 20 6c 69 73 74 20 arches the list
cf70: 66 6f 72 20 74 68 65 20 56 54 61 62 6c 65 20 74 for the VTable t
cf80: 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 hat corresponds
cf90: 74 6f 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 to the.** databa
cfa0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 64 6f se connection do
cfb0: 69 6e 67 20 74 68 65 20 70 72 65 70 61 72 69 6e ing the preparin
cfc0: 67 20 73 6f 20 61 73 20 74 6f 20 75 73 65 20 74 g so as to use t
cfd0: 68 65 20 63 6f 72 72 65 63 74 0a 2a 2a 20 73 71 he correct.** sq
cfe0: 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 lite3_vtab* hand
cff0: 6c 65 20 69 6e 20 74 68 65 20 63 6f 6d 70 69 6c le in the compil
d000: 65 64 20 71 75 65 72 79 2e 0a 2a 2a 0a 2a 2a 20 ed query..**.**
d010: 57 68 65 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72 When an in-memor
d020: 79 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 20 69 y Table object i
d030: 73 20 64 65 6c 65 74 65 64 20 28 66 6f 72 20 65 s deleted (for e
d040: 78 61 6d 70 6c 65 20 77 68 65 6e 20 74 68 65 0a xample when the.
d050: 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 62 65 69 ** schema is bei
d060: 6e 67 20 72 65 6c 6f 61 64 65 64 20 66 6f 72 20 ng reloaded for
d070: 73 6f 6d 65 20 72 65 61 73 6f 6e 29 2c 20 74 68 some reason), th
d080: 65 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 74 73 e VTable objects
d090: 20 61 72 65 20 6e 6f 74 20 0a 2a 2a 20 64 65 6c are not .** del
d0a0: 65 74 65 64 20 61 6e 64 20 74 68 65 20 73 71 6c eted and the sql
d0b0: 69 74 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 6c ite3_vtab* handl
d0c0: 65 73 20 61 72 65 20 6e 6f 74 20 78 44 69 73 63 es are not xDisc
d0d0: 6f 6e 6e 65 63 74 28 29 65 64 20 0a 2a 2a 20 69 onnect()ed .** i
d0e0: 6d 6d 65 64 69 61 74 65 6c 79 2e 20 49 6e 73 74 mmediately. Inst
d0f0: 65 61 64 2c 20 74 68 65 79 20 61 72 65 20 6d 6f ead, they are mo
d100: 76 65 64 20 66 72 6f 6d 20 74 68 65 20 54 61 62 ved from the Tab
d110: 6c 65 2e 70 56 54 61 62 6c 65 20 6c 69 73 74 20 le.pVTable list
d120: 74 6f 0a 2a 2a 20 61 6e 6f 74 68 65 72 20 6c 69 to.** another li
d130: 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 64 65 64 nked list headed
d140: 20 62 79 20 74 68 65 20 73 71 6c 69 74 65 33 2e by the sqlite3.
d150: 70 44 69 73 63 6f 6e 6e 65 63 74 20 6d 65 6d 62 pDisconnect memb
d160: 65 72 20 6f 66 20 74 68 65 0a 2a 2a 20 63 6f 72 er of the.** cor
d170: 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c 69 74 responding sqlit
d180: 65 33 20 73 74 72 75 63 74 75 72 65 2e 20 54 68 e3 structure. Th
d190: 65 79 20 61 72 65 20 74 68 65 6e 20 64 65 6c 65 ey are then dele
d1a0: 74 65 64 2f 78 44 69 73 63 6f 6e 6e 65 63 74 65 ted/xDisconnecte
d1b0: 64 20 0a 2a 2a 20 6e 65 78 74 20 74 69 6d 65 20 d .** next time
d1c0: 61 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 70 a statement is p
d1d0: 72 65 70 61 72 65 64 20 75 73 69 6e 67 20 73 61 repared using sa
d1e0: 69 64 20 73 71 6c 69 74 65 33 2a 2e 20 54 68 69 id sqlite3*. Thi
d1f0: 73 20 69 73 20 64 6f 6e 65 0a 2a 2a 20 74 6f 20 s is done.** to
d200: 61 76 6f 69 64 20 64 65 61 64 6c 6f 63 6b 20 69 avoid deadlock i
d210: 73 73 75 65 73 20 69 6e 76 6f 6c 76 69 6e 67 20 ssues involving
d220: 6d 75 6c 74 69 70 6c 65 20 73 71 6c 69 74 65 33 multiple sqlite3
d230: 2e 6d 75 74 65 78 20 6d 75 74 65 78 65 73 2e 0a .mutex mutexes..
d240: 2a 2a 20 52 65 66 65 72 20 74 6f 20 63 6f 6d 6d ** Refer to comm
d250: 65 6e 74 73 20 61 62 6f 76 65 20 66 75 6e 63 74 ents above funct
d260: 69 6f 6e 20 73 71 6c 69 74 65 33 56 74 61 62 55 ion sqlite3VtabU
d270: 6e 6c 6f 63 6b 4c 69 73 74 28 29 20 66 6f 72 20 nlockList() for
d280: 61 6e 0a 2a 2a 20 65 78 70 6c 61 6e 61 74 69 6f an.** explanatio
d290: 6e 20 61 73 20 74 6f 20 77 68 79 20 69 74 20 69 n as to why it i
d2a0: 73 20 73 61 66 65 20 74 6f 20 61 64 64 20 61 6e s safe to add an
d2b0: 20 65 6e 74 72 79 20 74 6f 20 61 6e 20 73 71 6c entry to an sql
d2c0: 69 74 65 33 2e 70 44 69 73 63 6f 6e 6e 65 63 74 ite3.pDisconnect
d2d0: 0a 2a 2a 20 6c 69 73 74 20 77 69 74 68 6f 75 74 .** list without
d2e0: 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 63 6f 72 holding the cor
d2f0: 72 65 73 70 6f 6e 64 69 6e 67 20 73 71 6c 69 74 responding sqlit
d300: 65 33 2e 6d 75 74 65 78 20 6d 75 74 65 78 2e 0a e3.mutex mutex..
d310: 2a 2a 0a 2a 2a 20 54 68 65 20 6d 65 6d 6f 72 79 **.** The memory
d320: 20 66 6f 72 20 6f 62 6a 65 63 74 73 20 6f 66 20 for objects of
d330: 74 68 69 73 20 74 79 70 65 20 69 73 20 61 6c 77 this type is alw
d340: 61 79 73 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 ays allocated by
d350: 20 0a 2a 2a 20 73 71 6c 69 74 65 33 44 62 4d 61 .** sqlite3DbMa
d360: 6c 6c 6f 63 28 29 2c 20 75 73 69 6e 67 20 74 68 lloc(), using th
d370: 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e e connection han
d380: 64 6c 65 20 73 74 6f 72 65 64 20 69 6e 20 56 54 dle stored in VT
d390: 61 62 6c 65 2e 64 62 20 61 73 20 0a 2a 2a 20 74 able.db as .** t
d3a0: 68 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e he first argumen
d3b0: 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56 54 61 t..*/.struct VTa
d3c0: 62 6c 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 ble {. sqlite3
d3d0: 2a 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 *db;
d3e0: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f /* Database co
d3f0: 6e 6e 65 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 nnection associa
d400: 74 65 64 20 77 69 74 68 20 74 68 69 73 20 74 61 ted with this ta
d410: 62 6c 65 20 2a 2f 0a 20 20 4d 6f 64 75 6c 65 20 ble */. Module
d420: 2a 70 4d 6f 64 3b 20 20 20 20 20 20 20 20 20 20 *pMod;
d430: 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f /* Pointer to
d440: 20 6d 6f 64 75 6c 65 20 69 6d 70 6c 65 6d 65 6e module implemen
d450: 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 73 71 6c 69 tation */. sqli
d460: 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62 3b te3_vtab *pVtab;
d470: 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 /* Pointer
d480: 20 74 6f 20 76 74 61 62 20 69 6e 73 74 61 6e 63 to vtab instanc
d490: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b e */. int nRef;
d4a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d4b0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f /* Number of po
d4c0: 69 6e 74 65 72 73 20 74 6f 20 74 68 69 73 20 73 inters to this s
d4d0: 74 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 75 38 tructure */. u8
d4e0: 20 62 43 6f 6e 73 74 72 61 69 6e 74 3b 20 20 20 bConstraint;
d4f0: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
d500: 69 66 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 if constraints a
d510: 72 65 20 73 75 70 70 6f 72 74 65 64 20 2a 2f 0a re supported */.
d520: 20 20 69 6e 74 20 69 53 61 76 65 70 6f 69 6e 74 int iSavepoint
d530: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 ; /* D
d540: 65 70 74 68 20 6f 66 20 74 68 65 20 53 41 56 45 epth of the SAVE
d550: 50 4f 49 4e 54 20 73 74 61 63 6b 20 2a 2f 0a 20 POINT stack */.
d560: 20 56 54 61 62 6c 65 20 2a 70 4e 65 78 74 3b 20 VTable *pNext;
d570: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 /* Ne
d580: 78 74 20 69 6e 20 6c 69 6e 6b 65 64 20 6c 69 73 xt in linked lis
d590: 74 20 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f t (see above) */
d5a0: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 .};../*.** Each
d5b0: 53 51 4c 20 74 61 62 6c 65 20 69 73 20 72 65 70 SQL table is rep
d5c0: 72 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 6d 6f resented in memo
d5d0: 72 79 20 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 ry by an instanc
d5e0: 65 20 6f 66 20 74 68 65 0a 2a 2a 20 66 6f 6c 6c e of the.** foll
d5f0: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e owing structure.
d600: 0a 2a 2a 0a 2a 2a 20 54 61 62 6c 65 2e 7a 4e 61 .**.** Table.zNa
d610: 6d 65 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f me is the name o
d620: 66 20 74 68 65 20 74 61 62 6c 65 2e 20 20 54 68 f the table. Th
d630: 65 20 63 61 73 65 20 6f 66 20 74 68 65 20 6f 72 e case of the or
d640: 69 67 69 6e 61 6c 0a 2a 2a 20 43 52 45 41 54 45 iginal.** CREATE
d650: 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 TABLE statement
d660: 20 69 73 20 73 74 6f 72 65 64 2c 20 62 75 74 20 is stored, but
d670: 63 61 73 65 20 69 73 20 6e 6f 74 20 73 69 67 6e case is not sign
d680: 69 66 69 63 61 6e 74 20 66 6f 72 0a 2a 2a 20 63 ificant for.** c
d690: 6f 6d 70 61 72 69 73 6f 6e 73 2e 0a 2a 2a 0a 2a omparisons..**.*
d6a0: 2a 20 54 61 62 6c 65 2e 6e 43 6f 6c 20 69 73 20 * Table.nCol is
d6b0: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f the number of co
d6c0: 6c 75 6d 6e 73 20 69 6e 20 74 68 69 73 20 74 61 lumns in this ta
d6d0: 62 6c 65 2e 20 20 54 61 62 6c 65 2e 61 43 6f 6c ble. Table.aCol
d6e0: 20 69 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 72 is a.** pointer
d6f0: 20 74 6f 20 61 6e 20 61 72 72 61 79 20 6f 66 20 to an array of
d700: 43 6f 6c 75 6d 6e 20 73 74 72 75 63 74 75 72 65 Column structure
d710: 73 2c 20 6f 6e 65 20 66 6f 72 20 65 61 63 68 20 s, one for each
d720: 63 6f 6c 75 6d 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 column..**.** If
d730: 20 74 68 65 20 74 61 62 6c 65 20 68 61 73 20 61 the table has a
d740: 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 n INTEGER PRIMAR
d750: 59 20 4b 45 59 2c 20 74 68 65 6e 20 54 61 62 6c Y KEY, then Tabl
d760: 65 2e 69 50 4b 65 79 20 69 73 20 74 68 65 20 69 e.iPKey is the i
d770: 6e 64 65 78 20 6f 66 0a 2a 2a 20 74 68 65 20 63 ndex of.** the c
d780: 6f 6c 75 6d 6e 20 74 68 61 74 20 69 73 20 74 68 olumn that is th
d790: 61 74 20 6b 65 79 2e 20 20 20 4f 74 68 65 72 77 at key. Otherw
d7a0: 69 73 65 20 54 61 62 6c 65 2e 69 50 4b 65 79 20 ise Table.iPKey
d7b0: 69 73 20 6e 65 67 61 74 69 76 65 2e 20 20 4e 6f is negative. No
d7c0: 74 65 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 64 te.** that the d
d7d0: 61 74 61 74 79 70 65 20 6f 66 20 74 68 65 20 50 atatype of the P
d7e0: 52 49 4d 41 52 59 20 4b 45 59 20 6d 75 73 74 20 RIMARY KEY must
d7f0: 62 65 20 49 4e 54 45 47 45 52 20 66 6f 72 20 74 be INTEGER for t
d800: 68 69 73 20 66 69 65 6c 64 20 74 6f 0a 2a 2a 20 his field to.**
d810: 62 65 20 73 65 74 2e 20 20 41 6e 20 49 4e 54 45 be set. An INTE
d820: 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 GER PRIMARY KEY
d830: 69 73 20 75 73 65 64 20 61 73 20 74 68 65 20 72 is used as the r
d840: 6f 77 69 64 20 66 6f 72 20 65 61 63 68 20 72 6f owid for each ro
d850: 77 20 6f 66 0a 2a 2a 20 74 68 65 20 74 61 62 6c w of.** the tabl
d860: 65 2e 20 20 49 66 20 61 20 74 61 62 6c 65 20 68 e. If a table h
d870: 61 73 20 6e 6f 20 49 4e 54 45 47 45 52 20 50 52 as no INTEGER PR
d880: 49 4d 41 52 59 20 4b 45 59 2c 20 74 68 65 6e 20 IMARY KEY, then
d890: 61 20 72 61 6e 64 6f 6d 20 72 6f 77 69 64 0a 2a a random rowid.*
d8a0: 2a 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 66 * is generated f
d8b0: 6f 72 20 65 61 63 68 20 72 6f 77 20 6f 66 20 74 or each row of t
d8c0: 68 65 20 74 61 62 6c 65 2e 20 20 54 46 5f 48 61 he table. TF_Ha
d8d0: 73 50 72 69 6d 61 72 79 4b 65 79 20 69 73 20 73 sPrimaryKey is s
d8e0: 65 74 20 69 66 0a 2a 2a 20 74 68 65 20 74 61 62 et if.** the tab
d8f0: 6c 65 20 68 61 73 20 61 6e 79 20 50 52 49 4d 41 le has any PRIMA
d900: 52 59 20 4b 45 59 2c 20 49 4e 54 45 47 45 52 20 RY KEY, INTEGER
d910: 6f 72 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2a or otherwise..**
d920: 0a 2a 2a 20 54 61 62 6c 65 2e 74 6e 75 6d 20 69 .** Table.tnum i
d930: 73 20 74 68 65 20 70 61 67 65 20 6e 75 6d 62 65 s the page numbe
d940: 72 20 66 6f 72 20 74 68 65 20 72 6f 6f 74 20 42 r for the root B
d950: 54 72 65 65 20 70 61 67 65 20 6f 66 20 74 68 65 Tree page of the
d960: 20 74 61 62 6c 65 20 69 6e 20 74 68 65 0a 2a 2a table in the.**
d970: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 database file.
d980: 20 49 66 20 54 61 62 6c 65 2e 69 44 62 20 69 73 If Table.iDb is
d990: 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 the index of th
d9a0: 65 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 e database table
d9b0: 20 62 61 63 6b 65 6e 64 0a 2a 2a 20 69 6e 20 73 backend.** in s
d9c0: 71 6c 69 74 65 2e 61 44 62 5b 5d 2e 20 20 30 20 qlite.aDb[]. 0
d9d0: 69 73 20 66 6f 72 20 74 68 65 20 6d 61 69 6e 20 is for the main
d9e0: 64 61 74 61 62 61 73 65 20 61 6e 64 20 31 20 69 database and 1 i
d9f0: 73 20 66 6f 72 20 74 68 65 20 66 69 6c 65 20 74 s for the file t
da00: 68 61 74 0a 2a 2a 20 68 6f 6c 64 73 20 74 65 6d hat.** holds tem
da10: 70 6f 72 61 72 79 20 74 61 62 6c 65 73 20 61 6e porary tables an
da20: 64 20 69 6e 64 69 63 65 73 2e 20 20 49 66 20 54 d indices. If T
da30: 46 5f 45 70 68 65 6d 65 72 61 6c 20 69 73 20 73 F_Ephemeral is s
da40: 65 74 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 74 et.** then the t
da50: 61 62 6c 65 20 69 73 20 73 74 6f 72 65 64 20 69 able is stored i
da60: 6e 20 61 20 66 69 6c 65 20 74 68 61 74 20 69 73 n a file that is
da70: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 64 automatically d
da80: 65 6c 65 74 65 64 0a 2a 2a 20 77 68 65 6e 20 74 eleted.** when t
da90: 68 65 20 56 44 42 45 20 63 75 72 73 6f 72 20 74 he VDBE cursor t
daa0: 6f 20 74 68 65 20 74 61 62 6c 65 20 69 73 20 63 o the table is c
dab0: 6c 6f 73 65 64 2e 20 20 49 6e 20 74 68 69 73 20 losed. In this
dac0: 63 61 73 65 20 54 61 62 6c 65 2e 74 6e 75 6d 20 case Table.tnum
dad0: 0a 2a 2a 20 72 65 66 65 72 73 20 56 44 42 45 20 .** refers VDBE
dae0: 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 74 68 cursor number th
daf0: 61 74 20 68 6f 6c 64 73 20 74 68 65 20 74 61 62 at holds the tab
db00: 6c 65 20 6f 70 65 6e 2c 20 6e 6f 74 20 74 6f 20 le open, not to
db10: 74 68 65 20 72 6f 6f 74 0a 2a 2a 20 70 61 67 65 the root.** page
db20: 20 6e 75 6d 62 65 72 2e 20 20 54 72 61 6e 73 69 number. Transi
db30: 65 6e 74 20 74 61 62 6c 65 73 20 61 72 65 20 75 ent tables are u
db40: 73 65 64 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 sed to hold the
db50: 72 65 73 75 6c 74 73 20 6f 66 20 61 0a 2a 2a 20 results of a.**
db60: 73 75 62 2d 71 75 65 72 79 20 74 68 61 74 20 61 sub-query that a
db70: 70 70 65 61 72 73 20 69 6e 73 74 65 61 64 20 6f ppears instead o
db80: 66 20 61 20 72 65 61 6c 20 74 61 62 6c 65 20 6e f a real table n
db90: 61 6d 65 20 69 6e 20 74 68 65 20 46 52 4f 4d 20 ame in the FROM
dba0: 63 6c 61 75 73 65 20 0a 2a 2a 20 6f 66 20 61 20 clause .** of a
dbb0: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 SELECT statement
dbc0: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 54 61 62 6c ..*/.struct Tabl
dbd0: 65 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d e {. char *zNam
dbe0: 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 e; /* Na
dbf0: 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 me of the table
dc00: 6f 72 20 76 69 65 77 20 2a 2f 0a 20 20 43 6f 6c or view */. Col
dc10: 75 6d 6e 20 2a 61 43 6f 6c 3b 20 20 20 20 20 20 umn *aCol;
dc20: 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e /* Information
dc30: 20 61 62 6f 75 74 20 65 61 63 68 20 63 6f 6c 75 about each colu
dc40: 6d 6e 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 mn */. Index *p
dc50: 49 6e 64 65 78 3b 20 20 20 20 20 20 20 2f 2a 20 Index; /*
dc60: 4c 69 73 74 20 6f 66 20 53 51 4c 20 69 6e 64 65 List of SQL inde
dc70: 78 65 73 20 6f 6e 20 74 68 69 73 20 74 61 62 6c xes on this tabl
dc80: 65 2e 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a e. */. Select *
dc90: 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 pSelect; /*
dca0: 4e 55 4c 4c 20 66 6f 72 20 74 61 62 6c 65 73 2e NULL for tables.
dcb0: 20 20 50 6f 69 6e 74 73 20 74 6f 20 64 65 66 69 Points to defi
dcc0: 6e 69 74 69 6f 6e 20 69 66 20 61 20 76 69 65 77 nition if a view
dcd0: 2e 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 46 4b . */. FKey *pFK
dce0: 65 79 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4c ey; /* L
dcf0: 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 61 6c inked list of al
dd00: 6c 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 69 l foreign keys i
dd10: 6e 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a n this table */.
dd20: 20 20 63 68 61 72 20 2a 7a 43 6f 6c 41 66 66 3b char *zColAff;
dd30: 20 20 20 20 20 20 20 2f 2a 20 53 74 72 69 6e 67 /* String
dd40: 20 64 65 66 69 6e 69 6e 67 20 74 68 65 20 61 66 defining the af
dd50: 66 69 6e 69 74 79 20 6f 66 20 65 61 63 68 20 63 finity of each c
dd60: 6f 6c 75 6d 6e 20 2a 2f 0a 23 69 66 6e 64 65 66 olumn */.#ifndef
dd70: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 48 45 SQLITE_OMIT_CHE
dd80: 43 4b 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 CK. ExprList *p
dd90: 43 68 65 63 6b 3b 20 20 20 20 2f 2a 20 41 6c 6c Check; /* All
dda0: 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e CHECK constrain
ddb0: 74 73 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 74 ts */.#endif. t
ddc0: 52 6f 77 63 6e 74 20 6e 52 6f 77 45 73 74 3b 20 Rowcnt nRowEst;
ddd0: 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 /* Estimated
dde0: 20 72 6f 77 73 20 69 6e 20 74 61 62 6c 65 20 2d rows in table -
ddf0: 20 66 72 6f 6d 20 73 71 6c 69 74 65 5f 73 74 61 from sqlite_sta
de00: 74 31 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69 6e t1 table */. in
de10: 74 20 74 6e 75 6d 3b 20 20 20 20 20 20 20 20 20 t tnum;
de20: 20 20 20 2f 2a 20 52 6f 6f 74 20 42 54 72 65 65 /* Root BTree
de30: 20 6e 6f 64 65 20 66 6f 72 20 74 68 69 73 20 74 node for this t
de40: 61 62 6c 65 20 28 73 65 65 20 6e 6f 74 65 20 61 able (see note a
de50: 62 6f 76 65 29 20 2a 2f 0a 20 20 69 31 36 20 69 bove) */. i16 i
de60: 50 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 PKey;
de70: 2f 2a 20 49 66 20 6e 6f 74 20 6e 65 67 61 74 69 /* If not negati
de80: 76 65 2c 20 75 73 65 20 61 43 6f 6c 5b 69 50 4b ve, use aCol[iPK
de90: 65 79 5d 20 61 73 20 74 68 65 20 70 72 69 6d 61 ey] as the prima
dea0: 72 79 20 6b 65 79 20 2a 2f 0a 20 20 69 31 36 20 ry key */. i16
deb0: 6e 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 nCol;
dec0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f /* Number of co
ded0: 6c 75 6d 6e 73 20 69 6e 20 74 68 69 73 20 74 61 lumns in this ta
dee0: 62 6c 65 20 2a 2f 0a 20 20 75 31 36 20 6e 52 65 ble */. u16 nRe
def0: 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a f; /*
df00: 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 Number of point
df10: 65 72 73 20 74 6f 20 74 68 69 73 20 54 61 62 6c ers to this Tabl
df20: 65 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 73 7a e */. LogEst sz
df30: 54 61 62 52 6f 77 3b 20 20 20 20 20 2f 2a 20 45 TabRow; /* E
df40: 73 74 69 6d 61 74 65 64 20 73 69 7a 65 20 6f 66 stimated size of
df50: 20 65 61 63 68 20 74 61 62 6c 65 20 72 6f 77 20 each table row
df60: 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 38 in bytes */. u8
df70: 20 74 61 62 46 6c 61 67 73 3b 20 20 20 20 20 20 tabFlags;
df80: 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 54 46 /* Mask of TF
df90: 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 _* values */. u
dfa0: 38 20 6b 65 79 43 6f 6e 66 3b 20 20 20 20 20 20 8 keyConf;
dfb0: 20 20 20 20 2f 2a 20 57 68 61 74 20 74 6f 20 64 /* What to d
dfc0: 6f 20 69 6e 20 63 61 73 65 20 6f 66 20 75 6e 69 o in case of uni
dfd0: 71 75 65 6e 65 73 73 20 63 6f 6e 66 6c 69 63 74 queness conflict
dfe0: 20 6f 6e 20 69 50 4b 65 79 20 2a 2f 0a 23 69 66 on iPKey */.#if
dff0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
e000: 5f 41 4c 54 45 52 54 41 42 4c 45 0a 20 20 69 6e _ALTERTABLE. in
e010: 74 20 61 64 64 43 6f 6c 4f 66 66 73 65 74 3b 20 t addColOffset;
e020: 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 20 /* Offset in
e030: 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 6d CREATE TABLE stm
e040: 74 20 74 6f 20 61 64 64 20 61 20 6e 65 77 20 63 t to add a new c
e050: 6f 6c 75 6d 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a olumn */.#endif.
e060: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
e070: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
e080: 0a 20 20 69 6e 74 20 6e 4d 6f 64 75 6c 65 41 72 . int nModuleAr
e090: 67 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 g; /* Numbe
e0a0: 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 74 r of arguments t
e0b0: 6f 20 74 68 65 20 6d 6f 64 75 6c 65 20 2a 2f 0a o the module */.
e0c0: 20 20 63 68 61 72 20 2a 2a 61 7a 4d 6f 64 75 6c char **azModul
e0d0: 65 41 72 67 3b 20 20 2f 2a 20 54 65 78 74 20 6f eArg; /* Text o
e0e0: 66 20 61 6c 6c 20 6d 6f 64 75 6c 65 20 61 72 67 f all module arg
e0f0: 73 2e 20 5b 30 5d 20 69 73 20 6d 6f 64 75 6c 65 s. [0] is module
e100: 20 6e 61 6d 65 20 2a 2f 0a 20 20 56 54 61 62 6c name */. VTabl
e110: 65 20 2a 70 56 54 61 62 6c 65 3b 20 20 20 20 20 e *pVTable;
e120: 2f 2a 20 4c 69 73 74 20 6f 66 20 56 54 61 62 6c /* List of VTabl
e130: 65 20 6f 62 6a 65 63 74 73 2e 20 2a 2f 0a 23 65 e objects. */.#e
e140: 6e 64 69 66 0a 20 20 54 72 69 67 67 65 72 20 2a ndif. Trigger *
e150: 70 54 72 69 67 67 65 72 3b 20 20 20 2f 2a 20 4c pTrigger; /* L
e160: 69 73 74 20 6f 66 20 74 72 69 67 67 65 72 73 20 ist of triggers
e170: 73 74 6f 72 65 64 20 69 6e 20 70 53 63 68 65 6d stored in pSchem
e180: 61 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 a */. Schema *p
e190: 53 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 53 Schema; /* S
e1a0: 63 68 65 6d 61 20 74 68 61 74 20 63 6f 6e 74 61 chema that conta
e1b0: 69 6e 73 20 74 68 69 73 20 74 61 62 6c 65 20 2a ins this table *
e1c0: 2f 0a 20 20 54 61 62 6c 65 20 2a 70 4e 65 78 74 /. Table *pNext
e1d0: 5a 6f 6d 62 69 65 3b 20 20 2f 2a 20 4e 65 78 74 Zombie; /* Next
e1e0: 20 6f 6e 20 74 68 65 20 50 61 72 73 65 2e 70 5a on the Parse.pZ
e1f0: 6f 6d 62 69 65 54 61 62 20 6c 69 73 74 20 2a 2f ombieTab list */
e200: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 .};../*.** Allow
e210: 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 54 61 ed values for Ta
e220: 62 65 2e 74 61 62 46 6c 61 67 73 2e 0a 2a 2f 0a be.tabFlags..*/.
e230: 23 64 65 66 69 6e 65 20 54 46 5f 52 65 61 64 6f #define TF_Reado
e240: 6e 6c 79 20 20 20 20 20 20 20 20 30 78 30 31 20 nly 0x01
e250: 20 20 20 2f 2a 20 52 65 61 64 2d 6f 6e 6c 79 20 /* Read-only
e260: 73 79 73 74 65 6d 20 74 61 62 6c 65 20 2a 2f 0a system table */.
e270: 23 64 65 66 69 6e 65 20 54 46 5f 45 70 68 65 6d #define TF_Ephem
e280: 65 72 61 6c 20 20 20 20 20 20 20 30 78 30 32 20 eral 0x02
e290: 20 20 20 2f 2a 20 41 6e 20 65 70 68 65 6d 65 72 /* An ephemer
e2a0: 61 6c 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 al table */.#def
e2b0: 69 6e 65 20 54 46 5f 48 61 73 50 72 69 6d 61 72 ine TF_HasPrimar
e2c0: 79 4b 65 79 20 20 20 30 78 30 34 20 20 20 20 2f yKey 0x04 /
e2d0: 2a 20 54 61 62 6c 65 20 68 61 73 20 61 20 70 72 * Table has a pr
e2e0: 69 6d 61 72 79 20 6b 65 79 20 2a 2f 0a 23 64 65 imary key */.#de
e2f0: 66 69 6e 65 20 54 46 5f 41 75 74 6f 69 6e 63 72 fine TF_Autoincr
e300: 65 6d 65 6e 74 20 20 20 30 78 30 38 20 20 20 20 ement 0x08
e310: 2f 2a 20 49 6e 74 65 67 65 72 20 70 72 69 6d 61 /* Integer prima
e320: 72 79 20 6b 65 79 20 69 73 20 61 75 74 6f 69 6e ry key is autoin
e330: 63 72 65 6d 65 6e 74 20 2a 2f 0a 23 64 65 66 69 crement */.#defi
e340: 6e 65 20 54 46 5f 56 69 72 74 75 61 6c 20 20 20 ne TF_Virtual
e350: 20 20 20 20 20 20 30 78 31 30 20 20 20 20 2f 2a 0x10 /*
e360: 20 49 73 20 61 20 76 69 72 74 75 61 6c 20 74 61 Is a virtual ta
e370: 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 ble */.#define T
e380: 46 5f 57 69 74 68 6f 75 74 52 6f 77 69 64 20 20 F_WithoutRowid
e390: 20 20 30 78 32 30 20 20 20 20 2f 2a 20 4e 6f 20 0x20 /* No
e3a0: 72 6f 77 69 64 20 75 73 65 64 2e 20 50 52 49 4d rowid used. PRIM
e3b0: 41 52 59 20 4b 45 59 20 69 73 20 74 68 65 20 6b ARY KEY is the k
e3c0: 65 79 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 65 ey */.../*.** Te
e3d0: 73 74 20 74 6f 20 73 65 65 20 77 68 65 74 68 65 st to see whethe
e3e0: 72 20 6f 72 20 6e 6f 74 20 61 20 74 61 62 6c 65 r or not a table
e3f0: 20 69 73 20 61 20 76 69 72 74 75 61 6c 20 74 61 is a virtual ta
e400: 62 6c 65 2e 20 20 54 68 69 73 20 69 73 0a 2a 2a ble. This is.**
e410: 20 64 6f 6e 65 20 61 73 20 61 20 6d 61 63 72 6f done as a macro
e420: 20 73 6f 20 74 68 61 74 20 69 74 20 77 69 6c 6c so that it will
e430: 20 62 65 20 6f 70 74 69 6d 69 7a 65 64 20 6f 75 be optimized ou
e440: 74 20 77 68 65 6e 20 76 69 72 74 75 61 6c 0a 2a t when virtual.*
e450: 2a 20 74 61 62 6c 65 20 73 75 70 70 6f 72 74 20 * table support
e460: 69 73 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 is omitted from
e470: 74 68 65 20 62 75 69 6c 64 2e 0a 2a 2f 0a 23 69 the build..*/.#i
e480: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
e490: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 23 T_VIRTUALTABLE.#
e4a0: 20 20 64 65 66 69 6e 65 20 49 73 56 69 72 74 75 define IsVirtu
e4b0: 61 6c 28 58 29 20 20 20 20 20 20 28 28 28 58 29 al(X) (((X)
e4c0: 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f ->tabFlags & TF_
e4d0: 56 69 72 74 75 61 6c 29 21 3d 30 29 0a 23 20 20 Virtual)!=0).#
e4e0: 64 65 66 69 6e 65 20 49 73 48 69 64 64 65 6e 43 define IsHiddenC
e4f0: 6f 6c 75 6d 6e 28 58 29 20 28 28 28 58 29 2d 3e olumn(X) (((X)->
e500: 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f 4c 46 4c colFlags & COLFL
e510: 41 47 5f 48 49 44 44 45 4e 29 21 3d 30 29 0a 23 AG_HIDDEN)!=0).#
e520: 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 49 else.# define I
e530: 73 56 69 72 74 75 61 6c 28 58 29 20 20 20 20 20 sVirtual(X)
e540: 20 30 0a 23 20 20 64 65 66 69 6e 65 20 49 73 48 0.# define IsH
e550: 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 30 iddenColumn(X) 0
e560: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 44 6f 65 73 .#endif../* Does
e570: 20 74 68 65 20 74 61 62 6c 65 20 68 61 76 65 20 the table have
e580: 61 20 72 6f 77 69 64 20 2a 2f 0a 23 64 65 66 69 a rowid */.#defi
e590: 6e 65 20 48 61 73 52 6f 77 69 64 28 58 29 20 20 ne HasRowid(X)
e5a0: 20 20 20 28 28 28 58 29 2d 3e 74 61 62 46 6c 61 (((X)->tabFla
e5b0: 67 73 20 26 20 54 46 5f 57 69 74 68 6f 75 74 52 gs & TF_WithoutR
e5c0: 6f 77 69 64 29 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a owid)==0)../*.**
e5d0: 20 45 61 63 68 20 66 6f 72 65 69 67 6e 20 6b 65 Each foreign ke
e5e0: 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 73 20 y constraint is
e5f0: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
e600: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
e610: 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 ucture..**.** A
e620: 66 6f 72 65 69 67 6e 20 6b 65 79 20 69 73 20 61 foreign key is a
e630: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
e640: 77 6f 20 74 61 62 6c 65 73 2e 20 20 54 68 65 20 wo tables. The
e650: 22 66 72 6f 6d 22 20 74 61 62 6c 65 20 69 73 0a "from" table is.
e660: 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 ** the table tha
e670: 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 52 t contains the R
e680: 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 EFERENCES clause
e690: 20 74 68 61 74 20 63 72 65 61 74 65 73 20 74 68 that creates th
e6a0: 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 6b 65 79 e foreign.** key
e6b0: 2e 20 20 54 68 65 20 22 74 6f 22 20 74 61 62 6c . The "to" tabl
e6c0: 65 20 69 73 20 74 68 65 20 74 61 62 6c 65 20 74 e is the table t
e6d0: 68 61 74 20 69 73 20 6e 61 6d 65 64 20 69 6e 20 hat is named in
e6e0: 74 68 65 20 52 45 46 45 52 45 4e 43 45 53 20 63 the REFERENCES c
e6f0: 6c 61 75 73 65 2e 0a 2a 2a 20 43 6f 6e 73 69 64 lause..** Consid
e700: 65 72 20 74 68 69 73 20 65 78 61 6d 70 6c 65 3a er this example:
e710: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 45 41 54 .**.** CREAT
e720: 45 20 54 41 42 4c 45 20 65 78 31 28 0a 2a 2a 20 E TABLE ex1(.**
e730: 20 20 20 20 20 20 61 20 49 4e 54 45 47 45 52 20 a INTEGER
e740: 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a 2a 2a 20 PRIMARY KEY,.**
e750: 20 20 20 20 20 20 62 20 49 4e 54 45 47 45 52 20 b INTEGER
e760: 43 4f 4e 53 54 52 41 49 4e 54 20 66 6b 31 20 52 CONSTRAINT fk1 R
e770: 45 46 45 52 45 4e 43 45 53 20 65 78 32 28 78 29 EFERENCES ex2(x)
e780: 0a 2a 2a 20 20 20 20 20 29 3b 0a 2a 2a 0a 2a 2a .** );.**.**
e790: 20 46 6f 72 20 66 6f 72 65 69 67 6e 20 6b 65 79 For foreign key
e7a0: 20 22 66 6b 31 22 2c 20 74 68 65 20 66 72 6f 6d "fk1", the from
e7b0: 2d 74 61 62 6c 65 20 69 73 20 22 65 78 31 22 20 -table is "ex1"
e7c0: 61 6e 64 20 74 68 65 20 74 6f 2d 74 61 62 6c 65 and the to-table
e7d0: 20 69 73 20 22 65 78 32 22 2e 0a 2a 2a 20 45 71 is "ex2"..** Eq
e7e0: 75 69 76 61 6c 65 6e 74 20 6e 61 6d 65 73 3a 0a uivalent names:.
e7f0: 2a 2a 0a 2a 2a 20 20 20 20 20 66 72 6f 6d 2d 74 **.** from-t
e800: 61 62 6c 65 20 3d 3d 20 63 68 69 6c 64 2d 74 61 able == child-ta
e810: 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 74 6f 2d ble.** to-
e820: 74 61 62 6c 65 20 3d 3d 20 70 61 72 65 6e 74 2d table == parent-
e830: 74 61 62 6c 65 0a 2a 2a 0a 2a 2a 20 45 61 63 68 table.**.** Each
e840: 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 REFERENCES clau
e850: 73 65 20 67 65 6e 65 72 61 74 65 73 20 61 6e 20 se generates an
e860: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
e870: 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
e880: 75 72 65 0a 2a 2a 20 77 68 69 63 68 20 69 73 20 ure.** which is
e890: 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 65 20 attached to the
e8a0: 66 72 6f 6d 2d 74 61 62 6c 65 2e 20 20 54 68 65 from-table. The
e8b0: 20 74 6f 2d 74 61 62 6c 65 20 6e 65 65 64 20 6e to-table need n
e8c0: 6f 74 20 65 78 69 73 74 20 77 68 65 6e 0a 2a 2a ot exist when.**
e8d0: 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 20 the from-table
e8e0: 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 65 is created. The
e8f0: 20 65 78 69 73 74 65 6e 63 65 20 6f 66 20 74 68 existence of th
e900: 65 20 74 6f 2d 74 61 62 6c 65 20 69 73 20 6e 6f e to-table is no
e910: 74 20 63 68 65 63 6b 65 64 2e 0a 2a 2a 0a 2a 2a t checked..**.**
e920: 20 54 68 65 20 6c 69 73 74 20 6f 66 20 61 6c 6c The list of all
e930: 20 70 61 72 65 6e 74 73 20 66 6f 72 20 63 68 69 parents for chi
e940: 6c 64 20 54 61 62 6c 65 20 58 20 69 73 20 68 65 ld Table X is he
e950: 6c 64 20 61 74 20 58 2e 70 46 4b 65 79 2e 0a 2a ld at X.pFKey..*
e960: 2a 0a 2a 2a 20 41 20 6c 69 73 74 20 6f 66 20 61 *.** A list of a
e970: 6c 6c 20 63 68 69 6c 64 72 65 6e 20 66 6f 72 20 ll children for
e980: 61 20 74 61 62 6c 65 20 6e 61 6d 65 64 20 5a 20 a table named Z
e990: 28 77 68 69 63 68 20 6d 69 67 68 74 20 6e 6f 74 (which might not
e9a0: 20 65 76 65 6e 20 65 78 69 73 74 29 0a 2a 2a 20 even exist).**
e9b0: 69 73 20 68 65 6c 64 20 69 6e 20 53 63 68 65 6d is held in Schem
e9c0: 61 2e 66 6b 65 79 48 61 73 68 20 77 69 74 68 20 a.fkeyHash with
e9d0: 61 20 68 61 73 68 20 6b 65 79 20 6f 66 20 5a 2e a hash key of Z.
e9e0: 0a 2a 2f 0a 73 74 72 75 63 74 20 46 4b 65 79 20 .*/.struct FKey
e9f0: 7b 0a 20 20 54 61 62 6c 65 20 2a 70 46 72 6f 6d {. Table *pFrom
ea00: 3b 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 63 ; /* Table c
ea10: 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 52 45 ontaining the RE
ea20: 46 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 20 FERENCES clause
ea30: 28 61 6b 61 3a 20 43 68 69 6c 64 29 20 2a 2f 0a (aka: Child) */.
ea40: 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 46 72 6f FKey *pNextFro
ea50: 6d 3b 20 20 2f 2a 20 4e 65 78 74 20 46 4b 65 79 m; /* Next FKey
ea60: 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 69 with the same i
ea70: 6e 20 70 46 72 6f 6d 2e 20 4e 65 78 74 20 70 61 n pFrom. Next pa
ea80: 72 65 6e 74 20 6f 66 20 70 46 72 6f 6d 20 2a 2f rent of pFrom */
ea90: 0a 20 20 63 68 61 72 20 2a 7a 54 6f 3b 20 20 20 . char *zTo;
eaa0: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
eab0: 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 6b table that the k
eac0: 65 79 20 70 6f 69 6e 74 73 20 74 6f 20 28 61 6b ey points to (ak
ead0: 61 3a 20 50 61 72 65 6e 74 29 20 2a 2f 0a 20 20 a: Parent) */.
eae0: 46 4b 65 79 20 2a 70 4e 65 78 74 54 6f 3b 20 20 FKey *pNextTo;
eaf0: 20 20 2f 2a 20 4e 65 78 74 20 77 69 74 68 20 74 /* Next with t
eb00: 68 65 20 73 61 6d 65 20 7a 54 6f 2e 20 4e 65 78 he same zTo. Nex
eb10: 74 20 63 68 69 6c 64 20 6f 66 20 7a 54 6f 2e 20 t child of zTo.
eb20: 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 50 72 65 76 */. FKey *pPrev
eb30: 54 6f 3b 20 20 20 20 2f 2a 20 50 72 65 76 69 6f To; /* Previo
eb40: 75 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 us with the same
eb50: 20 7a 54 6f 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 zTo */. int nC
eb60: 6f 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ol; /* N
eb70: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 umber of columns
eb80: 20 69 6e 20 74 68 69 73 20 6b 65 79 20 2a 2f 0a in this key */.
eb90: 20 20 2f 2a 20 45 56 3a 20 52 2d 33 30 33 32 33 /* EV: R-30323
eba0: 2d 32 31 39 31 37 20 2a 2f 0a 20 20 75 38 20 69 -21917 */. u8 i
ebb0: 73 44 65 66 65 72 72 65 64 3b 20 20 20 20 20 20 sDeferred;
ebc0: 20 2f 2a 20 54 72 75 65 20 69 66 20 63 6f 6e 73 /* True if cons
ebd0: 74 72 61 69 6e 74 20 63 68 65 63 6b 69 6e 67 20 traint checking
ebe0: 69 73 20 64 65 66 65 72 72 65 64 20 74 69 6c 6c is deferred till
ebf0: 20 43 4f 4d 4d 49 54 20 2a 2f 0a 20 20 75 38 20 COMMIT */. u8
ec00: 61 41 63 74 69 6f 6e 5b 32 5d 3b 20 20 20 20 20 aAction[2];
ec10: 20 20 20 2f 2a 20 4f 4e 20 44 45 4c 45 54 45 20 /* ON DELETE
ec20: 61 6e 64 20 4f 4e 20 55 50 44 41 54 45 20 61 63 and ON UPDATE ac
ec30: 74 69 6f 6e 73 2c 20 72 65 73 70 65 63 74 69 76 tions, respectiv
ec40: 65 6c 79 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 ely */. Trigger
ec50: 20 2a 61 70 54 72 69 67 67 65 72 5b 32 5d 3b 2f *apTrigger[2];/
ec60: 2a 20 54 72 69 67 67 65 72 73 20 66 6f 72 20 61 * Triggers for a
ec70: 41 63 74 69 6f 6e 5b 5d 20 61 63 74 69 6f 6e 73 Action[] actions
ec80: 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 73 43 6f */. struct sCo
ec90: 6c 4d 61 70 20 7b 20 20 20 20 20 20 2f 2a 20 4d lMap { /* M
eca0: 61 70 70 69 6e 67 20 6f 66 20 63 6f 6c 75 6d 6e apping of column
ecb0: 73 20 69 6e 20 70 46 72 6f 6d 20 74 6f 20 63 6f s in pFrom to co
ecc0: 6c 75 6d 6e 73 20 69 6e 20 7a 54 6f 20 2a 2f 0a lumns in zTo */.
ecd0: 20 20 20 20 69 6e 74 20 69 46 72 6f 6d 3b 20 20 int iFrom;
ece0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
ecf0: 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 ex of column in
ed00: 70 46 72 6f 6d 20 2a 2f 0a 20 20 20 20 63 68 61 pFrom */. cha
ed10: 72 20 2a 7a 43 6f 6c 3b 20 20 20 20 20 20 20 20 r *zCol;
ed20: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 63 6f /* Name of co
ed30: 6c 75 6d 6e 20 69 6e 20 7a 54 6f 2e 20 20 49 66 lumn in zTo. If
ed40: 20 4e 55 4c 4c 20 75 73 65 20 50 52 49 4d 41 52 NULL use PRIMAR
ed50: 59 20 4b 45 59 20 2a 2f 0a 20 20 7d 20 61 43 6f Y KEY */. } aCo
ed60: 6c 5b 31 5d 3b 20 20 20 20 20 20 20 20 20 20 20 l[1];
ed70: 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 20 66 6f /* One entry fo
ed80: 72 20 65 61 63 68 20 6f 66 20 6e 43 6f 6c 20 63 r each of nCol c
ed90: 6f 6c 75 6d 6e 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a olumns */.};../*
eda0: 0a 2a 2a 20 53 51 4c 69 74 65 20 73 75 70 70 6f .** SQLite suppo
edb0: 72 74 73 20 6d 61 6e 79 20 64 69 66 66 65 72 65 rts many differe
edc0: 6e 74 20 77 61 79 73 20 74 6f 20 72 65 73 6f 6c nt ways to resol
edd0: 76 65 20 61 20 63 6f 6e 73 74 72 61 69 6e 74 0a ve a constraint.
ede0: 2a 2a 20 65 72 72 6f 72 2e 20 20 52 4f 4c 4c 42 ** error. ROLLB
edf0: 41 43 4b 20 70 72 6f 63 65 73 73 69 6e 67 20 6d ACK processing m
ee00: 65 61 6e 73 20 74 68 61 74 20 61 20 63 6f 6e 73 eans that a cons
ee10: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e traint violation
ee20: 0a 2a 2a 20 63 61 75 73 65 73 20 74 68 65 20 6f .** causes the o
ee30: 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 63 peration in proc
ee40: 65 73 73 20 74 6f 20 66 61 69 6c 20 61 6e 64 20 ess to fail and
ee50: 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 for the current
ee60: 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 74 transaction.** t
ee70: 6f 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b o be rolled back
ee80: 2e 20 20 41 42 4f 52 54 20 70 72 6f 63 65 73 73 . ABORT process
ee90: 69 6e 67 20 6d 65 61 6e 73 20 74 68 65 20 6f 70 ing means the op
eea0: 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 63 65 eration in proce
eeb0: 73 73 0a 2a 2a 20 66 61 69 6c 73 20 61 6e 64 20 ss.** fails and
eec0: 61 6e 79 20 70 72 69 6f 72 20 63 68 61 6e 67 65 any prior change
eed0: 73 20 66 72 6f 6d 20 74 68 61 74 20 6f 6e 65 20 s from that one
eee0: 6f 70 65 72 61 74 69 6f 6e 20 61 72 65 20 62 61 operation are ba
eef0: 63 6b 65 64 20 6f 75 74 2c 0a 2a 2a 20 62 75 74 cked out,.** but
ef00: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
ef10: 20 69 73 20 6e 6f 74 20 72 6f 6c 6c 65 64 20 62 is not rolled b
ef20: 61 63 6b 2e 20 20 46 41 49 4c 20 70 72 6f 63 65 ack. FAIL proce
ef30: 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 68 61 74 ssing means that
ef40: 0a 2a 2a 20 74 68 65 20 6f 70 65 72 61 74 69 6f .** the operatio
ef50: 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 20 73 74 n in progress st
ef60: 6f 70 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 ops and returns
ef70: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 20 an error code.
ef80: 42 75 74 20 70 72 69 6f 72 0a 2a 2a 20 63 68 61 But prior.** cha
ef90: 6e 67 65 73 20 64 75 65 20 74 6f 20 74 68 65 20 nges due to the
efa0: 73 61 6d 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 same operation a
efb0: 72 65 20 6e 6f 74 20 62 61 63 6b 65 64 20 6f 75 re not backed ou
efc0: 74 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c 62 61 63 t and no rollbac
efd0: 6b 0a 2a 2a 20 6f 63 63 75 72 73 2e 20 20 49 47 k.** occurs. IG
efe0: 4e 4f 52 45 20 6d 65 61 6e 73 20 74 68 61 74 20 NORE means that
eff0: 74 68 65 20 70 61 72 74 69 63 75 6c 61 72 20 72 the particular r
f000: 6f 77 20 74 68 61 74 20 63 61 75 73 65 64 20 74 ow that caused t
f010: 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 0a 2a 2a he constraint.**
f020: 20 65 72 72 6f 72 20 69 73 20 6e 6f 74 20 69 6e error is not in
f030: 73 65 72 74 65 64 20 6f 72 20 75 70 64 61 74 65 serted or update
f040: 64 2e 20 20 50 72 6f 63 65 73 73 69 6e 67 20 63 d. Processing c
f050: 6f 6e 74 69 6e 75 65 73 20 61 6e 64 20 6e 6f 20 ontinues and no
f060: 65 72 72 6f 72 0a 2a 2a 20 69 73 20 72 65 74 75 error.** is retu
f070: 72 6e 65 64 2e 20 20 52 45 50 4c 41 43 45 20 6d rned. REPLACE m
f080: 65 61 6e 73 20 74 68 61 74 20 70 72 65 65 78 69 eans that preexi
f090: 73 74 69 6e 67 20 64 61 74 61 62 61 73 65 20 72 sting database r
f0a0: 6f 77 73 20 74 68 61 74 20 63 61 75 73 65 64 0a ows that caused.
f0b0: 2a 2a 20 61 20 55 4e 49 51 55 45 20 63 6f 6e 73 ** a UNIQUE cons
f0c0: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e traint violation
f0d0: 20 61 72 65 20 72 65 6d 6f 76 65 64 20 73 6f 20 are removed so
f0e0: 74 68 61 74 20 74 68 65 20 6e 65 77 20 69 6e 73 that the new ins
f0f0: 65 72 74 20 6f 72 0a 2a 2a 20 75 70 64 61 74 65 ert or.** update
f100: 20 63 61 6e 20 70 72 6f 63 65 65 64 2e 20 20 50 can proceed. P
f110: 72 6f 63 65 73 73 69 6e 67 20 63 6f 6e 74 69 6e rocessing contin
f120: 75 65 73 20 61 6e 64 20 6e 6f 20 65 72 72 6f 72 ues and no error
f130: 20 69 73 20 72 65 70 6f 72 74 65 64 2e 0a 2a 2a is reported..**
f140: 0a 2a 2a 20 52 45 53 54 52 49 43 54 2c 20 53 45 .** RESTRICT, SE
f150: 54 4e 55 4c 4c 2c 20 61 6e 64 20 43 41 53 43 41 TNULL, and CASCA
f160: 44 45 20 61 63 74 69 6f 6e 73 20 61 70 70 6c 79 DE actions apply
f170: 20 6f 6e 6c 79 20 74 6f 20 66 6f 72 65 69 67 6e only to foreign
f180: 20 6b 65 79 73 2e 0a 2a 2a 20 52 45 53 54 52 49 keys..** RESTRI
f190: 43 54 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 CT is the same a
f1a0: 73 20 41 42 4f 52 54 20 66 6f 72 20 49 4d 4d 45 s ABORT for IMME
f1b0: 44 49 41 54 45 20 66 6f 72 65 69 67 6e 20 6b 65 DIATE foreign ke
f1c0: 79 73 20 61 6e 64 20 74 68 65 0a 2a 2a 20 73 61 ys and the.** sa
f1d0: 6d 65 20 61 73 20 52 4f 4c 4c 42 41 43 4b 20 66 me as ROLLBACK f
f1e0: 6f 72 20 44 45 46 45 52 52 45 44 20 6b 65 79 73 or DEFERRED keys
f1f0: 2e 20 20 53 45 54 4e 55 4c 4c 20 6d 65 61 6e 73 . SETNULL means
f200: 20 74 68 61 74 20 74 68 65 20 66 6f 72 65 69 67 that the foreig
f210: 6e 0a 2a 2a 20 6b 65 79 20 69 73 20 73 65 74 20 n.** key is set
f220: 74 6f 20 4e 55 4c 4c 2e 20 20 43 41 53 43 41 44 to NULL. CASCAD
f230: 45 20 6d 65 61 6e 73 20 74 68 61 74 20 61 20 44 E means that a D
f240: 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54 45 20 ELETE or UPDATE
f250: 6f 66 20 74 68 65 0a 2a 2a 20 72 65 66 65 72 65 of the.** refere
f260: 6e 63 65 64 20 74 61 62 6c 65 20 72 6f 77 20 69 nced table row i
f270: 73 20 70 72 6f 70 61 67 61 74 65 64 20 69 6e 74 s propagated int
f280: 6f 20 74 68 65 20 72 6f 77 20 74 68 61 74 20 68 o the row that h
f290: 6f 6c 64 73 20 74 68 65 0a 2a 2a 20 66 6f 72 65 olds the.** fore
f2a0: 69 67 6e 20 6b 65 79 2e 0a 2a 2a 20 0a 2a 2a 20 ign key..** .**
f2b0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 The following sy
f2c0: 6d 62 6f 6c 69 63 20 76 61 6c 75 65 73 20 61 72 mbolic values ar
f2d0: 65 20 75 73 65 64 20 74 6f 20 72 65 63 6f 72 64 e used to record
f2e0: 20 77 68 69 63 68 20 74 79 70 65 0a 2a 2a 20 6f which type.** o
f2f0: 66 20 61 63 74 69 6f 6e 20 74 6f 20 74 61 6b 65 f action to take
f300: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f ..*/.#define OE_
f310: 4e 6f 6e 65 20 20 20 20 20 30 20 20 20 2f 2a 20 None 0 /*
f320: 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6e 73 There is no cons
f330: 74 72 61 69 6e 74 20 74 6f 20 63 68 65 63 6b 20 traint to check
f340: 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 52 6f */.#define OE_Ro
f350: 6c 6c 62 61 63 6b 20 31 20 20 20 2f 2a 20 46 61 llback 1 /* Fa
f360: 69 6c 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e il the operation
f370: 20 61 6e 64 20 72 6f 6c 6c 62 61 63 6b 20 74 68 and rollback th
f380: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f e transaction */
f390: 0a 23 64 65 66 69 6e 65 20 4f 45 5f 41 62 6f 72 .#define OE_Abor
f3a0: 74 20 20 20 20 32 20 20 20 2f 2a 20 42 61 63 6b t 2 /* Back
f3b0: 20 6f 75 74 20 63 68 61 6e 67 65 73 20 62 75 74 out changes but
f3c0: 20 64 6f 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 do no rollback
f3d0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 23 transaction */.#
f3e0: 64 65 66 69 6e 65 20 4f 45 5f 46 61 69 6c 20 20 define OE_Fail
f3f0: 20 20 20 33 20 20 20 2f 2a 20 53 74 6f 70 20 74 3 /* Stop t
f400: 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 62 75 74 he operation but
f410: 20 6c 65 61 76 65 20 61 6c 6c 20 70 72 69 6f 72 leave all prior
f420: 20 63 68 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 changes */.#def
f430: 69 6e 65 20 4f 45 5f 49 67 6e 6f 72 65 20 20 20 ine OE_Ignore
f440: 34 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68 4 /* Ignore th
f450: 65 20 65 72 72 6f 72 2e 20 44 6f 20 6e 6f 74 20 e error. Do not
f460: 64 6f 20 74 68 65 20 49 4e 53 45 52 54 20 6f 72 do the INSERT or
f470: 20 55 50 44 41 54 45 20 2a 2f 0a 23 64 65 66 69 UPDATE */.#defi
f480: 6e 65 20 4f 45 5f 52 65 70 6c 61 63 65 20 20 35 ne OE_Replace 5
f490: 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 65 78 69 /* Delete exi
f4a0: 73 74 69 6e 67 20 72 65 63 6f 72 64 2c 20 74 68 sting record, th
f4b0: 65 6e 20 64 6f 20 49 4e 53 45 52 54 20 6f 72 20 en do INSERT or
f4c0: 55 50 44 41 54 45 20 2a 2f 0a 0a 23 64 65 66 69 UPDATE */..#defi
f4d0: 6e 65 20 4f 45 5f 52 65 73 74 72 69 63 74 20 36 ne OE_Restrict 6
f4e0: 20 20 20 2f 2a 20 4f 45 5f 41 62 6f 72 74 20 66 /* OE_Abort f
f4f0: 6f 72 20 49 4d 4d 45 44 49 41 54 45 2c 20 4f 45 or IMMEDIATE, OE
f500: 5f 52 6f 6c 6c 62 61 63 6b 20 66 6f 72 20 44 45 _Rollback for DE
f510: 46 45 52 52 45 44 20 2a 2f 0a 23 64 65 66 69 6e FERRED */.#defin
f520: 65 20 4f 45 5f 53 65 74 4e 75 6c 6c 20 20 37 20 e OE_SetNull 7
f530: 20 20 2f 2a 20 53 65 74 20 74 68 65 20 66 6f 72 /* Set the for
f540: 65 69 67 6e 20 6b 65 79 20 76 61 6c 75 65 20 74 eign key value t
f550: 6f 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 69 6e o NULL */.#defin
f560: 65 20 4f 45 5f 53 65 74 44 66 6c 74 20 20 38 20 e OE_SetDflt 8
f570: 20 20 2f 2a 20 53 65 74 20 74 68 65 20 66 6f 72 /* Set the for
f580: 65 69 67 6e 20 6b 65 79 20 76 61 6c 75 65 20 74 eign key value t
f590: 6f 20 69 74 73 20 64 65 66 61 75 6c 74 20 2a 2f o its default */
f5a0: 0a 23 64 65 66 69 6e 65 20 4f 45 5f 43 61 73 63 .#define OE_Casc
f5b0: 61 64 65 20 20 39 20 20 20 2f 2a 20 43 61 73 63 ade 9 /* Casc
f5c0: 61 64 65 20 74 68 65 20 63 68 61 6e 67 65 73 20 ade the changes
f5d0: 2a 2f 0a 0a 23 64 65 66 69 6e 65 20 4f 45 5f 44 */..#define OE_D
f5e0: 65 66 61 75 6c 74 20 20 31 30 20 20 2f 2a 20 44 efault 10 /* D
f5f0: 6f 20 77 68 61 74 65 76 65 72 20 74 68 65 20 64 o whatever the d
f600: 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 69 73 efault action is
f610: 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 */.../*.** An i
f620: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 nstance of the f
f630: 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
f640: 72 65 20 69 73 20 70 61 73 73 65 64 20 61 73 20 re is passed as
f650: 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 the first.** arg
f660: 75 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74 65 33 ument to sqlite3
f670: 56 64 62 65 4b 65 79 43 6f 6d 70 61 72 65 20 61 VdbeKeyCompare a
f680: 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 63 6f nd is used to co
f690: 6e 74 72 6f 6c 20 74 68 65 20 0a 2a 2a 20 63 6f ntrol the .** co
f6a0: 6d 70 61 72 69 73 6f 6e 20 6f 66 20 74 68 65 20 mparison of the
f6b0: 74 77 6f 20 69 6e 64 65 78 20 6b 65 79 73 2e 0a two index keys..
f6c0: 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 **.** Note that
f6d0: 61 53 6f 72 74 4f 72 64 65 72 5b 5d 20 61 6e 64 aSortOrder[] and
f6e0: 20 61 43 6f 6c 6c 5b 5d 20 68 61 76 65 20 6e 46 aColl[] have nF
f6f0: 69 65 6c 64 2b 31 20 73 6c 6f 74 73 2e 20 20 54 ield+1 slots. T
f700: 68 65 72 65 0a 2a 2a 20 61 72 65 20 6e 46 69 65 here.** are nFie
f710: 6c 64 20 73 6c 6f 74 73 20 66 6f 72 20 74 68 65 ld slots for the
f720: 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6e 20 69 columns of an i
f730: 6e 64 65 78 20 74 68 65 6e 20 6f 6e 65 20 65 78 ndex then one ex
f740: 74 72 61 20 73 6c 6f 74 0a 2a 2a 20 66 6f 72 20 tra slot.** for
f750: 74 68 65 20 72 6f 77 69 64 20 61 74 20 74 68 65 the rowid at the
f760: 20 65 6e 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 end..*/.struct
f770: 4b 65 79 49 6e 66 6f 20 7b 0a 20 20 75 33 32 20 KeyInfo {. u32
f780: 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 nRef;
f790: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 66 /* Number of ref
f7a0: 65 72 65 6e 63 65 73 20 74 6f 20 74 68 69 73 20 erences to this
f7b0: 4b 65 79 49 6e 66 6f 20 6f 62 6a 65 63 74 20 2a KeyInfo object *
f7c0: 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 20 20 /. u8 enc;
f7d0: 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 /* Text
f7e0: 65 6e 63 6f 64 69 6e 67 20 2d 20 6f 6e 65 20 6f encoding - one o
f7f0: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 55 54 46 f the SQLITE_UTF
f800: 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 31 * values */. u1
f810: 36 20 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 6 nField;
f820: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6b /* Number of k
f830: 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 ey columns in th
f840: 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 31 36 e index */. u16
f850: 20 6e 58 46 69 65 6c 64 3b 20 20 20 20 20 20 20 nXField;
f860: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f /* Number of co
f870: 6c 75 6d 6e 73 20 62 65 79 6f 6e 64 20 74 68 65 lumns beyond the
f880: 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a key columns */.
f890: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 sqlite3 *db;
f8a0: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
f8b0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
f8c0: 20 2a 2f 0a 20 20 75 38 20 2a 61 53 6f 72 74 4f */. u8 *aSortO
f8d0: 72 64 65 72 3b 20 20 20 20 20 2f 2a 20 53 6f 72 rder; /* Sor
f8e0: 74 20 6f 72 64 65 72 20 66 6f 72 20 65 61 63 68 t order for each
f8f0: 20 63 6f 6c 75 6d 6e 2e 20 2a 2f 0a 20 20 43 6f column. */. Co
f900: 6c 6c 53 65 71 20 2a 61 43 6f 6c 6c 5b 31 5d 3b llSeq *aColl[1];
f910: 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 73 /* Collating s
f920: 65 71 75 65 6e 63 65 20 66 6f 72 20 65 61 63 68 equence for each
f930: 20 74 65 72 6d 20 6f 66 20 74 68 65 20 6b 65 79 term of the key
f940: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
f950: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
f960: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
f970: 74 75 72 65 20 68 6f 6c 64 73 20 69 6e 66 6f 72 ture holds infor
f980: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 0a 2a mation about a.*
f990: 2a 20 73 69 6e 67 6c 65 20 69 6e 64 65 78 20 72 * single index r
f9a0: 65 63 6f 72 64 20 74 68 61 74 20 68 61 73 20 61 ecord that has a
f9b0: 6c 72 65 61 64 79 20 62 65 65 6e 20 70 61 72 73 lready been pars
f9c0: 65 64 20 6f 75 74 20 69 6e 74 6f 20 69 6e 64 69 ed out into indi
f9d0: 76 69 64 75 61 6c 0a 2a 2a 20 76 61 6c 75 65 73 vidual.** values
f9e0: 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 65 63 6f 72 64 ..**.** A record
f9f0: 20 69 73 20 61 6e 20 6f 62 6a 65 63 74 20 74 68 is an object th
fa00: 61 74 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 at contains one
fa10: 6f 72 20 6d 6f 72 65 20 66 69 65 6c 64 73 20 6f or more fields o
fa20: 66 20 64 61 74 61 2e 0a 2a 2a 20 52 65 63 6f 72 f data..** Recor
fa30: 64 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 73 ds are used to s
fa40: 74 6f 72 65 20 74 68 65 20 63 6f 6e 74 65 6e 74 tore the content
fa50: 20 6f 66 20 61 20 74 61 62 6c 65 20 72 6f 77 20 of a table row
fa60: 61 6e 64 20 74 6f 20 73 74 6f 72 65 0a 2a 2a 20 and to store.**
fa70: 74 68 65 20 6b 65 79 20 6f 66 20 61 6e 20 69 6e the key of an in
fa80: 64 65 78 2e 20 20 41 20 62 6c 6f 62 20 65 6e 63 dex. A blob enc
fa90: 6f 64 69 6e 67 20 6f 66 20 61 20 72 65 63 6f 72 oding of a recor
faa0: 64 20 69 73 20 63 72 65 61 74 65 64 20 62 79 0a d is created by.
fab0: 2a 2a 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 ** the OP_MakeRe
fac0: 63 6f 72 64 20 6f 70 63 6f 64 65 20 6f 66 20 74 cord opcode of t
fad0: 68 65 20 56 44 42 45 20 61 6e 64 20 69 73 20 64 he VDBE and is d
fae0: 69 73 61 73 73 65 6d 62 6c 65 64 20 62 79 20 74 isassembled by t
faf0: 68 65 0a 2a 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 he.** OP_Column
fb00: 6f 70 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 opcode..**.** Th
fb10: 69 73 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c is structure hol
fb20: 64 73 20 61 20 72 65 63 6f 72 64 20 74 68 61 74 ds a record that
fb30: 20 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 has already bee
fb40: 6e 20 64 69 73 61 73 73 65 6d 62 6c 65 64 0a 2a n disassembled.*
fb50: 2a 20 69 6e 74 6f 20 69 74 73 20 63 6f 6e 73 74 * into its const
fb60: 69 74 75 65 6e 74 20 66 69 65 6c 64 73 2e 0a 2a ituent fields..*
fb70: 2f 0a 73 74 72 75 63 74 20 55 6e 70 61 63 6b 65 /.struct Unpacke
fb80: 64 52 65 63 6f 72 64 20 7b 0a 20 20 4b 65 79 49 dRecord {. KeyI
fb90: 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 nfo *pKeyInfo;
fba0: 2f 2a 20 43 6f 6c 6c 61 74 69 6f 6e 20 61 6e 64 /* Collation and
fbb0: 20 73 6f 72 74 2d 6f 72 64 65 72 20 69 6e 66 6f sort-order info
fbc0: 72 6d 61 74 69 6f 6e 20 2a 2f 0a 20 20 75 31 36 rmation */. u16
fbd0: 20 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 20 nField;
fbe0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e /* Number of en
fbf0: 74 72 69 65 73 20 69 6e 20 61 70 4d 65 6d 5b 5d tries in apMem[]
fc00: 20 2a 2f 0a 20 20 75 38 20 66 6c 61 67 73 3b 20 */. u8 flags;
fc10: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 6f 6f /* Boo
fc20: 6c 65 61 6e 20 73 65 74 74 69 6e 67 73 2e 20 20 lean settings.
fc30: 55 4e 50 41 43 4b 45 44 5f 2e 2e 2e 20 62 65 6c UNPACKED_... bel
fc40: 6f 77 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d 65 ow */. Mem *aMe
fc50: 6d 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 m; /* V
fc60: 61 6c 75 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a alues */.};../*.
fc70: 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 ** Allowed value
fc80: 73 20 6f 66 20 55 6e 70 61 63 6b 65 64 52 65 63 s of UnpackedRec
fc90: 6f 72 64 2e 66 6c 61 67 73 0a 2a 2f 0a 23 64 65 ord.flags.*/.#de
fca0: 66 69 6e 65 20 55 4e 50 41 43 4b 45 44 5f 49 4e fine UNPACKED_IN
fcb0: 43 52 4b 45 59 20 20 20 20 20 20 20 30 78 30 31 CRKEY 0x01
fcc0: 20 20 2f 2a 20 4d 61 6b 65 20 74 68 69 73 20 6b /* Make this k
fcd0: 65 79 20 61 6e 20 65 70 73 69 6c 6f 6e 20 6c 61 ey an epsilon la
fce0: 72 67 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 rger */.#define
fcf0: 55 4e 50 41 43 4b 45 44 5f 50 52 45 46 49 58 5f UNPACKED_PREFIX_
fd00: 4d 41 54 43 48 20 20 30 78 30 32 20 20 2f 2a 20 MATCH 0x02 /*
fd10: 41 20 70 72 65 66 69 78 20 6d 61 74 63 68 20 69 A prefix match i
fd20: 73 20 63 6f 6e 73 69 64 65 72 65 64 20 4f 4b 20 s considered OK
fd30: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 */../*.** Each S
fd40: 51 4c 20 69 6e 64 65 78 20 69 73 20 72 65 70 72 QL index is repr
fd50: 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 6d 6f 72 esented in memor
fd60: 79 20 62 79 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 y by an.** insta
fd70: 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
fd80: 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a wing structure..
fd90: 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6c 75 6d 6e **.** The column
fda0: 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 s of the table t
fdb0: 68 61 74 20 61 72 65 20 74 6f 20 62 65 20 69 6e hat are to be in
fdc0: 64 65 78 65 64 20 61 72 65 20 64 65 73 63 72 69 dexed are descri
fdd0: 62 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 61 69 bed.** by the ai
fde0: 43 6f 6c 75 6d 6e 5b 5d 20 66 69 65 6c 64 20 6f Column[] field o
fdf0: 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 f this structure
fe00: 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 . For example,
fe10: 73 75 70 70 6f 73 65 0a 2a 2a 20 77 65 20 68 61 suppose.** we ha
fe20: 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ve the following
fe30: 20 74 61 62 6c 65 20 61 6e 64 20 69 6e 64 65 78 table and index
fe40: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 45 41 :.**.** CREA
fe50: 54 45 20 54 41 42 4c 45 20 45 78 31 28 63 31 20 TE TABLE Ex1(c1
fe60: 69 6e 74 2c 20 63 32 20 69 6e 74 2c 20 63 33 20 int, c2 int, c3
fe70: 74 65 78 74 29 3b 0a 2a 2a 20 20 20 20 20 43 52 text);.** CR
fe80: 45 41 54 45 20 49 4e 44 45 58 20 45 78 32 20 4f EATE INDEX Ex2 O
fe90: 4e 20 45 78 31 28 63 33 2c 63 31 29 3b 0a 2a 2a N Ex1(c3,c1);.**
fea0: 0a 2a 2a 20 49 6e 20 74 68 65 20 54 61 62 6c 65 .** In the Table
feb0: 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 72 structure descr
fec0: 69 62 69 6e 67 20 45 78 31 2c 20 6e 43 6f 6c 3d ibing Ex1, nCol=
fed0: 3d 33 20 62 65 63 61 75 73 65 20 74 68 65 72 65 =3 because there
fee0: 20 61 72 65 0a 2a 2a 20 74 68 72 65 65 20 63 6f are.** three co
fef0: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62 lumns in the tab
ff00: 6c 65 2e 20 20 49 6e 20 74 68 65 20 49 6e 64 65 le. In the Inde
ff10: 78 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 x structure desc
ff20: 72 69 62 69 6e 67 0a 2a 2a 20 45 78 32 2c 20 6e ribing.** Ex2, n
ff30: 43 6f 6c 75 6d 6e 3d 3d 32 20 73 69 6e 63 65 20 Column==2 since
ff40: 32 20 6f 66 20 74 68 65 20 33 20 63 6f 6c 75 6d 2 of the 3 colum
ff50: 6e 73 20 6f 66 20 45 78 31 20 61 72 65 20 69 6e ns of Ex1 are in
ff60: 64 65 78 65 64 2e 0a 2a 2a 20 54 68 65 20 76 61 dexed..** The va
ff70: 6c 75 65 20 6f 66 20 61 69 43 6f 6c 75 6d 6e 20 lue of aiColumn
ff80: 69 73 20 7b 32 2c 20 30 7d 2e 20 20 61 69 43 6f is {2, 0}. aiCo
ff90: 6c 75 6d 6e 5b 30 5d 3d 3d 32 20 62 65 63 61 75 lumn[0]==2 becau
ffa0: 73 65 20 74 68 65 20 0a 2a 2a 20 66 69 72 73 74 se the .** first
ffb0: 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 69 6e column to be in
ffc0: 64 65 78 65 64 20 28 63 33 29 20 68 61 73 20 61 dexed (c3) has a
ffd0: 6e 20 69 6e 64 65 78 20 6f 66 20 32 20 69 6e 20 n index of 2 in
ffe0: 45 78 31 2e 61 43 6f 6c 5b 5d 2e 0a 2a 2a 20 54 Ex1.aCol[]..** T
fff0: 68 65 20 73 65 63 6f 6e 64 20 63 6f 6c 75 6d 6e he second column
10000 20 74 6f 20 62 65 20 69 6e 64 65 78 65 64 20 28 to be indexed (
10010 63 31 29 20 68 61 73 20 61 6e 20 69 6e 64 65 78 c1) has an index
10020 20 6f 66 20 30 20 69 6e 0a 2a 2a 20 45 78 31 2e of 0 in.** Ex1.
10030 61 43 6f 6c 5b 5d 2c 20 68 65 6e 63 65 20 45 78 aCol[], hence Ex
10040 32 2e 61 69 43 6f 6c 75 6d 6e 5b 31 5d 3d 3d 30 2.aiColumn[1]==0
10050 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 6e 64 65 ..**.** The Inde
10060 78 2e 6f 6e 45 72 72 6f 72 20 66 69 65 6c 64 20 x.onError field
10070 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 determines wheth
10080 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 69 6e er or not the in
10090 64 65 78 65 64 20 63 6f 6c 75 6d 6e 73 0a 2a 2a dexed columns.**
100a0 20 6d 75 73 74 20 62 65 20 75 6e 69 71 75 65 20 must be unique
100b0 61 6e 64 20 77 68 61 74 20 74 6f 20 64 6f 20 69 and what to do i
100c0 66 20 74 68 65 79 20 61 72 65 20 6e 6f 74 2e 20 f they are not.
100d0 20 57 68 65 6e 20 49 6e 64 65 78 2e 6f 6e 45 72 When Index.onEr
100e0 72 6f 72 3d 4f 45 5f 4e 6f 6e 65 2c 0a 2a 2a 20 ror=OE_None,.**
100f0 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73 it means this is
10100 20 6e 6f 74 20 61 20 75 6e 69 71 75 65 20 69 6e not a unique in
10110 64 65 78 2e 20 20 4f 74 68 65 72 77 69 73 65 20 dex. Otherwise
10120 69 74 20 69 73 20 61 20 75 6e 69 71 75 65 20 69 it is a unique i
10130 6e 64 65 78 0a 2a 2a 20 61 6e 64 20 74 68 65 20 ndex.** and the
10140 76 61 6c 75 65 20 6f 66 20 49 6e 64 65 78 2e 6f value of Index.o
10150 6e 45 72 72 6f 72 20 69 6e 64 69 63 61 74 65 20 nError indicate
10160 74 68 65 20 77 68 69 63 68 20 63 6f 6e 66 6c 69 the which confli
10170 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 0a 2a ct resolution .*
10180 2a 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 65 * algorithm to e
10190 6d 70 6c 6f 79 20 77 68 65 6e 65 76 65 72 20 61 mploy whenever a
101a0 6e 20 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 n attempt is mad
101b0 65 20 74 6f 20 69 6e 73 65 72 74 20 61 20 6e 6f e to insert a no
101c0 6e 2d 75 6e 69 71 75 65 0a 2a 2a 20 65 6c 65 6d n-unique.** elem
101d0 65 6e 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 ent..*/.struct I
101e0 6e 64 65 78 20 7b 0a 20 20 63 68 61 72 20 2a 7a ndex {. char *z
101f0 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 Name;
10200 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 /* Name of thi
10210 73 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 31 36 s index */. i16
10220 20 2a 61 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 *aiColumn;
10230 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 63 /* Which c
10240 6f 6c 75 6d 6e 73 20 61 72 65 20 75 73 65 64 20 olumns are used
10250 62 79 20 74 68 69 73 20 69 6e 64 65 78 2e 20 20 by this index.
10260 31 73 74 20 69 73 20 30 20 2a 2f 0a 20 20 74 52 1st is 0 */. tR
10270 6f 77 63 6e 74 20 2a 61 69 52 6f 77 45 73 74 3b owcnt *aiRowEst;
10280 20 20 20 20 20 20 20 2f 2a 20 46 72 6f 6d 20 41 /* From A
10290 4e 41 4c 59 5a 45 3a 20 45 73 74 2e 20 72 6f 77 NALYZE: Est. row
102a0 73 20 73 65 6c 65 63 74 65 64 20 62 79 20 65 61 s selected by ea
102b0 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 54 ch column */. T
102c0 61 62 6c 65 20 2a 70 54 61 62 6c 65 3b 20 20 20 able *pTable;
102d0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 /* The S
102e0 51 4c 20 74 61 62 6c 65 20 62 65 69 6e 67 20 69 QL table being i
102f0 6e 64 65 78 65 64 20 2a 2f 0a 20 20 63 68 61 72 ndexed */. char
10300 20 2a 7a 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 *zColAff;
10310 20 20 20 20 20 2f 2a 20 53 74 72 69 6e 67 20 64 /* String d
10320 65 66 69 6e 69 6e 67 20 74 68 65 20 61 66 66 69 efining the affi
10330 6e 69 74 79 20 6f 66 20 65 61 63 68 20 63 6f 6c nity of each col
10340 75 6d 6e 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a umn */. Index *
10350 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 pNext;
10360 20 20 2f 2a 20 54 68 65 20 6e 65 78 74 20 69 6e /* The next in
10370 64 65 78 20 61 73 73 6f 63 69 61 74 65 64 20 77 dex associated w
10380 69 74 68 20 74 68 65 20 73 61 6d 65 20 74 61 62 ith the same tab
10390 6c 65 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a le */. Schema *
103a0 70 53 63 68 65 6d 61 3b 20 20 20 20 20 20 20 20 pSchema;
103b0 20 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 /* Schema conta
103c0 69 6e 69 6e 67 20 74 68 69 73 20 69 6e 64 65 78 ining this index
103d0 20 2a 2f 0a 20 20 75 38 20 2a 61 53 6f 72 74 4f */. u8 *aSortO
103e0 72 64 65 72 3b 20 20 20 20 20 20 20 20 20 20 2f rder; /
103f0 2a 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d * for each colum
10400 6e 3a 20 54 72 75 65 3d 3d 44 45 53 43 2c 20 46 n: True==DESC, F
10410 61 6c 73 65 3d 3d 41 53 43 20 2a 2f 0a 20 20 63 alse==ASC */. c
10420 68 61 72 20 2a 2a 61 7a 43 6f 6c 6c 3b 20 20 20 har **azColl;
10430 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 /* Array
10440 20 6f 66 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 of collation se
10450 71 75 65 6e 63 65 20 6e 61 6d 65 73 20 66 6f 72 quence names for
10460 20 69 6e 64 65 78 20 2a 2f 0a 20 20 45 78 70 72 index */. Expr
10470 20 2a 70 50 61 72 74 49 64 78 57 68 65 72 65 3b *pPartIdxWhere;
10480 20 20 20 20 20 2f 2a 20 57 48 45 52 45 20 63 6c /* WHERE cl
10490 61 75 73 65 20 66 6f 72 20 70 61 72 74 69 61 6c ause for partial
104a0 20 69 6e 64 69 63 65 73 20 2a 2f 0a 20 20 4b 65 indices */. Ke
104b0 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b yInfo *pKeyInfo;
104c0 20 20 20 20 20 20 20 2f 2a 20 41 20 4b 65 79 49 /* A KeyI
104d0 6e 66 6f 20 6f 62 6a 65 63 74 20 73 75 69 74 61 nfo object suita
104e0 62 6c 65 20 66 6f 72 20 74 68 69 73 20 69 6e 64 ble for this ind
104f0 65 78 20 2a 2f 0a 20 20 69 6e 74 20 74 6e 75 6d ex */. int tnum
10500 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
10510 20 2f 2a 20 44 42 20 50 61 67 65 20 63 6f 6e 74 /* DB Page cont
10520 61 69 6e 69 6e 67 20 72 6f 6f 74 20 6f 66 20 74 aining root of t
10530 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a 20 20 4c his index */. L
10540 6f 67 45 73 74 20 73 7a 49 64 78 52 6f 77 3b 20 ogEst szIdxRow;
10550 20 20 20 20 20 20 20 20 2f 2a 20 45 73 74 69 6d /* Estim
10560 61 74 65 64 20 61 76 65 72 61 67 65 20 72 6f 77 ated average row
10570 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 2a size in bytes *
10580 2f 0a 20 20 75 31 36 20 6e 4b 65 79 43 6f 6c 3b /. u16 nKeyCol;
10590 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
105a0 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e Number of column
105b0 73 20 66 6f 72 6d 69 6e 67 20 74 68 65 20 6b 65 s forming the ke
105c0 79 20 2a 2f 0a 20 20 75 31 36 20 6e 43 6f 6c 75 y */. u16 nColu
105d0 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 mn;
105e0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c /* Number of col
105f0 75 6d 6e 73 20 73 74 6f 72 65 64 20 69 6e 20 74 umns stored in t
10600 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 38 he index */. u8
10610 20 6f 6e 45 72 72 6f 72 3b 20 20 20 20 20 20 20 onError;
10620 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f 41 62 6f /* OE_Abo
10630 72 74 2c 20 4f 45 5f 49 67 6e 6f 72 65 2c 20 4f rt, OE_Ignore, O
10640 45 5f 52 65 70 6c 61 63 65 2c 20 6f 72 20 4f 45 E_Replace, or OE
10650 5f 4e 6f 6e 65 20 2a 2f 0a 20 20 75 6e 73 69 67 _None */. unsig
10660 6e 65 64 20 61 75 74 6f 49 6e 64 65 78 3a 32 3b ned autoIndex:2;
10670 20 20 20 20 2f 2a 20 31 3d 3d 55 4e 49 51 55 45 /* 1==UNIQUE
10680 2c 20 32 3d 3d 50 52 49 4d 41 52 59 20 4b 45 59 , 2==PRIMARY KEY
10690 2c 20 30 3d 3d 43 52 45 41 54 45 20 49 4e 44 45 , 0==CREATE INDE
106a0 58 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 X */. unsigned
106b0 62 55 6e 6f 72 64 65 72 65 64 3a 31 3b 20 20 20 bUnordered:1;
106c0 2f 2a 20 55 73 65 20 74 68 69 73 20 69 6e 64 65 /* Use this inde
106d0 78 20 66 6f 72 20 3d 3d 20 6f 72 20 49 4e 20 71 x for == or IN q
106e0 75 65 72 69 65 73 20 6f 6e 6c 79 20 2a 2f 0a 20 ueries only */.
106f0 20 75 6e 73 69 67 6e 65 64 20 75 6e 69 71 4e 6f unsigned uniqNo
10700 74 4e 75 6c 6c 3a 31 3b 20 20 2f 2a 20 54 72 75 tNull:1; /* Tru
10710 65 20 69 66 20 55 4e 49 51 55 45 20 61 6e 64 20 e if UNIQUE and
10720 4e 4f 54 20 4e 55 4c 4c 20 66 6f 72 20 61 6c 6c NOT NULL for all
10730 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 75 6e columns */. un
10740 73 69 67 6e 65 64 20 69 73 52 65 73 69 7a 65 64 signed isResized
10750 3a 31 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69 :1; /* True i
10760 66 20 72 65 73 69 7a 65 49 6e 64 65 78 4f 62 6a f resizeIndexObj
10770 65 63 74 28 29 20 68 61 73 20 62 65 65 6e 20 63 ect() has been c
10780 61 6c 6c 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 alled */. unsig
10790 6e 65 64 20 69 73 43 6f 76 65 72 69 6e 67 3a 31 ned isCovering:1
107a0 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 ; /* True if t
107b0 68 69 73 20 69 73 20 61 20 63 6f 76 65 72 69 6e his is a coverin
107c0 67 20 69 6e 64 65 78 20 2a 2f 0a 23 69 66 64 65 g index */.#ifde
107d0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
107e0 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 STAT3_OR_STAT4.
107f0 20 69 6e 74 20 6e 53 61 6d 70 6c 65 3b 20 20 20 int nSample;
10800 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
10810 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 ber of elements
10820 69 6e 20 61 53 61 6d 70 6c 65 5b 5d 20 2a 2f 0a in aSample[] */.
10830 20 20 69 6e 74 20 6e 53 61 6d 70 6c 65 43 6f 6c int nSampleCol
10840 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 ; /* Si
10850 7a 65 20 6f 66 20 49 6e 64 65 78 53 61 6d 70 6c ze of IndexSampl
10860 65 2e 61 6e 45 71 5b 5d 20 61 6e 64 20 73 6f 20 e.anEq[] and so
10870 6f 6e 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 on */. tRowcnt
10880 2a 61 41 76 67 45 71 3b 20 20 20 20 20 20 20 20 *aAvgEq;
10890 20 2f 2a 20 41 76 65 72 61 67 65 20 6e 45 71 20 /* Average nEq
108a0 76 61 6c 75 65 73 20 66 6f 72 20 6b 65 79 73 20 values for keys
108b0 6e 6f 74 20 69 6e 20 61 53 61 6d 70 6c 65 20 2a not in aSample *
108c0 2f 0a 20 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 /. IndexSample
108d0 2a 61 53 61 6d 70 6c 65 3b 20 20 20 20 2f 2a 20 *aSample; /*
108e0 53 61 6d 70 6c 65 73 20 6f 66 20 74 68 65 20 6c Samples of the l
108f0 65 66 74 2d 6d 6f 73 74 20 6b 65 79 20 2a 2f 0a eft-most key */.
10900 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
10910 20 45 61 63 68 20 73 61 6d 70 6c 65 20 73 74 6f Each sample sto
10920 72 65 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 red in the sqlit
10930 65 5f 73 74 61 74 33 20 74 61 62 6c 65 20 69 73 e_stat3 table is
10940 20 72 65 70 72 65 73 65 6e 74 65 64 20 69 6e 20 represented in
10950 6d 65 6d 6f 72 79 20 0a 2a 2a 20 75 73 69 6e 67 memory .** using
10960 20 61 20 73 74 72 75 63 74 75 72 65 20 6f 66 20 a structure of
10970 74 68 69 73 20 74 79 70 65 2e 20 20 53 65 65 20 this type. See
10980 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 documentation at
10990 20 74 68 65 20 74 6f 70 20 6f 66 20 74 68 65 0a the top of the.
109a0 2a 2a 20 61 6e 61 6c 79 7a 65 2e 63 20 73 6f 75 ** analyze.c sou
109b0 72 63 65 20 66 69 6c 65 20 66 6f 72 20 61 64 64 rce file for add
109c0 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 itional informat
109d0 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 ion..*/.struct I
109e0 6e 64 65 78 53 61 6d 70 6c 65 20 7b 0a 20 20 76 ndexSample {. v
109f0 6f 69 64 20 2a 70 3b 20 20 20 20 20 20 20 20 20 oid *p;
10a00 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 73 /* Pointer to s
10a10 61 6d 70 6c 65 64 20 72 65 63 6f 72 64 20 2a 2f ampled record */
10a20 0a 20 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 . int n;
10a30 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 /* Size of
10a40 72 65 63 6f 72 64 20 69 6e 20 62 79 74 65 73 20 record in bytes
10a50 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e */. tRowcnt *an
10a60 45 71 3b 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e Eq; /* Est. n
10a70 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 77 68 umber of rows wh
10a80 65 72 65 20 74 68 65 20 6b 65 79 20 65 71 75 61 ere the key equa
10a90 6c 73 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a ls this sample *
10aa0 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 4c /. tRowcnt *anL
10ab0 74 3b 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 t; /* Est. nu
10ac0 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 mber of rows whe
10ad0 72 65 20 6b 65 79 20 69 73 20 6c 65 73 73 20 74 re key is less t
10ae0 68 61 6e 20 74 68 69 73 20 73 61 6d 70 6c 65 20 han this sample
10af0 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e */. tRowcnt *an
10b00 44 4c 74 3b 20 20 20 2f 2a 20 45 73 74 2e 20 6e DLt; /* Est. n
10b10 75 6d 62 65 72 20 6f 66 20 64 69 73 74 69 6e 63 umber of distinc
10b20 74 20 6b 65 79 73 20 6c 65 73 73 20 74 68 61 6e t keys less than
10b30 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a this sample */.
10b40 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 };../*.** Each t
10b50 6f 6b 65 6e 20 63 6f 6d 69 6e 67 20 6f 75 74 20 oken coming out
10b60 6f 66 20 74 68 65 20 6c 65 78 65 72 20 69 73 20 of the lexer is
10b70 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a an instance of.*
10b80 2a 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 * this structure
10b90 2e 20 20 54 6f 6b 65 6e 73 20 61 72 65 20 61 6c . Tokens are al
10ba0 73 6f 20 75 73 65 64 20 61 73 20 70 61 72 74 20 so used as part
10bb0 6f 66 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e of an expression
10bc0 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 69 66 20 ..**.** Note if
10bd0 54 6f 6b 65 6e 2e 7a 3d 3d 30 20 74 68 65 6e 20 Token.z==0 then
10be0 54 6f 6b 65 6e 2e 64 79 6e 20 61 6e 64 20 54 6f Token.dyn and To
10bf0 6b 65 6e 2e 6e 20 61 72 65 20 75 6e 64 65 66 69 ken.n are undefi
10c00 6e 65 64 20 61 6e 64 0a 2a 2a 20 6d 61 79 20 63 ned and.** may c
10c10 6f 6e 74 61 69 6e 20 72 61 6e 64 6f 6d 20 76 61 ontain random va
10c20 6c 75 65 73 2e 20 20 44 6f 20 6e 6f 74 20 6d 61 lues. Do not ma
10c30 6b 65 20 61 6e 79 20 61 73 73 75 6d 70 74 69 6f ke any assumptio
10c40 6e 73 20 61 62 6f 75 74 20 54 6f 6b 65 6e 2e 64 ns about Token.d
10c50 79 6e 0a 2a 2a 20 61 6e 64 20 54 6f 6b 65 6e 2e yn.** and Token.
10c60 6e 20 77 68 65 6e 20 54 6f 6b 65 6e 2e 7a 3d 3d n when Token.z==
10c70 30 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 54 6f 6b 0..*/.struct Tok
10c80 65 6e 20 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 en {. const cha
10c90 72 20 2a 7a 3b 20 20 20 20 20 2f 2a 20 54 65 78 r *z; /* Tex
10ca0 74 20 6f 66 20 74 68 65 20 74 6f 6b 65 6e 2e 20 t of the token.
10cb0 20 4e 6f 74 20 4e 55 4c 4c 2d 74 65 72 6d 69 6e Not NULL-termin
10cc0 61 74 65 64 21 20 2a 2f 0a 20 20 75 6e 73 69 67 ated! */. unsig
10cd0 6e 65 64 20 69 6e 74 20 6e 3b 20 20 20 20 2f 2a ned int n; /*
10ce0 20 4e 75 6d 62 65 72 20 6f 66 20 63 68 61 72 61 Number of chara
10cf0 63 74 65 72 73 20 69 6e 20 74 68 69 73 20 74 6f cters in this to
10d00 6b 65 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ken */.};../*.**
10d10 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
10d20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 63 this structure c
10d30 6f 6e 74 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 ontains informat
10d40 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 67 65 ion needed to ge
10d50 6e 65 72 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 nerate.** code f
10d60 6f 72 20 61 20 53 45 4c 45 43 54 20 74 68 61 74 or a SELECT that
10d70 20 63 6f 6e 74 61 69 6e 73 20 61 67 67 72 65 67 contains aggreg
10d80 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a ate functions..*
10d90 2a 0a 2a 2a 20 49 66 20 45 78 70 72 2e 6f 70 3d *.** If Expr.op=
10da0 3d 54 4b 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 6f =TK_AGG_COLUMN o
10db0 72 20 54 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f r TK_AGG_FUNCTIO
10dc0 4e 20 74 68 65 6e 20 45 78 70 72 2e 70 41 67 67 N then Expr.pAgg
10dd0 49 6e 66 6f 20 69 73 20 61 0a 2a 2a 20 70 6f 69 Info is a.** poi
10de0 6e 74 65 72 20 74 6f 20 74 68 69 73 20 73 74 72 nter to this str
10df0 75 63 74 75 72 65 2e 20 20 54 68 65 20 45 78 70 ucture. The Exp
10e00 72 2e 69 43 6f 6c 75 6d 6e 20 66 69 65 6c 64 20 r.iColumn field
10e10 69 73 20 74 68 65 20 69 6e 64 65 78 20 69 6e 0a is the index in.
10e20 2a 2a 20 41 67 67 49 6e 66 6f 2e 61 43 6f 6c 5b ** AggInfo.aCol[
10e30 5d 20 6f 72 20 41 67 67 49 6e 66 6f 2e 61 46 75 ] or AggInfo.aFu
10e40 6e 63 5b 5d 20 6f 66 20 69 6e 66 6f 72 6d 61 74 nc[] of informat
10e50 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 67 65 ion needed to ge
10e60 6e 65 72 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 nerate.** code f
10e70 6f 72 20 74 68 61 74 20 6e 6f 64 65 2e 0a 2a 2a or that node..**
10e80 0a 2a 2a 20 41 67 67 49 6e 66 6f 2e 70 47 72 6f .** AggInfo.pGro
10e90 75 70 42 79 20 61 6e 64 20 41 67 67 49 6e 66 6f upBy and AggInfo
10ea0 2e 61 46 75 6e 63 2e 70 45 78 70 72 20 70 6f 69 .aFunc.pExpr poi
10eb0 6e 74 20 74 6f 20 66 69 65 6c 64 73 20 77 69 74 nt to fields wit
10ec0 68 69 6e 20 74 68 65 0a 2a 2a 20 6f 72 69 67 69 hin the.** origi
10ed0 6e 61 6c 20 53 65 6c 65 63 74 20 73 74 72 75 63 nal Select struc
10ee0 74 75 72 65 20 74 68 61 74 20 64 65 73 63 72 69 ture that descri
10ef0 62 65 73 20 74 68 65 20 53 45 4c 45 43 54 20 73 bes the SELECT s
10f00 74 61 74 65 6d 65 6e 74 2e 20 20 54 68 65 73 65 tatement. These
10f10 0a 2a 2a 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f .** fields do no
10f20 74 20 6e 65 65 64 20 74 6f 20 62 65 20 66 72 65 t need to be fre
10f30 65 64 20 77 68 65 6e 20 64 65 61 6c 6c 6f 63 61 ed when dealloca
10f40 74 69 6e 67 20 74 68 65 20 41 67 67 49 6e 66 6f ting the AggInfo
10f50 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 structure..*/.s
10f60 74 72 75 63 74 20 41 67 67 49 6e 66 6f 20 7b 0a truct AggInfo {.
10f70 20 20 75 38 20 64 69 72 65 63 74 4d 6f 64 65 3b u8 directMode;
10f80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 69 72 /* Dir
10f90 65 63 74 20 72 65 6e 64 65 72 69 6e 67 20 6d 6f ect rendering mo
10fa0 64 65 20 6d 65 61 6e 73 20 74 61 6b 65 20 64 61 de means take da
10fb0 74 61 20 64 69 72 65 63 74 6c 79 0a 20 20 20 20 ta directly.
10fc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
10fd0 20 20 20 20 20 20 2a 2a 20 66 72 6f 6d 20 73 6f ** from so
10fe0 75 72 63 65 20 74 61 62 6c 65 73 20 72 61 74 68 urce tables rath
10ff0 65 72 20 74 68 61 6e 20 66 72 6f 6d 20 61 63 63 er than from acc
11000 75 6d 75 6c 61 74 6f 72 73 20 2a 2f 0a 20 20 75 umulators */. u
11010 38 20 75 73 65 53 6f 72 74 69 6e 67 49 64 78 3b 8 useSortingIdx;
11020 20 20 20 20 20 20 20 2f 2a 20 49 6e 20 64 69 72 /* In dir
11030 65 63 74 20 6d 6f 64 65 2c 20 72 65 66 65 72 65 ect mode, refere
11040 6e 63 65 20 74 68 65 20 73 6f 72 74 69 6e 67 20 nce the sorting
11050 69 6e 64 65 78 20 72 61 74 68 65 72 0a 20 20 20 index rather.
11060 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11070 20 20 20 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 ** than t
11080 68 65 20 73 6f 75 72 63 65 20 74 61 62 6c 65 20 he source table
11090 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 */. int sorting
110a0 49 64 78 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 Idx; /*
110b0 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 Cursor number of
110c0 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
110d0 65 78 20 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74 ex */. int sort
110e0 69 6e 67 49 64 78 50 54 61 62 3b 20 20 20 20 20 ingIdxPTab;
110f0 2f 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 /* Cursor number
11100 20 6f 66 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 of pseudo-table
11110 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 6f 72 74 69 */. int nSorti
11120 6e 67 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a ngColumn; /*
11130 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d Number of colum
11140 6e 73 20 69 6e 20 74 68 65 20 73 6f 72 74 69 6e ns in the sortin
11150 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 g index */. int
11160 20 6d 6e 52 65 67 2c 20 6d 78 52 65 67 3b 20 20 mnReg, mxReg;
11170 20 20 20 20 20 2f 2a 20 52 61 6e 67 65 20 6f 66 /* Range of
11180 20 72 65 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 registers alloc
11190 61 74 65 64 20 66 6f 72 20 61 43 6f 6c 20 61 6e ated for aCol an
111a0 64 20 61 46 75 6e 63 20 2a 2f 0a 20 20 45 78 70 d aFunc */. Exp
111b0 72 4c 69 73 74 20 2a 70 47 72 6f 75 70 42 79 3b rList *pGroupBy;
111c0 20 20 20 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 /* The grou
111d0 70 20 62 79 20 63 6c 61 75 73 65 20 2a 2f 0a 20 p by clause */.
111e0 20 73 74 72 75 63 74 20 41 67 67 49 6e 66 6f 5f struct AggInfo_
111f0 63 6f 6c 20 7b 20 20 20 20 2f 2a 20 46 6f 72 20 col { /* For
11200 65 61 63 68 20 63 6f 6c 75 6d 6e 20 75 73 65 64 each column used
11210 20 69 6e 20 73 6f 75 72 63 65 20 74 61 62 6c 65 in source table
11220 73 20 2a 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a s */. Table *
11230 70 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 pTab;
11240 20 20 2f 2a 20 53 6f 75 72 63 65 20 74 61 62 6c /* Source tabl
11250 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 54 61 e */. int iTa
11260 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ble;
11270 20 20 2f 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 /* Cursor numb
11280 65 72 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 er of the source
11290 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e table */. in
112a0 74 20 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 t iColumn;
112b0 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e /* Column
112c0 20 6e 75 6d 62 65 72 20 77 69 74 68 69 6e 20 74 number within t
112d0 68 65 20 73 6f 75 72 63 65 20 74 61 62 6c 65 20 he source table
112e0 2a 2f 0a 20 20 20 20 69 6e 74 20 69 53 6f 72 74 */. int iSort
112f0 65 72 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 erColumn;
11300 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 /* Column number
11310 20 69 6e 20 74 68 65 20 73 6f 72 74 69 6e 67 20 in the sorting
11320 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 index */. int
11330 20 69 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 iMem;
11340 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 /* Memory
11350 6c 6f 63 61 74 69 6f 6e 20 74 68 61 74 20 61 63 location that ac
11360 74 73 20 61 73 20 61 63 63 75 6d 75 6c 61 74 6f ts as accumulato
11370 72 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 r */. Expr *p
11380 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 Expr;
11390 20 20 2f 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 /* The origina
113a0 6c 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a l expression */.
113b0 20 20 7d 20 2a 61 43 6f 6c 3b 0a 20 20 69 6e 74 } *aCol;. int
113c0 20 6e 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 nColumn;
113d0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
113e0 66 20 75 73 65 64 20 65 6e 74 72 69 65 73 20 69 f used entries i
113f0 6e 20 61 43 6f 6c 5b 5d 20 2a 2f 0a 20 20 69 6e n aCol[] */. in
11400 74 20 6e 41 63 63 75 6d 75 6c 61 74 6f 72 3b 20 t nAccumulator;
11410 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
11420 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 of columns that
11430 73 68 6f 77 20 74 68 72 6f 75 67 68 20 74 6f 20 show through to
11440 74 68 65 20 6f 75 74 70 75 74 2e 0a 20 20 20 20 the output..
11450 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11460 20 20 20 20 20 20 2a 2a 20 41 64 64 69 74 69 6f ** Additio
11470 6e 61 6c 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 nal columns are
11480 75 73 65 64 20 6f 6e 6c 79 20 61 73 20 70 61 72 used only as par
11490 61 6d 65 74 65 72 73 20 74 6f 0a 20 20 20 20 20 ameters to.
114a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
114b0 20 20 20 20 20 2a 2a 20 61 67 67 72 65 67 61 74 ** aggregat
114c0 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 e functions */.
114d0 20 73 74 72 75 63 74 20 41 67 67 49 6e 66 6f 5f struct AggInfo_
114e0 66 75 6e 63 20 7b 20 20 20 2f 2a 20 46 6f 72 20 func { /* For
114f0 65 61 63 68 20 61 67 67 72 65 67 61 74 65 20 66 each aggregate f
11500 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 45 unction */. E
11510 78 70 72 20 2a 70 45 78 70 72 3b 20 20 20 20 20 xpr *pExpr;
11520 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 /* Expre
11530 73 73 69 6f 6e 20 65 6e 63 6f 64 69 6e 67 20 74 ssion encoding t
11540 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 he function */.
11550 20 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e FuncDef *pFun
11560 63 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 c; /* T
11570 68 65 20 61 67 67 72 65 67 61 74 65 20 66 75 6e he aggregate fun
11580 63 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 ction implementa
11590 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 tion */. int
115a0 69 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 iMem;
115b0 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c /* Memory l
115c0 6f 63 61 74 69 6f 6e 20 74 68 61 74 20 61 63 74 ocation that act
115d0 73 20 61 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 s as accumulator
115e0 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 44 69 73 */. int iDis
115f0 74 69 6e 63 74 3b 20 20 20 20 20 20 20 20 20 20 tinct;
11600 20 2f 2a 20 45 70 68 65 6d 65 72 61 6c 20 74 61 /* Ephemeral ta
11610 62 6c 65 20 75 73 65 64 20 74 6f 20 65 6e 66 6f ble used to enfo
11620 72 63 65 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a rce DISTINCT */.
11630 20 20 7d 20 2a 61 46 75 6e 63 3b 0a 20 20 69 6e } *aFunc;. in
11640 74 20 6e 46 75 6e 63 3b 20 20 20 20 20 20 20 20 t nFunc;
11650 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
11660 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61 46 of entries in aF
11670 75 6e 63 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a unc[] */.};../*.
11680 2a 2a 20 54 68 65 20 64 61 74 61 74 79 70 65 20 ** The datatype
11690 79 6e 56 61 72 20 69 73 20 61 20 73 69 67 6e 65 ynVar is a signe
116a0 64 20 69 6e 74 65 67 65 72 2c 20 65 69 74 68 65 d integer, eithe
116b0 72 20 31 36 2d 62 69 74 20 6f 72 20 33 32 2d 62 r 16-bit or 32-b
116c0 69 74 2e 0a 2a 2a 20 55 73 75 61 6c 6c 79 20 69 it..** Usually i
116d0 74 20 69 73 20 31 36 2d 62 69 74 73 2e 20 20 42 t is 16-bits. B
116e0 75 74 20 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 ut if SQLITE_MAX
116f0 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 _VARIABLE_NUMBER
11700 20 69 73 20 67 72 65 61 74 65 72 0a 2a 2a 20 74 is greater.** t
11710 68 61 6e 20 33 32 37 36 37 20 77 65 20 68 61 76 han 32767 we hav
11720 65 20 74 6f 20 6d 61 6b 65 20 69 74 20 33 32 2d e to make it 32-
11730 62 69 74 2e 20 20 31 36 2d 62 69 74 20 69 73 20 bit. 16-bit is
11740 70 72 65 66 65 72 72 65 64 20 62 65 63 61 75 73 preferred becaus
11750 65 0a 2a 2a 20 69 74 20 75 73 65 73 20 6c 65 73 e.** it uses les
11760 73 20 6d 65 6d 6f 72 79 20 69 6e 20 74 68 65 20 s memory in the
11770 45 78 70 72 20 6f 62 6a 65 63 74 2c 20 77 68 69 Expr object, whi
11780 63 68 20 69 73 20 61 20 62 69 67 20 6d 65 6d 6f ch is a big memo
11790 72 79 20 75 73 65 72 0a 2a 2a 20 69 6e 20 73 79 ry user.** in sy
117a0 73 74 65 6d 73 20 77 69 74 68 20 6c 6f 74 73 20 stems with lots
117b0 6f 66 20 70 72 65 70 61 72 65 64 20 73 74 61 74 of prepared stat
117c0 65 6d 65 6e 74 73 2e 20 20 41 6e 64 20 66 65 77 ements. And few
117d0 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 0a 2a 2a applications.**
117e0 20 6e 65 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 need more than
117f0 61 62 6f 75 74 20 31 30 20 6f 72 20 32 30 20 76 about 10 or 20 v
11800 61 72 69 61 62 6c 65 73 2e 20 20 42 75 74 20 73 ariables. But s
11810 6f 6d 65 20 65 78 74 72 65 6d 65 20 75 73 65 72 ome extreme user
11820 73 20 77 61 6e 74 0a 2a 2a 20 74 6f 20 68 61 76 s want.** to hav
11830 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 e prepared state
11840 6d 65 6e 74 73 20 77 69 74 68 20 6f 76 65 72 20 ments with over
11850 33 32 37 36 37 20 76 61 72 69 61 62 6c 65 73 2c 32767 variables,
11860 20 61 6e 64 20 66 6f 72 20 74 68 65 6d 0a 2a 2a and for them.**
11870 20 74 68 65 20 6f 70 74 69 6f 6e 20 69 73 20 61 the option is a
11880 76 61 69 6c 61 62 6c 65 20 28 61 74 20 63 6f 6d vailable (at com
11890 70 69 6c 65 2d 74 69 6d 65 29 2e 0a 2a 2f 0a 23 pile-time)..*/.#
118a0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 if SQLITE_MAX_VA
118b0 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 3c 3d 33 RIABLE_NUMBER<=3
118c0 32 37 36 37 0a 74 79 70 65 64 65 66 20 69 31 36 2767.typedef i16
118d0 20 79 6e 56 61 72 3b 0a 23 65 6c 73 65 0a 74 79 ynVar;.#else.ty
118e0 70 65 64 65 66 20 69 6e 74 20 79 6e 56 61 72 3b pedef int ynVar;
118f0 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 .#endif../*.** E
11900 61 63 68 20 6e 6f 64 65 20 6f 66 20 61 6e 20 65 ach node of an e
11910 78 70 72 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 xpression in the
11920 20 70 61 72 73 65 20 74 72 65 65 20 69 73 20 61 parse tree is a
11930 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 n instance.** of
11940 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 2e this structure.
11950 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e 6f 70 20 69 .**.** Expr.op i
11960 73 20 74 68 65 20 6f 70 63 6f 64 65 2e 20 54 68 s the opcode. Th
11970 65 20 69 6e 74 65 67 65 72 20 70 61 72 73 65 72 e integer parser
11980 20 74 6f 6b 65 6e 20 63 6f 64 65 73 20 61 72 65 token codes are
11990 20 72 65 75 73 65 64 0a 2a 2a 20 61 73 20 6f 70 reused.** as op
119a0 63 6f 64 65 73 20 68 65 72 65 2e 20 46 6f 72 20 codes here. For
119b0 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 70 61 72 example, the par
119c0 73 65 72 20 64 65 66 69 6e 65 73 20 54 4b 5f 47 ser defines TK_G
119d0 45 20 74 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 E to be an integ
119e0 65 72 0a 2a 2a 20 63 6f 64 65 20 72 65 70 72 65 er.** code repre
119f0 73 65 6e 74 69 6e 67 20 74 68 65 20 22 3e 3d 22 senting the ">="
11a00 20 6f 70 65 72 61 74 6f 72 2e 20 54 68 69 73 20 operator. This
11a10 73 61 6d 65 20 69 6e 74 65 67 65 72 20 63 6f 64 same integer cod
11a20 65 20 69 73 20 72 65 75 73 65 64 0a 2a 2a 20 74 e is reused.** t
11a30 6f 20 72 65 70 72 65 73 65 6e 74 20 74 68 65 20 o represent the
11a40 67 72 65 61 74 65 72 2d 74 68 61 6e 2d 6f 72 2d greater-than-or-
11a50 65 71 75 61 6c 2d 74 6f 20 6f 70 65 72 61 74 6f equal-to operato
11a60 72 20 69 6e 20 74 68 65 20 65 78 70 72 65 73 73 r in the express
11a70 69 6f 6e 0a 2a 2a 20 74 72 65 65 2e 0a 2a 2a 0a ion.** tree..**.
11a80 2a 2a 20 49 66 20 74 68 65 20 65 78 70 72 65 73 ** If the expres
11a90 73 69 6f 6e 20 69 73 20 61 6e 20 53 51 4c 20 6c sion is an SQL l
11aa0 69 74 65 72 61 6c 20 28 54 4b 5f 49 4e 54 45 47 iteral (TK_INTEG
11ab0 45 52 2c 20 54 4b 5f 46 4c 4f 41 54 2c 20 54 4b ER, TK_FLOAT, TK
11ac0 5f 42 4c 4f 42 2c 20 0a 2a 2a 20 6f 72 20 54 4b _BLOB, .** or TK
11ad0 5f 53 54 52 49 4e 47 29 2c 20 74 68 65 6e 20 45 _STRING), then E
11ae0 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 xpr.token contai
11af0 6e 73 20 74 68 65 20 74 65 78 74 20 6f 66 20 74 ns the text of t
11b00 68 65 20 53 51 4c 20 6c 69 74 65 72 61 6c 2e 20 he SQL literal.
11b10 49 66 0a 2a 2a 20 74 68 65 20 65 78 70 72 65 73 If.** the expres
11b20 73 69 6f 6e 20 69 73 20 61 20 76 61 72 69 61 62 sion is a variab
11b30 6c 65 20 28 54 4b 5f 56 41 52 49 41 42 4c 45 29 le (TK_VARIABLE)
11b40 2c 20 74 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 , then Expr.toke
11b50 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 0a n contains the .
11b60 2a 2a 20 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 ** variable name
11b70 2e 20 46 69 6e 61 6c 6c 79 2c 20 69 66 20 74 68 . Finally, if th
11b80 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 e expression is
11b90 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 an SQL function
11ba0 28 54 4b 5f 46 55 4e 43 54 49 4f 4e 29 2c 0a 2a (TK_FUNCTION),.*
11bb0 2a 20 74 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 * then Expr.toke
11bc0 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e n contains the n
11bd0 61 6d 65 20 6f 66 20 74 68 65 20 66 75 6e 63 74 ame of the funct
11be0 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e ion..**.** Expr.
11bf0 70 52 69 67 68 74 20 61 6e 64 20 45 78 70 72 2e pRight and Expr.
11c00 70 4c 65 66 74 20 61 72 65 20 74 68 65 20 6c 65 pLeft are the le
11c10 66 74 20 61 6e 64 20 72 69 67 68 74 20 73 75 62 ft and right sub
11c20 65 78 70 72 65 73 73 69 6f 6e 73 20 6f 66 20 61 expressions of a
11c30 0a 2a 2a 20 62 69 6e 61 72 79 20 6f 70 65 72 61 .** binary opera
11c40 74 6f 72 2e 20 45 69 74 68 65 72 20 6f 72 20 62 tor. Either or b
11c50 6f 74 68 20 6d 61 79 20 62 65 20 4e 55 4c 4c 2e oth may be NULL.
11c60 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e 78 2e 70 4c .**.** Expr.x.pL
11c70 69 73 74 20 69 73 20 61 20 6c 69 73 74 20 6f 66 ist is a list of
11c80 20 61 72 67 75 6d 65 6e 74 73 20 69 66 20 74 68 arguments if th
11c90 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 e expression is
11ca0 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2c an SQL function,
11cb0 0a 2a 2a 20 61 20 43 41 53 45 20 65 78 70 72 65 .** a CASE expre
11cc0 73 73 69 6f 6e 20 6f 72 20 61 6e 20 49 4e 20 65 ssion or an IN e
11cd0 78 70 72 65 73 73 69 6f 6e 20 6f 66 20 74 68 65 xpression of the
11ce0 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 49 4e 20 form "<lhs> IN
11cf0 28 3c 79 3e 2c 20 3c 7a 3e 2e 2e 2e 29 22 2e 0a (<y>, <z>...)"..
11d00 2a 2a 20 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 ** Expr.x.pSelec
11d10 74 20 69 73 20 75 73 65 64 20 69 66 20 74 68 65 t is used if the
11d20 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 expression is a
11d30 20 73 75 62 2d 73 65 6c 65 63 74 20 6f 72 20 61 sub-select or a
11d40 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 66 0a n expression of.
11d50 2a 2a 20 74 68 65 20 66 6f 72 6d 20 22 3c 6c 68 ** the form "<lh
11d60 73 3e 20 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e s> IN (SELECT ..
11d70 2e 29 22 2e 20 49 66 20 74 68 65 20 45 50 5f 78 .)". If the EP_x
11d80 49 73 53 65 6c 65 63 74 20 62 69 74 20 69 73 20 IsSelect bit is
11d90 73 65 74 20 69 6e 20 74 68 65 0a 2a 2a 20 45 78 set in the.** Ex
11da0 70 72 2e 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 pr.flags mask, t
11db0 68 65 6e 20 45 78 70 72 2e 78 2e 70 53 65 6c 65 hen Expr.x.pSele
11dc0 63 74 20 69 73 20 76 61 6c 69 64 2e 20 4f 74 68 ct is valid. Oth
11dd0 65 72 77 69 73 65 2c 20 45 78 70 72 2e 78 2e 70 erwise, Expr.x.p
11de0 4c 69 73 74 20 69 73 20 0a 2a 2a 20 76 61 6c 69 List is .** vali
11df0 64 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 72 d..**.** An expr
11e00 65 73 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f ession of the fo
11e10 72 6d 20 49 44 20 6f 72 20 49 44 2e 49 44 20 72 rm ID or ID.ID r
11e20 65 66 65 72 73 20 74 6f 20 61 20 63 6f 6c 75 6d efers to a colum
11e30 6e 20 69 6e 20 61 20 74 61 62 6c 65 2e 0a 2a 2a n in a table..**
11e40 20 46 6f 72 20 73 75 63 68 20 65 78 70 72 65 73 For such expres
11e50 73 69 6f 6e 73 2c 20 45 78 70 72 2e 6f 70 20 69 sions, Expr.op i
11e60 73 20 73 65 74 20 74 6f 20 54 4b 5f 43 4f 4c 55 s set to TK_COLU
11e70 4d 4e 20 61 6e 64 20 45 78 70 72 2e 69 54 61 62 MN and Expr.iTab
11e80 6c 65 20 69 73 0a 2a 2a 20 74 68 65 20 69 6e 74 le is.** the int
11e90 65 67 65 72 20 63 75 72 73 6f 72 20 6e 75 6d 62 eger cursor numb
11ea0 65 72 20 6f 66 20 61 20 56 44 42 45 20 63 75 72 er of a VDBE cur
11eb0 73 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 sor pointing to
11ec0 74 68 61 74 20 74 61 62 6c 65 20 61 6e 64 0a 2a that table and.*
11ed0 2a 20 45 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 69 * Expr.iColumn i
11ee0 73 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d s the column num
11ef0 62 65 72 20 66 6f 72 20 74 68 65 20 73 70 65 63 ber for the spec
11f00 69 66 69 63 20 63 6f 6c 75 6d 6e 2e 20 20 49 66 ific column. If
11f10 20 74 68 65 0a 2a 2a 20 65 78 70 72 65 73 73 69 the.** expressi
11f20 6f 6e 20 69 73 20 75 73 65 64 20 61 73 20 61 20 on is used as a
11f30 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 61 67 67 result in an agg
11f40 72 65 67 61 74 65 20 53 45 4c 45 43 54 2c 20 74 regate SELECT, t
11f50 68 65 6e 20 74 68 65 0a 2a 2a 20 76 61 6c 75 65 hen the.** value
11f60 20 69 73 20 61 6c 73 6f 20 73 74 6f 72 65 64 20 is also stored
11f70 69 6e 20 74 68 65 20 45 78 70 72 2e 69 41 67 67 in the Expr.iAgg
11f80 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 61 column in the a
11f90 67 67 72 65 67 61 74 65 20 73 6f 20 74 68 61 74 ggregate so that
11fa0 0a 2a 2a 20 69 74 20 63 61 6e 20 62 65 20 61 63 .** it can be ac
11fb0 63 65 73 73 65 64 20 61 66 74 65 72 20 61 6c 6c cessed after all
11fc0 20 61 67 67 72 65 67 61 74 65 73 20 61 72 65 20 aggregates are
11fd0 63 6f 6d 70 75 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 computed..**.**
11fe0 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f If the expressio
11ff0 6e 20 69 73 20 61 6e 20 75 6e 62 6f 75 6e 64 20 n is an unbound
12000 76 61 72 69 61 62 6c 65 20 6d 61 72 6b 65 72 20 variable marker
12010 28 61 20 71 75 65 73 74 69 6f 6e 20 6d 61 72 6b (a question mark
12020 20 0a 2a 2a 20 63 68 61 72 61 63 74 65 72 20 27 .** character '
12030 3f 27 20 69 6e 20 74 68 65 20 6f 72 69 67 69 6e ?' in the origin
12040 61 6c 20 53 51 4c 29 20 74 68 65 6e 20 74 68 65 al SQL) then the
12050 20 45 78 70 72 2e 69 54 61 62 6c 65 20 68 6f 6c Expr.iTable hol
12060 64 73 20 74 68 65 20 69 6e 64 65 78 20 0a 2a 2a ds the index .**
12070 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 61 74 number for that
12080 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a variable..**.**
12090 20 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 If the expressi
120a0 6f 6e 20 69 73 20 61 20 73 75 62 71 75 65 72 79 on is a subquery
120b0 20 74 68 65 6e 20 45 78 70 72 2e 69 43 6f 6c 75 then Expr.iColu
120c0 6d 6e 20 68 6f 6c 64 73 20 61 6e 20 69 6e 74 65 mn holds an inte
120d0 67 65 72 0a 2a 2a 20 72 65 67 69 73 74 65 72 20 ger.** register
120e0 6e 75 6d 62 65 72 20 63 6f 6e 74 61 69 6e 69 6e number containin
120f0 67 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 g the result of
12100 74 68 65 20 73 75 62 71 75 65 72 79 2e 20 20 49 the subquery. I
12110 66 20 74 68 65 0a 2a 2a 20 73 75 62 71 75 65 72 f the.** subquer
12120 79 20 67 69 76 65 73 20 61 20 63 6f 6e 73 74 61 y gives a consta
12130 6e 74 20 72 65 73 75 6c 74 2c 20 74 68 65 6e 20 nt result, then
12140 69 54 61 62 6c 65 20 69 73 20 2d 31 2e 20 20 49 iTable is -1. I
12150 66 20 74 68 65 20 73 75 62 71 75 65 72 79 0a 2a f the subquery.*
12160 2a 20 67 69 76 65 73 20 61 20 64 69 66 66 65 72 * gives a differ
12170 65 6e 74 20 61 6e 73 77 65 72 20 61 74 20 64 69 ent answer at di
12180 66 66 65 72 65 6e 74 20 74 69 6d 65 73 20 64 75 fferent times du
12190 72 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20 70 ring statement p
121a0 72 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 rocessing.** the
121b0 6e 20 69 54 61 62 6c 65 20 69 73 20 74 68 65 20 n iTable is the
121c0 61 64 64 72 65 73 73 20 6f 66 20 61 20 73 75 62 address of a sub
121d0 72 6f 75 74 69 6e 65 20 74 68 61 74 20 63 6f 6d routine that com
121e0 70 75 74 65 73 20 74 68 65 20 73 75 62 71 75 65 putes the subque
121f0 72 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ry..**.** If the
12200 20 45 78 70 72 20 69 73 20 6f 66 20 74 79 70 65 Expr is of type
12210 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 61 6e 64 20 OP_Column, and
12220 74 68 65 20 74 61 62 6c 65 20 69 74 20 69 73 20 the table it is
12230 73 65 6c 65 63 74 69 6e 67 20 66 72 6f 6d 0a 2a selecting from.*
12240 2a 20 69 73 20 61 20 64 69 73 6b 20 74 61 62 6c * is a disk tabl
12250 65 20 6f 72 20 74 68 65 20 22 6f 6c 64 2e 2a 22 e or the "old.*"
12260 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 2c 20 74 pseudo-table, t
12270 68 65 6e 20 70 54 61 62 20 70 6f 69 6e 74 73 20 hen pTab points
12280 74 6f 20 74 68 65 0a 2a 2a 20 63 6f 72 72 65 73 to the.** corres
12290 70 6f 6e 64 69 6e 67 20 74 61 62 6c 65 20 64 65 ponding table de
122a0 66 69 6e 69 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 finition..**.**
122b0 41 4c 4c 4f 43 41 54 49 4f 4e 20 4e 4f 54 45 53 ALLOCATION NOTES
122c0 3a 0a 2a 2a 0a 2a 2a 20 45 78 70 72 20 6f 62 6a :.**.** Expr obj
122d0 65 63 74 73 20 63 61 6e 20 75 73 65 20 61 20 6c ects can use a l
122e0 6f 74 20 6f 66 20 6d 65 6d 6f 72 79 20 73 70 61 ot of memory spa
122f0 63 65 20 69 6e 20 64 61 74 61 62 61 73 65 20 73 ce in database s
12300 63 68 65 6d 61 2e 20 20 54 6f 0a 2a 2a 20 68 65 chema. To.** he
12310 6c 70 20 72 65 64 75 63 65 20 6d 65 6d 6f 72 79 lp reduce memory
12320 20 72 65 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 requirements, s
12330 6f 6d 65 74 69 6d 65 73 20 61 6e 20 45 78 70 72 ometimes an Expr
12340 20 6f 62 6a 65 63 74 20 77 69 6c 6c 20 62 65 0a object will be.
12350 2a 2a 20 74 72 75 6e 63 61 74 65 64 2e 20 20 41 ** truncated. A
12360 6e 64 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 nd to reduce the
12370 20 6e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 number of memor
12380 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 2c 20 73 y allocations, s
12390 6f 6d 65 74 69 6d 65 73 0a 2a 2a 20 74 77 6f 20 ometimes.** two
123a0 6f 72 20 6d 6f 72 65 20 45 78 70 72 20 6f 62 6a or more Expr obj
123b0 65 63 74 73 20 77 69 6c 6c 20 62 65 20 73 74 6f ects will be sto
123c0 72 65 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 red in a single
123d0 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
123e0 6e 2c 0a 2a 2a 20 74 6f 67 65 74 68 65 72 20 77 n,.** together w
123f0 69 74 68 20 45 78 70 72 2e 7a 54 6f 6b 65 6e 20 ith Expr.zToken
12400 73 74 72 69 6e 67 73 2e 0a 2a 2a 0a 2a 2a 20 49 strings..**.** I
12410 66 20 74 68 65 20 45 50 5f 52 65 64 75 63 65 64 f the EP_Reduced
12420 20 61 6e 64 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c and EP_TokenOnl
12430 79 20 66 6c 61 67 73 20 61 72 65 20 73 65 74 20 y flags are set
12440 77 68 65 6e 0a 2a 2a 20 61 6e 20 45 78 70 72 20 when.** an Expr
12450 6f 62 6a 65 63 74 20 69 73 20 74 72 75 6e 63 61 object is trunca
12460 74 65 64 2e 20 20 57 68 65 6e 20 45 50 5f 52 65 ted. When EP_Re
12470 64 75 63 65 64 20 69 73 20 73 65 74 2c 20 74 68 duced is set, th
12480 65 6e 20 61 6c 6c 0a 2a 2a 20 74 68 65 20 63 68 en all.** the ch
12490 69 6c 64 20 45 78 70 72 20 6f 62 6a 65 63 74 73 ild Expr objects
124a0 20 69 6e 20 74 68 65 20 45 78 70 72 2e 70 4c 65 in the Expr.pLe
124b0 66 74 20 61 6e 64 20 45 78 70 72 2e 70 52 69 67 ft and Expr.pRig
124c0 68 74 20 73 75 62 74 72 65 65 73 0a 2a 2a 20 61 ht subtrees.** a
124d0 72 65 20 63 6f 6e 74 61 69 6e 65 64 20 77 69 74 re contained wit
124e0 68 69 6e 20 74 68 65 20 73 61 6d 65 20 6d 65 6d hin the same mem
124f0 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 ory allocation.
12500 20 4e 6f 74 65 2c 20 68 6f 77 65 76 65 72 2c 20 Note, however,
12510 74 68 61 74 0a 2a 2a 20 74 68 65 20 73 75 62 74 that.** the subt
12520 72 65 65 73 20 69 6e 20 45 78 70 72 2e 78 2e 70 rees in Expr.x.p
12530 4c 69 73 74 20 6f 72 20 45 78 70 72 2e 78 2e 70 List or Expr.x.p
12540 53 65 6c 65 63 74 20 61 72 65 20 61 6c 77 61 79 Select are alway
12550 73 20 73 65 70 61 72 61 74 65 6c 79 0a 2a 2a 20 s separately.**
12560 61 6c 6c 6f 63 61 74 65 64 2c 20 72 65 67 61 72 allocated, regar
12570 64 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 dless of whether
12580 20 6f 72 20 6e 6f 74 20 45 50 5f 52 65 64 75 63 or not EP_Reduc
12590 65 64 20 69 73 20 73 65 74 2e 0a 2a 2f 0a 73 74 ed is set..*/.st
125a0 72 75 63 74 20 45 78 70 72 20 7b 0a 20 20 75 38 ruct Expr {. u8
125b0 20 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 op;
125c0 20 20 20 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f /* Operatio
125d0 6e 20 70 65 72 66 6f 72 6d 65 64 20 62 79 20 74 n performed by t
125e0 68 69 73 20 6e 6f 64 65 20 2a 2f 0a 20 20 63 68 his node */. ch
125f0 61 72 20 61 66 66 69 6e 69 74 79 3b 20 20 20 20 ar affinity;
12600 20 20 20 20 20 2f 2a 20 54 68 65 20 61 66 66 69 /* The affi
12610 6e 69 74 79 20 6f 66 20 74 68 65 20 63 6f 6c 75 nity of the colu
12620 6d 6e 20 6f 72 20 30 20 69 66 20 6e 6f 74 20 61 mn or 0 if not a
12630 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 75 33 32 column */. u32
12640 20 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 flags;
12650 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 66 /* Various f
12660 6c 61 67 73 2e 20 20 45 50 5f 2a 20 53 65 65 20 lags. EP_* See
12670 62 65 6c 6f 77 20 2a 2f 0a 20 20 75 6e 69 6f 6e below */. union
12680 20 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 54 6f {. char *zTo
12690 6b 65 6e 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ken; /*
126a0 20 54 6f 6b 65 6e 20 76 61 6c 75 65 2e 20 5a 65 Token value. Ze
126b0 72 6f 20 74 65 72 6d 69 6e 61 74 65 64 20 61 6e ro terminated an
126c0 64 20 64 65 71 75 6f 74 65 64 20 2a 2f 0a 20 20 d dequoted */.
126d0 20 20 69 6e 74 20 69 56 61 6c 75 65 3b 20 20 20 int iValue;
126e0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d /* Non-
126f0 6e 65 67 61 74 69 76 65 20 69 6e 74 65 67 65 72 negative integer
12700 20 76 61 6c 75 65 20 69 66 20 45 50 5f 49 6e 74 value if EP_Int
12710 56 61 6c 75 65 20 2a 2f 0a 20 20 7d 20 75 3b 0a Value */. } u;.
12720 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 45 50 5f . /* If the EP_
12730 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 67 20 69 TokenOnly flag i
12740 73 20 73 65 74 20 69 6e 20 74 68 65 20 45 78 70 s set in the Exp
12750 72 2e 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 r.flags mask, th
12760 65 6e 20 6e 6f 0a 20 20 2a 2a 20 73 70 61 63 65 en no. ** space
12770 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f is allocated fo
12780 72 20 74 68 65 20 66 69 65 6c 64 73 20 62 65 6c r the fields bel
12790 6f 77 20 74 68 69 73 20 70 6f 69 6e 74 2e 20 41 ow this point. A
127a0 6e 20 61 74 74 65 6d 70 74 20 74 6f 0a 20 20 2a n attempt to. *
127b0 2a 20 61 63 63 65 73 73 20 74 68 65 6d 20 77 69 * access them wi
127c0 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20 73 ll result in a s
127d0 65 67 66 61 75 6c 74 20 6f 72 20 6d 61 6c 66 75 egfault or malfu
127e0 6e 63 74 69 6f 6e 2e 20 0a 20 20 2a 2a 2a 2a 2a nction. . *****
127f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12800 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
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 2f 0a 0a 20 20 45 78 70 72 20 2a 70 4c 65 66 74 /.. Expr *pLeft
12840 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c ; /* L
12850 65 66 74 20 73 75 62 6e 6f 64 65 20 2a 2f 0a 20 eft subnode */.
12860 20 45 78 70 72 20 2a 70 52 69 67 68 74 3b 20 20 Expr *pRight;
12870 20 20 20 20 20 20 20 20 2f 2a 20 52 69 67 68 74 /* Right
12880 20 73 75 62 6e 6f 64 65 20 2a 2f 0a 20 20 75 6e subnode */. un
12890 69 6f 6e 20 7b 0a 20 20 20 20 45 78 70 72 4c 69 ion {. ExprLi
128a0 73 74 20 2a 70 4c 69 73 74 3b 20 20 20 20 20 2f st *pList; /
128b0 2a 20 6f 70 20 3d 20 49 4e 2c 20 45 58 49 53 54 * op = IN, EXIST
128c0 53 2c 20 53 45 4c 45 43 54 2c 20 43 41 53 45 2c S, SELECT, CASE,
128d0 20 46 55 4e 43 54 49 4f 4e 2c 20 42 45 54 57 45 FUNCTION, BETWE
128e0 45 4e 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 EN */. Select
128f0 20 2a 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f *pSelect; /
12900 2a 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 61 * EP_xIsSelect a
12910 6e 64 20 6f 70 20 3d 20 49 4e 2c 20 45 58 49 53 nd op = IN, EXIS
12920 54 53 2c 20 53 45 4c 45 43 54 20 2a 2f 0a 20 20 TS, SELECT */.
12930 7d 20 78 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 } x;.. /* If th
12940 65 20 45 50 5f 52 65 64 75 63 65 64 20 66 6c 61 e EP_Reduced fla
12950 67 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 g is set in the
12960 45 78 70 72 2e 66 6c 61 67 73 20 6d 61 73 6b 2c Expr.flags mask,
12970 20 74 68 65 6e 20 6e 6f 0a 20 20 2a 2a 20 73 70 then no. ** sp
12980 61 63 65 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 ace is allocated
12990 20 66 6f 72 20 74 68 65 20 66 69 65 6c 64 73 20 for the fields
129a0 62 65 6c 6f 77 20 74 68 69 73 20 70 6f 69 6e 74 below this point
129b0 2e 20 41 6e 20 61 74 74 65 6d 70 74 20 74 6f 0a . An attempt to.
129c0 20 20 2a 2a 20 61 63 63 65 73 73 20 74 68 65 6d ** access them
129d0 20 77 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 will result in
129e0 61 20 73 65 67 66 61 75 6c 74 20 6f 72 20 6d 61 a segfault or ma
129f0 6c 66 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a 2a lfunction.. ***
12a00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
12a10 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
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 2f 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f **/..#if SQLITE_
12a50 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 3e 30 MAX_EXPR_DEPTH>0
12a60 0a 20 20 69 6e 74 20 6e 48 65 69 67 68 74 3b 20 . int nHeight;
12a70 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 65 69 /* Hei
12a80 67 68 74 20 6f 66 20 74 68 65 20 74 72 65 65 20 ght of the tree
12a90 68 65 61 64 65 64 20 62 79 20 74 68 69 73 20 6e headed by this n
12aa0 6f 64 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 ode */.#endif.
12ab0 69 6e 74 20 69 54 61 62 6c 65 3b 20 20 20 20 20 int iTable;
12ac0 20 20 20 20 20 20 20 2f 2a 20 54 4b 5f 43 4f 4c /* TK_COL
12ad0 55 4d 4e 3a 20 63 75 72 73 6f 72 20 6e 75 6d 62 UMN: cursor numb
12ae0 65 72 20 6f 66 20 74 61 62 6c 65 20 68 6f 6c 64 er of table hold
12af0 69 6e 67 20 63 6f 6c 75 6d 6e 0a 20 20 20 20 20 ing column.
12b00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12b10 20 20 20 20 2a 2a 20 54 4b 5f 52 45 47 49 53 54 ** TK_REGIST
12b20 45 52 3a 20 72 65 67 69 73 74 65 72 20 6e 75 6d ER: register num
12b30 62 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 ber.
12b40 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 **
12b50 54 4b 5f 54 52 49 47 47 45 52 3a 20 31 20 2d 3e TK_TRIGGER: 1 ->
12b60 20 6e 65 77 2c 20 30 20 2d 3e 20 6f 6c 64 0a 20 new, 0 -> old.
12b70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12b80 20 20 20 20 20 20 20 20 2a 2a 20 45 50 5f 55 6e ** EP_Un
12b90 6c 69 6b 65 6c 79 3a 20 20 31 30 30 30 20 74 69 likely: 1000 ti
12ba0 6d 65 73 20 6c 69 6b 65 6c 69 68 6f 6f 64 20 2a mes likelihood *
12bb0 2f 0a 20 20 79 6e 56 61 72 20 69 43 6f 6c 75 6d /. ynVar iColum
12bc0 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 4b n; /* TK
12bd0 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c 75 6d 6e 20 _COLUMN: column
12be0 69 6e 64 65 78 2e 20 20 2d 31 20 66 6f 72 20 72 index. -1 for r
12bf0 6f 77 69 64 2e 0a 20 20 20 20 20 20 20 20 20 20 owid..
12c00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
12c10 2a 20 54 4b 5f 56 41 52 49 41 42 4c 45 3a 20 76 * TK_VARIABLE: v
12c20 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 72 20 28 ariable number (
12c30 61 6c 77 61 79 73 20 3e 3d 20 31 29 2e 20 2a 2f always >= 1). */
12c40 0a 20 20 69 31 36 20 69 41 67 67 3b 20 20 20 20 . i16 iAgg;
12c50 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 /* Whi
12c60 63 68 20 65 6e 74 72 79 20 69 6e 20 70 41 67 67 ch entry in pAgg
12c70 49 6e 66 6f 2d 3e 61 43 6f 6c 5b 5d 20 6f 72 20 Info->aCol[] or
12c80 2d 3e 61 46 75 6e 63 5b 5d 20 2a 2f 0a 20 20 69 ->aFunc[] */. i
12c90 31 36 20 69 52 69 67 68 74 4a 6f 69 6e 54 61 62 16 iRightJoinTab
12ca0 6c 65 3b 20 20 20 2f 2a 20 49 66 20 45 50 5f 46 le; /* If EP_F
12cb0 72 6f 6d 4a 6f 69 6e 2c 20 74 68 65 20 72 69 67 romJoin, the rig
12cc0 68 74 20 74 61 62 6c 65 20 6f 66 20 74 68 65 20 ht table of the
12cd0 6a 6f 69 6e 20 2a 2f 0a 20 20 75 38 20 6f 70 32 join */. u8 op2
12ce0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
12cf0 20 2f 2a 20 54 4b 5f 52 45 47 49 53 54 45 52 3a /* TK_REGISTER:
12d00 20 6f 72 69 67 69 6e 61 6c 20 76 61 6c 75 65 20 original value
12d10 6f 66 20 45 78 70 72 2e 6f 70 0a 20 20 20 20 20 of Expr.op.
12d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12d30 20 20 20 20 2a 2a 20 54 4b 5f 43 4f 4c 55 4d 4e ** TK_COLUMN
12d40 3a 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 70 : the value of p
12d50 35 20 66 6f 72 20 4f 50 5f 43 6f 6c 75 6d 6e 0a 5 for OP_Column.
12d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12d70 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f 41 ** TK_A
12d80 47 47 5f 46 55 4e 43 54 49 4f 4e 3a 20 6e 65 73 GG_FUNCTION: nes
12d90 74 69 6e 67 20 64 65 70 74 68 20 2a 2f 0a 20 20 ting depth */.
12da0 41 67 67 49 6e 66 6f 20 2a 70 41 67 67 49 6e 66 AggInfo *pAggInf
12db0 6f 3b 20 20 20 20 20 2f 2a 20 55 73 65 64 20 62 o; /* Used b
12dc0 79 20 54 4b 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 y TK_AGG_COLUMN
12dd0 61 6e 64 20 54 4b 5f 41 47 47 5f 46 55 4e 43 54 and TK_AGG_FUNCT
12de0 49 4f 4e 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a ION */. Table *
12df0 70 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 pTab;
12e00 2f 2a 20 54 61 62 6c 65 20 66 6f 72 20 54 4b 5f /* Table for TK_
12e10 43 4f 4c 55 4d 4e 20 65 78 70 72 65 73 73 69 6f COLUMN expressio
12e20 6e 73 2e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ns. */.};../*.**
12e30 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 The following a
12e40 72 65 20 74 68 65 20 6d 65 61 6e 69 6e 67 73 20 re the meanings
12e50 6f 66 20 62 69 74 73 20 69 6e 20 74 68 65 20 45 of bits in the E
12e60 78 70 72 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e xpr.flags field.
12e70 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 46 .*/.#define EP_F
12e80 72 6f 6d 4a 6f 69 6e 20 20 30 78 30 30 30 30 30 romJoin 0x00000
12e90 31 20 2f 2a 20 4f 72 69 67 69 6e 61 74 65 64 20 1 /* Originated
12ea0 69 6e 20 4f 4e 20 6f 72 20 55 53 49 4e 47 20 63 in ON or USING c
12eb0 6c 61 75 73 65 20 6f 66 20 61 20 6a 6f 69 6e 20 lause of a join
12ec0 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 67 */.#define EP_Ag
12ed0 67 20 20 20 20 20 20 20 30 78 30 30 30 30 30 32 g 0x000002
12ee0 20 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 /* Contains one
12ef0 20 6f 72 20 6d 6f 72 65 20 61 67 67 72 65 67 61 or more aggrega
12f00 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a te functions */.
12f10 23 64 65 66 69 6e 65 20 45 50 5f 52 65 73 6f 6c #define EP_Resol
12f20 76 65 64 20 20 30 78 30 30 30 30 30 34 20 2f 2a ved 0x000004 /*
12f30 20 49 44 73 20 68 61 76 65 20 62 65 65 6e 20 72 IDs have been r
12f40 65 73 6f 6c 76 65 64 20 74 6f 20 43 4f 4c 55 4d esolved to COLUM
12f50 4e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 Ns */.#define EP
12f60 5f 45 72 72 6f 72 20 20 20 20 20 30 78 30 30 30 _Error 0x000
12f70 30 30 38 20 2f 2a 20 45 78 70 72 65 73 73 69 6f 008 /* Expressio
12f80 6e 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f n contains one o
12f90 72 20 6d 6f 72 65 20 65 72 72 6f 72 73 20 2a 2f r more errors */
12fa0 0a 23 64 65 66 69 6e 65 20 45 50 5f 44 69 73 74 .#define EP_Dist
12fb0 69 6e 63 74 20 20 30 78 30 30 30 30 31 30 20 2f inct 0x000010 /
12fc0 2a 20 41 67 67 72 65 67 61 74 65 20 66 75 6e 63 * Aggregate func
12fd0 74 69 6f 6e 20 77 69 74 68 20 44 49 53 54 49 4e tion with DISTIN
12fe0 43 54 20 6b 65 79 77 6f 72 64 20 2a 2f 0a 23 64 CT keyword */.#d
12ff0 65 66 69 6e 65 20 45 50 5f 56 61 72 53 65 6c 65 efine EP_VarSele
13000 63 74 20 30 78 30 30 30 30 32 30 20 2f 2a 20 70 ct 0x000020 /* p
13010 53 65 6c 65 63 74 20 69 73 20 63 6f 72 72 65 6c Select is correl
13020 61 74 65 64 2c 20 6e 6f 74 20 63 6f 6e 73 74 61 ated, not consta
13030 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 nt */.#define EP
13040 5f 44 62 6c 51 75 6f 74 65 64 20 30 78 30 30 30 _DblQuoted 0x000
13050 30 34 30 20 2f 2a 20 74 6f 6b 65 6e 2e 7a 20 77 040 /* token.z w
13060 61 73 20 6f 72 69 67 69 6e 61 6c 6c 79 20 69 6e as originally in
13070 20 22 2e 2e 2e 22 20 2a 2f 0a 23 64 65 66 69 6e "..." */.#defin
13080 65 20 45 50 5f 49 6e 66 69 78 46 75 6e 63 20 30 e EP_InfixFunc 0
13090 78 30 30 30 30 38 30 20 2f 2a 20 54 72 75 65 20 x000080 /* True
130a0 66 6f 72 20 61 6e 20 69 6e 66 69 78 20 66 75 6e for an infix fun
130b0 63 74 69 6f 6e 3a 20 4c 49 4b 45 2c 20 47 4c 4f ction: LIKE, GLO
130c0 42 2c 20 65 74 63 20 2a 2f 0a 23 64 65 66 69 6e B, etc */.#defin
130d0 65 20 45 50 5f 43 6f 6c 6c 61 74 65 20 20 20 30 e EP_Collate 0
130e0 78 30 30 30 31 30 30 20 2f 2a 20 54 72 65 65 20 x000100 /* Tree
130f0 63 6f 6e 74 61 69 6e 73 20 61 20 54 4b 5f 43 4f contains a TK_CO
13100 4c 4c 41 54 45 20 6f 70 65 61 72 74 6f 72 20 2a LLATE opeartor *
13110 2f 0a 20 20 20 20 20 20 2f 2a 20 75 6e 75 73 65 /. /* unuse
13120 64 20 20 20 20 20 20 30 78 30 30 30 32 30 30 20 d 0x000200
13130 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 49 6e */.#define EP_In
13140 74 56 61 6c 75 65 20 20 30 78 30 30 30 34 30 30 tValue 0x000400
13150 20 2f 2a 20 49 6e 74 65 67 65 72 20 76 61 6c 75 /* Integer valu
13160 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 75 e contained in u
13170 2e 69 56 61 6c 75 65 20 2a 2f 0a 23 64 65 66 69 .iValue */.#defi
13180 6e 65 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 ne EP_xIsSelect
13190 30 78 30 30 30 38 30 30 20 2f 2a 20 78 2e 70 53 0x000800 /* x.pS
131a0 65 6c 65 63 74 20 69 73 20 76 61 6c 69 64 20 28 elect is valid (
131b0 6f 74 68 65 72 77 69 73 65 20 78 2e 70 4c 69 73 otherwise x.pLis
131c0 74 20 69 73 29 20 2a 2f 0a 23 64 65 66 69 6e 65 t is) */.#define
131d0 20 45 50 5f 53 6b 69 70 20 20 20 20 20 20 30 78 EP_Skip 0x
131e0 30 30 31 30 30 30 20 2f 2a 20 43 4f 4c 4c 41 54 001000 /* COLLAT
131f0 45 2c 20 41 53 2c 20 6f 72 20 55 4e 4c 49 4b 45 E, AS, or UNLIKE
13200 4c 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 LY */.#define EP
13210 5f 52 65 64 75 63 65 64 20 20 20 30 78 30 30 32 _Reduced 0x002
13220 30 30 30 20 2f 2a 20 45 78 70 72 20 73 74 72 75 000 /* Expr stru
13230 63 74 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 ct EXPR_REDUCEDS
13240 49 5a 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a IZE bytes only *
13250 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 54 6f 6b /.#define EP_Tok
13260 65 6e 4f 6e 6c 79 20 30 78 30 30 34 30 30 30 20 enOnly 0x004000
13270 2f 2a 20 45 78 70 72 20 73 74 72 75 63 74 20 45 /* Expr struct E
13280 58 50 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a XPR_TOKENONLYSIZ
13290 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a E bytes only */.
132a0 23 64 65 66 69 6e 65 20 45 50 5f 53 74 61 74 69 #define EP_Stati
132b0 63 20 20 20 20 30 78 30 30 38 30 30 30 20 2f 2a c 0x008000 /*
132c0 20 48 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 Held in memory
132d0 6e 6f 74 20 6f 62 74 61 69 6e 65 64 20 66 72 6f not obtained fro
132e0 6d 20 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 23 64 m malloc() */.#d
132f0 65 66 69 6e 65 20 45 50 5f 4d 65 6d 54 6f 6b 65 efine EP_MemToke
13300 6e 20 20 30 78 30 31 30 30 30 30 20 2f 2a 20 4e n 0x010000 /* N
13310 65 65 64 20 74 6f 20 73 71 6c 69 74 65 33 44 62 eed to sqlite3Db
13320 46 72 65 65 28 29 20 45 78 70 72 2e 7a 54 6f 6b Free() Expr.zTok
13330 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 en */.#define EP
13340 5f 4e 6f 52 65 64 75 63 65 20 20 30 78 30 32 30 _NoReduce 0x020
13350 30 30 30 20 2f 2a 20 43 61 6e 6e 6f 74 20 45 58 000 /* Cannot EX
13360 50 52 44 55 50 5f 52 45 44 55 43 45 20 74 68 69 PRDUP_REDUCE thi
13370 73 20 45 78 70 72 20 2a 2f 0a 23 64 65 66 69 6e s Expr */.#defin
13380 65 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 20 20 30 e EP_Unlikely 0
13390 78 30 34 30 30 30 30 20 2f 2a 20 75 6e 6c 69 6b x040000 /* unlik
133a0 65 6c 79 28 29 20 6f 72 20 6c 69 6b 65 6c 69 68 ely() or likelih
133b0 6f 6f 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a ood() function *
133c0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 6f 6e /.#define EP_Con
133d0 73 74 61 6e 74 20 20 30 78 30 38 30 30 30 30 20 stant 0x080000
133e0 2f 2a 20 4e 6f 64 65 20 69 73 20 61 20 63 6f 6e /* Node is a con
133f0 73 74 61 6e 74 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 stant */../*.**
13400 54 68 65 73 65 20 6d 61 63 72 6f 73 20 63 61 6e These macros can
13410 20 62 65 20 75 73 65 64 20 74 6f 20 74 65 73 74 be used to test
13420 2c 20 73 65 74 2c 20 6f 72 20 63 6c 65 61 72 20 , set, or clear
13430 62 69 74 73 20 69 6e 20 74 68 65 20 0a 2a 2a 20 bits in the .**
13440 45 78 70 72 2e 66 6c 61 67 73 20 66 69 65 6c 64 Expr.flags field
13450 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 78 70 ..*/.#define Exp
13460 72 48 61 73 50 72 6f 70 65 72 74 79 28 45 2c 50 rHasProperty(E,P
13470 29 20 20 20 20 20 28 28 28 45 29 2d 3e 66 6c 61 ) (((E)->fla
13480 67 73 26 28 50 29 29 21 3d 30 29 0a 23 64 65 66 gs&(P))!=0).#def
13490 69 6e 65 20 45 78 70 72 48 61 73 41 6c 6c 50 72 ine ExprHasAllPr
134a0 6f 70 65 72 74 79 28 45 2c 50 29 20 20 28 28 28 operty(E,P) (((
134b0 45 29 2d 3e 66 6c 61 67 73 26 28 50 29 29 3d 3d E)->flags&(P))==
134c0 28 50 29 29 0a 23 64 65 66 69 6e 65 20 45 78 70 (P)).#define Exp
134d0 72 53 65 74 50 72 6f 70 65 72 74 79 28 45 2c 50 rSetProperty(E,P
134e0 29 20 20 20 20 20 28 45 29 2d 3e 66 6c 61 67 73 ) (E)->flags
134f0 7c 3d 28 50 29 0a 23 64 65 66 69 6e 65 20 45 78 |=(P).#define Ex
13500 70 72 43 6c 65 61 72 50 72 6f 70 65 72 74 79 28 prClearProperty(
13510 45 2c 50 29 20 20 20 28 45 29 2d 3e 66 6c 61 67 E,P) (E)->flag
13520 73 26 3d 7e 28 50 29 0a 0a 2f 2a 20 54 68 65 20 s&=~(P)../* The
13530 45 78 70 72 53 65 74 56 56 41 50 72 6f 70 65 72 ExprSetVVAProper
13540 74 79 28 29 20 6d 61 63 72 6f 20 69 73 20 75 73 ty() macro is us
13550 65 64 20 66 6f 72 20 56 65 72 69 66 69 63 61 74 ed for Verificat
13560 69 6f 6e 2c 20 56 61 6c 69 64 61 74 69 6f 6e 2c ion, Validation,
13570 0a 2a 2a 20 61 6e 64 20 41 63 63 72 65 64 69 74 .** and Accredit
13580 61 74 69 6f 6e 20 6f 6e 6c 79 2e 20 20 49 74 20 ation only. It
13590 77 6f 72 6b 73 20 6c 69 6b 65 20 45 78 70 72 53 works like ExprS
135a0 65 74 50 72 6f 70 65 72 74 79 28 29 20 64 75 72 etProperty() dur
135b0 69 6e 67 20 56 56 41 0a 2a 2a 20 70 72 6f 63 65 ing VVA.** proce
135c0 73 73 65 73 20 62 75 74 20 69 73 20 61 20 6e 6f sses but is a no
135d0 2d 6f 70 20 66 6f 72 20 64 65 6c 69 76 65 72 79 -op for delivery
135e0 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
135f0 54 45 5f 44 45 42 55 47 0a 23 20 64 65 66 69 6e TE_DEBUG.# defin
13600 65 20 45 78 70 72 53 65 74 56 56 41 50 72 6f 70 e ExprSetVVAProp
13610 65 72 74 79 28 45 2c 50 29 20 20 28 45 29 2d 3e erty(E,P) (E)->
13620 66 6c 61 67 73 7c 3d 28 50 29 0a 23 65 6c 73 65 flags|=(P).#else
13630 0a 23 20 64 65 66 69 6e 65 20 45 78 70 72 53 65 .# define ExprSe
13640 74 56 56 41 50 72 6f 70 65 72 74 79 28 45 2c 50 tVVAProperty(E,P
13650 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
13660 4d 61 63 72 6f 73 20 74 6f 20 64 65 74 65 72 6d Macros to determ
13670 69 6e 65 20 74 68 65 20 6e 75 6d 62 65 72 20 6f ine the number o
13680 66 20 62 79 74 65 73 20 72 65 71 75 69 72 65 64 f bytes required
13690 20 62 79 20 61 20 6e 6f 72 6d 61 6c 20 45 78 70 by a normal Exp
136a0 72 20 0a 2a 2a 20 73 74 72 75 63 74 2c 20 61 6e r .** struct, an
136b0 20 45 78 70 72 20 73 74 72 75 63 74 20 77 69 74 Expr struct wit
136c0 68 20 74 68 65 20 45 50 5f 52 65 64 75 63 65 64 h the EP_Reduced
136d0 20 66 6c 61 67 20 73 65 74 20 69 6e 20 45 78 70 flag set in Exp
136e0 72 2e 66 6c 61 67 73 20 0a 2a 2a 20 61 6e 64 20 r.flags .** and
136f0 61 6e 20 45 78 70 72 20 73 74 72 75 63 74 20 77 an Expr struct w
13700 69 74 68 20 74 68 65 20 45 50 5f 54 6f 6b 65 6e ith the EP_Token
13710 4f 6e 6c 79 20 66 6c 61 67 20 73 65 74 2e 0a 2a Only flag set..*
13720 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 5f 46 /.#define EXPR_F
13730 55 4c 4c 53 49 5a 45 20 20 20 20 20 20 20 20 20 ULLSIZE
13740 20 20 73 69 7a 65 6f 66 28 45 78 70 72 29 20 20 sizeof(Expr)
13750 20 20 20 20 20 20 20 20 20 2f 2a 20 46 75 6c 6c /* Full
13760 20 73 69 7a 65 20 2a 2f 0a 23 64 65 66 69 6e 65 size */.#define
13770 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 49 5a EXPR_REDUCEDSIZ
13780 45 20 20 20 20 20 20 20 20 6f 66 66 73 65 74 6f E offseto
13790 66 28 45 78 70 72 2c 69 54 61 62 6c 65 29 20 20 f(Expr,iTable)
137a0 2f 2a 20 43 6f 6d 6d 6f 6e 20 66 65 61 74 75 72 /* Common featur
137b0 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 es */.#define EX
137c0 50 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a 45 PR_TOKENONLYSIZE
137d0 20 20 20 20 20 20 6f 66 66 73 65 74 6f 66 28 45 offsetof(E
137e0 78 70 72 2c 70 4c 65 66 74 29 20 20 20 2f 2a 20 xpr,pLeft) /*
137f0 46 65 77 65 72 20 66 65 61 74 75 72 65 73 20 2a Fewer features *
13800 2f 0a 0a 2f 2a 0a 2a 2a 20 46 6c 61 67 73 20 70 /../*.** Flags p
13810 61 73 73 65 64 20 74 6f 20 74 68 65 20 73 71 6c assed to the sql
13820 69 74 65 33 45 78 70 72 44 75 70 28 29 20 66 75 ite3ExprDup() fu
13830 6e 63 74 69 6f 6e 2e 20 53 65 65 20 74 68 65 20 nction. See the
13840 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74 20 0a header comment .
13850 2a 2a 20 61 62 6f 76 65 20 73 71 6c 69 74 65 33 ** above sqlite3
13860 45 78 70 72 44 75 70 28 29 20 66 6f 72 20 64 65 ExprDup() for de
13870 74 61 69 6c 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e tails..*/.#defin
13880 65 20 45 58 50 52 44 55 50 5f 52 45 44 55 43 45 e EXPRDUP_REDUCE
13890 20 20 20 20 20 20 20 20 20 30 78 30 30 30 31 20 0x0001
138a0 20 2f 2a 20 55 73 65 64 20 72 65 64 75 63 65 64 /* Used reduced
138b0 2d 73 69 7a 65 20 45 78 70 72 20 6e 6f 64 65 73 -size Expr nodes
138c0 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 73 */../*.** A lis
138d0 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e 73 t of expressions
138e0 2e 20 20 45 61 63 68 20 65 78 70 72 65 73 73 69 . Each expressi
138f0 6f 6e 20 6d 61 79 20 6f 70 74 69 6f 6e 61 6c 6c on may optionall
13900 79 20 68 61 76 65 20 61 0a 2a 2a 20 6e 61 6d 65 y have a.** name
13910 2e 20 20 41 6e 20 65 78 70 72 2f 6e 61 6d 65 20 . An expr/name
13920 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 63 61 6e 20 combination can
13930 62 65 20 75 73 65 64 20 69 6e 20 73 65 76 65 72 be used in sever
13940 61 6c 20 77 61 79 73 2c 20 73 75 63 68 0a 2a 2a al ways, such.**
13950 20 61 73 20 74 68 65 20 6c 69 73 74 20 6f 66 20 as the list of
13960 22 65 78 70 72 20 41 53 20 49 44 22 20 66 69 65 "expr AS ID" fie
13970 6c 64 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 20 lds following a
13980 22 53 45 4c 45 43 54 22 20 6f 72 20 69 6e 20 74 "SELECT" or in t
13990 68 65 0a 2a 2a 20 6c 69 73 74 20 6f 66 20 22 49 he.** list of "I
139a0 44 20 3d 20 65 78 70 72 22 20 69 74 65 6d 73 20 D = expr" items
139b0 69 6e 20 61 6e 20 55 50 44 41 54 45 2e 20 20 41 in an UPDATE. A
139c0 20 6c 69 73 74 20 6f 66 20 65 78 70 72 65 73 73 list of express
139d0 69 6f 6e 73 20 63 61 6e 0a 2a 2a 20 61 6c 73 6f ions can.** also
139e0 20 62 65 20 75 73 65 64 20 61 73 20 74 68 65 20 be used as the
139f0 61 72 67 75 6d 65 6e 74 20 74 6f 20 61 20 66 75 argument to a fu
13a00 6e 63 74 69 6f 6e 2c 20 69 6e 20 77 68 69 63 68 nction, in which
13a10 20 63 61 73 65 20 74 68 65 20 61 2e 7a 4e 61 6d case the a.zNam
13a20 65 0a 2a 2a 20 66 69 65 6c 64 20 69 73 20 6e 6f e.** field is no
13a30 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 42 79 t used..**.** By
13a40 20 64 65 66 61 75 6c 74 20 74 68 65 20 45 78 70 default the Exp
13a50 72 2e 7a 53 70 61 6e 20 66 69 65 6c 64 20 68 6f r.zSpan field ho
13a60 6c 64 73 20 61 20 68 75 6d 61 6e 2d 72 65 61 64 lds a human-read
13a70 61 62 6c 65 20 64 65 73 63 72 69 70 74 69 6f 6e able description
13a80 20 6f 66 0a 2a 2a 20 74 68 65 20 65 78 70 72 65 of.** the expre
13a90 73 73 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73 ssion that is us
13aa0 65 64 20 69 6e 20 74 68 65 20 67 65 6e 65 72 61 ed in the genera
13ab0 74 69 6f 6e 20 6f 66 20 65 72 72 6f 72 20 6d 65 tion of error me
13ac0 73 73 61 67 65 73 20 61 6e 64 0a 2a 2a 20 63 6f ssages and.** co
13ad0 6c 75 6d 6e 20 6c 61 62 65 6c 73 2e 20 20 49 6e lumn labels. In
13ae0 20 74 68 69 73 20 63 61 73 65 2c 20 45 78 70 72 this case, Expr
13af0 2e 7a 53 70 61 6e 20 69 73 20 74 79 70 69 63 61 .zSpan is typica
13b00 6c 6c 79 20 74 68 65 20 74 65 78 74 20 6f 66 20 lly the text of
13b10 61 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 65 78 70 72 a.** column expr
13b20 65 73 73 69 6f 6e 20 61 73 20 69 74 20 65 78 69 ession as it exi
13b30 73 74 73 20 69 6e 20 61 20 53 45 4c 45 43 54 20 sts in a SELECT
13b40 73 74 61 74 65 6d 65 6e 74 2e 20 20 48 6f 77 65 statement. Howe
13b50 76 65 72 2c 20 69 66 0a 2a 2a 20 74 68 65 20 62 ver, if.** the b
13b60 53 70 61 6e 49 73 54 61 62 20 66 6c 61 67 20 69 SpanIsTab flag i
13b70 73 20 73 65 74 2c 20 74 68 65 6e 20 7a 53 70 61 s set, then zSpa
13b80 6e 20 69 73 20 6f 76 65 72 6c 6f 61 64 65 64 20 n is overloaded
13b90 74 6f 20 6d 65 61 6e 20 74 68 65 20 6e 61 6d 65 to mean the name
13ba0 0a 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75 6c .** of the resul
13bb0 74 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 t column in the
13bc0 66 6f 72 6d 3a 20 44 41 54 41 42 41 53 45 2e 54 form: DATABASE.T
13bd0 41 42 4c 45 2e 43 4f 4c 55 4d 4e 2e 20 20 54 68 ABLE.COLUMN. Th
13be0 69 73 20 6c 61 74 65 72 0a 2a 2a 20 66 6f 72 6d is later.** form
13bf0 20 69 73 20 75 73 65 64 20 66 6f 72 20 6e 61 6d is used for nam
13c00 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 77 69 74 e resolution wit
13c10 68 20 6e 65 73 74 65 64 20 46 52 4f 4d 20 63 6c h nested FROM cl
13c20 61 75 73 65 73 2e 0a 2a 2f 0a 73 74 72 75 63 74 auses..*/.struct
13c30 20 45 78 70 72 4c 69 73 74 20 7b 0a 20 20 69 6e ExprList {. in
13c40 74 20 6e 45 78 70 72 3b 20 20 20 20 20 20 20 20 t nExpr;
13c50 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
13c60 66 20 65 78 70 72 65 73 73 69 6f 6e 73 20 6f 6e f expressions on
13c70 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a 20 20 69 the list */. i
13c80 6e 74 20 69 45 43 75 72 73 6f 72 3b 20 20 20 20 nt iECursor;
13c90 20 20 20 20 20 20 2f 2a 20 56 44 42 45 20 43 75 /* VDBE Cu
13ca0 72 73 6f 72 20 61 73 73 6f 63 69 61 74 65 64 20 rsor associated
13cb0 77 69 74 68 20 74 68 69 73 20 45 78 70 72 4c 69 with this ExprLi
13cc0 73 74 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 45 st */. struct E
13cd0 78 70 72 4c 69 73 74 5f 69 74 65 6d 20 7b 20 2f xprList_item { /
13ce0 2a 20 46 6f 72 20 65 61 63 68 20 65 78 70 72 65 * For each expre
13cf0 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 6c 69 73 ssion in the lis
13d00 74 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 t */. Expr *p
13d10 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 Expr;
13d20 20 2f 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 /* The list of
13d30 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 expressions */.
13d40 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 char *zName;
13d50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f /* To
13d60 6b 65 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 ken associated w
13d70 69 74 68 20 74 68 69 73 20 65 78 70 72 65 73 73 ith this express
13d80 69 6f 6e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 ion */. char
13d90 2a 7a 53 70 61 6e 3b 20 20 20 20 20 20 20 20 20 *zSpan;
13da0 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 74 /* Original t
13db0 65 78 74 20 6f 66 20 74 68 65 20 65 78 70 72 65 ext of the expre
13dc0 73 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 75 38 20 ssion */. u8
13dd0 73 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 20 20 sortOrder;
13de0 20 20 20 20 20 2f 2a 20 31 20 66 6f 72 20 44 45 /* 1 for DE
13df0 53 43 20 6f 72 20 30 20 66 6f 72 20 41 53 43 20 SC or 0 for ASC
13e00 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 */. unsigned
13e10 64 6f 6e 65 20 3a 31 3b 20 20 20 20 20 20 20 2f done :1; /
13e20 2a 20 41 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 * A flag to indi
13e30 63 61 74 65 20 77 68 65 6e 20 70 72 6f 63 65 73 cate when proces
13e40 73 69 6e 67 20 69 73 20 66 69 6e 69 73 68 65 64 sing is finished
13e50 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 */. unsigned
13e60 20 62 53 70 61 6e 49 73 54 61 62 20 3a 31 3b 20 bSpanIsTab :1;
13e70 2f 2a 20 7a 53 70 61 6e 20 68 6f 6c 64 73 20 44 /* zSpan holds D
13e80 42 2e 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 20 2a B.TABLE.COLUMN *
13e90 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 72 /. unsigned r
13ea0 65 75 73 61 62 6c 65 20 3a 31 3b 20 20 20 2f 2a eusable :1; /*
13eb0 20 43 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 Constant expres
13ec0 73 69 6f 6e 20 69 73 20 72 65 75 73 61 62 6c 65 sion is reusable
13ed0 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 20 7b 0a */. union {.
13ee0 20 20 20 20 20 20 73 74 72 75 63 74 20 7b 0a 20 struct {.
13ef0 20 20 20 20 20 20 20 75 31 36 20 69 4f 72 64 65 u16 iOrde
13f00 72 42 79 43 6f 6c 3b 20 20 20 20 20 20 2f 2a 20 rByCol; /*
13f10 46 6f 72 20 4f 52 44 45 52 20 42 59 2c 20 63 6f For ORDER BY, co
13f20 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 72 lumn number in r
13f30 65 73 75 6c 74 20 73 65 74 20 2a 2f 0a 20 20 20 esult set */.
13f40 20 20 20 20 20 75 31 36 20 69 41 6c 69 61 73 3b u16 iAlias;
13f50 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
13f60 64 65 78 20 69 6e 74 6f 20 50 61 72 73 65 2e 61 dex into Parse.a
13f70 41 6c 69 61 73 5b 5d 20 66 6f 72 20 7a 4e 61 6d Alias[] for zNam
13f80 65 20 2a 2f 0a 20 20 20 20 20 20 7d 20 78 3b 0a e */. } x;.
13f90 20 20 20 20 20 20 69 6e 74 20 69 43 6f 6e 73 74 int iConst
13fa0 45 78 70 72 52 65 67 3b 20 20 20 20 20 20 2f 2a ExprReg; /*
13fb0 20 52 65 67 69 73 74 65 72 20 69 6e 20 77 68 69 Register in whi
13fc0 63 68 20 45 78 70 72 20 76 61 6c 75 65 20 69 73 ch Expr value is
13fd0 20 63 61 63 68 65 64 20 2a 2f 0a 20 20 20 20 7d cached */. }
13fe0 20 75 3b 0a 20 20 7d 20 2a 61 3b 20 20 20 20 20 u;. } *a;
13ff0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
14000 41 6c 6c 6f 63 20 61 20 70 6f 77 65 72 20 6f 66 Alloc a power of
14010 20 74 77 6f 20 67 72 65 61 74 65 72 20 6f 72 20 two greater or
14020 65 71 75 61 6c 20 74 6f 20 6e 45 78 70 72 20 2a equal to nExpr *
14030 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 /.};../*.** An i
14040 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 nstance of this
14050 73 74 72 75 63 74 75 72 65 20 69 73 20 75 73 65 structure is use
14060 64 20 62 79 20 74 68 65 20 70 61 72 73 65 72 20 d by the parser
14070 74 6f 20 72 65 63 6f 72 64 20 62 6f 74 68 0a 2a to record both.*
14080 2a 20 74 68 65 20 70 61 72 73 65 20 74 72 65 65 * the parse tree
14090 20 66 6f 72 20 61 6e 20 65 78 70 72 65 73 73 69 for an expressi
140a0 6f 6e 20 61 6e 64 20 74 68 65 20 73 70 61 6e 20 on and the span
140b0 6f 66 20 69 6e 70 75 74 20 74 65 78 74 20 66 6f of input text fo
140c0 72 20 61 6e 0a 2a 2a 20 65 78 70 72 65 73 73 69 r an.** expressi
140d0 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 on..*/.struct Ex
140e0 70 72 53 70 61 6e 20 7b 0a 20 20 45 78 70 72 20 prSpan {. Expr
140f0 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 *pExpr;
14100 20 2f 2a 20 54 68 65 20 65 78 70 72 65 73 73 69 /* The expressi
14110 6f 6e 20 70 61 72 73 65 20 74 72 65 65 20 2a 2f on parse tree */
14120 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
14130 53 74 61 72 74 3b 20 20 20 2f 2a 20 46 69 72 73 Start; /* Firs
14140 74 20 63 68 61 72 61 63 74 65 72 20 6f 66 20 69 t character of i
14150 6e 70 75 74 20 74 65 78 74 20 2a 2f 0a 20 20 63 nput text */. c
14160 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 6e 64 3b onst char *zEnd;
14170 20 20 20 20 20 2f 2a 20 4f 6e 65 20 63 68 61 72 /* One char
14180 61 63 74 65 72 20 70 61 73 74 20 74 68 65 20 65 acter past the e
14190 6e 64 20 6f 66 20 69 6e 70 75 74 20 74 65 78 74 nd of input text
141a0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
141b0 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 instance of thi
141c0 73 20 73 74 72 75 63 74 75 72 65 20 63 61 6e 20 s structure can
141d0 68 6f 6c 64 20 61 20 73 69 6d 70 6c 65 20 6c 69 hold a simple li
141e0 73 74 20 6f 66 20 69 64 65 6e 74 69 66 69 65 72 st of identifier
141f0 73 2c 0a 2a 2a 20 73 75 63 68 20 61 73 20 74 68 s,.** such as th
14200 65 20 6c 69 73 74 20 22 61 2c 62 2c 63 22 20 69 e list "a,b,c" i
14210 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 n the following
14220 73 74 61 74 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a statements:.**.*
14230 2a 20 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e * INSERT IN
14240 54 4f 20 74 28 61 2c 62 2c 63 29 20 56 41 4c 55 TO t(a,b,c) VALU
14250 45 53 20 2e 2e 2e 3b 0a 2a 2a 20 20 20 20 20 20 ES ...;.**
14260 43 52 45 41 54 45 20 49 4e 44 45 58 20 69 64 78 CREATE INDEX idx
14270 20 4f 4e 20 74 28 61 2c 62 2c 63 29 3b 0a 2a 2a ON t(a,b,c);.**
14280 20 20 20 20 20 20 43 52 45 41 54 45 20 54 52 49 CREATE TRI
14290 47 47 45 52 20 74 72 69 67 20 42 45 46 4f 52 45 GGER trig BEFORE
142a0 20 55 50 44 41 54 45 20 4f 4e 20 74 28 61 2c 62 UPDATE ON t(a,b
142b0 2c 63 29 20 2e 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 ,c) ...;.**.** T
142c0 68 65 20 49 64 4c 69 73 74 2e 61 2e 69 64 78 20 he IdList.a.idx
142d0 66 69 65 6c 64 20 69 73 20 75 73 65 64 20 77 68 field is used wh
142e0 65 6e 20 74 68 65 20 49 64 4c 69 73 74 20 72 65 en the IdList re
142f0 70 72 65 73 65 6e 74 73 20 74 68 65 20 6c 69 73 presents the lis
14300 74 20 6f 66 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6e t of.** column n
14310 61 6d 65 73 20 61 66 74 65 72 20 61 20 74 61 62 ames after a tab
14320 6c 65 20 6e 61 6d 65 20 69 6e 20 61 6e 20 49 4e le name in an IN
14330 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 SERT statement.
14340 20 49 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e In the statemen
14350 74 0a 2a 2a 0a 2a 2a 20 20 20 20 20 49 4e 53 45 t.**.** INSE
14360 52 54 20 49 4e 54 4f 20 74 28 61 2c 62 2c 63 29 RT INTO t(a,b,c)
14370 20 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 22 61 ....**.** If "a
14380 22 20 69 73 20 74 68 65 20 6b 2d 74 68 20 63 6f " is the k-th co
14390 6c 75 6d 6e 20 6f 66 20 74 61 62 6c 65 20 22 74 lumn of table "t
143a0 22 2c 20 74 68 65 6e 20 49 64 4c 69 73 74 2e 61 ", then IdList.a
143b0 5b 30 5d 2e 69 64 78 3d 3d 6b 2e 0a 2a 2f 0a 73 [0].idx==k..*/.s
143c0 74 72 75 63 74 20 49 64 4c 69 73 74 20 7b 0a 20 truct IdList {.
143d0 20 73 74 72 75 63 74 20 49 64 4c 69 73 74 5f 69 struct IdList_i
143e0 74 65 6d 20 7b 0a 20 20 20 20 63 68 61 72 20 2a tem {. char *
143f0 7a 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 4e zName; /* N
14400 61 6d 65 20 6f 66 20 74 68 65 20 69 64 65 6e 74 ame of the ident
14410 69 66 69 65 72 20 2a 2f 0a 20 20 20 20 69 6e 74 ifier */. int
14420 20 69 64 78 3b 20 20 20 20 20 20 20 20 20 20 2f idx; /
14430 2a 20 49 6e 64 65 78 20 69 6e 20 73 6f 6d 65 20 * Index in some
14440 54 61 62 6c 65 2e 61 43 6f 6c 5b 5d 20 6f 66 20 Table.aCol[] of
14450 61 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 64 20 7a a column named z
14460 4e 61 6d 65 20 2a 2f 0a 20 20 7d 20 2a 61 3b 0a Name */. } *a;.
14470 20 20 69 6e 74 20 6e 49 64 3b 20 20 20 20 20 20 int nId;
14480 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
14490 69 64 65 6e 74 69 66 69 65 72 73 20 6f 6e 20 74 identifiers on t
144a0 68 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f he list */.};../
144b0 2a 0a 2a 2a 20 54 68 65 20 62 69 74 6d 61 73 6b *.** The bitmask
144c0 20 64 61 74 61 74 79 70 65 20 64 65 66 69 6e 65 datatype define
144d0 64 20 62 65 6c 6f 77 20 69 73 20 75 73 65 64 20 d below is used
144e0 66 6f 72 20 76 61 72 69 6f 75 73 20 6f 70 74 69 for various opti
144f0 6d 69 7a 61 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a mizations..**.**
14500 20 43 68 61 6e 67 69 6e 67 20 74 68 69 73 20 66 Changing this f
14510 72 6f 6d 20 61 20 36 34 2d 62 69 74 20 74 6f 20 rom a 64-bit to
14520 61 20 33 32 2d 62 69 74 20 74 79 70 65 20 6c 69 a 32-bit type li
14530 6d 69 74 73 20 74 68 65 20 6e 75 6d 62 65 72 20 mits the number
14540 6f 66 0a 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 of.** tables in
14550 61 20 6a 6f 69 6e 20 74 6f 20 33 32 20 69 6e 73 a join to 32 ins
14560 74 65 61 64 20 6f 66 20 36 34 2e 20 20 42 75 74 tead of 64. But
14570 20 69 74 20 61 6c 73 6f 20 72 65 64 75 63 65 73 it also reduces
14580 20 74 68 65 20 73 69 7a 65 0a 2a 2a 20 6f 66 20 the size.** of
14590 74 68 65 20 6c 69 62 72 61 72 79 20 62 79 20 37 the library by 7
145a0 33 38 20 62 79 74 65 73 20 6f 6e 20 69 78 38 36 38 bytes on ix86
145b0 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 75 36 34 ..*/.typedef u64
145c0 20 42 69 74 6d 61 73 6b 3b 0a 0a 2f 2a 0a 2a 2a Bitmask;../*.**
145d0 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 The number of b
145e0 69 74 73 20 69 6e 20 61 20 42 69 74 6d 61 73 6b its in a Bitmask
145f0 2e 20 20 22 42 4d 53 22 20 6d 65 61 6e 73 20 22 . "BMS" means "
14600 42 69 74 4d 61 73 6b 20 53 69 7a 65 22 2e 0a 2a BitMask Size"..*
14610 2f 0a 23 64 65 66 69 6e 65 20 42 4d 53 20 20 28 /.#define BMS (
14620 28 69 6e 74 29 28 73 69 7a 65 6f 66 28 42 69 74 (int)(sizeof(Bit
14630 6d 61 73 6b 29 2a 38 29 29 0a 0a 2f 2a 0a 2a 2a mask)*8))../*.**
14640 20 41 20 62 69 74 20 69 6e 20 61 20 42 69 74 6d A bit in a Bitm
14650 61 73 6b 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d ask.*/.#define M
14660 41 53 4b 42 49 54 28 6e 29 20 20 20 28 28 28 42 ASKBIT(n) (((B
14670 69 74 6d 61 73 6b 29 31 29 3c 3c 28 6e 29 29 0a itmask)1)<<(n)).
14680 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
14690 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 64 wing structure d
146a0 65 73 63 72 69 62 65 73 20 74 68 65 20 46 52 4f escribes the FRO
146b0 4d 20 63 6c 61 75 73 65 20 6f 66 20 61 20 53 45 M clause of a SE
146c0 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a LECT statement..
146d0 2a 2a 20 45 61 63 68 20 74 61 62 6c 65 20 6f 72 ** Each table or
146e0 20 73 75 62 71 75 65 72 79 20 69 6e 20 74 68 65 subquery in the
146f0 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 69 73 20 FROM clause is
14700 61 20 73 65 70 61 72 61 74 65 20 65 6c 65 6d 65 a separate eleme
14710 6e 74 20 6f 66 0a 2a 2a 20 74 68 65 20 53 72 63 nt of.** the Src
14720 4c 69 73 74 2e 61 5b 5d 20 61 72 72 61 79 2e 0a List.a[] array..
14730 2a 2a 0a 2a 2a 20 57 69 74 68 20 74 68 65 20 61 **.** With the a
14740 64 64 69 74 69 6f 6e 20 6f 66 20 6d 75 6c 74 69 ddition of multi
14750 70 6c 65 20 64 61 74 61 62 61 73 65 20 73 75 70 ple database sup
14760 70 6f 72 74 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 port, the follow
14770 69 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2a ing structure.**
14780 20 63 61 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 can also be use
14790 64 20 74 6f 20 64 65 73 63 72 69 62 65 20 61 20 d to describe a
147a0 70 61 72 74 69 63 75 6c 61 72 20 74 61 62 6c 65 particular table
147b0 20 73 75 63 68 20 61 73 20 74 68 65 20 74 61 62 such as the tab
147c0 6c 65 20 74 68 61 74 0a 2a 2a 20 69 73 20 6d 6f le that.** is mo
147d0 64 69 66 69 65 64 20 62 79 20 61 6e 20 49 4e 53 dified by an INS
147e0 45 52 54 2c 20 44 45 4c 45 54 45 2c 20 6f 72 20 ERT, DELETE, or
147f0 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 UPDATE statement
14800 2e 20 20 49 6e 20 73 74 61 6e 64 61 72 64 20 53 . In standard S
14810 51 4c 2c 0a 2a 2a 20 73 75 63 68 20 61 20 74 61 QL,.** such a ta
14820 62 6c 65 20 6d 75 73 74 20 62 65 20 61 20 73 69 ble must be a si
14830 6d 70 6c 65 20 6e 61 6d 65 3a 20 49 44 2e 20 20 mple name: ID.
14840 42 75 74 20 69 6e 20 53 51 4c 69 74 65 2c 20 74 But in SQLite, t
14850 68 65 20 74 61 62 6c 65 20 63 61 6e 0a 2a 2a 20 he table can.**
14860 6e 6f 77 20 62 65 20 69 64 65 6e 74 69 66 69 65 now be identifie
14870 64 20 62 79 20 61 20 64 61 74 61 62 61 73 65 20 d by a database
14880 6e 61 6d 65 2c 20 61 20 64 6f 74 2c 20 74 68 65 name, a dot, the
14890 6e 20 74 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 n the table name
148a0 3a 20 49 44 2e 49 44 2e 0a 2a 2a 0a 2a 2a 20 54 : ID.ID..**.** T
148b0 68 65 20 6a 6f 69 6e 74 79 70 65 20 73 74 61 72 he jointype star
148c0 74 73 20 6f 75 74 20 73 68 6f 77 69 6e 67 20 74 ts out showing t
148d0 68 65 20 6a 6f 69 6e 20 74 79 70 65 20 62 65 74 he join type bet
148e0 77 65 65 6e 20 74 68 65 20 63 75 72 72 65 6e 74 ween the current
148f0 20 74 61 62 6c 65 0a 2a 2a 20 61 6e 64 20 74 68 table.** and th
14900 65 20 6e 65 78 74 20 74 61 62 6c 65 20 6f 6e 20 e next table on
14910 74 68 65 20 6c 69 73 74 2e 20 20 54 68 65 20 70 the list. The p
14920 61 72 73 65 72 20 62 75 69 6c 64 73 20 74 68 65 arser builds the
14930 20 6c 69 73 74 20 74 68 69 73 20 77 61 79 2e 0a list this way..
14940 2a 2a 20 42 75 74 20 73 71 6c 69 74 65 33 53 72 ** But sqlite3Sr
14950 63 4c 69 73 74 53 68 69 66 74 4a 6f 69 6e 54 79 cListShiftJoinTy
14960 70 65 28 29 20 6c 61 74 65 72 20 73 68 69 66 74 pe() later shift
14970 73 20 74 68 65 20 6a 6f 69 6e 74 79 70 65 73 20 s the jointypes
14980 73 6f 20 74 68 61 74 20 65 61 63 68 0a 2a 2a 20 so that each.**
14990 6a 6f 69 6e 74 79 70 65 20 65 78 70 72 65 73 73 jointype express
149a0 65 73 20 74 68 65 20 6a 6f 69 6e 20 62 65 74 77 es the join betw
149b0 65 65 6e 20 74 68 65 20 74 61 62 6c 65 20 61 6e een the table an
149c0 64 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 74 d the previous t
149d0 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 able..**.** In t
149e0 68 65 20 63 6f 6c 55 73 65 64 20 66 69 65 6c 64 he colUsed field
149f0 2c 20 74 68 65 20 68 69 67 68 2d 6f 72 64 65 72 , the high-order
14a00 20 62 69 74 20 28 62 69 74 20 36 33 29 20 69 73 bit (bit 63) is
14a10 20 73 65 74 20 69 66 20 74 68 65 20 74 61 62 6c set if the tabl
14a20 65 0a 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 6d 6f e.** contains mo
14a30 72 65 20 74 68 61 6e 20 36 33 20 63 6f 6c 75 6d re than 63 colum
14a40 6e 73 20 61 6e 64 20 74 68 65 20 36 34 2d 74 68 ns and the 64-th
14a50 20 6f 72 20 6c 61 74 65 72 20 63 6f 6c 75 6d 6e or later column
14a60 20 69 73 20 75 73 65 64 2e 0a 2a 2f 0a 73 74 72 is used..*/.str
14a70 75 63 74 20 53 72 63 4c 69 73 74 20 7b 0a 20 20 uct SrcList {.
14a80 75 38 20 6e 53 72 63 3b 20 20 20 20 20 20 20 20 u8 nSrc;
14a90 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 61 62 /* Number of tab
14aa0 6c 65 73 20 6f 72 20 73 75 62 71 75 65 72 69 65 les or subquerie
14ab0 73 20 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c s in the FROM cl
14ac0 61 75 73 65 20 2a 2f 0a 20 20 75 38 20 6e 41 6c ause */. u8 nAl
14ad0 6c 6f 63 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d loc; /* Num
14ae0 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 61 ber of entries a
14af0 6c 6c 6f 63 61 74 65 64 20 69 6e 20 61 5b 5d 20 llocated in a[]
14b00 62 65 6c 6f 77 20 2a 2f 0a 20 20 73 74 72 75 63 below */. struc
14b10 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 7b t SrcList_item {
14b20 0a 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53 63 . Schema *pSc
14b30 68 65 6d 61 3b 20 20 2f 2a 20 53 63 68 65 6d 61 hema; /* Schema
14b40 20 74 6f 20 77 68 69 63 68 20 74 68 69 73 20 69 to which this i
14b50 74 65 6d 20 69 73 20 66 69 78 65 64 20 2a 2f 0a tem is fixed */.
14b60 20 20 20 20 63 68 61 72 20 2a 7a 44 61 74 61 62 char *zDatab
14b70 61 73 65 3b 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 ase; /* Name of
14b80 20 64 61 74 61 62 61 73 65 20 68 6f 6c 64 69 6e database holdin
14b90 67 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a g this table */.
14ba0 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b char *zName;
14bb0 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
14bc0 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 the table */.
14bd0 20 20 63 68 61 72 20 2a 7a 41 6c 69 61 73 3b 20 char *zAlias;
14be0 20 20 20 20 2f 2a 20 54 68 65 20 22 42 22 20 70 /* The "B" p
14bf0 61 72 74 20 6f 66 20 61 20 22 41 20 41 53 20 42 art of a "A AS B
14c00 22 20 70 68 72 61 73 65 2e 20 20 7a 4e 61 6d 65 " phrase. zName
14c10 20 69 73 20 74 68 65 20 22 41 22 20 2a 2f 0a 20 is the "A" */.
14c20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 Table *pTab;
14c30 20 20 20 20 20 2f 2a 20 41 6e 20 53 51 4c 20 74 /* An SQL t
14c40 61 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 able correspondi
14c50 6e 67 20 74 6f 20 7a 4e 61 6d 65 20 2a 2f 0a 20 ng to zName */.
14c60 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 Select *pSele
14c70 63 74 3b 20 20 2f 2a 20 41 20 53 45 4c 45 43 54 ct; /* A SELECT
14c80 20 73 74 61 74 65 6d 65 6e 74 20 75 73 65 64 20 statement used
14c90 69 6e 20 70 6c 61 63 65 20 6f 66 20 61 20 74 61 in place of a ta
14ca0 62 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 ble name */.
14cb0 69 6e 74 20 61 64 64 72 46 69 6c 6c 53 75 62 3b int addrFillSub;
14cc0 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 /* Address of
14cd0 73 75 62 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 subroutine to ma
14ce0 6e 69 66 65 73 74 20 61 20 73 75 62 71 75 65 72 nifest a subquer
14cf0 79 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 y */. int reg
14d00 52 65 74 75 72 6e 3b 20 20 20 20 2f 2a 20 52 65 Return; /* Re
14d10 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 gister holding r
14d20 65 74 75 72 6e 20 61 64 64 72 65 73 73 20 6f 66 eturn address of
14d30 20 61 64 64 72 46 69 6c 6c 53 75 62 20 2a 2f 0a addrFillSub */.
14d40 20 20 20 20 75 38 20 6a 6f 69 6e 74 79 70 65 3b u8 jointype;
14d50 20 20 20 20 20 20 2f 2a 20 54 79 70 65 20 6f 66 /* Type of
14d60 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e 20 74 68 join between th
14d70 69 73 20 61 62 6c 65 20 61 6e 64 20 74 68 65 20 is able and the
14d80 70 72 65 76 69 6f 75 73 20 2a 2f 0a 20 20 20 20 previous */.
14d90 75 6e 73 69 67 6e 65 64 20 6e 6f 74 49 6e 64 65 unsigned notInde
14da0 78 65 64 20 3a 31 3b 20 20 20 20 2f 2a 20 54 72 xed :1; /* Tr
14db0 75 65 20 69 66 20 74 68 65 72 65 20 69 73 20 61 ue if there is a
14dc0 20 4e 4f 54 20 49 4e 44 45 58 45 44 20 63 6c 61 NOT INDEXED cla
14dd0 75 73 65 20 2a 2f 0a 20 20 20 20 75 6e 73 69 67 use */. unsig
14de0 6e 65 64 20 69 73 43 6f 72 72 65 6c 61 74 65 64 ned isCorrelated
14df0 20 3a 31 3b 20 20 2f 2a 20 54 72 75 65 20 69 66 :1; /* True if
14e00 20 73 75 62 2d 71 75 65 72 79 20 69 73 20 63 6f sub-query is co
14e10 72 72 65 6c 61 74 65 64 20 2a 2f 0a 20 20 20 20 rrelated */.
14e20 75 6e 73 69 67 6e 65 64 20 76 69 61 43 6f 72 6f unsigned viaCoro
14e30 75 74 69 6e 65 20 3a 31 3b 20 20 2f 2a 20 49 6d utine :1; /* Im
14e40 70 6c 65 6d 65 6e 74 65 64 20 61 73 20 61 20 63 plemented as a c
14e50 6f 2d 72 6f 75 74 69 6e 65 20 2a 2f 0a 23 69 66 o-routine */.#if
14e60 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
14e70 5f 45 58 50 4c 41 49 4e 0a 20 20 20 20 75 38 20 _EXPLAIN. u8
14e80 69 53 65 6c 65 63 74 49 64 3b 20 20 20 20 20 2f iSelectId; /
14e90 2a 20 49 66 20 70 53 65 6c 65 63 74 21 3d 30 2c * If pSelect!=0,
14ea0 20 74 68 65 20 69 64 20 6f 66 20 74 68 65 20 73 the id of the s
14eb0 75 62 2d 73 65 6c 65 63 74 20 69 6e 20 45 51 50 ub-select in EQP
14ec0 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 */.#endif. i
14ed0 6e 74 20 69 43 75 72 73 6f 72 3b 20 20 20 20 20 nt iCursor;
14ee0 20 2f 2a 20 54 68 65 20 56 44 42 45 20 63 75 72 /* The VDBE cur
14ef0 73 6f 72 20 6e 75 6d 62 65 72 20 75 73 65 64 20 sor number used
14f00 74 6f 20 61 63 63 65 73 73 20 74 68 69 73 20 74 to access this t
14f10 61 62 6c 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 able */. Expr
14f20 20 2a 70 4f 6e 3b 20 20 20 20 20 20 20 20 2f 2a *pOn; /*
14f30 20 54 68 65 20 4f 4e 20 63 6c 61 75 73 65 20 6f The ON clause o
14f40 66 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 f a join */.
14f50 49 64 4c 69 73 74 20 2a 70 55 73 69 6e 67 3b 20 IdList *pUsing;
14f60 20 20 2f 2a 20 54 68 65 20 55 53 49 4e 47 20 63 /* The USING c
14f70 6c 61 75 73 65 20 6f 66 20 61 20 6a 6f 69 6e 20 lause of a join
14f80 2a 2f 0a 20 20 20 20 42 69 74 6d 61 73 6b 20 63 */. Bitmask c
14f90 6f 6c 55 73 65 64 3b 20 20 2f 2a 20 42 69 74 20 olUsed; /* Bit
14fa0 4e 20 28 31 3c 3c 4e 29 20 73 65 74 20 69 66 20 N (1<<N) set if
14fb0 63 6f 6c 75 6d 6e 20 4e 20 6f 66 20 70 54 61 62 column N of pTab
14fc0 20 69 73 20 75 73 65 64 20 2a 2f 0a 20 20 20 20 is used */.
14fd0 63 68 61 72 20 2a 7a 49 6e 64 65 78 3b 20 20 20 char *zIndex;
14fe0 20 20 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 20 /* Identifier
14ff0 66 72 6f 6d 20 22 49 4e 44 45 58 45 44 20 42 59 from "INDEXED BY
15000 20 3c 7a 49 6e 64 65 78 3e 22 20 63 6c 61 75 73 <zIndex>" claus
15010 65 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20 2a e */. Index *
15020 70 49 6e 64 65 78 3b 20 20 20 20 2f 2a 20 49 6e pIndex; /* In
15030 64 65 78 20 73 74 72 75 63 74 75 72 65 20 63 6f dex structure co
15040 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 7a rresponding to z
15050 49 6e 64 65 78 2c 20 69 66 20 61 6e 79 20 2a 2f Index, if any */
15060 0a 20 20 7d 20 61 5b 31 5d 3b 20 20 20 20 20 20 . } a[1];
15070 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e /* One en
15080 74 72 79 20 66 6f 72 20 65 61 63 68 20 69 64 65 try for each ide
15090 6e 74 69 66 69 65 72 20 6f 6e 20 74 68 65 20 6c ntifier on the l
150a0 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ist */.};../*.**
150b0 20 50 65 72 6d 69 74 74 65 64 20 76 61 6c 75 65 Permitted value
150c0 73 20 6f 66 20 74 68 65 20 53 72 63 4c 69 73 74 s of the SrcList
150d0 2e 61 2e 6a 6f 69 6e 74 79 70 65 20 66 69 65 6c .a.jointype fiel
150e0 64 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f d.*/.#define JT_
150f0 49 4e 4e 45 52 20 20 20 20 20 30 78 30 30 30 31 INNER 0x0001
15100 20 20 20 20 2f 2a 20 41 6e 79 20 6b 69 6e 64 20 /* Any kind
15110 6f 66 20 69 6e 6e 65 72 20 6f 72 20 63 72 6f 73 of inner or cros
15120 73 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e s join */.#defin
15130 65 20 4a 54 5f 43 52 4f 53 53 20 20 20 20 20 30 e JT_CROSS 0
15140 78 30 30 30 32 20 20 20 20 2f 2a 20 45 78 70 6c x0002 /* Expl
15150 69 63 69 74 20 75 73 65 20 6f 66 20 74 68 65 20 icit use of the
15160 43 52 4f 53 53 20 6b 65 79 77 6f 72 64 20 2a 2f CROSS keyword */
15170 0a 23 64 65 66 69 6e 65 20 4a 54 5f 4e 41 54 55 .#define JT_NATU
15180 52 41 4c 20 20 20 30 78 30 30 30 34 20 20 20 20 RAL 0x0004
15190 2f 2a 20 54 72 75 65 20 66 6f 72 20 61 20 22 6e /* True for a "n
151a0 61 74 75 72 61 6c 22 20 6a 6f 69 6e 20 2a 2f 0a atural" join */.
151b0 23 64 65 66 69 6e 65 20 4a 54 5f 4c 45 46 54 20 #define JT_LEFT
151c0 20 20 20 20 20 30 78 30 30 30 38 20 20 20 20 2f 0x0008 /
151d0 2a 20 4c 65 66 74 20 6f 75 74 65 72 20 6a 6f 69 * Left outer joi
151e0 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f n */.#define JT_
151f0 52 49 47 48 54 20 20 20 20 20 30 78 30 30 31 30 RIGHT 0x0010
15200 20 20 20 20 2f 2a 20 52 69 67 68 74 20 6f 75 74 /* Right out
15210 65 72 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 er join */.#defi
15220 6e 65 20 4a 54 5f 4f 55 54 45 52 20 20 20 20 20 ne JT_OUTER
15230 30 78 30 30 32 30 20 20 20 20 2f 2a 20 54 68 65 0x0020 /* The
15240 20 22 4f 55 54 45 52 22 20 6b 65 79 77 6f 72 64 "OUTER" keyword
15250 20 69 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 23 is present */.#
15260 64 65 66 69 6e 65 20 4a 54 5f 45 52 52 4f 52 20 define JT_ERROR
15270 20 20 20 20 30 78 30 30 34 30 20 20 20 20 2f 2a 0x0040 /*
15280 20 75 6e 6b 6e 6f 77 6e 20 6f 72 20 75 6e 73 75 unknown or unsu
15290 70 70 6f 72 74 65 64 20 6a 6f 69 6e 20 74 79 70 pported join typ
152a0 65 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6c 61 e */.../*.** Fla
152b0 67 73 20 61 70 70 72 6f 70 72 69 61 74 65 20 66 gs appropriate f
152c0 6f 72 20 74 68 65 20 77 63 74 72 6c 46 6c 61 67 or the wctrlFlag
152d0 73 20 70 61 72 61 6d 65 74 65 72 20 6f 66 20 73 s parameter of s
152e0 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 69 6e qlite3WhereBegin
152f0 28 29 0a 2a 2a 20 61 6e 64 20 74 68 65 20 57 68 ().** and the Wh
15300 65 72 65 49 6e 66 6f 2e 77 63 74 72 6c 46 6c 61 ereInfo.wctrlFla
15310 67 73 20 6d 65 6d 62 65 72 2e 0a 2a 2f 0a 23 64 gs member..*/.#d
15320 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 45 efine WHERE_ORDE
15330 52 42 59 5f 4e 4f 52 4d 41 4c 20 20 20 30 78 30 RBY_NORMAL 0x0
15340 30 30 30 20 2f 2a 20 4e 6f 2d 6f 70 20 2a 2f 0a 000 /* No-op */.
15350 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 #define WHERE_OR
15360 44 45 52 42 59 5f 4d 49 4e 20 20 20 20 20 20 30 DERBY_MIN 0
15370 78 30 30 30 31 20 2f 2a 20 4f 52 44 45 52 20 42 x0001 /* ORDER B
15380 59 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 Y processing for
15390 20 6d 69 6e 28 29 20 66 75 6e 63 20 2a 2f 0a 23 min() func */.#
153a0 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 define WHERE_ORD
153b0 45 52 42 59 5f 4d 41 58 20 20 20 20 20 20 30 78 ERBY_MAX 0x
153c0 30 30 30 32 20 2f 2a 20 4f 52 44 45 52 20 42 59 0002 /* ORDER BY
153d0 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 processing for
153e0 6d 61 78 28 29 20 66 75 6e 63 20 2a 2f 0a 23 64 max() func */.#d
153f0 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e 45 50 efine WHERE_ONEP
15400 41 53 53 5f 44 45 53 49 52 45 44 20 20 30 78 30 ASS_DESIRED 0x0
15410 30 30 34 20 2f 2a 20 57 61 6e 74 20 74 6f 20 64 004 /* Want to d
15420 6f 20 6f 6e 65 2d 70 61 73 73 20 55 50 44 41 54 o one-pass UPDAT
15430 45 2f 44 45 4c 45 54 45 20 2a 2f 0a 23 64 65 66 E/DELETE */.#def
15440 69 6e 65 20 57 48 45 52 45 5f 44 55 50 4c 49 43 ine WHERE_DUPLIC
15450 41 54 45 53 5f 4f 4b 20 20 20 20 30 78 30 30 30 ATES_OK 0x000
15460 38 20 2f 2a 20 4f 6b 20 74 6f 20 72 65 74 75 72 8 /* Ok to retur
15470 6e 20 61 20 72 6f 77 20 6d 6f 72 65 20 74 68 61 n a row more tha
15480 6e 20 6f 6e 63 65 20 2a 2f 0a 23 64 65 66 69 6e n once */.#defin
15490 65 20 57 48 45 52 45 5f 4f 4d 49 54 5f 4f 50 45 e WHERE_OMIT_OPE
154a0 4e 5f 43 4c 4f 53 45 20 20 30 78 30 30 31 30 20 N_CLOSE 0x0010
154b0 2f 2a 20 54 61 62 6c 65 20 63 75 72 73 6f 72 73 /* Table cursors
154c0 20 61 72 65 20 61 6c 72 65 61 64 79 20 6f 70 65 are already ope
154d0 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 n */.#define WHE
154e0 52 45 5f 46 4f 52 43 45 5f 54 41 42 4c 45 20 20 RE_FORCE_TABLE
154f0 20 20 20 20 30 78 30 30 32 30 20 2f 2a 20 44 6f 0x0020 /* Do
15500 20 6e 6f 74 20 75 73 65 20 61 6e 20 69 6e 64 65 not use an inde
15510 78 2d 6f 6e 6c 79 20 73 65 61 72 63 68 20 2a 2f x-only search */
15520 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f .#define WHERE_O
15530 4e 45 54 41 42 4c 45 5f 4f 4e 4c 59 20 20 20 20 NETABLE_ONLY
15540 30 78 30 30 34 30 20 2f 2a 20 4f 6e 6c 79 20 63 0x0040 /* Only c
15550 6f 64 65 20 74 68 65 20 31 73 74 20 74 61 62 6c ode the 1st tabl
15560 65 20 69 6e 20 70 54 61 62 4c 69 73 74 20 2a 2f e in pTabList */
15570 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 41 .#define WHERE_A
15580 4e 44 5f 4f 4e 4c 59 20 20 20 20 20 20 20 20 20 ND_ONLY
15590 30 78 30 30 38 30 20 2f 2a 20 44 6f 6e 27 74 20 0x0080 /* Don't
155a0 75 73 65 20 69 6e 64 69 63 65 73 20 66 6f 72 20 use indices for
155b0 4f 52 20 74 65 72 6d 73 20 2a 2f 0a 23 64 65 66 OR terms */.#def
155c0 69 6e 65 20 57 48 45 52 45 5f 47 52 4f 55 50 42 ine WHERE_GROUPB
155d0 59 20 20 20 20 20 20 20 20 20 20 30 78 30 31 30 Y 0x010
155e0 30 20 2f 2a 20 70 4f 72 64 65 72 42 79 20 69 73 0 /* pOrderBy is
155f0 20 72 65 61 6c 6c 79 20 61 20 47 52 4f 55 50 20 really a GROUP
15600 42 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 BY */.#define WH
15610 45 52 45 5f 44 49 53 54 49 4e 43 54 42 59 20 20 ERE_DISTINCTBY
15620 20 20 20 20 20 30 78 30 32 30 30 20 2f 2a 20 70 0x0200 /* p
15630 4f 72 64 65 72 62 79 20 69 73 20 72 65 61 6c 6c Orderby is reall
15640 79 20 61 20 44 49 53 54 49 4e 43 54 20 63 6c 61 y a DISTINCT cla
15650 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 use */.#define W
15660 48 45 52 45 5f 57 41 4e 54 5f 44 49 53 54 49 4e HERE_WANT_DISTIN
15670 43 54 20 20 20 20 30 78 30 34 30 30 20 2f 2a 20 CT 0x0400 /*
15680 41 6c 6c 20 6f 75 74 70 75 74 20 6e 65 65 64 73 All output needs
15690 20 74 6f 20 62 65 20 64 69 73 74 69 6e 63 74 20 to be distinct
156a0 2a 2f 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 64 20 72 */../* Allowed r
156b0 65 74 75 72 6e 20 76 61 6c 75 65 73 20 66 72 6f eturn values fro
156c0 6d 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 m sqlite3WhereIs
156d0 44 69 73 74 69 6e 63 74 28 29 0a 2a 2f 0a 23 64 Distinct().*/.#d
156e0 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 efine WHERE_DIST
156f0 49 4e 43 54 5f 4e 4f 4f 50 20 20 20 20 20 20 30 INCT_NOOP 0
15700 20 20 2f 2a 20 44 49 53 54 49 4e 43 54 20 6b 65 /* DISTINCT ke
15710 79 77 6f 72 64 20 6e 6f 74 20 75 73 65 64 20 2a yword not used *
15720 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
15730 44 49 53 54 49 4e 43 54 5f 55 4e 49 51 55 45 20 DISTINCT_UNIQUE
15740 20 20 20 31 20 20 2f 2a 20 4e 6f 20 64 75 70 6c 1 /* No dupl
15750 69 63 61 74 65 73 20 2a 2f 0a 23 64 65 66 69 6e icates */.#defin
15760 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 e WHERE_DISTINCT
15770 5f 4f 52 44 45 52 45 44 20 20 20 32 20 20 2f 2a _ORDERED 2 /*
15780 20 41 6c 6c 20 64 75 70 6c 69 63 61 74 65 73 20 All duplicates
15790 61 72 65 20 61 64 6a 61 63 65 6e 74 20 2a 2f 0a are adjacent */.
157a0 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 44 49 #define WHERE_DI
157b0 53 54 49 4e 43 54 5f 55 4e 4f 52 44 45 52 45 44 STINCT_UNORDERED
157c0 20 33 20 20 2f 2a 20 44 75 70 6c 69 63 61 74 65 3 /* Duplicate
157d0 73 20 61 72 65 20 73 63 61 74 74 65 72 65 64 20 s are scattered
157e0 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 4e 61 6d 65 */../*.** A Name
157f0 43 6f 6e 74 65 78 74 20 64 65 66 69 6e 65 73 20 Context defines
15800 61 20 63 6f 6e 74 65 78 74 20 69 6e 20 77 68 69 a context in whi
15810 63 68 20 74 6f 20 72 65 73 6f 6c 76 65 20 74 61 ch to resolve ta
15820 62 6c 65 20 61 6e 64 20 63 6f 6c 75 6d 6e 0a 2a ble and column.*
15830 2a 20 6e 61 6d 65 73 2e 20 20 54 68 65 20 63 6f * names. The co
15840 6e 74 65 78 74 20 63 6f 6e 73 69 73 74 73 20 6f ntext consists o
15850 66 20 61 20 6c 69 73 74 20 6f 66 20 74 61 62 6c f a list of tabl
15860 65 73 20 28 74 68 65 20 70 53 72 63 4c 69 73 74 es (the pSrcList
15870 29 20 66 69 65 6c 64 20 61 6e 64 0a 2a 2a 20 61 ) field and.** a
15880 20 6c 69 73 74 20 6f 66 20 6e 61 6d 65 64 20 65 list of named e
15890 78 70 72 65 73 73 69 6f 6e 20 28 70 45 4c 69 73 xpression (pELis
158a0 74 29 2e 20 20 54 68 65 20 6e 61 6d 65 64 20 65 t). The named e
158b0 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 20 6d xpression list m
158c0 61 79 0a 2a 2a 20 62 65 20 4e 55 4c 4c 2e 20 20 ay.** be NULL.
158d0 54 68 65 20 70 53 72 63 20 63 6f 72 72 65 73 70 The pSrc corresp
158e0 6f 6e 64 73 20 74 6f 20 74 68 65 20 46 52 4f 4d onds to the FROM
158f0 20 63 6c 61 75 73 65 20 6f 66 20 61 20 53 45 4c clause of a SEL
15900 45 43 54 20 6f 72 0a 2a 2a 20 74 6f 20 74 68 65 ECT or.** to the
15910 20 74 61 62 6c 65 20 62 65 69 6e 67 20 6f 70 65 table being ope
15920 72 61 74 65 64 20 6f 6e 20 62 79 20 49 4e 53 45 rated on by INSE
15930 52 54 2c 20 55 50 44 41 54 45 2c 20 6f 72 20 44 RT, UPDATE, or D
15940 45 4c 45 54 45 2e 20 20 54 68 65 0a 2a 2a 20 70 ELETE. The.** p
15950 45 4c 69 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 EList correspond
15960 73 20 74 6f 20 74 68 65 20 72 65 73 75 6c 74 20 s to the result
15970 73 65 74 20 6f 66 20 61 20 53 45 4c 45 43 54 20 set of a SELECT
15980 61 6e 64 20 69 73 20 4e 55 4c 4c 20 66 6f 72 0a and is NULL for.
15990 2a 2a 20 6f 74 68 65 72 20 73 74 61 74 65 6d 65 ** other stateme
159a0 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 4e 61 6d 65 43 nts..**.** NameC
159b0 6f 6e 74 65 78 74 73 20 63 61 6e 20 62 65 20 6e ontexts can be n
159c0 65 73 74 65 64 2e 20 20 57 68 65 6e 20 72 65 73 ested. When res
159d0 6f 6c 76 69 6e 67 20 6e 61 6d 65 73 2c 20 74 68 olving names, th
159e0 65 20 69 6e 6e 65 72 2d 6d 6f 73 74 20 0a 2a 2a e inner-most .**
159f0 20 63 6f 6e 74 65 78 74 20 69 73 20 73 65 61 72 context is sear
15a00 63 68 65 64 20 66 69 72 73 74 2e 20 20 49 66 20 ched first. If
15a10 6e 6f 20 6d 61 74 63 68 20 69 73 20 66 6f 75 6e no match is foun
15a20 64 2c 20 74 68 65 20 6e 65 78 74 20 6f 75 74 65 d, the next oute
15a30 72 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 69 73 20 r.** context is
15a40 63 68 65 63 6b 65 64 2e 20 20 49 66 20 74 68 65 checked. If the
15a50 72 65 20 69 73 20 73 74 69 6c 6c 20 6e 6f 20 6d re is still no m
15a60 61 74 63 68 2c 20 74 68 65 20 6e 65 78 74 20 63 atch, the next c
15a70 6f 6e 74 65 78 74 0a 2a 2a 20 69 73 20 63 68 65 ontext.** is che
15a80 63 6b 65 64 2e 20 20 54 68 69 73 20 70 72 6f 63 cked. This proc
15a90 65 73 73 20 63 6f 6e 74 69 6e 75 65 73 20 75 6e ess continues un
15aa0 74 69 6c 20 65 69 74 68 65 72 20 61 20 6d 61 74 til either a mat
15ab0 63 68 20 69 73 20 66 6f 75 6e 64 0a 2a 2a 20 6f ch is found.** o
15ac0 72 20 61 6c 6c 20 63 6f 6e 74 65 78 74 73 20 61 r all contexts a
15ad0 72 65 20 63 68 65 63 6b 2e 20 20 57 68 65 6e 20 re check. When
15ae0 61 20 6d 61 74 63 68 20 69 73 20 66 6f 75 6e 64 a match is found
15af0 2c 20 74 68 65 20 6e 52 65 66 20 6d 65 6d 62 65 , the nRef membe
15b00 72 20 6f 66 0a 2a 2a 20 74 68 65 20 63 6f 6e 74 r of.** the cont
15b10 65 78 74 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ext containing t
15b20 68 65 20 6d 61 74 63 68 20 69 73 20 69 6e 63 72 he match is incr
15b30 65 6d 65 6e 74 65 64 2e 20 0a 2a 2a 0a 2a 2a 20 emented. .**.**
15b40 45 61 63 68 20 73 75 62 71 75 65 72 79 20 67 65 Each subquery ge
15b50 74 73 20 61 20 6e 65 77 20 4e 61 6d 65 43 6f 6e ts a new NameCon
15b60 74 65 78 74 2e 20 20 54 68 65 20 70 4e 65 78 74 text. The pNext
15b70 20 66 69 65 6c 64 20 70 6f 69 6e 74 73 20 74 6f field points to
15b80 20 74 68 65 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 the.** NameCont
15b90 65 78 74 20 69 6e 20 74 68 65 20 70 61 72 65 6e ext in the paren
15ba0 74 20 71 75 65 72 79 2e 20 20 54 68 75 73 20 74 t query. Thus t
15bb0 68 65 20 70 72 6f 63 65 73 73 20 6f 66 20 73 63 he process of sc
15bc0 61 6e 6e 69 6e 67 20 74 68 65 0a 2a 2a 20 4e 61 anning the.** Na
15bd0 6d 65 43 6f 6e 74 65 78 74 20 6c 69 73 74 20 63 meContext list c
15be0 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 73 65 orresponds to se
15bf0 61 72 63 68 69 6e 67 20 74 68 72 6f 75 67 68 20 arching through
15c00 73 75 63 63 65 73 73 69 76 65 6c 79 20 6f 75 74 successively out
15c10 65 72 0a 2a 2a 20 73 75 62 71 75 65 72 69 65 73 er.** subqueries
15c20 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 61 20 6d looking for a m
15c30 61 74 63 68 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 atch..*/.struct
15c40 4e 61 6d 65 43 6f 6e 74 65 78 74 20 7b 0a 20 20 NameContext {.
15c50 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 Parse *pParse;
15c60 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 72 73 /* The pars
15c70 65 72 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 er */. SrcList
15c80 2a 70 53 72 63 4c 69 73 74 3b 20 20 20 2f 2a 20 *pSrcList; /*
15c90 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 74 61 62 6c One or more tabl
15ca0 65 73 20 75 73 65 64 20 74 6f 20 72 65 73 6f 6c es used to resol
15cb0 76 65 20 6e 61 6d 65 73 20 2a 2f 0a 20 20 45 78 ve names */. Ex
15cc0 70 72 4c 69 73 74 20 2a 70 45 4c 69 73 74 3b 20 prList *pEList;
15cd0 20 20 20 2f 2a 20 4f 70 74 69 6f 6e 61 6c 20 6c /* Optional l
15ce0 69 73 74 20 6f 66 20 72 65 73 75 6c 74 2d 73 65 ist of result-se
15cf0 74 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 41 t columns */. A
15d00 67 67 49 6e 66 6f 20 2a 70 41 67 67 49 6e 66 6f ggInfo *pAggInfo
15d10 3b 20 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 ; /* Informati
15d20 6f 6e 20 61 62 6f 75 74 20 61 67 67 72 65 67 61 on about aggrega
15d30 74 65 73 20 61 74 20 74 68 69 73 20 6c 65 76 65 tes at this leve
15d40 6c 20 2a 2f 0a 20 20 4e 61 6d 65 43 6f 6e 74 65 l */. NameConte
15d50 78 74 20 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e xt *pNext; /* N
15d60 65 78 74 20 6f 75 74 65 72 20 6e 61 6d 65 20 63 ext outer name c
15d70 6f 6e 74 65 78 74 2e 20 20 4e 55 4c 4c 20 66 6f ontext. NULL fo
15d80 72 20 6f 75 74 65 72 6d 6f 73 74 20 2a 2f 0a 20 r outermost */.
15d90 20 69 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 int nRef;
15da0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
15db0 6f 66 20 6e 61 6d 65 73 20 72 65 73 6f 6c 76 65 of names resolve
15dc0 64 20 62 79 20 74 68 69 73 20 63 6f 6e 74 65 78 d by this contex
15dd0 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 72 72 3b t */. int nErr;
15de0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
15df0 75 6d 62 65 72 20 6f 66 20 65 72 72 6f 72 73 20 umber of errors
15e00 65 6e 63 6f 75 6e 74 65 72 65 64 20 77 68 69 6c encountered whil
15e10 65 20 72 65 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 e resolving name
15e20 73 20 2a 2f 0a 20 20 75 38 20 6e 63 46 6c 61 67 s */. u8 ncFlag
15e30 73 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 5a s; /* Z
15e40 65 72 6f 20 6f 72 20 6d 6f 72 65 20 4e 43 5f 2a ero or more NC_*
15e50 20 66 6c 61 67 73 20 64 65 66 69 6e 65 64 20 62 flags defined b
15e60 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a elow */.};../*.*
15e70 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 * Allowed values
15e80 20 66 6f 72 20 74 68 65 20 4e 61 6d 65 43 6f 6e for the NameCon
15e90 74 65 78 74 2c 20 6e 63 46 6c 61 67 73 20 66 69 text, ncFlags fi
15ea0 65 6c 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 eld..*/.#define
15eb0 4e 43 5f 41 6c 6c 6f 77 41 67 67 20 20 30 78 30 NC_AllowAgg 0x0
15ec0 31 20 20 20 20 2f 2a 20 41 67 67 72 65 67 61 74 1 /* Aggregat
15ed0 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 e functions are
15ee0 61 6c 6c 6f 77 65 64 20 68 65 72 65 20 2a 2f 0a allowed here */.
15ef0 23 64 65 66 69 6e 65 20 4e 43 5f 48 61 73 41 67 #define NC_HasAg
15f00 67 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 20 g 0x02 /*
15f10 4f 6e 65 20 6f 72 20 6d 6f 72 65 20 61 67 67 72 One or more aggr
15f20 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 egate functions
15f30 73 65 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 seen */.#define
15f40 4e 43 5f 49 73 43 68 65 63 6b 20 20 20 30 78 30 NC_IsCheck 0x0
15f50 34 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 4 /* True if
15f60 72 65 73 6f 6c 76 69 6e 67 20 6e 61 6d 65 73 20 resolving names
15f70 69 6e 20 61 20 43 48 45 43 4b 20 63 6f 6e 73 74 in a CHECK const
15f80 72 61 69 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 raint */.#define
15f90 20 4e 43 5f 49 6e 41 67 67 46 75 6e 63 20 30 78 NC_InAggFunc 0x
15fa0 30 38 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 08 /* True if
15fb0 20 61 6e 61 6c 79 7a 69 6e 67 20 61 72 67 75 6d analyzing argum
15fc0 65 6e 74 73 20 74 6f 20 61 6e 20 61 67 67 20 66 ents to an agg f
15fd0 75 6e 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e unc */.#define N
15fe0 43 5f 50 61 72 74 49 64 78 20 20 20 30 78 31 30 C_PartIdx 0x10
15ff0 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 /* True if r
16000 65 73 6f 6c 76 69 6e 67 20 61 20 70 61 72 74 69 esolving a parti
16010 61 6c 20 69 6e 64 65 78 20 57 48 45 52 45 20 2a al index WHERE *
16020 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 /../*.** An inst
16030 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
16040 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
16050 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 69 6e 66 contains all inf
16060 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 6e 65 65 64 ormation.** need
16070 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 63 ed to generate c
16080 6f 64 65 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 ode for a single
16090 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
160a0 74 2e 0a 2a 2a 0a 2a 2a 20 6e 4c 69 6d 69 74 20 t..**.** nLimit
160b0 69 73 20 73 65 74 20 74 6f 20 2d 31 20 69 66 20 is set to -1 if
160c0 74 68 65 72 65 20 69 73 20 6e 6f 20 4c 49 4d 49 there is no LIMI
160d0 54 20 63 6c 61 75 73 65 2e 20 20 6e 4f 66 66 73 T clause. nOffs
160e0 65 74 20 69 73 20 73 65 74 20 74 6f 20 30 2e 0a et is set to 0..
160f0 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 61 ** If there is a
16100 20 4c 49 4d 49 54 20 63 6c 61 75 73 65 2c 20 74 LIMIT clause, t
16110 68 65 20 70 61 72 73 65 72 20 73 65 74 73 20 6e he parser sets n
16120 4c 69 6d 69 74 20 74 6f 20 74 68 65 20 76 61 6c Limit to the val
16130 75 65 20 6f 66 20 74 68 65 0a 2a 2a 20 6c 69 6d ue of the.** lim
16140 69 74 20 61 6e 64 20 6e 4f 66 66 73 65 74 20 74 it and nOffset t
16150 6f 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 o the value of t
16160 68 65 20 6f 66 66 73 65 74 20 28 6f 72 20 30 20 he offset (or 0
16170 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f 74 0a if there is not.
16180 2a 2a 20 6f 66 66 73 65 74 29 2e 20 20 42 75 74 ** offset). But
16190 20 6c 61 74 65 72 20 6f 6e 2c 20 6e 4c 69 6d 69 later on, nLimi
161a0 74 20 61 6e 64 20 6e 4f 66 66 73 65 74 20 62 65 t and nOffset be
161b0 63 6f 6d 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 come the memory
161c0 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 20 69 6e 20 locations.** in
161d0 74 68 65 20 56 44 42 45 20 74 68 61 74 20 72 65 the VDBE that re
161e0 63 6f 72 64 20 74 68 65 20 6c 69 6d 69 74 20 61 cord the limit a
161f0 6e 64 20 6f 66 66 73 65 74 20 63 6f 75 6e 74 65 nd offset counte
16200 72 73 2e 0a 2a 2a 0a 2a 2a 20 61 64 64 72 4f 70 rs..**.** addrOp
16210 65 6e 45 70 68 6d 5b 5d 20 65 6e 74 72 69 65 73 enEphm[] entries
16220 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 61 64 64 contain the add
16230 72 65 73 73 20 6f 66 20 4f 50 5f 4f 70 65 6e 45 ress of OP_OpenE
16240 70 68 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 73 phemeral opcodes
16250 2e 0a 2a 2a 20 54 68 65 73 65 20 61 64 64 72 65 ..** These addre
16260 73 73 65 73 20 6d 75 73 74 20 62 65 20 73 74 6f sses must be sto
16270 72 65 64 20 73 6f 20 74 68 61 74 20 77 65 20 63 red so that we c
16280 61 6e 20 67 6f 20 62 61 63 6b 20 61 6e 64 20 66 an go back and f
16290 69 6c 6c 20 69 6e 0a 2a 2a 20 74 68 65 20 50 34 ill in.** the P4
162a0 5f 4b 45 59 49 4e 46 4f 20 61 6e 64 20 50 32 20 _KEYINFO and P2
162b0 70 61 72 61 6d 65 74 65 72 73 20 6c 61 74 65 72 parameters later
162c0 2e 20 20 4e 65 69 74 68 65 72 20 74 68 65 20 4b . Neither the K
162d0 65 79 49 6e 66 6f 20 6e 6f 72 0a 2a 2a 20 74 68 eyInfo nor.** th
162e0 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 e number of colu
162f0 6d 6e 73 20 69 6e 20 50 32 20 63 61 6e 20 62 65 mns in P2 can be
16300 20 63 6f 6d 70 75 74 65 64 20 61 74 20 74 68 65 computed at the
16310 20 73 61 6d 65 20 74 69 6d 65 0a 2a 2a 20 61 73 same time.** as
16320 20 74 68 65 20 4f 50 5f 4f 70 65 6e 45 70 68 6d the OP_OpenEphm
16330 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73 20 instruction is
16340 63 6f 64 65 64 20 62 65 63 61 75 73 65 20 6e 6f coded because no
16350 74 0a 2a 2a 20 65 6e 6f 75 67 68 20 69 6e 66 6f t.** enough info
16360 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 rmation about th
16370 65 20 63 6f 6d 70 6f 75 6e 64 20 71 75 65 72 79 e compound query
16380 20 69 73 20 6b 6e 6f 77 6e 20 61 74 20 74 68 61 is known at tha
16390 74 20 70 6f 69 6e 74 2e 0a 2a 2a 20 54 68 65 20 t point..** The
163a0 4b 65 79 49 6e 66 6f 20 66 6f 72 20 61 64 64 72 KeyInfo for addr
163b0 4f 70 65 6e 54 72 61 6e 5b 30 5d 20 61 6e 64 20 OpenTran[0] and
163c0 5b 31 5d 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6c [1] contains col
163d0 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 lating sequences
163e0 0a 2a 2a 20 66 6f 72 20 74 68 65 20 72 65 73 75 .** for the resu
163f0 6c 74 20 73 65 74 2e 20 20 54 68 65 20 4b 65 79 lt set. The Key
16400 49 6e 66 6f 20 66 6f 72 20 61 64 64 72 4f 70 65 Info for addrOpe
16410 6e 45 70 68 6d 5b 32 5d 20 63 6f 6e 74 61 69 6e nEphm[2] contain
16420 73 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73 s collating.** s
16430 65 71 75 65 6e 63 65 73 20 66 6f 72 20 74 68 65 equences for the
16440 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 ORDER BY clause
16450 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 65 6c 65 ..*/.struct Sele
16460 63 74 20 7b 0a 20 20 45 78 70 72 4c 69 73 74 20 ct {. ExprList
16470 2a 70 45 4c 69 73 74 3b 20 20 20 20 20 20 2f 2a *pEList; /*
16480 20 54 68 65 20 66 69 65 6c 64 73 20 6f 66 20 74 The fields of t
16490 68 65 20 72 65 73 75 6c 74 20 2a 2f 0a 20 20 75 he result */. u
164a0 38 20 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 8 op;
164b0 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 3a /* One of:
164c0 20 54 4b 5f 55 4e 49 4f 4e 20 54 4b 5f 41 4c 4c TK_UNION TK_ALL
164d0 20 54 4b 5f 49 4e 54 45 52 53 45 43 54 20 54 4b TK_INTERSECT TK
164e0 5f 45 58 43 45 50 54 20 2a 2f 0a 20 20 75 31 36 _EXCEPT */. u16
164f0 20 73 65 6c 46 6c 61 67 73 3b 20 20 20 20 20 20 selFlags;
16500 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 53 /* Various S
16510 46 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 F_* values */.
16520 69 6e 74 20 69 4c 69 6d 69 74 2c 20 69 4f 66 66 int iLimit, iOff
16530 73 65 74 3b 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 set; /* Memory
16540 20 72 65 67 69 73 74 65 72 73 20 68 6f 6c 64 69 registers holdi
16550 6e 67 20 4c 49 4d 49 54 20 26 20 4f 46 46 53 45 ng LIMIT & OFFSE
16560 54 20 63 6f 75 6e 74 65 72 73 20 2a 2f 0a 20 20 T counters */.
16570 69 6e 74 20 61 64 64 72 4f 70 65 6e 45 70 68 6d int addrOpenEphm
16580 5b 33 5d 3b 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 [3]; /* OP_Ope
16590 6e 45 70 68 65 6d 20 6f 70 63 6f 64 65 73 20 72 nEphem opcodes r
165a0 65 6c 61 74 65 64 20 74 6f 20 74 68 69 73 20 73 elated to this s
165b0 65 6c 65 63 74 20 2a 2f 0a 20 20 75 36 34 20 6e elect */. u64 n
165c0 53 65 6c 65 63 74 52 6f 77 3b 20 20 20 20 20 20 SelectRow;
165d0 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 20 6e /* Estimated n
165e0 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20 umber of result
165f0 72 6f 77 73 20 2a 2f 0a 20 20 53 72 63 4c 69 73 rows */. SrcLis
16600 74 20 2a 70 53 72 63 3b 20 20 20 20 20 20 20 20 t *pSrc;
16610 20 2f 2a 20 54 68 65 20 46 52 4f 4d 20 63 6c 61 /* The FROM cla
16620 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 use */. Expr *p
16630 57 68 65 72 65 3b 20 20 20 20 20 20 20 20 20 20 Where;
16640 2f 2a 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 /* The WHERE cla
16650 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 use */. ExprLis
16660 74 20 2a 70 47 72 6f 75 70 42 79 3b 20 20 20 20 t *pGroupBy;
16670 2f 2a 20 54 68 65 20 47 52 4f 55 50 20 42 59 20 /* The GROUP BY
16680 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 clause */. Expr
16690 20 2a 70 48 61 76 69 6e 67 3b 20 20 20 20 20 20 *pHaving;
166a0 20 20 20 2f 2a 20 54 68 65 20 48 41 56 49 4e 47 /* The HAVING
166b0 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 78 70 clause */. Exp
166c0 72 4c 69 73 74 20 2a 70 4f 72 64 65 72 42 79 3b rList *pOrderBy;
166d0 20 20 20 20 2f 2a 20 54 68 65 20 4f 52 44 45 52 /* The ORDER
166e0 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 BY clause */.
166f0 53 65 6c 65 63 74 20 2a 70 50 72 69 6f 72 3b 20 Select *pPrior;
16700 20 20 20 20 20 20 20 2f 2a 20 50 72 69 6f 72 20 /* Prior
16710 73 65 6c 65 63 74 20 69 6e 20 61 20 63 6f 6d 70 select in a comp
16720 6f 75 6e 64 20 73 65 6c 65 63 74 20 73 74 61 74 ound select stat
16730 65 6d 65 6e 74 20 2a 2f 0a 20 20 53 65 6c 65 63 ement */. Selec
16740 74 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 t *pNext;
16750 20 20 2f 2a 20 4e 65 78 74 20 73 65 6c 65 63 74 /* Next select
16760 20 74 6f 20 74 68 65 20 6c 65 66 74 20 69 6e 20 to the left in
16770 61 20 63 6f 6d 70 6f 75 6e 64 20 2a 2f 0a 20 20 a compound */.
16780 53 65 6c 65 63 74 20 2a 70 52 69 67 68 74 6d 6f Select *pRightmo
16790 73 74 3b 20 20 20 20 2f 2a 20 52 69 67 68 74 2d st; /* Right-
167a0 6d 6f 73 74 20 73 65 6c 65 63 74 20 69 6e 20 61 most select in a
167b0 20 63 6f 6d 70 6f 75 6e 64 20 73 65 6c 65 63 74 compound select
167c0 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 statement */.
167d0 45 78 70 72 20 2a 70 4c 69 6d 69 74 3b 20 20 20 Expr *pLimit;
167e0 20 20 20 20 20 20 20 2f 2a 20 4c 49 4d 49 54 20 /* LIMIT
167f0 65 78 70 72 65 73 73 69 6f 6e 2e 20 4e 55 4c 4c expression. NULL
16800 20 6d 65 61 6e 73 20 6e 6f 74 20 75 73 65 64 2e means not used.
16810 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 4f 66 66 */. Expr *pOff
16820 73 65 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 set; /*
16830 4f 46 46 53 45 54 20 65 78 70 72 65 73 73 69 6f OFFSET expressio
16840 6e 2e 20 4e 55 4c 4c 20 6d 65 61 6e 73 20 6e 6f n. NULL means no
16850 74 20 75 73 65 64 2e 20 2a 2f 0a 7d 3b 0a 0a 2f t used. */.};../
16860 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c *.** Allowed val
16870 75 65 73 20 66 6f 72 20 53 65 6c 65 63 74 2e 73 ues for Select.s
16880 65 6c 46 6c 61 67 73 2e 20 20 54 68 65 20 22 53 elFlags. The "S
16890 46 22 20 70 72 65 66 69 78 20 73 74 61 6e 64 73 F" prefix stands
168a0 20 66 6f 72 0a 2a 2a 20 22 53 65 6c 65 63 74 20 for.** "Select
168b0 46 6c 61 67 22 2e 0a 2a 2f 0a 23 64 65 66 69 6e Flag"..*/.#defin
168c0 65 20 53 46 5f 44 69 73 74 69 6e 63 74 20 20 20 e SF_Distinct
168d0 20 20 20 20 20 30 78 30 30 30 31 20 20 2f 2a 20 0x0001 /*
168e0 4f 75 74 70 75 74 20 73 68 6f 75 6c 64 20 62 65 Output should be
168f0 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 23 64 65 DISTINCT */.#de
16900 66 69 6e 65 20 53 46 5f 52 65 73 6f 6c 76 65 64 fine SF_Resolved
16910 20 20 20 20 20 20 20 20 30 78 30 30 30 32 20 20 0x0002
16920 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 73 20 68 /* Identifiers h
16930 61 76 65 20 62 65 65 6e 20 72 65 73 6f 6c 76 65 ave been resolve
16940 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f d */.#define SF_
16950 41 67 67 72 65 67 61 74 65 20 20 20 20 20 20 20 Aggregate
16960 30 78 30 30 30 34 20 20 2f 2a 20 43 6f 6e 74 61 0x0004 /* Conta
16970 69 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 75 ins aggregate fu
16980 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 nctions */.#defi
16990 6e 65 20 53 46 5f 55 73 65 73 45 70 68 65 6d 65 ne SF_UsesEpheme
169a0 72 61 6c 20 20 20 30 78 30 30 30 38 20 20 2f 2a ral 0x0008 /*
169b0 20 55 73 65 73 20 74 68 65 20 4f 70 65 6e 45 70 Uses the OpenEp
169c0 68 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 20 2a hemeral opcode *
169d0 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 45 78 70 /.#define SF_Exp
169e0 61 6e 64 65 64 20 20 20 20 20 20 20 20 30 78 30 anded 0x0
169f0 30 31 30 20 20 2f 2a 20 73 71 6c 69 74 65 33 53 010 /* sqlite3S
16a00 65 6c 65 63 74 45 78 70 61 6e 64 28 29 20 63 61 electExpand() ca
16a10 6c 6c 65 64 20 6f 6e 20 74 68 69 73 20 2a 2f 0a lled on this */.
16a20 23 64 65 66 69 6e 65 20 53 46 5f 48 61 73 54 79 #define SF_HasTy
16a30 70 65 49 6e 66 6f 20 20 20 20 20 30 78 30 30 32 peInfo 0x002
16a40 30 20 20 2f 2a 20 46 52 4f 4d 20 73 75 62 71 75 0 /* FROM subqu
16a50 65 72 69 65 73 20 68 61 76 65 20 54 61 62 6c 65 eries have Table
16a60 20 6d 65 74 61 64 61 74 61 20 2a 2f 0a 23 64 65 metadata */.#de
16a70 66 69 6e 65 20 53 46 5f 55 73 65 53 6f 72 74 65 fine SF_UseSorte
16a80 72 20 20 20 20 20 20 20 30 78 30 30 34 30 20 20 r 0x0040
16a90 2f 2a 20 53 6f 72 74 20 75 73 69 6e 67 20 61 20 /* Sort using a
16aa0 73 6f 72 74 65 72 20 2a 2f 0a 23 64 65 66 69 6e sorter */.#defin
16ab0 65 20 53 46 5f 56 61 6c 75 65 73 20 20 20 20 20 e SF_Values
16ac0 20 20 20 20 20 30 78 30 30 38 30 20 20 2f 2a 20 0x0080 /*
16ad0 53 79 6e 74 68 65 73 69 7a 65 64 20 66 72 6f 6d Synthesized from
16ae0 20 56 41 4c 55 45 53 20 63 6c 61 75 73 65 20 2a VALUES clause *
16af0 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d 61 74 /.#define SF_Mat
16b00 65 72 69 61 6c 69 7a 65 20 20 20 20 20 30 78 30 erialize 0x0
16b10 31 30 30 20 20 2f 2a 20 46 6f 72 63 65 20 6d 61 100 /* Force ma
16b20 74 65 72 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 terialization of
16b30 20 76 69 65 77 73 20 2a 2f 0a 23 64 65 66 69 6e views */.#defin
16b40 65 20 53 46 5f 4e 65 73 74 65 64 46 72 6f 6d 20 e SF_NestedFrom
16b50 20 20 20 20 20 30 78 30 32 30 30 20 20 2f 2a 20 0x0200 /*
16b60 50 61 72 74 20 6f 66 20 61 20 70 61 72 65 6e 74 Part of a parent
16b70 68 65 73 69 7a 65 64 20 46 52 4f 4d 20 63 6c 61 hesized FROM cla
16b80 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 use */.#define S
16b90 46 5f 4d 61 79 62 65 43 6f 6e 76 65 72 74 20 20 F_MaybeConvert
16ba0 20 20 30 78 30 34 30 30 20 20 2f 2a 20 4e 65 65 0x0400 /* Nee
16bb0 64 20 63 6f 6e 76 65 72 74 43 6f 6d 70 6f 75 6e d convertCompoun
16bc0 64 53 65 6c 65 63 74 54 6f 53 75 62 71 75 65 72 dSelectToSubquer
16bd0 79 28 29 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 y() */.../*.** T
16be0 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 61 20 he results of a
16bf0 73 65 6c 65 63 74 20 63 61 6e 20 62 65 20 64 69 select can be di
16c00 73 74 72 69 62 75 74 65 64 20 69 6e 20 73 65 76 stributed in sev
16c10 65 72 61 6c 20 77 61 79 73 2e 20 20 54 68 65 0a eral ways. The.
16c20 2a 2a 20 22 53 52 54 22 20 70 72 65 66 69 78 20 ** "SRT" prefix
16c30 6d 65 61 6e 73 20 22 53 45 4c 45 43 54 20 52 65 means "SELECT Re
16c40 73 75 6c 74 20 54 79 70 65 22 2e 0a 2a 2f 0a 23 sult Type"..*/.#
16c50 64 65 66 69 6e 65 20 53 52 54 5f 55 6e 69 6f 6e define SRT_Union
16c60 20 20 20 20 20 20 20 20 31 20 20 2f 2a 20 53 74 1 /* St
16c70 6f 72 65 20 72 65 73 75 6c 74 20 61 73 20 6b 65 ore result as ke
16c80 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 2a ys in an index *
16c90 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 78 /.#define SRT_Ex
16ca0 63 65 70 74 20 20 20 20 20 20 20 32 20 20 2f 2a cept 2 /*
16cb0 20 52 65 6d 6f 76 65 20 72 65 73 75 6c 74 20 66 Remove result f
16cc0 72 6f 6d 20 61 20 55 4e 49 4f 4e 20 69 6e 64 65 rom a UNION inde
16cd0 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 x */.#define SRT
16ce0 5f 45 78 69 73 74 73 20 20 20 20 20 20 20 33 20 _Exists 3
16cf0 20 2f 2a 20 53 74 6f 72 65 20 31 20 69 66 20 74 /* Store 1 if t
16d00 68 65 20 72 65 73 75 6c 74 20 69 73 20 6e 6f 74 he result is not
16d10 20 65 6d 70 74 79 20 2a 2f 0a 23 64 65 66 69 6e empty */.#defin
16d20 65 20 53 52 54 5f 44 69 73 63 61 72 64 20 20 20 e SRT_Discard
16d30 20 20 20 34 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 4 /* Do not
16d40 73 61 76 65 20 74 68 65 20 72 65 73 75 6c 74 73 save the results
16d50 20 61 6e 79 77 68 65 72 65 20 2a 2f 0a 0a 2f 2a anywhere */../*
16d60 20 54 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c The ORDER BY cl
16d70 61 75 73 65 20 69 73 20 69 67 6e 6f 72 65 64 20 ause is ignored
16d80 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 20 61 for all of the a
16d90 62 6f 76 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 bove */.#define
16da0 49 67 6e 6f 72 61 62 6c 65 4f 72 64 65 72 62 79 IgnorableOrderby
16db0 28 58 29 20 28 28 58 2d 3e 65 44 65 73 74 29 3c (X) ((X->eDest)<
16dc0 3d 53 52 54 5f 44 69 73 63 61 72 64 29 0a 0a 23 =SRT_Discard)..#
16dd0 64 65 66 69 6e 65 20 53 52 54 5f 4f 75 74 70 75 define SRT_Outpu
16de0 74 20 20 20 20 20 20 20 35 20 20 2f 2a 20 4f 75 t 5 /* Ou
16df0 74 70 75 74 20 65 61 63 68 20 72 6f 77 20 6f 66 tput each row of
16e00 20 72 65 73 75 6c 74 20 2a 2f 0a 23 64 65 66 69 result */.#defi
16e10 6e 65 20 53 52 54 5f 4d 65 6d 20 20 20 20 20 20 ne SRT_Mem
16e20 20 20 20 20 36 20 20 2f 2a 20 53 74 6f 72 65 20 6 /* Store
16e30 72 65 73 75 6c 74 20 69 6e 20 61 20 6d 65 6d 6f result in a memo
16e40 72 79 20 63 65 6c 6c 20 2a 2f 0a 23 64 65 66 69 ry cell */.#defi
16e50 6e 65 20 53 52 54 5f 53 65 74 20 20 20 20 20 20 ne SRT_Set
16e60 20 20 20 20 37 20 20 2f 2a 20 53 74 6f 72 65 20 7 /* Store
16e70 72 65 73 75 6c 74 73 20 61 73 20 6b 65 79 73 20 results as keys
16e80 69 6e 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 23 in an index */.#
16e90 64 65 66 69 6e 65 20 53 52 54 5f 54 61 62 6c 65 define SRT_Table
16ea0 20 20 20 20 20 20 20 20 38 20 20 2f 2a 20 53 74 8 /* St
16eb0 6f 72 65 20 72 65 73 75 6c 74 20 61 73 20 64 61 ore result as da
16ec0 74 61 20 77 69 74 68 20 61 6e 20 61 75 74 6f 6d ta with an autom
16ed0 61 74 69 63 20 72 6f 77 69 64 20 2a 2f 0a 23 64 atic rowid */.#d
16ee0 65 66 69 6e 65 20 53 52 54 5f 45 70 68 65 6d 54 efine SRT_EphemT
16ef0 61 62 20 20 20 20 20 39 20 20 2f 2a 20 43 72 65 ab 9 /* Cre
16f00 61 74 65 20 74 72 61 6e 73 69 65 6e 74 20 74 61 ate transient ta
16f10 62 20 61 6e 64 20 73 74 6f 72 65 20 6c 69 6b 65 b and store like
16f20 20 53 52 54 5f 54 61 62 6c 65 20 2a 2f 0a 23 64 SRT_Table */.#d
16f30 65 66 69 6e 65 20 53 52 54 5f 43 6f 72 6f 75 74 efine SRT_Corout
16f40 69 6e 65 20 20 20 31 30 20 20 2f 2a 20 47 65 6e ine 10 /* Gen
16f50 65 72 61 74 65 20 61 20 73 69 6e 67 6c 65 20 72 erate a single r
16f60 6f 77 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a ow of result */.
16f70 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
16f80 63 65 20 6f 66 20 74 68 69 73 20 6f 62 6a 65 63 ce of this objec
16f90 74 20 64 65 73 63 72 69 62 65 73 20 77 68 65 72 t describes wher
16fa0 65 20 74 6f 20 70 75 74 20 6f 66 20 74 68 65 20 e to put of the
16fb0 72 65 73 75 6c 74 73 20 6f 66 0a 2a 2a 20 61 20 results of.** a
16fc0 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 SELECT statement
16fd0 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 65 6c 65 ..*/.struct Sele
16fe0 63 74 44 65 73 74 20 7b 0a 20 20 75 38 20 65 44 ctDest {. u8 eD
16ff0 65 73 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 est; /*
17000 48 6f 77 20 74 6f 20 64 69 73 70 6f 73 65 20 6f How to dispose o
17010 66 20 74 68 65 20 72 65 73 75 6c 74 73 2e 20 20 f the results.
17020 4f 6e 20 6f 66 20 53 52 54 5f 2a 20 61 62 6f 76 On of SRT_* abov
17030 65 2e 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 e. */. char aff
17040 53 64 73 74 3b 20 20 20 20 20 2f 2a 20 41 66 66 Sdst; /* Aff
17050 69 6e 69 74 79 20 75 73 65 64 20 77 68 65 6e 20 inity used when
17060 65 44 65 73 74 3d 3d 53 52 54 5f 53 65 74 20 2a eDest==SRT_Set *
17070 2f 0a 20 20 69 6e 74 20 69 53 44 50 61 72 6d 3b /. int iSDParm;
17080 20 20 20 20 20 20 2f 2a 20 41 20 70 61 72 61 6d /* A param
17090 65 74 65 72 20 75 73 65 64 20 62 79 20 74 68 65 eter used by the
170a0 20 65 44 65 73 74 20 64 69 73 70 6f 73 61 6c 20 eDest disposal
170b0 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 69 6e 74 20 method */. int
170c0 69 53 64 73 74 3b 20 20 20 20 20 20 20 20 2f 2a iSdst; /*
170d0 20 42 61 73 65 20 72 65 67 69 73 74 65 72 20 77 Base register w
170e0 68 65 72 65 20 72 65 73 75 6c 74 73 20 61 72 65 here results are
170f0 20 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 69 6e written */. in
17100 74 20 6e 53 64 73 74 3b 20 20 20 20 20 20 20 20 t nSdst;
17110 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 67 /* Number of reg
17120 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 65 64 isters allocated
17130 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 44 75 */.};../*.** Du
17140 72 69 6e 67 20 63 6f 64 65 20 67 65 6e 65 72 61 ring code genera
17150 74 69 6f 6e 20 6f 66 20 73 74 61 74 65 6d 65 6e tion of statemen
17160 74 73 20 74 68 61 74 20 64 6f 20 69 6e 73 65 72 ts that do inser
17170 74 73 20 69 6e 74 6f 20 41 55 54 4f 49 4e 43 52 ts into AUTOINCR
17180 45 4d 45 4e 54 20 0a 2a 2a 20 74 61 62 6c 65 73 EMENT .** tables
17190 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 , the following
171a0 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 61 information is a
171b0 74 74 61 63 68 65 64 20 74 6f 20 74 68 65 20 54 ttached to the T
171c0 61 62 6c 65 2e 75 2e 61 75 74 6f 49 6e 63 2e 70 able.u.autoInc.p
171d0 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 6f 66 20 65 .** pointer of e
171e0 61 63 68 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e ach autoincremen
171f0 74 20 74 61 62 6c 65 20 74 6f 20 72 65 63 6f 72 t table to recor
17200 64 20 73 6f 6d 65 20 73 69 64 65 20 69 6e 66 6f d some side info
17210 72 6d 61 74 69 6f 6e 20 74 68 61 74 0a 2a 2a 20 rmation that.**
17220 74 68 65 20 63 6f 64 65 20 67 65 6e 65 72 61 74 the code generat
17230 6f 72 20 6e 65 65 64 73 2e 20 20 57 65 20 68 61 or needs. We ha
17240 76 65 20 74 6f 20 6b 65 65 70 20 70 65 72 2d 74 ve to keep per-t
17250 61 62 6c 65 20 61 75 74 6f 69 6e 63 72 65 6d 65 able autoincreme
17260 6e 74 0a 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f nt.** informatio
17270 6e 20 69 6e 20 63 61 73 65 20 69 6e 73 65 72 74 n in case insert
17280 73 20 61 72 65 20 64 6f 77 6e 20 77 69 74 68 69 s are down withi
17290 6e 20 74 72 69 67 67 65 72 73 2e 20 20 54 72 69 n triggers. Tri
172a0 67 67 65 72 73 20 64 6f 20 6e 6f 74 0a 2a 2a 20 ggers do not.**
172b0 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6f 72 64 69 6e normally coordin
172c0 61 74 65 20 74 68 65 69 72 20 61 63 74 69 76 69 ate their activi
172d0 74 69 65 73 2c 20 62 75 74 20 77 65 20 64 6f 20 ties, but we do
172e0 6e 65 65 64 20 74 6f 20 63 6f 6f 72 64 69 6e 61 need to coordina
172f0 74 65 20 74 68 65 0a 2a 2a 20 6c 6f 61 64 69 6e te the.** loadin
17300 67 20 61 6e 64 20 73 61 76 69 6e 67 20 6f 66 20 g and saving of
17310 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 20 69 6e autoincrement in
17320 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 formation..*/.st
17330 72 75 63 74 20 41 75 74 6f 69 6e 63 49 6e 66 6f ruct AutoincInfo
17340 20 7b 0a 20 20 41 75 74 6f 69 6e 63 49 6e 66 6f {. AutoincInfo
17350 20 2a 70 4e 65 78 74 3b 20 20 20 2f 2a 20 4e 65 *pNext; /* Ne
17360 78 74 20 69 6e 66 6f 20 62 6c 6f 63 6b 20 69 6e xt info block in
17370 20 61 20 6c 69 73 74 20 6f 66 20 74 68 65 6d 20 a list of them
17380 61 6c 6c 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a all */. Table *
17390 70 54 61 62 3b 20 20 20 20 20 20 20 20 20 20 2f pTab; /
173a0 2a 20 54 61 62 6c 65 20 74 68 69 73 20 69 6e 66 * Table this inf
173b0 6f 20 62 6c 6f 63 6b 20 72 65 66 65 72 73 20 74 o block refers t
173c0 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 o */. int iDb;
173d0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
173e0 49 6e 64 65 78 20 69 6e 20 73 71 6c 69 74 65 33 Index in sqlite3
173f0 2e 61 44 62 5b 5d 20 6f 66 20 64 61 74 61 62 61 .aDb[] of databa
17400 73 65 20 68 6f 6c 64 69 6e 67 20 70 54 61 62 20 se holding pTab
17410 2a 2f 0a 20 20 69 6e 74 20 72 65 67 43 74 72 3b */. int regCtr;
17420 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 /* Me
17430 6d 6f 72 79 20 72 65 67 69 73 74 65 72 20 68 6f mory register ho
17440 6c 64 69 6e 67 20 74 68 65 20 72 6f 77 69 64 20 lding the rowid
17450 63 6f 75 6e 74 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f counter */.};../
17460 2a 0a 2a 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 *.** Size of the
17470 20 63 6f 6c 75 6d 6e 20 63 61 63 68 65 0a 2a 2f column cache.*/
17480 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
17490 4e 5f 43 4f 4c 43 41 43 48 45 0a 23 20 64 65 66 N_COLCACHE.# def
174a0 69 6e 65 20 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c ine SQLITE_N_COL
174b0 43 41 43 48 45 20 31 30 0a 23 65 6e 64 69 66 0a CACHE 10.#endif.
174c0 0a 2f 2a 0a 2a 2a 20 41 74 20 6c 65 61 73 74 20 ./*.** At least
174d0 6f 6e 65 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 one instance of
174e0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
174f0 72 75 63 74 75 72 65 20 69 73 20 63 72 65 61 74 ructure is creat
17500 65 64 20 66 6f 72 20 65 61 63 68 20 0a 2a 2a 20 ed for each .**
17510 74 72 69 67 67 65 72 20 74 68 61 74 20 6d 61 79 trigger that may
17520 20 62 65 20 66 69 72 65 64 20 77 68 69 6c 65 20 be fired while
17530 70 61 72 73 69 6e 67 20 61 6e 20 49 4e 53 45 52 parsing an INSER
17540 54 2c 20 55 50 44 41 54 45 20 6f 72 20 44 45 4c T, UPDATE or DEL
17550 45 54 45 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 ETE.** statement
17560 2e 20 41 6c 6c 20 73 75 63 68 20 6f 62 6a 65 63 . All such objec
17570 74 73 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e ts are stored in
17580 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 the linked list
17590 20 68 65 61 64 65 64 20 61 74 0a 2a 2a 20 50 61 headed at.** Pa
175a0 72 73 65 2e 70 54 72 69 67 67 65 72 50 72 67 20 rse.pTriggerPrg
175b0 61 6e 64 20 64 65 6c 65 74 65 64 20 6f 6e 63 65 and deleted once
175c0 20 73 74 61 74 65 6d 65 6e 74 20 63 6f 6d 70 69 statement compi
175d0 6c 61 74 69 6f 6e 20 68 61 73 20 62 65 65 6e 0a lation has been.
175e0 2a 2a 20 63 6f 6d 70 6c 65 74 65 64 2e 0a 2a 2a ** completed..**
175f0 0a 2a 2a 20 41 20 56 64 62 65 20 73 75 62 2d 70 .** A Vdbe sub-p
17600 72 6f 67 72 61 6d 20 74 68 61 74 20 69 6d 70 6c rogram that impl
17610 65 6d 65 6e 74 73 20 74 68 65 20 62 6f 64 79 20 ements the body
17620 61 6e 64 20 57 48 45 4e 20 63 6c 61 75 73 65 20 and WHEN clause
17630 6f 66 20 74 72 69 67 67 65 72 0a 2a 2a 20 54 72 of trigger.** Tr
17640 69 67 67 65 72 50 72 67 2e 70 54 72 69 67 67 65 iggerPrg.pTrigge
17650 72 2c 20 61 73 73 75 6d 69 6e 67 20 61 20 64 65 r, assuming a de
17660 66 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 fault ON CONFLIC
17670 54 20 63 6c 61 75 73 65 20 6f 66 0a 2a 2a 20 54 T clause of.** T
17680 72 69 67 67 65 72 50 72 67 2e 6f 72 63 6f 6e 66 riggerPrg.orconf
17690 2c 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 , is stored in t
176a0 68 65 20 54 72 69 67 67 65 72 50 72 67 2e 70 50 he TriggerPrg.pP
176b0 72 6f 67 72 61 6d 20 76 61 72 69 61 62 6c 65 2e rogram variable.
176c0 0a 2a 2a 20 54 68 65 20 50 61 72 73 65 2e 70 54 .** The Parse.pT
176d0 72 69 67 67 65 72 50 72 67 20 6c 69 73 74 20 6e riggerPrg list n
176e0 65 76 65 72 20 63 6f 6e 74 61 69 6e 73 20 74 77 ever contains tw
176f0 6f 20 65 6e 74 72 69 65 73 20 77 69 74 68 20 74 o entries with t
17700 68 65 20 73 61 6d 65 0a 2a 2a 20 76 61 6c 75 65 he same.** value
17710 73 20 66 6f 72 20 62 6f 74 68 20 70 54 72 69 67 s for both pTrig
17720 67 65 72 20 61 6e 64 20 6f 72 63 6f 6e 66 2e 0a ger and orconf..
17730 2a 2a 0a 2a 2a 20 54 68 65 20 54 72 69 67 67 65 **.** The Trigge
17740 72 50 72 67 2e 61 43 6f 6c 6d 61 73 6b 5b 30 5d rPrg.aColmask[0]
17750 20 76 61 72 69 61 62 6c 65 20 69 73 20 73 65 74 variable is set
17760 20 74 6f 20 61 20 6d 61 73 6b 20 6f 66 20 6f 6c to a mask of ol
17770 64 2e 2a 20 63 6f 6c 75 6d 6e 73 0a 2a 2a 20 61 d.* columns.** a
17780 63 63 65 73 73 65 64 20 28 6f 72 20 73 65 74 20 ccessed (or set
17790 74 6f 20 30 20 66 6f 72 20 74 72 69 67 67 65 72 to 0 for trigger
177a0 73 20 66 69 72 65 64 20 61 73 20 61 20 72 65 73 s fired as a res
177b0 75 6c 74 20 6f 66 20 49 4e 53 45 52 54 20 0a 2a ult of INSERT .*
177c0 2a 20 73 74 61 74 65 6d 65 6e 74 73 29 2e 20 53 * statements). S
177d0 69 6d 69 6c 61 72 6c 79 2c 20 74 68 65 20 54 72 imilarly, the Tr
177e0 69 67 67 65 72 50 72 67 2e 61 43 6f 6c 6d 61 73 iggerPrg.aColmas
177f0 6b 5b 31 5d 20 76 61 72 69 61 62 6c 65 20 69 73 k[1] variable is
17800 20 73 65 74 20 74 6f 0a 2a 2a 20 61 20 6d 61 73 set to.** a mas
17810 6b 20 6f 66 20 6e 65 77 2e 2a 20 63 6f 6c 75 6d k of new.* colum
17820 6e 73 20 75 73 65 64 20 62 79 20 74 68 65 20 70 ns used by the p
17830 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 73 74 72 75 63 rogram..*/.struc
17840 74 20 54 72 69 67 67 65 72 50 72 67 20 7b 0a 20 t TriggerPrg {.
17850 20 54 72 69 67 67 65 72 20 2a 70 54 72 69 67 67 Trigger *pTrigg
17860 65 72 3b 20 20 20 20 20 20 2f 2a 20 54 72 69 67 er; /* Trig
17870 67 65 72 20 74 68 69 73 20 70 72 6f 67 72 61 6d ger this program
17880 20 77 61 73 20 63 6f 64 65 64 20 66 72 6f 6d 20 was coded from
17890 2a 2f 0a 20 20 54 72 69 67 67 65 72 50 72 67 20 */. TriggerPrg
178a0 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 2f 2a 20 *pNext; /*
178b0 4e 65 78 74 20 65 6e 74 72 79 20 69 6e 20 50 61 Next entry in Pa
178c0 72 73 65 2e 70 54 72 69 67 67 65 72 50 72 67 20 rse.pTriggerPrg
178d0 6c 69 73 74 20 2a 2f 0a 20 20 53 75 62 50 72 6f list */. SubPro
178e0 67 72 61 6d 20 2a 70 50 72 6f 67 72 61 6d 3b 20 gram *pProgram;
178f0 20 20 2f 2a 20 50 72 6f 67 72 61 6d 20 69 6d 70 /* Program imp
17900 6c 65 6d 65 6e 74 69 6e 67 20 70 54 72 69 67 67 lementing pTrigg
17910 65 72 2f 6f 72 63 6f 6e 66 20 2a 2f 0a 20 20 69 er/orconf */. i
17920 6e 74 20 6f 72 63 6f 6e 66 3b 20 20 20 20 20 20 nt orconf;
17930 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 75 6c /* Defaul
17940 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 70 6f t ON CONFLICT po
17950 6c 69 63 79 20 2a 2f 0a 20 20 75 33 32 20 61 43 licy */. u32 aC
17960 6f 6c 6d 61 73 6b 5b 32 5d 3b 20 20 20 20 20 20 olmask[2];
17970 20 20 2f 2a 20 4d 61 73 6b 73 20 6f 66 20 6f 6c /* Masks of ol
17980 64 2e 2a 2c 20 6e 65 77 2e 2a 20 63 6f 6c 75 6d d.*, new.* colum
17990 6e 73 20 61 63 63 65 73 73 65 64 20 2a 2f 0a 7d ns accessed */.}
179a0 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 79 44 62 ;../*.** The yDb
179b0 4d 61 73 6b 20 64 61 74 61 74 79 70 65 20 66 6f Mask datatype fo
179c0 72 20 74 68 65 20 62 69 74 6d 61 73 6b 20 6f 66 r the bitmask of
179d0 20 61 6c 6c 20 61 74 74 61 63 68 65 64 20 64 61 all attached da
179e0 74 61 62 61 73 65 73 2e 0a 2a 2f 0a 23 69 66 20 tabases..*/.#if
179f0 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 43 SQLITE_MAX_ATTAC
17a00 48 45 44 3e 33 30 0a 20 20 74 79 70 65 64 65 66 HED>30. typedef
17a10 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 36 34 20 sqlite3_uint64
17a20 79 44 62 4d 61 73 6b 3b 0a 23 65 6c 73 65 0a 20 yDbMask;.#else.
17a30 20 74 79 70 65 64 65 66 20 75 6e 73 69 67 6e 65 typedef unsigne
17a40 64 20 69 6e 74 20 79 44 62 4d 61 73 6b 3b 0a 23 d int yDbMask;.#
17a50 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 endif../*.** An
17a60 53 51 4c 20 70 61 72 73 65 72 20 63 6f 6e 74 65 SQL parser conte
17a70 78 74 2e 20 20 41 20 63 6f 70 79 20 6f 66 20 74 xt. A copy of t
17a80 68 69 73 20 73 74 72 75 63 74 75 72 65 20 69 73 his structure is
17a90 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 0a passed through.
17aa0 2a 2a 20 74 68 65 20 70 61 72 73 65 72 20 61 6e ** the parser an
17ab0 64 20 64 6f 77 6e 20 69 6e 74 6f 20 61 6c 6c 20 d down into all
17ac0 74 68 65 20 70 61 72 73 65 72 20 61 63 74 69 6f the parser actio
17ad0 6e 20 72 6f 75 74 69 6e 65 20 69 6e 20 6f 72 64 n routine in ord
17ae0 65 72 20 74 6f 0a 2a 2a 20 63 61 72 72 79 20 61 er to.** carry a
17af0 72 6f 75 6e 64 20 69 6e 66 6f 72 6d 61 74 69 6f round informatio
17b00 6e 20 74 68 61 74 20 69 73 20 67 6c 6f 62 61 6c n that is global
17b10 20 74 6f 20 74 68 65 20 65 6e 74 69 72 65 20 70 to the entire p
17b20 61 72 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 arse..**.** The
17b30 73 74 72 75 63 74 75 72 65 20 69 73 20 64 69 76 structure is div
17b40 69 64 65 64 20 69 6e 74 6f 20 74 77 6f 20 70 61 ided into two pa
17b50 72 74 73 2e 20 20 57 68 65 6e 20 74 68 65 20 70 rts. When the p
17b60 61 72 73 65 72 20 61 6e 64 20 63 6f 64 65 0a 2a arser and code.*
17b70 2a 20 67 65 6e 65 72 61 74 65 20 63 61 6c 6c 20 * generate call
17b80 74 68 65 6d 73 65 6c 76 65 73 20 72 65 63 75 72 themselves recur
17b90 73 69 76 65 6c 79 2c 20 74 68 65 20 66 69 72 73 sively, the firs
17ba0 74 20 70 61 72 74 20 6f 66 20 74 68 65 20 73 74 t part of the st
17bb0 72 75 63 74 75 72 65 0a 2a 2a 20 69 73 20 63 6f ructure.** is co
17bc0 6e 73 74 61 6e 74 20 62 75 74 20 74 68 65 20 73 nstant but the s
17bd0 65 63 6f 6e 64 20 70 61 72 74 20 69 73 20 72 65 econd part is re
17be0 73 65 74 20 61 74 20 74 68 65 20 62 65 67 69 6e set at the begin
17bf0 6e 69 6e 67 20 61 6e 64 20 65 6e 64 20 6f 66 0a ning and end of.
17c00 2a 2a 20 65 61 63 68 20 72 65 63 75 72 73 69 6f ** each recursio
17c10 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6e 54 61 n..**.** The nTa
17c20 62 6c 65 4c 6f 63 6b 20 61 6e 64 20 61 54 61 62 bleLock and aTab
17c30 6c 65 4c 6f 63 6b 20 76 61 72 69 61 62 6c 65 73 leLock variables
17c40 20 61 72 65 20 6f 6e 6c 79 20 75 73 65 64 20 69 are only used i
17c50 66 20 74 68 65 20 73 68 61 72 65 64 2d 63 61 63 f the shared-cac
17c60 68 65 20 0a 2a 2a 20 66 65 61 74 75 72 65 20 69 he .** feature i
17c70 73 20 65 6e 61 62 6c 65 64 20 28 69 66 20 73 71 s enabled (if sq
17c80 6c 69 74 65 33 54 73 64 28 29 2d 3e 75 73 65 53 lite3Tsd()->useS
17c90 68 61 72 65 64 44 61 74 61 20 69 73 20 74 72 75 haredData is tru
17ca0 65 29 2e 20 54 68 65 79 20 61 72 65 0a 2a 2a 20 e). They are.**
17cb0 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 used to store th
17cc0 65 20 73 65 74 20 6f 66 20 74 61 62 6c 65 2d 6c e set of table-l
17cd0 6f 63 6b 73 20 72 65 71 75 69 72 65 64 20 62 79 ocks required by
17ce0 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 62 the statement b
17cf0 65 69 6e 67 0a 2a 2a 20 63 6f 6d 70 69 6c 65 64 eing.** compiled
17d00 2e 20 46 75 6e 63 74 69 6f 6e 20 73 71 6c 69 74 . Function sqlit
17d10 65 33 54 61 62 6c 65 4c 6f 63 6b 28 29 20 69 73 e3TableLock() is
17d20 20 75 73 65 64 20 74 6f 20 61 64 64 20 65 6e 74 used to add ent
17d30 72 69 65 73 20 74 6f 20 74 68 65 0a 2a 2a 20 6c ries to the.** l
17d40 69 73 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 ist..*/.struct P
17d50 61 72 73 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 arse {. sqlite3
17d60 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 2f 2a *db; /*
17d70 20 54 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 The main databa
17d80 73 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a se structure */.
17d90 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 3b char *zErrMsg;
17da0 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 72 72 /* An err
17db0 6f 72 20 6d 65 73 73 61 67 65 20 2a 2f 0a 20 20 or message */.
17dc0 56 64 62 65 20 2a 70 56 64 62 65 3b 20 20 20 20 Vdbe *pVdbe;
17dd0 20 20 20 20 20 2f 2a 20 41 6e 20 65 6e 67 69 6e /* An engin
17de0 65 20 66 6f 72 20 65 78 65 63 75 74 69 6e 67 20 e for executing
17df0 64 61 74 61 62 61 73 65 20 62 79 74 65 63 6f 64 database bytecod
17e00 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b 20 20 e */. int rc;
17e10 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
17e20 65 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 eturn code from
17e30 65 78 65 63 75 74 69 6f 6e 20 2a 2f 0a 20 20 75 execution */. u
17e40 38 20 63 6f 6c 4e 61 6d 65 73 53 65 74 3b 20 20 8 colNamesSet;
17e50 20 20 20 20 2f 2a 20 54 52 55 45 20 61 66 74 65 /* TRUE afte
17e60 72 20 4f 50 5f 43 6f 6c 75 6d 6e 4e 61 6d 65 20 r OP_ColumnName
17e70 68 61 73 20 62 65 65 6e 20 69 73 73 75 65 64 20 has been issued
17e80 74 6f 20 70 56 64 62 65 20 2a 2f 0a 20 20 75 38 to pVdbe */. u8
17e90 20 63 68 65 63 6b 53 63 68 65 6d 61 3b 20 20 20 checkSchema;
17ea0 20 20 20 2f 2a 20 43 61 75 73 65 73 20 73 63 68 /* Causes sch
17eb0 65 6d 61 20 63 6f 6f 6b 69 65 20 63 68 65 63 6b ema cookie check
17ec0 20 61 66 74 65 72 20 61 6e 20 65 72 72 6f 72 20 after an error
17ed0 2a 2f 0a 20 20 75 38 20 6e 65 73 74 65 64 3b 20 */. u8 nested;
17ee0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
17ef0 62 65 72 20 6f 66 20 6e 65 73 74 65 64 20 63 61 ber of nested ca
17f00 6c 6c 73 20 74 6f 20 74 68 65 20 70 61 72 73 65 lls to the parse
17f10 72 2f 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 r/code generator
17f20 20 2a 2f 0a 20 20 75 38 20 6e 54 65 6d 70 52 65 */. u8 nTempRe
17f30 67 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 g; /* Nu
17f40 6d 62 65 72 20 6f 66 20 74 65 6d 70 6f 72 61 72 mber of temporar
17f50 79 20 72 65 67 69 73 74 65 72 73 20 69 6e 20 61 y registers in a
17f60 54 65 6d 70 52 65 67 5b 5d 20 2a 2f 0a 20 20 75 TempReg[] */. u
17f70 38 20 6e 54 65 6d 70 49 6e 55 73 65 3b 20 20 20 8 nTempInUse;
17f80 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
17f90 20 61 54 65 6d 70 52 65 67 5b 5d 20 63 75 72 72 aTempReg[] curr
17fa0 65 6e 74 6c 79 20 63 68 65 63 6b 65 64 20 6f 75 ently checked ou
17fb0 74 20 2a 2f 0a 20 20 75 38 20 6e 43 6f 6c 43 61 t */. u8 nColCa
17fc0 63 68 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e che; /* N
17fd0 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 umber of entries
17fe0 20 69 6e 20 61 43 6f 6c 43 61 63 68 65 5b 5d 20 in aColCache[]
17ff0 2a 2f 0a 20 20 75 38 20 69 43 6f 6c 43 61 63 68 */. u8 iColCach
18000 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 e; /* Nex
18010 74 20 65 6e 74 72 79 20 69 6e 20 61 43 6f 6c 43 t entry in aColC
18020 61 63 68 65 5b 5d 20 74 6f 20 72 65 70 6c 61 63 ache[] to replac
18030 65 20 2a 2f 0a 20 20 75 38 20 69 73 4d 75 6c 74 e */. u8 isMult
18040 69 57 72 69 74 65 3b 20 20 20 20 20 2f 2a 20 54 iWrite; /* T
18050 72 75 65 20 69 66 20 73 74 61 74 65 6d 65 6e 74 rue if statement
18060 20 6d 61 79 20 6d 6f 64 69 66 79 2f 69 6e 73 65 may modify/inse
18070 72 74 20 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 rt multiple rows
18080 20 2a 2f 0a 20 20 75 38 20 6d 61 79 41 62 6f 72 */. u8 mayAbor
18090 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 t; /* Tr
180a0 75 65 20 69 66 20 73 74 61 74 65 6d 65 6e 74 20 ue if statement
180b0 6d 61 79 20 74 68 72 6f 77 20 61 6e 20 41 42 4f may throw an ABO
180c0 52 54 20 65 78 63 65 70 74 69 6f 6e 20 2a 2f 0a RT exception */.
180d0 20 20 75 38 20 68 61 73 43 6f 6d 70 6f 75 6e 64 u8 hasCompound
180e0 3b 20 20 20 20 20 20 2f 2a 20 4e 65 65 64 20 74 ; /* Need t
180f0 6f 20 69 6e 76 6f 6b 65 20 63 6f 6e 76 65 72 74 o invoke convert
18100 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 74 54 6f CompoundSelectTo
18110 53 75 62 71 75 65 72 79 28 29 20 2a 2f 0a 20 20 Subquery() */.
18120 69 6e 74 20 61 54 65 6d 70 52 65 67 5b 38 5d 3b int aTempReg[8];
18130 20 20 20 20 20 2f 2a 20 48 6f 6c 64 69 6e 67 20 /* Holding
18140 61 72 65 61 20 66 6f 72 20 74 65 6d 70 6f 72 61 area for tempora
18150 72 79 20 72 65 67 69 73 74 65 72 73 20 2a 2f 0a ry registers */.
18160 20 20 69 6e 74 20 6e 52 61 6e 67 65 52 65 67 3b int nRangeReg;
18170 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
18180 66 20 74 68 65 20 74 65 6d 70 6f 72 61 72 79 20 f the temporary
18190 72 65 67 69 73 74 65 72 20 62 6c 6f 63 6b 20 2a register block *
181a0 2f 0a 20 20 69 6e 74 20 69 52 61 6e 67 65 52 65 /. int iRangeRe
181b0 67 3b 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 g; /* Firs
181c0 74 20 72 65 67 69 73 74 65 72 20 69 6e 20 74 65 t register in te
181d0 6d 70 6f 72 61 72 79 20 72 65 67 69 73 74 65 72 mporary register
181e0 20 62 6c 6f 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 block */. int
181f0 6e 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 20 nErr;
18200 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 72 /* Number of er
18210 72 6f 72 73 20 73 65 65 6e 20 2a 2f 0a 20 20 69 rors seen */. i
18220 6e 74 20 6e 54 61 62 3b 20 20 20 20 20 20 20 20 nt nTab;
18230 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
18240 20 70 72 65 76 69 6f 75 73 6c 79 20 61 6c 6c 6f previously allo
18250 63 61 74 65 64 20 56 44 42 45 20 63 75 72 73 6f cated VDBE curso
18260 72 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d rs */. int nMem
18270 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
18280 4e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 Number of memory
18290 20 63 65 6c 6c 73 20 75 73 65 64 20 73 6f 20 66 cells used so f
182a0 61 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 65 74 ar */. int nSet
182b0 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ; /*
182c0 4e 75 6d 62 65 72 20 6f 66 20 73 65 74 73 20 75 Number of sets u
182d0 73 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 sed so far */.
182e0 69 6e 74 20 6e 4f 6e 63 65 3b 20 20 20 20 20 20 int nOnce;
182f0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
18300 66 20 4f 50 5f 4f 6e 63 65 20 69 6e 73 74 72 75 f OP_Once instru
18310 63 74 69 6f 6e 73 20 73 6f 20 66 61 72 20 2a 2f ctions so far */
18320 0a 20 20 69 6e 74 20 6e 4f 70 41 6c 6c 6f 63 3b . int nOpAlloc;
18330 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
18340 72 20 6f 66 20 73 6c 6f 74 73 20 61 6c 6c 6f 63 r of slots alloc
18350 61 74 65 64 20 66 6f 72 20 56 64 62 65 2e 61 4f ated for Vdbe.aO
18360 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 p[] */. int nLa
18370 62 65 6c 3b 20 20 20 20 20 20 20 20 20 20 2f 2a bel; /*
18380 20 4e 75 6d 62 65 72 20 6f 66 20 6c 61 62 65 6c Number of label
18390 73 20 75 73 65 64 20 2a 2f 0a 20 20 69 6e 74 20 s used */. int
183a0 2a 61 4c 61 62 65 6c 3b 20 20 20 20 20 20 20 20 *aLabel;
183b0 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 68 6f 6c /* Space to hol
183c0 64 20 74 68 65 20 6c 61 62 65 6c 73 20 2a 2f 0a d the labels */.
183d0 20 20 69 6e 74 20 69 46 69 78 65 64 4f 70 3b 20 int iFixedOp;
183e0 20 20 20 20 20 20 20 2f 2a 20 4e 65 76 65 72 20 /* Never
183f0 62 61 63 6b 20 6f 75 74 20 6f 70 63 6f 64 65 73 back out opcodes
18400 20 69 46 69 78 65 64 4f 70 2d 31 20 6f 72 20 65 iFixedOp-1 or e
18410 61 72 6c 69 65 72 20 2a 2f 0a 20 20 69 6e 74 20 arlier */. int
18420 63 6b 42 61 73 65 3b 20 20 20 20 20 20 20 20 20 ckBase;
18430 20 2f 2a 20 42 61 73 65 20 72 65 67 69 73 74 65 /* Base registe
18440 72 20 6f 66 20 64 61 74 61 20 64 75 72 69 6e 67 r of data during
18450 20 63 68 65 63 6b 20 63 6f 6e 73 74 72 61 69 6e check constrain
18460 74 73 20 2a 2f 0a 20 20 69 6e 74 20 69 50 61 72 ts */. int iPar
18470 74 49 64 78 54 61 62 3b 20 20 20 20 20 2f 2a 20 tIdxTab; /*
18480 54 61 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 Table correspond
18490 69 6e 67 20 74 6f 20 61 20 70 61 72 74 69 61 6c ing to a partial
184a0 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 index */. int
184b0 69 43 61 63 68 65 4c 65 76 65 6c 3b 20 20 20 20 iCacheLevel;
184c0 20 2f 2a 20 43 6f 6c 43 61 63 68 65 20 76 61 6c /* ColCache val
184d0 69 64 20 77 68 65 6e 20 61 43 6f 6c 43 61 63 68 id when aColCach
184e0 65 5b 5d 2e 69 4c 65 76 65 6c 3c 3d 69 43 61 63 e[].iLevel<=iCac
184f0 68 65 4c 65 76 65 6c 20 2a 2f 0a 20 20 69 6e 74 heLevel */. int
18500 20 69 43 61 63 68 65 43 6e 74 3b 20 20 20 20 20 iCacheCnt;
18510 20 20 2f 2a 20 43 6f 75 6e 74 65 72 20 75 73 65 /* Counter use
18520 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 43 d to generate aC
18530 6f 6c 43 61 63 68 65 5b 5d 2e 6c 72 75 20 76 61 olCache[].lru va
18540 6c 75 65 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 lues */. struct
18550 20 79 43 6f 6c 43 61 63 68 65 20 7b 0a 20 20 20 yColCache {.
18560 20 69 6e 74 20 69 54 61 62 6c 65 3b 20 20 20 20 int iTable;
18570 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 /* Table
18580 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 2a 2f cursor number */
18590 0a 20 20 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e . int iColumn
185a0 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 ; /* Ta
185b0 62 6c 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 ble column numbe
185c0 72 20 2a 2f 0a 20 20 20 20 75 38 20 74 65 6d 70 r */. u8 temp
185d0 52 65 67 3b 20 20 20 20 20 20 20 20 20 20 20 2f Reg; /
185e0 2a 20 69 52 65 67 20 69 73 20 61 20 74 65 6d 70 * iReg is a temp
185f0 20 72 65 67 69 73 74 65 72 20 74 68 61 74 20 6e register that n
18600 65 65 64 73 20 74 6f 20 62 65 20 66 72 65 65 64 eeds to be freed
18610 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4c 65 76 */. int iLev
18620 65 6c 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a el; /*
18630 20 4e 65 73 74 69 6e 67 20 6c 65 76 65 6c 20 2a Nesting level *
18640 2f 0a 20 20 20 20 69 6e 74 20 69 52 65 67 3b 20 /. int iReg;
18650 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
18660 65 67 20 77 69 74 68 20 76 61 6c 75 65 20 6f 66 eg with value of
18670 20 74 68 69 73 20 63 6f 6c 75 6d 6e 2e 20 30 20 this column. 0
18680 6d 65 61 6e 73 20 6e 6f 6e 65 2e 20 2a 2f 0a 20 means none. */.
18690 20 20 20 69 6e 74 20 6c 72 75 3b 20 20 20 20 20 int lru;
186a0 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 61 73 /* Leas
186b0 74 20 72 65 63 65 6e 74 6c 79 20 75 73 65 64 20 t recently used
186c0 65 6e 74 72 79 20 68 61 73 20 74 68 65 20 73 6d entry has the sm
186d0 61 6c 6c 65 73 74 20 76 61 6c 75 65 20 2a 2f 0a allest value */.
186e0 20 20 7d 20 61 43 6f 6c 43 61 63 68 65 5b 53 51 } aColCache[SQ
186f0 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 5d LITE_N_COLCACHE]
18700 3b 20 20 2f 2a 20 4f 6e 65 20 66 6f 72 20 65 61 ; /* One for ea
18710 63 68 20 63 6f 6c 75 6d 6e 20 63 61 63 68 65 20 ch column cache
18720 65 6e 74 72 79 20 2a 2f 0a 20 20 45 78 70 72 4c entry */. ExprL
18730 69 73 74 20 2a 70 43 6f 6e 73 74 45 78 70 72 3b ist *pConstExpr;
18740 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 65 78 70 72 /* Constant expr
18750 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 79 44 62 essions */. yDb
18760 4d 61 73 6b 20 77 72 69 74 65 4d 61 73 6b 3b 20 Mask writeMask;
18770 20 20 2f 2a 20 53 74 61 72 74 20 61 20 77 72 69 /* Start a wri
18780 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f te transaction o
18790 6e 20 74 68 65 73 65 20 64 61 74 61 62 61 73 65 n these database
187a0 73 20 2a 2f 0a 20 20 79 44 62 4d 61 73 6b 20 63 s */. yDbMask c
187b0 6f 6f 6b 69 65 4d 61 73 6b 3b 20 20 2f 2a 20 42 ookieMask; /* B
187c0 69 74 6d 61 73 6b 20 6f 66 20 73 63 68 65 6d 61 itmask of schema
187d0 20 76 65 72 69 66 69 65 64 20 64 61 74 61 62 61 verified databa
187e0 73 65 73 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6f ses */. int coo
187f0 6b 69 65 47 6f 74 6f 3b 20 20 20 20 20 20 2f 2a kieGoto; /*
18800 20 41 64 64 72 65 73 73 20 6f 66 20 4f 50 5f 47 Address of OP_G
18810 6f 74 6f 20 74 6f 20 63 6f 6f 6b 69 65 20 76 65 oto to cookie ve
18820 72 69 66 69 65 72 20 73 75 62 72 6f 75 74 69 6e rifier subroutin
18830 65 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 e */. int cooki
18840 65 56 61 6c 75 65 5b 53 51 4c 49 54 45 5f 4d 41 eValue[SQLITE_MA
18850 58 5f 41 54 54 41 43 48 45 44 2b 32 5d 3b 20 20 X_ATTACHED+2];
18860 2f 2a 20 56 61 6c 75 65 73 20 6f 66 20 63 6f 6f /* Values of coo
18870 6b 69 65 73 20 74 6f 20 76 65 72 69 66 79 20 2a kies to verify *
18880 2f 0a 20 20 69 6e 74 20 72 65 67 52 6f 77 69 64 /. int regRowid
18890 3b 20 20 20 20 20 20 20 20 2f 2a 20 52 65 67 69 ; /* Regi
188a0 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 6f 77 ster holding row
188b0 69 64 20 6f 66 20 43 52 45 41 54 45 20 54 41 42 id of CREATE TAB
188c0 4c 45 20 65 6e 74 72 79 20 2a 2f 0a 20 20 69 6e LE entry */. in
188d0 74 20 72 65 67 52 6f 6f 74 3b 20 20 20 20 20 20 t regRoot;
188e0 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 68 /* Register h
188f0 6f 6c 64 69 6e 67 20 72 6f 6f 74 20 70 61 67 65 olding root page
18900 20 6e 75 6d 62 65 72 20 66 6f 72 20 6e 65 77 20 number for new
18910 6f 62 6a 65 63 74 73 20 2a 2f 0a 20 20 69 6e 74 objects */. int
18920 20 6e 4d 61 78 41 72 67 3b 20 20 20 20 20 20 20 nMaxArg;
18930 20 20 2f 2a 20 4d 61 78 20 61 72 67 73 20 70 61 /* Max args pa
18940 73 73 65 64 20 74 6f 20 75 73 65 72 20 66 75 6e ssed to user fun
18950 63 74 69 6f 6e 20 62 79 20 73 75 62 2d 70 72 6f ction by sub-pro
18960 67 72 61 6d 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 gram */. Token
18970 63 6f 6e 73 74 72 61 69 6e 74 4e 61 6d 65 3b 2f constraintName;/
18980 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f * Name of the co
18990 6e 73 74 72 61 69 6e 74 20 63 75 72 72 65 6e 74 nstraint current
189a0 6c 79 20 62 65 69 6e 67 20 70 61 72 73 65 64 20 ly being parsed
189b0 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
189c0 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 E_OMIT_SHARED_CA
189d0 43 48 45 0a 20 20 69 6e 74 20 6e 54 61 62 6c 65 CHE. int nTable
189e0 4c 6f 63 6b 3b 20 20 20 20 20 20 20 20 2f 2a 20 Lock; /*
189f0 4e 75 6d 62 65 72 20 6f 66 20 6c 6f 63 6b 73 20 Number of locks
18a00 69 6e 20 61 54 61 62 6c 65 4c 6f 63 6b 20 2a 2f in aTableLock */
18a10 0a 20 20 54 61 62 6c 65 4c 6f 63 6b 20 2a 61 54 . TableLock *aT
18a20 61 62 6c 65 4c 6f 63 6b 3b 20 2f 2a 20 52 65 71 ableLock; /* Req
18a30 75 69 72 65 64 20 74 61 62 6c 65 20 6c 6f 63 6b uired table lock
18a40 73 20 66 6f 72 20 73 68 61 72 65 64 2d 63 61 63 s for shared-cac
18a50 68 65 20 6d 6f 64 65 20 2a 2f 0a 23 65 6e 64 69 he mode */.#endi
18a60 66 0a 20 20 41 75 74 6f 69 6e 63 49 6e 66 6f 20 f. AutoincInfo
18a70 2a 70 41 69 6e 63 3b 20 20 2f 2a 20 49 6e 66 6f *pAinc; /* Info
18a80 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 41 55 rmation about AU
18a90 54 4f 49 4e 43 52 45 4d 45 4e 54 20 63 6f 75 6e TOINCREMENT coun
18aa0 74 65 72 73 20 2a 2f 0a 0a 20 20 2f 2a 20 49 6e ters */.. /* In
18ab0 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 77 formation used w
18ac0 68 69 6c 65 20 63 6f 64 69 6e 67 20 74 72 69 67 hile coding trig
18ad0 67 65 72 20 70 72 6f 67 72 61 6d 73 2e 20 2a 2f ger programs. */
18ae0 0a 20 20 50 61 72 73 65 20 2a 70 54 6f 70 6c 65 . Parse *pTople
18af0 76 65 6c 3b 20 20 20 20 2f 2a 20 50 61 72 73 65 vel; /* Parse
18b00 20 73 74 72 75 63 74 75 72 65 20 66 6f 72 20 6d structure for m
18b10 61 69 6e 20 70 72 6f 67 72 61 6d 20 28 6f 72 20 ain program (or
18b20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 54 61 62 6c 65 NULL) */. Table
18b30 20 2a 70 54 72 69 67 67 65 72 54 61 62 3b 20 20 *pTriggerTab;
18b40 2f 2a 20 54 61 62 6c 65 20 74 72 69 67 67 65 72 /* Table trigger
18b50 73 20 61 72 65 20 62 65 69 6e 67 20 63 6f 64 65 s are being code
18b60 64 20 66 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 61 d for */. int a
18b70 64 64 72 43 72 54 61 62 3b 20 20 20 20 20 20 20 ddrCrTab;
18b80 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 4f 50 /* Address of OP
18b90 5f 43 72 65 61 74 65 54 61 62 6c 65 20 6f 70 63 _CreateTable opc
18ba0 6f 64 65 20 6f 6e 20 43 52 45 41 54 45 20 54 41 ode on CREATE TA
18bb0 42 4c 45 20 2a 2f 0a 20 20 69 6e 74 20 61 64 64 BLE */. int add
18bc0 72 53 6b 69 70 50 4b 3b 20 20 20 20 20 20 2f 2a rSkipPK; /*
18bd0 20 41 64 64 72 65 73 73 20 6f 66 20 69 6e 73 74 Address of inst
18be0 72 75 63 74 69 6f 6e 20 74 6f 20 73 6b 69 70 20 ruction to skip
18bf0 50 52 49 4d 41 52 59 20 4b 45 59 20 69 6e 64 65 PRIMARY KEY inde
18c00 78 20 2a 2f 0a 20 20 75 33 32 20 6e 51 75 65 72 x */. u32 nQuer
18c10 79 4c 6f 6f 70 3b 20 20 20 20 20 20 2f 2a 20 45 yLoop; /* E
18c20 73 74 20 6e 75 6d 62 65 72 20 6f 66 20 69 74 65 st number of ite
18c30 72 61 74 69 6f 6e 73 20 6f 66 20 61 20 71 75 65 rations of a que
18c40 72 79 20 28 31 30 2a 6c 6f 67 32 28 4e 29 29 20 ry (10*log2(N))
18c50 2a 2f 0a 20 20 75 33 32 20 6f 6c 64 6d 61 73 6b */. u32 oldmask
18c60 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 ; /* Mas
18c70 6b 20 6f 66 20 6f 6c 64 2e 2a 20 63 6f 6c 75 6d k of old.* colum
18c80 6e 73 20 72 65 66 65 72 65 6e 63 65 64 20 2a 2f ns referenced */
18c90 0a 20 20 75 33 32 20 6e 65 77 6d 61 73 6b 3b 20 . u32 newmask;
18ca0 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 /* Mask
18cb0 6f 66 20 6e 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 of new.* columns
18cc0 20 72 65 66 65 72 65 6e 63 65 64 20 2a 2f 0a 20 referenced */.
18cd0 20 75 38 20 65 54 72 69 67 67 65 72 4f 70 3b 20 u8 eTriggerOp;
18ce0 20 20 20 20 20 20 2f 2a 20 54 4b 5f 55 50 44 41 /* TK_UPDA
18cf0 54 45 2c 20 54 4b 5f 49 4e 53 45 52 54 20 6f 72 TE, TK_INSERT or
18d00 20 54 4b 5f 44 45 4c 45 54 45 20 2a 2f 0a 20 20 TK_DELETE */.
18d10 75 38 20 65 4f 72 63 6f 6e 66 3b 20 20 20 20 20 u8 eOrconf;
18d20 20 20 20 20 20 2f 2a 20 44 65 66 61 75 6c 74 20 /* Default
18d30 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 70 6f 6c 69 ON CONFLICT poli
18d40 63 79 20 66 6f 72 20 74 72 69 67 67 65 72 20 73 cy for trigger s
18d50 74 65 70 73 20 2a 2f 0a 20 20 75 38 20 64 69 73 teps */. u8 dis
18d60 61 62 6c 65 54 72 69 67 67 65 72 73 3b 20 20 2f ableTriggers; /
18d70 2a 20 54 72 75 65 20 74 6f 20 64 69 73 61 62 6c * True to disabl
18d80 65 20 74 72 69 67 67 65 72 73 20 2a 2f 0a 0a 20 e triggers */..
18d90 20 2f 2a 20 41 62 6f 76 65 20 69 73 20 63 6f 6e /* Above is con
18da0 73 74 61 6e 74 20 62 65 74 77 65 65 6e 20 72 65 stant between re
18db0 63 75 72 73 69 6f 6e 73 2e 20 20 42 65 6c 6f 77 cursions. Below
18dc0 20 69 73 20 72 65 73 65 74 20 62 65 66 6f 72 65 is reset before
18dd0 20 61 6e 64 20 61 66 74 65 72 0a 20 20 2a 2a 20 and after. **
18de0 65 61 63 68 20 72 65 63 75 72 73 69 6f 6e 20 2a each recursion *
18df0 2f 0a 0a 20 20 69 6e 74 20 6e 56 61 72 3b 20 20 /.. int nVar;
18e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
18e10 2a 20 4e 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 * Number of '?'
18e20 76 61 72 69 61 62 6c 65 73 20 73 65 65 6e 20 69 variables seen i
18e30 6e 20 74 68 65 20 53 51 4c 20 73 6f 20 66 61 72 n the SQL so far
18e40 20 2a 2f 0a 20 20 69 6e 74 20 6e 7a 56 61 72 3b */. int nzVar;
18e50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18e60 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 76 61 /* Number of ava
18e70 69 6c 61 62 6c 65 20 73 6c 6f 74 73 20 69 6e 20 ilable slots in
18e80 61 7a 56 61 72 5b 5d 20 2a 2f 0a 20 20 75 38 20 azVar[] */. u8
18e90 69 50 6b 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 iPkSortOrder;
18ea0 20 20 20 20 20 20 20 2f 2a 20 41 53 43 20 6f 72 /* ASC or
18eb0 20 44 45 53 43 20 66 6f 72 20 49 4e 54 45 47 45 DESC for INTEGE
18ec0 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 2a 2f R PRIMARY KEY */
18ed0 0a 20 20 75 38 20 65 78 70 6c 61 69 6e 3b 20 20 . u8 explain;
18ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
18ef0 54 72 75 65 20 69 66 20 74 68 65 20 45 58 50 4c True if the EXPL
18f00 41 49 4e 20 66 6c 61 67 20 69 73 20 66 6f 75 6e AIN flag is foun
18f10 64 20 6f 6e 20 74 68 65 20 71 75 65 72 79 20 2a d on the query *
18f20 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
18f30 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
18f40 4c 45 0a 20 20 75 38 20 64 65 63 6c 61 72 65 56 LE. u8 declareV
18f50 74 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 2f tab; /
18f60 2a 20 54 72 75 65 20 69 66 20 69 6e 73 69 64 65 * True if inside
18f70 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 sqlite3_declare
18f80 5f 76 74 61 62 28 29 20 2a 2f 0a 20 20 69 6e 74 _vtab() */. int
18f90 20 6e 56 74 61 62 4c 6f 63 6b 3b 20 20 20 20 20 nVtabLock;
18fa0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
18fb0 20 6f 66 20 76 69 72 74 75 61 6c 20 74 61 62 6c of virtual tabl
18fc0 65 73 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 23 65 es to lock */.#e
18fd0 6e 64 69 66 0a 20 20 69 6e 74 20 6e 41 6c 69 61 ndif. int nAlia
18fe0 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s;
18ff0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 6c /* Number of al
19000 69 61 73 65 64 20 72 65 73 75 6c 74 20 73 65 74 iased result set
19010 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 69 6e columns */. in
19020 74 20 6e 48 65 69 67 68 74 3b 20 20 20 20 20 20 t nHeight;
19030 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 /* Expre
19040 73 73 69 6f 6e 20 74 72 65 65 20 68 65 69 67 68 ssion tree heigh
19050 74 20 6f 66 20 63 75 72 72 65 6e 74 20 73 75 62 t of current sub
19060 2d 73 65 6c 65 63 74 20 2a 2f 0a 23 69 66 6e 64 -select */.#ifnd
19070 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 ef SQLITE_OMIT_E
19080 58 50 4c 41 49 4e 0a 20 20 69 6e 74 20 69 53 65 XPLAIN. int iSe
19090 6c 65 63 74 49 64 3b 20 20 20 20 20 20 20 20 20 lectId;
190a0 20 20 20 2f 2a 20 49 44 20 6f 66 20 63 75 72 72 /* ID of curr
190b0 65 6e 74 20 73 65 6c 65 63 74 20 66 6f 72 20 45 ent select for E
190c0 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 20 2a 2f XPLAIN output */
190d0 0a 20 20 69 6e 74 20 69 4e 65 78 74 53 65 6c 65 . int iNextSele
190e0 63 74 49 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 ctId; /*
190f0 4e 65 78 74 20 61 76 61 69 6c 61 62 6c 65 20 73 Next available s
19100 65 6c 65 63 74 20 49 44 20 66 6f 72 20 45 58 50 elect ID for EXP
19110 4c 41 49 4e 20 6f 75 74 70 75 74 20 2a 2f 0a 23 LAIN output */.#
19120 65 6e 64 69 66 0a 20 20 63 68 61 72 20 2a 2a 61 endif. char **a
19130 7a 56 61 72 3b 20 20 20 20 20 20 20 20 20 20 20 zVar;
19140 20 20 2f 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f /* Pointers to
19150 20 6e 61 6d 65 73 20 6f 66 20 70 61 72 61 6d 65 names of parame
19160 74 65 72 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a ters */. Vdbe *
19170 70 52 65 70 72 65 70 61 72 65 3b 20 20 20 20 20 pReprepare;
19180 20 20 20 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 /* VM being
19190 72 65 70 72 65 70 61 72 65 64 20 28 73 71 6c 69 reprepared (sqli
191a0 74 65 33 52 65 70 72 65 70 61 72 65 28 29 29 20 te3Reprepare())
191b0 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
191c0 2a 7a 54 61 69 6c 3b 20 20 20 20 20 20 20 20 2f *zTail; /
191d0 2a 20 41 6c 6c 20 53 51 4c 20 74 65 78 74 20 70 * All SQL text p
191e0 61 73 74 20 74 68 65 20 6c 61 73 74 20 73 65 6d ast the last sem
191f0 69 63 6f 6c 6f 6e 20 70 61 72 73 65 64 20 2a 2f icolon parsed */
19200 0a 20 20 54 61 62 6c 65 20 2a 70 4e 65 77 54 61 . Table *pNewTa
19210 62 6c 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ble; /*
19220 41 20 74 61 62 6c 65 20 62 65 69 6e 67 20 63 6f A table being co
19230 6e 73 74 72 75 63 74 65 64 20 62 79 20 43 52 45 nstructed by CRE
19240 41 54 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 54 ATE TABLE */. T
19250 72 69 67 67 65 72 20 2a 70 4e 65 77 54 72 69 67 rigger *pNewTrig
19260 67 65 72 3b 20 20 20 20 20 2f 2a 20 54 72 69 67 ger; /* Trig
19270 67 65 72 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 ger under constr
19280 75 63 74 20 62 79 20 61 20 43 52 45 41 54 45 20 uct by a CREATE
19290 54 52 49 47 47 45 52 20 2a 2f 0a 20 20 63 6f 6e TRIGGER */. con
192a0 73 74 20 63 68 61 72 20 2a 7a 41 75 74 68 43 6f st char *zAuthCo
192b0 6e 74 65 78 74 3b 20 2f 2a 20 54 68 65 20 36 74 ntext; /* The 6t
192c0 68 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 64 h parameter to d
192d0 62 2d 3e 78 41 75 74 68 20 63 61 6c 6c 62 61 63 b->xAuth callbac
192e0 6b 73 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 73 4e ks */. Token sN
192f0 61 6d 65 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 ameToken;
19300 20 20 2f 2a 20 54 6f 6b 65 6e 20 77 69 74 68 20 /* Token with
19310 75 6e 71 75 61 6c 69 66 69 65 64 20 73 63 68 65 unqualified sche
19320 6d 61 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a ma object name *
19330 2f 0a 20 20 54 6f 6b 65 6e 20 73 4c 61 73 74 54 /. Token sLastT
19340 6f 6b 65 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a oken; /*
19350 20 54 68 65 20 6c 61 73 74 20 74 6f 6b 65 6e 20 The last token
19360 70 61 72 73 65 64 20 2a 2f 0a 23 69 66 6e 64 65 parsed */.#ifnde
19370 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
19380 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 54 6f 6b RTUALTABLE. Tok
19390 65 6e 20 73 41 72 67 3b 20 20 20 20 20 20 20 20 en sArg;
193a0 20 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 6c 65 /* Comple
193b0 74 65 20 74 65 78 74 20 6f 66 20 61 20 6d 6f 64 te text of a mod
193c0 75 6c 65 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a ule argument */.
193d0 20 20 54 61 62 6c 65 20 2a 2a 61 70 56 74 61 62 Table **apVtab
193e0 4c 6f 63 6b 3b 20 20 20 20 20 20 20 2f 2a 20 50 Lock; /* P
193f0 6f 69 6e 74 65 72 20 74 6f 20 76 69 72 74 75 61 ointer to virtua
19400 6c 20 74 61 62 6c 65 73 20 6e 65 65 64 69 6e 67 l tables needing
19410 20 6c 6f 63 6b 69 6e 67 20 2a 2f 0a 23 65 6e 64 locking */.#end
19420 69 66 0a 20 20 54 61 62 6c 65 20 2a 70 5a 6f 6d if. Table *pZom
19430 62 69 65 54 61 62 3b 20 20 20 20 20 20 20 20 2f bieTab; /
19440 2a 20 4c 69 73 74 20 6f 66 20 54 61 62 6c 65 20 * List of Table
19450 6f 62 6a 65 63 74 73 20 74 6f 20 64 65 6c 65 74 objects to delet
19460 65 20 61 66 74 65 72 20 63 6f 64 65 20 67 65 6e e after code gen
19470 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 50 72 67 */. TriggerPrg
19480 20 2a 70 54 72 69 67 67 65 72 50 72 67 3b 20 20 *pTriggerPrg;
19490 2f 2a 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f /* Linked list o
194a0 66 20 63 6f 64 65 64 20 74 72 69 67 67 65 72 73 f coded triggers
194b0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 */.};../*.** Re
194c0 74 75 72 6e 20 74 72 75 65 20 69 66 20 63 75 72 turn true if cur
194d0 72 65 6e 74 6c 79 20 69 6e 73 69 64 65 20 61 6e rently inside an
194e0 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 sqlite3_declare
194f0 5f 76 74 61 62 28 29 20 63 61 6c 6c 2e 0a 2a 2f _vtab() call..*/
19500 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
19510 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 MIT_VIRTUALTABLE
19520 0a 20 20 23 64 65 66 69 6e 65 20 49 4e 5f 44 45 . #define IN_DE
19530 43 4c 41 52 45 5f 56 54 41 42 20 30 0a 23 65 6c CLARE_VTAB 0.#el
19540 73 65 0a 20 20 23 64 65 66 69 6e 65 20 49 4e 5f se. #define IN_
19550 44 45 43 4c 41 52 45 5f 56 54 41 42 20 28 70 50 DECLARE_VTAB (pP
19560 61 72 73 65 2d 3e 64 65 63 6c 61 72 65 56 74 61 arse->declareVta
19570 62 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a b).#endif../*.**
19580 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
19590 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
195a0 72 75 63 74 75 72 65 20 63 61 6e 20 62 65 20 64 ructure can be d
195b0 65 63 6c 61 72 65 64 20 6f 6e 20 61 20 73 74 61 eclared on a sta
195c0 63 6b 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 74 ck and used.** t
195d0 6f 20 73 61 76 65 20 74 68 65 20 50 61 72 73 65 o save the Parse
195e0 2e 7a 41 75 74 68 43 6f 6e 74 65 78 74 20 76 61 .zAuthContext va
195f0 6c 75 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 lue so that it c
19600 61 6e 20 62 65 20 72 65 73 74 6f 72 65 64 20 6c an be restored l
19610 61 74 65 72 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ater..*/.struct
19620 41 75 74 68 43 6f 6e 74 65 78 74 20 7b 0a 20 20 AuthContext {.
19630 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 75 74 const char *zAut
19640 68 43 6f 6e 74 65 78 74 3b 20 20 20 2f 2a 20 50 hContext; /* P
19650 75 74 20 73 61 76 65 64 20 50 61 72 73 65 2e 7a ut saved Parse.z
19660 41 75 74 68 43 6f 6e 74 65 78 74 20 68 65 72 65 AuthContext here
19670 20 2a 2f 0a 20 20 50 61 72 73 65 20 2a 70 50 61 */. Parse *pPa
19680 72 73 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 rse;
19690 20 20 2f 2a 20 54 68 65 20 50 61 72 73 65 20 73 /* The Parse s
196a0 74 72 75 63 74 75 72 65 20 2a 2f 0a 7d 3b 0a 0a tructure */.};..
196b0 2f 2a 0a 2a 2a 20 42 69 74 66 69 65 6c 64 20 66 /*.** Bitfield f
196c0 6c 61 67 73 20 66 6f 72 20 50 35 20 76 61 6c 75 lags for P5 valu
196d0 65 20 69 6e 20 76 61 72 69 6f 75 73 20 6f 70 63 e in various opc
196e0 6f 64 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 odes..*/.#define
196f0 20 4f 50 46 4c 41 47 5f 4e 43 48 41 4e 47 45 20 OPFLAG_NCHANGE
19700 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
19710 20 53 65 74 20 74 6f 20 75 70 64 61 74 65 20 64 Set to update d
19720 62 2d 3e 6e 43 68 61 6e 67 65 20 2a 2f 0a 23 64 b->nChange */.#d
19730 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 4c 41 53 efine OPFLAG_LAS
19740 54 52 4f 57 49 44 20 20 20 20 20 30 78 30 32 20 TROWID 0x02
19750 20 20 20 2f 2a 20 53 65 74 20 74 6f 20 75 70 64 /* Set to upd
19760 61 74 65 20 64 62 2d 3e 6c 61 73 74 52 6f 77 69 ate db->lastRowi
19770 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 d */.#define OPF
19780 4c 41 47 5f 49 53 55 50 44 41 54 45 20 20 20 20 LAG_ISUPDATE
19790 20 20 30 78 30 34 20 20 20 20 2f 2a 20 54 68 69 0x04 /* Thi
197a0 73 20 4f 50 5f 49 6e 73 65 72 74 20 69 73 20 61 s OP_Insert is a
197b0 6e 20 73 71 6c 20 55 50 44 41 54 45 20 2a 2f 0a n sql UPDATE */.
197c0 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 41 #define OPFLAG_A
197d0 50 50 45 4e 44 20 20 20 20 20 20 20 20 30 78 30 PPEND 0x0
197e0 38 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 8 /* This is
197f0 6c 69 6b 65 6c 79 20 74 6f 20 62 65 20 61 6e 20 likely to be an
19800 61 70 70 65 6e 64 20 2a 2f 0a 23 64 65 66 69 6e append */.#defin
19810 65 20 4f 50 46 4c 41 47 5f 55 53 45 53 45 45 4b e OPFLAG_USESEEK
19820 52 45 53 55 4c 54 20 30 78 31 30 20 20 20 20 2f RESULT 0x10 /
19830 2a 20 54 72 79 20 74 6f 20 61 76 6f 69 64 20 61 * Try to avoid a
19840 20 73 65 65 6b 20 69 6e 20 42 74 72 65 65 49 6e seek in BtreeIn
19850 73 65 72 74 28 29 20 2a 2f 0a 23 64 65 66 69 6e sert() */.#defin
19860 65 20 4f 50 46 4c 41 47 5f 43 4c 45 41 52 43 41 e OPFLAG_CLEARCA
19870 43 48 45 20 20 20 20 30 78 32 30 20 20 20 20 2f CHE 0x20 /
19880 2a 20 43 6c 65 61 72 20 70 73 65 75 64 6f 2d 74 * Clear pseudo-t
19890 61 62 6c 65 20 63 61 63 68 65 20 69 6e 20 4f 50 able cache in OP
198a0 5f 43 6f 6c 75 6d 6e 20 2a 2f 0a 23 64 65 66 69 _Column */.#defi
198b0 6e 65 20 4f 50 46 4c 41 47 5f 4c 45 4e 47 54 48 ne OPFLAG_LENGTH
198c0 41 52 47 20 20 20 20 20 30 78 34 30 20 20 20 20 ARG 0x40
198d0 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c /* OP_Column onl
198e0 79 20 75 73 65 64 20 66 6f 72 20 6c 65 6e 67 74 y used for lengt
198f0 68 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f h() */.#define O
19900 50 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 47 20 PFLAG_TYPEOFARG
19910 20 20 20 20 30 78 38 30 20 20 20 20 2f 2a 20 4f 0x80 /* O
19920 50 5f 43 6f 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 P_Column only us
19930 65 64 20 66 6f 72 20 74 79 70 65 6f 66 28 29 20 ed for typeof()
19940 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
19950 47 5f 42 55 4c 4b 43 53 52 20 20 20 20 20 20 20 G_BULKCSR
19960 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 4f 70 0x01 /* OP_Op
19970 65 6e 2a 2a 20 75 73 65 64 20 74 6f 20 6f 70 65 en** used to ope
19980 6e 20 62 75 6c 6b 20 63 75 72 73 6f 72 20 2a 2f n bulk cursor */
19990 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
199a0 50 32 49 53 52 45 47 20 20 20 20 20 20 20 30 78 P2ISREG 0x
199b0 30 32 20 20 20 20 2f 2a 20 50 32 20 74 6f 20 4f 02 /* P2 to O
199c0 50 5f 4f 70 65 6e 2a 2a 20 69 73 20 61 20 72 65 P_Open** is a re
199d0 67 69 73 74 65 72 20 6e 75 6d 62 65 72 20 2a 2f gister number */
199e0 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f .#define OPFLAG_
199f0 50 45 52 4d 55 54 45 20 20 20 20 20 20 20 30 78 PERMUTE 0x
19a00 30 31 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6d 70 01 /* OP_Comp
19a10 61 72 65 3a 20 75 73 65 20 74 68 65 20 70 65 72 are: use the per
19a20 6d 75 74 61 74 69 6f 6e 20 2a 2f 0a 0a 2f 2a 0a mutation */../*.
19a30 20 2a 20 45 61 63 68 20 74 72 69 67 67 65 72 20 * Each trigger
19a40 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 20 64 present in the d
19a50 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 atabase schema i
19a60 73 20 73 74 6f 72 65 64 20 61 73 20 61 6e 20 69 s stored as an i
19a70 6e 73 74 61 6e 63 65 20 6f 66 0a 20 2a 20 73 74 nstance of. * st
19a80 72 75 63 74 20 54 72 69 67 67 65 72 2e 20 0a 20 ruct Trigger. .
19a90 2a 0a 20 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f *. * Pointers to
19aa0 20 69 6e 73 74 61 6e 63 65 73 20 6f 66 20 73 74 instances of st
19ab0 72 75 63 74 20 54 72 69 67 67 65 72 20 61 72 65 ruct Trigger are
19ac0 20 73 74 6f 72 65 64 20 69 6e 20 74 77 6f 20 77 stored in two w
19ad0 61 79 73 2e 0a 20 2a 20 31 2e 20 49 6e 20 74 68 ays.. * 1. In th
19ae0 65 20 22 74 72 69 67 48 61 73 68 22 20 68 61 73 e "trigHash" has
19af0 68 20 74 61 62 6c 65 20 28 70 61 72 74 20 6f 66 h table (part of
19b00 20 74 68 65 20 73 71 6c 69 74 65 33 2a 20 74 68 the sqlite3* th
19b10 61 74 20 72 65 70 72 65 73 65 6e 74 73 20 74 68 at represents th
19b20 65 20 0a 20 2a 20 20 20 20 64 61 74 61 62 61 73 e . * databas
19b30 65 29 2e 20 54 68 69 73 20 61 6c 6c 6f 77 73 20 e). This allows
19b40 54 72 69 67 67 65 72 20 73 74 72 75 63 74 75 72 Trigger structur
19b50 65 73 20 74 6f 20 62 65 20 72 65 74 72 69 65 76 es to be retriev
19b60 65 64 20 62 79 20 6e 61 6d 65 2e 0a 20 2a 20 32 ed by name.. * 2
19b70 2e 20 41 6c 6c 20 74 72 69 67 67 65 72 73 20 61 . All triggers a
19b80 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 ssociated with a
19b90 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 66 6f single table fo
19ba0 72 6d 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 rm a linked list
19bb0 2c 20 75 73 69 6e 67 20 74 68 65 0a 20 2a 20 20 , using the. *
19bc0 20 20 70 4e 65 78 74 20 6d 65 6d 62 65 72 20 6f pNext member o
19bd0 66 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 f struct Trigger
19be0 2e 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 . A pointer to t
19bf0 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 he first element
19c00 20 6f 66 20 74 68 65 0a 20 2a 20 20 20 20 6c 69 of the. * li
19c10 6e 6b 65 64 20 6c 69 73 74 20 69 73 20 73 74 6f nked list is sto
19c20 72 65 64 20 61 73 20 74 68 65 20 22 70 54 72 69 red as the "pTri
19c30 67 67 65 72 22 20 6d 65 6d 62 65 72 20 6f 66 20 gger" member of
19c40 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20 the associated.
19c50 2a 20 20 20 20 73 74 72 75 63 74 20 54 61 62 6c * struct Tabl
19c60 65 2e 0a 20 2a 0a 20 2a 20 54 68 65 20 22 73 74 e.. *. * The "st
19c70 65 70 5f 6c 69 73 74 22 20 6d 65 6d 62 65 72 20 ep_list" member
19c80 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 66 69 points to the fi
19c90 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 20 61 rst element of a
19ca0 20 6c 69 6e 6b 65 64 20 6c 69 73 74 0a 20 2a 20 linked list. *
19cb0 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 53 containing the S
19cc0 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 73 70 QL statements sp
19cd0 65 63 69 66 69 65 64 20 61 73 20 74 68 65 20 74 ecified as the t
19ce0 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 2e 0a rigger program..
19cf0 20 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 */.struct Trigg
19d00 65 72 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 er {. char *zNa
19d10 6d 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f me; /
19d20 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 * The name of th
19d30 65 20 74 72 69 67 67 65 72 20 20 20 20 20 20 20 e trigger
19d40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19d50 20 2a 2f 0a 20 20 63 68 61 72 20 2a 74 61 62 6c */. char *tabl
19d60 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
19d70 20 54 68 65 20 74 61 62 6c 65 20 6f 72 20 76 69 The table or vi
19d80 65 77 20 74 6f 20 77 68 69 63 68 20 74 68 65 20 ew to which the
19d90 74 72 69 67 67 65 72 20 61 70 70 6c 69 65 73 20 trigger applies
19da0 2a 2f 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 20 */. u8 op;
19db0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
19dc0 4f 6e 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 One of TK_DELETE
19dd0 2c 20 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f , TK_UPDATE, TK_
19de0 49 4e 53 45 52 54 20 20 20 20 20 20 20 20 20 2a INSERT *
19df0 2f 0a 20 20 75 38 20 74 72 5f 74 6d 3b 20 20 20 /. u8 tr_tm;
19e00 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
19e10 6e 65 20 6f 66 20 54 52 49 47 47 45 52 5f 42 45 ne of TRIGGER_BE
19e20 46 4f 52 45 2c 20 54 52 49 47 47 45 52 5f 41 46 FORE, TRIGGER_AF
19e30 54 45 52 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 TER */. Expr *p
19e40 57 68 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 When;
19e50 20 2f 2a 20 54 68 65 20 57 48 45 4e 20 63 6c 61 /* The WHEN cla
19e60 75 73 65 20 6f 66 20 74 68 65 20 65 78 70 72 65 use of the expre
19e70 73 73 69 6f 6e 20 28 6d 61 79 20 62 65 20 4e 55 ssion (may be NU
19e80 4c 4c 29 20 2a 2f 0a 20 20 49 64 4c 69 73 74 20 LL) */. IdList
19e90 2a 70 43 6f 6c 75 6d 6e 73 3b 20 20 20 20 20 20 *pColumns;
19ea0 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 /* If this is a
19eb0 6e 20 55 50 44 41 54 45 20 4f 46 20 3c 63 6f 6c n UPDATE OF <col
19ec0 75 6d 6e 2d 6c 69 73 74 3e 20 74 72 69 67 67 65 umn-list> trigge
19ed0 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 r,.
19ee0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
19ef0 74 68 65 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 the <column-list
19f00 3e 20 69 73 20 73 74 6f 72 65 64 20 68 65 72 65 > is stored here
19f10 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 */. Schema *pS
19f20 63 68 65 6d 61 3b 20 20 20 20 20 20 20 20 2f 2a chema; /*
19f30 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 Schema containi
19f40 6e 67 20 74 68 65 20 74 72 69 67 67 65 72 20 2a ng the trigger *
19f50 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 54 61 62 /. Schema *pTab
19f60 53 63 68 65 6d 61 3b 20 20 20 20 20 2f 2a 20 53 Schema; /* S
19f70 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 6e 67 chema containing
19f80 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 the table */.
19f90 54 72 69 67 67 65 72 53 74 65 70 20 2a 73 74 65 TriggerStep *ste
19fa0 70 5f 6c 69 73 74 3b 20 2f 2a 20 4c 69 6e 6b 20 p_list; /* Link
19fb0 6c 69 73 74 20 6f 66 20 74 72 69 67 67 65 72 20 list of trigger
19fc0 70 72 6f 67 72 61 6d 20 73 74 65 70 73 20 20 20 program steps
19fd0 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 54 */. T
19fe0 72 69 67 67 65 72 20 2a 70 4e 65 78 74 3b 20 20 rigger *pNext;
19ff0 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 74 /* Next t
1a000 72 69 67 67 65 72 20 61 73 73 6f 63 69 61 74 65 rigger associate
1a010 64 20 77 69 74 68 20 74 68 65 20 74 61 62 6c 65 d with the table
1a020 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 */.};../*.** A
1a030 74 72 69 67 67 65 72 20 69 73 20 65 69 74 68 65 trigger is eithe
1a040 72 20 61 20 42 45 46 4f 52 45 20 6f 72 20 61 6e r a BEFORE or an
1a050 20 41 46 54 45 52 20 74 72 69 67 67 65 72 2e 20 AFTER trigger.
1a060 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 The following c
1a070 6f 6e 73 74 61 6e 74 73 0a 2a 2a 20 64 65 74 65 onstants.** dete
1a080 72 6d 69 6e 65 20 77 68 69 63 68 2e 20 0a 2a 2a rmine which. .**
1a090 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 .** If there are
1a0a0 20 6d 75 6c 74 69 70 6c 65 20 74 72 69 67 67 65 multiple trigge
1a0b0 72 73 2c 20 79 6f 75 20 6d 69 67 68 74 20 6f 66 rs, you might of
1a0c0 20 73 6f 6d 65 20 42 45 46 4f 52 45 20 61 6e 64 some BEFORE and
1a0d0 20 73 6f 6d 65 20 41 46 54 45 52 2e 0a 2a 2a 20 some AFTER..**
1a0e0 49 6e 20 74 68 61 74 20 63 61 73 65 73 2c 20 74 In that cases, t
1a0f0 68 65 20 63 6f 6e 73 74 61 6e 74 73 20 62 65 6c he constants bel
1a100 6f 77 20 63 61 6e 20 62 65 20 4f 52 65 64 20 74 ow can be ORed t
1a110 6f 67 65 74 68 65 72 2e 0a 2a 2f 0a 23 64 65 66 ogether..*/.#def
1a120 69 6e 65 20 54 52 49 47 47 45 52 5f 42 45 46 4f ine TRIGGER_BEFO
1a130 52 45 20 20 31 0a 23 64 65 66 69 6e 65 20 54 52 RE 1.#define TR
1a140 49 47 47 45 52 5f 41 46 54 45 52 20 20 20 32 0a IGGER_AFTER 2.
1a150 0a 2f 2a 0a 20 2a 20 41 6e 20 69 6e 73 74 61 6e ./*. * An instan
1a160 63 65 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 ce of struct Tri
1a170 67 67 65 72 53 74 65 70 20 69 73 20 75 73 65 64 ggerStep is used
1a180 20 74 6f 20 73 74 6f 72 65 20 61 20 73 69 6e 67 to store a sing
1a190 6c 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 le SQL statement
1a1a0 0a 20 2a 20 74 68 61 74 20 69 73 20 61 20 70 61 . * that is a pa
1a1b0 72 74 20 6f 66 20 61 20 74 72 69 67 67 65 72 2d rt of a trigger-
1a1c0 70 72 6f 67 72 61 6d 2e 20 0a 20 2a 0a 20 2a 20 program. . *. *
1a1d0 49 6e 73 74 61 6e 63 65 73 20 6f 66 20 73 74 72 Instances of str
1a1e0 75 63 74 20 54 72 69 67 67 65 72 53 74 65 70 20 uct TriggerStep
1a1f0 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 are stored in a
1a200 73 69 6e 67 6c 79 20 6c 69 6e 6b 65 64 20 6c 69 singly linked li
1a210 73 74 20 28 6c 69 6e 6b 65 64 0a 20 2a 20 75 73 st (linked. * us
1a220 69 6e 67 20 74 68 65 20 22 70 4e 65 78 74 22 20 ing the "pNext"
1a230 6d 65 6d 62 65 72 29 20 72 65 66 65 72 65 6e 63 member) referenc
1a240 65 64 20 62 79 20 74 68 65 20 22 73 74 65 70 5f ed by the "step_
1a250 6c 69 73 74 22 20 6d 65 6d 62 65 72 20 6f 66 20 list" member of
1a260 74 68 65 20 0a 20 2a 20 61 73 73 6f 63 69 61 74 the . * associat
1a270 65 64 20 73 74 72 75 63 74 20 54 72 69 67 67 65 ed struct Trigge
1a280 72 20 69 6e 73 74 61 6e 63 65 2e 20 54 68 65 20 r instance. The
1a290 66 69 72 73 74 20 65 6c 65 6d 65 6e 74 20 6f 66 first element of
1a2a0 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c 69 73 74 the linked list
1a2b0 20 69 73 0a 20 2a 20 74 68 65 20 66 69 72 73 74 is. * the first
1a2c0 20 73 74 65 70 20 6f 66 20 74 68 65 20 74 72 69 step of the tri
1a2d0 67 67 65 72 2d 70 72 6f 67 72 61 6d 2e 0a 20 2a gger-program.. *
1a2e0 20 0a 20 2a 20 54 68 65 20 22 6f 70 22 20 6d 65 . * The "op" me
1a2f0 6d 62 65 72 20 69 6e 64 69 63 61 74 65 73 20 77 mber indicates w
1a300 68 65 74 68 65 72 20 74 68 69 73 20 69 73 20 61 hether this is a
1a310 20 22 44 45 4c 45 54 45 22 2c 20 22 49 4e 53 45 "DELETE", "INSE
1a320 52 54 22 2c 20 22 55 50 44 41 54 45 22 20 6f 72 RT", "UPDATE" or
1a330 0a 20 2a 20 22 53 45 4c 45 43 54 22 20 73 74 61 . * "SELECT" sta
1a340 74 65 6d 65 6e 74 2e 20 54 68 65 20 6d 65 61 6e tement. The mean
1a350 69 6e 67 73 20 6f 66 20 74 68 65 20 6f 74 68 65 ings of the othe
1a360 72 20 6d 65 6d 62 65 72 73 20 69 73 20 64 65 74 r members is det
1a370 65 72 6d 69 6e 65 64 20 62 79 20 74 68 65 20 0a ermined by the .
1a380 20 2a 20 76 61 6c 75 65 20 6f 66 20 22 6f 70 22 * value of "op"
1a390 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 2a 0a as follows:. *.
1a3a0 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 49 4e 53 * (op == TK_INS
1a3b0 45 52 54 29 0a 20 2a 20 6f 72 63 6f 6e 66 20 20 ERT). * orconf
1a3c0 20 20 2d 3e 20 73 74 6f 72 65 73 20 74 68 65 20 -> stores the
1a3d0 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 61 6c 67 6f ON CONFLICT algo
1a3e0 72 69 74 68 6d 0a 20 2a 20 70 53 65 6c 65 63 74 rithm. * pSelect
1a3f0 20 20 20 2d 3e 20 49 66 20 74 68 69 73 20 69 73 -> If this is
1a400 20 61 6e 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 an INSERT INTO
1a410 2e 2e 2e 20 53 45 4c 45 43 54 20 2e 2e 2e 20 73 ... SELECT ... s
1a420 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 6e 0a 20 tatement, then.
1a430 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 * t
1a440 68 69 73 20 73 74 6f 72 65 73 20 61 20 70 6f 69 his stores a poi
1a450 6e 74 65 72 20 74 6f 20 74 68 65 20 53 45 4c 45 nter to the SELE
1a460 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 4f 74 CT statement. Ot
1a470 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a herwise NULL.. *
1a480 20 74 61 72 67 65 74 20 20 20 20 2d 3e 20 41 20 target -> A
1a490 74 6f 6b 65 6e 20 68 6f 6c 64 69 6e 67 20 74 68 token holding th
1a4a0 65 20 71 75 6f 74 65 64 20 6e 61 6d 65 20 6f 66 e quoted name of
1a4b0 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 69 6e the table to in
1a4c0 73 65 72 74 20 69 6e 74 6f 2e 0a 20 2a 20 70 45 sert into.. * pE
1a4d0 78 70 72 4c 69 73 74 20 2d 3e 20 49 66 20 74 68 xprList -> If th
1a4e0 69 73 20 69 73 20 61 6e 20 49 4e 53 45 52 54 20 is is an INSERT
1a4f0 49 4e 54 4f 20 2e 2e 2e 20 56 41 4c 55 45 53 20 INTO ... VALUES
1a500 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 ... statement, t
1a510 68 65 6e 0a 20 2a 20 20 20 20 20 20 20 20 20 20 hen. *
1a520 20 20 20 20 74 68 69 73 20 73 74 6f 72 65 73 20 this stores
1a530 76 61 6c 75 65 73 20 74 6f 20 62 65 20 69 6e 73 values to be ins
1a540 65 72 74 65 64 2e 20 4f 74 68 65 72 77 69 73 65 erted. Otherwise
1a550 20 4e 55 4c 4c 2e 0a 20 2a 20 70 49 64 4c 69 73 NULL.. * pIdLis
1a560 74 20 20 20 2d 3e 20 49 66 20 74 68 69 73 20 69 t -> If this i
1a570 73 20 61 6e 20 49 4e 53 45 52 54 20 49 4e 54 4f s an INSERT INTO
1a580 20 2e 2e 2e 20 28 3c 63 6f 6c 75 6d 6e 2d 6e 61 ... (<column-na
1a590 6d 65 73 3e 29 20 56 41 4c 55 45 53 20 2e 2e 2e mes>) VALUES ...
1a5a0 20 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 . *
1a5b0 20 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 statement, the
1a5c0 6e 20 74 68 69 73 20 73 74 6f 72 65 73 20 74 68 n this stores th
1a5d0 65 20 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 20 74 e column-names t
1a5e0 6f 20 62 65 0a 20 2a 20 20 20 20 20 20 20 20 20 o be. *
1a5f0 20 20 20 20 20 69 6e 73 65 72 74 65 64 20 69 6e inserted in
1a600 74 6f 2e 0a 20 2a 0a 20 2a 20 28 6f 70 20 3d 3d to.. *. * (op ==
1a610 20 54 4b 5f 44 45 4c 45 54 45 29 0a 20 2a 20 74 TK_DELETE). * t
1a620 61 72 67 65 74 20 20 20 20 2d 3e 20 41 20 74 6f arget -> A to
1a630 6b 65 6e 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 ken holding the
1a640 71 75 6f 74 65 64 20 6e 61 6d 65 20 6f 66 20 74 quoted name of t
1a650 68 65 20 74 61 62 6c 65 20 74 6f 20 64 65 6c 65 he table to dele
1a660 74 65 20 66 72 6f 6d 2e 0a 20 2a 20 70 57 68 65 te from.. * pWhe
1a670 72 65 20 20 20 20 2d 3e 20 54 68 65 20 57 48 45 re -> The WHE
1a680 52 45 20 63 6c 61 75 73 65 20 6f 66 20 74 68 65 RE clause of the
1a690 20 44 45 4c 45 54 45 20 73 74 61 74 65 6d 65 6e DELETE statemen
1a6a0 74 20 69 66 20 6f 6e 65 20 69 73 20 73 70 65 63 t if one is spec
1a6b0 69 66 69 65 64 2e 0a 20 2a 20 20 20 20 20 20 20 ified.. *
1a6c0 20 20 20 20 20 20 20 4f 74 68 65 72 77 69 73 65 Otherwise
1a6d0 20 4e 55 4c 4c 2e 0a 20 2a 20 0a 20 2a 20 28 6f NULL.. * . * (o
1a6e0 70 20 3d 3d 20 54 4b 5f 55 50 44 41 54 45 29 0a p == TK_UPDATE).
1a6f0 20 2a 20 74 61 72 67 65 74 20 20 20 20 2d 3e 20 * target ->
1a700 41 20 74 6f 6b 65 6e 20 68 6f 6c 64 69 6e 67 20 A token holding
1a710 74 68 65 20 71 75 6f 74 65 64 20 6e 61 6d 65 20 the quoted name
1a720 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 of the table to
1a730 75 70 64 61 74 65 20 72 6f 77 73 20 6f 66 2e 0a update rows of..
1a740 20 2a 20 70 57 68 65 72 65 20 20 20 20 2d 3e 20 * pWhere ->
1a750 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 The WHERE clause
1a760 20 6f 66 20 74 68 65 20 55 50 44 41 54 45 20 73 of the UPDATE s
1a770 74 61 74 65 6d 65 6e 74 20 69 66 20 6f 6e 65 20 tatement if one
1a780 69 73 20 73 70 65 63 69 66 69 65 64 2e 0a 20 2a is specified.. *
1a790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4f 74 Ot
1a7a0 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 2a herwise NULL.. *
1a7b0 20 70 45 78 70 72 4c 69 73 74 20 2d 3e 20 41 20 pExprList -> A
1a7c0 6c 69 73 74 20 6f 66 20 74 68 65 20 63 6f 6c 75 list of the colu
1a7d0 6d 6e 73 20 74 6f 20 75 70 64 61 74 65 20 61 6e mns to update an
1a7e0 64 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e d the expression
1a7f0 73 20 74 6f 20 75 70 64 61 74 65 0a 20 2a 20 20 s to update. *
1a800 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 6d them
1a810 20 74 6f 2e 20 53 65 65 20 73 71 6c 69 74 65 33 to. See sqlite3
1a820 55 70 64 61 74 65 28 29 20 64 6f 63 75 6d 65 6e Update() documen
1a830 74 61 74 69 6f 6e 20 6f 66 20 22 70 43 68 61 6e tation of "pChan
1a840 67 65 73 22 0a 20 2a 20 20 20 20 20 20 20 20 20 ges". *
1a850 20 20 20 20 20 61 72 67 75 6d 65 6e 74 2e 0a 20 argument..
1a860 2a 20 0a 20 2a 2f 0a 73 74 72 75 63 74 20 54 72 * . */.struct Tr
1a870 69 67 67 65 72 53 74 65 70 20 7b 0a 20 20 75 38 iggerStep {. u8
1a880 20 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 op;
1a890 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 4b 5f /* One of TK_
1a8a0 44 45 4c 45 54 45 2c 20 54 4b 5f 55 50 44 41 54 DELETE, TK_UPDAT
1a8b0 45 2c 20 54 4b 5f 49 4e 53 45 52 54 2c 20 54 4b E, TK_INSERT, TK
1a8c0 5f 53 45 4c 45 43 54 20 2a 2f 0a 20 20 75 38 20 _SELECT */. u8
1a8d0 6f 72 63 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 orconf;
1a8e0 20 20 2f 2a 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b /* OE_Rollback
1a8f0 20 65 74 63 2e 20 2a 2f 0a 20 20 54 72 69 67 67 etc. */. Trigg
1a900 65 72 20 2a 70 54 72 69 67 3b 20 20 20 20 20 20 er *pTrig;
1a910 2f 2a 20 54 68 65 20 74 72 69 67 67 65 72 20 74 /* The trigger t
1a920 68 61 74 20 74 68 69 73 20 73 74 65 70 20 69 73 hat this step is
1a930 20 61 20 70 61 72 74 20 6f 66 20 2a 2f 0a 20 20 a part of */.
1a940 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 3b Select *pSelect;
1a950 20 20 20 20 20 2f 2a 20 53 45 4c 45 43 54 20 73 /* SELECT s
1a960 74 61 74 6d 65 6e 74 20 6f 72 20 52 48 53 20 6f tatment or RHS o
1a970 66 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e f INSERT INTO ..
1a980 20 53 45 4c 45 43 54 20 2e 2e 2e 20 2a 2f 0a 20 SELECT ... */.
1a990 20 54 6f 6b 65 6e 20 74 61 72 67 65 74 3b 20 20 Token target;
1a9a0 20 20 20 20 20 20 2f 2a 20 54 61 72 67 65 74 20 /* Target
1a9b0 74 61 62 6c 65 20 66 6f 72 20 44 45 4c 45 54 45 table for DELETE
1a9c0 2c 20 55 50 44 41 54 45 2c 20 49 4e 53 45 52 54 , UPDATE, INSERT
1a9d0 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 68 65 */. Expr *pWhe
1a9e0 72 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 re; /* Th
1a9f0 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 66 e WHERE clause f
1aa00 6f 72 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 or DELETE or UPD
1aa10 41 54 45 20 73 74 65 70 73 20 2a 2f 0a 20 20 45 ATE steps */. E
1aa20 78 70 72 4c 69 73 74 20 2a 70 45 78 70 72 4c 69 xprList *pExprLi
1aa30 73 74 3b 20 2f 2a 20 53 45 54 20 63 6c 61 75 73 st; /* SET claus
1aa40 65 20 66 6f 72 20 55 50 44 41 54 45 2e 20 2a 2f e for UPDATE. */
1aa50 0a 20 20 49 64 4c 69 73 74 20 2a 70 49 64 4c 69 . IdList *pIdLi
1aa60 73 74 3b 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d st; /* Colum
1aa70 6e 20 6e 61 6d 65 73 20 66 6f 72 20 49 4e 53 45 n names for INSE
1aa80 52 54 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 RT */. TriggerS
1aa90 74 65 70 20 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 tep *pNext; /*
1aaa0 4e 65 78 74 20 69 6e 20 74 68 65 20 6c 69 6e 6b Next in the link
1aab0 2d 6c 69 73 74 20 2a 2f 0a 20 20 54 72 69 67 67 -list */. Trigg
1aac0 65 72 53 74 65 70 20 2a 70 4c 61 73 74 3b 20 20 erStep *pLast;
1aad0 2f 2a 20 4c 61 73 74 20 65 6c 65 6d 65 6e 74 20 /* Last element
1aae0 69 6e 20 6c 69 6e 6b 2d 6c 69 73 74 2e 20 56 61 in link-list. Va
1aaf0 6c 69 64 20 66 6f 72 20 31 73 74 20 65 6c 65 6d lid for 1st elem
1ab00 20 6f 6e 6c 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a only */.};../*.
1ab10 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ** The following
1ab20 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 structure conta
1ab30 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 ins information
1ab40 75 73 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 used by the sqli
1ab50 74 65 46 69 78 2e 2e 2e 0a 2a 2a 20 72 6f 75 74 teFix....** rout
1ab60 69 6e 65 73 20 61 73 20 74 68 65 79 20 77 61 6c ines as they wal
1ab70 6b 20 74 68 65 20 70 61 72 73 65 20 74 72 65 65 k the parse tree
1ab80 20 74 6f 20 6d 61 6b 65 20 64 61 74 61 62 61 73 to make databas
1ab90 65 20 72 65 66 65 72 65 6e 63 65 73 0a 2a 2a 20 e references.**
1aba0 65 78 70 6c 69 63 69 74 2e 20 20 0a 2a 2f 0a 74 explicit. .*/.t
1abb0 79 70 65 64 65 66 20 73 74 72 75 63 74 20 44 62 ypedef struct Db
1abc0 46 69 78 65 72 20 44 62 46 69 78 65 72 3b 0a 73 Fixer DbFixer;.s
1abd0 74 72 75 63 74 20 44 62 46 69 78 65 72 20 7b 0a truct DbFixer {.
1abe0 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b Parse *pParse;
1abf0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 72 /* The par
1ac00 73 69 6e 67 20 63 6f 6e 74 65 78 74 2e 20 20 45 sing context. E
1ac10 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 77 72 rror messages wr
1ac20 69 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a 20 20 itten here */.
1ac30 53 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b Schema *pSchema;
1ac40 20 20 20 20 2f 2a 20 46 69 78 20 69 74 65 6d 73 /* Fix items
1ac50 20 74 6f 20 74 68 69 73 20 73 63 68 65 6d 61 20 to this schema
1ac60 2a 2f 0a 20 20 69 6e 74 20 62 56 61 72 4f 6e 6c */. int bVarOnl
1ac70 79 3b 20 20 20 20 20 20 20 2f 2a 20 43 68 65 63 y; /* Chec
1ac80 6b 20 66 6f 72 20 76 61 72 69 61 62 6c 65 20 72 k for variable r
1ac90 65 66 65 72 65 6e 63 65 73 20 6f 6e 6c 79 20 2a eferences only *
1aca0 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
1acb0 7a 44 62 3b 20 20 20 20 2f 2a 20 4d 61 6b 65 20 zDb; /* Make
1acc0 73 75 72 65 20 61 6c 6c 20 6f 62 6a 65 63 74 73 sure all objects
1acd0 20 61 72 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 are contained i
1ace0 6e 20 74 68 69 73 20 64 61 74 61 62 61 73 65 20 n this database
1acf0 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
1ad00 2a 7a 54 79 70 65 3b 20 20 2f 2a 20 54 79 70 65 *zType; /* Type
1ad10 20 6f 66 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 of the containe
1ad20 72 20 2d 20 75 73 65 64 20 66 6f 72 20 65 72 72 r - used for err
1ad30 6f 72 20 6d 65 73 73 61 67 65 73 20 2a 2f 0a 20 or messages */.
1ad40 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 20 2a 70 4e const Token *pN
1ad50 61 6d 65 3b 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 ame; /* Name of
1ad60 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 2d 20 the container -
1ad70 75 73 65 64 20 66 6f 72 20 65 72 72 6f 72 20 6d used for error m
1ad80 65 73 73 61 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f essages */.};../
1ad90 2a 0a 2a 2a 20 41 6e 20 6f 62 6a 65 63 74 65 64 *.** An objected
1ada0 20 75 73 65 64 20 74 6f 20 61 63 63 75 6d 75 6c used to accumul
1adb0 61 74 65 20 74 68 65 20 74 65 78 74 20 6f 66 20 ate the text of
1adc0 61 20 73 74 72 69 6e 67 20 77 68 65 72 65 20 77 a string where w
1add0 65 0a 2a 2a 20 64 6f 20 6e 6f 74 20 6e 65 63 65 e.** do not nece
1ade0 73 73 61 72 69 6c 79 20 6b 6e 6f 77 20 68 6f 77 ssarily know how
1adf0 20 62 69 67 20 74 68 65 20 73 74 72 69 6e 67 20 big the string
1ae00 77 69 6c 6c 20 62 65 20 69 6e 20 74 68 65 20 65 will be in the e
1ae10 6e 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 74 nd..*/.struct St
1ae20 72 41 63 63 75 6d 20 7b 0a 20 20 73 71 6c 69 74 rAccum {. sqlit
1ae30 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 20 e3 *db;
1ae40 2f 2a 20 4f 70 74 69 6f 6e 61 6c 20 64 61 74 61 /* Optional data
1ae50 62 61 73 65 20 66 6f 72 20 6c 6f 6f 6b 61 73 69 base for lookasi
1ae60 64 65 2e 20 20 43 61 6e 20 62 65 20 4e 55 4c 4c de. Can be NULL
1ae70 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 42 61 73 */. char *zBas
1ae80 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 e; /* A
1ae90 62 61 73 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e base allocation.
1aea0 20 20 4e 6f 74 20 66 72 6f 6d 20 6d 61 6c 6c 6f Not from mallo
1aeb0 63 2e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 c. */. char *zT
1aec0 65 78 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ext; /*
1aed0 54 68 65 20 73 74 72 69 6e 67 20 63 6f 6c 6c 65 The string colle
1aee0 63 74 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 cted so far */.
1aef0 20 69 6e 74 20 20 6e 43 68 61 72 3b 20 20 20 20 int nChar;
1af00 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 /* Length
1af10 6f 66 20 74 68 65 20 73 74 72 69 6e 67 20 73 6f of the string so
1af20 20 66 61 72 20 2a 2f 0a 20 20 69 6e 74 20 20 6e far */. int n
1af30 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 20 2f Alloc; /
1af40 2a 20 41 6d 6f 75 6e 74 20 6f 66 20 73 70 61 63 * Amount of spac
1af50 65 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 7a e allocated in z
1af60 54 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 20 6d Text */. int m
1af70 78 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 20 2f xAlloc; /
1af80 2a 20 4d 61 78 69 6d 75 6d 20 61 6c 6c 6f 77 65 * Maximum allowe
1af90 64 20 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 d string length
1afa0 2a 2f 0a 20 20 75 38 20 20 20 75 73 65 4d 61 6c */. u8 useMal
1afb0 6c 6f 63 3b 20 20 20 20 20 20 2f 2a 20 30 3a 20 loc; /* 0:
1afc0 6e 6f 6e 65 2c 20 20 31 3a 20 73 71 6c 69 74 65 none, 1: sqlite
1afd0 33 44 62 4d 61 6c 6c 6f 63 2c 20 20 32 3a 20 73 3DbMalloc, 2: s
1afe0 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 20 2a 2f qlite3_malloc */
1aff0 0a 20 20 75 38 20 20 20 61 63 63 45 72 72 6f 72 . u8 accError
1b000 3b 20 20 20 20 20 20 20 2f 2a 20 53 54 52 41 43 ; /* STRAC
1b010 43 55 4d 5f 4e 4f 4d 45 4d 20 6f 72 20 53 54 52 CUM_NOMEM or STR
1b020 41 43 43 55 4d 5f 54 4f 4f 42 49 47 20 2a 2f 0a ACCUM_TOOBIG */.
1b030 7d 3b 0a 23 64 65 66 69 6e 65 20 53 54 52 41 43 };.#define STRAC
1b040 43 55 4d 5f 4e 4f 4d 45 4d 20 20 20 31 0a 23 64 CUM_NOMEM 1.#d
1b050 65 66 69 6e 65 20 53 54 52 41 43 43 55 4d 5f 54 efine STRACCUM_T
1b060 4f 4f 42 49 47 20 20 32 0a 0a 2f 2a 0a 2a 2a 20 OOBIG 2../*.**
1b070 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 A pointer to thi
1b080 73 20 73 74 72 75 63 74 75 72 65 20 69 73 20 75 s structure is u
1b090 73 65 64 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 sed to communica
1b0a0 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a te information.*
1b0b0 2a 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 49 6e * from sqlite3In
1b0c0 69 74 20 61 6e 64 20 4f 50 5f 50 61 72 73 65 53 it and OP_ParseS
1b0d0 63 68 65 6d 61 20 69 6e 74 6f 20 74 68 65 20 73 chema into the s
1b0e0 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 qlite3InitCallba
1b0f0 63 6b 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 ck..*/.typedef s
1b100 74 72 75 63 74 20 7b 0a 20 20 73 71 6c 69 74 65 truct {. sqlite
1b110 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 2f 2a 3 *db; /*
1b120 20 54 68 65 20 64 61 74 61 62 61 73 65 20 62 65 The database be
1b130 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 ing initialized
1b140 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 */. char **pzEr
1b150 72 4d 73 67 3b 20 20 20 20 2f 2a 20 45 72 72 6f rMsg; /* Erro
1b160 72 20 6d 65 73 73 61 67 65 20 73 74 6f 72 65 64 r message stored
1b170 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 69 here */. int i
1b180 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f Db; /
1b190 2a 20 30 20 66 6f 72 20 6d 61 69 6e 20 64 61 74 * 0 for main dat
1b1a0 61 62 61 73 65 2e 20 20 31 20 66 6f 72 20 54 45 abase. 1 for TE
1b1b0 4d 50 2c 20 32 2e 2e 20 66 6f 72 20 41 54 54 41 MP, 2.. for ATTA
1b1c0 43 48 65 64 20 2a 2f 0a 20 20 69 6e 74 20 72 63 CHed */. int rc
1b1d0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
1b1e0 20 52 65 73 75 6c 74 20 63 6f 64 65 20 73 74 6f Result code sto
1b1f0 72 65 64 20 68 65 72 65 20 2a 2f 0a 7d 20 49 6e red here */.} In
1b200 69 74 44 61 74 61 3b 0a 0a 2f 2a 0a 2a 2a 20 53 itData;../*.** S
1b210 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e tructure contain
1b220 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 69 ing global confi
1b230 67 75 72 61 74 69 6f 6e 20 64 61 74 61 20 66 6f guration data fo
1b240 72 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 r the SQLite lib
1b250 72 61 72 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 rary..**.** This
1b260 20 73 74 72 75 63 74 75 72 65 20 61 6c 73 6f 20 structure also
1b270 63 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 73 74 contains some st
1b280 61 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e ate information.
1b290 0a 2a 2f 0a 73 74 72 75 63 74 20 53 71 6c 69 74 .*/.struct Sqlit
1b2a0 65 33 43 6f 6e 66 69 67 20 7b 0a 20 20 69 6e 74 e3Config {. int
1b2b0 20 62 4d 65 6d 73 74 61 74 3b 20 20 20 20 20 20 bMemstat;
1b2c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1b2d0 2a 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 * True to enable
1b2e0 20 6d 65 6d 6f 72 79 20 73 74 61 74 75 73 20 2a memory status *
1b2f0 2f 0a 20 20 69 6e 74 20 62 43 6f 72 65 4d 75 74 /. int bCoreMut
1b300 65 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ex;
1b310 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f /* True to
1b320 20 65 6e 61 62 6c 65 20 63 6f 72 65 20 6d 75 74 enable core mut
1b330 65 78 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 exing */. int b
1b340 46 75 6c 6c 4d 75 74 65 78 3b 20 20 20 20 20 20 FullMutex;
1b350 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1b360 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 66 True to enable f
1b370 75 6c 6c 20 6d 75 74 65 78 69 6e 67 20 2a 2f 0a ull mutexing */.
1b380 20 20 69 6e 74 20 62 4f 70 65 6e 55 72 69 3b 20 int bOpenUri;
1b390 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b3a0 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 69 /* True to i
1b3b0 6e 74 65 72 70 72 65 74 20 66 69 6c 65 6e 61 6d nterpret filenam
1b3c0 65 73 20 61 73 20 55 52 49 73 20 2a 2f 0a 20 20 es as URIs */.
1b3d0 69 6e 74 20 62 55 73 65 43 69 73 3b 20 20 20 20 int bUseCis;
1b3e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b3f0 20 20 2f 2a 20 55 73 65 20 63 6f 76 65 72 69 6e /* Use coverin
1b400 67 20 69 6e 64 69 63 65 73 20 66 6f 72 20 66 75 g indices for fu
1b410 6c 6c 2d 73 63 61 6e 73 20 2a 2f 0a 20 20 69 6e ll-scans */. in
1b420 74 20 6d 78 53 74 72 6c 65 6e 3b 20 20 20 20 20 t mxStrlen;
1b430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b440 2f 2a 20 4d 61 78 69 6d 75 6d 20 73 74 72 69 6e /* Maximum strin
1b450 67 20 6c 65 6e 67 74 68 20 2a 2f 0a 20 20 69 6e g length */. in
1b460 74 20 6e 65 76 65 72 43 6f 72 72 75 70 74 3b 20 t neverCorrupt;
1b470 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b480 2f 2a 20 44 61 74 61 62 61 73 65 20 69 73 20 61 /* Database is a
1b490 6c 77 61 79 73 20 77 65 6c 6c 2d 66 6f 72 6d 65 lways well-forme
1b4a0 64 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 4c 6f 6f d */. int szLoo
1b4b0 6b 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 kaside;
1b4c0 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 /* Defa
1b4d0 75 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 ult lookaside bu
1b4e0 66 66 65 72 20 73 69 7a 65 20 2a 2f 0a 20 20 69 ffer size */. i
1b4f0 6e 74 20 6e 4c 6f 6f 6b 61 73 69 64 65 3b 20 20 nt nLookaside;
1b500 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b510 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b /* Default look
1b520 61 73 69 64 65 20 62 75 66 66 65 72 20 63 6f 75 aside buffer cou
1b530 6e 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f nt */. sqlite3_
1b540 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 6d 3b 20 20 mem_methods m;
1b550 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 77 /* Low
1b560 2d 6c 65 76 65 6c 20 6d 65 6d 6f 72 79 20 61 6c -level memory al
1b570 6c 6f 63 61 74 69 6f 6e 20 69 6e 74 65 72 66 61 location interfa
1b580 63 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ce */. sqlite3_
1b590 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 6d 75 mutex_methods mu
1b5a0 74 65 78 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 77 tex; /* Low
1b5b0 2d 6c 65 76 65 6c 20 6d 75 74 65 78 20 69 6e 74 -level mutex int
1b5c0 65 72 66 61 63 65 20 2a 2f 0a 20 20 73 71 6c 69 erface */. sqli
1b5d0 74 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f te3_pcache_metho
1b5e0 64 73 32 20 70 63 61 63 68 65 32 3b 20 20 2f 2a ds2 pcache2; /*
1b5f0 20 4c 6f 77 2d 6c 65 76 65 6c 20 70 61 67 65 2d Low-level page-
1b600 63 61 63 68 65 20 69 6e 74 65 72 66 61 63 65 20 cache interface
1b610 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 48 65 61 70 */. void *pHeap
1b620 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1b630 20 20 20 20 20 20 20 2f 2a 20 48 65 61 70 20 73 /* Heap s
1b640 74 6f 72 61 67 65 20 73 70 61 63 65 20 2a 2f 0a torage space */.
1b650 20 20 69 6e 74 20 6e 48 65 61 70 3b 20 20 20 20 int nHeap;
1b660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b670 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 70 /* Size of p
1b680 48 65 61 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 Heap[] */. int
1b690 6d 6e 52 65 71 2c 20 6d 78 52 65 71 3b 20 20 20 mnReq, mxReq;
1b6a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1b6b0 20 4d 69 6e 20 61 6e 64 20 6d 61 78 20 68 65 61 Min and max hea
1b6c0 70 20 72 65 71 75 65 73 74 73 20 73 69 7a 65 73 p requests sizes
1b6d0 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e */. sqlite3_in
1b6e0 74 36 34 20 73 7a 4d 6d 61 70 3b 20 20 20 20 20 t64 szMmap;
1b6f0 20 20 20 20 20 20 20 20 2f 2a 20 6d 6d 61 70 28 /* mmap(
1b700 29 20 73 70 61 63 65 20 70 65 72 20 6f 70 65 6e ) space per open
1b710 20 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74 file */. sqlit
1b720 65 33 5f 69 6e 74 36 34 20 6d 78 4d 6d 61 70 3b e3_int64 mxMmap;
1b730 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1b740 4d 61 78 69 6d 75 6d 20 76 61 6c 75 65 20 66 6f Maximum value fo
1b750 72 20 73 7a 4d 6d 61 70 20 2a 2f 0a 20 20 76 6f r szMmap */. vo
1b760 69 64 20 2a 70 53 63 72 61 74 63 68 3b 20 20 20 id *pScratch;
1b770 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b780 2f 2a 20 53 63 72 61 74 63 68 20 6d 65 6d 6f 72 /* Scratch memor
1b790 79 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 53 63 72 y */. int szScr
1b7a0 61 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 atch;
1b7b0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
1b7c0 20 6f 66 20 65 61 63 68 20 73 63 72 61 74 63 68 of each scratch
1b7d0 20 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 buffer */. int
1b7e0 20 6e 53 63 72 61 74 63 68 3b 20 20 20 20 20 20 nScratch;
1b7f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1b800 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 63 72 61 * Number of scra
1b810 74 63 68 20 62 75 66 66 65 72 73 20 2a 2f 0a 20 tch buffers */.
1b820 20 76 6f 69 64 20 2a 70 50 61 67 65 3b 20 20 20 void *pPage;
1b830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b840 20 20 20 2f 2a 20 50 61 67 65 20 63 61 63 68 65 /* Page cache
1b850 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69 6e 74 memory */. int
1b860 20 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 szPage;
1b870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1b880 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 70 * Size of each p
1b890 61 67 65 20 69 6e 20 70 50 61 67 65 5b 5d 20 2a age in pPage[] *
1b8a0 2f 0a 20 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 /. int nPage;
1b8b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b8c0 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
1b8d0 6f 66 20 70 61 67 65 73 20 69 6e 20 70 50 61 67 of pages in pPag
1b8e0 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 50 e[] */. int mxP
1b8f0 61 72 73 65 72 53 74 61 63 6b 3b 20 20 20 20 20 arserStack;
1b900 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 6d 61 /* ma
1b910 78 69 6d 75 6d 20 64 65 70 74 68 20 6f 66 20 74 ximum depth of t
1b920 68 65 20 70 61 72 73 65 72 20 73 74 61 63 6b 20 he parser stack
1b930 2a 2f 0a 20 20 69 6e 74 20 73 68 61 72 65 64 43 */. int sharedC
1b940 61 63 68 65 45 6e 61 62 6c 65 64 3b 20 20 20 20 acheEnabled;
1b950 20 20 20 20 20 20 20 2f 2a 20 74 72 75 65 20 69 /* true i
1b960 66 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d f shared-cache m
1b970 6f 64 65 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 ode enabled */.
1b980 20 2f 2a 20 54 68 65 20 61 62 6f 76 65 20 6d 69 /* The above mi
1b990 67 68 74 20 62 65 20 69 6e 69 74 69 61 6c 69 7a ght be initializ
1b9a0 65 64 20 74 6f 20 6e 6f 6e 2d 7a 65 72 6f 2e 20 ed to non-zero.
1b9b0 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6e The following n
1b9c0 65 65 64 20 74 6f 20 61 6c 77 61 79 73 0a 20 20 eed to always.
1b9d0 2a 2a 20 69 6e 69 74 69 61 6c 6c 79 20 62 65 20 ** initially be
1b9e0 7a 65 72 6f 2c 20 68 6f 77 65 76 65 72 2e 20 2a zero, however. *
1b9f0 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b 20 /. int isInit;
1ba00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ba10 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 66 /* True af
1ba20 74 65 72 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 ter initializati
1ba30 6f 6e 20 68 61 73 20 66 69 6e 69 73 68 65 64 20 on has finished
1ba40 2a 2f 0a 20 20 69 6e 74 20 69 6e 50 72 6f 67 72 */. int inProgr
1ba50 65 73 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ess;
1ba60 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 77 /* True w
1ba70 68 69 6c 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 hile initializat
1ba80 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 20 ion in progress
1ba90 2a 2f 0a 20 20 69 6e 74 20 69 73 4d 75 74 65 78 */. int isMutex
1baa0 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 Init;
1bab0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 /* True a
1bac0 66 74 65 72 20 6d 75 74 65 78 65 73 20 61 72 65 fter mutexes are
1bad0 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a initialized */.
1bae0 20 20 69 6e 74 20 69 73 4d 61 6c 6c 6f 63 49 6e int isMallocIn
1baf0 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 it;
1bb00 20 20 20 20 2f 2a 20 54 72 75 65 20 61 66 74 65 /* True afte
1bb10 72 20 6d 61 6c 6c 6f 63 20 69 73 20 69 6e 69 74 r malloc is init
1bb20 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 ialized */. int
1bb30 20 69 73 50 43 61 63 68 65 49 6e 69 74 3b 20 20 isPCacheInit;
1bb40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1bb50 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 61 6c * True after mal
1bb60 6c 6f 63 20 69 73 20 69 6e 69 74 69 61 6c 69 7a loc is initializ
1bb70 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ed */. sqlite3_
1bb80 6d 75 74 65 78 20 2a 70 49 6e 69 74 4d 75 74 65 mutex *pInitMute
1bb90 78 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 x; /* Mut
1bba0 65 78 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 ex used by sqlit
1bbb0 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 e3_initialize()
1bbc0 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 49 6e 69 */. int nRefIni
1bbd0 74 4d 75 74 65 78 3b 20 20 20 20 20 20 20 20 20 tMutex;
1bbe0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1bbf0 20 6f 66 20 75 73 65 72 73 20 6f 66 20 70 49 6e of users of pIn
1bc00 69 74 4d 75 74 65 78 20 2a 2f 0a 20 20 76 6f 69 itMutex */. voi
1bc10 64 20 28 2a 78 4c 6f 67 29 28 76 6f 69 64 2a 2c d (*xLog)(void*,
1bc20 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 int,const char*)
1bc30 3b 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 66 6f ; /* Function fo
1bc40 72 20 6c 6f 67 67 69 6e 67 20 2a 2f 0a 20 20 76 r logging */. v
1bc50 6f 69 64 20 2a 70 4c 6f 67 41 72 67 3b 20 20 20 oid *pLogArg;
1bc60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1bc70 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
1bc80 75 6d 65 6e 74 20 74 6f 20 78 4c 6f 67 28 29 20 ument to xLog()
1bc90 2a 2f 0a 20 20 69 6e 74 20 62 4c 6f 63 61 6c 74 */. int bLocalt
1bca0 69 6d 65 46 61 75 6c 74 3b 20 20 20 20 20 20 20 imeFault;
1bcb0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 /* True t
1bcc0 6f 20 66 61 69 6c 20 6c 6f 63 61 6c 74 69 6d 65 o fail localtime
1bcd0 28 29 20 63 61 6c 6c 73 20 2a 2f 0a 23 69 66 64 () calls */.#ifd
1bce0 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
1bcf0 5f 53 51 4c 4c 4f 47 0a 20 20 76 6f 69 64 28 2a _SQLLOG. void(*
1bd00 78 53 71 6c 6c 6f 67 29 28 76 6f 69 64 2a 2c 73 xSqllog)(void*,s
1bd10 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
1bd20 61 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 ar*, int);. voi
1bd30 64 20 2a 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 23 d *pSqllogArg;.#
1bd40 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 endif.};../*.**
1bd50 54 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 This macro is us
1bd60 65 64 20 69 6e 73 69 64 65 20 6f 66 20 61 73 73 ed inside of ass
1bd70 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
1bd80 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 to indicate tha
1bd90 74 0a 2a 2a 20 74 68 65 20 61 73 73 65 72 74 20 t.** the assert
1bda0 69 73 20 6f 6e 6c 79 20 76 61 6c 69 64 20 6f 6e is only valid on
1bdb0 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 20 64 a well-formed d
1bdc0 61 74 61 62 61 73 65 2e 20 20 49 6e 73 74 65 61 atabase. Instea
1bdd0 64 20 6f 66 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 d of:.**.**
1bde0 61 73 73 65 72 74 28 20 58 20 29 3b 0a 2a 2a 0a assert( X );.**.
1bdf0 2a 2a 20 4f 6e 65 20 77 72 69 74 65 73 3a 0a 2a ** One writes:.*
1be00 2a 0a 2a 2a 20 20 20 20 20 61 73 73 65 72 74 28 *.** assert(
1be10 20 58 20 7c 7c 20 43 4f 52 52 55 50 54 5f 44 42 X || CORRUPT_DB
1be20 20 29 3b 0a 2a 2a 0a 2a 2a 20 43 4f 52 52 55 50 );.**.** CORRUP
1be30 54 5f 44 42 20 69 73 20 74 72 75 65 20 64 75 72 T_DB is true dur
1be40 69 6e 67 20 6e 6f 72 6d 61 6c 20 6f 70 65 72 61 ing normal opera
1be50 74 69 6f 6e 2e 20 20 43 4f 52 52 55 50 54 5f 44 tion. CORRUPT_D
1be60 42 20 64 6f 65 73 20 6e 6f 74 20 69 6e 64 69 63 B does not indic
1be70 61 74 65 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 ate.** that the
1be80 64 61 74 61 62 61 73 65 20 69 73 20 64 65 66 69 database is defi
1be90 6e 69 74 65 6c 79 20 63 6f 72 72 75 70 74 2c 20 nitely corrupt,
1bea0 6f 6e 6c 79 20 74 68 61 74 20 69 74 20 6d 69 67 only that it mig
1beb0 68 74 20 62 65 20 63 6f 72 72 75 70 74 2e 0a 2a ht be corrupt..*
1bec0 2a 20 46 6f 72 20 6d 6f 73 74 20 74 65 73 74 20 * For most test
1bed0 63 61 73 65 73 2c 20 43 4f 52 52 55 50 54 5f 44 cases, CORRUPT_D
1bee0 42 20 69 73 20 73 65 74 20 74 6f 20 66 61 6c 73 B is set to fals
1bef0 65 20 75 73 69 6e 67 20 61 20 73 70 65 63 69 61 e using a specia
1bf00 6c 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 74 65 73 l.** sqlite3_tes
1bf10 74 5f 63 6f 6e 74 72 6f 6c 28 29 2e 20 20 54 68 t_control(). Th
1bf20 69 73 20 65 6e 61 62 6c 65 73 20 61 73 73 65 72 is enables asser
1bf30 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 74 t() statements t
1bf40 6f 20 70 72 6f 76 65 0a 2a 2a 20 74 68 69 6e 67 o prove.** thing
1bf50 73 20 74 68 61 74 20 61 72 65 20 61 6c 77 61 79 s that are alway
1bf60 73 20 74 72 75 65 20 66 6f 72 20 77 65 6c 6c 2d s true for well-
1bf70 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 73 formed databases
1bf80 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f 52 ..*/.#define COR
1bf90 52 55 50 54 5f 44 42 20 20 28 73 71 6c 69 74 65 RUPT_DB (sqlite
1bfa0 33 43 6f 6e 66 69 67 2e 6e 65 76 65 72 43 6f 72 3Config.neverCor
1bfb0 72 75 70 74 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 rupt==0)../*.**
1bfc0 43 6f 6e 74 65 78 74 20 70 6f 69 6e 74 65 72 20 Context pointer
1bfd0 70 61 73 73 65 64 20 64 6f 77 6e 20 74 68 72 6f passed down thro
1bfe0 75 67 68 20 74 68 65 20 74 72 65 65 2d 77 61 6c ugh the tree-wal
1bff0 6b 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 57 61 6c k..*/.struct Wal
1c000 6b 65 72 20 7b 0a 20 20 69 6e 74 20 28 2a 78 45 ker {. int (*xE
1c010 78 70 72 43 61 6c 6c 62 61 63 6b 29 28 57 61 6c xprCallback)(Wal
1c020 6b 65 72 2a 2c 20 45 78 70 72 2a 29 3b 20 20 20 ker*, Expr*);
1c030 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 6f /* Callback fo
1c040 72 20 65 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f r expressions */
1c050 0a 20 20 69 6e 74 20 28 2a 78 53 65 6c 65 63 74 . int (*xSelect
1c060 43 61 6c 6c 62 61 63 6b 29 28 57 61 6c 6b 65 72 Callback)(Walker
1c070 2a 2c 53 65 6c 65 63 74 2a 29 3b 20 20 2f 2a 20 *,Select*); /*
1c080 43 61 6c 6c 62 61 63 6b 20 66 6f 72 20 53 45 4c Callback for SEL
1c090 45 43 54 73 20 2a 2f 0a 20 20 50 61 72 73 65 20 ECTs */. Parse
1c0a0 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 20 20 *pParse;
1c0b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c0c0 20 20 20 20 2f 2a 20 50 61 72 73 65 72 20 63 6f /* Parser co
1c0d0 6e 74 65 78 74 2e 20 20 2a 2f 0a 20 20 69 6e 74 ntext. */. int
1c0e0 20 77 61 6c 6b 65 72 44 65 70 74 68 3b 20 20 20 walkerDepth;
1c0f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c100 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1c110 20 6f 66 20 73 75 62 71 75 65 72 69 65 73 20 2a of subqueries *
1c120 2f 0a 20 20 75 38 20 62 53 65 6c 65 63 74 44 65 /. u8 bSelectDe
1c130 70 74 68 46 69 72 73 74 3b 20 20 20 20 20 20 20 pthFirst;
1c140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1c150 20 44 6f 20 73 75 62 71 75 65 72 69 65 73 20 66 Do subqueries f
1c160 69 72 73 74 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 irst */. union
1c170 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
1c180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c190 20 20 20 20 2f 2a 20 45 78 74 72 61 20 64 61 74 /* Extra dat
1c1a0 61 20 66 6f 72 20 63 61 6c 6c 62 61 63 6b 20 2a a for callback *
1c1b0 2f 0a 20 20 20 20 4e 61 6d 65 43 6f 6e 74 65 78 /. NameContex
1c1c0 74 20 2a 70 4e 43 3b 20 20 20 20 20 20 20 20 20 t *pNC;
1c1d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c1e0 20 2f 2a 20 4e 61 6d 69 6e 67 20 63 6f 6e 74 65 /* Naming conte
1c1f0 78 74 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 3b xt */. int i;
1c200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c220 20 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 /* Integer
1c230 76 61 6c 75 65 20 2a 2f 0a 20 20 20 20 53 72 63 value */. Src
1c240 4c 69 73 74 20 2a 70 53 72 63 4c 69 73 74 3b 20 List *pSrcList;
1c250 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c260 20 20 20 20 20 20 20 20 2f 2a 20 46 52 4f 4d 20 /* FROM
1c270 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 73 74 clause */. st
1c280 72 75 63 74 20 53 72 63 43 6f 75 6e 74 20 2a 70 ruct SrcCount *p
1c290 53 72 63 43 6f 75 6e 74 3b 20 20 20 20 20 20 20 SrcCount;
1c2a0 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 75 6e /* Coun
1c2b0 74 69 6e 67 20 63 6f 6c 75 6d 6e 20 72 65 66 65 ting column refe
1c2c0 72 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 75 3b rences */. } u;
1c2d0 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 .};../* Forward
1c2e0 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 2a 2f 0a declarations */.
1c2f0 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 6b 45 int sqlite3WalkE
1c300 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 xpr(Walker*, Exp
1c310 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
1c320 57 61 6c 6b 45 78 70 72 4c 69 73 74 28 57 61 6c WalkExprList(Wal
1c330 6b 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 ker*, ExprList*)
1c340 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c ;.int sqlite3Wal
1c350 6b 53 65 6c 65 63 74 28 57 61 6c 6b 65 72 2a 2c kSelect(Walker*,
1c360 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 Select*);.int s
1c370 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 qlite3WalkSelect
1c380 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 53 65 Expr(Walker*, Se
1c390 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 lect*);.int sqli
1c3a0 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 46 72 6f te3WalkSelectFro
1c3b0 6d 28 57 61 6c 6b 65 72 2a 2c 20 53 65 6c 65 63 m(Walker*, Selec
1c3c0 74 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 t*);../*.** Retu
1c3d0 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 74 68 65 rn code from the
1c3e0 20 70 61 72 73 65 2d 74 72 65 65 20 77 61 6c 6b parse-tree walk
1c3f0 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 20 61 ing primitives a
1c400 6e 64 20 74 68 65 69 72 0a 2a 2a 20 63 61 6c 6c nd their.** call
1c410 62 61 63 6b 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e backs..*/.#defin
1c420 65 20 57 52 43 5f 43 6f 6e 74 69 6e 75 65 20 20 e WRC_Continue
1c430 20 20 30 20 20 20 2f 2a 20 43 6f 6e 74 69 6e 75 0 /* Continu
1c440 65 20 64 6f 77 6e 20 69 6e 74 6f 20 63 68 69 6c e down into chil
1c450 64 72 65 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 dren */.#define
1c460 57 52 43 5f 50 72 75 6e 65 20 20 20 20 20 20 20 WRC_Prune
1c470 31 20 20 20 2f 2a 20 4f 6d 69 74 20 63 68 69 6c 1 /* Omit chil
1c480 64 72 65 6e 20 62 75 74 20 63 6f 6e 74 69 6e 75 dren but continu
1c490 65 20 77 61 6c 6b 69 6e 67 20 73 69 62 6c 69 6e e walking siblin
1c4a0 67 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 52 gs */.#define WR
1c4b0 43 5f 41 62 6f 72 74 20 20 20 20 20 20 20 32 20 C_Abort 2
1c4c0 20 20 2f 2a 20 41 62 61 6e 64 6f 6e 20 74 68 65 /* Abandon the
1c4d0 20 74 72 65 65 20 77 61 6c 6b 20 2a 2f 0a 0a 2f tree walk */../
1c4e0 2a 0a 2a 2a 20 41 73 73 75 6d 69 6e 67 20 7a 49 *.** Assuming zI
1c4f0 6e 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 20 n points to the
1c500 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 61 20 first byte of a
1c510 55 54 46 2d 38 20 63 68 61 72 61 63 74 65 72 2c UTF-8 character,
1c520 0a 2a 2a 20 61 64 76 61 6e 63 65 20 7a 49 6e 20 .** advance zIn
1c530 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 to point to the
1c540 66 69 72 73 74 20 62 79 74 65 20 6f 66 20 74 68 first byte of th
1c550 65 20 6e 65 78 74 20 55 54 46 2d 38 20 63 68 61 e next UTF-8 cha
1c560 72 61 63 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 racter..*/.#defi
1c570 6e 65 20 53 51 4c 49 54 45 5f 53 4b 49 50 5f 55 ne SQLITE_SKIP_U
1c580 54 46 38 28 7a 49 6e 29 20 7b 20 20 20 20 20 20 TF8(zIn) {
1c590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c5a0 20 20 5c 0a 20 20 69 66 28 20 28 2a 28 7a 49 6e \. if( (*(zIn
1c5b0 2b 2b 29 29 3e 3d 30 78 63 30 20 29 7b 20 20 20 ++))>=0xc0 ){
1c5c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c5d0 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 20 \.
1c5e0 20 77 68 69 6c 65 28 20 28 2a 7a 49 6e 20 26 20 while( (*zIn &
1c5f0 30 78 63 30 29 3d 3d 30 78 38 30 20 29 7b 20 7a 0xc0)==0x80 ){ z
1c600 49 6e 2b 2b 3b 20 7d 20 20 20 20 20 20 20 20 20 In++; }
1c610 20 20 20 20 5c 0a 20 20 7d 20 20 20 20 20 20 20 \. }
1c620 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c640 20 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 7d \.}
1c650 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 ../*.** The SQLI
1c660 54 45 5f 2a 5f 42 4b 50 54 20 6d 61 63 72 6f 73 TE_*_BKPT macros
1c670 20 61 72 65 20 73 75 62 73 74 69 74 75 74 65 73 are substitutes
1c680 20 66 6f 72 20 74 68 65 20 65 72 72 6f 72 20 63 for the error c
1c690 6f 64 65 73 20 77 69 74 68 0a 2a 2a 20 74 68 65 odes with.** the
1c6a0 20 73 61 6d 65 20 6e 61 6d 65 20 62 75 74 20 77 same name but w
1c6b0 69 74 68 6f 75 74 20 74 68 65 20 5f 42 4b 50 54 ithout the _BKPT
1c6c0 20 73 75 66 66 69 78 2e 20 20 54 68 65 73 65 20 suffix. These
1c6d0 6d 61 63 72 6f 73 20 69 6e 76 6f 6b 65 0a 2a 2a macros invoke.**
1c6e0 20 72 6f 75 74 69 6e 65 73 20 74 68 61 74 20 72 routines that r
1c6f0 65 70 6f 72 74 20 74 68 65 20 6c 69 6e 65 2d 6e eport the line-n
1c700 75 6d 62 65 72 20 6f 6e 20 77 68 69 63 68 20 74 umber on which t
1c710 68 65 20 65 72 72 6f 72 20 6f 72 69 67 69 6e 61 he error origina
1c720 74 65 64 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c ted.** using sql
1c730 69 74 65 33 5f 6c 6f 67 28 29 2e 20 20 54 68 65 ite3_log(). The
1c740 20 72 6f 75 74 69 6e 65 73 20 61 6c 73 6f 20 70 routines also p
1c750 72 6f 76 69 64 65 20 61 20 63 6f 6e 76 65 6e 69 rovide a conveni
1c760 65 6e 74 20 70 6c 61 63 65 0a 2a 2a 20 74 6f 20 ent place.** to
1c770 73 65 74 20 61 20 64 65 62 75 67 67 65 72 20 62 set a debugger b
1c780 72 65 61 6b 70 6f 69 6e 74 2e 0a 2a 2f 0a 69 6e reakpoint..*/.in
1c790 74 20 73 71 6c 69 74 65 33 43 6f 72 72 75 70 74 t sqlite3Corrupt
1c7a0 45 72 72 6f 72 28 69 6e 74 29 3b 0a 69 6e 74 20 Error(int);.int
1c7b0 73 71 6c 69 74 65 33 4d 69 73 75 73 65 45 72 72 sqlite3MisuseErr
1c7c0 6f 72 28 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c or(int);.int sql
1c7d0 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 72 6f ite3CantopenErro
1c7e0 72 28 69 6e 74 29 3b 0a 23 64 65 66 69 6e 65 20 r(int);.#define
1c7f0 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
1c800 4b 50 54 20 73 71 6c 69 74 65 33 43 6f 72 72 75 KPT sqlite3Corru
1c810 70 74 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f ptError(__LINE__
1c820 29 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 ).#define SQLITE
1c830 5f 4d 49 53 55 53 45 5f 42 4b 50 54 20 73 71 6c _MISUSE_BKPT sql
1c840 69 74 65 33 4d 69 73 75 73 65 45 72 72 6f 72 28 ite3MisuseError(
1c850 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e __LINE__).#defin
1c860 65 20 53 51 4c 49 54 45 5f 43 41 4e 54 4f 50 45 e SQLITE_CANTOPE
1c870 4e 5f 42 4b 50 54 20 73 71 6c 69 74 65 33 43 61 N_BKPT sqlite3Ca
1c880 6e 74 6f 70 65 6e 45 72 72 6f 72 28 5f 5f 4c 49 ntopenError(__LI
1c890 4e 45 5f 5f 29 0a 0a 0a 2f 2a 0a 2a 2a 20 46 54 NE__).../*.** FT
1c8a0 53 34 20 69 73 20 72 65 61 6c 6c 79 20 61 6e 20 S4 is really an
1c8b0 65 78 74 65 6e 73 69 6f 6e 20 66 6f 72 20 46 54 extension for FT
1c8c0 53 33 2e 20 20 49 74 20 69 73 20 65 6e 61 62 6c S3. It is enabl
1c8d0 65 64 20 75 73 69 6e 67 20 74 68 65 0a 2a 2a 20 ed using the.**
1c8e0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 SQLITE_ENABLE_FT
1c8f0 53 33 20 6d 61 63 72 6f 2e 20 20 42 75 74 20 74 S3 macro. But t
1c900 6f 20 61 76 6f 69 64 20 63 6f 6e 66 75 73 69 6f o avoid confusio
1c910 6e 20 77 65 20 61 6c 73 6f 20 61 6c 6c 0a 2a 2a n we also all.**
1c920 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 the SQLITE_ENAB
1c930 4c 45 5f 46 54 53 34 20 6d 61 63 72 6f 20 74 6f LE_FTS4 macro to
1c940 20 73 65 72 76 65 20 61 73 20 61 6e 20 61 6c 69 serve as an ali
1c950 73 73 65 20 66 6f 72 20 53 51 4c 49 54 45 5f 45 sse for SQLITE_E
1c960 4e 41 42 4c 45 5f 46 54 53 33 2e 0a 2a 2f 0a 23 NABLE_FTS3..*/.#
1c970 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
1c980 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 29 20 26 E_ENABLE_FTS4) &
1c990 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 & !defined(SQLIT
1c9a0 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 29 0a 23 E_ENABLE_FTS3).#
1c9b0 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 define SQLITE_E
1c9c0 4e 41 42 4c 45 5f 46 54 53 33 0a 23 65 6e 64 69 NABLE_FTS3.#endi
1c9d0 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 63 74 79 f../*.** The cty
1c9e0 70 65 2e 68 20 68 65 61 64 65 72 20 69 73 20 6e pe.h header is n
1c9f0 65 65 64 65 64 20 66 6f 72 20 6e 6f 6e 2d 41 53 eeded for non-AS
1ca00 43 49 49 20 73 79 73 74 65 6d 73 2e 20 20 49 74 CII systems. It
1ca10 20 69 73 20 61 6c 73 6f 0a 2a 2a 20 6e 65 65 64 is also.** need
1ca20 65 64 20 62 79 20 46 54 53 33 20 77 68 65 6e 20 ed by FTS3 when
1ca30 46 54 53 33 20 69 73 20 69 6e 63 6c 75 64 65 64 FTS3 is included
1ca40 20 69 6e 20 74 68 65 20 61 6d 61 6c 67 61 6d 61 in the amalgama
1ca50 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 tion..*/.#if !de
1ca60 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 41 53 43 fined(SQLITE_ASC
1ca70 49 49 29 20 7c 7c 20 5c 0a 20 20 20 20 28 64 65 II) || \. (de
1ca80 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
1ca90 42 4c 45 5f 46 54 53 33 29 20 26 26 20 64 65 66 BLE_FTS3) && def
1caa0 69 6e 65 64 28 53 51 4c 49 54 45 5f 41 4d 41 4c ined(SQLITE_AMAL
1cab0 47 41 4d 41 54 49 4f 4e 29 29 0a 23 20 69 6e 63 GAMATION)).# inc
1cac0 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 3e 0a 23 lude <ctype.h>.#
1cad0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 endif../*.** The
1cae0 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f following macro
1caf0 73 20 6d 69 6d 69 63 20 74 68 65 20 73 74 61 6e s mimic the stan
1cb00 64 61 72 64 20 6c 69 62 72 61 72 79 20 66 75 6e dard library fun
1cb10 63 74 69 6f 6e 73 20 74 6f 75 70 70 65 72 28 29 ctions toupper()
1cb20 2c 0a 2a 2a 20 69 73 73 70 61 63 65 28 29 2c 20 ,.** isspace(),
1cb30 69 73 61 6c 6e 75 6d 28 29 2c 20 69 73 64 69 67 isalnum(), isdig
1cb40 69 74 28 29 20 61 6e 64 20 69 73 78 64 69 67 69 it() and isxdigi
1cb50 74 28 29 2c 20 72 65 73 70 65 63 74 69 76 65 6c t(), respectivel
1cb60 79 2e 20 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 y. The.** sqlite
1cb70 20 76 65 72 73 69 6f 6e 73 20 6f 6e 6c 79 20 77 versions only w
1cb80 6f 72 6b 20 66 6f 72 20 41 53 43 49 49 20 63 68 ork for ASCII ch
1cb90 61 72 61 63 74 65 72 73 2c 20 72 65 67 61 72 64 aracters, regard
1cba0 6c 65 73 73 20 6f 66 20 6c 6f 63 61 6c 65 2e 0a less of locale..
1cbb0 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
1cbc0 5f 41 53 43 49 49 0a 23 20 64 65 66 69 6e 65 20 _ASCII.# define
1cbd0 73 71 6c 69 74 65 33 54 6f 75 70 70 65 72 28 78 sqlite3Toupper(x
1cbe0 29 20 20 28 28 78 29 26 7e 28 73 71 6c 69 74 65 ) ((x)&~(sqlite
1cbf0 33 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 3CtypeMap[(unsig
1cc00 6e 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 ned char)(x)]&0x
1cc10 32 30 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 20)).# define sq
1cc20 6c 69 74 65 33 49 73 73 70 61 63 65 28 78 29 20 lite3Isspace(x)
1cc30 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d (sqlite3CtypeM
1cc40 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ap[(unsigned cha
1cc50 72 29 28 78 29 5d 26 30 78 30 31 29 0a 23 20 64 r)(x)]&0x01).# d
1cc60 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 efine sqlite3Isa
1cc70 6c 6e 75 6d 28 78 29 20 20 20 28 73 71 6c 69 74 lnum(x) (sqlit
1cc80 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 e3CtypeMap[(unsi
1cc90 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 gned char)(x)]&0
1cca0 78 30 36 29 0a 23 20 64 65 66 69 6e 65 20 73 71 x06).# define sq
1ccb0 6c 69 74 65 33 49 73 61 6c 70 68 61 28 78 29 20 lite3Isalpha(x)
1ccc0 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d (sqlite3CtypeM
1ccd0 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ap[(unsigned cha
1cce0 72 29 28 78 29 5d 26 30 78 30 32 29 0a 23 20 64 r)(x)]&0x02).# d
1ccf0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 64 efine sqlite3Isd
1cd00 69 67 69 74 28 78 29 20 20 20 28 73 71 6c 69 74 igit(x) (sqlit
1cd10 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 e3CtypeMap[(unsi
1cd20 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 gned char)(x)]&0
1cd30 78 30 34 29 0a 23 20 64 65 66 69 6e 65 20 73 71 x04).# define sq
1cd40 6c 69 74 65 33 49 73 78 64 69 67 69 74 28 78 29 lite3Isxdigit(x)
1cd50 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d (sqlite3CtypeM
1cd60 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ap[(unsigned cha
1cd70 72 29 28 78 29 5d 26 30 78 30 38 29 0a 23 20 64 r)(x)]&0x08).# d
1cd80 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f 6c efine sqlite3Tol
1cd90 6f 77 65 72 28 78 29 20 20 20 28 73 71 6c 69 74 ower(x) (sqlit
1cda0 65 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 5b 28 e3UpperToLower[(
1cdb0 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 unsigned char)(x
1cdc0 29 5d 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 )]).#else.# defi
1cdd0 6e 65 20 73 71 6c 69 74 65 33 54 6f 75 70 70 65 ne sqlite3Touppe
1cde0 72 28 78 29 20 20 20 74 6f 75 70 70 65 72 28 28 r(x) toupper((
1cdf0 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 unsigned char)(x
1ce00 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 )).# define sqli
1ce10 74 65 33 49 73 73 70 61 63 65 28 78 29 20 20 20 te3Isspace(x)
1ce20 69 73 73 70 61 63 65 28 28 75 6e 73 69 67 6e 65 isspace((unsigne
1ce30 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 d char)(x)).# de
1ce40 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 6c fine sqlite3Isal
1ce50 6e 75 6d 28 78 29 20 20 20 69 73 61 6c 6e 75 6d num(x) isalnum
1ce60 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 ((unsigned char)
1ce70 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 (x)).# define sq
1ce80 6c 69 74 65 33 49 73 61 6c 70 68 61 28 78 29 20 lite3Isalpha(x)
1ce90 20 20 69 73 61 6c 70 68 61 28 28 75 6e 73 69 67 isalpha((unsig
1cea0 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 ned char)(x)).#
1ceb0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 define sqlite3Is
1cec0 64 69 67 69 74 28 78 29 20 20 20 69 73 64 69 67 digit(x) isdig
1ced0 69 74 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 it((unsigned cha
1cee0 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 r)(x)).# define
1cef0 73 71 6c 69 74 65 33 49 73 78 64 69 67 69 74 28 sqlite3Isxdigit(
1cf00 78 29 20 20 69 73 78 64 69 67 69 74 28 28 75 6e x) isxdigit((un
1cf10 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 signed char)(x))
1cf20 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
1cf30 33 54 6f 6c 6f 77 65 72 28 78 29 20 20 20 74 6f 3Tolower(x) to
1cf40 6c 6f 77 65 72 28 28 75 6e 73 69 67 6e 65 64 20 lower((unsigned
1cf50 63 68 61 72 29 28 78 29 29 0a 23 65 6e 64 69 66 char)(x)).#endif
1cf60 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 72 6e 61 6c ../*.** Internal
1cf70 20 66 75 6e 63 74 69 6f 6e 20 70 72 6f 74 6f 74 function protot
1cf80 79 70 65 73 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ypes.*/.#define
1cf90 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 20 73 sqlite3StrICmp s
1cfa0 71 6c 69 74 65 33 5f 73 74 72 69 63 6d 70 0a 69 qlite3_stricmp.i
1cfb0 6e 74 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e nt sqlite3Strlen
1cfc0 33 30 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 30(const char*);
1cfd0 0a 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 .#define sqlite3
1cfe0 53 74 72 4e 49 43 6d 70 20 73 71 6c 69 74 65 33 StrNICmp sqlite3
1cff0 5f 73 74 72 6e 69 63 6d 70 0a 0a 69 6e 74 20 73 _strnicmp..int s
1d000 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 49 6e 69 74 qlite3MallocInit
1d010 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c (void);.void sql
1d020 69 74 65 33 4d 61 6c 6c 6f 63 45 6e 64 28 76 6f ite3MallocEnd(vo
1d030 69 64 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 id);.void *sqlit
1d040 65 33 4d 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 e3Malloc(int);.v
1d050 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c oid *sqlite3Mall
1d060 6f 63 5a 65 72 6f 28 69 6e 74 29 3b 0a 76 6f 69 ocZero(int);.voi
1d070 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c d *sqlite3DbMall
1d080 6f 63 5a 65 72 6f 28 73 71 6c 69 74 65 33 2a 2c ocZero(sqlite3*,
1d090 20 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c int);.void *sql
1d0a0 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 ite3DbMallocRaw(
1d0b0 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 29 3b 0a sqlite3*, int);.
1d0c0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 44 62 53 char *sqlite3DbS
1d0d0 74 72 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 63 trDup(sqlite3*,c
1d0e0 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 63 68 61 onst char*);.cha
1d0f0 72 20 2a 73 71 6c 69 74 65 33 44 62 53 74 72 4e r *sqlite3DbStrN
1d100 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e Dup(sqlite3*,con
1d110 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b 0a st char*, int);.
1d120 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 52 65 61 void *sqlite3Rea
1d130 6c 6c 6f 63 28 76 6f 69 64 2a 2c 20 69 6e 74 29 lloc(void*, int)
1d140 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 ;.void *sqlite3D
1d150 62 52 65 61 6c 6c 6f 63 4f 72 46 72 65 65 28 73 bReallocOrFree(s
1d160 71 6c 69 74 65 33 20 2a 2c 20 76 6f 69 64 20 2a qlite3 *, void *
1d170 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 , int);.void *sq
1d180 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 28 73 lite3DbRealloc(s
1d190 71 6c 69 74 65 33 20 2a 2c 20 76 6f 69 64 20 2a qlite3 *, void *
1d1a0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
1d1b0 69 74 65 33 44 62 46 72 65 65 28 73 71 6c 69 74 ite3DbFree(sqlit
1d1c0 65 33 2a 2c 20 76 6f 69 64 2a 29 3b 0a 69 6e 74 e3*, void*);.int
1d1d0 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 sqlite3MallocSi
1d1e0 7a 65 28 76 6f 69 64 2a 29 3b 0a 69 6e 74 20 73 ze(void*);.int s
1d1f0 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 53 69 qlite3DbMallocSi
1d200 7a 65 28 73 71 6c 69 74 65 33 2a 2c 20 76 6f 69 ze(sqlite3*, voi
1d210 64 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 d*);.void *sqlit
1d220 65 33 53 63 72 61 74 63 68 4d 61 6c 6c 6f 63 28 e3ScratchMalloc(
1d230 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
1d240 65 33 53 63 72 61 74 63 68 46 72 65 65 28 76 6f e3ScratchFree(vo
1d250 69 64 2a 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 id*);.void *sqli
1d260 74 65 33 50 61 67 65 4d 61 6c 6c 6f 63 28 69 6e te3PageMalloc(in
1d270 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
1d280 50 61 67 65 46 72 65 65 28 76 6f 69 64 2a 29 3b PageFree(void*);
1d290 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d .void sqlite3Mem
1d2a0 53 65 74 44 65 66 61 75 6c 74 28 76 6f 69 64 29 SetDefault(void)
1d2b0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 65 ;.void sqlite3Be
1d2c0 6e 69 67 6e 4d 61 6c 6c 6f 63 48 6f 6f 6b 73 28 nignMallocHooks(
1d2d0 76 6f 69 64 20 28 2a 29 28 76 6f 69 64 29 2c 20 void (*)(void),
1d2e0 76 6f 69 64 20 28 2a 29 28 76 6f 69 64 29 29 3b void (*)(void));
1d2f0 0a 69 6e 74 20 73 71 6c 69 74 65 33 48 65 61 70 .int sqlite3Heap
1d300 4e 65 61 72 6c 79 46 75 6c 6c 28 76 6f 69 64 29 NearlyFull(void)
1d310 3b 0a 0a 2f 2a 0a 2a 2a 20 4f 6e 20 73 79 73 74 ;../*.** On syst
1d320 65 6d 73 20 77 69 74 68 20 61 6d 70 6c 65 20 73 ems with ample s
1d330 74 61 63 6b 20 73 70 61 63 65 20 61 6e 64 20 74 tack space and t
1d340 68 61 74 20 73 75 70 70 6f 72 74 20 61 6c 6c 6f hat support allo
1d350 63 61 28 29 2c 20 6d 61 6b 65 0a 2a 2a 20 75 73 ca(), make.** us
1d360 65 20 6f 66 20 61 6c 6c 6f 63 61 28 29 20 74 6f e of alloca() to
1d370 20 6f 62 74 61 69 6e 20 73 70 61 63 65 20 66 6f obtain space fo
1d380 72 20 6c 61 72 67 65 20 61 75 74 6f 6d 61 74 69 r large automati
1d390 63 20 6f 62 6a 65 63 74 73 2e 20 20 42 79 20 64 c objects. By d
1d3a0 65 66 61 75 6c 74 2c 0a 2a 2a 20 6f 62 74 61 69 efault,.** obtai
1d3b0 6e 20 73 70 61 63 65 20 66 72 6f 6d 20 6d 61 6c n space from mal
1d3c0 6c 6f 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 loc()..**.** The
1d3d0 20 61 6c 6c 6f 63 61 28 29 20 72 6f 75 74 69 6e alloca() routin
1d3e0 65 20 6e 65 76 65 72 20 72 65 74 75 72 6e 73 20 e never returns
1d3f0 4e 55 4c 4c 2e 20 20 54 68 69 73 20 77 69 6c 6c NULL. This will
1d400 20 63 61 75 73 65 20 63 6f 64 65 20 70 61 74 68 cause code path
1d410 73 0a 2a 2a 20 74 68 61 74 20 64 65 61 6c 20 77 s.** that deal w
1d420 69 74 68 20 73 71 6c 69 74 65 33 53 74 61 63 6b ith sqlite3Stack
1d430 41 6c 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 73 Alloc() failures
1d440 20 74 6f 20 62 65 20 75 6e 72 65 61 63 68 61 62 to be unreachab
1d450 6c 65 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 le..*/.#ifdef SQ
1d460 4c 49 54 45 5f 55 53 45 5f 41 4c 4c 4f 43 41 0a LITE_USE_ALLOCA.
1d470 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
1d480 53 74 61 63 6b 41 6c 6c 6f 63 52 61 77 28 44 2c StackAllocRaw(D,
1d490 4e 29 20 20 20 61 6c 6c 6f 63 61 28 4e 29 0a 23 N) alloca(N).#
1d4a0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 define sqlite3S
1d4b0 74 61 63 6b 41 6c 6c 6f 63 5a 65 72 6f 28 44 2c tackAllocZero(D,
1d4c0 4e 29 20 20 6d 65 6d 73 65 74 28 61 6c 6c 6f 63 N) memset(alloc
1d4d0 61 28 4e 29 2c 20 30 2c 20 4e 29 0a 23 20 64 65 a(N), 0, N).# de
1d4e0 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 fine sqlite3Stac
1d4f0 6b 46 72 65 65 28 44 2c 50 29 20 20 20 20 20 20 kFree(D,P)
1d500 20 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 .#else.# define
1d510 20 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c sqlite3StackAll
1d520 6f 63 52 61 77 28 44 2c 4e 29 20 20 20 73 71 6c ocRaw(D,N) sql
1d530 69 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 ite3DbMallocRaw(
1d540 44 2c 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 D,N).# define sq
1d550 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 5a lite3StackAllocZ
1d560 65 72 6f 28 44 2c 4e 29 20 20 73 71 6c 69 74 65 ero(D,N) sqlite
1d570 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 44 2c 3DbMallocZero(D,
1d580 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 N).# define sqli
1d590 74 65 33 53 74 61 63 6b 46 72 65 65 28 44 2c 50 te3StackFree(D,P
1d5a0 29 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 ) sqlite3D
1d5b0 62 46 72 65 65 28 44 2c 50 29 0a 23 65 6e 64 69 bFree(D,P).#endi
1d5c0 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
1d5d0 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 33 0a _ENABLE_MEMSYS3.
1d5e0 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 65 const sqlite3_me
1d5f0 6d 5f 6d 65 74 68 6f 64 73 20 2a 73 71 6c 69 74 m_methods *sqlit
1d600 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 33 28 e3MemGetMemsys3(
1d610 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 23 69 void);.#endif.#i
1d620 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
1d630 4c 45 5f 4d 45 4d 53 59 53 35 0a 63 6f 6e 73 74 LE_MEMSYS5.const
1d640 20 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 sqlite3_mem_met
1d650 68 6f 64 73 20 2a 73 71 6c 69 74 65 33 4d 65 6d hods *sqlite3Mem
1d660 47 65 74 4d 65 6d 73 79 73 35 28 76 6f 69 64 29 GetMemsys5(void)
1d670 3b 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 ;.#endif...#ifnd
1d680 65 66 20 53 51 4c 49 54 45 5f 4d 55 54 45 58 5f ef SQLITE_MUTEX_
1d690 4f 4d 49 54 0a 20 20 73 71 6c 69 74 65 33 5f 6d OMIT. sqlite3_m
1d6a0 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 6f 6e utex_methods con
1d6b0 73 74 20 2a 73 71 6c 69 74 65 33 44 65 66 61 75 st *sqlite3Defau
1d6c0 6c 74 4d 75 74 65 78 28 76 6f 69 64 29 3b 0a 20 ltMutex(void);.
1d6d0 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d sqlite3_mutex_m
1d6e0 65 74 68 6f 64 73 20 63 6f 6e 73 74 20 2a 73 71 ethods const *sq
1d6f0 6c 69 74 65 33 4e 6f 6f 70 4d 75 74 65 78 28 76 lite3NoopMutex(v
1d700 6f 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f oid);. sqlite3_
1d710 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 4d 75 mutex *sqlite3Mu
1d720 74 65 78 41 6c 6c 6f 63 28 69 6e 74 29 3b 0a 20 texAlloc(int);.
1d730 20 69 6e 74 20 73 71 6c 69 74 65 33 4d 75 74 65 int sqlite3Mute
1d740 78 49 6e 69 74 28 76 6f 69 64 29 3b 0a 20 20 69 xInit(void);. i
1d750 6e 74 20 73 71 6c 69 74 65 33 4d 75 74 65 78 45 nt sqlite3MutexE
1d760 6e 64 28 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 nd(void);.#endif
1d770 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 ..int sqlite3Sta
1d780 74 75 73 56 61 6c 75 65 28 69 6e 74 29 3b 0a 76 tusValue(int);.v
1d790 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 75 oid sqlite3Statu
1d7a0 73 41 64 64 28 69 6e 74 2c 20 69 6e 74 29 3b 0a sAdd(int, int);.
1d7b0 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 void sqlite3Stat
1d7c0 75 73 53 65 74 28 69 6e 74 2c 20 69 6e 74 29 3b usSet(int, int);
1d7d0 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
1d7e0 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 _OMIT_FLOATING_P
1d7f0 4f 49 4e 54 0a 20 20 69 6e 74 20 73 71 6c 69 74 OINT. int sqlit
1d800 65 33 49 73 4e 61 4e 28 64 6f 75 62 6c 65 29 3b e3IsNaN(double);
1d810 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
1d820 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 58 29 20 sqlite3IsNaN(X)
1d830 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 0.#endif../*.**
1d840 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
1d850 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
1d860 72 75 63 74 75 72 65 20 68 6f 6c 64 73 20 69 6e ructure holds in
1d870 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 formation about
1d880 53 51 4c 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 SQL.** functions
1d890 20 61 72 67 75 6d 65 6e 74 73 20 74 68 61 74 20 arguments that
1d8a0 61 72 65 20 74 68 65 20 70 61 72 61 6d 65 74 65 are the paramete
1d8b0 72 73 20 74 6f 20 74 68 65 20 70 72 69 6e 74 66 rs to the printf
1d8c0 28 29 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a () function..*/.
1d8d0 73 74 72 75 63 74 20 50 72 69 6e 74 66 41 72 67 struct PrintfArg
1d8e0 75 6d 65 6e 74 73 20 7b 0a 20 20 69 6e 74 20 6e uments {. int n
1d8f0 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 Arg;
1d900 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d /* Total num
1d910 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 ber of arguments
1d920 20 2a 2f 0a 20 20 69 6e 74 20 6e 55 73 65 64 3b */. int nUsed;
1d930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d940 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 * Number of argu
1d950 6d 65 6e 74 73 20 75 73 65 64 20 73 6f 20 66 61 ments used so fa
1d960 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 r */. sqlite3_v
1d970 61 6c 75 65 20 2a 2a 61 70 41 72 67 3b 20 20 20 alue **apArg;
1d980 2f 2a 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 /* The argument
1d990 76 61 6c 75 65 73 20 2a 2f 0a 7d 3b 0a 0a 23 64 values */.};..#d
1d9a0 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 52 49 efine SQLITE_PRI
1d9b0 4e 54 46 5f 49 4e 54 45 52 4e 41 4c 20 30 78 30 NTF_INTERNAL 0x0
1d9c0 31 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 1.#define SQLITE
1d9d0 5f 50 52 49 4e 54 46 5f 53 51 4c 46 55 4e 43 20 _PRINTF_SQLFUNC
1d9e0 20 30 78 30 32 0a 76 6f 69 64 20 73 71 6c 69 74 0x02.void sqlit
1d9f0 65 33 56 58 50 72 69 6e 74 66 28 53 74 72 41 63 e3VXPrintf(StrAc
1da00 63 75 6d 2a 2c 20 75 33 32 2c 20 63 6f 6e 73 74 cum*, u32, const
1da10 20 63 68 61 72 2a 2c 20 76 61 5f 6c 69 73 74 29 char*, va_list)
1da20 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 58 50 ;.void sqlite3XP
1da30 72 69 6e 74 66 28 53 74 72 41 63 63 75 6d 2a 2c rintf(StrAccum*,
1da40 20 75 33 32 2c 20 63 6f 6e 73 74 20 63 68 61 72 u32, const char
1da50 2a 2c 20 2e 2e 2e 29 3b 0a 63 68 61 72 20 2a 73 *, ...);.char *s
1da60 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 73 71 qlite3MPrintf(sq
1da70 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
1da80 72 2a 2c 20 2e 2e 2e 29 3b 0a 63 68 61 72 20 2a r*, ...);.char *
1da90 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74 66 28 sqlite3VMPrintf(
1daa0 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 sqlite3*,const c
1dab0 68 61 72 2a 2c 20 76 61 5f 6c 69 73 74 29 3b 0a har*, va_list);.
1dac0 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4d 41 70 char *sqlite3MAp
1dad0 70 65 6e 64 66 28 73 71 6c 69 74 65 33 2a 2c 63 pendf(sqlite3*,c
1dae0 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a har*,const char*
1daf0 2c 2e 2e 2e 29 3b 0a 23 69 66 20 64 65 66 69 6e ,...);.#if defin
1db00 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 ed(SQLITE_TEST)
1db10 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 || defined(SQLIT
1db20 45 5f 44 45 42 55 47 29 0a 20 20 76 6f 69 64 20 E_DEBUG). void
1db30 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
1db40 74 66 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 tf(const char*,
1db50 2e 2e 2e 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 ...);.#endif.#if
1db60 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
1db70 54 45 53 54 29 0a 20 20 76 6f 69 64 20 2a 73 71 TEST). void *sq
1db80 6c 69 74 65 33 54 65 73 74 54 65 78 74 54 6f 50 lite3TestTextToP
1db90 74 72 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b tr(const char*);
1dba0 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 4f 75 74 70 .#endif../* Outp
1dbb0 75 74 20 66 6f 72 6d 61 74 74 69 6e 67 20 66 6f ut formatting fo
1dbc0 72 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 52 r SQLITE_TESTCTR
1dbd0 4c 5f 45 58 50 4c 41 49 4e 20 2a 2f 0a 23 69 66 L_EXPLAIN */.#if
1dbe0 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
1dbf0 45 4e 41 42 4c 45 5f 54 52 45 45 5f 45 58 50 4c ENABLE_TREE_EXPL
1dc00 41 49 4e 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 AIN). void sqli
1dc10 74 65 33 45 78 70 6c 61 69 6e 42 65 67 69 6e 28 te3ExplainBegin(
1dc20 56 64 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 Vdbe*);. void s
1dc30 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 50 72 69 qlite3ExplainPri
1dc40 6e 74 66 28 56 64 62 65 2a 2c 20 63 6f 6e 73 74 ntf(Vdbe*, const
1dc50 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 20 20 char*, ...);.
1dc60 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 6c void sqlite3Expl
1dc70 61 69 6e 4e 4c 28 56 64 62 65 2a 29 3b 0a 20 20 ainNL(Vdbe*);.
1dc80 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 6c void sqlite3Expl
1dc90 61 69 6e 50 75 73 68 28 56 64 62 65 2a 29 3b 0a ainPush(Vdbe*);.
1dca0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 void sqlite3Ex
1dcb0 70 6c 61 69 6e 50 6f 70 28 56 64 62 65 2a 29 3b plainPop(Vdbe*);
1dcc0 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 45 . void sqlite3E
1dcd0 78 70 6c 61 69 6e 46 69 6e 69 73 68 28 56 64 62 xplainFinish(Vdb
1dce0 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 e*);. void sqli
1dcf0 74 65 33 45 78 70 6c 61 69 6e 53 65 6c 65 63 74 te3ExplainSelect
1dd00 28 56 64 62 65 2a 2c 20 53 65 6c 65 63 74 2a 29 (Vdbe*, Select*)
1dd10 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
1dd20 45 78 70 6c 61 69 6e 45 78 70 72 28 56 64 62 65 ExplainExpr(Vdbe
1dd30 2a 2c 20 45 78 70 72 2a 29 3b 0a 20 20 76 6f 69 *, Expr*);. voi
1dd40 64 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e d sqlite3Explain
1dd50 45 78 70 72 4c 69 73 74 28 56 64 62 65 2a 2c 20 ExprList(Vdbe*,
1dd60 45 78 70 72 4c 69 73 74 2a 29 3b 0a 20 20 63 6f ExprList*);. co
1dd70 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 nst char *sqlite
1dd80 33 56 64 62 65 45 78 70 6c 61 6e 61 74 69 6f 6e 3VdbeExplanation
1dd90 28 56 64 62 65 2a 29 3b 0a 23 65 6c 73 65 0a 23 (Vdbe*);.#else.#
1dda0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 define sqlite3E
1ddb0 78 70 6c 61 69 6e 42 65 67 69 6e 28 58 29 0a 23 xplainBegin(X).#
1ddc0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 define sqlite3E
1ddd0 78 70 6c 61 69 6e 53 65 6c 65 63 74 28 41 2c 42 xplainSelect(A,B
1dde0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
1ddf0 65 33 45 78 70 6c 61 69 6e 45 78 70 72 28 41 2c e3ExplainExpr(A,
1de00 42 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 B).# define sqli
1de10 74 65 33 45 78 70 6c 61 69 6e 45 78 70 72 4c 69 te3ExplainExprLi
1de20 73 74 28 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 st(A,B).# define
1de30 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 46 sqlite3ExplainF
1de40 69 6e 69 73 68 28 58 29 0a 23 20 64 65 66 69 6e inish(X).# defin
1de50 65 20 73 71 6c 69 74 65 33 56 64 62 65 45 78 70 e sqlite3VdbeExp
1de60 6c 61 6e 61 74 69 6f 6e 28 58 29 20 30 0a 23 65 lanation(X) 0.#e
1de70 6e 64 69 66 0a 0a 0a 76 6f 69 64 20 73 71 6c 69 ndif...void sqli
1de80 74 65 33 53 65 74 53 74 72 69 6e 67 28 63 68 61 te3SetString(cha
1de90 72 20 2a 2a 2c 20 73 71 6c 69 74 65 33 2a 2c 20 r **, sqlite3*,
1dea0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e const char*, ...
1deb0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
1dec0 72 72 6f 72 4d 73 67 28 50 61 72 73 65 2a 2c 20 rrorMsg(Parse*,
1ded0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e const char*, ...
1dee0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 65 );.int sqlite3De
1def0 71 75 6f 74 65 28 63 68 61 72 2a 29 3b 0a 69 6e quote(char*);.in
1df00 74 20 73 71 6c 69 74 65 33 4b 65 79 77 6f 72 64 t sqlite3Keyword
1df10 43 6f 64 65 28 63 6f 6e 73 74 20 75 6e 73 69 67 Code(const unsig
1df20 6e 65 64 20 63 68 61 72 2a 2c 20 69 6e 74 29 3b ned char*, int);
1df30 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 75 6e 50 .int sqlite3RunP
1df40 61 72 73 65 72 28 50 61 72 73 65 2a 2c 20 63 6f arser(Parse*, co
1df50 6e 73 74 20 63 68 61 72 2a 2c 20 63 68 61 72 20 nst char*, char
1df60 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 **);.void sqlite
1df70 33 46 69 6e 69 73 68 43 6f 64 69 6e 67 28 50 61 3FinishCoding(Pa
1df80 72 73 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 rse*);.int sqlit
1df90 65 33 47 65 74 54 65 6d 70 52 65 67 28 50 61 72 e3GetTempReg(Par
1dfa0 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
1dfb0 65 33 52 65 6c 65 61 73 65 54 65 6d 70 52 65 67 e3ReleaseTempReg
1dfc0 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 69 6e (Parse*,int);.in
1dfd0 74 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d 70 t sqlite3GetTemp
1dfe0 52 61 6e 67 65 28 50 61 72 73 65 2a 2c 69 6e 74 Range(Parse*,int
1dff0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
1e000 65 6c 65 61 73 65 54 65 6d 70 52 61 6e 67 65 28 eleaseTempRange(
1e010 50 61 72 73 65 2a 2c 69 6e 74 2c 69 6e 74 29 3b Parse*,int,int);
1e020 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 65 .void sqlite3Cle
1e030 61 72 54 65 6d 70 52 65 67 43 61 63 68 65 28 50 arTempRegCache(P
1e040 61 72 73 65 2a 29 3b 0a 45 78 70 72 20 2a 73 71 arse*);.Expr *sq
1e050 6c 69 74 65 33 45 78 70 72 41 6c 6c 6f 63 28 73 lite3ExprAlloc(s
1e060 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 qlite3*,int,cons
1e070 74 20 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 45 t Token*,int);.E
1e080 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 xpr *sqlite3Expr
1e090 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f (sqlite3*,int,co
1e0a0 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
1e0b0 20 73 71 6c 69 74 65 33 45 78 70 72 41 74 74 61 sqlite3ExprAtta
1e0c0 63 68 53 75 62 74 72 65 65 73 28 73 71 6c 69 74 chSubtrees(sqlit
1e0d0 65 33 2a 2c 45 78 70 72 2a 2c 45 78 70 72 2a 2c e3*,Expr*,Expr*,
1e0e0 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a 73 71 Expr*);.Expr *sq
1e0f0 6c 69 74 65 33 50 45 78 70 72 28 50 61 72 73 65 lite3PExpr(Parse
1e100 2a 2c 20 69 6e 74 2c 20 45 78 70 72 2a 2c 20 45 *, int, Expr*, E
1e110 78 70 72 2a 2c 20 63 6f 6e 73 74 20 54 6f 6b 65 xpr*, const Toke
1e120 6e 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 n*);.Expr *sqlit
1e130 65 33 45 78 70 72 41 6e 64 28 73 71 6c 69 74 65 e3ExprAnd(sqlite
1e140 33 2a 2c 45 78 70 72 2a 2c 20 45 78 70 72 2a 29 3*,Expr*, Expr*)
1e150 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 ;.Expr *sqlite3E
1e160 78 70 72 46 75 6e 63 74 69 6f 6e 28 50 61 72 73 xprFunction(Pars
1e170 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 20 54 6f e*,ExprList*, To
1e180 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ken*);.void sqli
1e190 74 65 33 45 78 70 72 41 73 73 69 67 6e 56 61 72 te3ExprAssignVar
1e1a0 4e 75 6d 62 65 72 28 50 61 72 73 65 2a 2c 20 45 Number(Parse*, E
1e1b0 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
1e1c0 74 65 33 45 78 70 72 44 65 6c 65 74 65 28 73 71 te3ExprDelete(sq
1e1d0 6c 69 74 65 33 2a 2c 20 45 78 70 72 2a 29 3b 0a lite3*, Expr*);.
1e1e0 45 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 65 ExprList *sqlite
1e1f0 33 45 78 70 72 4c 69 73 74 41 70 70 65 6e 64 28 3ExprListAppend(
1e200 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a Parse*,ExprList*
1e210 2c 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 ,Expr*);.void sq
1e220 6c 69 74 65 33 45 78 70 72 4c 69 73 74 53 65 74 lite3ExprListSet
1e230 4e 61 6d 65 28 50 61 72 73 65 2a 2c 45 78 70 72 Name(Parse*,Expr
1e240 4c 69 73 74 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 List*,Token*,int
1e250 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
1e260 78 70 72 4c 69 73 74 53 65 74 53 70 61 6e 28 50 xprListSetSpan(P
1e270 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c arse*,ExprList*,
1e280 45 78 70 72 53 70 61 6e 2a 29 3b 0a 76 6f 69 64 ExprSpan*);.void
1e290 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 sqlite3ExprList
1e2a0 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c Delete(sqlite3*,
1e2b0 20 45 78 70 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 ExprList*);.int
1e2c0 20 73 71 6c 69 74 65 33 49 6e 69 74 28 73 71 6c sqlite3Init(sql
1e2d0 69 74 65 33 2a 2c 20 63 68 61 72 2a 2a 29 3b 0a ite3*, char**);.
1e2e0 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 69 74 43 int sqlite3InitC
1e2f0 61 6c 6c 62 61 63 6b 28 76 6f 69 64 2a 2c 20 69 allback(void*, i
1e300 6e 74 2c 20 63 68 61 72 2a 2a 2c 20 63 68 61 72 nt, char**, char
1e310 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 **);.void sqlite
1e320 33 50 72 61 67 6d 61 28 50 61 72 73 65 2a 2c 54 3Pragma(Parse*,T
1e330 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b oken*,Token*,Tok
1e340 65 6e 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 en*,int);.void s
1e350 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c 53 63 qlite3ResetAllSc
1e360 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f hemasOfConnectio
1e370 6e 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 n(sqlite3*);.voi
1e380 64 20 73 71 6c 69 74 65 33 52 65 73 65 74 4f 6e d sqlite3ResetOn
1e390 65 53 63 68 65 6d 61 28 73 71 6c 69 74 65 33 2a eSchema(sqlite3*
1e3a0 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
1e3b0 74 65 33 43 6f 6c 6c 61 70 73 65 44 61 74 61 62 te3CollapseDatab
1e3c0 61 73 65 41 72 72 61 79 28 73 71 6c 69 74 65 33 aseArray(sqlite3
1e3d0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
1e3e0 42 65 67 69 6e 50 61 72 73 65 28 50 61 72 73 65 BeginParse(Parse
1e3f0 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c *,int);.void sql
1e400 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e ite3CommitIntern
1e410 61 6c 43 68 61 6e 67 65 73 28 73 71 6c 69 74 65 alChanges(sqlite
1e420 33 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 3*);.Table *sqli
1e430 74 65 33 52 65 73 75 6c 74 53 65 74 4f 66 53 65 te3ResultSetOfSe
1e440 6c 65 63 74 28 50 61 72 73 65 2a 2c 53 65 6c 65 lect(Parse*,Sele
1e450 63 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ct*);.void sqlit
1e460 65 33 4f 70 65 6e 4d 61 73 74 65 72 54 61 62 6c e3OpenMasterTabl
1e470 65 28 50 61 72 73 65 20 2a 2c 20 69 6e 74 29 3b e(Parse *, int);
1e480 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 50 .Index *sqlite3P
1e490 72 69 6d 61 72 79 4b 65 79 49 6e 64 65 78 28 54 rimaryKeyIndex(T
1e4a0 61 62 6c 65 2a 29 3b 0a 69 31 36 20 73 71 6c 69 able*);.i16 sqli
1e4b0 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e 64 65 78 te3ColumnOfIndex
1e4c0 28 49 6e 64 65 78 2a 2c 20 69 31 36 29 3b 0a 76 (Index*, i16);.v
1e4d0 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 72 74 oid sqlite3Start
1e4e0 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 6f 6b Table(Parse*,Tok
1e4f0 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 2c 69 en*,Token*,int,i
1e500 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 nt,int,int);.voi
1e510 64 20 73 71 6c 69 74 65 33 41 64 64 43 6f 6c 75 d sqlite3AddColu
1e520 6d 6e 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a mn(Parse*,Token*
1e530 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
1e540 64 64 4e 6f 74 4e 75 6c 6c 28 50 61 72 73 65 2a ddNotNull(Parse*
1e550 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
1e560 69 74 65 33 41 64 64 50 72 69 6d 61 72 79 4b 65 ite3AddPrimaryKe
1e570 79 28 50 61 72 73 65 2a 2c 20 45 78 70 72 4c 69 y(Parse*, ExprLi
1e580 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 st*, int, int, i
1e590 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
1e5a0 33 41 64 64 43 68 65 63 6b 43 6f 6e 73 74 72 61 3AddCheckConstra
1e5b0 69 6e 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 int(Parse*, Expr
1e5c0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
1e5d0 41 64 64 43 6f 6c 75 6d 6e 54 79 70 65 28 50 61 AddColumnType(Pa
1e5e0 72 73 65 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 76 6f rse*,Token*);.vo
1e5f0 69 64 20 73 71 6c 69 74 65 33 41 64 64 44 65 66 id sqlite3AddDef
1e600 61 75 6c 74 56 61 6c 75 65 28 50 61 72 73 65 2a aultValue(Parse*
1e610 2c 45 78 70 72 53 70 61 6e 2a 29 3b 0a 76 6f 69 ,ExprSpan*);.voi
1e620 64 20 73 71 6c 69 74 65 33 41 64 64 43 6f 6c 6c d sqlite3AddColl
1e630 61 74 65 54 79 70 65 28 50 61 72 73 65 2a 2c 20 ateType(Parse*,
1e640 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 Token*);.void sq
1e650 6c 69 74 65 33 45 6e 64 54 61 62 6c 65 28 50 61 lite3EndTable(Pa
1e660 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
1e670 6e 2a 2c 75 38 2c 53 65 6c 65 63 74 2a 29 3b 0a n*,u8,Select*);.
1e680 69 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 int sqlite3Parse
1e690 55 72 69 28 63 6f 6e 73 74 20 63 68 61 72 2a 2c Uri(const char*,
1e6a0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 6e 73 69 const char*,unsi
1e6b0 67 6e 65 64 20 69 6e 74 2a 2c 0a 20 20 20 20 20 gned int*,.
1e6c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 s
1e6d0 71 6c 69 74 65 33 5f 76 66 73 2a 2a 2c 63 68 61 qlite3_vfs**,cha
1e6e0 72 2a 2a 2c 63 68 61 72 20 2a 2a 29 3b 0a 42 74 r**,char **);.Bt
1e6f0 72 65 65 20 2a 73 71 6c 69 74 65 33 44 62 4e 61 ree *sqlite3DbNa
1e700 6d 65 54 6f 42 74 72 65 65 28 73 71 6c 69 74 65 meToBtree(sqlite
1e710 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 3*,const char*);
1e720 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 64 65 .int sqlite3Code
1e730 4f 6e 63 65 28 50 61 72 73 65 20 2a 29 3b 0a 0a Once(Parse *);..
1e740 42 69 74 76 65 63 20 2a 73 71 6c 69 74 65 33 42 Bitvec *sqlite3B
1e750 69 74 76 65 63 43 72 65 61 74 65 28 75 33 32 29 itvecCreate(u32)
1e760 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 42 69 74 ;.int sqlite3Bit
1e770 76 65 63 54 65 73 74 28 42 69 74 76 65 63 2a 2c vecTest(Bitvec*,
1e780 20 75 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 u32);.int sqlit
1e790 65 33 42 69 74 76 65 63 53 65 74 28 42 69 74 76 e3BitvecSet(Bitv
1e7a0 65 63 2a 2c 20 75 33 32 29 3b 0a 76 6f 69 64 20 ec*, u32);.void
1e7b0 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 6c 65 sqlite3BitvecCle
1e7c0 61 72 28 42 69 74 76 65 63 2a 2c 20 75 33 32 2c ar(Bitvec*, u32,
1e7d0 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 void*);.void sq
1e7e0 6c 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 lite3BitvecDestr
1e7f0 6f 79 28 42 69 74 76 65 63 2a 29 3b 0a 75 33 32 oy(Bitvec*);.u32
1e800 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 69 sqlite3BitvecSi
1e810 7a 65 28 42 69 74 76 65 63 2a 29 3b 0a 69 6e 74 ze(Bitvec*);.int
1e820 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 sqlite3BitvecBu
1e830 69 6c 74 69 6e 54 65 73 74 28 69 6e 74 2c 69 6e iltinTest(int,in
1e840 74 2a 29 3b 0a 0a 52 6f 77 53 65 74 20 2a 73 71 t*);..RowSet *sq
1e850 6c 69 74 65 33 52 6f 77 53 65 74 49 6e 69 74 28 lite3RowSetInit(
1e860 73 71 6c 69 74 65 33 2a 2c 20 76 6f 69 64 2a 2c sqlite3*, void*,
1e870 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 3b 0a unsigned int);.
1e880 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f 77 53 void sqlite3RowS
1e890 65 74 43 6c 65 61 72 28 52 6f 77 53 65 74 2a 29 etClear(RowSet*)
1e8a0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f ;.void sqlite3Ro
1e8b0 77 53 65 74 49 6e 73 65 72 74 28 52 6f 77 53 65 wSetInsert(RowSe
1e8c0 74 2a 2c 20 69 36 34 29 3b 0a 69 6e 74 20 73 71 t*, i64);.int sq
1e8d0 6c 69 74 65 33 52 6f 77 53 65 74 54 65 73 74 28 lite3RowSetTest(
1e8e0 52 6f 77 53 65 74 2a 2c 20 75 38 20 69 42 61 74 RowSet*, u8 iBat
1e8f0 63 68 2c 20 69 36 34 29 3b 0a 69 6e 74 20 73 71 ch, i64);.int sq
1e900 6c 69 74 65 33 52 6f 77 53 65 74 4e 65 78 74 28 lite3RowSetNext(
1e910 52 6f 77 53 65 74 2a 2c 20 69 36 34 2a 29 3b 0a RowSet*, i64*);.
1e920 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 72 65 .void sqlite3Cre
1e930 61 74 65 56 69 65 77 28 50 61 72 73 65 2a 2c 54 ateView(Parse*,T
1e940 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b oken*,Token*,Tok
1e950 65 6e 2a 2c 53 65 6c 65 63 74 2a 2c 69 6e 74 2c en*,Select*,int,
1e960 69 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 69 int);..#if !defi
1e970 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
1e980 56 49 45 57 29 20 7c 7c 20 21 64 65 66 69 6e 65 VIEW) || !define
1e990 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 d(SQLITE_OMIT_VI
1e9a0 52 54 55 41 4c 54 41 42 4c 45 29 0a 20 20 69 6e RTUALTABLE). in
1e9b0 74 20 73 71 6c 69 74 65 33 56 69 65 77 47 65 74 t sqlite3ViewGet
1e9c0 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 50 61 72 73 ColumnNames(Pars
1e9d0 65 2a 2c 54 61 62 6c 65 2a 29 3b 0a 23 65 6c 73 e*,Table*);.#els
1e9e0 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 e.# define sqlit
1e9f0 65 33 56 69 65 77 47 65 74 43 6f 6c 75 6d 6e 4e e3ViewGetColumnN
1ea00 61 6d 65 73 28 41 2c 42 29 20 30 0a 23 65 6e 64 ames(A,B) 0.#end
1ea10 69 66 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 if..void sqlite3
1ea20 44 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a DropTable(Parse*
1ea30 2c 20 53 72 63 4c 69 73 74 2a 2c 20 69 6e 74 2c , SrcList*, int,
1ea40 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
1ea50 74 65 33 43 6f 64 65 44 72 6f 70 54 61 62 6c 65 te3CodeDropTable
1ea60 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
1ea70 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 int, int);.void
1ea80 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 54 61 sqlite3DeleteTa
1ea90 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c 20 54 61 ble(sqlite3*, Ta
1eaa0 62 6c 65 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53 ble*);.#ifndef S
1eab0 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f 49 QLITE_OMIT_AUTOI
1eac0 4e 43 52 45 4d 45 4e 54 0a 20 20 76 6f 69 64 20 NCREMENT. void
1ead0 73 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 sqlite3Autoincre
1eae0 6d 65 6e 74 42 65 67 69 6e 28 50 61 72 73 65 20 mentBegin(Parse
1eaf0 2a 70 50 61 72 73 65 29 3b 0a 20 20 76 6f 69 64 *pParse);. void
1eb00 20 73 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 sqlite3Autoincr
1eb10 65 6d 65 6e 74 45 6e 64 28 50 61 72 73 65 20 2a ementEnd(Parse *
1eb20 70 50 61 72 73 65 29 3b 0a 23 65 6c 73 65 0a 23 pParse);.#else.#
1eb30 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 define sqlite3A
1eb40 75 74 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 69 utoincrementBegi
1eb50 6e 28 58 29 0a 23 20 64 65 66 69 6e 65 20 73 71 n(X).# define sq
1eb60 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 65 6d 65 lite3Autoincreme
1eb70 6e 74 45 6e 64 28 58 29 0a 23 65 6e 64 69 66 0a ntEnd(X).#endif.
1eb80 69 6e 74 20 73 71 6c 69 74 65 33 43 6f 64 65 43 int sqlite3CodeC
1eb90 6f 72 6f 75 74 69 6e 65 28 50 61 72 73 65 2a 2c oroutine(Parse*,
1eba0 20 53 65 6c 65 63 74 2a 2c 20 53 65 6c 65 63 74 Select*, Select
1ebb0 44 65 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c Dest*);.void sql
1ebc0 69 74 65 33 49 6e 73 65 72 74 28 50 61 72 73 65 ite3Insert(Parse
1ebd0 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 53 65 6c *, SrcList*, Sel
1ebe0 65 63 74 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 69 ect*, IdList*, i
1ebf0 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 nt);.void *sqlit
1ec00 65 33 41 72 72 61 79 41 6c 6c 6f 63 61 74 65 28 e3ArrayAllocate(
1ec10 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c 69 sqlite3*,void*,i
1ec20 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a 49 nt,int*,int*);.I
1ec30 64 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 64 dList *sqlite3Id
1ec40 4c 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 74 ListAppend(sqlit
1ec50 65 33 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 54 6f e3*, IdList*, To
1ec60 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ken*);.int sqlit
1ec70 65 33 49 64 4c 69 73 74 49 6e 64 65 78 28 49 64 e3IdListIndex(Id
1ec80 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 72 List*,const char
1ec90 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c *);.SrcList *sql
1eca0 69 74 65 33 53 72 63 4c 69 73 74 45 6e 6c 61 72 ite3SrcListEnlar
1ecb0 67 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 ge(sqlite3*, Src
1ecc0 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 List*, int, int)
1ecd0 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 74 ;.SrcList *sqlit
1ece0 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e 64 28 e3SrcListAppend(
1ecf0 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 sqlite3*, SrcLis
1ed00 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 t*, Token*, Toke
1ed10 6e 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 n*);.SrcList *sq
1ed20 6c 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 lite3SrcListAppe
1ed30 6e 64 46 72 6f 6d 54 65 72 6d 28 50 61 72 73 65 ndFromTerm(Parse
1ed40 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b *, SrcList*, Tok
1ed50 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 0a 20 20 20 en*, Token*,.
1ed60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ed70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ed80 20 20 20 54 6f 6b 65 6e 2a 2c 20 53 65 6c 65 63 Token*, Selec
1ed90 74 2a 2c 20 45 78 70 72 2a 2c 20 49 64 4c 69 73 t*, Expr*, IdLis
1eda0 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 t*);.void sqlite
1edb0 33 53 72 63 4c 69 73 74 49 6e 64 65 78 65 64 42 3SrcListIndexedB
1edc0 79 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c 69 y(Parse *, SrcLi
1edd0 73 74 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b 0a st *, Token *);.
1ede0 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 65 78 int sqlite3Index
1edf0 65 64 42 79 4c 6f 6f 6b 75 70 28 50 61 72 73 65 edByLookup(Parse
1ee00 20 2a 2c 20 73 74 72 75 63 74 20 53 72 63 4c 69 *, struct SrcLi
1ee10 73 74 5f 69 74 65 6d 20 2a 29 3b 0a 76 6f 69 64 st_item *);.void
1ee20 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 53 sqlite3SrcListS
1ee30 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 53 72 63 hiftJoinType(Src
1ee40 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c List*);.void sql
1ee50 69 74 65 33 53 72 63 4c 69 73 74 41 73 73 69 67 ite3SrcListAssig
1ee60 6e 43 75 72 73 6f 72 73 28 50 61 72 73 65 2a 2c nCursors(Parse*,
1ee70 20 53 72 63 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 SrcList*);.void
1ee80 20 73 71 6c 69 74 65 33 49 64 4c 69 73 74 44 65 sqlite3IdListDe
1ee90 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 49 lete(sqlite3*, I
1eea0 64 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 dList*);.void sq
1eeb0 6c 69 74 65 33 53 72 63 4c 69 73 74 44 65 6c 65 lite3SrcListDele
1eec0 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 te(sqlite3*, Src
1eed0 4c 69 73 74 2a 29 3b 0a 49 6e 64 65 78 20 2a 73 List*);.Index *s
1eee0 71 6c 69 74 65 33 41 6c 6c 6f 63 61 74 65 49 6e qlite3AllocateIn
1eef0 64 65 78 4f 62 6a 65 63 74 28 73 71 6c 69 74 65 dexObject(sqlite
1ef00 33 2a 2c 69 31 36 2c 69 6e 74 2c 63 68 61 72 2a 3*,i16,int,char*
1ef10 2a 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 *);.Index *sqlit
1ef20 65 33 43 72 65 61 74 65 49 6e 64 65 78 28 50 61 e3CreateIndex(Pa
1ef30 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
1ef40 6e 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 n*,SrcList*,Expr
1ef50 4c 69 73 74 2a 2c 69 6e 74 2c 54 6f 6b 65 6e 2a List*,int,Token*
1ef60 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
1ef70 20 20 20 20 20 20 20 20 20 20 20 20 45 78 70 72 Expr
1ef80 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f *, int, int);.vo
1ef90 69 64 20 73 71 6c 69 74 65 33 44 72 6f 70 49 6e id sqlite3DropIn
1efa0 64 65 78 28 50 61 72 73 65 2a 2c 20 53 72 63 4c dex(Parse*, SrcL
1efb0 69 73 74 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 ist*, int);.int
1efc0 73 71 6c 69 74 65 33 53 65 6c 65 63 74 28 50 61 sqlite3Select(Pa
1efd0 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 53 rse*, Select*, S
1efe0 65 6c 65 63 74 44 65 73 74 2a 29 3b 0a 53 65 6c electDest*);.Sel
1eff0 65 63 74 20 2a 73 71 6c 69 74 65 33 53 65 6c 65 ect *sqlite3Sele
1f000 63 74 4e 65 77 28 50 61 72 73 65 2a 2c 45 78 70 ctNew(Parse*,Exp
1f010 72 4c 69 73 74 2a 2c 53 72 63 4c 69 73 74 2a 2c rList*,SrcList*,
1f020 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c Expr*,ExprList*,
1f030 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
1f040 20 20 20 20 20 20 20 20 20 20 45 78 70 72 2a 2c Expr*,
1f050 45 78 70 72 4c 69 73 74 2a 2c 75 31 36 2c 45 78 ExprList*,u16,Ex
1f060 70 72 2a 2c 45 78 70 72 2a 29 3b 0a 76 6f 69 64 pr*,Expr*);.void
1f070 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65 sqlite3SelectDe
1f080 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 lete(sqlite3*, S
1f090 65 6c 65 63 74 2a 29 3b 0a 54 61 62 6c 65 20 2a elect*);.Table *
1f0a0 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 4c 6f sqlite3SrcListLo
1f0b0 6f 6b 75 70 28 50 61 72 73 65 2a 2c 20 53 72 63 okup(Parse*, Src
1f0c0 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 List*);.int sqli
1f0d0 74 65 33 49 73 52 65 61 64 4f 6e 6c 79 28 50 61 te3IsReadOnly(Pa
1f0e0 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e rse*, Table*, in
1f0f0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
1f100 4f 70 65 6e 54 61 62 6c 65 28 50 61 72 73 65 2a OpenTable(Parse*
1f110 2c 20 69 6e 74 20 69 43 75 72 2c 20 69 6e 74 20 , int iCur, int
1f120 69 44 62 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 iDb, Table*, int
1f130 29 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 );.#if defined(S
1f140 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 50 44 QLITE_ENABLE_UPD
1f150 41 54 45 5f 44 45 4c 45 54 45 5f 4c 49 4d 49 54 ATE_DELETE_LIMIT
1f160 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 ) && !defined(SQ
1f170 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55 45 LITE_OMIT_SUBQUE
1f180 52 59 29 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 RY).Expr *sqlite
1f190 33 4c 69 6d 69 74 57 68 65 72 65 28 50 61 72 73 3LimitWhere(Pars
1f1a0 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 e*,SrcList*,Expr
1f1b0 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 *,ExprList*,Expr
1f1c0 2a 2c 45 78 70 72 2a 2c 63 68 61 72 2a 29 3b 0a *,Expr*,char*);.
1f1d0 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 #endif.void sqli
1f1e0 74 65 33 44 65 6c 65 74 65 46 72 6f 6d 28 50 61 te3DeleteFrom(Pa
1f1f0 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 rse*, SrcList*,
1f200 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c Expr*);.void sql
1f210 69 74 65 33 55 70 64 61 74 65 28 50 61 72 73 65 ite3Update(Parse
1f220 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 70 *, SrcList*, Exp
1f230 72 4c 69 73 74 2a 2c 20 45 78 70 72 2a 2c 20 69 rList*, Expr*, i
1f240 6e 74 29 3b 0a 57 68 65 72 65 49 6e 66 6f 20 2a nt);.WhereInfo *
1f250 73 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 69 sqlite3WhereBegi
1f260 6e 28 50 61 72 73 65 2a 2c 53 72 63 4c 69 73 74 n(Parse*,SrcList
1f270 2a 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 *,Expr*,ExprList
1f280 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 75 31 36 2c *,ExprList*,u16,
1f290 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
1f2a0 65 33 57 68 65 72 65 45 6e 64 28 57 68 65 72 65 e3WhereEnd(Where
1f2b0 49 6e 66 6f 2a 29 3b 0a 75 36 34 20 73 71 6c 69 Info*);.u64 sqli
1f2c0 74 65 33 57 68 65 72 65 4f 75 74 70 75 74 52 6f te3WhereOutputRo
1f2d0 77 43 6f 75 6e 74 28 57 68 65 72 65 49 6e 66 6f wCount(WhereInfo
1f2e0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 *);.int sqlite3W
1f2f0 68 65 72 65 49 73 44 69 73 74 69 6e 63 74 28 57 hereIsDistinct(W
1f300 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 hereInfo*);.int
1f310 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 4f 72 sqlite3WhereIsOr
1f320 64 65 72 65 64 28 57 68 65 72 65 49 6e 66 6f 2a dered(WhereInfo*
1f330 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 );.int sqlite3Wh
1f340 65 72 65 43 6f 6e 74 69 6e 75 65 4c 61 62 65 6c ereContinueLabel
1f350 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e (WhereInfo*);.in
1f360 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 72 t sqlite3WhereBr
1f370 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 65 49 6e eakLabel(WhereIn
1f380 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 fo*);.int sqlite
1f390 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 73 73 28 3WhereOkOnePass(
1f3a0 57 68 65 72 65 49 6e 66 6f 2a 2c 20 69 6e 74 2a WhereInfo*, int*
1f3b0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
1f3c0 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 6d 6e 28 prCodeGetColumn(
1f3d0 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 Parse*, Table*,
1f3e0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 75 int, int, int, u
1f3f0 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 8);.void sqlite3
1f400 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 6d ExprCodeGetColum
1f410 6e 4f 66 54 61 62 6c 65 28 56 64 62 65 2a 2c 20 nOfTable(Vdbe*,
1f420 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 Table*, int, int
1f430 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
1f440 69 74 65 33 45 78 70 72 43 6f 64 65 4d 6f 76 65 ite3ExprCodeMove
1f450 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e (Parse*, int, in
1f460 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t, int);.void sq
1f470 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 53 74 lite3ExprCacheSt
1f480 6f 72 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c ore(Parse*, int,
1f490 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 int, int);.void
1f4a0 20 73 71 6c 69 74 65 33 45 78 70 72 43 61 63 68 sqlite3ExprCach
1f4b0 65 50 75 73 68 28 50 61 72 73 65 2a 29 3b 0a 76 ePush(Parse*);.v
1f4c0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
1f4d0 61 63 68 65 50 6f 70 28 50 61 72 73 65 2a 2c 20 achePop(Parse*,
1f4e0 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
1f4f0 65 33 45 78 70 72 43 61 63 68 65 52 65 6d 6f 76 e3ExprCacheRemov
1f500 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 e(Parse*, int, i
1f510 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
1f520 33 45 78 70 72 43 61 63 68 65 43 6c 65 61 72 28 3ExprCacheClear(
1f530 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 Parse*);.void sq
1f540 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 41 66 lite3ExprCacheAf
1f550 66 69 6e 69 74 79 43 68 61 6e 67 65 28 50 61 72 finityChange(Par
1f560 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a se*, int, int);.
1f570 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 int sqlite3ExprC
1f580 6f 64 65 28 50 61 72 73 65 2a 2c 20 45 78 70 72 ode(Parse*, Expr
1f590 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
1f5a0 6c 69 74 65 33 45 78 70 72 43 6f 64 65 41 74 49 lite3ExprCodeAtI
1f5b0 6e 69 74 28 50 61 72 73 65 2a 2c 20 45 78 70 72 nit(Parse*, Expr
1f5c0 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 6e 74 *, int, u8);.int
1f5d0 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 sqlite3ExprCode
1f5e0 54 65 6d 70 28 50 61 72 73 65 2a 2c 20 45 78 70 Temp(Parse*, Exp
1f5f0 72 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 r*, int*);.int s
1f600 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 54 61 qlite3ExprCodeTa
1f610 72 67 65 74 28 50 61 72 73 65 2a 2c 20 45 78 70 rget(Parse*, Exp
1f620 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
1f630 6c 69 74 65 33 45 78 70 72 43 6f 64 65 41 6e 64 lite3ExprCodeAnd
1f640 43 61 63 68 65 28 50 61 72 73 65 2a 2c 20 45 78 Cache(Parse*, Ex
1f650 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 pr*, int);.int s
1f660 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 45 78 qlite3ExprCodeEx
1f670 70 72 4c 69 73 74 28 50 61 72 73 65 2a 2c 20 45 prList(Parse*, E
1f680 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 75 xprList*, int, u
1f690 38 29 3b 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 8);.#define SQLI
1f6a0 54 45 5f 45 43 45 4c 5f 44 55 50 20 20 20 20 20 TE_ECEL_DUP
1f6b0 20 30 78 30 31 20 20 2f 2a 20 44 65 65 70 2c 20 0x01 /* Deep,
1f6c0 6e 6f 74 20 73 68 61 6c 6c 6f 77 20 63 6f 70 69 not shallow copi
1f6d0 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
1f6e0 4c 49 54 45 5f 45 43 45 4c 5f 46 41 43 54 4f 52 LITE_ECEL_FACTOR
1f6f0 20 20 20 30 78 30 32 20 20 2f 2a 20 46 61 63 74 0x02 /* Fact
1f700 6f 72 20 6f 75 74 20 63 6f 6e 73 74 61 6e 74 20 or out constant
1f710 74 65 72 6d 73 20 2a 2f 0a 76 6f 69 64 20 73 71 terms */.void sq
1f720 6c 69 74 65 33 45 78 70 72 49 66 54 72 75 65 28 lite3ExprIfTrue(
1f730 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 Parse*, Expr*, i
1f740 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
1f750 71 6c 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 qlite3ExprIfFals
1f760 65 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c e(Parse*, Expr*,
1f770 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 54 61 62 6c int, int);.Tabl
1f780 65 20 2a 73 71 6c 69 74 65 33 46 69 6e 64 54 61 e *sqlite3FindTa
1f790 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e ble(sqlite3*,con
1f7a0 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
1f7b0 63 68 61 72 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 char*);.Table *s
1f7c0 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 61 62 6c qlite3LocateTabl
1f7d0 65 28 50 61 72 73 65 2a 2c 69 6e 74 20 69 73 56 e(Parse*,int isV
1f7e0 69 65 77 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c iew,const char*,
1f7f0 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 54 const char*);.T
1f800 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 4c 6f 63 able *sqlite3Loc
1f810 61 74 65 54 61 62 6c 65 49 74 65 6d 28 50 61 72 ateTableItem(Par
1f820 73 65 2a 2c 69 6e 74 20 69 73 56 69 65 77 2c 73 se*,int isView,s
1f830 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 truct SrcList_it
1f840 65 6d 20 2a 29 3b 0a 49 6e 64 65 78 20 2a 73 71 em *);.Index *sq
1f850 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28 73 lite3FindIndex(s
1f860 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 qlite3*,const ch
1f870 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a ar*, const char*
1f880 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 );.void sqlite3U
1f890 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 54 61 nlinkAndDeleteTa
1f8a0 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 ble(sqlite3*,int
1f8b0 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 ,const char*);.v
1f8c0 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e oid sqlite3Unlin
1f8d0 6b 41 6e 64 44 65 6c 65 74 65 49 6e 64 65 78 28 kAndDeleteIndex(
1f8e0 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e sqlite3*,int,con
1f8f0 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 st char*);.void
1f900 73 71 6c 69 74 65 33 56 61 63 75 75 6d 28 50 61 sqlite3Vacuum(Pa
1f910 72 73 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 rse*);.int sqlit
1f920 65 33 52 75 6e 56 61 63 75 75 6d 28 63 68 61 72 e3RunVacuum(char
1f930 2a 2a 2c 20 73 71 6c 69 74 65 33 2a 29 3b 0a 63 **, sqlite3*);.c
1f940 68 61 72 20 2a 73 71 6c 69 74 65 33 4e 61 6d 65 har *sqlite3Name
1f950 46 72 6f 6d 54 6f 6b 65 6e 28 73 71 6c 69 74 65 FromToken(sqlite
1f960 33 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 3*, Token*);.int
1f970 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6d 70 sqlite3ExprComp
1f980 61 72 65 28 45 78 70 72 2a 2c 20 45 78 70 72 2a are(Expr*, Expr*
1f990 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 , int);.int sqli
1f9a0 74 65 33 45 78 70 72 4c 69 73 74 43 6f 6d 70 61 te3ExprListCompa
1f9b0 72 65 28 45 78 70 72 4c 69 73 74 2a 2c 20 45 78 re(ExprList*, Ex
1f9c0 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 3b 0a 69 prList*, int);.i
1f9d0 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 6d nt sqlite3ExprIm
1f9e0 70 6c 69 65 73 45 78 70 72 28 45 78 70 72 2a 2c pliesExpr(Expr*,
1f9f0 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f Expr*, int);.vo
1fa00 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e id sqlite3ExprAn
1fa10 61 6c 79 7a 65 41 67 67 72 65 67 61 74 65 73 28 alyzeAggregates(
1fa20 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 2c 20 45 78 NameContext*, Ex
1fa30 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 pr*);.void sqlit
1fa40 65 33 45 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 e3ExprAnalyzeAgg
1fa50 4c 69 73 74 28 4e 61 6d 65 43 6f 6e 74 65 78 74 List(NameContext
1fa60 2a 2c 45 78 70 72 4c 69 73 74 2a 29 3b 0a 69 6e *,ExprList*);.in
1fa70 74 20 73 71 6c 69 74 65 33 46 75 6e 63 74 69 6f t sqlite3Functio
1fa80 6e 55 73 65 73 54 68 69 73 53 72 63 28 45 78 70 nUsesThisSrc(Exp
1fa90 72 2a 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 56 r*, SrcList*);.V
1faa0 64 62 65 20 2a 73 71 6c 69 74 65 33 47 65 74 56 dbe *sqlite3GetV
1fab0 64 62 65 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 dbe(Parse*);.voi
1fac0 64 20 73 71 6c 69 74 65 33 50 72 6e 67 53 61 76 d sqlite3PrngSav
1fad0 65 53 74 61 74 65 28 76 6f 69 64 29 3b 0a 76 6f eState(void);.vo
1fae0 69 64 20 73 71 6c 69 74 65 33 50 72 6e 67 52 65 id sqlite3PrngRe
1faf0 73 74 6f 72 65 53 74 61 74 65 28 76 6f 69 64 29 storeState(void)
1fb00 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f ;.void sqlite3Ro
1fb10 6c 6c 62 61 63 6b 41 6c 6c 28 73 71 6c 69 74 65 llbackAll(sqlite
1fb20 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 3*,int);.void sq
1fb30 6c 69 74 65 33 43 6f 64 65 56 65 72 69 66 79 53 lite3CodeVerifyS
1fb40 63 68 65 6d 61 28 50 61 72 73 65 2a 2c 20 69 6e chema(Parse*, in
1fb50 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
1fb60 43 6f 64 65 56 65 72 69 66 79 4e 61 6d 65 64 53 CodeVerifyNamedS
1fb70 63 68 65 6d 61 28 50 61 72 73 65 2a 2c 20 63 6f chema(Parse*, co
1fb80 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 29 3b 0a nst char *zDb);.
1fb90 76 6f 69 64 20 73 71 6c 69 74 65 33 42 65 67 69 void sqlite3Begi
1fba0 6e 54 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 72 nTransaction(Par
1fbb0 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 se*, int);.void
1fbc0 73 71 6c 69 74 65 33 43 6f 6d 6d 69 74 54 72 61 sqlite3CommitTra
1fbd0 6e 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a 29 nsaction(Parse*)
1fbe0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 6f ;.void sqlite3Ro
1fbf0 6c 6c 62 61 63 6b 54 72 61 6e 73 61 63 74 69 6f llbackTransactio
1fc00 6e 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 n(Parse*);.void
1fc10 73 71 6c 69 74 65 33 53 61 76 65 70 6f 69 6e 74 sqlite3Savepoint
1fc20 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 54 6f (Parse*, int, To
1fc30 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ken*);.void sqli
1fc40 74 65 33 43 6c 6f 73 65 53 61 76 65 70 6f 69 6e te3CloseSavepoin
1fc50 74 73 28 73 71 6c 69 74 65 33 20 2a 29 3b 0a 76 ts(sqlite3 *);.v
1fc60 6f 69 64 20 73 71 6c 69 74 65 33 4c 65 61 76 65 oid sqlite3Leave
1fc70 4d 75 74 65 78 41 6e 64 43 6c 6f 73 65 5a 6f 6d MutexAndCloseZom
1fc80 62 69 65 28 73 71 6c 69 74 65 33 2a 29 3b 0a 69 bie(sqlite3*);.i
1fc90 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 73 nt sqlite3ExprIs
1fca0 43 6f 6e 73 74 61 6e 74 28 45 78 70 72 2a 29 3b Constant(Expr*);
1fcb0 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
1fcc0 49 73 43 6f 6e 73 74 61 6e 74 4e 6f 74 4a 6f 69 IsConstantNotJoi
1fcd0 6e 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 n(Expr*);.int sq
1fce0 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 lite3ExprIsConst
1fcf0 61 6e 74 4f 72 46 75 6e 63 74 69 6f 6e 28 45 78 antOrFunction(Ex
1fd00 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 pr*);.int sqlite
1fd10 33 45 78 70 72 49 73 49 6e 74 65 67 65 72 28 45 3ExprIsInteger(E
1fd20 78 70 72 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 xpr*, int*);.int
1fd30 20 73 71 6c 69 74 65 33 45 78 70 72 43 61 6e 42 sqlite3ExprCanB
1fd40 65 4e 75 6c 6c 28 63 6f 6e 73 74 20 45 78 70 72 eNull(const Expr
1fd50 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
1fd60 45 78 70 72 43 6f 64 65 49 73 4e 75 6c 6c 4a 75 ExprCodeIsNullJu
1fd70 6d 70 28 56 64 62 65 2a 2c 20 63 6f 6e 73 74 20 mp(Vdbe*, const
1fd80 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 Expr*, int, int)
1fd90 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 ;.int sqlite3Exp
1fda0 72 4e 65 65 64 73 4e 6f 41 66 66 69 6e 69 74 79 rNeedsNoAffinity
1fdb0 43 68 61 6e 67 65 28 63 6f 6e 73 74 20 45 78 70 Change(const Exp
1fdc0 72 2a 2c 20 63 68 61 72 29 3b 0a 69 6e 74 20 73 r*, char);.int s
1fdd0 71 6c 69 74 65 33 49 73 52 6f 77 69 64 28 63 6f qlite3IsRowid(co
1fde0 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 nst char*);.void
1fdf0 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 74 65 sqlite3Generate
1fe00 52 6f 77 44 65 6c 65 74 65 28 50 61 72 73 65 2a RowDelete(Parse*
1fe10 2c 54 61 62 6c 65 2a 2c 54 72 69 67 67 65 72 2a ,Table*,Trigger*
1fe20 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 31 36 ,int,int,int,i16
1fe30 2c 75 38 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 ,u8,u8,u8);.void
1fe40 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 74 65 sqlite3Generate
1fe50 52 6f 77 49 6e 64 65 78 44 65 6c 65 74 65 28 50 RowIndexDelete(P
1fe60 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 arse*, Table*, i
1fe70 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 29 3b 0a nt, int, int*);.
1fe80 69 6e 74 20 73 71 6c 69 74 65 33 47 65 6e 65 72 int sqlite3Gener
1fe90 61 74 65 49 6e 64 65 78 4b 65 79 28 50 61 72 73 ateIndexKey(Pars
1fea0 65 2a 2c 20 49 6e 64 65 78 2a 2c 20 69 6e 74 2c e*, Index*, int,
1feb0 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c int, int, int*,
1fec0 49 6e 64 65 78 2a 2c 69 6e 74 29 3b 0a 76 6f 69 Index*,int);.voi
1fed0 64 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 74 d sqlite3Generat
1fee0 65 43 6f 6e 73 74 72 61 69 6e 74 43 68 65 63 6b eConstraintCheck
1fef0 73 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c s(Parse*,Table*,
1ff00 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 int*,int,int,int
1ff10 2c 69 6e 74 2c 0a 20 20 20 20 20 20 20 20 20 20 ,int,.
1ff20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ff30 20 20 20 20 20 20 20 20 20 20 20 75 38 2c 75 38 u8,u8
1ff40 2c 69 6e 74 2c 69 6e 74 2a 29 3b 0a 76 6f 69 64 ,int,int*);.void
1ff50 20 73 71 6c 69 74 65 33 43 6f 6d 70 6c 65 74 65 sqlite3Complete
1ff60 49 6e 73 65 72 74 69 6f 6e 28 50 61 72 73 65 2a Insertion(Parse*
1ff70 2c 54 61 62 6c 65 2a 2c 69 6e 74 2c 69 6e 74 2c ,Table*,int,int,
1ff80 69 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 int,int*,int,int
1ff90 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ,int);.int sqlit
1ffa0 65 33 4f 70 65 6e 54 61 62 6c 65 41 6e 64 49 6e e3OpenTableAndIn
1ffb0 64 69 63 65 73 28 50 61 72 73 65 2a 2c 20 54 61 dices(Parse*, Ta
1ffc0 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 ble*, int, int,
1ffd0 75 38 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 2a 29 u8*, int*, int*)
1ffe0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 65 ;.void sqlite3Be
1fff0 67 69 6e 57 72 69 74 65 4f 70 65 72 61 74 69 6f ginWriteOperatio
20000 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 n(Parse*, int, i
20010 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
20020 33 4d 75 6c 74 69 57 72 69 74 65 28 50 61 72 73 3MultiWrite(Pars
20030 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
20040 33 4d 61 79 41 62 6f 72 74 28 50 61 72 73 65 2a 3MayAbort(Parse*
20050 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 48 );.void sqlite3H
20060 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 altConstraint(Pa
20070 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 rse*, int, int,
20080 63 68 61 72 2a 2c 20 69 38 2c 20 75 38 29 3b 0a char*, i8, u8);.
20090 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 69 71 void sqlite3Uniq
200a0 75 65 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 72 ueConstraint(Par
200b0 73 65 2a 2c 20 69 6e 74 2c 20 49 6e 64 65 78 2a se*, int, Index*
200c0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
200d0 6f 77 69 64 43 6f 6e 73 74 72 61 69 6e 74 28 50 owidConstraint(P
200e0 61 72 73 65 2a 2c 20 69 6e 74 2c 20 54 61 62 6c arse*, int, Tabl
200f0 65 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 e*);.Expr *sqlit
20100 65 33 45 78 70 72 44 75 70 28 73 71 6c 69 74 65 e3ExprDup(sqlite
20110 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b 0a 45 3*,Expr*,int);.E
20120 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 xprList *sqlite3
20130 45 78 70 72 4c 69 73 74 44 75 70 28 73 71 6c 69 ExprListDup(sqli
20140 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 te3*,ExprList*,i
20150 6e 74 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 nt);.SrcList *sq
20160 6c 69 74 65 33 53 72 63 4c 69 73 74 44 75 70 28 lite3SrcListDup(
20170 73 71 6c 69 74 65 33 2a 2c 53 72 63 4c 69 73 74 sqlite3*,SrcList
20180 2a 2c 69 6e 74 29 3b 0a 49 64 4c 69 73 74 20 2a *,int);.IdList *
20190 73 71 6c 69 74 65 33 49 64 4c 69 73 74 44 75 70 sqlite3IdListDup
201a0 28 73 71 6c 69 74 65 33 2a 2c 49 64 4c 69 73 74 (sqlite3*,IdList
201b0 2a 29 3b 0a 53 65 6c 65 63 74 20 2a 73 71 6c 69 *);.Select *sqli
201c0 74 65 33 53 65 6c 65 63 74 44 75 70 28 73 71 6c te3SelectDup(sql
201d0 69 74 65 33 2a 2c 53 65 6c 65 63 74 2a 2c 69 6e ite3*,Select*,in
201e0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
201f0 46 75 6e 63 44 65 66 49 6e 73 65 72 74 28 46 75 FuncDefInsert(Fu
20200 6e 63 44 65 66 48 61 73 68 2a 2c 20 46 75 6e 63 ncDefHash*, Func
20210 44 65 66 2a 29 3b 0a 46 75 6e 63 44 65 66 20 2a Def*);.FuncDef *
20220 73 71 6c 69 74 65 33 46 69 6e 64 46 75 6e 63 74 sqlite3FindFunct
20230 69 6f 6e 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e ion(sqlite3*,con
20240 73 74 20 63 68 61 72 2a 2c 69 6e 74 2c 69 6e 74 st char*,int,int
20250 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 20 73 71 ,u8,u8);.void sq
20260 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 75 69 lite3RegisterBui
20270 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 73 71 ltinFunctions(sq
20280 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 lite3*);.void sq
20290 6c 69 74 65 33 52 65 67 69 73 74 65 72 44 61 74 lite3RegisterDat
202a0 65 54 69 6d 65 46 75 6e 63 74 69 6f 6e 73 28 76 eTimeFunctions(v
202b0 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 oid);.void sqlit
202c0 65 33 52 65 67 69 73 74 65 72 47 6c 6f 62 61 6c e3RegisterGlobal
202d0 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 3b Functions(void);
202e0 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 61 66 65 .int sqlite3Safe
202f0 74 79 43 68 65 63 6b 4f 6b 28 73 71 6c 69 74 65 tyCheckOk(sqlite
20300 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 3*);.int sqlite3
20310 53 61 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f SafetyCheckSickO
20320 72 4f 6b 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 rOk(sqlite3*);.v
20330 6f 69 64 20 73 71 6c 69 74 65 33 43 68 61 6e 67 oid sqlite3Chang
20340 65 43 6f 6f 6b 69 65 28 50 61 72 73 65 2a 2c 20 eCookie(Parse*,
20350 69 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 69 int);..#if !defi
20360 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
20370 56 49 45 57 29 20 26 26 20 21 64 65 66 69 6e 65 VIEW) && !define
20380 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 d(SQLITE_OMIT_TR
20390 49 47 47 45 52 29 0a 76 6f 69 64 20 73 71 6c 69 IGGER).void sqli
203a0 74 65 33 4d 61 74 65 72 69 61 6c 69 7a 65 56 69 te3MaterializeVi
203b0 65 77 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 ew(Parse*, Table
203c0 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a *, Expr*, int);.
203d0 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
203e0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 SQLITE_OMIT_TRIG
203f0 47 45 52 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 GER. void sqlit
20400 65 33 42 65 67 69 6e 54 72 69 67 67 65 72 28 50 e3BeginTrigger(P
20410 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 54 6f arse*, Token*,To
20420 6b 65 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 49 64 4c ken*,int,int,IdL
20430 69 73 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 0a 20 ist*,SrcList*,.
20440 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20450 20 20 20 20 20 20 20 20 20 20 45 78 70 72 2a 2c Expr*,
20460 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 int, int);. voi
20470 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 54 d sqlite3FinishT
20480 72 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 rigger(Parse*, T
20490 72 69 67 67 65 72 53 74 65 70 2a 2c 20 54 6f 6b riggerStep*, Tok
204a0 65 6e 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c en*);. void sql
204b0 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 28 ite3DropTrigger(
204c0 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
204d0 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 , int);. void s
204e0 71 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 qlite3DropTrigge
204f0 72 50 74 72 28 50 61 72 73 65 2a 2c 20 54 72 69 rPtr(Parse*, Tri
20500 67 67 65 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 gger*);. Trigge
20510 72 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 r *sqlite3Trigge
20520 72 73 45 78 69 73 74 28 50 61 72 73 65 20 2a 2c rsExist(Parse *,
20530 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 45 78 Table*, int, Ex
20540 70 72 4c 69 73 74 2a 2c 20 69 6e 74 20 2a 70 4d prList*, int *pM
20550 61 73 6b 29 3b 0a 20 20 54 72 69 67 67 65 72 20 ask);. Trigger
20560 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 4c *sqlite3TriggerL
20570 69 73 74 28 50 61 72 73 65 20 2a 2c 20 54 61 62 ist(Parse *, Tab
20580 6c 65 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 le *);. void sq
20590 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 lite3CodeRowTrig
205a0 67 65 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 ger(Parse*, Trig
205b0 67 65 72 20 2a 2c 20 69 6e 74 2c 20 45 78 70 72 ger *, int, Expr
205c0 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 54 61 62 6c List*, int, Tabl
205d0 65 20 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 e *,.
205e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
205f0 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
20600 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 . void sqlite3C
20610 6f 64 65 52 6f 77 54 72 69 67 67 65 72 44 69 72 odeRowTriggerDir
20620 65 63 74 28 50 61 72 73 65 20 2a 2c 20 54 72 69 ect(Parse *, Tri
20630 67 67 65 72 20 2a 2c 20 54 61 62 6c 65 20 2a 2c gger *, Table *,
20640 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b int, int, int);
20650 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 56 69 . void sqliteVi
20660 65 77 54 72 69 67 67 65 72 73 28 50 61 72 73 65 ewTriggers(Parse
20670 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a *, Table*, Expr*
20680 2c 20 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a , int, ExprList*
20690 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
206a0 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 53 74 3DeleteTriggerSt
206b0 65 70 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 ep(sqlite3*, Tri
206c0 67 67 65 72 53 74 65 70 2a 29 3b 0a 20 20 54 72 ggerStep*);. Tr
206d0 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 iggerStep *sqlit
206e0 65 33 54 72 69 67 67 65 72 53 65 6c 65 63 74 53 e3TriggerSelectS
206f0 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c tep(sqlite3*,Sel
20700 65 63 74 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 ect*);. Trigger
20710 53 74 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 Step *sqlite3Tri
20720 67 67 65 72 49 6e 73 65 72 74 53 74 65 70 28 73 ggerInsertStep(s
20730 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 qlite3*,Token*,
20740 49 64 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 IdList*,.
20750 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20760 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20770 20 53 65 6c 65 63 74 2a 2c 75 38 29 3b 0a 20 20 Select*,u8);.
20780 54 72 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c TriggerStep *sql
20790 69 74 65 33 54 72 69 67 67 65 72 55 70 64 61 74 ite3TriggerUpdat
207a0 65 53 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 eStep(sqlite3*,T
207b0 6f 6b 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c oken*,ExprList*,
207c0 20 45 78 70 72 2a 2c 20 75 38 29 3b 0a 20 20 54 Expr*, u8);. T
207d0 72 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 riggerStep *sqli
207e0 74 65 33 54 72 69 67 67 65 72 44 65 6c 65 74 65 te3TriggerDelete
207f0 53 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 6f Step(sqlite3*,To
20800 6b 65 6e 2a 2c 20 45 78 70 72 2a 29 3b 0a 20 20 ken*, Expr*);.
20810 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 void sqlite3Dele
20820 74 65 54 72 69 67 67 65 72 28 73 71 6c 69 74 65 teTrigger(sqlite
20830 33 2a 2c 20 54 72 69 67 67 65 72 2a 29 3b 0a 20 3*, Trigger*);.
20840 20 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 6c void sqlite3Unl
20850 69 6e 6b 41 6e 64 44 65 6c 65 74 65 54 72 69 67 inkAndDeleteTrig
20860 67 65 72 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 ger(sqlite3*,int
20870 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 ,const char*);.
20880 20 75 33 32 20 73 71 6c 69 74 65 33 54 72 69 67 u32 sqlite3Trig
20890 67 65 72 43 6f 6c 6d 61 73 6b 28 50 61 72 73 65 gerColmask(Parse
208a0 2a 2c 54 72 69 67 67 65 72 2a 2c 45 78 70 72 4c *,Trigger*,ExprL
208b0 69 73 74 2a 2c 69 6e 74 2c 69 6e 74 2c 54 61 62 ist*,int,int,Tab
208c0 6c 65 2a 2c 69 6e 74 29 3b 0a 23 20 64 65 66 69 le*,int);.# defi
208d0 6e 65 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 ne sqlite3ParseT
208e0 6f 70 6c 65 76 65 6c 28 70 29 20 28 28 70 29 2d oplevel(p) ((p)-
208f0 3e 70 54 6f 70 6c 65 76 65 6c 20 3f 20 28 70 29 >pToplevel ? (p)
20900 2d 3e 70 54 6f 70 6c 65 76 65 6c 20 3a 20 28 70 ->pToplevel : (p
20910 29 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e )).#else.# defin
20920 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 e sqlite3Trigger
20930 73 45 78 69 73 74 28 42 2c 43 2c 44 2c 45 2c 46 sExist(B,C,D,E,F
20940 29 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ) 0.# define sql
20950 69 74 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 ite3DeleteTrigge
20960 72 28 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 20 r(A,B).# define
20970 73 71 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 sqlite3DropTrigg
20980 65 72 50 74 72 28 41 2c 42 29 0a 23 20 64 65 66 erPtr(A,B).# def
20990 69 6e 65 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e ine sqlite3Unlin
209a0 6b 41 6e 64 44 65 6c 65 74 65 54 72 69 67 67 65 kAndDeleteTrigge
209b0 72 28 41 2c 42 2c 43 29 0a 23 20 64 65 66 69 6e r(A,B,C).# defin
209c0 65 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 e sqlite3CodeRow
209d0 54 72 69 67 67 65 72 28 41 2c 42 2c 43 2c 44 2c Trigger(A,B,C,D,
209e0 45 2c 46 2c 47 2c 48 2c 49 29 0a 23 20 64 65 66 E,F,G,H,I).# def
209f0 69 6e 65 20 73 71 6c 69 74 65 33 43 6f 64 65 52 ine sqlite3CodeR
20a00 6f 77 54 72 69 67 67 65 72 44 69 72 65 63 74 28 owTriggerDirect(
20a10 41 2c 42 2c 43 2c 44 2c 45 2c 46 29 0a 23 20 64 A,B,C,D,E,F).# d
20a20 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 72 69 efine sqlite3Tri
20a30 67 67 65 72 4c 69 73 74 28 58 2c 20 59 29 20 30 ggerList(X, Y) 0
20a40 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
20a50 33 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 3ParseToplevel(p
20a60 29 20 70 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ) p.# define sql
20a70 69 74 65 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 ite3TriggerColma
20a80 73 6b 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 2c 47 sk(A,B,C,D,E,F,G
20a90 29 20 30 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 ) 0.#endif..int
20aa0 73 71 6c 69 74 65 33 4a 6f 69 6e 54 79 70 65 28 sqlite3JoinType(
20ab0 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 Parse*, Token*,
20ac0 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b Token*, Token*);
20ad0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 72 65 .void sqlite3Cre
20ae0 61 74 65 46 6f 72 65 69 67 6e 4b 65 79 28 50 61 ateForeignKey(Pa
20af0 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c rse*, ExprList*,
20b00 20 54 6f 6b 65 6e 2a 2c 20 45 78 70 72 4c 69 73 Token*, ExprLis
20b10 74 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 t*, int);.void s
20b20 71 6c 69 74 65 33 44 65 66 65 72 46 6f 72 65 69 qlite3DeferForei
20b30 67 6e 4b 65 79 28 50 61 72 73 65 2a 2c 20 69 6e gnKey(Parse*, in
20b40 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 t);.#ifndef SQLI
20b50 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a TE_OMIT_AUTHORIZ
20b60 41 54 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c ATION. void sql
20b70 69 74 65 33 41 75 74 68 52 65 61 64 28 50 61 72 ite3AuthRead(Par
20b80 73 65 2a 2c 45 78 70 72 2a 2c 53 63 68 65 6d 61 se*,Expr*,Schema
20b90 2a 2c 53 72 63 4c 69 73 74 2a 29 3b 0a 20 20 69 *,SrcList*);. i
20ba0 6e 74 20 73 71 6c 69 74 65 33 41 75 74 68 43 68 nt sqlite3AuthCh
20bb0 65 63 6b 28 50 61 72 73 65 2a 2c 69 6e 74 2c 20 eck(Parse*,int,
20bc0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
20bd0 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
20be0 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 char*);. void s
20bf0 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 65 78 qlite3AuthContex
20c00 74 50 75 73 68 28 50 61 72 73 65 2a 2c 20 41 75 tPush(Parse*, Au
20c10 74 68 43 6f 6e 74 65 78 74 2a 2c 20 63 6f 6e 73 thContext*, cons
20c20 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 t char*);. void
20c30 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 sqlite3AuthCont
20c40 65 78 74 50 6f 70 28 41 75 74 68 43 6f 6e 74 65 extPop(AuthConte
20c50 78 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 xt*);. int sqli
20c60 74 65 33 41 75 74 68 52 65 61 64 43 6f 6c 28 50 te3AuthReadCol(P
20c70 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 arse*, const cha
20c80 72 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 r *, const char
20c90 2a 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 0a 23 *, int);.#else.#
20ca0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 define sqlite3A
20cb0 75 74 68 52 65 61 64 28 61 2c 62 2c 63 2c 64 29 uthRead(a,b,c,d)
20cc0 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
20cd0 33 41 75 74 68 43 68 65 63 6b 28 61 2c 62 2c 63 3AuthCheck(a,b,c
20ce0 2c 64 2c 65 29 20 20 20 20 53 51 4c 49 54 45 5f ,d,e) SQLITE_
20cf0 4f 4b 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 OK.# define sqli
20d00 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 50 75 te3AuthContextPu
20d10 73 68 28 61 2c 62 2c 63 29 0a 23 20 64 65 66 69 sh(a,b,c).# defi
20d20 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f ne sqlite3AuthCo
20d30 6e 74 65 78 74 50 6f 70 28 61 29 20 20 28 28 76 ntextPop(a) ((v
20d40 6f 69 64 29 28 61 29 29 0a 23 65 6e 64 69 66 0a oid)(a)).#endif.
20d50 76 6f 69 64 20 73 71 6c 69 74 65 33 41 74 74 61 void sqlite3Atta
20d60 63 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a ch(Parse*, Expr*
20d70 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 29 3b , Expr*, Expr*);
20d80 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 74 .void sqlite3Det
20d90 61 63 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 ach(Parse*, Expr
20da0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
20db0 46 69 78 49 6e 69 74 28 44 62 46 69 78 65 72 2a FixInit(DbFixer*
20dc0 2c 20 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 63 , Parse*, int, c
20dd0 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 onst char*, cons
20de0 74 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 t Token*);.int s
20df0 71 6c 69 74 65 33 46 69 78 53 72 63 4c 69 73 74 qlite3FixSrcList
20e00 28 44 62 46 69 78 65 72 2a 2c 20 53 72 63 4c 69 (DbFixer*, SrcLi
20e10 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 st*);.int sqlite
20e20 33 46 69 78 53 65 6c 65 63 74 28 44 62 46 69 78 3FixSelect(DbFix
20e30 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 er*, Select*);.i
20e40 6e 74 20 73 71 6c 69 74 65 33 46 69 78 45 78 70 nt sqlite3FixExp
20e50 72 28 44 62 46 69 78 65 72 2a 2c 20 45 78 70 72 r(DbFixer*, Expr
20e60 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 *);.int sqlite3F
20e70 69 78 45 78 70 72 4c 69 73 74 28 44 62 46 69 78 ixExprList(DbFix
20e80 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b er*, ExprList*);
20e90 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 54 .int sqlite3FixT
20ea0 72 69 67 67 65 72 53 74 65 70 28 44 62 46 69 78 riggerStep(DbFix
20eb0 65 72 2a 2c 20 54 72 69 67 67 65 72 53 74 65 70 er*, TriggerStep
20ec0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 *);.int sqlite3A
20ed0 74 6f 46 28 63 6f 6e 73 74 20 63 68 61 72 20 2a toF(const char *
20ee0 7a 2c 20 64 6f 75 62 6c 65 2a 2c 20 69 6e 74 2c z, double*, int,
20ef0 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 u8);.int sqlite
20f00 33 47 65 74 49 6e 74 33 32 28 63 6f 6e 73 74 20 3GetInt32(const
20f10 63 68 61 72 20 2a 2c 20 69 6e 74 2a 29 3b 0a 69 char *, int*);.i
20f20 6e 74 20 73 71 6c 69 74 65 33 41 74 6f 69 28 63 nt sqlite3Atoi(c
20f30 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 onst char*);.int
20f40 20 73 71 6c 69 74 65 33 55 74 66 31 36 42 79 74 sqlite3Utf16Byt
20f50 65 4c 65 6e 28 63 6f 6e 73 74 20 76 6f 69 64 20 eLen(const void
20f60 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e 43 68 61 *pData, int nCha
20f70 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 r);.int sqlite3U
20f80 74 66 38 43 68 61 72 4c 65 6e 28 63 6f 6e 73 74 tf8CharLen(const
20f90 20 63 68 61 72 20 2a 70 44 61 74 61 2c 20 69 6e char *pData, in
20fa0 74 20 6e 42 79 74 65 29 3b 0a 75 33 32 20 73 71 t nByte);.u32 sq
20fb0 6c 69 74 65 33 55 74 66 38 52 65 61 64 28 63 6f lite3Utf8Read(co
20fc0 6e 73 74 20 75 38 2a 2a 29 3b 0a 4c 6f 67 45 73 nst u8**);.LogEs
20fd0 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 t sqlite3LogEst(
20fe0 75 36 34 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c u64);.LogEst sql
20ff0 69 74 65 33 4c 6f 67 45 73 74 41 64 64 28 4c 6f ite3LogEstAdd(Lo
21000 67 45 73 74 2c 4c 6f 67 45 73 74 29 3b 0a 23 69 gEst,LogEst);.#i
21010 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
21020 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 4c T_VIRTUALTABLE.L
21030 6f 67 45 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 ogEst sqlite3Log
21040 45 73 74 46 72 6f 6d 44 6f 75 62 6c 65 28 64 6f EstFromDouble(do
21050 75 62 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 75 36 uble);.#endif.u6
21060 34 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 54 4 sqlite3LogEstT
21070 6f 49 6e 74 28 4c 6f 67 45 73 74 29 3b 0a 0a 2f oInt(LogEst);../
21080 2a 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 74 6f *.** Routines to
21090 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 read and write
210a0 76 61 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 variable-length
210b0 69 6e 74 65 67 65 72 73 2e 20 20 54 68 65 73 65 integers. These
210c0 20 75 73 65 64 20 74 6f 0a 2a 2a 20 62 65 20 64 used to.** be d
210d0 65 66 69 6e 65 64 20 6c 6f 63 61 6c 6c 79 2c 20 efined locally,
210e0 62 75 74 20 6e 6f 77 20 77 65 20 75 73 65 20 74 but now we use t
210f0 68 65 20 76 61 72 69 6e 74 20 72 6f 75 74 69 6e he varint routin
21100 65 73 20 69 6e 20 74 68 65 20 75 74 69 6c 2e 63 es in the util.c
21110 0a 2a 2a 20 66 69 6c 65 2e 20 20 43 6f 64 65 20 .** file. Code
21120 73 68 6f 75 6c 64 20 75 73 65 20 74 68 65 20 4d should use the M
21130 41 43 52 4f 20 66 6f 72 6d 73 20 62 65 6c 6f 77 ACRO forms below
21140 2c 20 61 73 20 74 68 65 20 56 61 72 69 6e 74 33 , as the Varint3
21150 32 20 76 65 72 73 69 6f 6e 73 0a 2a 2a 20 61 72 2 versions.** ar
21160 65 20 63 6f 64 65 64 20 74 6f 20 61 73 73 75 6d e coded to assum
21170 65 20 74 68 65 20 73 69 6e 67 6c 65 20 62 79 74 e the single byt
21180 65 20 63 61 73 65 20 69 73 20 61 6c 72 65 61 64 e case is alread
21190 79 20 68 61 6e 64 6c 65 64 20 28 77 68 69 63 68 y handled (which
211a0 20 0a 2a 2a 20 74 68 65 20 4d 41 43 52 4f 20 66 .** the MACRO f
211b0 6f 72 6d 20 64 6f 65 73 29 2e 0a 2a 2f 0a 69 6e orm does)..*/.in
211c0 74 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 t sqlite3PutVari
211d0 6e 74 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 nt(unsigned char
211e0 2a 2c 20 75 36 34 29 3b 0a 69 6e 74 20 73 71 6c *, u64);.int sql
211f0 69 74 65 33 50 75 74 56 61 72 69 6e 74 33 32 28 ite3PutVarint32(
21200 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 2c 20 unsigned char*,
21210 75 33 32 29 3b 0a 75 38 20 73 71 6c 69 74 65 33 u32);.u8 sqlite3
21220 47 65 74 56 61 72 69 6e 74 28 63 6f 6e 73 74 20 GetVarint(const
21230 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 2c unsigned char *,
21240 20 75 36 34 20 2a 29 3b 0a 75 38 20 73 71 6c 69 u64 *);.u8 sqli
21250 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 63 te3GetVarint32(c
21260 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
21270 61 72 20 2a 2c 20 75 33 32 20 2a 29 3b 0a 69 6e ar *, u32 *);.in
21280 74 20 73 71 6c 69 74 65 33 56 61 72 69 6e 74 4c t sqlite3VarintL
21290 65 6e 28 75 36 34 20 76 29 3b 0a 0a 2f 2a 0a 2a en(u64 v);../*.*
212a0 2a 20 54 68 65 20 68 65 61 64 65 72 20 6f 66 20 * The header of
212b0 61 20 72 65 63 6f 72 64 20 63 6f 6e 73 69 73 74 a record consist
212c0 73 20 6f 66 20 61 20 73 65 71 75 65 6e 63 65 20 s of a sequence
212d0 76 61 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 variable-length
212e0 69 6e 74 65 67 65 72 73 2e 0a 2a 2a 20 54 68 65 integers..** The
212f0 73 65 20 69 6e 74 65 67 65 72 73 20 61 72 65 20 se integers are
21300 61 6c 6d 6f 73 74 20 61 6c 77 61 79 73 20 73 6d almost always sm
21310 61 6c 6c 20 61 6e 64 20 61 72 65 20 65 6e 63 6f all and are enco
21320 64 65 64 20 61 73 20 61 20 73 69 6e 67 6c 65 20 ded as a single
21330 62 79 74 65 2e 0a 2a 2a 20 54 68 65 20 66 6f 6c byte..** The fol
21340 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 74 61 lowing macros ta
21350 6b 65 20 61 64 76 61 6e 74 61 67 65 20 74 68 69 ke advantage thi
21360 73 20 66 61 63 74 20 74 6f 20 70 72 6f 76 69 64 s fact to provid
21370 65 20 61 20 66 61 73 74 20 65 6e 63 6f 64 65 0a e a fast encode.
21380 2a 2a 20 61 6e 64 20 64 65 63 6f 64 65 20 6f 66 ** and decode of
21390 20 74 68 65 20 69 6e 74 65 67 65 72 73 20 69 6e the integers in
213a0 20 61 20 72 65 63 6f 72 64 20 68 65 61 64 65 72 a record header
213b0 2e 20 20 49 74 20 69 73 20 66 61 73 74 65 72 20 . It is faster
213c0 66 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 0a 2a for the common.*
213d0 2a 20 63 61 73 65 20 77 68 65 72 65 20 74 68 65 * case where the
213e0 20 69 6e 74 65 67 65 72 20 69 73 20 61 20 73 69 integer is a si
213f0 6e 67 6c 65 20 62 79 74 65 2e 20 20 49 74 20 69 ngle byte. It i
21400 73 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f 77 65 s a little slowe
21410 72 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 69 6e r when the.** in
21420 74 65 67 65 72 20 69 73 20 74 77 6f 20 6f 72 20 teger is two or
21430 6d 6f 72 65 20 62 79 74 65 73 2e 20 20 42 75 74 more bytes. But
21440 20 6f 76 65 72 61 6c 6c 20 69 74 20 69 73 20 66 overall it is f
21450 61 73 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 aster..**.** The
21460 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 70 72 65 following expre
21470 73 73 69 6f 6e 73 20 61 72 65 20 65 71 75 69 76 ssions are equiv
21480 61 6c 65 6e 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 alent:.**.**
21490 20 78 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 x = sqlite3GetV
214a0 61 72 69 6e 74 33 32 28 20 41 2c 20 26 42 20 29 arint32( A, &B )
214b0 3b 0a 2a 2a 20 20 20 20 20 78 20 3d 20 73 71 6c ;.** x = sql
214c0 69 74 65 33 50 75 74 56 61 72 69 6e 74 33 32 28 ite3PutVarint32(
214d0 20 41 2c 20 42 20 29 3b 0a 2a 2a 0a 2a 2a 20 20 A, B );.**.**
214e0 20 20 20 78 20 3d 20 67 65 74 56 61 72 69 6e 74 x = getVarint
214f0 33 32 28 20 41 2c 20 42 20 29 3b 0a 2a 2a 20 20 32( A, B );.**
21500 20 20 20 78 20 3d 20 70 75 74 56 61 72 69 6e 74 x = putVarint
21510 33 32 28 20 41 2c 20 42 20 29 3b 0a 2a 2a 0a 2a 32( A, B );.**.*
21520 2f 0a 23 64 65 66 69 6e 65 20 67 65 74 56 61 72 /.#define getVar
21530 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a 20 20 int32(A,B) \.
21540 28 75 38 29 28 28 2a 28 41 29 3c 28 75 38 29 30 (u8)((*(A)<(u8)0
21550 78 38 30 29 3f 28 28 42 29 3d 28 75 33 32 29 2a x80)?((B)=(u32)*
21560 28 41 29 29 2c 31 3a 73 71 6c 69 74 65 33 47 65 (A)),1:sqlite3Ge
21570 74 56 61 72 69 6e 74 33 32 28 28 41 29 2c 28 75 tVarint32((A),(u
21580 33 32 20 2a 29 26 28 42 29 29 29 0a 23 64 65 66 32 *)&(B))).#def
21590 69 6e 65 20 70 75 74 56 61 72 69 6e 74 33 32 28 ine putVarint32(
215a0 41 2c 42 29 20 20 5c 0a 20 20 28 75 38 29 28 28 A,B) \. (u8)((
215b0 28 75 33 32 29 28 42 29 3c 28 75 33 32 29 30 78 (u32)(B)<(u32)0x
215c0 38 30 29 3f 28 2a 28 41 29 3d 28 75 6e 73 69 67 80)?(*(A)=(unsig
215d0 6e 65 64 20 63 68 61 72 29 28 42 29 29 2c 31 3a ned char)(B)),1:
215e0 5c 0a 20 20 73 71 6c 69 74 65 33 50 75 74 56 61 \. sqlite3PutVa
215f0 72 69 6e 74 33 32 28 28 41 29 2c 28 42 29 29 29 rint32((A),(B)))
21600 0a 23 64 65 66 69 6e 65 20 67 65 74 56 61 72 69 .#define getVari
21610 6e 74 20 20 20 20 73 71 6c 69 74 65 33 47 65 74 nt sqlite3Get
21620 56 61 72 69 6e 74 0a 23 64 65 66 69 6e 65 20 70 Varint.#define p
21630 75 74 56 61 72 69 6e 74 20 20 20 20 73 71 6c 69 utVarint sqli
21640 74 65 33 50 75 74 56 61 72 69 6e 74 0a 0a 0a 63 te3PutVarint...c
21650 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 onst char *sqlit
21660 65 33 49 6e 64 65 78 41 66 66 69 6e 69 74 79 53 e3IndexAffinityS
21670 74 72 28 56 64 62 65 20 2a 2c 20 49 6e 64 65 78 tr(Vdbe *, Index
21680 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);.void sqlite
21690 33 54 61 62 6c 65 41 66 66 69 6e 69 74 79 53 74 3TableAffinitySt
216a0 72 28 56 64 62 65 20 2a 2c 20 54 61 62 6c 65 20 r(Vdbe *, Table
216b0 2a 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 65 33 *);.char sqlite3
216c0 43 6f 6d 70 61 72 65 41 66 66 69 6e 69 74 79 28 CompareAffinity(
216d0 45 78 70 72 20 2a 70 45 78 70 72 2c 20 63 68 61 Expr *pExpr, cha
216e0 72 20 61 66 66 32 29 3b 0a 69 6e 74 20 73 71 6c r aff2);.int sql
216f0 69 74 65 33 49 6e 64 65 78 41 66 66 69 6e 69 74 ite3IndexAffinit
21700 79 4f 6b 28 45 78 70 72 20 2a 70 45 78 70 72 2c yOk(Expr *pExpr,
21710 20 63 68 61 72 20 69 64 78 5f 61 66 66 69 6e 69 char idx_affini
21720 74 79 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 65 ty);.char sqlite
21730 33 45 78 70 72 41 66 66 69 6e 69 74 79 28 45 78 3ExprAffinity(Ex
21740 70 72 20 2a 70 45 78 70 72 29 3b 0a 69 6e 74 20 pr *pExpr);.int
21750 73 71 6c 69 74 65 33 41 74 6f 69 36 34 28 63 6f sqlite3Atoi64(co
21760 6e 73 74 20 63 68 61 72 2a 2c 20 69 36 34 2a 2c nst char*, i64*,
21770 20 69 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 int, u8);.void
21780 73 71 6c 69 74 65 33 45 72 72 6f 72 28 73 71 6c sqlite3Error(sql
21790 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e 73 ite3*, int, cons
217a0 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a 76 6f t char*,...);.vo
217b0 69 64 20 2a 73 71 6c 69 74 65 33 48 65 78 54 6f id *sqlite3HexTo
217c0 42 6c 6f 62 28 73 71 6c 69 74 65 33 2a 2c 20 63 Blob(sqlite3*, c
217d0 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 20 69 6e onst char *z, in
217e0 74 20 6e 29 3b 0a 75 38 20 73 71 6c 69 74 65 33 t n);.u8 sqlite3
217f0 48 65 78 54 6f 49 6e 74 28 69 6e 74 20 68 29 3b HexToInt(int h);
21800 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 77 6f 50 .int sqlite3TwoP
21810 61 72 74 4e 61 6d 65 28 50 61 72 73 65 20 2a 2c artName(Parse *,
21820 20 54 6f 6b 65 6e 20 2a 2c 20 54 6f 6b 65 6e 20 Token *, Token
21830 2a 2c 20 54 6f 6b 65 6e 20 2a 2a 29 3b 0a 0a 23 *, Token **);..#
21840 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
21850 45 5f 54 45 53 54 29 20 0a 63 6f 6e 73 74 20 63 E_TEST) .const c
21860 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 4e har *sqlite3ErrN
21870 61 6d 65 28 69 6e 74 29 3b 0a 23 65 6e 64 69 66 ame(int);.#endif
21880 0a 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 ..const char *sq
21890 6c 69 74 65 33 45 72 72 53 74 72 28 69 6e 74 29 lite3ErrStr(int)
218a0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 61 ;.int sqlite3Rea
218b0 64 53 63 68 65 6d 61 28 50 61 72 73 65 20 2a 70 dSchema(Parse *p
218c0 50 61 72 73 65 29 3b 0a 43 6f 6c 6c 53 65 71 20 Parse);.CollSeq
218d0 2a 73 71 6c 69 74 65 33 46 69 6e 64 43 6f 6c 6c *sqlite3FindColl
218e0 53 65 71 28 73 71 6c 69 74 65 33 2a 2c 75 38 20 Seq(sqlite3*,u8
218f0 65 6e 63 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a enc, const char*
21900 2c 69 6e 74 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a ,int);.CollSeq *
21910 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 43 6f 6c sqlite3LocateCol
21920 6c 53 65 71 28 50 61 72 73 65 20 2a 70 50 61 72 lSeq(Parse *pPar
21930 73 65 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 7a se, const char*z
21940 4e 61 6d 65 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a Name);.CollSeq *
21950 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6c 6c 53 sqlite3ExprCollS
21960 65 71 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 eq(Parse *pParse
21970 2c 20 45 78 70 72 20 2a 70 45 78 70 72 29 3b 0a , Expr *pExpr);.
21980 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
21990 72 41 64 64 43 6f 6c 6c 61 74 65 54 6f 6b 65 6e rAddCollateToken
219a0 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 (Parse *pParse,
219b0 45 78 70 72 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a Expr*, Token*);.
219c0 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
219d0 72 41 64 64 43 6f 6c 6c 61 74 65 53 74 72 69 6e rAddCollateStrin
219e0 67 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c 63 g(Parse*,Expr*,c
219f0 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 45 78 70 onst char*);.Exp
21a00 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 53 6b r *sqlite3ExprSk
21a10 69 70 43 6f 6c 6c 61 74 65 28 45 78 70 72 2a 29 ipCollate(Expr*)
21a20 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 68 65 ;.int sqlite3Che
21a30 63 6b 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 ckCollSeq(Parse
21a40 2a 2c 20 43 6f 6c 6c 53 65 71 20 2a 29 3b 0a 69 *, CollSeq *);.i
21a50 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 6b 4f nt sqlite3CheckO
21a60 62 6a 65 63 74 4e 61 6d 65 28 50 61 72 73 65 20 bjectName(Parse
21a70 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 *, const char *)
21a80 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 ;.void sqlite3Vd
21a90 62 65 53 65 74 43 68 61 6e 67 65 73 28 73 71 6c beSetChanges(sql
21aa0 69 74 65 33 20 2a 2c 20 69 6e 74 29 3b 0a 69 6e ite3 *, int);.in
21ab0 74 20 73 71 6c 69 74 65 33 41 64 64 49 6e 74 36 t sqlite3AddInt6
21ac0 34 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 4(i64*,i64);.int
21ad0 20 73 71 6c 69 74 65 33 53 75 62 49 6e 74 36 34 sqlite3SubInt64
21ae0 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 (i64*,i64);.int
21af0 73 71 6c 69 74 65 33 4d 75 6c 49 6e 74 36 34 28 sqlite3MulInt64(
21b00 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 73 i64*,i64);.int s
21b10 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 28 69 qlite3AbsInt32(i
21b20 6e 74 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 nt);.#ifdef SQLI
21b30 54 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 5f 4e 41 TE_ENABLE_8_3_NA
21b40 4d 45 53 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 MES.void sqlite3
21b50 46 69 6c 65 53 75 66 66 69 78 33 28 63 6f 6e 73 FileSuffix3(cons
21b60 74 20 63 68 61 72 2a 2c 20 63 68 61 72 2a 29 3b t char*, char*);
21b70 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
21b80 73 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 69 sqlite3FileSuffi
21b90 78 33 28 58 2c 59 29 0a 23 65 6e 64 69 66 0a 75 x3(X,Y).#endif.u
21ba0 38 20 73 71 6c 69 74 65 33 47 65 74 42 6f 6f 6c 8 sqlite3GetBool
21bb0 65 61 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a ean(const char *
21bc0 7a 2c 69 6e 74 29 3b 0a 0a 63 6f 6e 73 74 20 76 z,int);..const v
21bd0 6f 69 64 20 2a 73 71 6c 69 74 65 33 56 61 6c 75 oid *sqlite3Valu
21be0 65 54 65 78 74 28 73 71 6c 69 74 65 33 5f 76 61 eText(sqlite3_va
21bf0 6c 75 65 2a 2c 20 75 38 29 3b 0a 69 6e 74 20 73 lue*, u8);.int s
21c00 71 6c 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 qlite3ValueBytes
21c10 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2c (sqlite3_value*,
21c20 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 u8);.void sqlit
21c30 65 33 56 61 6c 75 65 53 65 74 53 74 72 28 73 71 e3ValueSetStr(sq
21c40 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2c 20 69 6e lite3_value*, in
21c50 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2c t, const void *,
21c60 75 38 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 u8, .
21c70 20 20 20 20 20 20 20 20 20 20 20 20 20 76 6f 69 voi
21c80 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f d(*)(void*));.vo
21c90 69 64 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 id sqlite3ValueS
21ca0 65 74 4e 75 6c 6c 28 73 71 6c 69 74 65 33 5f 76 etNull(sqlite3_v
21cb0 61 6c 75 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c alue*);.void sql
21cc0 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 73 71 ite3ValueFree(sq
21cd0 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 3b 0a 73 lite3_value*);.s
21ce0 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 73 71 qlite3_value *sq
21cf0 6c 69 74 65 33 56 61 6c 75 65 4e 65 77 28 73 71 lite3ValueNew(sq
21d00 6c 69 74 65 33 20 2a 29 3b 0a 63 68 61 72 20 2a lite3 *);.char *
21d10 73 71 6c 69 74 65 33 55 74 66 31 36 74 6f 38 28 sqlite3Utf16to8(
21d20 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 sqlite3 *, const
21d30 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 75 38 29 void*, int, u8)
21d40 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 61 6c ;.int sqlite3Val
21d50 75 65 46 72 6f 6d 45 78 70 72 28 73 71 6c 69 74 ueFromExpr(sqlit
21d60 65 33 20 2a 2c 20 45 78 70 72 20 2a 2c 20 75 38 e3 *, Expr *, u8
21d70 2c 20 75 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 , u8, sqlite3_va
21d80 6c 75 65 20 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 lue **);.void sq
21d90 6c 69 74 65 33 56 61 6c 75 65 41 70 70 6c 79 41 lite3ValueApplyA
21da0 66 66 69 6e 69 74 79 28 73 71 6c 69 74 65 33 5f ffinity(sqlite3_
21db0 76 61 6c 75 65 20 2a 2c 20 75 38 2c 20 75 38 29 value *, u8, u8)
21dc0 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
21dd0 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e 0a 65 78 _AMALGAMATION.ex
21de0 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 tern const unsig
21df0 6e 65 64 20 63 68 61 72 20 73 71 6c 69 74 65 33 ned char sqlite3
21e00 4f 70 63 6f 64 65 50 72 6f 70 65 72 74 79 5b 5d OpcodeProperty[]
21e10 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 ;.extern const u
21e20 6e 73 69 67 6e 65 64 20 63 68 61 72 20 73 71 6c nsigned char sql
21e30 69 74 65 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 ite3UpperToLower
21e40 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 [];.extern const
21e50 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 73 unsigned char s
21e60 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b 5d qlite3CtypeMap[]
21e70 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 54 ;.extern const T
21e80 6f 6b 65 6e 20 73 71 6c 69 74 65 33 49 6e 74 54 oken sqlite3IntT
21e90 6f 6b 65 6e 73 5b 5d 3b 0a 65 78 74 65 72 6e 20 okens[];.extern
21ea0 53 51 4c 49 54 45 5f 57 53 44 20 73 74 72 75 63 SQLITE_WSD struc
21eb0 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 67 20 t Sqlite3Config
21ec0 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 3b 0a 65 sqlite3Config;.e
21ed0 78 74 65 72 6e 20 53 51 4c 49 54 45 5f 57 53 44 xtern SQLITE_WSD
21ee0 20 46 75 6e 63 44 65 66 48 61 73 68 20 73 71 6c FuncDefHash sql
21ef0 69 74 65 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 ite3GlobalFuncti
21f00 6f 6e 73 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c ons;.#ifndef SQL
21f10 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 65 78 74 ITE_OMIT_WSD.ext
21f20 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 50 ern int sqlite3P
21f30 65 6e 64 69 6e 67 42 79 74 65 3b 0a 23 65 6e 64 endingByte;.#end
21f40 69 66 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 if.#endif.void s
21f50 71 6c 69 74 65 33 52 6f 6f 74 50 61 67 65 4d 6f qlite3RootPageMo
21f60 76 65 64 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e ved(sqlite3*, in
21f70 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f t, int, int);.vo
21f80 69 64 20 73 71 6c 69 74 65 33 52 65 69 6e 64 65 id sqlite3Reinde
21f90 78 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a x(Parse*, Token*
21fa0 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 , Token*);.void
21fb0 73 71 6c 69 74 65 33 41 6c 74 65 72 46 75 6e 63 sqlite3AlterFunc
21fc0 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a 76 6f 69 tions(void);.voi
21fd0 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 52 65 d sqlite3AlterRe
21fe0 6e 61 6d 65 54 61 62 6c 65 28 50 61 72 73 65 2a nameTable(Parse*
21ff0 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f 6b 65 , SrcList*, Toke
22000 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 n*);.int sqlite3
22010 47 65 74 54 6f 6b 65 6e 28 63 6f 6e 73 74 20 75 GetToken(const u
22020 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 2c 20 nsigned char *,
22030 69 6e 74 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c int *);.void sql
22040 69 74 65 33 4e 65 73 74 65 64 50 61 72 73 65 28 ite3NestedParse(
22050 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 Parse*, const ch
22060 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 64 20 ar*, ...);.void
22070 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 72 65 sqlite3ExpirePre
22080 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73 28 paredStatements(
22090 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 sqlite3*);.int s
220a0 71 6c 69 74 65 33 43 6f 64 65 53 75 62 73 65 6c qlite3CodeSubsel
220b0 65 63 74 28 50 61 72 73 65 20 2a 2c 20 45 78 70 ect(Parse *, Exp
220c0 72 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a r *, int, int);.
220d0 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 void sqlite3Sele
220e0 63 74 50 72 65 70 28 50 61 72 73 65 2a 2c 20 53 ctPrep(Parse*, S
220f0 65 6c 65 63 74 2a 2c 20 4e 61 6d 65 43 6f 6e 74 elect*, NameCont
22100 65 78 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ext*);.int sqlit
22110 65 33 4d 61 74 63 68 53 70 61 6e 4e 61 6d 65 28 e3MatchSpanName(
22120 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
22130 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
22140 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 char*, const cha
22150 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
22160 52 65 73 6f 6c 76 65 45 78 70 72 4e 61 6d 65 73 ResolveExprNames
22170 28 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 2c 20 45 (NameContext*, E
22180 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
22190 74 65 33 52 65 73 6f 6c 76 65 53 65 6c 65 63 74 te3ResolveSelect
221a0 4e 61 6d 65 73 28 50 61 72 73 65 2a 2c 20 53 65 Names(Parse*, Se
221b0 6c 65 63 74 2a 2c 20 4e 61 6d 65 43 6f 6e 74 65 lect*, NameConte
221c0 78 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 xt*);.void sqlit
221d0 65 33 52 65 73 6f 6c 76 65 53 65 6c 66 52 65 66 e3ResolveSelfRef
221e0 65 72 65 6e 63 65 28 50 61 72 73 65 2a 2c 54 61 erence(Parse*,Ta
221f0 62 6c 65 2a 2c 69 6e 74 2c 45 78 70 72 2a 2c 45 ble*,int,Expr*,E
22200 78 70 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 xprList*);.int s
22210 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 4f 72 64 qlite3ResolveOrd
22220 65 72 47 72 6f 75 70 42 79 28 50 61 72 73 65 2a erGroupBy(Parse*
22230 2c 20 53 65 6c 65 63 74 2a 2c 20 45 78 70 72 4c , Select*, ExprL
22240 69 73 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 ist*, const char
22250 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
22260 43 6f 6c 75 6d 6e 44 65 66 61 75 6c 74 28 56 64 ColumnDefault(Vd
22270 62 65 20 2a 2c 20 54 61 62 6c 65 20 2a 2c 20 69 be *, Table *, i
22280 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
22290 71 6c 69 74 65 33 41 6c 74 65 72 46 69 6e 69 73 qlite3AlterFinis
222a0 68 41 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 hAddColumn(Parse
222b0 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b 0a 76 6f *, Token *);.vo
222c0 69 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 42 id sqlite3AlterB
222d0 65 67 69 6e 41 64 64 43 6f 6c 75 6d 6e 28 50 61 eginAddColumn(Pa
222e0 72 73 65 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a rse *, SrcList *
222f0 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 );.CollSeq *sqli
22300 74 65 33 47 65 74 43 6f 6c 6c 53 65 71 28 50 61 te3GetCollSeq(Pa
22310 72 73 65 2a 2c 20 75 38 2c 20 43 6f 6c 6c 53 65 rse*, u8, CollSe
22320 71 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a q *, const char*
22330 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 65 33 41 );.char sqlite3A
22340 66 66 69 6e 69 74 79 54 79 70 65 28 63 6f 6e 73 ffinityType(cons
22350 74 20 63 68 61 72 2a 2c 20 75 38 2a 29 3b 0a 76 t char*, u8*);.v
22360 6f 69 64 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 oid sqlite3Analy
22370 7a 65 28 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e ze(Parse*, Token
22380 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 *, Token*);.int
22390 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 42 75 73 sqlite3InvokeBus
223a0 79 48 61 6e 64 6c 65 72 28 42 75 73 79 48 61 6e yHandler(BusyHan
223b0 64 6c 65 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 dler*);.int sqli
223c0 74 65 33 46 69 6e 64 44 62 28 73 71 6c 69 74 65 te3FindDb(sqlite
223d0 33 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 3*, Token*);.int
223e0 20 73 71 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 sqlite3FindDbNa
223f0 6d 65 28 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f me(sqlite3 *, co
22400 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 69 6e 74 nst char *);.int
22410 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 73 69 73 sqlite3Analysis
22420 4c 6f 61 64 28 73 71 6c 69 74 65 33 2a 2c 69 6e Load(sqlite3*,in
22430 74 20 69 44 42 29 3b 0a 76 6f 69 64 20 73 71 6c t iDB);.void sql
22440 69 74 65 33 44 65 6c 65 74 65 49 6e 64 65 78 53 ite3DeleteIndexS
22450 61 6d 70 6c 65 73 28 73 71 6c 69 74 65 33 2a 2c amples(sqlite3*,
22460 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 Index*);.void sq
22470 6c 69 74 65 33 44 65 66 61 75 6c 74 52 6f 77 45 lite3DefaultRowE
22480 73 74 28 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 st(Index*);.void
22490 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 72 sqlite3Register
224a0 4c 69 6b 65 46 75 6e 63 74 69 6f 6e 73 28 73 71 LikeFunctions(sq
224b0 6c 69 74 65 33 2a 2c 20 69 6e 74 29 3b 0a 69 6e lite3*, int);.in
224c0 74 20 73 71 6c 69 74 65 33 49 73 4c 69 6b 65 46 t sqlite3IsLikeF
224d0 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a unction(sqlite3*
224e0 2c 45 78 70 72 2a 2c 69 6e 74 2a 2c 63 68 61 72 ,Expr*,int*,char
224f0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
22500 4d 69 6e 69 6d 75 6d 46 69 6c 65 46 6f 72 6d 61 MinimumFileForma
22510 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 t(Parse*, int, i
22520 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
22530 33 53 63 68 65 6d 61 43 6c 65 61 72 28 76 6f 69 3SchemaClear(voi
22540 64 20 2a 29 3b 0a 53 63 68 65 6d 61 20 2a 73 71 d *);.Schema *sq
22550 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74 28 73 lite3SchemaGet(s
22560 71 6c 69 74 65 33 20 2a 2c 20 42 74 72 65 65 20 qlite3 *, Btree
22570 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 *);.int sqlite3S
22580 63 68 65 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c chemaToIndex(sql
22590 69 74 65 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 ite3 *db, Schema
225a0 20 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 *);.KeyInfo *sq
225b0 6c 69 74 65 33 4b 65 79 49 6e 66 6f 41 6c 6c 6f lite3KeyInfoAllo
225c0 63 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 69 c(sqlite3*,int,i
225d0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
225e0 33 4b 65 79 49 6e 66 6f 55 6e 72 65 66 28 4b 65 3KeyInfoUnref(Ke
225f0 79 49 6e 66 6f 2a 29 3b 0a 4b 65 79 49 6e 66 6f yInfo*);.KeyInfo
22600 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f *sqlite3KeyInfo
22610 52 65 66 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b Ref(KeyInfo*);.K
22620 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 4b eyInfo *sqlite3K
22630 65 79 49 6e 66 6f 4f 66 49 6e 64 65 78 28 50 61 eyInfoOfIndex(Pa
22640 72 73 65 2a 2c 20 49 6e 64 65 78 2a 29 3b 0a 23 rse*, Index*);.#
22650 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
22660 55 47 0a 69 6e 74 20 73 71 6c 69 74 65 33 4b 65 UG.int sqlite3Ke
22670 79 49 6e 66 6f 49 73 57 72 69 74 65 61 62 6c 65 yInfoIsWriteable
22680 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 23 65 6e 64 (KeyInfo*);.#end
22690 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 72 if.int sqlite3Cr
226a0 65 61 74 65 46 75 6e 63 28 73 71 6c 69 74 65 33 eateFunc(sqlite3
226b0 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a *, const char *
226c0 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 76 6f 69 64 , int, int, void
226d0 20 2a 2c 20 0a 20 20 76 6f 69 64 20 28 2a 29 28 *, . void (*)(
226e0 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
226f0 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
22700 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 ue **),. void (
22710 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 *)(sqlite3_conte
22720 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
22730 76 61 6c 75 65 20 2a 2a 29 2c 20 76 6f 69 64 20 value **), void
22740 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 (*)(sqlite3_cont
22750 65 78 74 2a 29 2c 0a 20 20 46 75 6e 63 44 65 73 ext*),. FuncDes
22760 74 72 75 63 74 6f 72 20 2a 70 44 65 73 74 72 75 tructor *pDestru
22770 63 74 6f 72 0a 29 3b 0a 69 6e 74 20 73 71 6c 69 ctor.);.int sqli
22780 74 65 33 41 70 69 45 78 69 74 28 73 71 6c 69 74 te3ApiExit(sqlit
22790 65 33 20 2a 64 62 2c 20 69 6e 74 29 3b 0a 69 6e e3 *db, int);.in
227a0 74 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 65 6d t sqlite3OpenTem
227b0 70 44 61 74 61 62 61 73 65 28 50 61 72 73 65 20 pDatabase(Parse
227c0 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);..void sqlite
227d0 33 53 74 72 41 63 63 75 6d 49 6e 69 74 28 53 74 3StrAccumInit(St
227e0 72 41 63 63 75 6d 2a 2c 20 63 68 61 72 2a 2c 20 rAccum*, char*,
227f0 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
22800 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 6d 41 sqlite3StrAccumA
22810 70 70 65 6e 64 28 53 74 72 41 63 63 75 6d 2a 2c ppend(StrAccum*,
22820 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 const char*,int)
22830 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 ;.void sqlite3St
22840 72 41 63 63 75 6d 41 70 70 65 6e 64 41 6c 6c 28 rAccumAppendAll(
22850 53 74 72 41 63 63 75 6d 2a 2c 63 6f 6e 73 74 20 StrAccum*,const
22860 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c char*);.void sql
22870 69 74 65 33 41 70 70 65 6e 64 53 70 61 63 65 28 ite3AppendSpace(
22880 53 74 72 41 63 63 75 6d 2a 2c 69 6e 74 29 3b 0a StrAccum*,int);.
22890 63 68 61 72 20 2a 73 71 6c 69 74 65 33 53 74 72 char *sqlite3Str
228a0 41 63 63 75 6d 46 69 6e 69 73 68 28 53 74 72 41 AccumFinish(StrA
228b0 63 63 75 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c ccum*);.void sql
228c0 69 74 65 33 53 74 72 41 63 63 75 6d 52 65 73 65 ite3StrAccumRese
228d0 74 28 53 74 72 41 63 63 75 6d 2a 29 3b 0a 76 6f t(StrAccum*);.vo
228e0 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 id sqlite3Select
228f0 44 65 73 74 49 6e 69 74 28 53 65 6c 65 63 74 44 DestInit(SelectD
22900 65 73 74 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 45 est*,int,int);.E
22910 78 70 72 20 2a 73 71 6c 69 74 65 33 43 72 65 61 xpr *sqlite3Crea
22920 74 65 43 6f 6c 75 6d 6e 45 78 70 72 28 73 71 6c teColumnExpr(sql
22930 69 74 65 33 20 2a 2c 20 53 72 63 4c 69 73 74 20 ite3 *, SrcList
22940 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 0a 76 *, int, int);..v
22950 6f 69 64 20 73 71 6c 69 74 65 33 42 61 63 6b 75 oid sqlite3Backu
22960 70 52 65 73 74 61 72 74 28 73 71 6c 69 74 65 33 pRestart(sqlite3
22970 5f 62 61 63 6b 75 70 20 2a 29 3b 0a 76 6f 69 64 _backup *);.void
22980 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 sqlite3BackupUp
22990 64 61 74 65 28 73 71 6c 69 74 65 33 5f 62 61 63 date(sqlite3_bac
229a0 6b 75 70 20 2a 2c 20 50 67 6e 6f 2c 20 63 6f 6e kup *, Pgno, con
229b0 73 74 20 75 38 20 2a 29 3b 0a 0a 23 69 66 64 65 st u8 *);..#ifde
229c0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
229d0 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 76 STAT3_OR_STAT4.v
229e0 6f 69 64 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 oid sqlite3Analy
229f0 7a 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 zeFunctions(void
22a00 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 );.int sqlite3St
22a10 61 74 34 50 72 6f 62 65 53 65 74 56 61 6c 75 65 at4ProbeSetValue
22a20 28 50 61 72 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 (Parse*,Index*,U
22a30 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 2a 2c npackedRecord**,
22a40 45 78 70 72 2a 2c 75 38 2c 69 6e 74 2c 69 6e 74 Expr*,u8,int,int
22a50 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
22a60 53 74 61 74 34 50 72 6f 62 65 46 72 65 65 28 55 Stat4ProbeFree(U
22a70 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 29 3b npackedRecord*);
22a80 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
22a90 68 65 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 he interface to
22aa0 74 68 65 20 4c 45 4d 4f 4e 2d 67 65 6e 65 72 61 the LEMON-genera
22ab0 74 65 64 20 70 61 72 73 65 72 0a 2a 2f 0a 76 6f ted parser.*/.vo
22ac0 69 64 20 2a 73 71 6c 69 74 65 33 50 61 72 73 65 id *sqlite3Parse
22ad0 72 41 6c 6c 6f 63 28 76 6f 69 64 2a 28 2a 29 28 rAlloc(void*(*)(
22ae0 73 69 7a 65 5f 74 29 29 3b 0a 76 6f 69 64 20 73 size_t));.void s
22af0 71 6c 69 74 65 33 50 61 72 73 65 72 46 72 65 65 qlite3ParserFree
22b00 28 76 6f 69 64 2a 2c 20 76 6f 69 64 28 2a 29 28 (void*, void(*)(
22b10 76 6f 69 64 2a 29 29 3b 0a 76 6f 69 64 20 73 71 void*));.void sq
22b20 6c 69 74 65 33 50 61 72 73 65 72 28 76 6f 69 64 lite3Parser(void
22b30 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2c 20 50 *, int, Token, P
22b40 61 72 73 65 2a 29 3b 0a 23 69 66 64 65 66 20 59 arse*);.#ifdef Y
22b50 59 54 52 41 43 4b 4d 41 58 53 54 41 43 4b 44 45 YTRACKMAXSTACKDE
22b60 50 54 48 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 PTH. int sqlite
22b70 33 50 61 72 73 65 72 53 74 61 63 6b 50 65 61 6b 3ParserStackPeak
22b80 28 76 6f 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a (void*);.#endif.
22b90 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 .void sqlite3Aut
22ba0 6f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 oLoadExtensions(
22bb0 73 71 6c 69 74 65 33 2a 29 3b 0a 23 69 66 6e 64 sqlite3*);.#ifnd
22bc0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c ef SQLITE_OMIT_L
22bd0 4f 41 44 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 OAD_EXTENSION.
22be0 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 void sqlite3Clos
22bf0 65 45 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 eExtensions(sqli
22c00 74 65 33 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 te3*);.#else.# d
22c10 65 66 69 6e 65 20 73 71 6c 69 74 65 33 43 6c 6f efine sqlite3Clo
22c20 73 65 45 78 74 65 6e 73 69 6f 6e 73 28 58 29 0a seExtensions(X).
22c30 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 #endif..#ifndef
22c40 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
22c50 45 44 5f 43 41 43 48 45 0a 20 20 76 6f 69 64 20 ED_CACHE. void
22c60 73 71 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b sqlite3TableLock
22c70 28 50 61 72 73 65 20 2a 2c 20 69 6e 74 2c 20 69 (Parse *, int, i
22c80 6e 74 2c 20 75 38 2c 20 63 6f 6e 73 74 20 63 68 nt, u8, const ch
22c90 61 72 20 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 ar *);.#else. #
22ca0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 61 define sqlite3Ta
22cb0 62 6c 65 4c 6f 63 6b 28 76 2c 77 2c 78 2c 79 2c bleLock(v,w,x,y,
22cc0 7a 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 z).#endif..#ifde
22cd0 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 f SQLITE_TEST.
22ce0 69 6e 74 20 73 71 6c 69 74 65 33 55 74 66 38 54 int sqlite3Utf8T
22cf0 6f 38 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 o8(unsigned char
22d00 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 *);.#endif..#ifd
22d10 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ef SQLITE_OMIT_V
22d20 49 52 54 55 41 4c 54 41 42 4c 45 0a 23 20 20 64 IRTUALTABLE.# d
22d30 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 efine sqlite3Vta
22d40 62 43 6c 65 61 72 28 59 29 0a 23 20 20 64 65 66 bClear(Y).# def
22d50 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 53 ine sqlite3VtabS
22d60 79 6e 63 28 58 2c 59 29 20 53 51 4c 49 54 45 5f ync(X,Y) SQLITE_
22d70 4f 4b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c OK.# define sql
22d80 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b ite3VtabRollback
22d90 28 58 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 (X).# define sq
22da0 6c 69 74 65 33 56 74 61 62 43 6f 6d 6d 69 74 28 lite3VtabCommit(
22db0 58 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c X).# define sql
22dc0 69 74 65 33 56 74 61 62 49 6e 53 79 6e 63 28 64 ite3VtabInSync(d
22dd0 62 29 20 30 0a 23 20 20 64 65 66 69 6e 65 20 73 b) 0.# define s
22de0 71 6c 69 74 65 33 56 74 61 62 4c 6f 63 6b 28 58 qlite3VtabLock(X
22df0 29 20 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c ) .# define sql
22e00 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 28 58 ite3VtabUnlock(X
22e10 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 ).# define sqli
22e20 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 te3VtabUnlockLis
22e30 74 28 58 29 0a 23 20 20 64 65 66 69 6e 65 20 73 t(X).# define s
22e40 71 6c 69 74 65 33 56 74 61 62 53 61 76 65 70 6f qlite3VtabSavepo
22e50 69 6e 74 28 58 2c 20 59 2c 20 5a 29 20 53 51 4c int(X, Y, Z) SQL
22e60 49 54 45 5f 4f 4b 0a 23 20 20 64 65 66 69 6e 65 ITE_OK.# define
22e70 20 73 71 6c 69 74 65 33 47 65 74 56 54 61 62 6c sqlite3GetVTabl
22e80 65 28 58 2c 59 29 20 20 28 28 56 54 61 62 6c 65 e(X,Y) ((VTable
22e90 2a 29 30 29 0a 23 65 6c 73 65 0a 20 20 20 76 6f *)0).#else. vo
22ea0 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 43 6c id sqlite3VtabCl
22eb0 65 61 72 28 73 71 6c 69 74 65 33 20 2a 64 62 2c ear(sqlite3 *db,
22ec0 20 54 61 62 6c 65 2a 29 3b 0a 20 20 20 76 6f 69 Table*);. voi
22ed0 64 20 73 71 6c 69 74 65 33 56 74 61 62 44 69 73 d sqlite3VtabDis
22ee0 63 6f 6e 6e 65 63 74 28 73 71 6c 69 74 65 33 20 connect(sqlite3
22ef0 2a 64 62 2c 20 54 61 62 6c 65 20 2a 70 29 3b 0a *db, Table *p);.
22f00 20 20 20 69 6e 74 20 73 71 6c 69 74 65 33 56 74 int sqlite3Vt
22f10 61 62 53 79 6e 63 28 73 71 6c 69 74 65 33 20 2a abSync(sqlite3 *
22f20 64 62 2c 20 56 64 62 65 2a 29 3b 0a 20 20 20 69 db, Vdbe*);. i
22f30 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 52 6f nt sqlite3VtabRo
22f40 6c 6c 62 61 63 6b 28 73 71 6c 69 74 65 33 20 2a llback(sqlite3 *
22f50 64 62 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 db);. int sqli
22f60 74 65 33 56 74 61 62 43 6f 6d 6d 69 74 28 73 71 te3VtabCommit(sq
22f70 6c 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 20 76 lite3 *db);. v
22f80 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 4c oid sqlite3VtabL
22f90 6f 63 6b 28 56 54 61 62 6c 65 20 2a 29 3b 0a 20 ock(VTable *);.
22fa0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 void sqlite3Vt
22fb0 61 62 55 6e 6c 6f 63 6b 28 56 54 61 62 6c 65 20 abUnlock(VTable
22fc0 2a 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 *);. void sqli
22fd0 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 te3VtabUnlockLis
22fe0 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 t(sqlite3*);.
22ff0 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 53 int sqlite3VtabS
23000 61 76 65 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 avepoint(sqlite3
23010 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 *, int, int);.
23020 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 void sqlite3Vt
23030 61 62 49 6d 70 6f 72 74 45 72 72 6d 73 67 28 56 abImportErrmsg(V
23040 64 62 65 2a 2c 20 73 71 6c 69 74 65 33 5f 76 74 dbe*, sqlite3_vt
23050 61 62 2a 29 3b 0a 20 20 20 56 54 61 62 6c 65 20 ab*);. VTable
23060 2a 73 71 6c 69 74 65 33 47 65 74 56 54 61 62 6c *sqlite3GetVTabl
23070 65 28 73 71 6c 69 74 65 33 2a 2c 20 54 61 62 6c e(sqlite3*, Tabl
23080 65 2a 29 3b 0a 23 20 20 64 65 66 69 6e 65 20 73 e*);.# define s
23090 71 6c 69 74 65 33 56 74 61 62 49 6e 53 79 6e 63 qlite3VtabInSync
230a0 28 64 62 29 20 28 28 64 62 29 2d 3e 6e 56 54 72 (db) ((db)->nVTr
230b0 61 6e 73 3e 30 20 26 26 20 28 64 62 29 2d 3e 61 ans>0 && (db)->a
230c0 56 54 72 61 6e 73 3d 3d 30 29 0a 23 65 6e 64 69 VTrans==0).#endi
230d0 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 f.void sqlite3Vt
230e0 61 62 4d 61 6b 65 57 72 69 74 61 62 6c 65 28 50 abMakeWritable(P
230f0 61 72 73 65 2a 2c 54 61 62 6c 65 2a 29 3b 0a 76 arse*,Table*);.v
23100 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 42 oid sqlite3VtabB
23110 65 67 69 6e 50 61 72 73 65 28 50 61 72 73 65 2a eginParse(Parse*
23120 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a , Token*, Token*
23130 2c 20 54 6f 6b 65 6e 2a 2c 20 69 6e 74 29 3b 0a , Token*, int);.
23140 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 void sqlite3Vtab
23150 46 69 6e 69 73 68 50 61 72 73 65 28 50 61 72 73 FinishParse(Pars
23160 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 e*, Token*);.voi
23170 64 20 73 71 6c 69 74 65 33 56 74 61 62 41 72 67 d sqlite3VtabArg
23180 49 6e 69 74 28 50 61 72 73 65 2a 29 3b 0a 76 6f Init(Parse*);.vo
23190 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 41 72 id sqlite3VtabAr
231a0 67 45 78 74 65 6e 64 28 50 61 72 73 65 2a 2c 20 gExtend(Parse*,
231b0 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c Token*);.int sql
231c0 69 74 65 33 56 74 61 62 43 61 6c 6c 43 72 65 61 ite3VtabCallCrea
231d0 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 te(sqlite3*, int
231e0 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 , const char *,
231f0 63 68 61 72 20 2a 2a 29 3b 0a 69 6e 74 20 73 71 char **);.int sq
23200 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 43 6f 6e lite3VtabCallCon
23210 6e 65 63 74 28 50 61 72 73 65 2a 2c 20 54 61 62 nect(Parse*, Tab
23220 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 le*);.int sqlite
23230 33 56 74 61 62 43 61 6c 6c 44 65 73 74 72 6f 79 3VtabCallDestroy
23240 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 (sqlite3*, int,
23250 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 69 const char *);.i
23260 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 42 65 nt sqlite3VtabBe
23270 67 69 6e 28 73 71 6c 69 74 65 33 20 2a 2c 20 56 gin(sqlite3 *, V
23280 54 61 62 6c 65 20 2a 29 3b 0a 46 75 6e 63 44 65 Table *);.FuncDe
23290 66 20 2a 73 71 6c 69 74 65 33 56 74 61 62 4f 76 f *sqlite3VtabOv
232a0 65 72 6c 6f 61 64 46 75 6e 63 74 69 6f 6e 28 73 erloadFunction(s
232b0 71 6c 69 74 65 33 20 2a 2c 46 75 6e 63 44 65 66 qlite3 *,FuncDef
232c0 2a 2c 20 69 6e 74 20 6e 41 72 67 2c 20 45 78 70 *, int nArg, Exp
232d0 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
232e0 33 49 6e 76 61 6c 69 64 46 75 6e 63 74 69 6f 6e 3InvalidFunction
232f0 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
23300 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
23310 6c 75 65 2a 2a 29 3b 0a 73 71 6c 69 74 65 33 5f lue**);.sqlite3_
23320 69 6e 74 36 34 20 73 71 6c 69 74 65 33 53 74 6d int64 sqlite3Stm
23330 74 43 75 72 72 65 6e 74 54 69 6d 65 28 73 71 6c tCurrentTime(sql
23340 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 3b 0a ite3_context*);.
23350 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 50 int sqlite3VdbeP
23360 61 72 61 6d 65 74 65 72 49 6e 64 65 78 28 56 64 arameterIndex(Vd
23370 62 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a be*, const char*
23380 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 , int);.int sqli
23390 74 65 33 54 72 61 6e 73 66 65 72 42 69 6e 64 69 te3TransferBindi
233a0 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 ngs(sqlite3_stmt
233b0 20 2a 2c 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 *, sqlite3_stmt
233c0 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);.void sqlite
233d0 33 50 61 72 73 65 72 52 65 73 65 74 28 50 61 72 3ParserReset(Par
233e0 73 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 se*);.int sqlite
233f0 33 52 65 70 72 65 70 61 72 65 28 56 64 62 65 2a 3Reprepare(Vdbe*
23400 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
23410 78 70 72 4c 69 73 74 43 68 65 63 6b 4c 65 6e 67 xprListCheckLeng
23420 74 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 4c th(Parse*, ExprL
23430 69 73 74 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 ist*, const char
23440 2a 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c *);.CollSeq *sql
23450 69 74 65 33 42 69 6e 61 72 79 43 6f 6d 70 61 72 ite3BinaryCompar
23460 65 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a eCollSeq(Parse *
23470 2c 20 45 78 70 72 20 2a 2c 20 45 78 70 72 20 2a , Expr *, Expr *
23480 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 65 );.int sqlite3Te
23490 6d 70 49 6e 4d 65 6d 6f 72 79 28 63 6f 6e 73 74 mpInMemory(const
234a0 20 73 71 6c 69 74 65 33 2a 29 3b 0a 63 6f 6e 73 sqlite3*);.cons
234b0 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4a t char *sqlite3J
234c0 6f 75 72 6e 61 6c 4d 6f 64 65 6e 61 6d 65 28 69 ournalModename(i
234d0 6e 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c nt);.#ifndef SQL
234e0 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 69 ITE_OMIT_WAL. i
234f0 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 6b 70 nt sqlite3Checkp
23500 6f 69 6e 74 28 73 71 6c 69 74 65 33 2a 2c 20 69 oint(sqlite3*, i
23510 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 nt, int, int*, i
23520 6e 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 nt*);. int sqli
23530 74 65 33 57 61 6c 44 65 66 61 75 6c 74 48 6f 6f te3WalDefaultHoo
23540 6b 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a k(void*,sqlite3*
23550 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 ,const char*,int
23560 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 );.#endif.#ifnde
23570 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 54 f SQLITE_OMIT_CT
23580 45 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 E. void sqlite3
23590 43 74 65 41 64 64 28 50 61 72 73 65 2a 2c 54 6f CteAdd(Parse*,To
235a0 6b 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 53 ken*,ExprList*,S
235b0 65 6c 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 20 elect*);. void
235c0 73 71 6c 69 74 65 33 43 74 65 46 69 6e 69 73 68 sqlite3CteFinish
235d0 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 23 65 (Parse*,int);.#e
235e0 6e 64 69 66 0a 0a 2f 2a 20 44 65 63 6c 61 72 61 ndif../* Declara
235f0 74 69 6f 6e 73 20 66 6f 72 20 66 75 6e 63 74 69 tions for functi
23600 6f 6e 73 20 69 6e 20 66 6b 65 79 2e 63 2e 20 41 ons in fkey.c. A
23610 6c 6c 20 6f 66 20 74 68 65 73 65 20 61 72 65 20 ll of these are
23620 72 65 70 6c 61 63 65 64 20 62 79 0a 2a 2a 20 6e replaced by.** n
23630 6f 2d 6f 70 20 6d 61 63 72 6f 73 20 69 66 20 4f o-op macros if O
23640 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 20 MIT_FOREIGN_KEY
23650 69 73 20 64 65 66 69 6e 65 64 2e 20 49 6e 20 74 is defined. In t
23660 68 69 73 20 63 61 73 65 20 6e 6f 20 66 6f 72 65 his case no fore
23670 69 67 6e 0a 2a 2a 20 6b 65 79 20 66 75 6e 63 74 ign.** key funct
23680 69 6f 6e 61 6c 69 74 79 20 69 73 20 61 76 61 69 ionality is avai
23690 6c 61 62 6c 65 2e 20 49 66 20 4f 4d 49 54 5f 54 lable. If OMIT_T
236a0 52 49 47 47 45 52 20 69 73 20 64 65 66 69 6e 65 RIGGER is define
236b0 64 20 62 75 74 0a 2a 2a 20 4f 4d 49 54 5f 46 4f d but.** OMIT_FO
236c0 52 45 49 47 4e 5f 4b 45 59 20 69 73 20 6e 6f 74 REIGN_KEY is not
236d0 2c 20 6f 6e 6c 79 20 73 6f 6d 65 20 6f 66 20 74 , only some of t
236e0 68 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 he functions are
236f0 20 6e 6f 2d 6f 70 65 64 2e 20 49 6e 0a 2a 2a 20 no-oped. In.**
23700 74 68 69 73 20 63 61 73 65 20 66 6f 72 65 69 67 this case foreig
23710 6e 20 6b 65 79 73 20 61 72 65 20 70 61 72 73 65 n keys are parse
23720 64 2c 20 62 75 74 20 6e 6f 20 6f 74 68 65 72 20 d, but no other
23730 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 functionality is
23740 20 0a 2a 2a 20 70 72 6f 76 69 64 65 64 20 28 65 .** provided (e
23750 6e 66 6f 72 63 65 6d 65 6e 74 20 6f 66 20 46 4b nforcement of FK
23760 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 72 65 71 constraints req
23770 75 69 72 65 73 20 74 68 65 20 74 72 69 67 67 65 uires the trigge
23780 72 73 20 73 75 62 2d 73 79 73 74 65 6d 29 2e 0a rs sub-system)..
23790 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 */.#if !defined(
237a0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 SQLITE_OMIT_FORE
237b0 49 47 4e 5f 4b 45 59 29 20 26 26 20 21 64 65 66 IGN_KEY) && !def
237c0 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 ined(SQLITE_OMIT
237d0 5f 54 52 49 47 47 45 52 29 0a 20 20 76 6f 69 64 _TRIGGER). void
237e0 20 73 71 6c 69 74 65 33 46 6b 43 68 65 63 6b 28 sqlite3FkCheck(
237f0 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 Parse*, Table*,
23800 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 int, int, int*,
23810 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c int);. void sql
23820 69 74 65 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 ite3FkDropTable(
23830 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 20 Parse*, SrcList
23840 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 76 6f *, Table*);. vo
23850 69 64 20 73 71 6c 69 74 65 33 46 6b 41 63 74 69 id sqlite3FkActi
23860 6f 6e 73 28 50 61 72 73 65 2a 2c 20 54 61 62 6c ons(Parse*, Tabl
23870 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 e*, ExprList*, i
23880 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a nt, int*, int);.
23890 20 20 69 6e 74 20 73 71 6c 69 74 65 33 46 6b 52 int sqlite3FkR
238a0 65 71 75 69 72 65 64 28 50 61 72 73 65 2a 2c 20 equired(Parse*,
238b0 54 61 62 6c 65 2a 2c 20 69 6e 74 2a 2c 20 69 6e Table*, int*, in
238c0 74 29 3b 0a 20 20 75 33 32 20 73 71 6c 69 74 65 t);. u32 sqlite
238d0 33 46 6b 4f 6c 64 6d 61 73 6b 28 50 61 72 73 65 3FkOldmask(Parse
238e0 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 46 4b *, Table*);. FK
238f0 65 79 20 2a 73 71 6c 69 74 65 33 46 6b 52 65 66 ey *sqlite3FkRef
23900 65 72 65 6e 63 65 73 28 54 61 62 6c 65 20 2a 29 erences(Table *)
23910 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e ;.#else. #defin
23920 65 20 73 71 6c 69 74 65 33 46 6b 41 63 74 69 6f e sqlite3FkActio
23930 6e 73 28 61 2c 62 2c 63 2c 64 2c 65 2c 66 29 0a ns(a,b,c,d,e,f).
23940 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 #define sqlite
23950 33 46 6b 43 68 65 63 6b 28 61 2c 62 2c 63 2c 64 3FkCheck(a,b,c,d
23960 2c 65 2c 66 29 0a 20 20 23 64 65 66 69 6e 65 20 ,e,f). #define
23970 73 71 6c 69 74 65 33 46 6b 44 72 6f 70 54 61 62 sqlite3FkDropTab
23980 6c 65 28 61 2c 62 2c 63 29 0a 20 20 23 64 65 66 le(a,b,c). #def
23990 69 6e 65 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 ine sqlite3FkOld
239a0 6d 61 73 6b 28 61 2c 62 29 20 20 20 20 20 20 20 mask(a,b)
239b0 20 20 30 0a 20 20 23 64 65 66 69 6e 65 20 73 71 0. #define sq
239c0 6c 69 74 65 33 46 6b 52 65 71 75 69 72 65 64 28 lite3FkRequired(
239d0 61 2c 62 2c 63 2c 64 29 20 20 20 20 30 0a 23 65 a,b,c,d) 0.#e
239e0 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c ndif.#ifndef SQL
239f0 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e ITE_OMIT_FOREIGN
23a00 5f 4b 45 59 0a 20 20 76 6f 69 64 20 73 71 6c 69 _KEY. void sqli
23a10 74 65 33 46 6b 44 65 6c 65 74 65 28 73 71 6c 69 te3FkDelete(sqli
23a20 74 65 33 20 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a te3 *, Table*);.
23a30 20 20 69 6e 74 20 73 71 6c 69 74 65 33 46 6b 4c int sqlite3FkL
23a40 6f 63 61 74 65 49 6e 64 65 78 28 50 61 72 73 65 ocateIndex(Parse
23a50 2a 2c 54 61 62 6c 65 2a 2c 46 4b 65 79 2a 2c 49 *,Table*,FKey*,I
23a60 6e 64 65 78 2a 2a 2c 69 6e 74 2a 2a 29 3b 0a 23 ndex**,int**);.#
23a70 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 else. #define s
23a80 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 28 61 qlite3FkDelete(a
23a90 2c 62 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 ,b). #define sq
23aa0 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 lite3FkLocateInd
23ab0 65 78 28 61 2c 62 2c 63 2c 64 2c 65 29 0a 23 65 ex(a,b,c,d,e).#e
23ac0 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 41 76 61 ndif.../*.** Ava
23ad0 69 6c 61 62 6c 65 20 66 61 75 6c 74 20 69 6e 6a ilable fault inj
23ae0 65 63 74 6f 72 73 2e 20 20 53 68 6f 75 6c 64 20 ectors. Should
23af0 62 65 20 6e 75 6d 62 65 72 65 64 20 62 65 67 69 be numbered begi
23b00 6e 6e 69 6e 67 20 77 69 74 68 20 30 2e 0a 2a 2f nning with 0..*/
23b10 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
23b20 46 41 55 4c 54 49 4e 4a 45 43 54 4f 52 5f 4d 41 FAULTINJECTOR_MA
23b30 4c 4c 4f 43 20 20 20 20 20 30 0a 23 64 65 66 69 LLOC 0.#defi
23b40 6e 65 20 53 51 4c 49 54 45 5f 46 41 55 4c 54 49 ne SQLITE_FAULTI
23b50 4e 4a 45 43 54 4f 52 5f 43 4f 55 4e 54 20 20 20 NJECTOR_COUNT
23b60 20 20 20 31 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 1../*.** The
23b70 69 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 interface to the
23b80 20 63 6f 64 65 20 69 6e 20 66 61 75 6c 74 2e 63 code in fault.c
23b90 20 75 73 65 64 20 66 6f 72 20 69 64 65 6e 74 69 used for identi
23ba0 66 79 69 6e 67 20 22 62 65 6e 69 67 6e 22 0a 2a fying "benign".*
23bb0 2a 20 6d 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 * malloc failure
23bc0 73 2e 20 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 s. This is only
23bd0 70 72 65 73 65 6e 74 20 69 66 20 53 51 4c 49 54 present if SQLIT
23be0 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 E_OMIT_BUILTIN_T
23bf0 45 53 54 0a 2a 2a 20 69 73 20 6e 6f 74 20 64 65 EST.** is not de
23c00 66 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 fined..*/.#ifnde
23c10 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 f SQLITE_OMIT_BU
23c20 49 4c 54 49 4e 5f 54 45 53 54 0a 20 20 76 6f 69 ILTIN_TEST. voi
23c30 64 20 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 d sqlite3BeginBe
23c40 6e 69 67 6e 4d 61 6c 6c 6f 63 28 76 6f 69 64 29 nignMalloc(void)
23c50 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
23c60 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 EndBenignMalloc(
23c70 76 6f 69 64 29 3b 0a 23 65 6c 73 65 0a 20 20 23 void);.#else. #
23c80 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 42 65 define sqlite3Be
23c90 67 69 6e 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 ginBenignMalloc(
23ca0 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 ). #define sqli
23cb0 74 65 33 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c te3EndBenignMall
23cc0 6f 63 28 29 0a 23 65 6e 64 69 66 0a 0a 23 64 65 oc().#endif..#de
23cd0 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 52 4f fine IN_INDEX_RO
23ce0 57 49 44 20 20 20 20 20 20 20 20 20 20 20 31 0a WID 1.
23cf0 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 #define IN_INDEX
23d00 5f 45 50 48 20 20 20 20 20 20 20 20 20 20 20 20 _EPH
23d10 20 32 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 2.#define IN_IN
23d20 44 45 58 5f 49 4e 44 45 58 5f 41 53 43 20 20 20 DEX_INDEX_ASC
23d30 20 20 20 20 33 0a 23 64 65 66 69 6e 65 20 49 4e 3.#define IN
23d40 5f 49 4e 44 45 58 5f 49 4e 44 45 58 5f 44 45 53 _INDEX_INDEX_DES
23d50 43 20 20 20 20 20 20 34 0a 69 6e 74 20 73 71 6c C 4.int sql
23d60 69 74 65 33 46 69 6e 64 49 6e 49 6e 64 65 78 28 ite3FindInIndex(
23d70 50 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c Parse *, Expr *,
23d80 20 69 6e 74 2a 29 3b 0a 0a 23 69 66 64 65 66 20 int*);..#ifdef
23d90 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 54 SQLITE_ENABLE_AT
23da0 4f 4d 49 43 5f 57 52 49 54 45 0a 20 20 69 6e 74 OMIC_WRITE. int
23db0 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 4f sqlite3JournalO
23dc0 70 65 6e 28 73 71 6c 69 74 65 33 5f 76 66 73 20 pen(sqlite3_vfs
23dd0 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c *, const char *,
23de0 20 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 2c sqlite3_file *,
23df0 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 69 6e int, int);. in
23e00 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c t sqlite3Journal
23e10 53 69 7a 65 28 73 71 6c 69 74 65 33 5f 76 66 73 Size(sqlite3_vfs
23e20 20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 *);. int sqlit
23e30 65 33 4a 6f 75 72 6e 61 6c 43 72 65 61 74 65 28 e3JournalCreate(
23e40 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 3b sqlite3_file *);
23e50 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f . int sqlite3Jo
23e60 75 72 6e 61 6c 45 78 69 73 74 73 28 73 71 6c 69 urnalExists(sqli
23e70 74 65 33 5f 66 69 6c 65 20 2a 70 29 3b 0a 23 65 te3_file *p);.#e
23e80 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 lse. #define sq
23e90 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 lite3JournalSize
23ea0 28 70 56 66 73 29 20 28 28 70 56 66 73 29 2d 3e (pVfs) ((pVfs)->
23eb0 73 7a 4f 73 46 69 6c 65 29 0a 20 20 23 64 65 66 szOsFile). #def
23ec0 69 6e 65 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e ine sqlite3Journ
23ed0 61 6c 45 78 69 73 74 73 28 70 29 20 31 0a 23 65 alExists(p) 1.#e
23ee0 6e 64 69 66 0a 0a 76 6f 69 64 20 73 71 6c 69 74 ndif..void sqlit
23ef0 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c 4f 70 65 6e e3MemJournalOpen
23f00 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 20 2a 29 (sqlite3_file *)
23f10 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d ;.int sqlite3Mem
23f20 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 76 6f 69 64 JournalSize(void
23f30 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 73 );.int sqlite3Is
23f40 4d 65 6d 4a 6f 75 72 6e 61 6c 28 73 71 6c 69 74 MemJournal(sqlit
23f50 65 33 5f 66 69 6c 65 20 2a 29 3b 0a 0a 23 69 66 e3_file *);..#if
23f60 20 53 51 4c 49 54 45 5f 4d 41 58 5f 45 58 50 52 SQLITE_MAX_EXPR
23f70 5f 44 45 50 54 48 3e 30 0a 20 20 76 6f 69 64 20 _DEPTH>0. void
23f80 73 71 6c 69 74 65 33 45 78 70 72 53 65 74 48 65 sqlite3ExprSetHe
23f90 69 67 68 74 28 50 61 72 73 65 20 2a 70 50 61 72 ight(Parse *pPar
23fa0 73 65 2c 20 45 78 70 72 20 2a 70 29 3b 0a 20 20 se, Expr *p);.
23fb0 69 6e 74 20 73 71 6c 69 74 65 33 53 65 6c 65 63 int sqlite3Selec
23fc0 74 45 78 70 72 48 65 69 67 68 74 28 53 65 6c 65 tExprHeight(Sele
23fd0 63 74 20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c ct *);. int sql
23fe0 69 74 65 33 45 78 70 72 43 68 65 63 6b 48 65 69 ite3ExprCheckHei
23ff0 67 68 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 ght(Parse*, int)
24000 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e ;.#else. #defin
24010 65 20 73 71 6c 69 74 65 33 45 78 70 72 53 65 74 e sqlite3ExprSet
24020 48 65 69 67 68 74 28 78 2c 79 29 0a 20 20 23 64 Height(x,y). #d
24030 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 65 6c efine sqlite3Sel
24040 65 63 74 45 78 70 72 48 65 69 67 68 74 28 78 29 ectExprHeight(x)
24050 20 30 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 0. #define sql
24060 69 74 65 33 45 78 70 72 43 68 65 63 6b 48 65 69 ite3ExprCheckHei
24070 67 68 74 28 78 2c 79 29 0a 23 65 6e 64 69 66 0a ght(x,y).#endif.
24080 0a 75 33 32 20 73 71 6c 69 74 65 33 47 65 74 34 .u32 sqlite3Get4
24090 62 79 74 65 28 63 6f 6e 73 74 20 75 38 2a 29 3b byte(const u8*);
240a0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 75 74 .void sqlite3Put
240b0 34 62 79 74 65 28 75 38 2a 2c 20 75 33 32 29 3b 4byte(u8*, u32);
240c0 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
240d0 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f ENABLE_UNLOCK_NO
240e0 54 49 46 59 0a 20 20 76 6f 69 64 20 73 71 6c 69 TIFY. void sqli
240f0 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f te3ConnectionBlo
24100 63 6b 65 64 28 73 71 6c 69 74 65 33 20 2a 2c 20 cked(sqlite3 *,
24110 73 71 6c 69 74 65 33 20 2a 29 3b 0a 20 20 76 6f sqlite3 *);. vo
24120 69 64 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 id sqlite3Connec
24130 74 69 6f 6e 55 6e 6c 6f 63 6b 65 64 28 73 71 6c tionUnlocked(sql
24140 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 76 6f 69 ite3 *db);. voi
24150 64 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 d sqlite3Connect
24160 69 6f 6e 43 6c 6f 73 65 64 28 73 71 6c 69 74 65 ionClosed(sqlite
24170 33 20 2a 64 62 29 3b 0a 23 65 6c 73 65 0a 20 20 3 *db);.#else.
24180 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 43 #define sqlite3C
24190 6f 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 onnectionBlocked
241a0 28 78 2c 79 29 0a 20 20 23 64 65 66 69 6e 65 20 (x,y). #define
241b0 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f sqlite3Connectio
241c0 6e 55 6e 6c 6f 63 6b 65 64 28 78 29 0a 20 20 23 nUnlocked(x). #
241d0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 43 6f define sqlite3Co
241e0 6e 6e 65 63 74 69 6f 6e 43 6c 6f 73 65 64 28 78 nnectionClosed(x
241f0 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 ).#endif..#ifdef
24200 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 SQLITE_DEBUG.
24210 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 72 73 void sqlite3Pars
24220 65 72 54 72 61 63 65 28 46 49 4c 45 2a 2c 20 63 erTrace(FILE*, c
24230 68 61 72 20 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a har *);.#endif..
24240 2f 2a 0a 2a 2a 20 49 66 20 74 68 65 20 53 51 4c /*.** If the SQL
24250 49 54 45 5f 45 4e 41 42 4c 45 20 49 4f 54 52 41 ITE_ENABLE IOTRA
24260 43 45 20 65 78 69 73 74 73 20 74 68 65 6e 20 74 CE exists then t
24270 68 65 20 67 6c 6f 62 61 6c 20 76 61 72 69 61 62 he global variab
24280 6c 65 0a 2a 2a 20 73 71 6c 69 74 65 33 49 6f 54 le.** sqlite3IoT
24290 72 61 63 65 20 69 73 20 61 20 70 6f 69 6e 74 65 race is a pointe
242a0 72 20 74 6f 20 61 20 70 72 69 6e 74 66 2d 6c 69 r to a printf-li
242b0 6b 65 20 72 6f 75 74 69 6e 65 20 75 73 65 64 20 ke routine used
242c0 74 6f 0a 2a 2a 20 70 72 69 6e 74 20 49 2f 4f 20 to.** print I/O
242d0 74 72 61 63 69 6e 67 20 6d 65 73 73 61 67 65 73 tracing messages
242e0 2e 20 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c . .*/.#ifdef SQL
242f0 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52 41 ITE_ENABLE_IOTRA
24300 43 45 0a 23 20 64 65 66 69 6e 65 20 49 4f 54 52 CE.# define IOTR
24310 41 43 45 28 41 29 20 20 69 66 28 20 73 71 6c 69 ACE(A) if( sqli
24320 74 65 33 49 6f 54 72 61 63 65 20 29 7b 20 73 71 te3IoTrace ){ sq
24330 6c 69 74 65 33 49 6f 54 72 61 63 65 20 41 3b 20 lite3IoTrace A;
24340 7d 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 }. void sqlite3
24350 56 64 62 65 49 4f 54 72 61 63 65 53 71 6c 28 56 VdbeIOTraceSql(V
24360 64 62 65 2a 29 3b 0a 53 51 4c 49 54 45 5f 45 58 dbe*);.SQLITE_EX
24370 54 45 52 4e 20 76 6f 69 64 20 28 2a 73 71 6c 69 TERN void (*sqli
24380 74 65 33 49 6f 54 72 61 63 65 29 28 63 6f 6e 73 te3IoTrace)(cons
24390 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a 23 65 t char*,...);.#e
243a0 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 49 4f 54 lse.# define IOT
243b0 52 41 43 45 28 41 29 0a 23 20 64 65 66 69 6e 65 RACE(A).# define
243c0 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 72 sqlite3VdbeIOTr
243d0 61 63 65 53 71 6c 28 58 29 0a 23 65 6e 64 69 66 aceSql(X).#endif
243e0 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 72 6f ../*.** These ro
243f0 75 74 69 6e 65 73 20 61 72 65 20 61 76 61 69 6c utines are avail
24400 61 62 6c 65 20 66 6f 72 20 74 68 65 20 6d 65 6d able for the mem
24410 32 2e 63 20 64 65 62 75 67 67 69 6e 67 20 6d 65 2.c debugging me
24420 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 0a 2a mory allocator.*
24430 2a 20 6f 6e 6c 79 2e 20 20 54 68 65 79 20 61 72 * only. They ar
24440 65 20 75 73 65 64 20 74 6f 20 76 65 72 69 66 79 e used to verify
24450 20 74 68 61 74 20 64 69 66 66 65 72 65 6e 74 20 that different
24460 22 74 79 70 65 73 22 20 6f 66 20 6d 65 6d 6f 72 "types" of memor
24470 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 y.** allocations
24480 20 61 72 65 20 70 72 6f 70 65 72 6c 79 20 74 72 are properly tr
24490 61 63 6b 65 64 20 62 79 20 74 68 65 20 73 79 73 acked by the sys
244a0 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 tem..**.** sqlit
244b0 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 e3MemdebugSetTyp
244c0 65 28 29 20 73 65 74 73 20 74 68 65 20 22 74 79 e() sets the "ty
244d0 70 65 22 20 6f 66 20 61 6e 20 61 6c 6c 6f 63 61 pe" of an alloca
244e0 74 69 6f 6e 20 74 6f 20 6f 6e 65 20 6f 66 0a 2a tion to one of.*
244f0 2a 20 74 68 65 20 4d 45 4d 54 59 50 45 5f 2a 20 * the MEMTYPE_*
24500 6d 61 63 72 6f 73 20 64 65 66 69 6e 65 64 20 62 macros defined b
24510 65 6c 6f 77 2e 20 20 54 68 65 20 74 79 70 65 20 elow. The type
24520 6d 75 73 74 20 62 65 20 61 20 62 69 74 6d 61 73 must be a bitmas
24530 6b 20 77 69 74 68 0a 2a 2a 20 61 20 73 69 6e 67 k with.** a sing
24540 6c 65 20 62 69 74 20 73 65 74 2e 0a 2a 2a 0a 2a le bit set..**.*
24550 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 * sqlite3Memdebu
24560 67 48 61 73 54 79 70 65 28 29 20 72 65 74 75 72 gHasType() retur
24570 6e 73 20 74 72 75 65 20 69 66 20 61 6e 79 20 6f ns true if any o
24580 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 69 74 f the bits in it
24590 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 67 75 s second.** argu
245a0 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 20 74 ment match the t
245b0 79 70 65 20 73 65 74 20 62 79 20 74 68 65 20 70 ype set by the p
245c0 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 33 4d revious sqlite3M
245d0 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 28 29 emdebugSetType()
245e0 2e 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 ..** sqlite3Memd
245f0 65 62 75 67 48 61 73 54 79 70 65 28 29 20 69 73 ebugHasType() is
24600 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 75 73 intended for us
24610 65 20 69 6e 73 69 64 65 20 61 73 73 65 72 74 28 e inside assert(
24620 29 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a ) statements..**
24630 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
24640 62 75 67 4e 6f 54 79 70 65 28 29 20 72 65 74 75 bugNoType() retu
24650 72 6e 73 20 74 72 75 65 20 69 66 20 6e 6f 6e 65 rns true if none
24660 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 of the bits in
24670 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 its second.** ar
24680 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 gument match the
24690 20 74 79 70 65 20 73 65 74 20 62 79 20 74 68 65 type set by the
246a0 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 previous sqlite
246b0 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 3MemdebugSetType
246c0 28 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 72 68 61 70 ()..**.** Perhap
246d0 73 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 6f 72 s the most impor
246e0 74 61 6e 74 20 70 6f 69 6e 74 20 69 73 20 74 68 tant point is th
246f0 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 65 74 e difference bet
24700 77 65 65 6e 20 4d 45 4d 54 59 50 45 5f 48 45 41 ween MEMTYPE_HEA
24710 50 0a 2a 2a 20 61 6e 64 20 4d 45 4d 54 59 50 45 P.** and MEMTYPE
24720 5f 4c 4f 4f 4b 41 53 49 44 45 2e 20 20 49 66 20 _LOOKASIDE. If
24730 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 73 an allocation is
24740 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 49 MEMTYPE_LOOKASI
24750 44 45 2c 20 74 68 61 74 20 6d 65 61 6e 73 0a 2a DE, that means.*
24760 2a 20 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 * it might have
24770 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 20 62 been allocated b
24780 79 20 6c 6f 6f 6b 61 73 69 64 65 2c 20 65 78 63 y lookaside, exc
24790 65 70 74 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 ept the allocati
247a0 6f 6e 20 77 61 73 0a 2a 2a 20 74 6f 6f 20 6c 61 on was.** too la
247b0 72 67 65 20 6f 72 20 6c 6f 6f 6b 61 73 69 64 65 rge or lookaside
247c0 20 77 61 73 20 61 6c 72 65 61 64 79 20 66 75 6c was already ful
247d0 6c 2e 20 20 49 74 20 69 73 20 69 6d 70 6f 72 74 l. It is import
247e0 61 6e 74 20 74 6f 20 76 65 72 69 66 79 0a 2a 2a ant to verify.**
247f0 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 69 6f 6e that allocation
24800 73 20 74 68 61 74 20 6d 69 67 68 74 20 68 61 76 s that might hav
24810 65 20 62 65 65 6e 20 73 61 74 69 73 66 69 65 64 e been satisfied
24820 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 20 61 72 by lookaside ar
24830 65 20 6e 6f 74 0a 2a 2a 20 70 61 73 73 65 64 20 e not.** passed
24840 62 61 63 6b 20 74 6f 20 6e 6f 6e 2d 6c 6f 6f 6b back to non-look
24850 61 73 69 64 65 20 66 72 65 65 28 29 20 72 6f 75 aside free() rou
24860 74 69 6e 65 73 2e 20 20 41 73 73 65 72 74 73 20 tines. Asserts
24870 73 75 63 68 20 61 73 20 74 68 65 0a 2a 2a 20 65 such as the.** e
24880 78 61 6d 70 6c 65 20 61 62 6f 76 65 20 61 72 65 xample above are
24890 20 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 20 6e placed on the n
248a0 6f 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 72 65 on-lookaside fre
248b0 65 28 29 20 72 6f 75 74 69 6e 65 73 20 74 6f 20 e() routines to
248c0 76 65 72 69 66 79 0a 2a 2a 20 74 68 69 73 20 63 verify.** this c
248d0 6f 6e 73 74 72 61 69 6e 74 2e 20 0a 2a 2a 0a 2a onstraint. .**.*
248e0 2a 20 41 6c 6c 20 6f 66 20 74 68 69 73 20 69 73 * All of this is
248f0 20 6e 6f 2d 6f 70 20 66 6f 72 20 61 20 70 72 6f no-op for a pro
24900 64 75 63 74 69 6f 6e 20 62 75 69 6c 64 2e 20 20 duction build.
24910 49 74 20 6f 6e 6c 79 20 63 6f 6d 65 73 20 69 6e It only comes in
24920 74 6f 0a 2a 2a 20 70 6c 61 79 20 77 68 65 6e 20 to.** play when
24930 74 68 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 the SQLITE_MEMDE
24940 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 BUG compile-time
24950 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 2e option is used.
24960 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 .*/.#ifdef SQLIT
24970 45 5f 4d 45 4d 44 45 42 55 47 0a 20 20 76 6f 69 E_MEMDEBUG. voi
24980 64 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 d sqlite3Memdebu
24990 67 53 65 74 54 79 70 65 28 76 6f 69 64 2a 2c 75 gSetType(void*,u
249a0 38 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 8);. int sqlite
249b0 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 65 3MemdebugHasType
249c0 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 69 6e (void*,u8);. in
249d0 74 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 t sqlite3Memdebu
249e0 67 4e 6f 54 79 70 65 28 76 6f 69 64 2a 2c 75 38 gNoType(void*,u8
249f0 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e );.#else.# defin
24a00 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 e sqlite3Memdebu
24a10 67 53 65 74 54 79 70 65 28 58 2c 59 29 20 20 2f gSetType(X,Y) /
24a20 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 64 65 66 * no-op */.# def
24a30 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 ine sqlite3Memde
24a40 62 75 67 48 61 73 54 79 70 65 28 58 2c 59 29 20 bugHasType(X,Y)
24a50 20 31 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 1.# define sqli
24a60 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 te3MemdebugNoTyp
24a70 65 28 58 2c 59 29 20 20 20 31 0a 23 65 6e 64 69 e(X,Y) 1.#endi
24a80 66 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 f.#define MEMTYP
24a90 45 5f 48 45 41 50 20 20 20 20 20 20 20 30 78 30 E_HEAP 0x0
24aa0 31 20 20 2f 2a 20 47 65 6e 65 72 61 6c 20 68 65 1 /* General he
24ab0 61 70 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 2a ap allocations *
24ac0 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 50 /.#define MEMTYP
24ad0 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 20 30 78 30 E_LOOKASIDE 0x0
24ae0 32 20 20 2f 2a 20 4d 69 67 68 74 20 68 61 76 65 2 /* Might have
24af0 20 62 65 65 6e 20 6c 6f 6f 6b 61 73 69 64 65 20 been lookaside
24b00 6d 65 6d 6f 72 79 20 2a 2f 0a 23 64 65 66 69 6e memory */.#defin
24b10 65 20 4d 45 4d 54 59 50 45 5f 53 43 52 41 54 43 e MEMTYPE_SCRATC
24b20 48 20 20 20 20 30 78 30 34 20 20 2f 2a 20 53 63 H 0x04 /* Sc
24b30 72 61 74 63 68 20 61 6c 6c 6f 63 61 74 69 6f 6e ratch allocation
24b40 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d s */.#define MEM
24b50 54 59 50 45 5f 50 43 41 43 48 45 20 20 20 20 20 TYPE_PCACHE
24b60 30 78 30 38 20 20 2f 2a 20 50 61 67 65 20 63 61 0x08 /* Page ca
24b70 63 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 che allocations
24b80 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 */.#define MEMTY
24b90 50 45 5f 44 42 20 20 20 20 20 20 20 20 20 30 78 PE_DB 0x
24ba0 31 30 20 20 2f 2a 20 55 73 65 73 20 73 71 6c 69 10 /* Uses sqli
24bb0 74 65 33 44 62 4d 61 6c 6c 6f 63 2c 20 6e 6f 74 te3DbMalloc, not
24bc0 20 73 71 6c 69 74 65 5f 6d 61 6c 6c 6f 63 20 2a sqlite_malloc *
24bd0 2f 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 5f 53 51 /..#endif /* _SQ
24be0 4c 49 54 45 49 4e 54 5f 48 5f 20 2a 2f 0a LITEINT_H_ */.