/ Hex Artifact Content
Login

Artifact bddb7931fc1216fda6f6720e18d2a9b1e0f8fc96:


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 69 6e 74 20 6e 4f 70 3b 20 20 20 20 20 20 20   int nOp;       
30a0: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
30b0: 66 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69  f instructions i
30c0: 6e 20 74 68 65 20 70 72 6f 67 72 61 6d 20 2a 2f  n the program */
30d0: 0a 20 20 69 6e 74 20 6e 4f 70 41 6c 6c 6f 63 3b  .  int nOpAlloc;
30e0: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
30f0: 20 6f 66 20 73 6c 6f 74 73 20 61 6c 6c 6f 63 61   of slots alloca
3100: 74 65 64 20 66 6f 72 20 61 4f 70 5b 5d 20 2a 2f  ted for aOp[] */
3110: 0a 20 20 4f 70 20 2a 61 4f 70 3b 20 20 20 20 20  .  Op *aOp;     
3120: 20 20 20 20 20 20 20 2f 2a 20 53 70 61 63 65 20         /* Space 
3130: 74 6f 20 68 6f 6c 64 20 74 68 65 20 76 69 72 74  to hold the virt
3140: 75 61 6c 20 6d 61 63 68 69 6e 65 27 73 20 70 72  ual machine's pr
3150: 6f 67 72 61 6d 20 2a 2f 0a 20 20 69 6e 74 20 6e  ogram */.  int n
3160: 4c 61 62 65 6c 3b 20 20 20 20 20 20 20 20 20 2f  Label;         /
3170: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6c 61 62 65  * Number of labe
3180: 6c 73 20 75 73 65 64 20 2a 2f 0a 20 20 69 6e 74  ls used */.  int
3190: 20 6e 4c 61 62 65 6c 41 6c 6c 6f 63 3b 20 20 20   nLabelAlloc;   
31a0: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 73 6c   /* Number of sl
31b0: 6f 74 73 20 61 6c 6c 6f 63 61 74 65 64 20 69 6e  ots allocated in
31c0: 20 61 4c 61 62 65 6c 5b 5d 20 2a 2f 0a 20 20 69   aLabel[] */.  i
31d0: 6e 74 20 2a 61 4c 61 62 65 6c 3b 20 20 20 20 20  nt *aLabel;     
31e0: 20 20 20 2f 2a 20 53 70 61 63 65 20 74 6f 20 68     /* Space to h
31f0: 6f 6c 64 20 74 68 65 20 6c 61 62 65 6c 73 20 2a  old the labels *
3200: 2f 0a 20 20 4d 65 6d 20 2a 61 53 74 61 63 6b 3b  /.  Mem *aStack;
3210: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6f          /* The o
3220: 70 65 72 61 6e 64 20 73 74 61 63 6b 2c 20 65 78  perand stack, ex
3230: 63 65 70 74 20 73 74 72 69 6e 67 20 76 61 6c 75  cept string valu
3240: 65 73 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 54 6f  es */.  Mem *pTo
3250: 73 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  s;          /* T
3260: 6f 70 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20  op entry in the 
3270: 6f 70 65 72 61 6e 64 20 73 74 61 63 6b 20 2a 2f  operand stack */
3280: 0a 20 20 4d 65 6d 20 2a 2a 61 70 41 72 67 3b 20  .  Mem **apArg; 
3290: 20 20 20 20 20 20 20 2f 2a 20 41 72 67 75 6d 65         /* Argume
32a0: 6e 74 73 20 74 6f 20 63 75 72 72 65 6e 74 6c 79  nts to currently
32b0: 20 65 78 65 63 75 74 69 6e 67 20 75 73 65 72 20   executing user 
32c0: 66 75 6e 63 74 69 6f 6e 20 2a 2f 0a 20 20 4d 65  function */.  Me
32d0: 6d 20 2a 61 43 6f 6c 4e 61 6d 65 3b 20 20 20 20  m *aColName;    
32e0: 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e 61 6d 65    /* Column name
32f0: 73 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a 20  s to return */. 
3300: 20 69 6e 74 20 6e 43 75 72 73 6f 72 3b 20 20 20   int nCursor;   
3310: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
3320: 66 20 73 6c 6f 74 73 20 69 6e 20 61 70 43 73 72  f slots in apCsr
3330: 5b 5d 20 2a 2f 0a 20 20 43 75 72 73 6f 72 20 2a  [] */.  Cursor *
3340: 2a 61 70 43 73 72 3b 20 20 20 20 20 2f 2a 20 4f  *apCsr;     /* O
3350: 6e 65 20 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68  ne element of th
3360: 69 73 20 61 72 72 61 79 20 66 6f 72 20 65 61 63  is array for eac
3370: 68 20 6f 70 65 6e 20 63 75 72 73 6f 72 20 2a 2f  h open cursor */
3380: 0a 20 20 69 6e 74 20 6e 56 61 72 3b 20 20 20 20  .  int nVar;    
3390: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
33a0: 20 6f 66 20 65 6e 74 72 69 65 73 20 69 6e 20 61   of entries in a
33b0: 56 61 72 5b 5d 20 2a 2f 0a 20 20 4d 65 6d 20 2a  Var[] */.  Mem *
33c0: 61 56 61 72 3b 20 20 20 20 20 20 20 20 20 20 2f  aVar;          /
33d0: 2a 20 56 61 6c 75 65 73 20 66 6f 72 20 74 68 65  * Values for the
33e0: 20 4f 50 5f 56 61 72 69 61 62 6c 65 20 6f 70 63   OP_Variable opc
33f0: 6f 64 65 2e 20 2a 2f 0a 20 20 63 68 61 72 20 2a  ode. */.  char *
3400: 2a 61 7a 56 61 72 3b 20 20 20 20 20 20 20 2f 2a  *azVar;       /*
3410: 20 4e 61 6d 65 20 6f 66 20 76 61 72 69 61 62 6c   Name of variabl
3420: 65 73 20 2a 2f 0a 20 20 69 6e 74 20 6f 6b 56 61  es */.  int okVa
3430: 72 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  r;          /* T
3440: 72 75 65 20 69 66 20 61 7a 56 61 72 5b 5d 20 68  rue if azVar[] h
3450: 61 73 20 62 65 65 6e 20 69 6e 69 74 69 61 6c 69  as been initiali
3460: 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 6d 61 67  zed */.  int mag
3470: 69 63 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ic;             
3480: 20 2f 2a 20 4d 61 67 69 63 20 6e 75 6d 62 65 72   /* Magic number
3490: 20 66 6f 72 20 73 61 6e 69 74 79 20 63 68 65 63   for sanity chec
34a0: 6b 69 6e 67 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d  king */.  int nM
34b0: 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  em;             
34c0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6d    /* Number of m
34d0: 65 6d 6f 72 79 20 6c 6f 63 61 74 69 6f 6e 73 20  emory locations 
34e0: 63 75 72 72 65 6e 74 6c 79 20 61 6c 6c 6f 63 61  currently alloca
34f0: 74 65 64 20 2a 2f 0a 20 20 4d 65 6d 20 2a 61 4d  ted */.  Mem *aM
3500: 65 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  em;             
3510: 20 2f 2a 20 54 68 65 20 6d 65 6d 6f 72 79 20 6c   /* The memory l
3520: 6f 63 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e  ocations */.  in
3530: 74 20 6e 43 61 6c 6c 62 61 63 6b 3b 20 20 20 20  t nCallback;    
3540: 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20        /* Number 
3550: 6f 66 20 63 61 6c 6c 62 61 63 6b 73 20 69 6e 76  of callbacks inv
3560: 6f 6b 65 64 20 73 6f 20 66 61 72 20 2a 2f 0a 20  oked so far */. 
3570: 20 69 6e 74 20 63 61 63 68 65 43 74 72 3b 20 20   int cacheCtr;  
3580: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73           /* Curs
3590: 6f 72 20 72 6f 77 20 63 61 63 68 65 20 67 65 6e  or row cache gen
35a0: 65 72 61 74 69 6f 6e 20 63 6f 75 6e 74 65 72 20  eration counter 
35b0: 2a 2f 0a 20 20 46 69 66 6f 20 73 46 69 66 6f 3b  */.  Fifo sFifo;
35c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
35d0: 41 20 6c 69 73 74 20 6f 66 20 52 4f 57 49 44 73  A list of ROWIDs
35e0: 20 2a 2f 0a 20 20 69 6e 74 20 63 6f 6e 74 65 78   */.  int contex
35f0: 74 53 74 61 63 6b 54 6f 70 3b 20 20 20 20 2f 2a  tStackTop;    /*
3600: 20 49 6e 64 65 78 20 6f 66 20 74 6f 70 20 65 6c   Index of top el
3610: 65 6d 65 6e 74 20 69 6e 20 74 68 65 20 63 6f 6e  ement in the con
3620: 74 65 78 74 20 73 74 61 63 6b 20 2a 2f 0a 20 20  text stack */.  
3630: 69 6e 74 20 63 6f 6e 74 65 78 74 53 74 61 63 6b  int contextStack
3640: 44 65 70 74 68 3b 20 20 2f 2a 20 54 68 65 20 73  Depth;  /* The s
3650: 69 7a 65 20 6f 66 20 74 68 65 20 22 63 6f 6e 74  ize of the "cont
3660: 65 78 74 22 20 73 74 61 63 6b 20 2a 2f 0a 20 20  ext" stack */.  
3670: 43 6f 6e 74 65 78 74 20 2a 63 6f 6e 74 65 78 74  Context *context
3680: 53 74 61 63 6b 3b 20 20 2f 2a 20 53 74 61 63 6b  Stack;  /* Stack
3690: 20 75 73 65 64 20 62 79 20 6f 70 63 6f 64 65 73   used by opcodes
36a0: 20 43 6f 6e 74 65 78 74 50 75 73 68 20 26 20 43   ContextPush & C
36b0: 6f 6e 74 65 78 74 50 6f 70 2a 2f 0a 20 20 69 6e  ontextPop*/.  in
36c0: 74 20 70 63 3b 20 20 20 20 20 20 20 20 20 20 20  t pc;           
36d0: 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 72 6f        /* The pro
36e0: 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 2a 2f 0a  gram counter */.
36f0: 20 20 69 6e 74 20 72 63 3b 20 20 20 20 20 20 20    int rc;       
3700: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c            /* Val
3710: 75 65 20 74 6f 20 72 65 74 75 72 6e 20 2a 2f 0a  ue to return */.
3720: 20 20 75 6e 73 69 67 6e 65 64 20 75 6e 69 71 75    unsigned uniqu
3730: 65 43 6e 74 3b 20 20 20 20 20 2f 2a 20 55 73 65  eCnt;     /* Use
3740: 64 20 62 79 20 4f 50 5f 4d 61 6b 65 52 65 63 6f  d by OP_MakeReco
3750: 72 64 20 77 68 65 6e 20 50 32 21 3d 30 20 2a 2f  rd when P2!=0 */
3760: 0a 20 20 69 6e 74 20 65 72 72 6f 72 41 63 74 69  .  int errorActi
3770: 6f 6e 3b 20 20 20 20 20 20 20 20 2f 2a 20 52 65  on;        /* Re
3780: 63 6f 76 65 72 79 20 61 63 74 69 6f 6e 20 74 6f  covery action to
3790: 20 64 6f 20 69 6e 20 63 61 73 65 20 6f 66 20 61   do in case of a
37a0: 6e 20 65 72 72 6f 72 20 2a 2f 0a 20 20 69 6e 74  n error */.  int
37b0: 20 69 6e 54 65 6d 70 54 72 61 6e 73 3b 20 20 20   inTempTrans;   
37c0: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20       /* True if 
37d0: 74 65 6d 70 20 64 61 74 61 62 61 73 65 20 69 73  temp database is
37e0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 65 64 20 2a   transactioned *
37f0: 2f 0a 20 20 69 6e 74 20 72 65 74 75 72 6e 53 74  /.  int returnSt
3800: 61 63 6b 5b 31 30 30 5d 3b 20 20 20 2f 2a 20 52  ack[100];   /* R
3810: 65 74 75 72 6e 20 61 64 64 72 65 73 73 20 73 74  eturn address st
3820: 61 63 6b 20 66 6f 72 20 4f 50 5f 47 6f 73 75 62  ack for OP_Gosub
3830: 20 26 20 4f 50 5f 52 65 74 75 72 6e 20 2a 2f 0a   & OP_Return */.
3840: 20 20 69 6e 74 20 72 65 74 75 72 6e 44 65 70 74    int returnDept
3850: 68 3b 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 78  h;        /* Nex
3860: 74 20 75 6e 75 73 65 64 20 65 6c 65 6d 65 6e 74  t unused element
3870: 20 69 6e 20 72 65 74 75 72 6e 53 74 61 63 6b 5b   in returnStack[
3880: 5d 20 2a 2f 0a 20 20 69 6e 74 20 6e 52 65 73 43  ] */.  int nResC
3890: 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f  olumn;         /
38a0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  * Number of colu
38b0: 6d 6e 73 20 69 6e 20 6f 6e 65 20 72 6f 77 20 6f  mns in one row o
38c0: 66 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74  f the result set
38d0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 61 7a 52   */.  char **azR
38e0: 65 73 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 2f 2a  esColumn;     /*
38f0: 20 56 61 6c 75 65 73 20 66 6f 72 20 6f 6e 65 20   Values for one 
3900: 72 6f 77 20 6f 66 20 72 65 73 75 6c 74 20 2a 2f  row of result */
3910: 20 0a 20 20 69 6e 74 20 70 6f 70 53 74 61 63 6b   .  int popStack
3920: 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50  ;           /* P
3930: 6f 70 20 74 68 65 20 73 74 61 63 6b 20 74 68 69  op the stack thi
3940: 73 20 6d 75 63 68 20 6f 6e 20 65 6e 74 72 79 20  s much on entry 
3950: 74 6f 20 56 64 62 65 45 78 65 63 28 29 20 2a 2f  to VdbeExec() */
3960: 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67  .  char *zErrMsg
3970: 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 72  ;          /* Er
3980: 72 6f 72 20 6d 65 73 73 61 67 65 20 77 72 69 74  ror message writ
3990: 74 65 6e 20 68 65 72 65 20 2a 2f 0a 20 20 75 38  ten here */.  u8
39a0: 20 72 65 73 4f 6e 53 74 61 63 6b 3b 20 20 20 20   resOnStack;    
39b0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
39c0: 20 74 68 65 72 65 20 61 72 65 20 72 65 73 75 6c   there are resul
39d0: 74 20 76 61 6c 75 65 73 20 6f 6e 20 74 68 65 20  t values on the 
39e0: 73 74 61 63 6b 20 2a 2f 0a 20 20 75 38 20 65 78  stack */.  u8 ex
39f0: 70 6c 61 69 6e 3b 20 20 20 20 20 20 20 20 20 20  plain;          
3a00: 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 45 58     /* True if EX
3a10: 50 4c 41 49 4e 20 70 72 65 73 65 6e 74 20 6f 6e  PLAIN present on
3a20: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 20 2a 2f 0a   SQL command */.
3a30: 20 20 75 38 20 63 68 61 6e 67 65 43 6e 74 4f 6e    u8 changeCntOn
3a40: 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75  ;         /* Tru
3a50: 65 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20  e to update the 
3a60: 63 68 61 6e 67 65 2d 63 6f 75 6e 74 65 72 20 2a  change-counter *
3a70: 2f 0a 20 20 75 38 20 61 62 6f 72 74 65 64 3b 20  /.  u8 aborted; 
3a80: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
3a90: 72 75 65 20 69 66 20 52 4f 4c 4c 42 41 43 4b 20  rue if ROLLBACK 
3aa0: 69 6e 20 61 6e 6f 74 68 65 72 20 56 4d 20 63 61  in another VM ca
3ab0: 75 73 65 73 20 61 6e 20 61 62 6f 72 74 20 2a 2f  uses an abort */
3ac0: 0a 20 20 75 38 20 65 78 70 69 72 65 64 3b 20 20  .  u8 expired;  
3ad0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72             /* Tr
3ae0: 75 65 20 69 66 20 74 68 65 20 56 4d 20 6e 65 65  ue if the VM nee
3af0: 64 73 20 74 6f 20 62 65 20 72 65 63 6f 6d 70 69  ds to be recompi
3b00: 6c 65 64 20 2a 2f 0a 20 20 75 38 20 6d 69 6e 57  led */.  u8 minW
3b10: 72 69 74 65 46 69 6c 65 46 6f 72 6d 61 74 3b 20  riteFileFormat; 
3b20: 20 2f 2a 20 4d 69 6e 69 6d 75 6d 20 66 69 6c 65   /* Minimum file
3b30: 20 66 6f 72 6d 61 74 20 66 6f 72 20 77 72 69 74   format for writ
3b40: 61 62 6c 65 20 64 61 74 61 62 61 73 65 20 66 69  able database fi
3b50: 6c 65 73 20 2a 2f 0a 20 20 75 38 20 69 6e 56 74  les */.  u8 inVt
3b60: 61 62 4d 65 74 68 6f 64 3b 20 20 20 20 20 20 20  abMethod;       
3b70: 20 2f 2a 20 53 65 65 20 63 6f 6d 6d 65 6e 74 73   /* See comments
3b80: 20 61 62 6f 76 65 20 2a 2f 0a 20 20 69 6e 74 20   above */.  int 
3b90: 6e 43 68 61 6e 67 65 3b 20 20 20 20 20 20 20 20  nChange;        
3ba0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
3bb0: 20 64 62 20 63 68 61 6e 67 65 73 20 6d 61 64 65   db changes made
3bc0: 20 73 69 6e 63 65 20 6c 61 73 74 20 72 65 73 65   since last rese
3bd0: 74 20 2a 2f 0a 20 20 69 36 34 20 73 74 61 72 74  t */.  i64 start
3be0: 54 69 6d 65 3b 20 20 20 20 20 20 20 20 20 20 2f  Time;          /
3bf0: 2a 20 54 69 6d 65 20 77 68 65 6e 20 71 75 65 72  * Time when quer
3c00: 79 20 73 74 61 72 74 65 64 20 2d 20 75 73 65 64  y started - used
3c10: 20 66 6f 72 20 70 72 6f 66 69 6c 69 6e 67 20 2a   for profiling *
3c20: 2f 0a 20 20 69 6e 74 20 6e 53 71 6c 3b 20 20 20  /.  int nSql;   
3c30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
3c40: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20  ber of bytes in 
3c50: 7a 53 71 6c 20 2a 2f 0a 20 20 63 68 61 72 20 2a  zSql */.  char *
3c60: 7a 53 71 6c 3b 20 20 20 20 20 20 20 20 20 20 20  zSql;           
3c70: 2f 2a 20 54 65 78 74 20 6f 66 20 74 68 65 20 53  /* Text of the S
3c80: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61  QL statement tha
3c90: 74 20 67 65 6e 65 72 61 74 65 64 20 74 68 69 73  t generated this
3ca0: 20 2a 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54   */.#ifdef SQLIT
3cb0: 45 5f 44 45 42 55 47 0a 20 20 46 49 4c 45 20 2a  E_DEBUG.  FILE *
3cc0: 74 72 61 63 65 3b 20 20 20 20 20 20 20 20 2f 2a  trace;        /*
3cd0: 20 57 72 69 74 65 20 61 6e 20 65 78 65 63 75 74   Write an execut
3ce0: 69 6f 6e 20 74 72 61 63 65 20 68 65 72 65 2c 20  ion trace here, 
3cf0: 69 66 20 6e 6f 74 20 4e 55 4c 4c 20 2a 2f 0a 23  if not NULL */.#
3d00: 65 6e 64 69 66 0a 23 69 66 64 65 66 20 53 51 4c  endif.#ifdef SQL
3d10: 49 54 45 5f 53 53 45 0a 20 20 69 6e 74 20 66 65  ITE_SSE.  int fe
3d20: 74 63 68 49 64 3b 20 20 20 20 20 20 20 20 20 20  tchId;          
3d30: 2f 2a 20 53 74 61 74 65 6d 65 6e 74 20 6e 75 6d  /* Statement num
3d40: 62 65 72 20 75 73 65 64 20 62 79 20 73 71 6c 69  ber used by sqli
3d50: 74 65 33 5f 66 65 74 63 68 5f 73 74 61 74 65 6d  te3_fetch_statem
3d60: 65 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 6c 72 75  ent */.  int lru
3d70: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ;              /
3d80: 2a 20 43 6f 75 6e 74 65 72 20 75 73 65 64 20 66  * Counter used f
3d90: 6f 72 20 4c 52 55 20 63 61 63 68 65 20 72 65 70  or LRU cache rep
3da0: 6c 61 63 65 6d 65 6e 74 20 2a 2f 0a 23 65 6e 64  lacement */.#end
3db0: 69 66 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  if.};../*.** The
3dc0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 61   following are a
3dd0: 6c 6c 6f 77 65 64 20 76 61 6c 75 65 73 20 66 6f  llowed values fo
3de0: 72 20 56 64 62 65 2e 6d 61 67 69 63 0a 2a 2f 0a  r Vdbe.magic.*/.
3df0: 23 64 65 66 69 6e 65 20 56 44 42 45 5f 4d 41 47  #define VDBE_MAG
3e00: 49 43 5f 49 4e 49 54 20 20 20 20 20 30 78 32 36  IC_INIT     0x26
3e10: 62 63 65 61 61 35 20 20 20 20 2f 2a 20 42 75 69  bceaa5    /* Bui
3e20: 6c 64 69 6e 67 20 61 20 56 44 42 45 20 70 72 6f  lding a VDBE pro
3e30: 67 72 61 6d 20 2a 2f 0a 23 64 65 66 69 6e 65 20  gram */.#define 
3e40: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 20  VDBE_MAGIC_RUN  
3e50: 20 20 20 20 30 78 62 64 66 32 30 64 61 33 20 20      0xbdf20da3  
3e60: 20 20 2f 2a 20 56 44 42 45 20 69 73 20 72 65 61    /* VDBE is rea
3e70: 64 79 20 74 6f 20 65 78 65 63 75 74 65 20 2a 2f  dy to execute */
3e80: 0a 23 64 65 66 69 6e 65 20 56 44 42 45 5f 4d 41  .#define VDBE_MA
3e90: 47 49 43 5f 48 41 4c 54 20 20 20 20 20 30 78 35  GIC_HALT     0x5
3ea0: 31 39 63 32 39 37 33 20 20 20 20 2f 2a 20 56 44  19c2973    /* VD
3eb0: 42 45 20 68 61 73 20 63 6f 6d 70 6c 65 74 65 64  BE has completed
3ec0: 20 65 78 65 63 75 74 69 6f 6e 20 2a 2f 0a 23 64   execution */.#d
3ed0: 65 66 69 6e 65 20 56 44 42 45 5f 4d 41 47 49 43  efine VDBE_MAGIC
3ee0: 5f 44 45 41 44 20 20 20 20 20 30 78 62 36 30 36  _DEAD     0xb606
3ef0: 63 33 63 38 20 20 20 20 2f 2a 20 54 68 65 20 56  c3c8    /* The V
3f00: 44 42 45 20 68 61 73 20 62 65 65 6e 20 64 65 61  DBE has been dea
3f10: 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 0a 2f 2a 0a  llocated */../*.
3f20: 2a 2a 20 46 75 6e 63 74 69 6f 6e 20 70 72 6f 74  ** Function prot
3f30: 6f 74 79 70 65 73 0a 2a 2f 0a 76 6f 69 64 20 73  otypes.*/.void s
3f40: 71 6c 69 74 65 33 56 64 62 65 46 72 65 65 43 75  qlite3VdbeFreeCu
3f50: 72 73 6f 72 28 56 64 62 65 20 2a 2c 20 43 75 72  rsor(Vdbe *, Cur
3f60: 73 6f 72 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69  sor*);.void sqli
3f70: 74 65 56 64 62 65 50 6f 70 53 74 61 63 6b 28 56  teVdbePopStack(V
3f80: 64 62 65 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73  dbe*,int);.int s
3f90: 71 6c 69 74 65 33 56 64 62 65 43 75 72 73 6f 72  qlite3VdbeCursor
3fa0: 4d 6f 76 65 74 6f 28 43 75 72 73 6f 72 2a 29 3b  Moveto(Cursor*);
3fb0: 0a 23 69 66 20 64 65 66 69 6e 65 64 28 53 51 4c  .#if defined(SQL
3fc0: 49 54 45 5f 44 45 42 55 47 29 20 7c 7c 20 64 65  ITE_DEBUG) || de
3fd0: 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f 46 49  fined(VDBE_PROFI
3fe0: 4c 45 29 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  LE).void sqlite3
3ff0: 56 64 62 65 50 72 69 6e 74 4f 70 28 46 49 4c 45  VdbePrintOp(FILE
4000: 2a 2c 20 69 6e 74 2c 20 4f 70 2a 29 3b 0a 23 65  *, int, Op*);.#e
4010: 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33  ndif.int sqlite3
4020: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
4030: 6e 28 75 33 32 29 3b 0a 75 33 32 20 73 71 6c 69  n(u32);.u32 sqli
4040: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
4050: 65 28 4d 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69 6e  e(Mem*, int);.in
4060: 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  t sqlite3VdbeSer
4070: 69 61 6c 50 75 74 28 75 6e 73 69 67 6e 65 64 20  ialPut(unsigned 
4080: 63 68 61 72 2a 2c 20 69 6e 74 2c 20 4d 65 6d 2a  char*, int, Mem*
4090: 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71 6c 69  , int);.int sqli
40a0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65 74  te3VdbeSerialGet
40b0: 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20  (const unsigned 
40c0: 63 68 61 72 2a 2c 20 75 33 32 2c 20 4d 65 6d 2a  char*, u32, Mem*
40d0: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  );.void sqlite3V
40e0: 64 62 65 44 65 6c 65 74 65 41 75 78 44 61 74 61  dbeDeleteAuxData
40f0: 28 56 64 62 65 46 75 6e 63 2a 2c 20 69 6e 74 29  (VdbeFunc*, int)
4100: 3b 0a 0a 69 6e 74 20 73 71 6c 69 74 65 32 42 74  ;..int sqlite2Bt
4110: 72 65 65 4b 65 79 43 6f 6d 70 61 72 65 28 42 74  reeKeyCompare(Bt
4120: 43 75 72 73 6f 72 20 2a 2c 20 63 6f 6e 73 74 20  Cursor *, const 
4130: 76 6f 69 64 20 2a 2c 20 69 6e 74 2c 20 69 6e 74  void *, int, int
4140: 2c 20 69 6e 74 20 2a 29 3b 0a 69 6e 74 20 73 71  , int *);.int sq
4150: 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65 79 43  lite3VdbeIdxKeyC
4160: 6f 6d 70 61 72 65 28 43 75 72 73 6f 72 2a 2c 20  ompare(Cursor*, 
4170: 69 6e 74 20 2c 20 63 6f 6e 73 74 20 75 6e 73 69  int , const unsi
4180: 67 6e 65 64 20 63 68 61 72 2a 2c 20 69 6e 74 2a  gned char*, int*
4190: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
41a0: 62 65 49 64 78 52 6f 77 69 64 28 42 74 43 75 72  beIdxRowid(BtCur
41b0: 73 6f 72 20 2a 2c 20 69 36 34 20 2a 29 3b 0a 69  sor *, i64 *);.i
41c0: 6e 74 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f 6d  nt sqlite3MemCom
41d0: 70 61 72 65 28 63 6f 6e 73 74 20 4d 65 6d 2a 2c  pare(const Mem*,
41e0: 20 63 6f 6e 73 74 20 4d 65 6d 2a 2c 20 63 6f 6e   const Mem*, con
41f0: 73 74 20 43 6f 6c 6c 53 65 71 2a 29 3b 0a 69 6e  st CollSeq*);.in
4200: 74 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63  t sqlite3VdbeRec
4210: 6f 72 64 43 6f 6d 70 61 72 65 28 76 6f 69 64 2a  ordCompare(void*
4220: 2c 69 6e 74 2c 63 6f 6e 73 74 20 76 6f 69 64 2a  ,int,const void*
4230: 2c 69 6e 74 2c 20 63 6f 6e 73 74 20 76 6f 69 64  ,int, const void
4240: 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  *);.int sqlite3V
4250: 64 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 63  dbeIdxRowidLen(c
4260: 6f 6e 73 74 20 75 38 2a 29 3b 0a 69 6e 74 20 73  onst u8*);.int s
4270: 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 56  qlite3VdbeExec(V
4280: 64 62 65 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74  dbe*);.int sqlit
4290: 65 33 56 64 62 65 4c 69 73 74 28 56 64 62 65 2a  e3VdbeList(Vdbe*
42a0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
42b0: 62 65 48 61 6c 74 28 56 64 62 65 2a 29 3b 0a 69  beHalt(Vdbe*);.i
42c0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 43 68  nt sqlite3VdbeCh
42d0: 61 6e 67 65 45 6e 63 6f 64 69 6e 67 28 4d 65 6d  angeEncoding(Mem
42e0: 20 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73 71   *, int);.int sq
42f0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 54 6f 6f 42  lite3VdbeMemTooB
4300: 69 67 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73 71  ig(Mem*);.int sq
4310: 6c 69 74 65 33 56 64 62 65 4d 65 6d 43 6f 70 79  lite3VdbeMemCopy
4320: 28 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20 4d 65 6d  (Mem*, const Mem
4330: 2a 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  *);.void sqlite3
4340: 56 64 62 65 4d 65 6d 53 68 61 6c 6c 6f 77 43 6f  VdbeMemShallowCo
4350: 70 79 28 4d 65 6d 2a 2c 20 63 6f 6e 73 74 20 4d  py(Mem*, const M
4360: 65 6d 2a 2c 20 69 6e 74 29 3b 0a 69 6e 74 20 73  em*, int);.int s
4370: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 4d 6f 76  qlite3VdbeMemMov
4380: 65 28 4d 65 6d 2a 2c 20 4d 65 6d 2a 29 3b 0a 69  e(Mem*, Mem*);.i
4390: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
43a0: 6d 4e 75 6c 54 65 72 6d 69 6e 61 74 65 28 4d 65  mNulTerminate(Me
43b0: 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33  m*);.int sqlite3
43c0: 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 4d 65  VdbeMemSetStr(Me
43d0: 6d 2a 2c 20 63 6f 6e 73 74 20 63 68 61 72 2a 2c  m*, const char*,
43e0: 20 69 6e 74 2c 20 75 38 2c 20 76 6f 69 64 28 2a   int, u8, void(*
43f0: 29 28 76 6f 69 64 2a 29 29 3b 0a 76 6f 69 64 20  )(void*));.void 
4400: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
4410: 74 49 6e 74 36 34 28 4d 65 6d 2a 2c 20 69 36 34  tInt64(Mem*, i64
4420: 29 3b 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  );.void sqlite3V
4430: 64 62 65 4d 65 6d 53 65 74 44 6f 75 62 6c 65 28  dbeMemSetDouble(
4440: 4d 65 6d 2a 2c 20 64 6f 75 62 6c 65 29 3b 0a 76  Mem*, double);.v
4450: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d  oid sqlite3VdbeM
4460: 65 6d 53 65 74 4e 75 6c 6c 28 4d 65 6d 2a 29 3b  emSetNull(Mem*);
4470: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
4480: 65 4d 65 6d 53 65 74 5a 65 72 6f 42 6c 6f 62 28  eMemSetZeroBlob(
4490: 4d 65 6d 2a 2c 69 6e 74 29 3b 0a 69 6e 74 20 73  Mem*,int);.int s
44a0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 45 78 70  qlite3VdbeMemExp
44b0: 61 6e 64 42 6c 6f 62 28 4d 65 6d 2a 29 3b 0a 69  andBlob(Mem*);.i
44c0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
44d0: 6d 4d 61 6b 65 57 72 69 74 65 61 62 6c 65 28 4d  mMakeWriteable(M
44e0: 65 6d 2a 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65  em*);.int sqlite
44f0: 33 56 64 62 65 4d 65 6d 44 79 6e 61 6d 69 63 69  3VdbeMemDynamici
4500: 66 79 28 4d 65 6d 2a 29 3b 0a 69 6e 74 20 73 71  fy(Mem*);.int sq
4510: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 74 72 69  lite3VdbeMemStri
4520: 6e 67 69 66 79 28 4d 65 6d 2a 2c 20 69 6e 74 29  ngify(Mem*, int)
4530: 3b 0a 69 36 34 20 73 71 6c 69 74 65 33 56 64 62  ;.i64 sqlite3Vdb
4540: 65 49 6e 74 56 61 6c 75 65 28 4d 65 6d 2a 29 3b  eIntValue(Mem*);
4550: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
4560: 4d 65 6d 49 6e 74 65 67 65 72 69 66 79 28 4d 65  MemIntegerify(Me
4570: 6d 2a 29 3b 0a 64 6f 75 62 6c 65 20 73 71 6c 69  m*);.double sqli
4580: 74 65 33 56 64 62 65 52 65 61 6c 56 61 6c 75 65  te3VdbeRealValue
4590: 28 4d 65 6d 2a 29 3b 0a 76 6f 69 64 20 73 71 6c  (Mem*);.void sql
45a0: 69 74 65 33 56 64 62 65 49 6e 74 65 67 65 72 41  ite3VdbeIntegerA
45b0: 66 66 69 6e 69 74 79 28 4d 65 6d 2a 29 3b 0a 69  ffinity(Mem*);.i
45c0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
45d0: 6d 52 65 61 6c 69 66 79 28 4d 65 6d 2a 29 3b 0a  mRealify(Mem*);.
45e0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
45f0: 65 6d 4e 75 6d 65 72 69 66 79 28 4d 65 6d 2a 29  emNumerify(Mem*)
4600: 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  ;.int sqlite3Vdb
4610: 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65 28 42 74  eMemFromBtree(Bt
4620: 43 75 72 73 6f 72 2a 2c 69 6e 74 2c 69 6e 74 2c  Cursor*,int,int,
4630: 69 6e 74 2c 4d 65 6d 2a 29 3b 0a 76 6f 69 64 20  int,Mem*);.void 
4640: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65  sqlite3VdbeMemRe
4650: 6c 65 61 73 65 28 4d 65 6d 20 2a 70 29 3b 0a 69  lease(Mem *p);.i
4660: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65  nt sqlite3VdbeMe
4670: 6d 46 69 6e 61 6c 69 7a 65 28 4d 65 6d 2a 2c 20  mFinalize(Mem*, 
4680: 46 75 6e 63 44 65 66 2a 29 3b 0a 23 69 66 6e 64  FuncDef*);.#ifnd
4690: 65 66 20 4e 44 45 42 55 47 0a 20 20 76 6f 69 64  ef NDEBUG.  void
46a0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
46b0: 61 6e 69 74 79 28 4d 65 6d 2a 29 3b 0a 20 20 69  anity(Mem*);.  i
46c0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4f 70  nt sqlite3VdbeOp
46d0: 63 6f 64 65 4e 6f 50 75 73 68 28 75 38 29 3b 0a  codeNoPush(u8);.
46e0: 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74  #endif.int sqlit
46f0: 65 33 56 64 62 65 4d 65 6d 54 72 61 6e 73 6c 61  e3VdbeMemTransla
4700: 74 65 28 4d 65 6d 2a 2c 20 75 38 29 3b 0a 23 69  te(Mem*, u8);.#i
4710: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55  fdef SQLITE_DEBU
4720: 47 0a 20 20 76 6f 69 64 20 73 71 6c 69 74 65 33  G.  void sqlite3
4730: 56 64 62 65 50 72 69 6e 74 53 71 6c 28 56 64 62  VdbePrintSql(Vdb
4740: 65 2a 29 3b 0a 20 20 76 6f 69 64 20 73 71 6c 69  e*);.  void sqli
4750: 74 65 33 56 64 62 65 4d 65 6d 50 72 65 74 74 79  te3VdbeMemPretty
4760: 50 72 69 6e 74 28 4d 65 6d 20 2a 70 4d 65 6d 2c  Print(Mem *pMem,
4770: 20 63 68 61 72 20 2a 7a 42 75 66 29 3b 0a 23 65   char *zBuf);.#e
4780: 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74 65 33  ndif.int sqlite3
4790: 56 64 62 65 4d 65 6d 48 61 6e 64 6c 65 42 6f 6d  VdbeMemHandleBom
47a0: 28 4d 65 6d 20 2a 70 4d 65 6d 29 3b 0a 76 6f 69  (Mem *pMem);.voi
47b0: 64 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 66  d sqlite3VdbeFif
47c0: 6f 49 6e 69 74 28 46 69 66 6f 2a 29 3b 0a 69 6e  oInit(Fifo*);.in
47d0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 66  t sqlite3VdbeFif
47e0: 6f 50 75 73 68 28 46 69 66 6f 2a 2c 20 69 36 34  oPush(Fifo*, i64
47f0: 29 3b 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  );.int sqlite3Vd
4800: 62 65 46 69 66 6f 50 6f 70 28 46 69 66 6f 2a 2c  beFifoPop(Fifo*,
4810: 20 69 36 34 2a 29 3b 0a 76 6f 69 64 20 73 71 6c   i64*);.void sql
4820: 69 74 65 33 56 64 62 65 46 69 66 6f 43 6c 65 61  ite3VdbeFifoClea
4830: 72 28 46 69 66 6f 2a 29 3b 0a 0a 23 65 6e 64 69  r(Fifo*);..#endi
4840: 66 20 2f 2a 20 21 64 65 66 69 6e 65 64 28 5f 56  f /* !defined(_V
4850: 44 42 45 49 4e 54 5f 48 5f 29 20 2a 2f 0a        DBEINT_H_) */.