/ Hex Artifact Content
Login

Artifact 51acaab4275b5fddc7af5e7d1d2594044216ac46:


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 66 69  *****.** This fi
0180: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 63 6f 64 65  le contains code
0190: 20 75 73 65 64 20 66 6f 72 20 63 72 65 61 74 69   used for creati
01a0: 6e 67 2c 20 64 65 73 74 72 6f 79 69 6e 67 2c 20  ng, destroying, 
01b0: 61 6e 64 20 70 6f 70 75 6c 61 74 69 6e 67 0a 2a  and populating.*
01c0: 2a 20 61 20 56 44 42 45 20 28 6f 72 20 61 6e 20  * a VDBE (or an 
01d0: 22 73 71 6c 69 74 65 33 5f 73 74 6d 74 22 20 61  "sqlite3_stmt" a
01e0: 73 20 69 74 20 69 73 20 6b 6e 6f 77 6e 20 74 6f  s it is known to
01f0: 20 74 68 65 20 6f 75 74 73 69 64 65 20 77 6f 72   the outside wor
0200: 6c 64 2e 29 20 20 50 72 69 6f 72 0a 2a 2a 20 74  ld.)  Prior.** t
0210: 6f 20 76 65 72 73 69 6f 6e 20 32 2e 38 2e 37 2c  o version 2.8.7,
0220: 20 61 6c 6c 20 74 68 69 73 20 63 6f 64 65 20 77   all this code w
0230: 61 73 20 63 6f 6d 62 69 6e 65 64 20 69 6e 74 6f  as combined into
0240: 20 74 68 65 20 76 64 62 65 2e 63 20 73 6f 75 72   the vdbe.c sour
0250: 63 65 20 66 69 6c 65 2e 0a 2a 2a 20 42 75 74 20  ce file..** But 
0260: 74 68 61 74 20 66 69 6c 65 20 77 61 73 20 67 65  that file was ge
0270: 74 74 69 6e 67 20 74 6f 6f 20 62 69 67 20 73 6f  tting too big so
0280: 20 74 68 69 73 20 73 75 62 72 6f 75 74 69 6e 65   this subroutine
0290: 73 20 77 65 72 65 20 73 70 6c 69 74 20 6f 75 74  s were split out
02a0: 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 64 65 20 22 73  ..*/.#include "s
02b0: 71 6c 69 74 65 49 6e 74 2e 68 22 0a 23 69 6e 63  qliteInt.h".#inc
02c0: 6c 75 64 65 20 22 6f 73 2e 68 22 0a 23 69 6e 63  lude "os.h".#inc
02d0: 6c 75 64 65 20 3c 63 74 79 70 65 2e 68 3e 0a 23  lude <ctype.h>.#
02e0: 69 6e 63 6c 75 64 65 20 22 76 64 62 65 49 6e 74  include "vdbeInt
02f0: 2e 68 22 0a 0a 0a 2f 2a 0a 2a 2a 20 57 68 65 6e  .h".../*.** When
0300: 20 64 65 62 75 67 67 69 6e 67 20 74 68 65 20 63   debugging the c
0310: 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 20 69 6e  ode generator in
0320: 20 61 20 73 79 6d 62 6f 6c 69 63 20 64 65 62 75   a symbolic debu
0330: 67 67 65 72 2c 20 6f 6e 65 20 63 61 6e 0a 2a 2a  gger, one can.**
0340: 20 73 65 74 20 74 68 65 20 73 71 6c 69 74 65 33   set the sqlite3
0350: 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63  _vdbe_addop_trac
0360: 65 20 74 6f 20 31 20 61 6e 64 20 61 6c 6c 20 6f  e to 1 and all o
0370: 70 63 6f 64 65 73 20 77 69 6c 6c 20 62 65 20 70  pcodes will be p
0380: 72 69 6e 74 65 64 0a 2a 2a 20 61 73 20 74 68 65  rinted.** as the
0390: 79 20 61 72 65 20 61 64 64 65 64 20 74 6f 20 74  y are added to t
03a0: 68 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 73  he instruction s
03b0: 74 72 65 61 6d 2e 0a 2a 2f 0a 23 69 66 64 65 66  tream..*/.#ifdef
03c0: 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 69 6e   SQLITE_DEBUG.in
03d0: 74 20 73 71 6c 69 74 65 33 5f 76 64 62 65 5f 61  t sqlite3_vdbe_a
03e0: 64 64 6f 70 5f 74 72 61 63 65 20 3d 20 30 3b 0a  ddop_trace = 0;.
03f0: 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 43  #endif.../*.** C
0400: 72 65 61 74 65 20 61 20 6e 65 77 20 76 69 72 74  reate a new virt
0410: 75 61 6c 20 64 61 74 61 62 61 73 65 20 65 6e 67  ual database eng
0420: 69 6e 65 2e 0a 2a 2f 0a 56 64 62 65 20 2a 73 71  ine..*/.Vdbe *sq
0430: 6c 69 74 65 33 56 64 62 65 43 72 65 61 74 65 28  lite3VdbeCreate(
0440: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
0450: 56 64 62 65 20 2a 70 3b 0a 20 20 70 20 3d 20 73  Vdbe *p;.  p = s
0460: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a  qliteMalloc( siz
0470: 65 6f 66 28 56 64 62 65 29 20 29 3b 0a 20 20 69  eof(Vdbe) );.  i
0480: 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e  f( p==0 ) return
0490: 20 30 3b 0a 20 20 70 2d 3e 64 62 20 3d 20 64 62   0;.  p->db = db
04a0: 3b 0a 20 20 69 66 28 20 64 62 2d 3e 70 56 64 62  ;.  if( db->pVdb
04b0: 65 20 29 7b 0a 20 20 20 20 64 62 2d 3e 70 56 64  e ){.    db->pVd
04c0: 62 65 2d 3e 70 50 72 65 76 20 3d 20 70 3b 0a 20  be->pPrev = p;. 
04d0: 20 7d 0a 20 20 70 2d 3e 70 4e 65 78 74 20 3d 20   }.  p->pNext = 
04e0: 64 62 2d 3e 70 56 64 62 65 3b 0a 20 20 70 2d 3e  db->pVdbe;.  p->
04f0: 70 50 72 65 76 20 3d 20 30 3b 0a 20 20 64 62 2d  pPrev = 0;.  db-
0500: 3e 70 56 64 62 65 20 3d 20 70 3b 0a 20 20 70 2d  >pVdbe = p;.  p-
0510: 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41  >magic = VDBE_MA
0520: 47 49 43 5f 49 4e 49 54 3b 0a 20 20 72 65 74 75  GIC_INIT;.  retu
0530: 72 6e 20 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  rn p;.}../*.** R
0540: 65 6d 65 6d 62 65 72 20 74 68 65 20 53 51 4c 20  emember the SQL 
0550: 73 74 72 69 6e 67 20 66 6f 72 20 61 20 70 72 65  string for a pre
0560: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 2e  pared statement.
0570: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
0580: 56 64 62 65 53 65 74 53 71 6c 28 56 64 62 65 20  VdbeSetSql(Vdbe 
0590: 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  *p, const char *
05a0: 7a 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 69 66 28  z, int n){.  if(
05b0: 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a   p==0 ) return;.
05c0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 7a 53 71    assert( p->zSq
05d0: 6c 3d 3d 30 20 29 3b 0a 20 20 70 2d 3e 7a 53 71  l==0 );.  p->zSq
05e0: 6c 20 3d 20 73 71 6c 69 74 65 33 53 74 72 4e 44  l = sqlite3StrND
05f0: 75 70 28 7a 2c 20 6e 29 3b 0a 7d 0a 0a 2f 2a 0a  up(z, n);.}../*.
0600: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 53 51  ** Return the SQ
0610: 4c 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  L associated wit
0620: 68 20 61 20 70 72 65 70 61 72 65 64 20 73 74 61  h a prepared sta
0630: 74 65 6d 65 6e 74 0a 2a 2f 0a 63 6f 6e 73 74 20  tement.*/.const 
0640: 63 68 61 72 20 2a 73 71 6c 69 74 65 33 56 64 62  char *sqlite3Vdb
0650: 65 47 65 74 53 71 6c 28 56 64 62 65 20 2a 70 29  eGetSql(Vdbe *p)
0660: 7b 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 7a 53  {.  return p->zS
0670: 71 6c 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 77 61  ql;.}../*.** Swa
0680: 70 20 61 6c 6c 20 63 6f 6e 74 65 6e 74 20 62 65  p all content be
0690: 74 77 65 65 6e 20 74 77 6f 20 56 44 42 45 20 73  tween two VDBE s
06a0: 74 72 75 63 74 75 72 65 73 2e 0a 2a 2f 0a 76 6f  tructures..*/.vo
06b0: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53 77  id sqlite3VdbeSw
06c0: 61 70 28 56 64 62 65 20 2a 70 41 2c 20 56 64 62  ap(Vdbe *pA, Vdb
06d0: 65 20 2a 70 42 29 7b 0a 20 20 56 64 62 65 20 74  e *pB){.  Vdbe t
06e0: 6d 70 2c 20 2a 70 54 6d 70 3b 0a 20 20 63 68 61  mp, *pTmp;.  cha
06f0: 72 20 2a 7a 54 6d 70 3b 0a 20 20 69 6e 74 20 6e  r *zTmp;.  int n
0700: 54 6d 70 3b 0a 20 20 74 6d 70 20 3d 20 2a 70 41  Tmp;.  tmp = *pA
0710: 3b 0a 20 20 2a 70 41 20 3d 20 2a 70 42 3b 0a 20  ;.  *pA = *pB;. 
0720: 20 2a 70 42 20 3d 20 74 6d 70 3b 0a 20 20 70 54   *pB = tmp;.  pT
0730: 6d 70 20 3d 20 70 41 2d 3e 70 4e 65 78 74 3b 0a  mp = pA->pNext;.
0740: 20 20 70 41 2d 3e 70 4e 65 78 74 20 3d 20 70 42    pA->pNext = pB
0750: 2d 3e 70 4e 65 78 74 3b 0a 20 20 70 42 2d 3e 70  ->pNext;.  pB->p
0760: 4e 65 78 74 20 3d 20 70 54 6d 70 3b 0a 20 20 70  Next = pTmp;.  p
0770: 54 6d 70 20 3d 20 70 41 2d 3e 70 50 72 65 76 3b  Tmp = pA->pPrev;
0780: 0a 20 20 70 41 2d 3e 70 50 72 65 76 20 3d 20 70  .  pA->pPrev = p
0790: 42 2d 3e 70 50 72 65 76 3b 0a 20 20 70 42 2d 3e  B->pPrev;.  pB->
07a0: 70 50 72 65 76 20 3d 20 70 54 6d 70 3b 0a 20 20  pPrev = pTmp;.  
07b0: 7a 54 6d 70 20 3d 20 70 41 2d 3e 7a 53 71 6c 3b  zTmp = pA->zSql;
07c0: 0a 20 20 70 41 2d 3e 7a 53 71 6c 20 3d 20 70 42  .  pA->zSql = pB
07d0: 2d 3e 7a 53 71 6c 3b 0a 20 20 70 42 2d 3e 7a 53  ->zSql;.  pB->zS
07e0: 71 6c 20 3d 20 7a 54 6d 70 3b 0a 20 20 6e 54 6d  ql = zTmp;.  nTm
07f0: 70 20 3d 20 70 41 2d 3e 6e 53 71 6c 3b 0a 20 20  p = pA->nSql;.  
0800: 70 41 2d 3e 6e 53 71 6c 20 3d 20 70 42 2d 3e 6e  pA->nSql = pB->n
0810: 53 71 6c 3b 0a 20 20 70 42 2d 3e 6e 53 71 6c 20  Sql;.  pB->nSql 
0820: 3d 20 6e 54 6d 70 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  = nTmp;.}../*.**
0830: 20 54 75 72 6e 20 74 72 61 63 69 6e 67 20 6f 6e   Turn tracing on
0840: 20 6f 72 20 6f 66 66 0a 2a 2f 0a 76 6f 69 64 20   or off.*/.void 
0850: 73 71 6c 69 74 65 33 56 64 62 65 54 72 61 63 65  sqlite3VdbeTrace
0860: 28 56 64 62 65 20 2a 70 2c 20 46 49 4c 45 20 2a  (Vdbe *p, FILE *
0870: 74 72 61 63 65 29 7b 0a 20 20 70 2d 3e 74 72 61  trace){.  p->tra
0880: 63 65 20 3d 20 74 72 61 63 65 3b 0a 7d 0a 0a 2f  ce = trace;.}../
0890: 2a 0a 2a 2a 20 52 65 73 69 7a 65 20 74 68 65 20  *.** Resize the 
08a0: 56 64 62 65 2e 61 4f 70 20 61 72 72 61 79 20 73  Vdbe.aOp array s
08b0: 6f 20 74 68 61 74 20 69 74 20 63 6f 6e 74 61 69  o that it contai
08c0: 6e 73 20 61 74 20 6c 65 61 73 74 20 4e 0a 2a 2a  ns at least N.**
08d0: 20 65 6c 65 6d 65 6e 74 73 2e 20 49 66 20 74 68   elements. If th
08e0: 65 20 56 64 62 65 20 69 73 20 69 6e 20 56 44 42  e Vdbe is in VDB
08f0: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 73 74 61 74  E_MAGIC_RUN stat
0900: 65 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 56  e, then.** the V
0910: 64 62 65 2e 61 4f 70 20 61 72 72 61 79 20 77 69  dbe.aOp array wi
0920: 6c 6c 20 62 65 20 73 69 7a 65 64 20 74 6f 20 63  ll be sized to c
0930: 6f 6e 74 61 69 6e 20 65 78 61 63 74 6c 79 20 4e  ontain exactly N
0940: 0a 2a 2a 20 65 6c 65 6d 65 6e 74 73 2e 20 56 64  .** elements. Vd
0950: 62 65 2e 6e 4f 70 41 6c 6c 6f 63 20 69 73 20 73  be.nOpAlloc is s
0960: 65 74 20 74 6f 20 72 65 66 6c 65 63 74 20 74 68  et to reflect th
0970: 65 20 6e 65 77 20 73 69 7a 65 20 6f 66 0a 2a 2a  e new size of.**
0980: 20 74 68 65 20 61 72 72 61 79 2e 0a 2a 2a 0a 2a   the array..**.*
0990: 2a 20 49 66 20 61 6e 20 6f 75 74 2d 6f 66 2d 6d  * If an out-of-m
09a0: 65 6d 6f 72 79 20 65 72 72 6f 72 20 6f 63 63 75  emory error occu
09b0: 72 73 20 77 68 69 6c 65 20 72 65 73 69 7a 69 6e  rs while resizin
09c0: 67 20 74 68 65 20 61 72 72 61 79 2c 0a 2a 2a 20  g the array,.** 
09d0: 56 64 62 65 2e 61 4f 70 20 61 6e 64 20 56 64 62  Vdbe.aOp and Vdb
09e0: 65 2e 6e 4f 70 41 6c 6c 6f 63 20 72 65 6d 61 69  e.nOpAlloc remai
09f0: 6e 20 75 6e 63 68 61 6e 67 65 64 20 28 74 68 69  n unchanged (thi
0a00: 73 20 69 73 20 73 6f 20 74 68 61 74 0a 2a 2a 20  s is so that.** 
0a10: 61 6e 79 20 6f 70 63 6f 64 65 73 20 61 6c 72 65  any opcodes alre
0a20: 61 64 79 20 61 6c 6c 6f 63 61 74 65 64 20 63 61  ady allocated ca
0a30: 6e 20 62 65 20 63 6f 72 72 65 63 74 6c 79 20 64  n be correctly d
0a40: 65 61 6c 6c 6f 63 61 74 65 64 0a 2a 2a 20 61 6c  eallocated.** al
0a50: 6f 6e 67 20 77 69 74 68 20 74 68 65 20 72 65 73  ong with the res
0a60: 74 20 6f 66 20 74 68 65 20 56 64 62 65 29 2e 0a  t of the Vdbe)..
0a70: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72  */.static void r
0a80: 65 73 69 7a 65 4f 70 41 72 72 61 79 28 56 64 62  esizeOpArray(Vdb
0a90: 65 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20  e *p, int N){.  
0aa0: 69 6e 74 20 72 75 6e 4d 6f 64 65 20 3d 20 70 2d  int runMode = p-
0ab0: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
0ac0: 49 43 5f 52 55 4e 3b 0a 20 20 69 66 28 20 72 75  IC_RUN;.  if( ru
0ad0: 6e 4d 6f 64 65 20 7c 7c 20 70 2d 3e 6e 4f 70 41  nMode || p->nOpA
0ae0: 6c 6c 6f 63 3c 4e 20 29 7b 0a 20 20 20 20 56 64  lloc<N ){.    Vd
0af0: 62 65 4f 70 20 2a 70 4e 65 77 3b 0a 20 20 20 20  beOp *pNew;.    
0b00: 69 6e 74 20 6e 4e 65 77 20 3d 20 4e 20 2b 20 31  int nNew = N + 1
0b10: 30 30 2a 28 21 72 75 6e 4d 6f 64 65 29 3b 0a 20  00*(!runMode);. 
0b20: 20 20 20 69 6e 74 20 6f 6c 64 53 69 7a 65 20 3d     int oldSize =
0b30: 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 3b 0a 20 20   p->nOpAlloc;.  
0b40: 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 52    pNew = sqliteR
0b50: 65 61 6c 6c 6f 63 28 70 2d 3e 61 4f 70 2c 20 6e  ealloc(p->aOp, n
0b60: 4e 65 77 2a 73 69 7a 65 6f 66 28 4f 70 29 29 3b  New*sizeof(Op));
0b70: 0a 20 20 20 20 69 66 28 20 70 4e 65 77 20 29 7b  .    if( pNew ){
0b80: 0a 20 20 20 20 20 20 70 2d 3e 6e 4f 70 41 6c 6c  .      p->nOpAll
0b90: 6f 63 20 3d 20 6e 4e 65 77 3b 0a 20 20 20 20 20  oc = nNew;.     
0ba0: 20 70 2d 3e 61 4f 70 20 3d 20 70 4e 65 77 3b 0a   p->aOp = pNew;.
0bb0: 20 20 20 20 20 20 69 66 28 20 6e 4e 65 77 3e 6f        if( nNew>o
0bc0: 6c 64 53 69 7a 65 20 29 7b 0a 20 20 20 20 20 20  ldSize ){.      
0bd0: 20 20 6d 65 6d 73 65 74 28 26 70 2d 3e 61 4f 70    memset(&p->aOp
0be0: 5b 6f 6c 64 53 69 7a 65 5d 2c 20 30 2c 20 28 6e  [oldSize], 0, (n
0bf0: 4e 65 77 2d 6f 6c 64 53 69 7a 65 29 2a 73 69 7a  New-oldSize)*siz
0c00: 65 6f 66 28 4f 70 29 29 3b 0a 20 20 20 20 20 20  eof(Op));.      
0c10: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f  }.    }.  }.}../
0c20: 2a 0a 2a 2a 20 41 64 64 20 61 20 6e 65 77 20 69  *.** Add a new i
0c30: 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f 20 74 68  nstruction to th
0c40: 65 20 6c 69 73 74 20 6f 66 20 69 6e 73 74 72 75  e list of instru
0c50: 63 74 69 6f 6e 73 20 63 75 72 72 65 6e 74 20 69  ctions current i
0c60: 6e 20 74 68 65 0a 2a 2a 20 56 44 42 45 2e 20 20  n the.** VDBE.  
0c70: 52 65 74 75 72 6e 20 74 68 65 20 61 64 64 72 65  Return the addre
0c80: 73 73 20 6f 66 20 74 68 65 20 6e 65 77 20 69 6e  ss of the new in
0c90: 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a  struction..**.**
0ca0: 20 50 61 72 61 6d 65 74 65 72 73 3a 0a 2a 2a 0a   Parameters:.**.
0cb0: 2a 2a 20 20 20 20 70 20 20 20 20 20 20 20 20 20  **    p         
0cc0: 20 20 20 20 20 20 50 6f 69 6e 74 65 72 20 74 6f        Pointer to
0cd0: 20 74 68 65 20 56 44 42 45 0a 2a 2a 0a 2a 2a 20   the VDBE.**.** 
0ce0: 20 20 20 6f 70 20 20 20 20 20 20 20 20 20 20 20     op           
0cf0: 20 20 20 54 68 65 20 6f 70 63 6f 64 65 20 66 6f     The opcode fo
0d00: 72 20 74 68 69 73 20 69 6e 73 74 72 75 63 74 69  r this instructi
0d10: 6f 6e 0a 2a 2a 0a 2a 2a 20 20 20 20 70 31 2c 20  on.**.**    p1, 
0d20: 70 32 20 20 20 20 20 20 20 20 20 20 46 69 72 73  p2          Firs
0d30: 74 20 74 77 6f 20 6f 66 20 74 68 65 20 74 68 72  t two of the thr
0d40: 65 65 20 70 6f 73 73 69 62 6c 65 20 6f 70 65 72  ee possible oper
0d50: 61 6e 64 73 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20  ands..**.** Use 
0d60: 74 68 65 20 73 71 6c 69 74 65 33 56 64 62 65 52  the sqlite3VdbeR
0d70: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 29 20 66 75  esolveLabel() fu
0d80: 6e 63 74 69 6f 6e 20 74 6f 20 66 69 78 20 61 6e  nction to fix an
0d90: 20 61 64 64 72 65 73 73 20 61 6e 64 0a 2a 2a 20   address and.** 
0da0: 74 68 65 20 73 71 6c 69 74 65 33 56 64 62 65 43  the sqlite3VdbeC
0db0: 68 61 6e 67 65 50 33 28 29 20 66 75 6e 63 74 69  hangeP3() functi
0dc0: 6f 6e 20 74 6f 20 63 68 61 6e 67 65 20 74 68 65  on to change the
0dd0: 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 50 33   value of the P3
0de0: 0a 2a 2a 20 6f 70 65 72 61 6e 64 2e 0a 2a 2f 0a  .** operand..*/.
0df0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 41  int sqlite3VdbeA
0e00: 64 64 4f 70 28 56 64 62 65 20 2a 70 2c 20 69 6e  ddOp(Vdbe *p, in
0e10: 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20 69 6e  t op, int p1, in
0e20: 74 20 70 32 29 7b 0a 20 20 69 6e 74 20 69 3b 0a  t p2){.  int i;.
0e30: 20 20 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 0a    VdbeOp *pOp;..
0e40: 20 20 69 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20    i = p->nOp;.  
0e50: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
0e60: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
0e70: 54 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 4f  T );.  if( p->nO
0e80: 70 41 6c 6c 6f 63 3c 3d 69 20 29 7b 0a 20 20 20  pAlloc<=i ){.   
0e90: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70   resizeOpArray(p
0ea0: 2c 20 69 2b 31 29 3b 0a 20 20 20 20 69 66 28 20  , i+1);.    if( 
0eb0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69  sqlite3MallocFai
0ec0: 6c 65 64 28 29 20 29 7b 0a 20 20 20 20 20 20 72  led() ){.      r
0ed0: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20  eturn 0;.    }. 
0ee0: 20 7d 0a 20 20 70 2d 3e 6e 4f 70 2b 2b 3b 0a 20   }.  p->nOp++;. 
0ef0: 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69   pOp = &p->aOp[i
0f00: 5d 3b 0a 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65  ];.  pOp->opcode
0f10: 20 3d 20 6f 70 3b 0a 20 20 70 4f 70 2d 3e 70 31   = op;.  pOp->p1
0f20: 20 3d 20 70 31 3b 0a 20 20 70 4f 70 2d 3e 70 32   = p1;.  pOp->p2
0f30: 20 3d 20 70 32 3b 0a 20 20 70 4f 70 2d 3e 70 33   = p2;.  pOp->p3
0f40: 20 3d 20 30 3b 0a 20 20 70 4f 70 2d 3e 70 33 74   = 0;.  pOp->p3t
0f50: 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44  ype = P3_NOTUSED
0f60: 3b 0a 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d  ;.  p->expired =
0f70: 20 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54   0;.#ifdef SQLIT
0f80: 45 5f 44 45 42 55 47 0a 20 20 69 66 28 20 73 71  E_DEBUG.  if( sq
0f90: 6c 69 74 65 33 5f 76 64 62 65 5f 61 64 64 6f 70  lite3_vdbe_addop
0fa0: 5f 74 72 61 63 65 20 29 20 73 71 6c 69 74 65 33  _trace ) sqlite3
0fb0: 56 64 62 65 50 72 69 6e 74 4f 70 28 30 2c 20 69  VdbePrintOp(0, i
0fc0: 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 23  , &p->aOp[i]);.#
0fd0: 65 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 69  endif.  return i
0fe0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61  ;.}../*.** Add a
0ff0: 6e 20 6f 70 63 6f 64 65 20 74 68 61 74 20 69 6e  n opcode that in
1000: 63 6c 75 64 65 73 20 74 68 65 20 70 33 20 76 61  cludes the p3 va
1010: 6c 75 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  lue..*/.int sqli
1020: 74 65 33 56 64 62 65 4f 70 33 28 56 64 62 65 20  te3VdbeOp3(Vdbe 
1030: 2a 70 2c 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20  *p, int op, int 
1040: 70 31 2c 20 69 6e 74 20 70 32 2c 20 63 6f 6e 73  p1, int p2, cons
1050: 74 20 63 68 61 72 20 2a 7a 50 33 2c 69 6e 74 20  t char *zP3,int 
1060: 70 33 74 79 70 65 29 7b 0a 20 20 69 6e 74 20 61  p3type){.  int a
1070: 64 64 72 20 3d 20 73 71 6c 69 74 65 33 56 64 62  ddr = sqlite3Vdb
1080: 65 41 64 64 4f 70 28 70 2c 20 6f 70 2c 20 70 31  eAddOp(p, op, p1
1090: 2c 20 70 32 29 3b 0a 20 20 73 71 6c 69 74 65 33  , p2);.  sqlite3
10a0: 56 64 62 65 43 68 61 6e 67 65 50 33 28 70 2c 20  VdbeChangeP3(p, 
10b0: 61 64 64 72 2c 20 7a 50 33 2c 20 70 33 74 79 70  addr, zP3, p3typ
10c0: 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 61 64 64  e);.  return add
10d0: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61  r;.}../*.** Crea
10e0: 74 65 20 61 20 6e 65 77 20 73 79 6d 62 6f 6c 69  te a new symboli
10f0: 63 20 6c 61 62 65 6c 20 66 6f 72 20 61 6e 20 69  c label for an i
1100: 6e 73 74 72 75 63 74 69 6f 6e 20 74 68 61 74 20  nstruction that 
1110: 68 61 73 20 79 65 74 20 74 6f 20 62 65 0a 2a 2a  has yet to be.**
1120: 20 63 6f 64 65 64 2e 20 20 54 68 65 20 73 79 6d   coded.  The sym
1130: 62 6f 6c 69 63 20 6c 61 62 65 6c 20 69 73 20 72  bolic label is r
1140: 65 61 6c 6c 79 20 6a 75 73 74 20 61 20 6e 65 67  eally just a neg
1150: 61 74 69 76 65 20 6e 75 6d 62 65 72 2e 20 20 54  ative number.  T
1160: 68 65 0a 2a 2a 20 6c 61 62 65 6c 20 63 61 6e 20  he.** label can 
1170: 62 65 20 75 73 65 64 20 61 73 20 74 68 65 20 50  be used as the P
1180: 32 20 76 61 6c 75 65 20 6f 66 20 61 6e 20 6f 70  2 value of an op
1190: 65 72 61 74 69 6f 6e 2e 20 20 4c 61 74 65 72 2c  eration.  Later,
11a0: 20 77 68 65 6e 0a 2a 2a 20 74 68 65 20 6c 61 62   when.** the lab
11b0: 65 6c 20 69 73 20 72 65 73 6f 6c 76 65 64 20 74  el is resolved t
11c0: 6f 20 61 20 73 70 65 63 69 66 69 63 20 61 64 64  o a specific add
11d0: 72 65 73 73 2c 20 74 68 65 20 56 44 42 45 20 77  ress, the VDBE w
11e0: 69 6c 6c 20 73 63 61 6e 0a 2a 2a 20 74 68 72 6f  ill scan.** thro
11f0: 75 67 68 20 69 74 73 20 6f 70 65 72 61 74 69 6f  ugh its operatio
1200: 6e 20 6c 69 73 74 20 61 6e 64 20 63 68 61 6e 67  n list and chang
1210: 65 20 61 6c 6c 20 76 61 6c 75 65 73 20 6f 66 20  e all values of 
1220: 50 32 20 77 68 69 63 68 20 6d 61 74 63 68 0a 2a  P2 which match.*
1230: 2a 20 74 68 65 20 6c 61 62 65 6c 20 69 6e 74 6f  * the label into
1240: 20 74 68 65 20 72 65 73 6f 6c 76 65 64 20 61 64   the resolved ad
1250: 64 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  dress..**.** The
1260: 20 56 44 42 45 20 6b 6e 6f 77 73 20 74 68 61 74   VDBE knows that
1270: 20 61 20 50 32 20 76 61 6c 75 65 20 69 73 20 61   a P2 value is a
1280: 20 6c 61 62 65 6c 20 62 65 63 61 75 73 65 20 6c   label because l
1290: 61 62 65 6c 73 20 61 72 65 0a 2a 2a 20 61 6c 77  abels are.** alw
12a0: 61 79 73 20 6e 65 67 61 74 69 76 65 20 61 6e 64  ays negative and
12b0: 20 50 32 20 76 61 6c 75 65 73 20 61 72 65 20 73   P2 values are s
12c0: 75 70 70 6f 73 65 20 74 6f 20 62 65 20 6e 6f 6e  uppose to be non
12d0: 2d 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 48 65  -negative..** He
12e0: 6e 63 65 2c 20 61 20 6e 65 67 61 74 69 76 65 20  nce, a negative 
12f0: 50 32 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61  P2 value is a la
1300: 62 65 6c 20 74 68 61 74 20 68 61 73 20 79 65 74  bel that has yet
1310: 20 74 6f 20 62 65 20 72 65 73 6f 6c 76 65 64 2e   to be resolved.
1320: 0a 2a 2a 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 72  .**.** Zero is r
1330: 65 74 75 72 6e 65 64 20 69 66 20 61 20 6d 61 6c  eturned if a mal
1340: 6c 6f 63 28 29 20 66 61 69 6c 73 2e 0a 2a 2f 0a  loc() fails..*/.
1350: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d  int sqlite3VdbeM
1360: 61 6b 65 4c 61 62 65 6c 28 56 64 62 65 20 2a 70  akeLabel(Vdbe *p
1370: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 20  ){.  int i;.  i 
1380: 3d 20 70 2d 3e 6e 4c 61 62 65 6c 2b 2b 3b 0a 20  = p->nLabel++;. 
1390: 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69   assert( p->magi
13a0: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e  c==VDBE_MAGIC_IN
13b0: 49 54 20 29 3b 0a 20 20 69 66 28 20 69 3e 3d 70  IT );.  if( i>=p
13c0: 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20 29 7b  ->nLabelAlloc ){
13d0: 0a 20 20 20 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c  .    p->nLabelAl
13e0: 6c 6f 63 20 3d 20 70 2d 3e 6e 4c 61 62 65 6c 41  loc = p->nLabelA
13f0: 6c 6c 6f 63 2a 32 20 2b 20 31 30 3b 0a 20 20 20  lloc*2 + 10;.   
1400: 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20 73 71 6c   p->aLabel = sql
1410: 69 74 65 52 65 61 6c 6c 6f 63 4f 72 46 72 65 65  iteReallocOrFree
1420: 28 70 2d 3e 61 4c 61 62 65 6c 2c 0a 20 20 20 20  (p->aLabel,.    
1430: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1440: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1450: 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 2a 73  p->nLabelAlloc*s
1460: 69 7a 65 6f 66 28 70 2d 3e 61 4c 61 62 65 6c 5b  izeof(p->aLabel[
1470: 30 5d 29 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  0]));.  }.  if( 
1480: 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a 20 20 20  p->aLabel ){.   
1490: 20 70 2d 3e 61 4c 61 62 65 6c 5b 69 5d 20 3d 20   p->aLabel[i] = 
14a0: 2d 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  -1;.  }.  return
14b0: 20 2d 31 2d 69 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   -1-i;.}../*.** 
14c0: 52 65 73 6f 6c 76 65 20 6c 61 62 65 6c 20 22 78  Resolve label "x
14d0: 22 20 74 6f 20 62 65 20 74 68 65 20 61 64 64 72  " to be the addr
14e0: 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78 74 20  ess of the next 
14f0: 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f 0a 2a  instruction to.*
1500: 2a 20 62 65 20 69 6e 73 65 72 74 65 64 2e 20 20  * be inserted.  
1510: 54 68 65 20 70 61 72 61 6d 65 74 65 72 20 22 78  The parameter "x
1520: 22 20 6d 75 73 74 20 68 61 76 65 20 62 65 65 6e  " must have been
1530: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a   obtained from.*
1540: 2a 20 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 74  * a prior call t
1550: 6f 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b  o sqlite3VdbeMak
1560: 65 4c 61 62 65 6c 28 29 2e 0a 2a 2f 0a 76 6f 69  eLabel()..*/.voi
1570: 64 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73  d sqlite3VdbeRes
1580: 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62 65 20 2a  olveLabel(Vdbe *
1590: 70 2c 20 69 6e 74 20 78 29 7b 0a 20 20 69 6e 74  p, int x){.  int
15a0: 20 6a 20 3d 20 2d 31 2d 78 3b 0a 20 20 61 73 73   j = -1-x;.  ass
15b0: 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  ert( p->magic==V
15c0: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
15d0: 3b 0a 20 20 61 73 73 65 72 74 28 20 6a 3e 3d 30  ;.  assert( j>=0
15e0: 20 26 26 20 6a 3c 70 2d 3e 6e 4c 61 62 65 6c 20   && j<p->nLabel 
15f0: 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61 4c 61 62  );.  if( p->aLab
1600: 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4c 61  el ){.    p->aLa
1610: 62 65 6c 5b 6a 5d 20 3d 20 70 2d 3e 6e 4f 70 3b  bel[j] = p->nOp;
1620: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  .  }.}../*.** Re
1630: 74 75 72 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 69 66  turn non-zero if
1640: 20 6f 70 63 6f 64 65 20 27 6f 70 27 20 69 73 20   opcode 'op' is 
1650: 67 75 61 72 65 6e 74 65 65 64 20 6e 6f 74 20 74  guarenteed not t
1660: 6f 20 70 75 73 68 20 6d 6f 72 65 20 76 61 6c 75  o push more valu
1670: 65 73 0a 2a 2a 20 6f 6e 74 6f 20 74 68 65 20 56  es.** onto the V
1680: 44 42 45 20 73 74 61 63 6b 20 74 68 61 6e 20 69  DBE stack than i
1690: 74 20 70 6f 70 73 20 6f 66 66 2e 0a 2a 2f 0a 73  t pops off..*/.s
16a0: 74 61 74 69 63 20 69 6e 74 20 6f 70 63 6f 64 65  tatic int opcode
16b0: 4e 6f 50 75 73 68 28 75 38 20 6f 70 29 7b 0a 20  NoPush(u8 op){. 
16c0: 20 2f 2a 20 54 68 65 20 31 30 20 4e 4f 50 55 53   /* The 10 NOPUS
16d0: 48 5f 4d 41 53 4b 5f 6e 20 63 6f 6e 73 74 61 6e  H_MASK_n constan
16e0: 74 73 20 61 72 65 20 64 65 66 69 6e 65 64 20 69  ts are defined i
16f0: 6e 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 61  n the automatica
1700: 6c 6c 79 0a 20 20 2a 2a 20 67 65 6e 65 72 61 74  lly.  ** generat
1710: 65 64 20 68 65 61 64 65 72 20 66 69 6c 65 20 6f  ed header file o
1720: 70 63 6f 64 65 73 2e 68 2e 20 45 61 63 68 20 69  pcodes.h. Each i
1730: 73 20 61 20 31 36 2d 62 69 74 20 62 69 74 6d 61  s a 16-bit bitma
1740: 73 6b 2c 20 6f 6e 65 0a 20 20 2a 2a 20 62 69 74  sk, one.  ** bit
1750: 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 74   corresponding t
1760: 6f 20 65 61 63 68 20 6f 70 63 6f 64 65 20 69 6d  o each opcode im
1770: 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 74 68 65  plemented by the
1780: 20 76 69 72 74 75 61 6c 0a 20 20 2a 2a 20 6d 61   virtual.  ** ma
1790: 63 68 69 6e 65 20 69 6e 20 76 64 62 65 2e 63 2e  chine in vdbe.c.
17a0: 20 54 68 65 20 62 69 74 20 69 73 20 74 72 75 65   The bit is true
17b0: 20 69 66 20 74 68 65 20 77 6f 72 64 20 22 6e 6f   if the word "no
17c0: 2d 70 75 73 68 22 20 61 70 70 65 61 72 73 0a 20  -push" appears. 
17d0: 20 2a 2a 20 69 6e 20 61 20 63 6f 6d 6d 65 6e 74   ** in a comment
17e0: 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 6c 69 6e   on the same lin
17f0: 65 20 61 73 20 74 68 65 20 22 63 61 73 65 20 4f  e as the "case O
1800: 50 5f 58 58 58 3a 22 20 69 6e 20 0a 20 20 2a 2a  P_XXX:" in .  **
1810: 20 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63   sqlite3VdbeExec
1820: 28 29 20 69 6e 20 76 64 62 65 2e 63 2e 0a 20 20  () in vdbe.c..  
1830: 2a 2a 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 62  **.  ** If the b
1840: 69 74 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e  it is true, then
1850: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69   the correspondi
1860: 6e 67 20 6f 70 63 6f 64 65 20 69 73 20 67 75 61  ng opcode is gua
1870: 72 65 6e 74 65 65 64 20 6e 6f 74 0a 20 20 2a 2a  renteed not.  **
1880: 20 74 6f 20 67 72 6f 77 20 74 68 65 20 73 74 61   to grow the sta
1890: 63 6b 20 77 68 65 6e 20 69 74 20 69 73 20 65 78  ck when it is ex
18a0: 65 63 75 74 65 64 2e 20 4f 74 68 65 72 77 69 73  ecuted. Otherwis
18b0: 65 2c 20 69 74 20 6d 61 79 20 67 72 6f 77 20 74  e, it may grow t
18c0: 68 65 0a 20 20 2a 2a 20 73 74 61 63 6b 20 62 79  he.  ** stack by
18d0: 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 65 6e 74   at most one ent
18e0: 72 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 4f  ry..  **.  ** NO
18f0: 50 55 53 48 5f 4d 41 53 4b 5f 30 20 63 6f 72 72  PUSH_MASK_0 corr
1900: 65 73 70 6f 6e 64 73 20 74 6f 20 6f 70 63 6f 64  esponds to opcod
1910: 65 73 20 30 20 74 6f 20 31 35 2e 20 4e 4f 50 55  es 0 to 15. NOPU
1920: 53 48 5f 4d 41 53 4b 5f 31 20 63 6f 6e 74 61 69  SH_MASK_1 contai
1930: 6e 73 0a 20 20 2a 2a 20 6f 6e 65 20 62 69 74 20  ns.  ** one bit 
1940: 66 6f 72 20 6f 70 63 6f 64 65 73 20 31 36 20 74  for opcodes 16 t
1950: 6f 20 33 31 2c 20 61 6e 64 20 73 6f 20 6f 6e 2e  o 31, and so on.
1960: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 31 36 2d 62 69  .  **.  ** 16-bi
1970: 74 20 62 69 74 6d 61 73 6b 73 20 28 72 61 74 68  t bitmasks (rath
1980: 65 72 20 74 68 61 6e 20 33 32 2d 62 69 74 29 20  er than 32-bit) 
1990: 61 72 65 20 73 70 65 63 69 66 69 65 64 20 69 6e  are specified in
19a0: 20 6f 70 63 6f 64 65 73 2e 68 20 0a 20 20 2a 2a   opcodes.h .  **
19b0: 20 62 65 63 61 75 73 65 20 74 68 65 20 66 69 6c   because the fil
19c0: 65 20 69 73 20 67 65 6e 65 72 61 74 65 64 20 62  e is generated b
19d0: 79 20 61 6e 20 61 77 6b 20 70 72 6f 67 72 61 6d  y an awk program
19e0: 2e 20 41 77 6b 20 6d 61 6e 69 70 75 6c 61 74 65  . Awk manipulate
19f0: 73 0a 20 20 2a 2a 20 61 6c 6c 20 6e 75 6d 62 65  s.  ** all numbe
1a00: 72 73 20 61 73 20 66 6c 6f 61 74 69 6e 67 2d 70  rs as floating-p
1a10: 6f 69 6e 74 20 61 6e 64 20 77 65 20 64 6f 6e 27  oint and we don'
1a20: 74 20 77 61 6e 74 20 74 6f 20 72 69 73 6b 20 61  t want to risk a
1a30: 20 72 6f 75 6e 64 69 6e 67 0a 20 20 2a 2a 20 65   rounding.  ** e
1a40: 72 72 6f 72 20 69 66 20 73 6f 6d 65 6f 6e 65 20  rror if someone 
1a50: 62 75 69 6c 64 73 20 77 69 74 68 20 61 6e 20 61  builds with an a
1a60: 77 6b 20 74 68 61 74 20 75 73 65 73 20 28 66 6f  wk that uses (fo
1a70: 72 20 65 78 61 6d 70 6c 65 29 20 33 32 2d 62 69  r example) 32-bi
1a80: 74 20 0a 20 20 2a 2a 20 49 45 45 45 20 66 6c 6f  t .  ** IEEE flo
1a90: 61 74 73 2e 0a 20 20 2a 2f 20 0a 20 20 73 74 61  ats..  */ .  sta
1aa0: 74 69 63 20 63 6f 6e 73 74 20 75 33 32 20 6d 61  tic const u32 ma
1ab0: 73 6b 73 5b 35 5d 20 3d 20 7b 0a 20 20 20 20 4e  sks[5] = {.    N
1ac0: 4f 50 55 53 48 5f 4d 41 53 4b 5f 30 20 2b 20 28  OPUSH_MASK_0 + (
1ad0: 28 28 75 6e 73 69 67 6e 65 64 29 4e 4f 50 55 53  ((unsigned)NOPUS
1ae0: 48 5f 4d 41 53 4b 5f 31 29 3c 3c 31 36 29 2c 0a  H_MASK_1)<<16),.
1af0: 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f      NOPUSH_MASK_
1b00: 32 20 2b 20 28 28 28 75 6e 73 69 67 6e 65 64 29  2 + (((unsigned)
1b10: 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 33 29 3c 3c  NOPUSH_MASK_3)<<
1b20: 31 36 29 2c 0a 20 20 20 20 4e 4f 50 55 53 48 5f  16),.    NOPUSH_
1b30: 4d 41 53 4b 5f 34 20 2b 20 28 28 28 75 6e 73 69  MASK_4 + (((unsi
1b40: 67 6e 65 64 29 4e 4f 50 55 53 48 5f 4d 41 53 4b  gned)NOPUSH_MASK
1b50: 5f 35 29 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f  _5)<<16),.    NO
1b60: 50 55 53 48 5f 4d 41 53 4b 5f 36 20 2b 20 28 28  PUSH_MASK_6 + ((
1b70: 28 75 6e 73 69 67 6e 65 64 29 4e 4f 50 55 53 48  (unsigned)NOPUSH
1b80: 5f 4d 41 53 4b 5f 37 29 3c 3c 31 36 29 2c 0a 20  _MASK_7)<<16),. 
1b90: 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 38     NOPUSH_MASK_8
1ba0: 20 2b 20 28 28 28 75 6e 73 69 67 6e 65 64 29 4e   + (((unsigned)N
1bb0: 4f 50 55 53 48 5f 4d 41 53 4b 5f 39 29 3c 3c 31  OPUSH_MASK_9)<<1
1bc0: 36 29 0a 20 20 7d 3b 0a 20 20 61 73 73 65 72 74  6).  };.  assert
1bd0: 28 20 6f 70 3c 33 32 2a 35 20 29 3b 0a 20 20 72  ( op<32*5 );.  r
1be0: 65 74 75 72 6e 20 28 6d 61 73 6b 73 5b 6f 70 3e  eturn (masks[op>
1bf0: 3e 35 5d 20 26 20 28 31 3c 3c 28 6f 70 26 30 78  >5] & (1<<(op&0x
1c00: 31 46 29 29 29 3b 0a 7d 0a 0a 23 69 66 6e 64 65  1F)));.}..#ifnde
1c10: 66 20 4e 44 45 42 55 47 0a 69 6e 74 20 73 71 6c  f NDEBUG.int sql
1c20: 69 74 65 33 56 64 62 65 4f 70 63 6f 64 65 4e 6f  ite3VdbeOpcodeNo
1c30: 50 75 73 68 28 75 38 20 6f 70 29 7b 0a 20 20 72  Push(u8 op){.  r
1c40: 65 74 75 72 6e 20 6f 70 63 6f 64 65 4e 6f 50 75  eturn opcodeNoPu
1c50: 73 68 28 6f 70 29 3b 0a 7d 0a 23 65 6e 64 69 66  sh(op);.}.#endif
1c60: 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 70 20 74 68 72  ../*.** Loop thr
1c70: 6f 75 67 68 20 74 68 65 20 70 72 6f 67 72 61 6d  ough the program
1c80: 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 50 32 20   looking for P2 
1c90: 76 61 6c 75 65 73 20 74 68 61 74 20 61 72 65 20  values that are 
1ca0: 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 45 61 63  negative..** Eac
1cb0: 68 20 73 75 63 68 20 76 61 6c 75 65 20 69 73 20  h such value is 
1cc0: 61 20 6c 61 62 65 6c 2e 20 20 52 65 73 6f 6c 76  a label.  Resolv
1cd0: 65 20 74 68 65 20 6c 61 62 65 6c 20 62 79 20 73  e the label by s
1ce0: 65 74 74 69 6e 67 20 74 68 65 20 50 32 0a 2a 2a  etting the P2.**
1cf0: 20 76 61 6c 75 65 20 74 6f 20 69 74 73 20 63 6f   value to its co
1d00: 72 72 65 63 74 20 6e 6f 6e 2d 7a 65 72 6f 20 76  rrect non-zero v
1d10: 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  alue..**.** This
1d20: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c   routine is call
1d30: 65 64 20 6f 6e 63 65 20 61 66 74 65 72 20 61 6c  ed once after al
1d40: 6c 20 6f 70 63 6f 64 65 73 20 68 61 76 65 20 62  l opcodes have b
1d50: 65 65 6e 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2a  een inserted..**
1d60: 0a 2a 2a 20 56 61 72 69 61 62 6c 65 20 2a 70 4d  .** Variable *pM
1d70: 61 78 46 75 6e 63 41 72 67 73 20 69 73 20 73 65  axFuncArgs is se
1d80: 74 20 74 6f 20 74 68 65 20 6d 61 78 69 6d 75 6d  t to the maximum
1d90: 20 76 61 6c 75 65 20 6f 66 20 61 6e 79 20 50 32   value of any P2
1da0: 20 61 72 67 75 6d 65 6e 74 20 0a 2a 2a 20 74 6f   argument .** to
1db0: 20 61 6e 20 4f 50 5f 46 75 6e 63 74 69 6f 6e 2c   an OP_Function,
1dc0: 20 4f 50 5f 41 67 67 53 74 65 70 20 6f 72 20 4f   OP_AggStep or O
1dd0: 50 5f 56 46 69 6c 74 65 72 20 6f 70 63 6f 64 65  P_VFilter opcode
1de0: 2e 20 54 68 69 73 20 69 73 20 75 73 65 64 20 62  . This is used b
1df0: 79 20 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62  y .** sqlite3Vdb
1e00: 65 4d 61 6b 65 52 65 61 64 79 28 29 20 74 6f 20  eMakeReady() to 
1e10: 73 69 7a 65 20 74 68 65 20 56 64 62 65 2e 61 70  size the Vdbe.ap
1e20: 41 72 67 5b 5d 20 61 72 72 61 79 2e 0a 2a 2a 0a  Arg[] array..**.
1e30: 2a 2a 20 54 68 65 20 69 6e 74 65 67 65 72 20 2a  ** The integer *
1e40: 70 4d 61 78 53 74 61 63 6b 20 69 73 20 73 65 74  pMaxStack is set
1e50: 20 74 6f 20 74 68 65 20 6d 61 78 69 6d 75 6d 20   to the maximum 
1e60: 6e 75 6d 62 65 72 20 6f 66 20 76 64 62 65 20 73  number of vdbe s
1e70: 74 61 63 6b 0a 2a 2a 20 65 6e 74 72 69 65 73 20  tack.** entries 
1e80: 74 68 61 74 20 73 74 61 74 69 63 20 61 6e 61 6c  that static anal
1e90: 79 73 69 73 20 72 65 76 65 61 6c 73 20 74 68 69  ysis reveals thi
1ea0: 73 20 70 72 6f 67 72 61 6d 20 6d 69 67 68 74 20  s program might 
1eb0: 6e 65 65 64 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  need..**.** This
1ec0: 20 72 6f 75 74 69 6e 65 20 61 6c 73 6f 20 64 6f   routine also do
1ed0: 65 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  es the following
1ee0: 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 3a 20 20   optimization:  
1ef0: 49 74 20 73 63 61 6e 73 20 66 6f 72 0a 2a 2a 20  It scans for.** 
1f00: 48 61 6c 74 20 69 6e 73 74 72 75 63 74 69 6f 6e  Halt instruction
1f10: 73 20 77 68 65 72 65 20 50 31 3d 3d 53 51 4c 49  s where P1==SQLI
1f20: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 6f 72  TE_CONSTRAINT or
1f30: 20 50 32 3d 3d 4f 45 5f 41 62 6f 72 74 20 6f 72   P2==OE_Abort or
1f40: 20 66 6f 72 0a 2a 2a 20 49 64 78 49 6e 73 65 72   for.** IdxInser
1f50: 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 77  t instructions w
1f60: 68 65 72 65 20 50 32 21 3d 30 2e 20 20 49 66 20  here P2!=0.  If 
1f70: 6e 6f 20 73 75 63 68 20 69 6e 73 74 72 75 63 74  no such instruct
1f80: 69 6f 6e 20 69 73 0a 2a 2a 20 66 6f 75 6e 64 2c  ion is.** found,
1f90: 20 74 68 65 6e 20 65 76 65 72 79 20 53 74 61 74   then every Stat
1fa0: 65 6d 65 6e 74 20 69 6e 73 74 72 75 63 74 69 6f  ement instructio
1fb0: 6e 20 69 73 20 63 68 61 6e 67 65 64 20 74 6f 20  n is changed to 
1fc0: 61 20 4e 6f 6f 70 2e 20 20 49 6e 0a 2a 2a 20 74  a Noop.  In.** t
1fd0: 68 69 73 20 77 61 79 2c 20 77 65 20 61 76 6f 69  his way, we avoi
1fe0: 64 20 63 72 65 61 74 69 6e 67 20 74 68 65 20 73  d creating the s
1ff0: 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c  tatement journal
2000: 20 66 69 6c 65 20 75 6e 6e 65 63 65 73 73 61 72   file unnecessar
2010: 69 6c 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ily..*/.static v
2020: 6f 69 64 20 72 65 73 6f 6c 76 65 50 32 56 61 6c  oid resolveP2Val
2030: 75 65 73 28 56 64 62 65 20 2a 70 2c 20 69 6e 74  ues(Vdbe *p, int
2040: 20 2a 70 4d 61 78 46 75 6e 63 41 72 67 73 2c 20   *pMaxFuncArgs, 
2050: 69 6e 74 20 2a 70 4d 61 78 53 74 61 63 6b 29 7b  int *pMaxStack){
2060: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20  .  int i;.  int 
2070: 6e 4d 61 78 41 72 67 73 20 3d 20 30 3b 0a 20 20  nMaxArgs = 0;.  
2080: 69 6e 74 20 6e 4d 61 78 53 74 61 63 6b 20 3d 20  int nMaxStack = 
2090: 70 2d 3e 6e 4f 70 3b 0a 20 20 4f 70 20 2a 70 4f  p->nOp;.  Op *pO
20a0: 70 3b 0a 20 20 69 6e 74 20 2a 61 4c 61 62 65 6c  p;.  int *aLabel
20b0: 20 3d 20 70 2d 3e 61 4c 61 62 65 6c 3b 0a 20 20   = p->aLabel;.  
20c0: 69 6e 74 20 64 6f 65 73 53 74 61 74 65 6d 65 6e  int doesStatemen
20d0: 74 52 6f 6c 6c 62 61 63 6b 20 3d 20 30 3b 0a 20  tRollback = 0;. 
20e0: 20 69 6e 74 20 68 61 73 53 74 61 74 65 6d 65 6e   int hasStatemen
20f0: 74 42 65 67 69 6e 20 3d 20 30 3b 0a 20 20 66 6f  tBegin = 0;.  fo
2100: 72 28 70 4f 70 3d 70 2d 3e 61 4f 70 2c 20 69 3d  r(pOp=p->aOp, i=
2110: 70 2d 3e 6e 4f 70 2d 31 3b 20 69 3e 3d 30 3b 20  p->nOp-1; i>=0; 
2120: 69 2d 2d 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20 20  i--, pOp++){.   
2130: 20 75 38 20 6f 70 63 6f 64 65 20 3d 20 70 4f 70   u8 opcode = pOp
2140: 2d 3e 6f 70 63 6f 64 65 3b 0a 0a 20 20 20 20 69  ->opcode;..    i
2150: 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 46 75  f( opcode==OP_Fu
2160: 6e 63 74 69 6f 6e 20 7c 7c 20 6f 70 63 6f 64 65  nction || opcode
2170: 3d 3d 4f 50 5f 41 67 67 53 74 65 70 20 0a 23 69  ==OP_AggStep .#i
2180: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
2190: 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20  T_VIRTUALTABLE. 
21a0: 20 20 20 20 20 20 20 7c 7c 20 6f 70 63 6f 64 65         || opcode
21b0: 3d 3d 4f 50 5f 56 55 70 64 61 74 65 0a 23 65 6e  ==OP_VUpdate.#en
21c0: 64 69 66 0a 20 20 20 20 29 7b 0a 20 20 20 20 20  dif.    ){.     
21d0: 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e 6e 4d 61   if( pOp->p2>nMa
21e0: 78 41 72 67 73 20 29 20 6e 4d 61 78 41 72 67 73  xArgs ) nMaxArgs
21f0: 20 3d 20 70 4f 70 2d 3e 70 32 3b 0a 20 20 20 20   = pOp->p2;.    
2200: 7d 65 6c 73 65 20 69 66 28 20 6f 70 63 6f 64 65  }else if( opcode
2210: 3d 3d 4f 50 5f 48 61 6c 74 20 29 7b 0a 20 20 20  ==OP_Halt ){.   
2220: 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 31 3d 3d     if( pOp->p1==
2230: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
2240: 54 20 26 26 20 70 4f 70 2d 3e 70 32 3d 3d 4f 45  T && pOp->p2==OE
2250: 5f 41 62 6f 72 74 20 29 7b 0a 20 20 20 20 20 20  _Abort ){.      
2260: 20 20 64 6f 65 73 53 74 61 74 65 6d 65 6e 74 52    doesStatementR
2270: 6f 6c 6c 62 61 63 6b 20 3d 20 31 3b 0a 20 20 20  ollback = 1;.   
2280: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69     }.    }else i
2290: 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 53 74  f( opcode==OP_St
22a0: 61 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20 20 20  atement ){.     
22b0: 20 68 61 73 53 74 61 74 65 6d 65 6e 74 42 65 67   hasStatementBeg
22c0: 69 6e 20 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73  in = 1;.    }els
22d0: 65 20 69 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50  e if( opcode==OP
22e0: 5f 56 46 69 6c 74 65 72 20 29 7b 0a 20 20 20 20  _VFilter ){.    
22f0: 20 20 69 6e 74 20 6e 3b 0a 20 20 20 20 20 20 61    int n;.      a
2300: 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 20 2d 20  ssert( p->nOp - 
2310: 69 20 3e 3d 20 33 20 29 3b 0a 20 20 20 20 20 20  i >= 3 );.      
2320: 61 73 73 65 72 74 28 20 70 4f 70 5b 2d 32 5d 2e  assert( pOp[-2].
2330: 6f 70 63 6f 64 65 3d 3d 4f 50 5f 49 6e 74 65 67  opcode==OP_Integ
2340: 65 72 20 29 3b 0a 20 20 20 20 20 20 6e 20 3d 20  er );.      n = 
2350: 70 4f 70 5b 2d 32 5d 2e 70 31 3b 0a 20 20 20 20  pOp[-2].p1;.    
2360: 20 20 69 66 28 20 6e 3e 6e 4d 61 78 41 72 67 73    if( n>nMaxArgs
2370: 20 29 20 6e 4d 61 78 41 72 67 73 20 3d 20 6e 3b   ) nMaxArgs = n;
2380: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 6f  .    }.    if( o
2390: 70 63 6f 64 65 4e 6f 50 75 73 68 28 6f 70 63 6f  pcodeNoPush(opco
23a0: 64 65 29 20 29 7b 0a 20 20 20 20 20 20 6e 4d 61  de) ){.      nMa
23b0: 78 53 74 61 63 6b 2d 2d 3b 0a 20 20 20 20 7d 0a  xStack--;.    }.
23c0: 0a 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 32  .    if( pOp->p2
23d0: 3e 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a  >=0 ) continue;.
23e0: 20 20 20 20 61 73 73 65 72 74 28 20 2d 31 2d 70      assert( -1-p
23f0: 4f 70 2d 3e 70 32 3c 70 2d 3e 6e 4c 61 62 65 6c  Op->p2<p->nLabel
2400: 20 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 32 20   );.    pOp->p2 
2410: 3d 20 61 4c 61 62 65 6c 5b 2d 31 2d 70 4f 70 2d  = aLabel[-1-pOp-
2420: 3e 70 32 5d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  >p2];.  }.  sqli
2430: 74 65 46 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c  teFree(p->aLabel
2440: 29 3b 0a 20 20 70 2d 3e 61 4c 61 62 65 6c 20 3d  );.  p->aLabel =
2450: 20 30 3b 0a 0a 20 20 2a 70 4d 61 78 46 75 6e 63   0;..  *pMaxFunc
2460: 41 72 67 73 20 3d 20 6e 4d 61 78 41 72 67 73 3b  Args = nMaxArgs;
2470: 0a 20 20 2a 70 4d 61 78 53 74 61 63 6b 20 3d 20  .  *pMaxStack = 
2480: 6e 4d 61 78 53 74 61 63 6b 3b 0a 0a 20 20 2f 2a  nMaxStack;..  /*
2490: 20 49 66 20 77 65 20 6e 65 76 65 72 20 72 6f 6c   If we never rol
24a0: 6c 62 61 63 6b 20 61 20 73 74 61 74 65 6d 65 6e  lback a statemen
24b0: 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74  t transaction, t
24c0: 68 65 6e 20 73 74 61 74 65 6d 65 6e 74 0a 20 20  hen statement.  
24d0: 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20  ** transactions 
24e0: 61 72 65 20 6e 6f 74 20 6e 65 65 64 65 64 2e 20  are not needed. 
24f0: 20 53 6f 20 63 68 61 6e 67 65 20 65 76 65 72 79   So change every
2500: 20 4f 50 5f 53 74 61 74 65 6d 65 6e 74 0a 20 20   OP_Statement.  
2510: 2a 2a 20 6f 70 63 6f 64 65 20 69 6e 74 6f 20 61  ** opcode into a
2520: 6e 20 4f 50 5f 4e 6f 6f 70 2e 20 20 54 68 69 73  n OP_Noop.  This
2530: 20 61 76 6f 69 64 20 61 20 63 61 6c 6c 20 74 6f   avoid a call to
2540: 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78   sqlite3OsOpenEx
2550: 63 6c 75 73 69 76 65 28 29 0a 20 20 2a 2a 20 77  clusive().  ** w
2560: 68 69 63 68 20 63 61 6e 20 62 65 20 65 78 70 65  hich can be expe
2570: 6e 73 69 76 65 20 6f 6e 20 73 6f 6d 65 20 70 6c  nsive on some pl
2580: 61 74 66 6f 72 6d 73 2e 0a 20 20 2a 2f 0a 20 20  atforms..  */.  
2590: 69 66 28 20 68 61 73 53 74 61 74 65 6d 65 6e 74  if( hasStatement
25a0: 42 65 67 69 6e 20 26 26 20 21 64 6f 65 73 53 74  Begin && !doesSt
25b0: 61 74 65 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20  atementRollback 
25c0: 29 7b 0a 20 20 20 20 66 6f 72 28 70 4f 70 3d 70  ){.    for(pOp=p
25d0: 2d 3e 61 4f 70 2c 20 69 3d 70 2d 3e 6e 4f 70 2d  ->aOp, i=p->nOp-
25e0: 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 2c 20 70 4f  1; i>=0; i--, pO
25f0: 70 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20  p++){.      if( 
2600: 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f  pOp->opcode==OP_
2610: 53 74 61 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20  Statement ){.   
2620: 20 20 20 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65       pOp->opcode
2630: 20 3d 20 4f 50 5f 4e 6f 6f 70 3b 0a 20 20 20 20   = OP_Noop;.    
2640: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a    }.    }.  }.}.
2650: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ./*.** Return th
2660: 65 20 61 64 64 72 65 73 73 20 6f 66 20 74 68 65  e address of the
2670: 20 6e 65 78 74 20 69 6e 73 74 72 75 63 74 69 6f   next instructio
2680: 6e 20 74 6f 20 62 65 20 69 6e 73 65 72 74 65 64  n to be inserted
2690: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
26a0: 56 64 62 65 43 75 72 72 65 6e 74 41 64 64 72 28  VdbeCurrentAddr(
26b0: 56 64 62 65 20 2a 70 29 7b 0a 20 20 61 73 73 65  Vdbe *p){.  asse
26c0: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
26d0: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
26e0: 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 6e 4f 70  .  return p->nOp
26f0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61  ;.}../*.** Add a
2700: 20 77 68 6f 6c 65 20 6c 69 73 74 20 6f 66 20 6f   whole list of o
2710: 70 65 72 61 74 69 6f 6e 73 20 74 6f 20 74 68 65  perations to the
2720: 20 6f 70 65 72 61 74 69 6f 6e 20 73 74 61 63 6b   operation stack
2730: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 0a 2a 2a  .  Return the.**
2740: 20 61 64 64 72 65 73 73 20 6f 66 20 74 68 65 20   address of the 
2750: 66 69 72 73 74 20 6f 70 65 72 61 74 69 6f 6e 20  first operation 
2760: 61 64 64 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71  added..*/.int sq
2770: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69  lite3VdbeAddOpLi
2780: 73 74 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  st(Vdbe *p, int 
2790: 6e 4f 70 2c 20 56 64 62 65 4f 70 4c 69 73 74 20  nOp, VdbeOpList 
27a0: 63 6f 6e 73 74 20 2a 61 4f 70 29 7b 0a 20 20 69  const *aOp){.  i
27b0: 6e 74 20 61 64 64 72 3b 0a 20 20 61 73 73 65 72  nt addr;.  asser
27c0: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
27d0: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
27e0: 20 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28    resizeOpArray(
27f0: 70 2c 20 70 2d 3e 6e 4f 70 20 2b 20 6e 4f 70 29  p, p->nOp + nOp)
2800: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 4d  ;.  if( sqlite3M
2810: 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20 29 7b  allocFailed() ){
2820: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20  .    return 0;. 
2830: 20 7d 0a 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e   }.  addr = p->n
2840: 4f 70 3b 0a 20 20 69 66 28 20 6e 4f 70 3e 30 20  Op;.  if( nOp>0 
2850: 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  ){.    int i;.  
2860: 20 20 56 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e    VdbeOpList con
2870: 73 74 20 2a 70 49 6e 20 3d 20 61 4f 70 3b 0a 20  st *pIn = aOp;. 
2880: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 4f     for(i=0; i<nO
2890: 70 3b 20 69 2b 2b 2c 20 70 49 6e 2b 2b 29 7b 0a  p; i++, pIn++){.
28a0: 20 20 20 20 20 20 69 6e 74 20 70 32 20 3d 20 70        int p2 = p
28b0: 49 6e 2d 3e 70 32 3b 0a 20 20 20 20 20 20 56 64  In->p2;.      Vd
28c0: 62 65 4f 70 20 2a 70 4f 75 74 20 3d 20 26 70 2d  beOp *pOut = &p-
28d0: 3e 61 4f 70 5b 69 2b 61 64 64 72 5d 3b 0a 20 20  >aOp[i+addr];.  
28e0: 20 20 20 20 70 4f 75 74 2d 3e 6f 70 63 6f 64 65      pOut->opcode
28f0: 20 3d 20 70 49 6e 2d 3e 6f 70 63 6f 64 65 3b 0a   = pIn->opcode;.
2900: 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 31 20 3d        pOut->p1 =
2910: 20 70 49 6e 2d 3e 70 31 3b 0a 20 20 20 20 20 20   pIn->p1;.      
2920: 70 4f 75 74 2d 3e 70 32 20 3d 20 70 32 3c 30 20  pOut->p2 = p2<0 
2930: 3f 20 61 64 64 72 20 2b 20 41 44 44 52 28 70 32  ? addr + ADDR(p2
2940: 29 20 3a 20 70 32 3b 0a 20 20 20 20 20 20 70 4f  ) : p2;.      pO
2950: 75 74 2d 3e 70 33 20 3d 20 70 49 6e 2d 3e 70 33  ut->p3 = pIn->p3
2960: 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70 33  ;.      pOut->p3
2970: 74 79 70 65 20 3d 20 70 49 6e 2d 3e 70 33 20 3f  type = pIn->p3 ?
2980: 20 50 33 5f 53 54 41 54 49 43 20 3a 20 50 33 5f   P3_STATIC : P3_
2990: 4e 4f 54 55 53 45 44 3b 0a 23 69 66 64 65 66 20  NOTUSED;.#ifdef 
29a0: 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20  SQLITE_DEBUG.   
29b0: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 76     if( sqlite3_v
29c0: 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63 65 20  dbe_addop_trace 
29d0: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
29e0: 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28 30 2c  e3VdbePrintOp(0,
29f0: 20 69 2b 61 64 64 72 2c 20 26 70 2d 3e 61 4f 70   i+addr, &p->aOp
2a00: 5b 69 2b 61 64 64 72 5d 29 3b 0a 20 20 20 20 20  [i+addr]);.     
2a10: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a   }.#endif.    }.
2a20: 20 20 20 20 70 2d 3e 6e 4f 70 20 2b 3d 20 6e 4f      p->nOp += nO
2a30: 70 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  p;.  }.  return 
2a40: 61 64 64 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  addr;.}../*.** C
2a50: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20  hange the value 
2a60: 6f 66 20 74 68 65 20 50 31 20 6f 70 65 72 61 6e  of the P1 operan
2a70: 64 20 66 6f 72 20 61 20 73 70 65 63 69 66 69 63  d for a specific
2a80: 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a   instruction..**
2a90: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
2aa0: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 61 20 6c   useful when a l
2ab0: 61 72 67 65 20 70 72 6f 67 72 61 6d 20 69 73 20  arge program is 
2ac0: 6c 6f 61 64 65 64 20 66 72 6f 6d 20 61 0a 2a 2a  loaded from a.**
2ad0: 20 73 74 61 74 69 63 20 61 72 72 61 79 20 75 73   static array us
2ae0: 69 6e 67 20 73 71 6c 69 74 65 33 56 64 62 65 41  ing sqlite3VdbeA
2af0: 64 64 4f 70 4c 69 73 74 20 62 75 74 20 77 65 20  ddOpList but we 
2b00: 77 61 6e 74 20 74 6f 20 6d 61 6b 65 20 61 0a 2a  want to make a.*
2b10: 2a 20 66 65 77 20 6d 69 6e 6f 72 20 63 68 61 6e  * few minor chan
2b20: 67 65 73 20 74 6f 20 74 68 65 20 70 72 6f 67 72  ges to the progr
2b30: 61 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  am..*/.void sqli
2b40: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 31 28  te3VdbeChangeP1(
2b50: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64  Vdbe *p, int add
2b60: 72 2c 20 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61  r, int val){.  a
2b70: 73 73 65 72 74 28 20 70 3d 3d 30 20 7c 7c 20 70  ssert( p==0 || p
2b80: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
2b90: 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 69 66  GIC_INIT );.  if
2ba0: 28 20 70 20 26 26 20 61 64 64 72 3e 3d 30 20 26  ( p && addr>=0 &
2bb0: 26 20 70 2d 3e 6e 4f 70 3e 61 64 64 72 20 26 26  & p->nOp>addr &&
2bc0: 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 70   p->aOp ){.    p
2bd0: 2d 3e 61 4f 70 5b 61 64 64 72 5d 2e 70 31 20 3d  ->aOp[addr].p1 =
2be0: 20 76 61 6c 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a   val;.  }.}../*.
2bf0: 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 76 61  ** Change the va
2c00: 6c 75 65 20 6f 66 20 74 68 65 20 50 32 20 6f 70  lue of the P2 op
2c10: 65 72 61 6e 64 20 66 6f 72 20 61 20 73 70 65 63  erand for a spec
2c20: 69 66 69 63 20 69 6e 73 74 72 75 63 74 69 6f 6e  ific instruction
2c30: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  ..** This routin
2c40: 65 20 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20  e is useful for 
2c50: 73 65 74 74 69 6e 67 20 61 20 6a 75 6d 70 20 64  setting a jump d
2c60: 65 73 74 69 6e 61 74 69 6f 6e 2e 0a 2a 2f 0a 76  estination..*/.v
2c70: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43  oid sqlite3VdbeC
2c80: 68 61 6e 67 65 50 32 28 56 64 62 65 20 2a 70 2c  hangeP2(Vdbe *p,
2c90: 20 69 6e 74 20 61 64 64 72 2c 20 69 6e 74 20 76   int addr, int v
2ca0: 61 6c 29 7b 0a 20 20 61 73 73 65 72 74 28 20 76  al){.  assert( v
2cb0: 61 6c 3e 3d 30 20 29 3b 0a 20 20 61 73 73 65 72  al>=0 );.  asser
2cc0: 74 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 6d 61  t( p==0 || p->ma
2cd0: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
2ce0: 49 4e 49 54 20 29 3b 0a 20 20 69 66 28 20 70 20  INIT );.  if( p 
2cf0: 26 26 20 61 64 64 72 3e 3d 30 20 26 26 20 70 2d  && addr>=0 && p-
2d00: 3e 6e 4f 70 3e 61 64 64 72 20 26 26 20 70 2d 3e  >nOp>addr && p->
2d10: 61 4f 70 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4f  aOp ){.    p->aO
2d20: 70 5b 61 64 64 72 5d 2e 70 32 20 3d 20 76 61 6c  p[addr].p2 = val
2d30: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  ;.  }.}../*.** C
2d40: 68 61 6e 67 65 20 74 68 65 20 50 32 20 6f 70 65  hange the P2 ope
2d50: 72 61 6e 64 20 6f 66 20 69 6e 73 74 72 75 63 74  rand of instruct
2d60: 69 6f 6e 20 61 64 64 72 20 73 6f 20 74 68 61 74  ion addr so that
2d70: 20 69 74 20 70 6f 69 6e 74 73 20 74 6f 0a 2a 2a   it points to.**
2d80: 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66 20   the address of 
2d90: 74 68 65 20 6e 65 78 74 20 69 6e 73 74 72 75 63  the next instruc
2da0: 74 69 6f 6e 20 74 6f 20 62 65 20 63 6f 64 65 64  tion to be coded
2db0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
2dc0: 33 56 64 62 65 4a 75 6d 70 48 65 72 65 28 56 64  3VdbeJumpHere(Vd
2dd0: 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 29  be *p, int addr)
2de0: 7b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 43  {.  sqlite3VdbeC
2df0: 68 61 6e 67 65 50 32 28 70 2c 20 61 64 64 72 2c  hangeP2(p, addr,
2e00: 20 70 2d 3e 6e 4f 70 29 3b 0a 7d 0a 0a 0a 2f 2a   p->nOp);.}.../*
2e10: 0a 2a 2a 20 49 66 20 74 68 65 20 69 6e 70 75 74  .** If the input
2e20: 20 46 75 6e 63 44 65 66 20 73 74 72 75 63 74 75   FuncDef structu
2e30: 72 65 20 69 73 20 65 70 68 65 6d 65 72 61 6c 2c  re is ephemeral,
2e40: 20 74 68 65 6e 20 66 72 65 65 20 69 74 2e 20 20   then free it.  
2e50: 49 66 0a 2a 2a 20 74 68 65 20 46 75 6e 63 44 65  If.** the FuncDe
2e60: 66 20 69 73 20 6e 6f 74 20 65 70 68 65 72 6d 61  f is not epherma
2e70: 6c 2c 20 74 68 65 6e 20 64 6f 20 6e 6f 74 68 69  l, then do nothi
2e80: 6e 67 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  ng..*/.static vo
2e90: 69 64 20 66 72 65 65 45 70 68 65 6d 65 72 61 6c  id freeEphemeral
2ea0: 46 75 6e 63 74 69 6f 6e 28 46 75 6e 63 44 65 66  Function(FuncDef
2eb0: 20 2a 70 44 65 66 29 7b 0a 20 20 69 66 28 20 70   *pDef){.  if( p
2ec0: 44 65 66 20 26 26 20 28 70 44 65 66 2d 3e 66 6c  Def && (pDef->fl
2ed0: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 46 55 4e  ags & SQLITE_FUN
2ee0: 43 5f 45 50 48 45 4d 29 21 3d 30 20 29 7b 0a 20  C_EPHEM)!=0 ){. 
2ef0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 44     sqliteFree(pD
2f00: 65 66 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  ef);.  }.}../*.*
2f10: 2a 20 44 65 6c 65 74 65 20 61 20 50 33 20 76 61  * Delete a P3 va
2f20: 6c 75 65 20 69 66 20 6e 65 63 65 73 73 61 72 79  lue if necessary
2f30: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
2f40: 20 66 72 65 65 50 33 28 69 6e 74 20 70 33 74 79   freeP3(int p3ty
2f50: 70 65 2c 20 76 6f 69 64 20 2a 70 33 29 7b 0a 20  pe, void *p3){. 
2f60: 20 69 66 28 20 70 33 20 29 7b 0a 20 20 20 20 73   if( p3 ){.    s
2f70: 77 69 74 63 68 28 20 70 33 74 79 70 65 20 29 7b  witch( p3type ){
2f80: 0a 20 20 20 20 20 20 63 61 73 65 20 50 33 5f 44  .      case P3_D
2f90: 59 4e 41 4d 49 43 3a 0a 20 20 20 20 20 20 63 61  YNAMIC:.      ca
2fa0: 73 65 20 50 33 5f 4b 45 59 49 4e 46 4f 3a 0a 20  se P3_KEYINFO:. 
2fb0: 20 20 20 20 20 63 61 73 65 20 50 33 5f 4b 45 59       case P3_KEY
2fc0: 49 4e 46 4f 5f 48 41 4e 44 4f 46 46 3a 20 7b 0a  INFO_HANDOFF: {.
2fd0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72          sqliteFr
2fe0: 65 65 28 70 33 29 3b 0a 20 20 20 20 20 20 20 20  ee(p3);.        
2ff0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  break;.      }. 
3000: 20 20 20 20 20 63 61 73 65 20 50 33 5f 4d 50 52       case P3_MPR
3010: 49 4e 54 46 3a 20 7b 0a 20 20 20 20 20 20 20 20  INTF: {.        
3020: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 33 29  sqlite3_free(p3)
3030: 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  ;.        break;
3040: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63  .      }.      c
3050: 61 73 65 20 50 33 5f 56 44 42 45 46 55 4e 43 3a  ase P3_VDBEFUNC:
3060: 20 7b 0a 20 20 20 20 20 20 20 20 56 64 62 65 46   {.        VdbeF
3070: 75 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 20 3d  unc *pVdbeFunc =
3080: 20 28 56 64 62 65 46 75 6e 63 20 2a 29 70 33 3b   (VdbeFunc *)p3;
3090: 0a 20 20 20 20 20 20 20 20 66 72 65 65 45 70 68  .        freeEph
30a0: 65 6d 65 72 61 6c 46 75 6e 63 74 69 6f 6e 28 70  emeralFunction(p
30b0: 56 64 62 65 46 75 6e 63 2d 3e 70 46 75 6e 63 29  VdbeFunc->pFunc)
30c0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
30d0: 33 56 64 62 65 44 65 6c 65 74 65 41 75 78 44 61  3VdbeDeleteAuxDa
30e0: 74 61 28 70 56 64 62 65 46 75 6e 63 2c 20 30 29  ta(pVdbeFunc, 0)
30f0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
3100: 46 72 65 65 28 70 56 64 62 65 46 75 6e 63 29 3b  Free(pVdbeFunc);
3110: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
3120: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61        }.      ca
3130: 73 65 20 50 33 5f 46 55 4e 43 44 45 46 3a 20 7b  se P3_FUNCDEF: {
3140: 0a 20 20 20 20 20 20 20 20 66 72 65 65 45 70 68  .        freeEph
3150: 65 6d 65 72 61 6c 46 75 6e 63 74 69 6f 6e 28 28  emeralFunction((
3160: 46 75 6e 63 44 65 66 2a 29 70 33 29 3b 0a 20 20  FuncDef*)p3);.  
3170: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3180: 20 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20     }.      case 
3190: 50 33 5f 4d 45 4d 3a 20 7b 0a 20 20 20 20 20 20  P3_MEM: {.      
31a0: 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 46 72    sqlite3ValueFr
31b0: 65 65 28 28 73 71 6c 69 74 65 33 5f 76 61 6c 75  ee((sqlite3_valu
31c0: 65 2a 29 70 33 29 3b 0a 20 20 20 20 20 20 20 20  e*)p3);.        
31d0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20  break;.      }. 
31e0: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a     }.  }.}.../*.
31f0: 2a 2a 20 43 68 61 6e 67 65 20 4e 20 6f 70 63 6f  ** Change N opco
3200: 64 65 73 20 73 74 61 72 74 69 6e 67 20 61 74 20  des starting at 
3210: 61 64 64 72 20 74 6f 20 4e 6f 2d 6f 70 73 2e 0a  addr to No-ops..
3220: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
3230: 64 62 65 43 68 61 6e 67 65 54 6f 4e 6f 6f 70 28  dbeChangeToNoop(
3240: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64  Vdbe *p, int add
3250: 72 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 56 64 62  r, int N){.  Vdb
3260: 65 4f 70 20 2a 70 4f 70 20 3d 20 26 70 2d 3e 61  eOp *pOp = &p->a
3270: 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 77 68 69 6c  Op[addr];.  whil
3280: 65 28 20 4e 2d 2d 20 29 7b 0a 20 20 20 20 66 72  e( N-- ){.    fr
3290: 65 65 50 33 28 70 4f 70 2d 3e 70 33 74 79 70 65  eeP3(pOp->p3type
32a0: 2c 20 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20 20  , pOp->p3);.    
32b0: 6d 65 6d 73 65 74 28 70 4f 70 2c 20 30 2c 20 73  memset(pOp, 0, s
32c0: 69 7a 65 6f 66 28 70 4f 70 5b 30 5d 29 29 3b 0a  izeof(pOp[0]));.
32d0: 20 20 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20      pOp->opcode 
32e0: 3d 20 4f 50 5f 4e 6f 6f 70 3b 0a 20 20 20 20 70  = OP_Noop;.    p
32f0: 4f 70 2b 2b 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  Op++;.  }.}../*.
3300: 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20 76 61  ** Change the va
3310: 6c 75 65 20 6f 66 20 74 68 65 20 50 33 20 6f 70  lue of the P3 op
3320: 65 72 61 6e 64 20 66 6f 72 20 61 20 73 70 65 63  erand for a spec
3330: 69 66 69 63 20 69 6e 73 74 72 75 63 74 69 6f 6e  ific instruction
3340: 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  ..** This routin
3350: 65 20 69 73 20 75 73 65 66 75 6c 20 77 68 65 6e  e is useful when
3360: 20 61 20 6c 61 72 67 65 20 70 72 6f 67 72 61 6d   a large program
3370: 20 69 73 20 6c 6f 61 64 65 64 20 66 72 6f 6d 20   is loaded from 
3380: 61 0a 2a 2a 20 73 74 61 74 69 63 20 61 72 72 61  a.** static arra
3390: 79 20 75 73 69 6e 67 20 73 71 6c 69 74 65 33 56  y using sqlite3V
33a0: 64 62 65 41 64 64 4f 70 4c 69 73 74 20 62 75 74  dbeAddOpList but
33b0: 20 77 65 20 77 61 6e 74 20 74 6f 20 6d 61 6b 65   we want to make
33c0: 20 61 0a 2a 2a 20 66 65 77 20 6d 69 6e 6f 72 20   a.** few minor 
33d0: 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65 20 70  changes to the p
33e0: 72 6f 67 72 61 6d 2e 0a 2a 2a 0a 2a 2a 20 49 66  rogram..**.** If
33f0: 20 6e 3e 3d 30 20 74 68 65 6e 20 74 68 65 20 50   n>=0 then the P
3400: 33 20 6f 70 65 72 61 6e 64 20 69 73 20 64 79 6e  3 operand is dyn
3410: 61 6d 69 63 2c 20 6d 65 61 6e 69 6e 67 20 74 68  amic, meaning th
3420: 61 74 20 61 20 63 6f 70 79 20 6f 66 0a 2a 2a 20  at a copy of.** 
3430: 74 68 65 20 73 74 72 69 6e 67 20 69 73 20 6d 61  the string is ma
3440: 64 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f  de into memory o
3450: 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c  btained from sql
3460: 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a 2a 20  iteMalloc()..** 
3470: 41 20 76 61 6c 75 65 20 6f 66 20 6e 3d 3d 30 20  A value of n==0 
3480: 6d 65 61 6e 73 20 63 6f 70 79 20 62 79 74 65 73  means copy bytes
3490: 20 6f 66 20 7a 50 33 20 75 70 20 74 6f 20 61 6e   of zP3 up to an
34a0: 64 20 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 0a  d including the.
34b0: 2a 2a 20 66 69 72 73 74 20 6e 75 6c 6c 20 62 79  ** first null by
34c0: 74 65 2e 20 20 49 66 20 6e 3e 30 20 74 68 65 6e  te.  If n>0 then
34d0: 20 63 6f 70 79 20 6e 2b 31 20 62 79 74 65 73 20   copy n+1 bytes 
34e0: 6f 66 20 7a 50 33 2e 0a 2a 2a 0a 2a 2a 20 49 66  of zP3..**.** If
34f0: 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 69   n==P3_KEYINFO i
3500: 74 20 6d 65 61 6e 73 20 74 68 61 74 20 7a 50 33  t means that zP3
3510: 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f   is a pointer to
3520: 20 61 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63   a KeyInfo struc
3530: 74 75 72 65 2e 0a 2a 2a 20 41 20 63 6f 70 79 20  ture..** A copy 
3540: 69 73 20 6d 61 64 65 20 6f 66 20 74 68 65 20 4b  is made of the K
3550: 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65  eyInfo structure
3560: 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f 62 74   into memory obt
3570: 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 73 71  ained from.** sq
3580: 6c 69 74 65 4d 61 6c 6c 6f 63 2c 20 74 6f 20 62  liteMalloc, to b
3590: 65 20 66 72 65 65 64 20 77 68 65 6e 20 74 68 65  e freed when the
35a0: 20 56 64 62 65 20 69 73 20 66 69 6e 61 6c 69 7a   Vdbe is finaliz
35b0: 65 64 2e 0a 2a 2a 20 6e 3d 3d 50 33 5f 4b 45 59  ed..** n==P3_KEY
35c0: 49 4e 46 4f 5f 48 41 4e 44 4f 46 46 20 69 6e 64  INFO_HANDOFF ind
35d0: 69 63 61 74 65 73 20 74 68 61 74 20 7a 50 33 20  icates that zP3 
35e0: 70 6f 69 6e 74 73 20 74 6f 20 61 20 4b 65 79 49  points to a KeyI
35f0: 6e 66 6f 20 73 74 72 75 63 74 75 72 65 0a 2a 2a  nfo structure.**
3600: 20 73 74 6f 72 65 64 20 69 6e 20 6d 65 6d 6f 72   stored in memor
3610: 79 20 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65  y that the calle
3620: 72 20 68 61 73 20 6f 62 74 61 69 6e 65 64 20 66  r has obtained f
3630: 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63  rom sqliteMalloc
3640: 2e 20 54 68 65 20 0a 2a 2a 20 63 61 6c 6c 65 72  . The .** caller
3650: 20 73 68 6f 75 6c 64 20 6e 6f 74 20 66 72 65 65   should not free
3660: 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f 6e 2c   the allocation,
3670: 20 69 74 20 77 69 6c 6c 20 62 65 20 66 72 65 65   it will be free
3680: 64 20 77 68 65 6e 20 74 68 65 20 56 64 62 65 20  d when the Vdbe 
3690: 69 73 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65 64 2e  is.** finalized.
36a0: 0a 2a 2a 20 0a 2a 2a 20 4f 74 68 65 72 20 76 61  .** .** Other va
36b0: 6c 75 65 73 20 6f 66 20 6e 20 28 50 33 5f 53 54  lues of n (P3_ST
36c0: 41 54 49 43 2c 20 50 33 5f 43 4f 4c 4c 53 45 51  ATIC, P3_COLLSEQ
36d0: 20 65 74 63 2e 29 20 69 6e 64 69 63 61 74 65 20   etc.) indicate 
36e0: 74 68 61 74 20 7a 50 33 20 70 6f 69 6e 74 73 0a  that zP3 points.
36f0: 2a 2a 20 74 6f 20 61 20 73 74 72 69 6e 67 20 6f  ** to a string o
3700: 72 20 73 74 72 75 63 74 75 72 65 20 74 68 61 74  r structure that
3710: 20 69 73 20 67 75 61 72 61 6e 74 65 65 64 20 74   is guaranteed t
3720: 6f 20 65 78 69 73 74 20 66 6f 72 20 74 68 65 20  o exist for the 
3730: 6c 69 66 65 74 69 6d 65 20 6f 66 0a 2a 2a 20 74  lifetime of.** t
3740: 68 65 20 56 64 62 65 2e 20 49 6e 20 74 68 65 73  he Vdbe. In thes
3750: 65 20 63 61 73 65 73 20 77 65 20 63 61 6e 20 6a  e cases we can j
3760: 75 73 74 20 63 6f 70 79 20 74 68 65 20 70 6f 69  ust copy the poi
3770: 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 61  nter..**.** If a
3780: 64 64 72 3c 30 20 74 68 65 6e 20 63 68 61 6e 67  ddr<0 then chang
3790: 65 20 50 33 20 6f 6e 20 74 68 65 20 6d 6f 73 74  e P3 on the most
37a0: 20 72 65 63 65 6e 74 6c 79 20 69 6e 73 65 72 74   recently insert
37b0: 65 64 20 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a  ed instruction..
37c0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
37d0: 64 62 65 43 68 61 6e 67 65 50 33 28 56 64 62 65  dbeChangeP3(Vdbe
37e0: 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 63   *p, int addr, c
37f0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 33 2c 20  onst char *zP3, 
3800: 69 6e 74 20 6e 29 7b 0a 20 20 4f 70 20 2a 70 4f  int n){.  Op *pO
3810: 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70 3d 3d  p;.  assert( p==
3820: 30 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  0 || p->magic==V
3830: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
3840: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20  ;.  if( p==0 || 
3850: 70 2d 3e 61 4f 70 3d 3d 30 20 7c 7c 20 73 71 6c  p->aOp==0 || sql
3860: 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64  ite3MallocFailed
3870: 28 29 20 29 7b 0a 20 20 20 20 69 66 20 28 6e 20  () ){.    if (n 
3880: 21 3d 20 50 33 5f 4b 45 59 49 4e 46 4f 29 20 7b  != P3_KEYINFO) {
3890: 0a 20 20 20 20 20 20 66 72 65 65 50 33 28 6e 2c  .      freeP3(n,
38a0: 20 28 76 6f 69 64 2a 29 2a 28 63 68 61 72 2a 2a   (void*)*(char**
38b0: 29 26 7a 50 33 29 3b 0a 20 20 20 20 7d 0a 20 20  )&zP3);.    }.  
38c0: 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20    return;.  }.  
38d0: 69 66 28 20 61 64 64 72 3c 30 20 7c 7c 20 61 64  if( addr<0 || ad
38e0: 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20  dr>=p->nOp ){.  
38f0: 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 20    addr = p->nOp 
3900: 2d 20 31 3b 0a 20 20 20 20 69 66 28 20 61 64 64  - 1;.    if( add
3910: 72 3c 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  r<0 ) return;.  
3920: 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f  }.  pOp = &p->aO
3930: 70 5b 61 64 64 72 5d 3b 0a 20 20 66 72 65 65 50  p[addr];.  freeP
3940: 33 28 70 4f 70 2d 3e 70 33 74 79 70 65 2c 20 70  3(pOp->p3type, p
3950: 4f 70 2d 3e 70 33 29 3b 0a 20 20 70 4f 70 2d 3e  Op->p3);.  pOp->
3960: 70 33 20 3d 20 30 3b 0a 20 20 69 66 28 20 7a 50  p3 = 0;.  if( zP
3970: 33 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d  3==0 ){.    pOp-
3980: 3e 70 33 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70  >p3 = 0;.    pOp
3990: 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f  ->p3type = P3_NO
39a0: 54 55 53 45 44 3b 0a 20 20 7d 65 6c 73 65 20 69  TUSED;.  }else i
39b0: 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f  f( n==P3_KEYINFO
39c0: 20 29 7b 0a 20 20 20 20 4b 65 79 49 6e 66 6f 20   ){.    KeyInfo 
39d0: 2a 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 20 20 69  *pKeyInfo;.    i
39e0: 6e 74 20 6e 46 69 65 6c 64 2c 20 6e 42 79 74 65  nt nField, nByte
39f0: 3b 0a 0a 20 20 20 20 6e 46 69 65 6c 64 20 3d 20  ;..    nField = 
3a00: 28 28 4b 65 79 49 6e 66 6f 2a 29 7a 50 33 29 2d  ((KeyInfo*)zP3)-
3a10: 3e 6e 46 69 65 6c 64 3b 0a 20 20 20 20 6e 42 79  >nField;.    nBy
3a20: 74 65 20 3d 20 73 69 7a 65 6f 66 28 2a 70 4b 65  te = sizeof(*pKe
3a30: 79 49 6e 66 6f 29 20 2b 20 28 6e 46 69 65 6c 64  yInfo) + (nField
3a40: 2d 31 29 2a 73 69 7a 65 6f 66 28 70 4b 65 79 49  -1)*sizeof(pKeyI
3a50: 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 30 5d 29 20 2b  nfo->aColl[0]) +
3a60: 20 6e 46 69 65 6c 64 3b 0a 20 20 20 20 70 4b 65   nField;.    pKe
3a70: 79 49 6e 66 6f 20 3d 20 73 71 6c 69 74 65 4d 61  yInfo = sqliteMa
3a80: 6c 6c 6f 63 52 61 77 28 20 6e 42 79 74 65 20 29  llocRaw( nByte )
3a90: 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20  ;.    pOp->p3 = 
3aa0: 28 63 68 61 72 2a 29 70 4b 65 79 49 6e 66 6f 3b  (char*)pKeyInfo;
3ab0: 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66  .    if( pKeyInf
3ac0: 6f 20 29 7b 0a 20 20 20 20 20 20 75 6e 73 69 67  o ){.      unsig
3ad0: 6e 65 64 20 63 68 61 72 20 2a 61 53 6f 72 74 4f  ned char *aSortO
3ae0: 72 64 65 72 3b 0a 20 20 20 20 20 20 6d 65 6d 63  rder;.      memc
3af0: 70 79 28 70 4b 65 79 49 6e 66 6f 2c 20 7a 50 33  py(pKeyInfo, zP3
3b00: 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20  , nByte);.      
3b10: 61 53 6f 72 74 4f 72 64 65 72 20 3d 20 70 4b 65  aSortOrder = pKe
3b20: 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65  yInfo->aSortOrde
3b30: 72 3b 0a 20 20 20 20 20 20 69 66 28 20 61 53 6f  r;.      if( aSo
3b40: 72 74 4f 72 64 65 72 20 29 7b 0a 20 20 20 20 20  rtOrder ){.     
3b50: 20 20 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f     pKeyInfo->aSo
3b60: 72 74 4f 72 64 65 72 20 3d 20 28 75 6e 73 69 67  rtOrder = (unsig
3b70: 6e 65 64 20 63 68 61 72 2a 29 26 70 4b 65 79 49  ned char*)&pKeyI
3b80: 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6e 46 69 65 6c  nfo->aColl[nFiel
3b90: 64 5d 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63  d];.        memc
3ba0: 70 79 28 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f  py(pKeyInfo->aSo
3bb0: 72 74 4f 72 64 65 72 2c 20 61 53 6f 72 74 4f 72  rtOrder, aSortOr
3bc0: 64 65 72 2c 20 6e 46 69 65 6c 64 29 3b 0a 20 20  der, nField);.  
3bd0: 20 20 20 20 7d 0a 20 20 20 20 20 20 70 4f 70 2d      }.      pOp-
3be0: 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59  >p3type = P3_KEY
3bf0: 49 4e 46 4f 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  INFO;.    }else{
3c00: 0a 20 20 20 20 20 20 70 4f 70 2d 3e 70 33 74 79  .      pOp->p3ty
3c10: 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b  pe = P3_NOTUSED;
3c20: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69  .    }.  }else i
3c30: 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f  f( n==P3_KEYINFO
3c40: 5f 48 41 4e 44 4f 46 46 20 29 7b 0a 20 20 20 20  _HANDOFF ){.    
3c50: 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61 72 2a  pOp->p3 = (char*
3c60: 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d 3e 70  )zP3;.    pOp->p
3c70: 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59 49 4e  3type = P3_KEYIN
3c80: 46 4f 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  FO;.  }else if( 
3c90: 6e 3c 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e  n<0 ){.    pOp->
3ca0: 70 33 20 3d 20 28 63 68 61 72 2a 29 7a 50 33 3b  p3 = (char*)zP3;
3cb0: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65  .    pOp->p3type
3cc0: 20 3d 20 6e 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20   = n;.  }else{. 
3cd0: 20 20 20 69 66 28 20 6e 3d 3d 30 20 29 20 6e 20     if( n==0 ) n 
3ce0: 3d 20 73 74 72 6c 65 6e 28 7a 50 33 29 3b 0a 20  = strlen(zP3);. 
3cf0: 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 73 71 6c     pOp->p3 = sql
3d00: 69 74 65 53 74 72 4e 44 75 70 28 7a 50 33 2c 20  iteStrNDup(zP3, 
3d10: 6e 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74  n);.    pOp->p3t
3d20: 79 70 65 20 3d 20 50 33 5f 44 59 4e 41 4d 49 43  ype = P3_DYNAMIC
3d30: 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66  ;.  }.}..#ifndef
3d40: 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65   NDEBUG./*.** Re
3d50: 70 6c 61 63 65 20 74 68 65 20 50 33 20 66 69 65  place the P3 fie
3d60: 6c 64 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72  ld of the most r
3d70: 65 63 65 6e 74 6c 79 20 63 6f 64 65 64 20 69 6e  ecently coded in
3d80: 73 74 72 75 63 74 69 6f 6e 20 77 69 74 68 0a 2a  struction with.*
3d90: 2a 20 63 6f 6d 6d 65 6e 74 20 74 65 78 74 2e 0a  * comment text..
3da0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
3db0: 64 62 65 43 6f 6d 6d 65 6e 74 28 56 64 62 65 20  dbeComment(Vdbe 
3dc0: 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  *p, const char *
3dd0: 7a 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a 20  zFormat, ...){. 
3de0: 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 61   va_list ap;.  a
3df0: 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20  ssert( p->nOp>0 
3e00: 7c 7c 20 70 2d 3e 61 4f 70 3d 3d 30 20 29 3b 0a  || p->aOp==0 );.
3e10: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f 70    assert( p->aOp
3e20: 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 5b 70 2d  ==0 || p->aOp[p-
3e30: 3e 6e 4f 70 2d 31 5d 2e 70 33 3d 3d 30 20 7c 7c  >nOp-1].p3==0 ||
3e40: 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61   sqlite3MallocFa
3e50: 69 6c 65 64 28 29 20 29 3b 0a 20 20 76 61 5f 73  iled() );.  va_s
3e60: 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d 61 74  tart(ap, zFormat
3e70: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
3e80: 43 68 61 6e 67 65 50 33 28 70 2c 20 2d 31 2c 20  ChangeP3(p, -1, 
3e90: 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74 66 28  sqlite3VMPrintf(
3ea0: 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c 20 50 33  zFormat, ap), P3
3eb0: 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20 76 61 5f  _DYNAMIC);.  va_
3ec0: 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65 6e 64 69  end(ap);.}.#endi
3ed0: 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  f../*.** Return 
3ee0: 74 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20 61  the opcode for a
3ef0: 20 67 69 76 65 6e 20 61 64 64 72 65 73 73 2e 0a   given address..
3f00: 2a 2f 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69 74  */.VdbeOp *sqlit
3f10: 65 33 56 64 62 65 47 65 74 4f 70 28 56 64 62 65  e3VdbeGetOp(Vdbe
3f20: 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 29 7b 0a   *p, int addr){.
3f30: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67    assert( p->mag
3f40: 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic==VDBE_MAGIC_I
3f50: 4e 49 54 20 29 3b 0a 20 20 61 73 73 65 72 74 28  NIT );.  assert(
3f60: 20 28 61 64 64 72 3e 3d 30 20 26 26 20 61 64 64   (addr>=0 && add
3f70: 72 3c 70 2d 3e 6e 4f 70 29 20 7c 7c 20 73 71 6c  r<p->nOp) || sql
3f80: 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64  ite3MallocFailed
3f90: 28 29 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 28  () );.  return (
3fa0: 28 61 64 64 72 3e 3d 30 20 26 26 20 61 64 64 72  (addr>=0 && addr
3fb0: 3c 70 2d 3e 6e 4f 70 29 3f 28 26 70 2d 3e 61 4f  <p->nOp)?(&p->aO
3fc0: 70 5b 61 64 64 72 5d 29 3a 30 29 3b 0a 7d 0a 0a  p[addr]):0);.}..
3fd0: 23 69 66 20 21 64 65 66 69 6e 65 64 28 53 51 4c  #if !defined(SQL
3fe0: 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e  ITE_OMIT_EXPLAIN
3ff0: 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28 4e 44  ) || !defined(ND
4000: 45 42 55 47 29 20 5c 0a 20 20 20 20 20 7c 7c 20  EBUG) \.     || 
4010: 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f  defined(VDBE_PRO
4020: 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65 64  FILE) || defined
4030: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f  (SQLITE_DEBUG)./
4040: 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 61 20 73  *.** Compute a s
4050: 74 72 69 6e 67 20 74 68 61 74 20 64 65 73 63 72  tring that descr
4060: 69 62 65 73 20 74 68 65 20 50 33 20 70 61 72 61  ibes the P3 para
4070: 6d 65 74 65 72 20 66 6f 72 20 61 6e 20 6f 70 63  meter for an opc
4080: 6f 64 65 2e 0a 2a 2a 20 55 73 65 20 7a 54 65 6d  ode..** Use zTem
4090: 70 20 66 6f 72 20 61 6e 79 20 72 65 71 75 69 72  p for any requir
40a0: 65 64 20 74 65 6d 70 6f 72 61 72 79 20 62 75 66  ed temporary buf
40b0: 66 65 72 20 73 70 61 63 65 2e 0a 2a 2f 0a 73 74  fer space..*/.st
40c0: 61 74 69 63 20 63 68 61 72 20 2a 64 69 73 70 6c  atic char *displ
40d0: 61 79 50 33 28 4f 70 20 2a 70 4f 70 2c 20 63 68  ayP3(Op *pOp, ch
40e0: 61 72 20 2a 7a 54 65 6d 70 2c 20 69 6e 74 20 6e  ar *zTemp, int n
40f0: 54 65 6d 70 29 7b 0a 20 20 63 68 61 72 20 2a 7a  Temp){.  char *z
4100: 50 33 3b 0a 20 20 61 73 73 65 72 74 28 20 6e 54  P3;.  assert( nT
4110: 65 6d 70 3e 3d 32 30 20 29 3b 0a 20 20 73 77 69  emp>=20 );.  swi
4120: 74 63 68 28 20 70 4f 70 2d 3e 70 33 74 79 70 65  tch( pOp->p3type
4130: 20 29 7b 0a 20 20 20 20 63 61 73 65 20 50 33 5f   ){.    case P3_
4140: 4b 45 59 49 4e 46 4f 3a 20 7b 0a 20 20 20 20 20  KEYINFO: {.     
4150: 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 20 20 20   int i, j;.     
4160: 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e   KeyInfo *pKeyIn
4170: 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 70  fo = (KeyInfo*)p
4180: 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 73 70  Op->p3;.      sp
4190: 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 6b 65  rintf(zTemp, "ke
41a0: 79 69 6e 66 6f 28 25 64 22 2c 20 70 4b 65 79 49  yinfo(%d", pKeyI
41b0: 6e 66 6f 2d 3e 6e 46 69 65 6c 64 29 3b 0a 20 20  nfo->nField);.  
41c0: 20 20 20 20 69 20 3d 20 73 74 72 6c 65 6e 28 7a      i = strlen(z
41d0: 54 65 6d 70 29 3b 0a 20 20 20 20 20 20 66 6f 72  Temp);.      for
41e0: 28 6a 3d 30 3b 20 6a 3c 70 4b 65 79 49 6e 66 6f  (j=0; j<pKeyInfo
41f0: 2d 3e 6e 46 69 65 6c 64 3b 20 6a 2b 2b 29 7b 0a  ->nField; j++){.
4200: 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 20          CollSeq 
4210: 2a 70 43 6f 6c 6c 20 3d 20 70 4b 65 79 49 6e 66  *pColl = pKeyInf
4220: 6f 2d 3e 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20  o->aColl[j];.   
4230: 20 20 20 20 20 69 66 28 20 70 43 6f 6c 6c 20 29       if( pColl )
4240: 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20  {.          int 
4250: 6e 20 3d 20 73 74 72 6c 65 6e 28 70 43 6f 6c 6c  n = strlen(pColl
4260: 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20  ->zName);.      
4270: 20 20 20 20 69 66 28 20 69 2b 6e 3e 6e 54 65 6d      if( i+n>nTem
4280: 70 2d 36 20 29 7b 0a 20 20 20 20 20 20 20 20 20  p-6 ){.         
4290: 20 20 20 73 74 72 63 70 79 28 26 7a 54 65 6d 70     strcpy(&zTemp
42a0: 5b 69 5d 2c 22 2c 2e 2e 2e 22 29 3b 0a 20 20 20  [i],",...");.   
42b0: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a           break;.
42c0: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
42d0: 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d        zTemp[i++]
42e0: 20 3d 20 27 2c 27 3b 0a 20 20 20 20 20 20 20 20   = ',';.        
42f0: 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e    if( pKeyInfo->
4300: 61 53 6f 72 74 4f 72 64 65 72 20 26 26 20 70 4b  aSortOrder && pK
4310: 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64  eyInfo->aSortOrd
4320: 65 72 5b 6a 5d 20 29 7b 0a 20 20 20 20 20 20 20  er[j] ){.       
4330: 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20       zTemp[i++] 
4340: 3d 20 27 2d 27 3b 0a 20 20 20 20 20 20 20 20 20  = '-';.         
4350: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 73 74 72   }.          str
4360: 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c 20 70  cpy(&zTemp[i], p
4370: 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20  Coll->zName);.  
4380: 20 20 20 20 20 20 20 20 69 20 2b 3d 20 6e 3b 0a          i += n;.
4390: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66          }else if
43a0: 28 20 69 2b 34 3c 6e 54 65 6d 70 2d 36 20 29 7b  ( i+4<nTemp-6 ){
43b0: 0a 20 20 20 20 20 20 20 20 20 20 73 74 72 63 70  .          strcp
43c0: 79 28 26 7a 54 65 6d 70 5b 69 5d 2c 22 2c 6e 69  y(&zTemp[i],",ni
43d0: 6c 22 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69  l");.          i
43e0: 20 2b 3d 20 34 3b 0a 20 20 20 20 20 20 20 20 7d   += 4;.        }
43f0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7a  .      }.      z
4400: 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27 29 27 3b  Temp[i++] = ')';
4410: 0a 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 5d 20  .      zTemp[i] 
4420: 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 72  = 0;.      asser
4430: 74 28 20 69 3c 6e 54 65 6d 70 20 29 3b 0a 20 20  t( i<nTemp );.  
4440: 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b      zP3 = zTemp;
4450: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  .      break;.  
4460: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 50 33 5f    }.    case P3_
4470: 43 4f 4c 4c 53 45 51 3a 20 7b 0a 20 20 20 20 20  COLLSEQ: {.     
4480: 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20   CollSeq *pColl 
4490: 3d 20 28 43 6f 6c 6c 53 65 71 2a 29 70 4f 70 2d  = (CollSeq*)pOp-
44a0: 3e 70 33 3b 0a 20 20 20 20 20 20 73 70 72 69 6e  >p3;.      sprin
44b0: 74 66 28 7a 54 65 6d 70 2c 20 22 63 6f 6c 6c 73  tf(zTemp, "colls
44c0: 65 71 28 25 2e 32 30 73 29 22 2c 20 70 43 6f 6c  eq(%.20s)", pCol
44d0: 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20  l->zName);.     
44e0: 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20   zP3 = zTemp;.  
44f0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
4500: 0a 20 20 20 20 63 61 73 65 20 50 33 5f 46 55 4e  .    case P3_FUN
4510: 43 44 45 46 3a 20 7b 0a 20 20 20 20 20 20 46 75  CDEF: {.      Fu
4520: 6e 63 44 65 66 20 2a 70 44 65 66 20 3d 20 28 46  ncDef *pDef = (F
4530: 75 6e 63 44 65 66 2a 29 70 4f 70 2d 3e 70 33 3b  uncDef*)pOp->p3;
4540: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 73  .      sqlite3_s
4550: 6e 70 72 69 6e 74 66 28 6e 54 65 6d 70 2c 20 7a  nprintf(nTemp, z
4560: 54 65 6d 70 2c 20 22 25 73 28 25 64 29 22 2c 20  Temp, "%s(%d)", 
4570: 70 44 65 66 2d 3e 7a 4e 61 6d 65 2c 20 70 44 65  pDef->zName, pDe
4580: 66 2d 3e 6e 41 72 67 29 3b 0a 20 20 20 20 20 20  f->nArg);.      
4590: 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20  zP3 = zTemp;.   
45a0: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a     break;.    }.
45b0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
45c0: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45  MIT_VIRTUALTABLE
45d0: 0a 20 20 20 20 63 61 73 65 20 50 33 5f 56 54 41  .    case P3_VTA
45e0: 42 3a 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  B: {.      sqlit
45f0: 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62 20 3d  e3_vtab *pVtab =
4600: 20 28 73 71 6c 69 74 65 33 5f 76 74 61 62 2a 29   (sqlite3_vtab*)
4610: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 73  pOp->p3;.      s
4620: 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28  qlite3_snprintf(
4630: 6e 54 65 6d 70 2c 20 7a 54 65 6d 70 2c 20 22 76  nTemp, zTemp, "v
4640: 74 61 62 3a 25 70 3a 25 70 22 2c 20 70 56 74 61  tab:%p:%p", pVta
4650: 62 2c 20 70 56 74 61 62 2d 3e 70 4d 6f 64 75 6c  b, pVtab->pModul
4660: 65 29 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20  e);.      zP3 = 
4670: 7a 54 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65  zTemp;.      bre
4680: 61 6b 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66  ak;.    }.#endif
4690: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a  .    default: {.
46a0: 20 20 20 20 20 20 7a 50 33 20 3d 20 70 4f 70 2d        zP3 = pOp-
46b0: 3e 70 33 3b 0a 20 20 20 20 20 20 69 66 28 20 7a  >p3;.      if( z
46c0: 50 33 3d 3d 30 20 7c 7c 20 70 4f 70 2d 3e 6f 70  P3==0 || pOp->op
46d0: 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 7b  code==OP_Noop ){
46e0: 0a 20 20 20 20 20 20 20 20 7a 50 33 20 3d 20 22  .        zP3 = "
46f0: 22 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  ";.      }.    }
4700: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 7a  .  }.  assert( z
4710: 50 33 21 3d 30 20 29 3b 0a 20 20 72 65 74 75 72  P3!=0 );.  retur
4720: 6e 20 7a 50 33 3b 0a 7d 0a 23 65 6e 64 69 66 0a  n zP3;.}.#endif.
4730: 0a 0a 23 69 66 20 64 65 66 69 6e 65 64 28 56 44  ..#if defined(VD
4740: 42 45 5f 50 52 4f 46 49 4c 45 29 20 7c 7c 20 64  BE_PROFILE) || d
4750: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45  efined(SQLITE_DE
4760: 42 55 47 29 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74  BUG)./*.** Print
4770: 20 61 20 73 69 6e 67 6c 65 20 6f 70 63 6f 64 65   a single opcode
4780: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  .  This routine 
4790: 69 73 20 75 73 65 64 20 66 6f 72 20 64 65 62 75  is used for debu
47a0: 67 67 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76  gging only..*/.v
47b0: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 50  oid sqlite3VdbeP
47c0: 72 69 6e 74 4f 70 28 46 49 4c 45 20 2a 70 4f 75  rintOp(FILE *pOu
47d0: 74 2c 20 69 6e 74 20 70 63 2c 20 4f 70 20 2a 70  t, int pc, Op *p
47e0: 4f 70 29 7b 0a 20 20 63 68 61 72 20 2a 7a 50 33  Op){.  char *zP3
47f0: 3b 0a 20 20 63 68 61 72 20 7a 50 74 72 5b 35 30  ;.  char zPtr[50
4800: 5d 3b 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73  ];.  static cons
4810: 74 20 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74 31  t char *zFormat1
4820: 20 3d 20 22 25 34 64 20 25 2d 31 33 73 20 25 34   = "%4d %-13s %4
4830: 64 20 25 34 64 20 25 73 5c 6e 22 3b 0a 20 20 69  d %4d %s\n";.  i
4840: 66 28 20 70 4f 75 74 3d 3d 30 20 29 20 70 4f 75  f( pOut==0 ) pOu
4850: 74 20 3d 20 73 74 64 6f 75 74 3b 0a 20 20 7a 50  t = stdout;.  zP
4860: 33 20 3d 20 64 69 73 70 6c 61 79 50 33 28 70 4f  3 = displayP3(pO
4870: 70 2c 20 7a 50 74 72 2c 20 73 69 7a 65 6f 66 28  p, zPtr, sizeof(
4880: 7a 50 74 72 29 29 3b 0a 20 20 66 70 72 69 6e 74  zPtr));.  fprint
4890: 66 28 70 4f 75 74 2c 20 7a 46 6f 72 6d 61 74 31  f(pOut, zFormat1
48a0: 2c 0a 20 20 20 20 20 20 70 63 2c 20 73 71 6c 69  ,.      pc, sqli
48b0: 74 65 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70  te3OpcodeNames[p
48c0: 4f 70 2d 3e 6f 70 63 6f 64 65 5d 2c 20 70 4f 70  Op->opcode], pOp
48d0: 2d 3e 70 31 2c 20 70 4f 70 2d 3e 70 32 2c 20 7a  ->p1, pOp->p2, z
48e0: 50 33 29 3b 0a 20 20 66 66 6c 75 73 68 28 70 4f  P3);.  fflush(pO
48f0: 75 74 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f  ut);.}.#endif../
4900: 2a 0a 2a 2a 20 52 65 6c 65 61 73 65 20 61 6e 20  *.** Release an 
4910: 61 72 72 61 79 20 6f 66 20 4e 20 4d 65 6d 20 65  array of N Mem e
4920: 6c 65 6d 65 6e 74 73 0a 2a 2f 0a 73 74 61 74 69  lements.*/.stati
4930: 63 20 76 6f 69 64 20 72 65 6c 65 61 73 65 4d 65  c void releaseMe
4940: 6d 41 72 72 61 79 28 4d 65 6d 20 2a 70 2c 20 69  mArray(Mem *p, i
4950: 6e 74 20 4e 29 7b 0a 20 20 69 66 28 20 70 20 29  nt N){.  if( p )
4960: 7b 0a 20 20 20 20 77 68 69 6c 65 28 20 4e 2d 2d  {.    while( N--
4970: 3e 30 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  >0 ){.      sqli
4980: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
4990: 65 28 70 2b 2b 29 3b 0a 20 20 20 20 7d 0a 20 20  e(p++);.    }.  
49a0: 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c  }.}..#ifndef SQL
49b0: 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e  ITE_OMIT_EXPLAIN
49c0: 0a 2f 2a 0a 2a 2a 20 47 69 76 65 20 61 20 6c 69  ./*.** Give a li
49d0: 73 74 69 6e 67 20 6f 66 20 74 68 65 20 70 72 6f  sting of the pro
49e0: 67 72 61 6d 20 69 6e 20 74 68 65 20 76 69 72 74  gram in the virt
49f0: 75 61 6c 20 6d 61 63 68 69 6e 65 2e 0a 2a 2a 0a  ual machine..**.
4a00: 2a 2a 20 54 68 65 20 69 6e 74 65 72 66 61 63 65  ** The interface
4a10: 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20   is the same as 
4a20: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28  sqlite3VdbeExec(
4a30: 29 2e 20 20 42 75 74 20 69 6e 73 74 65 61 64 20  ).  But instead 
4a40: 6f 66 0a 2a 2a 20 72 75 6e 6e 69 6e 67 20 74 68  of.** running th
4a50: 65 20 63 6f 64 65 2c 20 69 74 20 69 6e 76 6f 6b  e code, it invok
4a60: 65 73 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20  es the callback 
4a70: 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 20 69 6e  once for each in
4a80: 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68  struction..** Th
4a90: 69 73 20 66 65 61 74 75 72 65 20 69 73 20 75 73  is feature is us
4aa0: 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20  ed to implement 
4ab0: 22 45 58 50 4c 41 49 4e 22 2e 0a 2a 2f 0a 69 6e  "EXPLAIN"..*/.in
4ac0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 4c 69 73  t sqlite3VdbeLis
4ad0: 74 28 0a 20 20 56 64 62 65 20 2a 70 20 20 20 20  t(.  Vdbe *p    
4ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
4af0: 2a 20 54 68 65 20 56 44 42 45 20 2a 2f 0a 29 7b  * The VDBE */.){
4b00: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d  .  sqlite3 *db =
4b10: 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 3b   p->db;.  int i;
4b20: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
4b30: 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74  TE_OK;..  assert
4b40: 28 20 70 2d 3e 65 78 70 6c 61 69 6e 20 29 3b 0a  ( p->explain );.
4b50: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d    if( p->magic!=
4b60: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29  VDBE_MAGIC_RUN )
4b70: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
4b80: 49 53 55 53 45 3b 0a 20 20 61 73 73 65 72 74 28  ISUSE;.  assert(
4b90: 20 64 62 2d 3e 6d 61 67 69 63 3d 3d 53 51 4c 49   db->magic==SQLI
4ba0: 54 45 5f 4d 41 47 49 43 5f 42 55 53 59 20 29 3b  TE_MAGIC_BUSY );
4bb0: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 72 63  .  assert( p->rc
4bc0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
4bd0: 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53  ->rc==SQLITE_BUS
4be0: 59 20 29 3b 0a 0a 20 20 2f 2a 20 45 76 65 6e 20  Y );..  /* Even 
4bf0: 74 68 6f 75 67 68 20 74 68 69 73 20 6f 70 63 6f  though this opco
4c00: 64 65 20 64 6f 65 73 20 6e 6f 74 20 70 75 74 20  de does not put 
4c10: 64 79 6e 61 6d 69 63 20 73 74 72 69 6e 67 73 20  dynamic strings 
4c20: 6f 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 74 68  onto the.  ** th
4c30: 65 20 73 74 61 63 6b 2c 20 74 68 65 79 20 6d 61  e stack, they ma
4c40: 79 20 62 65 63 6f 6d 65 20 64 79 6e 61 6d 69 63  y become dynamic
4c50: 20 69 66 20 74 68 65 20 75 73 65 72 20 63 61 6c   if the user cal
4c60: 6c 73 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f  ls.  ** sqlite3_
4c70: 63 6f 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 2c  column_text16(),
4c80: 20 63 61 75 73 69 6e 67 20 61 20 74 72 61 6e 73   causing a trans
4c90: 6c 61 74 69 6f 6e 20 74 6f 20 55 54 46 2d 31 36  lation to UTF-16
4ca0: 20 65 6e 63 6f 64 69 6e 67 2e 0a 20 20 2a 2f 0a   encoding..  */.
4cb0: 20 20 69 66 28 20 70 2d 3e 70 54 6f 73 3d 3d 26    if( p->pTos==&
4cc0: 70 2d 3e 61 53 74 61 63 6b 5b 34 5d 20 29 7b 0a  p->aStack[4] ){.
4cd0: 20 20 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72      releaseMemAr
4ce0: 72 61 79 28 70 2d 3e 61 53 74 61 63 6b 2c 20 35  ray(p->aStack, 5
4cf0: 29 3b 0a 20 20 7d 0a 20 20 70 2d 3e 72 65 73 4f  );.  }.  p->resO
4d00: 6e 53 74 61 63 6b 20 3d 20 30 3b 0a 0a 20 20 64  nStack = 0;..  d
4d10: 6f 7b 0a 20 20 20 20 69 20 3d 20 70 2d 3e 70 63  o{.    i = p->pc
4d20: 2b 2b 3b 0a 20 20 7d 77 68 69 6c 65 28 20 69 3c  ++;.  }while( i<
4d30: 70 2d 3e 6e 4f 70 20 26 26 20 70 2d 3e 65 78 70  p->nOp && p->exp
4d40: 6c 61 69 6e 3d 3d 32 20 26 26 20 70 2d 3e 61 4f  lain==2 && p->aO
4d50: 70 5b 69 5d 2e 6f 70 63 6f 64 65 21 3d 4f 50 5f  p[i].opcode!=OP_
4d60: 45 78 70 6c 61 69 6e 20 29 3b 0a 20 20 69 66 28  Explain );.  if(
4d70: 20 69 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20   i>=p->nOp ){.  
4d80: 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45    p->rc = SQLITE
4d90: 5f 4f 4b 3b 0a 20 20 20 20 72 63 20 3d 20 53 51  _OK;.    rc = SQ
4da0: 4c 49 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c  LITE_DONE;.  }el
4db0: 73 65 20 69 66 28 20 64 62 2d 3e 75 31 2e 69 73  se if( db->u1.is
4dc0: 49 6e 74 65 72 72 75 70 74 65 64 20 29 7b 0a 20  Interrupted ){. 
4dd0: 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54     p->rc = SQLIT
4de0: 45 5f 49 4e 54 45 52 52 55 50 54 3b 0a 20 20 20  E_INTERRUPT;.   
4df0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
4e00: 4f 52 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  OR;.    sqlite3S
4e10: 65 74 53 74 72 69 6e 67 28 26 70 2d 3e 7a 45 72  etString(&p->zEr
4e20: 72 4d 73 67 2c 20 73 71 6c 69 74 65 33 45 72 72  rMsg, sqlite3Err
4e30: 53 74 72 28 70 2d 3e 72 63 29 2c 20 28 63 68 61  Str(p->rc), (cha
4e40: 72 2a 29 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  r*)0);.  }else{.
4e50: 20 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26 70      Op *pOp = &p
4e60: 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 4d 65  ->aOp[i];.    Me
4e70: 6d 20 2a 70 4d 65 6d 20 3d 20 70 2d 3e 61 53 74  m *pMem = p->aSt
4e80: 61 63 6b 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 66  ack;.    pMem->f
4e90: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
4ea0: 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d      pMem->type =
4eb0: 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b   SQLITE_INTEGER;
4ec0: 0a 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d  .    pMem->u.i =
4ed0: 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20   i;             
4ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4ef0: 20 20 20 2f 2a 20 50 72 6f 67 72 61 6d 20 63 6f     /* Program co
4f00: 75 6e 74 65 72 20 2a 2f 0a 20 20 20 20 70 4d 65  unter */.    pMe
4f10: 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e  m++;..    pMem->
4f20: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 74 61 74  flags = MEM_Stat
4f30: 69 63 7c 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54  ic|MEM_Str|MEM_T
4f40: 65 72 6d 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a  erm;.    pMem->z
4f50: 20 3d 20 28 63 68 61 72 2a 29 73 71 6c 69 74 65   = (char*)sqlite
4f60: 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70 4f 70  3OpcodeNames[pOp
4f70: 2d 3e 6f 70 63 6f 64 65 5d 3b 20 20 2f 2a 20 4f  ->opcode];  /* O
4f80: 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 61 73 73  pcode */.    ass
4f90: 65 72 74 28 20 70 4d 65 6d 2d 3e 7a 21 3d 30 20  ert( pMem->z!=0 
4fa0: 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d  );.    pMem->n =
4fb0: 20 73 74 72 6c 65 6e 28 70 4d 65 6d 2d 3e 7a 29   strlen(pMem->z)
4fc0: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65  ;.    pMem->type
4fd0: 20 3d 20 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a   = SQLITE_TEXT;.
4fe0: 20 20 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20      pMem->enc = 
4ff0: 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20  SQLITE_UTF8;.   
5000: 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d   pMem++;..    pM
5010: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
5020: 49 6e 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 75  Int;.    pMem->u
5030: 2e 69 20 3d 20 70 4f 70 2d 3e 70 31 3b 20 20 20  .i = pOp->p1;   
5040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5050: 20 20 20 20 20 20 20 2f 2a 20 50 31 20 2a 2f 0a         /* P1 */.
5060: 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d      pMem->type =
5070: 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b   SQLITE_INTEGER;
5080: 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20  .    pMem++;..  
5090: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
50a0: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d 65  MEM_Int;.    pMe
50b0: 6d 2d 3e 75 2e 69 20 3d 20 70 4f 70 2d 3e 70 32  m->u.i = pOp->p2
50c0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
50d0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 32             /* P2
50e0: 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79   */.    pMem->ty
50f0: 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45  pe = SQLITE_INTE
5100: 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b  GER;.    pMem++;
5110: 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67  ..    pMem->flag
5120: 73 20 3d 20 4d 45 4d 5f 45 70 68 65 6d 7c 4d 45  s = MEM_Ephem|ME
5130: 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65 72 6d 3b 20  M_Str|MEM_Term; 
5140: 20 20 2f 2a 20 50 33 20 2a 2f 0a 20 20 20 20 70    /* P3 */.    p
5150: 4d 65 6d 2d 3e 7a 20 3d 20 64 69 73 70 6c 61 79  Mem->z = display
5160: 50 33 28 70 4f 70 2c 20 70 4d 65 6d 2d 3e 7a 53  P3(pOp, pMem->zS
5170: 68 6f 72 74 2c 20 73 69 7a 65 6f 66 28 70 4d 65  hort, sizeof(pMe
5180: 6d 2d 3e 7a 53 68 6f 72 74 29 29 3b 0a 20 20 20  m->zShort));.   
5190: 20 61 73 73 65 72 74 28 20 70 4d 65 6d 2d 3e 7a   assert( pMem->z
51a0: 21 3d 30 20 29 3b 0a 20 20 20 20 70 4d 65 6d 2d  !=0 );.    pMem-
51b0: 3e 6e 20 3d 20 73 74 72 6c 65 6e 28 70 4d 65 6d  >n = strlen(pMem
51c0: 2d 3e 7a 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  ->z);.    pMem->
51d0: 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 54 45  type = SQLITE_TE
51e0: 58 54 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 65 6e  XT;.    pMem->en
51f0: 63 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b  c = SQLITE_UTF8;
5200: 0a 0a 20 20 20 20 70 2d 3e 6e 52 65 73 43 6f 6c  ..    p->nResCol
5210: 75 6d 6e 20 3d 20 35 20 2d 20 32 2a 28 70 2d 3e  umn = 5 - 2*(p->
5220: 65 78 70 6c 61 69 6e 2d 31 29 3b 0a 20 20 20 20  explain-1);.    
5230: 70 2d 3e 70 54 6f 73 20 3d 20 70 4d 65 6d 3b 0a  p->pTos = pMem;.
5240: 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49      p->rc = SQLI
5250: 54 45 5f 4f 4b 3b 0a 20 20 20 20 70 2d 3e 72 65  TE_OK;.    p->re
5260: 73 4f 6e 53 74 61 63 6b 20 3d 20 31 3b 0a 20 20  sOnStack = 1;.  
5270: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 4f    rc = SQLITE_RO
5280: 57 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  W;.  }.  return 
5290: 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20  rc;.}.#endif /* 
52a0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c  SQLITE_OMIT_EXPL
52b0: 41 49 4e 20 2a 2f 0a 0a 23 69 66 64 65 66 20 53  AIN */..#ifdef S
52c0: 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f 2a 0a 2a  QLITE_DEBUG./*.*
52d0: 2a 20 50 72 69 6e 74 20 74 68 65 20 53 51 4c 20  * Print the SQL 
52e0: 74 68 61 74 20 77 61 73 20 75 73 65 64 20 74 6f  that was used to
52f0: 20 67 65 6e 65 72 61 74 65 20 61 20 56 44 42 45   generate a VDBE
5300: 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 76 6f 69   program..*/.voi
5310: 64 20 73 71 6c 69 74 65 33 56 64 62 65 50 72 69  d sqlite3VdbePri
5320: 6e 74 53 71 6c 28 56 64 62 65 20 2a 70 29 7b 0a  ntSql(Vdbe *p){.
5330: 20 20 69 6e 74 20 6e 4f 70 20 3d 20 70 2d 3e 6e    int nOp = p->n
5340: 4f 70 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70 4f  Op;.  VdbeOp *pO
5350: 70 3b 0a 20 20 69 66 28 20 6e 4f 70 3c 31 20 29  p;.  if( nOp<1 )
5360: 20 72 65 74 75 72 6e 3b 0a 20 20 70 4f 70 20 3d   return;.  pOp =
5370: 20 26 70 2d 3e 61 4f 70 5b 6e 4f 70 2d 31 5d 3b   &p->aOp[nOp-1];
5380: 0a 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63 6f  .  if( pOp->opco
5390: 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 26 26 20 70  de==OP_Noop && p
53a0: 4f 70 2d 3e 70 33 21 3d 30 20 29 7b 0a 20 20 20  Op->p3!=0 ){.   
53b0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d   const char *z =
53c0: 20 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 77 68   pOp->p3;.    wh
53d0: 69 6c 65 28 20 69 73 73 70 61 63 65 28 2a 28 75  ile( isspace(*(u
53e0: 38 2a 29 7a 29 20 29 20 7a 2b 2b 3b 0a 20 20 20  8*)z) ) z++;.   
53f0: 20 70 72 69 6e 74 66 28 22 53 51 4c 3a 20 5b 25   printf("SQL: [%
5400: 73 5d 5c 6e 22 2c 20 7a 29 3b 0a 20 20 7d 0a 7d  s]\n", z);.  }.}
5410: 0a 23 65 6e 64 69 66 0a 0a 23 69 66 20 21 64 65  .#endif..#if !de
5420: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49  fined(SQLITE_OMI
5430: 54 5f 54 52 41 43 45 29 20 26 26 20 64 65 66 69  T_TRACE) && defi
5440: 6e 65 64 28 53 51 4c 49 54 45 5f 45 4e 41 42 4c  ned(SQLITE_ENABL
5450: 45 5f 49 4f 54 52 41 43 45 29 0a 2f 2a 0a 2a 2a  E_IOTRACE)./*.**
5460: 20 50 72 69 6e 74 20 61 6e 20 49 4f 54 52 41 43   Print an IOTRAC
5470: 45 20 6d 65 73 73 61 67 65 20 73 68 6f 77 69 6e  E message showin
5480: 67 20 53 51 4c 20 63 6f 6e 74 65 6e 74 2e 0a 2a  g SQL content..*
5490: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
54a0: 62 65 49 4f 54 72 61 63 65 53 71 6c 28 56 64 62  beIOTraceSql(Vdb
54b0: 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 6e 4f 70  e *p){.  int nOp
54c0: 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 56 64 62   = p->nOp;.  Vdb
54d0: 65 4f 70 20 2a 70 4f 70 3b 0a 20 20 69 66 28 20  eOp *pOp;.  if( 
54e0: 73 71 6c 69 74 65 33 5f 69 6f 5f 74 72 61 63 65  sqlite3_io_trace
54f0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  ==0 ) return;.  
5500: 69 66 28 20 6e 4f 70 3c 31 20 29 20 72 65 74 75  if( nOp<1 ) retu
5510: 72 6e 3b 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e  rn;.  pOp = &p->
5520: 61 4f 70 5b 6e 4f 70 2d 31 5d 3b 0a 20 20 69 66  aOp[nOp-1];.  if
5530: 28 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f  ( pOp->opcode==O
5540: 50 5f 4e 6f 6f 70 20 26 26 20 70 4f 70 2d 3e 70  P_Noop && pOp->p
5550: 33 21 3d 30 20 29 7b 0a 20 20 20 20 63 68 61 72  3!=0 ){.    char
5560: 20 2a 7a 20 3d 20 73 71 6c 69 74 65 33 53 74 72   *z = sqlite3Str
5570: 44 75 70 28 70 4f 70 2d 3e 70 33 29 3b 0a 20 20  Dup(pOp->p3);.  
5580: 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 20 20    int i, j;.    
5590: 66 6f 72 28 69 3d 30 3b 20 69 73 73 70 61 63 65  for(i=0; isspace
55a0: 28 7a 5b 69 5d 29 3b 20 69 2b 2b 29 7b 7d 0a 20  (z[i]); i++){}. 
55b0: 20 20 20 66 6f 72 28 6a 3d 30 3b 20 7a 5b 69 5d     for(j=0; z[i]
55c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66  ; i++){.      if
55d0: 28 20 69 73 73 70 61 63 65 28 7a 5b 69 5d 29 20  ( isspace(z[i]) 
55e0: 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a  ){.        if( z
55f0: 5b 69 2d 31 5d 21 3d 27 20 27 20 29 7b 0a 20 20  [i-1]!=' ' ){.  
5600: 20 20 20 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d          z[j++] =
5610: 20 27 20 27 3b 0a 20 20 20 20 20 20 20 20 7d 0a   ' ';.        }.
5620: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
5630: 20 20 20 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 7a 5b       z[j++] = z[
5640: 69 5d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  i];.      }.    
5650: 7d 0a 20 20 20 20 7a 5b 6a 5d 20 3d 20 30 3b 0a  }.    z[j] = 0;.
5660: 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6f 5f 74      sqlite3_io_t
5670: 72 61 63 65 28 22 53 51 4c 20 25 73 5c 6e 22 2c  race("SQL %s\n",
5680: 20 7a 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 46   z);.    sqliteF
5690: 72 65 65 28 7a 29 3b 0a 20 20 7d 0a 7d 0a 23 65  ree(z);.  }.}.#e
56a0: 6e 64 69 66 20 2f 2a 20 21 53 51 4c 49 54 45 5f  ndif /* !SQLITE_
56b0: 4f 4d 49 54 5f 54 52 41 43 45 20 26 26 20 53 51  OMIT_TRACE && SQ
56c0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52  LITE_ENABLE_IOTR
56d0: 41 43 45 20 2a 2f 0a 0a 0a 2f 2a 0a 2a 2a 20 50  ACE */.../*.** P
56e0: 72 65 70 61 72 65 20 61 20 76 69 72 74 75 61 6c  repare a virtual
56f0: 20 6d 61 63 68 69 6e 65 20 66 6f 72 20 65 78 65   machine for exe
5700: 63 75 74 69 6f 6e 2e 20 20 54 68 69 73 20 69 6e  cution.  This in
5710: 76 6f 6c 76 65 73 20 74 68 69 6e 67 73 20 73 75  volves things su
5720: 63 68 0a 2a 2a 20 61 73 20 61 6c 6c 6f 63 61 74  ch.** as allocat
5730: 69 6e 67 20 73 74 61 63 6b 20 73 70 61 63 65 20  ing stack space 
5740: 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 69 6e 67  and initializing
5750: 20 74 68 65 20 70 72 6f 67 72 61 6d 20 63 6f 75   the program cou
5760: 6e 74 65 72 2e 0a 2a 2a 20 41 66 74 65 72 20 74  nter..** After t
5770: 68 65 20 56 44 42 45 20 68 61 73 20 62 65 20 70  he VDBE has be p
5780: 72 65 70 70 65 64 2c 20 69 74 20 63 61 6e 20 62  repped, it can b
5790: 65 20 65 78 65 63 75 74 65 64 20 62 79 20 6f 6e  e executed by on
57a0: 65 20 6f 72 20 6d 6f 72 65 0a 2a 2a 20 63 61 6c  e or more.** cal
57b0: 6c 73 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62  ls to sqlite3Vdb
57c0: 65 45 78 65 63 28 29 2e 20 20 0a 2a 2a 0a 2a 2a  eExec().  .**.**
57d0: 20 54 68 69 73 20 69 73 20 74 68 65 20 6f 6e 6c   This is the onl
57e0: 79 20 77 61 79 20 74 6f 20 6d 6f 76 65 20 61 20  y way to move a 
57f0: 56 44 42 45 20 66 72 6f 6d 20 56 44 42 45 5f 4d  VDBE from VDBE_M
5800: 41 47 49 43 5f 49 4e 49 54 20 74 6f 0a 2a 2a 20  AGIC_INIT to.** 
5810: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 2e 0a  VDBE_MAGIC_RUN..
5820: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
5830: 64 62 65 4d 61 6b 65 52 65 61 64 79 28 0a 20 20  dbeMakeReady(.  
5840: 56 64 62 65 20 2a 70 2c 20 20 20 20 20 20 20 20  Vdbe *p,        
5850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5860: 2a 20 54 68 65 20 56 44 42 45 20 2a 2f 0a 20 20  * The VDBE */.  
5870: 69 6e 74 20 6e 56 61 72 2c 20 20 20 20 20 20 20  int nVar,       
5880: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5890: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 27 3f 27 20  * Number of '?' 
58a0: 73 65 65 20 69 6e 20 74 68 65 20 53 51 4c 20 73  see in the SQL s
58b0: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 69 6e  tatement */.  in
58c0: 74 20 6e 4d 65 6d 2c 20 20 20 20 20 20 20 20 20  t nMem,         
58d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
58e0: 4e 75 6d 62 65 72 20 6f 66 20 6d 65 6d 6f 72 79  Number of memory
58f0: 20 63 65 6c 6c 73 20 74 6f 20 61 6c 6c 6f 63 61   cells to alloca
5900: 74 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 75 72  te */.  int nCur
5910: 73 6f 72 2c 20 20 20 20 20 20 20 20 20 20 20 20  sor,            
5920: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
5930: 20 6f 66 20 63 75 72 73 6f 72 73 20 74 6f 20 61   of cursors to a
5940: 6c 6c 6f 63 61 74 65 20 2a 2f 0a 20 20 69 6e 74  llocate */.  int
5950: 20 69 73 45 78 70 6c 61 69 6e 20 20 20 20 20 20   isExplain      
5960: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
5970: 72 75 65 20 69 66 20 74 68 65 20 45 58 50 4c 41  rue if the EXPLA
5980: 49 4e 20 6b 65 79 77 6f 72 64 73 20 69 73 20 70  IN keywords is p
5990: 72 65 73 65 6e 74 20 2a 2f 0a 29 7b 0a 20 20 69  resent */.){.  i
59a0: 6e 74 20 6e 3b 0a 0a 20 20 61 73 73 65 72 74 28  nt n;..  assert(
59b0: 20 70 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72   p!=0 );.  asser
59c0: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
59d0: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
59e0: 0a 20 20 2f 2a 20 54 68 65 72 65 20 73 68 6f 75  .  /* There shou
59f0: 6c 64 20 62 65 20 61 74 20 6c 65 61 73 74 20 6f  ld be at least o
5a00: 6e 65 20 6f 70 63 6f 64 65 2e 0a 20 20 2a 2f 0a  ne opcode..  */.
5a10: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70    assert( p->nOp
5a20: 3e 30 20 29 3b 0a 0a 20 20 2f 2a 20 53 65 74 20  >0 );..  /* Set 
5a30: 74 68 65 20 6d 61 67 69 63 20 74 6f 20 56 44 42  the magic to VDB
5a40: 45 5f 4d 41 47 49 43 5f 52 55 4e 20 73 6f 6f 6e  E_MAGIC_RUN soon
5a50: 65 72 20 72 61 74 68 65 72 20 74 68 61 6e 20 6c  er rather than l
5a60: 61 74 65 72 2e 20 54 68 69 73 0a 20 20 20 2a 20  ater. This.   * 
5a70: 69 73 20 62 65 63 61 75 73 65 20 74 68 65 20 63  is because the c
5a80: 61 6c 6c 20 74 6f 20 72 65 73 69 7a 65 4f 70 41  all to resizeOpA
5a90: 72 72 61 79 28 29 20 62 65 6c 6f 77 20 6d 61 79  rray() below may
5aa0: 20 73 68 72 69 6e 6b 20 74 68 65 0a 20 20 20 2a   shrink the.   *
5ab0: 20 70 2d 3e 61 4f 70 5b 5d 20 61 72 72 61 79 20   p->aOp[] array 
5ac0: 74 6f 20 73 61 76 65 20 6d 65 6d 6f 72 79 20 69  to save memory i
5ad0: 66 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 69 6e  f called when in
5ae0: 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20   VDBE_MAGIC_RUN 
5af0: 0a 20 20 20 2a 20 73 74 61 74 65 2e 0a 20 20 20  .   * state..   
5b00: 2a 2f 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20  */.  p->magic = 
5b10: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 3b 0a  VDBE_MAGIC_RUN;.
5b20: 0a 20 20 2f 2a 20 4e 6f 20 69 6e 73 74 72 75 63  .  /* No instruc
5b30: 74 69 6f 6e 20 65 76 65 72 20 70 75 73 68 65 73  tion ever pushes
5b40: 20 6d 6f 72 65 20 74 68 61 6e 20 61 20 73 69 6e   more than a sin
5b50: 67 6c 65 20 65 6c 65 6d 65 6e 74 20 6f 6e 74 6f  gle element onto
5b60: 20 74 68 65 0a 20 20 2a 2a 20 73 74 61 63 6b 2e   the.  ** stack.
5b70: 20 20 41 6e 64 20 74 68 65 20 73 74 61 63 6b 20    And the stack 
5b80: 6e 65 76 65 72 20 67 72 6f 77 73 20 6f 6e 20 73  never grows on s
5b90: 75 63 63 65 73 73 69 76 65 20 65 78 65 63 75 74  uccessive execut
5ba0: 69 6f 6e 73 20 6f 66 20 74 68 65 0a 20 20 2a 2a  ions of the.  **
5bb0: 20 73 61 6d 65 20 6c 6f 6f 70 2e 20 20 53 6f 20   same loop.  So 
5bc0: 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72  the total number
5bd0: 20 6f 66 20 69 6e 73 74 72 75 63 74 69 6f 6e 73   of instructions
5be0: 20 69 73 20 61 6e 20 75 70 70 65 72 20 62 6f 75   is an upper bou
5bf0: 6e 64 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 6d  nd.  ** on the m
5c00: 61 78 69 6d 75 6d 20 73 74 61 63 6b 20 64 65 70  aximum stack dep
5c10: 74 68 20 72 65 71 75 69 72 65 64 2e 20 20 28 41  th required.  (A
5c20: 64 64 65 64 20 6c 61 74 65 72 3a 29 20 20 54 68  dded later:)  Th
5c30: 65 0a 20 20 2a 2a 20 72 65 73 6f 6c 76 65 50 32  e.  ** resolveP2
5c40: 56 61 6c 75 65 73 28 29 20 63 61 6c 6c 20 63 6f  Values() call co
5c50: 6d 70 75 74 65 73 20 61 20 74 69 67 68 74 65 72  mputes a tighter
5c60: 20 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20   upper bound on 
5c70: 74 68 65 0a 20 20 2a 2a 20 73 74 61 63 6b 20 73  the.  ** stack s
5c80: 69 7a 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 41  ize..  **.  ** A
5c90: 6c 6c 6f 63 61 74 69 6f 6e 20 61 6c 6c 20 74 68  llocation all th
5ca0: 65 20 73 74 61 63 6b 20 73 70 61 63 65 20 77 65  e stack space we
5cb0: 20 77 69 6c 6c 20 65 76 65 72 20 6e 65 65 64 2e   will ever need.
5cc0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 61  .  */.  if( p->a
5cd0: 53 74 61 63 6b 3d 3d 30 20 29 7b 0a 20 20 20 20  Stack==0 ){.    
5ce0: 69 6e 74 20 6e 41 72 67 3b 20 20 20 20 20 20 20  int nArg;       
5cf0: 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e 75 6d 62 65  /* Maximum numbe
5d00: 72 20 6f 66 20 61 72 67 73 20 70 61 73 73 65 64  r of args passed
5d10: 20 74 6f 20 61 20 75 73 65 72 20 66 75 6e 63 74   to a user funct
5d20: 69 6f 6e 2e 20 2a 2f 0a 20 20 20 20 69 6e 74 20  ion. */.    int 
5d30: 6e 53 74 61 63 6b 3b 20 20 20 20 20 2f 2a 20 4d  nStack;     /* M
5d40: 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  aximum number of
5d50: 20 73 74 61 63 6b 20 65 6e 74 72 69 65 73 20 72   stack entries r
5d60: 65 71 75 69 72 65 64 20 2a 2f 0a 20 20 20 20 72  equired */.    r
5d70: 65 73 6f 6c 76 65 50 32 56 61 6c 75 65 73 28 70  esolveP2Values(p
5d80: 2c 20 26 6e 41 72 67 2c 20 26 6e 53 74 61 63 6b  , &nArg, &nStack
5d90: 29 3b 0a 20 20 20 20 72 65 73 69 7a 65 4f 70 41  );.    resizeOpA
5da0: 72 72 61 79 28 70 2c 20 70 2d 3e 6e 4f 70 29 3b  rray(p, p->nOp);
5db0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 56 61  .    assert( nVa
5dc0: 72 3e 3d 30 20 29 3b 0a 20 20 20 20 61 73 73 65  r>=0 );.    asse
5dd0: 72 74 28 20 6e 53 74 61 63 6b 3c 70 2d 3e 6e 4f  rt( nStack<p->nO
5de0: 70 20 29 3b 0a 20 20 20 20 69 66 28 20 69 73 45  p );.    if( isE
5df0: 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20 20 20 20  xplain ){.      
5e00: 6e 53 74 61 63 6b 20 3d 20 31 30 3b 0a 20 20 20  nStack = 10;.   
5e10: 20 7d 0a 20 20 20 20 70 2d 3e 61 53 74 61 63 6b   }.    p->aStack
5e20: 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28   = sqliteMalloc(
5e30: 0a 20 20 20 20 20 20 20 20 6e 53 74 61 63 6b 2a  .        nStack*
5e40: 73 69 7a 65 6f 66 28 70 2d 3e 61 53 74 61 63 6b  sizeof(p->aStack
5e50: 5b 30 5d 29 20 20 20 20 2f 2a 20 61 53 74 61 63  [0])    /* aStac
5e60: 6b 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 41 72  k */.      + nAr
5e70: 67 2a 73 69 7a 65 6f 66 28 4d 65 6d 2a 29 20 20  g*sizeof(Mem*)  
5e80: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61              /* a
5e90: 70 41 72 67 20 2a 2f 0a 20 20 20 20 20 20 2b 20  pArg */.      + 
5ea0: 6e 56 61 72 2a 73 69 7a 65 6f 66 28 4d 65 6d 29  nVar*sizeof(Mem)
5eb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5ec0: 2a 20 61 56 61 72 20 2a 2f 0a 20 20 20 20 20 20  * aVar */.      
5ed0: 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66 28 63 68  + nVar*sizeof(ch
5ee0: 61 72 2a 29 20 20 20 20 20 20 20 20 20 20 20 20  ar*)            
5ef0: 20 2f 2a 20 61 7a 56 61 72 20 2a 2f 0a 20 20 20   /* azVar */.   
5f00: 20 20 20 2b 20 6e 4d 65 6d 2a 73 69 7a 65 6f 66     + nMem*sizeof
5f10: 28 4d 65 6d 29 20 20 20 20 20 20 20 20 20 20 20  (Mem)           
5f20: 20 20 20 20 2f 2a 20 61 4d 65 6d 20 2a 2f 0a 20      /* aMem */. 
5f30: 20 20 20 20 20 2b 20 6e 43 75 72 73 6f 72 2a 73       + nCursor*s
5f40: 69 7a 65 6f 66 28 43 75 72 73 6f 72 2a 29 20 20  izeof(Cursor*)  
5f50: 20 20 20 20 20 20 2f 2a 20 61 70 43 73 72 20 2a        /* apCsr *
5f60: 2f 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66 28  /.    );.    if(
5f70: 20 21 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46   !sqlite3MallocF
5f80: 61 69 6c 65 64 28 29 20 29 7b 0a 20 20 20 20 20  ailed() ){.     
5f90: 20 70 2d 3e 61 4d 65 6d 20 3d 20 26 70 2d 3e 61   p->aMem = &p->a
5fa0: 53 74 61 63 6b 5b 6e 53 74 61 63 6b 5d 3b 0a 20  Stack[nStack];. 
5fb0: 20 20 20 20 20 70 2d 3e 6e 4d 65 6d 20 3d 20 6e       p->nMem = n
5fc0: 4d 65 6d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 56  Mem;.      p->aV
5fd0: 61 72 20 3d 20 26 70 2d 3e 61 4d 65 6d 5b 6e 4d  ar = &p->aMem[nM
5fe0: 65 6d 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 56  em];.      p->nV
5ff0: 61 72 20 3d 20 6e 56 61 72 3b 0a 20 20 20 20 20  ar = nVar;.     
6000: 20 70 2d 3e 6f 6b 56 61 72 20 3d 20 30 3b 0a 20   p->okVar = 0;. 
6010: 20 20 20 20 20 70 2d 3e 61 70 41 72 67 20 3d 20       p->apArg = 
6020: 28 4d 65 6d 2a 2a 29 26 70 2d 3e 61 56 61 72 5b  (Mem**)&p->aVar[
6030: 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20 70 2d 3e  nVar];.      p->
6040: 61 7a 56 61 72 20 3d 20 28 63 68 61 72 2a 2a 29  azVar = (char**)
6050: 26 70 2d 3e 61 70 41 72 67 5b 6e 41 72 67 5d 3b  &p->apArg[nArg];
6060: 0a 20 20 20 20 20 20 70 2d 3e 61 70 43 73 72 20  .      p->apCsr 
6070: 3d 20 28 43 75 72 73 6f 72 2a 2a 29 26 70 2d 3e  = (Cursor**)&p->
6080: 61 7a 56 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20  azVar[nVar];.   
6090: 20 20 20 70 2d 3e 6e 43 75 72 73 6f 72 20 3d 20     p->nCursor = 
60a0: 6e 43 75 72 73 6f 72 3b 0a 20 20 20 20 20 20 66  nCursor;.      f
60b0: 6f 72 28 6e 3d 30 3b 20 6e 3c 6e 56 61 72 3b 20  or(n=0; n<nVar; 
60c0: 6e 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 2d  n++){.        p-
60d0: 3e 61 56 61 72 5b 6e 5d 2e 66 6c 61 67 73 20 3d  >aVar[n].flags =
60e0: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20   MEM_Null;.     
60f0: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 66   }.    }.  }.  f
6100: 6f 72 28 6e 3d 30 3b 20 6e 3c 70 2d 3e 6e 4d 65  or(n=0; n<p->nMe
6110: 6d 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20 70 2d 3e  m; n++){.    p->
6120: 61 4d 65 6d 5b 6e 5d 2e 66 6c 61 67 73 20 3d 20  aMem[n].flags = 
6130: 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a 0a 20  MEM_Null;.  }.. 
6140: 20 70 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e 61   p->pTos = &p->a
6150: 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20 20 70 2d 3e  Stack[-1];.  p->
6160: 70 63 20 3d 20 2d 31 3b 0a 20 20 70 2d 3e 72 63  pc = -1;.  p->rc
6170: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
6180: 70 2d 3e 75 6e 69 71 75 65 43 6e 74 20 3d 20 30  p->uniqueCnt = 0
6190: 3b 0a 20 20 70 2d 3e 72 65 74 75 72 6e 44 65 70  ;.  p->returnDep
61a0: 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e 65 72 72  th = 0;.  p->err
61b0: 6f 72 41 63 74 69 6f 6e 20 3d 20 4f 45 5f 41 62  orAction = OE_Ab
61c0: 6f 72 74 3b 0a 20 20 70 2d 3e 70 6f 70 53 74 61  ort;.  p->popSta
61d0: 63 6b 20 3d 20 20 30 3b 0a 20 20 70 2d 3e 65 78  ck =  0;.  p->ex
61e0: 70 6c 61 69 6e 20 7c 3d 20 69 73 45 78 70 6c 61  plain |= isExpla
61f0: 69 6e 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d  in;.  p->magic =
6200: 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 3b   VDBE_MAGIC_RUN;
6210: 0a 20 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20  .  p->nChange = 
6220: 30 3b 0a 20 20 70 2d 3e 63 61 63 68 65 43 74 72  0;.  p->cacheCtr
6230: 20 3d 20 31 3b 0a 20 20 70 2d 3e 6d 69 6e 57 72   = 1;.  p->minWr
6240: 69 74 65 46 69 6c 65 46 6f 72 6d 61 74 20 3d 20  iteFileFormat = 
6250: 32 35 35 3b 0a 23 69 66 64 65 66 20 56 44 42 45  255;.#ifdef VDBE
6260: 5f 50 52 4f 46 49 4c 45 0a 20 20 7b 0a 20 20 20  _PROFILE.  {.   
6270: 20 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72 28   int i;.    for(
6280: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69  i=0; i<p->nOp; i
6290: 2b 2b 29 7b 0a 20 20 20 20 20 20 70 2d 3e 61 4f  ++){.      p->aO
62a0: 70 5b 69 5d 2e 63 6e 74 20 3d 20 30 3b 0a 20 20  p[i].cnt = 0;.  
62b0: 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79      p->aOp[i].cy
62c0: 63 6c 65 73 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  cles = 0;.    }.
62d0: 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a    }.#endif.}../*
62e0: 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75 72 73  .** Close a curs
62f0: 6f 72 20 61 6e 64 20 72 65 6c 65 61 73 65 20 61  or and release a
6300: 6c 6c 20 74 68 65 20 72 65 73 6f 75 72 63 65 73  ll the resources
6310: 20 74 68 61 74 20 63 75 72 73 6f 72 20 68 61 70   that cursor hap
6320: 70 65 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c 64 2e  pens.** to hold.
6330: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
6340: 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 56  VdbeFreeCursor(V
6350: 64 62 65 20 2a 70 2c 20 43 75 72 73 6f 72 20 2a  dbe *p, Cursor *
6360: 70 43 78 29 7b 0a 20 20 69 66 28 20 70 43 78 3d  pCx){.  if( pCx=
6370: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  =0 ){.    return
6380: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 78 2d  ;.  }.  if( pCx-
6390: 3e 70 43 75 72 73 6f 72 20 29 7b 0a 20 20 20 20  >pCursor ){.    
63a0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73  sqlite3BtreeClos
63b0: 65 43 75 72 73 6f 72 28 70 43 78 2d 3e 70 43 75  eCursor(pCx->pCu
63c0: 72 73 6f 72 29 3b 0a 20 20 7d 0a 20 20 69 66 28  rsor);.  }.  if(
63d0: 20 70 43 78 2d 3e 70 42 74 20 29 7b 0a 20 20 20   pCx->pBt ){.   
63e0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
63f0: 73 65 28 70 43 78 2d 3e 70 42 74 29 3b 0a 20 20  se(pCx->pBt);.  
6400: 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  }.#ifndef SQLITE
6410: 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42  _OMIT_VIRTUALTAB
6420: 4c 45 0a 20 20 69 66 28 20 70 43 78 2d 3e 70 56  LE.  if( pCx->pV
6430: 74 61 62 43 75 72 73 6f 72 20 29 7b 0a 20 20 20  tabCursor ){.   
6440: 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75   sqlite3_vtab_cu
6450: 72 73 6f 72 20 2a 70 56 74 61 62 43 75 72 73 6f  rsor *pVtabCurso
6460: 72 20 3d 20 70 43 78 2d 3e 70 56 74 61 62 43 75  r = pCx->pVtabCu
6470: 72 73 6f 72 3b 0a 20 20 20 20 63 6f 6e 73 74 20  rsor;.    const 
6480: 73 71 6c 69 74 65 33 5f 6d 6f 64 75 6c 65 20 2a  sqlite3_module *
6490: 70 4d 6f 64 75 6c 65 20 3d 20 70 43 78 2d 3e 70  pModule = pCx->p
64a0: 4d 6f 64 75 6c 65 3b 0a 20 20 20 20 70 2d 3e 69  Module;.    p->i
64b0: 6e 56 74 61 62 4d 65 74 68 6f 64 20 3d 20 31 3b  nVtabMethod = 1;
64c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 61 66 65  .    sqlite3Safe
64d0: 74 79 4f 66 66 28 70 2d 3e 64 62 29 3b 0a 20 20  tyOff(p->db);.  
64e0: 20 20 70 4d 6f 64 75 6c 65 2d 3e 78 43 6c 6f 73    pModule->xClos
64f0: 65 28 70 56 74 61 62 43 75 72 73 6f 72 29 3b 0a  e(pVtabCursor);.
6500: 20 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74      sqlite3Safet
6510: 79 4f 6e 28 70 2d 3e 64 62 29 3b 0a 20 20 20 20  yOn(p->db);.    
6520: 70 2d 3e 69 6e 56 74 61 62 4d 65 74 68 6f 64 20  p->inVtabMethod 
6530: 3d 20 30 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  = 0;.  }.#endif.
6540: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 43 78    sqliteFree(pCx
6550: 2d 3e 70 44 61 74 61 29 3b 0a 20 20 73 71 6c 69  ->pData);.  sqli
6560: 74 65 46 72 65 65 28 70 43 78 2d 3e 61 54 79 70  teFree(pCx->aTyp
6570: 65 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65  e);.  sqliteFree
6580: 28 70 43 78 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  (pCx);.}../*.** 
6590: 43 6c 6f 73 65 20 61 6c 6c 20 63 75 72 73 6f 72  Close all cursor
65a0: 73 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  s.*/.static void
65b0: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
65c0: 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74  (Vdbe *p){.  int
65d0: 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61 70 43   i;.  if( p->apC
65e0: 73 72 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a  sr==0 ) return;.
65f0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
6600: 6e 43 75 72 73 6f 72 3b 20 69 2b 2b 29 7b 0a 20  nCursor; i++){. 
6610: 20 20 20 69 66 28 20 21 70 2d 3e 69 6e 56 74 61     if( !p->inVta
6620: 62 4d 65 74 68 6f 64 20 7c 7c 20 28 70 2d 3e 61  bMethod || (p->a
6630: 70 43 73 72 5b 69 5d 20 26 26 20 21 70 2d 3e 61  pCsr[i] && !p->a
6640: 70 43 73 72 5b 69 5d 2d 3e 70 56 74 61 62 43 75  pCsr[i]->pVtabCu
6650: 72 73 6f 72 29 20 29 7b 0a 20 20 20 20 20 20 73  rsor) ){.      s
6660: 71 6c 69 74 65 33 56 64 62 65 46 72 65 65 43 75  qlite3VdbeFreeCu
6670: 72 73 6f 72 28 70 2c 20 70 2d 3e 61 70 43 73 72  rsor(p, p->apCsr
6680: 5b 69 5d 29 3b 0a 20 20 20 20 20 20 70 2d 3e 61  [i]);.      p->a
6690: 70 43 73 72 5b 69 5d 20 3d 20 30 3b 0a 20 20 20  pCsr[i] = 0;.   
66a0: 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   }.  }.}../*.** 
66b0: 43 6c 65 61 6e 20 75 70 20 74 68 65 20 56 4d 20  Clean up the VM 
66c0: 61 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e 2e  after execution.
66d0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
66e0: 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74  ine will automat
66f0: 69 63 61 6c 6c 79 20 63 6c 6f 73 65 20 61 6e 79  ically close any
6700: 20 63 75 72 73 6f 72 73 2c 20 6c 69 73 74 73 2c   cursors, lists,
6710: 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73 6f 72 74 65   and/or.** sorte
6720: 72 73 20 74 68 61 74 20 77 65 72 65 20 6c 65 66  rs that were lef
6730: 74 20 6f 70 65 6e 2e 20 20 49 74 20 61 6c 73 6f  t open.  It also
6740: 20 64 65 6c 65 74 65 73 20 74 68 65 20 76 61 6c   deletes the val
6750: 75 65 73 20 6f 66 0a 2a 2a 20 76 61 72 69 61 62  ues of.** variab
6760: 6c 65 73 20 69 6e 20 74 68 65 20 61 56 61 72 5b  les in the aVar[
6770: 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a 73 74 61 74  ] array..*/.stat
6780: 69 63 20 76 6f 69 64 20 43 6c 65 61 6e 75 70 28  ic void Cleanup(
6790: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  Vdbe *p){.  int 
67a0: 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61 53 74 61  i;.  if( p->aSta
67b0: 63 6b 20 29 7b 0a 20 20 20 20 72 65 6c 65 61 73  ck ){.    releas
67c0: 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 53 74  eMemArray(p->aSt
67d0: 61 63 6b 2c 20 31 20 2b 20 28 70 2d 3e 70 54 6f  ack, 1 + (p->pTo
67e0: 73 20 2d 20 70 2d 3e 61 53 74 61 63 6b 29 29 3b  s - p->aStack));
67f0: 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d 20 26  .    p->pTos = &
6800: 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20  p->aStack[-1];. 
6810: 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72   }.  closeAllCur
6820: 73 6f 72 73 28 70 29 3b 0a 20 20 72 65 6c 65 61  sors(p);.  relea
6830: 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 4d  seMemArray(p->aM
6840: 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29 3b 0a 20 20  em, p->nMem);.  
6850: 73 71 6c 69 74 65 33 56 64 62 65 46 69 66 6f 43  sqlite3VdbeFifoC
6860: 6c 65 61 72 28 26 70 2d 3e 73 46 69 66 6f 29 3b  lear(&p->sFifo);
6870: 0a 20 20 69 66 28 20 70 2d 3e 63 6f 6e 74 65 78  .  if( p->contex
6880: 74 53 74 61 63 6b 20 29 7b 0a 20 20 20 20 66 6f  tStack ){.    fo
6890: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 63 6f 6e 74  r(i=0; i<p->cont
68a0: 65 78 74 53 74 61 63 6b 54 6f 70 3b 20 69 2b 2b  extStackTop; i++
68b0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
68c0: 56 64 62 65 46 69 66 6f 43 6c 65 61 72 28 26 70  VdbeFifoClear(&p
68d0: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 5b 69  ->contextStack[i
68e0: 5d 2e 73 46 69 66 6f 29 3b 0a 20 20 20 20 7d 0a  ].sFifo);.    }.
68f0: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70      sqliteFree(p
6900: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 29 3b  ->contextStack);
6910: 0a 20 20 7d 0a 20 20 70 2d 3e 63 6f 6e 74 65 78  .  }.  p->contex
6920: 74 53 74 61 63 6b 20 3d 20 30 3b 0a 20 20 70 2d  tStack = 0;.  p-
6930: 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 44 65 70  >contextStackDep
6940: 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e  th = 0;.  p->con
6950: 74 65 78 74 53 74 61 63 6b 54 6f 70 20 3d 20 30  textStackTop = 0
6960: 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  ;.  sqliteFree(p
6970: 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 70 2d  ->zErrMsg);.  p-
6980: 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 7d 0a  >zErrMsg = 0;.}.
6990: 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 6e  ./*.** Set the n
69a0: 75 6d 62 65 72 20 6f 66 20 72 65 73 75 6c 74 20  umber of result 
69b0: 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20 77 69 6c  columns that wil
69c0: 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 79  l be returned by
69d0: 20 74 68 69 73 20 53 51 4c 0a 2a 2a 20 73 74 61   this SQL.** sta
69e0: 74 65 6d 65 6e 74 2e 20 54 68 69 73 20 69 73 20  tement. This is 
69f0: 6e 6f 77 20 73 65 74 20 61 74 20 63 6f 6d 70 69  now set at compi
6a00: 6c 65 20 74 69 6d 65 2c 20 72 61 74 68 65 72 20  le time, rather 
6a10: 74 68 61 6e 20 64 75 72 69 6e 67 0a 2a 2a 20 65  than during.** e
6a20: 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 65 20  xecution of the 
6a30: 76 64 62 65 20 70 72 6f 67 72 61 6d 20 73 6f 20  vdbe program so 
6a40: 74 68 61 74 20 73 71 6c 69 74 65 33 5f 63 6f 6c  that sqlite3_col
6a50: 75 6d 6e 5f 63 6f 75 6e 74 28 29 20 63 61 6e 0a  umn_count() can.
6a60: 2a 2a 20 62 65 20 63 61 6c 6c 65 64 20 6f 6e 20  ** be called on 
6a70: 61 6e 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  an SQL statement
6a80: 20 62 65 66 6f 72 65 20 73 71 6c 69 74 65 33 5f   before sqlite3_
6a90: 73 74 65 70 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20  step()..*/.void 
6aa0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75  sqlite3VdbeSetNu
6ab0: 6d 43 6f 6c 73 28 56 64 62 65 20 2a 70 2c 20 69  mCols(Vdbe *p, i
6ac0: 6e 74 20 6e 52 65 73 43 6f 6c 75 6d 6e 29 7b 0a  nt nResColumn){.
6ad0: 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b    Mem *pColName;
6ae0: 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 72 65 6c 65  .  int n;.  rele
6af0: 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61  aseMemArray(p->a
6b00: 43 6f 6c 4e 61 6d 65 2c 20 70 2d 3e 6e 52 65 73  ColName, p->nRes
6b10: 43 6f 6c 75 6d 6e 2a 43 4f 4c 4e 41 4d 45 5f 4e  Column*COLNAME_N
6b20: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
6b30: 70 2d 3e 61 43 6f 6c 4e 61 6d 65 29 3b 0a 20 20  p->aColName);.  
6b40: 6e 20 3d 20 6e 52 65 73 43 6f 6c 75 6d 6e 2a 43  n = nResColumn*C
6b50: 4f 4c 4e 41 4d 45 5f 4e 3b 0a 20 20 70 2d 3e 6e  OLNAME_N;.  p->n
6b60: 52 65 73 43 6f 6c 75 6d 6e 20 3d 20 6e 52 65 73  ResColumn = nRes
6b70: 43 6f 6c 75 6d 6e 3b 0a 20 20 70 2d 3e 61 43 6f  Column;.  p->aCo
6b80: 6c 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e 61 6d 65  lName = pColName
6b90: 20 3d 20 28 4d 65 6d 2a 29 73 71 6c 69 74 65 4d   = (Mem*)sqliteM
6ba0: 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66 28 4d 65  alloc( sizeof(Me
6bb0: 6d 29 2a 6e 20 29 3b 0a 20 20 69 66 28 20 70 2d  m)*n );.  if( p-
6bc0: 3e 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20 29 20 72  >aColName==0 ) r
6bd0: 65 74 75 72 6e 3b 0a 20 20 77 68 69 6c 65 28 20  eturn;.  while( 
6be0: 6e 2d 2d 20 3e 20 30 20 29 7b 0a 20 20 20 20 28  n-- > 0 ){.    (
6bf0: 70 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e 66 6c 61  pColName++)->fla
6c00: 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20  gs = MEM_Null;. 
6c10: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20   }.}../*.** Set 
6c20: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
6c30: 69 64 78 27 74 68 20 63 6f 6c 75 6d 6e 20 74 6f  idx'th column to
6c40: 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20   be returned by 
6c50: 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  the SQL statemen
6c60: 74 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d 75 73 74  t..** zName must
6c70: 20 62 65 20 61 20 70 6f 69 6e 74 65 72 20 74 6f   be a pointer to
6c80: 20 61 20 6e 75 6c 20 74 65 72 6d 69 6e 61 74 65   a nul terminate
6c90: 64 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20  d string..**.** 
6ca0: 54 68 69 73 20 63 61 6c 6c 20 6d 75 73 74 20 62  This call must b
6cb0: 65 20 6d 61 64 65 20 61 66 74 65 72 20 61 20 63  e made after a c
6cc0: 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 56 64  all to sqlite3Vd
6cd0: 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 29 2e 0a  beSetNumCols()..
6ce0: 2a 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50 33 5f 53  **.** If N==P3_S
6cf0: 54 41 54 49 43 20 20 69 74 20 6d 65 61 6e 73 20  TATIC  it means 
6d00: 74 68 61 74 20 7a 4e 61 6d 65 20 69 73 20 61 20  that zName is a 
6d10: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 63 6f 6e  pointer to a con
6d20: 73 74 61 6e 74 20 73 74 61 74 69 63 0a 2a 2a 20  stant static.** 
6d30: 73 74 72 69 6e 67 20 61 6e 64 20 77 65 20 63 61  string and we ca
6d40: 6e 20 6a 75 73 74 20 63 6f 70 79 20 74 68 65 20  n just copy the 
6d50: 70 6f 69 6e 74 65 72 2e 20 49 66 20 69 74 20 69  pointer. If it i
6d60: 73 20 50 33 5f 44 59 4e 41 4d 49 43 2c 20 74 68  s P3_DYNAMIC, th
6d70: 65 6e 20 0a 2a 2a 20 74 68 65 20 73 74 72 69 6e  en .** the strin
6d80: 67 20 69 73 20 66 72 65 65 64 20 75 73 69 6e 67  g is freed using
6d90: 20 73 71 6c 69 74 65 46 72 65 65 28 29 20 77 68   sqliteFree() wh
6da0: 65 6e 20 74 68 65 20 76 64 62 65 20 69 73 20 66  en the vdbe is f
6db0: 69 6e 69 73 68 65 64 20 77 69 74 68 0a 2a 2a 20  inished with.** 
6dc0: 69 74 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 4e  it. Otherwise, N
6dd0: 20 62 79 74 65 73 20 6f 66 20 7a 4e 61 6d 65 20   bytes of zName 
6de0: 61 72 65 20 63 6f 70 69 65 64 2e 0a 2a 2f 0a 69  are copied..*/.i
6df0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  nt sqlite3VdbeSe
6e00: 74 43 6f 6c 4e 61 6d 65 28 56 64 62 65 20 2a 70  tColName(Vdbe *p
6e10: 2c 20 69 6e 74 20 69 64 78 2c 20 69 6e 74 20 76  , int idx, int v
6e20: 61 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  ar, const char *
6e30: 7a 4e 61 6d 65 2c 20 69 6e 74 20 4e 29 7b 0a 20  zName, int N){. 
6e40: 20 69 6e 74 20 72 63 3b 0a 20 20 4d 65 6d 20 2a   int rc;.  Mem *
6e50: 70 43 6f 6c 4e 61 6d 65 3b 0a 20 20 61 73 73 65  pColName;.  asse
6e60: 72 74 28 20 69 64 78 3c 70 2d 3e 6e 52 65 73 43  rt( idx<p->nResC
6e70: 6f 6c 75 6d 6e 20 29 3b 0a 20 20 61 73 73 65 72  olumn );.  asser
6e80: 74 28 20 76 61 72 3c 43 4f 4c 4e 41 4d 45 5f 4e  t( var<COLNAME_N
6e90: 20 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65   );.  if( sqlite
6ea0: 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20  3MallocFailed() 
6eb0: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  ) return SQLITE_
6ec0: 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65 72 74 28  NOMEM;.  assert(
6ed0: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21 3d 30 20   p->aColName!=0 
6ee0: 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20  );.  pColName = 
6ef0: 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 69 64  &(p->aColName[id
6f00: 78 2b 76 61 72 2a 70 2d 3e 6e 52 65 73 43 6f 6c  x+var*p->nResCol
6f10: 75 6d 6e 5d 29 3b 0a 20 20 69 66 28 20 4e 3d 3d  umn]);.  if( N==
6f20: 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e 3d  P3_DYNAMIC || N=
6f30: 3d 50 33 5f 53 54 41 54 49 43 20 29 7b 0a 20 20  =P3_STATIC ){.  
6f40: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64    rc = sqlite3Vd
6f50: 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f 6c  beMemSetStr(pCol
6f60: 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c  Name, zName, -1,
6f70: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51   SQLITE_UTF8, SQ
6f80: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
6f90: 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20  }else{.    rc = 
6fa0: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65  sqlite3VdbeMemSe
6fb0: 74 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20 7a  tStr(pColName, z
6fc0: 4e 61 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45 5f  Name, N, SQLITE_
6fd0: 55 54 46 38 2c 53 51 4c 49 54 45 5f 54 52 41 4e  UTF8,SQLITE_TRAN
6fe0: 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69 66  SIENT);.  }.  if
6ff0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
7000: 26 26 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49 43  && N==P3_DYNAMIC
7010: 20 29 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65   ){.    pColName
7020: 2d 3e 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c 4e  ->flags = (pColN
7030: 61 6d 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45 4d  ame->flags&(~MEM
7040: 5f 53 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44 79  _Static))|MEM_Dy
7050: 6e 3b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d  n;.    pColName-
7060: 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a 20  >xDel = 0;.  }. 
7070: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f   return rc;.}../
7080: 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6f 72 20 77  *.** A read or w
7090: 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e  rite transaction
70a0: 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20   may or may not 
70b0: 62 65 20 61 63 74 69 76 65 20 6f 6e 20 64 61 74  be active on dat
70c0: 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20  abase handle.** 
70d0: 64 62 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63  db. If a transac
70e0: 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2c 20  tion is active, 
70f0: 63 6f 6d 6d 69 74 20 69 74 2e 20 49 66 20 74 68  commit it. If th
7100: 65 72 65 20 69 73 20 61 0a 2a 2a 20 77 72 69 74  ere is a.** writ
7110: 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 70  e-transaction sp
7120: 61 6e 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e  anning more than
7130: 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66 69   one database fi
7140: 6c 65 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65  le, this routine
7150: 0a 2a 2a 20 74 61 6b 65 73 20 63 61 72 65 20 6f  .** takes care o
7160: 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  f the master jou
7170: 72 6e 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a 2a  rnal trickery..*
7180: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64 62  /.static int vdb
7190: 65 43 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20  eCommit(sqlite3 
71a0: 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  *db){.  int i;. 
71b0: 20 69 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30 3b   int nTrans = 0;
71c0: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64    /* Number of d
71d0: 61 74 61 62 61 73 65 73 20 77 69 74 68 20 61 6e  atabases with an
71e0: 20 61 63 74 69 76 65 20 77 72 69 74 65 2d 74 72   active write-tr
71f0: 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20 69  ansaction */.  i
7200: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
7210: 4b 3b 0a 20 20 69 6e 74 20 6e 65 65 64 58 63 6f  K;.  int needXco
7220: 6d 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20  mmit = 0;..  /* 
7230: 42 65 66 6f 72 65 20 64 6f 69 6e 67 20 61 6e 79  Before doing any
7240: 74 68 69 6e 67 20 65 6c 73 65 2c 20 63 61 6c 6c  thing else, call
7250: 20 74 68 65 20 78 53 79 6e 63 28 29 20 63 61 6c   the xSync() cal
7260: 6c 62 61 63 6b 20 66 6f 72 20 61 6e 79 0a 20 20  lback for any.  
7270: 2a 2a 20 76 69 72 74 75 61 6c 20 6d 6f 64 75 6c  ** virtual modul
7280: 65 20 74 61 62 6c 65 73 20 77 72 69 74 74 65 6e  e tables written
7290: 20 69 6e 20 74 68 69 73 20 74 72 61 6e 73 61 63   in this transac
72a0: 74 69 6f 6e 2e 20 54 68 69 73 20 68 61 73 20 74  tion. This has t
72b0: 6f 0a 20 20 2a 2a 20 62 65 20 64 6f 6e 65 20 62  o.  ** be done b
72c0: 65 66 6f 72 65 20 64 65 74 65 72 6d 69 6e 69 6e  efore determinin
72d0: 67 20 77 68 65 74 68 65 72 20 61 20 6d 61 73 74  g whether a mast
72e0: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  er journal file 
72f0: 69 73 20 0a 20 20 2a 2a 20 72 65 71 75 69 72 65  is .  ** require
7300: 64 2c 20 61 73 20 61 6e 20 78 53 79 6e 63 28 29  d, as an xSync()
7310: 20 63 61 6c 6c 62 61 63 6b 20 6d 61 79 20 61 64   callback may ad
7320: 64 20 61 6e 20 61 74 74 61 63 68 65 64 20 64 61  d an attached da
7330: 74 61 62 61 73 65 0a 20 20 2a 2a 20 74 6f 20 74  tabase.  ** to t
7340: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a  he transaction..
7350: 20 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69    */.  rc = sqli
7360: 74 65 33 56 74 61 62 53 79 6e 63 28 64 62 2c 20  te3VtabSync(db, 
7370: 72 63 29 3b 0a 20 20 69 66 28 20 72 63 21 3d 53  rc);.  if( rc!=S
7380: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
7390: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 0a  return rc;.  }..
73a0: 20 20 2f 2a 20 54 68 69 73 20 6c 6f 6f 70 20 64    /* This loop d
73b0: 65 74 65 72 6d 69 6e 65 73 20 28 61 29 20 69 66  etermines (a) if
73c0: 20 74 68 65 20 63 6f 6d 6d 69 74 20 68 6f 6f 6b   the commit hook
73d0: 20 73 68 6f 75 6c 64 20 62 65 20 69 6e 76 6f 6b   should be invok
73e0: 65 64 20 61 6e 64 0a 20 20 2a 2a 20 28 62 29 20  ed and.  ** (b) 
73f0: 68 6f 77 20 6d 61 6e 79 20 64 61 74 61 62 61 73  how many databas
7400: 65 20 66 69 6c 65 73 20 68 61 76 65 20 6f 70 65  e files have ope
7410: 6e 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74  n write transact
7420: 69 6f 6e 73 2c 20 6e 6f 74 20 0a 20 20 2a 2a 20  ions, not .  ** 
7430: 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 20 74 65  including the te
7440: 6d 70 20 64 61 74 61 62 61 73 65 2e 20 28 62 29  mp database. (b)
7450: 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 20 62 65   is important be
7460: 63 61 75 73 65 20 69 66 20 6d 6f 72 65 20 74 68  cause if more th
7470: 61 6e 20 0a 20 20 2a 2a 20 6f 6e 65 20 64 61 74  an .  ** one dat
7480: 61 62 61 73 65 20 66 69 6c 65 20 68 61 73 20 61  abase file has a
7490: 6e 20 6f 70 65 6e 20 77 72 69 74 65 20 74 72 61  n open write tra
74a0: 6e 73 61 63 74 69 6f 6e 2c 20 61 20 6d 61 73 74  nsaction, a mast
74b0: 65 72 20 6a 6f 75 72 6e 61 6c 0a 20 20 2a 2a 20  er journal.  ** 
74c0: 66 69 6c 65 20 69 73 20 72 65 71 75 69 72 65 64  file is required
74d0: 20 66 6f 72 20 61 6e 20 61 74 6f 6d 69 63 20 63   for an atomic c
74e0: 6f 6d 6d 69 74 2e 0a 20 20 2a 2f 20 0a 20 20 66  ommit..  */ .  f
74f0: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44  or(i=0; i<db->nD
7500: 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 42 74  b; i++){ .    Bt
7510: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
7520: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69  Db[i].pBt;.    i
7530: 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65  f( pBt && sqlite
7540: 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28  3BtreeIsInTrans(
7550: 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 6e 65  pBt) ){.      ne
7560: 65 64 58 63 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20  edXcommit = 1;. 
7570: 20 20 20 20 20 69 66 28 20 69 21 3d 31 20 29 20       if( i!=1 ) 
7580: 6e 54 72 61 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a  nTrans++;.    }.
7590: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65    }..  /* If the
75a0: 72 65 20 61 72 65 20 61 6e 79 20 77 72 69 74 65  re are any write
75b0: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 74  -transactions at
75c0: 20 61 6c 6c 2c 20 69 6e 76 6f 6b 65 20 74 68 65   all, invoke the
75d0: 20 63 6f 6d 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a   commit hook */.
75e0: 20 20 69 66 28 20 6e 65 65 64 58 63 6f 6d 6d 69    if( needXcommi
75f0: 74 20 26 26 20 64 62 2d 3e 78 43 6f 6d 6d 69 74  t && db->xCommit
7600: 43 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20  Callback ){.    
7610: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66  sqlite3SafetyOff
7620: 28 64 62 29 3b 0a 20 20 20 20 72 63 20 3d 20 64  (db);.    rc = d
7630: 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61  b->xCommitCallba
7640: 63 6b 28 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72  ck(db->pCommitAr
7650: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53  g);.    sqlite3S
7660: 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20  afetyOn(db);.   
7670: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20   if( rc ){.     
7680: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43   return SQLITE_C
7690: 4f 4e 53 54 52 41 49 4e 54 3b 0a 20 20 20 20 7d  ONSTRAINT;.    }
76a0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 73  .  }..  /* The s
76b0: 69 6d 70 6c 65 20 63 61 73 65 20 2d 20 6e 6f 20  imple case - no 
76c0: 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 64 61  more than one da
76d0: 74 61 62 61 73 65 20 66 69 6c 65 20 28 6e 6f 74  tabase file (not
76e0: 20 63 6f 75 6e 74 69 6e 67 20 74 68 65 0a 20 20   counting the.  
76f0: 2a 2a 20 54 45 4d 50 20 64 61 74 61 62 61 73 65  ** TEMP database
7700: 29 20 68 61 73 20 61 20 74 72 61 6e 73 61 63 74  ) has a transact
7710: 69 6f 6e 20 61 63 74 69 76 65 2e 20 20 20 54 68  ion active.   Th
7720: 65 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 66  ere is no need f
7730: 6f 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61 73 74  or the.  ** mast
7740: 65 72 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2a  er-journal..  **
7750: 0a 20 20 2a 2a 20 49 66 20 74 68 65 20 72 65 74  .  ** If the ret
7760: 75 72 6e 20 76 61 6c 75 65 20 6f 66 20 73 71 6c  urn value of sql
7770: 69 74 65 33 42 74 72 65 65 47 65 74 46 69 6c 65  ite3BtreeGetFile
7780: 6e 61 6d 65 28 29 20 69 73 20 61 20 7a 65 72 6f  name() is a zero
7790: 20 6c 65 6e 67 74 68 0a 20 20 2a 2a 20 73 74 72   length.  ** str
77a0: 69 6e 67 2c 20 69 74 20 6d 65 61 6e 73 20 74 68  ing, it means th
77b0: 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20  e main database 
77c0: 69 73 20 3a 6d 65 6d 6f 72 79 3a 2e 20 20 49 6e  is :memory:.  In
77d0: 20 74 68 61 74 20 63 61 73 65 20 77 65 20 64 6f   that case we do
77e0: 0a 20 20 2a 2a 20 6e 6f 74 20 73 75 70 70 6f 72  .  ** not suppor
77f0: 74 20 61 74 6f 6d 69 63 20 6d 75 6c 74 69 2d 66  t atomic multi-f
7800: 69 6c 65 20 63 6f 6d 6d 69 74 73 2c 20 73 6f 20  ile commits, so 
7810: 75 73 65 20 74 68 65 20 73 69 6d 70 6c 65 20 63  use the simple c
7820: 61 73 65 20 74 68 65 6e 0a 20 20 2a 2a 20 74 6f  ase then.  ** to
7830: 6f 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 30 3d  o..  */.  if( 0=
7840: 3d 73 74 72 6c 65 6e 28 73 71 6c 69 74 65 33 42  =strlen(sqlite3B
7850: 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28  treeGetFilename(
7860: 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 29  db->aDb[0].pBt))
7870: 20 7c 7c 20 6e 54 72 61 6e 73 3c 3d 31 20 29 7b   || nTrans<=1 ){
7880: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 72 63  .    for(i=0; rc
7890: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69  ==SQLITE_OK && i
78a0: 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20  <db->nDb; i++){ 
78b0: 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42  .      Btree *pB
78c0: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70  t = db->aDb[i].p
78d0: 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42  Bt;.      if( pB
78e0: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20  t ){.        rc 
78f0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f  = sqlite3BtreeCo
7900: 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 70 42 74  mmitPhaseOne(pBt
7910: 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  , 0);.      }.  
7920: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f 20 74    }..    /* Do t
7930: 68 65 20 63 6f 6d 6d 69 74 20 6f 6e 6c 79 20 69  he commit only i
7940: 66 20 61 6c 6c 20 64 61 74 61 62 61 73 65 73 20  f all databases 
7950: 73 75 63 63 65 73 73 66 75 6c 6c 79 20 63 6f 6d  successfully com
7960: 70 6c 65 74 65 20 70 68 61 73 65 20 31 2e 20 0a  plete phase 1. .
7970: 20 20 20 20 2a 2a 20 49 66 20 6f 6e 65 20 6f 66      ** If one of
7980: 20 74 68 65 20 42 74 72 65 65 43 6f 6d 6d 69 74   the BtreeCommit
7990: 50 68 61 73 65 4f 6e 65 28 29 20 63 61 6c 6c 73  PhaseOne() calls
79a0: 20 66 61 69 6c 73 2c 20 74 68 69 73 20 69 6e 64   fails, this ind
79b0: 69 63 61 74 65 73 20 61 6e 0a 20 20 20 20 2a 2a  icates an.    **
79c0: 20 49 4f 20 65 72 72 6f 72 20 77 68 69 6c 65 20   IO error while 
79d0: 64 65 6c 65 74 69 6e 67 20 6f 72 20 74 72 75 6e  deleting or trun
79e0: 63 61 74 69 6e 67 20 61 20 6a 6f 75 72 6e 61 6c  cating a journal
79f0: 20 66 69 6c 65 2e 20 49 74 20 69 73 20 75 6e 6c   file. It is unl
7a00: 69 6b 65 6c 79 2c 0a 20 20 20 20 2a 2a 20 62 75  ikely,.    ** bu
7a10: 74 20 63 6f 75 6c 64 20 68 61 70 70 65 6e 2e 20  t could happen. 
7a20: 49 6e 20 74 68 69 73 20 63 61 73 65 20 61 62 61  In this case aba
7a30: 6e 64 6f 6e 20 70 72 6f 63 65 73 73 69 6e 67 20  ndon processing 
7a40: 61 6e 64 20 72 65 74 75 72 6e 20 74 68 65 20 65  and return the e
7a50: 72 72 6f 72 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  rror..    */.   
7a60: 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51   for(i=0; rc==SQ
7a70: 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d  LITE_OK && i<db-
7a80: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nDb; i++){.    
7a90: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
7aa0: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
7ab0: 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a       if( pBt ){.
7ac0: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
7ad0: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50  ite3BtreeCommitP
7ae0: 68 61 73 65 54 77 6f 28 70 42 74 29 3b 0a 20 20  haseTwo(pBt);.  
7af0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
7b00: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
7b10: 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  K ){.      sqlit
7b20: 65 33 56 74 61 62 43 6f 6d 6d 69 74 28 64 62 29  e3VtabCommit(db)
7b30: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
7b40: 2a 20 54 68 65 20 63 6f 6d 70 6c 65 78 20 63 61  * The complex ca
7b50: 73 65 20 2d 20 54 68 65 72 65 20 69 73 20 61 20  se - There is a 
7b60: 6d 75 6c 74 69 2d 66 69 6c 65 20 77 72 69 74 65  multi-file write
7b70: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74  -transaction act
7b80: 69 76 65 2e 0a 20 20 2a 2a 20 54 68 69 73 20 72  ive..  ** This r
7b90: 65 71 75 69 72 65 73 20 61 20 6d 61 73 74 65 72  equires a master
7ba0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f   journal file to
7bb0: 20 65 6e 73 75 72 65 20 74 68 65 20 74 72 61 6e   ensure the tran
7bc0: 73 61 63 74 69 6f 6e 20 69 73 0a 20 20 2a 2a 20  saction is.  ** 
7bd0: 63 6f 6d 6d 69 74 74 65 64 20 61 74 6f 6d 69 63  committed atomic
7be0: 6c 79 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66  ly..  */.#ifndef
7bf0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53   SQLITE_OMIT_DIS
7c00: 4b 49 4f 0a 20 20 65 6c 73 65 7b 0a 20 20 20 20  KIO.  else{.    
7c10: 69 6e 74 20 6e 65 65 64 53 79 6e 63 20 3d 20 30  int needSync = 0
7c20: 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4d 61 73  ;.    char *zMas
7c30: 74 65 72 20 3d 20 30 3b 20 20 20 2f 2a 20 46 69  ter = 0;   /* Fi
7c40: 6c 65 2d 6e 61 6d 65 20 66 6f 72 20 74 68 65 20  le-name for the 
7c50: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 2a  master journal *
7c60: 2f 0a 20 20 20 20 63 68 61 72 20 63 6f 6e 73 74  /.    char const
7c70: 20 2a 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71   *zMainFile = sq
7c80: 6c 69 74 65 33 42 74 72 65 65 47 65 74 46 69 6c  lite3BtreeGetFil
7c90: 65 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d  ename(db->aDb[0]
7ca0: 2e 70 42 74 29 3b 0a 20 20 20 20 4f 73 46 69 6c  .pBt);.    OsFil
7cb0: 65 20 2a 6d 61 73 74 65 72 20 3d 20 30 3b 0a 0a  e *master = 0;..
7cc0: 20 20 20 20 2f 2a 20 53 65 6c 65 63 74 20 61 20      /* Select a 
7cd0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
7ce0: 69 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20  ile name */.    
7cf0: 64 6f 20 7b 0a 20 20 20 20 20 20 75 33 32 20 72  do {.      u32 r
7d00: 61 6e 64 6f 6d 3b 0a 20 20 20 20 20 20 73 71 6c  andom;.      sql
7d10: 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29  iteFree(zMaster)
7d20: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52  ;.      sqlite3R
7d30: 61 6e 64 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66  andomness(sizeof
7d40: 28 72 61 6e 64 6f 6d 29 2c 20 26 72 61 6e 64 6f  (random), &rando
7d50: 6d 29 3b 0a 20 20 20 20 20 20 7a 4d 61 73 74 65  m);.      zMaste
7d60: 72 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e  r = sqlite3MPrin
7d70: 74 66 28 22 25 73 2d 6d 6a 25 30 38 58 22 2c 20  tf("%s-mj%08X", 
7d80: 7a 4d 61 69 6e 46 69 6c 65 2c 20 72 61 6e 64 6f  zMainFile, rando
7d90: 6d 26 30 78 37 66 66 66 66 66 66 66 29 3b 0a 20  m&0x7fffffff);. 
7da0: 20 20 20 20 20 69 66 28 20 21 7a 4d 61 73 74 65       if( !zMaste
7db0: 72 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74  r ){.        ret
7dc0: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
7dd0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 77  ;.      }.    }w
7de0: 68 69 6c 65 28 20 73 71 6c 69 74 65 33 4f 73 46  hile( sqlite3OsF
7df0: 69 6c 65 45 78 69 73 74 73 28 7a 4d 61 73 74 65  ileExists(zMaste
7e00: 72 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 70  r) );..    /* Op
7e10: 65 6e 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  en the master jo
7e20: 75 72 6e 61 6c 2e 20 2a 2f 0a 20 20 20 20 72 63  urnal. */.    rc
7e30: 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e   = sqlite3OsOpen
7e40: 45 78 63 6c 75 73 69 76 65 28 7a 4d 61 73 74 65  Exclusive(zMaste
7e50: 72 2c 20 26 6d 61 73 74 65 72 2c 20 30 29 3b 0a  r, &master, 0);.
7e60: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
7e70: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73  TE_OK ){.      s
7e80: 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65  qliteFree(zMaste
7e90: 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  r);.      return
7ea0: 20 72 63 3b 0a 20 20 20 20 7d 0a 20 0a 20 20 20   rc;.    }. .   
7eb0: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 61   /* Write the na
7ec0: 6d 65 20 6f 66 20 65 61 63 68 20 64 61 74 61 62  me of each datab
7ed0: 61 73 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20  ase file in the 
7ee0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 6f  transaction into
7ef0: 20 74 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20   the new.    ** 
7f00: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
7f10: 69 6c 65 2e 20 49 66 20 61 6e 20 65 72 72 6f 72  ile. If an error
7f20: 20 6f 63 63 75 72 73 20 61 74 20 74 68 69 73 20   occurs at this 
7f30: 70 6f 69 6e 74 20 63 6c 6f 73 65 0a 20 20 20 20  point close.    
7f40: 2a 2a 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68  ** and delete th
7f50: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
7f60: 20 66 69 6c 65 2e 20 41 6c 6c 20 74 68 65 20 69   file. All the i
7f70: 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61  ndividual journa
7f80: 6c 20 66 69 6c 65 73 0a 20 20 20 20 2a 2a 20 73  l files.    ** s
7f90: 74 69 6c 6c 20 68 61 76 65 20 27 6e 75 6c 6c 27  till have 'null'
7fa0: 20 61 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a   as the master j
7fb0: 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 2c 20  ournal pointer, 
7fc0: 73 6f 20 74 68 65 79 20 77 69 6c 6c 20 72 6f 6c  so they will rol
7fd0: 6c 0a 20 20 20 20 2a 2a 20 62 61 63 6b 20 69 6e  l.    ** back in
7fe0: 64 65 70 65 6e 64 65 6e 74 6c 79 20 69 66 20 61  dependently if a
7ff0: 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e   failure occurs.
8000: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28  .    */.    for(
8010: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
8020: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72  i++){ .      Btr
8030: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
8040: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
8050: 69 66 28 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69  if( i==1 ) conti
8060: 6e 75 65 3b 20 20 20 2f 2a 20 49 67 6e 6f 72 65  nue;   /* Ignore
8070: 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62 61   the TEMP databa
8080: 73 65 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20  se */.      if( 
8090: 70 42 74 20 26 26 20 73 71 6c 69 74 65 33 42 74  pBt && sqlite3Bt
80a0: 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74  reeIsInTrans(pBt
80b0: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 63 68 61  ) ){.        cha
80c0: 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 20 3d  r const *zFile =
80d0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74   sqlite3BtreeGet
80e0: 4a 6f 75 72 6e 61 6c 6e 61 6d 65 28 70 42 74 29  Journalname(pBt)
80f0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a 46  ;.        if( zF
8100: 69 6c 65 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e 74  ile[0]==0 ) cont
8110: 69 6e 75 65 3b 20 20 2f 2a 20 49 67 6e 6f 72 65  inue;  /* Ignore
8120: 20 3a 6d 65 6d 6f 72 79 3a 20 64 61 74 61 62 61   :memory: databa
8130: 73 65 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 69  ses */.        i
8140: 66 28 20 21 6e 65 65 64 53 79 6e 63 20 26 26 20  f( !needSync && 
8150: 21 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e  !sqlite3BtreeSyn
8160: 63 44 69 73 61 62 6c 65 64 28 70 42 74 29 20 29  cDisabled(pBt) )
8170: 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 65 64  {.          need
8180: 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20  Sync = 1;.      
8190: 20 20 7d 0a 20 20 20 20 20 20 20 20 72 63 20 3d    }.        rc =
81a0: 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28   sqlite3OsWrite(
81b0: 6d 61 73 74 65 72 2c 20 7a 46 69 6c 65 2c 20 73  master, zFile, s
81c0: 74 72 6c 65 6e 28 7a 46 69 6c 65 29 2b 31 29 3b  trlen(zFile)+1);
81d0: 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21  .        if( rc!
81e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
81f0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f          sqlite3O
8200: 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b  sClose(&master);
8210: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  .          sqlit
8220: 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74  e3OsDelete(zMast
8230: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73  er);.          s
8240: 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65  qliteFree(zMaste
8250: 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65  r);.          re
8260: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20  turn rc;.       
8270: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d   }.      }.    }
8280: 0a 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 74  ...    /* Sync t
8290: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
82a0: 6c 20 66 69 6c 65 2e 20 42 65 66 6f 72 65 20 64  l file. Before d
82b0: 6f 69 6e 67 20 74 68 69 73 2c 20 6f 70 65 6e 20  oing this, open 
82c0: 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a 20 20  the directory.  
82d0: 20 20 2a 2a 20 74 68 65 20 6d 61 73 74 65 72 20    ** the master 
82e0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20  journal file is 
82f0: 73 74 6f 72 65 20 69 6e 20 73 6f 20 74 68 61 74  store in so that
8300: 20 69 74 20 67 65 74 73 20 73 79 6e 63 65 64 20   it gets synced 
8310: 74 6f 6f 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  too..    */.    
8320: 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69  zMainFile = sqli
8330: 74 65 33 42 74 72 65 65 47 65 74 44 69 72 6e 61  te3BtreeGetDirna
8340: 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42  me(db->aDb[0].pB
8350: 74 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  t);.    rc = sql
8360: 69 74 65 33 4f 73 4f 70 65 6e 44 69 72 65 63 74  ite3OsOpenDirect
8370: 6f 72 79 28 6d 61 73 74 65 72 2c 20 7a 4d 61 69  ory(master, zMai
8380: 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69 66 28 20  nFile);.    if( 
8390: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c  rc!=SQLITE_OK ||
83a0: 0a 20 20 20 20 20 20 20 20 20 20 28 6e 65 65 64  .          (need
83b0: 53 79 6e 63 20 26 26 20 28 72 63 3d 73 71 6c 69  Sync && (rc=sqli
83c0: 74 65 33 4f 73 53 79 6e 63 28 6d 61 73 74 65 72  te3OsSync(master
83d0: 2c 30 29 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 29  ,0))!=SQLITE_OK)
83e0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
83f0: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
8400: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
8410: 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72  OsDelete(zMaster
8420: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  );.      sqliteF
8430: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
8440: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
8450: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 53 79 6e     }..    /* Syn
8460: 63 20 61 6c 6c 20 74 68 65 20 64 62 20 66 69 6c  c all the db fil
8470: 65 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 74  es involved in t
8480: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20  he transaction. 
8490: 54 68 65 20 73 61 6d 65 20 63 61 6c 6c 0a 20 20  The same call.  
84a0: 20 20 2a 2a 20 73 65 74 73 20 74 68 65 20 6d 61    ** sets the ma
84b0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69  ster journal poi
84c0: 6e 74 65 72 20 69 6e 20 65 61 63 68 20 69 6e 64  nter in each ind
84d0: 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 2e  ividual journal.
84e0: 20 49 66 0a 20 20 20 20 2a 2a 20 61 6e 20 65 72   If.    ** an er
84f0: 72 6f 72 20 6f 63 63 75 72 73 20 68 65 72 65 2c  ror occurs here,
8500: 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74   do not delete t
8510: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
8520: 6c 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20  l file..    **. 
8530: 20 20 20 2a 2a 20 49 66 20 74 68 65 20 65 72 72     ** If the err
8540: 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67  or occurs during
8550: 20 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20   the first call 
8560: 74 6f 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65  to.    ** sqlite
8570: 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73  3BtreeCommitPhas
8580: 65 4f 6e 65 28 29 2c 20 74 68 65 6e 20 74 68 65  eOne(), then the
8590: 72 65 20 69 73 20 61 20 63 68 61 6e 63 65 20 74  re is a chance t
85a0: 68 61 74 20 74 68 65 0a 20 20 20 20 2a 2a 20 6d  hat the.    ** m
85b0: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
85c0: 6c 65 20 77 69 6c 6c 20 62 65 20 6f 72 70 68 61  le will be orpha
85d0: 6e 65 64 2e 20 42 75 74 20 77 65 20 63 61 6e 6e  ned. But we cann
85e0: 6f 74 20 64 65 6c 65 74 65 20 69 74 2c 0a 20 20  ot delete it,.  
85f0: 20 20 2a 2a 20 69 6e 20 63 61 73 65 20 74 68 65    ** in case the
8600: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8610: 66 69 6c 65 20 6e 61 6d 65 20 77 61 73 20 77 72  file name was wr
8620: 69 74 74 65 6e 20 69 6e 74 6f 20 74 68 65 20 6a  itten into the j
8630: 6f 75 72 6e 61 6c 0a 20 20 20 20 2a 2a 20 66 69  ournal.    ** fi
8640: 6c 65 20 62 65 66 6f 72 65 20 74 68 65 20 66 61  le before the fa
8650: 69 6c 75 72 65 20 6f 63 63 75 72 65 64 2e 0a 20  ilure occured.. 
8660: 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d     */.    for(i=
8670: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  0; rc==SQLITE_OK
8680: 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69   && i<db->nDb; i
8690: 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65  ++){ .      Btre
86a0: 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62  e *pBt = db->aDb
86b0: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69  [i].pBt;.      i
86c0: 66 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65  f( pBt && sqlite
86d0: 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28  3BtreeIsInTrans(
86e0: 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20 20 20  pBt) ){.        
86f0: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
8700: 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28  eCommitPhaseOne(
8710: 70 42 74 2c 20 7a 4d 61 73 74 65 72 29 3b 0a 20  pBt, zMaster);. 
8720: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
8730: 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28   sqlite3OsClose(
8740: 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 69 66  &master);.    if
8750: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8760: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  ){.      sqliteF
8770: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
8780: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
8790: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 65 6c     }..    /* Del
87a0: 65 74 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a  ete the master j
87b0: 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69  ournal file. Thi
87c0: 73 20 63 6f 6d 6d 69 74 73 20 74 68 65 20 74 72  s commits the tr
87d0: 61 6e 73 61 63 74 69 6f 6e 2e 20 41 66 74 65 72  ansaction. After
87e0: 0a 20 20 20 20 2a 2a 20 64 6f 69 6e 67 20 74 68  .    ** doing th
87f0: 69 73 20 74 68 65 20 64 69 72 65 63 74 6f 72 79  is the directory
8800: 20 69 73 20 73 79 6e 63 65 64 20 61 67 61 69 6e   is synced again
8810: 20 62 65 66 6f 72 65 20 61 6e 79 20 69 6e 64 69   before any indi
8820: 76 69 64 75 61 6c 0a 20 20 20 20 2a 2a 20 74 72  vidual.    ** tr
8830: 61 6e 73 61 63 74 69 6f 6e 20 66 69 6c 65 73 20  ansaction files 
8840: 61 72 65 20 64 65 6c 65 74 65 64 2e 0a 20 20 20  are deleted..   
8850: 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   */.    rc = sql
8860: 69 74 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61  ite3OsDelete(zMa
8870: 73 74 65 72 29 3b 0a 20 20 20 20 73 71 6c 69 74  ster);.    sqlit
8880: 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a  eFree(zMaster);.
8890: 20 20 20 20 7a 4d 61 73 74 65 72 20 3d 20 30 3b      zMaster = 0;
88a0: 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20  .    if( rc ){. 
88b0: 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a       return rc;.
88c0: 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20 73      }.    rc = s
88d0: 71 6c 69 74 65 33 4f 73 53 79 6e 63 44 69 72 65  qlite3OsSyncDire
88e0: 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69 6c 65 29  ctory(zMainFile)
88f0: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
8900: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
8910: 20 2f 2a 20 54 68 69 73 20 69 73 20 6e 6f 74 20   /* This is not 
8920: 67 6f 6f 64 2e 20 54 68 65 20 6d 61 73 74 65 72  good. The master
8930: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 68 61   journal file ha
8940: 73 20 62 65 65 6e 20 64 65 6c 65 74 65 64 2c 20  s been deleted, 
8950: 62 75 74 0a 20 20 20 20 20 20 2a 2a 20 74 68 65  but.      ** the
8960: 20 64 69 72 65 63 74 6f 72 79 20 73 79 6e 63 20   directory sync 
8970: 66 61 69 6c 65 64 2e 20 54 68 65 72 65 20 69 73  failed. There is
8980: 20 6e 6f 20 63 6f 6d 70 6c 65 74 65 6c 79 20 73   no completely s
8990: 61 66 65 20 63 6f 75 72 73 65 20 6f 66 0a 20 20  afe course of.  
89a0: 20 20 20 20 2a 2a 20 61 63 74 69 6f 6e 20 66 72      ** action fr
89b0: 6f 6d 20 68 65 72 65 2e 20 54 68 65 20 69 6e 64  om here. The ind
89c0: 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 73  ividual journals
89d0: 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 6e 61 6d   contain the nam
89e0: 65 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a  e of the.      *
89f0: 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  * master journal
8a00: 20 66 69 6c 65 2c 20 62 75 74 20 74 68 65 72 65   file, but there
8a10: 20 69 73 20 6e 6f 20 77 61 79 20 6f 66 20 6b 6e   is no way of kn
8a20: 6f 77 69 6e 67 20 69 66 20 74 68 61 74 0a 20 20  owing if that.  
8a30: 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f      ** master jo
8a40: 75 72 6e 61 6c 20 65 78 69 73 74 73 20 6e 6f 77  urnal exists now
8a50: 20 6f 72 20 69 66 20 69 74 20 77 69 6c 6c 20 65   or if it will e
8a60: 78 69 73 74 20 61 66 74 65 72 20 74 68 65 20 6f  xist after the o
8a70: 70 65 72 61 74 69 6e 67 0a 20 20 20 20 20 20 2a  perating.      *
8a80: 2a 20 73 79 73 74 65 6d 20 63 72 61 73 68 20 74  * system crash t
8a90: 68 61 74 20 6d 61 79 20 66 6f 6c 6c 6f 77 20 74  hat may follow t
8aa0: 68 65 20 66 73 79 6e 63 28 29 20 66 61 69 6c 75  he fsync() failu
8ab0: 72 65 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20  re..      */.   
8ac0: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
8ad0: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41 6c 6c 20    }..    /* All 
8ae0: 66 69 6c 65 73 20 61 6e 64 20 64 69 72 65 63 74  files and direct
8af0: 6f 72 69 65 73 20 68 61 76 65 20 61 6c 72 65 61  ories have alrea
8b00: 64 79 20 62 65 65 6e 20 73 79 6e 63 65 64 2c 20  dy been synced, 
8b10: 73 6f 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  so the following
8b20: 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 73 20 74 6f  .    ** calls to
8b30: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
8b40: 6d 69 74 50 68 61 73 65 54 77 6f 28 29 20 61 72  mitPhaseTwo() ar
8b50: 65 20 6f 6e 6c 79 20 63 6c 6f 73 69 6e 67 20 66  e only closing f
8b60: 69 6c 65 73 20 61 6e 64 0a 20 20 20 20 2a 2a 20  iles and.    ** 
8b70: 64 65 6c 65 74 69 6e 67 20 6f 72 20 74 72 75 6e  deleting or trun
8b80: 63 61 74 69 6e 67 20 6a 6f 75 72 6e 61 6c 73 2e  cating journals.
8b90: 20 49 66 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f   If something go
8ba0: 65 73 20 77 72 6f 6e 67 20 77 68 69 6c 65 0a 20  es wrong while. 
8bb0: 20 20 20 2a 2a 20 74 68 69 73 20 69 73 20 68 61     ** this is ha
8bc0: 70 70 65 6e 69 6e 67 20 77 65 20 64 6f 6e 27 74  ppening we don't
8bd0: 20 72 65 61 6c 6c 79 20 63 61 72 65 2e 20 54 68   really care. Th
8be0: 65 20 69 6e 74 65 67 72 69 74 79 20 6f 66 20 74  e integrity of t
8bf0: 68 65 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61  he.    ** transa
8c00: 63 74 69 6f 6e 20 69 73 20 61 6c 72 65 61 64 79  ction is already
8c10: 20 67 75 61 72 61 6e 74 65 65 64 2c 20 62 75 74   guaranteed, but
8c20: 20 73 6f 6d 65 20 73 74 72 61 79 20 27 63 6f 6c   some stray 'col
8c30: 64 27 20 6a 6f 75 72 6e 61 6c 73 0a 20 20 20 20  d' journals.    
8c40: 2a 2a 20 6d 61 79 20 62 65 20 6c 79 69 6e 67 20  ** may be lying 
8c50: 61 72 6f 75 6e 64 2e 20 52 65 74 75 72 6e 69 6e  around. Returnin
8c60: 67 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  g an error code 
8c70: 77 6f 6e 27 74 20 68 65 6c 70 20 6d 61 74 74 65  won't help matte
8c80: 72 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64  rs..    */.    d
8c90: 69 73 61 62 6c 65 5f 73 69 6d 75 6c 61 74 65 64  isable_simulated
8ca0: 5f 69 6f 5f 65 72 72 6f 72 73 28 29 3b 0a 20 20  _io_errors();.  
8cb0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d    for(i=0; i<db-
8cc0: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20  >nDb; i++){ .   
8cd0: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
8ce0: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
8cf0: 20 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b        if( pBt ){
8d00: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
8d10: 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65  BtreeCommitPhase
8d20: 54 77 6f 28 70 42 74 29 3b 0a 20 20 20 20 20 20  Two(pBt);.      
8d30: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 65 6e 61 62  }.    }.    enab
8d40: 6c 65 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f  le_simulated_io_
8d50: 65 72 72 6f 72 73 28 29 3b 0a 0a 20 20 20 20 73  errors();..    s
8d60: 71 6c 69 74 65 33 56 74 61 62 43 6f 6d 6d 69 74  qlite3VtabCommit
8d70: 28 64 62 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66  (db);.  }.#endif
8d80: 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ..  return rc;.}
8d90: 0a 0a 2f 2a 20 0a 2a 2a 20 54 68 69 73 20 72 6f  ../* .** This ro
8da0: 75 74 69 6e 65 20 63 68 65 63 6b 73 20 74 68 61  utine checks tha
8db0: 74 20 74 68 65 20 73 71 6c 69 74 65 33 2e 61 63  t the sqlite3.ac
8dc0: 74 69 76 65 56 64 62 65 43 6e 74 20 63 6f 75 6e  tiveVdbeCnt coun
8dd0: 74 20 76 61 72 69 61 62 6c 65 0a 2a 2a 20 6d 61  t variable.** ma
8de0: 74 63 68 65 73 20 74 68 65 20 6e 75 6d 62 65 72  tches the number
8df0: 20 6f 66 20 76 64 62 65 27 73 20 69 6e 20 74 68   of vdbe's in th
8e00: 65 20 6c 69 73 74 20 73 71 6c 69 74 65 33 2e 70  e list sqlite3.p
8e10: 56 64 62 65 20 74 68 61 74 20 61 72 65 0a 2a 2a  Vdbe that are.**
8e20: 20 63 75 72 72 65 6e 74 6c 79 20 61 63 74 69 76   currently activ
8e30: 65 2e 20 41 6e 20 61 73 73 65 72 74 69 6f 6e 20  e. An assertion 
8e40: 66 61 69 6c 73 20 69 66 20 74 68 65 20 74 77 6f  fails if the two
8e50: 20 63 6f 75 6e 74 73 20 64 6f 20 6e 6f 74 20 6d   counts do not m
8e60: 61 74 63 68 2e 0a 2a 2a 20 54 68 69 73 20 69 73  atch..** This is
8e70: 20 61 6e 20 69 6e 74 65 72 6e 61 6c 20 73 65 6c   an internal sel
8e80: 66 2d 63 68 65 63 6b 20 6f 6e 6c 79 20 2d 20 69  f-check only - i
8e90: 74 20 69 73 20 6e 6f 74 20 61 6e 20 65 73 73 65  t is not an esse
8ea0: 6e 74 69 61 6c 20 70 72 6f 63 65 73 73 69 6e 67  ntial processing
8eb0: 0a 2a 2a 20 73 74 65 70 2e 0a 2a 2a 0a 2a 2a 20  .** step..**.** 
8ec0: 54 68 69 73 20 69 73 20 61 20 6e 6f 2d 6f 70 20  This is a no-op 
8ed0: 69 66 20 4e 44 45 42 55 47 20 69 73 20 64 65 66  if NDEBUG is def
8ee0: 69 6e 65 64 2e 0a 2a 2f 0a 23 69 66 6e 64 65 66  ined..*/.#ifndef
8ef0: 20 4e 44 45 42 55 47 0a 73 74 61 74 69 63 20 76   NDEBUG.static v
8f00: 6f 69 64 20 63 68 65 63 6b 41 63 74 69 76 65 56  oid checkActiveV
8f10: 64 62 65 43 6e 74 28 73 71 6c 69 74 65 33 20 2a  dbeCnt(sqlite3 *
8f20: 64 62 29 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a  db){.  Vdbe *p;.
8f30: 20 20 69 6e 74 20 63 6e 74 20 3d 20 30 3b 0a 20    int cnt = 0;. 
8f40: 20 70 20 3d 20 64 62 2d 3e 70 56 64 62 65 3b 0a   p = db->pVdbe;.
8f50: 20 20 77 68 69 6c 65 28 20 70 20 29 7b 0a 20 20    while( p ){.  
8f60: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d 3d    if( p->magic==
8f70: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 26  VDBE_MAGIC_RUN &
8f80: 26 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20  & p->pc>=0 ){.  
8f90: 20 20 20 20 63 6e 74 2b 2b 3b 0a 20 20 20 20 7d      cnt++;.    }
8fa0: 0a 20 20 20 20 70 20 3d 20 70 2d 3e 70 4e 65 78  .    p = p->pNex
8fb0: 74 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28  t;.  }.  assert(
8fc0: 20 63 6e 74 3d 3d 64 62 2d 3e 61 63 74 69 76 65   cnt==db->active
8fd0: 56 64 62 65 43 6e 74 20 29 3b 0a 7d 0a 23 65 6c  VdbeCnt );.}.#el
8fe0: 73 65 0a 23 64 65 66 69 6e 65 20 63 68 65 63 6b  se.#define check
8ff0: 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 78 29  ActiveVdbeCnt(x)
9000: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 46  .#endif../*.** F
9010: 69 6e 64 20 65 76 65 72 79 20 61 63 74 69 76 65  ind every active
9020: 20 56 4d 20 6f 74 68 65 72 20 74 68 61 6e 20 70   VM other than p
9030: 56 64 62 65 20 61 6e 64 20 63 68 61 6e 67 65 20  Vdbe and change 
9040: 69 74 73 20 73 74 61 74 75 73 20 74 6f 0a 2a 2a  its status to.**
9050: 20 61 62 6f 72 74 65 64 2e 20 20 54 68 69 73 20   aborted.  This 
9060: 68 61 70 70 65 6e 73 20 77 68 65 6e 20 6f 6e 65  happens when one
9070: 20 56 4d 20 63 61 75 73 65 73 20 61 20 72 6f 6c   VM causes a rol
9080: 6c 62 61 63 6b 20 64 75 65 20 74 6f 20 61 6e 0a  lback due to an.
9090: 2a 2a 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 52  ** ON CONFLICT R
90a0: 4f 4c 4c 42 41 43 4b 20 63 6c 61 75 73 65 20 28  OLLBACK clause (
90b0: 66 6f 72 20 65 78 61 6d 70 6c 65 29 2e 20 20 54  for example).  T
90c0: 68 65 20 6f 74 68 65 72 20 56 4d 73 20 6d 75 73  he other VMs mus
90d0: 74 20 62 65 0a 2a 2a 20 61 62 6f 72 74 65 64 20  t be.** aborted 
90e0: 73 6f 20 74 68 61 74 20 74 68 65 79 20 64 6f 20  so that they do 
90f0: 6e 6f 74 20 68 61 76 65 20 64 61 74 61 20 72 6f  not have data ro
9100: 6c 6c 65 64 20 6f 75 74 20 66 72 6f 6d 20 75 6e  lled out from un
9110: 64 65 72 6e 65 61 74 68 0a 2a 2a 20 74 68 65 6d  derneath.** them
9120: 20 6c 65 61 64 69 6e 67 20 74 6f 20 61 20 73 65   leading to a se
9130: 67 66 61 75 6c 74 2e 0a 2a 2f 0a 76 6f 69 64 20  gfault..*/.void 
9140: 73 71 6c 69 74 65 33 41 62 6f 72 74 4f 74 68 65  sqlite3AbortOthe
9150: 72 41 63 74 69 76 65 56 64 62 65 73 28 73 71 6c  rActiveVdbes(sql
9160: 69 74 65 33 20 2a 64 62 2c 20 56 64 62 65 20 2a  ite3 *db, Vdbe *
9170: 70 45 78 63 65 70 74 29 7b 0a 20 20 56 64 62 65  pExcept){.  Vdbe
9180: 20 2a 70 4f 74 68 65 72 3b 0a 20 20 66 6f 72 28   *pOther;.  for(
9190: 70 4f 74 68 65 72 3d 64 62 2d 3e 70 56 64 62 65  pOther=db->pVdbe
91a0: 3b 20 70 4f 74 68 65 72 3b 20 70 4f 74 68 65 72  ; pOther; pOther
91b0: 3d 70 4f 74 68 65 72 2d 3e 70 4e 65 78 74 29 7b  =pOther->pNext){
91c0: 0a 20 20 20 20 69 66 28 20 70 4f 74 68 65 72 3d  .    if( pOther=
91d0: 3d 70 45 78 63 65 70 74 20 29 20 63 6f 6e 74 69  =pExcept ) conti
91e0: 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 70 4f 74  nue;.    if( pOt
91f0: 68 65 72 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45  her->magic!=VDBE
9200: 5f 4d 41 47 49 43 5f 52 55 4e 20 7c 7c 20 70 4f  _MAGIC_RUN || pO
9210: 74 68 65 72 2d 3e 70 63 3c 30 20 29 20 63 6f 6e  ther->pc<0 ) con
9220: 74 69 6e 75 65 3b 0a 20 20 20 20 63 68 65 63 6b  tinue;.    check
9230: 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64 62  ActiveVdbeCnt(db
9240: 29 3b 0a 20 20 20 20 63 6c 6f 73 65 41 6c 6c 43  );.    closeAllC
9250: 75 72 73 6f 72 73 28 70 4f 74 68 65 72 29 3b 0a  ursors(pOther);.
9260: 20 20 20 20 63 68 65 63 6b 41 63 74 69 76 65 56      checkActiveV
9270: 64 62 65 43 6e 74 28 64 62 29 3b 0a 20 20 20 20  dbeCnt(db);.    
9280: 70 4f 74 68 65 72 2d 3e 61 62 6f 72 74 65 64 20  pOther->aborted 
9290: 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a  = 1;.  }.}../*.*
92a0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
92b0: 73 20 63 61 6c 6c 65 64 20 74 68 65 20 77 68 65  s called the whe
92c0: 6e 20 61 20 56 44 42 45 20 74 72 69 65 73 20 74  n a VDBE tries t
92d0: 6f 20 68 61 6c 74 2e 20 20 49 66 20 74 68 65 20  o halt.  If the 
92e0: 56 44 42 45 0a 2a 2a 20 68 61 73 20 6d 61 64 65  VDBE.** has made
92f0: 20 63 68 61 6e 67 65 73 20 61 6e 64 20 69 73 20   changes and is 
9300: 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 20 6d 6f  in autocommit mo
9310: 64 65 2c 20 74 68 65 6e 20 63 6f 6d 6d 69 74 20  de, then commit 
9320: 74 68 6f 73 65 0a 2a 2a 20 63 68 61 6e 67 65 73  those.** changes
9330: 2e 20 20 49 66 20 61 20 72 6f 6c 6c 62 61 63 6b  .  If a rollback
9340: 20 69 73 20 6e 65 65 64 65 64 2c 20 74 68 65 6e   is needed, then
9350: 20 64 6f 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b   do the rollback
9360: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75  ..**.** This rou
9370: 74 69 6e 65 20 69 73 20 74 68 65 20 6f 6e 6c 79  tine is the only
9380: 20 77 61 79 20 74 6f 20 6d 6f 76 65 20 74 68 65   way to move the
9390: 20 73 74 61 74 65 20 6f 66 20 61 20 56 4d 20 66   state of a VM f
93a0: 72 6f 6d 0a 2a 2a 20 53 51 4c 49 54 45 5f 4d 41  rom.** SQLITE_MA
93b0: 47 49 43 5f 52 55 4e 20 74 6f 20 53 51 4c 49 54  GIC_RUN to SQLIT
93c0: 45 5f 4d 41 47 49 43 5f 48 41 4c 54 2e 0a 2a 2a  E_MAGIC_HALT..**
93d0: 0a 2a 2a 20 52 65 74 75 72 6e 20 61 6e 20 65 72  .** Return an er
93e0: 72 6f 72 20 63 6f 64 65 2e 20 20 49 66 20 74 68  ror code.  If th
93f0: 65 20 63 6f 6d 6d 69 74 20 63 6f 75 6c 64 20 6e  e commit could n
9400: 6f 74 20 63 6f 6d 70 6c 65 74 65 20 62 65 63 61  ot complete beca
9410: 75 73 65 20 6f 66 0a 2a 2a 20 6c 6f 63 6b 20 63  use of.** lock c
9420: 6f 6e 74 65 6e 74 69 6f 6e 2c 20 72 65 74 75 72  ontention, retur
9430: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e 20 20  n SQLITE_BUSY.  
9440: 49 66 20 53 51 4c 49 54 45 5f 42 55 53 59 20 69  If SQLITE_BUSY i
9450: 73 20 72 65 74 75 72 6e 65 64 2c 20 69 74 0a 2a  s returned, it.*
9460: 2a 20 6d 65 61 6e 73 20 74 68 65 20 63 6c 6f 73  * means the clos
9470: 65 20 64 69 64 20 6e 6f 74 20 68 61 70 70 65 6e  e did not happen
9480: 20 61 6e 64 20 6e 65 65 64 73 20 74 6f 20 62 65   and needs to be
9490: 20 72 65 70 65 61 74 65 64 2e 0a 2a 2f 0a 69 6e   repeated..*/.in
94a0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 48 61 6c  t sqlite3VdbeHal
94b0: 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 71  t(Vdbe *p){.  sq
94c0: 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64  lite3 *db = p->d
94d0: 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e  b;.  int i;.  in
94e0: 74 20 28 2a 78 46 75 6e 63 29 28 42 74 72 65 65  t (*xFunc)(Btree
94f0: 20 2a 70 42 74 29 20 3d 20 30 3b 20 20 2f 2a 20   *pBt) = 0;  /* 
9500: 46 75 6e 63 74 69 6f 6e 20 74 6f 20 63 61 6c 6c  Function to call
9510: 20 6f 6e 20 65 61 63 68 20 62 74 72 65 65 20 62   on each btree b
9520: 61 63 6b 65 6e 64 20 2a 2f 0a 20 20 69 6e 74 20  ackend */.  int 
9530: 69 73 53 70 65 63 69 61 6c 45 72 72 6f 72 3b 20  isSpecialError; 
9540: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65             /* Se
9550: 74 20 74 6f 20 74 72 75 65 20 69 66 20 53 51 4c  t to true if SQL
9560: 49 54 45 5f 4e 4f 4d 45 4d 20 6f 72 20 49 4f 45  ITE_NOMEM or IOE
9570: 52 52 20 2a 2f 0a 0a 20 20 2f 2a 20 54 68 69 73  RR */..  /* This
9580: 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6e 74 61 69   function contai
9590: 6e 73 20 74 68 65 20 6c 6f 67 69 63 20 74 68 61  ns the logic tha
95a0: 74 20 64 65 74 65 72 6d 69 6e 65 73 20 69 66 20  t determines if 
95b0: 61 20 73 74 61 74 65 6d 65 6e 74 20 6f 72 0a 20  a statement or. 
95c0: 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   ** transaction 
95d0: 77 69 6c 6c 20 62 65 20 63 6f 6d 6d 69 74 74 65  will be committe
95e0: 64 20 6f 72 20 72 6f 6c 6c 65 64 20 62 61 63 6b  d or rolled back
95f0: 20 61 73 20 61 20 72 65 73 75 6c 74 20 6f 66 20   as a result of 
9600: 74 68 65 0a 20 20 2a 2a 20 65 78 65 63 75 74 69  the.  ** executi
9610: 6f 6e 20 6f 66 20 74 68 69 73 20 76 69 72 74 75  on of this virtu
9620: 61 6c 20 6d 61 63 68 69 6e 65 2e 20 0a 20 20 2a  al machine. .  *
9630: 2a 0a 20 20 2a 2a 20 53 70 65 63 69 61 6c 20 65  *.  ** Special e
9640: 72 72 6f 72 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a  rrors:.  **.  **
9650: 20 20 20 20 20 49 66 20 61 6e 20 53 51 4c 49 54       If an SQLIT
9660: 45 5f 4e 4f 4d 45 4d 20 65 72 72 6f 72 20 68 61  E_NOMEM error ha
9670: 73 20 6f 63 63 75 72 65 64 20 69 6e 20 61 20 73  s occured in a s
9680: 74 61 74 65 6d 65 6e 74 20 74 68 61 74 20 77 72  tatement that wr
9690: 69 74 65 73 20 74 6f 0a 20 20 2a 2a 20 20 20 20  ites to.  **    
96a0: 20 74 68 65 20 64 61 74 61 62 61 73 65 2c 20 74   the database, t
96b0: 68 65 6e 20 65 69 74 68 65 72 20 61 20 73 74 61  hen either a sta
96c0: 74 65 6d 65 6e 74 20 6f 72 20 74 72 61 6e 73 61  tement or transa
96d0: 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 72 6f  ction must be ro
96e0: 6c 6c 65 64 0a 20 20 2a 2a 20 20 20 20 20 62 61  lled.  **     ba
96f0: 63 6b 20 74 6f 20 65 6e 73 75 72 65 20 74 68 65  ck to ensure the
9700: 20 74 72 65 65 2d 73 74 72 75 63 74 75 72 65 73   tree-structures
9710: 20 61 72 65 20 69 6e 20 61 20 63 6f 6e 73 69 73   are in a consis
9720: 74 65 6e 74 20 73 74 61 74 65 2e 20 41 0a 20 20  tent state. A.  
9730: 2a 2a 20 20 20 20 20 73 74 61 74 65 6d 65 6e 74  **     statement
9740: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
9750: 72 6f 6c 6c 65 64 20 62 61 63 6b 20 69 66 20 6f  rolled back if o
9760: 6e 65 20 69 73 20 6f 70 65 6e 2c 20 6f 74 68 65  ne is open, othe
9770: 72 77 69 73 65 20 74 68 65 0a 20 20 2a 2a 20 20  rwise the.  **  
9780: 20 20 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61     entire transa
9790: 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 72 6f  ction must be ro
97a0: 6c 6c 65 64 20 62 61 63 6b 2e 0a 20 20 2a 2a 0a  lled back..  **.
97b0: 20 20 2a 2a 20 20 20 20 20 49 66 20 61 6e 20 53    **     If an S
97c0: 51 4c 49 54 45 5f 49 4f 45 52 52 20 65 72 72 6f  QLITE_IOERR erro
97d0: 72 20 68 61 73 20 6f 63 63 75 72 65 64 20 69 6e  r has occured in
97e0: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61   a statement tha
97f0: 74 20 77 72 69 74 65 73 20 74 6f 0a 20 20 2a 2a  t writes to.  **
9800: 20 20 20 20 20 74 68 65 20 64 61 74 61 62 61 73       the databas
9810: 65 2c 20 74 68 65 6e 20 74 68 65 20 65 6e 74 69  e, then the enti
9820: 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d  re transaction m
9830: 75 73 74 20 62 65 20 72 6f 6c 6c 65 64 20 62 61  ust be rolled ba
9840: 63 6b 2e 20 54 68 65 0a 20 20 2a 2a 20 20 20 20  ck. The.  **    
9850: 20 49 2f 4f 20 65 72 72 6f 72 20 6d 61 79 20 68   I/O error may h
9860: 61 76 65 20 63 61 75 73 65 64 20 67 61 72 62 61  ave caused garba
9870: 67 65 20 74 6f 20 62 65 20 77 72 69 74 74 65 6e  ge to be written
9880: 20 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20   to the journal 
9890: 0a 20 20 2a 2a 20 20 20 20 20 66 69 6c 65 2e 20  .  **     file. 
98a0: 57 65 72 65 20 74 68 65 20 74 72 61 6e 73 61 63  Were the transac
98b0: 74 69 6f 6e 20 74 6f 20 63 6f 6e 74 69 6e 75 65  tion to continue
98c0: 20 61 6e 64 20 65 76 65 6e 74 75 61 6c 6c 79 20   and eventually 
98d0: 62 65 20 72 6f 6c 6c 65 64 20 0a 20 20 2a 2a 20  be rolled .  ** 
98e0: 20 20 20 20 62 61 63 6b 20 74 68 61 74 20 67 61      back that ga
98f0: 72 62 61 67 65 20 6d 69 67 68 74 20 65 6e 64 20  rbage might end 
9900: 75 70 20 69 6e 20 74 68 65 20 64 61 74 61 62 61  up in the databa
9910: 73 65 20 66 69 6c 65 2e 0a 20 20 2a 2a 20 20 20  se file..  **   
9920: 20 20 0a 20 20 2a 2a 20 20 20 20 20 49 6e 20 62    .  **     In b
9930: 6f 74 68 20 6f 66 20 74 68 65 20 61 62 6f 76 65  oth of the above
9940: 20 63 61 73 65 73 2c 20 74 68 65 20 56 64 62 65   cases, the Vdbe
9950: 2e 65 72 72 6f 72 41 63 74 69 6f 6e 20 76 61 72  .errorAction var
9960: 69 61 62 6c 65 20 69 73 20 0a 20 20 2a 2a 20 20  iable is .  **  
9970: 20 20 20 69 67 6e 6f 72 65 64 2e 20 49 66 20 74     ignored. If t
9980: 68 65 20 73 71 6c 69 74 65 33 2e 61 75 74 6f 43  he sqlite3.autoC
9990: 6f 6d 6d 69 74 20 66 6c 61 67 20 69 73 20 66 61  ommit flag is fa
99a0: 6c 73 65 20 61 6e 64 20 61 20 74 72 61 6e 73 61  lse and a transa
99b0: 63 74 69 6f 6e 0a 20 20 2a 2a 20 20 20 20 20 69  ction.  **     i
99c0: 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2c 20 69  s rolled back, i
99d0: 74 20 77 69 6c 6c 20 62 65 20 73 65 74 20 74 6f  t will be set to
99e0: 20 74 72 75 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a   true..  **.  **
99f0: 20 4f 74 68 65 72 20 65 72 72 6f 72 73 3a 0a 20   Other errors:. 
9a00: 20 2a 2a 0a 20 20 2a 2a 20 4e 6f 20 65 72 72 6f   **.  ** No erro
9a10: 72 3a 0a 20 20 2a 2a 0a 20 20 2a 2f 0a 0a 20 20  r:.  **.  */..  
9a20: 69 66 28 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  if( sqlite3Mallo
9a30: 63 46 61 69 6c 65 64 28 29 20 29 7b 0a 20 20 20  cFailed() ){.   
9a40: 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f   p->rc = SQLITE_
9a50: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28  NOMEM;.  }.  if(
9a60: 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f   p->magic!=VDBE_
9a70: 4d 41 47 49 43 5f 52 55 4e 20 29 7b 0a 20 20 20  MAGIC_RUN ){.   
9a80: 20 2f 2a 20 41 6c 72 65 61 64 79 20 68 61 6c 74   /* Already halt
9a90: 65 64 2e 20 20 4e 6f 74 68 69 6e 67 20 74 6f 20  ed.  Nothing to 
9aa0: 64 6f 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72  do. */.    asser
9ab0: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
9ac0: 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 3b 0a  E_MAGIC_HALT );.
9ad0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f  #ifndef SQLITE_O
9ae0: 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45  MIT_VIRTUALTABLE
9af0: 0a 20 20 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72  .    closeAllCur
9b00: 73 6f 72 73 28 70 29 3b 0a 23 65 6e 64 69 66 0a  sors(p);.#endif.
9b10: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
9b20: 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 63 6c 6f 73  E_OK;.  }.  clos
9b30: 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 29 3b 0a  eAllCursors(p);.
9b40: 20 20 63 68 65 63 6b 41 63 74 69 76 65 56 64 62    checkActiveVdb
9b50: 65 43 6e 74 28 64 62 29 3b 0a 0a 20 20 2f 2a 20  eCnt(db);..  /* 
9b60: 4e 6f 20 63 6f 6d 6d 69 74 20 6f 72 20 72 6f 6c  No commit or rol
9b70: 6c 62 61 63 6b 20 6e 65 65 64 65 64 20 69 66 20  lback needed if 
9b80: 74 68 65 20 70 72 6f 67 72 61 6d 20 6e 65 76 65  the program neve
9b90: 72 20 73 74 61 72 74 65 64 20 2a 2f 0a 20 20 69  r started */.  i
9ba0: 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20  f( p->pc>=0 ){. 
9bb0: 20 20 20 69 6e 74 20 6d 72 63 3b 20 20 20 2f 2a     int mrc;   /*
9bc0: 20 50 72 69 6d 61 72 79 20 65 72 72 6f 72 20 63   Primary error c
9bd0: 6f 64 65 20 66 72 6f 6d 20 70 2d 3e 72 63 20 2a  ode from p->rc *
9be0: 2f 0a 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 66  /.    /* Check f
9bf0: 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20 73 70  or one of the sp
9c00: 65 63 69 61 6c 20 65 72 72 6f 72 73 20 2d 20 53  ecial errors - S
9c10: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 6f 72 20 53  QLITE_NOMEM or S
9c20: 51 4c 49 54 45 5f 49 4f 45 52 52 20 2a 2f 0a 20  QLITE_IOERR */. 
9c30: 20 20 20 6d 72 63 20 3d 20 70 2d 3e 72 63 20 26     mrc = p->rc &
9c40: 20 30 78 66 66 3b 0a 20 20 20 20 69 73 53 70 65   0xff;.    isSpe
9c50: 63 69 61 6c 45 72 72 6f 72 20 3d 20 28 28 6d 72  cialError = ((mr
9c60: 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20  c==SQLITE_NOMEM 
9c70: 7c 7c 20 6d 72 63 3d 3d 53 51 4c 49 54 45 5f 49  || mrc==SQLITE_I
9c80: 4f 45 52 52 29 3f 31 3a 30 29 3b 0a 20 20 20 20  OERR)?1:0);.    
9c90: 69 66 28 20 69 73 53 70 65 63 69 61 6c 45 72 72  if( isSpecialErr
9ca0: 6f 72 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54  or ){.      /* T
9cb0: 68 69 73 20 6c 6f 6f 70 20 64 6f 65 73 20 73 74  his loop does st
9cc0: 61 74 69 63 20 61 6e 61 6c 79 73 69 73 20 6f 66  atic analysis of
9cd0: 20 74 68 65 20 71 75 65 72 79 20 74 6f 20 73 65   the query to se
9ce0: 65 20 77 68 69 63 68 20 6f 66 20 74 68 65 0a 20  e which of the. 
9cf0: 20 20 20 20 20 2a 2a 20 66 6f 6c 6c 6f 77 69 6e       ** followin
9d00: 67 20 74 68 72 65 65 20 63 61 74 65 67 6f 72 69  g three categori
9d10: 65 73 20 69 74 20 66 61 6c 6c 73 20 69 6e 74 6f  es it falls into
9d20: 3a 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20  :.      **.     
9d30: 20 2a 2a 20 20 20 20 20 52 65 61 64 2d 6f 6e 6c   **     Read-onl
9d40: 79 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 20 51  y.      **     Q
9d50: 75 65 72 79 20 77 69 74 68 20 73 74 61 74 65 6d  uery with statem
9d60: 65 6e 74 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20  ent journal.    
9d70: 20 20 2a 2a 20 20 20 20 20 51 75 65 72 79 20 77    **     Query w
9d80: 69 74 68 6f 75 74 20 73 74 61 74 65 6d 65 6e 74  ithout statement
9d90: 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 2a   journal.      *
9da0: 2a 0a 20 20 20 20 20 20 2a 2a 20 57 65 20 63 6f  *.      ** We co
9db0: 75 6c 64 20 64 6f 20 73 6f 6d 65 74 68 69 6e 67  uld do something
9dc0: 20 6d 6f 72 65 20 65 6c 65 67 61 6e 74 20 74 68   more elegant th
9dd0: 61 6e 20 74 68 69 73 20 73 74 61 74 69 63 20 61  an this static a
9de0: 6e 61 6c 79 73 69 73 20 28 69 2e 65 2e 0a 20 20  nalysis (i.e..  
9df0: 20 20 20 20 2a 2a 20 73 74 6f 72 65 20 74 68 65      ** store the
9e00: 20 74 79 70 65 20 6f 66 20 71 75 65 72 79 20 61   type of query a
9e10: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f  s part of the co
9e20: 6d 70 6c 69 61 74 69 6f 6e 20 70 68 61 73 65 29  mpliation phase)
9e30: 2c 20 62 75 74 20 0a 20 20 20 20 20 20 2a 2a 20  , but .      ** 
9e40: 68 61 6e 64 6c 69 6e 67 20 6d 61 6c 6c 6f 63 28  handling malloc(
9e50: 29 20 6f 72 20 49 4f 20 66 61 69 6c 75 72 65 20  ) or IO failure 
9e60: 69 73 20 61 20 66 61 69 72 6c 79 20 6f 62 73 63  is a fairly obsc
9e70: 75 72 65 20 65 64 67 65 20 63 61 73 65 20 73 6f  ure edge case so
9e80: 20 0a 20 20 20 20 20 20 2a 2a 20 74 68 69 73 20   .      ** this 
9e90: 69 73 20 70 72 6f 62 61 62 6c 79 20 65 61 73 69  is probably easi
9ea0: 65 72 2e 20 54 6f 64 6f 3a 20 4d 69 67 68 74 20  er. Todo: Might 
9eb0: 62 65 20 61 6e 20 6f 70 70 6f 72 74 75 6e 69 74  be an opportunit
9ec0: 79 20 74 6f 20 72 65 64 75 63 65 20 0a 20 20 20  y to reduce .   
9ed0: 20 20 20 2a 2a 20 63 6f 64 65 20 73 69 7a 65 20     ** code size 
9ee0: 61 20 76 65 72 79 20 73 6d 61 6c 6c 20 61 6d 6f  a very small amo
9ef0: 75 6e 74 20 74 68 6f 75 67 68 2e 2e 2e 0a 20 20  unt though....  
9f00: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74      */.      int
9f10: 20 69 73 52 65 61 64 4f 6e 6c 79 20 3d 20 31 3b   isReadOnly = 1;
9f20: 0a 20 20 20 20 20 20 69 6e 74 20 69 73 53 74 61  .      int isSta
9f30: 74 65 6d 65 6e 74 20 3d 20 30 3b 0a 20 20 20 20  tement = 0;.    
9f40: 20 20 61 73 73 65 72 74 28 70 2d 3e 61 4f 70 20    assert(p->aOp 
9f50: 7c 7c 20 70 2d 3e 6e 4f 70 3d 3d 30 29 3b 0a 20  || p->nOp==0);. 
9f60: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c       for(i=0; i<
9f70: 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 20 0a 20  p->nOp; i++){ . 
9f80: 20 20 20 20 20 20 20 73 77 69 74 63 68 28 20 70         switch( p
9f90: 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64 65 20  ->aOp[i].opcode 
9fa0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 63 61 73  ){.          cas
9fb0: 65 20 4f 50 5f 54 72 61 6e 73 61 63 74 69 6f 6e  e OP_Transaction
9fc0: 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 73  :.            is
9fd0: 52 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20  ReadOnly = 0;.  
9fe0: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b            break;
9ff0: 0a 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20  .          case 
a000: 4f 50 5f 53 74 61 74 65 6d 65 6e 74 3a 0a 20 20  OP_Statement:.  
a010: 20 20 20 20 20 20 20 20 20 20 69 73 53 74 61 74            isStat
a020: 65 6d 65 6e 74 20 3d 20 31 3b 0a 20 20 20 20 20  ement = 1;.     
a030: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
a040: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
a050: 20 20 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74    .      /* If t
a060: 68 65 20 71 75 65 72 79 20 77 61 73 20 72 65 61  he query was rea
a070: 64 2d 6f 6e 6c 79 2c 20 77 65 20 6e 65 65 64 20  d-only, we need 
a080: 64 6f 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 61  do no rollback a
a090: 74 20 61 6c 6c 2e 20 4f 74 68 65 72 77 69 73 65  t all. Otherwise
a0a0: 2c 0a 20 20 20 20 20 20 2a 2a 20 70 72 6f 63 65  ,.      ** proce
a0b0: 65 64 20 77 69 74 68 20 74 68 65 20 73 70 65 63  ed with the spec
a0c0: 69 61 6c 20 68 61 6e 64 6c 69 6e 67 2e 0a 20 20  ial handling..  
a0d0: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28      */.      if(
a0e0: 20 21 69 73 52 65 61 64 4f 6e 6c 79 20 29 7b 0a   !isReadOnly ){.
a0f0: 20 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 72          if( p->r
a100: 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20  c==SQLITE_NOMEM 
a110: 26 26 20 69 73 53 74 61 74 65 6d 65 6e 74 20 29  && isStatement )
a120: 7b 0a 20 20 20 20 20 20 20 20 20 20 78 46 75 6e  {.          xFun
a130: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
a140: 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 3b 0a 20 20  RollbackStmt;.  
a150: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
a160: 20 20 20 20 20 20 20 2f 2a 20 57 65 20 61 72 65         /* We are
a170: 20 66 6f 72 63 65 64 20 74 6f 20 72 6f 6c 6c 20   forced to roll 
a180: 62 61 63 6b 20 74 68 65 20 61 63 74 69 76 65 20  back the active 
a190: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 42 65 66  transaction. Bef
a1a0: 6f 72 65 20 64 6f 69 6e 67 0a 20 20 20 20 20 20  ore doing.      
a1b0: 20 20 20 20 2a 2a 20 73 6f 2c 20 61 62 6f 72 74      ** so, abort
a1c0: 20 61 6e 79 20 6f 74 68 65 72 20 73 74 61 74 65   any other state
a1d0: 6d 65 6e 74 73 20 74 68 69 73 20 68 61 6e 64 6c  ments this handl
a1e0: 65 20 63 75 72 72 65 6e 74 6c 79 20 68 61 73 20  e currently has 
a1f0: 61 63 74 69 76 65 2e 0a 20 20 20 20 20 20 20 20  active..        
a200: 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 73    */.          s
a210: 71 6c 69 74 65 33 41 62 6f 72 74 4f 74 68 65 72  qlite3AbortOther
a220: 41 63 74 69 76 65 56 64 62 65 73 28 64 62 2c 20  ActiveVdbes(db, 
a230: 70 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71  p);.          sq
a240: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c  lite3RollbackAll
a250: 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 20 20  (db);.          
a260: 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d  db->autoCommit =
a270: 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20   1;.        }.  
a280: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20      }.    }.  . 
a290: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 61 75 74     /* If the aut
a2a0: 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61 67 20 69 73  o-commit flag is
a2b0: 20 73 65 74 20 61 6e 64 20 74 68 69 73 20 69 73   set and this is
a2c0: 20 74 68 65 20 6f 6e 6c 79 20 61 63 74 69 76 65   the only active
a2d0: 20 76 64 62 65 2c 20 74 68 65 6e 0a 20 20 20 20   vdbe, then.    
a2e0: 2a 2a 20 77 65 20 64 6f 20 65 69 74 68 65 72 20  ** we do either 
a2f0: 61 20 63 6f 6d 6d 69 74 20 6f 72 20 72 6f 6c 6c  a commit or roll
a300: 62 61 63 6b 20 6f 66 20 74 68 65 20 63 75 72 72  back of the curr
a310: 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e  ent transaction.
a320: 20 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20   .    **.    ** 
a330: 4e 6f 74 65 3a 20 54 68 69 73 20 62 6c 6f 63 6b  Note: This block
a340: 20 61 6c 73 6f 20 72 75 6e 73 20 69 66 20 6f 6e   also runs if on
a350: 65 20 6f 66 20 74 68 65 20 73 70 65 63 69 61 6c  e of the special
a360: 20 65 72 72 6f 72 73 20 68 61 6e 64 6c 65 64 20   errors handled 
a370: 0a 20 20 20 20 2a 2a 20 61 62 6f 76 65 20 68 61  .    ** above ha
a380: 73 20 6f 63 63 75 72 65 64 2e 20 0a 20 20 20 20  s occured. .    
a390: 2a 2f 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 61  */.    if( db->a
a3a0: 75 74 6f 43 6f 6d 6d 69 74 20 26 26 20 64 62 2d  utoCommit && db-
a3b0: 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 3d 3d  >activeVdbeCnt==
a3c0: 31 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  1 ){.      if( p
a3d0: 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ->rc==SQLITE_OK 
a3e0: 7c 7c 20 28 70 2d 3e 65 72 72 6f 72 41 63 74 69  || (p->errorActi
a3f0: 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 26 26 20 21  on==OE_Fail && !
a400: 69 73 53 70 65 63 69 61 6c 45 72 72 6f 72 29 20  isSpecialError) 
a410: 29 7b 0a 09 2f 2a 20 54 68 65 20 61 75 74 6f 2d  ){../* The auto-
a420: 63 6f 6d 6d 69 74 20 66 6c 61 67 20 69 73 20 74  commit flag is t
a430: 72 75 65 2c 20 61 6e 64 20 74 68 65 20 76 64 62  rue, and the vdb
a440: 65 20 70 72 6f 67 72 61 6d 20 77 61 73 20 0a 20  e program was . 
a450: 20 20 20 20 20 20 20 2a 2a 20 73 75 63 63 65 73         ** succes
a460: 73 66 75 6c 20 6f 72 20 68 69 74 20 61 6e 20 27  sful or hit an '
a470: 4f 52 20 46 41 49 4c 27 20 63 6f 6e 73 74 72 61  OR FAIL' constra
a480: 69 6e 74 2e 20 54 68 69 73 20 6d 65 61 6e 73 20  int. This means 
a490: 61 20 63 6f 6d 6d 69 74 20 0a 20 20 20 20 20 20  a commit .      
a4a0: 20 20 2a 2a 20 69 73 20 72 65 71 75 69 72 65 64    ** is required
a4b0: 2e 0a 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20  ..        */.   
a4c0: 20 20 20 20 20 69 6e 74 20 72 63 20 3d 20 76 64       int rc = vd
a4d0: 62 65 43 6f 6d 6d 69 74 28 64 62 29 3b 0a 20 20  beCommit(db);.  
a4e0: 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51        if( rc==SQ
a4f0: 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 20 20  LITE_BUSY ){.   
a500: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51         return SQ
a510: 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20 20  LITE_BUSY;.     
a520: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21     }else if( rc!
a530: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
a540: 20 20 20 20 20 20 20 20 70 2d 3e 72 63 20 3d 20          p->rc = 
a550: 72 63 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71  rc;.          sq
a560: 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c  lite3RollbackAll
a570: 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 7d 65  (db);.        }e
a580: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 73  lse{.          s
a590: 71 6c 69 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65  qlite3CommitInte
a5a0: 72 6e 61 6c 43 68 61 6e 67 65 73 28 64 62 29 3b  rnalChanges(db);
a5b0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
a5c0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
a5d0: 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b 41  sqlite3RollbackA
a5e0: 6c 6c 28 64 62 29 3b 0a 20 20 20 20 20 20 7d 0a  ll(db);.      }.
a5f0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 21 78      }else if( !x
a600: 46 75 6e 63 20 29 7b 0a 20 20 20 20 20 20 69 66  Func ){.      if
a610: 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  ( p->rc==SQLITE_
a620: 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72 6f 72 41 63  OK || p->errorAc
a630: 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 29 7b  tion==OE_Fail ){
a640: 0a 20 20 20 20 20 20 20 20 78 46 75 6e 63 20 3d  .        xFunc =
a650: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
a660: 6d 69 74 53 74 6d 74 3b 0a 20 20 20 20 20 20 7d  mitStmt;.      }
a670: 65 6c 73 65 20 69 66 28 20 70 2d 3e 65 72 72 6f  else if( p->erro
a680: 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 41 62 6f 72  rAction==OE_Abor
a690: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 78 46 75  t ){.        xFu
a6a0: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
a6b0: 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 3b 0a 20  eRollbackStmt;. 
a6c0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
a6d0: 20 20 20 20 73 71 6c 69 74 65 33 41 62 6f 72 74      sqlite3Abort
a6e0: 4f 74 68 65 72 41 63 74 69 76 65 56 64 62 65 73  OtherActiveVdbes
a6f0: 28 64 62 2c 20 70 29 3b 0a 20 20 20 20 20 20 20  (db, p);.       
a700: 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b   sqlite3Rollback
a710: 41 6c 6c 28 64 62 29 3b 0a 20 20 20 20 20 20 20  All(db);.       
a720: 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20   db->autoCommit 
a730: 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  = 1;.      }.   
a740: 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66 20   }.  .    /* If 
a750: 78 46 75 6e 63 20 69 73 20 6e 6f 74 20 4e 55 4c  xFunc is not NUL
a760: 4c 2c 20 74 68 65 6e 20 69 74 20 69 73 20 6f 6e  L, then it is on
a770: 65 20 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65  e of sqlite3Btre
a780: 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 20 6f 72  eRollbackStmt or
a790: 0a 20 20 20 20 2a 2a 20 73 71 6c 69 74 65 33 42  .    ** sqlite3B
a7a0: 74 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74 2e 20  treeCommitStmt. 
a7b0: 43 61 6c 6c 20 69 74 20 6f 6e 63 65 20 6f 6e 20  Call it once on 
a7c0: 65 61 63 68 20 62 61 63 6b 65 6e 64 2e 20 49 66  each backend. If
a7d0: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
a7e0: 0a 20 20 20 20 2a 2a 20 61 6e 64 20 74 68 65 20  .    ** and the 
a7f0: 72 65 74 75 72 6e 20 63 6f 64 65 20 69 73 20 73  return code is s
a800: 74 69 6c 6c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20  till SQLITE_OK, 
a810: 73 65 74 20 74 68 65 20 72 65 74 75 72 6e 20 63  set the return c
a820: 6f 64 65 20 74 6f 20 74 68 65 20 6e 65 77 0a 20  ode to the new. 
a830: 20 20 20 2a 2a 20 65 72 72 6f 72 20 76 61 6c 75     ** error valu
a840: 65 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 61 73  e..    */.    as
a850: 73 65 72 74 28 21 78 46 75 6e 63 20 7c 7c 0a 20  sert(!xFunc ||. 
a860: 20 20 20 20 20 78 46 75 6e 63 3d 3d 73 71 6c 69       xFunc==sqli
a870: 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53 74  te3BtreeCommitSt
a880: 6d 74 20 7c 7c 0a 20 20 20 20 20 20 78 46 75 6e  mt ||.      xFun
a890: 63 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 65 52  c==sqlite3BtreeR
a8a0: 6f 6c 6c 62 61 63 6b 53 74 6d 74 0a 20 20 20 20  ollbackStmt.    
a8b0: 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  );.    for(i=0; 
a8c0: 78 46 75 6e 63 20 26 26 20 69 3c 64 62 2d 3e 6e  xFunc && i<db->n
a8d0: 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20  Db; i++){ .     
a8e0: 20 69 6e 74 20 72 63 3b 0a 20 20 20 20 20 20 42   int rc;.      B
a8f0: 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e  tree *pBt = db->
a900: 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20  aDb[i].pBt;.    
a910: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20    if( pBt ){.   
a920: 20 20 20 20 20 72 63 20 3d 20 78 46 75 6e 63 28       rc = xFunc(
a930: 70 42 74 29 3b 0a 20 20 20 20 20 20 20 20 69 66  pBt);.        if
a940: 28 20 72 63 20 26 26 20 28 70 2d 3e 72 63 3d 3d  ( rc && (p->rc==
a950: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e  SQLITE_OK || p->
a960: 72 63 3d 3d 53 51 4c 49 54 45 5f 43 4f 4e 53 54  rc==SQLITE_CONST
a970: 52 41 49 4e 54 29 20 29 7b 0a 20 20 20 20 20 20  RAINT) ){.      
a980: 20 20 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a      p->rc = rc;.
a990: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
a9a0: 33 53 65 74 53 74 72 69 6e 67 28 26 70 2d 3e 7a  3SetString(&p->z
a9b0: 45 72 72 4d 73 67 2c 20 30 29 3b 0a 20 20 20 20  ErrMsg, 0);.    
a9c0: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20      }.      }.  
a9d0: 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66    }.  .    /* If
a9e0: 20 74 68 69 73 20 77 61 73 20 61 6e 20 49 4e 53   this was an INS
a9f0: 45 52 54 2c 20 55 50 44 41 54 45 20 6f 72 20 44  ERT, UPDATE or D
aa00: 45 4c 45 54 45 20 61 6e 64 20 74 68 65 20 73 74  ELETE and the st
aa10: 61 74 65 6d 65 6e 74 20 77 61 73 20 63 6f 6d 6d  atement was comm
aa20: 69 74 74 65 64 2c 20 0a 20 20 20 20 2a 2a 20 73  itted, .    ** s
aa30: 65 74 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f  et the change co
aa40: 75 6e 74 65 72 2e 20 0a 20 20 20 20 2a 2f 0a 20  unter. .    */. 
aa50: 20 20 20 69 66 28 20 70 2d 3e 63 68 61 6e 67 65     if( p->change
aa60: 43 6e 74 4f 6e 20 26 26 20 70 2d 3e 70 63 3e 3d  CntOn && p->pc>=
aa70: 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 21  0 ){.      if( !
aa80: 78 46 75 6e 63 20 7c 7c 20 78 46 75 6e 63 3d 3d  xFunc || xFunc==
aa90: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
aaa0: 69 74 53 74 6d 74 20 29 7b 0a 20 20 20 20 20 20  itStmt ){.      
aab0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74    sqlite3VdbeSet
aac0: 43 68 61 6e 67 65 73 28 64 62 2c 20 70 2d 3e 6e  Changes(db, p->n
aad0: 43 68 61 6e 67 65 29 3b 0a 20 20 20 20 20 20 7d  Change);.      }
aae0: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71  else{.        sq
aaf0: 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61 6e  lite3VdbeSetChan
ab00: 67 65 73 28 64 62 2c 20 30 29 3b 0a 20 20 20 20  ges(db, 0);.    
ab10: 20 20 7d 0a 20 20 20 20 20 20 70 2d 3e 6e 43 68    }.      p->nCh
ab20: 61 6e 67 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a  ange = 0;.    }.
ab30: 20 20 0a 20 20 20 20 2f 2a 20 52 6f 6c 6c 62 61    .    /* Rollba
ab40: 63 6b 20 6f 72 20 63 6f 6d 6d 69 74 20 61 6e 79  ck or commit any
ab50: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 20   schema changes 
ab60: 74 68 61 74 20 6f 63 63 75 72 72 65 64 2e 20 2a  that occurred. *
ab70: 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e 72 63 21  /.    if( p->rc!
ab80: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62  =SQLITE_OK && db
ab90: 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 49  ->flags&SQLITE_I
aba0: 6e 74 65 72 6e 43 68 61 6e 67 65 73 20 29 7b 0a  nternChanges ){.
abb0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65 73        sqlite3Res
abc0: 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61  etInternalSchema
abd0: 28 64 62 2c 20 30 29 3b 0a 20 20 20 20 20 20 64  (db, 0);.      d
abe0: 62 2d 3e 66 6c 61 67 73 20 3d 20 28 64 62 2d 3e  b->flags = (db->
abf0: 66 6c 61 67 73 20 7c 20 53 51 4c 49 54 45 5f 49  flags | SQLITE_I
ac00: 6e 74 65 72 6e 43 68 61 6e 67 65 73 29 3b 0a 20  nternChanges);. 
ac10: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 57     }.  }..  /* W
ac20: 65 20 68 61 76 65 20 73 75 63 63 65 73 73 66 75  e have successfu
ac30: 6c 6c 79 20 68 61 6c 74 65 64 20 61 6e 64 20 63  lly halted and c
ac40: 6c 6f 73 65 64 20 74 68 65 20 56 4d 2e 20 20 52  losed the VM.  R
ac50: 65 63 6f 72 64 20 74 68 69 73 20 66 61 63 74 2e  ecord this fact.
ac60: 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63 3e   */.  if( p->pc>
ac70: 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 61 63  =0 ){.    db->ac
ac80: 74 69 76 65 56 64 62 65 43 6e 74 2d 2d 3b 0a 20  tiveVdbeCnt--;. 
ac90: 20 7d 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20   }.  p->magic = 
aca0: 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 3b  VDBE_MAGIC_HALT;
acb0: 0a 20 20 63 68 65 63 6b 41 63 74 69 76 65 56 64  .  checkActiveVd
acc0: 62 65 43 6e 74 28 64 62 29 3b 0a 0a 20 20 72 65  beCnt(db);..  re
acd0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
ace0: 7d 0a 0a 2f 2a 0a 2a 2a 20 45 61 63 68 20 56 44  }../*.** Each VD
acf0: 42 45 20 68 6f 6c 64 73 20 74 68 65 20 72 65 73  BE holds the res
ad00: 75 6c 74 20 6f 66 20 74 68 65 20 6d 6f 73 74 20  ult of the most 
ad10: 72 65 63 65 6e 74 20 73 71 6c 69 74 65 33 5f 73  recent sqlite3_s
ad20: 74 65 70 28 29 20 63 61 6c 6c 0a 2a 2a 20 69 6e  tep() call.** in
ad30: 20 70 2d 3e 72 63 2e 20 20 54 68 69 73 20 72 6f   p->rc.  This ro
ad40: 75 74 69 6e 65 20 73 65 74 73 20 74 68 61 74 20  utine sets that 
ad50: 72 65 73 75 6c 74 20 62 61 63 6b 20 74 6f 20 53  result back to S
ad60: 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 76 6f 69  QLITE_OK..*/.voi
ad70: 64 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73  d sqlite3VdbeRes
ad80: 65 74 53 74 65 70 52 65 73 75 6c 74 28 56 64 62  etStepResult(Vdb
ad90: 65 20 2a 70 29 7b 0a 20 20 70 2d 3e 72 63 20 3d  e *p){.  p->rc =
ada0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
adb0: 2a 0a 2a 2a 20 43 6c 65 61 6e 20 75 70 20 61 20  *.** Clean up a 
adc0: 56 44 42 45 20 61 66 74 65 72 20 65 78 65 63 75  VDBE after execu
add0: 74 69 6f 6e 20 62 75 74 20 64 6f 20 6e 6f 74 20  tion but do not 
ade0: 64 65 6c 65 74 65 20 74 68 65 20 56 44 42 45 20  delete the VDBE 
adf0: 6a 75 73 74 20 79 65 74 2e 0a 2a 2a 20 57 72 69  just yet..** Wri
ae00: 74 65 20 61 6e 79 20 65 72 72 6f 72 20 6d 65 73  te any error mes
ae10: 73 61 67 65 73 20 69 6e 74 6f 20 2a 70 7a 45 72  sages into *pzEr
ae20: 72 4d 73 67 2e 20 20 52 65 74 75 72 6e 20 74 68  rMsg.  Return th
ae30: 65 20 72 65 73 75 6c 74 20 63 6f 64 65 2e 0a 2a  e result code..*
ae40: 2a 0a 2a 2a 20 41 66 74 65 72 20 74 68 69 73 20  *.** After this 
ae50: 72 6f 75 74 69 6e 65 20 69 73 20 72 75 6e 2c 20  routine is run, 
ae60: 74 68 65 20 56 44 42 45 20 73 68 6f 75 6c 64 20  the VDBE should 
ae70: 62 65 20 72 65 61 64 79 20 74 6f 20 62 65 20 65  be ready to be e
ae80: 78 65 63 75 74 65 64 0a 2a 2a 20 61 67 61 69 6e  xecuted.** again
ae90: 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20 6c 6f 6f 6b 20  ..**.** To look 
aea0: 61 74 20 69 74 20 61 6e 6f 74 68 65 72 20 77 61  at it another wa
aeb0: 79 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  y, this routine 
aec0: 72 65 73 65 74 73 20 74 68 65 20 73 74 61 74 65  resets the state
aed0: 20 6f 66 20 74 68 65 0a 2a 2a 20 76 69 72 74 75   of the.** virtu
aee0: 61 6c 20 6d 61 63 68 69 6e 65 20 66 72 6f 6d 20  al machine from 
aef0: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 6f  VDBE_MAGIC_RUN o
af00: 72 20 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  r VDBE_MAGIC_HAL
af10: 54 20 62 61 63 6b 20 74 6f 0a 2a 2a 20 56 44 42  T back to.** VDB
af20: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 2e 0a 2a 2f  E_MAGIC_INIT..*/
af30: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
af40: 52 65 73 65 74 28 56 64 62 65 20 2a 70 29 7b 0a  Reset(Vdbe *p){.
af50: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20    sqlite3 *db;. 
af60: 20 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 0a 20 20   db = p->db;..  
af70: 2f 2a 20 49 66 20 74 68 65 20 56 4d 20 64 69 64  /* If the VM did
af80: 20 6e 6f 74 20 72 75 6e 20 74 6f 20 63 6f 6d 70   not run to comp
af90: 6c 65 74 69 6f 6e 20 6f 72 20 69 66 20 69 74 20  letion or if it 
afa0: 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 6e 0a 20  encountered an. 
afb0: 20 2a 2a 20 65 72 72 6f 72 2c 20 74 68 65 6e 20   ** error, then 
afc0: 69 74 20 6d 69 67 68 74 20 6e 6f 74 20 68 61 76  it might not hav
afd0: 65 20 62 65 65 6e 20 68 61 6c 74 65 64 20 70 72  e been halted pr
afe0: 6f 70 65 72 6c 79 2e 20 20 53 6f 20 68 61 6c 74  operly.  So halt
aff0: 0a 20 20 2a 2a 20 69 74 20 6e 6f 77 2e 0a 20 20  .  ** it now..  
b000: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 53 61 66 65  */.  sqlite3Safe
b010: 74 79 4f 6e 28 64 62 29 3b 0a 20 20 73 71 6c 69  tyOn(db);.  sqli
b020: 74 65 33 56 64 62 65 48 61 6c 74 28 70 29 3b 0a  te3VdbeHalt(p);.
b030: 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f    sqlite3SafetyO
b040: 66 66 28 64 62 29 3b 0a 0a 20 20 2f 2a 20 49 66  ff(db);..  /* If
b050: 20 74 68 65 20 56 44 42 45 20 68 61 73 20 62 65   the VDBE has be
b060: 20 72 75 6e 20 65 76 65 6e 20 70 61 72 74 69 61   run even partia
b070: 6c 6c 79 2c 20 74 68 65 6e 20 74 72 61 6e 73 66  lly, then transf
b080: 65 72 20 74 68 65 20 65 72 72 6f 72 20 63 6f 64  er the error cod
b090: 65 0a 20 20 2a 2a 20 61 6e 64 20 65 72 72 6f 72  e.  ** and error
b0a0: 20 6d 65 73 73 61 67 65 20 66 72 6f 6d 20 74 68   message from th
b0b0: 65 20 56 44 42 45 20 69 6e 74 6f 20 74 68 65 20  e VDBE into the 
b0c0: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 73 74  main database st
b0d0: 72 75 63 74 75 72 65 2e 20 20 42 75 74 0a 20 20  ructure.  But.  
b0e0: 2a 2a 20 69 66 20 74 68 65 20 56 44 42 45 20 68  ** if the VDBE h
b0f0: 61 73 20 6a 75 73 74 20 62 65 65 6e 20 73 65 74  as just been set
b100: 20 74 6f 20 72 75 6e 20 62 75 74 20 68 61 73 20   to run but has 
b110: 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 65 78 65  not actually exe
b120: 63 75 74 65 64 20 61 6e 79 0a 20 20 2a 2a 20 69  cuted any.  ** i
b130: 6e 73 74 72 75 63 74 69 6f 6e 73 20 79 65 74 2c  nstructions yet,
b140: 20 6c 65 61 76 65 20 74 68 65 20 6d 61 69 6e 20   leave the main 
b150: 64 61 74 61 62 61 73 65 20 65 72 72 6f 72 20 69  database error i
b160: 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 6e 63 68 61  nformation uncha
b170: 6e 67 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  nged..  */.  if(
b180: 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20   p->pc>=0 ){.   
b190: 20 69 66 28 20 70 2d 3e 7a 45 72 72 4d 73 67 20   if( p->zErrMsg 
b1a0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
b1b0: 56 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d 3e  ValueSetStr(db->
b1c0: 70 45 72 72 2c 20 2d 31 2c 20 70 2d 3e 7a 45 72  pErr, -1, p->zEr
b1d0: 72 4d 73 67 2c 20 53 51 4c 49 54 45 5f 55 54 46  rMsg, SQLITE_UTF
b1e0: 38 2c 20 73 71 6c 69 74 65 33 46 72 65 65 58 29  8, sqlite3FreeX)
b1f0: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 65 72 72 43  ;.      db->errC
b200: 6f 64 65 20 3d 20 70 2d 3e 72 63 3b 0a 20 20 20  ode = p->rc;.   
b210: 20 20 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20     p->zErrMsg = 
b220: 30 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28  0;.    }else if(
b230: 20 70 2d 3e 72 63 20 29 7b 0a 20 20 20 20 20 20   p->rc ){.      
b240: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c  sqlite3Error(db,
b250: 20 70 2d 3e 72 63 2c 20 30 29 3b 0a 20 20 20 20   p->rc, 0);.    
b260: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
b270: 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51  ite3Error(db, SQ
b280: 4c 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20  LITE_OK, 0);.   
b290: 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70   }.  }else if( p
b2a0: 2d 3e 72 63 20 26 26 20 70 2d 3e 65 78 70 69 72  ->rc && p->expir
b2b0: 65 64 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65  ed ){.    /* The
b2c0: 20 65 78 70 69 72 65 64 20 66 6c 61 67 20 77 61   expired flag wa
b2d0: 73 20 73 65 74 20 6f 6e 20 74 68 65 20 56 44 42  s set on the VDB
b2e0: 45 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72  E before the fir
b2f0: 73 74 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74  st call.    ** t
b300: 6f 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  o sqlite3_step()
b310: 2e 20 46 6f 72 20 63 6f 6e 73 69 73 74 65 6e 63  . For consistenc
b320: 79 20 28 73 69 6e 63 65 20 73 71 6c 69 74 65 33  y (since sqlite3
b330: 5f 73 74 65 70 28 29 20 77 61 73 0a 20 20 20 20  _step() was.    
b340: 2a 2a 20 63 61 6c 6c 65 64 29 2c 20 73 65 74 20  ** called), set 
b350: 74 68 65 20 64 61 74 61 62 61 73 65 20 65 72 72  the database err
b360: 6f 72 20 69 6e 20 74 68 69 73 20 63 61 73 65 20  or in this case 
b370: 61 73 20 77 65 6c 6c 2e 0a 20 20 20 20 2a 2f 0a  as well..    */.
b380: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
b390: 28 64 62 2c 20 70 2d 3e 72 63 2c 20 30 29 3b 0a  (db, p->rc, 0);.
b3a0: 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 63 6c 61 69    }..  /* Reclai
b3b0: 6d 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 75 73 65  m all memory use
b3c0: 64 20 62 79 20 74 68 65 20 56 44 42 45 0a 20 20  d by the VDBE.  
b3d0: 2a 2f 0a 20 20 43 6c 65 61 6e 75 70 28 70 29 3b  */.  Cleanup(p);
b3e0: 0a 0a 20 20 2f 2a 20 53 61 76 65 20 70 72 6f 66  ..  /* Save prof
b3f0: 69 6c 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f  iling informatio
b400: 6e 20 66 72 6f 6d 20 74 68 69 73 20 56 44 42 45  n from this VDBE
b410: 20 72 75 6e 2e 0a 20 20 2a 2f 0a 20 20 61 73 73   run..  */.  ass
b420: 65 72 74 28 20 70 2d 3e 70 54 6f 73 3c 26 70 2d  ert( p->pTos<&p-
b430: 3e 61 53 74 61 63 6b 5b 70 2d 3e 70 63 3c 30 3f  >aStack[p->pc<0?
b440: 30 3a 70 2d 3e 70 63 5d 20 7c 7c 20 21 70 2d 3e  0:p->pc] || !p->
b450: 61 53 74 61 63 6b 20 29 3b 0a 23 69 66 64 65 66  aStack );.#ifdef
b460: 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 0a 20 20   VDBE_PROFILE.  
b470: 7b 0a 20 20 20 20 46 49 4c 45 20 2a 6f 75 74 20  {.    FILE *out 
b480: 3d 20 66 6f 70 65 6e 28 22 76 64 62 65 5f 70 72  = fopen("vdbe_pr
b490: 6f 66 69 6c 65 2e 6f 75 74 22 2c 20 22 61 22 29  ofile.out", "a")
b4a0: 3b 0a 20 20 20 20 69 66 28 20 6f 75 74 20 29 7b  ;.    if( out ){
b4b0: 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  .      int i;.  
b4c0: 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c      fprintf(out,
b4d0: 20 22 2d 2d 2d 2d 20 22 29 3b 0a 20 20 20 20 20   "---- ");.     
b4e0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e   for(i=0; i<p->n
b4f0: 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  Op; i++){.      
b500: 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c 20 22    fprintf(out, "
b510: 25 30 32 78 22 2c 20 70 2d 3e 61 4f 70 5b 69 5d  %02x", p->aOp[i]
b520: 2e 6f 70 63 6f 64 65 29 3b 0a 20 20 20 20 20 20  .opcode);.      
b530: 7d 0a 20 20 20 20 20 20 66 70 72 69 6e 74 66 28  }.      fprintf(
b540: 6f 75 74 2c 20 22 5c 6e 22 29 3b 0a 20 20 20 20  out, "\n");.    
b550: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
b560: 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  nOp; i++){.     
b570: 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c 20     fprintf(out, 
b580: 22 25 36 64 20 25 31 30 6c 6c 64 20 25 38 6c 6c  "%6d %10lld %8ll
b590: 64 20 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20  d ",.           
b5a0: 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 2c 0a 20  p->aOp[i].cnt,. 
b5b0: 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70            p->aOp
b5c0: 5b 69 5d 2e 63 79 63 6c 65 73 2c 0a 20 20 20 20  [i].cycles,.    
b5d0: 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d         p->aOp[i]
b5e0: 2e 63 6e 74 3e 30 20 3f 20 70 2d 3e 61 4f 70 5b  .cnt>0 ? p->aOp[
b5f0: 69 5d 2e 63 79 63 6c 65 73 2f 70 2d 3e 61 4f 70  i].cycles/p->aOp
b600: 5b 69 5d 2e 63 6e 74 20 3a 20 30 0a 20 20 20 20  [i].cnt : 0.    
b610: 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20 20 73      );.        s
b620: 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f  qlite3VdbePrintO
b630: 70 28 6f 75 74 2c 20 69 2c 20 26 70 2d 3e 61 4f  p(out, i, &p->aO
b640: 70 5b 69 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 20  p[i]);.      }. 
b650: 20 20 20 20 20 66 63 6c 6f 73 65 28 6f 75 74 29       fclose(out)
b660: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64  ;.    }.  }.#end
b670: 69 66 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20  if.  p->magic = 
b680: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 3b  VDBE_MAGIC_INIT;
b690: 0a 20 20 70 2d 3e 61 62 6f 72 74 65 64 20 3d 20  .  p->aborted = 
b6a0: 30 3b 0a 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d  0;.  if( p->rc==
b6b0: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b  SQLITE_SCHEMA ){
b6c0: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65  .    sqlite3Rese
b6d0: 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28  tInternalSchema(
b6e0: 64 62 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 72 65  db, 0);.  }.  re
b6f0: 74 75 72 6e 20 70 2d 3e 72 63 20 26 20 64 62 2d  turn p->rc & db-
b700: 3e 65 72 72 4d 61 73 6b 3b 0a 7d 0a 20 0a 2f 2a  >errMask;.}. ./*
b710: 0a 2a 2a 20 43 6c 65 61 6e 20 75 70 20 61 6e 64  .** Clean up and
b720: 20 64 65 6c 65 74 65 20 61 20 56 44 42 45 20 61   delete a VDBE a
b730: 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e 2e 20  fter execution. 
b740: 20 52 65 74 75 72 6e 20 61 6e 20 69 6e 74 65 67   Return an integ
b750: 65 72 20 77 68 69 63 68 20 69 73 0a 2a 2a 20 74  er which is.** t
b760: 68 65 20 72 65 73 75 6c 74 20 63 6f 64 65 2e 20  he result code. 
b770: 20 57 72 69 74 65 20 61 6e 79 20 65 72 72 6f 72   Write any error
b780: 20 6d 65 73 73 61 67 65 20 74 65 78 74 20 69 6e   message text in
b790: 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a 2a 2f  to *pzErrMsg..*/
b7a0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
b7b0: 46 69 6e 61 6c 69 7a 65 28 56 64 62 65 20 2a 70  Finalize(Vdbe *p
b7c0: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
b7d0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 70  LITE_OK;.  if( p
b7e0: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
b7f0: 47 49 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 6d 61  GIC_RUN || p->ma
b800: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
b810: 48 41 4c 54 20 29 7b 0a 20 20 20 20 72 63 20 3d  HALT ){.    rc =
b820: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 65   sqlite3VdbeRese
b830: 74 28 70 29 3b 0a 20 20 20 20 61 73 73 65 72 74  t(p);.    assert
b840: 28 20 28 72 63 20 26 20 70 2d 3e 64 62 2d 3e 65  ( (rc & p->db->e
b850: 72 72 4d 61 73 6b 29 3d 3d 72 63 20 29 3b 0a 20  rrMask)==rc );. 
b860: 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d 61   }else if( p->ma
b870: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
b880: 49 4e 49 54 20 29 7b 0a 20 20 20 20 72 65 74 75  INIT ){.    retu
b890: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45  rn SQLITE_MISUSE
b8a0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56  ;.  }.  sqlite3V
b8b0: 64 62 65 44 65 6c 65 74 65 28 70 29 3b 0a 20 20  dbeDelete(p);.  
b8c0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
b8d0: 0a 2a 2a 20 43 61 6c 6c 20 74 68 65 20 64 65 73  .** Call the des
b8e0: 74 72 75 63 74 6f 72 20 66 6f 72 20 65 61 63 68  tructor for each
b8f0: 20 61 75 78 64 61 74 61 20 65 6e 74 72 79 20 69   auxdata entry i
b900: 6e 20 70 56 64 62 65 46 75 6e 63 20 66 6f 72 20  n pVdbeFunc for 
b910: 77 68 69 63 68 0a 2a 2a 20 74 68 65 20 63 6f 72  which.** the cor
b920: 72 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 69  responding bit i
b930: 6e 20 6d 61 73 6b 20 69 73 20 63 6c 65 61 72 2e  n mask is clear.
b940: 20 20 41 75 78 64 61 74 61 20 65 6e 74 72 69 65    Auxdata entrie
b950: 73 20 62 65 79 6f 6e 64 20 33 31 0a 2a 2a 20 61  s beyond 31.** a
b960: 72 65 20 61 6c 77 61 79 73 20 64 65 73 74 72 6f  re always destro
b970: 79 65 64 2e 20 20 54 6f 20 64 65 73 74 72 6f 79  yed.  To destroy
b980: 20 61 6c 6c 20 61 75 78 64 61 74 61 20 65 6e 74   all auxdata ent
b990: 72 69 65 73 2c 20 63 61 6c 6c 20 74 68 69 73 0a  ries, call this.
b9a0: 2a 2a 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20  ** routine with 
b9b0: 6d 61 73 6b 3d 3d 30 2e 0a 2a 2f 0a 76 6f 69 64  mask==0..*/.void
b9c0: 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65   sqlite3VdbeDele
b9d0: 74 65 41 75 78 44 61 74 61 28 56 64 62 65 46 75  teAuxData(VdbeFu
b9e0: 6e 63 20 2a 70 56 64 62 65 46 75 6e 63 2c 20 69  nc *pVdbeFunc, i
b9f0: 6e 74 20 6d 61 73 6b 29 7b 0a 20 20 69 6e 74 20  nt mask){.  int 
ba00: 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  i;.  for(i=0; i<
ba10: 70 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 3b  pVdbeFunc->nAux;
ba20: 20 69 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63   i++){.    struc
ba30: 74 20 41 75 78 44 61 74 61 20 2a 70 41 75 78 20  t AuxData *pAux 
ba40: 3d 20 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 70  = &pVdbeFunc->ap
ba50: 41 75 78 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20  Aux[i];.    if( 
ba60: 28 69 3e 33 31 20 7c 7c 20 21 28 6d 61 73 6b 26  (i>31 || !(mask&
ba70: 28 31 3c 3c 69 29 29 29 20 26 26 20 70 41 75 78  (1<<i))) && pAux
ba80: 2d 3e 70 41 75 78 20 29 7b 0a 20 20 20 20 20 20  ->pAux ){.      
ba90: 69 66 28 20 70 41 75 78 2d 3e 78 44 65 6c 65 74  if( pAux->xDelet
baa0: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 70 41 75  e ){.        pAu
bab0: 78 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 2d  x->xDelete(pAux-
bac0: 3e 70 41 75 78 29 3b 0a 20 20 20 20 20 20 7d 0a  >pAux);.      }.
bad0: 20 20 20 20 20 20 70 41 75 78 2d 3e 70 41 75 78        pAux->pAux
bae0: 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a   = 0;.    }.  }.
baf0: 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20  }../*.** Delete 
bb00: 61 6e 20 65 6e 74 69 72 65 20 56 44 42 45 2e 0a  an entire VDBE..
bb10: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
bb20: 64 62 65 44 65 6c 65 74 65 28 56 64 62 65 20 2a  dbeDelete(Vdbe *
bb30: 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  p){.  int i;.  i
bb40: 66 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e  f( p==0 ) return
bb50: 3b 0a 20 20 43 6c 65 61 6e 75 70 28 70 29 3b 0a  ;.  Cleanup(p);.
bb60: 20 20 69 66 28 20 70 2d 3e 70 50 72 65 76 20 29    if( p->pPrev )
bb70: 7b 0a 20 20 20 20 70 2d 3e 70 50 72 65 76 2d 3e  {.    p->pPrev->
bb80: 70 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74  pNext = p->pNext
bb90: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61  ;.  }else{.    a
bba0: 73 73 65 72 74 28 20 70 2d 3e 64 62 2d 3e 70 56  ssert( p->db->pV
bbb0: 64 62 65 3d 3d 70 20 29 3b 0a 20 20 20 20 70 2d  dbe==p );.    p-
bbc0: 3e 64 62 2d 3e 70 56 64 62 65 20 3d 20 70 2d 3e  >db->pVdbe = p->
bbd0: 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28  pNext;.  }.  if(
bbe0: 20 70 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20   p->pNext ){.   
bbf0: 20 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76   p->pNext->pPrev
bc00: 20 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 20 20 7d   = p->pPrev;.  }
bc10: 0a 20 20 69 66 28 20 70 2d 3e 61 4f 70 20 29 7b  .  if( p->aOp ){
bc20: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
bc30: 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20  p->nOp; i++){.  
bc40: 20 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26 70      Op *pOp = &p
bc50: 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 20 20  ->aOp[i];.      
bc60: 66 72 65 65 50 33 28 70 4f 70 2d 3e 70 33 74 79  freeP3(pOp->p3ty
bc70: 70 65 2c 20 70 4f 70 2d 3e 70 33 29 3b 0a 20 20  pe, pOp->p3);.  
bc80: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 46 72    }.    sqliteFr
bc90: 65 65 28 70 2d 3e 61 4f 70 29 3b 0a 20 20 7d 0a  ee(p->aOp);.  }.
bca0: 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61    releaseMemArra
bcb0: 79 28 70 2d 3e 61 56 61 72 2c 20 70 2d 3e 6e 56  y(p->aVar, p->nV
bcc0: 61 72 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65  ar);.  sqliteFre
bcd0: 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20  e(p->aLabel);.  
bce0: 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 53  sqliteFree(p->aS
bcf0: 74 61 63 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65  tack);.  release
bd00: 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 43 6f 6c  MemArray(p->aCol
bd10: 4e 61 6d 65 2c 20 70 2d 3e 6e 52 65 73 43 6f 6c  Name, p->nResCol
bd20: 75 6d 6e 2a 43 4f 4c 4e 41 4d 45 5f 4e 29 3b 0a  umn*COLNAME_N);.
bd30: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
bd40: 61 43 6f 6c 4e 61 6d 65 29 3b 0a 20 20 73 71 6c  aColName);.  sql
bd50: 69 74 65 46 72 65 65 28 70 2d 3e 7a 53 71 6c 29  iteFree(p->zSql)
bd60: 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56  ;.  p->magic = V
bd70: 44 42 45 5f 4d 41 47 49 43 5f 44 45 41 44 3b 0a  DBE_MAGIC_DEAD;.
bd80: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 29 3b    sqliteFree(p);
bd90: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 61 20 4d  .}../*.** If a M
bda0: 6f 76 65 54 6f 20 6f 70 65 72 61 74 69 6f 6e 20  oveTo operation 
bdb0: 69 73 20 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68  is pending on th
bdc0: 65 20 67 69 76 65 6e 20 63 75 72 73 6f 72 2c 20  e given cursor, 
bdd0: 74 68 65 6e 20 64 6f 20 74 68 61 74 0a 2a 2a 20  then do that.** 
bde0: 4d 6f 76 65 54 6f 20 6e 6f 77 2e 20 20 52 65 74  MoveTo now.  Ret
bdf0: 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64  urn an error cod
be00: 65 2e 20 20 49 66 20 6e 6f 20 4d 6f 76 65 54 6f  e.  If no MoveTo
be10: 20 69 73 20 70 65 6e 64 69 6e 67 2c 20 74 68 69   is pending, thi
be20: 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 64 6f 65  s.** routine doe
be30: 73 20 6e 6f 74 68 69 6e 67 20 61 6e 64 20 72 65  s nothing and re
be40: 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e  turns SQLITE_OK.
be50: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
be60: 64 62 65 43 75 72 73 6f 72 4d 6f 76 65 74 6f 28  dbeCursorMoveto(
be70: 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 69 66  Cursor *p){.  if
be80: 28 20 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76  ( p->deferredMov
be90: 65 74 6f 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  eto ){.    int r
bea0: 65 73 2c 20 72 63 3b 0a 23 69 66 64 65 66 20 53  es, rc;.#ifdef S
beb0: 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 20 20 65  QLITE_TEST.    e
bec0: 78 74 65 72 6e 20 69 6e 74 20 73 71 6c 69 74 65  xtern int sqlite
bed0: 33 5f 73 65 61 72 63 68 5f 63 6f 75 6e 74 3b 0a  3_search_count;.
bee0: 23 65 6e 64 69 66 0a 20 20 20 20 61 73 73 65 72  #endif.    asser
bef0: 74 28 20 70 2d 3e 69 73 54 61 62 6c 65 20 29 3b  t( p->isTable );
bf00: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
bf10: 33 42 74 72 65 65 4d 6f 76 65 74 6f 28 70 2d 3e  3BtreeMoveto(p->
bf20: 70 43 75 72 73 6f 72 2c 20 30 2c 20 70 2d 3e 6d  pCursor, 0, p->m
bf30: 6f 76 65 74 6f 54 61 72 67 65 74 2c 20 30 2c 20  ovetoTarget, 0, 
bf40: 26 72 65 73 29 3b 0a 20 20 20 20 69 66 28 20 72  &res);.    if( r
bf50: 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20  c ) return rc;. 
bf60: 20 20 20 2a 70 2d 3e 70 49 6e 63 72 4b 65 79 20     *p->pIncrKey 
bf70: 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 6c 61 73 74  = 0;.    p->last
bf80: 52 6f 77 69 64 20 3d 20 6b 65 79 54 6f 49 6e 74  Rowid = keyToInt
bf90: 28 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74  (p->movetoTarget
bfa0: 29 3b 0a 20 20 20 20 70 2d 3e 72 6f 77 69 64 49  );.    p->rowidI
bfb0: 73 56 61 6c 69 64 20 3d 20 72 65 73 3d 3d 30 3b  sValid = res==0;
bfc0: 0a 20 20 20 20 69 66 28 20 72 65 73 3c 30 20 29  .    if( res<0 )
bfd0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c  {.      rc = sql
bfe0: 69 74 65 33 42 74 72 65 65 4e 65 78 74 28 70 2d  ite3BtreeNext(p-
bff0: 3e 70 43 75 72 73 6f 72 2c 20 26 72 65 73 29 3b  >pCursor, &res);
c000: 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20  .      if( rc ) 
c010: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d  return rc;.    }
c020: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54  .#ifdef SQLITE_T
c030: 45 53 54 0a 20 20 20 20 73 71 6c 69 74 65 33 5f  EST.    sqlite3_
c040: 73 65 61 72 63 68 5f 63 6f 75 6e 74 2b 2b 3b 0a  search_count++;.
c050: 23 65 6e 64 69 66 0a 20 20 20 20 70 2d 3e 64 65  #endif.    p->de
c060: 66 65 72 72 65 64 4d 6f 76 65 74 6f 20 3d 20 30  ferredMoveto = 0
c070: 3b 0a 20 20 20 20 70 2d 3e 63 61 63 68 65 53 74  ;.    p->cacheSt
c080: 61 74 75 73 20 3d 20 43 41 43 48 45 5f 53 54 41  atus = CACHE_STA
c090: 4c 45 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  LE;.  }.  return
c0a0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
c0b0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
c0c0: 6e 67 20 66 75 6e 63 74 69 6f 6e 73 3a 0a 2a 2a  ng functions:.**
c0d0: 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53  .** sqlite3VdbeS
c0e0: 65 72 69 61 6c 54 79 70 65 28 29 0a 2a 2a 20 73  erialType().** s
c0f0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
c100: 54 79 70 65 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c  TypeLen().** sql
c110: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 52 65  ite3VdbeSerialRe
c120: 61 64 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56  ad().** sqlite3V
c130: 64 62 65 53 65 72 69 61 6c 4c 65 6e 28 29 0a 2a  dbeSerialLen().*
c140: 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  * sqlite3VdbeSer
c150: 69 61 6c 57 72 69 74 65 28 29 0a 2a 2a 0a 2a 2a  ialWrite().**.**
c160: 20 65 6e 63 61 70 73 75 6c 61 74 65 20 74 68 65   encapsulate the
c170: 20 63 6f 64 65 20 74 68 61 74 20 73 65 72 69 61   code that seria
c180: 6c 69 7a 65 73 20 76 61 6c 75 65 73 20 66 6f 72  lizes values for
c190: 20 73 74 6f 72 61 67 65 20 69 6e 20 53 51 4c 69   storage in SQLi
c1a0: 74 65 0a 2a 2a 20 64 61 74 61 20 61 6e 64 20 69  te.** data and i
c1b0: 6e 64 65 78 20 72 65 63 6f 72 64 73 2e 20 45 61  ndex records. Ea
c1c0: 63 68 20 73 65 72 69 61 6c 69 7a 65 64 20 76 61  ch serialized va
c1d0: 6c 75 65 20 63 6f 6e 73 69 73 74 73 20 6f 66 20  lue consists of 
c1e0: 61 0a 2a 2a 20 27 73 65 72 69 61 6c 2d 74 79 70  a.** 'serial-typ
c1f0: 65 27 20 61 6e 64 20 61 20 62 6c 6f 62 20 6f 66  e' and a blob of
c200: 20 64 61 74 61 2e 20 54 68 65 20 73 65 72 69 61   data. The seria
c210: 6c 20 74 79 70 65 20 69 73 20 61 6e 20 38 2d 62  l type is an 8-b
c220: 79 74 65 20 75 6e 73 69 67 6e 65 64 0a 2a 2a 20  yte unsigned.** 
c230: 69 6e 74 65 67 65 72 2c 20 73 74 6f 72 65 64 20  integer, stored 
c240: 61 73 20 61 20 76 61 72 69 6e 74 2e 0a 2a 2a 0a  as a varint..**.
c250: 2a 2a 20 49 6e 20 61 6e 20 53 51 4c 69 74 65 20  ** In an SQLite 
c260: 69 6e 64 65 78 20 72 65 63 6f 72 64 2c 20 74 68  index record, th
c270: 65 20 73 65 72 69 61 6c 20 74 79 70 65 20 69 73  e serial type is
c280: 20 73 74 6f 72 65 64 20 64 69 72 65 63 74 6c 79   stored directly
c290: 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 65 20 62   before.** the b
c2a0: 6c 6f 62 20 6f 66 20 64 61 74 61 20 74 68 61 74  lob of data that
c2b0: 20 69 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20   it corresponds 
c2c0: 74 6f 2e 20 49 6e 20 61 20 74 61 62 6c 65 20 72  to. In a table r
c2d0: 65 63 6f 72 64 2c 20 61 6c 6c 20 73 65 72 69 61  ecord, all seria
c2e0: 6c 0a 2a 2a 20 74 79 70 65 73 20 61 72 65 20 73  l.** types are s
c2f0: 74 6f 72 65 64 20 61 74 20 74 68 65 20 73 74 61  tored at the sta
c300: 72 74 20 6f 66 20 74 68 65 20 72 65 63 6f 72 64  rt of the record
c310: 2c 20 61 6e 64 20 74 68 65 20 62 6c 6f 62 73 20  , and the blobs 
c320: 6f 66 20 64 61 74 61 20 61 74 0a 2a 2a 20 74 68  of data at.** th
c330: 65 20 65 6e 64 2e 20 48 65 6e 63 65 20 74 68 65  e end. Hence the
c340: 73 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 6c 6c  se functions all
c350: 6f 77 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f  ow the caller to
c360: 20 68 61 6e 64 6c 65 20 74 68 65 0a 2a 2a 20 73   handle the.** s
c370: 65 72 69 61 6c 2d 74 79 70 65 20 61 6e 64 20 64  erial-type and d
c380: 61 74 61 20 62 6c 6f 62 20 73 65 70 65 72 61 74  ata blob seperat
c390: 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66  ely..**.** The f
c3a0: 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65 20 64  ollowing table d
c3b0: 65 73 63 72 69 62 65 73 20 74 68 65 20 76 61 72  escribes the var
c3c0: 69 6f 75 73 20 73 74 6f 72 61 67 65 20 63 6c 61  ious storage cla
c3d0: 73 73 65 73 20 66 6f 72 20 64 61 74 61 3a 0a 2a  sses for data:.*
c3e0: 2a 0a 2a 2a 20 20 20 73 65 72 69 61 6c 20 74 79  *.**   serial ty
c3f0: 70 65 20 20 20 20 20 20 20 20 62 79 74 65 73 20  pe        bytes 
c400: 6f 66 20 64 61 74 61 20 20 20 20 20 20 74 79 70  of data      typ
c410: 65 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  e.**   ---------
c420: 2d 2d 2d 2d 2d 20 20 20 20 20 2d 2d 2d 2d 2d 2d  -----     ------
c430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 2d 2d 2d  ---------    ---
c440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
c450: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
c460: 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20 20             0    
c470: 20 20 20 20 20 20 20 20 4e 55 4c 4c 0a 2a 2a 20          NULL.** 
c480: 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20       1          
c490: 20 20 20 20 20 20 20 20 20 20 20 31 20 20 20 20             1    
c4a0: 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69          signed i
c4b0: 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 32  nteger.**      2
c4c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c4d0: 20 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20       2          
c4e0: 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72    signed integer
c4f0: 0a 2a 2a 20 20 20 20 20 20 33 20 20 20 20 20 20  .**      3      
c500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 33                 3
c510: 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e              sign
c520: 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20  ed integer.**   
c530: 20 20 20 34 20 20 20 20 20 20 20 20 20 20 20 20     4            
c540: 20 20 20 20 20 20 20 20 20 34 20 20 20 20 20 20           4      
c550: 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74        signed int
c560: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 35 20 20  eger.**      5  
c570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c580: 20 20 20 36 20 20 20 20 20 20 20 20 20 20 20 20     6            
c590: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a  signed integer.*
c5a0: 2a 20 20 20 20 20 20 36 20 20 20 20 20 20 20 20  *      6        
c5b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 38 20 20               8  
c5c0: 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64            signed
c5d0: 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20   integer.**     
c5e0: 20 37 20 20 20 20 20 20 20 20 20 20 20 20 20 20   7              
c5f0: 20 20 20 20 20 20 20 38 20 20 20 20 20 20 20 20         8        
c600: 20 20 20 20 49 45 45 45 20 66 6c 6f 61 74 0a 2a      IEEE float.*
c610: 2a 20 20 20 20 20 20 38 20 20 20 20 20 20 20 20  *      8        
c620: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 20 20               0  
c630: 20 20 20 20 20 20 20 20 20 20 49 6e 74 65 67 65            Intege
c640: 72 20 63 6f 6e 73 74 61 6e 74 20 30 0a 2a 2a 20  r constant 0.** 
c650: 20 20 20 20 20 39 20 20 20 20 20 20 20 20 20 20       9          
c660: 20 20 20 20 20 20 20 20 20 20 20 30 20 20 20 20             0    
c670: 20 20 20 20 20 20 20 20 49 6e 74 65 67 65 72 20          Integer 
c680: 63 6f 6e 73 74 61 6e 74 20 31 0a 2a 2a 20 20 20  constant 1.**   
c690: 20 20 31 30 2c 31 31 20 20 20 20 20 20 20 20 20    10,11         
c6a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c6b0: 20 20 20 20 20 20 72 65 73 65 72 76 65 64 20 66        reserved f
c6c0: 6f 72 20 65 78 70 61 6e 73 69 6f 6e 0a 2a 2a 20  or expansion.** 
c6d0: 20 20 20 4e 3e 3d 31 32 20 61 6e 64 20 65 76 65     N>=12 and eve
c6e0: 6e 20 20 20 20 20 20 20 28 4e 2d 31 32 29 2f 32  n       (N-12)/2
c6f0: 20 20 20 20 20 20 20 20 42 4c 4f 42 0a 2a 2a 20          BLOB.** 
c700: 20 20 20 4e 3e 3d 31 33 20 61 6e 64 20 6f 64 64     N>=13 and odd
c710: 20 20 20 20 20 20 20 20 28 4e 2d 31 33 29 2f 32          (N-13)/2
c720: 20 20 20 20 20 20 20 20 74 65 78 74 0a 2a 2a 0a          text.**.
c730: 2a 2a 20 54 68 65 20 38 20 61 6e 64 20 39 20 74  ** The 8 and 9 t
c740: 79 70 65 73 20 77 65 72 65 20 61 64 64 65 64 20  ypes were added 
c750: 69 6e 20 33 2e 33 2e 30 2c 20 66 69 6c 65 20 66  in 3.3.0, file f
c760: 6f 72 6d 61 74 20 34 2e 20 20 50 72 69 6f 72 20  ormat 4.  Prior 
c770: 76 65 72 73 69 6f 6e 73 0a 2a 2a 20 6f 66 20 53  versions.** of S
c780: 51 4c 69 74 65 20 77 69 6c 6c 20 6e 6f 74 20 75  QLite will not u
c790: 6e 64 65 72 73 74 61 6e 64 20 74 68 6f 73 65 20  nderstand those 
c7a0: 73 65 72 69 61 6c 20 74 79 70 65 73 2e 0a 2a 2f  serial types..*/
c7b0: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
c7c0: 68 65 20 73 65 72 69 61 6c 2d 74 79 70 65 20 66  he serial-type f
c7d0: 6f 72 20 74 68 65 20 76 61 6c 75 65 20 73 74 6f  or the value sto
c7e0: 72 65 64 20 69 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a  red in pMem..*/.
c7f0: 75 33 32 20 73 71 6c 69 74 65 33 56 64 62 65 53  u32 sqlite3VdbeS
c800: 65 72 69 61 6c 54 79 70 65 28 4d 65 6d 20 2a 70  erialType(Mem *p
c810: 4d 65 6d 2c 20 69 6e 74 20 66 69 6c 65 5f 66 6f  Mem, int file_fo
c820: 72 6d 61 74 29 7b 0a 20 20 69 6e 74 20 66 6c 61  rmat){.  int fla
c830: 67 73 20 3d 20 70 4d 65 6d 2d 3e 66 6c 61 67 73  gs = pMem->flags
c840: 3b 0a 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 69 66  ;.  int n;..  if
c850: 28 20 66 6c 61 67 73 26 4d 45 4d 5f 4e 75 6c 6c  ( flags&MEM_Null
c860: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30   ){.    return 0
c870: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67  ;.  }.  if( flag
c880: 73 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20 20 20  s&MEM_Int ){.   
c890: 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74 20 77   /* Figure out w
c8a0: 68 65 74 68 65 72 20 74 6f 20 75 73 65 20 31 2c  hether to use 1,
c8b0: 20 32 2c 20 34 2c 20 36 20 6f 72 20 38 20 62 79   2, 4, 6 or 8 by
c8c0: 74 65 73 2e 20 2a 2f 0a 23 20 20 20 64 65 66 69  tes. */.#   defi
c8d0: 6e 65 20 4d 41 58 5f 36 42 59 54 45 20 28 28 28  ne MAX_6BYTE (((
c8e0: 28 69 36 34 29 30 78 30 30 30 30 31 30 30 30 29  (i64)0x00001000)
c8f0: 3c 3c 33 32 29 2d 31 29 0a 20 20 20 20 69 36 34  <<32)-1).    i64
c900: 20 69 20 3d 20 70 4d 65 6d 2d 3e 75 2e 69 3b 0a   i = pMem->u.i;.
c910: 20 20 20 20 75 36 34 20 75 3b 0a 20 20 20 20 69      u64 u;.    i
c920: 66 28 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 3d  f( file_format>=
c930: 34 20 26 26 20 28 69 26 31 29 3d 3d 69 20 29 7b  4 && (i&1)==i ){
c940: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 38 2b  .      return 8+
c950: 69 3b 0a 20 20 20 20 7d 0a 20 20 20 20 75 20 3d  i;.    }.    u =
c960: 20 69 3c 30 20 3f 20 2d 69 20 3a 20 69 3b 0a 20   i<0 ? -i : i;. 
c970: 20 20 20 69 66 28 20 75 3c 3d 31 32 37 20 29 20     if( u<=127 ) 
c980: 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 69 66  return 1;.    if
c990: 28 20 75 3c 3d 33 32 37 36 37 20 29 20 72 65 74  ( u<=32767 ) ret
c9a0: 75 72 6e 20 32 3b 0a 20 20 20 20 69 66 28 20 75  urn 2;.    if( u
c9b0: 3c 3d 38 33 38 38 36 30 37 20 29 20 72 65 74 75  <=8388607 ) retu
c9c0: 72 6e 20 33 3b 0a 20 20 20 20 69 66 28 20 75 3c  rn 3;.    if( u<
c9d0: 3d 32 31 34 37 34 38 33 36 34 37 20 29 20 72 65  =2147483647 ) re
c9e0: 74 75 72 6e 20 34 3b 0a 20 20 20 20 69 66 28 20  turn 4;.    if( 
c9f0: 75 3c 3d 4d 41 58 5f 36 42 59 54 45 20 29 20 72  u<=MAX_6BYTE ) r
ca00: 65 74 75 72 6e 20 35 3b 0a 20 20 20 20 72 65 74  eturn 5;.    ret
ca10: 75 72 6e 20 36 3b 0a 20 20 7d 0a 20 20 69 66 28  urn 6;.  }.  if(
ca20: 20 66 6c 61 67 73 26 4d 45 4d 5f 52 65 61 6c 20   flags&MEM_Real 
ca30: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 37 3b  ){.    return 7;
ca40: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 66  .  }.  assert( f
ca50: 6c 61 67 73 26 28 4d 45 4d 5f 53 74 72 7c 4d 45  lags&(MEM_Str|ME
ca60: 4d 5f 42 6c 6f 62 29 20 29 3b 0a 20 20 6e 20 3d  M_Blob) );.  n =
ca70: 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 69 66 28 20   pMem->n;.  if( 
ca80: 66 6c 61 67 73 20 26 20 4d 45 4d 5f 5a 65 72 6f  flags & MEM_Zero
ca90: 20 29 7b 0a 20 20 20 20 6e 20 2b 3d 20 70 4d 65   ){.    n += pMe
caa0: 6d 2d 3e 75 2e 69 3b 0a 20 20 7d 0a 20 20 61 73  m->u.i;.  }.  as
cab0: 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a 20 20  sert( n>=0 );.  
cac0: 72 65 74 75 72 6e 20 28 28 6e 2a 32 29 20 2b 20  return ((n*2) + 
cad0: 31 32 20 2b 20 28 28 66 6c 61 67 73 26 4d 45 4d  12 + ((flags&MEM
cae0: 5f 53 74 72 29 21 3d 30 29 29 3b 0a 7d 0a 0a 2f  _Str)!=0));.}../
caf0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
cb00: 6c 65 6e 67 74 68 20 6f 66 20 74 68 65 20 64 61  length of the da
cb10: 74 61 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  ta corresponding
cb20: 20 74 6f 20 74 68 65 20 73 75 70 70 6c 69 65 64   to the supplied
cb30: 20 73 65 72 69 61 6c 2d 74 79 70 65 2e 0a 2a 2f   serial-type..*/
cb40: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
cb50: 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 75 33  SerialTypeLen(u3
cb60: 32 20 73 65 72 69 61 6c 5f 74 79 70 65 29 7b 0a  2 serial_type){.
cb70: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
cb80: 65 3e 3d 31 32 20 29 7b 0a 20 20 20 20 72 65 74  e>=12 ){.    ret
cb90: 75 72 6e 20 28 73 65 72 69 61 6c 5f 74 79 70 65  urn (serial_type
cba0: 2d 31 32 29 2f 32 3b 0a 20 20 7d 65 6c 73 65 7b  -12)/2;.  }else{
cbb0: 0a 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e 73  .    static cons
cbc0: 74 20 75 38 20 61 53 69 7a 65 5b 5d 20 3d 20 7b  t u8 aSize[] = {
cbd0: 20 30 2c 20 31 2c 20 32 2c 20 33 2c 20 34 2c 20   0, 1, 2, 3, 4, 
cbe0: 36 2c 20 38 2c 20 38 2c 20 30 2c 20 30 2c 20 30  6, 8, 8, 0, 0, 0
cbf0: 2c 20 30 20 7d 3b 0a 20 20 20 20 72 65 74 75 72  , 0 };.    retur
cc00: 6e 20 61 53 69 7a 65 5b 73 65 72 69 61 6c 5f 74  n aSize[serial_t
cc10: 79 70 65 5d 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  ype];.  }.}../*.
cc20: 2a 2a 20 49 66 20 77 65 20 61 72 65 20 6f 6e 20  ** If we are on 
cc30: 61 6e 20 61 72 63 68 69 74 65 63 74 75 72 65 20  an architecture 
cc40: 77 69 74 68 20 6d 69 78 65 64 2d 65 6e 64 69 61  with mixed-endia
cc50: 6e 20 66 6c 6f 61 74 69 6e 67 20 0a 2a 2a 2a 20  n floating .*** 
cc60: 70 6f 69 6e 74 73 20 28 65 78 3a 20 41 52 4d 37  points (ex: ARM7
cc70: 29 20 74 68 65 6e 20 73 77 61 70 20 74 68 65 20  ) then swap the 
cc80: 6c 6f 77 65 72 20 34 20 62 79 74 65 73 20 77 69  lower 4 bytes wi
cc90: 74 68 20 74 68 65 20 0a 2a 2a 20 75 70 70 65 72  th the .** upper
cca0: 20 34 20 62 79 74 65 73 2e 20 20 52 65 74 75 72   4 bytes.  Retur
ccb0: 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 2a 2a  n the result..**
ccc0: 0a 2a 2a 20 46 6f 72 20 6d 6f 73 74 20 28 73 61  .** For most (sa
ccd0: 6e 65 29 20 61 72 63 68 69 74 65 63 74 75 72 65  ne) architecture
cce0: 73 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f 2d  s, this is a no-
ccf0: 6f 70 2e 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51  op..*/.#ifdef SQ
cd00: 4c 49 54 45 5f 4d 49 58 45 44 5f 45 4e 44 49 41  LITE_MIXED_ENDIA
cd10: 4e 5f 36 34 42 49 54 5f 46 4c 4f 41 54 0a 73 74  N_64BIT_FLOAT.st
cd20: 61 74 69 63 20 64 6f 75 62 6c 65 20 66 6c 6f 61  atic double floa
cd30: 74 53 77 61 70 28 64 6f 75 62 6c 65 20 69 6e 29  tSwap(double in)
cd40: 7b 0a 20 20 75 6e 69 6f 6e 20 7b 0a 20 20 20 20  {.  union {.    
cd50: 64 6f 75 62 6c 65 20 72 3b 0a 20 20 20 20 75 33  double r;.    u3
cd60: 32 20 69 5b 32 5d 3b 0a 20 20 7d 20 75 3b 0a 20  2 i[2];.  } u;. 
cd70: 20 75 33 32 20 74 3b 0a 0a 20 20 75 2e 72 20 3d   u32 t;..  u.r =
cd80: 20 69 6e 3b 0a 20 20 74 20 3d 20 75 2e 69 5b 30   in;.  t = u.i[0
cd90: 5d 3b 0a 20 20 75 2e 69 5b 30 5d 20 3d 20 75 2e  ];.  u.i[0] = u.
cda0: 69 5b 31 5d 3b 0a 20 20 75 2e 69 5b 31 5d 20 3d  i[1];.  u.i[1] =
cdb0: 20 74 3b 0a 20 20 72 65 74 75 72 6e 20 75 2e 72   t;.  return u.r
cdc0: 3b 0a 7d 0a 23 20 64 65 66 69 6e 65 20 73 77 61  ;.}.# define swa
cdd0: 70 4d 69 78 65 64 45 6e 64 69 61 6e 46 6c 6f 61  pMixedEndianFloa
cde0: 74 28 58 29 20 20 58 20 3d 20 66 6c 6f 61 74 53  t(X)  X = floatS
cdf0: 77 61 70 28 58 29 0a 23 65 6c 73 65 0a 23 20 64  wap(X).#else.# d
ce00: 65 66 69 6e 65 20 73 77 61 70 4d 69 78 65 64 45  efine swapMixedE
ce10: 6e 64 69 61 6e 46 6c 6f 61 74 28 58 29 0a 23 65  ndianFloat(X).#e
ce20: 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74  ndif../*.** Writ
ce30: 65 20 74 68 65 20 73 65 72 69 61 6c 69 7a 65 64  e the serialized
ce40: 20 64 61 74 61 20 62 6c 6f 62 20 66 6f 72 20 74   data blob for t
ce50: 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20  he value stored 
ce60: 69 6e 20 70 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a  in pMem into .**
ce70: 20 62 75 66 2e 20 49 74 20 69 73 20 61 73 73 75   buf. It is assu
ce80: 6d 65 64 20 74 68 61 74 20 74 68 65 20 63 61 6c  med that the cal
ce90: 6c 65 72 20 68 61 73 20 61 6c 6c 6f 63 61 74 65  ler has allocate
cea0: 64 20 73 75 66 66 69 63 69 65 6e 74 20 73 70 61  d sufficient spa
ceb0: 63 65 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68  ce..** Return th
cec0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  e number of byte
ced0: 73 20 77 72 69 74 74 65 6e 2e 0a 2a 2a 0a 2a 2a  s written..**.**
cee0: 20 6e 42 75 66 20 69 73 20 74 68 65 20 61 6d 6f   nBuf is the amo
cef0: 75 6e 74 20 6f 66 20 73 70 61 63 65 20 6c 65 66  unt of space lef
cf00: 74 20 69 6e 20 62 75 66 5b 5d 2e 20 20 6e 42 75  t in buf[].  nBu
cf10: 66 20 6d 75 73 74 20 61 6c 77 61 79 73 20 62 65  f must always be
cf20: 0a 2a 2a 20 6c 61 72 67 65 20 65 6e 6f 75 67 68  .** large enough
cf30: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 65 6e 74   to hold the ent
cf40: 69 72 65 20 66 69 65 6c 64 2e 20 20 45 78 63 65  ire field.  Exce
cf50: 70 74 2c 20 69 66 20 74 68 65 20 66 69 65 6c 64  pt, if the field
cf60: 20 69 73 0a 2a 2a 20 61 20 62 6c 6f 62 20 77 69   is.** a blob wi
cf70: 74 68 20 61 20 7a 65 72 6f 2d 66 69 6c 6c 65 64  th a zero-filled
cf80: 20 74 61 69 6c 2c 20 74 68 65 6e 20 62 75 66 5b   tail, then buf[
cf90: 5d 20 6d 69 67 68 74 20 62 65 20 6a 75 73 74 20  ] might be just 
cfa0: 74 68 65 20 72 69 67 68 74 0a 2a 2a 20 73 69 7a  the right.** siz
cfb0: 65 20 74 6f 20 68 6f 6c 64 20 65 76 65 72 79 74  e to hold everyt
cfc0: 68 69 6e 67 20 65 78 63 65 70 74 20 66 6f 72 20  hing except for 
cfd0: 74 68 65 20 7a 65 72 6f 2d 66 69 6c 6c 65 64 20  the zero-filled 
cfe0: 74 61 69 6c 2e 20 20 49 66 20 62 75 66 5b 5d 0a  tail.  If buf[].
cff0: 2a 2a 20 69 73 20 6f 6e 6c 79 20 62 69 67 20 65  ** is only big e
d000: 6e 6f 75 67 68 20 74 6f 20 68 6f 6c 64 20 74 68  nough to hold th
d010: 65 20 6e 6f 6e 2d 7a 65 72 6f 20 70 72 65 66 69  e non-zero prefi
d020: 78 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 77 72 69  x, then only wri
d030: 74 65 20 74 68 61 74 0a 2a 2a 20 70 72 65 66 69  te that.** prefi
d040: 78 20 69 6e 74 6f 20 62 75 66 5b 5d 2e 20 20 42  x into buf[].  B
d050: 75 74 20 69 66 20 62 75 66 5b 5d 20 69 73 20 6c  ut if buf[] is l
d060: 61 72 67 65 20 65 6e 6f 75 67 68 20 74 6f 20 68  arge enough to h
d070: 6f 6c 64 20 62 6f 74 68 20 74 68 65 0a 2a 2a 20  old both the.** 
d080: 70 72 65 66 69 78 20 61 6e 64 20 74 68 65 20 74  prefix and the t
d090: 61 69 6c 20 74 68 65 6e 20 77 72 69 74 65 20 74  ail then write t
d0a0: 68 65 20 70 72 65 66 69 78 20 61 6e 64 20 73 65  he prefix and se
d0b0: 74 20 74 68 65 20 74 61 69 6c 20 74 6f 20 61 6c  t the tail to al
d0c0: 6c 0a 2a 2a 20 7a 65 72 6f 73 2e 0a 2a 2a 0a 2a  l.** zeros..**.*
d0d0: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
d0e0: 62 65 72 20 6f 66 20 62 79 74 65 73 20 61 63 74  ber of bytes act
d0f0: 75 61 6c 6c 79 20 77 72 69 74 74 65 6e 20 69 6e  ually written in
d100: 74 6f 20 62 75 66 5b 5d 2e 20 20 54 68 65 20 6e  to buf[].  The n
d110: 75 6d 62 65 72 0a 2a 2a 20 6f 66 20 62 79 74 65  umber.** of byte
d120: 73 20 69 6e 20 74 68 65 20 7a 65 72 6f 2d 66 69  s in the zero-fi
d130: 6c 6c 65 64 20 74 61 69 6c 20 69 73 20 69 6e 63  lled tail is inc
d140: 6c 75 64 65 64 20 69 6e 20 74 68 65 20 72 65 74  luded in the ret
d150: 75 72 6e 20 76 61 6c 75 65 20 6f 6e 6c 79 0a 2a  urn value only.*
d160: 2a 20 69 66 20 74 68 6f 73 65 20 62 79 74 65 73  * if those bytes
d170: 20 77 65 72 65 20 7a 65 72 6f 65 64 20 69 6e 20   were zeroed in 
d180: 62 75 66 5b 5d 2e 0a 2a 2f 20 0a 69 6e 74 20 73  buf[]..*/ .int s
d190: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
d1a0: 50 75 74 28 75 38 20 2a 62 75 66 2c 20 69 6e 74  Put(u8 *buf, int
d1b0: 20 6e 42 75 66 2c 20 4d 65 6d 20 2a 70 4d 65 6d   nBuf, Mem *pMem
d1c0: 2c 20 69 6e 74 20 66 69 6c 65 5f 66 6f 72 6d 61  , int file_forma
d1d0: 74 29 7b 0a 20 20 75 33 32 20 73 65 72 69 61 6c  t){.  u32 serial
d1e0: 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65 33 56  _type = sqlite3V
d1f0: 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 70 4d  dbeSerialType(pM
d200: 65 6d 2c 20 66 69 6c 65 5f 66 6f 72 6d 61 74 29  em, file_format)
d210: 3b 0a 20 20 69 6e 74 20 6c 65 6e 3b 0a 0a 20 20  ;.  int len;..  
d220: 2f 2a 20 49 6e 74 65 67 65 72 20 61 6e 64 20 52  /* Integer and R
d230: 65 61 6c 20 2a 2f 0a 20 20 69 66 28 20 73 65 72  eal */.  if( ser
d240: 69 61 6c 5f 74 79 70 65 3c 3d 37 20 26 26 20 73  ial_type<=7 && s
d250: 65 72 69 61 6c 5f 74 79 70 65 3e 30 20 29 7b 0a  erial_type>0 ){.
d260: 20 20 20 20 75 36 34 20 76 3b 0a 20 20 20 20 69      u64 v;.    i
d270: 6e 74 20 69 3b 0a 20 20 20 20 69 66 28 20 73 65  nt i;.    if( se
d280: 72 69 61 6c 5f 74 79 70 65 3d 3d 37 20 29 7b 0a  rial_type==7 ){.
d290: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 69        assert( si
d2a0: 7a 65 6f 66 28 76 29 3d 3d 73 69 7a 65 6f 66 28  zeof(v)==sizeof(
d2b0: 70 4d 65 6d 2d 3e 72 29 20 29 3b 0a 20 20 20 20  pMem->r) );.    
d2c0: 20 20 73 77 61 70 4d 69 78 65 64 45 6e 64 69 61    swapMixedEndia
d2d0: 6e 46 6c 6f 61 74 28 70 4d 65 6d 2d 3e 72 29 3b  nFloat(pMem->r);
d2e0: 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26 76  .      memcpy(&v
d2f0: 2c 20 26 70 4d 65 6d 2d 3e 72 2c 20 73 69 7a 65  , &pMem->r, size
d300: 6f 66 28 76 29 29 3b 0a 20 20 20 20 7d 65 6c 73  of(v));.    }els
d310: 65 7b 0a 20 20 20 20 20 20 76 20 3d 20 70 4d 65  e{.      v = pMe
d320: 6d 2d 3e 75 2e 69 3b 0a 20 20 20 20 7d 0a 20 20  m->u.i;.    }.  
d330: 20 20 6c 65 6e 20 3d 20 69 20 3d 20 73 71 6c 69    len = i = sqli
d340: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
d350: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
d360: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6c  );.    assert( l
d370: 65 6e 3c 3d 6e 42 75 66 20 29 3b 0a 20 20 20 20  en<=nBuf );.    
d380: 77 68 69 6c 65 28 20 69 2d 2d 20 29 7b 0a 20 20  while( i-- ){.  
d390: 20 20 20 20 62 75 66 5b 69 5d 20 3d 20 28 76 26      buf[i] = (v&
d3a0: 30 78 46 46 29 3b 0a 20 20 20 20 20 20 76 20 3e  0xFF);.      v >
d3b0: 3e 3d 20 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20  >= 8;.    }.    
d3c0: 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a  return len;.  }.
d3d0: 0a 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72 20  .  /* String or 
d3e0: 62 6c 6f 62 20 2a 2f 0a 20 20 69 66 28 20 73 65  blob */.  if( se
d3f0: 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b  rial_type>=12 ){
d400: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4d 65  .    assert( pMe
d410: 6d 2d 3e 6e 20 2b 20 28 28 70 4d 65 6d 2d 3e 66  m->n + ((pMem->f
d420: 6c 61 67 73 20 26 20 4d 45 4d 5f 5a 65 72 6f 29  lags & MEM_Zero)
d430: 3f 70 4d 65 6d 2d 3e 75 2e 69 3a 30 29 0a 20 20  ?pMem->u.i:0).  
d440: 20 20 20 20 20 20 20 20 20 20 20 3d 3d 20 73 71             == sq
d450: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
d460: 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79  ypeLen(serial_ty
d470: 70 65 29 20 29 3b 0a 20 20 20 20 61 73 73 65 72  pe) );.    asser
d480: 74 28 20 70 4d 65 6d 2d 3e 6e 3c 3d 6e 42 75 66  t( pMem->n<=nBuf
d490: 20 29 3b 0a 20 20 20 20 6c 65 6e 20 3d 20 70 4d   );.    len = pM
d4a0: 65 6d 2d 3e 6e 3b 0a 20 20 20 20 6d 65 6d 63 70  em->n;.    memcp
d4b0: 79 28 62 75 66 2c 20 70 4d 65 6d 2d 3e 7a 2c 20  y(buf, pMem->z, 
d4c0: 6c 65 6e 29 3b 0a 20 20 20 20 69 66 28 20 70 4d  len);.    if( pM
d4d0: 65 6d 2d 3e 66 6c 61 67 73 20 26 20 4d 45 4d 5f  em->flags & MEM_
d4e0: 5a 65 72 6f 20 29 7b 0a 20 20 20 20 20 20 6c 65  Zero ){.      le
d4f0: 6e 20 2b 3d 20 70 4d 65 6d 2d 3e 75 2e 69 3b 0a  n += pMem->u.i;.
d500: 20 20 20 20 20 20 69 66 28 20 6c 65 6e 3e 6e 42        if( len>nB
d510: 75 66 20 29 7b 0a 20 20 20 20 20 20 20 20 6c 65  uf ){.        le
d520: 6e 20 3d 20 6e 42 75 66 3b 0a 20 20 20 20 20 20  n = nBuf;.      
d530: 7d 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 26  }.      memset(&
d540: 62 75 66 5b 70 4d 65 6d 2d 3e 6e 5d 2c 20 30 2c  buf[pMem->n], 0,
d550: 20 6c 65 6e 2d 70 4d 65 6d 2d 3e 6e 29 3b 0a 20   len-pMem->n);. 
d560: 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20     }.    return 
d570: 6c 65 6e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e  len;.  }..  /* N
d580: 55 4c 4c 20 6f 72 20 63 6f 6e 73 74 61 6e 74 73  ULL or constants
d590: 20 30 20 6f 72 20 31 20 2a 2f 0a 20 20 72 65 74   0 or 1 */.  ret
d5a0: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
d5b0: 44 65 73 65 72 69 61 6c 69 7a 65 20 74 68 65 20  Deserialize the 
d5c0: 64 61 74 61 20 62 6c 6f 62 20 70 6f 69 6e 74 65  data blob pointe
d5d0: 64 20 74 6f 20 62 79 20 62 75 66 20 61 73 20 73  d to by buf as s
d5e0: 65 72 69 61 6c 20 74 79 70 65 20 73 65 72 69 61  erial type seria
d5f0: 6c 5f 74 79 70 65 0a 2a 2a 20 61 6e 64 20 73 74  l_type.** and st
d600: 6f 72 65 20 74 68 65 20 72 65 73 75 6c 74 20 69  ore the result i
d610: 6e 20 70 4d 65 6d 2e 20 20 52 65 74 75 72 6e 20  n pMem.  Return 
d620: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79  the number of by
d630: 74 65 73 20 72 65 61 64 2e 0a 2a 2f 20 0a 69 6e  tes read..*/ .in
d640: 74 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  t sqlite3VdbeSer
d650: 69 61 6c 47 65 74 28 0a 20 20 63 6f 6e 73 74 20  ialGet(.  const 
d660: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 62  unsigned char *b
d670: 75 66 2c 20 20 20 20 20 2f 2a 20 42 75 66 66 65  uf,     /* Buffe
d680: 72 20 74 6f 20 64 65 73 65 72 69 61 6c 69 7a 65  r to deserialize
d690: 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 73   from */.  u32 s
d6a0: 65 72 69 61 6c 5f 74 79 70 65 2c 20 20 20 20 20  erial_type,     
d6b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 72 69           /* Seri
d6c0: 61 6c 20 74 79 70 65 20 74 6f 20 64 65 73 65 72  al type to deser
d6d0: 69 61 6c 69 7a 65 20 2a 2f 0a 20 20 4d 65 6d 20  ialize */.  Mem 
d6e0: 2a 70 4d 65 6d 20 20 20 20 20 20 20 20 20 20 20  *pMem           
d6f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d            /* Mem
d700: 6f 72 79 20 63 65 6c 6c 20 74 6f 20 77 72 69 74  ory cell to writ
d710: 65 20 76 61 6c 75 65 20 69 6e 74 6f 20 2a 2f 0a  e value into */.
d720: 29 7b 0a 20 20 73 77 69 74 63 68 28 20 73 65 72  ){.  switch( ser
d730: 69 61 6c 5f 74 79 70 65 20 29 7b 0a 20 20 20 20  ial_type ){.    
d740: 63 61 73 65 20 31 30 3a 20 20 20 2f 2a 20 52 65  case 10:   /* Re
d750: 73 65 72 76 65 64 20 66 6f 72 20 66 75 74 75 72  served for futur
d760: 65 20 75 73 65 20 2a 2f 0a 20 20 20 20 63 61 73  e use */.    cas
d770: 65 20 31 31 3a 20 20 20 2f 2a 20 52 65 73 65 72  e 11:   /* Reser
d780: 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20 75  ved for future u
d790: 73 65 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 30  se */.    case 0
d7a0: 3a 20 7b 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a  : {  /* NULL */.
d7b0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
d7c0: 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20  s = MEM_Null;.  
d7d0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
d7e0: 0a 20 20 20 20 63 61 73 65 20 31 3a 20 7b 20 2f  .    case 1: { /
d7f0: 2a 20 31 2d 62 79 74 65 20 73 69 67 6e 65 64 20  * 1-byte signed 
d800: 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 20  integer */.     
d810: 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20 28 73 69   pMem->u.i = (si
d820: 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30 5d  gned char)buf[0]
d830: 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  ;.      pMem->fl
d840: 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20  ags = MEM_Int;. 
d850: 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20       return 1;. 
d860: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 32 3a     }.    case 2:
d870: 20 7b 20 2f 2a 20 32 2d 62 79 74 65 20 73 69 67   { /* 2-byte sig
d880: 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20  ned integer */. 
d890: 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d       pMem->u.i =
d8a0: 20 28 28 28 73 69 67 6e 65 64 20 63 68 61 72 29   (((signed char)
d8b0: 62 75 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62 75  buf[0])<<8) | bu
d8c0: 66 5b 31 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d  f[1];.      pMem
d8d0: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
d8e0: 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  t;.      return 
d8f0: 32 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  2;.    }.    cas
d900: 65 20 33 3a 20 7b 20 2f 2a 20 33 2d 62 79 74 65  e 3: { /* 3-byte
d910: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20   signed integer 
d920: 2a 2f 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75  */.      pMem->u
d930: 2e 69 20 3d 20 28 28 28 73 69 67 6e 65 64 20 63  .i = (((signed c
d940: 68 61 72 29 62 75 66 5b 30 5d 29 3c 3c 31 36 29  har)buf[0])<<16)
d950: 20 7c 20 28 62 75 66 5b 31 5d 3c 3c 38 29 20 7c   | (buf[1]<<8) |
d960: 20 62 75 66 5b 32 5d 3b 0a 20 20 20 20 20 20 70   buf[2];.      p
d970: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
d980: 5f 49 6e 74 3b 0a 20 20 20 20 20 20 72 65 74 75  _Int;.      retu
d990: 72 6e 20 33 3b 0a 20 20 20 20 7d 0a 20 20 20 20  rn 3;.    }.    
d9a0: 63 61 73 65 20 34 3a 20 7b 20 2f 2a 20 34 2d 62  case 4: { /* 4-b
d9b0: 79 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67  yte signed integ
d9c0: 65 72 20 2a 2f 0a 20 20 20 20 20 20 70 4d 65 6d  er */.      pMem
d9d0: 2d 3e 75 2e 69 20 3d 20 28 62 75 66 5b 30 5d 3c  ->u.i = (buf[0]<
d9e0: 3c 32 34 29 20 7c 20 28 62 75 66 5b 31 5d 3c 3c  <24) | (buf[1]<<
d9f0: 31 36 29 20 7c 20 28 62 75 66 5b 32 5d 3c 3c 38  16) | (buf[2]<<8
da00: 29 20 7c 20 62 75 66 5b 33 5d 3b 0a 20 20 20 20  ) | buf[3];.    
da10: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
da20: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 72  MEM_Int;.      r
da30: 65 74 75 72 6e 20 34 3b 0a 20 20 20 20 7d 0a 20  eturn 4;.    }. 
da40: 20 20 20 63 61 73 65 20 35 3a 20 7b 20 2f 2a 20     case 5: { /* 
da50: 36 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 6e  6-byte signed in
da60: 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 20 20 75  teger */.      u
da70: 36 34 20 78 20 3d 20 28 28 28 73 69 67 6e 65 64  64 x = (((signed
da80: 20 63 68 61 72 29 62 75 66 5b 30 5d 29 3c 3c 38   char)buf[0])<<8
da90: 29 20 7c 20 62 75 66 5b 31 5d 3b 0a 20 20 20 20  ) | buf[1];.    
daa0: 20 20 75 33 32 20 79 20 3d 20 28 62 75 66 5b 32    u32 y = (buf[2
dab0: 5d 3c 3c 32 34 29 20 7c 20 28 62 75 66 5b 33 5d  ]<<24) | (buf[3]
dac0: 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b 34 5d 3c  <<16) | (buf[4]<
dad0: 3c 38 29 20 7c 20 62 75 66 5b 35 5d 3b 0a 20 20  <8) | buf[5];.  
dae0: 20 20 20 20 78 20 3d 20 28 78 3c 3c 33 32 29 20      x = (x<<32) 
daf0: 7c 20 79 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  | y;.      pMem-
db00: 3e 75 2e 69 20 3d 20 2a 28 69 36 34 2a 29 26 78  >u.i = *(i64*)&x
db10: 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  ;.      pMem->fl
db20: 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20  ags = MEM_Int;. 
db30: 20 20 20 20 20 72 65 74 75 72 6e 20 36 3b 0a 20       return 6;. 
db40: 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 36 3a     }.    case 6:
db50: 20 20 20 2f 2a 20 38 2d 62 79 74 65 20 73 69 67     /* 8-byte sig
db60: 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20  ned integer */. 
db70: 20 20 20 63 61 73 65 20 37 3a 20 7b 20 2f 2a 20     case 7: { /* 
db80: 49 45 45 45 20 66 6c 6f 61 74 69 6e 67 20 70 6f  IEEE floating po
db90: 69 6e 74 20 2a 2f 0a 20 20 20 20 20 20 75 36 34  int */.      u64
dba0: 20 78 3b 0a 20 20 20 20 20 20 75 33 32 20 79 3b   x;.      u32 y;
dbb0: 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 4e 44  .#if !defined(ND
dbc0: 45 42 55 47 29 20 26 26 20 21 64 65 66 69 6e 65  EBUG) && !define
dbd0: 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4c  d(SQLITE_OMIT_FL
dbe0: 4f 41 54 49 4e 47 5f 50 4f 49 4e 54 29 0a 20 20  OATING_POINT).  
dbf0: 20 20 20 20 2f 2a 20 56 65 72 69 66 79 20 74 68      /* Verify th
dc00: 61 74 20 69 6e 74 65 67 65 72 73 20 61 6e 64 20  at integers and 
dc10: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 76  floating point v
dc20: 61 6c 75 65 73 20 75 73 65 20 74 68 65 20 73 61  alues use the sa
dc30: 6d 65 0a 20 20 20 20 20 20 2a 2a 20 62 79 74 65  me.      ** byte
dc40: 20 6f 72 64 65 72 2e 20 20 4f 72 2c 20 74 68 61   order.  Or, tha
dc50: 74 20 69 66 20 53 51 4c 49 54 45 5f 4d 49 58 45  t if SQLITE_MIXE
dc60: 44 5f 45 4e 44 49 41 4e 5f 36 34 42 49 54 5f 46  D_ENDIAN_64BIT_F
dc70: 4c 4f 41 54 20 69 73 0a 20 20 20 20 20 20 2a 2a  LOAT is.      **
dc80: 20 64 65 66 69 6e 65 64 20 74 68 61 74 20 36 34   defined that 64
dc90: 2d 62 69 74 20 66 6c 6f 61 74 69 6e 67 20 70 6f  -bit floating po
dca0: 69 6e 74 20 76 61 6c 75 65 73 20 72 65 61 6c 6c  int values reall
dcb0: 79 20 61 72 65 20 6d 69 78 65 64 0a 20 20 20 20  y are mixed.    
dcc0: 20 20 2a 2a 20 65 6e 64 69 61 6e 2e 0a 20 20 20    ** endian..   
dcd0: 20 20 20 2a 2f 0a 20 20 20 20 20 20 73 74 61 74     */.      stat
dce0: 69 63 20 63 6f 6e 73 74 20 75 36 34 20 74 31 20  ic const u64 t1 
dcf0: 3d 20 28 28 75 36 34 29 30 78 33 66 66 30 30 30  = ((u64)0x3ff000
dd00: 30 30 29 3c 3c 33 32 3b 0a 20 20 20 20 20 20 73  00)<<32;.      s
dd10: 74 61 74 69 63 20 63 6f 6e 73 74 20 64 6f 75 62  tatic const doub
dd20: 6c 65 20 72 31 20 3d 20 31 2e 30 3b 0a 20 20 20  le r1 = 1.0;.   
dd30: 20 20 20 64 6f 75 62 6c 65 20 72 32 20 3d 20 72     double r2 = r
dd40: 31 3b 0a 20 20 20 20 20 20 73 77 61 70 4d 69 78  1;.      swapMix
dd50: 65 64 45 6e 64 69 61 6e 46 6c 6f 61 74 28 72 32  edEndianFloat(r2
dd60: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  );.      assert(
dd70: 20 73 69 7a 65 6f 66 28 72 32 29 3d 3d 73 69 7a   sizeof(r2)==siz
dd80: 65 6f 66 28 74 31 29 20 26 26 20 6d 65 6d 63 6d  eof(t1) && memcm
dd90: 70 28 26 72 32 2c 20 26 74 31 2c 20 73 69 7a 65  p(&r2, &t1, size
dda0: 6f 66 28 72 31 29 29 3d 3d 30 20 29 3b 0a 23 65  of(r1))==0 );.#e
ddb0: 6e 64 69 66 0a 0a 20 20 20 20 20 20 78 20 3d 20  ndif..      x = 
ddc0: 28 62 75 66 5b 30 5d 3c 3c 32 34 29 20 7c 20 28  (buf[0]<<24) | (
ddd0: 62 75 66 5b 31 5d 3c 3c 31 36 29 20 7c 20 28 62  buf[1]<<16) | (b
dde0: 75 66 5b 32 5d 3c 3c 38 29 20 7c 20 62 75 66 5b  uf[2]<<8) | buf[
ddf0: 33 5d 3b 0a 20 20 20 20 20 20 79 20 3d 20 28 62  3];.      y = (b
de00: 75 66 5b 34 5d 3c 3c 32 34 29 20 7c 20 28 62 75  uf[4]<<24) | (bu
de10: 66 5b 35 5d 3c 3c 31 36 29 20 7c 20 28 62 75 66  f[5]<<16) | (buf
de20: 5b 36 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 37 5d  [6]<<8) | buf[7]
de30: 3b 0a 20 20 20 20 20 20 78 20 3d 20 28 78 3c 3c  ;.      x = (x<<
de40: 33 32 29 20 7c 20 79 3b 0a 20 20 20 20 20 20 69  32) | y;.      i
de50: 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3d 3d  f( serial_type==
de60: 36 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4d 65  6 ){.        pMe
de70: 6d 2d 3e 75 2e 69 20 3d 20 2a 28 69 36 34 2a 29  m->u.i = *(i64*)
de80: 26 78 3b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  &x;.        pMem
de90: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
dea0: 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  t;.      }else{.
deb0: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20          assert( 
dec0: 73 69 7a 65 6f 66 28 78 29 3d 3d 38 20 26 26 20  sizeof(x)==8 && 
ded0: 73 69 7a 65 6f 66 28 70 4d 65 6d 2d 3e 72 29 3d  sizeof(pMem->r)=
dee0: 3d 38 20 29 3b 0a 20 20 20 20 20 20 20 20 6d 65  =8 );.        me
def0: 6d 63 70 79 28 26 70 4d 65 6d 2d 3e 72 2c 20 26  mcpy(&pMem->r, &
df00: 78 2c 20 73 69 7a 65 6f 66 28 78 29 29 3b 0a 20  x, sizeof(x));. 
df10: 20 20 20 20 20 20 20 73 77 61 70 4d 69 78 65 64         swapMixed
df20: 45 6e 64 69 61 6e 46 6c 6f 61 74 28 70 4d 65 6d  EndianFloat(pMem
df30: 2d 3e 72 29 3b 0a 20 20 20 20 20 20 20 20 70 4d  ->r);.        pM
df40: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
df50: 52 65 61 6c 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Real;.      }.  
df60: 20 20 20 20 72 65 74 75 72 6e 20 38 3b 0a 20 20      return 8;.  
df70: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 38 3a 20    }.    case 8: 
df80: 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 30 20     /* Integer 0 
df90: 2a 2f 0a 20 20 20 20 63 61 73 65 20 39 3a 20 7b  */.    case 9: {
dfa0: 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 31 20 2a    /* Integer 1 *
dfb0: 2f 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e  /.      pMem->u.
dfc0: 69 20 3d 20 73 65 72 69 61 6c 5f 74 79 70 65 2d  i = serial_type-
dfd0: 38 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  8;.      pMem->f
dfe0: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
dff0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a        return 0;.
e000: 20 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c      }.    defaul
e010: 74 3a 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 6c  t: {.      int l
e020: 65 6e 20 3d 20 28 73 65 72 69 61 6c 5f 74 79 70  en = (serial_typ
e030: 65 2d 31 32 29 2f 32 3b 0a 20 20 20 20 20 20 70  e-12)/2;.      p
e040: 4d 65 6d 2d 3e 7a 20 3d 20 28 63 68 61 72 20 2a  Mem->z = (char *
e050: 29 62 75 66 3b 0a 20 20 20 20 20 20 70 4d 65 6d  )buf;.      pMem
e060: 2d 3e 6e 20 3d 20 6c 65 6e 3b 0a 20 20 20 20 20  ->n = len;.     
e070: 20 70 4d 65 6d 2d 3e 78 44 65 6c 20 3d 20 30 3b   pMem->xDel = 0;
e080: 0a 20 20 20 20 20 20 69 66 28 20 73 65 72 69 61  .      if( seria
e090: 6c 5f 74 79 70 65 26 30 78 30 31 20 29 7b 0a 20  l_type&0x01 ){. 
e0a0: 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61         pMem->fla
e0b0: 67 73 20 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d  gs = MEM_Str | M
e0c0: 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20 20 20 20  EM_Ephem;.      
e0d0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70  }else{.        p
e0e0: 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  Mem->flags = MEM
e0f0: 5f 42 6c 6f 62 20 7c 20 4d 45 4d 5f 45 70 68 65  _Blob | MEM_Ephe
e100: 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  m;.      }.     
e110: 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 20   return len;.   
e120: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
e130: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  0;.}../*.** The 
e140: 68 65 61 64 65 72 20 6f 66 20 61 20 72 65 63 6f  header of a reco
e150: 72 64 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61  rd consists of a
e160: 20 73 65 71 75 65 6e 63 65 20 76 61 72 69 61 62   sequence variab
e170: 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74 65 67 65  le-length intege
e180: 72 73 2e 0a 2a 2a 20 54 68 65 73 65 20 69 6e 74  rs..** These int
e190: 65 67 65 72 73 20 61 72 65 20 61 6c 6d 6f 73 74  egers are almost
e1a0: 20 61 6c 77 61 79 73 20 73 6d 61 6c 6c 20 61 6e   always small an
e1b0: 64 20 61 72 65 20 65 6e 63 6f 64 65 64 20 61 73  d are encoded as
e1c0: 20 61 20 73 69 6e 67 6c 65 20 62 79 74 65 2e 0a   a single byte..
e1d0: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
e1e0: 20 6d 61 63 72 6f 20 74 61 6b 65 73 20 61 64 76   macro takes adv
e1f0: 61 6e 74 61 67 65 20 74 68 69 73 20 66 61 63 74  antage this fact
e200: 20 74 6f 20 70 72 6f 76 69 64 65 20 61 20 66 61   to provide a fa
e210: 73 74 20 64 65 63 6f 64 65 0a 2a 2a 20 6f 66 20  st decode.** of 
e220: 74 68 65 20 69 6e 74 65 67 65 72 73 20 69 6e 20  the integers in 
e230: 61 20 72 65 63 6f 72 64 20 68 65 61 64 65 72 2e  a record header.
e240: 20 20 49 74 20 69 73 20 66 61 73 74 65 72 20 66    It is faster f
e250: 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61  or the common ca
e260: 73 65 0a 2a 2a 20 77 68 65 72 65 20 74 68 65 20  se.** where the 
e270: 69 6e 74 65 67 65 72 20 69 73 20 61 20 73 69 6e  integer is a sin
e280: 67 6c 65 20 62 79 74 65 2e 20 20 49 74 20 69 73  gle byte.  It is
e290: 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f 77 65 72   a little slower
e2a0: 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20 69 6e 74   when the.** int
e2b0: 65 67 65 72 20 69 73 20 74 77 6f 20 6f 72 20 6d  eger is two or m
e2c0: 6f 72 65 20 62 79 74 65 73 2e 20 20 42 75 74 20  ore bytes.  But 
e2d0: 6f 76 65 72 61 6c 6c 20 69 74 20 69 73 20 66 61  overall it is fa
e2e0: 73 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ster..**.** The 
e2f0: 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 70 72 65 73  following expres
e300: 73 69 6f 6e 73 20 61 72 65 20 65 71 75 69 76 61  sions are equiva
e310: 6c 65 6e 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  lent:.**.**     
e320: 78 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 61  x = sqlite3GetVa
e330: 72 69 6e 74 33 32 28 20 41 2c 20 26 42 20 29 3b  rint32( A, &B );
e340: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 78 20 3d 20 47  .**.**     x = G
e350: 65 74 56 61 72 69 6e 74 28 20 41 2c 20 42 20 29  etVarint( A, B )
e360: 3b 0a 2a 2a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20  ;.**.*/.#define 
e370: 47 65 74 56 61 72 69 6e 74 28 41 2c 42 29 20 20  GetVarint(A,B)  
e380: 28 28 42 20 3d 20 2a 28 41 29 29 3c 3d 30 78 37  ((B = *(A))<=0x7
e390: 66 20 3f 20 31 20 3a 20 73 71 6c 69 74 65 33 47  f ? 1 : sqlite3G
e3a0: 65 74 56 61 72 69 6e 74 33 32 28 41 2c 20 26 42  etVarint32(A, &B
e3b0: 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  ))../*.** This f
e3c0: 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61 72 65 73  unction compares
e3d0: 20 74 68 65 20 74 77 6f 20 74 61 62 6c 65 20 72   the two table r
e3e0: 6f 77 73 20 6f 72 20 69 6e 64 65 78 20 72 65 63  ows or index rec
e3f0: 6f 72 64 73 20 73 70 65 63 69 66 69 65 64 20 62  ords specified b
e400: 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c 20 70 4b  y .** {nKey1, pK
e410: 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65 79 32 2c  ey1} and {nKey2,
e420: 20 70 4b 65 79 32 7d 2c 20 72 65 74 75 72 6e 69   pKey2}, returni
e430: 6e 67 20 61 20 6e 65 67 61 74 69 76 65 2c 20 7a  ng a negative, z
e440: 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73 69 74 69  ero.** or positi
e450: 76 65 20 69 6e 74 65 67 65 72 20 69 66 20 7b 6e  ve integer if {n
e460: 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20 69 73 20  Key1, pKey1} is 
e470: 6c 65 73 73 20 74 68 61 6e 2c 20 65 71 75 61 6c  less than, equal
e480: 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72 65 61 74   to or .** great
e490: 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79 32 2c 20  er than {nKey2, 
e4a0: 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68 20 4b 65  pKey2}.  Both Ke
e4b0: 79 31 20 61 6e 64 20 4b 65 79 32 20 6d 75 73 74  y1 and Key2 must
e4c0: 20 62 65 20 62 79 74 65 20 73 74 72 69 6e 67 73   be byte strings
e4d0: 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20 62 79 20  .** composed by 
e4e0: 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72  the OP_MakeRecor
e4f0: 64 20 6f 70 63 6f 64 65 20 6f 66 20 74 68 65 20  d opcode of the 
e500: 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  VDBE..*/.int sql
e510: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f  ite3VdbeRecordCo
e520: 6d 70 61 72 65 28 0a 20 20 76 6f 69 64 20 2a 75  mpare(.  void *u
e530: 73 65 72 44 61 74 61 2c 0a 20 20 69 6e 74 20 6e  serData,.  int n
e540: 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64  Key1, const void
e550: 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69 6e 74 20   *pKey1, .  int 
e560: 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69  nKey2, const voi
e570: 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20 20 4b 65  d *pKey2.){.  Ke
e580: 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20  yInfo *pKeyInfo 
e590: 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75 73 65 72  = (KeyInfo*)user
e5a0: 44 61 74 61 3b 0a 20 20 75 33 32 20 64 31 2c 20  Data;.  u32 d1, 
e5b0: 64 32 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20  d2;          /* 
e5c0: 4f 66 66 73 65 74 20 69 6e 74 6f 20 61 4b 65 79  Offset into aKey
e5d0: 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61 74 61 20  [] of next data 
e5e0: 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75 33 32  element */.  u32
e5f0: 20 69 64 78 31 2c 20 69 64 78 32 3b 20 20 20 20   idx1, idx2;    
e600: 20 20 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f    /* Offset into
e610: 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20   aKey[] of next 
e620: 68 65 61 64 65 72 20 65 6c 65 6d 65 6e 74 20 2a  header element *
e630: 2f 0a 20 20 75 33 32 20 73 7a 48 64 72 31 2c 20  /.  u32 szHdr1, 
e640: 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e 75 6d 62  szHdr2;  /* Numb
e650: 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 20 68  er of bytes in h
e660: 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e 74 20 69  eader */.  int i
e670: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 46 69 65   = 0;.  int nFie
e680: 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 30  ld;.  int rc = 0
e690: 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  ;.  const unsign
e6a0: 65 64 20 63 68 61 72 20 2a 61 4b 65 79 31 20 3d  ed char *aKey1 =
e6b0: 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64   (const unsigned
e6c0: 20 63 68 61 72 20 2a 29 70 4b 65 79 31 3b 0a 20   char *)pKey1;. 
e6d0: 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20   const unsigned 
e6e0: 63 68 61 72 20 2a 61 4b 65 79 32 20 3d 20 28 63  char *aKey2 = (c
e6f0: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
e700: 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a 20 20 4d  ar *)pKey2;..  M
e710: 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65 6d 20 6d  em mem1;.  Mem m
e720: 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65 6e 63 20  em2;.  mem1.enc 
e730: 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b  = pKeyInfo->enc;
e740: 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d 20 70 4b  .  mem2.enc = pK
e750: 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20 0a  eyInfo->enc;.  .
e760: 20 20 69 64 78 31 20 3d 20 47 65 74 56 61 72 69    idx1 = GetVari
e770: 6e 74 28 61 4b 65 79 31 2c 20 73 7a 48 64 72 31  nt(aKey1, szHdr1
e780: 29 3b 0a 20 20 64 31 20 3d 20 73 7a 48 64 72 31  );.  d1 = szHdr1
e790: 3b 0a 20 20 69 64 78 32 20 3d 20 47 65 74 56 61  ;.  idx2 = GetVa
e7a0: 72 69 6e 74 28 61 4b 65 79 32 2c 20 73 7a 48 64  rint(aKey2, szHd
e7b0: 72 32 29 3b 0a 20 20 64 32 20 3d 20 73 7a 48 64  r2);.  d2 = szHd
e7c0: 72 32 3b 0a 20 20 6e 46 69 65 6c 64 20 3d 20 70  r2;.  nField = p
e7d0: 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b  KeyInfo->nField;
e7e0: 0a 20 20 77 68 69 6c 65 28 20 69 64 78 31 3c 73  .  while( idx1<s
e7f0: 7a 48 64 72 31 20 26 26 20 69 64 78 32 3c 73 7a  zHdr1 && idx2<sz
e800: 48 64 72 32 20 29 7b 0a 20 20 20 20 75 33 32 20  Hdr2 ){.    u32 
e810: 73 65 72 69 61 6c 5f 74 79 70 65 31 3b 0a 20 20  serial_type1;.  
e820: 20 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70    u32 serial_typ
e830: 65 32 3b 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64  e2;..    /* Read
e840: 20 74 68 65 20 73 65 72 69 61 6c 20 74 79 70 65   the serial type
e850: 73 20 66 6f 72 20 74 68 65 20 6e 65 78 74 20 65  s for the next e
e860: 6c 65 6d 65 6e 74 20 69 6e 20 65 61 63 68 20 6b  lement in each k
e870: 65 79 2e 20 2a 2f 0a 20 20 20 20 69 64 78 31 20  ey. */.    idx1 
e880: 2b 3d 20 47 65 74 56 61 72 69 6e 74 28 20 61 4b  += GetVarint( aK
e890: 65 79 31 2b 69 64 78 31 2c 20 73 65 72 69 61 6c  ey1+idx1, serial
e8a0: 5f 74 79 70 65 31 20 29 3b 0a 20 20 20 20 69 66  _type1 );.    if
e8b0: 28 20 64 31 3e 3d 6e 4b 65 79 31 20 26 26 20 73  ( d1>=nKey1 && s
e8c0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
e8d0: 54 79 70 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74  TypeLen(serial_t
e8e0: 79 70 65 31 29 3e 30 20 29 20 62 72 65 61 6b 3b  ype1)>0 ) break;
e8f0: 0a 20 20 20 20 69 64 78 32 20 2b 3d 20 47 65 74  .    idx2 += Get
e900: 56 61 72 69 6e 74 28 20 61 4b 65 79 32 2b 69 64  Varint( aKey2+id
e910: 78 32 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 32  x2, serial_type2
e920: 20 29 3b 0a 20 20 20 20 69 66 28 20 64 32 3e 3d   );.    if( d2>=
e930: 6e 4b 65 79 32 20 26 26 20 73 71 6c 69 74 65 33  nKey2 && sqlite3
e940: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
e950: 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 32 29 3e  n(serial_type2)>
e960: 30 20 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20  0 ) break;..    
e970: 2f 2a 20 45 78 74 72 61 63 74 20 74 68 65 20 76  /* Extract the v
e980: 61 6c 75 65 73 20 74 6f 20 62 65 20 63 6f 6d 70  alues to be comp
e990: 61 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  ared..    */.   
e9a0: 20 64 31 20 2b 3d 20 73 71 6c 69 74 65 33 56 64   d1 += sqlite3Vd
e9b0: 62 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65  beSerialGet(&aKe
e9c0: 79 31 5b 64 31 5d 2c 20 73 65 72 69 61 6c 5f 74  y1[d1], serial_t
e9d0: 79 70 65 31 2c 20 26 6d 65 6d 31 29 3b 0a 20 20  ype1, &mem1);.  
e9e0: 20 20 64 32 20 2b 3d 20 73 71 6c 69 74 65 33 56    d2 += sqlite3V
e9f0: 64 62 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b  dbeSerialGet(&aK
ea00: 65 79 32 5b 64 32 5d 2c 20 73 65 72 69 61 6c 5f  ey2[d2], serial_
ea10: 74 79 70 65 32 2c 20 26 6d 65 6d 32 29 3b 0a 0a  type2, &mem2);..
ea20: 20 20 20 20 2f 2a 20 44 6f 20 74 68 65 20 63 6f      /* Do the co
ea30: 6d 70 61 72 69 73 6f 6e 0a 20 20 20 20 2a 2f 0a  mparison.    */.
ea40: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
ea50: 4d 65 6d 43 6f 6d 70 61 72 65 28 26 6d 65 6d 31  MemCompare(&mem1
ea60: 2c 20 26 6d 65 6d 32 2c 20 69 3c 6e 46 69 65 6c  , &mem2, i<nFiel
ea70: 64 20 3f 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 43  d ? pKeyInfo->aC
ea80: 6f 6c 6c 5b 69 5d 20 3a 20 30 29 3b 0a 20 20 20  oll[i] : 0);.   
ea90: 20 69 66 28 20 6d 65 6d 31 2e 66 6c 61 67 73 20   if( mem1.flags 
eaa0: 26 20 4d 45 4d 5f 44 79 6e 20 29 20 73 71 6c 69  & MEM_Dyn ) sqli
eab0: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
eac0: 65 28 26 6d 65 6d 31 29 3b 0a 20 20 20 20 69 66  e(&mem1);.    if
ead0: 28 20 6d 65 6d 32 2e 66 6c 61 67 73 20 26 20 4d  ( mem2.flags & M
eae0: 45 4d 5f 44 79 6e 20 29 20 73 71 6c 69 74 65 33  EM_Dyn ) sqlite3
eaf0: 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26  VdbeMemRelease(&
eb00: 6d 65 6d 32 29 3b 0a 20 20 20 20 69 66 28 20 72  mem2);.    if( r
eb10: 63 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 62 72  c!=0 ){.      br
eb20: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  eak;.    }.    i
eb30: 2b 2b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 6e  ++;.  }..  /* On
eb40: 65 20 6f 66 20 74 68 65 20 6b 65 79 73 20 72 61  e of the keys ra
eb50: 6e 20 6f 75 74 20 6f 66 20 66 69 65 6c 64 73 2c  n out of fields,
eb60: 20 62 75 74 20 61 6c 6c 20 74 68 65 20 66 69 65   but all the fie
eb70: 6c 64 73 20 75 70 20 74 6f 20 74 68 61 74 20 70  lds up to that p
eb80: 6f 69 6e 74 0a 20 20 2a 2a 20 77 65 72 65 20 65  oint.  ** were e
eb90: 71 75 61 6c 2e 20 49 66 20 74 68 65 20 69 6e 63  qual. If the inc
eba0: 72 4b 65 79 20 66 6c 61 67 20 69 73 20 74 72 75  rKey flag is tru
ebb0: 65 2c 20 74 68 65 6e 20 74 68 65 20 73 65 63 6f  e, then the seco
ebc0: 6e 64 20 6b 65 79 20 69 73 0a 20 20 2a 2a 20 74  nd key is.  ** t
ebd0: 72 65 61 74 65 64 20 61 73 20 6c 61 72 67 65 72  reated as larger
ebe0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d  ..  */.  if( rc=
ebf0: 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 4b  =0 ){.    if( pK
ec00: 65 79 49 6e 66 6f 2d 3e 69 6e 63 72 4b 65 79 20  eyInfo->incrKey 
ec10: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 2d 31  ){.      rc = -1
ec20: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
ec30: 64 31 3c 6e 4b 65 79 31 20 29 7b 0a 20 20 20 20  d1<nKey1 ){.    
ec40: 20 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 7d 65    rc = 1;.    }e
ec50: 6c 73 65 20 69 66 28 20 64 32 3c 6e 4b 65 79 32  lse if( d2<nKey2
ec60: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 2d   ){.      rc = -
ec70: 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  1;.    }.  }else
ec80: 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 61   if( pKeyInfo->a
ec90: 53 6f 72 74 4f 72 64 65 72 20 26 26 20 69 3c 70  SortOrder && i<p
eca0: 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 0a  KeyInfo->nField.
ecb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 26                 &
ecc0: 26 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  & pKeyInfo->aSor
ecd0: 74 4f 72 64 65 72 5b 69 5d 20 29 7b 0a 20 20 20  tOrder[i] ){.   
ece0: 20 72 63 20 3d 20 2d 72 63 3b 0a 20 20 7d 0a 0a   rc = -rc;.  }..
ecf0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
ed00: 2f 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d 65  /*.** The argume
ed10: 6e 74 20 69 73 20 61 6e 20 69 6e 64 65 78 20 65  nt is an index e
ed20: 6e 74 72 79 20 63 6f 6d 70 6f 73 65 64 20 75 73  ntry composed us
ed30: 69 6e 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52  ing the OP_MakeR
ed40: 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a  ecord opcode..**
ed50: 20 54 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20   The last entry 
ed60: 69 6e 20 74 68 69 73 20 72 65 63 6f 72 64 20 73  in this record s
ed70: 68 6f 75 6c 64 20 62 65 20 61 6e 20 69 6e 74 65  hould be an inte
ed80: 67 65 72 20 28 73 70 65 63 69 66 69 63 61 6c 6c  ger (specificall
ed90: 79 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20  y.** an integer 
eda0: 72 6f 77 69 64 29 2e 20 20 54 68 69 73 20 72 6f  rowid).  This ro
edb0: 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68  utine returns th
edc0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  e number of byte
edd0: 73 20 69 6e 0a 2a 2a 20 74 68 61 74 20 69 6e 74  s in.** that int
ede0: 65 67 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  eger..*/.int sql
edf0: 69 74 65 33 56 64 62 65 49 64 78 52 6f 77 69 64  ite3VdbeIdxRowid
ee00: 4c 65 6e 28 63 6f 6e 73 74 20 75 38 20 2a 61 4b  Len(const u8 *aK
ee10: 65 79 29 7b 0a 20 20 75 33 32 20 73 7a 48 64 72  ey){.  u32 szHdr
ee20: 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65  ;        /* Size
ee30: 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20 2a   of the header *
ee40: 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f 77 69  /.  u32 typeRowi
ee50: 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61 6c 20  d;    /* Serial 
ee60: 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f 77 69  type of the rowi
ee70: 64 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65 33 47  d */..  sqlite3G
ee80: 65 74 56 61 72 69 6e 74 33 32 28 61 4b 65 79 2c  etVarint32(aKey,
ee90: 20 26 73 7a 48 64 72 29 3b 0a 20 20 73 71 6c 69   &szHdr);.  sqli
eea0: 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 26  te3GetVarint32(&
eeb0: 61 4b 65 79 5b 73 7a 48 64 72 2d 31 5d 2c 20 26  aKey[szHdr-1], &
eec0: 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 72 65  typeRowid);.  re
eed0: 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65  turn sqlite3Vdbe
eee0: 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 74 79  SerialTypeLen(ty
eef0: 70 65 52 6f 77 69 64 29 3b 0a 7d 0a 20 20 0a 0a  peRowid);.}.  ..
ef00: 2f 2a 0a 2a 2a 20 70 43 75 72 20 70 6f 69 6e 74  /*.** pCur point
ef10: 73 20 61 74 20 61 6e 20 69 6e 64 65 78 20 65 6e  s at an index en
ef20: 74 72 79 20 63 72 65 61 74 65 64 20 75 73 69 6e  try created usin
ef30: 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63  g the OP_MakeRec
ef40: 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 52  ord opcode..** R
ef50: 65 61 64 20 74 68 65 20 72 6f 77 69 64 20 28 74  ead the rowid (t
ef60: 68 65 20 6c 61 73 74 20 66 69 65 6c 64 20 69 6e  he last field in
ef70: 20 74 68 65 20 72 65 63 6f 72 64 29 20 61 6e 64   the record) and
ef80: 20 73 74 6f 72 65 20 69 74 20 69 6e 20 2a 72 6f   store it in *ro
ef90: 77 69 64 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 53  wid..** Return S
efa0: 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 65 72  QLITE_OK if ever
efb0: 79 74 68 69 6e 67 20 77 6f 72 6b 73 2c 20 6f 72  ything works, or
efc0: 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 6f   an error code o
efd0: 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74  therwise..*/.int
efe0: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 52   sqlite3VdbeIdxR
eff0: 6f 77 69 64 28 42 74 43 75 72 73 6f 72 20 2a 70  owid(BtCursor *p
f000: 43 75 72 2c 20 69 36 34 20 2a 72 6f 77 69 64 29  Cur, i64 *rowid)
f010: 7b 0a 20 20 69 36 34 20 6e 43 65 6c 6c 4b 65 79  {.  i64 nCellKey
f020: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a   = 0;.  int rc;.
f030: 20 20 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20    u32 szHdr;    
f040: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74      /* Size of t
f050: 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75  he header */.  u
f060: 33 32 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20  32 typeRowid;   
f070: 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20   /* Serial type 
f080: 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a  of the rowid */.
f090: 20 20 75 33 32 20 6c 65 6e 52 6f 77 69 64 3b 20    u32 lenRowid; 
f0a0: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74      /* Size of t
f0b0: 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20 4d 65  he rowid */.  Me
f0c0: 6d 20 6d 2c 20 76 3b 0a 0a 20 20 73 71 6c 69 74  m m, v;..  sqlit
f0d0: 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65 28 70  e3BtreeKeySize(p
f0e0: 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29 3b  Cur, &nCellKey);
f0f0: 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c  .  if( nCellKey<
f100: 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  =0 ){.    return
f110: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f   SQLITE_CORRUPT_
f120: 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 72 63 20 3d  BKPT;.  }.  rc =
f130: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46   sqlite3VdbeMemF
f140: 72 6f 6d 42 74 72 65 65 28 70 43 75 72 2c 20 30  romBtree(pCur, 0
f150: 2c 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c 20 26  , nCellKey, 1, &
f160: 6d 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a  m);.  if( rc ){.
f170: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
f180: 20 7d 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56   }.  sqlite3GetV
f190: 61 72 69 6e 74 33 32 28 28 75 38 2a 29 6d 2e 7a  arint32((u8*)m.z
f1a0: 2c 20 26 73 7a 48 64 72 29 3b 0a 20 20 73 71 6c  , &szHdr);.  sql
f1b0: 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28  ite3GetVarint32(
f1c0: 28 75 38 2a 29 26 6d 2e 7a 5b 73 7a 48 64 72 2d  (u8*)&m.z[szHdr-
f1d0: 31 5d 2c 20 26 74 79 70 65 52 6f 77 69 64 29 3b  1], &typeRowid);
f1e0: 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71  .  lenRowid = sq
f1f0: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
f200: 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77 69 64  ypeLen(typeRowid
f210: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  );.  sqlite3Vdbe
f220: 53 65 72 69 61 6c 47 65 74 28 28 75 38 2a 29 26  SerialGet((u8*)&
f230: 6d 2e 7a 5b 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64  m.z[m.n-lenRowid
f240: 5d 2c 20 74 79 70 65 52 6f 77 69 64 2c 20 26 76  ], typeRowid, &v
f250: 29 3b 0a 20 20 2a 72 6f 77 69 64 20 3d 20 76 2e  );.  *rowid = v.
f260: 75 2e 69 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  u.i;.  sqlite3Vd
f270: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 29  beMemRelease(&m)
f280: 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  ;.  return SQLIT
f290: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  E_OK;.}../*.** C
f2a0: 6f 6d 70 61 72 65 20 74 68 65 20 6b 65 79 20 6f  ompare the key o
f2b0: 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74 72  f the index entr
f2c0: 79 20 74 68 61 74 20 63 75 72 73 6f 72 20 70 43  y that cursor pC
f2d0: 20 69 73 20 70 6f 69 6e 74 20 74 6f 20 61 67 61   is point to aga
f2e0: 69 6e 73 74 0a 2a 2a 20 74 68 65 20 6b 65 79 20  inst.** the key 
f2f0: 73 74 72 69 6e 67 20 69 6e 20 70 4b 65 79 20 28  string in pKey (
f300: 6f 66 20 6c 65 6e 67 74 68 20 6e 4b 65 79 29 2e  of length nKey).
f310: 20 20 57 72 69 74 65 20 69 6e 74 6f 20 2a 70 52    Write into *pR
f320: 65 73 20 61 20 6e 75 6d 62 65 72 0a 2a 2a 20 74  es a number.** t
f330: 68 61 74 20 69 73 20 6e 65 67 61 74 69 76 65 2c  hat is negative,
f340: 20 7a 65 72 6f 2c 20 6f 72 20 70 6f 73 69 74 69   zero, or positi
f350: 76 65 20 69 66 20 70 43 20 69 73 20 6c 65 73 73  ve if pC is less
f360: 20 74 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f 2c   than, equal to,
f370: 0a 2a 2a 20 6f 72 20 67 72 65 61 74 65 72 20 74  .** or greater t
f380: 68 61 6e 20 70 4b 65 79 2e 20 20 52 65 74 75 72  han pKey.  Retur
f390: 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 6f 6e 20 73  n SQLITE_OK on s
f3a0: 75 63 63 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 70 4b  uccess..**.** pK
f3b0: 65 79 20 69 73 20 65 69 74 68 65 72 20 63 72 65  ey is either cre
f3c0: 61 74 65 64 20 77 69 74 68 6f 75 74 20 61 20 72  ated without a r
f3d0: 6f 77 69 64 20 6f 72 20 69 73 20 74 72 75 6e 63  owid or is trunc
f3e0: 61 74 65 64 20 73 6f 20 74 68 61 74 20 69 74 0a  ated so that it.
f3f0: 2a 2a 20 6f 6d 69 74 73 20 74 68 65 20 72 6f 77  ** omits the row
f400: 69 64 20 61 74 20 74 68 65 20 65 6e 64 2e 20 20  id at the end.  
f410: 54 68 65 20 72 6f 77 69 64 20 61 74 20 74 68 65  The rowid at the
f420: 20 65 6e 64 20 6f 66 20 74 68 65 20 69 6e 64 65   end of the inde
f430: 78 20 65 6e 74 72 79 0a 2a 2a 20 69 73 20 69 67  x entry.** is ig
f440: 6e 6f 72 65 64 20 61 73 20 77 65 6c 6c 2e 0a 2a  nored as well..*
f450: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
f460: 65 49 64 78 4b 65 79 43 6f 6d 70 61 72 65 28 0a  eIdxKeyCompare(.
f470: 20 20 43 75 72 73 6f 72 20 2a 70 43 2c 20 20 20    Cursor *pC,   
f480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
f490: 20 54 68 65 20 63 75 72 73 6f 72 20 74 6f 20 63   The cursor to c
f4a0: 6f 6d 70 61 72 65 20 61 67 61 69 6e 73 74 20 2a  ompare against *
f4b0: 2f 0a 20 20 69 6e 74 20 6e 4b 65 79 2c 20 63 6f  /.  int nKey, co
f4c0: 6e 73 74 20 75 38 20 2a 70 4b 65 79 2c 20 20 20  nst u8 *pKey,   
f4d0: 2f 2a 20 54 68 65 20 6b 65 79 20 74 6f 20 63 6f  /* The key to co
f4e0: 6d 70 61 72 65 20 2a 2f 0a 20 20 69 6e 74 20 2a  mpare */.  int *
f4f0: 72 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20  res             
f500: 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20         /* Write 
f510: 74 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 72  the comparison r
f520: 65 73 75 6c 74 20 68 65 72 65 20 2a 2f 0a 29 7b  esult here */.){
f530: 0a 20 20 69 36 34 20 6e 43 65 6c 6c 4b 65 79 20  .  i64 nCellKey 
f540: 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  = 0;.  int rc;. 
f550: 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 20   BtCursor *pCur 
f560: 3d 20 70 43 2d 3e 70 43 75 72 73 6f 72 3b 0a 20  = pC->pCursor;. 
f570: 20 69 6e 74 20 6c 65 6e 52 6f 77 69 64 3b 0a 20   int lenRowid;. 
f580: 20 4d 65 6d 20 6d 3b 0a 0a 20 20 73 71 6c 69 74   Mem m;..  sqlit
f590: 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65 28 70  e3BtreeKeySize(p
f5a0: 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29 3b  Cur, &nCellKey);
f5b0: 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c  .  if( nCellKey<
f5c0: 3d 30 20 29 7b 0a 20 20 20 20 2a 72 65 73 20 3d  =0 ){.    *res =
f5d0: 20 30 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   0;.    return S
f5e0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20  QLITE_OK;.  }.  
f5f0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
f600: 4d 65 6d 46 72 6f 6d 42 74 72 65 65 28 70 43 2d  MemFromBtree(pC-
f610: 3e 70 43 75 72 73 6f 72 2c 20 30 2c 20 6e 43 65  >pCursor, 0, nCe
f620: 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20  llKey, 1, &m);. 
f630: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72   if( rc ){.    r
f640: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
f650: 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71 6c 69 74  lenRowid = sqlit
f660: 65 33 56 64 62 65 49 64 78 52 6f 77 69 64 4c 65  e3VdbeIdxRowidLe
f670: 6e 28 28 75 38 2a 29 6d 2e 7a 29 3b 0a 20 20 2a  n((u8*)m.z);.  *
f680: 72 65 73 20 3d 20 73 71 6c 69 74 65 33 56 64 62  res = sqlite3Vdb
f690: 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28 70  eRecordCompare(p
f6a0: 43 2d 3e 70 4b 65 79 49 6e 66 6f 2c 20 6d 2e 6e  C->pKeyInfo, m.n
f6b0: 2d 6c 65 6e 52 6f 77 69 64 2c 20 6d 2e 7a 2c 20  -lenRowid, m.z, 
f6c0: 6e 4b 65 79 2c 20 70 4b 65 79 29 3b 0a 20 20 73  nKey, pKey);.  s
f6d0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
f6e0: 65 61 73 65 28 26 6d 29 3b 0a 20 20 72 65 74 75  ease(&m);.  retu
f6f0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a  rn SQLITE_OK;.}.
f700: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
f710: 69 6e 65 20 73 65 74 73 20 74 68 65 20 76 61 6c  ine sets the val
f720: 75 65 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65  ue to be returne
f730: 64 20 62 79 20 73 75 62 73 65 71 75 65 6e 74 20  d by subsequent 
f740: 63 61 6c 6c 73 20 74 6f 0a 2a 2a 20 73 71 6c 69  calls to.** sqli
f750: 74 65 33 5f 63 68 61 6e 67 65 73 28 29 20 6f 6e  te3_changes() on
f760: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 68 61   the database ha
f770: 6e 64 6c 65 20 27 64 62 27 2e 20 0a 2a 2f 0a 76  ndle 'db'. .*/.v
f780: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53  oid sqlite3VdbeS
f790: 65 74 43 68 61 6e 67 65 73 28 73 71 6c 69 74 65  etChanges(sqlite
f7a0: 33 20 2a 64 62 2c 20 69 6e 74 20 6e 43 68 61 6e  3 *db, int nChan
f7b0: 67 65 29 7b 0a 20 20 64 62 2d 3e 6e 43 68 61 6e  ge){.  db->nChan
f7c0: 67 65 20 3d 20 6e 43 68 61 6e 67 65 3b 0a 20 20  ge = nChange;.  
f7d0: 64 62 2d 3e 6e 54 6f 74 61 6c 43 68 61 6e 67 65  db->nTotalChange
f7e0: 20 2b 3d 20 6e 43 68 61 6e 67 65 3b 0a 7d 0a 0a   += nChange;.}..
f7f0: 2f 2a 0a 2a 2a 20 53 65 74 20 61 20 66 6c 61 67  /*.** Set a flag
f800: 20 69 6e 20 74 68 65 20 76 64 62 65 20 74 6f 20   in the vdbe to 
f810: 75 70 64 61 74 65 20 74 68 65 20 63 68 61 6e 67  update the chang
f820: 65 20 63 6f 75 6e 74 65 72 20 77 68 65 6e 20 69  e counter when i
f830: 74 20 69 73 20 66 69 6e 61 6c 69 73 65 64 0a 2a  t is finalised.*
f840: 2a 20 6f 72 20 72 65 73 65 74 2e 0a 2a 2f 0a 76  * or reset..*/.v
f850: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43  oid sqlite3VdbeC
f860: 6f 75 6e 74 43 68 61 6e 67 65 73 28 56 64 62 65  ountChanges(Vdbe
f870: 20 2a 76 29 7b 0a 20 20 76 2d 3e 63 68 61 6e 67   *v){.  v->chang
f880: 65 43 6e 74 4f 6e 20 3d 20 31 3b 0a 7d 0a 0a 2f  eCntOn = 1;.}../
f890: 2a 0a 2a 2a 20 4d 61 72 6b 20 65 76 65 72 79 20  *.** Mark every 
f8a0: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
f8b0: 6e 74 20 61 73 73 6f 63 69 61 74 65 64 20 77 69  nt associated wi
f8c0: 74 68 20 61 20 64 61 74 61 62 61 73 65 20 63 6f  th a database co
f8d0: 6e 6e 65 63 74 69 6f 6e 0a 2a 2a 20 61 73 20 65  nnection.** as e
f8e0: 78 70 69 72 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 6e  xpired..**.** An
f8f0: 20 65 78 70 69 72 65 64 20 73 74 61 74 65 6d 65   expired stateme
f900: 6e 74 20 6d 65 61 6e 73 20 74 68 61 74 20 72 65  nt means that re
f910: 63 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 66 20 74  compilation of t
f920: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73 0a  he statement is.
f930: 2a 2a 20 72 65 63 6f 6d 6d 65 6e 64 2e 20 20 53  ** recommend.  S
f940: 74 61 74 65 6d 65 6e 74 73 20 65 78 70 69 72 65  tatements expire
f950: 20 77 68 65 6e 20 74 68 69 6e 67 73 20 68 61 70   when things hap
f960: 70 65 6e 20 74 68 61 74 20 6d 61 6b 65 20 74 68  pen that make th
f970: 65 69 72 0a 2a 2a 20 70 72 6f 67 72 61 6d 73 20  eir.** programs 
f980: 6f 62 73 6f 6c 65 74 65 2e 20 20 52 65 6d 6f 76  obsolete.  Remov
f990: 69 6e 67 20 75 73 65 72 2d 64 65 66 69 6e 65 64  ing user-defined
f9a0: 20 66 75 6e 63 74 69 6f 6e 73 20 6f 72 20 63 6f   functions or co
f9b0: 6c 6c 61 74 69 6e 67 0a 2a 2a 20 73 65 71 75 65  llating.** seque
f9c0: 6e 63 65 73 2c 20 6f 72 20 63 68 61 6e 67 69 6e  nces, or changin
f9d0: 67 20 61 6e 20 61 75 74 68 6f 72 69 7a 61 74 69  g an authorizati
f9e0: 6f 6e 20 66 75 6e 63 74 69 6f 6e 20 61 72 65 20  on function are 
f9f0: 74 68 65 20 74 79 70 65 73 20 6f 66 0a 2a 2a 20  the types of.** 
fa00: 74 68 69 6e 67 73 20 74 68 61 74 20 6d 61 6b 65  things that make
fa10: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
fa20: 65 6e 74 73 20 6f 62 73 6f 6c 65 74 65 2e 0a 2a  ents obsolete..*
fa30: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 45 78  /.void sqlite3Ex
fa40: 70 69 72 65 50 72 65 70 61 72 65 64 53 74 61 74  pirePreparedStat
fa50: 65 6d 65 6e 74 73 28 73 71 6c 69 74 65 33 20 2a  ements(sqlite3 *
fa60: 64 62 29 7b 0a 20 20 56 64 62 65 20 2a 70 3b 0a  db){.  Vdbe *p;.
fa70: 20 20 66 6f 72 28 70 20 3d 20 64 62 2d 3e 70 56    for(p = db->pV
fa80: 64 62 65 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65  dbe; p; p=p->pNe
fa90: 78 74 29 7b 0a 20 20 20 20 70 2d 3e 65 78 70 69  xt){.    p->expi
faa0: 72 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 7d 0a 0a  red = 1;.  }.}..
fab0: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65  /*.** Return the
fac0: 20 64 61 74 61 62 61 73 65 20 61 73 73 6f 63 69   database associ
fad0: 61 74 65 64 20 77 69 74 68 20 74 68 65 20 56 64  ated with the Vd
fae0: 62 65 2e 0a 2a 2f 0a 73 71 6c 69 74 65 33 20 2a  be..*/.sqlite3 *
faf0: 73 71 6c 69 74 65 33 56 64 62 65 44 62 28 56 64  sqlite3VdbeDb(Vd
fb00: 62 65 20 2a 76 29 7b 0a 20 20 72 65 74 75 72 6e  be *v){.  return
fb10: 20 76 2d 3e 64 62 3b 0a 7d 0a                     v->db;.}.