/ Hex Artifact Content
Login

Artifact cb02cbbceddf3b40d49012e9f41576f17bcbec97:


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 2f  oKey(X)   (X)../
0390: 2a 0a 2a 2a 20 54 68 65 20 6d 61 6b 65 66 69 6c  *.** The makefil
03a0: 65 20 73 63 61 6e 73 20 74 68 65 20 76 64 62 65  e scans the vdbe
03b0: 2e 63 20 73 6f 75 72 63 65 20 66 69 6c 65 20 61  .c source file a
03c0: 6e 64 20 63 72 65 61 74 65 73 20 74 68 65 20 66  nd creates the f
03d0: 6f 6c 6c 6f 77 69 6e 67 0a 2a 2a 20 61 72 72 61  ollowing.** arra
03e0: 79 20 6f 66 20 73 74 72 69 6e 67 20 63 6f 6e 73  y of string cons
03f0: 74 61 6e 74 73 20 77 68 69 63 68 20 61 72 65 20  tants which are 
0400: 74 68 65 20 6e 61 6d 65 73 20 6f 66 20 61 6c 6c  the names of all
0410: 20 56 44 42 45 20 6f 70 63 6f 64 65 73 2e 20 20   VDBE opcodes.  
0420: 54 68 69 73 0a 2a 2a 20 61 72 72 61 79 20 69 73  This.** array is
0430: 20 64 65 66 69 6e 65 64 20 69 6e 20 61 20 73 65   defined in a se
0440: 70 61 72 61 74 65 20 73 6f 75 72 63 65 20 63 6f  parate source co
0450: 64 65 20 66 69 6c 65 20 6e 61 6d 65 64 20 6f 70  de file named op
0460: 63 6f 64 65 2e 63 20 77 68 69 63 68 20 69 73 0a  code.c which is.
0470: 2a 2a 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  ** automatically
0480: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 74 68   generated by th
0490: 65 20 6d 61 6b 65 66 69 6c 65 2e 0a 2a 2f 0a 65  e makefile..*/.e
04a0: 78 74 65 72 6e 20 63 6f 6e 73 74 20 63 68 61 72  xtern const char
04b0: 20 2a 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 4f   *const sqlite3O
04c0: 70 63 6f 64 65 4e 61 6d 65 73 5b 5d 3b 0a 0a 2f  pcodeNames[];../
04d0: 2a 0a 2a 2a 20 53 51 4c 20 69 73 20 74 72 61 6e  *.** SQL is tran
04e0: 73 6c 61 74 65 64 20 69 6e 74 6f 20 61 20 73 65  slated into a se
04f0: 71 75 65 6e 63 65 20 6f 66 20 69 6e 73 74 72 75  quence of instru
0500: 63 74 69 6f 6e 73 20 74 6f 20 62 65 0a 2a 2a 20  ctions to be.** 
0510: 65 78 65 63 75 74 65 64 20 62 79 20 61 20 76 69  executed by a vi
0520: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 20  rtual machine.  
0530: 45 61 63 68 20 69 6e 73 74 72 75 63 74 69 6f 6e  Each instruction
0540: 20 69 73 20 61 6e 20 69 6e 73 74 61 6e 63 65 0a   is an instance.
0550: 2a 2a 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  ** of the follow
0560: 69 6e 67 20 73 74 72 75 63 74 75 72 65 2e 0a 2a  ing structure..*
0570: 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  /.typedef struct
0580: 20 56 64 62 65 4f 70 20 4f 70 3b 0a 0a 2f 2a 0a   VdbeOp Op;../*.
0590: 2a 2a 20 42 6f 6f 6c 65 61 6e 20 76 61 6c 75 65  ** Boolean value
05a0: 73 0a 2a 2f 0a 74 79 70 65 64 65 66 20 75 6e 73  s.*/.typedef uns
05b0: 69 67 6e 65 64 20 63 68 61 72 20 42 6f 6f 6c 3b  igned char Bool;
05c0: 0a 0a 2f 2a 0a 2a 2a 20 41 20 63 75 72 73 6f 72  ../*.** A cursor
05d0: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 69 6e   is a pointer in
05e0: 74 6f 20 61 20 73 69 6e 67 6c 65 20 42 54 72 65  to a single BTre
05f0: 65 20 77 69 74 68 69 6e 20 61 20 64 61 74 61 62  e within a datab
0600: 61 73 65 20 66 69 6c 65 2e 0a 2a 2a 20 54 68 65  ase file..** The
0610: 20 63 75 72 73 6f 72 20 63 61 6e 20 73 65 65 6b   cursor can seek
0620: 20 74 6f 20 61 20 42 54 72 65 65 20 65 6e 74 72   to a BTree entr
0630: 79 20 77 69 74 68 20 61 20 70 61 72 74 69 63 75  y with a particu
0640: 6c 61 72 20 6b 65 79 2c 20 6f 72 0a 2a 2a 20 6c  lar key, or.** l
0650: 6f 6f 70 20 6f 76 65 72 20 61 6c 6c 20 65 6e 74  oop over all ent
0660: 72 69 65 73 20 6f 66 20 74 68 65 20 42 74 72 65  ries of the Btre
0670: 65 2e 20 20 59 6f 75 20 63 61 6e 20 61 6c 73 6f  e.  You can also
0680: 20 69 6e 73 65 72 74 20 6e 65 77 20 42 54 72 65   insert new BTre
0690: 65 0a 2a 2a 20 65 6e 74 72 69 65 73 20 6f 72 20  e.** entries or 
06a0: 72 65 74 72 69 65 76 65 20 74 68 65 20 6b 65 79  retrieve the key
06b0: 20 6f 72 20 64 61 74 61 20 66 72 6f 6d 20 74 68   or data from th
06c0: 65 20 65 6e 74 72 79 20 74 68 61 74 20 74 68 65  e entry that the
06d0: 20 63 75 72 73 6f 72 0a 2a 2a 20 69 73 20 63 75   cursor.** is cu
06e0: 72 72 65 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67  rrently pointing
06f0: 20 74 6f 2e 0a 2a 2a 20 0a 2a 2a 20 45 76 65 72   to..** .** Ever
0700: 79 20 63 75 72 73 6f 72 20 74 68 61 74 20 74 68  y cursor that th
0710: 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e  e virtual machin
0720: 65 20 68 61 73 20 6f 70 65 6e 20 69 73 20 72 65  e has open is re
0730: 70 72 65 73 65 6e 74 65 64 20 62 79 20 61 6e 0a  presented by an.
0740: 2a 2a 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  ** instance of t
0750: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72  he following str
0760: 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 49 66  ucture..**.** If
0770: 20 74 68 65 20 43 75 72 73 6f 72 2e 69 73 54 72   the Cursor.isTr
0780: 69 67 67 65 72 52 6f 77 20 66 6c 61 67 20 69 73  iggerRow flag is
0790: 20 73 65 74 20 69 74 20 6d 65 61 6e 73 20 74 68   set it means th
07a0: 61 74 20 74 68 69 73 20 63 75 72 73 6f 72 20 69  at this cursor i
07b0: 73 0a 2a 2a 20 72 65 61 6c 6c 79 20 61 20 73 69  s.** really a si
07c0: 6e 67 6c 65 20 72 6f 77 20 74 68 61 74 20 72 65  ngle row that re
07d0: 70 72 65 73 65 6e 74 73 20 74 68 65 20 4e 45 57  presents the NEW
07e0: 20 6f 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d 74   or OLD pseudo-t
07f0: 61 62 6c 65 20 6f 66 0a 2a 2a 20 61 20 72 6f 77  able of.** a row
0800: 20 74 72 69 67 67 65 72 2e 20 20 54 68 65 20 64   trigger.  The d
0810: 61 74 61 20 66 6f 72 20 74 68 65 20 72 6f 77 20  ata for the row 
0820: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 43 75 72  is stored in Cur
0830: 73 6f 72 2e 70 44 61 74 61 20 61 6e 64 0a 2a 2a  sor.pData and.**
0840: 20 74 68 65 20 72 6f 77 69 64 20 69 73 20 69 6e   the rowid is in
0850: 20 43 75 72 73 6f 72 2e 69 4b 65 79 2e 0a 2a 2f   Cursor.iKey..*/
0860: 0a 73 74 72 75 63 74 20 43 75 72 73 6f 72 20 7b  .struct Cursor {
0870: 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75  .  BtCursor *pCu
0880: 72 73 6f 72 3b 20 20 20 20 2f 2a 20 54 68 65 20  rsor;    /* The 
0890: 63 75 72 73 6f 72 20 73 74 72 75 63 74 75 72 65  cursor structure
08a0: 20 6f 66 20 74 68 65 20 62 61 63 6b 65 6e 64 20   of the backend 
08b0: 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20  */.  int iDb;   
08c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e             /* In
08d0: 64 65 78 20 6f 66 20 63 75 72 73 6f 72 20 64 61  dex of cursor da
08e0: 74 61 62 61 73 65 20 69 6e 20 64 62 2d 3e 61 44  tabase in db->aD
08f0: 62 5b 5d 20 28 6f 72 20 2d 31 29 20 2a 2f 0a 20  b[] (or -1) */. 
0900: 20 69 36 34 20 6c 61 73 74 52 6f 77 69 64 3b 20   i64 lastRowid; 
0910: 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20 72         /* Last r
0920: 6f 77 69 64 20 66 72 6f 6d 20 61 20 4e 65 78 74  owid from a Next
0930: 20 6f 72 20 4e 65 78 74 49 64 78 20 6f 70 65 72   or NextIdx oper
0940: 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 36 34 20 6e  ation */.  i64 n
0950: 65 78 74 52 6f 77 69 64 3b 20 20 20 20 20 20 20  extRowid;       
0960: 20 2f 2a 20 4e 65 78 74 20 72 6f 77 69 64 20 72   /* Next rowid r
0970: 65 74 75 72 6e 65 64 20 62 79 20 4f 50 5f 4e 65  eturned by OP_Ne
0980: 77 52 6f 77 69 64 20 2a 2f 0a 20 20 42 6f 6f 6c  wRowid */.  Bool
0990: 20 7a 65 72 6f 65 64 3b 20 20 20 20 20 20 20 20   zeroed;        
09a0: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 7a 65 72    /* True if zer
09b0: 6f 65 64 20 6f 75 74 20 61 6e 64 20 72 65 61 64  oed out and read
09c0: 79 20 66 6f 72 20 72 65 75 73 65 20 2a 2f 0a 20  y for reuse */. 
09d0: 20 42 6f 6f 6c 20 72 6f 77 69 64 49 73 56 61 6c   Bool rowidIsVal
09e0: 69 64 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69  id;    /* True i
09f0: 66 20 6c 61 73 74 52 6f 77 69 64 20 69 73 20 76  f lastRowid is v
0a00: 61 6c 69 64 20 2a 2f 0a 20 20 42 6f 6f 6c 20 61  alid */.  Bool a
0a10: 74 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 20  tFirst;         
0a20: 2f 2a 20 54 72 75 65 20 69 66 20 70 6f 69 6e 74  /* True if point
0a30: 69 6e 67 20 74 6f 20 66 69 72 73 74 20 65 6e 74  ing to first ent
0a40: 72 79 20 2a 2f 0a 20 20 42 6f 6f 6c 20 75 73 65  ry */.  Bool use
0a50: 52 61 6e 64 6f 6d 52 6f 77 69 64 3b 20 20 2f 2a  RandomRowid;  /*
0a60: 20 47 65 6e 65 72 61 74 65 20 6e 65 77 20 72 65   Generate new re
0a70: 63 6f 72 64 20 6e 75 6d 62 65 72 73 20 73 65 6d  cord numbers sem
0a80: 69 2d 72 61 6e 64 6f 6d 6c 79 20 2a 2f 0a 20 20  i-randomly */.  
0a90: 42 6f 6f 6c 20 6e 75 6c 6c 52 6f 77 3b 20 20 20  Bool nullRow;   
0aa0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
0ab0: 20 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 72   pointing to a r
0ac0: 6f 77 20 77 69 74 68 20 6e 6f 20 64 61 74 61 20  ow with no data 
0ad0: 2a 2f 0a 20 20 42 6f 6f 6c 20 6e 65 78 74 52 6f  */.  Bool nextRo
0ae0: 77 69 64 56 61 6c 69 64 3b 20 20 2f 2a 20 54 72  widValid;  /* Tr
0af0: 75 65 20 69 66 20 74 68 65 20 6e 65 78 74 52 6f  ue if the nextRo
0b00: 77 69 64 20 66 69 65 6c 64 20 69 73 20 76 61 6c  wid field is val
0b10: 69 64 20 2a 2f 0a 20 20 42 6f 6f 6c 20 70 73 65  id */.  Bool pse
0b20: 75 64 6f 54 61 62 6c 65 3b 20 20 20 20 20 2f 2a  udoTable;     /*
0b30: 20 54 68 69 73 20 69 73 20 61 20 4e 45 57 20 6f   This is a NEW o
0b40: 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d 74 61 62  r OLD pseudo-tab
0b50: 6c 65 73 20 6f 66 20 61 20 74 72 69 67 67 65 72  les of a trigger
0b60: 20 2a 2f 0a 20 20 42 6f 6f 6c 20 64 65 66 65 72   */.  Bool defer
0b70: 72 65 64 4d 6f 76 65 74 6f 3b 20 20 2f 2a 20 41  redMoveto;  /* A
0b80: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
0b90: 42 74 72 65 65 4d 6f 76 65 74 6f 28 29 20 69 73  BtreeMoveto() is
0ba0: 20 6e 65 65 64 65 64 20 2a 2f 0a 20 20 42 6f 6f   needed */.  Boo
0bb0: 6c 20 69 73 54 61 62 6c 65 3b 20 20 20 20 20 20  l isTable;      
0bc0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 20     /* True if a 
0bd0: 74 61 62 6c 65 20 72 65 71 75 69 72 69 6e 67 20  table requiring 
0be0: 69 6e 74 65 67 65 72 20 6b 65 79 73 20 2a 2f 0a  integer keys */.
0bf0: 20 20 42 6f 6f 6c 20 69 73 49 6e 64 65 78 3b 20    Bool isIndex; 
0c00: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20          /* True 
0c10: 69 66 20 61 6e 20 69 6e 64 65 78 20 63 6f 6e 74  if an index cont
0c20: 61 69 6e 69 6e 67 20 6b 65 79 73 20 6f 6e 6c 79  aining keys only
0c30: 20 2d 20 6e 6f 20 64 61 74 61 20 2a 2f 0a 20 20   - no data */.  
0c40: 75 38 20 62 6f 67 75 73 49 6e 63 72 4b 65 79 3b  u8 bogusIncrKey;
0c50: 20 20 20 20 20 20 2f 2a 20 53 6f 6d 65 74 68 69        /* Somethi
0c60: 6e 67 20 66 6f 72 20 70 49 6e 63 72 4b 65 79 20  ng for pIncrKey 
0c70: 74 6f 20 70 6f 69 6e 74 20 74 6f 20 69 66 20 70  to point to if p
0c80: 4b 65 79 49 6e 66 6f 3d 3d 30 20 2a 2f 0a 20 20  KeyInfo==0 */.  
0c90: 69 36 34 20 6d 6f 76 65 74 6f 54 61 72 67 65 74  i64 movetoTarget
0ca0: 3b 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e  ;     /* Argumen
0cb0: 74 20 74 6f 20 74 68 65 20 64 65 66 65 72 72 65  t to the deferre
0cc0: 64 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f  d sqlite3BtreeMo
0cd0: 76 65 74 6f 28 29 20 2a 2f 0a 20 20 42 74 72 65  veto() */.  Btre
0ce0: 65 20 2a 70 42 74 3b 20 20 20 20 20 20 20 20 20  e *pBt;         
0cf0: 20 20 2f 2a 20 53 65 70 61 72 61 74 65 20 66 69    /* Separate fi
0d00: 6c 65 20 68 6f 6c 64 69 6e 67 20 74 65 6d 70 6f  le holding tempo
0d10: 72 61 72 79 20 74 61 62 6c 65 20 2a 2f 0a 20 20  rary table */.  
0d20: 69 6e 74 20 6e 44 61 74 61 3b 20 20 20 20 20 20  int nData;      
0d30: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
0d40: 6f 66 20 62 79 74 65 73 20 69 6e 20 70 44 61 74  of bytes in pDat
0d50: 61 20 2a 2f 0a 20 20 63 68 61 72 20 2a 70 44 61  a */.  char *pDa
0d60: 74 61 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ta;          /* 
0d70: 44 61 74 61 20 66 6f 72 20 61 20 4e 45 57 20 6f  Data for a NEW o
0d80: 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d 74 61 62  r OLD pseudo-tab
0d90: 6c 65 20 2a 2f 0a 20 20 69 36 34 20 69 4b 65 79  le */.  i64 iKey
0da0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
0db0: 20 4b 65 79 20 66 6f 72 20 74 68 65 20 4e 45 57   Key for the NEW
0dc0: 20 6f 72 20 4f 4c 44 20 70 73 65 75 64 6f 2d 74   or OLD pseudo-t
0dd0: 61 62 6c 65 20 72 6f 77 20 2a 2f 0a 20 20 75 38  able row */.  u8
0de0: 20 2a 70 49 6e 63 72 4b 65 79 3b 20 20 20 20 20   *pIncrKey;     
0df0: 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74      /* Pointer t
0e00: 6f 20 70 4b 65 79 49 6e 66 6f 2d 3e 69 6e 63 72  o pKeyInfo->incr
0e10: 4b 65 79 20 2a 2f 0a 20 20 4b 65 79 49 6e 66 6f  Key */.  KeyInfo
0e20: 20 2a 70 4b 65 79 49 6e 66 6f 3b 20 20 20 20 2f   *pKeyInfo;    /
0e30: 2a 20 49 6e 66 6f 20 61 62 6f 75 74 20 69 6e 64  * Info about ind
0e40: 65 78 20 6b 65 79 73 20 6e 65 65 64 65 64 20 62  ex keys needed b
0e50: 79 20 69 6e 64 65 78 20 63 75 72 73 6f 72 73 20  y index cursors 
0e60: 2a 2f 0a 20 20 69 6e 74 20 6e 46 69 65 6c 64 3b  */.  int nField;
0e70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
0e80: 6d 62 65 72 20 6f 66 20 66 69 65 6c 64 73 20 69  mber of fields i
0e90: 6e 20 74 68 65 20 68 65 61 64 65 72 20 2a 2f 0a  n the header */.
0ea0: 20 20 69 36 34 20 73 65 71 43 6f 75 6e 74 3b 20    i64 seqCount; 
0eb0: 20 20 20 20 20 20 20 20 2f 2a 20 53 65 71 75 65          /* Seque
0ec0: 6e 63 65 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20  nce counter */. 
0ed0: 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75   sqlite3_vtab_cu
0ee0: 72 73 6f 72 20 2a 70 56 74 61 62 43 75 72 73 6f  rsor *pVtabCurso
0ef0: 72 3b 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f  r;  /* The curso
0f00: 72 20 66 6f 72 20 61 20 76 69 72 74 75 61 6c 20  r for a virtual 
0f10: 74 61 62 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74  table */.  const
0f20: 20 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20   sqlite3_module 
0f30: 2a 70 4d 6f 64 75 6c 65 3b 20 20 20 20 20 2f 2a  *pModule;     /*
0f40: 20 4d 6f 64 75 6c 65 20 66 6f 72 20 63 75 72 73   Module for curs
0f50: 6f 72 20 70 56 74 61 62 43 75 72 73 6f 72 20 2a  or pVtabCursor *
0f60: 2f 0a 0a 20 20 2f 2a 20 43 61 63 68 65 64 20 69  /..  /* Cached i
0f70: 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74  nformation about
0f80: 20 74 68 65 20 68 65 61 64 65 72 20 66 6f 72 20   the header for 
0f90: 74 68 65 20 64 61 74 61 20 72 65 63 6f 72 64 20  the data record 
0fa0: 74 68 61 74 20 74 68 65 0a 20 20 2a 2a 20 63 75  that the.  ** cu
0fb0: 72 73 6f 72 20 69 73 20 63 75 72 72 65 6e 74 6c  rsor is currentl
0fc0: 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 20 20  y pointing to.  
0fd0: 4f 6e 6c 79 20 76 61 6c 69 64 20 69 66 20 63 61  Only valid if ca
0fe0: 63 68 65 56 61 6c 69 64 20 69 73 20 74 72 75 65  cheValid is true
0ff0: 2e 0a 20 20 2a 2a 20 61 52 6f 77 20 6d 69 67 68  ..  ** aRow migh
1000: 74 20 70 6f 69 6e 74 20 74 6f 20 28 65 70 68 65  t point to (ephe
1010: 6d 65 72 61 6c 29 20 64 61 74 61 20 66 6f 72 20  meral) data for 
1020: 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f 77 2c  the current row,
1030: 20 6f 72 20 69 74 20 6d 69 67 68 74 0a 20 20 2a   or it might.  *
1040: 2a 20 62 65 20 4e 55 4c 4c 2e 0a 20 20 2a 2f 0a  * be NULL..  */.
1050: 20 20 69 6e 74 20 63 61 63 68 65 53 74 61 74 75    int cacheStatu
1060: 73 3b 20 20 20 20 20 20 2f 2a 20 43 61 63 68 65  s;      /* Cache
1070: 20 69 73 20 76 61 6c 69 64 20 69 66 20 74 68 69   is valid if thi
1080: 73 20 6d 61 74 63 68 65 73 20 56 64 62 65 2e 63  s matches Vdbe.c
1090: 61 63 68 65 43 74 72 20 2a 2f 0a 20 20 69 6e 74  acheCtr */.  int
10a0: 20 70 61 79 6c 6f 61 64 53 69 7a 65 3b 20 20 20   payloadSize;   
10b0: 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d 62     /* Total numb
10c0: 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 74  er of bytes in t
10d0: 68 65 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 75  he record */.  u
10e0: 33 32 20 2a 61 54 79 70 65 3b 20 20 20 20 20 20  32 *aType;      
10f0: 20 20 20 20 20 2f 2a 20 54 79 70 65 20 76 61 6c       /* Type val
1100: 75 65 73 20 66 6f 72 20 61 6c 6c 20 65 6e 74 72  ues for all entr
1110: 69 65 73 20 69 6e 20 74 68 65 20 72 65 63 6f 72  ies in the recor
1120: 64 20 2a 2f 0a 20 20 75 33 32 20 2a 61 4f 66 66  d */.  u32 *aOff
1130: 73 65 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20  set;         /* 
1140: 43 61 63 68 65 64 20 6f 66 66 73 65 74 73 20 74  Cached offsets t
1150: 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 65  o the start of e
1160: 61 63 68 20 63 6f 6c 75 6d 6e 73 20 64 61 74 61  ach columns data
1170: 20 2a 2f 0a 20 20 75 38 20 2a 61 52 6f 77 3b 20   */.  u8 *aRow; 
1180: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
1190: 61 74 61 20 66 6f 72 20 74 68 65 20 63 75 72 72  ata for the curr
11a0: 65 6e 74 20 72 6f 77 2c 20 69 66 20 61 6c 6c 20  ent row, if all 
11b0: 6f 6e 20 6f 6e 65 20 70 61 67 65 20 2a 2f 0a 7d  on one page */.}
11c0: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ;.typedef struct
11d0: 20 43 75 72 73 6f 72 20 43 75 72 73 6f 72 3b 0a   Cursor Cursor;.
11e0: 0a 2f 2a 0a 2a 2a 20 4e 75 6d 62 65 72 20 6f 66  ./*.** Number of
11f0: 20 62 79 74 65 73 20 6f 66 20 73 74 72 69 6e 67   bytes of string
1200: 20 73 74 6f 72 61 67 65 20 73 70 61 63 65 20 61   storage space a
1210: 76 61 69 6c 61 62 6c 65 20 74 6f 20 65 61 63 68  vailable to each
1220: 20 73 74 61 63 6b 0a 2a 2a 20 6c 61 79 65 72 20   stack.** layer 
1230: 77 69 74 68 6f 75 74 20 68 61 76 69 6e 67 20 74  without having t
1240: 6f 20 6d 61 6c 6c 6f 63 2e 20 20 4e 42 46 53 20  o malloc.  NBFS 
1250: 69 73 20 73 68 6f 72 74 20 66 6f 72 20 4e 75 6d  is short for Num
1260: 62 65 72 20 6f 66 20 42 79 74 65 73 0a 2a 2a 20  ber of Bytes.** 
1270: 46 6f 72 20 53 74 72 69 6e 67 73 2e 0a 2a 2f 0a  For Strings..*/.
1280: 23 64 65 66 69 6e 65 20 4e 42 46 53 20 33 32 0a  #define NBFS 32.
1290: 0a 2f 2a 0a 2a 2a 20 41 20 76 61 6c 75 65 20 66  ./*.** A value f
12a0: 6f 72 20 43 75 72 73 6f 72 2e 63 61 63 68 65 56  or Cursor.cacheV
12b0: 61 6c 69 64 20 74 68 61 74 20 6d 65 61 6e 73 20  alid that means 
12c0: 74 68 65 20 63 61 63 68 65 20 69 73 20 61 6c 77  the cache is alw
12d0: 61 79 73 20 69 6e 76 61 6c 69 64 2e 0a 2a 2f 0a  ays invalid..*/.
12e0: 23 64 65 66 69 6e 65 20 43 41 43 48 45 5f 53 54  #define CACHE_ST
12f0: 41 4c 45 20 30 0a 0a 2f 2a 0a 2a 2a 20 49 6e 74  ALE 0../*.** Int
1300: 65 72 6e 61 6c 6c 79 2c 20 74 68 65 20 76 64 62  ernally, the vdb
1310: 65 20 6d 61 6e 69 70 75 6c 61 74 65 73 20 6e 65  e manipulates ne
1320: 61 72 6c 79 20 61 6c 6c 20 53 51 4c 20 76 61 6c  arly all SQL val
1330: 75 65 73 20 61 73 20 4d 65 6d 0a 2a 2a 20 73 74  ues as Mem.** st
1340: 72 75 63 74 75 72 65 73 2e 20 45 61 63 68 20 4d  ructures. Each M
1350: 65 6d 20 73 74 72 75 63 74 20 6d 61 79 20 63 61  em struct may ca
1360: 63 68 65 20 6d 75 6c 74 69 70 6c 65 20 72 65 70  che multiple rep
1370: 72 65 73 65 6e 74 61 74 69 6f 6e 73 20 28 73 74  resentations (st
1380: 72 69 6e 67 2c 0a 2a 2a 20 69 6e 74 65 67 65 72  ring,.** integer
1390: 20 65 74 63 2e 29 20 6f 66 20 74 68 65 20 73 61   etc.) of the sa
13a0: 6d 65 20 76 61 6c 75 65 2e 20 20 41 20 76 61 6c  me value.  A val
13b0: 75 65 20 28 61 6e 64 20 74 68 65 72 65 66 6f 72  ue (and therefor
13c0: 65 20 4d 65 6d 20 73 74 72 75 63 74 75 72 65 29  e Mem structure)
13d0: 0a 2a 2a 20 68 61 73 20 74 68 65 20 66 6f 6c 6c  .** has the foll
13e0: 6f 77 69 6e 67 20 70 72 6f 70 65 72 74 69 65 73  owing properties
13f0: 3a 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 76 61 6c  :.**.** Each val
1400: 75 65 20 68 61 73 20 61 20 6d 61 6e 69 66 65 73  ue has a manifes
1410: 74 20 74 79 70 65 2e 20 54 68 65 20 6d 61 6e 69  t type. The mani
1420: 66 65 73 74 20 74 79 70 65 20 6f 66 20 74 68 65  fest type of the
1430: 20 76 61 6c 75 65 20 73 74 6f 72 65 64 0a 2a 2a   value stored.**
1440: 20 69 6e 20 61 20 4d 65 6d 20 73 74 72 75 63 74   in a Mem struct
1450: 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20   is returned by 
1460: 74 68 65 20 4d 65 6d 54 79 70 65 28 4d 65 6d 2a  the MemType(Mem*
1470: 29 20 6d 61 63 72 6f 2e 20 54 68 65 20 74 79 70  ) macro. The typ
1480: 65 20 69 73 0a 2a 2a 20 6f 6e 65 20 6f 66 20 53  e is.** one of S
1490: 51 4c 49 54 45 5f 4e 55 4c 4c 2c 20 53 51 4c 49  QLITE_NULL, SQLI
14a0: 54 45 5f 49 4e 54 45 47 45 52 2c 20 53 51 4c 49  TE_INTEGER, SQLI
14b0: 54 45 5f 52 45 41 4c 2c 20 53 51 4c 49 54 45 5f  TE_REAL, SQLITE_
14c0: 54 45 58 54 20 6f 72 0a 2a 2a 20 53 51 4c 49 54  TEXT or.** SQLIT
14d0: 45 5f 42 4c 4f 42 2e 0a 2a 2f 0a 73 74 72 75 63  E_BLOB..*/.struc
14e0: 74 20 4d 65 6d 20 7b 0a 20 20 75 6e 69 6f 6e 20  t Mem {.  union 
14f0: 7b 0a 20 20 20 20 69 36 34 20 69 3b 20 20 20 20  {.    i64 i;    
1500: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 74            /* Int
1510: 65 67 65 72 20 76 61 6c 75 65 2e 20 4f 72 20 46  eger value. Or F
1520: 75 6e 63 44 65 66 2a 20 77 68 65 6e 20 66 6c 61  uncDef* when fla
1530: 67 73 3d 3d 4d 45 4d 5f 41 67 67 20 2a 2f 0a 20  gs==MEM_Agg */. 
1540: 20 20 20 46 75 6e 63 44 65 66 20 2a 70 44 65 66     FuncDef *pDef
1550: 3b 20 20 20 20 20 20 2f 2a 20 55 73 65 64 20 6f  ;      /* Used o
1560: 6e 6c 79 20 77 68 65 6e 20 66 6c 61 67 73 3d 3d  nly when flags==
1570: 4d 45 4d 5f 41 67 67 20 2a 2f 0a 20 20 7d 20 75  MEM_Agg */.  } u
1580: 3b 0a 20 20 64 6f 75 62 6c 65 20 72 3b 20 20 20  ;.  double r;   
1590: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 6c 20          /* Real 
15a0: 76 61 6c 75 65 20 2a 2f 0a 20 20 63 68 61 72 20  value */.  char 
15b0: 2a 7a 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  *z;            /
15c0: 2a 20 53 74 72 69 6e 67 20 6f 72 20 42 4c 4f 42  * String or BLOB
15d0: 20 76 61 6c 75 65 20 2a 2f 0a 20 20 69 6e 74 20   value */.  int 
15e0: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  n;              
15f0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 68 61  /* Number of cha
1600: 72 61 63 74 65 72 73 20 69 6e 20 73 74 72 69 6e  racters in strin
1610: 67 20 76 61 6c 75 65 2c 20 69 6e 63 6c 75 64 69  g value, includi
1620: 6e 67 20 27 5c 30 27 20 2a 2f 0a 20 20 75 31 36  ng '\0' */.  u16
1630: 20 66 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20   flags;         
1640: 20 2f 2a 20 53 6f 6d 65 20 63 6f 6d 62 69 6e 61   /* Some combina
1650: 74 69 6f 6e 20 6f 66 20 4d 45 4d 5f 4e 75 6c 6c  tion of MEM_Null
1660: 2c 20 4d 45 4d 5f 53 74 72 2c 20 4d 45 4d 5f 44  , MEM_Str, MEM_D
1670: 79 6e 2c 20 65 74 63 2e 20 2a 2f 0a 20 20 75 38  yn, etc. */.  u8
1680: 20 20 74 79 70 65 3b 20 20 20 20 20 20 20 20 20    type;         
1690: 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 53 51 4c 49    /* One of SQLI
16a0: 54 45 5f 4e 55 4c 4c 2c 20 53 51 4c 49 54 45 5f  TE_NULL, SQLITE_
16b0: 54 45 58 54 2c 20 53 51 4c 49 54 45 5f 49 4e 54  TEXT, SQLITE_INT
16c0: 45 47 45 52 2c 20 65 74 63 20 2a 2f 0a 20 20 75  EGER, etc */.  u
16d0: 38 20 20 65 6e 63 3b 20 20 20 20 20 20 20 20 20  8  enc;         
16e0: 20 20 20 2f 2a 20 53 51 4c 49 54 45 5f 55 54 46     /* SQLITE_UTF
16f0: 38 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 42  8, SQLITE_UTF16B
1700: 45 2c 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4c  E, SQLITE_UTF16L
1710: 45 20 2a 2f 0a 20 20 76 6f 69 64 20 28 2a 78 44  E */.  void (*xD
1720: 65 6c 29 28 76 6f 69 64 20 2a 29 3b 20 20 2f 2a  el)(void *);  /*
1730: 20 49 66 20 6e 6f 74 20 6e 75 6c 6c 2c 20 63 61   If not null, ca
1740: 6c 6c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  ll this function
1750: 20 74 6f 20 64 65 6c 65 74 65 20 4d 65 6d 2e 7a   to delete Mem.z
1760: 20 2a 2f 0a 20 20 63 68 61 72 20 7a 53 68 6f 72   */.  char zShor
1770: 74 5b 4e 42 46 53 5d 3b 20 20 2f 2a 20 53 70 61  t[NBFS];  /* Spa
1780: 63 65 20 66 6f 72 20 73 68 6f 72 74 20 73 74 72  ce for short str
1790: 69 6e 67 73 20 2a 2f 0a 7d 3b 0a 74 79 70 65 64  ings */.};.typed
17a0: 65 66 20 73 74 72 75 63 74 20 4d 65 6d 20 4d 65  ef struct Mem Me
17b0: 6d 3b 0a 0a 2f 2a 20 4f 6e 65 20 6f 72 20 6d 6f  m;../* One or mo
17c0: 72 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  re of the follow
17d0: 69 6e 67 20 66 6c 61 67 73 20 61 72 65 20 73 65  ing flags are se
17e0: 74 20 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68  t to indicate th
17f0: 65 20 76 61 6c 69 64 4f 4b 0a 2a 2a 20 72 65 70  e validOK.** rep
1800: 72 65 73 65 6e 74 61 74 69 6f 6e 73 20 6f 66 20  resentations of 
1810: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64  the value stored
1820: 20 69 6e 20 74 68 65 20 4d 65 6d 20 73 74 72 75   in the Mem stru
1830: 63 74 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65  ct..**.** If the
1840: 20 4d 45 4d 5f 4e 75 6c 6c 20 66 6c 61 67 20 69   MEM_Null flag i
1850: 73 20 73 65 74 2c 20 74 68 65 6e 20 74 68 65 20  s set, then the 
1860: 76 61 6c 75 65 20 69 73 20 61 6e 20 53 51 4c 20  value is an SQL 
1870: 4e 55 4c 4c 20 76 61 6c 75 65 2e 0a 2a 2a 20 4e  NULL value..** N
1880: 6f 20 6f 74 68 65 72 20 66 6c 61 67 73 20 6d 61  o other flags ma
1890: 79 20 62 65 20 73 65 74 20 69 6e 20 74 68 69 73  y be set in this
18a0: 20 63 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20   case..**.** If 
18b0: 74 68 65 20 4d 45 4d 5f 53 74 72 20 66 6c 61 67  the MEM_Str flag
18c0: 20 69 73 20 73 65 74 20 74 68 65 6e 20 4d 65 6d   is set then Mem
18d0: 2e 7a 20 70 6f 69 6e 74 73 20 61 74 20 61 20 73  .z points at a s
18e0: 74 72 69 6e 67 20 72 65 70 72 65 73 65 6e 74 61  tring representa
18f0: 74 69 6f 6e 2e 0a 2a 2a 20 55 73 75 61 6c 6c 79  tion..** Usually
1900: 20 74 68 69 73 20 69 73 20 65 6e 63 6f 64 65 64   this is encoded
1910: 20 69 6e 20 74 68 65 20 73 61 6d 65 20 75 6e 69   in the same uni
1920: 63 6f 64 65 20 65 6e 63 6f 64 69 6e 67 20 61 73  code encoding as
1930: 20 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 64 61 74   the main.** dat
1940: 61 62 61 73 65 20 28 73 65 65 20 62 65 6c 6f 77  abase (see below
1950: 20 66 6f 72 20 65 78 63 65 70 74 69 6f 6e 73 29   for exceptions)
1960: 2e 20 49 66 20 74 68 65 20 4d 45 4d 5f 54 65 72  . If the MEM_Ter
1970: 6d 20 66 6c 61 67 20 69 73 20 61 6c 73 6f 0a 2a  m flag is also.*
1980: 2a 20 73 65 74 2c 20 74 68 65 6e 20 74 68 65 20  * set, then the 
1990: 73 74 72 69 6e 67 20 69 73 20 6e 75 6c 20 74 65  string is nul te
19a0: 72 6d 69 6e 61 74 65 64 2e 20 54 68 65 20 4d 45  rminated. The ME
19b0: 4d 5f 49 6e 74 20 61 6e 64 20 4d 45 4d 5f 52 65  M_Int and MEM_Re
19c0: 61 6c 20 0a 2a 2a 20 66 6c 61 67 73 20 6d 61 79  al .** flags may
19d0: 20 63 6f 65 78 69 73 74 20 77 69 74 68 20 74 68   coexist with th
19e0: 65 20 4d 45 4d 5f 53 74 72 20 66 6c 61 67 2e 0a  e MEM_Str flag..
19f0: 2a 2a 0a 2a 2a 20 4d 75 6c 74 69 70 6c 65 20 6f  **.** Multiple o
1a00: 66 20 74 68 65 73 65 20 76 61 6c 75 65 73 20 63  f these values c
1a10: 61 6e 20 61 70 70 65 61 72 20 69 6e 20 4d 65 6d  an appear in Mem
1a20: 2e 66 6c 61 67 73 2e 20 20 42 75 74 20 6f 6e 6c  .flags.  But onl
1a30: 79 20 6f 6e 65 0a 2a 2a 20 61 74 20 61 20 74 69  y one.** at a ti
1a40: 6d 65 20 63 61 6e 20 61 70 70 65 61 72 20 69 6e  me can appear in
1a50: 20 4d 65 6d 2e 74 79 70 65 2e 0a 2a 2f 0a 23 64   Mem.type..*/.#d
1a60: 65 66 69 6e 65 20 4d 45 4d 5f 4e 75 6c 6c 20 20  efine MEM_Null  
1a70: 20 20 20 20 30 78 30 30 30 31 20 20 20 2f 2a 20      0x0001   /* 
1a80: 56 61 6c 75 65 20 69 73 20 4e 55 4c 4c 20 2a 2f  Value is NULL */
1a90: 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 53 74 72  .#define MEM_Str
1aa0: 20 20 20 20 20 20 20 30 78 30 30 30 32 20 20 20         0x0002   
1ab0: 2f 2a 20 56 61 6c 75 65 20 69 73 20 61 20 73 74  /* Value is a st
1ac0: 72 69 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20  ring */.#define 
1ad0: 4d 45 4d 5f 49 6e 74 20 20 20 20 20 20 20 30 78  MEM_Int       0x
1ae0: 30 30 30 34 20 20 20 2f 2a 20 56 61 6c 75 65 20  0004   /* Value 
1af0: 69 73 20 61 6e 20 69 6e 74 65 67 65 72 20 2a 2f  is an integer */
1b00: 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 52 65 61  .#define MEM_Rea
1b10: 6c 20 20 20 20 20 20 30 78 30 30 30 38 20 20 20  l      0x0008   
1b20: 2f 2a 20 56 61 6c 75 65 20 69 73 20 61 20 72 65  /* Value is a re
1b30: 61 6c 20 6e 75 6d 62 65 72 20 2a 2f 0a 23 64 65  al number */.#de
1b40: 66 69 6e 65 20 4d 45 4d 5f 42 6c 6f 62 20 20 20  fine MEM_Blob   
1b50: 20 20 20 30 78 30 30 31 30 20 20 20 2f 2a 20 56     0x0010   /* V
1b60: 61 6c 75 65 20 69 73 20 61 20 42 4c 4f 42 20 2a  alue is a BLOB *
1b70: 2f 0a 0a 2f 2a 20 57 68 65 6e 65 76 65 72 20 4d  /../* Whenever M
1b80: 65 6d 20 63 6f 6e 74 61 69 6e 73 20 61 20 76 61  em contains a va
1b90: 6c 69 64 20 73 74 72 69 6e 67 20 6f 72 20 62 6c  lid string or bl
1ba0: 6f 62 20 72 65 70 72 65 73 65 6e 74 61 74 69 6f  ob representatio
1bb0: 6e 2c 20 6f 6e 65 20 6f 66 0a 2a 2a 20 74 68 65  n, one of.** the
1bc0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6c 61 67 73   following flags
1bd0: 20 6d 75 73 74 20 62 65 20 73 65 74 20 74 6f 20   must be set to 
1be0: 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20 6d 65  determine the me
1bf0: 6d 6f 72 79 20 6d 61 6e 61 67 65 6d 65 6e 74 0a  mory management.
1c00: 2a 2a 20 70 6f 6c 69 63 79 20 66 6f 72 20 4d 65  ** policy for Me
1c10: 6d 2e 7a 2e 20 20 54 68 65 20 4d 45 4d 5f 54 65  m.z.  The MEM_Te
1c20: 72 6d 20 66 6c 61 67 20 74 65 6c 6c 73 20 75 73  rm flag tells us
1c30: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
1c40: 74 68 65 0a 2a 2a 20 73 74 72 69 6e 67 20 69 73  the.** string is
1c50: 20 5c 30 30 30 20 6f 72 20 5c 75 30 30 30 30 20   \000 or \u0000 
1c60: 74 65 72 6d 69 6e 61 74 65 64 0a 2a 2f 0a 23 64  terminated.*/.#d
1c70: 65 66 69 6e 65 20 4d 45 4d 5f 54 65 72 6d 20 20  efine MEM_Term  
1c80: 20 20 20 20 30 78 30 30 32 30 20 20 20 2f 2a 20      0x0020   /* 
1c90: 53 74 72 69 6e 67 20 72 65 70 20 69 73 20 6e 75  String rep is nu
1ca0: 6c 20 74 65 72 6d 69 6e 61 74 65 64 20 2a 2f 0a  l terminated */.
1cb0: 23 64 65 66 69 6e 65 20 4d 45 4d 5f 44 79 6e 20  #define MEM_Dyn 
1cc0: 20 20 20 20 20 20 30 78 30 30 34 30 20 20 20 2f        0x0040   /
1cd0: 2a 20 4e 65 65 64 20 74 6f 20 63 61 6c 6c 20 73  * Need to call s
1ce0: 71 6c 69 74 65 46 72 65 65 28 29 20 6f 6e 20 4d  qliteFree() on M
1cf0: 65 6d 2e 7a 20 2a 2f 0a 23 64 65 66 69 6e 65 20  em.z */.#define 
1d00: 4d 45 4d 5f 53 74 61 74 69 63 20 20 20 20 30 78  MEM_Static    0x
1d10: 30 30 38 30 20 20 20 2f 2a 20 4d 65 6d 2e 7a 20  0080   /* Mem.z 
1d20: 70 6f 69 6e 74 73 20 74 6f 20 61 20 73 74 61 74  points to a stat
1d30: 69 63 20 73 74 72 69 6e 67 20 2a 2f 0a 23 64 65  ic string */.#de
1d40: 66 69 6e 65 20 4d 45 4d 5f 45 70 68 65 6d 20 20  fine MEM_Ephem  
1d50: 20 20 20 30 78 30 31 30 30 20 20 20 2f 2a 20 4d     0x0100   /* M
1d60: 65 6d 2e 7a 20 70 6f 69 6e 74 73 20 74 6f 20 61  em.z points to a
1d70: 6e 20 65 70 68 65 6d 65 72 61 6c 20 73 74 72 69  n ephemeral stri
1d80: 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45  ng */.#define ME
1d90: 4d 5f 53 68 6f 72 74 20 20 20 20 20 30 78 30 32  M_Short     0x02
1da0: 30 30 20 20 20 2f 2a 20 4d 65 6d 2e 7a 20 70 6f  00   /* Mem.z po
1db0: 69 6e 74 73 20 74 6f 20 4d 65 6d 2e 7a 53 68 6f  ints to Mem.zSho
1dc0: 72 74 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45  rt */.#define ME
1dd0: 4d 5f 41 67 67 20 20 20 20 20 20 20 30 78 30 34  M_Agg       0x04
1de0: 30 30 20 20 20 2f 2a 20 4d 65 6d 2e 7a 20 70 6f  00   /* Mem.z po
1df0: 69 6e 74 73 20 74 6f 20 61 6e 20 61 67 67 20 66  ints to an agg f
1e00: 75 6e 63 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20  unction context 
1e10: 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 5a  */.#define MEM_Z
1e20: 65 72 6f 20 20 20 20 20 20 30 78 30 38 30 30 20  ero      0x0800 
1e30: 20 20 2f 2a 20 4d 65 6d 2e 69 20 63 6f 6e 74 61    /* Mem.i conta
1e40: 69 6e 73 20 63 6f 75 6e 74 20 6f 66 20 30 73 20  ins count of 0s 
1e50: 61 70 70 65 6e 64 65 64 20 74 6f 20 62 6c 6f 62  appended to blob
1e60: 20 2a 2f 0a 0a 0a 2f 2a 20 41 20 56 64 62 65 46   */.../* A VdbeF
1e70: 75 6e 63 20 69 73 20 6a 75 73 74 20 61 20 46 75  unc is just a Fu
1e80: 6e 63 44 65 66 20 28 64 65 66 69 6e 65 64 20 69  ncDef (defined i
1e90: 6e 20 73 71 6c 69 74 65 49 6e 74 2e 68 29 20 74  n sqliteInt.h) t
1ea0: 68 61 74 20 63 6f 6e 74 61 69 6e 73 0a 2a 2a 20  hat contains.** 
1eb0: 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72  additional infor
1ec0: 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 61 75 78  mation about aux
1ed0: 69 6c 69 61 72 79 20 69 6e 66 6f 72 6d 61 74 69  iliary informati
1ee0: 6f 6e 20 62 6f 75 6e 64 20 74 6f 20 61 72 67 75  on bound to argu
1ef0: 6d 65 6e 74 73 0a 2a 2a 20 6f 66 20 74 68 65 20  ments.** of the 
1f00: 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 20  function.  This 
1f10: 69 73 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65  is used to imple
1f20: 6d 65 6e 74 20 74 68 65 20 73 71 6c 69 74 65 33  ment the sqlite3
1f30: 5f 67 65 74 5f 61 75 78 64 61 74 61 28 29 0a 2a  _get_auxdata().*
1f40: 2a 20 61 6e 64 20 73 71 6c 69 74 65 33 5f 73 65  * and sqlite3_se
1f50: 74 5f 61 75 78 64 61 74 61 28 29 20 41 50 49 73  t_auxdata() APIs
1f60: 2e 20 20 54 68 65 20 22 61 75 78 64 61 74 61 22  .  The "auxdata"
1f70: 20 69 73 20 73 6f 6d 65 20 61 75 78 69 6c 69 61   is some auxilia
1f80: 72 79 20 64 61 74 61 0a 2a 2a 20 74 68 61 74 20  ry data.** that 
1f90: 63 61 6e 20 62 65 20 61 73 73 6f 63 69 61 74 65  can be associate
1fa0: 64 20 77 69 74 68 20 61 20 63 6f 6e 73 74 61 6e  d with a constan
1fb0: 74 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 61 20  t argument to a 
1fc0: 66 75 6e 63 74 69 6f 6e 2e 20 20 54 68 69 73 0a  function.  This.
1fd0: 2a 2a 20 61 6c 6c 6f 77 73 20 66 75 6e 63 74 69  ** allows functi
1fe0: 6f 6e 73 20 73 75 63 68 20 61 73 20 22 72 65 67  ons such as "reg
1ff0: 65 78 70 22 20 74 6f 20 63 6f 6d 70 69 6c 65 20  exp" to compile 
2000: 74 68 65 69 72 20 63 6f 6e 73 74 61 6e 74 20 72  their constant r
2010: 65 67 75 6c 61 72 0a 2a 2a 20 65 78 70 72 65 73  egular.** expres
2020: 73 69 6f 6e 20 61 72 67 75 6d 65 6e 74 20 6f 6e  sion argument on
2030: 63 65 20 61 6e 64 20 72 65 75 73 65 64 20 74 68  ce and reused th
2040: 65 20 63 6f 6d 70 69 6c 65 64 20 63 6f 64 65 20  e compiled code 
2050: 66 6f 72 20 6d 75 6c 74 69 70 6c 65 0a 2a 2a 20  for multiple.** 
2060: 69 6e 76 6f 63 61 74 69 6f 6e 73 2e 0a 2a 2f 0a  invocations..*/.
2070: 73 74 72 75 63 74 20 56 64 62 65 46 75 6e 63 20  struct VdbeFunc 
2080: 7b 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75  {.  FuncDef *pFu
2090: 6e 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  nc;             
20a0: 20 20 2f 2a 20 54 68 65 20 64 65 66 69 6e 69 74    /* The definit
20b0: 69 6f 6e 20 6f 66 20 74 68 65 20 66 75 6e 63 74  ion of the funct
20c0: 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 41 75  ion */.  int nAu
20d0: 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  x;              
20e0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
20f0: 20 6f 66 20 65 6e 74 72 69 65 73 20 61 6c 6c 6f   of entries allo
2100: 63 61 74 65 64 20 66 6f 72 20 61 70 41 75 78 5b  cated for apAux[
2110: 5d 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 41 75  ] */.  struct Au
2120: 78 44 61 74 61 20 7b 0a 20 20 20 20 76 6f 69 64  xData {.    void
2130: 20 2a 70 41 75 78 3b 20 20 20 20 20 20 20 20 20   *pAux;         
2140: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 75 78            /* Aux
2150: 20 64 61 74 61 20 66 6f 72 20 74 68 65 20 69 2d   data for the i-
2160: 74 68 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 20  th argument */. 
2170: 20 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 65 74     void (*xDelet
2180: 65 29 28 76 6f 69 64 20 2a 29 3b 20 20 20 20 20  e)(void *);     
2190: 20 2f 2a 20 44 65 73 74 72 75 63 74 6f 72 20 66   /* Destructor f
21a0: 6f 72 20 74 68 65 20 61 75 78 20 64 61 74 61 20  or the aux data 
21b0: 2a 2f 0a 20 20 7d 20 61 70 41 75 78 5b 31 5d 3b  */.  } apAux[1];
21c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
21d0: 20 20 20 2f 2a 20 4f 6e 65 20 73 6c 6f 74 20 66     /* One slot f
21e0: 6f 72 20 65 61 63 68 20 66 75 6e 63 74 69 6f 6e  or each function
21f0: 20 61 72 67 75 6d 65 6e 74 20 2a 2f 0a 7d 3b 0a   argument */.};.
2200: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 56  typedef struct V
2210: 64 62 65 46 75 6e 63 20 56 64 62 65 46 75 6e 63  dbeFunc VdbeFunc
2220: 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 22 63 6f  ;../*.** The "co
2230: 6e 74 65 78 74 22 20 61 72 67 75 6d 65 6e 74 20  ntext" argument 
2240: 66 6f 72 20 61 20 69 6e 73 74 61 6c 6c 61 62 6c  for a installabl
2250: 65 20 66 75 6e 63 74 69 6f 6e 2e 20 20 41 20 70  e function.  A p
2260: 6f 69 6e 74 65 72 20 74 6f 20 61 6e 0a 2a 2a 20  ointer to an.** 
2270: 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73  instance of this
2280: 20 73 74 72 75 63 74 75 72 65 20 69 73 20 74 68   structure is th
2290: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74  e first argument
22a0: 20 74 6f 20 74 68 65 20 72 6f 75 74 69 6e 65 73   to the routines
22b0: 20 75 73 65 64 0a 2a 2a 20 69 6d 70 6c 65 6d 65   used.** impleme
22c0: 6e 74 20 74 68 65 20 53 51 4c 20 66 75 6e 63 74  nt the SQL funct
22d0: 69 6f 6e 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72  ions..**.** Ther
22e0: 65 20 69 73 20 61 20 74 79 70 65 64 65 66 20 66  e is a typedef f
22f0: 6f 72 20 74 68 69 73 20 73 74 72 75 63 74 75 72  or this structur
2300: 65 20 69 6e 20 73 71 6c 69 74 65 2e 68 2e 20 20  e in sqlite.h.  
2310: 53 6f 20 61 6c 6c 20 72 6f 75 74 69 6e 65 73 2c  So all routines,
2320: 0a 2a 2a 20 65 76 65 6e 20 74 68 65 20 70 75 62  .** even the pub
2330: 6c 69 63 20 69 6e 74 65 72 66 61 63 65 20 74 6f  lic interface to
2340: 20 53 51 4c 69 74 65 2c 20 63 61 6e 20 75 73 65   SQLite, can use
2350: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68   a pointer to th
2360: 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a  is structure..**
2370: 20 42 75 74 20 74 68 69 73 20 66 69 6c 65 20 69   But this file i
2380: 73 20 74 68 65 20 6f 6e 6c 79 20 70 6c 61 63 65  s the only place
2390: 20 77 68 65 72 65 20 74 68 65 20 69 6e 74 65 72   where the inter
23a0: 6e 61 6c 20 64 65 74 61 69 6c 73 20 6f 66 20 74  nal details of t
23b0: 68 69 73 0a 2a 2a 20 73 74 72 75 63 74 75 72 65  his.** structure
23c0: 20 61 72 65 20 6b 6e 6f 77 6e 2e 0a 2a 2a 0a 2a   are known..**.*
23d0: 2a 20 54 68 69 73 20 73 74 72 75 63 74 75 72 65  * This structure
23e0: 20 69 73 20 64 65 66 69 6e 65 64 20 69 6e 73 69   is defined insi
23f0: 64 65 20 6f 66 20 76 64 62 65 49 6e 74 2e 68 20  de of vdbeInt.h 
2400: 62 65 63 61 75 73 65 20 69 74 20 75 73 65 73 20  because it uses 
2410: 73 75 62 73 74 72 75 63 74 75 72 65 73 0a 2a 2a  substructures.**
2420: 20 28 4d 65 6d 29 20 77 68 69 63 68 20 61 72 65   (Mem) which are
2430: 20 6f 6e 6c 79 20 64 65 66 69 6e 65 64 20 74 68   only defined th
2440: 65 72 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 73  ere..*/.struct s
2450: 71 6c 69 74 65 33 5f 63 6f 6e 74 65 78 74 20 7b  qlite3_context {
2460: 0a 20 20 46 75 6e 63 44 65 66 20 2a 70 46 75 6e  .  FuncDef *pFun
2470: 63 3b 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e  c;       /* Poin
2480: 74 65 72 20 74 6f 20 66 75 6e 63 74 69 6f 6e 20  ter to function 
2490: 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 20 20 4d 55  information.  MU
24a0: 53 54 20 42 45 20 46 49 52 53 54 20 2a 2f 0a 20  ST BE FIRST */. 
24b0: 20 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65   VdbeFunc *pVdbe
24c0: 46 75 6e 63 3b 20 20 2f 2a 20 41 75 78 69 6c 61  Func;  /* Auxila
24d0: 72 79 20 64 61 74 61 2c 20 69 66 20 63 72 65 61  ry data, if crea
24e0: 74 65 64 2e 20 2a 2f 0a 20 20 4d 65 6d 20 73 3b  ted. */.  Mem s;
24f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2500: 2f 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76 61  /* The return va
2510: 6c 75 65 20 69 73 20 73 74 6f 72 65 64 20 68 65  lue is stored he
2520: 72 65 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 4d 65  re */.  Mem *pMe
2530: 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  m;            /*
2540: 20 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 75 73 65   Memory cell use
2550: 64 20 74 6f 20 73 74 6f 72 65 20 61 67 67 72 65  d to store aggre
2560: 67 61 74 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a  gate context */.
2570: 20 20 75 38 20 69 73 45 72 72 6f 72 3b 20 20 20    u8 isError;   
2580: 20 20 20 20 20 20 20 20 2f 2a 20 53 65 74 20 74          /* Set t
2590: 6f 20 74 72 75 65 20 66 6f 72 20 61 6e 20 65 72  o true for an er
25a0: 72 6f 72 20 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71  ror */.  CollSeq
25b0: 20 2a 70 43 6f 6c 6c 3b 20 20 20 20 20 20 20 2f   *pColl;       /
25c0: 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75  * Collating sequ
25d0: 65 6e 63 65 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a  ence */.};../*.*
25e0: 2a 20 41 20 53 65 74 20 73 74 72 75 63 74 75 72  * A Set structur
25f0: 65 20 69 73 20 75 73 65 64 20 66 6f 72 20 71 75  e is used for qu
2600: 69 63 6b 20 74 65 73 74 69 6e 67 20 74 6f 20 73  ick testing to s
2610: 65 65 20 69 66 20 61 20 76 61 6c 75 65 0a 2a 2a  ee if a value.**
2620: 20 69 73 20 70 61 72 74 20 6f 66 20 61 20 73 6d   is part of a sm
2630: 61 6c 6c 20 73 65 74 2e 20 20 53 65 74 73 20 61  all set.  Sets a
2640: 72 65 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65  re used to imple
2650: 6d 65 6e 74 20 63 6f 64 65 20 6c 69 6b 65 0a 2a  ment code like.*
2660: 2a 20 74 68 69 73 3a 0a 2a 2a 20 20 20 20 20 20  * this:.**      
2670: 20 20 20 20 20 20 78 2e 79 20 49 4e 20 28 27 68        x.y IN ('h
2680: 69 27 2c 27 68 6f 6f 27 2c 27 68 75 6d 27 29 0a  i','hoo','hum').
2690: 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75 63  */.typedef struc
26a0: 74 20 53 65 74 20 53 65 74 3b 0a 73 74 72 75 63  t Set Set;.struc
26b0: 74 20 53 65 74 20 7b 0a 20 20 48 61 73 68 20 68  t Set {.  Hash h
26c0: 61 73 68 3b 20 20 20 20 20 20 20 20 20 20 20 20  ash;            
26d0: 20 2f 2a 20 41 20 73 65 74 20 69 73 20 6a 75 73   /* A set is jus
26e0: 74 20 61 20 68 61 73 68 20 74 61 62 6c 65 20 2a  t a hash table *
26f0: 2f 0a 20 20 48 61 73 68 45 6c 65 6d 20 2a 70 72  /.  HashElem *pr
2700: 65 76 3b 20 20 20 20 20 20 20 20 2f 2a 20 50 72  ev;        /* Pr
2710: 65 76 69 6f 75 73 6c 79 20 61 63 63 65 73 73 65  eviously accesse
2720: 64 20 68 61 73 68 20 65 6c 65 6d 65 6e 20 2a 2f  d hash elemen */
2730: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 20 46 69 66  .};../*.** A Fif
2740: 6f 50 61 67 65 20 73 74 72 75 63 74 75 72 65 20  oPage structure 
2750: 68 6f 6c 64 73 20 61 20 73 69 6e 67 6c 65 20 70  holds a single p
2760: 61 67 65 20 6f 66 20 76 61 6c 76 65 73 2e 20 20  age of valves.  
2770: 50 61 67 65 73 20 61 72 65 20 61 72 72 61 6e 67  Pages are arrang
2780: 65 64 0a 2a 2a 20 69 6e 20 61 20 6c 69 73 74 2e  ed.** in a list.
2790: 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73 74 72 75  .*/.typedef stru
27a0: 63 74 20 46 69 66 6f 50 61 67 65 20 46 69 66 6f  ct FifoPage Fifo
27b0: 50 61 67 65 3b 0a 73 74 72 75 63 74 20 46 69 66  Page;.struct Fif
27c0: 6f 50 61 67 65 20 7b 0a 20 20 69 6e 74 20 6e 53  oPage {.  int nS
27d0: 6c 6f 74 3b 20 20 20 20 20 20 20 20 20 2f 2a 20  lot;         /* 
27e0: 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65  Number of entrie
27f0: 73 20 61 53 6c 6f 74 5b 5d 20 2a 2f 0a 20 20 69  s aSlot[] */.  i
2800: 6e 74 20 69 57 72 69 74 65 3b 20 20 20 20 20 20  nt iWrite;      
2810: 20 20 2f 2a 20 50 75 73 68 20 74 68 65 20 6e 65    /* Push the ne
2820: 78 74 20 76 61 6c 75 65 20 69 6e 74 6f 20 74 68  xt value into th
2830: 69 73 20 65 6e 74 72 79 20 69 6e 20 61 53 6c 6f  is entry in aSlo
2840: 74 5b 5d 20 2a 2f 0a 20 20 69 6e 74 20 69 52 65  t[] */.  int iRe
2850: 61 64 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 52  ad;         /* R
2860: 65 61 64 20 74 68 65 20 6e 65 78 74 20 76 61 6c  ead the next val
2870: 75 65 20 66 72 6f 6d 20 74 68 69 73 20 65 6e 74  ue from this ent
2880: 72 79 20 69 6e 20 61 53 6c 6f 74 5b 5d 20 2a 2f  ry in aSlot[] */
2890: 0a 20 20 46 69 66 6f 50 61 67 65 20 2a 70 4e 65  .  FifoPage *pNe
28a0: 78 74 3b 20 20 20 2f 2a 20 4e 65 78 74 20 70 61  xt;   /* Next pa
28b0: 67 65 20 69 6e 20 74 68 65 20 66 69 66 6f 20 2a  ge in the fifo *
28c0: 2f 0a 20 20 69 36 34 20 61 53 6c 6f 74 5b 31 5d  /.  i64 aSlot[1]
28d0: 3b 20 20 20 20 20 20 2f 2a 20 4f 6e 65 20 6f 72  ;      /* One or
28e0: 20 6d 6f 72 65 20 73 6c 6f 74 73 20 66 6f 72 20   more slots for 
28f0: 72 6f 77 69 64 20 76 61 6c 75 65 73 20 2a 2f 0a  rowid values */.
2900: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 46 69  };../*.** The Fi
2910: 66 6f 20 73 74 72 75 63 74 75 72 65 20 69 73 20  fo structure is 
2920: 74 79 70 65 64 65 66 2d 65 64 20 69 6e 20 76 64  typedef-ed in vd
2930: 62 65 49 6e 74 2e 68 2e 20 20 42 75 74 20 74 68  beInt.h.  But th
2940: 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e  e implementation
2950: 0a 2a 2a 20 6f 66 20 74 68 61 74 20 73 74 72 75  .** of that stru
2960: 63 74 75 72 65 20 69 73 20 70 72 69 76 61 74 65  cture is private
2970: 20 74 6f 20 74 68 69 73 20 66 69 6c 65 2e 0a 2a   to this file..*
2980: 2a 0a 2a 2a 20 54 68 65 20 46 69 66 6f 20 73 74  *.** The Fifo st
2990: 72 75 63 74 75 72 65 20 64 65 73 63 72 69 62 65  ructure describe
29a0: 73 20 74 68 65 20 65 6e 74 69 72 65 20 66 69 66  s the entire fif
29b0: 6f 2e 20 20 0a 2a 2f 0a 74 79 70 65 64 65 66 20  o.  .*/.typedef 
29c0: 73 74 72 75 63 74 20 46 69 66 6f 20 46 69 66 6f  struct Fifo Fifo
29d0: 3b 0a 73 74 72 75 63 74 20 46 69 66 6f 20 7b 0a  ;.struct Fifo {.
29e0: 20 20 69 6e 74 20 6e 45 6e 74 72 79 3b 20 20 20    int nEntry;   
29f0: 20 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e        /* Total n
2a00: 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73  umber of entries
2a10: 20 2a 2f 0a 20 20 46 69 66 6f 50 61 67 65 20 2a   */.  FifoPage *
2a20: 70 46 69 72 73 74 3b 20 20 20 2f 2a 20 46 69 72  pFirst;   /* Fir
2a30: 73 74 20 70 61 67 65 20 6f 6e 20 74 68 65 20 6c  st page on the l
2a40: 69 73 74 20 2a 2f 0a 20 20 46 69 66 6f 50 61 67  ist */.  FifoPag
2a50: 65 20 2a 70 4c 61 73 74 3b 20 20 20 20 2f 2a 20  e *pLast;    /* 
2a60: 4c 61 73 74 20 70 61 67 65 20 6f 6e 20 74 68 65  Last page on the
2a70: 20 6c 69 73 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a   list */.};../*.
2a80: 2a 2a 20 41 20 43 6f 6e 74 65 78 74 20 73 74 6f  ** A Context sto
2a90: 72 65 73 20 74 68 65 20 6c 61 73 74 20 69 6e 73  res the last ins
2aa0: 65 72 74 20 72 6f 77 69 64 2c 20 74 68 65 20 6c  ert rowid, the l
2ab0: 61 73 74 20 73 74 61 74 65 6d 65 6e 74 20 63 68  ast statement ch
2ac0: 61 6e 67 65 20 63 6f 75 6e 74 2c 0a 2a 2a 20 61  ange count,.** a
2ad0: 6e 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 73  nd the current s
2ae0: 74 61 74 65 6d 65 6e 74 20 63 68 61 6e 67 65 20  tatement change 
2af0: 63 6f 75 6e 74 20 28 69 2e 65 2e 20 63 68 61 6e  count (i.e. chan
2b00: 67 65 73 20 73 69 6e 63 65 20 6c 61 73 74 20 73  ges since last s
2b10: 74 61 74 65 6d 65 6e 74 29 2e 0a 2a 2a 20 54 68  tatement)..** Th
2b20: 65 20 63 75 72 72 65 6e 74 20 6b 65 79 6c 69 73  e current keylis
2b30: 74 20 69 73 20 61 6c 73 6f 20 73 74 6f 72 65 64  t is also stored
2b40: 20 69 6e 20 74 68 65 20 63 6f 6e 74 65 78 74 2e   in the context.
2b50: 0a 2a 2a 20 45 6c 65 6d 65 6e 74 73 20 6f 66 20  .** Elements of 
2b60: 43 6f 6e 74 65 78 74 20 73 74 72 75 63 74 75 72  Context structur
2b70: 65 20 74 79 70 65 20 6d 61 6b 65 20 75 70 20 74  e type make up t
2b80: 68 65 20 43 6f 6e 74 65 78 74 53 74 61 63 6b 2c  he ContextStack,
2b90: 20 77 68 69 63 68 20 69 73 0a 2a 2a 20 75 70 64   which is.** upd
2ba0: 61 74 65 64 20 62 79 20 74 68 65 20 43 6f 6e 74  ated by the Cont
2bb0: 65 78 74 50 75 73 68 20 61 6e 64 20 43 6f 6e 74  extPush and Cont
2bc0: 65 78 74 50 6f 70 20 6f 70 63 6f 64 65 73 20 28  extPop opcodes (
2bd0: 75 73 65 64 20 62 79 20 74 72 69 67 67 65 72 73  used by triggers
2be0: 29 2e 0a 2a 2a 20 54 68 65 20 63 6f 6e 74 65 78  )..** The contex
2bf0: 74 20 69 73 20 70 75 73 68 65 64 20 62 65 66 6f  t is pushed befo
2c00: 72 65 20 65 78 65 63 75 74 69 6e 67 20 61 20 74  re executing a t
2c10: 72 69 67 67 65 72 20 61 20 70 6f 70 70 65 64 20  rigger a popped 
2c20: 77 68 65 6e 20 74 68 65 0a 2a 2a 20 74 72 69 67  when the.** trig
2c30: 67 65 72 20 66 69 6e 69 73 68 65 73 2e 0a 2a 2f  ger finishes..*/
2c40: 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20  .typedef struct 
2c50: 43 6f 6e 74 65 78 74 20 43 6f 6e 74 65 78 74 3b  Context Context;
2c60: 0a 73 74 72 75 63 74 20 43 6f 6e 74 65 78 74 20  .struct Context 
2c70: 7b 0a 20 20 69 36 34 20 6c 61 73 74 52 6f 77 69  {.  i64 lastRowi
2c80: 64 3b 20 20 20 20 2f 2a 20 4c 61 73 74 20 69 6e  d;    /* Last in
2c90: 73 65 72 74 20 72 6f 77 69 64 20 28 73 71 6c 69  sert rowid (sqli
2ca0: 74 65 33 2e 6c 61 73 74 52 6f 77 69 64 29 20 2a  te3.lastRowid) *
2cb0: 2f 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67 65 3b  /.  int nChange;
2cc0: 20 20 20 20 20 20 2f 2a 20 53 74 61 74 65 6d 65        /* Stateme
2cd0: 6e 74 20 63 68 61 6e 67 65 73 20 28 56 64 62 65  nt changes (Vdbe
2ce0: 2e 6e 43 68 61 6e 67 65 73 29 20 20 20 20 20 2a  .nChanges)     *
2cf0: 2f 0a 20 20 46 69 66 6f 20 73 46 69 66 6f 3b 20  /.  Fifo sFifo; 
2d00: 20 20 20 20 20 20 2f 2a 20 52 65 63 6f 72 64 73        /* Records
2d10: 20 74 68 61 74 20 77 69 6c 6c 20 70 61 72 74 69   that will parti
2d20: 63 69 70 61 74 65 20 69 6e 20 61 20 44 45 4c 45  cipate in a DELE
2d30: 54 45 20 6f 72 20 55 50 44 41 54 45 20 2a 2f 0a  TE or UPDATE */.
2d40: 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73  };../*.** An ins
2d50: 74 61 6e 63 65 20 6f 66 20 74 68 65 20 76 69 72  tance of the vir
2d60: 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e 20 20 54  tual machine.  T
2d70: 68 69 73 20 73 74 72 75 63 74 75 72 65 20 63 6f  his structure co
2d80: 6e 74 61 69 6e 73 20 74 68 65 20 63 6f 6d 70 6c  ntains the compl
2d90: 65 74 65 0a 2a 2a 20 73 74 61 74 65 20 6f 66 20  ete.** state of 
2da0: 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68  the virtual mach
2db0: 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22  ine..**.** The "
2dc0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 22 20 73 74  sqlite3_stmt" st
2dd0: 72 75 63 74 75 72 65 20 70 6f 69 6e 74 65 72 20  ructure pointer 
2de0: 74 68 61 74 20 69 73 20 72 65 74 75 72 6e 65 64  that is returned
2df0: 20 62 79 20 73 71 6c 69 74 65 33 5f 63 6f 6d 70   by sqlite3_comp
2e00: 69 6c 65 28 29 0a 2a 2a 20 69 73 20 72 65 61 6c  ile().** is real
2e10: 6c 79 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20  ly a pointer to 
2e20: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
2e30: 68 69 73 20 73 74 72 75 63 74 75 72 65 2e 0a 2a  his structure..*
2e40: 2a 0a 2a 2a 20 54 68 65 20 56 64 62 65 2e 69 6e  *.** The Vdbe.in
2e50: 56 74 61 62 4d 65 74 68 6f 64 20 76 61 72 69 61  VtabMethod varia
2e60: 62 6c 65 20 69 73 20 73 65 74 20 74 6f 20 6e 6f  ble is set to no
2e70: 6e 2d 7a 65 72 6f 20 66 6f 72 20 74 68 65 20 64  n-zero for the d
2e80: 75 72 61 74 69 6f 6e 20 6f 66 0a 2a 2a 20 61 6e  uration of.** an
2e90: 79 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20  y virtual table 
2ea0: 6d 65 74 68 6f 64 20 69 6e 76 6f 63 61 74 69 6f  method invocatio
2eb0: 6e 73 20 6d 61 64 65 20 62 79 20 74 68 65 20 76  ns made by the v
2ec0: 64 62 65 20 70 72 6f 67 72 61 6d 2e 20 49 74 20  dbe program. It 
2ed0: 69 73 0a 2a 2a 20 73 65 74 20 74 6f 20 32 20 66  is.** set to 2 f
2ee0: 6f 72 20 78 44 65 73 74 72 6f 79 20 6d 65 74 68  or xDestroy meth
2ef0: 6f 64 20 63 61 6c 6c 73 20 61 6e 64 20 31 20 66  od calls and 1 f
2f00: 6f 72 20 61 6c 6c 20 6f 74 68 65 72 20 6d 65 74  or all other met
2f10: 68 6f 64 73 2e 20 54 68 69 73 0a 2a 2a 20 76 61  hods. This.** va
2f20: 72 69 61 62 6c 65 20 69 73 20 75 73 65 64 20 66  riable is used f
2f30: 6f 72 20 74 77 6f 20 70 75 72 70 6f 73 65 73 3a  or two purposes:
2f40: 20 74 6f 20 61 6c 6c 6f 77 20 78 44 65 73 74 72   to allow xDestr
2f50: 6f 79 20 6d 65 74 68 6f 64 73 20 74 6f 20 65 78  oy methods to ex
2f60: 65 63 75 74 65 0a 2a 2a 20 22 44 52 4f 50 20 54  ecute.** "DROP T
2f70: 41 42 4c 45 22 20 73 74 61 74 65 6d 65 6e 74 73  ABLE" statements
2f80: 20 61 6e 64 20 74 6f 20 70 72 65 76 65 6e 74 20   and to prevent 
2f90: 73 6f 6d 65 20 6e 61 73 74 79 20 73 69 64 65 20  some nasty side 
2fa0: 65 66 66 65 63 74 73 20 6f 66 0a 2a 2a 20 6d 61  effects of.** ma
2fb0: 6c 6c 6f 63 20 66 61 69 6c 75 72 65 20 77 68 65  lloc failure whe
2fc0: 6e 20 53 51 4c 69 74 65 20 69 73 20 69 6e 76 6f  n SQLite is invo
2fd0: 6b 65 64 20 72 65 63 75 72 73 69 76 65 6c 79 20  ked recursively 
2fe0: 62 79 20 61 20 76 69 72 74 75 61 6c 20 74 61 62  by a virtual tab
2ff0: 6c 65 20 0a 2a 2a 20 6d 65 74 68 6f 64 20 66 75  le .** method fu
3000: 6e 63 74 69 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63  nction..*/.struc
3010: 74 20 56 64 62 65 20 7b 0a 20 20 73 71 6c 69 74  t Vdbe {.  sqlit
3020: 65 33 20 2a 64 62 3b 20 20 20 20 20 20 20 20 2f  e3 *db;        /
3030: 2a 20 54 68 65 20 77 68 6f 6c 65 20 64 61 74 61  * The whole data
3040: 62 61 73 65 20 2a 2f 0a 20 20 56 64 62 65 20 2a  base */.  Vdbe *
3050: 70 50 72 65 76 2c 2a 70 4e 65 78 74 3b 20 2f 2a  pPrev,*pNext; /*
3060: 20 4c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20   Linked list of 
3070: 56 44 42 45 73 20 77 69 74 68 20 74 68 65 20 73  VDBEs with the s
3080: 61 6d 65 20 56 64 62 65 2e 64 62 20 2a 2f 0a 20  ame Vdbe.db */. 
3090: 20 46 49 4c 45 20 2a 74 72 61 63 65 3b 20 20 20   FILE *trace;   
30a0: 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 61 6e       /* Write an
30b0: 20 65 78 65 63 75 74 69 6f 6e 20 74 72 61 63 65   execution trace
30c0: 20 68 65 72 65 2c 20 69 66 20 6e 6f 74 20 4e 55   here, if not NU
30d0: 4c 4c 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 70 3b  LL */.  int nOp;
30e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
30f0: 75 6d 62 65 72 20 6f 66 20 69 6e 73 74 72 75 63  umber of instruc
3100: 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 70 72 6f  tions in the pro
3110: 67 72 61 6d 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f  gram */.  int nO
3120: 70 41 6c 6c 6f 63 3b 20 20 20 20 20 20 20 2f 2a  pAlloc;       /*
3130: 20 4e 75 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73   Number of slots
3140: 20 61 6c 6c 6f 63 61 74 65 64 20 66 6f 72 20 61   allocated for a
3150: 4f 70 5b 5d 20 2a 2f 0a 20 20 4f 70 20 2a 61 4f  Op[] */.  Op *aO
3160: 70 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  p;            /*
3170: 20 53 70 61 63 65 20 74 6f 20 68 6f 6c 64 20 74   Space to hold t
3180: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  he virtual machi
3190: 6e 65 27 73 20 70 72 6f 67 72 61 6d 20 2a 2f 0a  ne's program */.
31a0: 20 20 69 6e 74 20 6e 4c 61 62 65 6c 3b 20 20 20    int nLabel;   
31b0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
31c0: 6f 66 20 6c 61 62 65 6c 73 20 75 73 65 64 20 2a  of labels used *
31d0: 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 65 6c 41 6c  /.  int nLabelAl
31e0: 6c 6f 63 3b 20 20 20 20 2f 2a 20 4e 75 6d 62 65  loc;    /* Numbe
31f0: 72 20 6f 66 20 73 6c 6f 74 73 20 61 6c 6c 6f 63  r of slots alloc
3200: 61 74 65 64 20 69 6e 20 61 4c 61 62 65 6c 5b 5d  ated in aLabel[]
3210: 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 4c 61 62 65   */.  int *aLabe
3220: 6c 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61  l;        /* Spa
3230: 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 6c  ce to hold the l
3240: 61 62 65 6c 73 20 2a 2f 0a 20 20 4d 65 6d 20 2a  abels */.  Mem *
3250: 61 53 74 61 63 6b 3b 20 20 20 20 20 20 20 20 2f  aStack;        /
3260: 2a 20 54 68 65 20 6f 70 65 72 61 6e 64 20 73 74  * The operand st
3270: 61 63 6b 2c 20 65 78 63 65 70 74 20 73 74 72 69  ack, except stri
3280: 6e 67 20 76 61 6c 75 65 73 20 2a 2f 0a 20 20 4d  ng values */.  M
3290: 65 6d 20 2a 70 54 6f 73 3b 20 20 20 20 20 20 20  em *pTos;       
32a0: 20 20 20 2f 2a 20 54 6f 70 20 65 6e 74 72 79 20     /* Top entry 
32b0: 69 6e 20 74 68 65 20 6f 70 65 72 61 6e 64 20 73  in the operand s
32c0: 74 61 63 6b 20 2a 2f 0a 20 20 4d 65 6d 20 2a 2a  tack */.  Mem **
32d0: 61 70 41 72 67 3b 20 20 20 20 20 20 20 20 2f 2a  apArg;        /*
32e0: 20 41 72 67 75 6d 65 6e 74 73 20 74 6f 20 63 75   Arguments to cu
32f0: 72 72 65 6e 74 6c 79 20 65 78 65 63 75 74 69 6e  rrently executin
3300: 67 20 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 20  g user function 
3310: 2a 2f 0a 20 20 4d 65 6d 20 2a 61 43 6f 6c 4e 61  */.  Mem *aColNa
3320: 6d 65 3b 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75  me;      /* Colu
3330: 6d 6e 20 6e 61 6d 65 73 20 74 6f 20 72 65 74 75  mn names to retu
3340: 72 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 75 72  rn */.  int nCur
3350: 73 6f 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e  sor;        /* N
3360: 75 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 69  umber of slots i
3370: 6e 20 61 70 43 73 72 5b 5d 20 2a 2f 0a 20 20 43  n apCsr[] */.  C
3380: 75 72 73 6f 72 20 2a 2a 61 70 43 73 72 3b 20 20  ursor **apCsr;  
3390: 20 20 20 2f 2a 20 4f 6e 65 20 65 6c 65 6d 65 6e     /* One elemen
33a0: 74 20 6f 66 20 74 68 69 73 20 61 72 72 61 79 20  t of this array 
33b0: 66 6f 72 20 65 61 63 68 20 6f 70 65 6e 20 63 75  for each open cu
33c0: 72 73 6f 72 20 2a 2f 0a 20 20 69 6e 74 20 6e 56  rsor */.  int nV
33d0: 61 72 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ar;           /*
33e0: 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72 69   Number of entri
33f0: 65 73 20 69 6e 20 61 56 61 72 5b 5d 20 2a 2f 0a  es in aVar[] */.
3400: 20 20 4d 65 6d 20 2a 61 56 61 72 3b 20 20 20 20    Mem *aVar;    
3410: 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 73 20        /* Values 
3420: 66 6f 72 20 74 68 65 20 4f 50 5f 56 61 72 69 61  for the OP_Varia
3430: 62 6c 65 20 6f 70 63 6f 64 65 2e 20 2a 2f 0a 20  ble opcode. */. 
3440: 20 63 68 61 72 20 2a 2a 61 7a 56 61 72 3b 20 20   char **azVar;  
3450: 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20       /* Name of 
3460: 76 61 72 69 61 62 6c 65 73 20 2a 2f 0a 20 20 69  variables */.  i
3470: 6e 74 20 6f 6b 56 61 72 3b 20 20 20 20 20 20 20  nt okVar;       
3480: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61 7a     /* True if az
3490: 56 61 72 5b 5d 20 68 61 73 20 62 65 65 6e 20 69  Var[] has been i
34a0: 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f 0a 20 20  nitialized */.  
34b0: 69 6e 74 20 6d 61 67 69 63 3b 20 20 20 20 20 20  int magic;      
34c0: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 67 69 63          /* Magic
34d0: 20 6e 75 6d 62 65 72 20 66 6f 72 20 73 61 6e 69   number for sani
34e0: 74 79 20 63 68 65 63 6b 69 6e 67 20 2a 2f 0a 20  ty checking */. 
34f0: 20 69 6e 74 20 6e 4d 65 6d 3b 20 20 20 20 20 20   int nMem;      
3500: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
3510: 65 72 20 6f 66 20 6d 65 6d 6f 72 79 20 6c 6f 63  er of memory loc
3520: 61 74 69 6f 6e 73 20 63 75 72 72 65 6e 74 6c 79  ations currently
3530: 20 61 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20   allocated */.  
3540: 4d 65 6d 20 2a 61 4d 65 6d 3b 20 20 20 20 20 20  Mem *aMem;      
3550: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6d          /* The m
3560: 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e 73 20  emory locations 
3570: 2a 2f 0a 20 20 69 6e 74 20 6e 43 61 6c 6c 62 61  */.  int nCallba
3580: 63 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ck;          /* 
3590: 4e 75 6d 62 65 72 20 6f 66 20 63 61 6c 6c 62 61  Number of callba
35a0: 63 6b 73 20 69 6e 76 6f 6b 65 64 20 73 6f 20 66  cks invoked so f
35b0: 61 72 20 2a 2f 0a 20 20 69 6e 74 20 63 61 63 68  ar */.  int cach
35c0: 65 43 74 72 3b 20 20 20 20 20 20 20 20 20 20 20  eCtr;           
35d0: 2f 2a 20 43 75 72 73 6f 72 20 72 6f 77 20 63 61  /* Cursor row ca
35e0: 63 68 65 20 67 65 6e 65 72 61 74 69 6f 6e 20 63  che generation c
35f0: 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 46 69 66 6f  ounter */.  Fifo
3600: 20 73 46 69 66 6f 3b 20 20 20 20 20 20 20 20 20   sFifo;         
3610: 20 20 20 20 2f 2a 20 41 20 6c 69 73 74 20 6f 66      /* A list of
3620: 20 52 4f 57 49 44 73 20 2a 2f 0a 20 20 69 6e 74   ROWIDs */.  int
3630: 20 63 6f 6e 74 65 78 74 53 74 61 63 6b 54 6f 70   contextStackTop
3640: 3b 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66  ;    /* Index of
3650: 20 74 6f 70 20 65 6c 65 6d 65 6e 74 20 69 6e 20   top element in 
3660: 74 68 65 20 63 6f 6e 74 65 78 74 20 73 74 61 63  the context stac
3670: 6b 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6e 74 65  k */.  int conte
3680: 78 74 53 74 61 63 6b 44 65 70 74 68 3b 20 20 2f  xtStackDepth;  /
3690: 2a 20 54 68 65 20 73 69 7a 65 20 6f 66 20 74 68  * The size of th
36a0: 65 20 22 63 6f 6e 74 65 78 74 22 20 73 74 61 63  e "context" stac
36b0: 6b 20 2a 2f 0a 20 20 43 6f 6e 74 65 78 74 20 2a  k */.  Context *
36c0: 63 6f 6e 74 65 78 74 53 74 61 63 6b 3b 20 20 2f  contextStack;  /
36d0: 2a 20 53 74 61 63 6b 20 75 73 65 64 20 62 79 20  * Stack used by 
36e0: 6f 70 63 6f 64 65 73 20 43 6f 6e 74 65 78 74 50  opcodes ContextP
36f0: 75 73 68 20 26 20 43 6f 6e 74 65 78 74 50 6f 70  ush & ContextPop
3700: 2a 2f 0a 20 20 69 6e 74 20 70 63 3b 20 20 20 20  */.  int pc;    
3710: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3720: 54 68 65 20 70 72 6f 67 72 61 6d 20 63 6f 75 6e  The program coun
3730: 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b  ter */.  int rc;
3740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3750: 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74   /* Value to ret
3760: 75 72 6e 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65  urn */.  unsigne
3770: 64 20 75 6e 69 71 75 65 43 6e 74 3b 20 20 20 20  d uniqueCnt;    
3780: 20 2f 2a 20 55 73 65 64 20 62 79 20 4f 50 5f 4d   /* Used by OP_M
3790: 61 6b 65 52 65 63 6f 72 64 20 77 68 65 6e 20 50  akeRecord when P
37a0: 32 21 3d 30 20 2a 2f 0a 20 20 69 6e 74 20 65 72  2!=0 */.  int er
37b0: 72 6f 72 41 63 74 69 6f 6e 3b 20 20 20 20 20 20  rorAction;      
37c0: 20 20 2f 2a 20 52 65 63 6f 76 65 72 79 20 61 63    /* Recovery ac
37d0: 74 69 6f 6e 20 74 6f 20 64 6f 20 69 6e 20 63 61  tion to do in ca
37e0: 73 65 20 6f 66 20 61 6e 20 65 72 72 6f 72 20 2a  se of an error *
37f0: 2f 0a 20 20 69 6e 74 20 69 6e 54 65 6d 70 54 72  /.  int inTempTr
3800: 61 6e 73 3b 20 20 20 20 20 20 20 20 2f 2a 20 54  ans;        /* T
3810: 72 75 65 20 69 66 20 74 65 6d 70 20 64 61 74 61  rue if temp data
3820: 62 61 73 65 20 69 73 20 74 72 61 6e 73 61 63 74  base is transact
3830: 69 6f 6e 65 64 20 2a 2f 0a 20 20 69 6e 74 20 72  ioned */.  int r
3840: 65 74 75 72 6e 53 74 61 63 6b 5b 31 30 30 5d 3b  eturnStack[100];
3850: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 61 64 64     /* Return add
3860: 72 65 73 73 20 73 74 61 63 6b 20 66 6f 72 20 4f  ress stack for O
3870: 50 5f 47 6f 73 75 62 20 26 20 4f 50 5f 52 65 74  P_Gosub & OP_Ret
3880: 75 72 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 65 74  urn */.  int ret
3890: 75 72 6e 44 65 70 74 68 3b 20 20 20 20 20 20 20  urnDepth;       
38a0: 20 2f 2a 20 4e 65 78 74 20 75 6e 75 73 65 64 20   /* Next unused 
38b0: 65 6c 65 6d 65 6e 74 20 69 6e 20 72 65 74 75 72  element in retur
38c0: 6e 53 74 61 63 6b 5b 5d 20 2a 2f 0a 20 20 69 6e  nStack[] */.  in
38d0: 74 20 6e 52 65 73 43 6f 6c 75 6d 6e 3b 20 20 20  t nResColumn;   
38e0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
38f0: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 6f 6e  of columns in on
3900: 65 20 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73  e row of the res
3910: 75 6c 74 20 73 65 74 20 2a 2f 0a 20 20 63 68 61  ult set */.  cha
3920: 72 20 2a 2a 61 7a 52 65 73 43 6f 6c 75 6d 6e 3b  r **azResColumn;
3930: 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 73 20 66       /* Values f
3940: 6f 72 20 6f 6e 65 20 72 6f 77 20 6f 66 20 72 65  or one row of re
3950: 73 75 6c 74 20 2a 2f 20 0a 20 20 69 6e 74 20 70  sult */ .  int p
3960: 6f 70 53 74 61 63 6b 3b 20 20 20 20 20 20 20 20  opStack;        
3970: 20 20 20 2f 2a 20 50 6f 70 20 74 68 65 20 73 74     /* Pop the st
3980: 61 63 6b 20 74 68 69 73 20 6d 75 63 68 20 6f 6e  ack this much on
3990: 20 65 6e 74 72 79 20 74 6f 20 56 64 62 65 45 78   entry to VdbeEx
39a0: 65 63 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a  ec() */.  char *
39b0: 7a 45 72 72 4d 73 67 3b 20 20 20 20 20 20 20 20  zErrMsg;        
39c0: 20 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61    /* Error messa
39d0: 67 65 20 77 72 69 74 74 65 6e 20 68 65 72 65 20  ge written here 
39e0: 2a 2f 0a 20 20 75 38 20 72 65 73 4f 6e 53 74 61  */.  u8 resOnSta
39f0: 63 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ck;          /* 
3a00: 54 72 75 65 20 69 66 20 74 68 65 72 65 20 61 72  True if there ar
3a10: 65 20 72 65 73 75 6c 74 20 76 61 6c 75 65 73 20  e result values 
3a20: 6f 6e 20 74 68 65 20 73 74 61 63 6b 20 2a 2f 0a  on the stack */.
3a30: 20 20 75 38 20 65 78 70 6c 61 69 6e 3b 20 20 20    u8 explain;   
3a40: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75            /* Tru
3a50: 65 20 69 66 20 45 58 50 4c 41 49 4e 20 70 72 65  e if EXPLAIN pre
3a60: 73 65 6e 74 20 6f 6e 20 53 51 4c 20 63 6f 6d 6d  sent on SQL comm
3a70: 61 6e 64 20 2a 2f 0a 20 20 75 38 20 63 68 61 6e  and */.  u8 chan
3a80: 67 65 43 6e 74 4f 6e 3b 20 20 20 20 20 20 20 20  geCntOn;        
3a90: 20 2f 2a 20 54 72 75 65 20 74 6f 20 75 70 64 61   /* True to upda
3aa0: 74 65 20 74 68 65 20 63 68 61 6e 67 65 2d 63 6f  te the change-co
3ab0: 75 6e 74 65 72 20 2a 2f 0a 20 20 75 38 20 61 62  unter */.  u8 ab
3ac0: 6f 72 74 65 64 3b 20 20 20 20 20 20 20 20 20 20  orted;          
3ad0: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 52 4f     /* True if RO
3ae0: 4c 4c 42 41 43 4b 20 69 6e 20 61 6e 6f 74 68 65  LLBACK in anothe
3af0: 72 20 56 4d 20 63 61 75 73 65 73 20 61 6e 20 61  r VM causes an a
3b00: 62 6f 72 74 20 2a 2f 0a 20 20 75 38 20 65 78 70  bort */.  u8 exp
3b10: 69 72 65 64 3b 20 20 20 20 20 20 20 20 20 20 20  ired;           
3b20: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65    /* True if the
3b30: 20 56 4d 20 6e 65 65 64 73 20 74 6f 20 62 65 20   VM needs to be 
3b40: 72 65 63 6f 6d 70 69 6c 65 64 20 2a 2f 0a 20 20  recompiled */.  
3b50: 75 38 20 6d 69 6e 57 72 69 74 65 46 69 6c 65 46  u8 minWriteFileF
3b60: 6f 72 6d 61 74 3b 20 20 2f 2a 20 4d 69 6e 69 6d  ormat;  /* Minim
3b70: 75 6d 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 66  um file format f
3b80: 6f 72 20 77 72 69 74 61 62 6c 65 20 64 61 74 61  or writable data
3b90: 62 61 73 65 20 66 69 6c 65 73 20 2a 2f 0a 20 20  base files */.  
3ba0: 75 38 20 69 6e 56 74 61 62 4d 65 74 68 6f 64 3b  u8 inVtabMethod;
3bb0: 20 20 20 20 20 20 20 20 2f 2a 20 53 65 65 20 63          /* See c
3bc0: 6f 6d 6d 65 6e 74 73 20 61 62 6f 76 65 20 2a 2f  omments above */
3bd0: 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67 65 3b 20  .  int nChange; 
3be0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
3bf0: 6d 62 65 72 20 6f 66 20 64 62 20 63 68 61 6e 67  mber of db chang
3c00: 65 73 20 6d 61 64 65 20 73 69 6e 63 65 20 6c 61  es made since la
3c10: 73 74 20 72 65 73 65 74 20 2a 2f 0a 20 20 69 36  st reset */.  i6
3c20: 34 20 73 74 61 72 74 54 69 6d 65 3b 20 20 20 20  4 startTime;    
3c30: 20 20 20 20 20 20 2f 2a 20 54 69 6d 65 20 77 68        /* Time wh
3c40: 65 6e 20 71 75 65 72 79 20 73 74 61 72 74 65 64  en query started
3c50: 20 2d 20 75 73 65 64 20 66 6f 72 20 70 72 6f 66   - used for prof
3c60: 69 6c 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 6e  iling */.  int n
3c70: 53 71 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  Sql;            
3c80: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 62 79   /* Number of by
3c90: 74 65 73 20 69 6e 20 7a 53 71 6c 20 2a 2f 0a 20  tes in zSql */. 
3ca0: 20 63 68 61 72 20 2a 7a 53 71 6c 3b 20 20 20 20   char *zSql;    
3cb0: 20 20 20 20 20 20 20 2f 2a 20 54 65 78 74 20 6f         /* Text o
3cc0: 66 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d  f the SQL statem
3cd0: 65 6e 74 20 74 68 61 74 20 67 65 6e 65 72 61 74  ent that generat
3ce0: 65 64 20 74 68 69 73 20 2a 2f 0a 23 69 66 64 65  ed this */.#ifde
3cf0: 66 20 53 51 4c 49 54 45 5f 53 53 45 0a 20 20 69  f SQLITE_SSE.  i
3d00: 6e 74 20 66 65 74 63 68 49 64 3b 20 20 20 20 20  nt fetchId;     
3d10: 20 20 20 20 20 2f 2a 20 53 74 61 74 65 6d 65 6e       /* Statemen
3d20: 74 20 6e 75 6d 62 65 72 20 75 73 65 64 20 62 79  t number used by
3d30: 20 73 71 6c 69 74 65 33 5f 66 65 74 63 68 5f 73   sqlite3_fetch_s
3d40: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 6e  tatement */.  in
3d50: 74 20 6c 72 75 3b 20 20 20 20 20 20 20 20 20 20  t lru;          
3d60: 20 20 20 20 2f 2a 20 43 6f 75 6e 74 65 72 20 75      /* Counter u
3d70: 73 65 64 20 66 6f 72 20 4c 52 55 20 63 61 63 68  sed for LRU cach
3d80: 65 20 72 65 70 6c 61 63 65 6d 65 6e 74 20 2a 2f  e replacement */
3d90: 0a 23 65 6e 64 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a  .#endif.};../*.*
3da0: 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  * The following 
3db0: 61 72 65 20 61 6c 6c 6f 77 65 64 20 76 61 6c 75  are allowed valu
3dc0: 65 73 20 66 6f 72 20 56 64 62 65 2e 6d 61 67 69  es for Vdbe.magi
3dd0: 63 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 56 44 42  c.*/.#define VDB
3de0: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 20 20 20  E_MAGIC_INIT    
3df0: 20 30 78 32 36 62 63 65 61 61 35 20 20 20 20 2f   0x26bceaa5    /
3e00: 2a 20 42 75 69 6c 64 69 6e 67 20 61 20 56 44 42  * Building a VDB
3e10: 45 20 70 72 6f 67 72 61 6d 20 2a 2f 0a 23 64 65  E program */.#de
3e20: 66 69 6e 65 20 56 44 42 45 5f 4d 41 47 49 43 5f  fine VDBE_MAGIC_
3e30: 52 55 4e 20 20 20 20 20 20 30 78 62 64 66 32 30  RUN      0xbdf20
3e40: 64 61 33 20 20 20 20 2f 2a 20 56 44 42 45 20 69  da3    /* VDBE i
3e50: 73 20 72 65 61 64 79 20 74 6f 20 65 78 65 63 75  s ready to execu
3e60: 74 65 20 2a 2f 0a 23 64 65 66 69 6e 65 20 56 44  te */.#define VD
3e70: 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 20 20  BE_MAGIC_HALT   
3e80: 20 20 30 78 35 31 39 63 32 39 37 33 20 20 20 20    0x519c2973    
3e90: 2f 2a 20 56 44 42 45 20 68 61 73 20 63 6f 6d 70  /* VDBE has comp
3ea0: 6c 65 74 65 64 20 65 78 65 63 75 74 69 6f 6e 20  leted execution 
3eb0: 2a 2f 0a 23 64 65 66 69 6e 65 20 56 44 42 45 5f  */.#define VDBE_
3ec0: 4d 41 47 49 43 5f 44 45 41 44 20 20 20 20 20 30  MAGIC_DEAD     0
3ed0: 78 62 36 30 36 63 33 63 38 20 20 20 20 2f 2a 20  xb606c3c8    /* 
3ee0: 54 68 65 20 56 44 42 45 20 68 61 73 20 62 65 65  The VDBE has bee
3ef0: 6e 20 64 65 61 6c 6c 6f 63 61 74 65 64 20 2a 2f  n deallocated */
3f00: 0a 0a 2f 2a 0a 2a 2a 20 46 75 6e 63 74 69 6f 6e  ../*.** Function
3f10: 20 70 72 6f 74 6f 74 79 70 65 73 0a 2a 2f 0a 76   prototypes.*/.v
3f20: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 46  oid sqlite3VdbeF
3f30: 72 65 65 43 75 72 73 6f 72 28 56 64 62 65 20 2a  reeCursor(Vdbe *
3f40: 2c 20 43 75 72 73 6f 72 2a 29 3b 0a 76 6f 69 64  , Cursor*);.void
3f50: 20 73 71 6c 69 74 65 56 64 62 65 50 6f 70 53 74   sqliteVdbePopSt
3f60: 61 63 6b 28 56 64 62 65 2a 2c 69 6e 74 29 3b 0a  ack(Vdbe*,int);.
3f70: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 43  int sqlite3VdbeC
3f80: 75 72 73 6f 72 4d 6f 76 65 74 6f 28 43 75 72 73  ursorMoveto(Curs
3f90: 6f 72 2a 29 3b 0a 23 69 66 20 64 65 66 69 6e 65  or*);.#if define
3fa0: 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 20  d(SQLITE_DEBUG) 
3fb0: 7c 7c 20 64 65 66 69 6e 65 64 28 56 44 42 45 5f  || defined(VDBE_
3fc0: 50 52 4f 46 49 4c 45 29 0a 76 6f 69 64 20 73 71  PROFILE).void sq
3fd0: 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70  lite3VdbePrintOp
3fe0: 28 46 49 4c 45 2a 2c 20 69 6e 74 2c 20 4f 70 2a  (FILE*, int, Op*
3ff0: 29 3b 0a 23 65 6e 64 69 66 0a 23 69 66 64 65 66  );.#endif.#ifdef
4000: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 76 6f   SQLITE_DEBUG.vo
4010: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 50 72  id sqlite3VdbePr
4020: 69 6e 74 53 71 6c 28 56 64 62 65 2a 29 3b 0a 23  intSql(Vdbe*);.#
4030: 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65  endif.int sqlite
4040: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
4050: 65 6e 28 75 33 32 29 3b 0a 75 33 32 20 73 71 6c  en(u32);.u32 sql
4060: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
4070: 70 65 28 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69  pe(Mem*, int);.i
4080: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  nt sqlite3VdbeSe
4090: 72 69 61 6c 50 75 74 28 75 6e 73 69 67 6e 65 64  rialPut(unsigned
40a0: 20 63 68 61 72 2a 2c 20 69 6e 74 2c 20 4d 65 6d   char*, int, Mem
40b0: 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c  *, int);.int sql
40c0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65  ite3VdbeSerialGe
40d0: 74 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64  t(const unsigned
40e0: 20 63 68 61 72 2a 2c 20 75 33 32 2c 20 4d 65 6d   char*, u32, Mem
40f0: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  *);.void sqlite3
4100: 56 64 62 65 44 65 6c 65 74 65 41 75 78 44 61 74  VdbeDeleteAuxDat
4110: 61 28 56 64 62 65 46 75 6e 63 2a 2c 20 69 6e 74  a(VdbeFunc*, int
4120: 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 32 42  );..int sqlite2B
4130: 74 72 65 65 4b 65 79 43 6f 6d 70 61 72 65 28 42  treeKeyCompare(B
4140: 74 43 75 72 73 6f 72 20 2a 2c 20 63 6f 6e 73 74  tCursor *, const
4150: 20 76 6f 69 64 20 2a 2c 20 69 6e 74 2c 20 69 6e   void *, int, in
4160: 74 2c 20 69 6e 74 20 2a 29 3b 0a 69 6e 74 20 73  t, int *);.int s
4170: 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65 79  qlite3VdbeIdxKey
4180: 43 6f 6d 70 61 72 65 28 43 75 72 73 6f 72 2a 2c  Compare(Cursor*,
4190: 20 69 6e 74 20 2c 20 63 6f 6e 73 74 20 75 6e 73   int , const uns
41a0: 69 67 6e 65 64 20 63 68 61 72 2a 2c 20 69 6e 74  igned char*, int
41b0: 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  *);.int sqlite3V
41c0: 64 62 65 49 64 78 52 6f 77 69 64 28 42 74 43 75  dbeIdxRowid(BtCu
41d0: 72 73 6f 72 20 2a 2c 20 69 36 34 20 2a 29 3b 0a  rsor *, i64 *);.
41e0: 69 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f  int sqlite3MemCo
41f0: 6d 70 61 72 65 28 63 6f 6e 73 74 20 4d 65 6d 2a  mpare(const Mem*
4200: 2c 20 63 6f 6e 73 74 20 4d 65 6d 2a 2c 20 63 6f  , const Mem*, co
4210: 6e 73 74 20 43 6f 6c 6c 53 65 71 2a 29 3b 0a 69  nst CollSeq*);.i
4220: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 52 65  nt sqlite3VdbeRe
4230: 63 6f 72 64 43 6f 6d 70 61 72 65 28 76 6f 69 64  cordCompare(void
4240: 2a 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64  *,int,const void
4250: 2a 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69  *,int, const voi
4260: 64 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  d*);.int sqlite3
4270: 56 64 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28  VdbeIdxRowidLen(
4280: 63 6f 6e 73 74 20 75 38 2a 29 3b 0a 69 6e 74 20  const u8*);.int 
4290: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28  sqlite3VdbeExec(
42a0: 56 64 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69  Vdbe*);.int sqli
42b0: 74 65 33 56 64 62 65 4c 69 73 74 28 56 64 62 65  te3VdbeList(Vdbe
42c0: 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  *);.int sqlite3V
42d0: 64 62 65 48 61 6c 74 28 56 64 62 65 2a 29 3b 0a  dbeHalt(Vdbe*);.
42e0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 43  int sqlite3VdbeC
42f0: 68 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28 4d 65  hangeEncoding(Me
4300: 6d 20 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73  m *, int);.int s
4310: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70  qlite3VdbeMemCop
4320: 79 28 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20 4d 65  y(Mem*, const Me
4330: 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65  m*);.void sqlite
4340: 33 56 64 62 65 4d 65 6d 53 68 61 6c 6c 6f 77 43  3VdbeMemShallowC
4350: 6f 70 79 28 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20  opy(Mem*, const 
4360: 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20  Mem*, int);.int 
4370: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 6f  sqlite3VdbeMemMo
4380: 76 65 28 4d 65 6d 2a 2c 20 4d 65 6d 2a 29 3b 0a  ve(Mem*, Mem*);.
4390: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
43a0: 65 6d 4e 75 6c 54 65 72 6d 69 6e 61 74 65 28 4d  emNulTerminate(M
43b0: 65 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  em*);.int sqlite
43c0: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 4d  3VdbeMemSetStr(M
43d0: 65 6d 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a  em*, const char*
43e0: 2c 20 69 6e 74 2c 20 75 38 2c 20 76 6f 69 64 28  , int, u8, void(
43f0: 2a 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f 69 64  *)(void*));.void
4400: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
4410: 65 74 49 6e 74 36 34 28 4d 65 6d 2a 2c 20 69 36  etInt64(Mem*, i6
4420: 34 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  4);.void sqlite3
4430: 56 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65  VdbeMemSetDouble
4440: 28 4d 65 6d 2a 2c 20 64 6f 75 62 6c 65 29 3b 0a  (Mem*, double);.
4450: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
4460: 4d 65 6d 53 65 74 4e 75 6c 6c 28 4d 65 6d 2a 29  MemSetNull(Mem*)
4470: 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  ;.void sqlite3Vd
4480: 62 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62  beMemSetZeroBlob
4490: 28 4d 65 6d 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20  (Mem*,int);.int 
44a0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 45 78  sqlite3VdbeMemEx
44b0: 70 61 6e 64 42 6c 6f 62 28 4d 65 6d 2a 29 3b 0a  pandBlob(Mem*);.
44c0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
44d0: 65 6d 4d 61 6b 65 57 72 69 74 65 61 62 6c 65 28  emMakeWriteable(
44e0: 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  Mem*);.int sqlit
44f0: 65 33 56 64 62 65 4d 65 6d 44 79 6e 61 6d 69 63  e3VdbeMemDynamic
4500: 69 66 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73  ify(Mem*);.int s
4510: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 74 72  qlite3VdbeMemStr
4520: 69 6e 67 69 66 79 28 4d 65 6d 2a 2c 20 69 6e 74  ingify(Mem*, int
4530: 29 3b 0a 69 36 34 20 73 71 6c 69 74 65 33 56 64  );.i64 sqlite3Vd
4540: 62 65 49 6e 74 56 61 6c 75 65 28 4d 65 6d 2a 29  beIntValue(Mem*)
4550: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  ;.int sqlite3Vdb
4560: 65 4d 65 6d 49 6e 74 65 67 65 72 69 66 79 28 4d  eMemIntegerify(M
4570: 65 6d 2a 29 3b 0a 64 6f 75 62 6c 65 20 73 71 6c  em*);.double sql
4580: 69 74 65 33 56 64 62 65 52 65 61 6c 56 61 6c 75  ite3VdbeRealValu
4590: 65 28 4d 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71  e(Mem*);.void sq
45a0: 6c 69 74 65 33 56 64 62 65 49 6e 74 65 67 65 72  lite3VdbeInteger
45b0: 41 66 66 69 6e 69 74 79 28 4d 65 6d 2a 29 3b 0a  Affinity(Mem*);.
45c0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
45d0: 65 6d 52 65 61 6c 69 66 79 28 4d 65 6d 2a 29 3b  emRealify(Mem*);
45e0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
45f0: 4d 65 6d 4e 75 6d 65 72 69 66 79 28 4d 65 6d 2a  MemNumerify(Mem*
4600: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
4610: 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65 28 42  beMemFromBtree(B
4620: 74 43 75 72 73 6f 72 2a 2c 69 6e 74 2c 69 6e 74  tCursor*,int,int
4630: 2c 69 6e 74 2c 4d 65 6d 2a 29 3b 0a 76 6f 69 64  ,int,Mem*);.void
4640: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52   sqlite3VdbeMemR
4650: 65 6c 65 61 73 65 28 4d 65 6d 20 2a 70 29 3b 0a  elease(Mem *p);.
4660: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
4670: 65 6d 46 69 6e 61 6c 69 7a 65 28 4d 65 6d 2a 2c  emFinalize(Mem*,
4680: 20 46 75 6e 63 44 65 66 2a 29 3b 0a 23 69 66 6e   FuncDef*);.#ifn
4690: 64 65 66 20 4e 44 45 42 55 47 0a 76 6f 69 64 20  def NDEBUG.void 
46a0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 61  sqlite3VdbeMemSa
46b0: 6e 69 74 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20  nity(Mem*);.int 
46c0: 73 71 6c 69 74 65 33 56 64 62 65 4f 70 63 6f 64  sqlite3VdbeOpcod
46d0: 65 4e 6f 50 75 73 68 28 75 38 29 3b 0a 23 65 6e  eNoPush(u8);.#en
46e0: 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  dif.int sqlite3V
46f0: 64 62 65 4d 65 6d 54 72 61 6e 73 6c 61 74 65 28  dbeMemTranslate(
4700: 4d 65 6d 2a 2c 20 75 38 29 3b 0a 76 6f 69 64 20  Mem*, u8);.void 
4710: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 50 72  sqlite3VdbeMemPr
4720: 65 74 74 79 50 72 69 6e 74 28 4d 65 6d 20 2a 70  ettyPrint(Mem *p
4730: 4d 65 6d 2c 20 63 68 61 72 20 2a 7a 42 75 66 29  Mem, char *zBuf)
4740: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  ;.int sqlite3Vdb
4750: 65 4d 65 6d 48 61 6e 64 6c 65 42 6f 6d 28 4d 65  eMemHandleBom(Me
4760: 6d 20 2a 70 4d 65 6d 29 3b 0a 76 6f 69 64 20 73  m *pMem);.void s
4770: 71 6c 69 74 65 33 56 64 62 65 46 69 66 6f 49 6e  qlite3VdbeFifoIn
4780: 69 74 28 46 69 66 6f 2a 29 3b 0a 69 6e 74 20 73  it(Fifo*);.int s
4790: 71 6c 69 74 65 33 56 64 62 65 46 69 66 6f 50 75  qlite3VdbeFifoPu
47a0: 73 68 28 46 69 66 6f 2a 2c 20 69 36 34 29 3b 0a  sh(Fifo*, i64);.
47b0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 46  int sqlite3VdbeF
47c0: 69 66 6f 50 6f 70 28 46 69 66 6f 2a 2c 20 69 36  ifoPop(Fifo*, i6
47d0: 34 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65  4*);.void sqlite
47e0: 33 56 64 62 65 46 69 66 6f 43 6c 65 61 72 28 46  3VdbeFifoClear(F
47f0: 69 66 6f 2a 29 3b 0a 0a 23 65 6e 64 69 66 20 2f  ifo*);..#endif /
4800: 2a 20 21 64 65 66 69 6e 65 64 28 5f 56 44 42 45  * !defined(_VDBE
4810: 49 4e 54 5f 48 5f 29 20 2a 2f 0a                 INT_H_) */.