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 54 68 INT_H_../*.** Th
01e0: 65 73 65 20 23 64 65 66 69 6e 65 73 20 73 68 6f ese #defines sho
01f0: 75 6c 64 20 65 6e 61 62 6c 65 20 3e 32 47 42 20 uld enable >2GB
0200: 66 69 6c 65 20 73 75 70 70 6f 72 74 20 6f 6e 20 file support on
0210: 50 4f 53 49 58 20 69 66 20 74 68 65 0a 2a 2a 20 POSIX if the.**
0220: 75 6e 64 65 72 6c 79 69 6e 67 20 6f 70 65 72 61 underlying opera
0230: 74 69 6e 67 20 73 79 73 74 65 6d 20 73 75 70 70 ting system supp
0240: 6f 72 74 73 20 69 74 2e 20 20 49 66 20 74 68 65 orts it. If the
0250: 20 4f 53 20 6c 61 63 6b 73 0a 2a 2a 20 6c 61 72 OS lacks.** lar
0260: 67 65 20 66 69 6c 65 20 73 75 70 70 6f 72 74 2c ge file support,
0270: 20 6f 72 20 69 66 20 74 68 65 20 4f 53 20 69 73 or if the OS is
0280: 20 77 69 6e 64 6f 77 73 2c 20 74 68 65 73 65 20 windows, these
0290: 73 68 6f 75 6c 64 20 62 65 20 6e 6f 2d 6f 70 73 should be no-ops
02a0: 2e 0a 2a 2a 0a 2a 2a 20 54 69 63 6b 65 74 20 23 ..**.** Ticket #
02b0: 32 37 33 39 3a 20 20 54 68 65 20 5f 4c 41 52 47 2739: The _LARG
02c0: 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 6d 61 63 EFILE_SOURCE mac
02d0: 72 6f 20 6d 75 73 74 20 61 70 70 65 61 72 20 62 ro must appear b
02e0: 65 66 6f 72 65 20 61 6e 79 0a 2a 2a 20 73 79 73 efore any.** sys
02f0: 74 65 6d 20 23 69 6e 63 6c 75 64 65 73 2e 20 20 tem #includes.
0300: 48 65 6e 63 65 2c 20 74 68 69 73 20 62 6c 6f 63 Hence, this bloc
0310: 6b 20 6f 66 20 63 6f 64 65 20 6d 75 73 74 20 62 k of code must b
0320: 65 20 74 68 65 20 76 65 72 79 20 66 69 72 73 74 e the very first
0330: 0a 2a 2a 20 63 6f 64 65 20 69 6e 20 61 6c 6c 20 .** code in all
0340: 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 0a 2a 2a source files..**
0350: 0a 2a 2a 20 4c 61 72 67 65 20 66 69 6c 65 20 73 .** Large file s
0360: 75 70 70 6f 72 74 20 63 61 6e 20 62 65 20 64 69 upport can be di
0370: 73 61 62 6c 65 64 20 75 73 69 6e 67 20 74 68 65 sabled using the
0380: 20 2d 44 53 51 4c 49 54 45 5f 44 49 53 41 42 4c -DSQLITE_DISABL
0390: 45 5f 4c 46 53 20 73 77 69 74 63 68 0a 2a 2a 20 E_LFS switch.**
03a0: 6f 6e 20 74 68 65 20 63 6f 6d 70 69 6c 65 72 20 on the compiler
03b0: 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 2e 20 20 54 command line. T
03c0: 68 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 his is necessary
03d0: 20 69 66 20 79 6f 75 20 61 72 65 20 63 6f 6d 70 if you are comp
03e0: 69 6c 69 6e 67 0a 2a 2a 20 6f 6e 20 61 20 72 65 iling.** on a re
03f0: 63 65 6e 74 20 6d 61 63 68 69 6e 65 20 28 65 78 cent machine (ex
0400: 3a 20 52 65 64 20 48 61 74 20 37 2e 32 29 20 62 : Red Hat 7.2) b
0410: 75 74 20 79 6f 75 20 77 61 6e 74 20 79 6f 75 72 ut you want your
0420: 20 63 6f 64 65 20 74 6f 20 77 6f 72 6b 0a 2a 2a code to work.**
0430: 20 6f 6e 20 61 6e 20 6f 6c 64 65 72 20 6d 61 63 on an older mac
0440: 68 69 6e 65 20 28 65 78 3a 20 52 65 64 20 48 61 hine (ex: Red Ha
0450: 74 20 36 2e 30 29 2e 20 20 49 66 20 79 6f 75 20 t 6.0). If you
0460: 63 6f 6d 70 69 6c 65 20 6f 6e 20 52 65 64 20 48 compile on Red H
0470: 61 74 20 37 2e 32 0a 2a 2a 20 77 69 74 68 6f 75 at 7.2.** withou
0480: 74 20 74 68 69 73 20 6f 70 74 69 6f 6e 2c 20 4c t this option, L
0490: 46 53 20 69 73 20 65 6e 61 62 6c 65 2e 20 20 42 FS is enable. B
04a0: 75 74 20 4c 46 53 20 64 6f 65 73 20 6e 6f 74 20 ut LFS does not
04b0: 65 78 69 73 74 20 69 6e 20 74 68 65 20 6b 65 72 exist in the ker
04c0: 6e 65 6c 0a 2a 2a 20 69 6e 20 52 65 64 20 48 61 nel.** in Red Ha
04d0: 74 20 36 2e 30 2c 20 73 6f 20 74 68 65 20 63 6f t 6.0, so the co
04e0: 64 65 20 77 6f 6e 27 74 20 77 6f 72 6b 2e 20 20 de won't work.
04f0: 48 65 6e 63 65 2c 20 66 6f 72 20 6d 61 78 69 6d Hence, for maxim
0500: 75 6d 20 62 69 6e 61 72 79 0a 2a 2a 20 70 6f 72 um binary.** por
0510: 74 61 62 69 6c 69 74 79 20 79 6f 75 20 73 68 6f tability you sho
0520: 75 6c 64 20 6f 6d 69 74 20 4c 46 53 2e 0a 2a 2a uld omit LFS..**
0530: 0a 2a 2a 20 54 68 65 20 70 72 65 76 69 6f 75 73 .** The previous
0540: 20 70 61 72 61 67 72 61 70 68 20 77 61 73 20 77 paragraph was w
0550: 72 69 74 74 65 6e 20 69 6e 20 32 30 30 35 2e 20 ritten in 2005.
0560: 20 28 54 68 69 73 20 70 61 72 61 67 72 61 70 68 (This paragraph
0570: 20 69 73 20 77 72 69 74 74 65 6e 0a 2a 2a 20 6f is written.** o
0580: 6e 20 32 30 30 38 2d 31 31 2d 32 38 2e 29 20 54 n 2008-11-28.) T
0590: 68 65 73 65 20 64 61 79 73 2c 20 61 6c 6c 20 4c hese days, all L
05a0: 69 6e 75 78 20 6b 65 72 6e 65 6c 73 20 73 75 70 inux kernels sup
05b0: 70 6f 72 74 20 6c 61 72 67 65 20 66 69 6c 65 73 port large files
05c0: 2c 20 73 6f 0a 2a 2a 20 79 6f 75 20 73 68 6f 75 , so.** you shou
05d0: 6c 64 20 70 72 6f 62 61 62 6c 79 20 6c 65 61 76 ld probably leav
05e0: 65 20 4c 46 53 20 65 6e 61 62 6c 65 64 2e 20 20 e LFS enabled.
05f0: 42 75 74 20 73 6f 6d 65 20 65 6d 62 65 64 64 65 But some embedde
0600: 64 20 70 6c 61 74 66 6f 72 6d 73 20 6d 69 67 68 d platforms migh
0610: 74 0a 2a 2a 20 6c 61 63 6b 20 4c 46 53 20 69 6e t.** lack LFS in
0620: 20 77 68 69 63 68 20 63 61 73 65 20 74 68 65 20 which case the
0630: 53 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c SQLITE_DISABLE_L
0640: 46 53 20 6d 61 63 72 6f 20 6d 69 67 68 74 20 73 FS macro might s
0650: 74 69 6c 6c 20 62 65 20 75 73 65 66 75 6c 2e 0a till be useful..
0660: 2a 2a 0a 2a 2a 20 53 69 6d 69 6c 61 72 20 69 73 **.** Similar is
0670: 20 74 72 75 65 20 66 6f 72 20 4d 61 63 20 4f 53 true for Mac OS
0680: 20 58 2e 20 20 4c 46 53 20 69 73 20 6f 6e 6c 79 X. LFS is only
0690: 20 73 75 70 70 6f 72 74 65 64 20 6f 6e 20 4d 61 supported on Ma
06a0: 63 20 4f 53 20 58 20 39 20 61 6e 64 20 6c 61 74 c OS X 9 and lat
06b0: 65 72 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 er..*/.#ifndef S
06c0: 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 4c 46 QLITE_DISABLE_LF
06d0: 53 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 S.# define _LARG
06e0: 45 5f 46 49 4c 45 20 20 20 20 20 20 20 31 0a 23 E_FILE 1.#
06f0: 20 69 66 6e 64 65 66 20 5f 46 49 4c 45 5f 4f 46 ifndef _FILE_OF
0700: 46 53 45 54 5f 42 49 54 53 0a 23 20 20 20 64 65 FSET_BITS.# de
0710: 66 69 6e 65 20 5f 46 49 4c 45 5f 4f 46 46 53 45 fine _FILE_OFFSE
0720: 54 5f 42 49 54 53 20 36 34 0a 23 20 65 6e 64 69 T_BITS 64.# endi
0730: 66 0a 23 20 64 65 66 69 6e 65 20 5f 4c 41 52 47 f.# define _LARG
0740: 45 46 49 4c 45 5f 53 4f 55 52 43 45 20 31 0a 23 EFILE_SOURCE 1.#
0750: 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46 6f 72 endif../*.** For
0760: 20 4d 69 6e 47 57 2c 20 63 68 65 63 6b 20 74 6f MinGW, check to
0770: 20 73 65 65 20 69 66 20 77 65 20 63 61 6e 20 69 see if we can i
0780: 6e 63 6c 75 64 65 20 74 68 65 20 68 65 61 64 65 nclude the heade
0790: 72 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 69 6e r file containin
07a0: 67 20 69 74 73 0a 2a 2a 20 76 65 72 73 69 6f 6e g its.** version
07b0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c 20 61 6d information, am
07c0: 6f 6e 67 20 6f 74 68 65 72 20 74 68 69 6e 67 73 ong other things
07d0: 2e 20 20 4e 6f 72 6d 61 6c 6c 79 2c 20 74 68 69 . Normally, thi
07e0: 73 20 69 6e 74 65 72 6e 61 6c 20 4d 69 6e 47 57 s internal MinGW
07f0: 0a 2a 2a 20 68 65 61 64 65 72 20 66 69 6c 65 20 .** header file
0800: 77 6f 75 6c 64 20 5b 6f 6e 6c 79 5d 20 62 65 20 would [only] be
0810: 69 6e 63 6c 75 64 65 64 20 61 75 74 6f 6d 61 74 included automat
0820: 69 63 61 6c 6c 79 20 62 79 20 6f 74 68 65 72 20 ically by other
0830: 4d 69 6e 47 57 20 68 65 61 64 65 72 0a 2a 2a 20 MinGW header.**
0840: 66 69 6c 65 73 3b 20 68 6f 77 65 76 65 72 2c 20 files; however,
0850: 74 68 65 20 63 6f 6e 74 61 69 6e 65 64 20 76 65 the contained ve
0860: 72 73 69 6f 6e 20 69 6e 66 6f 72 6d 61 74 69 6f rsion informatio
0870: 6e 20 69 73 20 6e 6f 77 20 72 65 71 75 69 72 65 n is now require
0880: 64 20 62 79 20 74 68 69 73 0a 2a 2a 20 68 65 61 d by this.** hea
0890: 64 65 72 20 66 69 6c 65 20 74 6f 20 77 6f 72 6b der file to work
08a0: 20 61 72 6f 75 6e 64 20 62 69 6e 61 72 79 20 63 around binary c
08b0: 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 69 73 73 ompatibility iss
08c0: 75 65 73 20 28 73 65 65 20 62 65 6c 6f 77 29 20 ues (see below)
08d0: 61 6e 64 0a 2a 2a 20 74 68 69 73 20 69 73 20 74 and.** this is t
08e0: 68 65 20 6f 6e 6c 79 20 6b 6e 6f 77 6e 20 77 61 he only known wa
08f0: 79 20 74 6f 20 72 65 6c 69 61 62 6c 79 20 6f 62 y to reliably ob
0900: 74 61 69 6e 20 69 74 2e 20 20 54 68 69 73 20 65 tain it. This e
0910: 6e 74 69 72 65 20 23 69 66 20 62 6c 6f 63 6b 0a ntire #if block.
0920: 2a 2a 20 77 6f 75 6c 64 20 62 65 20 63 6f 6d 70 ** would be comp
0930: 6c 65 74 65 6c 79 20 75 6e 6e 65 63 65 73 73 61 letely unnecessa
0940: 72 79 20 69 66 20 74 68 65 72 65 20 77 61 73 20 ry if there was
0950: 61 6e 79 20 6f 74 68 65 72 20 77 61 79 20 6f 66 any other way of
0960: 20 64 65 74 65 63 74 69 6e 67 0a 2a 2a 20 4d 69 detecting.** Mi
0970: 6e 47 57 20 76 69 61 20 74 68 65 69 72 20 70 72 nGW via their pr
0980: 65 70 72 6f 63 65 73 73 6f 72 20 28 65 2e 67 2e eprocessor (e.g.
0990: 20 69 66 20 74 68 65 79 20 63 75 73 74 6f 6d 69 if they customi
09a0: 7a 65 64 20 74 68 65 69 72 20 47 43 43 20 74 6f zed their GCC to
09b0: 20 64 65 66 69 6e 65 0a 2a 2a 20 73 6f 6d 65 20 define.** some
09c0: 4d 69 6e 47 57 2d 73 70 65 63 69 66 69 63 20 6d MinGW-specific m
09d0: 61 63 72 6f 73 29 2e 20 20 57 68 65 6e 20 63 6f acros). When co
09e0: 6d 70 69 6c 69 6e 67 20 66 6f 72 20 4d 69 6e 47 mpiling for MinG
09f0: 57 2c 20 65 69 74 68 65 72 20 74 68 65 0a 2a 2a W, either the.**
0a00: 20 5f 48 41 56 45 5f 4d 49 4e 47 57 5f 48 20 6f _HAVE_MINGW_H o
0a10: 72 20 5f 48 41 56 45 5f 5f 4d 49 4e 47 57 5f 48 r _HAVE__MINGW_H
0a20: 20 28 6e 6f 74 65 20 74 68 65 20 65 78 74 72 61 (note the extra
0a30: 20 75 6e 64 65 72 73 63 6f 72 65 29 20 6d 61 63 underscore) mac
0a40: 72 6f 20 6d 75 73 74 20 62 65 0a 2a 2a 20 64 65 ro must be.** de
0a50: 66 69 6e 65 64 3b 20 6f 74 68 65 72 77 69 73 65 fined; otherwise
0a60: 2c 20 64 65 74 65 63 74 69 6f 6e 20 6f 66 20 63 , detection of c
0a70: 6f 6e 64 69 74 69 6f 6e 73 20 73 70 65 63 69 66 onditions specif
0a80: 69 63 20 74 6f 20 4d 69 6e 47 57 20 77 69 6c 6c ic to MinGW will
0a90: 20 62 65 0a 2a 2a 20 64 69 73 61 62 6c 65 64 2e be.** disabled.
0aa0: 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 .*/.#if defined(
0ab0: 5f 48 41 56 45 5f 4d 49 4e 47 57 5f 48 29 0a 23 _HAVE_MINGW_H).#
0ac0: 20 69 6e 63 6c 75 64 65 20 22 6d 69 6e 67 77 2e include "mingw.
0ad0: 68 22 0a 23 65 6c 69 66 20 64 65 66 69 6e 65 64 h".#elif defined
0ae0: 28 5f 48 41 56 45 5f 5f 4d 49 4e 47 57 5f 48 29 (_HAVE__MINGW_H)
0af0: 0a 23 20 69 6e 63 6c 75 64 65 20 22 5f 6d 69 6e .# include "_min
0b00: 67 77 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a gw.h".#endif../*
0b10: 0a 2a 2a 20 46 6f 72 20 4d 69 6e 47 57 20 76 65 .** For MinGW ve
0b20: 72 73 69 6f 6e 20 34 2e 78 20 28 61 6e 64 20 68 rsion 4.x (and h
0b30: 69 67 68 65 72 29 2c 20 63 68 65 63 6b 20 74 6f igher), check to
0b40: 20 73 65 65 20 69 66 20 74 68 65 20 5f 55 53 45 see if the _USE
0b50: 5f 33 32 42 49 54 5f 54 49 4d 45 5f 54 0a 2a 2a _32BIT_TIME_T.**
0b60: 20 64 65 66 69 6e 65 20 69 73 20 72 65 71 75 69 define is requi
0b70: 72 65 64 20 74 6f 20 6d 61 69 6e 74 61 69 6e 20 red to maintain
0b80: 62 69 6e 61 72 79 20 63 6f 6d 70 61 74 69 62 69 binary compatibi
0b90: 6c 69 74 79 20 77 69 74 68 20 74 68 65 20 4d 53 lity with the MS
0ba0: 56 43 20 72 75 6e 74 69 6d 65 0a 2a 2a 20 6c 69 VC runtime.** li
0bb0: 62 72 61 72 79 20 69 6e 20 75 73 65 20 28 65 2e brary in use (e.
0bc0: 67 2e 20 66 6f 72 20 57 69 6e 64 6f 77 73 20 58 g. for Windows X
0bd0: 50 29 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 P)..*/.#if !defi
0be0: 6e 65 64 28 5f 55 53 45 5f 33 32 42 49 54 5f 54 ned(_USE_32BIT_T
0bf0: 49 4d 45 5f 54 29 20 26 26 20 21 64 65 66 69 6e IME_T) && !defin
0c00: 65 64 28 5f 55 53 45 5f 36 34 42 49 54 5f 54 49 ed(_USE_64BIT_TI
0c10: 4d 45 5f 54 29 20 26 26 20 5c 0a 20 20 20 20 64 ME_T) && \. d
0c20: 65 66 69 6e 65 64 28 5f 57 49 4e 33 32 29 20 26 efined(_WIN32) &
0c30: 26 20 21 64 65 66 69 6e 65 64 28 5f 57 49 4e 36 & !defined(_WIN6
0c40: 34 29 20 26 26 20 5c 0a 20 20 20 20 64 65 66 69 4) && \. defi
0c50: 6e 65 64 28 5f 5f 4d 49 4e 47 57 5f 4d 41 4a 4f ned(__MINGW_MAJO
0c60: 52 5f 56 45 52 53 49 4f 4e 29 20 26 26 20 5f 5f R_VERSION) && __
0c70: 4d 49 4e 47 57 5f 4d 41 4a 4f 52 5f 56 45 52 53 MINGW_MAJOR_VERS
0c80: 49 4f 4e 20 3e 3d 20 34 20 26 26 20 5c 0a 20 20 ION >= 4 && \.
0c90: 20 20 64 65 66 69 6e 65 64 28 5f 5f 4d 53 56 43 defined(__MSVC
0ca0: 52 54 5f 5f 29 0a 23 20 64 65 66 69 6e 65 20 5f RT__).# define _
0cb0: 55 53 45 5f 33 32 42 49 54 5f 54 49 4d 45 5f 54 USE_32BIT_TIME_T
0cc0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 20 54 68 65 20 .#endif../* The
0cd0: 70 75 62 6c 69 63 20 53 51 4c 69 74 65 20 69 6e public SQLite in
0ce0: 74 65 72 66 61 63 65 2e 20 20 54 68 65 20 5f 46 terface. The _F
0cf0: 49 4c 45 5f 4f 46 46 53 45 54 5f 42 49 54 53 20 ILE_OFFSET_BITS
0d00: 6d 61 63 72 6f 20 6d 75 73 74 20 61 70 70 65 61 macro must appea
0d10: 72 0a 2a 2a 20 66 69 72 73 74 20 69 6e 20 51 4e r.** first in QN
0d20: 58 2e 20 20 41 6c 73 6f 2c 20 74 68 65 20 5f 55 X. Also, the _U
0d30: 53 45 5f 33 32 42 49 54 5f 54 49 4d 45 5f 54 20 SE_32BIT_TIME_T
0d40: 6d 61 63 72 6f 20 6d 75 73 74 20 61 70 70 65 61 macro must appea
0d50: 72 20 66 69 72 73 74 20 66 6f 72 0a 2a 2a 20 4d r first for.** M
0d60: 69 6e 47 57 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 inGW..*/.#includ
0d70: 65 20 22 73 71 6c 69 74 65 33 2e 68 22 0a 0a 2f e "sqlite3.h"../
0d80: 2a 0a 2a 2a 20 49 6e 63 6c 75 64 65 20 74 68 65 *.** Include the
0d90: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 68 configuration h
0da0: 65 61 64 65 72 20 6f 75 74 70 75 74 20 62 79 20 eader output by
0db0: 27 63 6f 6e 66 69 67 75 72 65 27 20 69 66 20 77 'configure' if w
0dc0: 65 27 72 65 20 75 73 69 6e 67 20 74 68 65 0a 2a e're using the.*
0dd0: 2a 20 61 75 74 6f 63 6f 6e 66 2d 62 61 73 65 64 * autoconf-based
0de0: 20 62 75 69 6c 64 0a 2a 2f 0a 23 69 66 64 65 66 build.*/.#ifdef
0df0: 20 5f 48 41 56 45 5f 53 51 4c 49 54 45 5f 43 4f _HAVE_SQLITE_CO
0e00: 4e 46 49 47 5f 48 0a 23 69 6e 63 6c 75 64 65 20 NFIG_H.#include
0e10: 22 63 6f 6e 66 69 67 2e 68 22 0a 23 65 6e 64 69 "config.h".#endi
0e20: 66 0a 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c f..#include "sql
0e30: 69 74 65 4c 69 6d 69 74 2e 68 22 0a 0a 2f 2a 20 iteLimit.h"../*
0e40: 44 69 73 61 62 6c 65 20 6e 75 69 73 61 6e 63 65 Disable nuisance
0e50: 20 77 61 72 6e 69 6e 67 73 20 6f 6e 20 42 6f 72 warnings on Bor
0e60: 6c 61 6e 64 20 63 6f 6d 70 69 6c 65 72 73 20 2a land compilers *
0e70: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f /.#if defined(__
0e80: 42 4f 52 4c 41 4e 44 43 5f 5f 29 0a 23 70 72 61 BORLANDC__).#pra
0e90: 67 6d 61 20 77 61 72 6e 20 2d 72 63 68 20 2f 2a gma warn -rch /*
0ea0: 20 75 6e 72 65 61 63 68 61 62 6c 65 20 63 6f 64 unreachable cod
0eb0: 65 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 72 e */.#pragma war
0ec0: 6e 20 2d 63 63 63 20 2f 2a 20 43 6f 6e 64 69 74 n -ccc /* Condit
0ed0: 69 6f 6e 20 69 73 20 61 6c 77 61 79 73 20 74 72 ion is always tr
0ee0: 75 65 20 6f 72 20 66 61 6c 73 65 20 2a 2f 0a 23 ue or false */.#
0ef0: 70 72 61 67 6d 61 20 77 61 72 6e 20 2d 61 75 73 pragma warn -aus
0f00: 20 2f 2a 20 41 73 73 69 67 6e 65 64 20 76 61 6c /* Assigned val
0f10: 75 65 20 69 73 20 6e 65 76 65 72 20 75 73 65 64 ue is never used
0f20: 20 2a 2f 0a 23 70 72 61 67 6d 61 20 77 61 72 6e */.#pragma warn
0f30: 20 2d 63 73 75 20 2f 2a 20 43 6f 6d 70 61 72 69 -csu /* Compari
0f40: 6e 67 20 73 69 67 6e 65 64 20 61 6e 64 20 75 6e ng signed and un
0f50: 73 69 67 6e 65 64 20 2a 2f 0a 23 70 72 61 67 6d signed */.#pragm
0f60: 61 20 77 61 72 6e 20 2d 73 70 61 20 2f 2a 20 53 a warn -spa /* S
0f70: 75 73 70 69 63 69 6f 75 73 20 70 6f 69 6e 74 65 uspicious pointe
0f80: 72 20 61 72 69 74 68 6d 65 74 69 63 20 2a 2f 0a r arithmetic */.
0f90: 23 65 6e 64 69 66 0a 0a 2f 2a 20 4e 65 65 64 65 #endif../* Neede
0fa0: 64 20 66 6f 72 20 76 61 72 69 6f 75 73 20 64 65 d for various de
0fb0: 66 69 6e 69 74 69 6f 6e 73 2e 2e 2e 20 2a 2f 0a finitions... */.
0fc0: 23 69 66 6e 64 65 66 20 5f 47 4e 55 5f 53 4f 55 #ifndef _GNU_SOU
0fd0: 52 43 45 0a 23 20 64 65 66 69 6e 65 20 5f 47 4e RCE.# define _GN
0fe0: 55 5f 53 4f 55 52 43 45 0a 23 65 6e 64 69 66 0a U_SOURCE.#endif.
0ff0: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 4f .#if defined(__O
1000: 70 65 6e 42 53 44 5f 5f 29 20 26 26 20 21 64 65 penBSD__) && !de
1010: 66 69 6e 65 64 28 5f 42 53 44 5f 53 4f 55 52 43 fined(_BSD_SOURC
1020: 45 29 0a 23 20 64 65 66 69 6e 65 20 5f 42 53 44 E).# define _BSD
1030: 5f 53 4f 55 52 43 45 0a 23 65 6e 64 69 66 0a 0a _SOURCE.#endif..
1040: 2f 2a 0a 2a 2a 20 49 6e 63 6c 75 64 65 20 73 74 /*.** Include st
1050: 61 6e 64 61 72 64 20 68 65 61 64 65 72 20 66 69 andard header fi
1060: 6c 65 73 20 61 73 20 6e 65 63 65 73 73 61 72 79 les as necessary
1070: 0a 2a 2f 0a 23 69 66 64 65 66 20 48 41 56 45 5f .*/.#ifdef HAVE_
1080: 53 54 44 49 4e 54 5f 48 0a 23 69 6e 63 6c 75 64 STDINT_H.#includ
1090: 65 20 3c 73 74 64 69 6e 74 2e 68 3e 0a 23 65 6e e <stdint.h>.#en
10a0: 64 69 66 0a 23 69 66 64 65 66 20 48 41 56 45 5f dif.#ifdef HAVE_
10b0: 49 4e 54 54 59 50 45 53 5f 48 0a 23 69 6e 63 6c INTTYPES_H.#incl
10c0: 75 64 65 20 3c 69 6e 74 74 79 70 65 73 2e 68 3e ude <inttypes.h>
10d0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
10e0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 he following mac
10f0: 72 6f 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 ros are used to
1100: 63 61 73 74 20 70 6f 69 6e 74 65 72 73 20 74 6f cast pointers to
1110: 20 69 6e 74 65 67 65 72 73 20 61 6e 64 0a 2a 2a integers and.**
1120: 20 69 6e 74 65 67 65 72 73 20 74 6f 20 70 6f 69 integers to poi
1130: 6e 74 65 72 73 2e 20 20 54 68 65 20 77 61 79 20 nters. The way
1140: 79 6f 75 20 64 6f 20 74 68 69 73 20 76 61 72 69 you do this vari
1150: 65 73 20 66 72 6f 6d 20 6f 6e 65 20 63 6f 6d 70 es from one comp
1160: 69 6c 65 72 0a 2a 2a 20 74 6f 20 74 68 65 20 6e iler.** to the n
1170: 65 78 74 2c 20 73 6f 20 77 65 20 68 61 76 65 20 ext, so we have
1180: 64 65 76 65 6c 6f 70 65 64 20 74 68 65 20 66 6f developed the fo
1190: 6c 6c 6f 77 69 6e 67 20 73 65 74 20 6f 66 20 23 llowing set of #
11a0: 69 66 20 73 74 61 74 65 6d 65 6e 74 73 0a 2a 2a if statements.**
11b0: 20 74 6f 20 67 65 6e 65 72 61 74 65 20 61 70 70 to generate app
11c0: 72 6f 70 72 69 61 74 65 20 6d 61 63 72 6f 73 20 ropriate macros
11d0: 66 6f 72 20 61 20 77 69 64 65 20 72 61 6e 67 65 for a wide range
11e0: 20 6f 66 20 63 6f 6d 70 69 6c 65 72 73 2e 0a 2a of compilers..*
11f0: 2a 0a 2a 2a 20 54 68 65 20 63 6f 72 72 65 63 74 *.** The correct
1200: 20 22 41 4e 53 49 22 20 77 61 79 20 74 6f 20 64 "ANSI" way to d
1210: 6f 20 74 68 69 73 20 69 73 20 74 6f 20 75 73 65 o this is to use
1220: 20 74 68 65 20 69 6e 74 70 74 72 5f 74 20 74 79 the intptr_t ty
1230: 70 65 2e 20 0a 2a 2a 20 55 6e 66 6f 72 74 75 6e pe. .** Unfortun
1240: 61 74 65 6c 79 2c 20 74 68 61 74 20 74 79 70 65 ately, that type
1250: 64 65 66 20 69 73 20 6e 6f 74 20 61 76 61 69 6c def is not avail
1260: 61 62 6c 65 20 6f 6e 20 61 6c 6c 20 63 6f 6d 70 able on all comp
1270: 69 6c 65 72 73 2c 20 6f 72 0a 2a 2a 20 69 66 20 ilers, or.** if
1280: 69 74 20 69 73 20 61 76 61 69 6c 61 62 6c 65 2c it is available,
1290: 20 69 74 20 72 65 71 75 69 72 65 73 20 61 6e 20 it requires an
12a0: 23 69 6e 63 6c 75 64 65 20 6f 66 20 73 70 65 63 #include of spec
12b0: 69 66 69 63 20 68 65 61 64 65 72 73 0a 2a 2a 20 ific headers.**
12c0: 74 68 61 74 20 76 61 72 79 20 66 72 6f 6d 20 6f that vary from o
12d0: 6e 65 20 6d 61 63 68 69 6e 65 20 74 6f 20 74 68 ne machine to th
12e0: 65 20 6e 65 78 74 2e 0a 2a 2a 0a 2a 2a 20 54 69 e next..**.** Ti
12f0: 63 6b 65 74 20 23 33 38 36 30 3a 20 20 54 68 65 cket #3860: The
1300: 20 6c 6c 76 6d 2d 67 63 63 2d 34 2e 32 20 63 6f llvm-gcc-4.2 co
1310: 6d 70 69 6c 65 72 20 66 72 6f 6d 20 41 70 70 6c mpiler from Appl
1320: 65 20 63 68 6f 6b 65 73 20 6f 6e 0a 2a 2a 20 74 e chokes on.** t
1330: 68 65 20 28 28 76 6f 69 64 2a 29 26 28 28 63 68 he ((void*)&((ch
1340: 61 72 2a 29 30 29 5b 58 5d 29 20 63 6f 6e 73 74 ar*)0)[X]) const
1350: 72 75 63 74 2e 20 20 42 75 74 20 4d 53 56 43 20 ruct. But MSVC
1360: 63 68 6f 6b 65 73 20 6f 6e 20 28 28 76 6f 69 64 chokes on ((void
1370: 2a 29 28 58 29 29 2e 0a 2a 2a 20 53 6f 20 77 65 *)(X))..** So we
1380: 20 68 61 76 65 20 74 6f 20 64 65 66 69 6e 65 20 have to define
1390: 74 68 65 20 6d 61 63 72 6f 73 20 69 6e 20 64 69 the macros in di
13a0: 66 66 65 72 65 6e 74 20 77 61 79 73 20 64 65 70 fferent ways dep
13b0: 65 6e 64 69 6e 67 20 6f 6e 20 74 68 65 0a 2a 2a ending on the.**
13c0: 20 63 6f 6d 70 69 6c 65 72 2e 0a 2a 2f 0a 23 69 compiler..*/.#i
13d0: 66 20 64 65 66 69 6e 65 64 28 5f 5f 50 54 52 44 f defined(__PTRD
13e0: 49 46 46 5f 54 59 50 45 5f 5f 29 20 20 2f 2a 20 IFF_TYPE__) /*
13f0: 54 68 69 73 20 63 61 73 65 20 73 68 6f 75 6c 64 This case should
1400: 20 77 6f 72 6b 20 66 6f 72 20 47 43 43 20 2a 2f work for GCC */
1410: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
1420: 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 29 20 20 _INT_TO_PTR(X)
1430: 28 28 76 6f 69 64 2a 29 28 5f 5f 50 54 52 44 49 ((void*)(__PTRDI
1440: 46 46 5f 54 59 50 45 5f 5f 29 28 58 29 29 0a 23 FF_TYPE__)(X)).#
1450: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 define SQLITE_P
1460: 54 52 5f 54 4f 5f 49 4e 54 28 58 29 20 20 28 28 TR_TO_INT(X) ((
1470: 69 6e 74 29 28 5f 5f 50 54 52 44 49 46 46 5f 54 int)(__PTRDIFF_T
1480: 59 50 45 5f 5f 29 28 58 29 29 0a 23 65 6c 69 66 YPE__)(X)).#elif
1490: 20 21 64 65 66 69 6e 65 64 28 5f 5f 47 4e 55 43 !defined(__GNUC
14a0: 5f 5f 29 20 20 20 20 20 20 20 2f 2a 20 57 6f 72 __) /* Wor
14b0: 6b 73 20 66 6f 72 20 63 6f 6d 70 69 6c 65 72 73 ks for compilers
14c0: 20 6f 74 68 65 72 20 74 68 61 6e 20 4c 4c 56 4d other than LLVM
14d0: 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c */.# define SQL
14e0: 49 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 ITE_INT_TO_PTR(X
14f0: 29 20 20 28 28 76 6f 69 64 2a 29 26 28 28 63 68 ) ((void*)&((ch
1500: 61 72 2a 29 30 29 5b 58 5d 29 0a 23 20 64 65 66 ar*)0)[X]).# def
1510: 69 6e 65 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 ine SQLITE_PTR_T
1520: 4f 5f 49 4e 54 28 58 29 20 20 28 28 69 6e 74 29 O_INT(X) ((int)
1530: 28 28 28 63 68 61 72 2a 29 58 29 2d 28 63 68 61 (((char*)X)-(cha
1540: 72 2a 29 30 29 29 0a 23 65 6c 69 66 20 64 65 66 r*)0)).#elif def
1550: 69 6e 65 64 28 48 41 56 45 5f 53 54 44 49 4e 54 ined(HAVE_STDINT
1560: 5f 48 29 20 20 20 2f 2a 20 55 73 65 20 74 68 69 _H) /* Use thi
1570: 73 20 63 61 73 65 20 69 66 20 77 65 20 68 61 76 s case if we hav
1580: 65 20 41 4e 53 49 20 68 65 61 64 65 72 73 20 2a e ANSI headers *
1590: 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 /.# define SQLIT
15a0: 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 58 29 20 E_INT_TO_PTR(X)
15b0: 20 28 28 76 6f 69 64 2a 29 28 69 6e 74 70 74 72 ((void*)(intptr
15c0: 5f 74 29 28 58 29 29 0a 23 20 64 65 66 69 6e 65 _t)(X)).# define
15d0: 20 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 SQLITE_PTR_TO_I
15e0: 4e 54 28 58 29 20 20 28 28 69 6e 74 29 28 69 6e NT(X) ((int)(in
15f0: 74 70 74 72 5f 74 29 28 58 29 29 0a 23 65 6c 73 tptr_t)(X)).#els
1600: 65 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e
1610: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 47 65 /* Ge
1620: 6e 65 72 61 74 65 73 20 61 20 77 61 72 6e 69 6e nerates a warnin
1630: 67 20 2d 20 62 75 74 20 69 74 20 61 6c 77 61 79 g - but it alway
1640: 73 20 77 6f 72 6b 73 20 2a 2f 0a 23 20 64 65 66 s works */.# def
1650: 69 6e 65 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 ine SQLITE_INT_T
1660: 4f 5f 50 54 52 28 58 29 20 20 28 28 76 6f 69 64 O_PTR(X) ((void
1670: 2a 29 28 58 29 29 0a 23 20 64 65 66 69 6e 65 20 *)(X)).# define
1680: 53 51 4c 49 54 45 5f 50 54 52 5f 54 4f 5f 49 4e SQLITE_PTR_TO_IN
1690: 54 28 58 29 20 20 28 28 69 6e 74 29 28 58 29 29 T(X) ((int)(X))
16a0: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 .#endif../*.** T
16b0: 68 65 20 53 51 4c 49 54 45 5f 54 48 52 45 41 44 he SQLITE_THREAD
16c0: 53 41 46 45 20 6d 61 63 72 6f 20 6d 75 73 74 20 SAFE macro must
16d0: 62 65 20 64 65 66 69 6e 65 64 20 61 73 20 30 2c be defined as 0,
16e0: 20 31 2c 20 6f 72 20 32 2e 0a 2a 2a 20 30 20 6d 1, or 2..** 0 m
16f0: 65 61 6e 73 20 6d 75 74 65 78 65 73 20 61 72 65 eans mutexes are
1700: 20 70 65 72 6d 61 6e 65 6e 74 6c 79 20 64 69 73 permanently dis
1710: 61 62 6c 65 20 61 6e 64 20 74 68 65 20 6c 69 62 able and the lib
1720: 72 61 72 79 20 69 73 20 6e 65 76 65 72 0a 2a 2a rary is never.**
1730: 20 74 68 72 65 61 64 73 61 66 65 2e 20 20 31 20 threadsafe. 1
1740: 6d 65 61 6e 73 20 74 68 65 20 6c 69 62 72 61 72 means the librar
1750: 79 20 69 73 20 73 65 72 69 61 6c 69 7a 65 64 20 y is serialized
1760: 77 68 69 63 68 20 69 73 20 74 68 65 20 68 69 67 which is the hig
1770: 68 65 73 74 0a 2a 2a 20 6c 65 76 65 6c 20 6f 66 hest.** level of
1780: 20 74 68 72 65 61 64 73 61 66 65 74 79 2e 20 20 threadsafety.
1790: 32 20 6d 65 61 6e 73 20 74 68 65 20 6c 69 62 72 2 means the libr
17a0: 61 72 79 20 69 73 20 6d 75 6c 74 69 74 68 72 65 ary is multithre
17b0: 61 64 65 64 20 2d 20 6d 75 6c 74 69 70 6c 65 0a aded - multiple.
17c0: 2a 2a 20 74 68 72 65 61 64 73 20 63 61 6e 20 75 ** threads can u
17d0: 73 65 20 53 51 4c 69 74 65 20 61 73 20 6c 6f 6e se SQLite as lon
17e0: 67 20 61 73 20 6e 6f 20 74 77 6f 20 74 68 72 65 g as no two thre
17f0: 61 64 73 20 74 72 79 20 74 6f 20 75 73 65 20 74 ads try to use t
1800: 68 65 20 73 61 6d 65 0a 2a 2a 20 64 61 74 61 62 he same.** datab
1810: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 ase connection a
1820: 74 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 2e t the same time.
1830: 0a 2a 2a 0a 2a 2a 20 4f 6c 64 65 72 20 76 65 72 .**.** Older ver
1840: 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65 20 sions of SQLite
1850: 75 73 65 64 20 61 6e 20 6f 70 74 69 6f 6e 61 6c used an optional
1860: 20 54 48 52 45 41 44 53 41 46 45 20 6d 61 63 72 THREADSAFE macr
1870: 6f 2e 0a 2a 2a 20 57 65 20 73 75 70 70 6f 72 74 o..** We support
1880: 20 74 68 61 74 20 66 6f 72 20 6c 65 67 61 63 79 that for legacy
1890: 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 ..*/.#if !define
18a0: 64 28 53 51 4c 49 54 45 5f 54 48 52 45 41 44 53 d(SQLITE_THREADS
18b0: 41 46 45 29 0a 23 20 69 66 20 64 65 66 69 6e 65 AFE).# if define
18c0: 64 28 54 48 52 45 41 44 53 41 46 45 29 0a 23 20 d(THREADSAFE).#
18d0: 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f define SQLITE_
18e0: 54 48 52 45 41 44 53 41 46 45 20 54 48 52 45 41 THREADSAFE THREA
18f0: 44 53 41 46 45 0a 23 20 65 6c 73 65 0a 23 20 20 DSAFE.# else.#
1900: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 define SQLITE_T
1910: 48 52 45 41 44 53 41 46 45 20 31 20 2f 2a 20 49 HREADSAFE 1 /* I
1920: 4d 50 3a 20 52 2d 30 37 32 37 32 2d 32 32 33 30 MP: R-07272-2230
1930: 39 20 2a 2f 0a 23 20 65 6e 64 69 66 0a 23 65 6e 9 */.# endif.#en
1940: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 6f 77 65 72 dif../*.** Power
1950: 73 61 66 65 20 6f 76 65 72 77 72 69 74 65 20 69 safe overwrite i
1960: 73 20 6f 6e 20 62 79 20 64 65 66 61 75 6c 74 2e s on by default.
1970: 20 20 42 75 74 20 63 61 6e 20 62 65 20 74 75 72 But can be tur
1980: 6e 65 64 20 6f 66 66 20 75 73 69 6e 67 0a 2a 2a ned off using.**
1990: 20 74 68 65 20 2d 44 53 51 4c 49 54 45 5f 50 4f the -DSQLITE_PO
19a0: 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49 54 WERSAFE_OVERWRIT
19b0: 45 3d 30 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 E=0 command-line
19c0: 20 6f 70 74 69 6f 6e 2e 0a 2a 2f 0a 23 69 66 6e option..*/.#ifn
19d0: 64 65 66 20 53 51 4c 49 54 45 5f 50 4f 57 45 52 def SQLITE_POWER
19e0: 53 41 46 45 5f 4f 56 45 52 57 52 49 54 45 0a 23 SAFE_OVERWRITE.#
19f0: 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 50 define SQLITE_P
1a00: 4f 57 45 52 53 41 46 45 5f 4f 56 45 52 57 52 49 OWERSAFE_OVERWRI
1a10: 54 45 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a TE 1.#endif../*.
1a20: 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 44 45 ** The SQLITE_DE
1a30: 46 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 20 FAULT_MEMSTATUS
1a40: 6d 61 63 72 6f 20 6d 75 73 74 20 62 65 20 64 65 macro must be de
1a50: 66 69 6e 65 64 20 61 73 20 65 69 74 68 65 72 20 fined as either
1a60: 30 20 6f 72 20 31 2e 0a 2a 2a 20 49 74 20 64 65 0 or 1..** It de
1a70: 74 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 72 termines whether
1a80: 20 6f 72 20 6e 6f 74 20 74 68 65 20 66 65 61 74 or not the feat
1a90: 75 72 65 73 20 72 65 6c 61 74 65 64 20 74 6f 20 ures related to
1aa0: 0a 2a 2a 20 53 51 4c 49 54 45 5f 43 4f 4e 46 49 .** SQLITE_CONFI
1ab0: 47 5f 4d 45 4d 53 54 41 54 55 53 20 61 72 65 20 G_MEMSTATUS are
1ac0: 61 76 61 69 6c 61 62 6c 65 20 62 79 20 64 65 66 available by def
1ad0: 61 75 6c 74 20 6f 72 20 6e 6f 74 2e 20 54 68 69 ault or not. Thi
1ae0: 73 20 76 61 6c 75 65 20 63 61 6e 0a 2a 2a 20 62 s value can.** b
1af0: 65 20 6f 76 65 72 72 69 64 64 65 6e 20 61 74 20 e overridden at
1b00: 72 75 6e 74 69 6d 65 20 75 73 69 6e 67 20 74 68 runtime using th
1b10: 65 20 73 71 6c 69 74 65 33 5f 63 6f 6e 66 69 67 e sqlite3_config
1b20: 28 29 20 41 50 49 2e 0a 2a 2f 0a 23 69 66 20 21 () API..*/.#if !
1b30: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 defined(SQLITE_D
1b40: 45 46 41 55 4c 54 5f 4d 45 4d 53 54 41 54 55 53 EFAULT_MEMSTATUS
1b50: 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 ).# define SQLIT
1b60: 45 5f 44 45 46 41 55 4c 54 5f 4d 45 4d 53 54 41 E_DEFAULT_MEMSTA
1b70: 54 55 53 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a TUS 1.#endif../*
1b80: 0a 2a 2a 20 45 78 61 63 74 6c 79 20 6f 6e 65 20 .** Exactly one
1b90: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
1ba0: 20 6d 61 63 72 6f 73 20 6d 75 73 74 20 62 65 20 macros must be
1bb0: 64 65 66 69 6e 65 64 20 69 6e 20 6f 72 64 65 72 defined in order
1bc0: 20 74 6f 0a 2a 2a 20 73 70 65 63 69 66 79 20 77 to.** specify w
1bd0: 68 69 63 68 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f hich memory allo
1be0: 63 61 74 69 6f 6e 20 73 75 62 73 79 73 74 65 6d cation subsystem
1bf0: 20 74 6f 20 75 73 65 2e 0a 2a 2a 0a 2a 2a 20 20 to use..**.**
1c00: 20 20 20 53 51 4c 49 54 45 5f 53 59 53 54 45 4d SQLITE_SYSTEM
1c10: 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 20 20 20 20 _MALLOC
1c20: 20 2f 2f 20 55 73 65 20 6e 6f 72 6d 61 6c 20 73 // Use normal s
1c30: 79 73 74 65 6d 20 6d 61 6c 6c 6f 63 28 29 0a 2a ystem malloc().*
1c40: 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 57 49 4e * SQLITE_WIN
1c50: 33 32 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 20 20 32_MALLOC
1c60: 20 20 20 20 2f 2f 20 55 73 65 20 57 69 6e 33 32 // Use Win32
1c70: 20 6e 61 74 69 76 65 20 68 65 61 70 20 41 50 49 native heap API
1c80: 0a 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 5a .** SQLITE_Z
1c90: 45 52 4f 5f 4d 41 4c 4c 4f 43 20 20 20 20 20 20 ERO_MALLOC
1ca0: 20 20 20 20 20 20 2f 2f 20 55 73 65 20 61 20 73 // Use a s
1cb0: 74 75 62 20 61 6c 6c 6f 63 61 74 6f 72 20 74 68 tub allocator th
1cc0: 61 74 20 61 6c 77 61 79 73 20 66 61 69 6c 73 0a at always fails.
1cd0: 2a 2a 20 20 20 20 20 53 51 4c 49 54 45 5f 4d 45 ** SQLITE_ME
1ce0: 4d 44 45 42 55 47 20 20 20 20 20 20 20 20 20 20 MDEBUG
1cf0: 20 20 20 20 20 2f 2f 20 44 65 62 75 67 67 69 6e // Debuggin
1d00: 67 20 76 65 72 73 69 6f 6e 20 6f 66 20 73 79 73 g version of sys
1d10: 74 65 6d 20 6d 61 6c 6c 6f 63 28 29 0a 2a 2a 0a tem malloc().**.
1d20: 2a 2a 20 4f 6e 20 57 69 6e 64 6f 77 73 2c 20 69 ** On Windows, i
1d30: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 57 49 4e f the SQLITE_WIN
1d40: 33 32 5f 4d 41 4c 4c 4f 43 5f 56 41 4c 49 44 41 32_MALLOC_VALIDA
1d50: 54 45 20 6d 61 63 72 6f 20 69 73 20 64 65 66 69 TE macro is defi
1d60: 6e 65 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 61 ned and the.** a
1d70: 73 73 65 72 74 28 29 20 6d 61 63 72 6f 20 69 73 ssert() macro is
1d80: 20 65 6e 61 62 6c 65 64 2c 20 65 61 63 68 20 63 enabled, each c
1d90: 61 6c 6c 20 69 6e 74 6f 20 74 68 65 20 57 69 6e all into the Win
1da0: 33 32 20 6e 61 74 69 76 65 20 68 65 61 70 20 73 32 native heap s
1db0: 75 62 73 79 73 74 65 6d 0a 2a 2a 20 77 69 6c 6c ubsystem.** will
1dc0: 20 63 61 75 73 65 20 48 65 61 70 56 61 6c 69 64 cause HeapValid
1dd0: 61 74 65 20 74 6f 20 62 65 20 63 61 6c 6c 65 64 ate to be called
1de0: 2e 20 20 49 66 20 68 65 61 70 20 76 61 6c 69 64 . If heap valid
1df0: 61 74 69 6f 6e 20 73 68 6f 75 6c 64 20 66 61 69 ation should fai
1e00: 6c 2c 20 61 6e 0a 2a 2a 20 61 73 73 65 72 74 69 l, an.** asserti
1e10: 6f 6e 20 77 69 6c 6c 20 62 65 20 74 72 69 67 67 on will be trigg
1e20: 65 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 6e ered..**.** If n
1e30: 6f 6e 65 20 6f 66 20 74 68 65 20 61 62 6f 76 65 one of the above
1e40: 20 61 72 65 20 64 65 66 69 6e 65 64 2c 20 74 68 are defined, th
1e50: 65 6e 20 73 65 74 20 53 51 4c 49 54 45 5f 53 59 en set SQLITE_SY
1e60: 53 54 45 4d 5f 4d 41 4c 4c 4f 43 20 61 73 0a 2a STEM_MALLOC as.*
1e70: 2a 20 74 68 65 20 64 65 66 61 75 6c 74 2e 0a 2a * the default..*
1e80: 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 /.#if defined(SQ
1e90: 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c LITE_SYSTEM_MALL
1ea0: 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 69 6e 65 OC) \. + define
1eb0: 64 28 53 51 4c 49 54 45 5f 57 49 4e 33 32 5f 4d d(SQLITE_WIN32_M
1ec0: 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 65 66 ALLOC) \. + def
1ed0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 5a 45 52 4f ined(SQLITE_ZERO
1ee0: 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 64 _MALLOC) \. + d
1ef0: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 45 efined(SQLITE_ME
1f00: 4d 44 45 42 55 47 29 3e 31 0a 23 20 65 72 72 6f MDEBUG)>1.# erro
1f10: 72 20 22 54 77 6f 20 6f 72 20 6d 6f 72 65 20 6f r "Two or more o
1f20: 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
1f30: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 63 6f 6e compile-time con
1f40: 66 69 67 75 72 61 74 69 6f 6e 20 6f 70 74 69 6f figuration optio
1f50: 6e 73 5c 0a 20 61 72 65 20 64 65 66 69 6e 65 64 ns\. are defined
1f60: 20 62 75 74 20 61 74 20 6d 6f 73 74 20 6f 6e 65 but at most one
1f70: 20 69 73 20 61 6c 6c 6f 77 65 64 3a 5c 0a 20 53 is allowed:\. S
1f80: 51 4c 49 54 45 5f 53 59 53 54 45 4d 5f 4d 41 4c QLITE_SYSTEM_MAL
1f90: 4c 4f 43 2c 20 53 51 4c 49 54 45 5f 57 49 4e 33 LOC, SQLITE_WIN3
1fa0: 32 5f 4d 41 4c 4c 4f 43 2c 20 53 51 4c 49 54 45 2_MALLOC, SQLITE
1fb0: 5f 4d 45 4d 44 45 42 55 47 2c 5c 0a 20 53 51 4c _MEMDEBUG,\. SQL
1fc0: 49 54 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 22 ITE_ZERO_MALLOC"
1fd0: 0a 23 65 6e 64 69 66 0a 23 69 66 20 64 65 66 69 .#endif.#if defi
1fe0: 6e 65 64 28 53 51 4c 49 54 45 5f 53 59 53 54 45 ned(SQLITE_SYSTE
1ff0: 4d 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 20 2b 20 M_MALLOC) \. +
2000: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 57 defined(SQLITE_W
2010: 49 4e 33 32 5f 4d 41 4c 4c 4f 43 29 20 5c 0a 20 IN32_MALLOC) \.
2020: 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 + defined(SQLIT
2030: 45 5f 5a 45 52 4f 5f 4d 41 4c 4c 4f 43 29 20 5c E_ZERO_MALLOC) \
2040: 0a 20 20 2b 20 64 65 66 69 6e 65 64 28 53 51 4c . + defined(SQL
2050: 49 54 45 5f 4d 45 4d 44 45 42 55 47 29 3d 3d 30 ITE_MEMDEBUG)==0
2060: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
2070: 5f 53 59 53 54 45 4d 5f 4d 41 4c 4c 4f 43 20 31 _SYSTEM_MALLOC 1
2080: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 .#endif../*.** I
2090: 66 20 53 51 4c 49 54 45 5f 4d 41 4c 4c 4f 43 5f f SQLITE_MALLOC_
20a0: 53 4f 46 54 5f 4c 49 4d 49 54 20 69 73 20 6e 6f SOFT_LIMIT is no
20b0: 74 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 72 79 t zero, then try
20c0: 20 74 6f 20 6b 65 65 70 20 74 68 65 0a 2a 2a 20 to keep the.**
20d0: 73 69 7a 65 73 20 6f 66 20 6d 65 6d 6f 72 79 20 sizes of memory
20e0: 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 62 65 6c 6f allocations belo
20f0: 77 20 74 68 69 73 20 76 61 6c 75 65 20 77 68 65 w this value whe
2100: 72 65 20 70 6f 73 73 69 62 6c 65 2e 0a 2a 2f 0a re possible..*/.
2110: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
2120: 49 54 45 5f 4d 41 4c 4c 4f 43 5f 53 4f 46 54 5f ITE_MALLOC_SOFT_
2130: 4c 49 4d 49 54 29 0a 23 20 64 65 66 69 6e 65 20 LIMIT).# define
2140: 53 51 4c 49 54 45 5f 4d 41 4c 4c 4f 43 5f 53 4f SQLITE_MALLOC_SO
2150: 46 54 5f 4c 49 4d 49 54 20 31 30 32 34 0a 23 65 FT_LIMIT 1024.#e
2160: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 65 20 6e ndif../*.** We n
2170: 65 65 64 20 74 6f 20 64 65 66 69 6e 65 20 5f 58 eed to define _X
2180: 4f 50 45 4e 5f 53 4f 55 52 43 45 20 61 73 20 66 OPEN_SOURCE as f
2190: 6f 6c 6c 6f 77 73 20 69 6e 20 6f 72 64 65 72 20 ollows in order
21a0: 74 6f 20 65 6e 61 62 6c 65 0a 2a 2a 20 72 65 63 to enable.** rec
21b0: 75 72 73 69 76 65 20 6d 75 74 65 78 65 73 20 6f ursive mutexes o
21c0: 6e 20 6d 6f 73 74 20 55 6e 69 78 20 73 79 73 74 n most Unix syst
21d0: 65 6d 73 20 61 6e 64 20 66 63 68 6d 6f 64 28 29 ems and fchmod()
21e0: 20 6f 6e 20 4f 70 65 6e 42 53 44 2e 0a 2a 2a 20 on OpenBSD..**
21f0: 42 75 74 20 5f 58 4f 50 45 4e 5f 53 4f 55 52 43 But _XOPEN_SOURC
2200: 45 20 64 65 66 69 6e 65 20 63 61 75 73 65 73 20 E define causes
2210: 70 72 6f 62 6c 65 6d 73 20 66 6f 72 20 4d 61 63 problems for Mac
2220: 20 4f 53 20 58 2c 20 73 6f 20 6f 6d 69 74 0a 2a OS X, so omit.*
2230: 2a 20 69 74 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 * it..*/.#if !de
2240: 66 69 6e 65 64 28 5f 58 4f 50 45 4e 5f 53 4f 55 fined(_XOPEN_SOU
2250: 52 43 45 29 20 26 26 20 21 64 65 66 69 6e 65 64 RCE) && !defined
2260: 28 5f 5f 44 41 52 57 49 4e 5f 5f 29 20 26 26 20 (__DARWIN__) &&
2270: 21 64 65 66 69 6e 65 64 28 5f 5f 41 50 50 4c 45 !defined(__APPLE
2280: 5f 5f 29 0a 23 20 20 64 65 66 69 6e 65 20 5f 58 __).# define _X
2290: 4f 50 45 4e 5f 53 4f 55 52 43 45 20 36 30 30 0a OPEN_SOURCE 600.
22a0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4e 44 #endif../*.** ND
22b0: 45 42 55 47 20 61 6e 64 20 53 51 4c 49 54 45 5f EBUG and SQLITE_
22c0: 44 45 42 55 47 20 61 72 65 20 6f 70 70 6f 73 69 DEBUG are opposi
22d0: 74 65 73 2e 20 20 49 74 20 73 68 6f 75 6c 64 20 tes. It should
22e0: 61 6c 77 61 79 73 20 62 65 20 74 72 75 65 20 74 always be true t
22f0: 68 61 74 0a 2a 2a 20 64 65 66 69 6e 65 64 28 4e hat.** defined(N
2300: 44 45 42 55 47 29 3d 3d 21 64 65 66 69 6e 65 64 DEBUG)==!defined
2310: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 2e 20 (SQLITE_DEBUG).
2320: 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20 If this is not
2330: 63 75 72 72 65 6e 74 6c 79 20 74 72 75 65 2c 0a currently true,.
2340: 2a 2a 20 6d 61 6b 65 20 69 74 20 74 72 75 65 20 ** make it true
2350: 62 79 20 64 65 66 69 6e 69 6e 67 20 6f 72 20 75 by defining or u
2360: 6e 64 65 66 69 6e 69 6e 67 20 4e 44 45 42 55 47 ndefining NDEBUG
2370: 2e 0a 2a 2a 0a 2a 2a 20 53 65 74 74 69 6e 67 20 ..**.** Setting
2380: 4e 44 45 42 55 47 20 6d 61 6b 65 73 20 74 68 65 NDEBUG makes the
2390: 20 63 6f 64 65 20 73 6d 61 6c 6c 65 72 20 61 6e code smaller an
23a0: 64 20 66 61 73 74 65 72 20 62 79 20 64 69 73 61 d faster by disa
23b0: 62 6c 69 6e 67 20 74 68 65 0a 2a 2a 20 61 73 73 bling the.** ass
23c0: 65 72 74 28 29 20 73 74 61 74 65 6d 65 6e 74 73 ert() statements
23d0: 20 69 6e 20 74 68 65 20 63 6f 64 65 2e 20 20 53 in the code. S
23e0: 6f 20 77 65 20 77 61 6e 74 20 74 68 65 20 64 65 o we want the de
23f0: 66 61 75 6c 74 20 61 63 74 69 6f 6e 0a 2a 2a 20 fault action.**
2400: 74 6f 20 62 65 20 66 6f 72 20 4e 44 45 42 55 47 to be for NDEBUG
2410: 20 74 6f 20 62 65 20 73 65 74 20 61 6e 64 20 4e to be set and N
2420: 44 45 42 55 47 20 74 6f 20 62 65 20 75 6e 64 65 DEBUG to be unde
2430: 66 69 6e 65 64 20 6f 6e 6c 79 20 69 66 20 53 51 fined only if SQ
2440: 4c 49 54 45 5f 44 45 42 55 47 0a 2a 2a 20 69 73 LITE_DEBUG.** is
2450: 20 73 65 74 2e 20 20 54 68 75 73 20 4e 44 45 42 set. Thus NDEB
2460: 55 47 20 62 65 63 6f 6d 65 73 20 61 6e 20 6f 70 UG becomes an op
2470: 74 2d 69 6e 20 72 61 74 68 65 72 20 74 68 61 6e t-in rather than
2480: 20 61 6e 20 6f 70 74 2d 6f 75 74 0a 2a 2a 20 66 an opt-out.** f
2490: 65 61 74 75 72 65 2e 0a 2a 2f 0a 23 69 66 20 21 eature..*/.#if !
24a0: 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 20 defined(NDEBUG)
24b0: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 && !defined(SQLI
24c0: 54 45 5f 44 45 42 55 47 29 20 0a 23 20 64 65 66 TE_DEBUG) .# def
24d0: 69 6e 65 20 4e 44 45 42 55 47 20 31 0a 23 65 6e ine NDEBUG 1.#en
24e0: 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 28 dif.#if defined(
24f0: 4e 44 45 42 55 47 29 20 26 26 20 64 65 66 69 6e NDEBUG) && defin
2500: 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 ed(SQLITE_DEBUG)
2510: 0a 23 20 75 6e 64 65 66 20 4e 44 45 42 55 47 0a .# undef NDEBUG.
2520: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 6e #endif../*.** En
2530: 61 62 6c 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 able SQLITE_ENAB
2540: 4c 45 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 LE_EXPLAIN_COMME
2550: 4e 54 53 20 69 66 20 53 51 4c 49 54 45 5f 44 45 NTS if SQLITE_DE
2560: 42 55 47 20 69 73 20 74 75 72 6e 65 64 20 6f 6e BUG is turned on
2570: 2e 0a 2a 2f 0a 23 69 66 20 21 64 65 66 69 6e 65 ..*/.#if !define
2580: 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f d(SQLITE_ENABLE_
2590: 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e 54 53 EXPLAIN_COMMENTS
25a0: 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c ) && defined(SQL
25b0: 49 54 45 5f 44 45 42 55 47 29 0a 23 20 64 65 66 ITE_DEBUG).# def
25c0: 69 6e 65 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c ine SQLITE_ENABL
25d0: 45 5f 45 58 50 4c 41 49 4e 5f 43 4f 4d 4d 45 4e E_EXPLAIN_COMMEN
25e0: 54 53 20 31 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a TS 1.#endif../*.
25f0: 2a 2a 20 54 68 65 20 74 65 73 74 63 61 73 65 28 ** The testcase(
2600: 29 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 20 ) macro is used
2610: 74 6f 20 61 69 64 20 69 6e 20 63 6f 76 65 72 61 to aid in covera
2620: 67 65 20 74 65 73 74 69 6e 67 2e 20 20 57 68 65 ge testing. Whe
2630: 6e 20 0a 2a 2a 20 64 6f 69 6e 67 20 63 6f 76 65 n .** doing cove
2640: 72 61 67 65 20 74 65 73 74 69 6e 67 2c 20 74 68 rage testing, th
2650: 65 20 63 6f 6e 64 69 74 69 6f 6e 20 69 6e 73 69 e condition insi
2660: 64 65 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 de the argument
2670: 74 6f 0a 2a 2a 20 74 65 73 74 63 61 73 65 28 29 to.** testcase()
2680: 20 6d 75 73 74 20 62 65 20 65 76 61 6c 75 61 74 must be evaluat
2690: 65 64 20 62 6f 74 68 20 74 72 75 65 20 61 6e 64 ed both true and
26a0: 20 66 61 6c 73 65 20 69 6e 20 6f 72 64 65 72 20 false in order
26b0: 74 6f 0a 2a 2a 20 67 65 74 20 66 75 6c 6c 20 62 to.** get full b
26c0: 72 61 6e 63 68 20 63 6f 76 65 72 61 67 65 2e 20 ranch coverage.
26d0: 20 54 68 65 20 74 65 73 74 63 61 73 65 28 29 20 The testcase()
26e0: 6d 61 63 72 6f 20 69 73 20 69 6e 73 65 72 74 65 macro is inserte
26f0: 64 0a 2a 2a 20 74 6f 20 68 65 6c 70 20 65 6e 73 d.** to help ens
2700: 75 72 65 20 61 64 65 71 75 61 74 65 20 74 65 73 ure adequate tes
2710: 74 20 63 6f 76 65 72 61 67 65 20 69 6e 20 70 6c t coverage in pl
2720: 61 63 65 73 20 77 68 65 72 65 20 73 69 6d 70 6c aces where simpl
2730: 65 0a 2a 2a 20 63 6f 6e 64 69 74 69 6f 6e 2f 64 e.** condition/d
2740: 65 63 69 73 69 6f 6e 20 63 6f 76 65 72 61 67 65 ecision coverage
2750: 20 69 73 20 69 6e 61 64 65 71 75 61 74 65 2e 20 is inadequate.
2760: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 65 For example, te
2770: 73 74 63 61 73 65 28 29 0a 2a 2a 20 63 61 6e 20 stcase().** can
2780: 62 65 20 75 73 65 64 20 74 6f 20 6d 61 6b 65 20 be used to make
2790: 73 75 72 65 20 62 6f 75 6e 64 61 72 79 20 76 61 sure boundary va
27a0: 6c 75 65 73 20 61 72 65 20 74 65 73 74 65 64 2e lues are tested.
27b0: 20 20 46 6f 72 0a 2a 2a 20 62 69 74 6d 61 73 6b For.** bitmask
27c0: 20 74 65 73 74 73 2c 20 74 65 73 74 63 61 73 65 tests, testcase
27d0: 28 29 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 () can be used t
27e0: 6f 20 6d 61 6b 65 20 73 75 72 65 20 65 61 63 68 o make sure each
27f0: 20 62 69 74 0a 2a 2a 20 69 73 20 73 69 67 6e 69 bit.** is signi
2800: 66 69 63 61 6e 74 20 61 6e 64 20 75 73 65 64 20 ficant and used
2810: 61 74 20 6c 65 61 73 74 20 6f 6e 63 65 2e 20 20 at least once.
2820: 4f 6e 20 73 77 69 74 63 68 20 73 74 61 74 65 6d On switch statem
2830: 65 6e 74 73 0a 2a 2a 20 77 68 65 72 65 20 6d 75 ents.** where mu
2840: 6c 74 69 70 6c 65 20 63 61 73 65 73 20 67 6f 20 ltiple cases go
2850: 74 6f 20 74 68 65 20 73 61 6d 65 20 62 6c 6f 63 to the same bloc
2860: 6b 20 6f 66 20 63 6f 64 65 2c 20 74 65 73 74 63 k of code, testc
2870: 61 73 65 28 29 0a 2a 2a 20 63 61 6e 20 69 6e 73 ase().** can ins
2880: 75 72 65 20 74 68 61 74 20 61 6c 6c 20 63 61 73 ure that all cas
2890: 65 73 20 61 72 65 20 65 76 61 6c 75 61 74 65 64 es are evaluated
28a0: 2e 0a 2a 2a 0a 2a 2f 0a 23 69 66 64 65 66 20 53 ..**.*/.#ifdef S
28b0: 51 4c 49 54 45 5f 43 4f 56 45 52 41 47 45 5f 54 QLITE_COVERAGE_T
28c0: 45 53 54 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 EST. void sqlit
28d0: 65 33 43 6f 76 65 72 61 67 65 28 69 6e 74 29 3b e3Coverage(int);
28e0: 0a 23 20 64 65 66 69 6e 65 20 74 65 73 74 63 61 .# define testca
28f0: 73 65 28 58 29 20 20 69 66 28 20 58 20 29 7b 20 se(X) if( X ){
2900: 73 71 6c 69 74 65 33 43 6f 76 65 72 61 67 65 28 sqlite3Coverage(
2910: 5f 5f 4c 49 4e 45 5f 5f 29 3b 20 7d 0a 23 65 6c __LINE__); }.#el
2920: 73 65 0a 23 20 64 65 66 69 6e 65 20 74 65 73 74 se.# define test
2930: 63 61 73 65 28 58 29 0a 23 65 6e 64 69 66 0a 0a case(X).#endif..
2940: 2f 2a 0a 2a 2a 20 54 68 65 20 54 45 53 54 4f 4e /*.** The TESTON
2950: 4c 59 20 6d 61 63 72 6f 20 69 73 20 75 73 65 64 LY macro is used
2960: 20 74 6f 20 65 6e 63 6c 6f 73 65 20 76 61 72 69 to enclose vari
2970: 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f 6e able declaration
2980: 73 20 6f 72 0a 2a 2a 20 6f 74 68 65 72 20 62 69 s or.** other bi
2990: 74 73 20 6f 66 20 63 6f 64 65 20 74 68 61 74 20 ts of code that
29a0: 61 72 65 20 6e 65 65 64 65 64 20 74 6f 20 73 75 are needed to su
29b0: 70 70 6f 72 74 20 74 68 65 20 61 72 67 75 6d 65 pport the argume
29c0: 6e 74 73 0a 2a 2a 20 77 69 74 68 69 6e 20 74 65 nts.** within te
29d0: 73 74 63 61 73 65 28 29 20 61 6e 64 20 61 73 73 stcase() and ass
29e0: 65 72 74 28 29 20 6d 61 63 72 6f 73 2e 0a 2a 2f ert() macros..*/
29f0: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 4e 44 .#if !defined(ND
2a00: 45 42 55 47 29 20 7c 7c 20 64 65 66 69 6e 65 64 EBUG) || defined
2a10: 28 53 51 4c 49 54 45 5f 43 4f 56 45 52 41 47 45 (SQLITE_COVERAGE
2a20: 5f 54 45 53 54 29 0a 23 20 64 65 66 69 6e 65 20 _TEST).# define
2a30: 54 45 53 54 4f 4e 4c 59 28 58 29 20 20 58 0a 23 TESTONLY(X) X.#
2a40: 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 54 45 else.# define TE
2a50: 53 54 4f 4e 4c 59 28 58 29 0a 23 65 6e 64 69 66 STONLY(X).#endif
2a60: 0a 0a 2f 2a 0a 2a 2a 20 53 6f 6d 65 74 69 6d 65 ../*.** Sometime
2a70: 73 20 77 65 20 6e 65 65 64 20 61 20 73 6d 61 6c s we need a smal
2a80: 6c 20 61 6d 6f 75 6e 74 20 6f 66 20 63 6f 64 65 l amount of code
2a90: 20 73 75 63 68 20 61 73 20 61 20 76 61 72 69 61 such as a varia
2aa0: 62 6c 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 ble initializati
2ab0: 6f 6e 0a 2a 2a 20 74 6f 20 73 65 74 75 70 20 66 on.** to setup f
2ac0: 6f 72 20 61 20 6c 61 74 65 72 20 61 73 73 65 72 or a later asser
2ad0: 74 28 29 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 t() statement.
2ae0: 57 65 20 64 6f 20 6e 6f 74 20 77 61 6e 74 20 74 We do not want t
2af0: 68 69 73 20 63 6f 64 65 20 74 6f 0a 2a 2a 20 61 his code to.** a
2b00: 70 70 65 61 72 20 77 68 65 6e 20 61 73 73 65 72 ppear when asser
2b10: 74 28 29 20 69 73 20 64 69 73 61 62 6c 65 64 2e t() is disabled.
2b20: 20 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 The following
2b30: 6d 61 63 72 6f 20 69 73 20 74 68 65 72 65 66 6f macro is therefo
2b40: 72 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 63 6f re.** used to co
2b50: 6e 74 61 69 6e 20 74 68 61 74 20 73 65 74 75 70 ntain that setup
2b60: 20 63 6f 64 65 2e 20 20 54 68 65 20 22 56 56 41 code. The "VVA
2b70: 22 20 61 63 72 6f 6e 79 6d 20 73 74 61 6e 64 73 " acronym stands
2b80: 20 66 6f 72 0a 2a 2a 20 22 56 65 72 69 66 69 63 for.** "Verific
2b90: 61 74 69 6f 6e 2c 20 56 61 6c 69 64 61 74 69 6f ation, Validatio
2ba0: 6e 2c 20 61 6e 64 20 41 63 63 72 65 64 69 74 61 n, and Accredita
2bb0: 74 69 6f 6e 22 2e 20 20 49 6e 20 6f 74 68 65 72 tion". In other
2bc0: 20 77 6f 72 64 73 2c 20 74 68 65 0a 2a 2a 20 63 words, the.** c
2bd0: 6f 64 65 20 77 69 74 68 69 6e 20 56 56 41 5f 4f ode within VVA_O
2be0: 4e 4c 59 28 29 20 77 69 6c 6c 20 6f 6e 6c 79 20 NLY() will only
2bf0: 72 75 6e 20 64 75 72 69 6e 67 20 76 65 72 69 66 run during verif
2c00: 69 63 61 74 69 6f 6e 20 70 72 6f 63 65 73 73 65 ication processe
2c10: 73 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 s..*/.#ifndef ND
2c20: 45 42 55 47 0a 23 20 64 65 66 69 6e 65 20 56 56 EBUG.# define VV
2c30: 41 5f 4f 4e 4c 59 28 58 29 20 20 58 0a 23 65 6c A_ONLY(X) X.#el
2c40: 73 65 0a 23 20 64 65 66 69 6e 65 20 56 56 41 5f se.# define VVA_
2c50: 4f 4e 4c 59 28 58 29 0a 23 65 6e 64 69 66 0a 0a ONLY(X).#endif..
2c60: 2f 2a 0a 2a 2a 20 54 68 65 20 41 4c 57 41 59 53 /*.** The ALWAYS
2c70: 20 61 6e 64 20 4e 45 56 45 52 20 6d 61 63 72 6f and NEVER macro
2c80: 73 20 73 75 72 72 6f 75 6e 64 20 62 6f 6f 6c 65 s surround boole
2c90: 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 73 20 77 an expressions w
2ca0: 68 69 63 68 20 0a 2a 2a 20 61 72 65 20 69 6e 74 hich .** are int
2cb0: 65 6e 64 65 64 20 74 6f 20 61 6c 77 61 79 73 20 ended to always
2cc0: 62 65 20 74 72 75 65 20 6f 72 20 66 61 6c 73 65 be true or false
2cd0: 2c 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e 20 , respectively.
2ce0: 20 53 75 63 68 0a 2a 2a 20 65 78 70 72 65 73 73 Such.** express
2cf0: 69 6f 6e 73 20 63 6f 75 6c 64 20 62 65 20 6f 6d ions could be om
2d00: 69 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 63 itted from the c
2d10: 6f 64 65 20 63 6f 6d 70 6c 65 74 65 6c 79 2e 20 ode completely.
2d20: 20 42 75 74 20 74 68 65 79 0a 2a 2a 20 61 72 65 But they.** are
2d30: 20 69 6e 63 6c 75 64 65 64 20 69 6e 20 61 20 66 included in a f
2d40: 65 77 20 63 61 73 65 73 20 69 6e 20 6f 72 64 65 ew cases in orde
2d50: 72 20 74 6f 20 65 6e 68 61 6e 63 65 20 74 68 65 r to enhance the
2d60: 20 72 65 73 69 6c 69 65 6e 63 65 0a 2a 2a 20 6f resilience.** o
2d70: 66 20 53 51 4c 69 74 65 20 74 6f 20 75 6e 65 78 f SQLite to unex
2d80: 70 65 63 74 65 64 20 62 65 68 61 76 69 6f 72 20 pected behavior
2d90: 2d 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 63 6f - to make the co
2da0: 64 65 20 22 73 65 6c 66 2d 68 65 61 6c 69 6e 67 de "self-healing
2db0: 22 0a 2a 2a 20 6f 72 20 22 64 75 63 74 69 6c 65 ".** or "ductile
2dc0: 22 20 72 61 74 68 65 72 20 74 68 61 6e 20 62 65 " rather than be
2dd0: 69 6e 67 20 22 62 72 69 74 74 6c 65 22 20 61 6e ing "brittle" an
2de0: 64 20 63 72 61 73 68 69 6e 67 20 61 74 20 74 68 d crashing at th
2df0: 65 20 66 69 72 73 74 0a 2a 2a 20 68 69 6e 74 20 e first.** hint
2e00: 6f 66 20 75 6e 70 6c 61 6e 6e 65 64 20 62 65 68 of unplanned beh
2e10: 61 76 69 6f 72 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 avior..**.** In
2e20: 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 41 4c 57 other words, ALW
2e30: 41 59 53 20 61 6e 64 20 4e 45 56 45 52 20 61 72 AYS and NEVER ar
2e40: 65 20 61 64 64 65 64 20 66 6f 72 20 64 65 66 65 e added for defe
2e50: 6e 73 69 76 65 20 63 6f 64 65 2e 0a 2a 2a 0a 2a nsive code..**.*
2e60: 2a 20 57 68 65 6e 20 64 6f 69 6e 67 20 63 6f 76 * When doing cov
2e70: 65 72 61 67 65 20 74 65 73 74 69 6e 67 20 41 4c erage testing AL
2e80: 57 41 59 53 20 61 6e 64 20 4e 45 56 45 52 20 61 WAYS and NEVER a
2e90: 72 65 20 68 61 72 64 2d 63 6f 64 65 64 20 74 6f re hard-coded to
2ea0: 0a 2a 2a 20 62 65 20 74 72 75 65 20 61 6e 64 20 .** be true and
2eb0: 66 61 6c 73 65 20 73 6f 20 74 68 61 74 20 74 68 false so that th
2ec0: 65 20 75 6e 72 65 61 63 68 61 62 6c 65 20 63 6f e unreachable co
2ed0: 64 65 20 74 68 65 79 20 73 70 65 63 69 66 79 20 de they specify
2ee0: 77 69 6c 6c 0a 2a 2a 20 6e 6f 74 20 62 65 20 63 will.** not be c
2ef0: 6f 75 6e 74 65 64 20 61 73 20 75 6e 74 65 73 74 ounted as untest
2f00: 65 64 20 63 6f 64 65 2e 0a 2a 2f 0a 23 69 66 20 ed code..*/.#if
2f10: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 43 defined(SQLITE_C
2f20: 4f 56 45 52 41 47 45 5f 54 45 53 54 29 0a 23 20 OVERAGE_TEST).#
2f30: 64 65 66 69 6e 65 20 41 4c 57 41 59 53 28 58 29 define ALWAYS(X)
2f40: 20 20 20 20 20 20 28 31 29 0a 23 20 64 65 66 69 (1).# defi
2f50: 6e 65 20 4e 45 56 45 52 28 58 29 20 20 20 20 20 ne NEVER(X)
2f60: 20 20 28 30 29 0a 23 65 6c 69 66 20 21 64 65 66 (0).#elif !def
2f70: 69 6e 65 64 28 4e 44 45 42 55 47 29 0a 23 20 64 ined(NDEBUG).# d
2f80: 65 66 69 6e 65 20 41 4c 57 41 59 53 28 58 29 20 efine ALWAYS(X)
2f90: 20 20 20 20 20 28 28 58 29 3f 31 3a 28 61 73 73 ((X)?1:(ass
2fa0: 65 72 74 28 30 29 2c 30 29 29 0a 23 20 64 65 66 ert(0),0)).# def
2fb0: 69 6e 65 20 4e 45 56 45 52 28 58 29 20 20 20 20 ine NEVER(X)
2fc0: 20 20 20 28 28 58 29 3f 28 61 73 73 65 72 74 28 ((X)?(assert(
2fd0: 30 29 2c 31 29 3a 30 29 0a 23 65 6c 73 65 0a 23 0),1):0).#else.#
2fe0: 20 64 65 66 69 6e 65 20 41 4c 57 41 59 53 28 58 define ALWAYS(X
2ff0: 29 20 20 20 20 20 20 28 58 29 0a 23 20 64 65 66 ) (X).# def
3000: 69 6e 65 20 4e 45 56 45 52 28 58 29 20 20 20 20 ine NEVER(X)
3010: 20 20 20 28 58 29 0a 23 65 6e 64 69 66 0a 0a 2f (X).#endif../
3020: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72 75 65 *.** Return true
3030: 20 28 6e 6f 6e 2d 7a 65 72 6f 29 20 69 66 20 74 (non-zero) if t
3040: 68 65 20 69 6e 70 75 74 20 69 73 20 61 20 69 6e he input is a in
3050: 74 65 67 65 72 20 74 68 61 74 20 69 73 20 74 6f teger that is to
3060: 6f 20 6c 61 72 67 65 0a 2a 2a 20 74 6f 20 66 69 o large.** to fi
3070: 74 20 69 6e 20 33 32 2d 62 69 74 73 2e 20 20 54 t in 32-bits. T
3080: 68 69 73 20 6d 61 63 72 6f 20 69 73 20 75 73 65 his macro is use
3090: 64 20 69 6e 73 69 64 65 20 6f 66 20 76 61 72 69 d inside of vari
30a0: 6f 75 73 20 74 65 73 74 63 61 73 65 28 29 0a 2a ous testcase().*
30b0: 2a 20 6d 61 63 72 6f 73 20 74 6f 20 76 65 72 69 * macros to veri
30c0: 66 79 20 74 68 61 74 20 77 65 20 68 61 76 65 20 fy that we have
30d0: 74 65 73 74 65 64 20 53 51 4c 69 74 65 20 66 6f tested SQLite fo
30e0: 72 20 6c 61 72 67 65 2d 66 69 6c 65 20 73 75 70 r large-file sup
30f0: 70 6f 72 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 port..*/.#define
3100: 20 49 53 5f 42 49 47 5f 49 4e 54 28 58 29 20 20 IS_BIG_INT(X)
3110: 28 28 28 58 29 26 7e 28 69 36 34 29 30 78 66 66 (((X)&~(i64)0xff
3120: 66 66 66 66 66 66 29 21 3d 30 29 0a 0a 2f 2a 0a ffffff)!=0)../*.
3130: 2a 2a 20 54 68 65 20 6d 61 63 72 6f 20 75 6e 6c ** The macro unl
3140: 69 6b 65 6c 79 28 29 20 69 73 20 61 20 68 69 6e ikely() is a hin
3150: 74 20 74 68 61 74 20 73 75 72 72 6f 75 6e 64 73 t that surrounds
3160: 20 61 20 62 6f 6f 6c 65 61 6e 0a 2a 2a 20 65 78 a boolean.** ex
3170: 70 72 65 73 73 69 6f 6e 20 74 68 61 74 20 69 73 pression that is
3180: 20 75 73 75 61 6c 6c 79 20 66 61 6c 73 65 2e 20 usually false.
3190: 20 4d 61 63 72 6f 20 6c 69 6b 65 6c 79 28 29 20 Macro likely()
31a0: 73 75 72 72 6f 75 6e 64 73 0a 2a 2a 20 61 20 62 surrounds.** a b
31b0: 6f 6f 6c 65 61 6e 20 65 78 70 72 65 73 73 69 6f oolean expressio
31c0: 6e 20 74 68 61 74 20 69 73 20 75 73 75 61 6c 6c n that is usuall
31d0: 79 20 74 72 75 65 2e 20 20 54 68 65 73 65 20 68 y true. These h
31e0: 69 6e 74 73 20 63 6f 75 6c 64 2c 0a 2a 2a 20 69 ints could,.** i
31f0: 6e 20 74 68 65 6f 72 79 2c 20 62 65 20 75 73 65 n theory, be use
3200: 64 20 62 79 20 74 68 65 20 63 6f 6d 70 69 6c 65 d by the compile
3210: 72 20 74 6f 20 67 65 6e 65 72 61 74 65 20 62 65 r to generate be
3220: 74 74 65 72 20 63 6f 64 65 2c 20 62 75 74 0a 2a tter code, but.*
3230: 2a 20 63 75 72 72 65 6e 74 6c 79 20 74 68 65 79 * currently they
3240: 20 61 72 65 20 6a 75 73 74 20 63 6f 6d 6d 65 6e are just commen
3250: 74 73 20 66 6f 72 20 68 75 6d 61 6e 20 72 65 61 ts for human rea
3260: 64 65 72 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 ders..*/.#define
3270: 20 6c 69 6b 65 6c 79 28 58 29 20 20 20 20 28 58 likely(X) (X
3280: 29 0a 23 64 65 66 69 6e 65 20 75 6e 6c 69 6b 65 ).#define unlike
3290: 6c 79 28 58 29 20 20 28 58 29 0a 0a 23 69 6e 63 ly(X) (X)..#inc
32a0: 6c 75 64 65 20 22 68 61 73 68 2e 68 22 0a 23 69 lude "hash.h".#i
32b0: 6e 63 6c 75 64 65 20 22 70 61 72 73 65 2e 68 22 nclude "parse.h"
32c0: 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 69 6f .#include <stdio
32d0: 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 20 3c 73 74 .h>.#include <st
32e0: 64 6c 69 62 2e 68 3e 0a 23 69 6e 63 6c 75 64 65 dlib.h>.#include
32f0: 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 23 69 6e 63 <string.h>.#inc
3300: 6c 75 64 65 20 3c 61 73 73 65 72 74 2e 68 3e 0a lude <assert.h>.
3310: 23 69 6e 63 6c 75 64 65 20 3c 73 74 64 64 65 66 #include <stddef
3320: 2e 68 3e 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 63 6f .h>../*.** If co
3330: 6d 70 69 6c 69 6e 67 20 66 6f 72 20 61 20 70 72 mpiling for a pr
3340: 6f 63 65 73 73 6f 72 20 74 68 61 74 20 6c 61 63 ocessor that lac
3350: 6b 73 20 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e ks floating poin
3360: 74 20 73 75 70 70 6f 72 74 2c 0a 2a 2a 20 73 75 t support,.** su
3370: 62 73 74 69 74 75 74 65 20 69 6e 74 65 67 65 72 bstitute integer
3380: 20 66 6f 72 20 66 6c 6f 61 74 69 6e 67 2d 70 6f for floating-po
3390: 69 6e 74 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 int.*/.#ifdef SQ
33a0: 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 LITE_OMIT_FLOATI
33b0: 4e 47 5f 50 4f 49 4e 54 0a 23 20 64 65 66 69 6e NG_POINT.# defin
33c0: 65 20 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 5f e double sqlite_
33d0: 69 6e 74 36 34 0a 23 20 64 65 66 69 6e 65 20 66 int64.# define f
33e0: 6c 6f 61 74 20 73 71 6c 69 74 65 5f 69 6e 74 36 loat sqlite_int6
33f0: 34 0a 23 20 64 65 66 69 6e 65 20 4c 4f 4e 47 44 4.# define LONGD
3400: 4f 55 42 4c 45 5f 54 59 50 45 20 73 71 6c 69 74 OUBLE_TYPE sqlit
3410: 65 5f 69 6e 74 36 34 0a 23 20 69 66 6e 64 65 66 e_int64.# ifndef
3420: 20 53 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c 0a SQLITE_BIG_DBL.
3430: 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c 49 54 # define SQLIT
3440: 45 5f 42 49 47 5f 44 42 4c 20 28 28 28 73 71 6c E_BIG_DBL (((sql
3450: 69 74 65 33 5f 69 6e 74 36 34 29 31 29 3c 3c 35 ite3_int64)1)<<5
3460: 30 29 0a 23 20 65 6e 64 69 66 0a 23 20 64 65 66 0).# endif.# def
3470: 69 6e 65 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f ine SQLITE_OMIT_
3480: 44 41 54 45 54 49 4d 45 5f 46 55 4e 43 53 20 31 DATETIME_FUNCS 1
3490: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
34a0: 5f 4f 4d 49 54 5f 54 52 41 43 45 20 31 0a 23 20 _OMIT_TRACE 1.#
34b0: 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 4d 49 58 undef SQLITE_MIX
34c0: 45 44 5f 45 4e 44 49 41 4e 5f 36 34 42 49 54 5f ED_ENDIAN_64BIT_
34d0: 46 4c 4f 41 54 0a 23 20 75 6e 64 65 66 20 53 51 FLOAT.# undef SQ
34e0: 4c 49 54 45 5f 48 41 56 45 5f 49 53 4e 41 4e 0a LITE_HAVE_ISNAN.
34f0: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 #endif.#ifndef S
3500: 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c 0a 23 20 QLITE_BIG_DBL.#
3510: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 define SQLITE_BI
3520: 47 5f 44 42 4c 20 28 31 65 39 39 29 0a 23 65 6e G_DBL (1e99).#en
3530: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f 4d 49 54 5f dif../*.** OMIT_
3540: 54 45 4d 50 44 42 20 69 73 20 73 65 74 20 74 6f TEMPDB is set to
3550: 20 31 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d 49 1 if SQLITE_OMI
3560: 54 5f 54 45 4d 50 44 42 20 69 73 20 64 65 66 69 T_TEMPDB is defi
3570: 6e 65 64 2c 20 6f 72 20 30 0a 2a 2a 20 61 66 74 ned, or 0.** aft
3580: 65 72 77 61 72 64 2e 20 48 61 76 69 6e 67 20 74 erward. Having t
3590: 68 69 73 20 6d 61 63 72 6f 20 61 6c 6c 6f 77 73 his macro allows
35a0: 20 75 73 20 74 6f 20 63 61 75 73 65 20 74 68 65 us to cause the
35b0: 20 43 20 63 6f 6d 70 69 6c 65 72 20 0a 2a 2a 20 C compiler .**
35c0: 74 6f 20 6f 6d 69 74 20 63 6f 64 65 20 75 73 65 to omit code use
35d0: 64 20 62 79 20 54 45 4d 50 20 74 61 62 6c 65 73 d by TEMP tables
35e0: 20 77 69 74 68 6f 75 74 20 6d 65 73 73 79 20 23 without messy #
35f0: 69 66 6e 64 65 66 20 73 74 61 74 65 6d 65 6e 74 ifndef statement
3600: 73 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c s..*/.#ifdef SQL
3610: 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 0a ITE_OMIT_TEMPDB.
3620: 23 64 65 66 69 6e 65 20 4f 4d 49 54 5f 54 45 4d #define OMIT_TEM
3630: 50 44 42 20 31 0a 23 65 6c 73 65 0a 23 64 65 66 PDB 1.#else.#def
3640: 69 6e 65 20 4f 4d 49 54 5f 54 45 4d 50 44 42 20 ine OMIT_TEMPDB
3650: 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 0.#endif../*.**
3660: 54 68 65 20 22 66 69 6c 65 20 66 6f 72 6d 61 74 The "file format
3670: 22 20 6e 75 6d 62 65 72 20 69 73 20 61 6e 20 69 " number is an i
3680: 6e 74 65 67 65 72 20 74 68 61 74 20 69 73 20 69 nteger that is i
3690: 6e 63 72 65 6d 65 6e 74 65 64 20 77 68 65 6e 65 ncremented whene
36a0: 76 65 72 0a 2a 2a 20 74 68 65 20 56 44 42 45 2d ver.** the VDBE-
36b0: 6c 65 76 65 6c 20 66 69 6c 65 20 66 6f 72 6d 61 level file forma
36c0: 74 20 63 68 61 6e 67 65 73 2e 20 20 54 68 65 20 t changes. The
36d0: 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f 73 following macros
36e0: 20 64 65 66 69 6e 65 20 74 68 65 0a 2a 2a 20 74 define the.** t
36f0: 68 65 20 64 65 66 61 75 6c 74 20 66 69 6c 65 20 he default file
3700: 66 6f 72 6d 61 74 20 66 6f 72 20 6e 65 77 20 64 format for new d
3710: 61 74 61 62 61 73 65 73 20 61 6e 64 20 74 68 65 atabases and the
3720: 20 6d 61 78 69 6d 75 6d 20 66 69 6c 65 20 66 6f maximum file fo
3730: 72 6d 61 74 0a 2a 2a 20 74 68 61 74 20 74 68 65 rmat.** that the
3740: 20 6c 69 62 72 61 72 79 20 63 61 6e 20 72 65 61 library can rea
3750: 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 d..*/.#define SQ
3760: 4c 49 54 45 5f 4d 41 58 5f 46 49 4c 45 5f 46 4f LITE_MAX_FILE_FO
3770: 52 4d 41 54 20 34 0a 23 69 66 6e 64 65 66 20 53 RMAT 4.#ifndef S
3780: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 46 49 QLITE_DEFAULT_FI
3790: 4c 45 5f 46 4f 52 4d 41 54 0a 23 20 64 65 66 69 LE_FORMAT.# defi
37a0: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
37b0: 54 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 34 0a T_FILE_FORMAT 4.
37c0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 65 #endif../*.** De
37d0: 74 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 termine whether
37e0: 74 72 69 67 67 65 72 73 20 61 72 65 20 72 65 63 triggers are rec
37f0: 75 72 73 69 76 65 20 62 79 20 64 65 66 61 75 6c ursive by defaul
3800: 74 2e 20 20 54 68 69 73 20 63 61 6e 20 62 65 0a t. This can be.
3810: 2a 2a 20 63 68 61 6e 67 65 64 20 61 74 20 72 75 ** changed at ru
3820: 6e 2d 74 69 6d 65 20 75 73 69 6e 67 20 61 20 70 n-time using a p
3830: 72 61 67 6d 61 2e 0a 2a 2f 0a 23 69 66 6e 64 65 ragma..*/.#ifnde
3840: 66 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 f SQLITE_DEFAULT
3850: 5f 52 45 43 55 52 53 49 56 45 5f 54 52 49 47 47 _RECURSIVE_TRIGG
3860: 45 52 53 0a 23 20 64 65 66 69 6e 65 20 53 51 4c ERS.# define SQL
3870: 49 54 45 5f 44 45 46 41 55 4c 54 5f 52 45 43 55 ITE_DEFAULT_RECU
3880: 52 53 49 56 45 5f 54 52 49 47 47 45 52 53 20 30 RSIVE_TRIGGERS 0
3890: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 50 .#endif../*.** P
38a0: 72 6f 76 69 64 65 20 61 20 64 65 66 61 75 6c 74 rovide a default
38b0: 20 76 61 6c 75 65 20 66 6f 72 20 53 51 4c 49 54 value for SQLIT
38c0: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 20 69 6e 20 E_TEMP_STORE in
38d0: 63 61 73 65 20 69 74 20 69 73 20 6e 6f 74 20 73 case it is not s
38e0: 70 65 63 69 66 69 65 64 0a 2a 2a 20 6f 6e 20 74 pecified.** on t
38f0: 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 0a he command-line.
3900: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
3910: 45 5f 54 45 4d 50 5f 53 54 4f 52 45 0a 23 20 64 E_TEMP_STORE.# d
3920: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 54 45 4d efine SQLITE_TEM
3930: 50 5f 53 54 4f 52 45 20 31 0a 23 20 64 65 66 69 P_STORE 1.# defi
3940: 6e 65 20 53 51 4c 49 54 45 5f 54 45 4d 50 5f 53 ne SQLITE_TEMP_S
3950: 54 4f 52 45 5f 78 63 20 31 20 20 2f 2a 20 45 78 TORE_xc 1 /* Ex
3960: 63 6c 75 64 65 20 66 72 6f 6d 20 63 74 69 6d 65 clude from ctime
3970: 2e 63 20 2a 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a .c */.#endif../*
3980: 0a 2a 2a 20 47 43 43 20 64 6f 65 73 20 6e 6f 74 .** GCC does not
3990: 20 64 65 66 69 6e 65 20 74 68 65 20 6f 66 66 73 define the offs
39a0: 65 74 6f 66 28 29 20 6d 61 63 72 6f 20 73 6f 20 etof() macro so
39b0: 77 65 27 6c 6c 20 68 61 76 65 20 74 6f 20 64 6f we'll have to do
39c0: 20 69 74 0a 2a 2a 20 6f 75 72 73 65 6c 76 65 73 it.** ourselves
39d0: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 6f 66 66 ..*/.#ifndef off
39e0: 73 65 74 6f 66 0a 23 64 65 66 69 6e 65 20 6f 66 setof.#define of
39f0: 66 73 65 74 6f 66 28 53 54 52 55 43 54 55 52 45 fsetof(STRUCTURE
3a00: 2c 46 49 45 4c 44 29 20 28 28 69 6e 74 29 28 28 ,FIELD) ((int)((
3a10: 63 68 61 72 2a 29 26 28 28 53 54 52 55 43 54 55 char*)&((STRUCTU
3a20: 52 45 2a 29 30 29 2d 3e 46 49 45 4c 44 29 29 0a RE*)0)->FIELD)).
3a30: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4d 61 #endif../*.** Ma
3a40: 63 72 6f 73 20 74 6f 20 63 6f 6d 70 75 74 65 20 cros to compute
3a50: 6d 69 6e 69 6d 75 6d 20 61 6e 64 20 6d 61 78 69 minimum and maxi
3a60: 6d 75 6d 20 6f 66 20 74 77 6f 20 6e 75 6d 62 65 mum of two numbe
3a70: 72 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d rs..*/.#define M
3a80: 49 4e 28 41 2c 42 29 20 28 28 41 29 3c 28 42 29 IN(A,B) ((A)<(B)
3a90: 3f 28 41 29 3a 28 42 29 29 0a 23 64 65 66 69 6e ?(A):(B)).#defin
3aa0: 65 20 4d 41 58 28 41 2c 42 29 20 28 28 41 29 3e e MAX(A,B) ((A)>
3ab0: 28 42 29 3f 28 41 29 3a 28 42 29 29 0a 0a 2f 2a (B)?(A):(B))../*
3ac0: 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 .** Check to see
3ad0: 20 69 66 20 74 68 69 73 20 6d 61 63 68 69 6e 65 if this machine
3ae0: 20 75 73 65 73 20 45 42 43 44 49 43 2e 20 20 28 uses EBCDIC. (
3af0: 59 65 73 2c 20 62 65 6c 69 65 76 65 20 69 74 20 Yes, believe it
3b00: 6f 72 0a 2a 2a 20 6e 6f 74 2c 20 74 68 65 72 65 or.** not, there
3b10: 20 61 72 65 20 73 74 69 6c 6c 20 6d 61 63 68 69 are still machi
3b20: 6e 65 73 20 6f 75 74 20 74 68 65 72 65 20 74 68 nes out there th
3b30: 61 74 20 75 73 65 20 45 42 43 44 49 43 2e 29 0a at use EBCDIC.).
3b40: 2a 2f 0a 23 69 66 20 27 41 27 20 3d 3d 20 27 5c */.#if 'A' == '\
3b50: 33 30 31 27 0a 23 20 64 65 66 69 6e 65 20 53 51 301'.# define SQ
3b60: 4c 49 54 45 5f 45 42 43 44 49 43 20 31 0a 23 65 LITE_EBCDIC 1.#e
3b70: 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 53 51 4c lse.# define SQL
3b80: 49 54 45 5f 41 53 43 49 49 20 31 0a 23 65 6e 64 ITE_ASCII 1.#end
3b90: 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74 65 67 65 if../*.** Intege
3ba0: 72 73 20 6f 66 20 6b 6e 6f 77 6e 20 73 69 7a 65 rs of known size
3bb0: 73 2e 20 20 54 68 65 73 65 20 74 79 70 65 64 65 s. These typede
3bc0: 66 73 20 6d 69 67 68 74 20 63 68 61 6e 67 65 20 fs might change
3bd0: 66 6f 72 20 61 72 63 68 69 74 65 63 74 75 72 65 for architecture
3be0: 73 0a 2a 2a 20 77 68 65 72 65 20 74 68 65 20 73 s.** where the s
3bf0: 69 7a 65 73 20 76 65 72 79 2e 20 20 50 72 65 70 izes very. Prep
3c00: 72 6f 63 65 73 73 6f 72 20 6d 61 63 72 6f 73 20 rocessor macros
3c10: 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 73 6f are available so
3c20: 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 74 79 70 that the.** typ
3c30: 65 73 20 63 61 6e 20 62 65 20 63 6f 6e 76 65 6e es can be conven
3c40: 69 65 6e 74 6c 79 20 72 65 64 65 66 69 6e 65 64 iently redefined
3c50: 20 61 74 20 63 6f 6d 70 69 6c 65 2d 74 79 70 65 at compile-type
3c60: 2e 20 20 4c 69 6b 65 20 74 68 69 73 3a 0a 2a 2a . Like this:.**
3c70: 0a 2a 2a 20 20 20 20 20 20 20 20 20 63 63 20 27 .** cc '
3c80: 2d 44 55 49 4e 54 50 54 52 5f 54 59 50 45 3d 6c -DUINTPTR_TYPE=l
3c90: 6f 6e 67 20 6c 6f 6e 67 20 69 6e 74 27 20 2e 2e ong long int' ..
3ca0: 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 55 49 4e ..*/.#ifndef UIN
3cb0: 54 33 32 5f 54 59 50 45 0a 23 20 69 66 64 65 66 T32_TYPE.# ifdef
3cc0: 20 48 41 56 45 5f 55 49 4e 54 33 32 5f 54 0a 23 HAVE_UINT32_T.#
3cd0: 20 20 64 65 66 69 6e 65 20 55 49 4e 54 33 32 5f define UINT32_
3ce0: 54 59 50 45 20 75 69 6e 74 33 32 5f 74 0a 23 20 TYPE uint32_t.#
3cf0: 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 55 else.# define U
3d00: 49 4e 54 33 32 5f 54 59 50 45 20 75 6e 73 69 67 INT32_TYPE unsig
3d10: 6e 65 64 20 69 6e 74 0a 23 20 65 6e 64 69 66 0a ned int.# endif.
3d20: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 55 #endif.#ifndef U
3d30: 49 4e 54 31 36 5f 54 59 50 45 0a 23 20 69 66 64 INT16_TYPE.# ifd
3d40: 65 66 20 48 41 56 45 5f 55 49 4e 54 31 36 5f 54 ef HAVE_UINT16_T
3d50: 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 31 .# define UINT1
3d60: 36 5f 54 59 50 45 20 75 69 6e 74 31 36 5f 74 0a 6_TYPE uint16_t.
3d70: 23 20 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 # else.# define
3d80: 20 55 49 4e 54 31 36 5f 54 59 50 45 20 75 6e 73 UINT16_TYPE uns
3d90: 69 67 6e 65 64 20 73 68 6f 72 74 20 69 6e 74 0a igned short int.
3da0: 23 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 23 # endif.#endif.#
3db0: 69 66 6e 64 65 66 20 49 4e 54 31 36 5f 54 59 50 ifndef INT16_TYP
3dc0: 45 0a 23 20 69 66 64 65 66 20 48 41 56 45 5f 49 E.# ifdef HAVE_I
3dd0: 4e 54 31 36 5f 54 0a 23 20 20 64 65 66 69 6e 65 NT16_T.# define
3de0: 20 49 4e 54 31 36 5f 54 59 50 45 20 69 6e 74 31 INT16_TYPE int1
3df0: 36 5f 74 0a 23 20 65 6c 73 65 0a 23 20 20 64 65 6_t.# else.# de
3e00: 66 69 6e 65 20 49 4e 54 31 36 5f 54 59 50 45 20 fine INT16_TYPE
3e10: 73 68 6f 72 74 20 69 6e 74 0a 23 20 65 6e 64 69 short int.# endi
3e20: 66 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 f.#endif.#ifndef
3e30: 20 55 49 4e 54 38 5f 54 59 50 45 0a 23 20 69 66 UINT8_TYPE.# if
3e40: 64 65 66 20 48 41 56 45 5f 55 49 4e 54 38 5f 54 def HAVE_UINT8_T
3e50: 0a 23 20 20 64 65 66 69 6e 65 20 55 49 4e 54 38 .# define UINT8
3e60: 5f 54 59 50 45 20 75 69 6e 74 38 5f 74 0a 23 20 _TYPE uint8_t.#
3e70: 65 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 55 else.# define U
3e80: 49 4e 54 38 5f 54 59 50 45 20 75 6e 73 69 67 6e INT8_TYPE unsign
3e90: 65 64 20 63 68 61 72 0a 23 20 65 6e 64 69 66 0a ed char.# endif.
3ea0: 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 49 #endif.#ifndef I
3eb0: 4e 54 38 5f 54 59 50 45 0a 23 20 69 66 64 65 66 NT8_TYPE.# ifdef
3ec0: 20 48 41 56 45 5f 49 4e 54 38 5f 54 0a 23 20 20 HAVE_INT8_T.#
3ed0: 64 65 66 69 6e 65 20 49 4e 54 38 5f 54 59 50 45 define INT8_TYPE
3ee0: 20 69 6e 74 38 5f 74 0a 23 20 65 6c 73 65 0a 23 int8_t.# else.#
3ef0: 20 20 64 65 66 69 6e 65 20 49 4e 54 38 5f 54 59 define INT8_TY
3f00: 50 45 20 73 69 67 6e 65 64 20 63 68 61 72 0a 23 PE signed char.#
3f10: 20 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 23 69 endif.#endif.#i
3f20: 66 6e 64 65 66 20 4c 4f 4e 47 44 4f 55 42 4c 45 fndef LONGDOUBLE
3f30: 5f 54 59 50 45 0a 23 20 64 65 66 69 6e 65 20 4c _TYPE.# define L
3f40: 4f 4e 47 44 4f 55 42 4c 45 5f 54 59 50 45 20 6c ONGDOUBLE_TYPE l
3f50: 6f 6e 67 20 64 6f 75 62 6c 65 0a 23 65 6e 64 69 ong double.#endi
3f60: 66 0a 74 79 70 65 64 65 66 20 73 71 6c 69 74 65 f.typedef sqlite
3f70: 5f 69 6e 74 36 34 20 69 36 34 3b 20 20 20 20 20 _int64 i64;
3f80: 20 20 20 20 20 2f 2a 20 38 2d 62 79 74 65 20 73 /* 8-byte s
3f90: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f igned integer */
3fa0: 0a 74 79 70 65 64 65 66 20 73 71 6c 69 74 65 5f .typedef sqlite_
3fb0: 75 69 6e 74 36 34 20 75 36 34 3b 20 20 20 20 20 uint64 u64;
3fc0: 20 20 20 20 2f 2a 20 38 2d 62 79 74 65 20 75 6e /* 8-byte un
3fd0: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a signed integer *
3fe0: 2f 0a 74 79 70 65 64 65 66 20 55 49 4e 54 33 32 /.typedef UINT32
3ff0: 5f 54 59 50 45 20 75 33 32 3b 20 20 20 20 20 20 _TYPE u32;
4000: 20 20 20 20 20 2f 2a 20 34 2d 62 79 74 65 20 75 /* 4-byte u
4010: 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 nsigned integer
4020: 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e 54 31 */.typedef UINT1
4030: 36 5f 54 59 50 45 20 75 31 36 3b 20 20 20 20 20 6_TYPE u16;
4040: 20 20 20 20 20 20 2f 2a 20 32 2d 62 79 74 65 20 /* 2-byte
4050: 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
4060: 20 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e 54 31 */.typedef INT1
4070: 36 5f 54 59 50 45 20 69 31 36 3b 20 20 20 20 20 6_TYPE i16;
4080: 20 20 20 20 20 20 20 2f 2a 20 32 2d 62 79 74 65 /* 2-byte
4090: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 signed integer
40a0: 2a 2f 0a 74 79 70 65 64 65 66 20 55 49 4e 54 38 */.typedef UINT8
40b0: 5f 54 59 50 45 20 75 38 3b 20 20 20 20 20 20 20 _TYPE u8;
40c0: 20 20 20 20 20 20 2f 2a 20 31 2d 62 79 74 65 20 /* 1-byte
40d0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 unsigned integer
40e0: 20 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e 54 38 */.typedef INT8
40f0: 5f 54 59 50 45 20 69 38 3b 20 20 20 20 20 20 20 _TYPE i8;
4100: 20 20 20 20 20 20 20 2f 2a 20 31 2d 62 79 74 65 /* 1-byte
4110: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 signed integer
4120: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c 49 54 45 */../*.** SQLITE
4130: 5f 4d 41 58 5f 55 33 32 20 69 73 20 61 20 75 36 _MAX_U32 is a u6
4140: 34 20 63 6f 6e 73 74 61 6e 74 20 74 68 61 74 20 4 constant that
4150: 69 73 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 75 is the maximum u
4160: 36 34 20 76 61 6c 75 65 0a 2a 2a 20 74 68 61 74 64 value.** that
4170: 20 63 61 6e 20 62 65 20 73 74 6f 72 65 64 20 69 can be stored i
4180: 6e 20 61 20 75 33 32 20 77 69 74 68 6f 75 74 20 n a u32 without
4190: 6c 6f 73 73 20 6f 66 20 64 61 74 61 2e 20 20 54 loss of data. T
41a0: 68 65 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 30 he value.** is 0
41b0: 78 30 30 30 30 30 30 30 30 66 66 66 66 66 66 66 x00000000fffffff
41c0: 66 2e 20 20 42 75 74 20 62 65 63 61 75 73 65 20 f. But because
41d0: 6f 66 20 71 75 69 72 6b 73 20 6f 66 20 73 6f 6d of quirks of som
41e0: 65 20 63 6f 6d 70 69 6c 65 72 73 2c 20 77 65 0a e compilers, we.
41f0: 2a 2a 20 68 61 76 65 20 74 6f 20 73 70 65 63 69 ** have to speci
4200: 66 79 20 74 68 65 20 76 61 6c 75 65 20 69 6e 20 fy the value in
4210: 74 68 65 20 6c 65 73 73 20 69 6e 74 75 69 74 69 the less intuiti
4220: 76 65 20 6d 61 6e 6e 65 72 20 73 68 6f 77 6e 3a ve manner shown:
4230: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .*/.#define SQLI
4240: 54 45 5f 4d 41 58 5f 55 33 32 20 20 28 28 28 28 TE_MAX_U32 ((((
4250: 75 36 34 29 31 29 3c 3c 33 32 29 2d 31 29 0a 0a u64)1)<<32)-1)..
4260: 2f 2a 0a 2a 2a 20 54 68 65 20 64 61 74 61 74 79 /*.** The dataty
4270: 70 65 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 pe used to store
4280: 20 65 73 74 69 6d 61 74 65 73 20 6f 66 20 74 68 estimates of th
4290: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 e number of rows
42a0: 20 69 6e 20 61 0a 2a 2a 20 74 61 62 6c 65 20 6f in a.** table o
42b0: 72 20 69 6e 64 65 78 2e 20 20 54 68 69 73 20 69 r index. This i
42c0: 73 20 61 6e 20 75 6e 73 69 67 6e 65 64 20 69 6e s an unsigned in
42d0: 74 65 67 65 72 20 74 79 70 65 2e 20 20 46 6f 72 teger type. For
42e0: 20 39 39 2e 39 25 20 6f 66 0a 2a 2a 20 74 68 65 99.9% of.** the
42f0: 20 77 6f 72 6c 64 2c 20 61 20 33 32 2d 62 69 74 world, a 32-bit
4300: 20 69 6e 74 65 67 65 72 20 69 73 20 73 75 66 66 integer is suff
4310: 69 63 69 65 6e 74 2e 20 20 42 75 74 20 61 20 36 icient. But a 6
4320: 34 2d 62 69 74 20 69 6e 74 65 67 65 72 0a 2a 2a 4-bit integer.**
4330: 20 63 61 6e 20 62 65 20 75 73 65 64 20 61 74 20 can be used at
4340: 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 20 69 66 20 compile-time if
4350: 64 65 73 69 72 65 64 2e 0a 2a 2f 0a 23 69 66 64 desired..*/.#ifd
4360: 65 66 20 53 51 4c 49 54 45 5f 36 34 42 49 54 5f ef SQLITE_64BIT_
4370: 53 54 41 54 53 0a 20 74 79 70 65 64 65 66 20 75 STATS. typedef u
4380: 36 34 20 74 52 6f 77 63 6e 74 3b 20 20 20 20 2f 64 tRowcnt; /
4390: 2a 20 36 34 2d 62 69 74 20 6f 6e 6c 79 20 69 66 * 64-bit only if
43a0: 20 72 65 71 75 65 73 74 65 64 20 61 74 20 63 6f requested at co
43b0: 6d 70 69 6c 65 2d 74 69 6d 65 20 2a 2f 0a 23 65 mpile-time */.#e
43c0: 6c 73 65 0a 20 74 79 70 65 64 65 66 20 75 33 32 lse. typedef u32
43d0: 20 74 52 6f 77 63 6e 74 3b 20 20 20 20 2f 2a 20 tRowcnt; /*
43e0: 33 32 2d 62 69 74 20 69 73 20 74 68 65 20 64 65 32-bit is the de
43f0: 66 61 75 6c 74 20 2a 2f 0a 23 65 6e 64 69 66 0a fault */.#endif.
4400: 0a 2f 2a 0a 2a 2a 20 45 73 74 69 6d 61 74 65 64 ./*.** Estimated
4410: 20 71 75 61 6e 74 69 74 69 65 73 20 75 73 65 64 quantities used
4420: 20 66 6f 72 20 71 75 65 72 79 20 70 6c 61 6e 6e for query plann
4430: 69 6e 67 20 61 72 65 20 73 74 6f 72 65 64 20 61 ing are stored a
4440: 73 20 31 36 2d 62 69 74 0a 2a 2a 20 6c 6f 67 61 s 16-bit.** loga
4450: 72 69 74 68 6d 73 2e 20 20 46 6f 72 20 71 75 61 rithms. For qua
4460: 6e 74 69 74 79 20 58 2c 20 74 68 65 20 76 61 6c ntity X, the val
4470: 75 65 20 73 74 6f 72 65 64 20 69 73 20 31 30 2a ue stored is 10*
4480: 6c 6f 67 32 28 58 29 2e 20 20 54 68 69 73 0a 2a log2(X). This.*
4490: 2a 20 67 69 76 65 73 20 61 20 70 6f 73 73 69 62 * gives a possib
44a0: 6c 65 20 72 61 6e 67 65 20 6f 66 20 76 61 6c 75 le range of valu
44b0: 65 73 20 6f 66 20 61 70 70 72 6f 78 69 6d 61 74 es of approximat
44c0: 65 6c 79 20 31 2e 30 65 39 38 36 20 74 6f 20 31 ely 1.0e986 to 1
44d0: 65 2d 39 38 36 2e 0a 2a 2a 20 42 75 74 20 74 68 e-986..** But th
44e0: 65 20 61 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 e allowed values
44f0: 20 61 72 65 20 22 67 72 61 69 6e 79 22 2e 20 20 are "grainy".
4500: 4e 6f 74 20 65 76 65 72 79 20 76 61 6c 75 65 20 Not every value
4510: 69 73 20 72 65 70 72 65 73 65 6e 74 61 62 6c 65 is representable
4520: 2e 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 ..** For example
4530: 2c 20 71 75 61 6e 74 69 74 69 65 73 20 31 36 20 , quantities 16
4540: 61 6e 64 20 31 37 20 61 72 65 20 62 6f 74 68 20 and 17 are both
4550: 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 20 61 represented by a
4560: 20 4c 6f 67 45 73 74 0a 2a 2a 20 6f 66 20 34 30 LogEst.** of 40
4570: 2e 20 20 48 6f 77 65 76 65 72 2c 20 73 69 6e 63 . However, sinc
4580: 65 20 4c 6f 67 45 73 74 20 71 75 61 6e 74 61 74 e LogEst quantat
4590: 69 65 73 20 61 72 65 20 73 75 70 70 6f 73 65 20 ies are suppose
45a0: 74 6f 20 62 65 20 65 73 74 69 6d 61 74 65 73 2c to be estimates,
45b0: 0a 2a 2a 20 6e 6f 74 20 65 78 61 63 74 20 76 61 .** not exact va
45c0: 6c 75 65 73 2c 20 74 68 69 73 20 69 6d 70 72 65 lues, this impre
45d0: 63 69 73 69 6f 6e 20 69 73 20 6e 6f 74 20 61 20 cision is not a
45e0: 70 72 6f 62 6c 65 6d 2e 0a 2a 2a 0a 2a 2a 20 22 problem..**.** "
45f0: 4c 6f 67 45 73 74 22 20 69 73 20 73 68 6f 72 74 LogEst" is short
4600: 20 66 6f 72 20 22 4c 6f 67 61 72 69 74 68 6d 69 for "Logarithmi
4610: 63 20 45 73 74 69 6d 61 74 65 22 2e 0a 2a 2a 0a c Estimate"..**.
4620: 2a 2a 20 45 78 61 6d 70 6c 65 73 3a 0a 2a 2a 20 ** Examples:.**
4630: 20 20 20 20 20 31 20 2d 3e 20 30 20 20 20 20 20 1 -> 0
4640: 20 20 20 20 20 20 20 20 20 32 30 20 2d 3e 20 34 20 -> 4
4650: 33 20 20 20 20 20 20 20 20 20 20 31 30 30 30 30 3 10000
4660: 20 2d 3e 20 31 33 32 0a 2a 2a 20 20 20 20 20 20 -> 132.**
4670: 32 20 2d 3e 20 31 30 20 20 20 20 20 20 20 20 20 2 -> 10
4680: 20 20 20 20 32 35 20 2d 3e 20 34 36 20 20 20 20 25 -> 46
4690: 20 20 20 20 20 20 32 35 30 30 30 20 2d 3e 20 31 25000 -> 1
46a0: 34 36 0a 2a 2a 20 20 20 20 20 20 33 20 2d 3e 20 46.** 3 ->
46b0: 31 36 20 20 20 20 20 20 20 20 20 20 20 20 31 30 16 10
46c0: 30 20 2d 3e 20 36 36 20 20 20 20 20 20 20 20 31 0 -> 66 1
46d0: 30 30 30 30 30 30 20 2d 3e 20 31 39 39 0a 2a 2a 000000 -> 199.**
46e0: 20 20 20 20 20 20 34 20 2d 3e 20 32 30 20 20 20 4 -> 20
46f0: 20 20 20 20 20 20 20 20 31 30 30 30 20 2d 3e 20 1000 ->
4700: 39 39 20 20 20 20 20 20 20 20 31 30 34 38 35 37 99 104857
4710: 36 20 2d 3e 20 32 30 30 0a 2a 2a 20 20 20 20 20 6 -> 200.**
4720: 31 30 20 2d 3e 20 33 33 20 20 20 20 20 20 20 20 10 -> 33
4730: 20 20 20 31 30 32 34 20 2d 3e 20 31 30 30 20 20 1024 -> 100
4740: 20 20 34 32 39 34 39 36 37 32 39 36 20 2d 3e 20 4294967296 ->
4750: 33 32 30 0a 2a 2a 0a 2a 2a 20 54 68 65 20 4c 6f 320.**.** The Lo
4760: 67 45 73 74 20 63 61 6e 20 62 65 20 6e 65 67 61 gEst can be nega
4770: 74 69 76 65 20 74 6f 20 69 6e 64 69 63 61 74 65 tive to indicate
4780: 20 66 72 61 63 74 69 6f 6e 61 6c 20 76 61 6c 75 fractional valu
4790: 65 73 2e 20 0a 2a 2a 20 45 78 61 6d 70 6c 65 73 es. .** Examples
47a0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 30 2e 35 20 2d :.**.** 0.5 -
47b0: 3e 20 2d 31 30 20 20 20 20 20 20 20 20 20 20 20 > -10
47c0: 30 2e 31 20 2d 3e 20 2d 33 33 20 20 20 20 20 20 0.1 -> -33
47d0: 20 20 30 2e 30 36 32 35 20 2d 3e 20 2d 34 30 0a 0.0625 -> -40.
47e0: 2a 2f 0a 74 79 70 65 64 65 66 20 49 4e 54 31 36 */.typedef INT16
47f0: 5f 54 59 50 45 20 4c 6f 67 45 73 74 3b 0a 0a 2f _TYPE LogEst;../
4800: 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 6f 20 64 *.** Macros to d
4810: 65 74 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 etermine whether
4820: 20 74 68 65 20 6d 61 63 68 69 6e 65 20 69 73 20 the machine is
4830: 62 69 67 20 6f 72 20 6c 69 74 74 6c 65 20 65 6e big or little en
4840: 64 69 61 6e 2c 0a 2a 2a 20 61 6e 64 20 77 68 65 dian,.** and whe
4850: 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 61 74 ther or not that
4860: 20 64 65 74 65 72 6d 69 6e 61 74 69 6f 6e 20 69 determination i
4870: 73 20 72 75 6e 2d 74 69 6d 65 20 6f 72 20 63 6f s run-time or co
4880: 6d 70 69 6c 65 2d 74 69 6d 65 2e 0a 2a 2a 0a 2a mpile-time..**.*
4890: 2a 20 46 6f 72 20 62 65 73 74 20 70 65 72 66 6f * For best perfo
48a0: 72 6d 61 6e 63 65 2c 20 61 6e 20 61 74 74 65 6d rmance, an attem
48b0: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 67 75 pt is made to gu
48c0: 65 73 73 20 61 74 20 74 68 65 20 62 79 74 65 2d ess at the byte-
48d0: 6f 72 64 65 72 0a 2a 2a 20 75 73 69 6e 67 20 43 order.** using C
48e0: 2d 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6d 61 -preprocessor ma
48f0: 63 72 6f 73 2e 20 20 49 66 20 74 68 61 74 20 69 cros. If that i
4900: 73 20 75 6e 73 75 63 63 65 73 73 66 75 6c 2c 20 s unsuccessful,
4910: 6f 72 20 69 66 0a 2a 2a 20 2d 44 53 51 4c 49 54 or if.** -DSQLIT
4920: 45 5f 52 55 4e 54 49 4d 45 5f 42 59 54 45 4f 52 E_RUNTIME_BYTEOR
4930: 44 45 52 3d 31 20 69 73 20 73 65 74 2c 20 74 68 DER=1 is set, th
4940: 65 6e 20 62 79 74 65 2d 6f 72 64 65 72 20 69 73 en byte-order is
4950: 20 64 65 74 65 72 6d 69 6e 65 64 0a 2a 2a 20 61 determined.** a
4960: 74 20 72 75 6e 2d 74 69 6d 65 2e 0a 2a 2f 0a 23 t run-time..*/.#
4970: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 41 4d 41 ifdef SQLITE_AMA
4980: 4c 47 41 4d 41 54 49 4f 4e 0a 63 6f 6e 73 74 20 LGAMATION.const
4990: 69 6e 74 20 73 71 6c 69 74 65 33 6f 6e 65 20 3d int sqlite3one =
49a0: 20 31 3b 0a 23 65 6c 73 65 0a 65 78 74 65 72 6e 1;.#else.extern
49b0: 20 63 6f 6e 73 74 20 69 6e 74 20 73 71 6c 69 74 const int sqlit
49c0: 65 33 6f 6e 65 3b 0a 23 65 6e 64 69 66 0a 23 69 e3one;.#endif.#i
49d0: 66 20 28 64 65 66 69 6e 65 64 28 69 33 38 36 29 f (defined(i386)
49e0: 20 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 || defined(
49f0: 5f 5f 69 33 38 36 5f 5f 29 20 20 20 7c 7c 20 64 __i386__) || d
4a00: 65 66 69 6e 65 64 28 5f 4d 5f 49 58 38 36 29 20 efined(_M_IX86)
4a10: 7c 7c 20 20 20 20 5c 0a 20 20 20 20 20 64 65 66 || \. def
4a20: 69 6e 65 64 28 5f 5f 78 38 36 5f 36 34 29 20 7c ined(__x86_64) |
4a30: 7c 20 64 65 66 69 6e 65 64 28 5f 5f 78 38 36 5f | defined(__x86_
4a40: 36 34 5f 5f 29 20 7c 7c 20 64 65 66 69 6e 65 64 64__) || defined
4a50: 28 5f 4d 5f 58 36 34 29 20 20 7c 7c 20 20 20 20 (_M_X64) ||
4a60: 5c 0a 20 20 20 20 20 64 65 66 69 6e 65 64 28 5f \. defined(_
4a70: 4d 5f 41 4d 44 36 34 29 20 7c 7c 20 64 65 66 69 M_AMD64) || defi
4a80: 6e 65 64 28 5f 4d 5f 41 52 4d 29 20 20 20 20 20 ned(_M_ARM)
4a90: 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 78 38 36 || defined(__x86
4aa0: 29 20 20 20 7c 7c 20 20 20 20 5c 0a 20 20 20 20 ) || \.
4ab0: 20 64 65 66 69 6e 65 64 28 5f 5f 61 72 6d 5f 5f defined(__arm__
4ac0: 29 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 )) && !defined(S
4ad0: 51 4c 49 54 45 5f 52 55 4e 54 49 4d 45 5f 42 59 QLITE_RUNTIME_BY
4ae0: 54 45 4f 52 44 45 52 29 0a 23 20 64 65 66 69 6e TEORDER).# defin
4af0: 65 20 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 e SQLITE_BYTEORD
4b00: 45 52 20 20 20 20 31 32 33 34 0a 23 20 64 65 66 ER 1234.# def
4b10: 69 6e 65 20 53 51 4c 49 54 45 5f 42 49 47 45 4e ine SQLITE_BIGEN
4b20: 44 49 41 4e 20 20 20 20 30 0a 23 20 64 65 66 69 DIAN 0.# defi
4b30: 6e 65 20 53 51 4c 49 54 45 5f 4c 49 54 54 4c 45 ne SQLITE_LITTLE
4b40: 45 4e 44 49 41 4e 20 31 0a 23 20 64 65 66 69 6e ENDIAN 1.# defin
4b50: 65 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 e SQLITE_UTF16NA
4b60: 54 49 56 45 20 20 53 51 4c 49 54 45 5f 55 54 46 TIVE SQLITE_UTF
4b70: 31 36 4c 45 0a 23 65 6e 64 69 66 0a 23 69 66 20 16LE.#endif.#if
4b80: 28 64 65 66 69 6e 65 64 28 73 70 61 72 63 29 20 (defined(sparc)
4b90: 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f || defined(__
4ba0: 70 70 63 5f 5f 29 29 20 20 5c 0a 20 20 20 20 26 ppc__)) \. &
4bb0: 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 & !defined(SQLIT
4bc0: 45 5f 52 55 4e 54 49 4d 45 5f 42 59 54 45 4f 52 E_RUNTIME_BYTEOR
4bd0: 44 45 52 29 0a 23 20 64 65 66 69 6e 65 20 53 51 DER).# define SQ
4be0: 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 20 20 LITE_BYTEORDER
4bf0: 20 20 34 33 32 31 0a 23 20 64 65 66 69 6e 65 20 4321.# define
4c00: 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 41 4e SQLITE_BIGENDIAN
4c10: 20 20 20 20 31 0a 23 20 64 65 66 69 6e 65 20 53 1.# define S
4c20: 51 4c 49 54 45 5f 4c 49 54 54 4c 45 45 4e 44 49 QLITE_LITTLEENDI
4c30: 41 4e 20 30 0a 23 20 64 65 66 69 6e 65 20 53 51 AN 0.# define SQ
4c40: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
4c50: 20 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 45 SQLITE_UTF16BE
4c60: 0a 23 65 6e 64 69 66 0a 23 69 66 20 21 64 65 66 .#endif.#if !def
4c70: 69 6e 65 64 28 53 51 4c 49 54 45 5f 42 59 54 45 ined(SQLITE_BYTE
4c80: 4f 52 44 45 52 29 0a 23 20 64 65 66 69 6e 65 20 ORDER).# define
4c90: 53 51 4c 49 54 45 5f 42 59 54 45 4f 52 44 45 52 SQLITE_BYTEORDER
4ca0: 20 20 20 20 30 20 20 20 20 20 2f 2a 20 30 20 6d 0 /* 0 m
4cb0: 65 61 6e 73 20 22 75 6e 6b 6e 6f 77 6e 20 61 74 eans "unknown at
4cc0: 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65 22 20 2a compile-time" *
4cd0: 2f 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 /.# define SQLIT
4ce0: 45 5f 42 49 47 45 4e 44 49 41 4e 20 20 20 20 28 E_BIGENDIAN (
4cf0: 2a 28 63 68 61 72 20 2a 29 28 26 73 71 6c 69 74 *(char *)(&sqlit
4d00: 65 33 6f 6e 65 29 3d 3d 30 29 0a 23 20 64 65 66 e3one)==0).# def
4d10: 69 6e 65 20 53 51 4c 49 54 45 5f 4c 49 54 54 4c ine SQLITE_LITTL
4d20: 45 45 4e 44 49 41 4e 20 28 2a 28 63 68 61 72 20 EENDIAN (*(char
4d30: 2a 29 28 26 73 71 6c 69 74 65 33 6f 6e 65 29 3d *)(&sqlite3one)=
4d40: 3d 31 29 0a 23 20 64 65 66 69 6e 65 20 53 51 4c =1).# define SQL
4d50: 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 20 ITE_UTF16NATIVE
4d60: 20 28 53 51 4c 49 54 45 5f 42 49 47 45 4e 44 49 (SQLITE_BIGENDI
4d70: 41 4e 3f 53 51 4c 49 54 45 5f 55 54 46 31 36 42 AN?SQLITE_UTF16B
4d80: 45 3a 53 51 4c 49 54 45 5f 55 54 46 31 36 4c 45 E:SQLITE_UTF16LE
4d90: 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
4da0: 43 6f 6e 73 74 61 6e 74 73 20 66 6f 72 20 74 68 Constants for th
4db0: 65 20 6c 61 72 67 65 73 74 20 61 6e 64 20 73 6d e largest and sm
4dc0: 61 6c 6c 65 73 74 20 70 6f 73 73 69 62 6c 65 20 allest possible
4dd0: 36 34 2d 62 69 74 20 73 69 67 6e 65 64 20 69 6e 64-bit signed in
4de0: 74 65 67 65 72 73 2e 0a 2a 2a 20 54 68 65 73 65 tegers..** These
4df0: 20 6d 61 63 72 6f 73 20 61 72 65 20 64 65 73 69 macros are desi
4e00: 67 6e 65 64 20 74 6f 20 77 6f 72 6b 20 63 6f 72 gned to work cor
4e10: 72 65 63 74 6c 79 20 6f 6e 20 62 6f 74 68 20 33 rectly on both 3
4e20: 32 2d 62 69 74 20 61 6e 64 20 36 34 2d 62 69 74 2-bit and 64-bit
4e30: 0a 2a 2a 20 63 6f 6d 70 69 6c 65 72 73 2e 0a 2a .** compilers..*
4e40: 2f 0a 23 64 65 66 69 6e 65 20 4c 41 52 47 45 53 /.#define LARGES
4e50: 54 5f 49 4e 54 36 34 20 20 28 30 78 66 66 66 66 T_INT64 (0xffff
4e60: 66 66 66 66 7c 28 28 28 69 36 34 29 30 78 37 66 ffff|(((i64)0x7f
4e70: 66 66 66 66 66 66 29 3c 3c 33 32 29 29 0a 23 64 ffffff)<<32)).#d
4e80: 65 66 69 6e 65 20 53 4d 41 4c 4c 45 53 54 5f 49 efine SMALLEST_I
4e90: 4e 54 36 34 20 28 28 28 69 36 34 29 2d 31 29 20 NT64 (((i64)-1)
4ea0: 2d 20 4c 41 52 47 45 53 54 5f 49 4e 54 36 34 29 - LARGEST_INT64)
4eb0: 0a 0a 2f 2a 20 0a 2a 2a 20 52 6f 75 6e 64 20 75 ../* .** Round u
4ec0: 70 20 61 20 6e 75 6d 62 65 72 20 74 6f 20 74 68 p a number to th
4ed0: 65 20 6e 65 78 74 20 6c 61 72 67 65 72 20 6d 75 e next larger mu
4ee0: 6c 74 69 70 6c 65 20 6f 66 20 38 2e 20 20 54 68 ltiple of 8. Th
4ef0: 69 73 20 69 73 20 75 73 65 64 0a 2a 2a 20 74 6f is is used.** to
4f00: 20 66 6f 72 63 65 20 38 2d 62 79 74 65 20 61 6c force 8-byte al
4f10: 69 67 6e 6d 65 6e 74 20 6f 6e 20 36 34 2d 62 69 ignment on 64-bi
4f20: 74 20 61 72 63 68 69 74 65 63 74 75 72 65 73 2e t architectures.
4f30: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 52 4f 55 4e .*/.#define ROUN
4f40: 44 38 28 78 29 20 20 20 20 20 28 28 28 78 29 2b D8(x) (((x)+
4f50: 37 29 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 52 6f 7)&~7)../*.** Ro
4f60: 75 6e 64 20 64 6f 77 6e 20 74 6f 20 74 68 65 20 und down to the
4f70: 6e 65 61 72 65 73 74 20 6d 75 6c 74 69 70 6c 65 nearest multiple
4f80: 20 6f 66 20 38 0a 2a 2f 0a 23 64 65 66 69 6e 65 of 8.*/.#define
4f90: 20 52 4f 55 4e 44 44 4f 57 4e 38 28 78 29 20 28 ROUNDDOWN8(x) (
4fa0: 28 78 29 26 7e 37 29 0a 0a 2f 2a 0a 2a 2a 20 41 (x)&~7)../*.** A
4fb0: 73 73 65 72 74 20 74 68 61 74 20 74 68 65 20 70 ssert that the p
4fc0: 6f 69 6e 74 65 72 20 58 20 69 73 20 61 6c 69 67 ointer X is alig
4fd0: 6e 65 64 20 74 6f 20 61 6e 20 38 2d 62 79 74 65 ned to an 8-byte
4fe0: 20 62 6f 75 6e 64 61 72 79 2e 20 20 54 68 69 73 boundary. This
4ff0: 0a 2a 2a 20 6d 61 63 72 6f 20 69 73 20 75 73 65 .** macro is use
5000: 64 20 6f 6e 6c 79 20 77 69 74 68 69 6e 20 61 73 d only within as
5010: 73 65 72 74 28 29 20 74 6f 20 76 65 72 69 66 79 sert() to verify
5020: 20 74 68 61 74 20 74 68 65 20 63 6f 64 65 20 67 that the code g
5030: 65 74 73 0a 2a 2a 20 61 6c 6c 20 61 6c 69 67 6e ets.** all align
5040: 6d 65 6e 74 20 72 65 73 74 72 69 63 74 69 6f 6e ment restriction
5050: 73 20 63 6f 72 72 65 63 74 2e 0a 2a 2a 0a 2a 2a s correct..**.**
5060: 20 45 78 63 65 70 74 2c 20 69 66 20 53 51 4c 49 Except, if SQLI
5070: 54 45 5f 34 5f 42 59 54 45 5f 41 4c 49 47 4e 45 TE_4_BYTE_ALIGNE
5080: 44 5f 4d 41 4c 4c 4f 43 20 69 73 20 64 65 66 69 D_MALLOC is defi
5090: 6e 65 64 2c 20 74 68 65 6e 20 74 68 65 0a 2a 2a ned, then the.**
50a0: 20 75 6e 64 65 72 6c 79 69 6e 67 20 6d 61 6c 6c underlying mall
50b0: 6f 63 28 29 20 69 6d 70 6c 65 6d 65 6e 74 69 6f oc() implementio
50c0: 6e 20 6d 69 67 68 74 20 72 65 74 75 72 6e 20 75 n might return u
50d0: 73 20 34 2d 62 79 74 65 20 61 6c 69 67 6e 65 64 s 4-byte aligned
50e0: 0a 2a 2a 20 70 6f 69 6e 74 65 72 73 2e 20 20 49 .** pointers. I
50f0: 6e 20 74 68 61 74 20 63 61 73 65 2c 20 6f 6e 6c n that case, onl
5100: 79 20 76 65 72 69 66 79 20 34 2d 62 79 74 65 20 y verify 4-byte
5110: 61 6c 69 67 6e 6d 65 6e 74 2e 0a 2a 2f 0a 23 69 alignment..*/.#i
5120: 66 64 65 66 20 53 51 4c 49 54 45 5f 34 5f 42 59 fdef SQLITE_4_BY
5130: 54 45 5f 41 4c 49 47 4e 45 44 5f 4d 41 4c 4c 4f TE_ALIGNED_MALLO
5140: 43 0a 23 20 64 65 66 69 6e 65 20 45 49 47 48 54 C.# define EIGHT
5150: 5f 42 59 54 45 5f 41 4c 49 47 4e 4d 45 4e 54 28 _BYTE_ALIGNMENT(
5160: 58 29 20 20 20 28 28 28 28 63 68 61 72 2a 29 28 X) ((((char*)(
5170: 58 29 20 2d 20 28 63 68 61 72 2a 29 30 29 26 33 X) - (char*)0)&3
5180: 29 3d 3d 30 29 0a 23 65 6c 73 65 0a 23 20 64 65 )==0).#else.# de
5190: 66 69 6e 65 20 45 49 47 48 54 5f 42 59 54 45 5f fine EIGHT_BYTE_
51a0: 41 4c 49 47 4e 4d 45 4e 54 28 58 29 20 20 20 28 ALIGNMENT(X) (
51b0: 28 28 28 63 68 61 72 2a 29 28 58 29 20 2d 20 28 (((char*)(X) - (
51c0: 63 68 61 72 2a 29 30 29 26 37 29 3d 3d 30 29 0a char*)0)&7)==0).
51d0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 44 69 #endif../*.** Di
51e0: 73 61 62 6c 65 20 4d 4d 41 50 20 6f 6e 20 70 6c sable MMAP on pl
51f0: 61 74 66 6f 72 6d 73 20 77 68 65 72 65 20 69 74 atforms where it
5200: 20 69 73 20 6b 6e 6f 77 6e 20 74 6f 20 6e 6f 74 is known to not
5210: 20 77 6f 72 6b 0a 2a 2f 0a 23 69 66 20 64 65 66 work.*/.#if def
5220: 69 6e 65 64 28 5f 5f 4f 70 65 6e 42 53 44 5f 5f ined(__OpenBSD__
5230: 29 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f 5f 51 ) || defined(__Q
5240: 4e 58 4e 54 4f 5f 5f 29 0a 23 20 75 6e 64 65 66 NXNTO__).# undef
5250: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
5260: 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e 65 20 53 _SIZE.# define S
5270: 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 QLITE_MAX_MMAP_S
5280: 49 5a 45 20 30 0a 23 65 6e 64 69 66 0a 0a 2f 2a IZE 0.#endif../*
5290: 0a 2a 2a 20 44 65 66 61 75 6c 74 20 6d 61 78 69 .** Default maxi
52a0: 6d 75 6d 20 73 69 7a 65 20 6f 66 20 6d 65 6d 6f mum size of memo
52b0: 72 79 20 75 73 65 64 20 62 79 20 6d 65 6d 6f 72 ry used by memor
52c0: 79 2d 6d 61 70 70 65 64 20 49 2f 4f 20 69 6e 20 y-mapped I/O in
52d0: 74 68 65 20 56 46 53 0a 2a 2f 0a 23 69 66 64 65 the VFS.*/.#ifde
52e0: 66 20 5f 5f 41 50 50 4c 45 5f 5f 0a 23 20 69 6e f __APPLE__.# in
52f0: 63 6c 75 64 65 20 3c 54 61 72 67 65 74 43 6f 6e clude <TargetCon
5300: 64 69 74 69 6f 6e 61 6c 73 2e 68 3e 0a 23 20 69 ditionals.h>.# i
5310: 66 20 54 41 52 47 45 54 5f 4f 53 5f 49 50 48 4f f TARGET_OS_IPHO
5320: 4e 45 0a 23 20 20 20 75 6e 64 65 66 20 53 51 4c NE.# undef SQL
5330: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
5340: 45 0a 23 20 20 20 64 65 66 69 6e 65 20 53 51 4c E.# define SQL
5350: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
5360: 45 20 30 0a 23 20 65 6e 64 69 66 0a 23 65 6e 64 E 0.# endif.#end
5370: 69 66 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 if.#ifndef SQLIT
5380: 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 0a E_MAX_MMAP_SIZE.
5390: 23 20 69 66 20 64 65 66 69 6e 65 64 28 5f 5f 6c # if defined(__l
53a0: 69 6e 75 78 5f 5f 29 20 5c 0a 20 20 7c 7c 20 64 inux__) \. || d
53b0: 65 66 69 6e 65 64 28 5f 57 49 4e 33 32 29 20 5c efined(_WIN32) \
53c0: 0a 20 20 7c 7c 20 28 64 65 66 69 6e 65 64 28 5f . || (defined(_
53d0: 5f 41 50 50 4c 45 5f 5f 29 20 26 26 20 64 65 66 _APPLE__) && def
53e0: 69 6e 65 64 28 5f 5f 4d 41 43 48 5f 5f 29 29 20 ined(__MACH__))
53f0: 5c 0a 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 5f \. || defined(_
5400: 5f 73 75 6e 29 0a 23 20 20 20 64 65 66 69 6e 65 _sun).# define
5410: 20 53 51 4c 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 SQLITE_MAX_MMAP
5420: 5f 53 49 5a 45 20 30 78 37 66 66 66 30 30 30 30 _SIZE 0x7fff0000
5430: 20 20 2f 2a 20 32 31 34 37 34 31 38 31 31 32 20 /* 2147418112
5440: 2a 2f 0a 23 20 65 6c 73 65 0a 23 20 20 20 64 65 */.# else.# de
5450: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 58 5f fine SQLITE_MAX_
5460: 4d 4d 41 50 5f 53 49 5a 45 20 30 0a 23 20 65 6e MMAP_SIZE 0.# en
5470: 64 69 66 0a 23 20 64 65 66 69 6e 65 20 53 51 4c dif.# define SQL
5480: 49 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a ITE_MAX_MMAP_SIZ
5490: 45 5f 78 63 20 31 20 2f 2a 20 65 78 63 6c 75 64 E_xc 1 /* exclud
54a0: 65 20 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a e from ctime.c *
54b0: 2f 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 /.#endif../*.**
54c0: 54 68 65 20 64 65 66 61 75 6c 74 20 4d 4d 41 50 The default MMAP
54d0: 5f 53 49 5a 45 20 69 73 20 7a 65 72 6f 20 6f 6e _SIZE is zero on
54e0: 20 61 6c 6c 20 70 6c 61 74 66 6f 72 6d 73 2e 20 all platforms.
54f0: 20 4f 72 2c 20 65 76 65 6e 20 69 66 20 61 20 6c Or, even if a l
5500: 61 72 67 65 72 0a 2a 2a 20 64 65 66 61 75 6c 74 arger.** default
5510: 20 4d 4d 41 50 5f 53 49 5a 45 20 69 73 20 73 70 MMAP_SIZE is sp
5520: 65 63 69 66 69 65 64 20 61 74 20 63 6f 6d 70 69 ecified at compi
5530: 6c 65 2d 74 69 6d 65 2c 20 6d 61 6b 65 20 73 75 le-time, make su
5540: 72 65 20 74 68 61 74 20 69 74 20 64 6f 65 73 0a re that it does.
5550: 2a 2a 20 6e 6f 74 20 65 78 63 65 65 64 20 74 68 ** not exceed th
5560: 65 20 6d 61 78 69 6d 75 6d 20 6d 6d 61 70 20 73 e maximum mmap s
5570: 69 7a 65 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 ize..*/.#ifndef
5580: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 4d SQLITE_DEFAULT_M
5590: 4d 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 6e MAP_SIZE.# defin
55a0: 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 e SQLITE_DEFAULT
55b0: 5f 4d 4d 41 50 5f 53 49 5a 45 20 30 0a 23 20 64 _MMAP_SIZE 0.# d
55c0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 efine SQLITE_DEF
55d0: 41 55 4c 54 5f 4d 4d 41 50 5f 53 49 5a 45 5f 78 AULT_MMAP_SIZE_x
55e0: 63 20 31 20 20 2f 2a 20 45 78 63 6c 75 64 65 20 c 1 /* Exclude
55f0: 66 72 6f 6d 20 63 74 69 6d 65 2e 63 20 2a 2f 0a from ctime.c */.
5600: 23 65 6e 64 69 66 0a 23 69 66 20 53 51 4c 49 54 #endif.#if SQLIT
5610: 45 5f 44 45 46 41 55 4c 54 5f 4d 4d 41 50 5f 53 E_DEFAULT_MMAP_S
5620: 49 5a 45 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 4d IZE>SQLITE_MAX_M
5630: 4d 41 50 5f 53 49 5a 45 0a 23 20 75 6e 64 65 66 MAP_SIZE.# undef
5640: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f SQLITE_DEFAULT_
5650: 4d 4d 41 50 5f 53 49 5a 45 0a 23 20 64 65 66 69 MMAP_SIZE.# defi
5660: 6e 65 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c ne SQLITE_DEFAUL
5670: 54 5f 4d 4d 41 50 5f 53 49 5a 45 20 53 51 4c 49 T_MMAP_SIZE SQLI
5680: 54 45 5f 4d 41 58 5f 4d 4d 41 50 5f 53 49 5a 45 TE_MAX_MMAP_SIZE
5690: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4f .#endif../*.** O
56a0: 6e 6c 79 20 6f 6e 65 20 6f 66 20 53 51 4c 49 54 nly one of SQLIT
56b0: 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 20 6f E_ENABLE_STAT3 o
56c0: 72 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f r SQLITE_ENABLE_
56d0: 53 54 41 54 34 20 63 61 6e 20 62 65 20 64 65 66 STAT4 can be def
56e0: 69 6e 65 64 2e 0a 2a 2a 20 50 72 69 6f 72 69 74 ined..** Priorit
56f0: 79 20 69 73 20 67 69 76 65 6e 20 74 6f 20 53 51 y is given to SQ
5700: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
5710: 34 2e 20 20 49 66 20 65 69 74 68 65 72 20 61 72 4. If either ar
5720: 65 20 64 65 66 69 6e 65 64 2c 20 61 6c 73 6f 0a e defined, also.
5730: 2a 2a 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 ** define SQLITE
5740: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
5750: 5f 53 54 41 54 34 0a 2a 2f 0a 23 69 66 64 65 66 _STAT4.*/.#ifdef
5760: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
5770: 54 41 54 34 0a 23 20 75 6e 64 65 66 20 53 51 4c TAT4.# undef SQL
5780: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 ITE_ENABLE_STAT3
5790: 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 54 45 .# define SQLITE
57a0: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
57b0: 5f 53 54 41 54 34 20 31 0a 23 65 6c 69 66 20 53 _STAT4 1.#elif S
57c0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
57d0: 54 33 0a 23 20 64 65 66 69 6e 65 20 53 51 4c 49 T3.# define SQLI
57e0: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f TE_ENABLE_STAT3_
57f0: 4f 52 5f 53 54 41 54 34 20 31 0a 23 65 6c 69 66 OR_STAT4 1.#elif
5800: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
5810: 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 0a 23 20 TAT3_OR_STAT4.#
5820: 75 6e 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 undef SQLITE_ENA
5830: 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 BLE_STAT3_OR_STA
5840: 54 34 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a T4.#endif../*.**
5850: 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 An instance of
5860: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
5870: 72 75 63 74 75 72 65 20 69 73 20 75 73 65 64 20 ructure is used
5880: 74 6f 20 73 74 6f 72 65 20 74 68 65 20 62 75 73 to store the bus
5890: 79 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c y-handler.** cal
58a0: 6c 62 61 63 6b 20 66 6f 72 20 61 20 67 69 76 65 lback for a give
58b0: 6e 20 73 71 6c 69 74 65 20 68 61 6e 64 6c 65 2e n sqlite handle.
58c0: 20 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 71 6c 69 .**.** The sqli
58d0: 74 65 2e 62 75 73 79 48 61 6e 64 6c 65 72 20 6d te.busyHandler m
58e0: 65 6d 62 65 72 20 6f 66 20 74 68 65 20 73 71 6c ember of the sql
58f0: 69 74 65 20 73 74 72 75 63 74 20 63 6f 6e 74 61 ite struct conta
5900: 69 6e 73 20 74 68 65 20 62 75 73 79 0a 2a 2a 20 ins the busy.**
5910: 63 61 6c 6c 62 61 63 6b 20 66 6f 72 20 74 68 65 callback for the
5920: 20 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 database handle
5930: 2e 20 45 61 63 68 20 70 61 67 65 72 20 6f 70 65 . Each pager ope
5940: 6e 65 64 20 76 69 61 20 74 68 65 20 73 71 6c 69 ned via the sqli
5950: 74 65 0a 2a 2a 20 68 61 6e 64 6c 65 20 69 73 20 te.** handle is
5960: 70 61 73 73 65 64 20 61 20 70 6f 69 6e 74 65 72 passed a pointer
5970: 20 74 6f 20 73 71 6c 69 74 65 2e 62 75 73 79 48 to sqlite.busyH
5980: 61 6e 64 6c 65 72 2e 20 54 68 65 20 62 75 73 79 andler. The busy
5990: 2d 68 61 6e 64 6c 65 72 0a 2a 2a 20 63 61 6c 6c -handler.** call
59a0: 62 61 63 6b 20 69 73 20 63 75 72 72 65 6e 74 6c back is currentl
59b0: 79 20 69 6e 76 6f 6b 65 64 20 6f 6e 6c 79 20 66 y invoked only f
59c0: 72 6f 6d 20 77 69 74 68 69 6e 20 70 61 67 65 72 rom within pager
59d0: 2e 63 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 .c..*/.typedef s
59e0: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
59f0: 72 20 42 75 73 79 48 61 6e 64 6c 65 72 3b 0a 73 r BusyHandler;.s
5a00: 74 72 75 63 74 20 42 75 73 79 48 61 6e 64 6c 65 truct BusyHandle
5a10: 72 20 7b 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e r {. int (*xFun
5a20: 63 29 28 76 6f 69 64 20 2a 2c 69 6e 74 29 3b 20 c)(void *,int);
5a30: 20 2f 2a 20 54 68 65 20 62 75 73 79 20 63 61 6c /* The busy cal
5a40: 6c 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 lback */. void
5a50: 2a 70 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 *pArg;
5a60: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 /* First a
5a70: 72 67 20 74 6f 20 62 75 73 79 20 63 61 6c 6c 62 rg to busy callb
5a80: 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 75 ack */. int nBu
5a90: 73 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 sy;
5aa0: 20 20 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 /* Increment
5ab0: 65 64 20 77 69 74 68 20 65 61 63 68 20 62 75 73 ed with each bus
5ac0: 79 20 63 61 6c 6c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a y call */.};../*
5ad0: 0a 2a 2a 20 4e 61 6d 65 20 6f 66 20 74 68 65 20 .** Name of the
5ae0: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 master database
5af0: 74 61 62 6c 65 2e 20 20 54 68 65 20 6d 61 73 74 table. The mast
5b00: 65 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c er database tabl
5b10: 65 0a 2a 2a 20 69 73 20 61 20 73 70 65 63 69 61 e.** is a specia
5b20: 6c 20 74 61 62 6c 65 20 74 68 61 74 20 68 6f 6c l table that hol
5b30: 64 73 20 74 68 65 20 6e 61 6d 65 73 20 61 6e 64 ds the names and
5b40: 20 61 74 74 72 69 62 75 74 65 73 20 6f 66 20 61 attributes of a
5b50: 6c 6c 0a 2a 2a 20 75 73 65 72 20 74 61 62 6c 65 ll.** user table
5b60: 73 20 61 6e 64 20 69 6e 64 69 63 65 73 2e 0a 2a s and indices..*
5b70: 2f 0a 23 64 65 66 69 6e 65 20 4d 41 53 54 45 52 /.#define MASTER
5b80: 5f 4e 41 4d 45 20 20 20 20 20 20 20 22 73 71 6c _NAME "sql
5b90: 69 74 65 5f 6d 61 73 74 65 72 22 0a 23 64 65 66 ite_master".#def
5ba0: 69 6e 65 20 54 45 4d 50 5f 4d 41 53 54 45 52 5f ine TEMP_MASTER_
5bb0: 4e 41 4d 45 20 20 22 73 71 6c 69 74 65 5f 74 65 NAME "sqlite_te
5bc0: 6d 70 5f 6d 61 73 74 65 72 22 0a 0a 2f 2a 0a 2a mp_master"../*.*
5bd0: 2a 20 54 68 65 20 72 6f 6f 74 2d 70 61 67 65 20 * The root-page
5be0: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 64 61 of the master da
5bf0: 74 61 62 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2f tabase table..*/
5c00: 0a 23 64 65 66 69 6e 65 20 4d 41 53 54 45 52 5f .#define MASTER_
5c10: 52 4f 4f 54 20 20 20 20 20 20 20 31 0a 0a 2f 2a ROOT 1../*
5c20: 0a 2a 2a 20 54 68 65 20 6e 61 6d 65 20 6f 66 20 .** The name of
5c30: 74 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 the schema table
5c40: 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 43 48 ..*/.#define SCH
5c50: 45 4d 41 5f 54 41 42 4c 45 28 78 29 20 20 28 28 EMA_TABLE(x) ((
5c60: 21 4f 4d 49 54 5f 54 45 4d 50 44 42 29 26 26 28 !OMIT_TEMPDB)&&(
5c70: 78 3d 3d 31 29 3f 54 45 4d 50 5f 4d 41 53 54 45 x==1)?TEMP_MASTE
5c80: 52 5f 4e 41 4d 45 3a 4d 41 53 54 45 52 5f 4e 41 R_NAME:MASTER_NA
5c90: 4d 45 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 6f 6e ME)../*.** A con
5ca0: 76 65 6e 69 65 6e 63 65 20 6d 61 63 72 6f 20 74 venience macro t
5cb0: 68 61 74 20 72 65 74 75 72 6e 73 20 74 68 65 20 hat returns the
5cc0: 6e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e number of elemen
5cd0: 74 73 20 69 6e 0a 2a 2a 20 61 6e 20 61 72 72 61 ts in.** an arra
5ce0: 79 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 41 72 y..*/.#define Ar
5cf0: 72 61 79 53 69 7a 65 28 58 29 20 20 20 20 28 28 raySize(X) ((
5d00: 69 6e 74 29 28 73 69 7a 65 6f 66 28 58 29 2f 73 int)(sizeof(X)/s
5d10: 69 7a 65 6f 66 28 58 5b 30 5d 29 29 29 0a 0a 2f izeof(X[0])))../
5d20: 2a 0a 2a 2a 20 44 65 74 65 72 6d 69 6e 65 20 69 *.** Determine i
5d30: 66 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 69 f the argument i
5d40: 73 20 61 20 70 6f 77 65 72 20 6f 66 20 74 77 6f s a power of two
5d50: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 49 73 50 6f .*/.#define IsPo
5d60: 77 65 72 4f 66 54 77 6f 28 58 29 20 28 28 28 58 werOfTwo(X) (((X
5d70: 29 26 28 28 58 29 2d 31 29 29 3d 3d 30 29 0a 0a )&((X)-1))==0)..
5d80: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow
5d90: 69 6e 67 20 76 61 6c 75 65 20 61 73 20 61 20 64 ing value as a d
5da0: 65 73 74 72 75 63 74 6f 72 20 6d 65 61 6e 73 20 estructor means
5db0: 74 6f 20 75 73 65 20 73 71 6c 69 74 65 33 44 62 to use sqlite3Db
5dc0: 46 72 65 65 28 29 2e 0a 2a 2a 20 54 68 65 20 73 Free()..** The s
5dd0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 29 20 72 qlite3DbFree() r
5de0: 6f 75 74 69 6e 65 20 72 65 71 75 69 72 65 73 20 outine requires
5df0: 74 77 6f 20 70 61 72 61 6d 65 74 65 72 73 20 69 two parameters i
5e00: 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 0a 2a nstead of the .*
5e10: 2a 20 6f 6e 65 20 70 61 72 61 6d 65 74 65 72 20 * one parameter
5e20: 74 68 61 74 20 64 65 73 74 72 75 63 74 6f 72 73 that destructors
5e30: 20 6e 6f 72 6d 61 6c 6c 79 20 77 61 6e 74 2e 20 normally want.
5e40: 20 53 6f 20 77 65 20 68 61 76 65 20 74 6f 20 69 So we have to i
5e50: 6e 74 72 6f 64 75 63 65 20 0a 2a 2a 20 74 68 69 ntroduce .** thi
5e60: 73 20 6d 61 67 69 63 20 76 61 6c 75 65 20 74 68 s magic value th
5e70: 61 74 20 74 68 65 20 63 6f 64 65 20 6b 6e 6f 77 at the code know
5e80: 73 20 74 6f 20 68 61 6e 64 6c 65 20 64 69 66 66 s to handle diff
5e90: 65 72 65 6e 74 6c 79 2e 20 20 41 6e 79 20 0a 2a erently. Any .*
5ea0: 2a 20 70 6f 69 6e 74 65 72 20 77 69 6c 6c 20 77 * pointer will w
5eb0: 6f 72 6b 20 68 65 72 65 20 61 73 20 6c 6f 6e 67 ork here as long
5ec0: 20 61 73 20 69 74 20 69 73 20 64 69 73 74 69 6e as it is distin
5ed0: 63 74 20 66 72 6f 6d 20 53 51 4c 49 54 45 5f 53 ct from SQLITE_S
5ee0: 54 41 54 49 43 0a 2a 2a 20 61 6e 64 20 53 51 4c TATIC.** and SQL
5ef0: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 2e 0a 2a ITE_TRANSIENT..*
5f00: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
5f10: 5f 44 59 4e 41 4d 49 43 20 20 20 28 28 73 71 6c _DYNAMIC ((sql
5f20: 69 74 65 33 5f 64 65 73 74 72 75 63 74 6f 72 5f ite3_destructor_
5f30: 74 79 70 65 29 73 71 6c 69 74 65 33 4d 61 6c 6c type)sqlite3Mall
5f40: 6f 63 53 69 7a 65 29 0a 0a 2f 2a 0a 2a 2a 20 57 ocSize)../*.** W
5f50: 68 65 6e 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f hen SQLITE_OMIT_
5f60: 57 53 44 20 69 73 20 64 65 66 69 6e 65 64 2c 20 WSD is defined,
5f70: 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 it means that th
5f80: 65 20 74 61 72 67 65 74 20 70 6c 61 74 66 6f 72 e target platfor
5f90: 6d 20 64 6f 65 73 0a 2a 2a 20 6e 6f 74 20 73 75 m does.** not su
5fa0: 70 70 6f 72 74 20 57 72 69 74 61 62 6c 65 20 53 pport Writable S
5fb0: 74 61 74 69 63 20 44 61 74 61 20 28 57 53 44 29 tatic Data (WSD)
5fc0: 20 73 75 63 68 20 61 73 20 67 6c 6f 62 61 6c 20 such as global
5fd0: 61 6e 64 20 73 74 61 74 69 63 20 76 61 72 69 61 and static varia
5fe0: 62 6c 65 73 2e 0a 2a 2a 20 41 6c 6c 20 76 61 72 bles..** All var
5ff0: 69 61 62 6c 65 73 20 6d 75 73 74 20 65 69 74 68 iables must eith
6000: 65 72 20 62 65 20 6f 6e 20 74 68 65 20 73 74 61 er be on the sta
6010: 63 6b 20 6f 72 20 64 79 6e 61 6d 69 63 61 6c 6c ck or dynamicall
6020: 79 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f 6d y allocated from
6030: 0a 2a 2a 20 74 68 65 20 68 65 61 70 2e 20 20 57 .** the heap. W
6040: 68 65 6e 20 57 53 44 20 69 73 20 75 6e 73 75 70 hen WSD is unsup
6050: 70 6f 72 74 65 64 2c 20 74 68 65 20 76 61 72 69 ported, the vari
6060: 61 62 6c 65 20 64 65 63 6c 61 72 61 74 69 6f 6e able declaration
6070: 73 20 73 63 61 74 74 65 72 65 64 0a 2a 2a 20 74 s scattered.** t
6080: 68 72 6f 75 67 68 6f 75 74 20 74 68 65 20 53 51 hroughout the SQ
6090: 4c 69 74 65 20 63 6f 64 65 20 6d 75 73 74 20 62 Lite code must b
60a0: 65 63 6f 6d 65 20 63 6f 6e 73 74 61 6e 74 73 20 ecome constants
60b0: 69 6e 73 74 65 61 64 2e 20 20 54 68 65 20 53 51 instead. The SQ
60c0: 4c 49 54 45 5f 57 53 44 0a 2a 2a 20 6d 61 63 72 LITE_WSD.** macr
60d0: 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 68 o is used for th
60e0: 69 73 20 70 75 72 70 6f 73 65 2e 20 20 41 6e 64 is purpose. And
60f0: 20 69 6e 73 74 65 61 64 20 6f 66 20 72 65 66 65 instead of refe
6100: 72 65 6e 63 69 6e 67 20 74 68 65 20 76 61 72 69 rencing the vari
6110: 61 62 6c 65 0a 2a 2a 20 64 69 72 65 63 74 6c 79 able.** directly
6120: 2c 20 77 65 20 75 73 65 20 69 74 73 20 63 6f 6e , we use its con
6130: 73 74 61 6e 74 20 61 73 20 61 20 6b 65 79 20 74 stant as a key t
6140: 6f 20 6c 6f 6f 6b 75 70 20 74 68 65 20 72 75 6e o lookup the run
6150: 2d 74 69 6d 65 20 61 6c 6c 6f 63 61 74 65 64 0a -time allocated.
6160: 2a 2a 20 62 75 66 66 65 72 20 74 68 61 74 20 68 ** buffer that h
6170: 6f 6c 64 73 20 72 65 61 6c 20 76 61 72 69 61 62 olds real variab
6180: 6c 65 2e 20 20 54 68 65 20 63 6f 6e 73 74 61 6e le. The constan
6190: 74 20 69 73 20 61 6c 73 6f 20 74 68 65 20 69 6e t is also the in
61a0: 69 74 69 61 6c 69 7a 65 72 0a 2a 2a 20 66 6f 72 itializer.** for
61b0: 20 74 68 65 20 72 75 6e 2d 74 69 6d 65 20 61 6c the run-time al
61c0: 6c 6f 63 61 74 65 64 20 62 75 66 66 65 72 2e 0a located buffer..
61d0: 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 75 73 75 **.** In the usu
61e0: 61 6c 20 63 61 73 65 20 77 68 65 72 65 20 57 53 al case where WS
61f0: 44 20 69 73 20 73 75 70 70 6f 72 74 65 64 2c 20 D is supported,
6200: 74 68 65 20 53 51 4c 49 54 45 5f 57 53 44 20 61 the SQLITE_WSD a
6210: 6e 64 20 47 4c 4f 42 41 4c 0a 2a 2a 20 6d 61 63 nd GLOBAL.** mac
6220: 72 6f 73 20 62 65 63 6f 6d 65 20 6e 6f 2d 6f 70 ros become no-op
6230: 73 20 61 6e 64 20 68 61 76 65 20 7a 65 72 6f 20 s and have zero
6240: 70 65 72 66 6f 72 6d 61 6e 63 65 20 69 6d 70 61 performance impa
6250: 63 74 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ct..*/.#ifdef SQ
6260: 4c 49 54 45 5f 4f 4d 49 54 5f 57 53 44 0a 20 20 LITE_OMIT_WSD.
6270: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 57 #define SQLITE_W
6280: 53 44 20 63 6f 6e 73 74 0a 20 20 23 64 65 66 69 SD const. #defi
6290: 6e 65 20 47 4c 4f 42 41 4c 28 74 2c 76 29 20 28 ne GLOBAL(t,v) (
62a0: 2a 28 74 2a 29 73 71 6c 69 74 65 33 5f 77 73 64 *(t*)sqlite3_wsd
62b0: 5f 66 69 6e 64 28 28 76 6f 69 64 2a 29 26 28 76 _find((void*)&(v
62c0: 29 2c 20 73 69 7a 65 6f 66 28 76 29 29 29 0a 20 ), sizeof(v))).
62d0: 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
62e0: 47 6c 6f 62 61 6c 43 6f 6e 66 69 67 20 47 4c 4f GlobalConfig GLO
62f0: 42 41 4c 28 73 74 72 75 63 74 20 53 71 6c 69 74 BAL(struct Sqlit
6300: 65 33 43 6f 6e 66 69 67 2c 20 73 71 6c 69 74 65 e3Config, sqlite
6310: 33 43 6f 6e 66 69 67 29 0a 20 20 69 6e 74 20 73 3Config). int s
6320: 71 6c 69 74 65 33 5f 77 73 64 5f 69 6e 69 74 28 qlite3_wsd_init(
6330: 69 6e 74 20 4e 2c 20 69 6e 74 20 4a 29 3b 0a 20 int N, int J);.
6340: 20 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 5f 77 void *sqlite3_w
6350: 73 64 5f 66 69 6e 64 28 76 6f 69 64 20 2a 4b 2c sd_find(void *K,
6360: 20 69 6e 74 20 4c 29 3b 0a 23 65 6c 73 65 0a 20 int L);.#else.
6370: 20 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f #define SQLITE_
6380: 57 53 44 20 0a 20 20 23 64 65 66 69 6e 65 20 47 WSD . #define G
6390: 4c 4f 42 41 4c 28 74 2c 76 29 20 76 0a 20 20 23 LOBAL(t,v) v. #
63a0: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 47 6c define sqlite3Gl
63b0: 6f 62 61 6c 43 6f 6e 66 69 67 20 73 71 6c 69 74 obalConfig sqlit
63c0: 65 33 43 6f 6e 66 69 67 0a 23 65 6e 64 69 66 0a e3Config.#endif.
63d0: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f ./*.** The follo
63e0: 77 69 6e 67 20 6d 61 63 72 6f 73 20 61 72 65 20 wing macros are
63f0: 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 73 73 used to suppress
6400: 20 63 6f 6d 70 69 6c 65 72 20 77 61 72 6e 69 6e compiler warnin
6410: 67 73 20 61 6e 64 20 74 6f 0a 2a 2a 20 6d 61 6b gs and to.** mak
6420: 65 20 69 74 20 63 6c 65 61 72 20 74 6f 20 68 75 e it clear to hu
6430: 6d 61 6e 20 72 65 61 64 65 72 73 20 77 68 65 6e man readers when
6440: 20 61 20 66 75 6e 63 74 69 6f 6e 20 70 61 72 61 a function para
6450: 6d 65 74 65 72 20 69 73 20 64 65 6c 69 62 65 72 meter is deliber
6460: 61 74 65 6c 79 20 0a 2a 2a 20 6c 65 66 74 20 75 ately .** left u
6470: 6e 75 73 65 64 20 77 69 74 68 69 6e 20 74 68 65 nused within the
6480: 20 62 6f 64 79 20 6f 66 20 61 20 66 75 6e 63 74 body of a funct
6490: 69 6f 6e 2e 20 54 68 69 73 20 75 73 75 61 6c 6c ion. This usuall
64a0: 79 20 68 61 70 70 65 6e 73 20 77 68 65 6e 0a 2a y happens when.*
64b0: 2a 20 61 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 * a function is
64c0: 63 61 6c 6c 65 64 20 76 69 61 20 61 20 66 75 6e called via a fun
64d0: 63 74 69 6f 6e 20 70 6f 69 6e 74 65 72 2e 20 46 ction pointer. F
64e0: 6f 72 20 65 78 61 6d 70 6c 65 20 74 68 65 20 0a or example the .
64f0: 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f ** implementatio
6500: 6e 20 6f 66 20 61 6e 20 53 51 4c 20 61 67 67 72 n of an SQL aggr
6510: 65 67 61 74 65 20 73 74 65 70 20 63 61 6c 6c 62 egate step callb
6520: 61 63 6b 20 6d 61 79 20 6e 6f 74 20 75 73 65 20 ack may not use
6530: 74 68 65 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 the.** parameter
6540: 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 65 20 indicating the
6550: 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 75 6d 65 number of argume
6560: 6e 74 73 20 70 61 73 73 65 64 20 74 6f 20 74 68 nts passed to th
6570: 65 20 61 67 67 72 65 67 61 74 65 2c 0a 2a 2a 20 e aggregate,.**
6580: 69 66 20 69 74 20 6b 6e 6f 77 73 20 74 68 61 74 if it knows that
6590: 20 74 68 69 73 20 69 73 20 65 6e 66 6f 72 63 65 this is enforce
65a0: 64 20 65 6c 73 65 77 68 65 72 65 2e 0a 2a 2a 0a d elsewhere..**.
65b0: 2a 2a 20 57 68 65 6e 20 61 20 66 75 6e 63 74 69 ** When a functi
65c0: 6f 6e 20 70 61 72 61 6d 65 74 65 72 20 69 73 20 on parameter is
65d0: 6e 6f 74 20 75 73 65 64 20 61 74 20 61 6c 6c 20 not used at all
65e0: 77 69 74 68 69 6e 20 74 68 65 20 62 6f 64 79 20 within the body
65f0: 6f 66 20 61 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a of a function,.*
6600: 2a 20 69 74 20 69 73 20 67 65 6e 65 72 61 6c 6c * it is generall
6610: 79 20 6e 61 6d 65 64 20 22 4e 6f 74 55 73 65 64 y named "NotUsed
6620: 22 20 6f 72 20 22 4e 6f 74 55 73 65 64 32 22 20 " or "NotUsed2"
6630: 74 6f 20 6d 61 6b 65 20 74 68 69 6e 67 73 20 65 to make things e
6640: 76 65 6e 20 63 6c 65 61 72 65 72 2e 0a 2a 2a 20 ven clearer..**
6650: 48 6f 77 65 76 65 72 2c 20 74 68 65 73 65 20 6d However, these m
6660: 61 63 72 6f 73 20 6d 61 79 20 61 6c 73 6f 20 62 acros may also b
6670: 65 20 75 73 65 64 20 74 6f 20 73 75 70 70 72 65 e used to suppre
6680: 73 73 20 77 61 72 6e 69 6e 67 73 20 72 65 6c 61 ss warnings rela
6690: 74 65 64 20 74 6f 0a 2a 2a 20 70 61 72 61 6d 65 ted to.** parame
66a0: 74 65 72 73 20 74 68 61 74 20 6d 61 79 20 6f 72 ters that may or
66b0: 20 6d 61 79 20 6e 6f 74 20 62 65 20 75 73 65 64 may not be used
66c0: 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 63 6f depending on co
66d0: 6d 70 69 6c 61 74 69 6f 6e 20 6f 70 74 69 6f 6e mpilation option
66e0: 73 2e 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c s..** For exampl
66f0: 65 20 74 68 6f 73 65 20 70 61 72 61 6d 65 74 65 e those paramete
6700: 72 73 20 6f 6e 6c 79 20 75 73 65 64 20 69 6e 20 rs only used in
6710: 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d 65 assert() stateme
6720: 6e 74 73 2e 20 49 6e 20 74 68 65 73 65 0a 2a 2a nts. In these.**
6730: 20 63 61 73 65 73 20 74 68 65 20 70 61 72 61 6d cases the param
6740: 65 74 65 72 73 20 61 72 65 20 6e 61 6d 65 64 20 eters are named
6750: 61 73 20 70 65 72 20 74 68 65 20 75 73 75 61 6c as per the usual
6760: 20 63 6f 6e 76 65 6e 74 69 6f 6e 73 2e 0a 2a 2f conventions..*/
6770: 0a 23 64 65 66 69 6e 65 20 55 4e 55 53 45 44 5f .#define UNUSED_
6780: 50 41 52 41 4d 45 54 45 52 28 78 29 20 28 76 6f PARAMETER(x) (vo
6790: 69 64 29 28 78 29 0a 23 64 65 66 69 6e 65 20 55 id)(x).#define U
67a0: 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52 32 NUSED_PARAMETER2
67b0: 28 78 2c 79 29 20 55 4e 55 53 45 44 5f 50 41 52 (x,y) UNUSED_PAR
67c0: 41 4d 45 54 45 52 28 78 29 2c 55 4e 55 53 45 44 AMETER(x),UNUSED
67d0: 5f 50 41 52 41 4d 45 54 45 52 28 79 29 0a 0a 2f _PARAMETER(y)../
67e0: 2a 0a 2a 2a 20 46 6f 72 77 61 72 64 20 72 65 66 *.** Forward ref
67f0: 65 72 65 6e 63 65 73 20 74 6f 20 73 74 72 75 63 erences to struc
6800: 74 75 72 65 73 0a 2a 2f 0a 74 79 70 65 64 65 66 tures.*/.typedef
6810: 20 73 74 72 75 63 74 20 41 67 67 49 6e 66 6f 20 struct AggInfo
6820: 41 67 67 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 AggInfo;.typedef
6830: 20 73 74 72 75 63 74 20 41 75 74 68 43 6f 6e 74 struct AuthCont
6840: 65 78 74 20 41 75 74 68 43 6f 6e 74 65 78 74 3b ext AuthContext;
6850: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6860: 41 75 74 6f 69 6e 63 49 6e 66 6f 20 41 75 74 6f AutoincInfo Auto
6870: 69 6e 63 49 6e 66 6f 3b 0a 74 79 70 65 64 65 66 incInfo;.typedef
6880: 20 73 74 72 75 63 74 20 42 69 74 76 65 63 20 42 struct Bitvec B
6890: 69 74 76 65 63 3b 0a 74 79 70 65 64 65 66 20 73 itvec;.typedef s
68a0: 74 72 75 63 74 20 43 6f 6c 6c 53 65 71 20 43 6f truct CollSeq Co
68b0: 6c 6c 53 65 71 3b 0a 74 79 70 65 64 65 66 20 73 llSeq;.typedef s
68c0: 74 72 75 63 74 20 43 6f 6c 75 6d 6e 20 43 6f 6c truct Column Col
68d0: 75 6d 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 umn;.typedef str
68e0: 75 63 74 20 44 62 20 44 62 3b 0a 74 79 70 65 64 uct Db Db;.typed
68f0: 65 66 20 73 74 72 75 63 74 20 53 63 68 65 6d 61 ef struct Schema
6900: 20 53 63 68 65 6d 61 3b 0a 74 79 70 65 64 65 66 Schema;.typedef
6910: 20 73 74 72 75 63 74 20 45 78 70 72 20 45 78 70 struct Expr Exp
6920: 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 r;.typedef struc
6930: 74 20 45 78 70 72 4c 69 73 74 20 45 78 70 72 4c t ExprList ExprL
6940: 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ist;.typedef str
6950: 75 63 74 20 45 78 70 72 53 70 61 6e 20 45 78 70 uct ExprSpan Exp
6960: 72 53 70 61 6e 3b 0a 74 79 70 65 64 65 66 20 73 rSpan;.typedef s
6970: 74 72 75 63 74 20 46 4b 65 79 20 46 4b 65 79 3b truct FKey FKey;
6980: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6990: 46 75 6e 63 44 65 73 74 72 75 63 74 6f 72 20 46 FuncDestructor F
69a0: 75 6e 63 44 65 73 74 72 75 63 74 6f 72 3b 0a 74 uncDestructor;.t
69b0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 ypedef struct Fu
69c0: 6e 63 44 65 66 20 46 75 6e 63 44 65 66 3b 0a 74 ncDef FuncDef;.t
69d0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 75 ypedef struct Fu
69e0: 6e 63 44 65 66 48 61 73 68 20 46 75 6e 63 44 65 ncDefHash FuncDe
69f0: 66 48 61 73 68 3b 0a 74 79 70 65 64 65 66 20 73 fHash;.typedef s
6a00: 74 72 75 63 74 20 49 64 4c 69 73 74 20 49 64 4c truct IdList IdL
6a10: 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ist;.typedef str
6a20: 75 63 74 20 49 6e 64 65 78 20 49 6e 64 65 78 3b uct Index Index;
6a30: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6a40: 49 6e 64 65 78 53 61 6d 70 6c 65 20 49 6e 64 65 IndexSample Inde
6a50: 78 53 61 6d 70 6c 65 3b 0a 74 79 70 65 64 65 66 xSample;.typedef
6a60: 20 73 74 72 75 63 74 20 4b 65 79 43 6c 61 73 73 struct KeyClass
6a70: 20 4b 65 79 43 6c 61 73 73 3b 0a 74 79 70 65 64 KeyClass;.typed
6a80: 65 66 20 73 74 72 75 63 74 20 4b 65 79 49 6e 66 ef struct KeyInf
6a90: 6f 20 4b 65 79 49 6e 66 6f 3b 0a 74 79 70 65 64 o KeyInfo;.typed
6aa0: 65 66 20 73 74 72 75 63 74 20 4c 6f 6f 6b 61 73 ef struct Lookas
6ab0: 69 64 65 20 4c 6f 6f 6b 61 73 69 64 65 3b 0a 74 ide Lookaside;.t
6ac0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 4c 6f ypedef struct Lo
6ad0: 6f 6b 61 73 69 64 65 53 6c 6f 74 20 4c 6f 6f 6b okasideSlot Look
6ae0: 61 73 69 64 65 53 6c 6f 74 3b 0a 74 79 70 65 64 asideSlot;.typed
6af0: 65 66 20 73 74 72 75 63 74 20 4d 6f 64 75 6c 65 ef struct Module
6b00: 20 4d 6f 64 75 6c 65 3b 0a 74 79 70 65 64 65 66 Module;.typedef
6b10: 20 73 74 72 75 63 74 20 4e 61 6d 65 43 6f 6e 74 struct NameCont
6b20: 65 78 74 20 4e 61 6d 65 43 6f 6e 74 65 78 74 3b ext NameContext;
6b30: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6b40: 50 61 72 73 65 20 50 61 72 73 65 3b 0a 74 79 70 Parse Parse;.typ
6b50: 65 64 65 66 20 73 74 72 75 63 74 20 50 72 65 55 edef struct PreU
6b60: 70 64 61 74 65 20 50 72 65 55 70 64 61 74 65 3b pdate PreUpdate;
6b70: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6b80: 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 PrintfArguments
6b90: 50 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 73 3b PrintfArguments;
6ba0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6bb0: 52 6f 77 53 65 74 20 52 6f 77 53 65 74 3b 0a 74 RowSet RowSet;.t
6bc0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 61 ypedef struct Sa
6bd0: 76 65 70 6f 69 6e 74 20 53 61 76 65 70 6f 69 6e vepoint Savepoin
6be0: 74 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 t;.typedef struc
6bf0: 74 20 53 65 6c 65 63 74 20 53 65 6c 65 63 74 3b t Select Select;
6c00: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6c10: 53 65 6c 65 63 74 44 65 73 74 20 53 65 6c 65 63 SelectDest Selec
6c20: 74 44 65 73 74 3b 0a 74 79 70 65 64 65 66 20 73 tDest;.typedef s
6c30: 74 72 75 63 74 20 53 72 63 4c 69 73 74 20 53 72 truct SrcList Sr
6c40: 63 4c 69 73 74 3b 0a 74 79 70 65 64 65 66 20 73 cList;.typedef s
6c50: 74 72 75 63 74 20 53 74 72 41 63 63 75 6d 20 53 truct StrAccum S
6c60: 74 72 41 63 63 75 6d 3b 0a 74 79 70 65 64 65 66 trAccum;.typedef
6c70: 20 73 74 72 75 63 74 20 54 61 62 6c 65 20 54 61 struct Table Ta
6c80: 62 6c 65 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ble;.typedef str
6c90: 75 63 74 20 54 61 62 6c 65 4c 6f 63 6b 20 54 61 uct TableLock Ta
6ca0: 62 6c 65 4c 6f 63 6b 3b 0a 74 79 70 65 64 65 66 bleLock;.typedef
6cb0: 20 73 74 72 75 63 74 20 54 6f 6b 65 6e 20 54 6f struct Token To
6cc0: 6b 65 6e 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ken;.typedef str
6cd0: 75 63 74 20 54 72 69 67 67 65 72 20 54 72 69 67 uct Trigger Trig
6ce0: 67 65 72 3b 0a 74 79 70 65 64 65 66 20 73 74 72 ger;.typedef str
6cf0: 75 63 74 20 54 72 69 67 67 65 72 50 72 67 20 54 uct TriggerPrg T
6d00: 72 69 67 67 65 72 50 72 67 3b 0a 74 79 70 65 64 riggerPrg;.typed
6d10: 65 66 20 73 74 72 75 63 74 20 54 72 69 67 67 65 ef struct Trigge
6d20: 72 53 74 65 70 20 54 72 69 67 67 65 72 53 74 65 rStep TriggerSte
6d30: 70 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 p;.typedef struc
6d40: 74 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 t UnpackedRecord
6d50: 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 3b UnpackedRecord;
6d60: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6d70: 56 54 61 62 6c 65 20 56 54 61 62 6c 65 3b 0a 74 VTable VTable;.t
6d80: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 56 74 ypedef struct Vt
6d90: 61 62 43 74 78 20 56 74 61 62 43 74 78 3b 0a 74 abCtx VtabCtx;.t
6da0: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 57 61 ypedef struct Wa
6db0: 6c 6b 65 72 20 57 61 6c 6b 65 72 3b 0a 74 79 70 lker Walker;.typ
6dc0: 65 64 65 66 20 73 74 72 75 63 74 20 57 68 65 72 edef struct Wher
6dd0: 65 49 6e 66 6f 20 57 68 65 72 65 49 6e 66 6f 3b eInfo WhereInfo;
6de0: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 .typedef struct
6df0: 57 69 74 68 20 57 69 74 68 3b 0a 0a 2f 2a 0a 2a With With;../*.*
6e00: 2a 20 44 65 66 65 72 20 73 6f 75 72 63 69 6e 67 * Defer sourcing
6e10: 20 76 64 62 65 2e 68 20 61 6e 64 20 62 74 72 65 vdbe.h and btre
6e20: 65 2e 68 20 75 6e 74 69 6c 20 61 66 74 65 72 20 e.h until after
6e30: 74 68 65 20 22 75 38 22 20 61 6e 64 20 0a 2a 2a the "u8" and .**
6e40: 20 22 42 75 73 79 48 61 6e 64 6c 65 72 22 20 74 "BusyHandler" t
6e50: 79 70 65 64 65 66 73 2e 20 76 64 62 65 2e 68 20 ypedefs. vdbe.h
6e60: 61 6c 73 6f 20 72 65 71 75 69 72 65 73 20 61 20 also requires a
6e70: 66 65 77 20 6f 66 20 74 68 65 20 6f 70 61 71 75 few of the opaqu
6e80: 65 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 74 79 70 e.** pointer typ
6e90: 65 73 20 28 69 2e 65 2e 20 46 75 6e 63 44 65 66 es (i.e. FuncDef
6ea0: 29 20 64 65 66 69 6e 65 64 20 61 62 6f 76 65 2e ) defined above.
6eb0: 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 62 74 .*/.#include "bt
6ec0: 72 65 65 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 ree.h".#include
6ed0: 22 76 64 62 65 2e 68 22 0a 23 69 6e 63 6c 75 64 "vdbe.h".#includ
6ee0: 65 20 22 70 61 67 65 72 2e 68 22 0a 23 69 6e 63 e "pager.h".#inc
6ef0: 6c 75 64 65 20 22 70 63 61 63 68 65 2e 68 22 0a lude "pcache.h".
6f00: 0a 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 .#include "os.h"
6f10: 0a 23 69 6e 63 6c 75 64 65 20 22 6d 75 74 65 78 .#include "mutex
6f20: 2e 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 .h".../*.** Each
6f30: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 74 database file t
6f40: 6f 20 62 65 20 61 63 63 65 73 73 65 64 20 62 79 o be accessed by
6f50: 20 74 68 65 20 73 79 73 74 65 6d 20 69 73 20 61 the system is a
6f60: 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 n instance.** of
6f70: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
6f80: 74 72 75 63 74 75 72 65 2e 20 20 54 68 65 72 65 tructure. There
6f90: 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79 20 74 77 are normally tw
6fa0: 6f 20 6f 66 20 74 68 65 73 65 20 73 74 72 75 63 o of these struc
6fb0: 74 75 72 65 73 0a 2a 2a 20 69 6e 20 74 68 65 20 tures.** in the
6fc0: 73 71 6c 69 74 65 2e 61 44 62 5b 5d 20 61 72 72 sqlite.aDb[] arr
6fd0: 61 79 2e 20 20 61 44 62 5b 30 5d 20 69 73 20 74 ay. aDb[0] is t
6fe0: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 he main database
6ff0: 20 66 69 6c 65 20 61 6e 64 0a 2a 2a 20 61 44 62 file and.** aDb
7000: 5b 31 5d 20 69 73 20 74 68 65 20 64 61 74 61 62 [1] is the datab
7010: 61 73 65 20 66 69 6c 65 20 75 73 65 64 20 74 6f ase file used to
7020: 20 68 6f 6c 64 20 74 65 6d 70 6f 72 61 72 79 20 hold temporary
7030: 74 61 62 6c 65 73 2e 20 20 41 64 64 69 74 69 6f tables. Additio
7040: 6e 61 6c 0a 2a 2a 20 64 61 74 61 62 61 73 65 73 nal.** databases
7050: 20 6d 61 79 20 62 65 20 61 74 74 61 63 68 65 64 may be attached
7060: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 44 62 20 7b ..*/.struct Db {
7070: 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 . char *zName;
7080: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 /* Name
7090: 6f 66 20 74 68 69 73 20 64 61 74 61 62 61 73 65 of this database
70a0: 20 2a 2f 0a 20 20 42 74 72 65 65 20 2a 70 42 74 */. Btree *pBt
70b0: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ; /* Th
70c0: 65 20 42 2a 54 72 65 65 20 73 74 72 75 63 74 75 e B*Tree structu
70d0: 72 65 20 66 6f 72 20 74 68 69 73 20 64 61 74 61 re for this data
70e0: 62 61 73 65 20 66 69 6c 65 20 2a 2f 0a 20 20 75 base file */. u
70f0: 38 20 73 61 66 65 74 79 5f 6c 65 76 65 6c 3b 20 8 safety_level;
7100: 20 20 20 20 2f 2a 20 48 6f 77 20 61 67 67 72 65 /* How aggre
7110: 73 73 69 76 65 20 61 74 20 73 79 6e 63 69 6e 67 ssive at syncing
7120: 20 64 61 74 61 20 74 6f 20 64 69 73 6b 20 2a 2f data to disk */
7130: 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 65 . Schema *pSche
7140: 6d 61 3b 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 ma; /* Point
7150: 65 72 20 74 6f 20 64 61 74 61 62 61 73 65 20 73 er to database s
7160: 63 68 65 6d 61 20 28 70 6f 73 73 69 62 6c 79 20 chema (possibly
7170: 73 68 61 72 65 64 29 20 2a 2f 0a 7d 3b 0a 0a 2f shared) */.};../
7180: 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
7190: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
71a0: 67 20 73 74 72 75 63 74 75 72 65 20 73 74 6f 72 g structure stor
71b0: 65 73 20 61 20 64 61 74 61 62 61 73 65 20 73 63 es a database sc
71c0: 68 65 6d 61 2e 0a 2a 2a 0a 2a 2a 20 4d 6f 73 74 hema..**.** Most
71d0: 20 53 63 68 65 6d 61 20 6f 62 6a 65 63 74 73 20 Schema objects
71e0: 61 72 65 20 61 73 73 6f 63 69 61 74 65 64 20 77 are associated w
71f0: 69 74 68 20 61 20 42 74 72 65 65 2e 20 20 54 68 ith a Btree. Th
7200: 65 20 65 78 63 65 70 74 69 6f 6e 20 69 73 0a 2a e exception is.*
7210: 2a 20 74 68 65 20 53 63 68 65 6d 61 20 66 6f 72 * the Schema for
7220: 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62 61 the TEMP databa
7230: 65 73 20 28 73 71 6c 69 74 65 33 2e 61 44 62 5b es (sqlite3.aDb[
7240: 31 5d 29 20 77 68 69 63 68 20 69 73 20 66 72 65 1]) which is fre
7250: 65 2d 73 74 61 6e 64 69 6e 67 2e 0a 2a 2a 20 49 e-standing..** I
7260: 6e 20 73 68 61 72 65 64 20 63 61 63 68 65 20 6d n shared cache m
7270: 6f 64 65 2c 20 61 20 73 69 6e 67 6c 65 20 53 63 ode, a single Sc
7280: 68 65 6d 61 20 6f 62 6a 65 63 74 20 63 61 6e 20 hema object can
7290: 62 65 20 73 68 61 72 65 64 20 62 79 20 6d 75 6c be shared by mul
72a0: 74 69 70 6c 65 0a 2a 2a 20 42 74 72 65 65 73 20 tiple.** Btrees
72b0: 74 68 61 74 20 72 65 66 65 72 20 74 6f 20 74 68 that refer to th
72c0: 65 20 73 61 6d 65 20 75 6e 64 65 72 6c 79 69 6e e same underlyin
72d0: 67 20 42 74 53 68 61 72 65 64 20 6f 62 6a 65 63 g BtShared objec
72e0: 74 2e 0a 2a 2a 20 0a 2a 2a 20 53 63 68 65 6d 61 t..** .** Schema
72f0: 20 6f 62 6a 65 63 74 73 20 61 72 65 20 61 75 74 objects are aut
7300: 6f 6d 61 74 69 63 61 6c 6c 79 20 64 65 61 6c 6c omatically deall
7310: 6f 63 61 74 65 64 20 77 68 65 6e 20 74 68 65 20 ocated when the
7320: 6c 61 73 74 20 42 74 72 65 65 20 74 68 61 74 0a last Btree that.
7330: 2a 2a 20 72 65 66 65 72 65 6e 63 65 73 20 74 68 ** references th
7340: 65 6d 20 69 73 20 64 65 73 74 72 6f 79 65 64 2e em is destroyed.
7350: 20 20 20 54 68 65 20 54 45 4d 50 20 53 63 68 65 The TEMP Sche
7360: 6d 61 20 69 73 20 6d 61 6e 75 61 6c 6c 79 20 66 ma is manually f
7370: 72 65 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 reed by.** sqlit
7380: 65 33 5f 63 6c 6f 73 65 28 29 2e 0a 2a 0a 2a 2a e3_close()..*.**
7390: 20 41 20 74 68 72 65 61 64 20 6d 75 73 74 20 62 A thread must b
73a0: 65 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 74 65 e holding a mute
73b0: 78 20 6f 6e 20 74 68 65 20 63 6f 72 72 65 73 70 x on the corresp
73c0: 6f 6e 64 69 6e 67 20 42 74 72 65 65 20 69 6e 20 onding Btree in
73d0: 6f 72 64 65 72 0a 2a 2a 20 74 6f 20 61 63 63 65 order.** to acce
73e0: 73 73 20 53 63 68 65 6d 61 20 63 6f 6e 74 65 6e ss Schema conten
73f0: 74 2e 20 20 54 68 69 73 20 69 6d 70 6c 69 65 73 t. This implies
7400: 20 74 68 61 74 20 74 68 65 20 74 68 72 65 61 64 that the thread
7410: 20 6d 75 73 74 20 61 6c 73 6f 20 62 65 0a 2a 2a must also be.**
7420: 20 68 6f 6c 64 69 6e 67 20 61 20 6d 75 74 65 78 holding a mutex
7430: 20 6f 6e 20 74 68 65 20 73 71 6c 69 74 65 33 20 on the sqlite3
7440: 63 6f 6e 6e 65 63 74 69 6f 6e 20 70 6f 69 6e 74 connection point
7450: 65 72 20 74 68 61 74 20 6f 77 6e 73 20 74 68 65 er that owns the
7460: 20 42 74 72 65 65 2e 0a 2a 2a 20 46 6f 72 20 61 Btree..** For a
7470: 20 54 45 4d 50 20 53 63 68 65 6d 61 2c 20 6f 6e TEMP Schema, on
7480: 6c 79 20 74 68 65 20 63 6f 6e 6e 65 63 74 69 6f ly the connectio
7490: 6e 20 6d 75 74 65 78 20 69 73 20 72 65 71 75 69 n mutex is requi
74a0: 72 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 red..*/.struct S
74b0: 63 68 65 6d 61 20 7b 0a 20 20 69 6e 74 20 73 63 chema {. int sc
74c0: 68 65 6d 61 5f 63 6f 6f 6b 69 65 3b 20 20 20 2f hema_cookie; /
74d0: 2a 20 44 61 74 61 62 61 73 65 20 73 63 68 65 6d * Database schem
74e0: 61 20 76 65 72 73 69 6f 6e 20 6e 75 6d 62 65 72 a version number
74f0: 20 66 6f 72 20 74 68 69 73 20 66 69 6c 65 20 2a for this file *
7500: 2f 0a 20 20 69 6e 74 20 69 47 65 6e 65 72 61 74 /. int iGenerat
7510: 69 6f 6e 3b 20 20 20 20 20 2f 2a 20 47 65 6e 65 ion; /* Gene
7520: 72 61 74 69 6f 6e 20 63 6f 75 6e 74 65 72 2e 20 ration counter.
7530: 20 49 6e 63 72 65 6d 65 6e 74 65 64 20 77 69 74 Incremented wit
7540: 68 20 65 61 63 68 20 63 68 61 6e 67 65 20 2a 2f h each change */
7550: 0a 20 20 48 61 73 68 20 74 62 6c 48 61 73 68 3b . Hash tblHash;
7560: 20 20 20 20 20 20 20 20 2f 2a 20 41 6c 6c 20 74 /* All t
7570: 61 62 6c 65 73 20 69 6e 64 65 78 65 64 20 62 79 ables indexed by
7580: 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 73 68 20 name */. Hash
7590: 69 64 78 48 61 73 68 3b 20 20 20 20 20 20 20 20 idxHash;
75a0: 2f 2a 20 41 6c 6c 20 28 6e 61 6d 65 64 29 20 69 /* All (named) i
75b0: 6e 64 69 63 65 73 20 69 6e 64 65 78 65 64 20 62 ndices indexed b
75c0: 79 20 6e 61 6d 65 20 2a 2f 0a 20 20 48 61 73 68 y name */. Hash
75d0: 20 74 72 69 67 48 61 73 68 3b 20 20 20 20 20 20 trigHash;
75e0: 20 2f 2a 20 41 6c 6c 20 74 72 69 67 67 65 72 73 /* All triggers
75f0: 20 69 6e 64 65 78 65 64 20 62 79 20 6e 61 6d 65 indexed by name
7600: 20 2a 2f 0a 20 20 48 61 73 68 20 66 6b 65 79 48 */. Hash fkeyH
7610: 61 73 68 3b 20 20 20 20 20 20 20 2f 2a 20 41 6c ash; /* Al
7620: 6c 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 62 l foreign keys b
7630: 79 20 72 65 66 65 72 65 6e 63 65 64 20 74 61 62 y referenced tab
7640: 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 54 61 62 le name */. Tab
7650: 6c 65 20 2a 70 53 65 71 54 61 62 3b 20 20 20 20 le *pSeqTab;
7660: 20 20 2f 2a 20 54 68 65 20 73 71 6c 69 74 65 5f /* The sqlite_
7670: 73 65 71 75 65 6e 63 65 20 74 61 62 6c 65 20 75 sequence table u
7680: 73 65 64 20 62 79 20 41 55 54 4f 49 4e 43 52 45 sed by AUTOINCRE
7690: 4d 45 4e 54 20 2a 2f 0a 20 20 75 38 20 66 69 6c MENT */. u8 fil
76a0: 65 5f 66 6f 72 6d 61 74 3b 20 20 20 20 20 20 2f e_format; /
76b0: 2a 20 53 63 68 65 6d 61 20 66 6f 72 6d 61 74 20 * Schema format
76c0: 76 65 72 73 69 6f 6e 20 66 6f 72 20 74 68 69 73 version for this
76d0: 20 66 69 6c 65 20 2a 2f 0a 20 20 75 38 20 65 6e file */. u8 en
76e0: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
76f0: 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 6e 67 /* Text encoding
7700: 20 75 73 65 64 20 62 79 20 74 68 69 73 20 64 61 used by this da
7710: 74 61 62 61 73 65 20 2a 2f 0a 20 20 75 31 36 20 tabase */. u16
7720: 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 flags;
7730: 20 2f 2a 20 46 6c 61 67 73 20 61 73 73 6f 63 69 /* Flags associ
7740: 61 74 65 64 20 77 69 74 68 20 74 68 69 73 20 73 ated with this s
7750: 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 20 63 chema */. int c
7760: 61 63 68 65 5f 73 69 7a 65 3b 20 20 20 20 20 20 ache_size;
7770: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 /* Number of pag
7780: 65 73 20 74 6f 20 75 73 65 20 69 6e 20 74 68 65 es to use in the
7790: 20 63 61 63 68 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a cache */.};../*
77a0: 0a 2a 2a 20 54 68 65 73 65 20 6d 61 63 72 6f 73 .** These macros
77b0: 20 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f 20 can be used to
77c0: 74 65 73 74 2c 20 73 65 74 2c 20 6f 72 20 63 6c test, set, or cl
77d0: 65 61 72 20 62 69 74 73 20 69 6e 20 74 68 65 20 ear bits in the
77e0: 0a 2a 2a 20 44 62 2e 70 53 63 68 65 6d 61 2d 3e .** Db.pSchema->
77f0: 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a flags field..*/.
7800: 23 64 65 66 69 6e 65 20 44 62 48 61 73 50 72 6f #define DbHasPro
7810: 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 20 20 perty(D,I,P)
7820: 20 28 28 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 (((D)->aDb[I].p
7830: 53 63 68 65 6d 61 2d 3e 66 6c 61 67 73 26 28 50 Schema->flags&(P
7840: 29 29 3d 3d 28 50 29 29 0a 23 64 65 66 69 6e 65 ))==(P)).#define
7850: 20 44 62 48 61 73 41 6e 79 50 72 6f 70 65 72 74 DbHasAnyPropert
7860: 79 28 44 2c 49 2c 50 29 20 20 28 28 28 44 29 2d y(D,I,P) (((D)-
7870: 3e 61 44 62 5b 49 5d 2e 70 53 63 68 65 6d 61 2d >aDb[I].pSchema-
7880: 3e 66 6c 61 67 73 26 28 50 29 29 21 3d 30 29 0a >flags&(P))!=0).
7890: 23 64 65 66 69 6e 65 20 44 62 53 65 74 50 72 6f #define DbSetPro
78a0: 70 65 72 74 79 28 44 2c 49 2c 50 29 20 20 20 20 perty(D,I,P)
78b0: 20 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 63 (D)->aDb[I].pSc
78c0: 68 65 6d 61 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 hema->flags|=(P)
78d0: 0a 23 64 65 66 69 6e 65 20 44 62 43 6c 65 61 72 .#define DbClear
78e0: 50 72 6f 70 65 72 74 79 28 44 2c 49 2c 50 29 20 Property(D,I,P)
78f0: 20 20 28 44 29 2d 3e 61 44 62 5b 49 5d 2e 70 53 (D)->aDb[I].pS
7900: 63 68 65 6d 61 2d 3e 66 6c 61 67 73 26 3d 7e 28 chema->flags&=~(
7910: 50 29 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 77 65 P)../*.** Allowe
7920: 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 68 65 d values for the
7930: 20 44 42 2e 70 53 63 68 65 6d 61 2d 3e 66 6c 61 DB.pSchema->fla
7940: 67 73 20 66 69 65 6c 64 2e 0a 2a 2a 0a 2a 2a 20 gs field..**.**
7950: 54 68 65 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 The DB_SchemaLoa
7960: 64 65 64 20 66 6c 61 67 20 69 73 20 73 65 74 20 ded flag is set
7970: 61 66 74 65 72 20 74 68 65 20 64 61 74 61 62 61 after the databa
7980: 73 65 20 73 63 68 65 6d 61 20 68 61 73 20 62 65 se schema has be
7990: 65 6e 0a 2a 2a 20 72 65 61 64 20 69 6e 74 6f 20 en.** read into
79a0: 69 6e 74 65 72 6e 61 6c 20 68 61 73 68 20 74 61 internal hash ta
79b0: 62 6c 65 73 2e 0a 2a 2a 0a 2a 2a 20 44 42 5f 55 bles..**.** DB_U
79c0: 6e 72 65 73 65 74 56 69 65 77 73 20 6d 65 61 6e nresetViews mean
79d0: 73 20 74 68 61 74 20 6f 6e 65 20 6f 72 20 6d 6f s that one or mo
79e0: 72 65 20 76 69 65 77 73 20 68 61 76 65 20 63 6f re views have co
79f0: 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 68 61 74 0a lumn names that.
7a00: 2a 2a 20 68 61 76 65 20 62 65 65 6e 20 66 69 6c ** have been fil
7a10: 6c 65 64 20 6f 75 74 2e 20 20 49 66 20 74 68 65 led out. If the
7a20: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 2c schema changes,
7a30: 20 74 68 65 73 65 20 63 6f 6c 75 6d 6e 20 6e 61 these column na
7a40: 6d 65 73 20 6d 69 67 68 74 0a 2a 2a 20 63 68 61 mes might.** cha
7a50: 6e 67 65 73 20 61 6e 64 20 73 6f 20 74 68 65 20 nges and so the
7a60: 76 69 65 77 20 77 69 6c 6c 20 6e 65 65 64 20 74 view will need t
7a70: 6f 20 62 65 20 72 65 73 65 74 2e 0a 2a 2f 0a 23 o be reset..*/.#
7a80: 64 65 66 69 6e 65 20 44 42 5f 53 63 68 65 6d 61 define DB_Schema
7a90: 4c 6f 61 64 65 64 20 20 20 20 30 78 30 30 30 31 Loaded 0x0001
7aa0: 20 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 61 20 /* The schema
7ab0: 68 61 73 20 62 65 65 6e 20 6c 6f 61 64 65 64 20 has been loaded
7ac0: 2a 2f 0a 23 64 65 66 69 6e 65 20 44 42 5f 55 6e */.#define DB_Un
7ad0: 72 65 73 65 74 56 69 65 77 73 20 20 20 20 30 78 resetViews 0x
7ae0: 30 30 30 32 20 20 2f 2a 20 53 6f 6d 65 20 76 69 0002 /* Some vi
7af0: 65 77 73 20 68 61 76 65 20 64 65 66 69 6e 65 64 ews have defined
7b00: 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 2a 2f column names */
7b10: 0a 23 64 65 66 69 6e 65 20 44 42 5f 45 6d 70 74 .#define DB_Empt
7b20: 79 20 20 20 20 20 20 20 20 20 20 20 30 78 30 30 y 0x00
7b30: 30 34 20 20 2f 2a 20 54 68 65 20 66 69 6c 65 20 04 /* The file
7b40: 69 73 20 65 6d 70 74 79 20 28 6c 65 6e 67 74 68 is empty (length
7b50: 20 30 20 62 79 74 65 73 29 20 2a 2f 0a 0a 2f 2a 0 bytes) */../*
7b60: 0a 2a 2a 20 54 68 65 20 6e 75 6d 62 65 72 20 6f .** The number o
7b70: 66 20 64 69 66 66 65 72 65 6e 74 20 6b 69 6e 64 f different kind
7b80: 73 20 6f 66 20 74 68 69 6e 67 73 20 74 68 61 74 s of things that
7b90: 20 63 61 6e 20 62 65 20 6c 69 6d 69 74 65 64 0a can be limited.
7ba0: 2a 2a 20 75 73 69 6e 67 20 74 68 65 20 73 71 6c ** using the sql
7bb0: 69 74 65 33 5f 6c 69 6d 69 74 28 29 20 69 6e 74 ite3_limit() int
7bc0: 65 72 66 61 63 65 2e 0a 2a 2f 0a 23 64 65 66 69 erface..*/.#defi
7bd0: 6e 65 20 53 51 4c 49 54 45 5f 4e 5f 4c 49 4d 49 ne SQLITE_N_LIMI
7be0: 54 20 28 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f T (SQLITE_LIMIT_
7bf0: 54 52 49 47 47 45 52 5f 44 45 50 54 48 2b 31 29 TRIGGER_DEPTH+1)
7c00: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 6b 61 73 69 64 ../*.** Lookasid
7c10: 65 20 6d 61 6c 6c 6f 63 20 69 73 20 61 20 73 65 e malloc is a se
7c20: 74 20 6f 66 20 66 69 78 65 64 2d 73 69 7a 65 20 t of fixed-size
7c30: 62 75 66 66 65 72 73 20 74 68 61 74 20 63 61 6e buffers that can
7c40: 20 62 65 20 75 73 65 64 0a 2a 2a 20 74 6f 20 73 be used.** to s
7c50: 61 74 69 73 66 79 20 73 6d 61 6c 6c 20 74 72 61 atisfy small tra
7c60: 6e 73 69 65 6e 74 20 6d 65 6d 6f 72 79 20 61 6c nsient memory al
7c70: 6c 6f 63 61 74 69 6f 6e 20 72 65 71 75 65 73 74 location request
7c80: 73 20 66 6f 72 20 6f 62 6a 65 63 74 73 0a 2a 2a s for objects.**
7c90: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
7ca0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 a particular da
7cb0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
7cc0: 6e 2e 20 20 54 68 65 20 75 73 65 20 6f 66 0a 2a n. The use of.*
7cd0: 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 61 6c 6c * lookaside mall
7ce0: 6f 63 20 70 72 6f 76 69 64 65 73 20 61 20 73 69 oc provides a si
7cf0: 67 6e 69 66 69 63 61 6e 74 20 70 65 72 66 6f 72 gnificant perfor
7d00: 6d 61 6e 63 65 20 65 6e 68 61 6e 63 65 6d 65 6e mance enhancemen
7d10: 74 0a 2a 2a 20 28 61 70 70 72 6f 78 20 31 30 25 t.** (approx 10%
7d20: 29 20 62 79 20 61 76 6f 69 64 69 6e 67 20 6e 75 ) by avoiding nu
7d30: 6d 65 72 6f 75 73 20 6d 61 6c 6c 6f 63 2f 66 72 merous malloc/fr
7d40: 65 65 20 72 65 71 75 65 73 74 73 20 77 68 69 6c ee requests whil
7d50: 65 20 70 61 72 73 69 6e 67 0a 2a 2a 20 53 51 4c e parsing.** SQL
7d60: 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a 0a statements..**.
7d70: 2a 2a 20 54 68 65 20 4c 6f 6f 6b 61 73 69 64 65 ** The Lookaside
7d80: 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 73 structure holds
7d90: 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e 20 69 configuration i
7da0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 nformation about
7db0: 20 74 68 65 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 the.** lookasid
7dc0: 65 20 6d 61 6c 6c 6f 63 20 73 75 62 73 79 73 74 e malloc subsyst
7dd0: 65 6d 2e 20 20 45 61 63 68 20 61 76 61 69 6c 61 em. Each availa
7de0: 62 6c 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 ble memory alloc
7df0: 61 74 69 6f 6e 20 69 6e 0a 2a 2a 20 74 68 65 20 ation in.** the
7e00: 6c 6f 6f 6b 61 73 69 64 65 20 73 75 62 73 79 73 lookaside subsys
7e10: 74 65 6d 20 69 73 20 73 74 6f 72 65 64 20 6f 6e tem is stored on
7e20: 20 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f a linked list o
7e30: 66 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 0a f LookasideSlot.
7e40: 2a 2a 20 6f 62 6a 65 63 74 73 2e 0a 2a 2a 0a 2a ** objects..**.*
7e50: 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 61 6c 6c 6f * Lookaside allo
7e60: 63 61 74 69 6f 6e 73 20 61 72 65 20 6f 6e 6c 79 cations are only
7e70: 20 61 6c 6c 6f 77 65 64 20 66 6f 72 20 6f 62 6a allowed for obj
7e80: 65 63 74 73 20 74 68 61 74 20 61 72 65 20 61 73 ects that are as
7e90: 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69 74 68 sociated.** with
7ea0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 64 61 a particular da
7eb0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
7ec0: 6e 2e 20 20 48 65 6e 63 65 2c 20 73 63 68 65 6d n. Hence, schem
7ed0: 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 61 a information ca
7ee0: 6e 6e 6f 74 0a 2a 2a 20 62 65 20 73 74 6f 72 65 nnot.** be store
7ef0: 64 20 69 6e 20 6c 6f 6f 6b 61 73 69 64 65 20 62 d in lookaside b
7f00: 65 63 61 75 73 65 20 69 6e 20 73 68 61 72 65 64 ecause in shared
7f10: 20 63 61 63 68 65 20 6d 6f 64 65 20 74 68 65 20 cache mode the
7f20: 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 schema informati
7f30: 6f 6e 0a 2a 2a 20 69 73 20 73 68 61 72 65 64 20 on.** is shared
7f40: 62 79 20 6d 75 6c 74 69 70 6c 65 20 64 61 74 61 by multiple data
7f50: 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 73 base connections
7f60: 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 20 77 68 . Therefore, wh
7f70: 69 6c 65 20 70 61 72 73 69 6e 67 0a 2a 2a 20 73 ile parsing.** s
7f80: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f chema informatio
7f90: 6e 2c 20 74 68 65 20 4c 6f 6f 6b 61 73 69 64 65 n, the Lookaside
7fa0: 2e 62 45 6e 61 62 6c 65 64 20 66 6c 61 67 20 69 .bEnabled flag i
7fb0: 73 20 63 6c 65 61 72 65 64 20 73 6f 20 74 68 61 s cleared so tha
7fc0: 74 0a 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 61 t.** lookaside a
7fd0: 6c 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 20 6e llocations are n
7fe0: 6f 74 20 75 73 65 64 20 74 6f 20 63 6f 6e 73 74 ot used to const
7ff0: 72 75 63 74 20 74 68 65 20 73 63 68 65 6d 61 20 ruct the schema
8000: 6f 62 6a 65 63 74 73 2e 0a 2a 2f 0a 73 74 72 75 objects..*/.stru
8010: 63 74 20 4c 6f 6f 6b 61 73 69 64 65 20 7b 0a 20 ct Lookaside {.
8020: 20 75 31 36 20 73 7a 3b 20 20 20 20 20 20 20 20 u16 sz;
8030: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 /* Size
8040: 20 6f 66 20 65 61 63 68 20 62 75 66 66 65 72 20 of each buffer
8050: 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 20 75 38 in bytes */. u8
8060: 20 62 45 6e 61 62 6c 65 64 3b 20 20 20 20 20 20 bEnabled;
8070: 20 20 20 20 20 20 2f 2a 20 46 61 6c 73 65 20 74 /* False t
8080: 6f 20 64 69 73 61 62 6c 65 20 6e 65 77 20 6c 6f o disable new lo
8090: 6f 6b 61 73 69 64 65 20 61 6c 6c 6f 63 61 74 69 okaside allocati
80a0: 6f 6e 73 20 2a 2f 0a 20 20 75 38 20 62 4d 61 6c ons */. u8 bMal
80b0: 6c 6f 63 65 64 3b 20 20 20 20 20 20 20 20 20 20 loced;
80c0: 20 2f 2a 20 54 72 75 65 20 69 66 20 70 53 74 61 /* True if pSta
80d0: 72 74 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d rt obtained from
80e0: 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 sqlite3_malloc(
80f0: 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 75 74 3b ) */. int nOut;
8100: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8110: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 75 66 66 * Number of buff
8120: 65 72 73 20 63 75 72 72 65 6e 74 6c 79 20 63 68 ers currently ch
8130: 65 63 6b 65 64 20 6f 75 74 20 2a 2f 0a 20 20 69 ecked out */. i
8140: 6e 74 20 6d 78 4f 75 74 3b 20 20 20 20 20 20 20 nt mxOut;
8150: 20 20 20 20 20 20 20 2f 2a 20 48 69 67 68 77 61 /* Highwa
8160: 74 65 72 20 6d 61 72 6b 20 66 6f 72 20 6e 4f 75 ter mark for nOu
8170: 74 20 2a 2f 0a 20 20 69 6e 74 20 61 6e 53 74 61 t */. int anSta
8180: 74 5b 33 5d 3b 20 20 20 20 20 20 20 20 20 20 2f t[3]; /
8190: 2a 20 30 3a 20 68 69 74 73 2e 20 20 31 3a 20 73 * 0: hits. 1: s
81a0: 69 7a 65 20 6d 69 73 73 65 73 2e 20 20 32 3a 20 ize misses. 2:
81b0: 66 75 6c 6c 20 6d 69 73 73 65 73 20 2a 2f 0a 20 full misses */.
81c0: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a LookasideSlot *
81d0: 70 46 72 65 65 3b 20 20 20 2f 2a 20 4c 69 73 74 pFree; /* List
81e0: 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 62 75 of available bu
81f0: 66 66 65 72 73 20 2a 2f 0a 20 20 76 6f 69 64 20 ffers */. void
8200: 2a 70 53 74 61 72 74 3b 20 20 20 20 20 20 20 20 *pStart;
8210: 20 20 20 2f 2a 20 46 69 72 73 74 20 62 79 74 65 /* First byte
8220: 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 6d 65 of available me
8230: 6d 6f 72 79 20 73 70 61 63 65 20 2a 2f 0a 20 20 mory space */.
8240: 76 6f 69 64 20 2a 70 45 6e 64 3b 20 20 20 20 20 void *pEnd;
8250: 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 /* First
8260: 20 62 79 74 65 20 70 61 73 74 20 65 6e 64 20 6f byte past end o
8270: 66 20 61 76 61 69 6c 61 62 6c 65 20 73 70 61 63 f available spac
8280: 65 20 2a 2f 0a 7d 3b 0a 73 74 72 75 63 74 20 4c e */.};.struct L
8290: 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 7b 0a 20 ookasideSlot {.
82a0: 20 4c 6f 6f 6b 61 73 69 64 65 53 6c 6f 74 20 2a LookasideSlot *
82b0: 70 4e 65 78 74 3b 20 20 20 20 2f 2a 20 4e 65 78 pNext; /* Nex
82c0: 74 20 62 75 66 66 65 72 20 69 6e 20 74 68 65 20 t buffer in the
82d0: 6c 69 73 74 20 6f 66 20 66 72 65 65 20 62 75 66 list of free buf
82e0: 66 65 72 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a fers */.};../*.*
82f0: 2a 20 41 20 68 61 73 68 20 74 61 62 6c 65 20 66 * A hash table f
8300: 6f 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 or function defi
8310: 6e 69 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 48 nitions..**.** H
8320: 61 73 68 20 65 61 63 68 20 46 75 6e 63 44 65 66 ash each FuncDef
8330: 20 73 74 72 75 63 74 75 72 65 20 69 6e 74 6f 20 structure into
8340: 6f 6e 65 20 6f 66 20 74 68 65 20 46 75 6e 63 44 one of the FuncD
8350: 65 66 48 61 73 68 2e 61 5b 5d 20 73 6c 6f 74 73 efHash.a[] slots
8360: 2e 0a 2a 2a 20 43 6f 6c 6c 69 73 69 6f 6e 73 20 ..** Collisions
8370: 61 72 65 20 6f 6e 20 74 68 65 20 46 75 6e 63 44 are on the FuncD
8380: 65 66 2e 70 48 61 73 68 20 63 68 61 69 6e 2e 0a ef.pHash chain..
8390: 2a 2f 0a 73 74 72 75 63 74 20 46 75 6e 63 44 65 */.struct FuncDe
83a0: 66 48 61 73 68 20 7b 0a 20 20 46 75 6e 63 44 65 fHash {. FuncDe
83b0: 66 20 2a 61 5b 32 33 5d 3b 20 20 20 20 20 20 20 f *a[23];
83c0: 2f 2a 20 48 61 73 68 20 74 61 62 6c 65 20 66 6f /* Hash table fo
83d0: 72 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 7d r functions */.}
83e0: 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 64 61 ;../*.** Each da
83f0: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
8400: 6e 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 n is an instance
8410: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
8420: 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a g structure..*/.
8430: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 20 7b struct sqlite3 {
8440: 0a 20 20 73 71 6c 69 74 65 33 5f 76 66 73 20 2a . sqlite3_vfs *
8450: 70 56 66 73 3b 20 20 20 20 20 20 20 20 20 20 20 pVfs;
8460: 20 2f 2a 20 4f 53 20 49 6e 74 65 72 66 61 63 65 /* OS Interface
8470: 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 56 64 62 */. struct Vdb
8480: 65 20 2a 70 56 64 62 65 3b 20 20 20 20 20 20 20 e *pVdbe;
8490: 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 61 /* List of a
84a0: 63 74 69 76 65 20 76 69 72 74 75 61 6c 20 6d 61 ctive virtual ma
84b0: 63 68 69 6e 65 73 20 2a 2f 0a 20 20 43 6f 6c 6c chines */. Coll
84c0: 53 65 71 20 2a 70 44 66 6c 74 43 6f 6c 6c 3b 20 Seq *pDfltColl;
84d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
84e0: 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 default collati
84f0: 6e 67 20 73 65 71 75 65 6e 63 65 20 28 42 49 4e ng sequence (BIN
8500: 41 52 59 29 20 2a 2f 0a 20 20 73 71 6c 69 74 65 ARY) */. sqlite
8510: 33 5f 6d 75 74 65 78 20 2a 6d 75 74 65 78 3b 20 3_mutex *mutex;
8520: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 /* Conne
8530: 63 74 69 6f 6e 20 6d 75 74 65 78 20 2a 2f 0a 20 ction mutex */.
8540: 20 44 62 20 2a 61 44 62 3b 20 20 20 20 20 20 20 Db *aDb;
8550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8560: 2a 20 41 6c 6c 20 62 61 63 6b 65 6e 64 73 20 2a * All backends *
8570: 2f 0a 20 20 69 6e 74 20 6e 44 62 3b 20 20 20 20 /. int nDb;
8580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8590: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 /* Number of b
85a0: 61 63 6b 65 6e 64 73 20 63 75 72 72 65 6e 74 6c ackends currentl
85b0: 79 20 69 6e 20 75 73 65 20 2a 2f 0a 20 20 69 6e y in use */. in
85c0: 74 20 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 t flags;
85d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d /* M
85e0: 69 73 63 65 6c 6c 61 6e 65 6f 75 73 20 66 6c 61 iscellaneous fla
85f0: 67 73 2e 20 53 65 65 20 62 65 6c 6f 77 20 2a 2f gs. See below */
8600: 0a 20 20 69 36 34 20 6c 61 73 74 52 6f 77 69 64 . i64 lastRowid
8610: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
8620: 20 2f 2a 20 52 4f 57 49 44 20 6f 66 20 6d 6f 73 /* ROWID of mos
8630: 74 20 72 65 63 65 6e 74 20 69 6e 73 65 72 74 20 t recent insert
8640: 28 73 65 65 20 61 62 6f 76 65 29 20 2a 2f 0a 20 (see above) */.
8650: 20 69 36 34 20 73 7a 4d 6d 61 70 3b 20 20 20 20 i64 szMmap;
8660: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8670: 2a 20 44 65 66 61 75 6c 74 20 6d 6d 61 70 5f 73 * Default mmap_s
8680: 69 7a 65 20 73 65 74 74 69 6e 67 20 2a 2f 0a 20 ize setting */.
8690: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 6f 70 unsigned int op
86a0: 65 6e 46 6c 61 67 73 3b 20 20 20 20 20 20 20 2f enFlags; /
86b0: 2a 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 * Flags passed t
86c0: 6f 20 73 71 6c 69 74 65 33 5f 76 66 73 2e 78 4f o sqlite3_vfs.xO
86d0: 70 65 6e 28 29 20 2a 2f 0a 20 20 69 6e 74 20 65 pen() */. int e
86e0: 72 72 43 6f 64 65 3b 20 20 20 20 20 20 20 20 20 rrCode;
86f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 6f 73 74 /* Most
8700: 20 72 65 63 65 6e 74 20 65 72 72 6f 72 20 63 6f recent error co
8710: 64 65 20 28 53 51 4c 49 54 45 5f 2a 29 20 2a 2f de (SQLITE_*) */
8720: 0a 20 20 69 6e 74 20 65 72 72 4d 61 73 6b 3b 20 . int errMask;
8730: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8740: 20 2f 2a 20 26 20 72 65 73 75 6c 74 20 63 6f 64 /* & result cod
8750: 65 73 20 77 69 74 68 20 74 68 69 73 20 62 65 66 es with this bef
8760: 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20 2a 2f ore returning */
8770: 0a 20 20 75 31 36 20 64 62 4f 70 74 46 6c 61 67 . u16 dbOptFlag
8780: 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s;
8790: 20 2f 2a 20 46 6c 61 67 73 20 74 6f 20 65 6e 61 /* Flags to ena
87a0: 62 6c 65 2f 64 69 73 61 62 6c 65 20 6f 70 74 69 ble/disable opti
87b0: 6d 69 7a 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 75 mizations */. u
87c0: 38 20 61 75 74 6f 43 6f 6d 6d 69 74 3b 20 20 20 8 autoCommit;
87d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
87e0: 54 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 The auto-commit
87f0: 66 6c 61 67 2e 20 2a 2f 0a 20 20 75 38 20 74 65 flag. */. u8 te
8800: 6d 70 5f 73 74 6f 72 65 3b 20 20 20 20 20 20 20 mp_store;
8810: 20 20 20 20 20 20 20 20 20 2f 2a 20 31 3a 20 66 /* 1: f
8820: 69 6c 65 20 32 3a 20 6d 65 6d 6f 72 79 20 30 3a ile 2: memory 0:
8830: 20 64 65 66 61 75 6c 74 20 2a 2f 0a 20 20 75 38 default */. u8
8840: 20 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 3b 20 20 mallocFailed;
8850: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
8860: 72 75 65 20 69 66 20 77 65 20 68 61 76 65 20 73 rue if we have s
8870: 65 65 6e 20 61 20 6d 61 6c 6c 6f 63 20 66 61 69 een a malloc fai
8880: 6c 75 72 65 20 2a 2f 0a 20 20 75 38 20 64 66 6c lure */. u8 dfl
8890: 74 4c 6f 63 6b 4d 6f 64 65 3b 20 20 20 20 20 20 tLockMode;
88a0: 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 75 /* Defau
88b0: 6c 74 20 6c 6f 63 6b 69 6e 67 2d 6d 6f 64 65 20 lt locking-mode
88c0: 66 6f 72 20 61 74 74 61 63 68 65 64 20 64 62 73 for attached dbs
88d0: 20 2a 2f 0a 20 20 73 69 67 6e 65 64 20 63 68 61 */. signed cha
88e0: 72 20 6e 65 78 74 41 75 74 6f 76 61 63 3b 20 20 r nextAutovac;
88f0: 20 20 20 20 2f 2a 20 41 75 74 6f 76 61 63 20 73 /* Autovac s
8900: 65 74 74 69 6e 67 20 61 66 74 65 72 20 56 41 43 etting after VAC
8910: 55 55 4d 20 69 66 20 3e 3d 30 20 2a 2f 0a 20 20 UUM if >=0 */.
8920: 75 38 20 73 75 70 70 72 65 73 73 45 72 72 3b 20 u8 suppressErr;
8930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
8940: 20 44 6f 20 6e 6f 74 20 69 73 73 75 65 20 65 72 Do not issue er
8950: 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69 66 20 ror messages if
8960: 74 72 75 65 20 2a 2f 0a 20 20 75 38 20 76 74 61 true */. u8 vta
8970: 62 4f 6e 43 6f 6e 66 6c 69 63 74 3b 20 20 20 20 bOnConflict;
8980: 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 /* Value
8990: 20 74 6f 20 72 65 74 75 72 6e 20 66 6f 72 20 73 to return for s
89a0: 33 5f 76 74 61 62 5f 6f 6e 5f 63 6f 6e 66 6c 69 3_vtab_on_confli
89b0: 63 74 28 29 20 2a 2f 0a 20 20 75 38 20 69 73 54 ct() */. u8 isT
89c0: 72 61 6e 73 61 63 74 69 6f 6e 53 61 76 65 70 6f ransactionSavepo
89d0: 69 6e 74 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 int; /* True
89e0: 69 66 20 74 68 65 20 6f 75 74 65 72 6d 6f 73 74 if the outermost
89f0: 20 73 61 76 65 70 6f 69 6e 74 20 69 73 20 61 20 savepoint is a
8a00: 54 53 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 78 74 TS */. int next
8a10: 50 61 67 65 73 69 7a 65 3b 20 20 20 20 20 20 20 Pagesize;
8a20: 20 20 20 20 20 20 2f 2a 20 50 61 67 65 73 69 7a /* Pagesiz
8a30: 65 20 61 66 74 65 72 20 56 41 43 55 55 4d 20 69 e after VACUUM i
8a40: 66 20 3e 30 20 2a 2f 0a 20 20 75 33 32 20 6d 61 f >0 */. u32 ma
8a50: 67 69 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 gic;
8a60: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 67 69 63 /* Magic
8a70: 20 6e 75 6d 62 65 72 20 66 6f 72 20 64 65 74 65 number for dete
8a80: 63 74 20 6c 69 62 72 61 72 79 20 6d 69 73 75 73 ct library misus
8a90: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 68 61 6e e */. int nChan
8aa0: 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ge;
8ab0: 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 72 65 /* Value re
8ac0: 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74 65 turned by sqlite
8ad0: 33 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f 0a 20 3_changes() */.
8ae0: 20 69 6e 74 20 6e 54 6f 74 61 6c 43 68 61 6e 67 int nTotalChang
8af0: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f e; /
8b00: 2a 20 56 61 6c 75 65 20 72 65 74 75 72 6e 65 64 * Value returned
8b10: 20 62 79 20 73 71 6c 69 74 65 33 5f 74 6f 74 61 by sqlite3_tota
8b20: 6c 5f 63 68 61 6e 67 65 73 28 29 20 2a 2f 0a 20 l_changes() */.
8b30: 20 69 6e 74 20 61 4c 69 6d 69 74 5b 53 51 4c 49 int aLimit[SQLI
8b40: 54 45 5f 4e 5f 4c 49 4d 49 54 5d 3b 20 20 20 2f TE_N_LIMIT]; /
8b50: 2a 20 4c 69 6d 69 74 73 20 2a 2f 0a 20 20 73 74 * Limits */. st
8b60: 72 75 63 74 20 73 71 6c 69 74 65 33 49 6e 69 74 ruct sqlite3Init
8b70: 49 6e 66 6f 20 7b 20 20 20 20 20 20 2f 2a 20 49 Info { /* I
8b80: 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 nformation used
8b90: 64 75 72 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a during initializ
8ba0: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 ation */. int
8bb0: 20 6e 65 77 54 6e 75 6d 3b 20 20 20 20 20 20 20 newTnum;
8bc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f 6f 74 /* Root
8bd0: 70 61 67 65 20 6f 66 20 74 61 62 6c 65 20 62 65 page of table be
8be0: 69 6e 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 ing initialized
8bf0: 2a 2f 0a 20 20 20 20 75 38 20 69 44 62 3b 20 20 */. u8 iDb;
8c00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8c10: 20 20 20 2f 2a 20 57 68 69 63 68 20 64 62 20 66 /* Which db f
8c20: 69 6c 65 20 69 73 20 62 65 69 6e 67 20 69 6e 69 ile is being ini
8c30: 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 20 20 tialized */.
8c40: 75 38 20 62 75 73 79 3b 20 20 20 20 20 20 20 20 u8 busy;
8c50: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
8c60: 52 55 45 20 69 66 20 63 75 72 72 65 6e 74 6c 79 RUE if currently
8c70: 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67 20 2a 2f initializing */
8c80: 0a 20 20 20 20 75 38 20 6f 72 70 68 61 6e 54 72 . u8 orphanTr
8c90: 69 67 67 65 72 3b 20 20 20 20 20 20 20 20 20 20 igger;
8ca0: 20 2f 2a 20 4c 61 73 74 20 73 74 61 74 65 6d 65 /* Last stateme
8cb0: 6e 74 20 69 73 20 6f 72 70 68 61 6e 65 64 20 54 nt is orphaned T
8cc0: 45 4d 50 20 74 72 69 67 67 65 72 20 2a 2f 0a 20 EMP trigger */.
8cd0: 20 7d 20 69 6e 69 74 3b 0a 20 20 69 6e 74 20 6e } init;. int n
8ce0: 56 64 62 65 41 63 74 69 76 65 3b 20 20 20 20 20 VdbeActive;
8cf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
8d00: 65 72 20 6f 66 20 56 44 42 45 73 20 63 75 72 72 er of VDBEs curr
8d10: 65 6e 74 6c 79 20 72 75 6e 6e 69 6e 67 20 2a 2f ently running */
8d20: 0a 20 20 69 6e 74 20 6e 56 64 62 65 52 65 61 64 . int nVdbeRead
8d30: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
8d40: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 63 /* Number of ac
8d50: 74 69 76 65 20 56 44 42 45 73 20 74 68 61 74 20 tive VDBEs that
8d60: 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 2a 2f read or write */
8d70: 0a 20 20 69 6e 74 20 6e 56 64 62 65 57 72 69 74 . int nVdbeWrit
8d80: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
8d90: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 63 /* Number of ac
8da0: 74 69 76 65 20 56 44 42 45 73 20 74 68 61 74 20 tive VDBEs that
8db0: 72 65 61 64 20 61 6e 64 20 77 72 69 74 65 20 2a read and write *
8dc0: 2f 0a 20 20 69 6e 74 20 6e 56 64 62 65 45 78 65 /. int nVdbeExe
8dd0: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
8de0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e /* Number of n
8df0: 65 73 74 65 64 20 63 61 6c 6c 73 20 74 6f 20 56 ested calls to V
8e00: 64 62 65 45 78 65 63 28 29 20 2a 2f 0a 20 20 69 dbeExec() */. i
8e10: 6e 74 20 6e 45 78 74 65 6e 73 69 6f 6e 3b 20 20 nt nExtension;
8e20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8e30: 4e 75 6d 62 65 72 20 6f 66 20 6c 6f 61 64 65 64 Number of loaded
8e40: 20 65 78 74 65 6e 73 69 6f 6e 73 20 2a 2f 0a 20 extensions */.
8e50: 20 76 6f 69 64 20 2a 2a 61 45 78 74 65 6e 73 69 void **aExtensi
8e60: 6f 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f on; /
8e70: 2a 20 41 72 72 61 79 20 6f 66 20 73 68 61 72 65 * Array of share
8e80: 64 20 6c 69 62 72 61 72 79 20 68 61 6e 64 6c 65 d library handle
8e90: 73 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 54 s */. void (*xT
8ea0: 72 61 63 65 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 race)(void*,cons
8eb0: 74 20 63 68 61 72 2a 29 3b 20 20 20 20 20 20 20 t char*);
8ec0: 20 2f 2a 20 54 72 61 63 65 20 66 75 6e 63 74 69 /* Trace functi
8ed0: 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 54 on */. void *pT
8ee0: 72 61 63 65 41 72 67 3b 20 20 20 20 20 20 20 20 raceArg;
8ef0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8f00: 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f /* Argument to
8f10: 20 74 68 65 20 74 72 61 63 65 20 66 75 6e 63 74 the trace funct
8f20: 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a ion */. void (*
8f30: 78 50 72 6f 66 69 6c 65 29 28 76 6f 69 64 2a 2c xProfile)(void*,
8f40: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 75 36 34 29 const char*,u64)
8f50: 3b 20 20 2f 2a 20 50 72 6f 66 69 6c 69 6e 67 20 ; /* Profiling
8f60: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f function */. vo
8f70: 69 64 20 2a 70 50 72 6f 66 69 6c 65 41 72 67 3b id *pProfileArg;
8f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8f90: 20 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d /* Argum
8fa0: 65 6e 74 20 74 6f 20 70 72 6f 66 69 6c 65 20 66 ent to profile f
8fb0: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 unction */. voi
8fc0: 64 20 2a 70 43 6f 6d 6d 69 74 41 72 67 3b 20 20 d *pCommitArg;
8fd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
8fe0: 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 * Argument to xC
8ff0: 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 29 20 ommitCallback()
9000: 2a 2f 20 20 20 0a 20 20 69 6e 74 20 28 2a 78 43 */ . int (*xC
9010: 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 29 28 76 ommitCallback)(v
9020: 6f 69 64 2a 29 3b 20 20 20 20 2f 2a 20 49 6e 76 oid*); /* Inv
9030: 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 63 6f oked at every co
9040: 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 64 20 mmit. */. void
9050: 2a 70 52 6f 6c 6c 62 61 63 6b 41 72 67 3b 20 20 *pRollbackArg;
9060: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
9070: 41 72 67 75 6d 65 6e 74 20 74 6f 20 78 52 6f 6c Argument to xRol
9080: 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b 28 29 20 lbackCallback()
9090: 2a 2f 20 20 20 0a 20 20 76 6f 69 64 20 28 2a 78 */ . void (*x
90a0: 52 6f 6c 6c 62 61 63 6b 43 61 6c 6c 62 61 63 6b RollbackCallback
90b0: 29 28 76 6f 69 64 2a 29 3b 20 2f 2a 20 49 6e 76 )(void*); /* Inv
90c0: 6f 6b 65 64 20 61 74 20 65 76 65 72 79 20 63 6f oked at every co
90d0: 6d 6d 69 74 2e 20 2a 2f 0a 20 20 76 6f 69 64 20 mmit. */. void
90e0: 2a 70 55 70 64 61 74 65 41 72 67 3b 0a 20 20 76 *pUpdateArg;. v
90f0: 6f 69 64 20 28 2a 78 55 70 64 61 74 65 43 61 6c oid (*xUpdateCal
9100: 6c 62 61 63 6b 29 28 76 6f 69 64 2a 2c 69 6e 74 lback)(void*,int
9110: 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f , const char*,co
9120: 6e 73 74 20 63 68 61 72 2a 2c 73 71 6c 69 74 65 nst char*,sqlite
9130: 5f 69 6e 74 36 34 29 3b 0a 23 69 66 64 65 66 20 _int64);.#ifdef
9140: 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 SQLITE_ENABLE_PR
9150: 45 55 50 44 41 54 45 5f 48 4f 4f 4b 0a 20 20 76 EUPDATE_HOOK. v
9160: 6f 69 64 20 2a 70 50 72 65 55 70 64 61 74 65 41 oid *pPreUpdateA
9170: 72 67 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 rg; /*
9180: 46 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 First argument t
9190: 6f 20 78 50 72 65 55 70 64 61 74 65 43 61 6c 6c o xPreUpdateCall
91a0: 62 61 63 6b 20 2a 2f 0a 20 20 76 6f 69 64 20 28 back */. void (
91b0: 2a 78 50 72 65 55 70 64 61 74 65 43 61 6c 6c 62 *xPreUpdateCallb
91c0: 61 63 6b 29 28 20 20 20 2f 2a 20 52 65 67 69 73 ack)( /* Regis
91d0: 74 65 72 65 64 20 75 73 69 6e 67 20 73 71 6c 69 tered using sqli
91e0: 74 65 33 5f 70 72 65 75 70 64 61 74 65 5f 68 6f te3_preupdate_ho
91f0: 6f 6b 28 29 20 2a 2f 0a 20 20 20 20 76 6f 69 64 ok() */. void
9200: 2a 2c 73 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 63 *,sqlite3*,int,c
9210: 68 61 72 20 63 6f 6e 73 74 2a 2c 63 68 61 72 20 har const*,char
9220: 63 6f 6e 73 74 2a 2c 73 71 6c 69 74 65 33 5f 69 const*,sqlite3_i
9230: 6e 74 36 34 2c 73 71 6c 69 74 65 33 5f 69 6e 74 nt64,sqlite3_int
9240: 36 34 0a 20 20 29 3b 0a 20 20 50 72 65 55 70 64 64. );. PreUpd
9250: 61 74 65 20 2a 70 50 72 65 55 70 64 61 74 65 3b ate *pPreUpdate;
9260: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 /* Conte
9270: 78 74 20 66 6f 72 20 61 63 74 69 76 65 20 70 72 xt for active pr
9280: 65 2d 75 70 64 61 74 65 20 63 61 6c 6c 62 61 63 e-update callbac
9290: 6b 20 2a 2f 0a 23 65 6e 64 69 66 20 2f 2a 20 53 k */.#endif /* S
92a0: 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 50 52 45 QLITE_ENABLE_PRE
92b0: 55 50 44 41 54 45 5f 48 4f 4f 4b 20 2a 2f 0a 23 UPDATE_HOOK */.#
92c0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
92d0: 49 54 5f 57 41 4c 0a 20 20 69 6e 74 20 28 2a 78 IT_WAL. int (*x
92e0: 57 61 6c 43 61 6c 6c 62 61 63 6b 29 28 76 6f 69 WalCallback)(voi
92f0: 64 20 2a 2c 20 73 71 6c 69 74 65 33 20 2a 2c 20 d *, sqlite3 *,
9300: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 6e const char *, in
9310: 74 29 3b 0a 20 20 76 6f 69 64 20 2a 70 57 61 6c t);. void *pWal
9320: 41 72 67 3b 0a 23 65 6e 64 69 66 0a 20 20 76 6f Arg;.#endif. vo
9330: 69 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 29 id(*xCollNeeded)
9340: 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c (void*,sqlite3*,
9350: 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f 6e int eTextRep,con
9360: 73 74 20 63 68 61 72 2a 29 3b 0a 20 20 76 6f 69 st char*);. voi
9370: 64 28 2a 78 43 6f 6c 6c 4e 65 65 64 65 64 31 36 d(*xCollNeeded16
9380: 29 28 76 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a )(void*,sqlite3*
9390: 2c 69 6e 74 20 65 54 65 78 74 52 65 70 2c 63 6f ,int eTextRep,co
93a0: 6e 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 76 6f nst void*);. vo
93b0: 69 64 20 2a 70 43 6f 6c 6c 4e 65 65 64 65 64 41 id *pCollNeededA
93c0: 72 67 3b 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 rg;. sqlite3_va
93d0: 6c 75 65 20 2a 70 45 72 72 3b 20 20 20 20 20 20 lue *pErr;
93e0: 20 20 20 20 2f 2a 20 4d 6f 73 74 20 72 65 63 65 /* Most rece
93f0: 6e 74 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 nt error message
9400: 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 */. union {.
9410: 20 20 76 6f 6c 61 74 69 6c 65 20 69 6e 74 20 69 volatile int i
9420: 73 49 6e 74 65 72 72 75 70 74 65 64 3b 20 2f 2a sInterrupted; /*
9430: 20 54 72 75 65 20 69 66 20 73 71 6c 69 74 65 33 True if sqlite3
9440: 5f 69 6e 74 65 72 72 75 70 74 20 68 61 73 20 62 _interrupt has b
9450: 65 65 6e 20 63 61 6c 6c 65 64 20 2a 2f 0a 20 20 een called */.
9460: 20 20 64 6f 75 62 6c 65 20 6e 6f 74 55 73 65 64 double notUsed
9470: 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 1; /*
9480: 20 53 70 61 63 65 72 20 2a 2f 0a 20 20 7d 20 75 Spacer */. } u
9490: 31 3b 0a 20 20 4c 6f 6f 6b 61 73 69 64 65 20 6c 1;. Lookaside l
94a0: 6f 6f 6b 61 73 69 64 65 3b 20 20 20 20 20 20 20 ookaside;
94b0: 20 20 20 2f 2a 20 4c 6f 6f 6b 61 73 69 64 65 20 /* Lookaside
94c0: 6d 61 6c 6c 6f 63 20 63 6f 6e 66 69 67 75 72 61 malloc configura
94d0: 74 69 6f 6e 20 2a 2f 0a 23 69 66 6e 64 65 66 20 tion */.#ifndef
94e0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 SQLITE_OMIT_AUTH
94f0: 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 69 6e 74 20 ORIZATION. int
9500: 28 2a 78 41 75 74 68 29 28 76 6f 69 64 2a 2c 69 (*xAuth)(void*,i
9510: 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 nt,const char*,c
9520: 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 onst char*,const
9530: 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 char*,const cha
9540: 72 2a 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 r*);.
9550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9560: 20 20 20 20 20 2f 2a 20 41 63 63 65 73 73 20 61 /* Access a
9570: 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75 6e uthorization fun
9580: 63 74 69 6f 6e 20 2a 2f 0a 20 20 76 6f 69 64 20 ction */. void
9590: 2a 70 41 75 74 68 41 72 67 3b 20 20 20 20 20 20 *pAuthArg;
95a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 31 73 74 20 /* 1st
95b0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 argument to the
95c0: 61 63 63 65 73 73 20 61 75 74 68 20 66 75 6e 63 access auth func
95d0: 74 69 6f 6e 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 tion */.#endif.#
95e0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
95f0: 49 54 5f 50 52 4f 47 52 45 53 53 5f 43 41 4c 4c IT_PROGRESS_CALL
9600: 42 41 43 4b 0a 20 20 69 6e 74 20 28 2a 78 50 72 BACK. int (*xPr
9610: 6f 67 72 65 73 73 29 28 76 6f 69 64 20 2a 29 3b ogress)(void *);
9620: 20 20 20 20 20 2f 2a 20 54 68 65 20 70 72 6f 67 /* The prog
9630: 72 65 73 73 20 63 61 6c 6c 62 61 63 6b 20 2a 2f ress callback */
9640: 0a 20 20 76 6f 69 64 20 2a 70 50 72 6f 67 72 65 . void *pProgre
9650: 73 73 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 ssArg;
9660: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 6f 20 /* Argument to
9670: 74 68 65 20 70 72 6f 67 72 65 73 73 20 63 61 6c the progress cal
9680: 6c 62 61 63 6b 20 2a 2f 0a 20 20 75 6e 73 69 67 lback */. unsig
9690: 6e 65 64 20 6e 50 72 6f 67 72 65 73 73 4f 70 73 ned nProgressOps
96a0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 ; /* Numb
96b0: 65 72 20 6f 66 20 6f 70 63 6f 64 65 73 20 66 6f er of opcodes fo
96c0: 72 20 70 72 6f 67 72 65 73 73 20 63 61 6c 6c 62 r progress callb
96d0: 61 63 6b 20 2a 2f 0a 23 65 6e 64 69 66 0a 23 69 ack */.#endif.#i
96e0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
96f0: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 T_VIRTUALTABLE.
9700: 20 69 6e 74 20 6e 56 54 72 61 6e 73 3b 20 20 20 int nVTrans;
9710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
9720: 2a 20 41 6c 6c 6f 63 61 74 65 64 20 73 69 7a 65 * Allocated size
9730: 20 6f 66 20 61 56 54 72 61 6e 73 20 2a 2f 0a 20 of aVTrans */.
9740: 20 48 61 73 68 20 61 4d 6f 64 75 6c 65 3b 20 20 Hash aModule;
9750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
9760: 2a 20 70 6f 70 75 6c 61 74 65 64 20 62 79 20 73 * populated by s
9770: 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 6d 6f qlite3_create_mo
9780: 64 75 6c 65 28 29 20 2a 2f 0a 20 20 56 74 61 62 dule() */. Vtab
9790: 43 74 78 20 2a 70 56 74 61 62 43 74 78 3b 20 20 Ctx *pVtabCtx;
97a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e /* Con
97b0: 74 65 78 74 20 66 6f 72 20 61 63 74 69 76 65 20 text for active
97c0: 76 74 61 62 20 63 6f 6e 6e 65 63 74 2f 63 72 65 vtab connect/cre
97d0: 61 74 65 20 2a 2f 0a 20 20 56 54 61 62 6c 65 20 ate */. VTable
97e0: 2a 2a 61 56 54 72 61 6e 73 3b 20 20 20 20 20 20 **aVTrans;
97f0: 20 20 20 20 20 20 20 2f 2a 20 56 69 72 74 75 61 /* Virtua
9800: 6c 20 74 61 62 6c 65 73 20 77 69 74 68 20 6f 70 l tables with op
9810: 65 6e 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 en transactions
9820: 2a 2f 0a 20 20 56 54 61 62 6c 65 20 2a 70 44 69 */. VTable *pDi
9830: 73 63 6f 6e 6e 65 63 74 3b 20 20 20 20 2f 2a 20 sconnect; /*
9840: 44 69 73 63 6f 6e 6e 65 63 74 20 74 68 65 73 65 Disconnect these
9850: 20 69 6e 20 6e 65 78 74 20 73 71 6c 69 74 65 33 in next sqlite3
9860: 5f 70 72 65 70 61 72 65 28 29 20 2a 2f 0a 23 65 _prepare() */.#e
9870: 6e 64 69 66 0a 20 20 46 75 6e 63 44 65 66 48 61 ndif. FuncDefHa
9880: 73 68 20 61 46 75 6e 63 3b 20 20 20 20 20 20 20 sh aFunc;
9890: 20 20 20 20 20 2f 2a 20 48 61 73 68 20 74 61 62 /* Hash tab
98a0: 6c 65 20 6f 66 20 63 6f 6e 6e 65 63 74 69 6f 6e le of connection
98b0: 20 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 functions */.
98c0: 48 61 73 68 20 61 43 6f 6c 6c 53 65 71 3b 20 20 Hash aCollSeq;
98d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
98e0: 20 41 6c 6c 20 63 6f 6c 6c 61 74 69 6e 67 20 73 All collating s
98f0: 65 71 75 65 6e 63 65 73 20 2a 2f 0a 20 20 42 75 equences */. Bu
9900: 73 79 48 61 6e 64 6c 65 72 20 62 75 73 79 48 61 syHandler busyHa
9910: 6e 64 6c 65 72 3b 20 20 20 20 20 20 2f 2a 20 42 ndler; /* B
9920: 75 73 79 20 63 61 6c 6c 62 61 63 6b 20 2a 2f 0a usy callback */.
9930: 20 20 44 62 20 61 44 62 53 74 61 74 69 63 5b 32 Db aDbStatic[2
9940: 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ];
9950: 2f 2a 20 53 74 61 74 69 63 20 73 70 61 63 65 20 /* Static space
9960: 66 6f 72 20 74 68 65 20 32 20 64 65 66 61 75 6c for the 2 defaul
9970: 74 20 62 61 63 6b 65 6e 64 73 20 2a 2f 0a 20 20 t backends */.
9980: 53 61 76 65 70 6f 69 6e 74 20 2a 70 53 61 76 65 Savepoint *pSave
9990: 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 20 2f 2a point; /*
99a0: 20 4c 69 73 74 20 6f 66 20 61 63 74 69 76 65 20 List of active
99b0: 73 61 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 savepoints */.
99c0: 69 6e 74 20 62 75 73 79 54 69 6d 65 6f 75 74 3b int busyTimeout;
99d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
99e0: 20 42 75 73 79 20 68 61 6e 64 6c 65 72 20 74 69 Busy handler ti
99f0: 6d 65 6f 75 74 2c 20 69 6e 20 6d 73 65 63 20 2a meout, in msec *
9a00: 2f 0a 20 20 69 6e 74 20 6e 53 61 76 65 70 6f 69 /. int nSavepoi
9a10: 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 nt;
9a20: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e /* Number of n
9a30: 6f 6e 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 on-transaction s
9a40: 61 76 65 70 6f 69 6e 74 73 20 2a 2f 0a 20 20 69 avepoints */. i
9a50: 6e 74 20 6e 53 74 61 74 65 6d 65 6e 74 3b 20 20 nt nStatement;
9a60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
9a70: 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 Number of nested
9a80: 20 73 74 61 74 65 6d 65 6e 74 2d 74 72 61 6e 73 statement-trans
9a90: 61 63 74 69 6f 6e 73 20 20 2a 2f 0a 20 20 69 36 actions */. i6
9aa0: 34 20 6e 44 65 66 65 72 72 65 64 43 6f 6e 73 3b 4 nDeferredCons;
9ab0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
9ac0: 65 74 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 et deferred cons
9ad0: 74 72 61 69 6e 74 73 20 74 68 69 73 20 74 72 61 traints this tra
9ae0: 6e 73 61 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 69 nsaction. */. i
9af0: 36 34 20 6e 44 65 66 65 72 72 65 64 49 6d 6d 43 64 nDeferredImmC
9b00: 6f 6e 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ons; /*
9b10: 4e 65 74 20 64 65 66 65 72 72 65 64 20 69 6d 6d Net deferred imm
9b20: 65 64 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e ediate constrain
9b30: 74 73 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 6e 42 ts */. int *pnB
9b40: 79 74 65 73 46 72 65 65 64 3b 20 20 20 20 20 20 ytesFreed;
9b50: 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f 74 20 /* If not
9b60: 4e 55 4c 4c 2c 20 69 6e 63 72 65 6d 65 6e 74 20 NULL, increment
9b70: 74 68 69 73 20 69 6e 20 44 62 46 72 65 65 28 29 this in DbFree()
9b80: 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 */..#ifdef SQLI
9b90: 54 45 5f 45 4e 41 42 4c 45 5f 55 4e 4c 4f 43 4b TE_ENABLE_UNLOCK
9ba0: 5f 4e 4f 54 49 46 59 0a 20 20 2f 2a 20 54 68 65 _NOTIFY. /* The
9bb0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 72 69 61 following varia
9bc0: 62 6c 65 73 20 61 72 65 20 61 6c 6c 20 70 72 6f bles are all pro
9bd0: 74 65 63 74 65 64 20 62 79 20 74 68 65 20 53 54 tected by the ST
9be0: 41 54 49 43 5f 4d 41 53 54 45 52 20 0a 20 20 2a ATIC_MASTER . *
9bf0: 2a 20 6d 75 74 65 78 2c 20 6e 6f 74 20 62 79 20 * mutex, not by
9c00: 73 71 6c 69 74 65 33 2e 6d 75 74 65 78 2e 20 54 sqlite3.mutex. T
9c10: 68 65 79 20 61 72 65 20 75 73 65 64 20 62 79 20 hey are used by
9c20: 63 6f 64 65 20 69 6e 20 6e 6f 74 69 66 79 2e 63 code in notify.c
9c30: 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 65 . . **. ** Whe
9c40: 6e 20 58 2e 70 55 6e 6c 6f 63 6b 43 6f 6e 6e 65 n X.pUnlockConne
9c50: 63 74 69 6f 6e 3d 3d 59 2c 20 74 68 61 74 20 6d ction==Y, that m
9c60: 65 61 6e 73 20 74 68 61 74 20 58 20 69 73 20 77 eans that X is w
9c70: 61 69 74 69 6e 67 20 66 6f 72 20 59 20 74 6f 0a aiting for Y to.
9c80: 20 20 2a 2a 20 75 6e 6c 6f 63 6b 20 73 6f 20 74 ** unlock so t
9c90: 68 61 74 20 69 74 20 63 61 6e 20 70 72 6f 63 65 hat it can proce
9ca0: 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 68 ed.. **. ** Wh
9cb0: 65 6e 20 58 2e 70 42 6c 6f 63 6b 69 6e 67 43 6f en X.pBlockingCo
9cc0: 6e 6e 65 63 74 69 6f 6e 3d 3d 59 2c 20 74 68 61 nnection==Y, tha
9cd0: 74 20 6d 65 61 6e 73 20 74 68 61 74 20 73 6f 6d t means that som
9ce0: 65 74 68 69 6e 67 20 74 68 61 74 20 58 20 74 72 ething that X tr
9cf0: 69 65 64 0a 20 20 2a 2a 20 74 72 69 65 64 20 74 ied. ** tried t
9d00: 6f 20 64 6f 20 72 65 63 65 6e 74 6c 79 20 66 61 o do recently fa
9d10: 69 6c 65 64 20 77 69 74 68 20 61 6e 20 53 51 4c iled with an SQL
9d20: 49 54 45 5f 4c 4f 43 4b 45 44 20 65 72 72 6f 72 ITE_LOCKED error
9d30: 20 64 75 65 20 74 6f 20 6c 6f 63 6b 73 0a 20 20 due to locks.
9d40: 2a 2a 20 68 65 6c 64 20 62 79 20 59 2e 0a 20 20 ** held by Y..
9d50: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 70 42 */. sqlite3 *pB
9d60: 6c 6f 63 6b 69 6e 67 43 6f 6e 6e 65 63 74 69 6f lockingConnectio
9d70: 6e 3b 20 2f 2a 20 43 6f 6e 6e 65 63 74 69 6f 6e n; /* Connection
9d80: 20 74 68 61 74 20 63 61 75 73 65 64 20 53 51 4c that caused SQL
9d90: 49 54 45 5f 4c 4f 43 4b 45 44 20 2a 2f 0a 20 20 ITE_LOCKED */.
9da0: 73 71 6c 69 74 65 33 20 2a 70 55 6e 6c 6f 63 6b sqlite3 *pUnlock
9db0: 43 6f 6e 6e 65 63 74 69 6f 6e 3b 20 20 20 20 20 Connection;
9dc0: 20 20 20 20 20 20 2f 2a 20 43 6f 6e 6e 65 63 74 /* Connect
9dd0: 69 6f 6e 20 74 6f 20 77 61 74 63 68 20 66 6f 72 ion to watch for
9de0: 20 75 6e 6c 6f 63 6b 20 2a 2f 0a 20 20 76 6f 69 unlock */. voi
9df0: 64 20 2a 70 55 6e 6c 6f 63 6b 41 72 67 3b 20 20 d *pUnlockArg;
9e00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9e10: 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20 74 /* Argument t
9e20: 6f 20 78 55 6e 6c 6f 63 6b 4e 6f 74 69 66 79 20 o xUnlockNotify
9e30: 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 55 6e 6c */. void (*xUnl
9e40: 6f 63 6b 4e 6f 74 69 66 79 29 28 76 6f 69 64 20 ockNotify)(void
9e50: 2a 2a 2c 20 69 6e 74 29 3b 20 20 2f 2a 20 55 6e **, int); /* Un
9e60: 6c 6f 63 6b 20 6e 6f 74 69 66 79 20 63 61 6c 6c lock notify call
9e70: 62 61 63 6b 20 2a 2f 0a 20 20 73 71 6c 69 74 65 back */. sqlite
9e80: 33 20 2a 70 4e 65 78 74 42 6c 6f 63 6b 65 64 3b 3 *pNextBlocked;
9e90: 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 /* Next
9ea0: 69 6e 20 6c 69 73 74 20 6f 66 20 61 6c 6c 20 62 in list of all b
9eb0: 6c 6f 63 6b 65 64 20 63 6f 6e 6e 65 63 74 69 6f locked connectio
9ec0: 6e 73 20 2a 2f 0a 23 65 6e 64 69 66 0a 7d 3b 0a ns */.#endif.};.
9ed0: 0a 2f 2a 0a 2a 2a 20 41 20 6d 61 63 72 6f 20 74 ./*.** A macro t
9ee0: 6f 20 64 69 73 63 6f 76 65 72 20 74 68 65 20 65 o discover the e
9ef0: 6e 63 6f 64 69 6e 67 20 6f 66 20 61 20 64 61 74 ncoding of a dat
9f00: 61 62 61 73 65 2e 0a 2a 2f 0a 23 64 65 66 69 6e abase..*/.#defin
9f10: 65 20 45 4e 43 28 64 62 29 20 28 28 64 62 29 2d e ENC(db) ((db)-
9f20: 3e 61 44 62 5b 30 5d 2e 70 53 63 68 65 6d 61 2d >aDb[0].pSchema-
9f30: 3e 65 6e 63 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 >enc)../*.** Pos
9f40: 73 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 sible values for
9f50: 20 74 68 65 20 73 71 6c 69 74 65 33 2e 66 6c 61 the sqlite3.fla
9f60: 67 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 gs..*/.#define S
9f70: 51 4c 49 54 45 5f 56 64 62 65 54 72 61 63 65 20 QLITE_VdbeTrace
9f80: 20 20 20 20 20 30 78 30 30 30 30 30 30 30 31 20 0x00000001
9f90: 20 2f 2a 20 54 72 75 65 20 74 6f 20 74 72 61 63 /* True to trac
9fa0: 65 20 56 44 42 45 20 65 78 65 63 75 74 69 6f 6e e VDBE execution
9fb0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
9fc0: 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73 TE_InternChanges
9fd0: 20 20 30 78 30 30 30 30 30 30 30 32 20 20 2f 2a 0x00000002 /*
9fe0: 20 55 6e 63 6f 6d 6d 69 74 74 65 64 20 48 61 73 Uncommitted Has
9ff0: 68 20 74 61 62 6c 65 20 63 68 61 6e 67 65 73 20 h table changes
a000: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a010: 45 5f 46 75 6c 6c 46 53 79 6e 63 20 20 20 20 20 E_FullFSync
a020: 20 30 78 30 30 30 30 30 30 30 34 20 20 2f 2a 20 0x00000004 /*
a030: 55 73 65 20 66 75 6c 6c 20 66 73 79 6e 63 20 6f Use full fsync o
a040: 6e 20 74 68 65 20 62 61 63 6b 65 6e 64 20 2a 2f n the backend */
a050: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
a060: 43 6b 70 74 46 75 6c 6c 46 53 79 6e 63 20 20 30 CkptFullFSync 0
a070: 78 30 30 30 30 30 30 30 38 20 20 2f 2a 20 55 73 x00000008 /* Us
a080: 65 20 66 75 6c 6c 20 66 73 79 6e 63 20 66 6f 72 e full fsync for
a090: 20 63 68 65 63 6b 70 6f 69 6e 74 20 2a 2f 0a 23 checkpoint */.#
a0a0: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 61 define SQLITE_Ca
a0b0: 63 68 65 53 70 69 6c 6c 20 20 20 20 20 30 78 30 cheSpill 0x0
a0c0: 30 30 30 30 30 31 30 20 20 2f 2a 20 4f 4b 20 74 0000010 /* OK t
a0d0: 6f 20 73 70 69 6c 6c 20 70 61 67 65 72 20 63 61 o spill pager ca
a0e0: 63 68 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 che */.#define S
a0f0: 51 4c 49 54 45 5f 46 75 6c 6c 43 6f 6c 4e 61 6d QLITE_FullColNam
a100: 65 73 20 20 20 30 78 30 30 30 30 30 30 32 30 20 es 0x00000020
a110: 20 2f 2a 20 53 68 6f 77 20 66 75 6c 6c 20 63 6f /* Show full co
a120: 6c 75 6d 6e 20 6e 61 6d 65 73 20 6f 6e 20 53 45 lumn names on SE
a130: 4c 45 43 54 20 2a 2f 0a 23 64 65 66 69 6e 65 20 LECT */.#define
a140: 53 51 4c 49 54 45 5f 53 68 6f 72 74 43 6f 6c 4e SQLITE_ShortColN
a150: 61 6d 65 73 20 20 30 78 30 30 30 30 30 30 34 30 ames 0x00000040
a160: 20 20 2f 2a 20 53 68 6f 77 20 73 68 6f 72 74 20 /* Show short
a170: 63 6f 6c 75 6d 6e 73 20 6e 61 6d 65 73 20 2a 2f columns names */
a180: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
a190: 43 6f 75 6e 74 52 6f 77 73 20 20 20 20 20 20 30 CountRows 0
a1a0: 78 30 30 30 30 30 30 38 30 20 20 2f 2a 20 43 6f x00000080 /* Co
a1b0: 75 6e 74 20 72 6f 77 73 20 63 68 61 6e 67 65 64 unt rows changed
a1c0: 20 62 79 20 49 4e 53 45 52 54 2c 20 2a 2f 0a 20 by INSERT, */.
a1d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a1e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a1f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 20 20 44 45 /* DE
a200: 4c 45 54 45 2c 20 6f 72 20 55 50 44 41 54 45 20 LETE, or UPDATE
a210: 61 6e 64 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 and return */.
a220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a240: 20 20 20 20 20 20 20 20 2f 2a 20 20 20 74 68 65 /* the
a250: 20 63 6f 75 6e 74 20 75 73 69 6e 67 20 61 20 63 count using a c
a260: 61 6c 6c 62 61 63 6b 2e 20 2a 2f 0a 23 64 65 66 allback. */.#def
a270: 69 6e 65 20 53 51 4c 49 54 45 5f 4e 75 6c 6c 43 ine SQLITE_NullC
a280: 61 6c 6c 62 61 63 6b 20 20 20 30 78 30 30 30 30 allback 0x0000
a290: 30 31 30 30 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 0100 /* Invoke
a2a0: 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 the callback onc
a2b0: 65 20 69 66 20 74 68 65 20 2a 2f 0a 20 20 20 20 e if the */.
a2c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a2d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a2e0: 20 20 20 20 20 20 2f 2a 20 20 20 72 65 73 75 6c /* resul
a2f0: 74 20 73 65 74 20 69 73 20 65 6d 70 74 79 20 2a t set is empty *
a300: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
a310: 5f 53 71 6c 54 72 61 63 65 20 20 20 20 20 20 20 _SqlTrace
a320: 30 78 30 30 30 30 30 32 30 30 20 20 2f 2a 20 44 0x00000200 /* D
a330: 65 62 75 67 20 70 72 69 6e 74 20 53 51 4c 20 61 ebug print SQL a
a340: 73 20 69 74 20 65 78 65 63 75 74 65 73 20 2a 2f s it executes */
a350: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
a360: 56 64 62 65 4c 69 73 74 69 6e 67 20 20 20 20 30 VdbeListing 0
a370: 78 30 30 30 30 30 34 30 30 20 20 2f 2a 20 44 65 x00000400 /* De
a380: 62 75 67 20 6c 69 73 74 69 6e 67 73 20 6f 66 20 bug listings of
a390: 56 44 42 45 20 70 72 6f 67 72 61 6d 73 20 2a 2f VDBE programs */
a3a0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
a3b0: 57 72 69 74 65 53 63 68 65 6d 61 20 20 20 20 30 WriteSchema 0
a3c0: 78 30 30 30 30 30 38 30 30 20 20 2f 2a 20 4f 4b x00000800 /* OK
a3d0: 20 74 6f 20 75 70 64 61 74 65 20 53 51 4c 49 54 to update SQLIT
a3e0: 45 5f 4d 41 53 54 45 52 20 2a 2f 0a 23 64 65 66 E_MASTER */.#def
a3f0: 69 6e 65 20 53 51 4c 49 54 45 5f 56 64 62 65 41 ine SQLITE_VdbeA
a400: 64 64 6f 70 54 72 61 63 65 20 30 78 30 30 30 30 ddopTrace 0x0000
a410: 31 30 30 30 20 20 2f 2a 20 54 72 61 63 65 20 73 1000 /* Trace s
a420: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28 qlite3VdbeAddOp(
a430: 29 20 63 61 6c 6c 73 20 2a 2f 0a 23 64 65 66 69 ) calls */.#defi
a440: 6e 65 20 53 51 4c 49 54 45 5f 49 67 6e 6f 72 65 ne SQLITE_Ignore
a450: 43 68 65 63 6b 73 20 20 20 30 78 30 30 30 30 32 Checks 0x00002
a460: 30 30 30 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 65 000 /* Do not e
a470: 6e 66 6f 72 63 65 20 63 68 65 63 6b 20 63 6f 6e nforce check con
a480: 73 74 72 61 69 6e 74 73 20 2a 2f 0a 23 64 65 66 straints */.#def
a490: 69 6e 65 20 53 51 4c 49 54 45 5f 52 65 61 64 55 ine SQLITE_ReadU
a4a0: 6e 63 6f 6d 6d 69 74 74 65 64 20 30 78 30 30 30 ncommitted 0x000
a4b0: 34 30 30 30 20 20 2f 2a 20 46 6f 72 20 73 68 61 4000 /* For sha
a4c0: 72 65 64 2d 63 61 63 68 65 20 6d 6f 64 65 20 2a red-cache mode *
a4d0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
a4e0: 5f 4c 65 67 61 63 79 46 69 6c 65 46 6d 74 20 20 _LegacyFileFmt
a4f0: 30 78 30 30 30 30 38 30 30 30 20 20 2f 2a 20 43 0x00008000 /* C
a500: 72 65 61 74 65 20 6e 65 77 20 64 61 74 61 62 61 reate new databa
a510: 73 65 73 20 69 6e 20 66 6f 72 6d 61 74 20 31 20 ses in format 1
a520: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a530: 45 5f 52 65 63 6f 76 65 72 79 4d 6f 64 65 20 20 E_RecoveryMode
a540: 20 30 78 30 30 30 31 30 30 30 30 20 20 2f 2a 20 0x00010000 /*
a550: 49 67 6e 6f 72 65 20 73 63 68 65 6d 61 20 65 72 Ignore schema er
a560: 72 6f 72 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 rors */.#define
a570: 53 51 4c 49 54 45 5f 52 65 76 65 72 73 65 4f 72 SQLITE_ReverseOr
a580: 64 65 72 20 20 20 30 78 30 30 30 32 30 30 30 30 der 0x00020000
a590: 20 20 2f 2a 20 52 65 76 65 72 73 65 20 75 6e 6f /* Reverse uno
a5a0: 72 64 65 72 65 64 20 53 45 4c 45 43 54 73 20 2a rdered SELECTs *
a5b0: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
a5c0: 5f 52 65 63 54 72 69 67 67 65 72 73 20 20 20 20 _RecTriggers
a5d0: 30 78 30 30 30 34 30 30 30 30 20 20 2f 2a 20 45 0x00040000 /* E
a5e0: 6e 61 62 6c 65 20 72 65 63 75 72 73 69 76 65 20 nable recursive
a5f0: 74 72 69 67 67 65 72 73 20 2a 2f 0a 23 64 65 66 triggers */.#def
a600: 69 6e 65 20 53 51 4c 49 54 45 5f 46 6f 72 65 69 ine SQLITE_Forei
a610: 67 6e 4b 65 79 73 20 20 20 20 30 78 30 30 30 38 gnKeys 0x0008
a620: 30 30 30 30 20 20 2f 2a 20 45 6e 66 6f 72 63 65 0000 /* Enforce
a630: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e foreign key con
a640: 73 74 72 61 69 6e 74 73 20 20 2a 2f 0a 23 64 65 straints */.#de
a650: 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 75 74 6f fine SQLITE_Auto
a660: 49 6e 64 65 78 20 20 20 20 20 20 30 78 30 30 31 Index 0x001
a670: 30 30 30 30 30 20 20 2f 2a 20 45 6e 61 62 6c 65 00000 /* Enable
a680: 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 automatic index
a690: 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 es */.#define SQ
a6a0: 4c 49 54 45 5f 50 72 65 66 65 72 42 75 69 6c 74 LITE_PreferBuilt
a6b0: 69 6e 20 20 30 78 30 30 32 30 30 30 30 30 20 20 in 0x00200000
a6c0: 2f 2a 20 50 72 65 66 65 72 65 6e 63 65 20 74 6f /* Preference to
a6d0: 20 62 75 69 6c 74 2d 69 6e 20 66 75 6e 63 73 20 built-in funcs
a6e0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a6f0: 45 5f 4c 6f 61 64 45 78 74 65 6e 73 69 6f 6e 20 E_LoadExtension
a700: 20 30 78 30 30 34 30 30 30 30 30 20 20 2f 2a 20 0x00400000 /*
a710: 45 6e 61 62 6c 65 20 6c 6f 61 64 5f 65 78 74 65 Enable load_exte
a720: 6e 73 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 nsion */.#define
a730: 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 54 72 SQLITE_EnableTr
a740: 69 67 67 65 72 20 20 30 78 30 30 38 30 30 30 30 igger 0x0080000
a750: 30 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 65 6e 0 /* True to en
a760: 61 62 6c 65 20 74 72 69 67 67 65 72 73 20 2a 2f able triggers */
a770: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
a780: 44 65 66 65 72 46 4b 73 20 20 20 20 20 20 20 30 DeferFKs 0
a790: 78 30 31 30 30 30 30 30 30 20 20 2f 2a 20 44 65 x01000000 /* De
a7a0: 66 65 72 20 61 6c 6c 20 46 4b 20 63 6f 6e 73 74 fer all FK const
a7b0: 72 61 69 6e 74 73 20 2a 2f 0a 23 64 65 66 69 6e raints */.#defin
a7c0: 65 20 53 51 4c 49 54 45 5f 51 75 65 72 79 4f 6e e SQLITE_QueryOn
a7d0: 6c 79 20 20 20 20 20 20 30 78 30 32 30 30 30 30 ly 0x020000
a7e0: 30 30 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 64 00 /* Disable d
a7f0: 61 74 61 62 61 73 65 20 63 68 61 6e 67 65 73 20 atabase changes
a800: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
a810: 45 5f 56 64 62 65 45 51 50 20 20 20 20 20 20 20 E_VdbeEQP
a820: 20 30 78 30 34 30 30 30 30 30 30 20 20 2f 2a 20 0x04000000 /*
a830: 44 65 62 75 67 20 45 58 50 4c 41 49 4e 20 51 55 Debug EXPLAIN QU
a840: 45 52 59 20 50 4c 41 4e 20 2a 2f 0a 0a 0a 2f 2a ERY PLAN */.../*
a850: 0a 2a 2a 20 42 69 74 73 20 6f 66 20 74 68 65 20 .** Bits of the
a860: 73 71 6c 69 74 65 33 2e 64 62 4f 70 74 46 6c 61 sqlite3.dbOptFla
a870: 67 73 20 66 69 65 6c 64 20 74 68 61 74 20 61 72 gs field that ar
a880: 65 20 75 73 65 64 20 62 79 20 74 68 65 0a 2a 2a e used by the.**
a890: 20 73 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f sqlite3_test_co
a8a0: 6e 74 72 6f 6c 28 53 51 4c 49 54 45 5f 54 45 53 ntrol(SQLITE_TES
a8b0: 54 43 54 52 4c 5f 4f 50 54 49 4d 49 5a 41 54 49 TCTRL_OPTIMIZATI
a8c0: 4f 4e 53 2c 2e 2e 2e 29 20 69 6e 74 65 72 66 61 ONS,...) interfa
a8d0: 63 65 20 74 6f 0a 2a 2a 20 73 65 6c 65 63 74 69 ce to.** selecti
a8e0: 76 65 6c 79 20 64 69 73 61 62 6c 65 20 76 61 72 vely disable var
a8f0: 69 6f 75 73 20 6f 70 74 69 6d 69 7a 61 74 69 6f ious optimizatio
a900: 6e 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ns..*/.#define S
a910: 51 4c 49 54 45 5f 51 75 65 72 79 46 6c 61 74 74 QLITE_QueryFlatt
a920: 65 6e 65 72 20 30 78 30 30 30 31 20 20 20 2f 2a ener 0x0001 /*
a930: 20 51 75 65 72 79 20 66 6c 61 74 74 65 6e 69 6e Query flattenin
a940: 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c g */.#define SQL
a950: 49 54 45 5f 43 6f 6c 75 6d 6e 43 61 63 68 65 20 ITE_ColumnCache
a960: 20 20 20 30 78 30 30 30 32 20 20 20 2f 2a 20 43 0x0002 /* C
a970: 6f 6c 75 6d 6e 20 63 61 63 68 65 20 2a 2f 0a 23 olumn cache */.#
a980: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 47 72 define SQLITE_Gr
a990: 6f 75 70 42 79 4f 72 64 65 72 20 20 20 30 78 30 oupByOrder 0x0
a9a0: 30 30 34 20 20 20 2f 2a 20 47 52 4f 55 50 42 59 004 /* GROUPBY
a9b0: 20 63 6f 76 65 72 20 6f 66 20 4f 52 44 45 52 42 cover of ORDERB
a9c0: 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c Y */.#define SQL
a9d0: 49 54 45 5f 46 61 63 74 6f 72 4f 75 74 43 6f 6e ITE_FactorOutCon
a9e0: 73 74 20 30 78 30 30 30 38 20 20 20 2f 2a 20 43 st 0x0008 /* C
a9f0: 6f 6e 73 74 61 6e 74 20 66 61 63 74 6f 72 69 6e onstant factorin
aa00: 67 20 2a 2f 0a 2f 2a 20 20 20 20 20 20 20 20 20 g */./*
aa10: 20 20 20 20 20 20 20 6e 6f 74 20 75 73 65 64 20 not used
aa20: 20 20 20 30 78 30 30 31 30 20 20 20 2f 2f 20 57 0x0010 // W
aa30: 61 73 3a 20 53 51 4c 49 54 45 5f 49 64 78 52 65 as: SQLITE_IdxRe
aa40: 61 6c 41 73 49 6e 74 20 2a 2f 0a 23 64 65 66 69 alAsInt */.#defi
aa50: 6e 65 20 53 51 4c 49 54 45 5f 44 69 73 74 69 6e ne SQLITE_Distin
aa60: 63 74 4f 70 74 20 20 20 20 30 78 30 30 32 30 20 ctOpt 0x0020
aa70: 20 20 2f 2a 20 44 49 53 54 49 4e 43 54 20 75 73 /* DISTINCT us
aa80: 69 6e 67 20 69 6e 64 65 78 65 73 20 2a 2f 0a 23 ing indexes */.#
aa90: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 6f define SQLITE_Co
aaa0: 76 65 72 49 64 78 53 63 61 6e 20 20 20 30 78 30 verIdxScan 0x0
aab0: 30 34 30 20 20 20 2f 2a 20 43 6f 76 65 72 69 6e 040 /* Coverin
aac0: 67 20 69 6e 64 65 78 20 73 63 61 6e 73 20 2a 2f g index scans */
aad0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
aae0: 4f 72 64 65 72 42 79 49 64 78 4a 6f 69 6e 20 30 OrderByIdxJoin 0
aaf0: 78 30 30 38 30 20 20 20 2f 2a 20 4f 52 44 45 52 x0080 /* ORDER
ab00: 20 42 59 20 6f 66 20 6a 6f 69 6e 73 20 76 69 61 BY of joins via
ab10: 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e index */.#defin
ab20: 65 20 53 51 4c 49 54 45 5f 53 75 62 71 43 6f 72 e SQLITE_SubqCor
ab30: 6f 75 74 69 6e 65 20 20 30 78 30 31 30 30 20 20 outine 0x0100
ab40: 20 2f 2a 20 45 76 61 6c 75 61 74 65 20 73 75 62 /* Evaluate sub
ab50: 71 75 65 72 69 65 73 20 61 73 20 63 6f 72 6f 75 queries as corou
ab60: 74 69 6e 65 73 20 2a 2f 0a 23 64 65 66 69 6e 65 tines */.#define
ab70: 20 53 51 4c 49 54 45 5f 54 72 61 6e 73 69 74 69 SQLITE_Transiti
ab80: 76 65 20 20 20 20 20 30 78 30 32 30 30 20 20 20 ve 0x0200
ab90: 2f 2a 20 54 72 61 6e 73 69 74 69 76 65 20 63 6f /* Transitive co
aba0: 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 23 64 65 nstraints */.#de
abb0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4f 6d 69 74 fine SQLITE_Omit
abc0: 4e 6f 6f 70 4a 6f 69 6e 20 20 20 30 78 30 34 30 NoopJoin 0x040
abd0: 30 20 20 20 2f 2a 20 4f 6d 69 74 20 75 6e 75 73 0 /* Omit unus
abe0: 65 64 20 74 61 62 6c 65 73 20 69 6e 20 6a 6f 69 ed tables in joi
abf0: 6e 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 ns */.#define SQ
ac00: 4c 49 54 45 5f 53 74 61 74 33 20 20 20 20 20 20 LITE_Stat3
ac10: 20 20 20 20 30 78 30 38 30 30 20 20 20 2f 2a 20 0x0800 /*
ac20: 55 73 65 20 74 68 65 20 53 51 4c 49 54 45 5f 53 Use the SQLITE_S
ac30: 54 41 54 33 20 74 61 62 6c 65 20 2a 2f 0a 23 64 TAT3 table */.#d
ac40: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 64 6a efine SQLITE_Adj
ac50: 75 73 74 4f 75 74 45 73 74 20 20 20 30 78 31 30 ustOutEst 0x10
ac60: 30 30 20 20 20 2f 2a 20 41 64 6a 75 73 74 20 6f 00 /* Adjust o
ac70: 75 74 70 75 74 20 65 73 74 69 6d 61 74 65 73 20 utput estimates
ac80: 75 73 69 6e 67 20 57 48 45 52 45 20 2a 2f 0a 23 using WHERE */.#
ac90: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 6c define SQLITE_Al
aca0: 6c 4f 70 74 73 20 20 20 20 20 20 20 20 30 78 66 lOpts 0xf
acb0: 66 66 66 20 20 20 2f 2a 20 41 6c 6c 20 6f 70 74 fff /* All opt
acc0: 69 6d 69 7a 61 74 69 6f 6e 73 20 2a 2f 0a 0a 2f imizations */../
acd0: 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 66 6f 72 20 *.** Macros for
ace0: 74 65 73 74 69 6e 67 20 77 68 65 74 68 65 72 20 testing whether
acf0: 6f 72 20 6e 6f 74 20 6f 70 74 69 6d 69 7a 61 74 or not optimizat
ad00: 69 6f 6e 73 20 61 72 65 20 65 6e 61 62 6c 65 64 ions are enabled
ad10: 20 6f 72 20 64 69 73 61 62 6c 65 64 2e 0a 2a 2f or disabled..*/
ad20: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
ad30: 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 45 53 OMIT_BUILTIN_TES
ad40: 54 0a 23 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 T.#define Optimi
ad50: 7a 61 74 69 6f 6e 44 69 73 61 62 6c 65 64 28 64 zationDisabled(d
ad60: 62 2c 20 6d 61 73 6b 29 20 20 28 28 28 64 62 29 b, mask) (((db)
ad70: 2d 3e 64 62 4f 70 74 46 6c 61 67 73 26 28 6d 61 ->dbOptFlags&(ma
ad80: 73 6b 29 29 21 3d 30 29 0a 23 64 65 66 69 6e 65 sk))!=0).#define
ad90: 20 4f 70 74 69 6d 69 7a 61 74 69 6f 6e 45 6e 61 OptimizationEna
ada0: 62 6c 65 64 28 64 62 2c 20 6d 61 73 6b 29 20 20 bled(db, mask)
adb0: 20 28 28 28 64 62 29 2d 3e 64 62 4f 70 74 46 6c (((db)->dbOptFl
adc0: 61 67 73 26 28 6d 61 73 6b 29 29 3d 3d 30 29 0a ags&(mask))==0).
add0: 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20 4f 70 #else.#define Op
ade0: 74 69 6d 69 7a 61 74 69 6f 6e 44 69 73 61 62 6c timizationDisabl
adf0: 65 64 28 64 62 2c 20 6d 61 73 6b 29 20 20 30 0a ed(db, mask) 0.
ae00: 23 64 65 66 69 6e 65 20 4f 70 74 69 6d 69 7a 61 #define Optimiza
ae10: 74 69 6f 6e 45 6e 61 62 6c 65 64 28 64 62 2c 20 tionEnabled(db,
ae20: 6d 61 73 6b 29 20 20 20 31 0a 23 65 6e 64 69 66 mask) 1.#endif
ae30: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 ../*.** Return t
ae40: 72 75 65 20 69 66 20 69 74 20 4f 4b 20 74 6f 20 rue if it OK to
ae50: 66 61 63 74 6f 72 20 63 6f 6e 73 74 61 6e 74 20 factor constant
ae60: 65 78 70 72 65 73 73 69 6f 6e 73 20 69 6e 74 6f expressions into
ae70: 20 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 the initializat
ae80: 69 6f 6e 0a 2a 2a 20 63 6f 64 65 2e 20 54 68 65 ion.** code. The
ae90: 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61 20 50 argument is a P
aea0: 61 72 73 65 20 6f 62 6a 65 63 74 20 66 6f 72 20 arse object for
aeb0: 74 68 65 20 63 6f 64 65 20 67 65 6e 65 72 61 74 the code generat
aec0: 6f 72 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 43 or..*/.#define C
aed0: 6f 6e 73 74 46 61 63 74 6f 72 4f 6b 28 50 29 20 onstFactorOk(P)
aee0: 28 28 50 29 2d 3e 6f 6b 43 6f 6e 73 74 46 61 63 ((P)->okConstFac
aef0: 74 6f 72 29 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 tor)../*.** Poss
af00: 69 62 6c 65 20 76 61 6c 75 65 73 20 66 6f 72 20 ible values for
af10: 74 68 65 20 73 71 6c 69 74 65 2e 6d 61 67 69 63 the sqlite.magic
af20: 20 66 69 65 6c 64 2e 0a 2a 2a 20 54 68 65 20 6e field..** The n
af30: 75 6d 62 65 72 73 20 61 72 65 20 6f 62 74 61 69 umbers are obtai
af40: 6e 65 64 20 61 74 20 72 61 6e 64 6f 6d 20 61 6e ned at random an
af50: 64 20 68 61 76 65 20 6e 6f 20 73 70 65 63 69 61 d have no specia
af60: 6c 20 6d 65 61 6e 69 6e 67 2c 20 6f 74 68 65 72 l meaning, other
af70: 0a 2a 2a 20 74 68 61 6e 20 62 65 69 6e 67 20 64 .** than being d
af80: 69 73 74 69 6e 63 74 20 66 72 6f 6d 20 6f 6e 65 istinct from one
af90: 20 61 6e 6f 74 68 65 72 2e 0a 2a 2f 0a 23 64 65 another..*/.#de
afa0: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 fine SQLITE_MAGI
afb0: 43 5f 4f 50 45 4e 20 20 20 20 20 30 78 61 30 32 C_OPEN 0xa02
afc0: 39 61 36 39 37 20 20 2f 2a 20 44 61 74 61 62 61 9a697 /* Databa
afd0: 73 65 20 69 73 20 6f 70 65 6e 20 2a 2f 0a 23 64 se is open */.#d
afe0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4d 41 47 efine SQLITE_MAG
aff0: 49 43 5f 43 4c 4f 53 45 44 20 20 20 30 78 39 66 IC_CLOSED 0x9f
b000: 33 63 32 64 33 33 20 20 2f 2a 20 44 61 74 61 62 3c2d33 /* Datab
b010: 61 73 65 20 69 73 20 63 6c 6f 73 65 64 20 2a 2f ase is closed */
b020: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
b030: 4d 41 47 49 43 5f 53 49 43 4b 20 20 20 20 20 30 MAGIC_SICK 0
b040: 78 34 62 37 37 31 32 39 30 20 20 2f 2a 20 45 72 x4b771290 /* Er
b050: 72 6f 72 20 61 6e 64 20 61 77 61 69 74 69 6e 67 ror and awaiting
b060: 20 63 6c 6f 73 65 20 2a 2f 0a 23 64 65 66 69 6e close */.#defin
b070: 65 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 42 e SQLITE_MAGIC_B
b080: 55 53 59 20 20 20 20 20 30 78 66 30 33 62 37 39 USY 0xf03b79
b090: 30 36 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 06 /* Database
b0a0: 63 75 72 72 65 6e 74 6c 79 20 69 6e 20 75 73 65 currently in use
b0b0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
b0c0: 54 45 5f 4d 41 47 49 43 5f 45 52 52 4f 52 20 20 TE_MAGIC_ERROR
b0d0: 20 20 30 78 62 35 33 35 37 39 33 30 20 20 2f 2a 0xb5357930 /*
b0e0: 20 41 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 An SQLITE_MISUS
b0f0: 45 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 E error occurred
b100: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
b110: 54 45 5f 4d 41 47 49 43 5f 5a 4f 4d 42 49 45 20 TE_MAGIC_ZOMBIE
b120: 20 20 30 78 36 34 63 66 66 63 37 66 20 20 2f 2a 0x64cffc7f /*
b130: 20 43 6c 6f 73 65 20 77 69 74 68 20 6c 61 73 74 Close with last
b140: 20 73 74 61 74 65 6d 65 6e 74 20 63 6c 6f 73 65 statement close
b150: 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 */../*.** Each
b160: 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 SQL function is
b170: 64 65 66 69 6e 65 64 20 62 79 20 61 6e 20 69 6e defined by an in
b180: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f stance of the fo
b190: 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 73 74 72 75 63 llowing.** struc
b1a0: 74 75 72 65 2e 20 20 41 20 70 6f 69 6e 74 65 72 ture. A pointer
b1b0: 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 75 to this structu
b1c0: 72 65 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 re is stored in
b1d0: 74 68 65 20 73 71 6c 69 74 65 2e 61 46 75 6e 63 the sqlite.aFunc
b1e0: 0a 2a 2a 20 68 61 73 68 20 74 61 62 6c 65 2e 20 .** hash table.
b1f0: 20 57 68 65 6e 20 6d 75 6c 74 69 70 6c 65 20 66 When multiple f
b200: 75 6e 63 74 69 6f 6e 73 20 68 61 76 65 20 74 68 unctions have th
b210: 65 20 73 61 6d 65 20 6e 61 6d 65 2c 20 74 68 65 e same name, the
b220: 20 68 61 73 68 20 74 61 62 6c 65 0a 2a 2a 20 70 hash table.** p
b230: 6f 69 6e 74 73 20 74 6f 20 61 20 6c 69 6e 6b 65 oints to a linke
b240: 64 20 6c 69 73 74 20 6f 66 20 74 68 65 73 65 20 d list of these
b250: 73 74 72 75 63 74 75 72 65 73 2e 0a 2a 2f 0a 73 structures..*/.s
b260: 74 72 75 63 74 20 46 75 6e 63 44 65 66 20 7b 0a truct FuncDef {.
b270: 20 20 69 31 36 20 6e 41 72 67 3b 20 20 20 20 20 i16 nArg;
b280: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
b290: 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 2e 20 20 of arguments.
b2a0: 2d 31 20 6d 65 61 6e 73 20 75 6e 6c 69 6d 69 74 -1 means unlimit
b2b0: 65 64 20 2a 2f 0a 20 20 75 31 36 20 66 75 6e 63 ed */. u16 func
b2c0: 46 6c 61 67 73 3b 20 20 20 20 20 20 20 2f 2a 20 Flags; /*
b2d0: 53 6f 6d 65 20 63 6f 6d 62 69 6e 61 74 69 6f 6e Some combination
b2e0: 20 6f 66 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f of SQLITE_FUNC_
b2f0: 2a 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 55 73 * */. void *pUs
b300: 65 72 44 61 74 61 3b 20 20 20 20 20 2f 2a 20 55 erData; /* U
b310: 73 65 72 20 64 61 74 61 20 70 61 72 61 6d 65 74 ser data paramet
b320: 65 72 20 2a 2f 0a 20 20 46 75 6e 63 44 65 66 20 er */. FuncDef
b330: 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 2f 2a 20 *pNext; /*
b340: 4e 65 78 74 20 66 75 6e 63 74 69 6f 6e 20 77 69 Next function wi
b350: 74 68 20 73 61 6d 65 20 6e 61 6d 65 20 2a 2f 0a th same name */.
b360: 20 20 76 6f 69 64 20 28 2a 78 46 75 6e 63 29 28 void (*xFunc)(
b370: 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
b380: 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
b390: 75 65 2a 2a 29 3b 20 2f 2a 20 52 65 67 75 6c 61 ue**); /* Regula
b3a0: 72 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 r function */.
b3b0: 76 6f 69 64 20 28 2a 78 53 74 65 70 29 28 73 71 void (*xStep)(sq
b3c0: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
b3d0: 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
b3e0: 2a 2a 29 3b 20 2f 2a 20 41 67 67 72 65 67 61 74 **); /* Aggregat
b3f0: 65 20 73 74 65 70 20 2a 2f 0a 20 20 76 6f 69 64 e step */. void
b400: 20 28 2a 78 46 69 6e 61 6c 69 7a 65 29 28 73 71 (*xFinalize)(sq
b410: 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 29 3b lite3_context*);
b420: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b430: 2f 2a 20 41 67 67 72 65 67 61 74 65 20 66 69 6e /* Aggregate fin
b440: 61 6c 69 7a 65 72 20 2a 2f 0a 20 20 63 68 61 72 alizer */. char
b450: 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 *zName;
b460: 20 2f 2a 20 53 51 4c 20 6e 61 6d 65 20 6f 66 20 /* SQL name of
b470: 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f the function. */
b480: 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 48 61 73 . FuncDef *pHas
b490: 68 3b 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 h; /* Next
b4a0: 77 69 74 68 20 61 20 64 69 66 66 65 72 65 6e 74 with a different
b4b0: 20 6e 61 6d 65 20 62 75 74 20 74 68 65 20 73 61 name but the sa
b4c0: 6d 65 20 68 61 73 68 20 2a 2f 0a 20 20 46 75 6e me hash */. Fun
b4d0: 63 44 65 73 74 72 75 63 74 6f 72 20 2a 70 44 65 cDestructor *pDe
b4e0: 73 74 72 75 63 74 6f 72 3b 20 20 20 2f 2a 20 52 structor; /* R
b4f0: 65 66 65 72 65 6e 63 65 20 63 6f 75 6e 74 65 64 eference counted
b500: 20 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 destructor func
b510: 74 69 6f 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a tion */.};../*.*
b520: 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 72 65 * This structure
b530: 20 65 6e 63 61 70 73 75 6c 61 74 65 73 20 61 20 encapsulates a
b540: 75 73 65 72 2d 66 75 6e 63 74 69 6f 6e 20 64 65 user-function de
b550: 73 74 72 75 63 74 6f 72 20 63 61 6c 6c 62 61 63 structor callbac
b560: 6b 20 28 61 73 0a 2a 2a 20 63 6f 6e 66 69 67 75 k (as.** configu
b570: 72 65 64 20 75 73 69 6e 67 20 63 72 65 61 74 65 red using create
b580: 5f 66 75 6e 63 74 69 6f 6e 5f 76 32 28 29 29 20 _function_v2())
b590: 61 6e 64 20 61 20 72 65 66 65 72 65 6e 63 65 20 and a reference
b5a0: 63 6f 75 6e 74 65 72 2e 20 57 68 65 6e 0a 2a 2a counter. When.**
b5b0: 20 63 72 65 61 74 65 5f 66 75 6e 63 74 69 6f 6e create_function
b5c0: 5f 76 32 28 29 20 69 73 20 63 61 6c 6c 65 64 20 _v2() is called
b5d0: 74 6f 20 63 72 65 61 74 65 20 61 20 66 75 6e 63 to create a func
b5e0: 74 69 6f 6e 20 77 69 74 68 20 61 20 64 65 73 74 tion with a dest
b5f0: 72 75 63 74 6f 72 2c 0a 2a 2a 20 61 20 73 69 6e ructor,.** a sin
b600: 67 6c 65 20 6f 62 6a 65 63 74 20 6f 66 20 74 68 gle object of th
b610: 69 73 20 74 79 70 65 20 69 73 20 61 6c 6c 6f 63 is type is alloc
b620: 61 74 65 64 2e 20 46 75 6e 63 44 65 73 74 72 75 ated. FuncDestru
b630: 63 74 6f 72 2e 6e 52 65 66 20 69 73 20 73 65 74 ctor.nRef is set
b640: 20 74 6f 20 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 to .** the numb
b650: 65 72 20 6f 66 20 46 75 6e 63 44 65 66 20 6f 62 er of FuncDef ob
b660: 6a 65 63 74 73 20 63 72 65 61 74 65 64 20 28 65 jects created (e
b670: 69 74 68 65 72 20 31 20 6f 72 20 33 2c 20 64 65 ither 1 or 3, de
b680: 70 65 6e 64 69 6e 67 20 6f 6e 20 77 68 65 74 68 pending on wheth
b690: 65 72 0a 2a 2a 20 6f 72 20 6e 6f 74 20 74 68 65 er.** or not the
b6a0: 20 73 70 65 63 69 66 69 65 64 20 65 6e 63 6f 64 specified encod
b6b0: 69 6e 67 20 69 73 20 53 51 4c 49 54 45 5f 41 4e ing is SQLITE_AN
b6c0: 59 29 2e 20 54 68 65 20 46 75 6e 63 44 65 66 2e Y). The FuncDef.
b6d0: 70 44 65 73 74 72 75 63 74 6f 72 0a 2a 2a 20 6d pDestructor.** m
b6e0: 65 6d 62 65 72 20 6f 66 20 65 61 63 68 20 6f 66 ember of each of
b6f0: 20 74 68 65 20 6e 65 77 20 46 75 6e 63 44 65 66 the new FuncDef
b700: 20 6f 62 6a 65 63 74 73 20 69 73 20 73 65 74 20 objects is set
b710: 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 to point to the
b720: 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 46 75 6e allocated.** Fun
b730: 63 44 65 73 74 72 75 63 74 6f 72 2e 0a 2a 2a 0a cDestructor..**.
b740: 2a 2a 20 54 68 65 72 65 61 66 74 65 72 2c 20 77 ** Thereafter, w
b750: 68 65 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 46 hen one of the F
b760: 75 6e 63 44 65 66 20 6f 62 6a 65 63 74 73 20 69 uncDef objects i
b770: 73 20 64 65 6c 65 74 65 64 2c 20 74 68 65 20 72 s deleted, the r
b780: 65 66 65 72 65 6e 63 65 0a 2a 2a 20 63 6f 75 6e eference.** coun
b790: 74 20 6f 6e 20 74 68 69 73 20 6f 62 6a 65 63 74 t on this object
b7a0: 20 69 73 20 64 65 63 72 65 6d 65 6e 74 65 64 2e is decremented.
b7b0: 20 57 68 65 6e 20 69 74 20 72 65 61 63 68 65 73 When it reaches
b7c0: 20 30 2c 20 74 68 65 20 64 65 73 74 72 75 63 74 0, the destruct
b7d0: 6f 72 0a 2a 2a 20 69 73 20 69 6e 76 6f 6b 65 64 or.** is invoked
b7e0: 20 61 6e 64 20 74 68 65 20 46 75 6e 63 44 65 73 and the FuncDes
b7f0: 74 72 75 63 74 6f 72 20 73 74 72 75 63 74 75 72 tructor structur
b800: 65 20 66 72 65 65 64 2e 0a 2a 2f 0a 73 74 72 75 e freed..*/.stru
b810: 63 74 20 46 75 6e 63 44 65 73 74 72 75 63 74 6f ct FuncDestructo
b820: 72 20 7b 0a 20 20 69 6e 74 20 6e 52 65 66 3b 0a r {. int nRef;.
b830: 20 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f void (*xDestro
b840: 79 29 28 76 6f 69 64 20 2a 29 3b 0a 20 20 76 6f y)(void *);. vo
b850: 69 64 20 2a 70 55 73 65 72 44 61 74 61 3b 0a 7d id *pUserData;.}
b860: 3b 0a 0a 2f 2a 0a 2a 2a 20 50 6f 73 73 69 62 6c ;../*.** Possibl
b870: 65 20 76 61 6c 75 65 73 20 66 6f 72 20 46 75 6e e values for Fun
b880: 63 44 65 66 2e 66 6c 61 67 73 2e 20 20 4e 6f 74 cDef.flags. Not
b890: 65 20 74 68 61 74 20 74 68 65 20 5f 4c 45 4e 47 e that the _LENG
b8a0: 54 48 20 61 6e 64 20 5f 54 59 50 45 4f 46 0a 2a TH and _TYPEOF.*
b8b0: 2a 20 76 61 6c 75 65 73 20 6d 75 73 74 20 63 6f * values must co
b8c0: 72 72 65 73 70 6f 6e 64 20 74 6f 20 4f 50 46 4c rrespond to OPFL
b8d0: 41 47 5f 4c 45 4e 47 54 48 41 52 47 20 61 6e 64 AG_LENGTHARG and
b8e0: 20 4f 50 46 4c 41 47 5f 54 59 50 45 4f 46 41 52 OPFLAG_TYPEOFAR
b8f0: 47 2e 20 20 54 68 65 72 65 0a 2a 2a 20 61 72 65 G. There.** are
b900: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d assert() statem
b910: 65 6e 74 73 20 69 6e 20 74 68 65 20 63 6f 64 65 ents in the code
b920: 20 74 6f 20 76 65 72 69 66 79 20 74 68 69 73 2e to verify this.
b930: 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 .*/.#define SQLI
b940: 54 45 5f 46 55 4e 43 5f 45 4e 43 4d 41 53 4b 20 TE_FUNC_ENCMASK
b950: 20 30 78 30 30 33 20 2f 2a 20 53 51 4c 49 54 45 0x003 /* SQLITE
b960: 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 55 54 _UTF8, SQLITE_UT
b970: 46 31 36 42 45 20 6f 72 20 55 54 46 31 36 4c 45 F16BE or UTF16LE
b980: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 */.#define SQLI
b990: 54 45 5f 46 55 4e 43 5f 4c 49 4b 45 20 20 20 20 TE_FUNC_LIKE
b9a0: 20 30 78 30 30 34 20 2f 2a 20 43 61 6e 64 69 64 0x004 /* Candid
b9b0: 61 74 65 20 66 6f 72 20 74 68 65 20 4c 49 4b 45 ate for the LIKE
b9c0: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 2a 2f optimization */
b9d0: 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f .#define SQLITE_
b9e0: 46 55 4e 43 5f 43 41 53 45 20 20 20 20 20 30 78 FUNC_CASE 0x
b9f0: 30 30 38 20 2f 2a 20 43 61 73 65 2d 73 65 6e 73 008 /* Case-sens
ba00: 69 74 69 76 65 20 4c 49 4b 45 2d 74 79 70 65 20 itive LIKE-type
ba10: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 function */.#def
ba20: 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f ine SQLITE_FUNC_
ba30: 45 50 48 45 4d 20 20 20 20 30 78 30 31 30 20 2f EPHEM 0x010 /
ba40: 2a 20 45 70 68 65 6d 65 72 61 6c 2e 20 20 44 65 * Ephemeral. De
ba50: 6c 65 74 65 20 77 69 74 68 20 56 44 42 45 20 2a lete with VDBE *
ba60: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
ba70: 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 20 30 _FUNC_NEEDCOLL 0
ba80: 78 30 32 30 20 2f 2a 20 73 71 6c 69 74 65 33 47 x020 /* sqlite3G
ba90: 65 74 46 75 6e 63 43 6f 6c 6c 53 65 71 28 29 20 etFuncCollSeq()
baa0: 6d 69 67 68 74 20 62 65 20 63 61 6c 6c 65 64 20 might be called
bab0: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
bac0: 45 5f 46 55 4e 43 5f 4c 45 4e 47 54 48 20 20 20 E_FUNC_LENGTH
bad0: 30 78 30 34 30 20 2f 2a 20 42 75 69 6c 74 2d 69 0x040 /* Built-i
bae0: 6e 20 6c 65 6e 67 74 68 28 29 20 66 75 6e 63 74 n length() funct
baf0: 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 ion */.#define S
bb00: 51 4c 49 54 45 5f 46 55 4e 43 5f 54 59 50 45 4f QLITE_FUNC_TYPEO
bb10: 46 20 20 20 30 78 30 38 30 20 2f 2a 20 42 75 69 F 0x080 /* Bui
bb20: 6c 74 2d 69 6e 20 74 79 70 65 6f 66 28 29 20 66 lt-in typeof() f
bb30: 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 unction */.#defi
bb40: 6e 65 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 ne SQLITE_FUNC_C
bb50: 4f 55 4e 54 20 20 20 20 30 78 31 30 30 20 2f 2a OUNT 0x100 /*
bb60: 20 42 75 69 6c 74 2d 69 6e 20 63 6f 75 6e 74 28 Built-in count(
bb70: 2a 29 20 61 67 67 72 65 67 61 74 65 20 2a 2f 0a *) aggregate */.
bb80: 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 #define SQLITE_F
bb90: 55 4e 43 5f 43 4f 41 4c 45 53 43 45 20 30 78 32 UNC_COALESCE 0x2
bba0: 30 30 20 2f 2a 20 42 75 69 6c 74 2d 69 6e 20 63 00 /* Built-in c
bbb0: 6f 61 6c 65 73 63 65 28 29 20 6f 72 20 69 66 6e oalesce() or ifn
bbc0: 75 6c 6c 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 ull() */.#define
bbd0: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 55 4e 4c SQLITE_FUNC_UNL
bbe0: 49 4b 45 4c 59 20 30 78 34 30 30 20 2f 2a 20 42 IKELY 0x400 /* B
bbf0: 75 69 6c 74 2d 69 6e 20 75 6e 6c 69 6b 65 6c 79 uilt-in unlikely
bc00: 28 29 20 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 23 () function */.#
bc10: 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 46 55 define SQLITE_FU
bc20: 4e 43 5f 43 4f 4e 53 54 41 4e 54 20 30 78 38 30 NC_CONSTANT 0x80
bc30: 30 20 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 69 6e 0 /* Constant in
bc40: 70 75 74 73 20 67 69 76 65 20 61 20 63 6f 6e 73 puts give a cons
bc50: 74 61 6e 74 20 6f 75 74 70 75 74 20 2a 2f 0a 0a tant output */..
bc60: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 /*.** The follow
bc70: 69 6e 67 20 74 68 72 65 65 20 6d 61 63 72 6f 73 ing three macros
bc80: 2c 20 46 55 4e 43 54 49 4f 4e 28 29 2c 20 4c 49 , FUNCTION(), LI
bc90: 4b 45 46 55 4e 43 28 29 20 61 6e 64 20 41 47 47 KEFUNC() and AGG
bca0: 52 45 47 41 54 45 28 29 20 61 72 65 0a 2a 2a 20 REGATE() are.**
bcb0: 75 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 74 used to create t
bcc0: 68 65 20 69 6e 69 74 69 61 6c 69 7a 65 72 73 20 he initializers
bcd0: 66 6f 72 20 74 68 65 20 46 75 6e 63 44 65 66 20 for the FuncDef
bce0: 73 74 72 75 63 74 75 72 65 73 2e 0a 2a 2a 0a 2a structures..**.*
bcf0: 2a 20 20 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 * FUNCTION(zNa
bd00: 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 me, nArg, iArg,
bd10: 62 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 20 bNC, xFunc).**
bd20: 20 20 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 Used to creat
bd30: 65 20 61 20 73 63 61 6c 61 72 20 66 75 6e 63 74 e a scalar funct
bd40: 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f ion definition o
bd50: 66 20 61 20 66 75 6e 63 74 69 6f 6e 20 7a 4e 61 f a function zNa
bd60: 6d 65 20 0a 2a 2a 20 20 20 20 20 69 6d 70 6c 65 me .** imple
bd70: 6d 65 6e 74 65 64 20 62 79 20 43 20 66 75 6e 63 mented by C func
bd80: 74 69 6f 6e 20 78 46 75 6e 63 20 74 68 61 74 20 tion xFunc that
bd90: 61 63 63 65 70 74 73 20 6e 41 72 67 20 61 72 67 accepts nArg arg
bda0: 75 6d 65 6e 74 73 2e 20 54 68 65 0a 2a 2a 20 20 uments. The.**
bdb0: 20 20 20 76 61 6c 75 65 20 70 61 73 73 65 64 20 value passed
bdc0: 61 73 20 69 41 72 67 20 69 73 20 63 61 73 74 20 as iArg is cast
bdd0: 74 6f 20 61 20 28 76 6f 69 64 2a 29 20 61 6e 64 to a (void*) and
bde0: 20 6d 61 64 65 20 61 76 61 69 6c 61 62 6c 65 0a made available.
bdf0: 2a 2a 20 20 20 20 20 61 73 20 74 68 65 20 75 73 ** as the us
be00: 65 72 2d 64 61 74 61 20 28 73 71 6c 69 74 65 33 er-data (sqlite3
be10: 5f 75 73 65 72 5f 64 61 74 61 28 29 29 20 66 6f _user_data()) fo
be20: 72 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 20 r the function.
be30: 49 66 20 0a 2a 2a 20 20 20 20 20 61 72 67 75 6d If .** argum
be40: 65 6e 74 20 62 4e 43 20 69 73 20 74 72 75 65 2c ent bNC is true,
be50: 20 74 68 65 6e 20 74 68 65 20 53 51 4c 49 54 45 then the SQLITE
be60: 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c 20 66 _FUNC_NEEDCOLL f
be70: 6c 61 67 20 69 73 20 73 65 74 2e 0a 2a 2a 0a 2a lag is set..**.*
be80: 2a 20 20 20 56 46 55 4e 43 54 49 4f 4e 28 7a 4e * VFUNCTION(zN
be90: 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c ame, nArg, iArg,
bea0: 20 62 4e 43 2c 20 78 46 75 6e 63 29 0a 2a 2a 20 bNC, xFunc).**
beb0: 20 20 20 20 4c 69 6b 65 20 46 55 4e 43 54 49 4f Like FUNCTIO
bec0: 4e 20 65 78 63 65 70 74 20 69 74 20 6f 6d 69 74 N except it omit
bed0: 73 20 74 68 65 20 53 51 4c 49 54 45 5f 46 55 4e s the SQLITE_FUN
bee0: 43 5f 43 4f 4e 53 54 41 4e 54 20 66 6c 61 67 2e C_CONSTANT flag.
bef0: 0a 2a 2a 0a 2a 2a 20 20 20 41 47 47 52 45 47 41 .**.** AGGREGA
bf00: 54 45 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 TE(zName, nArg,
bf10: 69 41 72 67 2c 20 62 4e 43 2c 20 78 53 74 65 70 iArg, bNC, xStep
bf20: 2c 20 78 46 69 6e 61 6c 29 0a 2a 2a 20 20 20 20 , xFinal).**
bf30: 20 55 73 65 64 20 74 6f 20 63 72 65 61 74 65 20 Used to create
bf40: 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e an aggregate fun
bf50: 63 74 69 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e ction definition
bf60: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 0a implemented by.
bf70: 2a 2a 20 20 20 20 20 74 68 65 20 43 20 66 75 6e ** the C fun
bf80: 63 74 69 6f 6e 73 20 78 53 74 65 70 20 61 6e 64 ctions xStep and
bf90: 20 78 46 69 6e 61 6c 2e 20 54 68 65 20 66 69 72 xFinal. The fir
bfa0: 73 74 20 66 6f 75 72 20 70 61 72 61 6d 65 74 65 st four paramete
bfb0: 72 73 0a 2a 2a 20 20 20 20 20 61 72 65 20 69 6e rs.** are in
bfc0: 74 65 72 70 72 65 74 65 64 20 69 6e 20 74 68 65 terpreted in the
bfd0: 20 73 61 6d 65 20 77 61 79 20 61 73 20 74 68 65 same way as the
bfe0: 20 66 69 72 73 74 20 34 20 70 61 72 61 6d 65 74 first 4 paramet
bff0: 65 72 73 20 74 6f 0a 2a 2a 20 20 20 20 20 46 55 ers to.** FU
c000: 4e 43 54 49 4f 4e 28 29 2e 0a 2a 2a 0a 2a 2a 20 NCTION()..**.**
c010: 20 20 4c 49 4b 45 46 55 4e 43 28 7a 4e 61 6d 65 LIKEFUNC(zName
c020: 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c 20 66 6c , nArg, pArg, fl
c030: 61 67 73 29 0a 2a 2a 20 20 20 20 20 55 73 65 64 ags).** Used
c040: 20 74 6f 20 63 72 65 61 74 65 20 61 20 73 63 61 to create a sca
c050: 6c 61 72 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 lar function def
c060: 69 6e 69 74 69 6f 6e 20 6f 66 20 61 20 66 75 6e inition of a fun
c070: 63 74 69 6f 6e 20 7a 4e 61 6d 65 20 0a 2a 2a 20 ction zName .**
c080: 20 20 20 20 74 68 61 74 20 61 63 63 65 70 74 73 that accepts
c090: 20 6e 41 72 67 20 61 72 67 75 6d 65 6e 74 73 20 nArg arguments
c0a0: 61 6e 64 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 and is implement
c0b0: 65 64 20 62 79 20 61 20 63 61 6c 6c 20 74 6f 20 ed by a call to
c0c0: 43 20 0a 2a 2a 20 20 20 20 20 66 75 6e 63 74 69 C .** functi
c0d0: 6f 6e 20 6c 69 6b 65 46 75 6e 63 2e 20 41 72 67 on likeFunc. Arg
c0e0: 75 6d 65 6e 74 20 70 41 72 67 20 69 73 20 63 61 ument pArg is ca
c0f0: 73 74 20 74 6f 20 61 20 28 76 6f 69 64 20 2a 29 st to a (void *)
c100: 20 61 6e 64 20 6d 61 64 65 0a 2a 2a 20 20 20 20 and made.**
c110: 20 61 76 61 69 6c 61 62 6c 65 20 61 73 20 74 68 available as th
c120: 65 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 72 2d e function user-
c130: 64 61 74 61 20 28 73 71 6c 69 74 65 33 5f 75 73 data (sqlite3_us
c140: 65 72 5f 64 61 74 61 28 29 29 2e 20 54 68 65 0a er_data()). The.
c150: 2a 2a 20 20 20 20 20 46 75 6e 63 44 65 66 2e 66 ** FuncDef.f
c160: 6c 61 67 73 20 76 61 72 69 61 62 6c 65 20 69 73 lags variable is
c170: 20 73 65 74 20 74 6f 20 74 68 65 20 76 61 6c 75 set to the valu
c180: 65 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20 e passed as the
c190: 66 6c 61 67 73 0a 2a 2a 20 20 20 20 20 70 61 72 flags.** par
c1a0: 61 6d 65 74 65 72 2e 0a 2a 2f 0a 23 64 65 66 69 ameter..*/.#defi
c1b0: 6e 65 20 46 55 4e 43 54 49 4f 4e 28 7a 4e 61 6d ne FUNCTION(zNam
c1c0: 65 2c 20 6e 41 72 67 2c 20 69 41 72 67 2c 20 62 e, nArg, iArg, b
c1d0: 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 20 7b NC, xFunc) \. {
c1e0: 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e nArg, SQLITE_FUN
c1f0: 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 C_CONSTANT|SQLIT
c200: 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 E_UTF8|(bNC*SQLI
c210: 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
c220: 29 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 ), \. SQLITE_I
c230: 4e 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c NT_TO_PTR(iArg),
c240: 20 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 0, xFunc, 0, 0,
c250: 20 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 #zName, 0, 0}.#
c260: 64 65 66 69 6e 65 20 56 46 55 4e 43 54 49 4f 4e define VFUNCTION
c270: 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 (zName, nArg, iA
c280: 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 29 20 rg, bNC, xFunc)
c290: 5c 0a 20 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 \. {nArg, SQLIT
c2a0: 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 E_UTF8|(bNC*SQLI
c2b0: 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
c2c0: 29 2c 20 5c 0a 20 20 20 53 51 4c 49 54 45 5f 49 ), \. SQLITE_I
c2d0: 4e 54 5f 54 4f 5f 50 54 52 28 69 41 72 67 29 2c NT_TO_PTR(iArg),
c2e0: 20 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 0, xFunc, 0, 0,
c2f0: 20 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 #zName, 0, 0}.#
c300: 64 65 66 69 6e 65 20 46 55 4e 43 54 49 4f 4e 32 define FUNCTION2
c310: 28 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 69 41 (zName, nArg, iA
c320: 72 67 2c 20 62 4e 43 2c 20 78 46 75 6e 63 2c 20 rg, bNC, xFunc,
c330: 65 78 74 72 61 46 6c 61 67 73 29 20 5c 0a 20 20 extraFlags) \.
c340: 7b 6e 41 72 67 2c 53 51 4c 49 54 45 5f 46 55 4e {nArg,SQLITE_FUN
c350: 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 C_CONSTANT|SQLIT
c360: 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 4c 49 E_UTF8|(bNC*SQLI
c370: 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f 4c 4c TE_FUNC_NEEDCOLL
c380: 29 7c 65 78 74 72 61 46 6c 61 67 73 2c 5c 0a 20 )|extraFlags,\.
c390: 20 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f SQLITE_INT_TO_
c3a0: 50 54 52 28 69 41 72 67 29 2c 20 30 2c 20 78 46 PTR(iArg), 0, xF
c3b0: 75 6e 63 2c 20 30 2c 20 30 2c 20 23 7a 4e 61 6d unc, 0, 0, #zNam
c3c0: 65 2c 20 30 2c 20 30 7d 0a 23 64 65 66 69 6e 65 e, 0, 0}.#define
c3d0: 20 53 54 52 5f 46 55 4e 43 54 49 4f 4e 28 7a 4e STR_FUNCTION(zN
c3e0: 61 6d 65 2c 20 6e 41 72 67 2c 20 70 41 72 67 2c ame, nArg, pArg,
c3f0: 20 62 4e 43 2c 20 78 46 75 6e 63 29 20 5c 0a 20 bNC, xFunc) \.
c400: 20 7b 6e 41 72 67 2c 20 53 51 4c 49 54 45 5f 46 {nArg, SQLITE_F
c410: 55 4e 43 5f 43 4f 4e 53 54 41 4e 54 7c 53 51 4c UNC_CONSTANT|SQL
c420: 49 54 45 5f 55 54 46 38 7c 28 62 4e 43 2a 53 51 ITE_UTF8|(bNC*SQ
c430: 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 43 4f LITE_FUNC_NEEDCO
c440: 4c 4c 29 2c 20 5c 0a 20 20 20 70 41 72 67 2c 20 LL), \. pArg,
c450: 30 2c 20 78 46 75 6e 63 2c 20 30 2c 20 30 2c 20 0, xFunc, 0, 0,
c460: 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 #zName, 0, 0}.#d
c470: 65 66 69 6e 65 20 4c 49 4b 45 46 55 4e 43 28 7a efine LIKEFUNC(z
c480: 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 2c Name, nArg, arg,
c490: 20 66 6c 61 67 73 29 20 5c 0a 20 20 7b 6e 41 72 flags) \. {nAr
c4a0: 67 2c 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 43 g, SQLITE_FUNC_C
c4b0: 4f 4e 53 54 41 4e 54 7c 53 51 4c 49 54 45 5f 55 ONSTANT|SQLITE_U
c4c0: 54 46 38 7c 66 6c 61 67 73 2c 20 5c 0a 20 20 20 TF8|flags, \.
c4d0: 28 76 6f 69 64 20 2a 29 61 72 67 2c 20 30 2c 20 (void *)arg, 0,
c4e0: 6c 69 6b 65 46 75 6e 63 2c 20 30 2c 20 30 2c 20 likeFunc, 0, 0,
c4f0: 23 7a 4e 61 6d 65 2c 20 30 2c 20 30 7d 0a 23 64 #zName, 0, 0}.#d
c500: 65 66 69 6e 65 20 41 47 47 52 45 47 41 54 45 28 efine AGGREGATE(
c510: 7a 4e 61 6d 65 2c 20 6e 41 72 67 2c 20 61 72 67 zName, nArg, arg
c520: 2c 20 6e 63 2c 20 78 53 74 65 70 2c 20 78 46 69 , nc, xStep, xFi
c530: 6e 61 6c 29 20 5c 0a 20 20 7b 6e 41 72 67 2c 20 nal) \. {nArg,
c540: 53 51 4c 49 54 45 5f 55 54 46 38 7c 28 6e 63 2a SQLITE_UTF8|(nc*
c550: 53 51 4c 49 54 45 5f 46 55 4e 43 5f 4e 45 45 44 SQLITE_FUNC_NEED
c560: 43 4f 4c 4c 29 2c 20 5c 0a 20 20 20 53 51 4c 49 COLL), \. SQLI
c570: 54 45 5f 49 4e 54 5f 54 4f 5f 50 54 52 28 61 72 TE_INT_TO_PTR(ar
c580: 67 29 2c 20 30 2c 20 30 2c 20 78 53 74 65 70 2c g), 0, 0, xStep,
c590: 78 46 69 6e 61 6c 2c 23 7a 4e 61 6d 65 2c 30 2c xFinal,#zName,0,
c5a0: 30 7d 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 20 63 75 0}../*.** All cu
c5b0: 72 72 65 6e 74 20 73 61 76 65 70 6f 69 6e 74 73 rrent savepoints
c5c0: 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 20 61 are stored in a
c5d0: 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 73 74 61 linked list sta
c5e0: 72 74 69 6e 67 20 61 74 0a 2a 2a 20 73 71 6c 69 rting at.** sqli
c5f0: 74 65 33 2e 70 53 61 76 65 70 6f 69 6e 74 2e 20 te3.pSavepoint.
c600: 54 68 65 20 66 69 72 73 74 20 65 6c 65 6d 65 6e The first elemen
c610: 74 20 69 6e 20 74 68 65 20 6c 69 73 74 20 69 73 t in the list is
c620: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 the most recent
c630: 6c 79 0a 2a 2a 20 6f 70 65 6e 65 64 20 73 61 76 ly.** opened sav
c640: 65 70 6f 69 6e 74 2e 20 53 61 76 65 70 6f 69 6e epoint. Savepoin
c650: 74 73 20 61 72 65 20 61 64 64 65 64 20 74 6f 20 ts are added to
c660: 74 68 65 20 6c 69 73 74 20 62 79 20 74 68 65 20 the list by the
c670: 76 64 62 65 0a 2a 2a 20 4f 50 5f 53 61 76 65 70 vdbe.** OP_Savep
c680: 6f 69 6e 74 20 69 6e 73 74 72 75 63 74 69 6f 6e oint instruction
c690: 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 53 61 76 65 ..*/.struct Save
c6a0: 70 6f 69 6e 74 20 7b 0a 20 20 63 68 61 72 20 2a point {. char *
c6b0: 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20 zName;
c6c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c6d0: 20 53 61 76 65 70 6f 69 6e 74 20 6e 61 6d 65 20 Savepoint name
c6e0: 28 6e 75 6c 2d 74 65 72 6d 69 6e 61 74 65 64 29 (nul-terminated)
c6f0: 20 2a 2f 0a 20 20 69 36 34 20 6e 44 65 66 65 72 */. i64 nDefer
c700: 72 65 64 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 redCons;
c710: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
c720: 62 65 72 20 6f 66 20 64 65 66 65 72 72 65 64 20 ber of deferred
c730: 66 6b 20 76 69 6f 6c 61 74 69 6f 6e 73 20 2a 2f fk violations */
c740: 0a 20 20 69 36 34 20 6e 44 65 66 65 72 72 65 64 . i64 nDeferred
c750: 49 6d 6d 43 6f 6e 73 3b 20 20 20 20 20 20 20 20 ImmCons;
c760: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
c770: 20 6f 66 20 64 65 66 65 72 72 65 64 20 69 6d 6d of deferred imm
c780: 20 66 6b 2e 20 2a 2f 0a 20 20 53 61 76 65 70 6f fk. */. Savepo
c790: 69 6e 74 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 int *pNext;
c7a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c7b0: 20 50 61 72 65 6e 74 20 73 61 76 65 70 6f 69 6e Parent savepoin
c7c0: 74 20 28 69 66 20 61 6e 79 29 20 2a 2f 0a 7d 3b t (if any) */.};
c7d0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c ../*.** The foll
c7e0: 6f 77 69 6e 67 20 61 72 65 20 75 73 65 64 20 61 owing are used a
c7f0: 73 20 74 68 65 20 73 65 63 6f 6e 64 20 70 61 72 s the second par
c800: 61 6d 65 74 65 72 20 74 6f 20 73 71 6c 69 74 65 ameter to sqlite
c810: 33 53 61 76 65 70 6f 69 6e 74 28 29 2c 0a 2a 2a 3Savepoint(),.**
c820: 20 61 6e 64 20 61 73 20 74 68 65 20 50 31 20 61 and as the P1 a
c830: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 4f rgument to the O
c840: 50 5f 53 61 76 65 70 6f 69 6e 74 20 69 6e 73 74 P_Savepoint inst
c850: 72 75 63 74 69 6f 6e 2e 0a 2a 2f 0a 23 64 65 66 ruction..*/.#def
c860: 69 6e 65 20 53 41 56 45 50 4f 49 4e 54 5f 42 45 ine SAVEPOINT_BE
c870: 47 49 4e 20 20 20 20 20 20 30 0a 23 64 65 66 69 GIN 0.#defi
c880: 6e 65 20 53 41 56 45 50 4f 49 4e 54 5f 52 45 4c ne SAVEPOINT_REL
c890: 45 41 53 45 20 20 20 20 31 0a 23 64 65 66 69 6e EASE 1.#defin
c8a0: 65 20 53 41 56 45 50 4f 49 4e 54 5f 52 4f 4c 4c e SAVEPOINT_ROLL
c8b0: 42 41 43 4b 20 20 20 32 0a 0a 0a 2f 2a 0a 2a 2a BACK 2.../*.**
c8c0: 20 45 61 63 68 20 53 51 4c 69 74 65 20 6d 6f 64 Each SQLite mod
c8d0: 75 6c 65 20 28 76 69 72 74 75 61 6c 20 74 61 62 ule (virtual tab
c8e0: 6c 65 20 64 65 66 69 6e 69 74 69 6f 6e 29 20 69 le definition) i
c8f0: 73 20 64 65 66 69 6e 65 64 20 62 79 20 61 6e 0a s defined by an.
c900: 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 ** instance of t
c910: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 he following str
c920: 75 63 74 75 72 65 2c 20 73 74 6f 72 65 64 20 69 ucture, stored i
c930: 6e 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61 4d n the sqlite3.aM
c940: 6f 64 75 6c 65 0a 2a 2a 20 68 61 73 68 20 74 61 odule.** hash ta
c950: 62 6c 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4d ble..*/.struct M
c960: 6f 64 75 6c 65 20 7b 0a 20 20 63 6f 6e 73 74 20 odule {. const
c970: 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a sqlite3_module *
c980: 70 4d 6f 64 75 6c 65 3b 20 20 20 20 20 20 20 2f pModule; /
c990: 2a 20 43 61 6c 6c 62 61 63 6b 20 70 6f 69 6e 74 * Callback point
c9a0: 65 72 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 ers */. const c
c9b0: 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
c9c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
c9d0: 20 4e 61 6d 65 20 70 61 73 73 65 64 20 74 6f 20 Name passed to
c9e0: 63 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 29 20 create_module()
c9f0: 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 75 78 3b */. void *pAux;
ca00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ca10: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 41 75 /* pAu
ca20: 78 20 70 61 73 73 65 64 20 74 6f 20 63 72 65 61 x passed to crea
ca30: 74 65 5f 6d 6f 64 75 6c 65 28 29 20 2a 2f 0a 20 te_module() */.
ca40: 20 76 6f 69 64 20 28 2a 78 44 65 73 74 72 6f 79 void (*xDestroy
ca50: 29 28 76 6f 69 64 20 2a 29 3b 20 20 20 20 20 20 )(void *);
ca60: 20 20 20 20 20 20 2f 2a 20 4d 6f 64 75 6c 65 20 /* Module
ca70: 64 65 73 74 72 75 63 74 6f 72 20 66 75 6e 63 74 destructor funct
ca80: 69 6f 6e 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a ion */.};../*.**
ca90: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f information abo
caa0: 75 74 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 6f ut each column o
cab0: 66 20 61 6e 20 53 51 4c 20 74 61 62 6c 65 20 69 f an SQL table i
cac0: 73 20 68 65 6c 64 20 69 6e 20 61 6e 20 69 6e 73 s held in an ins
cad0: 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 69 73 tance.** of this
cae0: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 structure..*/.s
caf0: 74 72 75 63 74 20 43 6f 6c 75 6d 6e 20 7b 0a 20 truct Column {.
cb00: 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 char *zName;
cb10: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 /* Name of thi
cb20: 73 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 45 78 s column */. Ex
cb30: 70 72 20 2a 70 44 66 6c 74 3b 20 20 20 20 20 2f pr *pDflt; /
cb40: 2a 20 44 65 66 61 75 6c 74 20 76 61 6c 75 65 20 * Default value
cb50: 6f 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a of this column *
cb60: 2f 0a 20 20 63 68 61 72 20 2a 7a 44 66 6c 74 3b /. char *zDflt;
cb70: 20 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c /* Original
cb80: 20 74 65 78 74 20 6f 66 20 74 68 65 20 64 65 66 text of the def
cb90: 61 75 6c 74 20 76 61 6c 75 65 20 2a 2f 0a 20 20 ault value */.
cba0: 63 68 61 72 20 2a 7a 54 79 70 65 3b 20 20 20 20 char *zType;
cbb0: 20 2f 2a 20 44 61 74 61 20 74 79 70 65 20 66 6f /* Data type fo
cbc0: 72 20 74 68 69 73 20 63 6f 6c 75 6d 6e 20 2a 2f r this column */
cbd0: 0a 20 20 63 68 61 72 20 2a 7a 43 6f 6c 6c 3b 20 . char *zColl;
cbe0: 20 20 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 /* Collating
cbf0: 20 73 65 71 75 65 6e 63 65 2e 20 20 49 66 20 4e sequence. If N
cc00: 55 4c 4c 2c 20 75 73 65 20 74 68 65 20 64 65 66 ULL, use the def
cc10: 61 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6e 6f 74 ault */. u8 not
cc20: 4e 75 6c 6c 3b 20 20 20 20 20 20 2f 2a 20 41 6e Null; /* An
cc30: 20 4f 45 5f 20 63 6f 64 65 20 66 6f 72 20 68 61 OE_ code for ha
cc40: 6e 64 6c 69 6e 67 20 61 20 4e 4f 54 20 4e 55 4c ndling a NOT NUL
cc50: 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a L constraint */.
cc60: 20 20 63 68 61 72 20 61 66 66 69 6e 69 74 79 3b char affinity;
cc70: 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 /* One of the
cc80: 20 53 51 4c 49 54 45 5f 41 46 46 5f 2e 2e 2e 20 SQLITE_AFF_...
cc90: 76 61 6c 75 65 73 20 2a 2f 0a 20 20 75 38 20 73 values */. u8 s
cca0: 7a 45 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 zEst; /*
ccb0: 45 73 74 69 6d 61 74 65 64 20 73 69 7a 65 20 6f Estimated size o
ccc0: 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 2e 20 20 f this column.
ccd0: 49 4e 54 3d 3d 31 20 2a 2f 0a 20 20 75 38 20 63 INT==1 */. u8 c
cce0: 6f 6c 46 6c 61 67 73 3b 20 20 20 20 20 2f 2a 20 olFlags; /*
ccf0: 42 6f 6f 6c 65 61 6e 20 70 72 6f 70 65 72 74 69 Boolean properti
cd00: 65 73 2e 20 20 53 65 65 20 43 4f 4c 46 4c 41 47 es. See COLFLAG
cd10: 5f 20 64 65 66 69 6e 65 73 20 62 65 6c 6f 77 20 _ defines below
cd20: 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 41 6c 6c 6f 77 65 */.};../* Allowe
cd30: 64 20 76 61 6c 75 65 73 20 66 6f 72 20 43 6f 6c d values for Col
cd40: 75 6d 6e 2e 63 6f 6c 46 6c 61 67 73 3a 0a 2a 2f umn.colFlags:.*/
cd50: 0a 23 64 65 66 69 6e 65 20 43 4f 4c 46 4c 41 47 .#define COLFLAG
cd60: 5f 50 52 49 4d 4b 45 59 20 20 30 78 30 30 30 31 _PRIMKEY 0x0001
cd70: 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 69 73 /* Column is
cd80: 20 70 61 72 74 20 6f 66 20 74 68 65 20 70 72 69 part of the pri
cd90: 6d 61 72 79 20 6b 65 79 20 2a 2f 0a 23 64 65 66 mary key */.#def
cda0: 69 6e 65 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 ine COLFLAG_HIDD
cdb0: 45 4e 20 20 20 30 78 30 30 30 32 20 20 20 20 2f EN 0x0002 /
cdc0: 2a 20 41 20 68 69 64 64 65 6e 20 63 6f 6c 75 6d * A hidden colum
cdd0: 6e 20 69 6e 20 61 20 76 69 72 74 75 61 6c 20 74 n in a virtual t
cde0: 61 62 6c 65 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 able */../*.** A
cdf0: 20 22 43 6f 6c 6c 61 74 69 6e 67 20 53 65 71 75 "Collating Sequ
ce00: 65 6e 63 65 22 20 69 73 20 64 65 66 69 6e 65 64 ence" is defined
ce10: 20 62 79 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 by an instance
ce20: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
ce30: 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 2e 20 43 .** structure. C
ce40: 6f 6e 63 65 70 74 75 61 6c 6c 79 2c 20 61 20 63 onceptually, a c
ce50: 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 ollating sequenc
ce60: 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 e consists of a
ce70: 6e 61 6d 65 20 61 6e 64 0a 2a 2a 20 61 20 63 6f name and.** a co
ce80: 6d 70 61 72 69 73 6f 6e 20 72 6f 75 74 69 6e 65 mparison routine
ce90: 20 74 68 61 74 20 64 65 66 69 6e 65 73 20 74 68 that defines th
cea0: 65 20 6f 72 64 65 72 20 6f 66 20 74 68 61 74 20 e order of that
ceb0: 73 65 71 75 65 6e 63 65 2e 0a 2a 2a 0a 2a 2a 20 sequence..**.**
cec0: 49 66 20 43 6f 6c 6c 53 65 71 2e 78 43 6d 70 20 If CollSeq.xCmp
ced0: 69 73 20 4e 55 4c 4c 2c 20 69 74 20 6d 65 61 6e is NULL, it mean
cee0: 73 20 74 68 61 74 20 74 68 65 0a 2a 2a 20 63 6f s that the.** co
cef0: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
cf00: 20 69 73 20 75 6e 64 65 66 69 6e 65 64 2e 20 20 is undefined.
cf10: 49 6e 64 69 63 65 73 20 62 75 69 6c 74 20 6f 6e Indices built on
cf20: 20 61 6e 20 75 6e 64 65 66 69 6e 65 64 0a 2a 2a an undefined.**
cf30: 20 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 collating seque
cf40: 6e 63 65 20 6d 61 79 20 6e 6f 74 20 62 65 20 72 nce may not be r
cf50: 65 61 64 20 6f 72 20 77 72 69 74 74 65 6e 2e 0a ead or written..
cf60: 2a 2f 0a 73 74 72 75 63 74 20 43 6f 6c 6c 53 65 */.struct CollSe
cf70: 71 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d q {. char *zNam
cf80: 65 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e e; /* N
cf90: 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 6c 61 ame of the colla
cfa0: 74 69 6e 67 20 73 65 71 75 65 6e 63 65 2c 20 55 ting sequence, U
cfb0: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 2a 2f 0a TF-8 encoded */.
cfc0: 20 20 75 38 20 65 6e 63 3b 20 20 20 20 20 20 20 u8 enc;
cfd0: 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 /* Text
cfe0: 65 6e 63 6f 64 69 6e 67 20 68 61 6e 64 6c 65 64 encoding handled
cff0: 20 62 79 20 78 43 6d 70 28 29 20 2a 2f 0a 20 20 by xCmp() */.
d000: 76 6f 69 64 20 2a 70 55 73 65 72 3b 20 20 20 20 void *pUser;
d010: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 /* First a
d020: 72 67 75 6d 65 6e 74 20 74 6f 20 78 43 6d 70 28 rgument to xCmp(
d030: 29 20 2a 2f 0a 20 20 69 6e 74 20 28 2a 78 43 6d ) */. int (*xCm
d040: 70 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 20 63 6f p)(void*,int, co
d050: 6e 73 74 20 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 nst void*, int,
d060: 63 6f 6e 73 74 20 76 6f 69 64 2a 29 3b 0a 20 20 const void*);.
d070: 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76 6f 69 void (*xDel)(voi
d080: 64 2a 29 3b 20 20 2f 2a 20 44 65 73 74 72 75 63 d*); /* Destruc
d090: 74 6f 72 20 66 6f 72 20 70 55 73 65 72 20 2a 2f tor for pUser */
d0a0: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 73 6f 72 .};../*.** A sor
d0b0: 74 20 6f 72 64 65 72 20 63 61 6e 20 62 65 20 65 t order can be e
d0c0: 69 74 68 65 72 20 41 53 43 20 6f 72 20 44 45 53 ither ASC or DES
d0d0: 43 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 C..*/.#define SQ
d0e0: 4c 49 54 45 5f 53 4f 5f 41 53 43 20 20 20 20 20 LITE_SO_ASC
d0f0: 20 20 30 20 20 2f 2a 20 53 6f 72 74 20 69 6e 20 0 /* Sort in
d100: 61 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 ascending order
d110: 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
d120: 45 5f 53 4f 5f 44 45 53 43 20 20 20 20 20 20 31 E_SO_DESC 1
d130: 20 20 2f 2a 20 53 6f 72 74 20 69 6e 20 61 73 63 /* Sort in asc
d140: 65 6e 64 69 6e 67 20 6f 72 64 65 72 20 2a 2f 0a ending order */.
d150: 0a 2f 2a 0a 2a 2a 20 43 6f 6c 75 6d 6e 20 61 66 ./*.** Column af
d160: 66 69 6e 69 74 79 20 74 79 70 65 73 2e 0a 2a 2a finity types..**
d170: 0a 2a 2a 20 54 68 65 73 65 20 75 73 65 64 20 74 .** These used t
d180: 6f 20 68 61 76 65 20 6d 6e 65 6d 6f 6e 69 63 20 o have mnemonic
d190: 6e 61 6d 65 20 6c 69 6b 65 20 27 69 27 20 66 6f name like 'i' fo
d1a0: 72 20 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 r SQLITE_AFF_INT
d1b0: 45 47 45 52 20 61 6e 64 0a 2a 2a 20 27 74 27 20 EGER and.** 't'
d1c0: 66 6f 72 20 53 51 4c 49 54 45 5f 41 46 46 5f 54 for SQLITE_AFF_T
d1d0: 45 58 54 2e 20 20 42 75 74 20 77 65 20 63 61 6e EXT. But we can
d1e0: 20 73 61 76 65 20 61 20 6c 69 74 74 6c 65 20 73 save a little s
d1f0: 70 61 63 65 20 61 6e 64 20 69 6d 70 72 6f 76 65 pace and improve
d200: 0a 2a 2a 20 74 68 65 20 73 70 65 65 64 20 61 20 .** the speed a
d210: 6c 69 74 74 6c 65 20 62 79 20 6e 75 6d 62 65 72 little by number
d220: 69 6e 67 20 74 68 65 20 76 61 6c 75 65 73 20 63 ing the values c
d230: 6f 6e 73 65 63 75 74 69 76 65 6c 79 2e 20 20 0a onsecutively. .
d240: 2a 2a 0a 2a 2a 20 42 75 74 20 72 61 74 68 65 72 **.** But rather
d250: 20 74 68 61 6e 20 73 74 61 72 74 20 77 69 74 68 than start with
d260: 20 30 20 6f 72 20 31 2c 20 77 65 20 62 65 67 69 0 or 1, we begi
d270: 6e 20 77 69 74 68 20 27 61 27 2e 20 20 54 68 61 n with 'a'. Tha
d280: 74 20 77 61 79 2c 0a 2a 2a 20 77 68 65 6e 20 6d t way,.** when m
d290: 75 6c 74 69 70 6c 65 20 61 66 66 69 6e 69 74 79 ultiple affinity
d2a0: 20 74 79 70 65 73 20 61 72 65 20 63 6f 6e 63 61 types are conca
d2b0: 74 65 6e 61 74 65 64 20 69 6e 74 6f 20 61 20 73 tenated into a s
d2c0: 74 72 69 6e 67 20 61 6e 64 0a 2a 2a 20 75 73 65 tring and.** use
d2d0: 64 20 61 73 20 74 68 65 20 50 34 20 6f 70 65 72 d as the P4 oper
d2e0: 61 6e 64 2c 20 74 68 65 79 20 77 69 6c 6c 20 62 and, they will b
d2f0: 65 20 6d 6f 72 65 20 72 65 61 64 61 62 6c 65 2e e more readable.
d300: 0a 2a 2a 0a 2a 2a 20 4e 6f 74 65 20 61 6c 73 6f .**.** Note also
d310: 20 74 68 61 74 20 74 68 65 20 6e 75 6d 65 72 69 that the numeri
d320: 63 20 74 79 70 65 73 20 61 72 65 20 67 72 6f 75 c types are grou
d330: 70 65 64 20 74 6f 67 65 74 68 65 72 20 73 6f 20 ped together so
d340: 74 68 61 74 20 74 65 73 74 69 6e 67 0a 2a 2a 20 that testing.**
d350: 66 6f 72 20 61 20 6e 75 6d 65 72 69 63 20 74 79 for a numeric ty
d360: 70 65 20 69 73 20 61 20 73 69 6e 67 6c 65 20 63 pe is a single c
d370: 6f 6d 70 61 72 69 73 6f 6e 2e 0a 2a 2f 0a 23 64 omparison..*/.#d
d380: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 efine SQLITE_AFF
d390: 5f 54 45 58 54 20 20 20 20 20 27 61 27 0a 23 64 _TEXT 'a'.#d
d3a0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 efine SQLITE_AFF
d3b0: 5f 4e 4f 4e 45 20 20 20 20 20 27 62 27 0a 23 64 _NONE 'b'.#d
d3c0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 efine SQLITE_AFF
d3d0: 5f 4e 55 4d 45 52 49 43 20 20 27 63 27 0a 23 64 _NUMERIC 'c'.#d
d3e0: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 efine SQLITE_AFF
d3f0: 5f 49 4e 54 45 47 45 52 20 20 27 64 27 0a 23 64 _INTEGER 'd'.#d
d400: 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 efine SQLITE_AFF
d410: 5f 52 45 41 4c 20 20 20 20 20 27 65 27 0a 0a 23 _REAL 'e'..#
d420: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 define sqlite3Is
d430: 4e 75 6d 65 72 69 63 41 66 66 69 6e 69 74 79 28 NumericAffinity(
d440: 58 29 20 20 28 28 58 29 3e 3d 53 51 4c 49 54 45 X) ((X)>=SQLITE
d450: 5f 41 46 46 5f 4e 55 4d 45 52 49 43 29 0a 0a 2f _AFF_NUMERIC)../
d460: 2a 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f *.** The SQLITE_
d470: 41 46 46 5f 4d 41 53 4b 20 76 61 6c 75 65 73 20 AFF_MASK values
d480: 6d 61 73 6b 73 20 6f 66 66 20 74 68 65 20 73 69 masks off the si
d490: 67 6e 69 66 69 63 61 6e 74 20 62 69 74 73 20 6f gnificant bits o
d4a0: 66 20 61 6e 0a 2a 2a 20 61 66 66 69 6e 69 74 79 f an.** affinity
d4b0: 20 76 61 6c 75 65 2e 20 0a 2a 2f 0a 23 64 65 66 value. .*/.#def
d4c0: 69 6e 65 20 53 51 4c 49 54 45 5f 41 46 46 5f 4d ine SQLITE_AFF_M
d4d0: 41 53 4b 20 20 20 20 20 30 78 36 37 0a 0a 2f 2a ASK 0x67../*
d4e0: 0a 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c 20 62 .** Additional b
d4f0: 69 74 20 76 61 6c 75 65 73 20 74 68 61 74 20 63 it values that c
d500: 61 6e 20 62 65 20 4f 52 65 64 20 77 69 74 68 20 an be ORed with
d510: 61 6e 20 61 66 66 69 6e 69 74 79 20 77 69 74 68 an affinity with
d520: 6f 75 74 0a 2a 2a 20 63 68 61 6e 67 69 6e 67 20 out.** changing
d530: 74 68 65 20 61 66 66 69 6e 69 74 79 2e 0a 2a 2a the affinity..**
d540: 0a 2a 2a 20 54 68 65 20 53 51 4c 49 54 45 5f 4e .** The SQLITE_N
d550: 4f 54 4e 55 4c 4c 20 66 6c 61 67 20 69 73 20 61 OTNULL flag is a
d560: 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 6f 66 20 combination of
d570: 4e 55 4c 4c 45 51 20 61 6e 64 20 4a 55 4d 50 49 NULLEQ and JUMPI
d580: 46 4e 55 4c 4c 2e 0a 2a 2a 20 49 74 20 63 61 75 FNULL..** It cau
d590: 73 65 73 20 61 6e 20 61 73 73 65 72 74 28 29 20 ses an assert()
d5a0: 74 6f 20 66 69 72 65 20 69 66 20 65 69 74 68 65 to fire if eithe
d5b0: 72 20 6f 70 65 72 61 6e 64 20 74 6f 20 61 20 63 r operand to a c
d5c0: 6f 6d 70 61 72 69 73 6f 6e 0a 2a 2a 20 6f 70 65 omparison.** ope
d5d0: 72 61 74 6f 72 20 69 73 20 4e 55 4c 4c 2e 20 20 rator is NULL.
d5e0: 49 74 20 69 73 20 61 64 64 65 64 20 74 6f 20 63 It is added to c
d5f0: 65 72 74 61 69 6e 20 63 6f 6d 70 61 72 69 73 6f ertain compariso
d600: 6e 20 6f 70 65 72 61 74 6f 72 73 20 74 6f 0a 2a n operators to.*
d610: 2a 20 70 72 6f 76 65 20 74 68 61 74 20 74 68 65 * prove that the
d620: 20 6f 70 65 72 61 6e 64 73 20 61 72 65 20 61 6c operands are al
d630: 77 61 79 73 20 4e 4f 54 20 4e 55 4c 4c 2e 0a 2a ways NOT NULL..*
d640: 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 /.#define SQLITE
d650: 5f 4a 55 4d 50 49 46 4e 55 4c 4c 20 20 20 30 78 _JUMPIFNULL 0x
d660: 30 38 20 20 2f 2a 20 6a 75 6d 70 73 20 69 66 20 08 /* jumps if
d670: 65 69 74 68 65 72 20 6f 70 65 72 61 6e 64 20 69 either operand i
d680: 73 20 4e 55 4c 4c 20 2a 2f 0a 23 64 65 66 69 6e s NULL */.#defin
d690: 65 20 53 51 4c 49 54 45 5f 53 54 4f 52 45 50 32 e SQLITE_STOREP2
d6a0: 20 20 20 20 20 20 30 78 31 30 20 20 2f 2a 20 53 0x10 /* S
d6b0: 74 6f 72 65 20 72 65 73 75 6c 74 20 69 6e 20 72 tore result in r
d6c0: 65 67 5b 50 32 5d 20 72 61 74 68 65 72 20 74 68 eg[P2] rather th
d6d0: 61 6e 20 6a 75 6d 70 20 2a 2f 0a 23 64 65 66 69 an jump */.#defi
d6e0: 6e 65 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 45 51 ne SQLITE_NULLEQ
d6f0: 20 20 20 20 20 20 20 30 78 38 30 20 20 2f 2a 20 0x80 /*
d700: 4e 55 4c 4c 3d 4e 55 4c 4c 20 2a 2f 0a 23 64 65 NULL=NULL */.#de
d710: 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 4f 54 4e fine SQLITE_NOTN
d720: 55 4c 4c 20 20 20 20 20 20 30 78 38 38 20 20 2f ULL 0x88 /
d730: 2a 20 41 73 73 65 72 74 20 74 68 61 74 20 6f 70 * Assert that op
d740: 65 72 61 6e 64 73 20 61 72 65 20 6e 65 76 65 72 erands are never
d750: 20 4e 55 4c 4c 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 NULL */../*.**
d760: 41 6e 20 6f 62 6a 65 63 74 20 6f 66 20 74 68 69 An object of thi
d770: 73 20 74 79 70 65 20 69 73 20 63 72 65 61 74 65 s type is create
d780: 64 20 66 6f 72 20 65 61 63 68 20 76 69 72 74 75 d for each virtu
d790: 61 6c 20 74 61 62 6c 65 20 70 72 65 73 65 6e 74 al table present
d7a0: 20 69 6e 0a 2a 2a 20 74 68 65 20 64 61 74 61 62 in.** the datab
d7b0: 61 73 65 20 73 63 68 65 6d 61 2e 20 0a 2a 2a 0a ase schema. .**.
d7c0: 2a 2a 20 49 66 20 74 68 65 20 64 61 74 61 62 61 ** If the databa
d7d0: 73 65 20 73 63 68 65 6d 61 20 69 73 20 73 68 61 se schema is sha
d7e0: 72 65 64 2c 20 74 68 65 6e 20 74 68 65 72 65 20 red, then there
d7f0: 69 73 20 6f 6e 65 20 69 6e 73 74 61 6e 63 65 20 is one instance
d800: 6f 66 20 74 68 69 73 0a 2a 2a 20 73 74 72 75 63 of this.** struc
d810: 74 75 72 65 20 66 6f 72 20 65 61 63 68 20 64 61 ture for each da
d820: 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f tabase connectio
d830: 6e 20 28 73 71 6c 69 74 65 33 2a 29 20 74 68 61 n (sqlite3*) tha
d840: 74 20 75 73 65 73 20 74 68 65 20 73 68 61 72 65 t uses the share
d850: 64 0a 2a 2a 20 73 63 68 65 6d 61 2e 20 54 68 69 d.** schema. Thi
d860: 73 20 69 73 20 62 65 63 61 75 73 65 20 65 61 63 s is because eac
d870: 68 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 h database conne
d880: 63 74 69 6f 6e 20 72 65 71 75 69 72 65 73 20 69 ction requires i
d890: 74 73 20 6f 77 6e 20 75 6e 69 71 75 65 0a 2a 2a ts own unique.**
d8a0: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
d8b0: 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 20 68 sqlite3_vtab* h
d8c0: 61 6e 64 6c 65 20 75 73 65 64 20 74 6f 20 61 63 andle used to ac
d8d0: 63 65 73 73 20 74 68 65 20 76 69 72 74 75 61 6c cess the virtual
d8e0: 20 74 61 62 6c 65 20 0a 2a 2a 20 69 6d 70 6c 65 table .** imple
d8f0: 6d 65 6e 74 61 74 69 6f 6e 2e 20 73 71 6c 69 74 mentation. sqlit
d900: 65 33 5f 76 74 61 62 2a 20 68 61 6e 64 6c 65 73 e3_vtab* handles
d910: 20 63 61 6e 20 6e 6f 74 20 62 65 20 73 68 61 72 can not be shar
d920: 65 64 20 62 65 74 77 65 65 6e 20 0a 2a 2a 20 64 ed between .** d
d930: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 atabase connecti
d940: 6f 6e 73 2c 20 65 76 65 6e 20 77 68 65 6e 20 74 ons, even when t
d950: 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 69 he rest of the i
d960: 6e 2d 6d 65 6d 6f 72 79 20 64 61 74 61 62 61 73 n-memory databas
d970: 65 20 0a 2a 2a 20 73 63 68 65 6d 61 20 69 73 20 e .** schema is
d980: 73 68 61 72 65 64 2c 20 61 73 20 74 68 65 20 69 shared, as the i
d990: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 mplementation of
d9a0: 74 65 6e 20 73 74 6f 72 65 73 20 74 68 65 20 64 ten stores the d
d9b0: 61 74 61 62 61 73 65 0a 2a 2a 20 63 6f 6e 6e 65 atabase.** conne
d9c0: 63 74 69 6f 6e 20 68 61 6e 64 6c 65 20 70 61 73 ction handle pas
d9d0: 73 65 64 20 74 6f 20 69 74 20 76 69 61 20 74 68 sed to it via th
d9e0: 65 20 78 43 6f 6e 6e 65 63 74 28 29 20 6f 72 20 e xConnect() or
d9f0: 78 43 72 65 61 74 65 28 29 20 6d 65 74 68 6f 64 xCreate() method
da00: 0a 2a 2a 20 64 75 72 69 6e 67 20 69 6e 69 74 69 .** during initi
da10: 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 74 65 72 6e alization intern
da20: 61 6c 6c 79 2e 20 54 68 69 73 20 64 61 74 61 62 ally. This datab
da30: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 ase connection h
da40: 61 6e 64 6c 65 20 6d 61 79 0a 2a 2a 20 74 68 65 andle may.** the
da50: 6e 20 62 65 20 75 73 65 64 20 62 79 20 74 68 65 n be used by the
da60: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 69 virtual table i
da70: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 74 6f mplementation to
da80: 20 61 63 63 65 73 73 20 72 65 61 6c 20 74 61 62 access real tab
da90: 6c 65 73 20 0a 2a 2a 20 77 69 74 68 69 6e 20 74 les .** within t
daa0: 68 65 20 64 61 74 61 62 61 73 65 2e 20 53 6f 20 he database. So
dab0: 74 68 61 74 20 74 68 65 79 20 61 70 70 65 61 72 that they appear
dac0: 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 as part of the
dad0: 63 61 6c 6c 65 72 73 20 0a 2a 2a 20 74 72 61 6e callers .** tran
dae0: 73 61 63 74 69 6f 6e 2c 20 74 68 65 73 65 20 61 saction, these a
daf0: 63 63 65 73 73 65 73 20 6e 65 65 64 20 74 6f 20 ccesses need to
db00: 62 65 20 6d 61 64 65 20 76 69 61 20 74 68 65 20 be made via the
db10: 73 61 6d 65 20 64 61 74 61 62 61 73 65 20 0a 2a same database .*
db20: 2a 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 61 73 20 * connection as
db30: 74 68 61 74 20 75 73 65 64 20 74 6f 20 65 78 65 that used to exe
db40: 63 75 74 65 20 53 51 4c 20 6f 70 65 72 61 74 69 cute SQL operati
db50: 6f 6e 73 20 6f 6e 20 74 68 65 20 76 69 72 74 75 ons on the virtu
db60: 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 al table..**.**
db70: 41 6c 6c 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 All VTable objec
db80: 74 73 20 74 68 61 74 20 63 6f 72 72 65 73 70 6f ts that correspo
db90: 6e 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 74 nd to a single t
dba0: 61 62 6c 65 20 69 6e 20 61 20 73 68 61 72 65 64 able in a shared
dbb0: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 .** database sch
dbc0: 65 6d 61 20 61 72 65 20 69 6e 69 74 69 61 6c 6c ema are initiall
dbd0: 79 20 73 74 6f 72 65 64 20 69 6e 20 61 20 6c 69 y stored in a li
dbe0: 6e 6b 65 64 2d 6c 69 73 74 20 70 6f 69 6e 74 65 nked-list pointe
dbf0: 64 20 74 6f 20 62 79 0a 2a 2a 20 74 68 65 20 54 d to by.** the T
dc00: 61 62 6c 65 2e 70 56 54 61 62 6c 65 20 6d 65 6d able.pVTable mem
dc10: 62 65 72 20 76 61 72 69 61 62 6c 65 20 6f 66 20 ber variable of
dc20: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
dc30: 67 20 54 61 62 6c 65 20 6f 62 6a 65 63 74 2e 0a g Table object..
dc40: 2a 2a 20 57 68 65 6e 20 61 6e 20 73 71 6c 69 74 ** When an sqlit
dc50: 65 33 5f 70 72 65 70 61 72 65 28 29 20 6f 70 65 e3_prepare() ope
dc60: 72 61 74 69 6f 6e 20 69 73 20 72 65 71 75 69 72 ration is requir
dc70: 65 64 20 74 6f 20 61 63 63 65 73 73 20 74 68 65 ed to access the
dc80: 20 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c virtual.** tabl
dc90: 65 2c 20 69 74 20 73 65 61 72 63 68 65 73 20 74 e, it searches t
dca0: 68 65 20 6c 69 73 74 20 66 6f 72 20 74 68 65 20 he list for the
dcb0: 56 54 61 62 6c 65 20 74 68 61 74 20 63 6f 72 72 VTable that corr
dcc0: 65 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 0a 2a esponds to the.*
dcd0: 2a 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 * database conne
dce0: 63 74 69 6f 6e 20 64 6f 69 6e 67 20 74 68 65 20 ction doing the
dcf0: 70 72 65 70 61 72 69 6e 67 20 73 6f 20 61 73 20 preparing so as
dd00: 74 6f 20 75 73 65 20 74 68 65 20 63 6f 72 72 65 to use the corre
dd10: 63 74 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 76 74 ct.** sqlite3_vt
dd20: 61 62 2a 20 68 61 6e 64 6c 65 20 69 6e 20 74 68 ab* handle in th
dd30: 65 20 63 6f 6d 70 69 6c 65 64 20 71 75 65 72 79 e compiled query
dd40: 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e 20 61 6e 20 ..**.** When an
dd50: 69 6e 2d 6d 65 6d 6f 72 79 20 54 61 62 6c 65 20 in-memory Table
dd60: 6f 62 6a 65 63 74 20 69 73 20 64 65 6c 65 74 65 object is delete
dd70: 64 20 28 66 6f 72 20 65 78 61 6d 70 6c 65 20 77 d (for example w
dd80: 68 65 6e 20 74 68 65 0a 2a 2a 20 73 63 68 65 6d hen the.** schem
dd90: 61 20 69 73 20 62 65 69 6e 67 20 72 65 6c 6f 61 a is being reloa
dda0: 64 65 64 20 66 6f 72 20 73 6f 6d 65 20 72 65 61 ded for some rea
ddb0: 73 6f 6e 29 2c 20 74 68 65 20 56 54 61 62 6c 65 son), the VTable
ddc0: 20 6f 62 6a 65 63 74 73 20 61 72 65 20 6e 6f 74 objects are not
ddd0: 20 0a 2a 2a 20 64 65 6c 65 74 65 64 20 61 6e 64 .** deleted and
dde0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 76 74 61 the sqlite3_vta
ddf0: 62 2a 20 68 61 6e 64 6c 65 73 20 61 72 65 20 6e b* handles are n
de00: 6f 74 20 78 44 69 73 63 6f 6e 6e 65 63 74 28 29 ot xDisconnect()
de10: 65 64 20 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 ed .** immediate
de20: 6c 79 2e 20 49 6e 73 74 65 61 64 2c 20 74 68 65 ly. Instead, the
de30: 79 20 61 72 65 20 6d 6f 76 65 64 20 66 72 6f 6d y are moved from
de40: 20 74 68 65 20 54 61 62 6c 65 2e 70 56 54 61 62 the Table.pVTab
de50: 6c 65 20 6c 69 73 74 20 74 6f 0a 2a 2a 20 61 6e le list to.** an
de60: 6f 74 68 65 72 20 6c 69 6e 6b 65 64 20 6c 69 73 other linked lis
de70: 74 20 68 65 61 64 65 64 20 62 79 20 74 68 65 20 t headed by the
de80: 73 71 6c 69 74 65 33 2e 70 44 69 73 63 6f 6e 6e sqlite3.pDisconn
de90: 65 63 74 20 6d 65 6d 62 65 72 20 6f 66 20 74 68 ect member of th
dea0: 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e 64 69 e.** correspondi
deb0: 6e 67 20 73 71 6c 69 74 65 33 20 73 74 72 75 63 ng sqlite3 struc
dec0: 74 75 72 65 2e 20 54 68 65 79 20 61 72 65 20 74 ture. They are t
ded0: 68 65 6e 20 64 65 6c 65 74 65 64 2f 78 44 69 73 hen deleted/xDis
dee0: 63 6f 6e 6e 65 63 74 65 64 20 0a 2a 2a 20 6e 65 connected .** ne
def0: 78 74 20 74 69 6d 65 20 61 20 73 74 61 74 65 6d xt time a statem
df00: 65 6e 74 20 69 73 20 70 72 65 70 61 72 65 64 20 ent is prepared
df10: 75 73 69 6e 67 20 73 61 69 64 20 73 71 6c 69 74 using said sqlit
df20: 65 33 2a 2e 20 54 68 69 73 20 69 73 20 64 6f 6e e3*. This is don
df30: 65 0a 2a 2a 20 74 6f 20 61 76 6f 69 64 20 64 65 e.** to avoid de
df40: 61 64 6c 6f 63 6b 20 69 73 73 75 65 73 20 69 6e adlock issues in
df50: 76 6f 6c 76 69 6e 67 20 6d 75 6c 74 69 70 6c 65 volving multiple
df60: 20 73 71 6c 69 74 65 33 2e 6d 75 74 65 78 20 6d sqlite3.mutex m
df70: 75 74 65 78 65 73 2e 0a 2a 2a 20 52 65 66 65 72 utexes..** Refer
df80: 20 74 6f 20 63 6f 6d 6d 65 6e 74 73 20 61 62 6f to comments abo
df90: 76 65 20 66 75 6e 63 74 69 6f 6e 20 73 71 6c 69 ve function sqli
dfa0: 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 te3VtabUnlockLis
dfb0: 74 28 29 20 66 6f 72 20 61 6e 0a 2a 2a 20 65 78 t() for an.** ex
dfc0: 70 6c 61 6e 61 74 69 6f 6e 20 61 73 20 74 6f 20 planation as to
dfd0: 77 68 79 20 69 74 20 69 73 20 73 61 66 65 20 74 why it is safe t
dfe0: 6f 20 61 64 64 20 61 6e 20 65 6e 74 72 79 20 74 o add an entry t
dff0: 6f 20 61 6e 20 73 71 6c 69 74 65 33 2e 70 44 69 o an sqlite3.pDi
e000: 73 63 6f 6e 6e 65 63 74 0a 2a 2a 20 6c 69 73 74 sconnect.** list
e010: 20 77 69 74 68 6f 75 74 20 68 6f 6c 64 69 6e 67 without holding
e020: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 the correspondi
e030: 6e 67 20 73 71 6c 69 74 65 33 2e 6d 75 74 65 78 ng sqlite3.mutex
e040: 20 6d 75 74 65 78 2e 0a 2a 2a 0a 2a 2a 20 54 68 mutex..**.** Th
e050: 65 20 6d 65 6d 6f 72 79 20 66 6f 72 20 6f 62 6a e memory for obj
e060: 65 63 74 73 20 6f 66 20 74 68 69 73 20 74 79 70 ects of this typ
e070: 65 20 69 73 20 61 6c 77 61 79 73 20 61 6c 6c 6f e is always allo
e080: 63 61 74 65 64 20 62 79 20 0a 2a 2a 20 73 71 6c cated by .** sql
e090: 69 74 65 33 44 62 4d 61 6c 6c 6f 63 28 29 2c 20 ite3DbMalloc(),
e0a0: 75 73 69 6e 67 20 74 68 65 20 63 6f 6e 6e 65 63 using the connec
e0b0: 74 69 6f 6e 20 68 61 6e 64 6c 65 20 73 74 6f 72 tion handle stor
e0c0: 65 64 20 69 6e 20 56 54 61 62 6c 65 2e 64 62 20 ed in VTable.db
e0d0: 61 73 20 0a 2a 2a 20 74 68 65 20 66 69 72 73 74 as .** the first
e0e0: 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 argument..*/.st
e0f0: 72 75 63 74 20 56 54 61 62 6c 65 20 7b 0a 20 20 ruct VTable {.
e100: 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20 sqlite3 *db;
e110: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 /* Dat
e120: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e abase connection
e130: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
e140: 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 this table */.
e150: 20 4d 6f 64 75 6c 65 20 2a 70 4d 6f 64 3b 20 20 Module *pMod;
e160: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f /* Po
e170: 69 6e 74 65 72 20 74 6f 20 6d 6f 64 75 6c 65 20 inter to module
e180: 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 2a implementation *
e190: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61 62 /. sqlite3_vtab
e1a0: 20 2a 70 56 74 61 62 3b 20 20 20 20 20 20 2f 2a *pVtab; /*
e1b0: 20 50 6f 69 6e 74 65 72 20 74 6f 20 76 74 61 62 Pointer to vtab
e1c0: 20 69 6e 73 74 61 6e 63 65 20 2a 2f 0a 20 20 69 instance */. i
e1d0: 6e 74 20 6e 52 65 66 3b 20 20 20 20 20 20 20 20 nt nRef;
e1e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
e1f0: 65 72 20 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 er of pointers t
e200: 6f 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 o this structure
e210: 20 2a 2f 0a 20 20 75 38 20 62 43 6f 6e 73 74 72 */. u8 bConstr
e220: 61 69 6e 74 3b 20 20 20 20 20 20 20 20 20 20 20 aint;
e230: 2f 2a 20 54 72 75 65 20 69 66 20 63 6f 6e 73 74 /* True if const
e240: 72 61 69 6e 74 73 20 61 72 65 20 73 75 70 70 6f raints are suppo
e250: 72 74 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 53 rted */. int iS
e260: 61 76 65 70 6f 69 6e 74 3b 20 20 20 20 20 20 20 avepoint;
e270: 20 20 20 20 2f 2a 20 44 65 70 74 68 20 6f 66 20 /* Depth of
e280: 74 68 65 20 53 41 56 45 50 4f 49 4e 54 20 73 74 the SAVEPOINT st
e290: 61 63 6b 20 2a 2f 0a 20 20 56 54 61 62 6c 65 20 ack */. VTable
e2a0: 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 *pNext;
e2b0: 20 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 6c 69 /* Next in li
e2c0: 6e 6b 65 64 20 6c 69 73 74 20 28 73 65 65 20 61 nked list (see a
e2d0: 62 6f 76 65 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a bove) */.};../*.
e2e0: 2a 2a 20 45 61 63 68 20 53 51 4c 20 74 61 62 6c ** Each SQL tabl
e2f0: 65 20 69 73 20 72 65 70 72 65 73 65 6e 74 65 64 e is represented
e300: 20 69 6e 20 6d 65 6d 6f 72 79 20 62 79 20 61 6e in memory by an
e310: 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 65 instance of the
e320: 0a 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 .** following st
e330: 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 54 ructure..**.** T
e340: 61 62 6c 65 2e 7a 4e 61 6d 65 20 69 73 20 74 68 able.zName is th
e350: 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 e name of the ta
e360: 62 6c 65 2e 20 20 54 68 65 20 63 61 73 65 20 6f ble. The case o
e370: 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 0a 2a f the original.*
e380: 2a 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 * CREATE TABLE s
e390: 74 61 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 tatement is stor
e3a0: 65 64 2c 20 62 75 74 20 63 61 73 65 20 69 73 20 ed, but case is
e3b0: 6e 6f 74 20 73 69 67 6e 69 66 69 63 61 6e 74 20 not significant
e3c0: 66 6f 72 0a 2a 2a 20 63 6f 6d 70 61 72 69 73 6f for.** compariso
e3d0: 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 61 62 6c 65 2e ns..**.** Table.
e3e0: 6e 43 6f 6c 20 69 73 20 74 68 65 20 6e 75 6d 62 nCol is the numb
e3f0: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e er of columns in
e400: 20 74 68 69 73 20 74 61 62 6c 65 2e 20 20 54 61 this table. Ta
e410: 62 6c 65 2e 61 43 6f 6c 20 69 73 20 61 0a 2a 2a ble.aCol is a.**
e420: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 61 pointer to an a
e430: 72 72 61 79 20 6f 66 20 43 6f 6c 75 6d 6e 20 73 rray of Column s
e440: 74 72 75 63 74 75 72 65 73 2c 20 6f 6e 65 20 66 tructures, one f
e450: 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2e 0a or each column..
e460: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 74 61 62 **.** If the tab
e470: 6c 65 20 68 61 73 20 61 6e 20 49 4e 54 45 47 45 le has an INTEGE
e480: 52 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 20 74 R PRIMARY KEY, t
e490: 68 65 6e 20 54 61 62 6c 65 2e 69 50 4b 65 79 20 hen Table.iPKey
e4a0: 69 73 20 74 68 65 20 69 6e 64 65 78 20 6f 66 0a is the index of.
e4b0: 2a 2a 20 74 68 65 20 63 6f 6c 75 6d 6e 20 74 68 ** the column th
e4c0: 61 74 20 69 73 20 74 68 61 74 20 6b 65 79 2e 20 at is that key.
e4d0: 20 20 4f 74 68 65 72 77 69 73 65 20 54 61 62 6c Otherwise Tabl
e4e0: 65 2e 69 50 4b 65 79 20 69 73 20 6e 65 67 61 74 e.iPKey is negat
e4f0: 69 76 65 2e 20 20 4e 6f 74 65 0a 2a 2a 20 74 68 ive. Note.** th
e500: 61 74 20 74 68 65 20 64 61 74 61 74 79 70 65 20 at the datatype
e510: 6f 66 20 74 68 65 20 50 52 49 4d 41 52 59 20 4b of the PRIMARY K
e520: 45 59 20 6d 75 73 74 20 62 65 20 49 4e 54 45 47 EY must be INTEG
e530: 45 52 20 66 6f 72 20 74 68 69 73 20 66 69 65 6c ER for this fiel
e540: 64 20 74 6f 0a 2a 2a 20 62 65 20 73 65 74 2e 20 d to.** be set.
e550: 20 41 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d An INTEGER PRIM
e560: 41 52 59 20 4b 45 59 20 69 73 20 75 73 65 64 20 ARY KEY is used
e570: 61 73 20 74 68 65 20 72 6f 77 69 64 20 66 6f 72 as the rowid for
e580: 20 65 61 63 68 20 72 6f 77 20 6f 66 0a 2a 2a 20 each row of.**
e590: 74 68 65 20 74 61 62 6c 65 2e 20 20 49 66 20 61 the table. If a
e5a0: 20 74 61 62 6c 65 20 68 61 73 20 6e 6f 20 49 4e table has no IN
e5b0: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 TEGER PRIMARY KE
e5c0: 59 2c 20 74 68 65 6e 20 61 20 72 61 6e 64 6f 6d Y, then a random
e5d0: 20 72 6f 77 69 64 0a 2a 2a 20 69 73 20 67 65 6e rowid.** is gen
e5e0: 65 72 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 erated for each
e5f0: 72 6f 77 20 6f 66 20 74 68 65 20 74 61 62 6c 65 row of the table
e600: 2e 20 20 54 46 5f 48 61 73 50 72 69 6d 61 72 79 . TF_HasPrimary
e610: 4b 65 79 20 69 73 20 73 65 74 20 69 66 0a 2a 2a Key is set if.**
e620: 20 74 68 65 20 74 61 62 6c 65 20 68 61 73 20 61 the table has a
e630: 6e 79 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 20 ny PRIMARY KEY,
e640: 49 4e 54 45 47 45 52 20 6f 72 20 6f 74 68 65 72 INTEGER or other
e650: 77 69 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 61 62 6c wise..**.** Tabl
e660: 65 2e 74 6e 75 6d 20 69 73 20 74 68 65 20 70 61 e.tnum is the pa
e670: 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 ge number for th
e680: 65 20 72 6f 6f 74 20 42 54 72 65 65 20 70 61 67 e root BTree pag
e690: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 69 e of the table i
e6a0: 6e 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 n the.** databas
e6b0: 65 20 66 69 6c 65 2e 20 20 49 66 20 54 61 62 6c e file. If Tabl
e6c0: 65 2e 69 44 62 20 69 73 20 74 68 65 20 69 6e 64 e.iDb is the ind
e6d0: 65 78 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 ex of the databa
e6e0: 73 65 20 74 61 62 6c 65 20 62 61 63 6b 65 6e 64 se table backend
e6f0: 0a 2a 2a 20 69 6e 20 73 71 6c 69 74 65 2e 61 44 .** in sqlite.aD
e700: 62 5b 5d 2e 20 20 30 20 69 73 20 66 6f 72 20 74 b[]. 0 is for t
e710: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 he main database
e720: 20 61 6e 64 20 31 20 69 73 20 66 6f 72 20 74 68 and 1 is for th
e730: 65 20 66 69 6c 65 20 74 68 61 74 0a 2a 2a 20 68 e file that.** h
e740: 6f 6c 64 73 20 74 65 6d 70 6f 72 61 72 79 20 74 olds temporary t
e750: 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63 65 ables and indice
e760: 73 2e 20 20 49 66 20 54 46 5f 45 70 68 65 6d 65 s. If TF_Epheme
e770: 72 61 6c 20 69 73 20 73 65 74 0a 2a 2a 20 74 68 ral is set.** th
e780: 65 6e 20 74 68 65 20 74 61 62 6c 65 20 69 73 20 en the table is
e790: 73 74 6f 72 65 64 20 69 6e 20 61 20 66 69 6c 65 stored in a file
e7a0: 20 74 68 61 74 20 69 73 20 61 75 74 6f 6d 61 74 that is automat
e7b0: 69 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 0a 2a ically deleted.*
e7c0: 2a 20 77 68 65 6e 20 74 68 65 20 56 44 42 45 20 * when the VDBE
e7d0: 63 75 72 73 6f 72 20 74 6f 20 74 68 65 20 74 61 cursor to the ta
e7e0: 62 6c 65 20 69 73 20 63 6c 6f 73 65 64 2e 20 20 ble is closed.
e7f0: 49 6e 20 74 68 69 73 20 63 61 73 65 20 54 61 62 In this case Tab
e800: 6c 65 2e 74 6e 75 6d 20 0a 2a 2a 20 72 65 66 65 le.tnum .** refe
e810: 72 73 20 56 44 42 45 20 63 75 72 73 6f 72 20 6e rs VDBE cursor n
e820: 75 6d 62 65 72 20 74 68 61 74 20 68 6f 6c 64 73 umber that holds
e830: 20 74 68 65 20 74 61 62 6c 65 20 6f 70 65 6e 2c the table open,
e840: 20 6e 6f 74 20 74 6f 20 74 68 65 20 72 6f 6f 74 not to the root
e850: 0a 2a 2a 20 70 61 67 65 20 6e 75 6d 62 65 72 2e .** page number.
e860: 20 20 54 72 61 6e 73 69 65 6e 74 20 74 61 62 6c Transient tabl
e870: 65 73 20 61 72 65 20 75 73 65 64 20 74 6f 20 68 es are used to h
e880: 6f 6c 64 20 74 68 65 20 72 65 73 75 6c 74 73 20 old the results
e890: 6f 66 20 61 0a 2a 2a 20 73 75 62 2d 71 75 65 72 of a.** sub-quer
e8a0: 79 20 74 68 61 74 20 61 70 70 65 61 72 73 20 69 y that appears i
e8b0: 6e 73 74 65 61 64 20 6f 66 20 61 20 72 65 61 6c nstead of a real
e8c0: 20 74 61 62 6c 65 20 6e 61 6d 65 20 69 6e 20 74 table name in t
e8d0: 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 0a he FROM clause .
e8e0: 2a 2a 20 6f 66 20 61 20 53 45 4c 45 43 54 20 73 ** of a SELECT s
e8f0: 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 73 74 72 tatement..*/.str
e900: 75 63 74 20 54 61 62 6c 65 20 7b 0a 20 20 63 68 uct Table {. ch
e910: 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 ar *zName;
e920: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 74 68 /* Name of th
e930: 65 20 74 61 62 6c 65 20 6f 72 20 76 69 65 77 20 e table or view
e940: 2a 2f 0a 20 20 43 6f 6c 75 6d 6e 20 2a 61 43 6f */. Column *aCo
e950: 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 66 l; /* Inf
e960: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 65 ormation about e
e970: 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 ach column */.
e980: 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 20 20 Index *pIndex;
e990: 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 /* List of
e9a0: 53 51 4c 20 69 6e 64 65 78 65 73 20 6f 6e 20 74 SQL indexes on t
e9b0: 68 69 73 20 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 his table. */.
e9c0: 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 74 3b Select *pSelect;
e9d0: 20 20 20 20 20 2f 2a 20 4e 55 4c 4c 20 66 6f 72 /* NULL for
e9e0: 20 74 61 62 6c 65 73 2e 20 20 50 6f 69 6e 74 73 tables. Points
e9f0: 20 74 6f 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 to definition i
ea00: 66 20 61 20 76 69 65 77 2e 20 2a 2f 0a 20 20 46 f a view. */. F
ea10: 4b 65 79 20 2a 70 46 4b 65 79 3b 20 20 20 20 20 Key *pFKey;
ea20: 20 20 20 20 2f 2a 20 4c 69 6e 6b 65 64 20 6c 69 /* Linked li
ea30: 73 74 20 6f 66 20 61 6c 6c 20 66 6f 72 65 69 67 st of all foreig
ea40: 6e 20 6b 65 79 73 20 69 6e 20 74 68 69 73 20 74 n keys in this t
ea50: 61 62 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a able */. char *
ea60: 7a 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 20 2f zColAff; /
ea70: 2a 20 53 74 72 69 6e 67 20 64 65 66 69 6e 69 6e * String definin
ea80: 67 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 6f g the affinity o
ea90: 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 2a 2f f each column */
eaa0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
eab0: 4f 4d 49 54 5f 43 48 45 43 4b 0a 20 20 45 78 70 OMIT_CHECK. Exp
eac0: 72 4c 69 73 74 20 2a 70 43 68 65 63 6b 3b 20 20 rList *pCheck;
ead0: 20 20 2f 2a 20 41 6c 6c 20 43 48 45 43 4b 20 63 /* All CHECK c
eae0: 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a 23 65 onstraints */.#e
eaf0: 6e 64 69 66 0a 20 20 4c 6f 67 45 73 74 20 6e 52 ndif. LogEst nR
eb00: 6f 77 4c 6f 67 45 73 74 3b 20 20 20 2f 2a 20 45 owLogEst; /* E
eb10: 73 74 69 6d 61 74 65 64 20 72 6f 77 73 20 69 6e stimated rows in
eb20: 20 74 61 62 6c 65 20 2d 20 66 72 6f 6d 20 73 71 table - from sq
eb30: 6c 69 74 65 5f 73 74 61 74 31 20 74 61 62 6c 65 lite_stat1 table
eb40: 20 2a 2f 0a 20 20 69 6e 74 20 74 6e 75 6d 3b 20 */. int tnum;
eb50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f /* Ro
eb60: 6f 74 20 42 54 72 65 65 20 6e 6f 64 65 20 66 6f ot BTree node fo
eb70: 72 20 74 68 69 73 20 74 61 62 6c 65 20 28 73 65 r this table (se
eb80: 65 20 6e 6f 74 65 20 61 62 6f 76 65 29 20 2a 2f e note above) */
eb90: 0a 20 20 69 31 36 20 69 50 4b 65 79 3b 20 20 20 . i16 iPKey;
eba0: 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 6e 6f /* If no
ebb0: 74 20 6e 65 67 61 74 69 76 65 2c 20 75 73 65 20 t negative, use
ebc0: 61 43 6f 6c 5b 69 50 4b 65 79 5d 20 61 73 20 74 aCol[iPKey] as t
ebd0: 68 65 20 70 72 69 6d 61 72 79 20 6b 65 79 20 2a he primary key *
ebe0: 2f 0a 20 20 69 31 36 20 6e 43 6f 6c 3b 20 20 20 /. i16 nCol;
ebf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
ec00: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e er of columns in
ec10: 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 this table */.
ec20: 20 75 31 36 20 6e 52 65 66 3b 20 20 20 20 20 20 u16 nRef;
ec30: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
ec40: 6f 66 20 70 6f 69 6e 74 65 72 73 20 74 6f 20 74 of pointers to t
ec50: 68 69 73 20 54 61 62 6c 65 20 2a 2f 0a 20 20 4c his Table */. L
ec60: 6f 67 45 73 74 20 73 7a 54 61 62 52 6f 77 3b 20 ogEst szTabRow;
ec70: 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 64 /* Estimated
ec80: 20 73 69 7a 65 20 6f 66 20 65 61 63 68 20 74 61 size of each ta
ec90: 62 6c 65 20 72 6f 77 20 69 6e 20 62 79 74 65 73 ble row in bytes
eca0: 20 2a 2f 0a 20 20 75 38 20 74 61 62 46 6c 61 67 */. u8 tabFlag
ecb0: 73 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 s; /* Ma
ecc0: 73 6b 20 6f 66 20 54 46 5f 2a 20 76 61 6c 75 65 sk of TF_* value
ecd0: 73 20 2a 2f 0a 20 20 75 38 20 6b 65 79 43 6f 6e s */. u8 keyCon
ece0: 66 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 f; /* W
ecf0: 68 61 74 20 74 6f 20 64 6f 20 69 6e 20 63 61 73 hat to do in cas
ed00: 65 20 6f 66 20 75 6e 69 71 75 65 6e 65 73 73 20 e of uniqueness
ed10: 63 6f 6e 66 6c 69 63 74 20 6f 6e 20 69 50 4b 65 conflict on iPKe
ed20: 79 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c y */.#ifndef SQL
ed30: 49 54 45 5f 4f 4d 49 54 5f 41 4c 54 45 52 54 41 ITE_OMIT_ALTERTA
ed40: 42 4c 45 0a 20 20 69 6e 74 20 61 64 64 43 6f 6c BLE. int addCol
ed50: 4f 66 66 73 65 74 3b 20 20 20 20 2f 2a 20 4f 66 Offset; /* Of
ed60: 66 73 65 74 20 69 6e 20 43 52 45 41 54 45 20 54 fset in CREATE T
ed70: 41 42 4c 45 20 73 74 6d 74 20 74 6f 20 61 64 64 ABLE stmt to add
ed80: 20 61 20 6e 65 77 20 63 6f 6c 75 6d 6e 20 2a 2f a new column */
ed90: 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
eda0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
edb0: 55 41 4c 54 41 42 4c 45 0a 20 20 69 6e 74 20 6e UALTABLE. int n
edc0: 4d 6f 64 75 6c 65 41 72 67 3b 20 20 20 20 20 20 ModuleArg;
edd0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 61 72 67 /* Number of arg
ede0: 75 6d 65 6e 74 73 20 74 6f 20 74 68 65 20 6d 6f uments to the mo
edf0: 64 75 6c 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a dule */. char *
ee00: 2a 61 7a 4d 6f 64 75 6c 65 41 72 67 3b 20 20 2f *azModuleArg; /
ee10: 2a 20 54 65 78 74 20 6f 66 20 61 6c 6c 20 6d 6f * Text of all mo
ee20: 64 75 6c 65 20 61 72 67 73 2e 20 5b 30 5d 20 69 dule args. [0] i
ee30: 73 20 6d 6f 64 75 6c 65 20 6e 61 6d 65 20 2a 2f s module name */
ee40: 0a 20 20 56 54 61 62 6c 65 20 2a 70 56 54 61 62 . VTable *pVTab
ee50: 6c 65 3b 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 le; /* List
ee60: 6f 66 20 56 54 61 62 6c 65 20 6f 62 6a 65 63 74 of VTable object
ee70: 73 2e 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 54 s. */.#endif. T
ee80: 72 69 67 67 65 72 20 2a 70 54 72 69 67 67 65 72 rigger *pTrigger
ee90: 3b 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 74 ; /* List of t
eea0: 72 69 67 67 65 72 73 20 73 74 6f 72 65 64 20 69 riggers stored i
eeb0: 6e 20 70 53 63 68 65 6d 61 20 2a 2f 0a 20 20 53 n pSchema */. S
eec0: 63 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 chema *pSchema;
eed0: 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 74 68 /* Schema th
eee0: 61 74 20 63 6f 6e 74 61 69 6e 73 20 74 68 69 73 at contains this
eef0: 20 74 61 62 6c 65 20 2a 2f 0a 20 20 54 61 62 6c table */. Tabl
ef00: 65 20 2a 70 4e 65 78 74 5a 6f 6d 62 69 65 3b 20 e *pNextZombie;
ef10: 20 2f 2a 20 4e 65 78 74 20 6f 6e 20 74 68 65 20 /* Next on the
ef20: 50 61 72 73 65 2e 70 5a 6f 6d 62 69 65 54 61 62 Parse.pZombieTab
ef30: 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a list */.};../*.
ef40: 2a 2a 20 41 6c 6c 6f 77 65 64 20 76 61 6c 75 65 ** Allowed value
ef50: 73 20 66 6f 72 20 54 61 62 6c 65 2e 74 61 62 46 s for Table.tabF
ef60: 6c 61 67 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65 lags..*/.#define
ef70: 20 54 46 5f 52 65 61 64 6f 6e 6c 79 20 20 20 20 TF_Readonly
ef80: 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 20 52 0x01 /* R
ef90: 65 61 64 2d 6f 6e 6c 79 20 73 79 73 74 65 6d 20 ead-only system
efa0: 74 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e 65 table */.#define
efb0: 20 54 46 5f 45 70 68 65 6d 65 72 61 6c 20 20 20 TF_Ephemeral
efc0: 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 20 41 0x02 /* A
efd0: 6e 20 65 70 68 65 6d 65 72 61 6c 20 74 61 62 6c n ephemeral tabl
efe0: 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f e */.#define TF_
eff0: 48 61 73 50 72 69 6d 61 72 79 4b 65 79 20 20 20 HasPrimaryKey
f000: 30 78 30 34 20 20 20 20 2f 2a 20 54 61 62 6c 65 0x04 /* Table
f010: 20 68 61 73 20 61 20 70 72 69 6d 61 72 79 20 6b has a primary k
f020: 65 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 ey */.#define TF
f030: 5f 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 20 20 _Autoincrement
f040: 20 30 78 30 38 20 20 20 20 2f 2a 20 49 6e 74 65 0x08 /* Inte
f050: 67 65 72 20 70 72 69 6d 61 72 79 20 6b 65 79 20 ger primary key
f060: 69 73 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 is autoincrement
f070: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 54 46 5f 56 */.#define TF_V
f080: 69 72 74 75 61 6c 20 20 20 20 20 20 20 20 20 30 irtual 0
f090: 78 31 30 20 20 20 20 2f 2a 20 49 73 20 61 20 76 x10 /* Is a v
f0a0: 69 72 74 75 61 6c 20 74 61 62 6c 65 20 2a 2f 0a irtual table */.
f0b0: 23 64 65 66 69 6e 65 20 54 46 5f 57 69 74 68 6f #define TF_Witho
f0c0: 75 74 52 6f 77 69 64 20 20 20 20 30 78 32 30 20 utRowid 0x20
f0d0: 20 20 20 2f 2a 20 4e 6f 20 72 6f 77 69 64 20 75 /* No rowid u
f0e0: 73 65 64 2e 20 50 52 49 4d 41 52 59 20 4b 45 59 sed. PRIMARY KEY
f0f0: 20 69 73 20 74 68 65 20 6b 65 79 20 2a 2f 0a 0a is the key */..
f100: 0a 2f 2a 0a 2a 2a 20 54 65 73 74 20 74 6f 20 73 ./*.** Test to s
f110: 65 65 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f ee whether or no
f120: 74 20 61 20 74 61 62 6c 65 20 69 73 20 61 20 76 t a table is a v
f130: 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 20 54 irtual table. T
f140: 68 69 73 20 69 73 0a 2a 2a 20 64 6f 6e 65 20 61 his is.** done a
f150: 73 20 61 20 6d 61 63 72 6f 20 73 6f 20 74 68 61 s a macro so tha
f160: 74 20 69 74 20 77 69 6c 6c 20 62 65 20 6f 70 74 t it will be opt
f170: 69 6d 69 7a 65 64 20 6f 75 74 20 77 68 65 6e 20 imized out when
f180: 76 69 72 74 75 61 6c 0a 2a 2a 20 74 61 62 6c 65 virtual.** table
f190: 20 73 75 70 70 6f 72 74 20 69 73 20 6f 6d 69 74 support is omit
f1a0: 74 65 64 20 66 72 6f 6d 20 74 68 65 20 62 75 69 ted from the bui
f1b0: 6c 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ld..*/.#ifndef S
f1c0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 QLITE_OMIT_VIRTU
f1d0: 41 4c 54 41 42 4c 45 0a 23 20 20 64 65 66 69 6e ALTABLE.# defin
f1e0: 65 20 49 73 56 69 72 74 75 61 6c 28 58 29 20 20 e IsVirtual(X)
f1f0: 20 20 20 20 28 28 28 58 29 2d 3e 74 61 62 46 6c (((X)->tabFl
f200: 61 67 73 20 26 20 54 46 5f 56 69 72 74 75 61 6c ags & TF_Virtual
f210: 29 21 3d 30 29 0a 23 20 20 64 65 66 69 6e 65 20 )!=0).# define
f220: 49 73 48 69 64 64 65 6e 43 6f 6c 75 6d 6e 28 58 IsHiddenColumn(X
f230: 29 20 28 28 28 58 29 2d 3e 63 6f 6c 46 6c 61 67 ) (((X)->colFlag
f240: 73 20 26 20 43 4f 4c 46 4c 41 47 5f 48 49 44 44 s & COLFLAG_HIDD
f250: 45 4e 29 21 3d 30 29 0a 23 65 6c 73 65 0a 23 20 EN)!=0).#else.#
f260: 20 64 65 66 69 6e 65 20 49 73 56 69 72 74 75 61 define IsVirtua
f270: 6c 28 58 29 20 20 20 20 20 20 30 0a 23 20 20 64 l(X) 0.# d
f280: 65 66 69 6e 65 20 49 73 48 69 64 64 65 6e 43 6f efine IsHiddenCo
f290: 6c 75 6d 6e 28 58 29 20 30 0a 23 65 6e 64 69 66 lumn(X) 0.#endif
f2a0: 0a 0a 2f 2a 20 44 6f 65 73 20 74 68 65 20 74 61 ../* Does the ta
f2b0: 62 6c 65 20 68 61 76 65 20 61 20 72 6f 77 69 64 ble have a rowid
f2c0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 48 61 73 52 */.#define HasR
f2d0: 6f 77 69 64 28 58 29 20 20 20 20 20 28 28 28 58 owid(X) (((X
f2e0: 29 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 )->tabFlags & TF
f2f0: 5f 57 69 74 68 6f 75 74 52 6f 77 69 64 29 3d 3d _WithoutRowid)==
f300: 30 29 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 66 0)../*.** Each f
f310: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 oreign key const
f320: 72 61 69 6e 74 20 69 73 20 61 6e 20 69 6e 73 74 raint is an inst
f330: 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
f340: 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e owing structure.
f350: 0a 2a 2a 0a 2a 2a 20 41 20 66 6f 72 65 69 67 6e .**.** A foreign
f360: 20 6b 65 79 20 69 73 20 61 73 73 6f 63 69 61 74 key is associat
f370: 65 64 20 77 69 74 68 20 74 77 6f 20 74 61 62 6c ed with two tabl
f380: 65 73 2e 20 20 54 68 65 20 22 66 72 6f 6d 22 20 es. The "from"
f390: 74 61 62 6c 65 20 69 73 0a 2a 2a 20 74 68 65 20 table is.** the
f3a0: 74 61 62 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 table that conta
f3b0: 69 6e 73 20 74 68 65 20 52 45 46 45 52 45 4e 43 ins the REFERENC
f3c0: 45 53 20 63 6c 61 75 73 65 20 74 68 61 74 20 63 ES clause that c
f3d0: 72 65 61 74 65 73 20 74 68 65 20 66 6f 72 65 69 reates the forei
f3e0: 67 6e 0a 2a 2a 20 6b 65 79 2e 20 20 54 68 65 20 gn.** key. The
f3f0: 22 74 6f 22 20 74 61 62 6c 65 20 69 73 20 74 68 "to" table is th
f400: 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 73 20 e table that is
f410: 6e 61 6d 65 64 20 69 6e 20 74 68 65 20 52 45 46 named in the REF
f420: 45 52 45 4e 43 45 53 20 63 6c 61 75 73 65 2e 0a ERENCES clause..
f430: 2a 2a 20 43 6f 6e 73 69 64 65 72 20 74 68 69 73 ** Consider this
f440: 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 example:.**.**
f450: 20 20 20 20 43 52 45 41 54 45 20 54 41 42 4c 45 CREATE TABLE
f460: 20 65 78 31 28 0a 2a 2a 20 20 20 20 20 20 20 61 ex1(.** a
f470: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 INTEGER PRIMARY
f480: 20 4b 45 59 2c 0a 2a 2a 20 20 20 20 20 20 20 62 KEY,.** b
f490: 20 49 4e 54 45 47 45 52 20 43 4f 4e 53 54 52 41 INTEGER CONSTRA
f4a0: 49 4e 54 20 66 6b 31 20 52 45 46 45 52 45 4e 43 INT fk1 REFERENC
f4b0: 45 53 20 65 78 32 28 78 29 0a 2a 2a 20 20 20 20 ES ex2(x).**
f4c0: 20 29 3b 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 66 6f );.**.** For fo
f4d0: 72 65 69 67 6e 20 6b 65 79 20 22 66 6b 31 22 2c reign key "fk1",
f4e0: 20 74 68 65 20 66 72 6f 6d 2d 74 61 62 6c 65 20 the from-table
f4f0: 69 73 20 22 65 78 31 22 20 61 6e 64 20 74 68 65 is "ex1" and the
f500: 20 74 6f 2d 74 61 62 6c 65 20 69 73 20 22 65 78 to-table is "ex
f510: 32 22 2e 0a 2a 2a 20 45 71 75 69 76 61 6c 65 6e 2"..** Equivalen
f520: 74 20 6e 61 6d 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 t names:.**.**
f530: 20 20 20 66 72 6f 6d 2d 74 61 62 6c 65 20 3d 3d from-table ==
f540: 20 63 68 69 6c 64 2d 74 61 62 6c 65 0a 2a 2a 20 child-table.**
f550: 20 20 20 20 20 20 74 6f 2d 74 61 62 6c 65 20 3d to-table =
f560: 3d 20 70 61 72 65 6e 74 2d 74 61 62 6c 65 0a 2a = parent-table.*
f570: 2a 0a 2a 2a 20 45 61 63 68 20 52 45 46 45 52 45 *.** Each REFERE
f580: 4e 43 45 53 20 63 6c 61 75 73 65 20 67 65 6e 65 NCES clause gene
f590: 72 61 74 65 73 20 61 6e 20 69 6e 73 74 61 6e 63 rates an instanc
f5a0: 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 e of the followi
f5b0: 6e 67 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 ng structure.**
f5c0: 77 68 69 63 68 20 69 73 20 61 74 74 61 63 68 65 which is attache
f5d0: 64 20 74 6f 20 74 68 65 20 66 72 6f 6d 2d 74 61 d to the from-ta
f5e0: 62 6c 65 2e 20 20 54 68 65 20 74 6f 2d 74 61 62 ble. The to-tab
f5f0: 6c 65 20 6e 65 65 64 20 6e 6f 74 20 65 78 69 73 le need not exis
f600: 74 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 66 72 t when.** the fr
f610: 6f 6d 2d 74 61 62 6c 65 20 69 73 20 63 72 65 61 om-table is crea
f620: 74 65 64 2e 20 20 54 68 65 20 65 78 69 73 74 65 ted. The existe
f630: 6e 63 65 20 6f 66 20 74 68 65 20 74 6f 2d 74 61 nce of the to-ta
f640: 62 6c 65 20 69 73 20 6e 6f 74 20 63 68 65 63 6b ble is not check
f650: 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6c 69 ed..**.** The li
f660: 73 74 20 6f 66 20 61 6c 6c 20 70 61 72 65 6e 74 st of all parent
f670: 73 20 66 6f 72 20 63 68 69 6c 64 20 54 61 62 6c s for child Tabl
f680: 65 20 58 20 69 73 20 68 65 6c 64 20 61 74 20 58 e X is held at X
f690: 2e 70 46 4b 65 79 2e 0a 2a 2a 0a 2a 2a 20 41 20 .pFKey..**.** A
f6a0: 6c 69 73 74 20 6f 66 20 61 6c 6c 20 63 68 69 6c list of all chil
f6b0: 64 72 65 6e 20 66 6f 72 20 61 20 74 61 62 6c 65 dren for a table
f6c0: 20 6e 61 6d 65 64 20 5a 20 28 77 68 69 63 68 20 named Z (which
f6d0: 6d 69 67 68 74 20 6e 6f 74 20 65 76 65 6e 20 65 might not even e
f6e0: 78 69 73 74 29 0a 2a 2a 20 69 73 20 68 65 6c 64 xist).** is held
f6f0: 20 69 6e 20 53 63 68 65 6d 61 2e 66 6b 65 79 48 in Schema.fkeyH
f700: 61 73 68 20 77 69 74 68 20 61 20 68 61 73 68 20 ash with a hash
f710: 6b 65 79 20 6f 66 20 5a 2e 0a 2a 2f 0a 73 74 72 key of Z..*/.str
f720: 75 63 74 20 46 4b 65 79 20 7b 0a 20 20 54 61 62 uct FKey {. Tab
f730: 6c 65 20 2a 70 46 72 6f 6d 3b 20 20 20 20 20 2f le *pFrom; /
f740: 2a 20 54 61 62 6c 65 20 63 6f 6e 74 61 69 6e 69 * Table containi
f750: 6e 67 20 74 68 65 20 52 45 46 45 52 45 4e 43 45 ng the REFERENCE
f760: 53 20 63 6c 61 75 73 65 20 28 61 6b 61 3a 20 43 S clause (aka: C
f770: 68 69 6c 64 29 20 2a 2f 0a 20 20 46 4b 65 79 20 hild) */. FKey
f780: 2a 70 4e 65 78 74 46 72 6f 6d 3b 20 20 2f 2a 20 *pNextFrom; /*
f790: 4e 65 78 74 20 46 4b 65 79 20 77 69 74 68 20 74 Next FKey with t
f7a0: 68 65 20 73 61 6d 65 20 69 6e 20 70 46 72 6f 6d he same in pFrom
f7b0: 2e 20 4e 65 78 74 20 70 61 72 65 6e 74 20 6f 66 . Next parent of
f7c0: 20 70 46 72 6f 6d 20 2a 2f 0a 20 20 63 68 61 72 pFrom */. char
f7d0: 20 2a 7a 54 6f 3b 20 20 20 20 20 20 20 20 2f 2a *zTo; /*
f7e0: 20 4e 61 6d 65 20 6f 66 20 74 61 62 6c 65 20 74 Name of table t
f7f0: 68 61 74 20 74 68 65 20 6b 65 79 20 70 6f 69 6e hat the key poin
f800: 74 73 20 74 6f 20 28 61 6b 61 3a 20 50 61 72 65 ts to (aka: Pare
f810: 6e 74 29 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 nt) */. FKey *p
f820: 4e 65 78 74 54 6f 3b 20 20 20 20 2f 2a 20 4e 65 NextTo; /* Ne
f830: 78 74 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 xt with the same
f840: 20 7a 54 6f 2e 20 4e 65 78 74 20 63 68 69 6c 64 zTo. Next child
f850: 20 6f 66 20 7a 54 6f 2e 20 2a 2f 0a 20 20 46 4b of zTo. */. FK
f860: 65 79 20 2a 70 50 72 65 76 54 6f 3b 20 20 20 20 ey *pPrevTo;
f870: 2f 2a 20 50 72 65 76 69 6f 75 73 20 77 69 74 68 /* Previous with
f880: 20 74 68 65 20 73 61 6d 65 20 7a 54 6f 20 2a 2f the same zTo */
f890: 0a 20 20 69 6e 74 20 6e 43 6f 6c 3b 20 20 20 20 . int nCol;
f8a0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
f8b0: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 69 f columns in thi
f8c0: 73 20 6b 65 79 20 2a 2f 0a 20 20 2f 2a 20 45 56 s key */. /* EV
f8d0: 3a 20 52 2d 33 30 33 32 33 2d 32 31 39 31 37 20 : R-30323-21917
f8e0: 2a 2f 0a 20 20 75 38 20 69 73 44 65 66 65 72 72 */. u8 isDeferr
f8f0: 65 64 3b 20 20 20 20 20 20 20 2f 2a 20 54 72 75 ed; /* Tru
f900: 65 20 69 66 20 63 6f 6e 73 74 72 61 69 6e 74 20 e if constraint
f910: 63 68 65 63 6b 69 6e 67 20 69 73 20 64 65 66 65 checking is defe
f920: 72 72 65 64 20 74 69 6c 6c 20 43 4f 4d 4d 49 54 rred till COMMIT
f930: 20 2a 2f 0a 20 20 75 38 20 61 41 63 74 69 6f 6e */. u8 aAction
f940: 5b 32 5d 3b 20 20 20 20 20 20 20 20 2f 2a 20 4f [2]; /* O
f950: 4e 20 44 45 4c 45 54 45 20 61 6e 64 20 4f 4e 20 N DELETE and ON
f960: 55 50 44 41 54 45 20 61 63 74 69 6f 6e 73 2c 20 UPDATE actions,
f970: 72 65 73 70 65 63 74 69 76 65 6c 79 20 2a 2f 0a respectively */.
f980: 20 20 54 72 69 67 67 65 72 20 2a 61 70 54 72 69 Trigger *apTri
f990: 67 67 65 72 5b 32 5d 3b 2f 2a 20 54 72 69 67 67 gger[2];/* Trigg
f9a0: 65 72 73 20 66 6f 72 20 61 41 63 74 69 6f 6e 5b ers for aAction[
f9b0: 5d 20 61 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 ] actions */. s
f9c0: 74 72 75 63 74 20 73 43 6f 6c 4d 61 70 20 7b 20 truct sColMap {
f9d0: 20 20 20 20 20 2f 2a 20 4d 61 70 70 69 6e 67 20 /* Mapping
f9e0: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 70 46 of columns in pF
f9f0: 72 6f 6d 20 74 6f 20 63 6f 6c 75 6d 6e 73 20 69 rom to columns i
fa00: 6e 20 7a 54 6f 20 2a 2f 0a 20 20 20 20 69 6e 74 n zTo */. int
fa10: 20 69 46 72 6f 6d 3b 20 20 20 20 20 20 20 20 20 iFrom;
fa20: 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 63 /* Index of c
fa30: 6f 6c 75 6d 6e 20 69 6e 20 70 46 72 6f 6d 20 2a olumn in pFrom *
fa40: 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 43 6f 6c /. char *zCol
fa50: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ; /* N
fa60: 61 6d 65 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e ame of column in
fa70: 20 7a 54 6f 2e 20 20 49 66 20 4e 55 4c 4c 20 75 zTo. If NULL u
fa80: 73 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 2a se PRIMARY KEY *
fa90: 2f 0a 20 20 7d 20 61 43 6f 6c 5b 31 5d 3b 20 20 /. } aCol[1];
faa0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65 /* One
fab0: 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63 68 20 entry for each
fac0: 6f 66 20 6e 43 6f 6c 20 63 6f 6c 75 6d 6e 73 20 of nCol columns
fad0: 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 53 51 4c */.};../*.** SQL
fae0: 69 74 65 20 73 75 70 70 6f 72 74 73 20 6d 61 6e ite supports man
faf0: 79 20 64 69 66 66 65 72 65 6e 74 20 77 61 79 73 y different ways
fb00: 20 74 6f 20 72 65 73 6f 6c 76 65 20 61 20 63 6f to resolve a co
fb10: 6e 73 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f nstraint.** erro
fb20: 72 2e 20 20 52 4f 4c 4c 42 41 43 4b 20 70 72 6f r. ROLLBACK pro
fb30: 63 65 73 73 69 6e 67 20 6d 65 61 6e 73 20 74 68 cessing means th
fb40: 61 74 20 61 20 63 6f 6e 73 74 72 61 69 6e 74 20 at a constraint
fb50: 76 69 6f 6c 61 74 69 6f 6e 0a 2a 2a 20 63 61 75 violation.** cau
fb60: 73 65 73 20 74 68 65 20 6f 70 65 72 61 74 69 6f ses the operatio
fb70: 6e 20 69 6e 20 70 72 6f 63 65 73 73 20 74 6f 20 n in process to
fb80: 66 61 69 6c 20 61 6e 64 20 66 6f 72 20 74 68 65 fail and for the
fb90: 20 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 current transac
fba0: 74 69 6f 6e 0a 2a 2a 20 74 6f 20 62 65 20 72 6f tion.** to be ro
fbb0: 6c 6c 65 64 20 62 61 63 6b 2e 20 20 41 42 4f 52 lled back. ABOR
fbc0: 54 20 70 72 6f 63 65 73 73 69 6e 67 20 6d 65 61 T processing mea
fbd0: 6e 73 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e ns the operation
fbe0: 20 69 6e 20 70 72 6f 63 65 73 73 0a 2a 2a 20 66 in process.** f
fbf0: 61 69 6c 73 20 61 6e 64 20 61 6e 79 20 70 72 69 ails and any pri
fc00: 6f 72 20 63 68 61 6e 67 65 73 20 66 72 6f 6d 20 or changes from
fc10: 74 68 61 74 20 6f 6e 65 20 6f 70 65 72 61 74 69 that one operati
fc20: 6f 6e 20 61 72 65 20 62 61 63 6b 65 64 20 6f 75 on are backed ou
fc30: 74 2c 0a 2a 2a 20 62 75 74 20 74 68 65 20 74 72 t,.** but the tr
fc40: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6e 6f 74 ansaction is not
fc50: 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20 46 rolled back. F
fc60: 41 49 4c 20 70 72 6f 63 65 73 73 69 6e 67 20 6d AIL processing m
fc70: 65 61 6e 73 20 74 68 61 74 0a 2a 2a 20 74 68 65 eans that.** the
fc80: 20 6f 70 65 72 61 74 69 6f 6e 20 69 6e 20 70 72 operation in pr
fc90: 6f 67 72 65 73 73 20 73 74 6f 70 73 20 61 6e 64 ogress stops and
fca0: 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72 72 6f returns an erro
fcb0: 72 20 63 6f 64 65 2e 20 20 42 75 74 20 70 72 69 r code. But pri
fcc0: 6f 72 0a 2a 2a 20 63 68 61 6e 67 65 73 20 64 75 or.** changes du
fcd0: 65 20 74 6f 20 74 68 65 20 73 61 6d 65 20 6f 70 e to the same op
fce0: 65 72 61 74 69 6f 6e 20 61 72 65 20 6e 6f 74 20 eration are not
fcf0: 62 61 63 6b 65 64 20 6f 75 74 20 61 6e 64 20 6e backed out and n
fd00: 6f 20 72 6f 6c 6c 62 61 63 6b 0a 2a 2a 20 6f 63 o rollback.** oc
fd10: 63 75 72 73 2e 20 20 49 47 4e 4f 52 45 20 6d 65 curs. IGNORE me
fd20: 61 6e 73 20 74 68 61 74 20 74 68 65 20 70 61 72 ans that the par
fd30: 74 69 63 75 6c 61 72 20 72 6f 77 20 74 68 61 74 ticular row that
fd40: 20 63 61 75 73 65 64 20 74 68 65 20 63 6f 6e 73 caused the cons
fd50: 74 72 61 69 6e 74 0a 2a 2a 20 65 72 72 6f 72 20 traint.** error
fd60: 69 73 20 6e 6f 74 20 69 6e 73 65 72 74 65 64 20 is not inserted
fd70: 6f 72 20 75 70 64 61 74 65 64 2e 20 20 50 72 6f or updated. Pro
fd80: 63 65 73 73 69 6e 67 20 63 6f 6e 74 69 6e 75 65 cessing continue
fd90: 73 20 61 6e 64 20 6e 6f 20 65 72 72 6f 72 0a 2a s and no error.*
fda0: 2a 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20 * is returned.
fdb0: 52 45 50 4c 41 43 45 20 6d 65 61 6e 73 20 74 68 REPLACE means th
fdc0: 61 74 20 70 72 65 65 78 69 73 74 69 6e 67 20 64 at preexisting d
fdd0: 61 74 61 62 61 73 65 20 72 6f 77 73 20 74 68 61 atabase rows tha
fde0: 74 20 63 61 75 73 65 64 0a 2a 2a 20 61 20 55 4e t caused.** a UN
fdf0: 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 IQUE constraint
fe00: 76 69 6f 6c 61 74 69 6f 6e 20 61 72 65 20 72 65 violation are re
fe10: 6d 6f 76 65 64 20 73 6f 20 74 68 61 74 20 74 68 moved so that th
fe20: 65 20 6e 65 77 20 69 6e 73 65 72 74 20 6f 72 0a e new insert or.
fe30: 2a 2a 20 75 70 64 61 74 65 20 63 61 6e 20 70 72 ** update can pr
fe40: 6f 63 65 65 64 2e 20 20 50 72 6f 63 65 73 73 69 oceed. Processi
fe50: 6e 67 20 63 6f 6e 74 69 6e 75 65 73 20 61 6e 64 ng continues and
fe60: 20 6e 6f 20 65 72 72 6f 72 20 69 73 20 72 65 70 no error is rep
fe70: 6f 72 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 52 45 53 orted..**.** RES
fe80: 54 52 49 43 54 2c 20 53 45 54 4e 55 4c 4c 2c 20 TRICT, SETNULL,
fe90: 61 6e 64 20 43 41 53 43 41 44 45 20 61 63 74 69 and CASCADE acti
fea0: 6f 6e 73 20 61 70 70 6c 79 20 6f 6e 6c 79 20 74 ons apply only t
feb0: 6f 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 2e 0a o foreign keys..
fec0: 2a 2a 20 52 45 53 54 52 49 43 54 20 69 73 20 74 ** RESTRICT is t
fed0: 68 65 20 73 61 6d 65 20 61 73 20 41 42 4f 52 54 he same as ABORT
fee0: 20 66 6f 72 20 49 4d 4d 45 44 49 41 54 45 20 66 for IMMEDIATE f
fef0: 6f 72 65 69 67 6e 20 6b 65 79 73 20 61 6e 64 20 oreign keys and
ff00: 74 68 65 0a 2a 2a 20 73 61 6d 65 20 61 73 20 52 the.** same as R
ff10: 4f 4c 4c 42 41 43 4b 20 66 6f 72 20 44 45 46 45 OLLBACK for DEFE
ff20: 52 52 45 44 20 6b 65 79 73 2e 20 20 53 45 54 4e RRED keys. SETN
ff30: 55 4c 4c 20 6d 65 61 6e 73 20 74 68 61 74 20 74 ULL means that t
ff40: 68 65 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 6b 65 he foreign.** ke
ff50: 79 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c y is set to NULL
ff60: 2e 20 20 43 41 53 43 41 44 45 20 6d 65 61 6e 73 . CASCADE means
ff70: 20 74 68 61 74 20 61 20 44 45 4c 45 54 45 20 6f that a DELETE o
ff80: 72 20 55 50 44 41 54 45 20 6f 66 20 74 68 65 0a r UPDATE of the.
ff90: 2a 2a 20 72 65 66 65 72 65 6e 63 65 64 20 74 61 ** referenced ta
ffa0: 62 6c 65 20 72 6f 77 20 69 73 20 70 72 6f 70 61 ble row is propa
ffb0: 67 61 74 65 64 20 69 6e 74 6f 20 74 68 65 20 72 gated into the r
ffc0: 6f 77 20 74 68 61 74 20 68 6f 6c 64 73 20 74 68 ow that holds th
ffd0: 65 0a 2a 2a 20 66 6f 72 65 69 67 6e 20 6b 65 79 e.** foreign key
ffe0: 2e 0a 2a 2a 20 0a 2a 2a 20 54 68 65 20 66 6f 6c ..** .** The fol
fff0: 6c 6f 77 69 6e 67 20 73 79 6d 62 6f 6c 69 63 20 lowing symbolic
10000 76 61 6c 75 65 73 20 61 72 65 20 75 73 65 64 20 values are used
10010 74 6f 20 72 65 63 6f 72 64 20 77 68 69 63 68 20 to record which
10020 74 79 70 65 0a 2a 2a 20 6f 66 20 61 63 74 69 6f type.** of actio
10030 6e 20 74 6f 20 74 61 6b 65 2e 0a 2a 2f 0a 23 64 n to take..*/.#d
10040 65 66 69 6e 65 20 4f 45 5f 4e 6f 6e 65 20 20 20 efine OE_None
10050 20 20 30 20 20 20 2f 2a 20 54 68 65 72 65 20 69 0 /* There i
10060 73 20 6e 6f 20 63 6f 6e 73 74 72 61 69 6e 74 20 s no constraint
10070 74 6f 20 63 68 65 63 6b 20 2a 2f 0a 23 64 65 66 to check */.#def
10080 69 6e 65 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b 20 ine OE_Rollback
10090 31 20 20 20 2f 2a 20 46 61 69 6c 20 74 68 65 20 1 /* Fail the
100a0 6f 70 65 72 61 74 69 6f 6e 20 61 6e 64 20 72 6f operation and ro
100b0 6c 6c 62 61 63 6b 20 74 68 65 20 74 72 61 6e 73 llback the trans
100c0 61 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e action */.#defin
100d0 65 20 4f 45 5f 41 62 6f 72 74 20 20 20 20 32 20 e OE_Abort 2
100e0 20 20 2f 2a 20 42 61 63 6b 20 6f 75 74 20 63 68 /* Back out ch
100f0 61 6e 67 65 73 20 62 75 74 20 64 6f 20 6e 6f 20 anges but do no
10100 72 6f 6c 6c 62 61 63 6b 20 74 72 61 6e 73 61 63 rollback transac
10110 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 tion */.#define
10120 4f 45 5f 46 61 69 6c 20 20 20 20 20 33 20 20 20 OE_Fail 3
10130 2f 2a 20 53 74 6f 70 20 74 68 65 20 6f 70 65 72 /* Stop the oper
10140 61 74 69 6f 6e 20 62 75 74 20 6c 65 61 76 65 20 ation but leave
10150 61 6c 6c 20 70 72 69 6f 72 20 63 68 61 6e 67 65 all prior change
10160 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f s */.#define OE_
10170 49 67 6e 6f 72 65 20 20 20 34 20 20 20 2f 2a 20 Ignore 4 /*
10180 49 67 6e 6f 72 65 20 74 68 65 20 65 72 72 6f 72 Ignore the error
10190 2e 20 44 6f 20 6e 6f 74 20 64 6f 20 74 68 65 20 . Do not do the
101a0 49 4e 53 45 52 54 20 6f 72 20 55 50 44 41 54 45 INSERT or UPDATE
101b0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 52 */.#define OE_R
101c0 65 70 6c 61 63 65 20 20 35 20 20 20 2f 2a 20 44 eplace 5 /* D
101d0 65 6c 65 74 65 20 65 78 69 73 74 69 6e 67 20 72 elete existing r
101e0 65 63 6f 72 64 2c 20 74 68 65 6e 20 64 6f 20 49 ecord, then do I
101f0 4e 53 45 52 54 20 6f 72 20 55 50 44 41 54 45 20 NSERT or UPDATE
10200 2a 2f 0a 0a 23 64 65 66 69 6e 65 20 4f 45 5f 52 */..#define OE_R
10210 65 73 74 72 69 63 74 20 36 20 20 20 2f 2a 20 4f estrict 6 /* O
10220 45 5f 41 62 6f 72 74 20 66 6f 72 20 49 4d 4d 45 E_Abort for IMME
10230 44 49 41 54 45 2c 20 4f 45 5f 52 6f 6c 6c 62 61 DIATE, OE_Rollba
10240 63 6b 20 66 6f 72 20 44 45 46 45 52 52 45 44 20 ck for DEFERRED
10250 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 53 65 */.#define OE_Se
10260 74 4e 75 6c 6c 20 20 37 20 20 20 2f 2a 20 53 65 tNull 7 /* Se
10270 74 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 t the foreign ke
10280 79 20 76 61 6c 75 65 20 74 6f 20 4e 55 4c 4c 20 y value to NULL
10290 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 45 5f 53 65 */.#define OE_Se
102a0 74 44 66 6c 74 20 20 38 20 20 20 2f 2a 20 53 65 tDflt 8 /* Se
102b0 74 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 t the foreign ke
102c0 79 20 76 61 6c 75 65 20 74 6f 20 69 74 73 20 64 y value to its d
102d0 65 66 61 75 6c 74 20 2a 2f 0a 23 64 65 66 69 6e efault */.#defin
102e0 65 20 4f 45 5f 43 61 73 63 61 64 65 20 20 39 20 e OE_Cascade 9
102f0 20 20 2f 2a 20 43 61 73 63 61 64 65 20 74 68 65 /* Cascade the
10300 20 63 68 61 6e 67 65 73 20 2a 2f 0a 0a 23 64 65 changes */..#de
10310 66 69 6e 65 20 4f 45 5f 44 65 66 61 75 6c 74 20 fine OE_Default
10320 20 31 30 20 20 2f 2a 20 44 6f 20 77 68 61 74 65 10 /* Do whate
10330 76 65 72 20 74 68 65 20 64 65 66 61 75 6c 74 20 ver the default
10340 61 63 74 69 6f 6e 20 69 73 20 2a 2f 0a 0a 0a 2f action is */.../
10350 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
10360 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
10370 67 20 73 74 72 75 63 74 75 72 65 20 69 73 20 70 g structure is p
10380 61 73 73 65 64 20 61 73 20 74 68 65 20 66 69 72 assed as the fir
10390 73 74 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 74 st.** argument t
103a0 6f 20 73 71 6c 69 74 65 33 56 64 62 65 4b 65 79 o sqlite3VdbeKey
103b0 43 6f 6d 70 61 72 65 20 61 6e 64 20 69 73 20 75 Compare and is u
103c0 73 65 64 20 74 6f 20 63 6f 6e 74 72 6f 6c 20 74 sed to control t
103d0 68 65 20 0a 2a 2a 20 63 6f 6d 70 61 72 69 73 6f he .** compariso
103e0 6e 20 6f 66 20 74 68 65 20 74 77 6f 20 69 6e 64 n of the two ind
103f0 65 78 20 6b 65 79 73 2e 0a 2a 2a 0a 2a 2a 20 4e ex keys..**.** N
10400 6f 74 65 20 74 68 61 74 20 61 53 6f 72 74 4f 72 ote that aSortOr
10410 64 65 72 5b 5d 20 61 6e 64 20 61 43 6f 6c 6c 5b der[] and aColl[
10420 5d 20 68 61 76 65 20 6e 46 69 65 6c 64 2b 31 20 ] have nField+1
10430 73 6c 6f 74 73 2e 20 20 54 68 65 72 65 0a 2a 2a slots. There.**
10440 20 61 72 65 20 6e 46 69 65 6c 64 20 73 6c 6f 74 are nField slot
10450 73 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e s for the column
10460 73 20 6f 66 20 61 6e 20 69 6e 64 65 78 20 74 68 s of an index th
10470 65 6e 20 6f 6e 65 20 65 78 74 72 61 20 73 6c 6f en one extra slo
10480 74 0a 2a 2a 20 66 6f 72 20 74 68 65 20 72 6f 77 t.** for the row
10490 69 64 20 61 74 20 74 68 65 20 65 6e 64 2e 0a 2a id at the end..*
104a0 2f 0a 73 74 72 75 63 74 20 4b 65 79 49 6e 66 6f /.struct KeyInfo
104b0 20 7b 0a 20 20 75 33 32 20 6e 52 65 66 3b 20 20 {. u32 nRef;
104c0 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
104d0 65 72 20 6f 66 20 72 65 66 65 72 65 6e 63 65 73 er of references
104e0 20 74 6f 20 74 68 69 73 20 4b 65 79 49 6e 66 6f to this KeyInfo
104f0 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 75 38 20 object */. u8
10500 65 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 enc;
10510 20 2f 2a 20 54 65 78 74 20 65 6e 63 6f 64 69 6e /* Text encodin
10520 67 20 2d 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 g - one of the S
10530 51 4c 49 54 45 5f 55 54 46 2a 20 76 61 6c 75 65 QLITE_UTF* value
10540 73 20 2a 2f 0a 20 20 75 31 36 20 6e 46 69 65 6c s */. u16 nFiel
10550 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 d; /* Nu
10560 6d 62 65 72 20 6f 66 20 6b 65 79 20 63 6f 6c 75 mber of key colu
10570 6d 6e 73 20 69 6e 20 74 68 65 20 69 6e 64 65 78 mns in the index
10580 20 2a 2f 0a 20 20 75 31 36 20 6e 58 46 69 65 6c */. u16 nXFiel
10590 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d d; /* Num
105a0 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 62 ber of columns b
105b0 65 79 6f 6e 64 20 74 68 65 20 6b 65 79 20 63 6f eyond the key co
105c0 6c 75 6d 6e 73 20 2a 2f 0a 20 20 73 71 6c 69 74 lumns */. sqlit
105d0 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 2f e3 *db; /
105e0 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 63 * The database c
105f0 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 75 onnection */. u
10600 38 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b 20 20 8 *aSortOrder;
10610 20 20 20 2f 2a 20 53 6f 72 74 20 6f 72 64 65 72 /* Sort order
10620 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e for each column
10630 2e 20 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 20 2a . */. CollSeq *
10640 61 43 6f 6c 6c 5b 31 5d 3b 20 20 2f 2a 20 43 6f aColl[1]; /* Co
10650 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
10660 20 66 6f 72 20 65 61 63 68 20 74 65 72 6d 20 6f for each term o
10670 66 20 74 68 65 20 6b 65 79 20 2a 2f 0a 7d 3b 0a f the key */.};.
10680 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
10690 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 ce of the follow
106a0 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 68 6f ing structure ho
106b0 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 lds information
106c0 61 62 6f 75 74 20 61 0a 2a 2a 20 73 69 6e 67 6c about a.** singl
106d0 65 20 69 6e 64 65 78 20 72 65 63 6f 72 64 20 74 e index record t
106e0 68 61 74 20 68 61 73 20 61 6c 72 65 61 64 79 20 hat has already
106f0 62 65 65 6e 20 70 61 72 73 65 64 20 6f 75 74 20 been parsed out
10700 69 6e 74 6f 20 69 6e 64 69 76 69 64 75 61 6c 0a into individual.
10710 2a 2a 20 76 61 6c 75 65 73 2e 0a 2a 2a 0a 2a 2a ** values..**.**
10720 20 41 20 72 65 63 6f 72 64 20 69 73 20 61 6e 20 A record is an
10730 6f 62 6a 65 63 74 20 74 68 61 74 20 63 6f 6e 74 object that cont
10740 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 ains one or more
10750 20 66 69 65 6c 64 73 20 6f 66 20 64 61 74 61 2e fields of data.
10760 0a 2a 2a 20 52 65 63 6f 72 64 73 20 61 72 65 20 .** Records are
10770 75 73 65 64 20 74 6f 20 73 74 6f 72 65 20 74 68 used to store th
10780 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 74 e content of a t
10790 61 62 6c 65 20 72 6f 77 20 61 6e 64 20 74 6f 20 able row and to
107a0 73 74 6f 72 65 0a 2a 2a 20 74 68 65 20 6b 65 79 store.** the key
107b0 20 6f 66 20 61 6e 20 69 6e 64 65 78 2e 20 20 41 of an index. A
107c0 20 62 6c 6f 62 20 65 6e 63 6f 64 69 6e 67 20 6f blob encoding o
107d0 66 20 61 20 72 65 63 6f 72 64 20 69 73 20 63 72 f a record is cr
107e0 65 61 74 65 64 20 62 79 0a 2a 2a 20 74 68 65 20 eated by.** the
107f0 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 OP_MakeRecord op
10800 63 6f 64 65 20 6f 66 20 74 68 65 20 56 44 42 45 code of the VDBE
10810 20 61 6e 64 20 69 73 20 64 69 73 61 73 73 65 6d and is disassem
10820 62 6c 65 64 20 62 79 20 74 68 65 0a 2a 2a 20 4f bled by the.** O
10830 50 5f 43 6f 6c 75 6d 6e 20 6f 70 63 6f 64 65 2e P_Column opcode.
10840 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 .**.** This stru
10850 63 74 75 72 65 20 68 6f 6c 64 73 20 61 20 72 65 cture holds a re
10860 63 6f 72 64 20 74 68 61 74 20 68 61 73 20 61 6c cord that has al
10870 72 65 61 64 79 20 62 65 65 6e 20 64 69 73 61 73 ready been disas
10880 73 65 6d 62 6c 65 64 0a 2a 2a 20 69 6e 74 6f 20 sembled.** into
10890 69 74 73 20 63 6f 6e 73 74 69 74 75 65 6e 74 20 its constituent
108a0 66 69 65 6c 64 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 fields..**.** Th
108b0 65 20 72 31 20 61 6e 64 20 72 32 20 6d 65 6d 62 e r1 and r2 memb
108c0 65 72 20 76 61 72 69 61 62 6c 65 73 20 61 72 65 er variables are
108d0 20 6f 6e 6c 79 20 75 73 65 64 20 62 79 20 74 68 only used by th
108e0 65 20 6f 70 74 69 6d 69 7a 65 64 20 63 6f 6d 70 e optimized comp
108f0 61 72 69 73 6f 6e 0a 2a 2a 20 66 75 6e 63 74 69 arison.** functi
10900 6f 6e 73 20 76 64 62 65 52 65 63 6f 72 64 43 6f ons vdbeRecordCo
10910 6d 70 61 72 65 49 6e 74 28 29 20 61 6e 64 20 76 mpareInt() and v
10920 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 dbeRecordCompare
10930 53 74 72 69 6e 67 28 29 2e 0a 2a 2f 0a 73 74 72 String()..*/.str
10940 75 63 74 20 55 6e 70 61 63 6b 65 64 52 65 63 6f uct UnpackedReco
10950 72 64 20 7b 0a 20 20 4b 65 79 49 6e 66 6f 20 2a rd {. KeyInfo *
10960 70 4b 65 79 49 6e 66 6f 3b 20 20 2f 2a 20 43 6f pKeyInfo; /* Co
10970 6c 6c 61 74 69 6f 6e 20 61 6e 64 20 73 6f 72 74 llation and sort
10980 2d 6f 72 64 65 72 20 69 6e 66 6f 72 6d 61 74 69 -order informati
10990 6f 6e 20 2a 2f 0a 20 20 75 31 36 20 6e 46 69 65 on */. u16 nFie
109a0 6c 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ld; /* N
109b0 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 umber of entries
109c0 20 69 6e 20 61 70 4d 65 6d 5b 5d 20 2a 2f 0a 20 in apMem[] */.
109d0 20 69 38 20 64 65 66 61 75 6c 74 5f 72 63 3b 20 i8 default_rc;
109e0 20 20 20 20 20 2f 2a 20 43 6f 6d 70 61 72 69 73 /* Comparis
109f0 6f 6e 20 72 65 73 75 6c 74 20 69 66 20 6b 65 79 on result if key
10a00 73 20 61 72 65 20 65 71 75 61 6c 20 2a 2f 0a 20 s are equal */.
10a10 20 75 38 20 69 73 43 6f 72 72 75 70 74 3b 20 20 u8 isCorrupt;
10a20 20 20 20 20 20 2f 2a 20 43 6f 72 72 75 70 74 69 /* Corrupti
10a30 6f 6e 20 64 65 74 65 63 74 65 64 20 62 79 20 78 on detected by x
10a40 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 29 20 RecordCompare()
10a50 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d 65 6d 3b 20 */. Mem *aMem;
10a60 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 /* Valu
10a70 65 73 20 2a 2f 0a 20 20 69 6e 74 20 72 31 3b 20 es */. int r1;
10a80 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 /* V
10a90 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 69 alue to return i
10aa0 66 20 28 6c 68 73 20 3e 20 72 68 73 29 20 2a 2f f (lhs > rhs) */
10ab0 0a 20 20 69 6e 74 20 72 32 3b 20 20 20 20 20 20 . int r2;
10ac0 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 /* Value
10ad0 74 6f 20 72 65 74 75 72 6e 20 69 66 20 28 72 68 to return if (rh
10ae0 73 20 3c 20 6c 68 73 29 20 2a 2f 0a 7d 3b 0a 0a s < lhs) */.};..
10af0 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 53 51 4c 20 ./*.** Each SQL
10b00 69 6e 64 65 78 20 69 73 20 72 65 70 72 65 73 65 index is represe
10b10 6e 74 65 64 20 69 6e 20 6d 65 6d 6f 72 79 20 62 nted in memory b
10b20 79 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 y an.** instance
10b30 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
10b40 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a g structure..**.
10b50 2a 2a 20 54 68 65 20 63 6f 6c 75 6d 6e 73 20 6f ** The columns o
10b60 66 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 f the table that
10b70 20 61 72 65 20 74 6f 20 62 65 20 69 6e 64 65 78 are to be index
10b80 65 64 20 61 72 65 20 64 65 73 63 72 69 62 65 64 ed are described
10b90 0a 2a 2a 20 62 79 20 74 68 65 20 61 69 43 6f 6c .** by the aiCol
10ba0 75 6d 6e 5b 5d 20 66 69 65 6c 64 20 6f 66 20 74 umn[] field of t
10bb0 68 69 73 20 73 74 72 75 63 74 75 72 65 2e 20 20 his structure.
10bc0 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 73 75 70 For example, sup
10bd0 70 6f 73 65 0a 2a 2a 20 77 65 20 68 61 76 65 20 pose.** we have
10be0 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 the following ta
10bf0 62 6c 65 20 61 6e 64 20 69 6e 64 65 78 3a 0a 2a ble and index:.*
10c00 2a 0a 2a 2a 20 20 20 20 20 43 52 45 41 54 45 20 *.** CREATE
10c10 54 41 42 4c 45 20 45 78 31 28 63 31 20 69 6e 74 TABLE Ex1(c1 int
10c20 2c 20 63 32 20 69 6e 74 2c 20 63 33 20 74 65 78 , c2 int, c3 tex
10c30 74 29 3b 0a 2a 2a 20 20 20 20 20 43 52 45 41 54 t);.** CREAT
10c40 45 20 49 4e 44 45 58 20 45 78 32 20 4f 4e 20 45 E INDEX Ex2 ON E
10c50 78 31 28 63 33 2c 63 31 29 3b 0a 2a 2a 0a 2a 2a x1(c3,c1);.**.**
10c60 20 49 6e 20 74 68 65 20 54 61 62 6c 65 20 73 74 In the Table st
10c70 72 75 63 74 75 72 65 20 64 65 73 63 72 69 62 69 ructure describi
10c80 6e 67 20 45 78 31 2c 20 6e 43 6f 6c 3d 3d 33 20 ng Ex1, nCol==3
10c90 62 65 63 61 75 73 65 20 74 68 65 72 65 20 61 72 because there ar
10ca0 65 0a 2a 2a 20 74 68 72 65 65 20 63 6f 6c 75 6d e.** three colum
10cb0 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c 65 2e ns in the table.
10cc0 20 20 49 6e 20 74 68 65 20 49 6e 64 65 78 20 73 In the Index s
10cd0 74 72 75 63 74 75 72 65 20 64 65 73 63 72 69 62 tructure describ
10ce0 69 6e 67 0a 2a 2a 20 45 78 32 2c 20 6e 43 6f 6c ing.** Ex2, nCol
10cf0 75 6d 6e 3d 3d 32 20 73 69 6e 63 65 20 32 20 6f umn==2 since 2 o
10d00 66 20 74 68 65 20 33 20 63 6f 6c 75 6d 6e 73 20 f the 3 columns
10d10 6f 66 20 45 78 31 20 61 72 65 20 69 6e 64 65 78 of Ex1 are index
10d20 65 64 2e 0a 2a 2a 20 54 68 65 20 76 61 6c 75 65 ed..** The value
10d30 20 6f 66 20 61 69 43 6f 6c 75 6d 6e 20 69 73 20 of aiColumn is
10d40 7b 32 2c 20 30 7d 2e 20 20 61 69 43 6f 6c 75 6d {2, 0}. aiColum
10d50 6e 5b 30 5d 3d 3d 32 20 62 65 63 61 75 73 65 20 n[0]==2 because
10d60 74 68 65 20 0a 2a 2a 20 66 69 72 73 74 20 63 6f the .** first co
10d70 6c 75 6d 6e 20 74 6f 20 62 65 20 69 6e 64 65 78 lumn to be index
10d80 65 64 20 28 63 33 29 20 68 61 73 20 61 6e 20 69 ed (c3) has an i
10d90 6e 64 65 78 20 6f 66 20 32 20 69 6e 20 45 78 31 ndex of 2 in Ex1
10da0 2e 61 43 6f 6c 5b 5d 2e 0a 2a 2a 20 54 68 65 20 .aCol[]..** The
10db0 73 65 63 6f 6e 64 20 63 6f 6c 75 6d 6e 20 74 6f second column to
10dc0 20 62 65 20 69 6e 64 65 78 65 64 20 28 63 31 29 be indexed (c1)
10dd0 20 68 61 73 20 61 6e 20 69 6e 64 65 78 20 6f 66 has an index of
10de0 20 30 20 69 6e 0a 2a 2a 20 45 78 31 2e 61 43 6f 0 in.** Ex1.aCo
10df0 6c 5b 5d 2c 20 68 65 6e 63 65 20 45 78 32 2e 61 l[], hence Ex2.a
10e00 69 43 6f 6c 75 6d 6e 5b 31 5d 3d 3d 30 2e 0a 2a iColumn[1]==0..*
10e10 2a 0a 2a 2a 20 54 68 65 20 49 6e 64 65 78 2e 6f *.** The Index.o
10e20 6e 45 72 72 6f 72 20 66 69 65 6c 64 20 64 65 74 nError field det
10e30 65 72 6d 69 6e 65 73 20 77 68 65 74 68 65 72 20 ermines whether
10e40 6f 72 20 6e 6f 74 20 74 68 65 20 69 6e 64 65 78 or not the index
10e50 65 64 20 63 6f 6c 75 6d 6e 73 0a 2a 2a 20 6d 75 ed columns.** mu
10e60 73 74 20 62 65 20 75 6e 69 71 75 65 20 61 6e 64 st be unique and
10e70 20 77 68 61 74 20 74 6f 20 64 6f 20 69 66 20 74 what to do if t
10e80 68 65 79 20 61 72 65 20 6e 6f 74 2e 20 20 57 68 hey are not. Wh
10e90 65 6e 20 49 6e 64 65 78 2e 6f 6e 45 72 72 6f 72 en Index.onError
10ea0 3d 4f 45 5f 4e 6f 6e 65 2c 0a 2a 2a 20 69 74 20 =OE_None,.** it
10eb0 6d 65 61 6e 73 20 74 68 69 73 20 69 73 20 6e 6f means this is no
10ec0 74 20 61 20 75 6e 69 71 75 65 20 69 6e 64 65 78 t a unique index
10ed0 2e 20 20 4f 74 68 65 72 77 69 73 65 20 69 74 20 . Otherwise it
10ee0 69 73 20 61 20 75 6e 69 71 75 65 20 69 6e 64 65 is a unique inde
10ef0 78 0a 2a 2a 20 61 6e 64 20 74 68 65 20 76 61 6c x.** and the val
10f00 75 65 20 6f 66 20 49 6e 64 65 78 2e 6f 6e 45 72 ue of Index.onEr
10f10 72 6f 72 20 69 6e 64 69 63 61 74 65 20 74 68 65 ror indicate the
10f20 20 77 68 69 63 68 20 63 6f 6e 66 6c 69 63 74 20 which conflict
10f30 72 65 73 6f 6c 75 74 69 6f 6e 20 0a 2a 2a 20 61 resolution .** a
10f40 6c 67 6f 72 69 74 68 6d 20 74 6f 20 65 6d 70 6c lgorithm to empl
10f50 6f 79 20 77 68 65 6e 65 76 65 72 20 61 6e 20 61 oy whenever an a
10f60 74 74 65 6d 70 74 20 69 73 20 6d 61 64 65 20 74 ttempt is made t
10f70 6f 20 69 6e 73 65 72 74 20 61 20 6e 6f 6e 2d 75 o insert a non-u
10f80 6e 69 71 75 65 0a 2a 2a 20 65 6c 65 6d 65 6e 74 nique.** element
10f90 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 ..*/.struct Inde
10fa0 78 20 7b 0a 20 20 63 68 61 72 20 2a 7a 4e 61 6d x {. char *zNam
10fb0 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f e; /
10fc0 2a 20 4e 61 6d 65 20 6f 66 20 74 68 69 73 20 69 * Name of this i
10fd0 6e 64 65 78 20 2a 2f 0a 20 20 69 31 36 20 2a 61 ndex */. i16 *a
10fe0 69 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 iColumn;
10ff0 20 20 20 2f 2a 20 57 68 69 63 68 20 63 6f 6c 75 /* Which colu
11000 6d 6e 73 20 61 72 65 20 75 73 65 64 20 62 79 20 mns are used by
11010 74 68 69 73 20 69 6e 64 65 78 2e 20 20 31 73 74 this index. 1st
11020 20 69 73 20 30 20 2a 2f 0a 20 20 4c 6f 67 45 73 is 0 */. LogEs
11030 74 20 2a 61 69 52 6f 77 4c 6f 67 45 73 74 3b 20 t *aiRowLogEst;
11040 20 20 20 20 2f 2a 20 46 72 6f 6d 20 41 4e 41 4c /* From ANAL
11050 59 5a 45 3a 20 45 73 74 2e 20 72 6f 77 73 20 73 YZE: Est. rows s
11060 65 6c 65 63 74 65 64 20 62 79 20 65 61 63 68 20 elected by each
11070 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 54 61 62 6c column */. Tabl
11080 65 20 2a 70 54 61 62 6c 65 3b 20 20 20 20 20 20 e *pTable;
11090 20 20 20 20 20 2f 2a 20 54 68 65 20 53 51 4c 20 /* The SQL
110a0 74 61 62 6c 65 20 62 65 69 6e 67 20 69 6e 64 65 table being inde
110b0 78 65 64 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a xed */. char *z
110c0 43 6f 6c 41 66 66 3b 20 20 20 20 20 20 20 20 20 ColAff;
110d0 20 20 2f 2a 20 53 74 72 69 6e 67 20 64 65 66 69 /* String defi
110e0 6e 69 6e 67 20 74 68 65 20 61 66 66 69 6e 69 74 ning the affinit
110f0 79 20 6f 66 20 65 61 63 68 20 63 6f 6c 75 6d 6e y of each column
11100 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 4e 65 */. Index *pNe
11110 78 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f xt; /
11120 2a 20 54 68 65 20 6e 65 78 74 20 69 6e 64 65 78 * The next index
11130 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
11140 20 74 68 65 20 73 61 6d 65 20 74 61 62 6c 65 20 the same table
11150 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a 70 53 63 */. Schema *pSc
11160 68 65 6d 61 3b 20 20 20 20 20 20 20 20 20 2f 2a hema; /*
11170 20 53 63 68 65 6d 61 20 63 6f 6e 74 61 69 6e 69 Schema containi
11180 6e 67 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f ng this index */
11190 0a 20 20 75 38 20 2a 61 53 6f 72 74 4f 72 64 65 . u8 *aSortOrde
111a0 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 66 r; /* f
111b0 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 3a 20 or each column:
111c0 54 72 75 65 3d 3d 44 45 53 43 2c 20 46 61 6c 73 True==DESC, Fals
111d0 65 3d 3d 41 53 43 20 2a 2f 0a 20 20 63 68 61 72 e==ASC */. char
111e0 20 2a 2a 61 7a 43 6f 6c 6c 3b 20 20 20 20 20 20 **azColl;
111f0 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 /* Array of
11200 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
11210 6e 63 65 20 6e 61 6d 65 73 20 66 6f 72 20 69 6e nce names for in
11220 64 65 78 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 dex */. Expr *p
11230 50 61 72 74 49 64 78 57 68 65 72 65 3b 20 20 20 PartIdxWhere;
11240 20 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 75 73 /* WHERE claus
11250 65 20 66 6f 72 20 70 61 72 74 69 61 6c 20 69 6e e for partial in
11260 64 69 63 65 73 20 2a 2f 0a 20 20 4b 65 79 49 6e dices */. KeyIn
11270 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 20 fo *pKeyInfo;
11280 20 20 20 20 2f 2a 20 41 20 4b 65 79 49 6e 66 6f /* A KeyInfo
11290 20 6f 62 6a 65 63 74 20 73 75 69 74 61 62 6c 65 object suitable
112a0 20 66 6f 72 20 74 68 69 73 20 69 6e 64 65 78 20 for this index
112b0 2a 2f 0a 20 20 69 6e 74 20 74 6e 75 6d 3b 20 20 */. int tnum;
112c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
112d0 20 44 42 20 50 61 67 65 20 63 6f 6e 74 61 69 6e DB Page contain
112e0 69 6e 67 20 72 6f 6f 74 20 6f 66 20 74 68 69 73 ing root of this
112f0 20 69 6e 64 65 78 20 2a 2f 0a 20 20 4c 6f 67 45 index */. LogE
11300 73 74 20 73 7a 49 64 78 52 6f 77 3b 20 20 20 20 st szIdxRow;
11310 20 20 20 20 20 2f 2a 20 45 73 74 69 6d 61 74 65 /* Estimate
11320 64 20 61 76 65 72 61 67 65 20 72 6f 77 20 73 69 d average row si
11330 7a 65 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a 20 ze in bytes */.
11340 20 75 31 36 20 6e 4b 65 79 43 6f 6c 3b 20 20 20 u16 nKeyCol;
11350 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
11360 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 66 ber of columns f
11370 6f 72 6d 69 6e 67 20 74 68 65 20 6b 65 79 20 2a orming the key *
11380 2f 0a 20 20 75 31 36 20 6e 43 6f 6c 75 6d 6e 3b /. u16 nColumn;
11390 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
113a0 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e Number of column
113b0 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 s stored in the
113c0 69 6e 64 65 78 20 2a 2f 0a 20 20 75 38 20 6f 6e index */. u8 on
113d0 45 72 72 6f 72 3b 20 20 20 20 20 20 20 20 20 20 Error;
113e0 20 20 20 20 2f 2a 20 4f 45 5f 41 62 6f 72 74 2c /* OE_Abort,
113f0 20 4f 45 5f 49 67 6e 6f 72 65 2c 20 4f 45 5f 52 OE_Ignore, OE_R
11400 65 70 6c 61 63 65 2c 20 6f 72 20 4f 45 5f 4e 6f eplace, or OE_No
11410 6e 65 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ne */. unsigned
11420 20 61 75 74 6f 49 6e 64 65 78 3a 32 3b 20 20 20 autoIndex:2;
11430 20 2f 2a 20 31 3d 3d 55 4e 49 51 55 45 2c 20 32 /* 1==UNIQUE, 2
11440 3d 3d 50 52 49 4d 41 52 59 20 4b 45 59 2c 20 30 ==PRIMARY KEY, 0
11450 3d 3d 43 52 45 41 54 45 20 49 4e 44 45 58 20 2a ==CREATE INDEX *
11460 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 62 55 6e /. unsigned bUn
11470 6f 72 64 65 72 65 64 3a 31 3b 20 20 20 2f 2a 20 ordered:1; /*
11480 55 73 65 20 74 68 69 73 20 69 6e 64 65 78 20 66 Use this index f
11490 6f 72 20 3d 3d 20 6f 72 20 49 4e 20 71 75 65 72 or == or IN quer
114a0 69 65 73 20 6f 6e 6c 79 20 2a 2f 0a 20 20 75 6e ies only */. un
114b0 73 69 67 6e 65 64 20 75 6e 69 71 4e 6f 74 4e 75 signed uniqNotNu
114c0 6c 6c 3a 31 3b 20 20 2f 2a 20 54 72 75 65 20 69 ll:1; /* True i
114d0 66 20 55 4e 49 51 55 45 20 61 6e 64 20 4e 4f 54 f UNIQUE and NOT
114e0 20 4e 55 4c 4c 20 66 6f 72 20 61 6c 6c 20 63 6f NULL for all co
114f0 6c 75 6d 6e 73 20 2a 2f 0a 20 20 75 6e 73 69 67 lumns */. unsig
11500 6e 65 64 20 69 73 52 65 73 69 7a 65 64 3a 31 3b ned isResized:1;
11510 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 /* True if r
11520 65 73 69 7a 65 49 6e 64 65 78 4f 62 6a 65 63 74 esizeIndexObject
11530 28 29 20 68 61 73 20 62 65 65 6e 20 63 61 6c 6c () has been call
11540 65 64 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 ed */. unsigned
11550 20 69 73 43 6f 76 65 72 69 6e 67 3a 31 3b 20 20 isCovering:1;
11560 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 69 73 /* True if this
11570 20 69 73 20 61 20 63 6f 76 65 72 69 6e 67 20 69 is a covering i
11580 6e 64 65 78 20 2a 2f 0a 23 69 66 64 65 66 20 53 ndex */.#ifdef S
11590 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
115a0 54 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 69 6e T3_OR_STAT4. in
115b0 74 20 6e 53 61 6d 70 6c 65 3b 20 20 20 20 20 20 t nSample;
115c0 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
115d0 20 6f 66 20 65 6c 65 6d 65 6e 74 73 20 69 6e 20 of elements in
115e0 61 53 61 6d 70 6c 65 5b 5d 20 2a 2f 0a 20 20 69 aSample[] */. i
115f0 6e 74 20 6e 53 61 6d 70 6c 65 43 6f 6c 3b 20 20 nt nSampleCol;
11600 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 /* Size
11610 6f 66 20 49 6e 64 65 78 53 61 6d 70 6c 65 2e 61 of IndexSample.a
11620 6e 45 71 5b 5d 20 61 6e 64 20 73 6f 20 6f 6e 20 nEq[] and so on
11630 2a 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 61 41 */. tRowcnt *aA
11640 76 67 45 71 3b 20 20 20 20 20 20 20 20 20 2f 2a vgEq; /*
11650 20 41 76 65 72 61 67 65 20 6e 45 71 20 76 61 6c Average nEq val
11660 75 65 73 20 66 6f 72 20 6b 65 79 73 20 6e 6f 74 ues for keys not
11670 20 69 6e 20 61 53 61 6d 70 6c 65 20 2a 2f 0a 20 in aSample */.
11680 20 49 6e 64 65 78 53 61 6d 70 6c 65 20 2a 61 53 IndexSample *aS
11690 61 6d 70 6c 65 3b 20 20 20 20 2f 2a 20 53 61 6d ample; /* Sam
116a0 70 6c 65 73 20 6f 66 20 74 68 65 20 6c 65 66 74 ples of the left
116b0 2d 6d 6f 73 74 20 6b 65 79 20 2a 2f 0a 23 65 6e -most key */.#en
116c0 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 dif.};../*.** Ea
116d0 63 68 20 73 61 6d 70 6c 65 20 73 74 6f 72 65 64 ch sample stored
116e0 20 69 6e 20 74 68 65 20 73 71 6c 69 74 65 5f 73 in the sqlite_s
116f0 74 61 74 33 20 74 61 62 6c 65 20 69 73 20 72 65 tat3 table is re
11700 70 72 65 73 65 6e 74 65 64 20 69 6e 20 6d 65 6d presented in mem
11710 6f 72 79 20 0a 2a 2a 20 75 73 69 6e 67 20 61 20 ory .** using a
11720 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 69 structure of thi
11730 73 20 74 79 70 65 2e 20 20 53 65 65 20 64 6f 63 s type. See doc
11740 75 6d 65 6e 74 61 74 69 6f 6e 20 61 74 20 74 68 umentation at th
11750 65 20 74 6f 70 20 6f 66 20 74 68 65 0a 2a 2a 20 e top of the.**
11760 61 6e 61 6c 79 7a 65 2e 63 20 73 6f 75 72 63 65 analyze.c source
11770 20 66 69 6c 65 20 66 6f 72 20 61 64 64 69 74 69 file for additi
11780 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e onal information
11790 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 49 6e 64 65 ..*/.struct Inde
117a0 78 53 61 6d 70 6c 65 20 7b 0a 20 20 76 6f 69 64 xSample {. void
117b0 20 2a 70 3b 20 20 20 20 20 20 20 20 20 20 2f 2a *p; /*
117c0 20 50 6f 69 6e 74 65 72 20 74 6f 20 73 61 6d 70 Pointer to samp
117d0 6c 65 64 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 led record */.
117e0 69 6e 74 20 6e 3b 20 20 20 20 20 20 20 20 20 20 int n;
117f0 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 72 65 63 /* Size of rec
11800 6f 72 64 20 69 6e 20 62 79 74 65 73 20 2a 2f 0a ord in bytes */.
11810 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 45 71 3b tRowcnt *anEq;
11820 20 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 /* Est. numb
11830 65 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 er of rows where
11840 20 74 68 65 20 6b 65 79 20 65 71 75 61 6c 73 20 the key equals
11850 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 20 this sample */.
11860 20 74 52 6f 77 63 6e 74 20 2a 61 6e 4c 74 3b 20 tRowcnt *anLt;
11870 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 65 /* Est. numbe
11880 72 20 6f 66 20 72 6f 77 73 20 77 68 65 72 65 20 r of rows where
11890 6b 65 79 20 69 73 20 6c 65 73 73 20 74 68 61 6e key is less than
118a0 20 74 68 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a this sample */.
118b0 20 20 74 52 6f 77 63 6e 74 20 2a 61 6e 44 4c 74 tRowcnt *anDLt
118c0 3b 20 20 20 2f 2a 20 45 73 74 2e 20 6e 75 6d 62 ; /* Est. numb
118d0 65 72 20 6f 66 20 64 69 73 74 69 6e 63 74 20 6b er of distinct k
118e0 65 79 73 20 6c 65 73 73 20 74 68 61 6e 20 74 68 eys less than th
118f0 69 73 20 73 61 6d 70 6c 65 20 2a 2f 0a 7d 3b 0a is sample */.};.
11900 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 74 6f 6b 65 ./*.** Each toke
11910 6e 20 63 6f 6d 69 6e 67 20 6f 75 74 20 6f 66 20 n coming out of
11920 74 68 65 20 6c 65 78 65 72 20 69 73 20 61 6e 20 the lexer is an
11930 69 6e 73 74 61 6e 63 65 20 6f 66 0a 2a 2a 20 74 instance of.** t
11940 68 69 73 20 73 74 72 75 63 74 75 72 65 2e 20 20 his structure.
11950 54 6f 6b 65 6e 73 20 61 72 65 20 61 6c 73 6f 20 Tokens are also
11960 75 73 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 used as part of
11970 61 6e 20 65 78 70 72 65 73 73 69 6f 6e 2e 0a 2a an expression..*
11980 2a 0a 2a 2a 20 4e 6f 74 65 20 69 66 20 54 6f 6b *.** Note if Tok
11990 65 6e 2e 7a 3d 3d 30 20 74 68 65 6e 20 54 6f 6b en.z==0 then Tok
119a0 65 6e 2e 64 79 6e 20 61 6e 64 20 54 6f 6b 65 6e en.dyn and Token
119b0 2e 6e 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64 .n are undefined
119c0 20 61 6e 64 0a 2a 2a 20 6d 61 79 20 63 6f 6e 74 and.** may cont
119d0 61 69 6e 20 72 61 6e 64 6f 6d 20 76 61 6c 75 65 ain random value
119e0 73 2e 20 20 44 6f 20 6e 6f 74 20 6d 61 6b 65 20 s. Do not make
119f0 61 6e 79 20 61 73 73 75 6d 70 74 69 6f 6e 73 20 any assumptions
11a00 61 62 6f 75 74 20 54 6f 6b 65 6e 2e 64 79 6e 0a about Token.dyn.
11a10 2a 2a 20 61 6e 64 20 54 6f 6b 65 6e 2e 6e 20 77 ** and Token.n w
11a20 68 65 6e 20 54 6f 6b 65 6e 2e 7a 3d 3d 30 2e 0a hen Token.z==0..
11a30 2a 2f 0a 73 74 72 75 63 74 20 54 6f 6b 65 6e 20 */.struct Token
11a40 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
11a50 7a 3b 20 20 20 20 20 2f 2a 20 54 65 78 74 20 6f z; /* Text o
11a60 66 20 74 68 65 20 74 6f 6b 65 6e 2e 20 20 4e 6f f the token. No
11a70 74 20 4e 55 4c 4c 2d 74 65 72 6d 69 6e 61 74 65 t NULL-terminate
11a80 64 21 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 d! */. unsigned
11a90 20 69 6e 74 20 6e 3b 20 20 20 20 2f 2a 20 4e 75 int n; /* Nu
11aa0 6d 62 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 mber of characte
11ab0 72 73 20 69 6e 20 74 68 69 73 20 74 6f 6b 65 6e rs in this token
11ac0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e */.};../*.** An
11ad0 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 instance of thi
11ae0 73 20 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 s structure cont
11af0 61 69 6e 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ains information
11b00 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
11b10 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 ate.** code for
11b20 61 20 53 45 4c 45 43 54 20 74 68 61 74 20 63 6f a SELECT that co
11b30 6e 74 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 ntains aggregate
11b40 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a functions..**.*
11b50 2a 20 49 66 20 45 78 70 72 2e 6f 70 3d 3d 54 4b * If Expr.op==TK
11b60 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 6f 72 20 54 _AGG_COLUMN or T
11b70 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e 20 74 K_AGG_FUNCTION t
11b80 68 65 6e 20 45 78 70 72 2e 70 41 67 67 49 6e 66 hen Expr.pAggInf
11b90 6f 20 69 73 20 61 0a 2a 2a 20 70 6f 69 6e 74 65 o is a.** pointe
11ba0 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
11bb0 75 72 65 2e 20 20 54 68 65 20 45 78 70 72 2e 69 ure. The Expr.i
11bc0 43 6f 6c 75 6d 6e 20 66 69 65 6c 64 20 69 73 20 Column field is
11bd0 74 68 65 20 69 6e 64 65 78 20 69 6e 0a 2a 2a 20 the index in.**
11be0 41 67 67 49 6e 66 6f 2e 61 43 6f 6c 5b 5d 20 6f AggInfo.aCol[] o
11bf0 72 20 41 67 67 49 6e 66 6f 2e 61 46 75 6e 63 5b r AggInfo.aFunc[
11c00 5d 20 6f 66 20 69 6e 66 6f 72 6d 61 74 69 6f 6e ] of information
11c10 20 6e 65 65 64 65 64 20 74 6f 20 67 65 6e 65 72 needed to gener
11c20 61 74 65 0a 2a 2a 20 63 6f 64 65 20 66 6f 72 20 ate.** code for
11c30 74 68 61 74 20 6e 6f 64 65 2e 0a 2a 2a 0a 2a 2a that node..**.**
11c40 20 41 67 67 49 6e 66 6f 2e 70 47 72 6f 75 70 42 AggInfo.pGroupB
11c50 79 20 61 6e 64 20 41 67 67 49 6e 66 6f 2e 61 46 y and AggInfo.aF
11c60 75 6e 63 2e 70 45 78 70 72 20 70 6f 69 6e 74 20 unc.pExpr point
11c70 74 6f 20 66 69 65 6c 64 73 20 77 69 74 68 69 6e to fields within
11c80 20 74 68 65 0a 2a 2a 20 6f 72 69 67 69 6e 61 6c the.** original
11c90 20 53 65 6c 65 63 74 20 73 74 72 75 63 74 75 72 Select structur
11ca0 65 20 74 68 61 74 20 64 65 73 63 72 69 62 65 73 e that describes
11cb0 20 74 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 the SELECT stat
11cc0 65 6d 65 6e 74 2e 20 20 54 68 65 73 65 0a 2a 2a ement. These.**
11cd0 20 66 69 65 6c 64 73 20 64 6f 20 6e 6f 74 20 6e fields do not n
11ce0 65 65 64 20 74 6f 20 62 65 20 66 72 65 65 64 20 eed to be freed
11cf0 77 68 65 6e 20 64 65 61 6c 6c 6f 63 61 74 69 6e when deallocatin
11d00 67 20 74 68 65 20 41 67 67 49 6e 66 6f 20 73 74 g the AggInfo st
11d10 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 72 75 ructure..*/.stru
11d20 63 74 20 41 67 67 49 6e 66 6f 20 7b 0a 20 20 75 ct AggInfo {. u
11d30 38 20 64 69 72 65 63 74 4d 6f 64 65 3b 20 20 20 8 directMode;
11d40 20 20 20 20 20 20 20 2f 2a 20 44 69 72 65 63 74 /* Direct
11d50 20 72 65 6e 64 65 72 69 6e 67 20 6d 6f 64 65 20 rendering mode
11d60 6d 65 61 6e 73 20 74 61 6b 65 20 64 61 74 61 20 means take data
11d70 64 69 72 65 63 74 6c 79 0a 20 20 20 20 20 20 20 directly.
11d80 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11d90 20 20 20 2a 2a 20 66 72 6f 6d 20 73 6f 75 72 63 ** from sourc
11da0 65 20 74 61 62 6c 65 73 20 72 61 74 68 65 72 20 e tables rather
11db0 74 68 61 6e 20 66 72 6f 6d 20 61 63 63 75 6d 75 than from accumu
11dc0 6c 61 74 6f 72 73 20 2a 2f 0a 20 20 75 38 20 75 lators */. u8 u
11dd0 73 65 53 6f 72 74 69 6e 67 49 64 78 3b 20 20 20 seSortingIdx;
11de0 20 20 20 20 2f 2a 20 49 6e 20 64 69 72 65 63 74 /* In direct
11df0 20 6d 6f 64 65 2c 20 72 65 66 65 72 65 6e 63 65 mode, reference
11e00 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
11e10 65 78 20 72 61 74 68 65 72 0a 20 20 20 20 20 20 ex rather.
11e20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11e30 20 20 20 20 2a 2a 20 74 68 61 6e 20 74 68 65 20 ** than the
11e40 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a source table */.
11e50 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 49 64 78 int sortingIdx
11e60 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 ; /* Cur
11e70 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 20 74 68 sor number of th
11e80 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 65 78 20 e sorting index
11e90 2a 2f 0a 20 20 69 6e 74 20 73 6f 72 74 69 6e 67 */. int sorting
11ea0 49 64 78 50 54 61 62 3b 20 20 20 20 20 2f 2a 20 IdxPTab; /*
11eb0 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 6f 66 Cursor number of
11ec0 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 20 2a 2f pseudo-table */
11ed0 0a 20 20 69 6e 74 20 6e 53 6f 72 74 69 6e 67 43 . int nSortingC
11ee0 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a 20 4e 75 olumn; /* Nu
11ef0 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 mber of columns
11f00 69 6e 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 in the sorting i
11f10 6e 64 65 78 20 2a 2f 0a 20 20 69 6e 74 20 6d 6e ndex */. int mn
11f20 52 65 67 2c 20 6d 78 52 65 67 3b 20 20 20 20 20 Reg, mxReg;
11f30 20 20 2f 2a 20 52 61 6e 67 65 20 6f 66 20 72 65 /* Range of re
11f40 67 69 73 74 65 72 73 20 61 6c 6c 6f 63 61 74 65 gisters allocate
11f50 64 20 66 6f 72 20 61 43 6f 6c 20 61 6e 64 20 61 d for aCol and a
11f60 46 75 6e 63 20 2a 2f 0a 20 20 45 78 70 72 4c 69 Func */. ExprLi
11f70 73 74 20 2a 70 47 72 6f 75 70 42 79 3b 20 20 20 st *pGroupBy;
11f80 20 20 2f 2a 20 54 68 65 20 67 72 6f 75 70 20 62 /* The group b
11f90 79 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 73 74 y clause */. st
11fa0 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 63 6f 6c ruct AggInfo_col
11fb0 20 7b 20 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 { /* For eac
11fc0 68 20 63 6f 6c 75 6d 6e 20 75 73 65 64 20 69 6e h column used in
11fd0 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 2a source tables *
11fe0 2f 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 61 /. Table *pTa
11ff0 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f b; /
12000 2a 20 53 6f 75 72 63 65 20 74 61 62 6c 65 20 2a * Source table *
12010 2f 0a 20 20 20 20 69 6e 74 20 69 54 61 62 6c 65 /. int iTable
12020 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
12030 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 * Cursor number
12040 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 of the source ta
12050 62 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 ble */. int i
12060 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 Column;
12070 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 75 /* Column nu
12080 6d 62 65 72 20 77 69 74 68 69 6e 20 74 68 65 20 mber within the
12090 73 6f 75 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a source table */.
120a0 20 20 20 20 69 6e 74 20 69 53 6f 72 74 65 72 43 int iSorterC
120b0 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 2f 2a 20 olumn; /*
120c0 43 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e Column number in
120d0 20 74 68 65 20 73 6f 72 74 69 6e 67 20 69 6e 64 the sorting ind
120e0 65 78 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d ex */. int iM
120f0 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 em;
12100 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 /* Memory loc
12110 61 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 ation that acts
12120 61 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a as accumulator *
12130 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 /. Expr *pExp
12140 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f r; /
12150 2a 20 54 68 65 20 6f 72 69 67 69 6e 61 6c 20 65 * The original e
12160 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 7d xpression */. }
12170 20 2a 61 43 6f 6c 3b 0a 20 20 69 6e 74 20 6e 43 *aCol;. int nC
12180 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 olumn;
12190 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
121a0 73 65 64 20 65 6e 74 72 69 65 73 20 69 6e 20 61 sed entries in a
121b0 43 6f 6c 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e Col[] */. int n
121c0 41 63 63 75 6d 75 6c 61 74 6f 72 3b 20 20 20 20 Accumulator;
121d0 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
121e0 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 73 68 6f columns that sho
121f0 77 20 74 68 72 6f 75 67 68 20 74 6f 20 74 68 65 w through to the
12200 20 6f 75 74 70 75 74 2e 0a 20 20 20 20 20 20 20 output..
12210 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12220 20 20 20 2a 2a 20 41 64 64 69 74 69 6f 6e 61 6c ** Additional
12230 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 75 73 65 columns are use
12240 64 20 6f 6e 6c 79 20 61 73 20 70 61 72 61 6d 65 d only as parame
12250 74 65 72 73 20 74 6f 0a 20 20 20 20 20 20 20 20 ters to.
12260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12270 20 20 2a 2a 20 61 67 67 72 65 67 61 74 65 20 66 ** aggregate f
12280 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 20 20 73 74 unctions */. st
12290 72 75 63 74 20 41 67 67 49 6e 66 6f 5f 66 75 6e ruct AggInfo_fun
122a0 63 20 7b 20 20 20 2f 2a 20 46 6f 72 20 65 61 63 c { /* For eac
122b0 68 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 h aggregate func
122c0 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 45 78 70 72 tion */. Expr
122d0 20 2a 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 *pExpr;
122e0 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 /* Expressi
122f0 6f 6e 20 65 6e 63 6f 64 69 6e 67 20 74 68 65 20 on encoding the
12300 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 function */.
12310 46 75 6e 63 44 65 66 20 2a 70 46 75 6e 63 3b 20 FuncDef *pFunc;
12320 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
12330 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 aggregate functi
12340 6f 6e 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f on implementatio
12350 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 4d 65 n */. int iMe
12360 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 m;
12370 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 6c 6f 63 61 /* Memory loca
12380 74 69 6f 6e 20 74 68 61 74 20 61 63 74 73 20 61 tion that acts a
12390 73 20 61 63 63 75 6d 75 6c 61 74 6f 72 20 2a 2f s accumulator */
123a0 0a 20 20 20 20 69 6e 74 20 69 44 69 73 74 69 6e . int iDistin
123b0 63 74 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a ct; /*
123c0 20 45 70 68 65 6d 65 72 61 6c 20 74 61 62 6c 65 Ephemeral table
123d0 20 75 73 65 64 20 74 6f 20 65 6e 66 6f 72 63 65 used to enforce
123e0 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 20 20 7d DISTINCT */. }
123f0 20 2a 61 46 75 6e 63 3b 0a 20 20 69 6e 74 20 6e *aFunc;. int n
12400 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 Func;
12410 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
12420 65 6e 74 72 69 65 73 20 69 6e 20 61 46 75 6e 63 entries in aFunc
12430 5b 5d 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 [] */.};../*.**
12440 54 68 65 20 64 61 74 61 74 79 70 65 20 79 6e 56 The datatype ynV
12450 61 72 20 69 73 20 61 20 73 69 67 6e 65 64 20 69 ar is a signed i
12460 6e 74 65 67 65 72 2c 20 65 69 74 68 65 72 20 31 nteger, either 1
12470 36 2d 62 69 74 20 6f 72 20 33 32 2d 62 69 74 2e 6-bit or 32-bit.
12480 0a 2a 2a 20 55 73 75 61 6c 6c 79 20 69 74 20 69 .** Usually it i
12490 73 20 31 36 2d 62 69 74 73 2e 20 20 42 75 74 20 s 16-bits. But
124a0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 if SQLITE_MAX_VA
124b0 52 49 41 42 4c 45 5f 4e 55 4d 42 45 52 20 69 73 RIABLE_NUMBER is
124c0 20 67 72 65 61 74 65 72 0a 2a 2a 20 74 68 61 6e greater.** than
124d0 20 33 32 37 36 37 20 77 65 20 68 61 76 65 20 74 32767 we have t
124e0 6f 20 6d 61 6b 65 20 69 74 20 33 32 2d 62 69 74 o make it 32-bit
124f0 2e 20 20 31 36 2d 62 69 74 20 69 73 20 70 72 65 . 16-bit is pre
12500 66 65 72 72 65 64 20 62 65 63 61 75 73 65 0a 2a ferred because.*
12510 2a 20 69 74 20 75 73 65 73 20 6c 65 73 73 20 6d * it uses less m
12520 65 6d 6f 72 79 20 69 6e 20 74 68 65 20 45 78 70 emory in the Exp
12530 72 20 6f 62 6a 65 63 74 2c 20 77 68 69 63 68 20 r object, which
12540 69 73 20 61 20 62 69 67 20 6d 65 6d 6f 72 79 20 is a big memory
12550 75 73 65 72 0a 2a 2a 20 69 6e 20 73 79 73 74 65 user.** in syste
12560 6d 73 20 77 69 74 68 20 6c 6f 74 73 20 6f 66 20 ms with lots of
12570 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 prepared stateme
12580 6e 74 73 2e 20 20 41 6e 64 20 66 65 77 20 61 70 nts. And few ap
12590 70 6c 69 63 61 74 69 6f 6e 73 0a 2a 2a 20 6e 65 plications.** ne
125a0 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 61 62 6f ed more than abo
125b0 75 74 20 31 30 20 6f 72 20 32 30 20 76 61 72 69 ut 10 or 20 vari
125c0 61 62 6c 65 73 2e 20 20 42 75 74 20 73 6f 6d 65 ables. But some
125d0 20 65 78 74 72 65 6d 65 20 75 73 65 72 73 20 77 extreme users w
125e0 61 6e 74 0a 2a 2a 20 74 6f 20 68 61 76 65 20 70 ant.** to have p
125f0 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e repared statemen
12600 74 73 20 77 69 74 68 20 6f 76 65 72 20 33 32 37 ts with over 327
12610 36 37 20 76 61 72 69 61 62 6c 65 73 2c 20 61 6e 67 variables, an
12620 64 20 66 6f 72 20 74 68 65 6d 0a 2a 2a 20 74 68 d for them.** th
12630 65 20 6f 70 74 69 6f 6e 20 69 73 20 61 76 61 69 e option is avai
12640 6c 61 62 6c 65 20 28 61 74 20 63 6f 6d 70 69 6c lable (at compil
12650 65 2d 74 69 6d 65 29 2e 0a 2a 2f 0a 23 69 66 20 e-time)..*/.#if
12660 53 51 4c 49 54 45 5f 4d 41 58 5f 56 41 52 49 41 SQLITE_MAX_VARIA
12670 42 4c 45 5f 4e 55 4d 42 45 52 3c 3d 33 32 37 36 BLE_NUMBER<=3276
12680 37 0a 74 79 70 65 64 65 66 20 69 31 36 20 79 6e 7.typedef i16 yn
12690 56 61 72 3b 0a 23 65 6c 73 65 0a 74 79 70 65 64 Var;.#else.typed
126a0 65 66 20 69 6e 74 20 79 6e 56 61 72 3b 0a 23 65 ef int ynVar;.#e
126b0 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 ndif../*.** Each
126c0 20 6e 6f 64 65 20 6f 66 20 61 6e 20 65 78 70 72 node of an expr
126d0 65 73 73 69 6f 6e 20 69 6e 20 74 68 65 20 70 61 ession in the pa
126e0 72 73 65 20 74 72 65 65 20 69 73 20 61 6e 20 69 rse tree is an i
126f0 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66 20 74 68 nstance.** of th
12700 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a is structure..**
12710 0a 2a 2a 20 45 78 70 72 2e 6f 70 20 69 73 20 74 .** Expr.op is t
12720 68 65 20 6f 70 63 6f 64 65 2e 20 54 68 65 20 69 he opcode. The i
12730 6e 74 65 67 65 72 20 70 61 72 73 65 72 20 74 6f nteger parser to
12740 6b 65 6e 20 63 6f 64 65 73 20 61 72 65 20 72 65 ken codes are re
12750 75 73 65 64 0a 2a 2a 20 61 73 20 6f 70 63 6f 64 used.** as opcod
12760 65 73 20 68 65 72 65 2e 20 46 6f 72 20 65 78 61 es here. For exa
12770 6d 70 6c 65 2c 20 74 68 65 20 70 61 72 73 65 72 mple, the parser
12780 20 64 65 66 69 6e 65 73 20 54 4b 5f 47 45 20 74 defines TK_GE t
12790 6f 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 0a o be an integer.
127a0 2a 2a 20 63 6f 64 65 20 72 65 70 72 65 73 65 6e ** code represen
127b0 74 69 6e 67 20 74 68 65 20 22 3e 3d 22 20 6f 70 ting the ">=" op
127c0 65 72 61 74 6f 72 2e 20 54 68 69 73 20 73 61 6d erator. This sam
127d0 65 20 69 6e 74 65 67 65 72 20 63 6f 64 65 20 69 e integer code i
127e0 73 20 72 65 75 73 65 64 0a 2a 2a 20 74 6f 20 72 s reused.** to r
127f0 65 70 72 65 73 65 6e 74 20 74 68 65 20 67 72 65 epresent the gre
12800 61 74 65 72 2d 74 68 61 6e 2d 6f 72 2d 65 71 75 ater-than-or-equ
12810 61 6c 2d 74 6f 20 6f 70 65 72 61 74 6f 72 20 69 al-to operator i
12820 6e 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e n the expression
12830 0a 2a 2a 20 74 72 65 65 2e 0a 2a 2a 0a 2a 2a 20 .** tree..**.**
12840 49 66 20 74 68 65 20 65 78 70 72 65 73 73 69 6f If the expressio
12850 6e 20 69 73 20 61 6e 20 53 51 4c 20 6c 69 74 65 n is an SQL lite
12860 72 61 6c 20 28 54 4b 5f 49 4e 54 45 47 45 52 2c ral (TK_INTEGER,
12870 20 54 4b 5f 46 4c 4f 41 54 2c 20 54 4b 5f 42 4c TK_FLOAT, TK_BL
12880 4f 42 2c 20 0a 2a 2a 20 6f 72 20 54 4b 5f 53 54 OB, .** or TK_ST
12890 52 49 4e 47 29 2c 20 74 68 65 6e 20 45 78 70 72 RING), then Expr
128a0 2e 74 6f 6b 65 6e 20 63 6f 6e 74 61 69 6e 73 20 .token contains
128b0 74 68 65 20 74 65 78 74 20 6f 66 20 74 68 65 20 the text of the
128c0 53 51 4c 20 6c 69 74 65 72 61 6c 2e 20 49 66 0a SQL literal. If.
128d0 2a 2a 20 74 68 65 20 65 78 70 72 65 73 73 69 6f ** the expressio
128e0 6e 20 69 73 20 61 20 76 61 72 69 61 62 6c 65 20 n is a variable
128f0 28 54 4b 5f 56 41 52 49 41 42 4c 45 29 2c 20 74 (TK_VARIABLE), t
12900 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 hen Expr.token c
12910 6f 6e 74 61 69 6e 73 20 74 68 65 20 0a 2a 2a 20 ontains the .**
12920 76 61 72 69 61 62 6c 65 20 6e 61 6d 65 2e 20 46 variable name. F
12930 69 6e 61 6c 6c 79 2c 20 69 66 20 74 68 65 20 65 inally, if the e
12940 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 xpression is an
12950 53 51 4c 20 66 75 6e 63 74 69 6f 6e 20 28 54 4b SQL function (TK
12960 5f 46 55 4e 43 54 49 4f 4e 29 2c 0a 2a 2a 20 74 _FUNCTION),.** t
12970 68 65 6e 20 45 78 70 72 2e 74 6f 6b 65 6e 20 63 hen Expr.token c
12980 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e 61 6d 65 ontains the name
12990 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69 6f 6e of the function
129a0 2e 0a 2a 2a 0a 2a 2a 20 45 78 70 72 2e 70 52 69 ..**.** Expr.pRi
129b0 67 68 74 20 61 6e 64 20 45 78 70 72 2e 70 4c 65 ght and Expr.pLe
129c0 66 74 20 61 72 65 20 74 68 65 20 6c 65 66 74 20 ft are the left
129d0 61 6e 64 20 72 69 67 68 74 20 73 75 62 65 78 70 and right subexp
129e0 72 65 73 73 69 6f 6e 73 20 6f 66 20 61 0a 2a 2a ressions of a.**
129f0 20 62 69 6e 61 72 79 20 6f 70 65 72 61 74 6f 72 binary operator
12a00 2e 20 45 69 74 68 65 72 20 6f 72 20 62 6f 74 68 . Either or both
12a10 20 6d 61 79 20 62 65 20 4e 55 4c 4c 2e 0a 2a 2a may be NULL..**
12a20 0a 2a 2a 20 45 78 70 72 2e 78 2e 70 4c 69 73 74 .** Expr.x.pList
12a30 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 61 72 is a list of ar
12a40 67 75 6d 65 6e 74 73 20 69 66 20 74 68 65 20 65 guments if the e
12a50 78 70 72 65 73 73 69 6f 6e 20 69 73 20 61 6e 20 xpression is an
12a60 53 51 4c 20 66 75 6e 63 74 69 6f 6e 2c 0a 2a 2a SQL function,.**
12a70 20 61 20 43 41 53 45 20 65 78 70 72 65 73 73 69 a CASE expressi
12a80 6f 6e 20 6f 72 20 61 6e 20 49 4e 20 65 78 70 72 on or an IN expr
12a90 65 73 73 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f ession of the fo
12aa0 72 6d 20 22 3c 6c 68 73 3e 20 49 4e 20 28 3c 79 rm "<lhs> IN (<y
12ab0 3e 2c 20 3c 7a 3e 2e 2e 2e 29 22 2e 0a 2a 2a 20 >, <z>...)"..**
12ac0 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 69 Expr.x.pSelect i
12ad0 73 20 75 73 65 64 20 69 66 20 74 68 65 20 65 78 s used if the ex
12ae0 70 72 65 73 73 69 6f 6e 20 69 73 20 61 20 73 75 pression is a su
12af0 62 2d 73 65 6c 65 63 74 20 6f 72 20 61 6e 20 65 b-select or an e
12b00 78 70 72 65 73 73 69 6f 6e 20 6f 66 0a 2a 2a 20 xpression of.**
12b10 74 68 65 20 66 6f 72 6d 20 22 3c 6c 68 73 3e 20 the form "<lhs>
12b20 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 IN (SELECT ...)"
12b30 2e 20 49 66 20 74 68 65 20 45 50 5f 78 49 73 53 . If the EP_xIsS
12b40 65 6c 65 63 74 20 62 69 74 20 69 73 20 73 65 74 elect bit is set
12b50 20 69 6e 20 74 68 65 0a 2a 2a 20 45 78 70 72 2e in the.** Expr.
12b60 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e flags mask, then
12b70 20 45 78 70 72 2e 78 2e 70 53 65 6c 65 63 74 20 Expr.x.pSelect
12b80 69 73 20 76 61 6c 69 64 2e 20 4f 74 68 65 72 77 is valid. Otherw
12b90 69 73 65 2c 20 45 78 70 72 2e 78 2e 70 4c 69 73 ise, Expr.x.pLis
12ba0 74 20 69 73 20 0a 2a 2a 20 76 61 6c 69 64 2e 0a t is .** valid..
12bb0 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 72 65 73 73 **.** An express
12bc0 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 ion of the form
12bd0 49 44 20 6f 72 20 49 44 2e 49 44 20 72 65 66 65 ID or ID.ID refe
12be0 72 73 20 74 6f 20 61 20 63 6f 6c 75 6d 6e 20 69 rs to a column i
12bf0 6e 20 61 20 74 61 62 6c 65 2e 0a 2a 2a 20 46 6f n a table..** Fo
12c00 72 20 73 75 63 68 20 65 78 70 72 65 73 73 69 6f r such expressio
12c10 6e 73 2c 20 45 78 70 72 2e 6f 70 20 69 73 20 73 ns, Expr.op is s
12c20 65 74 20 74 6f 20 54 4b 5f 43 4f 4c 55 4d 4e 20 et to TK_COLUMN
12c30 61 6e 64 20 45 78 70 72 2e 69 54 61 62 6c 65 20 and Expr.iTable
12c40 69 73 0a 2a 2a 20 74 68 65 20 69 6e 74 65 67 65 is.** the intege
12c50 72 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 r cursor number
12c60 6f 66 20 61 20 56 44 42 45 20 63 75 72 73 6f 72 of a VDBE cursor
12c70 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 74 68 61 pointing to tha
12c80 74 20 74 61 62 6c 65 20 61 6e 64 0a 2a 2a 20 45 t table and.** E
12c90 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 69 73 20 74 xpr.iColumn is t
12ca0 68 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 he column number
12cb0 20 66 6f 72 20 74 68 65 20 73 70 65 63 69 66 69 for the specifi
12cc0 63 20 63 6f 6c 75 6d 6e 2e 20 20 49 66 20 74 68 c column. If th
12cd0 65 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 e.** expression
12ce0 69 73 20 75 73 65 64 20 61 73 20 61 20 72 65 73 is used as a res
12cf0 75 6c 74 20 69 6e 20 61 6e 20 61 67 67 72 65 67 ult in an aggreg
12d00 61 74 65 20 53 45 4c 45 43 54 2c 20 74 68 65 6e ate SELECT, then
12d10 20 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20 69 73 the.** value is
12d20 20 61 6c 73 6f 20 73 74 6f 72 65 64 20 69 6e 20 also stored in
12d30 74 68 65 20 45 78 70 72 2e 69 41 67 67 20 63 6f the Expr.iAgg co
12d40 6c 75 6d 6e 20 69 6e 20 74 68 65 20 61 67 67 72 lumn in the aggr
12d50 65 67 61 74 65 20 73 6f 20 74 68 61 74 0a 2a 2a egate so that.**
12d60 20 69 74 20 63 61 6e 20 62 65 20 61 63 63 65 73 it can be acces
12d70 73 65 64 20 61 66 74 65 72 20 61 6c 6c 20 61 67 sed after all ag
12d80 67 72 65 67 61 74 65 73 20 61 72 65 20 63 6f 6d gregates are com
12d90 70 75 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 puted..**.** If
12da0 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 the expression i
12db0 73 20 61 6e 20 75 6e 62 6f 75 6e 64 20 76 61 72 s an unbound var
12dc0 69 61 62 6c 65 20 6d 61 72 6b 65 72 20 28 61 20 iable marker (a
12dd0 71 75 65 73 74 69 6f 6e 20 6d 61 72 6b 20 0a 2a question mark .*
12de0 2a 20 63 68 61 72 61 63 74 65 72 20 27 3f 27 20 * character '?'
12df0 69 6e 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 in the original
12e00 53 51 4c 29 20 74 68 65 6e 20 74 68 65 20 45 78 SQL) then the Ex
12e10 70 72 2e 69 54 61 62 6c 65 20 68 6f 6c 64 73 20 pr.iTable holds
12e20 74 68 65 20 69 6e 64 65 78 20 0a 2a 2a 20 6e 75 the index .** nu
12e30 6d 62 65 72 20 66 6f 72 20 74 68 61 74 20 76 61 mber for that va
12e40 72 69 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 riable..**.** If
12e50 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 the expression
12e60 69 73 20 61 20 73 75 62 71 75 65 72 79 20 74 68 is a subquery th
12e70 65 6e 20 45 78 70 72 2e 69 43 6f 6c 75 6d 6e 20 en Expr.iColumn
12e80 68 6f 6c 64 73 20 61 6e 20 69 6e 74 65 67 65 72 holds an integer
12e90 0a 2a 2a 20 72 65 67 69 73 74 65 72 20 6e 75 6d .** register num
12ea0 62 65 72 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 ber containing t
12eb0 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 he result of the
12ec0 20 73 75 62 71 75 65 72 79 2e 20 20 49 66 20 74 subquery. If t
12ed0 68 65 0a 2a 2a 20 73 75 62 71 75 65 72 79 20 67 he.** subquery g
12ee0 69 76 65 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 ives a constant
12ef0 72 65 73 75 6c 74 2c 20 74 68 65 6e 20 69 54 61 result, then iTa
12f00 62 6c 65 20 69 73 20 2d 31 2e 20 20 49 66 20 74 ble is -1. If t
12f10 68 65 20 73 75 62 71 75 65 72 79 0a 2a 2a 20 67 he subquery.** g
12f20 69 76 65 73 20 61 20 64 69 66 66 65 72 65 6e 74 ives a different
12f30 20 61 6e 73 77 65 72 20 61 74 20 64 69 66 66 65 answer at diffe
12f40 72 65 6e 74 20 74 69 6d 65 73 20 64 75 72 69 6e rent times durin
12f50 67 20 73 74 61 74 65 6d 65 6e 74 20 70 72 6f 63 g statement proc
12f60 65 73 73 69 6e 67 0a 2a 2a 20 74 68 65 6e 20 69 essing.** then i
12f70 54 61 62 6c 65 20 69 73 20 74 68 65 20 61 64 64 Table is the add
12f80 72 65 73 73 20 6f 66 20 61 20 73 75 62 72 6f 75 ress of a subrou
12f90 74 69 6e 65 20 74 68 61 74 20 63 6f 6d 70 75 74 tine that comput
12fa0 65 73 20 74 68 65 20 73 75 62 71 75 65 72 79 2e es the subquery.
12fb0 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 45 78 .**.** If the Ex
12fc0 70 72 20 69 73 20 6f 66 20 74 79 70 65 20 4f 50 pr is of type OP
12fd0 5f 43 6f 6c 75 6d 6e 2c 20 61 6e 64 20 74 68 65 _Column, and the
12fe0 20 74 61 62 6c 65 20 69 74 20 69 73 20 73 65 6c table it is sel
12ff0 65 63 74 69 6e 67 20 66 72 6f 6d 0a 2a 2a 20 69 ecting from.** i
13000 73 20 61 20 64 69 73 6b 20 74 61 62 6c 65 20 6f s a disk table o
13010 72 20 74 68 65 20 22 6f 6c 64 2e 2a 22 20 70 73 r the "old.*" ps
13020 65 75 64 6f 2d 74 61 62 6c 65 2c 20 74 68 65 6e eudo-table, then
13030 20 70 54 61 62 20 70 6f 69 6e 74 73 20 74 6f 20 pTab points to
13040 74 68 65 0a 2a 2a 20 63 6f 72 72 65 73 70 6f 6e the.** correspon
13050 64 69 6e 67 20 74 61 62 6c 65 20 64 65 66 69 6e ding table defin
13060 69 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 41 4c 4c ition..**.** ALL
13070 4f 43 41 54 49 4f 4e 20 4e 4f 54 45 53 3a 0a 2a OCATION NOTES:.*
13080 2a 0a 2a 2a 20 45 78 70 72 20 6f 62 6a 65 63 74 *.** Expr object
13090 73 20 63 61 6e 20 75 73 65 20 61 20 6c 6f 74 20 s can use a lot
130a0 6f 66 20 6d 65 6d 6f 72 79 20 73 70 61 63 65 20 of memory space
130b0 69 6e 20 64 61 74 61 62 61 73 65 20 73 63 68 65 in database sche
130c0 6d 61 2e 20 20 54 6f 0a 2a 2a 20 68 65 6c 70 20 ma. To.** help
130d0 72 65 64 75 63 65 20 6d 65 6d 6f 72 79 20 72 65 reduce memory re
130e0 71 75 69 72 65 6d 65 6e 74 73 2c 20 73 6f 6d 65 quirements, some
130f0 74 69 6d 65 73 20 61 6e 20 45 78 70 72 20 6f 62 times an Expr ob
13100 6a 65 63 74 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 ject will be.**
13110 74 72 75 6e 63 61 74 65 64 2e 20 20 41 6e 64 20 truncated. And
13120 74 6f 20 72 65 64 75 63 65 20 74 68 65 20 6e 75 to reduce the nu
13130 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20 61 mber of memory a
13140 6c 6c 6f 63 61 74 69 6f 6e 73 2c 20 73 6f 6d 65 llocations, some
13150 74 69 6d 65 73 0a 2a 2a 20 74 77 6f 20 6f 72 20 times.** two or
13160 6d 6f 72 65 20 45 78 70 72 20 6f 62 6a 65 63 74 more Expr object
13170 73 20 77 69 6c 6c 20 62 65 20 73 74 6f 72 65 64 s will be stored
13180 20 69 6e 20 61 20 73 69 6e 67 6c 65 20 6d 65 6d in a single mem
13190 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c 0a ory allocation,.
131a0 2a 2a 20 74 6f 67 65 74 68 65 72 20 77 69 74 68 ** together with
131b0 20 45 78 70 72 2e 7a 54 6f 6b 65 6e 20 73 74 72 Expr.zToken str
131c0 69 6e 67 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ings..**.** If t
131d0 68 65 20 45 50 5f 52 65 64 75 63 65 64 20 61 6e he EP_Reduced an
131e0 64 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 d EP_TokenOnly f
131f0 6c 61 67 73 20 61 72 65 20 73 65 74 20 77 68 65 lags are set whe
13200 6e 0a 2a 2a 20 61 6e 20 45 78 70 72 20 6f 62 6a n.** an Expr obj
13210 65 63 74 20 69 73 20 74 72 75 6e 63 61 74 65 64 ect is truncated
13220 2e 20 20 57 68 65 6e 20 45 50 5f 52 65 64 75 63 . When EP_Reduc
13230 65 64 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 ed is set, then
13240 61 6c 6c 0a 2a 2a 20 74 68 65 20 63 68 69 6c 64 all.** the child
13250 20 45 78 70 72 20 6f 62 6a 65 63 74 73 20 69 6e Expr objects in
13260 20 74 68 65 20 45 78 70 72 2e 70 4c 65 66 74 20 the Expr.pLeft
13270 61 6e 64 20 45 78 70 72 2e 70 52 69 67 68 74 20 and Expr.pRight
13280 73 75 62 74 72 65 65 73 0a 2a 2a 20 61 72 65 20 subtrees.** are
13290 63 6f 6e 74 61 69 6e 65 64 20 77 69 74 68 69 6e contained within
132a0 20 74 68 65 20 73 61 6d 65 20 6d 65 6d 6f 72 79 the same memory
132b0 20 61 6c 6c 6f 63 61 74 69 6f 6e 2e 20 20 4e 6f allocation. No
132c0 74 65 2c 20 68 6f 77 65 76 65 72 2c 20 74 68 61 te, however, tha
132d0 74 0a 2a 2a 20 74 68 65 20 73 75 62 74 72 65 65 t.** the subtree
132e0 73 20 69 6e 20 45 78 70 72 2e 78 2e 70 4c 69 73 s in Expr.x.pLis
132f0 74 20 6f 72 20 45 78 70 72 2e 78 2e 70 53 65 6c t or Expr.x.pSel
13300 65 63 74 20 61 72 65 20 61 6c 77 61 79 73 20 73 ect are always s
13310 65 70 61 72 61 74 65 6c 79 0a 2a 2a 20 61 6c 6c eparately.** all
13320 6f 63 61 74 65 64 2c 20 72 65 67 61 72 64 6c 65 ocated, regardle
13330 73 73 20 6f 66 20 77 68 65 74 68 65 72 20 6f 72 ss of whether or
13340 20 6e 6f 74 20 45 50 5f 52 65 64 75 63 65 64 20 not EP_Reduced
13350 69 73 20 73 65 74 2e 0a 2a 2f 0a 73 74 72 75 63 is set..*/.struc
13360 74 20 45 78 70 72 20 7b 0a 20 20 75 38 20 6f 70 t Expr {. u8 op
13370 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
13380 20 20 2f 2a 20 4f 70 65 72 61 74 69 6f 6e 20 70 /* Operation p
13390 65 72 66 6f 72 6d 65 64 20 62 79 20 74 68 69 73 erformed by this
133a0 20 6e 6f 64 65 20 2a 2f 0a 20 20 63 68 61 72 20 node */. char
133b0 61 66 66 69 6e 69 74 79 3b 20 20 20 20 20 20 20 affinity;
133c0 20 20 2f 2a 20 54 68 65 20 61 66 66 69 6e 69 74 /* The affinit
133d0 79 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 y of the column
133e0 6f 72 20 30 20 69 66 20 6e 6f 74 20 61 20 63 6f or 0 if not a co
133f0 6c 75 6d 6e 20 2a 2f 0a 20 20 75 33 32 20 66 6c lumn */. u32 fl
13400 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 ags;
13410 20 2f 2a 20 56 61 72 69 6f 75 73 20 66 6c 61 67 /* Various flag
13420 73 2e 20 20 45 50 5f 2a 20 53 65 65 20 62 65 6c s. EP_* See bel
13430 6f 77 20 2a 2f 0a 20 20 75 6e 69 6f 6e 20 7b 0a ow */. union {.
13440 20 20 20 20 63 68 61 72 20 2a 7a 54 6f 6b 65 6e char *zToken
13450 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f ; /* To
13460 6b 65 6e 20 76 61 6c 75 65 2e 20 5a 65 72 6f 20 ken value. Zero
13470 74 65 72 6d 69 6e 61 74 65 64 20 61 6e 64 20 64 terminated and d
13480 65 71 75 6f 74 65 64 20 2a 2f 0a 20 20 20 20 69 equoted */. i
13490 6e 74 20 69 56 61 6c 75 65 3b 20 20 20 20 20 20 nt iValue;
134a0 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d 6e 65 67 /* Non-neg
134b0 61 74 69 76 65 20 69 6e 74 65 67 65 72 20 76 61 ative integer va
134c0 6c 75 65 20 69 66 20 45 50 5f 49 6e 74 56 61 6c lue if EP_IntVal
134d0 75 65 20 2a 2f 0a 20 20 7d 20 75 3b 0a 0a 20 20 ue */. } u;..
134e0 2f 2a 20 49 66 20 74 68 65 20 45 50 5f 54 6f 6b /* If the EP_Tok
134f0 65 6e 4f 6e 6c 79 20 66 6c 61 67 20 69 73 20 73 enOnly flag is s
13500 65 74 20 69 6e 20 74 68 65 20 45 78 70 72 2e 66 et in the Expr.f
13510 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 65 6e 20 lags mask, then
13520 6e 6f 0a 20 20 2a 2a 20 73 70 61 63 65 20 69 73 no. ** space is
13530 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 74 allocated for t
13540 68 65 20 66 69 65 6c 64 73 20 62 65 6c 6f 77 20 he fields below
13550 74 68 69 73 20 70 6f 69 6e 74 2e 20 41 6e 20 61 this point. An a
13560 74 74 65 6d 70 74 20 74 6f 0a 20 20 2a 2a 20 61 ttempt to. ** a
13570 63 63 65 73 73 20 74 68 65 6d 20 77 69 6c 6c 20 ccess them will
13580 72 65 73 75 6c 74 20 69 6e 20 61 20 73 65 67 66 result in a segf
13590 61 75 6c 74 20 6f 72 20 6d 61 6c 66 75 6e 63 74 ault or malfunct
135a0 69 6f 6e 2e 20 0a 20 20 2a 2a 2a 2a 2a 2a 2a 2a ion. . ********
135b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
135c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
135d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
135e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a *************/..
135f0 20 20 45 78 70 72 20 2a 70 4c 65 66 74 3b 20 20 Expr *pLeft;
13600 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 66 74 /* Left
13610 20 73 75 62 6e 6f 64 65 20 2a 2f 0a 20 20 45 78 subnode */. Ex
13620 70 72 20 2a 70 52 69 67 68 74 3b 20 20 20 20 20 pr *pRight;
13630 20 20 20 20 20 2f 2a 20 52 69 67 68 74 20 73 75 /* Right su
13640 62 6e 6f 64 65 20 2a 2f 0a 20 20 75 6e 69 6f 6e bnode */. union
13650 20 7b 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 {. ExprList
13660 2a 70 4c 69 73 74 3b 20 20 20 20 20 2f 2a 20 6f *pList; /* o
13670 70 20 3d 20 49 4e 2c 20 45 58 49 53 54 53 2c 20 p = IN, EXISTS,
13680 53 45 4c 45 43 54 2c 20 43 41 53 45 2c 20 46 55 SELECT, CASE, FU
13690 4e 43 54 49 4f 4e 2c 20 42 45 54 57 45 45 4e 20 NCTION, BETWEEN
136a0 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 */. Select *p
136b0 53 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 45 Select; /* E
136c0 50 5f 78 49 73 53 65 6c 65 63 74 20 61 6e 64 20 P_xIsSelect and
136d0 6f 70 20 3d 20 49 4e 2c 20 45 58 49 53 54 53 2c op = IN, EXISTS,
136e0 20 53 45 4c 45 43 54 20 2a 2f 0a 20 20 7d 20 78 SELECT */. } x
136f0 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 45 ;.. /* If the E
13700 50 5f 52 65 64 75 63 65 64 20 66 6c 61 67 20 69 P_Reduced flag i
13710 73 20 73 65 74 20 69 6e 20 74 68 65 20 45 78 70 s set in the Exp
13720 72 2e 66 6c 61 67 73 20 6d 61 73 6b 2c 20 74 68 r.flags mask, th
13730 65 6e 20 6e 6f 0a 20 20 2a 2a 20 73 70 61 63 65 en no. ** space
13740 20 69 73 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f is allocated fo
13750 72 20 74 68 65 20 66 69 65 6c 64 73 20 62 65 6c r the fields bel
13760 6f 77 20 74 68 69 73 20 70 6f 69 6e 74 2e 20 41 ow this point. A
13770 6e 20 61 74 74 65 6d 70 74 20 74 6f 0a 20 20 2a n attempt to. *
13780 2a 20 61 63 63 65 73 73 20 74 68 65 6d 20 77 69 * access them wi
13790 6c 6c 20 72 65 73 75 6c 74 20 69 6e 20 61 20 73 ll result in a s
137a0 65 67 66 61 75 6c 74 20 6f 72 20 6d 61 6c 66 75 egfault or malfu
137b0 6e 63 74 69 6f 6e 2e 0a 20 20 2a 2a 2a 2a 2a 2a nction.. ******
137c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
137d0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
137e0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
137f0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f ***************/
13800 0a 0a 23 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 ..#if SQLITE_MAX
13810 5f 45 58 50 52 5f 44 45 50 54 48 3e 30 0a 20 20 _EXPR_DEPTH>0.
13820 69 6e 74 20 6e 48 65 69 67 68 74 3b 20 20 20 20 int nHeight;
13830 20 20 20 20 20 20 20 2f 2a 20 48 65 69 67 68 74 /* Height
13840 20 6f 66 20 74 68 65 20 74 72 65 65 20 68 65 61 of the tree hea
13850 64 65 64 20 62 79 20 74 68 69 73 20 6e 6f 64 65 ded by this node
13860 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e 74 */.#endif. int
13870 20 69 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20 iTable;
13880 20 20 20 20 2f 2a 20 54 4b 5f 43 4f 4c 55 4d 4e /* TK_COLUMN
13890 3a 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 20 : cursor number
138a0 6f 66 20 74 61 62 6c 65 20 68 6f 6c 64 69 6e 67 of table holding
138b0 20 63 6f 6c 75 6d 6e 0a 20 20 20 20 20 20 20 20 column.
138c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
138d0 20 2a 2a 20 54 4b 5f 52 45 47 49 53 54 45 52 3a ** TK_REGISTER:
138e0 20 72 65 67 69 73 74 65 72 20 6e 75 6d 62 65 72 register number
138f0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
13900 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 4b 5f ** TK_
13910 54 52 49 47 47 45 52 3a 20 31 20 2d 3e 20 6e 65 TRIGGER: 1 -> ne
13920 77 2c 20 30 20 2d 3e 20 6f 6c 64 0a 20 20 20 20 w, 0 -> old.
13930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13940 20 20 20 20 20 2a 2a 20 45 50 5f 55 6e 6c 69 6b ** EP_Unlik
13950 65 6c 79 3a 20 20 31 30 30 30 20 74 69 6d 65 73 ely: 1000 times
13960 20 6c 69 6b 65 6c 69 68 6f 6f 64 20 2a 2f 0a 20 likelihood */.
13970 20 79 6e 56 61 72 20 69 43 6f 6c 75 6d 6e 3b 20 ynVar iColumn;
13980 20 20 20 20 20 20 20 20 2f 2a 20 54 4b 5f 43 4f /* TK_CO
13990 4c 55 4d 4e 3a 20 63 6f 6c 75 6d 6e 20 69 6e 64 LUMN: column ind
139a0 65 78 2e 20 20 2d 31 20 66 6f 72 20 72 6f 77 69 ex. -1 for rowi
139b0 64 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 d..
139c0 20 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 54 ** T
139d0 4b 5f 56 41 52 49 41 42 4c 45 3a 20 76 61 72 69 K_VARIABLE: vari
139e0 61 62 6c 65 20 6e 75 6d 62 65 72 20 28 61 6c 77 able number (alw
139f0 61 79 73 20 3e 3d 20 31 29 2e 20 2a 2f 0a 20 20 ays >= 1). */.
13a00 69 31 36 20 69 41 67 67 3b 20 20 20 20 20 20 20 i16 iAgg;
13a10 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68 20 /* Which
13a20 65 6e 74 72 79 20 69 6e 20 70 41 67 67 49 6e 66 entry in pAggInf
13a30 6f 2d 3e 61 43 6f 6c 5b 5d 20 6f 72 20 2d 3e 61 o->aCol[] or ->a
13a40 46 75 6e 63 5b 5d 20 2a 2f 0a 20 20 69 31 36 20 Func[] */. i16
13a50 69 52 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 3b iRightJoinTable;
13a60 20 20 20 2f 2a 20 49 66 20 45 50 5f 46 72 6f 6d /* If EP_From
13a70 4a 6f 69 6e 2c 20 74 68 65 20 72 69 67 68 74 20 Join, the right
13a80 74 61 62 6c 65 20 6f 66 20 74 68 65 20 6a 6f 69 table of the joi
13a90 6e 20 2a 2f 0a 20 20 75 38 20 6f 70 32 3b 20 20 n */. u8 op2;
13aa0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
13ab0 20 54 4b 5f 52 45 47 49 53 54 45 52 3a 20 6f 72 TK_REGISTER: or
13ac0 69 67 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 iginal value of
13ad0 45 78 70 72 2e 6f 70 0a 20 20 20 20 20 20 20 20 Expr.op.
13ae0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13af0 20 2a 2a 20 54 4b 5f 43 4f 4c 55 4d 4e 3a 20 74 ** TK_COLUMN: t
13b00 68 65 20 76 61 6c 75 65 20 6f 66 20 70 35 20 66 he value of p5 f
13b10 6f 72 20 4f 50 5f 43 6f 6c 75 6d 6e 0a 20 20 20 or OP_Column.
13b20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
13b30 20 20 20 20 20 20 2a 2a 20 54 4b 5f 41 47 47 5f ** TK_AGG_
13b40 46 55 4e 43 54 49 4f 4e 3a 20 6e 65 73 74 69 6e FUNCTION: nestin
13b50 67 20 64 65 70 74 68 20 2a 2f 0a 20 20 41 67 67 g depth */. Agg
13b60 49 6e 66 6f 20 2a 70 41 67 67 49 6e 66 6f 3b 20 Info *pAggInfo;
13b70 20 20 20 20 2f 2a 20 55 73 65 64 20 62 79 20 54 /* Used by T
13b80 4b 5f 41 47 47 5f 43 4f 4c 55 4d 4e 20 61 6e 64 K_AGG_COLUMN and
13b90 20 54 4b 5f 41 47 47 5f 46 55 4e 43 54 49 4f 4e TK_AGG_FUNCTION
13ba0 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 */. Table *pTa
13bb0 62 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 b; /*
13bc0 54 61 62 6c 65 20 66 6f 72 20 54 4b 5f 43 4f 4c Table for TK_COL
13bd0 55 4d 4e 20 65 78 70 72 65 73 73 69 6f 6e 73 2e UMN expressions.
13be0 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 */.};../*.** Th
13bf0 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 e following are
13c00 74 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 20 the meanings of
13c10 62 69 74 73 20 69 6e 20 74 68 65 20 45 78 70 72 bits in the Expr
13c20 2e 66 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a 2f .flags field..*/
13c30 0a 23 64 65 66 69 6e 65 20 45 50 5f 46 72 6f 6d .#define EP_From
13c40 4a 6f 69 6e 20 20 30 78 30 30 30 30 30 31 20 2f Join 0x000001 /
13c50 2a 20 4f 72 69 67 69 6e 61 74 65 64 20 69 6e 20 * Originated in
13c60 4f 4e 20 6f 72 20 55 53 49 4e 47 20 63 6c 61 75 ON or USING clau
13c70 73 65 20 6f 66 20 61 20 6a 6f 69 6e 20 2a 2f 0a se of a join */.
13c80 23 64 65 66 69 6e 65 20 45 50 5f 41 67 67 20 20 #define EP_Agg
13c90 20 20 20 20 20 30 78 30 30 30 30 30 32 20 2f 2a 0x000002 /*
13ca0 20 43 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 Contains one or
13cb0 20 6d 6f 72 65 20 61 67 67 72 65 67 61 74 65 20 more aggregate
13cc0 66 75 6e 63 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 functions */.#de
13cd0 66 69 6e 65 20 45 50 5f 52 65 73 6f 6c 76 65 64 fine EP_Resolved
13ce0 20 20 30 78 30 30 30 30 30 34 20 2f 2a 20 49 44 0x000004 /* ID
13cf0 73 20 68 61 76 65 20 62 65 65 6e 20 72 65 73 6f s have been reso
13d00 6c 76 65 64 20 74 6f 20 43 4f 4c 55 4d 4e 73 20 lved to COLUMNs
13d10 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 45 72 */.#define EP_Er
13d20 72 6f 72 20 20 20 20 20 30 78 30 30 30 30 30 38 ror 0x000008
13d30 20 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 63 /* Expression c
13d40 6f 6e 74 61 69 6e 73 20 6f 6e 65 20 6f 72 20 6d ontains one or m
13d50 6f 72 65 20 65 72 72 6f 72 73 20 2a 2f 0a 23 64 ore errors */.#d
13d60 65 66 69 6e 65 20 45 50 5f 44 69 73 74 69 6e 63 efine EP_Distinc
13d70 74 20 20 30 78 30 30 30 30 31 30 20 2f 2a 20 41 t 0x000010 /* A
13d80 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f ggregate functio
13d90 6e 20 77 69 74 68 20 44 49 53 54 49 4e 43 54 20 n with DISTINCT
13da0 6b 65 79 77 6f 72 64 20 2a 2f 0a 23 64 65 66 69 keyword */.#defi
13db0 6e 65 20 45 50 5f 56 61 72 53 65 6c 65 63 74 20 ne EP_VarSelect
13dc0 30 78 30 30 30 30 32 30 20 2f 2a 20 70 53 65 6c 0x000020 /* pSel
13dd0 65 63 74 20 69 73 20 63 6f 72 72 65 6c 61 74 65 ect is correlate
13de0 64 2c 20 6e 6f 74 20 63 6f 6e 73 74 61 6e 74 20 d, not constant
13df0 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 44 62 */.#define EP_Db
13e00 6c 51 75 6f 74 65 64 20 30 78 30 30 30 30 34 30 lQuoted 0x000040
13e10 20 2f 2a 20 74 6f 6b 65 6e 2e 7a 20 77 61 73 20 /* token.z was
13e20 6f 72 69 67 69 6e 61 6c 6c 79 20 69 6e 20 22 2e originally in ".
13e30 2e 2e 22 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 .." */.#define E
13e40 50 5f 49 6e 66 69 78 46 75 6e 63 20 30 78 30 30 P_InfixFunc 0x00
13e50 30 30 38 30 20 2f 2a 20 54 72 75 65 20 66 6f 72 0080 /* True for
13e60 20 61 6e 20 69 6e 66 69 78 20 66 75 6e 63 74 69 an infix functi
13e70 6f 6e 3a 20 4c 49 4b 45 2c 20 47 4c 4f 42 2c 20 on: LIKE, GLOB,
13e80 65 74 63 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 etc */.#define E
13e90 50 5f 43 6f 6c 6c 61 74 65 20 20 20 30 78 30 30 P_Collate 0x00
13ea0 30 31 30 30 20 2f 2a 20 54 72 65 65 20 63 6f 6e 0100 /* Tree con
13eb0 74 61 69 6e 73 20 61 20 54 4b 5f 43 4f 4c 4c 41 tains a TK_COLLA
13ec0 54 45 20 6f 70 65 72 61 74 6f 72 20 2a 2f 0a 23 TE operator */.#
13ed0 64 65 66 69 6e 65 20 45 50 5f 47 65 6e 65 72 69 define EP_Generi
13ee0 63 20 20 20 30 78 30 30 30 32 30 30 20 2f 2a 20 c 0x000200 /*
13ef0 49 67 6e 6f 72 65 20 43 4f 4c 4c 41 54 45 20 6f Ignore COLLATE o
13f00 72 20 61 66 66 69 6e 69 74 79 20 6f 6e 20 74 68 r affinity on th
13f10 69 73 20 74 72 65 65 20 2a 2f 0a 23 64 65 66 69 is tree */.#defi
13f20 6e 65 20 45 50 5f 49 6e 74 56 61 6c 75 65 20 20 ne EP_IntValue
13f30 30 78 30 30 30 34 30 30 20 2f 2a 20 49 6e 74 65 0x000400 /* Inte
13f40 67 65 72 20 76 61 6c 75 65 20 63 6f 6e 74 61 69 ger value contai
13f50 6e 65 64 20 69 6e 20 75 2e 69 56 61 6c 75 65 20 ned in u.iValue
13f60 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 78 49 */.#define EP_xI
13f70 73 53 65 6c 65 63 74 20 30 78 30 30 30 38 30 30 sSelect 0x000800
13f80 20 2f 2a 20 78 2e 70 53 65 6c 65 63 74 20 69 73 /* x.pSelect is
13f90 20 76 61 6c 69 64 20 28 6f 74 68 65 72 77 69 73 valid (otherwis
13fa0 65 20 78 2e 70 4c 69 73 74 20 69 73 29 20 2a 2f e x.pList is) */
13fb0 0a 23 64 65 66 69 6e 65 20 45 50 5f 53 6b 69 70 .#define EP_Skip
13fc0 20 20 20 20 20 20 30 78 30 30 31 30 30 30 20 2f 0x001000 /
13fd0 2a 20 43 4f 4c 4c 41 54 45 2c 20 41 53 2c 20 6f * COLLATE, AS, o
13fe0 72 20 55 4e 4c 49 4b 45 4c 59 20 2a 2f 0a 23 64 r UNLIKELY */.#d
13ff0 65 66 69 6e 65 20 45 50 5f 52 65 64 75 63 65 64 efine EP_Reduced
14000 20 20 20 30 78 30 30 32 30 30 30 20 2f 2a 20 45 0x002000 /* E
14010 78 70 72 20 73 74 72 75 63 74 20 45 58 50 52 5f xpr struct EXPR_
14020 52 45 44 55 43 45 44 53 49 5a 45 20 62 79 74 65 REDUCEDSIZE byte
14030 73 20 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e s only */.#defin
14040 65 20 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 30 e EP_TokenOnly 0
14050 78 30 30 34 30 30 30 20 2f 2a 20 45 78 70 72 20 x004000 /* Expr
14060 73 74 72 75 63 74 20 45 58 50 52 5f 54 4f 4b 45 struct EXPR_TOKE
14070 4e 4f 4e 4c 59 53 49 5a 45 20 62 79 74 65 73 20 NONLYSIZE bytes
14080 6f 6e 6c 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 only */.#define
14090 45 50 5f 53 74 61 74 69 63 20 20 20 20 30 78 30 EP_Static 0x0
140a0 30 38 30 30 30 20 2f 2a 20 48 65 6c 64 20 69 6e 08000 /* Held in
140b0 20 6d 65 6d 6f 72 79 20 6e 6f 74 20 6f 62 74 61 memory not obta
140c0 69 6e 65 64 20 66 72 6f 6d 20 6d 61 6c 6c 6f 63 ined from malloc
140d0 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 45 50 () */.#define EP
140e0 5f 4d 65 6d 54 6f 6b 65 6e 20 20 30 78 30 31 30 _MemToken 0x010
140f0 30 30 30 20 2f 2a 20 4e 65 65 64 20 74 6f 20 73 000 /* Need to s
14100 71 6c 69 74 65 33 44 62 46 72 65 65 28 29 20 45 qlite3DbFree() E
14110 78 70 72 2e 7a 54 6f 6b 65 6e 20 2a 2f 0a 23 64 xpr.zToken */.#d
14120 65 66 69 6e 65 20 45 50 5f 4e 6f 52 65 64 75 63 efine EP_NoReduc
14130 65 20 20 30 78 30 32 30 30 30 30 20 2f 2a 20 43 e 0x020000 /* C
14140 61 6e 6e 6f 74 20 45 58 50 52 44 55 50 5f 52 45 annot EXPRDUP_RE
14150 44 55 43 45 20 74 68 69 73 20 45 78 70 72 20 2a DUCE this Expr *
14160 2f 0a 23 64 65 66 69 6e 65 20 45 50 5f 55 6e 6c /.#define EP_Unl
14170 69 6b 65 6c 79 20 20 30 78 30 34 30 30 30 30 20 ikely 0x040000
14180 2f 2a 20 75 6e 6c 69 6b 65 6c 79 28 29 20 6f 72 /* unlikely() or
14190 20 6c 69 6b 65 6c 69 68 6f 6f 64 28 29 20 66 75 likelihood() fu
141a0 6e 63 74 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e nction */.#defin
141b0 65 20 45 50 5f 43 6f 6e 73 74 61 6e 74 20 20 30 e EP_Constant 0
141c0 78 30 38 30 30 30 30 20 2f 2a 20 4e 6f 64 65 20 x080000 /* Node
141d0 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 20 2a 2f is a constant */
141e0 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 73 65 20 6d 61 ../*.** These ma
141f0 63 72 6f 73 20 63 61 6e 20 62 65 20 75 73 65 64 cros can be used
14200 20 74 6f 20 74 65 73 74 2c 20 73 65 74 2c 20 6f to test, set, o
14210 72 20 63 6c 65 61 72 20 62 69 74 73 20 69 6e 20 r clear bits in
14220 74 68 65 20 0a 2a 2a 20 45 78 70 72 2e 66 6c 61 the .** Expr.fla
14230 67 73 20 66 69 65 6c 64 2e 0a 2a 2f 0a 23 64 65 gs field..*/.#de
14240 66 69 6e 65 20 45 78 70 72 48 61 73 50 72 6f 70 fine ExprHasProp
14250 65 72 74 79 28 45 2c 50 29 20 20 20 20 20 28 28 erty(E,P) ((
14260 28 45 29 2d 3e 66 6c 61 67 73 26 28 50 29 29 21 (E)->flags&(P))!
14270 3d 30 29 0a 23 64 65 66 69 6e 65 20 45 78 70 72 =0).#define Expr
14280 48 61 73 41 6c 6c 50 72 6f 70 65 72 74 79 28 45 HasAllProperty(E
14290 2c 50 29 20 20 28 28 28 45 29 2d 3e 66 6c 61 67 ,P) (((E)->flag
142a0 73 26 28 50 29 29 3d 3d 28 50 29 29 0a 23 64 65 s&(P))==(P)).#de
142b0 66 69 6e 65 20 45 78 70 72 53 65 74 50 72 6f 70 fine ExprSetProp
142c0 65 72 74 79 28 45 2c 50 29 20 20 20 20 20 28 45 erty(E,P) (E
142d0 29 2d 3e 66 6c 61 67 73 7c 3d 28 50 29 0a 23 64 )->flags|=(P).#d
142e0 65 66 69 6e 65 20 45 78 70 72 43 6c 65 61 72 50 efine ExprClearP
142f0 72 6f 70 65 72 74 79 28 45 2c 50 29 20 20 20 28 roperty(E,P) (
14300 45 29 2d 3e 66 6c 61 67 73 26 3d 7e 28 50 29 0a E)->flags&=~(P).
14310 0a 2f 2a 20 54 68 65 20 45 78 70 72 53 65 74 56 ./* The ExprSetV
14320 56 41 50 72 6f 70 65 72 74 79 28 29 20 6d 61 63 VAProperty() mac
14330 72 6f 20 69 73 20 75 73 65 64 20 66 6f 72 20 56 ro is used for V
14340 65 72 69 66 69 63 61 74 69 6f 6e 2c 20 56 61 6c erification, Val
14350 69 64 61 74 69 6f 6e 2c 0a 2a 2a 20 61 6e 64 20 idation,.** and
14360 41 63 63 72 65 64 69 74 61 74 69 6f 6e 20 6f 6e Accreditation on
14370 6c 79 2e 20 20 49 74 20 77 6f 72 6b 73 20 6c 69 ly. It works li
14380 6b 65 20 45 78 70 72 53 65 74 50 72 6f 70 65 72 ke ExprSetProper
14390 74 79 28 29 20 64 75 72 69 6e 67 20 56 56 41 0a ty() during VVA.
143a0 2a 2a 20 70 72 6f 63 65 73 73 65 73 20 62 75 74 ** processes but
143b0 20 69 73 20 61 20 6e 6f 2d 6f 70 20 66 6f 72 20 is a no-op for
143c0 64 65 6c 69 76 65 72 79 2e 0a 2a 2f 0a 23 69 66 delivery..*/.#if
143d0 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 def SQLITE_DEBUG
143e0 0a 23 20 64 65 66 69 6e 65 20 45 78 70 72 53 65 .# define ExprSe
143f0 74 56 56 41 50 72 6f 70 65 72 74 79 28 45 2c 50 tVVAProperty(E,P
14400 29 20 20 28 45 29 2d 3e 66 6c 61 67 73 7c 3d 28 ) (E)->flags|=(
14410 50 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e P).#else.# defin
14420 65 20 45 78 70 72 53 65 74 56 56 41 50 72 6f 70 e ExprSetVVAProp
14430 65 72 74 79 28 45 2c 50 29 0a 23 65 6e 64 69 66 erty(E,P).#endif
14440 0a 0a 2f 2a 0a 2a 2a 20 4d 61 63 72 6f 73 20 74 ../*.** Macros t
14450 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 o determine the
14460 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 number of bytes
14470 72 65 71 75 69 72 65 64 20 62 79 20 61 20 6e 6f required by a no
14480 72 6d 61 6c 20 45 78 70 72 20 0a 2a 2a 20 73 74 rmal Expr .** st
14490 72 75 63 74 2c 20 61 6e 20 45 78 70 72 20 73 74 ruct, an Expr st
144a0 72 75 63 74 20 77 69 74 68 20 74 68 65 20 45 50 ruct with the EP
144b0 5f 52 65 64 75 63 65 64 20 66 6c 61 67 20 73 65 _Reduced flag se
144c0 74 20 69 6e 20 45 78 70 72 2e 66 6c 61 67 73 20 t in Expr.flags
144d0 0a 2a 2a 20 61 6e 64 20 61 6e 20 45 78 70 72 20 .** and an Expr
144e0 73 74 72 75 63 74 20 77 69 74 68 20 74 68 65 20 struct with the
144f0 45 50 5f 54 6f 6b 65 6e 4f 6e 6c 79 20 66 6c 61 EP_TokenOnly fla
14500 67 20 73 65 74 2e 0a 2a 2f 0a 23 64 65 66 69 6e g set..*/.#defin
14510 65 20 45 58 50 52 5f 46 55 4c 4c 53 49 5a 45 20 e EXPR_FULLSIZE
14520 20 20 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 sizeof
14530 28 45 78 70 72 29 20 20 20 20 20 20 20 20 20 20 (Expr)
14540 20 2f 2a 20 46 75 6c 6c 20 73 69 7a 65 20 2a 2f /* Full size */
14550 0a 23 64 65 66 69 6e 65 20 45 58 50 52 5f 52 45 .#define EXPR_RE
14560 44 55 43 45 44 53 49 5a 45 20 20 20 20 20 20 20 DUCEDSIZE
14570 20 6f 66 66 73 65 74 6f 66 28 45 78 70 72 2c 69 offsetof(Expr,i
14580 54 61 62 6c 65 29 20 20 2f 2a 20 43 6f 6d 6d 6f Table) /* Commo
14590 6e 20 66 65 61 74 75 72 65 73 20 2a 2f 0a 23 64 n features */.#d
145a0 65 66 69 6e 65 20 45 58 50 52 5f 54 4f 4b 45 4e efine EXPR_TOKEN
145b0 4f 4e 4c 59 53 49 5a 45 20 20 20 20 20 20 6f 66 ONLYSIZE of
145c0 66 73 65 74 6f 66 28 45 78 70 72 2c 70 4c 65 66 fsetof(Expr,pLef
145d0 74 29 20 20 20 2f 2a 20 46 65 77 65 72 20 66 65 t) /* Fewer fe
145e0 61 74 75 72 65 73 20 2a 2f 0a 0a 2f 2a 0a 2a 2a atures */../*.**
145f0 20 46 6c 61 67 73 20 70 61 73 73 65 64 20 74 6f Flags passed to
14600 20 74 68 65 20 73 71 6c 69 74 65 33 45 78 70 72 the sqlite3Expr
14610 44 75 70 28 29 20 66 75 6e 63 74 69 6f 6e 2e 20 Dup() function.
14620 53 65 65 20 74 68 65 20 68 65 61 64 65 72 20 63 See the header c
14630 6f 6d 6d 65 6e 74 20 0a 2a 2a 20 61 62 6f 76 65 omment .** above
14640 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 sqlite3ExprDup(
14650 29 20 66 6f 72 20 64 65 74 61 69 6c 73 2e 0a 2a ) for details..*
14660 2f 0a 23 64 65 66 69 6e 65 20 45 58 50 52 44 55 /.#define EXPRDU
14670 50 5f 52 45 44 55 43 45 20 20 20 20 20 20 20 20 P_REDUCE
14680 20 30 78 30 30 30 31 20 20 2f 2a 20 55 73 65 64 0x0001 /* Used
14690 20 72 65 64 75 63 65 64 2d 73 69 7a 65 20 45 78 reduced-size Ex
146a0 70 72 20 6e 6f 64 65 73 20 2a 2f 0a 0a 2f 2a 0a pr nodes */../*.
146b0 2a 2a 20 41 20 6c 69 73 74 20 6f 66 20 65 78 70 ** A list of exp
146c0 72 65 73 73 69 6f 6e 73 2e 20 20 45 61 63 68 20 ressions. Each
146d0 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 79 20 6f expression may o
146e0 70 74 69 6f 6e 61 6c 6c 79 20 68 61 76 65 20 61 ptionally have a
146f0 0a 2a 2a 20 6e 61 6d 65 2e 20 20 41 6e 20 65 78 .** name. An ex
14700 70 72 2f 6e 61 6d 65 20 63 6f 6d 62 69 6e 61 74 pr/name combinat
14710 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20 ion can be used
14720 69 6e 20 73 65 76 65 72 61 6c 20 77 61 79 73 2c in several ways,
14730 20 73 75 63 68 0a 2a 2a 20 61 73 20 74 68 65 20 such.** as the
14740 6c 69 73 74 20 6f 66 20 22 65 78 70 72 20 41 53 list of "expr AS
14750 20 49 44 22 20 66 69 65 6c 64 73 20 66 6f 6c 6c ID" fields foll
14760 6f 77 69 6e 67 20 61 20 22 53 45 4c 45 43 54 22 owing a "SELECT"
14770 20 6f 72 20 69 6e 20 74 68 65 0a 2a 2a 20 6c 69 or in the.** li
14780 73 74 20 6f 66 20 22 49 44 20 3d 20 65 78 70 72 st of "ID = expr
14790 22 20 69 74 65 6d 73 20 69 6e 20 61 6e 20 55 50 " items in an UP
147a0 44 41 54 45 2e 20 20 41 20 6c 69 73 74 20 6f 66 DATE. A list of
147b0 20 65 78 70 72 65 73 73 69 6f 6e 73 20 63 61 6e expressions can
147c0 0a 2a 2a 20 61 6c 73 6f 20 62 65 20 75 73 65 64 .** also be used
147d0 20 61 73 20 74 68 65 20 61 72 67 75 6d 65 6e 74 as the argument
147e0 20 74 6f 20 61 20 66 75 6e 63 74 69 6f 6e 2c 20 to a function,
147f0 69 6e 20 77 68 69 63 68 20 63 61 73 65 20 74 68 in which case th
14800 65 20 61 2e 7a 4e 61 6d 65 0a 2a 2a 20 66 69 65 e a.zName.** fie
14810 6c 64 20 69 73 20 6e 6f 74 20 75 73 65 64 2e 0a ld is not used..
14820 2a 2a 0a 2a 2a 20 42 79 20 64 65 66 61 75 6c 74 **.** By default
14830 20 74 68 65 20 45 78 70 72 2e 7a 53 70 61 6e 20 the Expr.zSpan
14840 66 69 65 6c 64 20 68 6f 6c 64 73 20 61 20 68 75 field holds a hu
14850 6d 61 6e 2d 72 65 61 64 61 62 6c 65 20 64 65 73 man-readable des
14860 63 72 69 70 74 69 6f 6e 20 6f 66 0a 2a 2a 20 74 cription of.** t
14870 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 74 68 he expression th
14880 61 74 20 69 73 20 75 73 65 64 20 69 6e 20 74 68 at is used in th
14890 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 6f 66 20 e generation of
148a0 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 61 error messages a
148b0 6e 64 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6c 61 62 nd.** column lab
148c0 65 6c 73 2e 20 20 49 6e 20 74 68 69 73 20 63 61 els. In this ca
148d0 73 65 2c 20 45 78 70 72 2e 7a 53 70 61 6e 20 69 se, Expr.zSpan i
148e0 73 20 74 79 70 69 63 61 6c 6c 79 20 74 68 65 20 s typically the
148f0 74 65 78 74 20 6f 66 20 61 0a 2a 2a 20 63 6f 6c text of a.** col
14900 75 6d 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 61 umn expression a
14910 73 20 69 74 20 65 78 69 73 74 73 20 69 6e 20 61 s it exists in a
14920 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e SELECT statemen
14930 74 2e 20 20 48 6f 77 65 76 65 72 2c 20 69 66 0a t. However, if.
14940 2a 2a 20 74 68 65 20 62 53 70 61 6e 49 73 54 61 ** the bSpanIsTa
14950 62 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 b flag is set, t
14960 68 65 6e 20 7a 53 70 61 6e 20 69 73 20 6f 76 65 hen zSpan is ove
14970 72 6c 6f 61 64 65 64 20 74 6f 20 6d 65 61 6e 20 rloaded to mean
14980 74 68 65 20 6e 61 6d 65 0a 2a 2a 20 6f 66 20 74 the name.** of t
14990 68 65 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e he result column
149a0 20 69 6e 20 74 68 65 20 66 6f 72 6d 3a 20 44 41 in the form: DA
149b0 54 41 42 41 53 45 2e 54 41 42 4c 45 2e 43 4f 4c TABASE.TABLE.COL
149c0 55 4d 4e 2e 20 20 54 68 69 73 20 6c 61 74 65 72 UMN. This later
149d0 0a 2a 2a 20 66 6f 72 6d 20 69 73 20 75 73 65 64 .** form is used
149e0 20 66 6f 72 20 6e 61 6d 65 20 72 65 73 6f 6c 75 for name resolu
149f0 74 69 6f 6e 20 77 69 74 68 20 6e 65 73 74 65 64 tion with nested
14a00 20 46 52 4f 4d 20 63 6c 61 75 73 65 73 2e 0a 2a FROM clauses..*
14a10 2f 0a 73 74 72 75 63 74 20 45 78 70 72 4c 69 73 /.struct ExprLis
14a20 74 20 7b 0a 20 20 69 6e 74 20 6e 45 78 70 72 3b t {. int nExpr;
14a30 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
14a40 4e 75 6d 62 65 72 20 6f 66 20 65 78 70 72 65 73 Number of expres
14a50 73 69 6f 6e 73 20 6f 6e 20 74 68 65 20 6c 69 73 sions on the lis
14a60 74 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 45 78 t */. struct Ex
14a70 70 72 4c 69 73 74 5f 69 74 65 6d 20 7b 20 2f 2a prList_item { /*
14a80 20 46 6f 72 20 65 61 63 68 20 65 78 70 72 65 73 For each expres
14a90 73 69 6f 6e 20 69 6e 20 74 68 65 20 6c 69 73 74 sion in the list
14aa0 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45 */. Expr *pE
14ab0 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 xpr;
14ac0 2f 2a 20 54 68 65 20 6c 69 73 74 20 6f 66 20 65 /* The list of e
14ad0 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 xpressions */.
14ae0 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 char *zName;
14af0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 6f 6b /* Tok
14b00 65 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 en associated wi
14b10 74 68 20 74 68 69 73 20 65 78 70 72 65 73 73 69 th this expressi
14b20 6f 6e 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a on */. char *
14b30 7a 53 70 61 6e 3b 20 20 20 20 20 20 20 20 20 20 zSpan;
14b40 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 74 65 /* Original te
14b50 78 74 20 6f 66 20 74 68 65 20 65 78 70 72 65 73 xt of the expres
14b60 73 69 6f 6e 20 2a 2f 0a 20 20 20 20 75 38 20 73 sion */. u8 s
14b70 6f 72 74 4f 72 64 65 72 3b 20 20 20 20 20 20 20 ortOrder;
14b80 20 20 20 20 2f 2a 20 31 20 66 6f 72 20 44 45 53 /* 1 for DES
14b90 43 20 6f 72 20 30 20 66 6f 72 20 41 53 43 20 2a C or 0 for ASC *
14ba0 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 64 /. unsigned d
14bb0 6f 6e 65 20 3a 31 3b 20 20 20 20 20 20 20 2f 2a one :1; /*
14bc0 20 41 20 66 6c 61 67 20 74 6f 20 69 6e 64 69 63 A flag to indic
14bd0 61 74 65 20 77 68 65 6e 20 70 72 6f 63 65 73 73 ate when process
14be0 69 6e 67 20 69 73 20 66 69 6e 69 73 68 65 64 20 ing is finished
14bf0 2a 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 */. unsigned
14c00 62 53 70 61 6e 49 73 54 61 62 20 3a 31 3b 20 2f bSpanIsTab :1; /
14c10 2a 20 7a 53 70 61 6e 20 68 6f 6c 64 73 20 44 42 * zSpan holds DB
14c20 2e 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 20 2a 2f .TABLE.COLUMN */
14c30 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 72 65 . unsigned re
14c40 75 73 61 62 6c 65 20 3a 31 3b 20 20 20 2f 2a 20 usable :1; /*
14c50 43 6f 6e 73 74 61 6e 74 20 65 78 70 72 65 73 73 Constant express
14c60 69 6f 6e 20 69 73 20 72 65 75 73 61 62 6c 65 20 ion is reusable
14c70 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 20 7b 0a 20 */. union {.
14c80 20 20 20 20 20 73 74 72 75 63 74 20 7b 0a 20 20 struct {.
14c90 20 20 20 20 20 20 75 31 36 20 69 4f 72 64 65 72 u16 iOrder
14ca0 42 79 43 6f 6c 3b 20 20 20 20 20 20 2f 2a 20 46 ByCol; /* F
14cb0 6f 72 20 4f 52 44 45 52 20 42 59 2c 20 63 6f 6c or ORDER BY, col
14cc0 75 6d 6e 20 6e 75 6d 62 65 72 20 69 6e 20 72 65 umn number in re
14cd0 73 75 6c 74 20 73 65 74 20 2a 2f 0a 20 20 20 20 sult set */.
14ce0 20 20 20 20 75 31 36 20 69 41 6c 69 61 73 3b 20 u16 iAlias;
14cf0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 /* Ind
14d00 65 78 20 69 6e 74 6f 20 50 61 72 73 65 2e 61 41 ex into Parse.aA
14d10 6c 69 61 73 5b 5d 20 66 6f 72 20 7a 4e 61 6d 65 lias[] for zName
14d20 20 2a 2f 0a 20 20 20 20 20 20 7d 20 78 3b 0a 20 */. } x;.
14d30 20 20 20 20 20 69 6e 74 20 69 43 6f 6e 73 74 45 int iConstE
14d40 78 70 72 52 65 67 3b 20 20 20 20 20 20 2f 2a 20 xprReg; /*
14d50 52 65 67 69 73 74 65 72 20 69 6e 20 77 68 69 63 Register in whic
14d60 68 20 45 78 70 72 20 76 61 6c 75 65 20 69 73 20 h Expr value is
14d70 63 61 63 68 65 64 20 2a 2f 0a 20 20 20 20 7d 20 cached */. }
14d80 75 3b 0a 20 20 7d 20 2a 61 3b 20 20 20 20 20 20 u;. } *a;
14d90 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
14da0 6c 6c 6f 63 20 61 20 70 6f 77 65 72 20 6f 66 20 lloc a power of
14db0 74 77 6f 20 67 72 65 61 74 65 72 20 6f 72 20 65 two greater or e
14dc0 71 75 61 6c 20 74 6f 20 6e 45 78 70 72 20 2a 2f qual to nExpr */
14dd0 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e .};../*.** An in
14de0 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 73 stance of this s
14df0 74 72 75 63 74 75 72 65 20 69 73 20 75 73 65 64 tructure is used
14e00 20 62 79 20 74 68 65 20 70 61 72 73 65 72 20 74 by the parser t
14e10 6f 20 72 65 63 6f 72 64 20 62 6f 74 68 0a 2a 2a o record both.**
14e20 20 74 68 65 20 70 61 72 73 65 20 74 72 65 65 20 the parse tree
14e30 66 6f 72 20 61 6e 20 65 78 70 72 65 73 73 69 6f for an expressio
14e40 6e 20 61 6e 64 20 74 68 65 20 73 70 61 6e 20 6f n and the span o
14e50 66 20 69 6e 70 75 74 20 74 65 78 74 20 66 6f 72 f input text for
14e60 20 61 6e 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f an.** expressio
14e70 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 45 78 70 n..*/.struct Exp
14e80 72 53 70 61 6e 20 7b 0a 20 20 45 78 70 72 20 2a rSpan {. Expr *
14e90 70 45 78 70 72 3b 20 20 20 20 20 20 20 20 20 20 pExpr;
14ea0 2f 2a 20 54 68 65 20 65 78 70 72 65 73 73 69 6f /* The expressio
14eb0 6e 20 70 61 72 73 65 20 74 72 65 65 20 2a 2f 0a n parse tree */.
14ec0 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 const char *zS
14ed0 74 61 72 74 3b 20 20 20 2f 2a 20 46 69 72 73 74 tart; /* First
14ee0 20 63 68 61 72 61 63 74 65 72 20 6f 66 20 69 6e character of in
14ef0 70 75 74 20 74 65 78 74 20 2a 2f 0a 20 20 63 6f put text */. co
14f00 6e 73 74 20 63 68 61 72 20 2a 7a 45 6e 64 3b 20 nst char *zEnd;
14f10 20 20 20 20 2f 2a 20 4f 6e 65 20 63 68 61 72 61 /* One chara
14f20 63 74 65 72 20 70 61 73 74 20 74 68 65 20 65 6e cter past the en
14f30 64 20 6f 66 20 69 6e 70 75 74 20 74 65 78 74 20 d of input text
14f40 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 */.};../*.** An
14f50 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 instance of this
14f60 20 73 74 72 75 63 74 75 72 65 20 63 61 6e 20 68 structure can h
14f70 6f 6c 64 20 61 20 73 69 6d 70 6c 65 20 6c 69 73 old a simple lis
14f80 74 20 6f 66 20 69 64 65 6e 74 69 66 69 65 72 73 t of identifiers
14f90 2c 0a 2a 2a 20 73 75 63 68 20 61 73 20 74 68 65 ,.** such as the
14fa0 20 6c 69 73 74 20 22 61 2c 62 2c 63 22 20 69 6e list "a,b,c" in
14fb0 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 the following s
14fc0 74 61 74 65 6d 65 6e 74 73 3a 0a 2a 2a 0a 2a 2a tatements:.**.**
14fd0 20 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 INSERT INT
14fe0 4f 20 74 28 61 2c 62 2c 63 29 20 56 41 4c 55 45 O t(a,b,c) VALUE
14ff0 53 20 2e 2e 2e 3b 0a 2a 2a 20 20 20 20 20 20 43 S ...;.** C
15000 52 45 41 54 45 20 49 4e 44 45 58 20 69 64 78 20 REATE INDEX idx
15010 4f 4e 20 74 28 61 2c 62 2c 63 29 3b 0a 2a 2a 20 ON t(a,b,c);.**
15020 20 20 20 20 20 43 52 45 41 54 45 20 54 52 49 47 CREATE TRIG
15030 47 45 52 20 74 72 69 67 20 42 45 46 4f 52 45 20 GER trig BEFORE
15040 55 50 44 41 54 45 20 4f 4e 20 74 28 61 2c 62 2c UPDATE ON t(a,b,
15050 63 29 20 2e 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 68 c) ...;.**.** Th
15060 65 20 49 64 4c 69 73 74 2e 61 2e 69 64 78 20 66 e IdList.a.idx f
15070 69 65 6c 64 20 69 73 20 75 73 65 64 20 77 68 65 ield is used whe
15080 6e 20 74 68 65 20 49 64 4c 69 73 74 20 72 65 70 n the IdList rep
15090 72 65 73 65 6e 74 73 20 74 68 65 20 6c 69 73 74 resents the list
150a0 20 6f 66 0a 2a 2a 20 63 6f 6c 75 6d 6e 20 6e 61 of.** column na
150b0 6d 65 73 20 61 66 74 65 72 20 61 20 74 61 62 6c mes after a tabl
150c0 65 20 6e 61 6d 65 20 69 6e 20 61 6e 20 49 4e 53 e name in an INS
150d0 45 52 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 ERT statement.
150e0 49 6e 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 In the statement
150f0 0a 2a 2a 0a 2a 2a 20 20 20 20 20 49 4e 53 45 52 .**.** INSER
15100 54 20 49 4e 54 4f 20 74 28 61 2c 62 2c 63 29 20 T INTO t(a,b,c)
15110 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 22 61 22 ....**.** If "a"
15120 20 69 73 20 74 68 65 20 6b 2d 74 68 20 63 6f 6c is the k-th col
15130 75 6d 6e 20 6f 66 20 74 61 62 6c 65 20 22 74 22 umn of table "t"
15140 2c 20 74 68 65 6e 20 49 64 4c 69 73 74 2e 61 5b , then IdList.a[
15150 30 5d 2e 69 64 78 3d 3d 6b 2e 0a 2a 2f 0a 73 74 0].idx==k..*/.st
15160 72 75 63 74 20 49 64 4c 69 73 74 20 7b 0a 20 20 ruct IdList {.
15170 73 74 72 75 63 74 20 49 64 4c 69 73 74 5f 69 74 struct IdList_it
15180 65 6d 20 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a em {. char *z
15190 4e 61 6d 65 3b 20 20 20 20 20 20 2f 2a 20 4e 61 Name; /* Na
151a0 6d 65 20 6f 66 20 74 68 65 20 69 64 65 6e 74 69 me of the identi
151b0 66 69 65 72 20 2a 2f 0a 20 20 20 20 69 6e 74 20 fier */. int
151c0 69 64 78 3b 20 20 20 20 20 20 20 20 20 20 2f 2a idx; /*
151d0 20 49 6e 64 65 78 20 69 6e 20 73 6f 6d 65 20 54 Index in some T
151e0 61 62 6c 65 2e 61 43 6f 6c 5b 5d 20 6f 66 20 61 able.aCol[] of a
151f0 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 64 20 7a 4e column named zN
15200 61 6d 65 20 2a 2f 0a 20 20 7d 20 2a 61 3b 0a 20 ame */. } *a;.
15210 20 69 6e 74 20 6e 49 64 3b 20 20 20 20 20 20 20 int nId;
15220 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 69 /* Number of i
15230 64 65 6e 74 69 66 69 65 72 73 20 6f 6e 20 74 68 dentifiers on th
15240 65 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a e list */.};../*
15250 0a 2a 2a 20 54 68 65 20 62 69 74 6d 61 73 6b 20 .** The bitmask
15260 64 61 74 61 74 79 70 65 20 64 65 66 69 6e 65 64 datatype defined
15270 20 62 65 6c 6f 77 20 69 73 20 75 73 65 64 20 66 below is used f
15280 6f 72 20 76 61 72 69 6f 75 73 20 6f 70 74 69 6d or various optim
15290 69 7a 61 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 izations..**.**
152a0 43 68 61 6e 67 69 6e 67 20 74 68 69 73 20 66 72 Changing this fr
152b0 6f 6d 20 61 20 36 34 2d 62 69 74 20 74 6f 20 61 om a 64-bit to a
152c0 20 33 32 2d 62 69 74 20 74 79 70 65 20 6c 69 6d 32-bit type lim
152d0 69 74 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f its the number o
152e0 66 0a 2a 2a 20 74 61 62 6c 65 73 20 69 6e 20 61 f.** tables in a
152f0 20 6a 6f 69 6e 20 74 6f 20 33 32 20 69 6e 73 74 join to 32 inst
15300 65 61 64 20 6f 66 20 36 34 2e 20 20 42 75 74 20 ead of 64. But
15310 69 74 20 61 6c 73 6f 20 72 65 64 75 63 65 73 20 it also reduces
15320 74 68 65 20 73 69 7a 65 0a 2a 2a 20 6f 66 20 74 the size.** of t
15330 68 65 20 6c 69 62 72 61 72 79 20 62 79 20 37 33 he library by 73
15340 38 20 62 79 74 65 73 20 6f 6e 20 69 78 38 36 2e 8 bytes on ix86.
15350 0a 2a 2f 0a 74 79 70 65 64 65 66 20 75 36 34 20 .*/.typedef u64
15360 42 69 74 6d 61 73 6b 3b 0a 0a 2f 2a 0a 2a 2a 20 Bitmask;../*.**
15370 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 69 The number of bi
15380 74 73 20 69 6e 20 61 20 42 69 74 6d 61 73 6b 2e ts in a Bitmask.
15390 20 20 22 42 4d 53 22 20 6d 65 61 6e 73 20 22 42 "BMS" means "B
153a0 69 74 4d 61 73 6b 20 53 69 7a 65 22 2e 0a 2a 2f itMask Size"..*/
153b0 0a 23 64 65 66 69 6e 65 20 42 4d 53 20 20 28 28 .#define BMS ((
153c0 69 6e 74 29 28 73 69 7a 65 6f 66 28 42 69 74 6d int)(sizeof(Bitm
153d0 61 73 6b 29 2a 38 29 29 0a 0a 2f 2a 0a 2a 2a 20 ask)*8))../*.**
153e0 41 20 62 69 74 20 69 6e 20 61 20 42 69 74 6d 61 A bit in a Bitma
153f0 73 6b 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 41 sk.*/.#define MA
15400 53 4b 42 49 54 28 6e 29 20 20 20 28 28 28 42 69 SKBIT(n) (((Bi
15410 74 6d 61 73 6b 29 31 29 3c 3c 28 6e 29 29 0a 23 tmask)1)<<(n)).#
15420 64 65 66 69 6e 65 20 4d 41 53 4b 42 49 54 33 32 define MASKBIT32
15430 28 6e 29 20 28 28 28 75 6e 73 69 67 6e 65 64 20 (n) (((unsigned
15440 69 6e 74 29 31 29 3c 3c 28 6e 29 29 0a 0a 2f 2a int)1)<<(n))../*
15450 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
15460 67 20 73 74 72 75 63 74 75 72 65 20 64 65 73 63 g structure desc
15470 72 69 62 65 73 20 74 68 65 20 46 52 4f 4d 20 63 ribes the FROM c
15480 6c 61 75 73 65 20 6f 66 20 61 20 53 45 4c 45 43 lause of a SELEC
15490 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 T statement..**
154a0 45 61 63 68 20 74 61 62 6c 65 20 6f 72 20 73 75 Each table or su
154b0 62 71 75 65 72 79 20 69 6e 20 74 68 65 20 46 52 bquery in the FR
154c0 4f 4d 20 63 6c 61 75 73 65 20 69 73 20 61 20 73 OM clause is a s
154d0 65 70 61 72 61 74 65 20 65 6c 65 6d 65 6e 74 20 eparate element
154e0 6f 66 0a 2a 2a 20 74 68 65 20 53 72 63 4c 69 73 of.** the SrcLis
154f0 74 2e 61 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a t.a[] array..**.
15500 2a 2a 20 57 69 74 68 20 74 68 65 20 61 64 64 69 ** With the addi
15510 74 69 6f 6e 20 6f 66 20 6d 75 6c 74 69 70 6c 65 tion of multiple
15520 20 64 61 74 61 62 61 73 65 20 73 75 70 70 6f 72 database suppor
15530 74 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 t, the following
15540 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 63 61 structure.** ca
15550 6e 20 61 6c 73 6f 20 62 65 20 75 73 65 64 20 74 n also be used t
15560 6f 20 64 65 73 63 72 69 62 65 20 61 20 70 61 72 o describe a par
15570 74 69 63 75 6c 61 72 20 74 61 62 6c 65 20 73 75 ticular table su
15580 63 68 20 61 73 20 74 68 65 20 74 61 62 6c 65 20 ch as the table
15590 74 68 61 74 0a 2a 2a 20 69 73 20 6d 6f 64 69 66 that.** is modif
155a0 69 65 64 20 62 79 20 61 6e 20 49 4e 53 45 52 54 ied by an INSERT
155b0 2c 20 44 45 4c 45 54 45 2c 20 6f 72 20 55 50 44 , DELETE, or UPD
155c0 41 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 20 20 ATE statement.
155d0 49 6e 20 73 74 61 6e 64 61 72 64 20 53 51 4c 2c In standard SQL,
155e0 0a 2a 2a 20 73 75 63 68 20 61 20 74 61 62 6c 65 .** such a table
155f0 20 6d 75 73 74 20 62 65 20 61 20 73 69 6d 70 6c must be a simpl
15600 65 20 6e 61 6d 65 3a 20 49 44 2e 20 20 42 75 74 e name: ID. But
15610 20 69 6e 20 53 51 4c 69 74 65 2c 20 74 68 65 20 in SQLite, the
15620 74 61 62 6c 65 20 63 61 6e 0a 2a 2a 20 6e 6f 77 table can.** now
15630 20 62 65 20 69 64 65 6e 74 69 66 69 65 64 20 62 be identified b
15640 79 20 61 20 64 61 74 61 62 61 73 65 20 6e 61 6d y a database nam
15650 65 2c 20 61 20 64 6f 74 2c 20 74 68 65 6e 20 74 e, a dot, then t
15660 68 65 20 74 61 62 6c 65 20 6e 61 6d 65 3a 20 49 he table name: I
15670 44 2e 49 44 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 D.ID..**.** The
15680 6a 6f 69 6e 74 79 70 65 20 73 74 61 72 74 73 20 jointype starts
15690 6f 75 74 20 73 68 6f 77 69 6e 67 20 74 68 65 20 out showing the
156a0 6a 6f 69 6e 20 74 79 70 65 20 62 65 74 77 65 65 join type betwee
156b0 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 n the current ta
156c0 62 6c 65 0a 2a 2a 20 61 6e 64 20 74 68 65 20 6e ble.** and the n
156d0 65 78 74 20 74 61 62 6c 65 20 6f 6e 20 74 68 65 ext table on the
156e0 20 6c 69 73 74 2e 20 20 54 68 65 20 70 61 72 73 list. The pars
156f0 65 72 20 62 75 69 6c 64 73 20 74 68 65 20 6c 69 er builds the li
15700 73 74 20 74 68 69 73 20 77 61 79 2e 0a 2a 2a 20 st this way..**
15710 42 75 74 20 73 71 6c 69 74 65 33 53 72 63 4c 69 But sqlite3SrcLi
15720 73 74 53 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 stShiftJoinType(
15730 29 20 6c 61 74 65 72 20 73 68 69 66 74 73 20 74 ) later shifts t
15740 68 65 20 6a 6f 69 6e 74 79 70 65 73 20 73 6f 20 he jointypes so
15750 74 68 61 74 20 65 61 63 68 0a 2a 2a 20 6a 6f 69 that each.** joi
15760 6e 74 79 70 65 20 65 78 70 72 65 73 73 65 73 20 ntype expresses
15770 74 68 65 20 6a 6f 69 6e 20 62 65 74 77 65 65 6e the join between
15780 20 74 68 65 20 74 61 62 6c 65 20 61 6e 64 20 74 the table and t
15790 68 65 20 70 72 65 76 69 6f 75 73 20 74 61 62 6c he previous tabl
157a0 65 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 74 68 65 20 e..**.** In the
157b0 63 6f 6c 55 73 65 64 20 66 69 65 6c 64 2c 20 74 colUsed field, t
157c0 68 65 20 68 69 67 68 2d 6f 72 64 65 72 20 62 69 he high-order bi
157d0 74 20 28 62 69 74 20 36 33 29 20 69 73 20 73 65 t (bit 63) is se
157e0 74 20 69 66 20 74 68 65 20 74 61 62 6c 65 0a 2a t if the table.*
157f0 2a 20 63 6f 6e 74 61 69 6e 73 20 6d 6f 72 65 20 * contains more
15800 74 68 61 6e 20 36 33 20 63 6f 6c 75 6d 6e 73 20 than 63 columns
15810 61 6e 64 20 74 68 65 20 36 34 2d 74 68 20 6f 72 and the 64-th or
15820 20 6c 61 74 65 72 20 63 6f 6c 75 6d 6e 20 69 73 later column is
15830 20 75 73 65 64 2e 0a 2a 2f 0a 73 74 72 75 63 74 used..*/.struct
15840 20 53 72 63 4c 69 73 74 20 7b 0a 20 20 69 6e 74 SrcList {. int
15850 20 6e 53 72 63 3b 20 20 20 20 20 20 20 20 2f 2a nSrc; /*
15860 20 4e 75 6d 62 65 72 20 6f 66 20 74 61 62 6c 65 Number of table
15870 73 20 6f 72 20 73 75 62 71 75 65 72 69 65 73 20 s or subqueries
15880 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 in the FROM clau
15890 73 65 20 2a 2f 0a 20 20 75 33 32 20 6e 41 6c 6c se */. u32 nAll
158a0 6f 63 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 oc; /* Numb
158b0 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 61 6c er of entries al
158c0 6c 6f 63 61 74 65 64 20 69 6e 20 61 5b 5d 20 62 located in a[] b
158d0 65 6c 6f 77 20 2a 2f 0a 20 20 73 74 72 75 63 74 elow */. struct
158e0 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 7b 0a SrcList_item {.
158f0 20 20 20 20 53 63 68 65 6d 61 20 2a 70 53 63 68 Schema *pSch
15900 65 6d 61 3b 20 20 2f 2a 20 53 63 68 65 6d 61 20 ema; /* Schema
15910 74 6f 20 77 68 69 63 68 20 74 68 69 73 20 69 74 to which this it
15920 65 6d 20 69 73 20 66 69 78 65 64 20 2a 2f 0a 20 em is fixed */.
15930 20 20 20 63 68 61 72 20 2a 7a 44 61 74 61 62 61 char *zDataba
15940 73 65 3b 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 se; /* Name of
15950 64 61 74 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 database holding
15960 20 74 68 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 this table */.
15970 20 20 20 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 char *zName;
15980 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 /* Name of
15990 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 the table */.
159a0 20 63 68 61 72 20 2a 7a 41 6c 69 61 73 3b 20 20 char *zAlias;
159b0 20 20 20 2f 2a 20 54 68 65 20 22 42 22 20 70 61 /* The "B" pa
159c0 72 74 20 6f 66 20 61 20 22 41 20 41 53 20 42 22 rt of a "A AS B"
159d0 20 70 68 72 61 73 65 2e 20 20 7a 4e 61 6d 65 20 phrase. zName
159e0 69 73 20 74 68 65 20 22 41 22 20 2a 2f 0a 20 20 is the "A" */.
159f0 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 Table *pTab;
15a00 20 20 20 20 2f 2a 20 41 6e 20 53 51 4c 20 74 61 /* An SQL ta
15a10 62 6c 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e ble correspondin
15a20 67 20 74 6f 20 7a 4e 61 6d 65 20 2a 2f 0a 20 20 g to zName */.
15a30 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c 65 63 Select *pSelec
15a40 74 3b 20 20 2f 2a 20 41 20 53 45 4c 45 43 54 20 t; /* A SELECT
15a50 73 74 61 74 65 6d 65 6e 74 20 75 73 65 64 20 69 statement used i
15a60 6e 20 70 6c 61 63 65 20 6f 66 20 61 20 74 61 62 n place of a tab
15a70 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 69 le name */. i
15a80 6e 74 20 61 64 64 72 46 69 6c 6c 53 75 62 3b 20 nt addrFillSub;
15a90 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 73 /* Address of s
15aa0 75 62 72 6f 75 74 69 6e 65 20 74 6f 20 6d 61 6e ubroutine to man
15ab0 69 66 65 73 74 20 61 20 73 75 62 71 75 65 72 79 ifest a subquery
15ac0 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 52 */. int regR
15ad0 65 74 75 72 6e 3b 20 20 20 20 2f 2a 20 52 65 67 eturn; /* Reg
15ae0 69 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 65 ister holding re
15af0 74 75 72 6e 20 61 64 64 72 65 73 73 20 6f 66 20 turn address of
15b00 61 64 64 72 46 69 6c 6c 53 75 62 20 2a 2f 0a 20 addrFillSub */.
15b10 20 20 20 69 6e 74 20 72 65 67 52 65 73 75 6c 74 int regResult
15b20 3b 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 ; /* Register
15b30 73 20 68 6f 6c 64 69 6e 67 20 72 65 73 75 6c 74 s holding result
15b40 73 20 6f 66 20 61 20 63 6f 2d 72 6f 75 74 69 6e s of a co-routin
15b50 65 20 2a 2f 0a 20 20 20 20 75 38 20 6a 6f 69 6e e */. u8 join
15b60 74 79 70 65 3b 20 20 20 20 20 20 2f 2a 20 54 79 type; /* Ty
15b70 70 65 20 6f 66 20 6a 6f 69 6e 20 62 65 74 77 65 pe of join betwe
15b80 65 6e 20 74 68 69 73 20 61 62 6c 65 20 61 6e 64 en this able and
15b90 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 2a 2f the previous */
15ba0 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 6e 6f . unsigned no
15bb0 74 49 6e 64 65 78 65 64 20 3a 31 3b 20 20 20 20 tIndexed :1;
15bc0 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 72 65 /* True if there
15bd0 20 69 73 20 61 20 4e 4f 54 20 49 4e 44 45 58 45 is a NOT INDEXE
15be0 44 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 D clause */.
15bf0 75 6e 73 69 67 6e 65 64 20 69 73 43 6f 72 72 65 unsigned isCorre
15c00 6c 61 74 65 64 20 3a 31 3b 20 20 2f 2a 20 54 72 lated :1; /* Tr
15c10 75 65 20 69 66 20 73 75 62 2d 71 75 65 72 79 20 ue if sub-query
15c20 69 73 20 63 6f 72 72 65 6c 61 74 65 64 20 2a 2f is correlated */
15c30 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 76 69 . unsigned vi
15c40 61 43 6f 72 6f 75 74 69 6e 65 20 3a 31 3b 20 20 aCoroutine :1;
15c50 2f 2a 20 49 6d 70 6c 65 6d 65 6e 74 65 64 20 61 /* Implemented a
15c60 73 20 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 2a s a co-routine *
15c70 2f 0a 20 20 20 20 75 6e 73 69 67 6e 65 64 20 69 /. unsigned i
15c80 73 52 65 63 75 72 73 69 76 65 20 3a 31 3b 20 20 sRecursive :1;
15c90 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 72 65 63 /* True for rec
15ca0 75 72 73 69 76 65 20 72 65 66 65 72 65 6e 63 65 ursive reference
15cb0 20 69 6e 20 57 49 54 48 20 2a 2f 0a 23 69 66 6e in WITH */.#ifn
15cc0 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
15cd0 45 58 50 4c 41 49 4e 0a 20 20 20 20 75 38 20 69 EXPLAIN. u8 i
15ce0 53 65 6c 65 63 74 49 64 3b 20 20 20 20 20 2f 2a SelectId; /*
15cf0 20 49 66 20 70 53 65 6c 65 63 74 21 3d 30 2c 20 If pSelect!=0,
15d00 74 68 65 20 69 64 20 6f 66 20 74 68 65 20 73 75 the id of the su
15d10 62 2d 73 65 6c 65 63 74 20 69 6e 20 45 51 50 20 b-select in EQP
15d20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 6e */.#endif. in
15d30 74 20 69 43 75 72 73 6f 72 3b 20 20 20 20 20 20 t iCursor;
15d40 2f 2a 20 54 68 65 20 56 44 42 45 20 63 75 72 73 /* The VDBE curs
15d50 6f 72 20 6e 75 6d 62 65 72 20 75 73 65 64 20 74 or number used t
15d60 6f 20 61 63 63 65 73 73 20 74 68 69 73 20 74 61 o access this ta
15d70 62 6c 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 ble */. Expr
15d80 2a 70 4f 6e 3b 20 20 20 20 20 20 20 20 2f 2a 20 *pOn; /*
15d90 54 68 65 20 4f 4e 20 63 6c 61 75 73 65 20 6f 66 The ON clause of
15da0 20 61 20 6a 6f 69 6e 20 2a 2f 0a 20 20 20 20 49 a join */. I
15db0 64 4c 69 73 74 20 2a 70 55 73 69 6e 67 3b 20 20 dList *pUsing;
15dc0 20 2f 2a 20 54 68 65 20 55 53 49 4e 47 20 63 6c /* The USING cl
15dd0 61 75 73 65 20 6f 66 20 61 20 6a 6f 69 6e 20 2a ause of a join *
15de0 2f 0a 20 20 20 20 42 69 74 6d 61 73 6b 20 63 6f /. Bitmask co
15df0 6c 55 73 65 64 3b 20 20 2f 2a 20 42 69 74 20 4e lUsed; /* Bit N
15e00 20 28 31 3c 3c 4e 29 20 73 65 74 20 69 66 20 63 (1<<N) set if c
15e10 6f 6c 75 6d 6e 20 4e 20 6f 66 20 70 54 61 62 20 olumn N of pTab
15e20 69 73 20 75 73 65 64 20 2a 2f 0a 20 20 20 20 63 is used */. c
15e30 68 61 72 20 2a 7a 49 6e 64 65 78 3b 20 20 20 20 har *zIndex;
15e40 20 2f 2a 20 49 64 65 6e 74 69 66 69 65 72 20 66 /* Identifier f
15e50 72 6f 6d 20 22 49 4e 44 45 58 45 44 20 42 59 20 rom "INDEXED BY
15e60 3c 7a 49 6e 64 65 78 3e 22 20 63 6c 61 75 73 65 <zIndex>" clause
15e70 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 */. Index *p
15e80 49 6e 64 65 78 3b 20 20 20 20 2f 2a 20 49 6e 64 Index; /* Ind
15e90 65 78 20 73 74 72 75 63 74 75 72 65 20 63 6f 72 ex structure cor
15ea0 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 7a 49 responding to zI
15eb0 6e 64 65 78 2c 20 69 66 20 61 6e 79 20 2a 2f 0a ndex, if any */.
15ec0 20 20 7d 20 61 5b 31 5d 3b 20 20 20 20 20 20 20 } a[1];
15ed0 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6e 74 /* One ent
15ee0 72 79 20 66 6f 72 20 65 61 63 68 20 69 64 65 6e ry for each iden
15ef0 74 69 66 69 65 72 20 6f 6e 20 74 68 65 20 6c 69 tifier on the li
15f00 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 st */.};../*.**
15f10 50 65 72 6d 69 74 74 65 64 20 76 61 6c 75 65 73 Permitted values
15f20 20 6f 66 20 74 68 65 20 53 72 63 4c 69 73 74 2e of the SrcList.
15f30 61 2e 6a 6f 69 6e 74 79 70 65 20 66 69 65 6c 64 a.jointype field
15f40 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 49 .*/.#define JT_I
15f50 4e 4e 45 52 20 20 20 20 20 30 78 30 30 30 31 20 NNER 0x0001
15f60 20 20 20 2f 2a 20 41 6e 79 20 6b 69 6e 64 20 6f /* Any kind o
15f70 66 20 69 6e 6e 65 72 20 6f 72 20 63 72 6f 73 73 f inner or cross
15f80 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 join */.#define
15f90 20 4a 54 5f 43 52 4f 53 53 20 20 20 20 20 30 78 JT_CROSS 0x
15fa0 30 30 30 32 20 20 20 20 2f 2a 20 45 78 70 6c 69 0002 /* Expli
15fb0 63 69 74 20 75 73 65 20 6f 66 20 74 68 65 20 43 cit use of the C
15fc0 52 4f 53 53 20 6b 65 79 77 6f 72 64 20 2a 2f 0a ROSS keyword */.
15fd0 23 64 65 66 69 6e 65 20 4a 54 5f 4e 41 54 55 52 #define JT_NATUR
15fe0 41 4c 20 20 20 30 78 30 30 30 34 20 20 20 20 2f AL 0x0004 /
15ff0 2a 20 54 72 75 65 20 66 6f 72 20 61 20 22 6e 61 * True for a "na
16000 74 75 72 61 6c 22 20 6a 6f 69 6e 20 2a 2f 0a 23 tural" join */.#
16010 64 65 66 69 6e 65 20 4a 54 5f 4c 45 46 54 20 20 define JT_LEFT
16020 20 20 20 20 30 78 30 30 30 38 20 20 20 20 2f 2a 0x0008 /*
16030 20 4c 65 66 74 20 6f 75 74 65 72 20 6a 6f 69 6e Left outer join
16040 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4a 54 5f 52 */.#define JT_R
16050 49 47 48 54 20 20 20 20 20 30 78 30 30 31 30 20 IGHT 0x0010
16060 20 20 20 2f 2a 20 52 69 67 68 74 20 6f 75 74 65 /* Right oute
16070 72 20 6a 6f 69 6e 20 2a 2f 0a 23 64 65 66 69 6e r join */.#defin
16080 65 20 4a 54 5f 4f 55 54 45 52 20 20 20 20 20 30 e JT_OUTER 0
16090 78 30 30 32 30 20 20 20 20 2f 2a 20 54 68 65 20 x0020 /* The
160a0 22 4f 55 54 45 52 22 20 6b 65 79 77 6f 72 64 20 "OUTER" keyword
160b0 69 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 23 64 is present */.#d
160c0 65 66 69 6e 65 20 4a 54 5f 45 52 52 4f 52 20 20 efine JT_ERROR
160d0 20 20 20 30 78 30 30 34 30 20 20 20 20 2f 2a 20 0x0040 /*
160e0 75 6e 6b 6e 6f 77 6e 20 6f 72 20 75 6e 73 75 70 unknown or unsup
160f0 70 6f 72 74 65 64 20 6a 6f 69 6e 20 74 79 70 65 ported join type
16100 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 46 6c 61 67 */.../*.** Flag
16110 73 20 61 70 70 72 6f 70 72 69 61 74 65 20 66 6f s appropriate fo
16120 72 20 74 68 65 20 77 63 74 72 6c 46 6c 61 67 73 r the wctrlFlags
16130 20 70 61 72 61 6d 65 74 65 72 20 6f 66 20 73 71 parameter of sq
16140 6c 69 74 65 33 57 68 65 72 65 42 65 67 69 6e 28 lite3WhereBegin(
16150 29 0a 2a 2a 20 61 6e 64 20 74 68 65 20 57 68 65 ).** and the Whe
16160 72 65 49 6e 66 6f 2e 77 63 74 72 6c 46 6c 61 67 reInfo.wctrlFlag
16170 73 20 6d 65 6d 62 65 72 2e 0a 2a 2f 0a 23 64 65 s member..*/.#de
16180 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 45 52 fine WHERE_ORDER
16190 42 59 5f 4e 4f 52 4d 41 4c 20 20 20 30 78 30 30 BY_NORMAL 0x00
161a0 30 30 20 2f 2a 20 4e 6f 2d 6f 70 20 2a 2f 0a 23 00 /* No-op */.#
161b0 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 define WHERE_ORD
161c0 45 52 42 59 5f 4d 49 4e 20 20 20 20 20 20 30 78 ERBY_MIN 0x
161d0 30 30 30 31 20 2f 2a 20 4f 52 44 45 52 20 42 59 0001 /* ORDER BY
161e0 20 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 processing for
161f0 6d 69 6e 28 29 20 66 75 6e 63 20 2a 2f 0a 23 64 min() func */.#d
16200 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 52 44 45 efine WHERE_ORDE
16210 52 42 59 5f 4d 41 58 20 20 20 20 20 20 30 78 30 RBY_MAX 0x0
16220 30 30 32 20 2f 2a 20 4f 52 44 45 52 20 42 59 20 002 /* ORDER BY
16230 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 6d processing for m
16240 61 78 28 29 20 66 75 6e 63 20 2a 2f 0a 23 64 65 ax() func */.#de
16250 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e 45 50 41 fine WHERE_ONEPA
16260 53 53 5f 44 45 53 49 52 45 44 20 20 30 78 30 30 SS_DESIRED 0x00
16270 30 34 20 2f 2a 20 57 61 6e 74 20 74 6f 20 64 6f 04 /* Want to do
16280 20 6f 6e 65 2d 70 61 73 73 20 55 50 44 41 54 45 one-pass UPDATE
16290 2f 44 45 4c 45 54 45 20 2a 2f 0a 23 64 65 66 69 /DELETE */.#defi
162a0 6e 65 20 57 48 45 52 45 5f 44 55 50 4c 49 43 41 ne WHERE_DUPLICA
162b0 54 45 53 5f 4f 4b 20 20 20 20 30 78 30 30 30 38 TES_OK 0x0008
162c0 20 2f 2a 20 4f 6b 20 74 6f 20 72 65 74 75 72 6e /* Ok to return
162d0 20 61 20 72 6f 77 20 6d 6f 72 65 20 74 68 61 6e a row more than
162e0 20 6f 6e 63 65 20 2a 2f 0a 23 64 65 66 69 6e 65 once */.#define
162f0 20 57 48 45 52 45 5f 4f 4d 49 54 5f 4f 50 45 4e WHERE_OMIT_OPEN
16300 5f 43 4c 4f 53 45 20 20 30 78 30 30 31 30 20 2f _CLOSE 0x0010 /
16310 2a 20 54 61 62 6c 65 20 63 75 72 73 6f 72 73 20 * Table cursors
16320 61 72 65 20 61 6c 72 65 61 64 79 20 6f 70 65 6e are already open
16330 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
16340 45 5f 46 4f 52 43 45 5f 54 41 42 4c 45 20 20 20 E_FORCE_TABLE
16350 20 20 20 30 78 30 30 32 30 20 2f 2a 20 44 6f 20 0x0020 /* Do
16360 6e 6f 74 20 75 73 65 20 61 6e 20 69 6e 64 65 78 not use an index
16370 2d 6f 6e 6c 79 20 73 65 61 72 63 68 20 2a 2f 0a -only search */.
16380 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 4f 4e #define WHERE_ON
16390 45 54 41 42 4c 45 5f 4f 4e 4c 59 20 20 20 20 30 ETABLE_ONLY 0
163a0 78 30 30 34 30 20 2f 2a 20 4f 6e 6c 79 20 63 6f x0040 /* Only co
163b0 64 65 20 74 68 65 20 31 73 74 20 74 61 62 6c 65 de the 1st table
163c0 20 69 6e 20 70 54 61 62 4c 69 73 74 20 2a 2f 0a in pTabList */.
163d0 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f 41 4e #define WHERE_AN
163e0 44 5f 4f 4e 4c 59 20 20 20 20 20 20 20 20 20 30 D_ONLY 0
163f0 78 30 30 38 30 20 2f 2a 20 44 6f 6e 27 74 20 75 x0080 /* Don't u
16400 73 65 20 69 6e 64 69 63 65 73 20 66 6f 72 20 4f se indices for O
16410 52 20 74 65 72 6d 73 20 2a 2f 0a 23 64 65 66 69 R terms */.#defi
16420 6e 65 20 57 48 45 52 45 5f 47 52 4f 55 50 42 59 ne WHERE_GROUPBY
16430 20 20 20 20 20 20 20 20 20 20 30 78 30 31 30 30 0x0100
16440 20 2f 2a 20 70 4f 72 64 65 72 42 79 20 69 73 20 /* pOrderBy is
16450 72 65 61 6c 6c 79 20 61 20 47 52 4f 55 50 20 42 really a GROUP B
16460 59 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 Y */.#define WHE
16470 52 45 5f 44 49 53 54 49 4e 43 54 42 59 20 20 20 RE_DISTINCTBY
16480 20 20 20 20 30 78 30 32 30 30 20 2f 2a 20 70 4f 0x0200 /* pO
16490 72 64 65 72 62 79 20 69 73 20 72 65 61 6c 6c 79 rderby is really
164a0 20 61 20 44 49 53 54 49 4e 43 54 20 63 6c 61 75 a DISTINCT clau
164b0 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 se */.#define WH
164c0 45 52 45 5f 57 41 4e 54 5f 44 49 53 54 49 4e 43 ERE_WANT_DISTINC
164d0 54 20 20 20 20 30 78 30 34 30 30 20 2f 2a 20 41 T 0x0400 /* A
164e0 6c 6c 20 6f 75 74 70 75 74 20 6e 65 65 64 73 20 ll output needs
164f0 74 6f 20 62 65 20 64 69 73 74 69 6e 63 74 20 2a to be distinct *
16500 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 45 5f /.#define WHERE_
16510 53 4f 52 54 42 59 47 52 4f 55 50 20 20 20 20 20 SORTBYGROUP
16520 20 30 78 30 38 30 30 20 2f 2a 20 53 75 70 70 6f 0x0800 /* Suppo
16530 72 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 rt sqlite3WhereI
16540 73 53 6f 72 74 65 64 28 29 20 2a 2f 0a 0a 2f 2a sSorted() */../*
16550 20 41 6c 6c 6f 77 65 64 20 72 65 74 75 72 6e 20 Allowed return
16560 76 61 6c 75 65 73 20 66 72 6f 6d 20 73 71 6c 69 values from sqli
16570 74 65 33 57 68 65 72 65 49 73 44 69 73 74 69 6e te3WhereIsDistin
16580 63 74 28 29 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 ct().*/.#define
16590 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 4e WHERE_DISTINCT_N
165a0 4f 4f 50 20 20 20 20 20 20 30 20 20 2f 2a 20 44 OOP 0 /* D
165b0 49 53 54 49 4e 43 54 20 6b 65 79 77 6f 72 64 20 ISTINCT keyword
165c0 6e 6f 74 20 75 73 65 64 20 2a 2f 0a 23 64 65 66 not used */.#def
165d0 69 6e 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e ine WHERE_DISTIN
165e0 43 54 5f 55 4e 49 51 55 45 20 20 20 20 31 20 20 CT_UNIQUE 1
165f0 2f 2a 20 4e 6f 20 64 75 70 6c 69 63 61 74 65 73 /* No duplicates
16600 20 2a 2f 0a 23 64 65 66 69 6e 65 20 57 48 45 52 */.#define WHER
16610 45 5f 44 49 53 54 49 4e 43 54 5f 4f 52 44 45 52 E_DISTINCT_ORDER
16620 45 44 20 20 20 32 20 20 2f 2a 20 41 6c 6c 20 64 ED 2 /* All d
16630 75 70 6c 69 63 61 74 65 73 20 61 72 65 20 61 64 uplicates are ad
16640 6a 61 63 65 6e 74 20 2a 2f 0a 23 64 65 66 69 6e jacent */.#defin
16650 65 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 e WHERE_DISTINCT
16660 5f 55 4e 4f 52 44 45 52 45 44 20 33 20 20 2f 2a _UNORDERED 3 /*
16670 20 44 75 70 6c 69 63 61 74 65 73 20 61 72 65 20 Duplicates are
16680 73 63 61 74 74 65 72 65 64 20 2a 2f 0a 0a 2f 2a scattered */../*
16690 0a 2a 2a 20 41 20 4e 61 6d 65 43 6f 6e 74 65 78 .** A NameContex
166a0 74 20 64 65 66 69 6e 65 73 20 61 20 63 6f 6e 74 t defines a cont
166b0 65 78 74 20 69 6e 20 77 68 69 63 68 20 74 6f 20 ext in which to
166c0 72 65 73 6f 6c 76 65 20 74 61 62 6c 65 20 61 6e resolve table an
166d0 64 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6e 61 6d 65 d column.** name
166e0 73 2e 20 20 54 68 65 20 63 6f 6e 74 65 78 74 20 s. The context
166f0 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 6c 69 consists of a li
16700 73 74 20 6f 66 20 74 61 62 6c 65 73 20 28 74 68 st of tables (th
16710 65 20 70 53 72 63 4c 69 73 74 29 20 66 69 65 6c e pSrcList) fiel
16720 64 20 61 6e 64 0a 2a 2a 20 61 20 6c 69 73 74 20 d and.** a list
16730 6f 66 20 6e 61 6d 65 64 20 65 78 70 72 65 73 73 of named express
16740 69 6f 6e 20 28 70 45 4c 69 73 74 29 2e 20 20 54 ion (pEList). T
16750 68 65 20 6e 61 6d 65 64 20 65 78 70 72 65 73 73 he named express
16760 69 6f 6e 20 6c 69 73 74 20 6d 61 79 0a 2a 2a 20 ion list may.**
16770 62 65 20 4e 55 4c 4c 2e 20 20 54 68 65 20 70 53 be NULL. The pS
16780 72 63 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 rc corresponds t
16790 6f 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 o the FROM claus
167a0 65 20 6f 66 20 61 20 53 45 4c 45 43 54 20 6f 72 e of a SELECT or
167b0 0a 2a 2a 20 74 6f 20 74 68 65 20 74 61 62 6c 65 .** to the table
167c0 20 62 65 69 6e 67 20 6f 70 65 72 61 74 65 64 20 being operated
167d0 6f 6e 20 62 79 20 49 4e 53 45 52 54 2c 20 55 50 on by INSERT, UP
167e0 44 41 54 45 2c 20 6f 72 20 44 45 4c 45 54 45 2e DATE, or DELETE.
167f0 20 20 54 68 65 0a 2a 2a 20 70 45 4c 69 73 74 20 The.** pEList
16800 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 corresponds to t
16810 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 6f 66 he result set of
16820 20 61 20 53 45 4c 45 43 54 20 61 6e 64 20 69 73 a SELECT and is
16830 20 4e 55 4c 4c 20 66 6f 72 0a 2a 2a 20 6f 74 68 NULL for.** oth
16840 65 72 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a er statements..*
16850 2a 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 74 *.** NameContext
16860 73 20 63 61 6e 20 62 65 20 6e 65 73 74 65 64 2e s can be nested.
16870 20 20 57 68 65 6e 20 72 65 73 6f 6c 76 69 6e 67 When resolving
16880 20 6e 61 6d 65 73 2c 20 74 68 65 20 69 6e 6e 65 names, the inne
16890 72 2d 6d 6f 73 74 20 0a 2a 2a 20 63 6f 6e 74 65 r-most .** conte
168a0 78 74 20 69 73 20 73 65 61 72 63 68 65 64 20 66 xt is searched f
168b0 69 72 73 74 2e 20 20 49 66 20 6e 6f 20 6d 61 74 irst. If no mat
168c0 63 68 20 69 73 20 66 6f 75 6e 64 2c 20 74 68 65 ch is found, the
168d0 20 6e 65 78 74 20 6f 75 74 65 72 0a 2a 2a 20 63 next outer.** c
168e0 6f 6e 74 65 78 74 20 69 73 20 63 68 65 63 6b 65 ontext is checke
168f0 64 2e 20 20 49 66 20 74 68 65 72 65 20 69 73 20 d. If there is
16900 73 74 69 6c 6c 20 6e 6f 20 6d 61 74 63 68 2c 20 still no match,
16910 74 68 65 20 6e 65 78 74 20 63 6f 6e 74 65 78 74 the next context
16920 0a 2a 2a 20 69 73 20 63 68 65 63 6b 65 64 2e 20 .** is checked.
16930 20 54 68 69 73 20 70 72 6f 63 65 73 73 20 63 6f This process co
16940 6e 74 69 6e 75 65 73 20 75 6e 74 69 6c 20 65 69 ntinues until ei
16950 74 68 65 72 20 61 20 6d 61 74 63 68 20 69 73 20 ther a match is
16960 66 6f 75 6e 64 0a 2a 2a 20 6f 72 20 61 6c 6c 20 found.** or all
16970 63 6f 6e 74 65 78 74 73 20 61 72 65 20 63 68 65 contexts are che
16980 63 6b 2e 20 20 57 68 65 6e 20 61 20 6d 61 74 63 ck. When a matc
16990 68 20 69 73 20 66 6f 75 6e 64 2c 20 74 68 65 20 h is found, the
169a0 6e 52 65 66 20 6d 65 6d 62 65 72 20 6f 66 0a 2a nRef member of.*
169b0 2a 20 74 68 65 20 63 6f 6e 74 65 78 74 20 63 6f * the context co
169c0 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6d 61 74 ntaining the mat
169d0 63 68 20 69 73 20 69 6e 63 72 65 6d 65 6e 74 65 ch is incremente
169e0 64 2e 20 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 73 d. .**.** Each s
169f0 75 62 71 75 65 72 79 20 67 65 74 73 20 61 20 6e ubquery gets a n
16a00 65 77 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2e 20 ew NameContext.
16a10 20 54 68 65 20 70 4e 65 78 74 20 66 69 65 6c 64 The pNext field
16a20 20 70 6f 69 6e 74 73 20 74 6f 20 74 68 65 0a 2a points to the.*
16a30 2a 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 69 6e * NameContext in
16a40 20 74 68 65 20 70 61 72 65 6e 74 20 71 75 65 72 the parent quer
16a50 79 2e 20 20 54 68 75 73 20 74 68 65 20 70 72 6f y. Thus the pro
16a60 63 65 73 73 20 6f 66 20 73 63 61 6e 6e 69 6e 67 cess of scanning
16a70 20 74 68 65 0a 2a 2a 20 4e 61 6d 65 43 6f 6e 74 the.** NameCont
16a80 65 78 74 20 6c 69 73 74 20 63 6f 72 72 65 73 70 ext list corresp
16a90 6f 6e 64 73 20 74 6f 20 73 65 61 72 63 68 69 6e onds to searchin
16aa0 67 20 74 68 72 6f 75 67 68 20 73 75 63 63 65 73 g through succes
16ab0 73 69 76 65 6c 79 20 6f 75 74 65 72 0a 2a 2a 20 sively outer.**
16ac0 73 75 62 71 75 65 72 69 65 73 20 6c 6f 6f 6b 69 subqueries looki
16ad0 6e 67 20 66 6f 72 20 61 20 6d 61 74 63 68 2e 0a ng for a match..
16ae0 2a 2f 0a 73 74 72 75 63 74 20 4e 61 6d 65 43 6f */.struct NameCo
16af0 6e 74 65 78 74 20 7b 0a 20 20 50 61 72 73 65 20 ntext {. Parse
16b00 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 20 2f *pParse; /
16b10 2a 20 54 68 65 20 70 61 72 73 65 72 20 2a 2f 0a * The parser */.
16b20 20 20 53 72 63 4c 69 73 74 20 2a 70 53 72 63 4c SrcList *pSrcL
16b30 69 73 74 3b 20 20 20 2f 2a 20 4f 6e 65 20 6f 72 ist; /* One or
16b40 20 6d 6f 72 65 20 74 61 62 6c 65 73 20 75 73 65 more tables use
16b50 64 20 74 6f 20 72 65 73 6f 6c 76 65 20 6e 61 6d d to resolve nam
16b60 65 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 es */. ExprList
16b70 20 2a 70 45 4c 69 73 74 3b 20 20 20 20 2f 2a 20 *pEList; /*
16b80 4f 70 74 69 6f 6e 61 6c 20 6c 69 73 74 20 6f 66 Optional list of
16b90 20 72 65 73 75 6c 74 2d 73 65 74 20 63 6f 6c 75 result-set colu
16ba0 6d 6e 73 20 2a 2f 0a 20 20 41 67 67 49 6e 66 6f mns */. AggInfo
16bb0 20 2a 70 41 67 67 49 6e 66 6f 3b 20 20 20 2f 2a *pAggInfo; /*
16bc0 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f Information abo
16bd0 75 74 20 61 67 67 72 65 67 61 74 65 73 20 61 74 ut aggregates at
16be0 20 74 68 69 73 20 6c 65 76 65 6c 20 2a 2f 0a 20 this level */.
16bf0 20 4e 61 6d 65 43 6f 6e 74 65 78 74 20 2a 70 4e NameContext *pN
16c00 65 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 6f 75 ext; /* Next ou
16c10 74 65 72 20 6e 61 6d 65 20 63 6f 6e 74 65 78 74 ter name context
16c20 2e 20 20 4e 55 4c 4c 20 66 6f 72 20 6f 75 74 65 . NULL for oute
16c30 72 6d 6f 73 74 20 2a 2f 0a 20 20 69 6e 74 20 6e rmost */. int n
16c40 52 65 66 3b 20 20 20 20 20 20 20 20 20 20 20 20 Ref;
16c50 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6e 61 6d /* Number of nam
16c60 65 73 20 72 65 73 6f 6c 76 65 64 20 62 79 20 74 es resolved by t
16c70 68 69 73 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 his context */.
16c80 20 69 6e 74 20 6e 45 72 72 3b 20 20 20 20 20 20 int nErr;
16c90 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
16ca0 6f 66 20 65 72 72 6f 72 73 20 65 6e 63 6f 75 6e of errors encoun
16cb0 74 65 72 65 64 20 77 68 69 6c 65 20 72 65 73 6f tered while reso
16cc0 6c 76 69 6e 67 20 6e 61 6d 65 73 20 2a 2f 0a 20 lving names */.
16cd0 20 75 38 20 6e 63 46 6c 61 67 73 3b 20 20 20 20 u8 ncFlags;
16ce0 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 /* Zero or
16cf0 20 6d 6f 72 65 20 4e 43 5f 2a 20 66 6c 61 67 73 more NC_* flags
16d00 20 64 65 66 69 6e 65 64 20 62 65 6c 6f 77 20 2a defined below *
16d10 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f /.};../*.** Allo
16d20 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 74 wed values for t
16d30 68 65 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2c 20 he NameContext,
16d40 6e 63 46 6c 61 67 73 20 66 69 65 6c 64 2e 0a 2a ncFlags field..*
16d50 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 41 6c 6c /.#define NC_All
16d60 6f 77 41 67 67 20 20 30 78 30 31 20 20 20 20 2f owAgg 0x01 /
16d70 2a 20 41 67 67 72 65 67 61 74 65 20 66 75 6e 63 * Aggregate func
16d80 74 69 6f 6e 73 20 61 72 65 20 61 6c 6c 6f 77 65 tions are allowe
16d90 64 20 68 65 72 65 20 2a 2f 0a 23 64 65 66 69 6e d here */.#defin
16da0 65 20 4e 43 5f 48 61 73 41 67 67 20 20 20 20 30 e NC_HasAgg 0
16db0 78 30 32 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 72 x02 /* One or
16dc0 20 6d 6f 72 65 20 61 67 67 72 65 67 61 74 65 20 more aggregate
16dd0 66 75 6e 63 74 69 6f 6e 73 20 73 65 65 6e 20 2a functions seen *
16de0 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 49 73 43 /.#define NC_IsC
16df0 68 65 63 6b 20 20 20 30 78 30 34 20 20 20 20 2f heck 0x04 /
16e00 2a 20 54 72 75 65 20 69 66 20 72 65 73 6f 6c 76 * True if resolv
16e10 69 6e 67 20 6e 61 6d 65 73 20 69 6e 20 61 20 43 ing names in a C
16e20 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 HECK constraint
16e30 2a 2f 0a 23 64 65 66 69 6e 65 20 4e 43 5f 49 6e */.#define NC_In
16e40 41 67 67 46 75 6e 63 20 30 78 30 38 20 20 20 20 AggFunc 0x08
16e50 2f 2a 20 54 72 75 65 20 69 66 20 61 6e 61 6c 79 /* True if analy
16e60 7a 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 20 74 zing arguments t
16e70 6f 20 61 6e 20 61 67 67 20 66 75 6e 63 20 2a 2f o an agg func */
16e80 0a 23 64 65 66 69 6e 65 20 4e 43 5f 50 61 72 74 .#define NC_Part
16e90 49 64 78 20 20 20 30 78 31 30 20 20 20 20 2f 2a Idx 0x10 /*
16ea0 20 54 72 75 65 20 69 66 20 72 65 73 6f 6c 76 69 True if resolvi
16eb0 6e 67 20 61 20 70 61 72 74 69 61 6c 20 69 6e 64 ng a partial ind
16ec0 65 78 20 57 48 45 52 45 20 2a 2f 0a 0a 2f 2a 0a ex WHERE */../*.
16ed0 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f ** An instance o
16ee0 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 f the following
16ef0 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 structure contai
16f00 6e 73 20 61 6c 6c 20 69 6e 66 6f 72 6d 61 74 69 ns all informati
16f10 6f 6e 0a 2a 2a 20 6e 65 65 64 65 64 20 74 6f 20 on.** needed to
16f20 67 65 6e 65 72 61 74 65 20 63 6f 64 65 20 66 6f generate code fo
16f30 72 20 61 20 73 69 6e 67 6c 65 20 53 45 4c 45 43 r a single SELEC
16f40 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 0a T statement..**.
16f50 2a 2a 20 6e 4c 69 6d 69 74 20 69 73 20 73 65 74 ** nLimit is set
16f60 20 74 6f 20 2d 31 20 69 66 20 74 68 65 72 65 20 to -1 if there
16f70 69 73 20 6e 6f 20 4c 49 4d 49 54 20 63 6c 61 75 is no LIMIT clau
16f80 73 65 2e 20 20 6e 4f 66 66 73 65 74 20 69 73 20 se. nOffset is
16f90 73 65 74 20 74 6f 20 30 2e 0a 2a 2a 20 49 66 20 set to 0..** If
16fa0 74 68 65 72 65 20 69 73 20 61 20 4c 49 4d 49 54 there is a LIMIT
16fb0 20 63 6c 61 75 73 65 2c 20 74 68 65 20 70 61 72 clause, the par
16fc0 73 65 72 20 73 65 74 73 20 6e 4c 69 6d 69 74 20 ser sets nLimit
16fd0 74 6f 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 to the value of
16fe0 74 68 65 0a 2a 2a 20 6c 69 6d 69 74 20 61 6e 64 the.** limit and
16ff0 20 6e 4f 66 66 73 65 74 20 74 6f 20 74 68 65 20 nOffset to the
17000 76 61 6c 75 65 20 6f 66 20 74 68 65 20 6f 66 66 value of the off
17010 73 65 74 20 28 6f 72 20 30 20 69 66 20 74 68 65 set (or 0 if the
17020 72 65 20 69 73 20 6e 6f 74 0a 2a 2a 20 6f 66 66 re is not.** off
17030 73 65 74 29 2e 20 20 42 75 74 20 6c 61 74 65 72 set). But later
17040 20 6f 6e 2c 20 6e 4c 69 6d 69 74 20 61 6e 64 20 on, nLimit and
17050 6e 4f 66 66 73 65 74 20 62 65 63 6f 6d 65 20 74 nOffset become t
17060 68 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69 he memory locati
17070 6f 6e 73 0a 2a 2a 20 69 6e 20 74 68 65 20 56 44 ons.** in the VD
17080 42 45 20 74 68 61 74 20 72 65 63 6f 72 64 20 74 BE that record t
17090 68 65 20 6c 69 6d 69 74 20 61 6e 64 20 6f 66 66 he limit and off
170a0 73 65 74 20 63 6f 75 6e 74 65 72 73 2e 0a 2a 2a set counters..**
170b0 0a 2a 2a 20 61 64 64 72 4f 70 65 6e 45 70 68 6d .** addrOpenEphm
170c0 5b 5d 20 65 6e 74 72 69 65 73 20 63 6f 6e 74 61 [] entries conta
170d0 69 6e 20 74 68 65 20 61 64 64 72 65 73 73 20 6f in the address o
170e0 66 20 4f 50 5f 4f 70 65 6e 45 70 68 65 6d 65 72 f OP_OpenEphemer
170f0 61 6c 20 6f 70 63 6f 64 65 73 2e 0a 2a 2a 20 54 al opcodes..** T
17100 68 65 73 65 20 61 64 64 72 65 73 73 65 73 20 6d hese addresses m
17110 75 73 74 20 62 65 20 73 74 6f 72 65 64 20 73 6f ust be stored so
17120 20 74 68 61 74 20 77 65 20 63 61 6e 20 67 6f 20 that we can go
17130 62 61 63 6b 20 61 6e 64 20 66 69 6c 6c 20 69 6e back and fill in
17140 0a 2a 2a 20 74 68 65 20 50 34 5f 4b 45 59 49 4e .** the P4_KEYIN
17150 46 4f 20 61 6e 64 20 50 32 20 70 61 72 61 6d 65 FO and P2 parame
17160 74 65 72 73 20 6c 61 74 65 72 2e 20 20 4e 65 69 ters later. Nei
17170 74 68 65 72 20 74 68 65 20 4b 65 79 49 6e 66 6f ther the KeyInfo
17180 20 6e 6f 72 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 nor.** the numb
17190 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e er of columns in
171a0 20 50 32 20 63 61 6e 20 62 65 20 63 6f 6d 70 75 P2 can be compu
171b0 74 65 64 20 61 74 20 74 68 65 20 73 61 6d 65 20 ted at the same
171c0 74 69 6d 65 0a 2a 2a 20 61 73 20 74 68 65 20 4f time.** as the O
171d0 50 5f 4f 70 65 6e 45 70 68 6d 20 69 6e 73 74 72 P_OpenEphm instr
171e0 75 63 74 69 6f 6e 20 69 73 20 63 6f 64 65 64 20 uction is coded
171f0 62 65 63 61 75 73 65 20 6e 6f 74 0a 2a 2a 20 65 because not.** e
17200 6e 6f 75 67 68 20 69 6e 66 6f 72 6d 61 74 69 6f nough informatio
17210 6e 20 61 62 6f 75 74 20 74 68 65 20 63 6f 6d 70 n about the comp
17220 6f 75 6e 64 20 71 75 65 72 79 20 69 73 20 6b 6e ound query is kn
17230 6f 77 6e 20 61 74 20 74 68 61 74 20 70 6f 69 6e own at that poin
17240 74 2e 0a 2a 2a 20 54 68 65 20 4b 65 79 49 6e 66 t..** The KeyInf
17250 6f 20 66 6f 72 20 61 64 64 72 4f 70 65 6e 54 72 o for addrOpenTr
17260 61 6e 5b 30 5d 20 61 6e 64 20 5b 31 5d 20 63 6f an[0] and [1] co
17270 6e 74 61 69 6e 73 20 63 6f 6c 6c 61 74 69 6e 67 ntains collating
17280 20 73 65 71 75 65 6e 63 65 73 0a 2a 2a 20 66 6f sequences.** fo
17290 72 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 r the result set
172a0 2e 20 20 54 68 65 20 4b 65 79 49 6e 66 6f 20 66 . The KeyInfo f
172b0 6f 72 20 61 64 64 72 4f 70 65 6e 45 70 68 6d 5b or addrOpenEphm[
172c0 32 5d 20 63 6f 6e 74 61 69 6e 73 20 63 6f 6c 6c 2] contains coll
172d0 61 74 69 6e 67 0a 2a 2a 20 73 65 71 75 65 6e 63 ating.** sequenc
172e0 65 73 20 66 6f 72 20 74 68 65 20 4f 52 44 45 52 es for the ORDER
172f0 20 42 59 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 73 BY clause..*/.s
17300 74 72 75 63 74 20 53 65 6c 65 63 74 20 7b 0a 20 truct Select {.
17310 20 45 78 70 72 4c 69 73 74 20 2a 70 45 4c 69 73 ExprList *pELis
17320 74 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 66 t; /* The f
17330 69 65 6c 64 73 20 6f 66 20 74 68 65 20 72 65 73 ields of the res
17340 75 6c 74 20 2a 2f 0a 20 20 75 38 20 6f 70 3b 20 ult */. u8 op;
17350 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17360 2f 2a 20 4f 6e 65 20 6f 66 3a 20 54 4b 5f 55 4e /* One of: TK_UN
17370 49 4f 4e 20 54 4b 5f 41 4c 4c 20 54 4b 5f 49 4e ION TK_ALL TK_IN
17380 54 45 52 53 45 43 54 20 54 4b 5f 45 58 43 45 50 TERSECT TK_EXCEP
17390 54 20 2a 2f 0a 20 20 75 31 36 20 73 65 6c 46 6c T */. u16 selFl
173a0 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ags; /*
173b0 20 56 61 72 69 6f 75 73 20 53 46 5f 2a 20 76 61 Various SF_* va
173c0 6c 75 65 73 20 2a 2f 0a 20 20 69 6e 74 20 69 4c lues */. int iL
173d0 69 6d 69 74 2c 20 69 4f 66 66 73 65 74 3b 20 20 imit, iOffset;
173e0 20 2f 2a 20 4d 65 6d 6f 72 79 20 72 65 67 69 73 /* Memory regis
173f0 74 65 72 73 20 68 6f 6c 64 69 6e 67 20 4c 49 4d ters holding LIM
17400 49 54 20 26 20 4f 46 46 53 45 54 20 63 6f 75 6e IT & OFFSET coun
17410 74 65 72 73 20 2a 2f 0a 20 20 69 6e 74 20 61 64 ters */. int ad
17420 64 72 4f 70 65 6e 45 70 68 6d 5b 32 5d 3b 20 20 drOpenEphm[2];
17430 20 2f 2a 20 4f 50 5f 4f 70 65 6e 45 70 68 65 6d /* OP_OpenEphem
17440 20 6f 70 63 6f 64 65 73 20 72 65 6c 61 74 65 64 opcodes related
17450 20 74 6f 20 74 68 69 73 20 73 65 6c 65 63 74 20 to this select
17460 2a 2f 0a 20 20 75 36 34 20 6e 53 65 6c 65 63 74 */. u64 nSelect
17470 52 6f 77 3b 20 20 20 20 20 20 20 20 2f 2a 20 45 Row; /* E
17480 73 74 69 6d 61 74 65 64 20 6e 75 6d 62 65 72 20 stimated number
17490 6f 66 20 72 65 73 75 6c 74 20 72 6f 77 73 20 2a of result rows *
174a0 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 53 72 /. SrcList *pSr
174b0 63 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 c; /* Th
174c0 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a 2f e FROM clause */
174d0 0a 20 20 45 78 70 72 20 2a 70 57 68 65 72 65 3b . Expr *pWhere;
174e0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
174f0 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a 2f WHERE clause */
17500 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 47 72 . ExprList *pGr
17510 6f 75 70 42 79 3b 20 20 20 20 2f 2a 20 54 68 65 oupBy; /* The
17520 20 47 52 4f 55 50 20 42 59 20 63 6c 61 75 73 65 GROUP BY clause
17530 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 48 61 76 */. Expr *pHav
17540 69 6e 67 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ing; /*
17550 54 68 65 20 48 41 56 49 4e 47 20 63 6c 61 75 73 The HAVING claus
17560 65 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 e */. ExprList
17570 2a 70 4f 72 64 65 72 42 79 3b 20 20 20 20 2f 2a *pOrderBy; /*
17580 20 54 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c The ORDER BY cl
17590 61 75 73 65 20 2a 2f 0a 20 20 53 65 6c 65 63 74 ause */. Select
175a0 20 2a 70 50 72 69 6f 72 3b 20 20 20 20 20 20 20 *pPrior;
175b0 20 2f 2a 20 50 72 69 6f 72 20 73 65 6c 65 63 74 /* Prior select
175c0 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 73 in a compound s
175d0 65 6c 65 63 74 20 73 74 61 74 65 6d 65 6e 74 20 elect statement
175e0 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a 70 4e 65 */. Select *pNe
175f0 78 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e xt; /* N
17600 65 78 74 20 73 65 6c 65 63 74 20 74 6f 20 74 68 ext select to th
17610 65 20 6c 65 66 74 20 69 6e 20 61 20 63 6f 6d 70 e left in a comp
17620 6f 75 6e 64 20 2a 2f 0a 20 20 45 78 70 72 20 2a ound */. Expr *
17630 70 4c 69 6d 69 74 3b 20 20 20 20 20 20 20 20 20 pLimit;
17640 20 2f 2a 20 4c 49 4d 49 54 20 65 78 70 72 65 73 /* LIMIT expres
17650 73 69 6f 6e 2e 20 4e 55 4c 4c 20 6d 65 61 6e 73 sion. NULL means
17660 20 6e 6f 74 20 75 73 65 64 2e 20 2a 2f 0a 20 20 not used. */.
17670 45 78 70 72 20 2a 70 4f 66 66 73 65 74 3b 20 20 Expr *pOffset;
17680 20 20 20 20 20 20 20 2f 2a 20 4f 46 46 53 45 54 /* OFFSET
17690 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 4e 55 4c expression. NUL
176a0 4c 20 6d 65 61 6e 73 20 6e 6f 74 20 75 73 65 64 L means not used
176b0 2e 20 2a 2f 0a 20 20 57 69 74 68 20 2a 70 57 69 . */. With *pWi
176c0 74 68 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a th; /*
176d0 20 57 49 54 48 20 63 6c 61 75 73 65 20 61 74 74 WITH clause att
176e0 61 63 68 65 64 20 74 6f 20 74 68 69 73 20 73 65 ached to this se
176f0 6c 65 63 74 2e 20 4f 72 20 4e 55 4c 4c 2e 20 2a lect. Or NULL. *
17700 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f /.};../*.** Allo
17710 77 65 64 20 76 61 6c 75 65 73 20 66 6f 72 20 53 wed values for S
17720 65 6c 65 63 74 2e 73 65 6c 46 6c 61 67 73 2e 20 elect.selFlags.
17730 20 54 68 65 20 22 53 46 22 20 70 72 65 66 69 78 The "SF" prefix
17740 20 73 74 61 6e 64 73 20 66 6f 72 0a 2a 2a 20 22 stands for.** "
17750 53 65 6c 65 63 74 20 46 6c 61 67 22 2e 0a 2a 2f Select Flag"..*/
17760 0a 23 64 65 66 69 6e 65 20 53 46 5f 44 69 73 74 .#define SF_Dist
17770 69 6e 63 74 20 20 20 20 20 20 20 20 30 78 30 30 inct 0x00
17780 30 31 20 20 2f 2a 20 4f 75 74 70 75 74 20 73 68 01 /* Output sh
17790 6f 75 6c 64 20 62 65 20 44 49 53 54 49 4e 43 54 ould be DISTINCT
177a0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 52 */.#define SF_R
177b0 65 73 6f 6c 76 65 64 20 20 20 20 20 20 20 20 30 esolved 0
177c0 78 30 30 30 32 20 20 2f 2a 20 49 64 65 6e 74 69 x0002 /* Identi
177d0 66 69 65 72 73 20 68 61 76 65 20 62 65 65 6e 20 fiers have been
177e0 72 65 73 6f 6c 76 65 64 20 2a 2f 0a 23 64 65 66 resolved */.#def
177f0 69 6e 65 20 53 46 5f 41 67 67 72 65 67 61 74 65 ine SF_Aggregate
17800 20 20 20 20 20 20 20 30 78 30 30 30 34 20 20 2f 0x0004 /
17810 2a 20 43 6f 6e 74 61 69 6e 73 20 61 67 67 72 65 * Contains aggre
17820 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 2a gate functions *
17830 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 55 73 65 /.#define SF_Use
17840 73 45 70 68 65 6d 65 72 61 6c 20 20 20 30 78 30 sEphemeral 0x0
17850 30 30 38 20 20 2f 2a 20 55 73 65 73 20 74 68 65 008 /* Uses the
17860 20 4f 70 65 6e 45 70 68 65 6d 65 72 61 6c 20 6f OpenEphemeral o
17870 70 63 6f 64 65 20 2a 2f 0a 23 64 65 66 69 6e 65 pcode */.#define
17880 20 53 46 5f 45 78 70 61 6e 64 65 64 20 20 20 20 SF_Expanded
17890 20 20 20 20 30 78 30 30 31 30 20 20 2f 2a 20 73 0x0010 /* s
178a0 71 6c 69 74 65 33 53 65 6c 65 63 74 45 78 70 61 qlite3SelectExpa
178b0 6e 64 28 29 20 63 61 6c 6c 65 64 20 6f 6e 20 74 nd() called on t
178c0 68 69 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 his */.#define S
178d0 46 5f 48 61 73 54 79 70 65 49 6e 66 6f 20 20 20 F_HasTypeInfo
178e0 20 20 30 78 30 30 32 30 20 20 2f 2a 20 46 52 4f 0x0020 /* FRO
178f0 4d 20 73 75 62 71 75 65 72 69 65 73 20 68 61 76 M subqueries hav
17900 65 20 54 61 62 6c 65 20 6d 65 74 61 64 61 74 61 e Table metadata
17910 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 */.
17920 20 20 20 20 20 20 20 20 2f 2a 20 20 20 20 20 30 /* 0
17930 78 30 30 34 30 20 20 4e 4f 54 20 55 53 45 44 20 x0040 NOT USED
17940 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 5f 56 61 */.#define SF_Va
17950 6c 75 65 73 20 20 20 20 20 20 20 20 20 20 30 78 lues 0x
17960 30 30 38 30 20 20 2f 2a 20 53 79 6e 74 68 65 73 0080 /* Synthes
17970 69 7a 65 64 20 66 72 6f 6d 20 56 41 4c 55 45 53 ized from VALUES
17980 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 20 clause */.
17990 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
179a0 2a 20 20 20 20 20 30 78 30 31 30 30 20 20 4e 4f * 0x0100 NO
179b0 54 20 55 53 45 44 20 2a 2f 0a 23 64 65 66 69 6e T USED */.#defin
179c0 65 20 53 46 5f 4e 65 73 74 65 64 46 72 6f 6d 20 e SF_NestedFrom
179d0 20 20 20 20 20 30 78 30 32 30 30 20 20 2f 2a 20 0x0200 /*
179e0 50 61 72 74 20 6f 66 20 61 20 70 61 72 65 6e 74 Part of a parent
179f0 68 65 73 69 7a 65 64 20 46 52 4f 4d 20 63 6c 61 hesized FROM cla
17a00 75 73 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 use */.#define S
17a10 46 5f 4d 61 79 62 65 43 6f 6e 76 65 72 74 20 20 F_MaybeConvert
17a20 20 20 30 78 30 34 30 30 20 20 2f 2a 20 4e 65 65 0x0400 /* Nee
17a30 64 20 63 6f 6e 76 65 72 74 43 6f 6d 70 6f 75 6e d convertCompoun
17a40 64 53 65 6c 65 63 74 54 6f 53 75 62 71 75 65 72 dSelectToSubquer
17a50 79 28 29 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 y() */.#define S
17a60 46 5f 52 65 63 75 72 73 69 76 65 20 20 20 20 20 F_Recursive
17a70 20 20 30 78 30 38 30 30 20 20 2f 2a 20 54 68 65 0x0800 /* The
17a80 20 72 65 63 75 72 73 69 76 65 20 70 61 72 74 20 recursive part
17a90 6f 66 20 61 20 72 65 63 75 72 73 69 76 65 20 43 of a recursive C
17aa0 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 46 TE */.#define SF
17ab0 5f 43 6f 6d 70 6f 75 6e 64 20 20 20 20 20 20 20 _Compound
17ac0 20 30 78 31 30 30 30 20 20 2f 2a 20 50 61 72 74 0x1000 /* Part
17ad0 20 6f 66 20 61 20 63 6f 6d 70 6f 75 6e 64 20 71 of a compound q
17ae0 75 65 72 79 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 uery */.../*.**
17af0 54 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 61 The results of a
17b00 20 53 45 4c 45 43 54 20 63 61 6e 20 62 65 20 64 SELECT can be d
17b10 69 73 74 72 69 62 75 74 65 64 20 69 6e 20 73 65 istributed in se
17b20 76 65 72 61 6c 20 77 61 79 73 2c 20 61 73 20 64 veral ways, as d
17b30 65 66 69 6e 65 64 0a 2a 2a 20 62 79 20 6f 6e 65 efined.** by one
17b40 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
17b50 67 20 6d 61 63 72 6f 73 2e 20 20 54 68 65 20 22 g macros. The "
17b60 53 52 54 22 20 70 72 65 66 69 78 20 6d 65 61 6e SRT" prefix mean
17b70 73 20 22 53 45 4c 45 43 54 20 52 65 73 75 6c 74 s "SELECT Result
17b80 0a 2a 2a 20 54 79 70 65 22 2e 0a 2a 2a 0a 2a 2a .** Type"..**.**
17b90 20 20 20 20 20 53 52 54 5f 55 6e 69 6f 6e 20 20 SRT_Union
17ba0 20 20 20 20 20 53 74 6f 72 65 20 72 65 73 75 6c Store resul
17bb0 74 73 20 61 73 20 61 20 6b 65 79 20 69 6e 20 61 ts as a key in a
17bc0 20 74 65 6d 70 6f 72 61 72 79 20 69 6e 64 65 78 temporary index
17bd0 20 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 .**
17be0 20 20 20 20 20 20 20 20 20 69 64 65 6e 74 69 66 identif
17bf0 69 65 64 20 62 79 20 70 44 65 73 74 2d 3e 69 53 ied by pDest->iS
17c00 44 50 61 72 6d 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 DParm..**.**
17c10 20 53 52 54 5f 45 78 63 65 70 74 20 20 20 20 20 SRT_Except
17c20 20 52 65 6d 6f 76 65 20 72 65 73 75 6c 74 73 20 Remove results
17c30 66 72 6f 6d 20 74 68 65 20 74 65 6d 70 6f 72 61 from the tempora
17c40 72 79 20 69 6e 64 65 78 20 70 44 65 73 74 2d 3e ry index pDest->
17c50 69 53 44 50 61 72 6d 2e 0a 2a 2a 0a 2a 2a 20 20 iSDParm..**.**
17c60 20 20 20 53 52 54 5f 45 78 69 73 74 73 20 20 20 SRT_Exists
17c70 20 20 20 53 74 6f 72 65 20 61 20 31 20 69 6e 20 Store a 1 in
17c80 6d 65 6d 6f 72 79 20 63 65 6c 6c 20 70 44 65 73 memory cell pDes
17c90 74 2d 3e 69 53 44 50 61 72 6d 20 69 66 20 74 68 t->iSDParm if th
17ca0 65 20 72 65 73 75 6c 74 0a 2a 2a 20 20 20 20 20 e result.**
17cb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17cc0 73 65 74 20 69 73 20 6e 6f 74 20 65 6d 70 74 79 set is not empty
17cd0 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f ..**.** SRT_
17ce0 44 69 73 63 61 72 64 20 20 20 20 20 54 68 72 6f Discard Thro
17cf0 77 20 74 68 65 20 72 65 73 75 6c 74 73 20 61 77 w the results aw
17d00 61 79 2e 20 20 54 68 69 73 20 69 73 20 75 73 65 ay. This is use
17d10 64 20 62 79 20 53 45 4c 45 43 54 0a 2a 2a 20 20 d by SELECT.**
17d20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17d30 20 20 20 73 74 61 74 65 6d 65 6e 74 73 20 77 69 statements wi
17d40 74 68 69 6e 20 74 72 69 67 67 65 72 73 20 77 68 thin triggers wh
17d50 6f 73 65 20 6f 6e 6c 79 20 70 75 72 70 6f 73 65 ose only purpose
17d60 20 69 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 is.**
17d70 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 73 the s
17d80 69 64 65 2d 65 66 66 65 63 74 73 20 6f 66 20 66 ide-effects of f
17d90 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 unctions..**.**
17da0 41 6c 6c 20 6f 66 20 74 68 65 20 61 62 6f 76 65 All of the above
17db0 20 61 72 65 20 66 72 65 65 20 74 6f 20 69 67 6e are free to ign
17dc0 6f 72 65 20 74 68 65 69 72 20 4f 52 44 45 52 20 ore their ORDER
17dd0 42 59 20 63 6c 61 75 73 65 2e 20 54 68 6f 73 65 BY clause. Those
17de0 20 74 68 61 74 0a 2a 2a 20 66 6f 6c 6c 6f 77 20 that.** follow
17df0 6d 75 73 74 20 68 6f 6e 6f 72 20 74 68 65 20 4f must honor the O
17e00 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2e 0a RDER BY clause..
17e10 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 4f 75 **.** SRT_Ou
17e20 74 70 75 74 20 20 20 20 20 20 47 65 6e 65 72 61 tput Genera
17e30 74 65 20 61 20 72 6f 77 20 6f 66 20 6f 75 74 70 te a row of outp
17e40 75 74 20 28 75 73 69 6e 67 20 74 68 65 20 4f 50 ut (using the OP
17e50 5f 52 65 73 75 6c 74 52 6f 77 0a 2a 2a 20 20 20 _ResultRow.**
17e60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
17e70 20 20 6f 70 63 6f 64 65 29 20 66 6f 72 20 65 61 opcode) for ea
17e80 63 68 20 72 6f 77 20 69 6e 20 74 68 65 20 72 65 ch row in the re
17e90 73 75 6c 74 20 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 sult set..**.**
17ea0 20 20 20 20 53 52 54 5f 4d 65 6d 20 20 20 20 20 SRT_Mem
17eb0 20 20 20 20 4f 6e 6c 79 20 76 61 6c 69 64 20 69 Only valid i
17ec0 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 f the result is
17ed0 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 2e a single column.
17ee0 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
17ef0 20 20 20 20 20 20 20 20 53 74 6f 72 65 20 74 68 Store th
17f00 65 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e 20 6f e first column o
17f10 66 20 74 68 65 20 66 69 72 73 74 20 72 65 73 75 f the first resu
17f20 6c 74 20 72 6f 77 0a 2a 2a 20 20 20 20 20 20 20 lt row.**
17f30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e in
17f40 20 72 65 67 69 73 74 65 72 20 70 44 65 73 74 2d register pDest-
17f50 3e 69 53 44 50 61 72 6d 20 74 68 65 6e 20 61 62 >iSDParm then ab
17f60 61 6e 64 6f 6e 20 74 68 65 20 72 65 73 74 0a 2a andon the rest.*
17f70 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
17f80 20 20 20 20 20 20 6f 66 20 74 68 65 20 71 75 65 of the que
17f90 72 79 2e 20 20 54 68 69 73 20 64 65 73 74 69 6e ry. This destin
17fa0 61 74 69 6f 6e 20 69 6d 70 6c 69 65 73 20 22 4c ation implies "L
17fb0 49 4d 49 54 20 31 22 2e 0a 2a 2a 0a 2a 2a 20 20 IMIT 1"..**.**
17fc0 20 20 20 53 52 54 5f 53 65 74 20 20 20 20 20 20 SRT_Set
17fd0 20 20 20 54 68 65 20 72 65 73 75 6c 74 20 6d 75 The result mu
17fe0 73 74 20 62 65 20 61 20 73 69 6e 67 6c 65 20 63 st be a single c
17ff0 6f 6c 75 6d 6e 2e 20 20 53 74 6f 72 65 20 65 61 olumn. Store ea
18000 63 68 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 ch.**
18010 20 20 20 20 20 20 20 20 20 20 72 6f 77 20 6f 66 row of
18020 20 72 65 73 75 6c 74 20 61 73 20 74 68 65 20 6b result as the k
18030 65 79 20 69 6e 20 74 61 62 6c 65 20 70 44 65 73 ey in table pDes
18040 74 2d 3e 69 53 44 50 61 72 6d 2e 20 0a 2a 2a 20 t->iSDParm. .**
18050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18060 20 20 20 20 41 70 70 6c 79 20 74 68 65 20 61 66 Apply the af
18070 66 69 6e 69 74 79 20 70 44 65 73 74 2d 3e 61 66 finity pDest->af
18080 66 53 64 73 74 20 62 65 66 6f 72 65 20 73 74 6f fSdst before sto
18090 72 69 6e 67 0a 2a 2a 20 20 20 20 20 20 20 20 20 ring.**
180a0 20 20 20 20 20 20 20 20 20 20 20 20 72 65 73 75 resu
180b0 6c 74 73 2e 20 20 55 73 65 64 20 74 6f 20 69 6d lts. Used to im
180c0 70 6c 65 6d 65 6e 74 20 22 49 4e 20 28 53 45 4c plement "IN (SEL
180d0 45 43 54 20 2e 2e 2e 29 22 2e 0a 2a 2a 0a 2a 2a ECT ...)"..**.**
180e0 20 20 20 20 20 53 52 54 5f 45 70 68 65 6d 54 61 SRT_EphemTa
180f0 62 20 20 20 20 43 72 65 61 74 65 20 61 6e 20 74 b Create an t
18100 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 20 70 emporary table p
18110 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 61 6e Dest->iSDParm an
18120 64 20 73 74 6f 72 65 0a 2a 2a 20 20 20 20 20 20 d store.**
18130 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 t
18140 68 65 20 72 65 73 75 6c 74 20 74 68 65 72 65 2e he result there.
18150 20 54 68 65 20 63 75 72 73 6f 72 20 69 73 20 6c The cursor is l
18160 65 66 74 20 6f 70 65 6e 20 61 66 74 65 72 0a 2a eft open after.*
18170 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
18180 20 20 20 20 20 20 72 65 74 75 72 6e 69 6e 67 2e returning.
18190 20 20 54 68 69 73 20 69 73 20 6c 69 6b 65 20 53 This is like S
181a0 52 54 5f 54 61 62 6c 65 20 65 78 63 65 70 74 20 RT_Table except
181b0 74 68 61 74 0a 2a 2a 20 20 20 20 20 20 20 20 20 that.**
181c0 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 this
181d0 20 64 65 73 74 69 6e 61 74 69 6f 6e 20 75 73 65 destination use
181e0 73 20 4f 50 5f 4f 70 65 6e 45 70 68 65 6d 65 72 s OP_OpenEphemer
181f0 61 6c 20 74 6f 20 63 72 65 61 74 65 0a 2a 2a 20 al to create.**
18200 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18210 20 20 20 20 74 68 65 20 74 61 62 6c 65 20 66 69 the table fi
18220 72 73 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 rst..**.** S
18230 52 54 5f 43 6f 72 6f 75 74 69 6e 65 20 20 20 47 RT_Coroutine G
18240 65 6e 65 72 61 74 65 20 61 20 63 6f 2d 72 6f 75 enerate a co-rou
18250 74 69 6e 65 20 74 68 61 74 20 72 65 74 75 72 6e tine that return
18260 73 20 61 20 6e 65 77 20 72 6f 77 20 6f 66 0a 2a s a new row of.*
18270 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 *
18280 20 20 20 20 20 20 72 65 73 75 6c 74 73 20 65 61 results ea
18290 63 68 20 74 69 6d 65 20 69 74 20 69 73 20 69 6e ch time it is in
182a0 76 6f 6b 65 64 2e 20 20 54 68 65 20 65 6e 74 72 voked. The entr
182b0 79 20 70 6f 69 6e 74 0a 2a 2a 20 20 20 20 20 20 y point.**
182c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6f o
182d0 66 20 74 68 65 20 63 6f 2d 72 6f 75 74 69 6e 65 f the co-routine
182e0 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 72 65 is stored in re
182f0 67 69 73 74 65 72 20 70 44 65 73 74 2d 3e 69 53 gister pDest->iS
18300 44 50 61 72 6d 0a 2a 2a 20 20 20 20 20 20 20 20 DParm.**
18310 20 20 20 20 20 20 20 20 20 20 20 20 20 61 6e 64 and
18320 20 74 68 65 20 72 65 73 75 6c 74 20 72 6f 77 20 the result row
18330 69 73 20 73 74 6f 72 65 64 20 69 6e 20 70 44 65 is stored in pDe
18340 73 74 2d 3e 6e 44 65 73 74 20 72 65 67 69 73 74 st->nDest regist
18350 65 72 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ers.**
18360 20 20 20 20 20 20 20 20 20 20 20 73 74 61 72 74 start
18370 69 6e 67 20 77 69 74 68 20 70 44 65 73 74 2d 3e ing with pDest->
18380 69 53 64 73 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 iSdst..**.**
18390 20 53 52 54 5f 54 61 62 6c 65 20 20 20 20 20 20 SRT_Table
183a0 20 53 74 6f 72 65 20 72 65 73 75 6c 74 73 20 69 Store results i
183b0 6e 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c n temporary tabl
183c0 65 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d e pDest->iSDParm
183d0 2e 0a 2a 2a 20 20 20 20 20 53 52 54 5f 46 69 66 ..** SRT_Fif
183e0 6f 20 20 20 20 20 20 20 20 54 68 69 73 20 69 73 o This is
183f0 20 6c 69 6b 65 20 53 52 54 5f 45 70 68 65 6d 54 like SRT_EphemT
18400 61 62 20 65 78 63 65 70 74 20 74 68 61 74 20 74 ab except that t
18410 68 65 20 74 61 62 6c 65 0a 2a 2a 20 20 20 20 20 he table.**
18420 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18430 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 61 6c is assumed to al
18440 72 65 61 64 79 20 62 65 20 6f 70 65 6e 2e 20 20 ready be open.
18450 53 52 54 5f 46 69 66 6f 20 68 61 73 0a 2a 2a 20 SRT_Fifo has.**
18460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18470 20 20 20 20 74 68 65 20 61 64 64 69 74 69 6f 6e the addition
18480 61 6c 20 70 72 6f 70 65 72 74 79 20 6f 66 20 62 al property of b
18490 65 69 6e 67 20 61 62 6c 65 20 74 6f 20 69 67 6e eing able to ign
184a0 6f 72 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 ore.**
184b0 20 20 20 20 20 20 20 20 20 20 20 74 68 65 20 4f the O
184c0 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2e 0a RDER BY clause..
184d0 2a 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 44 69 **.** SRT_Di
184e0 73 74 46 69 66 6f 20 20 20 20 53 74 6f 72 65 20 stFifo Store
184f0 72 65 73 75 6c 74 73 20 69 6e 20 61 20 74 65 6d results in a tem
18500 70 6f 72 61 72 79 20 74 61 62 6c 65 20 70 44 65 porary table pDe
18510 73 74 2d 3e 69 53 44 50 61 72 6d 2e 0a 2a 2a 20 st->iSDParm..**
18520 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18530 20 20 20 20 42 75 74 20 61 6c 73 6f 20 75 73 65 But also use
18540 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 temporary table
18550 20 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2b pDest->iSDParm+
18560 31 20 61 73 0a 2a 2a 20 20 20 20 20 20 20 20 20 1 as.**
18570 20 20 20 20 20 20 20 20 20 20 20 20 61 20 72 65 a re
18580 63 6f 72 64 20 6f 66 20 61 6c 6c 20 70 72 69 6f cord of all prio
18590 72 20 72 65 73 75 6c 74 73 20 61 6e 64 20 69 67 r results and ig
185a0 6e 6f 72 65 20 61 6e 79 20 64 75 70 6c 69 63 61 nore any duplica
185b0 74 65 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 te.**
185c0 20 20 20 20 20 20 20 20 20 20 72 6f 77 73 2e 20 rows.
185d0 20 4e 61 6d 65 20 6d 65 61 6e 73 3a 20 20 22 44 Name means: "D
185e0 69 73 74 69 6e 63 74 20 46 69 66 6f 22 2e 0a 2a istinct Fifo"..*
185f0 2a 0a 2a 2a 20 20 20 20 20 53 52 54 5f 51 75 65 *.** SRT_Que
18600 75 65 20 20 20 20 20 20 20 53 74 6f 72 65 20 72 ue Store r
18610 65 73 75 6c 74 73 20 69 6e 20 70 72 69 6f 72 69 esults in priori
18620 74 79 20 71 75 65 75 65 20 70 44 65 73 74 2d 3e ty queue pDest->
18630 69 53 44 50 61 72 6d 20 28 72 65 61 6c 6c 79 0a iSDParm (really.
18640 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
18650 20 20 20 20 20 20 20 61 6e 20 69 6e 64 65 78 29 an index)
18660 2e 20 20 41 70 70 65 6e 64 20 61 20 73 65 71 75 . Append a sequ
18670 65 6e 63 65 20 6e 75 6d 62 65 72 20 73 6f 20 74 ence number so t
18680 68 61 74 20 61 6c 6c 20 65 6e 74 72 69 65 73 0a hat all entries.
18690 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
186a0 20 20 20 20 20 20 20 61 72 65 20 64 69 73 74 69 are disti
186b0 6e 63 74 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 53 nct..**.** S
186c0 52 54 5f 44 69 73 74 51 75 65 75 65 20 20 20 53 RT_DistQueue S
186d0 74 6f 72 65 20 72 65 73 75 6c 74 73 20 69 6e 20 tore results in
186e0 70 72 69 6f 72 69 74 79 20 71 75 65 75 65 20 70 priority queue p
186f0 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 20 6f 6e Dest->iSDParm on
18700 6c 79 20 69 66 0a 2a 2a 20 20 20 20 20 20 20 20 ly if.**
18710 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 65 the
18720 20 73 61 6d 65 20 72 65 63 6f 72 64 20 68 61 73 same record has
18730 20 6e 65 76 65 72 20 62 65 65 6e 20 73 74 6f 72 never been stor
18740 65 64 20 62 65 66 6f 72 65 2e 20 20 54 68 65 0a ed before. The.
18750 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 **
18760 20 20 20 20 20 20 20 69 6e 64 65 78 20 61 74 20 index at
18770 70 44 65 73 74 2d 3e 69 53 44 50 61 72 6d 2b 31 pDest->iSDParm+1
18780 20 68 6f 6c 64 20 61 6c 6c 20 70 72 69 6f 72 20 hold all prior
18790 73 74 6f 72 65 73 2e 0a 2a 2f 0a 23 64 65 66 69 stores..*/.#defi
187a0 6e 65 20 53 52 54 5f 55 6e 69 6f 6e 20 20 20 20 ne SRT_Union
187b0 20 20 20 20 31 20 20 2f 2a 20 53 74 6f 72 65 20 1 /* Store
187c0 72 65 73 75 6c 74 20 61 73 20 6b 65 79 73 20 69 result as keys i
187d0 6e 20 61 6e 20 69 6e 64 65 78 20 2a 2f 0a 23 64 n an index */.#d
187e0 65 66 69 6e 65 20 53 52 54 5f 45 78 63 65 70 74 efine SRT_Except
187f0 20 20 20 20 20 20 20 32 20 20 2f 2a 20 52 65 6d 2 /* Rem
18800 6f 76 65 20 72 65 73 75 6c 74 20 66 72 6f 6d 20 ove result from
18810 61 20 55 4e 49 4f 4e 20 69 6e 64 65 78 20 2a 2f a UNION index */
18820 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 45 78 69 .#define SRT_Exi
18830 73 74 73 20 20 20 20 20 20 20 33 20 20 2f 2a 20 sts 3 /*
18840 53 74 6f 72 65 20 31 20 69 66 20 74 68 65 20 72 Store 1 if the r
18850 65 73 75 6c 74 20 69 73 20 6e 6f 74 20 65 6d 70 esult is not emp
18860 74 79 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 ty */.#define SR
18870 54 5f 44 69 73 63 61 72 64 20 20 20 20 20 20 34 T_Discard 4
18880 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 73 61 76 65 /* Do not save
18890 20 74 68 65 20 72 65 73 75 6c 74 73 20 61 6e 79 the results any
188a0 77 68 65 72 65 20 2a 2f 0a 23 64 65 66 69 6e 65 where */.#define
188b0 20 53 52 54 5f 46 69 66 6f 20 20 20 20 20 20 20 SRT_Fifo
188c0 20 20 35 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 5 /* Store re
188d0 73 75 6c 74 20 61 73 20 64 61 74 61 20 77 69 74 sult as data wit
188e0 68 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 72 h an automatic r
188f0 6f 77 69 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 owid */.#define
18900 53 52 54 5f 44 69 73 74 46 69 66 6f 20 20 20 20 SRT_DistFifo
18910 20 36 20 20 2f 2a 20 4c 69 6b 65 20 53 52 54 5f 6 /* Like SRT_
18920 46 69 66 6f 2c 20 62 75 74 20 75 6e 69 71 75 65 Fifo, but unique
18930 20 72 65 73 75 6c 74 73 20 6f 6e 6c 79 20 2a 2f results only */
18940 0a 23 64 65 66 69 6e 65 20 53 52 54 5f 51 75 65 .#define SRT_Que
18950 75 65 20 20 20 20 20 20 20 20 37 20 20 2f 2a 20 ue 7 /*
18960 53 74 6f 72 65 20 72 65 73 75 6c 74 20 69 6e 20 Store result in
18970 61 6e 20 71 75 65 75 65 20 2a 2f 0a 23 64 65 66 an queue */.#def
18980 69 6e 65 20 53 52 54 5f 44 69 73 74 51 75 65 75 ine SRT_DistQueu
18990 65 20 20 20 20 38 20 20 2f 2a 20 4c 69 6b 65 20 e 8 /* Like
189a0 53 52 54 5f 51 75 65 75 65 2c 20 62 75 74 20 75 SRT_Queue, but u
189b0 6e 69 71 75 65 20 72 65 73 75 6c 74 73 20 6f 6e nique results on
189c0 6c 79 20 2a 2f 0a 0a 2f 2a 20 54 68 65 20 4f 52 ly */../* The OR
189d0 44 45 52 20 42 59 20 63 6c 61 75 73 65 20 69 73 DER BY clause is
189e0 20 69 67 6e 6f 72 65 64 20 66 6f 72 20 61 6c 6c ignored for all
189f0 20 6f 66 20 74 68 65 20 61 62 6f 76 65 20 2a 2f of the above */
18a00 0a 23 64 65 66 69 6e 65 20 49 67 6e 6f 72 61 62 .#define Ignorab
18a10 6c 65 4f 72 64 65 72 62 79 28 58 29 20 28 28 58 leOrderby(X) ((X
18a20 2d 3e 65 44 65 73 74 29 3c 3d 53 52 54 5f 44 69 ->eDest)<=SRT_Di
18a30 73 74 51 75 65 75 65 29 0a 0a 23 64 65 66 69 6e stQueue)..#defin
18a40 65 20 53 52 54 5f 4f 75 74 70 75 74 20 20 20 20 e SRT_Output
18a50 20 20 20 39 20 20 2f 2a 20 4f 75 74 70 75 74 20 9 /* Output
18a60 65 61 63 68 20 72 6f 77 20 6f 66 20 72 65 73 75 each row of resu
18a70 6c 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 lt */.#define SR
18a80 54 5f 4d 65 6d 20 20 20 20 20 20 20 20 20 31 30 T_Mem 10
18a90 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c /* Store resul
18aa0 74 20 69 6e 20 61 20 6d 65 6d 6f 72 79 20 63 65 t in a memory ce
18ab0 6c 6c 20 2a 2f 0a 23 64 65 66 69 6e 65 20 53 52 ll */.#define SR
18ac0 54 5f 53 65 74 20 20 20 20 20 20 20 20 20 31 31 T_Set 11
18ad0 20 20 2f 2a 20 53 74 6f 72 65 20 72 65 73 75 6c /* Store resul
18ae0 74 73 20 61 73 20 6b 65 79 73 20 69 6e 20 61 6e ts as keys in an
18af0 20 69 6e 64 65 78 20 2a 2f 0a 23 64 65 66 69 6e index */.#defin
18b00 65 20 53 52 54 5f 45 70 68 65 6d 54 61 62 20 20 e SRT_EphemTab
18b10 20 20 31 32 20 20 2f 2a 20 43 72 65 61 74 65 20 12 /* Create
18b20 74 72 61 6e 73 69 65 6e 74 20 74 61 62 20 61 6e transient tab an
18b30 64 20 73 74 6f 72 65 20 6c 69 6b 65 20 53 52 54 d store like SRT
18b40 5f 54 61 62 6c 65 20 2a 2f 0a 23 64 65 66 69 6e _Table */.#defin
18b50 65 20 53 52 54 5f 43 6f 72 6f 75 74 69 6e 65 20 e SRT_Coroutine
18b60 20 20 31 33 20 20 2f 2a 20 47 65 6e 65 72 61 74 13 /* Generat
18b70 65 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f e a single row o
18b80 66 20 72 65 73 75 6c 74 20 2a 2f 0a 23 64 65 66 f result */.#def
18b90 69 6e 65 20 53 52 54 5f 54 61 62 6c 65 20 20 20 ine SRT_Table
18ba0 20 20 20 20 31 34 20 20 2f 2a 20 53 74 6f 72 65 14 /* Store
18bb0 20 72 65 73 75 6c 74 20 61 73 20 64 61 74 61 20 result as data
18bc0 77 69 74 68 20 61 6e 20 61 75 74 6f 6d 61 74 69 with an automati
18bd0 63 20 72 6f 77 69 64 20 2a 2f 0a 0a 2f 2a 0a 2a c rowid */../*.*
18be0 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 * An instance of
18bf0 20 74 68 69 73 20 6f 62 6a 65 63 74 20 64 65 73 this object des
18c00 63 72 69 62 65 73 20 77 68 65 72 65 20 74 6f 20 cribes where to
18c10 70 75 74 20 6f 66 20 74 68 65 20 72 65 73 75 6c put of the resul
18c20 74 73 20 6f 66 0a 2a 2a 20 61 20 53 45 4c 45 43 ts of.** a SELEC
18c30 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a T statement..*/.
18c40 73 74 72 75 63 74 20 53 65 6c 65 63 74 44 65 73 struct SelectDes
18c50 74 20 7b 0a 20 20 75 38 20 65 44 65 73 74 3b 20 t {. u8 eDest;
18c60 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48 6f /* Ho
18c70 77 20 74 6f 20 64 69 73 70 6f 73 65 20 6f 66 20 w to dispose of
18c80 74 68 65 20 72 65 73 75 6c 74 73 2e 20 20 4f 6e the results. On
18c90 20 6f 66 20 53 52 54 5f 2a 20 61 62 6f 76 65 2e of SRT_* above.
18ca0 20 2a 2f 0a 20 20 63 68 61 72 20 61 66 66 53 64 */. char affSd
18cb0 73 74 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 66 st; /* Af
18cc0 66 69 6e 69 74 79 20 75 73 65 64 20 77 68 65 6e finity used when
18cd0 20 65 44 65 73 74 3d 3d 53 52 54 5f 53 65 74 20 eDest==SRT_Set
18ce0 2a 2f 0a 20 20 69 6e 74 20 69 53 44 50 61 72 6d */. int iSDParm
18cf0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 70 ; /* A p
18d00 61 72 61 6d 65 74 65 72 20 75 73 65 64 20 62 79 arameter used by
18d10 20 74 68 65 20 65 44 65 73 74 20 64 69 73 70 6f the eDest dispo
18d20 73 61 6c 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 20 sal method */.
18d30 69 6e 74 20 69 53 64 73 74 3b 20 20 20 20 20 20 int iSdst;
18d40 20 20 20 20 20 2f 2a 20 42 61 73 65 20 72 65 67 /* Base reg
18d50 69 73 74 65 72 20 77 68 65 72 65 20 72 65 73 75 ister where resu
18d60 6c 74 73 20 61 72 65 20 77 72 69 74 74 65 6e 20 lts are written
18d70 2a 2f 0a 20 20 69 6e 74 20 6e 53 64 73 74 3b 20 */. int nSdst;
18d80 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
18d90 62 65 72 20 6f 66 20 72 65 67 69 73 74 65 72 73 ber of registers
18da0 20 61 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 allocated */.
18db0 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 64 65 72 ExprList *pOrder
18dc0 42 79 3b 20 20 2f 2a 20 4b 65 79 20 63 6f 6c 75 By; /* Key colu
18dd0 6d 6e 73 20 66 6f 72 20 53 52 54 5f 51 75 65 75 mns for SRT_Queu
18de0 65 20 61 6e 64 20 53 52 54 5f 44 69 73 74 51 75 e and SRT_DistQu
18df0 65 75 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a eue */.};../*.**
18e00 20 44 75 72 69 6e 67 20 63 6f 64 65 20 67 65 6e During code gen
18e10 65 72 61 74 69 6f 6e 20 6f 66 20 73 74 61 74 65 eration of state
18e20 6d 65 6e 74 73 20 74 68 61 74 20 64 6f 20 69 6e ments that do in
18e30 73 65 72 74 73 20 69 6e 74 6f 20 41 55 54 4f 49 serts into AUTOI
18e40 4e 43 52 45 4d 45 4e 54 20 0a 2a 2a 20 74 61 62 NCREMENT .** tab
18e50 6c 65 73 2c 20 74 68 65 20 66 6f 6c 6c 6f 77 69 les, the followi
18e60 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69 ng information i
18e70 73 20 61 74 74 61 63 68 65 64 20 74 6f 20 74 68 s attached to th
18e80 65 20 54 61 62 6c 65 2e 75 2e 61 75 74 6f 49 6e e Table.u.autoIn
18e90 63 2e 70 0a 2a 2a 20 70 6f 69 6e 74 65 72 20 6f c.p.** pointer o
18ea0 66 20 65 61 63 68 20 61 75 74 6f 69 6e 63 72 65 f each autoincre
18eb0 6d 65 6e 74 20 74 61 62 6c 65 20 74 6f 20 72 65 ment table to re
18ec0 63 6f 72 64 20 73 6f 6d 65 20 73 69 64 65 20 69 cord some side i
18ed0 6e 66 6f 72 6d 61 74 69 6f 6e 20 74 68 61 74 0a nformation that.
18ee0 2a 2a 20 74 68 65 20 63 6f 64 65 20 67 65 6e 65 ** the code gene
18ef0 72 61 74 6f 72 20 6e 65 65 64 73 2e 20 20 57 65 rator needs. We
18f00 20 68 61 76 65 20 74 6f 20 6b 65 65 70 20 70 65 have to keep pe
18f10 72 2d 74 61 62 6c 65 20 61 75 74 6f 69 6e 63 72 r-table autoincr
18f20 65 6d 65 6e 74 0a 2a 2a 20 69 6e 66 6f 72 6d 61 ement.** informa
18f30 74 69 6f 6e 20 69 6e 20 63 61 73 65 20 69 6e 73 tion in case ins
18f40 65 72 74 73 20 61 72 65 20 64 6f 77 6e 20 77 69 erts are down wi
18f50 74 68 69 6e 20 74 72 69 67 67 65 72 73 2e 20 20 thin triggers.
18f60 54 72 69 67 67 65 72 73 20 64 6f 20 6e 6f 74 0a Triggers do not.
18f70 2a 2a 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6f 72 ** normally coor
18f80 64 69 6e 61 74 65 20 74 68 65 69 72 20 61 63 74 dinate their act
18f90 69 76 69 74 69 65 73 2c 20 62 75 74 20 77 65 20 ivities, but we
18fa0 64 6f 20 6e 65 65 64 20 74 6f 20 63 6f 6f 72 64 do need to coord
18fb0 69 6e 61 74 65 20 74 68 65 0a 2a 2a 20 6c 6f 61 inate the.** loa
18fc0 64 69 6e 67 20 61 6e 64 20 73 61 76 69 6e 67 20 ding and saving
18fd0 6f 66 20 61 75 74 6f 69 6e 63 72 65 6d 65 6e 74 of autoincrement
18fe0 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2f information..*/
18ff0 0a 73 74 72 75 63 74 20 41 75 74 6f 69 6e 63 49 .struct AutoincI
19000 6e 66 6f 20 7b 0a 20 20 41 75 74 6f 69 6e 63 49 nfo {. AutoincI
19010 6e 66 6f 20 2a 70 4e 65 78 74 3b 20 20 20 2f 2a nfo *pNext; /*
19020 20 4e 65 78 74 20 69 6e 66 6f 20 62 6c 6f 63 6b Next info block
19030 20 69 6e 20 61 20 6c 69 73 74 20 6f 66 20 74 68 in a list of th
19040 65 6d 20 61 6c 6c 20 2a 2f 0a 20 20 54 61 62 6c em all */. Tabl
19050 65 20 2a 70 54 61 62 3b 20 20 20 20 20 20 20 20 e *pTab;
19060 20 20 2f 2a 20 54 61 62 6c 65 20 74 68 69 73 20 /* Table this
19070 69 6e 66 6f 20 62 6c 6f 63 6b 20 72 65 66 65 72 info block refer
19080 73 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 44 s to */. int iD
19090 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b;
190a0 2f 2a 20 49 6e 64 65 78 20 69 6e 20 73 71 6c 69 /* Index in sqli
190b0 74 65 33 2e 61 44 62 5b 5d 20 6f 66 20 64 61 74 te3.aDb[] of dat
190c0 61 62 61 73 65 20 68 6f 6c 64 69 6e 67 20 70 54 abase holding pT
190d0 61 62 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 43 ab */. int regC
190e0 74 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a tr; /*
190f0 20 4d 65 6d 6f 72 79 20 72 65 67 69 73 74 65 72 Memory register
19100 20 68 6f 6c 64 69 6e 67 20 74 68 65 20 72 6f 77 holding the row
19110 69 64 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 7d 3b id counter */.};
19120 0a 0a 2f 2a 0a 2a 2a 20 53 69 7a 65 20 6f 66 20 ../*.** Size of
19130 74 68 65 20 63 6f 6c 75 6d 6e 20 63 61 63 68 65 the column cache
19140 0a 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 .*/.#ifndef SQLI
19150 54 45 5f 4e 5f 43 4f 4c 43 41 43 48 45 0a 23 20 TE_N_COLCACHE.#
19160 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 4e 5f define SQLITE_N_
19170 43 4f 4c 43 41 43 48 45 20 31 30 0a 23 65 6e 64 COLCACHE 10.#end
19180 69 66 0a 0a 2f 2a 0a 2a 2a 20 41 74 20 6c 65 61 if../*.** At lea
19190 73 74 20 6f 6e 65 20 69 6e 73 74 61 6e 63 65 20 st one instance
191a0 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
191b0 20 73 74 72 75 63 74 75 72 65 20 69 73 20 63 72 structure is cr
191c0 65 61 74 65 64 20 66 6f 72 20 65 61 63 68 20 0a eated for each .
191d0 2a 2a 20 74 72 69 67 67 65 72 20 74 68 61 74 20 ** trigger that
191e0 6d 61 79 20 62 65 20 66 69 72 65 64 20 77 68 69 may be fired whi
191f0 6c 65 20 70 61 72 73 69 6e 67 20 61 6e 20 49 4e le parsing an IN
19200 53 45 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20 SERT, UPDATE or
19210 44 45 4c 45 54 45 0a 2a 2a 20 73 74 61 74 65 6d DELETE.** statem
19220 65 6e 74 2e 20 41 6c 6c 20 73 75 63 68 20 6f 62 ent. All such ob
19230 6a 65 63 74 73 20 61 72 65 20 73 74 6f 72 65 64 jects are stored
19240 20 69 6e 20 74 68 65 20 6c 69 6e 6b 65 64 20 6c in the linked l
19250 69 73 74 20 68 65 61 64 65 64 20 61 74 0a 2a 2a ist headed at.**
19260 20 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 Parse.pTriggerP
19270 72 67 20 61 6e 64 20 64 65 6c 65 74 65 64 20 6f rg and deleted o
19280 6e 63 65 20 73 74 61 74 65 6d 65 6e 74 20 63 6f nce statement co
19290 6d 70 69 6c 61 74 69 6f 6e 20 68 61 73 20 62 65 mpilation has be
192a0 65 6e 0a 2a 2a 20 63 6f 6d 70 6c 65 74 65 64 2e en.** completed.
192b0 0a 2a 2a 0a 2a 2a 20 41 20 56 64 62 65 20 73 75 .**.** A Vdbe su
192c0 62 2d 70 72 6f 67 72 61 6d 20 74 68 61 74 20 69 b-program that i
192d0 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 62 6f mplements the bo
192e0 64 79 20 61 6e 64 20 57 48 45 4e 20 63 6c 61 75 dy and WHEN clau
192f0 73 65 20 6f 66 20 74 72 69 67 67 65 72 0a 2a 2a se of trigger.**
19300 20 54 72 69 67 67 65 72 50 72 67 2e 70 54 72 69 TriggerPrg.pTri
19310 67 67 65 72 2c 20 61 73 73 75 6d 69 6e 67 20 61 gger, assuming a
19320 20 64 65 66 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 default ON CONF
19330 4c 49 43 54 20 63 6c 61 75 73 65 20 6f 66 0a 2a LICT clause of.*
19340 2a 20 54 72 69 67 67 65 72 50 72 67 2e 6f 72 63 * TriggerPrg.orc
19350 6f 6e 66 2c 20 69 73 20 73 74 6f 72 65 64 20 69 onf, is stored i
19360 6e 20 74 68 65 20 54 72 69 67 67 65 72 50 72 67 n the TriggerPrg
19370 2e 70 50 72 6f 67 72 61 6d 20 76 61 72 69 61 62 .pProgram variab
19380 6c 65 2e 0a 2a 2a 20 54 68 65 20 50 61 72 73 65 le..** The Parse
19390 2e 70 54 72 69 67 67 65 72 50 72 67 20 6c 69 73 .pTriggerPrg lis
193a0 74 20 6e 65 76 65 72 20 63 6f 6e 74 61 69 6e 73 t never contains
193b0 20 74 77 6f 20 65 6e 74 72 69 65 73 20 77 69 74 two entries wit
193c0 68 20 74 68 65 20 73 61 6d 65 0a 2a 2a 20 76 61 h the same.** va
193d0 6c 75 65 73 20 66 6f 72 20 62 6f 74 68 20 70 54 lues for both pT
193e0 72 69 67 67 65 72 20 61 6e 64 20 6f 72 63 6f 6e rigger and orcon
193f0 66 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 54 72 69 f..**.** The Tri
19400 67 67 65 72 50 72 67 2e 61 43 6f 6c 6d 61 73 6b ggerPrg.aColmask
19410 5b 30 5d 20 76 61 72 69 61 62 6c 65 20 69 73 20 [0] variable is
19420 73 65 74 20 74 6f 20 61 20 6d 61 73 6b 20 6f 66 set to a mask of
19430 20 6f 6c 64 2e 2a 20 63 6f 6c 75 6d 6e 73 0a 2a old.* columns.*
19440 2a 20 61 63 63 65 73 73 65 64 20 28 6f 72 20 73 * accessed (or s
19450 65 74 20 74 6f 20 30 20 66 6f 72 20 74 72 69 67 et to 0 for trig
19460 67 65 72 73 20 66 69 72 65 64 20 61 73 20 61 20 gers fired as a
19470 72 65 73 75 6c 74 20 6f 66 20 49 4e 53 45 52 54 result of INSERT
19480 20 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 73 29 .** statements)
19490 2e 20 53 69 6d 69 6c 61 72 6c 79 2c 20 74 68 65 . Similarly, the
194a0 20 54 72 69 67 67 65 72 50 72 67 2e 61 43 6f 6c TriggerPrg.aCol
194b0 6d 61 73 6b 5b 31 5d 20 76 61 72 69 61 62 6c 65 mask[1] variable
194c0 20 69 73 20 73 65 74 20 74 6f 0a 2a 2a 20 61 20 is set to.** a
194d0 6d 61 73 6b 20 6f 66 20 6e 65 77 2e 2a 20 63 6f mask of new.* co
194e0 6c 75 6d 6e 73 20 75 73 65 64 20 62 79 20 74 68 lumns used by th
194f0 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 73 74 e program..*/.st
19500 72 75 63 74 20 54 72 69 67 67 65 72 50 72 67 20 ruct TriggerPrg
19510 7b 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 72 {. Trigger *pTr
19520 69 67 67 65 72 3b 20 20 20 20 20 20 2f 2a 20 54 igger; /* T
19530 72 69 67 67 65 72 20 74 68 69 73 20 70 72 6f 67 rigger this prog
19540 72 61 6d 20 77 61 73 20 63 6f 64 65 64 20 66 72 ram was coded fr
19550 6f 6d 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 50 om */. TriggerP
19560 72 67 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 rg *pNext;
19570 2f 2a 20 4e 65 78 74 20 65 6e 74 72 79 20 69 6e /* Next entry in
19580 20 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 Parse.pTriggerP
19590 72 67 20 6c 69 73 74 20 2a 2f 0a 20 20 53 75 62 rg list */. Sub
195a0 50 72 6f 67 72 61 6d 20 2a 70 50 72 6f 67 72 61 Program *pProgra
195b0 6d 3b 20 20 20 2f 2a 20 50 72 6f 67 72 61 6d 20 m; /* Program
195c0 69 6d 70 6c 65 6d 65 6e 74 69 6e 67 20 70 54 72 implementing pTr
195d0 69 67 67 65 72 2f 6f 72 63 6f 6e 66 20 2a 2f 0a igger/orconf */.
195e0 20 20 69 6e 74 20 6f 72 63 6f 6e 66 3b 20 20 20 int orconf;
195f0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 /* Def
19600 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 ault ON CONFLICT
19610 20 70 6f 6c 69 63 79 20 2a 2f 0a 20 20 75 33 32 policy */. u32
19620 20 61 43 6f 6c 6d 61 73 6b 5b 32 5d 3b 20 20 20 aColmask[2];
19630 20 20 20 20 20 2f 2a 20 4d 61 73 6b 73 20 6f 66 /* Masks of
19640 20 6f 6c 64 2e 2a 2c 20 6e 65 77 2e 2a 20 63 6f old.*, new.* co
19650 6c 75 6d 6e 73 20 61 63 63 65 73 73 65 64 20 2a lumns accessed *
19660 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 /.};../*.** The
19670 79 44 62 4d 61 73 6b 20 64 61 74 61 74 79 70 65 yDbMask datatype
19680 20 66 6f 72 20 74 68 65 20 62 69 74 6d 61 73 6b for the bitmask
19690 20 6f 66 20 61 6c 6c 20 61 74 74 61 63 68 65 64 of all attached
196a0 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a 23 databases..*/.#
196b0 69 66 20 53 51 4c 49 54 45 5f 4d 41 58 5f 41 54 if SQLITE_MAX_AT
196c0 54 41 43 48 45 44 3e 33 30 0a 20 20 74 79 70 65 TACHED>30. type
196d0 64 65 66 20 73 71 6c 69 74 65 33 5f 75 69 6e 74 def sqlite3_uint
196e0 36 34 20 79 44 62 4d 61 73 6b 3b 0a 23 65 6c 73 64 yDbMask;.#els
196f0 65 0a 20 20 74 79 70 65 64 65 66 20 75 6e 73 69 e. typedef unsi
19700 67 6e 65 64 20 69 6e 74 20 79 44 62 4d 61 73 6b gned int yDbMask
19710 3b 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ;.#endif../*.**
19720 41 6e 20 53 51 4c 20 70 61 72 73 65 72 20 63 6f An SQL parser co
19730 6e 74 65 78 74 2e 20 20 41 20 63 6f 70 79 20 6f ntext. A copy o
19740 66 20 74 68 69 73 20 73 74 72 75 63 74 75 72 65 f this structure
19750 20 69 73 20 70 61 73 73 65 64 20 74 68 72 6f 75 is passed throu
19760 67 68 0a 2a 2a 20 74 68 65 20 70 61 72 73 65 72 gh.** the parser
19770 20 61 6e 64 20 64 6f 77 6e 20 69 6e 74 6f 20 61 and down into a
19780 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 61 63 ll the parser ac
19790 74 69 6f 6e 20 72 6f 75 74 69 6e 65 20 69 6e 20 tion routine in
197a0 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 63 61 72 72 order to.** carr
197b0 79 20 61 72 6f 75 6e 64 20 69 6e 66 6f 72 6d 61 y around informa
197c0 74 69 6f 6e 20 74 68 61 74 20 69 73 20 67 6c 6f tion that is glo
197d0 62 61 6c 20 74 6f 20 74 68 65 20 65 6e 74 69 72 bal to the entir
197e0 65 20 70 61 72 73 65 2e 0a 2a 2a 0a 2a 2a 20 54 e parse..**.** T
197f0 68 65 20 73 74 72 75 63 74 75 72 65 20 69 73 20 he structure is
19800 64 69 76 69 64 65 64 20 69 6e 74 6f 20 74 77 6f divided into two
19810 20 70 61 72 74 73 2e 20 20 57 68 65 6e 20 74 68 parts. When th
19820 65 20 70 61 72 73 65 72 20 61 6e 64 20 63 6f 64 e parser and cod
19830 65 0a 2a 2a 20 67 65 6e 65 72 61 74 65 20 63 61 e.** generate ca
19840 6c 6c 20 74 68 65 6d 73 65 6c 76 65 73 20 72 65 ll themselves re
19850 63 75 72 73 69 76 65 6c 79 2c 20 74 68 65 20 66 cursively, the f
19860 69 72 73 74 20 70 61 72 74 20 6f 66 20 74 68 65 irst part of the
19870 20 73 74 72 75 63 74 75 72 65 0a 2a 2a 20 69 73 structure.** is
19880 20 63 6f 6e 73 74 61 6e 74 20 62 75 74 20 74 68 constant but th
19890 65 20 73 65 63 6f 6e 64 20 70 61 72 74 20 69 73 e second part is
198a0 20 72 65 73 65 74 20 61 74 20 74 68 65 20 62 65 reset at the be
198b0 67 69 6e 6e 69 6e 67 20 61 6e 64 20 65 6e 64 20 ginning and end
198c0 6f 66 0a 2a 2a 20 65 61 63 68 20 72 65 63 75 72 of.** each recur
198d0 73 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 sion..**.** The
198e0 6e 54 61 62 6c 65 4c 6f 63 6b 20 61 6e 64 20 61 nTableLock and a
198f0 54 61 62 6c 65 4c 6f 63 6b 20 76 61 72 69 61 62 TableLock variab
19900 6c 65 73 20 61 72 65 20 6f 6e 6c 79 20 75 73 65 les are only use
19910 64 20 69 66 20 74 68 65 20 73 68 61 72 65 64 2d d if the shared-
19920 63 61 63 68 65 20 0a 2a 2a 20 66 65 61 74 75 72 cache .** featur
19930 65 20 69 73 20 65 6e 61 62 6c 65 64 20 28 69 66 e is enabled (if
19940 20 73 71 6c 69 74 65 33 54 73 64 28 29 2d 3e 75 sqlite3Tsd()->u
19950 73 65 53 68 61 72 65 64 44 61 74 61 20 69 73 20 seSharedData is
19960 74 72 75 65 29 2e 20 54 68 65 79 20 61 72 65 0a true). They are.
19970 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 ** used to store
19980 20 74 68 65 20 73 65 74 20 6f 66 20 74 61 62 6c the set of tabl
19990 65 2d 6c 6f 63 6b 73 20 72 65 71 75 69 72 65 64 e-locks required
199a0 20 62 79 20 74 68 65 20 73 74 61 74 65 6d 65 6e by the statemen
199b0 74 20 62 65 69 6e 67 0a 2a 2a 20 63 6f 6d 70 69 t being.** compi
199c0 6c 65 64 2e 20 46 75 6e 63 74 69 6f 6e 20 73 71 led. Function sq
199d0 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 29 lite3TableLock()
199e0 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 64 20 is used to add
199f0 65 6e 74 72 69 65 73 20 74 6f 20 74 68 65 0a 2a entries to the.*
19a00 2a 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74 72 75 63 * list..*/.struc
19a10 74 20 50 61 72 73 65 20 7b 0a 20 20 73 71 6c 69 t Parse {. sqli
19a20 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 te3 *db;
19a30 20 2f 2a 20 54 68 65 20 6d 61 69 6e 20 64 61 74 /* The main dat
19a40 61 62 61 73 65 20 73 74 72 75 63 74 75 72 65 20 abase structure
19a50 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d */. char *zErrM
19a60 73 67 3b 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 sg; /* An
19a70 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a 2f error message */
19a80 0a 20 20 56 64 62 65 20 2a 70 56 64 62 65 3b 20 . Vdbe *pVdbe;
19a90 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 65 6e /* An en
19aa0 67 69 6e 65 20 66 6f 72 20 65 78 65 63 75 74 69 gine for executi
19ab0 6e 67 20 64 61 74 61 62 61 73 65 20 62 79 74 65 ng database byte
19ac0 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 code */. int rc
19ad0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f ; /
19ae0 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 66 72 * Return code fr
19af0 6f 6d 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f 0a om execution */.
19b00 20 20 75 38 20 63 6f 6c 4e 61 6d 65 73 53 65 74 u8 colNamesSet
19b10 3b 20 20 20 20 20 20 2f 2a 20 54 52 55 45 20 61 ; /* TRUE a
19b20 66 74 65 72 20 4f 50 5f 43 6f 6c 75 6d 6e 4e 61 fter OP_ColumnNa
19b30 6d 65 20 68 61 73 20 62 65 65 6e 20 69 73 73 75 me has been issu
19b40 65 64 20 74 6f 20 70 56 64 62 65 20 2a 2f 0a 20 ed to pVdbe */.
19b50 20 75 38 20 63 68 65 63 6b 53 63 68 65 6d 61 3b u8 checkSchema;
19b60 20 20 20 20 20 20 2f 2a 20 43 61 75 73 65 73 20 /* Causes
19b70 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20 63 68 schema cookie ch
19b80 65 63 6b 20 61 66 74 65 72 20 61 6e 20 65 72 72 eck after an err
19b90 6f 72 20 2a 2f 0a 20 20 75 38 20 6e 65 73 74 65 or */. u8 neste
19ba0 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 d; /*
19bb0 4e 75 6d 62 65 72 20 6f 66 20 6e 65 73 74 65 64 Number of nested
19bc0 20 63 61 6c 6c 73 20 74 6f 20 74 68 65 20 70 61 calls to the pa
19bd0 72 73 65 72 2f 63 6f 64 65 20 67 65 6e 65 72 61 rser/code genera
19be0 74 6f 72 20 2a 2f 0a 20 20 75 38 20 6e 54 65 6d tor */. u8 nTem
19bf0 70 52 65 67 3b 20 20 20 20 20 20 20 20 20 2f 2a pReg; /*
19c00 20 4e 75 6d 62 65 72 20 6f 66 20 74 65 6d 70 6f Number of tempo
19c10 72 61 72 79 20 72 65 67 69 73 74 65 72 73 20 69 rary registers i
19c20 6e 20 61 54 65 6d 70 52 65 67 5b 5d 20 2a 2f 0a n aTempReg[] */.
19c30 20 20 75 38 20 69 73 4d 75 6c 74 69 57 72 69 74 u8 isMultiWrit
19c40 65 3b 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 e; /* True i
19c50 66 20 73 74 61 74 65 6d 65 6e 74 20 6d 61 79 20 f statement may
19c60 6d 6f 64 69 66 79 2f 69 6e 73 65 72 74 20 6d 75 modify/insert mu
19c70 6c 74 69 70 6c 65 20 72 6f 77 73 20 2a 2f 0a 20 ltiple rows */.
19c80 20 75 38 20 6d 61 79 41 62 6f 72 74 3b 20 20 20 u8 mayAbort;
19c90 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
19ca0 20 73 74 61 74 65 6d 65 6e 74 20 6d 61 79 20 74 statement may t
19cb0 68 72 6f 77 20 61 6e 20 41 42 4f 52 54 20 65 78 hrow an ABORT ex
19cc0 63 65 70 74 69 6f 6e 20 2a 2f 0a 20 20 75 38 20 ception */. u8
19cd0 68 61 73 43 6f 6d 70 6f 75 6e 64 3b 20 20 20 20 hasCompound;
19ce0 20 20 2f 2a 20 4e 65 65 64 20 74 6f 20 69 6e 76 /* Need to inv
19cf0 6f 6b 65 20 63 6f 6e 76 65 72 74 43 6f 6d 70 6f oke convertCompo
19d00 75 6e 64 53 65 6c 65 63 74 54 6f 53 75 62 71 75 undSelectToSubqu
19d10 65 72 79 28 29 20 2a 2f 0a 20 20 75 38 20 6f 6b ery() */. u8 ok
19d20 43 6f 6e 73 74 46 61 63 74 6f 72 3b 20 20 20 20 ConstFactor;
19d30 2f 2a 20 4f 4b 20 74 6f 20 66 61 63 74 6f 72 20 /* OK to factor
19d40 6f 75 74 20 63 6f 6e 73 74 61 6e 74 73 20 2a 2f out constants */
19d50 0a 20 20 69 6e 74 20 61 54 65 6d 70 52 65 67 5b . int aTempReg[
19d60 38 5d 3b 20 20 20 20 20 2f 2a 20 48 6f 6c 64 69 8]; /* Holdi
19d70 6e 67 20 61 72 65 61 20 66 6f 72 20 74 65 6d 70 ng area for temp
19d80 6f 72 61 72 79 20 72 65 67 69 73 74 65 72 73 20 orary registers
19d90 2a 2f 0a 20 20 69 6e 74 20 6e 52 61 6e 67 65 52 */. int nRangeR
19da0 65 67 3b 20 20 20 20 20 20 20 2f 2a 20 53 69 7a eg; /* Siz
19db0 65 20 6f 66 20 74 68 65 20 74 65 6d 70 6f 72 61 e of the tempora
19dc0 72 79 20 72 65 67 69 73 74 65 72 20 62 6c 6f 63 ry register bloc
19dd0 6b 20 2a 2f 0a 20 20 69 6e 74 20 69 52 61 6e 67 k */. int iRang
19de0 65 52 65 67 3b 20 20 20 20 20 20 20 2f 2a 20 46 eReg; /* F
19df0 69 72 73 74 20 72 65 67 69 73 74 65 72 20 69 6e irst register in
19e00 20 74 65 6d 70 6f 72 61 72 79 20 72 65 67 69 73 temporary regis
19e10 74 65 72 20 62 6c 6f 63 6b 20 2a 2f 0a 20 20 69 ter block */. i
19e20 6e 74 20 6e 45 72 72 3b 20 20 20 20 20 20 20 20 nt nErr;
19e30 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
19e40 20 65 72 72 6f 72 73 20 73 65 65 6e 20 2a 2f 0a errors seen */.
19e50 20 20 69 6e 74 20 6e 54 61 62 3b 20 20 20 20 20 int nTab;
19e60 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
19e70 20 6f 66 20 70 72 65 76 69 6f 75 73 6c 79 20 61 of previously a
19e80 6c 6c 6f 63 61 74 65 64 20 56 44 42 45 20 63 75 llocated VDBE cu
19e90 72 73 6f 72 73 20 2a 2f 0a 20 20 69 6e 74 20 6e rsors */. int n
19ea0 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 Mem;
19eb0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6d 65 6d /* Number of mem
19ec0 6f 72 79 20 63 65 6c 6c 73 20 75 73 65 64 20 73 ory cells used s
19ed0 6f 20 66 61 72 20 2a 2f 0a 20 20 69 6e 74 20 6e o far */. int n
19ee0 53 65 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 Set;
19ef0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 65 74 /* Number of set
19f00 73 20 75 73 65 64 20 73 6f 20 66 61 72 20 2a 2f s used so far */
19f10 0a 20 20 69 6e 74 20 6e 4f 6e 63 65 3b 20 20 20 . int nOnce;
19f20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
19f30 72 20 6f 66 20 4f 50 5f 4f 6e 63 65 20 69 6e 73 r of OP_Once ins
19f40 74 72 75 63 74 69 6f 6e 73 20 73 6f 20 66 61 72 tructions so far
19f50 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 70 41 6c 6c */. int nOpAll
19f60 6f 63 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 oc; /* Nu
19f70 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 61 6c mber of slots al
19f80 6c 6f 63 61 74 65 64 20 66 6f 72 20 56 64 62 65 located for Vdbe
19f90 2e 61 4f 70 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 .aOp[] */. int
19fa0 69 46 69 78 65 64 4f 70 3b 20 20 20 20 20 20 20 iFixedOp;
19fb0 20 2f 2a 20 4e 65 76 65 72 20 62 61 63 6b 20 6f /* Never back o
19fc0 75 74 20 6f 70 63 6f 64 65 73 20 69 46 69 78 65 ut opcodes iFixe
19fd0 64 4f 70 2d 31 20 6f 72 20 65 61 72 6c 69 65 72 dOp-1 or earlier
19fe0 20 2a 2f 0a 20 20 69 6e 74 20 63 6b 42 61 73 65 */. int ckBase
19ff0 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 61 ; /* Ba
1a000 73 65 20 72 65 67 69 73 74 65 72 20 6f 66 20 64 se register of d
1a010 61 74 61 20 64 75 72 69 6e 67 20 63 68 65 63 6b ata during check
1a020 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
1a030 20 20 69 6e 74 20 69 50 61 72 74 49 64 78 54 61 int iPartIdxTa
1a040 62 3b 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 b; /* Table
1a050 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f corresponding to
1a060 20 61 20 70 61 72 74 69 61 6c 20 69 6e 64 65 78 a partial index
1a070 20 2a 2f 0a 20 20 69 6e 74 20 69 43 61 63 68 65 */. int iCache
1a080 4c 65 76 65 6c 3b 20 20 20 20 20 2f 2a 20 43 6f Level; /* Co
1a090 6c 43 61 63 68 65 20 76 61 6c 69 64 20 77 68 65 lCache valid whe
1a0a0 6e 20 61 43 6f 6c 43 61 63 68 65 5b 5d 2e 69 4c n aColCache[].iL
1a0b0 65 76 65 6c 3c 3d 69 43 61 63 68 65 4c 65 76 65 evel<=iCacheLeve
1a0c0 6c 20 2a 2f 0a 20 20 69 6e 74 20 69 43 61 63 68 l */. int iCach
1a0d0 65 43 6e 74 3b 20 20 20 20 20 20 20 2f 2a 20 43 eCnt; /* C
1a0e0 6f 75 6e 74 65 72 20 75 73 65 64 20 74 6f 20 67 ounter used to g
1a0f0 65 6e 65 72 61 74 65 20 61 43 6f 6c 43 61 63 68 enerate aColCach
1a100 65 5b 5d 2e 6c 72 75 20 76 61 6c 75 65 73 20 2a e[].lru values *
1a110 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 65 6c 3b 20 /. int nLabel;
1a120 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1a130 65 72 20 6f 66 20 6c 61 62 65 6c 73 20 75 73 65 er of labels use
1a140 64 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 4c 61 62 d */. int *aLab
1a150 65 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 53 el; /* S
1a160 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 pace to hold the
1a170 20 6c 61 62 65 6c 73 20 2a 2f 0a 20 20 73 74 72 labels */. str
1a180 75 63 74 20 79 43 6f 6c 43 61 63 68 65 20 7b 0a uct yColCache {.
1a190 20 20 20 20 69 6e 74 20 69 54 61 62 6c 65 3b 20 int iTable;
1a1a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 /* Tab
1a1b0 6c 65 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 72 le cursor number
1a1c0 20 2a 2f 0a 20 20 20 20 69 31 36 20 69 43 6f 6c */. i16 iCol
1a1d0 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 20 2f 2a umn; /*
1a1e0 20 54 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 6e 75 Table column nu
1a1f0 6d 62 65 72 20 2a 2f 0a 20 20 20 20 75 38 20 74 mber */. u8 t
1a200 65 6d 70 52 65 67 3b 20 20 20 20 20 20 20 20 20 empReg;
1a210 20 20 2f 2a 20 69 52 65 67 20 69 73 20 61 20 74 /* iReg is a t
1a220 65 6d 70 20 72 65 67 69 73 74 65 72 20 74 68 61 emp register tha
1a230 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 66 72 t needs to be fr
1a240 65 65 64 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 eed */. int i
1a250 4c 65 76 65 6c 3b 20 20 20 20 20 20 20 20 20 20 Level;
1a260 20 2f 2a 20 4e 65 73 74 69 6e 67 20 6c 65 76 65 /* Nesting leve
1a270 6c 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 52 65 l */. int iRe
1a280 67 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f g; /
1a290 2a 20 52 65 67 20 77 69 74 68 20 76 61 6c 75 65 * Reg with value
1a2a0 20 6f 66 20 74 68 69 73 20 63 6f 6c 75 6d 6e 2e of this column.
1a2b0 20 30 20 6d 65 61 6e 73 20 6e 6f 6e 65 2e 20 2a 0 means none. *
1a2c0 2f 0a 20 20 20 20 69 6e 74 20 6c 72 75 3b 20 20 /. int lru;
1a2d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c /* L
1a2e0 65 61 73 74 20 72 65 63 65 6e 74 6c 79 20 75 73 east recently us
1a2f0 65 64 20 65 6e 74 72 79 20 68 61 73 20 74 68 65 ed entry has the
1a300 20 73 6d 61 6c 6c 65 73 74 20 76 61 6c 75 65 20 smallest value
1a310 2a 2f 0a 20 20 7d 20 61 43 6f 6c 43 61 63 68 65 */. } aColCache
1a320 5b 53 51 4c 49 54 45 5f 4e 5f 43 4f 4c 43 41 43 [SQLITE_N_COLCAC
1a330 48 45 5d 3b 20 20 2f 2a 20 4f 6e 65 20 66 6f 72 HE]; /* One for
1a340 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 63 61 63 each column cac
1a350 68 65 20 65 6e 74 72 79 20 2a 2f 0a 20 20 45 78 he entry */. Ex
1a360 70 72 4c 69 73 74 20 2a 70 43 6f 6e 73 74 45 78 prList *pConstEx
1a370 70 72 3b 2f 2a 20 43 6f 6e 73 74 61 6e 74 20 65 pr;/* Constant e
1a380 78 70 72 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 xpressions */.
1a390 54 6f 6b 65 6e 20 63 6f 6e 73 74 72 61 69 6e 74 Token constraint
1a3a0 4e 61 6d 65 3b 2f 2a 20 4e 61 6d 65 20 6f 66 20 Name;/* Name of
1a3b0 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 the constraint c
1a3c0 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20 70 urrently being p
1a3d0 61 72 73 65 64 20 2a 2f 0a 20 20 79 44 62 4d 61 arsed */. yDbMa
1a3e0 73 6b 20 77 72 69 74 65 4d 61 73 6b 3b 20 20 20 sk writeMask;
1a3f0 2f 2a 20 53 74 61 72 74 20 61 20 77 72 69 74 65 /* Start a write
1a400 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 6e 20 transaction on
1a410 74 68 65 73 65 20 64 61 74 61 62 61 73 65 73 20 these databases
1a420 2a 2f 0a 20 20 79 44 62 4d 61 73 6b 20 63 6f 6f */. yDbMask coo
1a430 6b 69 65 4d 61 73 6b 3b 20 20 2f 2a 20 42 69 74 kieMask; /* Bit
1a440 6d 61 73 6b 20 6f 66 20 73 63 68 65 6d 61 20 76 mask of schema v
1a450 65 72 69 66 69 65 64 20 64 61 74 61 62 61 73 65 erified database
1a460 73 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 s */. int cooki
1a470 65 56 61 6c 75 65 5b 53 51 4c 49 54 45 5f 4d 41 eValue[SQLITE_MA
1a480 58 5f 41 54 54 41 43 48 45 44 2b 32 5d 3b 20 20 X_ATTACHED+2];
1a490 2f 2a 20 56 61 6c 75 65 73 20 6f 66 20 63 6f 6f /* Values of coo
1a4a0 6b 69 65 73 20 74 6f 20 76 65 72 69 66 79 20 2a kies to verify *
1a4b0 2f 0a 20 20 69 6e 74 20 72 65 67 52 6f 77 69 64 /. int regRowid
1a4c0 3b 20 20 20 20 20 20 20 20 2f 2a 20 52 65 67 69 ; /* Regi
1a4d0 73 74 65 72 20 68 6f 6c 64 69 6e 67 20 72 6f 77 ster holding row
1a4e0 69 64 20 6f 66 20 43 52 45 41 54 45 20 54 41 42 id of CREATE TAB
1a4f0 4c 45 20 65 6e 74 72 79 20 2a 2f 0a 20 20 69 6e LE entry */. in
1a500 74 20 72 65 67 52 6f 6f 74 3b 20 20 20 20 20 20 t regRoot;
1a510 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 20 68 /* Register h
1a520 6f 6c 64 69 6e 67 20 72 6f 6f 74 20 70 61 67 65 olding root page
1a530 20 6e 75 6d 62 65 72 20 66 6f 72 20 6e 65 77 20 number for new
1a540 6f 62 6a 65 63 74 73 20 2a 2f 0a 20 20 69 6e 74 objects */. int
1a550 20 6e 4d 61 78 41 72 67 3b 20 20 20 20 20 20 20 nMaxArg;
1a560 20 20 2f 2a 20 4d 61 78 20 61 72 67 73 20 70 61 /* Max args pa
1a570 73 73 65 64 20 74 6f 20 75 73 65 72 20 66 75 6e ssed to user fun
1a580 63 74 69 6f 6e 20 62 79 20 73 75 62 2d 70 72 6f ction by sub-pro
1a590 67 72 61 6d 20 2a 2f 0a 23 69 66 6e 64 65 66 20 gram */.#ifndef
1a5a0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 SQLITE_OMIT_SHAR
1a5b0 45 44 5f 43 41 43 48 45 0a 20 20 69 6e 74 20 6e ED_CACHE. int n
1a5c0 54 61 62 6c 65 4c 6f 63 6b 3b 20 20 20 20 20 20 TableLock;
1a5d0 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c /* Number of l
1a5e0 6f 63 6b 73 20 69 6e 20 61 54 61 62 6c 65 4c 6f ocks in aTableLo
1a5f0 63 6b 20 2a 2f 0a 20 20 54 61 62 6c 65 4c 6f 63 ck */. TableLoc
1a600 6b 20 2a 61 54 61 62 6c 65 4c 6f 63 6b 3b 20 2f k *aTableLock; /
1a610 2a 20 52 65 71 75 69 72 65 64 20 74 61 62 6c 65 * Required table
1a620 20 6c 6f 63 6b 73 20 66 6f 72 20 73 68 61 72 65 locks for share
1a630 64 2d 63 61 63 68 65 20 6d 6f 64 65 20 2a 2f 0a d-cache mode */.
1a640 23 65 6e 64 69 66 0a 20 20 41 75 74 6f 69 6e 63 #endif. Autoinc
1a650 49 6e 66 6f 20 2a 70 41 69 6e 63 3b 20 20 2f 2a Info *pAinc; /*
1a660 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f Information abo
1a670 75 74 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 ut AUTOINCREMENT
1a680 20 63 6f 75 6e 74 65 72 73 20 2a 2f 0a 0a 20 20 counters */..
1a690 2f 2a 20 49 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 /* Information u
1a6a0 73 65 64 20 77 68 69 6c 65 20 63 6f 64 69 6e 67 sed while coding
1a6b0 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d trigger program
1a6c0 73 2e 20 2a 2f 0a 20 20 50 61 72 73 65 20 2a 70 s. */. Parse *p
1a6d0 54 6f 70 6c 65 76 65 6c 3b 20 20 20 20 2f 2a 20 Toplevel; /*
1a6e0 50 61 72 73 65 20 73 74 72 75 63 74 75 72 65 20 Parse structure
1a6f0 66 6f 72 20 6d 61 69 6e 20 70 72 6f 67 72 61 6d for main program
1a700 20 28 6f 72 20 4e 55 4c 4c 29 20 2a 2f 0a 20 20 (or NULL) */.
1a710 54 61 62 6c 65 20 2a 70 54 72 69 67 67 65 72 54 Table *pTriggerT
1a720 61 62 3b 20 20 2f 2a 20 54 61 62 6c 65 20 74 72 ab; /* Table tr
1a730 69 67 67 65 72 73 20 61 72 65 20 62 65 69 6e 67 iggers are being
1a740 20 63 6f 64 65 64 20 66 6f 72 20 2a 2f 0a 20 20 coded for */.
1a750 69 6e 74 20 61 64 64 72 43 72 54 61 62 3b 20 20 int addrCrTab;
1a760 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 /* Address
1a770 6f 66 20 4f 50 5f 43 72 65 61 74 65 54 61 62 6c of OP_CreateTabl
1a780 65 20 6f 70 63 6f 64 65 20 6f 6e 20 43 52 45 41 e opcode on CREA
1a790 54 45 20 54 41 42 4c 45 20 2a 2f 0a 20 20 69 6e TE TABLE */. in
1a7a0 74 20 61 64 64 72 53 6b 69 70 50 4b 3b 20 20 20 t addrSkipPK;
1a7b0 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 /* Address of
1a7c0 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f 20 instruction to
1a7d0 73 6b 69 70 20 50 52 49 4d 41 52 59 20 4b 45 59 skip PRIMARY KEY
1a7e0 20 69 6e 64 65 78 20 2a 2f 0a 20 20 75 33 32 20 index */. u32
1a7f0 6e 51 75 65 72 79 4c 6f 6f 70 3b 20 20 20 20 20 nQueryLoop;
1a800 20 2f 2a 20 45 73 74 20 6e 75 6d 62 65 72 20 6f /* Est number o
1a810 66 20 69 74 65 72 61 74 69 6f 6e 73 20 6f 66 20 f iterations of
1a820 61 20 71 75 65 72 79 20 28 31 30 2a 6c 6f 67 32 a query (10*log2
1a830 28 4e 29 29 20 2a 2f 0a 20 20 75 33 32 20 6f 6c (N)) */. u32 ol
1a840 64 6d 61 73 6b 3b 20 20 20 20 20 20 20 20 20 2f dmask; /
1a850 2a 20 4d 61 73 6b 20 6f 66 20 6f 6c 64 2e 2a 20 * Mask of old.*
1a860 63 6f 6c 75 6d 6e 73 20 72 65 66 65 72 65 6e 63 columns referenc
1a870 65 64 20 2a 2f 0a 20 20 75 33 32 20 6e 65 77 6d ed */. u32 newm
1a880 61 73 6b 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ask; /*
1a890 4d 61 73 6b 20 6f 66 20 6e 65 77 2e 2a 20 63 6f Mask of new.* co
1a8a0 6c 75 6d 6e 73 20 72 65 66 65 72 65 6e 63 65 64 lumns referenced
1a8b0 20 2a 2f 0a 20 20 75 38 20 65 54 72 69 67 67 65 */. u8 eTrigge
1a8c0 72 4f 70 3b 20 20 20 20 20 20 20 2f 2a 20 54 4b rOp; /* TK
1a8d0 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e 53 45 _UPDATE, TK_INSE
1a8e0 52 54 20 6f 72 20 54 4b 5f 44 45 4c 45 54 45 20 RT or TK_DELETE
1a8f0 2a 2f 0a 20 20 75 38 20 65 4f 72 63 6f 6e 66 3b */. u8 eOrconf;
1a900 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 /* Def
1a910 61 75 6c 74 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 ault ON CONFLICT
1a920 20 70 6f 6c 69 63 79 20 66 6f 72 20 74 72 69 67 policy for trig
1a930 67 65 72 20 73 74 65 70 73 20 2a 2f 0a 20 20 75 ger steps */. u
1a940 38 20 64 69 73 61 62 6c 65 54 72 69 67 67 65 72 8 disableTrigger
1a950 73 3b 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 64 s; /* True to d
1a960 69 73 61 62 6c 65 20 74 72 69 67 67 65 72 73 20 isable triggers
1a970 2a 2f 0a 0a 20 20 2f 2a 2a 2a 2a 2a 2a 2a 2a 2a */.. /*********
1a980 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1a990 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1a9a0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1a9b0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a ***************.
1a9c0 20 20 2a 2a 20 41 62 6f 76 65 20 69 73 20 63 6f ** Above is co
1a9d0 6e 73 74 61 6e 74 20 62 65 74 77 65 65 6e 20 72 nstant between r
1a9e0 65 63 75 72 73 69 6f 6e 73 2e 20 20 42 65 6c 6f ecursions. Belo
1a9f0 77 20 69 73 20 72 65 73 65 74 20 62 65 66 6f 72 w is reset befor
1aa00 65 20 61 6e 64 20 61 66 74 65 72 0a 20 20 2a 2a e and after. **
1aa10 20 65 61 63 68 20 72 65 63 75 72 73 69 6f 6e 2e each recursion.
1aa20 20 20 54 68 65 20 62 6f 75 6e 64 61 72 79 20 62 The boundary b
1aa30 65 74 77 65 65 6e 20 74 68 65 73 65 20 74 77 6f etween these two
1aa40 20 72 65 67 69 6f 6e 73 20 69 73 20 64 65 74 65 regions is dete
1aa50 72 6d 69 6e 65 64 0a 20 20 2a 2a 20 75 73 69 6e rmined. ** usin
1aa60 67 20 6f 66 66 73 65 74 6f 66 28 50 61 72 73 65 g offsetof(Parse
1aa70 2c 6e 56 61 72 29 20 73 6f 20 74 68 65 20 6e 56 ,nVar) so the nV
1aa80 61 72 20 66 69 65 6c 64 20 6d 75 73 74 20 62 65 ar field must be
1aa90 20 74 68 65 20 66 69 72 73 74 20 66 69 65 6c 64 the first field
1aaa0 0a 20 20 2a 2a 20 69 6e 20 74 68 65 20 72 65 63 . ** in the rec
1aab0 75 72 73 69 76 65 20 72 65 67 69 6f 6e 2e 0a 20 ursive region..
1aac0 20 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ***************
1aad0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1aae0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1aaf0 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
1ab00 2a 2a 2a 2a 2a 2a 2a 2a 2a 2f 0a 0a 20 20 69 6e *********/.. in
1ab10 74 20 6e 56 61 72 3b 20 20 20 20 20 20 20 20 20 t nVar;
1ab20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
1ab30 72 20 6f 66 20 27 3f 27 20 76 61 72 69 61 62 6c r of '?' variabl
1ab40 65 73 20 73 65 65 6e 20 69 6e 20 74 68 65 20 53 es seen in the S
1ab50 51 4c 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 69 QL so far */. i
1ab60 6e 74 20 6e 7a 56 61 72 3b 20 20 20 20 20 20 20 nt nzVar;
1ab70 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1ab80 65 72 20 6f 66 20 61 76 61 69 6c 61 62 6c 65 20 er of available
1ab90 73 6c 6f 74 73 20 69 6e 20 61 7a 56 61 72 5b 5d slots in azVar[]
1aba0 20 2a 2f 0a 20 20 75 38 20 69 50 6b 53 6f 72 74 */. u8 iPkSort
1abb0 4f 72 64 65 72 3b 20 20 20 20 20 20 20 20 20 20 Order;
1abc0 2f 2a 20 41 53 43 20 6f 72 20 44 45 53 43 20 66 /* ASC or DESC f
1abd0 6f 72 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 or INTEGER PRIMA
1abe0 52 59 20 4b 45 59 20 2a 2f 0a 20 20 75 38 20 62 RY KEY */. u8 b
1abf0 46 72 65 65 57 69 74 68 3b 20 20 20 20 20 20 20 FreeWith;
1ac00 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 /* True if
1ac10 20 70 57 69 74 68 20 73 68 6f 75 6c 64 20 62 65 pWith should be
1ac20 20 66 72 65 65 64 20 77 69 74 68 20 70 61 72 73 freed with pars
1ac30 65 72 20 2a 2f 0a 20 20 75 38 20 65 78 70 6c 61 er */. u8 expla
1ac40 69 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 in;
1ac50 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 /* True if the
1ac60 20 45 58 50 4c 41 49 4e 20 66 6c 61 67 20 69 73 EXPLAIN flag is
1ac70 20 66 6f 75 6e 64 20 6f 6e 20 74 68 65 20 71 75 found on the qu
1ac80 65 72 79 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 ery */.#ifndef S
1ac90 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 QLITE_OMIT_VIRTU
1aca0 41 4c 54 41 42 4c 45 0a 20 20 75 38 20 64 65 63 ALTABLE. u8 dec
1acb0 6c 61 72 65 56 74 61 62 3b 20 20 20 20 20 20 20 lareVtab;
1acc0 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 69 /* True if i
1acd0 6e 73 69 64 65 20 73 71 6c 69 74 65 33 5f 64 65 nside sqlite3_de
1ace0 63 6c 61 72 65 5f 76 74 61 62 28 29 20 2a 2f 0a clare_vtab() */.
1acf0 20 20 69 6e 74 20 6e 56 74 61 62 4c 6f 63 6b 3b int nVtabLock;
1ad00 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1ad10 75 6d 62 65 72 20 6f 66 20 76 69 72 74 75 61 6c umber of virtual
1ad20 20 74 61 62 6c 65 73 20 74 6f 20 6c 6f 63 6b 20 tables to lock
1ad30 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e 74 20 */.#endif. int
1ad40 6e 41 6c 69 61 73 3b 20 20 20 20 20 20 20 20 20 nAlias;
1ad50 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
1ad60 6f 66 20 61 6c 69 61 73 65 64 20 72 65 73 75 6c of aliased resul
1ad70 74 20 73 65 74 20 63 6f 6c 75 6d 6e 73 20 2a 2f t set columns */
1ad80 0a 20 20 69 6e 74 20 6e 48 65 69 67 68 74 3b 20 . int nHeight;
1ad90 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1ada0 45 78 70 72 65 73 73 69 6f 6e 20 74 72 65 65 20 Expression tree
1adb0 68 65 69 67 68 74 20 6f 66 20 63 75 72 72 65 6e height of curren
1adc0 74 20 73 75 62 2d 73 65 6c 65 63 74 20 2a 2f 0a t sub-select */.
1add0 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
1ade0 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69 6e MIT_EXPLAIN. in
1adf0 74 20 69 53 65 6c 65 63 74 49 64 3b 20 20 20 20 t iSelectId;
1ae00 20 20 20 20 20 20 20 20 2f 2a 20 49 44 20 6f 66 /* ID of
1ae10 20 63 75 72 72 65 6e 74 20 73 65 6c 65 63 74 20 current select
1ae20 66 6f 72 20 45 58 50 4c 41 49 4e 20 6f 75 74 70 for EXPLAIN outp
1ae30 75 74 20 2a 2f 0a 20 20 69 6e 74 20 69 4e 65 78 ut */. int iNex
1ae40 74 53 65 6c 65 63 74 49 64 3b 20 20 20 20 20 20 tSelectId;
1ae50 20 20 2f 2a 20 4e 65 78 74 20 61 76 61 69 6c 61 /* Next availa
1ae60 62 6c 65 20 73 65 6c 65 63 74 20 49 44 20 66 6f ble select ID fo
1ae70 72 20 45 58 50 4c 41 49 4e 20 6f 75 74 70 75 74 r EXPLAIN output
1ae80 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 63 68 61 */.#endif. cha
1ae90 72 20 2a 2a 61 7a 56 61 72 3b 20 20 20 20 20 20 r **azVar;
1aea0 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 /* Pointe
1aeb0 72 73 20 74 6f 20 6e 61 6d 65 73 20 6f 66 20 70 rs to names of p
1aec0 61 72 61 6d 65 74 65 72 73 20 2a 2f 0a 20 20 56 arameters */. V
1aed0 64 62 65 20 2a 70 52 65 70 72 65 70 61 72 65 3b dbe *pReprepare;
1aee0 20 20 20 20 20 20 20 20 20 2f 2a 20 56 4d 20 62 /* VM b
1aef0 65 69 6e 67 20 72 65 70 72 65 70 61 72 65 64 20 eing reprepared
1af00 28 73 71 6c 69 74 65 33 52 65 70 72 65 70 61 72 (sqlite3Reprepar
1af10 65 28 29 29 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 e()) */. const
1af20 63 68 61 72 20 2a 7a 54 61 69 6c 3b 20 20 20 20 char *zTail;
1af30 20 20 20 20 2f 2a 20 41 6c 6c 20 53 51 4c 20 74 /* All SQL t
1af40 65 78 74 20 70 61 73 74 20 74 68 65 20 6c 61 73 ext past the las
1af50 74 20 73 65 6d 69 63 6f 6c 6f 6e 20 70 61 72 73 t semicolon pars
1af60 65 64 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 ed */. Table *p
1af70 4e 65 77 54 61 62 6c 65 3b 20 20 20 20 20 20 20 NewTable;
1af80 20 20 2f 2a 20 41 20 74 61 62 6c 65 20 62 65 69 /* A table bei
1af90 6e 67 20 63 6f 6e 73 74 72 75 63 74 65 64 20 62 ng constructed b
1afa0 79 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 2a y CREATE TABLE *
1afb0 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 4e 65 /. Trigger *pNe
1afc0 77 54 72 69 67 67 65 72 3b 20 20 20 20 20 2f 2a wTrigger; /*
1afd0 20 54 72 69 67 67 65 72 20 75 6e 64 65 72 20 63 Trigger under c
1afe0 6f 6e 73 74 72 75 63 74 20 62 79 20 61 20 43 52 onstruct by a CR
1aff0 45 41 54 45 20 54 52 49 47 47 45 52 20 2a 2f 0a EATE TRIGGER */.
1b000 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 41 const char *zA
1b010 75 74 68 43 6f 6e 74 65 78 74 3b 20 2f 2a 20 54 uthContext; /* T
1b020 68 65 20 36 74 68 20 70 61 72 61 6d 65 74 65 72 he 6th parameter
1b030 20 74 6f 20 64 62 2d 3e 78 41 75 74 68 20 63 61 to db->xAuth ca
1b040 6c 6c 62 61 63 6b 73 20 2a 2f 0a 20 20 54 6f 6b llbacks */. Tok
1b050 65 6e 20 73 4e 61 6d 65 54 6f 6b 65 6e 3b 20 20 en sNameToken;
1b060 20 20 20 20 20 20 20 2f 2a 20 54 6f 6b 65 6e 20 /* Token
1b070 77 69 74 68 20 75 6e 71 75 61 6c 69 66 69 65 64 with unqualified
1b080 20 73 63 68 65 6d 61 20 6f 62 6a 65 63 74 20 6e schema object n
1b090 61 6d 65 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 73 ame */. Token s
1b0a0 4c 61 73 74 54 6f 6b 65 6e 3b 20 20 20 20 20 20 LastToken;
1b0b0 20 20 20 2f 2a 20 54 68 65 20 6c 61 73 74 20 74 /* The last t
1b0c0 6f 6b 65 6e 20 70 61 72 73 65 64 20 2a 2f 0a 23 oken parsed */.#
1b0d0 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1b0e0 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
1b0f0 20 20 54 6f 6b 65 6e 20 73 41 72 67 3b 20 20 20 Token sArg;
1b100 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
1b110 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 20 omplete text of
1b120 61 20 6d 6f 64 75 6c 65 20 61 72 67 75 6d 65 6e a module argumen
1b130 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 2a 61 t */. Table **a
1b140 70 56 74 61 62 4c 6f 63 6b 3b 20 20 20 20 20 20 pVtabLock;
1b150 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 76 /* Pointer to v
1b160 69 72 74 75 61 6c 20 74 61 62 6c 65 73 20 6e 65 irtual tables ne
1b170 65 64 69 6e 67 20 6c 6f 63 6b 69 6e 67 20 2a 2f eding locking */
1b180 0a 23 65 6e 64 69 66 0a 20 20 54 61 62 6c 65 20 .#endif. Table
1b190 2a 70 5a 6f 6d 62 69 65 54 61 62 3b 20 20 20 20 *pZombieTab;
1b1a0 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f 66 20 54 /* List of T
1b1b0 61 62 6c 65 20 6f 62 6a 65 63 74 73 20 74 6f 20 able objects to
1b1c0 64 65 6c 65 74 65 20 61 66 74 65 72 20 63 6f 64 delete after cod
1b1d0 65 20 67 65 6e 20 2a 2f 0a 20 20 54 72 69 67 67 e gen */. Trigg
1b1e0 65 72 50 72 67 20 2a 70 54 72 69 67 67 65 72 50 erPrg *pTriggerP
1b1f0 72 67 3b 20 20 2f 2a 20 4c 69 6e 6b 65 64 20 6c rg; /* Linked l
1b200 69 73 74 20 6f 66 20 63 6f 64 65 64 20 74 72 69 ist of coded tri
1b210 67 67 65 72 73 20 2a 2f 0a 20 20 57 69 74 68 20 ggers */. With
1b220 2a 70 57 69 74 68 3b 20 20 20 20 20 20 20 20 20 *pWith;
1b230 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20 /* Current
1b240 57 49 54 48 20 63 6c 61 75 73 65 2c 20 6f 72 20 WITH clause, or
1b250 4e 55 4c 4c 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a NULL */.};../*.*
1b260 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 * Return true if
1b270 20 63 75 72 72 65 6e 74 6c 79 20 69 6e 73 69 64 currently insid
1b280 65 20 61 6e 20 73 71 6c 69 74 65 33 5f 64 65 63 e an sqlite3_dec
1b290 6c 61 72 65 5f 76 74 61 62 28 29 20 63 61 6c 6c lare_vtab() call
1b2a0 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 ..*/.#ifdef SQLI
1b2b0 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
1b2c0 41 42 4c 45 0a 20 20 23 64 65 66 69 6e 65 20 49 ABLE. #define I
1b2d0 4e 5f 44 45 43 4c 41 52 45 5f 56 54 41 42 20 30 N_DECLARE_VTAB 0
1b2e0 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
1b2f0 20 49 4e 5f 44 45 43 4c 41 52 45 5f 56 54 41 42 IN_DECLARE_VTAB
1b300 20 28 70 50 61 72 73 65 2d 3e 64 65 63 6c 61 72 (pParse->declar
1b310 65 56 74 61 62 29 0a 23 65 6e 64 69 66 0a 0a 2f eVtab).#endif../
1b320 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 65 *.** An instance
1b330 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
1b340 67 20 73 74 72 75 63 74 75 72 65 20 63 61 6e 20 g structure can
1b350 62 65 20 64 65 63 6c 61 72 65 64 20 6f 6e 20 61 be declared on a
1b360 20 73 74 61 63 6b 20 61 6e 64 20 75 73 65 64 0a stack and used.
1b370 2a 2a 20 74 6f 20 73 61 76 65 20 74 68 65 20 50 ** to save the P
1b380 61 72 73 65 2e 7a 41 75 74 68 43 6f 6e 74 65 78 arse.zAuthContex
1b390 74 20 76 61 6c 75 65 20 73 6f 20 74 68 61 74 20 t value so that
1b3a0 69 74 20 63 61 6e 20 62 65 20 72 65 73 74 6f 72 it can be restor
1b3b0 65 64 20 6c 61 74 65 72 2e 0a 2a 2f 0a 73 74 72 ed later..*/.str
1b3c0 75 63 74 20 41 75 74 68 43 6f 6e 74 65 78 74 20 uct AuthContext
1b3d0 7b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a {. const char *
1b3e0 7a 41 75 74 68 43 6f 6e 74 65 78 74 3b 20 20 20 zAuthContext;
1b3f0 2f 2a 20 50 75 74 20 73 61 76 65 64 20 50 61 72 /* Put saved Par
1b400 73 65 2e 7a 41 75 74 68 43 6f 6e 74 65 78 74 20 se.zAuthContext
1b410 68 65 72 65 20 2a 2f 0a 20 20 50 61 72 73 65 20 here */. Parse
1b420 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 20 20 *pParse;
1b430 20 20 20 20 20 20 2f 2a 20 54 68 65 20 50 61 72 /* The Par
1b440 73 65 20 73 74 72 75 63 74 75 72 65 20 2a 2f 0a se structure */.
1b450 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 42 69 74 66 69 65 };../*.** Bitfie
1b460 6c 64 20 66 6c 61 67 73 20 66 6f 72 20 50 35 20 ld flags for P5
1b470 76 61 6c 75 65 20 69 6e 20 76 61 72 69 6f 75 73 value in various
1b480 20 6f 70 63 6f 64 65 73 2e 0a 2a 2a 0a 2a 2a 20 opcodes..**.**
1b490 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 76 61 Note that the va
1b4a0 6c 75 65 73 20 66 6f 72 20 49 53 4e 4f 4f 50 20 lues for ISNOOP
1b4b0 61 6e 64 20 4c 45 4e 47 54 48 41 52 47 20 61 72 and LENGTHARG ar
1b4c0 65 20 74 68 65 20 73 61 6d 65 2e 20 20 42 75 74 e the same. But
1b4d0 20 61 73 20 0a 2a 2a 20 74 68 6f 73 65 20 62 69 as .** those bi
1b4e0 74 73 20 61 72 65 20 6e 65 76 65 72 20 75 73 65 ts are never use
1b4f0 64 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 6f 70 d on the same op
1b500 63 6f 64 65 2c 20 74 68 65 20 6f 76 65 72 6c 61 code, the overla
1b510 70 20 69 73 20 68 61 72 6d 6c 65 73 73 2e 0a 2a p is harmless..*
1b520 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 /.#define OPFLAG
1b530 5f 4e 43 48 41 4e 47 45 20 20 20 20 20 20 20 30 _NCHANGE 0
1b540 78 30 31 20 20 20 20 2f 2a 20 53 65 74 20 74 6f x01 /* Set to
1b550 20 75 70 64 61 74 65 20 64 62 2d 3e 6e 43 68 61 update db->nCha
1b560 6e 67 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f nge */.#define O
1b570 50 46 4c 41 47 5f 4c 41 53 54 52 4f 57 49 44 20 PFLAG_LASTROWID
1b580 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 20 53 0x02 /* S
1b590 65 74 20 74 6f 20 75 70 64 61 74 65 20 64 62 2d et to update db-
1b5a0 3e 6c 61 73 74 52 6f 77 69 64 20 2a 2f 0a 23 64 >lastRowid */.#d
1b5b0 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 49 53 55 efine OPFLAG_ISU
1b5c0 50 44 41 54 45 20 20 20 20 20 20 30 78 30 34 20 PDATE 0x04
1b5d0 20 20 20 2f 2a 20 54 68 69 73 20 4f 50 5f 49 6e /* This OP_In
1b5e0 73 65 72 74 20 69 73 20 61 6e 20 73 71 6c 20 55 sert is an sql U
1b5f0 50 44 41 54 45 20 2a 2f 0a 23 64 65 66 69 6e 65 PDATE */.#define
1b600 20 4f 50 46 4c 41 47 5f 41 50 50 45 4e 44 20 20 OPFLAG_APPEND
1b610 20 20 20 20 20 20 30 78 30 38 20 20 20 20 2f 2a 0x08 /*
1b620 20 54 68 69 73 20 69 73 20 6c 69 6b 65 6c 79 20 This is likely
1b630 74 6f 20 62 65 20 61 6e 20 61 70 70 65 6e 64 20 to be an append
1b640 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
1b650 47 5f 55 53 45 53 45 45 4b 52 45 53 55 4c 54 20 G_USESEEKRESULT
1b660 30 78 31 30 20 20 20 20 2f 2a 20 54 72 79 20 74 0x10 /* Try t
1b670 6f 20 61 76 6f 69 64 20 61 20 73 65 65 6b 20 69 o avoid a seek i
1b680 6e 20 42 74 72 65 65 49 6e 73 65 72 74 28 29 20 n BtreeInsert()
1b690 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
1b6a0 47 5f 43 4c 45 41 52 43 41 43 48 45 20 20 20 20 G_CLEARCACHE
1b6b0 30 78 32 30 20 20 20 20 2f 2a 20 43 6c 65 61 72 0x20 /* Clear
1b6c0 20 70 73 65 75 64 6f 2d 74 61 62 6c 65 20 63 61 pseudo-table ca
1b6d0 63 68 65 20 69 6e 20 4f 50 5f 43 6f 6c 75 6d 6e che in OP_Column
1b6e0 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c */.#define OPFL
1b6f0 41 47 5f 49 53 4e 4f 4f 50 20 20 20 20 20 20 20 AG_ISNOOP
1b700 20 30 78 34 30 20 20 20 20 2f 2a 20 4f 50 5f 44 0x40 /* OP_D
1b710 65 6c 65 74 65 20 64 6f 65 73 20 70 72 65 2d 75 elete does pre-u
1b720 70 64 61 74 65 2d 68 6f 6f 6b 20 6f 6e 6c 79 20 pdate-hook only
1b730 2a 2f 0a 23 64 65 66 69 6e 65 20 4f 50 46 4c 41 */.#define OPFLA
1b740 47 5f 4c 45 4e 47 54 48 41 52 47 20 20 20 20 20 G_LENGTHARG
1b750 30 78 34 30 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 0x40 /* OP_Co
1b760 6c 75 6d 6e 20 6f 6e 6c 79 20 75 73 65 64 20 66 lumn only used f
1b770 6f 72 20 6c 65 6e 67 74 68 28 29 20 2a 2f 0a 23 or length() */.#
1b780 64 65 66 69 6e 65 20 4f 50 46 4c 41 47 5f 54 59 define OPFLAG_TY
1b790 50 45 4f 46 41 52 47 20 20 20 20 20 30 78 38 30 PEOFARG 0x80
1b7a0 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c 75 6d 6e /* OP_Column
1b7b0 20 6f 6e 6c 79 20 75 73 65 64 20 66 6f 72 20 74 only used for t
1b7c0 79 70 65 6f 66 28 29 20 2a 2f 0a 23 64 65 66 69 ypeof() */.#defi
1b7d0 6e 65 20 4f 50 46 4c 41 47 5f 42 55 4c 4b 43 53 ne OPFLAG_BULKCS
1b7e0 52 20 20 20 20 20 20 20 30 78 30 31 20 20 20 20 R 0x01
1b7f0 2f 2a 20 4f 50 5f 4f 70 65 6e 2a 2a 20 75 73 65 /* OP_Open** use
1b800 64 20 74 6f 20 6f 70 65 6e 20 62 75 6c 6b 20 63 d to open bulk c
1b810 75 72 73 6f 72 20 2a 2f 0a 23 64 65 66 69 6e 65 ursor */.#define
1b820 20 4f 50 46 4c 41 47 5f 50 32 49 53 52 45 47 20 OPFLAG_P2ISREG
1b830 20 20 20 20 20 20 30 78 30 32 20 20 20 20 2f 2a 0x02 /*
1b840 20 50 32 20 74 6f 20 4f 50 5f 4f 70 65 6e 2a 2a P2 to OP_Open**
1b850 20 69 73 20 61 20 72 65 67 69 73 74 65 72 20 6e is a register n
1b860 75 6d 62 65 72 20 2a 2f 0a 23 64 65 66 69 6e 65 umber */.#define
1b870 20 4f 50 46 4c 41 47 5f 50 45 52 4d 55 54 45 20 OPFLAG_PERMUTE
1b880 20 20 20 20 20 20 30 78 30 31 20 20 20 20 2f 2a 0x01 /*
1b890 20 4f 50 5f 43 6f 6d 70 61 72 65 3a 20 75 73 65 OP_Compare: use
1b8a0 20 74 68 65 20 70 65 72 6d 75 74 61 74 69 6f 6e the permutation
1b8b0 20 2a 2f 0a 0a 2f 2a 0a 20 2a 20 45 61 63 68 20 */../*. * Each
1b8c0 74 72 69 67 67 65 72 20 70 72 65 73 65 6e 74 20 trigger present
1b8d0 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 in the database
1b8e0 73 63 68 65 6d 61 20 69 73 20 73 74 6f 72 65 64 schema is stored
1b8f0 20 61 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 20 as an instance
1b900 6f 66 0a 20 2a 20 73 74 72 75 63 74 20 54 72 69 of. * struct Tri
1b910 67 67 65 72 2e 20 0a 20 2a 0a 20 2a 20 50 6f 69 gger. . *. * Poi
1b920 6e 74 65 72 73 20 74 6f 20 69 6e 73 74 61 6e 63 nters to instanc
1b930 65 73 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 es of struct Tri
1b940 67 67 65 72 20 61 72 65 20 73 74 6f 72 65 64 20 gger are stored
1b950 69 6e 20 74 77 6f 20 77 61 79 73 2e 0a 20 2a 20 in two ways.. *
1b960 31 2e 20 49 6e 20 74 68 65 20 22 74 72 69 67 48 1. In the "trigH
1b970 61 73 68 22 20 68 61 73 68 20 74 61 62 6c 65 20 ash" hash table
1b980 28 70 61 72 74 20 6f 66 20 74 68 65 20 73 71 6c (part of the sql
1b990 69 74 65 33 2a 20 74 68 61 74 20 72 65 70 72 65 ite3* that repre
1b9a0 73 65 6e 74 73 20 74 68 65 20 0a 20 2a 20 20 20 sents the . *
1b9b0 20 64 61 74 61 62 61 73 65 29 2e 20 54 68 69 73 database). This
1b9c0 20 61 6c 6c 6f 77 73 20 54 72 69 67 67 65 72 20 allows Trigger
1b9d0 73 74 72 75 63 74 75 72 65 73 20 74 6f 20 62 65 structures to be
1b9e0 20 72 65 74 72 69 65 76 65 64 20 62 79 20 6e 61 retrieved by na
1b9f0 6d 65 2e 0a 20 2a 20 32 2e 20 41 6c 6c 20 74 72 me.. * 2. All tr
1ba00 69 67 67 65 72 73 20 61 73 73 6f 63 69 61 74 65 iggers associate
1ba10 64 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65 20 d with a single
1ba20 74 61 62 6c 65 20 66 6f 72 6d 20 61 20 6c 69 6e table form a lin
1ba30 6b 65 64 20 6c 69 73 74 2c 20 75 73 69 6e 67 20 ked list, using
1ba40 74 68 65 0a 20 2a 20 20 20 20 70 4e 65 78 74 20 the. * pNext
1ba50 6d 65 6d 62 65 72 20 6f 66 20 73 74 72 75 63 74 member of struct
1ba60 20 54 72 69 67 67 65 72 2e 20 41 20 70 6f 69 6e Trigger. A poin
1ba70 74 65 72 20 74 6f 20 74 68 65 20 66 69 72 73 74 ter to the first
1ba80 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 0a element of the.
1ba90 20 2a 20 20 20 20 6c 69 6e 6b 65 64 20 6c 69 73 * linked lis
1baa0 74 20 69 73 20 73 74 6f 72 65 64 20 61 73 20 74 t is stored as t
1bab0 68 65 20 22 70 54 72 69 67 67 65 72 22 20 6d 65 he "pTrigger" me
1bac0 6d 62 65 72 20 6f 66 20 74 68 65 20 61 73 73 6f mber of the asso
1bad0 63 69 61 74 65 64 0a 20 2a 20 20 20 20 73 74 72 ciated. * str
1bae0 75 63 74 20 54 61 62 6c 65 2e 0a 20 2a 0a 20 2a uct Table.. *. *
1baf0 20 54 68 65 20 22 73 74 65 70 5f 6c 69 73 74 22 The "step_list"
1bb00 20 6d 65 6d 62 65 72 20 70 6f 69 6e 74 73 20 74 member points t
1bb10 6f 20 74 68 65 20 66 69 72 73 74 20 65 6c 65 6d o the first elem
1bb20 65 6e 74 20 6f 66 20 61 20 6c 69 6e 6b 65 64 20 ent of a linked
1bb30 6c 69 73 74 0a 20 2a 20 63 6f 6e 74 61 69 6e 69 list. * containi
1bb40 6e 67 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 ng the SQL state
1bb50 6d 65 6e 74 73 20 73 70 65 63 69 66 69 65 64 20 ments specified
1bb60 61 73 20 74 68 65 20 74 72 69 67 67 65 72 20 70 as the trigger p
1bb70 72 6f 67 72 61 6d 2e 0a 20 2a 2f 0a 73 74 72 75 rogram.. */.stru
1bb80 63 74 20 54 72 69 67 67 65 72 20 7b 0a 20 20 63 ct Trigger {. c
1bb90 68 61 72 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 har *zName;
1bba0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 /* The na
1bbb0 6d 65 20 6f 66 20 74 68 65 20 74 72 69 67 67 65 me of the trigge
1bbc0 72 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 r
1bbd0 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 63 68 */. ch
1bbe0 61 72 20 2a 74 61 62 6c 65 3b 20 20 20 20 20 20 ar *table;
1bbf0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 61 62 /* The tab
1bc00 6c 65 20 6f 72 20 76 69 65 77 20 74 6f 20 77 68 le or view to wh
1bc10 69 63 68 20 74 68 65 20 74 72 69 67 67 65 72 20 ich the trigger
1bc20 61 70 70 6c 69 65 73 20 2a 2f 0a 20 20 75 38 20 applies */. u8
1bc30 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 op;
1bc40 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 /* One of T
1bc50 4b 5f 44 45 4c 45 54 45 2c 20 54 4b 5f 55 50 44 K_DELETE, TK_UPD
1bc60 41 54 45 2c 20 54 4b 5f 49 4e 53 45 52 54 20 20 ATE, TK_INSERT
1bc70 20 20 20 20 20 20 20 2a 2f 0a 20 20 75 38 20 74 */. u8 t
1bc80 72 5f 74 6d 3b 20 20 20 20 20 20 20 20 20 20 20 r_tm;
1bc90 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 54 52 /* One of TR
1bca0 49 47 47 45 52 5f 42 45 46 4f 52 45 2c 20 54 52 IGGER_BEFORE, TR
1bcb0 49 47 47 45 52 5f 41 46 54 45 52 20 2a 2f 0a 20 IGGER_AFTER */.
1bcc0 20 45 78 70 72 20 2a 70 57 68 65 6e 3b 20 20 20 Expr *pWhen;
1bcd0 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 /* The
1bce0 57 48 45 4e 20 63 6c 61 75 73 65 20 6f 66 20 74 WHEN clause of t
1bcf0 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 28 6d he expression (m
1bd00 61 79 20 62 65 20 4e 55 4c 4c 29 20 2a 2f 0a 20 ay be NULL) */.
1bd10 20 49 64 4c 69 73 74 20 2a 70 43 6f 6c 75 6d 6e IdList *pColumn
1bd20 73 3b 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 s; /* If t
1bd30 68 69 73 20 69 73 20 61 6e 20 55 50 44 41 54 45 his is an UPDATE
1bd40 20 4f 46 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 OF <column-list
1bd50 3e 20 74 72 69 67 67 65 72 2c 0a 20 20 20 20 20 > trigger,.
1bd60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1bd70 20 20 20 20 20 20 20 20 74 68 65 20 3c 63 6f 6c the <col
1bd80 75 6d 6e 2d 6c 69 73 74 3e 20 69 73 20 73 74 6f umn-list> is sto
1bd90 72 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 53 63 red here */. Sc
1bda0 68 65 6d 61 20 2a 70 53 63 68 65 6d 61 3b 20 20 hema *pSchema;
1bdb0 20 20 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 /* Schema
1bdc0 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 74 containing the t
1bdd0 72 69 67 67 65 72 20 2a 2f 0a 20 20 53 63 68 65 rigger */. Sche
1bde0 6d 61 20 2a 70 54 61 62 53 63 68 65 6d 61 3b 20 ma *pTabSchema;
1bdf0 20 20 20 20 2f 2a 20 53 63 68 65 6d 61 20 63 6f /* Schema co
1be00 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 74 61 62 ntaining the tab
1be10 6c 65 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 53 le */. TriggerS
1be20 74 65 70 20 2a 73 74 65 70 5f 6c 69 73 74 3b 20 tep *step_list;
1be30 2f 2a 20 4c 69 6e 6b 20 6c 69 73 74 20 6f 66 20 /* Link list of
1be40 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 20 trigger program
1be50 73 74 65 70 73 20 20 20 20 20 20 20 20 20 20 20 steps
1be60 20 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 2a */. Trigger *
1be70 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20 20 2f pNext; /
1be80 2a 20 4e 65 78 74 20 74 72 69 67 67 65 72 20 61 * Next trigger a
1be90 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74 ssociated with t
1bea0 68 65 20 74 61 62 6c 65 20 2a 2f 0a 7d 3b 0a 0a he table */.};..
1beb0 2f 2a 0a 2a 2a 20 41 20 74 72 69 67 67 65 72 20 /*.** A trigger
1bec0 69 73 20 65 69 74 68 65 72 20 61 20 42 45 46 4f is either a BEFO
1bed0 52 45 20 6f 72 20 61 6e 20 41 46 54 45 52 20 74 RE or an AFTER t
1bee0 72 69 67 67 65 72 2e 20 20 54 68 65 20 66 6f 6c rigger. The fol
1bef0 6c 6f 77 69 6e 67 20 63 6f 6e 73 74 61 6e 74 73 lowing constants
1bf00 0a 2a 2a 20 64 65 74 65 72 6d 69 6e 65 20 77 68 .** determine wh
1bf10 69 63 68 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 74 ich. .**.** If t
1bf20 68 65 72 65 20 61 72 65 20 6d 75 6c 74 69 70 6c here are multipl
1bf30 65 20 74 72 69 67 67 65 72 73 2c 20 79 6f 75 20 e triggers, you
1bf40 6d 69 67 68 74 20 6f 66 20 73 6f 6d 65 20 42 45 might of some BE
1bf50 46 4f 52 45 20 61 6e 64 20 73 6f 6d 65 20 41 46 FORE and some AF
1bf60 54 45 52 2e 0a 2a 2a 20 49 6e 20 74 68 61 74 20 TER..** In that
1bf70 63 61 73 65 73 2c 20 74 68 65 20 63 6f 6e 73 74 cases, the const
1bf80 61 6e 74 73 20 62 65 6c 6f 77 20 63 61 6e 20 62 ants below can b
1bf90 65 20 4f 52 65 64 20 74 6f 67 65 74 68 65 72 2e e ORed together.
1bfa0 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 54 52 49 47 .*/.#define TRIG
1bfb0 47 45 52 5f 42 45 46 4f 52 45 20 20 31 0a 23 64 GER_BEFORE 1.#d
1bfc0 65 66 69 6e 65 20 54 52 49 47 47 45 52 5f 41 46 efine TRIGGER_AF
1bfd0 54 45 52 20 20 20 32 0a 0a 2f 2a 0a 20 2a 20 41 TER 2../*. * A
1bfe0 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 73 74 n instance of st
1bff0 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 70 ruct TriggerStep
1c000 20 69 73 20 75 73 65 64 20 74 6f 20 73 74 6f 72 is used to stor
1c010 65 20 61 20 73 69 6e 67 6c 65 20 53 51 4c 20 73 e a single SQL s
1c020 74 61 74 65 6d 65 6e 74 0a 20 2a 20 74 68 61 74 tatement. * that
1c030 20 69 73 20 61 20 70 61 72 74 20 6f 66 20 61 20 is a part of a
1c040 74 72 69 67 67 65 72 2d 70 72 6f 67 72 61 6d 2e trigger-program.
1c050 20 0a 20 2a 0a 20 2a 20 49 6e 73 74 61 6e 63 65 . *. * Instance
1c060 73 20 6f 66 20 73 74 72 75 63 74 20 54 72 69 67 s of struct Trig
1c070 67 65 72 53 74 65 70 20 61 72 65 20 73 74 6f 72 gerStep are stor
1c080 65 64 20 69 6e 20 61 20 73 69 6e 67 6c 79 20 6c ed in a singly l
1c090 69 6e 6b 65 64 20 6c 69 73 74 20 28 6c 69 6e 6b inked list (link
1c0a0 65 64 0a 20 2a 20 75 73 69 6e 67 20 74 68 65 20 ed. * using the
1c0b0 22 70 4e 65 78 74 22 20 6d 65 6d 62 65 72 29 20 "pNext" member)
1c0c0 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 74 68 referenced by th
1c0d0 65 20 22 73 74 65 70 5f 6c 69 73 74 22 20 6d 65 e "step_list" me
1c0e0 6d 62 65 72 20 6f 66 20 74 68 65 20 0a 20 2a 20 mber of the . *
1c0f0 61 73 73 6f 63 69 61 74 65 64 20 73 74 72 75 63 associated struc
1c100 74 20 54 72 69 67 67 65 72 20 69 6e 73 74 61 6e t Trigger instan
1c110 63 65 2e 20 54 68 65 20 66 69 72 73 74 20 65 6c ce. The first el
1c120 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 6c 69 6e ement of the lin
1c130 6b 65 64 20 6c 69 73 74 20 69 73 0a 20 2a 20 74 ked list is. * t
1c140 68 65 20 66 69 72 73 74 20 73 74 65 70 20 6f 66 he first step of
1c150 20 74 68 65 20 74 72 69 67 67 65 72 2d 70 72 6f the trigger-pro
1c160 67 72 61 6d 2e 0a 20 2a 20 0a 20 2a 20 54 68 65 gram.. * . * The
1c170 20 22 6f 70 22 20 6d 65 6d 62 65 72 20 69 6e 64 "op" member ind
1c180 69 63 61 74 65 73 20 77 68 65 74 68 65 72 20 74 icates whether t
1c190 68 69 73 20 69 73 20 61 20 22 44 45 4c 45 54 45 his is a "DELETE
1c1a0 22 2c 20 22 49 4e 53 45 52 54 22 2c 20 22 55 50 ", "INSERT", "UP
1c1b0 44 41 54 45 22 20 6f 72 0a 20 2a 20 22 53 45 4c DATE" or. * "SEL
1c1c0 45 43 54 22 20 73 74 61 74 65 6d 65 6e 74 2e 20 ECT" statement.
1c1d0 54 68 65 20 6d 65 61 6e 69 6e 67 73 20 6f 66 20 The meanings of
1c1e0 74 68 65 20 6f 74 68 65 72 20 6d 65 6d 62 65 72 the other member
1c1f0 73 20 69 73 20 64 65 74 65 72 6d 69 6e 65 64 20 s is determined
1c200 62 79 20 74 68 65 20 0a 20 2a 20 76 61 6c 75 65 by the . * value
1c210 20 6f 66 20 22 6f 70 22 20 61 73 20 66 6f 6c 6c of "op" as foll
1c220 6f 77 73 3a 0a 20 2a 0a 20 2a 20 28 6f 70 20 3d ows:. *. * (op =
1c230 3d 20 54 4b 5f 49 4e 53 45 52 54 29 0a 20 2a 20 = TK_INSERT). *
1c240 6f 72 63 6f 6e 66 20 20 20 20 2d 3e 20 73 74 6f orconf -> sto
1c250 72 65 73 20 74 68 65 20 4f 4e 20 43 4f 4e 46 4c res the ON CONFL
1c260 49 43 54 20 61 6c 67 6f 72 69 74 68 6d 0a 20 2a ICT algorithm. *
1c270 20 70 53 65 6c 65 63 74 20 20 20 2d 3e 20 49 66 pSelect -> If
1c280 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45 this is an INSE
1c290 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 53 45 4c 45 RT INTO ... SELE
1c2a0 43 54 20 2e 2e 2e 20 73 74 61 74 65 6d 65 6e 74 CT ... statement
1c2b0 2c 20 74 68 65 6e 0a 20 2a 20 20 20 20 20 20 20 , then. *
1c2c0 20 20 20 20 20 20 20 74 68 69 73 20 73 74 6f 72 this stor
1c2d0 65 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 es a pointer to
1c2e0 74 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 the SELECT state
1c2f0 6d 65 6e 74 2e 20 4f 74 68 65 72 77 69 73 65 20 ment. Otherwise
1c300 4e 55 4c 4c 2e 0a 20 2a 20 74 61 72 67 65 74 20 NULL.. * target
1c310 20 20 20 2d 3e 20 41 20 74 6f 6b 65 6e 20 68 6f -> A token ho
1c320 6c 64 69 6e 67 20 74 68 65 20 71 75 6f 74 65 64 lding the quoted
1c330 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 name of the tab
1c340 6c 65 20 74 6f 20 69 6e 73 65 72 74 20 69 6e 74 le to insert int
1c350 6f 2e 0a 20 2a 20 70 45 78 70 72 4c 69 73 74 20 o.. * pExprList
1c360 2d 3e 20 49 66 20 74 68 69 73 20 69 73 20 61 6e -> If this is an
1c370 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 2e 2e 2e INSERT INTO ...
1c380 20 56 41 4c 55 45 53 20 2e 2e 2e 20 73 74 61 74 VALUES ... stat
1c390 65 6d 65 6e 74 2c 20 74 68 65 6e 0a 20 2a 20 20 ement, then. *
1c3a0 20 20 20 20 20 20 20 20 20 20 20 20 74 68 69 73 this
1c3b0 20 73 74 6f 72 65 73 20 76 61 6c 75 65 73 20 74 stores values t
1c3c0 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 20 4f o be inserted. O
1c3d0 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 therwise NULL..
1c3e0 2a 20 70 49 64 4c 69 73 74 20 20 20 2d 3e 20 49 * pIdList -> I
1c3f0 66 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 f this is an INS
1c400 45 52 54 20 49 4e 54 4f 20 2e 2e 2e 20 28 3c 63 ERT INTO ... (<c
1c410 6f 6c 75 6d 6e 2d 6e 61 6d 65 73 3e 29 20 56 41 olumn-names>) VA
1c420 4c 55 45 53 20 2e 2e 2e 20 0a 20 2a 20 20 20 20 LUES ... . *
1c430 20 20 20 20 20 20 20 20 20 20 73 74 61 74 65 6d statem
1c440 65 6e 74 2c 20 74 68 65 6e 20 74 68 69 73 20 73 ent, then this s
1c450 74 6f 72 65 73 20 74 68 65 20 63 6f 6c 75 6d 6e tores the column
1c460 2d 6e 61 6d 65 73 20 74 6f 20 62 65 0a 20 2a 20 -names to be. *
1c470 20 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 73 ins
1c480 65 72 74 65 64 20 69 6e 74 6f 2e 0a 20 2a 0a 20 erted into.. *.
1c490 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f 44 45 4c 45 * (op == TK_DELE
1c4a0 54 45 29 0a 20 2a 20 74 61 72 67 65 74 20 20 20 TE). * target
1c4b0 20 2d 3e 20 41 20 74 6f 6b 65 6e 20 68 6f 6c 64 -> A token hold
1c4c0 69 6e 67 20 74 68 65 20 71 75 6f 74 65 64 20 6e ing the quoted n
1c4d0 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 ame of the table
1c4e0 20 74 6f 20 64 65 6c 65 74 65 20 66 72 6f 6d 2e to delete from.
1c4f0 0a 20 2a 20 70 57 68 65 72 65 20 20 20 20 2d 3e . * pWhere ->
1c500 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 The WHERE claus
1c510 65 20 6f 66 20 74 68 65 20 44 45 4c 45 54 45 20 e of the DELETE
1c520 73 74 61 74 65 6d 65 6e 74 20 69 66 20 6f 6e 65 statement if one
1c530 20 69 73 20 73 70 65 63 69 66 69 65 64 2e 0a 20 is specified..
1c540 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4f * O
1c550 74 68 65 72 77 69 73 65 20 4e 55 4c 4c 2e 0a 20 therwise NULL..
1c560 2a 20 0a 20 2a 20 28 6f 70 20 3d 3d 20 54 4b 5f * . * (op == TK_
1c570 55 50 44 41 54 45 29 0a 20 2a 20 74 61 72 67 65 UPDATE). * targe
1c580 74 20 20 20 20 2d 3e 20 41 20 74 6f 6b 65 6e 20 t -> A token
1c590 68 6f 6c 64 69 6e 67 20 74 68 65 20 71 75 6f 74 holding the quot
1c5a0 65 64 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 ed name of the t
1c5b0 61 62 6c 65 20 74 6f 20 75 70 64 61 74 65 20 72 able to update r
1c5c0 6f 77 73 20 6f 66 2e 0a 20 2a 20 70 57 68 65 72 ows of.. * pWher
1c5d0 65 20 20 20 20 2d 3e 20 54 68 65 20 57 48 45 52 e -> The WHER
1c5e0 45 20 63 6c 61 75 73 65 20 6f 66 20 74 68 65 20 E clause of the
1c5f0 55 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 UPDATE statement
1c600 20 69 66 20 6f 6e 65 20 69 73 20 73 70 65 63 69 if one is speci
1c610 66 69 65 64 2e 0a 20 2a 20 20 20 20 20 20 20 20 fied.. *
1c620 20 20 20 20 20 20 4f 74 68 65 72 77 69 73 65 20 Otherwise
1c630 4e 55 4c 4c 2e 0a 20 2a 20 70 45 78 70 72 4c 69 NULL.. * pExprLi
1c640 73 74 20 2d 3e 20 41 20 6c 69 73 74 20 6f 66 20 st -> A list of
1c650 74 68 65 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 75 the columns to u
1c660 70 64 61 74 65 20 61 6e 64 20 74 68 65 20 65 78 pdate and the ex
1c670 70 72 65 73 73 69 6f 6e 73 20 74 6f 20 75 70 64 pressions to upd
1c680 61 74 65 0a 20 2a 20 20 20 20 20 20 20 20 20 20 ate. *
1c690 20 20 20 20 74 68 65 6d 20 74 6f 2e 20 53 65 65 them to. See
1c6a0 20 73 71 6c 69 74 65 33 55 70 64 61 74 65 28 29 sqlite3Update()
1c6b0 20 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 6f documentation o
1c6c0 66 20 22 70 43 68 61 6e 67 65 73 22 0a 20 2a 20 f "pChanges". *
1c6d0 20 20 20 20 20 20 20 20 20 20 20 20 20 61 72 67 arg
1c6e0 75 6d 65 6e 74 2e 0a 20 2a 20 0a 20 2a 2f 0a 73 ument.. * . */.s
1c6f0 74 72 75 63 74 20 54 72 69 67 67 65 72 53 74 65 truct TriggerSte
1c700 70 20 7b 0a 20 20 75 38 20 6f 70 3b 20 20 20 20 p {. u8 op;
1c710 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e /* On
1c720 65 20 6f 66 20 54 4b 5f 44 45 4c 45 54 45 2c 20 e of TK_DELETE,
1c730 54 4b 5f 55 50 44 41 54 45 2c 20 54 4b 5f 49 4e TK_UPDATE, TK_IN
1c740 53 45 52 54 2c 20 54 4b 5f 53 45 4c 45 43 54 20 SERT, TK_SELECT
1c750 2a 2f 0a 20 20 75 38 20 6f 72 63 6f 6e 66 3b 20 */. u8 orconf;
1c760 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 45 5f /* OE_
1c770 52 6f 6c 6c 62 61 63 6b 20 65 74 63 2e 20 2a 2f Rollback etc. */
1c780 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 72 69 . Trigger *pTri
1c790 67 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 74 g; /* The t
1c7a0 72 69 67 67 65 72 20 74 68 61 74 20 74 68 69 73 rigger that this
1c7b0 20 73 74 65 70 20 69 73 20 61 20 70 61 72 74 20 step is a part
1c7c0 6f 66 20 2a 2f 0a 20 20 53 65 6c 65 63 74 20 2a of */. Select *
1c7d0 70 53 65 6c 65 63 74 3b 20 20 20 20 20 2f 2a 20 pSelect; /*
1c7e0 53 45 4c 45 43 54 20 73 74 61 74 6d 65 6e 74 20 SELECT statment
1c7f0 6f 72 20 52 48 53 20 6f 66 20 49 4e 53 45 52 54 or RHS of INSERT
1c800 20 49 4e 54 4f 20 2e 2e 20 53 45 4c 45 43 54 20 INTO .. SELECT
1c810 2e 2e 2e 20 2a 2f 0a 20 20 54 6f 6b 65 6e 20 74 ... */. Token t
1c820 61 72 67 65 74 3b 20 20 20 20 20 20 20 20 2f 2a arget; /*
1c830 20 54 61 72 67 65 74 20 74 61 62 6c 65 20 66 6f Target table fo
1c840 72 20 44 45 4c 45 54 45 2c 20 55 50 44 41 54 45 r DELETE, UPDATE
1c850 2c 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 45 78 , INSERT */. Ex
1c860 70 72 20 2a 70 57 68 65 72 65 3b 20 20 20 20 20 pr *pWhere;
1c870 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 45 20 /* The WHERE
1c880 63 6c 61 75 73 65 20 66 6f 72 20 44 45 4c 45 54 clause for DELET
1c890 45 20 6f 72 20 55 50 44 41 54 45 20 73 74 65 70 E or UPDATE step
1c8a0 73 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 s */. ExprList
1c8b0 2a 70 45 78 70 72 4c 69 73 74 3b 20 2f 2a 20 53 *pExprList; /* S
1c8c0 45 54 20 63 6c 61 75 73 65 20 66 6f 72 20 55 50 ET clause for UP
1c8d0 44 41 54 45 2e 20 2a 2f 0a 20 20 49 64 4c 69 73 DATE. */. IdLis
1c8e0 74 20 2a 70 49 64 4c 69 73 74 3b 20 20 20 20 20 t *pIdList;
1c8f0 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 /* Column names
1c900 66 6f 72 20 49 4e 53 45 52 54 20 2a 2f 0a 20 20 for INSERT */.
1c910 54 72 69 67 67 65 72 53 74 65 70 20 2a 70 4e 65 TriggerStep *pNe
1c920 78 74 3b 20 20 2f 2a 20 4e 65 78 74 20 69 6e 20 xt; /* Next in
1c930 74 68 65 20 6c 69 6e 6b 2d 6c 69 73 74 20 2a 2f the link-list */
1c940 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 20 2a . TriggerStep *
1c950 70 4c 61 73 74 3b 20 20 2f 2a 20 4c 61 73 74 20 pLast; /* Last
1c960 65 6c 65 6d 65 6e 74 20 69 6e 20 6c 69 6e 6b 2d element in link-
1c970 6c 69 73 74 2e 20 56 61 6c 69 64 20 66 6f 72 20 list. Valid for
1c980 31 73 74 20 65 6c 65 6d 20 6f 6e 6c 79 20 2a 2f 1st elem only */
1c990 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 .};../*.** The f
1c9a0 6f 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 ollowing structu
1c9b0 72 65 20 63 6f 6e 74 61 69 6e 73 20 69 6e 66 6f re contains info
1c9c0 72 6d 61 74 69 6f 6e 20 75 73 65 64 20 62 79 20 rmation used by
1c9d0 74 68 65 20 73 71 6c 69 74 65 46 69 78 2e 2e 2e the sqliteFix...
1c9e0 0a 2a 2a 20 72 6f 75 74 69 6e 65 73 20 61 73 20 .** routines as
1c9f0 74 68 65 79 20 77 61 6c 6b 20 74 68 65 20 70 61 they walk the pa
1ca00 72 73 65 20 74 72 65 65 20 74 6f 20 6d 61 6b 65 rse tree to make
1ca10 20 64 61 74 61 62 61 73 65 20 72 65 66 65 72 65 database refere
1ca20 6e 63 65 73 0a 2a 2a 20 65 78 70 6c 69 63 69 74 nces.** explicit
1ca30 2e 20 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 . .*/.typedef s
1ca40 74 72 75 63 74 20 44 62 46 69 78 65 72 20 44 62 truct DbFixer Db
1ca50 46 69 78 65 72 3b 0a 73 74 72 75 63 74 20 44 62 Fixer;.struct Db
1ca60 46 69 78 65 72 20 7b 0a 20 20 50 61 72 73 65 20 Fixer {. Parse
1ca70 2a 70 50 61 72 73 65 3b 20 20 20 20 20 20 2f 2a *pParse; /*
1ca80 20 54 68 65 20 70 61 72 73 69 6e 67 20 63 6f 6e The parsing con
1ca90 74 65 78 74 2e 20 20 45 72 72 6f 72 20 6d 65 73 text. Error mes
1caa0 73 61 67 65 73 20 77 72 69 74 74 65 6e 20 68 65 sages written he
1cab0 72 65 20 2a 2f 0a 20 20 53 63 68 65 6d 61 20 2a re */. Schema *
1cac0 70 53 63 68 65 6d 61 3b 20 20 20 20 2f 2a 20 46 pSchema; /* F
1cad0 69 78 20 69 74 65 6d 73 20 74 6f 20 74 68 69 73 ix items to this
1cae0 20 73 63 68 65 6d 61 20 2a 2f 0a 20 20 69 6e 74 schema */. int
1caf0 20 62 56 61 72 4f 6e 6c 79 3b 20 20 20 20 20 20 bVarOnly;
1cb00 20 2f 2a 20 43 68 65 63 6b 20 66 6f 72 20 76 61 /* Check for va
1cb10 72 69 61 62 6c 65 20 72 65 66 65 72 65 6e 63 65 riable reference
1cb20 73 20 6f 6e 6c 79 20 2a 2f 0a 20 20 63 6f 6e 73 s only */. cons
1cb30 74 20 63 68 61 72 20 2a 7a 44 62 3b 20 20 20 20 t char *zDb;
1cb40 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 61 6c 6c /* Make sure all
1cb50 20 6f 62 6a 65 63 74 73 20 61 72 65 20 63 6f 6e objects are con
1cb60 74 61 69 6e 65 64 20 69 6e 20 74 68 69 73 20 64 tained in this d
1cb70 61 74 61 62 61 73 65 20 2a 2f 0a 20 20 63 6f 6e atabase */. con
1cb80 73 74 20 63 68 61 72 20 2a 7a 54 79 70 65 3b 20 st char *zType;
1cb90 20 2f 2a 20 54 79 70 65 20 6f 66 20 74 68 65 20 /* Type of the
1cba0 63 6f 6e 74 61 69 6e 65 72 20 2d 20 75 73 65 64 container - used
1cbb0 20 66 6f 72 20 65 72 72 6f 72 20 6d 65 73 73 61 for error messa
1cbc0 67 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 54 ges */. const T
1cbd0 6f 6b 65 6e 20 2a 70 4e 61 6d 65 3b 20 2f 2a 20 oken *pName; /*
1cbe0 4e 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6e 74 Name of the cont
1cbf0 61 69 6e 65 72 20 2d 20 75 73 65 64 20 66 6f 72 ainer - used for
1cc00 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 error messages
1cc10 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 */.};../*.** An
1cc20 6f 62 6a 65 63 74 65 64 20 75 73 65 64 20 74 6f objected used to
1cc30 20 61 63 63 75 6d 75 6c 61 74 65 20 74 68 65 20 accumulate the
1cc40 74 65 78 74 20 6f 66 20 61 20 73 74 72 69 6e 67 text of a string
1cc50 20 77 68 65 72 65 20 77 65 0a 2a 2a 20 64 6f 20 where we.** do
1cc60 6e 6f 74 20 6e 65 63 65 73 73 61 72 69 6c 79 20 not necessarily
1cc70 6b 6e 6f 77 20 68 6f 77 20 62 69 67 20 74 68 65 know how big the
1cc80 20 73 74 72 69 6e 67 20 77 69 6c 6c 20 62 65 20 string will be
1cc90 69 6e 20 74 68 65 20 65 6e 64 2e 0a 2a 2f 0a 73 in the end..*/.s
1cca0 74 72 75 63 74 20 53 74 72 41 63 63 75 6d 20 7b truct StrAccum {
1ccb0 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 . sqlite3 *db;
1ccc0 20 20 20 20 20 20 20 20 2f 2a 20 4f 70 74 69 6f /* Optio
1ccd0 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 6f 72 nal database for
1cce0 20 6c 6f 6f 6b 61 73 69 64 65 2e 20 20 43 61 6e lookaside. Can
1ccf0 20 62 65 20 4e 55 4c 4c 20 2a 2f 0a 20 20 63 68 be NULL */. ch
1cd00 61 72 20 2a 7a 42 61 73 65 3b 20 20 20 20 20 20 ar *zBase;
1cd10 20 20 20 2f 2a 20 41 20 62 61 73 65 20 61 6c 6c /* A base all
1cd20 6f 63 61 74 69 6f 6e 2e 20 20 4e 6f 74 20 66 72 ocation. Not fr
1cd30 6f 6d 20 6d 61 6c 6c 6f 63 2e 20 2a 2f 0a 20 20 om malloc. */.
1cd40 63 68 61 72 20 2a 7a 54 65 78 74 3b 20 20 20 20 char *zText;
1cd50 20 20 20 20 20 2f 2a 20 54 68 65 20 73 74 72 69 /* The stri
1cd60 6e 67 20 63 6f 6c 6c 65 63 74 65 64 20 73 6f 20 ng collected so
1cd70 66 61 72 20 2a 2f 0a 20 20 69 6e 74 20 20 6e 43 far */. int nC
1cd80 68 61 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a har; /*
1cd90 20 4c 65 6e 67 74 68 20 6f 66 20 74 68 65 20 73 Length of the s
1cda0 74 72 69 6e 67 20 73 6f 20 66 61 72 20 2a 2f 0a tring so far */.
1cdb0 20 20 69 6e 74 20 20 6e 41 6c 6c 6f 63 3b 20 20 int nAlloc;
1cdc0 20 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 /* Amount
1cdd0 20 6f 66 20 73 70 61 63 65 20 61 6c 6c 6f 63 61 of space alloca
1cde0 74 65 64 20 69 6e 20 7a 54 65 78 74 20 2a 2f 0a ted in zText */.
1cdf0 20 20 69 6e 74 20 20 6d 78 41 6c 6c 6f 63 3b 20 int mxAlloc;
1ce00 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 /* Maximu
1ce10 6d 20 61 6c 6c 6f 77 65 64 20 73 74 72 69 6e 67 m allowed string
1ce20 20 6c 65 6e 67 74 68 20 2a 2f 0a 20 20 75 38 20 length */. u8
1ce30 20 20 75 73 65 4d 61 6c 6c 6f 63 3b 20 20 20 20 useMalloc;
1ce40 20 20 2f 2a 20 30 3a 20 6e 6f 6e 65 2c 20 20 31 /* 0: none, 1
1ce50 3a 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f : sqlite3DbMallo
1ce60 63 2c 20 20 32 3a 20 73 71 6c 69 74 65 33 5f 6d c, 2: sqlite3_m
1ce70 61 6c 6c 6f 63 20 2a 2f 0a 20 20 75 38 20 20 20 alloc */. u8
1ce80 61 63 63 45 72 72 6f 72 3b 20 20 20 20 20 20 20 accError;
1ce90 2f 2a 20 53 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 /* STRACCUM_NOME
1cea0 4d 20 6f 72 20 53 54 52 41 43 43 55 4d 5f 54 4f M or STRACCUM_TO
1ceb0 4f 42 49 47 20 2a 2f 0a 7d 3b 0a 23 64 65 66 69 OBIG */.};.#defi
1cec0 6e 65 20 53 54 52 41 43 43 55 4d 5f 4e 4f 4d 45 ne STRACCUM_NOME
1ced0 4d 20 20 20 31 0a 23 64 65 66 69 6e 65 20 53 54 M 1.#define ST
1cee0 52 41 43 43 55 4d 5f 54 4f 4f 42 49 47 20 20 32 RACCUM_TOOBIG 2
1cef0 0a 0a 2f 2a 0a 2a 2a 20 41 20 70 6f 69 6e 74 65 ../*.** A pointe
1cf00 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63 74 r to this struct
1cf10 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 63 ure is used to c
1cf20 6f 6d 6d 75 6e 69 63 61 74 65 20 69 6e 66 6f 72 ommunicate infor
1cf30 6d 61 74 69 6f 6e 0a 2a 2a 20 66 72 6f 6d 20 73 mation.** from s
1cf40 71 6c 69 74 65 33 49 6e 69 74 20 61 6e 64 20 4f qlite3Init and O
1cf50 50 5f 50 61 72 73 65 53 63 68 65 6d 61 20 69 6e P_ParseSchema in
1cf60 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 49 6e to the sqlite3In
1cf70 69 74 43 61 6c 6c 62 61 63 6b 2e 0a 2a 2f 0a 74 itCallback..*/.t
1cf80 79 70 65 64 65 66 20 73 74 72 75 63 74 20 7b 0a ypedef struct {.
1cf90 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 20 20 sqlite3 *db;
1cfa0 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 61 74 /* The dat
1cfb0 61 62 61 73 65 20 62 65 69 6e 67 20 69 6e 69 74 abase being init
1cfc0 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 63 68 61 ialized */. cha
1cfd0 72 20 2a 2a 70 7a 45 72 72 4d 73 67 3b 20 20 20 r **pzErrMsg;
1cfe0 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 /* Error messag
1cff0 65 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f e stored here */
1d000 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 20 20 . int iDb;
1d010 20 20 20 20 20 20 20 2f 2a 20 30 20 66 6f 72 20 /* 0 for
1d020 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 20 20 main database.
1d030 31 20 66 6f 72 20 54 45 4d 50 2c 20 32 2e 2e 20 1 for TEMP, 2..
1d040 66 6f 72 20 41 54 54 41 43 48 65 64 20 2a 2f 0a for ATTACHed */.
1d050 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20 int rc;
1d060 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 20 /* Result
1d070 63 6f 64 65 20 73 74 6f 72 65 64 20 68 65 72 65 code stored here
1d080 20 2a 2f 0a 7d 20 49 6e 69 74 44 61 74 61 3b 0a */.} InitData;.
1d090 0a 2f 2a 0a 2a 2a 20 53 74 72 75 63 74 75 72 65 ./*.** Structure
1d0a0 20 63 6f 6e 74 61 69 6e 69 6e 67 20 67 6c 6f 62 containing glob
1d0b0 61 6c 20 63 6f 6e 66 69 67 75 72 61 74 69 6f 6e al configuration
1d0c0 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 53 51 data for the SQ
1d0d0 4c 69 74 65 20 6c 69 62 72 61 72 79 2e 0a 2a 2a Lite library..**
1d0e0 0a 2a 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 .** This structu
1d0f0 72 65 20 61 6c 73 6f 20 63 6f 6e 74 61 69 6e 73 re also contains
1d100 20 73 6f 6d 65 20 73 74 61 74 65 20 69 6e 66 6f some state info
1d110 72 6d 61 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 rmation..*/.stru
1d120 63 74 20 53 71 6c 69 74 65 33 43 6f 6e 66 69 67 ct Sqlite3Config
1d130 20 7b 0a 20 20 69 6e 74 20 62 4d 65 6d 73 74 61 {. int bMemsta
1d140 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
1d150 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 /* True t
1d160 6f 20 65 6e 61 62 6c 65 20 6d 65 6d 6f 72 79 20 o enable memory
1d170 73 74 61 74 75 73 20 2a 2f 0a 20 20 69 6e 74 20 status */. int
1d180 62 43 6f 72 65 4d 75 74 65 78 3b 20 20 20 20 20 bCoreMutex;
1d190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1d1a0 20 54 72 75 65 20 74 6f 20 65 6e 61 62 6c 65 20 True to enable
1d1b0 63 6f 72 65 20 6d 75 74 65 78 69 6e 67 20 2a 2f core mutexing */
1d1c0 0a 20 20 69 6e 74 20 62 46 75 6c 6c 4d 75 74 65 . int bFullMute
1d1d0 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
1d1e0 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 /* True to
1d1f0 65 6e 61 62 6c 65 20 66 75 6c 6c 20 6d 75 74 65 enable full mute
1d200 78 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 62 4f xing */. int bO
1d210 70 65 6e 55 72 69 3b 20 20 20 20 20 20 20 20 20 penUri;
1d220 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1d230 72 75 65 20 74 6f 20 69 6e 74 65 72 70 72 65 74 rue to interpret
1d240 20 66 69 6c 65 6e 61 6d 65 73 20 61 73 20 55 52 filenames as UR
1d250 49 73 20 2a 2f 0a 20 20 69 6e 74 20 62 55 73 65 Is */. int bUse
1d260 43 69 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 Cis;
1d270 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 /* Use
1d280 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 69 63 65 covering indice
1d290 73 20 66 6f 72 20 66 75 6c 6c 2d 73 63 61 6e 73 s for full-scans
1d2a0 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 53 74 72 6c */. int mxStrl
1d2b0 65 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 en;
1d2c0 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d /* Maxim
1d2d0 75 6d 20 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 um string length
1d2e0 20 2a 2f 0a 20 20 69 6e 74 20 6e 65 76 65 72 43 */. int neverC
1d2f0 6f 72 72 75 70 74 3b 20 20 20 20 20 20 20 20 20 orrupt;
1d300 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
1d310 61 73 65 20 69 73 20 61 6c 77 61 79 73 20 77 65 ase is always we
1d320 6c 6c 2d 66 6f 72 6d 65 64 20 2a 2f 0a 20 20 69 ll-formed */. i
1d330 6e 74 20 73 7a 4c 6f 6f 6b 61 73 69 64 65 3b 20 nt szLookaside;
1d340 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d350 20 2f 2a 20 44 65 66 61 75 6c 74 20 6c 6f 6f 6b /* Default look
1d360 61 73 69 64 65 20 62 75 66 66 65 72 20 73 69 7a aside buffer siz
1d370 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 6f 6b e */. int nLook
1d380 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 aside;
1d390 20 20 20 20 20 20 20 20 20 2f 2a 20 44 65 66 61 /* Defa
1d3a0 75 6c 74 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 ult lookaside bu
1d3b0 66 66 65 72 20 63 6f 75 6e 74 20 2a 2f 0a 20 20 ffer count */.
1d3c0 73 71 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 sqlite3_mem_meth
1d3d0 6f 64 73 20 6d 3b 20 20 20 20 20 20 20 20 20 20 ods m;
1d3e0 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d /* Low-level m
1d3f0 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e emory allocation
1d400 20 69 6e 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 interface */.
1d410 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 sqlite3_mutex_me
1d420 74 68 6f 64 73 20 6d 75 74 65 78 3b 20 20 20 20 thods mutex;
1d430 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 65 6c 20 6d /* Low-level m
1d440 75 74 65 78 20 69 6e 74 65 72 66 61 63 65 20 2a utex interface *
1d450 2f 0a 20 20 73 71 6c 69 74 65 33 5f 70 63 61 63 /. sqlite3_pcac
1d460 68 65 5f 6d 65 74 68 6f 64 73 32 20 70 63 61 63 he_methods2 pcac
1d470 68 65 32 3b 20 20 2f 2a 20 4c 6f 77 2d 6c 65 76 he2; /* Low-lev
1d480 65 6c 20 70 61 67 65 2d 63 61 63 68 65 20 69 6e el page-cache in
1d490 74 65 72 66 61 63 65 20 2a 2f 0a 20 20 76 6f 69 terface */. voi
1d4a0 64 20 2a 70 48 65 61 70 3b 20 20 20 20 20 20 20 d *pHeap;
1d4b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d4c0 2a 20 48 65 61 70 20 73 74 6f 72 61 67 65 20 73 * Heap storage s
1d4d0 70 61 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 48 pace */. int nH
1d4e0 65 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 eap;
1d4f0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
1d500 69 7a 65 20 6f 66 20 70 48 65 61 70 5b 5d 20 2a ize of pHeap[] *
1d510 2f 0a 20 20 69 6e 74 20 6d 6e 52 65 71 2c 20 6d /. int mnReq, m
1d520 78 52 65 71 3b 20 20 20 20 20 20 20 20 20 20 20 xReq;
1d530 20 20 20 20 20 20 2f 2a 20 4d 69 6e 20 61 6e 64 /* Min and
1d540 20 6d 61 78 20 68 65 61 70 20 72 65 71 75 65 73 max heap reques
1d550 74 73 20 73 69 7a 65 73 20 2a 2f 0a 20 20 73 71 ts sizes */. sq
1d560 6c 69 74 65 33 5f 69 6e 74 36 34 20 73 7a 4d 6d lite3_int64 szMm
1d570 61 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ap;
1d580 2f 2a 20 6d 6d 61 70 28 29 20 73 70 61 63 65 20 /* mmap() space
1d590 70 65 72 20 6f 70 65 6e 20 66 69 6c 65 20 2a 2f per open file */
1d5a0 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 . sqlite3_int64
1d5b0 20 6d 78 4d 6d 61 70 3b 20 20 20 20 20 20 20 20 mxMmap;
1d5c0 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 /* Maximum
1d5d0 76 61 6c 75 65 20 66 6f 72 20 73 7a 4d 6d 61 70 value for szMmap
1d5e0 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 53 63 72 */. void *pScr
1d5f0 61 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 20 atch;
1d600 20 20 20 20 20 20 20 20 2f 2a 20 53 63 72 61 74 /* Scrat
1d610 63 68 20 6d 65 6d 6f 72 79 20 2a 2f 0a 20 20 69 ch memory */. i
1d620 6e 74 20 73 7a 53 63 72 61 74 63 68 3b 20 20 20 nt szScratch;
1d630 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d640 20 2f 2a 20 53 69 7a 65 20 6f 66 20 65 61 63 68 /* Size of each
1d650 20 73 63 72 61 74 63 68 20 62 75 66 66 65 72 20 scratch buffer
1d660 2a 2f 0a 20 20 69 6e 74 20 6e 53 63 72 61 74 63 */. int nScratc
1d670 68 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 h;
1d680 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1d690 20 6f 66 20 73 63 72 61 74 63 68 20 62 75 66 66 of scratch buff
1d6a0 65 72 73 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 ers */. void *p
1d6b0 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 20 Page;
1d6c0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 /* Pa
1d6d0 67 65 20 63 61 63 68 65 20 6d 65 6d 6f 72 79 20 ge cache memory
1d6e0 2a 2f 0a 20 20 69 6e 74 20 73 7a 50 61 67 65 3b */. int szPage;
1d6f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d700 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f /* Size o
1d710 66 20 65 61 63 68 20 70 61 67 65 20 69 6e 20 70 f each page in p
1d720 50 61 67 65 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 Page[] */. int
1d730 6e 50 61 67 65 3b 20 20 20 20 20 20 20 20 20 20 nPage;
1d740 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1d750 20 4e 75 6d 62 65 72 20 6f 66 20 70 61 67 65 73 Number of pages
1d760 20 69 6e 20 70 50 61 67 65 5b 5d 20 2a 2f 0a 20 in pPage[] */.
1d770 20 69 6e 74 20 6d 78 50 61 72 73 65 72 53 74 61 int mxParserSta
1d780 63 6b 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ck;
1d790 20 20 20 2f 2a 20 6d 61 78 69 6d 75 6d 20 64 65 /* maximum de
1d7a0 70 74 68 20 6f 66 20 74 68 65 20 70 61 72 73 65 pth of the parse
1d7b0 72 20 73 74 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 r stack */. int
1d7c0 20 73 68 61 72 65 64 43 61 63 68 65 45 6e 61 62 sharedCacheEnab
1d7d0 6c 65 64 3b 20 20 20 20 20 20 20 20 20 20 20 2f led; /
1d7e0 2a 20 74 72 75 65 20 69 66 20 73 68 61 72 65 64 * true if shared
1d7f0 2d 63 61 63 68 65 20 6d 6f 64 65 20 65 6e 61 62 -cache mode enab
1d800 6c 65 64 20 2a 2f 0a 20 20 2f 2a 20 54 68 65 20 led */. /* The
1d810 61 62 6f 76 65 20 6d 69 67 68 74 20 62 65 20 69 above might be i
1d820 6e 69 74 69 61 6c 69 7a 65 64 20 74 6f 20 6e 6f nitialized to no
1d830 6e 2d 7a 65 72 6f 2e 20 20 54 68 65 20 66 6f 6c n-zero. The fol
1d840 6c 6f 77 69 6e 67 20 6e 65 65 64 20 74 6f 20 61 lowing need to a
1d850 6c 77 61 79 73 0a 20 20 2a 2a 20 69 6e 69 74 69 lways. ** initi
1d860 61 6c 6c 79 20 62 65 20 7a 65 72 6f 2c 20 68 6f ally be zero, ho
1d870 77 65 76 65 72 2e 20 2a 2f 0a 20 20 69 6e 74 20 wever. */. int
1d880 69 73 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 isInit;
1d890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1d8a0 20 54 72 75 65 20 61 66 74 65 72 20 69 6e 69 74 True after init
1d8b0 69 61 6c 69 7a 61 74 69 6f 6e 20 68 61 73 20 66 ialization has f
1d8c0 69 6e 69 73 68 65 64 20 2a 2f 0a 20 20 69 6e 74 inished */. int
1d8d0 20 69 6e 50 72 6f 67 72 65 73 73 3b 20 20 20 20 inProgress;
1d8e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d8f0 2a 20 54 72 75 65 20 77 68 69 6c 65 20 69 6e 69 * True while ini
1d900 74 69 61 6c 69 7a 61 74 69 6f 6e 20 69 6e 20 70 tialization in p
1d910 72 6f 67 72 65 73 73 20 2a 2f 0a 20 20 69 6e 74 rogress */. int
1d920 20 69 73 4d 75 74 65 78 49 6e 69 74 3b 20 20 20 isMutexInit;
1d930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1d940 2a 20 54 72 75 65 20 61 66 74 65 72 20 6d 75 74 * True after mut
1d950 65 78 65 73 20 61 72 65 20 69 6e 69 74 69 61 6c exes are initial
1d960 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 73 ized */. int is
1d970 4d 61 6c 6c 6f 63 49 6e 69 74 3b 20 20 20 20 20 MallocInit;
1d980 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1d990 72 75 65 20 61 66 74 65 72 20 6d 61 6c 6c 6f 63 rue after malloc
1d9a0 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 is initialized
1d9b0 2a 2f 0a 20 20 69 6e 74 20 69 73 50 43 61 63 68 */. int isPCach
1d9c0 65 49 6e 69 74 3b 20 20 20 20 20 20 20 20 20 20 eInit;
1d9d0 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 61 /* True a
1d9e0 66 74 65 72 20 6d 61 6c 6c 6f 63 20 69 73 20 69 fter malloc is i
1d9f0 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 nitialized */.
1da00 69 6e 74 20 6e 52 65 66 49 6e 69 74 4d 75 74 65 int nRefInitMute
1da10 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 x;
1da20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 75 /* Number of u
1da30 73 65 72 73 20 6f 66 20 70 49 6e 69 74 4d 75 74 sers of pInitMut
1da40 65 78 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ex */. sqlite3_
1da50 6d 75 74 65 78 20 2a 70 49 6e 69 74 4d 75 74 65 mutex *pInitMute
1da60 78 3b 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 74 x; /* Mut
1da70 65 78 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 ex used by sqlit
1da80 65 33 5f 69 6e 69 74 69 61 6c 69 7a 65 28 29 20 e3_initialize()
1da90 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 4c 6f 67 */. void (*xLog
1daa0 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f 6e 73 )(void*,int,cons
1dab0 74 20 63 68 61 72 2a 29 3b 20 2f 2a 20 46 75 6e t char*); /* Fun
1dac0 63 74 69 6f 6e 20 66 6f 72 20 6c 6f 67 67 69 6e ction for loggin
1dad0 67 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 4c 6f g */. void *pLo
1dae0 67 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20 gArg;
1daf0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
1db00 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 74 6f irst argument to
1db10 20 78 4c 6f 67 28 29 20 2a 2f 0a 23 69 66 64 65 xLog() */.#ifde
1db20 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
1db30 53 51 4c 4c 4f 47 0a 20 20 76 6f 69 64 28 2a 78 SQLLOG. void(*x
1db40 53 71 6c 6c 6f 67 29 28 76 6f 69 64 2a 2c 73 71 Sqllog)(void*,sq
1db50 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
1db60 72 2a 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 r*, int);. void
1db70 20 2a 70 53 71 6c 6c 6f 67 41 72 67 3b 0a 23 65 *pSqllogArg;.#e
1db80 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c 49 ndif.#ifdef SQLI
1db90 54 45 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 TE_VDBE_COVERAGE
1dba0 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 . /* The follow
1dbb0 69 6e 67 20 63 61 6c 6c 62 61 63 6b 20 28 69 66 ing callback (if
1dbc0 20 6e 6f 74 20 4e 55 4c 4c 29 20 69 73 20 69 6e not NULL) is in
1dbd0 76 6f 6b 65 64 20 6f 6e 20 65 76 65 72 79 20 56 voked on every V
1dbe0 44 42 45 20 62 72 61 6e 63 68 0a 20 20 2a 2a 20 DBE branch. **
1dbf0 6f 70 65 72 61 74 69 6f 6e 2e 20 20 53 65 74 20 operation. Set
1dc00 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 75 73 69 the callback usi
1dc10 6e 67 20 53 51 4c 49 54 45 5f 54 45 53 54 43 54 ng SQLITE_TESTCT
1dc20 52 4c 5f 56 44 42 45 5f 43 4f 56 45 52 41 47 45 RL_VDBE_COVERAGE
1dc30 2e 0a 20 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a .. */. void (*
1dc40 78 56 64 62 65 42 72 61 6e 63 68 29 28 76 6f 69 xVdbeBranch)(voi
1dc50 64 2a 2c 69 6e 74 20 69 53 72 63 4c 69 6e 65 2c d*,int iSrcLine,
1dc60 75 38 20 65 54 68 69 73 2c 75 38 20 65 4d 78 29 u8 eThis,u8 eMx)
1dc70 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 63 6b 20 2a ; /* Callback *
1dc80 2f 0a 20 20 76 6f 69 64 20 2a 70 56 64 62 65 42 /. void *pVdbeB
1dc90 72 61 6e 63 68 41 72 67 3b 20 20 20 20 20 20 20 ranchArg;
1dca0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1dcb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1dcc0 20 31 73 74 20 61 72 67 75 6d 65 6e 74 20 2a 2f 1st argument */
1dcd0 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 .#endif.#ifndef
1dce0 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c SQLITE_OMIT_BUIL
1dcf0 54 49 4e 5f 54 45 53 54 0a 20 20 69 6e 74 20 28 TIN_TEST. int (
1dd00 2a 78 54 65 73 74 43 61 6c 6c 62 61 63 6b 29 28 *xTestCallback)(
1dd10 69 6e 74 29 3b 20 20 20 20 20 20 20 20 2f 2a 20 int); /*
1dd20 49 6e 76 6f 6b 65 64 20 62 79 20 73 71 6c 69 74 Invoked by sqlit
1dd30 65 33 46 61 75 6c 74 53 69 6d 28 29 20 2a 2f 0a e3FaultSim() */.
1dd40 23 65 6e 64 69 66 0a 20 20 69 6e 74 20 62 4c 6f #endif. int bLo
1dd50 63 61 6c 74 69 6d 65 46 61 75 6c 74 3b 20 20 20 caltimeFault;
1dd60 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
1dd70 75 65 20 74 6f 20 66 61 69 6c 20 6c 6f 63 61 6c ue to fail local
1dd80 74 69 6d 65 28 29 20 63 61 6c 6c 73 20 2a 2f 0a time() calls */.
1dd90 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 6d };../*.** This m
1dda0 61 63 72 6f 20 69 73 20 75 73 65 64 20 69 6e 73 acro is used ins
1ddb0 69 64 65 20 6f 66 20 61 73 73 65 72 74 28 29 20 ide of assert()
1ddc0 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 20 69 6e statements to in
1ddd0 64 69 63 61 74 65 20 74 68 61 74 0a 2a 2a 20 74 dicate that.** t
1dde0 68 65 20 61 73 73 65 72 74 20 69 73 20 6f 6e 6c he assert is onl
1ddf0 79 20 76 61 6c 69 64 20 6f 6e 20 61 20 77 65 6c y valid on a wel
1de00 6c 2d 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 l-formed databas
1de10 65 2e 20 20 49 6e 73 74 65 61 64 20 6f 66 3a 0a e. Instead of:.
1de20 2a 2a 0a 2a 2a 20 20 20 20 20 61 73 73 65 72 74 **.** assert
1de30 28 20 58 20 29 3b 0a 2a 2a 0a 2a 2a 20 4f 6e 65 ( X );.**.** One
1de40 20 77 72 69 74 65 73 3a 0a 2a 2a 0a 2a 2a 20 20 writes:.**.**
1de50 20 20 20 61 73 73 65 72 74 28 20 58 20 7c 7c 20 assert( X ||
1de60 43 4f 52 52 55 50 54 5f 44 42 20 29 3b 0a 2a 2a CORRUPT_DB );.**
1de70 0a 2a 2a 20 43 4f 52 52 55 50 54 5f 44 42 20 69 .** CORRUPT_DB i
1de80 73 20 74 72 75 65 20 64 75 72 69 6e 67 20 6e 6f s true during no
1de90 72 6d 61 6c 20 6f 70 65 72 61 74 69 6f 6e 2e 20 rmal operation.
1dea0 20 43 4f 52 52 55 50 54 5f 44 42 20 64 6f 65 73 CORRUPT_DB does
1deb0 20 6e 6f 74 20 69 6e 64 69 63 61 74 65 0a 2a 2a not indicate.**
1dec0 20 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 that the databa
1ded0 73 65 20 69 73 20 64 65 66 69 6e 69 74 65 6c 79 se is definitely
1dee0 20 63 6f 72 72 75 70 74 2c 20 6f 6e 6c 79 20 74 corrupt, only t
1def0 68 61 74 20 69 74 20 6d 69 67 68 74 20 62 65 20 hat it might be
1df00 63 6f 72 72 75 70 74 2e 0a 2a 2a 20 46 6f 72 20 corrupt..** For
1df10 6d 6f 73 74 20 74 65 73 74 20 63 61 73 65 73 2c most test cases,
1df20 20 43 4f 52 52 55 50 54 5f 44 42 20 69 73 20 73 CORRUPT_DB is s
1df30 65 74 20 74 6f 20 66 61 6c 73 65 20 75 73 69 6e et to false usin
1df40 67 20 61 20 73 70 65 63 69 61 6c 0a 2a 2a 20 73 g a special.** s
1df50 71 6c 69 74 65 33 5f 74 65 73 74 5f 63 6f 6e 74 qlite3_test_cont
1df60 72 6f 6c 28 29 2e 20 20 54 68 69 73 20 65 6e 61 rol(). This ena
1df70 62 6c 65 73 20 61 73 73 65 72 74 28 29 20 73 74 bles assert() st
1df80 61 74 65 6d 65 6e 74 73 20 74 6f 20 70 72 6f 76 atements to prov
1df90 65 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 74 e.** things that
1dfa0 20 61 72 65 20 61 6c 77 61 79 73 20 74 72 75 65 are always true
1dfb0 20 66 6f 72 20 77 65 6c 6c 2d 66 6f 72 6d 65 64 for well-formed
1dfc0 20 64 61 74 61 62 61 73 65 73 2e 0a 2a 2f 0a 23 databases..*/.#
1dfd0 64 65 66 69 6e 65 20 43 4f 52 52 55 50 54 5f 44 define CORRUPT_D
1dfe0 42 20 20 28 73 71 6c 69 74 65 33 43 6f 6e 66 69 B (sqlite3Confi
1dff0 67 2e 6e 65 76 65 72 43 6f 72 72 75 70 74 3d 3d g.neverCorrupt==
1e000 30 29 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 74 65 78 0)../*.** Contex
1e010 74 20 70 6f 69 6e 74 65 72 20 70 61 73 73 65 64 t pointer passed
1e020 20 64 6f 77 6e 20 74 68 72 6f 75 67 68 20 74 68 down through th
1e030 65 20 74 72 65 65 2d 77 61 6c 6b 2e 0a 2a 2f 0a e tree-walk..*/.
1e040 73 74 72 75 63 74 20 57 61 6c 6b 65 72 20 7b 0a struct Walker {.
1e050 20 20 69 6e 74 20 28 2a 78 45 78 70 72 43 61 6c int (*xExprCal
1e060 6c 62 61 63 6b 29 28 57 61 6c 6b 65 72 2a 2c 20 lback)(Walker*,
1e070 45 78 70 72 2a 29 3b 20 20 20 20 20 2f 2a 20 43 Expr*); /* C
1e080 61 6c 6c 62 61 63 6b 20 66 6f 72 20 65 78 70 72 allback for expr
1e090 65 73 73 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 essions */. int
1e0a0 20 28 2a 78 53 65 6c 65 63 74 43 61 6c 6c 62 61 (*xSelectCallba
1e0b0 63 6b 29 28 57 61 6c 6b 65 72 2a 2c 53 65 6c 65 ck)(Walker*,Sele
1e0c0 63 74 2a 29 3b 20 20 2f 2a 20 43 61 6c 6c 62 61 ct*); /* Callba
1e0d0 63 6b 20 66 6f 72 20 53 45 4c 45 43 54 73 20 2a ck for SELECTs *
1e0e0 2f 0a 20 20 76 6f 69 64 20 28 2a 78 53 65 6c 65 /. void (*xSele
1e0f0 63 74 43 61 6c 6c 62 61 63 6b 32 29 28 57 61 6c ctCallback2)(Wal
1e100 6b 65 72 2a 2c 53 65 6c 65 63 74 2a 29 3b 2f 2a ker*,Select*);/*
1e110 20 53 65 63 6f 6e 64 20 63 61 6c 6c 62 61 63 6b Second callback
1e120 20 66 6f 72 20 53 45 4c 45 43 54 73 20 2a 2f 0a for SELECTs */.
1e130 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 3b Parse *pParse;
1e140 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e150 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
1e160 61 72 73 65 72 20 63 6f 6e 74 65 78 74 2e 20 20 arser context.
1e170 2a 2f 0a 20 20 69 6e 74 20 77 61 6c 6b 65 72 44 */. int walkerD
1e180 65 70 74 68 3b 20 20 20 20 20 20 20 20 20 20 20 epth;
1e190 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1e1a0 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 75 62 71 * Number of subq
1e1b0 75 65 72 69 65 73 20 2a 2f 0a 20 20 75 6e 69 6f ueries */. unio
1e1c0 6e 20 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 n {
1e1d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e1e0 20 20 20 20 20 20 2f 2a 20 45 78 74 72 61 20 64 /* Extra d
1e1f0 61 74 61 20 66 6f 72 20 63 61 6c 6c 62 61 63 6b ata for callback
1e200 20 2a 2f 0a 20 20 20 20 4e 61 6d 65 43 6f 6e 74 */. NameCont
1e210 65 78 74 20 2a 70 4e 43 3b 20 20 20 20 20 20 20 ext *pNC;
1e220 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e230 20 20 20 2f 2a 20 4e 61 6d 69 6e 67 20 63 6f 6e /* Naming con
1e240 74 65 78 74 20 2a 2f 0a 20 20 20 20 69 6e 74 20 text */. int
1e250 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
1e260 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e270 20 20 20 20 20 20 20 2f 2a 20 49 6e 74 65 67 65 /* Intege
1e280 72 20 76 61 6c 75 65 20 2a 2f 0a 20 20 20 20 53 r value */. S
1e290 72 63 4c 69 73 74 20 2a 70 53 72 63 4c 69 73 74 rcList *pSrcList
1e2a0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
1e2b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 52 4f /* FRO
1e2c0 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 20 20 M clause */.
1e2d0 73 74 72 75 63 74 20 53 72 63 43 6f 75 6e 74 20 struct SrcCount
1e2e0 2a 70 53 72 63 43 6f 75 6e 74 3b 20 20 20 20 20 *pSrcCount;
1e2f0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f /* Co
1e300 75 6e 74 69 6e 67 20 63 6f 6c 75 6d 6e 20 72 65 unting column re
1e310 66 65 72 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 ferences */. }
1e320 75 3b 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 72 u;.};../* Forwar
1e330 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 73 20 2a d declarations *
1e340 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 61 6c /.int sqlite3Wal
1e350 6b 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 45 kExpr(Walker*, E
1e360 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 xpr*);.int sqlit
1e370 65 33 57 61 6c 6b 45 78 70 72 4c 69 73 74 28 57 e3WalkExprList(W
1e380 61 6c 6b 65 72 2a 2c 20 45 78 70 72 4c 69 73 74 alker*, ExprList
1e390 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 *);.int sqlite3W
1e3a0 61 6c 6b 53 65 6c 65 63 74 28 57 61 6c 6b 65 72 alkSelect(Walker
1e3b0 2a 2c 20 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 *, Select*);.int
1e3c0 20 73 71 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 sqlite3WalkSele
1e3d0 63 74 45 78 70 72 28 57 61 6c 6b 65 72 2a 2c 20 ctExpr(Walker*,
1e3e0 53 65 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 Select*);.int sq
1e3f0 6c 69 74 65 33 57 61 6c 6b 53 65 6c 65 63 74 46 lite3WalkSelectF
1e400 72 6f 6d 28 57 61 6c 6b 65 72 2a 2c 20 53 65 6c rom(Walker*, Sel
1e410 65 63 74 2a 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 65 ect*);../*.** Re
1e420 74 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 74 turn code from t
1e430 68 65 20 70 61 72 73 65 2d 74 72 65 65 20 77 61 he parse-tree wa
1e440 6c 6b 69 6e 67 20 70 72 69 6d 69 74 69 76 65 73 lking primitives
1e450 20 61 6e 64 20 74 68 65 69 72 0a 2a 2a 20 63 61 and their.** ca
1e460 6c 6c 62 61 63 6b 73 2e 0a 2a 2f 0a 23 64 65 66 llbacks..*/.#def
1e470 69 6e 65 20 57 52 43 5f 43 6f 6e 74 69 6e 75 65 ine WRC_Continue
1e480 20 20 20 20 30 20 20 20 2f 2a 20 43 6f 6e 74 69 0 /* Conti
1e490 6e 75 65 20 64 6f 77 6e 20 69 6e 74 6f 20 63 68 nue down into ch
1e4a0 69 6c 64 72 65 6e 20 2a 2f 0a 23 64 65 66 69 6e ildren */.#defin
1e4b0 65 20 57 52 43 5f 50 72 75 6e 65 20 20 20 20 20 e WRC_Prune
1e4c0 20 20 31 20 20 20 2f 2a 20 4f 6d 69 74 20 63 68 1 /* Omit ch
1e4d0 69 6c 64 72 65 6e 20 62 75 74 20 63 6f 6e 74 69 ildren but conti
1e4e0 6e 75 65 20 77 61 6c 6b 69 6e 67 20 73 69 62 6c nue walking sibl
1e4f0 69 6e 67 73 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ings */.#define
1e500 57 52 43 5f 41 62 6f 72 74 20 20 20 20 20 20 20 WRC_Abort
1e510 32 20 20 20 2f 2a 20 41 62 61 6e 64 6f 6e 20 74 2 /* Abandon t
1e520 68 65 20 74 72 65 65 20 77 61 6c 6b 20 2a 2f 0a he tree walk */.
1e530 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e ./*.** An instan
1e540 63 65 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 ce of this struc
1e550 74 75 72 65 20 72 65 70 72 65 73 65 6e 74 73 20 ture represents
1e560 61 20 73 65 74 20 6f 66 20 6f 6e 65 20 6f 72 20 a set of one or
1e570 6d 6f 72 65 20 43 54 45 73 0a 2a 2a 20 28 63 6f more CTEs.** (co
1e580 6d 6d 6f 6e 20 74 61 62 6c 65 20 65 78 70 72 65 mmon table expre
1e590 73 73 69 6f 6e 73 29 20 63 72 65 61 74 65 64 20 ssions) created
1e5a0 62 79 20 61 20 73 69 6e 67 6c 65 20 57 49 54 48 by a single WITH
1e5b0 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 73 74 72 75 clause..*/.stru
1e5c0 63 74 20 57 69 74 68 20 7b 0a 20 20 69 6e 74 20 ct With {. int
1e5d0 6e 43 74 65 3b 20 20 20 20 20 20 20 20 20 20 20 nCte;
1e5e0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1e5f0 75 6d 62 65 72 20 6f 66 20 43 54 45 73 20 69 6e umber of CTEs in
1e600 20 74 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 the WITH clause
1e610 20 2a 2f 0a 20 20 57 69 74 68 20 2a 70 4f 75 74 */. With *pOut
1e620 65 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 er;
1e630 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 61 69 6e /* Contain
1e640 69 6e 67 20 57 49 54 48 20 63 6c 61 75 73 65 2c ing WITH clause,
1e650 20 6f 72 20 4e 55 4c 4c 20 2a 2f 0a 20 20 73 74 or NULL */. st
1e660 72 75 63 74 20 43 74 65 20 7b 20 20 20 20 20 20 ruct Cte {
1e670 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1e680 20 46 6f 72 20 65 61 63 68 20 43 54 45 20 69 6e For each CTE in
1e690 20 74 68 65 20 57 49 54 48 20 63 6c 61 75 73 65 the WITH clause
1e6a0 2e 2e 2e 2e 20 2a 2f 0a 20 20 20 20 63 68 61 72 .... */. char
1e6b0 20 2a 7a 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 *zName;
1e6c0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
1e6d0 61 6d 65 20 6f 66 20 74 68 69 73 20 43 54 45 20 ame of this CTE
1e6e0 2a 2f 0a 20 20 20 20 45 78 70 72 4c 69 73 74 20 */. ExprList
1e6f0 2a 70 43 6f 6c 73 3b 20 20 20 20 20 20 20 20 20 *pCols;
1e700 20 20 20 20 20 20 20 2f 2a 20 4c 69 73 74 20 6f /* List o
1e710 66 20 65 78 70 6c 69 63 69 74 20 63 6f 6c 75 6d f explicit colum
1e720 6e 20 6e 61 6d 65 73 2c 20 6f 72 20 4e 55 4c 4c n names, or NULL
1e730 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a */. Select *
1e740 70 53 65 6c 65 63 74 3b 20 20 20 20 20 20 20 20 pSelect;
1e750 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 64 /* The d
1e760 65 66 69 6e 69 74 69 6f 6e 20 6f 66 20 74 68 69 efinition of thi
1e770 73 20 43 54 45 20 2a 2f 0a 20 20 20 20 63 6f 6e s CTE */. con
1e780 73 74 20 63 68 61 72 20 2a 7a 45 72 72 3b 20 20 st char *zErr;
1e790 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1e7a0 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 6f Error message fo
1e7b0 72 20 63 69 72 63 75 6c 61 72 20 72 65 66 65 72 r circular refer
1e7c0 65 6e 63 65 73 20 2a 2f 0a 20 20 7d 20 61 5b 31 ences */. } a[1
1e7d0 5d 3b 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 73 73 ];.};../*.** Ass
1e7e0 75 6d 69 6e 67 20 7a 49 6e 20 70 6f 69 6e 74 73 uming zIn points
1e7f0 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 to the first by
1e800 74 65 20 6f 66 20 61 20 55 54 46 2d 38 20 63 68 te of a UTF-8 ch
1e810 61 72 61 63 74 65 72 2c 0a 2a 2a 20 61 64 76 61 aracter,.** adva
1e820 6e 63 65 20 7a 49 6e 20 74 6f 20 70 6f 69 6e 74 nce zIn to point
1e830 20 74 6f 20 74 68 65 20 66 69 72 73 74 20 62 79 to the first by
1e840 74 65 20 6f 66 20 74 68 65 20 6e 65 78 74 20 55 te of the next U
1e850 54 46 2d 38 20 63 68 61 72 61 63 74 65 72 2e 0a TF-8 character..
1e860 2a 2f 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 */.#define SQLIT
1e870 45 5f 53 4b 49 50 5f 55 54 46 38 28 7a 49 6e 29 E_SKIP_UTF8(zIn)
1e880 20 7b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 {
1e890 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 69 66 \. if
1e8a0 28 20 28 2a 28 7a 49 6e 2b 2b 29 29 3e 3d 30 78 ( (*(zIn++))>=0x
1e8b0 63 30 20 29 7b 20 20 20 20 20 20 20 20 20 20 20 c0 ){
1e8c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e8d0 20 20 20 5c 0a 20 20 20 20 77 68 69 6c 65 28 20 \. while(
1e8e0 28 2a 7a 49 6e 20 26 20 30 78 63 30 29 3d 3d 30 (*zIn & 0xc0)==0
1e8f0 78 38 30 20 29 7b 20 7a 49 6e 2b 2b 3b 20 7d 20 x80 ){ zIn++; }
1e900 20 20 20 20 20 20 20 20 20 20 20 20 5c 0a 20 20 \.
1e910 7d 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 }
1e920 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e930 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1e940 20 20 20 20 20 5c 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 \.}../*.**
1e950 54 68 65 20 53 51 4c 49 54 45 5f 2a 5f 42 4b 50 The SQLITE_*_BKP
1e960 54 20 6d 61 63 72 6f 73 20 61 72 65 20 73 75 62 T macros are sub
1e970 73 74 69 74 75 74 65 73 20 66 6f 72 20 74 68 65 stitutes for the
1e980 20 65 72 72 6f 72 20 63 6f 64 65 73 20 77 69 74 error codes wit
1e990 68 0a 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 61 h.** the same na
1e9a0 6d 65 20 62 75 74 20 77 69 74 68 6f 75 74 20 74 me but without t
1e9b0 68 65 20 5f 42 4b 50 54 20 73 75 66 66 69 78 2e he _BKPT suffix.
1e9c0 20 20 54 68 65 73 65 20 6d 61 63 72 6f 73 20 69 These macros i
1e9d0 6e 76 6f 6b 65 0a 2a 2a 20 72 6f 75 74 69 6e 65 nvoke.** routine
1e9e0 73 20 74 68 61 74 20 72 65 70 6f 72 74 20 74 68 s that report th
1e9f0 65 20 6c 69 6e 65 2d 6e 75 6d 62 65 72 20 6f 6e e line-number on
1ea00 20 77 68 69 63 68 20 74 68 65 20 65 72 72 6f 72 which the error
1ea10 20 6f 72 69 67 69 6e 61 74 65 64 0a 2a 2a 20 75 originated.** u
1ea20 73 69 6e 67 20 73 71 6c 69 74 65 33 5f 6c 6f 67 sing sqlite3_log
1ea30 28 29 2e 20 20 54 68 65 20 72 6f 75 74 69 6e 65 (). The routine
1ea40 73 20 61 6c 73 6f 20 70 72 6f 76 69 64 65 20 61 s also provide a
1ea50 20 63 6f 6e 76 65 6e 69 65 6e 74 20 70 6c 61 63 convenient plac
1ea60 65 0a 2a 2a 20 74 6f 20 73 65 74 20 61 20 64 65 e.** to set a de
1ea70 62 75 67 67 65 72 20 62 72 65 61 6b 70 6f 69 6e bugger breakpoin
1ea80 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 t..*/.int sqlite
1ea90 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 69 6e 3CorruptError(in
1eaa0 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d t);.int sqlite3M
1eab0 69 73 75 73 65 45 72 72 6f 72 28 69 6e 74 29 3b isuseError(int);
1eac0 0a 69 6e 74 20 73 71 6c 69 74 65 33 43 61 6e 74 .int sqlite3Cant
1ead0 6f 70 65 6e 45 72 72 6f 72 28 69 6e 74 29 3b 0a openError(int);.
1eae0 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 43 #define SQLITE_C
1eaf0 4f 52 52 55 50 54 5f 42 4b 50 54 20 73 71 6c 69 ORRUPT_BKPT sqli
1eb00 74 65 33 43 6f 72 72 75 70 74 45 72 72 6f 72 28 te3CorruptError(
1eb10 5f 5f 4c 49 4e 45 5f 5f 29 0a 23 64 65 66 69 6e __LINE__).#defin
1eb20 65 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f e SQLITE_MISUSE_
1eb30 42 4b 50 54 20 73 71 6c 69 74 65 33 4d 69 73 75 BKPT sqlite3Misu
1eb40 73 65 45 72 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f seError(__LINE__
1eb50 29 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 54 45 ).#define SQLITE
1eb60 5f 43 41 4e 54 4f 50 45 4e 5f 42 4b 50 54 20 73 _CANTOPEN_BKPT s
1eb70 71 6c 69 74 65 33 43 61 6e 74 6f 70 65 6e 45 72 qlite3CantopenEr
1eb80 72 6f 72 28 5f 5f 4c 49 4e 45 5f 5f 29 0a 0a 0a ror(__LINE__)...
1eb90 2f 2a 0a 2a 2a 20 46 54 53 34 20 69 73 20 72 65 /*.** FTS4 is re
1eba0 61 6c 6c 79 20 61 6e 20 65 78 74 65 6e 73 69 6f ally an extensio
1ebb0 6e 20 66 6f 72 20 46 54 53 33 2e 20 20 49 74 20 n for FTS3. It
1ebc0 69 73 20 65 6e 61 62 6c 65 64 20 75 73 69 6e 67 is enabled using
1ebd0 20 74 68 65 0a 2a 2a 20 53 51 4c 49 54 45 5f 45 the.** SQLITE_E
1ebe0 4e 41 42 4c 45 5f 46 54 53 33 20 6d 61 63 72 6f NABLE_FTS3 macro
1ebf0 2e 20 20 42 75 74 20 74 6f 20 61 76 6f 69 64 20 . But to avoid
1ec00 63 6f 6e 66 75 73 69 6f 6e 20 77 65 20 61 6c 73 confusion we als
1ec10 6f 20 61 6c 6c 0a 2a 2a 20 74 68 65 20 53 51 4c o all.** the SQL
1ec20 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 34 20 ITE_ENABLE_FTS4
1ec30 6d 61 63 72 6f 20 74 6f 20 73 65 72 76 65 20 61 macro to serve a
1ec40 73 20 61 6e 20 61 6c 69 73 73 65 20 66 6f 72 20 s an alisse for
1ec50 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 SQLITE_ENABLE_FT
1ec60 53 33 2e 0a 2a 2f 0a 23 69 66 20 64 65 66 69 6e S3..*/.#if defin
1ec70 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
1ec80 5f 46 54 53 34 29 20 26 26 20 21 64 65 66 69 6e _FTS4) && !defin
1ec90 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ed(SQLITE_ENABLE
1eca0 5f 46 54 53 33 29 0a 23 20 64 65 66 69 6e 65 20 _FTS3).# define
1ecb0 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 SQLITE_ENABLE_FT
1ecc0 53 33 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a S3.#endif../*.**
1ecd0 20 54 68 65 20 63 74 79 70 65 2e 68 20 68 65 61 The ctype.h hea
1ece0 64 65 72 20 69 73 20 6e 65 65 64 65 64 20 66 6f der is needed fo
1ecf0 72 20 6e 6f 6e 2d 41 53 43 49 49 20 73 79 73 74 r non-ASCII syst
1ed00 65 6d 73 2e 20 20 49 74 20 69 73 20 61 6c 73 6f ems. It is also
1ed10 0a 2a 2a 20 6e 65 65 64 65 64 20 62 79 20 46 54 .** needed by FT
1ed20 53 33 20 77 68 65 6e 20 46 54 53 33 20 69 73 20 S3 when FTS3 is
1ed30 69 6e 63 6c 75 64 65 64 20 69 6e 20 74 68 65 20 included in the
1ed40 61 6d 61 6c 67 61 6d 61 74 69 6f 6e 2e 0a 2a 2f amalgamation..*/
1ed50 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 .#if !defined(SQ
1ed60 4c 49 54 45 5f 41 53 43 49 49 29 20 7c 7c 20 5c LITE_ASCII) || \
1ed70 0a 20 20 20 20 28 64 65 66 69 6e 65 64 28 53 51 . (defined(SQ
1ed80 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 46 54 53 33 LITE_ENABLE_FTS3
1ed90 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51 4c ) && defined(SQL
1eda0 49 54 45 5f 41 4d 41 4c 47 41 4d 41 54 49 4f 4e ITE_AMALGAMATION
1edb0 29 29 0a 23 20 69 6e 63 6c 75 64 65 20 3c 63 74 )).# include <ct
1edc0 79 70 65 2e 68 3e 0a 23 65 6e 64 69 66 0a 0a 2f ype.h>.#endif../
1edd0 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 *.** The followi
1ede0 6e 67 20 6d 61 63 72 6f 73 20 6d 69 6d 69 63 20 ng macros mimic
1edf0 74 68 65 20 73 74 61 6e 64 61 72 64 20 6c 69 62 the standard lib
1ee00 72 61 72 79 20 66 75 6e 63 74 69 6f 6e 73 20 74 rary functions t
1ee10 6f 75 70 70 65 72 28 29 2c 0a 2a 2a 20 69 73 73 oupper(),.** iss
1ee20 70 61 63 65 28 29 2c 20 69 73 61 6c 6e 75 6d 28 pace(), isalnum(
1ee30 29 2c 20 69 73 64 69 67 69 74 28 29 20 61 6e 64 ), isdigit() and
1ee40 20 69 73 78 64 69 67 69 74 28 29 2c 20 72 65 73 isxdigit(), res
1ee50 70 65 63 74 69 76 65 6c 79 2e 20 54 68 65 0a 2a pectively. The.*
1ee60 2a 20 73 71 6c 69 74 65 20 76 65 72 73 69 6f 6e * sqlite version
1ee70 73 20 6f 6e 6c 79 20 77 6f 72 6b 20 66 6f 72 20 s only work for
1ee80 41 53 43 49 49 20 63 68 61 72 61 63 74 65 72 73 ASCII characters
1ee90 2c 20 72 65 67 61 72 64 6c 65 73 73 20 6f 66 20 , regardless of
1eea0 6c 6f 63 61 6c 65 2e 0a 2a 2f 0a 23 69 66 64 65 locale..*/.#ifde
1eeb0 66 20 53 51 4c 49 54 45 5f 41 53 43 49 49 0a 23 f SQLITE_ASCII.#
1eec0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 54 define sqlite3T
1eed0 6f 75 70 70 65 72 28 78 29 20 20 28 28 78 29 26 oupper(x) ((x)&
1eee0 7e 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d 61 ~(sqlite3CtypeMa
1eef0 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 p[(unsigned char
1ef00 29 28 78 29 5d 26 30 78 32 30 29 29 0a 23 20 64 )(x)]&0x20)).# d
1ef10 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 73 efine sqlite3Iss
1ef20 70 61 63 65 28 78 29 20 20 20 28 73 71 6c 69 74 pace(x) (sqlit
1ef30 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 e3CtypeMap[(unsi
1ef40 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 gned char)(x)]&0
1ef50 78 30 31 29 0a 23 20 64 65 66 69 6e 65 20 73 71 x01).# define sq
1ef60 6c 69 74 65 33 49 73 61 6c 6e 75 6d 28 78 29 20 lite3Isalnum(x)
1ef70 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d (sqlite3CtypeM
1ef80 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ap[(unsigned cha
1ef90 72 29 28 78 29 5d 26 30 78 30 36 29 0a 23 20 64 r)(x)]&0x06).# d
1efa0 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 efine sqlite3Isa
1efb0 6c 70 68 61 28 78 29 20 20 20 28 73 71 6c 69 74 lpha(x) (sqlit
1efc0 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 e3CtypeMap[(unsi
1efd0 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 gned char)(x)]&0
1efe0 78 30 32 29 0a 23 20 64 65 66 69 6e 65 20 73 71 x02).# define sq
1eff0 6c 69 74 65 33 49 73 64 69 67 69 74 28 78 29 20 lite3Isdigit(x)
1f000 20 20 28 73 71 6c 69 74 65 33 43 74 79 70 65 4d (sqlite3CtypeM
1f010 61 70 5b 28 75 6e 73 69 67 6e 65 64 20 63 68 61 ap[(unsigned cha
1f020 72 29 28 78 29 5d 26 30 78 30 34 29 0a 23 20 64 r)(x)]&0x04).# d
1f030 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 78 efine sqlite3Isx
1f040 64 69 67 69 74 28 78 29 20 20 28 73 71 6c 69 74 digit(x) (sqlit
1f050 65 33 43 74 79 70 65 4d 61 70 5b 28 75 6e 73 69 e3CtypeMap[(unsi
1f060 67 6e 65 64 20 63 68 61 72 29 28 78 29 5d 26 30 gned char)(x)]&0
1f070 78 30 38 29 0a 23 20 64 65 66 69 6e 65 20 73 71 x08).# define sq
1f080 6c 69 74 65 33 54 6f 6c 6f 77 65 72 28 78 29 20 lite3Tolower(x)
1f090 20 20 28 73 71 6c 69 74 65 33 55 70 70 65 72 54 (sqlite3UpperT
1f0a0 6f 4c 6f 77 65 72 5b 28 75 6e 73 69 67 6e 65 64 oLower[(unsigned
1f0b0 20 63 68 61 72 29 28 78 29 5d 29 0a 23 65 6c 73 char)(x)]).#els
1f0c0 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 e.# define sqlit
1f0d0 65 33 54 6f 75 70 70 65 72 28 78 29 20 20 20 74 e3Toupper(x) t
1f0e0 6f 75 70 70 65 72 28 28 75 6e 73 69 67 6e 65 64 oupper((unsigned
1f0f0 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 char)(x)).# def
1f100 69 6e 65 20 73 71 6c 69 74 65 33 49 73 73 70 61 ine sqlite3Isspa
1f110 63 65 28 78 29 20 20 20 69 73 73 70 61 63 65 28 ce(x) isspace(
1f120 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 (unsigned char)(
1f130 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c x)).# define sql
1f140 69 74 65 33 49 73 61 6c 6e 75 6d 28 78 29 20 20 ite3Isalnum(x)
1f150 20 69 73 61 6c 6e 75 6d 28 28 75 6e 73 69 67 6e isalnum((unsign
1f160 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 20 64 ed char)(x)).# d
1f170 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 73 61 efine sqlite3Isa
1f180 6c 70 68 61 28 78 29 20 20 20 69 73 61 6c 70 68 lpha(x) isalph
1f190 61 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 a((unsigned char
1f1a0 29 28 78 29 29 0a 23 20 64 65 66 69 6e 65 20 73 )(x)).# define s
1f1b0 71 6c 69 74 65 33 49 73 64 69 67 69 74 28 78 29 qlite3Isdigit(x)
1f1c0 20 20 20 69 73 64 69 67 69 74 28 28 75 6e 73 69 isdigit((unsi
1f1d0 67 6e 65 64 20 63 68 61 72 29 28 78 29 29 0a 23 gned char)(x)).#
1f1e0 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 define sqlite3I
1f1f0 73 78 64 69 67 69 74 28 78 29 20 20 69 73 78 64 sxdigit(x) isxd
1f200 69 67 69 74 28 28 75 6e 73 69 67 6e 65 64 20 63 igit((unsigned c
1f210 68 61 72 29 28 78 29 29 0a 23 20 64 65 66 69 6e har)(x)).# defin
1f220 65 20 73 71 6c 69 74 65 33 54 6f 6c 6f 77 65 72 e sqlite3Tolower
1f230 28 78 29 20 20 20 74 6f 6c 6f 77 65 72 28 28 75 (x) tolower((u
1f240 6e 73 69 67 6e 65 64 20 63 68 61 72 29 28 78 29 nsigned char)(x)
1f250 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 ).#endif../*.**
1f260 49 6e 74 65 72 6e 61 6c 20 66 75 6e 63 74 69 6f Internal functio
1f270 6e 20 70 72 6f 74 6f 74 79 70 65 73 0a 2a 2f 0a n prototypes.*/.
1f280 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 #define sqlite3S
1f290 74 72 49 43 6d 70 20 73 71 6c 69 74 65 33 5f 73 trICmp sqlite3_s
1f2a0 74 72 69 63 6d 70 0a 69 6e 74 20 73 71 6c 69 74 tricmp.int sqlit
1f2b0 65 33 53 74 72 6c 65 6e 33 30 28 63 6f 6e 73 74 e3Strlen30(const
1f2c0 20 63 68 61 72 2a 29 3b 0a 23 64 65 66 69 6e 65 char*);.#define
1f2d0 20 73 71 6c 69 74 65 33 53 74 72 4e 49 43 6d 70 sqlite3StrNICmp
1f2e0 20 73 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d sqlite3_strnicm
1f2f0 70 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 61 p..int sqlite3Ma
1f300 6c 6c 6f 63 49 6e 69 74 28 76 6f 69 64 29 3b 0a llocInit(void);.
1f310 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 61 6c 6c void sqlite3Mall
1f320 6f 63 45 6e 64 28 76 6f 69 64 29 3b 0a 76 6f 69 ocEnd(void);.voi
1f330 64 20 2a 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 d *sqlite3Malloc
1f340 28 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c (int);.void *sql
1f350 69 74 65 33 4d 61 6c 6c 6f 63 5a 65 72 6f 28 69 ite3MallocZero(i
1f360 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 nt);.void *sqlit
1f370 65 33 44 62 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 e3DbMallocZero(s
1f380 71 6c 69 74 65 33 2a 2c 20 69 6e 74 29 3b 0a 76 qlite3*, int);.v
1f390 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 4d 61 oid *sqlite3DbMa
1f3a0 6c 6c 6f 63 52 61 77 28 73 71 6c 69 74 65 33 2a llocRaw(sqlite3*
1f3b0 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 2a 73 71 , int);.char *sq
1f3c0 6c 69 74 65 33 44 62 53 74 72 44 75 70 28 73 71 lite3DbStrDup(sq
1f3d0 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 lite3*,const cha
1f3e0 72 2a 29 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 r*);.char *sqlit
1f3f0 65 33 44 62 53 74 72 4e 44 75 70 28 73 71 6c 69 e3DbStrNDup(sqli
1f400 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
1f410 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 , int);.void *sq
1f420 6c 69 74 65 33 52 65 61 6c 6c 6f 63 28 76 6f 69 lite3Realloc(voi
1f430 64 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 2a d*, int);.void *
1f440 73 71 6c 69 74 65 33 44 62 52 65 61 6c 6c 6f 63 sqlite3DbRealloc
1f450 4f 72 46 72 65 65 28 73 71 6c 69 74 65 33 20 2a OrFree(sqlite3 *
1f460 2c 20 76 6f 69 64 20 2a 2c 20 69 6e 74 29 3b 0a , void *, int);.
1f470 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 44 62 52 void *sqlite3DbR
1f480 65 61 6c 6c 6f 63 28 73 71 6c 69 74 65 33 20 2a ealloc(sqlite3 *
1f490 2c 20 76 6f 69 64 20 2a 2c 20 69 6e 74 29 3b 0a , void *, int);.
1f4a0 76 6f 69 64 20 73 71 6c 69 74 65 33 44 62 46 72 void sqlite3DbFr
1f4b0 65 65 28 73 71 6c 69 74 65 33 2a 2c 20 76 6f 69 ee(sqlite3*, voi
1f4c0 64 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 d*);.int sqlite3
1f4d0 4d 61 6c 6c 6f 63 53 69 7a 65 28 76 6f 69 64 2a MallocSize(void*
1f4e0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 44 62 );.int sqlite3Db
1f4f0 4d 61 6c 6c 6f 63 53 69 7a 65 28 73 71 6c 69 74 MallocSize(sqlit
1f500 65 33 2a 2c 20 76 6f 69 64 2a 29 3b 0a 76 6f 69 e3*, void*);.voi
1f510 64 20 2a 73 71 6c 69 74 65 33 53 63 72 61 74 63 d *sqlite3Scratc
1f520 68 4d 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f hMalloc(int);.vo
1f530 69 64 20 73 71 6c 69 74 65 33 53 63 72 61 74 63 id sqlite3Scratc
1f540 68 46 72 65 65 28 76 6f 69 64 2a 29 3b 0a 76 6f hFree(void*);.vo
1f550 69 64 20 2a 73 71 6c 69 74 65 33 50 61 67 65 4d id *sqlite3PageM
1f560 61 6c 6c 6f 63 28 69 6e 74 29 3b 0a 76 6f 69 64 alloc(int);.void
1f570 20 73 71 6c 69 74 65 33 50 61 67 65 46 72 65 65 sqlite3PageFree
1f580 28 76 6f 69 64 2a 29 3b 0a 76 6f 69 64 20 73 71 (void*);.void sq
1f590 6c 69 74 65 33 4d 65 6d 53 65 74 44 65 66 61 75 lite3MemSetDefau
1f5a0 6c 74 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 lt(void);.void s
1f5b0 71 6c 69 74 65 33 42 65 6e 69 67 6e 4d 61 6c 6c qlite3BenignMall
1f5c0 6f 63 48 6f 6f 6b 73 28 76 6f 69 64 20 28 2a 29 ocHooks(void (*)
1f5d0 28 76 6f 69 64 29 2c 20 76 6f 69 64 20 28 2a 29 (void), void (*)
1f5e0 28 76 6f 69 64 29 29 3b 0a 69 6e 74 20 73 71 6c (void));.int sql
1f5f0 69 74 65 33 48 65 61 70 4e 65 61 72 6c 79 46 75 ite3HeapNearlyFu
1f600 6c 6c 28 76 6f 69 64 29 3b 0a 0a 2f 2a 0a 2a 2a ll(void);../*.**
1f610 20 4f 6e 20 73 79 73 74 65 6d 73 20 77 69 74 68 On systems with
1f620 20 61 6d 70 6c 65 20 73 74 61 63 6b 20 73 70 61 ample stack spa
1f630 63 65 20 61 6e 64 20 74 68 61 74 20 73 75 70 70 ce and that supp
1f640 6f 72 74 20 61 6c 6c 6f 63 61 28 29 2c 20 6d 61 ort alloca(), ma
1f650 6b 65 0a 2a 2a 20 75 73 65 20 6f 66 20 61 6c 6c ke.** use of all
1f660 6f 63 61 28 29 20 74 6f 20 6f 62 74 61 69 6e 20 oca() to obtain
1f670 73 70 61 63 65 20 66 6f 72 20 6c 61 72 67 65 20 space for large
1f680 61 75 74 6f 6d 61 74 69 63 20 6f 62 6a 65 63 74 automatic object
1f690 73 2e 20 20 42 79 20 64 65 66 61 75 6c 74 2c 0a s. By default,.
1f6a0 2a 2a 20 6f 62 74 61 69 6e 20 73 70 61 63 65 20 ** obtain space
1f6b0 66 72 6f 6d 20 6d 61 6c 6c 6f 63 28 29 2e 0a 2a from malloc()..*
1f6c0 2a 0a 2a 2a 20 54 68 65 20 61 6c 6c 6f 63 61 28 *.** The alloca(
1f6d0 29 20 72 6f 75 74 69 6e 65 20 6e 65 76 65 72 20 ) routine never
1f6e0 72 65 74 75 72 6e 73 20 4e 55 4c 4c 2e 20 20 54 returns NULL. T
1f6f0 68 69 73 20 77 69 6c 6c 20 63 61 75 73 65 20 63 his will cause c
1f700 6f 64 65 20 70 61 74 68 73 0a 2a 2a 20 74 68 61 ode paths.** tha
1f710 74 20 64 65 61 6c 20 77 69 74 68 20 73 71 6c 69 t deal with sqli
1f720 74 65 33 53 74 61 63 6b 41 6c 6c 6f 63 28 29 20 te3StackAlloc()
1f730 66 61 69 6c 75 72 65 73 20 74 6f 20 62 65 20 75 failures to be u
1f740 6e 72 65 61 63 68 61 62 6c 65 2e 0a 2a 2f 0a 23 nreachable..*/.#
1f750 69 66 64 65 66 20 53 51 4c 49 54 45 5f 55 53 45 ifdef SQLITE_USE
1f760 5f 41 4c 4c 4f 43 41 0a 23 20 64 65 66 69 6e 65 _ALLOCA.# define
1f770 20 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c sqlite3StackAll
1f780 6f 63 52 61 77 28 44 2c 4e 29 20 20 20 61 6c 6c ocRaw(D,N) all
1f790 6f 63 61 28 4e 29 0a 23 20 64 65 66 69 6e 65 20 oca(N).# define
1f7a0 73 71 6c 69 74 65 33 53 74 61 63 6b 41 6c 6c 6f sqlite3StackAllo
1f7b0 63 5a 65 72 6f 28 44 2c 4e 29 20 20 6d 65 6d 73 cZero(D,N) mems
1f7c0 65 74 28 61 6c 6c 6f 63 61 28 4e 29 2c 20 30 2c et(alloca(N), 0,
1f7d0 20 4e 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c N).# define sql
1f7e0 69 74 65 33 53 74 61 63 6b 46 72 65 65 28 44 2c ite3StackFree(D,
1f7f0 50 29 20 20 20 20 20 20 20 0a 23 65 6c 73 65 0a P) .#else.
1f800 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
1f810 53 74 61 63 6b 41 6c 6c 6f 63 52 61 77 28 44 2c StackAllocRaw(D,
1f820 4e 29 20 20 20 73 71 6c 69 74 65 33 44 62 4d 61 N) sqlite3DbMa
1f830 6c 6c 6f 63 52 61 77 28 44 2c 4e 29 0a 23 20 64 llocRaw(D,N).# d
1f840 65 66 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 efine sqlite3Sta
1f850 63 6b 41 6c 6c 6f 63 5a 65 72 6f 28 44 2c 4e 29 ckAllocZero(D,N)
1f860 20 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f sqlite3DbMallo
1f870 63 5a 65 72 6f 28 44 2c 4e 29 0a 23 20 64 65 66 cZero(D,N).# def
1f880 69 6e 65 20 73 71 6c 69 74 65 33 53 74 61 63 6b ine sqlite3Stack
1f890 46 72 65 65 28 44 2c 50 29 20 20 20 20 20 20 20 Free(D,P)
1f8a0 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 44 2c sqlite3DbFree(D,
1f8b0 50 29 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 P).#endif..#ifde
1f8c0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
1f8d0 4d 45 4d 53 59 53 33 0a 63 6f 6e 73 74 20 73 71 MEMSYS3.const sq
1f8e0 6c 69 74 65 33 5f 6d 65 6d 5f 6d 65 74 68 6f 64 lite3_mem_method
1f8f0 73 20 2a 73 71 6c 69 74 65 33 4d 65 6d 47 65 74 s *sqlite3MemGet
1f900 4d 65 6d 73 79 73 33 28 76 6f 69 64 29 3b 0a 23 Memsys3(void);.#
1f910 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c endif.#ifdef SQL
1f920 49 54 45 5f 45 4e 41 42 4c 45 5f 4d 45 4d 53 59 ITE_ENABLE_MEMSY
1f930 53 35 0a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 S5.const sqlite3
1f940 5f 6d 65 6d 5f 6d 65 74 68 6f 64 73 20 2a 73 71 _mem_methods *sq
1f950 6c 69 74 65 33 4d 65 6d 47 65 74 4d 65 6d 73 79 lite3MemGetMemsy
1f960 73 35 28 76 6f 69 64 29 3b 0a 23 65 6e 64 69 66 s5(void);.#endif
1f970 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ...#ifndef SQLIT
1f980 45 5f 4d 55 54 45 58 5f 4f 4d 49 54 0a 20 20 73 E_MUTEX_OMIT. s
1f990 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6d 65 74 qlite3_mutex_met
1f9a0 68 6f 64 73 20 63 6f 6e 73 74 20 2a 73 71 6c 69 hods const *sqli
1f9b0 74 65 33 44 65 66 61 75 6c 74 4d 75 74 65 78 28 te3DefaultMutex(
1f9c0 76 6f 69 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 void);. sqlite3
1f9d0 5f 6d 75 74 65 78 5f 6d 65 74 68 6f 64 73 20 63 _mutex_methods c
1f9e0 6f 6e 73 74 20 2a 73 71 6c 69 74 65 33 4e 6f 6f onst *sqlite3Noo
1f9f0 70 4d 75 74 65 78 28 76 6f 69 64 29 3b 0a 20 20 pMutex(void);.
1fa00 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 20 2a 73 sqlite3_mutex *s
1fa10 71 6c 69 74 65 33 4d 75 74 65 78 41 6c 6c 6f 63 qlite3MutexAlloc
1fa20 28 69 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c (int);. int sql
1fa30 69 74 65 33 4d 75 74 65 78 49 6e 69 74 28 76 6f ite3MutexInit(vo
1fa40 69 64 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 id);. int sqlit
1fa50 65 33 4d 75 74 65 78 45 6e 64 28 76 6f 69 64 29 e3MutexEnd(void)
1fa60 3b 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 ;.#endif..int sq
1fa70 6c 69 74 65 33 53 74 61 74 75 73 56 61 6c 75 65 lite3StatusValue
1fa80 28 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 (int);.void sqli
1fa90 74 65 33 53 74 61 74 75 73 41 64 64 28 69 6e 74 te3StatusAdd(int
1faa0 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
1fab0 69 74 65 33 53 74 61 74 75 73 53 65 74 28 69 6e ite3StatusSet(in
1fac0 74 2c 20 69 6e 74 29 3b 0a 0a 23 69 66 6e 64 65 t, int);..#ifnde
1fad0 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c f SQLITE_OMIT_FL
1fae0 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 0a 20 20 69 OATING_POINT. i
1faf0 6e 74 20 73 71 6c 69 74 65 33 49 73 4e 61 4e 28 nt sqlite3IsNaN(
1fb00 64 6f 75 62 6c 65 29 3b 0a 23 65 6c 73 65 0a 23 double);.#else.#
1fb10 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 49 define sqlite3I
1fb20 73 4e 61 4e 28 58 29 20 20 30 0a 23 65 6e 64 69 sNaN(X) 0.#endi
1fb30 66 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 f../*.** An inst
1fb40 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c ance of the foll
1fb50 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 20 owing structure
1fb60 68 6f 6c 64 73 20 69 6e 66 6f 72 6d 61 74 69 6f holds informatio
1fb70 6e 20 61 62 6f 75 74 20 53 51 4c 0a 2a 2a 20 66 n about SQL.** f
1fb80 75 6e 63 74 69 6f 6e 73 20 61 72 67 75 6d 65 6e unctions argumen
1fb90 74 73 20 74 68 61 74 20 61 72 65 20 74 68 65 20 ts that are the
1fba0 70 61 72 61 6d 65 74 65 72 73 20 74 6f 20 74 68 parameters to th
1fbb0 65 20 70 72 69 6e 74 66 28 29 20 66 75 6e 63 74 e printf() funct
1fbc0 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 50 ion..*/.struct P
1fbd0 72 69 6e 74 66 41 72 67 75 6d 65 6e 74 73 20 7b rintfArguments {
1fbe0 0a 20 20 69 6e 74 20 6e 41 72 67 3b 20 20 20 20 . int nArg;
1fbf0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
1fc00 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 61 otal number of a
1fc10 72 67 75 6d 65 6e 74 73 20 2a 2f 0a 20 20 69 6e rguments */. in
1fc20 74 20 6e 55 73 65 64 3b 20 20 20 20 20 20 20 20 t nUsed;
1fc30 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
1fc40 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20 75 73 of arguments us
1fc50 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 73 ed so far */. s
1fc60 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61 qlite3_value **a
1fc70 70 41 72 67 3b 20 20 20 2f 2a 20 54 68 65 20 61 pArg; /* The a
1fc80 72 67 75 6d 65 6e 74 20 76 61 6c 75 65 73 20 2a rgument values *
1fc90 2f 0a 7d 3b 0a 0a 23 64 65 66 69 6e 65 20 53 51 /.};..#define SQ
1fca0 4c 49 54 45 5f 50 52 49 4e 54 46 5f 49 4e 54 45 LITE_PRINTF_INTE
1fcb0 52 4e 41 4c 20 30 78 30 31 0a 23 64 65 66 69 6e RNAL 0x01.#defin
1fcc0 65 20 53 51 4c 49 54 45 5f 50 52 49 4e 54 46 5f e SQLITE_PRINTF_
1fcd0 53 51 4c 46 55 4e 43 20 20 30 78 30 32 0a 76 6f SQLFUNC 0x02.vo
1fce0 69 64 20 73 71 6c 69 74 65 33 56 58 50 72 69 6e id sqlite3VXPrin
1fcf0 74 66 28 53 74 72 41 63 63 75 6d 2a 2c 20 75 33 tf(StrAccum*, u3
1fd00 32 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2, const char*,
1fd10 76 61 5f 6c 69 73 74 29 3b 0a 76 6f 69 64 20 73 va_list);.void s
1fd20 71 6c 69 74 65 33 58 50 72 69 6e 74 66 28 53 74 qlite3XPrintf(St
1fd30 72 41 63 63 75 6d 2a 2c 20 75 33 32 2c 20 63 6f rAccum*, u32, co
1fd40 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b nst char*, ...);
1fd50 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 4d 50 .char *sqlite3MP
1fd60 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a 2c 63 rintf(sqlite3*,c
1fd70 6f 6e 73 74 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 onst char*, ...)
1fd80 3b 0a 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 ;.char *sqlite3V
1fd90 4d 50 72 69 6e 74 66 28 73 71 6c 69 74 65 33 2a MPrintf(sqlite3*
1fda0 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 76 61 ,const char*, va
1fdb0 5f 6c 69 73 74 29 3b 0a 63 68 61 72 20 2a 73 71 _list);.char *sq
1fdc0 6c 69 74 65 33 4d 41 70 70 65 6e 64 66 28 73 71 lite3MAppendf(sq
1fdd0 6c 69 74 65 33 2a 2c 63 68 61 72 2a 2c 63 6f 6e lite3*,char*,con
1fde0 73 74 20 63 68 61 72 2a 2c 2e 2e 2e 29 3b 0a 23 st char*,...);.#
1fdf0 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 if defined(SQLIT
1fe00 45 5f 54 45 53 54 29 20 7c 7c 20 64 65 66 69 6e E_TEST) || defin
1fe10 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 ed(SQLITE_DEBUG)
1fe20 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 44 . void sqlite3D
1fe30 65 62 75 67 50 72 69 6e 74 66 28 63 6f 6e 73 74 ebugPrintf(const
1fe40 20 63 68 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 23 65 char*, ...);.#e
1fe50 6e 64 69 66 0a 23 69 66 20 64 65 66 69 6e 65 64 ndif.#if defined
1fe60 28 53 51 4c 49 54 45 5f 54 45 53 54 29 0a 20 20 (SQLITE_TEST).
1fe70 76 6f 69 64 20 2a 73 71 6c 69 74 65 33 54 65 73 void *sqlite3Tes
1fe80 74 54 65 78 74 54 6f 50 74 72 28 63 6f 6e 73 74 tTextToPtr(const
1fe90 20 63 68 61 72 2a 29 3b 0a 23 65 6e 64 69 66 0a char*);.#endif.
1fea0 0a 2f 2a 20 4f 75 74 70 75 74 20 66 6f 72 6d 61 ./* Output forma
1feb0 74 74 69 6e 67 20 66 6f 72 20 53 51 4c 49 54 45 tting for SQLITE
1fec0 5f 54 45 53 54 43 54 52 4c 5f 45 58 50 4c 41 49 _TESTCTRL_EXPLAI
1fed0 4e 20 2a 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 N */.#if defined
1fee0 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 54 (SQLITE_ENABLE_T
1fef0 52 45 45 5f 45 58 50 4c 41 49 4e 29 0a 20 20 76 REE_EXPLAIN). v
1ff00 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 6c 61 oid sqlite3Expla
1ff10 69 6e 42 65 67 69 6e 28 56 64 62 65 2a 29 3b 0a inBegin(Vdbe*);.
1ff20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 void sqlite3Ex
1ff30 70 6c 61 69 6e 50 72 69 6e 74 66 28 56 64 62 65 plainPrintf(Vdbe
1ff40 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 *, const char*,
1ff50 2e 2e 2e 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c ...);. void sql
1ff60 69 74 65 33 45 78 70 6c 61 69 6e 4e 4c 28 56 64 ite3ExplainNL(Vd
1ff70 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c be*);. void sql
1ff80 69 74 65 33 45 78 70 6c 61 69 6e 50 75 73 68 28 ite3ExplainPush(
1ff90 56 64 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 Vdbe*);. void s
1ffa0 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 50 6f 70 qlite3ExplainPop
1ffb0 28 56 64 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 (Vdbe*);. void
1ffc0 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 46 69 sqlite3ExplainFi
1ffd0 6e 69 73 68 28 56 64 62 65 2a 29 3b 0a 20 20 76 nish(Vdbe*);. v
1ffe0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 6c 61 oid sqlite3Expla
1fff0 69 6e 53 65 6c 65 63 74 28 56 64 62 65 2a 2c 20 inSelect(Vdbe*,
20000 53 65 6c 65 63 74 2a 29 3b 0a 20 20 76 6f 69 64 Select*);. void
20010 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 45 sqlite3ExplainE
20020 78 70 72 28 56 64 62 65 2a 2c 20 45 78 70 72 2a xpr(Vdbe*, Expr*
20030 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
20040 33 45 78 70 6c 61 69 6e 45 78 70 72 4c 69 73 74 3ExplainExprList
20050 28 56 64 62 65 2a 2c 20 45 78 70 72 4c 69 73 74 (Vdbe*, ExprList
20060 2a 29 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 *);. const char
20070 20 2a 73 71 6c 69 74 65 33 56 64 62 65 45 78 70 *sqlite3VdbeExp
20080 6c 61 6e 61 74 69 6f 6e 28 56 64 62 65 2a 29 3b lanation(Vdbe*);
20090 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 .#else.# define
200a0 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 42 65 sqlite3ExplainBe
200b0 67 69 6e 28 58 29 0a 23 20 64 65 66 69 6e 65 20 gin(X).# define
200c0 73 71 6c 69 74 65 33 45 78 70 6c 61 69 6e 53 65 sqlite3ExplainSe
200d0 6c 65 63 74 28 41 2c 42 29 0a 23 20 64 65 66 69 lect(A,B).# defi
200e0 6e 65 20 73 71 6c 69 74 65 33 45 78 70 6c 61 69 ne sqlite3Explai
200f0 6e 45 78 70 72 28 41 2c 42 29 0a 23 20 64 65 66 nExpr(A,B).# def
20100 69 6e 65 20 73 71 6c 69 74 65 33 45 78 70 6c 61 ine sqlite3Expla
20110 69 6e 45 78 70 72 4c 69 73 74 28 41 2c 42 29 0a inExprList(A,B).
20120 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
20130 45 78 70 6c 61 69 6e 46 69 6e 69 73 68 28 58 29 ExplainFinish(X)
20140 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
20150 33 56 64 62 65 45 78 70 6c 61 6e 61 74 69 6f 6e 3VdbeExplanation
20160 28 58 29 20 30 0a 23 65 6e 64 69 66 0a 0a 0a 76 (X) 0.#endif...v
20170 6f 69 64 20 73 71 6c 69 74 65 33 53 65 74 53 74 oid sqlite3SetSt
20180 72 69 6e 67 28 63 68 61 72 20 2a 2a 2c 20 73 71 ring(char **, sq
20190 6c 69 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 lite3*, const ch
201a0 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 64 20 ar*, ...);.void
201b0 73 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28 sqlite3ErrorMsg(
201c0 50 61 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 Parse*, const ch
201d0 61 72 2a 2c 20 2e 2e 2e 29 3b 0a 69 6e 74 20 73 ar*, ...);.int s
201e0 71 6c 69 74 65 33 44 65 71 75 6f 74 65 28 63 68 qlite3Dequote(ch
201f0 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 ar*);.int sqlite
20200 33 4b 65 79 77 6f 72 64 43 6f 64 65 28 63 6f 6e 3KeywordCode(con
20210 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 st unsigned char
20220 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c *, int);.int sql
20230 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 50 61 ite3RunParser(Pa
20240 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 rse*, const char
20250 2a 2c 20 63 68 61 72 20 2a 2a 29 3b 0a 76 6f 69 *, char **);.voi
20260 64 20 73 71 6c 69 74 65 33 46 69 6e 69 73 68 43 d sqlite3FinishC
20270 6f 64 69 6e 67 28 50 61 72 73 65 2a 29 3b 0a 69 oding(Parse*);.i
20280 6e 74 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d nt sqlite3GetTem
20290 70 52 65 67 28 50 61 72 73 65 2a 29 3b 0a 76 6f pReg(Parse*);.vo
202a0 69 64 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 id sqlite3Releas
202b0 65 54 65 6d 70 52 65 67 28 50 61 72 73 65 2a 2c eTempReg(Parse*,
202c0 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 int);.int sqlite
202d0 33 47 65 74 54 65 6d 70 52 61 6e 67 65 28 50 61 3GetTempRange(Pa
202e0 72 73 65 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 rse*,int);.void
202f0 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 65 sqlite3ReleaseTe
20300 6d 70 52 61 6e 67 65 28 50 61 72 73 65 2a 2c 69 mpRange(Parse*,i
20310 6e 74 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 nt,int);.void sq
20320 6c 69 74 65 33 43 6c 65 61 72 54 65 6d 70 52 65 lite3ClearTempRe
20330 67 43 61 63 68 65 28 50 61 72 73 65 2a 29 3b 0a gCache(Parse*);.
20340 45 78 70 72 20 2a 73 71 6c 69 74 65 33 45 78 70 Expr *sqlite3Exp
20350 72 41 6c 6c 6f 63 28 73 71 6c 69 74 65 33 2a 2c rAlloc(sqlite3*,
20360 69 6e 74 2c 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a int,const Token*
20370 2c 69 6e 74 29 3b 0a 45 78 70 72 20 2a 73 71 6c ,int);.Expr *sql
20380 69 74 65 33 45 78 70 72 28 73 71 6c 69 74 65 33 ite3Expr(sqlite3
20390 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 *,int,const char
203a0 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
203b0 45 78 70 72 41 74 74 61 63 68 53 75 62 74 72 65 ExprAttachSubtre
203c0 65 73 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 es(sqlite3*,Expr
203d0 2a 2c 45 78 70 72 2a 2c 45 78 70 72 2a 29 3b 0a *,Expr*,Expr*);.
203e0 45 78 70 72 20 2a 73 71 6c 69 74 65 33 50 45 78 Expr *sqlite3PEx
203f0 70 72 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c 20 pr(Parse*, int,
20400 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 63 6f Expr*, Expr*, co
20410 6e 73 74 20 54 6f 6b 65 6e 2a 29 3b 0a 45 78 70 nst Token*);.Exp
20420 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 41 6e r *sqlite3ExprAn
20430 64 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a d(sqlite3*,Expr*
20440 2c 20 45 78 70 72 2a 29 3b 0a 45 78 70 72 20 2a , Expr*);.Expr *
20450 73 71 6c 69 74 65 33 45 78 70 72 46 75 6e 63 74 sqlite3ExprFunct
20460 69 6f 6e 28 50 61 72 73 65 2a 2c 45 78 70 72 4c ion(Parse*,ExprL
20470 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 ist*, Token*);.v
20480 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 41 oid sqlite3ExprA
20490 73 73 69 67 6e 56 61 72 4e 75 6d 62 65 72 28 50 ssignVarNumber(P
204a0 61 72 73 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 arse*, Expr*);.v
204b0 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 44 oid sqlite3ExprD
204c0 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 elete(sqlite3*,
204d0 45 78 70 72 2a 29 3b 0a 45 78 70 72 4c 69 73 74 Expr*);.ExprList
204e0 20 2a 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 *sqlite3ExprLis
204f0 74 41 70 70 65 6e 64 28 50 61 72 73 65 2a 2c 45 tAppend(Parse*,E
20500 78 70 72 4c 69 73 74 2a 2c 45 78 70 72 2a 29 3b xprList*,Expr*);
20510 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
20520 72 4c 69 73 74 53 65 74 4e 61 6d 65 28 50 61 72 rListSetName(Par
20530 73 65 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 54 6f se*,ExprList*,To
20540 6b 65 6e 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 ken*,int);.void
20550 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 53 sqlite3ExprListS
20560 65 74 53 70 61 6e 28 50 61 72 73 65 2a 2c 45 78 etSpan(Parse*,Ex
20570 70 72 4c 69 73 74 2a 2c 45 78 70 72 53 70 61 6e prList*,ExprSpan
20580 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
20590 45 78 70 72 4c 69 73 74 44 65 6c 65 74 65 28 73 ExprListDelete(s
205a0 71 6c 69 74 65 33 2a 2c 20 45 78 70 72 4c 69 73 qlite3*, ExprLis
205b0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
205c0 49 6e 69 74 28 73 71 6c 69 74 65 33 2a 2c 20 63 Init(sqlite3*, c
205d0 68 61 72 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 har**);.int sqli
205e0 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 te3InitCallback(
205f0 76 6f 69 64 2a 2c 20 69 6e 74 2c 20 63 68 61 72 void*, int, char
20600 2a 2a 2c 20 63 68 61 72 2a 2a 29 3b 0a 76 6f 69 **, char**);.voi
20610 64 20 73 71 6c 69 74 65 33 50 72 61 67 6d 61 28 d sqlite3Pragma(
20620 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f Parse*,Token*,To
20630 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 29 ken*,Token*,int)
20640 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 ;.void sqlite3Re
20650 73 65 74 41 6c 6c 53 63 68 65 6d 61 73 4f 66 43 setAllSchemasOfC
20660 6f 6e 6e 65 63 74 69 6f 6e 28 73 71 6c 69 74 65 onnection(sqlite
20670 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 3*);.void sqlite
20680 33 52 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 3ResetOneSchema(
20690 73 71 6c 69 74 65 33 2a 2c 69 6e 74 29 3b 0a 76 sqlite3*,int);.v
206a0 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6c 6c 61 oid sqlite3Colla
206b0 70 73 65 44 61 74 61 62 61 73 65 41 72 72 61 79 pseDatabaseArray
206c0 28 73 71 6c 69 74 65 33 2a 29 3b 0a 76 6f 69 64 (sqlite3*);.void
206d0 20 73 71 6c 69 74 65 33 42 65 67 69 6e 50 61 72 sqlite3BeginPar
206e0 73 65 28 50 61 72 73 65 2a 2c 69 6e 74 29 3b 0a se(Parse*,int);.
206f0 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6d 6d void sqlite3Comm
20700 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 itInternalChange
20710 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a 54 61 62 s(sqlite3*);.Tab
20720 6c 65 20 2a 73 71 6c 69 74 65 33 52 65 73 75 6c le *sqlite3Resul
20730 74 53 65 74 4f 66 53 65 6c 65 63 74 28 50 61 72 tSetOfSelect(Par
20740 73 65 2a 2c 53 65 6c 65 63 74 2a 29 3b 0a 76 6f se*,Select*);.vo
20750 69 64 20 73 71 6c 69 74 65 33 4f 70 65 6e 4d 61 id sqlite3OpenMa
20760 73 74 65 72 54 61 62 6c 65 28 50 61 72 73 65 20 sterTable(Parse
20770 2a 2c 20 69 6e 74 29 3b 0a 49 6e 64 65 78 20 2a *, int);.Index *
20780 73 71 6c 69 74 65 33 50 72 69 6d 61 72 79 4b 65 sqlite3PrimaryKe
20790 79 49 6e 64 65 78 28 54 61 62 6c 65 2a 29 3b 0a yIndex(Table*);.
207a0 69 31 36 20 73 71 6c 69 74 65 33 43 6f 6c 75 6d i16 sqlite3Colum
207b0 6e 4f 66 49 6e 64 65 78 28 49 6e 64 65 78 2a 2c nOfIndex(Index*,
207c0 20 69 31 36 29 3b 0a 76 6f 69 64 20 73 71 6c 69 i16);.void sqli
207d0 74 65 33 53 74 61 72 74 54 61 62 6c 65 28 50 61 te3StartTable(Pa
207e0 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b 65 rse*,Token*,Toke
207f0 6e 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 n*,int,int,int,i
20800 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
20810 33 41 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 3AddColumn(Parse
20820 2a 2c 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 *,Token*);.void
20830 73 71 6c 69 74 65 33 41 64 64 4e 6f 74 4e 75 6c sqlite3AddNotNul
20840 6c 28 50 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a l(Parse*, int);.
20850 76 6f 69 64 20 73 71 6c 69 74 65 33 41 64 64 50 void sqlite3AddP
20860 72 69 6d 61 72 79 4b 65 79 28 50 61 72 73 65 2a rimaryKey(Parse*
20870 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 , ExprList*, int
20880 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
20890 64 20 73 71 6c 69 74 65 33 41 64 64 43 68 65 63 d sqlite3AddChec
208a0 6b 43 6f 6e 73 74 72 61 69 6e 74 28 50 61 72 73 kConstraint(Pars
208b0 65 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 e*, Expr*);.void
208c0 20 73 71 6c 69 74 65 33 41 64 64 43 6f 6c 75 6d sqlite3AddColum
208d0 6e 54 79 70 65 28 50 61 72 73 65 2a 2c 54 6f 6b nType(Parse*,Tok
208e0 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 en*);.void sqlit
208f0 65 33 41 64 64 44 65 66 61 75 6c 74 56 61 6c 75 e3AddDefaultValu
20900 65 28 50 61 72 73 65 2a 2c 45 78 70 72 53 70 61 e(Parse*,ExprSpa
20910 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 n*);.void sqlite
20920 33 41 64 64 43 6f 6c 6c 61 74 65 54 79 70 65 28 3AddCollateType(
20930 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 29 3b Parse*, Token*);
20940 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 6e 64 .void sqlite3End
20950 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 54 6f 6b Table(Parse*,Tok
20960 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 75 38 2c 53 65 en*,Token*,u8,Se
20970 6c 65 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 lect*);.int sqli
20980 74 65 33 50 61 72 73 65 55 72 69 28 63 6f 6e 73 te3ParseUri(cons
20990 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 t char*,const ch
209a0 61 72 2a 2c 75 6e 73 69 67 6e 65 64 20 69 6e 74 ar*,unsigned int
209b0 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 *,.
209c0 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 76 sqlite3_v
209d0 66 73 2a 2a 2c 63 68 61 72 2a 2a 2c 63 68 61 72 fs**,char**,char
209e0 20 2a 2a 29 3b 0a 42 74 72 65 65 20 2a 73 71 6c **);.Btree *sql
209f0 69 74 65 33 44 62 4e 61 6d 65 54 6f 42 74 72 65 ite3DbNameToBtre
20a00 65 28 73 71 6c 69 74 65 33 2a 2c 63 6f 6e 73 74 e(sqlite3*,const
20a10 20 63 68 61 72 2a 29 3b 0a 69 6e 74 20 73 71 6c char*);.int sql
20a20 69 74 65 33 43 6f 64 65 4f 6e 63 65 28 50 61 72 ite3CodeOnce(Par
20a30 73 65 20 2a 29 3b 0a 0a 23 69 66 64 65 66 20 53 se *);..#ifdef S
20a40 51 4c 49 54 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 QLITE_OMIT_BUILT
20a50 49 4e 5f 54 45 53 54 0a 23 20 64 65 66 69 6e 65 IN_TEST.# define
20a60 20 73 71 6c 69 74 65 33 46 61 75 6c 74 53 69 6d sqlite3FaultSim
20a70 28 58 29 20 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 (X) SQLITE_OK.#e
20a80 6c 73 65 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 lse. int sqlite
20a90 33 46 61 75 6c 74 53 69 6d 28 69 6e 74 29 3b 0a 3FaultSim(int);.
20aa0 23 65 6e 64 69 66 0a 0a 42 69 74 76 65 63 20 2a #endif..Bitvec *
20ab0 73 71 6c 69 74 65 33 42 69 74 76 65 63 43 72 65 sqlite3BitvecCre
20ac0 61 74 65 28 75 33 32 29 3b 0a 69 6e 74 20 73 71 ate(u32);.int sq
20ad0 6c 69 74 65 33 42 69 74 76 65 63 54 65 73 74 28 lite3BitvecTest(
20ae0 42 69 74 76 65 63 2a 2c 20 75 33 32 29 3b 0a 69 Bitvec*, u32);.i
20af0 6e 74 20 73 71 6c 69 74 65 33 42 69 74 76 65 63 nt sqlite3Bitvec
20b00 53 65 74 28 42 69 74 76 65 63 2a 2c 20 75 33 32 Set(Bitvec*, u32
20b10 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 );.void sqlite3B
20b20 69 74 76 65 63 43 6c 65 61 72 28 42 69 74 76 65 itvecClear(Bitve
20b30 63 2a 2c 20 75 33 32 2c 20 76 6f 69 64 2a 29 3b c*, u32, void*);
20b40 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 42 69 74 .void sqlite3Bit
20b50 76 65 63 44 65 73 74 72 6f 79 28 42 69 74 76 65 vecDestroy(Bitve
20b60 63 2a 29 3b 0a 75 33 32 20 73 71 6c 69 74 65 33 c*);.u32 sqlite3
20b70 42 69 74 76 65 63 53 69 7a 65 28 42 69 74 76 65 BitvecSize(Bitve
20b80 63 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 c*);.int sqlite3
20b90 42 69 74 76 65 63 42 75 69 6c 74 69 6e 54 65 73 BitvecBuiltinTes
20ba0 74 28 69 6e 74 2c 69 6e 74 2a 29 3b 0a 0a 52 6f t(int,int*);..Ro
20bb0 77 53 65 74 20 2a 73 71 6c 69 74 65 33 52 6f 77 wSet *sqlite3Row
20bc0 53 65 74 49 6e 69 74 28 73 71 6c 69 74 65 33 2a SetInit(sqlite3*
20bd0 2c 20 76 6f 69 64 2a 2c 20 75 6e 73 69 67 6e 65 , void*, unsigne
20be0 64 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c d int);.void sql
20bf0 69 74 65 33 52 6f 77 53 65 74 43 6c 65 61 72 28 ite3RowSetClear(
20c00 52 6f 77 53 65 74 2a 29 3b 0a 76 6f 69 64 20 73 RowSet*);.void s
20c10 71 6c 69 74 65 33 52 6f 77 53 65 74 49 6e 73 65 qlite3RowSetInse
20c20 72 74 28 52 6f 77 53 65 74 2a 2c 20 69 36 34 29 rt(RowSet*, i64)
20c30 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 6f 77 ;.int sqlite3Row
20c40 53 65 74 54 65 73 74 28 52 6f 77 53 65 74 2a 2c SetTest(RowSet*,
20c50 20 69 6e 74 20 69 42 61 74 63 68 2c 20 69 36 34 int iBatch, i64
20c60 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 6f );.int sqlite3Ro
20c70 77 53 65 74 4e 65 78 74 28 52 6f 77 53 65 74 2a wSetNext(RowSet*
20c80 2c 20 69 36 34 2a 29 3b 0a 0a 76 6f 69 64 20 73 , i64*);..void s
20c90 71 6c 69 74 65 33 43 72 65 61 74 65 56 69 65 77 qlite3CreateView
20ca0 28 50 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 (Parse*,Token*,T
20cb0 6f 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 53 65 6c oken*,Token*,Sel
20cc0 65 63 74 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 0a ect*,int,int);..
20cd0 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c #if !defined(SQL
20ce0 49 54 45 5f 4f 4d 49 54 5f 56 49 45 57 29 20 7c ITE_OMIT_VIEW) |
20cf0 7c 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 | !defined(SQLIT
20d00 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 E_OMIT_VIRTUALTA
20d10 42 4c 45 29 0a 20 20 69 6e 74 20 73 71 6c 69 74 BLE). int sqlit
20d20 65 33 56 69 65 77 47 65 74 43 6f 6c 75 6d 6e 4e e3ViewGetColumnN
20d30 61 6d 65 73 28 50 61 72 73 65 2a 2c 54 61 62 6c ames(Parse*,Tabl
20d40 65 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 e*);.#else.# def
20d50 69 6e 65 20 73 71 6c 69 74 65 33 56 69 65 77 47 ine sqlite3ViewG
20d60 65 74 43 6f 6c 75 6d 6e 4e 61 6d 65 73 28 41 2c etColumnNames(A,
20d70 42 29 20 30 0a 23 65 6e 64 69 66 0a 0a 76 6f 69 B) 0.#endif..voi
20d80 64 20 73 71 6c 69 74 65 33 44 72 6f 70 54 61 62 d sqlite3DropTab
20d90 6c 65 28 50 61 72 73 65 2a 2c 20 53 72 63 4c 69 le(Parse*, SrcLi
20da0 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a st*, int, int);.
20db0 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 void sqlite3Code
20dc0 44 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a DropTable(Parse*
20dd0 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 , Table*, int, i
20de0 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
20df0 33 44 65 6c 65 74 65 54 61 62 6c 65 28 73 71 6c 3DeleteTable(sql
20e00 69 74 65 33 2a 2c 20 54 61 62 6c 65 2a 29 3b 0a ite3*, Table*);.
20e10 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
20e20 4d 49 54 5f 41 55 54 4f 49 4e 43 52 45 4d 45 4e MIT_AUTOINCREMEN
20e30 54 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 T. void sqlite3
20e40 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 42 65 67 AutoincrementBeg
20e50 69 6e 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 in(Parse *pParse
20e60 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 );. void sqlite
20e70 33 41 75 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 3AutoincrementEn
20e80 64 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 29 d(Parse *pParse)
20e90 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 ;.#else.# define
20ea0 20 73 71 6c 69 74 65 33 41 75 74 6f 69 6e 63 72 sqlite3Autoincr
20eb0 65 6d 65 6e 74 42 65 67 69 6e 28 58 29 0a 23 20 ementBegin(X).#
20ec0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 41 75 define sqlite3Au
20ed0 74 6f 69 6e 63 72 65 6d 65 6e 74 45 6e 64 28 58 toincrementEnd(X
20ee0 29 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 ).#endif.void sq
20ef0 6c 69 74 65 33 49 6e 73 65 72 74 28 50 61 72 73 lite3Insert(Pars
20f00 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 53 65 e*, SrcList*, Se
20f10 6c 65 63 74 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 lect*, IdList*,
20f20 69 6e 74 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 int);.void *sqli
20f30 74 65 33 41 72 72 61 79 41 6c 6c 6f 63 61 74 65 te3ArrayAllocate
20f40 28 73 71 6c 69 74 65 33 2a 2c 76 6f 69 64 2a 2c (sqlite3*,void*,
20f50 69 6e 74 2c 69 6e 74 2a 2c 69 6e 74 2a 29 3b 0a int,int*,int*);.
20f60 49 64 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 IdList *sqlite3I
20f70 64 4c 69 73 74 41 70 70 65 6e 64 28 73 71 6c 69 dListAppend(sqli
20f80 74 65 33 2a 2c 20 49 64 4c 69 73 74 2a 2c 20 54 te3*, IdList*, T
20f90 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 oken*);.int sqli
20fa0 74 65 33 49 64 4c 69 73 74 49 6e 64 65 78 28 49 te3IdListIndex(I
20fb0 64 4c 69 73 74 2a 2c 63 6f 6e 73 74 20 63 68 61 dList*,const cha
20fc0 72 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 r*);.SrcList *sq
20fd0 6c 69 74 65 33 53 72 63 4c 69 73 74 45 6e 6c 61 lite3SrcListEnla
20fe0 72 67 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 rge(sqlite3*, Sr
20ff0 63 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 cList*, int, int
21000 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 71 6c 69 );.SrcList *sqli
21010 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e 64 te3SrcListAppend
21020 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 63 4c 69 (sqlite3*, SrcLi
21030 73 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 6f 6b st*, Token*, Tok
21040 65 6e 2a 29 3b 0a 53 72 63 4c 69 73 74 20 2a 73 en*);.SrcList *s
21050 71 6c 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 qlite3SrcListApp
21060 65 6e 64 46 72 6f 6d 54 65 72 6d 28 50 61 72 73 endFromTerm(Pars
21070 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 54 6f e*, SrcList*, To
21080 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 0a 20 20 ken*, Token*,.
21090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
210a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
210b0 20 20 20 20 54 6f 6b 65 6e 2a 2c 20 53 65 6c 65 Token*, Sele
210c0 63 74 2a 2c 20 45 78 70 72 2a 2c 20 49 64 4c 69 ct*, Expr*, IdLi
210d0 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 st*);.void sqlit
210e0 65 33 53 72 63 4c 69 73 74 49 6e 64 65 78 65 64 e3SrcListIndexed
210f0 42 79 28 50 61 72 73 65 20 2a 2c 20 53 72 63 4c By(Parse *, SrcL
21100 69 73 74 20 2a 2c 20 54 6f 6b 65 6e 20 2a 29 3b ist *, Token *);
21110 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 65 .int sqlite3Inde
21120 78 65 64 42 79 4c 6f 6f 6b 75 70 28 50 61 72 73 xedByLookup(Pars
21130 65 20 2a 2c 20 73 74 72 75 63 74 20 53 72 63 4c e *, struct SrcL
21140 69 73 74 5f 69 74 65 6d 20 2a 29 3b 0a 76 6f 69 ist_item *);.voi
21150 64 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 d sqlite3SrcList
21160 53 68 69 66 74 4a 6f 69 6e 54 79 70 65 28 53 72 ShiftJoinType(Sr
21170 63 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 20 73 71 cList*);.void sq
21180 6c 69 74 65 33 53 72 63 4c 69 73 74 41 73 73 69 lite3SrcListAssi
21190 67 6e 43 75 72 73 6f 72 73 28 50 61 72 73 65 2a gnCursors(Parse*
211a0 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 76 6f 69 , SrcList*);.voi
211b0 64 20 73 71 6c 69 74 65 33 49 64 4c 69 73 74 44 d sqlite3IdListD
211c0 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 elete(sqlite3*,
211d0 49 64 4c 69 73 74 2a 29 3b 0a 76 6f 69 64 20 73 IdList*);.void s
211e0 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 65 6c qlite3SrcListDel
211f0 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 53 72 ete(sqlite3*, Sr
21200 63 4c 69 73 74 2a 29 3b 0a 49 6e 64 65 78 20 2a cList*);.Index *
21210 73 71 6c 69 74 65 33 41 6c 6c 6f 63 61 74 65 49 sqlite3AllocateI
21220 6e 64 65 78 4f 62 6a 65 63 74 28 73 71 6c 69 74 ndexObject(sqlit
21230 65 33 2a 2c 69 31 36 2c 69 6e 74 2c 63 68 61 72 e3*,i16,int,char
21240 2a 2a 29 3b 0a 49 6e 64 65 78 20 2a 73 71 6c 69 **);.Index *sqli
21250 74 65 33 43 72 65 61 74 65 49 6e 64 65 78 28 50 te3CreateIndex(P
21260 61 72 73 65 2a 2c 54 6f 6b 65 6e 2a 2c 54 6f 6b arse*,Token*,Tok
21270 65 6e 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 en*,SrcList*,Exp
21280 72 4c 69 73 74 2a 2c 69 6e 74 2c 54 6f 6b 65 6e rList*,int,Token
21290 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 *,.
212a0 20 20 20 20 20 20 20 20 20 20 20 20 20 45 78 70 Exp
212b0 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 r*, int, int);.v
212c0 6f 69 64 20 73 71 6c 69 74 65 33 44 72 6f 70 49 oid sqlite3DropI
212d0 6e 64 65 78 28 50 61 72 73 65 2a 2c 20 53 72 63 ndex(Parse*, Src
212e0 4c 69 73 74 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 List*, int);.int
212f0 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 28 50 sqlite3Select(P
21300 61 72 73 65 2a 2c 20 53 65 6c 65 63 74 2a 2c 20 arse*, Select*,
21310 53 65 6c 65 63 74 44 65 73 74 2a 29 3b 0a 53 65 SelectDest*);.Se
21320 6c 65 63 74 20 2a 73 71 6c 69 74 65 33 53 65 6c lect *sqlite3Sel
21330 65 63 74 4e 65 77 28 50 61 72 73 65 2a 2c 45 78 ectNew(Parse*,Ex
21340 70 72 4c 69 73 74 2a 2c 53 72 63 4c 69 73 74 2a prList*,SrcList*
21350 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 74 2a ,Expr*,ExprList*
21360 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
21370 20 20 20 20 20 20 20 20 20 20 20 45 78 70 72 2a Expr*
21380 2c 45 78 70 72 4c 69 73 74 2a 2c 75 31 36 2c 45 ,ExprList*,u16,E
21390 78 70 72 2a 2c 45 78 70 72 2a 29 3b 0a 76 6f 69 xpr*,Expr*);.voi
213a0 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 d sqlite3SelectD
213b0 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c 20 elete(sqlite3*,
213c0 53 65 6c 65 63 74 2a 29 3b 0a 54 61 62 6c 65 20 Select*);.Table
213d0 2a 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 4c *sqlite3SrcListL
213e0 6f 6f 6b 75 70 28 50 61 72 73 65 2a 2c 20 53 72 ookup(Parse*, Sr
213f0 63 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c cList*);.int sql
21400 69 74 65 33 49 73 52 65 61 64 4f 6e 6c 79 28 50 ite3IsReadOnly(P
21410 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 arse*, Table*, i
21420 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 nt);.void sqlite
21430 33 4f 70 65 6e 54 61 62 6c 65 28 50 61 72 73 65 3OpenTable(Parse
21440 2a 2c 20 69 6e 74 20 69 43 75 72 2c 20 69 6e 74 *, int iCur, int
21450 20 69 44 62 2c 20 54 61 62 6c 65 2a 2c 20 69 6e iDb, Table*, in
21460 74 29 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 t);.#if defined(
21470 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 55 50 SQLITE_ENABLE_UP
21480 44 41 54 45 5f 44 45 4c 45 54 45 5f 4c 49 4d 49 DATE_DELETE_LIMI
21490 54 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 T) && !defined(S
214a0 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 55 42 51 55 QLITE_OMIT_SUBQU
214b0 45 52 59 29 0a 45 78 70 72 20 2a 73 71 6c 69 74 ERY).Expr *sqlit
214c0 65 33 4c 69 6d 69 74 57 68 65 72 65 28 50 61 72 e3LimitWhere(Par
214d0 73 65 2a 2c 53 72 63 4c 69 73 74 2a 2c 45 78 70 se*,SrcList*,Exp
214e0 72 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 45 78 70 r*,ExprList*,Exp
214f0 72 2a 2c 45 78 70 72 2a 2c 63 68 61 72 2a 29 3b r*,Expr*,char*);
21500 0a 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c .#endif.void sql
21510 69 74 65 33 44 65 6c 65 74 65 46 72 6f 6d 28 50 ite3DeleteFrom(P
21520 61 72 73 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c arse*, SrcList*,
21530 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 Expr*);.void sq
21540 6c 69 74 65 33 55 70 64 61 74 65 28 50 61 72 73 lite3Update(Pars
21550 65 2a 2c 20 53 72 63 4c 69 73 74 2a 2c 20 45 78 e*, SrcList*, Ex
21560 70 72 4c 69 73 74 2a 2c 20 45 78 70 72 2a 2c 20 prList*, Expr*,
21570 69 6e 74 29 3b 0a 57 68 65 72 65 49 6e 66 6f 20 int);.WhereInfo
21580 2a 73 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 *sqlite3WhereBeg
21590 69 6e 28 50 61 72 73 65 2a 2c 53 72 63 4c 69 73 in(Parse*,SrcLis
215a0 74 2a 2c 45 78 70 72 2a 2c 45 78 70 72 4c 69 73 t*,Expr*,ExprLis
215b0 74 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 75 31 36 t*,ExprList*,u16
215c0 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
215d0 74 65 33 57 68 65 72 65 45 6e 64 28 57 68 65 72 te3WhereEnd(Wher
215e0 65 49 6e 66 6f 2a 29 3b 0a 75 36 34 20 73 71 6c eInfo*);.u64 sql
215f0 69 74 65 33 57 68 65 72 65 4f 75 74 70 75 74 52 ite3WhereOutputR
21600 6f 77 43 6f 75 6e 74 28 57 68 65 72 65 49 6e 66 owCount(WhereInf
21610 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 o*);.int sqlite3
21620 57 68 65 72 65 49 73 44 69 73 74 69 6e 63 74 28 WhereIsDistinct(
21630 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 WhereInfo*);.int
21640 20 73 71 6c 69 74 65 33 57 68 65 72 65 49 73 4f sqlite3WhereIsO
21650 72 64 65 72 65 64 28 57 68 65 72 65 49 6e 66 6f rdered(WhereInfo
21660 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 *);.int sqlite3W
21670 68 65 72 65 49 73 53 6f 72 74 65 64 28 57 68 65 hereIsSorted(Whe
21680 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 20 73 71 reInfo*);.int sq
21690 6c 69 74 65 33 57 68 65 72 65 43 6f 6e 74 69 6e lite3WhereContin
216a0 75 65 4c 61 62 65 6c 28 57 68 65 72 65 49 6e 66 ueLabel(WhereInf
216b0 6f 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 o*);.int sqlite3
216c0 57 68 65 72 65 42 72 65 61 6b 4c 61 62 65 6c 28 WhereBreakLabel(
216d0 57 68 65 72 65 49 6e 66 6f 2a 29 3b 0a 69 6e 74 WhereInfo*);.int
216e0 20 73 71 6c 69 74 65 33 57 68 65 72 65 4f 6b 4f sqlite3WhereOkO
216f0 6e 65 50 61 73 73 28 57 68 65 72 65 49 6e 66 6f nePass(WhereInfo
21700 2a 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 *, int*);.int sq
21710 6c 69 74 65 33 45 78 70 72 43 6f 64 65 47 65 74 lite3ExprCodeGet
21720 43 6f 6c 75 6d 6e 28 50 61 72 73 65 2a 2c 20 54 Column(Parse*, T
21730 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c able*, int, int,
21740 20 69 6e 74 2c 20 75 38 29 3b 0a 76 6f 69 64 20 int, u8);.void
21750 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 47 sqlite3ExprCodeG
21760 65 74 43 6f 6c 75 6d 6e 4f 66 54 61 62 6c 65 28 etColumnOfTable(
21770 56 64 62 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 Vdbe*, Table*, i
21780 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 nt, int, int);.v
21790 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 43 oid sqlite3ExprC
217a0 6f 64 65 4d 6f 76 65 28 50 61 72 73 65 2a 2c 20 odeMove(Parse*,
217b0 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a int, int, int);.
217c0 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
217d0 43 61 63 68 65 53 74 6f 72 65 28 50 61 72 73 65 CacheStore(Parse
217e0 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 69 6e 74 *, int, int, int
217f0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 );.void sqlite3E
21800 78 70 72 43 61 63 68 65 50 75 73 68 28 50 61 72 xprCachePush(Par
21810 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 se*);.void sqlit
21820 65 33 45 78 70 72 43 61 63 68 65 50 6f 70 28 50 e3ExprCachePop(P
21830 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c arse*);.void sql
21840 69 74 65 33 45 78 70 72 43 61 63 68 65 52 65 6d ite3ExprCacheRem
21850 6f 76 65 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c ove(Parse*, int,
21860 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
21870 74 65 33 45 78 70 72 43 61 63 68 65 43 6c 65 61 te3ExprCacheClea
21880 72 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 r(Parse*);.void
21890 73 71 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 sqlite3ExprCache
218a0 41 66 66 69 6e 69 74 79 43 68 61 6e 67 65 28 50 AffinityChange(P
218b0 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 arse*, int, int)
218c0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
218d0 70 72 43 6f 64 65 28 50 61 72 73 65 2a 2c 20 45 prCode(Parse*, E
218e0 78 70 72 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 xpr*, int);.void
218f0 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 64 65 sqlite3ExprCode
21900 46 61 63 74 6f 72 61 62 6c 65 28 50 61 72 73 65 Factorable(Parse
21910 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a *, Expr*, int);.
21920 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
21930 43 6f 64 65 41 74 49 6e 69 74 28 50 61 72 73 65 CodeAtInit(Parse
21940 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 75 *, Expr*, int, u
21950 38 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 8);.int sqlite3E
21960 78 70 72 43 6f 64 65 54 65 6d 70 28 50 61 72 73 xprCodeTemp(Pars
21970 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2a 29 e*, Expr*, int*)
21980 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 ;.int sqlite3Exp
21990 72 43 6f 64 65 54 61 72 67 65 74 28 50 61 72 73 rCodeTarget(Pars
219a0 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b e*, Expr*, int);
219b0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
219c0 72 43 6f 64 65 41 6e 64 43 61 63 68 65 28 50 61 rCodeAndCache(Pa
219d0 72 73 65 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 rse*, Expr*, int
219e0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 );.int sqlite3Ex
219f0 70 72 43 6f 64 65 45 78 70 72 4c 69 73 74 28 50 prCodeExprList(P
21a00 61 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 2a arse*, ExprList*
21a10 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 23 64 65 66 , int, u8);.#def
21a20 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 4c 5f ine SQLITE_ECEL_
21a30 44 55 50 20 20 20 20 20 20 30 78 30 31 20 20 2f DUP 0x01 /
21a40 2a 20 44 65 65 70 2c 20 6e 6f 74 20 73 68 61 6c * Deep, not shal
21a50 6c 6f 77 20 63 6f 70 69 65 73 20 2a 2f 0a 23 64 low copies */.#d
21a60 65 66 69 6e 65 20 53 51 4c 49 54 45 5f 45 43 45 efine SQLITE_ECE
21a70 4c 5f 46 41 43 54 4f 52 20 20 20 30 78 30 32 20 L_FACTOR 0x02
21a80 20 2f 2a 20 46 61 63 74 6f 72 20 6f 75 74 20 63 /* Factor out c
21a90 6f 6e 73 74 61 6e 74 20 74 65 72 6d 73 20 2a 2f onstant terms */
21aa0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 .void sqlite3Exp
21ab0 72 49 66 54 72 75 65 28 50 61 72 73 65 2a 2c 20 rIfTrue(Parse*,
21ac0 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 Expr*, int, int)
21ad0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 ;.void sqlite3Ex
21ae0 70 72 49 66 46 61 6c 73 65 28 50 61 72 73 65 2a prIfFalse(Parse*
21af0 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 69 6e , Expr*, int, in
21b00 74 29 3b 0a 54 61 62 6c 65 20 2a 73 71 6c 69 74 t);.Table *sqlit
21b10 65 33 46 69 6e 64 54 61 62 6c 65 28 73 71 6c 69 e3FindTable(sqli
21b20 74 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a te3*,const char*
21b30 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a , const char*);.
21b40 54 61 62 6c 65 20 2a 73 71 6c 69 74 65 33 4c 6f Table *sqlite3Lo
21b50 63 61 74 65 54 61 62 6c 65 28 50 61 72 73 65 2a cateTable(Parse*
21b60 2c 69 6e 74 20 69 73 56 69 65 77 2c 63 6f 6e 73 ,int isView,cons
21b70 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 t char*, const c
21b80 68 61 72 2a 29 3b 0a 54 61 62 6c 65 20 2a 73 71 har*);.Table *sq
21b90 6c 69 74 65 33 4c 6f 63 61 74 65 54 61 62 6c 65 lite3LocateTable
21ba0 49 74 65 6d 28 50 61 72 73 65 2a 2c 69 6e 74 20 Item(Parse*,int
21bb0 69 73 56 69 65 77 2c 73 74 72 75 63 74 20 53 72 isView,struct Sr
21bc0 63 4c 69 73 74 5f 69 74 65 6d 20 2a 29 3b 0a 49 cList_item *);.I
21bd0 6e 64 65 78 20 2a 73 71 6c 69 74 65 33 46 69 6e ndex *sqlite3Fin
21be0 64 49 6e 64 65 78 28 73 71 6c 69 74 65 33 2a 2c dIndex(sqlite3*,
21bf0 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e const char*, con
21c00 73 74 20 63 68 61 72 2a 29 3b 0a 76 6f 69 64 20 st char*);.void
21c10 73 71 6c 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 sqlite3UnlinkAnd
21c20 44 65 6c 65 74 65 54 61 62 6c 65 28 73 71 6c 69 DeleteTable(sqli
21c30 74 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 te3*,int,const c
21c40 68 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 har*);.void sqli
21c50 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 te3UnlinkAndDele
21c60 74 65 49 6e 64 65 78 28 73 71 6c 69 74 65 33 2a teIndex(sqlite3*
21c70 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 61 72 2a ,int,const char*
21c80 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 );.void sqlite3V
21c90 61 63 75 75 6d 28 50 61 72 73 65 2a 29 3b 0a 69 acuum(Parse*);.i
21ca0 6e 74 20 73 71 6c 69 74 65 33 52 75 6e 56 61 63 nt sqlite3RunVac
21cb0 75 75 6d 28 63 68 61 72 2a 2a 2c 20 73 71 6c 69 uum(char**, sqli
21cc0 74 65 33 2a 29 3b 0a 63 68 61 72 20 2a 73 71 6c te3*);.char *sql
21cd0 69 74 65 33 4e 61 6d 65 46 72 6f 6d 54 6f 6b 65 ite3NameFromToke
21ce0 6e 28 73 71 6c 69 74 65 33 2a 2c 20 54 6f 6b 65 n(sqlite3*, Toke
21cf0 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 n*);.int sqlite3
21d00 45 78 70 72 43 6f 6d 70 61 72 65 28 45 78 70 72 ExprCompare(Expr
21d10 2a 2c 20 45 78 70 72 2a 2c 20 69 6e 74 29 3b 0a *, Expr*, int);.
21d20 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 72 4c int sqlite3ExprL
21d30 69 73 74 43 6f 6d 70 61 72 65 28 45 78 70 72 4c istCompare(ExprL
21d40 69 73 74 2a 2c 20 45 78 70 72 4c 69 73 74 2a 2c ist*, ExprList*,
21d50 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
21d60 65 33 45 78 70 72 49 6d 70 6c 69 65 73 45 78 70 e3ExprImpliesExp
21d70 72 28 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 r(Expr*, Expr*,
21d80 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 int);.void sqlit
21d90 65 33 45 78 70 72 41 6e 61 6c 79 7a 65 41 67 67 e3ExprAnalyzeAgg
21da0 72 65 67 61 74 65 73 28 4e 61 6d 65 43 6f 6e 74 regates(NameCont
21db0 65 78 74 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f ext*, Expr*);.vo
21dc0 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e id sqlite3ExprAn
21dd0 61 6c 79 7a 65 41 67 67 4c 69 73 74 28 4e 61 6d alyzeAggList(Nam
21de0 65 43 6f 6e 74 65 78 74 2a 2c 45 78 70 72 4c 69 eContext*,ExprLi
21df0 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 st*);.int sqlite
21e00 33 46 75 6e 63 74 69 6f 6e 55 73 65 73 54 68 69 3FunctionUsesThi
21e10 73 53 72 63 28 45 78 70 72 2a 2c 20 53 72 63 4c sSrc(Expr*, SrcL
21e20 69 73 74 2a 29 3b 0a 56 64 62 65 20 2a 73 71 6c ist*);.Vdbe *sql
21e30 69 74 65 33 47 65 74 56 64 62 65 28 50 61 72 73 ite3GetVdbe(Pars
21e40 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
21e50 33 50 72 6e 67 53 61 76 65 53 74 61 74 65 28 76 3PrngSaveState(v
21e60 6f 69 64 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 oid);.void sqlit
21e70 65 33 50 72 6e 67 52 65 73 74 6f 72 65 53 74 61 e3PrngRestoreSta
21e80 74 65 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 te(void);.void s
21e90 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c qlite3RollbackAl
21ea0 6c 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 29 3b l(sqlite3*,int);
21eb0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 .void sqlite3Cod
21ec0 65 56 65 72 69 66 79 53 63 68 65 6d 61 28 50 61 eVerifySchema(Pa
21ed0 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 rse*, int);.void
21ee0 20 73 71 6c 69 74 65 33 43 6f 64 65 56 65 72 69 sqlite3CodeVeri
21ef0 66 79 4e 61 6d 65 64 53 63 68 65 6d 61 28 50 61 fyNamedSchema(Pa
21f00 72 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 rse*, const char
21f10 20 2a 7a 44 62 29 3b 0a 76 6f 69 64 20 73 71 6c *zDb);.void sql
21f20 69 74 65 33 42 65 67 69 6e 54 72 61 6e 73 61 63 ite3BeginTransac
21f30 74 69 6f 6e 28 50 61 72 73 65 2a 2c 20 69 6e 74 tion(Parse*, int
21f40 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 );.void sqlite3C
21f50 6f 6d 6d 69 74 54 72 61 6e 73 61 63 74 69 6f 6e ommitTransaction
21f60 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 (Parse*);.void s
21f70 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 54 72 qlite3RollbackTr
21f80 61 6e 73 61 63 74 69 6f 6e 28 50 61 72 73 65 2a ansaction(Parse*
21f90 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 );.void sqlite3S
21fa0 61 76 65 70 6f 69 6e 74 28 50 61 72 73 65 2a 2c avepoint(Parse*,
21fb0 20 69 6e 74 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 76 int, Token*);.v
21fc0 6f 69 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 oid sqlite3Close
21fd0 53 61 76 65 70 6f 69 6e 74 73 28 73 71 6c 69 74 Savepoints(sqlit
21fe0 65 33 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 e3 *);.void sqli
21ff0 74 65 33 4c 65 61 76 65 4d 75 74 65 78 41 6e 64 te3LeaveMutexAnd
22000 43 6c 6f 73 65 5a 6f 6d 62 69 65 28 73 71 6c 69 CloseZombie(sqli
22010 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 te3*);.int sqlit
22020 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 6e 74 e3ExprIsConstant
22030 28 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 71 6c (Expr*);.int sql
22040 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 ite3ExprIsConsta
22050 6e 74 4e 6f 74 4a 6f 69 6e 28 45 78 70 72 2a 29 ntNotJoin(Expr*)
22060 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 ;.int sqlite3Exp
22070 72 49 73 43 6f 6e 73 74 61 6e 74 4f 72 46 75 6e rIsConstantOrFun
22080 63 74 69 6f 6e 28 45 78 70 72 2a 29 3b 0a 69 6e ction(Expr*);.in
22090 74 20 73 71 6c 69 74 65 33 45 78 70 72 49 73 49 t sqlite3ExprIsI
220a0 6e 74 65 67 65 72 28 45 78 70 72 2a 2c 20 69 6e nteger(Expr*, in
220b0 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 t*);.int sqlite3
220c0 45 78 70 72 43 61 6e 42 65 4e 75 6c 6c 28 63 6f ExprCanBeNull(co
220d0 6e 73 74 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 nst Expr*);.int
220e0 73 71 6c 69 74 65 33 45 78 70 72 4e 65 65 64 73 sqlite3ExprNeeds
220f0 4e 6f 41 66 66 69 6e 69 74 79 43 68 61 6e 67 65 NoAffinityChange
22100 28 63 6f 6e 73 74 20 45 78 70 72 2a 2c 20 63 68 (const Expr*, ch
22110 61 72 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 ar);.int sqlite3
22120 49 73 52 6f 77 69 64 28 63 6f 6e 73 74 20 63 68 IsRowid(const ch
22130 61 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ar*);.void sqlit
22140 65 33 47 65 6e 65 72 61 74 65 52 6f 77 44 65 6c e3GenerateRowDel
22150 65 74 65 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 ete(Parse*,Table
22160 2a 2c 54 72 69 67 67 65 72 2a 2c 69 6e 74 2c 69 *,Trigger*,int,i
22170 6e 74 2c 69 6e 74 2c 69 31 36 2c 75 38 2c 75 38 nt,int,i16,u8,u8
22180 2c 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ,u8);.void sqlit
22190 65 33 47 65 6e 65 72 61 74 65 52 6f 77 49 6e 64 e3GenerateRowInd
221a0 65 78 44 65 6c 65 74 65 28 50 61 72 73 65 2a 2c exDelete(Parse*,
221b0 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e Table*, int, in
221c0 74 2c 20 69 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 t, int*);.int sq
221d0 6c 69 74 65 33 47 65 6e 65 72 61 74 65 49 6e 64 lite3GenerateInd
221e0 65 78 4b 65 79 28 50 61 72 73 65 2a 2c 20 49 6e exKey(Parse*, In
221f0 64 65 78 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c 20 dex*, int, int,
22200 69 6e 74 2c 20 69 6e 74 2a 2c 49 6e 64 65 78 2a int, int*,Index*
22210 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 ,int);.void sqli
22220 74 65 33 52 65 73 6f 6c 76 65 50 61 72 74 49 64 te3ResolvePartId
22230 78 4c 61 62 65 6c 28 50 61 72 73 65 2a 2c 69 6e xLabel(Parse*,in
22240 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 t);.void sqlite3
22250 47 65 6e 65 72 61 74 65 43 6f 6e 73 74 72 61 69 GenerateConstrai
22260 6e 74 43 68 65 63 6b 73 28 50 61 72 73 65 2a 2c ntChecks(Parse*,
22270 54 61 62 6c 65 2a 2c 69 6e 74 2a 2c 69 6e 74 2c Table*,int*,int,
22280 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 0a 20 20 20 int,int,int,.
22290 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
222a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
222b0 20 20 75 38 2c 75 38 2c 69 6e 74 2c 69 6e 74 2a u8,u8,int,int*
222c0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 );.void sqlite3C
222d0 6f 6d 70 6c 65 74 65 49 6e 73 65 72 74 69 6f 6e ompleteInsertion
222e0 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 2a 2c 69 (Parse*,Table*,i
222f0 6e 74 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2a 2c nt,int,int,int*,
22300 69 6e 74 2c 69 6e 74 2c 69 6e 74 29 3b 0a 69 6e int,int,int);.in
22310 74 20 73 71 6c 69 74 65 33 4f 70 65 6e 54 61 62 t sqlite3OpenTab
22320 6c 65 41 6e 64 49 6e 64 69 63 65 73 28 50 61 72 leAndIndices(Par
22330 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 69 6e 74 se*, Table*, int
22340 2c 20 69 6e 74 2c 20 75 38 2a 2c 20 69 6e 74 2a , int, u8*, int*
22350 2c 20 69 6e 74 2a 29 3b 0a 76 6f 69 64 20 73 71 , int*);.void sq
22360 6c 69 74 65 33 42 65 67 69 6e 57 72 69 74 65 4f lite3BeginWriteO
22370 70 65 72 61 74 69 6f 6e 28 50 61 72 73 65 2a 2c peration(Parse*,
22380 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 int, int);.void
22390 20 73 71 6c 69 74 65 33 4d 75 6c 74 69 57 72 69 sqlite3MultiWri
223a0 74 65 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 te(Parse*);.void
223b0 20 73 71 6c 69 74 65 33 4d 61 79 41 62 6f 72 74 sqlite3MayAbort
223c0 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 73 (Parse*);.void s
223d0 71 6c 69 74 65 33 48 61 6c 74 43 6f 6e 73 74 72 qlite3HaltConstr
223e0 61 69 6e 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 aint(Parse*, int
223f0 2c 20 69 6e 74 2c 20 63 68 61 72 2a 2c 20 69 38 , int, char*, i8
22400 2c 20 75 38 29 3b 0a 76 6f 69 64 20 73 71 6c 69 , u8);.void sqli
22410 74 65 33 55 6e 69 71 75 65 43 6f 6e 73 74 72 61 te3UniqueConstra
22420 69 6e 74 28 50 61 72 73 65 2a 2c 20 69 6e 74 2c int(Parse*, int,
22430 20 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 Index*);.void s
22440 71 6c 69 74 65 33 52 6f 77 69 64 43 6f 6e 73 74 qlite3RowidConst
22450 72 61 69 6e 74 28 50 61 72 73 65 2a 2c 20 69 6e raint(Parse*, in
22460 74 2c 20 54 61 62 6c 65 2a 29 3b 0a 45 78 70 72 t, Table*);.Expr
22470 20 2a 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 *sqlite3ExprDup
22480 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 2a 2c (sqlite3*,Expr*,
22490 69 6e 74 29 3b 0a 45 78 70 72 4c 69 73 74 20 2a int);.ExprList *
224a0 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 44 sqlite3ExprListD
224b0 75 70 28 73 71 6c 69 74 65 33 2a 2c 45 78 70 72 up(sqlite3*,Expr
224c0 4c 69 73 74 2a 2c 69 6e 74 29 3b 0a 53 72 63 4c List*,int);.SrcL
224d0 69 73 74 20 2a 73 71 6c 69 74 65 33 53 72 63 4c ist *sqlite3SrcL
224e0 69 73 74 44 75 70 28 73 71 6c 69 74 65 33 2a 2c istDup(sqlite3*,
224f0 53 72 63 4c 69 73 74 2a 2c 69 6e 74 29 3b 0a 49 SrcList*,int);.I
22500 64 4c 69 73 74 20 2a 73 71 6c 69 74 65 33 49 64 dList *sqlite3Id
22510 4c 69 73 74 44 75 70 28 73 71 6c 69 74 65 33 2a ListDup(sqlite3*
22520 2c 49 64 4c 69 73 74 2a 29 3b 0a 53 65 6c 65 63 ,IdList*);.Selec
22530 74 20 2a 73 71 6c 69 74 65 33 53 65 6c 65 63 74 t *sqlite3Select
22540 44 75 70 28 73 71 6c 69 74 65 33 2a 2c 53 65 6c Dup(sqlite3*,Sel
22550 65 63 74 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 ect*,int);.void
22560 73 71 6c 69 74 65 33 46 75 6e 63 44 65 66 49 6e sqlite3FuncDefIn
22570 73 65 72 74 28 46 75 6e 63 44 65 66 48 61 73 68 sert(FuncDefHash
22580 2a 2c 20 46 75 6e 63 44 65 66 2a 29 3b 0a 46 75 *, FuncDef*);.Fu
22590 6e 63 44 65 66 20 2a 73 71 6c 69 74 65 33 46 69 ncDef *sqlite3Fi
225a0 6e 64 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 74 ndFunction(sqlit
225b0 65 33 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 2c e3*,const char*,
225c0 69 6e 74 2c 69 6e 74 2c 75 38 2c 75 38 29 3b 0a int,int,u8,u8);.
225d0 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 void sqlite3Regi
225e0 73 74 65 72 42 75 69 6c 74 69 6e 46 75 6e 63 74 sterBuiltinFunct
225f0 69 6f 6e 73 28 73 71 6c 69 74 65 33 2a 29 3b 0a ions(sqlite3*);.
22600 76 6f 69 64 20 73 71 6c 69 74 65 33 52 65 67 69 void sqlite3Regi
22610 73 74 65 72 44 61 74 65 54 69 6d 65 46 75 6e 63 sterDateTimeFunc
22620 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a 76 6f 69 tions(void);.voi
22630 64 20 73 71 6c 69 74 65 33 52 65 67 69 73 74 65 d sqlite3Registe
22640 72 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 rGlobalFunctions
22650 28 76 6f 69 64 29 3b 0a 69 6e 74 20 73 71 6c 69 (void);.int sqli
22660 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f 6b te3SafetyCheckOk
22670 28 73 71 6c 69 74 65 33 2a 29 3b 0a 69 6e 74 20 (sqlite3*);.int
22680 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
22690 63 6b 53 69 63 6b 4f 72 4f 6b 28 73 71 6c 69 74 ckSickOrOk(sqlit
226a0 65 33 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 e3*);.void sqlit
226b0 65 33 43 68 61 6e 67 65 43 6f 6f 6b 69 65 28 50 e3ChangeCookie(P
226c0 61 72 73 65 2a 2c 20 69 6e 74 29 3b 0a 0a 23 69 arse*, int);..#i
226d0 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 f !defined(SQLIT
226e0 45 5f 4f 4d 49 54 5f 56 49 45 57 29 20 26 26 20 E_OMIT_VIEW) &&
226f0 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
22700 4f 4d 49 54 5f 54 52 49 47 47 45 52 29 0a 76 6f OMIT_TRIGGER).vo
22710 69 64 20 73 71 6c 69 74 65 33 4d 61 74 65 72 69 id sqlite3Materi
22720 61 6c 69 7a 65 56 69 65 77 28 50 61 72 73 65 2a alizeView(Parse*
22730 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 72 2a 2c , Table*, Expr*,
22740 20 69 6e 74 29 3b 0a 23 65 6e 64 69 66 0a 0a 23 int);.#endif..#
22750 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
22760 49 54 5f 54 52 49 47 47 45 52 0a 20 20 76 6f 69 IT_TRIGGER. voi
22770 64 20 73 71 6c 69 74 65 33 42 65 67 69 6e 54 72 d sqlite3BeginTr
22780 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 54 6f igger(Parse*, To
22790 6b 65 6e 2a 2c 54 6f 6b 65 6e 2a 2c 69 6e 74 2c ken*,Token*,int,
227a0 69 6e 74 2c 49 64 4c 69 73 74 2a 2c 53 72 63 4c int,IdList*,SrcL
227b0 69 73 74 2a 2c 0a 20 20 20 20 20 20 20 20 20 20 ist*,.
227c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
227d0 20 45 78 70 72 2a 2c 69 6e 74 2c 20 69 6e 74 29 Expr*,int, int)
227e0 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 ;. void sqlite3
227f0 46 69 6e 69 73 68 54 72 69 67 67 65 72 28 50 61 FinishTrigger(Pa
22800 72 73 65 2a 2c 20 54 72 69 67 67 65 72 53 74 65 rse*, TriggerSte
22810 70 2a 2c 20 54 6f 6b 65 6e 2a 29 3b 0a 20 20 76 p*, Token*);. v
22820 6f 69 64 20 73 71 6c 69 74 65 33 44 72 6f 70 54 oid sqlite3DropT
22830 72 69 67 67 65 72 28 50 61 72 73 65 2a 2c 20 53 rigger(Parse*, S
22840 72 63 4c 69 73 74 2a 2c 20 69 6e 74 29 3b 0a 20 rcList*, int);.
22850 20 76 6f 69 64 20 73 71 6c 69 74 65 33 44 72 6f void sqlite3Dro
22860 70 54 72 69 67 67 65 72 50 74 72 28 50 61 72 73 pTriggerPtr(Pars
22870 65 2a 2c 20 54 72 69 67 67 65 72 2a 29 3b 0a 20 e*, Trigger*);.
22880 20 54 72 69 67 67 65 72 20 2a 73 71 6c 69 74 65 Trigger *sqlite
22890 33 54 72 69 67 67 65 72 73 45 78 69 73 74 28 50 3TriggersExist(P
228a0 61 72 73 65 20 2a 2c 20 54 61 62 6c 65 2a 2c 20 arse *, Table*,
228b0 69 6e 74 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 int, ExprList*,
228c0 69 6e 74 20 2a 70 4d 61 73 6b 29 3b 0a 20 20 54 int *pMask);. T
228d0 72 69 67 67 65 72 20 2a 73 71 6c 69 74 65 33 54 rigger *sqlite3T
228e0 72 69 67 67 65 72 4c 69 73 74 28 50 61 72 73 65 riggerList(Parse
228f0 20 2a 2c 20 54 61 62 6c 65 20 2a 29 3b 0a 20 20 *, Table *);.
22900 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 64 65 void sqlite3Code
22910 52 6f 77 54 72 69 67 67 65 72 28 50 61 72 73 65 RowTrigger(Parse
22920 2a 2c 20 54 72 69 67 67 65 72 20 2a 2c 20 69 6e *, Trigger *, in
22930 74 2c 20 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e t, ExprList*, in
22940 74 2c 20 54 61 62 6c 65 20 2a 2c 0a 20 20 20 20 t, Table *,.
22950 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22960 20 20 20 20 20 20 20 20 69 6e 74 2c 20 69 6e 74 int, int
22970 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 , int);. void s
22980 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 qlite3CodeRowTri
22990 67 67 65 72 44 69 72 65 63 74 28 50 61 72 73 65 ggerDirect(Parse
229a0 20 2a 2c 20 54 72 69 67 67 65 72 20 2a 2c 20 54 *, Trigger *, T
229b0 61 62 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 able *, int, int
229c0 2c 20 69 6e 74 29 3b 0a 20 20 76 6f 69 64 20 73 , int);. void s
229d0 71 6c 69 74 65 56 69 65 77 54 72 69 67 67 65 72 qliteViewTrigger
229e0 73 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a s(Parse*, Table*
229f0 2c 20 45 78 70 72 2a 2c 20 69 6e 74 2c 20 45 78 , Expr*, int, Ex
22a00 70 72 4c 69 73 74 2a 29 3b 0a 20 20 76 6f 69 64 prList*);. void
22a10 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 54 72 sqlite3DeleteTr
22a20 69 67 67 65 72 53 74 65 70 28 73 71 6c 69 74 65 iggerStep(sqlite
22a30 33 2a 2c 20 54 72 69 67 67 65 72 53 74 65 70 2a 3*, TriggerStep*
22a40 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 65 70 );. TriggerStep
22a50 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 72 *sqlite3Trigger
22a60 53 65 6c 65 63 74 53 74 65 70 28 73 71 6c 69 74 SelectStep(sqlit
22a70 65 33 2a 2c 53 65 6c 65 63 74 2a 29 3b 0a 20 20 e3*,Select*);.
22a80 54 72 69 67 67 65 72 53 74 65 70 20 2a 73 71 6c TriggerStep *sql
22a90 69 74 65 33 54 72 69 67 67 65 72 49 6e 73 65 72 ite3TriggerInser
22aa0 74 53 74 65 70 28 73 71 6c 69 74 65 33 2a 2c 54 tStep(sqlite3*,T
22ab0 6f 6b 65 6e 2a 2c 20 49 64 4c 69 73 74 2a 2c 0a oken*, IdList*,.
22ac0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22ad0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
22ae0 20 20 20 20 20 20 20 20 53 65 6c 65 63 74 2a 2c Select*,
22af0 75 38 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 u8);. TriggerSt
22b00 65 70 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 ep *sqlite3Trigg
22b10 65 72 55 70 64 61 74 65 53 74 65 70 28 73 71 6c erUpdateStep(sql
22b20 69 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 45 78 70 ite3*,Token*,Exp
22b30 72 4c 69 73 74 2a 2c 20 45 78 70 72 2a 2c 20 75 rList*, Expr*, u
22b40 38 29 3b 0a 20 20 54 72 69 67 67 65 72 53 74 65 8);. TriggerSte
22b50 70 20 2a 73 71 6c 69 74 65 33 54 72 69 67 67 65 p *sqlite3Trigge
22b60 72 44 65 6c 65 74 65 53 74 65 70 28 73 71 6c 69 rDeleteStep(sqli
22b70 74 65 33 2a 2c 54 6f 6b 65 6e 2a 2c 20 45 78 70 te3*,Token*, Exp
22b80 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 r*);. void sqli
22b90 74 65 33 44 65 6c 65 74 65 54 72 69 67 67 65 72 te3DeleteTrigger
22ba0 28 73 71 6c 69 74 65 33 2a 2c 20 54 72 69 67 67 (sqlite3*, Trigg
22bb0 65 72 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c er*);. void sql
22bc0 69 74 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c ite3UnlinkAndDel
22bd0 65 74 65 54 72 69 67 67 65 72 28 73 71 6c 69 74 eteTrigger(sqlit
22be0 65 33 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 63 68 e3*,int,const ch
22bf0 61 72 2a 29 3b 0a 20 20 75 33 32 20 73 71 6c 69 ar*);. u32 sqli
22c00 74 65 33 54 72 69 67 67 65 72 43 6f 6c 6d 61 73 te3TriggerColmas
22c10 6b 28 50 61 72 73 65 2a 2c 54 72 69 67 67 65 72 k(Parse*,Trigger
22c20 2a 2c 45 78 70 72 4c 69 73 74 2a 2c 69 6e 74 2c *,ExprList*,int,
22c30 69 6e 74 2c 54 61 62 6c 65 2a 2c 69 6e 74 29 3b int,Table*,int);
22c40 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
22c50 33 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28 70 3ParseToplevel(p
22c60 29 20 28 28 70 29 2d 3e 70 54 6f 70 6c 65 76 65 ) ((p)->pTopleve
22c70 6c 20 3f 20 28 70 29 2d 3e 70 54 6f 70 6c 65 76 l ? (p)->pToplev
22c80 65 6c 20 3a 20 28 70 29 29 0a 23 65 6c 73 65 0a el : (p)).#else.
22c90 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
22ca0 54 72 69 67 67 65 72 73 45 78 69 73 74 28 42 2c TriggersExist(B,
22cb0 43 2c 44 2c 45 2c 46 29 20 30 0a 23 20 64 65 66 C,D,E,F) 0.# def
22cc0 69 6e 65 20 73 71 6c 69 74 65 33 44 65 6c 65 74 ine sqlite3Delet
22cd0 65 54 72 69 67 67 65 72 28 41 2c 42 29 0a 23 20 eTrigger(A,B).#
22ce0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 44 72 define sqlite3Dr
22cf0 6f 70 54 72 69 67 67 65 72 50 74 72 28 41 2c 42 opTriggerPtr(A,B
22d00 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
22d10 65 33 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 e3UnlinkAndDelet
22d20 65 54 72 69 67 67 65 72 28 41 2c 42 2c 43 29 0a eTrigger(A,B,C).
22d30 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 # define sqlite3
22d40 43 6f 64 65 52 6f 77 54 72 69 67 67 65 72 28 41 CodeRowTrigger(A
22d50 2c 42 2c 43 2c 44 2c 45 2c 46 2c 47 2c 48 2c 49 ,B,C,D,E,F,G,H,I
22d60 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 ).# define sqlit
22d70 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 65 72 e3CodeRowTrigger
22d80 44 69 72 65 63 74 28 41 2c 42 2c 43 2c 44 2c 45 Direct(A,B,C,D,E
22d90 2c 46 29 0a 23 20 64 65 66 69 6e 65 20 73 71 6c ,F).# define sql
22da0 69 74 65 33 54 72 69 67 67 65 72 4c 69 73 74 28 ite3TriggerList(
22db0 58 2c 20 59 29 20 30 0a 23 20 64 65 66 69 6e 65 X, Y) 0.# define
22dc0 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 6f 70 sqlite3ParseTop
22dd0 6c 65 76 65 6c 28 70 29 20 70 0a 23 20 64 65 66 level(p) p.# def
22de0 69 6e 65 20 73 71 6c 69 74 65 33 54 72 69 67 67 ine sqlite3Trigg
22df0 65 72 43 6f 6c 6d 61 73 6b 28 41 2c 42 2c 43 2c erColmask(A,B,C,
22e00 44 2c 45 2c 46 2c 47 29 20 30 0a 23 65 6e 64 69 D,E,F,G) 0.#endi
22e10 66 0a 0a 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f f..int sqlite3Jo
22e20 69 6e 54 79 70 65 28 50 61 72 73 65 2a 2c 20 54 inType(Parse*, T
22e30 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 oken*, Token*, T
22e40 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c oken*);.void sql
22e50 69 74 65 33 43 72 65 61 74 65 46 6f 72 65 69 67 ite3CreateForeig
22e60 6e 4b 65 79 28 50 61 72 73 65 2a 2c 20 45 78 70 nKey(Parse*, Exp
22e70 72 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 rList*, Token*,
22e80 45 78 70 72 4c 69 73 74 2a 2c 20 69 6e 74 29 3b ExprList*, int);
22e90 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 44 65 66 .void sqlite3Def
22ea0 65 72 46 6f 72 65 69 67 6e 4b 65 79 28 50 61 72 erForeignKey(Par
22eb0 73 65 2a 2c 20 69 6e 74 29 3b 0a 23 69 66 6e 64 se*, int);.#ifnd
22ec0 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
22ed0 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 76 UTHORIZATION. v
22ee0 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 68 52 oid sqlite3AuthR
22ef0 65 61 64 28 50 61 72 73 65 2a 2c 45 78 70 72 2a ead(Parse*,Expr*
22f00 2c 53 63 68 65 6d 61 2a 2c 53 72 63 4c 69 73 74 ,Schema*,SrcList
22f10 2a 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 *);. int sqlite
22f20 33 41 75 74 68 43 68 65 63 6b 28 50 61 72 73 65 3AuthCheck(Parse
22f30 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 *,int, const cha
22f40 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c r*, const char*,
22f50 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a 20 const char*);.
22f60 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 75 74 void sqlite3Aut
22f70 68 43 6f 6e 74 65 78 74 50 75 73 68 28 50 61 72 hContextPush(Par
22f80 73 65 2a 2c 20 41 75 74 68 43 6f 6e 74 65 78 74 se*, AuthContext
22f90 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b *, const char*);
22fa0 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 41 . void sqlite3A
22fb0 75 74 68 43 6f 6e 74 65 78 74 50 6f 70 28 41 75 uthContextPop(Au
22fc0 74 68 43 6f 6e 74 65 78 74 2a 29 3b 0a 20 20 69 thContext*);. i
22fd0 6e 74 20 73 71 6c 69 74 65 33 41 75 74 68 52 65 nt sqlite3AuthRe
22fe0 61 64 43 6f 6c 28 50 61 72 73 65 2a 2c 20 63 6f adCol(Parse*, co
22ff0 6e 73 74 20 63 68 61 72 20 2a 2c 20 63 6f 6e 73 nst char *, cons
23000 74 20 63 68 61 72 20 2a 2c 20 69 6e 74 29 3b 0a t char *, int);.
23010 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 #else.# define s
23020 71 6c 69 74 65 33 41 75 74 68 52 65 61 64 28 61 qlite3AuthRead(a
23030 2c 62 2c 63 2c 64 29 0a 23 20 64 65 66 69 6e 65 ,b,c,d).# define
23040 20 73 71 6c 69 74 65 33 41 75 74 68 43 68 65 63 sqlite3AuthChec
23050 6b 28 61 2c 62 2c 63 2c 64 2c 65 29 20 20 20 20 k(a,b,c,d,e)
23060 53 51 4c 49 54 45 5f 4f 4b 0a 23 20 64 65 66 69 SQLITE_OK.# defi
23070 6e 65 20 73 71 6c 69 74 65 33 41 75 74 68 43 6f ne sqlite3AuthCo
23080 6e 74 65 78 74 50 75 73 68 28 61 2c 62 2c 63 29 ntextPush(a,b,c)
23090 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
230a0 33 41 75 74 68 43 6f 6e 74 65 78 74 50 6f 70 28 3AuthContextPop(
230b0 61 29 20 20 28 28 76 6f 69 64 29 28 61 29 29 0a a) ((void)(a)).
230c0 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 #endif.void sqli
230d0 74 65 33 41 74 74 61 63 68 28 50 61 72 73 65 2a te3Attach(Parse*
230e0 2c 20 45 78 70 72 2a 2c 20 45 78 70 72 2a 2c 20 , Expr*, Expr*,
230f0 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c Expr*);.void sql
23100 69 74 65 33 44 65 74 61 63 68 28 50 61 72 73 65 ite3Detach(Parse
23110 2a 2c 20 45 78 70 72 2a 29 3b 0a 76 6f 69 64 20 *, Expr*);.void
23120 73 71 6c 69 74 65 33 46 69 78 49 6e 69 74 28 44 sqlite3FixInit(D
23130 62 46 69 78 65 72 2a 2c 20 50 61 72 73 65 2a 2c bFixer*, Parse*,
23140 20 69 6e 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 int, const char
23150 2a 2c 20 63 6f 6e 73 74 20 54 6f 6b 65 6e 2a 29 *, const Token*)
23160 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 78 ;.int sqlite3Fix
23170 53 72 63 4c 69 73 74 28 44 62 46 69 78 65 72 2a SrcList(DbFixer*
23180 2c 20 53 72 63 4c 69 73 74 2a 29 3b 0a 69 6e 74 , SrcList*);.int
23190 20 73 71 6c 69 74 65 33 46 69 78 53 65 6c 65 63 sqlite3FixSelec
231a0 74 28 44 62 46 69 78 65 72 2a 2c 20 53 65 6c 65 t(DbFixer*, Sele
231b0 63 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 ct*);.int sqlite
231c0 33 46 69 78 45 78 70 72 28 44 62 46 69 78 65 72 3FixExpr(DbFixer
231d0 2a 2c 20 45 78 70 72 2a 29 3b 0a 69 6e 74 20 73 *, Expr*);.int s
231e0 71 6c 69 74 65 33 46 69 78 45 78 70 72 4c 69 73 qlite3FixExprLis
231f0 74 28 44 62 46 69 78 65 72 2a 2c 20 45 78 70 72 t(DbFixer*, Expr
23200 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 List*);.int sqli
23210 74 65 33 46 69 78 54 72 69 67 67 65 72 53 74 65 te3FixTriggerSte
23220 70 28 44 62 46 69 78 65 72 2a 2c 20 54 72 69 67 p(DbFixer*, Trig
23230 67 65 72 53 74 65 70 2a 29 3b 0a 69 6e 74 20 73 gerStep*);.int s
23240 71 6c 69 74 65 33 41 74 6f 46 28 63 6f 6e 73 74 qlite3AtoF(const
23250 20 63 68 61 72 20 2a 7a 2c 20 64 6f 75 62 6c 65 char *z, double
23260 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 6e 74 *, int, u8);.int
23270 20 73 71 6c 69 74 65 33 47 65 74 49 6e 74 33 32 sqlite3GetInt32
23280 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 (const char *, i
23290 6e 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 nt*);.int sqlite
232a0 33 41 74 6f 69 28 63 6f 6e 73 74 20 63 68 61 72 3Atoi(const char
232b0 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 55 *);.int sqlite3U
232c0 74 66 31 36 42 79 74 65 4c 65 6e 28 63 6f 6e 73 tf16ByteLen(cons
232d0 74 20 76 6f 69 64 20 2a 70 44 61 74 61 2c 20 69 t void *pData, i
232e0 6e 74 20 6e 43 68 61 72 29 3b 0a 69 6e 74 20 73 nt nChar);.int s
232f0 71 6c 69 74 65 33 55 74 66 38 43 68 61 72 4c 65 qlite3Utf8CharLe
23300 6e 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 70 44 n(const char *pD
23310 61 74 61 2c 20 69 6e 74 20 6e 42 79 74 65 29 3b ata, int nByte);
23320 0a 75 33 32 20 73 71 6c 69 74 65 33 55 74 66 38 .u32 sqlite3Utf8
23330 52 65 61 64 28 63 6f 6e 73 74 20 75 38 2a 2a 29 Read(const u8**)
23340 3b 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 65 33 ;.LogEst sqlite3
23350 4c 6f 67 45 73 74 28 75 36 34 29 3b 0a 4c 6f 67 LogEst(u64);.Log
23360 45 73 74 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 Est sqlite3LogEs
23370 74 41 64 64 28 4c 6f 67 45 73 74 2c 4c 6f 67 45 tAdd(LogEst,LogE
23380 73 74 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c st);.#ifndef SQL
23390 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c ITE_OMIT_VIRTUAL
233a0 54 41 42 4c 45 0a 4c 6f 67 45 73 74 20 73 71 6c TABLE.LogEst sql
233b0 69 74 65 33 4c 6f 67 45 73 74 46 72 6f 6d 44 6f ite3LogEstFromDo
233c0 75 62 6c 65 28 64 6f 75 62 6c 65 29 3b 0a 23 65 uble(double);.#e
233d0 6e 64 69 66 0a 75 36 34 20 73 71 6c 69 74 65 33 ndif.u64 sqlite3
233e0 4c 6f 67 45 73 74 54 6f 49 6e 74 28 4c 6f 67 45 LogEstToInt(LogE
233f0 73 74 29 3b 0a 0a 2f 2a 0a 2a 2a 20 52 6f 75 74 st);../*.** Rout
23400 69 6e 65 73 20 74 6f 20 72 65 61 64 20 61 6e 64 ines to read and
23410 20 77 72 69 74 65 20 76 61 72 69 61 62 6c 65 2d write variable-
23420 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 73 2e length integers.
23430 20 20 54 68 65 73 65 20 75 73 65 64 20 74 6f 0a These used to.
23440 2a 2a 20 62 65 20 64 65 66 69 6e 65 64 20 6c 6f ** be defined lo
23450 63 61 6c 6c 79 2c 20 62 75 74 20 6e 6f 77 20 77 cally, but now w
23460 65 20 75 73 65 20 74 68 65 20 76 61 72 69 6e 74 e use the varint
23470 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 65 routines in the
23480 20 75 74 69 6c 2e 63 0a 2a 2a 20 66 69 6c 65 2e util.c.** file.
23490 20 20 43 6f 64 65 20 73 68 6f 75 6c 64 20 75 73 Code should us
234a0 65 20 74 68 65 20 4d 41 43 52 4f 20 66 6f 72 6d e the MACRO form
234b0 73 20 62 65 6c 6f 77 2c 20 61 73 20 74 68 65 20 s below, as the
234c0 56 61 72 69 6e 74 33 32 20 76 65 72 73 69 6f 6e Varint32 version
234d0 73 0a 2a 2a 20 61 72 65 20 63 6f 64 65 64 20 74 s.** are coded t
234e0 6f 20 61 73 73 75 6d 65 20 74 68 65 20 73 69 6e o assume the sin
234f0 67 6c 65 20 62 79 74 65 20 63 61 73 65 20 69 73 gle byte case is
23500 20 61 6c 72 65 61 64 79 20 68 61 6e 64 6c 65 64 already handled
23510 20 28 77 68 69 63 68 20 0a 2a 2a 20 74 68 65 20 (which .** the
23520 4d 41 43 52 4f 20 66 6f 72 6d 20 64 6f 65 73 29 MACRO form does)
23530 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 ..*/.int sqlite3
23540 50 75 74 56 61 72 69 6e 74 28 75 6e 73 69 67 6e PutVarint(unsign
23550 65 64 20 63 68 61 72 2a 2c 20 75 36 34 29 3b 0a ed char*, u64);.
23560 69 6e 74 20 73 71 6c 69 74 65 33 50 75 74 56 61 int sqlite3PutVa
23570 72 69 6e 74 33 32 28 75 6e 73 69 67 6e 65 64 20 rint32(unsigned
23580 63 68 61 72 2a 2c 20 75 33 32 29 3b 0a 75 38 20 char*, u32);.u8
23590 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 sqlite3GetVarint
235a0 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 (const unsigned
235b0 63 68 61 72 20 2a 2c 20 75 36 34 20 2a 29 3b 0a char *, u64 *);.
235c0 75 38 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 u8 sqlite3GetVar
235d0 69 6e 74 33 32 28 63 6f 6e 73 74 20 75 6e 73 69 int32(const unsi
235e0 67 6e 65 64 20 63 68 61 72 20 2a 2c 20 75 33 32 gned char *, u32
235f0 20 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 *);.int sqlite3
23600 56 61 72 69 6e 74 4c 65 6e 28 75 36 34 20 76 29 VarintLen(u64 v)
23610 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 ;../*.** The hea
23620 64 65 72 20 6f 66 20 61 20 72 65 63 6f 72 64 20 der of a record
23630 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 73 65 consists of a se
23640 71 75 65 6e 63 65 20 76 61 72 69 61 62 6c 65 2d quence variable-
23650 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 73 2e length integers.
23660 0a 2a 2a 20 54 68 65 73 65 20 69 6e 74 65 67 65 .** These intege
23670 72 73 20 61 72 65 20 61 6c 6d 6f 73 74 20 61 6c rs are almost al
23680 77 61 79 73 20 73 6d 61 6c 6c 20 61 6e 64 20 61 ways small and a
23690 72 65 20 65 6e 63 6f 64 65 64 20 61 73 20 61 20 re encoded as a
236a0 73 69 6e 67 6c 65 20 62 79 74 65 2e 0a 2a 2a 20 single byte..**
236b0 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 The following ma
236c0 63 72 6f 73 20 74 61 6b 65 20 61 64 76 61 6e 74 cros take advant
236d0 61 67 65 20 74 68 69 73 20 66 61 63 74 20 74 6f age this fact to
236e0 20 70 72 6f 76 69 64 65 20 61 20 66 61 73 74 20 provide a fast
236f0 65 6e 63 6f 64 65 0a 2a 2a 20 61 6e 64 20 64 65 encode.** and de
23700 63 6f 64 65 20 6f 66 20 74 68 65 20 69 6e 74 65 code of the inte
23710 67 65 72 73 20 69 6e 20 61 20 72 65 63 6f 72 64 gers in a record
23720 20 68 65 61 64 65 72 2e 20 20 49 74 20 69 73 20 header. It is
23730 66 61 73 74 65 72 20 66 6f 72 20 74 68 65 20 63 faster for the c
23740 6f 6d 6d 6f 6e 0a 2a 2a 20 63 61 73 65 20 77 68 ommon.** case wh
23750 65 72 65 20 74 68 65 20 69 6e 74 65 67 65 72 20 ere the integer
23760 69 73 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65 is a single byte
23770 2e 20 20 49 74 20 69 73 20 61 20 6c 69 74 74 6c . It is a littl
23780 65 20 73 6c 6f 77 65 72 20 77 68 65 6e 20 74 68 e slower when th
23790 65 0a 2a 2a 20 69 6e 74 65 67 65 72 20 69 73 20 e.** integer is
237a0 74 77 6f 20 6f 72 20 6d 6f 72 65 20 62 79 74 65 two or more byte
237b0 73 2e 20 20 42 75 74 20 6f 76 65 72 61 6c 6c 20 s. But overall
237c0 69 74 20 69 73 20 66 61 73 74 65 72 2e 0a 2a 2a it is faster..**
237d0 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e .** The followin
237e0 67 20 65 78 70 72 65 73 73 69 6f 6e 73 20 61 72 g expressions ar
237f0 65 20 65 71 75 69 76 61 6c 65 6e 74 3a 0a 2a 2a e equivalent:.**
23800 0a 2a 2a 20 20 20 20 20 78 20 3d 20 73 71 6c 69 .** x = sqli
23810 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 20 te3GetVarint32(
23820 41 2c 20 26 42 20 29 3b 0a 2a 2a 20 20 20 20 20 A, &B );.**
23830 78 20 3d 20 73 71 6c 69 74 65 33 50 75 74 56 61 x = sqlite3PutVa
23840 72 69 6e 74 33 32 28 20 41 2c 20 42 20 29 3b 0a rint32( A, B );.
23850 2a 2a 0a 2a 2a 20 20 20 20 20 78 20 3d 20 67 65 **.** x = ge
23860 74 56 61 72 69 6e 74 33 32 28 20 41 2c 20 42 20 tVarint32( A, B
23870 29 3b 0a 2a 2a 20 20 20 20 20 78 20 3d 20 70 75 );.** x = pu
23880 74 56 61 72 69 6e 74 33 32 28 20 41 2c 20 42 20 tVarint32( A, B
23890 29 3b 0a 2a 2a 0a 2a 2f 0a 23 64 65 66 69 6e 65 );.**.*/.#define
238a0 20 67 65 74 56 61 72 69 6e 74 33 32 28 41 2c 42 getVarint32(A,B
238b0 29 20 20 5c 0a 20 20 28 75 38 29 28 28 2a 28 41 ) \. (u8)((*(A
238c0 29 3c 28 75 38 29 30 78 38 30 29 3f 28 28 42 29 )<(u8)0x80)?((B)
238d0 3d 28 75 33 32 29 2a 28 41 29 29 2c 31 3a 73 71 =(u32)*(A)),1:sq
238e0 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 lite3GetVarint32
238f0 28 28 41 29 2c 28 75 33 32 20 2a 29 26 28 42 29 ((A),(u32 *)&(B)
23900 29 29 0a 23 64 65 66 69 6e 65 20 70 75 74 56 61 )).#define putVa
23910 72 69 6e 74 33 32 28 41 2c 42 29 20 20 5c 0a 20 rint32(A,B) \.
23920 20 28 75 38 29 28 28 28 75 33 32 29 28 42 29 3c (u8)(((u32)(B)<
23930 28 75 33 32 29 30 78 38 30 29 3f 28 2a 28 41 29 (u32)0x80)?(*(A)
23940 3d 28 75 6e 73 69 67 6e 65 64 20 63 68 61 72 29 =(unsigned char)
23950 28 42 29 29 2c 31 3a 5c 0a 20 20 73 71 6c 69 74 (B)),1:\. sqlit
23960 65 33 50 75 74 56 61 72 69 6e 74 33 32 28 28 41 e3PutVarint32((A
23970 29 2c 28 42 29 29 29 0a 23 64 65 66 69 6e 65 20 ),(B))).#define
23980 67 65 74 56 61 72 69 6e 74 20 20 20 20 73 71 6c getVarint sql
23990 69 74 65 33 47 65 74 56 61 72 69 6e 74 0a 23 64 ite3GetVarint.#d
239a0 65 66 69 6e 65 20 70 75 74 56 61 72 69 6e 74 20 efine putVarint
239b0 20 20 20 73 71 6c 69 74 65 33 50 75 74 56 61 72 sqlite3PutVar
239c0 69 6e 74 0a 0a 0a 63 6f 6e 73 74 20 63 68 61 72 int...const char
239d0 20 2a 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 *sqlite3IndexAf
239e0 66 69 6e 69 74 79 53 74 72 28 56 64 62 65 20 2a finityStr(Vdbe *
239f0 2c 20 49 6e 64 65 78 20 2a 29 3b 0a 76 6f 69 64 , Index *);.void
23a00 20 73 71 6c 69 74 65 33 54 61 62 6c 65 41 66 66 sqlite3TableAff
23a10 69 6e 69 74 79 28 56 64 62 65 2a 2c 20 54 61 62 inity(Vdbe*, Tab
23a20 6c 65 2a 2c 20 69 6e 74 29 3b 0a 63 68 61 72 20 le*, int);.char
23a30 73 71 6c 69 74 65 33 43 6f 6d 70 61 72 65 41 66 sqlite3CompareAf
23a40 66 69 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 finity(Expr *pEx
23a50 70 72 2c 20 63 68 61 72 20 61 66 66 32 29 3b 0a pr, char aff2);.
23a60 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 64 65 78 int sqlite3Index
23a70 41 66 66 69 6e 69 74 79 4f 6b 28 45 78 70 72 20 AffinityOk(Expr
23a80 2a 70 45 78 70 72 2c 20 63 68 61 72 20 69 64 78 *pExpr, char idx
23a90 5f 61 66 66 69 6e 69 74 79 29 3b 0a 63 68 61 72 _affinity);.char
23aa0 20 73 71 6c 69 74 65 33 45 78 70 72 41 66 66 69 sqlite3ExprAffi
23ab0 6e 69 74 79 28 45 78 70 72 20 2a 70 45 78 70 72 nity(Expr *pExpr
23ac0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 41 74 );.int sqlite3At
23ad0 6f 69 36 34 28 63 6f 6e 73 74 20 63 68 61 72 2a oi64(const char*
23ae0 2c 20 69 36 34 2a 2c 20 69 6e 74 2c 20 75 38 29 , i64*, int, u8)
23af0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 72 ;.void sqlite3Er
23b00 72 6f 72 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e ror(sqlite3*, in
23b10 74 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 2e t, const char*,.
23b20 2e 2e 29 3b 0a 76 6f 69 64 20 2a 73 71 6c 69 74 ..);.void *sqlit
23b30 65 33 48 65 78 54 6f 42 6c 6f 62 28 73 71 6c 69 e3HexToBlob(sqli
23b40 74 65 33 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 te3*, const char
23b50 20 2a 7a 2c 20 69 6e 74 20 6e 29 3b 0a 75 38 20 *z, int n);.u8
23b60 73 71 6c 69 74 65 33 48 65 78 54 6f 49 6e 74 28 sqlite3HexToInt(
23b70 69 6e 74 20 68 29 3b 0a 69 6e 74 20 73 71 6c 69 int h);.int sqli
23b80 74 65 33 54 77 6f 50 61 72 74 4e 61 6d 65 28 50 te3TwoPartName(P
23b90 61 72 73 65 20 2a 2c 20 54 6f 6b 65 6e 20 2a 2c arse *, Token *,
23ba0 20 54 6f 6b 65 6e 20 2a 2c 20 54 6f 6b 65 6e 20 Token *, Token
23bb0 2a 2a 29 3b 0a 0a 23 69 66 20 64 65 66 69 6e 65 **);..#if define
23bc0 64 28 53 51 4c 49 54 45 5f 54 45 53 54 29 20 0a d(SQLITE_TEST) .
23bd0 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71 6c 69 const char *sqli
23be0 74 65 33 45 72 72 4e 61 6d 65 28 69 6e 74 29 3b te3ErrName(int);
23bf0 0a 23 65 6e 64 69 66 0a 0a 63 6f 6e 73 74 20 63 .#endif..const c
23c00 68 61 72 20 2a 73 71 6c 69 74 65 33 45 72 72 53 har *sqlite3ErrS
23c10 74 72 28 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c tr(int);.int sql
23c20 69 74 65 33 52 65 61 64 53 63 68 65 6d 61 28 50 ite3ReadSchema(P
23c30 61 72 73 65 20 2a 70 50 61 72 73 65 29 3b 0a 43 arse *pParse);.C
23c40 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 46 ollSeq *sqlite3F
23c50 69 6e 64 43 6f 6c 6c 53 65 71 28 73 71 6c 69 74 indCollSeq(sqlit
23c60 65 33 2a 2c 75 38 20 65 6e 63 2c 20 63 6f 6e 73 e3*,u8 enc, cons
23c70 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 43 6f t char*,int);.Co
23c80 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 4c 6f llSeq *sqlite3Lo
23c90 63 61 74 65 43 6f 6c 6c 53 65 71 28 50 61 72 73 cateCollSeq(Pars
23ca0 65 20 2a 70 50 61 72 73 65 2c 20 63 6f 6e 73 74 e *pParse, const
23cb0 20 63 68 61 72 2a 7a 4e 61 6d 65 29 3b 0a 43 6f char*zName);.Co
23cc0 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 45 78 llSeq *sqlite3Ex
23cd0 70 72 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 prCollSeq(Parse
23ce0 2a 70 50 61 72 73 65 2c 20 45 78 70 72 20 2a 70 *pParse, Expr *p
23cf0 45 78 70 72 29 3b 0a 45 78 70 72 20 2a 73 71 6c Expr);.Expr *sql
23d00 69 74 65 33 45 78 70 72 41 64 64 43 6f 6c 6c 61 ite3ExprAddColla
23d10 74 65 54 6f 6b 65 6e 28 50 61 72 73 65 20 2a 70 teToken(Parse *p
23d20 50 61 72 73 65 2c 20 45 78 70 72 2a 2c 20 63 6f Parse, Expr*, co
23d30 6e 73 74 20 54 6f 6b 65 6e 2a 29 3b 0a 45 78 70 nst Token*);.Exp
23d40 72 20 2a 73 71 6c 69 74 65 33 45 78 70 72 41 64 r *sqlite3ExprAd
23d50 64 43 6f 6c 6c 61 74 65 53 74 72 69 6e 67 28 50 dCollateString(P
23d60 61 72 73 65 2a 2c 45 78 70 72 2a 2c 63 6f 6e 73 arse*,Expr*,cons
23d70 74 20 63 68 61 72 2a 29 3b 0a 45 78 70 72 20 2a t char*);.Expr *
23d80 73 71 6c 69 74 65 33 45 78 70 72 53 6b 69 70 43 sqlite3ExprSkipC
23d90 6f 6c 6c 61 74 65 28 45 78 70 72 2a 29 3b 0a 69 ollate(Expr*);.i
23da0 6e 74 20 73 71 6c 69 74 65 33 43 68 65 63 6b 43 nt sqlite3CheckC
23db0 6f 6c 6c 53 65 71 28 50 61 72 73 65 20 2a 2c 20 ollSeq(Parse *,
23dc0 43 6f 6c 6c 53 65 71 20 2a 29 3b 0a 69 6e 74 20 CollSeq *);.int
23dd0 73 71 6c 69 74 65 33 43 68 65 63 6b 4f 62 6a 65 sqlite3CheckObje
23de0 63 74 4e 61 6d 65 28 50 61 72 73 65 20 2a 2c 20 ctName(Parse *,
23df0 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 3b 0a 76 const char *);.v
23e00 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53 oid sqlite3VdbeS
23e10 65 74 43 68 61 6e 67 65 73 28 73 71 6c 69 74 65 etChanges(sqlite
23e20 33 20 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 3 *, int);.int s
23e30 71 6c 69 74 65 33 41 64 64 49 6e 74 36 34 28 69 qlite3AddInt64(i
23e40 36 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 73 71 64*,i64);.int sq
23e50 6c 69 74 65 33 53 75 62 49 6e 74 36 34 28 69 36 lite3SubInt64(i6
23e60 34 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 4*,i64);.int sql
23e70 69 74 65 33 4d 75 6c 49 6e 74 36 34 28 69 36 34 ite3MulInt64(i64
23e80 2a 2c 69 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 *,i64);.int sqli
23e90 74 65 33 41 62 73 49 6e 74 33 32 28 69 6e 74 29 te3AbsInt32(int)
23ea0 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ;.#ifdef SQLITE_
23eb0 45 4e 41 42 4c 45 5f 38 5f 33 5f 4e 41 4d 45 53 ENABLE_8_3_NAMES
23ec0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46 69 6c .void sqlite3Fil
23ed0 65 53 75 66 66 69 78 33 28 63 6f 6e 73 74 20 63 eSuffix3(const c
23ee0 68 61 72 2a 2c 20 63 68 61 72 2a 29 3b 0a 23 65 har*, char*);.#e
23ef0 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c lse.# define sql
23f00 69 74 65 33 46 69 6c 65 53 75 66 66 69 78 33 28 ite3FileSuffix3(
23f10 58 2c 59 29 0a 23 65 6e 64 69 66 0a 75 38 20 73 X,Y).#endif.u8 s
23f20 71 6c 69 74 65 33 47 65 74 42 6f 6f 6c 65 61 6e qlite3GetBoolean
23f30 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 2c 69 (const char *z,i
23f40 6e 74 29 3b 0a 0a 63 6f 6e 73 74 20 76 6f 69 64 nt);..const void
23f50 20 2a 73 71 6c 69 74 65 33 56 61 6c 75 65 54 65 *sqlite3ValueTe
23f60 78 74 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 xt(sqlite3_value
23f70 2a 2c 20 75 38 29 3b 0a 69 6e 74 20 73 71 6c 69 *, u8);.int sqli
23f80 74 65 33 56 61 6c 75 65 42 79 74 65 73 28 73 71 te3ValueBytes(sq
23f90 6c 69 74 65 33 5f 76 61 6c 75 65 2a 2c 20 75 38 lite3_value*, u8
23fa0 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 );.void sqlite3V
23fb0 61 6c 75 65 53 65 74 53 74 72 28 73 71 6c 69 74 alueSetStr(sqlit
23fc0 65 33 5f 76 61 6c 75 65 2a 2c 20 69 6e 74 2c 20 e3_value*, int,
23fd0 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2c 75 38 2c const void *,u8,
23fe0 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
23ff0 20 20 20 20 20 20 20 20 20 20 76 6f 69 64 28 2a void(*
24000 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f 69 64 20 )(void*));.void
24010 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74 4e sqlite3ValueSetN
24020 75 6c 6c 28 73 71 6c 69 74 65 33 5f 76 61 6c 75 ull(sqlite3_valu
24030 65 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 e*);.void sqlite
24040 33 56 61 6c 75 65 46 72 65 65 28 73 71 6c 69 74 3ValueFree(sqlit
24050 65 33 5f 76 61 6c 75 65 2a 29 3b 0a 73 71 6c 69 e3_value*);.sqli
24060 74 65 33 5f 76 61 6c 75 65 20 2a 73 71 6c 69 74 te3_value *sqlit
24070 65 33 56 61 6c 75 65 4e 65 77 28 73 71 6c 69 74 e3ValueNew(sqlit
24080 65 33 20 2a 29 3b 0a 63 68 61 72 20 2a 73 71 6c e3 *);.char *sql
24090 69 74 65 33 55 74 66 31 36 74 6f 38 28 73 71 6c ite3Utf16to8(sql
240a0 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 20 76 6f ite3 *, const vo
240b0 69 64 2a 2c 20 69 6e 74 2c 20 75 38 29 3b 0a 69 id*, int, u8);.i
240c0 6e 74 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 nt sqlite3ValueF
240d0 72 6f 6d 45 78 70 72 28 73 71 6c 69 74 65 33 20 romExpr(sqlite3
240e0 2a 2c 20 45 78 70 72 20 2a 2c 20 75 38 2c 20 75 *, Expr *, u8, u
240f0 38 2c 20 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 8, sqlite3_value
24100 20 2a 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 **);.void sqlit
24110 65 33 56 61 6c 75 65 41 70 70 6c 79 41 66 66 69 e3ValueApplyAffi
24120 6e 69 74 79 28 73 71 6c 69 74 65 33 5f 76 61 6c nity(sqlite3_val
24130 75 65 20 2a 2c 20 75 38 2c 20 75 38 29 3b 0a 23 ue *, u8, u8);.#
24140 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 41 4d ifndef SQLITE_AM
24150 41 4c 47 41 4d 41 54 49 4f 4e 0a 65 78 74 65 72 ALGAMATION.exter
24160 6e 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 n const unsigned
24170 20 63 68 61 72 20 73 71 6c 69 74 65 33 4f 70 63 char sqlite3Opc
24180 6f 64 65 50 72 6f 70 65 72 74 79 5b 5d 3b 0a 65 odeProperty[];.e
24190 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e 73 69 xtern const unsi
241a0 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 74 65 gned char sqlite
241b0 33 55 70 70 65 72 54 6f 4c 6f 77 65 72 5b 5d 3b 3UpperToLower[];
241c0 0a 65 78 74 65 72 6e 20 63 6f 6e 73 74 20 75 6e .extern const un
241d0 73 69 67 6e 65 64 20 63 68 61 72 20 73 71 6c 69 signed char sqli
241e0 74 65 33 43 74 79 70 65 4d 61 70 5b 5d 3b 0a 65 te3CtypeMap[];.e
241f0 78 74 65 72 6e 20 63 6f 6e 73 74 20 54 6f 6b 65 xtern const Toke
24200 6e 20 73 71 6c 69 74 65 33 49 6e 74 54 6f 6b 65 n sqlite3IntToke
24210 6e 73 5b 5d 3b 0a 65 78 74 65 72 6e 20 53 51 4c ns[];.extern SQL
24220 49 54 45 5f 57 53 44 20 73 74 72 75 63 74 20 53 ITE_WSD struct S
24230 71 6c 69 74 65 33 43 6f 6e 66 69 67 20 73 71 6c qlite3Config sql
24240 69 74 65 33 43 6f 6e 66 69 67 3b 0a 65 78 74 65 ite3Config;.exte
24250 72 6e 20 53 51 4c 49 54 45 5f 57 53 44 20 46 75 rn SQLITE_WSD Fu
24260 6e 63 44 65 66 48 61 73 68 20 73 71 6c 69 74 65 ncDefHash sqlite
24270 33 47 6c 6f 62 61 6c 46 75 6e 63 74 69 6f 6e 73 3GlobalFunctions
24280 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
24290 5f 4f 4d 49 54 5f 57 53 44 0a 65 78 74 65 72 6e _OMIT_WSD.extern
242a0 20 69 6e 74 20 73 71 6c 69 74 65 33 50 65 6e 64 int sqlite3Pend
242b0 69 6e 67 42 79 74 65 3b 0a 23 65 6e 64 69 66 0a ingByte;.#endif.
242c0 23 65 6e 64 69 66 0a 76 6f 69 64 20 73 71 6c 69 #endif.void sqli
242d0 74 65 33 52 6f 6f 74 50 61 67 65 4d 6f 76 65 64 te3RootPageMoved
242e0 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 (sqlite3*, int,
242f0 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 int, int);.void
24300 73 71 6c 69 74 65 33 52 65 69 6e 64 65 78 28 50 sqlite3Reindex(P
24310 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 arse*, Token*, T
24320 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 71 6c oken*);.void sql
24330 69 74 65 33 41 6c 74 65 72 46 75 6e 63 74 69 6f ite3AlterFunctio
24340 6e 73 28 76 6f 69 64 29 3b 0a 76 6f 69 64 20 73 ns(void);.void s
24350 71 6c 69 74 65 33 41 6c 74 65 72 52 65 6e 61 6d qlite3AlterRenam
24360 65 54 61 62 6c 65 28 50 61 72 73 65 2a 2c 20 53 eTable(Parse*, S
24370 72 63 4c 69 73 74 2a 2c 20 54 6f 6b 65 6e 2a 29 rcList*, Token*)
24380 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 47 65 74 ;.int sqlite3Get
24390 54 6f 6b 65 6e 28 63 6f 6e 73 74 20 75 6e 73 69 Token(const unsi
243a0 67 6e 65 64 20 63 68 61 72 20 2a 2c 20 69 6e 74 gned char *, int
243b0 20 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 *);.void sqlite
243c0 33 4e 65 73 74 65 64 50 61 72 73 65 28 50 61 72 3NestedParse(Par
243d0 73 65 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a se*, const char*
243e0 2c 20 2e 2e 2e 29 3b 0a 76 6f 69 64 20 73 71 6c , ...);.void sql
243f0 69 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 ite3ExpirePrepar
24400 65 64 53 74 61 74 65 6d 65 6e 74 73 28 73 71 6c edStatements(sql
24410 69 74 65 33 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 ite3*);.int sqli
24420 74 65 33 43 6f 64 65 53 75 62 73 65 6c 65 63 74 te3CodeSubselect
24430 28 50 61 72 73 65 20 2a 2c 20 45 78 70 72 20 2a (Parse *, Expr *
24440 2c 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 76 6f 69 , int, int);.voi
24450 64 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 50 d sqlite3SelectP
24460 72 65 70 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 rep(Parse*, Sele
24470 63 74 2a 2c 20 4e 61 6d 65 43 6f 6e 74 65 78 74 ct*, NameContext
24480 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d *);.int sqlite3M
24490 61 74 63 68 53 70 61 6e 4e 61 6d 65 28 63 6f 6e atchSpanName(con
244a0 73 74 20 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 st char*, const
244b0 63 68 61 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 char*, const cha
244c0 72 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 r*, const char*)
244d0 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 73 ;.int sqlite3Res
244e0 6f 6c 76 65 45 78 70 72 4e 61 6d 65 73 28 4e 61 olveExprNames(Na
244f0 6d 65 43 6f 6e 74 65 78 74 2a 2c 20 45 78 70 72 meContext*, Expr
24500 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
24510 52 65 73 6f 6c 76 65 53 65 6c 65 63 74 4e 61 6d ResolveSelectNam
24520 65 73 28 50 61 72 73 65 2a 2c 20 53 65 6c 65 63 es(Parse*, Selec
24530 74 2a 2c 20 4e 61 6d 65 43 6f 6e 74 65 78 74 2a t*, NameContext*
24540 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 52 );.void sqlite3R
24550 65 73 6f 6c 76 65 53 65 6c 66 52 65 66 65 72 65 esolveSelfRefere
24560 6e 63 65 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 nce(Parse*,Table
24570 2a 2c 69 6e 74 2c 45 78 70 72 2a 2c 45 78 70 72 *,int,Expr*,Expr
24580 4c 69 73 74 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 List*);.int sqli
24590 74 65 33 52 65 73 6f 6c 76 65 4f 72 64 65 72 47 te3ResolveOrderG
245a0 72 6f 75 70 42 79 28 50 61 72 73 65 2a 2c 20 53 roupBy(Parse*, S
245b0 65 6c 65 63 74 2a 2c 20 45 78 70 72 4c 69 73 74 elect*, ExprList
245c0 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b *, const char*);
245d0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6c .void sqlite3Col
245e0 75 6d 6e 44 65 66 61 75 6c 74 28 56 64 62 65 20 umnDefault(Vdbe
245f0 2a 2c 20 54 61 62 6c 65 20 2a 2c 20 69 6e 74 2c *, Table *, int,
24600 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c 69 int);.void sqli
24610 74 65 33 41 6c 74 65 72 46 69 6e 69 73 68 41 64 te3AlterFinishAd
24620 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 20 2a 2c dColumn(Parse *,
24630 20 54 6f 6b 65 6e 20 2a 29 3b 0a 76 6f 69 64 20 Token *);.void
24640 73 71 6c 69 74 65 33 41 6c 74 65 72 42 65 67 69 sqlite3AlterBegi
24650 6e 41 64 64 43 6f 6c 75 6d 6e 28 50 61 72 73 65 nAddColumn(Parse
24660 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a 29 3b 0a *, SrcList *);.
24670 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 33 CollSeq *sqlite3
24680 47 65 74 43 6f 6c 6c 53 65 71 28 50 61 72 73 65 GetCollSeq(Parse
24690 2a 2c 20 75 38 2c 20 43 6f 6c 6c 53 65 71 20 2a *, u8, CollSeq *
246a0 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a , const char*);.
246b0 63 68 61 72 20 73 71 6c 69 74 65 33 41 66 66 69 char sqlite3Affi
246c0 6e 69 74 79 54 79 70 65 28 63 6f 6e 73 74 20 63 nityType(const c
246d0 68 61 72 2a 2c 20 75 38 2a 29 3b 0a 76 6f 69 64 har*, u8*);.void
246e0 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 7a 65 28 sqlite3Analyze(
246f0 50 61 72 73 65 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 Parse*, Token*,
24700 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c Token*);.int sql
24710 69 74 65 33 49 6e 76 6f 6b 65 42 75 73 79 48 61 ite3InvokeBusyHa
24720 6e 64 6c 65 72 28 42 75 73 79 48 61 6e 64 6c 65 ndler(BusyHandle
24730 72 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r*);.int sqlite3
24740 46 69 6e 64 44 62 28 73 71 6c 69 74 65 33 2a 2c FindDb(sqlite3*,
24750 20 54 6f 6b 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 Token*);.int sq
24760 6c 69 74 65 33 46 69 6e 64 44 62 4e 61 6d 65 28 lite3FindDbName(
24770 73 71 6c 69 74 65 33 20 2a 2c 20 63 6f 6e 73 74 sqlite3 *, const
24780 20 63 68 61 72 20 2a 29 3b 0a 69 6e 74 20 73 71 char *);.int sq
24790 6c 69 74 65 33 41 6e 61 6c 79 73 69 73 4c 6f 61 lite3AnalysisLoa
247a0 64 28 73 71 6c 69 74 65 33 2a 2c 69 6e 74 20 69 d(sqlite3*,int i
247b0 44 42 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 DB);.void sqlite
247c0 33 44 65 6c 65 74 65 49 6e 64 65 78 53 61 6d 70 3DeleteIndexSamp
247d0 6c 65 73 28 73 71 6c 69 74 65 33 2a 2c 49 6e 64 les(sqlite3*,Ind
247e0 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 ex*);.void sqlit
247f0 65 33 44 65 66 61 75 6c 74 52 6f 77 45 73 74 28 e3DefaultRowEst(
24800 49 6e 64 65 78 2a 29 3b 0a 76 6f 69 64 20 73 71 Index*);.void sq
24810 6c 69 74 65 33 52 65 67 69 73 74 65 72 4c 69 6b lite3RegisterLik
24820 65 46 75 6e 63 74 69 6f 6e 73 28 73 71 6c 69 74 eFunctions(sqlit
24830 65 33 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 e3*, int);.int s
24840 71 6c 69 74 65 33 49 73 4c 69 6b 65 46 75 6e 63 qlite3IsLikeFunc
24850 74 69 6f 6e 28 73 71 6c 69 74 65 33 2a 2c 45 78 tion(sqlite3*,Ex
24860 70 72 2a 2c 69 6e 74 2a 2c 63 68 61 72 2a 29 3b pr*,int*,char*);
24870 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4d 69 6e .void sqlite3Min
24880 69 6d 75 6d 46 69 6c 65 46 6f 72 6d 61 74 28 50 imumFileFormat(P
24890 61 72 73 65 2a 2c 20 69 6e 74 2c 20 69 6e 74 29 arse*, int, int)
248a0 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 63 ;.void sqlite3Sc
248b0 68 65 6d 61 43 6c 65 61 72 28 76 6f 69 64 20 2a hemaClear(void *
248c0 29 3b 0a 53 63 68 65 6d 61 20 2a 73 71 6c 69 74 );.Schema *sqlit
248d0 65 33 53 63 68 65 6d 61 47 65 74 28 73 71 6c 69 e3SchemaGet(sqli
248e0 74 65 33 20 2a 2c 20 42 74 72 65 65 20 2a 29 3b te3 *, Btree *);
248f0 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68 65 .int sqlite3Sche
24900 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74 65 maToIndex(sqlite
24910 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a 29 3 *db, Schema *)
24920 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 71 6c 69 74 ;.KeyInfo *sqlit
24930 65 33 4b 65 79 49 6e 66 6f 41 6c 6c 6f 63 28 73 e3KeyInfoAlloc(s
24940 71 6c 69 74 65 33 2a 2c 69 6e 74 2c 69 6e 74 29 qlite3*,int,int)
24950 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 4b 65 ;.void sqlite3Ke
24960 79 49 6e 66 6f 55 6e 72 65 66 28 4b 65 79 49 6e yInfoUnref(KeyIn
24970 66 6f 2a 29 3b 0a 4b 65 79 49 6e 66 6f 20 2a 73 fo*);.KeyInfo *s
24980 71 6c 69 74 65 33 4b 65 79 49 6e 66 6f 52 65 66 qlite3KeyInfoRef
24990 28 4b 65 79 49 6e 66 6f 2a 29 3b 0a 4b 65 79 49 (KeyInfo*);.KeyI
249a0 6e 66 6f 20 2a 73 71 6c 69 74 65 33 4b 65 79 49 nfo *sqlite3KeyI
249b0 6e 66 6f 4f 66 49 6e 64 65 78 28 50 61 72 73 65 nfoOfIndex(Parse
249c0 2a 2c 20 49 6e 64 65 78 2a 29 3b 0a 23 69 66 64 *, Index*);.#ifd
249d0 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a ef SQLITE_DEBUG.
249e0 69 6e 74 20 73 71 6c 69 74 65 33 4b 65 79 49 6e int sqlite3KeyIn
249f0 66 6f 49 73 57 72 69 74 65 61 62 6c 65 28 4b 65 foIsWriteable(Ke
24a00 79 49 6e 66 6f 2a 29 3b 0a 23 65 6e 64 69 66 0a yInfo*);.#endif.
24a10 69 6e 74 20 73 71 6c 69 74 65 33 43 72 65 61 74 int sqlite3Creat
24a20 65 46 75 6e 63 28 73 71 6c 69 74 65 33 20 2a 2c eFunc(sqlite3 *,
24a30 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 69 const char *, i
24a40 6e 74 2c 20 69 6e 74 2c 20 76 6f 69 64 20 2a 2c nt, int, void *,
24a50 20 0a 20 20 76 6f 69 64 20 28 2a 29 28 73 71 6c . void (*)(sql
24a60 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 6e ite3_context*,in
24a70 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 t,sqlite3_value
24a80 2a 2a 29 2c 0a 20 20 76 6f 69 64 20 28 2a 29 28 **),. void (*)(
24a90 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a sqlite3_context*
24aa0 2c 69 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c ,int,sqlite3_val
24ab0 75 65 20 2a 2a 29 2c 20 76 6f 69 64 20 28 2a 29 ue **), void (*)
24ac0 28 73 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 (sqlite3_context
24ad0 2a 29 2c 0a 20 20 46 75 6e 63 44 65 73 74 72 75 *),. FuncDestru
24ae0 63 74 6f 72 20 2a 70 44 65 73 74 72 75 63 74 6f ctor *pDestructo
24af0 72 0a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 r.);.int sqlite3
24b00 41 70 69 45 78 69 74 28 73 71 6c 69 74 65 33 20 ApiExit(sqlite3
24b10 2a 64 62 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 *db, int);.int s
24b20 71 6c 69 74 65 33 4f 70 65 6e 54 65 6d 70 44 61 qlite3OpenTempDa
24b30 74 61 62 61 73 65 28 50 61 72 73 65 20 2a 29 3b tabase(Parse *);
24b40 0a 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 ..void sqlite3St
24b50 72 41 63 63 75 6d 49 6e 69 74 28 53 74 72 41 63 rAccumInit(StrAc
24b60 63 75 6d 2a 2c 20 63 68 61 72 2a 2c 20 69 6e 74 cum*, char*, int
24b70 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 71 6c , int);.void sql
24b80 69 74 65 33 53 74 72 41 63 63 75 6d 41 70 70 65 ite3StrAccumAppe
24b90 6e 64 28 53 74 72 41 63 63 75 6d 2a 2c 63 6f 6e nd(StrAccum*,con
24ba0 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a 76 st char*,int);.v
24bb0 6f 69 64 20 73 71 6c 69 74 65 33 53 74 72 41 63 oid sqlite3StrAc
24bc0 63 75 6d 41 70 70 65 6e 64 41 6c 6c 28 53 74 72 cumAppendAll(Str
24bd0 41 63 63 75 6d 2a 2c 63 6f 6e 73 74 20 63 68 61 Accum*,const cha
24be0 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 r*);.void sqlite
24bf0 33 41 70 70 65 6e 64 53 70 61 63 65 28 53 74 72 3AppendSpace(Str
24c00 41 63 63 75 6d 2a 2c 69 6e 74 29 3b 0a 63 68 61 Accum*,int);.cha
24c10 72 20 2a 73 71 6c 69 74 65 33 53 74 72 41 63 63 r *sqlite3StrAcc
24c20 75 6d 46 69 6e 69 73 68 28 53 74 72 41 63 63 75 umFinish(StrAccu
24c30 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 m*);.void sqlite
24c40 33 53 74 72 41 63 63 75 6d 52 65 73 65 74 28 53 3StrAccumReset(S
24c50 74 72 41 63 63 75 6d 2a 29 3b 0a 76 6f 69 64 20 trAccum*);.void
24c60 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65 73 sqlite3SelectDes
24c70 74 49 6e 69 74 28 53 65 6c 65 63 74 44 65 73 74 tInit(SelectDest
24c80 2a 2c 69 6e 74 2c 69 6e 74 29 3b 0a 45 78 70 72 *,int,int);.Expr
24c90 20 2a 73 71 6c 69 74 65 33 43 72 65 61 74 65 43 *sqlite3CreateC
24ca0 6f 6c 75 6d 6e 45 78 70 72 28 73 71 6c 69 74 65 olumnExpr(sqlite
24cb0 33 20 2a 2c 20 53 72 63 4c 69 73 74 20 2a 2c 20 3 *, SrcList *,
24cc0 69 6e 74 2c 20 69 6e 74 29 3b 0a 0a 76 6f 69 64 int, int);..void
24cd0 20 73 71 6c 69 74 65 33 42 61 63 6b 75 70 52 65 sqlite3BackupRe
24ce0 73 74 61 72 74 28 73 71 6c 69 74 65 33 5f 62 61 start(sqlite3_ba
24cf0 63 6b 75 70 20 2a 29 3b 0a 76 6f 69 64 20 73 71 ckup *);.void sq
24d00 6c 69 74 65 33 42 61 63 6b 75 70 55 70 64 61 74 lite3BackupUpdat
24d10 65 28 73 71 6c 69 74 65 33 5f 62 61 63 6b 75 70 e(sqlite3_backup
24d20 20 2a 2c 20 50 67 6e 6f 2c 20 63 6f 6e 73 74 20 *, Pgno, const
24d30 75 38 20 2a 29 3b 0a 0a 23 69 66 64 65 66 20 53 u8 *);..#ifdef S
24d40 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 QLITE_ENABLE_STA
24d50 54 33 5f 4f 52 5f 53 54 41 54 34 0a 76 6f 69 64 T3_OR_STAT4.void
24d60 20 73 71 6c 69 74 65 33 41 6e 61 6c 79 7a 65 46 sqlite3AnalyzeF
24d70 75 6e 63 74 69 6f 6e 73 28 76 6f 69 64 29 3b 0a unctions(void);.
24d80 69 6e 74 20 73 71 6c 69 74 65 33 53 74 61 74 34 int sqlite3Stat4
24d90 50 72 6f 62 65 53 65 74 56 61 6c 75 65 28 50 61 ProbeSetValue(Pa
24da0 72 73 65 2a 2c 49 6e 64 65 78 2a 2c 55 6e 70 61 rse*,Index*,Unpa
24db0 63 6b 65 64 52 65 63 6f 72 64 2a 2a 2c 45 78 70 ckedRecord**,Exp
24dc0 72 2a 2c 75 38 2c 69 6e 74 2c 69 6e 74 2a 29 3b r*,u8,int,int*);
24dd0 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 53 74 61 .void sqlite3Sta
24de0 74 34 50 72 6f 62 65 46 72 65 65 28 55 6e 70 61 t4ProbeFree(Unpa
24df0 63 6b 65 64 52 65 63 6f 72 64 2a 29 3b 0a 23 65 ckedRecord*);.#e
24e00 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 ndif../*.** The
24e10 69 6e 74 65 72 66 61 63 65 20 74 6f 20 74 68 65 interface to the
24e20 20 4c 45 4d 4f 4e 2d 67 65 6e 65 72 61 74 65 64 LEMON-generated
24e30 20 70 61 72 73 65 72 0a 2a 2f 0a 76 6f 69 64 20 parser.*/.void
24e40 2a 73 71 6c 69 74 65 33 50 61 72 73 65 72 41 6c *sqlite3ParserAl
24e50 6c 6f 63 28 76 6f 69 64 2a 28 2a 29 28 73 69 7a loc(void*(*)(siz
24e60 65 5f 74 29 29 3b 0a 76 6f 69 64 20 73 71 6c 69 e_t));.void sqli
24e70 74 65 33 50 61 72 73 65 72 46 72 65 65 28 76 6f te3ParserFree(vo
24e80 69 64 2a 2c 20 76 6f 69 64 28 2a 29 28 76 6f 69 id*, void(*)(voi
24e90 64 2a 29 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 d*));.void sqlit
24ea0 65 33 50 61 72 73 65 72 28 76 6f 69 64 2a 2c 20 e3Parser(void*,
24eb0 69 6e 74 2c 20 54 6f 6b 65 6e 2c 20 50 61 72 73 int, Token, Pars
24ec0 65 2a 29 3b 0a 23 69 66 64 65 66 20 59 59 54 52 e*);.#ifdef YYTR
24ed0 41 43 4b 4d 41 58 53 54 41 43 4b 44 45 50 54 48 ACKMAXSTACKDEPTH
24ee0 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 50 61 . int sqlite3Pa
24ef0 72 73 65 72 53 74 61 63 6b 50 65 61 6b 28 76 6f rserStackPeak(vo
24f00 69 64 2a 29 3b 0a 23 65 6e 64 69 66 0a 0a 76 6f id*);.#endif..vo
24f10 69 64 20 73 71 6c 69 74 65 33 41 75 74 6f 4c 6f id sqlite3AutoLo
24f20 61 64 45 78 74 65 6e 73 69 6f 6e 73 28 73 71 6c adExtensions(sql
24f30 69 74 65 33 2a 29 3b 0a 23 69 66 6e 64 65 66 20 ite3*);.#ifndef
24f40 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 4c 4f 41 44 SQLITE_OMIT_LOAD
24f50 5f 45 58 54 45 4e 53 49 4f 4e 0a 20 20 76 6f 69 _EXTENSION. voi
24f60 64 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 78 d sqlite3CloseEx
24f70 74 65 6e 73 69 6f 6e 73 28 73 71 6c 69 74 65 33 tensions(sqlite3
24f80 2a 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 *);.#else.# defi
24f90 6e 65 20 73 71 6c 69 74 65 33 43 6c 6f 73 65 45 ne sqlite3CloseE
24fa0 78 74 65 6e 73 69 6f 6e 73 28 58 29 0a 23 65 6e xtensions(X).#en
24fb0 64 69 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c dif..#ifndef SQL
24fc0 49 54 45 5f 4f 4d 49 54 5f 53 48 41 52 45 44 5f ITE_OMIT_SHARED_
24fd0 43 41 43 48 45 0a 20 20 76 6f 69 64 20 73 71 6c CACHE. void sql
24fe0 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 50 61 ite3TableLock(Pa
24ff0 72 73 65 20 2a 2c 20 69 6e 74 2c 20 69 6e 74 2c rse *, int, int,
25000 20 75 38 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 u8, const char
25010 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 *);.#else. #def
25020 69 6e 65 20 73 71 6c 69 74 65 33 54 61 62 6c 65 ine sqlite3Table
25030 4c 6f 63 6b 28 76 2c 77 2c 78 2c 79 2c 7a 29 0a Lock(v,w,x,y,z).
25040 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 53 #endif..#ifdef S
25050 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 69 6e 74 QLITE_TEST. int
25060 20 73 71 6c 69 74 65 33 55 74 66 38 54 6f 38 28 sqlite3Utf8To8(
25070 75 6e 73 69 67 6e 65 64 20 63 68 61 72 2a 29 3b unsigned char*);
25080 0a 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 .#endif..#ifdef
25090 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
250a0 55 41 4c 54 41 42 4c 45 0a 23 20 20 64 65 66 69 UALTABLE.# defi
250b0 6e 65 20 73 71 6c 69 74 65 33 56 74 61 62 43 6c ne sqlite3VtabCl
250c0 65 61 72 28 59 29 0a 23 20 20 64 65 66 69 6e 65 ear(Y).# define
250d0 20 73 71 6c 69 74 65 33 56 74 61 62 53 79 6e 63 sqlite3VtabSync
250e0 28 58 2c 59 29 20 53 51 4c 49 54 45 5f 4f 4b 0a (X,Y) SQLITE_OK.
250f0 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 # define sqlite
25100 33 56 74 61 62 52 6f 6c 6c 62 61 63 6b 28 58 29 3VtabRollback(X)
25110 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 .# define sqlit
25120 65 33 56 74 61 62 43 6f 6d 6d 69 74 28 58 29 0a e3VtabCommit(X).
25130 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 # define sqlite
25140 33 56 74 61 62 49 6e 53 79 6e 63 28 64 62 29 20 3VtabInSync(db)
25150 30 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 0.# define sqli
25160 74 65 33 56 74 61 62 4c 6f 63 6b 28 58 29 20 0a te3VtabLock(X) .
25170 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 # define sqlite
25180 33 56 74 61 62 55 6e 6c 6f 63 6b 28 58 29 0a 23 3VtabUnlock(X).#
25190 20 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 define sqlite3
251a0 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 58 VtabUnlockList(X
251b0 29 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 ).# define sqli
251c0 74 65 33 56 74 61 62 53 61 76 65 70 6f 69 6e 74 te3VtabSavepoint
251d0 28 58 2c 20 59 2c 20 5a 29 20 53 51 4c 49 54 45 (X, Y, Z) SQLITE
251e0 5f 4f 4b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 _OK.# define sq
251f0 6c 69 74 65 33 47 65 74 56 54 61 62 6c 65 28 58 lite3GetVTable(X
25200 2c 59 29 20 20 28 28 56 54 61 62 6c 65 2a 29 30 ,Y) ((VTable*)0
25210 29 0a 23 65 6c 73 65 0a 20 20 20 76 6f 69 64 20 ).#else. void
25220 73 71 6c 69 74 65 33 56 74 61 62 43 6c 65 61 72 sqlite3VtabClear
25230 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 54 61 (sqlite3 *db, Ta
25240 62 6c 65 2a 29 3b 0a 20 20 20 76 6f 69 64 20 73 ble*);. void s
25250 71 6c 69 74 65 33 56 74 61 62 44 69 73 63 6f 6e qlite3VtabDiscon
25260 6e 65 63 74 28 73 71 6c 69 74 65 33 20 2a 64 62 nect(sqlite3 *db
25270 2c 20 54 61 62 6c 65 20 2a 70 29 3b 0a 20 20 20 , Table *p);.
25280 69 6e 74 20 73 71 6c 69 74 65 33 56 74 61 62 53 int sqlite3VtabS
25290 79 6e 63 28 73 71 6c 69 74 65 33 20 2a 64 62 2c ync(sqlite3 *db,
252a0 20 56 64 62 65 2a 29 3b 0a 20 20 20 69 6e 74 20 Vdbe*);. int
252b0 73 71 6c 69 74 65 33 56 74 61 62 52 6f 6c 6c 62 sqlite3VtabRollb
252c0 61 63 6b 28 73 71 6c 69 74 65 33 20 2a 64 62 29 ack(sqlite3 *db)
252d0 3b 0a 20 20 20 69 6e 74 20 73 71 6c 69 74 65 33 ;. int sqlite3
252e0 56 74 61 62 43 6f 6d 6d 69 74 28 73 71 6c 69 74 VtabCommit(sqlit
252f0 65 33 20 2a 64 62 29 3b 0a 20 20 20 76 6f 69 64 e3 *db);. void
25300 20 73 71 6c 69 74 65 33 56 74 61 62 4c 6f 63 6b sqlite3VtabLock
25310 28 56 54 61 62 6c 65 20 2a 29 3b 0a 20 20 20 76 (VTable *);. v
25320 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 55 oid sqlite3VtabU
25330 6e 6c 6f 63 6b 28 56 54 61 62 6c 65 20 2a 29 3b nlock(VTable *);
25340 0a 20 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 . void sqlite3
25350 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 73 VtabUnlockList(s
25360 71 6c 69 74 65 33 2a 29 3b 0a 20 20 20 69 6e 74 qlite3*);. int
25370 20 73 71 6c 69 74 65 33 56 74 61 62 53 61 76 65 sqlite3VtabSave
25380 70 6f 69 6e 74 28 73 71 6c 69 74 65 33 20 2a 2c point(sqlite3 *,
25390 20 69 6e 74 2c 20 69 6e 74 29 3b 0a 20 20 20 76 int, int);. v
253a0 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 49 oid sqlite3VtabI
253b0 6d 70 6f 72 74 45 72 72 6d 73 67 28 56 64 62 65 mportErrmsg(Vdbe
253c0 2a 2c 20 73 71 6c 69 74 65 33 5f 76 74 61 62 2a *, sqlite3_vtab*
253d0 29 3b 0a 20 20 20 56 54 61 62 6c 65 20 2a 73 71 );. VTable *sq
253e0 6c 69 74 65 33 47 65 74 56 54 61 62 6c 65 28 73 lite3GetVTable(s
253f0 71 6c 69 74 65 33 2a 2c 20 54 61 62 6c 65 2a 29 qlite3*, Table*)
25400 3b 0a 23 20 20 64 65 66 69 6e 65 20 73 71 6c 69 ;.# define sqli
25410 74 65 33 56 74 61 62 49 6e 53 79 6e 63 28 64 62 te3VtabInSync(db
25420 29 20 28 28 64 62 29 2d 3e 6e 56 54 72 61 6e 73 ) ((db)->nVTrans
25430 3e 30 20 26 26 20 28 64 62 29 2d 3e 61 56 54 72 >0 && (db)->aVTr
25440 61 6e 73 3d 3d 30 29 0a 23 65 6e 64 69 66 0a 76 ans==0).#endif.v
25450 6f 69 64 20 73 71 6c 69 74 65 33 56 74 61 62 4d oid sqlite3VtabM
25460 61 6b 65 57 72 69 74 61 62 6c 65 28 50 61 72 73 akeWritable(Pars
25470 65 2a 2c 54 61 62 6c 65 2a 29 3b 0a 76 6f 69 64 e*,Table*);.void
25480 20 73 71 6c 69 74 65 33 56 74 61 62 42 65 67 69 sqlite3VtabBegi
25490 6e 50 61 72 73 65 28 50 61 72 73 65 2a 2c 20 54 nParse(Parse*, T
254a0 6f 6b 65 6e 2a 2c 20 54 6f 6b 65 6e 2a 2c 20 54 oken*, Token*, T
254b0 6f 6b 65 6e 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 oken*, int);.voi
254c0 64 20 73 71 6c 69 74 65 33 56 74 61 62 46 69 6e d sqlite3VtabFin
254d0 69 73 68 50 61 72 73 65 28 50 61 72 73 65 2a 2c ishParse(Parse*,
254e0 20 54 6f 6b 65 6e 2a 29 3b 0a 76 6f 69 64 20 73 Token*);.void s
254f0 71 6c 69 74 65 33 56 74 61 62 41 72 67 49 6e 69 qlite3VtabArgIni
25500 74 28 50 61 72 73 65 2a 29 3b 0a 76 6f 69 64 20 t(Parse*);.void
25510 73 71 6c 69 74 65 33 56 74 61 62 41 72 67 45 78 sqlite3VtabArgEx
25520 74 65 6e 64 28 50 61 72 73 65 2a 2c 20 54 6f 6b tend(Parse*, Tok
25530 65 6e 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 en*);.int sqlite
25540 33 56 74 61 62 43 61 6c 6c 43 72 65 61 74 65 28 3VtabCallCreate(
25550 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 sqlite3*, int, c
25560 6f 6e 73 74 20 63 68 61 72 20 2a 2c 20 63 68 61 onst char *, cha
25570 72 20 2a 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 r **);.int sqlit
25580 65 33 56 74 61 62 43 61 6c 6c 43 6f 6e 6e 65 63 e3VtabCallConnec
25590 74 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a t(Parse*, Table*
255a0 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 74 );.int sqlite3Vt
255b0 61 62 43 61 6c 6c 44 65 73 74 72 6f 79 28 73 71 abCallDestroy(sq
255c0 6c 69 74 65 33 2a 2c 20 69 6e 74 2c 20 63 6f 6e lite3*, int, con
255d0 73 74 20 63 68 61 72 20 2a 29 3b 0a 69 6e 74 20 st char *);.int
255e0 73 71 6c 69 74 65 33 56 74 61 62 42 65 67 69 6e sqlite3VtabBegin
255f0 28 73 71 6c 69 74 65 33 20 2a 2c 20 56 54 61 62 (sqlite3 *, VTab
25600 6c 65 20 2a 29 3b 0a 46 75 6e 63 44 65 66 20 2a le *);.FuncDef *
25610 73 71 6c 69 74 65 33 56 74 61 62 4f 76 65 72 6c sqlite3VtabOverl
25620 6f 61 64 46 75 6e 63 74 69 6f 6e 28 73 71 6c 69 oadFunction(sqli
25630 74 65 33 20 2a 2c 46 75 6e 63 44 65 66 2a 2c 20 te3 *,FuncDef*,
25640 69 6e 74 20 6e 41 72 67 2c 20 45 78 70 72 2a 29 int nArg, Expr*)
25650 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 49 6e ;.void sqlite3In
25660 76 61 6c 69 64 46 75 6e 63 74 69 6f 6e 28 73 71 validFunction(sq
25670 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 2a 2c 69 lite3_context*,i
25680 6e 74 2c 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 nt,sqlite3_value
25690 2a 2a 29 3b 0a 73 71 6c 69 74 65 33 5f 69 6e 74 **);.sqlite3_int
256a0 36 34 20 73 71 6c 69 74 65 33 53 74 6d 74 43 75 64 sqlite3StmtCu
256b0 72 72 65 6e 74 54 69 6d 65 28 73 71 6c 69 74 65 rrentTime(sqlite
256c0 33 5f 63 6f 6e 74 65 78 74 2a 29 3b 0a 69 6e 74 3_context*);.int
256d0 20 73 71 6c 69 74 65 33 56 64 62 65 50 61 72 61 sqlite3VdbePara
256e0 6d 65 74 65 72 49 6e 64 65 78 28 56 64 62 65 2a meterIndex(Vdbe*
256f0 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c 20 69 , const char*, i
25700 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 nt);.int sqlite3
25710 54 72 61 6e 73 66 65 72 42 69 6e 64 69 6e 67 73 TransferBindings
25720 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2c (sqlite3_stmt *,
25730 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 29 sqlite3_stmt *)
25740 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 ;.void sqlite3Pa
25750 72 73 65 72 52 65 73 65 74 28 50 61 72 73 65 2a rserReset(Parse*
25760 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 );.int sqlite3Re
25770 70 72 65 70 61 72 65 28 56 64 62 65 2a 29 3b 0a prepare(Vdbe*);.
25780 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78 70 72 void sqlite3Expr
25790 4c 69 73 74 43 68 65 63 6b 4c 65 6e 67 74 68 28 ListCheckLength(
257a0 50 61 72 73 65 2a 2c 20 45 78 70 72 4c 69 73 74 Parse*, ExprList
257b0 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b *, const char*);
257c0 0a 43 6f 6c 6c 53 65 71 20 2a 73 71 6c 69 74 65 .CollSeq *sqlite
257d0 33 42 69 6e 61 72 79 43 6f 6d 70 61 72 65 43 6f 3BinaryCompareCo
257e0 6c 6c 53 65 71 28 50 61 72 73 65 20 2a 2c 20 45 llSeq(Parse *, E
257f0 78 70 72 20 2a 2c 20 45 78 70 72 20 2a 29 3b 0a xpr *, Expr *);.
25800 69 6e 74 20 73 71 6c 69 74 65 33 54 65 6d 70 49 int sqlite3TempI
25810 6e 4d 65 6d 6f 72 79 28 63 6f 6e 73 74 20 73 71 nMemory(const sq
25820 6c 69 74 65 33 2a 29 3b 0a 63 6f 6e 73 74 20 63 lite3*);.const c
25830 68 61 72 20 2a 73 71 6c 69 74 65 33 4a 6f 75 72 har *sqlite3Jour
25840 6e 61 6c 4d 6f 64 65 6e 61 6d 65 28 69 6e 74 29 nalModename(int)
25850 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
25860 5f 4f 4d 49 54 5f 57 41 4c 0a 20 20 69 6e 74 20 _OMIT_WAL. int
25870 73 71 6c 69 74 65 33 43 68 65 63 6b 70 6f 69 6e sqlite3Checkpoin
25880 74 28 73 71 6c 69 74 65 33 2a 2c 20 69 6e 74 2c t(sqlite3*, int,
25890 20 69 6e 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 2a int, int*, int*
258a0 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 33 );. int sqlite3
258b0 57 61 6c 44 65 66 61 75 6c 74 48 6f 6f 6b 28 76 WalDefaultHook(v
258c0 6f 69 64 2a 2c 73 71 6c 69 74 65 33 2a 2c 63 6f oid*,sqlite3*,co
258d0 6e 73 74 20 63 68 61 72 2a 2c 69 6e 74 29 3b 0a nst char*,int);.
258e0 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 20 53 #endif.#ifndef S
258f0 51 4c 49 54 45 5f 4f 4d 49 54 5f 43 54 45 0a 20 QLITE_OMIT_CTE.
25900 20 57 69 74 68 20 2a 73 71 6c 69 74 65 33 57 69 With *sqlite3Wi
25910 74 68 41 64 64 28 50 61 72 73 65 2a 2c 57 69 74 thAdd(Parse*,Wit
25920 68 2a 2c 54 6f 6b 65 6e 2a 2c 45 78 70 72 4c 69 h*,Token*,ExprLi
25930 73 74 2a 2c 53 65 6c 65 63 74 2a 29 3b 0a 20 20 st*,Select*);.
25940 76 6f 69 64 20 73 71 6c 69 74 65 33 57 69 74 68 void sqlite3With
25950 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 2a 2c Delete(sqlite3*,
25960 57 69 74 68 2a 29 3b 0a 20 20 76 6f 69 64 20 73 With*);. void s
25970 71 6c 69 74 65 33 57 69 74 68 50 75 73 68 28 50 qlite3WithPush(P
25980 61 72 73 65 2a 2c 20 57 69 74 68 2a 2c 20 75 38 arse*, With*, u8
25990 29 3b 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 );.#else.#define
259a0 20 73 71 6c 69 74 65 33 57 69 74 68 50 75 73 68 sqlite3WithPush
259b0 28 78 2c 79 2c 7a 29 0a 23 64 65 66 69 6e 65 20 (x,y,z).#define
259c0 73 71 6c 69 74 65 33 57 69 74 68 44 65 6c 65 74 sqlite3WithDelet
259d0 65 28 78 2c 79 29 0a 23 65 6e 64 69 66 0a 0a 2f e(x,y).#endif../
259e0 2a 20 44 65 63 6c 61 72 61 74 69 6f 6e 73 20 66 * Declarations f
259f0 6f 72 20 66 75 6e 63 74 69 6f 6e 73 20 69 6e 20 or functions in
25a00 66 6b 65 79 2e 63 2e 20 41 6c 6c 20 6f 66 20 74 fkey.c. All of t
25a10 68 65 73 65 20 61 72 65 20 72 65 70 6c 61 63 65 hese are replace
25a20 64 20 62 79 0a 2a 2a 20 6e 6f 2d 6f 70 20 6d 61 d by.** no-op ma
25a30 63 72 6f 73 20 69 66 20 4f 4d 49 54 5f 46 4f 52 cros if OMIT_FOR
25a40 45 49 47 4e 5f 4b 45 59 20 69 73 20 64 65 66 69 EIGN_KEY is defi
25a50 6e 65 64 2e 20 49 6e 20 74 68 69 73 20 63 61 73 ned. In this cas
25a60 65 20 6e 6f 20 66 6f 72 65 69 67 6e 0a 2a 2a 20 e no foreign.**
25a70 6b 65 79 20 66 75 6e 63 74 69 6f 6e 61 6c 69 74 key functionalit
25a80 79 20 69 73 20 61 76 61 69 6c 61 62 6c 65 2e 20 y is available.
25a90 49 66 20 4f 4d 49 54 5f 54 52 49 47 47 45 52 20 If OMIT_TRIGGER
25aa0 69 73 20 64 65 66 69 6e 65 64 20 62 75 74 0a 2a is defined but.*
25ab0 2a 20 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b * OMIT_FOREIGN_K
25ac0 45 59 20 69 73 20 6e 6f 74 2c 20 6f 6e 6c 79 20 EY is not, only
25ad0 73 6f 6d 65 20 6f 66 20 74 68 65 20 66 75 6e 63 some of the func
25ae0 74 69 6f 6e 73 20 61 72 65 20 6e 6f 2d 6f 70 65 tions are no-ope
25af0 64 2e 20 49 6e 0a 2a 2a 20 74 68 69 73 20 63 61 d. In.** this ca
25b00 73 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 se foreign keys
25b10 61 72 65 20 70 61 72 73 65 64 2c 20 62 75 74 20 are parsed, but
25b20 6e 6f 20 6f 74 68 65 72 20 66 75 6e 63 74 69 6f no other functio
25b30 6e 61 6c 69 74 79 20 69 73 20 0a 2a 2a 20 70 72 nality is .** pr
25b40 6f 76 69 64 65 64 20 28 65 6e 66 6f 72 63 65 6d ovided (enforcem
25b50 65 6e 74 20 6f 66 20 46 4b 20 63 6f 6e 73 74 72 ent of FK constr
25b60 61 69 6e 74 73 20 72 65 71 75 69 72 65 73 20 74 aints requires t
25b70 68 65 20 74 72 69 67 67 65 72 73 20 73 75 62 2d he triggers sub-
25b80 73 79 73 74 65 6d 29 2e 0a 2a 2f 0a 23 69 66 20 system)..*/.#if
25b90 21 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f !defined(SQLITE_
25ba0 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 OMIT_FOREIGN_KEY
25bb0 29 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 ) && !defined(SQ
25bc0 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 LITE_OMIT_TRIGGE
25bd0 52 29 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 R). void sqlite
25be0 33 46 6b 43 68 65 63 6b 28 50 61 72 73 65 2a 2c 3FkCheck(Parse*,
25bf0 20 54 61 62 6c 65 2a 2c 20 69 6e 74 2c 20 69 6e Table*, int, in
25c00 74 2c 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 t, int*, int);.
25c10 20 76 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 44 void sqlite3FkD
25c20 72 6f 70 54 61 62 6c 65 28 50 61 72 73 65 2a 2c ropTable(Parse*,
25c30 20 53 72 63 4c 69 73 74 20 2a 2c 20 54 61 62 6c SrcList *, Tabl
25c40 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 e*);. void sqli
25c50 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 50 61 72 te3FkActions(Par
25c60 73 65 2a 2c 20 54 61 62 6c 65 2a 2c 20 45 78 70 se*, Table*, Exp
25c70 72 4c 69 73 74 2a 2c 20 69 6e 74 2c 20 69 6e 74 rList*, int, int
25c80 2a 2c 20 69 6e 74 29 3b 0a 20 20 69 6e 74 20 73 *, int);. int s
25c90 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72 65 64 qlite3FkRequired
25ca0 28 50 61 72 73 65 2a 2c 20 54 61 62 6c 65 2a 2c (Parse*, Table*,
25cb0 20 69 6e 74 2a 2c 20 69 6e 74 29 3b 0a 20 20 75 int*, int);. u
25cc0 33 32 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 32 sqlite3FkOldm
25cd0 61 73 6b 28 50 61 72 73 65 2a 2c 20 54 61 62 6c ask(Parse*, Tabl
25ce0 65 2a 29 3b 0a 20 20 46 4b 65 79 20 2a 73 71 6c e*);. FKey *sql
25cf0 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 65 73 ite3FkReferences
25d00 28 54 61 62 6c 65 20 2a 29 3b 0a 23 65 6c 73 65 (Table *);.#else
25d10 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
25d20 65 33 46 6b 41 63 74 69 6f 6e 73 28 61 2c 62 2c e3FkActions(a,b,
25d30 63 2c 64 2c 65 2c 66 29 0a 20 20 23 64 65 66 69 c,d,e,f). #defi
25d40 6e 65 20 73 71 6c 69 74 65 33 46 6b 43 68 65 63 ne sqlite3FkChec
25d50 6b 28 61 2c 62 2c 63 2c 64 2c 65 2c 66 29 0a 20 k(a,b,c,d,e,f).
25d60 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
25d70 46 6b 44 72 6f 70 54 61 62 6c 65 28 61 2c 62 2c FkDropTable(a,b,
25d80 63 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c c). #define sql
25d90 69 74 65 33 46 6b 4f 6c 64 6d 61 73 6b 28 61 2c ite3FkOldmask(a,
25da0 62 29 20 20 20 20 20 20 20 20 20 30 0a 20 20 23 b) 0. #
25db0 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b define sqlite3Fk
25dc0 52 65 71 75 69 72 65 64 28 61 2c 62 2c 63 2c 64 Required(a,b,c,d
25dd0 29 20 20 20 20 30 0a 23 65 6e 64 69 66 0a 23 69 ) 0.#endif.#i
25de0 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
25df0 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 0a 20 20 T_FOREIGN_KEY.
25e00 76 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 44 65 void sqlite3FkDe
25e10 6c 65 74 65 28 73 71 6c 69 74 65 33 20 2a 2c 20 lete(sqlite3 *,
25e20 54 61 62 6c 65 2a 29 3b 0a 20 20 69 6e 74 20 73 Table*);. int s
25e30 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e qlite3FkLocateIn
25e40 64 65 78 28 50 61 72 73 65 2a 2c 54 61 62 6c 65 dex(Parse*,Table
25e50 2a 2c 46 4b 65 79 2a 2c 49 6e 64 65 78 2a 2a 2c *,FKey*,Index**,
25e60 69 6e 74 2a 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 int**);.#else.
25e70 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 #define sqlite3F
25e80 6b 44 65 6c 65 74 65 28 61 2c 62 29 0a 20 20 23 kDelete(a,b). #
25e90 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 46 6b define sqlite3Fk
25ea0 4c 6f 63 61 74 65 49 6e 64 65 78 28 61 2c 62 2c LocateIndex(a,b,
25eb0 63 2c 64 2c 65 29 0a 23 65 6e 64 69 66 0a 0a 0a c,d,e).#endif...
25ec0 2f 2a 0a 2a 2a 20 41 76 61 69 6c 61 62 6c 65 20 /*.** Available
25ed0 66 61 75 6c 74 20 69 6e 6a 65 63 74 6f 72 73 2e fault injectors.
25ee0 20 20 53 68 6f 75 6c 64 20 62 65 20 6e 75 6d 62 Should be numb
25ef0 65 72 65 64 20 62 65 67 69 6e 6e 69 6e 67 20 77 ered beginning w
25f00 69 74 68 20 30 2e 0a 2a 2f 0a 23 64 65 66 69 6e ith 0..*/.#defin
25f10 65 20 53 51 4c 49 54 45 5f 46 41 55 4c 54 49 4e e SQLITE_FAULTIN
25f20 4a 45 43 54 4f 52 5f 4d 41 4c 4c 4f 43 20 20 20 JECTOR_MALLOC
25f30 20 20 30 0a 23 64 65 66 69 6e 65 20 53 51 4c 49 0.#define SQLI
25f40 54 45 5f 46 41 55 4c 54 49 4e 4a 45 43 54 4f 52 TE_FAULTINJECTOR
25f50 5f 43 4f 55 4e 54 20 20 20 20 20 20 31 0a 0a 2f _COUNT 1../
25f60 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65 72 66 61 *.** The interfa
25f70 63 65 20 74 6f 20 74 68 65 20 63 6f 64 65 20 69 ce to the code i
25f80 6e 20 66 61 75 6c 74 2e 63 20 75 73 65 64 20 66 n fault.c used f
25f90 6f 72 20 69 64 65 6e 74 69 66 79 69 6e 67 20 22 or identifying "
25fa0 62 65 6e 69 67 6e 22 0a 2a 2a 20 6d 61 6c 6c 6f benign".** mallo
25fb0 63 20 66 61 69 6c 75 72 65 73 2e 20 54 68 69 73 c failures. This
25fc0 20 69 73 20 6f 6e 6c 79 20 70 72 65 73 65 6e 74 is only present
25fd0 20 69 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f if SQLITE_OMIT_
25fe0 42 55 49 4c 54 49 4e 5f 54 45 53 54 0a 2a 2a 20 BUILTIN_TEST.**
25ff0 69 73 20 6e 6f 74 20 64 65 66 69 6e 65 64 2e 0a is not defined..
26000 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 */.#ifndef SQLIT
26010 45 5f 4f 4d 49 54 5f 42 55 49 4c 54 49 4e 5f 54 E_OMIT_BUILTIN_T
26020 45 53 54 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 EST. void sqlit
26030 65 33 42 65 67 69 6e 42 65 6e 69 67 6e 4d 61 6c e3BeginBenignMal
26040 6c 6f 63 28 76 6f 69 64 29 3b 0a 20 20 76 6f 69 loc(void);. voi
26050 64 20 73 71 6c 69 74 65 33 45 6e 64 42 65 6e 69 d sqlite3EndBeni
26060 67 6e 4d 61 6c 6c 6f 63 28 76 6f 69 64 29 3b 0a gnMalloc(void);.
26070 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 #else. #define
26080 73 71 6c 69 74 65 33 42 65 67 69 6e 42 65 6e 69 sqlite3BeginBeni
26090 67 6e 4d 61 6c 6c 6f 63 28 29 0a 20 20 23 64 65 gnMalloc(). #de
260a0 66 69 6e 65 20 73 71 6c 69 74 65 33 45 6e 64 42 fine sqlite3EndB
260b0 65 6e 69 67 6e 4d 61 6c 6c 6f 63 28 29 0a 23 65 enignMalloc().#e
260c0 6e 64 69 66 0a 0a 23 64 65 66 69 6e 65 20 49 4e ndif..#define IN
260d0 5f 49 4e 44 45 58 5f 52 4f 57 49 44 20 20 20 20 _INDEX_ROWID
260e0 20 20 20 20 20 20 20 31 0a 23 64 65 66 69 6e 65 1.#define
260f0 20 49 4e 5f 49 4e 44 45 58 5f 45 50 48 20 20 20 IN_INDEX_EPH
26100 20 20 20 20 20 20 20 20 20 20 32 0a 23 64 65 66 2.#def
26110 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f 49 4e 44 ine IN_INDEX_IND
26120 45 58 5f 41 53 43 20 20 20 20 20 20 20 33 0a 23 EX_ASC 3.#
26130 64 65 66 69 6e 65 20 49 4e 5f 49 4e 44 45 58 5f define IN_INDEX_
26140 49 4e 44 45 58 5f 44 45 53 43 20 20 20 20 20 20 INDEX_DESC
26150 34 0a 69 6e 74 20 73 71 6c 69 74 65 33 46 69 6e 4.int sqlite3Fin
26160 64 49 6e 49 6e 64 65 78 28 50 61 72 73 65 20 2a dInIndex(Parse *
26170 2c 20 45 78 70 72 20 2a 2c 20 69 6e 74 2a 29 3b , Expr *, int*);
26180 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
26190 45 4e 41 42 4c 45 5f 41 54 4f 4d 49 43 5f 57 52 ENABLE_ATOMIC_WR
261a0 49 54 45 0a 20 20 69 6e 74 20 73 71 6c 69 74 65 ITE. int sqlite
261b0 33 4a 6f 75 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 3JournalOpen(sql
261c0 69 74 65 33 5f 76 66 73 20 2a 2c 20 63 6f 6e 73 ite3_vfs *, cons
261d0 74 20 63 68 61 72 20 2a 2c 20 73 71 6c 69 74 65 t char *, sqlite
261e0 33 5f 66 69 6c 65 20 2a 2c 20 69 6e 74 2c 20 69 3_file *, int, i
261f0 6e 74 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 nt);. int sqlit
26200 65 33 4a 6f 75 72 6e 61 6c 53 69 7a 65 28 73 71 e3JournalSize(sq
26210 6c 69 74 65 33 5f 76 66 73 20 2a 29 3b 0a 20 20 lite3_vfs *);.
26220 69 6e 74 20 73 71 6c 69 74 65 33 4a 6f 75 72 6e int sqlite3Journ
26230 61 6c 43 72 65 61 74 65 28 73 71 6c 69 74 65 33 alCreate(sqlite3
26240 5f 66 69 6c 65 20 2a 29 3b 0a 20 20 69 6e 74 20 _file *);. int
26250 73 71 6c 69 74 65 33 4a 6f 75 72 6e 61 6c 45 78 sqlite3JournalEx
26260 69 73 74 73 28 73 71 6c 69 74 65 33 5f 66 69 6c ists(sqlite3_fil
26270 65 20 2a 70 29 3b 0a 23 65 6c 73 65 0a 20 20 23 e *p);.#else. #
26280 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 4a 6f define sqlite3Jo
26290 75 72 6e 61 6c 53 69 7a 65 28 70 56 66 73 29 20 urnalSize(pVfs)
262a0 28 28 70 56 66 73 29 2d 3e 73 7a 4f 73 46 69 6c ((pVfs)->szOsFil
262b0 65 29 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c e). #define sql
262c0 69 74 65 33 4a 6f 75 72 6e 61 6c 45 78 69 73 74 ite3JournalExist
262d0 73 28 70 29 20 31 0a 23 65 6e 64 69 66 0a 0a 76 s(p) 1.#endif..v
262e0 6f 69 64 20 73 71 6c 69 74 65 33 4d 65 6d 4a 6f oid sqlite3MemJo
262f0 75 72 6e 61 6c 4f 70 65 6e 28 73 71 6c 69 74 65 urnalOpen(sqlite
26300 33 5f 66 69 6c 65 20 2a 29 3b 0a 69 6e 74 20 73 3_file *);.int s
26310 71 6c 69 74 65 33 4d 65 6d 4a 6f 75 72 6e 61 6c qlite3MemJournal
26320 53 69 7a 65 28 76 6f 69 64 29 3b 0a 69 6e 74 20 Size(void);.int
26330 73 71 6c 69 74 65 33 49 73 4d 65 6d 4a 6f 75 72 sqlite3IsMemJour
26340 6e 61 6c 28 73 71 6c 69 74 65 33 5f 66 69 6c 65 nal(sqlite3_file
26350 20 2a 29 3b 0a 0a 23 69 66 20 53 51 4c 49 54 45 *);..#if SQLITE
26360 5f 4d 41 58 5f 45 58 50 52 5f 44 45 50 54 48 3e _MAX_EXPR_DEPTH>
26370 30 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33 0. void sqlite3
26380 45 78 70 72 53 65 74 48 65 69 67 68 74 28 50 61 ExprSetHeight(Pa
26390 72 73 65 20 2a 70 50 61 72 73 65 2c 20 45 78 70 rse *pParse, Exp
263a0 72 20 2a 70 29 3b 0a 20 20 69 6e 74 20 73 71 6c r *p);. int sql
263b0 69 74 65 33 53 65 6c 65 63 74 45 78 70 72 48 65 ite3SelectExprHe
263c0 69 67 68 74 28 53 65 6c 65 63 74 20 2a 29 3b 0a ight(Select *);.
263d0 20 20 69 6e 74 20 73 71 6c 69 74 65 33 45 78 70 int sqlite3Exp
263e0 72 43 68 65 63 6b 48 65 69 67 68 74 28 50 61 72 rCheckHeight(Par
263f0 73 65 2a 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 se*, int);.#else
26400 0a 20 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 . #define sqlit
26410 65 33 45 78 70 72 53 65 74 48 65 69 67 68 74 28 e3ExprSetHeight(
26420 78 2c 79 29 0a 20 20 23 64 65 66 69 6e 65 20 73 x,y). #define s
26430 71 6c 69 74 65 33 53 65 6c 65 63 74 45 78 70 72 qlite3SelectExpr
26440 48 65 69 67 68 74 28 78 29 20 30 0a 20 20 23 64 Height(x) 0. #d
26450 65 66 69 6e 65 20 73 71 6c 69 74 65 33 45 78 70 efine sqlite3Exp
26460 72 43 68 65 63 6b 48 65 69 67 68 74 28 78 2c 79 rCheckHeight(x,y
26470 29 0a 23 65 6e 64 69 66 0a 0a 75 33 32 20 73 71 ).#endif..u32 sq
26480 6c 69 74 65 33 47 65 74 34 62 79 74 65 28 63 6f lite3Get4byte(co
26490 6e 73 74 20 75 38 2a 29 3b 0a 76 6f 69 64 20 73 nst u8*);.void s
264a0 71 6c 69 74 65 33 50 75 74 34 62 79 74 65 28 75 qlite3Put4byte(u
264b0 38 2a 2c 20 75 33 32 29 3b 0a 0a 23 69 66 64 65 8*, u32);..#ifde
264c0 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
264d0 55 4e 4c 4f 43 4b 5f 4e 4f 54 49 46 59 0a 20 20 UNLOCK_NOTIFY.
264e0 76 6f 69 64 20 73 71 6c 69 74 65 33 43 6f 6e 6e void sqlite3Conn
264f0 65 63 74 69 6f 6e 42 6c 6f 63 6b 65 64 28 73 71 ectionBlocked(sq
26500 6c 69 74 65 33 20 2a 2c 20 73 71 6c 69 74 65 33 lite3 *, sqlite3
26510 20 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 *);. void sqli
26520 74 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c te3ConnectionUnl
26530 6f 63 6b 65 64 28 73 71 6c 69 74 65 33 20 2a 64 ocked(sqlite3 *d
26540 62 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 b);. void sqlit
26550 65 33 43 6f 6e 6e 65 63 74 69 6f 6e 43 6c 6f 73 e3ConnectionClos
26560 65 64 28 73 71 6c 69 74 65 33 20 2a 64 62 29 3b ed(sqlite3 *db);
26570 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
26580 20 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 sqlite3Connecti
26590 6f 6e 42 6c 6f 63 6b 65 64 28 78 2c 79 29 0a 20 onBlocked(x,y).
265a0 20 23 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 #define sqlite3
265b0 43 6f 6e 6e 65 63 74 69 6f 6e 55 6e 6c 6f 63 6b ConnectionUnlock
265c0 65 64 28 78 29 0a 20 20 23 64 65 66 69 6e 65 20 ed(x). #define
265d0 73 71 6c 69 74 65 33 43 6f 6e 6e 65 63 74 69 6f sqlite3Connectio
265e0 6e 43 6c 6f 73 65 64 28 78 29 0a 23 65 6e 64 69 nClosed(x).#endi
265f0 66 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 f..#ifdef SQLITE
26600 5f 44 45 42 55 47 0a 20 20 76 6f 69 64 20 73 71 _DEBUG. void sq
26610 6c 69 74 65 33 50 61 72 73 65 72 54 72 61 63 65 lite3ParserTrace
26620 28 46 49 4c 45 2a 2c 20 63 68 61 72 20 2a 29 3b (FILE*, char *);
26630 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 49 .#endif../*.** I
26640 66 20 74 68 65 20 53 51 4c 49 54 45 5f 45 4e 41 f the SQLITE_ENA
26650 42 4c 45 20 49 4f 54 52 41 43 45 20 65 78 69 73 BLE IOTRACE exis
26660 74 73 20 74 68 65 6e 20 74 68 65 20 67 6c 6f 62 ts then the glob
26670 61 6c 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 73 al variable.** s
26680 71 6c 69 74 65 33 49 6f 54 72 61 63 65 20 69 73 qlite3IoTrace is
26690 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 a pointer to a
266a0 70 72 69 6e 74 66 2d 6c 69 6b 65 20 72 6f 75 74 printf-like rout
266b0 69 6e 65 20 75 73 65 64 20 74 6f 0a 2a 2a 20 70 ine used to.** p
266c0 72 69 6e 74 20 49 2f 4f 20 74 72 61 63 69 6e 67 rint I/O tracing
266d0 20 6d 65 73 73 61 67 65 73 2e 20 0a 2a 2f 0a 23 messages. .*/.#
266e0 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 ifdef SQLITE_ENA
266f0 42 4c 45 5f 49 4f 54 52 41 43 45 0a 23 20 64 65 BLE_IOTRACE.# de
26700 66 69 6e 65 20 49 4f 54 52 41 43 45 28 41 29 20 fine IOTRACE(A)
26710 20 69 66 28 20 73 71 6c 69 74 65 33 49 6f 54 72 if( sqlite3IoTr
26720 61 63 65 20 29 7b 20 73 71 6c 69 74 65 33 49 6f ace ){ sqlite3Io
26730 54 72 61 63 65 20 41 3b 20 7d 0a 20 20 76 6f 69 Trace A; }. voi
26740 64 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 d sqlite3VdbeIOT
26750 72 61 63 65 53 71 6c 28 56 64 62 65 2a 29 3b 0a raceSql(Vdbe*);.
26760 53 51 4c 49 54 45 5f 45 58 54 45 52 4e 20 76 6f SQLITE_EXTERN vo
26770 69 64 20 28 2a 73 71 6c 69 74 65 33 49 6f 54 72 id (*sqlite3IoTr
26780 61 63 65 29 28 63 6f 6e 73 74 20 63 68 61 72 2a ace)(const char*
26790 2c 2e 2e 2e 29 3b 0a 23 65 6c 73 65 0a 23 20 64 ,...);.#else.# d
267a0 65 66 69 6e 65 20 49 4f 54 52 41 43 45 28 41 29 efine IOTRACE(A)
267b0 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 65 .# define sqlite
267c0 33 56 64 62 65 49 4f 54 72 61 63 65 53 71 6c 28 3VdbeIOTraceSql(
267d0 58 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a X).#endif../*.**
267e0 20 54 68 65 73 65 20 72 6f 75 74 69 6e 65 73 20 These routines
267f0 61 72 65 20 61 76 61 69 6c 61 62 6c 65 20 66 6f are available fo
26800 72 20 74 68 65 20 6d 65 6d 32 2e 63 20 64 65 62 r the mem2.c deb
26810 75 67 67 69 6e 67 20 6d 65 6d 6f 72 79 20 61 6c ugging memory al
26820 6c 6f 63 61 74 6f 72 0a 2a 2a 20 6f 6e 6c 79 2e locator.** only.
26830 20 20 54 68 65 79 20 61 72 65 20 75 73 65 64 20 They are used
26840 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 64 to verify that d
26850 69 66 66 65 72 65 6e 74 20 22 74 79 70 65 73 22 ifferent "types"
26860 20 6f 66 20 6d 65 6d 6f 72 79 0a 2a 2a 20 61 6c of memory.** al
26870 6c 6f 63 61 74 69 6f 6e 73 20 61 72 65 20 70 72 locations are pr
26880 6f 70 65 72 6c 79 20 74 72 61 63 6b 65 64 20 62 operly tracked b
26890 79 20 74 68 65 20 73 79 73 74 65 6d 2e 0a 2a 2a y the system..**
268a0 0a 2a 2a 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 .** sqlite3Memde
268b0 62 75 67 53 65 74 54 79 70 65 28 29 20 73 65 74 bugSetType() set
268c0 73 20 74 68 65 20 22 74 79 70 65 22 20 6f 66 20 s the "type" of
268d0 61 6e 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 74 6f an allocation to
268e0 20 6f 6e 65 20 6f 66 0a 2a 2a 20 74 68 65 20 4d one of.** the M
268f0 45 4d 54 59 50 45 5f 2a 20 6d 61 63 72 6f 73 20 EMTYPE_* macros
26900 64 65 66 69 6e 65 64 20 62 65 6c 6f 77 2e 20 20 defined below.
26910 54 68 65 20 74 79 70 65 20 6d 75 73 74 20 62 65 The type must be
26920 20 61 20 62 69 74 6d 61 73 6b 20 77 69 74 68 0a a bitmask with.
26930 2a 2a 20 61 20 73 69 6e 67 6c 65 20 62 69 74 20 ** a single bit
26940 73 65 74 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 set..**.** sqlit
26950 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 79 70 e3MemdebugHasTyp
26960 65 28 29 20 72 65 74 75 72 6e 73 20 74 72 75 65 e() returns true
26970 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 62 if any of the b
26980 69 74 73 20 69 6e 20 69 74 73 20 73 65 63 6f 6e its in its secon
26990 64 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 6d 61 d.** argument ma
269a0 74 63 68 20 74 68 65 20 74 79 70 65 20 73 65 74 tch the type set
269b0 20 62 79 20 74 68 65 20 70 72 65 76 69 6f 75 73 by the previous
269c0 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 sqlite3Memdebug
269d0 53 65 74 54 79 70 65 28 29 2e 0a 2a 2a 20 73 71 SetType()..** sq
269e0 6c 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 lite3MemdebugHas
269f0 54 79 70 65 28 29 20 69 73 20 69 6e 74 65 6e 64 Type() is intend
26a00 65 64 20 66 6f 72 20 75 73 65 20 69 6e 73 69 64 ed for use insid
26a10 65 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 e assert() state
26a20 6d 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 73 71 6c ments..**.** sql
26a30 69 74 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 ite3MemdebugNoTy
26a40 70 65 28 29 20 72 65 74 75 72 6e 73 20 74 72 75 pe() returns tru
26a50 65 20 69 66 20 6e 6f 6e 65 20 6f 66 20 74 68 65 e if none of the
26a60 20 62 69 74 73 20 69 6e 20 69 74 73 20 73 65 63 bits in its sec
26a70 6f 6e 64 0a 2a 2a 20 61 72 67 75 6d 65 6e 74 20 ond.** argument
26a80 6d 61 74 63 68 20 74 68 65 20 74 79 70 65 20 73 match the type s
26a90 65 74 20 62 79 20 74 68 65 20 70 72 65 76 69 6f et by the previo
26aa0 75 73 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 us sqlite3Memdeb
26ab0 75 67 53 65 74 54 79 70 65 28 29 2e 0a 2a 2a 0a ugSetType()..**.
26ac0 2a 2a 20 50 65 72 68 61 70 73 20 74 68 65 20 6d ** Perhaps the m
26ad0 6f 73 74 20 69 6d 70 6f 72 74 61 6e 74 20 70 6f ost important po
26ae0 69 6e 74 20 69 73 20 74 68 65 20 64 69 66 66 65 int is the diffe
26af0 72 65 6e 63 65 20 62 65 74 77 65 65 6e 20 4d 45 rence between ME
26b00 4d 54 59 50 45 5f 48 45 41 50 0a 2a 2a 20 61 6e MTYPE_HEAP.** an
26b10 64 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 53 d MEMTYPE_LOOKAS
26b20 49 44 45 2e 20 20 49 66 20 61 6e 20 61 6c 6c 6f IDE. If an allo
26b30 63 61 74 69 6f 6e 20 69 73 20 4d 45 4d 54 59 50 cation is MEMTYP
26b40 45 5f 4c 4f 4f 4b 41 53 49 44 45 2c 20 74 68 61 E_LOOKASIDE, tha
26b50 74 20 6d 65 61 6e 73 0a 2a 2a 20 69 74 20 6d 69 t means.** it mi
26b60 67 68 74 20 68 61 76 65 20 62 65 65 6e 20 61 6c ght have been al
26b70 6c 6f 63 61 74 65 64 20 62 79 20 6c 6f 6f 6b 61 located by looka
26b80 73 69 64 65 2c 20 65 78 63 65 70 74 20 74 68 65 side, except the
26b90 20 61 6c 6c 6f 63 61 74 69 6f 6e 20 77 61 73 0a allocation was.
26ba0 2a 2a 20 74 6f 6f 20 6c 61 72 67 65 20 6f 72 20 ** too large or
26bb0 6c 6f 6f 6b 61 73 69 64 65 20 77 61 73 20 61 6c lookaside was al
26bc0 72 65 61 64 79 20 66 75 6c 6c 2e 20 20 49 74 20 ready full. It
26bd0 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 74 6f 20 is important to
26be0 76 65 72 69 66 79 0a 2a 2a 20 74 68 61 74 20 61 verify.** that a
26bf0 6c 6c 6f 63 61 74 69 6f 6e 73 20 74 68 61 74 20 llocations that
26c00 6d 69 67 68 74 20 68 61 76 65 20 62 65 65 6e 20 might have been
26c10 73 61 74 69 73 66 69 65 64 20 62 79 20 6c 6f 6f satisfied by loo
26c20 6b 61 73 69 64 65 20 61 72 65 20 6e 6f 74 0a 2a kaside are not.*
26c30 2a 20 70 61 73 73 65 64 20 62 61 63 6b 20 74 6f * passed back to
26c40 20 6e 6f 6e 2d 6c 6f 6f 6b 61 73 69 64 65 20 66 non-lookaside f
26c50 72 65 65 28 29 20 72 6f 75 74 69 6e 65 73 2e 20 ree() routines.
26c60 20 41 73 73 65 72 74 73 20 73 75 63 68 20 61 73 Asserts such as
26c70 20 74 68 65 0a 2a 2a 20 65 78 61 6d 70 6c 65 20 the.** example
26c80 61 62 6f 76 65 20 61 72 65 20 70 6c 61 63 65 64 above are placed
26c90 20 6f 6e 20 74 68 65 20 6e 6f 6e 2d 6c 6f 6f 6b on the non-look
26ca0 61 73 69 64 65 20 66 72 65 65 28 29 20 72 6f 75 aside free() rou
26cb0 74 69 6e 65 73 20 74 6f 20 76 65 72 69 66 79 0a tines to verify.
26cc0 2a 2a 20 74 68 69 73 20 63 6f 6e 73 74 72 61 69 ** this constrai
26cd0 6e 74 2e 20 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 6f nt. .**.** All o
26ce0 66 20 74 68 69 73 20 69 73 20 6e 6f 2d 6f 70 20 f this is no-op
26cf0 66 6f 72 20 61 20 70 72 6f 64 75 63 74 69 6f 6e for a production
26d00 20 62 75 69 6c 64 2e 20 20 49 74 20 6f 6e 6c 79 build. It only
26d10 20 63 6f 6d 65 73 20 69 6e 74 6f 0a 2a 2a 20 70 comes into.** p
26d20 6c 61 79 20 77 68 65 6e 20 74 68 65 20 53 51 4c lay when the SQL
26d30 49 54 45 5f 4d 45 4d 44 45 42 55 47 20 63 6f 6d ITE_MEMDEBUG com
26d40 70 69 6c 65 2d 74 69 6d 65 20 6f 70 74 69 6f 6e pile-time option
26d50 20 69 73 20 75 73 65 64 2e 0a 2a 2f 0a 23 69 66 is used..*/.#if
26d60 64 65 66 20 53 51 4c 49 54 45 5f 4d 45 4d 44 45 def SQLITE_MEMDE
26d70 42 55 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 BUG. void sqlit
26d80 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 e3MemdebugSetTyp
26d90 65 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 20 20 69 e(void*,u8);. i
26da0 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 64 65 62 nt sqlite3Memdeb
26db0 75 67 48 61 73 54 79 70 65 28 76 6f 69 64 2a 2c ugHasType(void*,
26dc0 75 38 29 3b 0a 20 20 69 6e 74 20 73 71 6c 69 74 u8);. int sqlit
26dd0 65 33 4d 65 6d 64 65 62 75 67 4e 6f 54 79 70 65 e3MemdebugNoType
26de0 28 76 6f 69 64 2a 2c 75 38 29 3b 0a 23 65 6c 73 (void*,u8);.#els
26df0 65 0a 23 20 64 65 66 69 6e 65 20 73 71 6c 69 74 e.# define sqlit
26e00 65 33 4d 65 6d 64 65 62 75 67 53 65 74 54 79 70 e3MemdebugSetTyp
26e10 65 28 58 2c 59 29 20 20 2f 2a 20 6e 6f 2d 6f 70 e(X,Y) /* no-op
26e20 20 2a 2f 0a 23 20 64 65 66 69 6e 65 20 73 71 6c */.# define sql
26e30 69 74 65 33 4d 65 6d 64 65 62 75 67 48 61 73 54 ite3MemdebugHasT
26e40 79 70 65 28 58 2c 59 29 20 20 31 0a 23 20 64 65 ype(X,Y) 1.# de
26e50 66 69 6e 65 20 73 71 6c 69 74 65 33 4d 65 6d 64 fine sqlite3Memd
26e60 65 62 75 67 4e 6f 54 79 70 65 28 58 2c 59 29 20 ebugNoType(X,Y)
26e70 20 20 31 0a 23 65 6e 64 69 66 0a 23 64 65 66 69 1.#endif.#defi
26e80 6e 65 20 4d 45 4d 54 59 50 45 5f 48 45 41 50 20 ne MEMTYPE_HEAP
26e90 20 20 20 20 20 20 30 78 30 31 20 20 2f 2a 20 47 0x01 /* G
26ea0 65 6e 65 72 61 6c 20 68 65 61 70 20 61 6c 6c 6f eneral heap allo
26eb0 63 61 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 69 cations */.#defi
26ec0 6e 65 20 4d 45 4d 54 59 50 45 5f 4c 4f 4f 4b 41 ne MEMTYPE_LOOKA
26ed0 53 49 44 45 20 20 30 78 30 32 20 20 2f 2a 20 4d SIDE 0x02 /* M
26ee0 69 67 68 74 20 68 61 76 65 20 62 65 65 6e 20 6c ight have been l
26ef0 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 ookaside memory
26f00 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 54 59 */.#define MEMTY
26f10 50 45 5f 53 43 52 41 54 43 48 20 20 20 20 30 78 PE_SCRATCH 0x
26f20 30 34 20 20 2f 2a 20 53 63 72 61 74 63 68 20 61 04 /* Scratch a
26f30 6c 6c 6f 63 61 74 69 6f 6e 73 20 2a 2f 0a 23 64 llocations */.#d
26f40 65 66 69 6e 65 20 4d 45 4d 54 59 50 45 5f 50 43 efine MEMTYPE_PC
26f50 41 43 48 45 20 20 20 20 20 30 78 30 38 20 20 2f ACHE 0x08 /
26f60 2a 20 50 61 67 65 20 63 61 63 68 65 20 61 6c 6c * Page cache all
26f70 6f 63 61 74 69 6f 6e 73 20 2a 2f 0a 23 64 65 66 ocations */.#def
26f80 69 6e 65 20 4d 45 4d 54 59 50 45 5f 44 42 20 20 ine MEMTYPE_DB
26f90 20 20 20 20 20 20 20 30 78 31 30 20 20 2f 2a 20 0x10 /*
26fa0 55 73 65 73 20 73 71 6c 69 74 65 33 44 62 4d 61 Uses sqlite3DbMa
26fb0 6c 6c 6f 63 2c 20 6e 6f 74 20 73 71 6c 69 74 65 lloc, not sqlite
26fc0 5f 6d 61 6c 6c 6f 63 20 2a 2f 0a 0a 23 65 6e 64 _malloc */..#end
26fd0 69 66 20 2f 2a 20 5f 53 51 4c 49 54 45 49 4e 54 if /* _SQLITEINT
26fe0 5f 48 5f 20 2a 2f 0a _H_ */.