0000: 2f 2a 0a 2a 2a 20 32 30 30 33 20 53 65 70 74 65 /*.** 2003 Septe
0010: 6d 62 65 72 20 36 0a 2a 2a 0a 2a 2a 20 54 68 65 mber 6.**.** The
0020: 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 6d author disclaim
0030: 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 74 s copyright to t
0040: 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 2e his source code.
0050: 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a 2a In place of.**
0060: 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 2c a legal notice,
0070: 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 73 here is a bless
0080: 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 ing:.**.** Ma
0090: 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 6e y you do good an
00a0: 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 d not evil..**
00b0: 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 66 May you find f
00c0: 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 79 orgiveness for y
00d0: 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 67 ourself and forg
00e0: 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 ive others..**
00f0: 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 20 May you share
0100: 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 61 freely, never ta
0110: 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 79 king more than y
0120: 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a ou 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 0a 2a 2a 20 54 68 69 73 20 69 73 *****.** This is
0180: 20 74 68 65 20 68 65 61 64 65 72 20 66 69 6c 65 the header file
0190: 20 66 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e for information
01a0: 20 74 68 61 74 20 69 73 20 70 72 69 76 61 74 65 that is private
01b0: 20 74 6f 20 74 68 65 0a 2a 2a 20 56 44 42 45 2e to the.** VDBE.
01c0: 20 20 54 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 This informati
01d0: 6f 6e 20 75 73 65 64 20 74 6f 20 61 6c 6c 20 62 on used to all b
01e0: 65 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 e at the top of
01f0: 74 68 65 20 73 69 6e 67 6c 65 0a 2a 2a 20 73 6f the single.** so
0200: 75 72 63 65 20 63 6f 64 65 20 66 69 6c 65 20 22 urce code file "
0210: 76 64 62 65 2e 63 22 2e 20 20 57 68 65 6e 20 74 vdbe.c". When t
0220: 68 61 74 20 66 69 6c 65 20 62 65 63 61 6d 65 20 hat file became
0230: 74 6f 6f 20 62 69 67 20 28 6f 76 65 72 0a 2a 2a too big (over.**
0240: 20 36 30 30 30 20 6c 69 6e 65 73 20 6c 6f 6e 67 6000 lines long
0250: 29 20 69 74 20 77 61 73 20 73 70 6c 69 74 20 75 ) it was split u
0260: 70 20 69 6e 74 6f 20 73 65 76 65 72 61 6c 20 73 p into several s
0270: 6d 61 6c 6c 65 72 20 66 69 6c 65 73 20 61 6e 64 maller files and
0280: 0a 2a 2a 20 74 68 69 73 20 68 65 61 64 65 72 20 .** this header
0290: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 77 61 73 20 information was
02a0: 66 61 63 74 6f 72 65 64 20 6f 75 74 2e 0a 2a 2f factored out..*/
02b0: 0a 23 69 66 6e 64 65 66 20 5f 56 44 42 45 49 4e .#ifndef _VDBEIN
02c0: 54 5f 48 5f 0a 23 64 65 66 69 6e 65 20 5f 56 44 T_H_.#define _VD
02d0: 42 45 49 4e 54 5f 48 5f 0a 0a 2f 2a 0a 2a 2a 20 BEINT_H_../*.**
02e0: 69 6e 74 54 6f 4b 65 79 28 29 20 61 6e 64 20 6b intToKey() and k
02f0: 65 79 54 6f 49 6e 74 28 29 20 75 73 65 64 20 74 eyToInt() used t
0300: 6f 20 74 72 61 6e 73 66 6f 72 6d 20 74 68 65 20 o transform the
0310: 72 6f 77 69 64 2e 20 20 42 75 74 20 77 69 74 68 rowid. But with
0320: 0a 2a 2a 20 74 68 65 20 6c 61 74 65 73 74 20 76 .** the latest v
0330: 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 64 ersions of the d
0340: 65 73 69 67 6e 20 74 68 65 79 20 61 72 65 20 6e esign they are n
0350: 6f 2d 6f 70 73 2e 0a 2a 2f 0a 23 64 65 66 69 6e o-ops..*/.#defin
0360: 65 20 6b 65 79 54 6f 49 6e 74 28 58 29 20 20 20 e keyToInt(X)
0370: 28 58 29 0a 23 64 65 66 69 6e 65 20 69 6e 74 54 (X).#define intT
0380: 6f 4b 65 79 28 58 29 20 20 20 28 58 29 0a 0a 0a oKey(X) (X)...
0390: 2f 2a 0a 2a 2a 20 53 51 4c 20 69 73 20 74 72 61 /*.** SQL is tra
03a0: 6e 73 6c 61 74 65 64 20 69 6e 74 6f 20 61 20 73 nslated into a s
03b0: 65 71 75 65 6e 63 65 20 6f 66 20 69 6e 73 74 72 equence of instr
03c0: 75 63 74 69 6f 6e 73 20 74 6f 20 62 65 0a 2a 2a uctions to be.**
03d0: 20 65 78 65 63 75 74 65 64 20 62 79 20 61 20 76 executed by a v
03e0: 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 irtual machine.
03f0: 20 45 61 63 68 20 69 6e 73 74 72 75 63 74 69 6f Each instructio
0400: 6e 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 n is an instance
0410: 0a 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f .** of the follo
0420: 77 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a wing structure..
0430: 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 */.typedef struc
0440: 74 20 56 64 62 65 4f 70 20 4f 70 3b 0a 0a 2f 2a t VdbeOp Op;../*
0450: 0a 2a 2a 20 42 6f 6f 6c 65 61 6e 20 76 61 6c 75 .** Boolean valu
0460: 65 73 0a 2a 2f 0a 74 79 70 65 64 65 66 20 75 6e es.*/.typedef un
0470: 73 69 67 6e 65 64 20 63 68 61 72 20 42 6f 6f 6c signed char Bool
0480: 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 75 72 73 6f ;../*.** A curso
0490: 72 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 69 r is a pointer i
04a0: 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20 42 54 72 nto a single BTr
04b0: 65 65 20 77 69 74 68 69 6e 20 61 20 64 61 74 61 ee within a data
04c0: 62 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 54 68 base file..** Th
04d0: 65 20 63 75 72 73 6f 72 20 63 61 6e 20 73 65 65 e cursor can see
04e0: 6b 20 74 6f 20 61 20 42 54 72 65 65 20 65 6e 74 k to a BTree ent
04f0: 72 79 20 77 69 74 68 20 61 20 70 61 72 74 69 63 ry with a partic
0500: 75 6c 61 72 20 6b 65 79 2c 20 6f 72 0a 2a 2a 20 ular key, or.**
0510: 6c 6f 6f 70 20 6f 76 65 72 20 61 6c 6c 20 65 6e loop over all en
0520: 74 72 69 65 73 20 6f 66 20 74 68 65 20 42 74 72 tries of the Btr
0530: 65 65 2e 20 20 59 6f 75 20 63 61 6e 20 61 6c 73 ee. You can als
0540: 6f 20 69 6e 73 65 72 74 20 6e 65 77 20 42 54 72 o insert new BTr
0550: 65 65 0a 2a 2a 20 65 6e 74 72 69 65 73 20 6f 72 ee.** entries or
0560: 20 72 65 74 72 69 65 76 65 20 74 68 65 20 6b 65 retrieve the ke
0570: 79 20 6f 72 20 64 61 74 61 20 66 72 6f 6d 20 74 y or data from t
0580: 68 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 he entry that th
0590: 65 20 63 75 72 73 6f 72 0a 2a 2a 20 69 73 20 63 e cursor.** is c
05a0: 75 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e urrently pointin
05b0: 67 20 74 6f 2e 0a 2a 2a 20 0a 2a 2a 20 45 76 65 g to..** .** Eve
05c0: 72 79 20 63 75 72 73 6f 72 20 74 68 61 74 20 74 ry cursor that t
05d0: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 he virtual machi
05e0: 6e 65 20 68 61 73 20 6f 70 65 6e 20 69 73 20 72 ne has open is r
05f0: 65 70 72 65 73 65 6e 74 65 64 20 62 79 20 61 6e epresented by an
0600: 0a 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 .** instance of
0610: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 the following st
0620: 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 ructure..**.** I
0630: 66 20 74 68 65 20 43 75 72 73 6f 72 2e 69 73 54 f the Cursor.isT
0640: 72 69 67 67 65 72 52 6f 77 20 66 6c 61 67 20 69 riggerRow flag i
0650: 73 20 73 65 74 20 69 74 20 6d 65 61 6e 73 20 74 s set it means t
0660: 68 61 74 20 74 68 69 73 20 63 75 72 73 6f 72 20 hat this cursor
0670: 69 73 0a 2a 2a 20 72 65 61 6c 6c 79 20 61 20 73 is.** really a s
0680: 69 6e 67 6c 65 20 72 6f 77 20 74 68 61 74 20 72 ingle row that r
0690: 65 70 72 65 73 65 6e 74 73 20 74 68 65 20 4e 45 epresents the NE
06a0: 57 20 6f 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d W or OLD pseudo-
06b0: 74 61 62 6c 65 20 6f 66 0a 2a 2a 20 61 20 72 6f table of.** a ro
06c0: 77 20 74 72 69 67 67 65 72 2e 20 20 54 68 65 20 w trigger. The
06d0: 64 61 74 61 20 66 6f 72 20 74 68 65 20 72 6f 77 data for the row
06e0: 20 69 73 20 73 74 6f 72 65 64 20 69 6e 20 43 75 is stored in Cu
06f0: 72 73 6f 72 2e 70 44 61 74 61 20 61 6e 64 0a 2a rsor.pData and.*
0700: 2a 20 74 68 65 20 72 6f 77 69 64 20 69 73 20 69 * the rowid is i
0710: 6e 20 43 75 72 73 6f 72 2e 69 4b 65 79 2e 0a 2a n Cursor.iKey..*
0720: 2f 0a 73 74 72 75 63 74 20 43 75 72 73 6f 72 20 /.struct Cursor
0730: 7b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 {. BtCursor *pC
0740: 75 72 73 6f 72 3b 20 20 20 20 2f 2a 20 54 68 65 ursor; /* The
0750: 20 63 75 72 73 6f 72 20 73 74 72 75 63 74 75 72 cursor structur
0760: 65 20 6f 66 20 74 68 65 20 62 61 63 6b 65 6e 64 e of the backend
0770: 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 */. int iDb;
0780: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 /* I
0790: 6e 64 65 78 20 6f 66 20 63 75 72 73 6f 72 20 64 ndex of cursor d
07a0: 61 74 61 62 61 73 65 20 69 6e 20 64 62 2d 3e 61 atabase in db->a
07b0: 44 62 5b 5d 20 28 6f 72 20 2d 31 29 20 2a 2f 0a Db[] (or -1) */.
07c0: 20 20 69 36 34 20 6c 61 73 74 52 6f 77 69 64 3b i64 lastRowid;
07d0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 /* Last
07e0: 72 6f 77 69 64 20 66 72 6f 6d 20 61 20 4e 65 78 rowid from a Nex
07f0: 74 20 6f 72 20 4e 65 78 74 49 64 78 20 6f 70 65 t or NextIdx ope
0800: 72 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 36 34 20 ration */. i64
0810: 6e 65 78 74 52 6f 77 69 64 3b 20 20 20 20 20 20 nextRowid;
0820: 20 20 2f 2a 20 4e 65 78 74 20 72 6f 77 69 64 20 /* Next rowid
0830: 72 65 74 75 72 6e 65 64 20 62 79 20 4f 50 5f 4e returned by OP_N
0840: 65 77 52 6f 77 69 64 20 2a 2f 0a 20 20 42 6f 6f ewRowid */. Boo
0850: 6c 20 7a 65 72 6f 65 64 3b 20 20 20 20 20 20 20 l zeroed;
0860: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 7a 65 /* True if ze
0870: 72 6f 65 64 20 6f 75 74 20 61 6e 64 20 72 65 61 roed out and rea
0880: 64 79 20 66 6f 72 20 72 65 75 73 65 20 2a 2f 0a dy for reuse */.
0890: 20 20 42 6f 6f 6c 20 72 6f 77 69 64 49 73 56 61 Bool rowidIsVa
08a0: 6c 69 64 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 lid; /* True
08b0: 69 66 20 6c 61 73 74 52 6f 77 69 64 20 69 73 20 if lastRowid is
08c0: 76 61 6c 69 64 20 2a 2f 0a 20 20 42 6f 6f 6c 20 valid */. Bool
08d0: 61 74 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 atFirst;
08e0: 20 2f 2a 20 54 72 75 65 20 69 66 20 70 6f 69 6e /* True if poin
08f0: 74 69 6e 67 20 74 6f 20 66 69 72 73 74 20 65 6e ting to first en
0900: 74 72 79 20 2a 2f 0a 20 20 42 6f 6f 6c 20 75 73 try */. Bool us
0910: 65 52 61 6e 64 6f 6d 52 6f 77 69 64 3b 20 20 2f eRandomRowid; /
0920: 2a 20 47 65 6e 65 72 61 74 65 20 6e 65 77 20 72 * Generate new r
0930: 65 63 6f 72 64 20 6e 75 6d 62 65 72 73 20 73 65 ecord numbers se
0940: 6d 69 2d 72 61 6e 64 6f 6d 6c 79 20 2a 2f 0a 20 mi-randomly */.
0950: 20 42 6f 6f 6c 20 6e 75 6c 6c 52 6f 77 3b 20 20 Bool nullRow;
0960: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 /* True i
0970: 66 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 f pointing to a
0980: 72 6f 77 20 77 69 74 68 20 6e 6f 20 64 61 74 61 row with no data
0990: 20 2a 2f 0a 20 20 42 6f 6f 6c 20 6e 65 78 74 52 */. Bool nextR
09a0: 6f 77 69 64 56 61 6c 69 64 3b 20 20 2f 2a 20 54 owidValid; /* T
09b0: 72 75 65 20 69 66 20 74 68 65 20 6e 65 78 74 52 rue if the nextR
09c0: 6f 77 69 64 20 66 69 65 6c 64 20 69 73 20 76 61 owid field is va
09d0: 6c 69 64 20 2a 2f 0a 20 20 42 6f 6f 6c 20 70 73 lid */. Bool ps
09e0: 65 75 64 6f 54 61 62 6c 65 3b 20 20 20 20 20 2f eudoTable; /
09f0: 2a 20 54 68 69 73 20 69 73 20 61 20 4e 45 57 20 * This is a NEW
0a00: 6f 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d 74 61 or OLD pseudo-ta
0a10: 62 6c 65 73 20 6f 66 20 61 20 74 72 69 67 67 65 bles of a trigge
0a20: 72 20 2a 2f 0a 20 20 42 6f 6f 6c 20 64 65 66 65 r */. Bool defe
0a30: 72 72 65 64 4d 6f 76 65 74 6f 3b 20 20 2f 2a 20 rredMoveto; /*
0a40: 41 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 A call to sqlite
0a50: 33 42 74 72 65 65 4d 6f 76 65 74 6f 28 29 20 69 3BtreeMoveto() i
0a60: 73 20 6e 65 65 64 65 64 20 2a 2f 0a 20 20 42 6f s needed */. Bo
0a70: 6f 6c 20 69 73 54 61 62 6c 65 3b 20 20 20 20 20 ol isTable;
0a80: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 /* True if a
0a90: 20 74 61 62 6c 65 20 72 65 71 75 69 72 69 6e 67 table requiring
0aa0: 20 69 6e 74 65 67 65 72 20 6b 65 79 73 20 2a 2f integer keys */
0ab0: 0a 20 20 42 6f 6f 6c 20 69 73 49 6e 64 65 78 3b . Bool isIndex;
0ac0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
0ad0: 20 69 66 20 61 6e 20 69 6e 64 65 78 20 63 6f 6e if an index con
0ae0: 74 61 69 6e 69 6e 67 20 6b 65 79 73 20 6f 6e 6c taining keys onl
0af0: 79 20 2d 20 6e 6f 20 64 61 74 61 20 2a 2f 0a 20 y - no data */.
0b00: 20 75 38 20 62 6f 67 75 73 49 6e 63 72 4b 65 79 u8 bogusIncrKey
0b10: 3b 20 20 20 20 20 20 2f 2a 20 53 6f 6d 65 74 68 ; /* Someth
0b20: 69 6e 67 20 66 6f 72 20 70 49 6e 63 72 4b 65 79 ing for pIncrKey
0b30: 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 69 66 20 to point to if
0b40: 70 4b 65 79 49 6e 66 6f 3d 3d 30 20 2a 2f 0a 20 pKeyInfo==0 */.
0b50: 20 69 36 34 20 6d 6f 76 65 74 6f 54 61 72 67 65 i64 movetoTarge
0b60: 74 3b 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 t; /* Argume
0b70: 6e 74 20 74 6f 20 74 68 65 20 64 65 66 65 72 72 nt to the deferr
0b80: 65 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d ed sqlite3BtreeM
0b90: 6f 76 65 74 6f 28 29 20 2a 2f 0a 20 20 42 74 72 oveto() */. Btr
0ba0: 65 65 20 2a 70 42 74 3b 20 20 20 20 20 20 20 20 ee *pBt;
0bb0: 20 20 20 2f 2a 20 53 65 70 61 72 61 74 65 20 66 /* Separate f
0bc0: 69 6c 65 20 68 6f 6c 64 69 6e 67 20 74 65 6d 70 ile holding temp
0bd0: 6f 72 61 72 79 20 74 61 62 6c 65 20 2a 2f 0a 20 orary table */.
0be0: 20 69 6e 74 20 6e 44 61 74 61 3b 20 20 20 20 20 int nData;
0bf0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 /* Number
0c00: 20 6f 66 20 62 79 74 65 73 20 69 6e 20 70 44 61 of bytes in pDa
0c10: 74 61 20 2a 2f 0a 20 20 63 68 61 72 20 2a 70 44 ta */. char *pD
0c20: 61 74 61 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ata; /*
0c30: 20 44 61 74 61 20 66 6f 72 20 61 20 4e 45 57 20 Data for a NEW
0c40: 6f 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d 74 61 or OLD pseudo-ta
0c50: 62 6c 65 20 2a 2f 0a 20 20 69 36 34 20 69 4b 65 ble */. i64 iKe
0c60: 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f y; /
0c70: 2a 20 4b 65 79 20 66 6f 72 20 74 68 65 20 4e 45 * Key for the NE
0c80: 57 20 6f 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d W or OLD pseudo-
0c90: 74 61 62 6c 65 20 72 6f 77 20 2a 2f 0a 20 20 75 table row */. u
0ca0: 38 20 2a 70 49 6e 63 72 4b 65 79 3b 20 20 20 20 8 *pIncrKey;
0cb0: 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 /* Pointer
0cc0: 74 6f 20 70 4b 65 79 49 6e 66 6f 2d 3e 69 6e 63 to pKeyInfo->inc
0cd0: 72 4b 65 79 20 2a 2f 0a 20 20 4b 65 79 49 6e 66 rKey */. KeyInf
0ce0: 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 20 20 o *pKeyInfo;
0cf0: 2f 2a 20 49 6e 66 6f 20 61 62 6f 75 74 20 69 6e /* Info about in
0d00: 64 65 78 20 6b 65 79 73 20 6e 65 65 64 65 64 20 dex keys needed
0d10: 62 79 20 69 6e 64 65 78 20 63 75 72 73 6f 72 73 by index cursors
0d20: 20 2a 2f 0a 20 20 69 6e 74 20 6e 46 69 65 6c 64 */. int nField
0d30: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e ; /* N
0d40: 75 6d 62 65 72 20 6f 66 20 66 69 65 6c 64 73 20 umber of fields
0d50: 69 6e 20 74 68 65 20 68 65 61 64 65 72 20 2a 2f in the header */
0d60: 0a 20 20 69 36 34 20 73 65 71 43 6f 75 6e 74 3b . i64 seqCount;
0d70: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 71 75 /* Sequ
0d80: 65 6e 63 65 20 63 6f 75 6e 74 65 72 20 2a 2f 0a ence counter */.
0d90: 20 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 sqlite3_vtab_c
0da0: 75 72 73 6f 72 20 2a 70 56 74 61 62 43 75 72 73 ursor *pVtabCurs
0db0: 6f 72 3b 20 20 2f 2a 20 54 68 65 20 63 75 72 73 or; /* The curs
0dc0: 6f 72 20 66 6f 72 20 61 20 76 69 72 74 75 61 6c or for a virtual
0dd0: 20 74 61 62 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 table */. cons
0de0: 74 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 t sqlite3_module
0df0: 20 2a 70 4d 6f 64 75 6c 65 3b 20 20 20 20 20 2f *pModule; /
0e00: 2a 20 4d 6f 64 75 6c 65 20 66 6f 72 20 63 75 72 * Module for cur
0e10: 73 6f 72 20 70 56 74 61 62 43 75 72 73 6f 72 20 sor pVtabCursor
0e20: 2a 2f 0a 0a 20 20 2f 2a 20 43 61 63 68 65 64 20 */.. /* Cached
0e30: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 information abou
0e40: 74 20 74 68 65 20 68 65 61 64 65 72 20 66 6f 72 t the header for
0e50: 20 74 68 65 20 64 61 74 61 20 72 65 63 6f 72 64 the data record
0e60: 20 74 68 61 74 20 74 68 65 0a 20 20 2a 2a 20 63 that the. ** c
0e70: 75 72 73 6f 72 20 69 73 20 63 75 72 72 65 6e 74 ursor is current
0e80: 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 ly pointing to.
0e90: 20 4f 6e 6c 79 20 76 61 6c 69 64 20 69 66 20 63 Only valid if c
0ea0: 61 63 68 65 56 61 6c 69 64 20 69 73 20 74 72 75 acheValid is tru
0eb0: 65 2e 0a 20 20 2a 2a 20 61 52 6f 77 20 6d 69 67 e.. ** aRow mig
0ec0: 68 74 20 70 6f 69 6e 74 20 74 6f 20 28 65 70 68 ht point to (eph
0ed0: 65 6d 65 72 61 6c 29 20 64 61 74 61 20 66 6f 72 emeral) data for
0ee0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77 the current row
0ef0: 2c 20 6f 72 20 69 74 20 6d 69 67 68 74 0a 20 20 , or it might.
0f00: 2a 2a 20 62 65 20 4e 55 4c 4c 2e 0a 20 20 2a 2f ** be NULL.. */
0f10: 0a 20 20 69 6e 74 20 63 61 63 68 65 53 74 61 74 . int cacheStat
0f20: 75 73 3b 20 20 20 20 20 20 2f 2a 20 43 61 63 68 us; /* Cach
0f30: 65 20 69 73 20 76 61 6c 69 64 20 69 66 20 74 68 e is valid if th
0f40: 69 73 20 6d 61 74 63 68 65 73 20 56 64 62 65 2e is matches Vdbe.
0f50: 63 61 63 68 65 43 74 72 20 2a 2f 0a 20 20 69 6e cacheCtr */. in
0f60: 74 20 70 61 79 6c 6f 61 64 53 69 7a 65 3b 20 20 t payloadSize;
0f70: 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d /* Total num
0f80: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 ber of bytes in
0f90: 74 68 65 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 the record */.
0fa0: 75 33 32 20 2a 61 54 79 70 65 3b 20 20 20 20 20 u32 *aType;
0fb0: 20 20 20 20 20 20 2f 2a 20 54 79 70 65 20 76 61 /* Type va
0fc0: 6c 75 65 73 20 66 6f 72 20 61 6c 6c 20 65 6e 74 lues for all ent
0fd0: 72 69 65 73 20 69 6e 20 74 68 65 20 72 65 63 6f ries in the reco
0fe0: 72 64 20 2a 2f 0a 20 20 75 33 32 20 2a 61 4f 66 rd */. u32 *aOf
0ff0: 66 73 65 74 3b 20 20 20 20 20 20 20 20 20 2f 2a fset; /*
1000: 20 43 61 63 68 65 64 20 6f 66 66 73 65 74 73 20 Cached offsets
1010: 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 to the start of
1020: 65 61 63 68 20 63 6f 6c 75 6d 6e 73 20 64 61 74 each columns dat
1030: 61 20 2a 2f 0a 20 20 75 38 20 2a 61 52 6f 77 3b a */. u8 *aRow;
1040: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
1050: 44 61 74 61 20 66 6f 72 20 74 68 65 20 63 75 72 Data for the cur
1060: 72 65 6e 74 20 72 6f 77 2c 20 69 66 20 61 6c 6c rent row, if all
1070: 20 6f 6e 20 6f 6e 65 20 70 61 67 65 20 2a 2f 0a on one page */.
1080: 7d 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 };.typedef struc
1090: 74 20 43 75 72 73 6f 72 20 43 75 72 73 6f 72 3b t Cursor Cursor;
10a0: 0a 0a 2f 2a 0a 2a 2a 20 41 20 76 61 6c 75 65 20 ../*.** A value
10b0: 66 6f 72 20 43 75 72 73 6f 72 2e 63 61 63 68 65 for Cursor.cache
10c0: 56 61 6c 69 64 20 74 68 61 74 20 6d 65 61 6e 73 Valid that means
10d0: 20 74 68 65 20 63 61 63 68 65 20 69 73 20 61 6c the cache is al
10e0: 77 61 79 73 20 69 6e 76 61 6c 69 64 2e 0a 2a 2f ways invalid..*/
10f0: 0a 23 64 65 66 69 6e 65 20 43 41 43 48 45 5f 53 .#define CACHE_S
1100: 54 41 4c 45 20 30 0a 0a 2f 2a 0a 2a 2a 20 49 6e TALE 0../*.** In
1110: 74 65 72 6e 61 6c 6c 79 2c 20 74 68 65 20 76 64 ternally, the vd
1120: 62 65 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 6e be manipulates n
1130: 65 61 72 6c 79 20 61 6c 6c 20 53 51 4c 20 76 61 early all SQL va
1140: 6c 75 65 73 20 61 73 20 4d 65 6d 0a 2a 2a 20 73 lues as Mem.** s
1150: 74 72 75 63 74 75 72 65 73 2e 20 45 61 63 68 20 tructures. Each
1160: 4d 65 6d 20 73 74 72 75 63 74 20 6d 61 79 20 63 Mem struct may c
1170: 61 63 68 65 20 6d 75 6c 74 69 70 6c 65 20 72 65 ache multiple re
1180: 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 20 28 73 presentations (s
1190: 74 72 69 6e 67 2c 0a 2a 2a 20 69 6e 74 65 67 65 tring,.** intege
11a0: 72 20 65 74 63 2e 29 20 6f 66 20 74 68 65 20 73 r etc.) of the s
11b0: 61 6d 65 20 76 61 6c 75 65 2e 20 20 41 20 76 61 ame value. A va
11c0: 6c 75 65 20 28 61 6e 64 20 74 68 65 72 65 66 6f lue (and therefo
11d0: 72 65 20 4d 65 6d 20 73 74 72 75 63 74 75 72 65 re Mem structure
11e0: 29 0a 2a 2a 20 68 61 73 20 74 68 65 20 66 6f 6c ).** has the fol
11f0: 6c 6f 77 69 6e 67 20 70 72 6f 70 65 72 74 69 65 lowing propertie
1200: 73 3a 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 76 61 s:.**.** Each va
1210: 6c 75 65 20 68 61 73 20 61 20 6d 61 6e 69 66 65 lue has a manife
1220: 73 74 20 74 79 70 65 2e 20 54 68 65 20 6d 61 6e st type. The man
1230: 69 66 65 73 74 20 74 79 70 65 20 6f 66 20 74 68 ifest type of th
1240: 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 0a 2a e value stored.*
1250: 2a 20 69 6e 20 61 20 4d 65 6d 20 73 74 72 75 63 * in a Mem struc
1260: 74 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 t is returned by
1270: 20 74 68 65 20 4d 65 6d 54 79 70 65 28 4d 65 6d the MemType(Mem
1280: 2a 29 20 6d 61 63 72 6f 2e 20 54 68 65 20 74 79 *) macro. The ty
1290: 70 65 20 69 73 0a 2a 2a 20 6f 6e 65 20 6f 66 20 pe is.** one of
12a0: 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 53 51 4c SQLITE_NULL, SQL
12b0: 49 54 45 5f 49 4e 54 45 47 45 52 2c 20 53 51 4c ITE_INTEGER, SQL
12c0: 49 54 45 5f 52 45 41 4c 2c 20 53 51 4c 49 54 45 ITE_REAL, SQLITE
12d0: 5f 54 45 58 54 20 6f 72 0a 2a 2a 20 53 51 4c 49 _TEXT or.** SQLI
12e0: 54 45 5f 42 4c 4f 42 2e 0a 2a 2f 0a 73 74 72 75 TE_BLOB..*/.stru
12f0: 63 74 20 4d 65 6d 20 7b 0a 20 20 75 6e 69 6f 6e ct Mem {. union
1300: 20 7b 0a 20 20 20 20 69 36 34 20 69 3b 20 20 20 {. i64 i;
1310: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
1320: 74 65 67 65 72 20 76 61 6c 75 65 2e 20 4f 72 20 teger value. Or
1330: 46 75 6e 63 44 65 66 2a 20 77 68 65 6e 20 66 6c FuncDef* when fl
1340: 61 67 73 3d 3d 4d 45 4d 5f 41 67 67 20 2a 2f 0a ags==MEM_Agg */.
1350: 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 44 65 FuncDef *pDe
1360: 66 3b 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 f; /* Used
1370: 6f 6e 6c 79 20 77 68 65 6e 20 66 6c 61 67 73 3d only when flags=
1380: 3d 4d 45 4d 5f 41 67 67 20 2a 2f 0a 20 20 7d 20 =MEM_Agg */. }
1390: 75 3b 0a 20 20 64 6f 75 62 6c 65 20 72 3b 20 20 u;. double r;
13a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 6c /* Real
13b0: 20 76 61 6c 75 65 20 2a 2f 0a 20 20 73 71 6c 69 value */. sqli
13c0: 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 te3 *db;
13d0: 2f 2a 20 54 68 65 20 61 73 73 6f 63 69 61 74 65 /* The associate
13e0: 64 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 d database conne
13f0: 63 74 69 6f 6e 20 2a 2f 0a 20 20 63 68 61 72 20 ction */. char
1400: 2a 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f *z; /
1410: 2a 20 53 74 72 69 6e 67 20 6f 72 20 42 4c 4f 42 * String or BLOB
1420: 20 76 61 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 20 value */. int
1430: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 n;
1440: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 68 61 /* Number of cha
1450: 72 61 63 74 65 72 73 20 69 6e 20 73 74 72 69 6e racters in strin
1460: 67 20 76 61 6c 75 65 2c 20 65 78 63 6c 75 64 69 g value, excludi
1470: 6e 67 20 27 5c 30 27 20 2a 2f 0a 20 20 75 31 36 ng '\0' */. u16
1480: 20 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 flags;
1490: 20 2f 2a 20 53 6f 6d 65 20 63 6f 6d 62 69 6e 61 /* Some combina
14a0: 74 69 6f 6e 20 6f 66 20 4d 45 4d 5f 4e 75 6c 6c tion of MEM_Null
14b0: 2c 20 4d 45 4d 5f 53 74 72 2c 20 4d 45 4d 5f 44 , MEM_Str, MEM_D
14c0: 79 6e 2c 20 65 74 63 2e 20 2a 2f 0a 20 20 75 38 yn, etc. */. u8
14d0: 20 20 74 79 70 65 3b 20 20 20 20 20 20 20 20 20 type;
14e0: 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 53 51 4c 49 /* One of SQLI
14f0: 54 45 5f 4e 55 4c 4c 2c 20 53 51 4c 49 54 45 5f TE_NULL, SQLITE_
1500: 54 45 58 54 2c 20 53 51 4c 49 54 45 5f 49 4e 54 TEXT, SQLITE_INT
1510: 45 47 45 52 2c 20 65 74 63 20 2a 2f 0a 20 20 75 EGER, etc */. u
1520: 38 20 20 65 6e 63 3b 20 20 20 20 20 20 20 20 20 8 enc;
1530: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 55 54 46 /* SQLITE_UTF
1540: 38 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42 8, SQLITE_UTF16B
1550: 45 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c E, SQLITE_UTF16L
1560: 45 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44 E */. void (*xD
1570: 65 6c 29 28 76 6f 69 64 20 2a 29 3b 20 20 2f 2a el)(void *); /*
1580: 20 49 66 20 6e 6f 74 20 6e 75 6c 6c 2c 20 63 61 If not null, ca
1590: 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e ll this function
15a0: 20 74 6f 20 64 65 6c 65 74 65 20 4d 65 6d 2e 7a to delete Mem.z
15b0: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 4f 6e 65 20 6f */.};../* One o
15c0: 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 20 66 6f r more of the fo
15d0: 6c 6c 6f 77 69 6e 67 20 66 6c 61 67 73 20 61 72 llowing flags ar
15e0: 65 20 73 65 74 20 74 6f 20 69 6e 64 69 63 61 74 e set to indicat
15f0: 65 20 74 68 65 20 76 61 6c 69 64 4f 4b 0a 2a 2a e the validOK.**
1600: 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 73 representations
1610: 20 6f 66 20 74 68 65 20 76 61 6c 75 65 20 73 74 of the value st
1620: 6f 72 65 64 20 69 6e 20 74 68 65 20 4d 65 6d 20 ored in the Mem
1630: 73 74 72 75 63 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 struct..**.** If
1640: 20 74 68 65 20 4d 45 4d 5f 4e 75 6c 6c 20 66 6c the MEM_Null fl
1650: 61 67 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 ag is set, then
1660: 74 68 65 20 76 61 6c 75 65 20 69 73 20 61 6e 20 the value is an
1670: 53 51 4c 20 4e 55 4c 4c 20 76 61 6c 75 65 2e 0a SQL NULL value..
1680: 2a 2a 20 4e 6f 20 6f 74 68 65 72 20 66 6c 61 67 ** No other flag
1690: 73 20 6d 61 79 20 62 65 20 73 65 74 20 69 6e 20 s may be set in
16a0: 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a 2a this case..**.**
16b0: 20 49 66 20 74 68 65 20 4d 45 4d 5f 53 74 72 20 If the MEM_Str
16c0: 66 6c 61 67 20 69 73 20 73 65 74 20 74 68 65 6e flag is set then
16d0: 20 4d 65 6d 2e 7a 20 70 6f 69 6e 74 73 20 61 74 Mem.z points at
16e0: 20 61 20 73 74 72 69 6e 67 20 72 65 70 72 65 73 a string repres
16f0: 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2a 20 55 73 75 entation..** Usu
1700: 61 6c 6c 79 20 74 68 69 73 20 69 73 20 65 6e 63 ally this is enc
1710: 6f 64 65 64 20 69 6e 20 74 68 65 20 73 61 6d 65 oded in the same
1720: 20 75 6e 69 63 6f 64 65 20 65 6e 63 6f 64 69 6e unicode encodin
1730: 67 20 61 73 20 74 68 65 20 6d 61 69 6e 0a 2a 2a g as the main.**
1740: 20 64 61 74 61 62 61 73 65 20 28 73 65 65 20 62 database (see b
1750: 65 6c 6f 77 20 66 6f 72 20 65 78 63 65 70 74 69 elow for excepti
1760: 6f 6e 73 29 2e 20 49 66 20 74 68 65 20 4d 45 4d ons). If the MEM
1770: 5f 54 65 72 6d 20 66 6c 61 67 20 69 73 20 61 6c _Term flag is al
1780: 73 6f 0a 2a 2a 20 73 65 74 2c 20 74 68 65 6e 20 so.** set, then
1790: 74 68 65 20 73 74 72 69 6e 67 20 69 73 20 6e 75 the string is nu
17a0: 6c 20 74 65 72 6d 69 6e 61 74 65 64 2e 20 54 68 l terminated. Th
17b0: 65 20 4d 45 4d 5f 49 6e 74 20 61 6e 64 20 4d 45 e MEM_Int and ME
17c0: 4d 5f 52 65 61 6c 20 0a 2a 2a 20 66 6c 61 67 73 M_Real .** flags
17d0: 20 6d 61 79 20 63 6f 65 78 69 73 74 20 77 69 74 may coexist wit
17e0: 68 20 74 68 65 20 4d 45 4d 5f 53 74 72 20 66 6c h the MEM_Str fl
17f0: 61 67 2e 0a 2a 2a 0a 2a 2a 20 4d 75 6c 74 69 70 ag..**.** Multip
1800: 6c 65 20 6f 66 20 74 68 65 73 65 20 76 61 6c 75 le of these valu
1810: 65 73 20 63 61 6e 20 61 70 70 65 61 72 20 69 6e es can appear in
1820: 20 4d 65 6d 2e 66 6c 61 67 73 2e 20 20 42 75 74 Mem.flags. But
1830: 20 6f 6e 6c 79 20 6f 6e 65 0a 2a 2a 20 61 74 20 only one.** at
1840: 61 20 74 69 6d 65 20 63 61 6e 20 61 70 70 65 61 a time can appea
1850: 72 20 69 6e 20 4d 65 6d 2e 74 79 70 65 2e 0a 2a r in Mem.type..*
1860: 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 4e 75 /.#define MEM_Nu
1870: 6c 6c 20 20 20 20 20 20 30 78 30 30 30 31 20 20 ll 0x0001
1880: 20 2f 2a 20 56 61 6c 75 65 20 69 73 20 4e 55 4c /* Value is NUL
1890: 4c 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d L */.#define MEM
18a0: 5f 53 74 72 20 20 20 20 20 20 20 30 78 30 30 30 _Str 0x000
18b0: 32 20 20 20 2f 2a 20 56 61 6c 75 65 20 69 73 20 2 /* Value is
18c0: 61 20 73 74 72 69 6e 67 20 2a 2f 0a 23 64 65 66 a string */.#def
18d0: 69 6e 65 20 4d 45 4d 5f 49 6e 74 20 20 20 20 20 ine MEM_Int
18e0: 20 20 30 78 30 30 30 34 20 20 20 2f 2a 20 56 61 0x0004 /* Va
18f0: 6c 75 65 20 69 73 20 61 6e 20 69 6e 74 65 67 65 lue is an intege
1900: 72 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d r */.#define MEM
1910: 5f 52 65 61 6c 20 20 20 20 20 20 30 78 30 30 30 _Real 0x000
1920: 38 20 20 20 2f 2a 20 56 61 6c 75 65 20 69 73 20 8 /* Value is
1930: 61 20 72 65 61 6c 20 6e 75 6d 62 65 72 20 2a 2f a real number */
1940: 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 42 6c 6f .#define MEM_Blo
1950: 62 20 20 20 20 20 20 30 78 30 30 31 30 20 20 20 b 0x0010
1960: 2f 2a 20 56 61 6c 75 65 20 69 73 20 61 20 42 4c /* Value is a BL
1970: 4f 42 20 2a 2f 0a 0a 23 64 65 66 69 6e 65 20 4d OB */..#define M
1980: 65 6d 53 65 74 54 79 70 65 46 6c 61 67 28 70 2c emSetTypeFlag(p,
1990: 20 66 29 20 5c 0a 20 20 28 28 70 29 2d 3e 66 6c f) \. ((p)->fl
19a0: 61 67 73 20 3d 20 28 28 70 29 2d 3e 66 6c 61 67 ags = ((p)->flag
19b0: 73 26 7e 28 4d 45 4d 5f 49 6e 74 7c 4d 45 4d 5f s&~(MEM_Int|MEM_
19c0: 52 65 61 6c 7c 4d 45 4d 5f 4e 75 6c 6c 7c 4d 45 Real|MEM_Null|ME
19d0: 4d 5f 42 6c 6f 62 7c 4d 45 4d 5f 53 74 72 29 29 M_Blob|MEM_Str))
19e0: 7c 66 29 0a 0a 2f 2a 20 57 68 65 6e 65 76 65 72 |f)../* Whenever
19f0: 20 4d 65 6d 20 63 6f 6e 74 61 69 6e 73 20 61 20 Mem contains a
1a00: 76 61 6c 69 64 20 73 74 72 69 6e 67 20 6f 72 20 valid string or
1a10: 62 6c 6f 62 20 72 65 70 72 65 73 65 6e 74 61 74 blob representat
1a20: 69 6f 6e 2c 20 6f 6e 65 20 6f 66 0a 2a 2a 20 74 ion, one of.** t
1a30: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6c 61 he following fla
1a40: 67 73 20 6d 75 73 74 20 62 65 20 73 65 74 20 74 gs must be set t
1a50: 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 o determine the
1a60: 6d 65 6d 6f 72 79 20 6d 61 6e 61 67 65 6d 65 6e memory managemen
1a70: 74 0a 2a 2a 20 70 6f 6c 69 63 79 20 66 6f 72 20 t.** policy for
1a80: 4d 65 6d 2e 7a 2e 20 20 54 68 65 20 4d 45 4d 5f Mem.z. The MEM_
1a90: 54 65 72 6d 20 66 6c 61 67 20 74 65 6c 6c 73 20 Term flag tells
1aa0: 75 73 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f us whether or no
1ab0: 74 20 74 68 65 0a 2a 2a 20 73 74 72 69 6e 67 20 t the.** string
1ac0: 69 73 20 5c 30 30 30 20 6f 72 20 5c 75 30 30 30 is \000 or \u000
1ad0: 30 20 74 65 72 6d 69 6e 61 74 65 64 0a 2a 2f 0a 0 terminated.*/.
1ae0: 23 64 65 66 69 6e 65 20 4d 45 4d 5f 54 65 72 6d #define MEM_Term
1af0: 20 20 20 20 20 20 30 78 30 30 32 30 20 20 20 2f 0x0020 /
1b00: 2a 20 53 74 72 69 6e 67 20 72 65 70 20 69 73 20 * String rep is
1b10: 6e 75 6c 20 74 65 72 6d 69 6e 61 74 65 64 20 2a nul terminated *
1b20: 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 44 79 /.#define MEM_Dy
1b30: 6e 20 20 20 20 20 20 20 30 78 30 30 34 30 20 20 n 0x0040
1b40: 20 2f 2a 20 4e 65 65 64 20 74 6f 20 63 61 6c 6c /* Need to call
1b50: 20 73 71 6c 69 74 65 46 72 65 65 28 29 20 6f 6e sqliteFree() on
1b60: 20 4d 65 6d 2e 7a 20 2a 2f 0a 23 64 65 66 69 6e Mem.z */.#defin
1b70: 65 20 4d 45 4d 5f 53 74 61 74 69 63 20 20 20 20 e MEM_Static
1b80: 30 78 30 30 38 30 20 20 20 2f 2a 20 4d 65 6d 2e 0x0080 /* Mem.
1b90: 7a 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 z points to a st
1ba0: 61 74 69 63 20 73 74 72 69 6e 67 20 2a 2f 0a 23 atic string */.#
1bb0: 64 65 66 69 6e 65 20 4d 45 4d 5f 45 70 68 65 6d define MEM_Ephem
1bc0: 20 20 20 20 20 30 78 30 31 30 30 20 20 20 2f 2a 0x0100 /*
1bd0: 20 4d 65 6d 2e 7a 20 70 6f 69 6e 74 73 20 74 6f Mem.z points to
1be0: 20 61 6e 20 65 70 68 65 6d 65 72 61 6c 20 73 74 an ephemeral st
1bf0: 72 69 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 ring */.#define
1c00: 4d 45 4d 5f 41 67 67 20 20 20 20 20 20 20 30 78 MEM_Agg 0x
1c10: 30 34 30 30 20 20 20 2f 2a 20 4d 65 6d 2e 7a 20 0400 /* Mem.z
1c20: 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 61 67 67 points to an agg
1c30: 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6e 74 65 78 function contex
1c40: 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d t */.#define MEM
1c50: 5f 5a 65 72 6f 20 20 20 20 20 20 30 78 30 38 30 _Zero 0x080
1c60: 30 20 20 20 2f 2a 20 4d 65 6d 2e 69 20 63 6f 6e 0 /* Mem.i con
1c70: 74 61 69 6e 73 20 63 6f 75 6e 74 20 6f 66 20 30 tains count of 0
1c80: 73 20 61 70 70 65 6e 64 65 64 20 74 6f 20 62 6c s appended to bl
1c90: 6f 62 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53 51 ob */..#ifdef SQ
1ca0: 4c 49 54 45 5f 4f 4d 49 54 5f 49 4e 43 52 42 4c LITE_OMIT_INCRBL
1cb0: 4f 42 0a 20 20 23 75 6e 64 65 66 20 4d 45 4d 5f OB. #undef MEM_
1cc0: 5a 65 72 6f 0a 20 20 23 64 65 66 69 6e 65 20 4d Zero. #define M
1cd0: 45 4d 5f 5a 65 72 6f 20 30 78 30 30 30 30 0a 23 EM_Zero 0x0000.#
1ce0: 65 6e 64 69 66 0a 0a 0a 2f 2a 20 41 20 56 64 62 endif.../* A Vdb
1cf0: 65 46 75 6e 63 20 69 73 20 6a 75 73 74 20 61 20 eFunc is just a
1d00: 46 75 6e 63 44 65 66 20 28 64 65 66 69 6e 65 64 FuncDef (defined
1d10: 20 69 6e 20 73 71 6c 69 74 65 49 6e 74 2e 68 29 in sqliteInt.h)
1d20: 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 0a 2a that contains.*
1d30: 2a 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 * additional inf
1d40: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 ormation about a
1d50: 75 78 69 6c 69 61 72 79 20 69 6e 66 6f 72 6d 61 uxiliary informa
1d60: 74 69 6f 6e 20 62 6f 75 6e 64 20 74 6f 20 61 72 tion bound to ar
1d70: 67 75 6d 65 6e 74 73 0a 2a 2a 20 6f 66 20 74 68 guments.** of th
1d80: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 e function. Thi
1d90: 73 20 69 73 20 75 73 65 64 20 74 6f 20 69 6d 70 s is used to imp
1da0: 6c 65 6d 65 6e 74 20 74 68 65 20 73 71 6c 69 74 lement the sqlit
1db0: 65 33 5f 67 65 74 5f 61 75 78 64 61 74 61 28 29 e3_get_auxdata()
1dc0: 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 65 33 5f .** and sqlite3_
1dd0: 73 65 74 5f 61 75 78 64 61 74 61 28 29 20 41 50 set_auxdata() AP
1de0: 49 73 2e 20 20 54 68 65 20 22 61 75 78 64 61 74 Is. The "auxdat
1df0: 61 22 20 69 73 20 73 6f 6d 65 20 61 75 78 69 6c a" is some auxil
1e00: 69 61 72 79 20 64 61 74 61 0a 2a 2a 20 74 68 61 iary data.** tha
1e10: 74 20 63 61 6e 20 62 65 20 61 73 73 6f 63 69 61 t can be associa
1e20: 74 65 64 20 77 69 74 68 20 61 20 63 6f 6e 73 74 ted with a const
1e30: 61 6e 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 ant argument to
1e40: 61 20 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 a function. Thi
1e50: 73 0a 2a 2a 20 61 6c 6c 6f 77 73 20 66 75 6e 63 s.** allows func
1e60: 74 69 6f 6e 73 20 73 75 63 68 20 61 73 20 22 72 tions such as "r
1e70: 65 67 65 78 70 22 20 74 6f 20 63 6f 6d 70 69 6c egexp" to compil
1e80: 65 20 74 68 65 69 72 20 63 6f 6e 73 74 61 6e 74 e their constant
1e90: 20 72 65 67 75 6c 61 72 0a 2a 2a 20 65 78 70 72 regular.** expr
1ea0: 65 73 73 69 6f 6e 20 61 72 67 75 6d 65 6e 74 20 ession argument
1eb0: 6f 6e 63 65 20 61 6e 64 20 72 65 75 73 65 64 20 once and reused
1ec0: 74 68 65 20 63 6f 6d 70 69 6c 65 64 20 63 6f 64 the compiled cod
1ed0: 65 20 66 6f 72 20 6d 75 6c 74 69 70 6c 65 0a 2a e for multiple.*
1ee0: 2a 20 69 6e 76 6f 63 61 74 69 6f 6e 73 2e 0a 2a * invocations..*
1ef0: 2f 0a 73 74 72 75 63 74 20 56 64 62 65 46 75 6e /.struct VdbeFun
1f00: 63 20 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 c {. FuncDef *p
1f10: 46 75 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 Func;
1f20: 20 20 20 20 2f 2a 20 54 68 65 20 64 65 66 69 6e /* The defin
1f30: 69 74 69 6f 6e 20 6f 66 20 74 68 65 20 66 75 6e ition of the fun
1f40: 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e ction */. int n
1f50: 41 75 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 Aux;
1f60: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1f70: 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 61 6c er of entries al
1f80: 6c 6f 63 61 74 65 64 20 66 6f 72 20 61 70 41 75 located for apAu
1f90: 78 5b 5d 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 x[] */. struct
1fa0: 41 75 78 44 61 74 61 20 7b 0a 20 20 20 20 76 6f AuxData {. vo
1fb0: 69 64 20 2a 70 41 75 78 3b 20 20 20 20 20 20 20 id *pAux;
1fc0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
1fd0: 75 78 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 ux data for the
1fe0: 69 2d 74 68 20 61 72 67 75 6d 65 6e 74 20 2a 2f i-th argument */
1ff0: 0a 20 20 20 20 76 6f 69 64 20 28 2a 78 44 65 6c . void (*xDel
2000: 65 74 65 29 28 76 6f 69 64 20 2a 29 3b 20 20 20 ete)(void *);
2010: 20 20 20 2f 2a 20 44 65 73 74 72 75 63 74 6f 72 /* Destructor
2020: 20 66 6f 72 20 74 68 65 20 61 75 78 20 64 61 74 for the aux dat
2030: 61 20 2a 2f 0a 20 20 7d 20 61 70 41 75 78 5b 31 a */. } apAux[1
2040: 5d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ];
2050: 20 20 20 20 20 2f 2a 20 4f 6e 65 20 73 6c 6f 74 /* One slot
2060: 20 66 6f 72 20 65 61 63 68 20 66 75 6e 63 74 69 for each functi
2070: 6f 6e 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 7d on argument */.}
2080: 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 22 63 6f ;../*.** The "co
2090: 6e 74 65 78 74 22 20 61 72 67 75 6d 65 6e 74 20 ntext" argument
20a0: 66 6f 72 20 61 20 69 6e 73 74 61 6c 6c 61 62 6c for a installabl
20b0: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 41 20 70 e function. A p
20c0: 6f 69 6e 74 65 72 20 74 6f 20 61 6e 0a 2a 2a 20 ointer to an.**
20d0: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 instance of this
20e0: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 74 68 structure is th
20f0: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 e first argument
2100: 20 74 6f 20 74 68 65 20 72 6f 75 74 69 6e 65 73 to the routines
2110: 20 75 73 65 64 0a 2a 2a 20 69 6d 70 6c 65 6d 65 used.** impleme
2120: 6e 74 20 74 68 65 20 53 51 4c 20 66 75 6e 63 74 nt the SQL funct
2130: 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 ions..**.** Ther
2140: 65 20 69 73 20 61 20 74 79 70 65 64 65 66 20 66 e is a typedef f
2150: 6f 72 20 74 68 69 73 20 73 74 72 75 63 74 75 72 or this structur
2160: 65 20 69 6e 20 73 71 6c 69 74 65 2e 68 2e 20 20 e in sqlite.h.
2170: 53 6f 20 61 6c 6c 20 72 6f 75 74 69 6e 65 73 2c So all routines,
2180: 0a 2a 2a 20 65 76 65 6e 20 74 68 65 20 70 75 62 .** even the pub
2190: 6c 69 63 20 69 6e 74 65 72 66 61 63 65 20 74 6f lic interface to
21a0: 20 53 51 4c 69 74 65 2c 20 63 61 6e 20 75 73 65 SQLite, can use
21b0: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 a pointer to th
21c0: 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a is structure..**
21d0: 20 42 75 74 20 74 68 69 73 20 66 69 6c 65 20 69 But this file i
21e0: 73 20 74 68 65 20 6f 6e 6c 79 20 70 6c 61 63 65 s the only place
21f0: 20 77 68 65 72 65 20 74 68 65 20 69 6e 74 65 72 where the inter
2200: 6e 61 6c 20 64 65 74 61 69 6c 73 20 6f 66 20 74 nal details of t
2210: 68 69 73 0a 2a 2a 20 73 74 72 75 63 74 75 72 65 his.** structure
2220: 20 61 72 65 20 6b 6e 6f 77 6e 2e 0a 2a 2a 0a 2a are known..**.*
2230: 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 72 65 * This structure
2240: 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e 73 69 is defined insi
2250: 64 65 20 6f 66 20 76 64 62 65 49 6e 74 2e 68 20 de of vdbeInt.h
2260: 62 65 63 61 75 73 65 20 69 74 20 75 73 65 73 20 because it uses
2270: 73 75 62 73 74 72 75 63 74 75 72 65 73 0a 2a 2a substructures.**
2280: 20 28 4d 65 6d 29 20 77 68 69 63 68 20 61 72 65 (Mem) which are
2290: 20 6f 6e 6c 79 20 64 65 66 69 6e 65 64 20 74 68 only defined th
22a0: 65 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73 ere..*/.struct s
22b0: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 7b qlite3_context {
22c0: 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e . FuncDef *pFun
22d0: 63 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e c; /* Poin
22e0: 74 65 72 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20 ter to function
22f0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 4d 55 information. MU
2300: 53 54 20 42 45 20 46 49 52 53 54 20 2a 2f 0a 20 ST BE FIRST */.
2310: 20 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 VdbeFunc *pVdbe
2320: 46 75 6e 63 3b 20 20 2f 2a 20 41 75 78 69 6c 61 Func; /* Auxila
2330: 72 79 20 64 61 74 61 2c 20 69 66 20 63 72 65 61 ry data, if crea
2340: 74 65 64 2e 20 2a 2f 0a 20 20 4d 65 6d 20 73 3b ted. */. Mem s;
2350: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2360: 2f 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 /* The return va
2370: 6c 75 65 20 69 73 20 73 74 6f 72 65 64 20 68 65 lue is stored he
2380: 72 65 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 4d 65 re */. Mem *pMe
2390: 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a m; /*
23a0: 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 75 73 65 Memory cell use
23b0: 64 20 74 6f 20 73 74 6f 72 65 20 61 67 67 72 65 d to store aggre
23c0: 67 61 74 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a gate context */.
23d0: 20 20 69 6e 74 20 69 73 45 72 72 6f 72 3b 20 20 int isError;
23e0: 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 /* Error
23f0: 20 63 6f 64 65 20 72 65 74 75 72 6e 65 64 20 62 code returned b
2400: 79 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 2e 20 y the function.
2410: 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 */. CollSeq *pC
2420: 6f 6c 6c 3b 20 20 20 20 20 20 20 2f 2a 20 43 6f oll; /* Co
2430: 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e 63 65 llating sequence
2440: 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 */.};../*.** A
2450: 53 65 74 20 73 74 72 75 63 74 75 72 65 20 69 73 Set structure is
2460: 20 75 73 65 64 20 66 6f 72 20 71 75 69 63 6b 20 used for quick
2470: 74 65 73 74 69 6e 67 20 74 6f 20 73 65 65 20 69 testing to see i
2480: 66 20 61 20 76 61 6c 75 65 0a 2a 2a 20 69 73 20 f a value.** is
2490: 70 61 72 74 20 6f 66 20 61 20 73 6d 61 6c 6c 20 part of a small
24a0: 73 65 74 2e 20 20 53 65 74 73 20 61 72 65 20 75 set. Sets are u
24b0: 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 sed to implement
24c0: 20 63 6f 64 65 20 6c 69 6b 65 0a 2a 2a 20 74 68 code like.** th
24d0: 69 73 3a 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 is:.**
24e0: 20 20 78 2e 79 20 49 4e 20 28 27 68 69 27 2c 27 x.y IN ('hi','
24f0: 68 6f 6f 27 2c 27 68 75 6d 27 29 0a 2a 2f 0a 74 hoo','hum').*/.t
2500: 79 70 65 64 65 66 20 73 74 72 75 63 74 20 53 65 ypedef struct Se
2510: 74 20 53 65 74 3b 0a 73 74 72 75 63 74 20 53 65 t Set;.struct Se
2520: 74 20 7b 0a 20 20 48 61 73 68 20 68 61 73 68 3b t {. Hash hash;
2530: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
2540: 41 20 73 65 74 20 69 73 20 6a 75 73 74 20 61 20 A set is just a
2550: 68 61 73 68 20 74 61 62 6c 65 20 2a 2f 0a 20 20 hash table */.
2560: 48 61 73 68 45 6c 65 6d 20 2a 70 72 65 76 3b 20 HashElem *prev;
2570: 20 20 20 20 20 20 20 2f 2a 20 50 72 65 76 69 6f /* Previo
2580: 75 73 6c 79 20 61 63 63 65 73 73 65 64 20 68 61 usly accessed ha
2590: 73 68 20 65 6c 65 6d 65 6e 20 2a 2f 0a 7d 3b 0a sh elemen */.};.
25a0: 0a 2f 2a 0a 2a 2a 20 41 20 46 69 66 6f 50 61 67 ./*.** A FifoPag
25b0: 65 20 73 74 72 75 63 74 75 72 65 20 68 6f 6c 64 e structure hold
25c0: 73 20 61 20 73 69 6e 67 6c 65 20 70 61 67 65 20 s a single page
25d0: 6f 66 20 76 61 6c 76 65 73 2e 20 20 50 61 67 65 of valves. Page
25e0: 73 20 61 72 65 20 61 72 72 61 6e 67 65 64 0a 2a s are arranged.*
25f0: 2a 20 69 6e 20 61 20 6c 69 73 74 2e 0a 2a 2f 0a * in a list..*/.
2600: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 46 typedef struct F
2610: 69 66 6f 50 61 67 65 20 46 69 66 6f 50 61 67 65 ifoPage FifoPage
2620: 3b 0a 73 74 72 75 63 74 20 46 69 66 6f 50 61 67 ;.struct FifoPag
2630: 65 20 7b 0a 20 20 69 6e 74 20 6e 53 6c 6f 74 3b e {. int nSlot;
2640: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
2650: 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 61 53 er of entries aS
2660: 6c 6f 74 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 lot[] */. int i
2670: 57 72 69 74 65 3b 20 20 20 20 20 20 20 20 2f 2a Write; /*
2680: 20 50 75 73 68 20 74 68 65 20 6e 65 78 74 20 76 Push the next v
2690: 61 6c 75 65 20 69 6e 74 6f 20 74 68 69 73 20 65 alue into this e
26a0: 6e 74 72 79 20 69 6e 20 61 53 6c 6f 74 5b 5d 20 ntry in aSlot[]
26b0: 2a 2f 0a 20 20 69 6e 74 20 69 52 65 61 64 3b 20 */. int iRead;
26c0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 64 20 /* Read
26d0: 74 68 65 20 6e 65 78 74 20 76 61 6c 75 65 20 66 the next value f
26e0: 72 6f 6d 20 74 68 69 73 20 65 6e 74 72 79 20 69 rom this entry i
26f0: 6e 20 61 53 6c 6f 74 5b 5d 20 2a 2f 0a 20 20 46 n aSlot[] */. F
2700: 69 66 6f 50 61 67 65 20 2a 70 4e 65 78 74 3b 20 ifoPage *pNext;
2710: 20 20 2f 2a 20 4e 65 78 74 20 70 61 67 65 20 69 /* Next page i
2720: 6e 20 74 68 65 20 66 69 66 6f 20 2a 2f 0a 20 20 n the fifo */.
2730: 69 36 34 20 61 53 6c 6f 74 5b 31 5d 3b 20 20 20 i64 aSlot[1];
2740: 20 20 20 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f 72 /* One or mor
2750: 65 20 73 6c 6f 74 73 20 66 6f 72 20 72 6f 77 69 e slots for rowi
2760: 64 20 76 61 6c 75 65 73 20 2a 2f 0a 7d 3b 0a 0a d values */.};..
2770: 2f 2a 0a 2a 2a 20 54 68 65 20 46 69 66 6f 20 73 /*.** The Fifo s
2780: 74 72 75 63 74 75 72 65 20 69 73 20 74 79 70 65 tructure is type
2790: 64 65 66 2d 65 64 20 69 6e 20 76 64 62 65 49 6e def-ed in vdbeIn
27a0: 74 2e 68 2e 20 20 42 75 74 20 74 68 65 20 69 6d t.h. But the im
27b0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 0a 2a 2a 20 plementation.**
27c0: 6f 66 20 74 68 61 74 20 73 74 72 75 63 74 75 72 of that structur
27d0: 65 20 69 73 20 70 72 69 76 61 74 65 20 74 6f 20 e is private to
27e0: 74 68 69 73 20 66 69 6c 65 2e 0a 2a 2a 0a 2a 2a this file..**.**
27f0: 20 54 68 65 20 46 69 66 6f 20 73 74 72 75 63 74 The Fifo struct
2800: 75 72 65 20 64 65 73 63 72 69 62 65 73 20 74 68 ure describes th
2810: 65 20 65 6e 74 69 72 65 20 66 69 66 6f 2e 20 20 e entire fifo.
2820: 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 .*/.typedef stru
2830: 63 74 20 46 69 66 6f 20 46 69 66 6f 3b 0a 73 74 ct Fifo Fifo;.st
2840: 72 75 63 74 20 46 69 66 6f 20 7b 0a 20 20 69 6e ruct Fifo {. in
2850: 74 20 6e 45 6e 74 72 79 3b 20 20 20 20 20 20 20 t nEntry;
2860: 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d 62 65 /* Total numbe
2870: 72 20 6f 66 20 65 6e 74 72 69 65 73 20 2a 2f 0a r of entries */.
2880: 20 20 46 69 66 6f 50 61 67 65 20 2a 70 46 69 72 FifoPage *pFir
2890: 73 74 3b 20 20 20 2f 2a 20 46 69 72 73 74 20 70 st; /* First p
28a0: 61 67 65 20 6f 6e 20 74 68 65 20 6c 69 73 74 20 age on the list
28b0: 2a 2f 0a 20 20 46 69 66 6f 50 61 67 65 20 2a 70 */. FifoPage *p
28c0: 4c 61 73 74 3b 20 20 20 20 2f 2a 20 4c 61 73 74 Last; /* Last
28d0: 20 70 61 67 65 20 6f 6e 20 74 68 65 20 6c 69 73 page on the lis
28e0: 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 t */.};../*.** A
28f0: 20 43 6f 6e 74 65 78 74 20 73 74 6f 72 65 73 20 Context stores
2900: 74 68 65 20 6c 61 73 74 20 69 6e 73 65 72 74 20 the last insert
2910: 72 6f 77 69 64 2c 20 74 68 65 20 6c 61 73 74 20 rowid, the last
2920: 73 74 61 74 65 6d 65 6e 74 20 63 68 61 6e 67 65 statement change
2930: 20 63 6f 75 6e 74 2c 0a 2a 2a 20 61 6e 64 20 74 count,.** and t
2940: 68 65 20 63 75 72 72 65 6e 74 20 73 74 61 74 65 he current state
2950: 6d 65 6e 74 20 63 68 61 6e 67 65 20 63 6f 75 6e ment change coun
2960: 74 20 28 69 2e 65 2e 20 63 68 61 6e 67 65 73 20 t (i.e. changes
2970: 73 69 6e 63 65 20 6c 61 73 74 20 73 74 61 74 65 since last state
2980: 6d 65 6e 74 29 2e 0a 2a 2a 20 54 68 65 20 63 75 ment)..** The cu
2990: 72 72 65 6e 74 20 6b 65 79 6c 69 73 74 20 69 73 rrent keylist is
29a0: 20 61 6c 73 6f 20 73 74 6f 72 65 64 20 69 6e 20 also stored in
29b0: 74 68 65 20 63 6f 6e 74 65 78 74 2e 0a 2a 2a 20 the context..**
29c0: 45 6c 65 6d 65 6e 74 73 20 6f 66 20 43 6f 6e 74 Elements of Cont
29d0: 65 78 74 20 73 74 72 75 63 74 75 72 65 20 74 79 ext structure ty
29e0: 70 65 20 6d 61 6b 65 20 75 70 20 74 68 65 20 43 pe make up the C
29f0: 6f 6e 74 65 78 74 53 74 61 63 6b 2c 20 77 68 69 ontextStack, whi
2a00: 63 68 20 69 73 0a 2a 2a 20 75 70 64 61 74 65 64 ch is.** updated
2a10: 20 62 79 20 74 68 65 20 43 6f 6e 74 65 78 74 50 by the ContextP
2a20: 75 73 68 20 61 6e 64 20 43 6f 6e 74 65 78 74 50 ush and ContextP
2a30: 6f 70 20 6f 70 63 6f 64 65 73 20 28 75 73 65 64 op opcodes (used
2a40: 20 62 79 20 74 72 69 67 67 65 72 73 29 2e 0a 2a by triggers)..*
2a50: 2a 20 54 68 65 20 63 6f 6e 74 65 78 74 20 69 73 * The context is
2a60: 20 70 75 73 68 65 64 20 62 65 66 6f 72 65 20 65 pushed before e
2a70: 78 65 63 75 74 69 6e 67 20 61 20 74 72 69 67 67 xecuting a trigg
2a80: 65 72 20 61 20 70 6f 70 70 65 64 20 77 68 65 6e er a popped when
2a90: 20 74 68 65 0a 2a 2a 20 74 72 69 67 67 65 72 20 the.** trigger
2aa0: 66 69 6e 69 73 68 65 73 2e 0a 2a 2f 0a 74 79 70 finishes..*/.typ
2ab0: 65 64 65 66 20 73 74 72 75 63 74 20 43 6f 6e 74 edef struct Cont
2ac0: 65 78 74 20 43 6f 6e 74 65 78 74 3b 0a 73 74 72 ext Context;.str
2ad0: 75 63 74 20 43 6f 6e 74 65 78 74 20 7b 0a 20 20 uct Context {.
2ae0: 69 36 34 20 6c 61 73 74 52 6f 77 69 64 3b 20 20 i64 lastRowid;
2af0: 20 20 2f 2a 20 4c 61 73 74 20 69 6e 73 65 72 74 /* Last insert
2b00: 20 72 6f 77 69 64 20 28 73 71 6c 69 74 65 33 2e rowid (sqlite3.
2b10: 6c 61 73 74 52 6f 77 69 64 29 20 2a 2f 0a 20 20 lastRowid) */.
2b20: 69 6e 74 20 6e 43 68 61 6e 67 65 3b 20 20 20 20 int nChange;
2b30: 20 20 2f 2a 20 53 74 61 74 65 6d 65 6e 74 20 63 /* Statement c
2b40: 68 61 6e 67 65 73 20 28 56 64 62 65 2e 6e 43 68 hanges (Vdbe.nCh
2b50: 61 6e 67 65 73 29 20 20 20 20 20 2a 2f 0a 20 20 anges) */.
2b60: 46 69 66 6f 20 73 46 69 66 6f 3b 20 20 20 20 20 Fifo sFifo;
2b70: 20 20 2f 2a 20 52 65 63 6f 72 64 73 20 74 68 61 /* Records tha
2b80: 74 20 77 69 6c 6c 20 70 61 72 74 69 63 69 70 61 t will participa
2b90: 74 65 20 69 6e 20 61 20 44 45 4c 45 54 45 20 6f te in a DELETE o
2ba0: 72 20 55 50 44 41 54 45 20 2a 2f 0a 7d 3b 0a 0a r UPDATE */.};..
2bb0: 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63 /*.** An instanc
2bc0: 65 20 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c e of the virtual
2bd0: 20 6d 61 63 68 69 6e 65 2e 20 20 54 68 69 73 20 machine. This
2be0: 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 structure contai
2bf0: 6e 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 0a ns the complete.
2c00: 2a 2a 20 73 74 61 74 65 20 6f 66 20 74 68 65 20 ** state of the
2c10: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e virtual machine.
2c20: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22 73 71 6c 69 .**.** The "sqli
2c30: 74 65 33 5f 73 74 6d 74 22 20 73 74 72 75 63 74 te3_stmt" struct
2c40: 75 72 65 20 70 6f 69 6e 74 65 72 20 74 68 61 74 ure pointer that
2c50: 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20 is returned by
2c60: 73 71 6c 69 74 65 33 5f 63 6f 6d 70 69 6c 65 28 sqlite3_compile(
2c70: 29 0a 2a 2a 20 69 73 20 72 65 61 6c 6c 79 20 61 ).** is really a
2c80: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69 pointer to an i
2c90: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20 nstance of this
2ca0: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a structure..**.**
2cb0: 20 54 68 65 20 56 64 62 65 2e 69 6e 56 74 61 62 The Vdbe.inVtab
2cc0: 4d 65 74 68 6f 64 20 76 61 72 69 61 62 6c 65 20 Method variable
2cd0: 69 73 20 73 65 74 20 74 6f 20 6e 6f 6e 2d 7a 65 is set to non-ze
2ce0: 72 6f 20 66 6f 72 20 74 68 65 20 64 75 72 61 74 ro for the durat
2cf0: 69 6f 6e 20 6f 66 0a 2a 2a 20 61 6e 79 20 76 69 ion of.** any vi
2d00: 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 65 74 68 rtual table meth
2d10: 6f 64 20 69 6e 76 6f 63 61 74 69 6f 6e 73 20 6d od invocations m
2d20: 61 64 65 20 62 79 20 74 68 65 20 76 64 62 65 20 ade by the vdbe
2d30: 70 72 6f 67 72 61 6d 2e 20 49 74 20 69 73 0a 2a program. It is.*
2d40: 2a 20 73 65 74 20 74 6f 20 32 20 66 6f 72 20 78 * set to 2 for x
2d50: 44 65 73 74 72 6f 79 20 6d 65 74 68 6f 64 20 63 Destroy method c
2d60: 61 6c 6c 73 20 61 6e 64 20 31 20 66 6f 72 20 61 alls and 1 for a
2d70: 6c 6c 20 6f 74 68 65 72 20 6d 65 74 68 6f 64 73 ll other methods
2d80: 2e 20 54 68 69 73 0a 2a 2a 20 76 61 72 69 61 62 . This.** variab
2d90: 6c 65 20 69 73 20 75 73 65 64 20 66 6f 72 20 74 le is used for t
2da0: 77 6f 20 70 75 72 70 6f 73 65 73 3a 20 74 6f 20 wo purposes: to
2db0: 61 6c 6c 6f 77 20 78 44 65 73 74 72 6f 79 20 6d allow xDestroy m
2dc0: 65 74 68 6f 64 73 20 74 6f 20 65 78 65 63 75 74 ethods to execut
2dd0: 65 0a 2a 2a 20 22 44 52 4f 50 20 54 41 42 4c 45 e.** "DROP TABLE
2de0: 22 20 73 74 61 74 65 6d 65 6e 74 73 20 61 6e 64 " statements and
2df0: 20 74 6f 20 70 72 65 76 65 6e 74 20 73 6f 6d 65 to prevent some
2e00: 20 6e 61 73 74 79 20 73 69 64 65 20 65 66 66 65 nasty side effe
2e10: 63 74 73 20 6f 66 0a 2a 2a 20 6d 61 6c 6c 6f 63 cts of.** malloc
2e20: 20 66 61 69 6c 75 72 65 20 77 68 65 6e 20 53 51 failure when SQ
2e30: 4c 69 74 65 20 69 73 20 69 6e 76 6f 6b 65 64 20 Lite is invoked
2e40: 72 65 63 75 72 73 69 76 65 6c 79 20 62 79 20 61 recursively by a
2e50: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 0a virtual table .
2e60: 2a 2a 20 6d 65 74 68 6f 64 20 66 75 6e 63 74 69 ** method functi
2e70: 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56 64 on..*/.struct Vd
2e80: 62 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a be {. sqlite3 *
2e90: 64 62 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 db; /* Th
2ea0: 65 20 77 68 6f 6c 65 20 64 61 74 61 62 61 73 65 e whole database
2eb0: 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 50 72 65 */. Vdbe *pPre
2ec0: 76 2c 2a 70 4e 65 78 74 3b 20 2f 2a 20 4c 69 6e v,*pNext; /* Lin
2ed0: 6b 65 64 20 6c 69 73 74 20 6f 66 20 56 44 42 45 ked list of VDBE
2ee0: 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 s with the same
2ef0: 56 64 62 65 2e 64 62 20 2a 2f 0a 20 20 69 6e 74 Vdbe.db */. int
2f00: 20 6e 4f 70 3b 20 20 20 20 20 20 20 20 20 20 20 nOp;
2f10: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 69 6e /* Number of in
2f20: 73 74 72 75 63 74 69 6f 6e 73 20 69 6e 20 74 68 structions in th
2f30: 65 20 70 72 6f 67 72 61 6d 20 2a 2f 0a 20 20 69 e program */. i
2f40: 6e 74 20 6e 4f 70 41 6c 6c 6f 63 3b 20 20 20 20 nt nOpAlloc;
2f50: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
2f60: 73 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65 64 20 slots allocated
2f70: 66 6f 72 20 61 4f 70 5b 5d 20 2a 2f 0a 20 20 4f for aOp[] */. O
2f80: 70 20 2a 61 4f 70 3b 20 20 20 20 20 20 20 20 20 p *aOp;
2f90: 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 68 /* Space to h
2fa0: 6f 6c 64 20 74 68 65 20 76 69 72 74 75 61 6c 20 old the virtual
2fb0: 6d 61 63 68 69 6e 65 27 73 20 70 72 6f 67 72 61 machine's progra
2fc0: 6d 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 65 m */. int nLabe
2fd0: 6c 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 l; /* Nu
2fe0: 6d 62 65 72 20 6f 66 20 6c 61 62 65 6c 73 20 75 mber of labels u
2ff0: 73 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 sed */. int nLa
3000: 62 65 6c 41 6c 6c 6f 63 3b 20 20 20 20 2f 2a 20 belAlloc; /*
3010: 4e 75 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 Number of slots
3020: 61 6c 6c 6f 63 61 74 65 64 20 69 6e 20 61 4c 61 allocated in aLa
3030: 62 65 6c 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 2a bel[] */. int *
3040: 61 4c 61 62 65 6c 3b 20 20 20 20 20 20 20 20 2f aLabel; /
3050: 2a 20 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 * Space to hold
3060: 74 68 65 20 6c 61 62 65 6c 73 20 2a 2f 0a 20 20 the labels */.
3070: 4d 65 6d 20 2a 2a 61 70 41 72 67 3b 20 20 20 20 Mem **apArg;
3080: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 73 /* Arguments
3090: 20 74 6f 20 63 75 72 72 65 6e 74 6c 79 20 65 78 to currently ex
30a0: 65 63 75 74 69 6e 67 20 75 73 65 72 20 66 75 6e ecuting user fun
30b0: 63 74 69 6f 6e 20 2a 2f 0a 20 20 4d 65 6d 20 2a ction */. Mem *
30c0: 61 43 6f 6c 4e 61 6d 65 3b 20 20 20 20 20 20 2f aColName; /
30d0: 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20 74 * Column names t
30e0: 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 69 6e o return */. in
30f0: 74 20 6e 43 75 72 73 6f 72 3b 20 20 20 20 20 20 t nCursor;
3100: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 /* Number of s
3110: 6c 6f 74 73 20 69 6e 20 61 70 43 73 72 5b 5d 20 lots in apCsr[]
3120: 2a 2f 0a 20 20 43 75 72 73 6f 72 20 2a 2a 61 70 */. Cursor **ap
3130: 43 73 72 3b 20 20 20 20 20 2f 2a 20 4f 6e 65 20 Csr; /* One
3140: 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 69 73 20 element of this
3150: 61 72 72 61 79 20 66 6f 72 20 65 61 63 68 20 6f array for each o
3160: 70 65 6e 20 63 75 72 73 6f 72 20 2a 2f 0a 20 20 pen cursor */.
3170: 69 6e 74 20 6e 56 61 72 3b 20 20 20 20 20 20 20 int nVar;
3180: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
3190: 20 65 6e 74 72 69 65 73 20 69 6e 20 61 56 61 72 entries in aVar
31a0: 5b 5d 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 56 61 [] */. Mem *aVa
31b0: 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 r; /* V
31c0: 61 6c 75 65 73 20 66 6f 72 20 74 68 65 20 4f 50 alues for the OP
31d0: 5f 56 61 72 69 61 62 6c 65 20 6f 70 63 6f 64 65 _Variable opcode
31e0: 2e 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 61 7a . */. char **az
31f0: 56 61 72 3b 20 20 20 20 20 20 20 2f 2a 20 4e 61 Var; /* Na
3200: 6d 65 20 6f 66 20 76 61 72 69 61 62 6c 65 73 20 me of variables
3210: 2a 2f 0a 20 20 69 6e 74 20 6f 6b 56 61 72 3b 20 */. int okVar;
3220: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
3230: 20 69 66 20 61 7a 56 61 72 5b 5d 20 68 61 73 20 if azVar[] has
3240: 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 7a 65 64 been initialized
3250: 20 2a 2f 0a 20 20 69 6e 74 20 6d 61 67 69 63 3b */. int magic;
3260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
3270: 20 4d 61 67 69 63 20 6e 75 6d 62 65 72 20 66 6f Magic number fo
3280: 72 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e r sanity checkin
3290: 67 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 3b g */. int nMem;
32a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
32b0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f * Number of memo
32c0: 72 79 20 6c 6f 63 61 74 69 6f 6e 73 20 63 75 72 ry locations cur
32d0: 72 65 6e 74 6c 79 20 61 6c 6c 6f 63 61 74 65 64 rently allocated
32e0: 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d 65 6d 3b */. Mem *aMem;
32f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
3300: 20 54 68 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 The memory loca
3310: 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 6e tions */. int n
3320: 43 61 6c 6c 62 61 63 6b 3b 20 20 20 20 20 20 20 Callback;
3330: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 /* Number of
3340: 63 61 6c 6c 62 61 63 6b 73 20 69 6e 76 6f 6b 65 callbacks invoke
3350: 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 69 6e d so far */. in
3360: 74 20 63 61 63 68 65 43 74 72 3b 20 20 20 20 20 t cacheCtr;
3370: 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 20 /* Cursor
3380: 72 6f 77 20 63 61 63 68 65 20 67 65 6e 65 72 61 row cache genera
3390: 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20 2a 2f 0a tion counter */.
33a0: 20 20 46 69 66 6f 20 73 46 69 66 6f 3b 20 20 20 Fifo sFifo;
33b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 6c /* A l
33c0: 69 73 74 20 6f 66 20 52 4f 57 49 44 73 20 2a 2f ist of ROWIDs */
33d0: 0a 20 20 69 6e 74 20 63 6f 6e 74 65 78 74 53 74 . int contextSt
33e0: 61 63 6b 54 6f 70 3b 20 20 20 20 2f 2a 20 49 6e ackTop; /* In
33f0: 64 65 78 20 6f 66 20 74 6f 70 20 65 6c 65 6d 65 dex of top eleme
3400: 6e 74 20 69 6e 20 74 68 65 20 63 6f 6e 74 65 78 nt in the contex
3410: 74 20 73 74 61 63 6b 20 2a 2f 0a 20 20 69 6e 74 t stack */. int
3420: 20 63 6f 6e 74 65 78 74 53 74 61 63 6b 44 65 70 contextStackDep
3430: 74 68 3b 20 20 2f 2a 20 54 68 65 20 73 69 7a 65 th; /* The size
3440: 20 6f 66 20 74 68 65 20 22 63 6f 6e 74 65 78 74 of the "context
3450: 22 20 73 74 61 63 6b 20 2a 2f 0a 20 20 43 6f 6e " stack */. Con
3460: 74 65 78 74 20 2a 63 6f 6e 74 65 78 74 53 74 61 text *contextSta
3470: 63 6b 3b 20 20 2f 2a 20 53 74 61 63 6b 20 75 73 ck; /* Stack us
3480: 65 64 20 62 79 20 6f 70 63 6f 64 65 73 20 43 6f ed by opcodes Co
3490: 6e 74 65 78 74 50 75 73 68 20 26 20 43 6f 6e 74 ntextPush & Cont
34a0: 65 78 74 50 6f 70 2a 2f 0a 20 20 69 6e 74 20 70 extPop*/. int p
34b0: 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 c;
34c0: 20 20 20 2f 2a 20 54 68 65 20 70 72 6f 67 72 61 /* The progra
34d0: 6d 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 m counter */. i
34e0: 6e 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 nt rc;
34f0: 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 /* Value
3500: 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 75 to return */. u
3510: 6e 73 69 67 6e 65 64 20 75 6e 69 71 75 65 43 6e nsigned uniqueCn
3520: 74 3b 20 20 20 20 20 2f 2a 20 55 73 65 64 20 62 t; /* Used b
3530: 79 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 y OP_MakeRecord
3540: 77 68 65 6e 20 50 32 21 3d 30 20 2a 2f 0a 20 20 when P2!=0 */.
3550: 69 6e 74 20 65 72 72 6f 72 41 63 74 69 6f 6e 3b int errorAction;
3560: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 63 6f 76 /* Recov
3570: 65 72 79 20 61 63 74 69 6f 6e 20 74 6f 20 64 6f ery action to do
3580: 20 69 6e 20 63 61 73 65 20 6f 66 20 61 6e 20 65 in case of an e
3590: 72 72 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 69 6e rror */. int in
35a0: 54 65 6d 70 54 72 61 6e 73 3b 20 20 20 20 20 20 TempTrans;
35b0: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 65 6d /* True if tem
35c0: 70 20 64 61 74 61 62 61 73 65 20 69 73 20 74 72 p database is tr
35d0: 61 6e 73 61 63 74 69 6f 6e 65 64 20 2a 2f 0a 20 ansactioned */.
35e0: 20 69 6e 74 20 72 65 74 75 72 6e 53 74 61 63 6b int returnStack
35f0: 5b 32 35 5d 3b 20 20 20 20 2f 2a 20 52 65 74 75 [25]; /* Retu
3600: 72 6e 20 61 64 64 72 65 73 73 20 73 74 61 63 6b rn address stack
3610: 20 66 6f 72 20 4f 50 5f 47 6f 73 75 62 20 26 20 for OP_Gosub &
3620: 4f 50 5f 52 65 74 75 72 6e 20 2a 2f 0a 20 20 69 OP_Return */. i
3630: 6e 74 20 72 65 74 75 72 6e 44 65 70 74 68 3b 20 nt returnDepth;
3640: 20 20 20 20 20 20 20 2f 2a 20 4e 65 78 74 20 75 /* Next u
3650: 6e 75 73 65 64 20 65 6c 65 6d 65 6e 74 20 69 6e nused element in
3660: 20 72 65 74 75 72 6e 53 74 61 63 6b 5b 5d 20 2a returnStack[] *
3670: 2f 0a 20 20 69 6e 74 20 6e 52 65 73 43 6f 6c 75 /. int nResColu
3680: 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 4e mn; /* N
3690: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 umber of columns
36a0: 20 69 6e 20 6f 6e 65 20 72 6f 77 20 6f 66 20 74 in one row of t
36b0: 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 2a 2f he result set */
36c0: 0a 20 20 63 68 61 72 20 2a 2a 61 7a 52 65 73 43 . char **azResC
36d0: 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a 20 56 61 olumn; /* Va
36e0: 6c 75 65 73 20 66 6f 72 20 6f 6e 65 20 72 6f 77 lues for one row
36f0: 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f 20 0a 20 of result */ .
3700: 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 3b 20 char *zErrMsg;
3710: 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f /* Erro
3720: 72 20 6d 65 73 73 61 67 65 20 77 72 69 74 74 65 r message writte
3730: 6e 20 68 65 72 65 20 2a 2f 0a 20 20 4d 65 6d 20 n here */. Mem
3740: 2a 70 52 65 73 75 6c 74 53 65 74 3b 20 20 20 20 *pResultSet;
3750: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 /* Pointer t
3760: 6f 20 61 6e 20 61 72 72 61 79 20 6f 66 20 72 65 o an array of re
3770: 73 75 6c 74 73 20 2a 2f 0a 20 20 75 38 20 65 78 sults */. u8 ex
3780: 70 6c 61 69 6e 3b 20 20 20 20 20 20 20 20 20 20 plain;
3790: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 45 58 /* True if EX
37a0: 50 4c 41 49 4e 20 70 72 65 73 65 6e 74 20 6f 6e PLAIN present on
37b0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 20 2a 2f 0a SQL command */.
37c0: 20 20 75 38 20 63 68 61 6e 67 65 43 6e 74 4f 6e u8 changeCntOn
37d0: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 ; /* Tru
37e0: 65 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20 e to update the
37f0: 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 2a change-counter *
3800: 2f 0a 20 20 75 38 20 61 62 6f 72 74 65 64 3b 20 /. u8 aborted;
3810: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
3820: 72 75 65 20 69 66 20 52 4f 4c 4c 42 41 43 4b 20 rue if ROLLBACK
3830: 69 6e 20 61 6e 6f 74 68 65 72 20 56 4d 20 63 61 in another VM ca
3840: 75 73 65 73 20 61 6e 20 61 62 6f 72 74 20 2a 2f uses an abort */
3850: 0a 20 20 75 38 20 65 78 70 69 72 65 64 3b 20 20 . u8 expired;
3860: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
3870: 75 65 20 69 66 20 74 68 65 20 56 4d 20 6e 65 65 ue if the VM nee
3880: 64 73 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 ds to be recompi
3890: 6c 65 64 20 2a 2f 0a 20 20 75 38 20 6d 69 6e 57 led */. u8 minW
38a0: 72 69 74 65 46 69 6c 65 46 6f 72 6d 61 74 3b 20 riteFileFormat;
38b0: 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 66 69 6c 65 /* Minimum file
38c0: 20 66 6f 72 6d 61 74 20 66 6f 72 20 77 72 69 74 format for writ
38d0: 61 62 6c 65 20 64 61 74 61 62 61 73 65 20 66 69 able database fi
38e0: 6c 65 73 20 2a 2f 0a 20 20 75 38 20 69 6e 56 74 les */. u8 inVt
38f0: 61 62 4d 65 74 68 6f 64 3b 20 20 20 20 20 20 20 abMethod;
3900: 20 2f 2a 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73 /* See comments
3910: 20 61 62 6f 76 65 20 2a 2f 0a 20 20 69 6e 74 20 above */. int
3920: 6e 43 68 61 6e 67 65 3b 20 20 20 20 20 20 20 20 nChange;
3930: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 /* Number of
3940: 20 64 62 20 63 68 61 6e 67 65 73 20 6d 61 64 65 db changes made
3950: 20 73 69 6e 63 65 20 6c 61 73 74 20 72 65 73 65 since last rese
3960: 74 20 2a 2f 0a 20 20 69 36 34 20 73 74 61 72 74 t */. i64 start
3970: 54 69 6d 65 3b 20 20 20 20 20 20 20 20 20 20 2f Time; /
3980: 2a 20 54 69 6d 65 20 77 68 65 6e 20 71 75 65 72 * Time when quer
3990: 79 20 73 74 61 72 74 65 64 20 2d 20 75 73 65 64 y started - used
39a0: 20 66 6f 72 20 70 72 6f 66 69 6c 69 6e 67 20 2a for profiling *
39b0: 2f 0a 20 20 69 6e 74 20 62 74 72 65 65 4d 61 73 /. int btreeMas
39c0: 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 k; /* B
39d0: 69 74 6d 61 73 6b 20 6f 66 20 64 62 2d 3e 61 44 itmask of db->aD
39e0: 62 5b 5d 20 65 6e 74 72 69 65 73 20 72 65 66 65 b[] entries refe
39f0: 72 65 6e 63 65 64 20 2a 2f 0a 20 20 42 74 72 65 renced */. Btre
3a00: 65 4d 75 74 65 78 41 72 72 61 79 20 61 4d 75 74 eMutexArray aMut
3a10: 65 78 3b 20 2f 2a 20 41 6e 20 61 72 72 61 79 20 ex; /* An array
3a20: 6f 66 20 42 74 72 65 65 20 75 73 65 64 20 68 65 of Btree used he
3a30: 72 65 20 61 6e 64 20 6e 65 65 64 69 6e 67 20 6c re and needing l
3a40: 6f 63 6b 73 20 2a 2f 0a 20 20 69 6e 74 20 6e 53 ocks */. int nS
3a50: 71 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ql;
3a60: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79 74 /* Number of byt
3a70: 65 73 20 69 6e 20 7a 53 71 6c 20 2a 2f 0a 20 20 es in zSql */.
3a80: 63 68 61 72 20 2a 7a 53 71 6c 3b 20 20 20 20 20 char *zSql;
3a90: 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 6f 66 /* Text of
3aa0: 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 the SQL stateme
3ab0: 6e 74 20 74 68 61 74 20 67 65 6e 65 72 61 74 65 nt that generate
3ac0: 64 20 74 68 69 73 20 2a 2f 0a 23 69 66 64 65 66 d this */.#ifdef
3ad0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 SQLITE_DEBUG.
3ae0: 46 49 4c 45 20 2a 74 72 61 63 65 3b 20 20 20 20 FILE *trace;
3af0: 20 20 20 20 2f 2a 20 57 72 69 74 65 20 61 6e 20 /* Write an
3b00: 65 78 65 63 75 74 69 6f 6e 20 74 72 61 63 65 20 execution trace
3b10: 68 65 72 65 2c 20 69 66 20 6e 6f 74 20 4e 55 4c here, if not NUL
3b20: 4c 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69 6e L */.#endif. in
3b30: 74 20 6f 70 65 6e 65 64 53 74 61 74 65 6d 65 6e t openedStatemen
3b40: 74 3b 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 t; /* True if t
3b50: 68 69 73 20 56 4d 20 68 61 73 20 6f 70 65 6e 65 his VM has opene
3b60: 64 20 61 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f d a statement jo
3b70: 75 72 6e 61 6c 20 2a 2f 0a 23 69 66 64 65 66 20 urnal */.#ifdef
3b80: 53 51 4c 49 54 45 5f 53 53 45 0a 20 20 69 6e 74 SQLITE_SSE. int
3b90: 20 66 65 74 63 68 49 64 3b 20 20 20 20 20 20 20 fetchId;
3ba0: 20 20 20 2f 2a 20 53 74 61 74 65 6d 65 6e 74 20 /* Statement
3bb0: 6e 75 6d 62 65 72 20 75 73 65 64 20 62 79 20 73 number used by s
3bc0: 71 6c 69 74 65 33 5f 66 65 74 63 68 5f 73 74 61 qlite3_fetch_sta
3bd0: 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 tement */. int
3be0: 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20 20 20 lru;
3bf0: 20 20 2f 2a 20 43 6f 75 6e 74 65 72 20 75 73 65 /* Counter use
3c00: 64 20 66 6f 72 20 4c 52 55 20 63 61 63 68 65 20 d for LRU cache
3c10: 72 65 70 6c 61 63 65 6d 65 6e 74 20 2a 2f 0a 23 replacement */.#
3c20: 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 endif.};../*.**
3c30: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 The following ar
3c40: 65 20 61 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 e allowed values
3c50: 20 66 6f 72 20 56 64 62 65 2e 6d 61 67 69 63 0a for Vdbe.magic.
3c60: 2a 2f 0a 23 64 65 66 69 6e 65 20 56 44 42 45 5f */.#define VDBE_
3c70: 4d 41 47 49 43 5f 49 4e 49 54 20 20 20 20 20 30 MAGIC_INIT 0
3c80: 78 32 36 62 63 65 61 61 35 20 20 20 20 2f 2a 20 x26bceaa5 /*
3c90: 42 75 69 6c 64 69 6e 67 20 61 20 56 44 42 45 20 Building a VDBE
3ca0: 70 72 6f 67 72 61 6d 20 2a 2f 0a 23 64 65 66 69 program */.#defi
3cb0: 6e 65 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 ne VDBE_MAGIC_RU
3cc0: 4e 20 20 20 20 20 20 30 78 62 64 66 32 30 64 61 N 0xbdf20da
3cd0: 33 20 20 20 20 2f 2a 20 56 44 42 45 20 69 73 20 3 /* VDBE is
3ce0: 72 65 61 64 79 20 74 6f 20 65 78 65 63 75 74 65 ready to execute
3cf0: 20 2a 2f 0a 23 64 65 66 69 6e 65 20 56 44 42 45 */.#define VDBE
3d00: 5f 4d 41 47 49 43 5f 48 41 4c 54 20 20 20 20 20 _MAGIC_HALT
3d10: 30 78 35 31 39 63 32 39 37 33 20 20 20 20 2f 2a 0x519c2973 /*
3d20: 20 56 44 42 45 20 68 61 73 20 63 6f 6d 70 6c 65 VDBE has comple
3d30: 74 65 64 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f ted execution */
3d40: 0a 23 64 65 66 69 6e 65 20 56 44 42 45 5f 4d 41 .#define VDBE_MA
3d50: 47 49 43 5f 44 45 41 44 20 20 20 20 20 30 78 62 GIC_DEAD 0xb
3d60: 36 30 36 63 33 63 38 20 20 20 20 2f 2a 20 54 68 606c3c8 /* Th
3d70: 65 20 56 44 42 45 20 68 61 73 20 62 65 65 6e 20 e VDBE has been
3d80: 64 65 61 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 0a deallocated */..
3d90: 2f 2a 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 70 /*.** Function p
3da0: 72 6f 74 6f 74 79 70 65 73 0a 2a 2f 0a 76 6f 69 rototypes.*/.voi
3db0: 64 20 73 71 6c 69 74 65 33 56 64 62 65 46 72 65 d sqlite3VdbeFre
3dc0: 65 43 75 72 73 6f 72 28 56 64 62 65 20 2a 2c 20 eCursor(Vdbe *,
3dd0: 43 75 72 73 6f 72 2a 29 3b 0a 76 6f 69 64 20 73 Cursor*);.void s
3de0: 71 6c 69 74 65 56 64 62 65 50 6f 70 53 74 61 63 qliteVdbePopStac
3df0: 6b 28 56 64 62 65 2a 2c 69 6e 74 29 3b 0a 69 6e k(Vdbe*,int);.in
3e00: 74 20 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 t sqlite3VdbeCur
3e10: 73 6f 72 4d 6f 76 65 74 6f 28 43 75 72 73 6f 72 sorMoveto(Cursor
3e20: 2a 29 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 *);.#if defined(
3e30: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20 7c 7c SQLITE_DEBUG) ||
3e40: 20 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 defined(VDBE_PR
3e50: 4f 46 49 4c 45 29 0a 76 6f 69 64 20 73 71 6c 69 OFILE).void sqli
3e60: 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 46 te3VdbePrintOp(F
3e70: 49 4c 45 2a 2c 20 69 6e 74 2c 20 4f 70 2a 29 3b ILE*, int, Op*);
3e80: 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 .#endif.int sqli
3e90: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 te3VdbeSerialTyp
3ea0: 65 4c 65 6e 28 75 33 32 29 3b 0a 75 33 32 20 73 eLen(u32);.u32 s
3eb0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c qlite3VdbeSerial
3ec0: 54 79 70 65 28 4d 65 6d 2a 2c 20 69 6e 74 29 3b Type(Mem*, int);
3ed0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 .int sqlite3Vdbe
3ee0: 53 65 72 69 61 6c 50 75 74 28 75 6e 73 69 67 6e SerialPut(unsign
3ef0: 65 64 20 63 68 61 72 2a 2c 20 69 6e 74 2c 20 4d ed char*, int, M
3f00: 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 em*, int);.int s
3f10: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c qlite3VdbeSerial
3f20: 47 65 74 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e Get(const unsign
3f30: 65 64 20 63 68 61 72 2a 2c 20 75 33 32 2c 20 4d ed char*, u32, M
3f40: 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 em*);.void sqlit
3f50: 65 33 56 64 62 65 44 65 6c 65 74 65 41 75 78 44 e3VdbeDeleteAuxD
3f60: 61 74 61 28 56 64 62 65 46 75 6e 63 2a 2c 20 69 ata(VdbeFunc*, i
3f70: 6e 74 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 nt);..int sqlite
3f80: 32 42 74 72 65 65 4b 65 79 43 6f 6d 70 61 72 65 2BtreeKeyCompare
3f90: 28 42 74 43 75 72 73 6f 72 20 2a 2c 20 63 6f 6e (BtCursor *, con
3fa0: 73 74 20 76 6f 69 64 20 2a 2c 20 69 6e 74 2c 20 st void *, int,
3fb0: 69 6e 74 2c 20 69 6e 74 20 2a 29 3b 0a 69 6e 74 int, int *);.int
3fc0: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b sqlite3VdbeIdxK
3fd0: 65 79 43 6f 6d 70 61 72 65 28 43 75 72 73 6f 72 eyCompare(Cursor
3fe0: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 75 6e 73 69 *,int,const unsi
3ff0: 67 6e 65 64 20 63 68 61 72 2a 2c 69 6e 74 2a 29 gned char*,int*)
4000: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 ;.int sqlite3Vdb
4010: 65 49 64 78 52 6f 77 69 64 28 42 74 43 75 72 73 eIdxRowid(BtCurs
4020: 6f 72 20 2a 2c 20 69 36 34 20 2a 29 3b 0a 69 6e or *, i64 *);.in
4030: 74 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 t sqlite3MemComp
4040: 61 72 65 28 63 6f 6e 73 74 20 4d 65 6d 2a 2c 20 are(const Mem*,
4050: 63 6f 6e 73 74 20 4d 65 6d 2a 2c 20 63 6f 6e 73 const Mem*, cons
4060: 74 20 43 6f 6c 6c 53 65 71 2a 29 3b 0a 69 6e 74 t CollSeq*);.int
4070: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f sqlite3VdbeReco
4080: 72 64 43 6f 6d 70 61 72 65 28 76 6f 69 64 2a 2c rdCompare(void*,
4090: 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a 2c int,const void*,
40a0: 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64 2a int, const void*
40b0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 );.int sqlite3Vd
40c0: 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 63 6f beIdxRowidLen(co
40d0: 6e 73 74 20 75 38 2a 29 3b 0a 69 6e 74 20 73 71 nst u8*);.int sq
40e0: 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 56 64 lite3VdbeExec(Vd
40f0: 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 be*);.int sqlite
4100: 33 56 64 62 65 4c 69 73 74 28 56 64 62 65 2a 29 3VdbeList(Vdbe*)
4110: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 ;.int sqlite3Vdb
4120: 65 48 61 6c 74 28 56 64 62 65 2a 29 3b 0a 69 6e eHalt(Vdbe*);.in
4130: 74 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 t sqlite3VdbeCha
4140: 6e 67 65 45 6e 63 6f 64 69 6e 67 28 4d 65 6d 20 ngeEncoding(Mem
4150: 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c *, int);.int sql
4160: 69 74 65 33 56 64 62 65 4d 65 6d 54 6f 6f 42 69 ite3VdbeMemTooBi
4170: 67 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c g(Mem*);.int sql
4180: 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79 28 ite3VdbeMemCopy(
4190: 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20 4d 65 6d 2a Mem*, const Mem*
41a0: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 );.void sqlite3V
41b0: 64 62 65 4d 65 6d 53 68 61 6c 6c 6f 77 43 6f 70 dbeMemShallowCop
41c0: 79 28 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20 4d 65 y(Mem*, const Me
41d0: 6d 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73 m*, int);.void s
41e0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 6f 76 qlite3VdbeMemMov
41f0: 65 28 4d 65 6d 2a 2c 20 4d 65 6d 2a 29 3b 0a 69 e(Mem*, Mem*);.i
4200: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 nt sqlite3VdbeMe
4210: 6d 4e 75 6c 54 65 72 6d 69 6e 61 74 65 28 4d 65 mNulTerminate(Me
4220: 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 m*);.int sqlite3
4230: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 4d 65 VdbeMemSetStr(Me
4240: 6d 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c m*, const char*,
4250: 20 69 6e 74 2c 20 75 38 2c 20 76 6f 69 64 28 2a int, u8, void(*
4260: 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f 69 64 20 )(void*));.void
4270: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 sqlite3VdbeMemSe
4280: 74 49 6e 74 36 34 28 4d 65 6d 2a 2c 20 69 36 34 tInt64(Mem*, i64
4290: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 );.void sqlite3V
42a0: 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65 28 dbeMemSetDouble(
42b0: 4d 65 6d 2a 2c 20 64 6f 75 62 6c 65 29 3b 0a 76 Mem*, double);.v
42c0: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d oid sqlite3VdbeM
42d0: 65 6d 53 65 74 4e 75 6c 6c 28 4d 65 6d 2a 29 3b emSetNull(Mem*);
42e0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 .void sqlite3Vdb
42f0: 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62 28 eMemSetZeroBlob(
4300: 4d 65 6d 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 Mem*,int);.int s
4310: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 61 6b qlite3VdbeMemMak
4320: 65 57 72 69 74 65 61 62 6c 65 28 4d 65 6d 2a 29 eWriteable(Mem*)
4330: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 ;.int sqlite3Vdb
4340: 65 4d 65 6d 44 79 6e 61 6d 69 63 69 66 79 28 4d eMemDynamicify(M
4350: 65 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 em*);.int sqlite
4360: 33 56 64 62 65 4d 65 6d 53 74 72 69 6e 67 69 66 3VdbeMemStringif
4370: 79 28 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69 36 y(Mem*, int);.i6
4380: 34 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74 4 sqlite3VdbeInt
4390: 56 61 6c 75 65 28 4d 65 6d 2a 29 3b 0a 69 6e 74 Value(Mem*);.int
43a0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 49 sqlite3VdbeMemI
43b0: 6e 74 65 67 65 72 69 66 79 28 4d 65 6d 2a 29 3b ntegerify(Mem*);
43c0: 0a 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 56 .double sqlite3V
43d0: 64 62 65 52 65 61 6c 56 61 6c 75 65 28 4d 65 6d dbeRealValue(Mem
43e0: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 *);.void sqlite3
43f0: 56 64 62 65 49 6e 74 65 67 65 72 41 66 66 69 6e VdbeIntegerAffin
4400: 69 74 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73 ity(Mem*);.int s
4410: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 61 qlite3VdbeMemRea
4420: 6c 69 66 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 lify(Mem*);.int
4430: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4e 75 sqlite3VdbeMemNu
4440: 6d 65 72 69 66 79 28 4d 65 6d 2a 29 3b 0a 69 6e merify(Mem*);.in
4450: 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d t sqlite3VdbeMem
4460: 46 72 6f 6d 42 74 72 65 65 28 42 74 43 75 72 73 FromBtree(BtCurs
4470: 6f 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c or*,int,int,int,
4480: 4d 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 Mem*);.void sqli
4490: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 te3VdbeMemReleas
44a0: 65 28 4d 65 6d 20 2a 70 29 3b 0a 69 6e 74 20 73 e(Mem *p);.int s
44b0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46 69 6e qlite3VdbeMemFin
44c0: 61 6c 69 7a 65 28 4d 65 6d 2a 2c 20 46 75 6e 63 alize(Mem*, Func
44d0: 44 65 66 2a 29 3b 0a 63 6f 6e 73 74 20 63 68 61 Def*);.const cha
44e0: 72 20 2a 73 71 6c 69 74 65 33 4f 70 63 6f 64 65 r *sqlite3Opcode
44f0: 4e 61 6d 65 28 69 6e 74 29 3b 0a 69 6e 74 20 73 Name(int);.int s
4500: 71 6c 69 74 65 33 56 64 62 65 4f 70 63 6f 64 65 qlite3VdbeOpcode
4510: 48 61 73 50 72 6f 70 65 72 74 79 28 69 6e 74 2c HasProperty(int,
4520: 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 int);.int sqlit
4530: 65 33 56 64 62 65 4d 65 6d 47 72 6f 77 28 4d 65 e3VdbeMemGrow(Me
4540: 6d 20 2a 70 4d 65 6d 2c 20 69 6e 74 20 6e 2c 20 m *pMem, int n,
4550: 69 6e 74 20 70 72 65 73 65 72 76 65 29 3b 0a 0a int preserve);..
4560: 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 20 #ifndef NDEBUG.
4570: 20 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 void sqlite3Vdb
4580: 65 4d 65 6d 53 61 6e 69 74 79 28 4d 65 6d 2a 29 eMemSanity(Mem*)
4590: 3b 0a 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c ;.#endif.int sql
45a0: 69 74 65 33 56 64 62 65 4d 65 6d 54 72 61 6e 73 ite3VdbeMemTrans
45b0: 6c 61 74 65 28 4d 65 6d 2a 2c 20 75 38 29 3b 0a late(Mem*, u8);.
45c0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 #ifdef SQLITE_DE
45d0: 42 55 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 BUG. void sqlit
45e0: 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28 56 e3VdbePrintSql(V
45f0: 64 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 dbe*);. void sq
4600: 6c 69 74 65 33 56 64 62 65 4d 65 6d 50 72 65 74 lite3VdbeMemPret
4610: 74 79 50 72 69 6e 74 28 4d 65 6d 20 2a 70 4d 65 tyPrint(Mem *pMe
4620: 6d 2c 20 63 68 61 72 20 2a 7a 42 75 66 29 3b 0a m, char *zBuf);.
4630: 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 #endif.int sqlit
4640: 65 33 56 64 62 65 4d 65 6d 48 61 6e 64 6c 65 42 e3VdbeMemHandleB
4650: 6f 6d 28 4d 65 6d 20 2a 70 4d 65 6d 29 3b 0a 76 om(Mem *pMem);.v
4660: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 46 oid sqlite3VdbeF
4670: 69 66 6f 49 6e 69 74 28 46 69 66 6f 2a 29 3b 0a ifoInit(Fifo*);.
4680: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 46 int sqlite3VdbeF
4690: 69 66 6f 50 75 73 68 28 46 69 66 6f 2a 2c 20 69 ifoPush(Fifo*, i
46a0: 36 34 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 64);.int sqlite3
46b0: 56 64 62 65 46 69 66 6f 50 6f 70 28 46 69 66 6f VdbeFifoPop(Fifo
46c0: 2a 2c 20 69 36 34 2a 29 3b 0a 76 6f 69 64 20 73 *, i64*);.void s
46d0: 71 6c 69 74 65 33 56 64 62 65 46 69 66 6f 43 6c qlite3VdbeFifoCl
46e0: 65 61 72 28 46 69 66 6f 2a 29 3b 0a 0a 23 69 66 ear(Fifo*);..#if
46f0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 ndef SQLITE_OMIT
4700: 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 69 6e 74 20 _INCRBLOB. int
4710: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 45 78 sqlite3VdbeMemEx
4720: 70 61 6e 64 42 6c 6f 62 28 4d 65 6d 20 2a 29 3b pandBlob(Mem *);
4730: 0a 23 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 .#else. #define
4740: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 45 sqlite3VdbeMemE
4750: 78 70 61 6e 64 42 6c 6f 62 28 78 29 20 53 51 4c xpandBlob(x) SQL
4760: 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 66 0a 0a 23 ITE_OK.#endif..#
4770: 65 6e 64 69 66 20 2f 2a 20 21 64 65 66 69 6e 65 endif /* !define
4780: 64 28 5f 56 44 42 45 49 4e 54 5f 48 5f 29 20 2a d(_VDBEINT_H_) *
4790: 2f 0a /.