0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 49 6e 74 65 72 6e ******.** Intern
0180: 61 6c 20 69 6e 74 65 72 66 61 63 65 20 64 65 66 al interface def
0190: 69 6e 69 74 69 6f 6e 73 20 66 6f 72 20 53 51 4c initions for SQL
01a0: 69 74 65 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 6e 64 ite..**.*/.#ifnd
01b0: 65 66 20 5f 53 51 4c 49 54 45 49 4e 54 5f 48 5f ef _SQLITEINT_H_
01c0: 0a 23 64 65 66 69 6e 65 20 5f 53 51 4c 49 54 45 .#define _SQLITE
01d0: 49 4e 54 5f 48 5f 0a 0a 2f 2a 0a 2a 2a 20 4d 61 INT_H_../*.** Ma
01e0: 6b 65 20 73 75 72 65 20 74 68 61 74 20 72 61 6e ke sure that ran
01f0: 64 5f 73 28 29 20 69 73 20 61 76 61 69 6c 61 62 d_s() is availab
0200: 6c 65 20 6f 6e 20 57 69 6e 64 6f 77 73 20 73 79 le on Windows sy
0210: 73 74 65 6d 73 20 77 69 74 68 20 4d 53 56 43 20 stems with MSVC
0220: 32 30 30 35 0a 2a 2a 20 6f 72 20 68 69 67 68 65 2005.** or highe
0230: 72 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 r..*/.#if define
0240: 64 28 5f 4d 53 43 5f 56 45 52 29 20 26 26 20 5f d(_MSC_VER) && _
0250: 4d 53 43 5f 56 45 52 3e 3d 31 34 30 30 0a 23 20 MSC_VER>=1400.#
0260: 20 64 65 66 69 6e 65 20 5f 43 52 54 5f 52 41 4e define _CRT_RAN
0270: 44 5f 53 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a D_S.#endif../*.*
0280: 2a 20 49 6e 63 6c 75 64 65 20 74 68 65 20 68 65 * Include the he
0290: 61 64 65 72 20 66 69 6c 65 20 75 73 65 64 20 74 ader file used t
02a0: 6f 20 63 75 73 74 6f 6d 69 7a 65 20 74 68 65 20 o customize the
02b0: 63 6f 6d 70 69 6c 65 72 20 6f 70 74 69 6f 6e 73 compiler options
02c0: 20 66 6f 72 20 4d 53 56 43 2e 0a 2a 2a 20 54 68 for MSVC..** Th
02d0: 69 73 20 73 68 6f 75 6c 64 20 62 65 20 64 6f 6e is should be don
02e0: 65 20 66 69 72 73 74 20 73 6f 20 74 68 61 74 20 e first so that
02f0: 69 74 20 63 61 6e 20 73 75 63 63 65 73 73 66 75 it can successfu
0300: 6c 6c 79 20 70 72 65 76 65 6e 74 20 73 70 75 72 lly prevent spur
0310: 69 6f 75 73 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 ious.** compiler
0320: 20 77 61 72 6e 69 6e 67 73 20 64 75 65 20 74 6f warnings due to
0330: 20 73 75 62 73 65 71 75 65 6e 74 20 63 6f 6e 74 subsequent cont
0340: 65 6e 74 20 69 6e 20 74 68 69 73 20 66 69 6c 65 ent in this file
0350: 20 61 6e 64 20 6f 74 68 65 72 20 66 69 6c 65 73 and other files
0360: 0a 2a 2a 20 74 68 61 74 20 61 72 65 20 69 6e 63 .** that are inc
0370: 6c 75 64 65 64 20 62 79 20 74 68 69 73 20 66 69 luded by this fi
0380: 6c 65 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 le..*/.#include
0390: 22 6d 73 76 63 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 "msvc.h"../*.**
03a0: 53 70 65 63 69 61 6c 20 73 65 74 75 70 20 66 6f Special setup fo
03b0: 72 20 56 78 57 6f 72 6b 73 0a 2a 2f 0a 23 69 6e r VxWorks.*/.#in
03c0: 63 6c 75 64 65 20 22 76 78 77 6f 72 6b 73 2e 68 clude "vxworks.h
03d0: 22 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 23 "../*.** These #
03e0: 64 65 66 69 6e 65 73 20 73 68 6f 75 6c 64 20 65 defines should e
03f0: 6e 61 62 6c 65 20 3e 32 47 42 20 66 69 6c 65 20 nable >2GB file
0400: 73 75 70 70 6f 72 74 20 6f 6e 20 50 4f 53 49 58 support on POSIX
0410: 20 69 66 20 74 68 65 0a 2a 2a 20 75 6e 64 65 72 if the.** under
0420: 6c 79 69 6e 67 20 6f 70 65 72 61 74 69 6e 67 20 lying operating
0430: 73 79 73 74 65 6d 20 73 75 70 70 6f 72 74 73 20 system supports
0440: 69 74 2e 20 20 49 66 20 74 68 65 20 4f 53 20 6c it. If the OS l
0450: 61 63 6b 73 0a 2a 2a 20 6c 61 72 67 65 20 66 69 acks.** large fi
0460: 6c 65 20 73 75 70 70 6f 72 74 2c 20 6f 72 20 69 le support, or i
0470: 66 20 74 68 65 20 4f 53 20 69 73 20 77 69 6e 64 f the OS is wind
0480: 6f 77 73 2c 20 74 68 65 73 65 20 73 68 6f 75 6c ows, these shoul
0490: 64 20 62 65 20 6e 6f 2d 6f 70 73 2e 0a 2a 2a 0a d be no-ops..**.
04a0: 2a 2a 20 54 69 63 6b 65 74 20 23 32 37 33 39 3a ** Ticket #2739:
04b0: 20 20 54 68 65 20 5f 4c 41 52 47 45 46 49 4c 45 The _LARGEFILE
04c0: 5f 53 4f 55 52 43 45 20 6d 61 63 72 6f 20 6d 75 _SOURCE macro mu
04d0: 73 74 20 61 70 70 65 61 72 20 62 65 66 6f 72 65 st appear before
04e0: 20 61 6e 79 0a 2a 2a 20 73 79 73 74 65 6d 20 23 any.** system #
04f0: 69 6e 63 6c 75 64 65 73 2e 20 20 48 65 6e 63 65 includes. Hence
0500: 2c 20 74 68 69 73 20 62 6c 6f 63 6b 20 6f 66 20 , this block of
0510: 63 6f 64 65 20 6d 75 73 74 20 62 65 20 74 68 65 code must be the
0520: 20 76 65 72 79 20 66 69 72 73 74 0a 2a 2a 20 63 very first.** c
0530: 6f 64 65 20 69 6e 20 61 6c 6c 20 73 6f 75 72 63 ode in all sourc
0540: 65 20 66 69 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 4c e files..**.** L
0550: 61 72 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 arge file suppor
0560: 74 20 63 61 6e 20 62 65 20 64 69 73 61 62 6c 65 t can be disable
0570: 64 20 75 73 69 6e 67 20 74 68 65 20 2d 44 53 51 d using the -DSQ
0580: 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 LITE_DISABLE_LFS
0590: 20 73 77 69 74 63 68 0a 2a 2a 20 6f 6e 20 74 68 switch.** on th
05a0: 65 20 63 6f 6d 70 69 6c 65 72 20 63 6f 6d 6d 61 e compiler comma
05b0: 6e 64 20 6c 69 6e 65 2e 20 20 54 68 69 73 20 69 nd line. This i
05c0: 73 20 6e 65 63 65 73 73 61 72 79 20 69 66 20 79 s necessary if y
05d0: 6f 75 20 61 72 65 20 63 6f 6d 70 69 6c 69 6e 67 ou are compiling
05e0: 0a 2a 2a 20 6f 6e 20 61 20 72 65 63 65 6e 74 20 .** on a recent
05f0: 6d 61 63 68 69 6e 65 20 28 65 78 3a 20 52 65 64 machine (ex: Red
0600: 20 48 61 74 20 37 2e 32 29 20 62 75 74 20 79 6f Hat 7.2) but yo
0610: 75 20 77 61 6e 74 20 79 6f 75 72 20 63 6f 64 65 u want your code
0620: 20 74 6f 20 77 6f 72 6b 0a 2a 2a 20 6f 6e 20 61 to work.** on a
0630: 6e 20 6f 6c 64 65 72 20 6d 61 63 68 69 6e 65 20 n older machine
0640: 28 65 78 3a 20 52 65 64 20 48 61 74 20 36 2e 30 (ex: Red Hat 6.0
0650: 29 2e 20 20 49 66 20 79 6f 75 20 63 6f 6d 70 69 ). If you compi
0660: 6c 65 20 6f 6e 20 52 65 64 20 48 61 74 20 37 2e le on Red Hat 7.
0670: 32 0a 2a 2a 20 77 69 74 68 6f 75 74 20 74 68 69 2.** without thi
0680: 73 20 6f 70 74 69 6f 6e 2c 20 4c 46 53 20 69 73 s option, LFS is
0690: 20 65 6e 61 62 6c 65 2e 20 20 42 75 74 20 4c 46 enable. But LF
06a0: 53 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 S does not exist
06b0: 20 69 6e 20 74 68 65 20 6b 65 72 6e 65 6c 0a 2a in the kernel.*
06c0: 2a 20 69 6e 20 52 65 64 20 48 61 74 20 36 2e 30 * in Red Hat 6.0
06d0: 2c 20 73 6f 20 74 68 65 20 63 6f 64 65 20 77 6f , so the code wo
06e0: 6e 27 74 20 77 6f 72 6b 2e 20 20 48 65 6e 63 65 n't work. Hence
06f0: 2c 20 66 6f 72 20 6d 61 78 69 6d 75 6d 20 62 69 , for maximum bi
0700: 6e 61 72 79 0a 2a 2a 20 70 6f 72 74 61 62 69 6c nary.** portabil
0710: 69 74 79 20 79 6f 75 20 73 68 6f 75 6c 64 20 6f ity you should o
0720: 6d 69 74 20 4c 46 53 2e 0a 2a 2a 0a 2a 2a 20 54 mit LFS..**.** T
0730: 68 65 20 70 72 65 76 69 6f 75 73 20 70 61 72 61 he previous para
0740: 67 72 61 70 68 20 77 61 73 20 77 72 69 74 74 65 graph was writte
0750: 6e 20 69 6e 20 32 30 30 35 2e 20 20 28 54 68 69 n in 2005. (Thi
0760: 73 20 70 61 72 61 67 72 61 70 68 20 69 73 20 77 s paragraph is w
0770: 72 69 74 74 65 6e 0a 2a 2a 20 6f 6e 20 32 30 30 ritten.** on 200
0780: 38 2d 31 31 2d 32 38 2e 29 20 54 68 65 73 65 20 8-11-28.) These
0790: 64 61 79 73 2c 20 61 6c 6c 20 4c 69 6e 75 78 20 days, all Linux
07a0: 6b 65 72 6e 65 6c 73 20 73 75 70 70 6f 72 74 20 kernels support
07b0: 6c 61 72 67 65 20 66 69 6c 65 73 2c 20 73 6f 0a large files, so.
07c0: 2a 2a 20 79 6f 75 20 73 68 6f 75 6c 64 20 70 72 ** you should pr
07d0: 6f 62 61 62 6c 79 20 6c 65 61 76 65 20 4c 46 53 obably leave LFS
07e0: 20 65 6e 61 62 6c 65 64 2e 20 20 42 75 74 20 73 enabled. But s
07f0: 6f 6d 65 20 65 6d 62 65 64 64 65 64 20 70 6c 61 ome embedded pla
0800: 74 66 6f 72 6d 73 20 6d 69 67 68 74 0a 2a 2a 20 tforms might.**
0810: 6c 61 63 6b 20 4c 46 53 20 69 6e 20 77 68 69 63 lack LFS in whic
0820: 68 20 63 61 73 65 20 74 68 65 20 53 51 4c 49 54 h case the SQLIT
0830: 45 5f 44 49 53 41 42 4c 45 5f 4c 46 53 20 6d 61 E_DISABLE_LFS ma
0840: 63 72 6f 20 6d 69 67 68 74 20 73 74 69 6c 6c 20 cro might still
0850: 62 65 20 75 73 65 66 75 6c 2e 0a 2a 2a 0a 2a 2a be useful..**.**
0860: 20 53 69 6d 69 6c 61 72 20 69 73 20 74 72 75 65 Similar is true
0870: 20 66 6f 72 20 4d 61 63 20 4f 53 20 58 2e 20 20 for Mac OS X.
0880: 4c 46 53 20 69 73 20 6f 6e 6c 79 20 73 75 70 70 LFS is only supp
0890: 6f 72 74 65 64 20 6f 6e 20 4d 61 63 20 4f 53 20 orted on Mac OS
08a0: 58 20 39 20 61 6e 64 20 6c 61 74 65 72 2e 0a 2a X 9 and later..*
08b0: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
08c0: 5f 44 49 53 41 42 4c 45 5f 4c 46 53 0a 23 20 64 _DISABLE_LFS.# d
08d0: 65 66 69 6e 65 20 5f 4c 41 52 47 45 5f 46 49 4c efine _LARGE_FIL
08e0: 45 20 20 20 20 20 20 20 31 0a 23 20 69 66 6e 64 E 1.# ifnd
08f0: 65 66 20 5f 46 49 4c 45 5f 4f 46 46 53 45 54 5f ef _FILE_OFFSET_
0900: 42 49 54 53 0a 23 20 20 20 64 65 66 69 6e 65 20 BITS.# define
0910: 5f 46 49 4c 45 5f 4f 46 46 53 45 54 5f 42 49 54 _FILE_OFFSET_BIT
0920: 53 20 36 34 0a 23 20 65 6e 64 69 66 0a 23 20 64 S 64.# endif.# d
0930: 65 66 69 6e 65 20 5f 4c 41 52 47 45 46 49 4c 45 efine _LARGEFILE
0940: 5f 53 4f 55 52 43 45 20 31 0a 23 65 6e 64 69 66 _SOURCE 1.#endif
0950: 0a 0a 2f 2a 20 57 68 61 74 20 76 65 72 73 69 6f ../* What versio
0960: 6e 20 6f 66 20 47 43 43 20 69 73 20 62 65 69 6e n of GCC is bein
0970: 67 20 75 73 65 64 2e 20 20 30 20 6d 65 61 6e 73 g used. 0 means
0980: 20 47 43 43 20 69 73 20 6e 6f 74 20 62 65 69 6e GCC is not bein
0990: 67 20 75 73 65 64 20 2a 2f 0a 23 69 66 64 65 66 g used */.#ifdef
09a0: 20 5f 5f 47 4e 55 43 5f 5f 0a 23 20 64 65 66 69 __GNUC__.# defi
09b0: 6e 65 20 47 43 43 5f 56 45 52 53 49 4f 4e 20 28 ne GCC_VERSION (
09c0: 5f 5f 47 4e 55 43 5f 5f 2a 31 30 30 30 30 30 30 __GNUC__*1000000
09d0: 2b 5f 5f 47 4e 55 43 5f 4d 49 4e 4f 52 5f 5f 2a +__GNUC_MINOR__*
09e0: 31 30 30 30 2b 5f 5f 47 4e 55 43 5f 50 41 54 43 1000+__GNUC_PATC
09f0: 48 4c 45 56 45 4c 5f 5f 29 0a 23 65 6c 73 65 0a HLEVEL__).#else.
0a00: 23 20 64 65 66 69 6e 65 20 47 43 43 5f 56 45 52 # define GCC_VER
0a10: 53 49 4f 4e 20 30 0a 23 65 6e 64 69 66 0a 0a 2f SION 0.#endif../
0a20: 2a 20 4e 65 65 64 65 64 20 66 6f 72 20 76 61 72 * Needed for var
0a30: 69 6f 75 73 20 64 65 66 69 6e 69 74 69 6f 6e 73 ious definitions
0a40: 2e 2e 2e 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e ... */.#if defin
0a50: 65 64 28 5f 5f 47 4e 55 43 5f 5f 29 20 26 26 20 ed(__GNUC__) &&
0a60: 21 64 65 66 69 6e 65 64 28 5f 47 4e 55 5f 53 4f !defined(_GNU_SO
0a70: 55 52 43 45 29 0a 23 20 64 65 66 69 6e 65 20 5f URCE).# define _
0a80: 47 4e 55 5f 53 4f 55 52 43 45 0a 23 65 6e 64 69 GNU_SOURCE.#endi
0a90: 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f f..#if defined(_
0aa0: 5f 4f 70 65 6e 42 53 44 5f 5f 29 20 26 26 20 21 _OpenBSD__) && !
0ab0: 64 65 66 69 6e 65 64 28 5f 42 53 44 5f 53 4f 55 defined(_BSD_SOU
0ac0: 52 43 45 29 0a 23 20 64 65 66 69 6e 65 20 5f 42 RCE).# define _B
0ad0: 53 44 5f 53 4f 55 52 43 45 0a 23 65 6e 64 69 66 SD_SOURCE.#endif
0ae0: 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 20 4d 69 6e 47 ../*.** For MinG
0af0: 57 2c 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 W, check to see
0b00: 69 66 20 77 65 20 63 61 6e 20 69 6e 63 6c 75 64 if we can includ
0b10: 65 20 74 68 65 20 68 65 61 64 65 72 20 66 69 6c e the header fil
0b20: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 69 74 73 e containing its
0b30: 0a 2a 2a 20 76 65 72 73 69 6f 6e 20 69 6e 66 6f .** version info
0b40: 72 6d 61 74 69 6f 6e 2c 20 61 6d 6f 6e 67 20 6f rmation, among o
0b50: 74 68 65 72 20 74 68 69 6e 67 73 2e 20 20 4e 6f ther things. No
0b60: 72 6d 61 6c 6c 79 2c 20 74 68 69 73 20 69 6e 74 rmally, this int
0b70: 65 72 6e 61 6c 20 4d 69 6e 47 57 0a 2a 2a 20 68 ernal MinGW.** h
0b80: 65 61 64 65 72 20 66 69 6c 65 20 77 6f 75 6c 64 eader file would
0b90: 20 5b 6f 6e 6c 79 5d 20 62 65 20 69 6e 63 6c 75 [only] be inclu
0ba0: 64 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c ded automaticall
0bb0: 79 20 62 79 20 6f 74 68 65 72 20 4d 69 6e 47 57 y by other MinGW
0bc0: 20 68 65 61 64 65 72 0a 2a 2a 20 66 69 6c 65 73 header.** files
0bd0: 3b 20 68 6f 77 65 76 65 72 2c 20 74 68 65 20 63 ; however, the c
0be0: 6f 6e 74 61 69 6e 65 64 20 76 65 72 73 69 6f 6e ontained version
0bf0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 73 20 information is
0c00: 6e 6f 77 20 72 65 71 75 69 72 65 64 20 62 79 20 now required by
0c10: 74 68 69 73 0a 2a 2a 20 68 65 61 64 65 72 20 66 this.** header f
0c20: 69 6c 65 20 74 6f 20 77 6f 72 6b 20 61 72 6f 75 ile to work arou
0c30: 6e 64 20 62 69 6e 61 72 79 20 63 6f 6d 70 61 74 nd binary compat
0c40: 69 62 69 6c 69 74 79 20 69 73 73 75 65 73 20 28 ibility issues (
0c50: 73 65 65 20 62 65 6c 6f 77 29 20 61 6e 64 0a 2a see below) and.*
0c60: 2a 20 74 68 69 73 20 69 73 20 74 68 65 20 6f 6e * this is the on
0c70: 6c 79 20 6b 6e 6f 77 6e 20 77 61 79 20 74 6f 20 ly known way to
0c80: 72 65 6c 69 61 62 6c 79 20 6f 62 74 61 69 6e 20 reliably obtain
0c90: 69 74 2e 20 20 54 68 69 73 20 65 6e 74 69 72 65 it. This entire
0ca0: 20 23 69 66 20 62 6c 6f 63 6b 0a 2a 2a 20 77 6f #if block.** wo
0cb0: 75 6c 64 20 62 65 20 63 6f 6d 70 6c 65 74 65 6c uld be completel
0cc0: 79 20 75 6e 6e 65 63 65 73 73 61 72 79 20 69 66 y unnecessary if
0cd0: 20 74 68 65 72 65 20 77 61 73 20 61 6e 79 20 6f there was any o
0ce0: 74 68 65 72 20 77 61 79 20 6f 66 20 64 65 74 65 ther way of dete
0cf0: 63 74 69 6e 67 0a 2a 2a 20 4d 69 6e 47 57 20 76 cting.** MinGW v
0d00: 69 61 20 74 68 65 69 72 20 70 72 65 70 72 6f 63 ia their preproc
0d10: 65 73 73 6f 72 20 28 65 2e 67 2e 20 69 66 20 74 essor (e.g. if t
0d20: 68 65 79 20 63 75 73 74 6f 6d 69 7a 65 64 20 74 hey customized t
0d30: 68 65 69 72 20 47 43 43 20 74 6f 20 64 65 66 69 heir GCC to defi
0d40: 6e 65 0a 2a 2a 20 73 6f 6d 65 20 4d 69 6e 47 57 ne.** some MinGW
0d50: 2d 73 70 65 63 69 66 69 63 20 6d 61 63 72 6f 73 -specific macros
0d60: 29 2e 20 20 57 68 65 6e 20 63 6f 6d 70 69 6c 69 ). When compili
0d70: 6e 67 20 66 6f 72 20 4d 69 6e 47 57 2c 20 65 69 ng for MinGW, ei
0d80: 74 68 65 72 20 74 68 65 0a 2a 2a 20 5f 48 41 56 ther the.** _HAV
0d90: 45 5f 4d 49 4e 47 57 5f 48 20 6f 72 20 5f 48 41 E_MINGW_H or _HA
0da0: 56 45 5f 5f 4d 49 4e 47 57 5f 48 20 28 6e 6f 74 VE__MINGW_H (not
0db0: 65 20 74 68 65 20 65 78 74 72 61 20 75 6e 64 65 e the extra unde
0dc0: 72 73 63 6f 72 65 29 20 6d 61 63 72 6f 20 6d 75 rscore) macro mu
0dd0: 73 74 20 62 65 0a 2a 2a 20 64 65 66 69 6e 65 64 st be.** defined
0de0: 3b 20 6f 74 68 65 72 77 69 73 65 2c 20 64 65 74 ; otherwise, det
0df0: 65 63 74 69 6f 6e 20 6f 66 20 63 6f 6e 64 69 74 ection of condit
0e00: 69 6f 6e 73 20 73 70 65 63 69 66 69 63 20 74 6f ions specific to
0e10: 20 4d 69 6e 47 57 20 77 69 6c 6c 20 62 65 0a 2a MinGW will be.*
0e20: 2a 20 64 69 73 61 62 6c 65 64 2e 0a 2a 2f 0a 23 * disabled..*/.#
0e30: 69 66 20 64 65 66 69 6e 65 64 28 5f 48 41 56 45 if defined(_HAVE
0e40: 5f 4d 49 4e 47 57 5f 48 29 0a 23 20 69 6e 63 6c _MINGW_H).# incl
0e50: 75 64 65 20 22 6d 69 6e 67 77 2e 68 22 0a 23 65 ude "mingw.h".#e
0e60: 6c 69 66 20 64 65 66 69 6e 65 64 28 5f 48 41 56 lif defined(_HAV
0e70: 45 5f 5f 4d 49 4e 47 57 5f 48 29 0a 23 20 69 6e E__MINGW_H).# in
0e80: 63 6c 75 64 65 20 22 5f 6d 69 6e 67 77 2e 68 22 clude "_mingw.h"
0e90: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 .#endif../*.** F
0ea0: 6f 72 20 4d 69 6e 47 57 20 76 65 72 73 69 6f 6e or MinGW version
0eb0: 20 34 2e 78 20 28 61 6e 64 20 68 69 67 68 65 72 4.x (and higher
0ec0: 29 2c 20 63 68 65 63 6b 20 74 6f 20 73 65 65 20 ), check to see
0ed0: 69 66 20 74 68 65 20 5f 55 53 45 5f 33 32 42 49 if the _USE_32BI
0ee0: 54 5f 54 49 4d 45 5f 54 0a 2a 2a 20 64 65 66 69 T_TIME_T.** defi
0ef0: 6e 65 20 69 73 20 72 65 71 75 69 72 65 64 20 74 ne is required t
0f00: 6f 20 6d 61 69 6e 74 61 69 6e 20 62 69 6e 61 72 o maintain binar
0f10: 79 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 y compatibility
0f20: 77 69 74 68 20 74 68 65 20 4d 53 56 43 20 72 75 with the MSVC ru
0f30: 6e 74 69 6d 65 0a 2a 2a 20 6c 69 62 72 61 72 79 ntime.** library
0f40: 20 69 6e 20 75 73 65 20 28 65 2e 67 2e 20 66 6f in use (e.g. fo
0f50: 72 20 57 69 6e 64 6f 77 73 20 58 50 29 2e 0a 2a r Windows XP)..*
0f60: 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 5f /.#if !defined(_
0f70: 55 53 45 5f 33 32 42 49 54 5f 54 49 4d 45 5f 54 USE_32BIT_TIME_T
0f80: 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 5f 55 ) && !defined(_U
0f90: 53 45 5f 36 34 42 49 54 5f 54 49 4d 45 5f 54 29 SE_64BIT_TIME_T)
0fa0: 20 26 26 20 5c 0a 20 20 20 20 64 65 66 69 6e 65 && \. define
0fb0: 64 28 5f 57 49 4e 33 32 29 20 26 26 20 21 64 65 d(_WIN32) && !de
0fc0: 66 69 6e 65 64 28 5f 57 49 4e 36 34 29 20 26 26 fined(_WIN64) &&
0fd0: 20 5c 0a 20 20 20 20 64 65 66 69 6e 65 64 28 5f \. defined(_
0fe0: 5f 4d 49 4e 47 57 5f 4d 41 4a 4f 52 5f 56 45 52 _MINGW_MAJOR_VER
0ff0: 53 49 4f 4e 29 20 26 26 20 5f 5f 4d 49 4e 47 57 SION) && __MINGW
1000: 5f 4d 41 4a 4f 52 5f 56 45 52 53 49 4f 4e 20 3e _MAJOR_VERSION >
1010: 3d 20 34 20 26 26 20 5c 0a 20 20 20 20 64 65 66 = 4 && \. def
1020: 69 6e 65 64 28 5f 5f 4d 53 56 43 52 54 5f 5f 29 ined(__MSVCRT__)
1030: 0a 23 20 64 65 66 69 6e 65 20 5f 55 53 45 5f 33 .# define _USE_3
1040: 32 42 49 54 5f 54 49 4d 45 5f 54 0a 23 65 6e 64 2BIT_TIME_T.#end
1050: 69 66 0a 0a 2f 2a 20 54 68 65 20 70 75 62 6c 69 if../* The publi
1060: 63 20 53 51 4c 69 74 65 20 69 6e 74 65 72 66 61 c SQLite interfa
1070: 63 65 2e 20 20 54 68 65 20 5f 46 49 4c 45 5f 4f ce. The _FILE_O
1080: 46 46 53 45 54 5f 42 49 54 53 20 6d 61 63 72 6f FFSET_BITS macro
1090: 20 6d 75 73 74 20 61 70 70 65 61 72 0a 2a 2a 20 must appear.**
10a0: 66 69 72 73 74 20 69 6e 20 51 4e 58 2e 20 20 41 first in QNX. A
10b0: 6c 73 6f 2c 20 74 68 65 20 5f 55 53 45 5f 33 32 lso, the _USE_32
10c0: 42 49 54 5f 54 49 4d 45 5f 54 20 6d 61 63 72 6f BIT_TIME_T macro
10d0: 20 6d 75 73 74 20 61 70 70 65 61 72 20 66 69 72 must appear fir
10e0: 73 74 20 66 6f 72 0a 2a 2a 20 4d 69 6e 47 57 2e st for.** MinGW.
10f0: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 .*/.#include "sq
1100: 6c 69 74 65 33 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 lite3.h"../*.**
1110: 49 6e 63 6c 75 64 65 20 74 68 65 20 63 6f 6e 66 Include the conf
1120: 69 67 75 72 61 74 69 6f 6e 20 68 65 61 64 65 72 iguration header
1130: 20 6f 75 74 70 75 74 20 62 79 20 27 63 6f 6e 66 output by 'conf
1140: 69 67 75 72 65 27 20 69 66 20 77 65 27 72 65 20 igure' if we're
1150: 75 73 69 6e 67 20 74 68 65 0a 2a 2a 20 61 75 74 using the.** aut
1160: 6f 63 6f 6e 66 2d 62 61 73 65 64 20 62 75 69 6c oconf-based buil
1170: 64 0a 2a 2f 0a 23 69 66 64 65 66 20 5f 48 41 56 d.*/.#ifdef _HAV
1180: 45 5f 53 51 4c 49 54 45 5f 43 4f 4e 46 49 47 5f E_SQLITE_CONFIG_
1190: 48 0a 23 69 6e 63 6c 75 64 65 20 22 63 6f 6e 66 H.#include "conf
11a0: 69 67 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 23 69 ig.h".#endif..#i
11b0: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 4c 69 nclude "sqliteLi
11c0: 6d 69 74 2e 68 22 0a 0a 2f 2a 20 44 69 73 61 62 mit.h"../* Disab
11d0: 6c 65 20 6e 75 69 73 61 6e 63 65 20 77 61 72 6e le nuisance warn
11e0: 69 6e 67 73 20 6f 6e 20 42 6f 72 6c 61 6e 64 20 ings on Borland
11f0: 63 6f 6d 70 69 6c 65 72 73 20 2a 2f 0a 23 69 66 compilers */.#if
1200: 20 64 65 66 69 6e 65 64 28 5f 5f 42 4f 52 4c 41 defined(__BORLA
1210: 4e 44 43 5f 5f 29 0a 23 70 72 61 67 6d 61 20 77 NDC__).#pragma w
1220: 61 72 6e 20 2d 72 63 68 20 2f 2a 20 75 6e 72 65 arn -rch /* unre
1230: 61 63 68 61 62 6c 65 20 63 6f 64 65 20 2a 2f 0a achable code */.
1240: 23 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 63 63 #pragma warn -cc
1250: 63 20 2f 2a 20 43 6f 6e 64 69 74 69 6f 6e 20 69 c /* Condition i
1260: 73 20 61 6c 77 61 79 73 20 74 72 75 65 20 6f 72 s always true or
1270: 20 66 61 6c 73 65 20 2a 2f 0a 23 70 72 61 67 6d false */.#pragm
1280: 61 20 77 61 72 6e 20 2d 61 75 73 20 2f 2a 20 41 a warn -aus /* A
1290: 73 73 69 67 6e 65 64 20 76 61 6c 75 65 20 69 73 ssigned value is
12a0: 20 6e 65 76 65 72 20 75 73 65 64 20 2a 2f 0a 23 never used */.#
12b0: 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 63 73 75 pragma warn -csu
12c0: 20 2f 2a 20 43 6f 6d 70 61 72 69 6e 67 20 73 69 /* Comparing si
12d0: 67 6e 65 64 20 61 6e 64 20 75 6e 73 69 67 6e 65 gned and unsigne
12e0: 64 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 72 d */.#pragma war
12f0: 6e 20 2d 73 70 61 20 2f 2a 20 53 75 73 70 69 63 n -spa /* Suspic
1300: 69 6f 75 73 20 70 6f 69 6e 74 65 72 20 61 72 69 ious pointer ari
1310: 74 68 6d 65 74 69 63 20 2a 2f 0a 23 65 6e 64 69 thmetic */.#endi
1320: 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 6c 75 64 65 f../*.** Include
1330: 20 73 74 61 6e 64 61 72 64 20 68 65 61 64 65 72 standard header
1340: 20 66 69 6c 65 73 20 61 73 20 6e 65 63 65 73 73 files as necess
1350: 61 72 79 0a 2a 2f 0a 23 69 66 64 65 66 20 48 41 ary.*/.#ifdef HA
1360: 56 45 5f 53 54 44 49 4e 54 5f 48 0a 23 69 6e 63 VE_STDINT_H.#inc
1370: 6c 75 64 65 20 3c 73 74 64 69 6e 74 2e 68 3e 0a lude <stdint.h>.
1380: 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 48 41 #endif.#ifdef HA
1390: 56 45 5f 49 4e 54 54 59 50 45 53 5f 48 0a 23 69 VE_INTTYPES_H.#i
13a0: 6e 63 6c 75 64 65 20 3c 69 6e 74 74 79 70 65 73 nclude <inttypes
13b0: 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a .h>.#endif../*.*
13c0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
13d0: 6d 61 63 72 6f 73 20 61 72 65 20 75 73 65 64 20 macros are used
13e0: 74 6f 20 63 61 73 74 20 70 6f 69 6e 74 65 72 73 to cast pointers
13f0: 20 74 6f 20 69 6e 74 65 67 65 72 73 20 61 6e 64 to integers and
1400: 0a 2a 2a 20 69 6e 74 65 67 65 72 73 20 74 6f 20 .** integers to
1410: 70 6f 69 6e 74 65 72 73 2e 20 20 54 68 65 20 77 pointers. The w
1420: 61 79 20 79 6f 75 20 64 6f 20 74 68 69 73 20 76 ay you do this v
1430: 61 72 69 65 73 20 66 72 6f 6d 20 6f 6e 65 20 63 aries from one c
1440: 6f 6d 70 69 6c 65 72 0a 2a 2a 20 74 6f 20 74 68 ompiler.** to th
1450: 65 20 6e 65 78 74 2c 20 73 6f 20 77 65 20 68 61 e next, so we ha
1460: 76 65 20 64 65 76 65 6c 6f 70 65 64 20 74 68 65 ve developed the
1470: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 74 20 6f following set o
1480: 66 20 23 69 66 20 73 74 61 74 65 6d 65 6e 74 73 f #if statements
1490: 0a 2a 2a 20 74 6f 20 67 65 6e 65 72 61 74 65 20 .** to generate
14a0: 61 70 70 72 6f 70 72 69 61 74 65 20 6d 61 63 72 appropriate macr
14b0: 6f 73 20 66 6f 72 20 61 20 77 69 64 65 20 72 61 os for a wide ra
14c0: 6e 67 65 20 6f 66 20 63 6f 6d 70 69 6c 65 72 73 nge of compilers
14d0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 72 72 ..**.** The corr
14e0: 65 63 74 20 22 41 4e 53 49 22 20 77 61 79 20 74 ect "ANSI" way t
14f0: 6f 20 64 6f 20 74 68 69 73 20 69 73 20 74 6f 20 o do this is to
1500: 75 73 65 20 74 68 65 20 69 6e 74 70 74 72 5f 74 use the intptr_t
1510: 20 74 79 70 65 2e 0a 2a 2a 20 55 6e 66 6f 72 74 type..** Unfort
1520: 75 6e 61 74 65 6c 79 2c 20 74 68 61 74 20 74 79 unately, that ty
1530: 70 65 64 65 66 20 69 73 20 6e 6f 74 20 61 76 61 pedef is not ava
1540: 69 6c 61 62 6c 65 20 6f 6e 20 61 6c 6c 20 63 6f ilable on all co
1550: 6d 70 69 6c 65 72 73 2c 20 6f 72 0a 2a 2a 20 69 mpilers, or.** i
1560: 66 20 69 74 20 69 73 20 61 76 61 69 6c 61 62 6c f it is availabl
1570: 65 2c 20 69 74 20 72 65 71 75 69 72 65 73 20 61 e, it requires a
1580: 6e 20 23 69 6e 63 6c 75 64 65 20 6f 66 20 73 70 n #include of sp
1590: 65 63 69 66 69 63 20 68 65 61 64 65 72 73 0a 2a ecific headers.*
15a0: 2a 20 74 68 61 74 20 76 61 72 79 20 66 72 6f 6d * that vary from
15b0: 20 6f 6e 65 20 6d 61 63 68 69 6e 65 20 74 6f 20 one machine to
15c0: 74 68 65 20 6e 65 78 74 2e 0a 2a 2a 0a 2a 2a 20 the next..**.**
15d0: 54 69 63 6b 65 74 20 23 33 38 36 30 3a 20 20 54 Ticket #3860: T
15e0: 68 65 20 6c 6c 76 6d 2d 67 63 63 2d 34 2e 32 20 he llvm-gcc-4.2
15f0: 63 6f 6d 70 69 6c 65 72 20 66 72 6f 6d 20 41 70 compiler from Ap
1600: 70 6c 65 20 63 68 6f 6b 65 73 20 6f 6e 0a 2a 2a ple chokes on.**
1610: 20 74 68 65 20 28 28 76 6f 69 64 2a 29 26 28 28 the ((void*)&((
1620: 63 68 61 72 2a 29 30 29 5b 58 5d 29 20 63 6f 6e char*)0)[X]) con
1630: 73 74 72 75 63 74 2e 20 20 42 75 74 20 4d 53 56 struct. But MSV
1640: 43 20 63 68 6f 6b 65 73 20 6f 6e 20 28 28 76 6f C chokes on ((vo
1650: 69 64 2a 29 28 58 29 29 2e 0a 2a 2a 20 53 6f 20 id*)(X))..** So
1660: 77 65 20 68 61 76 65 20 74 6f 20 64 65 66 69 6e we have to defin
1670: 65 20 74 68 65 20 6d 61 63 72 6f 73 20 69 6e 20 e the macros in
1680: 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 20 64 different ways d
1690: 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 0a epending on the.
16a0: 2a 2a 20 63 6f 6d 70 69 6c 65 72 2e 0a 2a 2f 0a ** compiler..*/.
16b0: 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 50 54 #if defined(__PT
16c0: 52 44 49 46 46 5f 54 59 50 45 5f 5f 29 20 20 2f RDIFF_TYPE__) /
16d0: 2a 20 54 68 69 73 20 63 61 73 65 20 73 68 6f 75 * This case shou
16e0: 6c 64 20 77 6f 72 6b 20 66 6f 72 20 47 43 43 20 ld work for GCC
16f0: 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 */.# define SQLI
1700: 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 29 TE_INT_TO_PTR(X)
1710: 20 20 28 28 76 6f 69 64 2a 29 28 5f 5f 50 54 52 ((void*)(__PTR
1720: 44 49 46 46 5f 54 59 50 45 5f 5f 29 28 58 29 29 DIFF_TYPE__)(X))
1730: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
1740: 5f 50 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 20 _PTR_TO_INT(X)
1750: 28 28 69 6e 74 29 28 5f 5f 50 54 52 44 49 46 46 ((int)(__PTRDIFF
1760: 5f 54 59 50 45 5f 5f 29 28 58 29 29 0a 23 65 6c _TYPE__)(X)).#el
1770: 69 66 20 21 64 65 66 69 6e 65 64 28 5f 5f 47 4e if !defined(__GN
1780: 55 43 5f 5f 29 20 20 20 20 20 20 20 2f 2a 20 57 UC__) /* W
1790: 6f 72 6b 73 20 66 6f 72 20 63 6f 6d 70 69 6c 65 orks for compile
17a0: 72 73 20 6f 74 68 65 72 20 74 68 61 6e 20 4c 4c rs other than LL
17b0: 56 4d 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 VM */.# define S
17c0: 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 QLITE_INT_TO_PTR
17d0: 28 58 29 20 20 28 28 76 6f 69 64 2a 29 26 28 28 (X) ((void*)&((
17e0: 63 68 61 72 2a 29 30 29 5b 58 5d 29 0a 23 20 64 char*)0)[X]).# d
17f0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 efine SQLITE_PTR
1800: 5f 54 4f 5f 49 4e 54 28 58 29 20 20 28 28 69 6e _TO_INT(X) ((in
1810: 74 29 28 28 28 63 68 61 72 2a 29 58 29 2d 28 63 t)(((char*)X)-(c
1820: 68 61 72 2a 29 30 29 29 0a 23 65 6c 69 66 20 64 har*)0)).#elif d
1830: 65 66 69 6e 65 64 28 48 41 56 45 5f 53 54 44 49 efined(HAVE_STDI
1840: 4e 54 5f 48 29 20 20 20 2f 2a 20 55 73 65 20 74 NT_H) /* Use t
1850: 68 69 73 20 63 61 73 65 20 69 66 20 77 65 20 68 his case if we h
1860: 61 76 65 20 41 4e 53 49 20 68 65 61 64 65 72 73 ave ANSI headers
1870: 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c */.# define SQL
1880: 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 ITE_INT_TO_PTR(X
1890: 29 20 20 28 28 76 6f 69 64 2a 29 28 69 6e 74 70 ) ((void*)(intp
18a0: 74 72 5f 74 29 28 58 29 29 0a 23 20 64 65 66 69 tr_t)(X)).# defi
18b0: 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f ne SQLITE_PTR_TO
18c0: 5f 49 4e 54 28 58 29 20 20 28 28 69 6e 74 29 28 _INT(X) ((int)(
18d0: 69 6e 74 70 74 72 5f 74 29 28 58 29 29 0a 23 65 intptr_t)(X)).#e
18e0: 6c 73 65 20 20 20 20 20 20 20 20 20 20 20 20 20 lse
18f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1900: 47 65 6e 65 72 61 74 65 73 20 61 20 77 61 72 6e Generates a warn
1910: 69 6e 67 20 2d 20 62 75 74 20 69 74 20 61 6c 77 ing - but it alw
1920: 61 79 73 20 77 6f 72 6b 73 20 2a 2f 0a 23 20 64 ays works */.# d
1930: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 efine SQLITE_INT
1940: 5f 54 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f _TO_PTR(X) ((vo
1950: 69 64 2a 29 28 58 29 29 0a 23 20 64 65 66 69 6e id*)(X)).# defin
1960: 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f e SQLITE_PTR_TO_
1970: 49 4e 54 28 58 29 20 20 28 28 69 6e 74 29 28 58 INT(X) ((int)(X
1980: 29 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a )).#endif../*.**
1990: 20 54 68 65 20 53 51 4c 49 54 45 5f 57 49 54 48 The SQLITE_WITH
19a0: 49 4e 28 50 2c 53 2c 45 29 20 6d 61 63 72 6f 20 IN(P,S,E) macro
19b0: 63 68 65 63 6b 73 20 74 6f 20 73 65 65 20 69 66 checks to see if
19c0: 20 70 6f 69 6e 74 65 72 20 50 20 70 6f 69 6e 74 pointer P point
19d0: 73 20 74 6f 0a 2a 2a 20 73 6f 6d 65 74 68 69 6e s to.** somethin
19e0: 67 20 62 65 74 77 65 65 6e 20 53 20 28 69 6e 63 g between S (inc
19f0: 6c 75 73 69 76 65 29 20 61 6e 64 20 45 20 28 65 lusive) and E (e
1a00: 78 63 6c 75 73 69 76 65 29 2e 0a 2a 2a 0a 2a 2a xclusive)..**.**
1a10: 20 49 6e 20 6f 74 68 65 72 20 77 6f 72 64 73 2c In other words,
1a20: 20 53 20 69 73 20 61 20 62 75 66 66 65 72 20 61 S is a buffer a
1a30: 6e 64 20 45 20 69 73 20 61 20 70 6f 69 6e 74 65 nd E is a pointe
1a40: 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 r to the first b
1a50: 79 74 65 20 61 66 74 65 72 0a 2a 2a 20 74 68 65 yte after.** the
1a60: 20 65 6e 64 20 6f 66 20 62 75 66 66 65 72 20 53 end of buffer S
1a70: 2e 20 20 54 68 69 73 20 6d 61 63 72 6f 20 72 65 . This macro re
1a80: 74 75 72 6e 73 20 74 72 75 65 20 69 66 20 50 20 turns true if P
1a90: 70 6f 69 6e 74 73 20 74 6f 20 73 6f 6d 65 74 68 points to someth
1aa0: 69 6e 67 0a 2a 2a 20 63 6f 6e 74 61 69 6e 65 64 ing.** contained
1ab0: 20 77 69 74 68 69 6e 20 74 68 65 20 62 75 66 66 within the buff
1ac0: 65 72 20 53 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 er S..*/.#if def
1ad0: 69 6e 65 64 28 48 41 56 45 5f 53 54 44 49 4e 54 ined(HAVE_STDINT
1ae0: 5f 48 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c _H).# define SQL
1af0: 49 54 45 5f 57 49 54 48 49 4e 28 50 2c 53 2c 45 ITE_WITHIN(P,S,E
1b00: 29 20 5c 0a 20 20 20 20 28 28 75 69 6e 74 70 74 ) \. ((uintpt
1b10: 72 5f 74 29 28 50 29 3e 3d 28 75 69 6e 74 70 74 r_t)(P)>=(uintpt
1b20: 72 5f 74 29 28 53 29 20 26 26 20 28 75 69 6e 74 r_t)(S) && (uint
1b30: 70 74 72 5f 74 29 28 50 29 3c 28 75 69 6e 74 70 ptr_t)(P)<(uintp
1b40: 74 72 5f 74 29 28 45 29 29 0a 23 65 6c 73 65 0a tr_t)(E)).#else.
1b50: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
1b60: 57 49 54 48 49 4e 28 50 2c 53 2c 45 29 20 28 28 WITHIN(P,S,E) ((
1b70: 50 29 3e 3d 28 53 29 20 26 26 20 28 50 29 3c 28 P)>=(S) && (P)<(
1b80: 45 29 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a E)).#endif../*.*
1b90: 2a 20 41 20 6d 61 63 72 6f 20 74 6f 20 68 69 6e * A macro to hin
1ba0: 74 20 74 6f 20 74 68 65 20 63 6f 6d 70 69 6c 65 t to the compile
1bb0: 72 20 74 68 61 74 20 61 20 66 75 6e 63 74 69 6f r that a functio
1bc0: 6e 20 73 68 6f 75 6c 64 20 6e 6f 74 20 62 65 0a n should not be.
1bd0: 2a 2a 20 69 6e 6c 69 6e 65 64 2e 0a 2a 2f 0a 23 ** inlined..*/.#
1be0: 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 47 4e 55 if defined(__GNU
1bf0: 43 5f 5f 29 0a 23 20 20 64 65 66 69 6e 65 20 53 C__).# define S
1c00: 51 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 20 QLITE_NOINLINE
1c10: 5f 5f 61 74 74 72 69 62 75 74 65 5f 5f 28 28 6e __attribute__((n
1c20: 6f 69 6e 6c 69 6e 65 29 29 0a 23 65 6c 69 66 20 oinline)).#elif
1c30: 64 65 66 69 6e 65 64 28 5f 4d 53 43 5f 56 45 52 defined(_MSC_VER
1c40: 29 20 26 26 20 5f 4d 53 43 5f 56 45 52 3e 3d 31 ) && _MSC_VER>=1
1c50: 33 31 30 0a 23 20 20 64 65 66 69 6e 65 20 53 51 310.# define SQ
1c60: 4c 49 54 45 5f 4e 4f 49 4e 4c 49 4e 45 20 20 5f LITE_NOINLINE _
1c70: 5f 64 65 63 6c 73 70 65 63 28 6e 6f 69 6e 6c 69 _declspec(noinli
1c80: 6e 65 29 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 ne).#else.# def
1c90: 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 49 4e 4c ine SQLITE_NOINL
1ca0: 49 4e 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a INE.#endif../*.*
1cb0: 2a 20 4d 61 6b 65 20 73 75 72 65 20 74 68 61 74 * Make sure that
1cc0: 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 69 6e the compiler in
1cd0: 74 72 69 6e 73 69 63 73 20 77 65 20 64 65 73 69 trinsics we desi
1ce0: 72 65 20 61 72 65 20 65 6e 61 62 6c 65 64 20 77 re are enabled w
1cf0: 68 65 6e 0a 2a 2a 20 63 6f 6d 70 69 6c 69 6e 67 hen.** compiling
1d00: 20 77 69 74 68 20 61 6e 20 61 70 70 72 6f 70 72 with an appropr
1d10: 69 61 74 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 iate version of
1d20: 4d 53 56 43 20 75 6e 6c 65 73 73 20 70 72 65 76 MSVC unless prev
1d30: 65 6e 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 ented by.** the
1d40: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 49 SQLITE_DISABLE_I
1d50: 4e 54 52 49 4e 53 49 43 20 64 65 66 69 6e 65 2e NTRINSIC define.
1d60: 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 .*/.#if !defined
1d70: 28 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f (SQLITE_DISABLE_
1d80: 49 4e 54 52 49 4e 53 49 43 29 0a 23 20 20 69 66 INTRINSIC).# if
1d90: 20 64 65 66 69 6e 65 64 28 5f 4d 53 43 5f 56 45 defined(_MSC_VE
1da0: 52 29 20 26 26 20 5f 4d 53 43 5f 56 45 52 3e 3d R) && _MSC_VER>=
1db0: 31 33 30 30 0a 23 20 20 20 20 69 66 20 21 64 65 1300.# if !de
1dc0: 66 69 6e 65 64 28 5f 57 49 4e 33 32 5f 57 43 45 fined(_WIN32_WCE
1dd0: 29 0a 23 20 20 20 20 20 20 69 6e 63 6c 75 64 65 ).# include
1de0: 20 3c 69 6e 74 72 69 6e 2e 68 3e 0a 23 20 20 20 <intrin.h>.#
1df0: 20 20 20 70 72 61 67 6d 61 20 69 6e 74 72 69 6e pragma intrin
1e00: 73 69 63 28 5f 62 79 74 65 73 77 61 70 5f 75 73 sic(_byteswap_us
1e10: 68 6f 72 74 29 0a 23 20 20 20 20 20 20 70 72 61 hort).# pra
1e20: 67 6d 61 20 69 6e 74 72 69 6e 73 69 63 28 5f 62 gma intrinsic(_b
1e30: 79 74 65 73 77 61 70 5f 75 6c 6f 6e 67 29 0a 23 yteswap_ulong).#
1e40: 20 20 20 20 20 20 70 72 61 67 6d 61 20 69 6e 74 pragma int
1e50: 72 69 6e 73 69 63 28 5f 52 65 61 64 57 72 69 74 rinsic(_ReadWrit
1e60: 65 42 61 72 72 69 65 72 29 0a 23 20 20 20 20 65 eBarrier).# e
1e70: 6c 73 65 0a 23 20 20 20 20 20 20 69 6e 63 6c 75 lse.# inclu
1e80: 64 65 20 3c 63 6d 6e 69 6e 74 72 69 6e 2e 68 3e de <cmnintrin.h>
1e90: 0a 23 20 20 20 20 65 6e 64 69 66 0a 23 20 20 65 .# endif.# e
1ea0: 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a ndif.#endif../*.
1eb0: 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 54 48 ** The SQLITE_TH
1ec0: 52 45 41 44 53 41 46 45 20 6d 61 63 72 6f 20 6d READSAFE macro m
1ed0: 75 73 74 20 62 65 20 64 65 66 69 6e 65 64 20 61 ust be defined a
1ee0: 73 20 30 2c 20 31 2c 20 6f 72 20 32 2e 0a 2a 2a s 0, 1, or 2..**
1ef0: 20 30 20 6d 65 61 6e 73 20 6d 75 74 65 78 65 73 0 means mutexes
1f00: 20 61 72 65 20 70 65 72 6d 61 6e 65 6e 74 6c 79 are permanently
1f10: 20 64 69 73 61 62 6c 65 20 61 6e 64 20 74 68 65 disable and the
1f20: 20 6c 69 62 72 61 72 79 20 69 73 20 6e 65 76 65 library is neve
1f30: 72 0a 2a 2a 20 74 68 72 65 61 64 73 61 66 65 2e r.** threadsafe.
1f40: 20 20 31 20 6d 65 61 6e 73 20 74 68 65 20 6c 69 1 means the li
1f50: 62 72 61 72 79 20 69 73 20 73 65 72 69 61 6c 69 brary is seriali
1f60: 7a 65 64 20 77 68 69 63 68 20 69 73 20 74 68 65 zed which is the
1f70: 20 68 69 67 68 65 73 74 0a 2a 2a 20 6c 65 76 65 highest.** leve
1f80: 6c 20 6f 66 20 74 68 72 65 61 64 73 61 66 65 74 l of threadsafet
1f90: 79 2e 20 20 32 20 6d 65 61 6e 73 20 74 68 65 20 y. 2 means the
1fa0: 6c 69 62 72 61 72 79 20 69 73 20 6d 75 6c 74 69 library is multi
1fb0: 74 68 72 65 61 64 65 64 20 2d 20 6d 75 6c 74 69 threaded - multi
1fc0: 70 6c 65 0a 2a 2a 20 74 68 72 65 61 64 73 20 63 ple.** threads c
1fd0: 61 6e 20 75 73 65 20 53 51 4c 69 74 65 20 61 73 an use SQLite as
1fe0: 20 6c 6f 6e 67 20 61 73 20 6e 6f 20 74 77 6f 20 long as no two
1ff0: 74 68 72 65 61 64 73 20 74 72 79 20 74 6f 20 75 threads try to u
2000: 73 65 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 64 se the same.** d
2010: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
2020: 6f 6e 20 61 74 20 74 68 65 20 73 61 6d 65 20 74 on at the same t
2030: 69 6d 65 2e 0a 2a 2a 0a 2a 2a 20 4f 6c 64 65 72 ime..**.** Older
2040: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c versions of SQL
2050: 69 74 65 20 75 73 65 64 20 61 6e 20 6f 70 74 69 ite used an opti
2060: 6f 6e 61 6c 20 54 48 52 45 41 44 53 41 46 45 20 onal THREADSAFE
2070: 6d 61 63 72 6f 2e 0a 2a 2a 20 57 65 20 73 75 70 macro..** We sup
2080: 70 6f 72 74 20 74 68 61 74 20 66 6f 72 20 6c 65 port that for le
2090: 67 61 63 79 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 gacy..*/.#if !de
20a0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 48 52 fined(SQLITE_THR
20b0: 45 41 44 53 41 46 45 29 0a 23 20 69 66 20 64 65 EADSAFE).# if de
20c0: 66 69 6e 65 64 28 54 48 52 45 41 44 53 41 46 45 fined(THREADSAFE
20d0: 29 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c ).# define SQL
20e0: 49 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 54 ITE_THREADSAFE T
20f0: 48 52 45 41 44 53 41 46 45 0a 23 20 65 6c 73 65 HREADSAFE.# else
2100: 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 .# define SQLI
2110: 54 45 5f 54 48 52 45 41 44 53 41 46 45 20 31 20 TE_THREADSAFE 1
2120: 2f 2a 20 49 4d 50 3a 20 52 2d 30 37 32 37 32 2d /* IMP: R-07272-
2130: 32 32 33 30 39 20 2a 2f 0a 23 20 65 6e 64 69 66 22309 */.# endif
2140: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 .#endif../*.** P
2150: 6f 77 65 72 73 61 66 65 20 6f 76 65 72 77 72 69 owersafe overwri
2160: 74 65 20 69 73 20 6f 6e 20 62 79 20 64 65 66 61 te is on by defa
2170: 75 6c 74 2e 20 20 42 75 74 20 63 61 6e 20 62 65 ult. But can be
2180: 20 74 75 72 6e 65 64 20 6f 66 66 20 75 73 69 6e turned off usin
2190: 67 0a 2a 2a 20 74 68 65 20 2d 44 53 51 4c 49 54 g.** the -DSQLIT
21a0: 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 E_POWERSAFE_OVER
21b0: 57 52 49 54 45 3d 30 20 63 6f 6d 6d 61 6e 64 2d WRITE=0 command-
21c0: 6c 69 6e 65 20 6f 70 74 69 6f 6e 2e 0a 2a 2f 0a line option..*/.
21d0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 50 #ifndef SQLITE_P
21e0: 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49 OWERSAFE_OVERWRI
21f0: 54 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 TE.# define SQLI
2200: 54 45 5f 50 4f 57 45 52 53 41 46 45 5f 4f 56 45 TE_POWERSAFE_OVE
2210: 52 57 52 49 54 45 20 31 0a 23 65 6e 64 69 66 0a RWRITE 1.#endif.
2220: 0a 2f 2a 0a 2a 2a 20 45 56 49 44 45 4e 43 45 2d ./*.** EVIDENCE-
2230: 4f 46 3a 20 52 2d 32 35 37 31 35 2d 33 37 30 37 OF: R-25715-3707
2240: 32 20 4d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 2 Memory allocat
2250: 69 6f 6e 20 73 74 61 74 69 73 74 69 63 73 20 61 ion statistics a
2260: 72 65 20 65 6e 61 62 6c 65 64 20 62 79 0a 2a 2a re enabled by.**
2270: 20 64 65 66 61 75 6c 74 20 75 6e 6c 65 73 73 20 default unless
2280: 53 51 4c 69 74 65 20 69 73 20 63 6f 6d 70 69 6c SQLite is compil
2290: 65 64 20 77 69 74 68 20 53 51 4c 49 54 45 5f 44 ed with SQLITE_D
22a0: 45 46 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 EFAULT_MEMSTATUS
22b0: 3d 30 20 69 6e 0a 2a 2a 20 77 68 69 63 68 20 63 =0 in.** which c
22c0: 61 73 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 ase memory alloc
22d0: 61 74 69 6f 6e 20 73 74 61 74 69 73 74 69 63 73 ation statistics
22e0: 20 61 72 65 20 64 69 73 61 62 6c 65 64 20 62 79 are disabled by
22f0: 20 64 65 66 61 75 6c 74 2e 0a 2a 2f 0a 23 69 66 default..*/.#if
2300: 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 !defined(SQLITE
2310: 5f 44 45 46 41 55 4c 54 5f 4d 45 4d 53 54 41 54 _DEFAULT_MEMSTAT
2320: 55 53 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c US).# define SQL
2330: 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 45 4d 53 ITE_DEFAULT_MEMS
2340: 54 41 54 55 53 20 31 0a 23 65 6e 64 69 66 0a 0a TATUS 1.#endif..
2350: 2f 2a 0a 2a 2a 20 45 78 61 63 74 6c 79 20 6f 6e /*.** Exactly on
2360: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
2370: 6e 67 20 6d 61 63 72 6f 73 20 6d 75 73 74 20 62 ng macros must b
2380: 65 20 64 65 66 69 6e 65 64 20 69 6e 20 6f 72 64 e defined in ord
2390: 65 72 20 74 6f 0a 2a 2a 20 73 70 65 63 69 66 79 er to.** specify
23a0: 20 77 68 69 63 68 20 6d 65 6d 6f 72 79 20 61 6c which memory al
23b0: 6c 6f 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74 location subsyst
23c0: 65 6d 20 74 6f 20 75 73 65 2e 0a 2a 2a 0a 2a 2a em to use..**.**
23d0: 20 20 20 20 20 53 51 4c 49 54 45 5f 53 59 53 54 SQLITE_SYST
23e0: 45 4d 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 20 20 EM_MALLOC
23f0: 20 20 20 2f 2f 20 55 73 65 20 6e 6f 72 6d 61 6c // Use normal
2400: 20 73 79 73 74 65 6d 20 6d 61 6c 6c 6f 63 28 29 system malloc()
2410: 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 57 .** SQLITE_W
2420: 49 4e 33 32 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 IN32_MALLOC
2430: 20 20 20 20 20 20 2f 2f 20 55 73 65 20 57 69 6e // Use Win
2440: 33 32 20 6e 61 74 69 76 65 20 68 65 61 70 20 41 32 native heap A
2450: 50 49 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 PI.** SQLITE
2460: 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 20 20 20 20 _ZERO_MALLOC
2470: 20 20 20 20 20 20 20 20 2f 2f 20 55 73 65 20 61 // Use a
2480: 20 73 74 75 62 20 61 6c 6c 6f 63 61 74 6f 72 20 stub allocator
2490: 74 68 61 74 20 61 6c 77 61 79 73 20 66 61 69 6c that always fail
24a0: 73 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f s.** SQLITE_
24b0: 4d 45 4d 44 45 42 55 47 20 20 20 20 20 20 20 20 MEMDEBUG
24c0: 20 20 20 20 20 20 20 2f 2f 20 44 65 62 75 67 67 // Debugg
24d0: 69 6e 67 20 76 65 72 73 69 6f 6e 20 6f 66 20 73 ing version of s
24e0: 79 73 74 65 6d 20 6d 61 6c 6c 6f 63 28 29 0a 2a ystem malloc().*
24f0: 2a 0a 2a 2a 20 4f 6e 20 57 69 6e 64 6f 77 73 2c *.** On Windows,
2500: 20 69 66 20 74 68 65 20 53 51 4c 49 54 45 5f 57 if the SQLITE_W
2510: 49 4e 33 32 5f 4d 41 4c 4c 4f 43 5f 56 41 4c 49 IN32_MALLOC_VALI
2520: 44 41 54 45 20 6d 61 63 72 6f 20 69 73 20 64 65 DATE macro is de
2530: 66 69 6e 65 64 20 61 6e 64 20 74 68 65 0a 2a 2a fined and the.**
2540: 20 61 73 73 65 72 74 28 29 20 6d 61 63 72 6f 20 assert() macro
2550: 69 73 20 65 6e 61 62 6c 65 64 2c 20 65 61 63 68 is enabled, each
2560: 20 63 61 6c 6c 20 69 6e 74 6f 20 74 68 65 20 57 call into the W
2570: 69 6e 33 32 20 6e 61 74 69 76 65 20 68 65 61 70 in32 native heap
2580: 20 73 75 62 73 79 73 74 65 6d 0a 2a 2a 20 77 69 subsystem.** wi
2590: 6c 6c 20 63 61 75 73 65 20 48 65 61 70 56 61 6c ll cause HeapVal
25a0: 69 64 61 74 65 20 74 6f 20 62 65 20 63 61 6c 6c idate to be call
25b0: 65 64 2e 20 20 49 66 20 68 65 61 70 20 76 61 6c ed. If heap val
25c0: 69 64 61 74 69 6f 6e 20 73 68 6f 75 6c 64 20 66 idation should f
25d0: 61 69 6c 2c 20 61 6e 0a 2a 2a 20 61 73 73 65 72 ail, an.** asser
25e0: 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 74 72 69 tion will be tri
25f0: 67 67 65 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 ggered..**.** If
2600: 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 61 62 6f none of the abo
2610: 76 65 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 ve are defined,
2620: 74 68 65 6e 20 73 65 74 20 53 51 4c 49 54 45 5f then set SQLITE_
2630: 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 20 61 73 SYSTEM_MALLOC as
2640: 0a 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74 2e .** the default.
2650: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
2660: 53 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 SQLITE_SYSTEM_MA
2670: 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 LLOC) \. + defi
2680: 6e 65 64 28 53 51 4c 49 54 45 5f 57 49 4e 33 32 ned(SQLITE_WIN32
2690: 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 _MALLOC) \. + d
26a0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 5a 45 efined(SQLITE_ZE
26b0: 52 4f 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b RO_MALLOC) \. +
26c0: 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f defined(SQLITE_
26d0: 4d 45 4d 44 45 42 55 47 29 3e 31 0a 23 20 65 72 MEMDEBUG)>1.# er
26e0: 72 6f 72 20 22 54 77 6f 20 6f 72 20 6d 6f 72 65 ror "Two or more
26f0: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
2700: 67 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 63 g compile-time c
2710: 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 onfiguration opt
2720: 69 6f 6e 73 5c 0a 20 61 72 65 20 64 65 66 69 6e ions\. are defin
2730: 65 64 20 62 75 74 20 61 74 20 6d 6f 73 74 20 6f ed but at most o
2740: 6e 65 20 69 73 20 61 6c 6c 6f 77 65 64 3a 5c 0a ne is allowed:\.
2750: 20 53 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d SQLITE_SYSTEM_M
2760: 41 4c 4c 4f 43 2c 20 53 51 4c 49 54 45 5f 57 49 ALLOC, SQLITE_WI
2770: 4e 33 32 5f 4d 41 4c 4c 4f 43 2c 20 53 51 4c 49 N32_MALLOC, SQLI
2780: 54 45 5f 4d 45 4d 44 45 42 55 47 2c 5c 0a 20 53 TE_MEMDEBUG,\. S
2790: 51 4c 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f QLITE_ZERO_MALLO
27a0: 43 22 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 C".#endif.#if de
27b0: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 53 59 53 fined(SQLITE_SYS
27c0: 54 45 4d 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 TEM_MALLOC) \.
27d0: 2b 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 + defined(SQLITE
27e0: 5f 57 49 4e 33 32 5f 4d 41 4c 4c 4f 43 29 20 5c _WIN32_MALLOC) \
27f0: 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c . + defined(SQL
2800: 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 29 ITE_ZERO_MALLOC)
2810: 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 \. + defined(S
2820: 51 4c 49 54 45 5f 4d 45 4d 44 45 42 55 47 29 3d QLITE_MEMDEBUG)=
2830: 3d 30 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 =0.# define SQLI
2840: 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 TE_SYSTEM_MALLOC
2850: 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 1.#endif../*.**
2860: 20 49 66 20 53 51 4c 49 54 45 5f 4d 41 4c 4c 4f If SQLITE_MALLO
2870: 43 5f 53 4f 46 54 5f 4c 49 4d 49 54 20 69 73 20 C_SOFT_LIMIT is
2880: 6e 6f 74 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 not zero, then t
2890: 72 79 20 74 6f 20 6b 65 65 70 20 74 68 65 0a 2a ry to keep the.*
28a0: 2a 20 73 69 7a 65 73 20 6f 66 20 6d 65 6d 6f 72 * sizes of memor
28b0: 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 62 65 y allocations be
28c0: 6c 6f 77 20 74 68 69 73 20 76 61 6c 75 65 20 77 low this value w
28d0: 68 65 72 65 20 70 6f 73 73 69 62 6c 65 2e 0a 2a here possible..*
28e0: 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 /.#if !defined(S
28f0: 51 4c 49 54 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 QLITE_MALLOC_SOF
2900: 54 5f 4c 49 4d 49 54 29 0a 23 20 64 65 66 69 6e T_LIMIT).# defin
2910: 65 20 53 51 4c 49 54 45 5f 4d 41 4c 4c 4f 43 5f e SQLITE_MALLOC_
2920: 53 4f 46 54 5f 4c 49 4d 49 54 20 31 30 32 34 0a SOFT_LIMIT 1024.
2930: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 65 #endif../*.** We
2940: 20 6e 65 65 64 20 74 6f 20 64 65 66 69 6e 65 20 need to define
2950: 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 45 20 61 73 _XOPEN_SOURCE as
2960: 20 66 6f 6c 6c 6f 77 73 20 69 6e 20 6f 72 64 65 follows in orde
2970: 72 20 74 6f 20 65 6e 61 62 6c 65 0a 2a 2a 20 72 r to enable.** r
2980: 65 63 75 72 73 69 76 65 20 6d 75 74 65 78 65 73 ecursive mutexes
2990: 20 6f 6e 20 6d 6f 73 74 20 55 6e 69 78 20 73 79 on most Unix sy
29a0: 73 74 65 6d 73 20 61 6e 64 20 66 63 68 6d 6f 64 stems and fchmod
29b0: 28 29 20 6f 6e 20 4f 70 65 6e 42 53 44 2e 0a 2a () on OpenBSD..*
29c0: 2a 20 42 75 74 20 5f 58 4f 50 45 4e 5f 53 4f 55 * But _XOPEN_SOU
29d0: 52 43 45 20 64 65 66 69 6e 65 20 63 61 75 73 65 RCE define cause
29e0: 73 20 70 72 6f 62 6c 65 6d 73 20 66 6f 72 20 4d s problems for M
29f0: 61 63 20 4f 53 20 58 2c 20 73 6f 20 6f 6d 69 74 ac OS X, so omit
2a00: 0a 2a 2a 20 69 74 2e 0a 2a 2f 0a 23 69 66 20 21 .** it..*/.#if !
2a10: 64 65 66 69 6e 65 64 28 5f 58 4f 50 45 4e 5f 53 defined(_XOPEN_S
2a20: 4f 55 52 43 45 29 20 26 26 20 21 64 65 66 69 6e OURCE) && !defin
2a30: 65 64 28 5f 5f 44 41 52 57 49 4e 5f 5f 29 20 26 ed(__DARWIN__) &
2a40: 26 20 21 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 & !defined(__APP
2a50: 4c 45 5f 5f 29 0a 23 20 20 64 65 66 69 6e 65 20 LE__).# define
2a60: 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 45 20 36 30 _XOPEN_SOURCE 60
2a70: 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 0.#endif../*.**
2a80: 4e 44 45 42 55 47 20 61 6e 64 20 53 51 4c 49 54 NDEBUG and SQLIT
2a90: 45 5f 44 45 42 55 47 20 61 72 65 20 6f 70 70 6f E_DEBUG are oppo
2aa0: 73 69 74 65 73 2e 20 20 49 74 20 73 68 6f 75 6c sites. It shoul
2ab0: 64 20 61 6c 77 61 79 73 20 62 65 20 74 72 75 65 d always be true
2ac0: 20 74 68 61 74 0a 2a 2a 20 64 65 66 69 6e 65 64 that.** defined
2ad0: 28 4e 44 45 42 55 47 29 3d 3d 21 64 65 66 69 6e (NDEBUG)==!defin
2ae0: 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 ed(SQLITE_DEBUG)
2af0: 2e 20 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f . If this is no
2b00: 74 20 63 75 72 72 65 6e 74 6c 79 20 74 72 75 65 t currently true
2b10: 2c 0a 2a 2a 20 6d 61 6b 65 20 69 74 20 74 72 75 ,.** make it tru
2b20: 65 20 62 79 20 64 65 66 69 6e 69 6e 67 20 6f 72 e by defining or
2b30: 20 75 6e 64 65 66 69 6e 69 6e 67 20 4e 44 45 42 undefining NDEB
2b40: 55 47 2e 0a 2a 2a 0a 2a 2a 20 53 65 74 74 69 6e UG..**.** Settin
2b50: 67 20 4e 44 45 42 55 47 20 6d 61 6b 65 73 20 74 g NDEBUG makes t
2b60: 68 65 20 63 6f 64 65 20 73 6d 61 6c 6c 65 72 20 he code smaller
2b70: 61 6e 64 20 66 61 73 74 65 72 20 62 79 20 64 69 and faster by di
2b80: 73 61 62 6c 69 6e 67 20 74 68 65 0a 2a 2a 20 61 sabling the.** a
2b90: 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e ssert() statemen
2ba0: 74 73 20 69 6e 20 74 68 65 20 63 6f 64 65 2e 20 ts in the code.
2bb0: 20 53 6f 20 77 65 20 77 61 6e 74 20 74 68 65 20 So we want the
2bc0: 64 65 66 61 75 6c 74 20 61 63 74 69 6f 6e 0a 2a default action.*
2bd0: 2a 20 74 6f 20 62 65 20 66 6f 72 20 4e 44 45 42 * to be for NDEB
2be0: 55 47 20 74 6f 20 62 65 20 73 65 74 20 61 6e 64 UG to be set and
2bf0: 20 4e 44 45 42 55 47 20 74 6f 20 62 65 20 75 6e NDEBUG to be un
2c00: 64 65 66 69 6e 65 64 20 6f 6e 6c 79 20 69 66 20 defined only if
2c10: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2a 2a 20 SQLITE_DEBUG.**
2c20: 69 73 20 73 65 74 2e 20 20 54 68 75 73 20 4e 44 is set. Thus ND
2c30: 45 42 55 47 20 62 65 63 6f 6d 65 73 20 61 6e 20 EBUG becomes an
2c40: 6f 70 74 2d 69 6e 20 72 61 74 68 65 72 20 74 68 opt-in rather th
2c50: 61 6e 20 61 6e 20 6f 70 74 2d 6f 75 74 0a 2a 2a an an opt-out.**
2c60: 20 66 65 61 74 75 72 65 2e 0a 2a 2f 0a 23 69 66 feature..*/.#if
2c70: 20 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 !defined(NDEBUG
2c80: 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 ) && !defined(SQ
2c90: 4c 49 54 45 5f 44 45 42 55 47 29 0a 23 20 64 65 LITE_DEBUG).# de
2ca0: 66 69 6e 65 20 4e 44 45 42 55 47 20 31 0a 23 65 fine NDEBUG 1.#e
2cb0: 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 ndif.#if defined
2cc0: 28 4e 44 45 42 55 47 29 20 26 26 20 64 65 66 69 (NDEBUG) && defi
2cd0: 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 ned(SQLITE_DEBUG
2ce0: 29 0a 23 20 75 6e 64 65 66 20 4e 44 45 42 55 47 ).# undef NDEBUG
2cf0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 .#endif../*.** E
2d00: 6e 61 62 6c 65 20 53 51 4c 49 54 45 5f 45 4e 41 nable SQLITE_ENA
2d10: 42 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d BLE_EXPLAIN_COMM
2d20: 45 4e 54 53 20 69 66 20 53 51 4c 49 54 45 5f 44 ENTS if SQLITE_D
2d30: 45 42 55 47 20 69 73 20 74 75 72 6e 65 64 20 6f EBUG is turned o
2d40: 6e 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e n..*/.#if !defin
2d50: 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
2d60: 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 _EXPLAIN_COMMENT
2d70: 53 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 S) && defined(SQ
2d80: 4c 49 54 45 5f 44 45 42 55 47 29 0a 23 20 64 65 LITE_DEBUG).# de
2d90: 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 fine SQLITE_ENAB
2da0: 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 LE_EXPLAIN_COMME
2db0: 4e 54 53 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a NTS 1.#endif../*
2dc0: 0a 2a 2a 20 54 68 65 20 74 65 73 74 63 61 73 65 .** The testcase
2dd0: 28 29 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 () macro is used
2de0: 20 74 6f 20 61 69 64 20 69 6e 20 63 6f 76 65 72 to aid in cover
2df0: 61 67 65 20 74 65 73 74 69 6e 67 2e 20 20 57 68 age testing. Wh
2e00: 65 6e 0a 2a 2a 20 64 6f 69 6e 67 20 63 6f 76 65 en.** doing cove
2e10: 72 61 67 65 20 74 65 73 74 69 6e 67 2c 20 74 68 rage testing, th
2e20: 65 20 63 6f 6e 64 69 74 69 6f 6e 20 69 6e 73 69 e condition insi
2e30: 64 65 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 de the argument
2e40: 74 6f 0a 2a 2a 20 74 65 73 74 63 61 73 65 28 29 to.** testcase()
2e50: 20 6d 75 73 74 20 62 65 20 65 76 61 6c 75 61 74 must be evaluat
2e60: 65 64 20 62 6f 74 68 20 74 72 75 65 20 61 6e 64 ed both true and
2e70: 20 66 61 6c 73 65 20 69 6e 20 6f 72 64 65 72 20 false in order
2e80: 74 6f 0a 2a 2a 20 67 65 74 20 66 75 6c 6c 20 62 to.** get full b
2e90: 72 61 6e 63 68 20 63 6f 76 65 72 61 67 65 2e 20 ranch coverage.
2ea0: 20 54 68 65 20 74 65 73 74 63 61 73 65 28 29 20 The testcase()
2eb0: 6d 61 63 72 6f 20 69 73 20 69 6e 73 65 72 74 65 macro is inserte
2ec0: 64 0a 2a 2a 20 74 6f 20 68 65 6c 70 20 65 6e 73 d.** to help ens
2ed0: 75 72 65 20 61 64 65 71 75 61 74 65 20 74 65 73 ure adequate tes
2ee0: 74 20 63 6f 76 65 72 61 67 65 20 69 6e 20 70 6c t coverage in pl
2ef0: 61 63 65 73 20 77 68 65 72 65 20 73 69 6d 70 6c aces where simpl
2f00: 65 0a 2a 2a 20 63 6f 6e 64 69 74 69 6f 6e 2f 64 e.** condition/d
2f10: 65 63 69 73 69 6f 6e 20 63 6f 76 65 72 61 67 65 ecision coverage
2f20: 20 69 73 20 69 6e 61 64 65 71 75 61 74 65 2e 20 is inadequate.
2f30: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 65 For example, te
2f40: 73 74 63 61 73 65 28 29 0a 2a 2a 20 63 61 6e 20 stcase().** can
2f50: 62 65 20 75 73 65 64 20 74 6f 20 6d 61 6b 65 20 be used to make
2f60: 73 75 72 65 20 62 6f 75 6e 64 61 72 79 20 76 61 sure boundary va
2f70: 6c 75 65 73 20 61 72 65 20 74 65 73 74 65 64 2e lues are tested.
2f80: 20 20 46 6f 72 0a 2a 2a 20 62 69 74 6d 61 73 6b For.** bitmask
2f90: 20 74 65 73 74 73 2c 20 74 65 73 74 63 61 73 65 tests, testcase
2fa0: 28 29 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 () can be used t
2fb0: 6f 20 6d 61 6b 65 20 73 75 72 65 20 65 61 63 68 o make sure each
2fc0: 20 62 69 74 0a 2a 2a 20 69 73 20 73 69 67 6e 69 bit.** is signi
2fd0: 66 69 63 61 6e 74 20 61 6e 64 20 75 73 65 64 20 ficant and used
2fe0: 61 74 20 6c 65 61 73 74 20 6f 6e 63 65 2e 20 20 at least once.
2ff0: 4f 6e 20 73 77 69 74 63 68 20 73 74 61 74 65 6d On switch statem
3000: 65 6e 74 73 0a 2a 2a 20 77 68 65 72 65 20 6d 75 ents.** where mu
3010: 6c 74 69 70 6c 65 20 63 61 73 65 73 20 67 6f 20 ltiple cases go
3020: 74 6f 20 74 68 65 20 73 61 6d 65 20 62 6c 6f 63 to the same bloc
3030: 6b 20 6f 66 20 63 6f 64 65 2c 20 74 65 73 74 63 k of code, testc
3040: 61 73 65 28 29 0a 2a 2a 20 63 61 6e 20 69 6e 73 ase().** can ins
3050: 75 72 65 20 74 68 61 74 20 61 6c 6c 20 63 61 73 ure that all cas
3060: 65 73 20 61 72 65 20 65 76 61 6c 75 61 74 65 64 es are evaluated
3070: 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 64 65 66 20 53 ..**.*/.#ifdef S
3080: 51 4c 49 54 45 5f 43 4f 56 45 52 41 47 45 5f 54 QLITE_COVERAGE_T
3090: 45 53 54 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 EST. void sqlit
30a0: 65 33 43 6f 76 65 72 61 67 65 28 69 6e 74 29 3b e3Coverage(int);
30b0: 0a 23 20 64 65 66 69 6e 65 20 74 65 73 74 63 61 .# define testca
30c0: 73 65 28 58 29 20 20 69 66 28 20 58 20 29 7b 20 se(X) if( X ){
30d0: 73 71 6c 69 74 65 33 43 6f 76 65 72 61 67 65 28 sqlite3Coverage(
30e0: 5f 5f 4c 49 4e 45 5f 5f 29 3b 20 7d 0a 23 65 6c __LINE__); }.#el
30f0: 73 65 0a 23 20 64 65 66 69 6e 65 20 74 65 73 74 se.# define test
3100: 63 61 73 65 28 58 29 0a 23 65 6e 64 69 66 0a 0a case(X).#endif..
3110: 2f 2a 0a 2a 2a 20 54 68 65 20 54 45 53 54 4f 4e /*.** The TESTON
3120: 4c 59 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 LY macro is used
3130: 20 74 6f 20 65 6e 63 6c 6f 73 65 20 76 61 72 69 to enclose vari
3140: 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f 6e able declaration
3150: 73 20 6f 72 0a 2a 2a 20 6f 74 68 65 72 20 62 69 s or.** other bi
3160: 74 73 20 6f 66 20 63 6f 64 65 20 74 68 61 74 20 ts of code that
3170: 61 72 65 20 6e 65 65 64 65 64 20 74 6f 20 73 75 are needed to su
3180: 70 70 6f 72 74 20 74 68 65 20 61 72 67 75 6d 65 pport the argume
3190: 6e 74 73 0a 2a 2a 20 77 69 74 68 69 6e 20 74 65 nts.** within te
31a0: 73 74 63 61 73 65 28 29 20 61 6e 64 20 61 73 73 stcase() and ass
31b0: 65 72 74 28 29 20 6d 61 63 72 6f 73 2e 0a 2a 2f ert() macros..*/
31c0: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 4e 44 .#if !defined(ND
31d0: 45 42 55 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 EBUG) || defined
31e0: 28 53 51 4c 49 54 45 5f 43 4f 56 45 52 41 47 45 (SQLITE_COVERAGE
31f0: 5f 54 45 53 54 29 0a 23 20 64 65 66 69 6e 65 20 _TEST).# define
3200: 54 45 53 54 4f 4e 4c 59 28 58 29 20 20 58 0a 23 TESTONLY(X) X.#
3210: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 54 45 else.# define TE
3220: 53 54 4f 4e 4c 59 28 58 29 0a 23 65 6e 64 69 66 STONLY(X).#endif
3230: 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 ../*.** Sometime
3240: 73 20 77 65 20 6e 65 65 64 20 61 20 73 6d 61 6c s we need a smal
3250: 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 63 6f 64 65 l amount of code
3260: 20 73 75 63 68 20 61 73 20 61 20 76 61 72 69 61 such as a varia
3270: 62 6c 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 ble initializati
3280: 6f 6e 0a 2a 2a 20 74 6f 20 73 65 74 75 70 20 66 on.** to setup f
3290: 6f 72 20 61 20 6c 61 74 65 72 20 61 73 73 65 72 or a later asser
32a0: 74 28 29 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 t() statement.
32b0: 57 65 20 64 6f 20 6e 6f 74 20 77 61 6e 74 20 74 We do not want t
32c0: 68 69 73 20 63 6f 64 65 20 74 6f 0a 2a 2a 20 61 his code to.** a
32d0: 70 70 65 61 72 20 77 68 65 6e 20 61 73 73 65 72 ppear when asser
32e0: 74 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 2e t() is disabled.
32f0: 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 The following
3300: 6d 61 63 72 6f 20 69 73 20 74 68 65 72 65 66 6f macro is therefo
3310: 72 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 63 6f re.** used to co
3320: 6e 74 61 69 6e 20 74 68 61 74 20 73 65 74 75 70 ntain that setup
3330: 20 63 6f 64 65 2e 20 20 54 68 65 20 22 56 56 41 code. The "VVA
3340: 22 20 61 63 72 6f 6e 79 6d 20 73 74 61 6e 64 73 " acronym stands
3350: 20 66 6f 72 0a 2a 2a 20 22 56 65 72 69 66 69 63 for.** "Verific
3360: 61 74 69 6f 6e 2c 20 56 61 6c 69 64 61 74 69 6f ation, Validatio
3370: 6e 2c 20 61 6e 64 20 41 63 63 72 65 64 69 74 61 n, and Accredita
3380: 74 69 6f 6e 22 2e 20 20 49 6e 20 6f 74 68 65 72 tion". In other
3390: 20 77 6f 72 64 73 2c 20 74 68 65 0a 2a 2a 20 63 words, the.** c
33a0: 6f 64 65 20 77 69 74 68 69 6e 20 56 56 41 5f 4f ode within VVA_O
33b0: 4e 4c 59 28 29 20 77 69 6c 6c 20 6f 6e 6c 79 20 NLY() will only
33c0: 72 75 6e 20 64 75 72 69 6e 67 20 76 65 72 69 66 run during verif
33d0: 69 63 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 65 ication processe
33e0: 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 s..*/.#ifndef ND
33f0: 45 42 55 47 0a 23 20 64 65 66 69 6e 65 20 56 56 EBUG.# define VV
3400: 41 5f 4f 4e 4c 59 28 58 29 20 20 58 0a 23 65 6c A_ONLY(X) X.#el
3410: 73 65 0a 23 20 64 65 66 69 6e 65 20 56 56 41 5f se.# define VVA_
3420: 4f 4e 4c 59 28 58 29 0a 23 65 6e 64 69 66 0a 0a ONLY(X).#endif..
3430: 2f 2a 0a 2a 2a 20 54 68 65 20 41 4c 57 41 59 53 /*.** The ALWAYS
3440: 20 61 6e 64 20 4e 45 56 45 52 20 6d 61 63 72 6f and NEVER macro
3450: 73 20 73 75 72 72 6f 75 6e 64 20 62 6f 6f 6c 65 s surround boole
3460: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 73 20 77 an expressions w
3470: 68 69 63 68 0a 2a 2a 20 61 72 65 20 69 6e 74 65 hich.** are inte
3480: 6e 64 65 64 20 74 6f 20 61 6c 77 61 79 73 20 62 nded to always b
3490: 65 20 74 72 75 65 20 6f 72 20 66 61 6c 73 65 2c e true or false,
34a0: 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e 20 20 respectively.
34b0: 53 75 63 68 0a 2a 2a 20 65 78 70 72 65 73 73 69 Such.** expressi
34c0: 6f 6e 73 20 63 6f 75 6c 64 20 62 65 20 6f 6d 69 ons could be omi
34d0: 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 63 6f tted from the co
34e0: 64 65 20 63 6f 6d 70 6c 65 74 65 6c 79 2e 20 20 de completely.
34f0: 42 75 74 20 74 68 65 79 0a 2a 2a 20 61 72 65 20 But they.** are
3500: 69 6e 63 6c 75 64 65 64 20 69 6e 20 61 20 66 65 included in a fe
3510: 77 20 63 61 73 65 73 20 69 6e 20 6f 72 64 65 72 w cases in order
3520: 20 74 6f 20 65 6e 68 61 6e 63 65 20 74 68 65 20 to enhance the
3530: 72 65 73 69 6c 69 65 6e 63 65 0a 2a 2a 20 6f 66 resilience.** of
3540: 20 53 51 4c 69 74 65 20 74 6f 20 75 6e 65 78 70 SQLite to unexp
3550: 65 63 74 65 64 20 62 65 68 61 76 69 6f 72 20 2d ected behavior -
3560: 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 63 6f 64 to make the cod
3570: 65 20 22 73 65 6c 66 2d 68 65 61 6c 69 6e 67 22 e "self-healing"
3580: 0a 2a 2a 20 6f 72 20 22 64 75 63 74 69 6c 65 22 .** or "ductile"
3590: 20 72 61 74 68 65 72 20 74 68 61 6e 20 62 65 69 rather than bei
35a0: 6e 67 20 22 62 72 69 74 74 6c 65 22 20 61 6e 64 ng "brittle" and
35b0: 20 63 72 61 73 68 69 6e 67 20 61 74 20 74 68 65 crashing at the
35c0: 20 66 69 72 73 74 0a 2a 2a 20 68 69 6e 74 20 6f first.** hint o
35d0: 66 20 75 6e 70 6c 61 6e 6e 65 64 20 62 65 68 61 f unplanned beha
35e0: 76 69 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 6f vior..**.** In o
35f0: 74 68 65 72 20 77 6f 72 64 73 2c 20 41 4c 57 41 ther words, ALWA
3600: 59 53 20 61 6e 64 20 4e 45 56 45 52 20 61 72 65 YS and NEVER are
3610: 20 61 64 64 65 64 20 66 6f 72 20 64 65 66 65 6e added for defen
3620: 73 69 76 65 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a sive code..**.**
3630: 20 57 68 65 6e 20 64 6f 69 6e 67 20 63 6f 76 65 When doing cove
3640: 72 61 67 65 20 74 65 73 74 69 6e 67 20 41 4c 57 rage testing ALW
3650: 41 59 53 20 61 6e 64 20 4e 45 56 45 52 20 61 72 AYS and NEVER ar
3660: 65 20 68 61 72 64 2d 63 6f 64 65 64 20 74 6f 0a e hard-coded to.
3670: 2a 2a 20 62 65 20 74 72 75 65 20 61 6e 64 20 66 ** be true and f
3680: 61 6c 73 65 20 73 6f 20 74 68 61 74 20 74 68 65 alse so that the
3690: 20 75 6e 72 65 61 63 68 61 62 6c 65 20 63 6f 64 unreachable cod
36a0: 65 20 74 68 65 79 20 73 70 65 63 69 66 79 20 77 e they specify w
36b0: 69 6c 6c 0a 2a 2a 20 6e 6f 74 20 62 65 20 63 6f ill.** not be co
36c0: 75 6e 74 65 64 20 61 73 20 75 6e 74 65 73 74 65 unted as unteste
36d0: 64 20 63 6f 64 65 2e 0a 2a 2f 0a 23 69 66 20 64 d code..*/.#if d
36e0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 43 4f efined(SQLITE_CO
36f0: 56 45 52 41 47 45 5f 54 45 53 54 29 0a 23 20 64 VERAGE_TEST).# d
3700: 65 66 69 6e 65 20 41 4c 57 41 59 53 28 58 29 20 efine ALWAYS(X)
3710: 20 20 20 20 20 28 31 29 0a 23 20 64 65 66 69 6e (1).# defin
3720: 65 20 4e 45 56 45 52 28 58 29 20 20 20 20 20 20 e NEVER(X)
3730: 20 28 30 29 0a 23 65 6c 69 66 20 21 64 65 66 69 (0).#elif !defi
3740: 6e 65 64 28 4e 44 45 42 55 47 29 0a 23 20 64 65 ned(NDEBUG).# de
3750: 66 69 6e 65 20 41 4c 57 41 59 53 28 58 29 20 20 fine ALWAYS(X)
3760: 20 20 20 20 28 28 58 29 3f 31 3a 28 61 73 73 65 ((X)?1:(asse
3770: 72 74 28 30 29 2c 30 29 29 0a 23 20 64 65 66 69 rt(0),0)).# defi
3780: 6e 65 20 4e 45 56 45 52 28 58 29 20 20 20 20 20 ne NEVER(X)
3790: 20 20 28 28 58 29 3f 28 61 73 73 65 72 74 28 30 ((X)?(assert(0
37a0: 29 2c 31 29 3a 30 29 0a 23 65 6c 73 65 0a 23 20 ),1):0).#else.#
37b0: 64 65 66 69 6e 65 20 41 4c 57 41 59 53 28 58 29 define ALWAYS(X)
37c0: 20 20 20 20 20 20 28 58 29 0a 23 20 64 65 66 69 (X).# defi
37d0: 6e 65 20 4e 45 56 45 52 28 58 29 20 20 20 20 20 ne NEVER(X)
37e0: 20 20 28 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a (X).#endif../*
37f0: 0a 2a 2a 20 53 6f 6d 65 20 6d 61 6c 6c 6f 63 20 .** Some malloc
3800: 66 61 69 6c 75 72 65 73 20 61 72 65 20 6f 6e 6c failures are onl
3810: 79 20 70 6f 73 73 69 62 6c 65 20 69 66 20 53 51 y possible if SQ
3820: 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 4c 4c 4f LITE_TEST_REALLO
3830: 43 5f 53 54 52 45 53 53 20 69 73 0a 2a 2a 20 64 C_STRESS is.** d
3840: 65 66 69 6e 65 64 2e 20 20 57 65 20 6e 65 65 64 efined. We need
3850: 20 74 6f 20 64 65 66 65 6e 64 20 61 67 61 69 6e to defend again
3860: 73 74 20 74 68 6f 73 65 20 66 61 69 6c 75 72 65 st those failure
3870: 73 20 77 68 65 6e 20 74 65 73 74 69 6e 67 20 77 s when testing w
3880: 69 74 68 0a 2a 2a 20 53 51 4c 49 54 45 5f 54 45 ith.** SQLITE_TE
3890: 53 54 5f 52 45 41 4c 4c 4f 43 5f 53 54 52 45 53 ST_REALLOC_STRES
38a0: 53 2c 20 62 75 74 20 77 65 20 64 6f 6e 27 74 20 S, but we don't
38b0: 77 61 6e 74 20 74 68 65 20 75 6e 72 65 61 63 68 want the unreach
38c0: 61 62 6c 65 20 62 72 61 6e 63 68 65 73 0a 2a 2a able branches.**
38d0: 20 64 75 72 69 6e 67 20 61 20 6e 6f 72 6d 61 6c during a normal
38e0: 20 62 75 69 6c 64 2e 20 20 54 68 65 20 66 6f 6c build. The fol
38f0: 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 20 63 61 6e lowing macro can
3900: 20 62 65 20 75 73 65 64 20 74 6f 20 64 69 73 61 be used to disa
3910: 62 6c 65 20 74 65 73 74 73 0a 2a 2a 20 74 68 61 ble tests.** tha
3920: 74 20 61 72 65 20 61 6c 77 61 79 73 20 66 61 6c t are always fal
3930: 73 65 20 65 78 63 65 70 74 20 77 68 65 6e 20 53 se except when S
3940: 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 4c 4c QLITE_TEST_REALL
3950: 4f 43 5f 53 54 52 45 53 53 20 69 73 20 73 65 74 OC_STRESS is set
3960: 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 ..*/.#if defined
3970: 28 53 51 4c 49 54 45 5f 54 45 53 54 5f 52 45 41 (SQLITE_TEST_REA
3980: 4c 4c 4f 43 5f 53 54 52 45 53 53 29 0a 23 20 64 LLOC_STRESS).# d
3990: 65 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 efine ONLY_IF_RE
39a0: 41 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 ALLOC_STRESS(X)
39b0: 20 28 58 29 0a 23 65 6c 69 66 20 21 64 65 66 69 (X).#elif !defi
39c0: 6e 65 64 28 4e 44 45 42 55 47 29 0a 23 20 64 65 ned(NDEBUG).# de
39d0: 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 41 fine ONLY_IF_REA
39e0: 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 20 LLOC_STRESS(X)
39f0: 28 28 58 29 3f 28 61 73 73 65 72 74 28 30 29 2c ((X)?(assert(0),
3a00: 31 29 3a 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 1):0).#else.# de
3a10: 66 69 6e 65 20 4f 4e 4c 59 5f 49 46 5f 52 45 41 fine ONLY_IF_REA
3a20: 4c 4c 4f 43 5f 53 54 52 45 53 53 28 58 29 20 20 LLOC_STRESS(X)
3a30: 28 30 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a (0).#endif../*.*
3a40: 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e 73 20 75 * Declarations u
3a50: 73 65 64 20 66 6f 72 20 74 72 61 63 69 6e 67 20 sed for tracing
3a60: 74 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 the operating sy
3a70: 73 74 65 6d 20 69 6e 74 65 72 66 61 63 65 73 2e stem interfaces.
3a80: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
3a90: 53 51 4c 49 54 45 5f 46 4f 52 43 45 5f 4f 53 5f SQLITE_FORCE_OS_
3aa0: 54 52 41 43 45 29 20 7c 7c 20 64 65 66 69 6e 65 TRACE) || define
3ab0: 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c d(SQLITE_TEST) |
3ac0: 7c 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 | \. (defined
3ad0: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 (SQLITE_DEBUG) &
3ae0: 26 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 & SQLITE_OS_WIN)
3af0: 0a 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 . extern int sq
3b00: 6c 69 74 65 33 4f 53 54 72 61 63 65 3b 0a 23 20 lite3OSTrace;.#
3b10: 64 65 66 69 6e 65 20 4f 53 54 52 41 43 45 28 58 define OSTRACE(X
3b20: 29 20 20 20 20 20 20 20 20 20 20 69 66 28 20 73 ) if( s
3b30: 71 6c 69 74 65 33 4f 53 54 72 61 63 65 20 29 20 qlite3OSTrace )
3b40: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
3b50: 74 66 20 58 0a 23 20 64 65 66 69 6e 65 20 53 51 tf X.# define SQ
3b60: 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 41 LITE_HAVE_OS_TRA
3b70: 43 45 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e CE.#else.# defin
3b80: 65 20 4f 53 54 52 41 43 45 28 58 29 0a 23 20 75 e OSTRACE(X).# u
3b90: 6e 64 65 66 20 20 53 51 4c 49 54 45 5f 48 41 56 ndef SQLITE_HAV
3ba0: 45 5f 4f 53 5f 54 52 41 43 45 0a 23 65 6e 64 69 E_OS_TRACE.#endi
3bb0: 66 0a 0a 2f 2a 0a 2a 2a 20 49 73 20 74 68 65 20 f../*.** Is the
3bc0: 73 71 6c 69 74 65 33 45 72 72 4e 61 6d 65 28 29 sqlite3ErrName()
3bd0: 20 66 75 6e 63 74 69 6f 6e 20 6e 65 65 64 65 64 function needed
3be0: 20 69 6e 20 74 68 65 20 62 75 69 6c 64 3f 20 20 in the build?
3bf0: 43 75 72 72 65 6e 74 6c 79 2c 0a 2a 2a 20 69 74 Currently,.** it
3c00: 20 69 73 20 6e 65 65 64 65 64 20 62 79 20 22 6d is needed by "m
3c10: 75 74 65 78 5f 77 33 32 2e 63 22 20 28 77 68 65 utex_w32.c" (whe
3c20: 6e 20 64 65 62 75 67 67 69 6e 67 29 2c 20 22 6f n debugging), "o
3c30: 73 5f 77 69 6e 2e 63 22 20 28 77 68 65 6e 0a 2a s_win.c" (when.*
3c40: 2a 20 4f 53 54 52 41 43 45 20 69 73 20 65 6e 61 * OSTRACE is ena
3c50: 62 6c 65 64 29 2c 20 61 6e 64 20 62 79 20 73 65 bled), and by se
3c60: 76 65 72 61 6c 20 22 74 65 73 74 2a 2e 63 22 20 veral "test*.c"
3c70: 66 69 6c 65 73 20 28 77 68 69 63 68 20 61 72 65 files (which are
3c80: 0a 2a 2a 20 63 6f 6d 70 69 6c 65 64 20 75 73 69 .** compiled usi
3c90: 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 54 29 2e ng SQLITE_TEST).
3ca0: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
3cb0: 53 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 SQLITE_HAVE_OS_T
3cc0: 52 41 43 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 RACE) || defined
3cd0: 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 7c 7c (SQLITE_TEST) ||
3ce0: 20 5c 0a 20 20 20 20 28 64 65 66 69 6e 65 64 28 \. (defined(
3cf0: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 26 26 SQLITE_DEBUG) &&
3d00: 20 53 51 4c 49 54 45 5f 4f 53 5f 57 49 4e 29 0a SQLITE_OS_WIN).
3d10: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
3d20: 4e 45 45 44 5f 45 52 52 5f 4e 41 4d 45 0a 23 65 NEED_ERR_NAME.#e
3d30: 6c 73 65 0a 23 20 75 6e 64 65 66 20 20 53 51 4c lse.# undef SQL
3d40: 49 54 45 5f 4e 45 45 44 5f 45 52 52 5f 4e 41 4d ITE_NEED_ERR_NAM
3d50: 45 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 E.#endif../*.**
3d60: 52 65 74 75 72 6e 20 74 72 75 65 20 28 6e 6f 6e Return true (non
3d70: 2d 7a 65 72 6f 29 20 69 66 20 74 68 65 20 69 6e -zero) if the in
3d80: 70 75 74 20 69 73 20 61 6e 20 69 6e 74 65 67 65 put is an intege
3d90: 72 20 74 68 61 74 20 69 73 20 74 6f 6f 20 6c 61 r that is too la
3da0: 72 67 65 0a 2a 2a 20 74 6f 20 66 69 74 20 69 6e rge.** to fit in
3db0: 20 33 32 2d 62 69 74 73 2e 20 20 54 68 69 73 20 32-bits. This
3dc0: 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 69 6e macro is used in
3dd0: 73 69 64 65 20 6f 66 20 76 61 72 69 6f 75 73 20 side of various
3de0: 74 65 73 74 63 61 73 65 28 29 0a 2a 2a 20 6d 61 testcase().** ma
3df0: 63 72 6f 73 20 74 6f 20 76 65 72 69 66 79 20 74 cros to verify t
3e00: 68 61 74 20 77 65 20 68 61 76 65 20 74 65 73 74 hat we have test
3e10: 65 64 20 53 51 4c 69 74 65 20 66 6f 72 20 6c 61 ed SQLite for la
3e20: 72 67 65 2d 66 69 6c 65 20 73 75 70 70 6f 72 74 rge-file support
3e30: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 53 5f ..*/.#define IS_
3e40: 42 49 47 5f 49 4e 54 28 58 29 20 20 28 28 28 58 BIG_INT(X) (((X
3e50: 29 26 7e 28 69 36 34 29 30 78 66 66 66 66 66 66 )&~(i64)0xffffff
3e60: 66 66 29 21 3d 30 29 0a 0a 2f 2a 0a 2a 2a 20 54 ff)!=0)../*.** T
3e70: 68 65 20 6d 61 63 72 6f 20 75 6e 6c 69 6b 65 6c he macro unlikel
3e80: 79 28 29 20 69 73 20 61 20 68 69 6e 74 20 74 68 y() is a hint th
3e90: 61 74 20 73 75 72 72 6f 75 6e 64 73 20 61 20 62 at surrounds a b
3ea0: 6f 6f 6c 65 61 6e 0a 2a 2a 20 65 78 70 72 65 73 oolean.** expres
3eb0: 73 69 6f 6e 20 74 68 61 74 20 69 73 20 75 73 75 sion that is usu
3ec0: 61 6c 6c 79 20 66 61 6c 73 65 2e 20 20 4d 61 63 ally false. Mac
3ed0: 72 6f 20 6c 69 6b 65 6c 79 28 29 20 73 75 72 72 ro likely() surr
3ee0: 6f 75 6e 64 73 0a 2a 2a 20 61 20 62 6f 6f 6c 65 ounds.** a boole
3ef0: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 74 68 an expression th
3f00: 61 74 20 69 73 20 75 73 75 61 6c 6c 79 20 74 72 at is usually tr
3f10: 75 65 2e 20 20 54 68 65 73 65 20 68 69 6e 74 73 ue. These hints
3f20: 20 63 6f 75 6c 64 2c 0a 2a 2a 20 69 6e 20 74 68 could,.** in th
3f30: 65 6f 72 79 2c 20 62 65 20 75 73 65 64 20 62 79 eory, be used by
3f40: 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 74 6f the compiler to
3f50: 20 67 65 6e 65 72 61 74 65 20 62 65 74 74 65 72 generate better
3f60: 20 63 6f 64 65 2c 20 62 75 74 0a 2a 2a 20 63 75 code, but.** cu
3f70: 72 72 65 6e 74 6c 79 20 74 68 65 79 20 61 72 65 rrently they are
3f80: 20 6a 75 73 74 20 63 6f 6d 6d 65 6e 74 73 20 66 just comments f
3f90: 6f 72 20 68 75 6d 61 6e 20 72 65 61 64 65 72 73 or human readers
3fa0: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 6c 69 6b ..*/.#define lik
3fb0: 65 6c 79 28 58 29 20 20 20 20 28 58 29 0a 23 64 ely(X) (X).#d
3fc0: 65 66 69 6e 65 20 75 6e 6c 69 6b 65 6c 79 28 58 efine unlikely(X
3fd0: 29 20 20 28 58 29 0a 0a 23 69 6e 63 6c 75 64 65 ) (X)..#include
3fe0: 20 22 68 61 73 68 2e 68 22 0a 23 69 6e 63 6c 75 "hash.h".#inclu
3ff0: 64 65 20 22 70 61 72 73 65 2e 68 22 0a 23 69 6e de "parse.h".#in
4000: 63 6c 75 64 65 20 3c 73 74 64 69 6f 2e 68 3e 0a clude <stdio.h>.
4010: 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69 62 #include <stdlib
4020: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 .h>.#include <st
4030: 72 69 6e 67 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 ring.h>.#include
4040: 20 3c 61 73 73 65 72 74 2e 68 3e 0a 23 69 6e 63 <assert.h>.#inc
4050: 6c 75 64 65 20 3c 73 74 64 64 65 66 2e 68 3e 0a lude <stddef.h>.
4060: 0a 2f 2a 0a 2a 2a 20 49 66 20 63 6f 6d 70 69 6c ./*.** If compil
4070: 69 6e 67 20 66 6f 72 20 61 20 70 72 6f 63 65 73 ing for a proces
4080: 73 6f 72 20 74 68 61 74 20 6c 61 63 6b 73 20 66 sor that lacks f
4090: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 73 75 loating point su
40a0: 70 70 6f 72 74 2c 0a 2a 2a 20 73 75 62 73 74 69 pport,.** substi
40b0: 74 75 74 65 20 69 6e 74 65 67 65 72 20 66 6f 72 tute integer for
40c0: 20 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 0a floating-point.
40d0: 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 */.#ifdef SQLITE
40e0: 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 _OMIT_FLOATING_P
40f0: 4f 49 4e 54 0a 23 20 64 65 66 69 6e 65 20 64 6f OINT.# define do
4100: 75 62 6c 65 20 73 71 6c 69 74 65 5f 69 6e 74 36 uble sqlite_int6
4110: 34 0a 23 20 64 65 66 69 6e 65 20 66 6c 6f 61 74 4.# define float
4120: 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 0a 23 20 sqlite_int64.#
4130: 64 65 66 69 6e 65 20 4c 4f 4e 47 44 4f 55 42 4c define LONGDOUBL
4140: 45 5f 54 59 50 45 20 73 71 6c 69 74 65 5f 69 6e E_TYPE sqlite_in
4150: 74 36 34 0a 23 20 69 66 6e 64 65 66 20 53 51 4c t64.# ifndef SQL
4160: 49 54 45 5f 42 49 47 5f 44 42 4c 0a 23 20 20 20 ITE_BIG_DBL.#
4170: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 define SQLITE_BI
4180: 47 5f 44 42 4c 20 28 28 28 73 71 6c 69 74 65 33 G_DBL (((sqlite3
4190: 5f 69 6e 74 36 34 29 31 29 3c 3c 35 30 29 0a 23 _int64)1)<<50).#
41a0: 20 65 6e 64 69 66 0a 23 20 64 65 66 69 6e 65 20 endif.# define
41b0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 41 54 45 SQLITE_OMIT_DATE
41c0: 54 49 4d 45 5f 46 55 4e 43 53 20 31 0a 23 20 64 TIME_FUNCS 1.# d
41d0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 4d 49 efine SQLITE_OMI
41e0: 54 5f 54 52 41 43 45 20 31 0a 23 20 75 6e 64 65 T_TRACE 1.# unde
41f0: 66 20 53 51 4c 49 54 45 5f 4d 49 58 45 44 5f 45 f SQLITE_MIXED_E
4200: 4e 44 49 41 4e 5f 36 34 42 49 54 5f 46 4c 4f 41 NDIAN_64BIT_FLOA
4210: 54 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 T.# undef SQLITE
4220: 5f 48 41 56 45 5f 49 53 4e 41 4e 0a 23 65 6e 64 _HAVE_ISNAN.#end
4230: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
4240: 45 5f 42 49 47 5f 44 42 4c 0a 23 20 64 65 66 69 E_BIG_DBL.# defi
4250: 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 ne SQLITE_BIG_DB
4260: 4c 20 28 31 65 39 39 29 0a 23 65 6e 64 69 66 0a L (1e99).#endif.
4270: 0a 2f 2a 0a 2a 2a 20 4f 4d 49 54 5f 54 45 4d 50 ./*.** OMIT_TEMP
4280: 44 42 20 69 73 20 73 65 74 20 74 6f 20 31 20 69 DB is set to 1 i
4290: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 f SQLITE_OMIT_TE
42a0: 4d 50 44 42 20 69 73 20 64 65 66 69 6e 65 64 2c MPDB is defined,
42b0: 20 6f 72 20 30 0a 2a 2a 20 61 66 74 65 72 77 61 or 0.** afterwa
42c0: 72 64 2e 20 48 61 76 69 6e 67 20 74 68 69 73 20 rd. Having this
42d0: 6d 61 63 72 6f 20 61 6c 6c 6f 77 73 20 75 73 20 macro allows us
42e0: 74 6f 20 63 61 75 73 65 20 74 68 65 20 43 20 63 to cause the C c
42f0: 6f 6d 70 69 6c 65 72 0a 2a 2a 20 74 6f 20 6f 6d ompiler.** to om
4300: 69 74 20 63 6f 64 65 20 75 73 65 64 20 62 79 20 it code used by
4310: 54 45 4d 50 20 74 61 62 6c 65 73 20 77 69 74 68 TEMP tables with
4320: 6f 75 74 20 6d 65 73 73 79 20 23 69 66 6e 64 65 out messy #ifnde
4330: 66 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2f f statements..*/
4340: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f .#ifdef SQLITE_O
4350: 4d 49 54 5f 54 45 4d 50 44 42 0a 23 64 65 66 69 MIT_TEMPDB.#defi
4360: 6e 65 20 4f 4d 49 54 5f 54 45 4d 50 44 42 20 31 ne OMIT_TEMPDB 1
4370: 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 4f .#else.#define O
4380: 4d 49 54 5f 54 45 4d 50 44 42 20 30 0a 23 65 6e MIT_TEMPDB 0.#en
4390: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 22 dif../*.** The "
43a0: 66 69 6c 65 20 66 6f 72 6d 61 74 22 20 6e 75 6d file format" num
43b0: 62 65 72 20 69 73 20 61 6e 20 69 6e 74 65 67 65 ber is an intege
43c0: 72 20 74 68 61 74 20 69 73 20 69 6e 63 72 65 6d r that is increm
43d0: 65 6e 74 65 64 20 77 68 65 6e 65 76 65 72 0a 2a ented whenever.*
43e0: 2a 20 74 68 65 20 56 44 42 45 2d 6c 65 76 65 6c * the VDBE-level
43f0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 63 68 61 file format cha
4400: 6e 67 65 73 2e 20 20 54 68 65 20 66 6f 6c 6c 6f nges. The follo
4410: 77 69 6e 67 20 6d 61 63 72 6f 73 20 64 65 66 69 wing macros defi
4420: 6e 65 20 74 68 65 0a 2a 2a 20 74 68 65 20 64 65 ne the.** the de
4430: 66 61 75 6c 74 20 66 69 6c 65 20 66 6f 72 6d 61 fault file forma
4440: 74 20 66 6f 72 20 6e 65 77 20 64 61 74 61 62 61 t for new databa
4450: 73 65 73 20 61 6e 64 20 74 68 65 20 6d 61 78 69 ses and the maxi
4460: 6d 75 6d 20 66 69 6c 65 20 66 6f 72 6d 61 74 0a mum file format.
4470: 2a 2a 20 74 68 61 74 20 74 68 65 20 6c 69 62 72 ** that the libr
4480: 61 72 79 20 63 61 6e 20 72 65 61 64 2e 0a 2a 2f ary can read..*/
4490: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
44a0: 4d 41 58 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 MAX_FILE_FORMAT
44b0: 34 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 4.#ifndef SQLITE
44c0: 5f 44 45 46 41 55 4c 54 5f 46 49 4c 45 5f 46 4f _DEFAULT_FILE_FO
44d0: 52 4d 41 54 0a 23 20 64 65 66 69 6e 65 20 53 51 RMAT.# define SQ
44e0: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 4c LITE_DEFAULT_FIL
44f0: 45 5f 46 4f 52 4d 41 54 20 34 0a 23 65 6e 64 69 E_FORMAT 4.#endi
4500: 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 f../*.** Determi
4510: 6e 65 20 77 68 65 74 68 65 72 20 74 72 69 67 67 ne whether trigg
4520: 65 72 73 20 61 72 65 20 72 65 63 75 72 73 69 76 ers are recursiv
4530: 65 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 54 e by default. T
4540: 68 69 73 20 63 61 6e 20 62 65 0a 2a 2a 20 63 68 his can be.** ch
4550: 61 6e 67 65 64 20 61 74 20 72 75 6e 2d 74 69 6d anged at run-tim
4560: 65 20 75 73 69 6e 67 20 61 20 70 72 61 67 6d 61 e using a pragma
4570: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c ..*/.#ifndef SQL
4580: 49 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 55 ITE_DEFAULT_RECU
4590: 52 53 49 56 45 5f 54 52 49 47 47 45 52 53 0a 23 RSIVE_TRIGGERS.#
45a0: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 define SQLITE_D
45b0: 45 46 41 55 4c 54 5f 52 45 43 55 52 53 49 56 45 EFAULT_RECURSIVE
45c0: 5f 54 52 49 47 47 45 52 53 20 30 0a 23 65 6e 64 _TRIGGERS 0.#end
45d0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 72 6f 76 69 64 if../*.** Provid
45e0: 65 20 61 20 64 65 66 61 75 6c 74 20 76 61 6c 75 e a default valu
45f0: 65 20 66 6f 72 20 53 51 4c 49 54 45 5f 54 45 4d e for SQLITE_TEM
4600: 50 5f 53 54 4f 52 45 20 69 6e 20 63 61 73 65 20 P_STORE in case
4610: 69 74 20 69 73 20 6e 6f 74 20 73 70 65 63 69 66 it is not specif
4620: 69 65 64 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 6f ied.** on the co
4630: 6d 6d 61 6e 64 2d 6c 69 6e 65 0a 2a 2f 0a 23 69 mmand-line.*/.#i
4640: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 54 45 4d fndef SQLITE_TEM
4650: 50 5f 53 54 4f 52 45 0a 23 20 64 65 66 69 6e 65 P_STORE.# define
4660: 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f SQLITE_TEMP_STO
4670: 52 45 20 31 0a 23 20 64 65 66 69 6e 65 20 53 51 RE 1.# define SQ
4680: 4c 49 54 45 5f 54 45 4d 50 5f 53 54 4f 52 45 5f LITE_TEMP_STORE_
4690: 78 63 20 31 20 20 2f 2a 20 45 78 63 6c 75 64 65 xc 1 /* Exclude
46a0: 20 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a 2f from ctime.c */
46b0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 .#endif../*.** I
46c0: 66 20 6e 6f 20 76 61 6c 75 65 20 68 61 73 20 62 f no value has b
46d0: 65 65 6e 20 70 72 6f 76 69 64 65 64 20 66 6f 72 een provided for
46e0: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b SQLITE_MAX_WORK
46f0: 45 52 5f 54 48 52 45 41 44 53 2c 20 6f 72 20 69 ER_THREADS, or i
4700: 66 0a 2a 2a 20 53 51 4c 49 54 45 5f 54 45 4d 50 f.** SQLITE_TEMP
4710: 5f 53 54 4f 52 45 20 69 73 20 73 65 74 20 74 6f _STORE is set to
4720: 20 33 20 28 6e 65 76 65 72 20 75 73 65 20 74 65 3 (never use te
4730: 6d 70 6f 72 61 72 79 20 66 69 6c 65 73 29 2c 20 mporary files),
4740: 73 65 74 20 69 74 0a 2a 2a 20 74 6f 20 7a 65 72 set it.** to zer
4750: 6f 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 o..*/.#if SQLITE
4760: 5f 54 45 4d 50 5f 53 54 4f 52 45 3d 3d 33 20 7c _TEMP_STORE==3 |
4770: 7c 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 | SQLITE_THREADS
4780: 41 46 45 3d 3d 30 0a 23 20 75 6e 64 65 66 20 53 AFE==0.# undef S
4790: 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 QLITE_MAX_WORKER
47a0: 5f 54 48 52 45 41 44 53 0a 23 20 64 65 66 69 6e _THREADS.# defin
47b0: 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 e SQLITE_MAX_WOR
47c0: 4b 45 52 5f 54 48 52 45 41 44 53 20 30 0a 23 65 KER_THREADS 0.#e
47d0: 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c ndif.#ifndef SQL
47e0: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
47f0: 48 52 45 41 44 53 0a 23 20 64 65 66 69 6e 65 20 HREADS.# define
4800: 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 SQLITE_MAX_WORKE
4810: 52 5f 54 48 52 45 41 44 53 20 38 0a 23 65 6e 64 R_THREADS 8.#end
4820: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
4830: 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 E_DEFAULT_WORKER
4840: 5f 54 48 52 45 41 44 53 0a 23 20 64 65 66 69 6e _THREADS.# defin
4850: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
4860: 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 53 20 _WORKER_THREADS
4870: 30 0a 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 0.#endif.#if SQL
4880: 49 54 45 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b ITE_DEFAULT_WORK
4890: 45 52 5f 54 48 52 45 41 44 53 3e 53 51 4c 49 54 ER_THREADS>SQLIT
48a0: 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 E_MAX_WORKER_THR
48b0: 45 41 44 53 0a 23 20 75 6e 64 65 66 20 53 51 4c EADS.# undef SQL
48c0: 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 52 5f 54 ITE_MAX_WORKER_T
48d0: 48 52 45 41 44 53 0a 23 20 64 65 66 69 6e 65 20 HREADS.# define
48e0: 53 51 4c 49 54 45 5f 4d 41 58 5f 57 4f 52 4b 45 SQLITE_MAX_WORKE
48f0: 52 5f 54 48 52 45 41 44 53 20 53 51 4c 49 54 45 R_THREADS SQLITE
4900: 5f 44 45 46 41 55 4c 54 5f 57 4f 52 4b 45 52 5f _DEFAULT_WORKER_
4910: 54 48 52 45 41 44 53 0a 23 65 6e 64 69 66 0a 0a THREADS.#endif..
4920: 2f 2a 0a 2a 2a 20 54 68 65 20 64 65 66 61 75 6c /*.** The defaul
4930: 74 20 69 6e 69 74 69 61 6c 20 61 6c 6c 6f 63 61 t initial alloca
4940: 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 70 61 67 tion for the pag
4950: 65 63 61 63 68 65 20 77 68 65 6e 20 75 73 69 6e ecache when usin
4960: 67 20 73 65 70 61 72 61 74 65 0a 2a 2a 20 70 61 g separate.** pa
4970: 67 65 63 61 63 68 65 73 20 66 6f 72 20 65 61 63 gecaches for eac
4980: 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 h database conne
4990: 63 74 69 6f 6e 2e 20 20 41 20 70 6f 73 69 74 69 ction. A positi
49a0: 76 65 20 6e 75 6d 62 65 72 20 69 73 20 74 68 65 ve number is the
49b0: 0a 2a 2a 20 6e 75 6d 62 65 72 20 6f 66 20 70 61 .** number of pa
49c0: 67 65 73 2e 20 20 41 20 6e 65 67 61 74 69 76 65 ges. A negative
49d0: 20 6e 75 6d 62 65 72 20 4e 20 74 72 61 6e 73 6c number N transl
49e0: 61 74 69 6f 6e 73 20 6d 65 61 6e 73 20 74 68 61 ations means tha
49f0: 74 20 61 20 62 75 66 66 65 72 0a 2a 2a 20 6f 66 t a buffer.** of
4a00: 20 2d 31 30 32 34 2a 4e 20 62 79 74 65 73 20 69 -1024*N bytes i
4a10: 73 20 61 6c 6c 6f 63 61 74 65 64 20 61 6e 64 20 s allocated and
4a20: 75 73 65 64 20 66 6f 72 20 61 73 20 6d 61 6e 79 used for as many
4a30: 20 70 61 67 65 73 20 61 73 20 69 74 20 77 69 6c pages as it wil
4a40: 6c 20 68 6f 6c 64 2e 0a 2a 2f 0a 23 69 66 6e 64 l hold..*/.#ifnd
4a50: 65 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ef SQLITE_DEFAUL
4a60: 54 5f 50 43 41 43 48 45 5f 49 4e 49 54 53 5a 0a T_PCACHE_INITSZ.
4a70: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
4a80: 44 45 46 41 55 4c 54 5f 50 43 41 43 48 45 5f 49 DEFAULT_PCACHE_I
4a90: 4e 49 54 53 5a 20 31 30 30 0a 23 65 6e 64 69 66 NITSZ 100.#endif
4aa0: 0a 0a 2f 2a 0a 2a 2a 20 47 43 43 20 64 6f 65 73 ../*.** GCC does
4ab0: 20 6e 6f 74 20 64 65 66 69 6e 65 20 74 68 65 20 not define the
4ac0: 6f 66 66 73 65 74 6f 66 28 29 20 6d 61 63 72 6f offsetof() macro
4ad0: 20 73 6f 20 77 65 27 6c 6c 20 68 61 76 65 20 74 so we'll have t
4ae0: 6f 20 64 6f 20 69 74 0a 2a 2a 20 6f 75 72 73 65 o do it.** ourse
4af0: 6c 76 65 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 lves..*/.#ifndef
4b00: 20 6f 66 66 73 65 74 6f 66 0a 23 64 65 66 69 6e offsetof.#defin
4b10: 65 20 6f 66 66 73 65 74 6f 66 28 53 54 52 55 43 e offsetof(STRUC
4b20: 54 55 52 45 2c 46 49 45 4c 44 29 20 28 28 69 6e TURE,FIELD) ((in
4b30: 74 29 28 28 63 68 61 72 2a 29 26 28 28 53 54 52 t)((char*)&((STR
4b40: 55 43 54 55 52 45 2a 29 30 29 2d 3e 46 49 45 4c UCTURE*)0)->FIEL
4b50: 44 29 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a D)).#endif../*.*
4b60: 2a 20 4d 61 63 72 6f 73 20 74 6f 20 63 6f 6d 70 * Macros to comp
4b70: 75 74 65 20 6d 69 6e 69 6d 75 6d 20 61 6e 64 20 ute minimum and
4b80: 6d 61 78 69 6d 75 6d 20 6f 66 20 74 77 6f 20 6e maximum of two n
4b90: 75 6d 62 65 72 73 2e 0a 2a 2f 0a 23 64 65 66 69 umbers..*/.#defi
4ba0: 6e 65 20 4d 49 4e 28 41 2c 42 29 20 28 28 41 29 ne MIN(A,B) ((A)
4bb0: 3c 28 42 29 3f 28 41 29 3a 28 42 29 29 0a 23 64 <(B)?(A):(B)).#d
4bc0: 65 66 69 6e 65 20 4d 41 58 28 41 2c 42 29 20 28 efine MAX(A,B) (
4bd0: 28 41 29 3e 28 42 29 3f 28 41 29 3a 28 42 29 29 (A)>(B)?(A):(B))
4be0: 0a 0a 2f 2a 0a 2a 2a 20 53 77 61 70 20 74 77 6f ../*.** Swap two
4bf0: 20 6f 62 6a 65 63 74 73 20 6f 66 20 74 79 70 65 objects of type
4c00: 20 54 59 50 45 2e 0a 2a 2f 0a 23 64 65 66 69 6e TYPE..*/.#defin
4c10: 65 20 53 57 41 50 28 54 59 50 45 2c 41 2c 42 29 e SWAP(TYPE,A,B)
4c20: 20 7b 54 59 50 45 20 74 3d 41 3b 20 41 3d 42 3b {TYPE t=A; A=B;
4c30: 20 42 3d 74 3b 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 B=t;}../*.** Ch
4c40: 65 63 6b 20 74 6f 20 73 65 65 20 69 66 20 74 68 eck to see if th
4c50: 69 73 20 6d 61 63 68 69 6e 65 20 75 73 65 73 20 is machine uses
4c60: 45 42 43 44 49 43 2e 20 20 28 59 65 73 2c 20 62 EBCDIC. (Yes, b
4c70: 65 6c 69 65 76 65 20 69 74 20 6f 72 0a 2a 2a 20 elieve it or.**
4c80: 6e 6f 74 2c 20 74 68 65 72 65 20 61 72 65 20 73 not, there are s
4c90: 74 69 6c 6c 20 6d 61 63 68 69 6e 65 73 20 6f 75 till machines ou
4ca0: 74 20 74 68 65 72 65 20 74 68 61 74 20 75 73 65 t there that use
4cb0: 20 45 42 43 44 49 43 2e 29 0a 2a 2f 0a 23 69 66 EBCDIC.).*/.#if
4cc0: 20 27 41 27 20 3d 3d 20 27 5c 33 30 31 27 0a 23 'A' == '\301'.#
4cd0: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 define SQLITE_E
4ce0: 42 43 44 49 43 20 31 0a 23 65 6c 73 65 0a 23 20 BCDIC 1.#else.#
4cf0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 53 define SQLITE_AS
4d00: 43 49 49 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a CII 1.#endif../*
4d10: 0a 2a 2a 20 49 6e 74 65 67 65 72 73 20 6f 66 20 .** Integers of
4d20: 6b 6e 6f 77 6e 20 73 69 7a 65 73 2e 20 20 54 68 known sizes. Th
4d30: 65 73 65 20 74 79 70 65 64 65 66 73 20 6d 69 67 ese typedefs mig
4d40: 68 74 20 63 68 61 6e 67 65 20 66 6f 72 20 61 72 ht change for ar
4d50: 63 68 69 74 65 63 74 75 72 65 73 0a 2a 2a 20 77 chitectures.** w
4d60: 68 65 72 65 20 74 68 65 20 73 69 7a 65 73 20 76 here the sizes v
4d70: 65 72 79 2e 20 20 50 72 65 70 72 6f 63 65 73 73 ery. Preprocess
4d80: 6f 72 20 6d 61 63 72 6f 73 20 61 72 65 20 61 76 or macros are av
4d90: 61 69 6c 61 62 6c 65 20 73 6f 20 74 68 61 74 20 ailable so that
4da0: 74 68 65 0a 2a 2a 20 74 79 70 65 73 20 63 61 6e the.** types can
4db0: 20 62 65 20 63 6f 6e 76 65 6e 69 65 6e 74 6c 79 be conveniently
4dc0: 20 72 65 64 65 66 69 6e 65 64 20 61 74 20 63 6f redefined at co
4dd0: 6d 70 69 6c 65 2d 74 79 70 65 2e 20 20 4c 69 6b mpile-type. Lik
4de0: 65 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 e this:.**.**
4df0: 20 20 20 20 20 20 63 63 20 27 2d 44 55 49 4e 54 cc '-DUINT
4e00: 50 54 52 5f 54 59 50 45 3d 6c 6f 6e 67 20 6c 6f PTR_TYPE=long lo
4e10: 6e 67 20 69 6e 74 27 20 2e 2e 2e 0a 2a 2f 0a 23 ng int' ....*/.#
4e20: 69 66 6e 64 65 66 20 55 49 4e 54 33 32 5f 54 59 ifndef UINT32_TY
4e30: 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 5f PE.# ifdef HAVE_
4e40: 55 49 4e 54 33 32 5f 54 0a 23 20 20 64 65 66 69 UINT32_T.# defi
4e50: 6e 65 20 55 49 4e 54 33 32 5f 54 59 50 45 20 75 ne UINT32_TYPE u
4e60: 69 6e 74 33 32 5f 74 0a 23 20 65 6c 73 65 0a 23 int32_t.# else.#
4e70: 20 20 64 65 66 69 6e 65 20 55 49 4e 54 33 32 5f define UINT32_
4e80: 54 59 50 45 20 75 6e 73 69 67 6e 65 64 20 69 6e TYPE unsigned in
4e90: 74 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 t.# endif.#endif
4ea0: 0a 23 69 66 6e 64 65 66 20 55 49 4e 54 31 36 5f .#ifndef UINT16_
4eb0: 54 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 TYPE.# ifdef HAV
4ec0: 45 5f 55 49 4e 54 31 36 5f 54 0a 23 20 20 64 65 E_UINT16_T.# de
4ed0: 66 69 6e 65 20 55 49 4e 54 31 36 5f 54 59 50 45 fine UINT16_TYPE
4ee0: 20 75 69 6e 74 31 36 5f 74 0a 23 20 65 6c 73 65 uint16_t.# else
4ef0: 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 31 .# define UINT1
4f00: 36 5f 54 59 50 45 20 75 6e 73 69 67 6e 65 64 20 6_TYPE unsigned
4f10: 73 68 6f 72 74 20 69 6e 74 0a 23 20 65 6e 64 69 short int.# endi
4f20: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
4f30: 20 49 4e 54 31 36 5f 54 59 50 45 0a 23 20 69 66 INT16_TYPE.# if
4f40: 64 65 66 20 48 41 56 45 5f 49 4e 54 31 36 5f 54 def HAVE_INT16_T
4f50: 0a 23 20 20 64 65 66 69 6e 65 20 49 4e 54 31 36 .# define INT16
4f60: 5f 54 59 50 45 20 69 6e 74 31 36 5f 74 0a 23 20 _TYPE int16_t.#
4f70: 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 49 else.# define I
4f80: 4e 54 31 36 5f 54 59 50 45 20 73 68 6f 72 74 20 NT16_TYPE short
4f90: 69 6e 74 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 int.# endif.#end
4fa0: 69 66 0a 23 69 66 6e 64 65 66 20 55 49 4e 54 38 if.#ifndef UINT8
4fb0: 5f 54 59 50 45 0a 23 20 69 66 64 65 66 20 48 41 _TYPE.# ifdef HA
4fc0: 56 45 5f 55 49 4e 54 38 5f 54 0a 23 20 20 64 65 VE_UINT8_T.# de
4fd0: 66 69 6e 65 20 55 49 4e 54 38 5f 54 59 50 45 20 fine UINT8_TYPE
4fe0: 75 69 6e 74 38 5f 74 0a 23 20 65 6c 73 65 0a 23 uint8_t.# else.#
4ff0: 20 20 64 65 66 69 6e 65 20 55 49 4e 54 38 5f 54 define UINT8_T
5000: 59 50 45 20 75 6e 73 69 67 6e 65 64 20 63 68 61 YPE unsigned cha
5010: 72 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 r.# endif.#endif
5020: 0a 23 69 66 6e 64 65 66 20 49 4e 54 38 5f 54 59 .#ifndef INT8_TY
5030: 50 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 5f PE.# ifdef HAVE_
5040: 49 4e 54 38 5f 54 0a 23 20 20 64 65 66 69 6e 65 INT8_T.# define
5050: 20 49 4e 54 38 5f 54 59 50 45 20 69 6e 74 38 5f INT8_TYPE int8_
5060: 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 t.# else.# defi
5070: 6e 65 20 49 4e 54 38 5f 54 59 50 45 20 73 69 67 ne INT8_TYPE sig
5080: 6e 65 64 20 63 68 61 72 0a 23 20 65 6e 64 69 66 ned char.# endif
5090: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
50a0: 4c 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 0a LONGDOUBLE_TYPE.
50b0: 23 20 64 65 66 69 6e 65 20 4c 4f 4e 47 44 4f 55 # define LONGDOU
50c0: 42 4c 45 5f 54 59 50 45 20 6c 6f 6e 67 20 64 6f BLE_TYPE long do
50d0: 75 62 6c 65 0a 23 65 6e 64 69 66 0a 74 79 70 65 uble.#endif.type
50e0: 64 65 66 20 73 71 6c 69 74 65 5f 69 6e 74 36 34 def sqlite_int64
50f0: 20 69 36 34 3b 20 20 20 20 20 20 20 20 20 20 2f i64; /
5100: 2a 20 38 2d 62 79 74 65 20 73 69 67 6e 65 64 20 * 8-byte signed
5110: 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 64 integer */.typed
5120: 65 66 20 73 71 6c 69 74 65 5f 75 69 6e 74 36 34 ef sqlite_uint64
5130: 20 75 36 34 3b 20 20 20 20 20 20 20 20 20 2f 2a u64; /*
5140: 20 38 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 64 8-byte unsigned
5150: 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 65 integer */.type
5160: 64 65 66 20 55 49 4e 54 33 32 5f 54 59 50 45 20 def UINT32_TYPE
5170: 75 33 32 3b 20 20 20 20 20 20 20 20 20 20 20 2f u32; /
5180: 2a 20 34 2d 62 79 74 65 20 75 6e 73 69 67 6e 65 * 4-byte unsigne
5190: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 d integer */.typ
51a0: 65 64 65 66 20 55 49 4e 54 31 36 5f 54 59 50 45 edef UINT16_TYPE
51b0: 20 75 31 36 3b 20 20 20 20 20 20 20 20 20 20 20 u16;
51c0: 2f 2a 20 32 2d 62 79 74 65 20 75 6e 73 69 67 6e /* 2-byte unsign
51d0: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 ed integer */.ty
51e0: 70 65 64 65 66 20 49 4e 54 31 36 5f 54 59 50 45 pedef INT16_TYPE
51f0: 20 69 31 36 3b 20 20 20 20 20 20 20 20 20 20 20 i16;
5200: 20 2f 2a 20 32 2d 62 79 74 65 20 73 69 67 6e 65 /* 2-byte signe
5210: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 70 d integer */.typ
5220: 65 64 65 66 20 55 49 4e 54 38 5f 54 59 50 45 20 edef UINT8_TYPE
5230: 75 38 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 u8;
5240: 2f 2a 20 31 2d 62 79 74 65 20 75 6e 73 69 67 6e /* 1-byte unsign
5250: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 74 79 ed integer */.ty
5260: 70 65 64 65 66 20 49 4e 54 38 5f 54 59 50 45 20 pedef INT8_TYPE
5270: 69 38 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 i8;
5280: 20 2f 2a 20 31 2d 62 79 74 65 20 73 69 67 6e 65 /* 1-byte signe
5290: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 0a 2f 2a d integer */../*
52a0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 41 58 5f 55 .** SQLITE_MAX_U
52b0: 33 32 20 69 73 20 61 20 75 36 34 20 63 6f 6e 73 32 is a u64 cons
52c0: 74 61 6e 74 20 74 68 61 74 20 69 73 20 74 68 65 tant that is the
52d0: 20 6d 61 78 69 6d 75 6d 20 75 36 34 20 76 61 6c maximum u64 val
52e0: 75 65 0a 2a 2a 20 74 68 61 74 20 63 61 6e 20 62 ue.** that can b
52f0: 65 20 73 74 6f 72 65 64 20 69 6e 20 61 20 75 33 e stored in a u3
5300: 32 20 77 69 74 68 6f 75 74 20 6c 6f 73 73 20 6f 2 without loss o
5310: 66 20 64 61 74 61 2e 20 20 54 68 65 20 76 61 6c f data. The val
5320: 75 65 0a 2a 2a 20 69 73 20 30 78 30 30 30 30 30 ue.** is 0x00000
5330: 30 30 30 66 66 66 66 66 66 66 66 2e 20 20 42 75 000ffffffff. Bu
5340: 74 20 62 65 63 61 75 73 65 20 6f 66 20 71 75 69 t because of qui
5350: 72 6b 73 20 6f 66 20 73 6f 6d 65 20 63 6f 6d 70 rks of some comp
5360: 69 6c 65 72 73 2c 20 77 65 0a 2a 2a 20 68 61 76 ilers, we.** hav
5370: 65 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 e to specify the
5380: 20 76 61 6c 75 65 20 69 6e 20 74 68 65 20 6c 65 value in the le
5390: 73 73 20 69 6e 74 75 69 74 69 76 65 20 6d 61 6e ss intuitive man
53a0: 6e 65 72 20 73 68 6f 77 6e 3a 0a 2a 2f 0a 23 64 ner shown:.*/.#d
53b0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 efine SQLITE_MAX
53c0: 5f 55 33 32 20 20 28 28 28 28 75 36 34 29 31 29 _U32 ((((u64)1)
53d0: 3c 3c 33 32 29 2d 31 29 0a 0a 2f 2a 0a 2a 2a 20 <<32)-1)../*.**
53e0: 54 68 65 20 64 61 74 61 74 79 70 65 20 75 73 65 The datatype use
53f0: 64 20 74 6f 20 73 74 6f 72 65 20 65 73 74 69 6d d to store estim
5400: 61 74 65 73 20 6f 66 20 74 68 65 20 6e 75 6d 62 ates of the numb
5410: 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20 61 0a er of rows in a.
5420: 2a 2a 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 ** table or inde
5430: 78 2e 20 20 54 68 69 73 20 69 73 20 61 6e 20 75 x. This is an u
5440: 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 nsigned integer
5450: 74 79 70 65 2e 20 20 46 6f 72 20 39 39 2e 39 25 type. For 99.9%
5460: 20 6f 66 0a 2a 2a 20 74 68 65 20 77 6f 72 6c 64 of.** the world
5470: 2c 20 61 20 33 32 2d 62 69 74 20 69 6e 74 65 67 , a 32-bit integ
5480: 65 72 20 69 73 20 73 75 66 66 69 63 69 65 6e 74 er is sufficient
5490: 2e 20 20 42 75 74 20 61 20 36 34 2d 62 69 74 20 . But a 64-bit
54a0: 69 6e 74 65 67 65 72 0a 2a 2a 20 63 61 6e 20 62 integer.** can b
54b0: 65 20 75 73 65 64 20 61 74 20 63 6f 6d 70 69 6c e used at compil
54c0: 65 2d 74 69 6d 65 20 69 66 20 64 65 73 69 72 65 e-time if desire
54d0: 64 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c d..*/.#ifdef SQL
54e0: 49 54 45 5f 36 34 42 49 54 5f 53 54 41 54 53 0a ITE_64BIT_STATS.
54f0: 20 74 79 70 65 64 65 66 20 75 36 34 20 74 52 6f typedef u64 tRo
5500: 77 63 6e 74 3b 20 20 20 20 2f 2a 20 36 34 2d 62 wcnt; /* 64-b
5510: 69 74 20 6f 6e 6c 79 20 69 66 20 72 65 71 75 65 it only if reque
5520: 73 74 65 64 20 61 74 20 63 6f 6d 70 69 6c 65 2d sted at compile-
5530: 74 69 6d 65 20 2a 2f 0a 23 65 6c 73 65 0a 20 74 time */.#else. t
5540: 79 70 65 64 65 66 20 75 33 32 20 74 52 6f 77 63 ypedef u32 tRowc
5550: 6e 74 3b 20 20 20 20 2f 2a 20 33 32 2d 62 69 74 nt; /* 32-bit
5560: 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 is the default
5570: 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a */.#endif../*.**
5580: 20 45 73 74 69 6d 61 74 65 64 20 71 75 61 6e 74 Estimated quant
5590: 69 74 69 65 73 20 75 73 65 64 20 66 6f 72 20 71 ities used for q
55a0: 75 65 72 79 20 70 6c 61 6e 6e 69 6e 67 20 61 72 uery planning ar
55b0: 65 20 73 74 6f 72 65 64 20 61 73 20 31 36 2d 62 e stored as 16-b
55c0: 69 74 0a 2a 2a 20 6c 6f 67 61 72 69 74 68 6d 73 it.** logarithms
55d0: 2e 20 20 46 6f 72 20 71 75 61 6e 74 69 74 79 20 . For quantity
55e0: 58 2c 20 74 68 65 20 76 61 6c 75 65 20 73 74 6f X, the value sto
55f0: 72 65 64 20 69 73 20 31 30 2a 6c 6f 67 32 28 58 red is 10*log2(X
5600: 29 2e 20 20 54 68 69 73 0a 2a 2a 20 67 69 76 65 ). This.** give
5610: 73 20 61 20 70 6f 73 73 69 62 6c 65 20 72 61 6e s a possible ran
5620: 67 65 20 6f 66 20 76 61 6c 75 65 73 20 6f 66 20 ge of values of
5630: 61 70 70 72 6f 78 69 6d 61 74 65 6c 79 20 31 2e approximately 1.
5640: 30 65 39 38 36 20 74 6f 20 31 65 2d 39 38 36 2e 0e986 to 1e-986.
5650: 0a 2a 2a 20 42 75 74 20 74 68 65 20 61 6c 6c 6f .** But the allo
5660: 77 65 64 20 76 61 6c 75 65 73 20 61 72 65 20 22 wed values are "
5670: 67 72 61 69 6e 79 22 2e 20 20 4e 6f 74 20 65 76 grainy". Not ev
5680: 65 72 79 20 76 61 6c 75 65 20 69 73 20 72 65 70 ery value is rep
5690: 72 65 73 65 6e 74 61 62 6c 65 2e 0a 2a 2a 20 46 resentable..** F
56a0: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 71 75 61 6e or example, quan
56b0: 74 69 74 69 65 73 20 31 36 20 61 6e 64 20 31 37 tities 16 and 17
56c0: 20 61 72 65 20 62 6f 74 68 20 72 65 70 72 65 73 are both repres
56d0: 65 6e 74 65 64 20 62 79 20 61 20 4c 6f 67 45 73 ented by a LogEs
56e0: 74 0a 2a 2a 20 6f 66 20 34 30 2e 20 20 48 6f 77 t.** of 40. How
56f0: 65 76 65 72 2c 20 73 69 6e 63 65 20 4c 6f 67 45 ever, since LogE
5700: 73 74 20 71 75 61 6e 74 69 74 69 65 73 20 61 72 st quantities ar
5710: 65 20 73 75 70 70 6f 73 65 20 74 6f 20 62 65 20 e suppose to be
5720: 65 73 74 69 6d 61 74 65 73 2c 0a 2a 2a 20 6e 6f estimates,.** no
5730: 74 20 65 78 61 63 74 20 76 61 6c 75 65 73 2c 20 t exact values,
5740: 74 68 69 73 20 69 6d 70 72 65 63 69 73 69 6f 6e this imprecision
5750: 20 69 73 20 6e 6f 74 20 61 20 70 72 6f 62 6c 65 is not a proble
5760: 6d 2e 0a 2a 2a 0a 2a 2a 20 22 4c 6f 67 45 73 74 m..**.** "LogEst
5770: 22 20 69 73 20 73 68 6f 72 74 20 66 6f 72 20 22 " is short for "
5780: 4c 6f 67 61 72 69 74 68 6d 69 63 20 45 73 74 69 Logarithmic Esti
5790: 6d 61 74 65 22 2e 0a 2a 2a 0a 2a 2a 20 45 78 61 mate"..**.** Exa
57a0: 6d 70 6c 65 73 3a 0a 2a 2a 20 20 20 20 20 20 31 mples:.** 1
57b0: 20 2d 3e 20 30 20 20 20 20 20 20 20 20 20 20 20 -> 0
57c0: 20 20 20 32 30 20 2d 3e 20 34 33 20 20 20 20 20 20 -> 43
57d0: 20 20 20 20 20 31 30 30 30 30 20 2d 3e 20 31 33 10000 -> 13
57e0: 32 0a 2a 2a 20 20 20 20 20 20 32 20 2d 3e 20 31 2.** 2 -> 1
57f0: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 32 35 0 25
5800: 20 2d 3e 20 34 36 20 20 20 20 20 20 20 20 20 20 -> 46
5810: 32 35 30 30 30 20 2d 3e 20 31 34 36 0a 2a 2a 20 25000 -> 146.**
5820: 20 20 20 20 20 33 20 2d 3e 20 31 36 20 20 20 20 3 -> 16
5830: 20 20 20 20 20 20 20 20 31 30 30 20 2d 3e 20 36 100 -> 6
5840: 36 20 20 20 20 20 20 20 20 31 30 30 30 30 30 30 6 1000000
5850: 20 2d 3e 20 31 39 39 0a 2a 2a 20 20 20 20 20 20 -> 199.**
5860: 34 20 2d 3e 20 32 30 20 20 20 20 20 20 20 20 20 4 -> 20
5870: 20 20 31 30 30 30 20 2d 3e 20 39 39 20 20 20 20 1000 -> 99
5880: 20 20 20 20 31 30 34 38 35 37 36 20 2d 3e 20 32 1048576 -> 2
5890: 30 30 0a 2a 2a 20 20 20 20 20 31 30 20 2d 3e 20 00.** 10 ->
58a0: 33 33 20 20 20 20 20 20 20 20 20 20 20 31 30 32 33 102
58b0: 34 20 2d 3e 20 31 30 30 20 20 20 20 34 32 39 34 4 -> 100 4294
58c0: 39 36 37 32 39 36 20 2d 3e 20 33 32 30 0a 2a 2a 967296 -> 320.**
58d0: 0a 2a 2a 20 54 68 65 20 4c 6f 67 45 73 74 20 63 .** The LogEst c
58e0: 61 6e 20 62 65 20 6e 65 67 61 74 69 76 65 20 74 an be negative t
58f0: 6f 20 69 6e 64 69 63 61 74 65 20 66 72 61 63 74 o indicate fract
5900: 69 6f 6e 61 6c 20 76 61 6c 75 65 73 2e 0a 2a 2a ional values..**
5910: 20 45 78 61 6d 70 6c 65 73 3a 0a 2a 2a 0a 2a 2a Examples:.**.**
5920: 20 20 20 20 30 2e 35 20 2d 3e 20 2d 31 30 20 20 0.5 -> -10
5930: 20 20 20 20 20 20 20 20 20 30 2e 31 20 2d 3e 20 0.1 ->
5940: 2d 33 33 20 20 20 20 20 20 20 20 30 2e 30 36 32 -33 0.062
5950: 35 20 2d 3e 20 2d 34 30 0a 2a 2f 0a 74 79 70 65 5 -> -40.*/.type
5960: 64 65 66 20 49 4e 54 31 36 5f 54 59 50 45 20 4c def INT16_TYPE L
5970: 6f 67 45 73 74 3b 0a 0a 2f 2a 0a 2a 2a 20 53 65 ogEst;../*.** Se
5980: 74 20 74 68 65 20 53 51 4c 49 54 45 5f 50 54 52 t the SQLITE_PTR
5990: 53 49 5a 45 20 6d 61 63 72 6f 20 74 6f 20 74 68 SIZE macro to th
59a0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 e number of byte
59b0: 73 20 69 6e 20 61 20 70 6f 69 6e 74 65 72 0a 2a s in a pointer.*
59c0: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
59d0: 5f 50 54 52 53 49 5a 45 0a 23 20 69 66 20 64 65 _PTRSIZE.# if de
59e0: 66 69 6e 65 64 28 5f 5f 53 49 5a 45 4f 46 5f 50 fined(__SIZEOF_P
59f0: 4f 49 4e 54 45 52 5f 5f 29 0a 23 20 20 20 64 65 OINTER__).# de
5a00: 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 53 fine SQLITE_PTRS
5a10: 49 5a 45 20 5f 5f 53 49 5a 45 4f 46 5f 50 4f 49 IZE __SIZEOF_POI
5a20: 4e 54 45 52 5f 5f 0a 23 20 65 6c 69 66 20 64 65 NTER__.# elif de
5a30: 66 69 6e 65 64 28 69 33 38 36 29 20 20 20 20 20 fined(i386)
5a40: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 69 33 38 || defined(__i38
5a50: 36 5f 5f 29 20 20 20 7c 7c 20 64 65 66 69 6e 65 6__) || define
5a60: 64 28 5f 4d 5f 49 58 38 36 29 20 7c 7c 20 20 20 d(_M_IX86) ||
5a70: 20 5c 0a 20 20 20 20 20 20 20 64 65 66 69 6e 65 \. define
5a80: 64 28 5f 4d 5f 41 52 4d 29 20 20 20 7c 7c 20 64 d(_M_ARM) || d
5a90: 65 66 69 6e 65 64 28 5f 5f 61 72 6d 5f 5f 29 20 efined(__arm__)
5aa0: 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f || defined(__
5ab0: 78 38 36 29 0a 23 20 20 20 64 65 66 69 6e 65 20 x86).# define
5ac0: 53 51 4c 49 54 45 5f 50 54 52 53 49 5a 45 20 34 SQLITE_PTRSIZE 4
5ad0: 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 66 69 .# else.# defi
5ae0: 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 53 49 5a ne SQLITE_PTRSIZ
5af0: 45 20 38 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 E 8.# endif.#end
5b00: 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 if../*.** Macros
5b10: 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20 77 68 to determine wh
5b20: 65 74 68 65 72 20 74 68 65 20 6d 61 63 68 69 6e ether the machin
5b30: 65 20 69 73 20 62 69 67 20 6f 72 20 6c 69 74 74 e is big or litt
5b40: 6c 65 20 65 6e 64 69 61 6e 2c 0a 2a 2a 20 61 6e le endian,.** an
5b50: 64 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 d whether or not
5b60: 20 74 68 61 74 20 64 65 74 65 72 6d 69 6e 61 74 that determinat
5b70: 69 6f 6e 20 69 73 20 72 75 6e 2d 74 69 6d 65 20 ion is run-time
5b80: 6f 72 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2e or compile-time.
5b90: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 62 65 73 74 20 .**.** For best
5ba0: 70 65 72 66 6f 72 6d 61 6e 63 65 2c 20 61 6e 20 performance, an
5bb0: 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 attempt is made
5bc0: 74 6f 20 67 75 65 73 73 20 61 74 20 74 68 65 20 to guess at the
5bd0: 62 79 74 65 2d 6f 72 64 65 72 0a 2a 2a 20 75 73 byte-order.** us
5be0: 69 6e 67 20 43 2d 70 72 65 70 72 6f 63 65 73 73 ing C-preprocess
5bf0: 6f 72 20 6d 61 63 72 6f 73 2e 20 20 49 66 20 74 or macros. If t
5c00: 68 61 74 20 69 73 20 75 6e 73 75 63 63 65 73 73 hat is unsuccess
5c10: 66 75 6c 2c 20 6f 72 20 69 66 0a 2a 2a 20 2d 44 ful, or if.** -D
5c20: 53 51 4c 49 54 45 5f 52 55 4e 54 49 4d 45 5f 42 SQLITE_RUNTIME_B
5c30: 59 54 45 4f 52 44 45 52 3d 31 20 69 73 20 73 65 YTEORDER=1 is se
5c40: 74 2c 20 74 68 65 6e 20 62 79 74 65 2d 6f 72 64 t, then byte-ord
5c50: 65 72 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 er is determined
5c60: 0a 2a 2a 20 61 74 20 72 75 6e 2d 74 69 6d 65 2e .** at run-time.
5c70: 0a 2a 2f 0a 23 69 66 20 28 64 65 66 69 6e 65 64 .*/.#if (defined
5c80: 28 69 33 38 36 29 20 20 20 20 20 7c 7c 20 64 65 (i386) || de
5c90: 66 69 6e 65 64 28 5f 5f 69 33 38 36 5f 5f 29 20 fined(__i386__)
5ca0: 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f || defined(_M_
5cb0: 49 58 38 36 29 20 7c 7c 20 20 20 20 5c 0a 20 20 IX86) || \.
5cc0: 20 20 20 64 65 66 69 6e 65 64 28 5f 5f 78 38 36 defined(__x86
5cd0: 5f 36 34 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 _64) || defined(
5ce0: 5f 5f 78 38 36 5f 36 34 5f 5f 29 20 7c 7c 20 64 __x86_64__) || d
5cf0: 65 66 69 6e 65 64 28 5f 4d 5f 58 36 34 29 20 20 efined(_M_X64)
5d00: 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 64 65 66 || \. def
5d10: 69 6e 65 64 28 5f 4d 5f 41 4d 44 36 34 29 20 7c ined(_M_AMD64) |
5d20: 7c 20 64 65 66 69 6e 65 64 28 5f 4d 5f 41 52 4d | defined(_M_ARM
5d30: 29 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 ) || defined
5d40: 28 5f 5f 78 38 36 29 20 20 20 7c 7c 20 20 20 20 (__x86) ||
5d50: 5c 0a 20 20 20 20 20 64 65 66 69 6e 65 64 28 5f \. defined(_
5d60: 5f 61 72 6d 5f 5f 29 29 20 26 26 20 21 64 65 66 _arm__)) && !def
5d70: 69 6e 65 64 28 53 51 4c 49 54 45 5f 52 55 4e 54 ined(SQLITE_RUNT
5d80: 49 4d 45 5f 42 59 54 45 4f 52 44 45 52 29 0a 23 IME_BYTEORDER).#
5d90: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 define SQLITE_B
5da0: 59 54 45 4f 52 44 45 52 20 20 20 20 31 32 33 34 YTEORDER 1234
5db0: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
5dc0: 5f 42 49 47 45 4e 44 49 41 4e 20 20 20 20 30 0a _BIGENDIAN 0.
5dd0: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
5de0: 4c 49 54 54 4c 45 45 4e 44 49 41 4e 20 31 0a 23 LITTLEENDIAN 1.#
5df0: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 55 define SQLITE_U
5e00: 54 46 31 36 4e 41 54 49 56 45 20 20 53 51 4c 49 TF16NATIVE SQLI
5e10: 54 45 5f 55 54 46 31 36 4c 45 0a 23 65 6e 64 69 TE_UTF16LE.#endi
5e20: 66 0a 23 69 66 20 28 64 65 66 69 6e 65 64 28 73 f.#if (defined(s
5e30: 70 61 72 63 29 20 20 20 20 7c 7c 20 64 65 66 69 parc) || defi
5e40: 6e 65 64 28 5f 5f 70 70 63 5f 5f 29 29 20 20 5c ned(__ppc__)) \
5e50: 0a 20 20 20 20 26 26 20 21 64 65 66 69 6e 65 64 . && !defined
5e60: 28 53 51 4c 49 54 45 5f 52 55 4e 54 49 4d 45 5f (SQLITE_RUNTIME_
5e70: 42 59 54 45 4f 52 44 45 52 29 0a 23 20 64 65 66 BYTEORDER).# def
5e80: 69 6e 65 20 53 51 4c 49 54 45 5f 42 59 54 45 4f ine SQLITE_BYTEO
5e90: 52 44 45 52 20 20 20 20 34 33 32 31 0a 23 20 64 RDER 4321.# d
5ea0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 efine SQLITE_BIG
5eb0: 45 4e 44 49 41 4e 20 20 20 20 31 0a 23 20 64 65 ENDIAN 1.# de
5ec0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 54 54 fine SQLITE_LITT
5ed0: 4c 45 45 4e 44 49 41 4e 20 30 0a 23 20 64 65 66 LEENDIAN 0.# def
5ee0: 69 6e 65 20 53 51 4c 49 54 45 5f 55 54 46 31 36 ine SQLITE_UTF16
5ef0: 4e 41 54 49 56 45 20 20 53 51 4c 49 54 45 5f 55 NATIVE SQLITE_U
5f00: 54 46 31 36 42 45 0a 23 65 6e 64 69 66 0a 23 69 TF16BE.#endif.#i
5f10: 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
5f20: 45 5f 42 59 54 45 4f 52 44 45 52 29 0a 23 20 69 E_BYTEORDER).# i
5f30: 66 64 65 66 20 53 51 4c 49 54 45 5f 41 4d 41 4c fdef SQLITE_AMAL
5f40: 47 41 4d 41 54 49 4f 4e 0a 20 20 63 6f 6e 73 74 GAMATION. const
5f50: 20 69 6e 74 20 73 71 6c 69 74 65 33 6f 6e 65 20 int sqlite3one
5f60: 3d 20 31 3b 0a 23 20 65 6c 73 65 0a 20 20 65 78 = 1;.# else. ex
5f70: 74 65 72 6e 20 63 6f 6e 73 74 20 69 6e 74 20 73 tern const int s
5f80: 71 6c 69 74 65 33 6f 6e 65 3b 0a 23 20 65 6e 64 qlite3one;.# end
5f90: 69 66 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 if.# define SQLI
5fa0: 54 45 5f 42 59 54 45 4f 52 44 45 52 20 20 20 20 TE_BYTEORDER
5fb0: 30 20 20 20 20 20 2f 2a 20 30 20 6d 65 61 6e 73 0 /* 0 means
5fc0: 20 22 75 6e 6b 6e 6f 77 6e 20 61 74 20 63 6f 6d "unknown at com
5fd0: 70 69 6c 65 2d 74 69 6d 65 22 20 2a 2f 0a 23 20 pile-time" */.#
5fe0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 define SQLITE_BI
5ff0: 47 45 4e 44 49 41 4e 20 20 20 20 28 2a 28 63 68 GENDIAN (*(ch
6000: 61 72 20 2a 29 28 26 73 71 6c 69 74 65 33 6f 6e ar *)(&sqlite3on
6010: 65 29 3d 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 e)==0).# define
6020: 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 SQLITE_LITTLEEND
6030: 49 41 4e 20 28 2a 28 63 68 61 72 20 2a 29 28 26 IAN (*(char *)(&
6040: 73 71 6c 69 74 65 33 6f 6e 65 29 3d 3d 31 29 0a sqlite3one)==1).
6050: 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f # define SQLITE_
6060: 55 54 46 31 36 4e 41 54 49 56 45 20 20 28 53 51 UTF16NATIVE (SQ
6070: 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e 3f 53 LITE_BIGENDIAN?S
6080: 51 4c 49 54 45 5f 55 54 46 31 36 42 45 3a 53 51 QLITE_UTF16BE:SQ
6090: 4c 49 54 45 5f 55 54 46 31 36 4c 45 29 0a 23 65 LITE_UTF16LE).#e
60a0: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 73 ndif../*.** Cons
60b0: 74 61 6e 74 73 20 66 6f 72 20 74 68 65 20 6c 61 tants for the la
60c0: 72 67 65 73 74 20 61 6e 64 20 73 6d 61 6c 6c 65 rgest and smalle
60d0: 73 74 20 70 6f 73 73 69 62 6c 65 20 36 34 2d 62 st possible 64-b
60e0: 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 it signed intege
60f0: 72 73 2e 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 rs..** These mac
6100: 72 6f 73 20 61 72 65 20 64 65 73 69 67 6e 65 64 ros are designed
6110: 20 74 6f 20 77 6f 72 6b 20 63 6f 72 72 65 63 74 to work correct
6120: 6c 79 20 6f 6e 20 62 6f 74 68 20 33 32 2d 62 69 ly on both 32-bi
6130: 74 20 61 6e 64 20 36 34 2d 62 69 74 0a 2a 2a 20 t and 64-bit.**
6140: 63 6f 6d 70 69 6c 65 72 73 2e 0a 2a 2f 0a 23 64 compilers..*/.#d
6150: 65 66 69 6e 65 20 4c 41 52 47 45 53 54 5f 49 4e efine LARGEST_IN
6160: 54 36 34 20 20 28 30 78 66 66 66 66 66 66 66 66 T64 (0xffffffff
6170: 7c 28 28 28 69 36 34 29 30 78 37 66 66 66 66 66 |(((i64)0x7fffff
6180: 66 66 29 3c 3c 33 32 29 29 0a 23 64 65 66 69 6e ff)<<32)).#defin
6190: 65 20 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34 e SMALLEST_INT64
61a0: 20 28 28 28 69 36 34 29 2d 31 29 20 2d 20 4c 41 (((i64)-1) - LA
61b0: 52 47 45 53 54 5f 49 4e 54 36 34 29 0a 0a 2f 2a RGEST_INT64)../*
61c0: 0a 2a 2a 20 52 6f 75 6e 64 20 75 70 20 61 20 6e .** Round up a n
61d0: 75 6d 62 65 72 20 74 6f 20 74 68 65 20 6e 65 78 umber to the nex
61e0: 74 20 6c 61 72 67 65 72 20 6d 75 6c 74 69 70 6c t larger multipl
61f0: 65 20 6f 66 20 38 2e 20 20 54 68 69 73 20 69 73 e of 8. This is
6200: 20 75 73 65 64 0a 2a 2a 20 74 6f 20 66 6f 72 63 used.** to forc
6210: 65 20 38 2d 62 79 74 65 20 61 6c 69 67 6e 6d 65 e 8-byte alignme
6220: 6e 74 20 6f 6e 20 36 34 2d 62 69 74 20 61 72 63 nt on 64-bit arc
6230: 68 69 74 65 63 74 75 72 65 73 2e 0a 2a 2f 0a 23 hitectures..*/.#
6240: 64 65 66 69 6e 65 20 52 4f 55 4e 44 38 28 78 29 define ROUND8(x)
6250: 20 20 20 20 20 28 28 28 78 29 2b 37 29 26 7e 37 (((x)+7)&~7
6260: 29 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 6e 64 20 64 )../*.** Round d
6270: 6f 77 6e 20 74 6f 20 74 68 65 20 6e 65 61 72 65 own to the neare
6280: 73 74 20 6d 75 6c 74 69 70 6c 65 20 6f 66 20 38 st multiple of 8
6290: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 52 4f 55 4e .*/.#define ROUN
62a0: 44 44 4f 57 4e 38 28 78 29 20 28 28 78 29 26 7e DDOWN8(x) ((x)&~
62b0: 37 29 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 65 72 74 7)../*.** Assert
62c0: 20 74 68 61 74 20 74 68 65 20 70 6f 69 6e 74 65 that the pointe
62d0: 72 20 58 20 69 73 20 61 6c 69 67 6e 65 64 20 74 r X is aligned t
62e0: 6f 20 61 6e 20 38 2d 62 79 74 65 20 62 6f 75 6e o an 8-byte boun
62f0: 64 61 72 79 2e 20 20 54 68 69 73 0a 2a 2a 20 6d dary. This.** m
6300: 61 63 72 6f 20 69 73 20 75 73 65 64 20 6f 6e 6c acro is used onl
6310: 79 20 77 69 74 68 69 6e 20 61 73 73 65 72 74 28 y within assert(
6320: 29 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 ) to verify that
6330: 20 74 68 65 20 63 6f 64 65 20 67 65 74 73 0a 2a the code gets.*
6340: 2a 20 61 6c 6c 20 61 6c 69 67 6e 6d 65 6e 74 20 * all alignment
6350: 72 65 73 74 72 69 63 74 69 6f 6e 73 20 63 6f 72 restrictions cor
6360: 72 65 63 74 2e 0a 2a 2a 0a 2a 2a 20 45 78 63 65 rect..**.** Exce
6370: 70 74 2c 20 69 66 20 53 51 4c 49 54 45 5f 34 5f pt, if SQLITE_4_
6380: 42 59 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c BYTE_ALIGNED_MAL
6390: 4c 4f 43 20 69 73 20 64 65 66 69 6e 65 64 2c 20 LOC is defined,
63a0: 74 68 65 6e 20 74 68 65 0a 2a 2a 20 75 6e 64 65 then the.** unde
63b0: 72 6c 79 69 6e 67 20 6d 61 6c 6c 6f 63 28 29 20 rlying malloc()
63c0: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6d implementation m
63d0: 69 67 68 74 20 72 65 74 75 72 6e 20 75 73 20 34 ight return us 4
63e0: 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 0a 2a 2a -byte aligned.**
63f0: 20 70 6f 69 6e 74 65 72 73 2e 20 20 49 6e 20 74 pointers. In t
6400: 68 61 74 20 63 61 73 65 2c 20 6f 6e 6c 79 20 76 hat case, only v
6410: 65 72 69 66 79 20 34 2d 62 79 74 65 20 61 6c 69 erify 4-byte ali
6420: 67 6e 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 66 64 65 gnment..*/.#ifde
6430: 66 20 53 51 4c 49 54 45 5f 34 5f 42 59 54 45 5f f SQLITE_4_BYTE_
6440: 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f 43 0a 23 ALIGNED_MALLOC.#
6450: 20 64 65 66 69 6e 65 20 45 49 47 48 54 5f 42 59 define EIGHT_BY
6460: 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 TE_ALIGNMENT(X)
6470: 20 20 28 28 28 28 63 68 61 72 2a 29 28 58 29 20 ((((char*)(X)
6480: 2d 20 28 63 68 61 72 2a 29 30 29 26 33 29 3d 3d - (char*)0)&3)==
6490: 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 0).#else.# defin
64a0: 65 20 45 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 e EIGHT_BYTE_ALI
64b0: 47 4e 4d 45 4e 54 28 58 29 20 20 20 28 28 28 28 GNMENT(X) ((((
64c0: 63 68 61 72 2a 29 28 58 29 20 2d 20 28 63 68 61 char*)(X) - (cha
64d0: 72 2a 29 30 29 26 37 29 3d 3d 30 29 0a 23 65 6e r*)0)&7)==0).#en
64e0: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 69 73 61 62 dif../*.** Disab
64f0: 6c 65 20 4d 4d 41 50 20 6f 6e 20 70 6c 61 74 66 le MMAP on platf
6500: 6f 72 6d 73 20 77 68 65 72 65 20 69 74 20 69 73 orms where it is
6510: 20 6b 6e 6f 77 6e 20 74 6f 20 6e 6f 74 20 77 6f known to not wo
6520: 72 6b 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 rk.*/.#if define
6530: 64 28 5f 5f 4f 70 65 6e 42 53 44 5f 5f 29 20 7c d(__OpenBSD__) |
6540: 7c 20 64 65 66 69 6e 65 64 28 5f 5f 51 4e 58 4e | defined(__QNXN
6550: 54 4f 5f 5f 29 0a 23 20 75 6e 64 65 66 20 53 51 TO__).# undef SQ
6560: 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 LITE_MAX_MMAP_SI
6570: 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 ZE.# define SQLI
6580: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
6590: 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 0.#endif../*.**
65a0: 20 44 65 66 61 75 6c 74 20 6d 61 78 69 6d 75 6d Default maximum
65b0: 20 73 69 7a 65 20 6f 66 20 6d 65 6d 6f 72 79 20 size of memory
65c0: 75 73 65 64 20 62 79 20 6d 65 6d 6f 72 79 2d 6d used by memory-m
65d0: 61 70 70 65 64 20 49 2f 4f 20 69 6e 20 74 68 65 apped I/O in the
65e0: 20 56 46 53 0a 2a 2f 0a 23 69 66 64 65 66 20 5f VFS.*/.#ifdef _
65f0: 5f 41 50 50 4c 45 5f 5f 0a 23 20 69 6e 63 6c 75 _APPLE__.# inclu
6600: 64 65 20 3c 54 61 72 67 65 74 43 6f 6e 64 69 74 de <TargetCondit
6610: 69 6f 6e 61 6c 73 2e 68 3e 0a 23 65 6e 64 69 66 ionals.h>.#endif
6620: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
6630: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 MAX_MMAP_SIZE.#
6640: 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 6c 69 6e if defined(__lin
6650: 75 78 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 65 66 ux__) \. || def
6660: 69 6e 65 64 28 5f 57 49 4e 33 32 29 20 5c 0a 20 ined(_WIN32) \.
6670: 20 7c 7c 20 28 64 65 66 69 6e 65 64 28 5f 5f 41 || (defined(__A
6680: 50 50 4c 45 5f 5f 29 20 26 26 20 64 65 66 69 6e PPLE__) && defin
6690: 65 64 28 5f 5f 4d 41 43 48 5f 5f 29 29 20 5c 0a ed(__MACH__)) \.
66a0: 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 73 || defined(__s
66b0: 75 6e 29 20 5c 0a 20 20 7c 7c 20 64 65 66 69 6e un) \. || defin
66c0: 65 64 28 5f 5f 46 72 65 65 42 53 44 5f 5f 29 20 ed(__FreeBSD__)
66d0: 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f \. || defined(_
66e0: 5f 44 72 61 67 6f 6e 46 6c 79 5f 5f 29 0a 23 20 _DragonFly__).#
66f0: 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f define SQLITE_
6700: 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 78 MAX_MMAP_SIZE 0x
6710: 37 66 66 66 30 30 30 30 20 20 2f 2a 20 32 31 34 7fff0000 /* 214
6720: 37 34 31 38 31 31 32 20 2a 2f 0a 23 20 65 6c 73 7418112 */.# els
6730: 65 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c e.# define SQL
6740: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
6750: 45 20 30 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 E 0.# endif.# de
6760: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f fine SQLITE_MAX_
6770: 4d 4d 41 50 5f 53 49 5a 45 5f 78 63 20 31 20 2f MMAP_SIZE_xc 1 /
6780: 2a 20 65 78 63 6c 75 64 65 20 66 72 6f 6d 20 63 * exclude from c
6790: 74 69 6d 65 2e 63 20 2a 2f 0a 23 65 6e 64 69 66 time.c */.#endif
67a0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 65 66 61 ../*.** The defa
67b0: 75 6c 74 20 4d 4d 41 50 5f 53 49 5a 45 20 69 73 ult MMAP_SIZE is
67c0: 20 7a 65 72 6f 20 6f 6e 20 61 6c 6c 20 70 6c 61 zero on all pla
67d0: 74 66 6f 72 6d 73 2e 20 20 4f 72 2c 20 65 76 65 tforms. Or, eve
67e0: 6e 20 69 66 20 61 20 6c 61 72 67 65 72 0a 2a 2a n if a larger.**
67f0: 20 64 65 66 61 75 6c 74 20 4d 4d 41 50 5f 53 49 default MMAP_SI
6800: 5a 45 20 69 73 20 73 70 65 63 69 66 69 65 64 20 ZE is specified
6810: 61 74 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 2c at compile-time,
6820: 20 6d 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 make sure that
6830: 69 74 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 65 it does.** not e
6840: 78 63 65 65 64 20 74 68 65 20 6d 61 78 69 6d 75 xceed the maximu
6850: 6d 20 6d 6d 61 70 20 73 69 7a 65 2e 0a 2a 2f 0a m mmap size..*/.
6860: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 #ifndef SQLITE_D
6870: 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 EFAULT_MMAP_SIZE
6880: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
6890: 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 _DEFAULT_MMAP_SI
68a0: 5a 45 20 30 0a 23 20 64 65 66 69 6e 65 20 53 51 ZE 0.# define SQ
68b0: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 LITE_DEFAULT_MMA
68c0: 50 5f 53 49 5a 45 5f 78 63 20 31 20 20 2f 2a 20 P_SIZE_xc 1 /*
68d0: 45 78 63 6c 75 64 65 20 66 72 6f 6d 20 63 74 69 Exclude from cti
68e0: 6d 65 2e 63 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 me.c */.#endif.#
68f0: 69 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c if SQLITE_DEFAUL
6900: 54 5f 4d 4d 41 50 5f 53 49 5a 45 3e 53 51 4c 49 T_MMAP_SIZE>SQLI
6910: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
6920: 0a 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 5f .# undef SQLITE_
6930: 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a DEFAULT_MMAP_SIZ
6940: 45 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 E.# define SQLIT
6950: 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 E_DEFAULT_MMAP_S
6960: 49 5a 45 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d IZE SQLITE_MAX_M
6970: 4d 41 50 5f 53 49 5a 45 0a 23 65 6e 64 69 66 0a MAP_SIZE.#endif.
6980: 0a 2f 2a 0a 2a 2a 20 4f 6e 6c 79 20 6f 6e 65 20 ./*.** Only one
6990: 6f 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 of SQLITE_ENABLE
69a0: 5f 53 54 41 54 33 20 6f 72 20 53 51 4c 49 54 45 _STAT3 or SQLITE
69b0: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 34 20 63 61 _ENABLE_STAT4 ca
69c0: 6e 20 62 65 20 64 65 66 69 6e 65 64 2e 0a 2a 2a n be defined..**
69d0: 20 50 72 69 6f 72 69 74 79 20 69 73 20 67 69 76 Priority is giv
69e0: 65 6e 20 74 6f 20 53 51 4c 49 54 45 5f 45 4e 41 en to SQLITE_ENA
69f0: 42 4c 45 5f 53 54 41 54 34 2e 20 20 49 66 20 65 BLE_STAT4. If e
6a00: 69 74 68 65 72 20 61 72 65 20 64 65 66 69 6e 65 ither are define
6a10: 64 2c 20 61 6c 73 6f 0a 2a 2a 20 64 65 66 69 6e d, also.** defin
6a20: 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f e SQLITE_ENABLE_
6a30: 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 2a STAT3_OR_STAT4.*
6a40: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
6a50: 45 4e 41 42 4c 45 5f 53 54 41 54 34 0a 23 20 75 ENABLE_STAT4.# u
6a60: 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 ndef SQLITE_ENAB
6a70: 4c 45 5f 53 54 41 54 33 0a 23 20 64 65 66 69 6e LE_STAT3.# defin
6a80: 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f e SQLITE_ENABLE_
6a90: 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 20 31 STAT3_OR_STAT4 1
6aa0: 0a 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 45 4e .#elif SQLITE_EN
6ab0: 41 42 4c 45 5f 53 54 41 54 33 0a 23 20 64 65 66 ABLE_STAT3.# def
6ac0: 69 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c ine SQLITE_ENABL
6ad0: 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 E_STAT3_OR_STAT4
6ae0: 20 31 0a 23 65 6c 69 66 20 53 51 4c 49 54 45 5f 1.#elif SQLITE_
6af0: 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f ENABLE_STAT3_OR_
6b00: 53 54 41 54 34 0a 23 20 75 6e 64 65 66 20 53 51 STAT4.# undef SQ
6b10: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
6b20: 33 5f 4f 52 5f 53 54 41 54 34 0a 23 65 6e 64 69 3_OR_STAT4.#endi
6b30: 66 0a 0a 2f 2a 0a 2a 2a 20 53 45 4c 45 43 54 54 f../*.** SELECTT
6b40: 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 77 69 6c RACE_ENABLED wil
6b50: 6c 20 62 65 20 65 69 74 68 65 72 20 31 20 6f 72 l be either 1 or
6b60: 20 30 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 0 depending on
6b70: 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 0a 2a whether or not.*
6b80: 2a 20 74 68 65 20 53 65 6c 65 63 74 20 71 75 65 * the Select que
6b90: 72 79 20 67 65 6e 65 72 61 74 6f 72 20 74 72 61 ry generator tra
6ba0: 63 69 6e 67 20 6c 6f 67 69 63 20 69 73 20 74 75 cing logic is tu
6bb0: 72 6e 65 64 20 6f 6e 2e 0a 2a 2f 0a 23 69 66 20 rned on..*/.#if
6bc0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 defined(SQLITE_D
6bd0: 45 42 55 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 EBUG) || defined
6be0: 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 (SQLITE_ENABLE_S
6bf0: 45 4c 45 43 54 54 52 41 43 45 29 0a 23 20 64 65 ELECTTRACE).# de
6c00: 66 69 6e 65 20 53 45 4c 45 43 54 54 52 41 43 45 fine SELECTTRACE
6c10: 5f 45 4e 41 42 4c 45 44 20 31 0a 23 65 6c 73 65 _ENABLED 1.#else
6c20: 0a 23 20 64 65 66 69 6e 65 20 53 45 4c 45 43 54 .# define SELECT
6c30: 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 30 0a TRACE_ENABLED 0.
6c40: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e #endif../*.** An
6c50: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
6c60: 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
6c70: 74 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 ture is used to
6c80: 73 74 6f 72 65 20 74 68 65 20 62 75 73 79 2d 68 store the busy-h
6c90: 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c 62 61 andler.** callba
6ca0: 63 6b 20 66 6f 72 20 61 20 67 69 76 65 6e 20 73 ck for a given s
6cb0: 71 6c 69 74 65 20 68 61 6e 64 6c 65 2e 0a 2a 2a qlite handle..**
6cc0: 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 65 2e 62 .** The sqlite.b
6cd0: 75 73 79 48 61 6e 64 6c 65 72 20 6d 65 6d 62 65 usyHandler membe
6ce0: 72 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 20 r of the sqlite
6cf0: 73 74 72 75 63 74 20 63 6f 6e 74 61 69 6e 73 20 struct contains
6d00: 74 68 65 20 62 75 73 79 0a 2a 2a 20 63 61 6c 6c the busy.** call
6d10: 62 61 63 6b 20 66 6f 72 20 74 68 65 20 64 61 74 back for the dat
6d20: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 45 61 abase handle. Ea
6d30: 63 68 20 70 61 67 65 72 20 6f 70 65 6e 65 64 20 ch pager opened
6d40: 76 69 61 20 74 68 65 20 73 71 6c 69 74 65 0a 2a via the sqlite.*
6d50: 2a 20 68 61 6e 64 6c 65 20 69 73 20 70 61 73 73 * handle is pass
6d60: 65 64 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 ed a pointer to
6d70: 73 71 6c 69 74 65 2e 62 75 73 79 48 61 6e 64 6c sqlite.busyHandl
6d80: 65 72 2e 20 54 68 65 20 62 75 73 79 2d 68 61 6e er. The busy-han
6d90: 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c 62 61 63 6b dler.** callback
6da0: 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 69 6e is currently in
6db0: 76 6f 6b 65 64 20 6f 6e 6c 79 20 66 72 6f 6d 20 voked only from
6dc0: 77 69 74 68 69 6e 20 70 61 67 65 72 2e 63 2e 0a within pager.c..
6dd0: 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 */.typedef struc
6de0: 74 20 42 75 73 79 48 61 6e 64 6c 65 72 20 42 75 t BusyHandler Bu
6df0: 73 79 48 61 6e 64 6c 65 72 3b 0a 73 74 72 75 63 syHandler;.struc
6e00: 74 20 42 75 73 79 48 61 6e 64 6c 65 72 20 7b 0a t BusyHandler {.
6e10: 20 20 69 6e 74 20 28 2a 78 46 75 6e 63 29 28 76 int (*xFunc)(v
6e20: 6f 69 64 20 2a 2c 69 6e 74 29 3b 20 20 2f 2a 20 oid *,int); /*
6e30: 54 68 65 20 62 75 73 79 20 63 61 6c 6c 62 61 63 The busy callbac
6e40: 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 72 k */. void *pAr
6e50: 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
6e60: 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 20 74 /* First arg t
6e70: 6f 20 62 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 o busy callback
6e80: 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 73 79 3b 20 */. int nBusy;
6e90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6ea0: 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 65 64 20 77 /* Incremented w
6eb0: 69 74 68 20 65 61 63 68 20 62 75 73 79 20 63 61 ith each busy ca
6ec0: 6c 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 ll */.};../*.**
6ed0: 4e 61 6d 65 20 6f 66 20 74 68 65 20 6d 61 73 74 Name of the mast
6ee0: 65 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c er database tabl
6ef0: 65 2e 20 20 54 68 65 20 6d 61 73 74 65 72 20 64 e. The master d
6f00: 61 74 61 62 61 73 65 20 74 61 62 6c 65 0a 2a 2a atabase table.**
6f10: 20 69 73 20 61 20 73 70 65 63 69 61 6c 20 74 61 is a special ta
6f20: 62 6c 65 20 74 68 61 74 20 68 6f 6c 64 73 20 74 ble that holds t
6f30: 68 65 20 6e 61 6d 65 73 20 61 6e 64 20 61 74 74 he names and att
6f40: 72 69 62 75 74 65 73 20 6f 66 20 61 6c 6c 0a 2a ributes of all.*
6f50: 2a 20 75 73 65 72 20 74 61 62 6c 65 73 20 61 6e * user tables an
6f60: 64 20 69 6e 64 69 63 65 73 2e 0a 2a 2f 0a 23 64 d indices..*/.#d
6f70: 65 66 69 6e 65 20 4d 41 53 54 45 52 5f 4e 41 4d efine MASTER_NAM
6f80: 45 20 20 20 20 20 20 20 22 73 71 6c 69 74 65 5f E "sqlite_
6f90: 6d 61 73 74 65 72 22 0a 23 64 65 66 69 6e 65 20 master".#define
6fa0: 54 45 4d 50 5f 4d 41 53 54 45 52 5f 4e 41 4d 45 TEMP_MASTER_NAME
6fb0: 20 20 22 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d "sqlite_temp_m
6fc0: 61 73 74 65 72 22 0a 0a 2f 2a 0a 2a 2a 20 54 68 aster"../*.** Th
6fd0: 65 20 72 6f 6f 74 2d 70 61 67 65 20 6f 66 20 74 e root-page of t
6fe0: 68 65 20 6d 61 73 74 65 72 20 64 61 74 61 62 61 he master databa
6ff0: 73 65 20 74 61 62 6c 65 2e 0a 2a 2f 0a 23 64 65 se table..*/.#de
7000: 66 69 6e 65 20 4d 41 53 54 45 52 5f 52 4f 4f 54 fine MASTER_ROOT
7010: 20 20 20 20 20 20 20 31 0a 0a 2f 2a 0a 2a 2a 20 1../*.**
7020: 54 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 The name of the
7030: 73 63 68 65 6d 61 20 74 61 62 6c 65 2e 0a 2a 2f schema table..*/
7040: 0a 23 64 65 66 69 6e 65 20 53 43 48 45 4d 41 5f .#define SCHEMA_
7050: 54 41 42 4c 45 28 78 29 20 20 28 28 21 4f 4d 49 TABLE(x) ((!OMI
7060: 54 5f 54 45 4d 50 44 42 29 26 26 28 78 3d 3d 31 T_TEMPDB)&&(x==1
7070: 29 3f 54 45 4d 50 5f 4d 41 53 54 45 52 5f 4e 41 )?TEMP_MASTER_NA
7080: 4d 45 3a 4d 41 53 54 45 52 5f 4e 41 4d 45 29 0a ME:MASTER_NAME).
7090: 0a 2f 2a 0a 2a 2a 20 41 20 63 6f 6e 76 65 6e 69 ./*.** A conveni
70a0: 65 6e 63 65 20 6d 61 63 72 6f 20 74 68 61 74 20 ence macro that
70b0: 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62 returns the numb
70c0: 65 72 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 er of elements i
70d0: 6e 0a 2a 2a 20 61 6e 20 61 72 72 61 79 2e 0a 2a n.** an array..*
70e0: 2f 0a 23 64 65 66 69 6e 65 20 41 72 72 61 79 53 /.#define ArrayS
70f0: 69 7a 65 28 58 29 20 20 20 20 28 28 69 6e 74 29 ize(X) ((int)
7100: 28 73 69 7a 65 6f 66 28 58 29 2f 73 69 7a 65 6f (sizeof(X)/sizeo
7110: 66 28 58 5b 30 5d 29 29 29 0a 0a 2f 2a 0a 2a 2a f(X[0])))../*.**
7120: 20 44 65 74 65 72 6d 69 6e 65 20 69 66 20 74 68 Determine if th
7130: 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 20 e argument is a
7140: 70 6f 77 65 72 20 6f 66 20 74 77 6f 0a 2a 2f 0a power of two.*/.
7150: 23 64 65 66 69 6e 65 20 49 73 50 6f 77 65 72 4f #define IsPowerO
7160: 66 54 77 6f 28 58 29 20 28 28 28 58 29 26 28 28 fTwo(X) (((X)&((
7170: 58 29 2d 31 29 29 3d 3d 30 29 0a 0a 2f 2a 0a 2a X)-1))==0)../*.*
7180: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
7190: 76 61 6c 75 65 20 61 73 20 61 20 64 65 73 74 72 value as a destr
71a0: 75 63 74 6f 72 20 6d 65 61 6e 73 20 74 6f 20 75 uctor means to u
71b0: 73 65 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 se sqlite3DbFree
71c0: 28 29 2e 0a 2a 2a 20 54 68 65 20 73 71 6c 69 74 ()..** The sqlit
71d0: 65 33 44 62 46 72 65 65 28 29 20 72 6f 75 74 69 e3DbFree() routi
71e0: 6e 65 20 72 65 71 75 69 72 65 73 20 74 77 6f 20 ne requires two
71f0: 70 61 72 61 6d 65 74 65 72 73 20 69 6e 73 74 65 parameters inste
7200: 61 64 20 6f 66 20 74 68 65 0a 2a 2a 20 6f 6e 65 ad of the.** one
7210: 20 70 61 72 61 6d 65 74 65 72 20 74 68 61 74 20 parameter that
7220: 64 65 73 74 72 75 63 74 6f 72 73 20 6e 6f 72 6d destructors norm
7230: 61 6c 6c 79 20 77 61 6e 74 2e 20 20 53 6f 20 77 ally want. So w
7240: 65 20 68 61 76 65 20 74 6f 20 69 6e 74 72 6f 64 e have to introd
7250: 75 63 65 0a 2a 2a 20 74 68 69 73 20 6d 61 67 69 uce.** this magi
7260: 63 20 76 61 6c 75 65 20 74 68 61 74 20 74 68 65 c value that the
7270: 20 63 6f 64 65 20 6b 6e 6f 77 73 20 74 6f 20 68 code knows to h
7280: 61 6e 64 6c 65 20 64 69 66 66 65 72 65 6e 74 6c andle differentl
7290: 79 2e 20 20 41 6e 79 0a 2a 2a 20 70 6f 69 6e 74 y. Any.** point
72a0: 65 72 20 77 69 6c 6c 20 77 6f 72 6b 20 68 65 72 er will work her
72b0: 65 20 61 73 20 6c 6f 6e 67 20 61 73 20 69 74 20 e as long as it
72c0: 69 73 20 64 69 73 74 69 6e 63 74 20 66 72 6f 6d is distinct from
72d0: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 0a 2a SQLITE_STATIC.*
72e0: 2a 20 61 6e 64 20 53 51 4c 49 54 45 5f 54 52 41 * and SQLITE_TRA
72f0: 4e 53 49 45 4e 54 2e 0a 2a 2f 0a 23 64 65 66 69 NSIENT..*/.#defi
7300: 6e 65 20 53 51 4c 49 54 45 5f 44 59 4e 41 4d 49 ne SQLITE_DYNAMI
7310: 43 20 20 20 28 28 73 71 6c 69 74 65 33 5f 64 65 C ((sqlite3_de
7320: 73 74 72 75 63 74 6f 72 5f 74 79 70 65 29 73 71 structor_type)sq
7330: 6c 69 74 65 33 4d 61 6c 6c 6f 63 53 69 7a 65 29 lite3MallocSize)
7340: 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e 20 53 51 4c ../*.** When SQL
7350: 49 54 45 5f 4f 4d 49 54 5f 57 53 44 20 69 73 20 ITE_OMIT_WSD is
7360: 64 65 66 69 6e 65 64 2c 20 69 74 20 6d 65 61 6e defined, it mean
7370: 73 20 74 68 61 74 20 74 68 65 20 74 61 72 67 65 s that the targe
7380: 74 20 70 6c 61 74 66 6f 72 6d 20 64 6f 65 73 0a t platform does.
7390: 2a 2a 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 57 ** not support W
73a0: 72 69 74 61 62 6c 65 20 53 74 61 74 69 63 20 44 ritable Static D
73b0: 61 74 61 20 28 57 53 44 29 20 73 75 63 68 20 61 ata (WSD) such a
73c0: 73 20 67 6c 6f 62 61 6c 20 61 6e 64 20 73 74 61 s global and sta
73d0: 74 69 63 20 76 61 72 69 61 62 6c 65 73 2e 0a 2a tic variables..*
73e0: 2a 20 41 6c 6c 20 76 61 72 69 61 62 6c 65 73 20 * All variables
73f0: 6d 75 73 74 20 65 69 74 68 65 72 20 62 65 20 6f must either be o
7400: 6e 20 74 68 65 20 73 74 61 63 6b 20 6f 72 20 64 n the stack or d
7410: 79 6e 61 6d 69 63 61 6c 6c 79 20 61 6c 6c 6f 63 ynamically alloc
7420: 61 74 65 64 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 ated from.** the
7430: 20 68 65 61 70 2e 20 20 57 68 65 6e 20 57 53 44 heap. When WSD
7440: 20 69 73 20 75 6e 73 75 70 70 6f 72 74 65 64 2c is unsupported,
7450: 20 74 68 65 20 76 61 72 69 61 62 6c 65 20 64 65 the variable de
7460: 63 6c 61 72 61 74 69 6f 6e 73 20 73 63 61 74 74 clarations scatt
7470: 65 72 65 64 0a 2a 2a 20 74 68 72 6f 75 67 68 6f ered.** througho
7480: 75 74 20 74 68 65 20 53 51 4c 69 74 65 20 63 6f ut the SQLite co
7490: 64 65 20 6d 75 73 74 20 62 65 63 6f 6d 65 20 63 de must become c
74a0: 6f 6e 73 74 61 6e 74 73 20 69 6e 73 74 65 61 64 onstants instead
74b0: 2e 20 20 54 68 65 20 53 51 4c 49 54 45 5f 57 53 . The SQLITE_WS
74c0: 44 0a 2a 2a 20 6d 61 63 72 6f 20 69 73 20 75 73 D.** macro is us
74d0: 65 64 20 66 6f 72 20 74 68 69 73 20 70 75 72 70 ed for this purp
74e0: 6f 73 65 2e 20 20 41 6e 64 20 69 6e 73 74 65 61 ose. And instea
74f0: 64 20 6f 66 20 72 65 66 65 72 65 6e 63 69 6e 67 d of referencing
7500: 20 74 68 65 20 76 61 72 69 61 62 6c 65 0a 2a 2a the variable.**
7510: 20 64 69 72 65 63 74 6c 79 2c 20 77 65 20 75 73 directly, we us
7520: 65 20 69 74 73 20 63 6f 6e 73 74 61 6e 74 20 61 e its constant a
7530: 73 20 61 20 6b 65 79 20 74 6f 20 6c 6f 6f 6b 75 s a key to looku
7540: 70 20 74 68 65 20 72 75 6e 2d 74 69 6d 65 20 61 p the run-time a
7550: 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 62 75 66 66 llocated.** buff
7560: 65 72 20 74 68 61 74 20 68 6f 6c 64 73 20 72 65 er that holds re
7570: 61 6c 20 76 61 72 69 61 62 6c 65 2e 20 20 54 68 al variable. Th
7580: 65 20 63 6f 6e 73 74 61 6e 74 20 69 73 20 61 6c e constant is al
7590: 73 6f 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a so the initializ
75a0: 65 72 0a 2a 2a 20 66 6f 72 20 74 68 65 20 72 75 er.** for the ru
75b0: 6e 2d 74 69 6d 65 20 61 6c 6c 6f 63 61 74 65 64 n-time allocated
75c0: 20 62 75 66 66 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 buffer..**.** I
75d0: 6e 20 74 68 65 20 75 73 75 61 6c 20 63 61 73 65 n the usual case
75e0: 20 77 68 65 72 65 20 57 53 44 20 69 73 20 73 75 where WSD is su
75f0: 70 70 6f 72 74 65 64 2c 20 74 68 65 20 53 51 4c pported, the SQL
7600: 49 54 45 5f 57 53 44 20 61 6e 64 20 47 4c 4f 42 ITE_WSD and GLOB
7610: 41 4c 0a 2a 2a 20 6d 61 63 72 6f 73 20 62 65 63 AL.** macros bec
7620: 6f 6d 65 20 6e 6f 2d 6f 70 73 20 61 6e 64 20 68 ome no-ops and h
7630: 61 76 65 20 7a 65 72 6f 20 70 65 72 66 6f 72 6d ave zero perform
7640: 61 6e 63 65 20 69 6d 70 61 63 74 2e 0a 2a 2f 0a ance impact..*/.
7650: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
7660: 49 54 5f 57 53 44 0a 20 20 23 64 65 66 69 6e 65 IT_WSD. #define
7670: 20 53 51 4c 49 54 45 5f 57 53 44 20 63 6f 6e 73 SQLITE_WSD cons
7680: 74 0a 20 20 23 64 65 66 69 6e 65 20 47 4c 4f 42 t. #define GLOB
7690: 41 4c 28 74 2c 76 29 20 28 2a 28 74 2a 29 73 71 AL(t,v) (*(t*)sq
76a0: 6c 69 74 65 33 5f 77 73 64 5f 66 69 6e 64 28 28 lite3_wsd_find((
76b0: 76 6f 69 64 2a 29 26 28 76 29 2c 20 73 69 7a 65 void*)&(v), size
76c0: 6f 66 28 76 29 29 29 0a 20 20 23 64 65 66 69 6e of(v))). #defin
76d0: 65 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 e sqlite3GlobalC
76e0: 6f 6e 66 69 67 20 47 4c 4f 42 41 4c 28 73 74 72 onfig GLOBAL(str
76f0: 75 63 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 uct Sqlite3Confi
7700: 67 2c 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 g, sqlite3Config
7710: 29 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 5f ). int sqlite3_
7720: 77 73 64 5f 69 6e 69 74 28 69 6e 74 20 4e 2c 20 wsd_init(int N,
7730: 69 6e 74 20 4a 29 3b 0a 20 20 76 6f 69 64 20 2a int J);. void *
7740: 73 71 6c 69 74 65 33 5f 77 73 64 5f 66 69 6e 64 sqlite3_wsd_find
7750: 28 76 6f 69 64 20 2a 4b 2c 20 69 6e 74 20 4c 29 (void *K, int L)
7760: 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e ;.#else. #defin
7770: 65 20 53 51 4c 49 54 45 5f 57 53 44 0a 20 20 23 e SQLITE_WSD. #
7780: 64 65 66 69 6e 65 20 47 4c 4f 42 41 4c 28 74 2c define GLOBAL(t,
7790: 76 29 20 76 0a 20 20 23 64 65 66 69 6e 65 20 73 v) v. #define s
77a0: 71 6c 69 74 65 33 47 6c 6f 62 61 6c 43 6f 6e 66 qlite3GlobalConf
77b0: 69 67 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 ig sqlite3Config
77c0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
77d0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 he following mac
77e0: 72 6f 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 ros are used to
77f0: 73 75 70 70 72 65 73 73 20 63 6f 6d 70 69 6c 65 suppress compile
7800: 72 20 77 61 72 6e 69 6e 67 73 20 61 6e 64 20 74 r warnings and t
7810: 6f 0a 2a 2a 20 6d 61 6b 65 20 69 74 20 63 6c 65 o.** make it cle
7820: 61 72 20 74 6f 20 68 75 6d 61 6e 20 72 65 61 64 ar to human read
7830: 65 72 73 20 77 68 65 6e 20 61 20 66 75 6e 63 74 ers when a funct
7840: 69 6f 6e 20 70 61 72 61 6d 65 74 65 72 20 69 73 ion parameter is
7850: 20 64 65 6c 69 62 65 72 61 74 65 6c 79 0a 2a 2a deliberately.**
7860: 20 6c 65 66 74 20 75 6e 75 73 65 64 20 77 69 74 left unused wit
7870: 68 69 6e 20 74 68 65 20 62 6f 64 79 20 6f 66 20 hin the body of
7880: 61 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68 69 73 a function. This
7890: 20 75 73 75 61 6c 6c 79 20 68 61 70 70 65 6e 73 usually happens
78a0: 20 77 68 65 6e 0a 2a 2a 20 61 20 66 75 6e 63 74 when.** a funct
78b0: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 76 69 ion is called vi
78c0: 61 20 61 20 66 75 6e 63 74 69 6f 6e 20 70 6f 69 a a function poi
78d0: 6e 74 65 72 2e 20 46 6f 72 20 65 78 61 6d 70 6c nter. For exampl
78e0: 65 20 74 68 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 e the.** impleme
78f0: 6e 74 61 74 69 6f 6e 20 6f 66 20 61 6e 20 53 51 ntation of an SQ
7900: 4c 20 61 67 67 72 65 67 61 74 65 20 73 74 65 70 L aggregate step
7910: 20 63 61 6c 6c 62 61 63 6b 20 6d 61 79 20 6e 6f callback may no
7920: 74 20 75 73 65 20 74 68 65 0a 2a 2a 20 70 61 72 t use the.** par
7930: 61 6d 65 74 65 72 20 69 6e 64 69 63 61 74 69 6e ameter indicatin
7940: 67 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 g the number of
7950: 61 72 67 75 6d 65 6e 74 73 20 70 61 73 73 65 64 arguments passed
7960: 20 74 6f 20 74 68 65 20 61 67 67 72 65 67 61 74 to the aggregat
7970: 65 2c 0a 2a 2a 20 69 66 20 69 74 20 6b 6e 6f 77 e,.** if it know
7980: 73 20 74 68 61 74 20 74 68 69 73 20 69 73 20 65 s that this is e
7990: 6e 66 6f 72 63 65 64 20 65 6c 73 65 77 68 65 72 nforced elsewher
79a0: 65 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 20 e..**.** When a
79b0: 66 75 6e 63 74 69 6f 6e 20 70 61 72 61 6d 65 74 function paramet
79c0: 65 72 20 69 73 20 6e 6f 74 20 75 73 65 64 20 61 er is not used a
79d0: 74 20 61 6c 6c 20 77 69 74 68 69 6e 20 74 68 65 t all within the
79e0: 20 62 6f 64 79 20 6f 66 20 61 20 66 75 6e 63 74 body of a funct
79f0: 69 6f 6e 2c 0a 2a 2a 20 69 74 20 69 73 20 67 65 ion,.** it is ge
7a00: 6e 65 72 61 6c 6c 79 20 6e 61 6d 65 64 20 22 4e nerally named "N
7a10: 6f 74 55 73 65 64 22 20 6f 72 20 22 4e 6f 74 55 otUsed" or "NotU
7a20: 73 65 64 32 22 20 74 6f 20 6d 61 6b 65 20 74 68 sed2" to make th
7a30: 69 6e 67 73 20 65 76 65 6e 20 63 6c 65 61 72 65 ings even cleare
7a40: 72 2e 0a 2a 2a 20 48 6f 77 65 76 65 72 2c 20 74 r..** However, t
7a50: 68 65 73 65 20 6d 61 63 72 6f 73 20 6d 61 79 20 hese macros may
7a60: 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 6f 20 also be used to
7a70: 73 75 70 70 72 65 73 73 20 77 61 72 6e 69 6e 67 suppress warning
7a80: 73 20 72 65 6c 61 74 65 64 20 74 6f 0a 2a 2a 20 s related to.**
7a90: 70 61 72 61 6d 65 74 65 72 73 20 74 68 61 74 20 parameters that
7aa0: 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 may or may not b
7ab0: 65 20 75 73 65 64 20 64 65 70 65 6e 64 69 6e 67 e used depending
7ac0: 20 6f 6e 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 on compilation
7ad0: 6f 70 74 69 6f 6e 73 2e 0a 2a 2a 20 46 6f 72 20 options..** For
7ae0: 65 78 61 6d 70 6c 65 20 74 68 6f 73 65 20 70 61 example those pa
7af0: 72 61 6d 65 74 65 72 73 20 6f 6e 6c 79 20 75 73 rameters only us
7b00: 65 64 20 69 6e 20 61 73 73 65 72 74 28 29 20 73 ed in assert() s
7b10: 74 61 74 65 6d 65 6e 74 73 2e 20 49 6e 20 74 68 tatements. In th
7b20: 65 73 65 0a 2a 2a 20 63 61 73 65 73 20 74 68 65 ese.** cases the
7b30: 20 70 61 72 61 6d 65 74 65 72 73 20 61 72 65 20 parameters are
7b40: 6e 61 6d 65 64 20 61 73 20 70 65 72 20 74 68 65 named as per the
7b50: 20 75 73 75 61 6c 20 63 6f 6e 76 65 6e 74 69 6f usual conventio
7b60: 6e 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 55 ns..*/.#define U
7b70: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 NUSED_PARAMETER(
7b80: 78 29 20 28 76 6f 69 64 29 28 78 29 0a 23 64 65 x) (void)(x).#de
7b90: 66 69 6e 65 20 55 4e 55 53 45 44 5f 50 41 52 41 fine UNUSED_PARA
7ba0: 4d 45 54 45 52 32 28 78 2c 79 29 20 55 4e 55 53 METER2(x,y) UNUS
7bb0: 45 44 5f 50 41 52 41 4d 45 54 45 52 28 78 29 2c ED_PARAMETER(x),
7bc0: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 UNUSED_PARAMETER
7bd0: 28 79 29 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 77 61 (y)../*.** Forwa
7be0: 72 64 20 72 65 66 65 72 65 6e 63 65 73 20 74 6f rd references to
7bf0: 20 73 74 72 75 63 74 75 72 65 73 0a 2a 2f 0a 74 structures.*/.t
7c00: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 41 67 ypedef struct Ag
7c10: 67 49 6e 66 6f 20 41 67 67 49 6e 66 6f 3b 0a 74 gInfo AggInfo;.t
7c20: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 41 75 ypedef struct Au
7c30: 74 68 43 6f 6e 74 65 78 74 20 41 75 74 68 43 6f thContext AuthCo
7c40: 6e 74 65 78 74 3b 0a 74 79 70 65 64 65 66 20 73 ntext;.typedef s
7c50: 74 72 75 63 74 20 41 75 74 6f 69 6e 63 49 6e 66 truct AutoincInf
7c60: 6f 20 41 75 74 6f 69 6e 63 49 6e 66 6f 3b 0a 74 o AutoincInfo;.t
7c70: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 42 69 ypedef struct Bi
7c80: 74 76 65 63 20 42 69 74 76 65 63 3b 0a 74 79 70 tvec Bitvec;.typ
7c90: 65 64 65 66 20 73 74 72 75 63 74 20 43 6f 6c 6c edef struct Coll
7ca0: 53 65 71 20 43 6f 6c 6c 53 65 71 3b 0a 74 79 70 Seq CollSeq;.typ
7cb0: 65 64 65 66 20 73 74 72 75 63 74 20 43 6f 6c 75 edef struct Colu
7cc0: 6d 6e 20 43 6f 6c 75 6d 6e 3b 0a 74 79 70 65 64 mn Column;.typed
7cd0: 65 66 20 73 74 72 75 63 74 20 44 62 20 44 62 3b ef struct Db Db;
7ce0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
7cf0: 53 63 68 65 6d 61 20 53 63 68 65 6d 61 3b 0a 74 Schema Schema;.t
7d00: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 45 78 ypedef struct Ex
7d10: 70 72 20 45 78 70 72 3b 0a 74 79 70 65 64 65 66 pr Expr;.typedef
7d20: 20 73 74 72 75 63 74 20 45 78 70 72 4c 69 73 74 struct ExprList
7d30: 20 45 78 70 72 4c 69 73 74 3b 0a 74 79 70 65 64 ExprList;.typed
7d40: 65 66 20 73 74 72 75 63 74 20 45 78 70 72 53 70 ef struct ExprSp
7d50: 61 6e 20 45 78 70 72 53 70 61 6e 3b 0a 74 79 70 an ExprSpan;.typ
7d60: 65 64 65 66 20 73 74 72 75 63 74 20 46 4b 65 79 edef struct FKey
7d70: 20 46 4b 65 79 3b 0a 74 79 70 65 64 65 66 20 73 FKey;.typedef s
7d80: 74 72 75 63 74 20 46 75 6e 63 44 65 73 74 72 75 truct FuncDestru
7d90: 63 74 6f 72 20 46 75 6e 63 44 65 73 74 72 75 63 ctor FuncDestruc
7da0: 74 6f 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 tor;.typedef str
7db0: 75 63 74 20 46 75 6e 63 44 65 66 20 46 75 6e 63 uct FuncDef Func
7dc0: 44 65 66 3b 0a 74 79 70 65 64 65 66 20 73 74 72 Def;.typedef str
7dd0: 75 63 74 20 46 75 6e 63 44 65 66 48 61 73 68 20 uct FuncDefHash
7de0: 46 75 6e 63 44 65 66 48 61 73 68 3b 0a 74 79 70 FuncDefHash;.typ
7df0: 65 64 65 66 20 73 74 72 75 63 74 20 49 64 4c 69 edef struct IdLi
7e00: 73 74 20 49 64 4c 69 73 74 3b 0a 74 79 70 65 64 st IdList;.typed
7e10: 65 66 20 73 74 72 75 63 74 20 49 6e 64 65 78 20 ef struct Index
7e20: 49 6e 64 65 78 3b 0a 74 79 70 65 64 65 66 20 73 Index;.typedef s
7e30: 74 72 75 63 74 20 49 6e 64 65 78 53 61 6d 70 6c truct IndexSampl
7e40: 65 20 49 6e 64 65 78 53 61 6d 70 6c 65 3b 0a 74 e IndexSample;.t
7e50: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 4b 65 ypedef struct Ke
7e60: 79 43 6c 61 73 73 20 4b 65 79 43 6c 61 73 73 3b yClass KeyClass;
7e70: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
7e80: 4b 65 79 49 6e 66 6f 20 4b 65 79 49 6e 66 6f 3b KeyInfo KeyInfo;
7e90: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
7ea0: 4c 6f 6f 6b 61 73 69 64 65 20 4c 6f 6f 6b 61 73 Lookaside Lookas
7eb0: 69 64 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ide;.typedef str
7ec0: 75 63 74 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f uct LookasideSlo
7ed0: 74 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 3b t LookasideSlot;
7ee0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
7ef0: 4d 6f 64 75 6c 65 20 4d 6f 64 75 6c 65 3b 0a 74 Module Module;.t
7f00: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 4e 61 ypedef struct Na
7f10: 6d 65 43 6f 6e 74 65 78 74 20 4e 61 6d 65 43 6f meContext NameCo
7f20: 6e 74 65 78 74 3b 0a 74 79 70 65 64 65 66 20 73 ntext;.typedef s
7f30: 74 72 75 63 74 20 50 61 72 73 65 20 50 61 72 73 truct Parse Pars
7f40: 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 e;.typedef struc
7f50: 74 20 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 t PrintfArgument
7f60: 73 20 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 s PrintfArgument
7f70: 73 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 s;.typedef struc
7f80: 74 20 52 6f 77 53 65 74 20 52 6f 77 53 65 74 3b t RowSet RowSet;
7f90: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
7fa0: 53 61 76 65 70 6f 69 6e 74 20 53 61 76 65 70 6f Savepoint Savepo
7fb0: 69 6e 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 int;.typedef str
7fc0: 75 63 74 20 53 65 6c 65 63 74 20 53 65 6c 65 63 uct Select Selec
7fd0: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
7fe0: 74 20 53 51 4c 69 74 65 54 68 72 65 61 64 20 53 t SQLiteThread S
7ff0: 51 4c 69 74 65 54 68 72 65 61 64 3b 0a 74 79 70 QLiteThread;.typ
8000: 65 64 65 66 20 73 74 72 75 63 74 20 53 65 6c 65 edef struct Sele
8010: 63 74 44 65 73 74 20 53 65 6c 65 63 74 44 65 73 ctDest SelectDes
8020: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
8030: 74 20 53 72 63 4c 69 73 74 20 53 72 63 4c 69 73 t SrcList SrcLis
8040: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
8050: 74 20 53 74 72 41 63 63 75 6d 20 53 74 72 41 63 t StrAccum StrAc
8060: 63 75 6d 3b 0a 74 79 70 65 64 65 66 20 73 74 72 cum;.typedef str
8070: 75 63 74 20 54 61 62 6c 65 20 54 61 62 6c 65 3b uct Table Table;
8080: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8090: 54 61 62 6c 65 4c 6f 63 6b 20 54 61 62 6c 65 4c TableLock TableL
80a0: 6f 63 6b 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ock;.typedef str
80b0: 75 63 74 20 54 6f 6b 65 6e 20 54 6f 6b 65 6e 3b uct Token Token;
80c0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
80d0: 54 72 65 65 56 69 65 77 20 54 72 65 65 56 69 65 TreeView TreeVie
80e0: 77 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 w;.typedef struc
80f0: 74 20 54 72 69 67 67 65 72 20 54 72 69 67 67 65 t Trigger Trigge
8100: 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 r;.typedef struc
8110: 74 20 54 72 69 67 67 65 72 50 72 67 20 54 72 69 t TriggerPrg Tri
8120: 67 67 65 72 50 72 67 3b 0a 74 79 70 65 64 65 66 ggerPrg;.typedef
8130: 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 53 struct TriggerS
8140: 74 65 70 20 54 72 69 67 67 65 72 53 74 65 70 3b tep TriggerStep;
8150: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
8160: 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 55 UnpackedRecord U
8170: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 3b 0a 74 npackedRecord;.t
8180: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 56 54 ypedef struct VT
8190: 61 62 6c 65 20 56 54 61 62 6c 65 3b 0a 74 79 70 able VTable;.typ
81a0: 65 64 65 66 20 73 74 72 75 63 74 20 56 74 61 62 edef struct Vtab
81b0: 43 74 78 20 56 74 61 62 43 74 78 3b 0a 74 79 70 Ctx VtabCtx;.typ
81c0: 65 64 65 66 20 73 74 72 75 63 74 20 57 61 6c 6b edef struct Walk
81d0: 65 72 20 57 61 6c 6b 65 72 3b 0a 74 79 70 65 64 er Walker;.typed
81e0: 65 66 20 73 74 72 75 63 74 20 57 68 65 72 65 49 ef struct WhereI
81f0: 6e 66 6f 20 57 68 65 72 65 49 6e 66 6f 3b 0a 74 nfo WhereInfo;.t
8200: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 57 69 ypedef struct Wi
8210: 74 68 20 57 69 74 68 3b 0a 0a 2f 2a 0a 2a 2a 20 th With;../*.**
8220: 44 65 66 65 72 20 73 6f 75 72 63 69 6e 67 20 76 Defer sourcing v
8230: 64 62 65 2e 68 20 61 6e 64 20 62 74 72 65 65 2e dbe.h and btree.
8240: 68 20 75 6e 74 69 6c 20 61 66 74 65 72 20 74 68 h until after th
8250: 65 20 22 75 38 22 20 61 6e 64 0a 2a 2a 20 22 42 e "u8" and.** "B
8260: 75 73 79 48 61 6e 64 6c 65 72 22 20 74 79 70 65 usyHandler" type
8270: 64 65 66 73 2e 20 76 64 62 65 2e 68 20 61 6c 73 defs. vdbe.h als
8280: 6f 20 72 65 71 75 69 72 65 73 20 61 20 66 65 77 o requires a few
8290: 20 6f 66 20 74 68 65 20 6f 70 61 71 75 65 0a 2a of the opaque.*
82a0: 2a 20 70 6f 69 6e 74 65 72 20 74 79 70 65 73 20 * pointer types
82b0: 28 69 2e 65 2e 20 46 75 6e 63 44 65 66 29 20 64 (i.e. FuncDef) d
82c0: 65 66 69 6e 65 64 20 61 62 6f 76 65 2e 0a 2a 2f efined above..*/
82d0: 0a 23 69 6e 63 6c 75 64 65 20 22 62 74 72 65 65 .#include "btree
82e0: 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 76 64 .h".#include "vd
82f0: 62 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 be.h".#include "
8300: 70 61 67 65 72 2e 68 22 0a 23 69 6e 63 6c 75 64 pager.h".#includ
8310: 65 20 22 70 63 61 63 68 65 2e 68 22 0a 0a 23 69 e "pcache.h"..#i
8320: 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 69 nclude "os.h".#i
8330: 6e 63 6c 75 64 65 20 22 6d 75 74 65 78 2e 68 22 nclude "mutex.h"
8340: 0a 0a 2f 2a 20 57 68 65 6e 20 75 73 69 6e 67 20 ../* When using
8350: 61 20 64 65 66 61 75 6c 74 20 77 61 6c 20 73 61 a default wal sa
8360: 66 65 74 79 20 6c 65 76 65 6c 2c 20 74 68 65 20 fety level, the
8370: 73 61 66 65 74 79 20 6c 65 76 65 6c 20 73 68 6f safety level sho
8380: 75 6c 64 20 6f 6e 6c 79 20 0a 2a 2a 20 63 68 61 uld only .** cha
8390: 6e 67 65 20 77 69 74 68 20 74 68 65 20 6a 6f 75 nge with the jou
83a0: 72 6e 61 6c 20 6d 6f 64 65 20 69 66 20 74 68 65 rnal mode if the
83b0: 20 75 73 65 72 20 68 61 73 6e 27 74 20 6d 61 6e user hasn't man
83c0: 75 61 6c 6c 79 20 73 70 65 63 69 66 69 65 64 20 ually specified
83d0: 0a 2a 2a 20 70 72 61 67 6d 61 20 73 79 6e 63 68 .** pragma synch
83e0: 72 6f 6e 6f 75 73 2c 20 69 66 20 74 68 65 79 20 ronous, if they
83f0: 68 61 76 65 20 74 68 65 20 64 65 66 61 75 6c 74 have the default
8400: 73 20 73 68 6f 75 6c 64 6e 27 74 20 62 65 20 61 s shouldn't be a
8410: 70 70 6c 69 65 64 2e 0a 2a 2a 20 54 68 65 20 53 pplied..** The S
8420: 51 4c 49 54 45 5f 53 41 46 45 54 59 4c 45 56 45 QLITE_SAFETYLEVE
8430: 4c 5f 46 49 58 45 44 20 76 61 6c 75 65 20 69 73 L_FIXED value is
8440: 20 4f 52 65 64 20 69 6e 74 6f 20 74 68 65 20 44 ORed into the D
8450: 62 2d 3e 73 61 66 65 74 79 5f 6c 65 76 65 6c 0a b->safety_level.
8460: 2a 2a 20 66 69 65 6c 64 20 77 68 65 6e 20 74 68 ** field when th
8470: 65 20 75 73 65 72 20 68 61 73 20 73 70 65 63 69 e user has speci
8480: 66 69 65 64 20 61 20 73 79 6e 63 68 72 6f 6e 6f fied a synchrono
8490: 75 73 20 73 65 74 74 69 6e 67 20 76 69 61 20 70 us setting via p
84a0: 72 61 67 6d 61 2e 0a 2a 2f 0a 23 64 65 66 69 6e ragma..*/.#defin
84b0: 65 20 53 51 4c 49 54 45 5f 53 41 46 45 54 59 4c e SQLITE_SAFETYL
84c0: 45 56 45 4c 5f 46 49 58 45 44 20 30 78 31 30 0a EVEL_FIXED 0x10.
84d0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 #define SQLITE_S
84e0: 41 46 45 54 59 4c 45 56 45 4c 5f 56 41 4c 55 45 AFETYLEVEL_VALUE
84f0: 5f 4d 41 53 4b 20 30 78 30 37 0a 23 64 65 66 69 _MASK 0x07.#defi
8500: 6e 65 20 53 51 4c 49 54 45 5f 44 62 53 61 66 65 ne SQLITE_DbSafe
8510: 74 79 4c 65 76 65 6c 56 61 6c 75 65 28 6c 65 76 tyLevelValue(lev
8520: 65 6c 29 20 28 6c 65 76 65 6c 26 53 51 4c 49 54 el) (level&SQLIT
8530: 45 5f 53 41 46 45 54 59 4c 45 56 45 4c 5f 56 41 E_SAFETYLEVEL_VA
8540: 4c 55 45 5f 4d 41 53 4b 29 0a 23 64 65 66 69 6e LUE_MASK).#defin
8550: 65 20 53 51 4c 49 54 45 5f 44 62 53 61 66 65 74 e SQLITE_DbSafet
8560: 79 4c 65 76 65 6c 49 73 46 69 78 65 64 28 6c 65 yLevelIsFixed(le
8570: 76 65 6c 29 20 28 6c 65 76 65 6c 26 53 51 4c 49 vel) (level&SQLI
8580: 54 45 5f 53 41 46 45 54 59 4c 45 56 45 4c 5f 46 TE_SAFETYLEVEL_F
8590: 49 58 45 44 29 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 IXED)../*.** Eac
85a0: 68 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 h database file
85b0: 74 6f 20 62 65 20 61 63 63 65 73 73 65 64 20 62 to be accessed b
85c0: 79 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 y the system is
85d0: 61 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f an instance.** o
85e0: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
85f0: 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 65 72 structure. Ther
8600: 65 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 74 e are normally t
8610: 77 6f 20 6f 66 20 74 68 65 73 65 20 73 74 72 75 wo of these stru
8620: 63 74 75 72 65 73 0a 2a 2a 20 69 6e 20 74 68 65 ctures.** in the
8630: 20 73 71 6c 69 74 65 2e 61 44 62 5b 5d 20 61 72 sqlite.aDb[] ar
8640: 72 61 79 2e 20 20 61 44 62 5b 30 5d 20 69 73 20 ray. aDb[0] is
8650: 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 the main databas
8660: 65 20 66 69 6c 65 20 61 6e 64 0a 2a 2a 20 61 44 e file and.** aD
8670: 62 5b 31 5d 20 69 73 20 74 68 65 20 64 61 74 61 b[1] is the data
8680: 62 61 73 65 20 66 69 6c 65 20 75 73 65 64 20 74 base file used t
8690: 6f 20 68 6f 6c 64 20 74 65 6d 70 6f 72 61 72 79 o hold temporary
86a0: 20 74 61 62 6c 65 73 2e 20 20 41 64 64 69 74 69 tables. Additi
86b0: 6f 6e 61 6c 0a 2a 2a 20 64 61 74 61 62 61 73 65 onal.** database
86c0: 73 20 6d 61 79 20 62 65 20 61 74 74 61 63 68 65 s may be attache
86d0: 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 44 62 20 d..*/.struct Db
86e0: 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b {. char *zName;
86f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 /* Name
8700: 20 6f 66 20 74 68 69 73 20 64 61 74 61 62 61 73 of this databas
8710: 65 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 42 e */. Btree *pB
8720: 74 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 t; /* T
8730: 68 65 20 42 2a 54 72 65 65 20 73 74 72 75 63 74 he B*Tree struct
8740: 75 72 65 20 66 6f 72 20 74 68 69 73 20 64 61 74 ure for this dat
8750: 61 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 abase file */.
8760: 75 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 3b u8 safety_level;
8770: 20 20 20 20 20 2f 2a 20 48 6f 77 20 61 67 67 72 /* How aggr
8780: 65 73 73 69 76 65 20 61 74 20 73 79 6e 63 69 6e essive at syncin
8790: 67 20 64 61 74 61 20 74 6f 20 64 69 73 6b 20 2a g data to disk *
87a0: 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 /. Schema *pSch
87b0: 65 6d 61 3b 20 20 20 20 20 2f 2a 20 50 6f 69 6e ema; /* Poin
87c0: 74 65 72 20 74 6f 20 64 61 74 61 62 61 73 65 20 ter to database
87d0: 73 63 68 65 6d 61 20 28 70 6f 73 73 69 62 6c 79 schema (possibly
87e0: 20 73 68 61 72 65 64 29 20 2a 2f 0a 7d 3b 0a 0a shared) */.};..
87f0: 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 /*.** An instanc
8800: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
8810: 6e 67 20 73 74 72 75 63 74 75 72 65 20 73 74 6f ng structure sto
8820: 72 65 73 20 61 20 64 61 74 61 62 61 73 65 20 73 res a database s
8830: 63 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 73 chema..**.** Mos
8840: 74 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 t Schema objects
8850: 20 61 72 65 20 61 73 73 6f 63 69 61 74 65 64 20 are associated
8860: 77 69 74 68 20 61 20 42 74 72 65 65 2e 20 20 54 with a Btree. T
8870: 68 65 20 65 78 63 65 70 74 69 6f 6e 20 69 73 0a he exception is.
8880: 2a 2a 20 74 68 65 20 53 63 68 65 6d 61 20 66 6f ** the Schema fo
8890: 72 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62 r the TEMP datab
88a0: 61 65 73 20 28 73 71 6c 69 74 65 33 2e 61 44 62 aes (sqlite3.aDb
88b0: 5b 31 5d 29 20 77 68 69 63 68 20 69 73 20 66 72 [1]) which is fr
88c0: 65 65 2d 73 74 61 6e 64 69 6e 67 2e 0a 2a 2a 20 ee-standing..**
88d0: 49 6e 20 73 68 61 72 65 64 20 63 61 63 68 65 20 In shared cache
88e0: 6d 6f 64 65 2c 20 61 20 73 69 6e 67 6c 65 20 53 mode, a single S
88f0: 63 68 65 6d 61 20 6f 62 6a 65 63 74 20 63 61 6e chema object can
8900: 20 62 65 20 73 68 61 72 65 64 20 62 79 20 6d 75 be shared by mu
8910: 6c 74 69 70 6c 65 0a 2a 2a 20 42 74 72 65 65 73 ltiple.** Btrees
8920: 20 74 68 61 74 20 72 65 66 65 72 20 74 6f 20 74 that refer to t
8930: 68 65 20 73 61 6d 65 20 75 6e 64 65 72 6c 79 69 he same underlyi
8940: 6e 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 ng BtShared obje
8950: 63 74 2e 0a 2a 2a 0a 2a 2a 20 53 63 68 65 6d 61 ct..**.** Schema
8960: 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 75 74 objects are aut
8970: 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 61 6c 6c omatically deall
8980: 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68 65 20 ocated when the
8990: 6c 61 73 74 20 42 74 72 65 65 20 74 68 61 74 0a last Btree that.
89a0: 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 20 74 68 ** references th
89b0: 65 6d 20 69 73 20 64 65 73 74 72 6f 79 65 64 2e em is destroyed.
89c0: 20 20 20 54 68 65 20 54 45 4d 50 20 53 63 68 65 The TEMP Sche
89d0: 6d 61 20 69 73 20 6d 61 6e 75 61 6c 6c 79 20 66 ma is manually f
89e0: 72 65 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 reed by.** sqlit
89f0: 65 33 5f 63 6c 6f 73 65 28 29 2e 0a 2a 0a 2a 2a e3_close()..*.**
8a00: 20 41 20 74 68 72 65 61 64 20 6d 75 73 74 20 62 A thread must b
8a10: 65 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 74 65 e holding a mute
8a20: 78 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 73 70 x on the corresp
8a30: 6f 6e 64 69 6e 67 20 42 74 72 65 65 20 69 6e 20 onding Btree in
8a40: 6f 72 64 65 72 0a 2a 2a 20 74 6f 20 61 63 63 65 order.** to acce
8a50: 73 73 20 53 63 68 65 6d 61 20 63 6f 6e 74 65 6e ss Schema conten
8a60: 74 2e 20 20 54 68 69 73 20 69 6d 70 6c 69 65 73 t. This implies
8a70: 20 74 68 61 74 20 74 68 65 20 74 68 72 65 61 64 that the thread
8a80: 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 0a 2a 2a must also be.**
8a90: 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 74 65 78 holding a mutex
8aa0: 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 65 33 20 on the sqlite3
8ab0: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 connection point
8ac0: 65 72 20 74 68 61 74 20 6f 77 6e 73 20 74 68 65 er that owns the
8ad0: 20 42 74 72 65 65 2e 0a 2a 2a 20 46 6f 72 20 61 Btree..** For a
8ae0: 20 54 45 4d 50 20 53 63 68 65 6d 61 2c 20 6f 6e TEMP Schema, on
8af0: 6c 79 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f ly the connectio
8b00: 6e 20 6d 75 74 65 78 20 69 73 20 72 65 71 75 69 n mutex is requi
8b10: 72 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 red..*/.struct S
8b20: 63 68 65 6d 61 20 7b 0a 20 20 69 6e 74 20 73 63 chema {. int sc
8b30: 68 65 6d 61 5f 63 6f 6f 6b 69 65 3b 20 20 20 2f hema_cookie; /
8b40: 2a 20 44 61 74 61 62 61 73 65 20 73 63 68 65 6d * Database schem
8b50: 61 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 a version number
8b60: 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 20 2a for this file *
8b70: 2f 0a 20 20 69 6e 74 20 69 47 65 6e 65 72 61 74 /. int iGenerat
8b80: 69 6f 6e 3b 20 20 20 20 20 2f 2a 20 47 65 6e 65 ion; /* Gene
8b90: 72 61 74 69 6f 6e 20 63 6f 75 6e 74 65 72 2e 20 ration counter.
8ba0: 20 49 6e 63 72 65 6d 65 6e 74 65 64 20 77 69 74 Incremented wit
8bb0: 68 20 65 61 63 68 20 63 68 61 6e 67 65 20 2a 2f h each change */
8bc0: 0a 20 20 48 61 73 68 20 74 62 6c 48 61 73 68 3b . Hash tblHash;
8bd0: 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 74 /* All t
8be0: 61 62 6c 65 73 20 69 6e 64 65 78 65 64 20 62 79 ables indexed by
8bf0: 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 73 68 20 name */. Hash
8c00: 69 64 78 48 61 73 68 3b 20 20 20 20 20 20 20 20 idxHash;
8c10: 2f 2a 20 41 6c 6c 20 28 6e 61 6d 65 64 29 20 69 /* All (named) i
8c20: 6e 64 69 63 65 73 20 69 6e 64 65 78 65 64 20 62 ndices indexed b
8c30: 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 73 68 y name */. Hash
8c40: 20 74 72 69 67 48 61 73 68 3b 20 20 20 20 20 20 trigHash;
8c50: 20 2f 2a 20 41 6c 6c 20 74 72 69 67 67 65 72 73 /* All triggers
8c60: 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d 65 indexed by name
8c70: 20 2a 2f 0a 20 20 48 61 73 68 20 66 6b 65 79 48 */. Hash fkeyH
8c80: 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 41 6c ash; /* Al
8c90: 6c 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 62 l foreign keys b
8ca0: 79 20 72 65 66 65 72 65 6e 63 65 64 20 74 61 62 y referenced tab
8cb0: 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 54 61 62 le name */. Tab
8cc0: 6c 65 20 2a 70 53 65 71 54 61 62 3b 20 20 20 20 le *pSeqTab;
8cd0: 20 20 2f 2a 20 54 68 65 20 73 71 6c 69 74 65 5f /* The sqlite_
8ce0: 73 65 71 75 65 6e 63 65 20 74 61 62 6c 65 20 75 sequence table u
8cf0: 73 65 64 20 62 79 20 41 55 54 4f 49 4e 43 52 45 sed by AUTOINCRE
8d00: 4d 45 4e 54 20 2a 2f 0a 20 20 75 38 20 66 69 6c MENT */. u8 fil
8d10: 65 5f 66 6f 72 6d 61 74 3b 20 20 20 20 20 20 2f e_format; /
8d20: 2a 20 53 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 * Schema format
8d30: 76 65 72 73 69 6f 6e 20 66 6f 72 20 74 68 69 73 version for this
8d40: 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 65 6e file */. u8 en
8d50: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
8d60: 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 6e 67 /* Text encoding
8d70: 20 75 73 65 64 20 62 79 20 74 68 69 73 20 64 61 used by this da
8d80: 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 31 36 20 tabase */. u16
8d90: 73 63 68 65 6d 61 46 6c 61 67 73 3b 20 20 20 20 schemaFlags;
8da0: 20 2f 2a 20 46 6c 61 67 73 20 61 73 73 6f 63 69 /* Flags associ
8db0: 61 74 65 64 20 77 69 74 68 20 74 68 69 73 20 73 ated with this s
8dc0: 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 20 63 chema */. int c
8dd0: 61 63 68 65 5f 73 69 7a 65 3b 20 20 20 20 20 20 ache_size;
8de0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
8df0: 65 73 20 74 6f 20 75 73 65 20 69 6e 20 74 68 65 es to use in the
8e00: 20 63 61 63 68 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a cache */.};../*
8e10: 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 6f 73 .** These macros
8e20: 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 can be used to
8e30: 74 65 73 74 2c 20 73 65 74 2c 20 6f 72 20 63 6c test, set, or cl
8e40: 65 61 72 20 62 69 74 73 20 69 6e 20 74 68 65 0a ear bits in the.
8e50: 2a 2a 20 44 62 2e 70 53 63 68 65 6d 61 2d 3e 66 ** Db.pSchema->f
8e60: 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 lags field..*/.#
8e70: 64 65 66 69 6e 65 20 44 62 48 61 73 50 72 6f 70 define DbHasProp
8e80: 65 72 74 79 28 44 2c 49 2c 50 29 20 20 20 20 20 erty(D,I,P)
8e90: 28 28 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 (((D)->aDb[I].pS
8ea0: 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 46 6c 61 chema->schemaFla
8eb0: 67 73 26 28 50 29 29 3d 3d 28 50 29 29 0a 23 64 gs&(P))==(P)).#d
8ec0: 65 66 69 6e 65 20 44 62 48 61 73 41 6e 79 50 72 efine DbHasAnyPr
8ed0: 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 28 operty(D,I,P) (
8ee0: 28 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 ((D)->aDb[I].pSc
8ef0: 68 65 6d 61 2d 3e 73 63 68 65 6d 61 46 6c 61 67 hema->schemaFlag
8f00: 73 26 28 50 29 29 21 3d 30 29 0a 23 64 65 66 69 s&(P))!=0).#defi
8f10: 6e 65 20 44 62 53 65 74 50 72 6f 70 65 72 74 79 ne DbSetProperty
8f20: 28 44 2c 49 2c 50 29 20 20 20 20 20 28 44 29 2d (D,I,P) (D)-
8f30: 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d >aDb[I].pSchema-
8f40: 3e 73 63 68 65 6d 61 46 6c 61 67 73 7c 3d 28 50 >schemaFlags|=(P
8f50: 29 0a 23 64 65 66 69 6e 65 20 44 62 43 6c 65 61 ).#define DbClea
8f60: 72 50 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 rProperty(D,I,P)
8f70: 20 20 20 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 (D)->aDb[I].p
8f80: 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 46 6c Schema->schemaFl
8f90: 61 67 73 26 3d 7e 28 50 29 0a 0a 2f 2a 0a 2a 2a ags&=~(P)../*.**
8fa0: 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 Allowed values
8fb0: 66 6f 72 20 74 68 65 20 44 42 2e 70 53 63 68 65 for the DB.pSche
8fc0: 6d 61 2d 3e 66 6c 61 67 73 20 66 69 65 6c 64 2e ma->flags field.
8fd0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 44 42 5f 53 63 .**.** The DB_Sc
8fe0: 68 65 6d 61 4c 6f 61 64 65 64 20 66 6c 61 67 20 hemaLoaded flag
8ff0: 69 73 20 73 65 74 20 61 66 74 65 72 20 74 68 65 is set after the
9000: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
9010: 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 72 65 61 has been.** rea
9020: 64 20 69 6e 74 6f 20 69 6e 74 65 72 6e 61 6c 20 d into internal
9030: 68 61 73 68 20 74 61 62 6c 65 73 2e 0a 2a 2a 0a hash tables..**.
9040: 2a 2a 20 44 42 5f 55 6e 72 65 73 65 74 56 69 65 ** DB_UnresetVie
9050: 77 73 20 6d 65 61 6e 73 20 74 68 61 74 20 6f 6e ws means that on
9060: 65 20 6f 72 20 6d 6f 72 65 20 76 69 65 77 73 20 e or more views
9070: 68 61 76 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 have column name
9080: 73 20 74 68 61 74 0a 2a 2a 20 68 61 76 65 20 62 s that.** have b
9090: 65 65 6e 20 66 69 6c 6c 65 64 20 6f 75 74 2e 20 een filled out.
90a0: 20 49 66 20 74 68 65 20 73 63 68 65 6d 61 20 63 If the schema c
90b0: 68 61 6e 67 65 73 2c 20 74 68 65 73 65 20 63 6f hanges, these co
90c0: 6c 75 6d 6e 20 6e 61 6d 65 73 20 6d 69 67 68 74 lumn names might
90d0: 0a 2a 2a 20 63 68 61 6e 67 65 73 20 61 6e 64 20 .** changes and
90e0: 73 6f 20 74 68 65 20 76 69 65 77 20 77 69 6c 6c so the view will
90f0: 20 6e 65 65 64 20 74 6f 20 62 65 20 72 65 73 65 need to be rese
9100: 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 t..*/.#define DB
9110: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 20 20 _SchemaLoaded
9120: 20 30 78 30 30 30 31 20 20 2f 2a 20 54 68 65 20 0x0001 /* The
9130: 73 63 68 65 6d 61 20 68 61 73 20 62 65 65 6e 20 schema has been
9140: 6c 6f 61 64 65 64 20 2a 2f 0a 23 64 65 66 69 6e loaded */.#defin
9150: 65 20 44 42 5f 55 6e 72 65 73 65 74 56 69 65 77 e DB_UnresetView
9160: 73 20 20 20 20 30 78 30 30 30 32 20 20 2f 2a 20 s 0x0002 /*
9170: 53 6f 6d 65 20 76 69 65 77 73 20 68 61 76 65 20 Some views have
9180: 64 65 66 69 6e 65 64 20 63 6f 6c 75 6d 6e 20 6e defined column n
9190: 61 6d 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ames */.#define
91a0: 44 42 5f 45 6d 70 74 79 20 20 20 20 20 20 20 20 DB_Empty
91b0: 20 20 20 30 78 30 30 30 34 20 20 2f 2a 20 54 68 0x0004 /* Th
91c0: 65 20 66 69 6c 65 20 69 73 20 65 6d 70 74 79 20 e file is empty
91d0: 28 6c 65 6e 67 74 68 20 30 20 62 79 74 65 73 29 (length 0 bytes)
91e0: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e */../*.** The n
91f0: 75 6d 62 65 72 20 6f 66 20 64 69 66 66 65 72 65 umber of differe
9200: 6e 74 20 6b 69 6e 64 73 20 6f 66 20 74 68 69 6e nt kinds of thin
9210: 67 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 6c gs that can be l
9220: 69 6d 69 74 65 64 0a 2a 2a 20 75 73 69 6e 67 20 imited.** using
9230: 74 68 65 20 73 71 6c 69 74 65 33 5f 6c 69 6d 69 the sqlite3_limi
9240: 74 28 29 20 69 6e 74 65 72 66 61 63 65 2e 0a 2a t() interface..*
9250: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
9260: 5f 4e 5f 4c 49 4d 49 54 20 28 53 51 4c 49 54 45 _N_LIMIT (SQLITE
9270: 5f 4c 49 4d 49 54 5f 57 4f 52 4b 45 52 5f 54 48 _LIMIT_WORKER_TH
9280: 52 45 41 44 53 2b 31 29 0a 0a 2f 2a 0a 2a 2a 20 READS+1)../*.**
9290: 4c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f 63 Lookaside malloc
92a0: 20 69 73 20 61 20 73 65 74 20 6f 66 20 66 69 78 is a set of fix
92b0: 65 64 2d 73 69 7a 65 20 62 75 66 66 65 72 73 20 ed-size buffers
92c0: 74 68 61 74 20 63 61 6e 20 62 65 20 75 73 65 64 that can be used
92d0: 0a 2a 2a 20 74 6f 20 73 61 74 69 73 66 79 20 73 .** to satisfy s
92e0: 6d 61 6c 6c 20 74 72 61 6e 73 69 65 6e 74 20 6d mall transient m
92f0: 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
9300: 20 72 65 71 75 65 73 74 73 20 66 6f 72 20 6f 62 requests for ob
9310: 6a 65 63 74 73 0a 2a 2a 20 61 73 73 6f 63 69 61 jects.** associa
9320: 74 65 64 20 77 69 74 68 20 61 20 70 61 72 74 69 ted with a parti
9330: 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 63 cular database c
9340: 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 54 68 65 20 onnection. The
9350: 75 73 65 20 6f 66 0a 2a 2a 20 6c 6f 6f 6b 61 73 use of.** lookas
9360: 69 64 65 20 6d 61 6c 6c 6f 63 20 70 72 6f 76 69 ide malloc provi
9370: 64 65 73 20 61 20 73 69 67 6e 69 66 69 63 61 6e des a significan
9380: 74 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 65 6e t performance en
9390: 68 61 6e 63 65 6d 65 6e 74 0a 2a 2a 20 28 61 70 hancement.** (ap
93a0: 70 72 6f 78 20 31 30 25 29 20 62 79 20 61 76 6f prox 10%) by avo
93b0: 69 64 69 6e 67 20 6e 75 6d 65 72 6f 75 73 20 6d iding numerous m
93c0: 61 6c 6c 6f 63 2f 66 72 65 65 20 72 65 71 75 65 alloc/free reque
93d0: 73 74 73 20 77 68 69 6c 65 20 70 61 72 73 69 6e sts while parsin
93e0: 67 0a 2a 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 g.** SQL stateme
93f0: 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4c nts..**.** The L
9400: 6f 6f 6b 61 73 69 64 65 20 73 74 72 75 63 74 75 ookaside structu
9410: 72 65 20 68 6f 6c 64 73 20 63 6f 6e 66 69 67 75 re holds configu
9420: 72 61 74 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 ration informati
9430: 6f 6e 20 61 62 6f 75 74 20 74 68 65 0a 2a 2a 20 on about the.**
9440: 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f 63 lookaside malloc
9450: 20 73 75 62 73 79 73 74 65 6d 2e 20 20 45 61 63 subsystem. Eac
9460: 68 20 61 76 61 69 6c 61 62 6c 65 20 6d 65 6d 6f h available memo
9470: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 69 6e ry allocation in
9480: 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 .** the lookasid
9490: 65 20 73 75 62 73 79 73 74 65 6d 20 69 73 20 73 e subsystem is s
94a0: 74 6f 72 65 64 20 6f 6e 20 61 20 6c 69 6e 6b 65 tored on a linke
94b0: 64 20 6c 69 73 74 20 6f 66 20 4c 6f 6f 6b 61 73 d list of Lookas
94c0: 69 64 65 53 6c 6f 74 0a 2a 2a 20 6f 62 6a 65 63 ideSlot.** objec
94d0: 74 73 2e 0a 2a 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 ts..**.** Lookas
94e0: 69 64 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 ide allocations
94f0: 61 72 65 20 6f 6e 6c 79 20 61 6c 6c 6f 77 65 64 are only allowed
9500: 20 66 6f 72 20 6f 62 6a 65 63 74 73 20 74 68 61 for objects tha
9510: 74 20 61 72 65 20 61 73 73 6f 63 69 61 74 65 64 t are associated
9520: 0a 2a 2a 20 77 69 74 68 20 61 20 70 61 72 74 69 .** with a parti
9530: 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 63 cular database c
9540: 6f 6e 6e 65 63 74 69 6f 6e 2e 20 20 48 65 6e 63 onnection. Henc
9550: 65 2c 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d e, schema inform
9560: 61 74 69 6f 6e 20 63 61 6e 6e 6f 74 0a 2a 2a 20 ation cannot.**
9570: 62 65 20 73 74 6f 72 65 64 20 69 6e 20 6c 6f 6f be stored in loo
9580: 6b 61 73 69 64 65 20 62 65 63 61 75 73 65 20 69 kaside because i
9590: 6e 20 73 68 61 72 65 64 20 63 61 63 68 65 20 6d n shared cache m
95a0: 6f 64 65 20 74 68 65 20 73 63 68 65 6d 61 20 69 ode the schema i
95b0: 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 69 73 nformation.** is
95c0: 20 73 68 61 72 65 64 20 62 79 20 6d 75 6c 74 69 shared by multi
95d0: 70 6c 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e ple database con
95e0: 6e 65 63 74 69 6f 6e 73 2e 20 20 54 68 65 72 65 nections. There
95f0: 66 6f 72 65 2c 20 77 68 69 6c 65 20 70 61 72 73 fore, while pars
9600: 69 6e 67 0a 2a 2a 20 73 63 68 65 6d 61 20 69 6e ing.** schema in
9610: 66 6f 72 6d 61 74 69 6f 6e 2c 20 74 68 65 20 4c formation, the L
9620: 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 ookaside.bEnable
9630: 64 20 66 6c 61 67 20 69 73 20 63 6c 65 61 72 65 d flag is cleare
9640: 64 20 73 6f 20 74 68 61 74 0a 2a 2a 20 6c 6f 6f d so that.** loo
9650: 6b 61 73 69 64 65 20 61 6c 6c 6f 63 61 74 69 6f kaside allocatio
9660: 6e 73 20 61 72 65 20 6e 6f 74 20 75 73 65 64 20 ns are not used
9670: 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 74 68 65 to construct the
9680: 20 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 2e schema objects.
9690: 0a 2a 2f 0a 73 74 72 75 63 74 20 4c 6f 6f 6b 61 .*/.struct Looka
96a0: 73 69 64 65 20 7b 0a 20 20 75 33 32 20 62 44 69 side {. u32 bDi
96b0: 73 61 62 6c 65 3b 20 20 20 20 20 20 20 20 20 20 sable;
96c0: 20 2f 2a 20 4f 6e 6c 79 20 6f 70 65 72 61 74 65 /* Only operate
96d0: 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 77 the lookaside w
96e0: 68 65 6e 20 7a 65 72 6f 20 2a 2f 0a 20 20 75 31 hen zero */. u1
96f0: 36 20 73 7a 3b 20 20 20 20 20 20 20 20 20 20 20 6 sz;
9700: 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 /* Size of
9710: 20 65 61 63 68 20 62 75 66 66 65 72 20 69 6e 20 each buffer in
9720: 62 79 74 65 73 20 2a 2f 0a 20 20 75 38 20 62 4d bytes */. u8 bM
9730: 61 6c 6c 6f 63 65 64 3b 20 20 20 20 20 20 20 20 alloced;
9740: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 70 53 /* True if pS
9750: 74 61 72 74 20 6f 62 74 61 69 6e 65 64 20 66 72 tart obtained fr
9760: 6f 6d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f om sqlite3_mallo
9770: 63 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 c() */. int nOu
9780: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
9790: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 75 /* Number of bu
97a0: 66 66 65 72 73 20 63 75 72 72 65 6e 74 6c 79 20 ffers currently
97b0: 63 68 65 63 6b 65 64 20 6f 75 74 20 2a 2f 0a 20 checked out */.
97c0: 20 69 6e 74 20 6d 78 4f 75 74 3b 20 20 20 20 20 int mxOut;
97d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 48 69 67 68 /* High
97e0: 77 61 74 65 72 20 6d 61 72 6b 20 66 6f 72 20 6e water mark for n
97f0: 4f 75 74 20 2a 2f 0a 20 20 69 6e 74 20 61 6e 53 Out */. int anS
9800: 74 61 74 5b 33 5d 3b 20 20 20 20 20 20 20 20 20 tat[3];
9810: 20 2f 2a 20 30 3a 20 68 69 74 73 2e 20 20 31 3a /* 0: hits. 1:
9820: 20 73 69 7a 65 20 6d 69 73 73 65 73 2e 20 20 32 size misses. 2
9830: 3a 20 66 75 6c 6c 20 6d 69 73 73 65 73 20 2a 2f : full misses */
9840: 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 . LookasideSlot
9850: 20 2a 70 46 72 65 65 3b 20 20 20 2f 2a 20 4c 69 *pFree; /* Li
9860: 73 74 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 st of available
9870: 62 75 66 66 65 72 73 20 2a 2f 0a 20 20 76 6f 69 buffers */. voi
9880: 64 20 2a 70 53 74 61 72 74 3b 20 20 20 20 20 20 d *pStart;
9890: 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 /* First by
98a0: 74 65 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 te of available
98b0: 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a memory space */.
98c0: 20 20 76 6f 69 64 20 2a 70 45 6e 64 3b 20 20 20 void *pEnd;
98d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 /* Fir
98e0: 73 74 20 62 79 74 65 20 70 61 73 74 20 65 6e 64 st byte past end
98f0: 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 73 70 of available sp
9900: 61 63 65 20 2a 2f 0a 7d 3b 0a 73 74 72 75 63 74 ace */.};.struct
9910: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 7b LookasideSlot {
9920: 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 . LookasideSlot
9930: 20 2a 70 4e 65 78 74 3b 20 20 20 20 2f 2a 20 4e *pNext; /* N
9940: 65 78 74 20 62 75 66 66 65 72 20 69 6e 20 74 68 ext buffer in th
9950: 65 20 6c 69 73 74 20 6f 66 20 66 72 65 65 20 62 e list of free b
9960: 75 66 66 65 72 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a uffers */.};../*
9970: 0a 2a 2a 20 41 20 68 61 73 68 20 74 61 62 6c 65 .** A hash table
9980: 20 66 6f 72 20 62 75 69 6c 74 2d 69 6e 20 66 75 for built-in fu
9990: 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f nction definitio
99a0: 6e 73 2e 20 20 28 41 70 70 6c 69 63 61 74 69 6f ns. (Applicatio
99b0: 6e 2d 64 65 66 69 6e 65 64 0a 2a 2a 20 66 75 6e n-defined.** fun
99c0: 63 74 69 6f 6e 73 20 75 73 65 20 61 20 72 65 67 ctions use a reg
99d0: 75 6c 61 72 20 74 61 62 6c 65 20 74 61 62 6c 65 ular table table
99e0: 20 66 72 6f 6d 20 68 61 73 68 2e 68 2e 29 0a 2a from hash.h.).*
99f0: 2a 0a 2a 2a 20 48 61 73 68 20 65 61 63 68 20 46 *.** Hash each F
9a00: 75 6e 63 44 65 66 20 73 74 72 75 63 74 75 72 65 uncDef structure
9a10: 20 69 6e 74 6f 20 6f 6e 65 20 6f 66 20 74 68 65 into one of the
9a20: 20 46 75 6e 63 44 65 66 48 61 73 68 2e 61 5b 5d FuncDefHash.a[]
9a30: 20 73 6c 6f 74 73 2e 0a 2a 2a 20 43 6f 6c 6c 69 slots..** Colli
9a40: 73 69 6f 6e 73 20 61 72 65 20 6f 6e 20 74 68 65 sions are on the
9a50: 20 46 75 6e 63 44 65 66 2e 75 2e 70 48 61 73 68 FuncDef.u.pHash
9a60: 20 63 68 61 69 6e 2e 0a 2a 2f 0a 23 64 65 66 69 chain..*/.#defi
9a70: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 48 ne SQLITE_FUNC_H
9a80: 41 53 48 5f 53 5a 20 32 33 0a 73 74 72 75 63 74 ASH_SZ 23.struct
9a90: 20 46 75 6e 63 44 65 66 48 61 73 68 20 7b 0a 20 FuncDefHash {.
9aa0: 20 46 75 6e 63 44 65 66 20 2a 61 5b 53 51 4c 49 FuncDef *a[SQLI
9ab0: 54 45 5f 46 55 4e 43 5f 48 41 53 48 5f 53 5a 5d TE_FUNC_HASH_SZ]
9ac0: 3b 20 20 20 20 20 20 20 2f 2a 20 48 61 73 68 20 ; /* Hash
9ad0: 74 61 62 6c 65 20 66 6f 72 20 66 75 6e 63 74 69 table for functi
9ae0: 6f 6e 73 20 2a 2f 0a 7d 3b 0a 0a 23 69 66 64 65 ons */.};..#ifde
9af0: 66 20 53 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 f SQLITE_USER_AU
9b00: 54 48 45 4e 54 49 43 41 54 49 4f 4e 0a 2f 2a 0a THENTICATION./*.
9b10: 2a 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 68 ** Information h
9b20: 65 6c 64 20 69 6e 20 74 68 65 20 22 73 71 6c 69 eld in the "sqli
9b30: 74 65 33 22 20 64 61 74 61 62 61 73 65 20 63 6f te3" database co
9b40: 6e 6e 65 63 74 69 6f 6e 20 6f 62 6a 65 63 74 20 nnection object
9b50: 61 6e 64 20 75 73 65 64 0a 2a 2a 20 74 6f 20 6d and used.** to m
9b60: 61 6e 61 67 65 20 75 73 65 72 20 61 75 74 68 65 anage user authe
9b70: 6e 74 69 63 61 74 69 6f 6e 2e 0a 2a 2f 0a 74 79 ntication..*/.ty
9b80: 70 65 64 65 66 20 73 74 72 75 63 74 20 73 71 6c pedef struct sql
9b90: 69 74 65 33 5f 75 73 65 72 61 75 74 68 20 73 71 ite3_userauth sq
9ba0: 6c 69 74 65 33 5f 75 73 65 72 61 75 74 68 3b 0a lite3_userauth;.
9bb0: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 75 struct sqlite3_u
9bc0: 73 65 72 61 75 74 68 20 7b 0a 20 20 75 38 20 61 serauth {. u8 a
9bd0: 75 74 68 4c 65 76 65 6c 3b 20 20 20 20 20 20 20 uthLevel;
9be0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
9bf0: 72 65 6e 74 20 61 75 74 68 65 6e 74 69 63 61 74 rent authenticat
9c00: 69 6f 6e 20 6c 65 76 65 6c 20 2a 2f 0a 20 20 69 ion level */. i
9c10: 6e 74 20 6e 41 75 74 68 50 57 3b 20 20 20 20 20 nt nAuthPW;
9c20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
9c30: 53 69 7a 65 20 6f 66 20 74 68 65 20 7a 41 75 74 Size of the zAut
9c40: 68 50 57 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a hPW in bytes */.
9c50: 20 20 63 68 61 72 20 2a 7a 41 75 74 68 50 57 3b char *zAuthPW;
9c60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9c70: 2f 2a 20 50 61 73 73 77 6f 72 64 20 75 73 65 64 /* Password used
9c80: 20 74 6f 20 61 75 74 68 65 6e 74 69 63 61 74 65 to authenticate
9c90: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 41 75 74 */. char *zAut
9ca0: 68 55 73 65 72 3b 20 20 20 20 20 20 20 20 20 20 hUser;
9cb0: 20 20 20 20 2f 2a 20 55 73 65 72 20 6e 61 6d 65 /* User name
9cc0: 20 75 73 65 64 20 74 6f 20 61 75 74 68 65 6e 74 used to authent
9cd0: 69 63 61 74 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 icate */.};../*
9ce0: 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 Allowed values f
9cf0: 6f 72 20 73 71 6c 69 74 65 33 5f 75 73 65 72 61 or sqlite3_usera
9d00: 75 74 68 2e 61 75 74 68 4c 65 76 65 6c 20 2a 2f uth.authLevel */
9d10: 0a 23 64 65 66 69 6e 65 20 55 41 55 54 48 5f 55 .#define UAUTH_U
9d20: 6e 6b 6e 6f 77 6e 20 20 20 20 20 30 20 20 20 20 nknown 0
9d30: 20 2f 2a 20 41 75 74 68 65 6e 74 69 63 61 74 69 /* Authenticati
9d40: 6f 6e 20 6e 6f 74 20 79 65 74 20 63 68 65 63 6b on not yet check
9d50: 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 41 ed */.#define UA
9d60: 55 54 48 5f 46 61 69 6c 20 20 20 20 20 20 20 20 UTH_Fail
9d70: 31 20 20 20 20 20 2f 2a 20 55 73 65 72 20 61 75 1 /* User au
9d80: 74 68 65 6e 74 69 63 61 74 69 6f 6e 20 66 61 69 thentication fai
9d90: 6c 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 55 led */.#define U
9da0: 41 55 54 48 5f 55 73 65 72 20 20 20 20 20 20 20 AUTH_User
9db0: 20 32 20 20 20 20 20 2f 2a 20 41 75 74 68 65 6e 2 /* Authen
9dc0: 74 69 63 61 74 65 64 20 61 73 20 61 20 6e 6f 72 ticated as a nor
9dd0: 6d 61 6c 20 75 73 65 72 20 2a 2f 0a 23 64 65 66 mal user */.#def
9de0: 69 6e 65 20 55 41 55 54 48 5f 41 64 6d 69 6e 20 ine UAUTH_Admin
9df0: 20 20 20 20 20 20 33 20 20 20 20 20 2f 2a 20 41 3 /* A
9e00: 75 74 68 65 6e 74 69 63 61 74 65 64 20 61 73 20 uthenticated as
9e10: 61 6e 20 61 64 6d 69 6e 69 73 74 72 61 74 6f 72 an administrator
9e20: 20 2a 2f 0a 0a 2f 2a 20 46 75 6e 63 74 69 6f 6e */../* Function
9e30: 73 20 75 73 65 64 20 6f 6e 6c 79 20 62 79 20 75 s used only by u
9e40: 73 65 72 20 61 75 74 68 6f 72 69 7a 61 74 69 6f ser authorizatio
9e50: 6e 20 6c 6f 67 69 63 20 2a 2f 0a 69 6e 74 20 73 n logic */.int s
9e60: 71 6c 69 74 65 33 55 73 65 72 41 75 74 68 54 61 qlite3UserAuthTa
9e70: 62 6c 65 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 ble(const char*)
9e80: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 73 65 ;.int sqlite3Use
9e90: 72 41 75 74 68 43 68 65 63 6b 4c 6f 67 69 6e 28 rAuthCheckLogin(
9ea0: 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 sqlite3*,const c
9eb0: 68 61 72 2a 2c 75 38 2a 29 3b 0a 76 6f 69 64 20 har*,u8*);.void
9ec0: 73 71 6c 69 74 65 33 55 73 65 72 41 75 74 68 49 sqlite3UserAuthI
9ed0: 6e 69 74 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 nit(sqlite3*);.v
9ee0: 6f 69 64 20 73 71 6c 69 74 65 33 43 72 79 70 74 oid sqlite3Crypt
9ef0: 46 75 6e 63 28 73 71 6c 69 74 65 33 5f 63 6f 6e Func(sqlite3_con
9f00: 74 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 text*,int,sqlite
9f10: 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 0a 23 65 6e 3_value**);..#en
9f20: 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 55 53 dif /* SQLITE_US
9f30: 45 52 5f 41 55 54 48 45 4e 54 49 43 41 54 49 4f ER_AUTHENTICATIO
9f40: 4e 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 74 79 70 65 N */../*.** type
9f50: 64 65 66 20 66 6f 72 20 74 68 65 20 61 75 74 68 def for the auth
9f60: 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61 orization callba
9f70: 63 6b 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a ck function..*/.
9f80: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 53 #ifdef SQLITE_US
9f90: 45 52 5f 41 55 54 48 45 4e 54 49 43 41 54 49 4f ER_AUTHENTICATIO
9fa0: 4e 0a 20 20 74 79 70 65 64 65 66 20 69 6e 74 20 N. typedef int
9fb0: 28 2a 73 71 6c 69 74 65 33 5f 78 61 75 74 68 29 (*sqlite3_xauth)
9fc0: 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 (void*,int,const
9fd0: 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 char*,const cha
9fe0: 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 0a r*,const char*,.
9ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 63 c
a010: 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 onst char*, cons
a020: 74 20 63 68 61 72 2a 29 3b 0a 23 65 6c 73 65 0a t char*);.#else.
a030: 20 20 74 79 70 65 64 65 66 20 69 6e 74 20 28 2a typedef int (*
a040: 73 71 6c 69 74 65 33 5f 78 61 75 74 68 29 28 76 sqlite3_xauth)(v
a050: 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 oid*,int,const c
a060: 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a har*,const char*
a070: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 0a 20 20 ,const char*,.
a080: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a090: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
a0a0: 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 st char*);.#endi
a0b0: 66 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 64 f.../*.** Each d
a0c0: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
a0d0: 6f 6e 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 on is an instanc
a0e0: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
a0f0: 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f ng structure..*/
a100: 0a 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 20 .struct sqlite3
a110: 7b 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 {. sqlite3_vfs
a120: 2a 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 20 *pVfs;
a130: 20 20 2f 2a 20 4f 53 20 49 6e 74 65 72 66 61 63 /* OS Interfac
a140: 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 56 64 e */. struct Vd
a150: 62 65 20 2a 70 56 64 62 65 3b 20 20 20 20 20 20 be *pVdbe;
a160: 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
a170: 61 63 74 69 76 65 20 76 69 72 74 75 61 6c 20 6d active virtual m
a180: 61 63 68 69 6e 65 73 20 2a 2f 0a 20 20 43 6f 6c achines */. Col
a190: 6c 53 65 71 20 2a 70 44 66 6c 74 43 6f 6c 6c 3b lSeq *pDfltColl;
a1a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
a1b0: 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 e default collat
a1c0: 69 6e 67 20 73 65 71 75 65 6e 63 65 20 28 42 49 ing sequence (BI
a1d0: 4e 41 52 59 29 20 2a 2f 0a 20 20 73 71 6c 69 74 NARY) */. sqlit
a1e0: 65 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b e3_mutex *mutex;
a1f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e /* Conn
a200: 65 63 74 69 6f 6e 20 6d 75 74 65 78 20 2a 2f 0a ection mutex */.
a210: 20 20 44 62 20 2a 61 44 62 3b 20 20 20 20 20 20 Db *aDb;
a220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a230: 2f 2a 20 41 6c 6c 20 62 61 63 6b 65 6e 64 73 20 /* All backends
a240: 2a 2f 0a 20 20 69 6e 74 20 6e 44 62 3b 20 20 20 */. int nDb;
a250: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a260: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
a270: 62 61 63 6b 65 6e 64 73 20 63 75 72 72 65 6e 74 backends current
a280: 6c 79 20 69 6e 20 75 73 65 20 2a 2f 0a 20 20 69 ly in use */. i
a290: 6e 74 20 66 6c 61 67 73 3b 20 20 20 20 20 20 20 nt flags;
a2a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
a2b0: 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 66 6c Miscellaneous fl
a2c0: 61 67 73 2e 20 53 65 65 20 62 65 6c 6f 77 20 2a ags. See below *
a2d0: 2f 0a 20 20 69 36 34 20 6c 61 73 74 52 6f 77 69 /. i64 lastRowi
a2e0: 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 d;
a2f0: 20 20 2f 2a 20 52 4f 57 49 44 20 6f 66 20 6d 6f /* ROWID of mo
a300: 73 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 st recent insert
a310: 20 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f 0a (see above) */.
a320: 20 20 69 36 34 20 73 7a 4d 6d 61 70 3b 20 20 20 i64 szMmap;
a330: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a340: 2f 2a 20 44 65 66 61 75 6c 74 20 6d 6d 61 70 5f /* Default mmap_
a350: 73 69 7a 65 20 73 65 74 74 69 6e 67 20 2a 2f 0a size setting */.
a360: 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6f unsigned int o
a370: 70 65 6e 46 6c 61 67 73 3b 20 20 20 20 20 20 20 penFlags;
a380: 2f 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 /* Flags passed
a390: 74 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 to sqlite3_vfs.x
a3a0: 4f 70 65 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 Open() */. int
a3b0: 65 72 72 43 6f 64 65 3b 20 20 20 20 20 20 20 20 errCode;
a3c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 /* Mos
a3d0: 74 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 63 t recent error c
a3e0: 6f 64 65 20 28 53 51 4c 49 54 45 5f 2a 29 20 2a ode (SQLITE_*) *
a3f0: 2f 0a 20 20 69 6e 74 20 65 72 72 4d 61 73 6b 3b /. int errMask;
a400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a410: 20 20 2f 2a 20 26 20 72 65 73 75 6c 74 20 63 6f /* & result co
a420: 64 65 73 20 77 69 74 68 20 74 68 69 73 20 62 65 des with this be
a430: 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 2a fore returning *
a440: 2f 0a 20 20 75 31 36 20 64 62 4f 70 74 46 6c 61 /. u16 dbOptFla
a450: 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 gs;
a460: 20 20 2f 2a 20 46 6c 61 67 73 20 74 6f 20 65 6e /* Flags to en
a470: 61 62 6c 65 2f 64 69 73 61 62 6c 65 20 6f 70 74 able/disable opt
a480: 69 6d 69 7a 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 imizations */.
a490: 75 38 20 65 6e 63 3b 20 20 20 20 20 20 20 20 20 u8 enc;
a4a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
a4b0: 20 54 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a Text encoding *
a4c0: 2f 0a 20 20 75 38 20 61 75 74 6f 43 6f 6d 6d 69 /. u8 autoCommi
a4d0: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
a4e0: 20 20 2f 2a 20 54 68 65 20 61 75 74 6f 2d 63 6f /* The auto-co
a4f0: 6d 6d 69 74 20 66 6c 61 67 2e 20 2a 2f 0a 20 20 mmit flag. */.
a500: 75 38 20 74 65 6d 70 5f 73 74 6f 72 65 3b 20 20 u8 temp_store;
a510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
a520: 20 31 3a 20 66 69 6c 65 20 32 3a 20 6d 65 6d 6f 1: file 2: memo
a530: 72 79 20 30 3a 20 64 65 66 61 75 6c 74 20 2a 2f ry 0: default */
a540: 0a 20 20 75 38 20 6d 61 6c 6c 6f 63 46 61 69 6c . u8 mallocFail
a550: 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ed;
a560: 20 2f 2a 20 54 72 75 65 20 69 66 20 77 65 20 68 /* True if we h
a570: 61 76 65 20 73 65 65 6e 20 61 20 6d 61 6c 6c 6f ave seen a mallo
a580: 63 20 66 61 69 6c 75 72 65 20 2a 2f 0a 20 20 75 c failure */. u
a590: 38 20 62 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 3b 8 bBenignMalloc;
a5a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
a5b0: 44 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 4f Do not require O
a5c0: 4f 4d 73 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 OMs if true */.
a5d0: 20 75 38 20 64 66 6c 74 4c 6f 63 6b 4d 6f 64 65 u8 dfltLockMode
a5e0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
a5f0: 2a 20 44 65 66 61 75 6c 74 20 6c 6f 63 6b 69 6e * Default lockin
a600: 67 2d 6d 6f 64 65 20 66 6f 72 20 61 74 74 61 63 g-mode for attac
a610: 68 65 64 20 64 62 73 20 2a 2f 0a 20 20 73 69 67 hed dbs */. sig
a620: 6e 65 64 20 63 68 61 72 20 6e 65 78 74 41 75 74 ned char nextAut
a630: 6f 76 61 63 3b 20 20 20 20 20 20 2f 2a 20 41 75 ovac; /* Au
a640: 74 6f 76 61 63 20 73 65 74 74 69 6e 67 20 61 66 tovac setting af
a650: 74 65 72 20 56 41 43 55 55 4d 20 69 66 20 3e 3d ter VACUUM if >=
a660: 30 20 2a 2f 0a 20 20 75 38 20 73 75 70 70 72 65 0 */. u8 suppre
a670: 73 73 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 ssErr;
a680: 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 69 /* Do not i
a690: 73 73 75 65 20 65 72 72 6f 72 20 6d 65 73 73 61 ssue error messa
a6a0: 67 65 73 20 69 66 20 74 72 75 65 20 2a 2f 0a 20 ges if true */.
a6b0: 20 75 38 20 76 74 61 62 4f 6e 43 6f 6e 66 6c 69 u8 vtabOnConfli
a6c0: 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ct; /
a6d0: 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72 * Value to retur
a6e0: 6e 20 66 6f 72 20 73 33 5f 76 74 61 62 5f 6f 6e n for s3_vtab_on
a6f0: 5f 63 6f 6e 66 6c 69 63 74 28 29 20 2a 2f 0a 20 _conflict() */.
a700: 20 75 38 20 69 73 54 72 61 6e 73 61 63 74 69 6f u8 isTransactio
a710: 6e 53 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 2f nSavepoint; /
a720: 2a 20 54 72 75 65 20 69 66 20 74 68 65 20 6f 75 * True if the ou
a730: 74 65 72 6d 6f 73 74 20 73 61 76 65 70 6f 69 6e termost savepoin
a740: 74 20 69 73 20 61 20 54 53 20 2a 2f 0a 20 20 69 t is a TS */. i
a750: 6e 74 20 6e 65 78 74 50 61 67 65 73 69 7a 65 3b nt nextPagesize;
a760: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
a770: 50 61 67 65 73 69 7a 65 20 61 66 74 65 72 20 56 Pagesize after V
a780: 41 43 55 55 4d 20 69 66 20 3e 30 20 2a 2f 0a 20 ACUUM if >0 */.
a790: 20 75 33 32 20 6d 61 67 69 63 3b 20 20 20 20 20 u32 magic;
a7a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
a7b0: 2a 20 4d 61 67 69 63 20 6e 75 6d 62 65 72 20 66 * Magic number f
a7c0: 6f 72 20 64 65 74 65 63 74 20 6c 69 62 72 61 72 or detect librar
a7d0: 79 20 6d 69 73 75 73 65 20 2a 2f 0a 20 20 69 6e y misuse */. in
a7e0: 74 20 6e 43 68 61 6e 67 65 3b 20 20 20 20 20 20 t nChange;
a7f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
a800: 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 62 79 alue returned by
a810: 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73 sqlite3_changes
a820: 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 54 6f 74 () */. int nTot
a830: 61 6c 43 68 61 6e 67 65 3b 20 20 20 20 20 20 20 alChange;
a840: 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 72 /* Value r
a850: 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74 eturned by sqlit
a860: 65 33 5f 74 6f 74 61 6c 5f 63 68 61 6e 67 65 73 e3_total_changes
a870: 28 29 20 2a 2f 0a 20 20 69 6e 74 20 61 4c 69 6d () */. int aLim
a880: 69 74 5b 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 it[SQLITE_N_LIMI
a890: 54 5d 3b 20 20 20 2f 2a 20 4c 69 6d 69 74 73 20 T]; /* Limits
a8a0: 2a 2f 0a 20 20 69 6e 74 20 6e 4d 61 78 53 6f 72 */. int nMaxSor
a8b0: 74 65 72 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 terMmap;
a8c0: 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 73 69 /* Maximum si
a8d0: 7a 65 20 6f 66 20 72 65 67 69 6f 6e 73 20 6d 61 ze of regions ma
a8e0: 70 70 65 64 20 62 79 20 73 6f 72 74 65 72 20 2a pped by sorter *
a8f0: 2f 0a 20 20 73 74 72 75 63 74 20 73 71 6c 69 74 /. struct sqlit
a900: 65 33 49 6e 69 74 49 6e 66 6f 20 7b 20 20 20 20 e3InitInfo {
a910: 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e /* Information
a920: 20 75 73 65 64 20 64 75 72 69 6e 67 20 69 6e 69 used during ini
a930: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 2a 2f 0a 20 tialization */.
a940: 20 20 20 69 6e 74 20 6e 65 77 54 6e 75 6d 3b 20 int newTnum;
a950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
a960: 2a 20 52 6f 6f 74 70 61 67 65 20 6f 66 20 74 61 * Rootpage of ta
a970: 62 6c 65 20 62 65 69 6e 67 20 69 6e 69 74 69 61 ble being initia
a980: 6c 69 7a 65 64 20 2a 2f 0a 20 20 20 20 75 38 20 lized */. u8
a990: 69 44 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 iDb;
a9a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 /* Whic
a9b0: 68 20 64 62 20 66 69 6c 65 20 69 73 20 62 65 69 h db file is bei
a9c0: 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a ng initialized *
a9d0: 2f 0a 20 20 20 20 75 38 20 62 75 73 79 3b 20 20 /. u8 busy;
a9e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a9f0: 20 20 2f 2a 20 54 52 55 45 20 69 66 20 63 75 72 /* TRUE if cur
aa00: 72 65 6e 74 6c 79 20 69 6e 69 74 69 61 6c 69 7a rently initializ
aa10: 69 6e 67 20 2a 2f 0a 20 20 20 20 75 38 20 6f 72 ing */. u8 or
aa20: 70 68 61 6e 54 72 69 67 67 65 72 3b 20 20 20 20 phanTrigger;
aa30: 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 73 /* Last s
aa40: 74 61 74 65 6d 65 6e 74 20 69 73 20 6f 72 70 68 tatement is orph
aa50: 61 6e 65 64 20 54 45 4d 50 20 74 72 69 67 67 65 aned TEMP trigge
aa60: 72 20 2a 2f 0a 20 20 20 20 75 38 20 69 6d 70 6f r */. u8 impo
aa70: 73 74 65 72 54 61 62 6c 65 3b 20 20 20 20 20 20 sterTable;
aa80: 20 20 20 20 20 2f 2a 20 42 75 69 6c 64 69 6e 67 /* Building
aa90: 20 61 6e 20 69 6d 70 6f 73 74 65 72 20 74 61 62 an imposter tab
aaa0: 6c 65 20 2a 2f 0a 20 20 7d 20 69 6e 69 74 3b 0a le */. } init;.
aab0: 20 20 69 6e 74 20 6e 56 64 62 65 41 63 74 69 76 int nVdbeActiv
aac0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
aad0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 56 44 42 /* Number of VDB
aae0: 45 73 20 63 75 72 72 65 6e 74 6c 79 20 72 75 6e Es currently run
aaf0: 6e 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 ning */. int nV
ab00: 64 62 65 52 65 61 64 3b 20 20 20 20 20 20 20 20 dbeRead;
ab10: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
ab20: 72 20 6f 66 20 61 63 74 69 76 65 20 56 44 42 45 r of active VDBE
ab30: 73 20 74 68 61 74 20 72 65 61 64 20 6f 72 20 77 s that read or w
ab40: 72 69 74 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 rite */. int nV
ab50: 64 62 65 57 72 69 74 65 3b 20 20 20 20 20 20 20 dbeWrite;
ab60: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
ab70: 72 20 6f 66 20 61 63 74 69 76 65 20 56 44 42 45 r of active VDBE
ab80: 73 20 74 68 61 74 20 72 65 61 64 20 61 6e 64 20 s that read and
ab90: 77 72 69 74 65 20 2a 2f 0a 20 20 69 6e 74 20 6e write */. int n
aba0: 56 64 62 65 45 78 65 63 3b 20 20 20 20 20 20 20 VdbeExec;
abb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
abc0: 65 72 20 6f 66 20 6e 65 73 74 65 64 20 63 61 6c er of nested cal
abd0: 6c 73 20 74 6f 20 56 64 62 65 45 78 65 63 28 29 ls to VdbeExec()
abe0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 44 65 73 74 */. int nVDest
abf0: 72 6f 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 roy;
ac00: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
ac10: 20 61 63 74 69 76 65 20 4f 50 5f 56 44 65 73 74 active OP_VDest
ac20: 72 6f 79 20 6f 70 65 72 61 74 69 6f 6e 73 20 2a roy operations *
ac30: 2f 0a 20 20 69 6e 74 20 6e 45 78 74 65 6e 73 69 /. int nExtensi
ac40: 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 on;
ac50: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c /* Number of l
ac60: 6f 61 64 65 64 20 65 78 74 65 6e 73 69 6f 6e 73 oaded extensions
ac70: 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 2a 61 45 78 */. void **aEx
ac80: 74 65 6e 73 69 6f 6e 3b 20 20 20 20 20 20 20 20 tension;
ac90: 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 /* Array of
aca0: 73 68 61 72 65 64 20 6c 69 62 72 61 72 79 20 68 shared library h
acb0: 61 6e 64 6c 65 73 20 2a 2f 0a 20 20 76 6f 69 64 andles */. void
acc0: 20 28 2a 78 54 72 61 63 65 29 28 76 6f 69 64 2a (*xTrace)(void*
acd0: 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 20 20 ,const char*);
ace0: 20 20 20 20 20 20 2f 2a 20 54 72 61 63 65 20 66 /* Trace f
acf0: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 unction */. voi
ad00: 64 20 2a 70 54 72 61 63 65 41 72 67 3b 20 20 20 d *pTraceArg;
ad10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ad20: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 /* Argume
ad30: 6e 74 20 74 6f 20 74 68 65 20 74 72 61 63 65 20 nt to the trace
ad40: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f function */. vo
ad50: 69 64 20 28 2a 78 50 72 6f 66 69 6c 65 29 28 76 id (*xProfile)(v
ad60: 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a oid*,const char*
ad70: 2c 75 36 34 29 3b 20 20 2f 2a 20 50 72 6f 66 69 ,u64); /* Profi
ad80: 6c 69 6e 67 20 66 75 6e 63 74 69 6f 6e 20 2a 2f ling function */
ad90: 0a 20 20 76 6f 69 64 20 2a 70 50 72 6f 66 69 6c . void *pProfil
ada0: 65 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 eArg;
adb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
adc0: 41 72 67 75 6d 65 6e 74 20 74 6f 20 70 72 6f 66 Argument to prof
add0: 69 6c 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a ile function */.
ade0: 20 20 76 6f 69 64 20 2a 70 43 6f 6d 6d 69 74 41 void *pCommitA
adf0: 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 rg;
ae00: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 /* Argument
ae10: 74 6f 20 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 to xCommitCallba
ae20: 63 6b 28 29 20 2a 2f 0a 20 20 69 6e 74 20 28 2a ck() */. int (*
ae30: 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 29 xCommitCallback)
ae40: 28 76 6f 69 64 2a 29 3b 20 20 20 20 2f 2a 20 49 (void*); /* I
ae50: 6e 76 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 nvoked at every
ae60: 63 6f 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 commit. */. voi
ae70: 64 20 2a 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b d *pRollbackArg;
ae80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
ae90: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 52 * Argument to xR
aea0: 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 ollbackCallback(
aeb0: 29 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 52 ) */. void (*xR
aec0: 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 29 ollbackCallback)
aed0: 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 49 6e 76 6f (void*); /* Invo
aee0: 6b 65 64 20 61 74 20 65 76 65 72 79 20 63 6f 6d ked at every com
aef0: 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a mit. */. void *
af00: 70 55 70 64 61 74 65 41 72 67 3b 0a 20 20 76 6f pUpdateArg;. vo
af10: 69 64 20 28 2a 78 55 70 64 61 74 65 43 61 6c 6c id (*xUpdateCall
af20: 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 2c back)(void*,int,
af30: 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e const char*,con
af40: 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 5f st char*,sqlite_
af50: 69 6e 74 36 34 29 3b 0a 23 69 66 6e 64 65 66 20 int64);.#ifndef
af60: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a SQLITE_OMIT_WAL.
af70: 20 20 69 6e 74 20 28 2a 78 57 61 6c 43 61 6c 6c int (*xWalCall
af80: 62 61 63 6b 29 28 76 6f 69 64 20 2a 2c 20 73 71 back)(void *, sq
af90: 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 20 63 lite3 *, const c
afa0: 68 61 72 20 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 har *, int);. v
afb0: 6f 69 64 20 2a 70 57 61 6c 41 72 67 3b 0a 23 65 oid *pWalArg;.#e
afc0: 6e 64 69 66 0a 20 20 76 6f 69 64 28 2a 78 43 6f ndif. void(*xCo
afd0: 6c 6c 4e 65 65 64 65 64 29 28 76 6f 69 64 2a 2c llNeeded)(void*,
afe0: 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 65 sqlite3*,int eTe
aff0: 78 74 52 65 70 2c 63 6f 6e 73 74 20 63 68 61 72 xtRep,const char
b000: 2a 29 3b 0a 20 20 76 6f 69 64 28 2a 78 43 6f 6c *);. void(*xCol
b010: 6c 4e 65 65 64 65 64 31 36 29 28 76 6f 69 64 2a lNeeded16)(void*
b020: 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 65 54 ,sqlite3*,int eT
b030: 65 78 74 52 65 70 2c 63 6f 6e 73 74 20 76 6f 69 extRep,const voi
b040: 64 2a 29 3b 0a 20 20 76 6f 69 64 20 2a 70 43 6f d*);. void *pCo
b050: 6c 6c 4e 65 65 64 65 64 41 72 67 3b 0a 20 20 73 llNeededArg;. s
b060: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 45 qlite3_value *pE
b070: 72 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 rr; /*
b080: 4d 6f 73 74 20 72 65 63 65 6e 74 20 65 72 72 6f Most recent erro
b090: 72 20 6d 65 73 73 61 67 65 20 2a 2f 0a 20 20 75 r message */. u
b0a0: 6e 69 6f 6e 20 7b 0a 20 20 20 20 76 6f 6c 61 74 nion {. volat
b0b0: 69 6c 65 20 69 6e 74 20 69 73 49 6e 74 65 72 72 ile int isInterr
b0c0: 75 70 74 65 64 3b 20 2f 2a 20 54 72 75 65 20 69 upted; /* True i
b0d0: 66 20 73 71 6c 69 74 65 33 5f 69 6e 74 65 72 72 f sqlite3_interr
b0e0: 75 70 74 20 68 61 73 20 62 65 65 6e 20 63 61 6c upt has been cal
b0f0: 6c 65 64 20 2a 2f 0a 20 20 20 20 64 6f 75 62 6c led */. doubl
b100: 65 20 6e 6f 74 55 73 65 64 31 3b 20 20 20 20 20 e notUsed1;
b110: 20 20 20 20 20 20 20 2f 2a 20 53 70 61 63 65 72 /* Spacer
b120: 20 2a 2f 0a 20 20 7d 20 75 31 3b 0a 20 20 4c 6f */. } u1;. Lo
b130: 6f 6b 61 73 69 64 65 20 6c 6f 6f 6b 61 73 69 64 okaside lookasid
b140: 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c e; /* L
b150: 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c 6f 63 20 ookaside malloc
b160: 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 2a 2f configuration */
b170: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
b180: 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 OMIT_AUTHORIZATI
b190: 4f 4e 0a 20 20 73 71 6c 69 74 65 33 5f 78 61 75 ON. sqlite3_xau
b1a0: 74 68 20 78 41 75 74 68 3b 20 20 20 20 20 20 20 th xAuth;
b1b0: 20 20 20 2f 2a 20 41 63 63 65 73 73 20 61 75 74 /* Access aut
b1c0: 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75 6e 63 74 horization funct
b1d0: 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ion */. void *p
b1e0: 41 75 74 68 41 72 67 3b 20 20 20 20 20 20 20 20 AuthArg;
b1f0: 20 20 20 20 20 20 20 2f 2a 20 31 73 74 20 61 72 /* 1st ar
b200: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 61 63 gument to the ac
b210: 63 65 73 73 20 61 75 74 68 20 66 75 6e 63 74 69 cess auth functi
b220: 6f 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 on */.#endif.#if
b230: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
b240: 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c 42 41 _PROGRESS_CALLBA
b250: 43 4b 0a 20 20 69 6e 74 20 28 2a 78 50 72 6f 67 CK. int (*xProg
b260: 72 65 73 73 29 28 76 6f 69 64 20 2a 29 3b 20 20 ress)(void *);
b270: 20 20 20 2f 2a 20 54 68 65 20 70 72 6f 67 72 65 /* The progre
b280: 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 ss callback */.
b290: 20 76 6f 69 64 20 2a 70 50 72 6f 67 72 65 73 73 void *pProgress
b2a0: 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 2f Arg; /
b2b0: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 * Argument to th
b2c0: 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 e progress callb
b2d0: 61 63 6b 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 ack */. unsigne
b2e0: 64 20 6e 50 72 6f 67 72 65 73 73 4f 70 73 3b 20 d nProgressOps;
b2f0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
b300: 20 6f 66 20 6f 70 63 6f 64 65 73 20 66 6f 72 20 of opcodes for
b310: 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 61 63 progress callbac
b320: 6b 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 6e k */.#endif.#ifn
b330: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
b340: 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69 VIRTUALTABLE. i
b350: 6e 74 20 6e 56 54 72 61 6e 73 3b 20 20 20 20 20 nt nVTrans;
b360: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b370: 41 6c 6c 6f 63 61 74 65 64 20 73 69 7a 65 20 6f Allocated size o
b380: 66 20 61 56 54 72 61 6e 73 20 2a 2f 0a 20 20 48 f aVTrans */. H
b390: 61 73 68 20 61 4d 6f 64 75 6c 65 3b 20 20 20 20 ash aModule;
b3a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
b3b0: 70 6f 70 75 6c 61 74 65 64 20 62 79 20 73 71 6c populated by sql
b3c0: 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f 64 75 ite3_create_modu
b3d0: 6c 65 28 29 20 2a 2f 0a 20 20 56 74 61 62 43 74 le() */. VtabCt
b3e0: 78 20 2a 70 56 74 61 62 43 74 78 3b 20 20 20 20 x *pVtabCtx;
b3f0: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 /* Conte
b400: 78 74 20 66 6f 72 20 61 63 74 69 76 65 20 76 74 xt for active vt
b410: 61 62 20 63 6f 6e 6e 65 63 74 2f 63 72 65 61 74 ab connect/creat
b420: 65 20 2a 2f 0a 20 20 56 54 61 62 6c 65 20 2a 2a e */. VTable **
b430: 61 56 54 72 61 6e 73 3b 20 20 20 20 20 20 20 20 aVTrans;
b440: 20 20 20 20 20 2f 2a 20 56 69 72 74 75 61 6c 20 /* Virtual
b450: 74 61 62 6c 65 73 20 77 69 74 68 20 6f 70 65 6e tables with open
b460: 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 2a 2f transactions */
b470: 0a 20 20 56 54 61 62 6c 65 20 2a 70 44 69 73 63 . VTable *pDisc
b480: 6f 6e 6e 65 63 74 3b 20 20 20 20 2f 2a 20 44 69 onnect; /* Di
b490: 73 63 6f 6e 6e 65 63 74 20 74 68 65 73 65 20 69 sconnect these i
b4a0: 6e 20 6e 65 78 74 20 73 71 6c 69 74 65 33 5f 70 n next sqlite3_p
b4b0: 72 65 70 61 72 65 28 29 20 2a 2f 0a 23 65 6e 64 repare() */.#end
b4c0: 69 66 0a 20 20 48 61 73 68 20 61 46 75 6e 63 3b if. Hash aFunc;
b4d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b4e0: 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 /* Hash table
b4f0: 20 6f 66 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 66 of connection f
b500: 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 48 61 unctions */. Ha
b510: 73 68 20 61 43 6f 6c 6c 53 65 71 3b 20 20 20 20 sh aCollSeq;
b520: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
b530: 6c 6c 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 ll collating seq
b540: 75 65 6e 63 65 73 20 2a 2f 0a 20 20 42 75 73 79 uences */. Busy
b550: 48 61 6e 64 6c 65 72 20 62 75 73 79 48 61 6e 64 Handler busyHand
b560: 6c 65 72 3b 20 20 20 20 20 20 2f 2a 20 42 75 73 ler; /* Bus
b570: 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 y callback */.
b580: 44 62 20 61 44 62 53 74 61 74 69 63 5b 32 5d 3b Db aDbStatic[2];
b590: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
b5a0: 20 53 74 61 74 69 63 20 73 70 61 63 65 20 66 6f Static space fo
b5b0: 72 20 74 68 65 20 32 20 64 65 66 61 75 6c 74 20 r the 2 default
b5c0: 62 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 53 61 backends */. Sa
b5d0: 76 65 70 6f 69 6e 74 20 2a 70 53 61 76 65 70 6f vepoint *pSavepo
b5e0: 69 6e 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c int; /* L
b5f0: 69 73 74 20 6f 66 20 61 63 74 69 76 65 20 73 61 ist of active sa
b600: 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e vepoints */. in
b610: 74 20 62 75 73 79 54 69 6d 65 6f 75 74 3b 20 20 t busyTimeout;
b620: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 /* B
b630: 75 73 79 20 68 61 6e 64 6c 65 72 20 74 69 6d 65 usy handler time
b640: 6f 75 74 2c 20 69 6e 20 6d 73 65 63 20 2a 2f 0a out, in msec */.
b650: 20 20 69 6e 74 20 6e 53 61 76 65 70 6f 69 6e 74 int nSavepoint
b660: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
b670: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e 6f 6e /* Number of non
b680: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 61 76 -transaction sav
b690: 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 6e 74 epoints */. int
b6a0: 20 6e 53 74 61 74 65 6d 65 6e 74 3b 20 20 20 20 nStatement;
b6b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
b6c0: 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 20 73 mber of nested s
b6d0: 74 61 74 65 6d 65 6e 74 2d 74 72 61 6e 73 61 63 tatement-transac
b6e0: 74 69 6f 6e 73 20 20 2a 2f 0a 20 20 69 36 34 20 tions */. i64
b6f0: 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 20 20 nDeferredCons;
b700: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 74 /* Net
b710: 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 deferred constr
b720: 61 69 6e 74 73 20 74 68 69 73 20 74 72 61 6e 73 aints this trans
b730: 61 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 69 36 34 action. */. i64
b740: 20 6e 44 65 66 65 72 72 65 64 49 6d 6d 43 6f 6e nDeferredImmCon
b750: 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 s; /* Ne
b760: 74 20 64 65 66 65 72 72 65 64 20 69 6d 6d 65 64 t deferred immed
b770: 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 iate constraints
b780: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 42 79 74 */. int *pnByt
b790: 65 73 46 72 65 65 64 3b 20 20 20 20 20 20 20 20 esFreed;
b7a0: 20 20 20 20 2f 2a 20 49 66 20 6e 6f 74 20 4e 55 /* If not NU
b7b0: 4c 4c 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 LL, increment th
b7c0: 69 73 20 69 6e 20 44 62 46 72 65 65 28 29 20 2a is in DbFree() *
b7d0: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f /.#ifdef SQLITE_
b7e0: 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f ENABLE_UNLOCK_NO
b7f0: 54 49 46 59 0a 20 20 2f 2a 20 54 68 65 20 66 6f TIFY. /* The fo
b800: 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 62 6c 65 llowing variable
b810: 73 20 61 72 65 20 61 6c 6c 20 70 72 6f 74 65 63 s are all protec
b820: 74 65 64 20 62 79 20 74 68 65 20 53 54 41 54 49 ted by the STATI
b830: 43 5f 4d 41 53 54 45 52 0a 20 20 2a 2a 20 6d 75 C_MASTER. ** mu
b840: 74 65 78 2c 20 6e 6f 74 20 62 79 20 73 71 6c 69 tex, not by sqli
b850: 74 65 33 2e 6d 75 74 65 78 2e 20 54 68 65 79 20 te3.mutex. They
b860: 61 72 65 20 75 73 65 64 20 62 79 20 63 6f 64 65 are used by code
b870: 20 69 6e 20 6e 6f 74 69 66 79 2e 63 2e 0a 20 20 in notify.c..
b880: 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 2e 70 **. ** When X.p
b890: 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 63 74 69 6f 6e UnlockConnection
b8a0: 3d 3d 59 2c 20 74 68 61 74 20 6d 65 61 6e 73 20 ==Y, that means
b8b0: 74 68 61 74 20 58 20 69 73 20 77 61 69 74 69 6e that X is waitin
b8c0: 67 20 66 6f 72 20 59 20 74 6f 0a 20 20 2a 2a 20 g for Y to. **
b8d0: 75 6e 6c 6f 63 6b 20 73 6f 20 74 68 61 74 20 69 unlock so that i
b8e0: 74 20 63 61 6e 20 70 72 6f 63 65 65 64 2e 0a 20 t can proceed..
b8f0: 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 6e 20 58 2e **. ** When X.
b900: 70 42 6c 6f 63 6b 69 6e 67 43 6f 6e 6e 65 63 74 pBlockingConnect
b910: 69 6f 6e 3d 3d 59 2c 20 74 68 61 74 20 6d 65 61 ion==Y, that mea
b920: 6e 73 20 74 68 61 74 20 73 6f 6d 65 74 68 69 6e ns that somethin
b930: 67 20 74 68 61 74 20 58 20 74 72 69 65 64 0a 20 g that X tried.
b940: 20 2a 2a 20 74 72 69 65 64 20 74 6f 20 64 6f 20 ** tried to do
b950: 72 65 63 65 6e 74 6c 79 20 66 61 69 6c 65 64 20 recently failed
b960: 77 69 74 68 20 61 6e 20 53 51 4c 49 54 45 5f 4c with an SQLITE_L
b970: 4f 43 4b 45 44 20 65 72 72 6f 72 20 64 75 65 20 OCKED error due
b980: 74 6f 20 6c 6f 63 6b 73 0a 20 20 2a 2a 20 68 65 to locks. ** he
b990: 6c 64 20 62 79 20 59 2e 0a 20 20 2a 2f 0a 20 20 ld by Y.. */.
b9a0: 73 71 6c 69 74 65 33 20 2a 70 42 6c 6f 63 6b 69 sqlite3 *pBlocki
b9b0: 6e 67 43 6f 6e 6e 65 63 74 69 6f 6e 3b 20 2f 2a ngConnection; /*
b9c0: 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 68 61 74 Connection that
b9d0: 20 63 61 75 73 65 64 20 53 51 4c 49 54 45 5f 4c caused SQLITE_L
b9e0: 4f 43 4b 45 44 20 2a 2f 0a 20 20 73 71 6c 69 74 OCKED */. sqlit
b9f0: 65 33 20 2a 70 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 e3 *pUnlockConne
ba00: 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 ction;
ba10: 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e 20 74 /* Connection t
ba20: 6f 20 77 61 74 63 68 20 66 6f 72 20 75 6e 6c 6f o watch for unlo
ba30: 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 55 ck */. void *pU
ba40: 6e 6c 6f 63 6b 41 72 67 3b 20 20 20 20 20 20 20 nlockArg;
ba50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
ba60: 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 55 6e Argument to xUn
ba70: 6c 6f 63 6b 4e 6f 74 69 66 79 20 2a 2f 0a 20 20 lockNotify */.
ba80: 76 6f 69 64 20 28 2a 78 55 6e 6c 6f 63 6b 4e 6f void (*xUnlockNo
ba90: 74 69 66 79 29 28 76 6f 69 64 20 2a 2a 2c 20 69 tify)(void **, i
baa0: 6e 74 29 3b 20 20 2f 2a 20 55 6e 6c 6f 63 6b 20 nt); /* Unlock
bab0: 6e 6f 74 69 66 79 20 63 61 6c 6c 62 61 63 6b 20 notify callback
bac0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 4e */. sqlite3 *pN
bad0: 65 78 74 42 6c 6f 63 6b 65 64 3b 20 20 20 20 20 extBlocked;
bae0: 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 6c 69 /* Next in li
baf0: 73 74 20 6f 66 20 61 6c 6c 20 62 6c 6f 63 6b 65 st of all blocke
bb00: 64 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 2a 2f d connections */
bb10: 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 .#endif.#ifdef S
bb20: 51 4c 49 54 45 5f 55 53 45 52 5f 41 55 54 48 45 QLITE_USER_AUTHE
bb30: 4e 54 49 43 41 54 49 4f 4e 0a 20 20 73 71 6c 69 NTICATION. sqli
bb40: 74 65 33 5f 75 73 65 72 61 75 74 68 20 61 75 74 te3_userauth aut
bb50: 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 h; /* Use
bb60: 72 20 61 75 74 68 65 6e 74 69 63 61 74 69 6f 6e r authentication
bb70: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a information */.
bb80: 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a #endif.};../*.**
bb90: 20 41 20 6d 61 63 72 6f 20 74 6f 20 64 69 73 63 A macro to disc
bba0: 6f 76 65 72 20 74 68 65 20 65 6e 63 6f 64 69 6e over the encodin
bbb0: 67 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 2e g of a database.
bbc0: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 43 48 45 .*/.#define SCHE
bbd0: 4d 41 5f 45 4e 43 28 64 62 29 20 28 28 64 62 29 MA_ENC(db) ((db)
bbe0: 2d 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 6d 61 ->aDb[0].pSchema
bbf0: 2d 3e 65 6e 63 29 0a 23 64 65 66 69 6e 65 20 45 ->enc).#define E
bc00: 4e 43 28 64 62 29 20 20 20 20 20 20 20 20 28 28 NC(db) ((
bc10: 64 62 29 2d 3e 65 6e 63 29 0a 0a 2f 2a 0a 2a 2a db)->enc)../*.**
bc20: 20 50 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 Possible values
bc30: 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 65 33 for the sqlite3
bc40: 2e 66 6c 61 67 73 2e 0a 2a 2f 0a 23 64 65 66 69 .flags..*/.#defi
bc50: 6e 65 20 53 51 4c 49 54 45 5f 56 64 62 65 54 72 ne SQLITE_VdbeTr
bc60: 61 63 65 20 20 20 20 20 20 30 78 30 30 30 30 30 ace 0x00000
bc70: 30 30 31 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 001 /* True to
bc80: 74 72 61 63 65 20 56 44 42 45 20 65 78 65 63 75 trace VDBE execu
bc90: 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tion */.#define
bca0: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 SQLITE_InternCha
bcb0: 6e 67 65 73 20 20 30 78 30 30 30 30 30 30 30 32 nges 0x00000002
bcc0: 20 20 2f 2a 20 55 6e 63 6f 6d 6d 69 74 74 65 64 /* Uncommitted
bcd0: 20 48 61 73 68 20 74 61 62 6c 65 20 63 68 61 6e Hash table chan
bce0: 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ges */.#define S
bcf0: 51 4c 49 54 45 5f 46 75 6c 6c 43 6f 6c 4e 61 6d QLITE_FullColNam
bd00: 65 73 20 20 20 30 78 30 30 30 30 30 30 30 34 20 es 0x00000004
bd10: 20 2f 2a 20 53 68 6f 77 20 66 75 6c 6c 20 63 6f /* Show full co
bd20: 6c 75 6d 6e 20 6e 61 6d 65 73 20 6f 6e 20 53 45 lumn names on SE
bd30: 4c 45 43 54 20 2a 2f 0a 23 64 65 66 69 6e 65 20 LECT */.#define
bd40: 53 51 4c 49 54 45 5f 46 75 6c 6c 46 53 79 6e 63 SQLITE_FullFSync
bd50: 20 20 20 20 20 20 30 78 30 30 30 30 30 30 30 38 0x00000008
bd60: 20 20 2f 2a 20 55 73 65 20 66 75 6c 6c 20 66 73 /* Use full fs
bd70: 79 6e 63 20 6f 6e 20 74 68 65 20 62 61 63 6b 65 ync on the backe
bd80: 6e 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 nd */.#define SQ
bd90: 4c 49 54 45 5f 43 6b 70 74 46 75 6c 6c 46 53 79 LITE_CkptFullFSy
bda0: 6e 63 20 20 30 78 30 30 30 30 30 30 31 30 20 20 nc 0x00000010
bdb0: 2f 2a 20 55 73 65 20 66 75 6c 6c 20 66 73 79 6e /* Use full fsyn
bdc0: 63 20 66 6f 72 20 63 68 65 63 6b 70 6f 69 6e 74 c for checkpoint
bdd0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
bde0: 54 45 5f 43 61 63 68 65 53 70 69 6c 6c 20 20 20 TE_CacheSpill
bdf0: 20 20 30 78 30 30 30 30 30 30 32 30 20 20 2f 2a 0x00000020 /*
be00: 20 4f 4b 20 74 6f 20 73 70 69 6c 6c 20 70 61 67 OK to spill pag
be10: 65 72 20 63 61 63 68 65 20 2a 2f 0a 23 64 65 66 er cache */.#def
be20: 69 6e 65 20 53 51 4c 49 54 45 5f 53 68 6f 72 74 ine SQLITE_Short
be30: 43 6f 6c 4e 61 6d 65 73 20 20 30 78 30 30 30 30 ColNames 0x0000
be40: 30 30 34 30 20 20 2f 2a 20 53 68 6f 77 20 73 68 0040 /* Show sh
be50: 6f 72 74 20 63 6f 6c 75 6d 6e 73 20 6e 61 6d 65 ort columns name
be60: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
be70: 49 54 45 5f 43 6f 75 6e 74 52 6f 77 73 20 20 20 ITE_CountRows
be80: 20 20 20 30 78 30 30 30 30 30 30 38 30 20 20 2f 0x00000080 /
be90: 2a 20 43 6f 75 6e 74 20 72 6f 77 73 20 63 68 61 * Count rows cha
bea0: 6e 67 65 64 20 62 79 20 49 4e 53 45 52 54 2c 20 nged by INSERT,
beb0: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 */.
bec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
bee0: 20 20 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 44 DELETE, or UPD
bef0: 41 54 45 20 61 6e 64 20 72 65 74 75 72 6e 20 2a ATE and return *
bf00: 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 /.
bf10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bf20: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 /*
bf30: 20 74 68 65 20 63 6f 75 6e 74 20 75 73 69 6e 67 the count using
bf40: 20 61 20 63 61 6c 6c 62 61 63 6b 2e 20 2a 2f 0a a callback. */.
bf50: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e #define SQLITE_N
bf60: 75 6c 6c 43 61 6c 6c 62 61 63 6b 20 20 20 30 78 ullCallback 0x
bf70: 30 30 30 30 30 31 30 30 20 20 2f 2a 20 49 6e 76 00000100 /* Inv
bf80: 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63 6b oke the callback
bf90: 20 6f 6e 63 65 20 69 66 20 74 68 65 20 2a 2f 0a once if the */.
bfa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bfb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
bfc0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 20 20 72 /* r
bfd0: 65 73 75 6c 74 20 73 65 74 20 69 73 20 65 6d 70 esult set is emp
bfe0: 74 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ty */.#define SQ
bff0: 4c 49 54 45 5f 53 71 6c 54 72 61 63 65 20 20 20 LITE_SqlTrace
c000: 20 20 20 20 30 78 30 30 30 30 30 32 30 30 20 20 0x00000200
c010: 2f 2a 20 44 65 62 75 67 20 70 72 69 6e 74 20 53 /* Debug print S
c020: 51 4c 20 61 73 20 69 74 20 65 78 65 63 75 74 65 QL as it execute
c030: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
c040: 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e 67 20 ITE_VdbeListing
c050: 20 20 20 30 78 30 30 30 30 30 34 30 30 20 20 2f 0x00000400 /
c060: 2a 20 44 65 62 75 67 20 6c 69 73 74 69 6e 67 73 * Debug listings
c070: 20 6f 66 20 56 44 42 45 20 70 72 6f 67 72 61 6d of VDBE program
c080: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
c090: 49 54 45 5f 57 72 69 74 65 53 63 68 65 6d 61 20 ITE_WriteSchema
c0a0: 20 20 20 30 78 30 30 30 30 30 38 30 30 20 20 2f 0x00000800 /
c0b0: 2a 20 4f 4b 20 74 6f 20 75 70 64 61 74 65 20 53 * OK to update S
c0c0: 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 2a 2f 0a QLITE_MASTER */.
c0d0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 #define SQLITE_V
c0e0: 64 62 65 41 64 64 6f 70 54 72 61 63 65 20 30 78 dbeAddopTrace 0x
c0f0: 30 30 30 30 31 30 30 30 20 20 2f 2a 20 54 72 61 00001000 /* Tra
c100: 63 65 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 ce sqlite3VdbeAd
c110: 64 4f 70 28 29 20 63 61 6c 6c 73 20 2a 2f 0a 23 dOp() calls */.#
c120: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 49 67 define SQLITE_Ig
c130: 6e 6f 72 65 43 68 65 63 6b 73 20 20 20 30 78 30 noreChecks 0x0
c140: 30 30 30 32 30 30 30 20 20 2f 2a 20 44 6f 20 6e 0002000 /* Do n
c150: 6f 74 20 65 6e 66 6f 72 63 65 20 63 68 65 63 6b ot enforce check
c160: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
c170: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 52 #define SQLITE_R
c180: 65 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 20 30 eadUncommitted 0
c190: 78 30 30 30 34 30 30 30 20 20 2f 2a 20 46 6f 72 x0004000 /* For
c1a0: 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d 6f shared-cache mo
c1b0: 64 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 de */.#define SQ
c1c0: 4c 49 54 45 5f 4c 65 67 61 63 79 46 69 6c 65 46 LITE_LegacyFileF
c1d0: 6d 74 20 20 30 78 30 30 30 30 38 30 30 30 20 20 mt 0x00008000
c1e0: 2f 2a 20 43 72 65 61 74 65 20 6e 65 77 20 64 61 /* Create new da
c1f0: 74 61 62 61 73 65 73 20 69 6e 20 66 6f 72 6d 61 tabases in forma
c200: 74 20 31 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 t 1 */.#define S
c210: 51 4c 49 54 45 5f 52 65 63 6f 76 65 72 79 4d 6f QLITE_RecoveryMo
c220: 64 65 20 20 20 30 78 30 30 30 31 30 30 30 30 20 de 0x00010000
c230: 20 2f 2a 20 49 67 6e 6f 72 65 20 73 63 68 65 6d /* Ignore schem
c240: 61 20 65 72 72 6f 72 73 20 2a 2f 0a 23 64 65 66 a errors */.#def
c250: 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 76 65 72 ine SQLITE_Rever
c260: 73 65 4f 72 64 65 72 20 20 20 30 78 30 30 30 32 seOrder 0x0002
c270: 30 30 30 30 20 20 2f 2a 20 52 65 76 65 72 73 65 0000 /* Reverse
c280: 20 75 6e 6f 72 64 65 72 65 64 20 53 45 4c 45 43 unordered SELEC
c290: 54 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 Ts */.#define SQ
c2a0: 4c 49 54 45 5f 52 65 63 54 72 69 67 67 65 72 73 LITE_RecTriggers
c2b0: 20 20 20 20 30 78 30 30 30 34 30 30 30 30 20 20 0x00040000
c2c0: 2f 2a 20 45 6e 61 62 6c 65 20 72 65 63 75 72 73 /* Enable recurs
c2d0: 69 76 65 20 74 72 69 67 67 65 72 73 20 2a 2f 0a ive triggers */.
c2e0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
c2f0: 6f 72 65 69 67 6e 4b 65 79 73 20 20 20 20 30 78 oreignKeys 0x
c300: 30 30 30 38 30 30 30 30 20 20 2f 2a 20 45 6e 66 00080000 /* Enf
c310: 6f 72 63 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 orce foreign key
c320: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 20 2a 2f constraints */
c330: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
c340: 41 75 74 6f 49 6e 64 65 78 20 20 20 20 20 20 30 AutoIndex 0
c350: 78 30 30 31 30 30 30 30 30 20 20 2f 2a 20 45 6e x00100000 /* En
c360: 61 62 6c 65 20 61 75 74 6f 6d 61 74 69 63 20 69 able automatic i
c370: 6e 64 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 6e ndexes */.#defin
c380: 65 20 53 51 4c 49 54 45 5f 50 72 65 66 65 72 42 e SQLITE_PreferB
c390: 75 69 6c 74 69 6e 20 20 30 78 30 30 32 30 30 30 uiltin 0x002000
c3a0: 30 30 20 20 2f 2a 20 50 72 65 66 65 72 65 6e 63 00 /* Preferenc
c3b0: 65 20 74 6f 20 62 75 69 6c 74 2d 69 6e 20 66 75 e to built-in fu
c3c0: 6e 63 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ncs */.#define S
c3d0: 51 4c 49 54 45 5f 4c 6f 61 64 45 78 74 65 6e 73 QLITE_LoadExtens
c3e0: 69 6f 6e 20 20 30 78 30 30 34 30 30 30 30 30 20 ion 0x00400000
c3f0: 20 2f 2a 20 45 6e 61 62 6c 65 20 6c 6f 61 64 5f /* Enable load_
c400: 65 78 74 65 6e 73 69 6f 6e 20 2a 2f 0a 23 64 65 extension */.#de
c410: 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 6e 61 62 fine SQLITE_Enab
c420: 6c 65 54 72 69 67 67 65 72 20 20 30 78 30 30 38 leTrigger 0x008
c430: 30 30 30 30 30 20 20 2f 2a 20 54 72 75 65 20 74 00000 /* True t
c440: 6f 20 65 6e 61 62 6c 65 20 74 72 69 67 67 65 72 o enable trigger
c450: 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c s */.#define SQL
c460: 49 54 45 5f 44 65 66 65 72 46 4b 73 20 20 20 20 ITE_DeferFKs
c470: 20 20 20 30 78 30 31 30 30 30 30 30 30 20 20 2f 0x01000000 /
c480: 2a 20 44 65 66 65 72 20 61 6c 6c 20 46 4b 20 63 * Defer all FK c
c490: 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 23 64 onstraints */.#d
c4a0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 51 75 65 efine SQLITE_Que
c4b0: 72 79 4f 6e 6c 79 20 20 20 20 20 20 30 78 30 32 ryOnly 0x02
c4c0: 30 30 30 30 30 30 20 20 2f 2a 20 44 69 73 61 62 000000 /* Disab
c4d0: 6c 65 20 64 61 74 61 62 61 73 65 20 63 68 61 6e le database chan
c4e0: 67 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ges */.#define S
c4f0: 51 4c 49 54 45 5f 56 64 62 65 45 51 50 20 20 20 QLITE_VdbeEQP
c500: 20 20 20 20 20 30 78 30 34 30 30 30 30 30 30 20 0x04000000
c510: 20 2f 2a 20 44 65 62 75 67 20 45 58 50 4c 41 49 /* Debug EXPLAI
c520: 4e 20 51 55 45 52 59 20 50 4c 41 4e 20 2a 2f 0a N QUERY PLAN */.
c530: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 56 #define SQLITE_V
c540: 61 63 75 75 6d 20 20 20 20 20 20 20 20 20 30 78 acuum 0x
c550: 30 38 30 30 30 30 30 30 20 20 2f 2a 20 43 75 72 08000000 /* Cur
c560: 72 65 6e 74 6c 79 20 69 6e 20 61 20 56 41 43 55 rently in a VACU
c570: 55 4d 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 UM */.#define SQ
c580: 4c 49 54 45 5f 43 65 6c 6c 53 69 7a 65 43 6b 20 LITE_CellSizeCk
c590: 20 20 20 20 30 78 31 30 30 30 30 30 30 30 20 20 0x10000000
c5a0: 2f 2a 20 43 68 65 63 6b 20 62 74 72 65 65 20 63 /* Check btree c
c5b0: 65 6c 6c 20 73 69 7a 65 73 20 6f 6e 20 6c 6f 61 ell sizes on loa
c5c0: 64 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 42 69 74 d */.../*.** Bit
c5d0: 73 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 s of the sqlite3
c5e0: 2e 64 62 4f 70 74 46 6c 61 67 73 20 66 69 65 6c .dbOptFlags fiel
c5f0: 64 20 74 68 61 74 20 61 72 65 20 75 73 65 64 20 d that are used
c600: 62 79 20 74 68 65 0a 2a 2a 20 73 71 6c 69 74 65 by the.** sqlite
c610: 33 5f 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 53 3_test_control(S
c620: 51 4c 49 54 45 5f 54 45 53 54 43 54 52 4c 5f 4f QLITE_TESTCTRL_O
c630: 50 54 49 4d 49 5a 41 54 49 4f 4e 53 2c 2e 2e 2e PTIMIZATIONS,...
c640: 29 20 69 6e 74 65 72 66 61 63 65 20 74 6f 0a 2a ) interface to.*
c650: 2a 20 73 65 6c 65 63 74 69 76 65 6c 79 20 64 69 * selectively di
c660: 73 61 62 6c 65 20 76 61 72 69 6f 75 73 20 6f 70 sable various op
c670: 74 69 6d 69 7a 61 74 69 6f 6e 73 2e 0a 2a 2f 0a timizations..*/.
c680: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 51 #define SQLITE_Q
c690: 75 65 72 79 46 6c 61 74 74 65 6e 65 72 20 30 78 ueryFlattener 0x
c6a0: 30 30 30 31 20 20 20 2f 2a 20 51 75 65 72 79 20 0001 /* Query
c6b0: 66 6c 61 74 74 65 6e 69 6e 67 20 2a 2f 0a 23 64 flattening */.#d
c6c0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6f 6c efine SQLITE_Col
c6d0: 75 6d 6e 43 61 63 68 65 20 20 20 20 30 78 30 30 umnCache 0x00
c6e0: 30 32 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 63 02 /* Column c
c6f0: 61 63 68 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ache */.#define
c700: 53 51 4c 49 54 45 5f 47 72 6f 75 70 42 79 4f 72 SQLITE_GroupByOr
c710: 64 65 72 20 20 20 30 78 30 30 30 34 20 20 20 2f der 0x0004 /
c720: 2a 20 47 52 4f 55 50 42 59 20 63 6f 76 65 72 20 * GROUPBY cover
c730: 6f 66 20 4f 52 44 45 52 42 59 20 2a 2f 0a 23 64 of ORDERBY */.#d
c740: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 61 63 efine SQLITE_Fac
c750: 74 6f 72 4f 75 74 43 6f 6e 73 74 20 30 78 30 30 torOutConst 0x00
c760: 30 38 20 20 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 08 /* Constant
c770: 20 66 61 63 74 6f 72 69 6e 67 20 2a 2f 0a 2f 2a factoring */./*
c780: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c790: 6e 6f 74 20 75 73 65 64 20 20 20 20 30 78 30 30 not used 0x00
c7a0: 31 30 20 20 20 2f 2f 20 57 61 73 3a 20 53 51 4c 10 // Was: SQL
c7b0: 49 54 45 5f 49 64 78 52 65 61 6c 41 73 49 6e 74 ITE_IdxRealAsInt
c7c0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
c7d0: 54 45 5f 44 69 73 74 69 6e 63 74 4f 70 74 20 20 TE_DistinctOpt
c7e0: 20 20 30 78 30 30 32 30 20 20 20 2f 2a 20 44 49 0x0020 /* DI
c7f0: 53 54 49 4e 43 54 20 75 73 69 6e 67 20 69 6e 64 STINCT using ind
c800: 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 exes */.#define
c810: 53 51 4c 49 54 45 5f 43 6f 76 65 72 49 64 78 53 SQLITE_CoverIdxS
c820: 63 61 6e 20 20 20 30 78 30 30 34 30 20 20 20 2f can 0x0040 /
c830: 2a 20 43 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 * Covering index
c840: 20 73 63 61 6e 73 20 2a 2f 0a 23 64 65 66 69 6e scans */.#defin
c850: 65 20 53 51 4c 49 54 45 5f 4f 72 64 65 72 42 79 e SQLITE_OrderBy
c860: 49 64 78 4a 6f 69 6e 20 30 78 30 30 38 30 20 20 IdxJoin 0x0080
c870: 20 2f 2a 20 4f 52 44 45 52 20 42 59 20 6f 66 20 /* ORDER BY of
c880: 6a 6f 69 6e 73 20 76 69 61 20 69 6e 64 65 78 20 joins via index
c890: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
c8a0: 45 5f 53 75 62 71 43 6f 72 6f 75 74 69 6e 65 20 E_SubqCoroutine
c8b0: 20 30 78 30 31 30 30 20 20 20 2f 2a 20 45 76 61 0x0100 /* Eva
c8c0: 6c 75 61 74 65 20 73 75 62 71 75 65 72 69 65 73 luate subqueries
c8d0: 20 61 73 20 63 6f 72 6f 75 74 69 6e 65 73 20 2a as coroutines *
c8e0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
c8f0: 5f 54 72 61 6e 73 69 74 69 76 65 20 20 20 20 20 _Transitive
c900: 30 78 30 32 30 30 20 20 20 2f 2a 20 54 72 61 6e 0x0200 /* Tran
c910: 73 69 74 69 76 65 20 63 6f 6e 73 74 72 61 69 6e sitive constrain
c920: 74 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ts */.#define SQ
c930: 4c 49 54 45 5f 4f 6d 69 74 4e 6f 6f 70 4a 6f 69 LITE_OmitNoopJoi
c940: 6e 20 20 20 30 78 30 34 30 30 20 20 20 2f 2a 20 n 0x0400 /*
c950: 4f 6d 69 74 20 75 6e 75 73 65 64 20 74 61 62 6c Omit unused tabl
c960: 65 73 20 69 6e 20 6a 6f 69 6e 73 20 2a 2f 0a 23 es in joins */.#
c970: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 53 74 define SQLITE_St
c980: 61 74 33 34 20 20 20 20 20 20 20 20 20 30 78 30 at34 0x0
c990: 38 30 30 20 20 20 2f 2a 20 55 73 65 20 53 54 41 800 /* Use STA
c9a0: 54 33 20 6f 72 20 53 54 41 54 34 20 64 61 74 61 T3 or STAT4 data
c9b0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
c9c0: 54 45 5f 43 75 72 73 6f 72 48 69 6e 74 73 20 20 TE_CursorHints
c9d0: 20 20 30 78 32 30 30 30 20 20 20 2f 2a 20 41 64 0x2000 /* Ad
c9e0: 64 20 4f 50 5f 43 75 72 73 6f 72 48 69 6e 74 20 d OP_CursorHint
c9f0: 6f 70 63 6f 64 65 73 20 2a 2f 0a 23 64 65 66 69 opcodes */.#defi
ca00: 6e 65 20 53 51 4c 49 54 45 5f 41 6c 6c 4f 70 74 ne SQLITE_AllOpt
ca10: 73 20 20 20 20 20 20 20 20 30 78 66 66 66 66 20 s 0xffff
ca20: 20 20 2f 2a 20 41 6c 6c 20 6f 70 74 69 6d 69 7a /* All optimiz
ca30: 61 74 69 6f 6e 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a ations */../*.**
ca40: 20 4d 61 63 72 6f 73 20 66 6f 72 20 74 65 73 74 Macros for test
ca50: 69 6e 67 20 77 68 65 74 68 65 72 20 6f 72 20 6e ing whether or n
ca60: 6f 74 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 73 ot optimizations
ca70: 20 61 72 65 20 65 6e 61 62 6c 65 64 20 6f 72 20 are enabled or
ca80: 64 69 73 61 62 6c 65 64 2e 0a 2a 2f 0a 23 69 66 disabled..*/.#if
ca90: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
caa0: 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 23 64 _BUILTIN_TEST.#d
cab0: 65 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 efine Optimizati
cac0: 6f 6e 44 69 73 61 62 6c 65 64 28 64 62 2c 20 6d onDisabled(db, m
cad0: 61 73 6b 29 20 20 28 28 28 64 62 29 2d 3e 64 62 ask) (((db)->db
cae0: 4f 70 74 46 6c 61 67 73 26 28 6d 61 73 6b 29 29 OptFlags&(mask))
caf0: 21 3d 30 29 0a 23 64 65 66 69 6e 65 20 4f 70 74 !=0).#define Opt
cb00: 69 6d 69 7a 61 74 69 6f 6e 45 6e 61 62 6c 65 64 imizationEnabled
cb10: 28 64 62 2c 20 6d 61 73 6b 29 20 20 20 28 28 28 (db, mask) (((
cb20: 64 62 29 2d 3e 64 62 4f 70 74 46 6c 61 67 73 26 db)->dbOptFlags&
cb30: 28 6d 61 73 6b 29 29 3d 3d 30 29 0a 23 65 6c 73 (mask))==0).#els
cb40: 65 0a 23 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 e.#define Optimi
cb50: 7a 61 74 69 6f 6e 44 69 73 61 62 6c 65 64 28 64 zationDisabled(d
cb60: 62 2c 20 6d 61 73 6b 29 20 20 30 0a 23 64 65 66 b, mask) 0.#def
cb70: 69 6e 65 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e ine Optimization
cb80: 45 6e 61 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b Enabled(db, mask
cb90: 29 20 20 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a ) 1.#endif../*
cba0: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 .** Return true
cbb0: 69 66 20 69 74 20 4f 4b 20 74 6f 20 66 61 63 74 if it OK to fact
cbc0: 6f 72 20 63 6f 6e 73 74 61 6e 74 20 65 78 70 72 or constant expr
cbd0: 65 73 73 69 6f 6e 73 20 69 6e 74 6f 20 74 68 65 essions into the
cbe0: 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 0a initialization.
cbf0: 2a 2a 20 63 6f 64 65 2e 20 54 68 65 20 61 72 67 ** code. The arg
cc00: 75 6d 65 6e 74 20 69 73 20 61 20 50 61 72 73 65 ument is a Parse
cc10: 20 6f 62 6a 65 63 74 20 66 6f 72 20 74 68 65 20 object for the
cc20: 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 2e 0a code generator..
cc30: 2a 2f 0a 23 64 65 66 69 6e 65 20 43 6f 6e 73 74 */.#define Const
cc40: 46 61 63 74 6f 72 4f 6b 28 50 29 20 28 28 50 29 FactorOk(P) ((P)
cc50: 2d 3e 6f 6b 43 6f 6e 73 74 46 61 63 74 6f 72 29 ->okConstFactor)
cc60: 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c 65 ../*.** Possible
cc70: 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 values for the
cc80: 73 71 6c 69 74 65 2e 6d 61 67 69 63 20 66 69 65 sqlite.magic fie
cc90: 6c 64 2e 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 ld..** The numbe
cca0: 72 73 20 61 72 65 20 6f 62 74 61 69 6e 65 64 20 rs are obtained
ccb0: 61 74 20 72 61 6e 64 6f 6d 20 61 6e 64 20 68 61 at random and ha
ccc0: 76 65 20 6e 6f 20 73 70 65 63 69 61 6c 20 6d 65 ve no special me
ccd0: 61 6e 69 6e 67 2c 20 6f 74 68 65 72 0a 2a 2a 20 aning, other.**
cce0: 74 68 61 6e 20 62 65 69 6e 67 20 64 69 73 74 69 than being disti
ccf0: 6e 63 74 20 66 72 6f 6d 20 6f 6e 65 20 61 6e 6f nct from one ano
cd00: 74 68 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ther..*/.#define
cd10: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 4f 50 SQLITE_MAGIC_OP
cd20: 45 4e 20 20 20 20 20 30 78 61 30 32 39 61 36 39 EN 0xa029a69
cd30: 37 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 69 7 /* Database i
cd40: 73 20 6f 70 65 6e 20 2a 2f 0a 23 64 65 66 69 6e s open */.#defin
cd50: 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 43 e SQLITE_MAGIC_C
cd60: 4c 4f 53 45 44 20 20 20 30 78 39 66 33 63 32 64 LOSED 0x9f3c2d
cd70: 33 33 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 33 /* Database
cd80: 69 73 20 63 6c 6f 73 65 64 20 2a 2f 0a 23 64 65 is closed */.#de
cd90: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 fine SQLITE_MAGI
cda0: 43 5f 53 49 43 4b 20 20 20 20 20 30 78 34 62 37 C_SICK 0x4b7
cdb0: 37 31 32 39 30 20 20 2f 2a 20 45 72 72 6f 72 20 71290 /* Error
cdc0: 61 6e 64 20 61 77 61 69 74 69 6e 67 20 63 6c 6f and awaiting clo
cdd0: 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 se */.#define SQ
cde0: 4c 49 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 20 LITE_MAGIC_BUSY
cdf0: 20 20 20 20 30 78 66 30 33 62 37 39 30 36 20 20 0xf03b7906
ce00: 2f 2a 20 44 61 74 61 62 61 73 65 20 63 75 72 72 /* Database curr
ce10: 65 6e 74 6c 79 20 69 6e 20 75 73 65 20 2a 2f 0a ently in use */.
ce20: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d #define SQLITE_M
ce30: 41 47 49 43 5f 45 52 52 4f 52 20 20 20 20 30 78 AGIC_ERROR 0x
ce40: 62 35 33 35 37 39 33 30 20 20 2f 2a 20 41 6e 20 b5357930 /* An
ce50: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 20 65 72 SQLITE_MISUSE er
ce60: 72 6f 72 20 6f 63 63 75 72 72 65 64 20 2a 2f 0a ror occurred */.
ce70: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d #define SQLITE_M
ce80: 41 47 49 43 5f 5a 4f 4d 42 49 45 20 20 20 30 78 AGIC_ZOMBIE 0x
ce90: 36 34 63 66 66 63 37 66 20 20 2f 2a 20 43 6c 6f 64cffc7f /* Clo
cea0: 73 65 20 77 69 74 68 20 6c 61 73 74 20 73 74 61 se with last sta
ceb0: 74 65 6d 65 6e 74 20 63 6c 6f 73 65 20 2a 2f 0a tement close */.
cec0: 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 51 4c 20 ./*.** Each SQL
ced0: 66 75 6e 63 74 69 6f 6e 20 69 73 20 64 65 66 69 function is defi
cee0: 6e 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61 6e ned by an instan
cef0: 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
cf00: 69 6e 67 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 ing.** structure
cf10: 2e 20 20 46 6f 72 20 67 6c 6f 62 61 6c 20 62 75 . For global bu
cf20: 69 6c 74 2d 69 6e 20 66 75 6e 63 74 69 6f 6e 73 ilt-in functions
cf30: 20 28 65 78 3a 20 73 75 62 73 74 72 28 29 2c 20 (ex: substr(),
cf40: 6d 61 78 28 29 2c 20 63 6f 75 6e 74 28 29 29 0a max(), count()).
cf50: 2a 2a 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 ** a pointer to
cf60: 74 68 69 73 20 73 74 72 75 63 74 75 72 65 20 69 this structure i
cf70: 73 20 68 65 6c 64 20 69 6e 20 74 68 65 20 73 71 s held in the sq
cf80: 6c 69 74 65 33 42 75 69 6c 74 69 6e 46 75 6e 63 lite3BuiltinFunc
cf90: 74 69 6f 6e 73 20 6f 62 6a 65 63 74 2e 0a 2a 2a tions object..**
cfa0: 20 46 6f 72 20 70 65 72 2d 63 6f 6e 6e 65 63 74 For per-connect
cfb0: 69 6f 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 2d ion application-
cfc0: 64 65 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e defined function
cfd0: 73 2c 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 s, a pointer to
cfe0: 74 68 69 73 0a 2a 2a 20 73 74 72 75 63 74 75 72 this.** structur
cff0: 65 20 69 73 20 68 65 6c 64 20 69 6e 20 74 68 65 e is held in the
d000: 20 64 62 2d 3e 61 48 61 73 68 20 68 61 73 68 20 db->aHash hash
d010: 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 table..**.** The
d020: 20 75 2e 70 48 61 73 68 20 66 69 65 6c 64 20 69 u.pHash field i
d030: 73 20 75 73 65 64 20 62 79 20 74 68 65 20 67 6c s used by the gl
d040: 6f 62 61 6c 20 62 75 69 6c 74 2d 69 6e 73 2e 20 obal built-ins.
d050: 20 54 68 65 20 75 2e 70 44 65 73 74 72 75 63 74 The u.pDestruct
d060: 6f 72 0a 2a 2a 20 66 69 65 6c 64 20 69 73 20 75 or.** field is u
d070: 73 65 64 20 62 79 20 70 65 72 2d 63 6f 6e 6e 65 sed by per-conne
d080: 63 74 69 6f 6e 20 61 70 70 2d 64 65 66 20 66 75 ction app-def fu
d090: 6e 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 72 75 nctions..*/.stru
d0a0: 63 74 20 46 75 6e 63 44 65 66 20 7b 0a 20 20 69 ct FuncDef {. i
d0b0: 38 20 6e 41 72 67 3b 20 20 20 20 20 20 20 20 20 8 nArg;
d0c0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
d0d0: 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 2d 31 20 arguments. -1
d0e0: 6d 65 61 6e 73 20 75 6e 6c 69 6d 69 74 65 64 20 means unlimited
d0f0: 2a 2f 0a 20 20 75 31 36 20 66 75 6e 63 46 6c 61 */. u16 funcFla
d100: 67 73 3b 20 20 20 20 20 20 20 2f 2a 20 53 6f 6d gs; /* Som
d110: 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 6f 66 e combination of
d120: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 2a 20 2a SQLITE_FUNC_* *
d130: 2f 0a 20 20 76 6f 69 64 20 2a 70 55 73 65 72 44 /. void *pUserD
d140: 61 74 61 3b 20 20 20 20 20 2f 2a 20 55 73 65 72 ata; /* User
d150: 20 64 61 74 61 20 70 61 72 61 6d 65 74 65 72 20 data parameter
d160: 2a 2f 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 4e */. FuncDef *pN
d170: 65 78 74 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 ext; /* Nex
d180: 74 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 t function with
d190: 73 61 6d 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 76 same name */. v
d1a0: 6f 69 64 20 28 2a 78 53 46 75 6e 63 29 28 73 71 oid (*xSFunc)(sq
d1b0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
d1c0: 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
d1d0: 2a 2a 29 3b 20 2f 2a 20 66 75 6e 63 20 6f 72 20 **); /* func or
d1e0: 61 67 67 2d 73 74 65 70 20 2a 2f 0a 20 20 76 6f agg-step */. vo
d1f0: 69 64 20 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28 id (*xFinalize)(
d200: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
d210: 29 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 );
d220: 20 20 20 20 2f 2a 20 41 67 67 20 66 69 6e 61 6c /* Agg final
d230: 69 7a 65 72 20 2a 2f 0a 20 20 63 68 61 72 20 2a izer */. char *
d240: 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 2f zName; /
d250: 2a 20 53 51 4c 20 6e 61 6d 65 20 6f 66 20 74 68 * SQL name of th
d260: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a 20 e function. */.
d270: 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 46 75 6e union {. Fun
d280: 63 44 65 66 20 2a 70 48 61 73 68 3b 20 20 20 20 cDef *pHash;
d290: 20 20 2f 2a 20 4e 65 78 74 20 77 69 74 68 20 61 /* Next with a
d2a0: 20 64 69 66 66 65 72 65 6e 74 20 6e 61 6d 65 20 different name
d2b0: 62 75 74 20 74 68 65 20 73 61 6d 65 20 68 61 73 but the same has
d2c0: 68 20 2a 2f 0a 20 20 20 20 46 75 6e 63 44 65 73 h */. FuncDes
d2d0: 74 72 75 63 74 6f 72 20 2a 70 44 65 73 74 72 75 tructor *pDestru
d2e0: 63 74 6f 72 3b 20 20 20 2f 2a 20 52 65 66 65 72 ctor; /* Refer
d2f0: 65 6e 63 65 20 63 6f 75 6e 74 65 64 20 64 65 73 ence counted des
d300: 74 72 75 63 74 6f 72 20 66 75 6e 63 74 69 6f 6e tructor function
d310: 20 2a 2f 0a 20 20 7d 20 75 3b 0a 7d 3b 0a 0a 2f */. } u;.};../
d320: 2a 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 *.** This struct
d330: 75 72 65 20 65 6e 63 61 70 73 75 6c 61 74 65 73 ure encapsulates
d340: 20 61 20 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e a user-function
d350: 20 64 65 73 74 72 75 63 74 6f 72 20 63 61 6c 6c destructor call
d360: 62 61 63 6b 20 28 61 73 0a 2a 2a 20 63 6f 6e 66 back (as.** conf
d370: 69 67 75 72 65 64 20 75 73 69 6e 67 20 63 72 65 igured using cre
d380: 61 74 65 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 ate_function_v2(
d390: 29 29 20 61 6e 64 20 61 20 72 65 66 65 72 65 6e )) and a referen
d3a0: 63 65 20 63 6f 75 6e 74 65 72 2e 20 57 68 65 6e ce counter. When
d3b0: 0a 2a 2a 20 63 72 65 61 74 65 5f 66 75 6e 63 74 .** create_funct
d3c0: 69 6f 6e 5f 76 32 28 29 20 69 73 20 63 61 6c 6c ion_v2() is call
d3d0: 65 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 66 ed to create a f
d3e0: 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 61 20 64 unction with a d
d3f0: 65 73 74 72 75 63 74 6f 72 2c 0a 2a 2a 20 61 20 estructor,.** a
d400: 73 69 6e 67 6c 65 20 6f 62 6a 65 63 74 20 6f 66 single object of
d410: 20 74 68 69 73 20 74 79 70 65 20 69 73 20 61 6c this type is al
d420: 6c 6f 63 61 74 65 64 2e 20 46 75 6e 63 44 65 73 located. FuncDes
d430: 74 72 75 63 74 6f 72 2e 6e 52 65 66 20 69 73 20 tructor.nRef is
d440: 73 65 74 20 74 6f 0a 2a 2a 20 74 68 65 20 6e 75 set to.** the nu
d450: 6d 62 65 72 20 6f 66 20 46 75 6e 63 44 65 66 20 mber of FuncDef
d460: 6f 62 6a 65 63 74 73 20 63 72 65 61 74 65 64 20 objects created
d470: 28 65 69 74 68 65 72 20 31 20 6f 72 20 33 2c 20 (either 1 or 3,
d480: 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 depending on whe
d490: 74 68 65 72 0a 2a 2a 20 6f 72 20 6e 6f 74 20 74 ther.** or not t
d4a0: 68 65 20 73 70 65 63 69 66 69 65 64 20 65 6e 63 he specified enc
d4b0: 6f 64 69 6e 67 20 69 73 20 53 51 4c 49 54 45 5f oding is SQLITE_
d4c0: 41 4e 59 29 2e 20 54 68 65 20 46 75 6e 63 44 65 ANY). The FuncDe
d4d0: 66 2e 70 44 65 73 74 72 75 63 74 6f 72 0a 2a 2a f.pDestructor.**
d4e0: 20 6d 65 6d 62 65 72 20 6f 66 20 65 61 63 68 20 member of each
d4f0: 6f 66 20 74 68 65 20 6e 65 77 20 46 75 6e 63 44 of the new FuncD
d500: 65 66 20 6f 62 6a 65 63 74 73 20 69 73 20 73 65 ef objects is se
d510: 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 t to point to th
d520: 65 20 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 46 e allocated.** F
d530: 75 6e 63 44 65 73 74 72 75 63 74 6f 72 2e 0a 2a uncDestructor..*
d540: 2a 0a 2a 2a 20 54 68 65 72 65 61 66 74 65 72 2c *.** Thereafter,
d550: 20 77 68 65 6e 20 6f 6e 65 20 6f 66 20 74 68 65 when one of the
d560: 20 46 75 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 FuncDef objects
d570: 20 69 73 20 64 65 6c 65 74 65 64 2c 20 74 68 65 is deleted, the
d580: 20 72 65 66 65 72 65 6e 63 65 0a 2a 2a 20 63 6f reference.** co
d590: 75 6e 74 20 6f 6e 20 74 68 69 73 20 6f 62 6a 65 unt on this obje
d5a0: 63 74 20 69 73 20 64 65 63 72 65 6d 65 6e 74 65 ct is decremente
d5b0: 64 2e 20 57 68 65 6e 20 69 74 20 72 65 61 63 68 d. When it reach
d5c0: 65 73 20 30 2c 20 74 68 65 20 64 65 73 74 72 75 es 0, the destru
d5d0: 63 74 6f 72 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b ctor.** is invok
d5e0: 65 64 20 61 6e 64 20 74 68 65 20 46 75 6e 63 44 ed and the FuncD
d5f0: 65 73 74 72 75 63 74 6f 72 20 73 74 72 75 63 74 estructor struct
d600: 75 72 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 ure freed..*/.st
d610: 72 75 63 74 20 46 75 6e 63 44 65 73 74 72 75 63 ruct FuncDestruc
d620: 74 6f 72 20 7b 0a 20 20 69 6e 74 20 6e 52 65 66 tor {. int nRef
d630: 3b 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74 ;. void (*xDest
d640: 72 6f 79 29 28 76 6f 69 64 20 2a 29 3b 0a 20 20 roy)(void *);.
d650: 76 6f 69 64 20 2a 70 55 73 65 72 44 61 74 61 3b void *pUserData;
d660: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 .};../*.** Possi
d670: 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 20 46 ble values for F
d680: 75 6e 63 44 65 66 2e 66 6c 61 67 73 2e 20 20 4e uncDef.flags. N
d690: 6f 74 65 20 74 68 61 74 20 74 68 65 20 5f 4c 45 ote that the _LE
d6a0: 4e 47 54 48 20 61 6e 64 20 5f 54 59 50 45 4f 46 NGTH and _TYPEOF
d6b0: 0a 2a 2a 20 76 61 6c 75 65 73 20 6d 75 73 74 20 .** values must
d6c0: 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 4f 50 correspond to OP
d6d0: 46 4c 41 47 5f 4c 45 4e 47 54 48 41 52 47 20 61 FLAG_LENGTHARG a
d6e0: 6e 64 20 4f 50 46 4c 41 47 5f 54 59 50 45 4f 46 nd OPFLAG_TYPEOF
d6f0: 41 52 47 2e 20 20 41 6e 64 0a 2a 2a 20 53 51 4c ARG. And.** SQL
d700: 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 54 41 4e ITE_FUNC_CONSTAN
d710: 54 20 6d 75 73 74 20 62 65 20 74 68 65 20 73 61 T must be the sa
d720: 6d 65 20 61 73 20 53 51 4c 49 54 45 5f 44 45 54 me as SQLITE_DET
d730: 45 52 4d 49 4e 49 53 54 49 43 2e 20 20 54 68 65 ERMINISTIC. The
d740: 72 65 0a 2a 2a 20 61 72 65 20 61 73 73 65 72 74 re.** are assert
d750: 28 29 20 73 74 61 74 65 6d 65 6e 74 73 20 69 6e () statements in
d760: 20 74 68 65 20 63 6f 64 65 20 74 6f 20 76 65 72 the code to ver
d770: 69 66 79 20 74 68 69 73 2e 0a 2a 2f 0a 23 64 65 ify this..*/.#de
d780: 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 fine SQLITE_FUNC
d790: 5f 45 4e 43 4d 41 53 4b 20 20 30 78 30 30 30 33 _ENCMASK 0x0003
d7a0: 20 2f 2a 20 53 51 4c 49 54 45 5f 55 54 46 38 2c /* SQLITE_UTF8,
d7b0: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 20 SQLITE_UTF16BE
d7c0: 6f 72 20 55 54 46 31 36 4c 45 20 2a 2f 0a 23 64 or UTF16LE */.#d
d7d0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e efine SQLITE_FUN
d7e0: 43 5f 4c 49 4b 45 20 20 20 20 20 30 78 30 30 30 C_LIKE 0x000
d7f0: 34 20 2f 2a 20 43 61 6e 64 69 64 61 74 65 20 66 4 /* Candidate f
d800: 6f 72 20 74 68 65 20 4c 49 4b 45 20 6f 70 74 69 or the LIKE opti
d810: 6d 69 7a 61 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 mization */.#def
d820: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
d830: 43 41 53 45 20 20 20 20 20 30 78 30 30 30 38 20 CASE 0x0008
d840: 2f 2a 20 43 61 73 65 2d 73 65 6e 73 69 74 69 76 /* Case-sensitiv
d850: 65 20 4c 49 4b 45 2d 74 79 70 65 20 66 75 6e 63 e LIKE-type func
d860: 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tion */.#define
d870: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 50 48 45 SQLITE_FUNC_EPHE
d880: 4d 20 20 20 20 30 78 30 30 31 30 20 2f 2a 20 45 M 0x0010 /* E
d890: 70 68 65 6d 65 72 61 6c 2e 20 20 44 65 6c 65 74 phemeral. Delet
d8a0: 65 20 77 69 74 68 20 56 44 42 45 20 2a 2f 0a 23 e with VDBE */.#
d8b0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 define SQLITE_FU
d8c0: 4e 43 5f 4e 45 45 44 43 4f 4c 4c 20 30 78 30 30 NC_NEEDCOLL 0x00
d8d0: 32 30 20 2f 2a 20 73 71 6c 69 74 65 33 47 65 74 20 /* sqlite3Get
d8e0: 46 75 6e 63 43 6f 6c 6c 53 65 71 28 29 20 6d 69 FuncCollSeq() mi
d8f0: 67 68 74 20 62 65 20 63 61 6c 6c 65 64 2a 2f 0a ght be called*/.
d900: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
d910: 55 4e 43 5f 4c 45 4e 47 54 48 20 20 20 30 78 30 UNC_LENGTH 0x0
d920: 30 34 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 040 /* Built-in
d930: 6c 65 6e 67 74 68 28 29 20 66 75 6e 63 74 69 6f length() functio
d940: 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c n */.#define SQL
d950: 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f 46 20 ITE_FUNC_TYPEOF
d960: 20 20 30 78 30 30 38 30 20 2f 2a 20 42 75 69 6c 0x0080 /* Buil
d970: 74 2d 69 6e 20 74 79 70 65 6f 66 28 29 20 66 75 t-in typeof() fu
d980: 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e nction */.#defin
d990: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f e SQLITE_FUNC_CO
d9a0: 55 4e 54 20 20 20 20 30 78 30 31 30 30 20 2f 2a UNT 0x0100 /*
d9b0: 20 42 75 69 6c 74 2d 69 6e 20 63 6f 75 6e 74 28 Built-in count(
d9c0: 2a 29 20 61 67 67 72 65 67 61 74 65 20 2a 2f 0a *) aggregate */.
d9d0: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
d9e0: 55 4e 43 5f 43 4f 41 4c 45 53 43 45 20 30 78 30 UNC_COALESCE 0x0
d9f0: 32 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 200 /* Built-in
da00: 63 6f 61 6c 65 73 63 65 28 29 20 6f 72 20 69 66 coalesce() or if
da10: 6e 75 6c 6c 28 29 20 2a 2f 0a 23 64 65 66 69 6e null() */.#defin
da20: 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 55 4e e SQLITE_FUNC_UN
da30: 4c 49 4b 45 4c 59 20 30 78 30 34 30 30 20 2f 2a LIKELY 0x0400 /*
da40: 20 42 75 69 6c 74 2d 69 6e 20 75 6e 6c 69 6b 65 Built-in unlike
da50: 6c 79 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f ly() function */
da60: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
da70: 46 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 30 78 FUNC_CONSTANT 0x
da80: 30 38 30 30 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 0800 /* Constant
da90: 20 69 6e 70 75 74 73 20 67 69 76 65 20 61 20 63 inputs give a c
daa0: 6f 6e 73 74 61 6e 74 20 6f 75 74 70 75 74 20 2a onstant output *
dab0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
dac0: 5f 46 55 4e 43 5f 4d 49 4e 4d 41 58 20 20 20 30 _FUNC_MINMAX 0
dad0: 78 31 30 30 30 20 2f 2a 20 54 72 75 65 20 66 6f x1000 /* True fo
dae0: 72 20 6d 69 6e 28 29 20 61 6e 64 20 6d 61 78 28 r min() and max(
daf0: 29 20 61 67 67 72 65 67 61 74 65 73 20 2a 2f 0a ) aggregates */.
db00: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
db10: 55 4e 43 5f 53 4c 4f 43 48 4e 47 20 20 30 78 32 UNC_SLOCHNG 0x2
db20: 30 30 30 20 2f 2a 20 22 53 6c 6f 77 20 43 68 61 000 /* "Slow Cha
db30: 6e 67 65 22 2e 20 56 61 6c 75 65 20 63 6f 6e 73 nge". Value cons
db40: 74 61 6e 74 20 64 75 72 69 6e 67 20 61 0a 20 20 tant during a.
db50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
db60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
db70: 20 20 2a 2a 20 73 69 6e 67 6c 65 20 71 75 65 72 ** single quer
db80: 79 20 2d 20 6d 69 67 68 74 20 63 68 61 6e 67 65 y - might change
db90: 20 6f 76 65 72 20 74 69 6d 65 20 2a 2f 0a 0a 2f over time */../
dba0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
dbb0: 6e 67 20 74 68 72 65 65 20 6d 61 63 72 6f 73 2c ng three macros,
dbc0: 20 46 55 4e 43 54 49 4f 4e 28 29 2c 20 4c 49 4b FUNCTION(), LIK
dbd0: 45 46 55 4e 43 28 29 20 61 6e 64 20 41 47 47 52 EFUNC() and AGGR
dbe0: 45 47 41 54 45 28 29 20 61 72 65 0a 2a 2a 20 75 EGATE() are.** u
dbf0: 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 68 sed to create th
dc00: 65 20 69 6e 69 74 69 61 6c 69 7a 65 72 73 20 66 e initializers f
dc10: 6f 72 20 74 68 65 20 46 75 6e 63 44 65 66 20 73 or the FuncDef s
dc20: 74 72 75 63 74 75 72 65 73 2e 0a 2a 2a 0a 2a 2a tructures..**.**
dc30: 20 20 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d FUNCTION(zNam
dc40: 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 e, nArg, iArg, b
dc50: 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 NC, xFunc).**
dc60: 20 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 Used to create
dc70: 20 61 20 73 63 61 6c 61 72 20 66 75 6e 63 74 69 a scalar functi
dc80: 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66 on definition of
dc90: 20 61 20 66 75 6e 63 74 69 6f 6e 20 7a 4e 61 6d a function zNam
dca0: 65 0a 2a 2a 20 20 20 20 20 69 6d 70 6c 65 6d 65 e.** impleme
dcb0: 6e 74 65 64 20 62 79 20 43 20 66 75 6e 63 74 69 nted by C functi
dcc0: 6f 6e 20 78 46 75 6e 63 20 74 68 61 74 20 61 63 on xFunc that ac
dcd0: 63 65 70 74 73 20 6e 41 72 67 20 61 72 67 75 6d cepts nArg argum
dce0: 65 6e 74 73 2e 20 54 68 65 0a 2a 2a 20 20 20 20 ents. The.**
dcf0: 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 61 73 value passed as
dd00: 20 69 41 72 67 20 69 73 20 63 61 73 74 20 74 6f iArg is cast to
dd10: 20 61 20 28 76 6f 69 64 2a 29 20 61 6e 64 20 6d a (void*) and m
dd20: 61 64 65 20 61 76 61 69 6c 61 62 6c 65 0a 2a 2a ade available.**
dd30: 20 20 20 20 20 61 73 20 74 68 65 20 75 73 65 72 as the user
dd40: 2d 64 61 74 61 20 28 73 71 6c 69 74 65 33 5f 75 -data (sqlite3_u
dd50: 73 65 72 5f 64 61 74 61 28 29 29 20 66 6f 72 20 ser_data()) for
dd60: 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 20 49 66 the function. If
dd70: 0a 2a 2a 20 20 20 20 20 61 72 67 75 6d 65 6e 74 .** argument
dd80: 20 62 4e 43 20 69 73 20 74 72 75 65 2c 20 74 68 bNC is true, th
dd90: 65 6e 20 74 68 65 20 53 51 4c 49 54 45 5f 46 55 en the SQLITE_FU
dda0: 4e 43 5f 4e 45 45 44 43 4f 4c 4c 20 66 6c 61 67 NC_NEEDCOLL flag
ddb0: 20 69 73 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 20 is set..**.**
ddc0: 20 56 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 VFUNCTION(zName
ddd0: 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
dde0: 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 20 20 C, xFunc).**
ddf0: 20 4c 69 6b 65 20 46 55 4e 43 54 49 4f 4e 20 65 Like FUNCTION e
de00: 78 63 65 70 74 20 69 74 20 6f 6d 69 74 73 20 74 xcept it omits t
de10: 68 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 he SQLITE_FUNC_C
de20: 4f 4e 53 54 41 4e 54 20 66 6c 61 67 2e 0a 2a 2a ONSTANT flag..**
de30: 0a 2a 2a 20 20 20 44 46 55 4e 43 54 49 4f 4e 28 .** DFUNCTION(
de40: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 zName, nArg, iAr
de50: 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 0a 2a g, bNC, xFunc).*
de60: 2a 20 20 20 20 20 4c 69 6b 65 20 46 55 4e 43 54 * Like FUNCT
de70: 49 4f 4e 20 65 78 63 65 70 74 20 69 74 20 6f 6d ION except it om
de80: 69 74 73 20 74 68 65 20 53 51 4c 49 54 45 5f 46 its the SQLITE_F
de90: 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 66 6c 61 UNC_CONSTANT fla
dea0: 67 20 61 6e 64 0a 2a 2a 20 20 20 20 20 61 64 64 g and.** add
deb0: 73 20 74 68 65 20 53 51 4c 49 54 45 5f 46 55 4e s the SQLITE_FUN
dec0: 43 5f 53 4c 4f 43 48 4e 47 20 66 6c 61 67 2e 20 C_SLOCHNG flag.
ded0: 20 55 73 65 64 20 66 6f 72 20 64 61 74 65 20 26 Used for date &
dee0: 20 74 69 6d 65 20 66 75 6e 63 74 69 6f 6e 73 0a time functions.
def0: 2a 2a 20 20 20 20 20 61 6e 64 20 66 75 6e 63 74 ** and funct
df00: 69 6f 6e 73 20 6c 69 6b 65 20 73 71 6c 69 74 65 ions like sqlite
df10: 5f 76 65 72 73 69 6f 6e 28 29 20 74 68 61 74 20 _version() that
df20: 63 61 6e 20 63 68 61 6e 67 65 2c 20 62 75 74 20 can change, but
df30: 6e 6f 74 20 64 75 72 69 6e 67 0a 2a 2a 20 20 20 not during.**
df40: 20 20 61 20 73 69 6e 67 6c 65 20 71 75 65 72 79 a single query
df50: 2e 0a 2a 2a 0a 2a 2a 20 20 20 41 47 47 52 45 47 ..**.** AGGREG
df60: 41 54 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c ATE(zName, nArg,
df70: 20 69 41 72 67 2c 20 62 4e 43 2c 20 78 53 74 65 iArg, bNC, xSte
df80: 70 2c 20 78 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 p, xFinal).**
df90: 20 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 Used to create
dfa0: 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 an aggregate fu
dfb0: 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f nction definitio
dfc0: 6e 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 n implemented by
dfd0: 0a 2a 2a 20 20 20 20 20 74 68 65 20 43 20 66 75 .** the C fu
dfe0: 6e 63 74 69 6f 6e 73 20 78 53 74 65 70 20 61 6e nctions xStep an
dff0: 64 20 78 46 69 6e 61 6c 2e 20 54 68 65 20 66 69 d xFinal. The fi
e000: 72 73 74 20 66 6f 75 72 20 70 61 72 61 6d 65 74 rst four paramet
e010: 65 72 73 0a 2a 2a 20 20 20 20 20 61 72 65 20 69 ers.** are i
e020: 6e 74 65 72 70 72 65 74 65 64 20 69 6e 20 74 68 nterpreted in th
e030: 65 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 e same way as th
e040: 65 20 66 69 72 73 74 20 34 20 70 61 72 61 6d 65 e first 4 parame
e050: 74 65 72 73 20 74 6f 0a 2a 2a 20 20 20 20 20 46 ters to.** F
e060: 55 4e 43 54 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a UNCTION()..**.**
e070: 20 20 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d LIKEFUNC(zNam
e080: 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 66 e, nArg, pArg, f
e090: 6c 61 67 73 29 0a 2a 2a 20 20 20 20 20 55 73 65 lags).** Use
e0a0: 64 20 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 d to create a sc
e0b0: 61 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 alar function de
e0c0: 66 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 finition of a fu
e0d0: 6e 63 74 69 6f 6e 20 7a 4e 61 6d 65 0a 2a 2a 20 nction zName.**
e0e0: 20 20 20 20 74 68 61 74 20 61 63 63 65 70 74 73 that accepts
e0f0: 20 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 73 20 nArg arguments
e100: 61 6e 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 and is implement
e110: 65 64 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 ed by a call to
e120: 43 0a 2a 2a 20 20 20 20 20 66 75 6e 63 74 69 6f C.** functio
e130: 6e 20 6c 69 6b 65 46 75 6e 63 2e 20 41 72 67 75 n likeFunc. Argu
e140: 6d 65 6e 74 20 70 41 72 67 20 69 73 20 63 61 73 ment pArg is cas
e150: 74 20 74 6f 20 61 20 28 76 6f 69 64 20 2a 29 20 t to a (void *)
e160: 61 6e 64 20 6d 61 64 65 0a 2a 2a 20 20 20 20 20 and made.**
e170: 61 76 61 69 6c 61 62 6c 65 20 61 73 20 74 68 65 available as the
e180: 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 72 2d 64 function user-d
e190: 61 74 61 20 28 73 71 6c 69 74 65 33 5f 75 73 65 ata (sqlite3_use
e1a0: 72 5f 64 61 74 61 28 29 29 2e 20 54 68 65 0a 2a r_data()). The.*
e1b0: 2a 20 20 20 20 20 46 75 6e 63 44 65 66 2e 66 6c * FuncDef.fl
e1c0: 61 67 73 20 76 61 72 69 61 62 6c 65 20 69 73 20 ags variable is
e1d0: 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 65 set to the value
e1e0: 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 66 passed as the f
e1f0: 6c 61 67 73 0a 2a 2a 20 20 20 20 20 70 61 72 61 lags.** para
e200: 6d 65 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e meter..*/.#defin
e210: 65 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 e FUNCTION(zName
e220: 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
e230: 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e C, xFunc) \. {n
e240: 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 Arg, SQLITE_FUNC
e250: 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 _CONSTANT|SQLITE
e260: 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 _UTF8|(bNC*SQLIT
e270: 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 E_FUNC_NEEDCOLL)
e280: 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e , \. SQLITE_IN
e290: 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 T_TO_PTR(iArg),
e2a0: 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 0, xFunc, 0, #zN
e2b0: 61 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 ame, {0} }.#defi
e2c0: 6e 65 20 56 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 ne VFUNCTION(zNa
e2d0: 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 me, nArg, iArg,
e2e0: 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 bNC, xFunc) \.
e2f0: 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 55 54 {nArg, SQLITE_UT
e300: 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 F8|(bNC*SQLITE_F
e310: 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c UNC_NEEDCOLL), \
e320: 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 . SQLITE_INT_T
e330: 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 O_PTR(iArg), 0,
e340: 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d 65 xFunc, 0, #zName
e350: 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 20 , {0} }.#define
e360: 44 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d 65 2c DFUNCTION(zName,
e370: 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e 43 nArg, iArg, bNC
e380: 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b 6e 41 , xFunc) \. {nA
e390: 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f rg, SQLITE_FUNC_
e3a0: 53 4c 4f 43 48 4e 47 7c 53 51 4c 49 54 45 5f 55 SLOCHNG|SQLITE_U
e3b0: 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f TF8|(bNC*SQLITE_
e3c0: 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 29 2c 20 FUNC_NEEDCOLL),
e3d0: 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f \. SQLITE_INT_
e3e0: 54 4f 5f 50 54 52 28 69 41 72 67 29 2c 20 30 2c TO_PTR(iArg), 0,
e3f0: 20 78 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 6d xFunc, 0, #zNam
e400: 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e 65 e, {0} }.#define
e410: 20 46 55 4e 43 54 49 4f 4e 32 28 7a 4e 61 6d 65 FUNCTION2(zName
e420: 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 4e , nArg, iArg, bN
e430: 43 2c 20 78 46 75 6e 63 2c 20 65 78 74 72 61 46 C, xFunc, extraF
e440: 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 67 2c lags) \. {nArg,
e450: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f 4e 53 SQLITE_FUNC_CONS
e460: 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 54 46 38 TANT|SQLITE_UTF8
e470: 7c 28 62 4e 43 2a 53 51 4c 49 54 45 5f 46 55 4e |(bNC*SQLITE_FUN
e480: 43 5f 4e 45 45 44 43 4f 4c 4c 29 7c 65 78 74 72 C_NEEDCOLL)|extr
e490: 61 46 6c 61 67 73 2c 5c 0a 20 20 20 53 51 4c 49 aFlags,\. SQLI
e4a0: 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 69 41 TE_INT_TO_PTR(iA
e4b0: 72 67 29 2c 20 30 2c 20 78 46 75 6e 63 2c 20 30 rg), 0, xFunc, 0
e4c0: 2c 20 23 7a 4e 61 6d 65 2c 20 7b 30 7d 20 7d 0a , #zName, {0} }.
e4d0: 23 64 65 66 69 6e 65 20 53 54 52 5f 46 55 4e 43 #define STR_FUNC
e4e0: 54 49 4f 4e 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 TION(zName, nArg
e4f0: 2c 20 70 41 72 67 2c 20 62 4e 43 2c 20 78 46 75 , pArg, bNC, xFu
e500: 6e 63 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 nc) \. {nArg, S
e510: 51 4c 49 54 45 5f 46 55 4e 43 5f 53 4c 4f 43 48 QLITE_FUNC_SLOCH
e520: 4e 47 7c 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 NG|SQLITE_UTF8|(
e530: 62 4e 43 2a 53 51 4c 49 54 45 5f 46 55 4e 43 5f bNC*SQLITE_FUNC_
e540: 4e 45 45 44 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 NEEDCOLL), \.
e550: 70 41 72 67 2c 20 30 2c 20 78 46 75 6e 63 2c 20 pArg, 0, xFunc,
e560: 30 2c 20 23 7a 4e 61 6d 65 2c 20 7d 0a 23 64 65 0, #zName, }.#de
e570: 66 69 6e 65 20 4c 49 4b 45 46 55 4e 43 28 7a 4e fine LIKEFUNC(zN
e580: 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c 20 ame, nArg, arg,
e590: 66 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 67 flags) \. {nArg
e5a0: 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 4f , SQLITE_FUNC_CO
e5b0: 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 54 NSTANT|SQLITE_UT
e5c0: 46 38 7c 66 6c 61 67 73 2c 20 5c 0a 20 20 20 28 F8|flags, \. (
e5d0: 76 6f 69 64 20 2a 29 61 72 67 2c 20 30 2c 20 6c void *)arg, 0, l
e5e0: 69 6b 65 46 75 6e 63 2c 20 30 2c 20 23 7a 4e 61 ikeFunc, 0, #zNa
e5f0: 6d 65 2c 20 7b 30 7d 20 7d 0a 23 64 65 66 69 6e me, {0} }.#defin
e600: 65 20 41 47 47 52 45 47 41 54 45 28 7a 4e 61 6d e AGGREGATE(zNam
e610: 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c 20 6e 63 e, nArg, arg, nc
e620: 2c 20 78 53 74 65 70 2c 20 78 46 69 6e 61 6c 29 , xStep, xFinal)
e630: 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 \. {nArg, SQLI
e640: 54 45 5f 55 54 46 38 7c 28 6e 63 2a 53 51 4c 49 TE_UTF8|(nc*SQLI
e650: 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
e660: 29 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 ), \. SQLITE_I
e670: 4e 54 5f 54 4f 5f 50 54 52 28 61 72 67 29 2c 20 NT_TO_PTR(arg),
e680: 30 2c 20 78 53 74 65 70 2c 78 46 69 6e 61 6c 2c 0, xStep,xFinal,
e690: 23 7a 4e 61 6d 65 2c 20 7b 30 7d 7d 0a 23 64 65 #zName, {0}}.#de
e6a0: 66 69 6e 65 20 41 47 47 52 45 47 41 54 45 32 28 fine AGGREGATE2(
e6b0: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 zName, nArg, arg
e6c0: 2c 20 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 , nc, xStep, xFi
e6d0: 6e 61 6c 2c 20 65 78 74 72 61 46 6c 61 67 73 29 nal, extraFlags)
e6e0: 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 \. {nArg, SQLI
e6f0: 54 45 5f 55 54 46 38 7c 28 6e 63 2a 53 51 4c 49 TE_UTF8|(nc*SQLI
e700: 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
e710: 29 7c 65 78 74 72 61 46 6c 61 67 73 2c 20 5c 0a )|extraFlags, \.
e720: 20 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f SQLITE_INT_TO
e730: 5f 50 54 52 28 61 72 67 29 2c 20 30 2c 20 78 53 _PTR(arg), 0, xS
e740: 74 65 70 2c 78 46 69 6e 61 6c 2c 23 7a 4e 61 6d tep,xFinal,#zNam
e750: 65 2c 20 7b 30 7d 7d 0a 0a 2f 2a 0a 2a 2a 20 41 e, {0}}../*.** A
e760: 6c 6c 20 63 75 72 72 65 6e 74 20 73 61 76 65 70 ll current savep
e770: 6f 69 6e 74 73 20 61 72 65 20 73 74 6f 72 65 64 oints are stored
e780: 20 69 6e 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 in a linked lis
e790: 74 20 73 74 61 72 74 69 6e 67 20 61 74 0a 2a 2a t starting at.**
e7a0: 20 73 71 6c 69 74 65 33 2e 70 53 61 76 65 70 6f sqlite3.pSavepo
e7b0: 69 6e 74 2e 20 54 68 65 20 66 69 72 73 74 20 65 int. The first e
e7c0: 6c 65 6d 65 6e 74 20 69 6e 20 74 68 65 20 6c 69 lement in the li
e7d0: 73 74 20 69 73 20 74 68 65 20 6d 6f 73 74 20 72 st is the most r
e7e0: 65 63 65 6e 74 6c 79 0a 2a 2a 20 6f 70 65 6e 65 ecently.** opene
e7f0: 64 20 73 61 76 65 70 6f 69 6e 74 2e 20 53 61 76 d savepoint. Sav
e800: 65 70 6f 69 6e 74 73 20 61 72 65 20 61 64 64 65 epoints are adde
e810: 64 20 74 6f 20 74 68 65 20 6c 69 73 74 20 62 79 d to the list by
e820: 20 74 68 65 20 76 64 62 65 0a 2a 2a 20 4f 50 5f the vdbe.** OP_
e830: 53 61 76 65 70 6f 69 6e 74 20 69 6e 73 74 72 75 Savepoint instru
e840: 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 ction..*/.struct
e850: 20 53 61 76 65 70 6f 69 6e 74 20 7b 0a 20 20 63 Savepoint {. c
e860: 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
e870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e880: 20 20 20 2f 2a 20 53 61 76 65 70 6f 69 6e 74 20 /* Savepoint
e890: 6e 61 6d 65 20 28 6e 75 6c 2d 74 65 72 6d 69 6e name (nul-termin
e8a0: 61 74 65 64 29 20 2a 2f 0a 20 20 69 36 34 20 6e ated) */. i64 n
e8b0: 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 20 20 20 DeferredCons;
e8c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
e8d0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 65 66 65 * Number of defe
e8e0: 72 72 65 64 20 66 6b 20 76 69 6f 6c 61 74 69 6f rred fk violatio
e8f0: 6e 73 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 ns */. i64 nDef
e900: 65 72 72 65 64 49 6d 6d 43 6f 6e 73 3b 20 20 20 erredImmCons;
e910: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
e920: 75 6d 62 65 72 20 6f 66 20 64 65 66 65 72 72 65 umber of deferre
e930: 64 20 69 6d 6d 20 66 6b 2e 20 2a 2f 0a 20 20 53 d imm fk. */. S
e940: 61 76 65 70 6f 69 6e 74 20 2a 70 4e 65 78 74 3b avepoint *pNext;
e950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e960: 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 73 61 76 /* Parent sav
e970: 65 70 6f 69 6e 74 20 28 69 66 20 61 6e 79 29 20 epoint (if any)
e980: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 */.};../*.** The
e990: 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 75 following are u
e9a0: 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e sed as the secon
e9b0: 64 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 73 d parameter to s
e9c0: 71 6c 69 74 65 33 53 61 76 65 70 6f 69 6e 74 28 qlite3Savepoint(
e9d0: 29 2c 0a 2a 2a 20 61 6e 64 20 61 73 20 74 68 65 ),.** and as the
e9e0: 20 50 31 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 P1 argument to
e9f0: 74 68 65 20 4f 50 5f 53 61 76 65 70 6f 69 6e 74 the OP_Savepoint
ea00: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2f instruction..*/
ea10: 0a 23 64 65 66 69 6e 65 20 53 41 56 45 50 4f 49 .#define SAVEPOI
ea20: 4e 54 5f 42 45 47 49 4e 20 20 20 20 20 20 30 0a NT_BEGIN 0.
ea30: 23 64 65 66 69 6e 65 20 53 41 56 45 50 4f 49 4e #define SAVEPOIN
ea40: 54 5f 52 45 4c 45 41 53 45 20 20 20 20 31 0a 23 T_RELEASE 1.#
ea50: 64 65 66 69 6e 65 20 53 41 56 45 50 4f 49 4e 54 define SAVEPOINT
ea60: 5f 52 4f 4c 4c 42 41 43 4b 20 20 20 32 0a 0a 0a _ROLLBACK 2...
ea70: 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 51 4c 69 74 /*.** Each SQLit
ea80: 65 20 6d 6f 64 75 6c 65 20 28 76 69 72 74 75 61 e module (virtua
ea90: 6c 20 74 61 62 6c 65 20 64 65 66 69 6e 69 74 69 l table definiti
eaa0: 6f 6e 29 20 69 73 20 64 65 66 69 6e 65 64 20 62 on) is defined b
eab0: 79 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 y an.** instance
eac0: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
ead0: 67 20 73 74 72 75 63 74 75 72 65 2c 20 73 74 6f g structure, sto
eae0: 72 65 64 20 69 6e 20 74 68 65 20 73 71 6c 69 74 red in the sqlit
eaf0: 65 33 2e 61 4d 6f 64 75 6c 65 0a 2a 2a 20 68 61 e3.aModule.** ha
eb00: 73 68 20 74 61 62 6c 65 2e 0a 2a 2f 0a 73 74 72 sh table..*/.str
eb10: 75 63 74 20 4d 6f 64 75 6c 65 20 7b 0a 20 20 63 uct Module {. c
eb20: 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 onst sqlite3_mod
eb30: 75 6c 65 20 2a 70 4d 6f 64 75 6c 65 3b 20 20 20 ule *pModule;
eb40: 20 20 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 /* Callback
eb50: 70 6f 69 6e 74 65 72 73 20 2a 2f 0a 20 20 63 6f pointers */. co
eb60: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b nst char *zName;
eb70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb80: 20 20 20 2f 2a 20 4e 61 6d 65 20 70 61 73 73 65 /* Name passe
eb90: 64 20 74 6f 20 63 72 65 61 74 65 5f 6d 6f 64 75 d to create_modu
eba0: 6c 65 28 29 20 2a 2f 0a 20 20 76 6f 69 64 20 2a le() */. void *
ebb0: 70 41 75 78 3b 20 20 20 20 20 20 20 20 20 20 20 pAux;
ebc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
ebd0: 2a 20 70 41 75 78 20 70 61 73 73 65 64 20 74 6f * pAux passed to
ebe0: 20 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 create_module()
ebf0: 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 65 */. void (*xDe
ec00: 73 74 72 6f 79 29 28 76 6f 69 64 20 2a 29 3b 20 stroy)(void *);
ec10: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f /* Mo
ec20: 64 75 6c 65 20 64 65 73 74 72 75 63 74 6f 72 20 dule destructor
ec30: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 54 61 function */. Ta
ec40: 62 6c 65 20 2a 70 45 70 6f 54 61 62 3b 20 20 20 ble *pEpoTab;
ec50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ec60: 20 20 20 2f 2a 20 45 70 6f 6e 79 6d 6f 75 73 20 /* Eponymous
ec70: 74 61 62 6c 65 20 66 6f 72 20 74 68 69 73 20 6d table for this m
ec80: 6f 64 75 6c 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a odule */.};../*.
ec90: 2a 2a 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 ** information a
eca0: 62 6f 75 74 20 65 61 63 68 20 63 6f 6c 75 6d 6e bout each column
ecb0: 20 6f 66 20 61 6e 20 53 51 4c 20 74 61 62 6c 65 of an SQL table
ecc0: 20 69 73 20 68 65 6c 64 20 69 6e 20 61 6e 20 69 is held in an i
ecd0: 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 nstance.** of th
ece0: 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f is structure..*/
ecf0: 0a 73 74 72 75 63 74 20 43 6f 6c 75 6d 6e 20 7b .struct Column {
ed00: 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 . char *zName;
ed10: 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
ed20: 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 his column */.
ed30: 45 78 70 72 20 2a 70 44 66 6c 74 3b 20 20 20 20 Expr *pDflt;
ed40: 20 2f 2a 20 44 65 66 61 75 6c 74 20 76 61 6c 75 /* Default valu
ed50: 65 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e e of this column
ed60: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 44 66 6c */. char *zDfl
ed70: 74 3b 20 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e t; /* Origin
ed80: 61 6c 20 74 65 78 74 20 6f 66 20 74 68 65 20 64 al text of the d
ed90: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 2a 2f 0a efault value */.
eda0: 20 20 63 68 61 72 20 2a 7a 54 79 70 65 3b 20 20 char *zType;
edb0: 20 20 20 2f 2a 20 44 61 74 61 20 74 79 70 65 20 /* Data type
edc0: 66 6f 72 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 for this column
edd0: 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6c 6c */. char *zColl
ede0: 3b 20 20 20 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 ; /* Collati
edf0: 6e 67 20 73 65 71 75 65 6e 63 65 2e 20 20 49 66 ng sequence. If
ee00: 20 4e 55 4c 4c 2c 20 75 73 65 20 74 68 65 20 64 NULL, use the d
ee10: 65 66 61 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6e efault */. u8 n
ee20: 6f 74 4e 75 6c 6c 3b 20 20 20 20 20 20 2f 2a 20 otNull; /*
ee30: 41 6e 20 4f 45 5f 20 63 6f 64 65 20 66 6f 72 20 An OE_ code for
ee40: 68 61 6e 64 6c 69 6e 67 20 61 20 4e 4f 54 20 4e handling a NOT N
ee50: 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a ULL constraint *
ee60: 2f 0a 20 20 63 68 61 72 20 61 66 66 69 6e 69 74 /. char affinit
ee70: 79 3b 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 y; /* One of t
ee80: 68 65 20 53 51 4c 49 54 45 5f 41 46 46 5f 2e 2e he SQLITE_AFF_..
ee90: 2e 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 38 . values */. u8
eea0: 20 73 7a 45 73 74 3b 20 20 20 20 20 20 20 20 2f szEst; /
eeb0: 2a 20 45 73 74 69 6d 61 74 65 64 20 73 69 7a 65 * Estimated size
eec0: 20 6f 66 20 76 61 6c 75 65 20 69 6e 20 74 68 69 of value in thi
eed0: 73 20 63 6f 6c 75 6d 6e 2e 20 73 69 7a 65 6f 66 s column. sizeof
eee0: 28 49 4e 54 29 3d 3d 31 20 2a 2f 0a 20 20 75 38 (INT)==1 */. u8
eef0: 20 63 6f 6c 46 6c 61 67 73 3b 20 20 20 20 20 2f colFlags; /
ef00: 2a 20 42 6f 6f 6c 65 61 6e 20 70 72 6f 70 65 72 * Boolean proper
ef10: 74 69 65 73 2e 20 20 53 65 65 20 43 4f 4c 46 4c ties. See COLFL
ef20: 41 47 5f 20 64 65 66 69 6e 65 73 20 62 65 6c 6f AG_ defines belo
ef30: 77 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f w */.};../* Allo
ef40: 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 43 wed values for C
ef50: 6f 6c 75 6d 6e 2e 63 6f 6c 46 6c 61 67 73 3a 0a olumn.colFlags:.
ef60: 2a 2f 0a 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c */.#define COLFL
ef70: 41 47 5f 50 52 49 4d 4b 45 59 20 20 30 78 30 30 AG_PRIMKEY 0x00
ef80: 30 31 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 01 /* Column
ef90: 69 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 70 is part of the p
efa0: 72 69 6d 61 72 79 20 6b 65 79 20 2a 2f 0a 23 64 rimary key */.#d
efb0: 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 48 49 efine COLFLAG_HI
efc0: 44 44 45 4e 20 20 20 30 78 30 30 30 32 20 20 20 DDEN 0x0002
efd0: 20 2f 2a 20 41 20 68 69 64 64 65 6e 20 63 6f 6c /* A hidden col
efe0: 75 6d 6e 20 69 6e 20 61 20 76 69 72 74 75 61 6c umn in a virtual
eff0: 20 74 61 62 6c 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a table */../*.**
f000: 20 41 20 22 43 6f 6c 6c 61 74 69 6e 67 20 53 65 A "Collating Se
f010: 71 75 65 6e 63 65 22 20 69 73 20 64 65 66 69 6e quence" is defin
f020: 65 64 20 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 ed by an instanc
f030: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
f040: 6e 67 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 2e ng.** structure.
f050: 20 43 6f 6e 63 65 70 74 75 61 6c 6c 79 2c 20 61 Conceptually, a
f060: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 collating seque
f070: 6e 63 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 nce consists of
f080: 61 20 6e 61 6d 65 20 61 6e 64 0a 2a 2a 20 61 20 a name and.** a
f090: 63 6f 6d 70 61 72 69 73 6f 6e 20 72 6f 75 74 69 comparison routi
f0a0: 6e 65 20 74 68 61 74 20 64 65 66 69 6e 65 73 20 ne that defines
f0b0: 74 68 65 20 6f 72 64 65 72 20 6f 66 20 74 68 61 the order of tha
f0c0: 74 20 73 65 71 75 65 6e 63 65 2e 0a 2a 2a 0a 2a t sequence..**.*
f0d0: 2a 20 49 66 20 43 6f 6c 6c 53 65 71 2e 78 43 6d * If CollSeq.xCm
f0e0: 70 20 69 73 20 4e 55 4c 4c 2c 20 69 74 20 6d 65 p is NULL, it me
f0f0: 61 6e 73 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 ans that the.**
f100: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
f110: 63 65 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e ce is undefined.
f120: 20 20 49 6e 64 69 63 65 73 20 62 75 69 6c 74 20 Indices built
f130: 6f 6e 20 61 6e 20 75 6e 64 65 66 69 6e 65 64 0a on an undefined.
f140: 2a 2a 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 ** collating seq
f150: 75 65 6e 63 65 20 6d 61 79 20 6e 6f 74 20 62 65 uence may not be
f160: 20 72 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e read or written
f170: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 43 6f 6c 6c ..*/.struct Coll
f180: 53 65 71 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e Seq {. char *zN
f190: 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ame; /*
f1a0: 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c Name of the col
f1b0: 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 2c lating sequence,
f1c0: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a UTF-8 encoded *
f1d0: 2f 0a 20 20 75 38 20 65 6e 63 3b 20 20 20 20 20 /. u8 enc;
f1e0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 /* Tex
f1f0: 74 20 65 6e 63 6f 64 69 6e 67 20 68 61 6e 64 6c t encoding handl
f200: 65 64 20 62 79 20 78 43 6d 70 28 29 20 2a 2f 0a ed by xCmp() */.
f210: 20 20 76 6f 69 64 20 2a 70 55 73 65 72 3b 20 20 void *pUser;
f220: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
f230: 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 6d argument to xCm
f240: 70 28 29 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 p() */. int (*x
f250: 43 6d 70 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 20 Cmp)(void*,int,
f260: 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 20 69 6e 74 const void*, int
f270: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 29 3b 0a , const void*);.
f280: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 void (*xDel)(v
f290: 6f 69 64 2a 29 3b 20 20 2f 2a 20 44 65 73 74 72 oid*); /* Destr
f2a0: 75 63 74 6f 72 20 66 6f 72 20 70 55 73 65 72 20 uctor for pUser
f2b0: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 */.};../*.** A s
f2c0: 6f 72 74 20 6f 72 64 65 72 20 63 61 6e 20 62 65 ort order can be
f2d0: 20 65 69 74 68 65 72 20 41 53 43 20 6f 72 20 44 either ASC or D
f2e0: 45 53 43 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ESC..*/.#define
f2f0: 53 51 4c 49 54 45 5f 53 4f 5f 41 53 43 20 20 20 SQLITE_SO_ASC
f300: 20 20 20 20 30 20 20 2f 2a 20 53 6f 72 74 20 69 0 /* Sort i
f310: 6e 20 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 n ascending orde
f320: 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c r */.#define SQL
f330: 49 54 45 5f 53 4f 5f 44 45 53 43 20 20 20 20 20 ITE_SO_DESC
f340: 20 31 20 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 1 /* Sort in a
f350: 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a scending order *
f360: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
f370: 5f 53 4f 5f 55 4e 44 45 46 49 4e 45 44 20 2d 31 _SO_UNDEFINED -1
f380: 20 2f 2a 20 4e 6f 20 73 6f 72 74 20 6f 72 64 65 /* No sort orde
f390: 72 20 73 70 65 63 69 66 69 65 64 20 2a 2f 0a 0a r specified */..
f3a0: 2f 2a 0a 2a 2a 20 43 6f 6c 75 6d 6e 20 61 66 66 /*.** Column aff
f3b0: 69 6e 69 74 79 20 74 79 70 65 73 2e 0a 2a 2a 0a inity types..**.
f3c0: 2a 2a 20 54 68 65 73 65 20 75 73 65 64 20 74 6f ** These used to
f3d0: 20 68 61 76 65 20 6d 6e 65 6d 6f 6e 69 63 20 6e have mnemonic n
f3e0: 61 6d 65 20 6c 69 6b 65 20 27 69 27 20 66 6f 72 ame like 'i' for
f3f0: 20 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 45 SQLITE_AFF_INTE
f400: 47 45 52 20 61 6e 64 0a 2a 2a 20 27 74 27 20 66 GER and.** 't' f
f410: 6f 72 20 53 51 4c 49 54 45 5f 41 46 46 5f 54 45 or SQLITE_AFF_TE
f420: 58 54 2e 20 20 42 75 74 20 77 65 20 63 61 6e 20 XT. But we can
f430: 73 61 76 65 20 61 20 6c 69 74 74 6c 65 20 73 70 save a little sp
f440: 61 63 65 20 61 6e 64 20 69 6d 70 72 6f 76 65 0a ace and improve.
f450: 2a 2a 20 74 68 65 20 73 70 65 65 64 20 61 20 6c ** the speed a l
f460: 69 74 74 6c 65 20 62 79 20 6e 75 6d 62 65 72 69 ittle by numberi
f470: 6e 67 20 74 68 65 20 76 61 6c 75 65 73 20 63 6f ng the values co
f480: 6e 73 65 63 75 74 69 76 65 6c 79 2e 0a 2a 2a 0a nsecutively..**.
f490: 2a 2a 20 42 75 74 20 72 61 74 68 65 72 20 74 68 ** But rather th
f4a0: 61 6e 20 73 74 61 72 74 20 77 69 74 68 20 30 20 an start with 0
f4b0: 6f 72 20 31 2c 20 77 65 20 62 65 67 69 6e 20 77 or 1, we begin w
f4c0: 69 74 68 20 27 41 27 2e 20 20 54 68 61 74 20 77 ith 'A'. That w
f4d0: 61 79 2c 0a 2a 2a 20 77 68 65 6e 20 6d 75 6c 74 ay,.** when mult
f4e0: 69 70 6c 65 20 61 66 66 69 6e 69 74 79 20 74 79 iple affinity ty
f4f0: 70 65 73 20 61 72 65 20 63 6f 6e 63 61 74 65 6e pes are concaten
f500: 61 74 65 64 20 69 6e 74 6f 20 61 20 73 74 72 69 ated into a stri
f510: 6e 67 20 61 6e 64 0a 2a 2a 20 75 73 65 64 20 61 ng and.** used a
f520: 73 20 74 68 65 20 50 34 20 6f 70 65 72 61 6e 64 s the P4 operand
f530: 2c 20 74 68 65 79 20 77 69 6c 6c 20 62 65 20 6d , they will be m
f540: 6f 72 65 20 72 65 61 64 61 62 6c 65 2e 0a 2a 2a ore readable..**
f550: 0a 2a 2a 20 4e 6f 74 65 20 61 6c 73 6f 20 74 68 .** Note also th
f560: 61 74 20 74 68 65 20 6e 75 6d 65 72 69 63 20 74 at the numeric t
f570: 79 70 65 73 20 61 72 65 20 67 72 6f 75 70 65 64 ypes are grouped
f580: 20 74 6f 67 65 74 68 65 72 20 73 6f 20 74 68 61 together so tha
f590: 74 20 74 65 73 74 69 6e 67 0a 2a 2a 20 66 6f 72 t testing.** for
f5a0: 20 61 20 6e 75 6d 65 72 69 63 20 74 79 70 65 20 a numeric type
f5b0: 69 73 20 61 20 73 69 6e 67 6c 65 20 63 6f 6d 70 is a single comp
f5c0: 61 72 69 73 6f 6e 2e 20 20 41 6e 64 20 74 68 65 arison. And the
f5d0: 20 42 4c 4f 42 20 74 79 70 65 20 69 73 20 66 69 BLOB type is fi
f5e0: 72 73 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 rst..*/.#define
f5f0: 53 51 4c 49 54 45 5f 41 46 46 5f 42 4c 4f 42 20 SQLITE_AFF_BLOB
f600: 20 20 20 20 27 41 27 0a 23 64 65 66 69 6e 65 20 'A'.#define
f610: 53 51 4c 49 54 45 5f 41 46 46 5f 54 45 58 54 20 SQLITE_AFF_TEXT
f620: 20 20 20 20 27 42 27 0a 23 64 65 66 69 6e 65 20 'B'.#define
f630: 53 51 4c 49 54 45 5f 41 46 46 5f 4e 55 4d 45 52 SQLITE_AFF_NUMER
f640: 49 43 20 20 27 43 27 0a 23 64 65 66 69 6e 65 20 IC 'C'.#define
f650: 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 45 47 SQLITE_AFF_INTEG
f660: 45 52 20 20 27 44 27 0a 23 64 65 66 69 6e 65 20 ER 'D'.#define
f670: 53 51 4c 49 54 45 5f 41 46 46 5f 52 45 41 4c 20 SQLITE_AFF_REAL
f680: 20 20 20 20 27 45 27 0a 0a 23 64 65 66 69 6e 65 'E'..#define
f690: 20 73 71 6c 69 74 65 33 49 73 4e 75 6d 65 72 69 sqlite3IsNumeri
f6a0: 63 41 66 66 69 6e 69 74 79 28 58 29 20 20 28 28 cAffinity(X) ((
f6b0: 58 29 3e 3d 53 51 4c 49 54 45 5f 41 46 46 5f 4e X)>=SQLITE_AFF_N
f6c0: 55 4d 45 52 49 43 29 0a 0a 2f 2a 0a 2a 2a 20 54 UMERIC)../*.** T
f6d0: 68 65 20 53 51 4c 49 54 45 5f 41 46 46 5f 4d 41 he SQLITE_AFF_MA
f6e0: 53 4b 20 76 61 6c 75 65 73 20 6d 61 73 6b 73 20 SK values masks
f6f0: 6f 66 66 20 74 68 65 20 73 69 67 6e 69 66 69 63 off the signific
f700: 61 6e 74 20 62 69 74 73 20 6f 66 20 61 6e 0a 2a ant bits of an.*
f710: 2a 20 61 66 66 69 6e 69 74 79 20 76 61 6c 75 65 * affinity value
f720: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c ..*/.#define SQL
f730: 49 54 45 5f 41 46 46 5f 4d 41 53 4b 20 20 20 20 ITE_AFF_MASK
f740: 20 30 78 34 37 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 0x47../*.** Add
f750: 69 74 69 6f 6e 61 6c 20 62 69 74 20 76 61 6c 75 itional bit valu
f760: 65 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 4f es that can be O
f770: 52 65 64 20 77 69 74 68 20 61 6e 20 61 66 66 69 Red with an affi
f780: 6e 69 74 79 20 77 69 74 68 6f 75 74 0a 2a 2a 20 nity without.**
f790: 63 68 61 6e 67 69 6e 67 20 74 68 65 20 61 66 66 changing the aff
f7a0: 69 6e 69 74 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 inity..**.** The
f7b0: 20 53 51 4c 49 54 45 5f 4e 4f 54 4e 55 4c 4c 20 SQLITE_NOTNULL
f7c0: 66 6c 61 67 20 69 73 20 61 20 63 6f 6d 62 69 6e flag is a combin
f7d0: 61 74 69 6f 6e 20 6f 66 20 4e 55 4c 4c 45 51 20 ation of NULLEQ
f7e0: 61 6e 64 20 4a 55 4d 50 49 46 4e 55 4c 4c 2e 0a and JUMPIFNULL..
f7f0: 2a 2a 20 49 74 20 63 61 75 73 65 73 20 61 6e 20 ** It causes an
f800: 61 73 73 65 72 74 28 29 20 74 6f 20 66 69 72 65 assert() to fire
f810: 20 69 66 20 65 69 74 68 65 72 20 6f 70 65 72 61 if either opera
f820: 6e 64 20 74 6f 20 61 20 63 6f 6d 70 61 72 69 73 nd to a comparis
f830: 6f 6e 0a 2a 2a 20 6f 70 65 72 61 74 6f 72 20 69 on.** operator i
f840: 73 20 4e 55 4c 4c 2e 20 20 49 74 20 69 73 20 61 s NULL. It is a
f850: 64 64 65 64 20 74 6f 20 63 65 72 74 61 69 6e 20 dded to certain
f860: 63 6f 6d 70 61 72 69 73 6f 6e 20 6f 70 65 72 61 comparison opera
f870: 74 6f 72 73 20 74 6f 0a 2a 2a 20 70 72 6f 76 65 tors to.** prove
f880: 20 74 68 61 74 20 74 68 65 20 6f 70 65 72 61 6e that the operan
f890: 64 73 20 61 72 65 20 61 6c 77 61 79 73 20 4e 4f ds are always NO
f8a0: 54 20 4e 55 4c 4c 2e 0a 2a 2f 0a 23 64 65 66 69 T NULL..*/.#defi
f8b0: 6e 65 20 53 51 4c 49 54 45 5f 4a 55 4d 50 49 46 ne SQLITE_JUMPIF
f8c0: 4e 55 4c 4c 20 20 20 30 78 31 30 20 20 2f 2a 20 NULL 0x10 /*
f8d0: 6a 75 6d 70 73 20 69 66 20 65 69 74 68 65 72 20 jumps if either
f8e0: 6f 70 65 72 61 6e 64 20 69 73 20 4e 55 4c 4c 20 operand is NULL
f8f0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
f900: 45 5f 53 54 4f 52 45 50 32 20 20 20 20 20 20 30 E_STOREP2 0
f910: 78 32 30 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 x20 /* Store re
f920: 73 75 6c 74 20 69 6e 20 72 65 67 5b 50 32 5d 20 sult in reg[P2]
f930: 72 61 74 68 65 72 20 74 68 61 6e 20 6a 75 6d 70 rather than jump
f940: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
f950: 54 45 5f 4e 55 4c 4c 45 51 20 20 20 20 20 20 20 TE_NULLEQ
f960: 30 78 38 30 20 20 2f 2a 20 4e 55 4c 4c 3d 4e 55 0x80 /* NULL=NU
f970: 4c 4c 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 LL */.#define SQ
f980: 4c 49 54 45 5f 4e 4f 54 4e 55 4c 4c 20 20 20 20 LITE_NOTNULL
f990: 20 20 30 78 39 30 20 20 2f 2a 20 41 73 73 65 72 0x90 /* Asser
f9a0: 74 20 74 68 61 74 20 6f 70 65 72 61 6e 64 73 20 t that operands
f9b0: 61 72 65 20 6e 65 76 65 72 20 4e 55 4c 4c 20 2a are never NULL *
f9c0: 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 6f 62 6a 65 /../*.** An obje
f9d0: 63 74 20 6f 66 20 74 68 69 73 20 74 79 70 65 20 ct of this type
f9e0: 69 73 20 63 72 65 61 74 65 64 20 66 6f 72 20 65 is created for e
f9f0: 61 63 68 20 76 69 72 74 75 61 6c 20 74 61 62 6c ach virtual tabl
fa00: 65 20 70 72 65 73 65 6e 74 20 69 6e 0a 2a 2a 20 e present in.**
fa10: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 the database sch
fa20: 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 ema..**.** If th
fa30: 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d e database schem
fa40: 61 20 69 73 20 73 68 61 72 65 64 2c 20 74 68 65 a is shared, the
fa50: 6e 20 74 68 65 72 65 20 69 73 20 6f 6e 65 20 69 n there is one i
fa60: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 0a nstance of this.
fa70: 2a 2a 20 73 74 72 75 63 74 75 72 65 20 66 6f 72 ** structure for
fa80: 20 65 61 63 68 20 64 61 74 61 62 61 73 65 20 63 each database c
fa90: 6f 6e 6e 65 63 74 69 6f 6e 20 28 73 71 6c 69 74 onnection (sqlit
faa0: 65 33 2a 29 20 74 68 61 74 20 75 73 65 73 20 74 e3*) that uses t
fab0: 68 65 20 73 68 61 72 65 64 0a 2a 2a 20 73 63 68 he shared.** sch
fac0: 65 6d 61 2e 20 54 68 69 73 20 69 73 20 62 65 63 ema. This is bec
fad0: 61 75 73 65 20 65 61 63 68 20 64 61 74 61 62 61 ause each databa
fae0: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 72 65 se connection re
faf0: 71 75 69 72 65 73 20 69 74 73 20 6f 77 6e 20 75 quires its own u
fb00: 6e 69 71 75 65 0a 2a 2a 20 69 6e 73 74 61 6e 63 nique.** instanc
fb10: 65 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 e of the sqlite3
fb20: 5f 76 74 61 62 2a 20 68 61 6e 64 6c 65 20 75 73 _vtab* handle us
fb30: 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 ed to access the
fb40: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 0a 2a virtual table.*
fb50: 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e * implementation
fb60: 2e 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 . sqlite3_vtab*
fb70: 68 61 6e 64 6c 65 73 20 63 61 6e 20 6e 6f 74 20 handles can not
fb80: 62 65 20 73 68 61 72 65 64 20 62 65 74 77 65 65 be shared betwee
fb90: 6e 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f n.** database co
fba0: 6e 6e 65 63 74 69 6f 6e 73 2c 20 65 76 65 6e 20 nnections, even
fbb0: 77 68 65 6e 20 74 68 65 20 72 65 73 74 20 6f 66 when the rest of
fbc0: 20 74 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 64 the in-memory d
fbd0: 61 74 61 62 61 73 65 0a 2a 2a 20 73 63 68 65 6d atabase.** schem
fbe0: 61 20 69 73 20 73 68 61 72 65 64 2c 20 61 73 20 a is shared, as
fbf0: 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 the implementati
fc00: 6f 6e 20 6f 66 74 65 6e 20 73 74 6f 72 65 73 20 on often stores
fc10: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 the database.**
fc20: 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 6e 64 6c connection handl
fc30: 65 20 70 61 73 73 65 64 20 74 6f 20 69 74 20 76 e passed to it v
fc40: 69 61 20 74 68 65 20 78 43 6f 6e 6e 65 63 74 28 ia the xConnect(
fc50: 29 20 6f 72 20 78 43 72 65 61 74 65 28 29 20 6d ) or xCreate() m
fc60: 65 74 68 6f 64 0a 2a 2a 20 64 75 72 69 6e 67 20 ethod.** during
fc70: 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 initialization i
fc80: 6e 74 65 72 6e 61 6c 6c 79 2e 20 54 68 69 73 20 nternally. This
fc90: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 database connect
fca0: 69 6f 6e 20 68 61 6e 64 6c 65 20 6d 61 79 0a 2a ion handle may.*
fcb0: 2a 20 74 68 65 6e 20 62 65 20 75 73 65 64 20 62 * then be used b
fcc0: 79 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 61 y the virtual ta
fcd0: 62 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 ble implementati
fce0: 6f 6e 20 74 6f 20 61 63 63 65 73 73 20 72 65 61 on to access rea
fcf0: 6c 20 74 61 62 6c 65 73 0a 2a 2a 20 77 69 74 68 l tables.** with
fd00: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e in the database.
fd10: 20 53 6f 20 74 68 61 74 20 74 68 65 79 20 61 70 So that they ap
fd20: 70 65 61 72 20 61 73 20 70 61 72 74 20 6f 66 20 pear as part of
fd30: 74 68 65 20 63 61 6c 6c 65 72 73 0a 2a 2a 20 74 the callers.** t
fd40: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 73 ransaction, thes
fd50: 65 20 61 63 63 65 73 73 65 73 20 6e 65 65 64 20 e accesses need
fd60: 74 6f 20 62 65 20 6d 61 64 65 20 76 69 61 20 74 to be made via t
fd70: 68 65 20 73 61 6d 65 20 64 61 74 61 62 61 73 65 he same database
fd80: 0a 2a 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 .** connection a
fd90: 73 20 74 68 61 74 20 75 73 65 64 20 74 6f 20 65 s that used to e
fda0: 78 65 63 75 74 65 20 53 51 4c 20 6f 70 65 72 61 xecute SQL opera
fdb0: 74 69 6f 6e 73 20 6f 6e 20 74 68 65 20 76 69 72 tions on the vir
fdc0: 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a tual table..**.*
fdd0: 2a 20 41 6c 6c 20 56 54 61 62 6c 65 20 6f 62 6a * All VTable obj
fde0: 65 63 74 73 20 74 68 61 74 20 63 6f 72 72 65 73 ects that corres
fdf0: 70 6f 6e 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 pond to a single
fe00: 20 74 61 62 6c 65 20 69 6e 20 61 20 73 68 61 72 table in a shar
fe10: 65 64 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 73 ed.** database s
fe20: 63 68 65 6d 61 20 61 72 65 20 69 6e 69 74 69 61 chema are initia
fe30: 6c 6c 79 20 73 74 6f 72 65 64 20 69 6e 20 61 20 lly stored in a
fe40: 6c 69 6e 6b 65 64 2d 6c 69 73 74 20 70 6f 69 6e linked-list poin
fe50: 74 65 64 20 74 6f 20 62 79 0a 2a 2a 20 74 68 65 ted to by.** the
fe60: 20 54 61 62 6c 65 2e 70 56 54 61 62 6c 65 20 6d Table.pVTable m
fe70: 65 6d 62 65 72 20 76 61 72 69 61 62 6c 65 20 6f ember variable o
fe80: 66 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 f the correspond
fe90: 69 6e 67 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 ing Table object
fea0: 2e 0a 2a 2a 20 57 68 65 6e 20 61 6e 20 73 71 6c ..** When an sql
feb0: 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 6f ite3_prepare() o
fec0: 70 65 72 61 74 69 6f 6e 20 69 73 20 72 65 71 75 peration is requ
fed0: 69 72 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 ired to access t
fee0: 68 65 20 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 he virtual.** ta
fef0: 62 6c 65 2c 20 69 74 20 73 65 61 72 63 68 65 73 ble, it searches
ff00: 20 74 68 65 20 6c 69 73 74 20 66 6f 72 20 74 68 the list for th
ff10: 65 20 56 54 61 62 6c 65 20 74 68 61 74 20 63 6f e VTable that co
ff20: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 rresponds to the
ff30: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 63 6f 6e .** database con
ff40: 6e 65 63 74 69 6f 6e 20 64 6f 69 6e 67 20 74 68 nection doing th
ff50: 65 20 70 72 65 70 61 72 69 6e 67 20 73 6f 20 61 e preparing so a
ff60: 73 20 74 6f 20 75 73 65 20 74 68 65 20 63 6f 72 s to use the cor
ff70: 72 65 63 74 0a 2a 2a 20 73 71 6c 69 74 65 33 5f rect.** sqlite3_
ff80: 76 74 61 62 2a 20 68 61 6e 64 6c 65 20 69 6e 20 vtab* handle in
ff90: 74 68 65 20 63 6f 6d 70 69 6c 65 64 20 71 75 65 the compiled que
ffa0: 72 79 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 ry..**.** When a
ffb0: 6e 20 69 6e 2d 6d 65 6d 6f 72 79 20 54 61 62 6c n in-memory Tabl
ffc0: 65 20 6f 62 6a 65 63 74 20 69 73 20 64 65 6c 65 e object is dele
ffd0: 74 65 64 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 ted (for example
ffe0: 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 73 63 68 when the.** sch
fff0: 65 6d 61 20 69 73 20 62 65 69 6e 67 20 72 65 6c ema is being rel
10000 6f 61 64 65 64 20 66 6f 72 20 73 6f 6d 65 20 72 oaded for some r
10010 65 61 73 6f 6e 29 2c 20 74 68 65 20 56 54 61 62 eason), the VTab
10020 6c 65 20 6f 62 6a 65 63 74 73 20 61 72 65 20 6e le objects are n
10030 6f 74 0a 2a 2a 20 64 65 6c 65 74 65 64 20 61 6e ot.** deleted an
10040 64 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 d the sqlite3_vt
10050 61 62 2a 20 68 61 6e 64 6c 65 73 20 61 72 65 20 ab* handles are
10060 6e 6f 74 20 78 44 69 73 63 6f 6e 6e 65 63 74 28 not xDisconnect(
10070 29 65 64 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 )ed.** immediate
10080 6c 79 2e 20 49 6e 73 74 65 61 64 2c 20 74 68 65 ly. Instead, the
10090 79 20 61 72 65 20 6d 6f 76 65 64 20 66 72 6f 6d y are moved from
100a0 20 74 68 65 20 54 61 62 6c 65 2e 70 56 54 61 62 the Table.pVTab
100b0 6c 65 20 6c 69 73 74 20 74 6f 0a 2a 2a 20 61 6e le list to.** an
100c0 6f 74 68 65 72 20 6c 69 6e 6b 65 64 20 6c 69 73 other linked lis
100d0 74 20 68 65 61 64 65 64 20 62 79 20 74 68 65 20 t headed by the
100e0 73 71 6c 69 74 65 33 2e 70 44 69 73 63 6f 6e 6e sqlite3.pDisconn
100f0 65 63 74 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 ect member of th
10100 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 e.** correspondi
10110 6e 67 20 73 71 6c 69 74 65 33 20 73 74 72 75 63 ng sqlite3 struc
10120 74 75 72 65 2e 20 54 68 65 79 20 61 72 65 20 74 ture. They are t
10130 68 65 6e 20 64 65 6c 65 74 65 64 2f 78 44 69 73 hen deleted/xDis
10140 63 6f 6e 6e 65 63 74 65 64 0a 2a 2a 20 6e 65 78 connected.** nex
10150 74 20 74 69 6d 65 20 61 20 73 74 61 74 65 6d 65 t time a stateme
10160 6e 74 20 69 73 20 70 72 65 70 61 72 65 64 20 75 nt is prepared u
10170 73 69 6e 67 20 73 61 69 64 20 73 71 6c 69 74 65 sing said sqlite
10180 33 2a 2e 20 54 68 69 73 20 69 73 20 64 6f 6e 65 3*. This is done
10190 0a 2a 2a 20 74 6f 20 61 76 6f 69 64 20 64 65 61 .** to avoid dea
101a0 64 6c 6f 63 6b 20 69 73 73 75 65 73 20 69 6e 76 dlock issues inv
101b0 6f 6c 76 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 olving multiple
101c0 73 71 6c 69 74 65 33 2e 6d 75 74 65 78 20 6d 75 sqlite3.mutex mu
101d0 74 65 78 65 73 2e 0a 2a 2a 20 52 65 66 65 72 20 texes..** Refer
101e0 74 6f 20 63 6f 6d 6d 65 6e 74 73 20 61 62 6f 76 to comments abov
101f0 65 20 66 75 6e 63 74 69 6f 6e 20 73 71 6c 69 74 e function sqlit
10200 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 e3VtabUnlockList
10210 28 29 20 66 6f 72 20 61 6e 0a 2a 2a 20 65 78 70 () for an.** exp
10220 6c 61 6e 61 74 69 6f 6e 20 61 73 20 74 6f 20 77 lanation as to w
10230 68 79 20 69 74 20 69 73 20 73 61 66 65 20 74 6f hy it is safe to
10240 20 61 64 64 20 61 6e 20 65 6e 74 72 79 20 74 6f add an entry to
10250 20 61 6e 20 73 71 6c 69 74 65 33 2e 70 44 69 73 an sqlite3.pDis
10260 63 6f 6e 6e 65 63 74 0a 2a 2a 20 6c 69 73 74 20 connect.** list
10270 77 69 74 68 6f 75 74 20 68 6f 6c 64 69 6e 67 20 without holding
10280 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
10290 67 20 73 71 6c 69 74 65 33 2e 6d 75 74 65 78 20 g sqlite3.mutex
102a0 6d 75 74 65 78 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 mutex..**.** The
102b0 20 6d 65 6d 6f 72 79 20 66 6f 72 20 6f 62 6a 65 memory for obje
102c0 63 74 73 20 6f 66 20 74 68 69 73 20 74 79 70 65 cts of this type
102d0 20 69 73 20 61 6c 77 61 79 73 20 61 6c 6c 6f 63 is always alloc
102e0 61 74 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 ated by.** sqlit
102f0 65 33 44 62 4d 61 6c 6c 6f 63 28 29 2c 20 75 73 e3DbMalloc(), us
10300 69 6e 67 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 ing the connecti
10310 6f 6e 20 68 61 6e 64 6c 65 20 73 74 6f 72 65 64 on handle stored
10320 20 69 6e 20 56 54 61 62 6c 65 2e 64 62 20 61 73 in VTable.db as
10330 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 20 61 72 .** the first ar
10340 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 72 75 63 gument..*/.struc
10350 74 20 56 54 61 62 6c 65 20 7b 0a 20 20 73 71 6c t VTable {. sql
10360 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 ite3 *db;
10370 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 /* Databa
10380 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 73 se connection as
10390 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
103a0 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 4d 6f is table */. Mo
103b0 64 75 6c 65 20 2a 70 4d 6f 64 3b 20 20 20 20 20 dule *pMod;
103c0 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 /* Point
103d0 65 72 20 74 6f 20 6d 6f 64 75 6c 65 20 69 6d 70 er to module imp
103e0 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 lementation */.
103f0 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 sqlite3_vtab *p
10400 56 74 61 62 3b 20 20 20 20 20 20 2f 2a 20 50 6f Vtab; /* Po
10410 69 6e 74 65 72 20 74 6f 20 76 74 61 62 20 69 6e inter to vtab in
10420 73 74 61 6e 63 65 20 2a 2f 0a 20 20 69 6e 74 20 stance */. int
10430 6e 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 nRef;
10440 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
10450 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 of pointers to t
10460 68 69 73 20 73 74 72 75 63 74 75 72 65 20 2a 2f his structure */
10470 0a 20 20 75 38 20 62 43 6f 6e 73 74 72 61 69 6e . u8 bConstrain
10480 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 t; /*
10490 54 72 75 65 20 69 66 20 63 6f 6e 73 74 72 61 69 True if constrai
104a0 6e 74 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 nts are supporte
104b0 64 20 2a 2f 0a 20 20 69 6e 74 20 69 53 61 76 65 d */. int iSave
104c0 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 20 20 20 point;
104d0 20 2f 2a 20 44 65 70 74 68 20 6f 66 20 74 68 65 /* Depth of the
104e0 20 53 41 56 45 50 4f 49 4e 54 20 73 74 61 63 6b SAVEPOINT stack
104f0 20 2a 2f 0a 20 20 56 54 61 62 6c 65 20 2a 70 4e */. VTable *pN
10500 65 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 ext;
10510 2f 2a 20 4e 65 78 74 20 69 6e 20 6c 69 6e 6b 65 /* Next in linke
10520 64 20 6c 69 73 74 20 28 73 65 65 20 61 62 6f 76 d list (see abov
10530 65 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 e) */.};../*.**
10540 54 68 65 20 73 63 68 65 6d 61 20 66 6f 72 20 65 The schema for e
10550 61 63 68 20 53 51 4c 20 74 61 62 6c 65 20 61 6e ach SQL table an
10560 64 20 76 69 65 77 20 69 73 20 72 65 70 72 65 73 d view is repres
10570 65 6e 74 65 64 20 69 6e 20 6d 65 6d 6f 72 79 0a ented in memory.
10580 2a 2a 20 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 ** by an instanc
10590 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
105a0 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f ng structure..*/
105b0 0a 73 74 72 75 63 74 20 54 61 62 6c 65 20 7b 0a .struct Table {.
105c0 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
105d0 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
105e0 66 20 74 68 65 20 74 61 62 6c 65 20 6f 72 20 76 f the table or v
105f0 69 65 77 20 2a 2f 0a 20 20 43 6f 6c 75 6d 6e 20 iew */. Column
10600 2a 61 43 6f 6c 3b 20 20 20 20 20 20 20 20 2f 2a *aCol; /*
10610 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f Information abo
10620 75 74 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a ut each column *
10630 2f 0a 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 /. Index *pInde
10640 78 3b 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 x; /* List
10650 20 6f 66 20 53 51 4c 20 69 6e 64 65 78 65 73 20 of SQL indexes
10660 6f 6e 20 74 68 69 73 20 74 61 62 6c 65 2e 20 2a on this table. *
10670 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c /. Select *pSel
10680 65 63 74 3b 20 20 20 20 20 2f 2a 20 4e 55 4c 4c ect; /* NULL
10690 20 66 6f 72 20 74 61 62 6c 65 73 2e 20 20 50 6f for tables. Po
106a0 69 6e 74 73 20 74 6f 20 64 65 66 69 6e 69 74 69 ints to definiti
106b0 6f 6e 20 69 66 20 61 20 76 69 65 77 2e 20 2a 2f on if a view. */
106c0 0a 20 20 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20 . FKey *pFKey;
106d0 20 20 20 20 20 20 20 20 2f 2a 20 4c 69 6e 6b 65 /* Linke
106e0 64 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 66 6f d list of all fo
106f0 72 65 69 67 6e 20 6b 65 79 73 20 69 6e 20 74 68 reign keys in th
10700 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 63 68 is table */. ch
10710 61 72 20 2a 7a 43 6f 6c 41 66 66 3b 20 20 20 20 ar *zColAff;
10720 20 20 20 2f 2a 20 53 74 72 69 6e 67 20 64 65 66 /* String def
10730 69 6e 69 6e 67 20 74 68 65 20 61 66 66 69 6e 69 ining the affini
10740 74 79 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d ty of each colum
10750 6e 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 n */. ExprList
10760 2a 70 43 68 65 63 6b 3b 20 20 20 20 2f 2a 20 41 *pCheck; /* A
10770 6c 6c 20 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 ll CHECK constra
10780 69 6e 74 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 ints */.
10790 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
107a0 2a 20 20 20 2e 2e 2e 20 61 6c 73 6f 20 75 73 65 * ... also use
107b0 64 20 61 73 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 d as column name
107c0 20 6c 69 73 74 20 69 6e 20 61 20 56 49 45 57 20 list in a VIEW
107d0 2a 2f 0a 20 20 69 6e 74 20 74 6e 75 6d 3b 20 20 */. int tnum;
107e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f /* Roo
107f0 74 20 42 54 72 65 65 20 70 61 67 65 20 66 6f 72 t BTree page for
10800 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 this table */.
10810 20 69 31 36 20 69 50 4b 65 79 3b 20 20 20 20 20 i16 iPKey;
10820 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f 74 20 /* If not
10830 6e 65 67 61 74 69 76 65 2c 20 75 73 65 20 61 43 negative, use aC
10840 6f 6c 5b 69 50 4b 65 79 5d 20 61 73 20 74 68 65 ol[iPKey] as the
10850 20 72 6f 77 69 64 20 2a 2f 0a 20 20 69 31 36 20 rowid */. i16
10860 6e 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 nCol;
10870 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f /* Number of co
10880 6c 75 6d 6e 73 20 69 6e 20 74 68 69 73 20 74 61 lumns in this ta
10890 62 6c 65 20 2a 2f 0a 20 20 75 31 36 20 6e 52 65 ble */. u16 nRe
108a0 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a f; /*
108b0 20 4e 75 6d 62 65 72 20 6f 66 20 70 6f 69 6e 74 Number of point
108c0 65 72 73 20 74 6f 20 74 68 69 73 20 54 61 62 6c ers to this Tabl
108d0 65 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 6e 52 e */. LogEst nR
108e0 6f 77 4c 6f 67 45 73 74 3b 20 20 20 2f 2a 20 45 owLogEst; /* E
108f0 73 74 69 6d 61 74 65 64 20 72 6f 77 73 20 69 6e stimated rows in
10900 20 74 61 62 6c 65 20 2d 20 66 72 6f 6d 20 73 71 table - from sq
10910 6c 69 74 65 5f 73 74 61 74 31 20 74 61 62 6c 65 lite_stat1 table
10920 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 73 7a 54 */. LogEst szT
10930 61 62 52 6f 77 3b 20 20 20 20 20 2f 2a 20 45 73 abRow; /* Es
10940 74 69 6d 61 74 65 64 20 73 69 7a 65 20 6f 66 20 timated size of
10950 65 61 63 68 20 74 61 62 6c 65 20 72 6f 77 20 69 each table row i
10960 6e 20 62 79 74 65 73 20 2a 2f 0a 23 69 66 64 65 n bytes */.#ifde
10970 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
10980 43 4f 53 54 4d 55 4c 54 0a 20 20 4c 6f 67 45 73 COSTMULT. LogEs
10990 74 20 63 6f 73 74 4d 75 6c 74 3b 20 20 20 20 20 t costMult;
109a0 2f 2a 20 43 6f 73 74 20 6d 75 6c 74 69 70 6c 69 /* Cost multipli
109b0 65 72 20 66 6f 72 20 75 73 69 6e 67 20 74 68 69 er for using thi
109c0 73 20 74 61 62 6c 65 20 2a 2f 0a 23 65 6e 64 69 s table */.#endi
109d0 66 0a 20 20 75 38 20 74 61 62 46 6c 61 67 73 3b f. u8 tabFlags;
109e0 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b /* Mask
109f0 20 6f 66 20 54 46 5f 2a 20 76 61 6c 75 65 73 20 of TF_* values
10a00 2a 2f 0a 20 20 75 38 20 6b 65 79 43 6f 6e 66 3b */. u8 keyConf;
10a10 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 68 61 /* Wha
10a20 74 20 74 6f 20 64 6f 20 69 6e 20 63 61 73 65 20 t to do in case
10a30 6f 66 20 75 6e 69 71 75 65 6e 65 73 73 20 63 6f of uniqueness co
10a40 6e 66 6c 69 63 74 20 6f 6e 20 69 50 4b 65 79 20 nflict on iPKey
10a50 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
10a60 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 42 4c E_OMIT_ALTERTABL
10a70 45 0a 20 20 69 6e 74 20 61 64 64 43 6f 6c 4f 66 E. int addColOf
10a80 66 73 65 74 3b 20 20 20 20 2f 2a 20 4f 66 66 73 fset; /* Offs
10a90 65 74 20 69 6e 20 43 52 45 41 54 45 20 54 41 42 et in CREATE TAB
10aa0 4c 45 20 73 74 6d 74 20 74 6f 20 61 64 64 20 61 LE stmt to add a
10ab0 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 23 new column */.#
10ac0 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 51 endif.#ifndef SQ
10ad0 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 LITE_OMIT_VIRTUA
10ae0 4c 54 41 42 4c 45 0a 20 20 69 6e 74 20 6e 4d 6f LTABLE. int nMo
10af0 64 75 6c 65 41 72 67 3b 20 20 20 20 20 20 2f 2a duleArg; /*
10b00 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d Number of argum
10b10 65 6e 74 73 20 74 6f 20 74 68 65 20 6d 6f 64 75 ents to the modu
10b20 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 61 le */. char **a
10b30 7a 4d 6f 64 75 6c 65 41 72 67 3b 20 20 2f 2a 20 zModuleArg; /*
10b40 30 3a 20 6d 6f 64 75 6c 65 20 31 3a 20 73 63 68 0: module 1: sch
10b50 65 6d 61 20 32 3a 20 76 74 61 62 20 6e 61 6d 65 ema 2: vtab name
10b60 20 33 2e 2e 2e 3a 20 61 72 67 73 20 2a 2f 0a 20 3...: args */.
10b70 20 56 54 61 62 6c 65 20 2a 70 56 54 61 62 6c 65 VTable *pVTable
10b80 3b 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 ; /* List of
10b90 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 74 73 2e VTable objects.
10ba0 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 54 72 69 */.#endif. Tri
10bb0 67 67 65 72 20 2a 70 54 72 69 67 67 65 72 3b 20 gger *pTrigger;
10bc0 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 74 72 69 /* List of tri
10bd0 67 67 65 72 73 20 73 74 6f 72 65 64 20 69 6e 20 ggers stored in
10be0 70 53 63 68 65 6d 61 20 2a 2f 0a 20 20 53 63 68 pSchema */. Sch
10bf0 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 20 ema *pSchema;
10c00 20 20 2f 2a 20 53 63 68 65 6d 61 20 74 68 61 74 /* Schema that
10c10 20 63 6f 6e 74 61 69 6e 73 20 74 68 69 73 20 74 contains this t
10c20 61 62 6c 65 20 2a 2f 0a 20 20 54 61 62 6c 65 20 able */. Table
10c30 2a 70 4e 65 78 74 5a 6f 6d 62 69 65 3b 20 20 2f *pNextZombie; /
10c40 2a 20 4e 65 78 74 20 6f 6e 20 74 68 65 20 50 61 * Next on the Pa
10c50 72 73 65 2e 70 5a 6f 6d 62 69 65 54 61 62 20 6c rse.pZombieTab l
10c60 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ist */.};../*.**
10c70 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 Allowed values
10c80 66 6f 72 20 54 61 62 6c 65 2e 74 61 62 46 6c 61 for Table.tabFla
10c90 67 73 2e 0a 2a 2a 0a 2a 2a 20 54 46 5f 4f 4f 4f gs..**.** TF_OOO
10ca0 48 69 64 64 65 6e 20 61 70 70 6c 69 65 73 20 74 Hidden applies t
10cb0 6f 20 74 61 62 6c 65 73 20 6f 72 20 76 69 65 77 o tables or view
10cc0 20 74 68 61 74 20 68 61 76 65 20 68 69 64 64 65 that have hidde
10cd0 6e 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 61 n columns that a
10ce0 72 65 0a 2a 2a 20 66 6f 6c 6c 6f 77 65 64 20 62 re.** followed b
10cf0 79 20 6e 6f 6e 2d 68 69 64 64 65 6e 20 63 6f 6c y non-hidden col
10d00 75 6d 6e 73 2e 20 20 45 78 61 6d 70 6c 65 3a 20 umns. Example:
10d10 20 22 43 52 45 41 54 45 20 56 49 52 54 55 41 4c "CREATE VIRTUAL
10d20 20 54 41 42 4c 45 20 78 20 55 53 49 4e 47 0a 2a TABLE x USING.*
10d30 2a 20 76 74 61 62 31 28 61 20 48 49 44 44 45 4e * vtab1(a HIDDEN
10d40 2c 20 62 29 3b 22 2e 20 20 53 69 6e 63 65 20 22 , b);". Since "
10d50 62 22 20 69 73 20 61 20 6e 6f 6e 2d 68 69 64 64 b" is a non-hidd
10d60 65 6e 20 63 6f 6c 75 6d 6e 20 62 75 74 20 22 61 en column but "a
10d70 22 20 69 73 20 68 69 64 64 65 6e 2c 0a 2a 2a 20 " is hidden,.**
10d80 74 68 65 20 54 46 5f 4f 4f 4f 48 69 64 64 65 6e the TF_OOOHidden
10d90 20 61 74 74 72 69 62 75 74 65 20 77 6f 75 6c 64 attribute would
10da0 20 61 70 70 6c 79 20 69 6e 20 74 68 69 73 20 63 apply in this c
10db0 61 73 65 2e 20 20 53 75 63 68 20 74 61 62 6c 65 ase. Such table
10dc0 73 20 72 65 71 75 69 72 65 0a 2a 2a 20 73 70 65 s require.** spe
10dd0 63 69 61 6c 20 68 61 6e 64 6c 69 6e 67 20 64 75 cial handling du
10de0 72 69 6e 67 20 49 4e 53 45 52 54 20 70 72 6f 63 ring INSERT proc
10df0 65 73 73 69 6e 67 2e 0a 2a 2f 0a 23 64 65 66 69 essing..*/.#defi
10e00 6e 65 20 54 46 5f 52 65 61 64 6f 6e 6c 79 20 20 ne TF_Readonly
10e10 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
10e20 20 52 65 61 64 2d 6f 6e 6c 79 20 73 79 73 74 65 Read-only syste
10e30 6d 20 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 m table */.#defi
10e40 6e 65 20 54 46 5f 45 70 68 65 6d 65 72 61 6c 20 ne TF_Ephemeral
10e50 20 20 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 0x02 /*
10e60 20 41 6e 20 65 70 68 65 6d 65 72 61 6c 20 74 61 An ephemeral ta
10e70 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 ble */.#define T
10e80 46 5f 48 61 73 50 72 69 6d 61 72 79 4b 65 79 20 F_HasPrimaryKey
10e90 20 20 30 78 30 34 20 20 20 20 2f 2a 20 54 61 62 0x04 /* Tab
10ea0 6c 65 20 68 61 73 20 61 20 70 72 69 6d 61 72 79 le has a primary
10eb0 20 6b 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 key */.#define
10ec0 54 46 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 TF_Autoincrement
10ed0 20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 49 6e 0x08 /* In
10ee0 74 65 67 65 72 20 70 72 69 6d 61 72 79 20 6b 65 teger primary ke
10ef0 79 20 69 73 20 61 75 74 6f 69 6e 63 72 65 6d 65 y is autoincreme
10f00 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 nt */.#define TF
10f10 5f 56 69 72 74 75 61 6c 20 20 20 20 20 20 20 20 _Virtual
10f20 20 30 78 31 30 20 20 20 20 2f 2a 20 49 73 20 61 0x10 /* Is a
10f30 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 2a virtual table *
10f40 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 57 69 74 /.#define TF_Wit
10f50 68 6f 75 74 52 6f 77 69 64 20 20 20 20 30 78 32 houtRowid 0x2
10f60 30 20 20 20 20 2f 2a 20 4e 6f 20 72 6f 77 69 64 0 /* No rowid
10f70 2e 20 20 50 52 49 4d 41 52 59 20 4b 45 59 20 69 . PRIMARY KEY i
10f80 73 20 74 68 65 20 6b 65 79 20 2a 2f 0a 23 64 65 s the key */.#de
10f90 66 69 6e 65 20 54 46 5f 4e 6f 56 69 73 69 62 6c fine TF_NoVisibl
10fa0 65 52 6f 77 69 64 20 20 30 78 34 30 20 20 20 20 eRowid 0x40
10fb0 2f 2a 20 4e 6f 20 75 73 65 72 2d 76 69 73 69 62 /* No user-visib
10fc0 6c 65 20 22 72 6f 77 69 64 22 20 63 6f 6c 75 6d le "rowid" colum
10fd0 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f n */.#define TF_
10fe0 4f 4f 4f 48 69 64 64 65 6e 20 20 20 20 20 20 20 OOOHidden
10ff0 30 78 38 30 20 20 20 20 2f 2a 20 4f 75 74 2d 6f 0x80 /* Out-o
11000 66 2d 4f 72 64 65 72 20 68 69 64 64 65 6e 20 63 f-Order hidden c
11010 6f 6c 75 6d 6e 73 20 2a 2f 0a 0a 0a 2f 2a 0a 2a olumns */.../*.*
11020 2a 20 54 65 73 74 20 74 6f 20 73 65 65 20 77 68 * Test to see wh
11030 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 61 20 74 ether or not a t
11040 61 62 6c 65 20 69 73 20 61 20 76 69 72 74 75 61 able is a virtua
11050 6c 20 74 61 62 6c 65 2e 20 20 54 68 69 73 20 69 l table. This i
11060 73 0a 2a 2a 20 64 6f 6e 65 20 61 73 20 61 20 6d s.** done as a m
11070 61 63 72 6f 20 73 6f 20 74 68 61 74 20 69 74 20 acro so that it
11080 77 69 6c 6c 20 62 65 20 6f 70 74 69 6d 69 7a 65 will be optimize
11090 64 20 6f 75 74 20 77 68 65 6e 20 76 69 72 74 75 d out when virtu
110a0 61 6c 0a 2a 2a 20 74 61 62 6c 65 20 73 75 70 70 al.** table supp
110b0 6f 72 74 20 69 73 20 6f 6d 69 74 74 65 64 20 66 ort is omitted f
110c0 72 6f 6d 20 74 68 65 20 62 75 69 6c 64 2e 0a 2a rom the build..*
110d0 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
110e0 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
110f0 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 49 73 56 LE.# define IsV
11100 69 72 74 75 61 6c 28 58 29 20 20 20 20 20 20 28 irtual(X) (
11110 28 28 58 29 2d 3e 74 61 62 46 6c 61 67 73 20 26 ((X)->tabFlags &
11120 20 54 46 5f 56 69 72 74 75 61 6c 29 21 3d 30 29 TF_Virtual)!=0)
11130 0a 23 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 .#else.# define
11140 20 49 73 56 69 72 74 75 61 6c 28 58 29 20 20 20 IsVirtual(X)
11150 20 20 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 0.#endif../*.
11160 2a 2a 20 4d 61 63 72 6f 73 20 74 6f 20 64 65 74 ** Macros to det
11170 65 72 6d 69 6e 65 20 69 66 20 61 20 63 6f 6c 75 ermine if a colu
11180 6d 6e 20 69 73 20 68 69 64 64 65 6e 2e 20 20 49 mn is hidden. I
11190 73 4f 72 64 69 6e 61 72 79 48 69 64 64 65 6e 43 sOrdinaryHiddenC
111a0 6f 6c 75 6d 6e 28 29 0a 2a 2a 20 6f 6e 6c 79 20 olumn().** only
111b0 77 6f 72 6b 73 20 66 6f 72 20 6e 6f 6e 2d 76 69 works for non-vi
111c0 72 74 75 61 6c 20 74 61 62 6c 65 73 20 28 6f 72 rtual tables (or
111d0 64 69 6e 61 72 79 20 74 61 62 6c 65 73 20 61 6e dinary tables an
111e0 64 20 76 69 65 77 73 29 20 61 6e 64 20 69 73 0a d views) and is.
111f0 2a 2a 20 61 6c 77 61 79 73 20 66 61 6c 73 65 20 ** always false
11200 75 6e 6c 65 73 73 20 53 51 4c 49 54 45 5f 45 4e unless SQLITE_EN
11210 41 42 4c 45 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 ABLE_HIDDEN_COLU
11220 4d 4e 53 20 69 73 20 64 65 66 69 6e 65 64 2e 20 MNS is defined.
11230 20 54 68 65 0a 2a 2a 20 49 73 48 69 64 64 65 6e The.** IsHidden
11240 43 6f 6c 75 6d 6e 28 29 20 6d 61 63 72 6f 20 69 Column() macro i
11250 73 20 67 65 6e 65 72 61 6c 20 70 75 72 70 6f 73 s general purpos
11260 65 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 e..*/.#if define
11270 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f d(SQLITE_ENABLE_
11280 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e 53 29 0a HIDDEN_COLUMNS).
11290 23 20 20 64 65 66 69 6e 65 20 49 73 48 69 64 64 # define IsHidd
112a0 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 20 20 20 enColumn(X)
112b0 20 20 20 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c (((X)->colFl
112c0 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 ags & COLFLAG_HI
112d0 44 44 45 4e 29 21 3d 30 29 0a 23 20 20 64 65 66 DDEN)!=0).# def
112e0 69 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 48 69 ine IsOrdinaryHi
112f0 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 28 28 ddenColumn(X) ((
11300 28 58 29 2d 3e 63 6f 6c 46 6c 61 67 73 20 26 20 (X)->colFlags &
11310 43 4f 4c 46 4c 41 47 5f 48 49 44 44 45 4e 29 21 COLFLAG_HIDDEN)!
11320 3d 30 29 0a 23 65 6c 69 66 20 21 64 65 66 69 6e =0).#elif !defin
11330 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 ed(SQLITE_OMIT_V
11340 49 52 54 55 41 4c 54 41 42 4c 45 29 0a 23 20 20 IRTUALTABLE).#
11350 64 65 66 69 6e 65 20 49 73 48 69 64 64 65 6e 43 define IsHiddenC
11360 6f 6c 75 6d 6e 28 58 29 20 20 20 20 20 20 20 20 olumn(X)
11370 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c 61 67 73 (((X)->colFlags
11380 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 45 & COLFLAG_HIDDE
11390 4e 29 21 3d 30 29 0a 23 20 20 64 65 66 69 6e 65 N)!=0).# define
113a0 20 49 73 4f 72 64 69 6e 61 72 79 48 69 64 64 65 IsOrdinaryHidde
113b0 6e 43 6f 6c 75 6d 6e 28 58 29 20 30 0a 23 65 6c nColumn(X) 0.#el
113c0 73 65 0a 23 20 20 64 65 66 69 6e 65 20 49 73 48 se.# define IsH
113d0 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 20 iddenColumn(X)
113e0 20 20 20 20 20 20 20 30 0a 23 20 20 64 65 66 69 0.# defi
113f0 6e 65 20 49 73 4f 72 64 69 6e 61 72 79 48 69 64 ne IsOrdinaryHid
11400 64 65 6e 43 6f 6c 75 6d 6e 28 58 29 20 30 0a 23 denColumn(X) 0.#
11410 65 6e 64 69 66 0a 0a 0a 2f 2a 20 44 6f 65 73 20 endif.../* Does
11420 74 68 65 20 74 61 62 6c 65 20 68 61 76 65 20 61 the table have a
11430 20 72 6f 77 69 64 20 2a 2f 0a 23 64 65 66 69 6e rowid */.#defin
11440 65 20 48 61 73 52 6f 77 69 64 28 58 29 20 20 20 e HasRowid(X)
11450 20 20 28 28 28 58 29 2d 3e 74 61 62 46 6c 61 67 (((X)->tabFlag
11460 73 20 26 20 54 46 5f 57 69 74 68 6f 75 74 52 6f s & TF_WithoutRo
11470 77 69 64 29 3d 3d 30 29 0a 23 64 65 66 69 6e 65 wid)==0).#define
11480 20 56 69 73 69 62 6c 65 52 6f 77 69 64 28 58 29 VisibleRowid(X)
11490 20 28 28 28 58 29 2d 3e 74 61 62 46 6c 61 67 73 (((X)->tabFlags
114a0 20 26 20 54 46 5f 4e 6f 56 69 73 69 62 6c 65 52 & TF_NoVisibleR
114b0 6f 77 69 64 29 3d 3d 30 29 0a 0a 2f 2a 0a 2a 2a owid)==0)../*.**
114c0 20 45 61 63 68 20 66 6f 72 65 69 67 6e 20 6b 65 Each foreign ke
114d0 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 73 20 y constraint is
114e0 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 an instance of t
114f0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
11500 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 41 20 ucture..**.** A
11510 66 6f 72 65 69 67 6e 20 6b 65 79 20 69 73 20 61 foreign key is a
11520 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
11530 77 6f 20 74 61 62 6c 65 73 2e 20 20 54 68 65 20 wo tables. The
11540 22 66 72 6f 6d 22 20 74 61 62 6c 65 20 69 73 0a "from" table is.
11550 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 ** the table tha
11560 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 52 t contains the R
11570 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 EFERENCES clause
11580 20 74 68 61 74 20 63 72 65 61 74 65 73 20 74 68 that creates th
11590 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 6b 65 79 e foreign.** key
115a0 2e 20 20 54 68 65 20 22 74 6f 22 20 74 61 62 6c . The "to" tabl
115b0 65 20 69 73 20 74 68 65 20 74 61 62 6c 65 20 74 e is the table t
115c0 68 61 74 20 69 73 20 6e 61 6d 65 64 20 69 6e 20 hat is named in
115d0 74 68 65 20 52 45 46 45 52 45 4e 43 45 53 20 63 the REFERENCES c
115e0 6c 61 75 73 65 2e 0a 2a 2a 20 43 6f 6e 73 69 64 lause..** Consid
115f0 65 72 20 74 68 69 73 20 65 78 61 6d 70 6c 65 3a er this example:
11600 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 45 41 54 .**.** CREAT
11610 45 20 54 41 42 4c 45 20 65 78 31 28 0a 2a 2a 20 E TABLE ex1(.**
11620 20 20 20 20 20 20 61 20 49 4e 54 45 47 45 52 20 a INTEGER
11630 50 52 49 4d 41 52 59 20 4b 45 59 2c 0a 2a 2a 20 PRIMARY KEY,.**
11640 20 20 20 20 20 20 62 20 49 4e 54 45 47 45 52 20 b INTEGER
11650 43 4f 4e 53 54 52 41 49 4e 54 20 66 6b 31 20 52 CONSTRAINT fk1 R
11660 45 46 45 52 45 4e 43 45 53 20 65 78 32 28 78 29 EFERENCES ex2(x)
11670 0a 2a 2a 20 20 20 20 20 29 3b 0a 2a 2a 0a 2a 2a .** );.**.**
11680 20 46 6f 72 20 66 6f 72 65 69 67 6e 20 6b 65 79 For foreign key
11690 20 22 66 6b 31 22 2c 20 74 68 65 20 66 72 6f 6d "fk1", the from
116a0 2d 74 61 62 6c 65 20 69 73 20 22 65 78 31 22 20 -table is "ex1"
116b0 61 6e 64 20 74 68 65 20 74 6f 2d 74 61 62 6c 65 and the to-table
116c0 20 69 73 20 22 65 78 32 22 2e 0a 2a 2a 20 45 71 is "ex2"..** Eq
116d0 75 69 76 61 6c 65 6e 74 20 6e 61 6d 65 73 3a 0a uivalent names:.
116e0 2a 2a 0a 2a 2a 20 20 20 20 20 66 72 6f 6d 2d 74 **.** from-t
116f0 61 62 6c 65 20 3d 3d 20 63 68 69 6c 64 2d 74 61 able == child-ta
11700 62 6c 65 0a 2a 2a 20 20 20 20 20 20 20 74 6f 2d ble.** to-
11710 74 61 62 6c 65 20 3d 3d 20 70 61 72 65 6e 74 2d table == parent-
11720 74 61 62 6c 65 0a 2a 2a 0a 2a 2a 20 45 61 63 68 table.**.** Each
11730 20 52 45 46 45 52 45 4e 43 45 53 20 63 6c 61 75 REFERENCES clau
11740 73 65 20 67 65 6e 65 72 61 74 65 73 20 61 6e 20 se generates an
11750 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
11760 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
11770 75 72 65 0a 2a 2a 20 77 68 69 63 68 20 69 73 20 ure.** which is
11780 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 65 20 attached to the
11790 66 72 6f 6d 2d 74 61 62 6c 65 2e 20 20 54 68 65 from-table. The
117a0 20 74 6f 2d 74 61 62 6c 65 20 6e 65 65 64 20 6e to-table need n
117b0 6f 74 20 65 78 69 73 74 20 77 68 65 6e 0a 2a 2a ot exist when.**
117c0 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 20 the from-table
117d0 69 73 20 63 72 65 61 74 65 64 2e 20 20 54 68 65 is created. The
117e0 20 65 78 69 73 74 65 6e 63 65 20 6f 66 20 74 68 existence of th
117f0 65 20 74 6f 2d 74 61 62 6c 65 20 69 73 20 6e 6f e to-table is no
11800 74 20 63 68 65 63 6b 65 64 2e 0a 2a 2a 0a 2a 2a t checked..**.**
11810 20 54 68 65 20 6c 69 73 74 20 6f 66 20 61 6c 6c The list of all
11820 20 70 61 72 65 6e 74 73 20 66 6f 72 20 63 68 69 parents for chi
11830 6c 64 20 54 61 62 6c 65 20 58 20 69 73 20 68 65 ld Table X is he
11840 6c 64 20 61 74 20 58 2e 70 46 4b 65 79 2e 0a 2a ld at X.pFKey..*
11850 2a 0a 2a 2a 20 41 20 6c 69 73 74 20 6f 66 20 61 *.** A list of a
11860 6c 6c 20 63 68 69 6c 64 72 65 6e 20 66 6f 72 20 ll children for
11870 61 20 74 61 62 6c 65 20 6e 61 6d 65 64 20 5a 20 a table named Z
11880 28 77 68 69 63 68 20 6d 69 67 68 74 20 6e 6f 74 (which might not
11890 20 65 76 65 6e 20 65 78 69 73 74 29 0a 2a 2a 20 even exist).**
118a0 69 73 20 68 65 6c 64 20 69 6e 20 53 63 68 65 6d is held in Schem
118b0 61 2e 66 6b 65 79 48 61 73 68 20 77 69 74 68 20 a.fkeyHash with
118c0 61 20 68 61 73 68 20 6b 65 79 20 6f 66 20 5a 2e a hash key of Z.
118d0 0a 2a 2f 0a 73 74 72 75 63 74 20 46 4b 65 79 20 .*/.struct FKey
118e0 7b 0a 20 20 54 61 62 6c 65 20 2a 70 46 72 6f 6d {. Table *pFrom
118f0 3b 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 63 ; /* Table c
11900 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 52 45 ontaining the RE
11910 46 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 20 FERENCES clause
11920 28 61 6b 61 3a 20 43 68 69 6c 64 29 20 2a 2f 0a (aka: Child) */.
11930 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 46 72 6f FKey *pNextFro
11940 6d 3b 20 20 2f 2a 20 4e 65 78 74 20 46 4b 65 79 m; /* Next FKey
11950 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 69 with the same i
11960 6e 20 70 46 72 6f 6d 2e 20 4e 65 78 74 20 70 61 n pFrom. Next pa
11970 72 65 6e 74 20 6f 66 20 70 46 72 6f 6d 20 2a 2f rent of pFrom */
11980 0a 20 20 63 68 61 72 20 2a 7a 54 6f 3b 20 20 20 . char *zTo;
11990 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
119a0 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 20 6b table that the k
119b0 65 79 20 70 6f 69 6e 74 73 20 74 6f 20 28 61 6b ey points to (ak
119c0 61 3a 20 50 61 72 65 6e 74 29 20 2a 2f 0a 20 20 a: Parent) */.
119d0 46 4b 65 79 20 2a 70 4e 65 78 74 54 6f 3b 20 20 FKey *pNextTo;
119e0 20 20 2f 2a 20 4e 65 78 74 20 77 69 74 68 20 74 /* Next with t
119f0 68 65 20 73 61 6d 65 20 7a 54 6f 2e 20 4e 65 78 he same zTo. Nex
11a00 74 20 63 68 69 6c 64 20 6f 66 20 7a 54 6f 2e 20 t child of zTo.
11a10 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 50 72 65 76 */. FKey *pPrev
11a20 54 6f 3b 20 20 20 20 2f 2a 20 50 72 65 76 69 6f To; /* Previo
11a30 75 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 us with the same
11a40 20 7a 54 6f 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 zTo */. int nC
11a50 6f 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ol; /* N
11a60 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 umber of columns
11a70 20 69 6e 20 74 68 69 73 20 6b 65 79 20 2a 2f 0a in this key */.
11a80 20 20 2f 2a 20 45 56 3a 20 52 2d 33 30 33 32 33 /* EV: R-30323
11a90 2d 32 31 39 31 37 20 2a 2f 0a 20 20 75 38 20 69 -21917 */. u8 i
11aa0 73 44 65 66 65 72 72 65 64 3b 20 20 20 20 20 20 sDeferred;
11ab0 20 2f 2a 20 54 72 75 65 20 69 66 20 63 6f 6e 73 /* True if cons
11ac0 74 72 61 69 6e 74 20 63 68 65 63 6b 69 6e 67 20 traint checking
11ad0 69 73 20 64 65 66 65 72 72 65 64 20 74 69 6c 6c is deferred till
11ae0 20 43 4f 4d 4d 49 54 20 2a 2f 0a 20 20 75 38 20 COMMIT */. u8
11af0 61 41 63 74 69 6f 6e 5b 32 5d 3b 20 20 20 20 20 aAction[2];
11b00 20 20 20 2f 2a 20 4f 4e 20 44 45 4c 45 54 45 20 /* ON DELETE
11b10 61 6e 64 20 4f 4e 20 55 50 44 41 54 45 20 61 63 and ON UPDATE ac
11b20 74 69 6f 6e 73 2c 20 72 65 73 70 65 63 74 69 76 tions, respectiv
11b30 65 6c 79 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 ely */. Trigger
11b40 20 2a 61 70 54 72 69 67 67 65 72 5b 32 5d 3b 2f *apTrigger[2];/
11b50 2a 20 54 72 69 67 67 65 72 73 20 66 6f 72 20 61 * Triggers for a
11b60 41 63 74 69 6f 6e 5b 5d 20 61 63 74 69 6f 6e 73 Action[] actions
11b70 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 73 43 6f */. struct sCo
11b80 6c 4d 61 70 20 7b 20 20 20 20 20 20 2f 2a 20 4d lMap { /* M
11b90 61 70 70 69 6e 67 20 6f 66 20 63 6f 6c 75 6d 6e apping of column
11ba0 73 20 69 6e 20 70 46 72 6f 6d 20 74 6f 20 63 6f s in pFrom to co
11bb0 6c 75 6d 6e 73 20 69 6e 20 7a 54 6f 20 2a 2f 0a lumns in zTo */.
11bc0 20 20 20 20 69 6e 74 20 69 46 72 6f 6d 3b 20 20 int iFrom;
11bd0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
11be0 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 ex of column in
11bf0 70 46 72 6f 6d 20 2a 2f 0a 20 20 20 20 63 68 61 pFrom */. cha
11c00 72 20 2a 7a 43 6f 6c 3b 20 20 20 20 20 20 20 20 r *zCol;
11c10 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 63 6f /* Name of co
11c20 6c 75 6d 6e 20 69 6e 20 7a 54 6f 2e 20 20 49 66 lumn in zTo. If
11c30 20 4e 55 4c 4c 20 75 73 65 20 50 52 49 4d 41 52 NULL use PRIMAR
11c40 59 20 4b 45 59 20 2a 2f 0a 20 20 7d 20 61 43 6f Y KEY */. } aCo
11c50 6c 5b 31 5d 3b 20 20 20 20 20 20 20 20 20 20 20 l[1];
11c60 20 2f 2a 20 4f 6e 65 20 65 6e 74 72 79 20 66 6f /* One entry fo
11c70 72 20 65 61 63 68 20 6f 66 20 6e 43 6f 6c 20 63 r each of nCol c
11c80 6f 6c 75 6d 6e 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a olumns */.};../*
11c90 0a 2a 2a 20 53 51 4c 69 74 65 20 73 75 70 70 6f .** SQLite suppo
11ca0 72 74 73 20 6d 61 6e 79 20 64 69 66 66 65 72 65 rts many differe
11cb0 6e 74 20 77 61 79 73 20 74 6f 20 72 65 73 6f 6c nt ways to resol
11cc0 76 65 20 61 20 63 6f 6e 73 74 72 61 69 6e 74 0a ve a constraint.
11cd0 2a 2a 20 65 72 72 6f 72 2e 20 20 52 4f 4c 4c 42 ** error. ROLLB
11ce0 41 43 4b 20 70 72 6f 63 65 73 73 69 6e 67 20 6d ACK processing m
11cf0 65 61 6e 73 20 74 68 61 74 20 61 20 63 6f 6e 73 eans that a cons
11d00 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e traint violation
11d10 0a 2a 2a 20 63 61 75 73 65 73 20 74 68 65 20 6f .** causes the o
11d20 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 63 peration in proc
11d30 65 73 73 20 74 6f 20 66 61 69 6c 20 61 6e 64 20 ess to fail and
11d40 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 for the current
11d50 74 72 61 6e 73 61 63 74 69 6f 6e 0a 2a 2a 20 74 transaction.** t
11d60 6f 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b o be rolled back
11d70 2e 20 20 41 42 4f 52 54 20 70 72 6f 63 65 73 73 . ABORT process
11d80 69 6e 67 20 6d 65 61 6e 73 20 74 68 65 20 6f 70 ing means the op
11d90 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 6f 63 65 eration in proce
11da0 73 73 0a 2a 2a 20 66 61 69 6c 73 20 61 6e 64 20 ss.** fails and
11db0 61 6e 79 20 70 72 69 6f 72 20 63 68 61 6e 67 65 any prior change
11dc0 73 20 66 72 6f 6d 20 74 68 61 74 20 6f 6e 65 20 s from that one
11dd0 6f 70 65 72 61 74 69 6f 6e 20 61 72 65 20 62 61 operation are ba
11de0 63 6b 65 64 20 6f 75 74 2c 0a 2a 2a 20 62 75 74 cked out,.** but
11df0 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e the transaction
11e00 20 69 73 20 6e 6f 74 20 72 6f 6c 6c 65 64 20 62 is not rolled b
11e10 61 63 6b 2e 20 20 46 41 49 4c 20 70 72 6f 63 65 ack. FAIL proce
11e20 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 68 61 74 ssing means that
11e30 0a 2a 2a 20 74 68 65 20 6f 70 65 72 61 74 69 6f .** the operatio
11e40 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 20 73 74 n in progress st
11e50 6f 70 73 20 61 6e 64 20 72 65 74 75 72 6e 73 20 ops and returns
11e60 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 20 an error code.
11e70 42 75 74 20 70 72 69 6f 72 0a 2a 2a 20 63 68 61 But prior.** cha
11e80 6e 67 65 73 20 64 75 65 20 74 6f 20 74 68 65 20 nges due to the
11e90 73 61 6d 65 20 6f 70 65 72 61 74 69 6f 6e 20 61 same operation a
11ea0 72 65 20 6e 6f 74 20 62 61 63 6b 65 64 20 6f 75 re not backed ou
11eb0 74 20 61 6e 64 20 6e 6f 20 72 6f 6c 6c 62 61 63 t and no rollbac
11ec0 6b 0a 2a 2a 20 6f 63 63 75 72 73 2e 20 20 49 47 k.** occurs. IG
11ed0 4e 4f 52 45 20 6d 65 61 6e 73 20 74 68 61 74 20 NORE means that
11ee0 74 68 65 20 70 61 72 74 69 63 75 6c 61 72 20 72 the particular r
11ef0 6f 77 20 74 68 61 74 20 63 61 75 73 65 64 20 74 ow that caused t
11f00 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 0a 2a 2a he constraint.**
11f10 20 65 72 72 6f 72 20 69 73 20 6e 6f 74 20 69 6e error is not in
11f20 73 65 72 74 65 64 20 6f 72 20 75 70 64 61 74 65 serted or update
11f30 64 2e 20 20 50 72 6f 63 65 73 73 69 6e 67 20 63 d. Processing c
11f40 6f 6e 74 69 6e 75 65 73 20 61 6e 64 20 6e 6f 20 ontinues and no
11f50 65 72 72 6f 72 0a 2a 2a 20 69 73 20 72 65 74 75 error.** is retu
11f60 72 6e 65 64 2e 20 20 52 45 50 4c 41 43 45 20 6d rned. REPLACE m
11f70 65 61 6e 73 20 74 68 61 74 20 70 72 65 65 78 69 eans that preexi
11f80 73 74 69 6e 67 20 64 61 74 61 62 61 73 65 20 72 sting database r
11f90 6f 77 73 20 74 68 61 74 20 63 61 75 73 65 64 0a ows that caused.
11fa0 2a 2a 20 61 20 55 4e 49 51 55 45 20 63 6f 6e 73 ** a UNIQUE cons
11fb0 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e traint violation
11fc0 20 61 72 65 20 72 65 6d 6f 76 65 64 20 73 6f 20 are removed so
11fd0 74 68 61 74 20 74 68 65 20 6e 65 77 20 69 6e 73 that the new ins
11fe0 65 72 74 20 6f 72 0a 2a 2a 20 75 70 64 61 74 65 ert or.** update
11ff0 20 63 61 6e 20 70 72 6f 63 65 65 64 2e 20 20 50 can proceed. P
12000 72 6f 63 65 73 73 69 6e 67 20 63 6f 6e 74 69 6e rocessing contin
12010 75 65 73 20 61 6e 64 20 6e 6f 20 65 72 72 6f 72 ues and no error
12020 20 69 73 20 72 65 70 6f 72 74 65 64 2e 0a 2a 2a is reported..**
12030 0a 2a 2a 20 52 45 53 54 52 49 43 54 2c 20 53 45 .** RESTRICT, SE
12040 54 4e 55 4c 4c 2c 20 61 6e 64 20 43 41 53 43 41 TNULL, and CASCA
12050 44 45 20 61 63 74 69 6f 6e 73 20 61 70 70 6c 79 DE actions apply
12060 20 6f 6e 6c 79 20 74 6f 20 66 6f 72 65 69 67 6e only to foreign
12070 20 6b 65 79 73 2e 0a 2a 2a 20 52 45 53 54 52 49 keys..** RESTRI
12080 43 54 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 CT is the same a
12090 73 20 41 42 4f 52 54 20 66 6f 72 20 49 4d 4d 45 s ABORT for IMME
120a0 44 49 41 54 45 20 66 6f 72 65 69 67 6e 20 6b 65 DIATE foreign ke
120b0 79 73 20 61 6e 64 20 74 68 65 0a 2a 2a 20 73 61 ys and the.** sa
120c0 6d 65 20 61 73 20 52 4f 4c 4c 42 41 43 4b 20 66 me as ROLLBACK f
120d0 6f 72 20 44 45 46 45 52 52 45 44 20 6b 65 79 73 or DEFERRED keys
120e0 2e 20 20 53 45 54 4e 55 4c 4c 20 6d 65 61 6e 73 . SETNULL means
120f0 20 74 68 61 74 20 74 68 65 20 66 6f 72 65 69 67 that the foreig
12100 6e 0a 2a 2a 20 6b 65 79 20 69 73 20 73 65 74 20 n.** key is set
12110 74 6f 20 4e 55 4c 4c 2e 20 20 43 41 53 43 41 44 to NULL. CASCAD
12120 45 20 6d 65 61 6e 73 20 74 68 61 74 20 61 20 44 E means that a D
12130 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54 45 20 ELETE or UPDATE
12140 6f 66 20 74 68 65 0a 2a 2a 20 72 65 66 65 72 65 of the.** refere
12150 6e 63 65 64 20 74 61 62 6c 65 20 72 6f 77 20 69 nced table row i
12160 73 20 70 72 6f 70 61 67 61 74 65 64 20 69 6e 74 s propagated int
12170 6f 20 74 68 65 20 72 6f 77 20 74 68 61 74 20 68 o the row that h
12180 6f 6c 64 73 20 74 68 65 0a 2a 2a 20 66 6f 72 65 olds the.** fore
12190 69 67 6e 20 6b 65 79 2e 0a 2a 2a 0a 2a 2a 20 54 ign key..**.** T
121a0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 6d he following sym
121b0 62 6f 6c 69 63 20 76 61 6c 75 65 73 20 61 72 65 bolic values are
121c0 20 75 73 65 64 20 74 6f 20 72 65 63 6f 72 64 20 used to record
121d0 77 68 69 63 68 20 74 79 70 65 0a 2a 2a 20 6f 66 which type.** of
121e0 20 61 63 74 69 6f 6e 20 74 6f 20 74 61 6b 65 2e action to take.
121f0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 4e .*/.#define OE_N
12200 6f 6e 65 20 20 20 20 20 30 20 20 20 2f 2a 20 54 one 0 /* T
12210 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6e 73 74 here is no const
12220 72 61 69 6e 74 20 74 6f 20 63 68 65 63 6b 20 2a raint to check *
12230 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 52 6f 6c /.#define OE_Rol
12240 6c 62 61 63 6b 20 31 20 20 20 2f 2a 20 46 61 69 lback 1 /* Fai
12250 6c 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 l the operation
12260 61 6e 64 20 72 6f 6c 6c 62 61 63 6b 20 74 68 65 and rollback the
12270 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a transaction */.
12280 23 64 65 66 69 6e 65 20 4f 45 5f 41 62 6f 72 74 #define OE_Abort
12290 20 20 20 20 32 20 20 20 2f 2a 20 42 61 63 6b 20 2 /* Back
122a0 6f 75 74 20 63 68 61 6e 67 65 73 20 62 75 74 20 out changes but
122b0 64 6f 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 74 do no rollback t
122c0 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 23 64 ransaction */.#d
122d0 65 66 69 6e 65 20 4f 45 5f 46 61 69 6c 20 20 20 efine OE_Fail
122e0 20 20 33 20 20 20 2f 2a 20 53 74 6f 70 20 74 68 3 /* Stop th
122f0 65 20 6f 70 65 72 61 74 69 6f 6e 20 62 75 74 20 e operation but
12300 6c 65 61 76 65 20 61 6c 6c 20 70 72 69 6f 72 20 leave all prior
12310 63 68 61 6e 67 65 73 20 2a 2f 0a 23 64 65 66 69 changes */.#defi
12320 6e 65 20 4f 45 5f 49 67 6e 6f 72 65 20 20 20 34 ne OE_Ignore 4
12330 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68 65 /* Ignore the
12340 20 65 72 72 6f 72 2e 20 44 6f 20 6e 6f 74 20 64 error. Do not d
12350 6f 20 74 68 65 20 49 4e 53 45 52 54 20 6f 72 20 o the INSERT or
12360 55 50 44 41 54 45 20 2a 2f 0a 23 64 65 66 69 6e UPDATE */.#defin
12370 65 20 4f 45 5f 52 65 70 6c 61 63 65 20 20 35 20 e OE_Replace 5
12380 20 20 2f 2a 20 44 65 6c 65 74 65 20 65 78 69 73 /* Delete exis
12390 74 69 6e 67 20 72 65 63 6f 72 64 2c 20 74 68 65 ting record, the
123a0 6e 20 64 6f 20 49 4e 53 45 52 54 20 6f 72 20 55 n do INSERT or U
123b0 50 44 41 54 45 20 2a 2f 0a 0a 23 64 65 66 69 6e PDATE */..#defin
123c0 65 20 4f 45 5f 52 65 73 74 72 69 63 74 20 36 20 e OE_Restrict 6
123d0 20 20 2f 2a 20 4f 45 5f 41 62 6f 72 74 20 66 6f /* OE_Abort fo
123e0 72 20 49 4d 4d 45 44 49 41 54 45 2c 20 4f 45 5f r IMMEDIATE, OE_
123f0 52 6f 6c 6c 62 61 63 6b 20 66 6f 72 20 44 45 46 Rollback for DEF
12400 45 52 52 45 44 20 2a 2f 0a 23 64 65 66 69 6e 65 ERRED */.#define
12410 20 4f 45 5f 53 65 74 4e 75 6c 6c 20 20 37 20 20 OE_SetNull 7
12420 20 2f 2a 20 53 65 74 20 74 68 65 20 66 6f 72 65 /* Set the fore
12430 69 67 6e 20 6b 65 79 20 76 61 6c 75 65 20 74 6f ign key value to
12440 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 69 6e 65 NULL */.#define
12450 20 4f 45 5f 53 65 74 44 66 6c 74 20 20 38 20 20 OE_SetDflt 8
12460 20 2f 2a 20 53 65 74 20 74 68 65 20 66 6f 72 65 /* Set the fore
12470 69 67 6e 20 6b 65 79 20 76 61 6c 75 65 20 74 6f ign key value to
12480 20 69 74 73 20 64 65 66 61 75 6c 74 20 2a 2f 0a its default */.
12490 23 64 65 66 69 6e 65 20 4f 45 5f 43 61 73 63 61 #define OE_Casca
124a0 64 65 20 20 39 20 20 20 2f 2a 20 43 61 73 63 61 de 9 /* Casca
124b0 64 65 20 74 68 65 20 63 68 61 6e 67 65 73 20 2a de the changes *
124c0 2f 0a 0a 23 64 65 66 69 6e 65 20 4f 45 5f 44 65 /..#define OE_De
124d0 66 61 75 6c 74 20 20 31 30 20 20 2f 2a 20 44 6f fault 10 /* Do
124e0 20 77 68 61 74 65 76 65 72 20 74 68 65 20 64 65 whatever the de
124f0 66 61 75 6c 74 20 61 63 74 69 6f 6e 20 69 73 20 fault action is
12500 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e */.../*.** An in
12510 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
12520 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 llowing structur
12530 65 20 69 73 20 70 61 73 73 65 64 20 61 73 20 74 e is passed as t
12540 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 he first.** argu
12550 6d 65 6e 74 20 74 6f 20 73 71 6c 69 74 65 33 56 ment to sqlite3V
12560 64 62 65 4b 65 79 43 6f 6d 70 61 72 65 20 61 6e dbeKeyCompare an
12570 64 20 69 73 20 75 73 65 64 20 74 6f 20 63 6f 6e d is used to con
12580 74 72 6f 6c 20 74 68 65 0a 2a 2a 20 63 6f 6d 70 trol the.** comp
12590 61 72 69 73 6f 6e 20 6f 66 20 74 68 65 20 74 77 arison of the tw
125a0 6f 20 69 6e 64 65 78 20 6b 65 79 73 2e 0a 2a 2a o index keys..**
125b0 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 61 53 .** Note that aS
125c0 6f 72 74 4f 72 64 65 72 5b 5d 20 61 6e 64 20 61 ortOrder[] and a
125d0 43 6f 6c 6c 5b 5d 20 68 61 76 65 20 6e 46 69 65 Coll[] have nFie
125e0 6c 64 2b 31 20 73 6c 6f 74 73 2e 20 20 54 68 65 ld+1 slots. The
125f0 72 65 0a 2a 2a 20 61 72 65 20 6e 46 69 65 6c 64 re.** are nField
12600 20 73 6c 6f 74 73 20 66 6f 72 20 74 68 65 20 63 slots for the c
12610 6f 6c 75 6d 6e 73 20 6f 66 20 61 6e 20 69 6e 64 olumns of an ind
12620 65 78 20 74 68 65 6e 20 6f 6e 65 20 65 78 74 72 ex then one extr
12630 61 20 73 6c 6f 74 0a 2a 2a 20 66 6f 72 20 74 68 a slot.** for th
12640 65 20 72 6f 77 69 64 20 61 74 20 74 68 65 20 65 e rowid at the e
12650 6e 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4b 65 nd..*/.struct Ke
12660 79 49 6e 66 6f 20 7b 0a 20 20 75 33 32 20 6e 52 yInfo {. u32 nR
12670 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ef; /*
12680 20 4e 75 6d 62 65 72 20 6f 66 20 72 65 66 65 72 Number of refer
12690 65 6e 63 65 73 20 74 6f 20 74 68 69 73 20 4b 65 ences to this Ke
126a0 79 49 6e 66 6f 20 6f 62 6a 65 63 74 20 2a 2f 0a yInfo object */.
126b0 20 20 75 38 20 65 6e 63 3b 20 20 20 20 20 20 20 u8 enc;
126c0 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 65 6e /* Text en
126d0 63 6f 64 69 6e 67 20 2d 20 6f 6e 65 20 6f 66 20 coding - one of
126e0 74 68 65 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 the SQLITE_UTF*
126f0 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 31 36 20 values */. u16
12700 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 20 20 nField;
12710 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6b 65 79 /* Number of key
12720 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 columns in the
12730 69 6e 64 65 78 20 2a 2f 0a 20 20 75 31 36 20 6e index */. u16 n
12740 58 46 69 65 6c 64 3b 20 20 20 20 20 20 20 20 2f XField; /
12750 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 * Number of colu
12760 6d 6e 73 20 62 65 79 6f 6e 64 20 74 68 65 20 6b mns beyond the k
12770 65 79 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 ey columns */.
12780 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20 sqlite3 *db;
12790 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 61 62 /* The datab
127a0 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a ase connection *
127b0 2f 0a 20 20 75 38 20 2a 61 53 6f 72 74 4f 72 64 /. u8 *aSortOrd
127c0 65 72 3b 20 20 20 20 20 2f 2a 20 53 6f 72 74 20 er; /* Sort
127d0 6f 72 64 65 72 20 66 6f 72 20 65 61 63 68 20 63 order for each c
127e0 6f 6c 75 6d 6e 2e 20 2a 2f 0a 20 20 43 6f 6c 6c olumn. */. Coll
127f0 53 65 71 20 2a 61 43 6f 6c 6c 5b 31 5d 3b 20 20 Seq *aColl[1];
12800 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 73 65 71 /* Collating seq
12810 75 65 6e 63 65 20 66 6f 72 20 65 61 63 68 20 74 uence for each t
12820 65 72 6d 20 6f 66 20 74 68 65 20 6b 65 79 20 2a erm of the key *
12830 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 /.};../*.** This
12840 20 6f 62 6a 65 63 74 20 68 6f 6c 64 73 20 61 20 object holds a
12850 72 65 63 6f 72 64 20 77 68 69 63 68 20 68 61 73 record which has
12860 20 62 65 65 6e 20 70 61 72 73 65 64 20 6f 75 74 been parsed out
12870 20 69 6e 74 6f 20 69 6e 64 69 76 69 64 75 61 6c into individual
12880 0a 2a 2a 20 66 69 65 6c 64 73 2c 20 66 6f 72 20 .** fields, for
12890 74 68 65 20 70 75 72 70 6f 73 65 73 20 6f 66 20 the purposes of
128a0 64 6f 69 6e 67 20 61 20 63 6f 6d 70 61 72 69 73 doing a comparis
128b0 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 20 72 65 63 6f on..**.** A reco
128c0 72 64 20 69 73 20 61 6e 20 6f 62 6a 65 63 74 20 rd is an object
128d0 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 6f 6e that contains on
128e0 65 20 6f 72 20 6d 6f 72 65 20 66 69 65 6c 64 73 e or more fields
128f0 20 6f 66 20 64 61 74 61 2e 0a 2a 2a 20 52 65 63 of data..** Rec
12900 6f 72 64 73 20 61 72 65 20 75 73 65 64 20 74 6f ords are used to
12910 20 73 74 6f 72 65 20 74 68 65 20 63 6f 6e 74 65 store the conte
12920 6e 74 20 6f 66 20 61 20 74 61 62 6c 65 20 72 6f nt of a table ro
12930 77 20 61 6e 64 20 74 6f 20 73 74 6f 72 65 0a 2a w and to store.*
12940 2a 20 74 68 65 20 6b 65 79 20 6f 66 20 61 6e 20 * the key of an
12950 69 6e 64 65 78 2e 20 20 41 20 62 6c 6f 62 20 65 index. A blob e
12960 6e 63 6f 64 69 6e 67 20 6f 66 20 61 20 72 65 63 ncoding of a rec
12970 6f 72 64 20 69 73 20 63 72 65 61 74 65 64 20 62 ord is created b
12980 79 0a 2a 2a 20 74 68 65 20 4f 50 5f 4d 61 6b 65 y.** the OP_Make
12990 52 65 63 6f 72 64 20 6f 70 63 6f 64 65 20 6f 66 Record opcode of
129a0 20 74 68 65 20 56 44 42 45 20 61 6e 64 20 69 73 the VDBE and is
129b0 20 64 69 73 61 73 73 65 6d 62 6c 65 64 20 62 79 disassembled by
129c0 20 74 68 65 0a 2a 2a 20 4f 50 5f 43 6f 6c 75 6d the.** OP_Colum
129d0 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 n opcode..**.**
129e0 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 An instance of t
129f0 68 69 73 20 6f 62 6a 65 63 74 20 73 65 72 76 65 his object serve
12a00 73 20 61 73 20 61 20 22 6b 65 79 22 20 66 6f 72 s as a "key" for
12a10 20 64 6f 69 6e 67 20 61 20 73 65 61 72 63 68 20 doing a search
12a20 6f 6e 0a 2a 2a 20 61 6e 20 69 6e 64 65 78 20 62 on.** an index b
12a30 2b 74 72 65 65 2e 20 54 68 65 20 67 6f 61 6c 20 +tree. The goal
12a40 6f 66 20 74 68 65 20 73 65 61 72 63 68 20 69 73 of the search is
12a50 20 74 6f 20 66 69 6e 64 20 74 68 65 20 65 6e 74 to find the ent
12a60 72 79 20 74 68 61 74 0a 2a 2a 20 69 73 20 63 6c ry that.** is cl
12a70 6f 73 65 64 20 74 6f 20 74 68 65 20 6b 65 79 20 osed to the key
12a80 64 65 73 63 72 69 62 65 64 20 62 79 20 74 68 69 described by thi
12a90 73 20 6f 62 6a 65 63 74 2e 20 20 54 68 69 73 20 s object. This
12aa0 6f 62 6a 65 63 74 20 6d 69 67 68 74 20 68 6f 6c object might hol
12ab0 64 0a 2a 2a 20 6a 75 73 74 20 61 20 70 72 65 66 d.** just a pref
12ac0 69 78 20 6f 66 20 74 68 65 20 6b 65 79 2e 20 20 ix of the key.
12ad0 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 69 The number of fi
12ae0 65 6c 64 73 20 69 73 20 67 69 76 65 6e 20 62 79 elds is given by
12af0 0a 2a 2a 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 .** pKeyInfo->nF
12b00 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 ield..**.** The
12b10 72 31 20 61 6e 64 20 72 32 20 66 69 65 6c 64 73 r1 and r2 fields
12b20 20 61 72 65 20 74 68 65 20 76 61 6c 75 65 73 20 are the values
12b30 74 6f 20 72 65 74 75 72 6e 20 69 66 20 74 68 69 to return if thi
12b40 73 20 6b 65 79 20 69 73 20 6c 65 73 73 20 74 68 s key is less th
12b50 61 6e 0a 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 an.** or greater
12b60 20 74 68 61 6e 20 61 20 6b 65 79 20 69 6e 20 74 than a key in t
12b70 68 65 20 62 74 72 65 65 2c 20 72 65 73 70 65 63 he btree, respec
12b80 74 69 76 65 6c 79 2e 20 20 54 68 65 73 65 20 61 tively. These a
12b90 72 65 20 6e 6f 72 6d 61 6c 6c 79 0a 2a 2a 20 2d re normally.** -
12ba0 31 20 61 6e 64 20 2b 31 20 72 65 73 70 65 63 74 1 and +1 respect
12bb0 69 76 65 6c 79 2c 20 62 75 74 20 6d 69 67 68 74 ively, but might
12bc0 20 62 65 20 69 6e 76 65 72 74 65 64 20 74 6f 20 be inverted to
12bd0 2b 31 20 61 6e 64 20 2d 31 20 69 66 20 74 68 65 +1 and -1 if the
12be0 20 62 2d 74 72 65 65 0a 2a 2a 20 69 73 20 69 6e b-tree.** is in
12bf0 20 44 45 53 43 20 6f 72 64 65 72 2e 0a 2a 2a 0a DESC order..**.
12c00 2a 2a 20 54 68 65 20 6b 65 79 20 63 6f 6d 70 61 ** The key compa
12c10 72 69 73 6f 6e 20 66 75 6e 63 74 69 6f 6e 73 20 rison functions
12c20 61 63 74 75 61 6c 6c 79 20 72 65 74 75 72 6e 20 actually return
12c30 64 65 66 61 75 6c 74 5f 72 63 20 77 68 65 6e 20 default_rc when
12c40 74 68 65 79 20 66 69 6e 64 0a 2a 2a 20 61 6e 20 they find.** an
12c50 65 71 75 61 6c 73 20 63 6f 6d 70 61 72 69 73 6f equals compariso
12c60 6e 2e 20 20 64 65 66 61 75 6c 74 5f 72 63 20 63 n. default_rc c
12c70 61 6e 20 62 65 20 2d 31 2c 20 30 2c 20 6f 72 20 an be -1, 0, or
12c80 2b 31 2e 20 20 49 66 20 74 68 65 72 65 20 61 72 +1. If there ar
12c90 65 0a 2a 2a 20 6d 75 6c 74 69 70 6c 65 20 65 6e e.** multiple en
12ca0 74 72 69 65 73 20 69 6e 20 74 68 65 20 62 2d 74 tries in the b-t
12cb0 72 65 65 20 77 69 74 68 20 74 68 65 20 73 61 6d ree with the sam
12cc0 65 20 6b 65 79 20 28 77 68 65 6e 20 6f 6e 6c 79 e key (when only
12cd0 20 6c 6f 6f 6b 69 6e 67 0a 2a 2a 20 61 74 20 74 looking.** at t
12ce0 68 65 20 66 69 72 73 74 20 70 4b 65 79 49 6e 66 he first pKeyInf
12cf0 6f 2d 3e 6e 46 69 65 6c 64 73 2c 29 20 74 68 65 o->nFields,) the
12d00 6e 20 64 65 66 61 75 6c 74 5f 72 63 20 63 61 6e n default_rc can
12d10 20 62 65 20 73 65 74 20 74 6f 20 2d 31 20 74 6f be set to -1 to
12d20 0a 2a 2a 20 63 61 75 73 65 20 74 68 65 20 73 65 .** cause the se
12d30 61 72 63 68 20 74 6f 20 66 69 6e 64 20 74 68 65 arch to find the
12d40 20 6c 61 73 74 20 6d 61 74 63 68 2c 20 6f 72 20 last match, or
12d50 2b 31 20 74 6f 20 63 61 75 73 65 20 74 68 65 20 +1 to cause the
12d60 73 65 61 72 63 68 20 74 6f 0a 2a 2a 20 66 69 6e search to.** fin
12d70 64 20 74 68 65 20 66 69 72 73 74 20 6d 61 74 63 d the first matc
12d80 68 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6b 65 79 h..**.** The key
12d90 20 63 6f 6d 70 61 72 69 73 6f 6e 20 66 75 6e 63 comparison func
12da0 74 69 6f 6e 73 20 77 69 6c 6c 20 73 65 74 20 65 tions will set e
12db0 71 53 65 65 6e 20 74 6f 20 74 72 75 65 20 69 66 qSeen to true if
12dc0 20 74 68 65 79 20 65 76 65 72 0a 2a 2a 20 67 65 they ever.** ge
12dd0 74 20 61 6e 64 20 65 71 75 61 6c 20 72 65 73 75 t and equal resu
12de0 6c 74 73 20 77 68 65 6e 20 63 6f 6d 70 61 72 69 lts when compari
12df0 6e 67 20 74 68 69 73 20 73 74 72 75 63 74 75 72 ng this structur
12e00 65 20 74 6f 20 61 20 62 2d 74 72 65 65 20 72 65 e to a b-tree re
12e10 63 6f 72 64 2e 0a 2a 2a 20 57 68 65 6e 20 64 65 cord..** When de
12e20 66 61 75 6c 74 5f 72 63 21 3d 30 2c 20 74 68 65 fault_rc!=0, the
12e30 20 73 65 61 72 63 68 20 6d 69 67 68 74 20 65 6e search might en
12e40 64 20 75 70 20 6f 6e 20 74 68 65 20 72 65 63 6f d up on the reco
12e50 72 64 20 69 6d 6d 65 64 69 61 74 65 6c 79 0a 2a rd immediately.*
12e60 2a 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 * before the fir
12e70 73 74 20 6d 61 74 63 68 20 6f 72 20 69 6d 6d 65 st match or imme
12e80 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 74 68 diately after th
12e90 65 20 6c 61 73 74 20 6d 61 74 63 68 2e 20 20 54 e last match. T
12ea0 68 65 0a 2a 2a 20 65 71 53 65 65 6e 20 66 69 65 he.** eqSeen fie
12eb0 6c 64 20 77 69 6c 6c 20 69 6e 64 69 63 61 74 65 ld will indicate
12ec0 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 whether or not
12ed0 61 6e 20 65 78 61 63 74 20 6d 61 74 63 68 20 65 an exact match e
12ee0 78 69 73 74 73 20 69 6e 20 74 68 65 0a 2a 2a 20 xists in the.**
12ef0 62 2d 74 72 65 65 2e 0a 2a 2f 0a 73 74 72 75 63 b-tree..*/.struc
12f00 74 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 t UnpackedRecord
12f10 20 7b 0a 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b {. KeyInfo *pK
12f20 65 79 49 6e 66 6f 3b 20 20 2f 2a 20 43 6f 6c 6c eyInfo; /* Coll
12f30 61 74 69 6f 6e 20 61 6e 64 20 73 6f 72 74 2d 6f ation and sort-o
12f40 72 64 65 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e rder information
12f50 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d 65 6d 3b */. Mem *aMem;
12f60 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c /* Val
12f70 75 65 73 20 2a 2f 0a 20 20 75 31 36 20 6e 46 69 ues */. u16 nFi
12f80 65 6c 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 eld; /*
12f90 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 Number of entrie
12fa0 73 20 69 6e 20 61 70 4d 65 6d 5b 5d 20 2a 2f 0a s in apMem[] */.
12fb0 20 20 69 38 20 64 65 66 61 75 6c 74 5f 72 63 3b i8 default_rc;
12fc0 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 61 72 69 /* Compari
12fd0 73 6f 6e 20 72 65 73 75 6c 74 20 69 66 20 6b 65 son result if ke
12fe0 79 73 20 61 72 65 20 65 71 75 61 6c 20 2a 2f 0a ys are equal */.
12ff0 20 20 75 38 20 65 72 72 43 6f 64 65 3b 20 20 20 u8 errCode;
13000 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 64 /* Error d
13010 65 74 65 63 74 65 64 20 62 79 20 78 52 65 63 6f etected by xReco
13020 72 64 43 6f 6d 70 61 72 65 20 28 43 4f 52 52 55 rdCompare (CORRU
13030 50 54 20 6f 72 20 4e 4f 4d 45 4d 29 20 2a 2f 0a PT or NOMEM) */.
13040 20 20 69 38 20 72 31 3b 20 20 20 20 20 20 20 20 i8 r1;
13050 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 /* Value t
13060 6f 20 72 65 74 75 72 6e 20 69 66 20 28 6c 68 73 o return if (lhs
13070 20 3e 20 72 68 73 29 20 2a 2f 0a 20 20 69 38 20 > rhs) */. i8
13080 72 32 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 r2;
13090 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 /* Value to ret
130a0 75 72 6e 20 69 66 20 28 72 68 73 20 3c 20 6c 68 urn if (rhs < lh
130b0 73 29 20 2a 2f 0a 20 20 75 38 20 65 71 53 65 65 s) */. u8 eqSee
130c0 6e 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 n; /* T
130d0 72 75 65 20 69 66 20 61 6e 20 65 71 75 61 6c 69 rue if an equali
130e0 74 79 20 63 6f 6d 70 61 72 69 73 6f 6e 20 68 61 ty comparison ha
130f0 73 20 62 65 65 6e 20 73 65 65 6e 20 2a 2f 0a 7d s been seen */.}
13100 3b 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 ;.../*.** Each S
13110 51 4c 20 69 6e 64 65 78 20 69 73 20 72 65 70 72 QL index is repr
13120 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 6d 6f 72 esented in memor
13130 79 20 62 79 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 y by an.** insta
13140 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f nce of the follo
13150 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a wing structure..
13160 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 6c 75 6d 6e **.** The column
13170 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 s of the table t
13180 68 61 74 20 61 72 65 20 74 6f 20 62 65 20 69 6e hat are to be in
13190 64 65 78 65 64 20 61 72 65 20 64 65 73 63 72 69 dexed are descri
131a0 62 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 61 69 bed.** by the ai
131b0 43 6f 6c 75 6d 6e 5b 5d 20 66 69 65 6c 64 20 6f Column[] field o
131c0 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 f this structure
131d0 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 . For example,
131e0 73 75 70 70 6f 73 65 0a 2a 2a 20 77 65 20 68 61 suppose.** we ha
131f0 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 ve the following
13200 20 74 61 62 6c 65 20 61 6e 64 20 69 6e 64 65 78 table and index
13210 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 45 41 :.**.** CREA
13220 54 45 20 54 41 42 4c 45 20 45 78 31 28 63 31 20 TE TABLE Ex1(c1
13230 69 6e 74 2c 20 63 32 20 69 6e 74 2c 20 63 33 20 int, c2 int, c3
13240 74 65 78 74 29 3b 0a 2a 2a 20 20 20 20 20 43 52 text);.** CR
13250 45 41 54 45 20 49 4e 44 45 58 20 45 78 32 20 4f EATE INDEX Ex2 O
13260 4e 20 45 78 31 28 63 33 2c 63 31 29 3b 0a 2a 2a N Ex1(c3,c1);.**
13270 0a 2a 2a 20 49 6e 20 74 68 65 20 54 61 62 6c 65 .** In the Table
13280 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 72 structure descr
13290 69 62 69 6e 67 20 45 78 31 2c 20 6e 43 6f 6c 3d ibing Ex1, nCol=
132a0 3d 33 20 62 65 63 61 75 73 65 20 74 68 65 72 65 =3 because there
132b0 20 61 72 65 0a 2a 2a 20 74 68 72 65 65 20 63 6f are.** three co
132c0 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62 lumns in the tab
132d0 6c 65 2e 20 20 49 6e 20 74 68 65 20 49 6e 64 65 le. In the Inde
132e0 78 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 x structure desc
132f0 72 69 62 69 6e 67 0a 2a 2a 20 45 78 32 2c 20 6e ribing.** Ex2, n
13300 43 6f 6c 75 6d 6e 3d 3d 32 20 73 69 6e 63 65 20 Column==2 since
13310 32 20 6f 66 20 74 68 65 20 33 20 63 6f 6c 75 6d 2 of the 3 colum
13320 6e 73 20 6f 66 20 45 78 31 20 61 72 65 20 69 6e ns of Ex1 are in
13330 64 65 78 65 64 2e 0a 2a 2a 20 54 68 65 20 76 61 dexed..** The va
13340 6c 75 65 20 6f 66 20 61 69 43 6f 6c 75 6d 6e 20 lue of aiColumn
13350 69 73 20 7b 32 2c 20 30 7d 2e 20 20 61 69 43 6f is {2, 0}. aiCo
13360 6c 75 6d 6e 5b 30 5d 3d 3d 32 20 62 65 63 61 75 lumn[0]==2 becau
13370 73 65 20 74 68 65 0a 2a 2a 20 66 69 72 73 74 20 se the.** first
13380 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 69 6e 64 column to be ind
13390 65 78 65 64 20 28 63 33 29 20 68 61 73 20 61 6e exed (c3) has an
133a0 20 69 6e 64 65 78 20 6f 66 20 32 20 69 6e 20 45 index of 2 in E
133b0 78 31 2e 61 43 6f 6c 5b 5d 2e 0a 2a 2a 20 54 68 x1.aCol[]..** Th
133c0 65 20 73 65 63 6f 6e 64 20 63 6f 6c 75 6d 6e 20 e second column
133d0 74 6f 20 62 65 20 69 6e 64 65 78 65 64 20 28 63 to be indexed (c
133e0 31 29 20 68 61 73 20 61 6e 20 69 6e 64 65 78 20 1) has an index
133f0 6f 66 20 30 20 69 6e 0a 2a 2a 20 45 78 31 2e 61 of 0 in.** Ex1.a
13400 43 6f 6c 5b 5d 2c 20 68 65 6e 63 65 20 45 78 32 Col[], hence Ex2
13410 2e 61 69 43 6f 6c 75 6d 6e 5b 31 5d 3d 3d 30 2e .aiColumn[1]==0.
13420 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 6e 64 65 78 .**.** The Index
13430 2e 6f 6e 45 72 72 6f 72 20 66 69 65 6c 64 20 64 .onError field d
13440 65 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 etermines whethe
13450 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 69 6e 64 r or not the ind
13460 65 78 65 64 20 63 6f 6c 75 6d 6e 73 0a 2a 2a 20 exed columns.**
13470 6d 75 73 74 20 62 65 20 75 6e 69 71 75 65 20 61 must be unique a
13480 6e 64 20 77 68 61 74 20 74 6f 20 64 6f 20 69 66 nd what to do if
13490 20 74 68 65 79 20 61 72 65 20 6e 6f 74 2e 20 20 they are not.
134a0 57 68 65 6e 20 49 6e 64 65 78 2e 6f 6e 45 72 72 When Index.onErr
134b0 6f 72 3d 4f 45 5f 4e 6f 6e 65 2c 0a 2a 2a 20 69 or=OE_None,.** i
134c0 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73 20 t means this is
134d0 6e 6f 74 20 61 20 75 6e 69 71 75 65 20 69 6e 64 not a unique ind
134e0 65 78 2e 20 20 4f 74 68 65 72 77 69 73 65 20 69 ex. Otherwise i
134f0 74 20 69 73 20 61 20 75 6e 69 71 75 65 20 69 6e t is a unique in
13500 64 65 78 0a 2a 2a 20 61 6e 64 20 74 68 65 20 76 dex.** and the v
13510 61 6c 75 65 20 6f 66 20 49 6e 64 65 78 2e 6f 6e alue of Index.on
13520 45 72 72 6f 72 20 69 6e 64 69 63 61 74 65 20 74 Error indicate t
13530 68 65 20 77 68 69 63 68 20 63 6f 6e 66 6c 69 63 he which conflic
13540 74 20 72 65 73 6f 6c 75 74 69 6f 6e 0a 2a 2a 20 t resolution.**
13550 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 65 6d 70 algorithm to emp
13560 6c 6f 79 20 77 68 65 6e 65 76 65 72 20 61 6e 20 loy whenever an
13570 61 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 attempt is made
13580 74 6f 20 69 6e 73 65 72 74 20 61 20 6e 6f 6e 2d to insert a non-
13590 75 6e 69 71 75 65 0a 2a 2a 20 65 6c 65 6d 65 6e unique.** elemen
135a0 74 2e 0a 2a 2a 0a 2a 2a 20 57 68 69 6c 65 20 70 t..**.** While p
135b0 61 72 73 69 6e 67 20 61 20 43 52 45 41 54 45 20 arsing a CREATE
135c0 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20 TABLE or CREATE
135d0 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74 20 INDEX statement
135e0 69 6e 20 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 67 in order to.** g
135f0 65 6e 65 72 61 74 65 20 56 44 42 45 20 63 6f 64 enerate VDBE cod
13600 65 20 28 61 73 20 6f 70 70 6f 73 65 64 20 74 6f e (as opposed to
13610 20 70 61 72 73 69 6e 67 20 6f 6e 65 20 72 65 61 parsing one rea
13620 64 20 66 72 6f 6d 20 61 6e 20 73 71 6c 69 74 65 d from an sqlite
13630 5f 6d 61 73 74 65 72 0a 2a 2a 20 74 61 62 6c 65 _master.** table
13640 20 61 73 20 70 61 72 74 20 6f 66 20 70 61 72 73 as part of pars
13650 69 6e 67 20 61 6e 20 65 78 69 73 74 69 6e 67 20 ing an existing
13660 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 29 database schema)
13670 2c 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 73 74 , transient inst
13680 61 6e 63 65 73 0a 2a 2a 20 6f 66 20 74 68 69 73 ances.** of this
13690 20 73 74 72 75 63 74 75 72 65 20 6d 61 79 20 62 structure may b
136a0 65 20 63 72 65 61 74 65 64 2e 20 49 6e 20 74 68 e created. In th
136b0 69 73 20 63 61 73 65 20 74 68 65 20 49 6e 64 65 is case the Inde
136c0 78 2e 74 6e 75 6d 20 76 61 72 69 61 62 6c 65 20 x.tnum variable
136d0 69 73 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 is.** used to st
136e0 6f 72 65 20 74 68 65 20 61 64 64 72 65 73 73 20 ore the address
136f0 6f 66 20 61 20 56 44 42 45 20 69 6e 73 74 72 75 of a VDBE instru
13700 63 74 69 6f 6e 2c 20 6e 6f 74 20 61 20 64 61 74 ction, not a dat
13710 61 62 61 73 65 20 70 61 67 65 0a 2a 2a 20 6e 75 abase page.** nu
13720 6d 62 65 72 20 28 69 74 20 63 61 6e 6e 6f 74 20 mber (it cannot
13730 2d 20 74 68 65 20 64 61 74 61 62 61 73 65 20 70 - the database p
13740 61 67 65 20 69 73 20 6e 6f 74 20 61 6c 6c 6f 63 age is not alloc
13750 61 74 65 64 20 75 6e 74 69 6c 20 74 68 65 20 56 ated until the V
13760 44 42 45 0a 2a 2a 20 70 72 6f 67 72 61 6d 20 69 DBE.** program i
13770 73 20 65 78 65 63 75 74 65 64 29 2e 20 53 65 65 s executed). See
13780 20 63 6f 6e 76 65 72 74 54 6f 57 69 74 68 6f 75 convertToWithou
13790 74 52 6f 77 69 64 54 61 62 6c 65 28 29 20 66 6f tRowidTable() fo
137a0 72 20 64 65 74 61 69 6c 73 2e 0a 2a 2f 0a 73 74 r details..*/.st
137b0 72 75 63 74 20 49 6e 64 65 78 20 7b 0a 20 20 63 ruct Index {. c
137c0 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
137d0 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
137e0 6f 66 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f of this index */
137f0 0a 20 20 69 31 36 20 2a 61 69 43 6f 6c 75 6d 6e . i16 *aiColumn
13800 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 ; /* W
13810 68 69 63 68 20 63 6f 6c 75 6d 6e 73 20 61 72 65 hich columns are
13820 20 75 73 65 64 20 62 79 20 74 68 69 73 20 69 6e used by this in
13830 64 65 78 2e 20 20 31 73 74 20 69 73 20 30 20 2a dex. 1st is 0 *
13840 2f 0a 20 20 4c 6f 67 45 73 74 20 2a 61 69 52 6f /. LogEst *aiRo
13850 77 4c 6f 67 45 73 74 3b 20 20 20 20 20 2f 2a 20 wLogEst; /*
13860 46 72 6f 6d 20 41 4e 41 4c 59 5a 45 3a 20 45 73 From ANALYZE: Es
13870 74 2e 20 72 6f 77 73 20 73 65 6c 65 63 74 65 64 t. rows selected
13880 20 62 79 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 by each column
13890 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 */. Table *pTab
138a0 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a le; /*
138b0 20 54 68 65 20 53 51 4c 20 74 61 62 6c 65 20 62 The SQL table b
138c0 65 69 6e 67 20 69 6e 64 65 78 65 64 20 2a 2f 0a eing indexed */.
138d0 20 20 63 68 61 72 20 2a 7a 43 6f 6c 41 66 66 3b char *zColAff;
138e0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 /* St
138f0 72 69 6e 67 20 64 65 66 69 6e 69 6e 67 20 74 68 ring defining th
13900 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 65 61 e affinity of ea
13910 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 49 ch column */. I
13920 6e 64 65 78 20 2a 70 4e 65 78 74 3b 20 20 20 20 ndex *pNext;
13930 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e /* The n
13940 65 78 74 20 69 6e 64 65 78 20 61 73 73 6f 63 69 ext index associ
13950 61 74 65 64 20 77 69 74 68 20 74 68 65 20 73 61 ated with the sa
13960 6d 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 53 63 me table */. Sc
13970 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 hema *pSchema;
13980 20 20 20 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 /* Schema
13990 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 69 73 containing this
139a0 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 38 20 2a index */. u8 *
139b0 61 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 20 aSortOrder;
139c0 20 20 20 20 20 2f 2a 20 66 6f 72 20 65 61 63 68 /* for each
139d0 20 63 6f 6c 75 6d 6e 3a 20 54 72 75 65 3d 3d 44 column: True==D
139e0 45 53 43 2c 20 46 61 6c 73 65 3d 3d 41 53 43 20 ESC, False==ASC
139f0 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
13a00 2a 2a 61 7a 43 6f 6c 6c 3b 20 20 20 20 20 2f 2a **azColl; /*
13a10 20 41 72 72 61 79 20 6f 66 20 63 6f 6c 6c 61 74 Array of collat
13a20 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 6e 61 6d ion sequence nam
13a30 65 73 20 66 6f 72 20 69 6e 64 65 78 20 2a 2f 0a es for index */.
13a40 20 20 45 78 70 72 20 2a 70 50 61 72 74 49 64 78 Expr *pPartIdx
13a50 57 68 65 72 65 3b 20 20 20 20 20 2f 2a 20 57 48 Where; /* WH
13a60 45 52 45 20 63 6c 61 75 73 65 20 66 6f 72 20 70 ERE clause for p
13a70 61 72 74 69 61 6c 20 69 6e 64 69 63 65 73 20 2a artial indices *
13a80 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 61 43 /. ExprList *aC
13a90 6f 6c 45 78 70 72 3b 20 20 20 20 20 20 2f 2a 20 olExpr; /*
13aa0 43 6f 6c 75 6d 6e 20 65 78 70 72 65 73 73 69 6f Column expressio
13ab0 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 74 6e 75 6d ns */. int tnum
13ac0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
13ad0 20 2f 2a 20 44 42 20 50 61 67 65 20 63 6f 6e 74 /* DB Page cont
13ae0 61 69 6e 69 6e 67 20 72 6f 6f 74 20 6f 66 20 74 aining root of t
13af0 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a 20 20 4c his index */. L
13b00 6f 67 45 73 74 20 73 7a 49 64 78 52 6f 77 3b 20 ogEst szIdxRow;
13b10 20 20 20 20 20 20 20 20 2f 2a 20 45 73 74 69 6d /* Estim
13b20 61 74 65 64 20 61 76 65 72 61 67 65 20 72 6f 77 ated average row
13b30 20 73 69 7a 65 20 69 6e 20 62 79 74 65 73 20 2a size in bytes *
13b40 2f 0a 20 20 75 31 36 20 6e 4b 65 79 43 6f 6c 3b /. u16 nKeyCol;
13b50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
13b60 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e Number of column
13b70 73 20 66 6f 72 6d 69 6e 67 20 74 68 65 20 6b 65 s forming the ke
13b80 79 20 2a 2f 0a 20 20 75 31 36 20 6e 43 6f 6c 75 y */. u16 nColu
13b90 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 mn;
13ba0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c /* Number of col
13bb0 75 6d 6e 73 20 73 74 6f 72 65 64 20 69 6e 20 74 umns stored in t
13bc0 68 65 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 38 he index */. u8
13bd0 20 6f 6e 45 72 72 6f 72 3b 20 20 20 20 20 20 20 onError;
13be0 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f 41 62 6f /* OE_Abo
13bf0 72 74 2c 20 4f 45 5f 49 67 6e 6f 72 65 2c 20 4f rt, OE_Ignore, O
13c00 45 5f 52 65 70 6c 61 63 65 2c 20 6f 72 20 4f 45 E_Replace, or OE
13c10 5f 4e 6f 6e 65 20 2a 2f 0a 20 20 75 6e 73 69 67 _None */. unsig
13c20 6e 65 64 20 69 64 78 54 79 70 65 3a 32 3b 20 20 ned idxType:2;
13c30 20 20 20 20 2f 2a 20 31 3d 3d 55 4e 49 51 55 45 /* 1==UNIQUE
13c40 2c 20 32 3d 3d 50 52 49 4d 41 52 59 20 4b 45 59 , 2==PRIMARY KEY
13c50 2c 20 30 3d 3d 43 52 45 41 54 45 20 49 4e 44 45 , 0==CREATE INDE
13c60 58 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 X */. unsigned
13c70 62 55 6e 6f 72 64 65 72 65 64 3a 31 3b 20 20 20 bUnordered:1;
13c80 2f 2a 20 55 73 65 20 74 68 69 73 20 69 6e 64 65 /* Use this inde
13c90 78 20 66 6f 72 20 3d 3d 20 6f 72 20 49 4e 20 71 x for == or IN q
13ca0 75 65 72 69 65 73 20 6f 6e 6c 79 20 2a 2f 0a 20 ueries only */.
13cb0 20 75 6e 73 69 67 6e 65 64 20 75 6e 69 71 4e 6f unsigned uniqNo
13cc0 74 4e 75 6c 6c 3a 31 3b 20 20 2f 2a 20 54 72 75 tNull:1; /* Tru
13cd0 65 20 69 66 20 55 4e 49 51 55 45 20 61 6e 64 20 e if UNIQUE and
13ce0 4e 4f 54 20 4e 55 4c 4c 20 66 6f 72 20 61 6c 6c NOT NULL for all
13cf0 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 75 6e columns */. un
13d00 73 69 67 6e 65 64 20 69 73 52 65 73 69 7a 65 64 signed isResized
13d10 3a 31 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69 :1; /* True i
13d20 66 20 72 65 73 69 7a 65 49 6e 64 65 78 4f 62 6a f resizeIndexObj
13d30 65 63 74 28 29 20 68 61 73 20 62 65 65 6e 20 63 ect() has been c
13d40 61 6c 6c 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 alled */. unsig
13d50 6e 65 64 20 69 73 43 6f 76 65 72 69 6e 67 3a 31 ned isCovering:1
13d60 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 ; /* True if t
13d70 68 69 73 20 69 73 20 61 20 63 6f 76 65 72 69 6e his is a coverin
13d80 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 6e 73 g index */. uns
13d90 69 67 6e 65 64 20 6e 6f 53 6b 69 70 53 63 61 6e igned noSkipScan
13da0 3a 31 3b 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 :1; /* Do not
13db0 74 72 79 20 74 6f 20 75 73 65 20 73 6b 69 70 2d try to use skip-
13dc0 73 63 61 6e 20 69 66 20 74 72 75 65 20 2a 2f 0a scan if true */.
13dd0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
13de0 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 ABLE_STAT3_OR_ST
13df0 41 54 34 0a 20 20 69 6e 74 20 6e 53 61 6d 70 6c AT4. int nSampl
13e00 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f e; /
13e10 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d * Number of elem
13e20 65 6e 74 73 20 69 6e 20 61 53 61 6d 70 6c 65 5b ents in aSample[
13e30 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 61 6d 70 ] */. int nSamp
13e40 6c 65 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 leCol;
13e50 2f 2a 20 53 69 7a 65 20 6f 66 20 49 6e 64 65 78 /* Size of Index
13e60 53 61 6d 70 6c 65 2e 61 6e 45 71 5b 5d 20 61 6e Sample.anEq[] an
13e70 64 20 73 6f 20 6f 6e 20 2a 2f 0a 20 20 74 52 6f d so on */. tRo
13e80 77 63 6e 74 20 2a 61 41 76 67 45 71 3b 20 20 20 wcnt *aAvgEq;
13e90 20 20 20 20 20 20 2f 2a 20 41 76 65 72 61 67 65 /* Average
13ea0 20 6e 45 71 20 76 61 6c 75 65 73 20 66 6f 72 20 nEq values for
13eb0 6b 65 79 73 20 6e 6f 74 20 69 6e 20 61 53 61 6d keys not in aSam
13ec0 70 6c 65 20 2a 2f 0a 20 20 49 6e 64 65 78 53 61 ple */. IndexSa
13ed0 6d 70 6c 65 20 2a 61 53 61 6d 70 6c 65 3b 20 20 mple *aSample;
13ee0 20 20 2f 2a 20 53 61 6d 70 6c 65 73 20 6f 66 20 /* Samples of
13ef0 74 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20 6b 65 the left-most ke
13f00 79 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a y */. tRowcnt *
13f10 61 69 52 6f 77 45 73 74 3b 20 20 20 20 20 20 20 aiRowEst;
13f20 2f 2a 20 4e 6f 6e 2d 6c 6f 67 61 72 69 74 68 6d /* Non-logarithm
13f30 69 63 20 73 74 61 74 31 20 64 61 74 61 20 66 6f ic stat1 data fo
13f40 72 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f 0a r this index */.
13f50 20 20 74 52 6f 77 63 6e 74 20 6e 52 6f 77 45 73 tRowcnt nRowEs
13f60 74 30 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 6f t0; /* No
13f70 6e 2d 6c 6f 67 61 72 69 74 68 6d 69 63 20 6e 75 n-logarithmic nu
13f80 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20 mber of rows in
13f90 74 68 65 20 69 6e 64 65 78 20 2a 2f 0a 23 65 6e the index */.#en
13fa0 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c dif.};../*.** Al
13fb0 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 lowed values for
13fc0 20 49 6e 64 65 78 2e 69 64 78 54 79 70 65 0a 2a Index.idxType.*
13fd0 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
13fe0 5f 49 44 58 54 59 50 45 5f 41 50 50 44 45 46 20 _IDXTYPE_APPDEF
13ff0 20 20 20 20 20 30 20 20 20 2f 2a 20 43 72 65 61 0 /* Crea
14000 74 65 64 20 75 73 69 6e 67 20 43 52 45 41 54 45 ted using CREATE
14010 20 49 4e 44 45 58 20 2a 2f 0a 23 64 65 66 69 6e INDEX */.#defin
14020 65 20 53 51 4c 49 54 45 5f 49 44 58 54 59 50 45 e SQLITE_IDXTYPE
14030 5f 55 4e 49 51 55 45 20 20 20 20 20 20 31 20 20 _UNIQUE 1
14040 20 2f 2a 20 49 6d 70 6c 65 6d 65 6e 74 73 20 61 /* Implements a
14050 20 55 4e 49 51 55 45 20 63 6f 6e 73 74 72 61 69 UNIQUE constrai
14060 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 nt */.#define SQ
14070 4c 49 54 45 5f 49 44 58 54 59 50 45 5f 50 52 49 LITE_IDXTYPE_PRI
14080 4d 41 52 59 4b 45 59 20 20 32 20 20 20 2f 2a 20 MARYKEY 2 /*
14090 49 73 20 74 68 65 20 50 52 49 4d 41 52 59 20 4b Is the PRIMARY K
140a0 45 59 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65 EY for the table
140b0 20 2a 2f 0a 0a 2f 2a 20 52 65 74 75 72 6e 20 74 */../* Return t
140c0 72 75 65 20 69 66 20 69 6e 64 65 78 20 58 20 69 rue if index X i
140d0 73 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20 s a PRIMARY KEY
140e0 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 index */.#define
140f0 20 49 73 50 72 69 6d 61 72 79 4b 65 79 49 6e 64 IsPrimaryKeyInd
14100 65 78 28 58 29 20 20 28 28 58 29 2d 3e 69 64 78 ex(X) ((X)->idx
14110 54 79 70 65 3d 3d 53 51 4c 49 54 45 5f 49 44 58 Type==SQLITE_IDX
14120 54 59 50 45 5f 50 52 49 4d 41 52 59 4b 45 59 29 TYPE_PRIMARYKEY)
14130 0a 0a 2f 2a 20 52 65 74 75 72 6e 20 74 72 75 65 ../* Return true
14140 20 69 66 20 69 6e 64 65 78 20 58 20 69 73 20 61 if index X is a
14150 20 55 4e 49 51 55 45 20 69 6e 64 65 78 20 2a 2f UNIQUE index */
14160 0a 23 64 65 66 69 6e 65 20 49 73 55 6e 69 71 75 .#define IsUniqu
14170 65 49 6e 64 65 78 28 58 29 20 20 20 20 20 20 28 eIndex(X) (
14180 28 58 29 2d 3e 6f 6e 45 72 72 6f 72 21 3d 4f 45 (X)->onError!=OE
14190 5f 4e 6f 6e 65 29 0a 0a 2f 2a 20 54 68 65 20 49 _None)../* The I
141a0 6e 64 65 78 2e 61 69 43 6f 6c 75 6d 6e 5b 5d 20 ndex.aiColumn[]
141b0 76 61 6c 75 65 73 20 61 72 65 20 6e 6f 72 6d 61 values are norma
141c0 6c 6c 79 20 70 6f 73 69 74 69 76 65 20 69 6e 74 lly positive int
141d0 65 67 65 72 2e 20 20 42 75 74 0a 2a 2a 20 74 68 eger. But.** th
141e0 65 72 65 20 61 72 65 20 73 6f 6d 65 20 6e 65 67 ere are some neg
141f0 61 74 69 76 65 20 76 61 6c 75 65 73 20 74 68 61 ative values tha
14200 74 20 68 61 76 65 20 73 70 65 63 69 61 6c 20 6d t have special m
14210 65 61 6e 69 6e 67 3a 0a 2a 2f 0a 23 64 65 66 69 eaning:.*/.#defi
14220 6e 65 20 58 4e 5f 52 4f 57 49 44 20 20 20 20 20 ne XN_ROWID
14230 28 2d 31 29 20 20 20 20 20 2f 2a 20 49 6e 64 65 (-1) /* Inde
14240 78 65 64 20 63 6f 6c 75 6d 6e 20 69 73 20 74 68 xed column is th
14250 65 20 72 6f 77 69 64 20 2a 2f 0a 23 64 65 66 69 e rowid */.#defi
14260 6e 65 20 58 4e 5f 45 58 50 52 20 20 20 20 20 20 ne XN_EXPR
14270 28 2d 32 29 20 20 20 20 20 2f 2a 20 49 6e 64 65 (-2) /* Inde
14280 78 65 64 20 63 6f 6c 75 6d 6e 20 69 73 20 61 6e xed column is an
14290 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 0a expression */..
142a0 2f 2a 0a 2a 2a 20 45 61 63 68 20 73 61 6d 70 6c /*.** Each sampl
142b0 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 e stored in the
142c0 73 71 6c 69 74 65 5f 73 74 61 74 33 20 74 61 62 sqlite_stat3 tab
142d0 6c 65 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 le is represente
142e0 64 20 69 6e 20 6d 65 6d 6f 72 79 0a 2a 2a 20 75 d in memory.** u
142f0 73 69 6e 67 20 61 20 73 74 72 75 63 74 75 72 65 sing a structure
14300 20 6f 66 20 74 68 69 73 20 74 79 70 65 2e 20 20 of this type.
14310 53 65 65 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f See documentatio
14320 6e 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 n at the top of
14330 74 68 65 0a 2a 2a 20 61 6e 61 6c 79 7a 65 2e 63 the.** analyze.c
14340 20 73 6f 75 72 63 65 20 66 69 6c 65 20 66 6f 72 source file for
14350 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f additional info
14360 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 rmation..*/.stru
14370 63 74 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 7b ct IndexSample {
14380 0a 20 20 76 6f 69 64 20 2a 70 3b 20 20 20 20 20 . void *p;
14390 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
143a0 74 6f 20 73 61 6d 70 6c 65 64 20 72 65 63 6f 72 to sampled recor
143b0 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 3b 20 20 20 d */. int n;
143c0 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
143d0 20 6f 66 20 72 65 63 6f 72 64 20 69 6e 20 62 79 of record in by
143e0 74 65 73 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 tes */. tRowcnt
143f0 20 2a 61 6e 45 71 3b 20 20 20 20 2f 2a 20 45 73 *anEq; /* Es
14400 74 2e 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 t. number of row
14410 73 20 77 68 65 72 65 20 74 68 65 20 6b 65 79 20 s where the key
14420 65 71 75 61 6c 73 20 74 68 69 73 20 73 61 6d 70 equals this samp
14430 6c 65 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 le */. tRowcnt
14440 2a 61 6e 4c 74 3b 20 20 20 20 2f 2a 20 45 73 74 *anLt; /* Est
14450 2e 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 . number of rows
14460 20 77 68 65 72 65 20 6b 65 79 20 69 73 20 6c 65 where key is le
14470 73 73 20 74 68 61 6e 20 74 68 69 73 20 73 61 6d ss than this sam
14480 70 6c 65 20 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 ple */. tRowcnt
14490 20 2a 61 6e 44 4c 74 3b 20 20 20 2f 2a 20 45 73 *anDLt; /* Es
144a0 74 2e 20 6e 75 6d 62 65 72 20 6f 66 20 64 69 73 t. number of dis
144b0 74 69 6e 63 74 20 6b 65 79 73 20 6c 65 73 73 20 tinct keys less
144c0 74 68 61 6e 20 74 68 69 73 20 73 61 6d 70 6c 65 than this sample
144d0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 */.};../*.** Ea
144e0 63 68 20 74 6f 6b 65 6e 20 63 6f 6d 69 6e 67 20 ch token coming
144f0 6f 75 74 20 6f 66 20 74 68 65 20 6c 65 78 65 72 out of the lexer
14500 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 is an instance
14510 6f 66 0a 2a 2a 20 74 68 69 73 20 73 74 72 75 63 of.** this struc
14520 74 75 72 65 2e 20 20 54 6f 6b 65 6e 73 20 61 72 ture. Tokens ar
14530 65 20 61 6c 73 6f 20 75 73 65 64 20 61 73 20 70 e also used as p
14540 61 72 74 20 6f 66 20 61 6e 20 65 78 70 72 65 73 art of an expres
14550 73 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 sion..**.** Note
14560 20 69 66 20 54 6f 6b 65 6e 2e 7a 3d 3d 30 20 74 if Token.z==0 t
14570 68 65 6e 20 54 6f 6b 65 6e 2e 64 79 6e 20 61 6e hen Token.dyn an
14580 64 20 54 6f 6b 65 6e 2e 6e 20 61 72 65 20 75 6e d Token.n are un
14590 64 65 66 69 6e 65 64 20 61 6e 64 0a 2a 2a 20 6d defined and.** m
145a0 61 79 20 63 6f 6e 74 61 69 6e 20 72 61 6e 64 6f ay contain rando
145b0 6d 20 76 61 6c 75 65 73 2e 20 20 44 6f 20 6e 6f m values. Do no
145c0 74 20 6d 61 6b 65 20 61 6e 79 20 61 73 73 75 6d t make any assum
145d0 70 74 69 6f 6e 73 20 61 62 6f 75 74 20 54 6f 6b ptions about Tok
145e0 65 6e 2e 64 79 6e 0a 2a 2a 20 61 6e 64 20 54 6f en.dyn.** and To
145f0 6b 65 6e 2e 6e 20 77 68 65 6e 20 54 6f 6b 65 6e ken.n when Token
14600 2e 7a 3d 3d 30 2e 0a 2a 2f 0a 73 74 72 75 63 74 .z==0..*/.struct
14610 20 54 6f 6b 65 6e 20 7b 0a 20 20 63 6f 6e 73 74 Token {. const
14620 20 63 68 61 72 20 2a 7a 3b 20 20 20 20 20 2f 2a char *z; /*
14630 20 54 65 78 74 20 6f 66 20 74 68 65 20 74 6f 6b Text of the tok
14640 65 6e 2e 20 20 4e 6f 74 20 4e 55 4c 4c 2d 74 65 en. Not NULL-te
14650 72 6d 69 6e 61 74 65 64 21 20 2a 2f 0a 20 20 75 rminated! */. u
14660 6e 73 69 67 6e 65 64 20 69 6e 74 20 6e 3b 20 20 nsigned int n;
14670 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 /* Number of c
14680 68 61 72 61 63 74 65 72 73 20 69 6e 20 74 68 69 haracters in thi
14690 73 20 74 6f 6b 65 6e 20 2a 2f 0a 7d 3b 0a 0a 2f s token */.};../
146a0 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
146b0 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 of this structu
146c0 72 65 20 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f re contains info
146d0 72 6d 61 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 rmation needed t
146e0 6f 20 67 65 6e 65 72 61 74 65 0a 2a 2a 20 63 6f o generate.** co
146f0 64 65 20 66 6f 72 20 61 20 53 45 4c 45 43 54 20 de for a SELECT
14700 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 67 that contains ag
14710 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e gregate function
14720 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 45 78 70 72 s..**.** If Expr
14730 2e 6f 70 3d 3d 54 4b 5f 41 47 47 5f 43 4f 4c 55 .op==TK_AGG_COLU
14740 4d 4e 20 6f 72 20 54 4b 5f 41 47 47 5f 46 55 4e MN or TK_AGG_FUN
14750 43 54 49 4f 4e 20 74 68 65 6e 20 45 78 70 72 2e CTION then Expr.
14760 70 41 67 67 49 6e 66 6f 20 69 73 20 61 0a 2a 2a pAggInfo is a.**
14770 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 pointer to this
14780 20 73 74 72 75 63 74 75 72 65 2e 20 20 54 68 65 structure. The
14790 20 45 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 66 69 Expr.iColumn fi
147a0 65 6c 64 20 69 73 20 74 68 65 20 69 6e 64 65 78 eld is the index
147b0 20 69 6e 0a 2a 2a 20 41 67 67 49 6e 66 6f 2e 61 in.** AggInfo.a
147c0 43 6f 6c 5b 5d 20 6f 72 20 41 67 67 49 6e 66 6f Col[] or AggInfo
147d0 2e 61 46 75 6e 63 5b 5d 20 6f 66 20 69 6e 66 6f .aFunc[] of info
147e0 72 6d 61 74 69 6f 6e 20 6e 65 65 64 65 64 20 74 rmation needed t
147f0 6f 20 67 65 6e 65 72 61 74 65 0a 2a 2a 20 63 6f o generate.** co
14800 64 65 20 66 6f 72 20 74 68 61 74 20 6e 6f 64 65 de for that node
14810 2e 0a 2a 2a 0a 2a 2a 20 41 67 67 49 6e 66 6f 2e ..**.** AggInfo.
14820 70 47 72 6f 75 70 42 79 20 61 6e 64 20 41 67 67 pGroupBy and Agg
14830 49 6e 66 6f 2e 61 46 75 6e 63 2e 70 45 78 70 72 Info.aFunc.pExpr
14840 20 70 6f 69 6e 74 20 74 6f 20 66 69 65 6c 64 73 point to fields
14850 20 77 69 74 68 69 6e 20 74 68 65 0a 2a 2a 20 6f within the.** o
14860 72 69 67 69 6e 61 6c 20 53 65 6c 65 63 74 20 73 riginal Select s
14870 74 72 75 63 74 75 72 65 20 74 68 61 74 20 64 65 tructure that de
14880 73 63 72 69 62 65 73 20 74 68 65 20 53 45 4c 45 scribes the SELE
14890 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 54 CT statement. T
148a0 68 65 73 65 0a 2a 2a 20 66 69 65 6c 64 73 20 64 hese.** fields d
148b0 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 62 65 o not need to be
148c0 20 66 72 65 65 64 20 77 68 65 6e 20 64 65 61 6c freed when deal
148d0 6c 6f 63 61 74 69 6e 67 20 74 68 65 20 41 67 67 locating the Agg
148e0 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 2e 0a Info structure..
148f0 2a 2f 0a 73 74 72 75 63 74 20 41 67 67 49 6e 66 */.struct AggInf
14900 6f 20 7b 0a 20 20 75 38 20 64 69 72 65 63 74 4d o {. u8 directM
14910 6f 64 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ode; /*
14920 20 44 69 72 65 63 74 20 72 65 6e 64 65 72 69 6e Direct renderin
14930 67 20 6d 6f 64 65 20 6d 65 61 6e 73 20 74 61 6b g mode means tak
14940 65 20 64 61 74 61 20 64 69 72 65 63 74 6c 79 0a e data directly.
14950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14960 20 20 20 20 20 20 20 20 20 20 2a 2a 20 66 72 6f ** fro
14970 6d 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 m source tables
14980 72 61 74 68 65 72 20 74 68 61 6e 20 66 72 6f 6d rather than from
14990 20 61 63 63 75 6d 75 6c 61 74 6f 72 73 20 2a 2f accumulators */
149a0 0a 20 20 75 38 20 75 73 65 53 6f 72 74 69 6e 67 . u8 useSorting
149b0 49 64 78 3b 20 20 20 20 20 20 20 2f 2a 20 49 6e Idx; /* In
149c0 20 64 69 72 65 63 74 20 6d 6f 64 65 2c 20 72 65 direct mode, re
149d0 66 65 72 65 6e 63 65 20 74 68 65 20 73 6f 72 74 ference the sort
149e0 69 6e 67 20 69 6e 64 65 78 20 72 61 74 68 65 72 ing index rather
149f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
14a00 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 ** th
14a10 61 6e 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 an the source ta
14a20 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 ble */. int sor
14a30 74 69 6e 67 49 64 78 3b 20 20 20 20 20 20 20 20 tingIdx;
14a40 20 2f 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 /* Cursor numbe
14a50 72 20 6f 66 20 74 68 65 20 73 6f 72 74 69 6e 67 r of the sorting
14a60 20 69 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 index */. int
14a70 73 6f 72 74 69 6e 67 49 64 78 50 54 61 62 3b 20 sortingIdxPTab;
14a80 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 6e 75 /* Cursor nu
14a90 6d 62 65 72 20 6f 66 20 70 73 65 75 64 6f 2d 74 mber of pseudo-t
14aa0 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 able */. int nS
14ab0 6f 72 74 69 6e 67 43 6f 6c 75 6d 6e 3b 20 20 20 ortingColumn;
14ac0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 /* Number of c
14ad0 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 73 6f olumns in the so
14ae0 72 74 69 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 rting index */.
14af0 20 69 6e 74 20 6d 6e 52 65 67 2c 20 6d 78 52 65 int mnReg, mxRe
14b00 67 3b 20 20 20 20 20 20 20 2f 2a 20 52 61 6e 67 g; /* Rang
14b10 65 20 6f 66 20 72 65 67 69 73 74 65 72 73 20 61 e of registers a
14b20 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 61 43 6f llocated for aCo
14b30 6c 20 61 6e 64 20 61 46 75 6e 63 20 2a 2f 0a 20 l and aFunc */.
14b40 20 45 78 70 72 4c 69 73 74 20 2a 70 47 72 6f 75 ExprList *pGrou
14b50 70 42 79 3b 20 20 20 20 20 2f 2a 20 54 68 65 20 pBy; /* The
14b60 67 72 6f 75 70 20 62 79 20 63 6c 61 75 73 65 20 group by clause
14b70 2a 2f 0a 20 20 73 74 72 75 63 74 20 41 67 67 49 */. struct AggI
14b80 6e 66 6f 5f 63 6f 6c 20 7b 20 20 20 20 2f 2a 20 nfo_col { /*
14b90 46 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 For each column
14ba0 75 73 65 64 20 69 6e 20 73 6f 75 72 63 65 20 74 used in source t
14bb0 61 62 6c 65 73 20 2a 2f 0a 20 20 20 20 54 61 62 ables */. Tab
14bc0 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 20 le *pTab;
14bd0 20 20 20 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 /* Source
14be0 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 table */. int
14bf0 20 69 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 iTable;
14c00 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 /* Cursor
14c10 6e 75 6d 62 65 72 20 6f 66 20 74 68 65 20 73 6f number of the so
14c20 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 urce table */.
14c30 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e 3b 20 20 int iColumn;
14c40 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f /* Co
14c50 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 77 69 74 68 lumn number with
14c60 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 in the source ta
14c70 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 ble */. int i
14c80 53 6f 72 74 65 72 43 6f 6c 75 6d 6e 3b 20 20 20 SorterColumn;
14c90 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 /* Column nu
14ca0 6d 62 65 72 20 69 6e 20 74 68 65 20 73 6f 72 74 mber in the sort
14cb0 69 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 20 ing index */.
14cc0 20 69 6e 74 20 69 4d 65 6d 3b 20 20 20 20 20 20 int iMem;
14cd0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d /* Mem
14ce0 6f 72 79 20 6c 6f 63 61 74 69 6f 6e 20 74 68 61 ory location tha
14cf0 74 20 61 63 74 73 20 61 73 20 61 63 63 75 6d 75 t acts as accumu
14d00 6c 61 74 6f 72 20 2a 2f 0a 20 20 20 20 45 78 70 lator */. Exp
14d10 72 20 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 r *pExpr;
14d20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f 72 69 /* The ori
14d30 67 69 6e 61 6c 20 65 78 70 72 65 73 73 69 6f 6e ginal expression
14d40 20 2a 2f 0a 20 20 7d 20 2a 61 43 6f 6c 3b 0a 20 */. } *aCol;.
14d50 20 69 6e 74 20 6e 43 6f 6c 75 6d 6e 3b 20 20 20 int nColumn;
14d60 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
14d70 65 72 20 6f 66 20 75 73 65 64 20 65 6e 74 72 69 er of used entri
14d80 65 73 20 69 6e 20 61 43 6f 6c 5b 5d 20 2a 2f 0a es in aCol[] */.
14d90 20 20 69 6e 74 20 6e 41 63 63 75 6d 75 6c 61 74 int nAccumulat
14da0 6f 72 3b 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d or; /* Num
14db0 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 ber of columns t
14dc0 68 61 74 20 73 68 6f 77 20 74 68 72 6f 75 67 68 hat show through
14dd0 20 74 6f 20 74 68 65 20 6f 75 74 70 75 74 2e 0a to the output..
14de0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14df0 20 20 20 20 20 20 20 20 20 20 2a 2a 20 41 64 64 ** Add
14e00 69 74 69 6f 6e 61 6c 20 63 6f 6c 75 6d 6e 73 20 itional columns
14e10 61 72 65 20 75 73 65 64 20 6f 6e 6c 79 20 61 73 are used only as
14e20 20 70 61 72 61 6d 65 74 65 72 73 20 74 6f 0a 20 parameters to.
14e30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14e40 20 20 20 20 20 20 20 20 20 2a 2a 20 61 67 67 72 ** aggr
14e50 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 egate functions
14e60 2a 2f 0a 20 20 73 74 72 75 63 74 20 41 67 67 49 */. struct AggI
14e70 6e 66 6f 5f 66 75 6e 63 20 7b 20 20 20 2f 2a 20 nfo_func { /*
14e80 46 6f 72 20 65 61 63 68 20 61 67 67 72 65 67 61 For each aggrega
14e90 74 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 te function */.
14ea0 20 20 20 45 78 70 72 20 2a 70 45 78 70 72 3b 20 Expr *pExpr;
14eb0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
14ec0 78 70 72 65 73 73 69 6f 6e 20 65 6e 63 6f 64 69 xpression encodi
14ed0 6e 67 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 ng the function
14ee0 2a 2f 0a 20 20 20 20 46 75 6e 63 44 65 66 20 2a */. FuncDef *
14ef0 70 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 20 pFunc;
14f00 2f 2a 20 54 68 65 20 61 67 67 72 65 67 61 74 65 /* The aggregate
14f10 20 66 75 6e 63 74 69 6f 6e 20 69 6d 70 6c 65 6d function implem
14f20 65 6e 74 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 entation */.
14f30 69 6e 74 20 69 4d 65 6d 3b 20 20 20 20 20 20 20 int iMem;
14f40 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f /* Memo
14f50 72 79 20 6c 6f 63 61 74 69 6f 6e 20 74 68 61 74 ry location that
14f60 20 61 63 74 73 20 61 73 20 61 63 63 75 6d 75 6c acts as accumul
14f70 61 74 6f 72 20 2a 2f 0a 20 20 20 20 69 6e 74 20 ator */. int
14f80 69 44 69 73 74 69 6e 63 74 3b 20 20 20 20 20 20 iDistinct;
14f90 20 20 20 20 20 2f 2a 20 45 70 68 65 6d 65 72 61 /* Ephemera
14fa0 6c 20 74 61 62 6c 65 20 75 73 65 64 20 74 6f 20 l table used to
14fb0 65 6e 66 6f 72 63 65 20 44 49 53 54 49 4e 43 54 enforce DISTINCT
14fc0 20 2a 2f 0a 20 20 7d 20 2a 61 46 75 6e 63 3b 0a */. } *aFunc;.
14fd0 20 20 69 6e 74 20 6e 46 75 6e 63 3b 20 20 20 20 int nFunc;
14fe0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
14ff0 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69 ber of entries i
15000 6e 20 61 46 75 6e 63 5b 5d 20 2a 2f 0a 7d 3b 0a n aFunc[] */.};.
15010 0a 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 74 ./*.** The datat
15020 79 70 65 20 79 6e 56 61 72 20 69 73 20 61 20 73 ype ynVar is a s
15030 69 67 6e 65 64 20 69 6e 74 65 67 65 72 2c 20 65 igned integer, e
15040 69 74 68 65 72 20 31 36 2d 62 69 74 20 6f 72 20 ither 16-bit or
15050 33 32 2d 62 69 74 2e 0a 2a 2a 20 55 73 75 61 6c 32-bit..** Usual
15060 6c 79 20 69 74 20 69 73 20 31 36 2d 62 69 74 73 ly it is 16-bits
15070 2e 20 20 42 75 74 20 69 66 20 53 51 4c 49 54 45 . But if SQLITE
15080 5f 4d 41 58 5f 56 41 52 49 41 42 4c 45 5f 4e 55 _MAX_VARIABLE_NU
15090 4d 42 45 52 20 69 73 20 67 72 65 61 74 65 72 0a MBER is greater.
150a0 2a 2a 20 74 68 61 6e 20 33 32 37 36 37 20 77 65 ** than 32767 we
150b0 20 68 61 76 65 20 74 6f 20 6d 61 6b 65 20 69 74 have to make it
150c0 20 33 32 2d 62 69 74 2e 20 20 31 36 2d 62 69 74 32-bit. 16-bit
150d0 20 69 73 20 70 72 65 66 65 72 72 65 64 20 62 65 is preferred be
150e0 63 61 75 73 65 0a 2a 2a 20 69 74 20 75 73 65 73 cause.** it uses
150f0 20 6c 65 73 73 20 6d 65 6d 6f 72 79 20 69 6e 20 less memory in
15100 74 68 65 20 45 78 70 72 20 6f 62 6a 65 63 74 2c the Expr object,
15110 20 77 68 69 63 68 20 69 73 20 61 20 62 69 67 20 which is a big
15120 6d 65 6d 6f 72 79 20 75 73 65 72 0a 2a 2a 20 69 memory user.** i
15130 6e 20 73 79 73 74 65 6d 73 20 77 69 74 68 20 6c n systems with l
15140 6f 74 73 20 6f 66 20 70 72 65 70 61 72 65 64 20 ots of prepared
15150 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 41 6e 64 statements. And
15160 20 66 65 77 20 61 70 70 6c 69 63 61 74 69 6f 6e few application
15170 73 0a 2a 2a 20 6e 65 65 64 20 6d 6f 72 65 20 74 s.** need more t
15180 68 61 6e 20 61 62 6f 75 74 20 31 30 20 6f 72 20 han about 10 or
15190 32 30 20 76 61 72 69 61 62 6c 65 73 2e 20 20 42 20 variables. B
151a0 75 74 20 73 6f 6d 65 20 65 78 74 72 65 6d 65 20 ut some extreme
151b0 75 73 65 72 73 20 77 61 6e 74 0a 2a 2a 20 74 6f users want.** to
151c0 20 68 61 76 65 20 70 72 65 70 61 72 65 64 20 73 have prepared s
151d0 74 61 74 65 6d 65 6e 74 73 20 77 69 74 68 20 6f tatements with o
151e0 76 65 72 20 33 32 37 36 37 20 76 61 72 69 61 62 ver 32767 variab
151f0 6c 65 73 2c 20 61 6e 64 20 66 6f 72 20 74 68 65 les, and for the
15200 6d 0a 2a 2a 20 74 68 65 20 6f 70 74 69 6f 6e 20 m.** the option
15210 69 73 20 61 76 61 69 6c 61 62 6c 65 20 28 61 74 is available (at
15220 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 29 2e 0a compile-time)..
15230 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 */.#if SQLITE_MA
15240 58 5f 56 41 52 49 41 42 4c 45 5f 4e 55 4d 42 45 X_VARIABLE_NUMBE
15250 52 3c 3d 33 32 37 36 37 0a 74 79 70 65 64 65 66 R<=32767.typedef
15260 20 69 31 36 20 79 6e 56 61 72 3b 0a 23 65 6c 73 i16 ynVar;.#els
15270 65 0a 74 79 70 65 64 65 66 20 69 6e 74 20 79 6e e.typedef int yn
15280 56 61 72 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a Var;.#endif../*.
15290 2a 2a 20 45 61 63 68 20 6e 6f 64 65 20 6f 66 20 ** Each node of
152a0 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 69 6e an expression in
152b0 20 74 68 65 20 70 61 72 73 65 20 74 72 65 65 20 the parse tree
152c0 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a 2a is an instance.*
152d0 2a 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 * of this struct
152e0 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e ure..**.** Expr.
152f0 6f 70 20 69 73 20 74 68 65 20 6f 70 63 6f 64 65 op is the opcode
15300 2e 20 54 68 65 20 69 6e 74 65 67 65 72 20 70 61 . The integer pa
15310 72 73 65 72 20 74 6f 6b 65 6e 20 63 6f 64 65 73 rser token codes
15320 20 61 72 65 20 72 65 75 73 65 64 0a 2a 2a 20 61 are reused.** a
15330 73 20 6f 70 63 6f 64 65 73 20 68 65 72 65 2e 20 s opcodes here.
15340 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 For example, the
15350 20 70 61 72 73 65 72 20 64 65 66 69 6e 65 73 20 parser defines
15360 54 4b 5f 47 45 20 74 6f 20 62 65 20 61 6e 20 69 TK_GE to be an i
15370 6e 74 65 67 65 72 0a 2a 2a 20 63 6f 64 65 20 72 nteger.** code r
15380 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 20 epresenting the
15390 22 3e 3d 22 20 6f 70 65 72 61 74 6f 72 2e 20 54 ">=" operator. T
153a0 68 69 73 20 73 61 6d 65 20 69 6e 74 65 67 65 72 his same integer
153b0 20 63 6f 64 65 20 69 73 20 72 65 75 73 65 64 0a code is reused.
153c0 2a 2a 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 ** to represent
153d0 74 68 65 20 67 72 65 61 74 65 72 2d 74 68 61 6e the greater-than
153e0 2d 6f 72 2d 65 71 75 61 6c 2d 74 6f 20 6f 70 65 -or-equal-to ope
153f0 72 61 74 6f 72 20 69 6e 20 74 68 65 20 65 78 70 rator in the exp
15400 72 65 73 73 69 6f 6e 0a 2a 2a 20 74 72 65 65 2e ression.** tree.
15410 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 65 78 .**.** If the ex
15420 70 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 53 pression is an S
15430 51 4c 20 6c 69 74 65 72 61 6c 20 28 54 4b 5f 49 QL literal (TK_I
15440 4e 54 45 47 45 52 2c 20 54 4b 5f 46 4c 4f 41 54 NTEGER, TK_FLOAT
15450 2c 20 54 4b 5f 42 4c 4f 42 2c 0a 2a 2a 20 6f 72 , TK_BLOB,.** or
15460 20 54 4b 5f 53 54 52 49 4e 47 29 2c 20 74 68 65 TK_STRING), the
15470 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 6f 6e n Expr.token con
15480 74 61 69 6e 73 20 74 68 65 20 74 65 78 74 20 6f tains the text o
15490 66 20 74 68 65 20 53 51 4c 20 6c 69 74 65 72 61 f the SQL litera
154a0 6c 2e 20 49 66 0a 2a 2a 20 74 68 65 20 65 78 70 l. If.** the exp
154b0 72 65 73 73 69 6f 6e 20 69 73 20 61 20 76 61 72 ression is a var
154c0 69 61 62 6c 65 20 28 54 4b 5f 56 41 52 49 41 42 iable (TK_VARIAB
154d0 4c 45 29 2c 20 74 68 65 6e 20 45 78 70 72 2e 74 LE), then Expr.t
154e0 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 oken contains th
154f0 65 0a 2a 2a 20 76 61 72 69 61 62 6c 65 20 6e 61 e.** variable na
15500 6d 65 2e 20 46 69 6e 61 6c 6c 79 2c 20 69 66 20 me. Finally, if
15510 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 the expression i
15520 73 20 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f s an SQL functio
15530 6e 20 28 54 4b 5f 46 55 4e 43 54 49 4f 4e 29 2c n (TK_FUNCTION),
15540 0a 2a 2a 20 74 68 65 6e 20 45 78 70 72 2e 74 6f .** then Expr.to
15550 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 ken contains the
15560 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 66 75 6e name of the fun
15570 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 78 70 ction..**.** Exp
15580 72 2e 70 52 69 67 68 74 20 61 6e 64 20 45 78 70 r.pRight and Exp
15590 72 2e 70 4c 65 66 74 20 61 72 65 20 74 68 65 20 r.pLeft are the
155a0 6c 65 66 74 20 61 6e 64 20 72 69 67 68 74 20 73 left and right s
155b0 75 62 65 78 70 72 65 73 73 69 6f 6e 73 20 6f 66 ubexpressions of
155c0 20 61 0a 2a 2a 20 62 69 6e 61 72 79 20 6f 70 65 a.** binary ope
155d0 72 61 74 6f 72 2e 20 45 69 74 68 65 72 20 6f 72 rator. Either or
155e0 20 62 6f 74 68 20 6d 61 79 20 62 65 20 4e 55 4c both may be NUL
155f0 4c 2e 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e 78 2e L..**.** Expr.x.
15600 70 4c 69 73 74 20 69 73 20 61 20 6c 69 73 74 20 pList is a list
15610 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 69 66 20 of arguments if
15620 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 the expression i
15630 73 20 61 6e 20 53 51 4c 20 66 75 6e 63 74 69 6f s an SQL functio
15640 6e 2c 0a 2a 2a 20 61 20 43 41 53 45 20 65 78 70 n,.** a CASE exp
15650 72 65 73 73 69 6f 6e 20 6f 72 20 61 6e 20 49 4e ression or an IN
15660 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 66 20 74 expression of t
15670 68 65 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 49 he form "<lhs> I
15680 4e 20 28 3c 79 3e 2c 20 3c 7a 3e 2e 2e 2e 29 22 N (<y>, <z>...)"
15690 2e 0a 2a 2a 20 45 78 70 72 2e 78 2e 70 53 65 6c ..** Expr.x.pSel
156a0 65 63 74 20 69 73 20 75 73 65 64 20 69 66 20 74 ect is used if t
156b0 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 he expression is
156c0 20 61 20 73 75 62 2d 73 65 6c 65 63 74 20 6f 72 a sub-select or
156d0 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 6f an expression o
156e0 66 0a 2a 2a 20 74 68 65 20 66 6f 72 6d 20 22 3c f.** the form "<
156f0 6c 68 73 3e 20 49 4e 20 28 53 45 4c 45 43 54 20 lhs> IN (SELECT
15700 2e 2e 2e 29 22 2e 20 49 66 20 74 68 65 20 45 50 ...)". If the EP
15710 5f 78 49 73 53 65 6c 65 63 74 20 62 69 74 20 69 _xIsSelect bit i
15720 73 20 73 65 74 20 69 6e 20 74 68 65 0a 2a 2a 20 s set in the.**
15730 45 78 70 72 2e 66 6c 61 67 73 20 6d 61 73 6b 2c Expr.flags mask,
15740 20 74 68 65 6e 20 45 78 70 72 2e 78 2e 70 53 65 then Expr.x.pSe
15750 6c 65 63 74 20 69 73 20 76 61 6c 69 64 2e 20 4f lect is valid. O
15760 74 68 65 72 77 69 73 65 2c 20 45 78 70 72 2e 78 therwise, Expr.x
15770 2e 70 4c 69 73 74 20 69 73 0a 2a 2a 20 76 61 6c .pList is.** val
15780 69 64 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 id..**.** An exp
15790 72 65 73 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 ression of the f
157a0 6f 72 6d 20 49 44 20 6f 72 20 49 44 2e 49 44 20 orm ID or ID.ID
157b0 72 65 66 65 72 73 20 74 6f 20 61 20 63 6f 6c 75 refers to a colu
157c0 6d 6e 20 69 6e 20 61 20 74 61 62 6c 65 2e 0a 2a mn in a table..*
157d0 2a 20 46 6f 72 20 73 75 63 68 20 65 78 70 72 65 * For such expre
157e0 73 73 69 6f 6e 73 2c 20 45 78 70 72 2e 6f 70 20 ssions, Expr.op
157f0 69 73 20 73 65 74 20 74 6f 20 54 4b 5f 43 4f 4c is set to TK_COL
15800 55 4d 4e 20 61 6e 64 20 45 78 70 72 2e 69 54 61 UMN and Expr.iTa
15810 62 6c 65 20 69 73 0a 2a 2a 20 74 68 65 20 69 6e ble is.** the in
15820 74 65 67 65 72 20 63 75 72 73 6f 72 20 6e 75 6d teger cursor num
15830 62 65 72 20 6f 66 20 61 20 56 44 42 45 20 63 75 ber of a VDBE cu
15840 72 73 6f 72 20 70 6f 69 6e 74 69 6e 67 20 74 6f rsor pointing to
15850 20 74 68 61 74 20 74 61 62 6c 65 20 61 6e 64 0a that table and.
15860 2a 2a 20 45 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 ** Expr.iColumn
15870 69 73 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 75 is the column nu
15880 6d 62 65 72 20 66 6f 72 20 74 68 65 20 73 70 65 mber for the spe
15890 63 69 66 69 63 20 63 6f 6c 75 6d 6e 2e 20 20 49 cific column. I
158a0 66 20 74 68 65 0a 2a 2a 20 65 78 70 72 65 73 73 f the.** express
158b0 69 6f 6e 20 69 73 20 75 73 65 64 20 61 73 20 61 ion is used as a
158c0 20 72 65 73 75 6c 74 20 69 6e 20 61 6e 20 61 67 result in an ag
158d0 67 72 65 67 61 74 65 20 53 45 4c 45 43 54 2c 20 gregate SELECT,
158e0 74 68 65 6e 20 74 68 65 0a 2a 2a 20 76 61 6c 75 then the.** valu
158f0 65 20 69 73 20 61 6c 73 6f 20 73 74 6f 72 65 64 e is also stored
15900 20 69 6e 20 74 68 65 20 45 78 70 72 2e 69 41 67 in the Expr.iAg
15910 67 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 g column in the
15920 61 67 67 72 65 67 61 74 65 20 73 6f 20 74 68 61 aggregate so tha
15930 74 0a 2a 2a 20 69 74 20 63 61 6e 20 62 65 20 61 t.** it can be a
15940 63 63 65 73 73 65 64 20 61 66 74 65 72 20 61 6c ccessed after al
15950 6c 20 61 67 67 72 65 67 61 74 65 73 20 61 72 65 l aggregates are
15960 20 63 6f 6d 70 75 74 65 64 2e 0a 2a 2a 0a 2a 2a computed..**.**
15970 20 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 If the expressi
15980 6f 6e 20 69 73 20 61 6e 20 75 6e 62 6f 75 6e 64 on is an unbound
15990 20 76 61 72 69 61 62 6c 65 20 6d 61 72 6b 65 72 variable marker
159a0 20 28 61 20 71 75 65 73 74 69 6f 6e 20 6d 61 72 (a question mar
159b0 6b 0a 2a 2a 20 63 68 61 72 61 63 74 65 72 20 27 k.** character '
159c0 3f 27 20 69 6e 20 74 68 65 20 6f 72 69 67 69 6e ?' in the origin
159d0 61 6c 20 53 51 4c 29 20 74 68 65 6e 20 74 68 65 al SQL) then the
159e0 20 45 78 70 72 2e 69 54 61 62 6c 65 20 68 6f 6c Expr.iTable hol
159f0 64 73 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20 ds the index.**
15a00 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 61 74 20 number for that
15a10 76 61 72 69 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 variable..**.**
15a20 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f If the expressio
15a30 6e 20 69 73 20 61 20 73 75 62 71 75 65 72 79 20 n is a subquery
15a40 74 68 65 6e 20 45 78 70 72 2e 69 43 6f 6c 75 6d then Expr.iColum
15a50 6e 20 68 6f 6c 64 73 20 61 6e 20 69 6e 74 65 67 n holds an integ
15a60 65 72 0a 2a 2a 20 72 65 67 69 73 74 65 72 20 6e er.** register n
15a70 75 6d 62 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 umber containing
15a80 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 the result of t
15a90 68 65 20 73 75 62 71 75 65 72 79 2e 20 20 49 66 he subquery. If
15aa0 20 74 68 65 0a 2a 2a 20 73 75 62 71 75 65 72 79 the.** subquery
15ab0 20 67 69 76 65 73 20 61 20 63 6f 6e 73 74 61 6e gives a constan
15ac0 74 20 72 65 73 75 6c 74 2c 20 74 68 65 6e 20 69 t result, then i
15ad0 54 61 62 6c 65 20 69 73 20 2d 31 2e 20 20 49 66 Table is -1. If
15ae0 20 74 68 65 20 73 75 62 71 75 65 72 79 0a 2a 2a the subquery.**
15af0 20 67 69 76 65 73 20 61 20 64 69 66 66 65 72 65 gives a differe
15b00 6e 74 20 61 6e 73 77 65 72 20 61 74 20 64 69 66 nt answer at dif
15b10 66 65 72 65 6e 74 20 74 69 6d 65 73 20 64 75 72 ferent times dur
15b20 69 6e 67 20 73 74 61 74 65 6d 65 6e 74 20 70 72 ing statement pr
15b30 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 6e ocessing.** then
15b40 20 69 54 61 62 6c 65 20 69 73 20 74 68 65 20 61 iTable is the a
15b50 64 64 72 65 73 73 20 6f 66 20 61 20 73 75 62 72 ddress of a subr
15b60 6f 75 74 69 6e 65 20 74 68 61 74 20 63 6f 6d 70 outine that comp
15b70 75 74 65 73 20 74 68 65 20 73 75 62 71 75 65 72 utes the subquer
15b80 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 y..**.** If the
15b90 45 78 70 72 20 69 73 20 6f 66 20 74 79 70 65 20 Expr is of type
15ba0 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 61 6e 64 20 74 OP_Column, and t
15bb0 68 65 20 74 61 62 6c 65 20 69 74 20 69 73 20 73 he table it is s
15bc0 65 6c 65 63 74 69 6e 67 20 66 72 6f 6d 0a 2a 2a electing from.**
15bd0 20 69 73 20 61 20 64 69 73 6b 20 74 61 62 6c 65 is a disk table
15be0 20 6f 72 20 74 68 65 20 22 6f 6c 64 2e 2a 22 20 or the "old.*"
15bf0 70 73 65 75 64 6f 2d 74 61 62 6c 65 2c 20 74 68 pseudo-table, th
15c00 65 6e 20 70 54 61 62 20 70 6f 69 6e 74 73 20 74 en pTab points t
15c10 6f 20 74 68 65 0a 2a 2a 20 63 6f 72 72 65 73 70 o the.** corresp
15c20 6f 6e 64 69 6e 67 20 74 61 62 6c 65 20 64 65 66 onding table def
15c30 69 6e 69 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 inition..**.** A
15c40 4c 4c 4f 43 41 54 49 4f 4e 20 4e 4f 54 45 53 3a LLOCATION NOTES:
15c50 0a 2a 2a 0a 2a 2a 20 45 78 70 72 20 6f 62 6a 65 .**.** Expr obje
15c60 63 74 73 20 63 61 6e 20 75 73 65 20 61 20 6c 6f cts can use a lo
15c70 74 20 6f 66 20 6d 65 6d 6f 72 79 20 73 70 61 63 t of memory spac
15c80 65 20 69 6e 20 64 61 74 61 62 61 73 65 20 73 63 e in database sc
15c90 68 65 6d 61 2e 20 20 54 6f 0a 2a 2a 20 68 65 6c hema. To.** hel
15ca0 70 20 72 65 64 75 63 65 20 6d 65 6d 6f 72 79 20 p reduce memory
15cb0 72 65 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 6f requirements, so
15cc0 6d 65 74 69 6d 65 73 20 61 6e 20 45 78 70 72 20 metimes an Expr
15cd0 6f 62 6a 65 63 74 20 77 69 6c 6c 20 62 65 0a 2a object will be.*
15ce0 2a 20 74 72 75 6e 63 61 74 65 64 2e 20 20 41 6e * truncated. An
15cf0 64 20 74 6f 20 72 65 64 75 63 65 20 74 68 65 20 d to reduce the
15d00 6e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 number of memory
15d10 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 2c 20 73 6f allocations, so
15d20 6d 65 74 69 6d 65 73 0a 2a 2a 20 74 77 6f 20 6f metimes.** two o
15d30 72 20 6d 6f 72 65 20 45 78 70 72 20 6f 62 6a 65 r more Expr obje
15d40 63 74 73 20 77 69 6c 6c 20 62 65 20 73 74 6f 72 cts will be stor
15d50 65 64 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 6d ed in a single m
15d60 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
15d70 2c 0a 2a 2a 20 74 6f 67 65 74 68 65 72 20 77 69 ,.** together wi
15d80 74 68 20 45 78 70 72 2e 7a 54 6f 6b 65 6e 20 73 th Expr.zToken s
15d90 74 72 69 6e 67 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 trings..**.** If
15da0 20 74 68 65 20 45 50 5f 52 65 64 75 63 65 64 20 the EP_Reduced
15db0 61 6e 64 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 and EP_TokenOnly
15dc0 20 66 6c 61 67 73 20 61 72 65 20 73 65 74 20 77 flags are set w
15dd0 68 65 6e 0a 2a 2a 20 61 6e 20 45 78 70 72 20 6f hen.** an Expr o
15de0 62 6a 65 63 74 20 69 73 20 74 72 75 6e 63 61 74 bject is truncat
15df0 65 64 2e 20 20 57 68 65 6e 20 45 50 5f 52 65 64 ed. When EP_Red
15e00 75 63 65 64 20 69 73 20 73 65 74 2c 20 74 68 65 uced is set, the
15e10 6e 20 61 6c 6c 0a 2a 2a 20 74 68 65 20 63 68 69 n all.** the chi
15e20 6c 64 20 45 78 70 72 20 6f 62 6a 65 63 74 73 20 ld Expr objects
15e30 69 6e 20 74 68 65 20 45 78 70 72 2e 70 4c 65 66 in the Expr.pLef
15e40 74 20 61 6e 64 20 45 78 70 72 2e 70 52 69 67 68 t and Expr.pRigh
15e50 74 20 73 75 62 74 72 65 65 73 0a 2a 2a 20 61 72 t subtrees.** ar
15e60 65 20 63 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 e contained with
15e70 69 6e 20 74 68 65 20 73 61 6d 65 20 6d 65 6d 6f in the same memo
15e80 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 ry allocation.
15e90 4e 6f 74 65 2c 20 68 6f 77 65 76 65 72 2c 20 74 Note, however, t
15ea0 68 61 74 0a 2a 2a 20 74 68 65 20 73 75 62 74 72 hat.** the subtr
15eb0 65 65 73 20 69 6e 20 45 78 70 72 2e 78 2e 70 4c ees in Expr.x.pL
15ec0 69 73 74 20 6f 72 20 45 78 70 72 2e 78 2e 70 53 ist or Expr.x.pS
15ed0 65 6c 65 63 74 20 61 72 65 20 61 6c 77 61 79 73 elect are always
15ee0 20 73 65 70 61 72 61 74 65 6c 79 0a 2a 2a 20 61 separately.** a
15ef0 6c 6c 6f 63 61 74 65 64 2c 20 72 65 67 61 72 64 llocated, regard
15f00 6c 65 73 73 20 6f 66 20 77 68 65 74 68 65 72 20 less of whether
15f10 6f 72 20 6e 6f 74 20 45 50 5f 52 65 64 75 63 65 or not EP_Reduce
15f20 64 20 69 73 20 73 65 74 2e 0a 2a 2f 0a 73 74 72 d is set..*/.str
15f30 75 63 74 20 45 78 70 72 20 7b 0a 20 20 75 38 20 uct Expr {. u8
15f40 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 op;
15f50 20 20 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f 6e /* Operation
15f60 20 70 65 72 66 6f 72 6d 65 64 20 62 79 20 74 68 performed by th
15f70 69 73 20 6e 6f 64 65 20 2a 2f 0a 20 20 63 68 61 is node */. cha
15f80 72 20 61 66 66 69 6e 69 74 79 3b 20 20 20 20 20 r affinity;
15f90 20 20 20 20 2f 2a 20 54 68 65 20 61 66 66 69 6e /* The affin
15fa0 69 74 79 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d ity of the colum
15fb0 6e 20 6f 72 20 30 20 69 66 20 6e 6f 74 20 61 20 n or 0 if not a
15fc0 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 75 33 32 20 column */. u32
15fd0 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 flags;
15fe0 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 66 6c /* Various fl
15ff0 61 67 73 2e 20 20 45 50 5f 2a 20 53 65 65 20 62 ags. EP_* See b
16000 65 6c 6f 77 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 elow */. union
16010 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 54 6f 6b {. char *zTok
16020 65 6e 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 en; /*
16030 54 6f 6b 65 6e 20 76 61 6c 75 65 2e 20 5a 65 72 Token value. Zer
16040 6f 20 74 65 72 6d 69 6e 61 74 65 64 20 61 6e 64 o terminated and
16050 20 64 65 71 75 6f 74 65 64 20 2a 2f 0a 20 20 20 dequoted */.
16060 20 69 6e 74 20 69 56 61 6c 75 65 3b 20 20 20 20 int iValue;
16070 20 20 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6e /* Non-n
16080 65 67 61 74 69 76 65 20 69 6e 74 65 67 65 72 20 egative integer
16090 76 61 6c 75 65 20 69 66 20 45 50 5f 49 6e 74 56 value if EP_IntV
160a0 61 6c 75 65 20 2a 2f 0a 20 20 7d 20 75 3b 0a 0a alue */. } u;..
160b0 20 20 2f 2a 20 49 66 20 74 68 65 20 45 50 5f 54 /* If the EP_T
160c0 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 67 20 69 73 okenOnly flag is
160d0 20 73 65 74 20 69 6e 20 74 68 65 20 45 78 70 72 set in the Expr
160e0 2e 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 .flags mask, the
160f0 6e 20 6e 6f 0a 20 20 2a 2a 20 73 70 61 63 65 20 n no. ** space
16100 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 is allocated for
16110 20 74 68 65 20 66 69 65 6c 64 73 20 62 65 6c 6f the fields belo
16120 77 20 74 68 69 73 20 70 6f 69 6e 74 2e 20 41 6e w this point. An
16130 20 61 74 74 65 6d 70 74 20 74 6f 0a 20 20 2a 2a attempt to. **
16140 20 61 63 63 65 73 73 20 74 68 65 6d 20 77 69 6c access them wil
16150 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20 73 65 l result in a se
16160 67 66 61 75 6c 74 20 6f 72 20 6d 61 6c 66 75 6e gfault or malfun
16170 63 74 69 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a ction.. *******
16180 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
16190 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
161a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
161b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a **************/.
161c0 0a 20 20 45 78 70 72 20 2a 70 4c 65 66 74 3b 20 . Expr *pLeft;
161d0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 66 /* Lef
161e0 74 20 73 75 62 6e 6f 64 65 20 2a 2f 0a 20 20 45 t subnode */. E
161f0 78 70 72 20 2a 70 52 69 67 68 74 3b 20 20 20 20 xpr *pRight;
16200 20 20 20 20 20 20 2f 2a 20 52 69 67 68 74 20 73 /* Right s
16210 75 62 6e 6f 64 65 20 2a 2f 0a 20 20 75 6e 69 6f ubnode */. unio
16220 6e 20 7b 0a 20 20 20 20 45 78 70 72 4c 69 73 74 n {. ExprList
16230 20 2a 70 4c 69 73 74 3b 20 20 20 20 20 2f 2a 20 *pList; /*
16240 6f 70 20 3d 20 49 4e 2c 20 45 58 49 53 54 53 2c op = IN, EXISTS,
16250 20 53 45 4c 45 43 54 2c 20 43 41 53 45 2c 20 46 SELECT, CASE, F
16260 55 4e 43 54 49 4f 4e 2c 20 42 45 54 57 45 45 4e UNCTION, BETWEEN
16270 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a */. Select *
16280 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 pSelect; /*
16290 45 50 5f 78 49 73 53 65 6c 65 63 74 20 61 6e 64 EP_xIsSelect and
162a0 20 6f 70 20 3d 20 49 4e 2c 20 45 58 49 53 54 53 op = IN, EXISTS
162b0 2c 20 53 45 4c 45 43 54 20 2a 2f 0a 20 20 7d 20 , SELECT */. }
162c0 78 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 x;.. /* If the
162d0 45 50 5f 52 65 64 75 63 65 64 20 66 6c 61 67 20 EP_Reduced flag
162e0 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 45 78 is set in the Ex
162f0 70 72 2e 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 pr.flags mask, t
16300 68 65 6e 20 6e 6f 0a 20 20 2a 2a 20 73 70 61 63 hen no. ** spac
16310 65 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 e is allocated f
16320 6f 72 20 74 68 65 20 66 69 65 6c 64 73 20 62 65 or the fields be
16330 6c 6f 77 20 74 68 69 73 20 70 6f 69 6e 74 2e 20 low this point.
16340 41 6e 20 61 74 74 65 6d 70 74 20 74 6f 0a 20 20 An attempt to.
16350 2a 2a 20 61 63 63 65 73 73 20 74 68 65 6d 20 77 ** access them w
16360 69 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20 ill result in a
16370 73 65 67 66 61 75 6c 74 20 6f 72 20 6d 61 6c 66 segfault or malf
16380 75 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a unction.. *****
16390 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
163a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
163b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
163c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
163d0 2f 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 /..#if SQLITE_MA
163e0 58 5f 45 58 50 52 5f 44 45 50 54 48 3e 30 0a 20 X_EXPR_DEPTH>0.
163f0 20 69 6e 74 20 6e 48 65 69 67 68 74 3b 20 20 20 int nHeight;
16400 20 20 20 20 20 20 20 20 2f 2a 20 48 65 69 67 68 /* Heigh
16410 74 20 6f 66 20 74 68 65 20 74 72 65 65 20 68 65 t of the tree he
16420 61 64 65 64 20 62 79 20 74 68 69 73 20 6e 6f 64 aded by this nod
16430 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e e */.#endif. in
16440 74 20 69 54 61 62 6c 65 3b 20 20 20 20 20 20 20 t iTable;
16450 20 20 20 20 20 2f 2a 20 54 4b 5f 43 4f 4c 55 4d /* TK_COLUM
16460 4e 3a 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 N: cursor number
16470 20 6f 66 20 74 61 62 6c 65 20 68 6f 6c 64 69 6e of table holdin
16480 67 20 63 6f 6c 75 6d 6e 0a 20 20 20 20 20 20 20 g column.
16490 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
164a0 20 20 2a 2a 20 54 4b 5f 52 45 47 49 53 54 45 52 ** TK_REGISTER
164b0 3a 20 72 65 67 69 73 74 65 72 20 6e 75 6d 62 65 : register numbe
164c0 72 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r.
164d0 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b ** TK
164e0 5f 54 52 49 47 47 45 52 3a 20 31 20 2d 3e 20 6e _TRIGGER: 1 -> n
164f0 65 77 2c 20 30 20 2d 3e 20 6f 6c 64 0a 20 20 20 ew, 0 -> old.
16500 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16510 20 20 20 20 20 20 2a 2a 20 45 50 5f 55 6e 6c 69 ** EP_Unli
16520 6b 65 6c 79 3a 20 20 31 33 34 32 31 37 37 32 38 kely: 134217728
16530 20 74 69 6d 65 73 20 6c 69 6b 65 6c 69 68 6f 6f times likelihoo
16540 64 20 2a 2f 0a 20 20 79 6e 56 61 72 20 69 43 6f d */. ynVar iCo
16550 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a lumn; /*
16560 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 63 6f 6c 75 TK_COLUMN: colu
16570 6d 6e 20 69 6e 64 65 78 2e 20 20 2d 31 20 66 6f mn index. -1 fo
16580 72 20 72 6f 77 69 64 2e 0a 20 20 20 20 20 20 20 r rowid..
16590 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
165a0 20 20 2a 2a 20 54 4b 5f 56 41 52 49 41 42 4c 45 ** TK_VARIABLE
165b0 3a 20 76 61 72 69 61 62 6c 65 20 6e 75 6d 62 65 : variable numbe
165c0 72 20 28 61 6c 77 61 79 73 20 3e 3d 20 31 29 2e r (always >= 1).
165d0 20 2a 2f 0a 20 20 69 31 36 20 69 41 67 67 3b 20 */. i16 iAgg;
165e0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
165f0 57 68 69 63 68 20 65 6e 74 72 79 20 69 6e 20 70 Which entry in p
16600 41 67 67 49 6e 66 6f 2d 3e 61 43 6f 6c 5b 5d 20 AggInfo->aCol[]
16610 6f 72 20 2d 3e 61 46 75 6e 63 5b 5d 20 2a 2f 0a or ->aFunc[] */.
16620 20 20 69 31 36 20 69 52 69 67 68 74 4a 6f 69 6e i16 iRightJoin
16630 54 61 62 6c 65 3b 20 20 20 2f 2a 20 49 66 20 45 Table; /* If E
16640 50 5f 46 72 6f 6d 4a 6f 69 6e 2c 20 74 68 65 20 P_FromJoin, the
16650 72 69 67 68 74 20 74 61 62 6c 65 20 6f 66 20 74 right table of t
16660 68 65 20 6a 6f 69 6e 20 2a 2f 0a 20 20 75 38 20 he join */. u8
16670 6f 70 32 3b 20 20 20 20 20 20 20 20 20 20 20 20 op2;
16680 20 20 20 20 2f 2a 20 54 4b 5f 52 45 47 49 53 54 /* TK_REGIST
16690 45 52 3a 20 6f 72 69 67 69 6e 61 6c 20 76 61 6c ER: original val
166a0 75 65 20 6f 66 20 45 78 70 72 2e 6f 70 0a 20 20 ue of Expr.op.
166b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
166c0 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f 43 4f 4c ** TK_COL
166d0 55 4d 4e 3a 20 74 68 65 20 76 61 6c 75 65 20 6f UMN: the value o
166e0 66 20 70 35 20 66 6f 72 20 4f 50 5f 43 6f 6c 75 f p5 for OP_Colu
166f0 6d 6e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 mn.
16700 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 ** T
16710 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 3a 20 K_AGG_FUNCTION:
16720 6e 65 73 74 69 6e 67 20 64 65 70 74 68 20 2a 2f nesting depth */
16730 0a 20 20 41 67 67 49 6e 66 6f 20 2a 70 41 67 67 . AggInfo *pAgg
16740 49 6e 66 6f 3b 20 20 20 20 20 2f 2a 20 55 73 65 Info; /* Use
16750 64 20 62 79 20 54 4b 5f 41 47 47 5f 43 4f 4c 55 d by TK_AGG_COLU
16760 4d 4e 20 61 6e 64 20 54 4b 5f 41 47 47 5f 46 55 MN and TK_AGG_FU
16770 4e 43 54 49 4f 4e 20 2a 2f 0a 20 20 54 61 62 6c NCTION */. Tabl
16780 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 20 20 e *pTab;
16790 20 20 20 2f 2a 20 54 61 62 6c 65 20 66 6f 72 20 /* Table for
167a0 54 4b 5f 43 4f 4c 55 4d 4e 20 65 78 70 72 65 73 TK_COLUMN expres
167b0 73 69 6f 6e 73 2e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a sions. */.};../*
167c0 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
167d0 67 20 61 72 65 20 74 68 65 20 6d 65 61 6e 69 6e g are the meanin
167e0 67 73 20 6f 66 20 62 69 74 73 20 69 6e 20 74 68 gs of bits in th
167f0 65 20 45 78 70 72 2e 66 6c 61 67 73 20 66 69 65 e Expr.flags fie
16800 6c 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 ld..*/.#define E
16810 50 5f 46 72 6f 6d 4a 6f 69 6e 20 20 30 78 30 30 P_FromJoin 0x00
16820 30 30 30 31 20 2f 2a 20 4f 72 69 67 69 6e 61 74 0001 /* Originat
16830 65 73 20 69 6e 20 4f 4e 2f 55 53 49 4e 47 20 63 es in ON/USING c
16840 6c 61 75 73 65 20 6f 66 20 6f 75 74 65 72 20 6a lause of outer j
16850 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 oin */.#define E
16860 50 5f 41 67 67 20 20 20 20 20 20 20 30 78 30 30 P_Agg 0x00
16870 30 30 30 32 20 2f 2a 20 43 6f 6e 74 61 69 6e 73 0002 /* Contains
16880 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 61 67 67 one or more agg
16890 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 regate functions
168a0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 52 */.#define EP_R
168b0 65 73 6f 6c 76 65 64 20 20 30 78 30 30 30 30 30 esolved 0x00000
168c0 34 20 2f 2a 20 49 44 73 20 68 61 76 65 20 62 65 4 /* IDs have be
168d0 65 6e 20 72 65 73 6f 6c 76 65 64 20 74 6f 20 43 en resolved to C
168e0 4f 4c 55 4d 4e 73 20 2a 2f 0a 23 64 65 66 69 6e OLUMNs */.#defin
168f0 65 20 45 50 5f 45 72 72 6f 72 20 20 20 20 20 30 e EP_Error 0
16900 78 30 30 30 30 30 38 20 2f 2a 20 45 78 70 72 65 x000008 /* Expre
16910 73 73 69 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 6f ssion contains o
16920 6e 65 20 6f 72 20 6d 6f 72 65 20 65 72 72 6f 72 ne or more error
16930 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f s */.#define EP_
16940 44 69 73 74 69 6e 63 74 20 20 30 78 30 30 30 30 Distinct 0x0000
16950 31 30 20 2f 2a 20 41 67 67 72 65 67 61 74 65 20 10 /* Aggregate
16960 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 44 49 function with DI
16970 53 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 20 2a STINCT keyword *
16980 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 56 61 72 /.#define EP_Var
16990 53 65 6c 65 63 74 20 30 78 30 30 30 30 32 30 20 Select 0x000020
169a0 2f 2a 20 70 53 65 6c 65 63 74 20 69 73 20 63 6f /* pSelect is co
169b0 72 72 65 6c 61 74 65 64 2c 20 6e 6f 74 20 63 6f rrelated, not co
169c0 6e 73 74 61 6e 74 20 2a 2f 0a 23 64 65 66 69 6e nstant */.#defin
169d0 65 20 45 50 5f 44 62 6c 51 75 6f 74 65 64 20 30 e EP_DblQuoted 0
169e0 78 30 30 30 30 34 30 20 2f 2a 20 74 6f 6b 65 6e x000040 /* token
169f0 2e 7a 20 77 61 73 20 6f 72 69 67 69 6e 61 6c 6c .z was originall
16a00 79 20 69 6e 20 22 2e 2e 2e 22 20 2a 2f 0a 23 64 y in "..." */.#d
16a10 65 66 69 6e 65 20 45 50 5f 49 6e 66 69 78 46 75 efine EP_InfixFu
16a20 6e 63 20 30 78 30 30 30 30 38 30 20 2f 2a 20 54 nc 0x000080 /* T
16a30 72 75 65 20 66 6f 72 20 61 6e 20 69 6e 66 69 78 rue for an infix
16a40 20 66 75 6e 63 74 69 6f 6e 3a 20 4c 49 4b 45 2c function: LIKE,
16a50 20 47 4c 4f 42 2c 20 65 74 63 20 2a 2f 0a 23 64 GLOB, etc */.#d
16a60 65 66 69 6e 65 20 45 50 5f 43 6f 6c 6c 61 74 65 efine EP_Collate
16a70 20 20 20 30 78 30 30 30 31 30 30 20 2f 2a 20 54 0x000100 /* T
16a80 72 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 ree contains a T
16a90 4b 5f 43 4f 4c 4c 41 54 45 20 6f 70 65 72 61 74 K_COLLATE operat
16aa0 6f 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 or */.#define EP
16ab0 5f 47 65 6e 65 72 69 63 20 20 20 30 78 30 30 30 _Generic 0x000
16ac0 32 30 30 20 2f 2a 20 49 67 6e 6f 72 65 20 43 4f 200 /* Ignore CO
16ad0 4c 4c 41 54 45 20 6f 72 20 61 66 66 69 6e 69 74 LLATE or affinit
16ae0 79 20 6f 6e 20 74 68 69 73 20 74 72 65 65 20 2a y on this tree *
16af0 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 49 6e 74 /.#define EP_Int
16b00 56 61 6c 75 65 20 20 30 78 30 30 30 34 30 30 20 Value 0x000400
16b10 2f 2a 20 49 6e 74 65 67 65 72 20 76 61 6c 75 65 /* Integer value
16b20 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 75 2e contained in u.
16b30 69 56 61 6c 75 65 20 2a 2f 0a 23 64 65 66 69 6e iValue */.#defin
16b40 65 20 45 50 5f 78 49 73 53 65 6c 65 63 74 20 30 e EP_xIsSelect 0
16b50 78 30 30 30 38 30 30 20 2f 2a 20 78 2e 70 53 65 x000800 /* x.pSe
16b60 6c 65 63 74 20 69 73 20 76 61 6c 69 64 20 28 6f lect is valid (o
16b70 74 68 65 72 77 69 73 65 20 78 2e 70 4c 69 73 74 therwise x.pList
16b80 20 69 73 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 is) */.#define
16b90 45 50 5f 53 6b 69 70 20 20 20 20 20 20 30 78 30 EP_Skip 0x0
16ba0 30 31 30 30 30 20 2f 2a 20 43 4f 4c 4c 41 54 45 01000 /* COLLATE
16bb0 2c 20 41 53 2c 20 6f 72 20 55 4e 4c 49 4b 45 4c , AS, or UNLIKEL
16bc0 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f Y */.#define EP_
16bd0 52 65 64 75 63 65 64 20 20 20 30 78 30 30 32 30 Reduced 0x0020
16be0 30 30 20 2f 2a 20 45 78 70 72 20 73 74 72 75 63 00 /* Expr struc
16bf0 74 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 49 t EXPR_REDUCEDSI
16c00 5a 45 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f ZE bytes only */
16c10 0a 23 64 65 66 69 6e 65 20 45 50 5f 54 6f 6b 65 .#define EP_Toke
16c20 6e 4f 6e 6c 79 20 30 78 30 30 34 30 30 30 20 2f nOnly 0x004000 /
16c30 2a 20 45 78 70 72 20 73 74 72 75 63 74 20 45 58 * Expr struct EX
16c40 50 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 5a 45 PR_TOKENONLYSIZE
16c50 20 62 79 74 65 73 20 6f 6e 6c 79 20 2a 2f 0a 23 bytes only */.#
16c60 64 65 66 69 6e 65 20 45 50 5f 53 74 61 74 69 63 define EP_Static
16c70 20 20 20 20 30 78 30 30 38 30 30 30 20 2f 2a 20 0x008000 /*
16c80 48 65 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 6e Held in memory n
16c90 6f 74 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d ot obtained from
16ca0 20 6d 61 6c 6c 6f 63 28 29 20 2a 2f 0a 23 64 65 malloc() */.#de
16cb0 66 69 6e 65 20 45 50 5f 4d 65 6d 54 6f 6b 65 6e fine EP_MemToken
16cc0 20 20 30 78 30 31 30 30 30 30 20 2f 2a 20 4e 65 0x010000 /* Ne
16cd0 65 64 20 74 6f 20 73 71 6c 69 74 65 33 44 62 46 ed to sqlite3DbF
16ce0 72 65 65 28 29 20 45 78 70 72 2e 7a 54 6f 6b 65 ree() Expr.zToke
16cf0 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f n */.#define EP_
16d00 4e 6f 52 65 64 75 63 65 20 20 30 78 30 32 30 30 NoReduce 0x0200
16d10 30 30 20 2f 2a 20 43 61 6e 6e 6f 74 20 45 58 50 00 /* Cannot EXP
16d20 52 44 55 50 5f 52 45 44 55 43 45 20 74 68 69 73 RDUP_REDUCE this
16d30 20 45 78 70 72 20 2a 2f 0a 23 64 65 66 69 6e 65 Expr */.#define
16d40 20 45 50 5f 55 6e 6c 69 6b 65 6c 79 20 20 30 78 EP_Unlikely 0x
16d50 30 34 30 30 30 30 20 2f 2a 20 75 6e 6c 69 6b 65 040000 /* unlike
16d60 6c 79 28 29 20 6f 72 20 6c 69 6b 65 6c 69 68 6f ly() or likeliho
16d70 6f 64 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f od() function */
16d80 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 6f 6e 73 .#define EP_Cons
16d90 74 46 75 6e 63 20 30 78 30 38 30 30 30 30 20 2f tFunc 0x080000 /
16da0 2a 20 41 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f * A SQLITE_FUNC_
16db0 43 4f 4e 53 54 41 4e 54 20 6f 72 20 5f 53 4c 4f CONSTANT or _SLO
16dc0 43 48 4e 47 20 66 75 6e 63 74 69 6f 6e 20 2a 2f CHNG function */
16dd0 0a 23 64 65 66 69 6e 65 20 45 50 5f 43 61 6e 42 .#define EP_CanB
16de0 65 4e 75 6c 6c 20 30 78 31 30 30 30 30 30 20 2f eNull 0x100000 /
16df0 2a 20 43 61 6e 20 62 65 20 6e 75 6c 6c 20 64 65 * Can be null de
16e00 73 70 69 74 65 20 4e 4f 54 20 4e 55 4c 4c 20 63 spite NOT NULL c
16e10 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 23 64 65 onstraint */.#de
16e20 66 69 6e 65 20 45 50 5f 53 75 62 71 75 65 72 79 fine EP_Subquery
16e30 20 20 30 78 32 30 30 30 30 30 20 2f 2a 20 54 72 0x200000 /* Tr
16e40 65 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 54 4b ee contains a TK
16e50 5f 53 45 4c 45 43 54 20 6f 70 65 72 61 74 6f 72 _SELECT operator
16e60 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 41 */.#define EP_A
16e70 6c 69 61 73 20 20 20 20 20 30 78 34 30 30 30 30 lias 0x40000
16e80 30 20 2f 2a 20 49 73 20 61 6e 20 61 6c 69 61 73 0 /* Is an alias
16e90 20 66 6f 72 20 61 20 72 65 73 75 6c 74 20 73 65 for a result se
16ea0 74 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 0a 2f 2a 0a t column */../*.
16eb0 2a 2a 20 43 6f 6d 62 69 6e 61 74 69 6f 6e 73 20 ** Combinations
16ec0 6f 66 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 45 of two or more E
16ed0 50 5f 2a 20 66 6c 61 67 73 0a 2a 2f 0a 23 64 65 P_* flags.*/.#de
16ee0 66 69 6e 65 20 45 50 5f 50 72 6f 70 61 67 61 74 fine EP_Propagat
16ef0 65 20 28 45 50 5f 43 6f 6c 6c 61 74 65 7c 45 50 e (EP_Collate|EP
16f00 5f 53 75 62 71 75 65 72 79 29 20 2f 2a 20 50 72 _Subquery) /* Pr
16f10 6f 70 61 67 61 74 65 20 74 68 65 73 65 20 62 69 opagate these bi
16f20 74 73 20 75 70 20 74 72 65 65 20 2a 2f 0a 0a 2f ts up tree */../
16f30 2a 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 6f *.** These macro
16f40 73 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f s can be used to
16f50 20 74 65 73 74 2c 20 73 65 74 2c 20 6f 72 20 63 test, set, or c
16f60 6c 65 61 72 20 62 69 74 73 20 69 6e 20 74 68 65 lear bits in the
16f70 0a 2a 2a 20 45 78 70 72 2e 66 6c 61 67 73 20 66 .** Expr.flags f
16f80 69 65 6c 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ield..*/.#define
16f90 20 45 78 70 72 48 61 73 50 72 6f 70 65 72 74 79 ExprHasProperty
16fa0 28 45 2c 50 29 20 20 20 20 20 28 28 28 45 29 2d (E,P) (((E)-
16fb0 3e 66 6c 61 67 73 26 28 50 29 29 21 3d 30 29 0a >flags&(P))!=0).
16fc0 23 64 65 66 69 6e 65 20 45 78 70 72 48 61 73 41 #define ExprHasA
16fd0 6c 6c 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 llProperty(E,P)
16fe0 20 28 28 28 45 29 2d 3e 66 6c 61 67 73 26 28 50 (((E)->flags&(P
16ff0 29 29 3d 3d 28 50 29 29 0a 23 64 65 66 69 6e 65 ))==(P)).#define
17000 20 45 78 70 72 53 65 74 50 72 6f 70 65 72 74 79 ExprSetProperty
17010 28 45 2c 50 29 20 20 20 20 20 28 45 29 2d 3e 66 (E,P) (E)->f
17020 6c 61 67 73 7c 3d 28 50 29 0a 23 64 65 66 69 6e lags|=(P).#defin
17030 65 20 45 78 70 72 43 6c 65 61 72 50 72 6f 70 65 e ExprClearPrope
17040 72 74 79 28 45 2c 50 29 20 20 20 28 45 29 2d 3e rty(E,P) (E)->
17050 66 6c 61 67 73 26 3d 7e 28 50 29 0a 0a 2f 2a 20 flags&=~(P)../*
17060 54 68 65 20 45 78 70 72 53 65 74 56 56 41 50 72 The ExprSetVVAPr
17070 6f 70 65 72 74 79 28 29 20 6d 61 63 72 6f 20 69 operty() macro i
17080 73 20 75 73 65 64 20 66 6f 72 20 56 65 72 69 66 s used for Verif
17090 69 63 61 74 69 6f 6e 2c 20 56 61 6c 69 64 61 74 ication, Validat
170a0 69 6f 6e 2c 0a 2a 2a 20 61 6e 64 20 41 63 63 72 ion,.** and Accr
170b0 65 64 69 74 61 74 69 6f 6e 20 6f 6e 6c 79 2e 20 editation only.
170c0 20 49 74 20 77 6f 72 6b 73 20 6c 69 6b 65 20 45 It works like E
170d0 78 70 72 53 65 74 50 72 6f 70 65 72 74 79 28 29 xprSetProperty()
170e0 20 64 75 72 69 6e 67 20 56 56 41 0a 2a 2a 20 70 during VVA.** p
170f0 72 6f 63 65 73 73 65 73 20 62 75 74 20 69 73 20 rocesses but is
17100 61 20 6e 6f 2d 6f 70 20 66 6f 72 20 64 65 6c 69 a no-op for deli
17110 76 65 72 79 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 very..*/.#ifdef
17120 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 23 20 64 SQLITE_DEBUG.# d
17130 65 66 69 6e 65 20 45 78 70 72 53 65 74 56 56 41 efine ExprSetVVA
17140 50 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 28 Property(E,P) (
17150 45 29 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 0a 23 E)->flags|=(P).#
17160 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 45 78 else.# define Ex
17170 70 72 53 65 74 56 56 41 50 72 6f 70 65 72 74 79 prSetVVAProperty
17180 28 45 2c 50 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a (E,P).#endif../*
17190 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 6f 20 64 65 .** Macros to de
171a0 74 65 72 6d 69 6e 65 20 74 68 65 20 6e 75 6d 62 termine the numb
171b0 65 72 20 6f 66 20 62 79 74 65 73 20 72 65 71 75 er of bytes requ
171c0 69 72 65 64 20 62 79 20 61 20 6e 6f 72 6d 61 6c ired by a normal
171d0 20 45 78 70 72 0a 2a 2a 20 73 74 72 75 63 74 2c Expr.** struct,
171e0 20 61 6e 20 45 78 70 72 20 73 74 72 75 63 74 20 an Expr struct
171f0 77 69 74 68 20 74 68 65 20 45 50 5f 52 65 64 75 with the EP_Redu
17200 63 65 64 20 66 6c 61 67 20 73 65 74 20 69 6e 20 ced flag set in
17210 45 78 70 72 2e 66 6c 61 67 73 0a 2a 2a 20 61 6e Expr.flags.** an
17220 64 20 61 6e 20 45 78 70 72 20 73 74 72 75 63 74 d an Expr struct
17230 20 77 69 74 68 20 74 68 65 20 45 50 5f 54 6f 6b with the EP_Tok
17240 65 6e 4f 6e 6c 79 20 66 6c 61 67 20 73 65 74 2e enOnly flag set.
17250 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 .*/.#define EXPR
17260 5f 46 55 4c 4c 53 49 5a 45 20 20 20 20 20 20 20 _FULLSIZE
17270 20 20 20 20 73 69 7a 65 6f 66 28 45 78 70 72 29 sizeof(Expr)
17280 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 75 /* Fu
17290 6c 6c 20 73 69 7a 65 20 2a 2f 0a 23 64 65 66 69 ll size */.#defi
172a0 6e 65 20 45 58 50 52 5f 52 45 44 55 43 45 44 53 ne EXPR_REDUCEDS
172b0 49 5a 45 20 20 20 20 20 20 20 20 6f 66 66 73 65 IZE offse
172c0 74 6f 66 28 45 78 70 72 2c 69 54 61 62 6c 65 29 tof(Expr,iTable)
172d0 20 20 2f 2a 20 43 6f 6d 6d 6f 6e 20 66 65 61 74 /* Common feat
172e0 75 72 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ures */.#define
172f0 45 58 50 52 5f 54 4f 4b 45 4e 4f 4e 4c 59 53 49 EXPR_TOKENONLYSI
17300 5a 45 20 20 20 20 20 20 6f 66 66 73 65 74 6f 66 ZE offsetof
17310 28 45 78 70 72 2c 70 4c 65 66 74 29 20 20 20 2f (Expr,pLeft) /
17320 2a 20 46 65 77 65 72 20 66 65 61 74 75 72 65 73 * Fewer features
17330 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 46 6c 61 67 73 */../*.** Flags
17340 20 70 61 73 73 65 64 20 74 6f 20 74 68 65 20 73 passed to the s
17350 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 29 20 qlite3ExprDup()
17360 66 75 6e 63 74 69 6f 6e 2e 20 53 65 65 20 74 68 function. See th
17370 65 20 68 65 61 64 65 72 20 63 6f 6d 6d 65 6e 74 e header comment
17380 0a 2a 2a 20 61 62 6f 76 65 20 73 71 6c 69 74 65 .** above sqlite
17390 33 45 78 70 72 44 75 70 28 29 20 66 6f 72 20 64 3ExprDup() for d
173a0 65 74 61 69 6c 73 2e 0a 2a 2f 0a 23 64 65 66 69 etails..*/.#defi
173b0 6e 65 20 45 58 50 52 44 55 50 5f 52 45 44 55 43 ne EXPRDUP_REDUC
173c0 45 20 20 20 20 20 20 20 20 20 30 78 30 30 30 31 E 0x0001
173d0 20 20 2f 2a 20 55 73 65 64 20 72 65 64 75 63 65 /* Used reduce
173e0 64 2d 73 69 7a 65 20 45 78 70 72 20 6e 6f 64 65 d-size Expr node
173f0 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 6c 69 s */../*.** A li
17400 73 74 20 6f 66 20 65 78 70 72 65 73 73 69 6f 6e st of expression
17410 73 2e 20 20 45 61 63 68 20 65 78 70 72 65 73 73 s. Each express
17420 69 6f 6e 20 6d 61 79 20 6f 70 74 69 6f 6e 61 6c ion may optional
17430 6c 79 20 68 61 76 65 20 61 0a 2a 2a 20 6e 61 6d ly have a.** nam
17440 65 2e 20 20 41 6e 20 65 78 70 72 2f 6e 61 6d 65 e. An expr/name
17450 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 63 61 6e combination can
17460 20 62 65 20 75 73 65 64 20 69 6e 20 73 65 76 65 be used in seve
17470 72 61 6c 20 77 61 79 73 2c 20 73 75 63 68 0a 2a ral ways, such.*
17480 2a 20 61 73 20 74 68 65 20 6c 69 73 74 20 6f 66 * as the list of
17490 20 22 65 78 70 72 20 41 53 20 49 44 22 20 66 69 "expr AS ID" fi
174a0 65 6c 64 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 elds following a
174b0 20 22 53 45 4c 45 43 54 22 20 6f 72 20 69 6e 20 "SELECT" or in
174c0 74 68 65 0a 2a 2a 20 6c 69 73 74 20 6f 66 20 22 the.** list of "
174d0 49 44 20 3d 20 65 78 70 72 22 20 69 74 65 6d 73 ID = expr" items
174e0 20 69 6e 20 61 6e 20 55 50 44 41 54 45 2e 20 20 in an UPDATE.
174f0 41 20 6c 69 73 74 20 6f 66 20 65 78 70 72 65 73 A list of expres
17500 73 69 6f 6e 73 20 63 61 6e 0a 2a 2a 20 61 6c 73 sions can.** als
17510 6f 20 62 65 20 75 73 65 64 20 61 73 20 74 68 65 o be used as the
17520 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 61 20 66 argument to a f
17530 75 6e 63 74 69 6f 6e 2c 20 69 6e 20 77 68 69 63 unction, in whic
17540 68 20 63 61 73 65 20 74 68 65 20 61 2e 7a 4e 61 h case the a.zNa
17550 6d 65 0a 2a 2a 20 66 69 65 6c 64 20 69 73 20 6e me.** field is n
17560 6f 74 20 75 73 65 64 2e 0a 2a 2a 0a 2a 2a 20 42 ot used..**.** B
17570 79 20 64 65 66 61 75 6c 74 20 74 68 65 20 45 78 y default the Ex
17580 70 72 2e 7a 53 70 61 6e 20 66 69 65 6c 64 20 68 pr.zSpan field h
17590 6f 6c 64 73 20 61 20 68 75 6d 61 6e 2d 72 65 61 olds a human-rea
175a0 64 61 62 6c 65 20 64 65 73 63 72 69 70 74 69 6f dable descriptio
175b0 6e 20 6f 66 0a 2a 2a 20 74 68 65 20 65 78 70 72 n of.** the expr
175c0 65 73 73 69 6f 6e 20 74 68 61 74 20 69 73 20 75 ession that is u
175d0 73 65 64 20 69 6e 20 74 68 65 20 67 65 6e 65 72 sed in the gener
175e0 61 74 69 6f 6e 20 6f 66 20 65 72 72 6f 72 20 6d ation of error m
175f0 65 73 73 61 67 65 73 20 61 6e 64 0a 2a 2a 20 63 essages and.** c
17600 6f 6c 75 6d 6e 20 6c 61 62 65 6c 73 2e 20 20 49 olumn labels. I
17610 6e 20 74 68 69 73 20 63 61 73 65 2c 20 45 78 70 n this case, Exp
17620 72 2e 7a 53 70 61 6e 20 69 73 20 74 79 70 69 63 r.zSpan is typic
17630 61 6c 6c 79 20 74 68 65 20 74 65 78 74 20 6f 66 ally the text of
17640 20 61 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 65 78 70 a.** column exp
17650 72 65 73 73 69 6f 6e 20 61 73 20 69 74 20 65 78 ression as it ex
17660 69 73 74 73 20 69 6e 20 61 20 53 45 4c 45 43 54 ists in a SELECT
17670 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 48 6f 77 statement. How
17680 65 76 65 72 2c 20 69 66 0a 2a 2a 20 74 68 65 20 ever, if.** the
17690 62 53 70 61 6e 49 73 54 61 62 20 66 6c 61 67 20 bSpanIsTab flag
176a0 69 73 20 73 65 74 2c 20 74 68 65 6e 20 7a 53 70 is set, then zSp
176b0 61 6e 20 69 73 20 6f 76 65 72 6c 6f 61 64 65 64 an is overloaded
176c0 20 74 6f 20 6d 65 61 6e 20 74 68 65 20 6e 61 6d to mean the nam
176d0 65 0a 2a 2a 20 6f 66 20 74 68 65 20 72 65 73 75 e.** of the resu
176e0 6c 74 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 lt column in the
176f0 20 66 6f 72 6d 3a 20 44 41 54 41 42 41 53 45 2e form: DATABASE.
17700 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 2e 20 20 54 TABLE.COLUMN. T
17710 68 69 73 20 6c 61 74 65 72 0a 2a 2a 20 66 6f 72 his later.** for
17720 6d 20 69 73 20 75 73 65 64 20 66 6f 72 20 6e 61 m is used for na
17730 6d 65 20 72 65 73 6f 6c 75 74 69 6f 6e 20 77 69 me resolution wi
17740 74 68 20 6e 65 73 74 65 64 20 46 52 4f 4d 20 63 th nested FROM c
17750 6c 61 75 73 65 73 2e 0a 2a 2f 0a 73 74 72 75 63 lauses..*/.struc
17760 74 20 45 78 70 72 4c 69 73 74 20 7b 0a 20 20 69 t ExprList {. i
17770 6e 74 20 6e 45 78 70 72 3b 20 20 20 20 20 20 20 nt nExpr;
17780 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
17790 6f 66 20 65 78 70 72 65 73 73 69 6f 6e 73 20 6f of expressions o
177a0 6e 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a 20 20 n the list */.
177b0 73 74 72 75 63 74 20 45 78 70 72 4c 69 73 74 5f struct ExprList_
177c0 69 74 65 6d 20 7b 20 2f 2a 20 46 6f 72 20 65 61 item { /* For ea
177d0 63 68 20 65 78 70 72 65 73 73 69 6f 6e 20 69 6e ch expression in
177e0 20 74 68 65 20 6c 69 73 74 20 2a 2f 0a 20 20 20 the list */.
177f0 20 45 78 70 72 20 2a 70 45 78 70 72 3b 20 20 20 Expr *pExpr;
17800 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
17810 6c 69 73 74 20 6f 66 20 65 78 70 72 65 73 73 69 list of expressi
17820 6f 6e 73 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 ons */. char
17830 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 *zName;
17840 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 61 73 73 6f /* Token asso
17850 63 69 61 74 65 64 20 77 69 74 68 20 74 68 69 73 ciated with this
17860 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 expression */.
17870 20 20 20 63 68 61 72 20 2a 7a 53 70 61 6e 3b 20 char *zSpan;
17880 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 /* Or
17890 69 67 69 6e 61 6c 20 74 65 78 74 20 6f 66 20 74 iginal text of t
178a0 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 2a 2f he expression */
178b0 0a 20 20 20 20 75 38 20 73 6f 72 74 4f 72 64 65 . u8 sortOrde
178c0 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 r; /*
178d0 31 20 66 6f 72 20 44 45 53 43 20 6f 72 20 30 20 1 for DESC or 0
178e0 66 6f 72 20 41 53 43 20 2a 2f 0a 20 20 20 20 75 for ASC */. u
178f0 6e 73 69 67 6e 65 64 20 64 6f 6e 65 20 3a 31 3b nsigned done :1;
17900 20 20 20 20 20 20 20 2f 2a 20 41 20 66 6c 61 67 /* A flag
17910 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77 68 65 to indicate whe
17920 6e 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20 n processing is
17930 66 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 20 20 finished */.
17940 75 6e 73 69 67 6e 65 64 20 62 53 70 61 6e 49 73 unsigned bSpanIs
17950 54 61 62 20 3a 31 3b 20 2f 2a 20 7a 53 70 61 6e Tab :1; /* zSpan
17960 20 68 6f 6c 64 73 20 44 42 2e 54 41 42 4c 45 2e holds DB.TABLE.
17970 43 4f 4c 55 4d 4e 20 2a 2f 0a 20 20 20 20 75 6e COLUMN */. un
17980 73 69 67 6e 65 64 20 72 65 75 73 61 62 6c 65 20 signed reusable
17990 3a 31 3b 20 20 20 2f 2a 20 43 6f 6e 73 74 61 6e :1; /* Constan
179a0 74 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 t expression is
179b0 72 65 75 73 61 62 6c 65 20 2a 2f 0a 20 20 20 20 reusable */.
179c0 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 20 20 73 74 union {. st
179d0 72 75 63 74 20 7b 0a 20 20 20 20 20 20 20 20 75 ruct {. u
179e0 31 36 20 69 4f 72 64 65 72 42 79 43 6f 6c 3b 20 16 iOrderByCol;
179f0 20 20 20 20 20 2f 2a 20 46 6f 72 20 4f 52 44 45 /* For ORDE
17a00 52 20 42 59 2c 20 63 6f 6c 75 6d 6e 20 6e 75 6d R BY, column num
17a10 62 65 72 20 69 6e 20 72 65 73 75 6c 74 20 73 65 ber in result se
17a20 74 20 2a 2f 0a 20 20 20 20 20 20 20 20 75 31 36 t */. u16
17a30 20 69 41 6c 69 61 73 3b 20 20 20 20 20 20 20 20 iAlias;
17a40 20 20 20 2f 2a 20 49 6e 64 65 78 20 69 6e 74 6f /* Index into
17a50 20 50 61 72 73 65 2e 61 41 6c 69 61 73 5b 5d 20 Parse.aAlias[]
17a60 66 6f 72 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 20 for zName */.
17a70 20 20 20 7d 20 78 3b 0a 20 20 20 20 20 20 69 6e } x;. in
17a80 74 20 69 43 6f 6e 73 74 45 78 70 72 52 65 67 3b t iConstExprReg;
17a90 20 20 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 /* Registe
17aa0 72 20 69 6e 20 77 68 69 63 68 20 45 78 70 72 20 r in which Expr
17ab0 76 61 6c 75 65 20 69 73 20 63 61 63 68 65 64 20 value is cached
17ac0 2a 2f 0a 20 20 20 20 7d 20 75 3b 0a 20 20 7d 20 */. } u;. }
17ad0 2a 61 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 *a;
17ae0 20 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 20 61 20 /* Alloc a
17af0 70 6f 77 65 72 20 6f 66 20 74 77 6f 20 67 72 65 power of two gre
17b00 61 74 65 72 20 6f 72 20 65 71 75 61 6c 20 74 6f ater or equal to
17b10 20 6e 45 78 70 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a nExpr */.};../*
17b20 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 .** An instance
17b30 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 of this structur
17b40 65 20 69 73 20 75 73 65 64 20 62 79 20 74 68 65 e is used by the
17b50 20 70 61 72 73 65 72 20 74 6f 20 72 65 63 6f 72 parser to recor
17b60 64 20 62 6f 74 68 0a 2a 2a 20 74 68 65 20 70 61 d both.** the pa
17b70 72 73 65 20 74 72 65 65 20 66 6f 72 20 61 6e 20 rse tree for an
17b80 65 78 70 72 65 73 73 69 6f 6e 20 61 6e 64 20 74 expression and t
17b90 68 65 20 73 70 61 6e 20 6f 66 20 69 6e 70 75 74 he span of input
17ba0 20 74 65 78 74 20 66 6f 72 20 61 6e 0a 2a 2a 20 text for an.**
17bb0 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2a 2f 0a 73 expression..*/.s
17bc0 74 72 75 63 74 20 45 78 70 72 53 70 61 6e 20 7b truct ExprSpan {
17bd0 0a 20 20 45 78 70 72 20 2a 70 45 78 70 72 3b 20 . Expr *pExpr;
17be0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
17bf0 65 78 70 72 65 73 73 69 6f 6e 20 70 61 72 73 65 expression parse
17c00 20 74 72 65 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 tree */. const
17c10 20 63 68 61 72 20 2a 7a 53 74 61 72 74 3b 20 20 char *zStart;
17c20 20 2f 2a 20 46 69 72 73 74 20 63 68 61 72 61 63 /* First charac
17c30 74 65 72 20 6f 66 20 69 6e 70 75 74 20 74 65 78 ter of input tex
17c40 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 t */. const cha
17c50 72 20 2a 7a 45 6e 64 3b 20 20 20 20 20 2f 2a 20 r *zEnd; /*
17c60 4f 6e 65 20 63 68 61 72 61 63 74 65 72 20 70 61 One character pa
17c70 73 74 20 74 68 65 20 65 6e 64 20 6f 66 20 69 6e st the end of in
17c80 70 75 74 20 74 65 78 74 20 2a 2f 0a 7d 3b 0a 0a put text */.};..
17c90 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 /*.** An instanc
17ca0 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 e of this struct
17cb0 75 72 65 20 63 61 6e 20 68 6f 6c 64 20 61 20 73 ure can hold a s
17cc0 69 6d 70 6c 65 20 6c 69 73 74 20 6f 66 20 69 64 imple list of id
17cd0 65 6e 74 69 66 69 65 72 73 2c 0a 2a 2a 20 73 75 entifiers,.** su
17ce0 63 68 20 61 73 20 74 68 65 20 6c 69 73 74 20 22 ch as the list "
17cf0 61 2c 62 2c 63 22 20 69 6e 20 74 68 65 20 66 6f a,b,c" in the fo
17d00 6c 6c 6f 77 69 6e 67 20 73 74 61 74 65 6d 65 6e llowing statemen
17d10 74 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 20 49 ts:.**.** I
17d20 4e 53 45 52 54 20 49 4e 54 4f 20 74 28 61 2c 62 NSERT INTO t(a,b
17d30 2c 63 29 20 56 41 4c 55 45 53 20 2e 2e 2e 3b 0a ,c) VALUES ...;.
17d40 2a 2a 20 20 20 20 20 20 43 52 45 41 54 45 20 49 ** CREATE I
17d50 4e 44 45 58 20 69 64 78 20 4f 4e 20 74 28 61 2c NDEX idx ON t(a,
17d60 62 2c 63 29 3b 0a 2a 2a 20 20 20 20 20 20 43 52 b,c);.** CR
17d70 45 41 54 45 20 54 52 49 47 47 45 52 20 74 72 69 EATE TRIGGER tri
17d80 67 20 42 45 46 4f 52 45 20 55 50 44 41 54 45 20 g BEFORE UPDATE
17d90 4f 4e 20 74 28 61 2c 62 2c 63 29 20 2e 2e 2e 3b ON t(a,b,c) ...;
17da0 0a 2a 2a 0a 2a 2a 20 54 68 65 20 49 64 4c 69 73 .**.** The IdLis
17db0 74 2e 61 2e 69 64 78 20 66 69 65 6c 64 20 69 73 t.a.idx field is
17dc0 20 75 73 65 64 20 77 68 65 6e 20 74 68 65 20 49 used when the I
17dd0 64 4c 69 73 74 20 72 65 70 72 65 73 65 6e 74 73 dList represents
17de0 20 74 68 65 20 6c 69 73 74 20 6f 66 0a 2a 2a 20 the list of.**
17df0 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 61 66 74 column names aft
17e00 65 72 20 61 20 74 61 62 6c 65 20 6e 61 6d 65 20 er a table name
17e10 69 6e 20 61 6e 20 49 4e 53 45 52 54 20 73 74 61 in an INSERT sta
17e20 74 65 6d 65 6e 74 2e 20 20 49 6e 20 74 68 65 20 tement. In the
17e30 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 0a 2a 2a 20 statement.**.**
17e40 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 INSERT INTO
17e50 74 28 61 2c 62 2c 63 29 20 2e 2e 2e 0a 2a 2a 0a t(a,b,c) ....**.
17e60 2a 2a 20 49 66 20 22 61 22 20 69 73 20 74 68 65 ** If "a" is the
17e70 20 6b 2d 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 k-th column of
17e80 74 61 62 6c 65 20 22 74 22 2c 20 74 68 65 6e 20 table "t", then
17e90 49 64 4c 69 73 74 2e 61 5b 30 5d 2e 69 64 78 3d IdList.a[0].idx=
17ea0 3d 6b 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 64 =k..*/.struct Id
17eb0 4c 69 73 74 20 7b 0a 20 20 73 74 72 75 63 74 20 List {. struct
17ec0 49 64 4c 69 73 74 5f 69 74 65 6d 20 7b 0a 20 20 IdList_item {.
17ed0 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
17ee0 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
17ef0 68 65 20 69 64 65 6e 74 69 66 69 65 72 20 2a 2f he identifier */
17f00 0a 20 20 20 20 69 6e 74 20 69 64 78 3b 20 20 20 . int idx;
17f10 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 /* Index
17f20 69 6e 20 73 6f 6d 65 20 54 61 62 6c 65 2e 61 43 in some Table.aC
17f30 6f 6c 5b 5d 20 6f 66 20 61 20 63 6f 6c 75 6d 6e ol[] of a column
17f40 20 6e 61 6d 65 64 20 7a 4e 61 6d 65 20 2a 2f 0a named zName */.
17f50 20 20 7d 20 2a 61 3b 0a 20 20 69 6e 74 20 6e 49 } *a;. int nI
17f60 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 d; /* Nu
17f70 6d 62 65 72 20 6f 66 20 69 64 65 6e 74 69 66 69 mber of identifi
17f80 65 72 73 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 ers on the list
17f90 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 */.};../*.** The
17fa0 20 62 69 74 6d 61 73 6b 20 64 61 74 61 74 79 70 bitmask datatyp
17fb0 65 20 64 65 66 69 6e 65 64 20 62 65 6c 6f 77 20 e defined below
17fc0 69 73 20 75 73 65 64 20 66 6f 72 20 76 61 72 69 is used for vari
17fd0 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e ous optimization
17fe0 73 2e 0a 2a 2a 0a 2a 2a 20 43 68 61 6e 67 69 6e s..**.** Changin
17ff0 67 20 74 68 69 73 20 66 72 6f 6d 20 61 20 36 34 g this from a 64
18000 2d 62 69 74 20 74 6f 20 61 20 33 32 2d 62 69 74 -bit to a 32-bit
18010 20 74 79 70 65 20 6c 69 6d 69 74 73 20 74 68 65 type limits the
18020 20 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 74 61 number of.** ta
18030 62 6c 65 73 20 69 6e 20 61 20 6a 6f 69 6e 20 74 bles in a join t
18040 6f 20 33 32 20 69 6e 73 74 65 61 64 20 6f 66 20 o 32 instead of
18050 36 34 2e 20 20 42 75 74 20 69 74 20 61 6c 73 6f 64. But it also
18060 20 72 65 64 75 63 65 73 20 74 68 65 20 73 69 7a reduces the siz
18070 65 0a 2a 2a 20 6f 66 20 74 68 65 20 6c 69 62 72 e.** of the libr
18080 61 72 79 20 62 79 20 37 33 38 20 62 79 74 65 73 ary by 738 bytes
18090 20 6f 6e 20 69 78 38 36 2e 0a 2a 2f 0a 74 79 70 on ix86..*/.typ
180a0 65 64 65 66 20 75 36 34 20 42 69 74 6d 61 73 6b edef u64 Bitmask
180b0 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 6e 75 6d ;../*.** The num
180c0 62 65 72 20 6f 66 20 62 69 74 73 20 69 6e 20 61 ber of bits in a
180d0 20 42 69 74 6d 61 73 6b 2e 20 20 22 42 4d 53 22 Bitmask. "BMS"
180e0 20 6d 65 61 6e 73 20 22 42 69 74 4d 61 73 6b 20 means "BitMask
180f0 53 69 7a 65 22 2e 0a 2a 2f 0a 23 64 65 66 69 6e Size"..*/.#defin
18100 65 20 42 4d 53 20 20 28 28 69 6e 74 29 28 73 69 e BMS ((int)(si
18110 7a 65 6f 66 28 42 69 74 6d 61 73 6b 29 2a 38 29 zeof(Bitmask)*8)
18120 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 62 69 74 20 69 )../*.** A bit i
18130 6e 20 61 20 42 69 74 6d 61 73 6b 0a 2a 2f 0a 23 n a Bitmask.*/.#
18140 64 65 66 69 6e 65 20 4d 41 53 4b 42 49 54 28 6e define MASKBIT(n
18150 29 20 20 20 28 28 28 42 69 74 6d 61 73 6b 29 31 ) (((Bitmask)1
18160 29 3c 3c 28 6e 29 29 0a 23 64 65 66 69 6e 65 20 )<<(n)).#define
18170 4d 41 53 4b 42 49 54 33 32 28 6e 29 20 28 28 28 MASKBIT32(n) (((
18180 75 6e 73 69 67 6e 65 64 20 69 6e 74 29 31 29 3c unsigned int)1)<
18190 3c 28 6e 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 <(n))../*.** The
181a0 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 following struc
181b0 74 75 72 65 20 64 65 73 63 72 69 62 65 73 20 74 ture describes t
181c0 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 6f he FROM clause o
181d0 66 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 f a SELECT state
181e0 6d 65 6e 74 2e 0a 2a 2a 20 45 61 63 68 20 74 61 ment..** Each ta
181f0 62 6c 65 20 6f 72 20 73 75 62 71 75 65 72 79 20 ble or subquery
18200 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 in the FROM clau
18210 73 65 20 69 73 20 61 20 73 65 70 61 72 61 74 65 se is a separate
18220 20 65 6c 65 6d 65 6e 74 20 6f 66 0a 2a 2a 20 74 element of.** t
18230 68 65 20 53 72 63 4c 69 73 74 2e 61 5b 5d 20 61 he SrcList.a[] a
18240 72 72 61 79 2e 0a 2a 2a 0a 2a 2a 20 57 69 74 68 rray..**.** With
18250 20 74 68 65 20 61 64 64 69 74 69 6f 6e 20 6f 66 the addition of
18260 20 6d 75 6c 74 69 70 6c 65 20 64 61 74 61 62 61 multiple databa
18270 73 65 20 73 75 70 70 6f 72 74 2c 20 74 68 65 20 se support, the
18280 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
18290 75 72 65 0a 2a 2a 20 63 61 6e 20 61 6c 73 6f 20 ure.** can also
182a0 62 65 20 75 73 65 64 20 74 6f 20 64 65 73 63 72 be used to descr
182b0 69 62 65 20 61 20 70 61 72 74 69 63 75 6c 61 72 ibe a particular
182c0 20 74 61 62 6c 65 20 73 75 63 68 20 61 73 20 74 table such as t
182d0 68 65 20 74 61 62 6c 65 20 74 68 61 74 0a 2a 2a he table that.**
182e0 20 69 73 20 6d 6f 64 69 66 69 65 64 20 62 79 20 is modified by
182f0 61 6e 20 49 4e 53 45 52 54 2c 20 44 45 4c 45 54 an INSERT, DELET
18300 45 2c 20 6f 72 20 55 50 44 41 54 45 20 73 74 61 E, or UPDATE sta
18310 74 65 6d 65 6e 74 2e 20 20 49 6e 20 73 74 61 6e tement. In stan
18320 64 61 72 64 20 53 51 4c 2c 0a 2a 2a 20 73 75 63 dard SQL,.** suc
18330 68 20 61 20 74 61 62 6c 65 20 6d 75 73 74 20 62 h a table must b
18340 65 20 61 20 73 69 6d 70 6c 65 20 6e 61 6d 65 3a e a simple name:
18350 20 49 44 2e 20 20 42 75 74 20 69 6e 20 53 51 4c ID. But in SQL
18360 69 74 65 2c 20 74 68 65 20 74 61 62 6c 65 20 63 ite, the table c
18370 61 6e 0a 2a 2a 20 6e 6f 77 20 62 65 20 69 64 65 an.** now be ide
18380 6e 74 69 66 69 65 64 20 62 79 20 61 20 64 61 74 ntified by a dat
18390 61 62 61 73 65 20 6e 61 6d 65 2c 20 61 20 64 6f abase name, a do
183a0 74 2c 20 74 68 65 6e 20 74 68 65 20 74 61 62 6c t, then the tabl
183b0 65 20 6e 61 6d 65 3a 20 49 44 2e 49 44 2e 0a 2a e name: ID.ID..*
183c0 2a 0a 2a 2a 20 54 68 65 20 6a 6f 69 6e 74 79 70 *.** The jointyp
183d0 65 20 73 74 61 72 74 73 20 6f 75 74 20 73 68 6f e starts out sho
183e0 77 69 6e 67 20 74 68 65 20 6a 6f 69 6e 20 74 79 wing the join ty
183f0 70 65 20 62 65 74 77 65 65 6e 20 74 68 65 20 63 pe between the c
18400 75 72 72 65 6e 74 20 74 61 62 6c 65 0a 2a 2a 20 urrent table.**
18410 61 6e 64 20 74 68 65 20 6e 65 78 74 20 74 61 62 and the next tab
18420 6c 65 20 6f 6e 20 74 68 65 20 6c 69 73 74 2e 20 le on the list.
18430 20 54 68 65 20 70 61 72 73 65 72 20 62 75 69 6c The parser buil
18440 64 73 20 74 68 65 20 6c 69 73 74 20 74 68 69 73 ds the list this
18450 20 77 61 79 2e 0a 2a 2a 20 42 75 74 20 73 71 6c way..** But sql
18460 69 74 65 33 53 72 63 4c 69 73 74 53 68 69 66 74 ite3SrcListShift
18470 4a 6f 69 6e 54 79 70 65 28 29 20 6c 61 74 65 72 JoinType() later
18480 20 73 68 69 66 74 73 20 74 68 65 20 6a 6f 69 6e shifts the join
18490 74 79 70 65 73 20 73 6f 20 74 68 61 74 20 65 61 types so that ea
184a0 63 68 0a 2a 2a 20 6a 6f 69 6e 74 79 70 65 20 65 ch.** jointype e
184b0 78 70 72 65 73 73 65 73 20 74 68 65 20 6a 6f 69 xpresses the joi
184c0 6e 20 62 65 74 77 65 65 6e 20 74 68 65 20 74 61 n between the ta
184d0 62 6c 65 20 61 6e 64 20 74 68 65 20 70 72 65 76 ble and the prev
184e0 69 6f 75 73 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a ious table..**.*
184f0 2a 20 49 6e 20 74 68 65 20 63 6f 6c 55 73 65 64 * In the colUsed
18500 20 66 69 65 6c 64 2c 20 74 68 65 20 68 69 67 68 field, the high
18510 2d 6f 72 64 65 72 20 62 69 74 20 28 62 69 74 20 -order bit (bit
18520 36 33 29 20 69 73 20 73 65 74 20 69 66 20 74 68 63) is set if th
18530 65 20 74 61 62 6c 65 0a 2a 2a 20 63 6f 6e 74 61 e table.** conta
18540 69 6e 73 20 6d 6f 72 65 20 74 68 61 6e 20 36 33 ins more than 63
18550 20 63 6f 6c 75 6d 6e 73 20 61 6e 64 20 74 68 65 columns and the
18560 20 36 34 2d 74 68 20 6f 72 20 6c 61 74 65 72 20 64-th or later
18570 63 6f 6c 75 6d 6e 20 69 73 20 75 73 65 64 2e 0a column is used..
18580 2a 2f 0a 73 74 72 75 63 74 20 53 72 63 4c 69 73 */.struct SrcLis
18590 74 20 7b 0a 20 20 69 6e 74 20 6e 53 72 63 3b 20 t {. int nSrc;
185a0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
185b0 20 6f 66 20 74 61 62 6c 65 73 20 6f 72 20 73 75 of tables or su
185c0 62 71 75 65 72 69 65 73 20 69 6e 20 74 68 65 20 bqueries in the
185d0 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 FROM clause */.
185e0 20 75 33 32 20 6e 41 6c 6c 6f 63 3b 20 20 20 20 u32 nAlloc;
185f0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 /* Number of e
18600 6e 74 72 69 65 73 20 61 6c 6c 6f 63 61 74 65 64 ntries allocated
18610 20 69 6e 20 61 5b 5d 20 62 65 6c 6f 77 20 2a 2f in a[] below */
18620 0a 20 20 73 74 72 75 63 74 20 53 72 63 4c 69 73 . struct SrcLis
18630 74 5f 69 74 65 6d 20 7b 0a 20 20 20 20 53 63 68 t_item {. Sch
18640 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 2f ema *pSchema; /
18650 2a 20 53 63 68 65 6d 61 20 74 6f 20 77 68 69 63 * Schema to whic
18660 68 20 74 68 69 73 20 69 74 65 6d 20 69 73 20 66 h this item is f
18670 69 78 65 64 20 2a 2f 0a 20 20 20 20 63 68 61 72 ixed */. char
18680 20 2a 7a 44 61 74 61 62 61 73 65 3b 20 20 2f 2a *zDatabase; /*
18690 20 4e 61 6d 65 20 6f 66 20 64 61 74 61 62 61 73 Name of databas
186a0 65 20 68 6f 6c 64 69 6e 67 20 74 68 69 73 20 74 e holding this t
186b0 61 62 6c 65 20 2a 2f 0a 20 20 20 20 63 68 61 72 able */. char
186c0 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a *zName; /*
186d0 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 Name of the tab
186e0 6c 65 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a le */. char *
186f0 7a 41 6c 69 61 73 3b 20 20 20 20 20 2f 2a 20 54 zAlias; /* T
18700 68 65 20 22 42 22 20 70 61 72 74 20 6f 66 20 61 he "B" part of a
18710 20 22 41 20 41 53 20 42 22 20 70 68 72 61 73 65 "A AS B" phrase
18720 2e 20 20 7a 4e 61 6d 65 20 69 73 20 74 68 65 20 . zName is the
18730 22 41 22 20 2a 2f 0a 20 20 20 20 54 61 62 6c 65 "A" */. Table
18740 20 2a 70 54 61 62 3b 20 20 20 20 20 20 2f 2a 20 *pTab; /*
18750 41 6e 20 53 51 4c 20 74 61 62 6c 65 20 63 6f 72 An SQL table cor
18760 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 7a 4e responding to zN
18770 61 6d 65 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 ame */. Selec
18780 74 20 2a 70 53 65 6c 65 63 74 3b 20 20 2f 2a 20 t *pSelect; /*
18790 41 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 A SELECT stateme
187a0 6e 74 20 75 73 65 64 20 69 6e 20 70 6c 61 63 65 nt used in place
187b0 20 6f 66 20 61 20 74 61 62 6c 65 20 6e 61 6d 65 of a table name
187c0 20 2a 2f 0a 20 20 20 20 69 6e 74 20 61 64 64 72 */. int addr
187d0 46 69 6c 6c 53 75 62 3b 20 20 2f 2a 20 41 64 64 FillSub; /* Add
187e0 72 65 73 73 20 6f 66 20 73 75 62 72 6f 75 74 69 ress of subrouti
187f0 6e 65 20 74 6f 20 6d 61 6e 69 66 65 73 74 20 61 ne to manifest a
18800 20 73 75 62 71 75 65 72 79 20 2a 2f 0a 20 20 20 subquery */.
18810 20 69 6e 74 20 72 65 67 52 65 74 75 72 6e 3b 20 int regReturn;
18820 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 68 /* Register h
18830 6f 6c 64 69 6e 67 20 72 65 74 75 72 6e 20 61 64 olding return ad
18840 64 72 65 73 73 20 6f 66 20 61 64 64 72 46 69 6c dress of addrFil
18850 6c 53 75 62 20 2a 2f 0a 20 20 20 20 69 6e 74 20 lSub */. int
18860 72 65 67 52 65 73 75 6c 74 3b 20 20 20 20 2f 2a regResult; /*
18870 20 52 65 67 69 73 74 65 72 73 20 68 6f 6c 64 69 Registers holdi
18880 6e 67 20 72 65 73 75 6c 74 73 20 6f 66 20 61 20 ng results of a
18890 63 6f 2d 72 6f 75 74 69 6e 65 20 2a 2f 0a 20 20 co-routine */.
188a0 20 20 73 74 72 75 63 74 20 7b 0a 20 20 20 20 20 struct {.
188b0 20 75 38 20 6a 6f 69 6e 74 79 70 65 3b 20 20 20 u8 jointype;
188c0 20 20 20 2f 2a 20 54 79 70 65 20 6f 66 20 6a 6f /* Type of jo
188d0 69 6e 20 62 65 74 77 65 65 6e 20 74 68 69 73 20 in between this
188e0 61 62 6c 65 20 61 6e 64 20 74 68 65 20 70 72 65 able and the pre
188f0 76 69 6f 75 73 20 2a 2f 0a 20 20 20 20 20 20 75 vious */. u
18900 6e 73 69 67 6e 65 64 20 6e 6f 74 49 6e 64 65 78 nsigned notIndex
18910 65 64 20 3a 31 3b 20 20 20 20 2f 2a 20 54 72 75 ed :1; /* Tru
18920 65 20 69 66 20 74 68 65 72 65 20 69 73 20 61 20 e if there is a
18930 4e 4f 54 20 49 4e 44 45 58 45 44 20 63 6c 61 75 NOT INDEXED clau
18940 73 65 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 se */. unsi
18950 67 6e 65 64 20 69 73 49 6e 64 65 78 65 64 42 79 gned isIndexedBy
18960 20 3a 31 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 :1; /* True i
18970 66 20 74 68 65 72 65 20 69 73 20 61 6e 20 49 4e f there is an IN
18980 44 45 58 45 44 20 42 59 20 63 6c 61 75 73 65 20 DEXED BY clause
18990 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65 */. unsigne
189a0 64 20 69 73 54 61 62 46 75 6e 63 20 3a 31 3b 20 d isTabFunc :1;
189b0 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 /* True if t
189c0 61 62 6c 65 2d 76 61 6c 75 65 64 2d 66 75 6e 63 able-valued-func
189d0 74 69 6f 6e 20 73 79 6e 74 61 78 20 2a 2f 0a 20 tion syntax */.
189e0 20 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 73 unsigned is
189f0 43 6f 72 72 65 6c 61 74 65 64 20 3a 31 3b 20 20 Correlated :1;
18a00 2f 2a 20 54 72 75 65 20 69 66 20 73 75 62 2d 71 /* True if sub-q
18a10 75 65 72 79 20 69 73 20 63 6f 72 72 65 6c 61 74 uery is correlat
18a20 65 64 20 2a 2f 0a 20 20 20 20 20 20 75 6e 73 69 ed */. unsi
18a30 67 6e 65 64 20 76 69 61 43 6f 72 6f 75 74 69 6e gned viaCoroutin
18a40 65 20 3a 31 3b 20 20 2f 2a 20 49 6d 70 6c 65 6d e :1; /* Implem
18a50 65 6e 74 65 64 20 61 73 20 61 20 63 6f 2d 72 6f ented as a co-ro
18a60 75 74 69 6e 65 20 2a 2f 0a 20 20 20 20 20 20 75 utine */. u
18a70 6e 73 69 67 6e 65 64 20 69 73 52 65 63 75 72 73 nsigned isRecurs
18a80 69 76 65 20 3a 31 3b 20 20 20 2f 2a 20 54 72 75 ive :1; /* Tru
18a90 65 20 66 6f 72 20 72 65 63 75 72 73 69 76 65 20 e for recursive
18aa0 72 65 66 65 72 65 6e 63 65 20 69 6e 20 57 49 54 reference in WIT
18ab0 48 20 2a 2f 0a 20 20 20 20 7d 20 66 67 3b 0a 23 H */. } fg;.#
18ac0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
18ad0 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 20 20 75 IT_EXPLAIN. u
18ae0 38 20 69 53 65 6c 65 63 74 49 64 3b 20 20 20 20 8 iSelectId;
18af0 20 2f 2a 20 49 66 20 70 53 65 6c 65 63 74 21 3d /* If pSelect!=
18b00 30 2c 20 74 68 65 20 69 64 20 6f 66 20 74 68 65 0, the id of the
18b10 20 73 75 62 2d 73 65 6c 65 63 74 20 69 6e 20 45 sub-select in E
18b20 51 50 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 20 QP */.#endif.
18b30 20 69 6e 74 20 69 43 75 72 73 6f 72 3b 20 20 20 int iCursor;
18b40 20 20 20 2f 2a 20 54 68 65 20 56 44 42 45 20 63 /* The VDBE c
18b50 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 75 73 65 ursor number use
18b60 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 69 73 d to access this
18b70 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 45 78 table */. Ex
18b80 70 72 20 2a 70 4f 6e 3b 20 20 20 20 20 20 20 20 pr *pOn;
18b90 2f 2a 20 54 68 65 20 4f 4e 20 63 6c 61 75 73 65 /* The ON clause
18ba0 20 6f 66 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 20 of a join */.
18bb0 20 20 49 64 4c 69 73 74 20 2a 70 55 73 69 6e 67 IdList *pUsing
18bc0 3b 20 20 20 2f 2a 20 54 68 65 20 55 53 49 4e 47 ; /* The USING
18bd0 20 63 6c 61 75 73 65 20 6f 66 20 61 20 6a 6f 69 clause of a joi
18be0 6e 20 2a 2f 0a 20 20 20 20 42 69 74 6d 61 73 6b n */. Bitmask
18bf0 20 63 6f 6c 55 73 65 64 3b 20 20 2f 2a 20 42 69 colUsed; /* Bi
18c00 74 20 4e 20 28 31 3c 3c 4e 29 20 73 65 74 20 69 t N (1<<N) set i
18c10 66 20 63 6f 6c 75 6d 6e 20 4e 20 6f 66 20 70 54 f column N of pT
18c20 61 62 20 69 73 20 75 73 65 64 20 2a 2f 0a 20 20 ab is used */.
18c30 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20 20 20 union {.
18c40 63 68 61 72 20 2a 7a 49 6e 64 65 78 65 64 42 79 char *zIndexedBy
18c50 3b 20 20 20 20 2f 2a 20 49 64 65 6e 74 69 66 69 ; /* Identifi
18c60 65 72 20 66 72 6f 6d 20 22 49 4e 44 45 58 45 44 er from "INDEXED
18c70 20 42 59 20 3c 7a 49 6e 64 65 78 3e 22 20 63 6c BY <zIndex>" cl
18c80 61 75 73 65 20 2a 2f 0a 20 20 20 20 20 20 45 78 ause */. Ex
18c90 70 72 4c 69 73 74 20 2a 70 46 75 6e 63 41 72 67 prList *pFuncArg
18ca0 3b 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 73 20 ; /* Arguments
18cb0 74 6f 20 74 61 62 6c 65 2d 76 61 6c 75 65 64 2d to table-valued-
18cc0 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 function */.
18cd0 7d 20 75 31 3b 0a 20 20 20 20 49 6e 64 65 78 20 } u1;. Index
18ce0 2a 70 49 42 49 6e 64 65 78 3b 20 20 2f 2a 20 49 *pIBIndex; /* I
18cf0 6e 64 65 78 20 73 74 72 75 63 74 75 72 65 20 63 ndex structure c
18d00 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 orresponding to
18d10 75 31 2e 7a 49 6e 64 65 78 65 64 42 79 20 2a 2f u1.zIndexedBy */
18d20 0a 20 20 7d 20 61 5b 31 5d 3b 20 20 20 20 20 20 . } a[1];
18d30 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e /* One en
18d40 74 72 79 20 66 6f 72 20 65 61 63 68 20 69 64 65 try for each ide
18d50 6e 74 69 66 69 65 72 20 6f 6e 20 74 68 65 20 6c ntifier on the l
18d60 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ist */.};../*.**
18d70 20 50 65 72 6d 69 74 74 65 64 20 76 61 6c 75 65 Permitted value
18d80 73 20 6f 66 20 74 68 65 20 53 72 63 4c 69 73 74 s of the SrcList
18d90 2e 61 2e 6a 6f 69 6e 74 79 70 65 20 66 69 65 6c .a.jointype fiel
18da0 64 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f d.*/.#define JT_
18db0 49 4e 4e 45 52 20 20 20 20 20 30 78 30 30 30 31 INNER 0x0001
18dc0 20 20 20 20 2f 2a 20 41 6e 79 20 6b 69 6e 64 20 /* Any kind
18dd0 6f 66 20 69 6e 6e 65 72 20 6f 72 20 63 72 6f 73 of inner or cros
18de0 73 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e s join */.#defin
18df0 65 20 4a 54 5f 43 52 4f 53 53 20 20 20 20 20 30 e JT_CROSS 0
18e00 78 30 30 30 32 20 20 20 20 2f 2a 20 45 78 70 6c x0002 /* Expl
18e10 69 63 69 74 20 75 73 65 20 6f 66 20 74 68 65 20 icit use of the
18e20 43 52 4f 53 53 20 6b 65 79 77 6f 72 64 20 2a 2f CROSS keyword */
18e30 0a 23 64 65 66 69 6e 65 20 4a 54 5f 4e 41 54 55 .#define JT_NATU
18e40 52 41 4c 20 20 20 30 78 30 30 30 34 20 20 20 20 RAL 0x0004
18e50 2f 2a 20 54 72 75 65 20 66 6f 72 20 61 20 22 6e /* True for a "n
18e60 61 74 75 72 61 6c 22 20 6a 6f 69 6e 20 2a 2f 0a atural" join */.
18e70 23 64 65 66 69 6e 65 20 4a 54 5f 4c 45 46 54 20 #define JT_LEFT
18e80 20 20 20 20 20 30 78 30 30 30 38 20 20 20 20 2f 0x0008 /
18e90 2a 20 4c 65 66 74 20 6f 75 74 65 72 20 6a 6f 69 * Left outer joi
18ea0 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f n */.#define JT_
18eb0 52 49 47 48 54 20 20 20 20 20 30 78 30 30 31 30 RIGHT 0x0010
18ec0 20 20 20 20 2f 2a 20 52 69 67 68 74 20 6f 75 74 /* Right out
18ed0 65 72 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 er join */.#defi
18ee0 6e 65 20 4a 54 5f 4f 55 54 45 52 20 20 20 20 20 ne JT_OUTER
18ef0 30 78 30 30 32 30 20 20 20 20 2f 2a 20 54 68 65 0x0020 /* The
18f00 20 22 4f 55 54 45 52 22 20 6b 65 79 77 6f 72 64 "OUTER" keyword
18f10 20 69 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 23 is present */.#
18f20 64 65 66 69 6e 65 20 4a 54 5f 45 52 52 4f 52 20 define JT_ERROR
18f30 20 20 20 20 30 78 30 30 34 30 20 20 20 20 2f 2a 0x0040 /*
18f40 20 75 6e 6b 6e 6f 77 6e 20 6f 72 20 75 6e 73 75 unknown or unsu
18f50 70 70 6f 72 74 65 64 20 6a 6f 69 6e 20 74 79 70 pported join typ
18f60 65 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6c 61 e */.../*.** Fla
18f70 67 73 20 61 70 70 72 6f 70 72 69 61 74 65 20 66 gs appropriate f
18f80 6f 72 20 74 68 65 20 77 63 74 72 6c 46 6c 61 67 or the wctrlFlag
18f90 73 20 70 61 72 61 6d 65 74 65 72 20 6f 66 20 73 s parameter of s
18fa0 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 69 6e qlite3WhereBegin
18fb0 28 29 0a 2a 2a 20 61 6e 64 20 74 68 65 20 57 68 ().** and the Wh
18fc0 65 72 65 49 6e 66 6f 2e 77 63 74 72 6c 46 6c 61 ereInfo.wctrlFla
18fd0 67 73 20 6d 65 6d 62 65 72 2e 0a 2a 2f 0a 23 64 gs member..*/.#d
18fe0 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 45 efine WHERE_ORDE
18ff0 52 42 59 5f 4e 4f 52 4d 41 4c 20 20 20 30 78 30 RBY_NORMAL 0x0
19000 30 30 30 20 2f 2a 20 4e 6f 2d 6f 70 20 2a 2f 0a 000 /* No-op */.
19010 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 #define WHERE_OR
19020 44 45 52 42 59 5f 4d 49 4e 20 20 20 20 20 20 30 DERBY_MIN 0
19030 78 30 30 30 31 20 2f 2a 20 4f 52 44 45 52 20 42 x0001 /* ORDER B
19040 59 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 Y processing for
19050 20 6d 69 6e 28 29 20 66 75 6e 63 20 2a 2f 0a 23 min() func */.#
19060 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 define WHERE_ORD
19070 45 52 42 59 5f 4d 41 58 20 20 20 20 20 20 30 78 ERBY_MAX 0x
19080 30 30 30 32 20 2f 2a 20 4f 52 44 45 52 20 42 59 0002 /* ORDER BY
19090 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 processing for
190a0 6d 61 78 28 29 20 66 75 6e 63 20 2a 2f 0a 23 64 max() func */.#d
190b0 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e 45 50 efine WHERE_ONEP
190c0 41 53 53 5f 44 45 53 49 52 45 44 20 20 30 78 30 ASS_DESIRED 0x0
190d0 30 30 34 20 2f 2a 20 57 61 6e 74 20 74 6f 20 64 004 /* Want to d
190e0 6f 20 6f 6e 65 2d 70 61 73 73 20 55 50 44 41 54 o one-pass UPDAT
190f0 45 2f 44 45 4c 45 54 45 20 2a 2f 0a 23 64 65 66 E/DELETE */.#def
19100 69 6e 65 20 57 48 45 52 45 5f 44 55 50 4c 49 43 ine WHERE_DUPLIC
19110 41 54 45 53 5f 4f 4b 20 20 20 20 30 78 30 30 30 ATES_OK 0x000
19120 38 20 2f 2a 20 4f 6b 20 74 6f 20 72 65 74 75 72 8 /* Ok to retur
19130 6e 20 61 20 72 6f 77 20 6d 6f 72 65 20 74 68 61 n a row more tha
19140 6e 20 6f 6e 63 65 20 2a 2f 0a 23 64 65 66 69 6e n once */.#defin
19150 65 20 57 48 45 52 45 5f 4f 4d 49 54 5f 4f 50 45 e WHERE_OMIT_OPE
19160 4e 5f 43 4c 4f 53 45 20 20 30 78 30 30 31 30 20 N_CLOSE 0x0010
19170 2f 2a 20 54 61 62 6c 65 20 63 75 72 73 6f 72 73 /* Table cursors
19180 20 61 72 65 20 61 6c 72 65 61 64 79 20 6f 70 65 are already ope
19190 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 n */.#define WHE
191a0 52 45 5f 46 4f 52 43 45 5f 54 41 42 4c 45 20 20 RE_FORCE_TABLE
191b0 20 20 20 20 30 78 30 30 32 30 20 2f 2a 20 44 6f 0x0020 /* Do
191c0 20 6e 6f 74 20 75 73 65 20 61 6e 20 69 6e 64 65 not use an inde
191d0 78 2d 6f 6e 6c 79 20 73 65 61 72 63 68 20 2a 2f x-only search */
191e0 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f .#define WHERE_O
191f0 4e 45 54 41 42 4c 45 5f 4f 4e 4c 59 20 20 20 20 NETABLE_ONLY
19200 30 78 30 30 34 30 20 2f 2a 20 4f 6e 6c 79 20 63 0x0040 /* Only c
19210 6f 64 65 20 74 68 65 20 31 73 74 20 74 61 62 6c ode the 1st tabl
19220 65 20 69 6e 20 70 54 61 62 4c 69 73 74 20 2a 2f e in pTabList */
19230 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4e .#define WHERE_N
19240 4f 5f 41 55 54 4f 49 4e 44 45 58 20 20 20 20 20 O_AUTOINDEX
19250 30 78 30 30 38 30 20 2f 2a 20 44 69 73 61 6c 6c 0x0080 /* Disall
19260 6f 77 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 ow automatic ind
19270 65 78 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 exes */.#define
19280 57 48 45 52 45 5f 47 52 4f 55 50 42 59 20 20 20 WHERE_GROUPBY
19290 20 20 20 20 20 20 20 30 78 30 31 30 30 20 2f 2a 0x0100 /*
192a0 20 70 4f 72 64 65 72 42 79 20 69 73 20 72 65 61 pOrderBy is rea
192b0 6c 6c 79 20 61 20 47 52 4f 55 50 20 42 59 20 2a lly a GROUP BY *
192c0 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
192d0 44 49 53 54 49 4e 43 54 42 59 20 20 20 20 20 20 DISTINCTBY
192e0 20 30 78 30 32 30 30 20 2f 2a 20 70 4f 72 64 65 0x0200 /* pOrde
192f0 72 62 79 20 69 73 20 72 65 61 6c 6c 79 20 61 20 rby is really a
19300 44 49 53 54 49 4e 43 54 20 63 6c 61 75 73 65 20 DISTINCT clause
19310 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 */.#define WHERE
19320 5f 57 41 4e 54 5f 44 49 53 54 49 4e 43 54 20 20 _WANT_DISTINCT
19330 20 20 30 78 30 34 30 30 20 2f 2a 20 41 6c 6c 20 0x0400 /* All
19340 6f 75 74 70 75 74 20 6e 65 65 64 73 20 74 6f 20 output needs to
19350 62 65 20 64 69 73 74 69 6e 63 74 20 2a 2f 0a 23 be distinct */.#
19360 64 65 66 69 6e 65 20 57 48 45 52 45 5f 53 4f 52 define WHERE_SOR
19370 54 42 59 47 52 4f 55 50 20 20 20 20 20 20 30 78 TBYGROUP 0x
19380 30 38 30 30 20 2f 2a 20 53 75 70 70 6f 72 74 20 0800 /* Support
19390 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 53 6f sqlite3WhereIsSo
193a0 72 74 65 64 28 29 20 2a 2f 0a 23 64 65 66 69 6e rted() */.#defin
193b0 65 20 57 48 45 52 45 5f 52 45 4f 50 45 4e 5f 49 e WHERE_REOPEN_I
193c0 44 58 20 20 20 20 20 20 20 30 78 31 30 30 30 20 DX 0x1000
193d0 2f 2a 20 54 72 79 20 74 6f 20 75 73 65 20 4f 50 /* Try to use OP
193e0 5f 52 65 6f 70 65 6e 49 64 78 20 2a 2f 0a 23 64 _ReopenIdx */.#d
193f0 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e 45 50 efine WHERE_ONEP
19400 41 53 53 5f 4d 55 4c 54 49 52 4f 57 20 30 78 32 ASS_MULTIROW 0x2
19410 30 30 30 20 2f 2a 20 4f 4e 45 50 41 53 53 20 69 000 /* ONEPASS i
19420 73 20 6f 6b 20 77 69 74 68 20 6d 75 6c 74 69 70 s ok with multip
19430 6c 65 20 72 6f 77 73 20 2a 2f 0a 0a 2f 2a 20 41 le rows */../* A
19440 6c 6c 6f 77 65 64 20 72 65 74 75 72 6e 20 76 61 llowed return va
19450 6c 75 65 73 20 66 72 6f 6d 20 73 71 6c 69 74 65 lues from sqlite
19460 33 57 68 65 72 65 49 73 44 69 73 74 69 6e 63 74 3WhereIsDistinct
19470 28 29 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 ().*/.#define WH
19480 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 4e 4f 4f ERE_DISTINCT_NOO
19490 50 20 20 20 20 20 20 30 20 20 2f 2a 20 44 49 53 P 0 /* DIS
194a0 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 20 6e 6f TINCT keyword no
194b0 74 20 75 73 65 64 20 2a 2f 0a 23 64 65 66 69 6e t used */.#defin
194c0 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 e WHERE_DISTINCT
194d0 5f 55 4e 49 51 55 45 20 20 20 20 31 20 20 2f 2a _UNIQUE 1 /*
194e0 20 4e 6f 20 64 75 70 6c 69 63 61 74 65 73 20 2a No duplicates *
194f0 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
19500 44 49 53 54 49 4e 43 54 5f 4f 52 44 45 52 45 44 DISTINCT_ORDERED
19510 20 20 20 32 20 20 2f 2a 20 41 6c 6c 20 64 75 70 2 /* All dup
19520 6c 69 63 61 74 65 73 20 61 72 65 20 61 64 6a 61 licates are adja
19530 63 65 6e 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 cent */.#define
19540 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 55 WHERE_DISTINCT_U
19550 4e 4f 52 44 45 52 45 44 20 33 20 20 2f 2a 20 44 NORDERED 3 /* D
19560 75 70 6c 69 63 61 74 65 73 20 61 72 65 20 73 63 uplicates are sc
19570 61 74 74 65 72 65 64 20 2a 2f 0a 0a 2f 2a 0a 2a attered */../*.*
19580 2a 20 41 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 * A NameContext
19590 64 65 66 69 6e 65 73 20 61 20 63 6f 6e 74 65 78 defines a contex
195a0 74 20 69 6e 20 77 68 69 63 68 20 74 6f 20 72 65 t in which to re
195b0 73 6f 6c 76 65 20 74 61 62 6c 65 20 61 6e 64 20 solve table and
195c0 63 6f 6c 75 6d 6e 0a 2a 2a 20 6e 61 6d 65 73 2e column.** names.
195d0 20 20 54 68 65 20 63 6f 6e 74 65 78 74 20 63 6f The context co
195e0 6e 73 69 73 74 73 20 6f 66 20 61 20 6c 69 73 74 nsists of a list
195f0 20 6f 66 20 74 61 62 6c 65 73 20 28 74 68 65 20 of tables (the
19600 70 53 72 63 4c 69 73 74 29 20 66 69 65 6c 64 20 pSrcList) field
19610 61 6e 64 0a 2a 2a 20 61 20 6c 69 73 74 20 6f 66 and.** a list of
19620 20 6e 61 6d 65 64 20 65 78 70 72 65 73 73 69 6f named expressio
19630 6e 20 28 70 45 4c 69 73 74 29 2e 20 20 54 68 65 n (pEList). The
19640 20 6e 61 6d 65 64 20 65 78 70 72 65 73 73 69 6f named expressio
19650 6e 20 6c 69 73 74 20 6d 61 79 0a 2a 2a 20 62 65 n list may.** be
19660 20 4e 55 4c 4c 2e 20 20 54 68 65 20 70 53 72 63 NULL. The pSrc
19670 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 corresponds to
19680 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 the FROM clause
19690 6f 66 20 61 20 53 45 4c 45 43 54 20 6f 72 0a 2a of a SELECT or.*
196a0 2a 20 74 6f 20 74 68 65 20 74 61 62 6c 65 20 62 * to the table b
196b0 65 69 6e 67 20 6f 70 65 72 61 74 65 64 20 6f 6e eing operated on
196c0 20 62 79 20 49 4e 53 45 52 54 2c 20 55 50 44 41 by INSERT, UPDA
196d0 54 45 2c 20 6f 72 20 44 45 4c 45 54 45 2e 20 20 TE, or DELETE.
196e0 54 68 65 0a 2a 2a 20 70 45 4c 69 73 74 20 63 6f The.** pEList co
196f0 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 rresponds to the
19700 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66 20 61 result set of a
19710 20 53 45 4c 45 43 54 20 61 6e 64 20 69 73 20 4e SELECT and is N
19720 55 4c 4c 20 66 6f 72 0a 2a 2a 20 6f 74 68 65 72 ULL for.** other
19730 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a statements..**.
19740 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 74 73 20 ** NameContexts
19750 63 61 6e 20 62 65 20 6e 65 73 74 65 64 2e 20 20 can be nested.
19760 57 68 65 6e 20 72 65 73 6f 6c 76 69 6e 67 20 6e When resolving n
19770 61 6d 65 73 2c 20 74 68 65 20 69 6e 6e 65 72 2d ames, the inner-
19780 6d 6f 73 74 0a 2a 2a 20 63 6f 6e 74 65 78 74 20 most.** context
19790 69 73 20 73 65 61 72 63 68 65 64 20 66 69 72 73 is searched firs
197a0 74 2e 20 20 49 66 20 6e 6f 20 6d 61 74 63 68 20 t. If no match
197b0 69 73 20 66 6f 75 6e 64 2c 20 74 68 65 20 6e 65 is found, the ne
197c0 78 74 20 6f 75 74 65 72 0a 2a 2a 20 63 6f 6e 74 xt outer.** cont
197d0 65 78 74 20 69 73 20 63 68 65 63 6b 65 64 2e 20 ext is checked.
197e0 20 49 66 20 74 68 65 72 65 20 69 73 20 73 74 69 If there is sti
197f0 6c 6c 20 6e 6f 20 6d 61 74 63 68 2c 20 74 68 65 ll no match, the
19800 20 6e 65 78 74 20 63 6f 6e 74 65 78 74 0a 2a 2a next context.**
19810 20 69 73 20 63 68 65 63 6b 65 64 2e 20 20 54 68 is checked. Th
19820 69 73 20 70 72 6f 63 65 73 73 20 63 6f 6e 74 69 is process conti
19830 6e 75 65 73 20 75 6e 74 69 6c 20 65 69 74 68 65 nues until eithe
19840 72 20 61 20 6d 61 74 63 68 20 69 73 20 66 6f 75 r a match is fou
19850 6e 64 0a 2a 2a 20 6f 72 20 61 6c 6c 20 63 6f 6e nd.** or all con
19860 74 65 78 74 73 20 61 72 65 20 63 68 65 63 6b 2e texts are check.
19870 20 20 57 68 65 6e 20 61 20 6d 61 74 63 68 20 69 When a match i
19880 73 20 66 6f 75 6e 64 2c 20 74 68 65 20 6e 52 65 s found, the nRe
19890 66 20 6d 65 6d 62 65 72 20 6f 66 0a 2a 2a 20 74 f member of.** t
198a0 68 65 20 63 6f 6e 74 65 78 74 20 63 6f 6e 74 61 he context conta
198b0 69 6e 69 6e 67 20 74 68 65 20 6d 61 74 63 68 20 ining the match
198c0 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 2e 0a is incremented..
198d0 2a 2a 0a 2a 2a 20 45 61 63 68 20 73 75 62 71 75 **.** Each subqu
198e0 65 72 79 20 67 65 74 73 20 61 20 6e 65 77 20 4e ery gets a new N
198f0 61 6d 65 43 6f 6e 74 65 78 74 2e 20 20 54 68 65 ameContext. The
19900 20 70 4e 65 78 74 20 66 69 65 6c 64 20 70 6f 69 pNext field poi
19910 6e 74 73 20 74 6f 20 74 68 65 0a 2a 2a 20 4e 61 nts to the.** Na
19920 6d 65 43 6f 6e 74 65 78 74 20 69 6e 20 74 68 65 meContext in the
19930 20 70 61 72 65 6e 74 20 71 75 65 72 79 2e 20 20 parent query.
19940 54 68 75 73 20 74 68 65 20 70 72 6f 63 65 73 73 Thus the process
19950 20 6f 66 20 73 63 61 6e 6e 69 6e 67 20 74 68 65 of scanning the
19960 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 .** NameContext
19970 6c 69 73 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 list corresponds
19980 20 74 6f 20 73 65 61 72 63 68 69 6e 67 20 74 68 to searching th
19990 72 6f 75 67 68 20 73 75 63 63 65 73 73 69 76 65 rough successive
199a0 6c 79 20 6f 75 74 65 72 0a 2a 2a 20 73 75 62 71 ly outer.** subq
199b0 75 65 72 69 65 73 20 6c 6f 6f 6b 69 6e 67 20 66 ueries looking f
199c0 6f 72 20 61 20 6d 61 74 63 68 2e 0a 2a 2f 0a 73 or a match..*/.s
199d0 74 72 75 63 74 20 4e 61 6d 65 43 6f 6e 74 65 78 truct NameContex
199e0 74 20 7b 0a 20 20 50 61 72 73 65 20 2a 70 50 61 t {. Parse *pPa
199f0 72 73 65 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 rse; /* Th
19a00 65 20 70 61 72 73 65 72 20 2a 2f 0a 20 20 53 72 e parser */. Sr
19a10 63 4c 69 73 74 20 2a 70 53 72 63 4c 69 73 74 3b cList *pSrcList;
19a20 20 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 /* One or mor
19a30 65 20 74 61 62 6c 65 73 20 75 73 65 64 20 74 6f e tables used to
19a40 20 72 65 73 6f 6c 76 65 20 6e 61 6d 65 73 20 2a resolve names *
19a50 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 45 /. ExprList *pE
19a60 4c 69 73 74 3b 20 20 20 20 2f 2a 20 4f 70 74 69 List; /* Opti
19a70 6f 6e 61 6c 20 6c 69 73 74 20 6f 66 20 72 65 73 onal list of res
19a80 75 6c 74 2d 73 65 74 20 63 6f 6c 75 6d 6e 73 20 ult-set columns
19a90 2a 2f 0a 20 20 41 67 67 49 6e 66 6f 20 2a 70 41 */. AggInfo *pA
19aa0 67 67 49 6e 66 6f 3b 20 20 20 2f 2a 20 49 6e 66 ggInfo; /* Inf
19ab0 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 ormation about a
19ac0 67 67 72 65 67 61 74 65 73 20 61 74 20 74 68 69 ggregates at thi
19ad0 73 20 6c 65 76 65 6c 20 2a 2f 0a 20 20 4e 61 6d s level */. Nam
19ae0 65 43 6f 6e 74 65 78 74 20 2a 70 4e 65 78 74 3b eContext *pNext;
19af0 20 20 2f 2a 20 4e 65 78 74 20 6f 75 74 65 72 20 /* Next outer
19b00 6e 61 6d 65 20 63 6f 6e 74 65 78 74 2e 20 20 4e name context. N
19b10 55 4c 4c 20 66 6f 72 20 6f 75 74 65 72 6d 6f 73 ULL for outermos
19b20 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 66 3b t */. int nRef;
19b30 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
19b40 75 6d 62 65 72 20 6f 66 20 6e 61 6d 65 73 20 72 umber of names r
19b50 65 73 6f 6c 76 65 64 20 62 79 20 74 68 69 73 20 esolved by this
19b60 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 context */. int
19b70 20 6e 45 72 72 3b 20 20 20 20 20 20 20 20 20 20 nErr;
19b80 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 /* Number of e
19b90 72 72 6f 72 73 20 65 6e 63 6f 75 6e 74 65 72 65 rrors encountere
19ba0 64 20 77 68 69 6c 65 20 72 65 73 6f 6c 76 69 6e d while resolvin
19bb0 67 20 6e 61 6d 65 73 20 2a 2f 0a 20 20 75 31 36 g names */. u16
19bc0 20 6e 63 46 6c 61 67 73 3b 20 20 20 20 20 20 20 ncFlags;
19bd0 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 /* Zero or mor
19be0 65 20 4e 43 5f 2a 20 66 6c 61 67 73 20 64 65 66 e NC_* flags def
19bf0 69 6e 65 64 20 62 65 6c 6f 77 20 2a 2f 0a 7d 3b ined below */.};
19c00 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 64 20 ../*.** Allowed
19c10 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 4e values for the N
19c20 61 6d 65 43 6f 6e 74 65 78 74 2c 20 6e 63 46 6c ameContext, ncFl
19c30 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a ags field..**.**
19c40 20 4e 6f 74 65 3a 20 20 4e 43 5f 4d 69 6e 4d 61 Note: NC_MinMa
19c50 78 41 67 67 20 6d 75 73 74 20 68 61 76 65 20 74 xAgg must have t
19c60 68 65 20 73 61 6d 65 20 76 61 6c 75 65 20 61 73 he same value as
19c70 20 53 46 5f 4d 69 6e 4d 61 78 41 67 67 20 61 6e SF_MinMaxAgg an
19c80 64 0a 2a 2a 20 53 51 4c 49 54 45 5f 46 55 4e 43 d.** SQLITE_FUNC
19c90 5f 4d 49 4e 4d 41 58 2e 0a 2a 2a 0a 2a 2f 0a 23 _MINMAX..**.*/.#
19ca0 64 65 66 69 6e 65 20 4e 43 5f 41 6c 6c 6f 77 41 define NC_AllowA
19cb0 67 67 20 20 30 78 30 30 30 31 20 20 2f 2a 20 41 gg 0x0001 /* A
19cc0 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f ggregate functio
19cd0 6e 73 20 61 72 65 20 61 6c 6c 6f 77 65 64 20 68 ns are allowed h
19ce0 65 72 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e ere */.#define N
19cf0 43 5f 48 61 73 41 67 67 20 20 20 20 30 78 30 30 C_HasAgg 0x00
19d00 30 32 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 02 /* One or mo
19d10 72 65 20 61 67 67 72 65 67 61 74 65 20 66 75 6e re aggregate fun
19d20 63 74 69 6f 6e 73 20 73 65 65 6e 20 2a 2f 0a 23 ctions seen */.#
19d30 64 65 66 69 6e 65 20 4e 43 5f 49 73 43 68 65 63 define NC_IsChec
19d40 6b 20 20 20 30 78 30 30 30 34 20 20 2f 2a 20 54 k 0x0004 /* T
19d50 72 75 65 20 69 66 20 72 65 73 6f 6c 76 69 6e 67 rue if resolving
19d60 20 6e 61 6d 65 73 20 69 6e 20 61 20 43 48 45 43 names in a CHEC
19d70 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a K constraint */.
19d80 23 64 65 66 69 6e 65 20 4e 43 5f 49 6e 41 67 67 #define NC_InAgg
19d90 46 75 6e 63 20 30 78 30 30 30 38 20 20 2f 2a 20 Func 0x0008 /*
19da0 54 72 75 65 20 69 66 20 61 6e 61 6c 79 7a 69 6e True if analyzin
19db0 67 20 61 72 67 75 6d 65 6e 74 73 20 74 6f 20 61 g arguments to a
19dc0 6e 20 61 67 67 20 66 75 6e 63 20 2a 2f 0a 23 64 n agg func */.#d
19dd0 65 66 69 6e 65 20 4e 43 5f 50 61 72 74 49 64 78 efine NC_PartIdx
19de0 20 20 20 30 78 30 30 31 30 20 20 2f 2a 20 54 72 0x0010 /* Tr
19df0 75 65 20 69 66 20 72 65 73 6f 6c 76 69 6e 67 20 ue if resolving
19e00 61 20 70 61 72 74 69 61 6c 20 69 6e 64 65 78 20 a partial index
19e10 57 48 45 52 45 20 2a 2f 0a 23 64 65 66 69 6e 65 WHERE */.#define
19e20 20 4e 43 5f 49 64 78 45 78 70 72 20 20 20 30 78 NC_IdxExpr 0x
19e30 30 30 32 30 20 20 2f 2a 20 54 72 75 65 20 69 66 0020 /* True if
19e40 20 72 65 73 6f 6c 76 69 6e 67 20 63 6f 6c 75 6d resolving colum
19e50 6e 73 20 6f 66 20 43 52 45 41 54 45 20 49 4e 44 ns of CREATE IND
19e60 45 58 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 EX */.#define NC
19e70 5f 4d 69 6e 4d 61 78 41 67 67 20 30 78 31 30 30 _MinMaxAgg 0x100
19e80 30 20 20 2f 2a 20 6d 69 6e 2f 6d 61 78 20 61 67 0 /* min/max ag
19e90 67 72 65 67 61 74 65 73 20 73 65 65 6e 2e 20 20 gregates seen.
19ea0 53 65 65 20 6e 6f 74 65 20 61 62 6f 76 65 20 2a See note above *
19eb0 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 /../*.** An inst
19ec0 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
19ed0 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
19ee0 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 69 6e 66 contains all inf
19ef0 6f 72 6d 61 74 69 6f 6e 0a 2a 2a 20 6e 65 65 64 ormation.** need
19f00 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 63 ed to generate c
19f10 6f 64 65 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 ode for a single
19f20 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
19f30 74 2e 0a 2a 2a 0a 2a 2a 20 6e 4c 69 6d 69 74 20 t..**.** nLimit
19f40 69 73 20 73 65 74 20 74 6f 20 2d 31 20 69 66 20 is set to -1 if
19f50 74 68 65 72 65 20 69 73 20 6e 6f 20 4c 49 4d 49 there is no LIMI
19f60 54 20 63 6c 61 75 73 65 2e 20 20 6e 4f 66 66 73 T clause. nOffs
19f70 65 74 20 69 73 20 73 65 74 20 74 6f 20 30 2e 0a et is set to 0..
19f80 2a 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 61 ** If there is a
19f90 20 4c 49 4d 49 54 20 63 6c 61 75 73 65 2c 20 74 LIMIT clause, t
19fa0 68 65 20 70 61 72 73 65 72 20 73 65 74 73 20 6e he parser sets n
19fb0 4c 69 6d 69 74 20 74 6f 20 74 68 65 20 76 61 6c Limit to the val
19fc0 75 65 20 6f 66 20 74 68 65 0a 2a 2a 20 6c 69 6d ue of the.** lim
19fd0 69 74 20 61 6e 64 20 6e 4f 66 66 73 65 74 20 74 it and nOffset t
19fe0 6f 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 o the value of t
19ff0 68 65 20 6f 66 66 73 65 74 20 28 6f 72 20 30 20 he offset (or 0
1a000 69 66 20 74 68 65 72 65 20 69 73 20 6e 6f 74 0a if there is not.
1a010 2a 2a 20 6f 66 66 73 65 74 29 2e 20 20 42 75 74 ** offset). But
1a020 20 6c 61 74 65 72 20 6f 6e 2c 20 6e 4c 69 6d 69 later on, nLimi
1a030 74 20 61 6e 64 20 6e 4f 66 66 73 65 74 20 62 65 t and nOffset be
1a040 63 6f 6d 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 come the memory
1a050 6c 6f 63 61 74 69 6f 6e 73 0a 2a 2a 20 69 6e 20 locations.** in
1a060 74 68 65 20 56 44 42 45 20 74 68 61 74 20 72 65 the VDBE that re
1a070 63 6f 72 64 20 74 68 65 20 6c 69 6d 69 74 20 61 cord the limit a
1a080 6e 64 20 6f 66 66 73 65 74 20 63 6f 75 6e 74 65 nd offset counte
1a090 72 73 2e 0a 2a 2a 0a 2a 2a 20 61 64 64 72 4f 70 rs..**.** addrOp
1a0a0 65 6e 45 70 68 6d 5b 5d 20 65 6e 74 72 69 65 73 enEphm[] entries
1a0b0 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 61 64 64 contain the add
1a0c0 72 65 73 73 20 6f 66 20 4f 50 5f 4f 70 65 6e 45 ress of OP_OpenE
1a0d0 70 68 65 6d 65 72 61 6c 20 6f 70 63 6f 64 65 73 phemeral opcodes
1a0e0 2e 0a 2a 2a 20 54 68 65 73 65 20 61 64 64 72 65 ..** These addre
1a0f0 73 73 65 73 20 6d 75 73 74 20 62 65 20 73 74 6f sses must be sto
1a100 72 65 64 20 73 6f 20 74 68 61 74 20 77 65 20 63 red so that we c
1a110 61 6e 20 67 6f 20 62 61 63 6b 20 61 6e 64 20 66 an go back and f
1a120 69 6c 6c 20 69 6e 0a 2a 2a 20 74 68 65 20 50 34 ill in.** the P4
1a130 5f 4b 45 59 49 4e 46 4f 20 61 6e 64 20 50 32 20 _KEYINFO and P2
1a140 70 61 72 61 6d 65 74 65 72 73 20 6c 61 74 65 72 parameters later
1a150 2e 20 20 4e 65 69 74 68 65 72 20 74 68 65 20 4b . Neither the K
1a160 65 79 49 6e 66 6f 20 6e 6f 72 0a 2a 2a 20 74 68 eyInfo nor.** th
1a170 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 e number of colu
1a180 6d 6e 73 20 69 6e 20 50 32 20 63 61 6e 20 62 65 mns in P2 can be
1a190 20 63 6f 6d 70 75 74 65 64 20 61 74 20 74 68 65 computed at the
1a1a0 20 73 61 6d 65 20 74 69 6d 65 0a 2a 2a 20 61 73 same time.** as
1a1b0 20 74 68 65 20 4f 50 5f 4f 70 65 6e 45 70 68 6d the OP_OpenEphm
1a1c0 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73 20 instruction is
1a1d0 63 6f 64 65 64 20 62 65 63 61 75 73 65 20 6e 6f coded because no
1a1e0 74 0a 2a 2a 20 65 6e 6f 75 67 68 20 69 6e 66 6f t.** enough info
1a1f0 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 rmation about th
1a200 65 20 63 6f 6d 70 6f 75 6e 64 20 71 75 65 72 79 e compound query
1a210 20 69 73 20 6b 6e 6f 77 6e 20 61 74 20 74 68 61 is known at tha
1a220 74 20 70 6f 69 6e 74 2e 0a 2a 2a 20 54 68 65 20 t point..** The
1a230 4b 65 79 49 6e 66 6f 20 66 6f 72 20 61 64 64 72 KeyInfo for addr
1a240 4f 70 65 6e 54 72 61 6e 5b 30 5d 20 61 6e 64 20 OpenTran[0] and
1a250 5b 31 5d 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6c [1] contains col
1a260 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 73 lating sequences
1a270 0a 2a 2a 20 66 6f 72 20 74 68 65 20 72 65 73 75 .** for the resu
1a280 6c 74 20 73 65 74 2e 20 20 54 68 65 20 4b 65 79 lt set. The Key
1a290 49 6e 66 6f 20 66 6f 72 20 61 64 64 72 4f 70 65 Info for addrOpe
1a2a0 6e 45 70 68 6d 5b 32 5d 20 63 6f 6e 74 61 69 6e nEphm[2] contain
1a2b0 73 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73 s collating.** s
1a2c0 65 71 75 65 6e 63 65 73 20 66 6f 72 20 74 68 65 equences for the
1a2d0 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 ORDER BY clause
1a2e0 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 65 6c 65 ..*/.struct Sele
1a2f0 63 74 20 7b 0a 20 20 45 78 70 72 4c 69 73 74 20 ct {. ExprList
1a300 2a 70 45 4c 69 73 74 3b 20 20 20 20 20 20 2f 2a *pEList; /*
1a310 20 54 68 65 20 66 69 65 6c 64 73 20 6f 66 20 74 The fields of t
1a320 68 65 20 72 65 73 75 6c 74 20 2a 2f 0a 20 20 75 he result */. u
1a330 38 20 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 8 op;
1a340 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 3a /* One of:
1a350 20 54 4b 5f 55 4e 49 4f 4e 20 54 4b 5f 41 4c 4c TK_UNION TK_ALL
1a360 20 54 4b 5f 49 4e 54 45 52 53 45 43 54 20 54 4b TK_INTERSECT TK
1a370 5f 45 58 43 45 50 54 20 2a 2f 0a 20 20 75 31 36 _EXCEPT */. u16
1a380 20 73 65 6c 46 6c 61 67 73 3b 20 20 20 20 20 20 selFlags;
1a390 20 20 20 20 2f 2a 20 56 61 72 69 6f 75 73 20 53 /* Various S
1a3a0 46 5f 2a 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 F_* values */.
1a3b0 69 6e 74 20 69 4c 69 6d 69 74 2c 20 69 4f 66 66 int iLimit, iOff
1a3c0 73 65 74 3b 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 set; /* Memory
1a3d0 20 72 65 67 69 73 74 65 72 73 20 68 6f 6c 64 69 registers holdi
1a3e0 6e 67 20 4c 49 4d 49 54 20 26 20 4f 46 46 53 45 ng LIMIT & OFFSE
1a3f0 54 20 63 6f 75 6e 74 65 72 73 20 2a 2f 0a 23 69 T counters */.#i
1a400 66 20 53 45 4c 45 43 54 54 52 41 43 45 5f 45 4e f SELECTTRACE_EN
1a410 41 42 4c 45 44 0a 20 20 63 68 61 72 20 7a 53 65 ABLED. char zSe
1a420 6c 4e 61 6d 65 5b 31 32 5d 3b 20 20 20 20 20 2f lName[12]; /
1a430 2a 20 53 79 6d 62 6f 6c 69 63 20 6e 61 6d 65 20 * Symbolic name
1a440 6f 66 20 74 68 69 73 20 53 45 4c 45 43 54 20 75 of this SELECT u
1a450 73 65 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 se for debugging
1a460 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e 74 */.#endif. int
1a470 20 61 64 64 72 4f 70 65 6e 45 70 68 6d 5b 32 5d addrOpenEphm[2]
1a480 3b 20 20 20 2f 2a 20 4f 50 5f 4f 70 65 6e 45 70 ; /* OP_OpenEp
1a490 68 65 6d 20 6f 70 63 6f 64 65 73 20 72 65 6c 61 hem opcodes rela
1a4a0 74 65 64 20 74 6f 20 74 68 69 73 20 73 65 6c 65 ted to this sele
1a4b0 63 74 20 2a 2f 0a 20 20 75 36 34 20 6e 53 65 6c ct */. u64 nSel
1a4c0 65 63 74 52 6f 77 3b 20 20 20 20 20 20 20 20 2f ectRow; /
1a4d0 2a 20 45 73 74 69 6d 61 74 65 64 20 6e 75 6d 62 * Estimated numb
1a4e0 65 72 20 6f 66 20 72 65 73 75 6c 74 20 72 6f 77 er of result row
1a4f0 73 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a s */. SrcList *
1a500 70 53 72 63 3b 20 20 20 20 20 20 20 20 20 2f 2a pSrc; /*
1a510 20 54 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 The FROM clause
1a520 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 68 65 */. Expr *pWhe
1a530 72 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 re; /*
1a540 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 The WHERE clause
1a550 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a */. ExprList *
1a560 70 47 72 6f 75 70 42 79 3b 20 20 20 20 2f 2a 20 pGroupBy; /*
1a570 54 68 65 20 47 52 4f 55 50 20 42 59 20 63 6c 61 The GROUP BY cla
1a580 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 use */. Expr *p
1a590 48 61 76 69 6e 67 3b 20 20 20 20 20 20 20 20 20 Having;
1a5a0 2f 2a 20 54 68 65 20 48 41 56 49 4e 47 20 63 6c /* The HAVING cl
1a5b0 61 75 73 65 20 2a 2f 0a 20 20 45 78 70 72 4c 69 ause */. ExprLi
1a5c0 73 74 20 2a 70 4f 72 64 65 72 42 79 3b 20 20 20 st *pOrderBy;
1a5d0 20 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 42 59 /* The ORDER BY
1a5e0 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 53 65 6c clause */. Sel
1a5f0 65 63 74 20 2a 70 50 72 69 6f 72 3b 20 20 20 20 ect *pPrior;
1a600 20 20 20 20 2f 2a 20 50 72 69 6f 72 20 73 65 6c /* Prior sel
1a610 65 63 74 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e ect in a compoun
1a620 64 20 73 65 6c 65 63 74 20 73 74 61 74 65 6d 65 d select stateme
1a630 6e 74 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a nt */. Select *
1a640 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 2f pNext; /
1a650 2a 20 4e 65 78 74 20 73 65 6c 65 63 74 20 74 6f * Next select to
1a660 20 74 68 65 20 6c 65 66 74 20 69 6e 20 61 20 63 the left in a c
1a670 6f 6d 70 6f 75 6e 64 20 2a 2f 0a 20 20 45 78 70 ompound */. Exp
1a680 72 20 2a 70 4c 69 6d 69 74 3b 20 20 20 20 20 20 r *pLimit;
1a690 20 20 20 20 2f 2a 20 4c 49 4d 49 54 20 65 78 70 /* LIMIT exp
1a6a0 72 65 73 73 69 6f 6e 2e 20 4e 55 4c 4c 20 6d 65 ression. NULL me
1a6b0 61 6e 73 20 6e 6f 74 20 75 73 65 64 2e 20 2a 2f ans not used. */
1a6c0 0a 20 20 45 78 70 72 20 2a 70 4f 66 66 73 65 74 . Expr *pOffset
1a6d0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 46 46 ; /* OFF
1a6e0 53 45 54 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 SET expression.
1a6f0 4e 55 4c 4c 20 6d 65 61 6e 73 20 6e 6f 74 20 75 NULL means not u
1a700 73 65 64 2e 20 2a 2f 0a 20 20 57 69 74 68 20 2a sed. */. With *
1a710 70 57 69 74 68 3b 20 20 20 20 20 20 20 20 20 20 pWith;
1a720 20 2f 2a 20 57 49 54 48 20 63 6c 61 75 73 65 20 /* WITH clause
1a730 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 69 73 attached to this
1a740 20 73 65 6c 65 63 74 2e 20 4f 72 20 4e 55 4c 4c select. Or NULL
1a750 2e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 . */.};../*.** A
1a760 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f llowed values fo
1a770 72 20 53 65 6c 65 63 74 2e 73 65 6c 46 6c 61 67 r Select.selFlag
1a780 73 2e 20 20 54 68 65 20 22 53 46 22 20 70 72 65 s. The "SF" pre
1a790 66 69 78 20 73 74 61 6e 64 73 20 66 6f 72 0a 2a fix stands for.*
1a7a0 2a 20 22 53 65 6c 65 63 74 20 46 6c 61 67 22 2e * "Select Flag".
1a7b0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 44 .*/.#define SF_D
1a7c0 69 73 74 69 6e 63 74 20 20 20 20 20 20 20 20 30 istinct 0
1a7d0 78 30 30 30 31 20 20 2f 2a 20 4f 75 74 70 75 74 x0001 /* Output
1a7e0 20 73 68 6f 75 6c 64 20 62 65 20 44 49 53 54 49 should be DISTI
1a7f0 4e 43 54 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 NCT */.#define S
1a800 46 5f 41 6c 6c 20 20 20 20 20 20 20 20 20 20 20 F_All
1a810 20 20 30 78 30 30 30 32 20 20 2f 2a 20 49 6e 63 0x0002 /* Inc
1a820 6c 75 64 65 73 20 74 68 65 20 41 4c 4c 20 6b 65 ludes the ALL ke
1a830 79 77 6f 72 64 20 2a 2f 0a 23 64 65 66 69 6e 65 yword */.#define
1a840 20 53 46 5f 52 65 73 6f 6c 76 65 64 20 20 20 20 SF_Resolved
1a850 20 20 20 20 30 78 30 30 30 34 20 20 2f 2a 20 49 0x0004 /* I
1a860 64 65 6e 74 69 66 69 65 72 73 20 68 61 76 65 20 dentifiers have
1a870 62 65 65 6e 20 72 65 73 6f 6c 76 65 64 20 2a 2f been resolved */
1a880 0a 23 64 65 66 69 6e 65 20 53 46 5f 41 67 67 72 .#define SF_Aggr
1a890 65 67 61 74 65 20 20 20 20 20 20 20 30 78 30 30 egate 0x00
1a8a0 30 38 20 20 2f 2a 20 43 6f 6e 74 61 69 6e 73 20 08 /* Contains
1a8b0 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
1a8c0 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ons */.#define S
1a8d0 46 5f 55 73 65 73 45 70 68 65 6d 65 72 61 6c 20 F_UsesEphemeral
1a8e0 20 20 30 78 30 30 31 30 20 20 2f 2a 20 55 73 65 0x0010 /* Use
1a8f0 73 20 74 68 65 20 4f 70 65 6e 45 70 68 65 6d 65 s the OpenEpheme
1a900 72 61 6c 20 6f 70 63 6f 64 65 20 2a 2f 0a 23 64 ral opcode */.#d
1a910 65 66 69 6e 65 20 53 46 5f 45 78 70 61 6e 64 65 efine SF_Expande
1a920 64 20 20 20 20 20 20 20 20 30 78 30 30 32 30 20 d 0x0020
1a930 20 2f 2a 20 73 71 6c 69 74 65 33 53 65 6c 65 63 /* sqlite3Selec
1a940 74 45 78 70 61 6e 64 28 29 20 63 61 6c 6c 65 64 tExpand() called
1a950 20 6f 6e 20 74 68 69 73 20 2a 2f 0a 23 64 65 66 on this */.#def
1a960 69 6e 65 20 53 46 5f 48 61 73 54 79 70 65 49 6e ine SF_HasTypeIn
1a970 66 6f 20 20 20 20 20 30 78 30 30 34 30 20 20 2f fo 0x0040 /
1a980 2a 20 46 52 4f 4d 20 73 75 62 71 75 65 72 69 65 * FROM subquerie
1a990 73 20 68 61 76 65 20 54 61 62 6c 65 20 6d 65 74 s have Table met
1a9a0 61 64 61 74 61 20 2a 2f 0a 23 64 65 66 69 6e 65 adata */.#define
1a9b0 20 53 46 5f 43 6f 6d 70 6f 75 6e 64 20 20 20 20 SF_Compound
1a9c0 20 20 20 20 30 78 30 30 38 30 20 20 2f 2a 20 50 0x0080 /* P
1a9d0 61 72 74 20 6f 66 20 61 20 63 6f 6d 70 6f 75 6e art of a compoun
1a9e0 64 20 71 75 65 72 79 20 2a 2f 0a 23 64 65 66 69 d query */.#defi
1a9f0 6e 65 20 53 46 5f 56 61 6c 75 65 73 20 20 20 20 ne SF_Values
1aa00 20 20 20 20 20 20 30 78 30 31 30 30 20 20 2f 2a 0x0100 /*
1aa10 20 53 79 6e 74 68 65 73 69 7a 65 64 20 66 72 6f Synthesized fro
1aa20 6d 20 56 41 4c 55 45 53 20 63 6c 61 75 73 65 20 m VALUES clause
1aa30 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4d 75 */.#define SF_Mu
1aa40 6c 74 69 56 61 6c 75 65 20 20 20 20 20 20 30 78 ltiValue 0x
1aa50 30 32 30 30 20 20 2f 2a 20 53 69 6e 67 6c 65 20 0200 /* Single
1aa60 56 41 4c 55 45 53 20 74 65 72 6d 20 77 69 74 68 VALUES term with
1aa70 20 6d 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a multiple rows *
1aa80 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 4e 65 73 /.#define SF_Nes
1aa90 74 65 64 46 72 6f 6d 20 20 20 20 20 20 30 78 30 tedFrom 0x0
1aaa0 34 30 30 20 20 2f 2a 20 50 61 72 74 20 6f 66 20 400 /* Part of
1aab0 61 20 70 61 72 65 6e 74 68 65 73 69 7a 65 64 20 a parenthesized
1aac0 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 23 FROM clause */.#
1aad0 64 65 66 69 6e 65 20 53 46 5f 4d 61 79 62 65 43 define SF_MaybeC
1aae0 6f 6e 76 65 72 74 20 20 20 20 30 78 30 38 30 30 onvert 0x0800
1aaf0 20 20 2f 2a 20 4e 65 65 64 20 63 6f 6e 76 65 72 /* Need conver
1ab00 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 74 54 tCompoundSelectT
1ab10 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f 0a 23 oSubquery() */.#
1ab20 64 65 66 69 6e 65 20 53 46 5f 4d 69 6e 4d 61 78 define SF_MinMax
1ab30 41 67 67 20 20 20 20 20 20 20 30 78 31 30 30 30 Agg 0x1000
1ab40 20 20 2f 2a 20 41 67 67 72 65 67 61 74 65 20 63 /* Aggregate c
1ab50 6f 6e 74 61 69 6e 69 6e 67 20 6d 69 6e 28 29 20 ontaining min()
1ab60 6f 72 20 6d 61 78 28 29 20 2a 2f 0a 23 64 65 66 or max() */.#def
1ab70 69 6e 65 20 53 46 5f 52 65 63 75 72 73 69 76 65 ine SF_Recursive
1ab80 20 20 20 20 20 20 20 30 78 32 30 30 30 20 20 2f 0x2000 /
1ab90 2a 20 54 68 65 20 72 65 63 75 72 73 69 76 65 20 * The recursive
1aba0 70 61 72 74 20 6f 66 20 61 20 72 65 63 75 72 73 part of a recurs
1abb0 69 76 65 20 43 54 45 20 2a 2f 0a 23 64 65 66 69 ive CTE */.#defi
1abc0 6e 65 20 53 46 5f 43 6f 6e 76 65 72 74 65 64 20 ne SF_Converted
1abd0 20 20 20 20 20 20 30 78 34 30 30 30 20 20 2f 2a 0x4000 /*
1abe0 20 42 79 20 63 6f 6e 76 65 72 74 43 6f 6d 70 6f By convertCompo
1abf0 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 75 undSelectToSubqu
1ac00 65 72 79 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 ery() */.#define
1ac10 20 53 46 5f 49 6e 63 6c 75 64 65 48 69 64 64 65 SF_IncludeHidde
1ac20 6e 20 20 20 30 78 38 30 30 30 20 20 2f 2a 20 49 n 0x8000 /* I
1ac30 6e 63 6c 75 64 65 20 68 69 64 64 65 6e 20 63 6f nclude hidden co
1ac40 6c 75 6d 6e 73 20 69 6e 20 6f 75 74 70 75 74 20 lumns in output
1ac50 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 72 */.../*.** The r
1ac60 65 73 75 6c 74 73 20 6f 66 20 61 20 53 45 4c 45 esults of a SELE
1ac70 43 54 20 63 61 6e 20 62 65 20 64 69 73 74 72 69 CT can be distri
1ac80 62 75 74 65 64 20 69 6e 20 73 65 76 65 72 61 6c buted in several
1ac90 20 77 61 79 73 2c 20 61 73 20 64 65 66 69 6e 65 ways, as define
1aca0 64 0a 2a 2a 20 62 79 20 6f 6e 65 20 6f 66 20 74 d.** by one of t
1acb0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 he following mac
1acc0 72 6f 73 2e 20 20 54 68 65 20 22 53 52 54 22 20 ros. The "SRT"
1acd0 70 72 65 66 69 78 20 6d 65 61 6e 73 20 22 53 45 prefix means "SE
1ace0 4c 45 43 54 20 52 65 73 75 6c 74 0a 2a 2a 20 54 LECT Result.** T
1acf0 79 70 65 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 ype"..**.**
1ad00 53 52 54 5f 55 6e 69 6f 6e 20 20 20 20 20 20 20 SRT_Union
1ad10 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 61 73 Store results as
1ad20 20 61 20 6b 65 79 20 69 6e 20 61 20 74 65 6d 70 a key in a temp
1ad30 6f 72 61 72 79 20 69 6e 64 65 78 0a 2a 2a 20 20 orary index.**
1ad40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ad50 20 20 20 69 64 65 6e 74 69 66 69 65 64 20 62 79 identified by
1ad60 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2e pDest->iSDParm.
1ad70 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 45 .**.** SRT_E
1ad80 78 63 65 70 74 20 20 20 20 20 20 52 65 6d 6f 76 xcept Remov
1ad90 65 20 72 65 73 75 6c 74 73 20 66 72 6f 6d 20 74 e results from t
1ada0 68 65 20 74 65 6d 70 6f 72 61 72 79 20 69 6e 64 he temporary ind
1adb0 65 78 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 ex pDest->iSDPar
1adc0 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 m..**.** SRT
1add0 5f 45 78 69 73 74 73 20 20 20 20 20 20 53 74 6f _Exists Sto
1ade0 72 65 20 61 20 31 20 69 6e 20 6d 65 6d 6f 72 79 re a 1 in memory
1adf0 20 63 65 6c 6c 20 70 44 65 73 74 2d 3e 69 53 44 cell pDest->iSD
1ae00 50 61 72 6d 20 69 66 20 74 68 65 20 72 65 73 75 Parm if the resu
1ae10 6c 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 lt.**
1ae20 20 20 20 20 20 20 20 20 20 20 73 65 74 20 69 73 set is
1ae30 20 6e 6f 74 20 65 6d 70 74 79 2e 0a 2a 2a 0a 2a not empty..**.*
1ae40 2a 20 20 20 20 20 53 52 54 5f 44 69 73 63 61 72 * SRT_Discar
1ae50 64 20 20 20 20 20 54 68 72 6f 77 20 74 68 65 20 d Throw the
1ae60 72 65 73 75 6c 74 73 20 61 77 61 79 2e 20 20 54 results away. T
1ae70 68 69 73 20 69 73 20 75 73 65 64 20 62 79 20 53 his is used by S
1ae80 45 4c 45 43 54 0a 2a 2a 20 20 20 20 20 20 20 20 ELECT.**
1ae90 20 20 20 20 20 20 20 20 20 20 20 20 20 73 74 61 sta
1aea0 74 65 6d 65 6e 74 73 20 77 69 74 68 69 6e 20 74 tements within t
1aeb0 72 69 67 67 65 72 73 20 77 68 6f 73 65 20 6f 6e riggers whose on
1aec0 6c 79 20 70 75 72 70 6f 73 65 20 69 73 0a 2a 2a ly purpose is.**
1aed0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1aee0 20 20 20 20 20 74 68 65 20 73 69 64 65 2d 65 66 the side-ef
1aef0 66 65 63 74 73 20 6f 66 20 66 75 6e 63 74 69 6f fects of functio
1af00 6e 73 2e 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 6f 66 ns..**.** All of
1af10 20 74 68 65 20 61 62 6f 76 65 20 61 72 65 20 66 the above are f
1af20 72 65 65 20 74 6f 20 69 67 6e 6f 72 65 20 74 68 ree to ignore th
1af30 65 69 72 20 4f 52 44 45 52 20 42 59 20 63 6c 61 eir ORDER BY cla
1af40 75 73 65 2e 20 54 68 6f 73 65 20 74 68 61 74 0a use. Those that.
1af50 2a 2a 20 66 6f 6c 6c 6f 77 20 6d 75 73 74 20 68 ** follow must h
1af60 6f 6e 6f 72 20 74 68 65 20 4f 52 44 45 52 20 42 onor the ORDER B
1af70 59 20 63 6c 61 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 Y clause..**.**
1af80 20 20 20 20 53 52 54 5f 4f 75 74 70 75 74 20 20 SRT_Output
1af90 20 20 20 20 47 65 6e 65 72 61 74 65 20 61 20 72 Generate a r
1afa0 6f 77 20 6f 66 20 6f 75 74 70 75 74 20 28 75 73 ow of output (us
1afb0 69 6e 67 20 74 68 65 20 4f 50 5f 52 65 73 75 6c ing the OP_Resul
1afc0 74 52 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 20 tRow.**
1afd0 20 20 20 20 20 20 20 20 20 20 20 20 6f 70 63 6f opco
1afe0 64 65 29 20 66 6f 72 20 65 61 63 68 20 72 6f 77 de) for each row
1aff0 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 20 73 in the result s
1b000 65 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 et..**.** SR
1b010 54 5f 4d 65 6d 20 20 20 20 20 20 20 20 20 4f 6e T_Mem On
1b020 6c 79 20 76 61 6c 69 64 20 69 66 20 74 68 65 20 ly valid if the
1b030 72 65 73 75 6c 74 20 69 73 20 61 20 73 69 6e 67 result is a sing
1b040 6c 65 20 63 6f 6c 75 6d 6e 2e 0a 2a 2a 20 20 20 le column..**
1b050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b060 20 20 53 74 6f 72 65 20 74 68 65 20 66 69 72 73 Store the firs
1b070 74 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 t column of the
1b080 66 69 72 73 74 20 72 65 73 75 6c 74 20 72 6f 77 first result row
1b090 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1b0a0 20 20 20 20 20 20 20 20 69 6e 20 72 65 67 69 73 in regis
1b0b0 74 65 72 20 70 44 65 73 74 2d 3e 69 53 44 50 61 ter pDest->iSDPa
1b0c0 72 6d 20 74 68 65 6e 20 61 62 61 6e 64 6f 6e 20 rm then abandon
1b0d0 74 68 65 20 72 65 73 74 0a 2a 2a 20 20 20 20 20 the rest.**
1b0e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b0f0 6f 66 20 74 68 65 20 71 75 65 72 79 2e 20 20 54 of the query. T
1b100 68 69 73 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 his destination
1b110 69 6d 70 6c 69 65 73 20 22 4c 49 4d 49 54 20 31 implies "LIMIT 1
1b120 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 "..**.** SRT
1b130 5f 53 65 74 20 20 20 20 20 20 20 20 20 54 68 65 _Set The
1b140 20 72 65 73 75 6c 74 20 6d 75 73 74 20 62 65 20 result must be
1b150 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2e a single column.
1b160 20 20 53 74 6f 72 65 20 65 61 63 68 0a 2a 2a 20 Store each.**
1b170 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b180 20 20 20 20 72 6f 77 20 6f 66 20 72 65 73 75 6c row of resul
1b190 74 20 61 73 20 74 68 65 20 6b 65 79 20 69 6e 20 t as the key in
1b1a0 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 table pDest->iSD
1b1b0 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 Parm..**
1b1c0 20 20 20 20 20 20 20 20 20 20 20 20 20 41 70 70 App
1b1d0 6c 79 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 ly the affinity
1b1e0 70 44 65 73 74 2d 3e 61 66 66 53 64 73 74 20 62 pDest->affSdst b
1b1f0 65 66 6f 72 65 20 73 74 6f 72 69 6e 67 0a 2a 2a efore storing.**
1b200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b210 20 20 20 20 20 72 65 73 75 6c 74 73 2e 20 20 55 results. U
1b220 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 sed to implement
1b230 20 22 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e 2e "IN (SELECT ...
1b240 29 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 )"..**.** SR
1b250 54 5f 45 70 68 65 6d 54 61 62 20 20 20 20 43 72 T_EphemTab Cr
1b260 65 61 74 65 20 61 6e 20 74 65 6d 70 6f 72 61 72 eate an temporar
1b270 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 y table pDest->i
1b280 53 44 50 61 72 6d 20 61 6e 64 20 73 74 6f 72 65 SDParm and store
1b290 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1b2a0 20 20 20 20 20 20 20 20 74 68 65 20 72 65 73 75 the resu
1b2b0 6c 74 20 74 68 65 72 65 2e 20 54 68 65 20 63 75 lt there. The cu
1b2c0 72 73 6f 72 20 69 73 20 6c 65 66 74 20 6f 70 65 rsor is left ope
1b2d0 6e 20 61 66 74 65 72 0a 2a 2a 20 20 20 20 20 20 n after.**
1b2e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 r
1b2f0 65 74 75 72 6e 69 6e 67 2e 20 20 54 68 69 73 20 eturning. This
1b300 69 73 20 6c 69 6b 65 20 53 52 54 5f 54 61 62 6c is like SRT_Tabl
1b310 65 20 65 78 63 65 70 74 20 74 68 61 74 0a 2a 2a e except that.**
1b320 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b330 20 20 20 20 20 74 68 69 73 20 64 65 73 74 69 6e this destin
1b340 61 74 69 6f 6e 20 75 73 65 73 20 4f 50 5f 4f 70 ation uses OP_Op
1b350 65 6e 45 70 68 65 6d 65 72 61 6c 20 74 6f 20 63 enEphemeral to c
1b360 72 65 61 74 65 0a 2a 2a 20 20 20 20 20 20 20 20 reate.**
1b370 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 the
1b380 20 74 61 62 6c 65 20 66 69 72 73 74 2e 0a 2a 2a table first..**
1b390 0a 2a 2a 20 20 20 20 20 53 52 54 5f 43 6f 72 6f .** SRT_Coro
1b3a0 75 74 69 6e 65 20 20 20 47 65 6e 65 72 61 74 65 utine Generate
1b3b0 20 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 74 68 a co-routine th
1b3c0 61 74 20 72 65 74 75 72 6e 73 20 61 20 6e 65 77 at returns a new
1b3d0 20 72 6f 77 20 6f 66 0a 2a 2a 20 20 20 20 20 20 row of.**
1b3e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 r
1b3f0 65 73 75 6c 74 73 20 65 61 63 68 20 74 69 6d 65 esults each time
1b400 20 69 74 20 69 73 20 69 6e 76 6f 6b 65 64 2e 20 it is invoked.
1b410 20 54 68 65 20 65 6e 74 72 79 20 70 6f 69 6e 74 The entry point
1b420 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
1b430 20 20 20 20 20 20 20 20 6f 66 20 74 68 65 20 63 of the c
1b440 6f 2d 72 6f 75 74 69 6e 65 20 69 73 20 73 74 6f o-routine is sto
1b450 72 65 64 20 69 6e 20 72 65 67 69 73 74 65 72 20 red in register
1b460 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 0a 2a pDest->iSDParm.*
1b470 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1b480 20 20 20 20 20 20 61 6e 64 20 74 68 65 20 72 65 and the re
1b490 73 75 6c 74 20 72 6f 77 20 69 73 20 73 74 6f 72 sult row is stor
1b4a0 65 64 20 69 6e 20 70 44 65 73 74 2d 3e 6e 44 65 ed in pDest->nDe
1b4b0 73 74 20 72 65 67 69 73 74 65 72 73 0a 2a 2a 20 st registers.**
1b4c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b4d0 20 20 20 20 73 74 61 72 74 69 6e 67 20 77 69 74 starting wit
1b4e0 68 20 70 44 65 73 74 2d 3e 69 53 64 73 74 2e 0a h pDest->iSdst..
1b4f0 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 54 61 **.** SRT_Ta
1b500 62 6c 65 20 20 20 20 20 20 20 53 74 6f 72 65 20 ble Store
1b510 72 65 73 75 6c 74 73 20 69 6e 20 74 65 6d 70 6f results in tempo
1b520 72 61 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 rary table pDest
1b530 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 20 20 ->iSDParm..**
1b540 20 20 53 52 54 5f 46 69 66 6f 20 20 20 20 20 20 SRT_Fifo
1b550 20 20 54 68 69 73 20 69 73 20 6c 69 6b 65 20 53 This is like S
1b560 52 54 5f 45 70 68 65 6d 54 61 62 20 65 78 63 65 RT_EphemTab exce
1b570 70 74 20 74 68 61 74 20 74 68 65 20 74 61 62 6c pt that the tabl
1b580 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 e.**
1b590 20 20 20 20 20 20 20 20 20 69 73 20 61 73 73 75 is assu
1b5a0 6d 65 64 20 74 6f 20 61 6c 72 65 61 64 79 20 62 med to already b
1b5b0 65 20 6f 70 65 6e 2e 20 20 53 52 54 5f 46 69 66 e open. SRT_Fif
1b5c0 6f 20 68 61 73 0a 2a 2a 20 20 20 20 20 20 20 20 o has.**
1b5d0 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 the
1b5e0 20 61 64 64 69 74 69 6f 6e 61 6c 20 70 72 6f 70 additional prop
1b5f0 65 72 74 79 20 6f 66 20 62 65 69 6e 67 20 61 62 erty of being ab
1b600 6c 65 20 74 6f 20 69 67 6e 6f 72 65 0a 2a 2a 20 le to ignore.**
1b610 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b620 20 20 20 20 74 68 65 20 4f 52 44 45 52 20 42 59 the ORDER BY
1b630 20 63 6c 61 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 clause..**.**
1b640 20 20 20 53 52 54 5f 44 69 73 74 46 69 66 6f 20 SRT_DistFifo
1b650 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 Store results
1b660 20 69 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 in a temporary
1b670 74 61 62 6c 65 20 70 44 65 73 74 2d 3e 69 53 44 table pDest->iSD
1b680 50 61 72 6d 2e 0a 2a 2a 20 20 20 20 20 20 20 20 Parm..**
1b690 20 20 20 20 20 20 20 20 20 20 20 20 20 42 75 74 But
1b6a0 20 61 6c 73 6f 20 75 73 65 20 74 65 6d 70 6f 72 also use tempor
1b6b0 61 72 79 20 74 61 62 6c 65 20 70 44 65 73 74 2d ary table pDest-
1b6c0 3e 69 53 44 50 61 72 6d 2b 31 20 61 73 0a 2a 2a >iSDParm+1 as.**
1b6d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b6e0 20 20 20 20 20 61 20 72 65 63 6f 72 64 20 6f 66 a record of
1b6f0 20 61 6c 6c 20 70 72 69 6f 72 20 72 65 73 75 6c all prior resul
1b700 74 73 20 61 6e 64 20 69 67 6e 6f 72 65 20 61 6e ts and ignore an
1b710 79 20 64 75 70 6c 69 63 61 74 65 0a 2a 2a 20 20 y duplicate.**
1b720 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b730 20 20 20 72 6f 77 73 2e 20 20 4e 61 6d 65 20 6d rows. Name m
1b740 65 61 6e 73 3a 20 20 22 44 69 73 74 69 6e 63 74 eans: "Distinct
1b750 20 46 69 66 6f 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 Fifo"..**.**
1b760 20 20 53 52 54 5f 51 75 65 75 65 20 20 20 20 20 SRT_Queue
1b770 20 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 Store results
1b780 69 6e 20 70 72 69 6f 72 69 74 79 20 71 75 65 75 in priority queu
1b790 65 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d e pDest->iSDParm
1b7a0 20 28 72 65 61 6c 6c 79 0a 2a 2a 20 20 20 20 20 (really.**
1b7b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b7c0 61 6e 20 69 6e 64 65 78 29 2e 20 20 41 70 70 65 an index). Appe
1b7d0 6e 64 20 61 20 73 65 71 75 65 6e 63 65 20 6e 75 nd a sequence nu
1b7e0 6d 62 65 72 20 73 6f 20 74 68 61 74 20 61 6c 6c mber so that all
1b7f0 20 65 6e 74 72 69 65 73 0a 2a 2a 20 20 20 20 20 entries.**
1b800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b810 61 72 65 20 64 69 73 74 69 6e 63 74 2e 0a 2a 2a are distinct..**
1b820 0a 2a 2a 20 20 20 20 20 53 52 54 5f 44 69 73 74 .** SRT_Dist
1b830 51 75 65 75 65 20 20 20 53 74 6f 72 65 20 72 65 Queue Store re
1b840 73 75 6c 74 73 20 69 6e 20 70 72 69 6f 72 69 74 sults in priorit
1b850 79 20 71 75 65 75 65 20 70 44 65 73 74 2d 3e 69 y queue pDest->i
1b860 53 44 50 61 72 6d 20 6f 6e 6c 79 20 69 66 0a 2a SDParm only if.*
1b870 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1b880 20 20 20 20 20 20 74 68 65 20 73 61 6d 65 20 72 the same r
1b890 65 63 6f 72 64 20 68 61 73 20 6e 65 76 65 72 20 ecord has never
1b8a0 62 65 65 6e 20 73 74 6f 72 65 64 20 62 65 66 6f been stored befo
1b8b0 72 65 2e 20 20 54 68 65 0a 2a 2a 20 20 20 20 20 re. The.**
1b8c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b8d0 69 6e 64 65 78 20 61 74 20 70 44 65 73 74 2d 3e index at pDest->
1b8e0 69 53 44 50 61 72 6d 2b 31 20 68 6f 6c 64 20 61 iSDParm+1 hold a
1b8f0 6c 6c 20 70 72 69 6f 72 20 73 74 6f 72 65 73 2e ll prior stores.
1b900 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f .*/.#define SRT_
1b910 55 6e 69 6f 6e 20 20 20 20 20 20 20 20 31 20 20 Union 1
1b920 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 /* Store result
1b930 61 73 20 6b 65 79 73 20 69 6e 20 61 6e 20 69 6e as keys in an in
1b940 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 dex */.#define S
1b950 52 54 5f 45 78 63 65 70 74 20 20 20 20 20 20 20 RT_Except
1b960 32 20 20 2f 2a 20 52 65 6d 6f 76 65 20 72 65 73 2 /* Remove res
1b970 75 6c 74 20 66 72 6f 6d 20 61 20 55 4e 49 4f 4e ult from a UNION
1b980 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e index */.#defin
1b990 65 20 53 52 54 5f 45 78 69 73 74 73 20 20 20 20 e SRT_Exists
1b9a0 20 20 20 33 20 20 2f 2a 20 53 74 6f 72 65 20 31 3 /* Store 1
1b9b0 20 69 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 if the result i
1b9c0 73 20 6e 6f 74 20 65 6d 70 74 79 20 2a 2f 0a 23 s not empty */.#
1b9d0 64 65 66 69 6e 65 20 53 52 54 5f 44 69 73 63 61 define SRT_Disca
1b9e0 72 64 20 20 20 20 20 20 34 20 20 2f 2a 20 44 6f rd 4 /* Do
1b9f0 20 6e 6f 74 20 73 61 76 65 20 74 68 65 20 72 65 not save the re
1ba00 73 75 6c 74 73 20 61 6e 79 77 68 65 72 65 20 2a sults anywhere *
1ba10 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 46 69 /.#define SRT_Fi
1ba20 66 6f 20 20 20 20 20 20 20 20 20 35 20 20 2f 2a fo 5 /*
1ba30 20 53 74 6f 72 65 20 72 65 73 75 6c 74 20 61 73 Store result as
1ba40 20 64 61 74 61 20 77 69 74 68 20 61 6e 20 61 75 data with an au
1ba50 74 6f 6d 61 74 69 63 20 72 6f 77 69 64 20 2a 2f tomatic rowid */
1ba60 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 44 69 73 .#define SRT_Dis
1ba70 74 46 69 66 6f 20 20 20 20 20 36 20 20 2f 2a 20 tFifo 6 /*
1ba80 4c 69 6b 65 20 53 52 54 5f 46 69 66 6f 2c 20 62 Like SRT_Fifo, b
1ba90 75 74 20 75 6e 69 71 75 65 20 72 65 73 75 6c 74 ut unique result
1baa0 73 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e s only */.#defin
1bab0 65 20 53 52 54 5f 51 75 65 75 65 20 20 20 20 20 e SRT_Queue
1bac0 20 20 20 37 20 20 2f 2a 20 53 74 6f 72 65 20 72 7 /* Store r
1bad0 65 73 75 6c 74 20 69 6e 20 61 6e 20 71 75 65 75 esult in an queu
1bae0 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 e */.#define SRT
1baf0 5f 44 69 73 74 51 75 65 75 65 20 20 20 20 38 20 _DistQueue 8
1bb00 20 2f 2a 20 4c 69 6b 65 20 53 52 54 5f 51 75 65 /* Like SRT_Que
1bb10 75 65 2c 20 62 75 74 20 75 6e 69 71 75 65 20 72 ue, but unique r
1bb20 65 73 75 6c 74 73 20 6f 6e 6c 79 20 2a 2f 0a 0a esults only */..
1bb30 2f 2a 20 54 68 65 20 4f 52 44 45 52 20 42 59 20 /* The ORDER BY
1bb40 63 6c 61 75 73 65 20 69 73 20 69 67 6e 6f 72 65 clause is ignore
1bb50 64 20 66 6f 72 20 61 6c 6c 20 6f 66 20 74 68 65 d for all of the
1bb60 20 61 62 6f 76 65 20 2a 2f 0a 23 64 65 66 69 6e above */.#defin
1bb70 65 20 49 67 6e 6f 72 61 62 6c 65 4f 72 64 65 72 e IgnorableOrder
1bb80 62 79 28 58 29 20 28 28 58 2d 3e 65 44 65 73 74 by(X) ((X->eDest
1bb90 29 3c 3d 53 52 54 5f 44 69 73 74 51 75 65 75 65 )<=SRT_DistQueue
1bba0 29 0a 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 4f )..#define SRT_O
1bbb0 75 74 70 75 74 20 20 20 20 20 20 20 39 20 20 2f utput 9 /
1bbc0 2a 20 4f 75 74 70 75 74 20 65 61 63 68 20 72 6f * Output each ro
1bbd0 77 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 0a 23 w of result */.#
1bbe0 64 65 66 69 6e 65 20 53 52 54 5f 4d 65 6d 20 20 define SRT_Mem
1bbf0 20 20 20 20 20 20 20 31 30 20 20 2f 2a 20 53 74 10 /* St
1bc00 6f 72 65 20 72 65 73 75 6c 74 20 69 6e 20 61 20 ore result in a
1bc10 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 2a 2f 0a 23 memory cell */.#
1bc20 64 65 66 69 6e 65 20 53 52 54 5f 53 65 74 20 20 define SRT_Set
1bc30 20 20 20 20 20 20 20 31 31 20 20 2f 2a 20 53 74 11 /* St
1bc40 6f 72 65 20 72 65 73 75 6c 74 73 20 61 73 20 6b ore results as k
1bc50 65 79 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 20 eys in an index
1bc60 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 */.#define SRT_E
1bc70 70 68 65 6d 54 61 62 20 20 20 20 31 32 20 20 2f phemTab 12 /
1bc80 2a 20 43 72 65 61 74 65 20 74 72 61 6e 73 69 65 * Create transie
1bc90 6e 74 20 74 61 62 20 61 6e 64 20 73 74 6f 72 65 nt tab and store
1bca0 20 6c 69 6b 65 20 53 52 54 5f 54 61 62 6c 65 20 like SRT_Table
1bcb0 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 43 */.#define SRT_C
1bcc0 6f 72 6f 75 74 69 6e 65 20 20 20 31 33 20 20 2f oroutine 13 /
1bcd0 2a 20 47 65 6e 65 72 61 74 65 20 61 20 73 69 6e * Generate a sin
1bce0 67 6c 65 20 72 6f 77 20 6f 66 20 72 65 73 75 6c gle row of resul
1bcf0 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 54 t */.#define SRT
1bd00 5f 54 61 62 6c 65 20 20 20 20 20 20 20 31 34 20 _Table 14
1bd10 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c 74 /* Store result
1bd20 20 61 73 20 64 61 74 61 20 77 69 74 68 20 61 6e as data with an
1bd30 20 61 75 74 6f 6d 61 74 69 63 20 72 6f 77 69 64 automatic rowid
1bd40 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e */../*.** An in
1bd50 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 6f stance of this o
1bd60 62 6a 65 63 74 20 64 65 73 63 72 69 62 65 73 20 bject describes
1bd70 77 68 65 72 65 20 74 6f 20 70 75 74 20 6f 66 20 where to put of
1bd80 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 0a 2a the results of.*
1bd90 2a 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 * a SELECT state
1bda0 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 ment..*/.struct
1bdb0 53 65 6c 65 63 74 44 65 73 74 20 7b 0a 20 20 75 SelectDest {. u
1bdc0 38 20 65 44 65 73 74 3b 20 20 20 20 20 20 20 20 8 eDest;
1bdd0 20 20 20 20 2f 2a 20 48 6f 77 20 74 6f 20 64 69 /* How to di
1bde0 73 70 6f 73 65 20 6f 66 20 74 68 65 20 72 65 73 spose of the res
1bdf0 75 6c 74 73 2e 20 20 4f 6e 20 6f 66 20 53 52 54 ults. On of SRT
1be00 5f 2a 20 61 62 6f 76 65 2e 20 2a 2f 0a 20 20 63 _* above. */. c
1be10 68 61 72 20 61 66 66 53 64 73 74 3b 20 20 20 20 har affSdst;
1be20 20 20 20 20 2f 2a 20 41 66 66 69 6e 69 74 79 20 /* Affinity
1be30 75 73 65 64 20 77 68 65 6e 20 65 44 65 73 74 3d used when eDest=
1be40 3d 53 52 54 5f 53 65 74 20 2a 2f 0a 20 20 69 6e =SRT_Set */. in
1be50 74 20 69 53 44 50 61 72 6d 3b 20 20 20 20 20 20 t iSDParm;
1be60 20 20 20 2f 2a 20 41 20 70 61 72 61 6d 65 74 65 /* A paramete
1be70 72 20 75 73 65 64 20 62 79 20 74 68 65 20 65 44 r used by the eD
1be80 65 73 74 20 64 69 73 70 6f 73 61 6c 20 6d 65 74 est disposal met
1be90 68 6f 64 20 2a 2f 0a 20 20 69 6e 74 20 69 53 64 hod */. int iSd
1bea0 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a st; /*
1beb0 20 42 61 73 65 20 72 65 67 69 73 74 65 72 20 77 Base register w
1bec0 68 65 72 65 20 72 65 73 75 6c 74 73 20 61 72 65 here results are
1bed0 20 77 72 69 74 74 65 6e 20 2a 2f 0a 20 20 69 6e written */. in
1bee0 74 20 6e 53 64 73 74 3b 20 20 20 20 20 20 20 20 t nSdst;
1bef0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
1bf00 72 65 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 registers alloca
1bf10 74 65 64 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 ted */. ExprLis
1bf20 74 20 2a 70 4f 72 64 65 72 42 79 3b 20 20 2f 2a t *pOrderBy; /*
1bf30 20 4b 65 79 20 63 6f 6c 75 6d 6e 73 20 66 6f 72 Key columns for
1bf40 20 53 52 54 5f 51 75 65 75 65 20 61 6e 64 20 53 SRT_Queue and S
1bf50 52 54 5f 44 69 73 74 51 75 65 75 65 20 2a 2f 0a RT_DistQueue */.
1bf60 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 44 75 72 69 6e 67 };../*.** During
1bf70 20 63 6f 64 65 20 67 65 6e 65 72 61 74 69 6f 6e code generation
1bf80 20 6f 66 20 73 74 61 74 65 6d 65 6e 74 73 20 74 of statements t
1bf90 68 61 74 20 64 6f 20 69 6e 73 65 72 74 73 20 69 hat do inserts i
1bfa0 6e 74 6f 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e nto AUTOINCREMEN
1bfb0 54 0a 2a 2a 20 74 61 62 6c 65 73 2c 20 74 68 65 T.** tables, the
1bfc0 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 following infor
1bfd0 6d 61 74 69 6f 6e 20 69 73 20 61 74 74 61 63 68 mation is attach
1bfe0 65 64 20 74 6f 20 74 68 65 20 54 61 62 6c 65 2e ed to the Table.
1bff0 75 2e 61 75 74 6f 49 6e 63 2e 70 0a 2a 2a 20 70 u.autoInc.p.** p
1c000 6f 69 6e 74 65 72 20 6f 66 20 65 61 63 68 20 61 ointer of each a
1c010 75 74 6f 69 6e 63 72 65 6d 65 6e 74 20 74 61 62 utoincrement tab
1c020 6c 65 20 74 6f 20 72 65 63 6f 72 64 20 73 6f 6d le to record som
1c030 65 20 73 69 64 65 20 69 6e 66 6f 72 6d 61 74 69 e side informati
1c040 6f 6e 20 74 68 61 74 0a 2a 2a 20 74 68 65 20 63 on that.** the c
1c050 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 20 6e 65 ode generator ne
1c060 65 64 73 2e 20 20 57 65 20 68 61 76 65 20 74 6f eds. We have to
1c070 20 6b 65 65 70 20 70 65 72 2d 74 61 62 6c 65 20 keep per-table
1c080 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 0a 2a 2a autoincrement.**
1c090 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 6e 20 information in
1c0a0 63 61 73 65 20 69 6e 73 65 72 74 73 20 61 72 65 case inserts are
1c0b0 20 64 6f 6e 65 20 77 69 74 68 69 6e 20 74 72 69 done within tri
1c0c0 67 67 65 72 73 2e 20 20 54 72 69 67 67 65 72 73 ggers. Triggers
1c0d0 20 64 6f 20 6e 6f 74 0a 2a 2a 20 6e 6f 72 6d 61 do not.** norma
1c0e0 6c 6c 79 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 lly coordinate t
1c0f0 68 65 69 72 20 61 63 74 69 76 69 74 69 65 73 2c heir activities,
1c100 20 62 75 74 20 77 65 20 64 6f 20 6e 65 65 64 20 but we do need
1c110 74 6f 20 63 6f 6f 72 64 69 6e 61 74 65 20 74 68 to coordinate th
1c120 65 0a 2a 2a 20 6c 6f 61 64 69 6e 67 20 61 6e 64 e.** loading and
1c130 20 73 61 76 69 6e 67 20 6f 66 20 61 75 74 6f 69 saving of autoi
1c140 6e 63 72 65 6d 65 6e 74 20 69 6e 66 6f 72 6d 61 ncrement informa
1c150 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 tion..*/.struct
1c160 41 75 74 6f 69 6e 63 49 6e 66 6f 20 7b 0a 20 20 AutoincInfo {.
1c170 41 75 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 4e 65 AutoincInfo *pNe
1c180 78 74 3b 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e xt; /* Next in
1c190 66 6f 20 62 6c 6f 63 6b 20 69 6e 20 61 20 6c 69 fo block in a li
1c1a0 73 74 20 6f 66 20 74 68 65 6d 20 61 6c 6c 20 2a st of them all *
1c1b0 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b /. Table *pTab;
1c1c0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 /* Tab
1c1d0 6c 65 20 74 68 69 73 20 69 6e 66 6f 20 62 6c 6f le this info blo
1c1e0 63 6b 20 72 65 66 65 72 73 20 74 6f 20 2a 2f 0a ck refers to */.
1c1f0 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20 20 int iDb;
1c200 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 /* Index
1c210 20 69 6e 20 73 71 6c 69 74 65 33 2e 61 44 62 5b in sqlite3.aDb[
1c220 5d 20 6f 66 20 64 61 74 61 62 61 73 65 20 68 6f ] of database ho
1c230 6c 64 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20 lding pTab */.
1c240 69 6e 74 20 72 65 67 43 74 72 3b 20 20 20 20 20 int regCtr;
1c250 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 /* Memory
1c260 72 65 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 register holding
1c270 20 74 68 65 20 72 6f 77 69 64 20 63 6f 75 6e 74 the rowid count
1c280 65 72 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 er */.};../*.**
1c290 53 69 7a 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 Size of the colu
1c2a0 6d 6e 20 63 61 63 68 65 0a 2a 2f 0a 23 69 66 6e mn cache.*/.#ifn
1c2b0 64 65 66 20 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c def SQLITE_N_COL
1c2c0 43 41 43 48 45 0a 23 20 64 65 66 69 6e 65 20 53 CACHE.# define S
1c2d0 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 QLITE_N_COLCACHE
1c2e0 20 31 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 10.#endif../*.*
1c2f0 2a 20 41 74 20 6c 65 61 73 74 20 6f 6e 65 20 69 * At least one i
1c300 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 nstance of the f
1c310 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
1c320 72 65 20 69 73 20 63 72 65 61 74 65 64 20 66 6f re is created fo
1c330 72 20 65 61 63 68 0a 2a 2a 20 74 72 69 67 67 65 r each.** trigge
1c340 72 20 74 68 61 74 20 6d 61 79 20 62 65 20 66 69 r that may be fi
1c350 72 65 64 20 77 68 69 6c 65 20 70 61 72 73 69 6e red while parsin
1c360 67 20 61 6e 20 49 4e 53 45 52 54 2c 20 55 50 44 g an INSERT, UPD
1c370 41 54 45 20 6f 72 20 44 45 4c 45 54 45 0a 2a 2a ATE or DELETE.**
1c380 20 73 74 61 74 65 6d 65 6e 74 2e 20 41 6c 6c 20 statement. All
1c390 73 75 63 68 20 6f 62 6a 65 63 74 73 20 61 72 65 such objects are
1c3a0 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 6c stored in the l
1c3b0 69 6e 6b 65 64 20 6c 69 73 74 20 68 65 61 64 65 inked list heade
1c3c0 64 20 61 74 0a 2a 2a 20 50 61 72 73 65 2e 70 54 d at.** Parse.pT
1c3d0 72 69 67 67 65 72 50 72 67 20 61 6e 64 20 64 65 riggerPrg and de
1c3e0 6c 65 74 65 64 20 6f 6e 63 65 20 73 74 61 74 65 leted once state
1c3f0 6d 65 6e 74 20 63 6f 6d 70 69 6c 61 74 69 6f 6e ment compilation
1c400 20 68 61 73 20 62 65 65 6e 0a 2a 2a 20 63 6f 6d has been.** com
1c410 70 6c 65 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 20 pleted..**.** A
1c420 56 64 62 65 20 73 75 62 2d 70 72 6f 67 72 61 6d Vdbe sub-program
1c430 20 74 68 61 74 20 69 6d 70 6c 65 6d 65 6e 74 73 that implements
1c440 20 74 68 65 20 62 6f 64 79 20 61 6e 64 20 57 48 the body and WH
1c450 45 4e 20 63 6c 61 75 73 65 20 6f 66 20 74 72 69 EN clause of tri
1c460 67 67 65 72 0a 2a 2a 20 54 72 69 67 67 65 72 50 gger.** TriggerP
1c470 72 67 2e 70 54 72 69 67 67 65 72 2c 20 61 73 73 rg.pTrigger, ass
1c480 75 6d 69 6e 67 20 61 20 64 65 66 61 75 6c 74 20 uming a default
1c490 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 ON CONFLICT clau
1c4a0 73 65 20 6f 66 0a 2a 2a 20 54 72 69 67 67 65 72 se of.** Trigger
1c4b0 50 72 67 2e 6f 72 63 6f 6e 66 2c 20 69 73 20 73 Prg.orconf, is s
1c4c0 74 6f 72 65 64 20 69 6e 20 74 68 65 20 54 72 69 tored in the Tri
1c4d0 67 67 65 72 50 72 67 2e 70 50 72 6f 67 72 61 6d ggerPrg.pProgram
1c4e0 20 76 61 72 69 61 62 6c 65 2e 0a 2a 2a 20 54 68 variable..** Th
1c4f0 65 20 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 e Parse.pTrigger
1c500 50 72 67 20 6c 69 73 74 20 6e 65 76 65 72 20 63 Prg list never c
1c510 6f 6e 74 61 69 6e 73 20 74 77 6f 20 65 6e 74 72 ontains two entr
1c520 69 65 73 20 77 69 74 68 20 74 68 65 20 73 61 6d ies with the sam
1c530 65 0a 2a 2a 20 76 61 6c 75 65 73 20 66 6f 72 20 e.** values for
1c540 62 6f 74 68 20 70 54 72 69 67 67 65 72 20 61 6e both pTrigger an
1c550 64 20 6f 72 63 6f 6e 66 2e 0a 2a 2a 0a 2a 2a 20 d orconf..**.**
1c560 54 68 65 20 54 72 69 67 67 65 72 50 72 67 2e 61 The TriggerPrg.a
1c570 43 6f 6c 6d 61 73 6b 5b 30 5d 20 76 61 72 69 61 Colmask[0] varia
1c580 62 6c 65 20 69 73 20 73 65 74 20 74 6f 20 61 20 ble is set to a
1c590 6d 61 73 6b 20 6f 66 20 6f 6c 64 2e 2a 20 63 6f mask of old.* co
1c5a0 6c 75 6d 6e 73 0a 2a 2a 20 61 63 63 65 73 73 65 lumns.** accesse
1c5b0 64 20 28 6f 72 20 73 65 74 20 74 6f 20 30 20 66 d (or set to 0 f
1c5c0 6f 72 20 74 72 69 67 67 65 72 73 20 66 69 72 65 or triggers fire
1c5d0 64 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f 66 d as a result of
1c5e0 20 49 4e 53 45 52 54 0a 2a 2a 20 73 74 61 74 65 INSERT.** state
1c5f0 6d 65 6e 74 73 29 2e 20 53 69 6d 69 6c 61 72 6c ments). Similarl
1c600 79 2c 20 74 68 65 20 54 72 69 67 67 65 72 50 72 y, the TriggerPr
1c610 67 2e 61 43 6f 6c 6d 61 73 6b 5b 31 5d 20 76 61 g.aColmask[1] va
1c620 72 69 61 62 6c 65 20 69 73 20 73 65 74 20 74 6f riable is set to
1c630 0a 2a 2a 20 61 20 6d 61 73 6b 20 6f 66 20 6e 65 .** a mask of ne
1c640 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 75 73 65 64 w.* columns used
1c650 20 62 79 20 74 68 65 20 70 72 6f 67 72 61 6d 2e by the program.
1c660 0a 2a 2f 0a 73 74 72 75 63 74 20 54 72 69 67 67 .*/.struct Trigg
1c670 65 72 50 72 67 20 7b 0a 20 20 54 72 69 67 67 65 erPrg {. Trigge
1c680 72 20 2a 70 54 72 69 67 67 65 72 3b 20 20 20 20 r *pTrigger;
1c690 20 20 2f 2a 20 54 72 69 67 67 65 72 20 74 68 69 /* Trigger thi
1c6a0 73 20 70 72 6f 67 72 61 6d 20 77 61 73 20 63 6f s program was co
1c6b0 64 65 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 54 72 ded from */. Tr
1c6c0 69 67 67 65 72 50 72 67 20 2a 70 4e 65 78 74 3b iggerPrg *pNext;
1c6d0 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 65 6e /* Next en
1c6e0 74 72 79 20 69 6e 20 50 61 72 73 65 2e 70 54 72 try in Parse.pTr
1c6f0 69 67 67 65 72 50 72 67 20 6c 69 73 74 20 2a 2f iggerPrg list */
1c700 0a 20 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 70 . SubProgram *p
1c710 50 72 6f 67 72 61 6d 3b 20 20 20 2f 2a 20 50 72 Program; /* Pr
1c720 6f 67 72 61 6d 20 69 6d 70 6c 65 6d 65 6e 74 69 ogram implementi
1c730 6e 67 20 70 54 72 69 67 67 65 72 2f 6f 72 63 6f ng pTrigger/orco
1c740 6e 66 20 2a 2f 0a 20 20 69 6e 74 20 6f 72 63 6f nf */. int orco
1c750 6e 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nf;
1c760 2f 2a 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 4f /* Default ON CO
1c770 4e 46 4c 49 43 54 20 70 6f 6c 69 63 79 20 2a 2f NFLICT policy */
1c780 0a 20 20 75 33 32 20 61 43 6f 6c 6d 61 73 6b 5b . u32 aColmask[
1c790 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 2]; /* Ma
1c7a0 73 6b 73 20 6f 66 20 6f 6c 64 2e 2a 2c 20 6e 65 sks of old.*, ne
1c7b0 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 61 63 63 65 w.* columns acce
1c7c0 73 73 65 64 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a ssed */.};../*.*
1c7d0 2a 20 54 68 65 20 79 44 62 4d 61 73 6b 20 64 61 * The yDbMask da
1c7e0 74 61 74 79 70 65 20 66 6f 72 20 74 68 65 20 62 tatype for the b
1c7f0 69 74 6d 61 73 6b 20 6f 66 20 61 6c 6c 20 61 74 itmask of all at
1c800 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73 tached databases
1c810 2e 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f ..*/.#if SQLITE_
1c820 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 33 30 0a MAX_ATTACHED>30.
1c830 20 20 74 79 70 65 64 65 66 20 75 6e 73 69 67 6e typedef unsign
1c840 65 64 20 63 68 61 72 20 79 44 62 4d 61 73 6b 5b ed char yDbMask[
1c850 28 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 54 41 (SQLITE_MAX_ATTA
1c860 43 48 45 44 2b 39 29 2f 38 5d 3b 0a 23 20 64 65 CHED+9)/8];.# de
1c870 66 69 6e 65 20 44 62 4d 61 73 6b 54 65 73 74 28 fine DbMaskTest(
1c880 4d 2c 49 29 20 20 20 20 28 28 28 4d 29 5b 28 49 M,I) (((M)[(I
1c890 29 2f 38 5d 26 28 31 3c 3c 28 28 49 29 26 37 29 )/8]&(1<<((I)&7)
1c8a0 29 29 21 3d 30 29 0a 23 20 64 65 66 69 6e 65 20 ))!=0).# define
1c8b0 44 62 4d 61 73 6b 5a 65 72 6f 28 4d 29 20 20 20 DbMaskZero(M)
1c8c0 20 20 20 6d 65 6d 73 65 74 28 28 4d 29 2c 30 2c memset((M),0,
1c8d0 73 69 7a 65 6f 66 28 4d 29 29 0a 23 20 64 65 66 sizeof(M)).# def
1c8e0 69 6e 65 20 44 62 4d 61 73 6b 53 65 74 28 4d 2c ine DbMaskSet(M,
1c8f0 49 29 20 20 20 20 20 28 4d 29 5b 28 49 29 2f 38 I) (M)[(I)/8
1c900 5d 7c 3d 28 31 3c 3c 28 28 49 29 26 37 29 29 0a ]|=(1<<((I)&7)).
1c910 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 41 # define DbMaskA
1c920 6c 6c 5a 65 72 6f 28 4d 29 20 20 20 73 71 6c 69 llZero(M) sqli
1c930 74 65 33 44 62 4d 61 73 6b 41 6c 6c 5a 65 72 6f te3DbMaskAllZero
1c940 28 4d 29 0a 23 20 64 65 66 69 6e 65 20 44 62 4d (M).# define DbM
1c950 61 73 6b 4e 6f 6e 5a 65 72 6f 28 4d 29 20 20 20 askNonZero(M)
1c960 28 73 71 6c 69 74 65 33 44 62 4d 61 73 6b 41 6c (sqlite3DbMaskAl
1c970 6c 5a 65 72 6f 28 4d 29 3d 3d 30 29 0a 23 65 6c lZero(M)==0).#el
1c980 73 65 0a 20 20 74 79 70 65 64 65 66 20 75 6e 73 se. typedef uns
1c990 69 67 6e 65 64 20 69 6e 74 20 79 44 62 4d 61 73 igned int yDbMas
1c9a0 6b 3b 0a 23 20 64 65 66 69 6e 65 20 44 62 4d 61 k;.# define DbMa
1c9b0 73 6b 54 65 73 74 28 4d 2c 49 29 20 20 20 20 28 skTest(M,I) (
1c9c0 28 28 4d 29 26 28 28 28 79 44 62 4d 61 73 6b 29 ((M)&(((yDbMask)
1c9d0 31 29 3c 3c 28 49 29 29 29 21 3d 30 29 0a 23 20 1)<<(I)))!=0).#
1c9e0 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 5a 65 72 define DbMaskZer
1c9f0 6f 28 4d 29 20 20 20 20 20 20 28 4d 29 3d 30 0a o(M) (M)=0.
1ca00 23 20 64 65 66 69 6e 65 20 44 62 4d 61 73 6b 53 # define DbMaskS
1ca10 65 74 28 4d 2c 49 29 20 20 20 20 20 28 4d 29 7c et(M,I) (M)|
1ca20 3d 28 28 28 79 44 62 4d 61 73 6b 29 31 29 3c 3c =(((yDbMask)1)<<
1ca30 28 49 29 29 0a 23 20 64 65 66 69 6e 65 20 44 62 (I)).# define Db
1ca40 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 4d 29 20 20 MaskAllZero(M)
1ca50 20 28 4d 29 3d 3d 30 0a 23 20 64 65 66 69 6e 65 (M)==0.# define
1ca60 20 44 62 4d 61 73 6b 4e 6f 6e 5a 65 72 6f 28 4d DbMaskNonZero(M
1ca70 29 20 20 20 28 4d 29 21 3d 30 0a 23 65 6e 64 69 ) (M)!=0.#endi
1ca80 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 53 51 4c 20 f../*.** An SQL
1ca90 70 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 parser context.
1caa0 20 41 20 63 6f 70 79 20 6f 66 20 74 68 69 73 20 A copy of this
1cab0 73 74 72 75 63 74 75 72 65 20 69 73 20 70 61 73 structure is pas
1cac0 73 65 64 20 74 68 72 6f 75 67 68 0a 2a 2a 20 74 sed through.** t
1cad0 68 65 20 70 61 72 73 65 72 20 61 6e 64 20 64 6f he parser and do
1cae0 77 6e 20 69 6e 74 6f 20 61 6c 6c 20 74 68 65 20 wn into all the
1caf0 70 61 72 73 65 72 20 61 63 74 69 6f 6e 20 72 6f parser action ro
1cb00 75 74 69 6e 65 20 69 6e 20 6f 72 64 65 72 20 74 utine in order t
1cb10 6f 0a 2a 2a 20 63 61 72 72 79 20 61 72 6f 75 6e o.** carry aroun
1cb20 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 d information th
1cb30 61 74 20 69 73 20 67 6c 6f 62 61 6c 20 74 6f 20 at is global to
1cb40 74 68 65 20 65 6e 74 69 72 65 20 70 61 72 73 65 the entire parse
1cb50 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 74 72 75 ..**.** The stru
1cb60 63 74 75 72 65 20 69 73 20 64 69 76 69 64 65 64 cture is divided
1cb70 20 69 6e 74 6f 20 74 77 6f 20 70 61 72 74 73 2e into two parts.
1cb80 20 20 57 68 65 6e 20 74 68 65 20 70 61 72 73 65 When the parse
1cb90 72 20 61 6e 64 20 63 6f 64 65 0a 2a 2a 20 67 65 r and code.** ge
1cba0 6e 65 72 61 74 65 20 63 61 6c 6c 20 74 68 65 6d nerate call them
1cbb0 73 65 6c 76 65 73 20 72 65 63 75 72 73 69 76 65 selves recursive
1cbc0 6c 79 2c 20 74 68 65 20 66 69 72 73 74 20 70 61 ly, the first pa
1cbd0 72 74 20 6f 66 20 74 68 65 20 73 74 72 75 63 74 rt of the struct
1cbe0 75 72 65 0a 2a 2a 20 69 73 20 63 6f 6e 73 74 61 ure.** is consta
1cbf0 6e 74 20 62 75 74 20 74 68 65 20 73 65 63 6f 6e nt but the secon
1cc00 64 20 70 61 72 74 20 69 73 20 72 65 73 65 74 20 d part is reset
1cc10 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 at the beginning
1cc20 20 61 6e 64 20 65 6e 64 20 6f 66 0a 2a 2a 20 65 and end of.** e
1cc30 61 63 68 20 72 65 63 75 72 73 69 6f 6e 2e 0a 2a ach recursion..*
1cc40 2a 0a 2a 2a 20 54 68 65 20 6e 54 61 62 6c 65 4c *.** The nTableL
1cc50 6f 63 6b 20 61 6e 64 20 61 54 61 62 6c 65 4c 6f ock and aTableLo
1cc60 63 6b 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 ck variables are
1cc70 20 6f 6e 6c 79 20 75 73 65 64 20 69 66 20 74 68 only used if th
1cc80 65 20 73 68 61 72 65 64 2d 63 61 63 68 65 0a 2a e shared-cache.*
1cc90 2a 20 66 65 61 74 75 72 65 20 69 73 20 65 6e 61 * feature is ena
1cca0 62 6c 65 64 20 28 69 66 20 73 71 6c 69 74 65 33 bled (if sqlite3
1ccb0 54 73 64 28 29 2d 3e 75 73 65 53 68 61 72 65 64 Tsd()->useShared
1ccc0 44 61 74 61 20 69 73 20 74 72 75 65 29 2e 20 54 Data is true). T
1ccd0 68 65 79 20 61 72 65 0a 2a 2a 20 75 73 65 64 20 hey are.** used
1cce0 74 6f 20 73 74 6f 72 65 20 74 68 65 20 73 65 74 to store the set
1ccf0 20 6f 66 20 74 61 62 6c 65 2d 6c 6f 63 6b 73 20 of table-locks
1cd00 72 65 71 75 69 72 65 64 20 62 79 20 74 68 65 20 required by the
1cd10 73 74 61 74 65 6d 65 6e 74 20 62 65 69 6e 67 0a statement being.
1cd20 2a 2a 20 63 6f 6d 70 69 6c 65 64 2e 20 46 75 6e ** compiled. Fun
1cd30 63 74 69 6f 6e 20 73 71 6c 69 74 65 33 54 61 62 ction sqlite3Tab
1cd40 6c 65 4c 6f 63 6b 28 29 20 69 73 20 75 73 65 64 leLock() is used
1cd50 20 74 6f 20 61 64 64 20 65 6e 74 72 69 65 73 20 to add entries
1cd60 74 6f 20 74 68 65 0a 2a 2a 20 6c 69 73 74 2e 0a to the.** list..
1cd70 2a 2f 0a 73 74 72 75 63 74 20 50 61 72 73 65 20 */.struct Parse
1cd80 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b {. sqlite3 *db;
1cd90 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
1cda0 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 73 74 main database st
1cdb0 72 75 63 74 75 72 65 20 2a 2f 0a 20 20 63 68 61 ructure */. cha
1cdc0 72 20 2a 7a 45 72 72 4d 73 67 3b 20 20 20 20 20 r *zErrMsg;
1cdd0 20 20 2f 2a 20 41 6e 20 65 72 72 6f 72 20 6d 65 /* An error me
1cde0 73 73 61 67 65 20 2a 2f 0a 20 20 56 64 62 65 20 ssage */. Vdbe
1cdf0 2a 70 56 64 62 65 3b 20 20 20 20 20 20 20 20 20 *pVdbe;
1ce00 2f 2a 20 41 6e 20 65 6e 67 69 6e 65 20 66 6f 72 /* An engine for
1ce10 20 65 78 65 63 75 74 69 6e 67 20 64 61 74 61 62 executing datab
1ce20 61 73 65 20 62 79 74 65 63 6f 64 65 20 2a 2f 0a ase bytecode */.
1ce30 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
1ce40 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e /* Return
1ce50 20 63 6f 64 65 20 66 72 6f 6d 20 65 78 65 63 75 code from execu
1ce60 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 63 6f 6c tion */. u8 col
1ce70 4e 61 6d 65 73 53 65 74 3b 20 20 20 20 20 20 2f NamesSet; /
1ce80 2a 20 54 52 55 45 20 61 66 74 65 72 20 4f 50 5f * TRUE after OP_
1ce90 43 6f 6c 75 6d 6e 4e 61 6d 65 20 68 61 73 20 62 ColumnName has b
1cea0 65 65 6e 20 69 73 73 75 65 64 20 74 6f 20 70 56 een issued to pV
1ceb0 64 62 65 20 2a 2f 0a 20 20 75 38 20 63 68 65 63 dbe */. u8 chec
1cec0 6b 53 63 68 65 6d 61 3b 20 20 20 20 20 20 2f 2a kSchema; /*
1ced0 20 43 61 75 73 65 73 20 73 63 68 65 6d 61 20 63 Causes schema c
1cee0 6f 6f 6b 69 65 20 63 68 65 63 6b 20 61 66 74 65 ookie check afte
1cef0 72 20 61 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 r an error */.
1cf00 75 38 20 6e 65 73 74 65 64 3b 20 20 20 20 20 20 u8 nested;
1cf10 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1cf20 66 20 6e 65 73 74 65 64 20 63 61 6c 6c 73 20 74 f nested calls t
1cf30 6f 20 74 68 65 20 70 61 72 73 65 72 2f 63 6f 64 o the parser/cod
1cf40 65 20 67 65 6e 65 72 61 74 6f 72 20 2a 2f 0a 20 e generator */.
1cf50 20 75 38 20 6e 54 65 6d 70 52 65 67 3b 20 20 20 u8 nTempReg;
1cf60 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
1cf70 6f 66 20 74 65 6d 70 6f 72 61 72 79 20 72 65 67 of temporary reg
1cf80 69 73 74 65 72 73 20 69 6e 20 61 54 65 6d 70 52 isters in aTempR
1cf90 65 67 5b 5d 20 2a 2f 0a 20 20 75 38 20 69 73 4d eg[] */. u8 isM
1cfa0 75 6c 74 69 57 72 69 74 65 3b 20 20 20 20 20 2f ultiWrite; /
1cfb0 2a 20 54 72 75 65 20 69 66 20 73 74 61 74 65 6d * True if statem
1cfc0 65 6e 74 20 6d 61 79 20 6d 6f 64 69 66 79 2f 69 ent may modify/i
1cfd0 6e 73 65 72 74 20 6d 75 6c 74 69 70 6c 65 20 72 nsert multiple r
1cfe0 6f 77 73 20 2a 2f 0a 20 20 75 38 20 6d 61 79 41 ows */. u8 mayA
1cff0 62 6f 72 74 3b 20 20 20 20 20 20 20 20 20 2f 2a bort; /*
1d000 20 54 72 75 65 20 69 66 20 73 74 61 74 65 6d 65 True if stateme
1d010 6e 74 20 6d 61 79 20 74 68 72 6f 77 20 61 6e 20 nt may throw an
1d020 41 42 4f 52 54 20 65 78 63 65 70 74 69 6f 6e 20 ABORT exception
1d030 2a 2f 0a 20 20 75 38 20 68 61 73 43 6f 6d 70 6f */. u8 hasCompo
1d040 75 6e 64 3b 20 20 20 20 20 20 2f 2a 20 4e 65 65 und; /* Nee
1d050 64 20 74 6f 20 69 6e 76 6f 6b 65 20 63 6f 6e 76 d to invoke conv
1d060 65 72 74 43 6f 6d 70 6f 75 6e 64 53 65 6c 65 63 ertCompoundSelec
1d070 74 54 6f 53 75 62 71 75 65 72 79 28 29 20 2a 2f tToSubquery() */
1d080 0a 20 20 75 38 20 6f 6b 43 6f 6e 73 74 46 61 63 . u8 okConstFac
1d090 74 6f 72 3b 20 20 20 20 2f 2a 20 4f 4b 20 74 6f tor; /* OK to
1d0a0 20 66 61 63 74 6f 72 20 6f 75 74 20 63 6f 6e 73 factor out cons
1d0b0 74 61 6e 74 73 20 2a 2f 0a 20 20 75 38 20 64 69 tants */. u8 di
1d0c0 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b 20 sableLookaside;
1d0d0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 69 6d /* Number of tim
1d0e0 65 73 20 6c 6f 6f 6b 61 73 69 64 65 20 68 61 73 es lookaside has
1d0f0 20 62 65 65 6e 20 64 69 73 61 62 6c 65 64 20 2a been disabled *
1d100 2f 0a 20 20 69 6e 74 20 61 54 65 6d 70 52 65 67 /. int aTempReg
1d110 5b 38 5d 3b 20 20 20 20 20 2f 2a 20 48 6f 6c 64 [8]; /* Hold
1d120 69 6e 67 20 61 72 65 61 20 66 6f 72 20 74 65 6d ing area for tem
1d130 70 6f 72 61 72 79 20 72 65 67 69 73 74 65 72 73 porary registers
1d140 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 61 6e 67 65 */. int nRange
1d150 52 65 67 3b 20 20 20 20 20 20 20 2f 2a 20 53 69 Reg; /* Si
1d160 7a 65 20 6f 66 20 74 68 65 20 74 65 6d 70 6f 72 ze of the tempor
1d170 61 72 79 20 72 65 67 69 73 74 65 72 20 62 6c 6f ary register blo
1d180 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 69 52 61 6e ck */. int iRan
1d190 67 65 52 65 67 3b 20 20 20 20 20 20 20 2f 2a 20 geReg; /*
1d1a0 46 69 72 73 74 20 72 65 67 69 73 74 65 72 20 69 First register i
1d1b0 6e 20 74 65 6d 70 6f 72 61 72 79 20 72 65 67 69 n temporary regi
1d1c0 73 74 65 72 20 62 6c 6f 63 6b 20 2a 2f 0a 20 20 ster block */.
1d1d0 69 6e 74 20 6e 45 72 72 3b 20 20 20 20 20 20 20 int nErr;
1d1e0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
1d1f0 66 20 65 72 72 6f 72 73 20 73 65 65 6e 20 2a 2f f errors seen */
1d200 0a 20 20 69 6e 74 20 6e 54 61 62 3b 20 20 20 20 . int nTab;
1d210 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1d220 72 20 6f 66 20 70 72 65 76 69 6f 75 73 6c 79 20 r of previously
1d230 61 6c 6c 6f 63 61 74 65 64 20 56 44 42 45 20 63 allocated VDBE c
1d240 75 72 73 6f 72 73 20 2a 2f 0a 20 20 69 6e 74 20 ursors */. int
1d250 6e 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 nMem;
1d260 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6d 65 /* Number of me
1d270 6d 6f 72 79 20 63 65 6c 6c 73 20 75 73 65 64 20 mory cells used
1d280 73 6f 20 66 61 72 20 2a 2f 0a 20 20 69 6e 74 20 so far */. int
1d290 6e 53 65 74 3b 20 20 20 20 20 20 20 20 20 20 20 nSet;
1d2a0 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 65 /* Number of se
1d2b0 74 73 20 75 73 65 64 20 73 6f 20 66 61 72 20 2a ts used so far *
1d2c0 2f 0a 20 20 69 6e 74 20 6e 4f 6e 63 65 3b 20 20 /. int nOnce;
1d2d0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1d2e0 65 72 20 6f 66 20 4f 50 5f 4f 6e 63 65 20 69 6e er of OP_Once in
1d2f0 73 74 72 75 63 74 69 6f 6e 73 20 73 6f 20 66 61 structions so fa
1d300 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 70 41 6c r */. int nOpAl
1d310 6c 6f 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e loc; /* N
1d320 75 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 61 umber of slots a
1d330 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 56 64 62 llocated for Vdb
1d340 65 2e 61 4f 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 e.aOp[] */. int
1d350 20 73 7a 4f 70 41 6c 6c 6f 63 3b 20 20 20 20 20 szOpAlloc;
1d360 20 20 2f 2a 20 42 79 74 65 73 20 6f 66 20 6d 65 /* Bytes of me
1d370 6d 6f 72 79 20 73 70 61 63 65 20 61 6c 6c 6f 63 mory space alloc
1d380 61 74 65 64 20 66 6f 72 20 56 64 62 65 2e 61 4f ated for Vdbe.aO
1d390 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 46 69 p[] */. int iFi
1d3a0 78 65 64 4f 70 3b 20 20 20 20 20 20 20 20 2f 2a xedOp; /*
1d3b0 20 4e 65 76 65 72 20 62 61 63 6b 20 6f 75 74 20 Never back out
1d3c0 6f 70 63 6f 64 65 73 20 69 46 69 78 65 64 4f 70 opcodes iFixedOp
1d3d0 2d 31 20 6f 72 20 65 61 72 6c 69 65 72 20 2a 2f -1 or earlier */
1d3e0 0a 20 20 69 6e 74 20 63 6b 42 61 73 65 3b 20 20 . int ckBase;
1d3f0 20 20 20 20 20 20 20 20 2f 2a 20 42 61 73 65 20 /* Base
1d400 72 65 67 69 73 74 65 72 20 6f 66 20 64 61 74 61 register of data
1d410 20 64 75 72 69 6e 67 20 63 68 65 63 6b 20 63 6f during check co
1d420 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 20 20 69 nstraints */. i
1d430 6e 74 20 69 53 65 6c 66 54 61 62 3b 20 20 20 20 nt iSelfTab;
1d440 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 6f 66 20 /* Table of
1d450 61 6e 20 69 6e 64 65 78 20 77 68 6f 73 65 20 65 an index whose e
1d460 78 70 72 73 20 61 72 65 20 62 65 69 6e 67 20 63 xprs are being c
1d470 6f 64 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 43 oded */. int iC
1d480 61 63 68 65 4c 65 76 65 6c 3b 20 20 20 20 20 2f acheLevel; /
1d490 2a 20 43 6f 6c 43 61 63 68 65 20 76 61 6c 69 64 * ColCache valid
1d4a0 20 77 68 65 6e 20 61 43 6f 6c 43 61 63 68 65 5b when aColCache[
1d4b0 5d 2e 69 4c 65 76 65 6c 3c 3d 69 43 61 63 68 65 ].iLevel<=iCache
1d4c0 4c 65 76 65 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 Level */. int i
1d4d0 43 61 63 68 65 43 6e 74 3b 20 20 20 20 20 20 20 CacheCnt;
1d4e0 2f 2a 20 43 6f 75 6e 74 65 72 20 75 73 65 64 20 /* Counter used
1d4f0 74 6f 20 67 65 6e 65 72 61 74 65 20 61 43 6f 6c to generate aCol
1d500 43 61 63 68 65 5b 5d 2e 6c 72 75 20 76 61 6c 75 Cache[].lru valu
1d510 65 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 es */. int nLab
1d520 65 6c 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 el; /*
1d530 4e 75 6d 62 65 72 20 6f 66 20 6c 61 62 65 6c 73 Number of labels
1d540 20 75 73 65 64 20 2a 2f 0a 20 20 69 6e 74 20 2a used */. int *
1d550 61 4c 61 62 65 6c 3b 20 20 20 20 20 20 20 20 20 aLabel;
1d560 2f 2a 20 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 /* Space to hold
1d570 20 74 68 65 20 6c 61 62 65 6c 73 20 2a 2f 0a 20 the labels */.
1d580 20 73 74 72 75 63 74 20 79 43 6f 6c 43 61 63 68 struct yColCach
1d590 65 20 7b 0a 20 20 20 20 69 6e 74 20 69 54 61 62 e {. int iTab
1d5a0 6c 65 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a le; /*
1d5b0 20 54 61 62 6c 65 20 63 75 72 73 6f 72 20 6e 75 Table cursor nu
1d5c0 6d 62 65 72 20 2a 2f 0a 20 20 20 20 69 31 36 20 mber */. i16
1d5d0 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 iColumn;
1d5e0 20 20 2f 2a 20 54 61 62 6c 65 20 63 6f 6c 75 6d /* Table colum
1d5f0 6e 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 20 20 n number */.
1d600 75 38 20 74 65 6d 70 52 65 67 3b 20 20 20 20 20 u8 tempReg;
1d610 20 20 20 20 20 20 2f 2a 20 69 52 65 67 20 69 73 /* iReg is
1d620 20 61 20 74 65 6d 70 20 72 65 67 69 73 74 65 72 a temp register
1d630 20 74 68 61 74 20 6e 65 65 64 73 20 74 6f 20 62 that needs to b
1d640 65 20 66 72 65 65 64 20 2a 2f 0a 20 20 20 20 69 e freed */. i
1d650 6e 74 20 69 4c 65 76 65 6c 3b 20 20 20 20 20 20 nt iLevel;
1d660 20 20 20 20 20 2f 2a 20 4e 65 73 74 69 6e 67 20 /* Nesting
1d670 6c 65 76 65 6c 20 2a 2f 0a 20 20 20 20 69 6e 74 level */. int
1d680 20 69 52 65 67 3b 20 20 20 20 20 20 20 20 20 20 iReg;
1d690 20 20 20 2f 2a 20 52 65 67 20 77 69 74 68 20 76 /* Reg with v
1d6a0 61 6c 75 65 20 6f 66 20 74 68 69 73 20 63 6f 6c alue of this col
1d6b0 75 6d 6e 2e 20 30 20 6d 65 61 6e 73 20 6e 6f 6e umn. 0 means non
1d6c0 65 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6c 72 e. */. int lr
1d6d0 75 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 u;
1d6e0 2f 2a 20 4c 65 61 73 74 20 72 65 63 65 6e 74 6c /* Least recentl
1d6f0 79 20 75 73 65 64 20 65 6e 74 72 79 20 68 61 73 y used entry has
1d700 20 74 68 65 20 73 6d 61 6c 6c 65 73 74 20 76 61 the smallest va
1d710 6c 75 65 20 2a 2f 0a 20 20 7d 20 61 43 6f 6c 43 lue */. } aColC
1d720 61 63 68 65 5b 53 51 4c 49 54 45 5f 4e 5f 43 4f ache[SQLITE_N_CO
1d730 4c 43 41 43 48 45 5d 3b 20 20 2f 2a 20 4f 6e 65 LCACHE]; /* One
1d740 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e for each column
1d750 20 63 61 63 68 65 20 65 6e 74 72 79 20 2a 2f 0a cache entry */.
1d760 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 6f 6e ExprList *pCon
1d770 73 74 45 78 70 72 3b 2f 2a 20 43 6f 6e 73 74 61 stExpr;/* Consta
1d780 6e 74 20 65 78 70 72 65 73 73 69 6f 6e 73 20 2a nt expressions *
1d790 2f 0a 20 20 54 6f 6b 65 6e 20 63 6f 6e 73 74 72 /. Token constr
1d7a0 61 69 6e 74 4e 61 6d 65 3b 2f 2a 20 4e 61 6d 65 aintName;/* Name
1d7b0 20 6f 66 20 74 68 65 20 63 6f 6e 73 74 72 61 69 of the constrai
1d7c0 6e 74 20 63 75 72 72 65 6e 74 6c 79 20 62 65 69 nt currently bei
1d7d0 6e 67 20 70 61 72 73 65 64 20 2a 2f 0a 20 20 79 ng parsed */. y
1d7e0 44 62 4d 61 73 6b 20 77 72 69 74 65 4d 61 73 6b DbMask writeMask
1d7f0 3b 20 20 20 2f 2a 20 53 74 61 72 74 20 61 20 77 ; /* Start a w
1d800 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e rite transaction
1d810 20 6f 6e 20 74 68 65 73 65 20 64 61 74 61 62 61 on these databa
1d820 73 65 73 20 2a 2f 0a 20 20 79 44 62 4d 61 73 6b ses */. yDbMask
1d830 20 63 6f 6f 6b 69 65 4d 61 73 6b 3b 20 20 2f 2a cookieMask; /*
1d840 20 42 69 74 6d 61 73 6b 20 6f 66 20 73 63 68 65 Bitmask of sche
1d850 6d 61 20 76 65 72 69 66 69 65 64 20 64 61 74 61 ma verified data
1d860 62 61 73 65 73 20 2a 2f 0a 20 20 69 6e 74 20 63 bases */. int c
1d870 6f 6f 6b 69 65 56 61 6c 75 65 5b 53 51 4c 49 54 ookieValue[SQLIT
1d880 45 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 2b 32 E_MAX_ATTACHED+2
1d890 5d 3b 20 20 2f 2a 20 56 61 6c 75 65 73 20 6f 66 ]; /* Values of
1d8a0 20 63 6f 6f 6b 69 65 73 20 74 6f 20 76 65 72 69 cookies to veri
1d8b0 66 79 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 52 fy */. int regR
1d8c0 6f 77 69 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 owid; /*
1d8d0 52 65 67 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 Register holding
1d8e0 20 72 6f 77 69 64 20 6f 66 20 43 52 45 41 54 45 rowid of CREATE
1d8f0 20 54 41 42 4c 45 20 65 6e 74 72 79 20 2a 2f 0a TABLE entry */.
1d900 20 20 69 6e 74 20 72 65 67 52 6f 6f 74 3b 20 20 int regRoot;
1d910 20 20 20 20 20 20 20 2f 2a 20 52 65 67 69 73 74 /* Regist
1d920 65 72 20 68 6f 6c 64 69 6e 67 20 72 6f 6f 74 20 er holding root
1d930 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 page number for
1d940 6e 65 77 20 6f 62 6a 65 63 74 73 20 2a 2f 0a 20 new objects */.
1d950 20 69 6e 74 20 6e 4d 61 78 41 72 67 3b 20 20 20 int nMaxArg;
1d960 20 20 20 20 20 20 2f 2a 20 4d 61 78 20 61 72 67 /* Max arg
1d970 73 20 70 61 73 73 65 64 20 74 6f 20 75 73 65 72 s passed to user
1d980 20 66 75 6e 63 74 69 6f 6e 20 62 79 20 73 75 62 function by sub
1d990 2d 70 72 6f 67 72 61 6d 20 2a 2f 0a 23 69 66 20 -program */.#if
1d9a0 53 45 4c 45 43 54 54 52 41 43 45 5f 45 4e 41 42 SELECTTRACE_ENAB
1d9b0 4c 45 44 0a 20 20 69 6e 74 20 6e 53 65 6c 65 63 LED. int nSelec
1d9c0 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 t; /* Nu
1d9d0 6d 62 65 72 20 6f 66 20 53 45 4c 45 43 54 20 73 mber of SELECT s
1d9e0 74 61 74 65 6d 65 6e 74 73 20 73 65 65 6e 20 2a tatements seen *
1d9f0 2f 0a 20 20 69 6e 74 20 6e 53 65 6c 65 63 74 49 /. int nSelectI
1da00 6e 64 65 6e 74 3b 20 20 20 2f 2a 20 48 6f 77 20 ndent; /* How
1da10 66 61 72 20 74 6f 20 69 6e 64 65 6e 74 20 53 45 far to indent SE
1da20 4c 45 43 54 54 52 41 43 45 28 29 20 6f 75 74 70 LECTTRACE() outp
1da30 75 74 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 66 ut */.#endif.#if
1da40 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
1da50 5f 53 48 41 52 45 44 5f 43 41 43 48 45 0a 20 20 _SHARED_CACHE.
1da60 69 6e 74 20 6e 54 61 62 6c 65 4c 6f 63 6b 3b 20 int nTableLock;
1da70 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1da80 20 6f 66 20 6c 6f 63 6b 73 20 69 6e 20 61 54 61 of locks in aTa
1da90 62 6c 65 4c 6f 63 6b 20 2a 2f 0a 20 20 54 61 62 bleLock */. Tab
1daa0 6c 65 4c 6f 63 6b 20 2a 61 54 61 62 6c 65 4c 6f leLock *aTableLo
1dab0 63 6b 3b 20 2f 2a 20 52 65 71 75 69 72 65 64 20 ck; /* Required
1dac0 74 61 62 6c 65 20 6c 6f 63 6b 73 20 66 6f 72 20 table locks for
1dad0 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d 6f 64 shared-cache mod
1dae0 65 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 41 75 e */.#endif. Au
1daf0 74 6f 69 6e 63 49 6e 66 6f 20 2a 70 41 69 6e 63 toincInfo *pAinc
1db00 3b 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f ; /* Informatio
1db10 6e 20 61 62 6f 75 74 20 41 55 54 4f 49 4e 43 52 n about AUTOINCR
1db20 45 4d 45 4e 54 20 63 6f 75 6e 74 65 72 73 20 2a EMENT counters *
1db30 2f 0a 0a 20 20 2f 2a 20 49 6e 66 6f 72 6d 61 74 /.. /* Informat
1db40 69 6f 6e 20 75 73 65 64 20 77 68 69 6c 65 20 63 ion used while c
1db50 6f 64 69 6e 67 20 74 72 69 67 67 65 72 20 70 72 oding trigger pr
1db60 6f 67 72 61 6d 73 2e 20 2a 2f 0a 20 20 50 61 72 ograms. */. Par
1db70 73 65 20 2a 70 54 6f 70 6c 65 76 65 6c 3b 20 20 se *pToplevel;
1db80 20 20 2f 2a 20 50 61 72 73 65 20 73 74 72 75 63 /* Parse struc
1db90 74 75 72 65 20 66 6f 72 20 6d 61 69 6e 20 70 72 ture for main pr
1dba0 6f 67 72 61 6d 20 28 6f 72 20 4e 55 4c 4c 29 20 ogram (or NULL)
1dbb0 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 72 69 */. Table *pTri
1dbc0 67 67 65 72 54 61 62 3b 20 20 2f 2a 20 54 61 62 ggerTab; /* Tab
1dbd0 6c 65 20 74 72 69 67 67 65 72 73 20 61 72 65 20 le triggers are
1dbe0 62 65 69 6e 67 20 63 6f 64 65 64 20 66 6f 72 20 being coded for
1dbf0 2a 2f 0a 20 20 69 6e 74 20 61 64 64 72 43 72 54 */. int addrCrT
1dc00 61 62 3b 20 20 20 20 20 20 20 2f 2a 20 41 64 64 ab; /* Add
1dc10 72 65 73 73 20 6f 66 20 4f 50 5f 43 72 65 61 74 ress of OP_Creat
1dc20 65 54 61 62 6c 65 20 6f 70 63 6f 64 65 20 6f 6e eTable opcode on
1dc30 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 2a 2f CREATE TABLE */
1dc40 0a 20 20 75 33 32 20 6e 51 75 65 72 79 4c 6f 6f . u32 nQueryLoo
1dc50 70 3b 20 20 20 20 20 20 2f 2a 20 45 73 74 20 6e p; /* Est n
1dc60 75 6d 62 65 72 20 6f 66 20 69 74 65 72 61 74 69 umber of iterati
1dc70 6f 6e 73 20 6f 66 20 61 20 71 75 65 72 79 20 28 ons of a query (
1dc80 31 30 2a 6c 6f 67 32 28 4e 29 29 20 2a 2f 0a 20 10*log2(N)) */.
1dc90 20 75 33 32 20 6f 6c 64 6d 61 73 6b 3b 20 20 20 u32 oldmask;
1dca0 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 /* Mask of
1dcb0 20 6f 6c 64 2e 2a 20 63 6f 6c 75 6d 6e 73 20 72 old.* columns r
1dcc0 65 66 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 75 eferenced */. u
1dcd0 33 32 20 6e 65 77 6d 61 73 6b 3b 20 20 20 20 20 32 newmask;
1dce0 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 6e /* Mask of n
1dcf0 65 77 2e 2a 20 63 6f 6c 75 6d 6e 73 20 72 65 66 ew.* columns ref
1dd00 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 75 38 20 erenced */. u8
1dd10 65 54 72 69 67 67 65 72 4f 70 3b 20 20 20 20 20 eTriggerOp;
1dd20 20 20 2f 2a 20 54 4b 5f 55 50 44 41 54 45 2c 20 /* TK_UPDATE,
1dd30 54 4b 5f 49 4e 53 45 52 54 20 6f 72 20 54 4b 5f TK_INSERT or TK_
1dd40 44 45 4c 45 54 45 20 2a 2f 0a 20 20 75 38 20 65 DELETE */. u8 e
1dd50 4f 72 63 6f 6e 66 3b 20 20 20 20 20 20 20 20 20 Orconf;
1dd60 20 2f 2a 20 44 65 66 61 75 6c 74 20 4f 4e 20 43 /* Default ON C
1dd70 4f 4e 46 4c 49 43 54 20 70 6f 6c 69 63 79 20 66 ONFLICT policy f
1dd80 6f 72 20 74 72 69 67 67 65 72 20 73 74 65 70 73 or trigger steps
1dd90 20 2a 2f 0a 20 20 75 38 20 64 69 73 61 62 6c 65 */. u8 disable
1dda0 54 72 69 67 67 65 72 73 3b 20 20 2f 2a 20 54 72 Triggers; /* Tr
1ddb0 75 65 20 74 6f 20 64 69 73 61 62 6c 65 20 74 72 ue to disable tr
1ddc0 69 67 67 65 72 73 20 2a 2f 0a 0a 20 20 2f 2a 2a iggers */.. /**
1ddd0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1dde0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1ddf0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1de00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1de10 2a 2a 2a 2a 2a 2a 0a 20 20 2a 2a 20 41 62 6f 76 ******. ** Abov
1de20 65 20 69 73 20 63 6f 6e 73 74 61 6e 74 20 62 65 e is constant be
1de30 74 77 65 65 6e 20 72 65 63 75 72 73 69 6f 6e 73 tween recursions
1de40 2e 20 20 42 65 6c 6f 77 20 69 73 20 72 65 73 65 . Below is rese
1de50 74 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 t before and aft
1de60 65 72 0a 20 20 2a 2a 20 65 61 63 68 20 72 65 63 er. ** each rec
1de70 75 72 73 69 6f 6e 2e 20 20 54 68 65 20 62 6f 75 ursion. The bou
1de80 6e 64 61 72 79 20 62 65 74 77 65 65 6e 20 74 68 ndary between th
1de90 65 73 65 20 74 77 6f 20 72 65 67 69 6f 6e 73 20 ese two regions
1dea0 69 73 20 64 65 74 65 72 6d 69 6e 65 64 0a 20 20 is determined.
1deb0 2a 2a 20 75 73 69 6e 67 20 6f 66 66 73 65 74 6f ** using offseto
1dec0 66 28 50 61 72 73 65 2c 6e 56 61 72 29 20 73 6f f(Parse,nVar) so
1ded0 20 74 68 65 20 6e 56 61 72 20 66 69 65 6c 64 20 the nVar field
1dee0 6d 75 73 74 20 62 65 20 74 68 65 20 66 69 72 73 must be the firs
1def0 74 20 66 69 65 6c 64 0a 20 20 2a 2a 20 69 6e 20 t field. ** in
1df00 74 68 65 20 72 65 63 75 72 73 69 76 65 20 72 65 the recursive re
1df10 67 69 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a gion.. ********
1df20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1df30 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1df40 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1df50 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1df60 2f 0a 0a 20 20 79 6e 56 61 72 20 6e 56 61 72 3b /.. ynVar nVar;
1df70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1df80 2a 20 4e 75 6d 62 65 72 20 6f 66 20 27 3f 27 20 * Number of '?'
1df90 76 61 72 69 61 62 6c 65 73 20 73 65 65 6e 20 69 variables seen i
1dfa0 6e 20 74 68 65 20 53 51 4c 20 73 6f 20 66 61 72 n the SQL so far
1dfb0 20 2a 2f 0a 20 20 69 6e 74 20 6e 7a 56 61 72 3b */. int nzVar;
1dfc0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dfd0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 76 61 /* Number of ava
1dfe0 69 6c 61 62 6c 65 20 73 6c 6f 74 73 20 69 6e 20 ilable slots in
1dff0 61 7a 56 61 72 5b 5d 20 2a 2f 0a 20 20 75 38 20 azVar[] */. u8
1e000 69 50 6b 53 6f 72 74 4f 72 64 65 72 3b 20 20 20 iPkSortOrder;
1e010 20 20 20 20 20 20 20 2f 2a 20 41 53 43 20 6f 72 /* ASC or
1e020 20 44 45 53 43 20 66 6f 72 20 49 4e 54 45 47 45 DESC for INTEGE
1e030 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 2a 2f R PRIMARY KEY */
1e040 0a 20 20 75 38 20 65 78 70 6c 61 69 6e 3b 20 20 . u8 explain;
1e050 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1e060 54 72 75 65 20 69 66 20 74 68 65 20 45 58 50 4c True if the EXPL
1e070 41 49 4e 20 66 6c 61 67 20 69 73 20 66 6f 75 6e AIN flag is foun
1e080 64 20 6f 6e 20 74 68 65 20 71 75 65 72 79 20 2a d on the query *
1e090 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 /.#ifndef SQLITE
1e0a0 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
1e0b0 4c 45 0a 20 20 75 38 20 64 65 63 6c 61 72 65 56 LE. u8 declareV
1e0c0 74 61 62 3b 20 20 20 20 20 20 20 20 20 20 20 2f tab; /
1e0d0 2a 20 54 72 75 65 20 69 66 20 69 6e 73 69 64 65 * True if inside
1e0e0 20 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 sqlite3_declare
1e0f0 5f 76 74 61 62 28 29 20 2a 2f 0a 20 20 69 6e 74 _vtab() */. int
1e100 20 6e 56 74 61 62 4c 6f 63 6b 3b 20 20 20 20 20 nVtabLock;
1e110 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1e120 20 6f 66 20 76 69 72 74 75 61 6c 20 74 61 62 6c of virtual tabl
1e130 65 73 20 74 6f 20 6c 6f 63 6b 20 2a 2f 0a 23 65 es to lock */.#e
1e140 6e 64 69 66 0a 20 20 69 6e 74 20 6e 41 6c 69 61 ndif. int nAlia
1e150 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s;
1e160 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 6c /* Number of al
1e170 69 61 73 65 64 20 72 65 73 75 6c 74 20 73 65 74 iased result set
1e180 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 69 6e columns */. in
1e190 74 20 6e 48 65 69 67 68 74 3b 20 20 20 20 20 20 t nHeight;
1e1a0 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 /* Expre
1e1b0 73 73 69 6f 6e 20 74 72 65 65 20 68 65 69 67 68 ssion tree heigh
1e1c0 74 20 6f 66 20 63 75 72 72 65 6e 74 20 73 75 62 t of current sub
1e1d0 2d 73 65 6c 65 63 74 20 2a 2f 0a 23 69 66 6e 64 -select */.#ifnd
1e1e0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 ef SQLITE_OMIT_E
1e1f0 58 50 4c 41 49 4e 0a 20 20 69 6e 74 20 69 53 65 XPLAIN. int iSe
1e200 6c 65 63 74 49 64 3b 20 20 20 20 20 20 20 20 20 lectId;
1e210 20 20 20 2f 2a 20 49 44 20 6f 66 20 63 75 72 72 /* ID of curr
1e220 65 6e 74 20 73 65 6c 65 63 74 20 66 6f 72 20 45 ent select for E
1e230 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 20 2a 2f XPLAIN output */
1e240 0a 20 20 69 6e 74 20 69 4e 65 78 74 53 65 6c 65 . int iNextSele
1e250 63 74 49 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 ctId; /*
1e260 4e 65 78 74 20 61 76 61 69 6c 61 62 6c 65 20 73 Next available s
1e270 65 6c 65 63 74 20 49 44 20 66 6f 72 20 45 58 50 elect ID for EXP
1e280 4c 41 49 4e 20 6f 75 74 70 75 74 20 2a 2f 0a 23 LAIN output */.#
1e290 65 6e 64 69 66 0a 20 20 63 68 61 72 20 2a 2a 61 endif. char **a
1e2a0 7a 56 61 72 3b 20 20 20 20 20 20 20 20 20 20 20 zVar;
1e2b0 20 20 2f 2a 20 50 6f 69 6e 74 65 72 73 20 74 6f /* Pointers to
1e2c0 20 6e 61 6d 65 73 20 6f 66 20 70 61 72 61 6d 65 names of parame
1e2d0 74 65 72 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a ters */. Vdbe *
1e2e0 70 52 65 70 72 65 70 61 72 65 3b 20 20 20 20 20 pReprepare;
1e2f0 20 20 20 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 /* VM being
1e300 72 65 70 72 65 70 61 72 65 64 20 28 73 71 6c 69 reprepared (sqli
1e310 74 65 33 52 65 70 72 65 70 61 72 65 28 29 29 20 te3Reprepare())
1e320 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
1e330 2a 7a 54 61 69 6c 3b 20 20 20 20 20 20 20 20 2f *zTail; /
1e340 2a 20 41 6c 6c 20 53 51 4c 20 74 65 78 74 20 70 * All SQL text p
1e350 61 73 74 20 74 68 65 20 6c 61 73 74 20 73 65 6d ast the last sem
1e360 69 63 6f 6c 6f 6e 20 70 61 72 73 65 64 20 2a 2f icolon parsed */
1e370 0a 20 20 54 61 62 6c 65 20 2a 70 4e 65 77 54 61 . Table *pNewTa
1e380 62 6c 65 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ble; /*
1e390 41 20 74 61 62 6c 65 20 62 65 69 6e 67 20 63 6f A table being co
1e3a0 6e 73 74 72 75 63 74 65 64 20 62 79 20 43 52 45 nstructed by CRE
1e3b0 41 54 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 54 ATE TABLE */. T
1e3c0 72 69 67 67 65 72 20 2a 70 4e 65 77 54 72 69 67 rigger *pNewTrig
1e3d0 67 65 72 3b 20 20 20 20 20 2f 2a 20 54 72 69 67 ger; /* Trig
1e3e0 67 65 72 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 ger under constr
1e3f0 75 63 74 20 62 79 20 61 20 43 52 45 41 54 45 20 uct by a CREATE
1e400 54 52 49 47 47 45 52 20 2a 2f 0a 20 20 63 6f 6e TRIGGER */. con
1e410 73 74 20 63 68 61 72 20 2a 7a 41 75 74 68 43 6f st char *zAuthCo
1e420 6e 74 65 78 74 3b 20 2f 2a 20 54 68 65 20 36 74 ntext; /* The 6t
1e430 68 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 64 h parameter to d
1e440 62 2d 3e 78 41 75 74 68 20 63 61 6c 6c 62 61 63 b->xAuth callbac
1e450 6b 73 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 73 4e ks */. Token sN
1e460 61 6d 65 54 6f 6b 65 6e 3b 20 20 20 20 20 20 20 ameToken;
1e470 20 20 2f 2a 20 54 6f 6b 65 6e 20 77 69 74 68 20 /* Token with
1e480 75 6e 71 75 61 6c 69 66 69 65 64 20 73 63 68 65 unqualified sche
1e490 6d 61 20 6f 62 6a 65 63 74 20 6e 61 6d 65 20 2a ma object name *
1e4a0 2f 0a 20 20 54 6f 6b 65 6e 20 73 4c 61 73 74 54 /. Token sLastT
1e4b0 6f 6b 65 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a oken; /*
1e4c0 20 54 68 65 20 6c 61 73 74 20 74 6f 6b 65 6e 20 The last token
1e4d0 70 61 72 73 65 64 20 2a 2f 0a 23 69 66 6e 64 65 parsed */.#ifnde
1e4e0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 f SQLITE_OMIT_VI
1e4f0 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 54 6f 6b RTUALTABLE. Tok
1e500 65 6e 20 73 41 72 67 3b 20 20 20 20 20 20 20 20 en sArg;
1e510 20 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 6c 65 /* Comple
1e520 74 65 20 74 65 78 74 20 6f 66 20 61 20 6d 6f 64 te text of a mod
1e530 75 6c 65 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a ule argument */.
1e540 20 20 54 61 62 6c 65 20 2a 2a 61 70 56 74 61 62 Table **apVtab
1e550 4c 6f 63 6b 3b 20 20 20 20 20 20 20 2f 2a 20 50 Lock; /* P
1e560 6f 69 6e 74 65 72 20 74 6f 20 76 69 72 74 75 61 ointer to virtua
1e570 6c 20 74 61 62 6c 65 73 20 6e 65 65 64 69 6e 67 l tables needing
1e580 20 6c 6f 63 6b 69 6e 67 20 2a 2f 0a 23 65 6e 64 locking */.#end
1e590 69 66 0a 20 20 54 61 62 6c 65 20 2a 70 5a 6f 6d if. Table *pZom
1e5a0 62 69 65 54 61 62 3b 20 20 20 20 20 20 20 20 2f bieTab; /
1e5b0 2a 20 4c 69 73 74 20 6f 66 20 54 61 62 6c 65 20 * List of Table
1e5c0 6f 62 6a 65 63 74 73 20 74 6f 20 64 65 6c 65 74 objects to delet
1e5d0 65 20 61 66 74 65 72 20 63 6f 64 65 20 67 65 6e e after code gen
1e5e0 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 50 72 67 */. TriggerPrg
1e5f0 20 2a 70 54 72 69 67 67 65 72 50 72 67 3b 20 20 *pTriggerPrg;
1e600 2f 2a 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f /* Linked list o
1e610 66 20 63 6f 64 65 64 20 74 72 69 67 67 65 72 73 f coded triggers
1e620 20 2a 2f 0a 20 20 57 69 74 68 20 2a 70 57 69 74 */. With *pWit
1e630 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
1e640 2f 2a 20 43 75 72 72 65 6e 74 20 57 49 54 48 20 /* Current WITH
1e650 63 6c 61 75 73 65 2c 20 6f 72 20 4e 55 4c 4c 20 clause, or NULL
1e660 2a 2f 0a 20 20 57 69 74 68 20 2a 70 57 69 74 68 */. With *pWith
1e670 54 6f 46 72 65 65 3b 20 20 20 20 20 20 20 20 2f ToFree; /
1e680 2a 20 46 72 65 65 20 74 68 69 73 20 57 49 54 48 * Free this WITH
1e690 20 6f 62 6a 65 63 74 20 61 74 20 74 68 65 20 65 object at the e
1e6a0 6e 64 20 6f 66 20 74 68 65 20 70 61 72 73 65 20 nd of the parse
1e6b0 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 */.};../*.** Ret
1e6c0 75 72 6e 20 74 72 75 65 20 69 66 20 63 75 72 72 urn true if curr
1e6d0 65 6e 74 6c 79 20 69 6e 73 69 64 65 20 61 6e 20 ently inside an
1e6e0 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f sqlite3_declare_
1e6f0 76 74 61 62 28 29 20 63 61 6c 6c 2e 0a 2a 2f 0a vtab() call..*/.
1e700 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d #ifdef SQLITE_OM
1e710 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
1e720 20 20 23 64 65 66 69 6e 65 20 49 4e 5f 44 45 43 #define IN_DEC
1e730 4c 41 52 45 5f 56 54 41 42 20 30 0a 23 65 6c 73 LARE_VTAB 0.#els
1e740 65 0a 20 20 23 64 65 66 69 6e 65 20 49 4e 5f 44 e. #define IN_D
1e750 45 43 4c 41 52 45 5f 56 54 41 42 20 28 70 50 61 ECLARE_VTAB (pPa
1e760 72 73 65 2d 3e 64 65 63 6c 61 72 65 56 74 61 62 rse->declareVtab
1e770 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
1e780 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 An instance of t
1e790 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
1e7a0 75 63 74 75 72 65 20 63 61 6e 20 62 65 20 64 65 ucture can be de
1e7b0 63 6c 61 72 65 64 20 6f 6e 20 61 20 73 74 61 63 clared on a stac
1e7c0 6b 20 61 6e 64 20 75 73 65 64 0a 2a 2a 20 74 6f k and used.** to
1e7d0 20 73 61 76 65 20 74 68 65 20 50 61 72 73 65 2e save the Parse.
1e7e0 7a 41 75 74 68 43 6f 6e 74 65 78 74 20 76 61 6c zAuthContext val
1e7f0 75 65 20 73 6f 20 74 68 61 74 20 69 74 20 63 61 ue so that it ca
1e800 6e 20 62 65 20 72 65 73 74 6f 72 65 64 20 6c 61 n be restored la
1e810 74 65 72 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 41 ter..*/.struct A
1e820 75 74 68 43 6f 6e 74 65 78 74 20 7b 0a 20 20 63 uthContext {. c
1e830 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 75 74 68 onst char *zAuth
1e840 43 6f 6e 74 65 78 74 3b 20 20 20 2f 2a 20 50 75 Context; /* Pu
1e850 74 20 73 61 76 65 64 20 50 61 72 73 65 2e 7a 41 t saved Parse.zA
1e860 75 74 68 43 6f 6e 74 65 78 74 20 68 65 72 65 20 uthContext here
1e870 2a 2f 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 */. Parse *pPar
1e880 73 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 se;
1e890 20 2f 2a 20 54 68 65 20 50 61 72 73 65 20 73 74 /* The Parse st
1e8a0 72 75 63 74 75 72 65 20 2a 2f 0a 7d 3b 0a 0a 2f ructure */.};../
1e8b0 2a 0a 2a 2a 20 42 69 74 66 69 65 6c 64 20 66 6c *.** Bitfield fl
1e8c0 61 67 73 20 66 6f 72 20 50 35 20 76 61 6c 75 65 ags for P5 value
1e8d0 20 69 6e 20 76 61 72 69 6f 75 73 20 6f 70 63 6f in various opco
1e8e0 64 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 des..*/.#define
1e8f0 4f 50 46 4c 41 47 5f 4e 43 48 41 4e 47 45 20 20 OPFLAG_NCHANGE
1e900 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 0x01 /*
1e910 4f 50 5f 49 6e 73 65 72 74 3a 20 53 65 74 20 74 OP_Insert: Set t
1e920 6f 20 75 70 64 61 74 65 20 64 62 2d 3e 6e 43 68 o update db->nCh
1e930 61 6e 67 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 ange */.
1e940 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e950 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1e960 41 6c 73 6f 20 75 73 65 64 20 69 6e 20 50 32 20 Also used in P2
1e970 28 6e 6f 74 20 50 35 29 20 6f 66 20 4f 50 5f 44 (not P5) of OP_D
1e980 65 6c 65 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 elete */.#define
1e990 20 4f 50 46 4c 41 47 5f 45 50 48 45 4d 20 20 20 OPFLAG_EPHEM
1e9a0 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
1e9b0 20 4f 50 5f 43 6f 6c 75 6d 6e 3a 20 45 70 68 65 OP_Column: Ephe
1e9c0 6d 65 72 61 6c 20 6f 75 74 70 75 74 20 69 73 20 meral output is
1e9d0 6f 6b 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 ok */.#define OP
1e9e0 46 4c 41 47 5f 4c 41 53 54 52 4f 57 49 44 20 20 FLAG_LASTROWID
1e9f0 20 20 20 30 78 30 32 20 20 20 20 2f 2a 20 53 65 0x02 /* Se
1ea00 74 20 74 6f 20 75 70 64 61 74 65 20 64 62 2d 3e t to update db->
1ea10 6c 61 73 74 52 6f 77 69 64 20 2a 2f 0a 23 64 65 lastRowid */.#de
1ea20 66 69 6e 65 20 4f 50 46 4c 41 47 5f 49 53 55 50 fine OPFLAG_ISUP
1ea30 44 41 54 45 20 20 20 20 20 20 30 78 30 34 20 20 DATE 0x04
1ea40 20 20 2f 2a 20 54 68 69 73 20 4f 50 5f 49 6e 73 /* This OP_Ins
1ea50 65 72 74 20 69 73 20 61 6e 20 73 71 6c 20 55 50 ert is an sql UP
1ea60 44 41 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 DATE */.#define
1ea70 4f 50 46 4c 41 47 5f 41 50 50 45 4e 44 20 20 20 OPFLAG_APPEND
1ea80 20 20 20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 0x08 /*
1ea90 54 68 69 73 20 69 73 20 6c 69 6b 65 6c 79 20 74 This is likely t
1eaa0 6f 20 62 65 20 61 6e 20 61 70 70 65 6e 64 20 2a o be an append *
1eab0 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
1eac0 5f 55 53 45 53 45 45 4b 52 45 53 55 4c 54 20 30 _USESEEKRESULT 0
1ead0 78 31 30 20 20 20 20 2f 2a 20 54 72 79 20 74 6f x10 /* Try to
1eae0 20 61 76 6f 69 64 20 61 20 73 65 65 6b 20 69 6e avoid a seek in
1eaf0 20 42 74 72 65 65 49 6e 73 65 72 74 28 29 20 2a BtreeInsert() *
1eb00 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
1eb10 5f 4c 45 4e 47 54 48 41 52 47 20 20 20 20 20 30 _LENGTHARG 0
1eb20 78 34 30 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c x40 /* OP_Col
1eb30 75 6d 6e 20 6f 6e 6c 79 20 75 73 65 64 20 66 6f umn only used fo
1eb40 72 20 6c 65 6e 67 74 68 28 29 20 2a 2f 0a 23 64 r length() */.#d
1eb50 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 54 59 50 efine OPFLAG_TYP
1eb60 45 4f 46 41 52 47 20 20 20 20 20 30 78 38 30 20 EOFARG 0x80
1eb70 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e 20 /* OP_Column
1eb80 6f 6e 6c 79 20 75 73 65 64 20 66 6f 72 20 74 79 only used for ty
1eb90 70 65 6f 66 28 29 20 2a 2f 0a 23 64 65 66 69 6e peof() */.#defin
1eba0 65 20 4f 50 46 4c 41 47 5f 42 55 4c 4b 43 53 52 e OPFLAG_BULKCSR
1ebb0 20 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 0x01 /
1ebc0 2a 20 4f 50 5f 4f 70 65 6e 2a 2a 20 75 73 65 64 * OP_Open** used
1ebd0 20 74 6f 20 6f 70 65 6e 20 62 75 6c 6b 20 63 75 to open bulk cu
1ebe0 72 73 6f 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 rsor */.#define
1ebf0 4f 50 46 4c 41 47 5f 53 45 45 4b 45 51 20 20 20 OPFLAG_SEEKEQ
1ec00 20 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 20 0x02 /*
1ec10 4f 50 5f 4f 70 65 6e 2a 2a 20 63 75 72 73 6f 72 OP_Open** cursor
1ec20 20 75 73 65 73 20 45 51 20 73 65 65 6b 20 6f 6e uses EQ seek on
1ec30 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 ly */.#define OP
1ec40 46 4c 41 47 5f 46 4f 52 44 45 4c 45 54 45 20 20 FLAG_FORDELETE
1ec50 20 20 20 30 78 30 38 20 20 20 20 2f 2a 20 4f 50 0x08 /* OP
1ec60 5f 4f 70 65 6e 20 73 68 6f 75 6c 64 20 75 73 65 _Open should use
1ec70 20 42 54 52 45 45 5f 46 4f 52 44 45 4c 45 54 45 BTREE_FORDELETE
1ec80 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c */.#define OPFL
1ec90 41 47 5f 50 32 49 53 52 45 47 20 20 20 20 20 20 AG_P2ISREG
1eca0 20 30 78 31 30 20 20 20 20 2f 2a 20 50 32 20 74 0x10 /* P2 t
1ecb0 6f 20 4f 50 5f 4f 70 65 6e 2a 2a 20 69 73 20 61 o OP_Open** is a
1ecc0 20 72 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 register number
1ecd0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c */.#define OPFL
1ece0 41 47 5f 50 45 52 4d 55 54 45 20 20 20 20 20 20 AG_PERMUTE
1ecf0 20 30 78 30 31 20 20 20 20 2f 2a 20 4f 50 5f 43 0x01 /* OP_C
1ed00 6f 6d 70 61 72 65 3a 20 75 73 65 20 74 68 65 20 ompare: use the
1ed10 70 65 72 6d 75 74 61 74 69 6f 6e 20 2a 2f 0a 23 permutation */.#
1ed20 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 53 41 define OPFLAG_SA
1ed30 56 45 50 4f 53 49 54 49 4f 4e 20 20 30 78 30 32 VEPOSITION 0x02
1ed40 20 20 20 20 2f 2a 20 4f 50 5f 44 65 6c 65 74 65 /* OP_Delete
1ed50 3a 20 6b 65 65 70 20 63 75 72 73 6f 72 20 70 6f : keep cursor po
1ed60 73 69 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e sition */.#defin
1ed70 65 20 4f 50 46 4c 41 47 5f 41 55 58 44 45 4c 45 e OPFLAG_AUXDELE
1ed80 54 45 20 20 20 20 20 30 78 30 34 20 20 20 20 2f TE 0x04 /
1ed90 2a 20 4f 50 5f 44 65 6c 65 74 65 3a 20 69 6e 64 * OP_Delete: ind
1eda0 65 78 20 69 6e 20 61 20 44 45 4c 45 54 45 20 6f ex in a DELETE o
1edb0 70 20 2a 2f 0a 0a 2f 2a 0a 20 2a 20 45 61 63 68 p */../*. * Each
1edc0 20 74 72 69 67 67 65 72 20 70 72 65 73 65 6e 74 trigger present
1edd0 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 in the database
1ede0 20 73 63 68 65 6d 61 20 69 73 20 73 74 6f 72 65 schema is store
1edf0 64 20 61 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 d as an instance
1ee00 20 6f 66 0a 20 2a 20 73 74 72 75 63 74 20 54 72 of. * struct Tr
1ee10 69 67 67 65 72 2e 0a 20 2a 0a 20 2a 20 50 6f 69 igger.. *. * Poi
1ee20 6e 74 65 72 73 20 74 6f 20 69 6e 73 74 61 6e 63 nters to instanc
1ee30 65 73 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 es of struct Tri
1ee40 67 67 65 72 20 61 72 65 20 73 74 6f 72 65 64 20 gger are stored
1ee50 69 6e 20 74 77 6f 20 77 61 79 73 2e 0a 20 2a 20 in two ways.. *
1ee60 31 2e 20 49 6e 20 74 68 65 20 22 74 72 69 67 48 1. In the "trigH
1ee70 61 73 68 22 20 68 61 73 68 20 74 61 62 6c 65 20 ash" hash table
1ee80 28 70 61 72 74 20 6f 66 20 74 68 65 20 73 71 6c (part of the sql
1ee90 69 74 65 33 2a 20 74 68 61 74 20 72 65 70 72 65 ite3* that repre
1eea0 73 65 6e 74 73 20 74 68 65 0a 20 2a 20 20 20 20 sents the. *
1eeb0 64 61 74 61 62 61 73 65 29 2e 20 54 68 69 73 20 database). This
1eec0 61 6c 6c 6f 77 73 20 54 72 69 67 67 65 72 20 73 allows Trigger s
1eed0 74 72 75 63 74 75 72 65 73 20 74 6f 20 62 65 20 tructures to be
1eee0 72 65 74 72 69 65 76 65 64 20 62 79 20 6e 61 6d retrieved by nam
1eef0 65 2e 0a 20 2a 20 32 2e 20 41 6c 6c 20 74 72 69 e.. * 2. All tri
1ef00 67 67 65 72 73 20 61 73 73 6f 63 69 61 74 65 64 ggers associated
1ef10 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 74 with a single t
1ef20 61 62 6c 65 20 66 6f 72 6d 20 61 20 6c 69 6e 6b able form a link
1ef30 65 64 20 6c 69 73 74 2c 20 75 73 69 6e 67 20 74 ed list, using t
1ef40 68 65 0a 20 2a 20 20 20 20 70 4e 65 78 74 20 6d he. * pNext m
1ef50 65 6d 62 65 72 20 6f 66 20 73 74 72 75 63 74 20 ember of struct
1ef60 54 72 69 67 67 65 72 2e 20 41 20 70 6f 69 6e 74 Trigger. A point
1ef70 65 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 er to the first
1ef80 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 0a 20 element of the.
1ef90 2a 20 20 20 20 6c 69 6e 6b 65 64 20 6c 69 73 74 * linked list
1efa0 20 69 73 20 73 74 6f 72 65 64 20 61 73 20 74 68 is stored as th
1efb0 65 20 22 70 54 72 69 67 67 65 72 22 20 6d 65 6d e "pTrigger" mem
1efc0 62 65 72 20 6f 66 20 74 68 65 20 61 73 73 6f 63 ber of the assoc
1efd0 69 61 74 65 64 0a 20 2a 20 20 20 20 73 74 72 75 iated. * stru
1efe0 63 74 20 54 61 62 6c 65 2e 0a 20 2a 0a 20 2a 20 ct Table.. *. *
1eff0 54 68 65 20 22 73 74 65 70 5f 6c 69 73 74 22 20 The "step_list"
1f000 6d 65 6d 62 65 72 20 70 6f 69 6e 74 73 20 74 6f member points to
1f010 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 the first eleme
1f020 6e 74 20 6f 66 20 61 20 6c 69 6e 6b 65 64 20 6c nt of a linked l
1f030 69 73 74 0a 20 2a 20 63 6f 6e 74 61 69 6e 69 6e ist. * containin
1f040 67 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d g the SQL statem
1f050 65 6e 74 73 20 73 70 65 63 69 66 69 65 64 20 61 ents specified a
1f060 73 20 74 68 65 20 74 72 69 67 67 65 72 20 70 72 s the trigger pr
1f070 6f 67 72 61 6d 2e 0a 20 2a 2f 0a 73 74 72 75 63 ogram.. */.struc
1f080 74 20 54 72 69 67 67 65 72 20 7b 0a 20 20 63 68 t Trigger {. ch
1f090 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 ar *zName;
1f0a0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d /* The nam
1f0b0 65 20 6f 66 20 74 68 65 20 74 72 69 67 67 65 72 e of the trigger
1f0c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f0d0 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 63 68 61 */. cha
1f0e0 72 20 2a 74 61 62 6c 65 3b 20 20 20 20 20 20 20 r *table;
1f0f0 20 20 20 20 20 2f 2a 20 54 68 65 20 74 61 62 6c /* The tabl
1f100 65 20 6f 72 20 76 69 65 77 20 74 6f 20 77 68 69 e or view to whi
1f110 63 68 20 74 68 65 20 74 72 69 67 67 65 72 20 61 ch the trigger a
1f120 70 70 6c 69 65 73 20 2a 2f 0a 20 20 75 38 20 6f pplies */. u8 o
1f130 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 p;
1f140 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 4b /* One of TK
1f150 5f 44 45 4c 45 54 45 2c 20 54 4b 5f 55 50 44 41 _DELETE, TK_UPDA
1f160 54 45 2c 20 54 4b 5f 49 4e 53 45 52 54 20 20 20 TE, TK_INSERT
1f170 20 20 20 20 20 20 2a 2f 0a 20 20 75 38 20 74 72 */. u8 tr
1f180 5f 74 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 _tm;
1f190 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 52 49 /* One of TRI
1f1a0 47 47 45 52 5f 42 45 46 4f 52 45 2c 20 54 52 49 GGER_BEFORE, TRI
1f1b0 47 47 45 52 5f 41 46 54 45 52 20 2a 2f 0a 20 20 GGER_AFTER */.
1f1c0 45 78 70 72 20 2a 70 57 68 65 6e 3b 20 20 20 20 Expr *pWhen;
1f1d0 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 /* The W
1f1e0 48 45 4e 20 63 6c 61 75 73 65 20 6f 66 20 74 68 HEN clause of th
1f1f0 65 20 65 78 70 72 65 73 73 69 6f 6e 20 28 6d 61 e expression (ma
1f200 79 20 62 65 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 y be NULL) */.
1f210 49 64 4c 69 73 74 20 2a 70 43 6f 6c 75 6d 6e 73 IdList *pColumns
1f220 3b 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 ; /* If th
1f230 69 73 20 69 73 20 61 6e 20 55 50 44 41 54 45 20 is is an UPDATE
1f240 4f 46 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e OF <column-list>
1f250 20 74 72 69 67 67 65 72 2c 0a 20 20 20 20 20 20 trigger,.
1f260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1f270 20 20 20 20 20 20 20 74 68 65 20 3c 63 6f 6c 75 the <colu
1f280 6d 6e 2d 6c 69 73 74 3e 20 69 73 20 73 74 6f 72 mn-list> is stor
1f290 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 53 63 68 ed here */. Sch
1f2a0 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 20 ema *pSchema;
1f2b0 20 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 63 /* Schema c
1f2c0 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 74 72 ontaining the tr
1f2d0 69 67 67 65 72 20 2a 2f 0a 20 20 53 63 68 65 6d igger */. Schem
1f2e0 61 20 2a 70 54 61 62 53 63 68 65 6d 61 3b 20 20 a *pTabSchema;
1f2f0 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6e /* Schema con
1f300 74 61 69 6e 69 6e 67 20 74 68 65 20 74 61 62 6c taining the tabl
1f310 65 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 74 e */. TriggerSt
1f320 65 70 20 2a 73 74 65 70 5f 6c 69 73 74 3b 20 2f ep *step_list; /
1f330 2a 20 4c 69 6e 6b 20 6c 69 73 74 20 6f 66 20 74 * Link list of t
1f340 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 20 73 rigger program s
1f350 74 65 70 73 20 20 20 20 20 20 20 20 20 20 20 20 teps
1f360 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 */. Trigger *p
1f370 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 2f 2a Next; /*
1f380 20 4e 65 78 74 20 74 72 69 67 67 65 72 20 61 73 Next trigger as
1f390 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 68 sociated with th
1f3a0 65 20 74 61 62 6c 65 20 2a 2f 0a 7d 3b 0a 0a 2f e table */.};../
1f3b0 2a 0a 2a 2a 20 41 20 74 72 69 67 67 65 72 20 69 *.** A trigger i
1f3c0 73 20 65 69 74 68 65 72 20 61 20 42 45 46 4f 52 s either a BEFOR
1f3d0 45 20 6f 72 20 61 6e 20 41 46 54 45 52 20 74 72 E or an AFTER tr
1f3e0 69 67 67 65 72 2e 20 20 54 68 65 20 66 6f 6c 6c igger. The foll
1f3f0 6f 77 69 6e 67 20 63 6f 6e 73 74 61 6e 74 73 0a owing constants.
1f400 2a 2a 20 64 65 74 65 72 6d 69 6e 65 20 77 68 69 ** determine whi
1f410 63 68 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 ch..**.** If the
1f420 72 65 20 61 72 65 20 6d 75 6c 74 69 70 6c 65 20 re are multiple
1f430 74 72 69 67 67 65 72 73 2c 20 79 6f 75 20 6d 69 triggers, you mi
1f440 67 68 74 20 6f 66 20 73 6f 6d 65 20 42 45 46 4f ght of some BEFO
1f450 52 45 20 61 6e 64 20 73 6f 6d 65 20 41 46 54 45 RE and some AFTE
1f460 52 2e 0a 2a 2a 20 49 6e 20 74 68 61 74 20 63 61 R..** In that ca
1f470 73 65 73 2c 20 74 68 65 20 63 6f 6e 73 74 61 6e ses, the constan
1f480 74 73 20 62 65 6c 6f 77 20 63 61 6e 20 62 65 20 ts below can be
1f490 4f 52 65 64 20 74 6f 67 65 74 68 65 72 2e 0a 2a ORed together..*
1f4a0 2f 0a 23 64 65 66 69 6e 65 20 54 52 49 47 47 45 /.#define TRIGGE
1f4b0 52 5f 42 45 46 4f 52 45 20 20 31 0a 23 64 65 66 R_BEFORE 1.#def
1f4c0 69 6e 65 20 54 52 49 47 47 45 52 5f 41 46 54 45 ine TRIGGER_AFTE
1f4d0 52 20 20 20 32 0a 0a 2f 2a 0a 20 2a 20 41 6e 20 R 2../*. * An
1f4e0 69 6e 73 74 61 6e 63 65 20 6f 66 20 73 74 72 75 instance of stru
1f4f0 63 74 20 54 72 69 67 67 65 72 53 74 65 70 20 69 ct TriggerStep i
1f500 73 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 s used to store
1f510 61 20 73 69 6e 67 6c 65 20 53 51 4c 20 73 74 61 a single SQL sta
1f520 74 65 6d 65 6e 74 0a 20 2a 20 74 68 61 74 20 69 tement. * that i
1f530 73 20 61 20 70 61 72 74 20 6f 66 20 61 20 74 72 s a part of a tr
1f540 69 67 67 65 72 2d 70 72 6f 67 72 61 6d 2e 0a 20 igger-program..
1f550 2a 0a 20 2a 20 49 6e 73 74 61 6e 63 65 73 20 6f *. * Instances o
1f560 66 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 f struct Trigger
1f570 53 74 65 70 20 61 72 65 20 73 74 6f 72 65 64 20 Step are stored
1f580 69 6e 20 61 20 73 69 6e 67 6c 79 20 6c 69 6e 6b in a singly link
1f590 65 64 20 6c 69 73 74 20 28 6c 69 6e 6b 65 64 0a ed list (linked.
1f5a0 20 2a 20 75 73 69 6e 67 20 74 68 65 20 22 70 4e * using the "pN
1f5b0 65 78 74 22 20 6d 65 6d 62 65 72 29 20 72 65 66 ext" member) ref
1f5c0 65 72 65 6e 63 65 64 20 62 79 20 74 68 65 20 22 erenced by the "
1f5d0 73 74 65 70 5f 6c 69 73 74 22 20 6d 65 6d 62 65 step_list" membe
1f5e0 72 20 6f 66 20 74 68 65 0a 20 2a 20 61 73 73 6f r of the. * asso
1f5f0 63 69 61 74 65 64 20 73 74 72 75 63 74 20 54 72 ciated struct Tr
1f600 69 67 67 65 72 20 69 6e 73 74 61 6e 63 65 2e 20 igger instance.
1f610 54 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e The first elemen
1f620 74 20 6f 66 20 74 68 65 20 6c 69 6e 6b 65 64 20 t of the linked
1f630 6c 69 73 74 20 69 73 0a 20 2a 20 74 68 65 20 66 list is. * the f
1f640 69 72 73 74 20 73 74 65 70 20 6f 66 20 74 68 65 irst step of the
1f650 20 74 72 69 67 67 65 72 2d 70 72 6f 67 72 61 6d trigger-program
1f660 2e 0a 20 2a 0a 20 2a 20 54 68 65 20 22 6f 70 22 .. *. * The "op"
1f670 20 6d 65 6d 62 65 72 20 69 6e 64 69 63 61 74 65 member indicate
1f680 73 20 77 68 65 74 68 65 72 20 74 68 69 73 20 69 s whether this i
1f690 73 20 61 20 22 44 45 4c 45 54 45 22 2c 20 22 49 s a "DELETE", "I
1f6a0 4e 53 45 52 54 22 2c 20 22 55 50 44 41 54 45 22 NSERT", "UPDATE"
1f6b0 20 6f 72 0a 20 2a 20 22 53 45 4c 45 43 54 22 20 or. * "SELECT"
1f6c0 73 74 61 74 65 6d 65 6e 74 2e 20 54 68 65 20 6d statement. The m
1f6d0 65 61 6e 69 6e 67 73 20 6f 66 20 74 68 65 20 6f eanings of the o
1f6e0 74 68 65 72 20 6d 65 6d 62 65 72 73 20 69 73 20 ther members is
1f6f0 64 65 74 65 72 6d 69 6e 65 64 20 62 79 20 74 68 determined by th
1f700 65 0a 20 2a 20 76 61 6c 75 65 20 6f 66 20 22 6f e. * value of "o
1f710 70 22 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 p" as follows:.
1f720 2a 0a 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 49 *. * (op == TK_I
1f730 4e 53 45 52 54 29 0a 20 2a 20 6f 72 63 6f 6e 66 NSERT). * orconf
1f740 20 20 20 20 2d 3e 20 73 74 6f 72 65 73 20 74 68 -> stores th
1f750 65 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 61 6c e ON CONFLICT al
1f760 67 6f 72 69 74 68 6d 0a 20 2a 20 70 53 65 6c 65 gorithm. * pSele
1f770 63 74 20 20 20 2d 3e 20 49 66 20 74 68 69 73 20 ct -> If this
1f780 69 73 20 61 6e 20 49 4e 53 45 52 54 20 49 4e 54 is an INSERT INT
1f790 4f 20 2e 2e 2e 20 53 45 4c 45 43 54 20 2e 2e 2e O ... SELECT ...
1f7a0 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 6e statement, then
1f7b0 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 . *
1f7c0 20 74 68 69 73 20 73 74 6f 72 65 73 20 61 20 70 this stores a p
1f7d0 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 53 45 ointer to the SE
1f7e0 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 LECT statement.
1f7f0 4f 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a Otherwise NULL..
1f800 20 2a 20 7a 54 61 72 67 65 74 20 20 20 2d 3e 20 * zTarget ->
1f810 44 65 71 75 6f 74 65 64 20 6e 61 6d 65 20 6f 66 Dequoted name of
1f820 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 69 6e the table to in
1f830 73 65 72 74 20 69 6e 74 6f 2e 0a 20 2a 20 70 45 sert into.. * pE
1f840 78 70 72 4c 69 73 74 20 2d 3e 20 49 66 20 74 68 xprList -> If th
1f850 69 73 20 69 73 20 61 6e 20 49 4e 53 45 52 54 20 is is an INSERT
1f860 49 4e 54 4f 20 2e 2e 2e 20 56 41 4c 55 45 53 20 INTO ... VALUES
1f870 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 ... statement, t
1f880 68 65 6e 0a 20 2a 20 20 20 20 20 20 20 20 20 20 hen. *
1f890 20 20 20 20 74 68 69 73 20 73 74 6f 72 65 73 20 this stores
1f8a0 76 61 6c 75 65 73 20 74 6f 20 62 65 20 69 6e 73 values to be ins
1f8b0 65 72 74 65 64 2e 20 4f 74 68 65 72 77 69 73 65 erted. Otherwise
1f8c0 20 4e 55 4c 4c 2e 0a 20 2a 20 70 49 64 4c 69 73 NULL.. * pIdLis
1f8d0 74 20 20 20 2d 3e 20 49 66 20 74 68 69 73 20 69 t -> If this i
1f8e0 73 20 61 6e 20 49 4e 53 45 52 54 20 49 4e 54 4f s an INSERT INTO
1f8f0 20 2e 2e 2e 20 28 3c 63 6f 6c 75 6d 6e 2d 6e 61 ... (<column-na
1f900 6d 65 73 3e 29 20 56 41 4c 55 45 53 20 2e 2e 2e mes>) VALUES ...
1f910 0a 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 . *
1f920 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 6e statement, then
1f930 20 74 68 69 73 20 73 74 6f 72 65 73 20 74 68 65 this stores the
1f940 20 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 20 74 6f column-names to
1f950 20 62 65 0a 20 2a 20 20 20 20 20 20 20 20 20 20 be. *
1f960 20 20 20 20 69 6e 73 65 72 74 65 64 20 69 6e 74 inserted int
1f970 6f 2e 0a 20 2a 0a 20 2a 20 28 6f 70 20 3d 3d 20 o.. *. * (op ==
1f980 54 4b 5f 44 45 4c 45 54 45 29 0a 20 2a 20 7a 54 TK_DELETE). * zT
1f990 61 72 67 65 74 20 20 20 2d 3e 20 44 65 71 75 6f arget -> Dequo
1f9a0 74 65 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 ted name of the
1f9b0 74 61 62 6c 65 20 74 6f 20 64 65 6c 65 74 65 20 table to delete
1f9c0 66 72 6f 6d 2e 0a 20 2a 20 70 57 68 65 72 65 20 from.. * pWhere
1f9d0 20 20 20 2d 3e 20 54 68 65 20 57 48 45 52 45 20 -> The WHERE
1f9e0 63 6c 61 75 73 65 20 6f 66 20 74 68 65 20 44 45 clause of the DE
1f9f0 4c 45 54 45 20 73 74 61 74 65 6d 65 6e 74 20 69 LETE statement i
1fa00 66 20 6f 6e 65 20 69 73 20 73 70 65 63 69 66 69 f one is specifi
1fa10 65 64 2e 0a 20 2a 20 20 20 20 20 20 20 20 20 20 ed.. *
1fa20 20 20 20 20 4f 74 68 65 72 77 69 73 65 20 4e 55 Otherwise NU
1fa30 4c 4c 2e 0a 20 2a 0a 20 2a 20 28 6f 70 20 3d 3d LL.. *. * (op ==
1fa40 20 54 4b 5f 55 50 44 41 54 45 29 0a 20 2a 20 7a TK_UPDATE). * z
1fa50 54 61 72 67 65 74 20 20 20 2d 3e 20 44 65 71 75 Target -> Dequ
1fa60 6f 74 65 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 oted name of the
1fa70 20 74 61 62 6c 65 20 74 6f 20 75 70 64 61 74 65 table to update
1fa80 2e 0a 20 2a 20 70 57 68 65 72 65 20 20 20 20 2d .. * pWhere -
1fa90 3e 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 > The WHERE clau
1faa0 73 65 20 6f 66 20 74 68 65 20 55 50 44 41 54 45 se of the UPDATE
1fab0 20 73 74 61 74 65 6d 65 6e 74 20 69 66 20 6f 6e statement if on
1fac0 65 20 69 73 20 73 70 65 63 69 66 69 65 64 2e 0a e is specified..
1fad0 20 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
1fae0 4f 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a Otherwise NULL..
1faf0 20 2a 20 70 45 78 70 72 4c 69 73 74 20 2d 3e 20 * pExprList ->
1fb00 41 20 6c 69 73 74 20 6f 66 20 74 68 65 20 63 6f A list of the co
1fb10 6c 75 6d 6e 73 20 74 6f 20 75 70 64 61 74 65 20 lumns to update
1fb20 61 6e 64 20 74 68 65 20 65 78 70 72 65 73 73 69 and the expressi
1fb30 6f 6e 73 20 74 6f 20 75 70 64 61 74 65 0a 20 2a ons to update. *
1fb40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 th
1fb50 65 6d 20 74 6f 2e 20 53 65 65 20 73 71 6c 69 74 em to. See sqlit
1fb60 65 33 55 70 64 61 74 65 28 29 20 64 6f 63 75 6d e3Update() docum
1fb70 65 6e 74 61 74 69 6f 6e 20 6f 66 20 22 70 43 68 entation of "pCh
1fb80 61 6e 67 65 73 22 0a 20 2a 20 20 20 20 20 20 20 anges". *
1fb90 20 20 20 20 20 20 20 61 72 67 75 6d 65 6e 74 2e argument.
1fba0 0a 20 2a 0a 20 2a 2f 0a 73 74 72 75 63 74 20 54 . *. */.struct T
1fbb0 72 69 67 67 65 72 53 74 65 70 20 7b 0a 20 20 75 riggerStep {. u
1fbc0 38 20 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 8 op;
1fbd0 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 4b /* One of TK
1fbe0 5f 44 45 4c 45 54 45 2c 20 54 4b 5f 55 50 44 41 _DELETE, TK_UPDA
1fbf0 54 45 2c 20 54 4b 5f 49 4e 53 45 52 54 2c 20 54 TE, TK_INSERT, T
1fc00 4b 5f 53 45 4c 45 43 54 20 2a 2f 0a 20 20 75 38 K_SELECT */. u8
1fc10 20 6f 72 63 6f 6e 66 3b 20 20 20 20 20 20 20 20 orconf;
1fc20 20 20 20 2f 2a 20 4f 45 5f 52 6f 6c 6c 62 61 63 /* OE_Rollbac
1fc30 6b 20 65 74 63 2e 20 2a 2f 0a 20 20 54 72 69 67 k etc. */. Trig
1fc40 67 65 72 20 2a 70 54 72 69 67 3b 20 20 20 20 20 ger *pTrig;
1fc50 20 2f 2a 20 54 68 65 20 74 72 69 67 67 65 72 20 /* The trigger
1fc60 74 68 61 74 20 74 68 69 73 20 73 74 65 70 20 69 that this step i
1fc70 73 20 61 20 70 61 72 74 20 6f 66 20 2a 2f 0a 20 s a part of */.
1fc80 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 Select *pSelect
1fc90 3b 20 20 20 20 20 2f 2a 20 53 45 4c 45 43 54 20 ; /* SELECT
1fca0 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 52 48 53 statement or RHS
1fcb0 20 6f 66 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 of INSERT INTO
1fcc0 53 45 4c 45 43 54 20 2e 2e 2e 20 2a 2f 0a 20 20 SELECT ... */.
1fcd0 63 68 61 72 20 2a 7a 54 61 72 67 65 74 3b 20 20 char *zTarget;
1fce0 20 20 20 20 20 2f 2a 20 54 61 72 67 65 74 20 74 /* Target t
1fcf0 61 62 6c 65 20 66 6f 72 20 44 45 4c 45 54 45 2c able for DELETE,
1fd00 20 55 50 44 41 54 45 2c 20 49 4e 53 45 52 54 20 UPDATE, INSERT
1fd10 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 68 65 72 */. Expr *pWher
1fd20 65 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 e; /* The
1fd30 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 66 6f WHERE clause fo
1fd40 72 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 r DELETE or UPDA
1fd50 54 45 20 73 74 65 70 73 20 2a 2f 0a 20 20 45 78 TE steps */. Ex
1fd60 70 72 4c 69 73 74 20 2a 70 45 78 70 72 4c 69 73 prList *pExprLis
1fd70 74 3b 20 2f 2a 20 53 45 54 20 63 6c 61 75 73 65 t; /* SET clause
1fd80 20 66 6f 72 20 55 50 44 41 54 45 2e 20 2a 2f 0a for UPDATE. */.
1fd90 20 20 49 64 4c 69 73 74 20 2a 70 49 64 4c 69 73 IdList *pIdLis
1fda0 74 3b 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e t; /* Column
1fdb0 20 6e 61 6d 65 73 20 66 6f 72 20 49 4e 53 45 52 names for INSER
1fdc0 54 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 74 T */. TriggerSt
1fdd0 65 70 20 2a 70 4e 65 78 74 3b 20 20 2f 2a 20 4e ep *pNext; /* N
1fde0 65 78 74 20 69 6e 20 74 68 65 20 6c 69 6e 6b 2d ext in the link-
1fdf0 6c 69 73 74 20 2a 2f 0a 20 20 54 72 69 67 67 65 list */. Trigge
1fe00 72 53 74 65 70 20 2a 70 4c 61 73 74 3b 20 20 2f rStep *pLast; /
1fe10 2a 20 4c 61 73 74 20 65 6c 65 6d 65 6e 74 20 69 * Last element i
1fe20 6e 20 6c 69 6e 6b 2d 6c 69 73 74 2e 20 56 61 6c n link-list. Val
1fe30 69 64 20 66 6f 72 20 31 73 74 20 65 6c 65 6d 20 id for 1st elem
1fe40 6f 6e 6c 79 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a only */.};../*.*
1fe50 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 * The following
1fe60 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 structure contai
1fe70 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 ns information u
1fe80 73 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 sed by the sqlit
1fe90 65 46 69 78 2e 2e 2e 0a 2a 2a 20 72 6f 75 74 69 eFix....** routi
1fea0 6e 65 73 20 61 73 20 74 68 65 79 20 77 61 6c 6b nes as they walk
1feb0 20 74 68 65 20 70 61 72 73 65 20 74 72 65 65 20 the parse tree
1fec0 74 6f 20 6d 61 6b 65 20 64 61 74 61 62 61 73 65 to make database
1fed0 20 72 65 66 65 72 65 6e 63 65 73 0a 2a 2a 20 65 references.** e
1fee0 78 70 6c 69 63 69 74 2e 0a 2a 2f 0a 74 79 70 65 xplicit..*/.type
1fef0 64 65 66 20 73 74 72 75 63 74 20 44 62 46 69 78 def struct DbFix
1ff00 65 72 20 44 62 46 69 78 65 72 3b 0a 73 74 72 75 er DbFixer;.stru
1ff10 63 74 20 44 62 46 69 78 65 72 20 7b 0a 20 20 50 ct DbFixer {. P
1ff20 61 72 73 65 20 2a 70 50 61 72 73 65 3b 20 20 20 arse *pParse;
1ff30 20 20 20 2f 2a 20 54 68 65 20 70 61 72 73 69 6e /* The parsin
1ff40 67 20 63 6f 6e 74 65 78 74 2e 20 20 45 72 72 6f g context. Erro
1ff50 72 20 6d 65 73 73 61 67 65 73 20 77 72 69 74 74 r messages writt
1ff60 65 6e 20 68 65 72 65 20 2a 2f 0a 20 20 53 63 68 en here */. Sch
1ff70 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 20 ema *pSchema;
1ff80 20 2f 2a 20 46 69 78 20 69 74 65 6d 73 20 74 6f /* Fix items to
1ff90 20 74 68 69 73 20 73 63 68 65 6d 61 20 2a 2f 0a this schema */.
1ffa0 20 20 69 6e 74 20 62 56 61 72 4f 6e 6c 79 3b 20 int bVarOnly;
1ffb0 20 20 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 66 /* Check f
1ffc0 6f 72 20 76 61 72 69 61 62 6c 65 20 72 65 66 65 or variable refe
1ffd0 72 65 6e 63 65 73 20 6f 6e 6c 79 20 2a 2f 0a 20 rences only */.
1ffe0 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 const char *zDb
1fff0 3b 20 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 ; /* Make sur
20000 65 20 61 6c 6c 20 6f 62 6a 65 63 74 73 20 61 72 e all objects ar
20010 65 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 74 e contained in t
20020 68 69 73 20 64 61 74 61 62 61 73 65 20 2a 2f 0a his database */.
20030 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 const char *zT
20040 79 70 65 3b 20 20 2f 2a 20 54 79 70 65 20 6f 66 ype; /* Type of
20050 20 74 68 65 20 63 6f 6e 74 61 69 6e 65 72 20 2d the container -
20060 20 75 73 65 64 20 66 6f 72 20 65 72 72 6f 72 20 used for error
20070 6d 65 73 73 61 67 65 73 20 2a 2f 0a 20 20 63 6f messages */. co
20080 6e 73 74 20 54 6f 6b 65 6e 20 2a 70 4e 61 6d 65 nst Token *pName
20090 3b 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 ; /* Name of the
200a0 20 63 6f 6e 74 61 69 6e 65 72 20 2d 20 75 73 65 container - use
200b0 64 20 66 6f 72 20 65 72 72 6f 72 20 6d 65 73 73 d for error mess
200c0 61 67 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a ages */.};../*.*
200d0 2a 20 41 6e 20 6f 62 6a 65 63 74 65 64 20 75 73 * An objected us
200e0 65 64 20 74 6f 20 61 63 63 75 6d 75 6c 61 74 65 ed to accumulate
200f0 20 74 68 65 20 74 65 78 74 20 6f 66 20 61 20 73 the text of a s
20100 74 72 69 6e 67 20 77 68 65 72 65 20 77 65 0a 2a tring where we.*
20110 2a 20 64 6f 20 6e 6f 74 20 6e 65 63 65 73 73 61 * do not necessa
20120 72 69 6c 79 20 6b 6e 6f 77 20 68 6f 77 20 62 69 rily know how bi
20130 67 20 74 68 65 20 73 74 72 69 6e 67 20 77 69 6c g the string wil
20140 6c 20 62 65 20 69 6e 20 74 68 65 20 65 6e 64 2e l be in the end.
20150 0a 2a 2f 0a 73 74 72 75 63 74 20 53 74 72 41 63 .*/.struct StrAc
20160 63 75 6d 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 cum {. sqlite3
20170 2a 64 62 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 *db; /*
20180 4f 70 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 Optional databas
20190 65 20 66 6f 72 20 6c 6f 6f 6b 61 73 69 64 65 2e e for lookaside.
201a0 20 20 43 61 6e 20 62 65 20 4e 55 4c 4c 20 2a 2f Can be NULL */
201b0 0a 20 20 63 68 61 72 20 2a 7a 42 61 73 65 3b 20 . char *zBase;
201c0 20 20 20 20 20 20 20 20 2f 2a 20 41 20 62 61 73 /* A bas
201d0 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 4e e allocation. N
201e0 6f 74 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 2e 20 ot from malloc.
201f0 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 54 65 78 74 */. char *zText
20200 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 ; /* The
20210 20 73 74 72 69 6e 67 20 63 6f 6c 6c 65 63 74 65 string collecte
20220 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 75 33 d so far */. u3
20230 32 20 20 6e 43 68 61 72 3b 20 20 20 20 20 20 20 2 nChar;
20240 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 /* Length of
20250 74 68 65 20 73 74 72 69 6e 67 20 73 6f 20 66 61 the string so fa
20260 72 20 2a 2f 0a 20 20 75 33 32 20 20 6e 41 6c 6c r */. u32 nAll
20270 6f 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 oc; /* A
20280 6d 6f 75 6e 74 20 6f 66 20 73 70 61 63 65 20 61 mount of space a
20290 6c 6c 6f 63 61 74 65 64 20 69 6e 20 7a 54 65 78 llocated in zTex
202a0 74 20 2a 2f 0a 20 20 75 33 32 20 20 6d 78 41 6c t */. u32 mxAl
202b0 6c 6f 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d loc; /* M
202c0 61 78 69 6d 75 6d 20 61 6c 6c 6f 77 65 64 20 61 aximum allowed a
202d0 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 30 20 66 6f llocation. 0 fo
202e0 72 20 6e 6f 20 6d 61 6c 6c 6f 63 20 75 73 61 67 r no malloc usag
202f0 65 20 2a 2f 0a 20 20 75 38 20 20 20 61 63 63 45 e */. u8 accE
20300 72 72 6f 72 3b 20 20 20 20 20 20 20 2f 2a 20 53 rror; /* S
20310 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 4d 20 6f 72 TRACCUM_NOMEM or
20320 20 53 54 52 41 43 43 55 4d 5f 54 4f 4f 42 49 47 STRACCUM_TOOBIG
20330 20 2a 2f 0a 20 20 75 38 20 20 20 70 72 69 6e 74 */. u8 print
20340 66 46 6c 61 67 73 3b 20 20 20 20 2f 2a 20 53 51 fFlags; /* SQ
20350 4c 49 54 45 5f 50 52 49 4e 54 46 20 66 6c 61 67 LITE_PRINTF flag
20360 73 20 62 65 6c 6f 77 20 2a 2f 0a 7d 3b 0a 23 64 s below */.};.#d
20370 65 66 69 6e 65 20 53 54 52 41 43 43 55 4d 5f 4e efine STRACCUM_N
20380 4f 4d 45 4d 20 20 20 31 0a 23 64 65 66 69 6e 65 OMEM 1.#define
20390 20 53 54 52 41 43 43 55 4d 5f 54 4f 4f 42 49 47 STRACCUM_TOOBIG
203a0 20 20 32 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 2.#define SQLI
203b0 54 45 5f 50 52 49 4e 54 46 5f 49 4e 54 45 52 4e TE_PRINTF_INTERN
203c0 41 4c 20 30 78 30 31 20 20 2f 2a 20 49 6e 74 65 AL 0x01 /* Inte
203d0 72 6e 61 6c 2d 75 73 65 2d 6f 6e 6c 79 20 63 6f rnal-use-only co
203e0 6e 76 65 72 74 65 72 73 20 61 6c 6c 6f 77 65 64 nverters allowed
203f0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
20400 54 45 5f 50 52 49 4e 54 46 5f 53 51 4c 46 55 4e TE_PRINTF_SQLFUN
20410 43 20 20 30 78 30 32 20 20 2f 2a 20 53 51 4c 20 C 0x02 /* SQL
20420 66 75 6e 63 74 69 6f 6e 20 61 72 67 75 6d 65 6e function argumen
20430 74 73 20 74 6f 20 56 58 50 72 69 6e 74 66 20 2a ts to VXPrintf *
20440 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
20450 5f 50 52 49 4e 54 46 5f 4d 41 4c 4c 4f 43 45 44 _PRINTF_MALLOCED
20460 20 30 78 30 34 20 20 2f 2a 20 54 72 75 65 20 69 0x04 /* True i
20470 66 20 78 54 65 78 74 20 69 73 20 61 6c 6c 6f 63 f xText is alloc
20480 61 74 65 64 20 73 70 61 63 65 20 2a 2f 0a 0a 23 ated space */..#
20490 64 65 66 69 6e 65 20 69 73 4d 61 6c 6c 6f 63 65 define isMalloce
204a0 64 28 58 29 20 20 28 28 28 58 29 2d 3e 70 72 69 d(X) (((X)->pri
204b0 6e 74 66 46 6c 61 67 73 20 26 20 53 51 4c 49 54 ntfFlags & SQLIT
204c0 45 5f 50 52 49 4e 54 46 5f 4d 41 4c 4c 4f 43 45 E_PRINTF_MALLOCE
204d0 44 29 21 3d 30 29 0a 0a 0a 2f 2a 0a 2a 2a 20 41 D)!=0).../*.** A
204e0 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 69 73 pointer to this
204f0 20 73 74 72 75 63 74 75 72 65 20 69 73 20 75 73 structure is us
20500 65 64 20 74 6f 20 63 6f 6d 6d 75 6e 69 63 61 74 ed to communicat
20510 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 2a 2a e information.**
20520 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 49 6e 69 from sqlite3Ini
20530 74 20 61 6e 64 20 4f 50 5f 50 61 72 73 65 53 63 t and OP_ParseSc
20540 68 65 6d 61 20 69 6e 74 6f 20 74 68 65 20 73 71 hema into the sq
20550 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 lite3InitCallbac
20560 6b 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 k..*/.typedef st
20570 72 75 63 74 20 7b 0a 20 20 73 71 6c 69 74 65 33 ruct {. sqlite3
20580 20 2a 64 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 *db; /*
20590 54 68 65 20 64 61 74 61 62 61 73 65 20 62 65 69 The database bei
205a0 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a ng initialized *
205b0 2f 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 /. char **pzErr
205c0 4d 73 67 3b 20 20 20 20 2f 2a 20 45 72 72 6f 72 Msg; /* Error
205d0 20 6d 65 73 73 61 67 65 20 73 74 6f 72 65 64 20 message stored
205e0 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 69 44 here */. int iD
205f0 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a b; /*
20600 20 30 20 66 6f 72 20 6d 61 69 6e 20 64 61 74 61 0 for main data
20610 62 61 73 65 2e 20 20 31 20 66 6f 72 20 54 45 4d base. 1 for TEM
20620 50 2c 20 32 2e 2e 20 66 6f 72 20 41 54 54 41 43 P, 2.. for ATTAC
20630 48 65 64 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b Hed */. int rc;
20640 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
20650 52 65 73 75 6c 74 20 63 6f 64 65 20 73 74 6f 72 Result code stor
20660 65 64 20 68 65 72 65 20 2a 2f 0a 7d 20 49 6e 69 ed here */.} Ini
20670 74 44 61 74 61 3b 0a 0a 2f 2a 0a 2a 2a 20 53 74 tData;../*.** St
20680 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 69 ructure containi
20690 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e 66 69 67 ng global config
206a0 75 72 61 74 69 6f 6e 20 64 61 74 61 20 66 6f 72 uration data for
206b0 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 the SQLite libr
206c0 61 72 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 ary..**.** This
206d0 73 74 72 75 63 74 75 72 65 20 61 6c 73 6f 20 63 structure also c
206e0 6f 6e 74 61 69 6e 73 20 73 6f 6d 65 20 73 74 61 ontains some sta
206f0 74 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a te information..
20700 2a 2f 0a 73 74 72 75 63 74 20 53 71 6c 69 74 65 */.struct Sqlite
20710 33 43 6f 6e 66 69 67 20 7b 0a 20 20 69 6e 74 20 3Config {. int
20720 62 4d 65 6d 73 74 61 74 3b 20 20 20 20 20 20 20 bMemstat;
20730 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
20740 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 True to enable
20750 6d 65 6d 6f 72 79 20 73 74 61 74 75 73 20 2a 2f memory status */
20760 0a 20 20 69 6e 74 20 62 43 6f 72 65 4d 75 74 65 . int bCoreMute
20770 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
20780 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 /* True to
20790 65 6e 61 62 6c 65 20 63 6f 72 65 20 6d 75 74 65 enable core mute
207a0 78 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 46 xing */. int bF
207b0 75 6c 6c 4d 75 74 65 78 3b 20 20 20 20 20 20 20 ullMutex;
207c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
207d0 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 66 75 rue to enable fu
207e0 6c 6c 20 6d 75 74 65 78 69 6e 67 20 2a 2f 0a 20 ll mutexing */.
207f0 20 69 6e 74 20 62 4f 70 65 6e 55 72 69 3b 20 20 int bOpenUri;
20800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20810 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 69 6e /* True to in
20820 74 65 72 70 72 65 74 20 66 69 6c 65 6e 61 6d 65 terpret filename
20830 73 20 61 73 20 55 52 49 73 20 2a 2f 0a 20 20 69 s as URIs */. i
20840 6e 74 20 62 55 73 65 43 69 73 3b 20 20 20 20 20 nt bUseCis;
20850 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20860 20 2f 2a 20 55 73 65 20 63 6f 76 65 72 69 6e 67 /* Use covering
20870 20 69 6e 64 69 63 65 73 20 66 6f 72 20 66 75 6c indices for ful
20880 6c 2d 73 63 61 6e 73 20 2a 2f 0a 20 20 69 6e 74 l-scans */. int
20890 20 6d 78 53 74 72 6c 65 6e 3b 20 20 20 20 20 20 mxStrlen;
208a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
208b0 2a 20 4d 61 78 69 6d 75 6d 20 73 74 72 69 6e 67 * Maximum string
208c0 20 6c 65 6e 67 74 68 20 2a 2f 0a 20 20 69 6e 74 length */. int
208d0 20 6e 65 76 65 72 43 6f 72 72 75 70 74 3b 20 20 neverCorrupt;
208e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
208f0 2a 20 44 61 74 61 62 61 73 65 20 69 73 20 61 6c * Database is al
20900 77 61 79 73 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 ways well-formed
20910 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 4c 6f 6f 6b */. int szLook
20920 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 aside;
20930 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 75 /* Defau
20940 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 lt lookaside buf
20950 66 65 72 20 73 69 7a 65 20 2a 2f 0a 20 20 69 6e fer size */. in
20960 74 20 6e 4c 6f 6f 6b 61 73 69 64 65 3b 20 20 20 t nLookaside;
20970 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20980 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b 61 /* Default looka
20990 73 69 64 65 20 62 75 66 66 65 72 20 63 6f 75 6e side buffer coun
209a0 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d t */. sqlite3_m
209b0 65 6d 5f 6d 65 74 68 6f 64 73 20 6d 3b 20 20 20 em_methods m;
209c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 77 2d /* Low-
209d0 6c 65 76 65 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c level memory all
209e0 6f 63 61 74 69 6f 6e 20 69 6e 74 65 72 66 61 63 ocation interfac
209f0 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 6d e */. sqlite3_m
20a00 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 6d 75 74 utex_methods mut
20a10 65 78 3b 20 20 20 20 20 20 2f 2a 20 4c 6f 77 2d ex; /* Low-
20a20 6c 65 76 65 6c 20 6d 75 74 65 78 20 69 6e 74 65 level mutex inte
20a30 72 66 61 63 65 20 2a 2f 0a 20 20 73 71 6c 69 74 rface */. sqlit
20a40 65 33 5f 70 63 61 63 68 65 5f 6d 65 74 68 6f 64 e3_pcache_method
20a50 73 32 20 70 63 61 63 68 65 32 3b 20 20 2f 2a 20 s2 pcache2; /*
20a60 4c 6f 77 2d 6c 65 76 65 6c 20 70 61 67 65 2d 63 Low-level page-c
20a70 61 63 68 65 20 69 6e 74 65 72 66 61 63 65 20 2a ache interface *
20a80 2f 0a 20 20 76 6f 69 64 20 2a 70 48 65 61 70 3b /. void *pHeap;
20a90 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20aa0 20 20 20 20 20 20 2f 2a 20 48 65 61 70 20 73 74 /* Heap st
20ab0 6f 72 61 67 65 20 73 70 61 63 65 20 2a 2f 0a 20 orage space */.
20ac0 20 69 6e 74 20 6e 48 65 61 70 3b 20 20 20 20 20 int nHeap;
20ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20ae0 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 70 48 /* Size of pH
20af0 65 61 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6d eap[] */. int m
20b00 6e 52 65 71 2c 20 6d 78 52 65 71 3b 20 20 20 20 nReq, mxReq;
20b10 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
20b20 4d 69 6e 20 61 6e 64 20 6d 61 78 20 68 65 61 70 Min and max heap
20b30 20 72 65 71 75 65 73 74 73 20 73 69 7a 65 73 20 requests sizes
20b40 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 */. sqlite3_int
20b50 36 34 20 73 7a 4d 6d 61 70 3b 20 20 20 20 20 20 64 szMmap;
20b60 20 20 20 20 20 20 20 2f 2a 20 6d 6d 61 70 28 29 /* mmap()
20b70 20 73 70 61 63 65 20 70 65 72 20 6f 70 65 6e 20 space per open
20b80 66 69 6c 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 file */. sqlite
20b90 33 5f 69 6e 74 36 34 20 6d 78 4d 6d 61 70 3b 20 3_int64 mxMmap;
20ba0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d /* M
20bb0 61 78 69 6d 75 6d 20 76 61 6c 75 65 20 66 6f 72 aximum value for
20bc0 20 73 7a 4d 6d 61 70 20 2a 2f 0a 20 20 76 6f 69 szMmap */. voi
20bd0 64 20 2a 70 53 63 72 61 74 63 68 3b 20 20 20 20 d *pScratch;
20be0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
20bf0 2a 20 53 63 72 61 74 63 68 20 6d 65 6d 6f 72 79 * Scratch memory
20c00 20 2a 2f 0a 20 20 69 6e 74 20 73 7a 53 63 72 61 */. int szScra
20c10 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 tch;
20c20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
20c30 6f 66 20 65 61 63 68 20 73 63 72 61 74 63 68 20 of each scratch
20c40 62 75 66 66 65 72 20 2a 2f 0a 20 20 69 6e 74 20 buffer */. int
20c50 6e 53 63 72 61 74 63 68 3b 20 20 20 20 20 20 20 nScratch;
20c60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
20c70 20 4e 75 6d 62 65 72 20 6f 66 20 73 63 72 61 74 Number of scrat
20c80 63 68 20 62 75 66 66 65 72 73 20 2a 2f 0a 20 20 ch buffers */.
20c90 76 6f 69 64 20 2a 70 50 61 67 65 3b 20 20 20 20 void *pPage;
20ca0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20cb0 20 20 2f 2a 20 50 61 67 65 20 63 61 63 68 65 20 /* Page cache
20cc0 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69 6e 74 20 memory */. int
20cd0 73 7a 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 szPage;
20ce0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
20cf0 20 53 69 7a 65 20 6f 66 20 65 61 63 68 20 70 61 Size of each pa
20d00 67 65 20 69 6e 20 70 50 61 67 65 5b 5d 20 2a 2f ge in pPage[] */
20d10 0a 20 20 69 6e 74 20 6e 50 61 67 65 3b 20 20 20 . int nPage;
20d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20d30 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
20d40 66 20 70 61 67 65 73 20 69 6e 20 70 50 61 67 65 f pages in pPage
20d50 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 50 61 [] */. int mxPa
20d60 72 73 65 72 53 74 61 63 6b 3b 20 20 20 20 20 20 rserStack;
20d70 20 20 20 20 20 20 20 20 20 20 2f 2a 20 6d 61 78 /* max
20d80 69 6d 75 6d 20 64 65 70 74 68 20 6f 66 20 74 68 imum depth of th
20d90 65 20 70 61 72 73 65 72 20 73 74 61 63 6b 20 2a e parser stack *
20da0 2f 0a 20 20 69 6e 74 20 73 68 61 72 65 64 43 61 /. int sharedCa
20db0 63 68 65 45 6e 61 62 6c 65 64 3b 20 20 20 20 20 cheEnabled;
20dc0 20 20 20 20 20 20 2f 2a 20 74 72 75 65 20 69 66 /* true if
20dd0 20 73 68 61 72 65 64 2d 63 61 63 68 65 20 6d 6f shared-cache mo
20de0 64 65 20 65 6e 61 62 6c 65 64 20 2a 2f 0a 20 20 de enabled */.
20df0 75 33 32 20 73 7a 50 6d 61 3b 20 20 20 20 20 20 u32 szPma;
20e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20e10 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 53 6f 72 /* Maximum Sor
20e20 74 65 72 20 50 4d 41 20 73 69 7a 65 20 2a 2f 0a ter PMA size */.
20e30 20 20 2f 2a 20 54 68 65 20 61 62 6f 76 65 20 6d /* The above m
20e40 69 67 68 74 20 62 65 20 69 6e 69 74 69 61 6c 69 ight be initiali
20e50 7a 65 64 20 74 6f 20 6e 6f 6e 2d 7a 65 72 6f 2e zed to non-zero.
20e60 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 The following
20e70 6e 65 65 64 20 74 6f 20 61 6c 77 61 79 73 0a 20 need to always.
20e80 20 2a 2a 20 69 6e 69 74 69 61 6c 6c 79 20 62 65 ** initially be
20e90 20 7a 65 72 6f 2c 20 68 6f 77 65 76 65 72 2e 20 zero, however.
20ea0 2a 2f 0a 20 20 69 6e 74 20 69 73 49 6e 69 74 3b */. int isInit;
20eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20ec0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 /* True a
20ed0 66 74 65 72 20 69 6e 69 74 69 61 6c 69 7a 61 74 fter initializat
20ee0 69 6f 6e 20 68 61 73 20 66 69 6e 69 73 68 65 64 ion has finished
20ef0 20 2a 2f 0a 20 20 69 6e 74 20 69 6e 50 72 6f 67 */. int inProg
20f00 72 65 73 73 3b 20 20 20 20 20 20 20 20 20 20 20 ress;
20f10 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
20f20 77 68 69 6c 65 20 69 6e 69 74 69 61 6c 69 7a 61 while initializa
20f30 74 69 6f 6e 20 69 6e 20 70 72 6f 67 72 65 73 73 tion in progress
20f40 20 2a 2f 0a 20 20 69 6e 74 20 69 73 4d 75 74 65 */. int isMute
20f50 78 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 xInit;
20f60 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
20f70 61 66 74 65 72 20 6d 75 74 65 78 65 73 20 61 72 after mutexes ar
20f80 65 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f e initialized */
20f90 0a 20 20 69 6e 74 20 69 73 4d 61 6c 6c 6f 63 49 . int isMallocI
20fa0 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 nit;
20fb0 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 66 74 /* True aft
20fc0 65 72 20 6d 61 6c 6c 6f 63 20 69 73 20 69 6e 69 er malloc is ini
20fd0 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 6e tialized */. in
20fe0 74 20 69 73 50 43 61 63 68 65 49 6e 69 74 3b 20 t isPCacheInit;
20ff0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21000 2f 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 61 /* True after ma
21010 6c 6c 6f 63 20 69 73 20 69 6e 69 74 69 61 6c 69 lloc is initiali
21020 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 zed */. int nRe
21030 66 49 6e 69 74 4d 75 74 65 78 3b 20 20 20 20 20 fInitMutex;
21040 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
21050 6d 62 65 72 20 6f 66 20 75 73 65 72 73 20 6f 66 mber of users of
21060 20 70 49 6e 69 74 4d 75 74 65 78 20 2a 2f 0a 20 pInitMutex */.
21070 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a sqlite3_mutex *
21080 70 49 6e 69 74 4d 75 74 65 78 3b 20 20 20 20 20 pInitMutex;
21090 20 20 20 2f 2a 20 4d 75 74 65 78 20 75 73 65 64 /* Mutex used
210a0 20 62 79 20 73 71 6c 69 74 65 33 5f 69 6e 69 74 by sqlite3_init
210b0 69 61 6c 69 7a 65 28 29 20 2a 2f 0a 20 20 76 6f ialize() */. vo
210c0 69 64 20 28 2a 78 4c 6f 67 29 28 76 6f 69 64 2a id (*xLog)(void*
210d0 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a ,int,const char*
210e0 29 3b 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 66 ); /* Function f
210f0 6f 72 20 6c 6f 67 67 69 6e 67 20 2a 2f 0a 20 20 or logging */.
21100 76 6f 69 64 20 2a 70 4c 6f 67 41 72 67 3b 20 20 void *pLogArg;
21110 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21120 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 /* First ar
21130 67 75 6d 65 6e 74 20 74 6f 20 78 4c 6f 67 28 29 gument to xLog()
21140 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 */.#ifdef SQLIT
21150 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 4c 4f 47 0a E_ENABLE_SQLLOG.
21160 20 20 76 6f 69 64 28 2a 78 53 71 6c 6c 6f 67 29 void(*xSqllog)
21170 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c (void*,sqlite3*,
21180 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 6e 74 const char*, int
21190 29 3b 0a 20 20 76 6f 69 64 20 2a 70 53 71 6c 6c );. void *pSqll
211a0 6f 67 41 72 67 3b 0a 23 65 6e 64 69 66 0a 23 69 ogArg;.#endif.#i
211b0 66 64 65 66 20 53 51 4c 49 54 45 5f 56 44 42 45 fdef SQLITE_VDBE
211c0 5f 43 4f 56 45 52 41 47 45 0a 20 20 2f 2a 20 54 _COVERAGE. /* T
211d0 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 61 6c he following cal
211e0 6c 62 61 63 6b 20 28 69 66 20 6e 6f 74 20 4e 55 lback (if not NU
211f0 4c 4c 29 20 69 73 20 69 6e 76 6f 6b 65 64 20 6f LL) is invoked o
21200 6e 20 65 76 65 72 79 20 56 44 42 45 20 62 72 61 n every VDBE bra
21210 6e 63 68 0a 20 20 2a 2a 20 6f 70 65 72 61 74 69 nch. ** operati
21220 6f 6e 2e 20 20 53 65 74 20 74 68 65 20 63 61 6c on. Set the cal
21230 6c 62 61 63 6b 20 75 73 69 6e 67 20 53 51 4c 49 lback using SQLI
21240 54 45 5f 54 45 53 54 43 54 52 4c 5f 56 44 42 45 TE_TESTCTRL_VDBE
21250 5f 43 4f 56 45 52 41 47 45 2e 0a 20 20 2a 2f 0a _COVERAGE.. */.
21260 20 20 76 6f 69 64 20 28 2a 78 56 64 62 65 42 72 void (*xVdbeBr
21270 61 6e 63 68 29 28 76 6f 69 64 2a 2c 69 6e 74 20 anch)(void*,int
21280 69 53 72 63 4c 69 6e 65 2c 75 38 20 65 54 68 69 iSrcLine,u8 eThi
21290 73 2c 75 38 20 65 4d 78 29 3b 20 20 2f 2a 20 43 s,u8 eMx); /* C
212a0 61 6c 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 allback */. voi
212b0 64 20 2a 70 56 64 62 65 42 72 61 6e 63 68 41 72 d *pVdbeBranchAr
212c0 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 g;
212d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
212e0 20 20 20 20 20 20 20 2f 2a 20 31 73 74 20 61 72 /* 1st ar
212f0 67 75 6d 65 6e 74 20 2a 2f 0a 23 65 6e 64 69 66 gument */.#endif
21300 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
21310 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 OMIT_BUILTIN_TES
21320 54 0a 20 20 69 6e 74 20 28 2a 78 54 65 73 74 43 T. int (*xTestC
21330 61 6c 6c 62 61 63 6b 29 28 69 6e 74 29 3b 20 20 allback)(int);
21340 20 20 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 64 /* Invoked
21350 20 62 79 20 73 71 6c 69 74 65 33 46 61 75 6c 74 by sqlite3Fault
21360 53 69 6d 28 29 20 2a 2f 0a 23 65 6e 64 69 66 0a Sim() */.#endif.
21370 20 20 69 6e 74 20 62 4c 6f 63 61 6c 74 69 6d 65 int bLocaltime
21380 46 61 75 6c 74 3b 20 20 20 20 20 20 20 20 20 20 Fault;
21390 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 66 /* True to f
213a0 61 69 6c 20 6c 6f 63 61 6c 74 69 6d 65 28 29 20 ail localtime()
213b0 63 61 6c 6c 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a calls */.};../*.
213c0 2a 2a 20 54 68 69 73 20 6d 61 63 72 6f 20 69 73 ** This macro is
213d0 20 75 73 65 64 20 69 6e 73 69 64 65 20 6f 66 20 used inside of
213e0 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
213f0 6e 74 73 20 74 6f 20 69 6e 64 69 63 61 74 65 20 nts to indicate
21400 74 68 61 74 0a 2a 2a 20 74 68 65 20 61 73 73 65 that.** the asse
21410 72 74 20 69 73 20 6f 6e 6c 79 20 76 61 6c 69 64 rt is only valid
21420 20 6f 6e 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65 on a well-forme
21430 64 20 64 61 74 61 62 61 73 65 2e 20 20 49 6e 73 d database. Ins
21440 74 65 61 64 20 6f 66 3a 0a 2a 2a 0a 2a 2a 20 20 tead of:.**.**
21450 20 20 20 61 73 73 65 72 74 28 20 58 20 29 3b 0a assert( X );.
21460 2a 2a 0a 2a 2a 20 4f 6e 65 20 77 72 69 74 65 73 **.** One writes
21470 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 73 73 65 :.**.** asse
21480 72 74 28 20 58 20 7c 7c 20 43 4f 52 52 55 50 54 rt( X || CORRUPT
21490 5f 44 42 20 29 3b 0a 2a 2a 0a 2a 2a 20 43 4f 52 _DB );.**.** COR
214a0 52 55 50 54 5f 44 42 20 69 73 20 74 72 75 65 20 RUPT_DB is true
214b0 64 75 72 69 6e 67 20 6e 6f 72 6d 61 6c 20 6f 70 during normal op
214c0 65 72 61 74 69 6f 6e 2e 20 20 43 4f 52 52 55 50 eration. CORRUP
214d0 54 5f 44 42 20 64 6f 65 73 20 6e 6f 74 20 69 6e T_DB does not in
214e0 64 69 63 61 74 65 0a 2a 2a 20 74 68 61 74 20 74 dicate.** that t
214f0 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 64 he database is d
21500 65 66 69 6e 69 74 65 6c 79 20 63 6f 72 72 75 70 efinitely corrup
21510 74 2c 20 6f 6e 6c 79 20 74 68 61 74 20 69 74 20 t, only that it
21520 6d 69 67 68 74 20 62 65 20 63 6f 72 72 75 70 74 might be corrupt
21530 2e 0a 2a 2a 20 46 6f 72 20 6d 6f 73 74 20 74 65 ..** For most te
21540 73 74 20 63 61 73 65 73 2c 20 43 4f 52 52 55 50 st cases, CORRUP
21550 54 5f 44 42 20 69 73 20 73 65 74 20 74 6f 20 66 T_DB is set to f
21560 61 6c 73 65 20 75 73 69 6e 67 20 61 20 73 70 65 alse using a spe
21570 63 69 61 6c 0a 2a 2a 20 73 71 6c 69 74 65 33 5f cial.** sqlite3_
21580 74 65 73 74 5f 63 6f 6e 74 72 6f 6c 28 29 2e 20 test_control().
21590 20 54 68 69 73 20 65 6e 61 62 6c 65 73 20 61 73 This enables as
215a0 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 sert() statement
215b0 73 20 74 6f 20 70 72 6f 76 65 0a 2a 2a 20 74 68 s to prove.** th
215c0 69 6e 67 73 20 74 68 61 74 20 61 72 65 20 61 6c ings that are al
215d0 77 61 79 73 20 74 72 75 65 20 66 6f 72 20 77 65 ways true for we
215e0 6c 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 ll-formed databa
215f0 73 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ses..*/.#define
21600 43 4f 52 52 55 50 54 5f 44 42 20 20 28 73 71 6c CORRUPT_DB (sql
21610 69 74 65 33 43 6f 6e 66 69 67 2e 6e 65 76 65 72 ite3Config.never
21620 43 6f 72 72 75 70 74 3d 3d 30 29 0a 0a 2f 2a 0a Corrupt==0)../*.
21630 2a 2a 20 43 6f 6e 74 65 78 74 20 70 6f 69 6e 74 ** Context point
21640 65 72 20 70 61 73 73 65 64 20 64 6f 77 6e 20 74 er passed down t
21650 68 72 6f 75 67 68 20 74 68 65 20 74 72 65 65 2d hrough the tree-
21660 77 61 6c 6b 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 walk..*/.struct
21670 57 61 6c 6b 65 72 20 7b 0a 20 20 50 61 72 73 65 Walker {. Parse
21680 20 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 20 *pParse;
21690 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
216a0 20 20 20 20 20 2f 2a 20 50 61 72 73 65 72 20 63 /* Parser c
216b0 6f 6e 74 65 78 74 2e 20 20 2a 2f 0a 20 20 69 6e ontext. */. in
216c0 74 20 28 2a 78 45 78 70 72 43 61 6c 6c 62 61 63 t (*xExprCallbac
216d0 6b 29 28 57 61 6c 6b 65 72 2a 2c 20 45 78 70 72 k)(Walker*, Expr
216e0 2a 29 3b 20 20 20 20 20 2f 2a 20 43 61 6c 6c 62 *); /* Callb
216f0 61 63 6b 20 66 6f 72 20 65 78 70 72 65 73 73 69 ack for expressi
21700 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 ons */. int (*x
21710 53 65 6c 65 63 74 43 61 6c 6c 62 61 63 6b 29 28 SelectCallback)(
21720 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 63 74 2a 29 Walker*,Select*)
21730 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 66 ; /* Callback f
21740 6f 72 20 53 45 4c 45 43 54 73 20 2a 2f 0a 20 20 or SELECTs */.
21750 76 6f 69 64 20 28 2a 78 53 65 6c 65 63 74 43 61 void (*xSelectCa
21760 6c 6c 62 61 63 6b 32 29 28 57 61 6c 6b 65 72 2a llback2)(Walker*
21770 2c 53 65 6c 65 63 74 2a 29 3b 2f 2a 20 53 65 63 ,Select*);/* Sec
21780 6f 6e 64 20 63 61 6c 6c 62 61 63 6b 20 66 6f 72 ond callback for
21790 20 53 45 4c 45 43 54 73 20 2a 2f 0a 20 20 69 6e SELECTs */. in
217a0 74 20 77 61 6c 6b 65 72 44 65 70 74 68 3b 20 20 t walkerDepth;
217b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
217c0 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
217d0 72 20 6f 66 20 73 75 62 71 75 65 72 69 65 73 20 r of subqueries
217e0 2a 2f 0a 20 20 75 38 20 65 43 6f 64 65 3b 20 20 */. u8 eCode;
217f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21800 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
21810 2a 20 41 20 73 6d 61 6c 6c 20 70 72 6f 63 65 73 * A small proces
21820 73 69 6e 67 20 63 6f 64 65 20 2a 2f 0a 20 20 75 sing code */. u
21830 6e 69 6f 6e 20 7b 20 20 20 20 20 20 20 20 20 20 nion {
21840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21850 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 74 72 /* Extr
21860 61 20 64 61 74 61 20 66 6f 72 20 63 61 6c 6c 62 a data for callb
21870 61 63 6b 20 2a 2f 0a 20 20 20 20 4e 61 6d 65 43 ack */. NameC
21880 6f 6e 74 65 78 74 20 2a 70 4e 43 3b 20 20 20 20 ontext *pNC;
21890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
218a0 20 20 20 20 20 20 2f 2a 20 4e 61 6d 69 6e 67 20 /* Naming
218b0 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 20 20 69 context */. i
218c0 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20 20 20 nt n;
218d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
218e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 63 /* A c
218f0 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 20 20 69 6e ounter */. in
21900 74 20 69 43 75 72 3b 20 20 20 20 20 20 20 20 20 t iCur;
21910 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21920 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 63 75 /* A cu
21930 72 73 6f 72 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 rsor number */.
21940 20 20 20 53 72 63 4c 69 73 74 20 2a 70 53 72 63 SrcList *pSrc
21950 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 List;
21960 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
21970 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a FROM clause */.
21980 20 20 20 20 73 74 72 75 63 74 20 53 72 63 43 6f struct SrcCo
21990 75 6e 74 20 2a 70 53 72 63 43 6f 75 6e 74 3b 20 unt *pSrcCount;
219a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
219b0 2a 20 43 6f 75 6e 74 69 6e 67 20 63 6f 6c 75 6d * Counting colum
219c0 6e 20 72 65 66 65 72 65 6e 63 65 73 20 2a 2f 0a n references */.
219d0 20 20 20 20 73 74 72 75 63 74 20 43 43 75 72 48 struct CCurH
219e0 69 6e 74 20 2a 70 43 43 75 72 48 69 6e 74 3b 20 int *pCCurHint;
219f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
21a00 2a 20 55 73 65 64 20 62 79 20 63 6f 64 65 43 75 * Used by codeCu
21a10 72 73 6f 72 48 69 6e 74 28 29 20 2a 2f 0a 20 20 rsorHint() */.
21a20 20 20 69 6e 74 20 2a 61 69 43 6f 6c 3b 20 20 20 int *aiCol;
21a30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21a40 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
21a50 61 72 72 61 79 20 6f 66 20 63 6f 6c 75 6d 6e 20 array of column
21a60 69 6e 64 65 78 65 73 20 2a 2f 0a 20 20 7d 20 75 indexes */. } u
21a70 3b 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 ;.};../* Forward
21a80 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 2a 2f declarations */
21a90 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c 6b .int sqlite3Walk
21aa0 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 45 78 Expr(Walker*, Ex
21ab0 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 pr*);.int sqlite
21ac0 33 57 61 6c 6b 45 78 70 72 4c 69 73 74 28 57 61 3WalkExprList(Wa
21ad0 6c 6b 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a lker*, ExprList*
21ae0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 );.int sqlite3Wa
21af0 6c 6b 53 65 6c 65 63 74 28 57 61 6c 6b 65 72 2a lkSelect(Walker*
21b00 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 , Select*);.int
21b10 73 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 sqlite3WalkSelec
21b20 74 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 53 tExpr(Walker*, S
21b30 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c elect*);.int sql
21b40 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 46 72 ite3WalkSelectFr
21b50 6f 6d 28 57 61 6c 6b 65 72 2a 2c 20 53 65 6c 65 om(Walker*, Sele
21b60 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 ct*);.int sqlite
21b70 33 45 78 70 72 57 61 6c 6b 4e 6f 6f 70 28 57 61 3ExprWalkNoop(Wa
21b80 6c 6b 65 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 0a lker*, Expr*);..
21b90 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 63 6f 64 /*.** Return cod
21ba0 65 20 66 72 6f 6d 20 74 68 65 20 70 61 72 73 65 e from the parse
21bb0 2d 74 72 65 65 20 77 61 6c 6b 69 6e 67 20 70 72 -tree walking pr
21bc0 69 6d 69 74 69 76 65 73 20 61 6e 64 20 74 68 65 imitives and the
21bd0 69 72 0a 2a 2a 20 63 61 6c 6c 62 61 63 6b 73 2e ir.** callbacks.
21be0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 57 52 43 5f .*/.#define WRC_
21bf0 43 6f 6e 74 69 6e 75 65 20 20 20 20 30 20 20 20 Continue 0
21c00 2f 2a 20 43 6f 6e 74 69 6e 75 65 20 64 6f 77 6e /* Continue down
21c10 20 69 6e 74 6f 20 63 68 69 6c 64 72 65 6e 20 2a into children *
21c20 2f 0a 23 64 65 66 69 6e 65 20 57 52 43 5f 50 72 /.#define WRC_Pr
21c30 75 6e 65 20 20 20 20 20 20 20 31 20 20 20 2f 2a une 1 /*
21c40 20 4f 6d 69 74 20 63 68 69 6c 64 72 65 6e 20 62 Omit children b
21c50 75 74 20 63 6f 6e 74 69 6e 75 65 20 77 61 6c 6b ut continue walk
21c60 69 6e 67 20 73 69 62 6c 69 6e 67 73 20 2a 2f 0a ing siblings */.
21c70 23 64 65 66 69 6e 65 20 57 52 43 5f 41 62 6f 72 #define WRC_Abor
21c80 74 20 20 20 20 20 20 20 32 20 20 20 2f 2a 20 41 t 2 /* A
21c90 62 61 6e 64 6f 6e 20 74 68 65 20 74 72 65 65 20 bandon the tree
21ca0 77 61 6c 6b 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 walk */../*.** A
21cb0 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 n instance of th
21cc0 69 73 20 73 74 72 75 63 74 75 72 65 20 72 65 70 is structure rep
21cd0 72 65 73 65 6e 74 73 20 61 20 73 65 74 20 6f 66 resents a set of
21ce0 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 43 54 45 one or more CTE
21cf0 73 0a 2a 2a 20 28 63 6f 6d 6d 6f 6e 20 74 61 62 s.** (common tab
21d00 6c 65 20 65 78 70 72 65 73 73 69 6f 6e 73 29 20 le expressions)
21d10 63 72 65 61 74 65 64 20 62 79 20 61 20 73 69 6e created by a sin
21d20 67 6c 65 20 57 49 54 48 20 63 6c 61 75 73 65 2e gle WITH clause.
21d30 0a 2a 2f 0a 73 74 72 75 63 74 20 57 69 74 68 20 .*/.struct With
21d40 7b 0a 20 20 69 6e 74 20 6e 43 74 65 3b 20 20 20 {. int nCte;
21d50 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21d60 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
21d70 20 43 54 45 73 20 69 6e 20 74 68 65 20 57 49 54 CTEs in the WIT
21d80 48 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 57 69 H clause */. Wi
21d90 74 68 20 2a 70 4f 75 74 65 72 3b 20 20 20 20 20 th *pOuter;
21da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
21db0 20 43 6f 6e 74 61 69 6e 69 6e 67 20 57 49 54 48 Containing WITH
21dc0 20 63 6c 61 75 73 65 2c 20 6f 72 20 4e 55 4c 4c clause, or NULL
21dd0 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 43 74 65 */. struct Cte
21de0 20 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
21df0 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 /* For eac
21e00 68 20 43 54 45 20 69 6e 20 74 68 65 20 57 49 54 h CTE in the WIT
21e10 48 20 63 6c 61 75 73 65 2e 2e 2e 2e 20 2a 2f 0a H clause.... */.
21e20 20 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b char *zName;
21e30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21e40 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 /* Name of t
21e50 68 69 73 20 43 54 45 20 2a 2f 0a 20 20 20 20 45 his CTE */. E
21e60 78 70 72 4c 69 73 74 20 2a 70 43 6f 6c 73 3b 20 xprList *pCols;
21e70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
21e80 2a 20 4c 69 73 74 20 6f 66 20 65 78 70 6c 69 63 * List of explic
21e90 69 74 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 2c it column names,
21ea0 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20 20 or NULL */.
21eb0 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 3b Select *pSelect;
21ec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21ed0 2f 2a 20 54 68 65 20 64 65 66 69 6e 69 74 69 6f /* The definitio
21ee0 6e 20 6f 66 20 74 68 69 73 20 43 54 45 20 2a 2f n of this CTE */
21ef0 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 . const char
21f00 2a 7a 43 74 65 45 72 72 3b 20 20 20 20 20 20 20 *zCteErr;
21f10 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20 6d 65 /* Error me
21f20 73 73 61 67 65 20 66 6f 72 20 63 69 72 63 75 6c ssage for circul
21f30 61 72 20 72 65 66 65 72 65 6e 63 65 73 20 2a 2f ar references */
21f40 0a 20 20 7d 20 61 5b 31 5d 3b 0a 7d 3b 0a 0a 23 . } a[1];.};..#
21f50 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
21f60 55 47 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 UG./*.** An inst
21f70 61 6e 63 65 20 6f 66 20 74 68 65 20 54 72 65 65 ance of the Tree
21f80 56 69 65 77 20 6f 62 6a 65 63 74 20 69 73 20 75 View object is u
21f90 73 65 64 20 66 6f 72 20 70 72 69 6e 74 69 6e 67 sed for printing
21fa0 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f 66 0a the content of.
21fb0 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75 72 ** data structur
21fc0 65 73 20 6f 6e 20 73 71 6c 69 74 65 33 44 65 62 es on sqlite3Deb
21fd0 75 67 50 72 69 6e 74 66 28 29 20 75 73 69 6e 67 ugPrintf() using
21fe0 20 61 20 74 72 65 65 2d 6c 69 6b 65 20 76 69 65 a tree-like vie
21ff0 77 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 54 72 65 w..*/.struct Tre
22000 65 56 69 65 77 20 7b 0a 20 20 69 6e 74 20 69 4c eView {. int iL
22010 65 76 65 6c 3b 20 20 20 20 20 20 20 20 20 20 20 evel;
22020 20 20 2f 2a 20 57 68 69 63 68 20 6c 65 76 65 6c /* Which level
22030 20 6f 66 20 74 68 65 20 74 72 65 65 20 77 65 20 of the tree we
22040 61 72 65 20 6f 6e 20 2a 2f 0a 20 20 75 38 20 20 are on */. u8
22050 62 4c 69 6e 65 5b 31 30 30 5d 3b 20 20 20 20 20 bLine[100];
22060 20 20 20 20 2f 2a 20 44 72 61 77 20 76 65 72 74 /* Draw vert
22070 69 63 61 6c 20 69 6e 20 63 6f 6c 75 6d 6e 20 69 ical in column i
22080 20 69 66 20 62 4c 69 6e 65 5b 69 5d 20 69 73 20 if bLine[i] is
22090 74 72 75 65 20 2a 2f 0a 7d 3b 0a 23 65 6e 64 69 true */.};.#endi
220a0 66 20 2f 2a 20 53 51 4c 49 54 45 5f 44 45 42 55 f /* SQLITE_DEBU
220b0 47 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 75 G */../*.** Assu
220c0 6d 69 6e 67 20 7a 49 6e 20 70 6f 69 6e 74 73 20 ming zIn points
220d0 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 to the first byt
220e0 65 20 6f 66 20 61 20 55 54 46 2d 38 20 63 68 61 e of a UTF-8 cha
220f0 72 61 63 74 65 72 2c 0a 2a 2a 20 61 64 76 61 6e racter,.** advan
22100 63 65 20 7a 49 6e 20 74 6f 20 70 6f 69 6e 74 20 ce zIn to point
22110 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 74 to the first byt
22120 65 20 6f 66 20 74 68 65 20 6e 65 78 74 20 55 54 e of the next UT
22130 46 2d 38 20 63 68 61 72 61 63 74 65 72 2e 0a 2a F-8 character..*
22140 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
22150 5f 53 4b 49 50 5f 55 54 46 38 28 7a 49 6e 29 20 _SKIP_UTF8(zIn)
22160 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
22170 20 20 20 20 20 20 20 20 20 5c 0a 20 20 69 66 28 \. if(
22180 20 28 2a 28 7a 49 6e 2b 2b 29 29 3e 3d 30 78 63 (*(zIn++))>=0xc
22190 30 20 29 7b 20 20 20 20 20 20 20 20 20 20 20 20 0 ){
221a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
221b0 20 20 5c 0a 20 20 20 20 77 68 69 6c 65 28 20 28 \. while( (
221c0 2a 7a 49 6e 20 26 20 30 78 63 30 29 3d 3d 30 78 *zIn & 0xc0)==0x
221d0 38 30 20 29 7b 20 7a 49 6e 2b 2b 3b 20 7d 20 20 80 ){ zIn++; }
221e0 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 7d \. }
221f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22220 20 20 20 20 5c 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 \.}../*.** T
22230 68 65 20 53 51 4c 49 54 45 5f 2a 5f 42 4b 50 54 he SQLITE_*_BKPT
22240 20 6d 61 63 72 6f 73 20 61 72 65 20 73 75 62 73 macros are subs
22250 74 69 74 75 74 65 73 20 66 6f 72 20 74 68 65 20 titutes for the
22260 65 72 72 6f 72 20 63 6f 64 65 73 20 77 69 74 68 error codes with
22270 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 61 6d .** the same nam
22280 65 20 62 75 74 20 77 69 74 68 6f 75 74 20 74 68 e but without th
22290 65 20 5f 42 4b 50 54 20 73 75 66 66 69 78 2e 20 e _BKPT suffix.
222a0 20 54 68 65 73 65 20 6d 61 63 72 6f 73 20 69 6e These macros in
222b0 76 6f 6b 65 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 voke.** routines
222c0 20 74 68 61 74 20 72 65 70 6f 72 74 20 74 68 65 that report the
222d0 20 6c 69 6e 65 2d 6e 75 6d 62 65 72 20 6f 6e 20 line-number on
222e0 77 68 69 63 68 20 74 68 65 20 65 72 72 6f 72 20 which the error
222f0 6f 72 69 67 69 6e 61 74 65 64 0a 2a 2a 20 75 73 originated.** us
22300 69 6e 67 20 73 71 6c 69 74 65 33 5f 6c 6f 67 28 ing sqlite3_log(
22310 29 2e 20 20 54 68 65 20 72 6f 75 74 69 6e 65 73 ). The routines
22320 20 61 6c 73 6f 20 70 72 6f 76 69 64 65 20 61 20 also provide a
22330 63 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 65 convenient place
22340 0a 2a 2a 20 74 6f 20 73 65 74 20 61 20 64 65 62 .** to set a deb
22350 75 67 67 65 72 20 62 72 65 61 6b 70 6f 69 6e 74 ugger breakpoint
22360 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
22370 43 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 74 CorruptError(int
22380 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 69 );.int sqlite3Mi
22390 73 75 73 65 45 72 72 6f 72 28 69 6e 74 29 3b 0a suseError(int);.
223a0 69 6e 74 20 73 71 6c 69 74 65 33 43 61 6e 74 6f int sqlite3Canto
223b0 70 65 6e 45 72 72 6f 72 28 69 6e 74 29 3b 0a 23 penError(int);.#
223c0 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 4f define SQLITE_CO
223d0 52 52 55 50 54 5f 42 4b 50 54 20 73 71 6c 69 74 RRUPT_BKPT sqlit
223e0 65 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 5f e3CorruptError(_
223f0 5f 4c 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e 65 _LINE__).#define
22400 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 SQLITE_MISUSE_B
22410 4b 50 54 20 73 71 6c 69 74 65 33 4d 69 73 75 73 KPT sqlite3Misus
22420 65 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 eError(__LINE__)
22430 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
22440 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 20 73 71 CANTOPEN_BKPT sq
22450 6c 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 72 lite3CantopenErr
22460 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 69 66 or(__LINE__).#if
22470 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
22480 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 4e 6f . int sqlite3No
22490 6d 65 6d 45 72 72 6f 72 28 69 6e 74 29 3b 0a 20 memError(int);.
224a0 20 69 6e 74 20 73 71 6c 69 74 65 33 49 6f 65 72 int sqlite3Ioer
224b0 72 6e 6f 6d 65 6d 45 72 72 6f 72 28 69 6e 74 29 rnomemError(int)
224c0 3b 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ;.# define SQLIT
224d0 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 73 71 6c E_NOMEM_BKPT sql
224e0 69 74 65 33 4e 6f 6d 65 6d 45 72 72 6f 72 28 5f ite3NomemError(_
224f0 5f 4c 49 4e 45 5f 5f 29 0a 23 20 64 65 66 69 6e _LINE__).# defin
22500 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e e SQLITE_IOERR_N
22510 4f 4d 45 4d 5f 42 4b 50 54 20 73 71 6c 69 74 65 OMEM_BKPT sqlite
22520 33 49 6f 65 72 72 6e 6f 6d 65 6d 45 72 72 6f 72 3IoerrnomemError
22530 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 65 6c 73 65 (__LINE__).#else
22540 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
22550 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 53 51 4c 49 _NOMEM_BKPT SQLI
22560 54 45 5f 4e 4f 4d 45 4d 0a 23 20 64 65 66 69 6e TE_NOMEM.# defin
22570 65 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e e SQLITE_IOERR_N
22580 4f 4d 45 4d 5f 42 4b 50 54 20 53 51 4c 49 54 45 OMEM_BKPT SQLITE
22590 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 0a 23 65 6e _IOERR_NOMEM.#en
225a0 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 54 53 33 20 dif../*.** FTS3
225b0 61 6e 64 20 46 54 53 34 20 62 6f 74 68 20 72 65 and FTS4 both re
225c0 71 75 69 72 65 20 76 69 72 74 75 61 6c 20 74 61 quire virtual ta
225d0 62 6c 65 20 73 75 70 70 6f 72 74 0a 2a 2f 0a 23 ble support.*/.#
225e0 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
225f0 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 E_OMIT_VIRTUALTA
22600 42 4c 45 29 0a 23 20 75 6e 64 65 66 20 53 51 4c BLE).# undef SQL
22610 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 0a ITE_ENABLE_FTS3.
22620 23 20 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 # undef SQLITE_E
22630 4e 41 42 4c 45 5f 46 54 53 34 0a 23 65 6e 64 69 NABLE_FTS4.#endi
22640 66 0a 0a 2f 2a 0a 2a 2a 20 46 54 53 34 20 69 73 f../*.** FTS4 is
22650 20 72 65 61 6c 6c 79 20 61 6e 20 65 78 74 65 6e really an exten
22660 73 69 6f 6e 20 66 6f 72 20 46 54 53 33 2e 20 20 sion for FTS3.
22670 49 74 20 69 73 20 65 6e 61 62 6c 65 64 20 75 73 It is enabled us
22680 69 6e 67 20 74 68 65 0a 2a 2a 20 53 51 4c 49 54 ing the.** SQLIT
22690 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 20 6d 61 E_ENABLE_FTS3 ma
226a0 63 72 6f 2e 20 20 42 75 74 20 74 6f 20 61 76 6f cro. But to avo
226b0 69 64 20 63 6f 6e 66 75 73 69 6f 6e 20 77 65 20 id confusion we
226c0 61 6c 73 6f 20 63 61 6c 6c 0a 2a 2a 20 74 68 65 also call.** the
226d0 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 SQLITE_ENABLE_F
226e0 54 53 34 20 6d 61 63 72 6f 20 74 6f 20 73 65 72 TS4 macro to ser
226f0 76 65 20 61 73 20 61 6e 20 61 6c 69 61 73 20 66 ve as an alias f
22700 6f 72 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 or SQLITE_ENABLE
22710 5f 46 54 53 33 2e 0a 2a 2f 0a 23 69 66 20 64 65 _FTS3..*/.#if de
22720 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
22730 42 4c 45 5f 46 54 53 34 29 20 26 26 20 21 64 65 BLE_FTS4) && !de
22740 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 fined(SQLITE_ENA
22750 42 4c 45 5f 46 54 53 33 29 0a 23 20 64 65 66 69 BLE_FTS3).# defi
22760 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ne SQLITE_ENABLE
22770 5f 46 54 53 33 20 31 0a 23 65 6e 64 69 66 0a 0a _FTS3 1.#endif..
22780 2f 2a 0a 2a 2a 20 54 68 65 20 63 74 79 70 65 2e /*.** The ctype.
22790 68 20 68 65 61 64 65 72 20 69 73 20 6e 65 65 64 h header is need
227a0 65 64 20 66 6f 72 20 6e 6f 6e 2d 41 53 43 49 49 ed for non-ASCII
227b0 20 73 79 73 74 65 6d 73 2e 20 20 49 74 20 69 73 systems. It is
227c0 20 61 6c 73 6f 0a 2a 2a 20 6e 65 65 64 65 64 20 also.** needed
227d0 62 79 20 46 54 53 33 20 77 68 65 6e 20 46 54 53 by FTS3 when FTS
227e0 33 20 69 73 20 69 6e 63 6c 75 64 65 64 20 69 6e 3 is included in
227f0 20 74 68 65 20 61 6d 61 6c 67 61 6d 61 74 69 6f the amalgamatio
22800 6e 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e n..*/.#if !defin
22810 65 64 28 53 51 4c 49 54 45 5f 41 53 43 49 49 29 ed(SQLITE_ASCII)
22820 20 7c 7c 20 5c 0a 20 20 20 20 28 64 65 66 69 6e || \. (defin
22830 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
22840 5f 46 54 53 33 29 20 26 26 20 64 65 66 69 6e 65 _FTS3) && define
22850 64 28 53 51 4c 49 54 45 5f 41 4d 41 4c 47 41 4d d(SQLITE_AMALGAM
22860 41 54 49 4f 4e 29 29 0a 23 20 69 6e 63 6c 75 64 ATION)).# includ
22870 65 20 3c 63 74 79 70 65 2e 68 3e 0a 23 65 6e 64 e <ctype.h>.#end
22880 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f if../*.** The fo
22890 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 20 6d llowing macros m
228a0 69 6d 69 63 20 74 68 65 20 73 74 61 6e 64 61 72 imic the standar
228b0 64 20 6c 69 62 72 61 72 79 20 66 75 6e 63 74 69 d library functi
228c0 6f 6e 73 20 74 6f 75 70 70 65 72 28 29 2c 0a 2a ons toupper(),.*
228d0 2a 20 69 73 73 70 61 63 65 28 29 2c 20 69 73 61 * isspace(), isa
228e0 6c 6e 75 6d 28 29 2c 20 69 73 64 69 67 69 74 28 lnum(), isdigit(
228f0 29 20 61 6e 64 20 69 73 78 64 69 67 69 74 28 29 ) and isxdigit()
22900 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e 20 , respectively.
22910 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 20 76 65 The.** sqlite ve
22920 72 73 69 6f 6e 73 20 6f 6e 6c 79 20 77 6f 72 6b rsions only work
22930 20 66 6f 72 20 41 53 43 49 49 20 63 68 61 72 61 for ASCII chara
22940 63 74 65 72 73 2c 20 72 65 67 61 72 64 6c 65 73 cters, regardles
22950 73 20 6f 66 20 6c 6f 63 61 6c 65 2e 0a 2a 2f 0a s of locale..*/.
22960 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 41 53 #ifdef SQLITE_AS
22970 43 49 49 0a 23 20 64 65 66 69 6e 65 20 73 71 6c CII.# define sql
22980 69 74 65 33 54 6f 75 70 70 65 72 28 78 29 20 20 ite3Toupper(x)
22990 28 28 78 29 26 7e 28 73 71 6c 69 74 65 33 43 74 ((x)&~(sqlite3Ct
229a0 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 64 ypeMap[(unsigned
229b0 20 63 68 61 72 29 28 78 29 5d 26 30 78 32 30 29 char)(x)]&0x20)
229c0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
229d0 65 33 49 73 73 70 61 63 65 28 78 29 20 20 20 28 e3Isspace(x) (
229e0 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b sqlite3CtypeMap[
229f0 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
22a00 78 29 5d 26 30 78 30 31 29 0a 23 20 64 65 66 69 x)]&0x01).# defi
22a10 6e 65 20 73 71 6c 69 74 65 33 49 73 61 6c 6e 75 ne sqlite3Isalnu
22a20 6d 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 m(x) (sqlite3C
22a30 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 typeMap[(unsigne
22a40 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 36 d char)(x)]&0x06
22a50 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
22a60 65 33 49 73 61 6c 70 68 61 28 78 29 20 20 20 28 e3Isalpha(x) (
22a70 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b sqlite3CtypeMap[
22a80 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
22a90 78 29 5d 26 30 78 30 32 29 0a 23 20 64 65 66 69 x)]&0x02).# defi
22aa0 6e 65 20 73 71 6c 69 74 65 33 49 73 64 69 67 69 ne sqlite3Isdigi
22ab0 74 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 43 t(x) (sqlite3C
22ac0 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 67 6e 65 typeMap[(unsigne
22ad0 64 20 63 68 61 72 29 28 78 29 5d 26 30 78 30 34 d char)(x)]&0x04
22ae0 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
22af0 65 33 49 73 78 64 69 67 69 74 28 78 29 20 20 28 e3Isxdigit(x) (
22b00 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 70 5b sqlite3CtypeMap[
22b10 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
22b20 78 29 5d 26 30 78 30 38 29 0a 23 20 64 65 66 69 x)]&0x08).# defi
22b30 6e 65 20 73 71 6c 69 74 65 33 54 6f 6c 6f 77 65 ne sqlite3Tolowe
22b40 72 28 78 29 20 20 20 28 73 71 6c 69 74 65 33 55 r(x) (sqlite3U
22b50 70 70 65 72 54 6f 4c 6f 77 65 72 5b 28 75 6e 73 pperToLower[(uns
22b60 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d 29 igned char)(x)])
22b70 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
22b80 73 71 6c 69 74 65 33 54 6f 75 70 70 65 72 28 78 sqlite3Toupper(x
22b90 29 20 20 20 74 6f 75 70 70 65 72 28 28 75 6e 73 ) toupper((uns
22ba0 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a igned char)(x)).
22bb0 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
22bc0 49 73 73 70 61 63 65 28 78 29 20 20 20 69 73 73 Isspace(x) iss
22bd0 70 61 63 65 28 28 75 6e 73 69 67 6e 65 64 20 63 pace((unsigned c
22be0 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e har)(x)).# defin
22bf0 65 20 73 71 6c 69 74 65 33 49 73 61 6c 6e 75 6d e sqlite3Isalnum
22c00 28 78 29 20 20 20 69 73 61 6c 6e 75 6d 28 28 75 (x) isalnum((u
22c10 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
22c20 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
22c30 65 33 49 73 61 6c 70 68 61 28 78 29 20 20 20 69 e3Isalpha(x) i
22c40 73 61 6c 70 68 61 28 28 75 6e 73 69 67 6e 65 64 salpha((unsigned
22c50 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 char)(x)).# def
22c60 69 6e 65 20 73 71 6c 69 74 65 33 49 73 64 69 67 ine sqlite3Isdig
22c70 69 74 28 78 29 20 20 20 69 73 64 69 67 69 74 28 it(x) isdigit(
22c80 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
22c90 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c x)).# define sql
22ca0 69 74 65 33 49 73 78 64 69 67 69 74 28 78 29 20 ite3Isxdigit(x)
22cb0 20 69 73 78 64 69 67 69 74 28 28 75 6e 73 69 67 isxdigit((unsig
22cc0 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 ned char)(x)).#
22cd0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 6f define sqlite3To
22ce0 6c 6f 77 65 72 28 78 29 20 20 20 74 6f 6c 6f 77 lower(x) tolow
22cf0 65 72 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 er((unsigned cha
22d00 72 29 28 78 29 29 0a 23 65 6e 64 69 66 0a 23 69 r)(x)).#endif.#i
22d10 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
22d20 54 5f 43 4f 4d 50 49 4c 45 4f 50 54 49 4f 4e 5f T_COMPILEOPTION_
22d30 44 49 41 47 53 0a 69 6e 74 20 73 71 6c 69 74 65 DIAGS.int sqlite
22d40 33 49 73 49 64 43 68 61 72 28 75 38 29 3b 0a 23 3IsIdChar(u8);.#
22d50 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 endif../*.** Int
22d60 65 72 6e 61 6c 20 66 75 6e 63 74 69 6f 6e 20 70 ernal function p
22d70 72 6f 74 6f 74 79 70 65 73 0a 2a 2f 0a 69 6e 74 rototypes.*/.int
22d80 20 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 sqlite3StrICmp(
22d90 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 const char*,cons
22da0 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 t char*);.int sq
22db0 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 63 6f lite3Strlen30(co
22dc0 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 64 65 66 nst char*);.#def
22dd0 69 6e 65 20 73 71 6c 69 74 65 33 53 74 72 4e 49 ine sqlite3StrNI
22de0 43 6d 70 20 73 71 6c 69 74 65 33 5f 73 74 72 6e Cmp sqlite3_strn
22df0 69 63 6d 70 0a 0a 69 6e 74 20 73 71 6c 69 74 65 icmp..int sqlite
22e00 33 4d 61 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 3MallocInit(void
22e10 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d );.void sqlite3M
22e20 61 6c 6c 6f 63 45 6e 64 28 76 6f 69 64 29 3b 0a allocEnd(void);.
22e30 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c void *sqlite3Mal
22e40 6c 6f 63 28 75 36 34 29 3b 0a 76 6f 69 64 20 2a loc(u64);.void *
22e50 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 sqlite3MallocZer
22e60 6f 28 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 o(u64);.void *sq
22e70 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 lite3DbMallocZer
22e80 6f 28 73 71 6c 69 74 65 33 2a 2c 20 75 36 34 29 o(sqlite3*, u64)
22e90 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 ;.void *sqlite3D
22ea0 62 4d 61 6c 6c 6f 63 52 61 77 28 73 71 6c 69 74 bMallocRaw(sqlit
22eb0 65 33 2a 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 e3*, u64);.void
22ec0 2a 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 *sqlite3DbMalloc
22ed0 52 61 77 4e 4e 28 73 71 6c 69 74 65 33 2a 2c 20 RawNN(sqlite3*,
22ee0 75 36 34 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 u64);.char *sqli
22ef0 74 65 33 44 62 53 74 72 44 75 70 28 73 71 6c 69 te3DbStrDup(sqli
22f00 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
22f10 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
22f20 44 62 53 74 72 4e 44 75 70 28 73 71 6c 69 74 65 DbStrNDup(sqlite
22f30 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 3*,const char*,
22f40 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 u64);.void *sqli
22f50 74 65 33 52 65 61 6c 6c 6f 63 28 76 6f 69 64 2a te3Realloc(void*
22f60 2c 20 75 36 34 29 3b 0a 76 6f 69 64 20 2a 73 71 , u64);.void *sq
22f70 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 4f 72 lite3DbReallocOr
22f80 46 72 65 65 28 73 71 6c 69 74 65 33 20 2a 2c 20 Free(sqlite3 *,
22f90 76 6f 69 64 20 2a 2c 20 75 36 34 29 3b 0a 76 6f void *, u64);.vo
22fa0 69 64 20 2a 73 71 6c 69 74 65 33 44 62 52 65 61 id *sqlite3DbRea
22fb0 6c 6c 6f 63 28 73 71 6c 69 74 65 33 20 2a 2c 20 lloc(sqlite3 *,
22fc0 76 6f 69 64 20 2a 2c 20 75 36 34 29 3b 0a 76 6f void *, u64);.vo
22fd0 69 64 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 id sqlite3DbFree
22fe0 28 73 71 6c 69 74 65 33 2a 2c 20 76 6f 69 64 2a (sqlite3*, void*
22ff0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 );.int sqlite3Ma
23000 6c 6c 6f 63 53 69 7a 65 28 76 6f 69 64 2a 29 3b llocSize(void*);
23010 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 62 4d 61 .int sqlite3DbMa
23020 6c 6c 6f 63 53 69 7a 65 28 73 71 6c 69 74 65 33 llocSize(sqlite3
23030 2a 2c 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 *, void*);.void
23040 2a 73 71 6c 69 74 65 33 53 63 72 61 74 63 68 4d *sqlite3ScratchM
23050 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 alloc(int);.void
23060 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 68 46 sqlite3ScratchF
23070 72 65 65 28 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 ree(void*);.void
23080 20 2a 73 71 6c 69 74 65 33 50 61 67 65 4d 61 6c *sqlite3PageMal
23090 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 loc(int);.void s
230a0 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 28 76 qlite3PageFree(v
230b0 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 oid*);.void sqli
230c0 74 65 33 4d 65 6d 53 65 74 44 65 66 61 75 6c 74 te3MemSetDefault
230d0 28 76 6f 69 64 29 3b 0a 23 69 66 6e 64 65 66 20 (void);.#ifndef
230e0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c SQLITE_OMIT_BUIL
230f0 54 49 4e 5f 54 45 53 54 0a 76 6f 69 64 20 73 71 TIN_TEST.void sq
23100 6c 69 74 65 33 42 65 6e 69 67 6e 4d 61 6c 6c 6f lite3BenignMallo
23110 63 48 6f 6f 6b 73 28 76 6f 69 64 20 28 2a 29 28 cHooks(void (*)(
23120 76 6f 69 64 29 2c 20 76 6f 69 64 20 28 2a 29 28 void), void (*)(
23130 76 6f 69 64 29 29 3b 0a 23 65 6e 64 69 66 0a 69 void));.#endif.i
23140 6e 74 20 73 71 6c 69 74 65 33 48 65 61 70 4e 65 nt sqlite3HeapNe
23150 61 72 6c 79 46 75 6c 6c 28 76 6f 69 64 29 3b 0a arlyFull(void);.
23160 0a 2f 2a 0a 2a 2a 20 4f 6e 20 73 79 73 74 65 6d ./*.** On system
23170 73 20 77 69 74 68 20 61 6d 70 6c 65 20 73 74 61 s with ample sta
23180 63 6b 20 73 70 61 63 65 20 61 6e 64 20 74 68 61 ck space and tha
23190 74 20 73 75 70 70 6f 72 74 20 61 6c 6c 6f 63 61 t support alloca
231a0 28 29 2c 20 6d 61 6b 65 0a 2a 2a 20 75 73 65 20 (), make.** use
231b0 6f 66 20 61 6c 6c 6f 63 61 28 29 20 74 6f 20 6f of alloca() to o
231c0 62 74 61 69 6e 20 73 70 61 63 65 20 66 6f 72 20 btain space for
231d0 6c 61 72 67 65 20 61 75 74 6f 6d 61 74 69 63 20 large automatic
231e0 6f 62 6a 65 63 74 73 2e 20 20 42 79 20 64 65 66 objects. By def
231f0 61 75 6c 74 2c 0a 2a 2a 20 6f 62 74 61 69 6e 20 ault,.** obtain
23200 73 70 61 63 65 20 66 72 6f 6d 20 6d 61 6c 6c 6f space from mallo
23210 63 28 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 c()..**.** The a
23220 6c 6c 6f 63 61 28 29 20 72 6f 75 74 69 6e 65 20 lloca() routine
23230 6e 65 76 65 72 20 72 65 74 75 72 6e 73 20 4e 55 never returns NU
23240 4c 4c 2e 20 20 54 68 69 73 20 77 69 6c 6c 20 63 LL. This will c
23250 61 75 73 65 20 63 6f 64 65 20 70 61 74 68 73 0a ause code paths.
23260 2a 2a 20 74 68 61 74 20 64 65 61 6c 20 77 69 74 ** that deal wit
23270 68 20 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c h sqlite3StackAl
23280 6c 6f 63 28 29 20 66 61 69 6c 75 72 65 73 20 74 loc() failures t
23290 6f 20 62 65 20 75 6e 72 65 61 63 68 61 62 6c 65 o be unreachable
232a0 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
232b0 54 45 5f 55 53 45 5f 41 4c 4c 4f 43 41 0a 23 20 TE_USE_ALLOCA.#
232c0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 define sqlite3St
232d0 61 63 6b 41 6c 6c 6f 63 52 61 77 28 44 2c 4e 29 ackAllocRaw(D,N)
232e0 20 20 20 61 6c 6c 6f 63 61 28 4e 29 0a 23 20 64 alloca(N).# d
232f0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 efine sqlite3Sta
23300 63 6b 41 6c 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 ckAllocZero(D,N)
23310 20 20 6d 65 6d 73 65 74 28 61 6c 6c 6f 63 61 28 memset(alloca(
23320 4e 29 2c 20 30 2c 20 4e 29 0a 23 20 64 65 66 69 N), 0, N).# defi
23330 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b 46 ne sqlite3StackF
23340 72 65 65 28 44 2c 50 29 0a 23 65 6c 73 65 0a 23 ree(D,P).#else.#
23350 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 define sqlite3S
23360 74 61 63 6b 41 6c 6c 6f 63 52 61 77 28 44 2c 4e tackAllocRaw(D,N
23370 29 20 20 20 73 71 6c 69 74 65 33 44 62 4d 61 6c ) sqlite3DbMal
23380 6c 6f 63 52 61 77 28 44 2c 4e 29 0a 23 20 64 65 locRaw(D,N).# de
23390 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 fine sqlite3Stac
233a0 6b 41 6c 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 20 kAllocZero(D,N)
233b0 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63 sqlite3DbMalloc
233c0 5a 65 72 6f 28 44 2c 4e 29 0a 23 20 64 65 66 69 Zero(D,N).# defi
233d0 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b 46 ne sqlite3StackF
233e0 72 65 65 28 44 2c 50 29 20 20 20 20 20 20 20 73 ree(D,P) s
233f0 71 6c 69 74 65 33 44 62 46 72 65 65 28 44 2c 50 qlite3DbFree(D,P
23400 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 ).#endif..#ifdef
23410 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 4d SQLITE_ENABLE_M
23420 45 4d 53 59 53 33 0a 63 6f 6e 73 74 20 73 71 6c EMSYS3.const sql
23430 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 ite3_mem_methods
23440 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 4d *sqlite3MemGetM
23450 65 6d 73 79 73 33 28 76 6f 69 64 29 3b 0a 23 65 emsys3(void);.#e
23460 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 ndif.#ifdef SQLI
23470 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 53 TE_ENABLE_MEMSYS
23480 35 0a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f 5.const sqlite3_
23490 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 2a 73 71 6c mem_methods *sql
234a0 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 73 ite3MemGetMemsys
234b0 35 28 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 5(void);.#endif.
234c0 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
234d0 5f 4d 55 54 45 58 5f 4f 4d 49 54 0a 20 20 73 71 _MUTEX_OMIT. sq
234e0 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 68 lite3_mutex_meth
234f0 6f 64 73 20 63 6f 6e 73 74 20 2a 73 71 6c 69 74 ods const *sqlit
23500 65 33 44 65 66 61 75 6c 74 4d 75 74 65 78 28 76 e3DefaultMutex(v
23510 6f 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f oid);. sqlite3_
23520 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 6f mutex_methods co
23530 6e 73 74 20 2a 73 71 6c 69 74 65 33 4e 6f 6f 70 nst *sqlite3Noop
23540 4d 75 74 65 78 28 76 6f 69 64 29 3b 0a 20 20 73 Mutex(void);. s
23550 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 71 qlite3_mutex *sq
23560 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 28 lite3MutexAlloc(
23570 69 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 int);. int sqli
23580 74 65 33 4d 75 74 65 78 49 6e 69 74 28 76 6f 69 te3MutexInit(voi
23590 64 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 d);. int sqlite
235a0 33 4d 75 74 65 78 45 6e 64 28 76 6f 69 64 29 3b 3MutexEnd(void);
235b0 0a 23 65 6e 64 69 66 0a 23 69 66 20 21 64 65 66 .#endif.#if !def
235c0 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 55 54 45 ined(SQLITE_MUTE
235d0 58 5f 4f 4d 49 54 29 20 26 26 20 21 64 65 66 69 X_OMIT) && !defi
235e0 6e 65 64 28 53 51 4c 49 54 45 5f 4d 55 54 45 58 ned(SQLITE_MUTEX
235f0 5f 4e 4f 4f 50 29 0a 20 20 76 6f 69 64 20 73 71 _NOOP). void sq
23600 6c 69 74 65 33 4d 65 6d 6f 72 79 42 61 72 72 69 lite3MemoryBarri
23610 65 72 28 76 6f 69 64 29 3b 0a 23 65 6c 73 65 0a er(void);.#else.
23620 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
23630 4d 65 6d 6f 72 79 42 61 72 72 69 65 72 28 29 0a MemoryBarrier().
23640 23 65 6e 64 69 66 0a 0a 73 71 6c 69 74 65 33 5f #endif..sqlite3_
23650 69 6e 74 36 34 20 73 71 6c 69 74 65 33 53 74 61 int64 sqlite3Sta
23660 74 75 73 56 61 6c 75 65 28 69 6e 74 29 3b 0a 76 tusValue(int);.v
23670 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 75 oid sqlite3Statu
23680 73 55 70 28 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 sUp(int, int);.v
23690 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 74 75 oid sqlite3Statu
236a0 73 44 6f 77 6e 28 69 6e 74 2c 20 69 6e 74 29 3b sDown(int, int);
236b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 .void sqlite3Sta
236c0 74 75 73 48 69 67 68 77 61 74 65 72 28 69 6e 74 tusHighwater(int
236d0 2c 20 69 6e 74 29 3b 0a 0a 2f 2a 20 41 63 63 65 , int);../* Acce
236e0 73 73 20 74 6f 20 6d 75 74 65 78 65 73 20 75 73 ss to mutexes us
236f0 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f 73 74 ed by sqlite3_st
23700 61 74 75 73 28 29 20 2a 2f 0a 73 71 6c 69 74 65 atus() */.sqlite
23710 33 5f 6d 75 74 65 78 20 2a 73 71 6c 69 74 65 33 3_mutex *sqlite3
23720 50 63 61 63 68 65 31 4d 75 74 65 78 28 76 6f 69 Pcache1Mutex(voi
23730 64 29 3b 0a 73 71 6c 69 74 65 33 5f 6d 75 74 65 d);.sqlite3_mute
23740 78 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 x *sqlite3Malloc
23750 4d 75 74 65 78 28 76 6f 69 64 29 3b 0a 0a 23 69 Mutex(void);..#i
23760 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
23770 54 5f 46 4c 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 T_FLOATING_POINT
23780 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 49 73 . int sqlite3Is
23790 4e 61 4e 28 64 6f 75 62 6c 65 29 3b 0a 23 65 6c NaN(double);.#el
237a0 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 se.# define sqli
237b0 74 65 33 49 73 4e 61 4e 28 58 29 20 20 30 0a 23 te3IsNaN(X) 0.#
237c0 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 endif../*.** An
237d0 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 instance of the
237e0 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 following struct
237f0 75 72 65 20 68 6f 6c 64 73 20 69 6e 66 6f 72 6d ure holds inform
23800 61 74 69 6f 6e 20 61 62 6f 75 74 20 53 51 4c 0a ation about SQL.
23810 2a 2a 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 67 ** functions arg
23820 75 6d 65 6e 74 73 20 74 68 61 74 20 61 72 65 20 uments that are
23830 74 68 65 20 70 61 72 61 6d 65 74 65 72 73 20 74 the parameters t
23840 6f 20 74 68 65 20 70 72 69 6e 74 66 28 29 20 66 o the printf() f
23850 75 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 unction..*/.stru
23860 63 74 20 50 72 69 6e 74 66 41 72 67 75 6d 65 6e ct PrintfArgumen
23870 74 73 20 7b 0a 20 20 69 6e 74 20 6e 41 72 67 3b ts {. int nArg;
23880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
23890 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 72 20 /* Total number
238a0 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 2a 2f 0a of arguments */.
238b0 20 20 69 6e 74 20 6e 55 73 65 64 3b 20 20 20 20 int nUsed;
238c0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
238d0 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 mber of argument
238e0 73 20 75 73 65 64 20 73 6f 20 66 61 72 20 2a 2f s used so far */
238f0 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 . sqlite3_value
23900 20 2a 2a 61 70 41 72 67 3b 20 20 20 2f 2a 20 54 **apArg; /* T
23910 68 65 20 61 72 67 75 6d 65 6e 74 20 76 61 6c 75 he argument valu
23920 65 73 20 2a 2f 0a 7d 3b 0a 0a 76 6f 69 64 20 73 es */.};..void s
23930 71 6c 69 74 65 33 56 58 50 72 69 6e 74 66 28 53 qlite3VXPrintf(S
23940 74 72 41 63 63 75 6d 2a 2c 20 63 6f 6e 73 74 20 trAccum*, const
23950 63 68 61 72 2a 2c 20 76 61 5f 6c 69 73 74 29 3b char*, va_list);
23960 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 58 50 72 .void sqlite3XPr
23970 69 6e 74 66 28 53 74 72 41 63 63 75 6d 2a 2c 20 intf(StrAccum*,
23980 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e const char*, ...
23990 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 );.char *sqlite3
239a0 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a MPrintf(sqlite3*
239b0 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e ,const char*, ..
239c0 2e 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 .);.char *sqlite
239d0 33 56 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 65 3VMPrintf(sqlite
239e0 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 3*,const char*,
239f0 76 61 5f 6c 69 73 74 29 3b 0a 23 69 66 20 64 65 va_list);.#if de
23a00 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 fined(SQLITE_DEB
23a10 55 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 53 UG) || defined(S
23a20 51 4c 49 54 45 5f 48 41 56 45 5f 4f 53 5f 54 52 QLITE_HAVE_OS_TR
23a30 41 43 45 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 ACE). void sqli
23a40 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 63 te3DebugPrintf(c
23a50 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 onst char*, ...)
23a60 3b 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 ;.#endif.#if def
23a70 69 6e 65 64 28 53 51 4c 49 54 45 5f 54 45 53 54 ined(SQLITE_TEST
23a80 29 0a 20 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 ). void *sqlite
23a90 33 54 65 73 74 54 65 78 74 54 6f 50 74 72 28 63 3TestTextToPtr(c
23aa0 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6e onst char*);.#en
23ab0 64 69 66 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 dif..#if defined
23ac0 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 20 (SQLITE_DEBUG).
23ad0 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 65 void sqlite3Tre
23ae0 65 56 69 65 77 45 78 70 72 28 54 72 65 65 56 69 eViewExpr(TreeVi
23af0 65 77 2a 2c 20 63 6f 6e 73 74 20 45 78 70 72 2a ew*, const Expr*
23b00 2c 20 75 38 29 3b 0a 20 20 76 6f 69 64 20 73 71 , u8);. void sq
23b10 6c 69 74 65 33 54 72 65 65 56 69 65 77 45 78 70 lite3TreeViewExp
23b20 72 4c 69 73 74 28 54 72 65 65 56 69 65 77 2a 2c rList(TreeView*,
23b30 20 63 6f 6e 73 74 20 45 78 70 72 4c 69 73 74 2a const ExprList*
23b40 2c 20 75 38 2c 20 63 6f 6e 73 74 20 63 68 61 72 , u8, const char
23b50 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 *);. void sqlit
23b60 65 33 54 72 65 65 56 69 65 77 53 65 6c 65 63 74 e3TreeViewSelect
23b70 28 54 72 65 65 56 69 65 77 2a 2c 20 63 6f 6e 73 (TreeView*, cons
23b80 74 20 53 65 6c 65 63 74 2a 2c 20 75 38 29 3b 0a t Select*, u8);.
23b90 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 54 72 void sqlite3Tr
23ba0 65 65 56 69 65 77 57 69 74 68 28 54 72 65 65 56 eeViewWith(TreeV
23bb0 69 65 77 2a 2c 20 63 6f 6e 73 74 20 57 69 74 68 iew*, const With
23bc0 2a 2c 20 75 38 29 3b 0a 23 65 6e 64 69 66 0a 0a *, u8);.#endif..
23bd0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 74 .void sqlite3Set
23be0 53 74 72 69 6e 67 28 63 68 61 72 20 2a 2a 2c 20 String(char **,
23bf0 73 71 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 sqlite3*, const
23c00 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c char*);.void sql
23c10 69 74 65 33 45 72 72 6f 72 4d 73 67 28 50 61 72 ite3ErrorMsg(Par
23c20 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a se*, const char*
23c30 2c 20 2e 2e 2e 29 3b 0a 69 6e 74 20 73 71 6c 69 , ...);.int sqli
23c40 74 65 33 44 65 71 75 6f 74 65 28 63 68 61 72 2a te3Dequote(char*
23c50 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 54 );.void sqlite3T
23c60 6f 6b 65 6e 49 6e 69 74 28 54 6f 6b 65 6e 2a 2c okenInit(Token*,
23c70 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 char*);.int sqli
23c80 74 65 33 4b 65 79 77 6f 72 64 43 6f 64 65 28 63 te3KeywordCode(c
23c90 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 onst unsigned ch
23ca0 61 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 ar*, int);.int s
23cb0 71 6c 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 qlite3RunParser(
23cc0 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 Parse*, const ch
23cd0 61 72 2a 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 76 ar*, char **);.v
23ce0 6f 69 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 oid sqlite3Finis
23cf0 68 43 6f 64 69 6e 67 28 50 61 72 73 65 2a 29 3b hCoding(Parse*);
23d00 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 65 74 54 .int sqlite3GetT
23d10 65 6d 70 52 65 67 28 50 61 72 73 65 2a 29 3b 0a empReg(Parse*);.
23d20 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 6c 65 void sqlite3Rele
23d30 61 73 65 54 65 6d 70 52 65 67 28 50 61 72 73 65 aseTempReg(Parse
23d40 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 *,int);.int sqli
23d50 74 65 33 47 65 74 54 65 6d 70 52 61 6e 67 65 28 te3GetTempRange(
23d60 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a 76 6f 69 Parse*,int);.voi
23d70 64 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 d sqlite3Release
23d80 54 65 6d 70 52 61 6e 67 65 28 50 61 72 73 65 2a TempRange(Parse*
23d90 2c 69 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 ,int,int);.void
23da0 73 71 6c 69 74 65 33 43 6c 65 61 72 54 65 6d 70 sqlite3ClearTemp
23db0 52 65 67 43 61 63 68 65 28 50 61 72 73 65 2a 29 RegCache(Parse*)
23dc0 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 ;.Expr *sqlite3E
23dd0 78 70 72 41 6c 6c 6f 63 28 73 71 6c 69 74 65 33 xprAlloc(sqlite3
23de0 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 54 6f 6b 65 *,int,const Toke
23df0 6e 2a 2c 69 6e 74 29 3b 0a 45 78 70 72 20 2a 73 n*,int);.Expr *s
23e00 71 6c 69 74 65 33 45 78 70 72 28 73 71 6c 69 74 qlite3Expr(sqlit
23e10 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 e3*,int,const ch
23e20 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ar*);.void sqlit
23e30 65 33 45 78 70 72 41 74 74 61 63 68 53 75 62 74 e3ExprAttachSubt
23e40 72 65 65 73 28 73 71 6c 69 74 65 33 2a 2c 45 78 rees(sqlite3*,Ex
23e50 70 72 2a 2c 45 78 70 72 2a 2c 45 78 70 72 2a 29 pr*,Expr*,Expr*)
23e60 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 33 50 ;.Expr *sqlite3P
23e70 45 78 70 72 28 50 61 72 73 65 2a 2c 20 69 6e 74 Expr(Parse*, int
23e80 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 , Expr*, Expr*,
23e90 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 29 3b 0a 45 const Token*);.E
23ea0 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 xpr *sqlite3Expr
23eb0 41 6e 64 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 And(sqlite3*,Exp
23ec0 72 2a 2c 20 45 78 70 72 2a 29 3b 0a 45 78 70 72 r*, Expr*);.Expr
23ed0 20 2a 73 71 6c 69 74 65 33 45 78 70 72 46 75 6e *sqlite3ExprFun
23ee0 63 74 69 6f 6e 28 50 61 72 73 65 2a 2c 45 78 70 ction(Parse*,Exp
23ef0 72 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b rList*, Token*);
23f00 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
23f10 72 41 73 73 69 67 6e 56 61 72 4e 75 6d 62 65 72 rAssignVarNumber
23f20 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b (Parse*, Expr*);
23f30 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
23f40 72 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a rDelete(sqlite3*
23f50 2c 20 45 78 70 72 2a 29 3b 0a 45 78 70 72 4c 69 , Expr*);.ExprLi
23f60 73 74 20 2a 73 71 6c 69 74 65 33 45 78 70 72 4c st *sqlite3ExprL
23f70 69 73 74 41 70 70 65 6e 64 28 50 61 72 73 65 2a istAppend(Parse*
23f80 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a ,ExprList*,Expr*
23f90 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
23fa0 78 70 72 4c 69 73 74 53 65 74 53 6f 72 74 4f 72 xprListSetSortOr
23fb0 64 65 72 28 45 78 70 72 4c 69 73 74 2a 2c 69 6e der(ExprList*,in
23fc0 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
23fd0 45 78 70 72 4c 69 73 74 53 65 74 4e 61 6d 65 28 ExprListSetName(
23fe0 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a Parse*,ExprList*
23ff0 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 76 6f ,Token*,int);.vo
24000 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 id sqlite3ExprLi
24010 73 74 53 65 74 53 70 61 6e 28 50 61 72 73 65 2a stSetSpan(Parse*
24020 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 53 ,ExprList*,ExprS
24030 70 61 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 pan*);.void sqli
24040 74 65 33 45 78 70 72 4c 69 73 74 44 65 6c 65 74 te3ExprListDelet
24050 65 28 73 71 6c 69 74 65 33 2a 2c 20 45 78 70 72 e(sqlite3*, Expr
24060 4c 69 73 74 2a 29 3b 0a 75 33 32 20 73 71 6c 69 List*);.u32 sqli
24070 74 65 33 45 78 70 72 4c 69 73 74 46 6c 61 67 73 te3ExprListFlags
24080 28 63 6f 6e 73 74 20 45 78 70 72 4c 69 73 74 2a (const ExprList*
24090 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e );.int sqlite3In
240a0 69 74 28 73 71 6c 69 74 65 33 2a 2c 20 63 68 61 it(sqlite3*, cha
240b0 72 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 r**);.int sqlite
240c0 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 3InitCallback(vo
240d0 69 64 2a 2c 20 69 6e 74 2c 20 63 68 61 72 2a 2a id*, int, char**
240e0 2c 20 63 68 61 72 2a 2a 29 3b 0a 76 6f 69 64 20 , char**);.void
240f0 73 71 6c 69 74 65 33 50 72 61 67 6d 61 28 50 61 sqlite3Pragma(Pa
24100 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
24110 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 3b 0a n*,Token*,int);.
24120 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 73 65 void sqlite3Rese
24130 74 41 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e tAllSchemasOfCon
24140 6e 65 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a nection(sqlite3*
24150 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
24160 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 73 71 esetOneSchema(sq
24170 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 lite3*,int);.voi
24180 64 20 73 71 6c 69 74 65 33 43 6f 6c 6c 61 70 73 d sqlite3Collaps
24190 65 44 61 74 61 62 61 73 65 41 72 72 61 79 28 73 eDatabaseArray(s
241a0 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 qlite3*);.void s
241b0 71 6c 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 qlite3CommitInte
241c0 72 6e 61 6c 43 68 61 6e 67 65 73 28 73 71 6c 69 rnalChanges(sqli
241d0 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 te3*);.void sqli
241e0 74 65 33 44 65 6c 65 74 65 43 6f 6c 75 6d 6e 4e te3DeleteColumnN
241f0 61 6d 65 73 28 73 71 6c 69 74 65 33 2a 2c 54 61 ames(sqlite3*,Ta
24200 62 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 ble*);.int sqlit
24210 65 33 43 6f 6c 75 6d 6e 73 46 72 6f 6d 45 78 70 e3ColumnsFromExp
24220 72 4c 69 73 74 28 50 61 72 73 65 2a 2c 45 78 70 rList(Parse*,Exp
24230 72 4c 69 73 74 2a 2c 69 31 36 2a 2c 43 6f 6c 75 rList*,i16*,Colu
24240 6d 6e 2a 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 mn**);.Table *sq
24250 6c 69 74 65 33 52 65 73 75 6c 74 53 65 74 4f 66 lite3ResultSetOf
24260 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c 53 65 Select(Parse*,Se
24270 6c 65 63 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c lect*);.void sql
24280 69 74 65 33 4f 70 65 6e 4d 61 73 74 65 72 54 61 ite3OpenMasterTa
24290 62 6c 65 28 50 61 72 73 65 20 2a 2c 20 69 6e 74 ble(Parse *, int
242a0 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 );.Index *sqlite
242b0 33 50 72 69 6d 61 72 79 4b 65 79 49 6e 64 65 78 3PrimaryKeyIndex
242c0 28 54 61 62 6c 65 2a 29 3b 0a 69 31 36 20 73 71 (Table*);.i16 sq
242d0 6c 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e 64 lite3ColumnOfInd
242e0 65 78 28 49 6e 64 65 78 2a 2c 20 69 31 36 29 3b ex(Index*, i16);
242f0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 .void sqlite3Sta
24300 72 74 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 rtTable(Parse*,T
24310 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 oken*,Token*,int
24320 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a 23 ,int,int,int);.#
24330 69 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 if SQLITE_ENABLE
24340 5f 48 49 44 44 45 4e 5f 43 4f 4c 55 4d 4e 53 0a _HIDDEN_COLUMNS.
24350 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
24360 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 46 72 lumnPropertiesFr
24370 6f 6d 4e 61 6d 65 28 54 61 62 6c 65 2a 2c 20 43 omName(Table*, C
24380 6f 6c 75 6d 6e 2a 29 3b 0a 23 65 6c 73 65 0a 23 olumn*);.#else.#
24390 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 43 define sqlite3C
243a0 6f 6c 75 6d 6e 50 72 6f 70 65 72 74 69 65 73 46 olumnPropertiesF
243b0 72 6f 6d 4e 61 6d 65 28 54 2c 43 29 20 2f 2a 20 romName(T,C) /*
243c0 6e 6f 2d 6f 70 20 2a 2f 0a 23 65 6e 64 69 66 0a no-op */.#endif.
243d0 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 43 void sqlite3AddC
243e0 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 54 6f 6b olumn(Parse*,Tok
243f0 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 en*);.void sqlit
24400 65 33 41 64 64 4e 6f 74 4e 75 6c 6c 28 50 61 72 e3AddNotNull(Par
24410 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 se*, int);.void
24420 73 71 6c 69 74 65 33 41 64 64 50 72 69 6d 61 72 sqlite3AddPrimar
24430 79 4b 65 79 28 50 61 72 73 65 2a 2c 20 45 78 70 yKey(Parse*, Exp
24440 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 rList*, int, int
24450 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
24460 69 74 65 33 41 64 64 43 68 65 63 6b 43 6f 6e 73 ite3AddCheckCons
24470 74 72 61 69 6e 74 28 50 61 72 73 65 2a 2c 20 45 traint(Parse*, E
24480 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
24490 74 65 33 41 64 64 43 6f 6c 75 6d 6e 54 79 70 65 te3AddColumnType
244a0 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 29 3b (Parse*,Token*);
244b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 .void sqlite3Add
244c0 44 65 66 61 75 6c 74 56 61 6c 75 65 28 50 61 72 DefaultValue(Par
244d0 73 65 2a 2c 45 78 70 72 53 70 61 6e 2a 29 3b 0a se*,ExprSpan*);.
244e0 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 43 void sqlite3AddC
244f0 6f 6c 6c 61 74 65 54 79 70 65 28 50 61 72 73 65 ollateType(Parse
24500 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 *, Token*);.void
24510 20 73 71 6c 69 74 65 33 45 6e 64 54 61 62 6c 65 sqlite3EndTable
24520 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 (Parse*,Token*,T
24530 6f 6b 65 6e 2a 2c 75 38 2c 53 65 6c 65 63 74 2a oken*,u8,Select*
24540 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 50 61 );.int sqlite3Pa
24550 72 73 65 55 72 69 28 63 6f 6e 73 74 20 63 68 61 rseUri(const cha
24560 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 r*,const char*,u
24570 6e 73 69 67 6e 65 64 20 69 6e 74 2a 2c 0a 20 20 nsigned int*,.
24580 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24590 20 20 73 71 6c 69 74 65 33 5f 76 66 73 2a 2a 2c sqlite3_vfs**,
245a0 63 68 61 72 2a 2a 2c 63 68 61 72 20 2a 2a 29 3b char**,char **);
245b0 0a 42 74 72 65 65 20 2a 73 71 6c 69 74 65 33 44 .Btree *sqlite3D
245c0 62 4e 61 6d 65 54 6f 42 74 72 65 65 28 73 71 6c bNameToBtree(sql
245d0 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 ite3*,const char
245e0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 *);.int sqlite3C
245f0 6f 64 65 4f 6e 63 65 28 50 61 72 73 65 20 2a 29 odeOnce(Parse *)
24600 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ;..#ifdef SQLITE
24610 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 _OMIT_BUILTIN_TE
24620 53 54 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 ST.# define sqli
24630 74 65 33 46 61 75 6c 74 53 69 6d 28 58 29 20 53 te3FaultSim(X) S
24640 51 4c 49 54 45 5f 4f 4b 0a 23 65 6c 73 65 0a 20 QLITE_OK.#else.
24650 20 69 6e 74 20 73 71 6c 69 74 65 33 46 61 75 6c int sqlite3Faul
24660 74 53 69 6d 28 69 6e 74 29 3b 0a 23 65 6e 64 69 tSim(int);.#endi
24670 66 0a 0a 42 69 74 76 65 63 20 2a 73 71 6c 69 74 f..Bitvec *sqlit
24680 65 33 42 69 74 76 65 63 43 72 65 61 74 65 28 75 e3BitvecCreate(u
24690 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 32);.int sqlite3
246a0 42 69 74 76 65 63 54 65 73 74 28 42 69 74 76 65 BitvecTest(Bitve
246b0 63 2a 2c 20 75 33 32 29 3b 0a 69 6e 74 20 73 71 c*, u32);.int sq
246c0 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74 4e lite3BitvecTestN
246d0 6f 74 4e 75 6c 6c 28 42 69 74 76 65 63 2a 2c 20 otNull(Bitvec*,
246e0 75 33 32 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 u32);.int sqlite
246f0 33 42 69 74 76 65 63 53 65 74 28 42 69 74 76 65 3BitvecSet(Bitve
24700 63 2a 2c 20 75 33 32 29 3b 0a 76 6f 69 64 20 73 c*, u32);.void s
24710 71 6c 69 74 65 33 42 69 74 76 65 63 43 6c 65 61 qlite3BitvecClea
24720 72 28 42 69 74 76 65 63 2a 2c 20 75 33 32 2c 20 r(Bitvec*, u32,
24730 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 6c void*);.void sql
24740 69 74 65 33 42 69 74 76 65 63 44 65 73 74 72 6f ite3BitvecDestro
24750 79 28 42 69 74 76 65 63 2a 29 3b 0a 75 33 32 20 y(Bitvec*);.u32
24760 73 71 6c 69 74 65 33 42 69 74 76 65 63 53 69 7a sqlite3BitvecSiz
24770 65 28 42 69 74 76 65 63 2a 29 3b 0a 23 69 66 6e e(Bitvec*);.#ifn
24780 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
24790 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 69 6e 74 BUILTIN_TEST.int
247a0 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 42 75 sqlite3BitvecBu
247b0 69 6c 74 69 6e 54 65 73 74 28 69 6e 74 2c 69 6e iltinTest(int,in
247c0 74 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 52 6f 77 t*);.#endif..Row
247d0 53 65 74 20 2a 73 71 6c 69 74 65 33 52 6f 77 53 Set *sqlite3RowS
247e0 65 74 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 2c etInit(sqlite3*,
247f0 20 76 6f 69 64 2a 2c 20 75 6e 73 69 67 6e 65 64 void*, unsigned
24800 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
24810 74 65 33 52 6f 77 53 65 74 43 6c 65 61 72 28 52 te3RowSetClear(R
24820 6f 77 53 65 74 2a 29 3b 0a 76 6f 69 64 20 73 71 owSet*);.void sq
24830 6c 69 74 65 33 52 6f 77 53 65 74 49 6e 73 65 72 lite3RowSetInser
24840 74 28 52 6f 77 53 65 74 2a 2c 20 69 36 34 29 3b t(RowSet*, i64);
24850 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 53 .int sqlite3RowS
24860 65 74 54 65 73 74 28 52 6f 77 53 65 74 2a 2c 20 etTest(RowSet*,
24870 69 6e 74 20 69 42 61 74 63 68 2c 20 69 36 34 29 int iBatch, i64)
24880 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 ;.int sqlite3Row
24890 53 65 74 4e 65 78 74 28 52 6f 77 53 65 74 2a 2c SetNext(RowSet*,
248a0 20 69 36 34 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 i64*);..void sq
248b0 6c 69 74 65 33 43 72 65 61 74 65 56 69 65 77 28 lite3CreateView(
248c0 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f Parse*,Token*,To
248d0 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 45 78 70 72 ken*,Token*,Expr
248e0 4c 69 73 74 2a 2c 53 65 6c 65 63 74 2a 2c 69 6e List*,Select*,in
248f0 74 2c 69 6e 74 29 3b 0a 0a 23 69 66 20 21 64 65 t,int);..#if !de
24900 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 fined(SQLITE_OMI
24910 54 5f 56 49 45 57 29 20 7c 7c 20 21 64 65 66 69 T_VIEW) || !defi
24920 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ned(SQLITE_OMIT_
24930 56 49 52 54 55 41 4c 54 41 42 4c 45 29 0a 20 20 VIRTUALTABLE).
24940 69 6e 74 20 73 71 6c 69 74 65 33 56 69 65 77 47 int sqlite3ViewG
24950 65 74 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 50 61 etColumnNames(Pa
24960 72 73 65 2a 2c 54 61 62 6c 65 2a 29 3b 0a 23 65 rse*,Table*);.#e
24970 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
24980 69 74 65 33 56 69 65 77 47 65 74 43 6f 6c 75 6d ite3ViewGetColum
24990 6e 4e 61 6d 65 73 28 41 2c 42 29 20 30 0a 23 65 nNames(A,B) 0.#e
249a0 6e 64 69 66 0a 0a 23 69 66 20 53 51 4c 49 54 45 ndif..#if SQLITE
249b0 5f 4d 41 58 5f 41 54 54 41 43 48 45 44 3e 33 30 _MAX_ATTACHED>30
249c0 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 44 62 . int sqlite3Db
249d0 4d 61 73 6b 41 6c 6c 5a 65 72 6f 28 79 44 62 4d MaskAllZero(yDbM
249e0 61 73 6b 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 ask);.#endif.voi
249f0 64 20 73 71 6c 69 74 65 33 44 72 6f 70 54 61 62 d sqlite3DropTab
24a00 6c 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 le(Parse*, SrcLi
24a10 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a st*, int, int);.
24a20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 void sqlite3Code
24a30 44 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a DropTable(Parse*
24a40 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 , Table*, int, i
24a50 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
24a60 33 44 65 6c 65 74 65 54 61 62 6c 65 28 73 71 6c 3DeleteTable(sql
24a70 69 74 65 33 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a ite3*, Table*);.
24a80 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
24a90 4d 49 54 5f 41 55 54 4f 49 4e 43 52 45 4d 45 4e MIT_AUTOINCREMEN
24aa0 54 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 T. void sqlite3
24ab0 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 AutoincrementBeg
24ac0 69 6e 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 in(Parse *pParse
24ad0 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
24ae0 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 3AutoincrementEn
24af0 64 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 29 d(Parse *pParse)
24b00 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ;.#else.# define
24b10 20 73 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 sqlite3Autoincr
24b20 65 6d 65 6e 74 42 65 67 69 6e 28 58 29 0a 23 20 ementBegin(X).#
24b30 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 define sqlite3Au
24b40 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 64 28 58 toincrementEnd(X
24b50 29 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 ).#endif.void sq
24b60 6c 69 74 65 33 49 6e 73 65 72 74 28 50 61 72 73 lite3Insert(Pars
24b70 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 53 65 e*, SrcList*, Se
24b80 6c 65 63 74 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 lect*, IdList*,
24b90 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 int);.void *sqli
24ba0 74 65 33 41 72 72 61 79 41 6c 6c 6f 63 61 74 65 te3ArrayAllocate
24bb0 28 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c (sqlite3*,void*,
24bc0 69 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a int,int*,int*);.
24bd0 49 64 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 IdList *sqlite3I
24be0 64 4c 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 dListAppend(sqli
24bf0 74 65 33 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 54 te3*, IdList*, T
24c00 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 oken*);.int sqli
24c10 74 65 33 49 64 4c 69 73 74 49 6e 64 65 78 28 49 te3IdListIndex(I
24c20 64 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 dList*,const cha
24c30 72 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 r*);.SrcList *sq
24c40 6c 69 74 65 33 53 72 63 4c 69 73 74 45 6e 6c 61 lite3SrcListEnla
24c50 72 67 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 rge(sqlite3*, Sr
24c60 63 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 cList*, int, int
24c70 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 );.SrcList *sqli
24c80 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e 64 te3SrcListAppend
24c90 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 (sqlite3*, SrcLi
24ca0 73 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b st*, Token*, Tok
24cb0 65 6e 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 en*);.SrcList *s
24cc0 71 6c 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 qlite3SrcListApp
24cd0 65 6e 64 46 72 6f 6d 54 65 72 6d 28 50 61 72 73 endFromTerm(Pars
24ce0 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f e*, SrcList*, To
24cf0 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 0a 20 20 ken*, Token*,.
24d00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24d10 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24d20 20 20 20 20 54 6f 6b 65 6e 2a 2c 20 53 65 6c 65 Token*, Sele
24d30 63 74 2a 2c 20 45 78 70 72 2a 2c 20 49 64 4c 69 ct*, Expr*, IdLi
24d40 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 st*);.void sqlit
24d50 65 33 53 72 63 4c 69 73 74 49 6e 64 65 78 65 64 e3SrcListIndexed
24d60 42 79 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c By(Parse *, SrcL
24d70 69 73 74 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b ist *, Token *);
24d80 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 72 63 .void sqlite3Src
24d90 4c 69 73 74 46 75 6e 63 41 72 67 73 28 50 61 72 ListFuncArgs(Par
24da0 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 se*, SrcList*, E
24db0 78 70 72 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 xprList*);.int s
24dc0 71 6c 69 74 65 33 49 6e 64 65 78 65 64 42 79 4c qlite3IndexedByL
24dd0 6f 6f 6b 75 70 28 50 61 72 73 65 20 2a 2c 20 73 ookup(Parse *, s
24de0 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 truct SrcList_it
24df0 65 6d 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 em *);.void sqli
24e00 74 65 33 53 72 63 4c 69 73 74 53 68 69 66 74 4a te3SrcListShiftJ
24e10 6f 69 6e 54 79 70 65 28 53 72 63 4c 69 73 74 2a oinType(SrcList*
24e20 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
24e30 72 63 4c 69 73 74 41 73 73 69 67 6e 43 75 72 73 rcListAssignCurs
24e40 6f 72 73 28 50 61 72 73 65 2a 2c 20 53 72 63 4c ors(Parse*, SrcL
24e50 69 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ist*);.void sqli
24e60 74 65 33 49 64 4c 69 73 74 44 65 6c 65 74 65 28 te3IdListDelete(
24e70 73 71 6c 69 74 65 33 2a 2c 20 49 64 4c 69 73 74 sqlite3*, IdList
24e80 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
24e90 53 72 63 4c 69 73 74 44 65 6c 65 74 65 28 73 71 SrcListDelete(sq
24ea0 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 73 74 2a lite3*, SrcList*
24eb0 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 74 65 );.Index *sqlite
24ec0 33 41 6c 6c 6f 63 61 74 65 49 6e 64 65 78 4f 62 3AllocateIndexOb
24ed0 6a 65 63 74 28 73 71 6c 69 74 65 33 2a 2c 69 31 ject(sqlite3*,i1
24ee0 36 2c 69 6e 74 2c 63 68 61 72 2a 2a 29 3b 0a 49 6,int,char**);.I
24ef0 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 43 72 65 ndex *sqlite3Cre
24f00 61 74 65 49 6e 64 65 78 28 50 61 72 73 65 2a 2c ateIndex(Parse*,
24f10 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 53 72 Token*,Token*,Sr
24f20 63 4c 69 73 74 2a 2c 45 78 70 72 4c 69 73 74 2a cList*,ExprList*
24f30 2c 69 6e 74 2c 54 6f 6b 65 6e 2a 2c 0a 20 20 20 ,int,Token*,.
24f40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24f50 20 20 20 20 20 20 20 45 78 70 72 2a 2c 20 69 6e Expr*, in
24f60 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t, int);.void sq
24f70 6c 69 74 65 33 44 72 6f 70 49 6e 64 65 78 28 50 lite3DropIndex(P
24f80 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c arse*, SrcList*,
24f90 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
24fa0 65 33 53 65 6c 65 63 74 28 50 61 72 73 65 2a 2c e3Select(Parse*,
24fb0 20 53 65 6c 65 63 74 2a 2c 20 53 65 6c 65 63 74 Select*, Select
24fc0 44 65 73 74 2a 29 3b 0a 53 65 6c 65 63 74 20 2a Dest*);.Select *
24fd0 73 71 6c 69 74 65 33 53 65 6c 65 63 74 4e 65 77 sqlite3SelectNew
24fe0 28 50 61 72 73 65 2a 2c 45 78 70 72 4c 69 73 74 (Parse*,ExprList
24ff0 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 72 2a *,SrcList*,Expr*
25000 2c 45 78 70 72 4c 69 73 74 2a 2c 0a 20 20 20 20 ,ExprList*,.
25010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25020 20 20 20 20 20 45 78 70 72 2a 2c 45 78 70 72 4c Expr*,ExprL
25030 69 73 74 2a 2c 75 31 36 2c 45 78 70 72 2a 2c 45 ist*,u16,Expr*,E
25040 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
25050 74 65 33 53 65 6c 65 63 74 44 65 6c 65 74 65 28 te3SelectDelete(
25060 73 71 6c 69 74 65 33 2a 2c 20 53 65 6c 65 63 74 sqlite3*, Select
25070 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 *);.Table *sqlit
25080 65 33 53 72 63 4c 69 73 74 4c 6f 6f 6b 75 70 28 e3SrcListLookup(
25090 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a Parse*, SrcList*
250a0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 73 );.int sqlite3Is
250b0 52 65 61 64 4f 6e 6c 79 28 50 61 72 73 65 2a 2c ReadOnly(Parse*,
250c0 20 54 61 62 6c 65 2a 2c 20 69 6e 74 29 3b 0a 76 Table*, int);.v
250d0 6f 69 64 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 oid sqlite3OpenT
250e0 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 able(Parse*, int
250f0 20 69 43 75 72 2c 20 69 6e 74 20 69 44 62 2c 20 iCur, int iDb,
25100 54 61 62 6c 65 2a 2c 20 69 6e 74 29 3b 0a 23 69 Table*, int);.#i
25110 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
25120 5f 45 4e 41 42 4c 45 5f 55 50 44 41 54 45 5f 44 _ENABLE_UPDATE_D
25130 45 4c 45 54 45 5f 4c 49 4d 49 54 29 20 26 26 20 ELETE_LIMIT) &&
25140 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
25150 4f 4d 49 54 5f 53 55 42 51 55 45 52 59 29 0a 45 OMIT_SUBQUERY).E
25160 78 70 72 20 2a 73 71 6c 69 74 65 33 4c 69 6d 69 xpr *sqlite3Limi
25170 74 57 68 65 72 65 28 50 61 72 73 65 2a 2c 53 72 tWhere(Parse*,Sr
25180 63 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 70 cList*,Expr*,Exp
25190 72 4c 69 73 74 2a 2c 45 78 70 72 2a 2c 45 78 70 rList*,Expr*,Exp
251a0 72 2a 2c 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 r*,char*);.#endi
251b0 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 f.void sqlite3De
251c0 6c 65 74 65 46 72 6f 6d 28 50 61 72 73 65 2a 2c leteFrom(Parse*,
251d0 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 70 72 2a SrcList*, Expr*
251e0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 );.void sqlite3U
251f0 70 64 61 74 65 28 50 61 72 73 65 2a 2c 20 53 72 pdate(Parse*, Sr
25200 63 4c 69 73 74 2a 2c 20 45 78 70 72 4c 69 73 74 cList*, ExprList
25210 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a *, Expr*, int);.
25220 57 68 65 72 65 49 6e 66 6f 20 2a 73 71 6c 69 74 WhereInfo *sqlit
25230 65 33 57 68 65 72 65 42 65 67 69 6e 28 50 61 72 e3WhereBegin(Par
25240 73 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 se*,SrcList*,Exp
25250 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 r*,ExprList*,Exp
25260 72 4c 69 73 74 2a 2c 75 31 36 2c 69 6e 74 29 3b rList*,u16,int);
25270 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 57 68 65 .void sqlite3Whe
25280 72 65 45 6e 64 28 57 68 65 72 65 49 6e 66 6f 2a reEnd(WhereInfo*
25290 29 3b 0a 75 36 34 20 73 71 6c 69 74 65 33 57 68 );.u64 sqlite3Wh
252a0 65 72 65 4f 75 74 70 75 74 52 6f 77 43 6f 75 6e ereOutputRowCoun
252b0 74 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 t(WhereInfo*);.i
252c0 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 nt sqlite3WhereI
252d0 73 44 69 73 74 69 6e 63 74 28 57 68 65 72 65 49 sDistinct(WhereI
252e0 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 nfo*);.int sqlit
252f0 65 33 57 68 65 72 65 49 73 4f 72 64 65 72 65 64 e3WhereIsOrdered
25300 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e (WhereInfo*);.in
25310 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 t sqlite3WhereIs
25320 53 6f 72 74 65 64 28 57 68 65 72 65 49 6e 66 6f Sorted(WhereInfo
25330 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 *);.int sqlite3W
25340 68 65 72 65 43 6f 6e 74 69 6e 75 65 4c 61 62 65 hereContinueLabe
25350 6c 28 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 l(WhereInfo*);.i
25360 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 nt sqlite3WhereB
25370 72 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 65 49 reakLabel(WhereI
25380 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 nfo*);.int sqlit
25390 65 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 73 73 e3WhereOkOnePass
253a0 28 57 68 65 72 65 49 6e 66 6f 2a 2c 20 69 6e 74 (WhereInfo*, int
253b0 2a 29 3b 0a 23 64 65 66 69 6e 65 20 4f 4e 45 50 *);.#define ONEP
253c0 41 53 53 5f 4f 46 46 20 20 20 20 20 20 30 20 20 ASS_OFF 0
253d0 20 20 20 20 20 20 2f 2a 20 55 73 65 20 6f 66 20 /* Use of
253e0 4f 4e 45 50 41 53 53 20 6e 6f 74 20 61 6c 6c 6f ONEPASS not allo
253f0 77 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f wed */.#define O
25400 4e 45 50 41 53 53 5f 53 49 4e 47 4c 45 20 20 20 NEPASS_SINGLE
25410 31 20 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 50 1 /* ONEP
25420 41 53 53 20 76 61 6c 69 64 20 66 6f 72 20 61 20 ASS valid for a
25430 73 69 6e 67 6c 65 20 72 6f 77 20 75 70 64 61 74 single row updat
25440 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 4e 45 e */.#define ONE
25450 50 41 53 53 5f 4d 55 4c 54 49 20 20 20 20 32 20 PASS_MULTI 2
25460 20 20 20 20 20 20 20 2f 2a 20 4f 4e 45 50 41 53 /* ONEPAS
25470 53 20 69 73 20 76 61 6c 69 64 20 66 6f 72 20 6d S is valid for m
25480 75 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a ultiple rows */.
25490 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
254a0 43 6f 64 65 4c 6f 61 64 49 6e 64 65 78 43 6f 6c CodeLoadIndexCol
254b0 75 6d 6e 28 50 61 72 73 65 2a 2c 20 49 6e 64 65 umn(Parse*, Inde
254c0 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e x*, int, int, in
254d0 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 t);.int sqlite3E
254e0 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 6d 6e xprCodeGetColumn
254f0 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
25500 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 int, int, int,
25510 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 u8);.void sqlite
25520 33 45 78 70 72 43 6f 64 65 47 65 74 43 6f 6c 75 3ExprCodeGetColu
25530 6d 6e 54 6f 52 65 67 28 50 61 72 73 65 2a 2c 20 mnToReg(Parse*,
25540 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 Table*, int, int
25550 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
25560 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 74 43 ite3ExprCodeGetC
25570 6f 6c 75 6d 6e 4f 66 54 61 62 6c 65 28 56 64 62 olumnOfTable(Vdb
25580 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c e*, Table*, int,
25590 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 int, int);.void
255a0 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 sqlite3ExprCode
255b0 4d 6f 76 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 Move(Parse*, int
255c0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
255d0 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 61 63 d sqlite3ExprCac
255e0 68 65 53 74 6f 72 65 28 50 61 72 73 65 2a 2c 20 heStore(Parse*,
255f0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
25600 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
25610 43 61 63 68 65 50 75 73 68 28 50 61 72 73 65 2a CachePush(Parse*
25620 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
25630 78 70 72 43 61 63 68 65 50 6f 70 28 50 61 72 73 xprCachePop(Pars
25640 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
25650 33 45 78 70 72 43 61 63 68 65 52 65 6d 6f 76 65 3ExprCacheRemove
25660 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e (Parse*, int, in
25670 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
25680 45 78 70 72 43 61 63 68 65 43 6c 65 61 72 28 50 ExprCacheClear(P
25690 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c arse*);.void sql
256a0 69 74 65 33 45 78 70 72 43 61 63 68 65 41 66 66 ite3ExprCacheAff
256b0 69 6e 69 74 79 43 68 61 6e 67 65 28 50 61 72 73 inityChange(Pars
256c0 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 e*, int, int);.v
256d0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
256e0 6f 64 65 28 50 61 72 73 65 2a 2c 20 45 78 70 72 ode(Parse*, Expr
256f0 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 *, int);.void sq
25700 6c 69 74 65 33 45 78 70 72 43 6f 64 65 43 6f 70 lite3ExprCodeCop
25710 79 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c y(Parse*, Expr*,
25720 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
25730 74 65 33 45 78 70 72 43 6f 64 65 46 61 63 74 6f te3ExprCodeFacto
25740 72 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 45 78 rable(Parse*, Ex
25750 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 pr*, int);.void
25760 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 41 sqlite3ExprCodeA
25770 74 49 6e 69 74 28 50 61 72 73 65 2a 2c 20 45 78 tInit(Parse*, Ex
25780 70 72 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 pr*, int, u8);.i
25790 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f nt sqlite3ExprCo
257a0 64 65 54 65 6d 70 28 50 61 72 73 65 2a 2c 20 45 deTemp(Parse*, E
257b0 78 70 72 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 xpr*, int*);.int
257c0 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 sqlite3ExprCode
257d0 54 61 72 67 65 74 28 50 61 72 73 65 2a 2c 20 45 Target(Parse*, E
257e0 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 xpr*, int);.void
257f0 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 sqlite3ExprCode
25800 41 6e 64 43 61 63 68 65 28 50 61 72 73 65 2a 2c AndCache(Parse*,
25810 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e Expr*, int);.in
25820 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 t sqlite3ExprCod
25830 65 45 78 70 72 4c 69 73 74 28 50 61 72 73 65 2a eExprList(Parse*
25840 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 , ExprList*, int
25850 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 23 64 65 66 , int, u8);.#def
25860 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f ine SQLITE_ECEL_
25870 44 55 50 20 20 20 20 20 20 30 78 30 31 20 20 2f DUP 0x01 /
25880 2a 20 44 65 65 70 2c 20 6e 6f 74 20 73 68 61 6c * Deep, not shal
25890 6c 6f 77 20 63 6f 70 69 65 73 20 2a 2f 0a 23 64 low copies */.#d
258a0 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 efine SQLITE_ECE
258b0 4c 5f 46 41 43 54 4f 52 20 20 20 30 78 30 32 20 L_FACTOR 0x02
258c0 20 2f 2a 20 46 61 63 74 6f 72 20 6f 75 74 20 63 /* Factor out c
258d0 6f 6e 73 74 61 6e 74 20 74 65 72 6d 73 20 2a 2f onstant terms */
258e0 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
258f0 45 43 45 4c 5f 52 45 46 20 20 20 20 20 20 30 78 ECEL_REF 0x
25900 30 34 20 20 2f 2a 20 55 73 65 20 45 78 70 72 4c 04 /* Use ExprL
25910 69 73 74 2e 75 2e 78 2e 69 4f 72 64 65 72 42 79 ist.u.x.iOrderBy
25920 43 6f 6c 20 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 Col */.void sqli
25930 74 65 33 45 78 70 72 49 66 54 72 75 65 28 50 61 te3ExprIfTrue(Pa
25940 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 rse*, Expr*, int
25950 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
25960 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 65 28 ite3ExprIfFalse(
25970 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 Parse*, Expr*, i
25980 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 nt, int);.void s
25990 71 6c 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 qlite3ExprIfFals
259a0 65 44 75 70 28 50 61 72 73 65 2a 2c 20 45 78 70 eDup(Parse*, Exp
259b0 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 54 r*, int, int);.T
259c0 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 46 69 6e able *sqlite3Fin
259d0 64 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c dTable(sqlite3*,
259e0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
259f0 73 74 20 63 68 61 72 2a 29 3b 0a 54 61 62 6c 65 st char*);.Table
25a00 20 2a 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 *sqlite3LocateT
25a10 61 62 6c 65 28 50 61 72 73 65 2a 2c 69 6e 74 20 able(Parse*,int
25a20 69 73 56 69 65 77 2c 63 6f 6e 73 74 20 63 68 61 isView,const cha
25a30 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 r*, const char*)
25a40 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 ;.Table *sqlite3
25a50 4c 6f 63 61 74 65 54 61 62 6c 65 49 74 65 6d 28 LocateTableItem(
25a60 50 61 72 73 65 2a 2c 69 6e 74 20 69 73 56 69 65 Parse*,int isVie
25a70 77 2c 73 74 72 75 63 74 20 53 72 63 4c 69 73 74 w,struct SrcList
25a80 5f 69 74 65 6d 20 2a 29 3b 0a 49 6e 64 65 78 20 _item *);.Index
25a90 2a 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 *sqlite3FindInde
25aa0 78 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 x(sqlite3*,const
25ab0 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 char*, const ch
25ac0 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ar*);.void sqlit
25ad0 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 e3UnlinkAndDelet
25ae0 65 54 61 62 6c 65 28 73 71 6c 69 74 65 33 2a 2c eTable(sqlite3*,
25af0 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 int,const char*)
25b00 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e ;.void sqlite3Un
25b10 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 49 6e 64 linkAndDeleteInd
25b20 65 78 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c ex(sqlite3*,int,
25b30 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f const char*);.vo
25b40 69 64 20 73 71 6c 69 74 65 33 56 61 63 75 75 6d id sqlite3Vacuum
25b50 28 50 61 72 73 65 2a 29 3b 0a 69 6e 74 20 73 71 (Parse*);.int sq
25b60 6c 69 74 65 33 52 75 6e 56 61 63 75 75 6d 28 63 lite3RunVacuum(c
25b70 68 61 72 2a 2a 2c 20 73 71 6c 69 74 65 33 2a 29 har**, sqlite3*)
25b80 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4e ;.char *sqlite3N
25b90 61 6d 65 46 72 6f 6d 54 6f 6b 65 6e 28 73 71 6c ameFromToken(sql
25ba0 69 74 65 33 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a ite3*, Token*);.
25bb0 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 43 int sqlite3ExprC
25bc0 6f 6d 70 61 72 65 28 45 78 70 72 2a 2c 20 45 78 ompare(Expr*, Ex
25bd0 70 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 pr*, int);.int s
25be0 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 43 6f qlite3ExprListCo
25bf0 6d 70 61 72 65 28 45 78 70 72 4c 69 73 74 2a 2c mpare(ExprList*,
25c00 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 ExprList*, int)
25c10 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 ;.int sqlite3Exp
25c20 72 49 6d 70 6c 69 65 73 45 78 70 72 28 45 78 70 rImpliesExpr(Exp
25c30 72 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b r*, Expr*, int);
25c40 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
25c50 72 41 6e 61 6c 79 7a 65 41 67 67 72 65 67 61 74 rAnalyzeAggregat
25c60 65 73 28 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 2c es(NameContext*,
25c70 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 Expr*);.void sq
25c80 6c 69 74 65 33 45 78 70 72 41 6e 61 6c 79 7a 65 lite3ExprAnalyze
25c90 41 67 67 4c 69 73 74 28 4e 61 6d 65 43 6f 6e 74 AggList(NameCont
25ca0 65 78 74 2a 2c 45 78 70 72 4c 69 73 74 2a 29 3b ext*,ExprList*);
25cb0 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 75 6e 63 .int sqlite3Func
25cc0 74 69 6f 6e 55 73 65 73 54 68 69 73 53 72 63 28 tionUsesThisSrc(
25cd0 45 78 70 72 2a 2c 20 53 72 63 4c 69 73 74 2a 29 Expr*, SrcList*)
25ce0 3b 0a 56 64 62 65 20 2a 73 71 6c 69 74 65 33 47 ;.Vdbe *sqlite3G
25cf0 65 74 56 64 62 65 28 50 61 72 73 65 2a 29 3b 0a etVdbe(Parse*);.
25d00 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
25d10 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 MIT_BUILTIN_TEST
25d20 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 72 6e .void sqlite3Prn
25d30 67 53 61 76 65 53 74 61 74 65 28 76 6f 69 64 29 gSaveState(void)
25d40 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 72 ;.void sqlite3Pr
25d50 6e 67 52 65 73 74 6f 72 65 53 74 61 74 65 28 76 ngRestoreState(v
25d60 6f 69 64 29 3b 0a 23 65 6e 64 69 66 0a 76 6f 69 oid);.#endif.voi
25d70 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 d sqlite3Rollbac
25d80 6b 41 6c 6c 28 73 71 6c 69 74 65 33 2a 2c 69 6e kAll(sqlite3*,in
25d90 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
25da0 43 6f 64 65 56 65 72 69 66 79 53 63 68 65 6d 61 CodeVerifySchema
25db0 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 (Parse*, int);.v
25dc0 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 56 oid sqlite3CodeV
25dd0 65 72 69 66 79 4e 61 6d 65 64 53 63 68 65 6d 61 erifyNamedSchema
25de0 28 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 (Parse*, const c
25df0 68 61 72 20 2a 7a 44 62 29 3b 0a 76 6f 69 64 20 har *zDb);.void
25e00 73 71 6c 69 74 65 33 42 65 67 69 6e 54 72 61 6e sqlite3BeginTran
25e10 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a 2c 20 saction(Parse*,
25e20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
25e30 65 33 43 6f 6d 6d 69 74 54 72 61 6e 73 61 63 74 e3CommitTransact
25e40 69 6f 6e 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 ion(Parse*);.voi
25e50 64 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 d sqlite3Rollbac
25e60 6b 54 72 61 6e 73 61 63 74 69 6f 6e 28 50 61 72 kTransaction(Par
25e70 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
25e80 65 33 53 61 76 65 70 6f 69 6e 74 28 50 61 72 73 e3Savepoint(Pars
25e90 65 2a 2c 20 69 6e 74 2c 20 54 6f 6b 65 6e 2a 29 e*, int, Token*)
25ea0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6c ;.void sqlite3Cl
25eb0 6f 73 65 53 61 76 65 70 6f 69 6e 74 73 28 73 71 oseSavepoints(sq
25ec0 6c 69 74 65 33 20 2a 29 3b 0a 76 6f 69 64 20 73 lite3 *);.void s
25ed0 71 6c 69 74 65 33 4c 65 61 76 65 4d 75 74 65 78 qlite3LeaveMutex
25ee0 41 6e 64 43 6c 6f 73 65 5a 6f 6d 62 69 65 28 73 AndCloseZombie(s
25ef0 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 qlite3*);.int sq
25f00 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 lite3ExprIsConst
25f10 61 6e 74 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 ant(Expr*);.int
25f20 73 71 6c 69 74 65 33 45 78 70 72 49 73 43 6f 6e sqlite3ExprIsCon
25f30 73 74 61 6e 74 4e 6f 74 4a 6f 69 6e 28 45 78 70 stantNotJoin(Exp
25f40 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
25f50 45 78 70 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 ExprIsConstantOr
25f60 46 75 6e 63 74 69 6f 6e 28 45 78 70 72 2a 2c 20 Function(Expr*,
25f70 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 u8);.int sqlite3
25f80 45 78 70 72 49 73 54 61 62 6c 65 43 6f 6e 73 74 ExprIsTableConst
25f90 61 6e 74 28 45 78 70 72 2a 2c 69 6e 74 29 3b 0a ant(Expr*,int);.
25fa0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
25fb0 41 42 4c 45 5f 43 55 52 53 4f 52 5f 48 49 4e 54 ABLE_CURSOR_HINT
25fc0 53 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 S.int sqlite3Exp
25fd0 72 43 6f 6e 74 61 69 6e 73 53 75 62 71 75 65 72 rContainsSubquer
25fe0 79 28 45 78 70 72 2a 29 3b 0a 23 65 6e 64 69 66 y(Expr*);.#endif
25ff0 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 .int sqlite3Expr
26000 49 73 49 6e 74 65 67 65 72 28 45 78 70 72 2a 2c IsInteger(Expr*,
26010 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 int*);.int sqli
26020 74 65 33 45 78 70 72 43 61 6e 42 65 4e 75 6c 6c te3ExprCanBeNull
26030 28 63 6f 6e 73 74 20 45 78 70 72 2a 29 3b 0a 69 (const Expr*);.i
26040 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 4e 65 nt sqlite3ExprNe
26050 65 64 73 4e 6f 41 66 66 69 6e 69 74 79 43 68 61 edsNoAffinityCha
26060 6e 67 65 28 63 6f 6e 73 74 20 45 78 70 72 2a 2c nge(const Expr*,
26070 20 63 68 61 72 29 3b 0a 69 6e 74 20 73 71 6c 69 char);.int sqli
26080 74 65 33 49 73 52 6f 77 69 64 28 63 6f 6e 73 74 te3IsRowid(const
26090 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 char*);.void sq
260a0 6c 69 74 65 33 47 65 6e 65 72 61 74 65 52 6f 77 lite3GenerateRow
260b0 44 65 6c 65 74 65 28 0a 20 20 20 20 50 61 72 73 Delete(. Pars
260c0 65 2a 2c 54 61 62 6c 65 2a 2c 54 72 69 67 67 65 e*,Table*,Trigge
260d0 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 r*,int,int,int,i
260e0 31 36 2c 75 38 2c 75 38 2c 75 38 2c 69 6e 74 29 16,u8,u8,u8,int)
260f0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 47 65 ;.void sqlite3Ge
26100 6e 65 72 61 74 65 52 6f 77 49 6e 64 65 78 44 65 nerateRowIndexDe
26110 6c 65 74 65 28 50 61 72 73 65 2a 2c 20 54 61 62 lete(Parse*, Tab
26120 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 le*, int, int, i
26130 6e 74 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 nt*, int);.int s
26140 71 6c 69 74 65 33 47 65 6e 65 72 61 74 65 49 6e qlite3GenerateIn
26150 64 65 78 4b 65 79 28 50 61 72 73 65 2a 2c 20 49 dexKey(Parse*, I
26160 6e 64 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c ndex*, int, int,
26170 20 69 6e 74 2c 20 69 6e 74 2a 2c 49 6e 64 65 78 int, int*,Index
26180 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c *,int);.void sql
26190 69 74 65 33 52 65 73 6f 6c 76 65 50 61 72 74 49 ite3ResolvePartI
261a0 64 78 4c 61 62 65 6c 28 50 61 72 73 65 2a 2c 69 dxLabel(Parse*,i
261b0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
261c0 33 47 65 6e 65 72 61 74 65 43 6f 6e 73 74 72 61 3GenerateConstra
261d0 69 6e 74 43 68 65 63 6b 73 28 50 61 72 73 65 2a intChecks(Parse*
261e0 2c 54 61 62 6c 65 2a 2c 69 6e 74 2a 2c 69 6e 74 ,Table*,int*,int
261f0 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 0a 20 20 ,int,int,int,.
26200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26220 20 20 20 75 38 2c 75 38 2c 69 6e 74 2c 69 6e 74 u8,u8,int,int
26230 2a 2c 69 6e 74 2a 29 3b 0a 76 6f 69 64 20 73 71 *,int*);.void sq
26240 6c 69 74 65 33 43 6f 6d 70 6c 65 74 65 49 6e 73 lite3CompleteIns
26250 65 72 74 69 6f 6e 28 50 61 72 73 65 2a 2c 54 61 ertion(Parse*,Ta
26260 62 6c 65 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 ble*,int,int,int
26270 2c 69 6e 74 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e ,int*,int,int,in
26280 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4f t);.int sqlite3O
26290 70 65 6e 54 61 62 6c 65 41 6e 64 49 6e 64 69 63 penTableAndIndic
262a0 65 73 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 es(Parse*, Table
262b0 2a 2c 20 69 6e 74 2c 20 75 38 2c 20 69 6e 74 2c *, int, u8, int,
262c0 20 75 38 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 2a u8*, int*, int*
262d0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 );.void sqlite3B
262e0 65 67 69 6e 57 72 69 74 65 4f 70 65 72 61 74 69 eginWriteOperati
262f0 6f 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 on(Parse*, int,
26300 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
26310 65 33 4d 75 6c 74 69 57 72 69 74 65 28 50 61 72 e3MultiWrite(Par
26320 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
26330 65 33 4d 61 79 41 62 6f 72 74 28 50 61 72 73 65 e3MayAbort(Parse
26340 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
26350 48 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 50 HaltConstraint(P
26360 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c arse*, int, int,
26370 20 63 68 61 72 2a 2c 20 69 38 2c 20 75 38 29 3b char*, i8, u8);
26380 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 69 .void sqlite3Uni
26390 71 75 65 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 queConstraint(Pa
263a0 72 73 65 2a 2c 20 69 6e 74 2c 20 49 6e 64 65 78 rse*, int, Index
263b0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
263c0 52 6f 77 69 64 43 6f 6e 73 74 72 61 69 6e 74 28 RowidConstraint(
263d0 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 54 61 62 Parse*, int, Tab
263e0 6c 65 2a 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 le*);.Expr *sqli
263f0 74 65 33 45 78 70 72 44 75 70 28 73 71 6c 69 74 te3ExprDup(sqlit
26400 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 29 3b 0a e3*,Expr*,int);.
26410 45 78 70 72 4c 69 73 74 20 2a 73 71 6c 69 74 65 ExprList *sqlite
26420 33 45 78 70 72 4c 69 73 74 44 75 70 28 73 71 6c 3ExprListDup(sql
26430 69 74 65 33 2a 2c 45 78 70 72 4c 69 73 74 2a 2c ite3*,ExprList*,
26440 69 6e 74 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 int);.SrcList *s
26450 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 75 70 qlite3SrcListDup
26460 28 73 71 6c 69 74 65 33 2a 2c 53 72 63 4c 69 73 (sqlite3*,SrcLis
26470 74 2a 2c 69 6e 74 29 3b 0a 49 64 4c 69 73 74 20 t*,int);.IdList
26480 2a 73 71 6c 69 74 65 33 49 64 4c 69 73 74 44 75 *sqlite3IdListDu
26490 70 28 73 71 6c 69 74 65 33 2a 2c 49 64 4c 69 73 p(sqlite3*,IdLis
264a0 74 2a 29 3b 0a 53 65 6c 65 63 74 20 2a 73 71 6c t*);.Select *sql
264b0 69 74 65 33 53 65 6c 65 63 74 44 75 70 28 73 71 ite3SelectDup(sq
264c0 6c 69 74 65 33 2a 2c 53 65 6c 65 63 74 2a 2c 69 lite3*,Select*,i
264d0 6e 74 29 3b 0a 23 69 66 20 53 45 4c 45 43 54 54 nt);.#if SELECTT
264e0 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 76 6f 69 RACE_ENABLED.voi
264f0 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 53 d sqlite3SelectS
26500 65 74 4e 61 6d 65 28 53 65 6c 65 63 74 2a 2c 63 etName(Select*,c
26510 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 23 65 6c onst char*);.#el
26520 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 se.# define sqli
26530 74 65 33 53 65 6c 65 63 74 53 65 74 4e 61 6d 65 te3SelectSetName
26540 28 41 2c 42 29 0a 23 65 6e 64 69 66 0a 76 6f 69 (A,B).#endif.voi
26550 64 20 73 71 6c 69 74 65 33 49 6e 73 65 72 74 42 d sqlite3InsertB
26560 75 69 6c 74 69 6e 46 75 6e 63 73 28 46 75 6e 63 uiltinFuncs(Func
26570 44 65 66 2a 2c 69 6e 74 29 3b 0a 46 75 6e 63 44 Def*,int);.FuncD
26580 65 66 20 2a 73 71 6c 69 74 65 33 46 69 6e 64 46 ef *sqlite3FindF
26590 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a unction(sqlite3*
265a0 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 ,const char*,int
265b0 2c 75 38 2c 75 38 29 3b 0a 76 6f 69 64 20 73 71 ,u8,u8);.void sq
265c0 6c 69 74 65 33 52 65 67 69 73 74 65 72 42 75 69 lite3RegisterBui
265d0 6c 74 69 6e 46 75 6e 63 74 69 6f 6e 73 28 76 6f ltinFunctions(vo
265e0 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 id);.void sqlite
265f0 33 52 65 67 69 73 74 65 72 44 61 74 65 54 69 6d 3RegisterDateTim
26600 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 eFunctions(void)
26610 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 ;.void sqlite3Re
26620 67 69 73 74 65 72 50 65 72 43 6f 6e 6e 65 63 74 gisterPerConnect
26630 69 6f 6e 42 75 69 6c 74 69 6e 46 75 6e 63 74 69 ionBuiltinFuncti
26640 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 69 ons(sqlite3*);.i
26650 6e 74 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 nt sqlite3Safety
26660 43 68 65 63 6b 4f 6b 28 73 71 6c 69 74 65 33 2a CheckOk(sqlite3*
26670 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 61 );.int sqlite3Sa
26680 66 65 74 79 43 68 65 63 6b 53 69 63 6b 4f 72 4f fetyCheckSickOrO
26690 6b 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 k(sqlite3*);.voi
266a0 64 20 73 71 6c 69 74 65 33 43 68 61 6e 67 65 43 d sqlite3ChangeC
266b0 6f 6f 6b 69 65 28 50 61 72 73 65 2a 2c 20 69 6e ookie(Parse*, in
266c0 74 29 3b 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 t);..#if !define
266d0 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 d(SQLITE_OMIT_VI
266e0 45 57 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 EW) && !defined(
266f0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 SQLITE_OMIT_TRIG
26700 47 45 52 29 0a 76 6f 69 64 20 73 71 6c 69 74 65 GER).void sqlite
26710 33 4d 61 74 65 72 69 61 6c 69 7a 65 56 69 65 77 3MaterializeView
26720 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
26730 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 23 65 Expr*, int);.#e
26740 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 ndif..#ifndef SQ
26750 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 LITE_OMIT_TRIGGE
26760 52 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 R. void sqlite3
26770 42 65 67 69 6e 54 72 69 67 67 65 72 28 50 61 72 BeginTrigger(Par
26780 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 se*, Token*,Toke
26790 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 49 64 4c 69 73 n*,int,int,IdLis
267a0 74 2a 2c 53 72 63 4c 69 73 74 2a 2c 0a 20 20 20 t*,SrcList*,.
267b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
267c0 20 20 20 20 20 20 20 20 45 78 70 72 2a 2c 69 6e Expr*,in
267d0 74 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 t, int);. void
267e0 73 71 6c 69 74 65 33 46 69 6e 69 73 68 54 72 69 sqlite3FinishTri
267f0 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 72 69 gger(Parse*, Tri
26800 67 67 65 72 53 74 65 70 2a 2c 20 54 6f 6b 65 6e ggerStep*, Token
26810 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 *);. void sqlit
26820 65 33 44 72 6f 70 54 72 69 67 67 65 72 28 50 61 e3DropTrigger(Pa
26830 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 rse*, SrcList*,
26840 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c int);. void sql
26850 69 74 65 33 44 72 6f 70 54 72 69 67 67 65 72 50 ite3DropTriggerP
26860 74 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 67 tr(Parse*, Trigg
26870 65 72 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 20 er*);. Trigger
26880 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 73 *sqlite3Triggers
26890 45 78 69 73 74 28 50 61 72 73 65 20 2a 2c 20 54 Exist(Parse *, T
268a0 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 45 78 70 72 able*, int, Expr
268b0 4c 69 73 74 2a 2c 20 69 6e 74 20 2a 70 4d 61 73 List*, int *pMas
268c0 6b 29 3b 0a 20 20 54 72 69 67 67 65 72 20 2a 73 k);. Trigger *s
268d0 71 6c 69 74 65 33 54 72 69 67 67 65 72 4c 69 73 qlite3TriggerLis
268e0 74 28 50 61 72 73 65 20 2a 2c 20 54 61 62 6c 65 t(Parse *, Table
268f0 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 *);. void sqli
26900 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 65 te3CodeRowTrigge
26910 72 28 50 61 72 73 65 2a 2c 20 54 72 69 67 67 65 r(Parse*, Trigge
26920 72 20 2a 2c 20 69 6e 74 2c 20 45 78 70 72 4c 69 r *, int, ExprLi
26930 73 74 2a 2c 20 69 6e 74 2c 20 54 61 62 6c 65 20 st*, int, Table
26940 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 *,.
26950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 i
26960 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 nt, int, int);.
26970 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 void sqlite3Cod
26980 65 52 6f 77 54 72 69 67 67 65 72 44 69 72 65 63 eRowTriggerDirec
26990 74 28 50 61 72 73 65 20 2a 2c 20 54 72 69 67 67 t(Parse *, Trigg
269a0 65 72 20 2a 2c 20 54 61 62 6c 65 20 2a 2c 20 69 er *, Table *, i
269b0 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 nt, int, int);.
269c0 20 76 6f 69 64 20 73 71 6c 69 74 65 56 69 65 77 void sqliteView
269d0 54 72 69 67 67 65 72 73 28 50 61 72 73 65 2a 2c Triggers(Parse*,
269e0 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a 2c 20 Table*, Expr*,
269f0 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b int, ExprList*);
26a00 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 44 . void sqlite3D
26a10 65 6c 65 74 65 54 72 69 67 67 65 72 53 74 65 70 eleteTriggerStep
26a20 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 67 67 (sqlite3*, Trigg
26a30 65 72 53 74 65 70 2a 29 3b 0a 20 20 54 72 69 67 erStep*);. Trig
26a40 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 65 33 gerStep *sqlite3
26a50 54 72 69 67 67 65 72 53 65 6c 65 63 74 53 74 65 TriggerSelectSte
26a60 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c 65 63 p(sqlite3*,Selec
26a70 74 2a 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 t*);. TriggerSt
26a80 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 ep *sqlite3Trigg
26a90 65 72 49 6e 73 65 72 74 53 74 65 70 28 73 71 6c erInsertStep(sql
26aa0 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 49 64 ite3*,Token*, Id
26ab0 4c 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 List*,.
26ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 S
26ae0 65 6c 65 63 74 2a 2c 75 38 29 3b 0a 20 20 54 72 elect*,u8);. Tr
26af0 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 iggerStep *sqlit
26b00 65 33 54 72 69 67 67 65 72 55 70 64 61 74 65 53 e3TriggerUpdateS
26b10 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 6f 6b tep(sqlite3*,Tok
26b20 65 6e 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 20 45 en*,ExprList*, E
26b30 78 70 72 2a 2c 20 75 38 29 3b 0a 20 20 54 72 69 xpr*, u8);. Tri
26b40 67 67 65 72 53 74 65 70 20 2a 73 71 6c 69 74 65 ggerStep *sqlite
26b50 33 54 72 69 67 67 65 72 44 65 6c 65 74 65 53 74 3TriggerDeleteSt
26b60 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 6f 6b 65 ep(sqlite3*,Toke
26b70 6e 2a 2c 20 45 78 70 72 2a 29 3b 0a 20 20 76 6f n*, Expr*);. vo
26b80 69 64 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 id sqlite3Delete
26b90 54 72 69 67 67 65 72 28 73 71 6c 69 74 65 33 2a Trigger(sqlite3*
26ba0 2c 20 54 72 69 67 67 65 72 2a 29 3b 0a 20 20 76 , Trigger*);. v
26bb0 6f 69 64 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e oid sqlite3Unlin
26bc0 6b 41 6e 64 44 65 6c 65 74 65 54 72 69 67 67 65 kAndDeleteTrigge
26bd0 72 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 r(sqlite3*,int,c
26be0 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 75 onst char*);. u
26bf0 33 32 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 32 sqlite3Trigge
26c00 72 43 6f 6c 6d 61 73 6b 28 50 61 72 73 65 2a 2c rColmask(Parse*,
26c10 54 72 69 67 67 65 72 2a 2c 45 78 70 72 4c 69 73 Trigger*,ExprLis
26c20 74 2a 2c 69 6e 74 2c 69 6e 74 2c 54 61 62 6c 65 t*,int,int,Table
26c30 2a 2c 69 6e 74 29 3b 0a 23 20 64 65 66 69 6e 65 *,int);.# define
26c40 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 6f 70 sqlite3ParseTop
26c50 6c 65 76 65 6c 28 70 29 20 28 28 70 29 2d 3e 70 level(p) ((p)->p
26c60 54 6f 70 6c 65 76 65 6c 20 3f 20 28 70 29 2d 3e Toplevel ? (p)->
26c70 70 54 6f 70 6c 65 76 65 6c 20 3a 20 28 70 29 29 pToplevel : (p))
26c80 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
26c90 33 49 73 54 6f 70 6c 65 76 65 6c 28 70 29 20 28 3IsToplevel(p) (
26ca0 28 70 29 2d 3e 70 54 6f 70 6c 65 76 65 6c 3d 3d (p)->pToplevel==
26cb0 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 0).#else.# defin
26cc0 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 e sqlite3Trigger
26cd0 73 45 78 69 73 74 28 42 2c 43 2c 44 2c 45 2c 46 sExist(B,C,D,E,F
26ce0 29 20 30 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ) 0.# define sql
26cf0 69 74 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 ite3DeleteTrigge
26d00 72 28 41 2c 42 29 0a 23 20 64 65 66 69 6e 65 20 r(A,B).# define
26d10 73 71 6c 69 74 65 33 44 72 6f 70 54 72 69 67 67 sqlite3DropTrigg
26d20 65 72 50 74 72 28 41 2c 42 29 0a 23 20 64 65 66 erPtr(A,B).# def
26d30 69 6e 65 20 73 71 6c 69 74 65 33 55 6e 6c 69 6e ine sqlite3Unlin
26d40 6b 41 6e 64 44 65 6c 65 74 65 54 72 69 67 67 65 kAndDeleteTrigge
26d50 72 28 41 2c 42 2c 43 29 0a 23 20 64 65 66 69 6e r(A,B,C).# defin
26d60 65 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 e sqlite3CodeRow
26d70 54 72 69 67 67 65 72 28 41 2c 42 2c 43 2c 44 2c Trigger(A,B,C,D,
26d80 45 2c 46 2c 47 2c 48 2c 49 29 0a 23 20 64 65 66 E,F,G,H,I).# def
26d90 69 6e 65 20 73 71 6c 69 74 65 33 43 6f 64 65 52 ine sqlite3CodeR
26da0 6f 77 54 72 69 67 67 65 72 44 69 72 65 63 74 28 owTriggerDirect(
26db0 41 2c 42 2c 43 2c 44 2c 45 2c 46 29 0a 23 20 64 A,B,C,D,E,F).# d
26dc0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 72 69 efine sqlite3Tri
26dd0 67 67 65 72 4c 69 73 74 28 58 2c 20 59 29 20 30 ggerList(X, Y) 0
26de0 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
26df0 33 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 3ParseToplevel(p
26e00 29 20 70 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ) p.# define sql
26e10 69 74 65 33 49 73 54 6f 70 6c 65 76 65 6c 28 70 ite3IsToplevel(p
26e20 29 20 31 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ) 1.# define sql
26e30 69 74 65 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 ite3TriggerColma
26e40 73 6b 28 41 2c 42 2c 43 2c 44 2c 45 2c 46 2c 47 sk(A,B,C,D,E,F,G
26e50 29 20 30 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 ) 0.#endif..int
26e60 73 71 6c 69 74 65 33 4a 6f 69 6e 54 79 70 65 28 sqlite3JoinType(
26e70 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 Parse*, Token*,
26e80 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b Token*, Token*);
26e90 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 72 65 .void sqlite3Cre
26ea0 61 74 65 46 6f 72 65 69 67 6e 4b 65 79 28 50 61 ateForeignKey(Pa
26eb0 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c rse*, ExprList*,
26ec0 20 54 6f 6b 65 6e 2a 2c 20 45 78 70 72 4c 69 73 Token*, ExprLis
26ed0 74 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 t*, int);.void s
26ee0 71 6c 69 74 65 33 44 65 66 65 72 46 6f 72 65 69 qlite3DeferForei
26ef0 67 6e 4b 65 79 28 50 61 72 73 65 2a 2c 20 69 6e gnKey(Parse*, in
26f00 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 t);.#ifndef SQLI
26f10 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a TE_OMIT_AUTHORIZ
26f20 41 54 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 6c ATION. void sql
26f30 69 74 65 33 41 75 74 68 52 65 61 64 28 50 61 72 ite3AuthRead(Par
26f40 73 65 2a 2c 45 78 70 72 2a 2c 53 63 68 65 6d 61 se*,Expr*,Schema
26f50 2a 2c 53 72 63 4c 69 73 74 2a 29 3b 0a 20 20 69 *,SrcList*);. i
26f60 6e 74 20 73 71 6c 69 74 65 33 41 75 74 68 43 68 nt sqlite3AuthCh
26f70 65 63 6b 28 50 61 72 73 65 2a 2c 69 6e 74 2c 20 eck(Parse*,int,
26f80 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
26f90 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
26fa0 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 char*);. void s
26fb0 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 65 78 qlite3AuthContex
26fc0 74 50 75 73 68 28 50 61 72 73 65 2a 2c 20 41 75 tPush(Parse*, Au
26fd0 74 68 43 6f 6e 74 65 78 74 2a 2c 20 63 6f 6e 73 thContext*, cons
26fe0 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 64 t char*);. void
26ff0 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f 6e 74 sqlite3AuthCont
27000 65 78 74 50 6f 70 28 41 75 74 68 43 6f 6e 74 65 extPop(AuthConte
27010 78 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 xt*);. int sqli
27020 74 65 33 41 75 74 68 52 65 61 64 43 6f 6c 28 50 te3AuthReadCol(P
27030 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 arse*, const cha
27040 72 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 r *, const char
27050 2a 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 0a 23 *, int);.#else.#
27060 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 define sqlite3A
27070 75 74 68 52 65 61 64 28 61 2c 62 2c 63 2c 64 29 uthRead(a,b,c,d)
27080 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
27090 33 41 75 74 68 43 68 65 63 6b 28 61 2c 62 2c 63 3AuthCheck(a,b,c
270a0 2c 64 2c 65 29 20 20 20 20 53 51 4c 49 54 45 5f ,d,e) SQLITE_
270b0 4f 4b 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 OK.# define sqli
270c0 74 65 33 41 75 74 68 43 6f 6e 74 65 78 74 50 75 te3AuthContextPu
270d0 73 68 28 61 2c 62 2c 63 29 0a 23 20 64 65 66 69 sh(a,b,c).# defi
270e0 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f ne sqlite3AuthCo
270f0 6e 74 65 78 74 50 6f 70 28 61 29 20 20 28 28 76 ntextPop(a) ((v
27100 6f 69 64 29 28 61 29 29 0a 23 65 6e 64 69 66 0a oid)(a)).#endif.
27110 76 6f 69 64 20 73 71 6c 69 74 65 33 41 74 74 61 void sqlite3Atta
27120 63 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a ch(Parse*, Expr*
27130 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 29 3b , Expr*, Expr*);
27140 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 74 .void sqlite3Det
27150 61 63 68 28 50 61 72 73 65 2a 2c 20 45 78 70 72 ach(Parse*, Expr
27160 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
27170 46 69 78 49 6e 69 74 28 44 62 46 69 78 65 72 2a FixInit(DbFixer*
27180 2c 20 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 63 , Parse*, int, c
27190 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 onst char*, cons
271a0 74 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 t Token*);.int s
271b0 71 6c 69 74 65 33 46 69 78 53 72 63 4c 69 73 74 qlite3FixSrcList
271c0 28 44 62 46 69 78 65 72 2a 2c 20 53 72 63 4c 69 (DbFixer*, SrcLi
271d0 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 st*);.int sqlite
271e0 33 46 69 78 53 65 6c 65 63 74 28 44 62 46 69 78 3FixSelect(DbFix
271f0 65 72 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 er*, Select*);.i
27200 6e 74 20 73 71 6c 69 74 65 33 46 69 78 45 78 70 nt sqlite3FixExp
27210 72 28 44 62 46 69 78 65 72 2a 2c 20 45 78 70 72 r(DbFixer*, Expr
27220 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 *);.int sqlite3F
27230 69 78 45 78 70 72 4c 69 73 74 28 44 62 46 69 78 ixExprList(DbFix
27240 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 2a 29 3b er*, ExprList*);
27250 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 54 .int sqlite3FixT
27260 72 69 67 67 65 72 53 74 65 70 28 44 62 46 69 78 riggerStep(DbFix
27270 65 72 2a 2c 20 54 72 69 67 67 65 72 53 74 65 70 er*, TriggerStep
27280 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 *);.int sqlite3A
27290 74 6f 46 28 63 6f 6e 73 74 20 63 68 61 72 20 2a toF(const char *
272a0 7a 2c 20 64 6f 75 62 6c 65 2a 2c 20 69 6e 74 2c z, double*, int,
272b0 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 u8);.int sqlite
272c0 33 47 65 74 49 6e 74 33 32 28 63 6f 6e 73 74 20 3GetInt32(const
272d0 63 68 61 72 20 2a 2c 20 69 6e 74 2a 29 3b 0a 69 char *, int*);.i
272e0 6e 74 20 73 71 6c 69 74 65 33 41 74 6f 69 28 63 nt sqlite3Atoi(c
272f0 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e 74 onst char*);.int
27300 20 73 71 6c 69 74 65 33 55 74 66 31 36 42 79 74 sqlite3Utf16Byt
27310 65 4c 65 6e 28 63 6f 6e 73 74 20 76 6f 69 64 20 eLen(const void
27320 2a 70 44 61 74 61 2c 20 69 6e 74 20 6e 43 68 61 *pData, int nCha
27330 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 r);.int sqlite3U
27340 74 66 38 43 68 61 72 4c 65 6e 28 63 6f 6e 73 74 tf8CharLen(const
27350 20 63 68 61 72 20 2a 70 44 61 74 61 2c 20 69 6e char *pData, in
27360 74 20 6e 42 79 74 65 29 3b 0a 75 33 32 20 73 71 t nByte);.u32 sq
27370 6c 69 74 65 33 55 74 66 38 52 65 61 64 28 63 6f lite3Utf8Read(co
27380 6e 73 74 20 75 38 2a 2a 29 3b 0a 4c 6f 67 45 73 nst u8**);.LogEs
27390 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 t sqlite3LogEst(
273a0 75 36 34 29 3b 0a 4c 6f 67 45 73 74 20 73 71 6c u64);.LogEst sql
273b0 69 74 65 33 4c 6f 67 45 73 74 41 64 64 28 4c 6f ite3LogEstAdd(Lo
273c0 67 45 73 74 2c 4c 6f 67 45 73 74 29 3b 0a 23 69 gEst,LogEst);.#i
273d0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
273e0 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 4c T_VIRTUALTABLE.L
273f0 6f 67 45 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 ogEst sqlite3Log
27400 45 73 74 46 72 6f 6d 44 6f 75 62 6c 65 28 64 6f EstFromDouble(do
27410 75 62 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 75 36 uble);.#endif.u6
27420 34 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 54 4 sqlite3LogEstT
27430 6f 49 6e 74 28 4c 6f 67 45 73 74 29 3b 0a 0a 2f oInt(LogEst);../
27440 2a 0a 2a 2a 20 52 6f 75 74 69 6e 65 73 20 74 6f *.** Routines to
27450 20 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 read and write
27460 76 61 72 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 variable-length
27470 69 6e 74 65 67 65 72 73 2e 20 20 54 68 65 73 65 integers. These
27480 20 75 73 65 64 20 74 6f 0a 2a 2a 20 62 65 20 64 used to.** be d
27490 65 66 69 6e 65 64 20 6c 6f 63 61 6c 6c 79 2c 20 efined locally,
274a0 62 75 74 20 6e 6f 77 20 77 65 20 75 73 65 20 74 but now we use t
274b0 68 65 20 76 61 72 69 6e 74 20 72 6f 75 74 69 6e he varint routin
274c0 65 73 20 69 6e 20 74 68 65 20 75 74 69 6c 2e 63 es in the util.c
274d0 0a 2a 2a 20 66 69 6c 65 2e 0a 2a 2f 0a 69 6e 74 .** file..*/.int
274e0 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 6e sqlite3PutVarin
274f0 74 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a t(unsigned char*
27500 2c 20 75 36 34 29 3b 0a 75 38 20 73 71 6c 69 74 , u64);.u8 sqlit
27510 65 33 47 65 74 56 61 72 69 6e 74 28 63 6f 6e 73 e3GetVarint(cons
27520 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 t unsigned char
27530 2a 2c 20 75 36 34 20 2a 29 3b 0a 75 38 20 73 71 *, u64 *);.u8 sq
27540 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 lite3GetVarint32
27550 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 (const unsigned
27560 63 68 61 72 20 2a 2c 20 75 33 32 20 2a 29 3b 0a char *, u32 *);.
27570 69 6e 74 20 73 71 6c 69 74 65 33 56 61 72 69 6e int sqlite3Varin
27580 74 4c 65 6e 28 75 36 34 20 76 29 3b 0a 0a 2f 2a tLen(u64 v);../*
27590 0a 2a 2a 20 54 68 65 20 63 6f 6d 6d 6f 6e 20 63 .** The common c
275a0 61 73 65 20 69 73 20 66 6f 72 20 61 20 76 61 72 ase is for a var
275b0 69 6e 74 20 74 6f 20 62 65 20 61 20 73 69 6e 67 int to be a sing
275c0 6c 65 20 62 79 74 65 2e 20 20 54 68 65 79 20 66 le byte. They f
275d0 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 6d 61 63 72 ollowing.** macr
275e0 6f 73 20 68 61 6e 64 6c 65 20 74 68 65 20 63 6f os handle the co
275f0 6d 6d 6f 6e 20 63 61 73 65 20 77 69 74 68 6f 75 mmon case withou
27600 74 20 61 20 70 72 6f 63 65 64 75 72 65 20 63 61 t a procedure ca
27610 6c 6c 2c 20 62 75 74 20 74 68 65 6e 20 63 61 6c ll, but then cal
27620 6c 0a 2a 2a 20 74 68 65 20 70 72 6f 63 65 64 75 l.** the procedu
27630 72 65 20 66 6f 72 20 6c 61 72 67 65 72 20 76 61 re for larger va
27640 72 69 6e 74 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e rints..*/.#defin
27650 65 20 67 65 74 56 61 72 69 6e 74 33 32 28 41 2c e getVarint32(A,
27660 42 29 20 20 5c 0a 20 20 28 75 38 29 28 28 2a 28 B) \. (u8)((*(
27670 41 29 3c 28 75 38 29 30 78 38 30 29 3f 28 28 42 A)<(u8)0x80)?((B
27680 29 3d 28 75 33 32 29 2a 28 41 29 29 2c 31 3a 73 )=(u32)*(A)),1:s
27690 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 qlite3GetVarint3
276a0 32 28 28 41 29 2c 28 75 33 32 20 2a 29 26 28 42 2((A),(u32 *)&(B
276b0 29 29 29 0a 23 64 65 66 69 6e 65 20 70 75 74 56 ))).#define putV
276c0 61 72 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a arint32(A,B) \.
276d0 20 20 28 75 38 29 28 28 28 75 33 32 29 28 42 29 (u8)(((u32)(B)
276e0 3c 28 75 33 32 29 30 78 38 30 29 3f 28 2a 28 41 <(u32)0x80)?(*(A
276f0 29 3d 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 )=(unsigned char
27700 29 28 42 29 29 2c 31 3a 5c 0a 20 20 73 71 6c 69 )(B)),1:\. sqli
27710 74 65 33 50 75 74 56 61 72 69 6e 74 28 28 41 29 te3PutVarint((A)
27720 2c 28 42 29 29 29 0a 23 64 65 66 69 6e 65 20 67 ,(B))).#define g
27730 65 74 56 61 72 69 6e 74 20 20 20 20 73 71 6c 69 etVarint sqli
27740 74 65 33 47 65 74 56 61 72 69 6e 74 0a 23 64 65 te3GetVarint.#de
27750 66 69 6e 65 20 70 75 74 56 61 72 69 6e 74 20 20 fine putVarint
27760 20 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 69 sqlite3PutVari
27770 6e 74 0a 0a 0a 63 6f 6e 73 74 20 63 68 61 72 20 nt...const char
27780 2a 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 66 *sqlite3IndexAff
27790 69 6e 69 74 79 53 74 72 28 73 71 6c 69 74 65 33 inityStr(sqlite3
277a0 2a 2c 20 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 *, Index*);.void
277b0 20 73 71 6c 69 74 65 33 54 61 62 6c 65 41 66 66 sqlite3TableAff
277c0 69 6e 69 74 79 28 56 64 62 65 2a 2c 20 54 61 62 inity(Vdbe*, Tab
277d0 6c 65 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 le*, int);.char
277e0 73 71 6c 69 74 65 33 43 6f 6d 70 61 72 65 41 66 sqlite3CompareAf
277f0 66 69 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 finity(Expr *pEx
27800 70 72 2c 20 63 68 61 72 20 61 66 66 32 29 3b 0a pr, char aff2);.
27810 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 65 78 int sqlite3Index
27820 41 66 66 69 6e 69 74 79 4f 6b 28 45 78 70 72 20 AffinityOk(Expr
27830 2a 70 45 78 70 72 2c 20 63 68 61 72 20 69 64 78 *pExpr, char idx
27840 5f 61 66 66 69 6e 69 74 79 29 3b 0a 63 68 61 72 _affinity);.char
27850 20 73 71 6c 69 74 65 33 45 78 70 72 41 66 66 69 sqlite3ExprAffi
27860 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 72 nity(Expr *pExpr
27870 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 74 );.int sqlite3At
27880 6f 69 36 34 28 63 6f 6e 73 74 20 63 68 61 72 2a oi64(const char*
27890 2c 20 69 36 34 2a 2c 20 69 6e 74 2c 20 75 38 29 , i64*, int, u8)
278a0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 65 63 ;.int sqlite3Dec
278b0 4f 72 48 65 78 54 6f 49 36 34 28 63 6f 6e 73 74 OrHexToI64(const
278c0 20 63 68 61 72 2a 2c 20 69 36 34 2a 29 3b 0a 76 char*, i64*);.v
278d0 6f 69 64 20 73 71 6c 69 74 65 33 45 72 72 6f 72 oid sqlite3Error
278e0 57 69 74 68 4d 73 67 28 73 71 6c 69 74 65 33 2a WithMsg(sqlite3*
278f0 2c 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 , int, const cha
27900 72 2a 2c 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 r*,...);.void sq
27910 6c 69 74 65 33 45 72 72 6f 72 28 73 71 6c 69 74 lite3Error(sqlit
27920 65 33 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 2a e3*,int);.void *
27930 73 71 6c 69 74 65 33 48 65 78 54 6f 42 6c 6f 62 sqlite3HexToBlob
27940 28 73 71 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 (sqlite3*, const
27950 20 63 68 61 72 20 2a 7a 2c 20 69 6e 74 20 6e 29 char *z, int n)
27960 3b 0a 75 38 20 73 71 6c 69 74 65 33 48 65 78 54 ;.u8 sqlite3HexT
27970 6f 49 6e 74 28 69 6e 74 20 68 29 3b 0a 69 6e 74 oInt(int h);.int
27980 20 73 71 6c 69 74 65 33 54 77 6f 50 61 72 74 4e sqlite3TwoPartN
27990 61 6d 65 28 50 61 72 73 65 20 2a 2c 20 54 6f 6b ame(Parse *, Tok
279a0 65 6e 20 2a 2c 20 54 6f 6b 65 6e 20 2a 2c 20 54 en *, Token *, T
279b0 6f 6b 65 6e 20 2a 2a 29 3b 0a 0a 23 69 66 20 64 oken **);..#if d
279c0 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4e 45 efined(SQLITE_NE
279d0 45 44 5f 45 52 52 5f 4e 41 4d 45 29 0a 63 6f 6e ED_ERR_NAME).con
279e0 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 33 st char *sqlite3
279f0 45 72 72 4e 61 6d 65 28 69 6e 74 29 3b 0a 23 65 ErrName(int);.#e
27a00 6e 64 69 66 0a 0a 63 6f 6e 73 74 20 63 68 61 72 ndif..const char
27a10 20 2a 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 *sqlite3ErrStr(
27a20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
27a30 33 52 65 61 64 53 63 68 65 6d 61 28 50 61 72 73 3ReadSchema(Pars
27a40 65 20 2a 70 50 61 72 73 65 29 3b 0a 43 6f 6c 6c e *pParse);.Coll
27a50 53 65 71 20 2a 73 71 6c 69 74 65 33 46 69 6e 64 Seq *sqlite3Find
27a60 43 6f 6c 6c 53 65 71 28 73 71 6c 69 74 65 33 2a CollSeq(sqlite3*
27a70 2c 75 38 20 65 6e 63 2c 20 63 6f 6e 73 74 20 63 ,u8 enc, const c
27a80 68 61 72 2a 2c 69 6e 74 29 3b 0a 43 6f 6c 6c 53 har*,int);.CollS
27a90 65 71 20 2a 73 71 6c 69 74 65 33 4c 6f 63 61 74 eq *sqlite3Locat
27aa0 65 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a eCollSeq(Parse *
27ab0 70 50 61 72 73 65 2c 20 63 6f 6e 73 74 20 63 68 pParse, const ch
27ac0 61 72 2a 7a 4e 61 6d 65 29 3b 0a 43 6f 6c 6c 53 ar*zName);.CollS
27ad0 65 71 20 2a 73 71 6c 69 74 65 33 45 78 70 72 43 eq *sqlite3ExprC
27ae0 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a 70 50 ollSeq(Parse *pP
27af0 61 72 73 65 2c 20 45 78 70 72 20 2a 70 45 78 70 arse, Expr *pExp
27b00 72 29 3b 0a 45 78 70 72 20 2a 73 71 6c 69 74 65 r);.Expr *sqlite
27b10 33 45 78 70 72 41 64 64 43 6f 6c 6c 61 74 65 54 3ExprAddCollateT
27b20 6f 6b 65 6e 28 50 61 72 73 65 20 2a 70 50 61 72 oken(Parse *pPar
27b30 73 65 2c 20 45 78 70 72 2a 2c 20 63 6f 6e 73 74 se, Expr*, const
27b40 20 54 6f 6b 65 6e 2a 2c 20 69 6e 74 29 3b 0a 45 Token*, int);.E
27b50 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 xpr *sqlite3Expr
27b60 41 64 64 43 6f 6c 6c 61 74 65 53 74 72 69 6e 67 AddCollateString
27b70 28 50 61 72 73 65 2a 2c 45 78 70 72 2a 2c 63 6f (Parse*,Expr*,co
27b80 6e 73 74 20 63 68 61 72 2a 29 3b 0a 45 78 70 72 nst char*);.Expr
27b90 20 2a 73 71 6c 69 74 65 33 45 78 70 72 53 6b 69 *sqlite3ExprSki
27ba0 70 43 6f 6c 6c 61 74 65 28 45 78 70 72 2a 29 3b pCollate(Expr*);
27bb0 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 .int sqlite3Chec
27bc0 6b 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a kCollSeq(Parse *
27bd0 2c 20 43 6f 6c 6c 53 65 71 20 2a 29 3b 0a 69 6e , CollSeq *);.in
27be0 74 20 73 71 6c 69 74 65 33 43 68 65 63 6b 4f 62 t sqlite3CheckOb
27bf0 6a 65 63 74 4e 61 6d 65 28 50 61 72 73 65 20 2a jectName(Parse *
27c00 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b , const char *);
27c10 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 .void sqlite3Vdb
27c20 65 53 65 74 43 68 61 6e 67 65 73 28 73 71 6c 69 eSetChanges(sqli
27c30 74 65 33 20 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 te3 *, int);.int
27c40 20 73 71 6c 69 74 65 33 41 64 64 49 6e 74 36 34 sqlite3AddInt64
27c50 28 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 (i64*,i64);.int
27c60 73 71 6c 69 74 65 33 53 75 62 49 6e 74 36 34 28 sqlite3SubInt64(
27c70 69 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 73 i64*,i64);.int s
27c80 71 6c 69 74 65 33 4d 75 6c 49 6e 74 36 34 28 69 qlite3MulInt64(i
27c90 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 73 71 64*,i64);.int sq
27ca0 6c 69 74 65 33 41 62 73 49 6e 74 33 32 28 69 6e lite3AbsInt32(in
27cb0 74 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 t);.#ifdef SQLIT
27cc0 45 5f 45 4e 41 42 4c 45 5f 38 5f 33 5f 4e 41 4d E_ENABLE_8_3_NAM
27cd0 45 53 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 ES.void sqlite3F
27ce0 69 6c 65 53 75 66 66 69 78 33 28 63 6f 6e 73 74 ileSuffix3(const
27cf0 20 63 68 61 72 2a 2c 20 63 68 61 72 2a 29 3b 0a char*, char*);.
27d00 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
27d10 71 6c 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 qlite3FileSuffix
27d20 33 28 58 2c 59 29 0a 23 65 6e 64 69 66 0a 75 38 3(X,Y).#endif.u8
27d30 20 73 71 6c 69 74 65 33 47 65 74 42 6f 6f 6c 65 sqlite3GetBoole
27d40 61 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a an(const char *z
27d50 2c 75 38 29 3b 0a 0a 63 6f 6e 73 74 20 76 6f 69 ,u8);..const voi
27d60 64 20 2a 73 71 6c 69 74 65 33 56 61 6c 75 65 54 d *sqlite3ValueT
27d70 65 78 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 ext(sqlite3_valu
27d80 65 2a 2c 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c e*, u8);.int sql
27d90 69 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 73 ite3ValueBytes(s
27da0 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2c 20 75 qlite3_value*, u
27db0 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 8);.void sqlite3
27dc0 56 61 6c 75 65 53 65 74 53 74 72 28 73 71 6c 69 ValueSetStr(sqli
27dd0 74 65 33 5f 76 61 6c 75 65 2a 2c 20 69 6e 74 2c te3_value*, int,
27de0 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2c 75 38 const void *,u8
27df0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
27e00 20 20 20 20 20 20 20 20 20 20 76 6f 69 64 28 2a void(*
27e10 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f 69 64 20 )(void*));.void
27e20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 4e sqlite3ValueSetN
27e30 75 6c 6c 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 ull(sqlite3_valu
27e40 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
27e50 33 56 61 6c 75 65 46 72 65 65 28 73 71 6c 69 74 3ValueFree(sqlit
27e60 65 33 5f 76 61 6c 75 65 2a 29 3b 0a 73 71 6c 69 e3_value*);.sqli
27e70 74 65 33 5f 76 61 6c 75 65 20 2a 73 71 6c 69 74 te3_value *sqlit
27e80 65 33 56 61 6c 75 65 4e 65 77 28 73 71 6c 69 74 e3ValueNew(sqlit
27e90 65 33 20 2a 29 3b 0a 63 68 61 72 20 2a 73 71 6c e3 *);.char *sql
27ea0 69 74 65 33 55 74 66 31 36 74 6f 38 28 73 71 6c ite3Utf16to8(sql
27eb0 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 20 76 6f ite3 *, const vo
27ec0 69 64 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 id*, int, u8);.i
27ed0 6e 74 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 nt sqlite3ValueF
27ee0 72 6f 6d 45 78 70 72 28 73 71 6c 69 74 65 33 20 romExpr(sqlite3
27ef0 2a 2c 20 45 78 70 72 20 2a 2c 20 75 38 2c 20 75 *, Expr *, u8, u
27f00 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 8, sqlite3_value
27f10 20 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 **);.void sqlit
27f20 65 33 56 61 6c 75 65 41 70 70 6c 79 41 66 66 69 e3ValueApplyAffi
27f30 6e 69 74 79 28 73 71 6c 69 74 65 33 5f 76 61 6c nity(sqlite3_val
27f40 75 65 20 2a 2c 20 75 38 2c 20 75 38 29 3b 0a 23 ue *, u8, u8);.#
27f50 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 41 4d ifndef SQLITE_AM
27f60 41 4c 47 41 4d 41 54 49 4f 4e 0a 65 78 74 65 72 ALGAMATION.exter
27f70 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 n const unsigned
27f80 20 63 68 61 72 20 73 71 6c 69 74 65 33 4f 70 63 char sqlite3Opc
27f90 6f 64 65 50 72 6f 70 65 72 74 79 5b 5d 3b 0a 65 odeProperty[];.e
27fa0 78 74 65 72 6e 20 63 6f 6e 73 74 20 63 68 61 72 xtern const char
27fb0 20 73 71 6c 69 74 65 33 53 74 72 42 49 4e 41 52 sqlite3StrBINAR
27fc0 59 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 Y[];.extern cons
27fd0 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 t unsigned char
27fe0 73 71 6c 69 74 65 33 55 70 70 65 72 54 6f 4c 6f sqlite3UpperToLo
27ff0 77 65 72 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 6f wer[];.extern co
28000 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 nst unsigned cha
28010 72 20 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 r sqlite3CtypeMa
28020 70 5b 5d 3b 0a 65 78 74 65 72 6e 20 63 6f 6e 73 p[];.extern cons
28030 74 20 54 6f 6b 65 6e 20 73 71 6c 69 74 65 33 49 t Token sqlite3I
28040 6e 74 54 6f 6b 65 6e 73 5b 5d 3b 0a 65 78 74 65 ntTokens[];.exte
28050 72 6e 20 53 51 4c 49 54 45 5f 57 53 44 20 73 74 rn SQLITE_WSD st
28060 72 75 63 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 ruct Sqlite3Conf
28070 69 67 20 73 71 6c 69 74 65 33 43 6f 6e 66 69 67 ig sqlite3Config
28080 3b 0a 65 78 74 65 72 6e 20 46 75 6e 63 44 65 66 ;.extern FuncDef
28090 48 61 73 68 20 73 71 6c 69 74 65 33 42 75 69 6c Hash sqlite3Buil
280a0 74 69 6e 46 75 6e 63 74 69 6f 6e 73 3b 0a 23 69 tinFunctions;.#i
280b0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
280c0 54 5f 57 53 44 0a 65 78 74 65 72 6e 20 69 6e 74 T_WSD.extern int
280d0 20 73 71 6c 69 74 65 33 50 65 6e 64 69 6e 67 42 sqlite3PendingB
280e0 79 74 65 3b 0a 23 65 6e 64 69 66 0a 23 65 6e 64 yte;.#endif.#end
280f0 69 66 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 if.void sqlite3R
28100 6f 6f 74 50 61 67 65 4d 6f 76 65 64 28 73 71 6c ootPageMoved(sql
28110 69 74 65 33 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c ite3*, int, int,
28120 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
28130 74 65 33 52 65 69 6e 64 65 78 28 50 61 72 73 65 te3Reindex(Parse
28140 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e *, Token*, Token
28150 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
28160 41 6c 74 65 72 46 75 6e 63 74 69 6f 6e 73 28 76 AlterFunctions(v
28170 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 oid);.void sqlit
28180 65 33 41 6c 74 65 72 52 65 6e 61 6d 65 54 61 62 e3AlterRenameTab
28190 6c 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 le(Parse*, SrcLi
281a0 73 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e st*, Token*);.in
281b0 74 20 73 71 6c 69 74 65 33 47 65 74 54 6f 6b 65 t sqlite3GetToke
281c0 6e 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 n(const unsigned
281d0 20 63 68 61 72 20 2a 2c 20 69 6e 74 20 2a 29 3b char *, int *);
281e0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4e 65 73 .void sqlite3Nes
281f0 74 65 64 50 61 72 73 65 28 50 61 72 73 65 2a 2c tedParse(Parse*,
28200 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e const char*, ..
28210 2e 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 .);.void sqlite3
28220 45 78 70 69 72 65 50 72 65 70 61 72 65 64 53 74 ExpirePreparedSt
28230 61 74 65 6d 65 6e 74 73 28 73 71 6c 69 74 65 33 atements(sqlite3
28240 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 *);.int sqlite3C
28250 6f 64 65 53 75 62 73 65 6c 65 63 74 28 50 61 72 odeSubselect(Par
28260 73 65 20 2a 2c 20 45 78 70 72 20 2a 2c 20 69 6e se *, Expr *, in
28270 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 t, int);.void sq
28280 6c 69 74 65 33 53 65 6c 65 63 74 50 72 65 70 28 lite3SelectPrep(
28290 50 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c Parse*, Select*,
282a0 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 29 3b 0a NameContext*);.
282b0 76 6f 69 64 20 73 71 6c 69 74 65 33 53 65 6c 65 void sqlite3Sele
282c0 63 74 57 72 6f 6e 67 4e 75 6d 54 65 72 6d 73 45 ctWrongNumTermsE
282d0 72 72 6f 72 28 50 61 72 73 65 20 2a 70 50 61 72 rror(Parse *pPar
282e0 73 65 2c 20 53 65 6c 65 63 74 20 2a 70 29 3b 0a se, Select *p);.
282f0 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 74 63 68 int sqlite3Match
28300 53 70 61 6e 4e 61 6d 65 28 63 6f 6e 73 74 20 63 SpanName(const c
28310 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 har*, const char
28320 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 *, const char*,
28330 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 69 6e const char*);.in
28340 74 20 73 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 t sqlite3Resolve
28350 45 78 70 72 4e 61 6d 65 73 28 4e 61 6d 65 43 6f ExprNames(NameCo
28360 6e 74 65 78 74 2a 2c 20 45 78 70 72 2a 29 3b 0a ntext*, Expr*);.
28370 69 6e 74 20 73 71 6c 69 74 65 33 52 65 73 6f 6c int sqlite3Resol
28380 76 65 45 78 70 72 4c 69 73 74 4e 61 6d 65 73 28 veExprListNames(
28390 4e 61 6d 65 43 6f 6e 74 65 78 74 2a 2c 20 45 78 NameContext*, Ex
283a0 70 72 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 20 73 prList*);.void s
283b0 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 53 65 6c qlite3ResolveSel
283c0 65 63 74 4e 61 6d 65 73 28 50 61 72 73 65 2a 2c ectNames(Parse*,
283d0 20 53 65 6c 65 63 74 2a 2c 20 4e 61 6d 65 43 6f Select*, NameCo
283e0 6e 74 65 78 74 2a 29 3b 0a 76 6f 69 64 20 73 71 ntext*);.void sq
283f0 6c 69 74 65 33 52 65 73 6f 6c 76 65 53 65 6c 66 lite3ResolveSelf
28400 52 65 66 65 72 65 6e 63 65 28 50 61 72 73 65 2a Reference(Parse*
28410 2c 54 61 62 6c 65 2a 2c 69 6e 74 2c 45 78 70 72 ,Table*,int,Expr
28420 2a 2c 45 78 70 72 4c 69 73 74 2a 29 3b 0a 69 6e *,ExprList*);.in
28430 74 20 73 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 t sqlite3Resolve
28440 4f 72 64 65 72 47 72 6f 75 70 42 79 28 50 61 72 OrderGroupBy(Par
28450 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 45 78 se*, Select*, Ex
28460 70 72 4c 69 73 74 2a 2c 20 63 6f 6e 73 74 20 63 prList*, const c
28470 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 har*);.void sqli
28480 74 65 33 43 6f 6c 75 6d 6e 44 65 66 61 75 6c 74 te3ColumnDefault
28490 28 56 64 62 65 20 2a 2c 20 54 61 62 6c 65 20 2a (Vdbe *, Table *
284a0 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
284b0 64 20 73 71 6c 69 74 65 33 41 6c 74 65 72 46 69 d sqlite3AlterFi
284c0 6e 69 73 68 41 64 64 43 6f 6c 75 6d 6e 28 50 61 nishAddColumn(Pa
284d0 72 73 65 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b rse *, Token *);
284e0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 6c 74 .void sqlite3Alt
284f0 65 72 42 65 67 69 6e 41 64 64 43 6f 6c 75 6d 6e erBeginAddColumn
28500 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c 69 73 (Parse *, SrcLis
28510 74 20 2a 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 t *);.CollSeq *s
28520 71 6c 69 74 65 33 47 65 74 43 6f 6c 6c 53 65 71 qlite3GetCollSeq
28530 28 50 61 72 73 65 2a 2c 20 75 38 2c 20 43 6f 6c (Parse*, u8, Col
28540 6c 53 65 71 20 2a 2c 20 63 6f 6e 73 74 20 63 68 lSeq *, const ch
28550 61 72 2a 29 3b 0a 63 68 61 72 20 73 71 6c 69 74 ar*);.char sqlit
28560 65 33 41 66 66 69 6e 69 74 79 54 79 70 65 28 63 e3AffinityType(c
28570 6f 6e 73 74 20 63 68 61 72 2a 2c 20 75 38 2a 29 onst char*, u8*)
28580 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 6e ;.void sqlite3An
28590 61 6c 79 7a 65 28 50 61 72 73 65 2a 2c 20 54 6f alyze(Parse*, To
285a0 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 ken*, Token*);.i
285b0 6e 74 20 73 71 6c 69 74 65 33 49 6e 76 6f 6b 65 nt sqlite3Invoke
285c0 42 75 73 79 48 61 6e 64 6c 65 72 28 42 75 73 79 BusyHandler(Busy
285d0 48 61 6e 64 6c 65 72 2a 29 3b 0a 69 6e 74 20 73 Handler*);.int s
285e0 71 6c 69 74 65 33 46 69 6e 64 44 62 28 73 71 6c qlite3FindDb(sql
285f0 69 74 65 33 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a ite3*, Token*);.
28600 69 6e 74 20 73 71 6c 69 74 65 33 46 69 6e 64 44 int sqlite3FindD
28610 62 4e 61 6d 65 28 73 71 6c 69 74 65 33 20 2a 2c bName(sqlite3 *,
28620 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a const char *);.
28630 69 6e 74 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 int sqlite3Analy
28640 73 69 73 4c 6f 61 64 28 73 71 6c 69 74 65 33 2a sisLoad(sqlite3*
28650 2c 69 6e 74 20 69 44 42 29 3b 0a 76 6f 69 64 20 ,int iDB);.void
28660 73 71 6c 69 74 65 33 44 65 6c 65 74 65 49 6e 64 sqlite3DeleteInd
28670 65 78 53 61 6d 70 6c 65 73 28 73 71 6c 69 74 65 exSamples(sqlite
28680 33 2a 2c 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 3*,Index*);.void
28690 20 73 71 6c 69 74 65 33 44 65 66 61 75 6c 74 52 sqlite3DefaultR
286a0 6f 77 45 73 74 28 49 6e 64 65 78 2a 29 3b 0a 76 owEst(Index*);.v
286b0 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 73 oid sqlite3Regis
286c0 74 65 72 4c 69 6b 65 46 75 6e 63 74 69 6f 6e 73 terLikeFunctions
286d0 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 29 3b (sqlite3*, int);
286e0 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 73 4c 69 .int sqlite3IsLi
286f0 6b 65 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 keFunction(sqlit
28700 65 33 2a 2c 45 78 70 72 2a 2c 69 6e 74 2a 2c 63 e3*,Expr*,int*,c
28710 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 har*);.void sqli
28720 74 65 33 53 63 68 65 6d 61 43 6c 65 61 72 28 76 te3SchemaClear(v
28730 6f 69 64 20 2a 29 3b 0a 53 63 68 65 6d 61 20 2a oid *);.Schema *
28740 73 71 6c 69 74 65 33 53 63 68 65 6d 61 47 65 74 sqlite3SchemaGet
28750 28 73 71 6c 69 74 65 33 20 2a 2c 20 42 74 72 65 (sqlite3 *, Btre
28760 65 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 e *);.int sqlite
28770 33 53 63 68 65 6d 61 54 6f 49 6e 64 65 78 28 73 3SchemaToIndex(s
28780 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 63 68 65 qlite3 *db, Sche
28790 6d 61 20 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a ma *);.KeyInfo *
287a0 73 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 41 6c sqlite3KeyInfoAl
287b0 6c 6f 63 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 loc(sqlite3*,int
287c0 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
287d0 74 65 33 4b 65 79 49 6e 66 6f 55 6e 72 65 66 28 te3KeyInfoUnref(
287e0 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b 65 79 49 6e KeyInfo*);.KeyIn
287f0 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 6e fo *sqlite3KeyIn
28800 66 6f 52 65 66 28 4b 65 79 49 6e 66 6f 2a 29 3b foRef(KeyInfo*);
28810 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 65 .KeyInfo *sqlite
28820 33 4b 65 79 49 6e 66 6f 4f 66 49 6e 64 65 78 28 3KeyInfoOfIndex(
28830 50 61 72 73 65 2a 2c 20 49 6e 64 65 78 2a 29 3b Parse*, Index*);
28840 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 .#ifdef SQLITE_D
28850 45 42 55 47 0a 69 6e 74 20 73 71 6c 69 74 65 33 EBUG.int sqlite3
28860 4b 65 79 49 6e 66 6f 49 73 57 72 69 74 65 61 62 KeyInfoIsWriteab
28870 6c 65 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 23 65 le(KeyInfo*);.#e
28880 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 ndif.int sqlite3
28890 43 72 65 61 74 65 46 75 6e 63 28 73 71 6c 69 74 CreateFunc(sqlit
288a0 65 33 20 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 e3 *, const char
288b0 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 76 6f *, int, int, vo
288c0 69 64 20 2a 2c 0a 20 20 76 6f 69 64 20 28 2a 29 id *,. void (*)
288d0 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
288e0 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 *,int,sqlite3_va
288f0 6c 75 65 20 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 lue **),. void
28900 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 (*)(sqlite3_cont
28910 65 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 ext*,int,sqlite3
28920 5f 76 61 6c 75 65 20 2a 2a 29 2c 20 76 6f 69 64 _value **), void
28930 20 28 2a 29 28 73 71 6c 69 74 65 33 5f 63 6f 6e (*)(sqlite3_con
28940 74 65 78 74 2a 29 2c 0a 20 20 46 75 6e 63 44 65 text*),. FuncDe
28950 73 74 72 75 63 74 6f 72 20 2a 70 44 65 73 74 72 structor *pDestr
28960 75 63 74 6f 72 0a 29 3b 0a 76 6f 69 64 20 73 71 uctor.);.void sq
28970 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 73 71 lite3OomFault(sq
28980 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 lite3*);.void sq
28990 6c 69 74 65 33 4f 6f 6d 43 6c 65 61 72 28 73 71 lite3OomClear(sq
289a0 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 6c lite3*);.int sql
289b0 69 74 65 33 41 70 69 45 78 69 74 28 73 71 6c 69 ite3ApiExit(sqli
289c0 74 65 33 20 2a 64 62 2c 20 69 6e 74 29 3b 0a 69 te3 *db, int);.i
289d0 6e 74 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 65 nt sqlite3OpenTe
289e0 6d 70 44 61 74 61 62 61 73 65 28 50 61 72 73 65 mpDatabase(Parse
289f0 20 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 *);..void sqlit
28a00 65 33 53 74 72 41 63 63 75 6d 49 6e 69 74 28 53 e3StrAccumInit(S
28a10 74 72 41 63 63 75 6d 2a 2c 20 73 71 6c 69 74 65 trAccum*, sqlite
28a20 33 2a 2c 20 63 68 61 72 2a 2c 20 69 6e 74 2c 20 3*, char*, int,
28a30 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
28a40 65 33 53 74 72 41 63 63 75 6d 41 70 70 65 6e 64 e3StrAccumAppend
28a50 28 53 74 72 41 63 63 75 6d 2a 2c 63 6f 6e 73 74 (StrAccum*,const
28a60 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 76 6f 69 char*,int);.voi
28a70 64 20 73 71 6c 69 74 65 33 53 74 72 41 63 63 75 d sqlite3StrAccu
28a80 6d 41 70 70 65 6e 64 41 6c 6c 28 53 74 72 41 63 mAppendAll(StrAc
28a90 63 75 6d 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a cum*,const char*
28aa0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41 );.void sqlite3A
28ab0 70 70 65 6e 64 43 68 61 72 28 53 74 72 41 63 63 ppendChar(StrAcc
28ac0 75 6d 2a 2c 69 6e 74 2c 63 68 61 72 29 3b 0a 63 um*,int,char);.c
28ad0 68 61 72 20 2a 73 71 6c 69 74 65 33 53 74 72 41 har *sqlite3StrA
28ae0 63 63 75 6d 46 69 6e 69 73 68 28 53 74 72 41 63 ccumFinish(StrAc
28af0 63 75 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 cum*);.void sqli
28b00 74 65 33 53 74 72 41 63 63 75 6d 52 65 73 65 74 te3StrAccumReset
28b10 28 53 74 72 41 63 63 75 6d 2a 29 3b 0a 76 6f 69 (StrAccum*);.voi
28b20 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 d sqlite3SelectD
28b30 65 73 74 49 6e 69 74 28 53 65 6c 65 63 74 44 65 estInit(SelectDe
28b40 73 74 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 45 78 st*,int,int);.Ex
28b50 70 72 20 2a 73 71 6c 69 74 65 33 43 72 65 61 74 pr *sqlite3Creat
28b60 65 43 6f 6c 75 6d 6e 45 78 70 72 28 73 71 6c 69 eColumnExpr(sqli
28b70 74 65 33 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a te3 *, SrcList *
28b80 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 0a 76 6f , int, int);..vo
28b90 69 64 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 id sqlite3Backup
28ba0 52 65 73 74 61 72 74 28 73 71 6c 69 74 65 33 5f Restart(sqlite3_
28bb0 62 61 63 6b 75 70 20 2a 29 3b 0a 76 6f 69 64 20 backup *);.void
28bc0 73 71 6c 69 74 65 33 42 61 63 6b 75 70 55 70 64 sqlite3BackupUpd
28bd0 61 74 65 28 73 71 6c 69 74 65 33 5f 62 61 63 6b ate(sqlite3_back
28be0 75 70 20 2a 2c 20 50 67 6e 6f 2c 20 63 6f 6e 73 up *, Pgno, cons
28bf0 74 20 75 38 20 2a 29 3b 0a 0a 23 69 66 64 65 66 t u8 *);..#ifdef
28c00 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
28c10 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 76 6f TAT3_OR_STAT4.vo
28c20 69 64 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 7a id sqlite3Analyz
28c30 65 46 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 eFunctions(void)
28c40 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 ;.int sqlite3Sta
28c50 74 34 50 72 6f 62 65 53 65 74 56 61 6c 75 65 28 t4ProbeSetValue(
28c60 50 61 72 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 6e Parse*,Index*,Un
28c70 70 61 63 6b 65 64 52 65 63 6f 72 64 2a 2a 2c 45 packedRecord**,E
28c80 78 70 72 2a 2c 75 38 2c 69 6e 74 2c 69 6e 74 2a xpr*,u8,int,int*
28c90 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 );.int sqlite3St
28ca0 61 74 34 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 at4ValueFromExpr
28cb0 28 50 61 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 (Parse*, Expr*,
28cc0 75 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 u8, sqlite3_valu
28cd0 65 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 e**);.void sqlit
28ce0 65 33 53 74 61 74 34 50 72 6f 62 65 46 72 65 65 e3Stat4ProbeFree
28cf0 28 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 2a (UnpackedRecord*
28d00 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 74 );.int sqlite3St
28d10 61 74 34 43 6f 6c 75 6d 6e 28 73 71 6c 69 74 65 at4Column(sqlite
28d20 33 2a 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a 2c 3*, const void*,
28d30 20 69 6e 74 2c 20 69 6e 74 2c 20 73 71 6c 69 74 int, int, sqlit
28d40 65 33 5f 76 61 6c 75 65 2a 2a 29 3b 0a 23 65 6e e3_value**);.#en
28d50 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 69 dif../*.** The i
28d60 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 20 nterface to the
28d70 4c 45 4d 4f 4e 2d 67 65 6e 65 72 61 74 65 64 20 LEMON-generated
28d80 70 61 72 73 65 72 0a 2a 2f 0a 76 6f 69 64 20 2a parser.*/.void *
28d90 73 71 6c 69 74 65 33 50 61 72 73 65 72 41 6c 6c sqlite3ParserAll
28da0 6f 63 28 76 6f 69 64 2a 28 2a 29 28 75 36 34 29 oc(void*(*)(u64)
28db0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 );.void sqlite3P
28dc0 61 72 73 65 72 46 72 65 65 28 76 6f 69 64 2a 2c arserFree(void*,
28dd0 20 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 void(*)(void*))
28de0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 ;.void sqlite3Pa
28df0 72 73 65 72 28 76 6f 69 64 2a 2c 20 69 6e 74 2c rser(void*, int,
28e00 20 54 6f 6b 65 6e 2c 20 50 61 72 73 65 2a 29 3b Token, Parse*);
28e10 0a 23 69 66 64 65 66 20 59 59 54 52 41 43 4b 4d .#ifdef YYTRACKM
28e20 41 58 53 54 41 43 4b 44 45 50 54 48 0a 20 20 69 AXSTACKDEPTH. i
28e30 6e 74 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 nt sqlite3Parser
28e40 53 74 61 63 6b 50 65 61 6b 28 76 6f 69 64 2a 29 StackPeak(void*)
28e50 3b 0a 23 65 6e 64 69 66 0a 0a 76 6f 69 64 20 73 ;.#endif..void s
28e60 71 6c 69 74 65 33 41 75 74 6f 4c 6f 61 64 45 78 qlite3AutoLoadEx
28e70 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 tensions(sqlite3
28e80 2a 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 *);.#ifndef SQLI
28e90 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 5f 45 58 54 TE_OMIT_LOAD_EXT
28ea0 45 4e 53 49 4f 4e 0a 20 20 76 6f 69 64 20 73 71 ENSION. void sq
28eb0 6c 69 74 65 33 43 6c 6f 73 65 45 78 74 65 6e 73 lite3CloseExtens
28ec0 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a ions(sqlite3*);.
28ed0 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
28ee0 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 74 65 6e qlite3CloseExten
28ef0 73 69 6f 6e 73 28 58 29 0a 23 65 6e 64 69 66 0a sions(X).#endif.
28f00 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
28f10 4f 4d 49 54 5f 53 48 41 52 45 44 5f 43 41 43 48 OMIT_SHARED_CACH
28f20 45 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 E. void sqlite3
28f30 54 61 62 6c 65 4c 6f 63 6b 28 50 61 72 73 65 20 TableLock(Parse
28f40 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 75 38 2c *, int, int, u8,
28f50 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a const char *);.
28f60 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 #else. #define
28f70 73 71 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b sqlite3TableLock
28f80 28 76 2c 77 2c 78 2c 79 2c 7a 29 0a 23 65 6e 64 (v,w,x,y,z).#end
28f90 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 if..#ifdef SQLIT
28fa0 45 5f 54 45 53 54 0a 20 20 69 6e 74 20 73 71 6c E_TEST. int sql
28fb0 69 74 65 33 55 74 66 38 54 6f 38 28 75 6e 73 69 ite3Utf8To8(unsi
28fc0 67 6e 65 64 20 63 68 61 72 2a 29 3b 0a 23 65 6e gned char*);.#en
28fd0 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
28fe0 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
28ff0 41 42 4c 45 0a 23 20 20 64 65 66 69 6e 65 20 73 ABLE.# define s
29000 71 6c 69 74 65 33 56 74 61 62 43 6c 65 61 72 28 qlite3VtabClear(
29010 59 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c Y).# define sql
29020 69 74 65 33 56 74 61 62 53 79 6e 63 28 58 2c 59 ite3VtabSync(X,Y
29030 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 20 64 ) SQLITE_OK.# d
29040 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 efine sqlite3Vta
29050 62 52 6f 6c 6c 62 61 63 6b 28 58 29 0a 23 20 20 bRollback(X).#
29060 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 define sqlite3Vt
29070 61 62 43 6f 6d 6d 69 74 28 58 29 0a 23 20 20 64 abCommit(X).# d
29080 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 efine sqlite3Vta
29090 62 49 6e 53 79 6e 63 28 64 62 29 20 30 0a 23 20 bInSync(db) 0.#
290a0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 define sqlite3V
290b0 74 61 62 4c 6f 63 6b 28 58 29 0a 23 20 20 64 65 tabLock(X).# de
290c0 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 fine sqlite3Vtab
290d0 55 6e 6c 6f 63 6b 28 58 29 0a 23 20 20 64 65 66 Unlock(X).# def
290e0 69 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 55 ine sqlite3VtabU
290f0 6e 6c 6f 63 6b 4c 69 73 74 28 58 29 0a 23 20 20 nlockList(X).#
29100 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 define sqlite3Vt
29110 61 62 53 61 76 65 70 6f 69 6e 74 28 58 2c 20 59 abSavepoint(X, Y
29120 2c 20 5a 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 , Z) SQLITE_OK.#
29130 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 define sqlite3
29140 47 65 74 56 54 61 62 6c 65 28 58 2c 59 29 20 20 GetVTable(X,Y)
29150 28 28 56 54 61 62 6c 65 2a 29 30 29 0a 23 65 6c ((VTable*)0).#el
29160 73 65 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 se. void sqlit
29170 65 33 56 74 61 62 43 6c 65 61 72 28 73 71 6c 69 e3VtabClear(sqli
29180 74 65 33 20 2a 64 62 2c 20 54 61 62 6c 65 2a 29 te3 *db, Table*)
29190 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 ;. void sqlite
291a0 33 56 74 61 62 44 69 73 63 6f 6e 6e 65 63 74 28 3VtabDisconnect(
291b0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 54 61 62 sqlite3 *db, Tab
291c0 6c 65 20 2a 70 29 3b 0a 20 20 20 69 6e 74 20 73 le *p);. int s
291d0 71 6c 69 74 65 33 56 74 61 62 53 79 6e 63 28 73 qlite3VtabSync(s
291e0 71 6c 69 74 65 33 20 2a 64 62 2c 20 56 64 62 65 qlite3 *db, Vdbe
291f0 2a 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 *);. int sqlit
29200 65 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 73 e3VtabRollback(s
29210 71 6c 69 74 65 33 20 2a 64 62 29 3b 0a 20 20 20 qlite3 *db);.
29220 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 43 int sqlite3VtabC
29230 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64 ommit(sqlite3 *d
29240 62 29 3b 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 b);. void sqli
29250 74 65 33 56 74 61 62 4c 6f 63 6b 28 56 54 61 62 te3VtabLock(VTab
29260 6c 65 20 2a 29 3b 0a 20 20 20 76 6f 69 64 20 73 le *);. void s
29270 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b qlite3VtabUnlock
29280 28 56 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 76 (VTable *);. v
29290 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 55 oid sqlite3VtabU
292a0 6e 6c 6f 63 6b 4c 69 73 74 28 73 71 6c 69 74 65 nlockList(sqlite
292b0 33 2a 29 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 3*);. int sqli
292c0 74 65 33 56 74 61 62 53 61 76 65 70 6f 69 6e 74 te3VtabSavepoint
292d0 28 73 71 6c 69 74 65 33 20 2a 2c 20 69 6e 74 2c (sqlite3 *, int,
292e0 20 69 6e 74 29 3b 0a 20 20 20 76 6f 69 64 20 73 int);. void s
292f0 71 6c 69 74 65 33 56 74 61 62 49 6d 70 6f 72 74 qlite3VtabImport
29300 45 72 72 6d 73 67 28 56 64 62 65 2a 2c 20 73 71 Errmsg(Vdbe*, sq
29310 6c 69 74 65 33 5f 76 74 61 62 2a 29 3b 0a 20 20 lite3_vtab*);.
29320 20 56 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 VTable *sqlite3
29330 47 65 74 56 54 61 62 6c 65 28 73 71 6c 69 74 65 GetVTable(sqlite
29340 33 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 23 20 20 3*, Table*);.#
29350 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 74 define sqlite3Vt
29360 61 62 49 6e 53 79 6e 63 28 64 62 29 20 28 28 64 abInSync(db) ((d
29370 62 29 2d 3e 6e 56 54 72 61 6e 73 3e 30 20 26 26 b)->nVTrans>0 &&
29380 20 28 64 62 29 2d 3e 61 56 54 72 61 6e 73 3d 3d (db)->aVTrans==
29390 30 29 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 0).#endif.int sq
293a0 6c 69 74 65 33 56 74 61 62 45 70 6f 6e 79 6d 6f lite3VtabEponymo
293b0 75 73 54 61 62 6c 65 49 6e 69 74 28 50 61 72 73 usTableInit(Pars
293c0 65 2a 2c 4d 6f 64 75 6c 65 2a 29 3b 0a 76 6f 69 e*,Module*);.voi
293d0 64 20 73 71 6c 69 74 65 33 56 74 61 62 45 70 6f d sqlite3VtabEpo
293e0 6e 79 6d 6f 75 73 54 61 62 6c 65 43 6c 65 61 72 nymousTableClear
293f0 28 73 71 6c 69 74 65 33 2a 2c 4d 6f 64 75 6c 65 (sqlite3*,Module
29400 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
29410 56 74 61 62 4d 61 6b 65 57 72 69 74 61 62 6c 65 VtabMakeWritable
29420 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 29 3b (Parse*,Table*);
29430 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 .void sqlite3Vta
29440 62 42 65 67 69 6e 50 61 72 73 65 28 50 61 72 73 bBeginParse(Pars
29450 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 e*, Token*, Toke
29460 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 69 6e 74 29 n*, Token*, int)
29470 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 ;.void sqlite3Vt
29480 61 62 46 69 6e 69 73 68 50 61 72 73 65 28 50 61 abFinishParse(Pa
29490 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 rse*, Token*);.v
294a0 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 41 oid sqlite3VtabA
294b0 72 67 49 6e 69 74 28 50 61 72 73 65 2a 29 3b 0a rgInit(Parse*);.
294c0 76 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 void sqlite3Vtab
294d0 41 72 67 45 78 74 65 6e 64 28 50 61 72 73 65 2a ArgExtend(Parse*
294e0 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 , Token*);.int s
294f0 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 43 72 qlite3VtabCallCr
29500 65 61 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 69 eate(sqlite3*, i
29510 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a nt, const char *
29520 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 69 6e 74 20 , char **);.int
29530 73 71 6c 69 74 65 33 56 74 61 62 43 61 6c 6c 43 sqlite3VtabCallC
29540 6f 6e 6e 65 63 74 28 50 61 72 73 65 2a 2c 20 54 onnect(Parse*, T
29550 61 62 6c 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 able*);.int sqli
29560 74 65 33 56 74 61 62 43 61 6c 6c 44 65 73 74 72 te3VtabCallDestr
29570 6f 79 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 oy(sqlite3*, int
29580 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b , const char *);
29590 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 .int sqlite3Vtab
295a0 42 65 67 69 6e 28 73 71 6c 69 74 65 33 20 2a 2c Begin(sqlite3 *,
295b0 20 56 54 61 62 6c 65 20 2a 29 3b 0a 46 75 6e 63 VTable *);.Func
295c0 44 65 66 20 2a 73 71 6c 69 74 65 33 56 74 61 62 Def *sqlite3Vtab
295d0 4f 76 65 72 6c 6f 61 64 46 75 6e 63 74 69 6f 6e OverloadFunction
295e0 28 73 71 6c 69 74 65 33 20 2a 2c 46 75 6e 63 44 (sqlite3 *,FuncD
295f0 65 66 2a 2c 20 69 6e 74 20 6e 41 72 67 2c 20 45 ef*, int nArg, E
29600 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 xpr*);.void sqli
29610 74 65 33 49 6e 76 61 6c 69 64 46 75 6e 63 74 69 te3InvalidFuncti
29620 6f 6e 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 on(sqlite3_conte
29630 78 74 2a 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f xt*,int,sqlite3_
29640 76 61 6c 75 65 2a 2a 29 3b 0a 73 71 6c 69 74 65 value**);.sqlite
29650 33 5f 69 6e 74 36 34 20 73 71 6c 69 74 65 33 53 3_int64 sqlite3S
29660 74 6d 74 43 75 72 72 65 6e 74 54 69 6d 65 28 73 tmtCurrentTime(s
29670 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 qlite3_context*)
29680 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 ;.int sqlite3Vdb
29690 65 50 61 72 61 6d 65 74 65 72 49 6e 64 65 78 28 eParameterIndex(
296a0 56 64 62 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 Vdbe*, const cha
296b0 72 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 r*, int);.int sq
296c0 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69 6e lite3TransferBin
296d0 64 69 6e 67 73 28 73 71 6c 69 74 65 33 5f 73 74 dings(sqlite3_st
296e0 6d 74 20 2a 2c 20 73 71 6c 69 74 65 33 5f 73 74 mt *, sqlite3_st
296f0 6d 74 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 mt *);.void sqli
29700 74 65 33 50 61 72 73 65 72 52 65 73 65 74 28 50 te3ParserReset(P
29710 61 72 73 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 arse*);.int sqli
29720 74 65 33 52 65 70 72 65 70 61 72 65 28 56 64 62 te3Reprepare(Vdb
29730 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
29740 33 45 78 70 72 4c 69 73 74 43 68 65 63 6b 4c 65 3ExprListCheckLe
29750 6e 67 74 68 28 50 61 72 73 65 2a 2c 20 45 78 70 ngth(Parse*, Exp
29760 72 4c 69 73 74 2a 2c 20 63 6f 6e 73 74 20 63 68 rList*, const ch
29770 61 72 2a 29 3b 0a 43 6f 6c 6c 53 65 71 20 2a 73 ar*);.CollSeq *s
29780 71 6c 69 74 65 33 42 69 6e 61 72 79 43 6f 6d 70 qlite3BinaryComp
29790 61 72 65 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 areCollSeq(Parse
297a0 20 2a 2c 20 45 78 70 72 20 2a 2c 20 45 78 70 72 *, Expr *, Expr
297b0 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 *);.int sqlite3
297c0 54 65 6d 70 49 6e 4d 65 6d 6f 72 79 28 63 6f 6e TempInMemory(con
297d0 73 74 20 73 71 6c 69 74 65 33 2a 29 3b 0a 63 6f st sqlite3*);.co
297e0 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 74 65 nst char *sqlite
297f0 33 4a 6f 75 72 6e 61 6c 4d 6f 64 65 6e 61 6d 65 3JournalModename
29800 28 69 6e 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 (int);.#ifndef S
29810 51 4c 49 54 45 5f 4f 4d 49 54 5f 57 41 4c 0a 20 QLITE_OMIT_WAL.
29820 20 69 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 int sqlite3Chec
29830 6b 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 2a 2c kpoint(sqlite3*,
29840 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c int, int, int*,
29850 20 69 6e 74 2a 29 3b 0a 20 20 69 6e 74 20 73 71 int*);. int sq
29860 6c 69 74 65 33 57 61 6c 44 65 66 61 75 6c 74 48 lite3WalDefaultH
29870 6f 6f 6b 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 ook(void*,sqlite
29880 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 69 3*,const char*,i
29890 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 6e nt);.#endif.#ifn
298a0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
298b0 43 54 45 0a 20 20 57 69 74 68 20 2a 73 71 6c 69 CTE. With *sqli
298c0 74 65 33 57 69 74 68 41 64 64 28 50 61 72 73 65 te3WithAdd(Parse
298d0 2a 2c 57 69 74 68 2a 2c 54 6f 6b 65 6e 2a 2c 45 *,With*,Token*,E
298e0 78 70 72 4c 69 73 74 2a 2c 53 65 6c 65 63 74 2a xprList*,Select*
298f0 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
29900 33 57 69 74 68 44 65 6c 65 74 65 28 73 71 6c 69 3WithDelete(sqli
29910 74 65 33 2a 2c 57 69 74 68 2a 29 3b 0a 20 20 76 te3*,With*);. v
29920 6f 69 64 20 73 71 6c 69 74 65 33 57 69 74 68 50 oid sqlite3WithP
29930 75 73 68 28 50 61 72 73 65 2a 2c 20 57 69 74 68 ush(Parse*, With
29940 2a 2c 20 75 38 29 3b 0a 23 65 6c 73 65 0a 23 64 *, u8);.#else.#d
29950 65 66 69 6e 65 20 73 71 6c 69 74 65 33 57 69 74 efine sqlite3Wit
29960 68 50 75 73 68 28 78 2c 79 2c 7a 29 0a 23 64 65 hPush(x,y,z).#de
29970 66 69 6e 65 20 73 71 6c 69 74 65 33 57 69 74 68 fine sqlite3With
29980 44 65 6c 65 74 65 28 78 2c 79 29 0a 23 65 6e 64 Delete(x,y).#end
29990 69 66 0a 0a 2f 2a 20 44 65 63 6c 61 72 61 74 69 if../* Declarati
299a0 6f 6e 73 20 66 6f 72 20 66 75 6e 63 74 69 6f 6e ons for function
299b0 73 20 69 6e 20 66 6b 65 79 2e 63 2e 20 41 6c 6c s in fkey.c. All
299c0 20 6f 66 20 74 68 65 73 65 20 61 72 65 20 72 65 of these are re
299d0 70 6c 61 63 65 64 20 62 79 0a 2a 2a 20 6e 6f 2d placed by.** no-
299e0 6f 70 20 6d 61 63 72 6f 73 20 69 66 20 4f 4d 49 op macros if OMI
299f0 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 20 69 73 T_FOREIGN_KEY is
29a00 20 64 65 66 69 6e 65 64 2e 20 49 6e 20 74 68 69 defined. In thi
29a10 73 20 63 61 73 65 20 6e 6f 20 66 6f 72 65 69 67 s case no foreig
29a20 6e 0a 2a 2a 20 6b 65 79 20 66 75 6e 63 74 69 6f n.** key functio
29a30 6e 61 6c 69 74 79 20 69 73 20 61 76 61 69 6c 61 nality is availa
29a40 62 6c 65 2e 20 49 66 20 4f 4d 49 54 5f 54 52 49 ble. If OMIT_TRI
29a50 47 47 45 52 20 69 73 20 64 65 66 69 6e 65 64 20 GGER is defined
29a60 62 75 74 0a 2a 2a 20 4f 4d 49 54 5f 46 4f 52 45 but.** OMIT_FORE
29a70 49 47 4e 5f 4b 45 59 20 69 73 20 6e 6f 74 2c 20 IGN_KEY is not,
29a80 6f 6e 6c 79 20 73 6f 6d 65 20 6f 66 20 74 68 65 only some of the
29a90 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 6e functions are n
29aa0 6f 2d 6f 70 65 64 2e 20 49 6e 0a 2a 2a 20 74 68 o-oped. In.** th
29ab0 69 73 20 63 61 73 65 20 66 6f 72 65 69 67 6e 20 is case foreign
29ac0 6b 65 79 73 20 61 72 65 20 70 61 72 73 65 64 2c keys are parsed,
29ad0 20 62 75 74 20 6e 6f 20 6f 74 68 65 72 20 66 75 but no other fu
29ae0 6e 63 74 69 6f 6e 61 6c 69 74 79 20 69 73 0a 2a nctionality is.*
29af0 2a 20 70 72 6f 76 69 64 65 64 20 28 65 6e 66 6f * provided (enfo
29b00 72 63 65 6d 65 6e 74 20 6f 66 20 46 4b 20 63 6f rcement of FK co
29b10 6e 73 74 72 61 69 6e 74 73 20 72 65 71 75 69 72 nstraints requir
29b20 65 73 20 74 68 65 20 74 72 69 67 67 65 72 73 20 es the triggers
29b30 73 75 62 2d 73 79 73 74 65 6d 29 2e 0a 2a 2f 0a sub-system)..*/.
29b40 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
29b50 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e ITE_OMIT_FOREIGN
29b60 5f 4b 45 59 29 20 26 26 20 21 64 65 66 69 6e 65 _KEY) && !define
29b70 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 d(SQLITE_OMIT_TR
29b80 49 47 47 45 52 29 0a 20 20 76 6f 69 64 20 73 71 IGGER). void sq
29b90 6c 69 74 65 33 46 6b 43 68 65 63 6b 28 50 61 72 lite3FkCheck(Par
29ba0 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 se*, Table*, int
29bb0 2c 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 , int, int*, int
29bc0 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
29bd0 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 50 61 72 3FkDropTable(Par
29be0 73 65 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 se*, SrcList *,
29bf0 54 61 62 6c 65 2a 29 3b 0a 20 20 76 6f 69 64 20 Table*);. void
29c00 73 71 6c 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 sqlite3FkActions
29c10 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
29c20 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c ExprList*, int,
29c30 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 69 int*, int);. i
29c40 6e 74 20 73 71 6c 69 74 65 33 46 6b 52 65 71 75 nt sqlite3FkRequ
29c50 69 72 65 64 28 50 61 72 73 65 2a 2c 20 54 61 62 ired(Parse*, Tab
29c60 6c 65 2a 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b le*, int*, int);
29c70 0a 20 20 75 33 32 20 73 71 6c 69 74 65 33 46 6b . u32 sqlite3Fk
29c80 4f 6c 64 6d 61 73 6b 28 50 61 72 73 65 2a 2c 20 Oldmask(Parse*,
29c90 54 61 62 6c 65 2a 29 3b 0a 20 20 46 4b 65 79 20 Table*);. FKey
29ca0 2a 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 *sqlite3FkRefere
29cb0 6e 63 65 73 28 54 61 62 6c 65 20 2a 29 3b 0a 23 nces(Table *);.#
29cc0 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 73 else. #define s
29cd0 71 6c 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 qlite3FkActions(
29ce0 61 2c 62 2c 63 2c 64 2c 65 2c 66 29 0a 20 20 23 a,b,c,d,e,f). #
29cf0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b define sqlite3Fk
29d00 43 68 65 63 6b 28 61 2c 62 2c 63 2c 64 2c 65 2c Check(a,b,c,d,e,
29d10 66 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c f). #define sql
29d20 69 74 65 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 ite3FkDropTable(
29d30 61 2c 62 2c 63 29 0a 20 20 23 64 65 66 69 6e 65 a,b,c). #define
29d40 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 61 73 sqlite3FkOldmas
29d50 6b 28 61 2c 62 29 20 20 20 20 20 20 20 20 20 30 k(a,b) 0
29d60 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
29d70 65 33 46 6b 52 65 71 75 69 72 65 64 28 61 2c 62 e3FkRequired(a,b
29d80 2c 63 2c 64 29 20 20 20 20 30 0a 23 65 6e 64 69 ,c,d) 0.#endi
29d90 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 f.#ifndef SQLITE
29da0 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 _OMIT_FOREIGN_KE
29db0 59 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 Y. void sqlite3
29dc0 46 6b 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 FkDelete(sqlite3
29dd0 20 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a 20 20 69 *, Table*);. i
29de0 6e 74 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 nt sqlite3FkLoca
29df0 74 65 49 6e 64 65 78 28 50 61 72 73 65 2a 2c 54 teIndex(Parse*,T
29e00 61 62 6c 65 2a 2c 46 4b 65 79 2a 2c 49 6e 64 65 able*,FKey*,Inde
29e10 78 2a 2a 2c 69 6e 74 2a 2a 29 3b 0a 23 65 6c 73 x**,int**);.#els
29e20 65 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 e. #define sqli
29e30 74 65 33 46 6b 44 65 6c 65 74 65 28 61 2c 62 29 te3FkDelete(a,b)
29e40 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
29e50 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 e3FkLocateIndex(
29e60 61 2c 62 2c 63 2c 64 2c 65 29 0a 23 65 6e 64 69 a,b,c,d,e).#endi
29e70 66 0a 0a 0a 2f 2a 0a 2a 2a 20 41 76 61 69 6c 61 f.../*.** Availa
29e80 62 6c 65 20 66 61 75 6c 74 20 69 6e 6a 65 63 74 ble fault inject
29e90 6f 72 73 2e 20 20 53 68 6f 75 6c 64 20 62 65 20 ors. Should be
29ea0 6e 75 6d 62 65 72 65 64 20 62 65 67 69 6e 6e 69 numbered beginni
29eb0 6e 67 20 77 69 74 68 20 30 2e 0a 2a 2f 0a 23 64 ng with 0..*/.#d
29ec0 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 41 55 efine SQLITE_FAU
29ed0 4c 54 49 4e 4a 45 43 54 4f 52 5f 4d 41 4c 4c 4f LTINJECTOR_MALLO
29ee0 43 20 20 20 20 20 30 0a 23 64 65 66 69 6e 65 20 C 0.#define
29ef0 53 51 4c 49 54 45 5f 46 41 55 4c 54 49 4e 4a 45 SQLITE_FAULTINJE
29f00 43 54 4f 52 5f 43 4f 55 4e 54 20 20 20 20 20 20 CTOR_COUNT
29f10 31 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 1../*.** The int
29f20 65 72 66 61 63 65 20 74 6f 20 74 68 65 20 63 6f erface to the co
29f30 64 65 20 69 6e 20 66 61 75 6c 74 2e 63 20 75 73 de in fault.c us
29f40 65 64 20 66 6f 72 20 69 64 65 6e 74 69 66 79 69 ed for identifyi
29f50 6e 67 20 22 62 65 6e 69 67 6e 22 0a 2a 2a 20 6d ng "benign".** m
29f60 61 6c 6c 6f 63 20 66 61 69 6c 75 72 65 73 2e 20 alloc failures.
29f70 54 68 69 73 20 69 73 20 6f 6e 6c 79 20 70 72 65 This is only pre
29f80 73 65 6e 74 20 69 66 20 53 51 4c 49 54 45 5f 4f sent if SQLITE_O
29f90 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 54 MIT_BUILTIN_TEST
29fa0 0a 2a 2a 20 69 73 20 6e 6f 74 20 64 65 66 69 6e .** is not defin
29fb0 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ed..*/.#ifndef S
29fc0 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 QLITE_OMIT_BUILT
29fd0 49 4e 5f 54 45 53 54 0a 20 20 76 6f 69 64 20 73 IN_TEST. void s
29fe0 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 67 qlite3BeginBenig
29ff0 6e 4d 61 6c 6c 6f 63 28 76 6f 69 64 29 3b 0a 20 nMalloc(void);.
2a000 20 76 6f 69 64 20 73 71 6c 69 74 65 33 45 6e 64 void sqlite3End
2a010 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 76 6f 69 BenignMalloc(voi
2a020 64 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 d);.#else. #def
2a030 69 6e 65 20 73 71 6c 69 74 65 33 42 65 67 69 6e ine sqlite3Begin
2a040 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 0a 20 BenignMalloc().
2a050 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
2a060 45 6e 64 42 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 EndBenignMalloc(
2a070 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
2a080 41 6c 6c 6f 77 65 64 20 72 65 74 75 72 6e 20 76 Allowed return v
2a090 61 6c 75 65 73 20 66 72 6f 6d 20 73 71 6c 69 74 alues from sqlit
2a0a0 65 33 46 69 6e 64 49 6e 49 6e 64 65 78 28 29 0a e3FindInIndex().
2a0b0 2a 2f 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e */.#define IN_IN
2a0c0 44 45 58 5f 52 4f 57 49 44 20 20 20 20 20 20 20 DEX_ROWID
2a0d0 20 31 20 20 20 2f 2a 20 53 65 61 72 63 68 20 74 1 /* Search t
2a0e0 68 65 20 72 6f 77 69 64 20 6f 66 20 74 68 65 20 he rowid of the
2a0f0 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 table */.#define
2a100 20 49 4e 5f 49 4e 44 45 58 5f 45 50 48 20 20 20 IN_INDEX_EPH
2a110 20 20 20 20 20 20 20 32 20 20 20 2f 2a 20 53 65 2 /* Se
2a120 61 72 63 68 20 61 6e 20 65 70 68 65 6d 65 72 61 arch an ephemera
2a130 6c 20 62 2d 74 72 65 65 20 2a 2f 0a 23 64 65 66 l b-tree */.#def
2a140 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 49 4e 44 ine IN_INDEX_IND
2a150 45 58 5f 41 53 43 20 20 20 20 33 20 20 20 2f 2a EX_ASC 3 /*
2a160 20 45 78 69 73 74 69 6e 67 20 69 6e 64 65 78 20 Existing index
2a170 41 53 43 45 4e 44 49 4e 47 20 2a 2f 0a 23 64 65 ASCENDING */.#de
2a180 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 49 4e fine IN_INDEX_IN
2a190 44 45 58 5f 44 45 53 43 20 20 20 34 20 20 20 2f DEX_DESC 4 /
2a1a0 2a 20 45 78 69 73 74 69 6e 67 20 69 6e 64 65 78 * Existing index
2a1b0 20 44 45 53 43 45 4e 44 49 4e 47 20 2a 2f 0a 23 DESCENDING */.#
2a1c0 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f define IN_INDEX_
2a1d0 4e 4f 4f 50 20 20 20 20 20 20 20 20 20 35 20 20 NOOP 5
2a1e0 20 2f 2a 20 4e 6f 20 74 61 62 6c 65 20 61 76 61 /* No table ava
2a1f0 69 6c 61 62 6c 65 2e 20 55 73 65 20 63 6f 6d 70 ilable. Use comp
2a200 61 72 69 73 6f 6e 73 20 2a 2f 0a 2f 2a 0a 2a 2a arisons */./*.**
2a210 20 41 6c 6c 6f 77 65 64 20 66 6c 61 67 73 20 66 Allowed flags f
2a220 6f 72 20 74 68 65 20 33 72 64 20 70 61 72 61 6d or the 3rd param
2a230 65 74 65 72 20 74 6f 20 73 71 6c 69 74 65 33 46 eter to sqlite3F
2a240 69 6e 64 49 6e 49 6e 64 65 78 28 29 2e 0a 2a 2f indInIndex()..*/
2a250 0a 23 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 .#define IN_INDE
2a260 58 5f 4e 4f 4f 50 5f 4f 4b 20 20 20 20 20 30 78 X_NOOP_OK 0x
2a270 30 30 30 31 20 20 2f 2a 20 4f 4b 20 74 6f 20 72 0001 /* OK to r
2a280 65 74 75 72 6e 20 49 4e 5f 49 4e 44 45 58 5f 4e eturn IN_INDEX_N
2a290 4f 4f 50 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 OOP */.#define I
2a2a0 4e 5f 49 4e 44 45 58 5f 4d 45 4d 42 45 52 53 48 N_INDEX_MEMBERSH
2a2b0 49 50 20 20 30 78 30 30 30 32 20 20 2f 2a 20 49 IP 0x0002 /* I
2a2c0 4e 20 6f 70 65 72 61 74 6f 72 20 75 73 65 64 20 N operator used
2a2d0 66 6f 72 20 6d 65 6d 62 65 72 73 68 69 70 20 74 for membership t
2a2e0 65 73 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 49 est */.#define I
2a2f0 4e 5f 49 4e 44 45 58 5f 4c 4f 4f 50 20 20 20 20 N_INDEX_LOOP
2a300 20 20 20 20 30 78 30 30 30 34 20 20 2f 2a 20 49 0x0004 /* I
2a310 4e 20 6f 70 65 72 61 74 6f 72 20 75 73 65 64 20 N operator used
2a320 61 73 20 61 20 6c 6f 6f 70 20 2a 2f 0a 69 6e 74 as a loop */.int
2a330 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 49 6e sqlite3FindInIn
2a340 64 65 78 28 50 61 72 73 65 20 2a 2c 20 45 78 70 dex(Parse *, Exp
2a350 72 20 2a 2c 20 75 33 32 2c 20 69 6e 74 2a 29 3b r *, u32, int*);
2a360 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
2a370 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
2a380 49 54 45 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 ITE. int sqlite
2a390 33 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 3JournalOpen(sql
2a3a0 69 74 65 33 5f 76 66 73 20 2a 2c 20 63 6f 6e 73 ite3_vfs *, cons
2a3b0 74 20 63 68 61 72 20 2a 2c 20 73 71 6c 69 74 65 t char *, sqlite
2a3c0 33 5f 66 69 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 3_file *, int, i
2a3d0 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 nt);. int sqlit
2a3e0 65 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 73 71 e3JournalSize(sq
2a3f0 6c 69 74 65 33 5f 76 66 73 20 2a 29 3b 0a 20 20 lite3_vfs *);.
2a400 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e int sqlite3Journ
2a410 61 6c 43 72 65 61 74 65 28 73 71 6c 69 74 65 33 alCreate(sqlite3
2a420 5f 66 69 6c 65 20 2a 29 3b 0a 20 20 69 6e 74 20 _file *);. int
2a430 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 45 78 sqlite3JournalEx
2a440 69 73 74 73 28 73 71 6c 69 74 65 33 5f 66 69 6c ists(sqlite3_fil
2a450 65 20 2a 70 29 3b 0a 23 65 6c 73 65 0a 20 20 23 e *p);.#else. #
2a460 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4a 6f define sqlite3Jo
2a470 75 72 6e 61 6c 53 69 7a 65 28 70 56 66 73 29 20 urnalSize(pVfs)
2a480 28 28 70 56 66 73 29 2d 3e 73 7a 4f 73 46 69 6c ((pVfs)->szOsFil
2a490 65 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c e). #define sql
2a4a0 69 74 65 33 4a 6f 75 72 6e 61 6c 45 78 69 73 74 ite3JournalExist
2a4b0 73 28 70 29 20 31 0a 23 65 6e 64 69 66 0a 0a 76 s(p) 1.#endif..v
2a4c0 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 4a 6f oid sqlite3MemJo
2a4d0 75 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 69 74 65 urnalOpen(sqlite
2a4e0 33 5f 66 69 6c 65 20 2a 29 3b 0a 69 6e 74 20 73 3_file *);.int s
2a4f0 71 6c 69 74 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c qlite3MemJournal
2a500 53 69 7a 65 28 76 6f 69 64 29 3b 0a 69 6e 74 20 Size(void);.int
2a510 73 71 6c 69 74 65 33 49 73 4d 65 6d 4a 6f 75 72 sqlite3IsMemJour
2a520 6e 61 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 nal(sqlite3_file
2a530 20 2a 29 3b 0a 0a 76 6f 69 64 20 73 71 6c 69 74 *);..void sqlit
2a540 65 33 45 78 70 72 53 65 74 48 65 69 67 68 74 41 e3ExprSetHeightA
2a550 6e 64 46 6c 61 67 73 28 50 61 72 73 65 20 2a 70 ndFlags(Parse *p
2a560 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 29 3b Parse, Expr *p);
2a570 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f .#if SQLITE_MAX_
2a580 45 58 50 52 5f 44 45 50 54 48 3e 30 0a 20 20 69 EXPR_DEPTH>0. i
2a590 6e 74 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 nt sqlite3Select
2a5a0 45 78 70 72 48 65 69 67 68 74 28 53 65 6c 65 63 ExprHeight(Selec
2a5b0 74 20 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 t *);. int sqli
2a5c0 74 65 33 45 78 70 72 43 68 65 63 6b 48 65 69 67 te3ExprCheckHeig
2a5d0 68 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b ht(Parse*, int);
2a5e0 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
2a5f0 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 45 78 sqlite3SelectEx
2a600 70 72 48 65 69 67 68 74 28 78 29 20 30 0a 20 20 prHeight(x) 0.
2a610 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 #define sqlite3E
2a620 78 70 72 43 68 65 63 6b 48 65 69 67 68 74 28 78 xprCheckHeight(x
2a630 2c 79 29 0a 23 65 6e 64 69 66 0a 0a 75 33 32 20 ,y).#endif..u32
2a640 73 71 6c 69 74 65 33 47 65 74 34 62 79 74 65 28 sqlite3Get4byte(
2a650 63 6f 6e 73 74 20 75 38 2a 29 3b 0a 76 6f 69 64 const u8*);.void
2a660 20 73 71 6c 69 74 65 33 50 75 74 34 62 79 74 65 sqlite3Put4byte
2a670 28 75 38 2a 2c 20 75 33 32 29 3b 0a 0a 23 69 66 (u8*, u32);..#if
2a680 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
2a690 45 5f 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 0a E_UNLOCK_NOTIFY.
2a6a0 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f void sqlite3Co
2a6b0 6e 6e 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 nnectionBlocked(
2a6c0 73 71 6c 69 74 65 33 20 2a 2c 20 73 71 6c 69 74 sqlite3 *, sqlit
2a6d0 65 33 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 e3 *);. void sq
2a6e0 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 lite3ConnectionU
2a6f0 6e 6c 6f 63 6b 65 64 28 73 71 6c 69 74 65 33 20 nlocked(sqlite3
2a700 2a 64 62 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c *db);. void sql
2a710 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c ite3ConnectionCl
2a720 6f 73 65 64 28 73 71 6c 69 74 65 33 20 2a 64 62 osed(sqlite3 *db
2a730 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 );.#else. #defi
2a740 6e 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 ne sqlite3Connec
2a750 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 78 2c 79 29 tionBlocked(x,y)
2a760 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
2a770 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c 6f e3ConnectionUnlo
2a780 63 6b 65 64 28 78 29 0a 20 20 23 64 65 66 69 6e cked(x). #defin
2a790 65 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 e sqlite3Connect
2a7a0 69 6f 6e 43 6c 6f 73 65 64 28 78 29 0a 23 65 6e ionClosed(x).#en
2a7b0 64 69 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 dif..#ifdef SQLI
2a7c0 54 45 5f 44 45 42 55 47 0a 20 20 76 6f 69 64 20 TE_DEBUG. void
2a7d0 73 71 6c 69 74 65 33 50 61 72 73 65 72 54 72 61 sqlite3ParserTra
2a7e0 63 65 28 46 49 4c 45 2a 2c 20 63 68 61 72 20 2a ce(FILE*, char *
2a7f0 29 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a );.#endif../*.**
2a800 20 49 66 20 74 68 65 20 53 51 4c 49 54 45 5f 45 If the SQLITE_E
2a810 4e 41 42 4c 45 20 49 4f 54 52 41 43 45 20 65 78 NABLE IOTRACE ex
2a820 69 73 74 73 20 74 68 65 6e 20 74 68 65 20 67 6c ists then the gl
2a830 6f 62 61 6c 20 76 61 72 69 61 62 6c 65 0a 2a 2a obal variable.**
2a840 20 73 71 6c 69 74 65 33 49 6f 54 72 61 63 65 20 sqlite3IoTrace
2a850 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
2a860 61 20 70 72 69 6e 74 66 2d 6c 69 6b 65 20 72 6f a printf-like ro
2a870 75 74 69 6e 65 20 75 73 65 64 20 74 6f 0a 2a 2a utine used to.**
2a880 20 70 72 69 6e 74 20 49 2f 4f 20 74 72 61 63 69 print I/O traci
2a890 6e 67 20 6d 65 73 73 61 67 65 73 2e 0a 2a 2f 0a ng messages..*/.
2a8a0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
2a8b0 41 42 4c 45 5f 49 4f 54 52 41 43 45 0a 23 20 64 ABLE_IOTRACE.# d
2a8c0 65 66 69 6e 65 20 49 4f 54 52 41 43 45 28 41 29 efine IOTRACE(A)
2a8d0 20 20 69 66 28 20 73 71 6c 69 74 65 33 49 6f 54 if( sqlite3IoT
2a8e0 72 61 63 65 20 29 7b 20 73 71 6c 69 74 65 33 49 race ){ sqlite3I
2a8f0 6f 54 72 61 63 65 20 41 3b 20 7d 0a 20 20 76 6f oTrace A; }. vo
2a900 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f id sqlite3VdbeIO
2a910 54 72 61 63 65 53 71 6c 28 56 64 62 65 2a 29 3b TraceSql(Vdbe*);
2a920 0a 53 51 4c 49 54 45 5f 41 50 49 20 53 51 4c 49 .SQLITE_API SQLI
2a930 54 45 5f 45 58 54 45 52 4e 20 76 6f 69 64 20 28 TE_EXTERN void (
2a940 53 51 4c 49 54 45 5f 43 44 45 43 4c 20 2a 73 71 SQLITE_CDECL *sq
2a950 6c 69 74 65 33 49 6f 54 72 61 63 65 29 28 63 6f lite3IoTrace)(co
2a960 6e 73 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a nst char*,...);.
2a970 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 49 #else.# define I
2a980 4f 54 52 41 43 45 28 41 29 0a 23 20 64 65 66 69 OTRACE(A).# defi
2a990 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f ne sqlite3VdbeIO
2a9a0 54 72 61 63 65 53 71 6c 28 58 29 0a 23 65 6e 64 TraceSql(X).#end
2a9b0 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 if../*.** These
2a9c0 72 6f 75 74 69 6e 65 73 20 61 72 65 20 61 76 61 routines are ava
2a9d0 69 6c 61 62 6c 65 20 66 6f 72 20 74 68 65 20 6d ilable for the m
2a9e0 65 6d 32 2e 63 20 64 65 62 75 67 67 69 6e 67 20 em2.c debugging
2a9f0 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 6f 72 memory allocator
2aa00 0a 2a 2a 20 6f 6e 6c 79 2e 20 20 54 68 65 79 20 .** only. They
2aa10 61 72 65 20 75 73 65 64 20 74 6f 20 76 65 72 69 are used to veri
2aa20 66 79 20 74 68 61 74 20 64 69 66 66 65 72 65 6e fy that differen
2aa30 74 20 22 74 79 70 65 73 22 20 6f 66 20 6d 65 6d t "types" of mem
2aa40 6f 72 79 0a 2a 2a 20 61 6c 6c 6f 63 61 74 69 6f ory.** allocatio
2aa50 6e 73 20 61 72 65 20 70 72 6f 70 65 72 6c 79 20 ns are properly
2aa60 74 72 61 63 6b 65 64 20 62 79 20 74 68 65 20 73 tracked by the s
2aa70 79 73 74 65 6d 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c ystem..**.** sql
2aa80 69 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 ite3MemdebugSetT
2aa90 79 70 65 28 29 20 73 65 74 73 20 74 68 65 20 22 ype() sets the "
2aaa0 74 79 70 65 22 20 6f 66 20 61 6e 20 61 6c 6c 6f type" of an allo
2aab0 63 61 74 69 6f 6e 20 74 6f 20 6f 6e 65 20 6f 66 cation to one of
2aac0 0a 2a 2a 20 74 68 65 20 4d 45 4d 54 59 50 45 5f .** the MEMTYPE_
2aad0 2a 20 6d 61 63 72 6f 73 20 64 65 66 69 6e 65 64 * macros defined
2aae0 20 62 65 6c 6f 77 2e 20 20 54 68 65 20 74 79 70 below. The typ
2aaf0 65 20 6d 75 73 74 20 62 65 20 61 20 62 69 74 6d e must be a bitm
2ab00 61 73 6b 20 77 69 74 68 0a 2a 2a 20 61 20 73 69 ask with.** a si
2ab10 6e 67 6c 65 20 62 69 74 20 73 65 74 2e 0a 2a 2a ngle bit set..**
2ab20 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
2ab30 62 75 67 48 61 73 54 79 70 65 28 29 20 72 65 74 bugHasType() ret
2ab40 75 72 6e 73 20 74 72 75 65 20 69 66 20 61 6e 79 urns true if any
2ab50 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 6e 20 of the bits in
2ab60 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 61 72 its second.** ar
2ab70 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 68 65 gument match the
2ab80 20 74 79 70 65 20 73 65 74 20 62 79 20 74 68 65 type set by the
2ab90 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 74 65 previous sqlite
2aba0 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 65 3MemdebugSetType
2abb0 28 29 2e 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 ()..** sqlite3Me
2abc0 6d 64 65 62 75 67 48 61 73 54 79 70 65 28 29 20 mdebugHasType()
2abd0 69 73 20 69 6e 74 65 6e 64 65 64 20 66 6f 72 20 is intended for
2abe0 75 73 65 20 69 6e 73 69 64 65 20 61 73 73 65 72 use inside asser
2abf0 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a t() statements..
2ac00 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d **.** sqlite3Mem
2ac10 64 65 62 75 67 4e 6f 54 79 70 65 28 29 20 72 65 debugNoType() re
2ac20 74 75 72 6e 73 20 74 72 75 65 20 69 66 20 6e 6f turns true if no
2ac30 6e 65 20 6f 66 20 74 68 65 20 62 69 74 73 20 69 ne of the bits i
2ac40 6e 20 69 74 73 20 73 65 63 6f 6e 64 0a 2a 2a 20 n its second.**
2ac50 61 72 67 75 6d 65 6e 74 20 6d 61 74 63 68 20 74 argument match t
2ac60 68 65 20 74 79 70 65 20 73 65 74 20 62 79 20 74 he type set by t
2ac70 68 65 20 70 72 65 76 69 6f 75 73 20 73 71 6c 69 he previous sqli
2ac80 74 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 te3MemdebugSetTy
2ac90 70 65 28 29 2e 0a 2a 2a 0a 2a 2a 20 50 65 72 68 pe()..**.** Perh
2aca0 61 70 73 20 74 68 65 20 6d 6f 73 74 20 69 6d 70 aps the most imp
2acb0 6f 72 74 61 6e 74 20 70 6f 69 6e 74 20 69 73 20 ortant point is
2acc0 74 68 65 20 64 69 66 66 65 72 65 6e 63 65 20 62 the difference b
2acd0 65 74 77 65 65 6e 20 4d 45 4d 54 59 50 45 5f 48 etween MEMTYPE_H
2ace0 45 41 50 0a 2a 2a 20 61 6e 64 20 4d 45 4d 54 59 EAP.** and MEMTY
2acf0 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 2e 20 20 49 PE_LOOKASIDE. I
2ad00 66 20 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 f an allocation
2ad10 69 73 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 is MEMTYPE_LOOKA
2ad20 53 49 44 45 2c 20 74 68 61 74 20 6d 65 61 6e 73 SIDE, that means
2ad30 0a 2a 2a 20 69 74 20 6d 69 67 68 74 20 68 61 76 .** it might hav
2ad40 65 20 62 65 65 6e 20 61 6c 6c 6f 63 61 74 65 64 e been allocated
2ad50 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 2c 20 65 by lookaside, e
2ad60 78 63 65 70 74 20 74 68 65 20 61 6c 6c 6f 63 61 xcept the alloca
2ad70 74 69 6f 6e 20 77 61 73 0a 2a 2a 20 74 6f 6f 20 tion was.** too
2ad80 6c 61 72 67 65 20 6f 72 20 6c 6f 6f 6b 61 73 69 large or lookasi
2ad90 64 65 20 77 61 73 20 61 6c 72 65 61 64 79 20 66 de was already f
2ada0 75 6c 6c 2e 20 20 49 74 20 69 73 20 69 6d 70 6f ull. It is impo
2adb0 72 74 61 6e 74 20 74 6f 20 76 65 72 69 66 79 0a rtant to verify.
2adc0 2a 2a 20 74 68 61 74 20 61 6c 6c 6f 63 61 74 69 ** that allocati
2add0 6f 6e 73 20 74 68 61 74 20 6d 69 67 68 74 20 68 ons that might h
2ade0 61 76 65 20 62 65 65 6e 20 73 61 74 69 73 66 69 ave been satisfi
2adf0 65 64 20 62 79 20 6c 6f 6f 6b 61 73 69 64 65 20 ed by lookaside
2ae00 61 72 65 20 6e 6f 74 0a 2a 2a 20 70 61 73 73 65 are not.** passe
2ae10 64 20 62 61 63 6b 20 74 6f 20 6e 6f 6e 2d 6c 6f d back to non-lo
2ae20 6f 6b 61 73 69 64 65 20 66 72 65 65 28 29 20 72 okaside free() r
2ae30 6f 75 74 69 6e 65 73 2e 20 20 41 73 73 65 72 74 outines. Assert
2ae40 73 20 73 75 63 68 20 61 73 20 74 68 65 0a 2a 2a s such as the.**
2ae50 20 65 78 61 6d 70 6c 65 20 61 62 6f 76 65 20 61 example above a
2ae60 72 65 20 70 6c 61 63 65 64 20 6f 6e 20 74 68 65 re placed on the
2ae70 20 6e 6f 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 non-lookaside f
2ae80 72 65 65 28 29 20 72 6f 75 74 69 6e 65 73 20 74 ree() routines t
2ae90 6f 20 76 65 72 69 66 79 0a 2a 2a 20 74 68 69 73 o verify.** this
2aea0 20 63 6f 6e 73 74 72 61 69 6e 74 2e 0a 2a 2a 0a constraint..**.
2aeb0 2a 2a 20 41 6c 6c 20 6f 66 20 74 68 69 73 20 69 ** All of this i
2aec0 73 20 6e 6f 2d 6f 70 20 66 6f 72 20 61 20 70 72 s no-op for a pr
2aed0 6f 64 75 63 74 69 6f 6e 20 62 75 69 6c 64 2e 20 oduction build.
2aee0 20 49 74 20 6f 6e 6c 79 20 63 6f 6d 65 73 20 69 It only comes i
2aef0 6e 74 6f 0a 2a 2a 20 70 6c 61 79 20 77 68 65 6e nto.** play when
2af00 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 45 4d 44 the SQLITE_MEMD
2af10 45 42 55 47 20 63 6f 6d 70 69 6c 65 2d 74 69 6d EBUG compile-tim
2af20 65 20 6f 70 74 69 6f 6e 20 69 73 20 75 73 65 64 e option is used
2af30 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
2af40 54 45 5f 4d 45 4d 44 45 42 55 47 0a 20 20 76 6f TE_MEMDEBUG. vo
2af50 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 id sqlite3Memdeb
2af60 75 67 53 65 74 54 79 70 65 28 76 6f 69 64 2a 2c ugSetType(void*,
2af70 75 38 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 u8);. int sqlit
2af80 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 e3MemdebugHasTyp
2af90 65 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 69 e(void*,u8);. i
2afa0 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 nt sqlite3Memdeb
2afb0 75 67 4e 6f 54 79 70 65 28 76 6f 69 64 2a 2c 75 ugNoType(void*,u
2afc0 38 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 8);.#else.# defi
2afd0 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 ne sqlite3Memdeb
2afe0 75 67 53 65 74 54 79 70 65 28 58 2c 59 29 20 20 ugSetType(X,Y)
2aff0 2f 2a 20 6e 6f 2d 6f 70 20 2a 2f 0a 23 20 64 65 /* no-op */.# de
2b000 66 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 fine sqlite3Memd
2b010 65 62 75 67 48 61 73 54 79 70 65 28 58 2c 59 29 ebugHasType(X,Y)
2b020 20 20 31 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 1.# define sql
2b030 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 ite3MemdebugNoTy
2b040 70 65 28 58 2c 59 29 20 20 20 31 0a 23 65 6e 64 pe(X,Y) 1.#end
2b050 69 66 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 if.#define MEMTY
2b060 50 45 5f 48 45 41 50 20 20 20 20 20 20 20 30 78 PE_HEAP 0x
2b070 30 31 20 20 2f 2a 20 47 65 6e 65 72 61 6c 20 68 01 /* General h
2b080 65 61 70 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 eap allocations
2b090 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 */.#define MEMTY
2b0a0 50 45 5f 4c 4f 4f 4b 41 53 49 44 45 20 20 30 78 PE_LOOKASIDE 0x
2b0b0 30 32 20 20 2f 2a 20 48 65 61 70 20 74 68 61 74 02 /* Heap that
2b0c0 20 6d 69 67 68 74 20 68 61 76 65 20 62 65 65 6e might have been
2b0d0 20 6c 6f 6f 6b 61 73 69 64 65 20 2a 2f 0a 23 64 lookaside */.#d
2b0e0 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f 53 43 efine MEMTYPE_SC
2b0f0 52 41 54 43 48 20 20 20 20 30 78 30 34 20 20 2f RATCH 0x04 /
2b100 2a 20 53 63 72 61 74 63 68 20 61 6c 6c 6f 63 61 * Scratch alloca
2b110 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 tions */.#define
2b120 20 4d 45 4d 54 59 50 45 5f 50 43 41 43 48 45 20 MEMTYPE_PCACHE
2b130 20 20 20 20 30 78 30 38 20 20 2f 2a 20 50 61 67 0x08 /* Pag
2b140 65 20 63 61 63 68 65 20 61 6c 6c 6f 63 61 74 69 e cache allocati
2b150 6f 6e 73 20 2a 2f 0a 0a 23 69 66 20 28 53 51 4c ons */..#if (SQL
2b160 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 50 4c 45 ITE_ENABLE_APPLE
2b170 5f 53 50 49 3e 30 29 20 26 26 20 64 65 66 69 6e _SPI>0) && defin
2b180 65 64 28 5f 5f 41 50 50 4c 45 5f 5f 29 0a 0a 2f ed(__APPLE__)../
2b190 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
2b1a0 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
2b1b0 67 20 73 74 72 75 63 74 75 72 65 20 69 73 20 75 g structure is u
2b1c0 73 65 64 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 sed to hold the
2b1d0 70 72 6f 63 65 73 73 20 49 44 0a 2a 2a 20 61 6e process ID.** an
2b1e0 64 20 72 65 74 75 72 6e 2d 62 79 2d 72 65 66 65 d return-by-refe
2b1f0 72 65 6e 63 65 20 6c 6f 63 6b 73 74 61 74 65 20 rence lockstate
2b200 76 61 6c 75 65 2e 20 20 54 68 65 20 53 51 4c 49 value. The SQLI
2b210 54 45 5f 46 43 4e 54 4c 5f 4c 4f 43 4b 53 54 41 TE_FCNTL_LOCKSTA
2b220 54 45 5f 50 49 44 0a 2a 2a 20 72 65 71 75 69 72 TE_PID.** requir
2b230 65 73 20 74 68 65 20 34 74 68 20 61 72 67 75 6d es the 4th argum
2b240 65 6e 74 20 74 6f 20 73 71 6c 69 74 65 33 5f 66 ent to sqlite3_f
2b250 69 6c 65 5f 63 6f 6e 74 72 6f 6c 20 74 6f 20 62 ile_control to b
2b260 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 e a pointer to a
2b270 6e 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 n.** instance of
2b280 20 4c 6f 63 6b 73 74 61 74 65 50 49 44 20 69 6e LockstatePID in
2b290 69 74 69 61 6c 69 7a 65 64 20 77 69 74 68 20 61 itialized with a
2b2a0 20 4c 6f 63 6b 73 74 61 74 65 50 49 44 2e 70 69 LockstatePID.pi
2b2b0 64 20 76 61 6c 75 65 20 65 71 75 61 6c 0a 2a 2a d value equal.**
2b2c0 20 74 6f 20 61 20 70 72 6f 63 65 73 73 20 49 44 to a process ID
2b2d0 20 74 6f 20 62 65 20 74 65 73 74 65 64 2c 20 6f to be tested, o
2b2e0 72 20 74 68 65 20 73 70 65 63 69 61 6c 20 76 61 r the special va
2b2f0 6c 75 65 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 53 lue SQLITE_LOCKS
2b300 54 41 54 45 5f 41 4e 59 50 49 44 0a 2a 2a 20 54 TATE_ANYPID.** T
2b310 68 65 20 4c 6f 63 6b 73 74 61 74 65 2e 73 74 61 he Lockstate.sta
2b320 74 65 20 76 61 6c 75 65 20 69 73 20 61 6c 77 61 te value is alwa
2b330 79 73 20 73 65 74 20 74 6f 20 6f 6e 65 20 6f 66 ys set to one of
2b340 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 the following v
2b350 61 6c 75 65 73 0a 2a 2a 20 77 68 65 6e 20 73 71 alues.** when sq
2b360 6c 69 74 65 33 5f 66 69 6c 65 5f 63 6f 6e 74 72 lite3_file_contr
2b370 6f 6c 20 72 65 74 75 72 6e 73 3a 0a 2a 2a 20 0a ol returns:.** .
2b380 2a 2a 20 20 20 53 51 4c 49 54 45 5f 4c 4f 43 4b ** SQLITE_LOCK
2b390 53 54 41 54 45 5f 4f 46 46 20 20 20 20 6e 6f 20 STATE_OFF no
2b3a0 61 63 74 69 76 65 20 73 71 6c 69 74 65 20 66 69 active sqlite fi
2b3b0 6c 65 20 6c 6f 63 6b 73 20 6d 61 74 63 68 20 74 le locks match t
2b3c0 68 65 20 73 70 65 63 69 66 69 65 64 20 70 69 64 he specified pid
2b3d0 0a 2a 2a 20 20 20 53 51 4c 49 54 45 5f 4c 4f 43 .** SQLITE_LOC
2b3e0 4b 53 54 41 54 45 5f 4f 4e 20 20 20 20 20 61 63 KSTATE_ON ac
2b3f0 74 69 76 65 20 73 71 6c 69 74 65 20 66 69 6c 65 tive sqlite file
2b400 20 6c 6f 63 6b 73 20 6d 61 74 63 68 20 74 68 65 locks match the
2b410 20 73 70 65 63 69 66 69 65 64 20 70 69 64 0a 2a specified pid.*
2b420 2a 20 20 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 53 * SQLITE_LOCKS
2b430 54 41 54 45 5f 4e 4f 54 41 44 42 20 70 61 74 68 TATE_NOTADB path
2b440 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 66 69 6c points to a fil
2b450 65 20 74 68 61 74 20 69 73 20 6e 6f 74 20 61 6e e that is not an
2b460 20 73 71 6c 69 74 65 20 64 62 20 66 69 6c 65 0a sqlite db file.
2b470 2a 2a 20 20 20 53 51 4c 49 54 45 5f 4c 4f 43 4b ** SQLITE_LOCK
2b480 53 54 41 54 45 5f 45 52 52 4f 52 20 20 70 61 74 STATE_ERROR pat
2b490 68 20 77 61 73 20 6e 6f 74 20 76 61 69 6c 64 20 h was not vaild
2b4a0 6f 72 20 77 61 73 20 75 6e 72 65 61 64 61 62 6c or was unreadabl
2b4b0 65 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 e.*/.typedef str
2b4c0 75 63 74 20 4c 6f 63 6b 73 74 61 74 65 50 49 44 uct LockstatePID
2b4d0 20 4c 6f 63 6b 73 74 61 74 65 50 49 44 3b 0a 73 LockstatePID;.s
2b4e0 74 72 75 63 74 20 4c 6f 63 6b 73 74 61 74 65 50 truct LockstateP
2b4f0 49 44 20 7b 0a 20 20 70 69 64 5f 74 20 70 69 64 ID {. pid_t pid
2b500 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
2b510 20 20 2f 2a 20 50 72 6f 63 65 73 73 20 49 44 20 /* Process ID
2b520 74 6f 20 74 65 73 74 20 2a 2f 0a 20 20 69 6e 74 to test */. int
2b530 20 73 74 61 74 65 3b 20 20 20 20 20 20 20 20 20 state;
2b540 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 73 /* The s
2b550 74 61 74 65 20 6f 66 20 74 68 65 20 6c 6f 63 6b tate of the lock
2b560 20 28 72 65 74 75 72 6e 20 76 61 6c 75 65 29 20 (return value)
2b570 2a 2f 0a 7d 3b 0a 0a 23 65 6e 64 69 66 20 2f 2a */.};..#endif /*
2b580 20 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f (SQLITE_ENABLE_
2b590 41 50 50 4c 45 5f 53 50 49 3e 30 29 20 26 26 20 APPLE_SPI>0) &&
2b5a0 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 5f defined(__APPLE_
2b5b0 5f 29 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 54 68 72 _) */../*.** Thr
2b5c0 65 61 64 69 6e 67 20 69 6e 74 65 72 66 61 63 65 eading interface
2b5d0 0a 2a 2f 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d .*/.#if SQLITE_M
2b5e0 41 58 5f 57 4f 52 4b 45 52 5f 54 48 52 45 41 44 AX_WORKER_THREAD
2b5f0 53 3e 30 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 S>0.int sqlite3T
2b600 68 72 65 61 64 43 72 65 61 74 65 28 53 51 4c 69 hreadCreate(SQLi
2b610 74 65 54 68 72 65 61 64 2a 2a 2c 76 6f 69 64 2a teThread**,void*
2b620 28 2a 29 28 76 6f 69 64 2a 29 2c 76 6f 69 64 2a (*)(void*),void*
2b630 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 54 68 );.int sqlite3Th
2b640 72 65 61 64 4a 6f 69 6e 28 53 51 4c 69 74 65 54 readJoin(SQLiteT
2b650 68 72 65 61 64 2a 2c 20 76 6f 69 64 2a 2a 29 3b hread*, void**);
2b660 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 64 65 66 .#endif..#if def
2b670 69 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 ined(SQLITE_ENAB
2b680 4c 45 5f 44 42 53 54 41 54 5f 56 54 41 42 29 20 LE_DBSTAT_VTAB)
2b690 7c 7c 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 || defined(SQLIT
2b6a0 45 5f 54 45 53 54 29 0a 69 6e 74 20 73 71 6c 69 E_TEST).int sqli
2b6b0 74 65 33 44 62 73 74 61 74 52 65 67 69 73 74 65 te3DbstatRegiste
2b6c0 72 28 73 71 6c 69 74 65 33 2a 29 3b 0a 23 65 6e r(sqlite3*);.#en
2b6d0 64 69 66 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 5f dif..#endif /* _
2b6e0 53 51 4c 49 54 45 49 4e 54 5f 48 5f 20 2a 2f 0a SQLITEINT_H_ */.