/ Hex Artifact Content
Login

Artifact 6e6f28e9bccc6c703dca1372fd661c57b5c15fb0:


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: 53 51 4c 20 69 73 20 74 72 61 6e 73 6c 61 74 65  SQL is translate
02f0: 64 20 69 6e 74 6f 20 61 20 73 65 71 75 65 6e 63  d into a sequenc
0300: 65 20 6f 66 20 69 6e 73 74 72 75 63 74 69 6f 6e  e of instruction
0310: 73 20 74 6f 20 62 65 0a 2a 2a 20 65 78 65 63 75  s to be.** execu
0320: 74 65 64 20 62 79 20 61 20 76 69 72 74 75 61 6c  ted by a virtual
0330: 20 6d 61 63 68 69 6e 65 2e 20 20 45 61 63 68 20   machine.  Each 
0340: 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73 20 61  instruction is a
0350: 6e 20 69 6e 73 74 61 6e 63 65 0a 2a 2a 20 6f 66  n instance.** of
0360: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73   the following s
0370: 74 72 75 63 74 75 72 65 2e 0a 2a 2f 0a 74 79 70  tructure..*/.typ
0380: 65 64 65 66 20 73 74 72 75 63 74 20 56 64 62 65  edef struct Vdbe
0390: 4f 70 20 4f 70 3b 0a 0a 2f 2a 0a 2a 2a 20 42 6f  Op Op;../*.** Bo
03a0: 6f 6c 65 61 6e 20 76 61 6c 75 65 73 0a 2a 2f 0a  olean values.*/.
03b0: 74 79 70 65 64 65 66 20 75 6e 73 69 67 6e 65 64  typedef unsigned
03c0: 20 63 68 61 72 20 42 6f 6f 6c 3b 0a 0a 2f 2a 0a   char Bool;../*.
03d0: 2a 2a 20 41 20 63 75 72 73 6f 72 20 69 73 20 61  ** A cursor is a
03e0: 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f 20 61 20   pointer into a 
03f0: 73 69 6e 67 6c 65 20 42 54 72 65 65 20 77 69 74  single BTree wit
0400: 68 69 6e 20 61 20 64 61 74 61 62 61 73 65 20 66  hin a database f
0410: 69 6c 65 2e 0a 2a 2a 20 54 68 65 20 63 75 72 73  ile..** The curs
0420: 6f 72 20 63 61 6e 20 73 65 65 6b 20 74 6f 20 61  or can seek to a
0430: 20 42 54 72 65 65 20 65 6e 74 72 79 20 77 69 74   BTree entry wit
0440: 68 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 6b  h a particular k
0450: 65 79 2c 20 6f 72 0a 2a 2a 20 6c 6f 6f 70 20 6f  ey, or.** loop o
0460: 76 65 72 20 61 6c 6c 20 65 6e 74 72 69 65 73 20  ver all entries 
0470: 6f 66 20 74 68 65 20 42 74 72 65 65 2e 20 20 59  of the Btree.  Y
0480: 6f 75 20 63 61 6e 20 61 6c 73 6f 20 69 6e 73 65  ou can also inse
0490: 72 74 20 6e 65 77 20 42 54 72 65 65 0a 2a 2a 20  rt new BTree.** 
04a0: 65 6e 74 72 69 65 73 20 6f 72 20 72 65 74 72 69  entries or retri
04b0: 65 76 65 20 74 68 65 20 6b 65 79 20 6f 72 20 64  eve the key or d
04c0: 61 74 61 20 66 72 6f 6d 20 74 68 65 20 65 6e 74  ata from the ent
04d0: 72 79 20 74 68 61 74 20 74 68 65 20 63 75 72 73  ry that the curs
04e0: 6f 72 0a 2a 2a 20 69 73 20 63 75 72 72 65 6e 74  or.** is current
04f0: 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f 2e 0a  ly pointing to..
0500: 2a 2a 20 0a 2a 2a 20 45 76 65 72 79 20 63 75 72  ** .** Every cur
0510: 73 6f 72 20 74 68 61 74 20 74 68 65 20 76 69 72  sor that the vir
0520: 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 68 61 73  tual machine has
0530: 20 6f 70 65 6e 20 69 73 20 72 65 70 72 65 73 65   open is represe
0540: 6e 74 65 64 20 62 79 20 61 6e 0a 2a 2a 20 69 6e  nted by an.** in
0550: 73 74 61 6e 63 65 20 6f 66 20 74 68 65 20 66 6f  stance of the fo
0560: 6c 6c 6f 77 69 6e 67 20 73 74 72 75 63 74 75 72  llowing structur
0570: 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56 64 62  e..*/.struct Vdb
0580: 65 43 75 72 73 6f 72 20 7b 0a 20 20 42 74 43 75  eCursor {.  BtCu
0590: 72 73 6f 72 20 2a 70 43 75 72 73 6f 72 3b 20 20  rsor *pCursor;  
05a0: 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20    /* The cursor 
05b0: 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 65  structure of the
05c0: 20 62 61 63 6b 65 6e 64 20 2a 2f 0a 20 20 42 74   backend */.  Bt
05d0: 72 65 65 20 2a 70 42 74 3b 20 20 20 20 20 20 20  ree *pBt;       
05e0: 20 20 20 20 2f 2a 20 53 65 70 61 72 61 74 65 20      /* Separate 
05f0: 66 69 6c 65 20 68 6f 6c 64 69 6e 67 20 74 65 6d  file holding tem
0600: 70 6f 72 61 72 79 20 74 61 62 6c 65 20 2a 2f 0a  porary table */.
0610: 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49    KeyInfo *pKeyI
0620: 6e 66 6f 3b 20 20 20 20 2f 2a 20 49 6e 66 6f 20  nfo;    /* Info 
0630: 61 62 6f 75 74 20 69 6e 64 65 78 20 6b 65 79 73  about index keys
0640: 20 6e 65 65 64 65 64 20 62 79 20 69 6e 64 65 78   needed by index
0650: 20 63 75 72 73 6f 72 73 20 2a 2f 0a 20 20 69 6e   cursors */.  in
0660: 74 20 69 44 62 3b 20 20 20 20 20 20 20 20 20 20  t iDb;          
0670: 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20      /* Index of 
0680: 63 75 72 73 6f 72 20 64 61 74 61 62 61 73 65 20  cursor database 
0690: 69 6e 20 64 62 2d 3e 61 44 62 5b 5d 20 28 6f 72  in db->aDb[] (or
06a0: 20 2d 31 29 20 2a 2f 0a 20 20 69 6e 74 20 70 73   -1) */.  int ps
06b0: 65 75 64 6f 54 61 62 6c 65 52 65 67 3b 20 20 20  eudoTableReg;   
06c0: 2f 2a 20 52 65 67 69 73 74 65 72 20 68 6f 6c 64  /* Register hold
06d0: 69 6e 67 20 70 73 65 75 64 6f 74 61 62 6c 65 20  ing pseudotable 
06e0: 63 6f 6e 74 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  content. */.  in
06f0: 74 20 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20  t nField;       
0700: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
0710: 20 66 69 65 6c 64 73 20 69 6e 20 74 68 65 20 68   fields in the h
0720: 65 61 64 65 72 20 2a 2f 0a 20 20 42 6f 6f 6c 20  eader */.  Bool 
0730: 7a 65 72 6f 65 64 3b 20 20 20 20 20 20 20 20 20  zeroed;         
0740: 20 2f 2a 20 54 72 75 65 20 69 66 20 7a 65 72 6f   /* True if zero
0750: 65 64 20 6f 75 74 20 61 6e 64 20 72 65 61 64 79  ed out and ready
0760: 20 66 6f 72 20 72 65 75 73 65 20 2a 2f 0a 20 20   for reuse */.  
0770: 42 6f 6f 6c 20 72 6f 77 69 64 49 73 56 61 6c 69  Bool rowidIsVali
0780: 64 3b 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66  d;    /* True if
0790: 20 6c 61 73 74 52 6f 77 69 64 20 69 73 20 76 61   lastRowid is va
07a0: 6c 69 64 20 2a 2f 0a 20 20 42 6f 6f 6c 20 61 74  lid */.  Bool at
07b0: 46 69 72 73 74 3b 20 20 20 20 20 20 20 20 20 2f  First;         /
07c0: 2a 20 54 72 75 65 20 69 66 20 70 6f 69 6e 74 69  * True if pointi
07d0: 6e 67 20 74 6f 20 66 69 72 73 74 20 65 6e 74 72  ng to first entr
07e0: 79 20 2a 2f 0a 20 20 42 6f 6f 6c 20 75 73 65 52  y */.  Bool useR
07f0: 61 6e 64 6f 6d 52 6f 77 69 64 3b 20 20 2f 2a 20  andomRowid;  /* 
0800: 47 65 6e 65 72 61 74 65 20 6e 65 77 20 72 65 63  Generate new rec
0810: 6f 72 64 20 6e 75 6d 62 65 72 73 20 73 65 6d 69  ord numbers semi
0820: 2d 72 61 6e 64 6f 6d 6c 79 20 2a 2f 0a 20 20 42  -randomly */.  B
0830: 6f 6f 6c 20 6e 75 6c 6c 52 6f 77 3b 20 20 20 20  ool nullRow;    
0840: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
0850: 70 6f 69 6e 74 69 6e 67 20 74 6f 20 61 20 72 6f  pointing to a ro
0860: 77 20 77 69 74 68 20 6e 6f 20 64 61 74 61 20 2a  w with no data *
0870: 2f 0a 20 20 42 6f 6f 6c 20 64 65 66 65 72 72 65  /.  Bool deferre
0880: 64 4d 6f 76 65 74 6f 3b 20 20 2f 2a 20 41 20 63  dMoveto;  /* A c
0890: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 42 74  all to sqlite3Bt
08a0: 72 65 65 4d 6f 76 65 74 6f 28 29 20 69 73 20 6e  reeMoveto() is n
08b0: 65 65 64 65 64 20 2a 2f 0a 20 20 42 6f 6f 6c 20  eeded */.  Bool 
08c0: 69 73 54 61 62 6c 65 3b 20 20 20 20 20 20 20 20  isTable;        
08d0: 20 2f 2a 20 54 72 75 65 20 69 66 20 61 20 74 61   /* True if a ta
08e0: 62 6c 65 20 72 65 71 75 69 72 69 6e 67 20 69 6e  ble requiring in
08f0: 74 65 67 65 72 20 6b 65 79 73 20 2a 2f 0a 20 20  teger keys */.  
0900: 42 6f 6f 6c 20 69 73 49 6e 64 65 78 3b 20 20 20  Bool isIndex;   
0910: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
0920: 20 61 6e 20 69 6e 64 65 78 20 63 6f 6e 74 61 69   an index contai
0930: 6e 69 6e 67 20 6b 65 79 73 20 6f 6e 6c 79 20 2d  ning keys only -
0940: 20 6e 6f 20 64 61 74 61 20 2a 2f 0a 20 20 42 6f   no data */.  Bo
0950: 6f 6c 20 69 73 4f 72 64 65 72 65 64 3b 20 20 20  ol isOrdered;   
0960: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74      /* True if t
0970: 68 65 20 75 6e 64 65 72 6c 79 69 6e 67 20 74 61  he underlying ta
0980: 62 6c 65 20 69 73 20 42 54 52 45 45 5f 55 4e 4f  ble is BTREE_UNO
0990: 52 44 45 52 45 44 20 2a 2f 0a 20 20 73 71 6c 69  RDERED */.  sqli
09a0: 74 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20  te3_vtab_cursor 
09b0: 2a 70 56 74 61 62 43 75 72 73 6f 72 3b 20 20 2f  *pVtabCursor;  /
09c0: 2a 20 54 68 65 20 63 75 72 73 6f 72 20 66 6f 72  * The cursor for
09d0: 20 61 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65   a virtual table
09e0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 73 71 6c 69   */.  const sqli
09f0: 74 65 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64  te3_module *pMod
0a00: 75 6c 65 3b 20 20 20 20 20 2f 2a 20 4d 6f 64 75  ule;     /* Modu
0a10: 6c 65 20 66 6f 72 20 63 75 72 73 6f 72 20 70 56  le for cursor pV
0a20: 74 61 62 43 75 72 73 6f 72 20 2a 2f 0a 20 20 69  tabCursor */.  i
0a30: 36 34 20 73 65 71 43 6f 75 6e 74 3b 20 20 20 20  64 seqCount;    
0a40: 20 20 20 20 20 2f 2a 20 53 65 71 75 65 6e 63 65       /* Sequence
0a50: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 69 36   counter */.  i6
0a60: 34 20 6d 6f 76 65 74 6f 54 61 72 67 65 74 3b 20  4 movetoTarget; 
0a70: 20 20 20 20 2f 2a 20 41 72 67 75 6d 65 6e 74 20      /* Argument 
0a80: 74 6f 20 74 68 65 20 64 65 66 65 72 72 65 64 20  to the deferred 
0a90: 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65  sqlite3BtreeMove
0aa0: 74 6f 28 29 20 2a 2f 0a 20 20 69 36 34 20 6c 61  to() */.  i64 la
0ab0: 73 74 52 6f 77 69 64 3b 20 20 20 20 20 20 20 20  stRowid;        
0ac0: 2f 2a 20 4c 61 73 74 20 72 6f 77 69 64 20 66 72  /* Last rowid fr
0ad0: 6f 6d 20 61 20 4e 65 78 74 20 6f 72 20 4e 65 78  om a Next or Nex
0ae0: 74 49 64 78 20 6f 70 65 72 61 74 69 6f 6e 20 2a  tIdx operation *
0af0: 2f 0a 0a 20 20 2f 2a 20 52 65 73 75 6c 74 20 6f  /..  /* Result o
0b00: 66 20 6c 61 73 74 20 73 71 6c 69 74 65 33 42 74  f last sqlite3Bt
0b10: 72 65 65 4d 6f 76 65 74 6f 28 29 20 64 6f 6e 65  reeMoveto() done
0b20: 20 62 79 20 61 6e 20 4f 50 5f 4e 6f 74 45 78 69   by an OP_NotExi
0b30: 73 74 73 20 6f 72 20 0a 20 20 2a 2a 20 4f 50 5f  sts or .  ** OP_
0b40: 49 73 55 6e 69 71 75 65 20 6f 70 63 6f 64 65 20  IsUnique opcode 
0b50: 6f 6e 20 74 68 69 73 20 63 75 72 73 6f 72 2e 20  on this cursor. 
0b60: 2a 2f 0a 20 20 69 6e 74 20 73 65 65 6b 52 65 73  */.  int seekRes
0b70: 75 6c 74 3b 0a 0a 20 20 2f 2a 20 43 61 63 68 65  ult;..  /* Cache
0b80: 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62  d information ab
0b90: 6f 75 74 20 74 68 65 20 68 65 61 64 65 72 20 66  out the header f
0ba0: 6f 72 20 74 68 65 20 64 61 74 61 20 72 65 63 6f  or the data reco
0bb0: 72 64 20 74 68 61 74 20 74 68 65 0a 20 20 2a 2a  rd that the.  **
0bc0: 20 63 75 72 73 6f 72 20 69 73 20 63 75 72 72 65   cursor is curre
0bd0: 6e 74 6c 79 20 70 6f 69 6e 74 69 6e 67 20 74 6f  ntly pointing to
0be0: 2e 20 20 4f 6e 6c 79 20 76 61 6c 69 64 20 69 66  .  Only valid if
0bf0: 20 63 61 63 68 65 53 74 61 74 75 73 20 6d 61 74   cacheStatus mat
0c00: 63 68 65 73 0a 20 20 2a 2a 20 56 64 62 65 2e 63  ches.  ** Vdbe.c
0c10: 61 63 68 65 43 74 72 2e 20 20 56 64 62 65 2e 63  acheCtr.  Vdbe.c
0c20: 61 63 68 65 43 74 72 20 77 69 6c 6c 20 6e 65 76  acheCtr will nev
0c30: 65 72 20 74 61 6b 65 20 6f 6e 20 74 68 65 20 76  er take on the v
0c40: 61 6c 75 65 20 6f 66 0a 20 20 2a 2a 20 43 41 43  alue of.  ** CAC
0c50: 48 45 5f 53 54 41 4c 45 20 61 6e 64 20 73 6f 20  HE_STALE and so 
0c60: 73 65 74 74 69 6e 67 20 63 61 63 68 65 53 74 61  setting cacheSta
0c70: 74 75 73 3d 43 41 43 48 45 5f 53 54 41 4c 45 20  tus=CACHE_STALE 
0c80: 67 75 61 72 61 6e 74 65 65 73 20 74 68 61 74 0a  guarantees that.
0c90: 20 20 2a 2a 20 74 68 65 20 63 61 63 68 65 20 69    ** the cache i
0ca0: 73 20 6f 75 74 20 6f 66 20 64 61 74 65 2e 0a 20  s out of date.. 
0cb0: 20 2a 2a 0a 20 20 2a 2a 20 61 52 6f 77 20 6d 69   **.  ** aRow mi
0cc0: 67 68 74 20 70 6f 69 6e 74 20 74 6f 20 28 65 70  ght point to (ep
0cd0: 68 65 6d 65 72 61 6c 29 20 64 61 74 61 20 66 6f  hemeral) data fo
0ce0: 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f  r the current ro
0cf0: 77 2c 20 6f 72 20 69 74 20 6d 69 67 68 74 0a 20  w, or it might. 
0d00: 20 2a 2a 20 62 65 20 4e 55 4c 4c 2e 0a 20 20 2a   ** be NULL..  *
0d10: 2f 0a 20 20 75 33 32 20 63 61 63 68 65 53 74 61  /.  u32 cacheSta
0d20: 74 75 73 3b 20 20 20 20 20 20 2f 2a 20 43 61 63  tus;      /* Cac
0d30: 68 65 20 69 73 20 76 61 6c 69 64 20 69 66 20 74  he is valid if t
0d40: 68 69 73 20 6d 61 74 63 68 65 73 20 56 64 62 65  his matches Vdbe
0d50: 2e 63 61 63 68 65 43 74 72 20 2a 2f 0a 20 20 69  .cacheCtr */.  i
0d60: 6e 74 20 70 61 79 6c 6f 61 64 53 69 7a 65 3b 20  nt payloadSize; 
0d70: 20 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75       /* Total nu
0d80: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e  mber of bytes in
0d90: 20 74 68 65 20 72 65 63 6f 72 64 20 2a 2f 0a 20   the record */. 
0da0: 20 75 33 32 20 2a 61 54 79 70 65 3b 20 20 20 20   u32 *aType;    
0db0: 20 20 20 20 20 20 20 2f 2a 20 54 79 70 65 20 76         /* Type v
0dc0: 61 6c 75 65 73 20 66 6f 72 20 61 6c 6c 20 65 6e  alues for all en
0dd0: 74 72 69 65 73 20 69 6e 20 74 68 65 20 72 65 63  tries in the rec
0de0: 6f 72 64 20 2a 2f 0a 20 20 75 33 32 20 2a 61 4f  ord */.  u32 *aO
0df0: 66 66 73 65 74 3b 20 20 20 20 20 20 20 20 20 2f  ffset;         /
0e00: 2a 20 43 61 63 68 65 64 20 6f 66 66 73 65 74 73  * Cached offsets
0e10: 20 74 6f 20 74 68 65 20 73 74 61 72 74 20 6f 66   to the start of
0e20: 20 65 61 63 68 20 63 6f 6c 75 6d 6e 73 20 64 61   each columns da
0e30: 74 61 20 2a 2f 0a 20 20 75 38 20 2a 61 52 6f 77  ta */.  u8 *aRow
0e40: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
0e50: 20 44 61 74 61 20 66 6f 72 20 74 68 65 20 63 75   Data for the cu
0e60: 72 72 65 6e 74 20 72 6f 77 2c 20 69 66 20 61 6c  rrent row, if al
0e70: 6c 20 6f 6e 20 6f 6e 65 20 70 61 67 65 20 2a 2f  l on one page */
0e80: 0a 7d 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75  .};.typedef stru
0e90: 63 74 20 56 64 62 65 43 75 72 73 6f 72 20 56 64  ct VdbeCursor Vd
0ea0: 62 65 43 75 72 73 6f 72 3b 0a 0a 2f 2a 0a 2a 2a  beCursor;../*.**
0eb0: 20 57 68 65 6e 20 61 20 73 75 62 2d 70 72 6f 67   When a sub-prog
0ec0: 72 61 6d 20 69 73 20 65 78 65 63 75 74 65 64 20  ram is executed 
0ed0: 28 4f 50 5f 50 72 6f 67 72 61 6d 29 2c 20 61 20  (OP_Program), a 
0ee0: 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 69  structure of thi
0ef0: 73 20 74 79 70 65 0a 2a 2a 20 69 73 20 61 6c 6c  s type.** is all
0f00: 6f 63 61 74 65 64 20 74 6f 20 73 74 6f 72 65 20  ocated to store 
0f10: 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75  the current valu
0f20: 65 20 6f 66 20 74 68 65 20 70 72 6f 67 72 61 6d  e of the program
0f30: 20 63 6f 75 6e 74 65 72 2c 20 61 73 0a 2a 2a 20   counter, as.** 
0f40: 77 65 6c 6c 20 61 73 20 74 68 65 20 63 75 72 72  well as the curr
0f50: 65 6e 74 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 20  ent memory cell 
0f60: 61 72 72 61 79 20 61 6e 64 20 76 61 72 69 6f 75  array and variou
0f70: 73 20 6f 74 68 65 72 20 66 72 61 6d 65 20 73 70  s other frame sp
0f80: 65 63 69 66 69 63 0a 2a 2a 20 76 61 6c 75 65 73  ecific.** values
0f90: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 56   stored in the V
0fa0: 64 62 65 20 73 74 72 75 63 74 2e 20 57 68 65 6e  dbe struct. When
0fb0: 20 74 68 65 20 73 75 62 2d 70 72 6f 67 72 61 6d   the sub-program
0fc0: 20 69 73 20 66 69 6e 69 73 68 65 64 2c 20 0a 2a   is finished, .*
0fd0: 2a 20 74 68 65 73 65 20 76 61 6c 75 65 73 20 61  * these values a
0fe0: 72 65 20 63 6f 70 69 65 64 20 62 61 63 6b 20 74  re copied back t
0ff0: 6f 20 74 68 65 20 56 64 62 65 20 66 72 6f 6d 20  o the Vdbe from 
1000: 74 68 65 20 56 64 62 65 46 72 61 6d 65 20 73 74  the VdbeFrame st
1010: 72 75 63 74 75 72 65 2c 0a 2a 2a 20 72 65 73 74  ructure,.** rest
1020: 6f 72 69 6e 67 20 74 68 65 20 73 74 61 74 65 20  oring the state 
1030: 6f 66 20 74 68 65 20 56 4d 20 74 6f 20 61 73 20  of the VM to as 
1040: 69 74 20 77 61 73 20 62 65 66 6f 72 65 20 74 68  it was before th
1050: 65 20 73 75 62 2d 70 72 6f 67 72 61 6d 0a 2a 2a  e sub-program.**
1060: 20 62 65 67 61 6e 20 65 78 65 63 75 74 69 6e 67   began executing
1070: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 6d 65 6d 6f  ..**.** The memo
1080: 72 79 20 66 6f 72 20 61 20 56 64 62 65 46 72 61  ry for a VdbeFra
1090: 6d 65 20 6f 62 6a 65 63 74 20 69 73 20 61 6c 6c  me object is all
10a0: 6f 63 61 74 65 64 20 61 6e 64 20 6d 61 6e 61 67  ocated and manag
10b0: 65 64 20 62 79 20 61 20 6d 65 6d 6f 72 79 0a 2a  ed by a memory.*
10c0: 2a 20 63 65 6c 6c 20 69 6e 20 74 68 65 20 70 61  * cell in the pa
10d0: 72 65 6e 74 20 28 63 61 6c 6c 69 6e 67 29 20 66  rent (calling) f
10e0: 72 61 6d 65 2e 20 57 68 65 6e 20 74 68 65 20 6d  rame. When the m
10f0: 65 6d 6f 72 79 20 63 65 6c 6c 20 69 73 20 64 65  emory cell is de
1100: 6c 65 74 65 64 20 6f 72 0a 2a 2a 20 6f 76 65 72  leted or.** over
1110: 77 72 69 74 74 65 6e 2c 20 74 68 65 20 56 64 62  written, the Vdb
1120: 65 46 72 61 6d 65 20 6f 62 6a 65 63 74 20 69 73  eFrame object is
1130: 20 6e 6f 74 20 66 72 65 65 64 20 69 6d 6d 65 64   not freed immed
1140: 69 61 74 65 6c 79 2e 20 49 6e 73 74 65 61 64 2c  iately. Instead,
1150: 20 69 74 0a 2a 2a 20 69 73 20 6c 69 6e 6b 65 64   it.** is linked
1160: 20 69 6e 74 6f 20 74 68 65 20 56 64 62 65 2e 70   into the Vdbe.p
1170: 44 65 6c 46 72 61 6d 65 20 6c 69 73 74 2e 20 54  DelFrame list. T
1180: 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 74  he contents of t
1190: 68 65 20 56 64 62 65 2e 70 44 65 6c 46 72 61 6d  he Vdbe.pDelFram
11a0: 65 0a 2a 2a 20 6c 69 73 74 20 69 73 20 64 65 6c  e.** list is del
11b0: 65 74 65 64 20 77 68 65 6e 20 74 68 65 20 56 4d  eted when the VM
11c0: 20 69 73 20 72 65 73 65 74 20 69 6e 20 56 64 62   is reset in Vdb
11d0: 65 48 61 6c 74 28 29 2e 20 54 68 65 20 72 65 61  eHalt(). The rea
11e0: 73 6f 6e 20 66 6f 72 20 64 6f 69 6e 67 0a 2a 2a  son for doing.**
11f0: 20 74 68 69 73 20 69 6e 73 74 65 61 64 20 6f 66   this instead of
1200: 20 64 65 6c 65 74 69 6e 67 20 74 68 65 20 56 64   deleting the Vd
1210: 62 65 46 72 61 6d 65 20 69 6d 6d 65 64 69 61 74  beFrame immediat
1220: 65 6c 79 20 69 73 20 74 6f 20 61 76 6f 69 64 20  ely is to avoid 
1230: 72 65 63 75 72 73 69 76 65 0a 2a 2a 20 63 61 6c  recursive.** cal
1240: 6c 73 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62  ls to sqlite3Vdb
1250: 65 4d 65 6d 52 65 6c 65 61 73 65 28 29 20 77 68  eMemRelease() wh
1260: 65 6e 20 74 68 65 20 6d 65 6d 6f 72 79 20 63 65  en the memory ce
1270: 6c 6c 73 20 62 65 6c 6f 6e 67 69 6e 67 20 74 6f  lls belonging to
1280: 20 74 68 65 0a 2a 2a 20 63 68 69 6c 64 20 66 72   the.** child fr
1290: 61 6d 65 20 61 72 65 20 72 65 6c 65 61 73 65 64  ame are released
12a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 75 72 72  ..**.** The curr
12b0: 65 6e 74 6c 79 20 65 78 65 63 75 74 69 6e 67 20  ently executing 
12c0: 66 72 61 6d 65 20 69 73 20 73 74 6f 72 65 64 20  frame is stored 
12d0: 69 6e 20 56 64 62 65 2e 70 46 72 61 6d 65 2e 20  in Vdbe.pFrame. 
12e0: 56 64 62 65 2e 70 46 72 61 6d 65 20 69 73 0a 2a  Vdbe.pFrame is.*
12f0: 2a 20 73 65 74 20 74 6f 20 4e 55 4c 4c 20 69 66  * set to NULL if
1300: 20 74 68 65 20 63 75 72 72 65 6e 74 6c 79 20 65   the currently e
1310: 78 65 63 75 74 69 6e 67 20 66 72 61 6d 65 20 69  xecuting frame i
1320: 73 20 74 68 65 20 6d 61 69 6e 20 70 72 6f 67 72  s the main progr
1330: 61 6d 2e 0a 2a 2f 0a 74 79 70 65 64 65 66 20 73  am..*/.typedef s
1340: 74 72 75 63 74 20 56 64 62 65 46 72 61 6d 65 20  truct VdbeFrame 
1350: 56 64 62 65 46 72 61 6d 65 3b 0a 73 74 72 75 63  VdbeFrame;.struc
1360: 74 20 56 64 62 65 46 72 61 6d 65 20 7b 0a 20 20  t VdbeFrame {.  
1370: 56 64 62 65 20 2a 76 3b 20 20 20 20 20 20 20 20  Vdbe *v;        
1380: 20 20 20 20 20 20 20 20 2f 2a 20 56 4d 20 74 68          /* VM th
1390: 69 73 20 66 72 61 6d 65 20 62 65 6c 6f 6e 67 73  is frame belongs
13a0: 20 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 70 63 3b   to */.  int pc;
13b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
13c0: 20 2f 2a 20 50 72 6f 67 72 61 6d 20 43 6f 75 6e   /* Program Coun
13d0: 74 65 72 20 69 6e 20 70 61 72 65 6e 74 20 28 63  ter in parent (c
13e0: 61 6c 6c 69 6e 67 29 20 66 72 61 6d 65 20 2a 2f  alling) frame */
13f0: 0a 20 20 4f 70 20 2a 61 4f 70 3b 20 20 20 20 20  .  Op *aOp;     
1400: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72             /* Pr
1410: 6f 67 72 61 6d 20 69 6e 73 74 72 75 63 74 69 6f  ogram instructio
1420: 6e 73 20 66 6f 72 20 70 61 72 65 6e 74 20 66 72  ns for parent fr
1430: 61 6d 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 4f 70  ame */.  int nOp
1440: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1450: 20 2f 2a 20 53 69 7a 65 20 6f 66 20 61 4f 70 20   /* Size of aOp 
1460: 61 72 72 61 79 20 2a 2f 0a 20 20 4d 65 6d 20 2a  array */.  Mem *
1470: 61 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20  aMem;           
1480: 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20 6d     /* Array of m
1490: 65 6d 6f 72 79 20 63 65 6c 6c 73 20 66 6f 72 20  emory cells for 
14a0: 70 61 72 65 6e 74 20 66 72 61 6d 65 20 2a 2f 0a  parent frame */.
14b0: 20 20 69 6e 74 20 6e 4d 65 6d 3b 20 20 20 20 20    int nMem;     
14c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
14d0: 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69  ber of entries i
14e0: 6e 20 61 4d 65 6d 20 2a 2f 0a 20 20 56 64 62 65  n aMem */.  Vdbe
14f0: 43 75 72 73 6f 72 20 2a 2a 61 70 43 73 72 3b 20  Cursor **apCsr; 
1500: 20 20 20 20 2f 2a 20 41 72 72 61 79 20 6f 66 20      /* Array of 
1510: 56 64 62 65 20 63 75 72 73 6f 72 73 20 66 6f 72  Vdbe cursors for
1520: 20 70 61 72 65 6e 74 20 66 72 61 6d 65 20 2a 2f   parent frame */
1530: 0a 20 20 75 31 36 20 6e 43 75 72 73 6f 72 3b 20  .  u16 nCursor; 
1540: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
1550: 6d 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20  mber of entries 
1560: 69 6e 20 61 70 43 73 72 20 2a 2f 0a 20 20 76 6f  in apCsr */.  vo
1570: 69 64 20 2a 74 6f 6b 65 6e 3b 20 20 20 20 20 20  id *token;      
1580: 20 20 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 66        /* Copy of
1590: 20 53 75 62 50 72 6f 67 72 61 6d 2e 74 6f 6b 65   SubProgram.toke
15a0: 6e 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 68 69 6c  n */.  int nChil
15b0: 64 4d 65 6d 3b 20 20 20 20 20 20 20 20 20 20 2f  dMem;          /
15c0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f  * Number of memo
15d0: 72 79 20 63 65 6c 6c 73 20 66 6f 72 20 63 68 69  ry cells for chi
15e0: 6c 64 20 66 72 61 6d 65 20 2a 2f 0a 20 20 69 6e  ld frame */.  in
15f0: 74 20 6e 43 68 69 6c 64 43 73 72 3b 20 20 20 20  t nChildCsr;    
1600: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
1610: 6f 66 20 63 75 72 73 6f 72 73 20 66 6f 72 20 63  of cursors for c
1620: 68 69 6c 64 20 66 72 61 6d 65 20 2a 2f 0a 20 20  hild frame */.  
1630: 69 36 34 20 6c 61 73 74 52 6f 77 69 64 3b 20 20  i64 lastRowid;  
1640: 20 20 20 20 20 20 20 20 2f 2a 20 4c 61 73 74 20          /* Last 
1650: 69 6e 73 65 72 74 20 72 6f 77 69 64 20 28 73 71  insert rowid (sq
1660: 6c 69 74 65 33 2e 6c 61 73 74 52 6f 77 69 64 29  lite3.lastRowid)
1670: 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 68 61 6e 67   */.  int nChang
1680: 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  e;            /*
1690: 20 53 74 61 74 65 6d 65 6e 74 20 63 68 61 6e 67   Statement chang
16a0: 65 73 20 28 56 64 62 65 2e 6e 43 68 61 6e 67 65  es (Vdbe.nChange
16b0: 73 29 20 20 20 20 20 2a 2f 0a 20 20 56 64 62 65  s)     */.  Vdbe
16c0: 46 72 61 6d 65 20 2a 70 50 61 72 65 6e 74 3b 20  Frame *pParent; 
16d0: 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 6f 66      /* Parent of
16e0: 20 74 68 69 73 20 66 72 61 6d 65 2c 20 6f 72 20   this frame, or 
16f0: 4e 55 4c 4c 20 69 66 20 70 61 72 65 6e 74 20 69  NULL if parent i
1700: 73 20 6d 61 69 6e 20 2a 2f 0a 7d 3b 0a 0a 23 64  s main */.};..#d
1710: 65 66 69 6e 65 20 56 64 62 65 46 72 61 6d 65 4d  efine VdbeFrameM
1720: 65 6d 28 70 29 20 28 28 4d 65 6d 20 2a 29 26 28  em(p) ((Mem *)&(
1730: 28 75 38 20 2a 29 70 29 5b 52 4f 55 4e 44 38 28  (u8 *)p)[ROUND8(
1740: 73 69 7a 65 6f 66 28 56 64 62 65 46 72 61 6d 65  sizeof(VdbeFrame
1750: 29 29 5d 29 0a 0a 2f 2a 0a 2a 2a 20 41 20 76 61  ))])../*.** A va
1760: 6c 75 65 20 66 6f 72 20 56 64 62 65 43 75 72 73  lue for VdbeCurs
1770: 6f 72 2e 63 61 63 68 65 56 61 6c 69 64 20 74 68  or.cacheValid th
1780: 61 74 20 6d 65 61 6e 73 20 74 68 65 20 63 61 63  at means the cac
1790: 68 65 20 69 73 20 61 6c 77 61 79 73 20 69 6e 76  he is always inv
17a0: 61 6c 69 64 2e 0a 2a 2f 0a 23 64 65 66 69 6e 65  alid..*/.#define
17b0: 20 43 41 43 48 45 5f 53 54 41 4c 45 20 30 0a 0a   CACHE_STALE 0..
17c0: 2f 2a 0a 2a 2a 20 49 6e 74 65 72 6e 61 6c 6c 79  /*.** Internally
17d0: 2c 20 74 68 65 20 76 64 62 65 20 6d 61 6e 69 70  , the vdbe manip
17e0: 75 6c 61 74 65 73 20 6e 65 61 72 6c 79 20 61 6c  ulates nearly al
17f0: 6c 20 53 51 4c 20 76 61 6c 75 65 73 20 61 73 20  l SQL values as 
1800: 4d 65 6d 0a 2a 2a 20 73 74 72 75 63 74 75 72 65  Mem.** structure
1810: 73 2e 20 45 61 63 68 20 4d 65 6d 20 73 74 72 75  s. Each Mem stru
1820: 63 74 20 6d 61 79 20 63 61 63 68 65 20 6d 75 6c  ct may cache mul
1830: 74 69 70 6c 65 20 72 65 70 72 65 73 65 6e 74 61  tiple representa
1840: 74 69 6f 6e 73 20 28 73 74 72 69 6e 67 2c 0a 2a  tions (string,.*
1850: 2a 20 69 6e 74 65 67 65 72 20 65 74 63 2e 29 20  * integer etc.) 
1860: 6f 66 20 74 68 65 20 73 61 6d 65 20 76 61 6c 75  of the same valu
1870: 65 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 4d 65 6d  e..*/.struct Mem
1880: 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62   {.  sqlite3 *db
1890: 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20  ;        /* The 
18a0: 61 73 73 6f 63 69 61 74 65 64 20 64 61 74 61 62  associated datab
18b0: 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a  ase connection *
18c0: 2f 0a 20 20 63 68 61 72 20 2a 7a 3b 20 20 20 20  /.  char *z;    
18d0: 20 20 20 20 20 20 20 20 2f 2a 20 53 74 72 69 6e          /* Strin
18e0: 67 20 6f 72 20 42 4c 4f 42 20 76 61 6c 75 65 20  g or BLOB value 
18f0: 2a 2f 0a 20 20 64 6f 75 62 6c 65 20 72 3b 20 20  */.  double r;  
1900: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 61 6c           /* Real
1910: 20 76 61 6c 75 65 20 2a 2f 0a 20 20 75 6e 69 6f   value */.  unio
1920: 6e 20 7b 0a 20 20 20 20 69 36 34 20 69 3b 20 20  n {.    i64 i;  
1930: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49              /* I
1940: 6e 74 65 67 65 72 20 76 61 6c 75 65 20 75 73 65  nteger value use
1950: 64 20 77 68 65 6e 20 4d 45 4d 5f 49 6e 74 20 69  d when MEM_Int i
1960: 73 20 73 65 74 20 69 6e 20 66 6c 61 67 73 20 2a  s set in flags *
1970: 2f 0a 20 20 20 20 69 6e 74 20 6e 5a 65 72 6f 3b  /.    int nZero;
1980: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65            /* Use
1990: 64 20 77 68 65 6e 20 62 69 74 20 4d 45 4d 5f 5a  d when bit MEM_Z
19a0: 65 72 6f 20 69 73 20 73 65 74 20 69 6e 20 66 6c  ero is set in fl
19b0: 61 67 73 20 2a 2f 0a 20 20 20 20 46 75 6e 63 44  ags */.    FuncD
19c0: 65 66 20 2a 70 44 65 66 3b 20 20 20 20 20 20 2f  ef *pDef;      /
19d0: 2a 20 55 73 65 64 20 6f 6e 6c 79 20 77 68 65 6e  * Used only when
19e0: 20 66 6c 61 67 73 3d 3d 4d 45 4d 5f 41 67 67 20   flags==MEM_Agg 
19f0: 2a 2f 0a 20 20 20 20 52 6f 77 53 65 74 20 2a 70  */.    RowSet *p
1a00: 52 6f 77 53 65 74 3b 20 20 20 20 2f 2a 20 55 73  RowSet;    /* Us
1a10: 65 64 20 6f 6e 6c 79 20 77 68 65 6e 20 66 6c 61  ed only when fla
1a20: 67 73 3d 3d 4d 45 4d 5f 52 6f 77 53 65 74 20 2a  gs==MEM_RowSet *
1a30: 2f 0a 20 20 20 20 56 64 62 65 46 72 61 6d 65 20  /.    VdbeFrame 
1a40: 2a 70 46 72 61 6d 65 3b 20 20 2f 2a 20 55 73 65  *pFrame;  /* Use
1a50: 64 20 77 68 65 6e 20 66 6c 61 67 73 3d 3d 4d 45  d when flags==ME
1a60: 4d 5f 46 72 61 6d 65 20 2a 2f 0a 20 20 7d 20 75  M_Frame */.  } u
1a70: 3b 0a 20 20 69 6e 74 20 6e 3b 20 20 20 20 20 20  ;.  int n;      
1a80: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65          /* Numbe
1a90: 72 20 6f 66 20 63 68 61 72 61 63 74 65 72 73 20  r of characters 
1aa0: 69 6e 20 73 74 72 69 6e 67 20 76 61 6c 75 65 2c  in string value,
1ab0: 20 65 78 63 6c 75 64 69 6e 67 20 27 5c 30 27 20   excluding '\0' 
1ac0: 2a 2f 0a 20 20 75 31 36 20 66 6c 61 67 73 3b 20  */.  u16 flags; 
1ad0: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f 6d 65           /* Some
1ae0: 20 63 6f 6d 62 69 6e 61 74 69 6f 6e 20 6f 66 20   combination of 
1af0: 4d 45 4d 5f 4e 75 6c 6c 2c 20 4d 45 4d 5f 53 74  MEM_Null, MEM_St
1b00: 72 2c 20 4d 45 4d 5f 44 79 6e 2c 20 65 74 63 2e  r, MEM_Dyn, etc.
1b10: 20 2a 2f 0a 20 20 75 38 20 20 74 79 70 65 3b 20   */.  u8  type; 
1b20: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 6e 65            /* One
1b30: 20 6f 66 20 53 51 4c 49 54 45 5f 4e 55 4c 4c 2c   of SQLITE_NULL,
1b40: 20 53 51 4c 49 54 45 5f 54 45 58 54 2c 20 53 51   SQLITE_TEXT, SQ
1b50: 4c 49 54 45 5f 49 4e 54 45 47 45 52 2c 20 65 74  LITE_INTEGER, et
1b60: 63 20 2a 2f 0a 20 20 75 38 20 20 65 6e 63 3b 20  c */.  u8  enc; 
1b70: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 51             /* SQ
1b80: 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49 54  LITE_UTF8, SQLIT
1b90: 45 5f 55 54 46 31 36 42 45 2c 20 53 51 4c 49 54  E_UTF16BE, SQLIT
1ba0: 45 5f 55 54 46 31 36 4c 45 20 2a 2f 0a 23 69 66  E_UTF16LE */.#if
1bb0: 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47  def SQLITE_DEBUG
1bc0: 0a 20 20 4d 65 6d 20 2a 70 53 63 6f 70 79 46 72  .  Mem *pScopyFr
1bd0: 6f 6d 3b 20 20 20 20 2f 2a 20 54 68 69 73 20 4d  om;    /* This M
1be0: 65 6d 20 69 73 20 61 20 73 68 61 6c 6c 6f 77 20  em is a shallow 
1bf0: 63 6f 70 79 20 6f 66 20 70 53 63 6f 70 79 46 72  copy of pScopyFr
1c00: 6f 6d 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 46  om */.  void *pF
1c10: 69 6c 6c 65 72 3b 20 20 20 20 20 20 2f 2a 20 53  iller;      /* S
1c20: 6f 20 74 68 61 74 20 73 69 7a 65 6f 66 28 4d 65  o that sizeof(Me
1c30: 6d 29 20 69 73 20 61 20 6d 75 6c 74 69 70 6c 65  m) is a multiple
1c40: 20 6f 66 20 38 20 2a 2f 0a 23 65 6e 64 69 66 0a   of 8 */.#endif.
1c50: 20 20 76 6f 69 64 20 28 2a 78 44 65 6c 29 28 76    void (*xDel)(v
1c60: 6f 69 64 20 2a 29 3b 20 20 2f 2a 20 49 66 20 6e  oid *);  /* If n
1c70: 6f 74 20 6e 75 6c 6c 2c 20 63 61 6c 6c 20 74 68  ot null, call th
1c80: 69 73 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 64  is function to d
1c90: 65 6c 65 74 65 20 4d 65 6d 2e 7a 20 2a 2f 0a 20  elete Mem.z */. 
1ca0: 20 63 68 61 72 20 2a 7a 4d 61 6c 6c 6f 63 3b 20   char *zMalloc; 
1cb0: 20 20 20 20 20 2f 2a 20 44 79 6e 61 6d 69 63 20       /* Dynamic 
1cc0: 62 75 66 66 65 72 20 61 6c 6c 6f 63 61 74 65 64  buffer allocated
1cd0: 20 62 79 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c   by sqlite3_mall
1ce0: 6f 63 28 29 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 20 4f  oc() */.};../* O
1cf0: 6e 65 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68  ne or more of th
1d00: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 6c 61 67  e following flag
1d10: 73 20 61 72 65 20 73 65 74 20 74 6f 20 69 6e 64  s are set to ind
1d20: 69 63 61 74 65 20 74 68 65 20 76 61 6c 69 64 4f  icate the validO
1d30: 4b 0a 2a 2a 20 72 65 70 72 65 73 65 6e 74 61 74  K.** representat
1d40: 69 6f 6e 73 20 6f 66 20 74 68 65 20 76 61 6c 75  ions of the valu
1d50: 65 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20  e stored in the 
1d60: 4d 65 6d 20 73 74 72 75 63 74 2e 0a 2a 2a 0a 2a  Mem struct..**.*
1d70: 2a 20 49 66 20 74 68 65 20 4d 45 4d 5f 4e 75 6c  * If the MEM_Nul
1d80: 6c 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74  l flag is set, t
1d90: 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 69 73  hen the value is
1da0: 20 61 6e 20 53 51 4c 20 4e 55 4c 4c 20 76 61 6c   an SQL NULL val
1db0: 75 65 2e 0a 2a 2a 20 4e 6f 20 6f 74 68 65 72 20  ue..** No other 
1dc0: 66 6c 61 67 73 20 6d 61 79 20 62 65 20 73 65 74  flags may be set
1dd0: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a   in this case..*
1de0: 2a 0a 2a 2a 20 49 66 20 74 68 65 20 4d 45 4d 5f  *.** If the MEM_
1df0: 53 74 72 20 66 6c 61 67 20 69 73 20 73 65 74 20  Str flag is set 
1e00: 74 68 65 6e 20 4d 65 6d 2e 7a 20 70 6f 69 6e 74  then Mem.z point
1e10: 73 20 61 74 20 61 20 73 74 72 69 6e 67 20 72 65  s at a string re
1e20: 70 72 65 73 65 6e 74 61 74 69 6f 6e 2e 0a 2a 2a  presentation..**
1e30: 20 55 73 75 61 6c 6c 79 20 74 68 69 73 20 69 73   Usually this is
1e40: 20 65 6e 63 6f 64 65 64 20 69 6e 20 74 68 65 20   encoded in the 
1e50: 73 61 6d 65 20 75 6e 69 63 6f 64 65 20 65 6e 63  same unicode enc
1e60: 6f 64 69 6e 67 20 61 73 20 74 68 65 20 6d 61 69  oding as the mai
1e70: 6e 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 28 73  n.** database (s
1e80: 65 65 20 62 65 6c 6f 77 20 66 6f 72 20 65 78 63  ee below for exc
1e90: 65 70 74 69 6f 6e 73 29 2e 20 49 66 20 74 68 65  eptions). If the
1ea0: 20 4d 45 4d 5f 54 65 72 6d 20 66 6c 61 67 20 69   MEM_Term flag i
1eb0: 73 20 61 6c 73 6f 0a 2a 2a 20 73 65 74 2c 20 74  s also.** set, t
1ec0: 68 65 6e 20 74 68 65 20 73 74 72 69 6e 67 20 69  hen the string i
1ed0: 73 20 6e 75 6c 20 74 65 72 6d 69 6e 61 74 65 64  s nul terminated
1ee0: 2e 20 54 68 65 20 4d 45 4d 5f 49 6e 74 20 61 6e  . The MEM_Int an
1ef0: 64 20 4d 45 4d 5f 52 65 61 6c 20 0a 2a 2a 20 66  d MEM_Real .** f
1f00: 6c 61 67 73 20 6d 61 79 20 63 6f 65 78 69 73 74  lags may coexist
1f10: 20 77 69 74 68 20 74 68 65 20 4d 45 4d 5f 53 74   with the MEM_St
1f20: 72 20 66 6c 61 67 2e 0a 2a 2f 0a 23 64 65 66 69  r flag..*/.#defi
1f30: 6e 65 20 4d 45 4d 5f 4e 75 6c 6c 20 20 20 20 20  ne MEM_Null     
1f40: 20 30 78 30 30 30 31 20 20 20 2f 2a 20 56 61 6c   0x0001   /* Val
1f50: 75 65 20 69 73 20 4e 55 4c 4c 20 2a 2f 0a 23 64  ue is NULL */.#d
1f60: 65 66 69 6e 65 20 4d 45 4d 5f 53 74 72 20 20 20  efine MEM_Str   
1f70: 20 20 20 20 30 78 30 30 30 32 20 20 20 2f 2a 20      0x0002   /* 
1f80: 56 61 6c 75 65 20 69 73 20 61 20 73 74 72 69 6e  Value is a strin
1f90: 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d  g */.#define MEM
1fa0: 5f 49 6e 74 20 20 20 20 20 20 20 30 78 30 30 30  _Int       0x000
1fb0: 34 20 20 20 2f 2a 20 56 61 6c 75 65 20 69 73 20  4   /* Value is 
1fc0: 61 6e 20 69 6e 74 65 67 65 72 20 2a 2f 0a 23 64  an integer */.#d
1fd0: 65 66 69 6e 65 20 4d 45 4d 5f 52 65 61 6c 20 20  efine MEM_Real  
1fe0: 20 20 20 20 30 78 30 30 30 38 20 20 20 2f 2a 20      0x0008   /* 
1ff0: 56 61 6c 75 65 20 69 73 20 61 20 72 65 61 6c 20  Value is a real 
2000: 6e 75 6d 62 65 72 20 2a 2f 0a 23 64 65 66 69 6e  number */.#defin
2010: 65 20 4d 45 4d 5f 42 6c 6f 62 20 20 20 20 20 20  e MEM_Blob      
2020: 30 78 30 30 31 30 20 20 20 2f 2a 20 56 61 6c 75  0x0010   /* Valu
2030: 65 20 69 73 20 61 20 42 4c 4f 42 20 2a 2f 0a 23  e is a BLOB */.#
2040: 64 65 66 69 6e 65 20 4d 45 4d 5f 52 6f 77 53 65  define MEM_RowSe
2050: 74 20 20 20 20 30 78 30 30 32 30 20 20 20 2f 2a  t    0x0020   /*
2060: 20 56 61 6c 75 65 20 69 73 20 61 20 52 6f 77 53   Value is a RowS
2070: 65 74 20 6f 62 6a 65 63 74 20 2a 2f 0a 23 64 65  et object */.#de
2080: 66 69 6e 65 20 4d 45 4d 5f 46 72 61 6d 65 20 20  fine MEM_Frame  
2090: 20 20 20 30 78 30 30 34 30 20 20 20 2f 2a 20 56     0x0040   /* V
20a0: 61 6c 75 65 20 69 73 20 61 20 56 64 62 65 46 72  alue is a VdbeFr
20b0: 61 6d 65 20 6f 62 6a 65 63 74 20 2a 2f 0a 23 64  ame object */.#d
20c0: 65 66 69 6e 65 20 4d 45 4d 5f 49 6e 76 61 6c 69  efine MEM_Invali
20d0: 64 20 20 20 30 78 30 30 38 30 20 20 20 2f 2a 20  d   0x0080   /* 
20e0: 56 61 6c 75 65 20 69 73 20 75 6e 64 65 66 69 6e  Value is undefin
20f0: 65 64 20 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45  ed */.#define ME
2100: 4d 5f 54 79 70 65 4d 61 73 6b 20 20 30 78 30 30  M_TypeMask  0x00
2110: 66 66 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 20  ff   /* Mask of 
2120: 74 79 70 65 20 62 69 74 73 20 2a 2f 0a 0a 2f 2a  type bits */../*
2130: 20 57 68 65 6e 65 76 65 72 20 4d 65 6d 20 63 6f   Whenever Mem co
2140: 6e 74 61 69 6e 73 20 61 20 76 61 6c 69 64 20 73  ntains a valid s
2150: 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 72 65  tring or blob re
2160: 70 72 65 73 65 6e 74 61 74 69 6f 6e 2c 20 6f 6e  presentation, on
2170: 65 20 6f 66 0a 2a 2a 20 74 68 65 20 66 6f 6c 6c  e of.** the foll
2180: 6f 77 69 6e 67 20 66 6c 61 67 73 20 6d 75 73 74  owing flags must
2190: 20 62 65 20 73 65 74 20 74 6f 20 64 65 74 65 72   be set to deter
21a0: 6d 69 6e 65 20 74 68 65 20 6d 65 6d 6f 72 79 20  mine the memory 
21b0: 6d 61 6e 61 67 65 6d 65 6e 74 0a 2a 2a 20 70 6f  management.** po
21c0: 6c 69 63 79 20 66 6f 72 20 4d 65 6d 2e 7a 2e 20  licy for Mem.z. 
21d0: 20 54 68 65 20 4d 45 4d 5f 54 65 72 6d 20 66 6c   The MEM_Term fl
21e0: 61 67 20 74 65 6c 6c 73 20 75 73 20 77 68 65 74  ag tells us whet
21f0: 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 0a 2a  her or not the.*
2200: 2a 20 73 74 72 69 6e 67 20 69 73 20 5c 30 30 30  * string is \000
2210: 20 6f 72 20 5c 75 30 30 30 30 20 74 65 72 6d 69   or \u0000 termi
2220: 6e 61 74 65 64 0a 2a 2f 0a 23 64 65 66 69 6e 65  nated.*/.#define
2230: 20 4d 45 4d 5f 54 65 72 6d 20 20 20 20 20 20 30   MEM_Term      0
2240: 78 30 32 30 30 20 20 20 2f 2a 20 53 74 72 69 6e  x0200   /* Strin
2250: 67 20 72 65 70 20 69 73 20 6e 75 6c 20 74 65 72  g rep is nul ter
2260: 6d 69 6e 61 74 65 64 20 2a 2f 0a 23 64 65 66 69  minated */.#defi
2270: 6e 65 20 4d 45 4d 5f 44 79 6e 20 20 20 20 20 20  ne MEM_Dyn      
2280: 20 30 78 30 34 30 30 20 20 20 2f 2a 20 4e 65 65   0x0400   /* Nee
2290: 64 20 74 6f 20 63 61 6c 6c 20 73 71 6c 69 74 65  d to call sqlite
22a0: 46 72 65 65 28 29 20 6f 6e 20 4d 65 6d 2e 7a 20  Free() on Mem.z 
22b0: 2a 2f 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 53  */.#define MEM_S
22c0: 74 61 74 69 63 20 20 20 20 30 78 30 38 30 30 20  tatic    0x0800 
22d0: 20 20 2f 2a 20 4d 65 6d 2e 7a 20 70 6f 69 6e 74    /* Mem.z point
22e0: 73 20 74 6f 20 61 20 73 74 61 74 69 63 20 73 74  s to a static st
22f0: 72 69 6e 67 20 2a 2f 0a 23 64 65 66 69 6e 65 20  ring */.#define 
2300: 4d 45 4d 5f 45 70 68 65 6d 20 20 20 20 20 30 78  MEM_Ephem     0x
2310: 31 30 30 30 20 20 20 2f 2a 20 4d 65 6d 2e 7a 20  1000   /* Mem.z 
2320: 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 65 70 68  points to an eph
2330: 65 6d 65 72 61 6c 20 73 74 72 69 6e 67 20 2a 2f  emeral string */
2340: 0a 23 64 65 66 69 6e 65 20 4d 45 4d 5f 41 67 67  .#define MEM_Agg
2350: 20 20 20 20 20 20 20 30 78 32 30 30 30 20 20 20         0x2000   
2360: 2f 2a 20 4d 65 6d 2e 7a 20 70 6f 69 6e 74 73 20  /* Mem.z points 
2370: 74 6f 20 61 6e 20 61 67 67 20 66 75 6e 63 74 69  to an agg functi
2380: 6f 6e 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 23 64  on context */.#d
2390: 65 66 69 6e 65 20 4d 45 4d 5f 5a 65 72 6f 20 20  efine MEM_Zero  
23a0: 20 20 20 20 30 78 34 30 30 30 20 20 20 2f 2a 20      0x4000   /* 
23b0: 4d 65 6d 2e 69 20 63 6f 6e 74 61 69 6e 73 20 63  Mem.i contains c
23c0: 6f 75 6e 74 20 6f 66 20 30 73 20 61 70 70 65 6e  ount of 0s appen
23d0: 64 65 64 20 74 6f 20 62 6c 6f 62 20 2a 2f 0a 23  ded to blob */.#
23e0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  ifdef SQLITE_OMI
23f0: 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 23 75 6e  T_INCRBLOB.  #un
2400: 64 65 66 20 4d 45 4d 5f 5a 65 72 6f 0a 20 20 23  def MEM_Zero.  #
2410: 64 65 66 69 6e 65 20 4d 45 4d 5f 5a 65 72 6f 20  define MEM_Zero 
2420: 30 78 30 30 30 30 0a 23 65 6e 64 69 66 0a 0a 2f  0x0000.#endif../
2430: 2a 0a 2a 2a 20 43 6c 65 61 72 20 61 6e 79 20 65  *.** Clear any e
2440: 78 69 73 74 69 6e 67 20 74 79 70 65 20 66 6c 61  xisting type fla
2450: 67 73 20 66 72 6f 6d 20 61 20 4d 65 6d 20 61 6e  gs from a Mem an
2460: 64 20 72 65 70 6c 61 63 65 20 74 68 65 6d 20 77  d replace them w
2470: 69 74 68 20 66 0a 2a 2f 0a 23 64 65 66 69 6e 65  ith f.*/.#define
2480: 20 4d 65 6d 53 65 74 54 79 70 65 46 6c 61 67 28   MemSetTypeFlag(
2490: 70 2c 20 66 29 20 5c 0a 20 20 20 28 28 70 29 2d  p, f) \.   ((p)-
24a0: 3e 66 6c 61 67 73 20 3d 20 28 28 70 29 2d 3e 66  >flags = ((p)->f
24b0: 6c 61 67 73 26 7e 28 4d 45 4d 5f 54 79 70 65 4d  lags&~(MEM_TypeM
24c0: 61 73 6b 7c 4d 45 4d 5f 5a 65 72 6f 29 29 7c 66  ask|MEM_Zero))|f
24d0: 29 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  )../*.** Return 
24e0: 74 72 75 65 20 69 66 20 61 20 6d 65 6d 6f 72 79  true if a memory
24f0: 20 63 65 6c 6c 20 69 73 20 6e 6f 74 20 6d 61 72   cell is not mar
2500: 6b 65 64 20 61 73 20 69 6e 76 61 6c 69 64 2e 20  ked as invalid. 
2510: 20 54 68 69 73 20 6d 61 63 72 6f 0a 2a 2a 20 69   This macro.** i
2520: 73 20 66 6f 72 20 75 73 65 20 69 6e 73 69 64 65  s for use inside
2530: 20 61 73 73 65 72 74 28 29 20 73 74 61 74 65 6d   assert() statem
2540: 65 6e 74 73 20 6f 6e 6c 79 2e 0a 2a 2f 0a 23 69  ents only..*/.#i
2550: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55  fdef SQLITE_DEBU
2560: 47 0a 23 64 65 66 69 6e 65 20 6d 65 6d 49 73 56  G.#define memIsV
2570: 61 6c 69 64 28 4d 29 20 20 28 28 4d 29 2d 3e 66  alid(M)  ((M)->f
2580: 6c 61 67 73 20 26 20 4d 45 4d 5f 49 6e 76 61 6c  lags & MEM_Inval
2590: 69 64 29 3d 3d 30 0a 23 65 6e 64 69 66 0a 0a 0a  id)==0.#endif...
25a0: 2f 2a 20 41 20 56 64 62 65 46 75 6e 63 20 69 73  /* A VdbeFunc is
25b0: 20 6a 75 73 74 20 61 20 46 75 6e 63 44 65 66 20   just a FuncDef 
25c0: 28 64 65 66 69 6e 65 64 20 69 6e 20 73 71 6c 69  (defined in sqli
25d0: 74 65 49 6e 74 2e 68 29 20 74 68 61 74 20 63 6f  teInt.h) that co
25e0: 6e 74 61 69 6e 73 0a 2a 2a 20 61 64 64 69 74 69  ntains.** additi
25f0: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
2600: 20 61 62 6f 75 74 20 61 75 78 69 6c 69 61 72 79   about auxiliary
2610: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 62 6f 75   information bou
2620: 6e 64 20 74 6f 20 61 72 67 75 6d 65 6e 74 73 0a  nd to arguments.
2630: 2a 2a 20 6f 66 20 74 68 65 20 66 75 6e 63 74 69  ** of the functi
2640: 6f 6e 2e 20 20 54 68 69 73 20 69 73 20 75 73 65  on.  This is use
2650: 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74  d to implement t
2660: 68 65 20 73 71 6c 69 74 65 33 5f 67 65 74 5f 61  he sqlite3_get_a
2670: 75 78 64 61 74 61 28 29 0a 2a 2a 20 61 6e 64 20  uxdata().** and 
2680: 73 71 6c 69 74 65 33 5f 73 65 74 5f 61 75 78 64  sqlite3_set_auxd
2690: 61 74 61 28 29 20 41 50 49 73 2e 20 20 54 68 65  ata() APIs.  The
26a0: 20 22 61 75 78 64 61 74 61 22 20 69 73 20 73 6f   "auxdata" is so
26b0: 6d 65 20 61 75 78 69 6c 69 61 72 79 20 64 61 74  me auxiliary dat
26c0: 61 0a 2a 2a 20 74 68 61 74 20 63 61 6e 20 62 65  a.** that can be
26d0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
26e0: 20 61 20 63 6f 6e 73 74 61 6e 74 20 61 72 67 75   a constant argu
26f0: 6d 65 6e 74 20 74 6f 20 61 20 66 75 6e 63 74 69  ment to a functi
2700: 6f 6e 2e 20 20 54 68 69 73 0a 2a 2a 20 61 6c 6c  on.  This.** all
2710: 6f 77 73 20 66 75 6e 63 74 69 6f 6e 73 20 73 75  ows functions su
2720: 63 68 20 61 73 20 22 72 65 67 65 78 70 22 20 74  ch as "regexp" t
2730: 6f 20 63 6f 6d 70 69 6c 65 20 74 68 65 69 72 20  o compile their 
2740: 63 6f 6e 73 74 61 6e 74 20 72 65 67 75 6c 61 72  constant regular
2750: 0a 2a 2a 20 65 78 70 72 65 73 73 69 6f 6e 20 61  .** expression a
2760: 72 67 75 6d 65 6e 74 20 6f 6e 63 65 20 61 6e 64  rgument once and
2770: 20 72 65 75 73 65 64 20 74 68 65 20 63 6f 6d 70   reused the comp
2780: 69 6c 65 64 20 63 6f 64 65 20 66 6f 72 20 6d 75  iled code for mu
2790: 6c 74 69 70 6c 65 0a 2a 2a 20 69 6e 76 6f 63 61  ltiple.** invoca
27a0: 74 69 6f 6e 73 2e 0a 2a 2f 0a 73 74 72 75 63 74  tions..*/.struct
27b0: 20 56 64 62 65 46 75 6e 63 20 7b 0a 20 20 46 75   VdbeFunc {.  Fu
27c0: 6e 63 44 65 66 20 2a 70 46 75 6e 63 3b 20 20 20  ncDef *pFunc;   
27d0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
27e0: 68 65 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66  he definition of
27f0: 20 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 2a 2f   the function */
2800: 0a 20 20 69 6e 74 20 6e 41 75 78 3b 20 20 20 20  .  int nAux;    
2810: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2820: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e   /* Number of en
2830: 74 72 69 65 73 20 61 6c 6c 6f 63 61 74 65 64 20  tries allocated 
2840: 66 6f 72 20 61 70 41 75 78 5b 5d 20 2a 2f 0a 20  for apAux[] */. 
2850: 20 73 74 72 75 63 74 20 41 75 78 44 61 74 61 20   struct AuxData 
2860: 7b 0a 20 20 20 20 76 6f 69 64 20 2a 70 41 75 78  {.    void *pAux
2870: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2880: 20 20 20 20 2f 2a 20 41 75 78 20 64 61 74 61 20      /* Aux data 
2890: 66 6f 72 20 74 68 65 20 69 2d 74 68 20 61 72 67  for the i-th arg
28a0: 75 6d 65 6e 74 20 2a 2f 0a 20 20 20 20 76 6f 69  ument */.    voi
28b0: 64 20 28 2a 78 44 65 6c 65 74 65 29 28 76 6f 69  d (*xDelete)(voi
28c0: 64 20 2a 29 3b 20 20 20 20 20 20 2f 2a 20 44 65  d *);      /* De
28d0: 73 74 72 75 63 74 6f 72 20 66 6f 72 20 74 68 65  structor for the
28e0: 20 61 75 78 20 64 61 74 61 20 2a 2f 0a 20 20 7d   aux data */.  }
28f0: 20 61 70 41 75 78 5b 31 5d 3b 20 20 20 20 20 20   apAux[1];      
2900: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2910: 4f 6e 65 20 73 6c 6f 74 20 66 6f 72 20 65 61 63  One slot for eac
2920: 68 20 66 75 6e 63 74 69 6f 6e 20 61 72 67 75 6d  h function argum
2930: 65 6e 74 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a  ent */.};../*.**
2940: 20 54 68 65 20 22 63 6f 6e 74 65 78 74 22 20 61   The "context" a
2950: 72 67 75 6d 65 6e 74 20 66 6f 72 20 61 20 69 6e  rgument for a in
2960: 73 74 61 6c 6c 61 62 6c 65 20 66 75 6e 63 74 69  stallable functi
2970: 6f 6e 2e 20 20 41 20 70 6f 69 6e 74 65 72 20 74  on.  A pointer t
2980: 6f 20 61 6e 0a 2a 2a 20 69 6e 73 74 61 6e 63 65  o an.** instance
2990: 20 6f 66 20 74 68 69 73 20 73 74 72 75 63 74 75   of this structu
29a0: 72 65 20 69 73 20 74 68 65 20 66 69 72 73 74 20  re is the first 
29b0: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20  argument to the 
29c0: 72 6f 75 74 69 6e 65 73 20 75 73 65 64 0a 2a 2a  routines used.**
29d0: 20 69 6d 70 6c 65 6d 65 6e 74 20 74 68 65 20 53   implement the S
29e0: 51 4c 20 66 75 6e 63 74 69 6f 6e 73 2e 0a 2a 2a  QL functions..**
29f0: 0a 2a 2a 20 54 68 65 72 65 20 69 73 20 61 20 74  .** There is a t
2a00: 79 70 65 64 65 66 20 66 6f 72 20 74 68 69 73 20  ypedef for this 
2a10: 73 74 72 75 63 74 75 72 65 20 69 6e 20 73 71 6c  structure in sql
2a20: 69 74 65 2e 68 2e 20 20 53 6f 20 61 6c 6c 20 72  ite.h.  So all r
2a30: 6f 75 74 69 6e 65 73 2c 0a 2a 2a 20 65 76 65 6e  outines,.** even
2a40: 20 74 68 65 20 70 75 62 6c 69 63 20 69 6e 74 65   the public inte
2a50: 72 66 61 63 65 20 74 6f 20 53 51 4c 69 74 65 2c  rface to SQLite,
2a60: 20 63 61 6e 20 75 73 65 20 61 20 70 6f 69 6e 74   can use a point
2a70: 65 72 20 74 6f 20 74 68 69 73 20 73 74 72 75 63  er to this struc
2a80: 74 75 72 65 2e 0a 2a 2a 20 42 75 74 20 74 68 69  ture..** But thi
2a90: 73 20 66 69 6c 65 20 69 73 20 74 68 65 20 6f 6e  s file is the on
2aa0: 6c 79 20 70 6c 61 63 65 20 77 68 65 72 65 20 74  ly place where t
2ab0: 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 65 74 61  he internal deta
2ac0: 69 6c 73 20 6f 66 20 74 68 69 73 0a 2a 2a 20 73  ils of this.** s
2ad0: 74 72 75 63 74 75 72 65 20 61 72 65 20 6b 6e 6f  tructure are kno
2ae0: 77 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 73  wn..**.** This s
2af0: 74 72 75 63 74 75 72 65 20 69 73 20 64 65 66 69  tructure is defi
2b00: 6e 65 64 20 69 6e 73 69 64 65 20 6f 66 20 76 64  ned inside of vd
2b10: 62 65 49 6e 74 2e 68 20 62 65 63 61 75 73 65 20  beInt.h because 
2b20: 69 74 20 75 73 65 73 20 73 75 62 73 74 72 75 63  it uses substruc
2b30: 74 75 72 65 73 0a 2a 2a 20 28 4d 65 6d 29 20 77  tures.** (Mem) w
2b40: 68 69 63 68 20 61 72 65 20 6f 6e 6c 79 20 64 65  hich are only de
2b50: 66 69 6e 65 64 20 74 68 65 72 65 2e 0a 2a 2f 0a  fined there..*/.
2b60: 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 63  struct sqlite3_c
2b70: 6f 6e 74 65 78 74 20 7b 0a 20 20 46 75 6e 63 44  ontext {.  FuncD
2b80: 65 66 20 2a 70 46 75 6e 63 3b 20 20 20 20 20 20  ef *pFunc;      
2b90: 20 2f 2a 20 50 6f 69 6e 74 65 72 20 74 6f 20 66   /* Pointer to f
2ba0: 75 6e 63 74 69 6f 6e 20 69 6e 66 6f 72 6d 61 74  unction informat
2bb0: 69 6f 6e 2e 20 20 4d 55 53 54 20 42 45 20 46 49  ion.  MUST BE FI
2bc0: 52 53 54 20 2a 2f 0a 20 20 56 64 62 65 46 75 6e  RST */.  VdbeFun
2bd0: 63 20 2a 70 56 64 62 65 46 75 6e 63 3b 20 20 2f  c *pVdbeFunc;  /
2be0: 2a 20 41 75 78 69 6c 61 72 79 20 64 61 74 61 2c  * Auxilary data,
2bf0: 20 69 66 20 63 72 65 61 74 65 64 2e 20 2a 2f 0a   if created. */.
2c00: 20 20 4d 65 6d 20 73 3b 20 20 20 20 20 20 20 20    Mem s;        
2c10: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 72          /* The r
2c20: 65 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 73  eturn value is s
2c30: 74 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a 20 20  tored here */.  
2c40: 4d 65 6d 20 2a 70 4d 65 6d 3b 20 20 20 20 20 20  Mem *pMem;      
2c50: 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20        /* Memory 
2c60: 63 65 6c 6c 20 75 73 65 64 20 74 6f 20 73 74 6f  cell used to sto
2c70: 72 65 20 61 67 67 72 65 67 61 74 65 20 63 6f 6e  re aggregate con
2c80: 74 65 78 74 20 2a 2f 0a 20 20 69 6e 74 20 69 73  text */.  int is
2c90: 45 72 72 6f 72 3b 20 20 20 20 20 20 20 20 20 20  Error;          
2ca0: 2f 2a 20 45 72 72 6f 72 20 63 6f 64 65 20 72 65  /* Error code re
2cb0: 74 75 72 6e 65 64 20 62 79 20 74 68 65 20 66 75  turned by the fu
2cc0: 6e 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 43 6f 6c  nction. */.  Col
2cd0: 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b 20 20 20 20  lSeq *pColl;    
2ce0: 20 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20     /* Collating 
2cf0: 73 65 71 75 65 6e 63 65 20 2a 2f 0a 7d 3b 0a 0a  sequence */.};..
2d00: 2f 2a 0a 2a 2a 20 41 6e 20 69 6e 73 74 61 6e 63  /*.** An instanc
2d10: 65 20 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c  e of the virtual
2d20: 20 6d 61 63 68 69 6e 65 2e 20 20 54 68 69 73 20   machine.  This 
2d30: 73 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69  structure contai
2d40: 6e 73 20 74 68 65 20 63 6f 6d 70 6c 65 74 65 0a  ns the complete.
2d50: 2a 2a 20 73 74 61 74 65 20 6f 66 20 74 68 65 20  ** state of the 
2d60: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e  virtual machine.
2d70: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 22 73 71 6c 69  .**.** The "sqli
2d80: 74 65 33 5f 73 74 6d 74 22 20 73 74 72 75 63 74  te3_stmt" struct
2d90: 75 72 65 20 70 6f 69 6e 74 65 72 20 74 68 61 74  ure pointer that
2da0: 20 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 20   is returned by 
2db0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28  sqlite3_prepare(
2dc0: 29 0a 2a 2a 20 69 73 20 72 65 61 6c 6c 79 20 61  ).** is really a
2dd0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 6e 20 69   pointer to an i
2de0: 6e 73 74 61 6e 63 65 20 6f 66 20 74 68 69 73 20  nstance of this 
2df0: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 0a 2a 2a  structure..**.**
2e00: 20 54 68 65 20 56 64 62 65 2e 69 6e 56 74 61 62   The Vdbe.inVtab
2e10: 4d 65 74 68 6f 64 20 76 61 72 69 61 62 6c 65 20  Method variable 
2e20: 69 73 20 73 65 74 20 74 6f 20 6e 6f 6e 2d 7a 65  is set to non-ze
2e30: 72 6f 20 66 6f 72 20 74 68 65 20 64 75 72 61 74  ro for the durat
2e40: 69 6f 6e 20 6f 66 0a 2a 2a 20 61 6e 79 20 76 69  ion of.** any vi
2e50: 72 74 75 61 6c 20 74 61 62 6c 65 20 6d 65 74 68  rtual table meth
2e60: 6f 64 20 69 6e 76 6f 63 61 74 69 6f 6e 73 20 6d  od invocations m
2e70: 61 64 65 20 62 79 20 74 68 65 20 76 64 62 65 20  ade by the vdbe 
2e80: 70 72 6f 67 72 61 6d 2e 20 49 74 20 69 73 0a 2a  program. It is.*
2e90: 2a 20 73 65 74 20 74 6f 20 32 20 66 6f 72 20 78  * set to 2 for x
2ea0: 44 65 73 74 72 6f 79 20 6d 65 74 68 6f 64 20 63  Destroy method c
2eb0: 61 6c 6c 73 20 61 6e 64 20 31 20 66 6f 72 20 61  alls and 1 for a
2ec0: 6c 6c 20 6f 74 68 65 72 20 6d 65 74 68 6f 64 73  ll other methods
2ed0: 2e 20 54 68 69 73 0a 2a 2a 20 76 61 72 69 61 62  . This.** variab
2ee0: 6c 65 20 69 73 20 75 73 65 64 20 66 6f 72 20 74  le is used for t
2ef0: 77 6f 20 70 75 72 70 6f 73 65 73 3a 20 74 6f 20  wo purposes: to 
2f00: 61 6c 6c 6f 77 20 78 44 65 73 74 72 6f 79 20 6d  allow xDestroy m
2f10: 65 74 68 6f 64 73 20 74 6f 20 65 78 65 63 75 74  ethods to execut
2f20: 65 0a 2a 2a 20 22 44 52 4f 50 20 54 41 42 4c 45  e.** "DROP TABLE
2f30: 22 20 73 74 61 74 65 6d 65 6e 74 73 20 61 6e 64  " statements and
2f40: 20 74 6f 20 70 72 65 76 65 6e 74 20 73 6f 6d 65   to prevent some
2f50: 20 6e 61 73 74 79 20 73 69 64 65 20 65 66 66 65   nasty side effe
2f60: 63 74 73 20 6f 66 0a 2a 2a 20 6d 61 6c 6c 6f 63  cts of.** malloc
2f70: 20 66 61 69 6c 75 72 65 20 77 68 65 6e 20 53 51   failure when SQ
2f80: 4c 69 74 65 20 69 73 20 69 6e 76 6f 6b 65 64 20  Lite is invoked 
2f90: 72 65 63 75 72 73 69 76 65 6c 79 20 62 79 20 61  recursively by a
2fa0: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 0a   virtual table .
2fb0: 2a 2a 20 6d 65 74 68 6f 64 20 66 75 6e 63 74 69  ** method functi
2fc0: 6f 6e 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 56 64  on..*/.struct Vd
2fd0: 62 65 20 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a  be {.  sqlite3 *
2fe0: 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  db;            /
2ff0: 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 63  * The database c
3000: 6f 6e 6e 65 63 74 69 6f 6e 20 74 68 61 74 20 6f  onnection that o
3010: 77 6e 73 20 74 68 69 73 20 73 74 61 74 65 6d 65  wns this stateme
3020: 6e 74 20 2a 2f 0a 20 20 4f 70 20 2a 61 4f 70 3b  nt */.  Op *aOp;
3030: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3040: 2f 2a 20 53 70 61 63 65 20 74 6f 20 68 6f 6c 64  /* Space to hold
3050: 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63   the virtual mac
3060: 68 69 6e 65 27 73 20 70 72 6f 67 72 61 6d 20 2a  hine's program *
3070: 2f 0a 20 20 4d 65 6d 20 2a 61 4d 65 6d 3b 20 20  /.  Mem *aMem;  
3080: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
3090: 68 65 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69  he memory locati
30a0: 6f 6e 73 20 2a 2f 0a 20 20 4d 65 6d 20 2a 2a 61  ons */.  Mem **a
30b0: 70 41 72 67 3b 20 20 20 20 20 20 20 20 20 20 20  pArg;           
30c0: 20 2f 2a 20 41 72 67 75 6d 65 6e 74 73 20 74 6f   /* Arguments to
30d0: 20 63 75 72 72 65 6e 74 6c 79 20 65 78 65 63 75   currently execu
30e0: 74 69 6e 67 20 75 73 65 72 20 66 75 6e 63 74 69  ting user functi
30f0: 6f 6e 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 43 6f  on */.  Mem *aCo
3100: 6c 4e 61 6d 65 3b 20 20 20 20 20 20 20 20 20 20  lName;          
3110: 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65 73 20  /* Column names 
3120: 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 4d  to return */.  M
3130: 65 6d 20 2a 70 52 65 73 75 6c 74 53 65 74 3b 20  em *pResultSet; 
3140: 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74 65         /* Pointe
3150: 72 20 74 6f 20 61 6e 20 61 72 72 61 79 20 6f 66  r to an array of
3160: 20 72 65 73 75 6c 74 73 20 2a 2f 0a 20 20 69 6e   results */.  in
3170: 74 20 6e 4d 65 6d 3b 20 20 20 20 20 20 20 20 20  t nMem;         
3180: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
3190: 6f 66 20 6d 65 6d 6f 72 79 20 6c 6f 63 61 74 69  of memory locati
31a0: 6f 6e 73 20 63 75 72 72 65 6e 74 6c 79 20 61 6c  ons currently al
31b0: 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 69 6e 74  located */.  int
31c0: 20 6e 4f 70 3b 20 20 20 20 20 20 20 20 20 20 20   nOp;           
31d0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
31e0: 66 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69  f instructions i
31f0: 6e 20 74 68 65 20 70 72 6f 67 72 61 6d 20 2a 2f  n the program */
3200: 0a 20 20 69 6e 74 20 6e 4f 70 41 6c 6c 6f 63 3b  .  int nOpAlloc;
3210: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75             /* Nu
3220: 6d 62 65 72 20 6f 66 20 73 6c 6f 74 73 20 61 6c  mber of slots al
3230: 6c 6f 63 61 74 65 64 20 66 6f 72 20 61 4f 70 5b  located for aOp[
3240: 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 61 62 65  ] */.  int nLabe
3250: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  l;             /
3260: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 61 62 65  * Number of labe
3270: 6c 73 20 75 73 65 64 20 2a 2f 0a 20 20 69 6e 74  ls used */.  int
3280: 20 6e 4c 61 62 65 6c 41 6c 6c 6f 63 3b 20 20 20   nLabelAlloc;   
3290: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
32a0: 66 20 73 6c 6f 74 73 20 61 6c 6c 6f 63 61 74 65  f slots allocate
32b0: 64 20 69 6e 20 61 4c 61 62 65 6c 5b 5d 20 2a 2f  d in aLabel[] */
32c0: 0a 20 20 69 6e 74 20 2a 61 4c 61 62 65 6c 3b 20  .  int *aLabel; 
32d0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70             /* Sp
32e0: 61 63 65 20 74 6f 20 68 6f 6c 64 20 74 68 65 20  ace to hold the 
32f0: 6c 61 62 65 6c 73 20 2a 2f 0a 20 20 75 31 36 20  labels */.  u16 
3300: 6e 52 65 73 43 6f 6c 75 6d 6e 3b 20 20 20 20 20  nResColumn;     
3310: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
3320: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 6f 6e 65 20   columns in one 
3330: 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75 6c  row of the resul
3340: 74 20 73 65 74 20 2a 2f 0a 20 20 75 31 36 20 6e  t set */.  u16 n
3350: 43 75 72 73 6f 72 3b 20 20 20 20 20 20 20 20 20  Cursor;         
3360: 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20     /* Number of 
3370: 73 6c 6f 74 73 20 69 6e 20 61 70 43 73 72 5b 5d  slots in apCsr[]
3380: 20 2a 2f 0a 20 20 75 33 32 20 6d 61 67 69 63 3b   */.  u32 magic;
3390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
33a0: 20 4d 61 67 69 63 20 6e 75 6d 62 65 72 20 66 6f   Magic number fo
33b0: 72 20 73 61 6e 69 74 79 20 63 68 65 63 6b 69 6e  r sanity checkin
33c0: 67 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 45 72  g */.  char *zEr
33d0: 72 4d 73 67 3b 20 20 20 20 20 20 20 20 20 20 2f  rMsg;          /
33e0: 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20  * Error message 
33f0: 77 72 69 74 74 65 6e 20 68 65 72 65 20 2a 2f 0a  written here */.
3400: 20 20 56 64 62 65 20 2a 70 50 72 65 76 2c 2a 70    Vdbe *pPrev,*p
3410: 4e 65 78 74 3b 20 20 20 20 20 2f 2a 20 4c 69 6e  Next;     /* Lin
3420: 6b 65 64 20 6c 69 73 74 20 6f 66 20 56 44 42 45  ked list of VDBE
3430: 73 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20  s with the same 
3440: 56 64 62 65 2e 64 62 20 2a 2f 0a 20 20 56 64 62  Vdbe.db */.  Vdb
3450: 65 43 75 72 73 6f 72 20 2a 2a 61 70 43 73 72 3b  eCursor **apCsr;
3460: 20 20 20 20 20 2f 2a 20 4f 6e 65 20 65 6c 65 6d       /* One elem
3470: 65 6e 74 20 6f 66 20 74 68 69 73 20 61 72 72 61  ent of this arra
3480: 79 20 66 6f 72 20 65 61 63 68 20 6f 70 65 6e 20  y for each open 
3490: 63 75 72 73 6f 72 20 2a 2f 0a 20 20 4d 65 6d 20  cursor */.  Mem 
34a0: 2a 61 56 61 72 3b 20 20 20 20 20 20 20 20 20 20  *aVar;          
34b0: 20 20 20 20 2f 2a 20 56 61 6c 75 65 73 20 66 6f      /* Values fo
34c0: 72 20 74 68 65 20 4f 50 5f 56 61 72 69 61 62 6c  r the OP_Variabl
34d0: 65 20 6f 70 63 6f 64 65 2e 20 2a 2f 0a 20 20 63  e opcode. */.  c
34e0: 68 61 72 20 2a 2a 61 7a 56 61 72 3b 20 20 20 20  har **azVar;    
34f0: 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f         /* Name o
3500: 66 20 76 61 72 69 61 62 6c 65 73 20 2a 2f 0a 20  f variables */. 
3510: 20 79 6e 56 61 72 20 6e 56 61 72 3b 20 20 20 20   ynVar nVar;    
3520: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
3530: 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e  er of entries in
3540: 20 61 56 61 72 5b 5d 20 2a 2f 0a 20 20 75 33 32   aVar[] */.  u32
3550: 20 63 61 63 68 65 43 74 72 3b 20 20 20 20 20 20   cacheCtr;      
3560: 20 20 20 20 20 2f 2a 20 56 64 62 65 43 75 72 73       /* VdbeCurs
3570: 6f 72 20 72 6f 77 20 63 61 63 68 65 20 67 65 6e  or row cache gen
3580: 65 72 61 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20  eration counter 
3590: 2a 2f 0a 20 20 69 6e 74 20 70 63 3b 20 20 20 20  */.  int pc;    
35a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
35b0: 54 68 65 20 70 72 6f 67 72 61 6d 20 63 6f 75 6e  The program coun
35c0: 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 72 63 3b  ter */.  int rc;
35d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
35e0: 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74   /* Value to ret
35f0: 75 72 6e 20 2a 2f 0a 20 20 75 38 20 65 72 72 6f  urn */.  u8 erro
3600: 72 41 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20  rAction;        
3610: 20 2f 2a 20 52 65 63 6f 76 65 72 79 20 61 63 74   /* Recovery act
3620: 69 6f 6e 20 74 6f 20 64 6f 20 69 6e 20 63 61 73  ion to do in cas
3630: 65 20 6f 66 20 61 6e 20 65 72 72 6f 72 20 2a 2f  e of an error */
3640: 0a 20 20 75 38 20 6f 6b 56 61 72 3b 20 20 20 20  .  u8 okVar;    
3650: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72             /* Tr
3660: 75 65 20 69 66 20 61 7a 56 61 72 5b 5d 20 68 61  ue if azVar[] ha
3670: 73 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69 7a  s been initializ
3680: 65 64 20 2a 2f 0a 20 20 75 38 20 65 78 70 6c 61  ed */.  u8 expla
3690: 69 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  in;             
36a0: 2f 2a 20 54 72 75 65 20 69 66 20 45 58 50 4c 41  /* True if EXPLA
36b0: 49 4e 20 70 72 65 73 65 6e 74 20 6f 6e 20 53 51  IN present on SQ
36c0: 4c 20 63 6f 6d 6d 61 6e 64 20 2a 2f 0a 20 20 75  L command */.  u
36d0: 38 20 63 68 61 6e 67 65 43 6e 74 4f 6e 3b 20 20  8 changeCntOn;  
36e0: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74         /* True t
36f0: 6f 20 75 70 64 61 74 65 20 74 68 65 20 63 68 61  o update the cha
3700: 6e 67 65 2d 63 6f 75 6e 74 65 72 20 2a 2f 0a 20  nge-counter */. 
3710: 20 75 38 20 65 78 70 69 72 65 64 3b 20 20 20 20   u8 expired;    
3720: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
3730: 20 69 66 20 74 68 65 20 56 4d 20 6e 65 65 64 73   if the VM needs
3740: 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69 6c 65   to be recompile
3750: 64 20 2a 2f 0a 20 20 75 38 20 72 75 6e 4f 6e 6c  d */.  u8 runOnl
3760: 79 4f 6e 63 65 3b 20 20 20 20 20 20 20 20 20 2f  yOnce;         /
3770: 2a 20 41 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  * Automatically 
3780: 65 78 70 69 72 65 20 6f 6e 20 72 65 73 65 74 20  expire on reset 
3790: 2a 2f 0a 20 20 75 38 20 6d 69 6e 57 72 69 74 65  */.  u8 minWrite
37a0: 46 69 6c 65 46 6f 72 6d 61 74 3b 20 20 2f 2a 20  FileFormat;  /* 
37b0: 4d 69 6e 69 6d 75 6d 20 66 69 6c 65 20 66 6f 72  Minimum file for
37c0: 6d 61 74 20 66 6f 72 20 77 72 69 74 61 62 6c 65  mat for writable
37d0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20   database files 
37e0: 2a 2f 0a 20 20 75 38 20 69 6e 56 74 61 62 4d 65  */.  u8 inVtabMe
37f0: 74 68 6f 64 3b 20 20 20 20 20 20 20 20 2f 2a 20  thod;        /* 
3800: 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 61 62 6f  See comments abo
3810: 76 65 20 2a 2f 0a 20 20 75 38 20 75 73 65 73 53  ve */.  u8 usesS
3820: 74 6d 74 4a 6f 75 72 6e 61 6c 3b 20 20 20 20 20  tmtJournal;     
3830: 2f 2a 20 54 72 75 65 20 69 66 20 75 73 65 73 20  /* True if uses 
3840: 61 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72  a statement jour
3850: 6e 61 6c 20 2a 2f 0a 20 20 75 38 20 72 65 61 64  nal */.  u8 read
3860: 4f 6e 6c 79 3b 20 20 20 20 20 20 20 20 20 20 20  Only;           
3870: 20 2f 2a 20 54 72 75 65 20 66 6f 72 20 72 65 61   /* True for rea
3880: 64 2d 6f 6e 6c 79 20 73 74 61 74 65 6d 65 6e 74  d-only statement
3890: 73 20 2a 2f 0a 20 20 75 38 20 69 73 50 72 65 70  s */.  u8 isPrep
38a0: 61 72 65 56 32 3b 20 20 20 20 20 20 20 20 20 2f  areV2;         /
38b0: 2a 20 54 72 75 65 20 69 66 20 70 72 65 70 61 72  * True if prepar
38c0: 65 64 20 77 69 74 68 20 70 72 65 70 61 72 65 5f  ed with prepare_
38d0: 76 32 28 29 20 2a 2f 0a 20 20 69 6e 74 20 6e 43  v2() */.  int nC
38e0: 68 61 6e 67 65 3b 20 20 20 20 20 20 20 20 20 20  hange;          
38f0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64    /* Number of d
3900: 62 20 63 68 61 6e 67 65 73 20 6d 61 64 65 20 73  b changes made s
3910: 69 6e 63 65 20 6c 61 73 74 20 72 65 73 65 74 20  ince last reset 
3920: 2a 2f 0a 20 20 69 6e 74 20 62 74 72 65 65 4d 61  */.  int btreeMa
3930: 73 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  sk;          /* 
3940: 42 69 74 6d 61 73 6b 20 6f 66 20 64 62 2d 3e 61  Bitmask of db->a
3950: 44 62 5b 5d 20 65 6e 74 72 69 65 73 20 72 65 66  Db[] entries ref
3960: 65 72 65 6e 63 65 64 20 2a 2f 0a 20 20 69 6e 74  erenced */.  int
3970: 20 69 53 74 61 74 65 6d 65 6e 74 3b 20 20 20 20   iStatement;    
3980: 20 20 20 20 20 2f 2a 20 53 74 61 74 65 6d 65 6e       /* Statemen
3990: 74 20 6e 75 6d 62 65 72 20 28 6f 72 20 30 20 69  t number (or 0 i
39a0: 66 20 68 61 73 20 6e 6f 74 20 6f 70 65 6e 65 64  f has not opened
39b0: 20 73 74 6d 74 29 20 2a 2f 0a 20 20 69 6e 74 20   stmt) */.  int 
39c0: 61 43 6f 75 6e 74 65 72 5b 33 5d 3b 20 20 20 20  aCounter[3];    
39d0: 20 20 20 20 2f 2a 20 43 6f 75 6e 74 65 72 73 20      /* Counters 
39e0: 75 73 65 64 20 62 79 20 73 71 6c 69 74 65 33 5f  used by sqlite3_
39f0: 73 74 6d 74 5f 73 74 61 74 75 73 28 29 20 2a 2f  stmt_status() */
3a00: 0a 20 20 42 74 72 65 65 4d 75 74 65 78 41 72 72  .  BtreeMutexArr
3a10: 61 79 20 61 4d 75 74 65 78 3b 20 2f 2a 20 41 6e  ay aMutex; /* An
3a20: 20 61 72 72 61 79 20 6f 66 20 42 74 72 65 65 20   array of Btree 
3a30: 75 73 65 64 20 68 65 72 65 20 61 6e 64 20 6e 65  used here and ne
3a40: 65 64 69 6e 67 20 6c 6f 63 6b 73 20 2a 2f 0a 23  eding locks */.#
3a50: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
3a60: 49 54 5f 54 52 41 43 45 0a 20 20 69 36 34 20 73  IT_TRACE.  i64 s
3a70: 74 61 72 74 54 69 6d 65 3b 20 20 20 20 20 20 20  tartTime;       
3a80: 20 20 20 2f 2a 20 54 69 6d 65 20 77 68 65 6e 20     /* Time when 
3a90: 71 75 65 72 79 20 73 74 61 72 74 65 64 20 2d 20  query started - 
3aa0: 75 73 65 64 20 66 6f 72 20 70 72 6f 66 69 6c 69  used for profili
3ab0: 6e 67 20 2a 2f 0a 23 65 6e 64 69 66 0a 20 20 69  ng */.#endif.  i
3ac0: 36 34 20 6e 46 6b 43 6f 6e 73 74 72 61 69 6e 74  64 nFkConstraint
3ad0: 3b 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72  ;      /* Number
3ae0: 20 6f 66 20 69 6d 6d 2e 20 46 4b 20 63 6f 6e 73   of imm. FK cons
3af0: 74 72 61 69 6e 74 73 20 74 68 69 73 20 56 4d 20  traints this VM 
3b00: 2a 2f 0a 20 20 69 36 34 20 6e 53 74 6d 74 44 65  */.  i64 nStmtDe
3b10: 66 43 6f 6e 73 3b 20 20 20 20 20 20 20 2f 2a 20  fCons;       /* 
3b20: 4e 75 6d 62 65 72 20 6f 66 20 64 65 66 2e 20 63  Number of def. c
3b30: 6f 6e 73 74 72 61 69 6e 74 73 20 77 68 65 6e 20  onstraints when 
3b40: 73 74 6d 74 20 73 74 61 72 74 65 64 20 2a 2f 0a  stmt started */.
3b50: 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 20 20 20    char *zSql;   
3b60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 78            /* Tex
3b70: 74 20 6f 66 20 74 68 65 20 53 51 4c 20 73 74 61  t of the SQL sta
3b80: 74 65 6d 65 6e 74 20 74 68 61 74 20 67 65 6e 65  tement that gene
3b90: 72 61 74 65 64 20 74 68 69 73 20 2a 2f 0a 20 20  rated this */.  
3ba0: 76 6f 69 64 20 2a 70 46 72 65 65 3b 20 20 20 20  void *pFree;    
3bb0: 20 20 20 20 20 20 20 20 2f 2a 20 46 72 65 65 20          /* Free 
3bc0: 74 68 69 73 20 77 68 65 6e 20 64 65 6c 65 74 69  this when deleti
3bd0: 6e 67 20 74 68 65 20 76 64 62 65 20 2a 2f 0a 23  ng the vdbe */.#
3be0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42  ifdef SQLITE_DEB
3bf0: 55 47 0a 20 20 46 49 4c 45 20 2a 74 72 61 63 65  UG.  FILE *trace
3c00: 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ;            /* 
3c10: 57 72 69 74 65 20 61 6e 20 65 78 65 63 75 74 69  Write an executi
3c20: 6f 6e 20 74 72 61 63 65 20 68 65 72 65 2c 20 69  on trace here, i
3c30: 66 20 6e 6f 74 20 4e 55 4c 4c 20 2a 2f 0a 23 65  f not NULL */.#e
3c40: 6e 64 69 66 0a 20 20 56 64 62 65 46 72 61 6d 65  ndif.  VdbeFrame
3c50: 20 2a 70 46 72 61 6d 65 3b 20 20 20 20 20 20 2f   *pFrame;      /
3c60: 2a 20 50 61 72 65 6e 74 20 66 72 61 6d 65 20 2a  * Parent frame *
3c70: 2f 0a 20 20 56 64 62 65 46 72 61 6d 65 20 2a 70  /.  VdbeFrame *p
3c80: 44 65 6c 46 72 61 6d 65 3b 20 20 20 2f 2a 20 4c  DelFrame;   /* L
3c90: 69 73 74 20 6f 66 20 66 72 61 6d 65 20 6f 62 6a  ist of frame obj
3ca0: 65 63 74 73 20 74 6f 20 66 72 65 65 20 6f 6e 20  ects to free on 
3cb0: 56 4d 20 72 65 73 65 74 20 2a 2f 0a 20 20 69 6e  VM reset */.  in
3cc0: 74 20 6e 46 72 61 6d 65 3b 20 20 20 20 20 20 20  t nFrame;       
3cd0: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
3ce0: 6f 66 20 66 72 61 6d 65 73 20 69 6e 20 70 46 72  of frames in pFr
3cf0: 61 6d 65 20 6c 69 73 74 20 2a 2f 0a 20 20 75 33  ame list */.  u3
3d00: 32 20 65 78 70 6d 61 73 6b 3b 20 20 20 20 20 20  2 expmask;      
3d10: 20 20 20 20 20 20 2f 2a 20 42 69 6e 64 69 6e 67        /* Binding
3d20: 20 74 6f 20 74 68 65 73 65 20 76 61 72 73 20 69   to these vars i
3d30: 6e 76 61 6c 69 64 61 74 65 73 20 56 4d 20 2a 2f  nvalidates VM */
3d40: 0a 20 20 53 75 62 50 72 6f 67 72 61 6d 20 2a 70  .  SubProgram *p
3d50: 50 72 6f 67 72 61 6d 3b 20 20 20 2f 2a 20 4c 69  Program;   /* Li
3d60: 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 61 6c 6c  nked list of all
3d70: 20 73 75 62 2d 70 72 6f 67 72 61 6d 73 20 75 73   sub-programs us
3d80: 65 64 20 62 79 20 56 4d 20 2a 2f 0a 7d 3b 0a 0a  ed by VM */.};..
3d90: 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  /*.** The follow
3da0: 69 6e 67 20 61 72 65 20 61 6c 6c 6f 77 65 64 20  ing are allowed 
3db0: 76 61 6c 75 65 73 20 66 6f 72 20 56 64 62 65 2e  values for Vdbe.
3dc0: 6d 61 67 69 63 0a 2a 2f 0a 23 64 65 66 69 6e 65  magic.*/.#define
3dd0: 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54   VDBE_MAGIC_INIT
3de0: 20 20 20 20 20 30 78 32 36 62 63 65 61 61 35 20       0x26bceaa5 
3df0: 20 20 20 2f 2a 20 42 75 69 6c 64 69 6e 67 20 61     /* Building a
3e00: 20 56 44 42 45 20 70 72 6f 67 72 61 6d 20 2a 2f   VDBE program */
3e10: 0a 23 64 65 66 69 6e 65 20 56 44 42 45 5f 4d 41  .#define VDBE_MA
3e20: 47 49 43 5f 52 55 4e 20 20 20 20 20 20 30 78 62  GIC_RUN      0xb
3e30: 64 66 32 30 64 61 33 20 20 20 20 2f 2a 20 56 44  df20da3    /* VD
3e40: 42 45 20 69 73 20 72 65 61 64 79 20 74 6f 20 65  BE is ready to e
3e50: 78 65 63 75 74 65 20 2a 2f 0a 23 64 65 66 69 6e  xecute */.#defin
3e60: 65 20 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  e VDBE_MAGIC_HAL
3e70: 54 20 20 20 20 20 30 78 35 31 39 63 32 39 37 33  T     0x519c2973
3e80: 20 20 20 20 2f 2a 20 56 44 42 45 20 68 61 73 20      /* VDBE has 
3e90: 63 6f 6d 70 6c 65 74 65 64 20 65 78 65 63 75 74  completed execut
3ea0: 69 6f 6e 20 2a 2f 0a 23 64 65 66 69 6e 65 20 56  ion */.#define V
3eb0: 44 42 45 5f 4d 41 47 49 43 5f 44 45 41 44 20 20  DBE_MAGIC_DEAD  
3ec0: 20 20 20 30 78 62 36 30 36 63 33 63 38 20 20 20     0xb606c3c8   
3ed0: 20 2f 2a 20 54 68 65 20 56 44 42 45 20 68 61 73   /* The VDBE has
3ee0: 20 62 65 65 6e 20 64 65 61 6c 6c 6f 63 61 74 65   been deallocate
3ef0: 64 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 46 75 6e 63  d */../*.** Func
3f00: 74 69 6f 6e 20 70 72 6f 74 6f 74 79 70 65 73 0a  tion prototypes.
3f10: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
3f20: 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 56 64  dbeFreeCursor(Vd
3f30: 62 65 20 2a 2c 20 56 64 62 65 43 75 72 73 6f 72  be *, VdbeCursor
3f40: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 56  *);.void sqliteV
3f50: 64 62 65 50 6f 70 53 74 61 63 6b 28 56 64 62 65  dbePopStack(Vdbe
3f60: 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69  *,int);.int sqli
3f70: 74 65 33 56 64 62 65 43 75 72 73 6f 72 4d 6f 76  te3VdbeCursorMov
3f80: 65 74 6f 28 56 64 62 65 43 75 72 73 6f 72 2a 29  eto(VdbeCursor*)
3f90: 3b 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51  ;.#if defined(SQ
3fa0: 4c 49 54 45 5f 44 45 42 55 47 29 20 7c 7c 20 64  LITE_DEBUG) || d
3fb0: 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f 46  efined(VDBE_PROF
3fc0: 49 4c 45 29 0a 76 6f 69 64 20 73 71 6c 69 74 65  ILE).void sqlite
3fd0: 33 56 64 62 65 50 72 69 6e 74 4f 70 28 46 49 4c  3VdbePrintOp(FIL
3fe0: 45 2a 2c 20 69 6e 74 2c 20 4f 70 2a 29 3b 0a 23  E*, int, Op*);.#
3ff0: 65 6e 64 69 66 0a 75 33 32 20 73 71 6c 69 74 65  endif.u32 sqlite
4000: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
4010: 65 6e 28 75 33 32 29 3b 0a 75 33 32 20 73 71 6c  en(u32);.u32 sql
4020: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
4030: 70 65 28 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a 75  pe(Mem*, int);.u
4040: 33 32 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  32 sqlite3VdbeSe
4050: 72 69 61 6c 50 75 74 28 75 6e 73 69 67 6e 65 64  rialPut(unsigned
4060: 20 63 68 61 72 2a 2c 20 69 6e 74 2c 20 4d 65 6d   char*, int, Mem
4070: 2a 2c 20 69 6e 74 29 3b 0a 75 33 32 20 73 71 6c  *, int);.u32 sql
4080: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65  ite3VdbeSerialGe
4090: 74 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64  t(const unsigned
40a0: 20 63 68 61 72 2a 2c 20 75 33 32 2c 20 4d 65 6d   char*, u32, Mem
40b0: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  *);.void sqlite3
40c0: 56 64 62 65 44 65 6c 65 74 65 41 75 78 44 61 74  VdbeDeleteAuxDat
40d0: 61 28 56 64 62 65 46 75 6e 63 2a 2c 20 69 6e 74  a(VdbeFunc*, int
40e0: 29 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 32 42  );..int sqlite2B
40f0: 74 72 65 65 4b 65 79 43 6f 6d 70 61 72 65 28 42  treeKeyCompare(B
4100: 74 43 75 72 73 6f 72 20 2a 2c 20 63 6f 6e 73 74  tCursor *, const
4110: 20 76 6f 69 64 20 2a 2c 20 69 6e 74 2c 20 69 6e   void *, int, in
4120: 74 2c 20 69 6e 74 20 2a 29 3b 0a 69 6e 74 20 73  t, int *);.int s
4130: 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65 79  qlite3VdbeIdxKey
4140: 43 6f 6d 70 61 72 65 28 56 64 62 65 43 75 72 73  Compare(VdbeCurs
4150: 6f 72 2a 2c 55 6e 70 61 63 6b 65 64 52 65 63 6f  or*,UnpackedReco
4160: 72 64 2a 2c 69 6e 74 2a 29 3b 0a 69 6e 74 20 73  rd*,int*);.int s
4170: 71 6c 69 74 65 33 56 64 62 65 49 64 78 52 6f 77  qlite3VdbeIdxRow
4180: 69 64 28 73 71 6c 69 74 65 33 2a 2c 20 42 74 43  id(sqlite3*, BtC
4190: 75 72 73 6f 72 20 2a 2c 20 69 36 34 20 2a 29 3b  ursor *, i64 *);
41a0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 43  .int sqlite3MemC
41b0: 6f 6d 70 61 72 65 28 63 6f 6e 73 74 20 4d 65 6d  ompare(const Mem
41c0: 2a 2c 20 63 6f 6e 73 74 20 4d 65 6d 2a 2c 20 63  *, const Mem*, c
41d0: 6f 6e 73 74 20 43 6f 6c 6c 53 65 71 2a 29 3b 0a  onst CollSeq*);.
41e0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 45  int sqlite3VdbeE
41f0: 78 65 63 28 56 64 62 65 2a 29 3b 0a 69 6e 74 20  xec(Vdbe*);.int 
4200: 73 71 6c 69 74 65 33 56 64 62 65 4c 69 73 74 28  sqlite3VdbeList(
4210: 56 64 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69  Vdbe*);.int sqli
4220: 74 65 33 56 64 62 65 48 61 6c 74 28 56 64 62 65  te3VdbeHalt(Vdbe
4230: 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  *);.int sqlite3V
4240: 64 62 65 43 68 61 6e 67 65 45 6e 63 6f 64 69 6e  dbeChangeEncodin
4250: 67 28 4d 65 6d 20 2a 2c 20 69 6e 74 29 3b 0a 69  g(Mem *, int);.i
4260: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
4270: 6d 54 6f 6f 42 69 67 28 4d 65 6d 2a 29 3b 0a 69  mTooBig(Mem*);.i
4280: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
4290: 6d 43 6f 70 79 28 4d 65 6d 2a 2c 20 63 6f 6e 73  mCopy(Mem*, cons
42a0: 74 20 4d 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71  t Mem*);.void sq
42b0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 68 61 6c  lite3VdbeMemShal
42c0: 6c 6f 77 43 6f 70 79 28 4d 65 6d 2a 2c 20 63 6f  lowCopy(Mem*, co
42d0: 6e 73 74 20 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a  nst Mem*, int);.
42e0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
42f0: 4d 65 6d 4d 6f 76 65 28 4d 65 6d 2a 2c 20 4d 65  MemMove(Mem*, Me
4300: 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  m*);.int sqlite3
4310: 56 64 62 65 4d 65 6d 4e 75 6c 54 65 72 6d 69 6e  VdbeMemNulTermin
4320: 61 74 65 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73  ate(Mem*);.int s
4330: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
4340: 53 74 72 28 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20  Str(Mem*, const 
4350: 63 68 61 72 2a 2c 20 69 6e 74 2c 20 75 38 2c 20  char*, int, u8, 
4360: 76 6f 69 64 28 2a 29 28 76 6f 69 64 2a 29 29 3b  void(*)(void*));
4370: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
4380: 65 4d 65 6d 53 65 74 49 6e 74 36 34 28 4d 65 6d  eMemSetInt64(Mem
4390: 2a 2c 20 69 36 34 29 3b 0a 23 69 66 64 65 66 20  *, i64);.#ifdef 
43a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41  SQLITE_OMIT_FLOA
43b0: 54 49 4e 47 5f 50 4f 49 4e 54 0a 23 20 64 65 66  TING_POINT.# def
43c0: 69 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ine sqlite3VdbeM
43d0: 65 6d 53 65 74 44 6f 75 62 6c 65 20 73 71 6c 69  emSetDouble sqli
43e0: 74 65 33 56 64 62 65 4d 65 6d 53 65 74 49 6e 74  te3VdbeMemSetInt
43f0: 36 34 0a 23 65 6c 73 65 0a 20 20 76 6f 69 64 20  64.#else.  void 
4400: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
4410: 74 44 6f 75 62 6c 65 28 4d 65 6d 2a 2c 20 64 6f  tDouble(Mem*, do
4420: 75 62 6c 65 29 3b 0a 23 65 6e 64 69 66 0a 76 6f  uble);.#endif.vo
4430: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  id sqlite3VdbeMe
4440: 6d 53 65 74 4e 75 6c 6c 28 4d 65 6d 2a 29 3b 0a  mSetNull(Mem*);.
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 5a 65 72 6f 42 6c 6f 62 28 4d  MemSetZeroBlob(M
4470: 65 6d 2a 2c 69 6e 74 29 3b 0a 76 6f 69 64 20 73  em*,int);.void s
4480: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
4490: 52 6f 77 53 65 74 28 4d 65 6d 2a 29 3b 0a 69 6e  RowSet(Mem*);.in
44a0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d  t sqlite3VdbeMem
44b0: 4d 61 6b 65 57 72 69 74 65 61 62 6c 65 28 4d 65  MakeWriteable(Me
44c0: 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  m*);.int sqlite3
44d0: 56 64 62 65 4d 65 6d 53 74 72 69 6e 67 69 66 79  VdbeMemStringify
44e0: 28 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69 36 34  (Mem*, int);.i64
44f0: 20 73 71 6c 69 74 65 33 56 64 62 65 49 6e 74 56   sqlite3VdbeIntV
4500: 61 6c 75 65 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20  alue(Mem*);.int 
4510: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 49 6e  sqlite3VdbeMemIn
4520: 74 65 67 65 72 69 66 79 28 4d 65 6d 2a 29 3b 0a  tegerify(Mem*);.
4530: 64 6f 75 62 6c 65 20 73 71 6c 69 74 65 33 56 64  double sqlite3Vd
4540: 62 65 52 65 61 6c 56 61 6c 75 65 28 4d 65 6d 2a  beRealValue(Mem*
4550: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  );.void sqlite3V
4560: 64 62 65 49 6e 74 65 67 65 72 41 66 66 69 6e 69  dbeIntegerAffini
4570: 74 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73 71  ty(Mem*);.int sq
4580: 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 61 6c  lite3VdbeMemReal
4590: 69 66 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73  ify(Mem*);.int s
45a0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4e 75 6d  qlite3VdbeMemNum
45b0: 65 72 69 66 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74  erify(Mem*);.int
45c0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46   sqlite3VdbeMemF
45d0: 72 6f 6d 42 74 72 65 65 28 42 74 43 75 72 73 6f  romBtree(BtCurso
45e0: 72 2a 2c 69 6e 74 2c 69 6e 74 2c 69 6e 74 2c 4d  r*,int,int,int,M
45f0: 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74  em*);.void sqlit
4600: 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65  e3VdbeMemRelease
4610: 28 4d 65 6d 20 2a 70 29 3b 0a 76 6f 69 64 20 73  (Mem *p);.void s
4620: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
4630: 65 61 73 65 45 78 74 65 72 6e 61 6c 28 4d 65 6d  easeExternal(Mem
4640: 20 2a 70 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65   *p);.int sqlite
4650: 33 56 64 62 65 4d 65 6d 46 69 6e 61 6c 69 7a 65  3VdbeMemFinalize
4660: 28 4d 65 6d 2a 2c 20 46 75 6e 63 44 65 66 2a 29  (Mem*, FuncDef*)
4670: 3b 0a 63 6f 6e 73 74 20 63 68 61 72 20 2a 73 71  ;.const char *sq
4680: 6c 69 74 65 33 4f 70 63 6f 64 65 4e 61 6d 65 28  lite3OpcodeName(
4690: 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  int);.int sqlite
46a0: 33 56 64 62 65 4d 65 6d 47 72 6f 77 28 4d 65 6d  3VdbeMemGrow(Mem
46b0: 20 2a 70 4d 65 6d 2c 20 69 6e 74 20 6e 2c 20 69   *pMem, int n, i
46c0: 6e 74 20 70 72 65 73 65 72 76 65 29 3b 0a 69 6e  nt preserve);.in
46d0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 43 6c 6f  t sqlite3VdbeClo
46e0: 73 65 53 74 61 74 65 6d 65 6e 74 28 56 64 62 65  seStatement(Vdbe
46f0: 20 2a 2c 20 69 6e 74 29 3b 0a 76 6f 69 64 20 73   *, int);.void s
4700: 71 6c 69 74 65 33 56 64 62 65 46 72 61 6d 65 44  qlite3VdbeFrameD
4710: 65 6c 65 74 65 28 56 64 62 65 46 72 61 6d 65 2a  elete(VdbeFrame*
4720: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
4730: 62 65 46 72 61 6d 65 52 65 73 74 6f 72 65 28 56  beFrameRestore(V
4740: 64 62 65 46 72 61 6d 65 20 2a 29 3b 0a 76 6f 69  dbeFrame *);.voi
4750: 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d  d sqlite3VdbeMem
4760: 53 74 6f 72 65 54 79 70 65 28 4d 65 6d 20 2a 70  StoreType(Mem *p
4770: 4d 65 6d 29 3b 0a 0a 23 69 66 64 65 66 20 53 51  Mem);..#ifdef SQ
4780: 4c 49 54 45 5f 44 45 42 55 47 0a 76 6f 69 64 20  LITE_DEBUG.void 
4790: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 50 72  sqlite3VdbeMemPr
47a0: 65 70 61 72 65 54 6f 43 68 61 6e 67 65 28 56 64  epareToChange(Vd
47b0: 62 65 2a 2c 4d 65 6d 2a 29 3b 0a 23 65 6e 64 69  be*,Mem*);.#endi
47c0: 66 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  f..#ifndef SQLIT
47d0: 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f 4b  E_OMIT_FOREIGN_K
47e0: 45 59 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  EY.int sqlite3Vd
47f0: 62 65 43 68 65 63 6b 46 6b 28 56 64 62 65 20 2a  beCheckFk(Vdbe *
4800: 2c 20 69 6e 74 29 3b 0a 23 65 6c 73 65 0a 23 20  , int);.#else.# 
4810: 64 65 66 69 6e 65 20 73 71 6c 69 74 65 33 56 64  define sqlite3Vd
4820: 62 65 43 68 65 63 6b 46 6b 28 70 2c 69 29 20 30  beCheckFk(p,i) 0
4830: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 6e 64 65 66  .#endif..#ifndef
4840: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 53 48 41   SQLITE_OMIT_SHA
4850: 52 45 44 5f 43 41 43 48 45 0a 76 6f 69 64 20 73  RED_CACHE.void s
4860: 71 6c 69 74 65 33 56 64 62 65 4d 75 74 65 78 41  qlite3VdbeMutexA
4870: 72 72 61 79 45 6e 74 65 72 28 56 64 62 65 20 2a  rrayEnter(Vdbe *
4880: 70 29 3b 0a 23 65 6c 73 65 0a 23 20 64 65 66 69  p);.#else.# defi
4890: 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 4d 75  ne sqlite3VdbeMu
48a0: 74 65 78 41 72 72 61 79 45 6e 74 65 72 28 70 29  texArrayEnter(p)
48b0: 0a 23 65 6e 64 69 66 0a 0a 69 6e 74 20 73 71 6c  .#endif..int sql
48c0: 69 74 65 33 56 64 62 65 4d 65 6d 54 72 61 6e 73  ite3VdbeMemTrans
48d0: 6c 61 74 65 28 4d 65 6d 2a 2c 20 75 38 29 3b 0a  late(Mem*, u8);.
48e0: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45  #ifdef SQLITE_DE
48f0: 42 55 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74  BUG.  void sqlit
4900: 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28 56  e3VdbePrintSql(V
4910: 64 62 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71  dbe*);.  void sq
4920: 6c 69 74 65 33 56 64 62 65 4d 65 6d 50 72 65 74  lite3VdbeMemPret
4930: 74 79 50 72 69 6e 74 28 4d 65 6d 20 2a 70 4d 65  tyPrint(Mem *pMe
4940: 6d 2c 20 63 68 61 72 20 2a 7a 42 75 66 29 3b 0a  m, char *zBuf);.
4950: 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74  #endif.int sqlit
4960: 65 33 56 64 62 65 4d 65 6d 48 61 6e 64 6c 65 42  e3VdbeMemHandleB
4970: 6f 6d 28 4d 65 6d 20 2a 70 4d 65 6d 29 3b 0a 0a  om(Mem *pMem);..
4980: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
4990: 4d 49 54 5f 49 4e 43 52 42 4c 4f 42 0a 20 20 69  MIT_INCRBLOB.  i
49a0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
49b0: 6d 45 78 70 61 6e 64 42 6c 6f 62 28 4d 65 6d 20  mExpandBlob(Mem 
49c0: 2a 29 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65 66  *);.#else.  #def
49d0: 69 6e 65 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ine sqlite3VdbeM
49e0: 65 6d 45 78 70 61 6e 64 42 6c 6f 62 28 78 29 20  emExpandBlob(x) 
49f0: 53 51 4c 49 54 45 5f 4f 4b 0a 23 65 6e 64 69 66  SQLITE_OK.#endif
4a00: 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 21 64 65 66  ..#endif /* !def
4a10: 69 6e 65 64 28 5f 56 44 42 45 49 4e 54 5f 48 5f  ined(_VDBEINT_H_
4a20: 29 20 2a 2f 0a                                   ) */.