/ Hex Artifact Content
Login

Artifact 62011e2ccf5fa9b3dcc7fa6ff5f0e0638d324a70:


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 23 69 66 64 65  = nTmp;.}..#ifde
0830: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 2f  f SQLITE_DEBUG./
0840: 2a 0a 2a 2a 20 54 75 72 6e 20 74 72 61 63 69 6e  *.** Turn tracin
0850: 67 20 6f 6e 20 6f 72 20 6f 66 66 0a 2a 2f 0a 76  g on or off.*/.v
0860: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 54  oid sqlite3VdbeT
0870: 72 61 63 65 28 56 64 62 65 20 2a 70 2c 20 46 49  race(Vdbe *p, FI
0880: 4c 45 20 2a 74 72 61 63 65 29 7b 0a 20 20 70 2d  LE *trace){.  p-
0890: 3e 74 72 61 63 65 20 3d 20 74 72 61 63 65 3b 0a  >trace = trace;.
08a0: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
08b0: 52 65 73 69 7a 65 20 74 68 65 20 56 64 62 65 2e  Resize the Vdbe.
08c0: 61 4f 70 20 61 72 72 61 79 20 73 6f 20 74 68 61  aOp array so tha
08d0: 74 20 69 74 20 63 6f 6e 74 61 69 6e 73 20 61 74  t it contains at
08e0: 20 6c 65 61 73 74 20 4e 0a 2a 2a 20 65 6c 65 6d   least N.** elem
08f0: 65 6e 74 73 2e 20 49 66 20 74 68 65 20 56 64 62  ents. If the Vdb
0900: 65 20 69 73 20 69 6e 20 56 44 42 45 5f 4d 41 47  e is in VDBE_MAG
0910: 49 43 5f 52 55 4e 20 73 74 61 74 65 2c 20 74 68  IC_RUN state, th
0920: 65 6e 0a 2a 2a 20 74 68 65 20 56 64 62 65 2e 61  en.** the Vdbe.a
0930: 4f 70 20 61 72 72 61 79 20 77 69 6c 6c 20 62 65  Op array will be
0940: 20 73 69 7a 65 64 20 74 6f 20 63 6f 6e 74 61 69   sized to contai
0950: 6e 20 65 78 61 63 74 6c 79 20 4e 0a 2a 2a 20 65  n exactly N.** e
0960: 6c 65 6d 65 6e 74 73 2e 20 56 64 62 65 2e 6e 4f  lements. Vdbe.nO
0970: 70 41 6c 6c 6f 63 20 69 73 20 73 65 74 20 74 6f  pAlloc is set to
0980: 20 72 65 66 6c 65 63 74 20 74 68 65 20 6e 65 77   reflect the new
0990: 20 73 69 7a 65 20 6f 66 0a 2a 2a 20 74 68 65 20   size of.** the 
09a0: 61 72 72 61 79 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  array..**.** If 
09b0: 61 6e 20 6f 75 74 2d 6f 66 2d 6d 65 6d 6f 72 79  an out-of-memory
09c0: 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68   error occurs wh
09d0: 69 6c 65 20 72 65 73 69 7a 69 6e 67 20 74 68 65  ile resizing the
09e0: 20 61 72 72 61 79 2c 0a 2a 2a 20 56 64 62 65 2e   array,.** Vdbe.
09f0: 61 4f 70 20 61 6e 64 20 56 64 62 65 2e 6e 4f 70  aOp and Vdbe.nOp
0a00: 41 6c 6c 6f 63 20 72 65 6d 61 69 6e 20 75 6e 63  Alloc remain unc
0a10: 68 61 6e 67 65 64 20 28 74 68 69 73 20 69 73 20  hanged (this is 
0a20: 73 6f 20 74 68 61 74 0a 2a 2a 20 61 6e 79 20 6f  so that.** any o
0a30: 70 63 6f 64 65 73 20 61 6c 72 65 61 64 79 20 61  pcodes already a
0a40: 6c 6c 6f 63 61 74 65 64 20 63 61 6e 20 62 65 20  llocated can be 
0a50: 63 6f 72 72 65 63 74 6c 79 20 64 65 61 6c 6c 6f  correctly deallo
0a60: 63 61 74 65 64 0a 2a 2a 20 61 6c 6f 6e 67 20 77  cated.** along w
0a70: 69 74 68 20 74 68 65 20 72 65 73 74 20 6f 66 20  ith the rest of 
0a80: 74 68 65 20 56 64 62 65 29 2e 0a 2a 2f 0a 73 74  the Vdbe)..*/.st
0a90: 61 74 69 63 20 76 6f 69 64 20 72 65 73 69 7a 65  atic void resize
0aa0: 4f 70 41 72 72 61 79 28 56 64 62 65 20 2a 70 2c  OpArray(Vdbe *p,
0ab0: 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72   int N){.  int r
0ac0: 75 6e 4d 6f 64 65 20 3d 20 70 2d 3e 6d 61 67 69  unMode = p->magi
0ad0: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c==VDBE_MAGIC_RU
0ae0: 4e 3b 0a 20 20 69 66 28 20 72 75 6e 4d 6f 64 65  N;.  if( runMode
0af0: 20 7c 7c 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 3c   || p->nOpAlloc<
0b00: 4e 20 29 7b 0a 20 20 20 20 56 64 62 65 4f 70 20  N ){.    VdbeOp 
0b10: 2a 70 4e 65 77 3b 0a 20 20 20 20 69 6e 74 20 6e  *pNew;.    int n
0b20: 4e 65 77 20 3d 20 4e 20 2b 20 31 30 30 2a 28 21  New = N + 100*(!
0b30: 72 75 6e 4d 6f 64 65 29 3b 0a 20 20 20 20 69 6e  runMode);.    in
0b40: 74 20 6f 6c 64 53 69 7a 65 20 3d 20 70 2d 3e 6e  t oldSize = p->n
0b50: 4f 70 41 6c 6c 6f 63 3b 0a 20 20 20 20 70 4e 65  OpAlloc;.    pNe
0b60: 77 20 3d 20 73 71 6c 69 74 65 52 65 61 6c 6c 6f  w = sqliteReallo
0b70: 63 28 70 2d 3e 61 4f 70 2c 20 6e 4e 65 77 2a 73  c(p->aOp, nNew*s
0b80: 69 7a 65 6f 66 28 4f 70 29 29 3b 0a 20 20 20 20  izeof(Op));.    
0b90: 69 66 28 20 70 4e 65 77 20 29 7b 0a 20 20 20 20  if( pNew ){.    
0ba0: 20 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 20 3d 20    p->nOpAlloc = 
0bb0: 6e 4e 65 77 3b 0a 20 20 20 20 20 20 70 2d 3e 61  nNew;.      p->a
0bc0: 4f 70 20 3d 20 70 4e 65 77 3b 0a 20 20 20 20 20  Op = pNew;.     
0bd0: 20 69 66 28 20 6e 4e 65 77 3e 6f 6c 64 53 69 7a   if( nNew>oldSiz
0be0: 65 20 29 7b 0a 20 20 20 20 20 20 20 20 6d 65 6d  e ){.        mem
0bf0: 73 65 74 28 26 70 2d 3e 61 4f 70 5b 6f 6c 64 53  set(&p->aOp[oldS
0c00: 69 7a 65 5d 2c 20 30 2c 20 28 6e 4e 65 77 2d 6f  ize], 0, (nNew-o
0c10: 6c 64 53 69 7a 65 29 2a 73 69 7a 65 6f 66 28 4f  ldSize)*sizeof(O
0c20: 70 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  p));.      }.   
0c30: 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   }.  }.}../*.** 
0c40: 41 64 64 20 61 20 6e 65 77 20 69 6e 73 74 72 75  Add a new instru
0c50: 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 6c 69 73  ction to the lis
0c60: 74 20 6f 66 20 69 6e 73 74 72 75 63 74 69 6f 6e  t of instruction
0c70: 73 20 63 75 72 72 65 6e 74 20 69 6e 20 74 68 65  s current in the
0c80: 0a 2a 2a 20 56 44 42 45 2e 20 20 52 65 74 75 72  .** VDBE.  Retur
0c90: 6e 20 74 68 65 20 61 64 64 72 65 73 73 20 6f 66  n the address of
0ca0: 20 74 68 65 20 6e 65 77 20 69 6e 73 74 72 75 63   the new instruc
0cb0: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61  tion..**.** Para
0cc0: 6d 65 74 65 72 73 3a 0a 2a 2a 0a 2a 2a 20 20 20  meters:.**.**   
0cd0: 20 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20   p              
0ce0: 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   Pointer to the 
0cf0: 56 44 42 45 0a 2a 2a 0a 2a 2a 20 20 20 20 6f 70  VDBE.**.**    op
0d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 54 68                Th
0d10: 65 20 6f 70 63 6f 64 65 20 66 6f 72 20 74 68 69  e opcode for thi
0d20: 73 20 69 6e 73 74 72 75 63 74 69 6f 6e 0a 2a 2a  s instruction.**
0d30: 0a 2a 2a 20 20 20 20 70 31 2c 20 70 32 20 20 20  .**    p1, p2   
0d40: 20 20 20 20 20 20 20 46 69 72 73 74 20 74 77 6f         First two
0d50: 20 6f 66 20 74 68 65 20 74 68 72 65 65 20 70 6f   of the three po
0d60: 73 73 69 62 6c 65 20 6f 70 65 72 61 6e 64 73 2e  ssible operands.
0d70: 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 65 20 73  .**.** Use the s
0d80: 71 6c 69 74 65 33 56 64 62 65 52 65 73 6f 6c 76  qlite3VdbeResolv
0d90: 65 4c 61 62 65 6c 28 29 20 66 75 6e 63 74 69 6f  eLabel() functio
0da0: 6e 20 74 6f 20 66 69 78 20 61 6e 20 61 64 64 72  n to fix an addr
0db0: 65 73 73 20 61 6e 64 0a 2a 2a 20 74 68 65 20 73  ess and.** the s
0dc0: 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65  qlite3VdbeChange
0dd0: 50 33 28 29 20 66 75 6e 63 74 69 6f 6e 20 74 6f  P3() function to
0de0: 20 63 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75   change the valu
0df0: 65 20 6f 66 20 74 68 65 20 50 33 0a 2a 2a 20 6f  e of the P3.** o
0e00: 70 65 72 61 6e 64 2e 0a 2a 2f 0a 69 6e 74 20 73  perand..*/.int s
0e10: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 28  qlite3VdbeAddOp(
0e20: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6f 70 2c  Vdbe *p, int op,
0e30: 20 69 6e 74 20 70 31 2c 20 69 6e 74 20 70 32 29   int p1, int p2)
0e40: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 56 64 62  {.  int i;.  Vdb
0e50: 65 4f 70 20 2a 70 4f 70 3b 0a 0a 20 20 69 20 3d  eOp *pOp;..  i =
0e60: 20 70 2d 3e 6e 4f 70 3b 0a 20 20 61 73 73 65 72   p->nOp;.  asser
0e70: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
0e80: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
0e90: 20 20 69 66 28 20 70 2d 3e 6e 4f 70 41 6c 6c 6f    if( p->nOpAllo
0ea0: 63 3c 3d 69 20 29 7b 0a 20 20 20 20 72 65 73 69  c<=i ){.    resi
0eb0: 7a 65 4f 70 41 72 72 61 79 28 70 2c 20 69 2b 31  zeOpArray(p, i+1
0ec0: 29 3b 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74  );.    if( sqlit
0ed0: 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29  e3MallocFailed()
0ee0: 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e   ){.      return
0ef0: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20   0;.    }.  }.  
0f00: 70 2d 3e 6e 4f 70 2b 2b 3b 0a 20 20 70 4f 70 20  p->nOp++;.  pOp 
0f10: 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20  = &p->aOp[i];.  
0f20: 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d 20 6f 70  pOp->opcode = op
0f30: 3b 0a 20 20 70 4f 70 2d 3e 70 31 20 3d 20 70 31  ;.  pOp->p1 = p1
0f40: 3b 0a 20 20 70 4f 70 2d 3e 70 32 20 3d 20 70 32  ;.  pOp->p2 = p2
0f50: 3b 0a 20 20 70 4f 70 2d 3e 70 33 20 3d 20 30 3b  ;.  pOp->p3 = 0;
0f60: 0a 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d  .  pOp->p3type =
0f70: 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a 20 20 70   P3_NOTUSED;.  p
0f80: 2d 3e 65 78 70 69 72 65 64 20 3d 20 30 3b 0a 23  ->expired = 0;.#
0f90: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42  ifdef SQLITE_DEB
0fa0: 55 47 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  UG.  if( sqlite3
0fb0: 5f 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63  _vdbe_addop_trac
0fc0: 65 20 29 20 73 71 6c 69 74 65 33 56 64 62 65 50  e ) sqlite3VdbeP
0fd0: 72 69 6e 74 4f 70 28 30 2c 20 69 2c 20 26 70 2d  rintOp(0, i, &p-
0fe0: 3e 61 4f 70 5b 69 5d 29 3b 0a 23 65 6e 64 69 66  >aOp[i]);.#endif
0ff0: 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a 0a  .  return i;.}..
1000: 2f 2a 0a 2a 2a 20 41 64 64 20 61 6e 20 6f 70 63  /*.** Add an opc
1010: 6f 64 65 20 74 68 61 74 20 69 6e 63 6c 75 64 65  ode that include
1020: 73 20 74 68 65 20 70 33 20 76 61 6c 75 65 2e 0a  s the p3 value..
1030: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
1040: 62 65 4f 70 33 28 56 64 62 65 20 2a 70 2c 20 69  beOp3(Vdbe *p, i
1050: 6e 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20 69  nt op, int p1, i
1060: 6e 74 20 70 32 2c 20 63 6f 6e 73 74 20 63 68 61  nt p2, const cha
1070: 72 20 2a 7a 50 33 2c 69 6e 74 20 70 33 74 79 70  r *zP3,int p3typ
1080: 65 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 20 3d  e){.  int addr =
1090: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
10a0: 70 28 70 2c 20 6f 70 2c 20 70 31 2c 20 70 32 29  p(p, op, p1, p2)
10b0: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 43  ;.  sqlite3VdbeC
10c0: 68 61 6e 67 65 50 33 28 70 2c 20 61 64 64 72 2c  hangeP3(p, addr,
10d0: 20 7a 50 33 2c 20 70 33 74 79 70 65 29 3b 0a 20   zP3, p3type);. 
10e0: 20 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d 0a   return addr;.}.
10f0: 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20  ./*.** Create a 
1100: 6e 65 77 20 73 79 6d 62 6f 6c 69 63 20 6c 61 62  new symbolic lab
1110: 65 6c 20 66 6f 72 20 61 6e 20 69 6e 73 74 72 75  el for an instru
1120: 63 74 69 6f 6e 20 74 68 61 74 20 68 61 73 20 79  ction that has y
1130: 65 74 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 64 65  et to be.** code
1140: 64 2e 20 20 54 68 65 20 73 79 6d 62 6f 6c 69 63  d.  The symbolic
1150: 20 6c 61 62 65 6c 20 69 73 20 72 65 61 6c 6c 79   label is really
1160: 20 6a 75 73 74 20 61 20 6e 65 67 61 74 69 76 65   just a negative
1170: 20 6e 75 6d 62 65 72 2e 20 20 54 68 65 0a 2a 2a   number.  The.**
1180: 20 6c 61 62 65 6c 20 63 61 6e 20 62 65 20 75 73   label can be us
1190: 65 64 20 61 73 20 74 68 65 20 50 32 20 76 61 6c  ed as the P2 val
11a0: 75 65 20 6f 66 20 61 6e 20 6f 70 65 72 61 74 69  ue of an operati
11b0: 6f 6e 2e 20 20 4c 61 74 65 72 2c 20 77 68 65 6e  on.  Later, when
11c0: 0a 2a 2a 20 74 68 65 20 6c 61 62 65 6c 20 69 73  .** the label is
11d0: 20 72 65 73 6f 6c 76 65 64 20 74 6f 20 61 20 73   resolved to a s
11e0: 70 65 63 69 66 69 63 20 61 64 64 72 65 73 73 2c  pecific address,
11f0: 20 74 68 65 20 56 44 42 45 20 77 69 6c 6c 20 73   the VDBE will s
1200: 63 61 6e 0a 2a 2a 20 74 68 72 6f 75 67 68 20 69  can.** through i
1210: 74 73 20 6f 70 65 72 61 74 69 6f 6e 20 6c 69 73  ts operation lis
1220: 74 20 61 6e 64 20 63 68 61 6e 67 65 20 61 6c 6c  t and change all
1230: 20 76 61 6c 75 65 73 20 6f 66 20 50 32 20 77 68   values of P2 wh
1240: 69 63 68 20 6d 61 74 63 68 0a 2a 2a 20 74 68 65  ich match.** the
1250: 20 6c 61 62 65 6c 20 69 6e 74 6f 20 74 68 65 20   label into the 
1260: 72 65 73 6f 6c 76 65 64 20 61 64 64 72 65 73 73  resolved address
1270: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 56 44 42 45  ..**.** The VDBE
1280: 20 6b 6e 6f 77 73 20 74 68 61 74 20 61 20 50 32   knows that a P2
1290: 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65   value is a labe
12a0: 6c 20 62 65 63 61 75 73 65 20 6c 61 62 65 6c 73  l because labels
12b0: 20 61 72 65 0a 2a 2a 20 61 6c 77 61 79 73 20 6e   are.** always n
12c0: 65 67 61 74 69 76 65 20 61 6e 64 20 50 32 20 76  egative and P2 v
12d0: 61 6c 75 65 73 20 61 72 65 20 73 75 70 70 6f 73  alues are suppos
12e0: 65 20 74 6f 20 62 65 20 6e 6f 6e 2d 6e 65 67 61  e to be non-nega
12f0: 74 69 76 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c 20  tive..** Hence, 
1300: 61 20 6e 65 67 61 74 69 76 65 20 50 32 20 76 61  a negative P2 va
1310: 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c 20 74  lue is a label t
1320: 68 61 74 20 68 61 73 20 79 65 74 20 74 6f 20 62  hat has yet to b
1330: 65 20 72 65 73 6f 6c 76 65 64 2e 0a 2a 2a 0a 2a  e resolved..**.*
1340: 2a 20 5a 65 72 6f 20 69 73 20 72 65 74 75 72 6e  * Zero is return
1350: 65 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29  ed if a malloc()
1360: 20 66 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20 73   fails..*/.int s
1370: 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61  qlite3VdbeMakeLa
1380: 62 65 6c 28 56 64 62 65 20 2a 70 29 7b 0a 20 20  bel(Vdbe *p){.  
1390: 69 6e 74 20 69 3b 0a 20 20 69 20 3d 20 70 2d 3e  int i;.  i = p->
13a0: 6e 4c 61 62 65 6c 2b 2b 3b 0a 20 20 61 73 73 65  nLabel++;.  asse
13b0: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
13c0: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
13d0: 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4c 61  .  if( i>=p->nLa
13e0: 62 65 6c 41 6c 6c 6f 63 20 29 7b 0a 20 20 20 20  belAlloc ){.    
13f0: 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20 3d  p->nLabelAlloc =
1400: 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 2a   p->nLabelAlloc*
1410: 32 20 2b 20 31 30 3b 0a 20 20 20 20 70 2d 3e 61  2 + 10;.    p->a
1420: 4c 61 62 65 6c 20 3d 20 73 71 6c 69 74 65 52 65  Label = sqliteRe
1430: 61 6c 6c 6f 63 4f 72 46 72 65 65 28 70 2d 3e 61  allocOrFree(p->a
1440: 4c 61 62 65 6c 2c 0a 20 20 20 20 20 20 20 20 20  Label,.         
1450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1460: 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 6e 4c             p->nL
1470: 61 62 65 6c 41 6c 6c 6f 63 2a 73 69 7a 65 6f 66  abelAlloc*sizeof
1480: 28 70 2d 3e 61 4c 61 62 65 6c 5b 30 5d 29 29 3b  (p->aLabel[0]));
1490: 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 61 4c  .  }.  if( p->aL
14a0: 61 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 61  abel ){.    p->a
14b0: 4c 61 62 65 6c 5b 69 5d 20 3d 20 2d 31 3b 0a 20  Label[i] = -1;. 
14c0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 2d 31 2d 69   }.  return -1-i
14d0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73 6f 6c  ;.}../*.** Resol
14e0: 76 65 20 6c 61 62 65 6c 20 22 78 22 20 74 6f 20  ve label "x" to 
14f0: 62 65 20 74 68 65 20 61 64 64 72 65 73 73 20 6f  be the address o
1500: 66 20 74 68 65 20 6e 65 78 74 20 69 6e 73 74 72  f the next instr
1510: 75 63 74 69 6f 6e 20 74 6f 0a 2a 2a 20 62 65 20  uction to.** be 
1520: 69 6e 73 65 72 74 65 64 2e 20 20 54 68 65 20 70  inserted.  The p
1530: 61 72 61 6d 65 74 65 72 20 22 78 22 20 6d 75 73  arameter "x" mus
1540: 74 20 68 61 76 65 20 62 65 65 6e 20 6f 62 74 61  t have been obta
1550: 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 61 20 70  ined from.** a p
1560: 72 69 6f 72 20 63 61 6c 6c 20 74 6f 20 73 71 6c  rior call to sql
1570: 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 65  ite3VdbeMakeLabe
1580: 6c 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  l()..*/.void sql
1590: 69 74 65 33 56 64 62 65 52 65 73 6f 6c 76 65 4c  ite3VdbeResolveL
15a0: 61 62 65 6c 28 56 64 62 65 20 2a 70 2c 20 69 6e  abel(Vdbe *p, in
15b0: 74 20 78 29 7b 0a 20 20 69 6e 74 20 6a 20 3d 20  t x){.  int j = 
15c0: 2d 31 2d 78 3b 0a 20 20 61 73 73 65 72 74 28 20  -1-x;.  assert( 
15d0: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
15e0: 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 61  AGIC_INIT );.  a
15f0: 73 73 65 72 74 28 20 6a 3e 3d 30 20 26 26 20 6a  ssert( j>=0 && j
1600: 3c 70 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a 20 20  <p->nLabel );.  
1610: 69 66 28 20 70 2d 3e 61 4c 61 62 65 6c 20 29 7b  if( p->aLabel ){
1620: 0a 20 20 20 20 70 2d 3e 61 4c 61 62 65 6c 5b 6a  .    p->aLabel[j
1630: 5d 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 7d 0a  ] = p->nOp;.  }.
1640: 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  }../*.** Return 
1650: 6e 6f 6e 2d 7a 65 72 6f 20 69 66 20 6f 70 63 6f  non-zero if opco
1660: 64 65 20 27 6f 70 27 20 69 73 20 67 75 61 72 65  de 'op' is guare
1670: 6e 74 65 65 64 20 6e 6f 74 20 74 6f 20 70 75 73  nteed not to pus
1680: 68 20 6d 6f 72 65 20 76 61 6c 75 65 73 0a 2a 2a  h more values.**
1690: 20 6f 6e 74 6f 20 74 68 65 20 56 44 42 45 20 73   onto the VDBE s
16a0: 74 61 63 6b 20 74 68 61 6e 20 69 74 20 70 6f 70  tack than it pop
16b0: 73 20 6f 66 66 2e 0a 2a 2f 0a 73 74 61 74 69 63  s off..*/.static
16c0: 20 69 6e 74 20 6f 70 63 6f 64 65 4e 6f 50 75 73   int opcodeNoPus
16d0: 68 28 75 38 20 6f 70 29 7b 0a 20 20 2f 2a 20 54  h(u8 op){.  /* T
16e0: 68 65 20 31 30 20 4e 4f 50 55 53 48 5f 4d 41 53  he 10 NOPUSH_MAS
16f0: 4b 5f 6e 20 63 6f 6e 73 74 61 6e 74 73 20 61 72  K_n constants ar
1700: 65 20 64 65 66 69 6e 65 64 20 69 6e 20 74 68 65  e defined in the
1710: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 0a 20   automatically. 
1720: 20 2a 2a 20 67 65 6e 65 72 61 74 65 64 20 68 65   ** generated he
1730: 61 64 65 72 20 66 69 6c 65 20 6f 70 63 6f 64 65  ader file opcode
1740: 73 2e 68 2e 20 45 61 63 68 20 69 73 20 61 20 31  s.h. Each is a 1
1750: 36 2d 62 69 74 20 62 69 74 6d 61 73 6b 2c 20 6f  6-bit bitmask, o
1760: 6e 65 0a 20 20 2a 2a 20 62 69 74 20 63 6f 72 72  ne.  ** bit corr
1770: 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 65 61 63  esponding to eac
1780: 68 20 6f 70 63 6f 64 65 20 69 6d 70 6c 65 6d 65  h opcode impleme
1790: 6e 74 65 64 20 62 79 20 74 68 65 20 76 69 72 74  nted by the virt
17a0: 75 61 6c 0a 20 20 2a 2a 20 6d 61 63 68 69 6e 65  ual.  ** machine
17b0: 20 69 6e 20 76 64 62 65 2e 63 2e 20 54 68 65 20   in vdbe.c. The 
17c0: 62 69 74 20 69 73 20 74 72 75 65 20 69 66 20 74  bit is true if t
17d0: 68 65 20 77 6f 72 64 20 22 6e 6f 2d 70 75 73 68  he word "no-push
17e0: 22 20 61 70 70 65 61 72 73 0a 20 20 2a 2a 20 69  " appears.  ** i
17f0: 6e 20 61 20 63 6f 6d 6d 65 6e 74 20 6f 6e 20 74  n a comment on t
1800: 68 65 20 73 61 6d 65 20 6c 69 6e 65 20 61 73 20  he same line as 
1810: 74 68 65 20 22 63 61 73 65 20 4f 50 5f 58 58 58  the "case OP_XXX
1820: 3a 22 20 69 6e 20 0a 20 20 2a 2a 20 73 71 6c 69  :" in .  ** sqli
1830: 74 65 33 56 64 62 65 45 78 65 63 28 29 20 69 6e  te3VdbeExec() in
1840: 20 76 64 62 65 2e 63 2e 0a 20 20 2a 2a 0a 20 20   vdbe.c..  **.  
1850: 2a 2a 20 49 66 20 74 68 65 20 62 69 74 20 69 73  ** If the bit is
1860: 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68 65 20   true, then the 
1870: 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 6f 70  corresponding op
1880: 63 6f 64 65 20 69 73 20 67 75 61 72 65 6e 74 65  code is guarente
1890: 65 64 20 6e 6f 74 0a 20 20 2a 2a 20 74 6f 20 67  ed not.  ** to g
18a0: 72 6f 77 20 74 68 65 20 73 74 61 63 6b 20 77 68  row the stack wh
18b0: 65 6e 20 69 74 20 69 73 20 65 78 65 63 75 74 65  en it is execute
18c0: 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 74  d. Otherwise, it
18d0: 20 6d 61 79 20 67 72 6f 77 20 74 68 65 0a 20 20   may grow the.  
18e0: 2a 2a 20 73 74 61 63 6b 20 62 79 20 61 74 20 6d  ** stack by at m
18f0: 6f 73 74 20 6f 6e 65 20 65 6e 74 72 79 2e 0a 20  ost one entry.. 
1900: 20 2a 2a 0a 20 20 2a 2a 20 4e 4f 50 55 53 48 5f   **.  ** NOPUSH_
1910: 4d 41 53 4b 5f 30 20 63 6f 72 72 65 73 70 6f 6e  MASK_0 correspon
1920: 64 73 20 74 6f 20 6f 70 63 6f 64 65 73 20 30 20  ds to opcodes 0 
1930: 74 6f 20 31 35 2e 20 4e 4f 50 55 53 48 5f 4d 41  to 15. NOPUSH_MA
1940: 53 4b 5f 31 20 63 6f 6e 74 61 69 6e 73 0a 20 20  SK_1 contains.  
1950: 2a 2a 20 6f 6e 65 20 62 69 74 20 66 6f 72 20 6f  ** one bit for o
1960: 70 63 6f 64 65 73 20 31 36 20 74 6f 20 33 31 2c  pcodes 16 to 31,
1970: 20 61 6e 64 20 73 6f 20 6f 6e 2e 0a 20 20 2a 2a   and so on..  **
1980: 0a 20 20 2a 2a 20 31 36 2d 62 69 74 20 62 69 74  .  ** 16-bit bit
1990: 6d 61 73 6b 73 20 28 72 61 74 68 65 72 20 74 68  masks (rather th
19a0: 61 6e 20 33 32 2d 62 69 74 29 20 61 72 65 20 73  an 32-bit) are s
19b0: 70 65 63 69 66 69 65 64 20 69 6e 20 6f 70 63 6f  pecified in opco
19c0: 64 65 73 2e 68 20 0a 20 20 2a 2a 20 62 65 63 61  des.h .  ** beca
19d0: 75 73 65 20 74 68 65 20 66 69 6c 65 20 69 73 20  use the file is 
19e0: 67 65 6e 65 72 61 74 65 64 20 62 79 20 61 6e 20  generated by an 
19f0: 61 77 6b 20 70 72 6f 67 72 61 6d 2e 20 41 77 6b  awk program. Awk
1a00: 20 6d 61 6e 69 70 75 6c 61 74 65 73 0a 20 20 2a   manipulates.  *
1a10: 2a 20 61 6c 6c 20 6e 75 6d 62 65 72 73 20 61 73  * all numbers as
1a20: 20 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e 74 20   floating-point 
1a30: 61 6e 64 20 77 65 20 64 6f 6e 27 74 20 77 61 6e  and we don't wan
1a40: 74 20 74 6f 20 72 69 73 6b 20 61 20 72 6f 75 6e  t to risk a roun
1a50: 64 69 6e 67 0a 20 20 2a 2a 20 65 72 72 6f 72 20  ding.  ** error 
1a60: 69 66 20 73 6f 6d 65 6f 6e 65 20 62 75 69 6c 64  if someone build
1a70: 73 20 77 69 74 68 20 61 6e 20 61 77 6b 20 74 68  s with an awk th
1a80: 61 74 20 75 73 65 73 20 28 66 6f 72 20 65 78 61  at uses (for exa
1a90: 6d 70 6c 65 29 20 33 32 2d 62 69 74 20 0a 20 20  mple) 32-bit .  
1aa0: 2a 2a 20 49 45 45 45 20 66 6c 6f 61 74 73 2e 0a  ** IEEE floats..
1ab0: 20 20 2a 2f 20 0a 20 20 73 74 61 74 69 63 20 63    */ .  static c
1ac0: 6f 6e 73 74 20 75 33 32 20 6d 61 73 6b 73 5b 35  onst u32 masks[5
1ad0: 5d 20 3d 20 7b 0a 20 20 20 20 4e 4f 50 55 53 48  ] = {.    NOPUSH
1ae0: 5f 4d 41 53 4b 5f 30 20 2b 20 28 28 28 75 6e 73  _MASK_0 + (((uns
1af0: 69 67 6e 65 64 29 4e 4f 50 55 53 48 5f 4d 41 53  igned)NOPUSH_MAS
1b00: 4b 5f 31 29 3c 3c 31 36 29 2c 0a 20 20 20 20 4e  K_1)<<16),.    N
1b10: 4f 50 55 53 48 5f 4d 41 53 4b 5f 32 20 2b 20 28  OPUSH_MASK_2 + (
1b20: 28 28 75 6e 73 69 67 6e 65 64 29 4e 4f 50 55 53  ((unsigned)NOPUS
1b30: 48 5f 4d 41 53 4b 5f 33 29 3c 3c 31 36 29 2c 0a  H_MASK_3)<<16),.
1b40: 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f      NOPUSH_MASK_
1b50: 34 20 2b 20 28 28 28 75 6e 73 69 67 6e 65 64 29  4 + (((unsigned)
1b60: 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 35 29 3c 3c  NOPUSH_MASK_5)<<
1b70: 31 36 29 2c 0a 20 20 20 20 4e 4f 50 55 53 48 5f  16),.    NOPUSH_
1b80: 4d 41 53 4b 5f 36 20 2b 20 28 28 28 75 6e 73 69  MASK_6 + (((unsi
1b90: 67 6e 65 64 29 4e 4f 50 55 53 48 5f 4d 41 53 4b  gned)NOPUSH_MASK
1ba0: 5f 37 29 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f  _7)<<16),.    NO
1bb0: 50 55 53 48 5f 4d 41 53 4b 5f 38 20 2b 20 28 28  PUSH_MASK_8 + ((
1bc0: 28 75 6e 73 69 67 6e 65 64 29 4e 4f 50 55 53 48  (unsigned)NOPUSH
1bd0: 5f 4d 41 53 4b 5f 39 29 3c 3c 31 36 29 0a 20 20  _MASK_9)<<16).  
1be0: 7d 3b 0a 20 20 61 73 73 65 72 74 28 20 6f 70 3c  };.  assert( op<
1bf0: 33 32 2a 35 20 29 3b 0a 20 20 72 65 74 75 72 6e  32*5 );.  return
1c00: 20 28 6d 61 73 6b 73 5b 6f 70 3e 3e 35 5d 20 26   (masks[op>>5] &
1c10: 20 28 31 3c 3c 28 6f 70 26 30 78 31 46 29 29 29   (1<<(op&0x1F)))
1c20: 3b 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 4e 44 45  ;.}..#ifndef NDE
1c30: 42 55 47 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  BUG.int sqlite3V
1c40: 64 62 65 4f 70 63 6f 64 65 4e 6f 50 75 73 68 28  dbeOpcodeNoPush(
1c50: 75 38 20 6f 70 29 7b 0a 20 20 72 65 74 75 72 6e  u8 op){.  return
1c60: 20 6f 70 63 6f 64 65 4e 6f 50 75 73 68 28 6f 70   opcodeNoPush(op
1c70: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  );.}.#endif../*.
1c80: 2a 2a 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20  ** Loop through 
1c90: 74 68 65 20 70 72 6f 67 72 61 6d 20 6c 6f 6f 6b  the program look
1ca0: 69 6e 67 20 66 6f 72 20 50 32 20 76 61 6c 75 65  ing for P2 value
1cb0: 73 20 74 68 61 74 20 61 72 65 20 6e 65 67 61 74  s that are negat
1cc0: 69 76 65 2e 0a 2a 2a 20 45 61 63 68 20 73 75 63  ive..** Each suc
1cd0: 68 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62  h value is a lab
1ce0: 65 6c 2e 20 20 52 65 73 6f 6c 76 65 20 74 68 65  el.  Resolve the
1cf0: 20 6c 61 62 65 6c 20 62 79 20 73 65 74 74 69 6e   label by settin
1d00: 67 20 74 68 65 20 50 32 0a 2a 2a 20 76 61 6c 75  g the P2.** valu
1d10: 65 20 74 6f 20 69 74 73 20 63 6f 72 72 65 63 74  e to its correct
1d20: 20 6e 6f 6e 2d 7a 65 72 6f 20 76 61 6c 75 65 2e   non-zero value.
1d30: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
1d40: 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 6f 6e  ine is called on
1d50: 63 65 20 61 66 74 65 72 20 61 6c 6c 20 6f 70 63  ce after all opc
1d60: 6f 64 65 73 20 68 61 76 65 20 62 65 65 6e 20 69  odes have been i
1d70: 6e 73 65 72 74 65 64 2e 0a 2a 2a 0a 2a 2a 20 56  nserted..**.** V
1d80: 61 72 69 61 62 6c 65 20 2a 70 4d 61 78 46 75 6e  ariable *pMaxFun
1d90: 63 41 72 67 73 20 69 73 20 73 65 74 20 74 6f 20  cArgs is set to 
1da0: 74 68 65 20 6d 61 78 69 6d 75 6d 20 76 61 6c 75  the maximum valu
1db0: 65 20 6f 66 20 61 6e 79 20 50 32 20 61 72 67 75  e of any P2 argu
1dc0: 6d 65 6e 74 20 0a 2a 2a 20 74 6f 20 61 6e 20 4f  ment .** to an O
1dd0: 50 5f 46 75 6e 63 74 69 6f 6e 2c 20 4f 50 5f 41  P_Function, OP_A
1de0: 67 67 53 74 65 70 20 6f 72 20 4f 50 5f 56 46 69  ggStep or OP_VFi
1df0: 6c 74 65 72 20 6f 70 63 6f 64 65 2e 20 54 68 69  lter opcode. Thi
1e00: 73 20 69 73 20 75 73 65 64 20 62 79 20 0a 2a 2a  s is used by .**
1e10: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65   sqlite3VdbeMake
1e20: 52 65 61 64 79 28 29 20 74 6f 20 73 69 7a 65 20  Ready() to size 
1e30: 74 68 65 20 56 64 62 65 2e 61 70 41 72 67 5b 5d  the Vdbe.apArg[]
1e40: 20 61 72 72 61 79 2e 0a 2a 2a 0a 2a 2a 20 54 68   array..**.** Th
1e50: 65 20 69 6e 74 65 67 65 72 20 2a 70 4d 61 78 53  e integer *pMaxS
1e60: 74 61 63 6b 20 69 73 20 73 65 74 20 74 6f 20 74  tack is set to t
1e70: 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65  he maximum numbe
1e80: 72 20 6f 66 20 76 64 62 65 20 73 74 61 63 6b 0a  r of vdbe stack.
1e90: 2a 2a 20 65 6e 74 72 69 65 73 20 74 68 61 74 20  ** entries that 
1ea0: 73 74 61 74 69 63 20 61 6e 61 6c 79 73 69 73 20  static analysis 
1eb0: 72 65 76 65 61 6c 73 20 74 68 69 73 20 70 72 6f  reveals this pro
1ec0: 67 72 61 6d 20 6d 69 67 68 74 20 6e 65 65 64 2e  gram might need.
1ed0: 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  .**.** This rout
1ee0: 69 6e 65 20 61 6c 73 6f 20 64 6f 65 73 20 74 68  ine also does th
1ef0: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69  e following opti
1f00: 6d 69 7a 61 74 69 6f 6e 3a 20 20 49 74 20 73 63  mization:  It sc
1f10: 61 6e 73 20 66 6f 72 0a 2a 2a 20 48 61 6c 74 20  ans for.** Halt 
1f20: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 77 68 65  instructions whe
1f30: 72 65 20 50 31 3d 3d 53 51 4c 49 54 45 5f 43 4f  re P1==SQLITE_CO
1f40: 4e 53 54 52 41 49 4e 54 20 6f 72 20 50 32 3d 3d  NSTRAINT or P2==
1f50: 4f 45 5f 41 62 6f 72 74 20 6f 72 20 66 6f 72 0a  OE_Abort or for.
1f60: 2a 2a 20 49 64 78 49 6e 73 65 72 74 20 69 6e 73  ** IdxInsert ins
1f70: 74 72 75 63 74 69 6f 6e 73 20 77 68 65 72 65 20  tructions where 
1f80: 50 32 21 3d 30 2e 20 20 49 66 20 6e 6f 20 73 75  P2!=0.  If no su
1f90: 63 68 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69  ch instruction i
1fa0: 73 0a 2a 2a 20 66 6f 75 6e 64 2c 20 74 68 65 6e  s.** found, then
1fb0: 20 65 76 65 72 79 20 53 74 61 74 65 6d 65 6e 74   every Statement
1fc0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73 20   instruction is 
1fd0: 63 68 61 6e 67 65 64 20 74 6f 20 61 20 4e 6f 6f  changed to a Noo
1fe0: 70 2e 20 20 49 6e 0a 2a 2a 20 74 68 69 73 20 77  p.  In.** this w
1ff0: 61 79 2c 20 77 65 20 61 76 6f 69 64 20 63 72 65  ay, we avoid cre
2000: 61 74 69 6e 67 20 74 68 65 20 73 74 61 74 65 6d  ating the statem
2010: 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ent journal file
2020: 20 75 6e 6e 65 63 65 73 73 61 72 69 6c 79 2e 0a   unnecessarily..
2030: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72  */.static void r
2040: 65 73 6f 6c 76 65 50 32 56 61 6c 75 65 73 28 56  esolveP2Values(V
2050: 64 62 65 20 2a 70 2c 20 69 6e 74 20 2a 70 4d 61  dbe *p, int *pMa
2060: 78 46 75 6e 63 41 72 67 73 2c 20 69 6e 74 20 2a  xFuncArgs, int *
2070: 70 4d 61 78 53 74 61 63 6b 29 7b 0a 20 20 69 6e  pMaxStack){.  in
2080: 74 20 69 3b 0a 20 20 69 6e 74 20 6e 4d 61 78 41  t i;.  int nMaxA
2090: 72 67 73 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e  rgs = 0;.  int n
20a0: 4d 61 78 53 74 61 63 6b 20 3d 20 70 2d 3e 6e 4f  MaxStack = p->nO
20b0: 70 3b 0a 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 20  p;.  Op *pOp;.  
20c0: 69 6e 74 20 2a 61 4c 61 62 65 6c 20 3d 20 70 2d  int *aLabel = p-
20d0: 3e 61 4c 61 62 65 6c 3b 0a 20 20 69 6e 74 20 64  >aLabel;.  int d
20e0: 6f 65 73 53 74 61 74 65 6d 65 6e 74 52 6f 6c 6c  oesStatementRoll
20f0: 62 61 63 6b 20 3d 20 30 3b 0a 20 20 69 6e 74 20  back = 0;.  int 
2100: 68 61 73 53 74 61 74 65 6d 65 6e 74 42 65 67 69  hasStatementBegi
2110: 6e 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 4f 70  n = 0;.  for(pOp
2120: 3d 70 2d 3e 61 4f 70 2c 20 69 3d 70 2d 3e 6e 4f  =p->aOp, i=p->nO
2130: 70 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 2c 20  p-1; i>=0; i--, 
2140: 70 4f 70 2b 2b 29 7b 0a 20 20 20 20 75 38 20 6f  pOp++){.    u8 o
2150: 70 63 6f 64 65 20 3d 20 70 4f 70 2d 3e 6f 70 63  pcode = pOp->opc
2160: 6f 64 65 3b 0a 0a 20 20 20 20 69 66 28 20 6f 70  ode;..    if( op
2170: 63 6f 64 65 3d 3d 4f 50 5f 46 75 6e 63 74 69 6f  code==OP_Functio
2180: 6e 20 7c 7c 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f  n || opcode==OP_
2190: 41 67 67 53 74 65 70 20 0a 23 69 66 6e 64 65 66  AggStep .#ifndef
21a0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52   SQLITE_OMIT_VIR
21b0: 54 55 41 4c 54 41 42 4c 45 0a 20 20 20 20 20 20  TUALTABLE.      
21c0: 20 20 7c 7c 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f    || opcode==OP_
21d0: 56 55 70 64 61 74 65 0a 23 65 6e 64 69 66 0a 20  VUpdate.#endif. 
21e0: 20 20 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20     ){.      if( 
21f0: 70 4f 70 2d 3e 70 32 3e 6e 4d 61 78 41 72 67 73  pOp->p2>nMaxArgs
2200: 20 29 20 6e 4d 61 78 41 72 67 73 20 3d 20 70 4f   ) nMaxArgs = pO
2210: 70 2d 3e 70 32 3b 0a 20 20 20 20 7d 65 6c 73 65  p->p2;.    }else
2220: 20 69 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f   if( opcode==OP_
2230: 48 61 6c 74 20 29 7b 0a 20 20 20 20 20 20 69 66  Halt ){.      if
2240: 28 20 70 4f 70 2d 3e 70 31 3d 3d 53 51 4c 49 54  ( pOp->p1==SQLIT
2250: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 20 26 26 20  E_CONSTRAINT && 
2260: 70 4f 70 2d 3e 70 32 3d 3d 4f 45 5f 41 62 6f 72  pOp->p2==OE_Abor
2270: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 64 6f 65  t ){.        doe
2280: 73 53 74 61 74 65 6d 65 6e 74 52 6f 6c 6c 62 61  sStatementRollba
2290: 63 6b 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a  ck = 1;.      }.
22a0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6f 70      }else if( op
22b0: 63 6f 64 65 3d 3d 4f 50 5f 53 74 61 74 65 6d 65  code==OP_Stateme
22c0: 6e 74 20 29 7b 0a 20 20 20 20 20 20 68 61 73 53  nt ){.      hasS
22d0: 74 61 74 65 6d 65 6e 74 42 65 67 69 6e 20 3d 20  tatementBegin = 
22e0: 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28  1;.    }else if(
22f0: 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 56 46 69 6c   opcode==OP_VFil
2300: 74 65 72 20 29 7b 0a 20 20 20 20 20 20 69 6e 74  ter ){.      int
2310: 20 6e 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74   n;.      assert
2320: 28 20 70 2d 3e 6e 4f 70 20 2d 20 69 20 3e 3d 20  ( p->nOp - i >= 
2330: 33 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  3 );.      asser
2340: 74 28 20 70 4f 70 5b 2d 32 5d 2e 6f 70 63 6f 64  t( pOp[-2].opcod
2350: 65 3d 3d 4f 50 5f 49 6e 74 65 67 65 72 20 29 3b  e==OP_Integer );
2360: 0a 20 20 20 20 20 20 6e 20 3d 20 70 4f 70 5b 2d  .      n = pOp[-
2370: 32 5d 2e 70 31 3b 0a 20 20 20 20 20 20 69 66 28  2].p1;.      if(
2380: 20 6e 3e 6e 4d 61 78 41 72 67 73 20 29 20 6e 4d   n>nMaxArgs ) nM
2390: 61 78 41 72 67 73 20 3d 20 6e 3b 0a 20 20 20 20  axArgs = n;.    
23a0: 7d 0a 20 20 20 20 69 66 28 20 6f 70 63 6f 64 65  }.    if( opcode
23b0: 4e 6f 50 75 73 68 28 6f 70 63 6f 64 65 29 20 29  NoPush(opcode) )
23c0: 7b 0a 20 20 20 20 20 20 6e 4d 61 78 53 74 61 63  {.      nMaxStac
23d0: 6b 2d 2d 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  k--;.    }..    
23e0: 69 66 28 20 70 4f 70 2d 3e 70 32 3e 3d 30 20 29  if( pOp->p2>=0 )
23f0: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61   continue;.    a
2400: 73 73 65 72 74 28 20 2d 31 2d 70 4f 70 2d 3e 70  ssert( -1-pOp->p
2410: 32 3c 70 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a 20  2<p->nLabel );. 
2420: 20 20 20 70 4f 70 2d 3e 70 32 20 3d 20 61 4c 61     pOp->p2 = aLa
2430: 62 65 6c 5b 2d 31 2d 70 4f 70 2d 3e 70 32 5d 3b  bel[-1-pOp->p2];
2440: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65  .  }.  sqliteFre
2450: 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20  e(p->aLabel);.  
2460: 70 2d 3e 61 4c 61 62 65 6c 20 3d 20 30 3b 0a 0a  p->aLabel = 0;..
2470: 20 20 2a 70 4d 61 78 46 75 6e 63 41 72 67 73 20    *pMaxFuncArgs 
2480: 3d 20 6e 4d 61 78 41 72 67 73 3b 0a 20 20 2a 70  = nMaxArgs;.  *p
2490: 4d 61 78 53 74 61 63 6b 20 3d 20 6e 4d 61 78 53  MaxStack = nMaxS
24a0: 74 61 63 6b 3b 0a 0a 20 20 2f 2a 20 49 66 20 77  tack;..  /* If w
24b0: 65 20 6e 65 76 65 72 20 72 6f 6c 6c 62 61 63 6b  e never rollback
24c0: 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61   a statement tra
24d0: 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 6e 20 73  nsaction, then s
24e0: 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20 74 72  tatement.  ** tr
24f0: 61 6e 73 61 63 74 69 6f 6e 73 20 61 72 65 20 6e  ansactions are n
2500: 6f 74 20 6e 65 65 64 65 64 2e 20 20 53 6f 20 63  ot needed.  So c
2510: 68 61 6e 67 65 20 65 76 65 72 79 20 4f 50 5f 53  hange every OP_S
2520: 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20 6f 70  tatement.  ** op
2530: 63 6f 64 65 20 69 6e 74 6f 20 61 6e 20 4f 50 5f  code into an OP_
2540: 4e 6f 6f 70 2e 20 20 54 68 69 73 20 61 76 6f 69  Noop.  This avoi
2550: 64 20 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69  d a call to sqli
2560: 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69  te3OsOpenExclusi
2570: 76 65 28 29 0a 20 20 2a 2a 20 77 68 69 63 68 20  ve().  ** which 
2580: 63 61 6e 20 62 65 20 65 78 70 65 6e 73 69 76 65  can be expensive
2590: 20 6f 6e 20 73 6f 6d 65 20 70 6c 61 74 66 6f 72   on some platfor
25a0: 6d 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 68  ms..  */.  if( h
25b0: 61 73 53 74 61 74 65 6d 65 6e 74 42 65 67 69 6e  asStatementBegin
25c0: 20 26 26 20 21 64 6f 65 73 53 74 61 74 65 6d 65   && !doesStateme
25d0: 6e 74 52 6f 6c 6c 62 61 63 6b 20 29 7b 0a 20 20  ntRollback ){.  
25e0: 20 20 66 6f 72 28 70 4f 70 3d 70 2d 3e 61 4f 70    for(pOp=p->aOp
25f0: 2c 20 69 3d 70 2d 3e 6e 4f 70 2d 31 3b 20 69 3e  , i=p->nOp-1; i>
2600: 3d 30 3b 20 69 2d 2d 2c 20 70 4f 70 2b 2b 29 7b  =0; i--, pOp++){
2610: 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e  .      if( pOp->
2620: 6f 70 63 6f 64 65 3d 3d 4f 50 5f 53 74 61 74 65  opcode==OP_State
2630: 6d 65 6e 74 20 29 7b 0a 20 20 20 20 20 20 20 20  ment ){.        
2640: 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d 20 4f 50  pOp->opcode = OP
2650: 5f 4e 6f 6f 70 3b 0a 20 20 20 20 20 20 7d 0a 20  _Noop;.      }. 
2660: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a     }.  }.}../*.*
2670: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61 64 64  * Return the add
2680: 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78 74  ress of the next
2690: 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f 20   instruction to 
26a0: 62 65 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2f 0a  be inserted..*/.
26b0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 43  int sqlite3VdbeC
26c0: 75 72 72 65 6e 74 41 64 64 72 28 56 64 62 65 20  urrentAddr(Vdbe 
26d0: 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28 20 70  *p){.  assert( p
26e0: 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41  ->magic==VDBE_MA
26f0: 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 72 65  GIC_INIT );.  re
2700: 74 75 72 6e 20 70 2d 3e 6e 4f 70 3b 0a 7d 0a 0a  turn p->nOp;.}..
2710: 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 77 68 6f 6c  /*.** Add a whol
2720: 65 20 6c 69 73 74 20 6f 66 20 6f 70 65 72 61 74  e list of operat
2730: 69 6f 6e 73 20 74 6f 20 74 68 65 20 6f 70 65 72  ions to the oper
2740: 61 74 69 6f 6e 20 73 74 61 63 6b 2e 20 20 52 65  ation stack.  Re
2750: 74 75 72 6e 20 74 68 65 0a 2a 2a 20 61 64 64 72  turn the.** addr
2760: 65 73 73 20 6f 66 20 74 68 65 20 66 69 72 73 74  ess of the first
2770: 20 6f 70 65 72 61 74 69 6f 6e 20 61 64 64 65 64   operation added
2780: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
2790: 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28 56 64  VdbeAddOpList(Vd
27a0: 62 65 20 2a 70 2c 20 69 6e 74 20 6e 4f 70 2c 20  be *p, int nOp, 
27b0: 56 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e 73 74  VdbeOpList const
27c0: 20 2a 61 4f 70 29 7b 0a 20 20 69 6e 74 20 61 64   *aOp){.  int ad
27d0: 64 72 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d  dr;.  assert( p-
27e0: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
27f0: 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 72 65 73  IC_INIT );.  res
2800: 69 7a 65 4f 70 41 72 72 61 79 28 70 2c 20 70 2d  izeOpArray(p, p-
2810: 3e 6e 4f 70 20 2b 20 6e 4f 70 29 3b 0a 20 20 69  >nOp + nOp);.  i
2820: 66 28 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  f( sqlite3Malloc
2830: 46 61 69 6c 65 64 28 29 20 29 7b 0a 20 20 20 20  Failed() ){.    
2840: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
2850: 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20  addr = p->nOp;. 
2860: 20 69 66 28 20 6e 4f 70 3e 30 20 29 7b 0a 20 20   if( nOp>0 ){.  
2870: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 56 64 62    int i;.    Vdb
2880: 65 4f 70 4c 69 73 74 20 63 6f 6e 73 74 20 2a 70  eOpList const *p
2890: 49 6e 20 3d 20 61 4f 70 3b 0a 20 20 20 20 66 6f  In = aOp;.    fo
28a0: 72 28 69 3d 30 3b 20 69 3c 6e 4f 70 3b 20 69 2b  r(i=0; i<nOp; i+
28b0: 2b 2c 20 70 49 6e 2b 2b 29 7b 0a 20 20 20 20 20  +, pIn++){.     
28c0: 20 69 6e 74 20 70 32 20 3d 20 70 49 6e 2d 3e 70   int p2 = pIn->p
28d0: 32 3b 0a 20 20 20 20 20 20 56 64 62 65 4f 70 20  2;.      VdbeOp 
28e0: 2a 70 4f 75 74 20 3d 20 26 70 2d 3e 61 4f 70 5b  *pOut = &p->aOp[
28f0: 69 2b 61 64 64 72 5d 3b 0a 20 20 20 20 20 20 70  i+addr];.      p
2900: 4f 75 74 2d 3e 6f 70 63 6f 64 65 20 3d 20 70 49  Out->opcode = pI
2910: 6e 2d 3e 6f 70 63 6f 64 65 3b 0a 20 20 20 20 20  n->opcode;.     
2920: 20 70 4f 75 74 2d 3e 70 31 20 3d 20 70 49 6e 2d   pOut->p1 = pIn-
2930: 3e 70 31 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d  >p1;.      pOut-
2940: 3e 70 32 20 3d 20 70 32 3c 30 20 3f 20 61 64 64  >p2 = p2<0 ? add
2950: 72 20 2b 20 41 44 44 52 28 70 32 29 20 3a 20 70  r + ADDR(p2) : p
2960: 32 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e 70  2;.      pOut->p
2970: 33 20 3d 20 70 49 6e 2d 3e 70 33 3b 0a 20 20 20  3 = pIn->p3;.   
2980: 20 20 20 70 4f 75 74 2d 3e 70 33 74 79 70 65 20     pOut->p3type 
2990: 3d 20 70 49 6e 2d 3e 70 33 20 3f 20 50 33 5f 53  = pIn->p3 ? P3_S
29a0: 54 41 54 49 43 20 3a 20 50 33 5f 4e 4f 54 55 53  TATIC : P3_NOTUS
29b0: 45 44 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54  ED;.#ifdef SQLIT
29c0: 45 5f 44 45 42 55 47 0a 20 20 20 20 20 20 69 66  E_DEBUG.      if
29d0: 28 20 73 71 6c 69 74 65 33 5f 76 64 62 65 5f 61  ( sqlite3_vdbe_a
29e0: 64 64 6f 70 5f 74 72 61 63 65 20 29 7b 0a 20 20  ddop_trace ){.  
29f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
2a00: 65 50 72 69 6e 74 4f 70 28 30 2c 20 69 2b 61 64  ePrintOp(0, i+ad
2a10: 64 72 2c 20 26 70 2d 3e 61 4f 70 5b 69 2b 61 64  dr, &p->aOp[i+ad
2a20: 64 72 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65  dr]);.      }.#e
2a30: 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 20 70  ndif.    }.    p
2a40: 2d 3e 6e 4f 70 20 2b 3d 20 6e 4f 70 3b 0a 20 20  ->nOp += nOp;.  
2a50: 7d 0a 20 20 72 65 74 75 72 6e 20 61 64 64 72 3b  }.  return addr;
2a60: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65  .}../*.** Change
2a70: 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68   the value of th
2a80: 65 20 50 31 20 6f 70 65 72 61 6e 64 20 66 6f 72  e P1 operand for
2a90: 20 61 20 73 70 65 63 69 66 69 63 20 69 6e 73 74   a specific inst
2aa0: 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73  ruction..** This
2ab0: 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66   routine is usef
2ac0: 75 6c 20 77 68 65 6e 20 61 20 6c 61 72 67 65 20  ul when a large 
2ad0: 70 72 6f 67 72 61 6d 20 69 73 20 6c 6f 61 64 65  program is loade
2ae0: 64 20 66 72 6f 6d 20 61 0a 2a 2a 20 73 74 61 74  d from a.** stat
2af0: 69 63 20 61 72 72 61 79 20 75 73 69 6e 67 20 73  ic array using s
2b00: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 4c  qlite3VdbeAddOpL
2b10: 69 73 74 20 62 75 74 20 77 65 20 77 61 6e 74 20  ist but we want 
2b20: 74 6f 20 6d 61 6b 65 20 61 0a 2a 2a 20 66 65 77  to make a.** few
2b30: 20 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73 20 74   minor changes t
2b40: 6f 20 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a 2a  o the program..*
2b50: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
2b60: 62 65 43 68 61 6e 67 65 50 31 28 56 64 62 65 20  beChangeP1(Vdbe 
2b70: 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 69 6e  *p, int addr, in
2b80: 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65 72 74  t val){.  assert
2b90: 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e 6d 61 67  ( p==0 || p->mag
2ba0: 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic==VDBE_MAGIC_I
2bb0: 4e 49 54 20 29 3b 0a 20 20 69 66 28 20 70 20 26  NIT );.  if( p &
2bc0: 26 20 61 64 64 72 3e 3d 30 20 26 26 20 70 2d 3e  & addr>=0 && p->
2bd0: 6e 4f 70 3e 61 64 64 72 20 26 26 20 70 2d 3e 61  nOp>addr && p->a
2be0: 4f 70 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4f 70  Op ){.    p->aOp
2bf0: 5b 61 64 64 72 5d 2e 70 31 20 3d 20 76 61 6c 3b  [addr].p1 = val;
2c00: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68  .  }.}../*.** Ch
2c10: 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f  ange the value o
2c20: 66 20 74 68 65 20 50 32 20 6f 70 65 72 61 6e 64  f the P2 operand
2c30: 20 66 6f 72 20 61 20 73 70 65 63 69 66 69 63 20   for a specific 
2c40: 69 6e 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20  instruction..** 
2c50: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
2c60: 75 73 65 66 75 6c 20 66 6f 72 20 73 65 74 74 69  useful for setti
2c70: 6e 67 20 61 20 6a 75 6d 70 20 64 65 73 74 69 6e  ng a jump destin
2c80: 61 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73  ation..*/.void s
2c90: 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65  qlite3VdbeChange
2ca0: 50 32 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  P2(Vdbe *p, int 
2cb0: 61 64 64 72 2c 20 69 6e 74 20 76 61 6c 29 7b 0a  addr, int val){.
2cc0: 20 20 61 73 73 65 72 74 28 20 76 61 6c 3e 3d 30    assert( val>=0
2cd0: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 3d   );.  assert( p=
2ce0: 3d 30 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d  =0 || p->magic==
2cf0: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
2d00: 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 61 64  );.  if( p && ad
2d10: 64 72 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f 70 3e  dr>=0 && p->nOp>
2d20: 61 64 64 72 20 26 26 20 70 2d 3e 61 4f 70 20 29  addr && p->aOp )
2d30: 7b 0a 20 20 20 20 70 2d 3e 61 4f 70 5b 61 64 64  {.    p->aOp[add
2d40: 72 5d 2e 70 32 20 3d 20 76 61 6c 3b 0a 20 20 7d  r].p2 = val;.  }
2d50: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65  .}../*.** Change
2d60: 20 74 68 65 20 50 32 20 6f 70 65 72 61 6e 64 20   the P2 operand 
2d70: 6f 66 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 61  of instruction a
2d80: 64 64 72 20 73 6f 20 74 68 61 74 20 69 74 20 70  ddr so that it p
2d90: 6f 69 6e 74 73 20 74 6f 0a 2a 2a 20 74 68 65 20  oints to.** the 
2da0: 61 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e  address of the n
2db0: 65 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20  ext instruction 
2dc0: 74 6f 20 62 65 20 63 6f 64 65 64 2e 0a 2a 2f 0a  to be coded..*/.
2dd0: 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65  void sqlite3Vdbe
2de0: 4a 75 6d 70 48 65 72 65 28 56 64 62 65 20 2a 70  JumpHere(Vdbe *p
2df0: 2c 20 69 6e 74 20 61 64 64 72 29 7b 0a 20 20 73  , int addr){.  s
2e00: 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65  qlite3VdbeChange
2e10: 50 32 28 70 2c 20 61 64 64 72 2c 20 70 2d 3e 6e  P2(p, addr, p->n
2e20: 4f 70 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49  Op);.}.../*.** I
2e30: 66 20 74 68 65 20 69 6e 70 75 74 20 46 75 6e 63  f the input Func
2e40: 44 65 66 20 73 74 72 75 63 74 75 72 65 20 69 73  Def structure is
2e50: 20 65 70 68 65 6d 65 72 61 6c 2c 20 74 68 65 6e   ephemeral, then
2e60: 20 66 72 65 65 20 69 74 2e 20 20 49 66 0a 2a 2a   free it.  If.**
2e70: 20 74 68 65 20 46 75 6e 63 44 65 66 20 69 73 20   the FuncDef is 
2e80: 6e 6f 74 20 65 70 68 65 72 6d 61 6c 2c 20 74 68  not ephermal, th
2e90: 65 6e 20 64 6f 20 6e 6f 74 68 69 6e 67 2e 0a 2a  en do nothing..*
2ea0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 72  /.static void fr
2eb0: 65 65 45 70 68 65 6d 65 72 61 6c 46 75 6e 63 74  eeEphemeralFunct
2ec0: 69 6f 6e 28 46 75 6e 63 44 65 66 20 2a 70 44 65  ion(FuncDef *pDe
2ed0: 66 29 7b 0a 20 20 69 66 28 20 70 44 65 66 20 26  f){.  if( pDef &
2ee0: 26 20 28 70 44 65 66 2d 3e 66 6c 61 67 73 20 26  & (pDef->flags &
2ef0: 20 53 51 4c 49 54 45 5f 46 55 4e 43 5f 45 50 48   SQLITE_FUNC_EPH
2f00: 45 4d 29 21 3d 30 20 29 7b 0a 20 20 20 20 73 71  EM)!=0 ){.    sq
2f10: 6c 69 74 65 46 72 65 65 28 70 44 65 66 29 3b 0a  liteFree(pDef);.
2f20: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c    }.}../*.** Del
2f30: 65 74 65 20 61 20 50 33 20 76 61 6c 75 65 20 69  ete a P3 value i
2f40: 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a 2f 0a  f necessary..*/.
2f50: 73 74 61 74 69 63 20 76 6f 69 64 20 66 72 65 65  static void free
2f60: 50 33 28 69 6e 74 20 70 33 74 79 70 65 2c 20 76  P3(int p3type, v
2f70: 6f 69 64 20 2a 70 33 29 7b 0a 20 20 69 66 28 20  oid *p3){.  if( 
2f80: 70 33 20 29 7b 0a 20 20 20 20 73 77 69 74 63 68  p3 ){.    switch
2f90: 28 20 70 33 74 79 70 65 20 29 7b 0a 20 20 20 20  ( p3type ){.    
2fa0: 20 20 63 61 73 65 20 50 33 5f 44 59 4e 41 4d 49    case P3_DYNAMI
2fb0: 43 3a 0a 20 20 20 20 20 20 63 61 73 65 20 50 33  C:.      case P3
2fc0: 5f 4b 45 59 49 4e 46 4f 3a 0a 20 20 20 20 20 20  _KEYINFO:.      
2fd0: 63 61 73 65 20 50 33 5f 4b 45 59 49 4e 46 4f 5f  case P3_KEYINFO_
2fe0: 48 41 4e 44 4f 46 46 3a 20 7b 0a 20 20 20 20 20  HANDOFF: {.     
2ff0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 33     sqliteFree(p3
3000: 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  );.        break
3010: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
3020: 63 61 73 65 20 50 33 5f 4d 50 52 49 4e 54 46 3a  case P3_MPRINTF:
3030: 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74   {.        sqlit
3040: 65 33 5f 66 72 65 65 28 70 33 29 3b 0a 20 20 20  e3_free(p3);.   
3050: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
3060: 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 50    }.      case P
3070: 33 5f 56 44 42 45 46 55 4e 43 3a 20 7b 0a 20 20  3_VDBEFUNC: {.  
3080: 20 20 20 20 20 20 56 64 62 65 46 75 6e 63 20 2a        VdbeFunc *
3090: 70 56 64 62 65 46 75 6e 63 20 3d 20 28 56 64 62  pVdbeFunc = (Vdb
30a0: 65 46 75 6e 63 20 2a 29 70 33 3b 0a 20 20 20 20  eFunc *)p3;.    
30b0: 20 20 20 20 66 72 65 65 45 70 68 65 6d 65 72 61      freeEphemera
30c0: 6c 46 75 6e 63 74 69 6f 6e 28 70 56 64 62 65 46  lFunction(pVdbeF
30d0: 75 6e 63 2d 3e 70 46 75 6e 63 29 3b 0a 20 20 20  unc->pFunc);.   
30e0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
30f0: 44 65 6c 65 74 65 41 75 78 44 61 74 61 28 70 56  DeleteAuxData(pV
3100: 64 62 65 46 75 6e 63 2c 20 30 29 3b 0a 20 20 20  dbeFunc, 0);.   
3110: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
3120: 70 56 64 62 65 46 75 6e 63 29 3b 0a 20 20 20 20  pVdbeFunc);.    
3130: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
3140: 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 50 33   }.      case P3
3150: 5f 46 55 4e 43 44 45 46 3a 20 7b 0a 20 20 20 20  _FUNCDEF: {.    
3160: 20 20 20 20 66 72 65 65 45 70 68 65 6d 65 72 61      freeEphemera
3170: 6c 46 75 6e 63 74 69 6f 6e 28 28 46 75 6e 63 44  lFunction((FuncD
3180: 65 66 2a 29 70 33 29 3b 0a 20 20 20 20 20 20 20  ef*)p3);.       
3190: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a   break;.      }.
31a0: 20 20 20 20 20 20 63 61 73 65 20 50 33 5f 4d 45        case P3_ME
31b0: 4d 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  M: {.        sql
31c0: 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 28 73  ite3ValueFree((s
31d0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 2a 29 70 33  qlite3_value*)p3
31e0: 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  );.        break
31f0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
3200: 20 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68    }.}.../*.** Ch
3210: 61 6e 67 65 20 4e 20 6f 70 63 6f 64 65 73 20 73  ange N opcodes s
3220: 74 61 72 74 69 6e 67 20 61 74 20 61 64 64 72 20  tarting at addr 
3230: 74 6f 20 4e 6f 2d 6f 70 73 2e 0a 2a 2f 0a 76 6f  to No-ops..*/.vo
3240: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 43 68  id sqlite3VdbeCh
3250: 61 6e 67 65 54 6f 4e 6f 6f 70 28 56 64 62 65 20  angeToNoop(Vdbe 
3260: 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 69 6e  *p, int addr, in
3270: 74 20 4e 29 7b 0a 20 20 69 66 28 20 70 20 26 26  t N){.  if( p &&
3280: 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 56   p->aOp ){.    V
3290: 64 62 65 4f 70 20 2a 70 4f 70 20 3d 20 26 70 2d  dbeOp *pOp = &p-
32a0: 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 20 20  >aOp[addr];.    
32b0: 77 68 69 6c 65 28 20 4e 2d 2d 20 29 7b 0a 20 20  while( N-- ){.  
32c0: 20 20 20 20 66 72 65 65 50 33 28 70 4f 70 2d 3e      freeP3(pOp->
32d0: 70 33 74 79 70 65 2c 20 70 4f 70 2d 3e 70 33 29  p3type, pOp->p3)
32e0: 3b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 70  ;.      memset(p
32f0: 4f 70 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 4f  Op, 0, sizeof(pO
3300: 70 5b 30 5d 29 29 3b 0a 20 20 20 20 20 20 70 4f  p[0]));.      pO
3310: 70 2d 3e 6f 70 63 6f 64 65 20 3d 20 4f 50 5f 4e  p->opcode = OP_N
3320: 6f 6f 70 3b 0a 20 20 20 20 20 20 70 4f 70 2b 2b  oop;.      pOp++
3330: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f  ;.    }.  }.}../
3340: 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68 65 20  *.** Change the 
3350: 76 61 6c 75 65 20 6f 66 20 74 68 65 20 50 33 20  value of the P3 
3360: 6f 70 65 72 61 6e 64 20 66 6f 72 20 61 20 73 70  operand for a sp
3370: 65 63 69 66 69 63 20 69 6e 73 74 72 75 63 74 69  ecific instructi
3380: 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  on..** This rout
3390: 69 6e 65 20 69 73 20 75 73 65 66 75 6c 20 77 68  ine is useful wh
33a0: 65 6e 20 61 20 6c 61 72 67 65 20 70 72 6f 67 72  en a large progr
33b0: 61 6d 20 69 73 20 6c 6f 61 64 65 64 20 66 72 6f  am is loaded fro
33c0: 6d 20 61 0a 2a 2a 20 73 74 61 74 69 63 20 61 72  m a.** static ar
33d0: 72 61 79 20 75 73 69 6e 67 20 73 71 6c 69 74 65  ray using sqlite
33e0: 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 20 62  3VdbeAddOpList b
33f0: 75 74 20 77 65 20 77 61 6e 74 20 74 6f 20 6d 61  ut we want to ma
3400: 6b 65 20 61 0a 2a 2a 20 66 65 77 20 6d 69 6e 6f  ke a.** few mino
3410: 72 20 63 68 61 6e 67 65 73 20 74 6f 20 74 68 65  r changes to the
3420: 20 70 72 6f 67 72 61 6d 2e 0a 2a 2a 0a 2a 2a 20   program..**.** 
3430: 49 66 20 6e 3e 3d 30 20 74 68 65 6e 20 74 68 65  If n>=0 then the
3440: 20 50 33 20 6f 70 65 72 61 6e 64 20 69 73 20 64   P3 operand is d
3450: 79 6e 61 6d 69 63 2c 20 6d 65 61 6e 69 6e 67 20  ynamic, meaning 
3460: 74 68 61 74 20 61 20 63 6f 70 79 20 6f 66 0a 2a  that a copy of.*
3470: 2a 20 74 68 65 20 73 74 72 69 6e 67 20 69 73 20  * the string is 
3480: 6d 61 64 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79  made into memory
3490: 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 20 73   obtained from s
34a0: 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29 2e 0a 2a  qliteMalloc()..*
34b0: 2a 20 41 20 76 61 6c 75 65 20 6f 66 20 6e 3d 3d  * A value of n==
34c0: 30 20 6d 65 61 6e 73 20 63 6f 70 79 20 62 79 74  0 means copy byt
34d0: 65 73 20 6f 66 20 7a 50 33 20 75 70 20 74 6f 20  es of zP3 up to 
34e0: 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67 20 74 68  and including th
34f0: 65 0a 2a 2a 20 66 69 72 73 74 20 6e 75 6c 6c 20  e.** first null 
3500: 62 79 74 65 2e 20 20 49 66 20 6e 3e 30 20 74 68  byte.  If n>0 th
3510: 65 6e 20 63 6f 70 79 20 6e 2b 31 20 62 79 74 65  en copy n+1 byte
3520: 73 20 6f 66 20 7a 50 33 2e 0a 2a 2a 0a 2a 2a 20  s of zP3..**.** 
3530: 49 66 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f  If n==P3_KEYINFO
3540: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 7a   it means that z
3550: 50 33 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20  P3 is a pointer 
3560: 74 6f 20 61 20 4b 65 79 49 6e 66 6f 20 73 74 72  to a KeyInfo str
3570: 75 63 74 75 72 65 2e 0a 2a 2a 20 41 20 63 6f 70  ucture..** A cop
3580: 79 20 69 73 20 6d 61 64 65 20 6f 66 20 74 68 65  y is made of the
3590: 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75   KeyInfo structu
35a0: 72 65 20 69 6e 74 6f 20 6d 65 6d 6f 72 79 20 6f  re into memory o
35b0: 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20  btained from.** 
35c0: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 2c 20 74 6f  sqliteMalloc, to
35d0: 20 62 65 20 66 72 65 65 64 20 77 68 65 6e 20 74   be freed when t
35e0: 68 65 20 56 64 62 65 20 69 73 20 66 69 6e 61 6c  he Vdbe is final
35f0: 69 7a 65 64 2e 0a 2a 2a 20 6e 3d 3d 50 33 5f 4b  ized..** n==P3_K
3600: 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46 46 20 69  EYINFO_HANDOFF i
3610: 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 7a 50  ndicates that zP
3620: 33 20 70 6f 69 6e 74 73 20 74 6f 20 61 20 4b 65  3 points to a Ke
3630: 79 49 6e 66 6f 20 73 74 72 75 63 74 75 72 65 0a  yInfo structure.
3640: 2a 2a 20 73 74 6f 72 65 64 20 69 6e 20 6d 65 6d  ** stored in mem
3650: 6f 72 79 20 74 68 61 74 20 74 68 65 20 63 61 6c  ory that the cal
3660: 6c 65 72 20 68 61 73 20 6f 62 74 61 69 6e 65 64  ler has obtained
3670: 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d 61 6c 6c   from sqliteMall
3680: 6f 63 2e 20 54 68 65 20 0a 2a 2a 20 63 61 6c 6c  oc. The .** call
3690: 65 72 20 73 68 6f 75 6c 64 20 6e 6f 74 20 66 72  er should not fr
36a0: 65 65 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f  ee the allocatio
36b0: 6e 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 66 72  n, it will be fr
36c0: 65 65 64 20 77 68 65 6e 20 74 68 65 20 56 64 62  eed when the Vdb
36d0: 65 20 69 73 0a 2a 2a 20 66 69 6e 61 6c 69 7a 65  e is.** finalize
36e0: 64 2e 0a 2a 2a 20 0a 2a 2a 20 4f 74 68 65 72 20  d..** .** Other 
36f0: 76 61 6c 75 65 73 20 6f 66 20 6e 20 28 50 33 5f  values of n (P3_
3700: 53 54 41 54 49 43 2c 20 50 33 5f 43 4f 4c 4c 53  STATIC, P3_COLLS
3710: 45 51 20 65 74 63 2e 29 20 69 6e 64 69 63 61 74  EQ etc.) indicat
3720: 65 20 74 68 61 74 20 7a 50 33 20 70 6f 69 6e 74  e that zP3 point
3730: 73 0a 2a 2a 20 74 6f 20 61 20 73 74 72 69 6e 67  s.** to a string
3740: 20 6f 72 20 73 74 72 75 63 74 75 72 65 20 74 68   or structure th
3750: 61 74 20 69 73 20 67 75 61 72 61 6e 74 65 65 64  at is guaranteed
3760: 20 74 6f 20 65 78 69 73 74 20 66 6f 72 20 74 68   to exist for th
3770: 65 20 6c 69 66 65 74 69 6d 65 20 6f 66 0a 2a 2a  e lifetime of.**
3780: 20 74 68 65 20 56 64 62 65 2e 20 49 6e 20 74 68   the Vdbe. In th
3790: 65 73 65 20 63 61 73 65 73 20 77 65 20 63 61 6e  ese cases we can
37a0: 20 6a 75 73 74 20 63 6f 70 79 20 74 68 65 20 70   just copy the p
37b0: 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 66  ointer..**.** If
37c0: 20 61 64 64 72 3c 30 20 74 68 65 6e 20 63 68 61   addr<0 then cha
37d0: 6e 67 65 20 50 33 20 6f 6e 20 74 68 65 20 6d 6f  nge P3 on the mo
37e0: 73 74 20 72 65 63 65 6e 74 6c 79 20 69 6e 73 65  st recently inse
37f0: 72 74 65 64 20 69 6e 73 74 72 75 63 74 69 6f 6e  rted instruction
3800: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
3810: 33 56 64 62 65 43 68 61 6e 67 65 50 33 28 56 64  3VdbeChangeP3(Vd
3820: 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c  be *p, int addr,
3830: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 50 33   const char *zP3
3840: 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 4f 70 20 2a  , int n){.  Op *
3850: 70 4f 70 3b 0a 20 20 61 73 73 65 72 74 28 20 70  pOp;.  assert( p
3860: 3d 3d 30 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d  ==0 || p->magic=
3870: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
3880: 20 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 7c   );.  if( p==0 |
3890: 7c 20 70 2d 3e 61 4f 70 3d 3d 30 20 7c 7c 20 73  | p->aOp==0 || s
38a0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c  qlite3MallocFail
38b0: 65 64 28 29 20 29 7b 0a 20 20 20 20 69 66 20 28  ed() ){.    if (
38c0: 6e 20 21 3d 20 50 33 5f 4b 45 59 49 4e 46 4f 29  n != P3_KEYINFO)
38d0: 20 7b 0a 20 20 20 20 20 20 66 72 65 65 50 33 28   {.      freeP3(
38e0: 6e 2c 20 28 76 6f 69 64 2a 29 2a 28 63 68 61 72  n, (void*)*(char
38f0: 2a 2a 29 26 7a 50 33 29 3b 0a 20 20 20 20 7d 0a  **)&zP3);.    }.
3900: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a      return;.  }.
3910: 20 20 69 66 28 20 61 64 64 72 3c 30 20 7c 7c 20    if( addr<0 || 
3920: 61 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a  addr>=p->nOp ){.
3930: 20 20 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f      addr = p->nO
3940: 70 20 2d 20 31 3b 0a 20 20 20 20 69 66 28 20 61  p - 1;.    if( a
3950: 64 64 72 3c 30 20 29 20 72 65 74 75 72 6e 3b 0a  ddr<0 ) return;.
3960: 20 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e    }.  pOp = &p->
3970: 61 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 66 72 65  aOp[addr];.  fre
3980: 65 50 33 28 70 4f 70 2d 3e 70 33 74 79 70 65 2c  eP3(pOp->p3type,
3990: 20 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 70 4f 70   pOp->p3);.  pOp
39a0: 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 69 66 28 20  ->p3 = 0;.  if( 
39b0: 7a 50 33 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4f  zP3==0 ){.    pO
39c0: 70 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 20 20 70  p->p3 = 0;.    p
39d0: 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f  Op->p3type = P3_
39e0: 4e 4f 54 55 53 45 44 3b 0a 20 20 7d 65 6c 73 65  NOTUSED;.  }else
39f0: 20 69 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e   if( n==P3_KEYIN
3a00: 46 4f 20 29 7b 0a 20 20 20 20 4b 65 79 49 6e 66  FO ){.    KeyInf
3a10: 6f 20 2a 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 20  o *pKeyInfo;.   
3a20: 20 69 6e 74 20 6e 46 69 65 6c 64 2c 20 6e 42 79   int nField, nBy
3a30: 74 65 3b 0a 0a 20 20 20 20 6e 46 69 65 6c 64 20  te;..    nField 
3a40: 3d 20 28 28 4b 65 79 49 6e 66 6f 2a 29 7a 50 33  = ((KeyInfo*)zP3
3a50: 29 2d 3e 6e 46 69 65 6c 64 3b 0a 20 20 20 20 6e  )->nField;.    n
3a60: 42 79 74 65 20 3d 20 73 69 7a 65 6f 66 28 2a 70  Byte = sizeof(*p
3a70: 4b 65 79 49 6e 66 6f 29 20 2b 20 28 6e 46 69 65  KeyInfo) + (nFie
3a80: 6c 64 2d 31 29 2a 73 69 7a 65 6f 66 28 70 4b 65  ld-1)*sizeof(pKe
3a90: 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 30 5d 29  yInfo->aColl[0])
3aa0: 20 2b 20 6e 46 69 65 6c 64 3b 0a 20 20 20 20 70   + nField;.    p
3ab0: 4b 65 79 49 6e 66 6f 20 3d 20 73 71 6c 69 74 65  KeyInfo = sqlite
3ac0: 4d 61 6c 6c 6f 63 52 61 77 28 20 6e 42 79 74 65  MallocRaw( nByte
3ad0: 20 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20   );.    pOp->p3 
3ae0: 3d 20 28 63 68 61 72 2a 29 70 4b 65 79 49 6e 66  = (char*)pKeyInf
3af0: 6f 3b 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49  o;.    if( pKeyI
3b00: 6e 66 6f 20 29 7b 0a 20 20 20 20 20 20 75 6e 73  nfo ){.      uns
3b10: 69 67 6e 65 64 20 63 68 61 72 20 2a 61 53 6f 72  igned char *aSor
3b20: 74 4f 72 64 65 72 3b 0a 20 20 20 20 20 20 6d 65  tOrder;.      me
3b30: 6d 63 70 79 28 70 4b 65 79 49 6e 66 6f 2c 20 7a  mcpy(pKeyInfo, z
3b40: 50 33 2c 20 6e 42 79 74 65 29 3b 0a 20 20 20 20  P3, nByte);.    
3b50: 20 20 61 53 6f 72 74 4f 72 64 65 72 20 3d 20 70    aSortOrder = p
3b60: 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72  KeyInfo->aSortOr
3b70: 64 65 72 3b 0a 20 20 20 20 20 20 69 66 28 20 61  der;.      if( a
3b80: 53 6f 72 74 4f 72 64 65 72 20 29 7b 0a 20 20 20  SortOrder ){.   
3b90: 20 20 20 20 20 70 4b 65 79 49 6e 66 6f 2d 3e 61       pKeyInfo->a
3ba0: 53 6f 72 74 4f 72 64 65 72 20 3d 20 28 75 6e 73  SortOrder = (uns
3bb0: 69 67 6e 65 64 20 63 68 61 72 2a 29 26 70 4b 65  igned char*)&pKe
3bc0: 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6e 46 69  yInfo->aColl[nFi
3bd0: 65 6c 64 5d 3b 0a 20 20 20 20 20 20 20 20 6d 65  eld];.        me
3be0: 6d 63 70 79 28 70 4b 65 79 49 6e 66 6f 2d 3e 61  mcpy(pKeyInfo->a
3bf0: 53 6f 72 74 4f 72 64 65 72 2c 20 61 53 6f 72 74  SortOrder, aSort
3c00: 4f 72 64 65 72 2c 20 6e 46 69 65 6c 64 29 3b 0a  Order, nField);.
3c10: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 4f        }.      pO
3c20: 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4b  p->p3type = P3_K
3c30: 45 59 49 4e 46 4f 3b 0a 20 20 20 20 7d 65 6c 73  EYINFO;.    }els
3c40: 65 7b 0a 20 20 20 20 20 20 70 4f 70 2d 3e 70 33  e{.      pOp->p3
3c50: 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45  type = P3_NOTUSE
3c60: 44 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  D;.    }.  }else
3c70: 20 69 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e   if( n==P3_KEYIN
3c80: 46 4f 5f 48 41 4e 44 4f 46 46 20 29 7b 0a 20 20  FO_HANDOFF ){.  
3c90: 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61    pOp->p3 = (cha
3ca0: 72 2a 29 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d  r*)zP3;.    pOp-
3cb0: 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59  >p3type = P3_KEY
3cc0: 49 4e 46 4f 3b 0a 20 20 7d 65 6c 73 65 20 69 66  INFO;.  }else if
3cd0: 28 20 6e 3c 30 20 29 7b 0a 20 20 20 20 70 4f 70  ( n<0 ){.    pOp
3ce0: 2d 3e 70 33 20 3d 20 28 63 68 61 72 2a 29 7a 50  ->p3 = (char*)zP
3cf0: 33 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79  3;.    pOp->p3ty
3d00: 70 65 20 3d 20 6e 3b 0a 20 20 7d 65 6c 73 65 7b  pe = n;.  }else{
3d10: 0a 20 20 20 20 69 66 28 20 6e 3d 3d 30 20 29 20  .    if( n==0 ) 
3d20: 6e 20 3d 20 73 74 72 6c 65 6e 28 7a 50 33 29 3b  n = strlen(zP3);
3d30: 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 73  .    pOp->p3 = s
3d40: 71 6c 69 74 65 53 74 72 4e 44 75 70 28 7a 50 33  qliteStrNDup(zP3
3d50: 2c 20 6e 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70  , n);.    pOp->p
3d60: 33 74 79 70 65 20 3d 20 50 33 5f 44 59 4e 41 4d  3type = P3_DYNAM
3d70: 49 43 3b 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64  IC;.  }.}..#ifnd
3d80: 65 66 20 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20  ef NDEBUG./*.** 
3d90: 52 65 70 6c 61 63 65 20 74 68 65 20 50 33 20 66  Replace the P3 f
3da0: 69 65 6c 64 20 6f 66 20 74 68 65 20 6d 6f 73 74  ield of the most
3db0: 20 72 65 63 65 6e 74 6c 79 20 63 6f 64 65 64 20   recently coded 
3dc0: 69 6e 73 74 72 75 63 74 69 6f 6e 20 77 69 74 68  instruction with
3dd0: 0a 2a 2a 20 63 6f 6d 6d 65 6e 74 20 74 65 78 74  .** comment text
3de0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
3df0: 33 56 64 62 65 43 6f 6d 6d 65 6e 74 28 56 64 62  3VdbeComment(Vdb
3e00: 65 20 2a 70 2c 20 63 6f 6e 73 74 20 63 68 61 72  e *p, const char
3e10: 20 2a 7a 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b   *zFormat, ...){
3e20: 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20  .  va_list ap;. 
3e30: 20 61 73 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e   assert( p->nOp>
3e40: 30 20 7c 7c 20 70 2d 3e 61 4f 70 3d 3d 30 20 29  0 || p->aOp==0 )
3e50: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61  ;.  assert( p->a
3e60: 4f 70 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 5b  Op==0 || p->aOp[
3e70: 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 3d 3d 30 20  p->nOp-1].p3==0 
3e80: 7c 7c 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63  || sqlite3Malloc
3e90: 46 61 69 6c 65 64 28 29 20 29 3b 0a 20 20 76 61  Failed() );.  va
3ea0: 5f 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d  _start(ap, zForm
3eb0: 61 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64  at);.  sqlite3Vd
3ec0: 62 65 43 68 61 6e 67 65 50 33 28 70 2c 20 2d 31  beChangeP3(p, -1
3ed0: 2c 20 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74  , sqlite3VMPrint
3ee0: 66 28 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c 20  f(zFormat, ap), 
3ef0: 50 33 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20 76  P3_DYNAMIC);.  v
3f00: 61 5f 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65 6e  a_end(ap);.}.#en
3f10: 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  dif../*.** Retur
3f20: 6e 20 74 68 65 20 6f 70 63 6f 64 65 20 66 6f 72  n the opcode for
3f30: 20 61 20 67 69 76 65 6e 20 61 64 64 72 65 73 73   a given address
3f40: 2e 0a 2a 2f 0a 56 64 62 65 4f 70 20 2a 73 71 6c  ..*/.VdbeOp *sql
3f50: 69 74 65 33 56 64 62 65 47 65 74 4f 70 28 56 64  ite3VdbeGetOp(Vd
3f60: 62 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 29  be *p, int addr)
3f70: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d  {.  assert( p->m
3f80: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
3f90: 5f 49 4e 49 54 20 29 3b 0a 20 20 61 73 73 65 72  _INIT );.  asser
3fa0: 74 28 20 28 61 64 64 72 3e 3d 30 20 26 26 20 61  t( (addr>=0 && a
3fb0: 64 64 72 3c 70 2d 3e 6e 4f 70 29 20 7c 7c 20 73  ddr<p->nOp) || s
3fc0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c  qlite3MallocFail
3fd0: 65 64 28 29 20 29 3b 0a 20 20 72 65 74 75 72 6e  ed() );.  return
3fe0: 20 28 28 61 64 64 72 3e 3d 30 20 26 26 20 61 64   ((addr>=0 && ad
3ff0: 64 72 3c 70 2d 3e 6e 4f 70 29 3f 28 26 70 2d 3e  dr<p->nOp)?(&p->
4000: 61 4f 70 5b 61 64 64 72 5d 29 3a 30 29 3b 0a 7d  aOp[addr]):0);.}
4010: 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53  ..#if !defined(S
4020: 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41  QLITE_OMIT_EXPLA
4030: 49 4e 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28  IN) || !defined(
4040: 4e 44 45 42 55 47 29 20 5c 0a 20 20 20 20 20 7c  NDEBUG) \.     |
4050: 7c 20 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50  | defined(VDBE_P
4060: 52 4f 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e  ROFILE) || defin
4070: 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29  ed(SQLITE_DEBUG)
4080: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 61  ./*.** Compute a
4090: 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 73   string that des
40a0: 63 72 69 62 65 73 20 74 68 65 20 50 33 20 70 61  cribes the P3 pa
40b0: 72 61 6d 65 74 65 72 20 66 6f 72 20 61 6e 20 6f  rameter for an o
40c0: 70 63 6f 64 65 2e 0a 2a 2a 20 55 73 65 20 7a 54  pcode..** Use zT
40d0: 65 6d 70 20 66 6f 72 20 61 6e 79 20 72 65 71 75  emp for any requ
40e0: 69 72 65 64 20 74 65 6d 70 6f 72 61 72 79 20 62  ired temporary b
40f0: 75 66 66 65 72 20 73 70 61 63 65 2e 0a 2a 2f 0a  uffer space..*/.
4100: 73 74 61 74 69 63 20 63 68 61 72 20 2a 64 69 73  static char *dis
4110: 70 6c 61 79 50 33 28 4f 70 20 2a 70 4f 70 2c 20  playP3(Op *pOp, 
4120: 63 68 61 72 20 2a 7a 54 65 6d 70 2c 20 69 6e 74  char *zTemp, int
4130: 20 6e 54 65 6d 70 29 7b 0a 20 20 63 68 61 72 20   nTemp){.  char 
4140: 2a 7a 50 33 3b 0a 20 20 61 73 73 65 72 74 28 20  *zP3;.  assert( 
4150: 6e 54 65 6d 70 3e 3d 32 30 20 29 3b 0a 20 20 73  nTemp>=20 );.  s
4160: 77 69 74 63 68 28 20 70 4f 70 2d 3e 70 33 74 79  witch( pOp->p3ty
4170: 70 65 20 29 7b 0a 20 20 20 20 63 61 73 65 20 50  pe ){.    case P
4180: 33 5f 4b 45 59 49 4e 46 4f 3a 20 7b 0a 20 20 20  3_KEYINFO: {.   
4190: 20 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 20     int i, j;.   
41a0: 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79     KeyInfo *pKey
41b0: 49 6e 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a  Info = (KeyInfo*
41c0: 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20  )pOp->p3;.      
41d0: 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66  sqlite3_snprintf
41e0: 28 6e 54 65 6d 70 2c 20 7a 54 65 6d 70 2c 20 22  (nTemp, zTemp, "
41f0: 6b 65 79 69 6e 66 6f 28 25 64 22 2c 20 70 4b 65  keyinfo(%d", pKe
4200: 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 29 3b 0a  yInfo->nField);.
4210: 20 20 20 20 20 20 69 20 3d 20 73 74 72 6c 65 6e        i = strlen
4220: 28 7a 54 65 6d 70 29 3b 0a 20 20 20 20 20 20 66  (zTemp);.      f
4230: 6f 72 28 6a 3d 30 3b 20 6a 3c 70 4b 65 79 49 6e  or(j=0; j<pKeyIn
4240: 66 6f 2d 3e 6e 46 69 65 6c 64 3b 20 6a 2b 2b 29  fo->nField; j++)
4250: 7b 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65  {.        CollSe
4260: 71 20 2a 70 43 6f 6c 6c 20 3d 20 70 4b 65 79 49  q *pColl = pKeyI
4270: 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20  nfo->aColl[j];. 
4280: 20 20 20 20 20 20 20 69 66 28 20 70 43 6f 6c 6c         if( pColl
4290: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e   ){.          in
42a0: 74 20 6e 20 3d 20 73 74 72 6c 65 6e 28 70 43 6f  t n = strlen(pCo
42b0: 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20  ll->zName);.    
42c0: 20 20 20 20 20 20 69 66 28 20 69 2b 6e 3e 6e 54        if( i+n>nT
42d0: 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20 20 20  emp-6 ){.       
42e0: 20 20 20 20 20 6d 65 6d 63 70 79 28 26 7a 54 65       memcpy(&zTe
42f0: 6d 70 5b 69 5d 2c 22 2c 2e 2e 2e 22 2c 34 29 3b  mp[i],",...",4);
4300: 0a 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65  .            bre
4310: 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  ak;.          }.
4320: 20 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b            zTemp[
4330: 69 2b 2b 5d 20 3d 20 27 2c 27 3b 0a 20 20 20 20  i++] = ',';.    
4340: 20 20 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e        if( pKeyIn
4350: 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20 26  fo->aSortOrder &
4360: 26 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  & pKeyInfo->aSor
4370: 74 4f 72 64 65 72 5b 6a 5d 20 29 7b 0a 20 20 20  tOrder[j] ){.   
4380: 20 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69           zTemp[i
4390: 2b 2b 5d 20 3d 20 27 2d 27 3b 0a 20 20 20 20 20  ++] = '-';.     
43a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
43b0: 20 6d 65 6d 63 70 79 28 26 7a 54 65 6d 70 5b 69   memcpy(&zTemp[i
43c0: 5d 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 2c  ], pColl->zName,
43d0: 6e 2b 31 29 3b 0a 20 20 20 20 20 20 20 20 20 20  n+1);.          
43e0: 69 20 2b 3d 20 6e 3b 0a 20 20 20 20 20 20 20 20  i += n;.        
43f0: 7d 65 6c 73 65 20 69 66 28 20 69 2b 34 3c 6e 54  }else if( i+4<nT
4400: 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20 20 20  emp-6 ){.       
4410: 20 20 20 6d 65 6d 63 70 79 28 26 7a 54 65 6d 70     memcpy(&zTemp
4420: 5b 69 5d 2c 22 2c 6e 69 6c 22 2c 34 29 3b 0a 20  [i],",nil",4);. 
4430: 20 20 20 20 20 20 20 20 20 69 20 2b 3d 20 34 3b           i += 4;
4440: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
4450: 20 7d 0a 20 20 20 20 20 20 7a 54 65 6d 70 5b 69   }.      zTemp[i
4460: 2b 2b 5d 20 3d 20 27 29 27 3b 0a 20 20 20 20 20  ++] = ')';.     
4470: 20 7a 54 65 6d 70 5b 69 5d 20 3d 20 30 3b 0a 20   zTemp[i] = 0;. 
4480: 20 20 20 20 20 61 73 73 65 72 74 28 20 69 3c 6e       assert( i<n
4490: 54 65 6d 70 20 29 3b 0a 20 20 20 20 20 20 7a 50  Temp );.      zP
44a0: 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20  3 = zTemp;.     
44b0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
44c0: 20 20 63 61 73 65 20 50 33 5f 43 4f 4c 4c 53 45    case P3_COLLSE
44d0: 51 3a 20 7b 0a 20 20 20 20 20 20 43 6f 6c 6c 53  Q: {.      CollS
44e0: 65 71 20 2a 70 43 6f 6c 6c 20 3d 20 28 43 6f 6c  eq *pColl = (Col
44f0: 6c 53 65 71 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20  lSeq*)pOp->p3;. 
4500: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 73 6e 70       sqlite3_snp
4510: 72 69 6e 74 66 28 6e 54 65 6d 70 2c 20 7a 54 65  rintf(nTemp, zTe
4520: 6d 70 2c 20 22 63 6f 6c 6c 73 65 71 28 25 2e 32  mp, "collseq(%.2
4530: 30 73 29 22 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61  0s)", pColl->zNa
4540: 6d 65 29 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d  me);.      zP3 =
4550: 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20 20 62 72   zTemp;.      br
4560: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
4570: 61 73 65 20 50 33 5f 46 55 4e 43 44 45 46 3a 20  ase P3_FUNCDEF: 
4580: 7b 0a 20 20 20 20 20 20 46 75 6e 63 44 65 66 20  {.      FuncDef 
4590: 2a 70 44 65 66 20 3d 20 28 46 75 6e 63 44 65 66  *pDef = (FuncDef
45a0: 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20  *)pOp->p3;.     
45b0: 20 73 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74   sqlite3_snprint
45c0: 66 28 6e 54 65 6d 70 2c 20 7a 54 65 6d 70 2c 20  f(nTemp, zTemp, 
45d0: 22 25 73 28 25 64 29 22 2c 20 70 44 65 66 2d 3e  "%s(%d)", pDef->
45e0: 7a 4e 61 6d 65 2c 20 70 44 65 66 2d 3e 6e 41 72  zName, pDef->nAr
45f0: 67 29 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20  g);.      zP3 = 
4600: 7a 54 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65  zTemp;.      bre
4610: 61 6b 3b 0a 20 20 20 20 7d 0a 23 69 66 6e 64 65  ak;.    }.#ifnde
4620: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49  f SQLITE_OMIT_VI
4630: 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 20 20 63  RTUALTABLE.    c
4640: 61 73 65 20 50 33 5f 56 54 41 42 3a 20 7b 0a 20  ase P3_VTAB: {. 
4650: 20 20 20 20 20 73 71 6c 69 74 65 33 5f 76 74 61       sqlite3_vta
4660: 62 20 2a 70 56 74 61 62 20 3d 20 28 73 71 6c 69  b *pVtab = (sqli
4670: 74 65 33 5f 76 74 61 62 2a 29 70 4f 70 2d 3e 70  te3_vtab*)pOp->p
4680: 33 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  3;.      sqlite3
4690: 5f 73 6e 70 72 69 6e 74 66 28 6e 54 65 6d 70 2c  _snprintf(nTemp,
46a0: 20 7a 54 65 6d 70 2c 20 22 76 74 61 62 3a 25 70   zTemp, "vtab:%p
46b0: 3a 25 70 22 2c 20 70 56 74 61 62 2c 20 70 56 74  :%p", pVtab, pVt
46c0: 61 62 2d 3e 70 4d 6f 64 75 6c 65 29 3b 0a 20 20  ab->pModule);.  
46d0: 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b      zP3 = zTemp;
46e0: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  .      break;.  
46f0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 64    }.#endif.    d
4700: 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20  efault: {.      
4710: 7a 50 33 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20  zP3 = pOp->p3;. 
4720: 20 20 20 20 20 69 66 28 20 7a 50 33 3d 3d 30 20       if( zP3==0 
4730: 7c 7c 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d  || pOp->opcode==
4740: 4f 50 5f 4e 6f 6f 70 20 29 7b 0a 20 20 20 20 20  OP_Noop ){.     
4750: 20 20 20 7a 50 33 20 3d 20 22 22 3b 0a 20 20 20     zP3 = "";.   
4760: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20     }.    }.  }. 
4770: 20 61 73 73 65 72 74 28 20 7a 50 33 21 3d 30 20   assert( zP3!=0 
4780: 29 3b 0a 20 20 72 65 74 75 72 6e 20 7a 50 33 3b  );.  return zP3;
4790: 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 20  .}.#endif...#if 
47a0: 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f  defined(VDBE_PRO
47b0: 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65 64  FILE) || defined
47c0: 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f  (SQLITE_DEBUG)./
47d0: 2a 0a 2a 2a 20 50 72 69 6e 74 20 61 20 73 69 6e  *.** Print a sin
47e0: 67 6c 65 20 6f 70 63 6f 64 65 2e 20 20 54 68 69  gle opcode.  Thi
47f0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65  s routine is use
4800: 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 20  d for debugging 
4810: 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  only..*/.void sq
4820: 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70  lite3VdbePrintOp
4830: 28 46 49 4c 45 20 2a 70 4f 75 74 2c 20 69 6e 74  (FILE *pOut, int
4840: 20 70 63 2c 20 4f 70 20 2a 70 4f 70 29 7b 0a 20   pc, Op *pOp){. 
4850: 20 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 63 68   char *zP3;.  ch
4860: 61 72 20 7a 50 74 72 5b 35 30 5d 3b 0a 20 20 73  ar zPtr[50];.  s
4870: 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72  tatic const char
4880: 20 2a 7a 46 6f 72 6d 61 74 31 20 3d 20 22 25 34   *zFormat1 = "%4
4890: 64 20 25 2d 31 33 73 20 25 34 64 20 25 34 64 20  d %-13s %4d %4d 
48a0: 25 73 5c 6e 22 3b 0a 20 20 69 66 28 20 70 4f 75  %s\n";.  if( pOu
48b0: 74 3d 3d 30 20 29 20 70 4f 75 74 20 3d 20 73 74  t==0 ) pOut = st
48c0: 64 6f 75 74 3b 0a 20 20 7a 50 33 20 3d 20 64 69  dout;.  zP3 = di
48d0: 73 70 6c 61 79 50 33 28 70 4f 70 2c 20 7a 50 74  splayP3(pOp, zPt
48e0: 72 2c 20 73 69 7a 65 6f 66 28 7a 50 74 72 29 29  r, sizeof(zPtr))
48f0: 3b 0a 20 20 66 70 72 69 6e 74 66 28 70 4f 75 74  ;.  fprintf(pOut
4900: 2c 20 7a 46 6f 72 6d 61 74 31 2c 0a 20 20 20 20  , zFormat1,.    
4910: 20 20 70 63 2c 20 73 71 6c 69 74 65 33 4f 70 63    pc, sqlite3Opc
4920: 6f 64 65 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70  odeNames[pOp->op
4930: 63 6f 64 65 5d 2c 20 70 4f 70 2d 3e 70 31 2c 20  code], pOp->p1, 
4940: 70 4f 70 2d 3e 70 32 2c 20 7a 50 33 29 3b 0a 20  pOp->p2, zP3);. 
4950: 20 66 66 6c 75 73 68 28 70 4f 75 74 29 3b 0a 7d   fflush(pOut);.}
4960: 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52  .#endif../*.** R
4970: 65 6c 65 61 73 65 20 61 6e 20 61 72 72 61 79 20  elease an array 
4980: 6f 66 20 4e 20 4d 65 6d 20 65 6c 65 6d 65 6e 74  of N Mem element
4990: 73 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  s.*/.static void
49a0: 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79   releaseMemArray
49b0: 28 4d 65 6d 20 2a 70 2c 20 69 6e 74 20 4e 29 7b  (Mem *p, int N){
49c0: 0a 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20  .  if( p ){.    
49d0: 77 68 69 6c 65 28 20 4e 2d 2d 3e 30 20 29 7b 0a  while( N-->0 ){.
49e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
49f0: 65 4d 65 6d 52 65 6c 65 61 73 65 28 70 2b 2b 29  eMemRelease(p++)
4a00: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 23  ;.    }.  }.}..#
4a10: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
4a20: 49 54 5f 45 58 50 4c 41 49 4e 0a 2f 2a 0a 2a 2a  IT_EXPLAIN./*.**
4a30: 20 47 69 76 65 20 61 20 6c 69 73 74 69 6e 67 20   Give a listing 
4a40: 6f 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20 69  of the program i
4a50: 6e 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61  n the virtual ma
4a60: 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  chine..**.** The
4a70: 20 69 6e 74 65 72 66 61 63 65 20 69 73 20 74 68   interface is th
4a80: 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74 65  e same as sqlite
4a90: 33 56 64 62 65 45 78 65 63 28 29 2e 20 20 42 75  3VdbeExec().  Bu
4aa0: 74 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 20  t instead of.** 
4ab0: 72 75 6e 6e 69 6e 67 20 74 68 65 20 63 6f 64 65  running the code
4ac0: 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68 65  , it invokes the
4ad0: 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20 66   callback once f
4ae0: 6f 72 20 65 61 63 68 20 69 6e 73 74 72 75 63 74  or each instruct
4af0: 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 66 65 61  ion..** This fea
4b00: 74 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20  ture is used to 
4b10: 69 6d 70 6c 65 6d 65 6e 74 20 22 45 58 50 4c 41  implement "EXPLA
4b20: 49 4e 22 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  IN"..*/.int sqli
4b30: 74 65 33 56 64 62 65 4c 69 73 74 28 0a 20 20 56  te3VdbeList(.  V
4b40: 64 62 65 20 2a 70 20 20 20 20 20 20 20 20 20 20  dbe *p          
4b50: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
4b60: 56 44 42 45 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c  VDBE */.){.  sql
4b70: 69 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 62  ite3 *db = p->db
4b80: 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74  ;.  int i;.  int
4b90: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
4ba0: 0a 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65  ..  assert( p->e
4bb0: 78 70 6c 61 69 6e 20 29 3b 0a 20 20 69 66 28 20  xplain );.  if( 
4bc0: 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d  p->magic!=VDBE_M
4bd0: 41 47 49 43 5f 52 55 4e 20 29 20 72 65 74 75 72  AGIC_RUN ) retur
4be0: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
4bf0: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6d  .  assert( db->m
4c00: 61 67 69 63 3d 3d 53 51 4c 49 54 45 5f 4d 41 47  agic==SQLITE_MAG
4c10: 49 43 5f 42 55 53 59 20 29 3b 0a 20 20 61 73 73  IC_BUSY );.  ass
4c20: 65 72 74 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49  ert( p->rc==SQLI
4c30: 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 72 63 3d 3d  TE_OK || p->rc==
4c40: 53 51 4c 49 54 45 5f 42 55 53 59 20 29 3b 0a 0a  SQLITE_BUSY );..
4c50: 20 20 2f 2a 20 45 76 65 6e 20 74 68 6f 75 67 68    /* Even though
4c60: 20 74 68 69 73 20 6f 70 63 6f 64 65 20 64 6f 65   this opcode doe
4c70: 73 20 6e 6f 74 20 70 75 74 20 64 79 6e 61 6d 69  s not put dynami
4c80: 63 20 73 74 72 69 6e 67 73 20 6f 6e 74 6f 20 74  c strings onto t
4c90: 68 65 0a 20 20 2a 2a 20 74 68 65 20 73 74 61 63  he.  ** the stac
4ca0: 6b 2c 20 74 68 65 79 20 6d 61 79 20 62 65 63 6f  k, they may beco
4cb0: 6d 65 20 64 79 6e 61 6d 69 63 20 69 66 20 74 68  me dynamic if th
4cc0: 65 20 75 73 65 72 20 63 61 6c 6c 73 0a 20 20 2a  e user calls.  *
4cd0: 2a 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e  * sqlite3_column
4ce0: 5f 74 65 78 74 31 36 28 29 2c 20 63 61 75 73 69  _text16(), causi
4cf0: 6e 67 20 61 20 74 72 61 6e 73 6c 61 74 69 6f 6e  ng a translation
4d00: 20 74 6f 20 55 54 46 2d 31 36 20 65 6e 63 6f 64   to UTF-16 encod
4d10: 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20  ing..  */.  if( 
4d20: 70 2d 3e 70 54 6f 73 3d 3d 26 70 2d 3e 61 53 74  p->pTos==&p->aSt
4d30: 61 63 6b 5b 34 5d 20 29 7b 0a 20 20 20 20 72 65  ack[4] ){.    re
4d40: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d  leaseMemArray(p-
4d50: 3e 61 53 74 61 63 6b 2c 20 35 29 3b 0a 20 20 7d  >aStack, 5);.  }
4d60: 0a 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63 6b  .  p->resOnStack
4d70: 20 3d 20 30 3b 0a 0a 20 20 64 6f 7b 0a 20 20 20   = 0;..  do{.   
4d80: 20 69 20 3d 20 70 2d 3e 70 63 2b 2b 3b 0a 20 20   i = p->pc++;.  
4d90: 7d 77 68 69 6c 65 28 20 69 3c 70 2d 3e 6e 4f 70  }while( i<p->nOp
4da0: 20 26 26 20 70 2d 3e 65 78 70 6c 61 69 6e 3d 3d   && p->explain==
4db0: 32 20 26 26 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f  2 && p->aOp[i].o
4dc0: 70 63 6f 64 65 21 3d 4f 50 5f 45 78 70 6c 61 69  pcode!=OP_Explai
4dd0: 6e 20 29 3b 0a 20 20 69 66 28 20 69 3e 3d 70 2d  n );.  if( i>=p-
4de0: 3e 6e 4f 70 20 29 7b 0a 20 20 20 20 70 2d 3e 72  >nOp ){.    p->r
4df0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
4e00: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 44     rc = SQLITE_D
4e10: 4f 4e 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  ONE;.  }else if(
4e20: 20 64 62 2d 3e 75 31 2e 69 73 49 6e 74 65 72 72   db->u1.isInterr
4e30: 75 70 74 65 64 20 29 7b 0a 20 20 20 20 70 2d 3e  upted ){.    p->
4e40: 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45  rc = SQLITE_INTE
4e50: 52 52 55 50 54 3b 0a 20 20 20 20 72 63 20 3d 20  RRUPT;.    rc = 
4e60: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20  SQLITE_ERROR;.  
4e70: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
4e80: 6e 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67 2c 20  ng(&p->zErrMsg, 
4e90: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 70 2d  sqlite3ErrStr(p-
4ea0: 3e 72 63 29 2c 20 28 63 68 61 72 2a 29 30 29 3b  >rc), (char*)0);
4eb0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 4f 70  .  }else{.    Op
4ec0: 20 2a 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b   *pOp = &p->aOp[
4ed0: 69 5d 3b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65  i];.    Mem *pMe
4ee0: 6d 20 3d 20 70 2d 3e 61 53 74 61 63 6b 3b 0a 20  m = p->aStack;. 
4ef0: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
4f00: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d   MEM_Int;.    pM
4f10: 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54  em->type = SQLIT
4f20: 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70  E_INTEGER;.    p
4f30: 4d 65 6d 2d 3e 75 2e 69 20 3d 20 69 3b 20 20 20  Mem->u.i = i;   
4f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4f50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4f60: 50 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 20  Program counter 
4f70: 2a 2f 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a  */.    pMem++;..
4f80: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
4f90: 3d 20 4d 45 4d 5f 53 74 61 74 69 63 7c 4d 45 4d  = MEM_Static|MEM
4fa0: 5f 53 74 72 7c 4d 45 4d 5f 54 65 72 6d 3b 0a 20  _Str|MEM_Term;. 
4fb0: 20 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 28 63 68     pMem->z = (ch
4fc0: 61 72 2a 29 73 71 6c 69 74 65 33 4f 70 63 6f 64  ar*)sqlite3Opcod
4fd0: 65 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70 63 6f  eNames[pOp->opco
4fe0: 64 65 5d 3b 20 20 2f 2a 20 4f 70 63 6f 64 65 20  de];  /* Opcode 
4ff0: 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  */.    assert( p
5000: 4d 65 6d 2d 3e 7a 21 3d 30 20 29 3b 0a 20 20 20  Mem->z!=0 );.   
5010: 20 70 4d 65 6d 2d 3e 6e 20 3d 20 73 74 72 6c 65   pMem->n = strle
5020: 6e 28 70 4d 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20  n(pMem->z);.    
5030: 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c  pMem->type = SQL
5040: 49 54 45 5f 54 45 58 54 3b 0a 20 20 20 20 70 4d  ITE_TEXT;.    pM
5050: 65 6d 2d 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45  em->enc = SQLITE
5060: 5f 55 54 46 38 3b 0a 20 20 20 20 70 4d 65 6d 2b  _UTF8;.    pMem+
5070: 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c  +;..    pMem->fl
5080: 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20  ags = MEM_Int;. 
5090: 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20 70     pMem->u.i = p
50a0: 4f 70 2d 3e 70 31 3b 20 20 20 20 20 20 20 20 20  Op->p1;         
50b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
50c0: 20 2f 2a 20 50 31 20 2a 2f 0a 20 20 20 20 70 4d   /* P1 */.    pM
50d0: 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54  em->type = SQLIT
50e0: 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70  E_INTEGER;.    p
50f0: 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d  Mem++;..    pMem
5100: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
5110: 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69  t;.    pMem->u.i
5120: 20 3d 20 70 4f 70 2d 3e 70 32 3b 20 20 20 20 20   = pOp->p2;     
5130: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5140: 20 20 20 20 20 2f 2a 20 50 32 20 2a 2f 0a 20 20       /* P2 */.  
5150: 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53    pMem->type = S
5160: 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b 0a 20  QLITE_INTEGER;. 
5170: 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20     pMem++;..    
5180: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
5190: 4d 5f 45 70 68 65 6d 7c 4d 45 4d 5f 53 74 72 7c  M_Ephem|MEM_Str|
51a0: 4d 45 4d 5f 54 65 72 6d 3b 20 20 20 2f 2a 20 50  MEM_Term;   /* P
51b0: 33 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 7a  3 */.    pMem->z
51c0: 20 3d 20 64 69 73 70 6c 61 79 50 33 28 70 4f 70   = displayP3(pOp
51d0: 2c 20 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 2c 20  , pMem->zShort, 
51e0: 73 69 7a 65 6f 66 28 70 4d 65 6d 2d 3e 7a 53 68  sizeof(pMem->zSh
51f0: 6f 72 74 29 29 3b 0a 20 20 20 20 61 73 73 65 72  ort));.    asser
5200: 74 28 20 70 4d 65 6d 2d 3e 7a 21 3d 30 20 29 3b  t( pMem->z!=0 );
5210: 0a 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d 20 73  .    pMem->n = s
5220: 74 72 6c 65 6e 28 70 4d 65 6d 2d 3e 7a 29 3b 0a  trlen(pMem->z);.
5230: 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d      pMem->type =
5240: 20 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20 20   SQLITE_TEXT;.  
5250: 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53 51    pMem->enc = SQ
5260: 4c 49 54 45 5f 55 54 46 38 3b 0a 0a 20 20 20 20  LITE_UTF8;..    
5270: 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d 20  p->nResColumn = 
5280: 35 20 2d 20 32 2a 28 70 2d 3e 65 78 70 6c 61 69  5 - 2*(p->explai
5290: 6e 2d 31 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f  n-1);.    p->pTo
52a0: 73 20 3d 20 70 4d 65 6d 3b 0a 20 20 20 20 70 2d  s = pMem;.    p-
52b0: 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  >rc = SQLITE_OK;
52c0: 0a 20 20 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61  .    p->resOnSta
52d0: 63 6b 20 3d 20 31 3b 0a 20 20 20 20 72 63 20 3d  ck = 1;.    rc =
52e0: 20 53 51 4c 49 54 45 5f 52 4f 57 3b 0a 20 20 7d   SQLITE_ROW;.  }
52f0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
5300: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
5310: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 20 2a 2f  _OMIT_EXPLAIN */
5320: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ..#ifdef SQLITE_
5330: 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 50 72 69 6e  DEBUG./*.** Prin
5340: 74 20 74 68 65 20 53 51 4c 20 74 68 61 74 20 77  t the SQL that w
5350: 61 73 20 75 73 65 64 20 74 6f 20 67 65 6e 65 72  as used to gener
5360: 61 74 65 20 61 20 56 44 42 45 20 70 72 6f 67 72  ate a VDBE progr
5370: 61 6d 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  am..*/.void sqli
5380: 74 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28  te3VdbePrintSql(
5390: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  Vdbe *p){.  int 
53a0: 6e 4f 70 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20  nOp = p->nOp;.  
53b0: 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 20 20 69  VdbeOp *pOp;.  i
53c0: 66 28 20 6e 4f 70 3c 31 20 29 20 72 65 74 75 72  f( nOp<1 ) retur
53d0: 6e 3b 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61  n;.  pOp = &p->a
53e0: 4f 70 5b 6e 4f 70 2d 31 5d 3b 0a 20 20 69 66 28  Op[nOp-1];.  if(
53f0: 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50   pOp->opcode==OP
5400: 5f 4e 6f 6f 70 20 26 26 20 70 4f 70 2d 3e 70 33  _Noop && pOp->p3
5410: 21 3d 30 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74  !=0 ){.    const
5420: 20 63 68 61 72 20 2a 7a 20 3d 20 70 4f 70 2d 3e   char *z = pOp->
5430: 70 33 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 69  p3;.    while( i
5440: 73 73 70 61 63 65 28 2a 28 75 38 2a 29 7a 29 20  sspace(*(u8*)z) 
5450: 29 20 7a 2b 2b 3b 0a 20 20 20 20 70 72 69 6e 74  ) z++;.    print
5460: 66 28 22 53 51 4c 3a 20 5b 25 73 5d 5c 6e 22 2c  f("SQL: [%s]\n",
5470: 20 7a 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69   z);.  }.}.#endi
5480: 66 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28  f..#if !defined(
5490: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41 43  SQLITE_OMIT_TRAC
54a0: 45 29 20 26 26 20 64 65 66 69 6e 65 64 28 53 51  E) && defined(SQ
54b0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 49 4f 54 52  LITE_ENABLE_IOTR
54c0: 41 43 45 29 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74  ACE)./*.** Print
54d0: 20 61 6e 20 49 4f 54 52 41 43 45 20 6d 65 73 73   an IOTRACE mess
54e0: 61 67 65 20 73 68 6f 77 69 6e 67 20 53 51 4c 20  age showing SQL 
54f0: 63 6f 6e 74 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64  content..*/.void
5500: 20 73 71 6c 69 74 65 33 56 64 62 65 49 4f 54 72   sqlite3VdbeIOTr
5510: 61 63 65 53 71 6c 28 56 64 62 65 20 2a 70 29 7b  aceSql(Vdbe *p){
5520: 0a 20 20 69 6e 74 20 6e 4f 70 20 3d 20 70 2d 3e  .  int nOp = p->
5530: 6e 4f 70 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70  nOp;.  VdbeOp *p
5540: 4f 70 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65  Op;.  if( sqlite
5550: 33 5f 69 6f 5f 74 72 61 63 65 3d 3d 30 20 29 20  3_io_trace==0 ) 
5560: 72 65 74 75 72 6e 3b 0a 20 20 69 66 28 20 6e 4f  return;.  if( nO
5570: 70 3c 31 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  p<1 ) return;.  
5580: 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 6e 4f  pOp = &p->aOp[nO
5590: 70 2d 31 5d 3b 0a 20 20 69 66 28 20 70 4f 70 2d  p-1];.  if( pOp-
55a0: 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70  >opcode==OP_Noop
55b0: 20 26 26 20 70 4f 70 2d 3e 70 33 21 3d 30 20 29   && pOp->p3!=0 )
55c0: 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 20 3d 20  {.    char *z = 
55d0: 73 71 6c 69 74 65 33 53 74 72 44 75 70 28 70 4f  sqlite3StrDup(pO
55e0: 70 2d 3e 70 33 29 3b 0a 20 20 20 20 69 6e 74 20  p->p3);.    int 
55f0: 69 2c 20 6a 3b 0a 20 20 20 20 66 6f 72 28 69 3d  i, j;.    for(i=
5600: 30 3b 20 69 73 73 70 61 63 65 28 7a 5b 69 5d 29  0; isspace(z[i])
5610: 3b 20 69 2b 2b 29 7b 7d 0a 20 20 20 20 66 6f 72  ; i++){}.    for
5620: 28 6a 3d 30 3b 20 7a 5b 69 5d 3b 20 69 2b 2b 29  (j=0; z[i]; i++)
5630: 7b 0a 20 20 20 20 20 20 69 66 28 20 69 73 73 70  {.      if( issp
5640: 61 63 65 28 7a 5b 69 5d 29 20 29 7b 0a 20 20 20  ace(z[i]) ){.   
5650: 20 20 20 20 20 69 66 28 20 7a 5b 69 2d 31 5d 21       if( z[i-1]!
5660: 3d 27 20 27 20 29 7b 0a 20 20 20 20 20 20 20 20  =' ' ){.        
5670: 20 20 7a 5b 6a 2b 2b 5d 20 3d 20 27 20 27 3b 0a    z[j++] = ' ';.
5680: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
5690: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 7a  }else{.        z
56a0: 5b 6a 2b 2b 5d 20 3d 20 7a 5b 69 5d 3b 0a 20 20  [j++] = z[i];.  
56b0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
56c0: 7a 5b 6a 5d 20 3d 20 30 3b 0a 20 20 20 20 73 71  z[j] = 0;.    sq
56d0: 6c 69 74 65 33 5f 69 6f 5f 74 72 61 63 65 28 22  lite3_io_trace("
56e0: 53 51 4c 20 25 73 5c 6e 22 2c 20 7a 29 3b 0a 20  SQL %s\n", z);. 
56f0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 29     sqliteFree(z)
5700: 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f  ;.  }.}.#endif /
5710: 2a 20 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  * !SQLITE_OMIT_T
5720: 52 41 43 45 20 26 26 20 53 51 4c 49 54 45 5f 45  RACE && SQLITE_E
5730: 4e 41 42 4c 45 5f 49 4f 54 52 41 43 45 20 2a 2f  NABLE_IOTRACE */
5740: 0a 0a 0a 2f 2a 0a 2a 2a 20 50 72 65 70 61 72 65  .../*.** Prepare
5750: 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69   a virtual machi
5760: 6e 65 20 66 6f 72 20 65 78 65 63 75 74 69 6f 6e  ne for execution
5770: 2e 20 20 54 68 69 73 20 69 6e 76 6f 6c 76 65 73  .  This involves
5780: 20 74 68 69 6e 67 73 20 73 75 63 68 0a 2a 2a 20   things such.** 
5790: 61 73 20 61 6c 6c 6f 63 61 74 69 6e 67 20 73 74  as allocating st
57a0: 61 63 6b 20 73 70 61 63 65 20 61 6e 64 20 69 6e  ack space and in
57b0: 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 70  itializing the p
57c0: 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 2e 0a  rogram counter..
57d0: 2a 2a 20 41 66 74 65 72 20 74 68 65 20 56 44 42  ** After the VDB
57e0: 45 20 68 61 73 20 62 65 20 70 72 65 70 70 65 64  E has be prepped
57f0: 2c 20 69 74 20 63 61 6e 20 62 65 20 65 78 65 63  , it can be exec
5800: 75 74 65 64 20 62 79 20 6f 6e 65 20 6f 72 20 6d  uted by one or m
5810: 6f 72 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20  ore.** calls to 
5820: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28  sqlite3VdbeExec(
5830: 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ).  .**.** This 
5840: 69 73 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20  is the only way 
5850: 74 6f 20 6d 6f 76 65 20 61 20 56 44 42 45 20 66  to move a VDBE f
5860: 72 6f 6d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  rom VDBE_MAGIC_I
5870: 4e 49 54 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d  NIT to.** VDBE_M
5880: 41 47 49 43 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69  AGIC_RUN..*/.voi
5890: 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b  d sqlite3VdbeMak
58a0: 65 52 65 61 64 79 28 0a 20 20 56 64 62 65 20 2a  eReady(.  Vdbe *
58b0: 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p,              
58c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
58d0: 56 44 42 45 20 2a 2f 0a 20 20 69 6e 74 20 6e 56  VDBE */.  int nV
58e0: 61 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ar,             
58f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
5900: 65 72 20 6f 66 20 27 3f 27 20 73 65 65 20 69 6e  er of '?' see in
5910: 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65   the SQL stateme
5920: 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d  nt */.  int nMem
5930: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
5940: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
5950: 20 6f 66 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73   of memory cells
5960: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a   to allocate */.
5970: 20 20 69 6e 74 20 6e 43 75 72 73 6f 72 2c 20 20    int nCursor,  
5980: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5990: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 75   /* Number of cu
59a0: 72 73 6f 72 73 20 74 6f 20 61 6c 6c 6f 63 61 74  rsors to allocat
59b0: 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 45 78 70  e */.  int isExp
59c0: 6c 61 69 6e 20 20 20 20 20 20 20 20 20 20 20 20  lain            
59d0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
59e0: 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b 65 79   the EXPLAIN key
59f0: 77 6f 72 64 73 20 69 73 20 70 72 65 73 65 6e 74  words is present
5a00: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a   */.){.  int n;.
5a10: 0a 20 20 61 73 73 65 72 74 28 20 70 21 3d 30 20  .  assert( p!=0 
5a20: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  );.  assert( p->
5a30: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
5a40: 43 5f 49 4e 49 54 20 29 3b 0a 0a 20 20 2f 2a 20  C_INIT );..  /* 
5a50: 54 68 65 72 65 20 73 68 6f 75 6c 64 20 62 65 20  There should be 
5a60: 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 6f 70 63  at least one opc
5a70: 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65  ode..  */.  asse
5a80: 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a  rt( p->nOp>0 );.
5a90: 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20 6d 61  .  /* Set the ma
5aa0: 67 69 63 20 74 6f 20 56 44 42 45 5f 4d 41 47 49  gic to VDBE_MAGI
5ab0: 43 5f 52 55 4e 20 73 6f 6f 6e 65 72 20 72 61 74  C_RUN sooner rat
5ac0: 68 65 72 20 74 68 61 6e 20 6c 61 74 65 72 2e 20  her than later. 
5ad0: 54 68 69 73 0a 20 20 20 2a 20 69 73 20 62 65 63  This.   * is bec
5ae0: 61 75 73 65 20 74 68 65 20 63 61 6c 6c 20 74 6f  ause the call to
5af0: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 29   resizeOpArray()
5b00: 20 62 65 6c 6f 77 20 6d 61 79 20 73 68 72 69 6e   below may shrin
5b10: 6b 20 74 68 65 0a 20 20 20 2a 20 70 2d 3e 61 4f  k the.   * p->aO
5b20: 70 5b 5d 20 61 72 72 61 79 20 74 6f 20 73 61 76  p[] array to sav
5b30: 65 20 6d 65 6d 6f 72 79 20 69 66 20 63 61 6c 6c  e memory if call
5b40: 65 64 20 77 68 65 6e 20 69 6e 20 56 44 42 45 5f  ed when in VDBE_
5b50: 4d 41 47 49 43 5f 52 55 4e 20 0a 20 20 20 2a 20  MAGIC_RUN .   * 
5b60: 73 74 61 74 65 2e 0a 20 20 20 2a 2f 0a 20 20 70  state..   */.  p
5b70: 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d  ->magic = VDBE_M
5b80: 41 47 49 43 5f 52 55 4e 3b 0a 0a 20 20 2f 2a 20  AGIC_RUN;..  /* 
5b90: 4e 6f 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 65  No instruction e
5ba0: 76 65 72 20 70 75 73 68 65 73 20 6d 6f 72 65 20  ver pushes more 
5bb0: 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20 65 6c  than a single el
5bc0: 65 6d 65 6e 74 20 6f 6e 74 6f 20 74 68 65 0a 20  ement onto the. 
5bd0: 20 2a 2a 20 73 74 61 63 6b 2e 20 20 41 6e 64 20   ** stack.  And 
5be0: 74 68 65 20 73 74 61 63 6b 20 6e 65 76 65 72 20  the stack never 
5bf0: 67 72 6f 77 73 20 6f 6e 20 73 75 63 63 65 73 73  grows on success
5c00: 69 76 65 20 65 78 65 63 75 74 69 6f 6e 73 20 6f  ive executions o
5c10: 66 20 74 68 65 0a 20 20 2a 2a 20 73 61 6d 65 20  f the.  ** same 
5c20: 6c 6f 6f 70 2e 20 20 53 6f 20 74 68 65 20 74 6f  loop.  So the to
5c30: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e  tal number of in
5c40: 73 74 72 75 63 74 69 6f 6e 73 20 69 73 20 61 6e  structions is an
5c50: 20 75 70 70 65 72 20 62 6f 75 6e 64 0a 20 20 2a   upper bound.  *
5c60: 2a 20 6f 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d  * on the maximum
5c70: 20 73 74 61 63 6b 20 64 65 70 74 68 20 72 65 71   stack depth req
5c80: 75 69 72 65 64 2e 20 20 28 41 64 64 65 64 20 6c  uired.  (Added l
5c90: 61 74 65 72 3a 29 20 20 54 68 65 0a 20 20 2a 2a  ater:)  The.  **
5ca0: 20 72 65 73 6f 6c 76 65 50 32 56 61 6c 75 65 73   resolveP2Values
5cb0: 28 29 20 63 61 6c 6c 20 63 6f 6d 70 75 74 65 73  () call computes
5cc0: 20 61 20 74 69 67 68 74 65 72 20 75 70 70 65 72   a tighter upper
5cd0: 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 0a 20 20   bound on the.  
5ce0: 2a 2a 20 73 74 61 63 6b 20 73 69 7a 65 2e 0a 20  ** stack size.. 
5cf0: 20 2a 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61 74   **.  ** Allocat
5d00: 69 6f 6e 20 61 6c 6c 20 74 68 65 20 73 74 61 63  ion all the stac
5d10: 6b 20 73 70 61 63 65 20 77 65 20 77 69 6c 6c 20  k space we will 
5d20: 65 76 65 72 20 6e 65 65 64 2e 0a 20 20 2a 2f 0a  ever need..  */.
5d30: 20 20 69 66 28 20 70 2d 3e 61 53 74 61 63 6b 3d    if( p->aStack=
5d40: 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 41  =0 ){.    int nA
5d50: 72 67 3b 20 20 20 20 20 20 20 2f 2a 20 4d 61 78  rg;       /* Max
5d60: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 61  imum number of a
5d70: 72 67 73 20 70 61 73 73 65 64 20 74 6f 20 61 20  rgs passed to a 
5d80: 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20 2a  user function. *
5d90: 2f 0a 20 20 20 20 69 6e 74 20 6e 53 74 61 63 6b  /.    int nStack
5da0: 3b 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d  ;     /* Maximum
5db0: 20 6e 75 6d 62 65 72 20 6f 66 20 73 74 61 63 6b   number of stack
5dc0: 20 65 6e 74 72 69 65 73 20 72 65 71 75 69 72 65   entries require
5dd0: 64 20 2a 2f 0a 20 20 20 20 72 65 73 6f 6c 76 65  d */.    resolve
5de0: 50 32 56 61 6c 75 65 73 28 70 2c 20 26 6e 41 72  P2Values(p, &nAr
5df0: 67 2c 20 26 6e 53 74 61 63 6b 29 3b 0a 20 20 20  g, &nStack);.   
5e00: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70   resizeOpArray(p
5e10: 2c 20 70 2d 3e 6e 4f 70 29 3b 0a 20 20 20 20 61  , p->nOp);.    a
5e20: 73 73 65 72 74 28 20 6e 56 61 72 3e 3d 30 20 29  ssert( nVar>=0 )
5e30: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 53  ;.    assert( nS
5e40: 74 61 63 6b 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20  tack<p->nOp );. 
5e50: 20 20 20 69 66 28 20 69 73 45 78 70 6c 61 69 6e     if( isExplain
5e60: 20 29 7b 0a 20 20 20 20 20 20 6e 53 74 61 63 6b   ){.      nStack
5e70: 20 3d 20 31 30 3b 0a 20 20 20 20 7d 0a 20 20 20   = 10;.    }.   
5e80: 20 70 2d 3e 61 53 74 61 63 6b 20 3d 20 73 71 6c   p->aStack = sql
5e90: 69 74 65 4d 61 6c 6c 6f 63 28 0a 20 20 20 20 20  iteMalloc(.     
5ea0: 20 20 20 6e 53 74 61 63 6b 2a 73 69 7a 65 6f 66     nStack*sizeof
5eb0: 28 70 2d 3e 61 53 74 61 63 6b 5b 30 5d 29 20 20  (p->aStack[0])  
5ec0: 20 20 2f 2a 20 61 53 74 61 63 6b 20 2a 2f 0a 20    /* aStack */. 
5ed0: 20 20 20 20 20 2b 20 6e 41 72 67 2a 73 69 7a 65       + nArg*size
5ee0: 6f 66 28 4d 65 6d 2a 29 20 20 20 20 20 20 20 20  of(Mem*)        
5ef0: 20 20 20 20 20 20 2f 2a 20 61 70 41 72 67 20 2a        /* apArg *
5f00: 2f 0a 20 20 20 20 20 20 2b 20 6e 56 61 72 2a 73  /.      + nVar*s
5f10: 69 7a 65 6f 66 28 4d 65 6d 29 20 20 20 20 20 20  izeof(Mem)      
5f20: 20 20 20 20 20 20 20 20 20 2f 2a 20 61 56 61 72           /* aVar
5f30: 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 56 61 72   */.      + nVar
5f40: 2a 73 69 7a 65 6f 66 28 63 68 61 72 2a 29 20 20  *sizeof(char*)  
5f50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61 7a             /* az
5f60: 56 61 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e  Var */.      + n
5f70: 4d 65 6d 2a 73 69 7a 65 6f 66 28 4d 65 6d 29 20  Mem*sizeof(Mem) 
5f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
5f90: 20 61 4d 65 6d 20 2a 2f 0a 20 20 20 20 20 20 2b   aMem */.      +
5fa0: 20 6e 43 75 72 73 6f 72 2a 73 69 7a 65 6f 66 28   nCursor*sizeof(
5fb0: 43 75 72 73 6f 72 2a 29 20 20 20 20 20 20 20 20  Cursor*)        
5fc0: 2f 2a 20 61 70 43 73 72 20 2a 2f 0a 20 20 20 20  /* apCsr */.    
5fd0: 29 3b 0a 20 20 20 20 69 66 28 20 21 73 71 6c 69  );.    if( !sqli
5fe0: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28  te3MallocFailed(
5ff0: 29 20 29 7b 0a 20 20 20 20 20 20 70 2d 3e 61 4d  ) ){.      p->aM
6000: 65 6d 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b  em = &p->aStack[
6010: 6e 53 74 61 63 6b 5d 3b 0a 20 20 20 20 20 20 70  nStack];.      p
6020: 2d 3e 6e 4d 65 6d 20 3d 20 6e 4d 65 6d 3b 0a 20  ->nMem = nMem;. 
6030: 20 20 20 20 20 70 2d 3e 61 56 61 72 20 3d 20 26       p->aVar = &
6040: 70 2d 3e 61 4d 65 6d 5b 6e 4d 65 6d 5d 3b 0a 20  p->aMem[nMem];. 
6050: 20 20 20 20 20 70 2d 3e 6e 56 61 72 20 3d 20 6e       p->nVar = n
6060: 56 61 72 3b 0a 20 20 20 20 20 20 70 2d 3e 6f 6b  Var;.      p->ok
6070: 56 61 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 70  Var = 0;.      p
6080: 2d 3e 61 70 41 72 67 20 3d 20 28 4d 65 6d 2a 2a  ->apArg = (Mem**
6090: 29 26 70 2d 3e 61 56 61 72 5b 6e 56 61 72 5d 3b  )&p->aVar[nVar];
60a0: 0a 20 20 20 20 20 20 70 2d 3e 61 7a 56 61 72 20  .      p->azVar 
60b0: 3d 20 28 63 68 61 72 2a 2a 29 26 70 2d 3e 61 70  = (char**)&p->ap
60c0: 41 72 67 5b 6e 41 72 67 5d 3b 0a 20 20 20 20 20  Arg[nArg];.     
60d0: 20 70 2d 3e 61 70 43 73 72 20 3d 20 28 43 75 72   p->apCsr = (Cur
60e0: 73 6f 72 2a 2a 29 26 70 2d 3e 61 7a 56 61 72 5b  sor**)&p->azVar[
60f0: 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20 70 2d 3e  nVar];.      p->
6100: 6e 43 75 72 73 6f 72 20 3d 20 6e 43 75 72 73 6f  nCursor = nCurso
6110: 72 3b 0a 20 20 20 20 20 20 66 6f 72 28 6e 3d 30  r;.      for(n=0
6120: 3b 20 6e 3c 6e 56 61 72 3b 20 6e 2b 2b 29 7b 0a  ; n<nVar; n++){.
6130: 20 20 20 20 20 20 20 20 70 2d 3e 61 56 61 72 5b          p->aVar[
6140: 6e 5d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e  n].flags = MEM_N
6150: 75 6c 6c 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ull;.      }.   
6160: 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28 6e 3d 30   }.  }.  for(n=0
6170: 3b 20 6e 3c 70 2d 3e 6e 4d 65 6d 3b 20 6e 2b 2b  ; n<p->nMem; n++
6180: 29 7b 0a 20 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e  ){.    p->aMem[n
6190: 5d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75  ].flags = MEM_Nu
61a0: 6c 6c 3b 0a 20 20 7d 0a 0a 20 20 70 2d 3e 70 54  ll;.  }..  p->pT
61b0: 6f 73 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b  os = &p->aStack[
61c0: 2d 31 5d 3b 0a 20 20 70 2d 3e 70 63 20 3d 20 2d  -1];.  p->pc = -
61d0: 31 3b 0a 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  1;.  p->rc = SQL
61e0: 49 54 45 5f 4f 4b 3b 0a 20 20 70 2d 3e 75 6e 69  ITE_OK;.  p->uni
61f0: 71 75 65 43 6e 74 20 3d 20 30 3b 0a 20 20 70 2d  queCnt = 0;.  p-
6200: 3e 72 65 74 75 72 6e 44 65 70 74 68 20 3d 20 30  >returnDepth = 0
6210: 3b 0a 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69  ;.  p->errorActi
6220: 6f 6e 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20  on = OE_Abort;. 
6230: 20 70 2d 3e 70 6f 70 53 74 61 63 6b 20 3d 20 20   p->popStack =  
6240: 30 3b 0a 20 20 70 2d 3e 65 78 70 6c 61 69 6e 20  0;.  p->explain 
6250: 7c 3d 20 69 73 45 78 70 6c 61 69 6e 3b 0a 20 20  |= isExplain;.  
6260: 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f  p->magic = VDBE_
6270: 4d 41 47 49 43 5f 52 55 4e 3b 0a 20 20 70 2d 3e  MAGIC_RUN;.  p->
6280: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20 70  nChange = 0;.  p
6290: 2d 3e 63 61 63 68 65 43 74 72 20 3d 20 31 3b 0a  ->cacheCtr = 1;.
62a0: 20 20 70 2d 3e 6d 69 6e 57 72 69 74 65 46 69 6c    p->minWriteFil
62b0: 65 46 6f 72 6d 61 74 20 3d 20 32 35 35 3b 0a 23  eFormat = 255;.#
62c0: 69 66 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49  ifdef VDBE_PROFI
62d0: 4c 45 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 69  LE.  {.    int i
62e0: 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  ;.    for(i=0; i
62f0: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
6300: 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63       p->aOp[i].c
6310: 6e 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d  nt = 0;.      p-
6320: 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 20 3d  >aOp[i].cycles =
6330: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65   0;.    }.  }.#e
6340: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  ndif.}../*.** Cl
6350: 6f 73 65 20 61 20 63 75 72 73 6f 72 20 61 6e 64  ose a cursor and
6360: 20 72 65 6c 65 61 73 65 20 61 6c 6c 20 74 68 65   release all the
6370: 20 72 65 73 6f 75 72 63 65 73 20 74 68 61 74 20   resources that 
6380: 63 75 72 73 6f 72 20 68 61 70 70 65 6e 73 0a 2a  cursor happens.*
6390: 2a 20 74 6f 20 68 6f 6c 64 2e 0a 2a 2f 0a 76 6f  * to hold..*/.vo
63a0: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 46 72  id sqlite3VdbeFr
63b0: 65 65 43 75 72 73 6f 72 28 56 64 62 65 20 2a 70  eeCursor(Vdbe *p
63c0: 2c 20 43 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a  , Cursor *pCx){.
63d0: 20 20 69 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a    if( pCx==0 ){.
63e0: 20 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a      return;.  }.
63f0: 20 20 69 66 28 20 70 43 78 2d 3e 70 43 75 72 73    if( pCx->pCurs
6400: 6f 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  or ){.    sqlite
6410: 33 42 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f  3BtreeCloseCurso
6420: 72 28 70 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b  r(pCx->pCursor);
6430: 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e  .  }.  if( pCx->
6440: 70 42 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  pBt ){.    sqlit
6450: 65 33 42 74 72 65 65 43 6c 6f 73 65 28 70 43 78  e3BtreeClose(pCx
6460: 2d 3e 70 42 74 29 3b 0a 20 20 7d 0a 23 69 66 6e  ->pBt);.  }.#ifn
6470: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
6480: 56 49 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69  VIRTUALTABLE.  i
6490: 66 28 20 70 43 78 2d 3e 70 56 74 61 62 43 75 72  f( pCx->pVtabCur
64a0: 73 6f 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  sor ){.    sqlit
64b0: 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a  e3_vtab_cursor *
64c0: 70 56 74 61 62 43 75 72 73 6f 72 20 3d 20 70 43  pVtabCursor = pC
64d0: 78 2d 3e 70 56 74 61 62 43 75 72 73 6f 72 3b 0a  x->pVtabCursor;.
64e0: 20 20 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65      const sqlite
64f0: 33 5f 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64 75 6c  3_module *pModul
6500: 65 20 3d 20 70 43 78 2d 3e 70 4d 6f 64 75 6c 65  e = pCx->pModule
6510: 3b 0a 20 20 20 20 70 2d 3e 69 6e 56 74 61 62 4d  ;.    p->inVtabM
6520: 65 74 68 6f 64 20 3d 20 31 3b 0a 20 20 20 20 73  ethod = 1;.    s
6530: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28  qlite3SafetyOff(
6540: 70 2d 3e 64 62 29 3b 0a 20 20 20 20 70 4d 6f 64  p->db);.    pMod
6550: 75 6c 65 2d 3e 78 43 6c 6f 73 65 28 70 56 74 61  ule->xClose(pVta
6560: 62 43 75 72 73 6f 72 29 3b 0a 20 20 20 20 73 71  bCursor);.    sq
6570: 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 70 2d  lite3SafetyOn(p-
6580: 3e 64 62 29 3b 0a 20 20 20 20 70 2d 3e 69 6e 56  >db);.    p->inV
6590: 74 61 62 4d 65 74 68 6f 64 20 3d 20 30 3b 0a 20  tabMethod = 0;. 
65a0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69   }.#endif.  sqli
65b0: 74 65 46 72 65 65 28 70 43 78 2d 3e 70 44 61 74  teFree(pCx->pDat
65c0: 61 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65  a);.  sqliteFree
65d0: 28 70 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20  (pCx->aType);.  
65e0: 73 71 6c 69 74 65 46 72 65 65 28 70 43 78 29 3b  sqliteFree(pCx);
65f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20  .}../*.** Close 
6600: 61 6c 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73  all cursors.*/.s
6610: 74 61 74 69 63 20 76 6f 69 64 20 63 6c 6f 73 65  tatic void close
6620: 41 6c 6c 43 75 72 73 6f 72 73 28 56 64 62 65 20  AllCursors(Vdbe 
6630: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  *p){.  int i;.  
6640: 69 66 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20  if( p->apCsr==0 
6650: 29 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28  ) return;.  for(
6660: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f  i=0; i<p->nCurso
6670: 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28  r; i++){.    if(
6680: 20 21 70 2d 3e 69 6e 56 74 61 62 4d 65 74 68 6f   !p->inVtabMetho
6690: 64 20 7c 7c 20 28 70 2d 3e 61 70 43 73 72 5b 69  d || (p->apCsr[i
66a0: 5d 20 26 26 20 21 70 2d 3e 61 70 43 73 72 5b 69  ] && !p->apCsr[i
66b0: 5d 2d 3e 70 56 74 61 62 43 75 72 73 6f 72 29 20  ]->pVtabCursor) 
66c0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
66d0: 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28 70  VdbeFreeCursor(p
66e0: 2c 20 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b 0a  , p->apCsr[i]);.
66f0: 20 20 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69        p->apCsr[i
6700: 5d 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d  ] = 0;.    }.  }
6710: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e 20  .}../*.** Clean 
6720: 75 70 20 74 68 65 20 56 4d 20 61 66 74 65 72 20  up the VM after 
6730: 65 78 65 63 75 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a  execution..**.**
6740: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69   This routine wi
6750: 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  ll automatically
6760: 20 63 6c 6f 73 65 20 61 6e 79 20 63 75 72 73 6f   close any curso
6770: 72 73 2c 20 6c 69 73 74 73 2c 20 61 6e 64 2f 6f  rs, lists, and/o
6780: 72 0a 2a 2a 20 73 6f 72 74 65 72 73 20 74 68 61  r.** sorters tha
6790: 74 20 77 65 72 65 20 6c 65 66 74 20 6f 70 65 6e  t were left open
67a0: 2e 20 20 49 74 20 61 6c 73 6f 20 64 65 6c 65 74  .  It also delet
67b0: 65 73 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66  es the values of
67c0: 0a 2a 2a 20 76 61 72 69 61 62 6c 65 73 20 69 6e  .** variables in
67d0: 20 74 68 65 20 61 56 61 72 5b 5d 20 61 72 72 61   the aVar[] arra
67e0: 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69  y..*/.static voi
67f0: 64 20 43 6c 65 61 6e 75 70 28 56 64 62 65 20 2a  d Cleanup(Vdbe *
6800: 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  p){.  int i;.  i
6810: 66 28 20 70 2d 3e 61 53 74 61 63 6b 20 29 7b 0a  f( p->aStack ){.
6820: 20 20 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72      releaseMemAr
6830: 72 61 79 28 70 2d 3e 61 53 74 61 63 6b 2c 20 31  ray(p->aStack, 1
6840: 20 2b 20 28 70 2d 3e 70 54 6f 73 20 2d 20 70 2d   + (p->pTos - p-
6850: 3e 61 53 74 61 63 6b 29 29 3b 0a 20 20 20 20 70  >aStack));.    p
6860: 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e 61 53 74  ->pTos = &p->aSt
6870: 61 63 6b 5b 2d 31 5d 3b 0a 20 20 7d 0a 20 20 63  ack[-1];.  }.  c
6880: 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70  loseAllCursors(p
6890: 29 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41  );.  releaseMemA
68a0: 72 72 61 79 28 70 2d 3e 61 4d 65 6d 2c 20 70 2d  rray(p->aMem, p-
68b0: 3e 6e 4d 65 6d 29 3b 0a 20 20 73 71 6c 69 74 65  >nMem);.  sqlite
68c0: 33 56 64 62 65 46 69 66 6f 43 6c 65 61 72 28 26  3VdbeFifoClear(&
68d0: 70 2d 3e 73 46 69 66 6f 29 3b 0a 20 20 69 66 28  p->sFifo);.  if(
68e0: 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b   p->contextStack
68f0: 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b   ){.    for(i=0;
6900: 20 69 3c 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61   i<p->contextSta
6910: 63 6b 54 6f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ckTop; i++){.   
6920: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 46 69     sqlite3VdbeFi
6930: 66 6f 43 6c 65 61 72 28 26 70 2d 3e 63 6f 6e 74  foClear(&p->cont
6940: 65 78 74 53 74 61 63 6b 5b 69 5d 2e 73 46 69 66  extStack[i].sFif
6950: 6f 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  o);.    }.    sq
6960: 6c 69 74 65 46 72 65 65 28 70 2d 3e 63 6f 6e 74  liteFree(p->cont
6970: 65 78 74 53 74 61 63 6b 29 3b 0a 20 20 7d 0a 20  extStack);.  }. 
6980: 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b   p->contextStack
6990: 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65   = 0;.  p->conte
69a0: 78 74 53 74 61 63 6b 44 65 70 74 68 20 3d 20 30  xtStackDepth = 0
69b0: 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74  ;.  p->contextSt
69c0: 61 63 6b 54 6f 70 20 3d 20 30 3b 0a 20 20 73 71  ackTop = 0;.  sq
69d0: 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a 45 72 72  liteFree(p->zErr
69e0: 4d 73 67 29 3b 0a 20 20 70 2d 3e 7a 45 72 72 4d  Msg);.  p->zErrM
69f0: 73 67 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  sg = 0;.}../*.**
6a00: 20 53 65 74 20 74 68 65 20 6e 75 6d 62 65 72 20   Set the number 
6a10: 6f 66 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e  of result column
6a20: 73 20 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72  s that will be r
6a30: 65 74 75 72 6e 65 64 20 62 79 20 74 68 69 73 20  eturned by this 
6a40: 53 51 4c 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74  SQL.** statement
6a50: 2e 20 54 68 69 73 20 69 73 20 6e 6f 77 20 73 65  . This is now se
6a60: 74 20 61 74 20 63 6f 6d 70 69 6c 65 20 74 69 6d  t at compile tim
6a70: 65 2c 20 72 61 74 68 65 72 20 74 68 61 6e 20 64  e, rather than d
6a80: 75 72 69 6e 67 0a 2a 2a 20 65 78 65 63 75 74 69  uring.** executi
6a90: 6f 6e 20 6f 66 20 74 68 65 20 76 64 62 65 20 70  on of the vdbe p
6aa0: 72 6f 67 72 61 6d 20 73 6f 20 74 68 61 74 20 73  rogram so that s
6ab0: 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f  qlite3_column_co
6ac0: 75 6e 74 28 29 20 63 61 6e 0a 2a 2a 20 62 65 20  unt() can.** be 
6ad0: 63 61 6c 6c 65 64 20 6f 6e 20 61 6e 20 53 51 4c  called on an SQL
6ae0: 20 73 74 61 74 65 6d 65 6e 74 20 62 65 66 6f 72   statement befor
6af0: 65 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  e sqlite3_step()
6b00: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
6b10: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
6b20: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6e 52 65  Vdbe *p, int nRe
6b30: 73 43 6f 6c 75 6d 6e 29 7b 0a 20 20 4d 65 6d 20  sColumn){.  Mem 
6b40: 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 20 20 69 6e 74  *pColName;.  int
6b50: 20 6e 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d   n;.  releaseMem
6b60: 41 72 72 61 79 28 70 2d 3e 61 43 6f 6c 4e 61 6d  Array(p->aColNam
6b70: 65 2c 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e  e, p->nResColumn
6b80: 2a 43 4f 4c 4e 41 4d 45 5f 4e 29 3b 0a 20 20 73  *COLNAME_N);.  s
6b90: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 43 6f  qliteFree(p->aCo
6ba0: 6c 4e 61 6d 65 29 3b 0a 20 20 6e 20 3d 20 6e 52  lName);.  n = nR
6bb0: 65 73 43 6f 6c 75 6d 6e 2a 43 4f 4c 4e 41 4d 45  esColumn*COLNAME
6bc0: 5f 4e 3b 0a 20 20 70 2d 3e 6e 52 65 73 43 6f 6c  _N;.  p->nResCol
6bd0: 75 6d 6e 20 3d 20 6e 52 65 73 43 6f 6c 75 6d 6e  umn = nResColumn
6be0: 3b 0a 20 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 20  ;.  p->aColName 
6bf0: 3d 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 28 4d 65  = pColName = (Me
6c00: 6d 2a 29 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28  m*)sqliteMalloc(
6c10: 20 73 69 7a 65 6f 66 28 4d 65 6d 29 2a 6e 20 29   sizeof(Mem)*n )
6c20: 3b 0a 20 20 69 66 28 20 70 2d 3e 61 43 6f 6c 4e  ;.  if( p->aColN
6c30: 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ame==0 ) return;
6c40: 0a 20 20 77 68 69 6c 65 28 20 6e 2d 2d 20 3e 20  .  while( n-- > 
6c50: 30 20 29 7b 0a 20 20 20 20 28 70 43 6f 6c 4e 61  0 ){.    (pColNa
6c60: 6d 65 2b 2b 29 2d 3e 66 6c 61 67 73 20 3d 20 4d  me++)->flags = M
6c70: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a 7d 0a 0a  EM_Null;.  }.}..
6c80: 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20 6e 61  /*.** Set the na
6c90: 6d 65 20 6f 66 20 74 68 65 20 69 64 78 27 74 68  me of the idx'th
6ca0: 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 72 65   column to be re
6cb0: 74 75 72 6e 65 64 20 62 79 20 74 68 65 20 53 51  turned by the SQ
6cc0: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20  L statement..** 
6cd0: 7a 4e 61 6d 65 20 6d 75 73 74 20 62 65 20 61 20  zName must be a 
6ce0: 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 6e 75 6c  pointer to a nul
6cf0: 20 74 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69   terminated stri
6d00: 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63  ng..**.** This c
6d10: 61 6c 6c 20 6d 75 73 74 20 62 65 20 6d 61 64 65  all must be made
6d20: 20 61 66 74 65 72 20 61 20 63 61 6c 6c 20 74 6f   after a call to
6d30: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e   sqlite3VdbeSetN
6d40: 75 6d 43 6f 6c 73 28 29 2e 0a 2a 2a 0a 2a 2a 20  umCols()..**.** 
6d50: 49 66 20 4e 3d 3d 50 33 5f 53 54 41 54 49 43 20  If N==P3_STATIC 
6d60: 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 7a   it means that z
6d70: 4e 61 6d 65 20 69 73 20 61 20 70 6f 69 6e 74 65  Name is a pointe
6d80: 72 20 74 6f 20 61 20 63 6f 6e 73 74 61 6e 74 20  r to a constant 
6d90: 73 74 61 74 69 63 0a 2a 2a 20 73 74 72 69 6e 67  static.** string
6da0: 20 61 6e 64 20 77 65 20 63 61 6e 20 6a 75 73 74   and we can just
6db0: 20 63 6f 70 79 20 74 68 65 20 70 6f 69 6e 74 65   copy the pointe
6dc0: 72 2e 20 49 66 20 69 74 20 69 73 20 50 33 5f 44  r. If it is P3_D
6dd0: 59 4e 41 4d 49 43 2c 20 74 68 65 6e 20 0a 2a 2a  YNAMIC, then .**
6de0: 20 74 68 65 20 73 74 72 69 6e 67 20 69 73 20 66   the string is f
6df0: 72 65 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74  reed using sqlit
6e00: 65 46 72 65 65 28 29 20 77 68 65 6e 20 74 68 65  eFree() when the
6e10: 20 76 64 62 65 20 69 73 20 66 69 6e 69 73 68 65   vdbe is finishe
6e20: 64 20 77 69 74 68 0a 2a 2a 20 69 74 2e 20 4f 74  d with.** it. Ot
6e30: 68 65 72 77 69 73 65 2c 20 4e 20 62 79 74 65 73  herwise, N bytes
6e40: 20 6f 66 20 7a 4e 61 6d 65 20 61 72 65 20 63 6f   of zName are co
6e50: 70 69 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  pied..*/.int sql
6e60: 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61  ite3VdbeSetColNa
6e70: 6d 65 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20  me(Vdbe *p, int 
6e80: 69 64 78 2c 20 69 6e 74 20 76 61 72 2c 20 63 6f  idx, int var, co
6e90: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
6ea0: 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72   int N){.  int r
6eb0: 63 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  c;.  Mem *pColNa
6ec0: 6d 65 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64  me;.  assert( id
6ed0: 78 3c 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20  x<p->nResColumn 
6ee0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 76 61 72  );.  assert( var
6ef0: 3c 43 4f 4c 4e 41 4d 45 5f 4e 20 29 3b 0a 20 20  <COLNAME_N );.  
6f00: 69 66 28 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f  if( sqlite3Mallo
6f10: 63 46 61 69 6c 65 64 28 29 20 29 20 72 65 74 75  cFailed() ) retu
6f20: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b  rn SQLITE_NOMEM;
6f30: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 43  .  assert( p->aC
6f40: 6f 6c 4e 61 6d 65 21 3d 30 20 29 3b 0a 20 20 70  olName!=0 );.  p
6f50: 43 6f 6c 4e 61 6d 65 20 3d 20 26 28 70 2d 3e 61  ColName = &(p->a
6f60: 43 6f 6c 4e 61 6d 65 5b 69 64 78 2b 76 61 72 2a  ColName[idx+var*
6f70: 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 5d 29 3b  p->nResColumn]);
6f80: 0a 20 20 69 66 28 20 4e 3d 3d 50 33 5f 44 59 4e  .  if( N==P3_DYN
6f90: 41 4d 49 43 20 7c 7c 20 4e 3d 3d 50 33 5f 53 54  AMIC || N==P3_ST
6fa0: 41 54 49 43 20 29 7b 0a 20 20 20 20 72 63 20 3d  ATIC ){.    rc =
6fb0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
6fc0: 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20  etStr(pColName, 
6fd0: 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54  zName, -1, SQLIT
6fe0: 45 5f 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53  E_UTF8, SQLITE_S
6ff0: 54 41 54 49 43 29 3b 0a 20 20 7d 65 6c 73 65 7b  TATIC);.  }else{
7000: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
7010: 33 56 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70  3VdbeMemSetStr(p
7020: 43 6f 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20  ColName, zName, 
7030: 4e 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 53  N, SQLITE_UTF8,S
7040: 51 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29  QLITE_TRANSIENT)
7050: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d  ;.  }.  if( rc==
7060: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 4e 3d 3d  SQLITE_OK && N==
7070: 50 33 5f 44 59 4e 41 4d 49 43 20 29 7b 0a 20 20  P3_DYNAMIC ){.  
7080: 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e 66 6c 61 67    pColName->flag
7090: 73 20 3d 20 28 70 43 6f 6c 4e 61 6d 65 2d 3e 66  s = (pColName->f
70a0: 6c 61 67 73 26 28 7e 4d 45 4d 5f 53 74 61 74 69  lags&(~MEM_Stati
70b0: 63 29 29 7c 4d 45 4d 5f 44 79 6e 3b 0a 20 20 20  c))|MEM_Dyn;.   
70c0: 20 70 43 6f 6c 4e 61 6d 65 2d 3e 78 44 65 6c 20   pColName->xDel 
70d0: 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72  = 0;.  }.  retur
70e0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41  n rc;.}../*.** A
70f0: 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 74   read or write t
7100: 72 61 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 6f  ransaction may o
7110: 72 20 6d 61 79 20 6e 6f 74 20 62 65 20 61 63 74  r may not be act
7120: 69 76 65 20 6f 6e 20 64 61 74 61 62 61 73 65 20  ive on database 
7130: 68 61 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 49 66  handle.** db. If
7140: 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69   a transaction i
7150: 73 20 61 63 74 69 76 65 2c 20 63 6f 6d 6d 69 74  s active, commit
7160: 20 69 74 2e 20 49 66 20 74 68 65 72 65 20 69 73   it. If there is
7170: 20 61 0a 2a 2a 20 77 72 69 74 65 2d 74 72 61 6e   a.** write-tran
7180: 73 61 63 74 69 6f 6e 20 73 70 61 6e 6e 69 6e 67  saction spanning
7190: 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 64   more than one d
71a0: 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68  atabase file, th
71b0: 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 74 61  is routine.** ta
71c0: 6b 65 73 20 63 61 72 65 20 6f 66 20 74 68 65 20  kes care of the 
71d0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 74  master journal t
71e0: 72 69 63 6b 65 72 79 2e 0a 2a 2f 0a 73 74 61 74  rickery..*/.stat
71f0: 69 63 20 69 6e 74 20 76 64 62 65 43 6f 6d 6d 69  ic int vdbeCommi
7200: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  t(sqlite3 *db){.
7210: 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 6e    int i;.  int n
7220: 54 72 61 6e 73 20 3d 20 30 3b 20 20 2f 2a 20 4e  Trans = 0;  /* N
7230: 75 6d 62 65 72 20 6f 66 20 64 61 74 61 62 61 73  umber of databas
7240: 65 73 20 77 69 74 68 20 61 6e 20 61 63 74 69 76  es with an activ
7250: 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74  e write-transact
7260: 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20  ion */.  int rc 
7270: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69  = SQLITE_OK;.  i
7280: 6e 74 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20 3d  nt needXcommit =
7290: 20 30 3b 0a 0a 20 20 2f 2a 20 42 65 66 6f 72 65   0;..  /* Before
72a0: 20 64 6f 69 6e 67 20 61 6e 79 74 68 69 6e 67 20   doing anything 
72b0: 65 6c 73 65 2c 20 63 61 6c 6c 20 74 68 65 20 78  else, call the x
72c0: 53 79 6e 63 28 29 20 63 61 6c 6c 62 61 63 6b 20  Sync() callback 
72d0: 66 6f 72 20 61 6e 79 0a 20 20 2a 2a 20 76 69 72  for any.  ** vir
72e0: 74 75 61 6c 20 6d 6f 64 75 6c 65 20 74 61 62 6c  tual module tabl
72f0: 65 73 20 77 72 69 74 74 65 6e 20 69 6e 20 74 68  es written in th
7300: 69 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20  is transaction. 
7310: 54 68 69 73 20 68 61 73 20 74 6f 0a 20 20 2a 2a  This has to.  **
7320: 20 62 65 20 64 6f 6e 65 20 62 65 66 6f 72 65 20   be done before 
7330: 64 65 74 65 72 6d 69 6e 69 6e 67 20 77 68 65 74  determining whet
7340: 68 65 72 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  her a master jou
7350: 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 0a 20 20  rnal file is .  
7360: 2a 2a 20 72 65 71 75 69 72 65 64 2c 20 61 73 20  ** required, as 
7370: 61 6e 20 78 53 79 6e 63 28 29 20 63 61 6c 6c 62  an xSync() callb
7380: 61 63 6b 20 6d 61 79 20 61 64 64 20 61 6e 20 61  ack may add an a
7390: 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65  ttached database
73a0: 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 74 72 61  .  ** to the tra
73b0: 6e 73 61 63 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20  nsaction..  */. 
73c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 74 61   rc = sqlite3Vta
73d0: 62 53 79 6e 63 28 64 62 2c 20 72 63 29 3b 0a 20  bSync(db, rc);. 
73e0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
73f0: 4f 4b 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  OK ){.    return
7400: 20 72 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54   rc;.  }..  /* T
7410: 68 69 73 20 6c 6f 6f 70 20 64 65 74 65 72 6d 69  his loop determi
7420: 6e 65 73 20 28 61 29 20 69 66 20 74 68 65 20 63  nes (a) if the c
7430: 6f 6d 6d 69 74 20 68 6f 6f 6b 20 73 68 6f 75 6c  ommit hook shoul
7440: 64 20 62 65 20 69 6e 76 6f 6b 65 64 20 61 6e 64  d be invoked and
7450: 0a 20 20 2a 2a 20 28 62 29 20 68 6f 77 20 6d 61  .  ** (b) how ma
7460: 6e 79 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ny database file
7470: 73 20 68 61 76 65 20 6f 70 65 6e 20 77 72 69 74  s have open writ
7480: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 2c 20  e transactions, 
7490: 6e 6f 74 20 0a 20 20 2a 2a 20 69 6e 63 6c 75 64  not .  ** includ
74a0: 69 6e 67 20 74 68 65 20 74 65 6d 70 20 64 61 74  ing the temp dat
74b0: 61 62 61 73 65 2e 20 28 62 29 20 69 73 20 69 6d  abase. (b) is im
74c0: 70 6f 72 74 61 6e 74 20 62 65 63 61 75 73 65 20  portant because 
74d0: 69 66 20 6d 6f 72 65 20 74 68 61 6e 20 0a 20 20  if more than .  
74e0: 2a 2a 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20  ** one database 
74f0: 66 69 6c 65 20 68 61 73 20 61 6e 20 6f 70 65 6e  file has an open
7500: 20 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69   write transacti
7510: 6f 6e 2c 20 61 20 6d 61 73 74 65 72 20 6a 6f 75  on, a master jou
7520: 72 6e 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 20 69  rnal.  ** file i
7530: 73 20 72 65 71 75 69 72 65 64 20 66 6f 72 20 61  s required for a
7540: 6e 20 61 74 6f 6d 69 63 20 63 6f 6d 6d 69 74 2e  n atomic commit.
7550: 0a 20 20 2a 2f 20 0a 20 20 66 6f 72 28 69 3d 30  .  */ .  for(i=0
7560: 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b  ; i<db->nDb; i++
7570: 29 7b 20 0a 20 20 20 20 42 74 72 65 65 20 2a 70  ){ .    Btree *p
7580: 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e  Bt = db->aDb[i].
7590: 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74  pBt;.    if( pBt
75a0: 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65 65   && sqlite3Btree
75b0: 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29  IsInTrans(pBt) )
75c0: 7b 0a 20 20 20 20 20 20 6e 65 65 64 58 63 6f 6d  {.      needXcom
75d0: 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 69  mit = 1;.      i
75e0: 66 28 20 69 21 3d 31 20 29 20 6e 54 72 61 6e 73  f( i!=1 ) nTrans
75f0: 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20  ++;.    }.  }.. 
7600: 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61 72 65   /* If there are
7610: 20 61 6e 79 20 77 72 69 74 65 2d 74 72 61 6e 73   any write-trans
7620: 61 63 74 69 6f 6e 73 20 61 74 20 61 6c 6c 2c 20  actions at all, 
7630: 69 6e 76 6f 6b 65 20 74 68 65 20 63 6f 6d 6d 69  invoke the commi
7640: 74 20 68 6f 6f 6b 20 2a 2f 0a 20 20 69 66 28 20  t hook */.  if( 
7650: 6e 65 65 64 58 63 6f 6d 6d 69 74 20 26 26 20 64  needXcommit && d
7660: 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61  b->xCommitCallba
7670: 63 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ck ){.    sqlite
7680: 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a  3SafetyOff(db);.
7690: 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 78 43 6f      rc = db->xCo
76a0: 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 64 62 2d  mmitCallback(db-
76b0: 3e 70 43 6f 6d 6d 69 74 41 72 67 29 3b 0a 20 20  >pCommitArg);.  
76c0: 20 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f    sqlite3SafetyO
76d0: 6e 28 64 62 29 3b 0a 20 20 20 20 69 66 28 20 72  n(db);.    if( r
76e0: 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72  c ){.      retur
76f0: 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41  n SQLITE_CONSTRA
7700: 49 4e 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a  INT;.    }.  }..
7710: 20 20 2f 2a 20 54 68 65 20 73 69 6d 70 6c 65 20    /* The simple 
7720: 63 61 73 65 20 2d 20 6e 6f 20 6d 6f 72 65 20 74  case - no more t
7730: 68 61 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65  han one database
7740: 20 66 69 6c 65 20 28 6e 6f 74 20 63 6f 75 6e 74   file (not count
7750: 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 54 45 4d  ing the.  ** TEM
7760: 50 20 64 61 74 61 62 61 73 65 29 20 68 61 73 20  P database) has 
7770: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63  a transaction ac
7780: 74 69 76 65 2e 20 20 20 54 68 65 72 65 20 69 73  tive.   There is
7790: 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 74 68 65   no need for the
77a0: 0a 20 20 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f 75  .  ** master-jou
77b0: 72 6e 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  rnal..  **.  ** 
77c0: 49 66 20 74 68 65 20 72 65 74 75 72 6e 20 76 61  If the return va
77d0: 6c 75 65 20 6f 66 20 73 71 6c 69 74 65 33 42 74  lue of sqlite3Bt
77e0: 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 29  reeGetFilename()
77f0: 20 69 73 20 61 20 7a 65 72 6f 20 6c 65 6e 67 74   is a zero lengt
7800: 68 0a 20 20 2a 2a 20 73 74 72 69 6e 67 2c 20 69  h.  ** string, i
7810: 74 20 6d 65 61 6e 73 20 74 68 65 20 6d 61 69 6e  t means the main
7820: 20 64 61 74 61 62 61 73 65 20 69 73 20 3a 6d 65   database is :me
7830: 6d 6f 72 79 3a 2e 20 20 49 6e 20 74 68 61 74 20  mory:.  In that 
7840: 63 61 73 65 20 77 65 20 64 6f 0a 20 20 2a 2a 20  case we do.  ** 
7850: 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 74 6f 6d  not support atom
7860: 69 63 20 6d 75 6c 74 69 2d 66 69 6c 65 20 63 6f  ic multi-file co
7870: 6d 6d 69 74 73 2c 20 73 6f 20 75 73 65 20 74 68  mmits, so use th
7880: 65 20 73 69 6d 70 6c 65 20 63 61 73 65 20 74 68  e simple case th
7890: 65 6e 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20 2a  en.  ** too..  *
78a0: 2f 0a 20 20 69 66 28 20 30 3d 3d 73 74 72 6c 65  /.  if( 0==strle
78b0: 6e 28 73 71 6c 69 74 65 33 42 74 72 65 65 47 65  n(sqlite3BtreeGe
78c0: 74 46 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61 44  tFilename(db->aD
78d0: 62 5b 30 5d 2e 70 42 74 29 29 20 7c 7c 20 6e 54  b[0].pBt)) || nT
78e0: 72 61 6e 73 3c 3d 31 20 29 7b 0a 20 20 20 20 66  rans<=1 ){.    f
78f0: 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49  or(i=0; rc==SQLI
7900: 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e  TE_OK && i<db->n
7910: 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20  Db; i++){ .     
7920: 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62   Btree *pBt = db
7930: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20  ->aDb[i].pBt;.  
7940: 20 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20      if( pBt ){. 
7950: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69         rc = sqli
7960: 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68  te3BtreeCommitPh
7970: 61 73 65 4f 6e 65 28 70 42 74 2c 20 30 29 3b 0a  aseOne(pBt, 0);.
7980: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20        }.    }.. 
7990: 20 20 20 2f 2a 20 44 6f 20 74 68 65 20 63 6f 6d     /* Do the com
79a0: 6d 69 74 20 6f 6e 6c 79 20 69 66 20 61 6c 6c 20  mit only if all 
79b0: 64 61 74 61 62 61 73 65 73 20 73 75 63 63 65 73  databases succes
79c0: 73 66 75 6c 6c 79 20 63 6f 6d 70 6c 65 74 65 20  sfully complete 
79d0: 70 68 61 73 65 20 31 2e 20 0a 20 20 20 20 2a 2a  phase 1. .    **
79e0: 20 49 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 42   If one of the B
79f0: 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f  treeCommitPhaseO
7a00: 6e 65 28 29 20 63 61 6c 6c 73 20 66 61 69 6c 73  ne() calls fails
7a10: 2c 20 74 68 69 73 20 69 6e 64 69 63 61 74 65 73  , this indicates
7a20: 20 61 6e 0a 20 20 20 20 2a 2a 20 49 4f 20 65 72   an.    ** IO er
7a30: 72 6f 72 20 77 68 69 6c 65 20 64 65 6c 65 74 69  ror while deleti
7a40: 6e 67 20 6f 72 20 74 72 75 6e 63 61 74 69 6e 67  ng or truncating
7a50: 20 61 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e   a journal file.
7a60: 20 49 74 20 69 73 20 75 6e 6c 69 6b 65 6c 79 2c   It is unlikely,
7a70: 0a 20 20 20 20 2a 2a 20 62 75 74 20 63 6f 75 6c  .    ** but coul
7a80: 64 20 68 61 70 70 65 6e 2e 20 49 6e 20 74 68 69  d happen. In thi
7a90: 73 20 63 61 73 65 20 61 62 61 6e 64 6f 6e 20 70  s case abandon p
7aa0: 72 6f 63 65 73 73 69 6e 67 20 61 6e 64 20 72 65  rocessing and re
7ab0: 74 75 72 6e 20 74 68 65 20 65 72 72 6f 72 2e 0a  turn the error..
7ac0: 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69      */.    for(i
7ad0: 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  =0; rc==SQLITE_O
7ae0: 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  K && i<db->nDb; 
7af0: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 42 74 72 65  i++){.      Btre
7b00: 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62  e *pBt = db->aDb
7b10: 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69  [i].pBt;.      i
7b20: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20  f( pBt ){.      
7b30: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74    rc = sqlite3Bt
7b40: 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77  reeCommitPhaseTw
7b50: 6f 28 70 42 74 29 3b 0a 20 20 20 20 20 20 7d 0a  o(pBt);.      }.
7b60: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
7b70: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
7b80: 20 20 20 20 20 73 71 6c 69 74 65 33 56 74 61 62       sqlite3Vtab
7b90: 43 6f 6d 6d 69 74 28 64 62 29 3b 0a 20 20 20 20  Commit(db);.    
7ba0: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20  }.  }..  /* The 
7bb0: 63 6f 6d 70 6c 65 78 20 63 61 73 65 20 2d 20 54  complex case - T
7bc0: 68 65 72 65 20 69 73 20 61 20 6d 75 6c 74 69 2d  here is a multi-
7bd0: 66 69 6c 65 20 77 72 69 74 65 2d 74 72 61 6e 73  file write-trans
7be0: 61 63 74 69 6f 6e 20 61 63 74 69 76 65 2e 0a 20  action active.. 
7bf0: 20 2a 2a 20 54 68 69 73 20 72 65 71 75 69 72 65   ** This require
7c00: 73 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  s a master journ
7c10: 61 6c 20 66 69 6c 65 20 74 6f 20 65 6e 73 75 72  al file to ensur
7c20: 65 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  e the transactio
7c30: 6e 20 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d 69 74  n is.  ** commit
7c40: 74 65 64 20 61 74 6f 6d 69 63 6c 79 2e 0a 20 20  ted atomicly..  
7c50: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  */.#ifndef SQLIT
7c60: 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 20 20  E_OMIT_DISKIO.  
7c70: 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74 20 6e 65  else{.    int ne
7c80: 65 64 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20  edSync = 0;.    
7c90: 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20  char *zMaster = 
7ca0: 30 3b 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61 6d  0;   /* File-nam
7cb0: 65 20 66 6f 72 20 74 68 65 20 6d 61 73 74 65 72  e for the master
7cc0: 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20 20   journal */.    
7cd0: 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 69  char const *zMai
7ce0: 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42  nFile = sqlite3B
7cf0: 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28  treeGetFilename(
7d00: 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b  db->aDb[0].pBt);
7d10: 0a 20 20 20 20 4f 73 46 69 6c 65 20 2a 6d 61 73  .    OsFile *mas
7d20: 74 65 72 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a  ter = 0;..    /*
7d30: 20 53 65 6c 65 63 74 20 61 20 6d 61 73 74 65 72   Select a master
7d40: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61   journal file na
7d50: 6d 65 20 2a 2f 0a 20 20 20 20 64 6f 20 7b 0a 20  me */.    do {. 
7d60: 20 20 20 20 20 75 33 32 20 72 61 6e 64 6f 6d 3b       u32 random;
7d70: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65  .      sqliteFre
7d80: 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20  e(zMaster);.    
7d90: 20 20 73 71 6c 69 74 65 33 52 61 6e 64 6f 6d 6e    sqlite3Randomn
7da0: 65 73 73 28 73 69 7a 65 6f 66 28 72 61 6e 64 6f  ess(sizeof(rando
7db0: 6d 29 2c 20 26 72 61 6e 64 6f 6d 29 3b 0a 20 20  m), &random);.  
7dc0: 20 20 20 20 7a 4d 61 73 74 65 72 20 3d 20 73 71      zMaster = sq
7dd0: 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 22 25 73  lite3MPrintf("%s
7de0: 2d 6d 6a 25 30 38 58 22 2c 20 7a 4d 61 69 6e 46  -mj%08X", zMainF
7df0: 69 6c 65 2c 20 72 61 6e 64 6f 6d 26 30 78 37 66  ile, random&0x7f
7e00: 66 66 66 66 66 66 29 3b 0a 20 20 20 20 20 20 69  ffffff);.      i
7e10: 66 28 20 21 7a 4d 61 73 74 65 72 20 29 7b 0a 20  f( !zMaster ){. 
7e20: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53 51         return SQ
7e30: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20  LITE_NOMEM;.    
7e40: 20 20 7d 0a 20 20 20 20 7d 77 68 69 6c 65 28 20    }.    }while( 
7e50: 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69  sqlite3OsFileExi
7e60: 73 74 73 28 7a 4d 61 73 74 65 72 29 20 29 3b 0a  sts(zMaster) );.
7e70: 0a 20 20 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65  .    /* Open the
7e80: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e   master journal.
7e90: 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   */.    rc = sql
7ea0: 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73  ite3OsOpenExclus
7eb0: 69 76 65 28 7a 4d 61 73 74 65 72 2c 20 26 6d 61  ive(zMaster, &ma
7ec0: 73 74 65 72 2c 20 30 29 3b 0a 20 20 20 20 69 66  ster, 0);.    if
7ed0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
7ee0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  ){.      sqliteF
7ef0: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
7f00: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
7f10: 20 20 20 7d 0a 20 0a 20 20 20 20 2f 2a 20 57 72     }. .    /* Wr
7f20: 69 74 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  ite the name of 
7f30: 65 61 63 68 20 64 61 74 61 62 61 73 65 20 66 69  each database fi
7f40: 6c 65 20 69 6e 20 74 68 65 20 74 72 61 6e 73 61  le in the transa
7f50: 63 74 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20 6e  ction into the n
7f60: 65 77 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65 72  ew.    ** master
7f70: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49   journal file. I
7f80: 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72  f an error occur
7f90: 73 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20  s at this point 
7fa0: 63 6c 6f 73 65 0a 20 20 20 20 2a 2a 20 61 6e 64  close.    ** and
7fb0: 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61 73 74   delete the mast
7fc0: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e  er journal file.
7fd0: 20 41 6c 6c 20 74 68 65 20 69 6e 64 69 76 69 64   All the individ
7fe0: 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ual journal file
7ff0: 73 0a 20 20 20 20 2a 2a 20 73 74 69 6c 6c 20 68  s.    ** still h
8000: 61 76 65 20 27 6e 75 6c 6c 27 20 61 73 20 74 68  ave 'null' as th
8010: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
8020: 20 70 6f 69 6e 74 65 72 2c 20 73 6f 20 74 68 65   pointer, so the
8030: 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a 20 20 20 20  y will roll.    
8040: 2a 2a 20 62 61 63 6b 20 69 6e 64 65 70 65 6e 64  ** back independ
8050: 65 6e 74 6c 79 20 69 66 20 61 20 66 61 69 6c 75  ently if a failu
8060: 72 65 20 6f 63 63 75 72 73 2e 0a 20 20 20 20 2a  re occurs..    *
8070: 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  /.    for(i=0; i
8080: 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20  <db->nDb; i++){ 
8090: 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42  .      Btree *pB
80a0: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70  t = db->aDb[i].p
80b0: 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 69 3d  Bt;.      if( i=
80c0: 3d 31 20 29 20 63 6f 6e 74 69 6e 75 65 3b 20 20  =1 ) continue;  
80d0: 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68 65 20 54   /* Ignore the T
80e0: 45 4d 50 20 64 61 74 61 62 61 73 65 20 2a 2f 0a  EMP database */.
80f0: 20 20 20 20 20 20 69 66 28 20 70 42 74 20 26 26        if( pBt &&
8100: 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 49   sqlite3BtreeIsI
8110: 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20  nTrans(pBt) ){. 
8120: 20 20 20 20 20 20 20 63 68 61 72 20 63 6f 6e 73         char cons
8130: 74 20 2a 7a 46 69 6c 65 20 3d 20 73 71 6c 69 74  t *zFile = sqlit
8140: 65 33 42 74 72 65 65 47 65 74 4a 6f 75 72 6e 61  e3BtreeGetJourna
8150: 6c 6e 61 6d 65 28 70 42 74 29 3b 0a 20 20 20 20  lname(pBt);.    
8160: 20 20 20 20 69 66 28 20 7a 46 69 6c 65 5b 30 5d      if( zFile[0]
8170: 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 20  ==0 ) continue; 
8180: 20 2f 2a 20 49 67 6e 6f 72 65 20 3a 6d 65 6d 6f   /* Ignore :memo
8190: 72 79 3a 20 64 61 74 61 62 61 73 65 73 20 2a 2f  ry: databases */
81a0: 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 6e 65  .        if( !ne
81b0: 65 64 53 79 6e 63 20 26 26 20 21 73 71 6c 69 74  edSync && !sqlit
81c0: 65 33 42 74 72 65 65 53 79 6e 63 44 69 73 61 62  e3BtreeSyncDisab
81d0: 6c 65 64 28 70 42 74 29 20 29 7b 0a 20 20 20 20  led(pBt) ){.    
81e0: 20 20 20 20 20 20 6e 65 65 64 53 79 6e 63 20 3d        needSync =
81f0: 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20   1;.        }.  
8200: 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74        rc = sqlit
8210: 65 33 4f 73 57 72 69 74 65 28 6d 61 73 74 65 72  e3OsWrite(master
8220: 2c 20 7a 46 69 6c 65 2c 20 73 74 72 6c 65 6e 28  , zFile, strlen(
8230: 7a 46 69 6c 65 29 2b 31 29 3b 0a 20 20 20 20 20  zFile)+1);.     
8240: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54     if( rc!=SQLIT
8250: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20  E_OK ){.        
8260: 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65    sqlite3OsClose
8270: 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 20  (&master);.     
8280: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65       sqlite3OsDe
8290: 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  lete(zMaster);. 
82a0: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 46           sqliteF
82b0: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
82c0: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 72          return r
82d0: 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  c;.        }.   
82e0: 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 0a 20 20 20     }.    }...   
82f0: 20 2f 2a 20 53 79 6e 63 20 74 68 65 20 6d 61 73   /* Sync the mas
8300: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
8310: 2e 20 42 65 66 6f 72 65 20 64 6f 69 6e 67 20 74  . Before doing t
8320: 68 69 73 2c 20 6f 70 65 6e 20 74 68 65 20 64 69  his, open the di
8330: 72 65 63 74 6f 72 79 0a 20 20 20 20 2a 2a 20 74  rectory.    ** t
8340: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
8350: 6c 20 66 69 6c 65 20 69 73 20 73 74 6f 72 65 20  l file is store 
8360: 69 6e 20 73 6f 20 74 68 61 74 20 69 74 20 67 65  in so that it ge
8370: 74 73 20 73 79 6e 63 65 64 20 74 6f 6f 2e 0a 20  ts synced too.. 
8380: 20 20 20 2a 2f 0a 20 20 20 20 7a 4d 61 69 6e 46     */.    zMainF
8390: 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72  ile = sqlite3Btr
83a0: 65 65 47 65 74 44 69 72 6e 61 6d 65 28 64 62 2d  eeGetDirname(db-
83b0: 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20  >aDb[0].pBt);.  
83c0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
83d0: 4f 70 65 6e 44 69 72 65 63 74 6f 72 79 28 6d 61  OpenDirectory(ma
83e0: 73 74 65 72 2c 20 7a 4d 61 69 6e 46 69 6c 65 29  ster, zMainFile)
83f0: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
8400: 4c 49 54 45 5f 4f 4b 20 7c 7c 0a 20 20 20 20 20  LITE_OK ||.     
8410: 20 20 20 20 20 28 6e 65 65 64 53 79 6e 63 20 26       (needSync &
8420: 26 20 28 72 63 3d 73 71 6c 69 74 65 33 4f 73 53  & (rc=sqlite3OsS
8430: 79 6e 63 28 6d 61 73 74 65 72 2c 30 29 29 21 3d  ync(master,0))!=
8440: 53 51 4c 49 54 45 5f 4f 4b 29 20 29 7b 0a 20 20  SQLITE_OK) ){.  
8450: 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f      sqlite3OsClo
8460: 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20  se(&master);.   
8470: 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65     sqlite3OsDele
8480: 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  te(zMaster);.   
8490: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
84a0: 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 72 65  aster);.      re
84b0: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a  turn rc;.    }..
84c0: 20 20 20 20 2f 2a 20 53 79 6e 63 20 61 6c 6c 20      /* Sync all 
84d0: 74 68 65 20 64 62 20 66 69 6c 65 73 20 69 6e 76  the db files inv
84e0: 6f 6c 76 65 64 20 69 6e 20 74 68 65 20 74 72 61  olved in the tra
84f0: 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 61  nsaction. The sa
8500: 6d 65 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 73  me call.    ** s
8510: 65 74 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a  ets the master j
8520: 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 69  ournal pointer i
8530: 6e 20 65 61 63 68 20 69 6e 64 69 76 69 64 75 61  n each individua
8540: 6c 20 6a 6f 75 72 6e 61 6c 2e 20 49 66 0a 20 20  l journal. If.  
8550: 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f 63    ** an error oc
8560: 63 75 72 73 20 68 65 72 65 2c 20 64 6f 20 6e 6f  curs here, do no
8570: 74 20 64 65 6c 65 74 65 20 74 68 65 20 6d 61 73  t delete the mas
8580: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
8590: 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20  ..    **.    ** 
85a0: 49 66 20 74 68 65 20 65 72 72 6f 72 20 6f 63 63  If the error occ
85b0: 75 72 73 20 64 75 72 69 6e 67 20 74 68 65 20 66  urs during the f
85c0: 69 72 73 74 20 63 61 6c 6c 20 74 6f 0a 20 20 20  irst call to.   
85d0: 20 2a 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65   ** sqlite3Btree
85e0: 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29  CommitPhaseOne()
85f0: 2c 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 20  , then there is 
8600: 61 20 63 68 61 6e 63 65 20 74 68 61 74 20 74 68  a chance that th
8610: 65 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20  e.    ** master 
8620: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77 69 6c  journal file wil
8630: 6c 20 62 65 20 6f 72 70 68 61 6e 65 64 2e 20 42  l be orphaned. B
8640: 75 74 20 77 65 20 63 61 6e 6e 6f 74 20 64 65 6c  ut we cannot del
8650: 65 74 65 20 69 74 2c 0a 20 20 20 20 2a 2a 20 69  ete it,.    ** i
8660: 6e 20 63 61 73 65 20 74 68 65 20 6d 61 73 74 65  n case the maste
8670: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e  r journal file n
8680: 61 6d 65 20 77 61 73 20 77 72 69 74 74 65 6e 20  ame was written 
8690: 69 6e 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c  into the journal
86a0: 0a 20 20 20 20 2a 2a 20 66 69 6c 65 20 62 65 66  .    ** file bef
86b0: 6f 72 65 20 74 68 65 20 66 61 69 6c 75 72 65 20  ore the failure 
86c0: 6f 63 63 75 72 65 64 2e 0a 20 20 20 20 2a 2f 0a  occured..    */.
86d0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d      for(i=0; rc=
86e0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c  =SQLITE_OK && i<
86f0: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a  db->nDb; i++){ .
8700: 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74        Btree *pBt
8710: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42   = db->aDb[i].pB
8720: 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 74  t;.      if( pBt
8730: 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65 65   && sqlite3Btree
8740: 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29  IsInTrans(pBt) )
8750: 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73  {.        rc = s
8760: 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69  qlite3BtreeCommi
8770: 74 50 68 61 73 65 4f 6e 65 28 70 42 74 2c 20 7a  tPhaseOne(pBt, z
8780: 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 7d  Master);.      }
8790: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
87a0: 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65  e3OsClose(&maste
87b0: 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d  r);.    if( rc!=
87c0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
87d0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
87e0: 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 72 65  aster);.      re
87f0: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a  turn rc;.    }..
8800: 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 74 68      /* Delete th
8810: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
8820: 20 66 69 6c 65 2e 20 54 68 69 73 20 63 6f 6d 6d   file. This comm
8830: 69 74 73 20 74 68 65 20 74 72 61 6e 73 61 63 74  its the transact
8840: 69 6f 6e 2e 20 41 66 74 65 72 0a 20 20 20 20 2a  ion. After.    *
8850: 2a 20 64 6f 69 6e 67 20 74 68 69 73 20 74 68 65  * doing this the
8860: 20 64 69 72 65 63 74 6f 72 79 20 69 73 20 73 79   directory is sy
8870: 6e 63 65 64 20 61 67 61 69 6e 20 62 65 66 6f 72  nced again befor
8880: 65 20 61 6e 79 20 69 6e 64 69 76 69 64 75 61 6c  e any individual
8890: 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74  .    ** transact
88a0: 69 6f 6e 20 66 69 6c 65 73 20 61 72 65 20 64 65  ion files are de
88b0: 6c 65 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  leted..    */.  
88c0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
88d0: 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b  Delete(zMaster);
88e0: 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28  .    sqliteFree(
88f0: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 7a 4d  zMaster);.    zM
8900: 61 73 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 69  aster = 0;.    i
8910: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 72  f( rc ){.      r
8920: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a  eturn rc;.    }.
8930: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
8940: 4f 73 53 79 6e 63 44 69 72 65 63 74 6f 72 79 28  OsSyncDirectory(
8950: 7a 4d 61 69 6e 46 69 6c 65 29 3b 0a 20 20 20 20  zMainFile);.    
8960: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
8970: 4b 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68  K ){.      /* Th
8980: 69 73 20 69 73 20 6e 6f 74 20 67 6f 6f 64 2e 20  is is not good. 
8990: 54 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  The master journ
89a0: 61 6c 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e  al file has been
89b0: 20 64 65 6c 65 74 65 64 2c 20 62 75 74 0a 20 20   deleted, but.  
89c0: 20 20 20 20 2a 2a 20 74 68 65 20 64 69 72 65 63      ** the direc
89d0: 74 6f 72 79 20 73 79 6e 63 20 66 61 69 6c 65 64  tory sync failed
89e0: 2e 20 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f  . There is no co
89f0: 6d 70 6c 65 74 65 6c 79 20 73 61 66 65 20 63 6f  mpletely safe co
8a00: 75 72 73 65 20 6f 66 0a 20 20 20 20 20 20 2a 2a  urse of.      **
8a10: 20 61 63 74 69 6f 6e 20 66 72 6f 6d 20 68 65 72   action from her
8a20: 65 2e 20 54 68 65 20 69 6e 64 69 76 69 64 75 61  e. The individua
8a30: 6c 20 6a 6f 75 72 6e 61 6c 73 20 63 6f 6e 74 61  l journals conta
8a40: 69 6e 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  in the name of t
8a50: 68 65 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74  he.      ** mast
8a60: 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c  er journal file,
8a70: 20 62 75 74 20 74 68 65 72 65 20 69 73 20 6e 6f   but there is no
8a80: 20 77 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20   way of knowing 
8a90: 69 66 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a  if that.      **
8aa0: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8ab0: 65 78 69 73 74 73 20 6e 6f 77 20 6f 72 20 69 66  exists now or if
8ac0: 20 69 74 20 77 69 6c 6c 20 65 78 69 73 74 20 61   it will exist a
8ad0: 66 74 65 72 20 74 68 65 20 6f 70 65 72 61 74 69  fter the operati
8ae0: 6e 67 0a 20 20 20 20 20 20 2a 2a 20 73 79 73 74  ng.      ** syst
8af0: 65 6d 20 63 72 61 73 68 20 74 68 61 74 20 6d 61  em crash that ma
8b00: 79 20 66 6f 6c 6c 6f 77 20 74 68 65 20 66 73 79  y follow the fsy
8b10: 6e 63 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20  nc() failure..  
8b20: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74      */.      ret
8b30: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20  urn rc;.    }.. 
8b40: 20 20 20 2f 2a 20 41 6c 6c 20 66 69 6c 65 73 20     /* All files 
8b50: 61 6e 64 20 64 69 72 65 63 74 6f 72 69 65 73 20  and directories 
8b60: 68 61 76 65 20 61 6c 72 65 61 64 79 20 62 65 65  have already bee
8b70: 6e 20 73 79 6e 63 65 64 2c 20 73 6f 20 74 68 65  n synced, so the
8b80: 20 66 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 2a   following.    *
8b90: 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74  * calls to sqlit
8ba0: 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61  e3BtreeCommitPha
8bb0: 73 65 54 77 6f 28 29 20 61 72 65 20 6f 6e 6c 79  seTwo() are only
8bc0: 20 63 6c 6f 73 69 6e 67 20 66 69 6c 65 73 20 61   closing files a
8bd0: 6e 64 0a 20 20 20 20 2a 2a 20 64 65 6c 65 74 69  nd.    ** deleti
8be0: 6e 67 20 6f 72 20 74 72 75 6e 63 61 74 69 6e 67  ng or truncating
8bf0: 20 6a 6f 75 72 6e 61 6c 73 2e 20 49 66 20 73 6f   journals. If so
8c00: 6d 65 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f  mething goes wro
8c10: 6e 67 20 77 68 69 6c 65 0a 20 20 20 20 2a 2a 20  ng while.    ** 
8c20: 74 68 69 73 20 69 73 20 68 61 70 70 65 6e 69 6e  this is happenin
8c30: 67 20 77 65 20 64 6f 6e 27 74 20 72 65 61 6c 6c  g we don't reall
8c40: 79 20 63 61 72 65 2e 20 54 68 65 20 69 6e 74 65  y care. The inte
8c50: 67 72 69 74 79 20 6f 66 20 74 68 65 0a 20 20 20  grity of the.   
8c60: 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   ** transaction 
8c70: 69 73 20 61 6c 72 65 61 64 79 20 67 75 61 72 61  is already guara
8c80: 6e 74 65 65 64 2c 20 62 75 74 20 73 6f 6d 65 20  nteed, but some 
8c90: 73 74 72 61 79 20 27 63 6f 6c 64 27 20 6a 6f 75  stray 'cold' jou
8ca0: 72 6e 61 6c 73 0a 20 20 20 20 2a 2a 20 6d 61 79  rnals.    ** may
8cb0: 20 62 65 20 6c 79 69 6e 67 20 61 72 6f 75 6e 64   be lying around
8cc0: 2e 20 52 65 74 75 72 6e 69 6e 67 20 61 6e 20 65  . Returning an e
8cd0: 72 72 6f 72 20 63 6f 64 65 20 77 6f 6e 27 74 20  rror code won't 
8ce0: 68 65 6c 70 20 6d 61 74 74 65 72 73 2e 0a 20 20  help matters..  
8cf0: 20 20 2a 2f 0a 20 20 20 20 64 69 73 61 62 6c 65    */.    disable
8d00: 5f 73 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72  _simulated_io_er
8d10: 72 6f 72 73 28 29 3b 0a 20 20 20 20 66 6f 72 28  rors();.    for(
8d20: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
8d30: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72  i++){ .      Btr
8d40: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
8d50: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
8d60: 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20  if( pBt ){.     
8d70: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
8d80: 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28 70 42  ommitPhaseTwo(pB
8d90: 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  t);.      }.    
8da0: 7d 0a 20 20 20 20 65 6e 61 62 6c 65 5f 73 69 6d  }.    enable_sim
8db0: 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73  ulated_io_errors
8dc0: 28 29 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65 33  ();..    sqlite3
8dd0: 56 74 61 62 43 6f 6d 6d 69 74 28 64 62 29 3b 0a  VtabCommit(db);.
8de0: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65    }.#endif..  re
8df0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 0a  turn rc;.}../* .
8e00: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
8e10: 63 68 65 63 6b 73 20 74 68 61 74 20 74 68 65 20  checks that the 
8e20: 73 71 6c 69 74 65 33 2e 61 63 74 69 76 65 56 64  sqlite3.activeVd
8e30: 62 65 43 6e 74 20 63 6f 75 6e 74 20 76 61 72 69  beCnt count vari
8e40: 61 62 6c 65 0a 2a 2a 20 6d 61 74 63 68 65 73 20  able.** matches 
8e50: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 64  the number of vd
8e60: 62 65 27 73 20 69 6e 20 74 68 65 20 6c 69 73 74  be's in the list
8e70: 20 73 71 6c 69 74 65 33 2e 70 56 64 62 65 20 74   sqlite3.pVdbe t
8e80: 68 61 74 20 61 72 65 0a 2a 2a 20 63 75 72 72 65  hat are.** curre
8e90: 6e 74 6c 79 20 61 63 74 69 76 65 2e 20 41 6e 20  ntly active. An 
8ea0: 61 73 73 65 72 74 69 6f 6e 20 66 61 69 6c 73 20  assertion fails 
8eb0: 69 66 20 74 68 65 20 74 77 6f 20 63 6f 75 6e 74  if the two count
8ec0: 73 20 64 6f 20 6e 6f 74 20 6d 61 74 63 68 2e 0a  s do not match..
8ed0: 2a 2a 20 54 68 69 73 20 69 73 20 61 6e 20 69 6e  ** This is an in
8ee0: 74 65 72 6e 61 6c 20 73 65 6c 66 2d 63 68 65 63  ternal self-chec
8ef0: 6b 20 6f 6e 6c 79 20 2d 20 69 74 20 69 73 20 6e  k only - it is n
8f00: 6f 74 20 61 6e 20 65 73 73 65 6e 74 69 61 6c 20  ot an essential 
8f10: 70 72 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 73 74  processing.** st
8f20: 65 70 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69  ep..**.** This i
8f30: 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 4e 44 45  s a no-op if NDE
8f40: 42 55 47 20 69 73 20 64 65 66 69 6e 65 64 2e 0a  BUG is defined..
8f50: 2a 2f 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55  */.#ifndef NDEBU
8f60: 47 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 68  G.static void ch
8f70: 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74  eckActiveVdbeCnt
8f80: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
8f90: 20 56 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20   Vdbe *p;.  int 
8fa0: 63 6e 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20 64  cnt = 0;.  p = d
8fb0: 62 2d 3e 70 56 64 62 65 3b 0a 20 20 77 68 69 6c  b->pVdbe;.  whil
8fc0: 65 28 20 70 20 29 7b 0a 20 20 20 20 69 66 28 20  e( p ){.    if( 
8fd0: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
8fe0: 41 47 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 70  AGIC_RUN && p->p
8ff0: 63 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6e  c>=0 ){.      cn
9000: 74 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70  t++;.    }.    p
9010: 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d   = p->pNext;.  }
9020: 0a 20 20 61 73 73 65 72 74 28 20 63 6e 74 3d 3d  .  assert( cnt==
9030: 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e  db->activeVdbeCn
9040: 74 20 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65  t );.}.#else.#de
9050: 66 69 6e 65 20 63 68 65 63 6b 41 63 74 69 76 65  fine checkActive
9060: 56 64 62 65 43 6e 74 28 78 29 0a 23 65 6e 64 69  VdbeCnt(x).#endi
9070: 66 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 65 76  f../*.** Find ev
9080: 65 72 79 20 61 63 74 69 76 65 20 56 4d 20 6f 74  ery active VM ot
9090: 68 65 72 20 74 68 61 6e 20 70 56 64 62 65 20 61  her than pVdbe a
90a0: 6e 64 20 63 68 61 6e 67 65 20 69 74 73 20 73 74  nd change its st
90b0: 61 74 75 73 20 74 6f 0a 2a 2a 20 61 62 6f 72 74  atus to.** abort
90c0: 65 64 2e 20 20 54 68 69 73 20 68 61 70 70 65 6e  ed.  This happen
90d0: 73 20 77 68 65 6e 20 6f 6e 65 20 56 4d 20 63 61  s when one VM ca
90e0: 75 73 65 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20  uses a rollback 
90f0: 64 75 65 20 74 6f 20 61 6e 0a 2a 2a 20 4f 4e 20  due to an.** ON 
9100: 43 4f 4e 46 4c 49 43 54 20 52 4f 4c 4c 42 41 43  CONFLICT ROLLBAC
9110: 4b 20 63 6c 61 75 73 65 20 28 66 6f 72 20 65 78  K clause (for ex
9120: 61 6d 70 6c 65 29 2e 20 20 54 68 65 20 6f 74 68  ample).  The oth
9130: 65 72 20 56 4d 73 20 6d 75 73 74 20 62 65 0a 2a  er VMs must be.*
9140: 2a 20 61 62 6f 72 74 65 64 20 73 6f 20 74 68 61  * aborted so tha
9150: 74 20 74 68 65 79 20 64 6f 20 6e 6f 74 20 68 61  t they do not ha
9160: 76 65 20 64 61 74 61 20 72 6f 6c 6c 65 64 20 6f  ve data rolled o
9170: 75 74 20 66 72 6f 6d 20 75 6e 64 65 72 6e 65 61  ut from undernea
9180: 74 68 0a 2a 2a 20 74 68 65 6d 20 6c 65 61 64 69  th.** them leadi
9190: 6e 67 20 74 6f 20 61 20 73 65 67 66 61 75 6c 74  ng to a segfault
91a0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
91b0: 33 41 62 6f 72 74 4f 74 68 65 72 41 63 74 69 76  3AbortOtherActiv
91c0: 65 56 64 62 65 73 28 73 71 6c 69 74 65 33 20 2a  eVdbes(sqlite3 *
91d0: 64 62 2c 20 56 64 62 65 20 2a 70 45 78 63 65 70  db, Vdbe *pExcep
91e0: 74 29 7b 0a 20 20 56 64 62 65 20 2a 70 4f 74 68  t){.  Vdbe *pOth
91f0: 65 72 3b 0a 20 20 66 6f 72 28 70 4f 74 68 65 72  er;.  for(pOther
9200: 3d 64 62 2d 3e 70 56 64 62 65 3b 20 70 4f 74 68  =db->pVdbe; pOth
9210: 65 72 3b 20 70 4f 74 68 65 72 3d 70 4f 74 68 65  er; pOther=pOthe
9220: 72 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69  r->pNext){.    i
9230: 66 28 20 70 4f 74 68 65 72 3d 3d 70 45 78 63 65  f( pOther==pExce
9240: 70 74 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  pt ) continue;. 
9250: 20 20 20 69 66 28 20 70 4f 74 68 65 72 2d 3e 6d     if( pOther->m
9260: 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43  agic!=VDBE_MAGIC
9270: 5f 52 55 4e 20 7c 7c 20 70 4f 74 68 65 72 2d 3e  _RUN || pOther->
9280: 70 63 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b  pc<0 ) continue;
9290: 0a 20 20 20 20 63 68 65 63 6b 41 63 74 69 76 65  .    checkActive
92a0: 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 20 20 20  VdbeCnt(db);.   
92b0: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
92c0: 28 70 4f 74 68 65 72 29 3b 0a 20 20 20 20 63 68  (pOther);.    ch
92d0: 65 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74  eckActiveVdbeCnt
92e0: 28 64 62 29 3b 0a 20 20 20 20 70 4f 74 68 65 72  (db);.    pOther
92f0: 2d 3e 61 62 6f 72 74 65 64 20 3d 20 31 3b 0a 20  ->aborted = 1;. 
9300: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73   }.}../*.** This
9310: 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c   routine is call
9320: 65 64 20 74 68 65 20 77 68 65 6e 20 61 20 56 44  ed the when a VD
9330: 42 45 20 74 72 69 65 73 20 74 6f 20 68 61 6c 74  BE tries to halt
9340: 2e 20 20 49 66 20 74 68 65 20 56 44 42 45 0a 2a  .  If the VDBE.*
9350: 2a 20 68 61 73 20 6d 61 64 65 20 63 68 61 6e 67  * has made chang
9360: 65 73 20 61 6e 64 20 69 73 20 69 6e 20 61 75 74  es and is in aut
9370: 6f 63 6f 6d 6d 69 74 20 6d 6f 64 65 2c 20 74 68  ocommit mode, th
9380: 65 6e 20 63 6f 6d 6d 69 74 20 74 68 6f 73 65 0a  en commit those.
9390: 2a 2a 20 63 68 61 6e 67 65 73 2e 20 20 49 66 20  ** changes.  If 
93a0: 61 20 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6e 65  a rollback is ne
93b0: 65 64 65 64 2c 20 74 68 65 6e 20 64 6f 20 74 68  eded, then do th
93c0: 65 20 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a  e rollback..**.*
93d0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
93e0: 73 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74  s the only way t
93f0: 6f 20 6d 6f 76 65 20 74 68 65 20 73 74 61 74 65  o move the state
9400: 20 6f 66 20 61 20 56 4d 20 66 72 6f 6d 0a 2a 2a   of a VM from.**
9410: 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 52 55   SQLITE_MAGIC_RU
9420: 4e 20 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49  N to SQLITE_MAGI
9430: 43 5f 48 41 4c 54 2e 0a 2a 2a 0a 2a 2a 20 52 65  C_HALT..**.** Re
9440: 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f  turn an error co
9450: 64 65 2e 20 20 49 66 20 74 68 65 20 63 6f 6d 6d  de.  If the comm
9460: 69 74 20 63 6f 75 6c 64 20 6e 6f 74 20 63 6f 6d  it could not com
9470: 70 6c 65 74 65 20 62 65 63 61 75 73 65 20 6f 66  plete because of
9480: 0a 2a 2a 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74  .** lock content
9490: 69 6f 6e 2c 20 72 65 74 75 72 6e 20 53 51 4c 49  ion, return SQLI
94a0: 54 45 5f 42 55 53 59 2e 20 20 49 66 20 53 51 4c  TE_BUSY.  If SQL
94b0: 49 54 45 5f 42 55 53 59 20 69 73 20 72 65 74 75  ITE_BUSY is retu
94c0: 72 6e 65 64 2c 20 69 74 0a 2a 2a 20 6d 65 61 6e  rned, it.** mean
94d0: 73 20 74 68 65 20 63 6c 6f 73 65 20 64 69 64 20  s the close did 
94e0: 6e 6f 74 20 68 61 70 70 65 6e 20 61 6e 64 20 6e  not happen and n
94f0: 65 65 64 73 20 74 6f 20 62 65 20 72 65 70 65 61  eeds to be repea
9500: 74 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ted..*/.int sqli
9510: 74 65 33 56 64 62 65 48 61 6c 74 28 56 64 62 65  te3VdbeHalt(Vdbe
9520: 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 20   *p){.  sqlite3 
9530: 2a 64 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69  *db = p->db;.  i
9540: 6e 74 20 69 3b 0a 20 20 69 6e 74 20 28 2a 78 46  nt i;.  int (*xF
9550: 75 6e 63 29 28 42 74 72 65 65 20 2a 70 42 74 29  unc)(Btree *pBt)
9560: 20 3d 20 30 3b 20 20 2f 2a 20 46 75 6e 63 74 69   = 0;  /* Functi
9570: 6f 6e 20 74 6f 20 63 61 6c 6c 20 6f 6e 20 65 61  on to call on ea
9580: 63 68 20 62 74 72 65 65 20 62 61 63 6b 65 6e 64  ch btree backend
9590: 20 2a 2f 0a 20 20 69 6e 74 20 69 73 53 70 65 63   */.  int isSpec
95a0: 69 61 6c 45 72 72 6f 72 3b 20 20 20 20 20 20 20  ialError;       
95b0: 20 20 20 20 20 2f 2a 20 53 65 74 20 74 6f 20 74       /* Set to t
95c0: 72 75 65 20 69 66 20 53 51 4c 49 54 45 5f 4e 4f  rue if SQLITE_NO
95d0: 4d 45 4d 20 6f 72 20 49 4f 45 52 52 20 2a 2f 0a  MEM or IOERR */.
95e0: 0a 20 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74  .  /* This funct
95f0: 69 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65  ion contains the
9600: 20 6c 6f 67 69 63 20 74 68 61 74 20 64 65 74 65   logic that dete
9610: 72 6d 69 6e 65 73 20 69 66 20 61 20 73 74 61 74  rmines if a stat
9620: 65 6d 65 6e 74 20 6f 72 0a 20 20 2a 2a 20 74 72  ement or.  ** tr
9630: 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62  ansaction will b
9640: 65 20 63 6f 6d 6d 69 74 74 65 64 20 6f 72 20 72  e committed or r
9650: 6f 6c 6c 65 64 20 62 61 63 6b 20 61 73 20 61 20  olled back as a 
9660: 72 65 73 75 6c 74 20 6f 66 20 74 68 65 0a 20 20  result of the.  
9670: 2a 2a 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20  ** execution of 
9680: 74 68 69 73 20 76 69 72 74 75 61 6c 20 6d 61 63  this virtual mac
9690: 68 69 6e 65 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a  hine. .  **.  **
96a0: 20 53 70 65 63 69 61 6c 20 65 72 72 6f 72 73 3a   Special errors:
96b0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 49  .  **.  **     I
96c0: 66 20 61 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  f an SQLITE_NOME
96d0: 4d 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75  M error has occu
96e0: 72 65 64 20 69 6e 20 61 20 73 74 61 74 65 6d 65  red in a stateme
96f0: 6e 74 20 74 68 61 74 20 77 72 69 74 65 73 20 74  nt that writes t
9700: 6f 0a 20 20 2a 2a 20 20 20 20 20 74 68 65 20 64  o.  **     the d
9710: 61 74 61 62 61 73 65 2c 20 74 68 65 6e 20 65 69  atabase, then ei
9720: 74 68 65 72 20 61 20 73 74 61 74 65 6d 65 6e 74  ther a statement
9730: 20 6f 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 20   or transaction 
9740: 6d 75 73 74 20 62 65 20 72 6f 6c 6c 65 64 0a 20  must be rolled. 
9750: 20 2a 2a 20 20 20 20 20 62 61 63 6b 20 74 6f 20   **     back to 
9760: 65 6e 73 75 72 65 20 74 68 65 20 74 72 65 65 2d  ensure the tree-
9770: 73 74 72 75 63 74 75 72 65 73 20 61 72 65 20 69  structures are i
9780: 6e 20 61 20 63 6f 6e 73 69 73 74 65 6e 74 20 73  n a consistent s
9790: 74 61 74 65 2e 20 41 0a 20 20 2a 2a 20 20 20 20  tate. A.  **    
97a0: 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73   statement trans
97b0: 61 63 74 69 6f 6e 20 69 73 20 72 6f 6c 6c 65 64  action is rolled
97c0: 20 62 61 63 6b 20 69 66 20 6f 6e 65 20 69 73 20   back if one is 
97d0: 6f 70 65 6e 2c 20 6f 74 68 65 72 77 69 73 65 20  open, otherwise 
97e0: 74 68 65 0a 20 20 2a 2a 20 20 20 20 20 65 6e 74  the.  **     ent
97f0: 69 72 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  ire transaction 
9800: 6d 75 73 74 20 62 65 20 72 6f 6c 6c 65 64 20 62  must be rolled b
9810: 61 63 6b 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20  ack..  **.  **  
9820: 20 20 20 49 66 20 61 6e 20 53 51 4c 49 54 45 5f     If an SQLITE_
9830: 49 4f 45 52 52 20 65 72 72 6f 72 20 68 61 73 20  IOERR error has 
9840: 6f 63 63 75 72 65 64 20 69 6e 20 61 20 73 74 61  occured in a sta
9850: 74 65 6d 65 6e 74 20 74 68 61 74 20 77 72 69 74  tement that writ
9860: 65 73 20 74 6f 0a 20 20 2a 2a 20 20 20 20 20 74  es to.  **     t
9870: 68 65 20 64 61 74 61 62 61 73 65 2c 20 74 68 65  he database, the
9880: 6e 20 74 68 65 20 65 6e 74 69 72 65 20 74 72 61  n the entire tra
9890: 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 65  nsaction must be
98a0: 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68   rolled back. Th
98b0: 65 0a 20 20 2a 2a 20 20 20 20 20 49 2f 4f 20 65  e.  **     I/O e
98c0: 72 72 6f 72 20 6d 61 79 20 68 61 76 65 20 63 61  rror may have ca
98d0: 75 73 65 64 20 67 61 72 62 61 67 65 20 74 6f 20  used garbage to 
98e0: 62 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68  be written to th
98f0: 65 20 6a 6f 75 72 6e 61 6c 20 0a 20 20 2a 2a 20  e journal .  ** 
9900: 20 20 20 20 66 69 6c 65 2e 20 57 65 72 65 20 74      file. Were t
9910: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74  he transaction t
9920: 6f 20 63 6f 6e 74 69 6e 75 65 20 61 6e 64 20 65  o continue and e
9930: 76 65 6e 74 75 61 6c 6c 79 20 62 65 20 72 6f 6c  ventually be rol
9940: 6c 65 64 20 0a 20 20 2a 2a 20 20 20 20 20 62 61  led .  **     ba
9950: 63 6b 20 74 68 61 74 20 67 61 72 62 61 67 65 20  ck that garbage 
9960: 6d 69 67 68 74 20 65 6e 64 20 75 70 20 69 6e 20  might end up in 
9970: 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  the database fil
9980: 65 2e 0a 20 20 2a 2a 20 20 20 20 20 0a 20 20 2a  e..  **     .  *
9990: 2a 20 20 20 20 20 49 6e 20 62 6f 74 68 20 6f 66  *     In both of
99a0: 20 74 68 65 20 61 62 6f 76 65 20 63 61 73 65 73   the above cases
99b0: 2c 20 74 68 65 20 56 64 62 65 2e 65 72 72 6f 72  , the Vdbe.error
99c0: 41 63 74 69 6f 6e 20 76 61 72 69 61 62 6c 65 20  Action variable 
99d0: 69 73 20 0a 20 20 2a 2a 20 20 20 20 20 69 67 6e  is .  **     ign
99e0: 6f 72 65 64 2e 20 49 66 20 74 68 65 20 73 71 6c  ored. If the sql
99f0: 69 74 65 33 2e 61 75 74 6f 43 6f 6d 6d 69 74 20  ite3.autoCommit 
9a00: 66 6c 61 67 20 69 73 20 66 61 6c 73 65 20 61 6e  flag is false an
9a10: 64 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a  d a transaction.
9a20: 20 20 2a 2a 20 20 20 20 20 69 73 20 72 6f 6c 6c    **     is roll
9a30: 65 64 20 62 61 63 6b 2c 20 69 74 20 77 69 6c 6c  ed back, it will
9a40: 20 62 65 20 73 65 74 20 74 6f 20 74 72 75 65 2e   be set to true.
9a50: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4f 74 68 65 72  .  **.  ** Other
9a60: 20 65 72 72 6f 72 73 3a 0a 20 20 2a 2a 0a 20 20   errors:.  **.  
9a70: 2a 2a 20 4e 6f 20 65 72 72 6f 72 3a 0a 20 20 2a  ** No error:.  *
9a80: 2a 0a 20 20 2a 2f 0a 0a 20 20 69 66 28 20 73 71  *.  */..  if( sq
9a90: 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65  lite3MallocFaile
9aa0: 64 28 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63  d() ){.    p->rc
9ab0: 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b   = SQLITE_NOMEM;
9ac0: 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 6d 61  .  }.  if( p->ma
9ad0: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
9ae0: 52 55 4e 20 29 7b 0a 20 20 20 20 2f 2a 20 41 6c  RUN ){.    /* Al
9af0: 72 65 61 64 79 20 68 61 6c 74 65 64 2e 20 20 4e  ready halted.  N
9b00: 6f 74 68 69 6e 67 20 74 6f 20 64 6f 2e 20 2a 2f  othing to do. */
9b10: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
9b20: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
9b30: 43 5f 48 41 4c 54 20 29 3b 0a 23 69 66 6e 64 65  C_HALT );.#ifnde
9b40: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49  f SQLITE_OMIT_VI
9b50: 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 20 20 63  RTUALTABLE.    c
9b60: 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70  loseAllCursors(p
9b70: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65  );.#endif.    re
9b80: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
9b90: 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75    }.  closeAllCu
9ba0: 72 73 6f 72 73 28 70 29 3b 0a 20 20 63 68 65 63  rsors(p);.  chec
9bb0: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64  kActiveVdbeCnt(d
9bc0: 62 29 3b 0a 0a 20 20 2f 2a 20 4e 6f 20 63 6f 6d  b);..  /* No com
9bd0: 6d 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20  mit or rollback 
9be0: 6e 65 65 64 65 64 20 69 66 20 74 68 65 20 70 72  needed if the pr
9bf0: 6f 67 72 61 6d 20 6e 65 76 65 72 20 73 74 61 72  ogram never star
9c00: 74 65 64 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e  ted */.  if( p->
9c10: 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74  pc>=0 ){.    int
9c20: 20 6d 72 63 3b 20 20 20 2f 2a 20 50 72 69 6d 61   mrc;   /* Prima
9c30: 72 79 20 65 72 72 6f 72 20 63 6f 64 65 20 66 72  ry error code fr
9c40: 6f 6d 20 70 2d 3e 72 63 20 2a 2f 0a 20 20 20 20  om p->rc */.    
9c50: 2f 2a 20 43 68 65 63 6b 20 66 6f 72 20 6f 6e 65  /* Check for one
9c60: 20 6f 66 20 74 68 65 20 73 70 65 63 69 61 6c 20   of the special 
9c70: 65 72 72 6f 72 73 20 2d 20 53 51 4c 49 54 45 5f  errors - SQLITE_
9c80: 4e 4f 4d 45 4d 20 6f 72 20 53 51 4c 49 54 45 5f  NOMEM or SQLITE_
9c90: 49 4f 45 52 52 20 2a 2f 0a 20 20 20 20 6d 72 63  IOERR */.    mrc
9ca0: 20 3d 20 70 2d 3e 72 63 20 26 20 30 78 66 66 3b   = p->rc & 0xff;
9cb0: 0a 20 20 20 20 69 73 53 70 65 63 69 61 6c 45 72  .    isSpecialEr
9cc0: 72 6f 72 20 3d 20 28 28 6d 72 63 3d 3d 53 51 4c  ror = ((mrc==SQL
9cd0: 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 6d 72 63  ITE_NOMEM || mrc
9ce0: 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3f  ==SQLITE_IOERR)?
9cf0: 31 3a 30 29 3b 0a 20 20 20 20 69 66 28 20 69 73  1:0);.    if( is
9d00: 53 70 65 63 69 61 6c 45 72 72 6f 72 20 29 7b 0a  SpecialError ){.
9d10: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 6c 6f        /* This lo
9d20: 6f 70 20 64 6f 65 73 20 73 74 61 74 69 63 20 61  op does static a
9d30: 6e 61 6c 79 73 69 73 20 6f 66 20 74 68 65 20 71  nalysis of the q
9d40: 75 65 72 79 20 74 6f 20 73 65 65 20 77 68 69 63  uery to see whic
9d50: 68 20 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a  h of the.      *
9d60: 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 72 65  * following thre
9d70: 65 20 63 61 74 65 67 6f 72 69 65 73 20 69 74 20  e categories it 
9d80: 66 61 6c 6c 73 20 69 6e 74 6f 3a 0a 20 20 20 20  falls into:.    
9d90: 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 20 20    **.      **   
9da0: 20 20 52 65 61 64 2d 6f 6e 6c 79 0a 20 20 20 20    Read-only.    
9db0: 20 20 2a 2a 20 20 20 20 20 51 75 65 72 79 20 77    **     Query w
9dc0: 69 74 68 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f  ith statement jo
9dd0: 75 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a 20 20  urnal.      **  
9de0: 20 20 20 51 75 65 72 79 20 77 69 74 68 6f 75 74     Query without
9df0: 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e   statement journ
9e00: 61 6c 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20  al.      **.    
9e10: 20 20 2a 2a 20 57 65 20 63 6f 75 6c 64 20 64 6f    ** We could do
9e20: 20 73 6f 6d 65 74 68 69 6e 67 20 6d 6f 72 65 20   something more 
9e30: 65 6c 65 67 61 6e 74 20 74 68 61 6e 20 74 68 69  elegant than thi
9e40: 73 20 73 74 61 74 69 63 20 61 6e 61 6c 79 73 69  s static analysi
9e50: 73 20 28 69 2e 65 2e 0a 20 20 20 20 20 20 2a 2a  s (i.e..      **
9e60: 20 73 74 6f 72 65 20 74 68 65 20 74 79 70 65 20   store the type 
9e70: 6f 66 20 71 75 65 72 79 20 61 73 20 70 61 72 74  of query as part
9e80: 20 6f 66 20 74 68 65 20 63 6f 6d 70 6c 69 61 74   of the compliat
9e90: 69 6f 6e 20 70 68 61 73 65 29 2c 20 62 75 74 20  ion phase), but 
9ea0: 0a 20 20 20 20 20 20 2a 2a 20 68 61 6e 64 6c 69  .      ** handli
9eb0: 6e 67 20 6d 61 6c 6c 6f 63 28 29 20 6f 72 20 49  ng malloc() or I
9ec0: 4f 20 66 61 69 6c 75 72 65 20 69 73 20 61 20 66  O failure is a f
9ed0: 61 69 72 6c 79 20 6f 62 73 63 75 72 65 20 65 64  airly obscure ed
9ee0: 67 65 20 63 61 73 65 20 73 6f 20 0a 20 20 20 20  ge case so .    
9ef0: 20 20 2a 2a 20 74 68 69 73 20 69 73 20 70 72 6f    ** this is pro
9f00: 62 61 62 6c 79 20 65 61 73 69 65 72 2e 20 54 6f  bably easier. To
9f10: 64 6f 3a 20 4d 69 67 68 74 20 62 65 20 61 6e 20  do: Might be an 
9f20: 6f 70 70 6f 72 74 75 6e 69 74 79 20 74 6f 20 72  opportunity to r
9f30: 65 64 75 63 65 20 0a 20 20 20 20 20 20 2a 2a 20  educe .      ** 
9f40: 63 6f 64 65 20 73 69 7a 65 20 61 20 76 65 72 79  code size a very
9f50: 20 73 6d 61 6c 6c 20 61 6d 6f 75 6e 74 20 74 68   small amount th
9f60: 6f 75 67 68 2e 2e 2e 0a 20 20 20 20 20 20 2a 2f  ough....      */
9f70: 0a 20 20 20 20 20 20 69 6e 74 20 69 73 52 65 61  .      int isRea
9f80: 64 4f 6e 6c 79 20 3d 20 31 3b 0a 20 20 20 20 20  dOnly = 1;.     
9f90: 20 69 6e 74 20 69 73 53 74 61 74 65 6d 65 6e 74   int isStatement
9fa0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65   = 0;.      asse
9fb0: 72 74 28 70 2d 3e 61 4f 70 20 7c 7c 20 70 2d 3e  rt(p->aOp || p->
9fc0: 6e 4f 70 3d 3d 30 29 3b 0a 20 20 20 20 20 20 66  nOp==0);.      f
9fd0: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70  or(i=0; i<p->nOp
9fe0: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 20  ; i++){ .       
9ff0: 20 73 77 69 74 63 68 28 20 70 2d 3e 61 4f 70 5b   switch( p->aOp[
a000: 69 5d 2e 6f 70 63 6f 64 65 20 29 7b 0a 20 20 20  i].opcode ){.   
a010: 20 20 20 20 20 20 20 63 61 73 65 20 4f 50 5f 54         case OP_T
a020: 72 61 6e 73 61 63 74 69 6f 6e 3a 0a 20 20 20 20  ransaction:.    
a030: 20 20 20 20 20 20 20 20 69 73 52 65 61 64 4f 6e          isReadOn
a040: 6c 79 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20  ly = 0;.        
a050: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
a060: 20 20 20 20 20 63 61 73 65 20 4f 50 5f 53 74 61       case OP_Sta
a070: 74 65 6d 65 6e 74 3a 0a 20 20 20 20 20 20 20 20  tement:.        
a080: 20 20 20 20 69 73 53 74 61 74 65 6d 65 6e 74 20      isStatement 
a090: 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20 20 20  = 1;.           
a0a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
a0b0: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 0a 20 20 20  }.      }.  .   
a0c0: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 71 75 65     /* If the que
a0d0: 72 79 20 77 61 73 20 72 65 61 64 2d 6f 6e 6c 79  ry was read-only
a0e0: 2c 20 77 65 20 6e 65 65 64 20 64 6f 20 6e 6f 20  , we need do no 
a0f0: 72 6f 6c 6c 62 61 63 6b 20 61 74 20 61 6c 6c 2e  rollback at all.
a100: 20 4f 74 68 65 72 77 69 73 65 2c 0a 20 20 20 20   Otherwise,.    
a110: 20 20 2a 2a 20 70 72 6f 63 65 65 64 20 77 69 74    ** proceed wit
a120: 68 20 74 68 65 20 73 70 65 63 69 61 6c 20 68 61  h the special ha
a130: 6e 64 6c 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2f  ndling..      */
a140: 0a 20 20 20 20 20 20 69 66 28 20 21 69 73 52 65  .      if( !isRe
a150: 61 64 4f 6e 6c 79 20 29 7b 0a 20 20 20 20 20 20  adOnly ){.      
a160: 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c    if( p->rc==SQL
a170: 49 54 45 5f 4e 4f 4d 45 4d 20 26 26 20 69 73 53  ITE_NOMEM && isS
a180: 74 61 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20 20  tatement ){.    
a190: 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71        xFunc = sq
a1a0: 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61  lite3BtreeRollba
a1b0: 63 6b 53 74 6d 74 3b 0a 20 20 20 20 20 20 20 20  ckStmt;.        
a1c0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20  }else{.         
a1d0: 20 2f 2a 20 57 65 20 61 72 65 20 66 6f 72 63 65   /* We are force
a1e0: 64 20 74 6f 20 72 6f 6c 6c 20 62 61 63 6b 20 74  d to roll back t
a1f0: 68 65 20 61 63 74 69 76 65 20 74 72 61 6e 73 61  he active transa
a200: 63 74 69 6f 6e 2e 20 42 65 66 6f 72 65 20 64 6f  ction. Before do
a210: 69 6e 67 0a 20 20 20 20 20 20 20 20 20 20 2a 2a  ing.          **
a220: 20 73 6f 2c 20 61 62 6f 72 74 20 61 6e 79 20 6f   so, abort any o
a230: 74 68 65 72 20 73 74 61 74 65 6d 65 6e 74 73 20  ther statements 
a240: 74 68 69 73 20 68 61 6e 64 6c 65 20 63 75 72 72  this handle curr
a250: 65 6e 74 6c 79 20 68 61 73 20 61 63 74 69 76 65  ently has active
a260: 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20  ..          */. 
a270: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
a280: 41 62 6f 72 74 4f 74 68 65 72 41 63 74 69 76 65  AbortOtherActive
a290: 56 64 62 65 73 28 64 62 2c 20 70 29 3b 0a 20 20  Vdbes(db, p);.  
a2a0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 52          sqlite3R
a2b0: 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a  ollbackAll(db);.
a2c0: 20 20 20 20 20 20 20 20 20 20 64 62 2d 3e 61 75            db->au
a2d0: 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20  toCommit = 1;.  
a2e0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
a2f0: 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20      }.  .    /* 
a300: 49 66 20 74 68 65 20 61 75 74 6f 2d 63 6f 6d 6d  If the auto-comm
a310: 69 74 20 66 6c 61 67 20 69 73 20 73 65 74 20 61  it flag is set a
a320: 6e 64 20 74 68 69 73 20 69 73 20 74 68 65 20 6f  nd this is the o
a330: 6e 6c 79 20 61 63 74 69 76 65 20 76 64 62 65 2c  nly active vdbe,
a340: 20 74 68 65 6e 0a 20 20 20 20 2a 2a 20 77 65 20   then.    ** we 
a350: 64 6f 20 65 69 74 68 65 72 20 61 20 63 6f 6d 6d  do either a comm
a360: 69 74 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 6f  it or rollback o
a370: 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72  f the current tr
a380: 61 6e 73 61 63 74 69 6f 6e 2e 20 0a 20 20 20 20  ansaction. .    
a390: 2a 2a 0a 20 20 20 20 2a 2a 20 4e 6f 74 65 3a 20  **.    ** Note: 
a3a0: 54 68 69 73 20 62 6c 6f 63 6b 20 61 6c 73 6f 20  This block also 
a3b0: 72 75 6e 73 20 69 66 20 6f 6e 65 20 6f 66 20 74  runs if one of t
a3c0: 68 65 20 73 70 65 63 69 61 6c 20 65 72 72 6f 72  he special error
a3d0: 73 20 68 61 6e 64 6c 65 64 20 0a 20 20 20 20 2a  s handled .    *
a3e0: 2a 20 61 62 6f 76 65 20 68 61 73 20 6f 63 63 75  * above has occu
a3f0: 72 65 64 2e 20 0a 20 20 20 20 2a 2f 0a 20 20 20  red. .    */.   
a400: 20 69 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d   if( db->autoCom
a410: 6d 69 74 20 26 26 20 64 62 2d 3e 61 63 74 69 76  mit && db->activ
a420: 65 56 64 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20  eVdbeCnt==1 ){. 
a430: 20 20 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d       if( p->rc==
a440: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 70 2d  SQLITE_OK || (p-
a450: 3e 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45  >errorAction==OE
a460: 5f 46 61 69 6c 20 26 26 20 21 69 73 53 70 65 63  _Fail && !isSpec
a470: 69 61 6c 45 72 72 6f 72 29 20 29 7b 0a 09 2f 2a  ialError) ){../*
a480: 20 54 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74   The auto-commit
a490: 20 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20 61   flag is true, a
a4a0: 6e 64 20 74 68 65 20 76 64 62 65 20 70 72 6f 67  nd the vdbe prog
a4b0: 72 61 6d 20 77 61 73 20 0a 20 20 20 20 20 20 20  ram was .       
a4c0: 20 2a 2a 20 73 75 63 63 65 73 73 66 75 6c 20 6f   ** successful o
a4d0: 72 20 68 69 74 20 61 6e 20 27 4f 52 20 46 41 49  r hit an 'OR FAI
a4e0: 4c 27 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20 54  L' constraint. T
a4f0: 68 69 73 20 6d 65 61 6e 73 20 61 20 63 6f 6d 6d  his means a comm
a500: 69 74 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 69  it .        ** i
a510: 73 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20  s required..    
a520: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69      */.        i
a530: 6e 74 20 72 63 20 3d 20 76 64 62 65 43 6f 6d 6d  nt rc = vdbeComm
a540: 69 74 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20  it(db);.        
a550: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42  if( rc==SQLITE_B
a560: 55 53 59 20 29 7b 0a 20 20 20 20 20 20 20 20 20  USY ){.         
a570: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42   return SQLITE_B
a580: 55 53 59 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c  USY;.        }el
a590: 73 65 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54  se if( rc!=SQLIT
a5a0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20  E_OK ){.        
a5b0: 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20    p->rc = rc;.  
a5c0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 52          sqlite3R
a5d0: 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a  ollbackAll(db);.
a5e0: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
a5f0: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
a600: 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68  CommitInternalCh
a610: 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 20 20 20  anges(db);.     
a620: 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65     }.      }else
a630: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
a640: 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29  3RollbackAll(db)
a650: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65  ;.      }.    }e
a660: 6c 73 65 20 69 66 28 20 21 78 46 75 6e 63 20 29  lse if( !xFunc )
a670: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e 72  {.      if( p->r
a680: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c==SQLITE_OK || 
a690: 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d  p->errorAction==
a6a0: 4f 45 5f 46 61 69 6c 20 29 7b 0a 20 20 20 20 20  OE_Fail ){.     
a6b0: 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69 74     xFunc = sqlit
a6c0: 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53 74 6d  e3BtreeCommitStm
a6d0: 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69  t;.      }else i
a6e0: 66 28 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f  f( p->errorActio
a6f0: 6e 3d 3d 4f 45 5f 41 62 6f 72 74 20 29 7b 0a 20  n==OE_Abort ){. 
a700: 20 20 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73         xFunc = s
a710: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62  qlite3BtreeRollb
a720: 61 63 6b 53 74 6d 74 3b 0a 20 20 20 20 20 20 7d  ackStmt;.      }
a730: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71  else{.        sq
a740: 6c 69 74 65 33 41 62 6f 72 74 4f 74 68 65 72 41  lite3AbortOtherA
a750: 63 74 69 76 65 56 64 62 65 73 28 64 62 2c 20 70  ctiveVdbes(db, p
a760: 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  );.        sqlit
a770: 65 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62  e3RollbackAll(db
a780: 29 3b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61  );.        db->a
a790: 75 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20  utoCommit = 1;. 
a7a0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a       }.    }.  .
a7b0: 20 20 20 20 2f 2a 20 49 66 20 78 46 75 6e 63 20      /* If xFunc 
a7c0: 69 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65  is not NULL, the
a7d0: 6e 20 69 74 20 69 73 20 6f 6e 65 20 6f 66 20 73  n it is one of s
a7e0: 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62  qlite3BtreeRollb
a7f0: 61 63 6b 53 74 6d 74 20 6f 72 0a 20 20 20 20 2a  ackStmt or.    *
a800: 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f  * sqlite3BtreeCo
a810: 6d 6d 69 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69  mmitStmt. Call i
a820: 74 20 6f 6e 63 65 20 6f 6e 20 65 61 63 68 20 62  t once on each b
a830: 61 63 6b 65 6e 64 2e 20 49 66 20 61 6e 20 65 72  ackend. If an er
a840: 72 6f 72 20 6f 63 63 75 72 73 0a 20 20 20 20 2a  ror occurs.    *
a850: 2a 20 61 6e 64 20 74 68 65 20 72 65 74 75 72 6e  * and the return
a860: 20 63 6f 64 65 20 69 73 20 73 74 69 6c 6c 20 53   code is still S
a870: 51 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20 74 68  QLITE_OK, set th
a880: 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 74 6f  e return code to
a890: 20 74 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20   the new.    ** 
a8a0: 65 72 72 6f 72 20 76 61 6c 75 65 2e 0a 20 20 20  error value..   
a8b0: 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 21   */.    assert(!
a8c0: 78 46 75 6e 63 20 7c 7c 0a 20 20 20 20 20 20 78  xFunc ||.      x
a8d0: 46 75 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74 72  Func==sqlite3Btr
a8e0: 65 65 43 6f 6d 6d 69 74 53 74 6d 74 20 7c 7c 0a  eeCommitStmt ||.
a8f0: 20 20 20 20 20 20 78 46 75 6e 63 3d 3d 73 71 6c        xFunc==sql
a900: 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63  ite3BtreeRollbac
a910: 6b 53 74 6d 74 0a 20 20 20 20 29 3b 0a 20 20 20  kStmt.    );.   
a920: 20 66 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63 20   for(i=0; xFunc 
a930: 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  && i<db->nDb; i+
a940: 2b 29 7b 20 0a 20 20 20 20 20 20 69 6e 74 20 72  +){ .      int r
a950: 63 3b 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a  c;.      Btree *
a960: 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d  pBt = db->aDb[i]
a970: 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20  .pBt;.      if( 
a980: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 72  pBt ){.        r
a990: 63 20 3d 20 78 46 75 6e 63 28 70 42 74 29 3b 0a  c = xFunc(pBt);.
a9a0: 20 20 20 20 20 20 20 20 69 66 28 20 72 63 20 26          if( rc &
a9b0: 26 20 28 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  & (p->rc==SQLITE
a9c0: 5f 4f 4b 20 7c 7c 20 70 2d 3e 72 63 3d 3d 53 51  _OK || p->rc==SQ
a9d0: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 29  LITE_CONSTRAINT)
a9e0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 2d   ){.          p-
a9f0: 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20  >rc = rc;.      
aa00: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
aa10: 72 69 6e 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67  ring(&p->zErrMsg
aa20: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a  , 0);.        }.
aa30: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
aa40: 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20  .    /* If this 
aa50: 77 61 73 20 61 6e 20 49 4e 53 45 52 54 2c 20 55  was an INSERT, U
aa60: 50 44 41 54 45 20 6f 72 20 44 45 4c 45 54 45 20  PDATE or DELETE 
aa70: 61 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e  and the statemen
aa80: 74 20 77 61 73 20 63 6f 6d 6d 69 74 74 65 64 2c  t was committed,
aa90: 20 0a 20 20 20 20 2a 2a 20 73 65 74 20 74 68 65   .    ** set the
aaa0: 20 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e   change counter.
aab0: 20 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28   .    */.    if(
aac0: 20 70 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e 20   p->changeCntOn 
aad0: 26 26 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20  && p->pc>=0 ){. 
aae0: 20 20 20 20 20 69 66 28 20 21 78 46 75 6e 63 20       if( !xFunc 
aaf0: 7c 7c 20 78 46 75 6e 63 3d 3d 73 71 6c 69 74 65  || xFunc==sqlite
ab00: 33 42 74 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74  3BtreeCommitStmt
ab10: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69   ){.        sqli
ab20: 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67 65  te3VdbeSetChange
ab30: 73 28 64 62 2c 20 70 2d 3e 6e 43 68 61 6e 67 65  s(db, p->nChange
ab40: 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  );.      }else{.
ab50: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
ab60: 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 64 62  dbeSetChanges(db
ab70: 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  , 0);.      }.  
ab80: 20 20 20 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d      p->nChange =
ab90: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20   0;.    }.  .   
aba0: 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b 20 6f 72 20   /* Rollback or 
abb0: 63 6f 6d 6d 69 74 20 61 6e 79 20 73 63 68 65 6d  commit any schem
abc0: 61 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 6f  a changes that o
abd0: 63 63 75 72 72 65 64 2e 20 2a 2f 0a 20 20 20 20  ccurred. */.    
abe0: 69 66 28 20 70 2d 3e 72 63 21 3d 53 51 4c 49 54  if( p->rc!=SQLIT
abf0: 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 66 6c 61 67  E_OK && db->flag
ac00: 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43  s&SQLITE_InternC
ac10: 68 61 6e 67 65 73 20 29 7b 0a 20 20 20 20 20 20  hanges ){.      
ac20: 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65  sqlite3ResetInte
ac30: 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30  rnalSchema(db, 0
ac40: 29 3b 0a 20 20 20 20 20 20 64 62 2d 3e 66 6c 61  );.      db->fla
ac50: 67 73 20 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20  gs = (db->flags 
ac60: 7c 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43  | SQLITE_InternC
ac70: 68 61 6e 67 65 73 29 3b 0a 20 20 20 20 7d 0a 20  hanges);.    }. 
ac80: 20 7d 0a 0a 20 20 2f 2a 20 57 65 20 68 61 76 65   }..  /* We have
ac90: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 68 61   successfully ha
aca0: 6c 74 65 64 20 61 6e 64 20 63 6c 6f 73 65 64 20  lted and closed 
acb0: 74 68 65 20 56 4d 2e 20 20 52 65 63 6f 72 64 20  the VM.  Record 
acc0: 74 68 69 73 20 66 61 63 74 2e 20 2a 2f 0a 20 20  this fact. */.  
acd0: 69 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a  if( p->pc>=0 ){.
ace0: 20 20 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64      db->activeVd
acf0: 62 65 43 6e 74 2d 2d 3b 0a 20 20 7d 0a 20 20 70  beCnt--;.  }.  p
ad00: 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d  ->magic = VDBE_M
ad10: 41 47 49 43 5f 48 41 4c 54 3b 0a 20 20 63 68 65  AGIC_HALT;.  che
ad20: 63 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28  ckActiveVdbeCnt(
ad30: 64 62 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 53  db);..  return S
ad40: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
ad50: 2a 2a 20 45 61 63 68 20 56 44 42 45 20 68 6f 6c  ** Each VDBE hol
ad60: 64 73 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  ds the result of
ad70: 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74   the most recent
ad80: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 20   sqlite3_step() 
ad90: 63 61 6c 6c 0a 2a 2a 20 69 6e 20 70 2d 3e 72 63  call.** in p->rc
ada0: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  .  This routine 
adb0: 73 65 74 73 20 74 68 61 74 20 72 65 73 75 6c 74  sets that result
adc0: 20 62 61 63 6b 20 74 6f 20 53 51 4c 49 54 45 5f   back to SQLITE_
add0: 4f 4b 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  OK..*/.void sqli
ade0: 74 65 33 56 64 62 65 52 65 73 65 74 53 74 65 70  te3VdbeResetStep
adf0: 52 65 73 75 6c 74 28 56 64 62 65 20 2a 70 29 7b  Result(Vdbe *p){
ae00: 0a 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54  .  p->rc = SQLIT
ae10: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43  E_OK;.}../*.** C
ae20: 6c 65 61 6e 20 75 70 20 61 20 56 44 42 45 20 61  lean up a VDBE a
ae30: 66 74 65 72 20 65 78 65 63 75 74 69 6f 6e 20 62  fter execution b
ae40: 75 74 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65  ut do not delete
ae50: 20 74 68 65 20 56 44 42 45 20 6a 75 73 74 20 79   the VDBE just y
ae60: 65 74 2e 0a 2a 2a 20 57 72 69 74 65 20 61 6e 79  et..** Write any
ae70: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20   error messages 
ae80: 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 20  into *pzErrMsg. 
ae90: 20 52 65 74 75 72 6e 20 74 68 65 20 72 65 73 75   Return the resu
aea0: 6c 74 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41  lt code..**.** A
aeb0: 66 74 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e  fter this routin
aec0: 65 20 69 73 20 72 75 6e 2c 20 74 68 65 20 56 44  e is run, the VD
aed0: 42 45 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61  BE should be rea
aee0: 64 79 20 74 6f 20 62 65 20 65 78 65 63 75 74 65  dy to be execute
aef0: 64 0a 2a 2a 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a  d.** again..**.*
af00: 2a 20 54 6f 20 6c 6f 6f 6b 20 61 74 20 69 74 20  * To look at it 
af10: 61 6e 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69  another way, thi
af20: 73 20 72 6f 75 74 69 6e 65 20 72 65 73 65 74 73  s routine resets
af30: 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 74 68   the state of th
af40: 65 0a 2a 2a 20 76 69 72 74 75 61 6c 20 6d 61 63  e.** virtual mac
af50: 68 69 6e 65 20 66 72 6f 6d 20 56 44 42 45 5f 4d  hine from VDBE_M
af60: 41 47 49 43 5f 52 55 4e 20 6f 72 20 56 44 42 45  AGIC_RUN or VDBE
af70: 5f 4d 41 47 49 43 5f 48 41 4c 54 20 62 61 63 6b  _MAGIC_HALT back
af80: 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49   to.** VDBE_MAGI
af90: 43 5f 49 4e 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73  C_INIT..*/.int s
afa0: 71 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28  qlite3VdbeReset(
afb0: 56 64 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69  Vdbe *p){.  sqli
afc0: 74 65 33 20 2a 64 62 3b 0a 20 20 64 62 20 3d 20  te3 *db;.  db = 
afd0: 70 2d 3e 64 62 3b 0a 0a 20 20 2f 2a 20 49 66 20  p->db;..  /* If 
afe0: 74 68 65 20 56 4d 20 64 69 64 20 6e 6f 74 20 72  the VM did not r
aff0: 75 6e 20 74 6f 20 63 6f 6d 70 6c 65 74 69 6f 6e  un to completion
b000: 20 6f 72 20 69 66 20 69 74 20 65 6e 63 6f 75 6e   or if it encoun
b010: 74 65 72 65 64 20 61 6e 0a 20 20 2a 2a 20 65 72  tered an.  ** er
b020: 72 6f 72 2c 20 74 68 65 6e 20 69 74 20 6d 69 67  ror, then it mig
b030: 68 74 20 6e 6f 74 20 68 61 76 65 20 62 65 65 6e  ht not have been
b040: 20 68 61 6c 74 65 64 20 70 72 6f 70 65 72 6c 79   halted properly
b050: 2e 20 20 53 6f 20 68 61 6c 74 0a 20 20 2a 2a 20  .  So halt.  ** 
b060: 69 74 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 73  it now..  */.  s
b070: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64  qlite3SafetyOn(d
b080: 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  b);.  sqlite3Vdb
b090: 65 48 61 6c 74 28 70 29 3b 0a 20 20 73 71 6c 69  eHalt(p);.  sqli
b0a0: 74 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29  te3SafetyOff(db)
b0b0: 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 56  ;..  /* If the V
b0c0: 44 42 45 20 68 61 73 20 62 65 20 72 75 6e 20 65  DBE has be run e
b0d0: 76 65 6e 20 70 61 72 74 69 61 6c 6c 79 2c 20 74  ven partially, t
b0e0: 68 65 6e 20 74 72 61 6e 73 66 65 72 20 74 68 65  hen transfer the
b0f0: 20 65 72 72 6f 72 20 63 6f 64 65 0a 20 20 2a 2a   error code.  **
b100: 20 61 6e 64 20 65 72 72 6f 72 20 6d 65 73 73 61   and error messa
b110: 67 65 20 66 72 6f 6d 20 74 68 65 20 56 44 42 45  ge from the VDBE
b120: 20 69 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 64   into the main d
b130: 61 74 61 62 61 73 65 20 73 74 72 75 63 74 75 72  atabase structur
b140: 65 2e 20 20 42 75 74 0a 20 20 2a 2a 20 69 66 20  e.  But.  ** if 
b150: 74 68 65 20 56 44 42 45 20 68 61 73 20 6a 75 73  the VDBE has jus
b160: 74 20 62 65 65 6e 20 73 65 74 20 74 6f 20 72 75  t been set to ru
b170: 6e 20 62 75 74 20 68 61 73 20 6e 6f 74 20 61 63  n but has not ac
b180: 74 75 61 6c 6c 79 20 65 78 65 63 75 74 65 64 20  tually executed 
b190: 61 6e 79 0a 20 20 2a 2a 20 69 6e 73 74 72 75 63  any.  ** instruc
b1a0: 74 69 6f 6e 73 20 79 65 74 2c 20 6c 65 61 76 65  tions yet, leave
b1b0: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61   the main databa
b1c0: 73 65 20 65 72 72 6f 72 20 69 6e 66 6f 72 6d 61  se error informa
b1d0: 74 69 6f 6e 20 75 6e 63 68 61 6e 67 65 64 2e 0a  tion unchanged..
b1e0: 20 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63    */.  if( p->pc
b1f0: 3e 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70  >=0 ){.    if( p
b200: 2d 3e 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20  ->zErrMsg ){.   
b210: 20 20 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53     sqlite3ValueS
b220: 65 74 53 74 72 28 64 62 2d 3e 70 45 72 72 2c 20  etStr(db->pErr, 
b230: 2d 31 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 2c 20  -1, p->zErrMsg, 
b240: 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 73 71 6c  SQLITE_UTF8, sql
b250: 69 74 65 33 46 72 65 65 58 29 3b 0a 20 20 20 20  ite3FreeX);.    
b260: 20 20 64 62 2d 3e 65 72 72 43 6f 64 65 20 3d 20    db->errCode = 
b270: 70 2d 3e 72 63 3b 0a 20 20 20 20 20 20 70 2d 3e  p->rc;.      p->
b280: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20  zErrMsg = 0;.   
b290: 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 72 63   }else if( p->rc
b2a0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
b2b0: 33 45 72 72 6f 72 28 64 62 2c 20 70 2d 3e 72 63  3Error(db, p->rc
b2c0: 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  , 0);.    }else{
b2d0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72  .      sqlite3Er
b2e0: 72 6f 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f  ror(db, SQLITE_O
b2f0: 4b 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  K, 0);.    }.  }
b300: 65 6c 73 65 20 69 66 28 20 70 2d 3e 72 63 20 26  else if( p->rc &
b310: 26 20 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a  & p->expired ){.
b320: 20 20 20 20 2f 2a 20 54 68 65 20 65 78 70 69 72      /* The expir
b330: 65 64 20 66 6c 61 67 20 77 61 73 20 73 65 74 20  ed flag was set 
b340: 6f 6e 20 74 68 65 20 56 44 42 45 20 62 65 66 6f  on the VDBE befo
b350: 72 65 20 74 68 65 20 66 69 72 73 74 20 63 61 6c  re the first cal
b360: 6c 0a 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69  l.    ** to sqli
b370: 74 65 33 5f 73 74 65 70 28 29 2e 20 46 6f 72 20  te3_step(). For 
b380: 63 6f 6e 73 69 73 74 65 6e 63 79 20 28 73 69 6e  consistency (sin
b390: 63 65 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28  ce sqlite3_step(
b3a0: 29 20 77 61 73 0a 20 20 20 20 2a 2a 20 63 61 6c  ) was.    ** cal
b3b0: 6c 65 64 29 2c 20 73 65 74 20 74 68 65 20 64 61  led), set the da
b3c0: 74 61 62 61 73 65 20 65 72 72 6f 72 20 69 6e 20  tabase error in 
b3d0: 74 68 69 73 20 63 61 73 65 20 61 73 20 77 65 6c  this case as wel
b3e0: 6c 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 73 71  l..    */.    sq
b3f0: 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20 70  lite3Error(db, p
b400: 2d 3e 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20  ->rc, 0);.  }.. 
b410: 20 2f 2a 20 52 65 63 6c 61 69 6d 20 61 6c 6c 20   /* Reclaim all 
b420: 6d 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 74  memory used by t
b430: 68 65 20 56 44 42 45 0a 20 20 2a 2f 0a 20 20 43  he VDBE.  */.  C
b440: 6c 65 61 6e 75 70 28 70 29 3b 0a 0a 20 20 2f 2a  leanup(p);..  /*
b450: 20 53 61 76 65 20 70 72 6f 66 69 6c 69 6e 67 20   Save profiling 
b460: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d  information from
b470: 20 74 68 69 73 20 56 44 42 45 20 72 75 6e 2e 0a   this VDBE run..
b480: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70    */.  assert( p
b490: 2d 3e 70 54 6f 73 3c 26 70 2d 3e 61 53 74 61 63  ->pTos<&p->aStac
b4a0: 6b 5b 70 2d 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70  k[p->pc<0?0:p->p
b4b0: 63 5d 20 7c 7c 20 21 70 2d 3e 61 53 74 61 63 6b  c] || !p->aStack
b4c0: 20 29 3b 0a 23 69 66 64 65 66 20 56 44 42 45 5f   );.#ifdef VDBE_
b4d0: 50 52 4f 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20  PROFILE.  {.    
b4e0: 46 49 4c 45 20 2a 6f 75 74 20 3d 20 66 6f 70 65  FILE *out = fope
b4f0: 6e 28 22 76 64 62 65 5f 70 72 6f 66 69 6c 65 2e  n("vdbe_profile.
b500: 6f 75 74 22 2c 20 22 61 22 29 3b 0a 20 20 20 20  out", "a");.    
b510: 69 66 28 20 6f 75 74 20 29 7b 0a 20 20 20 20 20  if( out ){.     
b520: 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 66 70   int i;.      fp
b530: 72 69 6e 74 66 28 6f 75 74 2c 20 22 2d 2d 2d 2d  rintf(out, "----
b540: 20 22 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69   ");.      for(i
b550: 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b  =0; i<p->nOp; i+
b560: 2b 29 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69  +){.        fpri
b570: 6e 74 66 28 6f 75 74 2c 20 22 25 30 32 78 22 2c  ntf(out, "%02x",
b580: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64   p->aOp[i].opcod
b590: 65 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  e);.      }.    
b5a0: 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c 20 22    fprintf(out, "
b5b0: 5c 6e 22 29 3b 0a 20 20 20 20 20 20 66 6f 72 28  \n");.      for(
b5c0: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69  i=0; i<p->nOp; i
b5d0: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 66 70 72  ++){.        fpr
b5e0: 69 6e 74 66 28 6f 75 74 2c 20 22 25 36 64 20 25  intf(out, "%6d %
b5f0: 31 30 6c 6c 64 20 25 38 6c 6c 64 20 22 2c 0a 20  10lld %8lld ",. 
b600: 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70            p->aOp
b610: 5b 69 5d 2e 63 6e 74 2c 0a 20 20 20 20 20 20 20  [i].cnt,.       
b620: 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79      p->aOp[i].cy
b630: 63 6c 65 73 2c 0a 20 20 20 20 20 20 20 20 20 20  cles,.          
b640: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 3e 30   p->aOp[i].cnt>0
b650: 20 3f 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63   ? p->aOp[i].cyc
b660: 6c 65 73 2f 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e  les/p->aOp[i].cn
b670: 74 20 3a 20 30 0a 20 20 20 20 20 20 20 20 29 3b  t : 0.        );
b680: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
b690: 56 64 62 65 50 72 69 6e 74 4f 70 28 6f 75 74 2c  VdbePrintOp(out,
b6a0: 20 69 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b   i, &p->aOp[i]);
b6b0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66  .      }.      f
b6c0: 63 6c 6f 73 65 28 6f 75 74 29 3b 0a 20 20 20 20  close(out);.    
b6d0: 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70  }.  }.#endif.  p
b6e0: 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d  ->magic = VDBE_M
b6f0: 41 47 49 43 5f 49 4e 49 54 3b 0a 20 20 70 2d 3e  AGIC_INIT;.  p->
b700: 61 62 6f 72 74 65 64 20 3d 20 30 3b 0a 20 20 69  aborted = 0;.  i
b710: 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  f( p->rc==SQLITE
b720: 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20 20 20 73  _SCHEMA ){.    s
b730: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72  qlite3ResetInter
b740: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29  nalSchema(db, 0)
b750: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
b760: 2d 3e 72 63 20 26 20 64 62 2d 3e 65 72 72 4d 61  ->rc & db->errMa
b770: 73 6b 3b 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c  sk;.}. ./*.** Cl
b780: 65 61 6e 20 75 70 20 61 6e 64 20 64 65 6c 65 74  ean up and delet
b790: 65 20 61 20 56 44 42 45 20 61 66 74 65 72 20 65  e a VDBE after e
b7a0: 78 65 63 75 74 69 6f 6e 2e 20 20 52 65 74 75 72  xecution.  Retur
b7b0: 6e 20 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69  n an integer whi
b7c0: 63 68 20 69 73 0a 2a 2a 20 74 68 65 20 72 65 73  ch is.** the res
b7d0: 75 6c 74 20 63 6f 64 65 2e 20 20 57 72 69 74 65  ult code.  Write
b7e0: 20 61 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61   any error messa
b7f0: 67 65 20 74 65 78 74 20 69 6e 74 6f 20 2a 70 7a  ge text into *pz
b800: 45 72 72 4d 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73  ErrMsg..*/.int s
b810: 71 6c 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69  qlite3VdbeFinali
b820: 7a 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69  ze(Vdbe *p){.  i
b830: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
b840: 4b 3b 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69  K;.  if( p->magi
b850: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c==VDBE_MAGIC_RU
b860: 4e 20 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56  N || p->magic==V
b870: 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29  DBE_MAGIC_HALT )
b880: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
b890: 65 33 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a  e3VdbeReset(p);.
b8a0: 20 20 20 20 61 73 73 65 72 74 28 20 28 72 63 20      assert( (rc 
b8b0: 26 20 70 2d 3e 64 62 2d 3e 65 72 72 4d 61 73 6b  & p->db->errMask
b8c0: 29 3d 3d 72 63 20 29 3b 0a 20 20 7d 65 6c 73 65  )==rc );.  }else
b8d0: 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56   if( p->magic!=V
b8e0: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29  DBE_MAGIC_INIT )
b8f0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
b900: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a  ITE_MISUSE;.  }.
b910: 20 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c    sqlite3VdbeDel
b920: 65 74 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e  ete(p);.  return
b930: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61   rc;.}../*.** Ca
b940: 6c 6c 20 74 68 65 20 64 65 73 74 72 75 63 74 6f  ll the destructo
b950: 72 20 66 6f 72 20 65 61 63 68 20 61 75 78 64 61  r for each auxda
b960: 74 61 20 65 6e 74 72 79 20 69 6e 20 70 56 64 62  ta entry in pVdb
b970: 65 46 75 6e 63 20 66 6f 72 20 77 68 69 63 68 0a  eFunc for which.
b980: 2a 2a 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e  ** the correspon
b990: 64 69 6e 67 20 62 69 74 20 69 6e 20 6d 61 73 6b  ding bit in mask
b9a0: 20 69 73 20 63 6c 65 61 72 2e 20 20 41 75 78 64   is clear.  Auxd
b9b0: 61 74 61 20 65 6e 74 72 69 65 73 20 62 65 79 6f  ata entries beyo
b9c0: 6e 64 20 33 31 0a 2a 2a 20 61 72 65 20 61 6c 77  nd 31.** are alw
b9d0: 61 79 73 20 64 65 73 74 72 6f 79 65 64 2e 20 20  ays destroyed.  
b9e0: 54 6f 20 64 65 73 74 72 6f 79 20 61 6c 6c 20 61  To destroy all a
b9f0: 75 78 64 61 74 61 20 65 6e 74 72 69 65 73 2c 20  uxdata entries, 
ba00: 63 61 6c 6c 20 74 68 69 73 0a 2a 2a 20 72 6f 75  call this.** rou
ba10: 74 69 6e 65 20 77 69 74 68 20 6d 61 73 6b 3d 3d  tine with mask==
ba20: 30 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  0..*/.void sqlit
ba30: 65 33 56 64 62 65 44 65 6c 65 74 65 41 75 78 44  e3VdbeDeleteAuxD
ba40: 61 74 61 28 56 64 62 65 46 75 6e 63 20 2a 70 56  ata(VdbeFunc *pV
ba50: 64 62 65 46 75 6e 63 2c 20 69 6e 74 20 6d 61 73  dbeFunc, int mas
ba60: 6b 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66  k){.  int i;.  f
ba70: 6f 72 28 69 3d 30 3b 20 69 3c 70 56 64 62 65 46  or(i=0; i<pVdbeF
ba80: 75 6e 63 2d 3e 6e 41 75 78 3b 20 69 2b 2b 29 7b  unc->nAux; i++){
ba90: 0a 20 20 20 20 73 74 72 75 63 74 20 41 75 78 44  .    struct AuxD
baa0: 61 74 61 20 2a 70 41 75 78 20 3d 20 26 70 56 64  ata *pAux = &pVd
bab0: 62 65 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 5d  beFunc->apAux[i]
bac0: 3b 0a 20 20 20 20 69 66 28 20 28 69 3e 33 31 20  ;.    if( (i>31 
bad0: 7c 7c 20 21 28 6d 61 73 6b 26 28 31 3c 3c 69 29  || !(mask&(1<<i)
bae0: 29 29 20 26 26 20 70 41 75 78 2d 3e 70 41 75 78  )) && pAux->pAux
baf0: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 41   ){.      if( pA
bb00: 75 78 2d 3e 78 44 65 6c 65 74 65 20 29 7b 0a 20  ux->xDelete ){. 
bb10: 20 20 20 20 20 20 20 70 41 75 78 2d 3e 78 44 65         pAux->xDe
bb20: 6c 65 74 65 28 70 41 75 78 2d 3e 70 41 75 78 29  lete(pAux->pAux)
bb30: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
bb40: 70 41 75 78 2d 3e 70 41 75 78 20 3d 20 30 3b 0a  pAux->pAux = 0;.
bb50: 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a      }.  }.}../*.
bb60: 2a 2a 20 44 65 6c 65 74 65 20 61 6e 20 65 6e 74  ** Delete an ent
bb70: 69 72 65 20 56 44 42 45 2e 0a 2a 2f 0a 76 6f 69  ire VDBE..*/.voi
bb80: 64 20 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c  d sqlite3VdbeDel
bb90: 65 74 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20  ete(Vdbe *p){.  
bba0: 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 3d 3d  int i;.  if( p==
bbb0: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 43 6c  0 ) return;.  Cl
bbc0: 65 61 6e 75 70 28 70 29 3b 0a 20 20 69 66 28 20  eanup(p);.  if( 
bbd0: 70 2d 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20  p->pPrev ){.    
bbe0: 70 2d 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20  p->pPrev->pNext 
bbf0: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 65  = p->pNext;.  }e
bc00: 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28  lse{.    assert(
bc10: 20 70 2d 3e 64 62 2d 3e 70 56 64 62 65 3d 3d 70   p->db->pVdbe==p
bc20: 20 29 3b 0a 20 20 20 20 70 2d 3e 64 62 2d 3e 70   );.    p->db->p
bc30: 56 64 62 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b  Vdbe = p->pNext;
bc40: 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 70 4e  .  }.  if( p->pN
bc50: 65 78 74 20 29 7b 0a 20 20 20 20 70 2d 3e 70 4e  ext ){.    p->pN
bc60: 65 78 74 2d 3e 70 50 72 65 76 20 3d 20 70 2d 3e  ext->pPrev = p->
bc70: 70 50 72 65 76 3b 0a 20 20 7d 0a 20 20 69 66 28  pPrev;.  }.  if(
bc80: 20 70 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 66   p->aOp ){.    f
bc90: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70  or(i=0; i<p->nOp
bca0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 4f 70  ; i++){.      Op
bcb0: 20 2a 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b   *pOp = &p->aOp[
bcc0: 69 5d 3b 0a 20 20 20 20 20 20 66 72 65 65 50 33  i];.      freeP3
bcd0: 28 70 4f 70 2d 3e 70 33 74 79 70 65 2c 20 70 4f  (pOp->p3type, pO
bce0: 70 2d 3e 70 33 29 3b 0a 20 20 20 20 7d 0a 20 20  p->p3);.    }.  
bcf0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e    sqliteFree(p->
bd00: 61 4f 70 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65  aOp);.  }.  rele
bd10: 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61  aseMemArray(p->a
bd20: 56 61 72 2c 20 70 2d 3e 6e 56 61 72 29 3b 0a 20  Var, p->nVar);. 
bd30: 20 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61   sqliteFree(p->a
bd40: 4c 61 62 65 6c 29 3b 0a 20 20 73 71 6c 69 74 65  Label);.  sqlite
bd50: 46 72 65 65 28 70 2d 3e 61 53 74 61 63 6b 29 3b  Free(p->aStack);
bd60: 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72  .  releaseMemArr
bd70: 61 79 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 2c 20  ay(p->aColName, 
bd80: 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 2a 43 4f  p->nResColumn*CO
bd90: 4c 4e 41 4d 45 5f 4e 29 3b 0a 20 20 73 71 6c 69  LNAME_N);.  sqli
bda0: 74 65 46 72 65 65 28 70 2d 3e 61 43 6f 6c 4e 61  teFree(p->aColNa
bdb0: 6d 65 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65  me);.  sqliteFre
bdc0: 65 28 70 2d 3e 7a 53 71 6c 29 3b 0a 20 20 70 2d  e(p->zSql);.  p-
bdd0: 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41  >magic = VDBE_MA
bde0: 47 49 43 5f 44 45 41 44 3b 0a 20 20 73 71 6c 69  GIC_DEAD;.  sqli
bdf0: 74 65 46 72 65 65 28 70 29 3b 0a 7d 0a 0a 2f 2a  teFree(p);.}../*
be00: 0a 2a 2a 20 49 66 20 61 20 4d 6f 76 65 54 6f 20  .** If a MoveTo 
be10: 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 70 65 6e  operation is pen
be20: 64 69 6e 67 20 6f 6e 20 74 68 65 20 67 69 76 65  ding on the give
be30: 6e 20 63 75 72 73 6f 72 2c 20 74 68 65 6e 20 64  n cursor, then d
be40: 6f 20 74 68 61 74 0a 2a 2a 20 4d 6f 76 65 54 6f  o that.** MoveTo
be50: 20 6e 6f 77 2e 20 20 52 65 74 75 72 6e 20 61 6e   now.  Return an
be60: 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 20 49 66   error code.  If
be70: 20 6e 6f 20 4d 6f 76 65 54 6f 20 69 73 20 70 65   no MoveTo is pe
be80: 6e 64 69 6e 67 2c 20 74 68 69 73 0a 2a 2a 20 72  nding, this.** r
be90: 6f 75 74 69 6e 65 20 64 6f 65 73 20 6e 6f 74 68  outine does noth
bea0: 69 6e 67 20 61 6e 64 20 72 65 74 75 72 6e 73 20  ing and returns 
beb0: 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 69 6e  SQLITE_OK..*/.in
bec0: 74 20 73 71 6c 69 74 65 33 56 64 62 65 43 75 72  t sqlite3VdbeCur
bed0: 73 6f 72 4d 6f 76 65 74 6f 28 43 75 72 73 6f 72  sorMoveto(Cursor
bee0: 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e 64   *p){.  if( p->d
bef0: 65 66 65 72 72 65 64 4d 6f 76 65 74 6f 20 29 7b  eferredMoveto ){
bf00: 0a 20 20 20 20 69 6e 74 20 72 65 73 2c 20 72 63  .    int res, rc
bf10: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
bf20: 54 45 53 54 0a 20 20 20 20 65 78 74 65 72 6e 20  TEST.    extern 
bf30: 69 6e 74 20 73 71 6c 69 74 65 33 5f 73 65 61 72  int sqlite3_sear
bf40: 63 68 5f 63 6f 75 6e 74 3b 0a 23 65 6e 64 69 66  ch_count;.#endif
bf50: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e  .    assert( p->
bf60: 69 73 54 61 62 6c 65 20 29 3b 0a 20 20 20 20 72  isTable );.    r
bf70: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
bf80: 4d 6f 76 65 74 6f 28 70 2d 3e 70 43 75 72 73 6f  Moveto(p->pCurso
bf90: 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76 65 74 6f 54  r, 0, p->movetoT
bfa0: 61 72 67 65 74 2c 20 30 2c 20 26 72 65 73 29 3b  arget, 0, &res);
bfb0: 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 65  .    if( rc ) re
bfc0: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 2a 70 2d  turn rc;.    *p-
bfd0: 3e 70 49 6e 63 72 4b 65 79 20 3d 20 30 3b 0a 20  >pIncrKey = 0;. 
bfe0: 20 20 20 70 2d 3e 6c 61 73 74 52 6f 77 69 64 20     p->lastRowid 
bff0: 3d 20 6b 65 79 54 6f 49 6e 74 28 70 2d 3e 6d 6f  = keyToInt(p->mo
c000: 76 65 74 6f 54 61 72 67 65 74 29 3b 0a 20 20 20  vetoTarget);.   
c010: 20 70 2d 3e 72 6f 77 69 64 49 73 56 61 6c 69 64   p->rowidIsValid
c020: 20 3d 20 72 65 73 3d 3d 30 3b 0a 20 20 20 20 69   = res==0;.    i
c030: 66 28 20 72 65 73 3c 30 20 29 7b 0a 20 20 20 20  f( res<0 ){.    
c040: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74    rc = sqlite3Bt
c050: 72 65 65 4e 65 78 74 28 70 2d 3e 70 43 75 72 73  reeNext(p->pCurs
c060: 6f 72 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 20  or, &res);.     
c070: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e   if( rc ) return
c080: 20 72 63 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65   rc;.    }.#ifde
c090: 66 20 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20  f SQLITE_TEST.  
c0a0: 20 20 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68    sqlite3_search
c0b0: 5f 63 6f 75 6e 74 2b 2b 3b 0a 23 65 6e 64 69 66  _count++;.#endif
c0c0: 0a 20 20 20 20 70 2d 3e 64 65 66 65 72 72 65 64  .    p->deferred
c0d0: 4d 6f 76 65 74 6f 20 3d 20 30 3b 0a 20 20 20 20  Moveto = 0;.    
c0e0: 70 2d 3e 63 61 63 68 65 53 74 61 74 75 73 20 3d  p->cacheStatus =
c0f0: 20 43 41 43 48 45 5f 53 54 41 4c 45 3b 0a 20 20   CACHE_STALE;.  
c100: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54  }.  return SQLIT
c110: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  E_OK;.}../*.** T
c120: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e  he following fun
c130: 63 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71  ctions:.**.** sq
c140: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
c150: 79 70 65 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33  ype().** sqlite3
c160: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
c170: 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64  n().** sqlite3Vd
c180: 62 65 53 65 72 69 61 6c 52 65 61 64 28 29 0a 2a  beSerialRead().*
c190: 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  * sqlite3VdbeSer
c1a0: 69 61 6c 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69  ialLen().** sqli
c1b0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 57 72 69  te3VdbeSerialWri
c1c0: 74 65 28 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70  te().**.** encap
c1d0: 73 75 6c 61 74 65 20 74 68 65 20 63 6f 64 65 20  sulate the code 
c1e0: 74 68 61 74 20 73 65 72 69 61 6c 69 7a 65 73 20  that serializes 
c1f0: 76 61 6c 75 65 73 20 66 6f 72 20 73 74 6f 72 61  values for stora
c200: 67 65 20 69 6e 20 53 51 4c 69 74 65 0a 2a 2a 20  ge in SQLite.** 
c210: 64 61 74 61 20 61 6e 64 20 69 6e 64 65 78 20 72  data and index r
c220: 65 63 6f 72 64 73 2e 20 45 61 63 68 20 73 65 72  ecords. Each ser
c230: 69 61 6c 69 7a 65 64 20 76 61 6c 75 65 20 63 6f  ialized value co
c240: 6e 73 69 73 74 73 20 6f 66 20 61 0a 2a 2a 20 27  nsists of a.** '
c250: 73 65 72 69 61 6c 2d 74 79 70 65 27 20 61 6e 64  serial-type' and
c260: 20 61 20 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e   a blob of data.
c270: 20 54 68 65 20 73 65 72 69 61 6c 20 74 79 70 65   The serial type
c280: 20 69 73 20 61 6e 20 38 2d 62 79 74 65 20 75 6e   is an 8-byte un
c290: 73 69 67 6e 65 64 0a 2a 2a 20 69 6e 74 65 67 65  signed.** intege
c2a0: 72 2c 20 73 74 6f 72 65 64 20 61 73 20 61 20 76  r, stored as a v
c2b0: 61 72 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20  arint..**.** In 
c2c0: 61 6e 20 53 51 4c 69 74 65 20 69 6e 64 65 78 20  an SQLite index 
c2d0: 72 65 63 6f 72 64 2c 20 74 68 65 20 73 65 72 69  record, the seri
c2e0: 61 6c 20 74 79 70 65 20 69 73 20 73 74 6f 72 65  al type is store
c2f0: 64 20 64 69 72 65 63 74 6c 79 20 62 65 66 6f 72  d directly befor
c300: 65 0a 2a 2a 20 74 68 65 20 62 6c 6f 62 20 6f 66  e.** the blob of
c310: 20 64 61 74 61 20 74 68 61 74 20 69 74 20 63 6f   data that it co
c320: 72 72 65 73 70 6f 6e 64 73 20 74 6f 2e 20 49 6e  rresponds to. In
c330: 20 61 20 74 61 62 6c 65 20 72 65 63 6f 72 64 2c   a table record,
c340: 20 61 6c 6c 20 73 65 72 69 61 6c 0a 2a 2a 20 74   all serial.** t
c350: 79 70 65 73 20 61 72 65 20 73 74 6f 72 65 64 20  ypes are stored 
c360: 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66 20  at the start of 
c370: 74 68 65 20 72 65 63 6f 72 64 2c 20 61 6e 64 20  the record, and 
c380: 74 68 65 20 62 6c 6f 62 73 20 6f 66 20 64 61 74  the blobs of dat
c390: 61 20 61 74 0a 2a 2a 20 74 68 65 20 65 6e 64 2e  a at.** the end.
c3a0: 20 48 65 6e 63 65 20 74 68 65 73 65 20 66 75 6e   Hence these fun
c3b0: 63 74 69 6f 6e 73 20 61 6c 6c 6f 77 20 74 68 65  ctions allow the
c3c0: 20 63 61 6c 6c 65 72 20 74 6f 20 68 61 6e 64 6c   caller to handl
c3d0: 65 20 74 68 65 0a 2a 2a 20 73 65 72 69 61 6c 2d  e the.** serial-
c3e0: 74 79 70 65 20 61 6e 64 20 64 61 74 61 20 62 6c  type and data bl
c3f0: 6f 62 20 73 65 70 65 72 61 74 65 6c 79 2e 0a 2a  ob seperately..*
c400: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
c410: 6e 67 20 74 61 62 6c 65 20 64 65 73 63 72 69 62  ng table describ
c420: 65 73 20 74 68 65 20 76 61 72 69 6f 75 73 20 73  es the various s
c430: 74 6f 72 61 67 65 20 63 6c 61 73 73 65 73 20 66  torage classes f
c440: 6f 72 20 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20  or data:.**.**  
c450: 20 73 65 72 69 61 6c 20 74 79 70 65 20 20 20 20   serial type    
c460: 20 20 20 20 62 79 74 65 73 20 6f 66 20 64 61 74      bytes of dat
c470: 61 20 20 20 20 20 20 74 79 70 65 0a 2a 2a 20 20  a      type.**  
c480: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20   -------------- 
c490: 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d      ------------
c4a0: 2d 2d 2d 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  ---    ---------
c4b0: 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 30  ------.**      0
c4c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c4d0: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
c4e0: 20 20 4e 55 4c 4c 0a 2a 2a 20 20 20 20 20 20 31    NULL.**      1
c4f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c500: 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20 20       1          
c510: 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72    signed integer
c520: 0a 2a 2a 20 20 20 20 20 20 32 20 20 20 20 20 20  .**      2      
c530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 32                 2
c540: 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e              sign
c550: 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20  ed integer.**   
c560: 20 20 20 33 20 20 20 20 20 20 20 20 20 20 20 20     3            
c570: 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20 20           3      
c580: 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74        signed int
c590: 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 34 20 20  eger.**      4  
c5a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c5b0: 20 20 20 34 20 20 20 20 20 20 20 20 20 20 20 20     4            
c5c0: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a  signed integer.*
c5d0: 2a 20 20 20 20 20 20 35 20 20 20 20 20 20 20 20  *      5        
c5e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 36 20 20               6  
c5f0: 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64            signed
c600: 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20   integer.**     
c610: 20 36 20 20 20 20 20 20 20 20 20 20 20 20 20 20   6              
c620: 20 20 20 20 20 20 20 38 20 20 20 20 20 20 20 20         8        
c630: 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67      signed integ
c640: 65 72 0a 2a 2a 20 20 20 20 20 20 37 20 20 20 20  er.**      7    
c650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c660: 20 38 20 20 20 20 20 20 20 20 20 20 20 20 49 45   8            IE
c670: 45 45 20 66 6c 6f 61 74 0a 2a 2a 20 20 20 20 20  EE float.**     
c680: 20 38 20 20 20 20 20 20 20 20 20 20 20 20 20 20   8              
c690: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20         0        
c6a0: 20 20 20 20 49 6e 74 65 67 65 72 20 63 6f 6e 73      Integer cons
c6b0: 74 61 6e 74 20 30 0a 2a 2a 20 20 20 20 20 20 39  tant 0.**      9
c6c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c6d0: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
c6e0: 20 20 49 6e 74 65 67 65 72 20 63 6f 6e 73 74 61    Integer consta
c6f0: 6e 74 20 31 0a 2a 2a 20 20 20 20 20 31 30 2c 31  nt 1.**     10,1
c700: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1               
c710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c720: 72 65 73 65 72 76 65 64 20 66 6f 72 20 65 78 70  reserved for exp
c730: 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e 3d  ansion.**    N>=
c740: 31 32 20 61 6e 64 20 65 76 65 6e 20 20 20 20 20  12 and even     
c750: 20 20 28 4e 2d 31 32 29 2f 32 20 20 20 20 20 20    (N-12)/2      
c760: 20 20 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e 3d    BLOB.**    N>=
c770: 31 33 20 61 6e 64 20 6f 64 64 20 20 20 20 20 20  13 and odd      
c780: 20 20 28 4e 2d 31 33 29 2f 32 20 20 20 20 20 20    (N-13)/2      
c790: 20 20 74 65 78 74 0a 2a 2a 0a 2a 2a 20 54 68 65    text.**.** The
c7a0: 20 38 20 61 6e 64 20 39 20 74 79 70 65 73 20 77   8 and 9 types w
c7b0: 65 72 65 20 61 64 64 65 64 20 69 6e 20 33 2e 33  ere added in 3.3
c7c0: 2e 30 2c 20 66 69 6c 65 20 66 6f 72 6d 61 74 20  .0, file format 
c7d0: 34 2e 20 20 50 72 69 6f 72 20 76 65 72 73 69 6f  4.  Prior versio
c7e0: 6e 73 0a 2a 2a 20 6f 66 20 53 51 4c 69 74 65 20  ns.** of SQLite 
c7f0: 77 69 6c 6c 20 6e 6f 74 20 75 6e 64 65 72 73 74  will not underst
c800: 61 6e 64 20 74 68 6f 73 65 20 73 65 72 69 61 6c  and those serial
c810: 20 74 79 70 65 73 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a   types..*/../*.*
c820: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 65 72  * Return the ser
c830: 69 61 6c 2d 74 79 70 65 20 66 6f 72 20 74 68 65  ial-type for the
c840: 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e   value stored in
c850: 20 70 4d 65 6d 2e 0a 2a 2f 0a 75 33 32 20 73 71   pMem..*/.u32 sq
c860: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54  lite3VdbeSerialT
c870: 79 70 65 28 4d 65 6d 20 2a 70 4d 65 6d 2c 20 69  ype(Mem *pMem, i
c880: 6e 74 20 66 69 6c 65 5f 66 6f 72 6d 61 74 29 7b  nt file_format){
c890: 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 70  .  int flags = p
c8a0: 4d 65 6d 2d 3e 66 6c 61 67 73 3b 0a 20 20 69 6e  Mem->flags;.  in
c8b0: 74 20 6e 3b 0a 0a 20 20 69 66 28 20 66 6c 61 67  t n;..  if( flag
c8c0: 73 26 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20  s&MEM_Null ){.  
c8d0: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
c8e0: 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f    if( flags&MEM_
c8f0: 49 6e 74 20 29 7b 0a 20 20 20 20 2f 2a 20 46 69  Int ){.    /* Fi
c900: 67 75 72 65 20 6f 75 74 20 77 68 65 74 68 65 72  gure out whether
c910: 20 74 6f 20 75 73 65 20 31 2c 20 32 2c 20 34 2c   to use 1, 2, 4,
c920: 20 36 20 6f 72 20 38 20 62 79 74 65 73 2e 20 2a   6 or 8 bytes. *
c930: 2f 0a 23 20 20 20 64 65 66 69 6e 65 20 4d 41 58  /.#   define MAX
c940: 5f 36 42 59 54 45 20 28 28 28 28 69 36 34 29 30  _6BYTE ((((i64)0
c950: 78 30 30 30 30 31 30 30 30 29 3c 3c 33 32 29 2d  x00001000)<<32)-
c960: 31 29 0a 20 20 20 20 69 36 34 20 69 20 3d 20 70  1).    i64 i = p
c970: 4d 65 6d 2d 3e 75 2e 69 3b 0a 20 20 20 20 75 36  Mem->u.i;.    u6
c980: 34 20 75 3b 0a 20 20 20 20 69 66 28 20 66 69 6c  4 u;.    if( fil
c990: 65 5f 66 6f 72 6d 61 74 3e 3d 34 20 26 26 20 28  e_format>=4 && (
c9a0: 69 26 31 29 3d 3d 69 20 29 7b 0a 20 20 20 20 20  i&1)==i ){.     
c9b0: 20 72 65 74 75 72 6e 20 38 2b 69 3b 0a 20 20 20   return 8+i;.   
c9c0: 20 7d 0a 20 20 20 20 75 20 3d 20 69 3c 30 20 3f   }.    u = i<0 ?
c9d0: 20 2d 69 20 3a 20 69 3b 0a 20 20 20 20 69 66 28   -i : i;.    if(
c9e0: 20 75 3c 3d 31 32 37 20 29 20 72 65 74 75 72 6e   u<=127 ) return
c9f0: 20 31 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 33   1;.    if( u<=3
ca00: 32 37 36 37 20 29 20 72 65 74 75 72 6e 20 32 3b  2767 ) return 2;
ca10: 0a 20 20 20 20 69 66 28 20 75 3c 3d 38 33 38 38  .    if( u<=8388
ca20: 36 30 37 20 29 20 72 65 74 75 72 6e 20 33 3b 0a  607 ) return 3;.
ca30: 20 20 20 20 69 66 28 20 75 3c 3d 32 31 34 37 34      if( u<=21474
ca40: 38 33 36 34 37 20 29 20 72 65 74 75 72 6e 20 34  83647 ) return 4
ca50: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 4d 41 58  ;.    if( u<=MAX
ca60: 5f 36 42 59 54 45 20 29 20 72 65 74 75 72 6e 20  _6BYTE ) return 
ca70: 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 36 3b  5;.    return 6;
ca80: 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73  .  }.  if( flags
ca90: 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20 20 20  &MEM_Real ){.   
caa0: 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d 0a 20   return 7;.  }. 
cab0: 20 61 73 73 65 72 74 28 20 66 6c 61 67 73 26 28   assert( flags&(
cac0: 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 42 6c 6f 62  MEM_Str|MEM_Blob
cad0: 29 20 29 3b 0a 20 20 6e 20 3d 20 70 4d 65 6d 2d  ) );.  n = pMem-
cae0: 3e 6e 3b 0a 20 20 69 66 28 20 66 6c 61 67 73 20  >n;.  if( flags 
caf0: 26 20 4d 45 4d 5f 5a 65 72 6f 20 29 7b 0a 20 20  & MEM_Zero ){.  
cb00: 20 20 6e 20 2b 3d 20 70 4d 65 6d 2d 3e 75 2e 69    n += pMem->u.i
cb10: 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20  ;.  }.  assert( 
cb20: 6e 3e 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e  n>=0 );.  return
cb30: 20 28 28 6e 2a 32 29 20 2b 20 31 32 20 2b 20 28   ((n*2) + 12 + (
cb40: 28 66 6c 61 67 73 26 4d 45 4d 5f 53 74 72 29 21  (flags&MEM_Str)!
cb50: 3d 30 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  =0));.}../*.** R
cb60: 65 74 75 72 6e 20 74 68 65 20 6c 65 6e 67 74 68  eturn the length
cb70: 20 6f 66 20 74 68 65 20 64 61 74 61 20 63 6f 72   of the data cor
cb80: 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68  responding to th
cb90: 65 20 73 75 70 70 6c 69 65 64 20 73 65 72 69 61  e supplied seria
cba0: 6c 2d 74 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73  l-type..*/.int s
cbb0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
cbc0: 54 79 70 65 4c 65 6e 28 75 33 32 20 73 65 72 69  TypeLen(u32 seri
cbd0: 61 6c 5f 74 79 70 65 29 7b 0a 20 20 69 66 28 20  al_type){.  if( 
cbe0: 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20  serial_type>=12 
cbf0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73  ){.    return (s
cc00: 65 72 69 61 6c 5f 74 79 70 65 2d 31 32 29 2f 32  erial_type-12)/2
cc10: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  ;.  }else{.    s
cc20: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20 61  tatic const u8 a
cc30: 53 69 7a 65 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c  Size[] = { 0, 1,
cc40: 20 32 2c 20 33 2c 20 34 2c 20 36 2c 20 38 2c 20   2, 3, 4, 6, 8, 
cc50: 38 2c 20 30 2c 20 30 2c 20 30 2c 20 30 20 7d 3b  8, 0, 0, 0, 0 };
cc60: 0a 20 20 20 20 72 65 74 75 72 6e 20 61 53 69 7a  .    return aSiz
cc70: 65 5b 73 65 72 69 61 6c 5f 74 79 70 65 5d 3b 0a  e[serial_type];.
cc80: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20    }.}../*.** If 
cc90: 77 65 20 61 72 65 20 6f 6e 20 61 6e 20 61 72 63  we are on an arc
cca0: 68 69 74 65 63 74 75 72 65 20 77 69 74 68 20 6d  hitecture with m
ccb0: 69 78 65 64 2d 65 6e 64 69 61 6e 20 66 6c 6f 61  ixed-endian floa
ccc0: 74 69 6e 67 20 0a 2a 2a 2a 20 70 6f 69 6e 74 73  ting .*** points
ccd0: 20 28 65 78 3a 20 41 52 4d 37 29 20 74 68 65 6e   (ex: ARM7) then
cce0: 20 73 77 61 70 20 74 68 65 20 6c 6f 77 65 72 20   swap the lower 
ccf0: 34 20 62 79 74 65 73 20 77 69 74 68 20 74 68 65  4 bytes with the
cd00: 20 0a 2a 2a 20 75 70 70 65 72 20 34 20 62 79 74   .** upper 4 byt
cd10: 65 73 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20  es.  Return the 
cd20: 72 65 73 75 6c 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f  result..**.** Fo
cd30: 72 20 6d 6f 73 74 20 28 73 61 6e 65 29 20 61 72  r most (sane) ar
cd40: 63 68 69 74 65 63 74 75 72 65 73 2c 20 74 68 69  chitectures, thi
cd50: 73 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f  s is a no-op..*/
cd60: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 4d  .#ifdef SQLITE_M
cd70: 49 58 45 44 5f 45 4e 44 49 41 4e 5f 36 34 42 49  IXED_ENDIAN_64BI
cd80: 54 5f 46 4c 4f 41 54 0a 73 74 61 74 69 63 20 64  T_FLOAT.static d
cd90: 6f 75 62 6c 65 20 66 6c 6f 61 74 53 77 61 70 28  ouble floatSwap(
cda0: 64 6f 75 62 6c 65 20 69 6e 29 7b 0a 20 20 75 6e  double in){.  un
cdb0: 69 6f 6e 20 7b 0a 20 20 20 20 64 6f 75 62 6c 65  ion {.    double
cdc0: 20 72 3b 0a 20 20 20 20 75 33 32 20 69 5b 32 5d   r;.    u32 i[2]
cdd0: 3b 0a 20 20 7d 20 75 3b 0a 20 20 75 33 32 20 74  ;.  } u;.  u32 t
cde0: 3b 0a 0a 20 20 75 2e 72 20 3d 20 69 6e 3b 0a 20  ;..  u.r = in;. 
cdf0: 20 74 20 3d 20 75 2e 69 5b 30 5d 3b 0a 20 20 75   t = u.i[0];.  u
ce00: 2e 69 5b 30 5d 20 3d 20 75 2e 69 5b 31 5d 3b 0a  .i[0] = u.i[1];.
ce10: 20 20 75 2e 69 5b 31 5d 20 3d 20 74 3b 0a 20 20    u.i[1] = t;.  
ce20: 72 65 74 75 72 6e 20 75 2e 72 3b 0a 7d 0a 23 20  return u.r;.}.# 
ce30: 64 65 66 69 6e 65 20 73 77 61 70 4d 69 78 65 64  define swapMixed
ce40: 45 6e 64 69 61 6e 46 6c 6f 61 74 28 58 29 20 20  EndianFloat(X)  
ce50: 58 20 3d 20 66 6c 6f 61 74 53 77 61 70 28 58 29  X = floatSwap(X)
ce60: 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20  .#else.# define 
ce70: 73 77 61 70 4d 69 78 65 64 45 6e 64 69 61 6e 46  swapMixedEndianF
ce80: 6c 6f 61 74 28 58 29 0a 23 65 6e 64 69 66 0a 0a  loat(X).#endif..
ce90: 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68 65 20  /*.** Write the 
cea0: 73 65 72 69 61 6c 69 7a 65 64 20 64 61 74 61 20  serialized data 
ceb0: 62 6c 6f 62 20 66 6f 72 20 74 68 65 20 76 61 6c  blob for the val
cec0: 75 65 20 73 74 6f 72 65 64 20 69 6e 20 70 4d 65  ue stored in pMe
ced0: 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62 75 66 2e 20  m into .** buf. 
cee0: 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74 68  It is assumed th
cef0: 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 68 61  at the caller ha
cf00: 73 20 61 6c 6c 6f 63 61 74 65 64 20 73 75 66 66  s allocated suff
cf10: 69 63 69 65 6e 74 20 73 70 61 63 65 2e 0a 2a 2a  icient space..**
cf20: 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 62   Return the numb
cf30: 65 72 20 6f 66 20 62 79 74 65 73 20 77 72 69 74  er of bytes writ
cf40: 74 65 6e 2e 0a 2a 2a 0a 2a 2a 20 6e 42 75 66 20  ten..**.** nBuf 
cf50: 69 73 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66  is the amount of
cf60: 20 73 70 61 63 65 20 6c 65 66 74 20 69 6e 20 62   space left in b
cf70: 75 66 5b 5d 2e 20 20 6e 42 75 66 20 6d 75 73 74  uf[].  nBuf must
cf80: 20 61 6c 77 61 79 73 20 62 65 0a 2a 2a 20 6c 61   always be.** la
cf90: 72 67 65 20 65 6e 6f 75 67 68 20 74 6f 20 68 6f  rge enough to ho
cfa0: 6c 64 20 74 68 65 20 65 6e 74 69 72 65 20 66 69  ld the entire fi
cfb0: 65 6c 64 2e 20 20 45 78 63 65 70 74 2c 20 69 66  eld.  Except, if
cfc0: 20 74 68 65 20 66 69 65 6c 64 20 69 73 0a 2a 2a   the field is.**
cfd0: 20 61 20 62 6c 6f 62 20 77 69 74 68 20 61 20 7a   a blob with a z
cfe0: 65 72 6f 2d 66 69 6c 6c 65 64 20 74 61 69 6c 2c  ero-filled tail,
cff0: 20 74 68 65 6e 20 62 75 66 5b 5d 20 6d 69 67 68   then buf[] migh
d000: 74 20 62 65 20 6a 75 73 74 20 74 68 65 20 72 69  t be just the ri
d010: 67 68 74 0a 2a 2a 20 73 69 7a 65 20 74 6f 20 68  ght.** size to h
d020: 6f 6c 64 20 65 76 65 72 79 74 68 69 6e 67 20 65  old everything e
d030: 78 63 65 70 74 20 66 6f 72 20 74 68 65 20 7a 65  xcept for the ze
d040: 72 6f 2d 66 69 6c 6c 65 64 20 74 61 69 6c 2e 20  ro-filled tail. 
d050: 20 49 66 20 62 75 66 5b 5d 0a 2a 2a 20 69 73 20   If buf[].** is 
d060: 6f 6e 6c 79 20 62 69 67 20 65 6e 6f 75 67 68 20  only big enough 
d070: 74 6f 20 68 6f 6c 64 20 74 68 65 20 6e 6f 6e 2d  to hold the non-
d080: 7a 65 72 6f 20 70 72 65 66 69 78 2c 20 74 68 65  zero prefix, the
d090: 6e 20 6f 6e 6c 79 20 77 72 69 74 65 20 74 68 61  n only write tha
d0a0: 74 0a 2a 2a 20 70 72 65 66 69 78 20 69 6e 74 6f  t.** prefix into
d0b0: 20 62 75 66 5b 5d 2e 20 20 42 75 74 20 69 66 20   buf[].  But if 
d0c0: 62 75 66 5b 5d 20 69 73 20 6c 61 72 67 65 20 65  buf[] is large e
d0d0: 6e 6f 75 67 68 20 74 6f 20 68 6f 6c 64 20 62 6f  nough to hold bo
d0e0: 74 68 20 74 68 65 0a 2a 2a 20 70 72 65 66 69 78  th the.** prefix
d0f0: 20 61 6e 64 20 74 68 65 20 74 61 69 6c 20 74 68   and the tail th
d100: 65 6e 20 77 72 69 74 65 20 74 68 65 20 70 72 65  en write the pre
d110: 66 69 78 20 61 6e 64 20 73 65 74 20 74 68 65 20  fix and set the 
d120: 74 61 69 6c 20 74 6f 20 61 6c 6c 0a 2a 2a 20 7a  tail to all.** z
d130: 65 72 6f 73 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75  eros..**.** Retu
d140: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
d150: 20 62 79 74 65 73 20 61 63 74 75 61 6c 6c 79 20   bytes actually 
d160: 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 62 75 66  written into buf
d170: 5b 5d 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 0a  [].  The number.
d180: 2a 2a 20 6f 66 20 62 79 74 65 73 20 69 6e 20 74  ** of bytes in t
d190: 68 65 20 7a 65 72 6f 2d 66 69 6c 6c 65 64 20 74  he zero-filled t
d1a0: 61 69 6c 20 69 73 20 69 6e 63 6c 75 64 65 64 20  ail is included 
d1b0: 69 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76 61  in the return va
d1c0: 6c 75 65 20 6f 6e 6c 79 0a 2a 2a 20 69 66 20 74  lue only.** if t
d1d0: 68 6f 73 65 20 62 79 74 65 73 20 77 65 72 65 20  hose bytes were 
d1e0: 7a 65 72 6f 65 64 20 69 6e 20 62 75 66 5b 5d 2e  zeroed in buf[].
d1f0: 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65 33  .*/ .int sqlite3
d200: 56 64 62 65 53 65 72 69 61 6c 50 75 74 28 75 38  VdbeSerialPut(u8
d210: 20 2a 62 75 66 2c 20 69 6e 74 20 6e 42 75 66 2c   *buf, int nBuf,
d220: 20 4d 65 6d 20 2a 70 4d 65 6d 2c 20 69 6e 74 20   Mem *pMem, int 
d230: 66 69 6c 65 5f 66 6f 72 6d 61 74 29 7b 0a 20 20  file_format){.  
d240: 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65 20  u32 serial_type 
d250: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
d260: 69 61 6c 54 79 70 65 28 70 4d 65 6d 2c 20 66 69  ialType(pMem, fi
d270: 6c 65 5f 66 6f 72 6d 61 74 29 3b 0a 20 20 69 6e  le_format);.  in
d280: 74 20 6c 65 6e 3b 0a 0a 20 20 2f 2a 20 49 6e 74  t len;..  /* Int
d290: 65 67 65 72 20 61 6e 64 20 52 65 61 6c 20 2a 2f  eger and Real */
d2a0: 0a 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79  .  if( serial_ty
d2b0: 70 65 3c 3d 37 20 26 26 20 73 65 72 69 61 6c 5f  pe<=7 && serial_
d2c0: 74 79 70 65 3e 30 20 29 7b 0a 20 20 20 20 75 36  type>0 ){.    u6
d2d0: 34 20 76 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a  4 v;.    int i;.
d2e0: 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74      if( serial_t
d2f0: 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20 20 20 20  ype==7 ){.      
d300: 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28 76  assert( sizeof(v
d310: 29 3d 3d 73 69 7a 65 6f 66 28 70 4d 65 6d 2d 3e  )==sizeof(pMem->
d320: 72 29 20 29 3b 0a 20 20 20 20 20 20 73 77 61 70  r) );.      swap
d330: 4d 69 78 65 64 45 6e 64 69 61 6e 46 6c 6f 61 74  MixedEndianFloat
d340: 28 70 4d 65 6d 2d 3e 72 29 3b 0a 20 20 20 20 20  (pMem->r);.     
d350: 20 6d 65 6d 63 70 79 28 26 76 2c 20 26 70 4d 65   memcpy(&v, &pMe
d360: 6d 2d 3e 72 2c 20 73 69 7a 65 6f 66 28 76 29 29  m->r, sizeof(v))
d370: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
d380: 20 20 20 76 20 3d 20 70 4d 65 6d 2d 3e 75 2e 69     v = pMem->u.i
d390: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c 65 6e 20  ;.    }.    len 
d3a0: 3d 20 69 20 3d 20 73 71 6c 69 74 65 33 56 64 62  = i = sqlite3Vdb
d3b0: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73  eSerialTypeLen(s
d3c0: 65 72 69 61 6c 5f 74 79 70 65 29 3b 0a 20 20 20  erial_type);.   
d3d0: 20 61 73 73 65 72 74 28 20 6c 65 6e 3c 3d 6e 42   assert( len<=nB
d3e0: 75 66 20 29 3b 0a 20 20 20 20 77 68 69 6c 65 28  uf );.    while(
d3f0: 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20 20 62 75   i-- ){.      bu
d400: 66 5b 69 5d 20 3d 20 28 76 26 30 78 46 46 29 3b  f[i] = (v&0xFF);
d410: 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20 38 3b 0a  .      v >>= 8;.
d420: 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e      }.    return
d430: 20 6c 65 6e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20   len;.  }..  /* 
d440: 53 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20 2a  String or blob *
d450: 2f 0a 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74  /.  if( serial_t
d460: 79 70 65 3e 3d 31 32 20 29 7b 0a 20 20 20 20 61  ype>=12 ){.    a
d470: 73 73 65 72 74 28 20 70 4d 65 6d 2d 3e 6e 20 2b  ssert( pMem->n +
d480: 20 28 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 26   ((pMem->flags &
d490: 20 4d 45 4d 5f 5a 65 72 6f 29 3f 70 4d 65 6d 2d   MEM_Zero)?pMem-
d4a0: 3e 75 2e 69 3a 30 29 0a 20 20 20 20 20 20 20 20  >u.i:0).        
d4b0: 20 20 20 20 20 3d 3d 20 73 71 6c 69 74 65 33 56       == sqlite3V
d4c0: 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e  dbeSerialTypeLen
d4d0: 28 73 65 72 69 61 6c 5f 74 79 70 65 29 20 29 3b  (serial_type) );
d4e0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4d 65  .    assert( pMe
d4f0: 6d 2d 3e 6e 3c 3d 6e 42 75 66 20 29 3b 0a 20 20  m->n<=nBuf );.  
d500: 20 20 6c 65 6e 20 3d 20 70 4d 65 6d 2d 3e 6e 3b    len = pMem->n;
d510: 0a 20 20 20 20 6d 65 6d 63 70 79 28 62 75 66 2c  .    memcpy(buf,
d520: 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b 0a   pMem->z, len);.
d530: 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e 66 6c      if( pMem->fl
d540: 61 67 73 20 26 20 4d 45 4d 5f 5a 65 72 6f 20 29  ags & MEM_Zero )
d550: 7b 0a 20 20 20 20 20 20 6c 65 6e 20 2b 3d 20 70  {.      len += p
d560: 4d 65 6d 2d 3e 75 2e 69 3b 0a 20 20 20 20 20 20  Mem->u.i;.      
d570: 69 66 28 20 6c 65 6e 3e 6e 42 75 66 20 29 7b 0a  if( len>nBuf ){.
d580: 20 20 20 20 20 20 20 20 6c 65 6e 20 3d 20 6e 42          len = nB
d590: 75 66 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  uf;.      }.    
d5a0: 20 20 6d 65 6d 73 65 74 28 26 62 75 66 5b 70 4d    memset(&buf[pM
d5b0: 65 6d 2d 3e 6e 5d 2c 20 30 2c 20 6c 65 6e 2d 70  em->n], 0, len-p
d5c0: 4d 65 6d 2d 3e 6e 29 3b 0a 20 20 20 20 7d 0a 20  Mem->n);.    }. 
d5d0: 20 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 20     return len;. 
d5e0: 20 7d 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 6f 72   }..  /* NULL or
d5f0: 20 63 6f 6e 73 74 61 6e 74 73 20 30 20 6f 72 20   constants 0 or 
d600: 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 30 3b  1 */.  return 0;
d610: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 73 65 72 69  .}../*.** Deseri
d620: 61 6c 69 7a 65 20 74 68 65 20 64 61 74 61 20 62  alize the data b
d630: 6c 6f 62 20 70 6f 69 6e 74 65 64 20 74 6f 20 62  lob pointed to b
d640: 79 20 62 75 66 20 61 73 20 73 65 72 69 61 6c 20  y buf as serial 
d650: 74 79 70 65 20 73 65 72 69 61 6c 5f 74 79 70 65  type serial_type
d660: 0a 2a 2a 20 61 6e 64 20 73 74 6f 72 65 20 74 68  .** and store th
d670: 65 20 72 65 73 75 6c 74 20 69 6e 20 70 4d 65 6d  e result in pMem
d680: 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  .  Return the nu
d690: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 72 65  mber of bytes re
d6a0: 61 64 2e 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69  ad..*/ .int sqli
d6b0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65 74  te3VdbeSerialGet
d6c0: 28 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  (.  const unsign
d6d0: 65 64 20 63 68 61 72 20 2a 62 75 66 2c 20 20 20  ed char *buf,   
d6e0: 20 20 2f 2a 20 42 75 66 66 65 72 20 74 6f 20 64    /* Buffer to d
d6f0: 65 73 65 72 69 61 6c 69 7a 65 20 66 72 6f 6d 20  eserialize from 
d700: 2a 2f 0a 20 20 75 33 32 20 73 65 72 69 61 6c 5f  */.  u32 serial_
d710: 74 79 70 65 2c 20 20 20 20 20 20 20 20 20 20 20  type,           
d720: 20 20 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70     /* Serial typ
d730: 65 20 74 6f 20 64 65 73 65 72 69 61 6c 69 7a 65  e to deserialize
d740: 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d 20   */.  Mem *pMem 
d750: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d760: 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 63 65      /* Memory ce
d770: 6c 6c 20 74 6f 20 77 72 69 74 65 20 76 61 6c 75  ll to write valu
d780: 65 20 69 6e 74 6f 20 2a 2f 0a 29 7b 0a 20 20 73  e into */.){.  s
d790: 77 69 74 63 68 28 20 73 65 72 69 61 6c 5f 74 79  witch( serial_ty
d7a0: 70 65 20 29 7b 0a 20 20 20 20 63 61 73 65 20 31  pe ){.    case 1
d7b0: 30 3a 20 20 20 2f 2a 20 52 65 73 65 72 76 65 64  0:   /* Reserved
d7c0: 20 66 6f 72 20 66 75 74 75 72 65 20 75 73 65 20   for future use 
d7d0: 2a 2f 0a 20 20 20 20 63 61 73 65 20 31 31 3a 20  */.    case 11: 
d7e0: 20 20 2f 2a 20 52 65 73 65 72 76 65 64 20 66 6f    /* Reserved fo
d7f0: 72 20 66 75 74 75 72 65 20 75 73 65 20 2a 2f 0a  r future use */.
d800: 20 20 20 20 63 61 73 65 20 30 3a 20 7b 20 20 2f      case 0: {  /
d810: 2a 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20 20 20 20  * NULL */.      
d820: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
d830: 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 62 72  M_Null;.      br
d840: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
d850: 61 73 65 20 31 3a 20 7b 20 2f 2a 20 31 2d 62 79  ase 1: { /* 1-by
d860: 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65  te signed intege
d870: 72 20 2a 2f 0a 20 20 20 20 20 20 70 4d 65 6d 2d  r */.      pMem-
d880: 3e 75 2e 69 20 3d 20 28 73 69 67 6e 65 64 20 63  >u.i = (signed c
d890: 68 61 72 29 62 75 66 5b 30 5d 3b 0a 20 20 20 20  har)buf[0];.    
d8a0: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
d8b0: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 72  MEM_Int;.      r
d8c0: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a 20  eturn 1;.    }. 
d8d0: 20 20 20 63 61 73 65 20 32 3a 20 7b 20 2f 2a 20     case 2: { /* 
d8e0: 32 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 6e  2-byte signed in
d8f0: 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 20 20 70  teger */.      p
d900: 4d 65 6d 2d 3e 75 2e 69 20 3d 20 28 28 28 73 69  Mem->u.i = (((si
d910: 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30 5d  gned char)buf[0]
d920: 29 3c 3c 38 29 20 7c 20 62 75 66 5b 31 5d 3b 0a  )<<8) | buf[1];.
d930: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
d940: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
d950: 20 20 20 72 65 74 75 72 6e 20 32 3b 0a 20 20 20     return 2;.   
d960: 20 7d 0a 20 20 20 20 63 61 73 65 20 33 3a 20 7b   }.    case 3: {
d970: 20 2f 2a 20 33 2d 62 79 74 65 20 73 69 67 6e 65   /* 3-byte signe
d980: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20  d integer */.   
d990: 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20 28     pMem->u.i = (
d9a0: 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62 75  ((signed char)bu
d9b0: 66 5b 30 5d 29 3c 3c 31 36 29 20 7c 20 28 62 75  f[0])<<16) | (bu
d9c0: 66 5b 31 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 32  f[1]<<8) | buf[2
d9d0: 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  ];.      pMem->f
d9e0: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
d9f0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 33 3b 0a        return 3;.
da00: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 34      }.    case 4
da10: 3a 20 7b 20 2f 2a 20 34 2d 62 79 74 65 20 73 69  : { /* 4-byte si
da20: 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a  gned integer */.
da30: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20        pMem->u.i 
da40: 3d 20 28 62 75 66 5b 30 5d 3c 3c 32 34 29 20 7c  = (buf[0]<<24) |
da50: 20 28 62 75 66 5b 31 5d 3c 3c 31 36 29 20 7c 20   (buf[1]<<16) | 
da60: 28 62 75 66 5b 32 5d 3c 3c 38 29 20 7c 20 62 75  (buf[2]<<8) | bu
da70: 66 5b 33 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d  f[3];.      pMem
da80: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
da90: 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  t;.      return 
daa0: 34 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  4;.    }.    cas
dab0: 65 20 35 3a 20 7b 20 2f 2a 20 36 2d 62 79 74 65  e 5: { /* 6-byte
dac0: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20   signed integer 
dad0: 2a 2f 0a 20 20 20 20 20 20 75 36 34 20 78 20 3d  */.      u64 x =
dae0: 20 28 28 28 73 69 67 6e 65 64 20 63 68 61 72 29   (((signed char)
daf0: 62 75 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62 75  buf[0])<<8) | bu
db00: 66 5b 31 5d 3b 0a 20 20 20 20 20 20 75 33 32 20  f[1];.      u32 
db10: 79 20 3d 20 28 62 75 66 5b 32 5d 3c 3c 32 34 29  y = (buf[2]<<24)
db20: 20 7c 20 28 62 75 66 5b 33 5d 3c 3c 31 36 29 20   | (buf[3]<<16) 
db30: 7c 20 28 62 75 66 5b 34 5d 3c 3c 38 29 20 7c 20  | (buf[4]<<8) | 
db40: 62 75 66 5b 35 5d 3b 0a 20 20 20 20 20 20 78 20  buf[5];.      x 
db50: 3d 20 28 78 3c 3c 33 32 29 20 7c 20 79 3b 0a 20  = (x<<32) | y;. 
db60: 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d       pMem->u.i =
db70: 20 2a 28 69 36 34 2a 29 26 78 3b 0a 20 20 20 20   *(i64*)&x;.    
db80: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
db90: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 72  MEM_Int;.      r
dba0: 65 74 75 72 6e 20 36 3b 0a 20 20 20 20 7d 0a 20  eturn 6;.    }. 
dbb0: 20 20 20 63 61 73 65 20 36 3a 20 20 20 2f 2a 20     case 6:   /* 
dbc0: 38 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 6e  8-byte signed in
dbd0: 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 63 61 73  teger */.    cas
dbe0: 65 20 37 3a 20 7b 20 2f 2a 20 49 45 45 45 20 66  e 7: { /* IEEE f
dbf0: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 2a 2f  loating point */
dc00: 0a 20 20 20 20 20 20 75 36 34 20 78 3b 0a 20 20  .      u64 x;.  
dc10: 20 20 20 20 75 33 32 20 79 3b 0a 23 69 66 20 21      u32 y;.#if !
dc20: 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 20  defined(NDEBUG) 
dc30: 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c 49  && !defined(SQLI
dc40: 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e 47  TE_OMIT_FLOATING
dc50: 5f 50 4f 49 4e 54 29 0a 20 20 20 20 20 20 2f 2a  _POINT).      /*
dc60: 20 56 65 72 69 66 79 20 74 68 61 74 20 69 6e 74   Verify that int
dc70: 65 67 65 72 73 20 61 6e 64 20 66 6c 6f 61 74 69  egers and floati
dc80: 6e 67 20 70 6f 69 6e 74 20 76 61 6c 75 65 73 20  ng point values 
dc90: 75 73 65 20 74 68 65 20 73 61 6d 65 0a 20 20 20  use the same.   
dca0: 20 20 20 2a 2a 20 62 79 74 65 20 6f 72 64 65 72     ** byte order
dcb0: 2e 20 20 4f 72 2c 20 74 68 61 74 20 69 66 20 53  .  Or, that if S
dcc0: 51 4c 49 54 45 5f 4d 49 58 45 44 5f 45 4e 44 49  QLITE_MIXED_ENDI
dcd0: 41 4e 5f 36 34 42 49 54 5f 46 4c 4f 41 54 20 69  AN_64BIT_FLOAT i
dce0: 73 0a 20 20 20 20 20 20 2a 2a 20 64 65 66 69 6e  s.      ** defin
dcf0: 65 64 20 74 68 61 74 20 36 34 2d 62 69 74 20 66  ed that 64-bit f
dd00: 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 76 61  loating point va
dd10: 6c 75 65 73 20 72 65 61 6c 6c 79 20 61 72 65 20  lues really are 
dd20: 6d 69 78 65 64 0a 20 20 20 20 20 20 2a 2a 20 65  mixed.      ** e
dd30: 6e 64 69 61 6e 2e 0a 20 20 20 20 20 20 2a 2f 0a  ndian..      */.
dd40: 20 20 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e        static con
dd50: 73 74 20 75 36 34 20 74 31 20 3d 20 28 28 75 36  st u64 t1 = ((u6
dd60: 34 29 30 78 33 66 66 30 30 30 30 30 29 3c 3c 33  4)0x3ff00000)<<3
dd70: 32 3b 0a 20 20 20 20 20 20 73 74 61 74 69 63 20  2;.      static 
dd80: 63 6f 6e 73 74 20 64 6f 75 62 6c 65 20 72 31 20  const double r1 
dd90: 3d 20 31 2e 30 3b 0a 20 20 20 20 20 20 64 6f 75  = 1.0;.      dou
dda0: 62 6c 65 20 72 32 20 3d 20 72 31 3b 0a 20 20 20  ble r2 = r1;.   
ddb0: 20 20 20 73 77 61 70 4d 69 78 65 64 45 6e 64 69     swapMixedEndi
ddc0: 61 6e 46 6c 6f 61 74 28 72 32 29 3b 0a 20 20 20  anFloat(r2);.   
ddd0: 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f     assert( sizeo
dde0: 66 28 72 32 29 3d 3d 73 69 7a 65 6f 66 28 74 31  f(r2)==sizeof(t1
ddf0: 29 20 26 26 20 6d 65 6d 63 6d 70 28 26 72 32 2c  ) && memcmp(&r2,
de00: 20 26 74 31 2c 20 73 69 7a 65 6f 66 28 72 31 29   &t1, sizeof(r1)
de10: 29 3d 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a 0a  )==0 );.#endif..
de20: 20 20 20 20 20 20 78 20 3d 20 28 62 75 66 5b 30        x = (buf[0
de30: 5d 3c 3c 32 34 29 20 7c 20 28 62 75 66 5b 31 5d  ]<<24) | (buf[1]
de40: 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b 32 5d 3c  <<16) | (buf[2]<
de50: 3c 38 29 20 7c 20 62 75 66 5b 33 5d 3b 0a 20 20  <8) | buf[3];.  
de60: 20 20 20 20 79 20 3d 20 28 62 75 66 5b 34 5d 3c      y = (buf[4]<
de70: 3c 32 34 29 20 7c 20 28 62 75 66 5b 35 5d 3c 3c  <24) | (buf[5]<<
de80: 31 36 29 20 7c 20 28 62 75 66 5b 36 5d 3c 3c 38  16) | (buf[6]<<8
de90: 29 20 7c 20 62 75 66 5b 37 5d 3b 0a 20 20 20 20  ) | buf[7];.    
dea0: 20 20 78 20 3d 20 28 78 3c 3c 33 32 29 20 7c 20    x = (x<<32) | 
deb0: 79 3b 0a 20 20 20 20 20 20 69 66 28 20 73 65 72  y;.      if( ser
dec0: 69 61 6c 5f 74 79 70 65 3d 3d 36 20 29 7b 0a 20  ial_type==6 ){. 
ded0: 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69         pMem->u.i
dee0: 20 3d 20 2a 28 69 36 34 2a 29 26 78 3b 0a 20 20   = *(i64*)&x;.  
def0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
df00: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
df10: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
df20: 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66    assert( sizeof
df30: 28 78 29 3d 3d 38 20 26 26 20 73 69 7a 65 6f 66  (x)==8 && sizeof
df40: 28 70 4d 65 6d 2d 3e 72 29 3d 3d 38 20 29 3b 0a  (pMem->r)==8 );.
df50: 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28 26          memcpy(&
df60: 70 4d 65 6d 2d 3e 72 2c 20 26 78 2c 20 73 69 7a  pMem->r, &x, siz
df70: 65 6f 66 28 78 29 29 3b 0a 20 20 20 20 20 20 20  eof(x));.       
df80: 20 73 77 61 70 4d 69 78 65 64 45 6e 64 69 61 6e   swapMixedEndian
df90: 46 6c 6f 61 74 28 70 4d 65 6d 2d 3e 72 29 3b 0a  Float(pMem->r);.
dfa0: 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c          pMem->fl
dfb0: 61 67 73 20 3d 20 4d 45 4d 5f 52 65 61 6c 3b 0a  ags = MEM_Real;.
dfc0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65        }.      re
dfd0: 74 75 72 6e 20 38 3b 0a 20 20 20 20 7d 0a 20 20  turn 8;.    }.  
dfe0: 20 20 63 61 73 65 20 38 3a 20 20 20 20 2f 2a 20    case 8:    /* 
dff0: 49 6e 74 65 67 65 72 20 30 20 2a 2f 0a 20 20 20  Integer 0 */.   
e000: 20 63 61 73 65 20 39 3a 20 7b 20 20 2f 2a 20 49   case 9: {  /* I
e010: 6e 74 65 67 65 72 20 31 20 2a 2f 0a 20 20 20 20  nteger 1 */.    
e020: 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20 73 65    pMem->u.i = se
e030: 72 69 61 6c 5f 74 79 70 65 2d 38 3b 0a 20 20 20  rial_type-8;.   
e040: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
e050: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20   MEM_Int;.      
e060: 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a  return 0;.    }.
e070: 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20      default: {. 
e080: 20 20 20 20 20 69 6e 74 20 6c 65 6e 20 3d 20 28       int len = (
e090: 73 65 72 69 61 6c 5f 74 79 70 65 2d 31 32 29 2f  serial_type-12)/
e0a0: 32 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 7a  2;.      pMem->z
e0b0: 20 3d 20 28 63 68 61 72 20 2a 29 62 75 66 3b 0a   = (char *)buf;.
e0c0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d 20        pMem->n = 
e0d0: 6c 65 6e 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  len;.      pMem-
e0e0: 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 20 20 20  >xDel = 0;.     
e0f0: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
e100: 26 30 78 30 31 20 29 7b 0a 20 20 20 20 20 20 20  &0x01 ){.       
e110: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
e120: 45 4d 5f 53 74 72 20 7c 20 4d 45 4d 5f 45 70 68  EM_Str | MEM_Eph
e130: 65 6d 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  em;.      }else{
e140: 0a 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  .        pMem->f
e150: 6c 61 67 73 20 3d 20 4d 45 4d 5f 42 6c 6f 62 20  lags = MEM_Blob 
e160: 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20  | MEM_Ephem;.   
e170: 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75 72     }.      retur
e180: 6e 20 6c 65 6e 3b 0a 20 20 20 20 7d 0a 20 20 7d  n len;.    }.  }
e190: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a  .  return 0;.}..
e1a0: 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 65 72  /*.** The header
e1b0: 20 6f 66 20 61 20 72 65 63 6f 72 64 20 63 6f 6e   of a record con
e1c0: 73 69 73 74 73 20 6f 66 20 61 20 73 65 71 75 65  sists of a seque
e1d0: 6e 63 65 20 76 61 72 69 61 62 6c 65 2d 6c 65 6e  nce variable-len
e1e0: 67 74 68 20 69 6e 74 65 67 65 72 73 2e 0a 2a 2a  gth integers..**
e1f0: 20 54 68 65 73 65 20 69 6e 74 65 67 65 72 73 20   These integers 
e200: 61 72 65 20 61 6c 6d 6f 73 74 20 61 6c 77 61 79  are almost alway
e210: 73 20 73 6d 61 6c 6c 20 61 6e 64 20 61 72 65 20  s small and are 
e220: 65 6e 63 6f 64 65 64 20 61 73 20 61 20 73 69 6e  encoded as a sin
e230: 67 6c 65 20 62 79 74 65 2e 0a 2a 2a 20 54 68 65  gle byte..** The
e240: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72 6f   following macro
e250: 20 74 61 6b 65 73 20 61 64 76 61 6e 74 61 67 65   takes advantage
e260: 20 74 68 69 73 20 66 61 63 74 20 74 6f 20 70 72   this fact to pr
e270: 6f 76 69 64 65 20 61 20 66 61 73 74 20 64 65 63  ovide a fast dec
e280: 6f 64 65 0a 2a 2a 20 6f 66 20 74 68 65 20 69 6e  ode.** of the in
e290: 74 65 67 65 72 73 20 69 6e 20 61 20 72 65 63 6f  tegers in a reco
e2a0: 72 64 20 68 65 61 64 65 72 2e 20 20 49 74 20 69  rd header.  It i
e2b0: 73 20 66 61 73 74 65 72 20 66 6f 72 20 74 68 65  s faster for the
e2c0: 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 0a 2a 2a 20   common case.** 
e2d0: 77 68 65 72 65 20 74 68 65 20 69 6e 74 65 67 65  where the intege
e2e0: 72 20 69 73 20 61 20 73 69 6e 67 6c 65 20 62 79  r is a single by
e2f0: 74 65 2e 20 20 49 74 20 69 73 20 61 20 6c 69 74  te.  It is a lit
e300: 74 6c 65 20 73 6c 6f 77 65 72 20 77 68 65 6e 20  tle slower when 
e310: 74 68 65 0a 2a 2a 20 69 6e 74 65 67 65 72 20 69  the.** integer i
e320: 73 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 62 79  s two or more by
e330: 74 65 73 2e 20 20 42 75 74 20 6f 76 65 72 61 6c  tes.  But overal
e340: 6c 20 69 74 20 69 73 20 66 61 73 74 65 72 2e 0a  l it is faster..
e350: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  **.** The follow
e360: 69 6e 67 20 65 78 70 72 65 73 73 69 6f 6e 73 20  ing expressions 
e370: 61 72 65 20 65 71 75 69 76 61 6c 65 6e 74 3a 0a  are equivalent:.
e380: 2a 2a 0a 2a 2a 20 20 20 20 20 78 20 3d 20 73 71  **.**     x = sq
e390: 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33 32  lite3GetVarint32
e3a0: 28 20 41 2c 20 26 42 20 29 3b 0a 2a 2a 0a 2a 2a  ( A, &B );.**.**
e3b0: 20 20 20 20 20 78 20 3d 20 47 65 74 56 61 72 69       x = GetVari
e3c0: 6e 74 28 20 41 2c 20 42 20 29 3b 0a 2a 2a 0a 2a  nt( A, B );.**.*
e3d0: 2f 0a 23 64 65 66 69 6e 65 20 47 65 74 56 61 72  /.#define GetVar
e3e0: 69 6e 74 28 41 2c 42 29 20 20 28 28 42 20 3d 20  int(A,B)  ((B = 
e3f0: 2a 28 41 29 29 3c 3d 30 78 37 66 20 3f 20 31 20  *(A))<=0x7f ? 1 
e400: 3a 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69  : sqlite3GetVari
e410: 6e 74 33 32 28 41 2c 20 26 42 29 29 0a 0a 2f 2a  nt32(A, &B))../*
e420: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
e430: 6e 20 63 6f 6d 70 61 72 65 73 20 74 68 65 20 74  n compares the t
e440: 77 6f 20 74 61 62 6c 65 20 72 6f 77 73 20 6f 72  wo table rows or
e450: 20 69 6e 64 65 78 20 72 65 63 6f 72 64 73 20 73   index records s
e460: 70 65 63 69 66 69 65 64 20 62 79 20 0a 2a 2a 20  pecified by .** 
e470: 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20 61  {nKey1, pKey1} a
e480: 6e 64 20 7b 6e 4b 65 79 32 2c 20 70 4b 65 79 32  nd {nKey2, pKey2
e490: 7d 2c 20 72 65 74 75 72 6e 69 6e 67 20 61 20 6e  }, returning a n
e4a0: 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 0a 2a 2a  egative, zero.**
e4b0: 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 6e 74   or positive int
e4c0: 65 67 65 72 20 69 66 20 7b 6e 4b 65 79 31 2c 20  eger if {nKey1, 
e4d0: 70 4b 65 79 31 7d 20 69 73 20 6c 65 73 73 20 74  pKey1} is less t
e4e0: 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f 20 6f 72  han, equal to or
e4f0: 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61   .** greater tha
e500: 6e 20 7b 6e 4b 65 79 32 2c 20 70 4b 65 79 32 7d  n {nKey2, pKey2}
e510: 2e 20 20 42 6f 74 68 20 4b 65 79 31 20 61 6e 64  .  Both Key1 and
e520: 20 4b 65 79 32 20 6d 75 73 74 20 62 65 20 62 79   Key2 must be by
e530: 74 65 20 73 74 72 69 6e 67 73 0a 2a 2a 20 63 6f  te strings.** co
e540: 6d 70 6f 73 65 64 20 62 79 20 74 68 65 20 4f 50  mposed by the OP
e550: 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f  _MakeRecord opco
e560: 64 65 20 6f 66 20 74 68 65 20 56 44 42 45 2e 0a  de of the VDBE..
e570: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
e580: 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65 28  beRecordCompare(
e590: 0a 20 20 76 6f 69 64 20 2a 75 73 65 72 44 61 74  .  void *userDat
e5a0: 61 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c 20  a,.  int nKey1, 
e5b0: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65 79  const void *pKey
e5c0: 31 2c 20 0a 20 20 69 6e 74 20 6e 4b 65 79 32 2c  1, .  int nKey2,
e5d0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65   const void *pKe
e5e0: 79 32 0a 29 7b 0a 20 20 4b 65 79 49 6e 66 6f 20  y2.){.  KeyInfo 
e5f0: 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 28 4b 65 79  *pKeyInfo = (Key
e600: 49 6e 66 6f 2a 29 75 73 65 72 44 61 74 61 3b 0a  Info*)userData;.
e610: 20 20 75 33 32 20 64 31 2c 20 64 32 3b 20 20 20    u32 d1, d2;   
e620: 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74         /* Offset
e630: 20 69 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66 20   into aKey[] of 
e640: 6e 65 78 74 20 64 61 74 61 20 65 6c 65 6d 65 6e  next data elemen
e650: 74 20 2a 2f 0a 20 20 75 33 32 20 69 64 78 31 2c  t */.  u32 idx1,
e660: 20 69 64 78 32 3b 20 20 20 20 20 20 2f 2a 20 4f   idx2;      /* O
e670: 66 66 73 65 74 20 69 6e 74 6f 20 61 4b 65 79 5b  ffset into aKey[
e680: 5d 20 6f 66 20 6e 65 78 74 20 68 65 61 64 65 72  ] of next header
e690: 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75 33   element */.  u3
e6a0: 32 20 73 7a 48 64 72 31 2c 20 73 7a 48 64 72 32  2 szHdr1, szHdr2
e6b0: 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20  ;  /* Number of 
e6c0: 62 79 74 65 73 20 69 6e 20 68 65 61 64 65 72 20  bytes in header 
e6d0: 2a 2f 0a 20 20 69 6e 74 20 69 20 3d 20 30 3b 0a  */.  int i = 0;.
e6e0: 20 20 69 6e 74 20 6e 46 69 65 6c 64 3b 0a 20 20    int nField;.  
e6f0: 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 63 6f  int rc = 0;.  co
e700: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61  nst unsigned cha
e710: 72 20 2a 61 4b 65 79 31 20 3d 20 28 63 6f 6e 73  r *aKey1 = (cons
e720: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20  t unsigned char 
e730: 2a 29 70 4b 65 79 31 3b 0a 20 20 63 6f 6e 73 74  *)pKey1;.  const
e740: 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a   unsigned char *
e750: 61 4b 65 79 32 20 3d 20 28 63 6f 6e 73 74 20 75  aKey2 = (const u
e760: 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29 70  nsigned char *)p
e770: 4b 65 79 32 3b 0a 0a 20 20 4d 65 6d 20 6d 65 6d  Key2;..  Mem mem
e780: 31 3b 0a 20 20 4d 65 6d 20 6d 65 6d 32 3b 0a 20  1;.  Mem mem2;. 
e790: 20 6d 65 6d 31 2e 65 6e 63 20 3d 20 70 4b 65 79   mem1.enc = pKey
e7a0: 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20 6d 65 6d  Info->enc;.  mem
e7b0: 32 2e 65 6e 63 20 3d 20 70 4b 65 79 49 6e 66 6f  2.enc = pKeyInfo
e7c0: 2d 3e 65 6e 63 3b 0a 20 20 0a 20 20 69 64 78 31  ->enc;.  .  idx1
e7d0: 20 3d 20 47 65 74 56 61 72 69 6e 74 28 61 4b 65   = GetVarint(aKe
e7e0: 79 31 2c 20 73 7a 48 64 72 31 29 3b 0a 20 20 64  y1, szHdr1);.  d
e7f0: 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20 20 69 64  1 = szHdr1;.  id
e800: 78 32 20 3d 20 47 65 74 56 61 72 69 6e 74 28 61  x2 = GetVarint(a
e810: 4b 65 79 32 2c 20 73 7a 48 64 72 32 29 3b 0a 20  Key2, szHdr2);. 
e820: 20 64 32 20 3d 20 73 7a 48 64 72 32 3b 0a 20 20   d2 = szHdr2;.  
e830: 6e 46 69 65 6c 64 20 3d 20 70 4b 65 79 49 6e 66  nField = pKeyInf
e840: 6f 2d 3e 6e 46 69 65 6c 64 3b 0a 20 20 77 68 69  o->nField;.  whi
e850: 6c 65 28 20 69 64 78 31 3c 73 7a 48 64 72 31 20  le( idx1<szHdr1 
e860: 26 26 20 69 64 78 32 3c 73 7a 48 64 72 32 20 29  && idx2<szHdr2 )
e870: 7b 0a 20 20 20 20 75 33 32 20 73 65 72 69 61 6c  {.    u32 serial
e880: 5f 74 79 70 65 31 3b 0a 20 20 20 20 75 33 32 20  _type1;.    u32 
e890: 73 65 72 69 61 6c 5f 74 79 70 65 32 3b 0a 0a 20  serial_type2;.. 
e8a0: 20 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73     /* Read the s
e8b0: 65 72 69 61 6c 20 74 79 70 65 73 20 66 6f 72 20  erial types for 
e8c0: 74 68 65 20 6e 65 78 74 20 65 6c 65 6d 65 6e 74  the next element
e8d0: 20 69 6e 20 65 61 63 68 20 6b 65 79 2e 20 2a 2f   in each key. */
e8e0: 0a 20 20 20 20 69 64 78 31 20 2b 3d 20 47 65 74  .    idx1 += Get
e8f0: 56 61 72 69 6e 74 28 20 61 4b 65 79 31 2b 69 64  Varint( aKey1+id
e900: 78 31 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 31  x1, serial_type1
e910: 20 29 3b 0a 20 20 20 20 69 66 28 20 64 31 3e 3d   );.    if( d1>=
e920: 6e 4b 65 79 31 20 26 26 20 73 71 6c 69 74 65 33  nKey1 && sqlite3
e930: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
e940: 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 31 29 3e  n(serial_type1)>
e950: 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 69  0 ) break;.    i
e960: 64 78 32 20 2b 3d 20 47 65 74 56 61 72 69 6e 74  dx2 += GetVarint
e970: 28 20 61 4b 65 79 32 2b 69 64 78 32 2c 20 73 65  ( aKey2+idx2, se
e980: 72 69 61 6c 5f 74 79 70 65 32 20 29 3b 0a 20 20  rial_type2 );.  
e990: 20 20 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32 20    if( d2>=nKey2 
e9a0: 26 26 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  && sqlite3VdbeSe
e9b0: 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69  rialTypeLen(seri
e9c0: 61 6c 5f 74 79 70 65 32 29 3e 30 20 29 20 62 72  al_type2)>0 ) br
e9d0: 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 45 78 74  eak;..    /* Ext
e9e0: 72 61 63 74 20 74 68 65 20 76 61 6c 75 65 73 20  ract the values 
e9f0: 74 6f 20 62 65 20 63 6f 6d 70 61 72 65 64 2e 0a  to be compared..
ea00: 20 20 20 20 2a 2f 0a 20 20 20 20 64 31 20 2b 3d      */.    d1 +=
ea10: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
ea20: 61 6c 47 65 74 28 26 61 4b 65 79 31 5b 64 31 5d  alGet(&aKey1[d1]
ea30: 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 31 2c 20  , serial_type1, 
ea40: 26 6d 65 6d 31 29 3b 0a 20 20 20 20 64 32 20 2b  &mem1);.    d2 +
ea50: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
ea60: 69 61 6c 47 65 74 28 26 61 4b 65 79 32 5b 64 32  ialGet(&aKey2[d2
ea70: 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 32 2c  ], serial_type2,
ea80: 20 26 6d 65 6d 32 29 3b 0a 0a 20 20 20 20 2f 2a   &mem2);..    /*
ea90: 20 44 6f 20 74 68 65 20 63 6f 6d 70 61 72 69 73   Do the comparis
eaa0: 6f 6e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72 63  on.    */.    rc
eab0: 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f 6d   = sqlite3MemCom
eac0: 70 61 72 65 28 26 6d 65 6d 31 2c 20 26 6d 65 6d  pare(&mem1, &mem
ead0: 32 2c 20 69 3c 6e 46 69 65 6c 64 20 3f 20 70 4b  2, i<nField ? pK
eae0: 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 69 5d  eyInfo->aColl[i]
eaf0: 20 3a 20 30 29 3b 0a 20 20 20 20 69 66 28 20 6d   : 0);.    if( m
eb00: 65 6d 31 2e 66 6c 61 67 73 20 26 20 4d 45 4d 5f  em1.flags & MEM_
eb10: 44 79 6e 20 29 20 73 71 6c 69 74 65 33 56 64 62  Dyn ) sqlite3Vdb
eb20: 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d  eMemRelease(&mem
eb30: 31 29 3b 0a 20 20 20 20 69 66 28 20 6d 65 6d 32  1);.    if( mem2
eb40: 2e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 44 79 6e  .flags & MEM_Dyn
eb50: 20 29 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65   ) sqlite3VdbeMe
eb60: 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d 32 29 3b  mRelease(&mem2);
eb70: 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30 20 29  .    if( rc!=0 )
eb80: 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20  {.      break;. 
eb90: 20 20 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20 20     }.    i++;.  
eba0: 7d 0a 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66 20 74  }..  /* One of t
ebb0: 68 65 20 6b 65 79 73 20 72 61 6e 20 6f 75 74 20  he keys ran out 
ebc0: 6f 66 20 66 69 65 6c 64 73 2c 20 62 75 74 20 61  of fields, but a
ebd0: 6c 6c 20 74 68 65 20 66 69 65 6c 64 73 20 75 70  ll the fields up
ebe0: 20 74 6f 20 74 68 61 74 20 70 6f 69 6e 74 0a 20   to that point. 
ebf0: 20 2a 2a 20 77 65 72 65 20 65 71 75 61 6c 2e 20   ** were equal. 
ec00: 49 66 20 74 68 65 20 69 6e 63 72 4b 65 79 20 66  If the incrKey f
ec10: 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68 65  lag is true, the
ec20: 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 6b 65 79  n the second key
ec30: 20 69 73 0a 20 20 2a 2a 20 74 72 65 61 74 65 64   is.  ** treated
ec40: 20 61 73 20 6c 61 72 67 65 72 2e 0a 20 20 2a 2f   as larger..  */
ec50: 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b 0a  .  if( rc==0 ){.
ec60: 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f      if( pKeyInfo
ec70: 2d 3e 69 6e 63 72 4b 65 79 20 29 7b 0a 20 20 20  ->incrKey ){.   
ec80: 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20     rc = -1;.    
ec90: 7d 65 6c 73 65 20 69 66 28 20 64 31 3c 6e 4b 65  }else if( d1<nKe
eca0: 79 31 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d  y1 ){.      rc =
ecb0: 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66   1;.    }else if
ecc0: 28 20 64 32 3c 6e 4b 65 79 32 20 29 7b 0a 20 20  ( d2<nKey2 ){.  
ecd0: 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20      rc = -1;.   
ece0: 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70   }.  }else if( p
ecf0: 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72  KeyInfo->aSortOr
ed00: 64 65 72 20 26 26 20 69 3c 70 4b 65 79 49 6e 66  der && i<pKeyInf
ed10: 6f 2d 3e 6e 46 69 65 6c 64 0a 20 20 20 20 20 20  o->nField.      
ed20: 20 20 20 20 20 20 20 20 20 26 26 20 70 4b 65 79           && pKey
ed30: 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72  Info->aSortOrder
ed40: 5b 69 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  [i] ){.    rc = 
ed50: 2d 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75  -rc;.  }..  retu
ed60: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  rn rc;.}../*.** 
ed70: 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73 20  The argument is 
ed80: 61 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63  an index entry c
ed90: 6f 6d 70 6f 73 65 64 20 75 73 69 6e 67 20 74 68  omposed using th
eda0: 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20  e OP_MakeRecord 
edb0: 6f 70 63 6f 64 65 2e 0a 2a 2a 20 54 68 65 20 6c  opcode..** The l
edc0: 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68 69  ast entry in thi
edd0: 73 20 72 65 63 6f 72 64 20 73 68 6f 75 6c 64 20  s record should 
ede0: 62 65 20 61 6e 20 69 6e 74 65 67 65 72 20 28 73  be an integer (s
edf0: 70 65 63 69 66 69 63 61 6c 6c 79 0a 2a 2a 20 61  pecifically.** a
ee00: 6e 20 69 6e 74 65 67 65 72 20 72 6f 77 69 64 29  n integer rowid)
ee10: 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  .  This routine 
ee20: 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d 62  returns the numb
ee30: 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 0a 2a  er of bytes in.*
ee40: 2a 20 74 68 61 74 20 69 6e 74 65 67 65 72 2e 0a  * that integer..
ee50: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
ee60: 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 63 6f  beIdxRowidLen(co
ee70: 6e 73 74 20 75 38 20 2a 61 4b 65 79 29 7b 0a 20  nst u8 *aKey){. 
ee80: 20 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20 20   u32 szHdr;     
ee90: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68     /* Size of th
eea0: 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33  e header */.  u3
eeb0: 32 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20 20  2 typeRowid;    
eec0: 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 6f  /* Serial type o
eed0: 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 0a  f the rowid */..
eee0: 20 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69    sqlite3GetVari
eef0: 6e 74 33 32 28 61 4b 65 79 2c 20 26 73 7a 48 64  nt32(aKey, &szHd
ef00: 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 65 74  r);.  sqlite3Get
ef10: 56 61 72 69 6e 74 33 32 28 26 61 4b 65 79 5b 73  Varint32(&aKey[s
ef20: 7a 48 64 72 2d 31 5d 2c 20 26 74 79 70 65 52 6f  zHdr-1], &typeRo
ef30: 77 69 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 73  wid);.  return s
ef40: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
ef50: 54 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77 69  TypeLen(typeRowi
ef60: 64 29 3b 0a 7d 0a 20 20 0a 0a 2f 2a 0a 2a 2a 20  d);.}.  ../*.** 
ef70: 70 43 75 72 20 70 6f 69 6e 74 73 20 61 74 20 61  pCur points at a
ef80: 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63 72  n index entry cr
ef90: 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 65 20  eated using the 
efa0: 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70  OP_MakeRecord op
efb0: 63 6f 64 65 2e 0a 2a 2a 20 52 65 61 64 20 74 68  code..** Read th
efc0: 65 20 72 6f 77 69 64 20 28 74 68 65 20 6c 61 73  e rowid (the las
efd0: 74 20 66 69 65 6c 64 20 69 6e 20 74 68 65 20 72  t field in the r
efe0: 65 63 6f 72 64 29 20 61 6e 64 20 73 74 6f 72 65  ecord) and store
eff0: 20 69 74 20 69 6e 20 2a 72 6f 77 69 64 2e 0a 2a   it in *rowid..*
f000: 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  * Return SQLITE_
f010: 4f 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e 67  OK if everything
f020: 20 77 6f 72 6b 73 2c 20 6f 72 20 61 6e 20 65 72   works, or an er
f030: 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77 69  ror code otherwi
f040: 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  se..*/.int sqlit
f050: 65 33 56 64 62 65 49 64 78 52 6f 77 69 64 28 42  e3VdbeIdxRowid(B
f060: 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69  tCursor *pCur, i
f070: 36 34 20 2a 72 6f 77 69 64 29 7b 0a 20 20 69 36  64 *rowid){.  i6
f080: 34 20 6e 43 65 6c 6c 4b 65 79 20 3d 20 30 3b 0a  4 nCellKey = 0;.
f090: 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 32 20    int rc;.  u32 
f0a0: 73 7a 48 64 72 3b 20 20 20 20 20 20 20 20 2f 2a  szHdr;        /*
f0b0: 20 53 69 7a 65 20 6f 66 20 74 68 65 20 68 65 61   Size of the hea
f0c0: 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 74 79 70  der */.  u32 typ
f0d0: 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a 20 53 65  eRowid;    /* Se
f0e0: 72 69 61 6c 20 74 79 70 65 20 6f 66 20 74 68 65  rial type of the
f0f0: 20 72 6f 77 69 64 20 2a 2f 0a 20 20 75 33 32 20   rowid */.  u32 
f100: 6c 65 6e 52 6f 77 69 64 3b 20 20 20 20 20 2f 2a  lenRowid;     /*
f110: 20 53 69 7a 65 20 6f 66 20 74 68 65 20 72 6f 77   Size of the row
f120: 69 64 20 2a 2f 0a 20 20 4d 65 6d 20 6d 2c 20 76  id */.  Mem m, v
f130: 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65  ;..  sqlite3Btre
f140: 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c 20 26  eKeySize(pCur, &
f150: 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 69 66 28  nCellKey);.  if(
f160: 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a   nCellKey<=0 ){.
f170: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
f180: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a  E_CORRUPT_BKPT;.
f190: 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74    }.  rc = sqlit
f1a0: 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72  e3VdbeMemFromBtr
f1b0: 65 65 28 70 43 75 72 2c 20 30 2c 20 6e 43 65 6c  ee(pCur, 0, nCel
f1c0: 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20 20  lKey, 1, &m);.  
f1d0: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72 65  if( rc ){.    re
f1e0: 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 73  turn rc;.  }.  s
f1f0: 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33  qlite3GetVarint3
f200: 32 28 28 75 38 2a 29 6d 2e 7a 2c 20 26 73 7a 48  2((u8*)m.z, &szH
f210: 64 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 65  dr);.  sqlite3Ge
f220: 74 56 61 72 69 6e 74 33 32 28 28 75 38 2a 29 26  tVarint32((u8*)&
f230: 6d 2e 7a 5b 73 7a 48 64 72 2d 31 5d 2c 20 26 74  m.z[szHdr-1], &t
f240: 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 6c 65 6e  ypeRowid);.  len
f250: 52 6f 77 69 64 20 3d 20 73 71 6c 69 74 65 33 56  Rowid = sqlite3V
f260: 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e  dbeSerialTypeLen
f270: 28 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 73  (typeRowid);.  s
f280: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
f290: 47 65 74 28 28 75 38 2a 29 26 6d 2e 7a 5b 6d 2e  Get((u8*)&m.z[m.
f2a0: 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20 74 79 70  n-lenRowid], typ
f2b0: 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a 20 20 2a  eRowid, &v);.  *
f2c0: 72 6f 77 69 64 20 3d 20 76 2e 75 2e 69 3b 0a 20  rowid = v.u.i;. 
f2d0: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52   sqlite3VdbeMemR
f2e0: 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20 72 65  elease(&m);.  re
f2f0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
f300: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65  }../*.** Compare
f310: 20 74 68 65 20 6b 65 79 20 6f 66 20 74 68 65 20   the key of the 
f320: 69 6e 64 65 78 20 65 6e 74 72 79 20 74 68 61 74  index entry that
f330: 20 63 75 72 73 6f 72 20 70 43 20 69 73 20 70 6f   cursor pC is po
f340: 69 6e 74 20 74 6f 20 61 67 61 69 6e 73 74 0a 2a  int to against.*
f350: 2a 20 74 68 65 20 6b 65 79 20 73 74 72 69 6e 67  * the key string
f360: 20 69 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65 6e   in pKey (of len
f370: 67 74 68 20 6e 4b 65 79 29 2e 20 20 57 72 69 74  gth nKey).  Writ
f380: 65 20 69 6e 74 6f 20 2a 70 52 65 73 20 61 20 6e  e into *pRes a n
f390: 75 6d 62 65 72 0a 2a 2a 20 74 68 61 74 20 69 73  umber.** that is
f3a0: 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 2c   negative, zero,
f3b0: 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 66 20   or positive if 
f3c0: 70 43 20 69 73 20 6c 65 73 73 20 74 68 61 6e 2c  pC is less than,
f3d0: 20 65 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f 72   equal to,.** or
f3e0: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70 4b   greater than pK
f3f0: 65 79 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49  ey.  Return SQLI
f400: 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73  TE_OK on success
f410: 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73 20  ..**.** pKey is 
f420: 65 69 74 68 65 72 20 63 72 65 61 74 65 64 20 77  either created w
f430: 69 74 68 6f 75 74 20 61 20 72 6f 77 69 64 20 6f  ithout a rowid o
f440: 72 20 69 73 20 74 72 75 6e 63 61 74 65 64 20 73  r is truncated s
f450: 6f 20 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d 69  o that it.** omi
f460: 74 73 20 74 68 65 20 72 6f 77 69 64 20 61 74 20  ts the rowid at 
f470: 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20 72 6f  the end.  The ro
f480: 77 69 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f  wid at the end o
f490: 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74 72  f the index entr
f4a0: 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64 20  y.** is ignored 
f4b0: 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74 20  as well..*/.int 
f4c0: 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65  sqlite3VdbeIdxKe
f4d0: 79 43 6f 6d 70 61 72 65 28 0a 20 20 43 75 72 73  yCompare(.  Curs
f4e0: 6f 72 20 2a 70 43 2c 20 20 20 20 20 20 20 20 20  or *pC,         
f4f0: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63          /* The c
f500: 75 72 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72 65  ursor to compare
f510: 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e   against */.  in
f520: 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38  t nKey, const u8
f530: 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68 65   *pKey,   /* The
f540: 20 6b 65 79 20 74 6f 20 63 6f 6d 70 61 72 65 20   key to compare 
f550: 2a 2f 0a 20 20 69 6e 74 20 2a 72 65 73 20 20 20  */.  int *res   
f560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
f570: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63 6f   /* Write the co
f580: 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20  mparison result 
f590: 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36 34  here */.){.  i64
f5a0: 20 6e 43 65 6c 6c 4b 65 79 20 3d 20 30 3b 0a 20   nCellKey = 0;. 
f5b0: 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75 72   int rc;.  BtCur
f5c0: 73 6f 72 20 2a 70 43 75 72 20 3d 20 70 43 2d 3e  sor *pCur = pC->
f5d0: 70 43 75 72 73 6f 72 3b 0a 20 20 69 6e 74 20 6c  pCursor;.  int l
f5e0: 65 6e 52 6f 77 69 64 3b 0a 20 20 4d 65 6d 20 6d  enRowid;.  Mem m
f5f0: 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65  ;..  sqlite3Btre
f600: 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c 20 26  eKeySize(pCur, &
f610: 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 69 66 28  nCellKey);.  if(
f620: 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a   nCellKey<=0 ){.
f630: 20 20 20 20 2a 72 65 73 20 3d 20 30 3b 0a 20 20      *res = 0;.  
f640: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
f650: 4f 4b 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73  OK;.  }.  rc = s
f660: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46 72 6f  qlite3VdbeMemFro
f670: 6d 42 74 72 65 65 28 70 43 2d 3e 70 43 75 72 73  mBtree(pC->pCurs
f680: 6f 72 2c 20 30 2c 20 6e 43 65 6c 6c 4b 65 79 2c  or, 0, nCellKey,
f690: 20 31 2c 20 26 6d 29 3b 0a 20 20 69 66 28 20 72   1, &m);.  if( r
f6a0: 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  c ){.    return 
f6b0: 72 63 3b 0a 20 20 7d 0a 20 20 6c 65 6e 52 6f 77  rc;.  }.  lenRow
f6c0: 69 64 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  id = sqlite3Vdbe
f6d0: 49 64 78 52 6f 77 69 64 4c 65 6e 28 28 75 38 2a  IdxRowidLen((u8*
f6e0: 29 6d 2e 7a 29 3b 0a 20 20 2a 72 65 73 20 3d 20  )m.z);.  *res = 
f6f0: 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72  sqlite3VdbeRecor
f700: 64 43 6f 6d 70 61 72 65 28 70 43 2d 3e 70 4b 65  dCompare(pC->pKe
f710: 79 49 6e 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52 6f  yInfo, m.n-lenRo
f720: 77 69 64 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c 20  wid, m.z, nKey, 
f730: 70 4b 65 79 29 3b 0a 20 20 73 71 6c 69 74 65 33  pKey);.  sqlite3
f740: 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26  VdbeMemRelease(&
f750: 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  m);.  return SQL
f760: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
f770: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65   This routine se
f780: 74 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f 20  ts the value to 
f790: 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20 73  be returned by s
f7a0: 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73 20  ubsequent calls 
f7b0: 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63 68  to.** sqlite3_ch
f7c0: 61 6e 67 65 73 28 29 20 6f 6e 20 74 68 65 20 64  anges() on the d
f7d0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 27  atabase handle '
f7e0: 64 62 27 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73 71  db'. .*/.void sq
f7f0: 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61 6e  lite3VdbeSetChan
f800: 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  ges(sqlite3 *db,
f810: 20 69 6e 74 20 6e 43 68 61 6e 67 65 29 7b 0a 20   int nChange){. 
f820: 20 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 6e   db->nChange = n
f830: 43 68 61 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e 54  Change;.  db->nT
f840: 6f 74 61 6c 43 68 61 6e 67 65 20 2b 3d 20 6e 43  otalChange += nC
f850: 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  hange;.}../*.** 
f860: 53 65 74 20 61 20 66 6c 61 67 20 69 6e 20 74 68  Set a flag in th
f870: 65 20 76 64 62 65 20 74 6f 20 75 70 64 61 74 65  e vdbe to update
f880: 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f 75 6e   the change coun
f890: 74 65 72 20 77 68 65 6e 20 69 74 20 69 73 20 66  ter when it is f
f8a0: 69 6e 61 6c 69 73 65 64 0a 2a 2a 20 6f 72 20 72  inalised.** or r
f8b0: 65 73 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  eset..*/.void sq
f8c0: 6c 69 74 65 33 56 64 62 65 43 6f 75 6e 74 43 68  lite3VdbeCountCh
f8d0: 61 6e 67 65 73 28 56 64 62 65 20 2a 76 29 7b 0a  anges(Vdbe *v){.
f8e0: 20 20 76 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e    v->changeCntOn
f8f0: 20 3d 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d   = 1;.}../*.** M
f900: 61 72 6b 20 65 76 65 72 79 20 70 72 65 70 61 72  ark every prepar
f910: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 73 73  ed statement ass
f920: 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 64  ociated with a d
f930: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
f940: 6f 6e 0a 2a 2a 20 61 73 20 65 78 70 69 72 65 64  on.** as expired
f950: 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 69 72  ..**.** An expir
f960: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 6d 65 61  ed statement mea
f970: 6e 73 20 74 68 61 74 20 72 65 63 6f 6d 70 69 6c  ns that recompil
f980: 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 74 61  ation of the sta
f990: 74 65 6d 65 6e 74 20 69 73 0a 2a 2a 20 72 65 63  tement is.** rec
f9a0: 6f 6d 6d 65 6e 64 2e 20 20 53 74 61 74 65 6d 65  ommend.  Stateme
f9b0: 6e 74 73 20 65 78 70 69 72 65 20 77 68 65 6e 20  nts expire when 
f9c0: 74 68 69 6e 67 73 20 68 61 70 70 65 6e 20 74 68  things happen th
f9d0: 61 74 20 6d 61 6b 65 20 74 68 65 69 72 0a 2a 2a  at make their.**
f9e0: 20 70 72 6f 67 72 61 6d 73 20 6f 62 73 6f 6c 65   programs obsole
f9f0: 74 65 2e 20 20 52 65 6d 6f 76 69 6e 67 20 75 73  te.  Removing us
fa00: 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63 74  er-defined funct
fa10: 69 6f 6e 73 20 6f 72 20 63 6f 6c 6c 61 74 69 6e  ions or collatin
fa20: 67 0a 2a 2a 20 73 65 71 75 65 6e 63 65 73 2c 20  g.** sequences, 
fa30: 6f 72 20 63 68 61 6e 67 69 6e 67 20 61 6e 20 61  or changing an a
fa40: 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75 6e  uthorization fun
fa50: 63 74 69 6f 6e 20 61 72 65 20 74 68 65 20 74 79  ction are the ty
fa60: 70 65 73 20 6f 66 0a 2a 2a 20 74 68 69 6e 67 73  pes of.** things
fa70: 20 74 68 61 74 20 6d 61 6b 65 20 70 72 65 70 61   that make prepa
fa80: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 20 6f  red statements o
fa90: 62 73 6f 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69 64  bsolete..*/.void
faa0: 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50 72   sqlite3ExpirePr
fab0: 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74 73  eparedStatements
fac0: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
fad0: 20 56 64 62 65 20 2a 70 3b 0a 20 20 66 6f 72 28   Vdbe *p;.  for(
fae0: 70 20 3d 20 64 62 2d 3e 70 56 64 62 65 3b 20 70  p = db->pVdbe; p
faf0: 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20  ; p=p->pNext){. 
fb00: 20 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d 20     p->expired = 
fb10: 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  1;.  }.}../*.** 
fb20: 52 65 74 75 72 6e 20 74 68 65 20 64 61 74 61 62  Return the datab
fb30: 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20 77  ase associated w
fb40: 69 74 68 20 74 68 65 20 56 64 62 65 2e 0a 2a 2f  ith the Vdbe..*/
fb50: 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74 65  .sqlite3 *sqlite
fb60: 33 56 64 62 65 44 62 28 56 64 62 65 20 2a 76 29  3VdbeDb(Vdbe *v)
fb70: 7b 0a 20 20 72 65 74 75 72 6e 20 76 2d 3e 64 62  {.  return v->db
fb80: 3b 0a 7d 0a                                      ;.}.