/ Hex Artifact Content
Login

Artifact a978d170b2ca99c8ff3da8a91f116a66da2600ac:


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 28 75 6e 73 69  0; isspace((unsi
5610: 67 6e 65 64 20 63 68 61 72 29 7a 5b 69 5d 29 3b  gned char)z[i]);
5620: 20 69 2b 2b 29 7b 7d 0a 20 20 20 20 66 6f 72 28   i++){}.    for(
5630: 6a 3d 30 3b 20 7a 5b 69 5d 3b 20 69 2b 2b 29 7b  j=0; z[i]; i++){
5640: 0a 20 20 20 20 20 20 69 66 28 20 69 73 73 70 61  .      if( isspa
5650: 63 65 28 28 75 6e 73 69 67 6e 65 64 20 63 68 61  ce((unsigned cha
5660: 72 29 7a 5b 69 5d 29 20 29 7b 0a 20 20 20 20 20  r)z[i]) ){.     
5670: 20 20 20 69 66 28 20 7a 5b 69 2d 31 5d 21 3d 27     if( z[i-1]!='
5680: 20 27 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20   ' ){.          
5690: 7a 5b 6a 2b 2b 5d 20 3d 20 27 20 27 3b 0a 20 20  z[j++] = ' ';.  
56a0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65        }.      }e
56b0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 7a 5b 6a  lse{.        z[j
56c0: 2b 2b 5d 20 3d 20 7a 5b 69 5d 3b 0a 20 20 20 20  ++] = z[i];.    
56d0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 7a 5b    }.    }.    z[
56e0: 6a 5d 20 3d 20 30 3b 0a 20 20 20 20 73 71 6c 69  j] = 0;.    sqli
56f0: 74 65 33 5f 69 6f 5f 74 72 61 63 65 28 22 53 51  te3_io_trace("SQ
5700: 4c 20 25 73 5c 6e 22 2c 20 7a 29 3b 0a 20 20 20  L %s\n", z);.   
5710: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 29 3b 0a   sqliteFree(z);.
5720: 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20    }.}.#endif /* 
5730: 21 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 41  !SQLITE_OMIT_TRA
5740: 43 45 20 26 26 20 53 51 4c 49 54 45 5f 45 4e 41  CE && SQLITE_ENA
5750: 42 4c 45 5f 49 4f 54 52 41 43 45 20 2a 2f 0a 0a  BLE_IOTRACE */..
5760: 0a 2f 2a 0a 2a 2a 20 50 72 65 70 61 72 65 20 61  ./*.** Prepare a
5770: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
5780: 20 66 6f 72 20 65 78 65 63 75 74 69 6f 6e 2e 20   for execution. 
5790: 20 54 68 69 73 20 69 6e 76 6f 6c 76 65 73 20 74   This involves t
57a0: 68 69 6e 67 73 20 73 75 63 68 0a 2a 2a 20 61 73  hings such.** as
57b0: 20 61 6c 6c 6f 63 61 74 69 6e 67 20 73 74 61 63   allocating stac
57c0: 6b 20 73 70 61 63 65 20 61 6e 64 20 69 6e 69 74  k space and init
57d0: 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 70 72 6f  ializing the pro
57e0: 67 72 61 6d 20 63 6f 75 6e 74 65 72 2e 0a 2a 2a  gram counter..**
57f0: 20 41 66 74 65 72 20 74 68 65 20 56 44 42 45 20   After the VDBE 
5800: 68 61 73 20 62 65 20 70 72 65 70 70 65 64 2c 20  has be prepped, 
5810: 69 74 20 63 61 6e 20 62 65 20 65 78 65 63 75 74  it can be execut
5820: 65 64 20 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72  ed by one or mor
5830: 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71  e.** calls to sq
5840: 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 29 2e  lite3VdbeExec().
5850: 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73    .**.** This is
5860: 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f   the only way to
5870: 20 6d 6f 76 65 20 61 20 56 44 42 45 20 66 72 6f   move a VDBE fro
5880: 6d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  m VDBE_MAGIC_INI
5890: 54 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47  T to.** VDBE_MAG
58a0: 49 43 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69 64 20  IC_RUN..*/.void 
58b0: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52  sqlite3VdbeMakeR
58c0: 65 61 64 79 28 0a 20 20 56 64 62 65 20 2a 70 2c  eady(.  Vdbe *p,
58d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
58e0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56 44         /* The VD
58f0: 42 45 20 2a 2f 0a 20 20 69 6e 74 20 6e 56 61 72  BE */.  int nVar
5900: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
5910: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
5920: 20 6f 66 20 27 3f 27 20 73 65 65 20 69 6e 20 74   of '?' see in t
5930: 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  he SQL statement
5940: 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d 2c 20   */.  int nMem, 
5950: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5960: 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f       /* Number o
5970: 66 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73 20 74  f memory cells t
5980: 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a 20 20  o allocate */.  
5990: 69 6e 74 20 6e 43 75 72 73 6f 72 2c 20 20 20 20  int nCursor,    
59a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
59b0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 75 72 73  * Number of curs
59c0: 6f 72 73 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20  ors to allocate 
59d0: 2a 2f 0a 20 20 69 6e 74 20 69 73 45 78 70 6c 61  */.  int isExpla
59e0: 69 6e 20 20 20 20 20 20 20 20 20 20 20 20 20 20  in              
59f0: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 74      /* True if t
5a00: 68 65 20 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f  he EXPLAIN keywo
5a10: 72 64 73 20 69 73 20 70 72 65 73 65 6e 74 20 2a  rds is present *
5a20: 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a 0a 20  /.){.  int n;.. 
5a30: 20 61 73 73 65 72 74 28 20 70 21 3d 30 20 29 3b   assert( p!=0 );
5a40: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61  .  assert( p->ma
5a50: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
5a60: 49 4e 49 54 20 29 3b 0a 0a 20 20 2f 2a 20 54 68  INIT );..  /* Th
5a70: 65 72 65 20 73 68 6f 75 6c 64 20 62 65 20 61 74  ere should be at
5a80: 20 6c 65 61 73 74 20 6f 6e 65 20 6f 70 63 6f 64   least one opcod
5a90: 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74  e..  */.  assert
5aa0: 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 0a 20  ( p->nOp>0 );.. 
5ab0: 20 2f 2a 20 53 65 74 20 74 68 65 20 6d 61 67 69   /* Set the magi
5ac0: 63 20 74 6f 20 56 44 42 45 5f 4d 41 47 49 43 5f  c to VDBE_MAGIC_
5ad0: 52 55 4e 20 73 6f 6f 6e 65 72 20 72 61 74 68 65  RUN sooner rathe
5ae0: 72 20 74 68 61 6e 20 6c 61 74 65 72 2e 20 54 68  r than later. Th
5af0: 69 73 0a 20 20 20 2a 20 69 73 20 62 65 63 61 75  is.   * is becau
5b00: 73 65 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 72  se the call to r
5b10: 65 73 69 7a 65 4f 70 41 72 72 61 79 28 29 20 62  esizeOpArray() b
5b20: 65 6c 6f 77 20 6d 61 79 20 73 68 72 69 6e 6b 20  elow may shrink 
5b30: 74 68 65 0a 20 20 20 2a 20 70 2d 3e 61 4f 70 5b  the.   * p->aOp[
5b40: 5d 20 61 72 72 61 79 20 74 6f 20 73 61 76 65 20  ] array to save 
5b50: 6d 65 6d 6f 72 79 20 69 66 20 63 61 6c 6c 65 64  memory if called
5b60: 20 77 68 65 6e 20 69 6e 20 56 44 42 45 5f 4d 41   when in VDBE_MA
5b70: 47 49 43 5f 52 55 4e 20 0a 20 20 20 2a 20 73 74  GIC_RUN .   * st
5b80: 61 74 65 2e 0a 20 20 20 2a 2f 0a 20 20 70 2d 3e  ate..   */.  p->
5b90: 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47  magic = VDBE_MAG
5ba0: 49 43 5f 52 55 4e 3b 0a 0a 20 20 2f 2a 20 4e 6f  IC_RUN;..  /* No
5bb0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 65 76 65   instruction eve
5bc0: 72 20 70 75 73 68 65 73 20 6d 6f 72 65 20 74 68  r pushes more th
5bd0: 61 6e 20 61 20 73 69 6e 67 6c 65 20 65 6c 65 6d  an a single elem
5be0: 65 6e 74 20 6f 6e 74 6f 20 74 68 65 0a 20 20 2a  ent onto the.  *
5bf0: 2a 20 73 74 61 63 6b 2e 20 20 41 6e 64 20 74 68  * stack.  And th
5c00: 65 20 73 74 61 63 6b 20 6e 65 76 65 72 20 67 72  e stack never gr
5c10: 6f 77 73 20 6f 6e 20 73 75 63 63 65 73 73 69 76  ows on successiv
5c20: 65 20 65 78 65 63 75 74 69 6f 6e 73 20 6f 66 20  e executions of 
5c30: 74 68 65 0a 20 20 2a 2a 20 73 61 6d 65 20 6c 6f  the.  ** same lo
5c40: 6f 70 2e 20 20 53 6f 20 74 68 65 20 74 6f 74 61  op.  So the tota
5c50: 6c 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e 73 74  l number of inst
5c60: 72 75 63 74 69 6f 6e 73 20 69 73 20 61 6e 20 75  ructions is an u
5c70: 70 70 65 72 20 62 6f 75 6e 64 0a 20 20 2a 2a 20  pper bound.  ** 
5c80: 6f 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 73  on the maximum s
5c90: 74 61 63 6b 20 64 65 70 74 68 20 72 65 71 75 69  tack depth requi
5ca0: 72 65 64 2e 20 20 28 41 64 64 65 64 20 6c 61 74  red.  (Added lat
5cb0: 65 72 3a 29 20 20 54 68 65 0a 20 20 2a 2a 20 72  er:)  The.  ** r
5cc0: 65 73 6f 6c 76 65 50 32 56 61 6c 75 65 73 28 29  esolveP2Values()
5cd0: 20 63 61 6c 6c 20 63 6f 6d 70 75 74 65 73 20 61   call computes a
5ce0: 20 74 69 67 68 74 65 72 20 75 70 70 65 72 20 62   tighter upper b
5cf0: 6f 75 6e 64 20 6f 6e 20 74 68 65 0a 20 20 2a 2a  ound on the.  **
5d00: 20 73 74 61 63 6b 20 73 69 7a 65 2e 0a 20 20 2a   stack size..  *
5d10: 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61 74 69 6f  *.  ** Allocatio
5d20: 6e 20 61 6c 6c 20 74 68 65 20 73 74 61 63 6b 20  n all the stack 
5d30: 73 70 61 63 65 20 77 65 20 77 69 6c 6c 20 65 76  space we will ev
5d40: 65 72 20 6e 65 65 64 2e 0a 20 20 2a 2f 0a 20 20  er need..  */.  
5d50: 69 66 28 20 70 2d 3e 61 53 74 61 63 6b 3d 3d 30  if( p->aStack==0
5d60: 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 41 72 67   ){.    int nArg
5d70: 3b 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d  ;       /* Maxim
5d80: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 61 72 67  um number of arg
5d90: 73 20 70 61 73 73 65 64 20 74 6f 20 61 20 75 73  s passed to a us
5da0: 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a  er function. */.
5db0: 20 20 20 20 69 6e 74 20 6e 53 74 61 63 6b 3b 20      int nStack; 
5dc0: 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e      /* Maximum n
5dd0: 75 6d 62 65 72 20 6f 66 20 73 74 61 63 6b 20 65  umber of stack e
5de0: 6e 74 72 69 65 73 20 72 65 71 75 69 72 65 64 20  ntries required 
5df0: 2a 2f 0a 20 20 20 20 72 65 73 6f 6c 76 65 50 32  */.    resolveP2
5e00: 56 61 6c 75 65 73 28 70 2c 20 26 6e 41 72 67 2c  Values(p, &nArg,
5e10: 20 26 6e 53 74 61 63 6b 29 3b 0a 20 20 20 20 72   &nStack);.    r
5e20: 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c 20  esizeOpArray(p, 
5e30: 70 2d 3e 6e 4f 70 29 3b 0a 20 20 20 20 61 73 73  p->nOp);.    ass
5e40: 65 72 74 28 20 6e 56 61 72 3e 3d 30 20 29 3b 0a  ert( nVar>=0 );.
5e50: 20 20 20 20 61 73 73 65 72 74 28 20 6e 53 74 61      assert( nSta
5e60: 63 6b 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 20  ck<p->nOp );.   
5e70: 20 69 66 28 20 69 73 45 78 70 6c 61 69 6e 20 29   if( isExplain )
5e80: 7b 0a 20 20 20 20 20 20 6e 53 74 61 63 6b 20 3d  {.      nStack =
5e90: 20 31 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70   10;.    }.    p
5ea0: 2d 3e 61 53 74 61 63 6b 20 3d 20 73 71 6c 69 74  ->aStack = sqlit
5eb0: 65 4d 61 6c 6c 6f 63 28 0a 20 20 20 20 20 20 20  eMalloc(.       
5ec0: 20 6e 53 74 61 63 6b 2a 73 69 7a 65 6f 66 28 70   nStack*sizeof(p
5ed0: 2d 3e 61 53 74 61 63 6b 5b 30 5d 29 20 20 20 20  ->aStack[0])    
5ee0: 2f 2a 20 61 53 74 61 63 6b 20 2a 2f 0a 20 20 20  /* aStack */.   
5ef0: 20 20 20 2b 20 6e 41 72 67 2a 73 69 7a 65 6f 66     + nArg*sizeof
5f00: 28 4d 65 6d 2a 29 20 20 20 20 20 20 20 20 20 20  (Mem*)          
5f10: 20 20 20 20 2f 2a 20 61 70 41 72 67 20 2a 2f 0a      /* apArg */.
5f20: 20 20 20 20 20 20 2b 20 6e 56 61 72 2a 73 69 7a        + nVar*siz
5f30: 65 6f 66 28 4d 65 6d 29 20 20 20 20 20 20 20 20  eof(Mem)        
5f40: 20 20 20 20 20 20 20 2f 2a 20 61 56 61 72 20 2a         /* aVar *
5f50: 2f 0a 20 20 20 20 20 20 2b 20 6e 56 61 72 2a 73  /.      + nVar*s
5f60: 69 7a 65 6f 66 28 63 68 61 72 2a 29 20 20 20 20  izeof(char*)    
5f70: 20 20 20 20 20 20 20 20 20 2f 2a 20 61 7a 56 61           /* azVa
5f80: 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 4d 65  r */.      + nMe
5f90: 6d 2a 73 69 7a 65 6f 66 28 4d 65 6d 29 20 20 20  m*sizeof(Mem)   
5fa0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61              /* a
5fb0: 4d 65 6d 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e  Mem */.      + n
5fc0: 43 75 72 73 6f 72 2a 73 69 7a 65 6f 66 28 43 75  Cursor*sizeof(Cu
5fd0: 72 73 6f 72 2a 29 20 20 20 20 20 20 20 20 2f 2a  rsor*)        /*
5fe0: 20 61 70 43 73 72 20 2a 2f 0a 20 20 20 20 29 3b   apCsr */.    );
5ff0: 0a 20 20 20 20 69 66 28 20 21 73 71 6c 69 74 65  .    if( !sqlite
6000: 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20  3MallocFailed() 
6010: 29 7b 0a 20 20 20 20 20 20 70 2d 3e 61 4d 65 6d  ){.      p->aMem
6020: 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b 6e 53   = &p->aStack[nS
6030: 74 61 63 6b 5d 3b 0a 20 20 20 20 20 20 70 2d 3e  tack];.      p->
6040: 6e 4d 65 6d 20 3d 20 6e 4d 65 6d 3b 0a 20 20 20  nMem = nMem;.   
6050: 20 20 20 70 2d 3e 61 56 61 72 20 3d 20 26 70 2d     p->aVar = &p-
6060: 3e 61 4d 65 6d 5b 6e 4d 65 6d 5d 3b 0a 20 20 20  >aMem[nMem];.   
6070: 20 20 20 70 2d 3e 6e 56 61 72 20 3d 20 6e 56 61     p->nVar = nVa
6080: 72 3b 0a 20 20 20 20 20 20 70 2d 3e 6f 6b 56 61  r;.      p->okVa
6090: 72 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d 3e  r = 0;.      p->
60a0: 61 70 41 72 67 20 3d 20 28 4d 65 6d 2a 2a 29 26  apArg = (Mem**)&
60b0: 70 2d 3e 61 56 61 72 5b 6e 56 61 72 5d 3b 0a 20  p->aVar[nVar];. 
60c0: 20 20 20 20 20 70 2d 3e 61 7a 56 61 72 20 3d 20       p->azVar = 
60d0: 28 63 68 61 72 2a 2a 29 26 70 2d 3e 61 70 41 72  (char**)&p->apAr
60e0: 67 5b 6e 41 72 67 5d 3b 0a 20 20 20 20 20 20 70  g[nArg];.      p
60f0: 2d 3e 61 70 43 73 72 20 3d 20 28 43 75 72 73 6f  ->apCsr = (Curso
6100: 72 2a 2a 29 26 70 2d 3e 61 7a 56 61 72 5b 6e 56  r**)&p->azVar[nV
6110: 61 72 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 43  ar];.      p->nC
6120: 75 72 73 6f 72 20 3d 20 6e 43 75 72 73 6f 72 3b  ursor = nCursor;
6130: 0a 20 20 20 20 20 20 66 6f 72 28 6e 3d 30 3b 20  .      for(n=0; 
6140: 6e 3c 6e 56 61 72 3b 20 6e 2b 2b 29 7b 0a 20 20  n<nVar; n++){.  
6150: 20 20 20 20 20 20 70 2d 3e 61 56 61 72 5b 6e 5d        p->aVar[n]
6160: 2e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c  .flags = MEM_Nul
6170: 6c 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  l;.      }.    }
6180: 0a 20 20 7d 0a 20 20 66 6f 72 28 6e 3d 30 3b 20  .  }.  for(n=0; 
6190: 6e 3c 70 2d 3e 6e 4d 65 6d 3b 20 6e 2b 2b 29 7b  n<p->nMem; n++){
61a0: 0a 20 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e 5d 2e  .    p->aMem[n].
61b0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
61c0: 3b 0a 20 20 7d 0a 0a 20 20 70 2d 3e 70 54 6f 73  ;.  }..  p->pTos
61d0: 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31   = &p->aStack[-1
61e0: 5d 3b 0a 20 20 70 2d 3e 70 63 20 3d 20 2d 31 3b  ];.  p->pc = -1;
61f0: 0a 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54  .  p->rc = SQLIT
6200: 45 5f 4f 4b 3b 0a 20 20 70 2d 3e 75 6e 69 71 75  E_OK;.  p->uniqu
6210: 65 43 6e 74 20 3d 20 30 3b 0a 20 20 70 2d 3e 72  eCnt = 0;.  p->r
6220: 65 74 75 72 6e 44 65 70 74 68 20 3d 20 30 3b 0a  eturnDepth = 0;.
6230: 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f 6e    p->errorAction
6240: 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20 20 70   = OE_Abort;.  p
6250: 2d 3e 70 6f 70 53 74 61 63 6b 20 3d 20 20 30 3b  ->popStack =  0;
6260: 0a 20 20 70 2d 3e 65 78 70 6c 61 69 6e 20 7c 3d  .  p->explain |=
6270: 20 69 73 45 78 70 6c 61 69 6e 3b 0a 20 20 70 2d   isExplain;.  p-
6280: 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41  >magic = VDBE_MA
6290: 47 49 43 5f 52 55 4e 3b 0a 20 20 70 2d 3e 6e 43  GIC_RUN;.  p->nC
62a0: 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20 70 2d 3e  hange = 0;.  p->
62b0: 63 61 63 68 65 43 74 72 20 3d 20 31 3b 0a 20 20  cacheCtr = 1;.  
62c0: 70 2d 3e 6d 69 6e 57 72 69 74 65 46 69 6c 65 46  p->minWriteFileF
62d0: 6f 72 6d 61 74 20 3d 20 32 35 35 3b 0a 23 69 66  ormat = 255;.#if
62e0: 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45  def VDBE_PROFILE
62f0: 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a  .  {.    int i;.
6300: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
6310: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
6320: 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74     p->aOp[i].cnt
6330: 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d 3e 61   = 0;.      p->a
6340: 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 20 3d 20 30  Op[i].cycles = 0
6350: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64  ;.    }.  }.#end
6360: 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73  if.}../*.** Clos
6370: 65 20 61 20 63 75 72 73 6f 72 20 61 6e 64 20 72  e a cursor and r
6380: 65 6c 65 61 73 65 20 61 6c 6c 20 74 68 65 20 72  elease all the r
6390: 65 73 6f 75 72 63 65 73 20 74 68 61 74 20 63 75  esources that cu
63a0: 72 73 6f 72 20 68 61 70 70 65 6e 73 0a 2a 2a 20  rsor happens.** 
63b0: 74 6f 20 68 6f 6c 64 2e 0a 2a 2f 0a 76 6f 69 64  to hold..*/.void
63c0: 20 73 71 6c 69 74 65 33 56 64 62 65 46 72 65 65   sqlite3VdbeFree
63d0: 43 75 72 73 6f 72 28 56 64 62 65 20 2a 70 2c 20  Cursor(Vdbe *p, 
63e0: 43 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a 20 20  Cursor *pCx){.  
63f0: 69 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a 20 20  if( pCx==0 ){.  
6400: 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20    return;.  }.  
6410: 69 66 28 20 70 43 78 2d 3e 70 43 75 72 73 6f 72  if( pCx->pCursor
6420: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
6430: 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28  treeCloseCursor(
6440: 70 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b 0a 20  pCx->pCursor);. 
6450: 20 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e 70 42   }.  if( pCx->pB
6460: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  t ){.    sqlite3
6470: 42 74 72 65 65 43 6c 6f 73 65 28 70 43 78 2d 3e  BtreeClose(pCx->
6480: 70 42 74 29 3b 0a 20 20 7d 0a 23 69 66 6e 64 65  pBt);.  }.#ifnde
6490: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49  f SQLITE_OMIT_VI
64a0: 52 54 55 41 4c 54 41 42 4c 45 0a 20 20 69 66 28  RTUALTABLE.  if(
64b0: 20 70 43 78 2d 3e 70 56 74 61 62 43 75 72 73 6f   pCx->pVtabCurso
64c0: 72 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  r ){.    sqlite3
64d0: 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a 70 56  _vtab_cursor *pV
64e0: 74 61 62 43 75 72 73 6f 72 20 3d 20 70 43 78 2d  tabCursor = pCx-
64f0: 3e 70 56 74 61 62 43 75 72 73 6f 72 3b 0a 20 20  >pVtabCursor;.  
6500: 20 20 63 6f 6e 73 74 20 73 71 6c 69 74 65 33 5f    const sqlite3_
6510: 6d 6f 64 75 6c 65 20 2a 70 4d 6f 64 75 6c 65 20  module *pModule 
6520: 3d 20 70 43 78 2d 3e 70 4d 6f 64 75 6c 65 3b 0a  = pCx->pModule;.
6530: 20 20 20 20 70 2d 3e 69 6e 56 74 61 62 4d 65 74      p->inVtabMet
6540: 68 6f 64 20 3d 20 31 3b 0a 20 20 20 20 73 71 6c  hod = 1;.    sql
6550: 69 74 65 33 53 61 66 65 74 79 4f 66 66 28 70 2d  ite3SafetyOff(p-
6560: 3e 64 62 29 3b 0a 20 20 20 20 70 4d 6f 64 75 6c  >db);.    pModul
6570: 65 2d 3e 78 43 6c 6f 73 65 28 70 56 74 61 62 43  e->xClose(pVtabC
6580: 75 72 73 6f 72 29 3b 0a 20 20 20 20 73 71 6c 69  ursor);.    sqli
6590: 74 65 33 53 61 66 65 74 79 4f 6e 28 70 2d 3e 64  te3SafetyOn(p->d
65a0: 62 29 3b 0a 20 20 20 20 70 2d 3e 69 6e 56 74 61  b);.    p->inVta
65b0: 62 4d 65 74 68 6f 64 20 3d 20 30 3b 0a 20 20 7d  bMethod = 0;.  }
65c0: 0a 23 65 6e 64 69 66 0a 20 20 73 71 6c 69 74 65  .#endif.  sqlite
65d0: 46 72 65 65 28 70 43 78 2d 3e 70 44 61 74 61 29  Free(pCx->pData)
65e0: 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  ;.  sqliteFree(p
65f0: 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20 73 71  Cx->aType);.  sq
6600: 6c 69 74 65 46 72 65 65 28 70 43 78 29 3b 0a 7d  liteFree(pCx);.}
6610: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6c  ../*.** Close al
6620: 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73 74 61  l cursors.*/.sta
6630: 74 69 63 20 76 6f 69 64 20 63 6c 6f 73 65 41 6c  tic void closeAl
6640: 6c 43 75 72 73 6f 72 73 28 56 64 62 65 20 2a 70  lCursors(Vdbe *p
6650: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66  ){.  int i;.  if
6660: 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20 29 20  ( p->apCsr==0 ) 
6670: 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28 69 3d  return;.  for(i=
6680: 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f 72 3b  0; i<p->nCursor;
6690: 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 21   i++){.    if( !
66a0: 70 2d 3e 69 6e 56 74 61 62 4d 65 74 68 6f 64 20  p->inVtabMethod 
66b0: 7c 7c 20 28 70 2d 3e 61 70 43 73 72 5b 69 5d 20  || (p->apCsr[i] 
66c0: 26 26 20 21 70 2d 3e 61 70 43 73 72 5b 69 5d 2d  && !p->apCsr[i]-
66d0: 3e 70 56 74 61 62 43 75 72 73 6f 72 29 20 29 7b  >pVtabCursor) ){
66e0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
66f0: 62 65 46 72 65 65 43 75 72 73 6f 72 28 70 2c 20  beFreeCursor(p, 
6700: 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b 0a 20 20  p->apCsr[i]);.  
6710: 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69 5d 20      p->apCsr[i] 
6720: 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d  = 0;.    }.  }.}
6730: 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e 20 75 70  ../*.** Clean up
6740: 20 74 68 65 20 56 4d 20 61 66 74 65 72 20 65 78   the VM after ex
6750: 65 63 75 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54  ecution..**.** T
6760: 68 69 73 20 72 6f 75 74 69 6e 65 20 77 69 6c 6c  his routine will
6770: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 63   automatically c
6780: 6c 6f 73 65 20 61 6e 79 20 63 75 72 73 6f 72 73  lose any cursors
6790: 2c 20 6c 69 73 74 73 2c 20 61 6e 64 2f 6f 72 0a  , lists, and/or.
67a0: 2a 2a 20 73 6f 72 74 65 72 73 20 74 68 61 74 20  ** sorters that 
67b0: 77 65 72 65 20 6c 65 66 74 20 6f 70 65 6e 2e 20  were left open. 
67c0: 20 49 74 20 61 6c 73 6f 20 64 65 6c 65 74 65 73   It also deletes
67d0: 20 74 68 65 20 76 61 6c 75 65 73 20 6f 66 0a 2a   the values of.*
67e0: 2a 20 76 61 72 69 61 62 6c 65 73 20 69 6e 20 74  * variables in t
67f0: 68 65 20 61 56 61 72 5b 5d 20 61 72 72 61 79 2e  he aVar[] array.
6800: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
6810: 43 6c 65 61 6e 75 70 28 56 64 62 65 20 2a 70 29  Cleanup(Vdbe *p)
6820: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66 28  {.  int i;.  if(
6830: 20 70 2d 3e 61 53 74 61 63 6b 20 29 7b 0a 20 20   p->aStack ){.  
6840: 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61    releaseMemArra
6850: 79 28 70 2d 3e 61 53 74 61 63 6b 2c 20 31 20 2b  y(p->aStack, 1 +
6860: 20 28 70 2d 3e 70 54 6f 73 20 2d 20 70 2d 3e 61   (p->pTos - p->a
6870: 53 74 61 63 6b 29 29 3b 0a 20 20 20 20 70 2d 3e  Stack));.    p->
6880: 70 54 6f 73 20 3d 20 26 70 2d 3e 61 53 74 61 63  pTos = &p->aStac
6890: 6b 5b 2d 31 5d 3b 0a 20 20 7d 0a 20 20 63 6c 6f  k[-1];.  }.  clo
68a0: 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 29 3b  seAllCursors(p);
68b0: 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72  .  releaseMemArr
68c0: 61 79 28 70 2d 3e 61 4d 65 6d 2c 20 70 2d 3e 6e  ay(p->aMem, p->n
68d0: 4d 65 6d 29 3b 0a 20 20 73 71 6c 69 74 65 33 56  Mem);.  sqlite3V
68e0: 64 62 65 46 69 66 6f 43 6c 65 61 72 28 26 70 2d  dbeFifoClear(&p-
68f0: 3e 73 46 69 66 6f 29 3b 0a 20 20 69 66 28 20 70  >sFifo);.  if( p
6900: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 20 29  ->contextStack )
6910: 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  {.    for(i=0; i
6920: 3c 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b  <p->contextStack
6930: 54 6f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  Top; i++){.     
6940: 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 66 6f   sqlite3VdbeFifo
6950: 43 6c 65 61 72 28 26 70 2d 3e 63 6f 6e 74 65 78  Clear(&p->contex
6960: 74 53 74 61 63 6b 5b 69 5d 2e 73 46 69 66 6f 29  tStack[i].sFifo)
6970: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
6980: 74 65 46 72 65 65 28 70 2d 3e 63 6f 6e 74 65 78  teFree(p->contex
6990: 74 53 74 61 63 6b 29 3b 0a 20 20 7d 0a 20 20 70  tStack);.  }.  p
69a0: 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b 20 3d  ->contextStack =
69b0: 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74   0;.  p->context
69c0: 53 74 61 63 6b 44 65 70 74 68 20 3d 20 30 3b 0a  StackDepth = 0;.
69d0: 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63    p->contextStac
69e0: 6b 54 6f 70 20 3d 20 30 3b 0a 20 20 73 71 6c 69  kTop = 0;.  sqli
69f0: 74 65 46 72 65 65 28 70 2d 3e 7a 45 72 72 4d 73  teFree(p->zErrMs
6a00: 67 29 3b 0a 20 20 70 2d 3e 7a 45 72 72 4d 73 67  g);.  p->zErrMsg
6a10: 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53   = 0;.}../*.** S
6a20: 65 74 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  et the number of
6a30: 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 20   result columns 
6a40: 74 68 61 74 20 77 69 6c 6c 20 62 65 20 72 65 74  that will be ret
6a50: 75 72 6e 65 64 20 62 79 20 74 68 69 73 20 53 51  urned by this SQ
6a60: 4c 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 2e 20  L.** statement. 
6a70: 54 68 69 73 20 69 73 20 6e 6f 77 20 73 65 74 20  This is now set 
6a80: 61 74 20 63 6f 6d 70 69 6c 65 20 74 69 6d 65 2c  at compile time,
6a90: 20 72 61 74 68 65 72 20 74 68 61 6e 20 64 75 72   rather than dur
6aa0: 69 6e 67 0a 2a 2a 20 65 78 65 63 75 74 69 6f 6e  ing.** execution
6ab0: 20 6f 66 20 74 68 65 20 76 64 62 65 20 70 72 6f   of the vdbe pro
6ac0: 67 72 61 6d 20 73 6f 20 74 68 61 74 20 73 71 6c  gram so that sql
6ad0: 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 63 6f 75 6e  ite3_column_coun
6ae0: 74 28 29 20 63 61 6e 0a 2a 2a 20 62 65 20 63 61  t() can.** be ca
6af0: 6c 6c 65 64 20 6f 6e 20 61 6e 20 53 51 4c 20 73  lled on an SQL s
6b00: 74 61 74 65 6d 65 6e 74 20 62 65 66 6f 72 65 20  tatement before 
6b10: 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e 0a  sqlite3_step()..
6b20: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
6b30: 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 56 64  dbeSetNumCols(Vd
6b40: 62 65 20 2a 70 2c 20 69 6e 74 20 6e 52 65 73 43  be *p, int nResC
6b50: 6f 6c 75 6d 6e 29 7b 0a 20 20 4d 65 6d 20 2a 70  olumn){.  Mem *p
6b60: 43 6f 6c 4e 61 6d 65 3b 0a 20 20 69 6e 74 20 6e  ColName;.  int n
6b70: 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72  ;.  releaseMemAr
6b80: 72 61 79 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 2c  ray(p->aColName,
6b90: 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 2a 43   p->nResColumn*C
6ba0: 4f 4c 4e 41 4d 45 5f 4e 29 3b 0a 20 20 73 71 6c  OLNAME_N);.  sql
6bb0: 69 74 65 46 72 65 65 28 70 2d 3e 61 43 6f 6c 4e  iteFree(p->aColN
6bc0: 61 6d 65 29 3b 0a 20 20 6e 20 3d 20 6e 52 65 73  ame);.  n = nRes
6bd0: 43 6f 6c 75 6d 6e 2a 43 4f 4c 4e 41 4d 45 5f 4e  Column*COLNAME_N
6be0: 3b 0a 20 20 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d  ;.  p->nResColum
6bf0: 6e 20 3d 20 6e 52 65 73 43 6f 6c 75 6d 6e 3b 0a  n = nResColumn;.
6c00: 20 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 20 3d 20    p->aColName = 
6c10: 70 43 6f 6c 4e 61 6d 65 20 3d 20 28 4d 65 6d 2a  pColName = (Mem*
6c20: 29 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 20 73  )sqliteMalloc( s
6c30: 69 7a 65 6f 66 28 4d 65 6d 29 2a 6e 20 29 3b 0a  izeof(Mem)*n );.
6c40: 20 20 69 66 28 20 70 2d 3e 61 43 6f 6c 4e 61 6d    if( p->aColNam
6c50: 65 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  e==0 ) return;. 
6c60: 20 77 68 69 6c 65 28 20 6e 2d 2d 20 3e 20 30 20   while( n-- > 0 
6c70: 29 7b 0a 20 20 20 20 28 70 43 6f 6c 4e 61 6d 65  ){.    (pColName
6c80: 2b 2b 29 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d  ++)->flags = MEM
6c90: 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a  _Null;.  }.}../*
6ca0: 0a 2a 2a 20 53 65 74 20 74 68 65 20 6e 61 6d 65  .** Set the name
6cb0: 20 6f 66 20 74 68 65 20 69 64 78 27 74 68 20 63   of the idx'th c
6cc0: 6f 6c 75 6d 6e 20 74 6f 20 62 65 20 72 65 74 75  olumn to be retu
6cd0: 72 6e 65 64 20 62 79 20 74 68 65 20 53 51 4c 20  rned by the SQL 
6ce0: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 20 7a 4e  statement..** zN
6cf0: 61 6d 65 20 6d 75 73 74 20 62 65 20 61 20 70 6f  ame must be a po
6d00: 69 6e 74 65 72 20 74 6f 20 61 20 6e 75 6c 20 74  inter to a nul t
6d10: 65 72 6d 69 6e 61 74 65 64 20 73 74 72 69 6e 67  erminated string
6d20: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 63 61 6c  ..**.** This cal
6d30: 6c 20 6d 75 73 74 20 62 65 20 6d 61 64 65 20 61  l must be made a
6d40: 66 74 65 72 20 61 20 63 61 6c 6c 20 74 6f 20 73  fter a call to s
6d50: 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d  qlite3VdbeSetNum
6d60: 43 6f 6c 73 28 29 2e 0a 2a 2a 0a 2a 2a 20 49 66  Cols()..**.** If
6d70: 20 4e 3d 3d 50 33 5f 53 54 41 54 49 43 20 20 69   N==P3_STATIC  i
6d80: 74 20 6d 65 61 6e 73 20 74 68 61 74 20 7a 4e 61  t means that zNa
6d90: 6d 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20  me is a pointer 
6da0: 74 6f 20 61 20 63 6f 6e 73 74 61 6e 74 20 73 74  to a constant st
6db0: 61 74 69 63 0a 2a 2a 20 73 74 72 69 6e 67 20 61  atic.** string a
6dc0: 6e 64 20 77 65 20 63 61 6e 20 6a 75 73 74 20 63  nd we can just c
6dd0: 6f 70 79 20 74 68 65 20 70 6f 69 6e 74 65 72 2e  opy the pointer.
6de0: 20 49 66 20 69 74 20 69 73 20 50 33 5f 44 59 4e   If it is P3_DYN
6df0: 41 4d 49 43 2c 20 74 68 65 6e 20 0a 2a 2a 20 74  AMIC, then .** t
6e00: 68 65 20 73 74 72 69 6e 67 20 69 73 20 66 72 65  he string is fre
6e10: 65 64 20 75 73 69 6e 67 20 73 71 6c 69 74 65 46  ed using sqliteF
6e20: 72 65 65 28 29 20 77 68 65 6e 20 74 68 65 20 76  ree() when the v
6e30: 64 62 65 20 69 73 20 66 69 6e 69 73 68 65 64 20  dbe is finished 
6e40: 77 69 74 68 0a 2a 2a 20 69 74 2e 20 4f 74 68 65  with.** it. Othe
6e50: 72 77 69 73 65 2c 20 4e 20 62 79 74 65 73 20 6f  rwise, N bytes o
6e60: 66 20 7a 4e 61 6d 65 20 61 72 65 20 63 6f 70 69  f zName are copi
6e70: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
6e80: 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65  e3VdbeSetColName
6e90: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 69 64  (Vdbe *p, int id
6ea0: 78 2c 20 69 6e 74 20 76 61 72 2c 20 63 6f 6e 73  x, int var, cons
6eb0: 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c 20 69  t char *zName, i
6ec0: 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72 63 3b  nt N){.  int rc;
6ed0: 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61 6d 65  .  Mem *pColName
6ee0: 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64 78 3c  ;.  assert( idx<
6ef0: 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 29 3b  p->nResColumn );
6f00: 0a 20 20 61 73 73 65 72 74 28 20 76 61 72 3c 43  .  assert( var<C
6f10: 4f 4c 4e 41 4d 45 5f 4e 20 29 3b 0a 20 20 69 66  OLNAME_N );.  if
6f20: 28 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46  ( sqlite3MallocF
6f30: 61 69 6c 65 64 28 29 20 29 20 72 65 74 75 72 6e  ailed() ) return
6f40: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
6f50: 20 61 73 73 65 72 74 28 20 70 2d 3e 61 43 6f 6c   assert( p->aCol
6f60: 4e 61 6d 65 21 3d 30 20 29 3b 0a 20 20 70 43 6f  Name!=0 );.  pCo
6f70: 6c 4e 61 6d 65 20 3d 20 26 28 70 2d 3e 61 43 6f  lName = &(p->aCo
6f80: 6c 4e 61 6d 65 5b 69 64 78 2b 76 61 72 2a 70 2d  lName[idx+var*p-
6f90: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 5d 29 3b 0a 20  >nResColumn]);. 
6fa0: 20 69 66 28 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d   if( N==P3_DYNAM
6fb0: 49 43 20 7c 7c 20 4e 3d 3d 50 33 5f 53 54 41 54  IC || N==P3_STAT
6fc0: 49 43 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  IC ){.    rc = s
6fd0: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74  qlite3VdbeMemSet
6fe0: 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20 7a 4e  Str(pColName, zN
6ff0: 61 6d 65 2c 20 2d 31 2c 20 53 51 4c 49 54 45 5f  ame, -1, SQLITE_
7000: 55 54 46 38 2c 20 53 51 4c 49 54 45 5f 53 54 41  UTF8, SQLITE_STA
7010: 54 49 43 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  TIC);.  }else{. 
7020: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
7030: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f  dbeMemSetStr(pCo
7040: 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 4e 2c  lName, zName, N,
7050: 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 53 51 4c   SQLITE_UTF8,SQL
7060: 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a  ITE_TRANSIENT);.
7070: 20 20 7d 0a 20 20 69 66 28 20 72 63 3d 3d 53 51    }.  if( rc==SQ
7080: 4c 49 54 45 5f 4f 4b 20 26 26 20 4e 3d 3d 50 33  LITE_OK && N==P3
7090: 5f 44 59 4e 41 4d 49 43 20 29 7b 0a 20 20 20 20  _DYNAMIC ){.    
70a0: 70 43 6f 6c 4e 61 6d 65 2d 3e 66 6c 61 67 73 20  pColName->flags 
70b0: 3d 20 28 70 43 6f 6c 4e 61 6d 65 2d 3e 66 6c 61  = (pColName->fla
70c0: 67 73 26 28 7e 4d 45 4d 5f 53 74 61 74 69 63 29  gs&(~MEM_Static)
70d0: 29 7c 4d 45 4d 5f 44 79 6e 3b 0a 20 20 20 20 70  )|MEM_Dyn;.    p
70e0: 43 6f 6c 4e 61 6d 65 2d 3e 78 44 65 6c 20 3d 20  ColName->xDel = 
70f0: 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  0;.  }.  return 
7100: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 20 72  rc;.}../*.** A r
7110: 65 61 64 20 6f 72 20 77 72 69 74 65 20 74 72 61  ead or write tra
7120: 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 6f 72 20  nsaction may or 
7130: 6d 61 79 20 6e 6f 74 20 62 65 20 61 63 74 69 76  may not be activ
7140: 65 20 6f 6e 20 64 61 74 61 62 61 73 65 20 68 61  e on database ha
7150: 6e 64 6c 65 0a 2a 2a 20 64 62 2e 20 49 66 20 61  ndle.** db. If a
7160: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
7170: 61 63 74 69 76 65 2c 20 63 6f 6d 6d 69 74 20 69  active, commit i
7180: 74 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 61  t. If there is a
7190: 0a 2a 2a 20 77 72 69 74 65 2d 74 72 61 6e 73 61  .** write-transa
71a0: 63 74 69 6f 6e 20 73 70 61 6e 6e 69 6e 67 20 6d  ction spanning m
71b0: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 64 61 74  ore than one dat
71c0: 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 69 73  abase file, this
71d0: 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 74 61 6b 65   routine.** take
71e0: 73 20 63 61 72 65 20 6f 66 20 74 68 65 20 6d 61  s care of the ma
71f0: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 74 72 69  ster journal tri
7200: 63 6b 65 72 79 2e 0a 2a 2f 0a 73 74 61 74 69 63  ckery..*/.static
7210: 20 69 6e 74 20 76 64 62 65 43 6f 6d 6d 69 74 28   int vdbeCommit(
7220: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
7230: 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 6e 54 72  int i;.  int nTr
7240: 61 6e 73 20 3d 20 30 3b 20 20 2f 2a 20 4e 75 6d  ans = 0;  /* Num
7250: 62 65 72 20 6f 66 20 64 61 74 61 62 61 73 65 73  ber of databases
7260: 20 77 69 74 68 20 61 6e 20 61 63 74 69 76 65 20   with an active 
7270: 77 72 69 74 65 2d 74 72 61 6e 73 61 63 74 69 6f  write-transactio
7280: 6e 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20  n */.  int rc = 
7290: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74  SQLITE_OK;.  int
72a0: 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20 3d 20 30   needXcommit = 0
72b0: 3b 0a 0a 20 20 2f 2a 20 42 65 66 6f 72 65 20 64  ;..  /* Before d
72c0: 6f 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 65 6c  oing anything el
72d0: 73 65 2c 20 63 61 6c 6c 20 74 68 65 20 78 53 79  se, call the xSy
72e0: 6e 63 28 29 20 63 61 6c 6c 62 61 63 6b 20 66 6f  nc() callback fo
72f0: 72 20 61 6e 79 0a 20 20 2a 2a 20 76 69 72 74 75  r any.  ** virtu
7300: 61 6c 20 6d 6f 64 75 6c 65 20 74 61 62 6c 65 73  al module tables
7310: 20 77 72 69 74 74 65 6e 20 69 6e 20 74 68 69 73   written in this
7320: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68   transaction. Th
7330: 69 73 20 68 61 73 20 74 6f 0a 20 20 2a 2a 20 62  is has to.  ** b
7340: 65 20 64 6f 6e 65 20 62 65 66 6f 72 65 20 64 65  e done before de
7350: 74 65 72 6d 69 6e 69 6e 67 20 77 68 65 74 68 65  termining whethe
7360: 72 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  r a master journ
7370: 61 6c 20 66 69 6c 65 20 69 73 20 0a 20 20 2a 2a  al file is .  **
7380: 20 72 65 71 75 69 72 65 64 2c 20 61 73 20 61 6e   required, as an
7390: 20 78 53 79 6e 63 28 29 20 63 61 6c 6c 62 61 63   xSync() callbac
73a0: 6b 20 6d 61 79 20 61 64 64 20 61 6e 20 61 74 74  k may add an att
73b0: 61 63 68 65 64 20 64 61 74 61 62 61 73 65 0a 20  ached database. 
73c0: 20 2a 2a 20 74 6f 20 74 68 65 20 74 72 61 6e 73   ** to the trans
73d0: 61 63 74 69 6f 6e 2e 0a 20 20 2a 2f 0a 20 20 72  action..  */.  r
73e0: 63 20 3d 20 73 71 6c 69 74 65 33 56 74 61 62 53  c = sqlite3VtabS
73f0: 79 6e 63 28 64 62 2c 20 72 63 29 3b 0a 20 20 69  ync(db, rc);.  i
7400: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
7410: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 72   ){.    return r
7420: 63 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 69  c;.  }..  /* Thi
7430: 73 20 6c 6f 6f 70 20 64 65 74 65 72 6d 69 6e 65  s loop determine
7440: 73 20 28 61 29 20 69 66 20 74 68 65 20 63 6f 6d  s (a) if the com
7450: 6d 69 74 20 68 6f 6f 6b 20 73 68 6f 75 6c 64 20  mit hook should 
7460: 62 65 20 69 6e 76 6f 6b 65 64 20 61 6e 64 0a 20  be invoked and. 
7470: 20 2a 2a 20 28 62 29 20 68 6f 77 20 6d 61 6e 79   ** (b) how many
7480: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20   database files 
7490: 68 61 76 65 20 6f 70 65 6e 20 77 72 69 74 65 20  have open write 
74a0: 74 72 61 6e 73 61 63 74 69 6f 6e 73 2c 20 6e 6f  transactions, no
74b0: 74 20 0a 20 20 2a 2a 20 69 6e 63 6c 75 64 69 6e  t .  ** includin
74c0: 67 20 74 68 65 20 74 65 6d 70 20 64 61 74 61 62  g the temp datab
74d0: 61 73 65 2e 20 28 62 29 20 69 73 20 69 6d 70 6f  ase. (b) is impo
74e0: 72 74 61 6e 74 20 62 65 63 61 75 73 65 20 69 66  rtant because if
74f0: 20 6d 6f 72 65 20 74 68 61 6e 20 0a 20 20 2a 2a   more than .  **
7500: 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66 69   one database fi
7510: 6c 65 20 68 61 73 20 61 6e 20 6f 70 65 6e 20 77  le has an open w
7520: 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e  rite transaction
7530: 2c 20 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  , a master journ
7540: 61 6c 0a 20 20 2a 2a 20 66 69 6c 65 20 69 73 20  al.  ** file is 
7550: 72 65 71 75 69 72 65 64 20 66 6f 72 20 61 6e 20  required for an 
7560: 61 74 6f 6d 69 63 20 63 6f 6d 6d 69 74 2e 0a 20  atomic commit.. 
7570: 20 2a 2f 20 0a 20 20 66 6f 72 28 69 3d 30 3b 20   */ .  for(i=0; 
7580: 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b  i<db->nDb; i++){
7590: 20 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 74   .    Btree *pBt
75a0: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42   = db->aDb[i].pB
75b0: 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 20 26  t;.    if( pBt &
75c0: 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73  & sqlite3BtreeIs
75d0: 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a  InTrans(pBt) ){.
75e0: 20 20 20 20 20 20 6e 65 65 64 58 63 6f 6d 6d 69        needXcommi
75f0: 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 66 28  t = 1;.      if(
7600: 20 69 21 3d 31 20 29 20 6e 54 72 61 6e 73 2b 2b   i!=1 ) nTrans++
7610: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  ;.    }.  }..  /
7620: 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 20 61  * If there are a
7630: 6e 79 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63  ny write-transac
7640: 74 69 6f 6e 73 20 61 74 20 61 6c 6c 2c 20 69 6e  tions at all, in
7650: 76 6f 6b 65 20 74 68 65 20 63 6f 6d 6d 69 74 20  voke the commit 
7660: 68 6f 6f 6b 20 2a 2f 0a 20 20 69 66 28 20 6e 65  hook */.  if( ne
7670: 65 64 58 63 6f 6d 6d 69 74 20 26 26 20 64 62 2d  edXcommit && db-
7680: 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b  >xCommitCallback
7690: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53   ){.    sqlite3S
76a0: 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20  afetyOff(db);.  
76b0: 20 20 72 63 20 3d 20 64 62 2d 3e 78 43 6f 6d 6d    rc = db->xComm
76c0: 69 74 43 61 6c 6c 62 61 63 6b 28 64 62 2d 3e 70  itCallback(db->p
76d0: 43 6f 6d 6d 69 74 41 72 67 29 3b 0a 20 20 20 20  CommitArg);.    
76e0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
76f0: 64 62 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20  db);.    if( rc 
7700: 29 7b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  ){.      return 
7710: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
7720: 54 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20  T;.    }.  }..  
7730: 2f 2a 20 54 68 65 20 73 69 6d 70 6c 65 20 63 61  /* The simple ca
7740: 73 65 20 2d 20 6e 6f 20 6d 6f 72 65 20 74 68 61  se - no more tha
7750: 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66  n one database f
7760: 69 6c 65 20 28 6e 6f 74 20 63 6f 75 6e 74 69 6e  ile (not countin
7770: 67 20 74 68 65 0a 20 20 2a 2a 20 54 45 4d 50 20  g the.  ** TEMP 
7780: 64 61 74 61 62 61 73 65 29 20 68 61 73 20 61 20  database) has a 
7790: 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74 69  transaction acti
77a0: 76 65 2e 20 20 20 54 68 65 72 65 20 69 73 20 6e  ve.   There is n
77b0: 6f 20 6e 65 65 64 20 66 6f 72 20 74 68 65 0a 20  o need for the. 
77c0: 20 2a 2a 20 6d 61 73 74 65 72 2d 6a 6f 75 72 6e   ** master-journ
77d0: 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 49 66  al..  **.  ** If
77e0: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
77f0: 65 20 6f 66 20 73 71 6c 69 74 65 33 42 74 72 65  e of sqlite3Btre
7800: 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 29 20 69  eGetFilename() i
7810: 73 20 61 20 7a 65 72 6f 20 6c 65 6e 67 74 68 0a  s a zero length.
7820: 20 20 2a 2a 20 73 74 72 69 6e 67 2c 20 69 74 20    ** string, it 
7830: 6d 65 61 6e 73 20 74 68 65 20 6d 61 69 6e 20 64  means the main d
7840: 61 74 61 62 61 73 65 20 69 73 20 3a 6d 65 6d 6f  atabase is :memo
7850: 72 79 3a 2e 20 20 49 6e 20 74 68 61 74 20 63 61  ry:.  In that ca
7860: 73 65 20 77 65 20 64 6f 0a 20 20 2a 2a 20 6e 6f  se we do.  ** no
7870: 74 20 73 75 70 70 6f 72 74 20 61 74 6f 6d 69 63  t support atomic
7880: 20 6d 75 6c 74 69 2d 66 69 6c 65 20 63 6f 6d 6d   multi-file comm
7890: 69 74 73 2c 20 73 6f 20 75 73 65 20 74 68 65 20  its, so use the 
78a0: 73 69 6d 70 6c 65 20 63 61 73 65 20 74 68 65 6e  simple case then
78b0: 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20 20 2a 2f 0a  .  ** too..  */.
78c0: 20 20 69 66 28 20 30 3d 3d 73 74 72 6c 65 6e 28    if( 0==strlen(
78d0: 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 46  sqlite3BtreeGetF
78e0: 69 6c 65 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b  ilename(db->aDb[
78f0: 30 5d 2e 70 42 74 29 29 20 7c 7c 20 6e 54 72 61  0].pBt)) || nTra
7900: 6e 73 3c 3d 31 20 29 7b 0a 20 20 20 20 66 6f 72  ns<=1 ){.    for
7910: 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45  (i=0; rc==SQLITE
7920: 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62  _OK && i<db->nDb
7930: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42  ; i++){ .      B
7940: 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e  tree *pBt = db->
7950: 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20  aDb[i].pBt;.    
7960: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20    if( pBt ){.   
7970: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
7980: 33 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73  3BtreeCommitPhas
7990: 65 4f 6e 65 28 70 42 74 2c 20 30 29 3b 0a 20 20  eOne(pBt, 0);.  
79a0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20      }.    }..   
79b0: 20 2f 2a 20 44 6f 20 74 68 65 20 63 6f 6d 6d 69   /* Do the commi
79c0: 74 20 6f 6e 6c 79 20 69 66 20 61 6c 6c 20 64 61  t only if all da
79d0: 74 61 62 61 73 65 73 20 73 75 63 63 65 73 73 66  tabases successf
79e0: 75 6c 6c 79 20 63 6f 6d 70 6c 65 74 65 20 70 68  ully complete ph
79f0: 61 73 65 20 31 2e 20 0a 20 20 20 20 2a 2a 20 49  ase 1. .    ** I
7a00: 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 42 74 72  f one of the Btr
7a10: 65 65 43 6f 6d 6d 69 74 50 68 61 73 65 4f 6e 65  eeCommitPhaseOne
7a20: 28 29 20 63 61 6c 6c 73 20 66 61 69 6c 73 2c 20  () calls fails, 
7a30: 74 68 69 73 20 69 6e 64 69 63 61 74 65 73 20 61  this indicates a
7a40: 6e 0a 20 20 20 20 2a 2a 20 49 4f 20 65 72 72 6f  n.    ** IO erro
7a50: 72 20 77 68 69 6c 65 20 64 65 6c 65 74 69 6e 67  r while deleting
7a60: 20 6f 72 20 74 72 75 6e 63 61 74 69 6e 67 20 61   or truncating a
7a70: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49   journal file. I
7a80: 74 20 69 73 20 75 6e 6c 69 6b 65 6c 79 2c 0a 20  t is unlikely,. 
7a90: 20 20 20 2a 2a 20 62 75 74 20 63 6f 75 6c 64 20     ** but could 
7aa0: 68 61 70 70 65 6e 2e 20 49 6e 20 74 68 69 73 20  happen. In this 
7ab0: 63 61 73 65 20 61 62 61 6e 64 6f 6e 20 70 72 6f  case abandon pro
7ac0: 63 65 73 73 69 6e 67 20 61 6e 64 20 72 65 74 75  cessing and retu
7ad0: 72 6e 20 74 68 65 20 65 72 72 6f 72 2e 0a 20 20  rn the error..  
7ae0: 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30    */.    for(i=0
7af0: 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ; rc==SQLITE_OK 
7b00: 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  && i<db->nDb; i+
7b10: 2b 29 7b 0a 20 20 20 20 20 20 42 74 72 65 65 20  +){.      Btree 
7b20: 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69  *pBt = db->aDb[i
7b30: 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28  ].pBt;.      if(
7b40: 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20   pBt ){.        
7b50: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
7b60: 65 43 6f 6d 6d 69 74 50 68 61 73 65 54 77 6f 28  eCommitPhaseTwo(
7b70: 70 42 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  pBt);.      }.  
7b80: 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d    }.    if( rc==
7b90: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
7ba0: 20 20 20 73 71 6c 69 74 65 33 56 74 61 62 43 6f     sqlite3VtabCo
7bb0: 6d 6d 69 74 28 64 62 29 3b 0a 20 20 20 20 7d 0a  mmit(db);.    }.
7bc0: 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 63 6f    }..  /* The co
7bd0: 6d 70 6c 65 78 20 63 61 73 65 20 2d 20 54 68 65  mplex case - The
7be0: 72 65 20 69 73 20 61 20 6d 75 6c 74 69 2d 66 69  re is a multi-fi
7bf0: 6c 65 20 77 72 69 74 65 2d 74 72 61 6e 73 61 63  le write-transac
7c00: 74 69 6f 6e 20 61 63 74 69 76 65 2e 0a 20 20 2a  tion active..  *
7c10: 2a 20 54 68 69 73 20 72 65 71 75 69 72 65 73 20  * This requires 
7c20: 61 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  a master journal
7c30: 20 66 69 6c 65 20 74 6f 20 65 6e 73 75 72 65 20   file to ensure 
7c40: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  the transaction 
7c50: 69 73 0a 20 20 2a 2a 20 63 6f 6d 6d 69 74 74 65  is.  ** committe
7c60: 64 20 61 74 6f 6d 69 63 6c 79 2e 0a 20 20 2a 2f  d atomicly..  */
7c70: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
7c80: 4f 4d 49 54 5f 44 49 53 4b 49 4f 0a 20 20 65 6c  OMIT_DISKIO.  el
7c90: 73 65 7b 0a 20 20 20 20 69 6e 74 20 6e 65 65 64  se{.    int need
7ca0: 53 79 6e 63 20 3d 20 30 3b 0a 20 20 20 20 63 68  Sync = 0;.    ch
7cb0: 61 72 20 2a 7a 4d 61 73 74 65 72 20 3d 20 30 3b  ar *zMaster = 0;
7cc0: 20 20 20 2f 2a 20 46 69 6c 65 2d 6e 61 6d 65 20     /* File-name 
7cd0: 66 6f 72 20 74 68 65 20 6d 61 73 74 65 72 20 6a  for the master j
7ce0: 6f 75 72 6e 61 6c 20 2a 2f 0a 20 20 20 20 63 68  ournal */.    ch
7cf0: 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 69 6e 46  ar const *zMainF
7d00: 69 6c 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72  ile = sqlite3Btr
7d10: 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 64 62  eeGetFilename(db
7d20: 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20  ->aDb[0].pBt);. 
7d30: 20 20 20 4f 73 46 69 6c 65 20 2a 6d 61 73 74 65     OsFile *maste
7d40: 72 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a 20 53  r = 0;..    /* S
7d50: 65 6c 65 63 74 20 61 20 6d 61 73 74 65 72 20 6a  elect a master j
7d60: 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d 65  ournal file name
7d70: 20 2a 2f 0a 20 20 20 20 64 6f 20 7b 0a 20 20 20   */.    do {.   
7d80: 20 20 20 75 33 32 20 72 61 6e 64 6f 6d 3b 0a 20     u32 random;. 
7d90: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
7da0: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  zMaster);.      
7db0: 73 71 6c 69 74 65 33 52 61 6e 64 6f 6d 6e 65 73  sqlite3Randomnes
7dc0: 73 28 73 69 7a 65 6f 66 28 72 61 6e 64 6f 6d 29  s(sizeof(random)
7dd0: 2c 20 26 72 61 6e 64 6f 6d 29 3b 0a 20 20 20 20  , &random);.    
7de0: 20 20 7a 4d 61 73 74 65 72 20 3d 20 73 71 6c 69    zMaster = sqli
7df0: 74 65 33 4d 50 72 69 6e 74 66 28 22 25 73 2d 6d  te3MPrintf("%s-m
7e00: 6a 25 30 38 58 22 2c 20 7a 4d 61 69 6e 46 69 6c  j%08X", zMainFil
7e10: 65 2c 20 72 61 6e 64 6f 6d 26 30 78 37 66 66 66  e, random&0x7fff
7e20: 66 66 66 66 29 3b 0a 20 20 20 20 20 20 69 66 28  ffff);.      if(
7e30: 20 21 7a 4d 61 73 74 65 72 20 29 7b 0a 20 20 20   !zMaster ){.   
7e40: 20 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49       return SQLI
7e50: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 20 20  TE_NOMEM;.      
7e60: 7d 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 73 71  }.    }while( sq
7e70: 6c 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74  lite3OsFileExist
7e80: 73 28 7a 4d 61 73 74 65 72 29 20 29 3b 0a 0a 20  s(zMaster) );.. 
7e90: 20 20 20 2f 2a 20 4f 70 65 6e 20 74 68 65 20 6d     /* Open the m
7ea0: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 2e 20 2a  aster journal. *
7eb0: 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  /.    rc = sqlit
7ec0: 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76  e3OsOpenExclusiv
7ed0: 65 28 7a 4d 61 73 74 65 72 2c 20 26 6d 61 73 74  e(zMaster, &mast
7ee0: 65 72 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20  er, 0);.    if( 
7ef0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
7f00: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65  .      sqliteFre
7f10: 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20  e(zMaster);.    
7f20: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20    return rc;.   
7f30: 20 7d 0a 20 0a 20 20 20 20 2f 2a 20 57 72 69 74   }. .    /* Writ
7f40: 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 65 61  e the name of ea
7f50: 63 68 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ch database file
7f60: 20 69 6e 20 74 68 65 20 74 72 61 6e 73 61 63 74   in the transact
7f70: 69 6f 6e 20 69 6e 74 6f 20 74 68 65 20 6e 65 77  ion into the new
7f80: 0a 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a  .    ** master j
7f90: 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 49 66 20  ournal file. If 
7fa0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 20  an error occurs 
7fb0: 61 74 20 74 68 69 73 20 70 6f 69 6e 74 20 63 6c  at this point cl
7fc0: 6f 73 65 0a 20 20 20 20 2a 2a 20 61 6e 64 20 64  ose.    ** and d
7fd0: 65 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65 72  elete the master
7fe0: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20 41   journal file. A
7ff0: 6c 6c 20 74 68 65 20 69 6e 64 69 76 69 64 75 61  ll the individua
8000: 6c 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 73 0a  l journal files.
8010: 20 20 20 20 2a 2a 20 73 74 69 6c 6c 20 68 61 76      ** still hav
8020: 65 20 27 6e 75 6c 6c 27 20 61 73 20 74 68 65 20  e 'null' as the 
8030: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70  master journal p
8040: 6f 69 6e 74 65 72 2c 20 73 6f 20 74 68 65 79 20  ointer, so they 
8050: 77 69 6c 6c 20 72 6f 6c 6c 0a 20 20 20 20 2a 2a  will roll.    **
8060: 20 62 61 63 6b 20 69 6e 64 65 70 65 6e 64 65 6e   back independen
8070: 74 6c 79 20 69 66 20 61 20 66 61 69 6c 75 72 65  tly if a failure
8080: 20 6f 63 63 75 72 73 2e 0a 20 20 20 20 2a 2f 0a   occurs..    */.
8090: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64      for(i=0; i<d
80a0: 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20  b->nDb; i++){ . 
80b0: 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20       Btree *pBt 
80c0: 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74  = db->aDb[i].pBt
80d0: 3b 0a 20 20 20 20 20 20 69 66 28 20 69 3d 3d 31  ;.      if( i==1
80e0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 20 20 20 2f   ) continue;   /
80f0: 2a 20 49 67 6e 6f 72 65 20 74 68 65 20 54 45 4d  * Ignore the TEM
8100: 50 20 64 61 74 61 62 61 73 65 20 2a 2f 0a 20 20  P database */.  
8110: 20 20 20 20 69 66 28 20 70 42 74 20 26 26 20 73      if( pBt && s
8120: 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e 54  qlite3BtreeIsInT
8130: 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 20 20  rans(pBt) ){.   
8140: 20 20 20 20 20 63 68 61 72 20 63 6f 6e 73 74 20       char const 
8150: 2a 7a 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33  *zFile = sqlite3
8160: 42 74 72 65 65 47 65 74 4a 6f 75 72 6e 61 6c 6e  BtreeGetJournaln
8170: 61 6d 65 28 70 42 74 29 3b 0a 20 20 20 20 20 20  ame(pBt);.      
8180: 20 20 69 66 28 20 7a 46 69 6c 65 5b 30 5d 3d 3d    if( zFile[0]==
8190: 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 20 20 2f  0 ) continue;  /
81a0: 2a 20 49 67 6e 6f 72 65 20 3a 6d 65 6d 6f 72 79  * Ignore :memory
81b0: 3a 20 64 61 74 61 62 61 73 65 73 20 2a 2f 0a 20  : databases */. 
81c0: 20 20 20 20 20 20 20 69 66 28 20 21 6e 65 65 64         if( !need
81d0: 53 79 6e 63 20 26 26 20 21 73 71 6c 69 74 65 33  Sync && !sqlite3
81e0: 42 74 72 65 65 53 79 6e 63 44 69 73 61 62 6c 65  BtreeSyncDisable
81f0: 64 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20  d(pBt) ){.      
8200: 20 20 20 20 6e 65 65 64 53 79 6e 63 20 3d 20 31      needSync = 1
8210: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
8220: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
8230: 4f 73 57 72 69 74 65 28 6d 61 73 74 65 72 2c 20  OsWrite(master, 
8240: 7a 46 69 6c 65 2c 20 73 74 72 6c 65 6e 28 7a 46  zFile, strlen(zF
8250: 69 6c 65 29 2b 31 29 3b 0a 20 20 20 20 20 20 20  ile)+1);.       
8260: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
8270: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  OK ){.          
8280: 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 26  sqlite3OsClose(&
8290: 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20  master);.       
82a0: 20 20 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65     sqlite3OsDele
82b0: 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20  te(zMaster);.   
82c0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65         sqliteFre
82d0: 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20  e(zMaster);.    
82e0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
82f0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
8300: 20 7d 0a 20 20 20 20 7d 0a 0a 0a 20 20 20 20 2f   }.    }...    /
8310: 2a 20 53 79 6e 63 20 74 68 65 20 6d 61 73 74 65  * Sync the maste
8320: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 20  r journal file. 
8330: 42 65 66 6f 72 65 20 64 6f 69 6e 67 20 74 68 69  Before doing thi
8340: 73 2c 20 6f 70 65 6e 20 74 68 65 20 64 69 72 65  s, open the dire
8350: 63 74 6f 72 79 0a 20 20 20 20 2a 2a 20 74 68 65  ctory.    ** the
8360: 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20   master journal 
8370: 66 69 6c 65 20 69 73 20 73 74 6f 72 65 20 69 6e  file is store in
8380: 20 73 6f 20 74 68 61 74 20 69 74 20 67 65 74 73   so that it gets
8390: 20 73 79 6e 63 65 64 20 74 6f 6f 2e 0a 20 20 20   synced too..   
83a0: 20 2a 2f 0a 20 20 20 20 7a 4d 61 69 6e 46 69 6c   */.    zMainFil
83b0: 65 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  e = sqlite3Btree
83c0: 47 65 74 44 69 72 6e 61 6d 65 28 64 62 2d 3e 61  GetDirname(db->a
83d0: 44 62 5b 30 5d 2e 70 42 74 29 3b 0a 20 20 20 20  Db[0].pBt);.    
83e0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70  rc = sqlite3OsOp
83f0: 65 6e 44 69 72 65 63 74 6f 72 79 28 6d 61 73 74  enDirectory(mast
8400: 65 72 2c 20 7a 4d 61 69 6e 46 69 6c 65 29 3b 0a  er, zMainFile);.
8410: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
8420: 54 45 5f 4f 4b 20 7c 7c 0a 20 20 20 20 20 20 20  TE_OK ||.       
8430: 20 20 20 28 6e 65 65 64 53 79 6e 63 20 26 26 20     (needSync && 
8440: 28 72 63 3d 73 71 6c 69 74 65 33 4f 73 53 79 6e  (rc=sqlite3OsSyn
8450: 63 28 6d 61 73 74 65 72 2c 30 29 29 21 3d 53 51  c(master,0))!=SQ
8460: 4c 49 54 45 5f 4f 4b 29 20 29 7b 0a 20 20 20 20  LITE_OK) ){.    
8470: 20 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65    sqlite3OsClose
8480: 28 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 20  (&master);.     
8490: 20 73 71 6c 69 74 65 33 4f 73 44 65 6c 65 74 65   sqlite3OsDelete
84a0: 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20  (zMaster);.     
84b0: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
84c0: 74 65 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75  ter);.      retu
84d0: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20  rn rc;.    }..  
84e0: 20 20 2f 2a 20 53 79 6e 63 20 61 6c 6c 20 74 68    /* Sync all th
84f0: 65 20 64 62 20 66 69 6c 65 73 20 69 6e 76 6f 6c  e db files invol
8500: 76 65 64 20 69 6e 20 74 68 65 20 74 72 61 6e 73  ved in the trans
8510: 61 63 74 69 6f 6e 2e 20 54 68 65 20 73 61 6d 65  action. The same
8520: 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 73 65 74   call.    ** set
8530: 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  s the master jou
8540: 72 6e 61 6c 20 70 6f 69 6e 74 65 72 20 69 6e 20  rnal pointer in 
8550: 65 61 63 68 20 69 6e 64 69 76 69 64 75 61 6c 20  each individual 
8560: 6a 6f 75 72 6e 61 6c 2e 20 49 66 0a 20 20 20 20  journal. If.    
8570: 2a 2a 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  ** an error occu
8580: 72 73 20 68 65 72 65 2c 20 64 6f 20 6e 6f 74 20  rs here, do not 
8590: 64 65 6c 65 74 65 20 74 68 65 20 6d 61 73 74 65  delete the maste
85a0: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2e 0a  r journal file..
85b0: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 49 66      **.    ** If
85c0: 20 74 68 65 20 65 72 72 6f 72 20 6f 63 63 75 72   the error occur
85d0: 73 20 64 75 72 69 6e 67 20 74 68 65 20 66 69 72  s during the fir
85e0: 73 74 20 63 61 6c 6c 20 74 6f 0a 20 20 20 20 2a  st call to.    *
85f0: 2a 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f  * sqlite3BtreeCo
8600: 6d 6d 69 74 50 68 61 73 65 4f 6e 65 28 29 2c 20  mmitPhaseOne(), 
8610: 74 68 65 6e 20 74 68 65 72 65 20 69 73 20 61 20  then there is a 
8620: 63 68 61 6e 63 65 20 74 68 61 74 20 74 68 65 0a  chance that the.
8630: 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f      ** master jo
8640: 75 72 6e 61 6c 20 66 69 6c 65 20 77 69 6c 6c 20  urnal file will 
8650: 62 65 20 6f 72 70 68 61 6e 65 64 2e 20 42 75 74  be orphaned. But
8660: 20 77 65 20 63 61 6e 6e 6f 74 20 64 65 6c 65 74   we cannot delet
8670: 65 20 69 74 2c 0a 20 20 20 20 2a 2a 20 69 6e 20  e it,.    ** in 
8680: 63 61 73 65 20 74 68 65 20 6d 61 73 74 65 72 20  case the master 
8690: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 6e 61 6d  journal file nam
86a0: 65 20 77 61 73 20 77 72 69 74 74 65 6e 20 69 6e  e was written in
86b0: 74 6f 20 74 68 65 20 6a 6f 75 72 6e 61 6c 0a 20  to the journal. 
86c0: 20 20 20 2a 2a 20 66 69 6c 65 20 62 65 66 6f 72     ** file befor
86d0: 65 20 74 68 65 20 66 61 69 6c 75 72 65 20 6f 63  e the failure oc
86e0: 63 75 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  cured..    */.  
86f0: 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53    for(i=0; rc==S
8700: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62  QLITE_OK && i<db
8710: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20  ->nDb; i++){ .  
8720: 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d      Btree *pBt =
8730: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b   db->aDb[i].pBt;
8740: 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20 26  .      if( pBt &
8750: 26 20 73 71 6c 69 74 65 33 42 74 72 65 65 49 73  & sqlite3BtreeIs
8760: 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a  InTrans(pBt) ){.
8770: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
8780: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 50  ite3BtreeCommitP
8790: 68 61 73 65 4f 6e 65 28 70 42 74 2c 20 7a 4d 61  haseOne(pBt, zMa
87a0: 73 74 65 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20  ster);.      }. 
87b0: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33     }.    sqlite3
87c0: 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29  OsClose(&master)
87d0: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 53 51  ;.    if( rc!=SQ
87e0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
87f0: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
8800: 74 65 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75  ter);.      retu
8810: 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20  rn rc;.    }..  
8820: 20 20 2f 2a 20 44 65 6c 65 74 65 20 74 68 65 20    /* Delete the 
8830: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
8840: 69 6c 65 2e 20 54 68 69 73 20 63 6f 6d 6d 69 74  ile. This commit
8850: 73 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  s the transactio
8860: 6e 2e 20 41 66 74 65 72 0a 20 20 20 20 2a 2a 20  n. After.    ** 
8870: 64 6f 69 6e 67 20 74 68 69 73 20 74 68 65 20 64  doing this the d
8880: 69 72 65 63 74 6f 72 79 20 69 73 20 73 79 6e 63  irectory is sync
8890: 65 64 20 61 67 61 69 6e 20 62 65 66 6f 72 65 20  ed again before 
88a0: 61 6e 79 20 69 6e 64 69 76 69 64 75 61 6c 0a 20  any individual. 
88b0: 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f     ** transactio
88c0: 6e 20 66 69 6c 65 73 20 61 72 65 20 64 65 6c 65  n files are dele
88d0: 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  ted..    */.    
88e0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 44 65  rc = sqlite3OsDe
88f0: 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  lete(zMaster);. 
8900: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
8910: 61 73 74 65 72 29 3b 0a 20 20 20 20 7a 4d 61 73  aster);.    zMas
8920: 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 69 66 28  ter = 0;.    if(
8930: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74   rc ){.      ret
8940: 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20  urn rc;.    }.  
8950: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73    rc = sqlite3Os
8960: 53 79 6e 63 44 69 72 65 63 74 6f 72 79 28 7a 4d  SyncDirectory(zM
8970: 61 69 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69 66  ainFile);.    if
8980: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
8990: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73  ){.      /* This
89a0: 20 69 73 20 6e 6f 74 20 67 6f 6f 64 2e 20 54 68   is not good. Th
89b0: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
89c0: 20 66 69 6c 65 20 68 61 73 20 62 65 65 6e 20 64   file has been d
89d0: 65 6c 65 74 65 64 2c 20 62 75 74 0a 20 20 20 20  eleted, but.    
89e0: 20 20 2a 2a 20 74 68 65 20 64 69 72 65 63 74 6f    ** the directo
89f0: 72 79 20 73 79 6e 63 20 66 61 69 6c 65 64 2e 20  ry sync failed. 
8a00: 54 68 65 72 65 20 69 73 20 6e 6f 20 63 6f 6d 70  There is no comp
8a10: 6c 65 74 65 6c 79 20 73 61 66 65 20 63 6f 75 72  letely safe cour
8a20: 73 65 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 61  se of.      ** a
8a30: 63 74 69 6f 6e 20 66 72 6f 6d 20 68 65 72 65 2e  ction from here.
8a40: 20 54 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20   The individual 
8a50: 6a 6f 75 72 6e 61 6c 73 20 63 6f 6e 74 61 69 6e  journals contain
8a60: 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65   the name of the
8a70: 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72  .      ** master
8a80: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 62   journal file, b
8a90: 75 74 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77  ut there is no w
8aa0: 61 79 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 69 66  ay of knowing if
8ab0: 20 74 68 61 74 0a 20 20 20 20 20 20 2a 2a 20 6d   that.      ** m
8ac0: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78  aster journal ex
8ad0: 69 73 74 73 20 6e 6f 77 20 6f 72 20 69 66 20 69  ists now or if i
8ae0: 74 20 77 69 6c 6c 20 65 78 69 73 74 20 61 66 74  t will exist aft
8af0: 65 72 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67  er the operating
8b00: 0a 20 20 20 20 20 20 2a 2a 20 73 79 73 74 65 6d  .      ** system
8b10: 20 63 72 61 73 68 20 74 68 61 74 20 6d 61 79 20   crash that may 
8b20: 66 6f 6c 6c 6f 77 20 74 68 65 20 66 73 79 6e 63  follow the fsync
8b30: 28 29 20 66 61 69 6c 75 72 65 2e 0a 20 20 20 20  () failure..    
8b40: 20 20 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72    */.      retur
8b50: 6e 20 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  n rc;.    }..   
8b60: 20 2f 2a 20 41 6c 6c 20 66 69 6c 65 73 20 61 6e   /* All files an
8b70: 64 20 64 69 72 65 63 74 6f 72 69 65 73 20 68 61  d directories ha
8b80: 76 65 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20  ve already been 
8b90: 73 79 6e 63 65 64 2c 20 73 6f 20 74 68 65 20 66  synced, so the f
8ba0: 6f 6c 6c 6f 77 69 6e 67 0a 20 20 20 20 2a 2a 20  ollowing.    ** 
8bb0: 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74 65 33  calls to sqlite3
8bc0: 42 74 72 65 65 43 6f 6d 6d 69 74 50 68 61 73 65  BtreeCommitPhase
8bd0: 54 77 6f 28 29 20 61 72 65 20 6f 6e 6c 79 20 63  Two() are only c
8be0: 6c 6f 73 69 6e 67 20 66 69 6c 65 73 20 61 6e 64  losing files and
8bf0: 0a 20 20 20 20 2a 2a 20 64 65 6c 65 74 69 6e 67  .    ** deleting
8c00: 20 6f 72 20 74 72 75 6e 63 61 74 69 6e 67 20 6a   or truncating j
8c10: 6f 75 72 6e 61 6c 73 2e 20 49 66 20 73 6f 6d 65  ournals. If some
8c20: 74 68 69 6e 67 20 67 6f 65 73 20 77 72 6f 6e 67  thing goes wrong
8c30: 20 77 68 69 6c 65 0a 20 20 20 20 2a 2a 20 74 68   while.    ** th
8c40: 69 73 20 69 73 20 68 61 70 70 65 6e 69 6e 67 20  is is happening 
8c50: 77 65 20 64 6f 6e 27 74 20 72 65 61 6c 6c 79 20  we don't really 
8c60: 63 61 72 65 2e 20 54 68 65 20 69 6e 74 65 67 72  care. The integr
8c70: 69 74 79 20 6f 66 20 74 68 65 0a 20 20 20 20 2a  ity of the.    *
8c80: 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73  * transaction is
8c90: 20 61 6c 72 65 61 64 79 20 67 75 61 72 61 6e 74   already guarant
8ca0: 65 65 64 2c 20 62 75 74 20 73 6f 6d 65 20 73 74  eed, but some st
8cb0: 72 61 79 20 27 63 6f 6c 64 27 20 6a 6f 75 72 6e  ray 'cold' journ
8cc0: 61 6c 73 0a 20 20 20 20 2a 2a 20 6d 61 79 20 62  als.    ** may b
8cd0: 65 20 6c 79 69 6e 67 20 61 72 6f 75 6e 64 2e 20  e lying around. 
8ce0: 52 65 74 75 72 6e 69 6e 67 20 61 6e 20 65 72 72  Returning an err
8cf0: 6f 72 20 63 6f 64 65 20 77 6f 6e 27 74 20 68 65  or code won't he
8d00: 6c 70 20 6d 61 74 74 65 72 73 2e 0a 20 20 20 20  lp matters..    
8d10: 2a 2f 0a 20 20 20 20 64 69 73 61 62 6c 65 5f 73  */.    disable_s
8d20: 69 6d 75 6c 61 74 65 64 5f 69 6f 5f 65 72 72 6f  imulated_io_erro
8d30: 72 73 28 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d  rs();.    for(i=
8d40: 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  0; i<db->nDb; i+
8d50: 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65  +){ .      Btree
8d60: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b   *pBt = db->aDb[
8d70: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66  i].pBt;.      if
8d80: 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20 20  ( pBt ){.       
8d90: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
8da0: 6d 69 74 50 68 61 73 65 54 77 6f 28 70 42 74 29  mitPhaseTwo(pBt)
8db0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
8dc0: 20 20 20 20 65 6e 61 62 6c 65 5f 73 69 6d 75 6c      enable_simul
8dd0: 61 74 65 64 5f 69 6f 5f 65 72 72 6f 72 73 28 29  ated_io_errors()
8de0: 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 56 74  ;..    sqlite3Vt
8df0: 61 62 43 6f 6d 6d 69 74 28 64 62 29 3b 0a 20 20  abCommit(db);.  
8e00: 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75  }.#endif..  retu
8e10: 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 0a 2a 2a  rn rc;.}../* .**
8e20: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68   This routine ch
8e30: 65 63 6b 73 20 74 68 61 74 20 74 68 65 20 73 71  ecks that the sq
8e40: 6c 69 74 65 33 2e 61 63 74 69 76 65 56 64 62 65  lite3.activeVdbe
8e50: 43 6e 74 20 63 6f 75 6e 74 20 76 61 72 69 61 62  Cnt count variab
8e60: 6c 65 0a 2a 2a 20 6d 61 74 63 68 65 73 20 74 68  le.** matches th
8e70: 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 64 62 65  e number of vdbe
8e80: 27 73 20 69 6e 20 74 68 65 20 6c 69 73 74 20 73  's in the list s
8e90: 71 6c 69 74 65 33 2e 70 56 64 62 65 20 74 68 61  qlite3.pVdbe tha
8ea0: 74 20 61 72 65 0a 2a 2a 20 63 75 72 72 65 6e 74  t are.** current
8eb0: 6c 79 20 61 63 74 69 76 65 2e 20 41 6e 20 61 73  ly active. An as
8ec0: 73 65 72 74 69 6f 6e 20 66 61 69 6c 73 20 69 66  sertion fails if
8ed0: 20 74 68 65 20 74 77 6f 20 63 6f 75 6e 74 73 20   the two counts 
8ee0: 64 6f 20 6e 6f 74 20 6d 61 74 63 68 2e 0a 2a 2a  do not match..**
8ef0: 20 54 68 69 73 20 69 73 20 61 6e 20 69 6e 74 65   This is an inte
8f00: 72 6e 61 6c 20 73 65 6c 66 2d 63 68 65 63 6b 20  rnal self-check 
8f10: 6f 6e 6c 79 20 2d 20 69 74 20 69 73 20 6e 6f 74  only - it is not
8f20: 20 61 6e 20 65 73 73 65 6e 74 69 61 6c 20 70 72   an essential pr
8f30: 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 73 74 65 70  ocessing.** step
8f40: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20  ..**.** This is 
8f50: 61 20 6e 6f 2d 6f 70 20 69 66 20 4e 44 45 42 55  a no-op if NDEBU
8f60: 47 20 69 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f  G is defined..*/
8f70: 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a  .#ifndef NDEBUG.
8f80: 73 74 61 74 69 63 20 76 6f 69 64 20 63 68 65 63  static void chec
8f90: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 73  kActiveVdbeCnt(s
8fa0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 56  qlite3 *db){.  V
8fb0: 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20 63 6e  dbe *p;.  int cn
8fc0: 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20 64 62 2d  t = 0;.  p = db-
8fd0: 3e 70 56 64 62 65 3b 0a 20 20 77 68 69 6c 65 28  >pVdbe;.  while(
8fe0: 20 70 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d   p ){.    if( p-
8ff0: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
9000: 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 70 63 3e  IC_RUN && p->pc>
9010: 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6e 74 2b  =0 ){.      cnt+
9020: 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 20 3d  +;.    }.    p =
9030: 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20   p->pNext;.  }. 
9040: 20 61 73 73 65 72 74 28 20 63 6e 74 3d 3d 64 62   assert( cnt==db
9050: 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20  ->activeVdbeCnt 
9060: 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65 66 69  );.}.#else.#defi
9070: 6e 65 20 63 68 65 63 6b 41 63 74 69 76 65 56 64  ne checkActiveVd
9080: 62 65 43 6e 74 28 78 29 0a 23 65 6e 64 69 66 0a  beCnt(x).#endif.
9090: 0a 2f 2a 0a 2a 2a 20 46 69 6e 64 20 65 76 65 72  ./*.** Find ever
90a0: 79 20 61 63 74 69 76 65 20 56 4d 20 6f 74 68 65  y active VM othe
90b0: 72 20 74 68 61 6e 20 70 56 64 62 65 20 61 6e 64  r than pVdbe and
90c0: 20 63 68 61 6e 67 65 20 69 74 73 20 73 74 61 74   change its stat
90d0: 75 73 20 74 6f 0a 2a 2a 20 61 62 6f 72 74 65 64  us to.** aborted
90e0: 2e 20 20 54 68 69 73 20 68 61 70 70 65 6e 73 20  .  This happens 
90f0: 77 68 65 6e 20 6f 6e 65 20 56 4d 20 63 61 75 73  when one VM caus
9100: 65 73 20 61 20 72 6f 6c 6c 62 61 63 6b 20 64 75  es a rollback du
9110: 65 20 74 6f 20 61 6e 0a 2a 2a 20 4f 4e 20 43 4f  e to an.** ON CO
9120: 4e 46 4c 49 43 54 20 52 4f 4c 4c 42 41 43 4b 20  NFLICT ROLLBACK 
9130: 63 6c 61 75 73 65 20 28 66 6f 72 20 65 78 61 6d  clause (for exam
9140: 70 6c 65 29 2e 20 20 54 68 65 20 6f 74 68 65 72  ple).  The other
9150: 20 56 4d 73 20 6d 75 73 74 20 62 65 0a 2a 2a 20   VMs must be.** 
9160: 61 62 6f 72 74 65 64 20 73 6f 20 74 68 61 74 20  aborted so that 
9170: 74 68 65 79 20 64 6f 20 6e 6f 74 20 68 61 76 65  they do not have
9180: 20 64 61 74 61 20 72 6f 6c 6c 65 64 20 6f 75 74   data rolled out
9190: 20 66 72 6f 6d 20 75 6e 64 65 72 6e 65 61 74 68   from underneath
91a0: 0a 2a 2a 20 74 68 65 6d 20 6c 65 61 64 69 6e 67  .** them leading
91b0: 20 74 6f 20 61 20 73 65 67 66 61 75 6c 74 2e 0a   to a segfault..
91c0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 41  */.void sqlite3A
91d0: 62 6f 72 74 4f 74 68 65 72 41 63 74 69 76 65 56  bortOtherActiveV
91e0: 64 62 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62  dbes(sqlite3 *db
91f0: 2c 20 56 64 62 65 20 2a 70 45 78 63 65 70 74 29  , Vdbe *pExcept)
9200: 7b 0a 20 20 56 64 62 65 20 2a 70 4f 74 68 65 72  {.  Vdbe *pOther
9210: 3b 0a 20 20 66 6f 72 28 70 4f 74 68 65 72 3d 64  ;.  for(pOther=d
9220: 62 2d 3e 70 56 64 62 65 3b 20 70 4f 74 68 65 72  b->pVdbe; pOther
9230: 3b 20 70 4f 74 68 65 72 3d 70 4f 74 68 65 72 2d  ; pOther=pOther-
9240: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28  >pNext){.    if(
9250: 20 70 4f 74 68 65 72 3d 3d 70 45 78 63 65 70 74   pOther==pExcept
9260: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
9270: 20 69 66 28 20 70 4f 74 68 65 72 2d 3e 6d 61 67   if( pOther->mag
9280: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52  ic!=VDBE_MAGIC_R
9290: 55 4e 20 7c 7c 20 70 4f 74 68 65 72 2d 3e 70 63  UN || pOther->pc
92a0: 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20  <0 ) continue;. 
92b0: 20 20 20 63 68 65 63 6b 41 63 74 69 76 65 56 64     checkActiveVd
92c0: 62 65 43 6e 74 28 64 62 29 3b 0a 20 20 20 20 63  beCnt(db);.    c
92d0: 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70  loseAllCursors(p
92e0: 4f 74 68 65 72 29 3b 0a 20 20 20 20 63 68 65 63  Other);.    chec
92f0: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64  kActiveVdbeCnt(d
9300: 62 29 3b 0a 20 20 20 20 70 4f 74 68 65 72 2d 3e  b);.    pOther->
9310: 61 62 6f 72 74 65 64 20 3d 20 31 3b 0a 20 20 7d  aborted = 1;.  }
9320: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
9330: 6f 75 74 69 6e 65 20 69 73 20 63 61 6c 6c 65 64  outine is called
9340: 20 74 68 65 20 77 68 65 6e 20 61 20 56 44 42 45   the when a VDBE
9350: 20 74 72 69 65 73 20 74 6f 20 68 61 6c 74 2e 20   tries to halt. 
9360: 20 49 66 20 74 68 65 20 56 44 42 45 0a 2a 2a 20   If the VDBE.** 
9370: 68 61 73 20 6d 61 64 65 20 63 68 61 6e 67 65 73  has made changes
9380: 20 61 6e 64 20 69 73 20 69 6e 20 61 75 74 6f 63   and is in autoc
9390: 6f 6d 6d 69 74 20 6d 6f 64 65 2c 20 74 68 65 6e  ommit mode, then
93a0: 20 63 6f 6d 6d 69 74 20 74 68 6f 73 65 0a 2a 2a   commit those.**
93b0: 20 63 68 61 6e 67 65 73 2e 20 20 49 66 20 61 20   changes.  If a 
93c0: 72 6f 6c 6c 62 61 63 6b 20 69 73 20 6e 65 65 64  rollback is need
93d0: 65 64 2c 20 74 68 65 6e 20 64 6f 20 74 68 65 20  ed, then do the 
93e0: 72 6f 6c 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20  rollback..**.** 
93f0: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
9400: 74 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20  the only way to 
9410: 6d 6f 76 65 20 74 68 65 20 73 74 61 74 65 20 6f  move the state o
9420: 66 20 61 20 56 4d 20 66 72 6f 6d 0a 2a 2a 20 53  f a VM from.** S
9430: 51 4c 49 54 45 5f 4d 41 47 49 43 5f 52 55 4e 20  QLITE_MAGIC_RUN 
9440: 74 6f 20 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f  to SQLITE_MAGIC_
9450: 48 41 4c 54 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75  HALT..**.** Retu
9460: 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65  rn an error code
9470: 2e 20 20 49 66 20 74 68 65 20 63 6f 6d 6d 69 74  .  If the commit
9480: 20 63 6f 75 6c 64 20 6e 6f 74 20 63 6f 6d 70 6c   could not compl
9490: 65 74 65 20 62 65 63 61 75 73 65 20 6f 66 0a 2a  ete because of.*
94a0: 2a 20 6c 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f  * lock contentio
94b0: 6e 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  n, return SQLITE
94c0: 5f 42 55 53 59 2e 20 20 49 66 20 53 51 4c 49 54  _BUSY.  If SQLIT
94d0: 45 5f 42 55 53 59 20 69 73 20 72 65 74 75 72 6e  E_BUSY is return
94e0: 65 64 2c 20 69 74 0a 2a 2a 20 6d 65 61 6e 73 20  ed, it.** means 
94f0: 74 68 65 20 63 6c 6f 73 65 20 64 69 64 20 6e 6f  the close did no
9500: 74 20 68 61 70 70 65 6e 20 61 6e 64 20 6e 65 65  t happen and nee
9510: 64 73 20 74 6f 20 62 65 20 72 65 70 65 61 74 65  ds to be repeate
9520: 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  d..*/.int sqlite
9530: 33 56 64 62 65 48 61 6c 74 28 56 64 62 65 20 2a  3VdbeHalt(Vdbe *
9540: 70 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  p){.  sqlite3 *d
9550: 62 20 3d 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74  b = p->db;.  int
9560: 20 69 3b 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e   i;.  int (*xFun
9570: 63 29 28 42 74 72 65 65 20 2a 70 42 74 29 20 3d  c)(Btree *pBt) =
9580: 20 30 3b 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e   0;  /* Function
9590: 20 74 6f 20 63 61 6c 6c 20 6f 6e 20 65 61 63 68   to call on each
95a0: 20 62 74 72 65 65 20 62 61 63 6b 65 6e 64 20 2a   btree backend *
95b0: 2f 0a 20 20 69 6e 74 20 69 73 53 70 65 63 69 61  /.  int isSpecia
95c0: 6c 45 72 72 6f 72 3b 20 20 20 20 20 20 20 20 20  lError;         
95d0: 20 20 20 2f 2a 20 53 65 74 20 74 6f 20 74 72 75     /* Set to tru
95e0: 65 20 69 66 20 53 51 4c 49 54 45 5f 4e 4f 4d 45  e if SQLITE_NOME
95f0: 4d 20 6f 72 20 49 4f 45 52 52 20 2a 2f 0a 0a 20  M or IOERR */.. 
9600: 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f   /* This functio
9610: 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6c  n contains the l
9620: 6f 67 69 63 20 74 68 61 74 20 64 65 74 65 72 6d  ogic that determ
9630: 69 6e 65 73 20 69 66 20 61 20 73 74 61 74 65 6d  ines if a statem
9640: 65 6e 74 20 6f 72 0a 20 20 2a 2a 20 74 72 61 6e  ent or.  ** tran
9650: 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20  saction will be 
9660: 63 6f 6d 6d 69 74 74 65 64 20 6f 72 20 72 6f 6c  committed or rol
9670: 6c 65 64 20 62 61 63 6b 20 61 73 20 61 20 72 65  led back as a re
9680: 73 75 6c 74 20 6f 66 20 74 68 65 0a 20 20 2a 2a  sult of the.  **
9690: 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74 68   execution of th
96a0: 69 73 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  is virtual machi
96b0: 6e 65 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 53  ne. .  **.  ** S
96c0: 70 65 63 69 61 6c 20 65 72 72 6f 72 73 3a 0a 20  pecial errors:. 
96d0: 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 49 66 20   **.  **     If 
96e0: 61 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20  an SQLITE_NOMEM 
96f0: 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72 65  error has occure
9700: 64 20 69 6e 20 61 20 73 74 61 74 65 6d 65 6e 74  d in a statement
9710: 20 74 68 61 74 20 77 72 69 74 65 73 20 74 6f 0a   that writes to.
9720: 20 20 2a 2a 20 20 20 20 20 74 68 65 20 64 61 74    **     the dat
9730: 61 62 61 73 65 2c 20 74 68 65 6e 20 65 69 74 68  abase, then eith
9740: 65 72 20 61 20 73 74 61 74 65 6d 65 6e 74 20 6f  er a statement o
9750: 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75  r transaction mu
9760: 73 74 20 62 65 20 72 6f 6c 6c 65 64 0a 20 20 2a  st be rolled.  *
9770: 2a 20 20 20 20 20 62 61 63 6b 20 74 6f 20 65 6e  *     back to en
9780: 73 75 72 65 20 74 68 65 20 74 72 65 65 2d 73 74  sure the tree-st
9790: 72 75 63 74 75 72 65 73 20 61 72 65 20 69 6e 20  ructures are in 
97a0: 61 20 63 6f 6e 73 69 73 74 65 6e 74 20 73 74 61  a consistent sta
97b0: 74 65 2e 20 41 0a 20 20 2a 2a 20 20 20 20 20 73  te. A.  **     s
97c0: 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 63  tatement transac
97d0: 74 69 6f 6e 20 69 73 20 72 6f 6c 6c 65 64 20 62  tion is rolled b
97e0: 61 63 6b 20 69 66 20 6f 6e 65 20 69 73 20 6f 70  ack if one is op
97f0: 65 6e 2c 20 6f 74 68 65 72 77 69 73 65 20 74 68  en, otherwise th
9800: 65 0a 20 20 2a 2a 20 20 20 20 20 65 6e 74 69 72  e.  **     entir
9810: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75  e transaction mu
9820: 73 74 20 62 65 20 72 6f 6c 6c 65 64 20 62 61 63  st be rolled bac
9830: 6b 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20  k..  **.  **    
9840: 20 49 66 20 61 6e 20 53 51 4c 49 54 45 5f 49 4f   If an SQLITE_IO
9850: 45 52 52 20 65 72 72 6f 72 20 68 61 73 20 6f 63  ERR error has oc
9860: 63 75 72 65 64 20 69 6e 20 61 20 73 74 61 74 65  cured in a state
9870: 6d 65 6e 74 20 74 68 61 74 20 77 72 69 74 65 73  ment that writes
9880: 20 74 6f 0a 20 20 2a 2a 20 20 20 20 20 74 68 65   to.  **     the
9890: 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 6e 20   database, then 
98a0: 74 68 65 20 65 6e 74 69 72 65 20 74 72 61 6e 73  the entire trans
98b0: 61 63 74 69 6f 6e 20 6d 75 73 74 20 62 65 20 72  action must be r
98c0: 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 54 68 65 0a  olled back. The.
98d0: 20 20 2a 2a 20 20 20 20 20 49 2f 4f 20 65 72 72    **     I/O err
98e0: 6f 72 20 6d 61 79 20 68 61 76 65 20 63 61 75 73  or may have caus
98f0: 65 64 20 67 61 72 62 61 67 65 20 74 6f 20 62 65  ed garbage to be
9900: 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65 20   written to the 
9910: 6a 6f 75 72 6e 61 6c 20 0a 20 20 2a 2a 20 20 20  journal .  **   
9920: 20 20 66 69 6c 65 2e 20 57 65 72 65 20 74 68 65    file. Were the
9930: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 6f 20   transaction to 
9940: 63 6f 6e 74 69 6e 75 65 20 61 6e 64 20 65 76 65  continue and eve
9950: 6e 74 75 61 6c 6c 79 20 62 65 20 72 6f 6c 6c 65  ntually be rolle
9960: 64 20 0a 20 20 2a 2a 20 20 20 20 20 62 61 63 6b  d .  **     back
9970: 20 74 68 61 74 20 67 61 72 62 61 67 65 20 6d 69   that garbage mi
9980: 67 68 74 20 65 6e 64 20 75 70 20 69 6e 20 74 68  ght end up in th
9990: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e  e database file.
99a0: 0a 20 20 2a 2a 20 20 20 20 20 0a 20 20 2a 2a 20  .  **     .  ** 
99b0: 20 20 20 20 49 6e 20 62 6f 74 68 20 6f 66 20 74      In both of t
99c0: 68 65 20 61 62 6f 76 65 20 63 61 73 65 73 2c 20  he above cases, 
99d0: 74 68 65 20 56 64 62 65 2e 65 72 72 6f 72 41 63  the Vdbe.errorAc
99e0: 74 69 6f 6e 20 76 61 72 69 61 62 6c 65 20 69 73  tion variable is
99f0: 20 0a 20 20 2a 2a 20 20 20 20 20 69 67 6e 6f 72   .  **     ignor
9a00: 65 64 2e 20 49 66 20 74 68 65 20 73 71 6c 69 74  ed. If the sqlit
9a10: 65 33 2e 61 75 74 6f 43 6f 6d 6d 69 74 20 66 6c  e3.autoCommit fl
9a20: 61 67 20 69 73 20 66 61 6c 73 65 20 61 6e 64 20  ag is false and 
9a30: 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20  a transaction.  
9a40: 2a 2a 20 20 20 20 20 69 73 20 72 6f 6c 6c 65 64  **     is rolled
9a50: 20 62 61 63 6b 2c 20 69 74 20 77 69 6c 6c 20 62   back, it will b
9a60: 65 20 73 65 74 20 74 6f 20 74 72 75 65 2e 0a 20  e set to true.. 
9a70: 20 2a 2a 0a 20 20 2a 2a 20 4f 74 68 65 72 20 65   **.  ** Other e
9a80: 72 72 6f 72 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a  rrors:.  **.  **
9a90: 20 4e 6f 20 65 72 72 6f 72 3a 0a 20 20 2a 2a 0a   No error:.  **.
9aa0: 20 20 2a 2f 0a 0a 20 20 69 66 28 20 73 71 6c 69    */..  if( sqli
9ab0: 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28  te3MallocFailed(
9ac0: 29 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  ) ){.    p->rc =
9ad0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
9ae0: 20 7d 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69   }.  if( p->magi
9af0: 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55  c!=VDBE_MAGIC_RU
9b00: 4e 20 29 7b 0a 20 20 20 20 2f 2a 20 41 6c 72 65  N ){.    /* Alre
9b10: 61 64 79 20 68 61 6c 74 65 64 2e 20 20 4e 6f 74  ady halted.  Not
9b20: 68 69 6e 67 20 74 6f 20 64 6f 2e 20 2a 2f 0a 20  hing to do. */. 
9b30: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61     assert( p->ma
9b40: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
9b50: 48 41 4c 54 20 29 3b 0a 23 69 66 6e 64 65 66 20  HALT );.#ifndef 
9b60: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54  SQLITE_OMIT_VIRT
9b70: 55 41 4c 54 41 42 4c 45 0a 20 20 20 20 63 6c 6f  UALTABLE.    clo
9b80: 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 29 3b  seAllCursors(p);
9b90: 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 74 75  .#endif.    retu
9ba0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20  rn SQLITE_OK;.  
9bb0: 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73  }.  closeAllCurs
9bc0: 6f 72 73 28 70 29 3b 0a 20 20 63 68 65 63 6b 41  ors(p);.  checkA
9bd0: 63 74 69 76 65 56 64 62 65 43 6e 74 28 64 62 29  ctiveVdbeCnt(db)
9be0: 3b 0a 0a 20 20 2f 2a 20 4e 6f 20 63 6f 6d 6d 69  ;..  /* No commi
9bf0: 74 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 6e 65  t or rollback ne
9c00: 65 64 65 64 20 69 66 20 74 68 65 20 70 72 6f 67  eded if the prog
9c10: 72 61 6d 20 6e 65 76 65 72 20 73 74 61 72 74 65  ram never starte
9c20: 64 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63  d */.  if( p->pc
9c30: 3e 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6d  >=0 ){.    int m
9c40: 72 63 3b 20 20 20 2f 2a 20 50 72 69 6d 61 72 79  rc;   /* Primary
9c50: 20 65 72 72 6f 72 20 63 6f 64 65 20 66 72 6f 6d   error code from
9c60: 20 70 2d 3e 72 63 20 2a 2f 0a 20 20 20 20 2f 2a   p->rc */.    /*
9c70: 20 43 68 65 63 6b 20 66 6f 72 20 6f 6e 65 20 6f   Check for one o
9c80: 66 20 74 68 65 20 73 70 65 63 69 61 6c 20 65 72  f the special er
9c90: 72 6f 72 73 20 2d 20 53 51 4c 49 54 45 5f 4e 4f  rors - SQLITE_NO
9ca0: 4d 45 4d 20 6f 72 20 53 51 4c 49 54 45 5f 49 4f  MEM or SQLITE_IO
9cb0: 45 52 52 20 2a 2f 0a 20 20 20 20 6d 72 63 20 3d  ERR */.    mrc =
9cc0: 20 70 2d 3e 72 63 20 26 20 30 78 66 66 3b 0a 20   p->rc & 0xff;. 
9cd0: 20 20 20 69 73 53 70 65 63 69 61 6c 45 72 72 6f     isSpecialErro
9ce0: 72 20 3d 20 28 28 6d 72 63 3d 3d 53 51 4c 49 54  r = ((mrc==SQLIT
9cf0: 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 6d 72 63 3d 3d  E_NOMEM || mrc==
9d00: 53 51 4c 49 54 45 5f 49 4f 45 52 52 29 3f 31 3a  SQLITE_IOERR)?1:
9d10: 30 29 3b 0a 20 20 20 20 69 66 28 20 69 73 53 70  0);.    if( isSp
9d20: 65 63 69 61 6c 45 72 72 6f 72 20 29 7b 0a 20 20  ecialError ){.  
9d30: 20 20 20 20 2f 2a 20 54 68 69 73 20 6c 6f 6f 70      /* This loop
9d40: 20 64 6f 65 73 20 73 74 61 74 69 63 20 61 6e 61   does static ana
9d50: 6c 79 73 69 73 20 6f 66 20 74 68 65 20 71 75 65  lysis of the que
9d60: 72 79 20 74 6f 20 73 65 65 20 77 68 69 63 68 20  ry to see which 
9d70: 6f 66 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20  of the.      ** 
9d80: 66 6f 6c 6c 6f 77 69 6e 67 20 74 68 72 65 65 20  following three 
9d90: 63 61 74 65 67 6f 72 69 65 73 20 69 74 20 66 61  categories it fa
9da0: 6c 6c 73 20 69 6e 74 6f 3a 0a 20 20 20 20 20 20  lls into:.      
9db0: 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 20  **.      **     
9dc0: 52 65 61 64 2d 6f 6e 6c 79 0a 20 20 20 20 20 20  Read-only.      
9dd0: 2a 2a 20 20 20 20 20 51 75 65 72 79 20 77 69 74  **     Query wit
9de0: 68 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72  h statement jour
9df0: 6e 61 6c 0a 20 20 20 20 20 20 2a 2a 20 20 20 20  nal.      **    
9e00: 20 51 75 65 72 79 20 77 69 74 68 6f 75 74 20 73   Query without s
9e10: 74 61 74 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c  tatement journal
9e20: 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20  .      **.      
9e30: 2a 2a 20 57 65 20 63 6f 75 6c 64 20 64 6f 20 73  ** We could do s
9e40: 6f 6d 65 74 68 69 6e 67 20 6d 6f 72 65 20 65 6c  omething more el
9e50: 65 67 61 6e 74 20 74 68 61 6e 20 74 68 69 73 20  egant than this 
9e60: 73 74 61 74 69 63 20 61 6e 61 6c 79 73 69 73 20  static analysis 
9e70: 28 69 2e 65 2e 0a 20 20 20 20 20 20 2a 2a 20 73  (i.e..      ** s
9e80: 74 6f 72 65 20 74 68 65 20 74 79 70 65 20 6f 66  tore the type of
9e90: 20 71 75 65 72 79 20 61 73 20 70 61 72 74 20 6f   query as part o
9ea0: 66 20 74 68 65 20 63 6f 6d 70 6c 69 61 74 69 6f  f the compliatio
9eb0: 6e 20 70 68 61 73 65 29 2c 20 62 75 74 20 0a 20  n phase), but . 
9ec0: 20 20 20 20 20 2a 2a 20 68 61 6e 64 6c 69 6e 67       ** handling
9ed0: 20 6d 61 6c 6c 6f 63 28 29 20 6f 72 20 49 4f 20   malloc() or IO 
9ee0: 66 61 69 6c 75 72 65 20 69 73 20 61 20 66 61 69  failure is a fai
9ef0: 72 6c 79 20 6f 62 73 63 75 72 65 20 65 64 67 65  rly obscure edge
9f00: 20 63 61 73 65 20 73 6f 20 0a 20 20 20 20 20 20   case so .      
9f10: 2a 2a 20 74 68 69 73 20 69 73 20 70 72 6f 62 61  ** this is proba
9f20: 62 6c 79 20 65 61 73 69 65 72 2e 20 54 6f 64 6f  bly easier. Todo
9f30: 3a 20 4d 69 67 68 74 20 62 65 20 61 6e 20 6f 70  : Might be an op
9f40: 70 6f 72 74 75 6e 69 74 79 20 74 6f 20 72 65 64  portunity to red
9f50: 75 63 65 20 0a 20 20 20 20 20 20 2a 2a 20 63 6f  uce .      ** co
9f60: 64 65 20 73 69 7a 65 20 61 20 76 65 72 79 20 73  de size a very s
9f70: 6d 61 6c 6c 20 61 6d 6f 75 6e 74 20 74 68 6f 75  mall amount thou
9f80: 67 68 2e 2e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  gh....      */. 
9f90: 20 20 20 20 20 69 6e 74 20 69 73 52 65 61 64 4f       int isReadO
9fa0: 6e 6c 79 20 3d 20 31 3b 0a 20 20 20 20 20 20 69  nly = 1;.      i
9fb0: 6e 74 20 69 73 53 74 61 74 65 6d 65 6e 74 20 3d  nt isStatement =
9fc0: 20 30 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74   0;.      assert
9fd0: 28 70 2d 3e 61 4f 70 20 7c 7c 20 70 2d 3e 6e 4f  (p->aOp || p->nO
9fe0: 70 3d 3d 30 29 3b 0a 20 20 20 20 20 20 66 6f 72  p==0);.      for
9ff0: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20  (i=0; i<p->nOp; 
a000: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 20 20 73  i++){ .        s
a010: 77 69 74 63 68 28 20 70 2d 3e 61 4f 70 5b 69 5d  witch( p->aOp[i]
a020: 2e 6f 70 63 6f 64 65 20 29 7b 0a 20 20 20 20 20  .opcode ){.     
a030: 20 20 20 20 20 63 61 73 65 20 4f 50 5f 54 72 61       case OP_Tra
a040: 6e 73 61 63 74 69 6f 6e 3a 0a 20 20 20 20 20 20  nsaction:.      
a050: 20 20 20 20 20 20 69 73 52 65 61 64 4f 6e 6c 79        isReadOnly
a060: 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20   = 0;.          
a070: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20    break;.       
a080: 20 20 20 63 61 73 65 20 4f 50 5f 53 74 61 74 65     case OP_State
a090: 6d 65 6e 74 3a 0a 20 20 20 20 20 20 20 20 20 20  ment:.          
a0a0: 20 20 69 73 53 74 61 74 65 6d 65 6e 74 20 3d 20    isStatement = 
a0b0: 31 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62  1;.            b
a0c0: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a  reak;.        }.
a0d0: 20 20 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 20        }.  .     
a0e0: 20 2f 2a 20 49 66 20 74 68 65 20 71 75 65 72 79   /* If the query
a0f0: 20 77 61 73 20 72 65 61 64 2d 6f 6e 6c 79 2c 20   was read-only, 
a100: 77 65 20 6e 65 65 64 20 64 6f 20 6e 6f 20 72 6f  we need do no ro
a110: 6c 6c 62 61 63 6b 20 61 74 20 61 6c 6c 2e 20 4f  llback at all. O
a120: 74 68 65 72 77 69 73 65 2c 0a 20 20 20 20 20 20  therwise,.      
a130: 2a 2a 20 70 72 6f 63 65 65 64 20 77 69 74 68 20  ** proceed with 
a140: 74 68 65 20 73 70 65 63 69 61 6c 20 68 61 6e 64  the special hand
a150: 6c 69 6e 67 2e 0a 20 20 20 20 20 20 2a 2f 0a 20  ling..      */. 
a160: 20 20 20 20 20 69 66 28 20 21 69 73 52 65 61 64       if( !isRead
a170: 4f 6e 6c 79 20 29 7b 0a 20 20 20 20 20 20 20 20  Only ){.        
a180: 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54  if( p->rc==SQLIT
a190: 45 5f 4e 4f 4d 45 4d 20 26 26 20 69 73 53 74 61  E_NOMEM && isSta
a1a0: 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20 20 20 20  tement ){.      
a1b0: 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c 69      xFunc = sqli
a1c0: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
a1d0: 53 74 6d 74 3b 0a 20 20 20 20 20 20 20 20 7d 65  Stmt;.        }e
a1e0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f  lse{.          /
a1f0: 2a 20 57 65 20 61 72 65 20 66 6f 72 63 65 64 20  * We are forced 
a200: 74 6f 20 72 6f 6c 6c 20 62 61 63 6b 20 74 68 65  to roll back the
a210: 20 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 74   active transact
a220: 69 6f 6e 2e 20 42 65 66 6f 72 65 20 64 6f 69 6e  ion. Before doin
a230: 67 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73  g.          ** s
a240: 6f 2c 20 61 62 6f 72 74 20 61 6e 79 20 6f 74 68  o, abort any oth
a250: 65 72 20 73 74 61 74 65 6d 65 6e 74 73 20 74 68  er statements th
a260: 69 73 20 68 61 6e 64 6c 65 20 63 75 72 72 65 6e  is handle curren
a270: 74 6c 79 20 68 61 73 20 61 63 74 69 76 65 2e 0a  tly has active..
a280: 20 20 20 20 20 20 20 20 20 20 2a 2f 0a 20 20 20            */.   
a290: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 41 62         sqlite3Ab
a2a0: 6f 72 74 4f 74 68 65 72 41 63 74 69 76 65 56 64  ortOtherActiveVd
a2b0: 62 65 73 28 64 62 2c 20 70 29 3b 0a 20 20 20 20  bes(db, p);.    
a2c0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 6f 6c        sqlite3Rol
a2d0: 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a 20 20  lbackAll(db);.  
a2e0: 20 20 20 20 20 20 20 20 64 62 2d 3e 61 75 74 6f          db->auto
a2f0: 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20  Commit = 1;.    
a300: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20      }.      }.  
a310: 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 49 66    }.  .    /* If
a320: 20 74 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74   the auto-commit
a330: 20 66 6c 61 67 20 69 73 20 73 65 74 20 61 6e 64   flag is set and
a340: 20 74 68 69 73 20 69 73 20 74 68 65 20 6f 6e 6c   this is the onl
a350: 79 20 61 63 74 69 76 65 20 76 64 62 65 2c 20 74  y active vdbe, t
a360: 68 65 6e 0a 20 20 20 20 2a 2a 20 77 65 20 64 6f  hen.    ** we do
a370: 20 65 69 74 68 65 72 20 61 20 63 6f 6d 6d 69 74   either a commit
a380: 20 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 6f 66 20   or rollback of 
a390: 74 68 65 20 63 75 72 72 65 6e 74 20 74 72 61 6e  the current tran
a3a0: 73 61 63 74 69 6f 6e 2e 20 0a 20 20 20 20 2a 2a  saction. .    **
a3b0: 0a 20 20 20 20 2a 2a 20 4e 6f 74 65 3a 20 54 68  .    ** Note: Th
a3c0: 69 73 20 62 6c 6f 63 6b 20 61 6c 73 6f 20 72 75  is block also ru
a3d0: 6e 73 20 69 66 20 6f 6e 65 20 6f 66 20 74 68 65  ns if one of the
a3e0: 20 73 70 65 63 69 61 6c 20 65 72 72 6f 72 73 20   special errors 
a3f0: 68 61 6e 64 6c 65 64 20 0a 20 20 20 20 2a 2a 20  handled .    ** 
a400: 61 62 6f 76 65 20 68 61 73 20 6f 63 63 75 72 65  above has occure
a410: 64 2e 20 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69  d. .    */.    i
a420: 66 28 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69  f( db->autoCommi
a430: 74 20 26 26 20 64 62 2d 3e 61 63 74 69 76 65 56  t && db->activeV
a440: 64 62 65 43 6e 74 3d 3d 31 20 29 7b 0a 20 20 20  dbeCnt==1 ){.   
a450: 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51     if( p->rc==SQ
a460: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 28 70 2d 3e 65  LITE_OK || (p->e
a470: 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46  rrorAction==OE_F
a480: 61 69 6c 20 26 26 20 21 69 73 53 70 65 63 69 61  ail && !isSpecia
a490: 6c 45 72 72 6f 72 29 20 29 7b 0a 09 2f 2a 20 54  lError) ){../* T
a4a0: 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66  he auto-commit f
a4b0: 6c 61 67 20 69 73 20 74 72 75 65 2c 20 61 6e 64  lag is true, and
a4c0: 20 74 68 65 20 76 64 62 65 20 70 72 6f 67 72 61   the vdbe progra
a4d0: 6d 20 77 61 73 20 0a 20 20 20 20 20 20 20 20 2a  m was .        *
a4e0: 2a 20 73 75 63 63 65 73 73 66 75 6c 20 6f 72 20  * successful or 
a4f0: 68 69 74 20 61 6e 20 27 4f 52 20 46 41 49 4c 27  hit an 'OR FAIL'
a500: 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20 54 68 69   constraint. Thi
a510: 73 20 6d 65 61 6e 73 20 61 20 63 6f 6d 6d 69 74  s means a commit
a520: 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 73 20   .        ** is 
a530: 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 20 20  required..      
a540: 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 6e 74    */.        int
a550: 20 72 63 20 3d 20 76 64 62 65 43 6f 6d 6d 69 74   rc = vdbeCommit
a560: 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 69 66  (db);.        if
a570: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53  ( rc==SQLITE_BUS
a580: 59 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72  Y ){.          r
a590: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53  eturn SQLITE_BUS
a5a0: 59 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65  Y;.        }else
a5b0: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
a5c0: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  OK ){.          
a5d0: 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20  p->rc = rc;.    
a5e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 6f 6c        sqlite3Rol
a5f0: 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a 20 20  lbackAll(db);.  
a600: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
a610: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 43 6f         sqlite3Co
a620: 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e  mmitInternalChan
a630: 67 65 73 28 64 62 29 3b 0a 20 20 20 20 20 20 20  ges(db);.       
a640: 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a   }.      }else{.
a650: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 52          sqlite3R
a660: 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b 0a  ollbackAll(db);.
a670: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73        }.    }els
a680: 65 20 69 66 28 20 21 78 46 75 6e 63 20 29 7b 0a  e if( !xFunc ){.
a690: 20 20 20 20 20 20 69 66 28 20 70 2d 3e 72 63 3d        if( p->rc=
a6a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d  =SQLITE_OK || p-
a6b0: 3e 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45  >errorAction==OE
a6c0: 5f 46 61 69 6c 20 29 7b 0a 20 20 20 20 20 20 20  _Fail ){.       
a6d0: 20 78 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 33   xFunc = sqlite3
a6e0: 42 74 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74 3b  BtreeCommitStmt;
a6f0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28  .      }else if(
a700: 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f 6e 3d   p->errorAction=
a710: 3d 4f 45 5f 41 62 6f 72 74 20 29 7b 0a 20 20 20  =OE_Abort ){.   
a720: 20 20 20 20 20 78 46 75 6e 63 20 3d 20 73 71 6c       xFunc = sql
a730: 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63  ite3BtreeRollbac
a740: 6b 53 74 6d 74 3b 0a 20 20 20 20 20 20 7d 65 6c  kStmt;.      }el
a750: 73 65 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  se{.        sqli
a760: 74 65 33 41 62 6f 72 74 4f 74 68 65 72 41 63 74  te3AbortOtherAct
a770: 69 76 65 56 64 62 65 73 28 64 62 2c 20 70 29 3b  iveVdbes(db, p);
a780: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
a790: 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b  RollbackAll(db);
a7a0: 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61 75 74  .        db->aut
a7b0: 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 20  oCommit = 1;.   
a7c0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20     }.    }.  .  
a7d0: 20 20 2f 2a 20 49 66 20 78 46 75 6e 63 20 69 73    /* If xFunc is
a7e0: 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20   not NULL, then 
a7f0: 69 74 20 69 73 20 6f 6e 65 20 6f 66 20 73 71 6c  it is one of sql
a800: 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63  ite3BtreeRollbac
a810: 6b 53 74 6d 74 20 6f 72 0a 20 20 20 20 2a 2a 20  kStmt or.    ** 
a820: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
a830: 69 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74 20  itStmt. Call it 
a840: 6f 6e 63 65 20 6f 6e 20 65 61 63 68 20 62 61 63  once on each bac
a850: 6b 65 6e 64 2e 20 49 66 20 61 6e 20 65 72 72 6f  kend. If an erro
a860: 72 20 6f 63 63 75 72 73 0a 20 20 20 20 2a 2a 20  r occurs.    ** 
a870: 61 6e 64 20 74 68 65 20 72 65 74 75 72 6e 20 63  and the return c
a880: 6f 64 65 20 69 73 20 73 74 69 6c 6c 20 53 51 4c  ode is still SQL
a890: 49 54 45 5f 4f 4b 2c 20 73 65 74 20 74 68 65 20  ITE_OK, set the 
a8a0: 72 65 74 75 72 6e 20 63 6f 64 65 20 74 6f 20 74  return code to t
a8b0: 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20 65 72  he new.    ** er
a8c0: 72 6f 72 20 76 61 6c 75 65 2e 0a 20 20 20 20 2a  ror value..    *
a8d0: 2f 0a 20 20 20 20 61 73 73 65 72 74 28 21 78 46  /.    assert(!xF
a8e0: 75 6e 63 20 7c 7c 0a 20 20 20 20 20 20 78 46 75  unc ||.      xFu
a8f0: 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 65  nc==sqlite3Btree
a900: 43 6f 6d 6d 69 74 53 74 6d 74 20 7c 7c 0a 20 20  CommitStmt ||.  
a910: 20 20 20 20 78 46 75 6e 63 3d 3d 73 71 6c 69 74      xFunc==sqlit
a920: 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 53  e3BtreeRollbackS
a930: 74 6d 74 0a 20 20 20 20 29 3b 0a 20 20 20 20 66  tmt.    );.    f
a940: 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63 20 26 26  or(i=0; xFunc &&
a950: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
a960: 7b 20 0a 20 20 20 20 20 20 69 6e 74 20 72 63 3b  { .      int rc;
a970: 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42  .      Btree *pB
a980: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70  t = db->aDb[i].p
a990: 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42  Bt;.      if( pB
a9a0: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20  t ){.        rc 
a9b0: 3d 20 78 46 75 6e 63 28 70 42 74 29 3b 0a 20 20  = xFunc(pBt);.  
a9c0: 20 20 20 20 20 20 69 66 28 20 72 63 20 26 26 20        if( rc && 
a9d0: 28 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  (p->rc==SQLITE_O
a9e0: 4b 20 7c 7c 20 70 2d 3e 72 63 3d 3d 53 51 4c 49  K || p->rc==SQLI
a9f0: 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 29 20 29  TE_CONSTRAINT) )
aa00: 7b 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 72  {.          p->r
aa10: 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20 20 20  c = rc;.        
aa20: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
aa30: 6e 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67 2c 20  ng(&p->zErrMsg, 
aa40: 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  0);.        }.  
aa50: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20      }.    }.  . 
aa60: 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 77 61     /* If this wa
aa70: 73 20 61 6e 20 49 4e 53 45 52 54 2c 20 55 50 44  s an INSERT, UPD
aa80: 41 54 45 20 6f 72 20 44 45 4c 45 54 45 20 61 6e  ATE or DELETE an
aa90: 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  d the statement 
aaa0: 77 61 73 20 63 6f 6d 6d 69 74 74 65 64 2c 20 0a  was committed, .
aab0: 20 20 20 20 2a 2a 20 73 65 74 20 74 68 65 20 63      ** set the c
aac0: 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20 0a  hange counter. .
aad0: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70      */.    if( p
aae0: 2d 3e 63 68 61 6e 67 65 43 6e 74 4f 6e 20 26 26  ->changeCntOn &&
aaf0: 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20   p->pc>=0 ){.   
ab00: 20 20 20 69 66 28 20 21 78 46 75 6e 63 20 7c 7c     if( !xFunc ||
ab10: 20 78 46 75 6e 63 3d 3d 73 71 6c 69 74 65 33 42   xFunc==sqlite3B
ab20: 74 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74 20 29  treeCommitStmt )
ab30: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
ab40: 33 56 64 62 65 53 65 74 43 68 61 6e 67 65 73 28  3VdbeSetChanges(
ab50: 64 62 2c 20 70 2d 3e 6e 43 68 61 6e 67 65 29 3b  db, p->nChange);
ab60: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
ab70: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
ab80: 65 53 65 74 43 68 61 6e 67 65 73 28 64 62 2c 20  eSetChanges(db, 
ab90: 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  0);.      }.    
aba0: 20 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d 20 30    p->nChange = 0
abb0: 3b 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f  ;.    }.  .    /
abc0: 2a 20 52 6f 6c 6c 62 61 63 6b 20 6f 72 20 63 6f  * Rollback or co
abd0: 6d 6d 69 74 20 61 6e 79 20 73 63 68 65 6d 61 20  mmit any schema 
abe0: 63 68 61 6e 67 65 73 20 74 68 61 74 20 6f 63 63  changes that occ
abf0: 75 72 72 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66  urred. */.    if
ac00: 28 20 70 2d 3e 72 63 21 3d 53 51 4c 49 54 45 5f  ( p->rc!=SQLITE_
ac10: 4f 4b 20 26 26 20 64 62 2d 3e 66 6c 61 67 73 26  OK && db->flags&
ac20: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61  SQLITE_InternCha
ac30: 6e 67 65 73 20 29 7b 0a 20 20 20 20 20 20 73 71  nges ){.      sq
ac40: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e  lite3ResetIntern
ac50: 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b  alSchema(db, 0);
ac60: 0a 20 20 20 20 20 20 64 62 2d 3e 66 6c 61 67 73  .      db->flags
ac70: 20 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20 7c 20   = (db->flags | 
ac80: 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61  SQLITE_InternCha
ac90: 6e 67 65 73 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  nges);.    }.  }
aca0: 0a 0a 20 20 2f 2a 20 57 65 20 68 61 76 65 20 73  ..  /* We have s
acb0: 75 63 63 65 73 73 66 75 6c 6c 79 20 68 61 6c 74  uccessfully halt
acc0: 65 64 20 61 6e 64 20 63 6c 6f 73 65 64 20 74 68  ed and closed th
acd0: 65 20 56 4d 2e 20 20 52 65 63 6f 72 64 20 74 68  e VM.  Record th
ace0: 69 73 20 66 61 63 74 2e 20 2a 2f 0a 20 20 69 66  is fact. */.  if
acf0: 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20  ( p->pc>=0 ){.  
ad00: 20 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65    db->activeVdbe
ad10: 43 6e 74 2d 2d 3b 0a 20 20 7d 0a 20 20 70 2d 3e  Cnt--;.  }.  p->
ad20: 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47  magic = VDBE_MAG
ad30: 49 43 5f 48 41 4c 54 3b 0a 20 20 63 68 65 63 6b  IC_HALT;.  check
ad40: 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 64 62  ActiveVdbeCnt(db
ad50: 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 53 51 4c  );..  return SQL
ad60: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  ITE_OK;.}../*.**
ad70: 20 45 61 63 68 20 56 44 42 45 20 68 6f 6c 64 73   Each VDBE holds
ad80: 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66 20 74   the result of t
ad90: 68 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 20 73  he most recent s
ada0: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 20 63 61  qlite3_step() ca
adb0: 6c 6c 0a 2a 2a 20 69 6e 20 70 2d 3e 72 63 2e 20  ll.** in p->rc. 
adc0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73 65   This routine se
add0: 74 73 20 74 68 61 74 20 72 65 73 75 6c 74 20 62  ts that result b
ade0: 61 63 6b 20 74 6f 20 53 51 4c 49 54 45 5f 4f 4b  ack to SQLITE_OK
adf0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
ae00: 33 56 64 62 65 52 65 73 65 74 53 74 65 70 52 65  3VdbeResetStepRe
ae10: 73 75 6c 74 28 56 64 62 65 20 2a 70 29 7b 0a 20  sult(Vdbe *p){. 
ae20: 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f   p->rc = SQLITE_
ae30: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65  OK;.}../*.** Cle
ae40: 61 6e 20 75 70 20 61 20 56 44 42 45 20 61 66 74  an up a VDBE aft
ae50: 65 72 20 65 78 65 63 75 74 69 6f 6e 20 62 75 74  er execution but
ae60: 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74   do not delete t
ae70: 68 65 20 56 44 42 45 20 6a 75 73 74 20 79 65 74  he VDBE just yet
ae80: 2e 0a 2a 2a 20 57 72 69 74 65 20 61 6e 79 20 65  ..** Write any e
ae90: 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69 6e  rror messages in
aea0: 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 20 20 52  to *pzErrMsg.  R
aeb0: 65 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74  eturn the result
aec0: 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66 74   code..**.** Aft
aed0: 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  er this routine 
aee0: 69 73 20 72 75 6e 2c 20 74 68 65 20 56 44 42 45  is run, the VDBE
aef0: 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61 64 79   should be ready
af00: 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 0a   to be executed.
af10: 2a 2a 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a 20  ** again..**.** 
af20: 54 6f 20 6c 6f 6f 6b 20 61 74 20 69 74 20 61 6e  To look at it an
af30: 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69 73 20  other way, this 
af40: 72 6f 75 74 69 6e 65 20 72 65 73 65 74 73 20 74  routine resets t
af50: 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 0a  he state of the.
af60: 2a 2a 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  ** virtual machi
af70: 6e 65 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41 47  ne from VDBE_MAG
af80: 49 43 5f 52 55 4e 20 6f 72 20 56 44 42 45 5f 4d  IC_RUN or VDBE_M
af90: 41 47 49 43 5f 48 41 4c 54 20 62 61 63 6b 20 74  AGIC_HALT back t
afa0: 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43 5f  o.** VDBE_MAGIC_
afb0: 49 4e 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  INIT..*/.int sql
afc0: 69 74 65 33 56 64 62 65 52 65 73 65 74 28 56 64  ite3VdbeReset(Vd
afd0: 62 65 20 2a 70 29 7b 0a 20 20 73 71 6c 69 74 65  be *p){.  sqlite
afe0: 33 20 2a 64 62 3b 0a 20 20 64 62 20 3d 20 70 2d  3 *db;.  db = p-
aff0: 3e 64 62 3b 0a 0a 20 20 2f 2a 20 49 66 20 74 68  >db;..  /* If th
b000: 65 20 56 4d 20 64 69 64 20 6e 6f 74 20 72 75 6e  e VM did not run
b010: 20 74 6f 20 63 6f 6d 70 6c 65 74 69 6f 6e 20 6f   to completion o
b020: 72 20 69 66 20 69 74 20 65 6e 63 6f 75 6e 74 65  r if it encounte
b030: 72 65 64 20 61 6e 0a 20 20 2a 2a 20 65 72 72 6f  red an.  ** erro
b040: 72 2c 20 74 68 65 6e 20 69 74 20 6d 69 67 68 74  r, then it might
b050: 20 6e 6f 74 20 68 61 76 65 20 62 65 65 6e 20 68   not have been h
b060: 61 6c 74 65 64 20 70 72 6f 70 65 72 6c 79 2e 20  alted properly. 
b070: 20 53 6f 20 68 61 6c 74 0a 20 20 2a 2a 20 69 74   So halt.  ** it
b080: 20 6e 6f 77 2e 0a 20 20 2a 2f 0a 20 20 73 71 6c   now..  */.  sql
b090: 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29  ite3SafetyOn(db)
b0a0: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 48  ;.  sqlite3VdbeH
b0b0: 61 6c 74 28 70 29 3b 0a 20 20 73 71 6c 69 74 65  alt(p);.  sqlite
b0c0: 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a  3SafetyOff(db);.
b0d0: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 56 44 42  .  /* If the VDB
b0e0: 45 20 68 61 73 20 62 65 20 72 75 6e 20 65 76 65  E has be run eve
b0f0: 6e 20 70 61 72 74 69 61 6c 6c 79 2c 20 74 68 65  n partially, the
b100: 6e 20 74 72 61 6e 73 66 65 72 20 74 68 65 20 65  n transfer the e
b110: 72 72 6f 72 20 63 6f 64 65 0a 20 20 2a 2a 20 61  rror code.  ** a
b120: 6e 64 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  nd error message
b130: 20 66 72 6f 6d 20 74 68 65 20 56 44 42 45 20 69   from the VDBE i
b140: 6e 74 6f 20 74 68 65 20 6d 61 69 6e 20 64 61 74  nto the main dat
b150: 61 62 61 73 65 20 73 74 72 75 63 74 75 72 65 2e  abase structure.
b160: 20 20 42 75 74 0a 20 20 2a 2a 20 69 66 20 74 68    But.  ** if th
b170: 65 20 56 44 42 45 20 68 61 73 20 6a 75 73 74 20  e VDBE has just 
b180: 62 65 65 6e 20 73 65 74 20 74 6f 20 72 75 6e 20  been set to run 
b190: 62 75 74 20 68 61 73 20 6e 6f 74 20 61 63 74 75  but has not actu
b1a0: 61 6c 6c 79 20 65 78 65 63 75 74 65 64 20 61 6e  ally executed an
b1b0: 79 0a 20 20 2a 2a 20 69 6e 73 74 72 75 63 74 69  y.  ** instructi
b1c0: 6f 6e 73 20 79 65 74 2c 20 6c 65 61 76 65 20 74  ons yet, leave t
b1d0: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
b1e0: 20 65 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69   error informati
b1f0: 6f 6e 20 75 6e 63 68 61 6e 67 65 64 2e 0a 20 20  on unchanged..  
b200: 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63 3e 3d  */.  if( p->pc>=
b210: 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e  0 ){.    if( p->
b220: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 20  zErrMsg ){.     
b230: 20 73 71 6c 69 74 65 33 56 61 6c 75 65 53 65 74   sqlite3ValueSet
b240: 53 74 72 28 64 62 2d 3e 70 45 72 72 2c 20 2d 31  Str(db->pErr, -1
b250: 2c 20 70 2d 3e 7a 45 72 72 4d 73 67 2c 20 53 51  , p->zErrMsg, SQ
b260: 4c 49 54 45 5f 55 54 46 38 2c 20 73 71 6c 69 74  LITE_UTF8, sqlit
b270: 65 33 46 72 65 65 58 29 3b 0a 20 20 20 20 20 20  e3FreeX);.      
b280: 64 62 2d 3e 65 72 72 43 6f 64 65 20 3d 20 70 2d  db->errCode = p-
b290: 3e 72 63 3b 0a 20 20 20 20 20 20 70 2d 3e 7a 45  >rc;.      p->zE
b2a0: 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20 7d  rrMsg = 0;.    }
b2b0: 65 6c 73 65 20 69 66 28 20 70 2d 3e 72 63 20 29  else if( p->rc )
b2c0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45  {.      sqlite3E
b2d0: 72 72 6f 72 28 64 62 2c 20 70 2d 3e 72 63 2c 20  rror(db, p->rc, 
b2e0: 30 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  0);.    }else{. 
b2f0: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f       sqlite3Erro
b300: 72 28 64 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c  r(db, SQLITE_OK,
b310: 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c   0);.    }.  }el
b320: 73 65 20 69 66 28 20 70 2d 3e 72 63 20 26 26 20  se if( p->rc && 
b330: 70 2d 3e 65 78 70 69 72 65 64 20 29 7b 0a 20 20  p->expired ){.  
b340: 20 20 2f 2a 20 54 68 65 20 65 78 70 69 72 65 64    /* The expired
b350: 20 66 6c 61 67 20 77 61 73 20 73 65 74 20 6f 6e   flag was set on
b360: 20 74 68 65 20 56 44 42 45 20 62 65 66 6f 72 65   the VDBE before
b370: 20 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 0a   the first call.
b380: 20 20 20 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65      ** to sqlite
b390: 33 5f 73 74 65 70 28 29 2e 20 46 6f 72 20 63 6f  3_step(). For co
b3a0: 6e 73 69 73 74 65 6e 63 79 20 28 73 69 6e 63 65  nsistency (since
b3b0: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 20   sqlite3_step() 
b3c0: 77 61 73 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 65  was.    ** calle
b3d0: 64 29 2c 20 73 65 74 20 74 68 65 20 64 61 74 61  d), set the data
b3e0: 62 61 73 65 20 65 72 72 6f 72 20 69 6e 20 74 68  base error in th
b3f0: 69 73 20 63 61 73 65 20 61 73 20 77 65 6c 6c 2e  is case as well.
b400: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69  .    */.    sqli
b410: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 70 2d 3e  te3Error(db, p->
b420: 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f  rc, 0);.  }..  /
b430: 2a 20 52 65 63 6c 61 69 6d 20 61 6c 6c 20 6d 65  * Reclaim all me
b440: 6d 6f 72 79 20 75 73 65 64 20 62 79 20 74 68 65  mory used by the
b450: 20 56 44 42 45 0a 20 20 2a 2f 0a 20 20 43 6c 65   VDBE.  */.  Cle
b460: 61 6e 75 70 28 70 29 3b 0a 0a 20 20 2f 2a 20 53  anup(p);..  /* S
b470: 61 76 65 20 70 72 6f 66 69 6c 69 6e 67 20 69 6e  ave profiling in
b480: 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74  formation from t
b490: 68 69 73 20 56 44 42 45 20 72 75 6e 2e 0a 20 20  his VDBE run..  
b4a0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  */.  assert( p->
b4b0: 70 54 6f 73 3c 26 70 2d 3e 61 53 74 61 63 6b 5b  pTos<&p->aStack[
b4c0: 70 2d 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70 63 5d  p->pc<0?0:p->pc]
b4d0: 20 7c 7c 20 21 70 2d 3e 61 53 74 61 63 6b 20 29   || !p->aStack )
b4e0: 3b 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50 52  ;.#ifdef VDBE_PR
b4f0: 4f 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20 46 49  OFILE.  {.    FI
b500: 4c 45 20 2a 6f 75 74 20 3d 20 66 6f 70 65 6e 28  LE *out = fopen(
b510: 22 76 64 62 65 5f 70 72 6f 66 69 6c 65 2e 6f 75  "vdbe_profile.ou
b520: 74 22 2c 20 22 61 22 29 3b 0a 20 20 20 20 69 66  t", "a");.    if
b530: 28 20 6f 75 74 20 29 7b 0a 20 20 20 20 20 20 69  ( out ){.      i
b540: 6e 74 20 69 3b 0a 20 20 20 20 20 20 66 70 72 69  nt i;.      fpri
b550: 6e 74 66 28 6f 75 74 2c 20 22 2d 2d 2d 2d 20 22  ntf(out, "---- "
b560: 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30  );.      for(i=0
b570: 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29  ; i<p->nOp; i++)
b580: 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74  {.        fprint
b590: 66 28 6f 75 74 2c 20 22 25 30 32 78 22 2c 20 70  f(out, "%02x", p
b5a0: 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64 65 29  ->aOp[i].opcode)
b5b0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
b5c0: 66 70 72 69 6e 74 66 28 6f 75 74 2c 20 22 5c 6e  fprintf(out, "\n
b5d0: 22 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d  ");.      for(i=
b5e0: 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b  0; i<p->nOp; i++
b5f0: 29 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e  ){.        fprin
b600: 74 66 28 6f 75 74 2c 20 22 25 36 64 20 25 31 30  tf(out, "%6d %10
b610: 6c 6c 64 20 25 38 6c 6c 64 20 22 2c 0a 20 20 20  lld %8lld ",.   
b620: 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69          p->aOp[i
b630: 5d 2e 63 6e 74 2c 0a 20 20 20 20 20 20 20 20 20  ].cnt,.         
b640: 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c    p->aOp[i].cycl
b650: 65 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70  es,.           p
b660: 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 3e 30 20 3f  ->aOp[i].cnt>0 ?
b670: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65   p->aOp[i].cycle
b680: 73 2f 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20  s/p->aOp[i].cnt 
b690: 3a 20 30 0a 20 20 20 20 20 20 20 20 29 3b 0a 20  : 0.        );. 
b6a0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64         sqlite3Vd
b6b0: 62 65 50 72 69 6e 74 4f 70 28 6f 75 74 2c 20 69  bePrintOp(out, i
b6c0: 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20  , &p->aOp[i]);. 
b6d0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 63 6c       }.      fcl
b6e0: 6f 73 65 28 6f 75 74 29 3b 0a 20 20 20 20 7d 0a  ose(out);.    }.
b6f0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e    }.#endif.  p->
b700: 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47  magic = VDBE_MAG
b710: 49 43 5f 49 4e 49 54 3b 0a 20 20 70 2d 3e 61 62  IC_INIT;.  p->ab
b720: 6f 72 74 65 64 20 3d 20 30 3b 0a 20 20 69 66 28  orted = 0;.  if(
b730: 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 53   p->rc==SQLITE_S
b740: 43 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c  CHEMA ){.    sql
b750: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
b760: 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a  lSchema(db, 0);.
b770: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e    }.  return p->
b780: 72 63 20 26 20 64 62 2d 3e 65 72 72 4d 61 73 6b  rc & db->errMask
b790: 3b 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c 65 61  ;.}. ./*.** Clea
b7a0: 6e 20 75 70 20 61 6e 64 20 64 65 6c 65 74 65 20  n up and delete 
b7b0: 61 20 56 44 42 45 20 61 66 74 65 72 20 65 78 65  a VDBE after exe
b7c0: 63 75 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20  cution.  Return 
b7d0: 61 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68  an integer which
b7e0: 20 69 73 0a 2a 2a 20 74 68 65 20 72 65 73 75 6c   is.** the resul
b7f0: 74 20 63 6f 64 65 2e 20 20 57 72 69 74 65 20 61  t code.  Write a
b800: 6e 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  ny error message
b810: 20 74 65 78 74 20 69 6e 74 6f 20 2a 70 7a 45 72   text into *pzEr
b820: 72 4d 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  rMsg..*/.int sql
b830: 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65  ite3VdbeFinalize
b840: 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74  (Vdbe *p){.  int
b850: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
b860: 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d  .  if( p->magic=
b870: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20  =VDBE_MAGIC_RUN 
b880: 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  || p->magic==VDB
b890: 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 7b 0a  E_MAGIC_HALT ){.
b8a0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
b8b0: 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a 20 20  VdbeReset(p);.  
b8c0: 20 20 61 73 73 65 72 74 28 20 28 72 63 20 26 20    assert( (rc & 
b8d0: 70 2d 3e 64 62 2d 3e 65 72 72 4d 61 73 6b 29 3d  p->db->errMask)=
b8e0: 3d 72 63 20 29 3b 0a 20 20 7d 65 6c 73 65 20 69  =rc );.  }else i
b8f0: 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42  f( p->magic!=VDB
b900: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 7b 0a  E_MAGIC_INIT ){.
b910: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
b920: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
b930: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
b940: 65 28 70 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  e(p);.  return r
b950: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c  c;.}../*.** Call
b960: 20 74 68 65 20 64 65 73 74 72 75 63 74 6f 72 20   the destructor 
b970: 66 6f 72 20 65 61 63 68 20 61 75 78 64 61 74 61  for each auxdata
b980: 20 65 6e 74 72 79 20 69 6e 20 70 56 64 62 65 46   entry in pVdbeF
b990: 75 6e 63 20 66 6f 72 20 77 68 69 63 68 0a 2a 2a  unc for which.**
b9a0: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69   the correspondi
b9b0: 6e 67 20 62 69 74 20 69 6e 20 6d 61 73 6b 20 69  ng bit in mask i
b9c0: 73 20 63 6c 65 61 72 2e 20 20 41 75 78 64 61 74  s clear.  Auxdat
b9d0: 61 20 65 6e 74 72 69 65 73 20 62 65 79 6f 6e 64  a entries beyond
b9e0: 20 33 31 0a 2a 2a 20 61 72 65 20 61 6c 77 61 79   31.** are alway
b9f0: 73 20 64 65 73 74 72 6f 79 65 64 2e 20 20 54 6f  s destroyed.  To
ba00: 20 64 65 73 74 72 6f 79 20 61 6c 6c 20 61 75 78   destroy all aux
ba10: 64 61 74 61 20 65 6e 74 72 69 65 73 2c 20 63 61  data entries, ca
ba20: 6c 6c 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69  ll this.** routi
ba30: 6e 65 20 77 69 74 68 20 6d 61 73 6b 3d 3d 30 2e  ne with mask==0.
ba40: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
ba50: 56 64 62 65 44 65 6c 65 74 65 41 75 78 44 61 74  VdbeDeleteAuxDat
ba60: 61 28 56 64 62 65 46 75 6e 63 20 2a 70 56 64 62  a(VdbeFunc *pVdb
ba70: 65 46 75 6e 63 2c 20 69 6e 74 20 6d 61 73 6b 29  eFunc, int mask)
ba80: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72  {.  int i;.  for
ba90: 28 69 3d 30 3b 20 69 3c 70 56 64 62 65 46 75 6e  (i=0; i<pVdbeFun
baa0: 63 2d 3e 6e 41 75 78 3b 20 69 2b 2b 29 7b 0a 20  c->nAux; i++){. 
bab0: 20 20 20 73 74 72 75 63 74 20 41 75 78 44 61 74     struct AuxDat
bac0: 61 20 2a 70 41 75 78 20 3d 20 26 70 56 64 62 65  a *pAux = &pVdbe
bad0: 46 75 6e 63 2d 3e 61 70 41 75 78 5b 69 5d 3b 0a  Func->apAux[i];.
bae0: 20 20 20 20 69 66 28 20 28 69 3e 33 31 20 7c 7c      if( (i>31 ||
baf0: 20 21 28 6d 61 73 6b 26 28 31 3c 3c 69 29 29 29   !(mask&(1<<i)))
bb00: 20 26 26 20 70 41 75 78 2d 3e 70 41 75 78 20 29   && pAux->pAux )
bb10: 7b 0a 20 20 20 20 20 20 69 66 28 20 70 41 75 78  {.      if( pAux
bb20: 2d 3e 78 44 65 6c 65 74 65 20 29 7b 0a 20 20 20  ->xDelete ){.   
bb30: 20 20 20 20 20 70 41 75 78 2d 3e 78 44 65 6c 65       pAux->xDele
bb40: 74 65 28 70 41 75 78 2d 3e 70 41 75 78 29 3b 0a  te(pAux->pAux);.
bb50: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 41        }.      pA
bb60: 75 78 2d 3e 70 41 75 78 20 3d 20 30 3b 0a 20 20  ux->pAux = 0;.  
bb70: 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a    }.  }.}../*.**
bb80: 20 44 65 6c 65 74 65 20 61 6e 20 65 6e 74 69 72   Delete an entir
bb90: 65 20 56 44 42 45 2e 0a 2a 2f 0a 76 6f 69 64 20  e VDBE..*/.void 
bba0: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
bbb0: 65 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e  e(Vdbe *p){.  in
bbc0: 74 20 69 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20  t i;.  if( p==0 
bbd0: 29 20 72 65 74 75 72 6e 3b 0a 20 20 43 6c 65 61  ) return;.  Clea
bbe0: 6e 75 70 28 70 29 3b 0a 20 20 69 66 28 20 70 2d  nup(p);.  if( p-
bbf0: 3e 70 50 72 65 76 20 29 7b 0a 20 20 20 20 70 2d  >pPrev ){.    p-
bc00: 3e 70 50 72 65 76 2d 3e 70 4e 65 78 74 20 3d 20  >pPrev->pNext = 
bc10: 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 65 6c 73  p->pNext;.  }els
bc20: 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  e{.    assert( p
bc30: 2d 3e 64 62 2d 3e 70 56 64 62 65 3d 3d 70 20 29  ->db->pVdbe==p )
bc40: 3b 0a 20 20 20 20 70 2d 3e 64 62 2d 3e 70 56 64  ;.    p->db->pVd
bc50: 62 65 20 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20  be = p->pNext;. 
bc60: 20 7d 0a 20 20 69 66 28 20 70 2d 3e 70 4e 65 78   }.  if( p->pNex
bc70: 74 20 29 7b 0a 20 20 20 20 70 2d 3e 70 4e 65 78  t ){.    p->pNex
bc80: 74 2d 3e 70 50 72 65 76 20 3d 20 70 2d 3e 70 50  t->pPrev = p->pP
bc90: 72 65 76 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70  rev;.  }.  if( p
bca0: 2d 3e 61 4f 70 20 29 7b 0a 20 20 20 20 66 6f 72  ->aOp ){.    for
bcb0: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20  (i=0; i<p->nOp; 
bcc0: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 4f 70 20 2a  i++){.      Op *
bcd0: 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d  pOp = &p->aOp[i]
bce0: 3b 0a 20 20 20 20 20 20 66 72 65 65 50 33 28 70  ;.      freeP3(p
bcf0: 4f 70 2d 3e 70 33 74 79 70 65 2c 20 70 4f 70 2d  Op->p3type, pOp-
bd00: 3e 70 33 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  >p3);.    }.    
bd10: 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 4f  sqliteFree(p->aO
bd20: 70 29 3b 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73  p);.  }.  releas
bd30: 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e 61 56 61  eMemArray(p->aVa
bd40: 72 2c 20 70 2d 3e 6e 56 61 72 29 3b 0a 20 20 73  r, p->nVar);.  s
bd50: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 4c 61  qliteFree(p->aLa
bd60: 62 65 6c 29 3b 0a 20 20 73 71 6c 69 74 65 46 72  bel);.  sqliteFr
bd70: 65 65 28 70 2d 3e 61 53 74 61 63 6b 29 3b 0a 20  ee(p->aStack);. 
bd80: 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79   releaseMemArray
bd90: 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 2c 20 70 2d  (p->aColName, p-
bda0: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 2a 43 4f 4c 4e  >nResColumn*COLN
bdb0: 41 4d 45 5f 4e 29 3b 0a 20 20 73 71 6c 69 74 65  AME_N);.  sqlite
bdc0: 46 72 65 65 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65  Free(p->aColName
bdd0: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
bde0: 70 2d 3e 7a 53 71 6c 29 3b 0a 20 20 70 2d 3e 6d  p->zSql);.  p->m
bdf0: 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49  agic = VDBE_MAGI
be00: 43 5f 44 45 41 44 3b 0a 20 20 73 71 6c 69 74 65  C_DEAD;.  sqlite
be10: 46 72 65 65 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a  Free(p);.}../*.*
be20: 2a 20 49 66 20 61 20 4d 6f 76 65 54 6f 20 6f 70  * If a MoveTo op
be30: 65 72 61 74 69 6f 6e 20 69 73 20 70 65 6e 64 69  eration is pendi
be40: 6e 67 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20  ng on the given 
be50: 63 75 72 73 6f 72 2c 20 74 68 65 6e 20 64 6f 20  cursor, then do 
be60: 74 68 61 74 0a 2a 2a 20 4d 6f 76 65 54 6f 20 6e  that.** MoveTo n
be70: 6f 77 2e 20 20 52 65 74 75 72 6e 20 61 6e 20 65  ow.  Return an e
be80: 72 72 6f 72 20 63 6f 64 65 2e 20 20 49 66 20 6e  rror code.  If n
be90: 6f 20 4d 6f 76 65 54 6f 20 69 73 20 70 65 6e 64  o MoveTo is pend
bea0: 69 6e 67 2c 20 74 68 69 73 0a 2a 2a 20 72 6f 75  ing, this.** rou
beb0: 74 69 6e 65 20 64 6f 65 73 20 6e 6f 74 68 69 6e  tine does nothin
bec0: 67 20 61 6e 64 20 72 65 74 75 72 6e 73 20 53 51  g and returns SQ
bed0: 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a 69 6e 74 20  LITE_OK..*/.int 
bee0: 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 73 6f  sqlite3VdbeCurso
bef0: 72 4d 6f 76 65 74 6f 28 43 75 72 73 6f 72 20 2a  rMoveto(Cursor *
bf00: 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e 64 65 66  p){.  if( p->def
bf10: 65 72 72 65 64 4d 6f 76 65 74 6f 20 29 7b 0a 20  erredMoveto ){. 
bf20: 20 20 20 69 6e 74 20 72 65 73 2c 20 72 63 3b 0a     int res, rc;.
bf30: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 54 45  #ifdef SQLITE_TE
bf40: 53 54 0a 20 20 20 20 65 78 74 65 72 6e 20 69 6e  ST.    extern in
bf50: 74 20 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68  t sqlite3_search
bf60: 5f 63 6f 75 6e 74 3b 0a 23 65 6e 64 69 66 0a 20  _count;.#endif. 
bf70: 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73     assert( p->is
bf80: 54 61 62 6c 65 20 29 3b 0a 20 20 20 20 72 63 20  Table );.    rc 
bf90: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4d 6f  = sqlite3BtreeMo
bfa0: 76 65 74 6f 28 70 2d 3e 70 43 75 72 73 6f 72 2c  veto(p->pCursor,
bfb0: 20 30 2c 20 70 2d 3e 6d 6f 76 65 74 6f 54 61 72   0, p->movetoTar
bfc0: 67 65 74 2c 20 30 2c 20 26 72 65 73 29 3b 0a 20  get, 0, &res);. 
bfd0: 20 20 20 69 66 28 20 72 63 20 29 20 72 65 74 75     if( rc ) retu
bfe0: 72 6e 20 72 63 3b 0a 20 20 20 20 2a 70 2d 3e 70  rn rc;.    *p->p
bff0: 49 6e 63 72 4b 65 79 20 3d 20 30 3b 0a 20 20 20  IncrKey = 0;.   
c000: 20 70 2d 3e 6c 61 73 74 52 6f 77 69 64 20 3d 20   p->lastRowid = 
c010: 6b 65 79 54 6f 49 6e 74 28 70 2d 3e 6d 6f 76 65  keyToInt(p->move
c020: 74 6f 54 61 72 67 65 74 29 3b 0a 20 20 20 20 70  toTarget);.    p
c030: 2d 3e 72 6f 77 69 64 49 73 56 61 6c 69 64 20 3d  ->rowidIsValid =
c040: 20 72 65 73 3d 3d 30 3b 0a 20 20 20 20 69 66 28   res==0;.    if(
c050: 20 72 65 73 3c 30 20 29 7b 0a 20 20 20 20 20 20   res<0 ){.      
c060: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
c070: 65 4e 65 78 74 28 70 2d 3e 70 43 75 72 73 6f 72  eNext(p->pCursor
c080: 2c 20 26 72 65 73 29 3b 0a 20 20 20 20 20 20 69  , &res);.      i
c090: 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20 72  f( rc ) return r
c0a0: 63 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20  c;.    }.#ifdef 
c0b0: 53 51 4c 49 54 45 5f 54 45 53 54 0a 20 20 20 20  SQLITE_TEST.    
c0c0: 73 71 6c 69 74 65 33 5f 73 65 61 72 63 68 5f 63  sqlite3_search_c
c0d0: 6f 75 6e 74 2b 2b 3b 0a 23 65 6e 64 69 66 0a 20  ount++;.#endif. 
c0e0: 20 20 20 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f     p->deferredMo
c0f0: 76 65 74 6f 20 3d 20 30 3b 0a 20 20 20 20 70 2d  veto = 0;.    p-
c100: 3e 63 61 63 68 65 53 74 61 74 75 73 20 3d 20 43  >cacheStatus = C
c110: 41 43 48 45 5f 53 54 41 4c 45 3b 0a 20 20 7d 0a  ACHE_STALE;.  }.
c120: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
c130: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  OK;.}../*.** The
c140: 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74   following funct
c150: 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73 71 6c 69  ions:.**.** sqli
c160: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
c170: 65 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64  e().** sqlite3Vd
c180: 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28  beSerialTypeLen(
c190: 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65  ).** sqlite3Vdbe
c1a0: 53 65 72 69 61 6c 52 65 61 64 28 29 0a 2a 2a 20  SerialRead().** 
c1b0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
c1c0: 6c 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65  lLen().** sqlite
c1d0: 33 56 64 62 65 53 65 72 69 61 6c 57 72 69 74 65  3VdbeSerialWrite
c1e0: 28 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61 70 73 75  ().**.** encapsu
c1f0: 6c 61 74 65 20 74 68 65 20 63 6f 64 65 20 74 68  late the code th
c200: 61 74 20 73 65 72 69 61 6c 69 7a 65 73 20 76 61  at serializes va
c210: 6c 75 65 73 20 66 6f 72 20 73 74 6f 72 61 67 65  lues for storage
c220: 20 69 6e 20 53 51 4c 69 74 65 0a 2a 2a 20 64 61   in SQLite.** da
c230: 74 61 20 61 6e 64 20 69 6e 64 65 78 20 72 65 63  ta and index rec
c240: 6f 72 64 73 2e 20 45 61 63 68 20 73 65 72 69 61  ords. Each seria
c250: 6c 69 7a 65 64 20 76 61 6c 75 65 20 63 6f 6e 73  lized value cons
c260: 69 73 74 73 20 6f 66 20 61 0a 2a 2a 20 27 73 65  ists of a.** 'se
c270: 72 69 61 6c 2d 74 79 70 65 27 20 61 6e 64 20 61  rial-type' and a
c280: 20 62 6c 6f 62 20 6f 66 20 64 61 74 61 2e 20 54   blob of data. T
c290: 68 65 20 73 65 72 69 61 6c 20 74 79 70 65 20 69  he serial type i
c2a0: 73 20 61 6e 20 38 2d 62 79 74 65 20 75 6e 73 69  s an 8-byte unsi
c2b0: 67 6e 65 64 0a 2a 2a 20 69 6e 74 65 67 65 72 2c  gned.** integer,
c2c0: 20 73 74 6f 72 65 64 20 61 73 20 61 20 76 61 72   stored as a var
c2d0: 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 61 6e  int..**.** In an
c2e0: 20 53 51 4c 69 74 65 20 69 6e 64 65 78 20 72 65   SQLite index re
c2f0: 63 6f 72 64 2c 20 74 68 65 20 73 65 72 69 61 6c  cord, the serial
c300: 20 74 79 70 65 20 69 73 20 73 74 6f 72 65 64 20   type is stored 
c310: 64 69 72 65 63 74 6c 79 20 62 65 66 6f 72 65 0a  directly before.
c320: 2a 2a 20 74 68 65 20 62 6c 6f 62 20 6f 66 20 64  ** the blob of d
c330: 61 74 61 20 74 68 61 74 20 69 74 20 63 6f 72 72  ata that it corr
c340: 65 73 70 6f 6e 64 73 20 74 6f 2e 20 49 6e 20 61  esponds to. In a
c350: 20 74 61 62 6c 65 20 72 65 63 6f 72 64 2c 20 61   table record, a
c360: 6c 6c 20 73 65 72 69 61 6c 0a 2a 2a 20 74 79 70  ll serial.** typ
c370: 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 61 74  es are stored at
c380: 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 68   the start of th
c390: 65 20 72 65 63 6f 72 64 2c 20 61 6e 64 20 74 68  e record, and th
c3a0: 65 20 62 6c 6f 62 73 20 6f 66 20 64 61 74 61 20  e blobs of data 
c3b0: 61 74 0a 2a 2a 20 74 68 65 20 65 6e 64 2e 20 48  at.** the end. H
c3c0: 65 6e 63 65 20 74 68 65 73 65 20 66 75 6e 63 74  ence these funct
c3d0: 69 6f 6e 73 20 61 6c 6c 6f 77 20 74 68 65 20 63  ions allow the c
c3e0: 61 6c 6c 65 72 20 74 6f 20 68 61 6e 64 6c 65 20  aller to handle 
c3f0: 74 68 65 0a 2a 2a 20 73 65 72 69 61 6c 2d 74 79  the.** serial-ty
c400: 70 65 20 61 6e 64 20 64 61 74 61 20 62 6c 6f 62  pe and data blob
c410: 20 73 65 70 65 72 61 74 65 6c 79 2e 0a 2a 2a 0a   seperately..**.
c420: 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67  ** The following
c430: 20 74 61 62 6c 65 20 64 65 73 63 72 69 62 65 73   table describes
c440: 20 74 68 65 20 76 61 72 69 6f 75 73 20 73 74 6f   the various sto
c450: 72 61 67 65 20 63 6c 61 73 73 65 73 20 66 6f 72  rage classes for
c460: 20 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 73   data:.**.**   s
c470: 65 72 69 61 6c 20 74 79 70 65 20 20 20 20 20 20  erial type      
c480: 20 20 62 79 74 65 73 20 6f 66 20 64 61 74 61 20    bytes of data 
c490: 20 20 20 20 20 74 79 70 65 0a 2a 2a 20 20 20 2d       type.**   -
c4a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20  -------------   
c4b0: 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d    --------------
c4c0: 2d 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  -    -----------
c4d0: 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20 30 20 20  ----.**      0  
c4e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c4f0: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20     0            
c500: 4e 55 4c 4c 0a 2a 2a 20 20 20 20 20 20 31 20 20  NULL.**      1  
c510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c520: 20 20 20 31 20 20 20 20 20 20 20 20 20 20 20 20     1            
c530: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a  signed integer.*
c540: 2a 20 20 20 20 20 20 32 20 20 20 20 20 20 20 20  *      2        
c550: 20 20 20 20 20 20 20 20 20 20 20 20 20 32 20 20               2  
c560: 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65 64            signed
c570: 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20   integer.**     
c580: 20 33 20 20 20 20 20 20 20 20 20 20 20 20 20 20   3              
c590: 20 20 20 20 20 20 20 33 20 20 20 20 20 20 20 20         3        
c5a0: 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67      signed integ
c5b0: 65 72 0a 2a 2a 20 20 20 20 20 20 34 20 20 20 20  er.**      4    
c5c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c5d0: 20 34 20 20 20 20 20 20 20 20 20 20 20 20 73 69   4            si
c5e0: 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20  gned integer.** 
c5f0: 20 20 20 20 20 35 20 20 20 20 20 20 20 20 20 20       5          
c600: 20 20 20 20 20 20 20 20 20 20 20 36 20 20 20 20             6    
c610: 20 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69          signed i
c620: 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 36  nteger.**      6
c630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c640: 20 20 20 20 20 38 20 20 20 20 20 20 20 20 20 20       8          
c650: 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72    signed integer
c660: 0a 2a 2a 20 20 20 20 20 20 37 20 20 20 20 20 20  .**      7      
c670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 38                 8
c680: 20 20 20 20 20 20 20 20 20 20 20 20 49 45 45 45              IEEE
c690: 20 66 6c 6f 61 74 0a 2a 2a 20 20 20 20 20 20 38   float.**      8
c6a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c6b0: 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20       0          
c6c0: 20 20 49 6e 74 65 67 65 72 20 63 6f 6e 73 74 61    Integer consta
c6d0: 6e 74 20 30 0a 2a 2a 20 20 20 20 20 20 39 20 20  nt 0.**      9  
c6e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c6f0: 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20     0            
c700: 49 6e 74 65 67 65 72 20 63 6f 6e 73 74 61 6e 74  Integer constant
c710: 20 31 0a 2a 2a 20 20 20 20 20 31 30 2c 31 31 20   1.**     10,11 
c720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c730: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 65                re
c740: 73 65 72 76 65 64 20 66 6f 72 20 65 78 70 61 6e  served for expan
c750: 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e 3d 31 32  sion.**    N>=12
c760: 20 61 6e 64 20 65 76 65 6e 20 20 20 20 20 20 20   and even       
c770: 28 4e 2d 31 32 29 2f 32 20 20 20 20 20 20 20 20  (N-12)/2        
c780: 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e 3d 31 33  BLOB.**    N>=13
c790: 20 61 6e 64 20 6f 64 64 20 20 20 20 20 20 20 20   and odd        
c7a0: 28 4e 2d 31 33 29 2f 32 20 20 20 20 20 20 20 20  (N-13)/2        
c7b0: 74 65 78 74 0a 2a 2a 0a 2a 2a 20 54 68 65 20 38  text.**.** The 8
c7c0: 20 61 6e 64 20 39 20 74 79 70 65 73 20 77 65 72   and 9 types wer
c7d0: 65 20 61 64 64 65 64 20 69 6e 20 33 2e 33 2e 30  e added in 3.3.0
c7e0: 2c 20 66 69 6c 65 20 66 6f 72 6d 61 74 20 34 2e  , file format 4.
c7f0: 20 20 50 72 69 6f 72 20 76 65 72 73 69 6f 6e 73    Prior versions
c800: 0a 2a 2a 20 6f 66 20 53 51 4c 69 74 65 20 77 69  .** of SQLite wi
c810: 6c 6c 20 6e 6f 74 20 75 6e 64 65 72 73 74 61 6e  ll not understan
c820: 64 20 74 68 6f 73 65 20 73 65 72 69 61 6c 20 74  d those serial t
c830: 79 70 65 73 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  ypes..*/../*.** 
c840: 52 65 74 75 72 6e 20 74 68 65 20 73 65 72 69 61  Return the seria
c850: 6c 2d 74 79 70 65 20 66 6f 72 20 74 68 65 20 76  l-type for the v
c860: 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 20 70  alue stored in p
c870: 4d 65 6d 2e 0a 2a 2f 0a 75 33 32 20 73 71 6c 69  Mem..*/.u32 sqli
c880: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
c890: 65 28 4d 65 6d 20 2a 70 4d 65 6d 2c 20 69 6e 74  e(Mem *pMem, int
c8a0: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 29 7b 0a 20   file_format){. 
c8b0: 20 69 6e 74 20 66 6c 61 67 73 20 3d 20 70 4d 65   int flags = pMe
c8c0: 6d 2d 3e 66 6c 61 67 73 3b 0a 20 20 69 6e 74 20  m->flags;.  int 
c8d0: 6e 3b 0a 0a 20 20 69 66 28 20 66 6c 61 67 73 26  n;..  if( flags&
c8e0: 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a 20 20 20 20  MEM_Null ){.    
c8f0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
c900: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 49 6e  if( flags&MEM_In
c910: 74 20 29 7b 0a 20 20 20 20 2f 2a 20 46 69 67 75  t ){.    /* Figu
c920: 72 65 20 6f 75 74 20 77 68 65 74 68 65 72 20 74  re out whether t
c930: 6f 20 75 73 65 20 31 2c 20 32 2c 20 34 2c 20 36  o use 1, 2, 4, 6
c940: 20 6f 72 20 38 20 62 79 74 65 73 2e 20 2a 2f 0a   or 8 bytes. */.
c950: 23 20 20 20 64 65 66 69 6e 65 20 4d 41 58 5f 36  #   define MAX_6
c960: 42 59 54 45 20 28 28 28 28 69 36 34 29 30 78 30  BYTE ((((i64)0x0
c970: 30 30 30 31 30 30 30 29 3c 3c 33 32 29 2d 31 29  0001000)<<32)-1)
c980: 0a 20 20 20 20 69 36 34 20 69 20 3d 20 70 4d 65  .    i64 i = pMe
c990: 6d 2d 3e 75 2e 69 3b 0a 20 20 20 20 75 36 34 20  m->u.i;.    u64 
c9a0: 75 3b 0a 20 20 20 20 69 66 28 20 66 69 6c 65 5f  u;.    if( file_
c9b0: 66 6f 72 6d 61 74 3e 3d 34 20 26 26 20 28 69 26  format>=4 && (i&
c9c0: 31 29 3d 3d 69 20 29 7b 0a 20 20 20 20 20 20 72  1)==i ){.      r
c9d0: 65 74 75 72 6e 20 38 2b 69 3b 0a 20 20 20 20 7d  eturn 8+i;.    }
c9e0: 0a 20 20 20 20 75 20 3d 20 69 3c 30 20 3f 20 2d  .    u = i<0 ? -
c9f0: 69 20 3a 20 69 3b 0a 20 20 20 20 69 66 28 20 75  i : i;.    if( u
ca00: 3c 3d 31 32 37 20 29 20 72 65 74 75 72 6e 20 31  <=127 ) return 1
ca10: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 33 32 37  ;.    if( u<=327
ca20: 36 37 20 29 20 72 65 74 75 72 6e 20 32 3b 0a 20  67 ) return 2;. 
ca30: 20 20 20 69 66 28 20 75 3c 3d 38 33 38 38 36 30     if( u<=838860
ca40: 37 20 29 20 72 65 74 75 72 6e 20 33 3b 0a 20 20  7 ) return 3;.  
ca50: 20 20 69 66 28 20 75 3c 3d 32 31 34 37 34 38 33    if( u<=2147483
ca60: 36 34 37 20 29 20 72 65 74 75 72 6e 20 34 3b 0a  647 ) return 4;.
ca70: 20 20 20 20 69 66 28 20 75 3c 3d 4d 41 58 5f 36      if( u<=MAX_6
ca80: 42 59 54 45 20 29 20 72 65 74 75 72 6e 20 35 3b  BYTE ) return 5;
ca90: 0a 20 20 20 20 72 65 74 75 72 6e 20 36 3b 0a 20  .    return 6;. 
caa0: 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d   }.  if( flags&M
cab0: 45 4d 5f 52 65 61 6c 20 29 7b 0a 20 20 20 20 72  EM_Real ){.    r
cac0: 65 74 75 72 6e 20 37 3b 0a 20 20 7d 0a 20 20 61  eturn 7;.  }.  a
cad0: 73 73 65 72 74 28 20 66 6c 61 67 73 26 28 4d 45  ssert( flags&(ME
cae0: 4d 5f 53 74 72 7c 4d 45 4d 5f 42 6c 6f 62 29 20  M_Str|MEM_Blob) 
caf0: 29 3b 0a 20 20 6e 20 3d 20 70 4d 65 6d 2d 3e 6e  );.  n = pMem->n
cb00: 3b 0a 20 20 69 66 28 20 66 6c 61 67 73 20 26 20  ;.  if( flags & 
cb10: 4d 45 4d 5f 5a 65 72 6f 20 29 7b 0a 20 20 20 20  MEM_Zero ){.    
cb20: 6e 20 2b 3d 20 70 4d 65 6d 2d 3e 75 2e 69 3b 0a  n += pMem->u.i;.
cb30: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6e 3e    }.  assert( n>
cb40: 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 28  =0 );.  return (
cb50: 28 6e 2a 32 29 20 2b 20 31 32 20 2b 20 28 28 66  (n*2) + 12 + ((f
cb60: 6c 61 67 73 26 4d 45 4d 5f 53 74 72 29 21 3d 30  lags&MEM_Str)!=0
cb70: 29 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  ));.}../*.** Ret
cb80: 75 72 6e 20 74 68 65 20 6c 65 6e 67 74 68 20 6f  urn the length o
cb90: 66 20 74 68 65 20 64 61 74 61 20 63 6f 72 72 65  f the data corre
cba0: 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74 68 65 20  sponding to the 
cbb0: 73 75 70 70 6c 69 65 64 20 73 65 72 69 61 6c 2d  supplied serial-
cbc0: 74 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  type..*/.int sql
cbd0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79  ite3VdbeSerialTy
cbe0: 70 65 4c 65 6e 28 75 33 32 20 73 65 72 69 61 6c  peLen(u32 serial
cbf0: 5f 74 79 70 65 29 7b 0a 20 20 69 66 28 20 73 65  _type){.  if( se
cc00: 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b  rial_type>=12 ){
cc10: 0a 20 20 20 20 72 65 74 75 72 6e 20 28 73 65 72  .    return (ser
cc20: 69 61 6c 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a  ial_type-12)/2;.
cc30: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 74 61    }else{.    sta
cc40: 74 69 63 20 63 6f 6e 73 74 20 75 38 20 61 53 69  tic const u8 aSi
cc50: 7a 65 5b 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32  ze[] = { 0, 1, 2
cc60: 2c 20 33 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c  , 3, 4, 6, 8, 8,
cc70: 20 30 2c 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20   0, 0, 0, 0 };. 
cc80: 20 20 20 72 65 74 75 72 6e 20 61 53 69 7a 65 5b     return aSize[
cc90: 73 65 72 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20  serial_type];.  
cca0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 77 65  }.}../*.** If we
ccb0: 20 61 72 65 20 6f 6e 20 61 6e 20 61 72 63 68 69   are on an archi
ccc0: 74 65 63 74 75 72 65 20 77 69 74 68 20 6d 69 78  tecture with mix
ccd0: 65 64 2d 65 6e 64 69 61 6e 20 66 6c 6f 61 74 69  ed-endian floati
cce0: 6e 67 20 0a 2a 2a 20 70 6f 69 6e 74 73 20 28 65  ng .** points (e
ccf0: 78 3a 20 41 52 4d 37 29 20 74 68 65 6e 20 73 77  x: ARM7) then sw
cd00: 61 70 20 74 68 65 20 6c 6f 77 65 72 20 34 20 62  ap the lower 4 b
cd10: 79 74 65 73 20 77 69 74 68 20 74 68 65 20 0a 2a  ytes with the .*
cd20: 2a 20 75 70 70 65 72 20 34 20 62 79 74 65 73 2e  * upper 4 bytes.
cd30: 20 20 52 65 74 75 72 6e 20 74 68 65 20 72 65 73    Return the res
cd40: 75 6c 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 6d  ult..**.** For m
cd50: 6f 73 74 20 61 72 63 68 69 74 65 63 74 75 72 65  ost architecture
cd60: 73 2c 20 74 68 69 73 20 69 73 20 61 20 6e 6f 2d  s, this is a no-
cd70: 6f 70 2e 0a 2a 2a 0a 2a 2a 20 28 6c 61 74 65 72  op..**.** (later
cd80: 29 3a 20 20 49 74 20 69 73 20 72 65 70 6f 72 74  ):  It is report
cd90: 65 64 20 74 6f 20 6d 65 20 74 68 61 74 20 74 68  ed to me that th
cda0: 65 20 6d 69 78 65 64 2d 65 6e 64 69 61 6e 20 70  e mixed-endian p
cdb0: 72 6f 62 6c 65 6d 0a 2a 2a 20 6f 6e 20 41 52 4d  roblem.** on ARM
cdc0: 37 20 69 73 20 61 6e 20 69 73 73 75 65 20 77 69  7 is an issue wi
cdd0: 74 68 20 47 43 43 2c 20 6e 6f 74 20 77 69 74 68  th GCC, not with
cde0: 20 74 68 65 20 41 52 4d 37 20 63 68 69 70 2e 20   the ARM7 chip. 
cdf0: 20 49 74 20 73 65 65 6d 73 0a 2a 2a 20 74 68 61   It seems.** tha
ce00: 74 20 65 61 72 6c 79 20 76 65 72 73 69 6f 6e 73  t early versions
ce10: 20 6f 66 20 47 43 43 20 73 74 6f 72 65 64 20 74   of GCC stored t
ce20: 68 65 20 74 77 6f 20 77 6f 72 64 73 20 6f 66 20  he two words of 
ce30: 61 20 36 34 2d 62 69 74 0a 2a 2a 20 66 6c 6f 61  a 64-bit.** floa
ce40: 74 20 69 6e 20 74 68 65 20 77 72 6f 6e 67 20 6f  t in the wrong o
ce50: 72 64 65 72 2e 20 20 41 6e 64 20 74 68 61 74 20  rder.  And that 
ce60: 65 72 72 6f 72 20 68 61 73 20 62 65 65 6e 20 70  error has been p
ce70: 72 6f 70 61 67 61 74 65 64 0a 2a 2a 20 65 76 65  ropagated.** eve
ce80: 72 20 73 69 6e 63 65 2e 20 20 54 68 65 20 62 6c  r since.  The bl
ce90: 61 6d 65 20 69 73 20 6e 6f 74 20 6e 65 63 65 73  ame is not neces
cea0: 73 61 72 69 6c 79 20 77 69 74 68 20 47 43 43 2c  sarily with GCC,
ceb0: 20 74 68 6f 75 67 68 2e 0a 2a 2a 20 47 43 43 20   though..** GCC 
cec0: 6d 69 67 68 74 20 68 61 76 65 20 6a 75 73 74 20  might have just 
ced0: 63 6f 70 79 69 6e 67 20 74 68 65 20 70 72 6f 62  copying the prob
cee0: 6c 65 6d 20 66 72 6f 6d 20 61 20 70 72 69 6f 72  lem from a prior
cef0: 20 63 6f 6d 70 69 6c 65 72 2e 0a 2a 2a 20 49 20   compiler..** I 
cf00: 61 6d 20 61 6c 73 6f 20 74 6f 6c 64 20 74 68 61  am also told tha
cf10: 74 20 6e 65 77 65 72 20 76 65 72 73 69 6f 6e 73  t newer versions
cf20: 20 6f 66 20 47 43 43 20 74 68 61 74 20 66 6f 6c   of GCC that fol
cf30: 6c 6f 77 20 61 20 64 69 66 66 65 72 65 6e 74 0a  low a different.
cf40: 2a 2a 20 41 42 49 20 67 65 74 20 74 68 65 20 62  ** ABI get the b
cf50: 79 74 65 20 6f 72 64 65 72 20 72 69 67 68 74 2e  yte order right.
cf60: 0a 2a 2a 0a 2a 2a 20 44 65 76 65 6c 6f 70 65 72  .**.** Developer
cf70: 73 20 75 73 69 6e 67 20 53 51 4c 69 74 65 20 6f  s using SQLite o
cf80: 6e 20 61 6e 20 41 52 4d 37 20 73 68 6f 75 6c 64  n an ARM7 should
cf90: 20 63 6f 6d 70 69 6c 65 20 61 6e 64 20 72 75 6e   compile and run
cfa0: 20 74 68 65 69 72 0a 2a 2a 20 61 70 70 6c 69 63   their.** applic
cfb0: 61 74 69 6f 6e 20 75 73 69 6e 67 20 2d 44 53 51  ation using -DSQ
cfc0: 4c 49 54 45 5f 44 45 42 55 47 3d 31 20 61 74 20  LITE_DEBUG=1 at 
cfd0: 6c 65 61 73 74 20 6f 6e 63 65 2e 20 20 57 69 74  least once.  Wit
cfe0: 68 20 44 45 42 55 47 0a 2a 2a 20 65 6e 61 62 6c  h DEBUG.** enabl
cff0: 65 64 2c 20 73 6f 6d 65 20 61 73 73 65 72 74 73  ed, some asserts
d000: 20 62 65 6c 6f 77 20 77 69 6c 6c 20 65 6e 73 75   below will ensu
d010: 72 65 20 74 68 61 74 20 74 68 65 20 62 79 74 65  re that the byte
d020: 20 6f 72 64 65 72 20 6f 66 0a 2a 2a 20 66 6c 6f   order of.** flo
d030: 61 74 69 6e 67 20 70 6f 69 6e 74 20 76 61 6c 75  ating point valu
d040: 65 73 20 69 73 20 63 6f 72 72 65 63 74 2e 0a 2a  es is correct..*
d050: 2f 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  /.#ifdef SQLITE_
d060: 4d 49 58 45 44 5f 45 4e 44 49 41 4e 5f 36 34 42  MIXED_ENDIAN_64B
d070: 49 54 5f 46 4c 4f 41 54 0a 73 74 61 74 69 63 20  IT_FLOAT.static 
d080: 64 6f 75 62 6c 65 20 66 6c 6f 61 74 53 77 61 70  double floatSwap
d090: 28 64 6f 75 62 6c 65 20 69 6e 29 7b 0a 20 20 75  (double in){.  u
d0a0: 6e 69 6f 6e 20 7b 0a 20 20 20 20 64 6f 75 62 6c  nion {.    doubl
d0b0: 65 20 72 3b 0a 20 20 20 20 75 33 32 20 69 5b 32  e r;.    u32 i[2
d0c0: 5d 3b 0a 20 20 7d 20 75 3b 0a 20 20 75 33 32 20  ];.  } u;.  u32 
d0d0: 74 3b 0a 0a 20 20 75 2e 72 20 3d 20 69 6e 3b 0a  t;..  u.r = in;.
d0e0: 20 20 74 20 3d 20 75 2e 69 5b 30 5d 3b 0a 20 20    t = u.i[0];.  
d0f0: 75 2e 69 5b 30 5d 20 3d 20 75 2e 69 5b 31 5d 3b  u.i[0] = u.i[1];
d100: 0a 20 20 75 2e 69 5b 31 5d 20 3d 20 74 3b 0a 20  .  u.i[1] = t;. 
d110: 20 72 65 74 75 72 6e 20 75 2e 72 3b 0a 7d 0a 23   return u.r;.}.#
d120: 20 64 65 66 69 6e 65 20 73 77 61 70 4d 69 78 65   define swapMixe
d130: 64 45 6e 64 69 61 6e 46 6c 6f 61 74 28 58 29 20  dEndianFloat(X) 
d140: 20 58 20 3d 20 66 6c 6f 61 74 53 77 61 70 28 58   X = floatSwap(X
d150: 29 0a 23 65 6c 73 65 0a 23 20 64 65 66 69 6e 65  ).#else.# define
d160: 20 73 77 61 70 4d 69 78 65 64 45 6e 64 69 61 6e   swapMixedEndian
d170: 46 6c 6f 61 74 28 58 29 0a 23 65 6e 64 69 66 0a  Float(X).#endif.
d180: 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68 65  ./*.** Write the
d190: 20 73 65 72 69 61 6c 69 7a 65 64 20 64 61 74 61   serialized data
d1a0: 20 62 6c 6f 62 20 66 6f 72 20 74 68 65 20 76 61   blob for the va
d1b0: 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 20 70 4d  lue stored in pM
d1c0: 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62 75 66 2e  em into .** buf.
d1d0: 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20 74   It is assumed t
d1e0: 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20 68  hat the caller h
d1f0: 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73 75 66  as allocated suf
d200: 66 69 63 69 65 6e 74 20 73 70 61 63 65 2e 0a 2a  ficient space..*
d210: 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d  * Return the num
d220: 62 65 72 20 6f 66 20 62 79 74 65 73 20 77 72 69  ber of bytes wri
d230: 74 74 65 6e 2e 0a 2a 2a 0a 2a 2a 20 6e 42 75 66  tten..**.** nBuf
d240: 20 69 73 20 74 68 65 20 61 6d 6f 75 6e 74 20 6f   is the amount o
d250: 66 20 73 70 61 63 65 20 6c 65 66 74 20 69 6e 20  f space left in 
d260: 62 75 66 5b 5d 2e 20 20 6e 42 75 66 20 6d 75 73  buf[].  nBuf mus
d270: 74 20 61 6c 77 61 79 73 20 62 65 0a 2a 2a 20 6c  t always be.** l
d280: 61 72 67 65 20 65 6e 6f 75 67 68 20 74 6f 20 68  arge enough to h
d290: 6f 6c 64 20 74 68 65 20 65 6e 74 69 72 65 20 66  old the entire f
d2a0: 69 65 6c 64 2e 20 20 45 78 63 65 70 74 2c 20 69  ield.  Except, i
d2b0: 66 20 74 68 65 20 66 69 65 6c 64 20 69 73 0a 2a  f the field is.*
d2c0: 2a 20 61 20 62 6c 6f 62 20 77 69 74 68 20 61 20  * a blob with a 
d2d0: 7a 65 72 6f 2d 66 69 6c 6c 65 64 20 74 61 69 6c  zero-filled tail
d2e0: 2c 20 74 68 65 6e 20 62 75 66 5b 5d 20 6d 69 67  , then buf[] mig
d2f0: 68 74 20 62 65 20 6a 75 73 74 20 74 68 65 20 72  ht be just the r
d300: 69 67 68 74 0a 2a 2a 20 73 69 7a 65 20 74 6f 20  ight.** size to 
d310: 68 6f 6c 64 20 65 76 65 72 79 74 68 69 6e 67 20  hold everything 
d320: 65 78 63 65 70 74 20 66 6f 72 20 74 68 65 20 7a  except for the z
d330: 65 72 6f 2d 66 69 6c 6c 65 64 20 74 61 69 6c 2e  ero-filled tail.
d340: 20 20 49 66 20 62 75 66 5b 5d 0a 2a 2a 20 69 73    If buf[].** is
d350: 20 6f 6e 6c 79 20 62 69 67 20 65 6e 6f 75 67 68   only big enough
d360: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 6e 6f 6e   to hold the non
d370: 2d 7a 65 72 6f 20 70 72 65 66 69 78 2c 20 74 68  -zero prefix, th
d380: 65 6e 20 6f 6e 6c 79 20 77 72 69 74 65 20 74 68  en only write th
d390: 61 74 0a 2a 2a 20 70 72 65 66 69 78 20 69 6e 74  at.** prefix int
d3a0: 6f 20 62 75 66 5b 5d 2e 20 20 42 75 74 20 69 66  o buf[].  But if
d3b0: 20 62 75 66 5b 5d 20 69 73 20 6c 61 72 67 65 20   buf[] is large 
d3c0: 65 6e 6f 75 67 68 20 74 6f 20 68 6f 6c 64 20 62  enough to hold b
d3d0: 6f 74 68 20 74 68 65 0a 2a 2a 20 70 72 65 66 69  oth the.** prefi
d3e0: 78 20 61 6e 64 20 74 68 65 20 74 61 69 6c 20 74  x and the tail t
d3f0: 68 65 6e 20 77 72 69 74 65 20 74 68 65 20 70 72  hen write the pr
d400: 65 66 69 78 20 61 6e 64 20 73 65 74 20 74 68 65  efix and set the
d410: 20 74 61 69 6c 20 74 6f 20 61 6c 6c 0a 2a 2a 20   tail to all.** 
d420: 7a 65 72 6f 73 2e 0a 2a 2a 0a 2a 2a 20 52 65 74  zeros..**.** Ret
d430: 75 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  urn the number o
d440: 66 20 62 79 74 65 73 20 61 63 74 75 61 6c 6c 79  f bytes actually
d450: 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 62 75   written into bu
d460: 66 5b 5d 2e 20 20 54 68 65 20 6e 75 6d 62 65 72  f[].  The number
d470: 0a 2a 2a 20 6f 66 20 62 79 74 65 73 20 69 6e 20  .** of bytes in 
d480: 74 68 65 20 7a 65 72 6f 2d 66 69 6c 6c 65 64 20  the zero-filled 
d490: 74 61 69 6c 20 69 73 20 69 6e 63 6c 75 64 65 64  tail is included
d4a0: 20 69 6e 20 74 68 65 20 72 65 74 75 72 6e 20 76   in the return v
d4b0: 61 6c 75 65 20 6f 6e 6c 79 0a 2a 2a 20 69 66 20  alue only.** if 
d4c0: 74 68 6f 73 65 20 62 79 74 65 73 20 77 65 72 65  those bytes were
d4d0: 20 7a 65 72 6f 65 64 20 69 6e 20 62 75 66 5b 5d   zeroed in buf[]
d4e0: 2e 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c 69 74 65  ..*/ .int sqlite
d4f0: 33 56 64 62 65 53 65 72 69 61 6c 50 75 74 28 75  3VdbeSerialPut(u
d500: 38 20 2a 62 75 66 2c 20 69 6e 74 20 6e 42 75 66  8 *buf, int nBuf
d510: 2c 20 4d 65 6d 20 2a 70 4d 65 6d 2c 20 69 6e 74  , Mem *pMem, int
d520: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 29 7b 0a 20   file_format){. 
d530: 20 75 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65   u32 serial_type
d540: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65   = sqlite3VdbeSe
d550: 72 69 61 6c 54 79 70 65 28 70 4d 65 6d 2c 20 66  rialType(pMem, f
d560: 69 6c 65 5f 66 6f 72 6d 61 74 29 3b 0a 20 20 69  ile_format);.  i
d570: 6e 74 20 6c 65 6e 3b 0a 0a 20 20 2f 2a 20 49 6e  nt len;..  /* In
d580: 74 65 67 65 72 20 61 6e 64 20 52 65 61 6c 20 2a  teger and Real *
d590: 2f 0a 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74  /.  if( serial_t
d5a0: 79 70 65 3c 3d 37 20 26 26 20 73 65 72 69 61 6c  ype<=7 && serial
d5b0: 5f 74 79 70 65 3e 30 20 29 7b 0a 20 20 20 20 75  _type>0 ){.    u
d5c0: 36 34 20 76 3b 0a 20 20 20 20 69 6e 74 20 69 3b  64 v;.    int i;
d5d0: 0a 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f  .    if( serial_
d5e0: 74 79 70 65 3d 3d 37 20 29 7b 0a 20 20 20 20 20  type==7 ){.     
d5f0: 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f 66 28   assert( sizeof(
d600: 76 29 3d 3d 73 69 7a 65 6f 66 28 70 4d 65 6d 2d  v)==sizeof(pMem-
d610: 3e 72 29 20 29 3b 0a 20 20 20 20 20 20 73 77 61  >r) );.      swa
d620: 70 4d 69 78 65 64 45 6e 64 69 61 6e 46 6c 6f 61  pMixedEndianFloa
d630: 74 28 70 4d 65 6d 2d 3e 72 29 3b 0a 20 20 20 20  t(pMem->r);.    
d640: 20 20 6d 65 6d 63 70 79 28 26 76 2c 20 26 70 4d    memcpy(&v, &pM
d650: 65 6d 2d 3e 72 2c 20 73 69 7a 65 6f 66 28 76 29  em->r, sizeof(v)
d660: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  );.    }else{.  
d670: 20 20 20 20 76 20 3d 20 70 4d 65 6d 2d 3e 75 2e      v = pMem->u.
d680: 69 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c 65 6e  i;.    }.    len
d690: 20 3d 20 69 20 3d 20 73 71 6c 69 74 65 33 56 64   = i = sqlite3Vd
d6a0: 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28  beSerialTypeLen(
d6b0: 73 65 72 69 61 6c 5f 74 79 70 65 29 3b 0a 20 20  serial_type);.  
d6c0: 20 20 61 73 73 65 72 74 28 20 6c 65 6e 3c 3d 6e    assert( len<=n
d6d0: 42 75 66 20 29 3b 0a 20 20 20 20 77 68 69 6c 65  Buf );.    while
d6e0: 28 20 69 2d 2d 20 29 7b 0a 20 20 20 20 20 20 62  ( i-- ){.      b
d6f0: 75 66 5b 69 5d 20 3d 20 28 76 26 30 78 46 46 29  uf[i] = (v&0xFF)
d700: 3b 0a 20 20 20 20 20 20 76 20 3e 3e 3d 20 38 3b  ;.      v >>= 8;
d710: 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72  .    }.    retur
d720: 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  n len;.  }..  /*
d730: 20 53 74 72 69 6e 67 20 6f 72 20 62 6c 6f 62 20   String or blob 
d740: 2a 2f 0a 20 20 69 66 28 20 73 65 72 69 61 6c 5f  */.  if( serial_
d750: 74 79 70 65 3e 3d 31 32 20 29 7b 0a 20 20 20 20  type>=12 ){.    
d760: 61 73 73 65 72 74 28 20 70 4d 65 6d 2d 3e 6e 20  assert( pMem->n 
d770: 2b 20 28 28 70 4d 65 6d 2d 3e 66 6c 61 67 73 20  + ((pMem->flags 
d780: 26 20 4d 45 4d 5f 5a 65 72 6f 29 3f 70 4d 65 6d  & MEM_Zero)?pMem
d790: 2d 3e 75 2e 69 3a 30 29 0a 20 20 20 20 20 20 20  ->u.i:0).       
d7a0: 20 20 20 20 20 20 3d 3d 20 73 71 6c 69 74 65 33        == sqlite3
d7b0: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
d7c0: 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 29 20 29  n(serial_type) )
d7d0: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4d  ;.    assert( pM
d7e0: 65 6d 2d 3e 6e 3c 3d 6e 42 75 66 20 29 3b 0a 20  em->n<=nBuf );. 
d7f0: 20 20 20 6c 65 6e 20 3d 20 70 4d 65 6d 2d 3e 6e     len = pMem->n
d800: 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 62 75 66  ;.    memcpy(buf
d810: 2c 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29 3b  , pMem->z, len);
d820: 0a 20 20 20 20 69 66 28 20 70 4d 65 6d 2d 3e 66  .    if( pMem->f
d830: 6c 61 67 73 20 26 20 4d 45 4d 5f 5a 65 72 6f 20  lags & MEM_Zero 
d840: 29 7b 0a 20 20 20 20 20 20 6c 65 6e 20 2b 3d 20  ){.      len += 
d850: 70 4d 65 6d 2d 3e 75 2e 69 3b 0a 20 20 20 20 20  pMem->u.i;.     
d860: 20 69 66 28 20 6c 65 6e 3e 6e 42 75 66 20 29 7b   if( len>nBuf ){
d870: 0a 20 20 20 20 20 20 20 20 6c 65 6e 20 3d 20 6e  .        len = n
d880: 42 75 66 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  Buf;.      }.   
d890: 20 20 20 6d 65 6d 73 65 74 28 26 62 75 66 5b 70     memset(&buf[p
d8a0: 4d 65 6d 2d 3e 6e 5d 2c 20 30 2c 20 6c 65 6e 2d  Mem->n], 0, len-
d8b0: 70 4d 65 6d 2d 3e 6e 29 3b 0a 20 20 20 20 7d 0a  pMem->n);.    }.
d8c0: 20 20 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a      return len;.
d8d0: 20 20 7d 0a 0a 20 20 2f 2a 20 4e 55 4c 4c 20 6f    }..  /* NULL o
d8e0: 72 20 63 6f 6e 73 74 61 6e 74 73 20 30 20 6f 72  r constants 0 or
d8f0: 20 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 30   1 */.  return 0
d900: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 73 65 72  ;.}../*.** Deser
d910: 69 61 6c 69 7a 65 20 74 68 65 20 64 61 74 61 20  ialize the data 
d920: 62 6c 6f 62 20 70 6f 69 6e 74 65 64 20 74 6f 20  blob pointed to 
d930: 62 79 20 62 75 66 20 61 73 20 73 65 72 69 61 6c  by buf as serial
d940: 20 74 79 70 65 20 73 65 72 69 61 6c 5f 74 79 70   type serial_typ
d950: 65 0a 2a 2a 20 61 6e 64 20 73 74 6f 72 65 20 74  e.** and store t
d960: 68 65 20 72 65 73 75 6c 74 20 69 6e 20 70 4d 65  he result in pMe
d970: 6d 2e 20 20 52 65 74 75 72 6e 20 74 68 65 20 6e  m.  Return the n
d980: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 72  umber of bytes r
d990: 65 61 64 2e 0a 2a 2f 20 0a 69 6e 74 20 73 71 6c  ead..*/ .int sql
d9a0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65  ite3VdbeSerialGe
d9b0: 74 28 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67  t(.  const unsig
d9c0: 6e 65 64 20 63 68 61 72 20 2a 62 75 66 2c 20 20  ned char *buf,  
d9d0: 20 20 20 2f 2a 20 42 75 66 66 65 72 20 74 6f 20     /* Buffer to 
d9e0: 64 65 73 65 72 69 61 6c 69 7a 65 20 66 72 6f 6d  deserialize from
d9f0: 20 2a 2f 0a 20 20 75 33 32 20 73 65 72 69 61 6c   */.  u32 serial
da00: 5f 74 79 70 65 2c 20 20 20 20 20 20 20 20 20 20  _type,          
da10: 20 20 20 20 2f 2a 20 53 65 72 69 61 6c 20 74 79      /* Serial ty
da20: 70 65 20 74 6f 20 64 65 73 65 72 69 61 6c 69 7a  pe to deserializ
da30: 65 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 4d 65 6d  e */.  Mem *pMem
da40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
da50: 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79 20 63       /* Memory c
da60: 65 6c 6c 20 74 6f 20 77 72 69 74 65 20 76 61 6c  ell to write val
da70: 75 65 20 69 6e 74 6f 20 2a 2f 0a 29 7b 0a 20 20  ue into */.){.  
da80: 73 77 69 74 63 68 28 20 73 65 72 69 61 6c 5f 74  switch( serial_t
da90: 79 70 65 20 29 7b 0a 20 20 20 20 63 61 73 65 20  ype ){.    case 
daa0: 31 30 3a 20 20 20 2f 2a 20 52 65 73 65 72 76 65  10:   /* Reserve
dab0: 64 20 66 6f 72 20 66 75 74 75 72 65 20 75 73 65  d for future use
dac0: 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 31 31 3a   */.    case 11:
dad0: 20 20 20 2f 2a 20 52 65 73 65 72 76 65 64 20 66     /* Reserved f
dae0: 6f 72 20 66 75 74 75 72 65 20 75 73 65 20 2a 2f  or future use */
daf0: 0a 20 20 20 20 63 61 73 65 20 30 3a 20 7b 20 20  .    case 0: {  
db00: 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20 20 20  /* NULL */.     
db10: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
db20: 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 62  EM_Null;.      b
db30: 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20  reak;.    }.    
db40: 63 61 73 65 20 31 3a 20 7b 20 2f 2a 20 31 2d 62  case 1: { /* 1-b
db50: 79 74 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67  yte signed integ
db60: 65 72 20 2a 2f 0a 20 20 20 20 20 20 70 4d 65 6d  er */.      pMem
db70: 2d 3e 75 2e 69 20 3d 20 28 73 69 67 6e 65 64 20  ->u.i = (signed 
db80: 63 68 61 72 29 62 75 66 5b 30 5d 3b 0a 20 20 20  char)buf[0];.   
db90: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
dba0: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20   MEM_Int;.      
dbb0: 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a  return 1;.    }.
dbc0: 20 20 20 20 63 61 73 65 20 32 3a 20 7b 20 2f 2a      case 2: { /*
dbd0: 20 32 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69   2-byte signed i
dbe0: 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 20 20  nteger */.      
dbf0: 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20 28 28 28 73  pMem->u.i = (((s
dc00: 69 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30  igned char)buf[0
dc10: 5d 29 3c 3c 38 29 20 7c 20 62 75 66 5b 31 5d 3b  ])<<8) | buf[1];
dc20: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  .      pMem->fla
dc30: 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20  gs = MEM_Int;.  
dc40: 20 20 20 20 72 65 74 75 72 6e 20 32 3b 0a 20 20      return 2;.  
dc50: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 33 3a 20    }.    case 3: 
dc60: 7b 20 2f 2a 20 33 2d 62 79 74 65 20 73 69 67 6e  { /* 3-byte sign
dc70: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20  ed integer */.  
dc80: 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20      pMem->u.i = 
dc90: 28 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62  (((signed char)b
dca0: 75 66 5b 30 5d 29 3c 3c 31 36 29 20 7c 20 28 62  uf[0])<<16) | (b
dcb0: 75 66 5b 31 5d 3c 3c 38 29 20 7c 20 62 75 66 5b  uf[1]<<8) | buf[
dcc0: 32 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  2];.      pMem->
dcd0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b  flags = MEM_Int;
dce0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 33 3b  .      return 3;
dcf0: 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20  .    }.    case 
dd00: 34 3a 20 7b 20 2f 2a 20 34 2d 62 79 74 65 20 73  4: { /* 4-byte s
dd10: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f  igned integer */
dd20: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69  .      pMem->u.i
dd30: 20 3d 20 28 62 75 66 5b 30 5d 3c 3c 32 34 29 20   = (buf[0]<<24) 
dd40: 7c 20 28 62 75 66 5b 31 5d 3c 3c 31 36 29 20 7c  | (buf[1]<<16) |
dd50: 20 28 62 75 66 5b 32 5d 3c 3c 38 29 20 7c 20 62   (buf[2]<<8) | b
dd60: 75 66 5b 33 5d 3b 0a 20 20 20 20 20 20 70 4d 65  uf[3];.      pMe
dd70: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49  m->flags = MEM_I
dd80: 6e 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  nt;.      return
dd90: 20 34 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61   4;.    }.    ca
dda0: 73 65 20 35 3a 20 7b 20 2f 2a 20 36 2d 62 79 74  se 5: { /* 6-byt
ddb0: 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72  e signed integer
ddc0: 20 2a 2f 0a 20 20 20 20 20 20 75 36 34 20 78 20   */.      u64 x 
ddd0: 3d 20 28 28 28 73 69 67 6e 65 64 20 63 68 61 72  = (((signed char
dde0: 29 62 75 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62  )buf[0])<<8) | b
ddf0: 75 66 5b 31 5d 3b 0a 20 20 20 20 20 20 75 33 32  uf[1];.      u32
de00: 20 79 20 3d 20 28 62 75 66 5b 32 5d 3c 3c 32 34   y = (buf[2]<<24
de10: 29 20 7c 20 28 62 75 66 5b 33 5d 3c 3c 31 36 29  ) | (buf[3]<<16)
de20: 20 7c 20 28 62 75 66 5b 34 5d 3c 3c 38 29 20 7c   | (buf[4]<<8) |
de30: 20 62 75 66 5b 35 5d 3b 0a 20 20 20 20 20 20 78   buf[5];.      x
de40: 20 3d 20 28 78 3c 3c 33 32 29 20 7c 20 79 3b 0a   = (x<<32) | y;.
de50: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20        pMem->u.i 
de60: 3d 20 2a 28 69 36 34 2a 29 26 78 3b 0a 20 20 20  = *(i64*)&x;.   
de70: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
de80: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20   MEM_Int;.      
de90: 72 65 74 75 72 6e 20 36 3b 0a 20 20 20 20 7d 0a  return 6;.    }.
dea0: 20 20 20 20 63 61 73 65 20 36 3a 20 20 20 2f 2a      case 6:   /*
deb0: 20 38 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69   8-byte signed i
dec0: 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 63 61  nteger */.    ca
ded0: 73 65 20 37 3a 20 7b 20 2f 2a 20 49 45 45 45 20  se 7: { /* IEEE 
dee0: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 2a  floating point *
def0: 2f 0a 20 20 20 20 20 20 75 36 34 20 78 3b 0a 20  /.      u64 x;. 
df00: 20 20 20 20 20 75 33 32 20 79 3b 0a 23 69 66 20       u32 y;.#if 
df10: 21 64 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29  !defined(NDEBUG)
df20: 20 26 26 20 21 64 65 66 69 6e 65 64 28 53 51 4c   && !defined(SQL
df30: 49 54 45 5f 4f 4d 49 54 5f 46 4c 4f 41 54 49 4e  ITE_OMIT_FLOATIN
df40: 47 5f 50 4f 49 4e 54 29 0a 20 20 20 20 20 20 2f  G_POINT).      /
df50: 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 69 6e  * Verify that in
df60: 74 65 67 65 72 73 20 61 6e 64 20 66 6c 6f 61 74  tegers and float
df70: 69 6e 67 20 70 6f 69 6e 74 20 76 61 6c 75 65 73  ing point values
df80: 20 75 73 65 20 74 68 65 20 73 61 6d 65 0a 20 20   use the same.  
df90: 20 20 20 20 2a 2a 20 62 79 74 65 20 6f 72 64 65      ** byte orde
dfa0: 72 2e 20 20 4f 72 2c 20 74 68 61 74 20 69 66 20  r.  Or, that if 
dfb0: 53 51 4c 49 54 45 5f 4d 49 58 45 44 5f 45 4e 44  SQLITE_MIXED_END
dfc0: 49 41 4e 5f 36 34 42 49 54 5f 46 4c 4f 41 54 20  IAN_64BIT_FLOAT 
dfd0: 69 73 0a 20 20 20 20 20 20 2a 2a 20 64 65 66 69  is.      ** defi
dfe0: 6e 65 64 20 74 68 61 74 20 36 34 2d 62 69 74 20  ned that 64-bit 
dff0: 66 6c 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 76  floating point v
e000: 61 6c 75 65 73 20 72 65 61 6c 6c 79 20 61 72 65  alues really are
e010: 20 6d 69 78 65 64 0a 20 20 20 20 20 20 2a 2a 20   mixed.      ** 
e020: 65 6e 64 69 61 6e 2e 0a 20 20 20 20 20 20 2a 2f  endian..      */
e030: 0a 20 20 20 20 20 20 73 74 61 74 69 63 20 63 6f  .      static co
e040: 6e 73 74 20 75 36 34 20 74 31 20 3d 20 28 28 75  nst u64 t1 = ((u
e050: 36 34 29 30 78 33 66 66 30 30 30 30 30 29 3c 3c  64)0x3ff00000)<<
e060: 33 32 3b 0a 20 20 20 20 20 20 73 74 61 74 69 63  32;.      static
e070: 20 63 6f 6e 73 74 20 64 6f 75 62 6c 65 20 72 31   const double r1
e080: 20 3d 20 31 2e 30 3b 0a 20 20 20 20 20 20 64 6f   = 1.0;.      do
e090: 75 62 6c 65 20 72 32 20 3d 20 72 31 3b 0a 20 20  uble r2 = r1;.  
e0a0: 20 20 20 20 73 77 61 70 4d 69 78 65 64 45 6e 64      swapMixedEnd
e0b0: 69 61 6e 46 6c 6f 61 74 28 72 32 29 3b 0a 20 20  ianFloat(r2);.  
e0c0: 20 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65      assert( size
e0d0: 6f 66 28 72 32 29 3d 3d 73 69 7a 65 6f 66 28 74  of(r2)==sizeof(t
e0e0: 31 29 20 26 26 20 6d 65 6d 63 6d 70 28 26 72 32  1) && memcmp(&r2
e0f0: 2c 20 26 74 31 2c 20 73 69 7a 65 6f 66 28 72 31  , &t1, sizeof(r1
e100: 29 29 3d 3d 30 20 29 3b 0a 23 65 6e 64 69 66 0a  ))==0 );.#endif.
e110: 0a 20 20 20 20 20 20 78 20 3d 20 28 62 75 66 5b  .      x = (buf[
e120: 30 5d 3c 3c 32 34 29 20 7c 20 28 62 75 66 5b 31  0]<<24) | (buf[1
e130: 5d 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b 32 5d  ]<<16) | (buf[2]
e140: 3c 3c 38 29 20 7c 20 62 75 66 5b 33 5d 3b 0a 20  <<8) | buf[3];. 
e150: 20 20 20 20 20 79 20 3d 20 28 62 75 66 5b 34 5d       y = (buf[4]
e160: 3c 3c 32 34 29 20 7c 20 28 62 75 66 5b 35 5d 3c  <<24) | (buf[5]<
e170: 3c 31 36 29 20 7c 20 28 62 75 66 5b 36 5d 3c 3c  <16) | (buf[6]<<
e180: 38 29 20 7c 20 62 75 66 5b 37 5d 3b 0a 20 20 20  8) | buf[7];.   
e190: 20 20 20 78 20 3d 20 28 78 3c 3c 33 32 29 20 7c     x = (x<<32) |
e1a0: 20 79 3b 0a 20 20 20 20 20 20 69 66 28 20 73 65   y;.      if( se
e1b0: 72 69 61 6c 5f 74 79 70 65 3d 3d 36 20 29 7b 0a  rial_type==6 ){.
e1c0: 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 75 2e          pMem->u.
e1d0: 69 20 3d 20 2a 28 69 36 34 2a 29 26 78 3b 0a 20  i = *(i64*)&x;. 
e1e0: 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61         pMem->fla
e1f0: 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20  gs = MEM_Int;.  
e200: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
e210: 20 20 20 61 73 73 65 72 74 28 20 73 69 7a 65 6f     assert( sizeo
e220: 66 28 78 29 3d 3d 38 20 26 26 20 73 69 7a 65 6f  f(x)==8 && sizeo
e230: 66 28 70 4d 65 6d 2d 3e 72 29 3d 3d 38 20 29 3b  f(pMem->r)==8 );
e240: 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79 28  .        memcpy(
e250: 26 70 4d 65 6d 2d 3e 72 2c 20 26 78 2c 20 73 69  &pMem->r, &x, si
e260: 7a 65 6f 66 28 78 29 29 3b 0a 20 20 20 20 20 20  zeof(x));.      
e270: 20 20 73 77 61 70 4d 69 78 65 64 45 6e 64 69 61    swapMixedEndia
e280: 6e 46 6c 6f 61 74 28 70 4d 65 6d 2d 3e 72 29 3b  nFloat(pMem->r);
e290: 0a 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  .        pMem->f
e2a0: 6c 61 67 73 20 3d 20 4d 45 4d 5f 52 65 61 6c 3b  lags = MEM_Real;
e2b0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72  .      }.      r
e2c0: 65 74 75 72 6e 20 38 3b 0a 20 20 20 20 7d 0a 20  eturn 8;.    }. 
e2d0: 20 20 20 63 61 73 65 20 38 3a 20 20 20 20 2f 2a     case 8:    /*
e2e0: 20 49 6e 74 65 67 65 72 20 30 20 2a 2f 0a 20 20   Integer 0 */.  
e2f0: 20 20 63 61 73 65 20 39 3a 20 7b 20 20 2f 2a 20    case 9: {  /* 
e300: 49 6e 74 65 67 65 72 20 31 20 2a 2f 0a 20 20 20  Integer 1 */.   
e310: 20 20 20 70 4d 65 6d 2d 3e 75 2e 69 20 3d 20 73     pMem->u.i = s
e320: 65 72 69 61 6c 5f 74 79 70 65 2d 38 3b 0a 20 20  erial_type-8;.  
e330: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
e340: 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20  = MEM_Int;.     
e350: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d   return 0;.    }
e360: 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a  .    default: {.
e370: 20 20 20 20 20 20 69 6e 74 20 6c 65 6e 20 3d 20        int len = 
e380: 28 73 65 72 69 61 6c 5f 74 79 70 65 2d 31 32 29  (serial_type-12)
e390: 2f 32 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e  /2;.      pMem->
e3a0: 7a 20 3d 20 28 63 68 61 72 20 2a 29 62 75 66 3b  z = (char *)buf;
e3b0: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 6e 20 3d  .      pMem->n =
e3c0: 20 6c 65 6e 3b 0a 20 20 20 20 20 20 70 4d 65 6d   len;.      pMem
e3d0: 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 20 20  ->xDel = 0;.    
e3e0: 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70    if( serial_typ
e3f0: 65 26 30 78 30 31 20 29 7b 0a 20 20 20 20 20 20  e&0x01 ){.      
e400: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
e410: 4d 45 4d 5f 53 74 72 20 7c 20 4d 45 4d 5f 45 70  MEM_Str | MEM_Ep
e420: 68 65 6d 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65  hem;.      }else
e430: 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e  {.        pMem->
e440: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 42 6c 6f 62  flags = MEM_Blob
e450: 20 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20   | MEM_Ephem;.  
e460: 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65 74 75      }.      retu
e470: 72 6e 20 6c 65 6e 3b 0a 20 20 20 20 7d 0a 20 20  rn len;.    }.  
e480: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
e490: 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61 64 65  ./*.** The heade
e4a0: 72 20 6f 66 20 61 20 72 65 63 6f 72 64 20 63 6f  r of a record co
e4b0: 6e 73 69 73 74 73 20 6f 66 20 61 20 73 65 71 75  nsists of a sequ
e4c0: 65 6e 63 65 20 76 61 72 69 61 62 6c 65 2d 6c 65  ence variable-le
e4d0: 6e 67 74 68 20 69 6e 74 65 67 65 72 73 2e 0a 2a  ngth integers..*
e4e0: 2a 20 54 68 65 73 65 20 69 6e 74 65 67 65 72 73  * These integers
e4f0: 20 61 72 65 20 61 6c 6d 6f 73 74 20 61 6c 77 61   are almost alwa
e500: 79 73 20 73 6d 61 6c 6c 20 61 6e 64 20 61 72 65  ys small and are
e510: 20 65 6e 63 6f 64 65 64 20 61 73 20 61 20 73 69   encoded as a si
e520: 6e 67 6c 65 20 62 79 74 65 2e 0a 2a 2a 20 54 68  ngle byte..** Th
e530: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61 63 72  e following macr
e540: 6f 20 74 61 6b 65 73 20 61 64 76 61 6e 74 61 67  o takes advantag
e550: 65 20 74 68 69 73 20 66 61 63 74 20 74 6f 20 70  e this fact to p
e560: 72 6f 76 69 64 65 20 61 20 66 61 73 74 20 64 65  rovide a fast de
e570: 63 6f 64 65 0a 2a 2a 20 6f 66 20 74 68 65 20 69  code.** of the i
e580: 6e 74 65 67 65 72 73 20 69 6e 20 61 20 72 65 63  ntegers in a rec
e590: 6f 72 64 20 68 65 61 64 65 72 2e 20 20 49 74 20  ord header.  It 
e5a0: 69 73 20 66 61 73 74 65 72 20 66 6f 72 20 74 68  is faster for th
e5b0: 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 0a 2a 2a  e common case.**
e5c0: 20 77 68 65 72 65 20 74 68 65 20 69 6e 74 65 67   where the integ
e5d0: 65 72 20 69 73 20 61 20 73 69 6e 67 6c 65 20 62  er is a single b
e5e0: 79 74 65 2e 20 20 49 74 20 69 73 20 61 20 6c 69  yte.  It is a li
e5f0: 74 74 6c 65 20 73 6c 6f 77 65 72 20 77 68 65 6e  ttle slower when
e600: 20 74 68 65 0a 2a 2a 20 69 6e 74 65 67 65 72 20   the.** integer 
e610: 69 73 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 62  is two or more b
e620: 79 74 65 73 2e 20 20 42 75 74 20 6f 76 65 72 61  ytes.  But overa
e630: 6c 6c 20 69 74 20 69 73 20 66 61 73 74 65 72 2e  ll it is faster.
e640: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f  .**.** The follo
e650: 77 69 6e 67 20 65 78 70 72 65 73 73 69 6f 6e 73  wing expressions
e660: 20 61 72 65 20 65 71 75 69 76 61 6c 65 6e 74 3a   are equivalent:
e670: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 78 20 3d 20 73  .**.**     x = s
e680: 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74 33  qlite3GetVarint3
e690: 32 28 20 41 2c 20 26 42 20 29 3b 0a 2a 2a 0a 2a  2( A, &B );.**.*
e6a0: 2a 20 20 20 20 20 78 20 3d 20 47 65 74 56 61 72  *     x = GetVar
e6b0: 69 6e 74 28 20 41 2c 20 42 20 29 3b 0a 2a 2a 0a  int( A, B );.**.
e6c0: 2a 2f 0a 23 64 65 66 69 6e 65 20 47 65 74 56 61  */.#define GetVa
e6d0: 72 69 6e 74 28 41 2c 42 29 20 20 28 28 42 20 3d  rint(A,B)  ((B =
e6e0: 20 2a 28 41 29 29 3c 3d 30 78 37 66 20 3f 20 31   *(A))<=0x7f ? 1
e6f0: 20 3a 20 73 71 6c 69 74 65 33 47 65 74 56 61 72   : sqlite3GetVar
e700: 69 6e 74 33 32 28 41 2c 20 26 42 29 29 0a 0a 2f  int32(A, &B))../
e710: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
e720: 6f 6e 20 63 6f 6d 70 61 72 65 73 20 74 68 65 20  on compares the 
e730: 74 77 6f 20 74 61 62 6c 65 20 72 6f 77 73 20 6f  two table rows o
e740: 72 20 69 6e 64 65 78 20 72 65 63 6f 72 64 73 20  r index records 
e750: 73 70 65 63 69 66 69 65 64 20 62 79 20 0a 2a 2a  specified by .**
e760: 20 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20   {nKey1, pKey1} 
e770: 61 6e 64 20 7b 6e 4b 65 79 32 2c 20 70 4b 65 79  and {nKey2, pKey
e780: 32 7d 2c 20 72 65 74 75 72 6e 69 6e 67 20 61 20  2}, returning a 
e790: 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 0a 2a  negative, zero.*
e7a0: 2a 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 6e  * or positive in
e7b0: 74 65 67 65 72 20 69 66 20 7b 6e 4b 65 79 31 2c  teger if {nKey1,
e7c0: 20 70 4b 65 79 31 7d 20 69 73 20 6c 65 73 73 20   pKey1} is less 
e7d0: 74 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f 20 6f  than, equal to o
e7e0: 72 20 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68  r .** greater th
e7f0: 61 6e 20 7b 6e 4b 65 79 32 2c 20 70 4b 65 79 32  an {nKey2, pKey2
e800: 7d 2e 20 20 42 6f 74 68 20 4b 65 79 31 20 61 6e  }.  Both Key1 an
e810: 64 20 4b 65 79 32 20 6d 75 73 74 20 62 65 20 62  d Key2 must be b
e820: 79 74 65 20 73 74 72 69 6e 67 73 0a 2a 2a 20 63  yte strings.** c
e830: 6f 6d 70 6f 73 65 64 20 62 79 20 74 68 65 20 4f  omposed by the O
e840: 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63  P_MakeRecord opc
e850: 6f 64 65 20 6f 66 20 74 68 65 20 56 44 42 45 2e  ode of the VDBE.
e860: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
e870: 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 65  dbeRecordCompare
e880: 28 0a 20 20 76 6f 69 64 20 2a 75 73 65 72 44 61  (.  void *userDa
e890: 74 61 2c 0a 20 20 69 6e 74 20 6e 4b 65 79 31 2c  ta,.  int nKey1,
e8a0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b 65   const void *pKe
e8b0: 79 31 2c 20 0a 20 20 69 6e 74 20 6e 4b 65 79 32  y1, .  int nKey2
e8c0: 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70 4b  , const void *pK
e8d0: 65 79 32 0a 29 7b 0a 20 20 4b 65 79 49 6e 66 6f  ey2.){.  KeyInfo
e8e0: 20 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 28 4b 65   *pKeyInfo = (Ke
e8f0: 79 49 6e 66 6f 2a 29 75 73 65 72 44 61 74 61 3b  yInfo*)userData;
e900: 0a 20 20 75 33 32 20 64 31 2c 20 64 32 3b 20 20  .  u32 d1, d2;  
e910: 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66 73 65          /* Offse
e920: 74 20 69 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66  t into aKey[] of
e930: 20 6e 65 78 74 20 64 61 74 61 20 65 6c 65 6d 65   next data eleme
e940: 6e 74 20 2a 2f 0a 20 20 75 33 32 20 69 64 78 31  nt */.  u32 idx1
e950: 2c 20 69 64 78 32 3b 20 20 20 20 20 20 2f 2a 20  , idx2;      /* 
e960: 4f 66 66 73 65 74 20 69 6e 74 6f 20 61 4b 65 79  Offset into aKey
e970: 5b 5d 20 6f 66 20 6e 65 78 74 20 68 65 61 64 65  [] of next heade
e980: 72 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20 75  r element */.  u
e990: 33 32 20 73 7a 48 64 72 31 2c 20 73 7a 48 64 72  32 szHdr1, szHdr
e9a0: 32 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66  2;  /* Number of
e9b0: 20 62 79 74 65 73 20 69 6e 20 68 65 61 64 65 72   bytes in header
e9c0: 20 2a 2f 0a 20 20 69 6e 74 20 69 20 3d 20 30 3b   */.  int i = 0;
e9d0: 0a 20 20 69 6e 74 20 6e 46 69 65 6c 64 3b 0a 20  .  int nField;. 
e9e0: 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20 20 63   int rc = 0;.  c
e9f0: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
ea00: 61 72 20 2a 61 4b 65 79 31 20 3d 20 28 63 6f 6e  ar *aKey1 = (con
ea10: 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  st unsigned char
ea20: 20 2a 29 70 4b 65 79 31 3b 0a 20 20 63 6f 6e 73   *)pKey1;.  cons
ea30: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20  t unsigned char 
ea40: 2a 61 4b 65 79 32 20 3d 20 28 63 6f 6e 73 74 20  *aKey2 = (const 
ea50: 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20 2a 29  unsigned char *)
ea60: 70 4b 65 79 32 3b 0a 0a 20 20 4d 65 6d 20 6d 65  pKey2;..  Mem me
ea70: 6d 31 3b 0a 20 20 4d 65 6d 20 6d 65 6d 32 3b 0a  m1;.  Mem mem2;.
ea80: 20 20 6d 65 6d 31 2e 65 6e 63 20 3d 20 70 4b 65    mem1.enc = pKe
ea90: 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20 6d 65  yInfo->enc;.  me
eaa0: 6d 32 2e 65 6e 63 20 3d 20 70 4b 65 79 49 6e 66  m2.enc = pKeyInf
eab0: 6f 2d 3e 65 6e 63 3b 0a 20 20 0a 20 20 69 64 78  o->enc;.  .  idx
eac0: 31 20 3d 20 47 65 74 56 61 72 69 6e 74 28 61 4b  1 = GetVarint(aK
ead0: 65 79 31 2c 20 73 7a 48 64 72 31 29 3b 0a 20 20  ey1, szHdr1);.  
eae0: 64 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20 20 69  d1 = szHdr1;.  i
eaf0: 64 78 32 20 3d 20 47 65 74 56 61 72 69 6e 74 28  dx2 = GetVarint(
eb00: 61 4b 65 79 32 2c 20 73 7a 48 64 72 32 29 3b 0a  aKey2, szHdr2);.
eb10: 20 20 64 32 20 3d 20 73 7a 48 64 72 32 3b 0a 20    d2 = szHdr2;. 
eb20: 20 6e 46 69 65 6c 64 20 3d 20 70 4b 65 79 49 6e   nField = pKeyIn
eb30: 66 6f 2d 3e 6e 46 69 65 6c 64 3b 0a 20 20 77 68  fo->nField;.  wh
eb40: 69 6c 65 28 20 69 64 78 31 3c 73 7a 48 64 72 31  ile( idx1<szHdr1
eb50: 20 26 26 20 69 64 78 32 3c 73 7a 48 64 72 32 20   && idx2<szHdr2 
eb60: 29 7b 0a 20 20 20 20 75 33 32 20 73 65 72 69 61  ){.    u32 seria
eb70: 6c 5f 74 79 70 65 31 3b 0a 20 20 20 20 75 33 32  l_type1;.    u32
eb80: 20 73 65 72 69 61 6c 5f 74 79 70 65 32 3b 0a 0a   serial_type2;..
eb90: 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20      /* Read the 
eba0: 73 65 72 69 61 6c 20 74 79 70 65 73 20 66 6f 72  serial types for
ebb0: 20 74 68 65 20 6e 65 78 74 20 65 6c 65 6d 65 6e   the next elemen
ebc0: 74 20 69 6e 20 65 61 63 68 20 6b 65 79 2e 20 2a  t in each key. *
ebd0: 2f 0a 20 20 20 20 69 64 78 31 20 2b 3d 20 47 65  /.    idx1 += Ge
ebe0: 74 56 61 72 69 6e 74 28 20 61 4b 65 79 31 2b 69  tVarint( aKey1+i
ebf0: 64 78 31 2c 20 73 65 72 69 61 6c 5f 74 79 70 65  dx1, serial_type
ec00: 31 20 29 3b 0a 20 20 20 20 69 66 28 20 64 31 3e  1 );.    if( d1>
ec10: 3d 6e 4b 65 79 31 20 26 26 20 73 71 6c 69 74 65  =nKey1 && sqlite
ec20: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
ec30: 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65 31 29  en(serial_type1)
ec40: 3e 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20  >0 ) break;.    
ec50: 69 64 78 32 20 2b 3d 20 47 65 74 56 61 72 69 6e  idx2 += GetVarin
ec60: 74 28 20 61 4b 65 79 32 2b 69 64 78 32 2c 20 73  t( aKey2+idx2, s
ec70: 65 72 69 61 6c 5f 74 79 70 65 32 20 29 3b 0a 20  erial_type2 );. 
ec80: 20 20 20 69 66 28 20 64 32 3e 3d 6e 4b 65 79 32     if( d2>=nKey2
ec90: 20 26 26 20 73 71 6c 69 74 65 33 56 64 62 65 53   && sqlite3VdbeS
eca0: 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72  erialTypeLen(ser
ecb0: 69 61 6c 5f 74 79 70 65 32 29 3e 30 20 29 20 62  ial_type2)>0 ) b
ecc0: 72 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20 45 78  reak;..    /* Ex
ecd0: 74 72 61 63 74 20 74 68 65 20 76 61 6c 75 65 73  tract the values
ece0: 20 74 6f 20 62 65 20 63 6f 6d 70 61 72 65 64 2e   to be compared.
ecf0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 64 31 20 2b  .    */.    d1 +
ed00: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
ed10: 69 61 6c 47 65 74 28 26 61 4b 65 79 31 5b 64 31  ialGet(&aKey1[d1
ed20: 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 31 2c  ], serial_type1,
ed30: 20 26 6d 65 6d 31 29 3b 0a 20 20 20 20 64 32 20   &mem1);.    d2 
ed40: 2b 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  += sqlite3VdbeSe
ed50: 72 69 61 6c 47 65 74 28 26 61 4b 65 79 32 5b 64  rialGet(&aKey2[d
ed60: 32 5d 2c 20 73 65 72 69 61 6c 5f 74 79 70 65 32  2], serial_type2
ed70: 2c 20 26 6d 65 6d 32 29 3b 0a 0a 20 20 20 20 2f  , &mem2);..    /
ed80: 2a 20 44 6f 20 74 68 65 20 63 6f 6d 70 61 72 69  * Do the compari
ed90: 73 6f 6e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 72  son.    */.    r
eda0: 63 20 3d 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f  c = sqlite3MemCo
edb0: 6d 70 61 72 65 28 26 6d 65 6d 31 2c 20 26 6d 65  mpare(&mem1, &me
edc0: 6d 32 2c 20 69 3c 6e 46 69 65 6c 64 20 3f 20 70  m2, i<nField ? p
edd0: 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 69  KeyInfo->aColl[i
ede0: 5d 20 3a 20 30 29 3b 0a 20 20 20 20 69 66 28 20  ] : 0);.    if( 
edf0: 6d 65 6d 31 2e 66 6c 61 67 73 20 26 20 4d 45 4d  mem1.flags & MEM
ee00: 5f 44 79 6e 20 29 20 73 71 6c 69 74 65 33 56 64  _Dyn ) sqlite3Vd
ee10: 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26 6d 65  beMemRelease(&me
ee20: 6d 31 29 3b 0a 20 20 20 20 69 66 28 20 6d 65 6d  m1);.    if( mem
ee30: 32 2e 66 6c 61 67 73 20 26 20 4d 45 4d 5f 44 79  2.flags & MEM_Dy
ee40: 6e 20 29 20 73 71 6c 69 74 65 33 56 64 62 65 4d  n ) sqlite3VdbeM
ee50: 65 6d 52 65 6c 65 61 73 65 28 26 6d 65 6d 32 29  emRelease(&mem2)
ee60: 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d 30 20  ;.    if( rc!=0 
ee70: 29 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  ){.      break;.
ee80: 20 20 20 20 7d 0a 20 20 20 20 69 2b 2b 3b 0a 20      }.    i++;. 
ee90: 20 7d 0a 0a 20 20 2f 2a 20 4f 6e 65 20 6f 66 20   }..  /* One of 
eea0: 74 68 65 20 6b 65 79 73 20 72 61 6e 20 6f 75 74  the keys ran out
eeb0: 20 6f 66 20 66 69 65 6c 64 73 2c 20 62 75 74 20   of fields, but 
eec0: 61 6c 6c 20 74 68 65 20 66 69 65 6c 64 73 20 75  all the fields u
eed0: 70 20 74 6f 20 74 68 61 74 20 70 6f 69 6e 74 0a  p to that point.
eee0: 20 20 2a 2a 20 77 65 72 65 20 65 71 75 61 6c 2e    ** were equal.
eef0: 20 49 66 20 74 68 65 20 69 6e 63 72 4b 65 79 20   If the incrKey 
ef00: 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20 74 68  flag is true, th
ef10: 65 6e 20 74 68 65 20 73 65 63 6f 6e 64 20 6b 65  en the second ke
ef20: 79 20 69 73 0a 20 20 2a 2a 20 74 72 65 61 74 65  y is.  ** treate
ef30: 64 20 61 73 20 6c 61 72 67 65 72 2e 0a 20 20 2a  d as larger..  *
ef40: 2f 0a 20 20 69 66 28 20 72 63 3d 3d 30 20 29 7b  /.  if( rc==0 ){
ef50: 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66  .    if( pKeyInf
ef60: 6f 2d 3e 69 6e 63 72 4b 65 79 20 29 7b 0a 20 20  o->incrKey ){.  
ef70: 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20 20      rc = -1;.   
ef80: 20 7d 65 6c 73 65 20 69 66 28 20 64 31 3c 6e 4b   }else if( d1<nK
ef90: 65 79 31 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ey1 ){.      rc 
efa0: 3d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69  = 1;.    }else i
efb0: 66 28 20 64 32 3c 6e 4b 65 79 32 20 29 7b 0a 20  f( d2<nKey2 ){. 
efc0: 20 20 20 20 20 72 63 20 3d 20 2d 31 3b 0a 20 20       rc = -1;.  
efd0: 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20    }.  }else if( 
efe0: 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f  pKeyInfo->aSortO
eff0: 72 64 65 72 20 26 26 20 69 3c 70 4b 65 79 49 6e  rder && i<pKeyIn
f000: 66 6f 2d 3e 6e 46 69 65 6c 64 0a 20 20 20 20 20  fo->nField.     
f010: 20 20 20 20 20 20 20 20 20 20 26 26 20 70 4b 65            && pKe
f020: 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65  yInfo->aSortOrde
f030: 72 5b 69 5d 20 29 7b 0a 20 20 20 20 72 63 20 3d  r[i] ){.    rc =
f040: 20 2d 72 63 3b 0a 20 20 7d 0a 0a 20 20 72 65 74   -rc;.  }..  ret
f050: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
f060: 20 54 68 65 20 61 72 67 75 6d 65 6e 74 20 69 73   The argument is
f070: 20 61 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20   an index entry 
f080: 63 6f 6d 70 6f 73 65 64 20 75 73 69 6e 67 20 74  composed using t
f090: 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64  he OP_MakeRecord
f0a0: 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 54 68 65 20   opcode..** The 
f0b0: 6c 61 73 74 20 65 6e 74 72 79 20 69 6e 20 74 68  last entry in th
f0c0: 69 73 20 72 65 63 6f 72 64 20 73 68 6f 75 6c 64  is record should
f0d0: 20 62 65 20 61 6e 20 69 6e 74 65 67 65 72 20 28   be an integer (
f0e0: 73 70 65 63 69 66 69 63 61 6c 6c 79 0a 2a 2a 20  specifically.** 
f0f0: 61 6e 20 69 6e 74 65 67 65 72 20 72 6f 77 69 64  an integer rowid
f100: 29 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65  ).  This routine
f110: 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e 75 6d   returns the num
f120: 62 65 72 20 6f 66 20 62 79 74 65 73 20 69 6e 0a  ber of bytes in.
f130: 2a 2a 20 74 68 61 74 20 69 6e 74 65 67 65 72 2e  ** that integer.
f140: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
f150: 64 62 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 63  dbeIdxRowidLen(c
f160: 6f 6e 73 74 20 75 38 20 2a 61 4b 65 79 29 7b 0a  onst u8 *aKey){.
f170: 20 20 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20    u32 szHdr;    
f180: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74      /* Size of t
f190: 68 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75  he header */.  u
f1a0: 33 32 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20  32 typeRowid;   
f1b0: 20 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20   /* Serial type 
f1c0: 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a  of the rowid */.
f1d0: 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56 61 72  .  sqlite3GetVar
f1e0: 69 6e 74 33 32 28 61 4b 65 79 2c 20 26 73 7a 48  int32(aKey, &szH
f1f0: 64 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 65  dr);.  sqlite3Ge
f200: 74 56 61 72 69 6e 74 33 32 28 26 61 4b 65 79 5b  tVarint32(&aKey[
f210: 73 7a 48 64 72 2d 31 5d 2c 20 26 74 79 70 65 52  szHdr-1], &typeR
f220: 6f 77 69 64 29 3b 0a 20 20 72 65 74 75 72 6e 20  owid);.  return 
f230: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
f240: 6c 54 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77  lTypeLen(typeRow
f250: 69 64 29 3b 0a 7d 0a 20 20 0a 0a 2f 2a 0a 2a 2a  id);.}.  ../*.**
f260: 20 70 43 75 72 20 70 6f 69 6e 74 73 20 61 74 20   pCur points at 
f270: 61 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63  an index entry c
f280: 72 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 65  reated using the
f290: 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f   OP_MakeRecord o
f2a0: 70 63 6f 64 65 2e 0a 2a 2a 20 52 65 61 64 20 74  pcode..** Read t
f2b0: 68 65 20 72 6f 77 69 64 20 28 74 68 65 20 6c 61  he rowid (the la
f2c0: 73 74 20 66 69 65 6c 64 20 69 6e 20 74 68 65 20  st field in the 
f2d0: 72 65 63 6f 72 64 29 20 61 6e 64 20 73 74 6f 72  record) and stor
f2e0: 65 20 69 74 20 69 6e 20 2a 72 6f 77 69 64 2e 0a  e it in *rowid..
f2f0: 2a 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45  ** Return SQLITE
f300: 5f 4f 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e  _OK if everythin
f310: 67 20 77 6f 72 6b 73 2c 20 6f 72 20 61 6e 20 65  g works, or an e
f320: 72 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77  rror code otherw
f330: 69 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ise..*/.int sqli
f340: 74 65 33 56 64 62 65 49 64 78 52 6f 77 69 64 28  te3VdbeIdxRowid(
f350: 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20  BtCursor *pCur, 
f360: 69 36 34 20 2a 72 6f 77 69 64 29 7b 0a 20 20 69  i64 *rowid){.  i
f370: 36 34 20 6e 43 65 6c 6c 4b 65 79 20 3d 20 30 3b  64 nCellKey = 0;
f380: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33 32  .  int rc;.  u32
f390: 20 73 7a 48 64 72 3b 20 20 20 20 20 20 20 20 2f   szHdr;        /
f3a0: 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 68 65  * Size of the he
f3b0: 61 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 74 79  ader */.  u32 ty
f3c0: 70 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a 20 53  peRowid;    /* S
f3d0: 65 72 69 61 6c 20 74 79 70 65 20 6f 66 20 74 68  erial type of th
f3e0: 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20 75 33 32  e rowid */.  u32
f3f0: 20 6c 65 6e 52 6f 77 69 64 3b 20 20 20 20 20 2f   lenRowid;     /
f400: 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 72 6f  * Size of the ro
f410: 77 69 64 20 2a 2f 0a 20 20 4d 65 6d 20 6d 2c 20  wid */.  Mem m, 
f420: 76 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72  v;..  sqlite3Btr
f430: 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c 20  eeKeySize(pCur, 
f440: 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 69 66  &nCellKey);.  if
f450: 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b  ( nCellKey<=0 ){
f460: 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49  .    return SQLI
f470: 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b  TE_CORRUPT_BKPT;
f480: 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69  .  }.  rc = sqli
f490: 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74  te3VdbeMemFromBt
f4a0: 72 65 65 28 70 43 75 72 2c 20 30 2c 20 6e 43 65  ree(pCur, 0, nCe
f4b0: 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20  llKey, 1, &m);. 
f4c0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72   if( rc ){.    r
f4d0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
f4e0: 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e 74  sqlite3GetVarint
f4f0: 33 32 28 28 75 38 2a 29 6d 2e 7a 2c 20 26 73 7a  32((u8*)m.z, &sz
f500: 48 64 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47  Hdr);.  sqlite3G
f510: 65 74 56 61 72 69 6e 74 33 32 28 28 75 38 2a 29  etVarint32((u8*)
f520: 26 6d 2e 7a 5b 73 7a 48 64 72 2d 31 5d 2c 20 26  &m.z[szHdr-1], &
f530: 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 6c 65  typeRowid);.  le
f540: 6e 52 6f 77 69 64 20 3d 20 73 71 6c 69 74 65 33  nRowid = sqlite3
f550: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c 65  VdbeSerialTypeLe
f560: 6e 28 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20  n(typeRowid);.  
f570: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
f580: 6c 47 65 74 28 28 75 38 2a 29 26 6d 2e 7a 5b 6d  lGet((u8*)&m.z[m
f590: 2e 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20 74 79  .n-lenRowid], ty
f5a0: 70 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a 20 20  peRowid, &v);.  
f5b0: 2a 72 6f 77 69 64 20 3d 20 76 2e 75 2e 69 3b 0a  *rowid = v.u.i;.
f5c0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d    sqlite3VdbeMem
f5d0: 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20 72  Release(&m);.  r
f5e0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
f5f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72  .}../*.** Compar
f600: 65 20 74 68 65 20 6b 65 79 20 6f 66 20 74 68 65  e the key of the
f610: 20 69 6e 64 65 78 20 65 6e 74 72 79 20 74 68 61   index entry tha
f620: 74 20 63 75 72 73 6f 72 20 70 43 20 69 73 20 70  t cursor pC is p
f630: 6f 69 6e 74 20 74 6f 20 61 67 61 69 6e 73 74 0a  oint to against.
f640: 2a 2a 20 74 68 65 20 6b 65 79 20 73 74 72 69 6e  ** the key strin
f650: 67 20 69 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65  g in pKey (of le
f660: 6e 67 74 68 20 6e 4b 65 79 29 2e 20 20 57 72 69  ngth nKey).  Wri
f670: 74 65 20 69 6e 74 6f 20 2a 70 52 65 73 20 61 20  te into *pRes a 
f680: 6e 75 6d 62 65 72 0a 2a 2a 20 74 68 61 74 20 69  number.** that i
f690: 73 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f  s negative, zero
f6a0: 2c 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 66  , or positive if
f6b0: 20 70 43 20 69 73 20 6c 65 73 73 20 74 68 61 6e   pC is less than
f6c0: 2c 20 65 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f  , equal to,.** o
f6d0: 72 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70  r greater than p
f6e0: 4b 65 79 2e 20 20 52 65 74 75 72 6e 20 53 51 4c  Key.  Return SQL
f6f0: 49 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73  ITE_OK on succes
f700: 73 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73  s..**.** pKey is
f710: 20 65 69 74 68 65 72 20 63 72 65 61 74 65 64 20   either created 
f720: 77 69 74 68 6f 75 74 20 61 20 72 6f 77 69 64 20  without a rowid 
f730: 6f 72 20 69 73 20 74 72 75 6e 63 61 74 65 64 20  or is truncated 
f740: 73 6f 20 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d  so that it.** om
f750: 69 74 73 20 74 68 65 20 72 6f 77 69 64 20 61 74  its the rowid at
f760: 20 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20 72   the end.  The r
f770: 6f 77 69 64 20 61 74 20 74 68 65 20 65 6e 64 20  owid at the end 
f780: 6f 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74  of the index ent
f790: 72 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64  ry.** is ignored
f7a0: 20 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74   as well..*/.int
f7b0: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b   sqlite3VdbeIdxK
f7c0: 65 79 43 6f 6d 70 61 72 65 28 0a 20 20 43 75 72  eyCompare(.  Cur
f7d0: 73 6f 72 20 2a 70 43 2c 20 20 20 20 20 20 20 20  sor *pC,        
f7e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
f7f0: 63 75 72 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72  cursor to compar
f800: 65 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69  e against */.  i
f810: 6e 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75  nt nKey, const u
f820: 38 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68  8 *pKey,   /* Th
f830: 65 20 6b 65 79 20 74 6f 20 63 6f 6d 70 61 72 65  e key to compare
f840: 20 2a 2f 0a 20 20 69 6e 74 20 2a 72 65 73 20 20   */.  int *res  
f850: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
f860: 20 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63    /* Write the c
f870: 6f 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c 74  omparison result
f880: 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36   here */.){.  i6
f890: 34 20 6e 43 65 6c 6c 4b 65 79 20 3d 20 30 3b 0a  4 nCellKey = 0;.
f8a0: 20 20 69 6e 74 20 72 63 3b 0a 20 20 42 74 43 75    int rc;.  BtCu
f8b0: 72 73 6f 72 20 2a 70 43 75 72 20 3d 20 70 43 2d  rsor *pCur = pC-
f8c0: 3e 70 43 75 72 73 6f 72 3b 0a 20 20 69 6e 74 20  >pCursor;.  int 
f8d0: 6c 65 6e 52 6f 77 69 64 3b 0a 20 20 4d 65 6d 20  lenRowid;.  Mem 
f8e0: 6d 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74 72  m;..  sqlite3Btr
f8f0: 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c 20  eeKeySize(pCur, 
f900: 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 69 66  &nCellKey);.  if
f910: 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20 29 7b  ( nCellKey<=0 ){
f920: 0a 20 20 20 20 2a 72 65 73 20 3d 20 30 3b 0a 20  .    *res = 0;. 
f930: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
f940: 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20  _OK;.  }.  rc = 
f950: 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 46 72  sqlite3VdbeMemFr
f960: 6f 6d 42 74 72 65 65 28 70 43 2d 3e 70 43 75 72  omBtree(pC->pCur
f970: 73 6f 72 2c 20 30 2c 20 6e 43 65 6c 6c 4b 65 79  sor, 0, nCellKey
f980: 2c 20 31 2c 20 26 6d 29 3b 0a 20 20 69 66 28 20  , 1, &m);.  if( 
f990: 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  rc ){.    return
f9a0: 20 72 63 3b 0a 20 20 7d 0a 20 20 6c 65 6e 52 6f   rc;.  }.  lenRo
f9b0: 77 69 64 20 3d 20 73 71 6c 69 74 65 33 56 64 62  wid = sqlite3Vdb
f9c0: 65 49 64 78 52 6f 77 69 64 4c 65 6e 28 28 75 38  eIdxRowidLen((u8
f9d0: 2a 29 6d 2e 7a 29 3b 0a 20 20 2a 72 65 73 20 3d  *)m.z);.  *res =
f9e0: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
f9f0: 72 64 43 6f 6d 70 61 72 65 28 70 43 2d 3e 70 4b  rdCompare(pC->pK
fa00: 65 79 49 6e 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52  eyInfo, m.n-lenR
fa10: 6f 77 69 64 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c  owid, m.z, nKey,
fa20: 20 70 4b 65 79 29 3b 0a 20 20 73 71 6c 69 74 65   pKey);.  sqlite
fa30: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
fa40: 26 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  &m);.  return SQ
fa50: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
fa60: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
fa70: 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f  ets the value to
fa80: 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20   be returned by 
fa90: 73 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73  subsequent calls
faa0: 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63   to.** sqlite3_c
fab0: 68 61 6e 67 65 73 28 29 20 6f 6e 20 74 68 65 20  hanges() on the 
fac0: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
fad0: 27 64 62 27 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73  'db'. .*/.void s
fae0: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61  qlite3VdbeSetCha
faf0: 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62  nges(sqlite3 *db
fb00: 2c 20 69 6e 74 20 6e 43 68 61 6e 67 65 29 7b 0a  , int nChange){.
fb10: 20 20 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20    db->nChange = 
fb20: 6e 43 68 61 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e  nChange;.  db->n
fb30: 54 6f 74 61 6c 43 68 61 6e 67 65 20 2b 3d 20 6e  TotalChange += n
fb40: 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Change;.}../*.**
fb50: 20 53 65 74 20 61 20 66 6c 61 67 20 69 6e 20 74   Set a flag in t
fb60: 68 65 20 76 64 62 65 20 74 6f 20 75 70 64 61 74  he vdbe to updat
fb70: 65 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f 75  e the change cou
fb80: 6e 74 65 72 20 77 68 65 6e 20 69 74 20 69 73 20  nter when it is 
fb90: 66 69 6e 61 6c 69 73 65 64 0a 2a 2a 20 6f 72 20  finalised.** or 
fba0: 72 65 73 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  reset..*/.void s
fbb0: 71 6c 69 74 65 33 56 64 62 65 43 6f 75 6e 74 43  qlite3VdbeCountC
fbc0: 68 61 6e 67 65 73 28 56 64 62 65 20 2a 76 29 7b  hanges(Vdbe *v){
fbd0: 0a 20 20 76 2d 3e 63 68 61 6e 67 65 43 6e 74 4f  .  v->changeCntO
fbe0: 6e 20 3d 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  n = 1;.}../*.** 
fbf0: 4d 61 72 6b 20 65 76 65 72 79 20 70 72 65 70 61  Mark every prepa
fc00: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 73  red statement as
fc10: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20  sociated with a 
fc20: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
fc30: 69 6f 6e 0a 2a 2a 20 61 73 20 65 78 70 69 72 65  ion.** as expire
fc40: 64 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 69  d..**.** An expi
fc50: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 6d 65  red statement me
fc60: 61 6e 73 20 74 68 61 74 20 72 65 63 6f 6d 70 69  ans that recompi
fc70: 6c 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 74  lation of the st
fc80: 61 74 65 6d 65 6e 74 20 69 73 0a 2a 2a 20 72 65  atement is.** re
fc90: 63 6f 6d 6d 65 6e 64 2e 20 20 53 74 61 74 65 6d  commend.  Statem
fca0: 65 6e 74 73 20 65 78 70 69 72 65 20 77 68 65 6e  ents expire when
fcb0: 20 74 68 69 6e 67 73 20 68 61 70 70 65 6e 20 74   things happen t
fcc0: 68 61 74 20 6d 61 6b 65 20 74 68 65 69 72 0a 2a  hat make their.*
fcd0: 2a 20 70 72 6f 67 72 61 6d 73 20 6f 62 73 6f 6c  * programs obsol
fce0: 65 74 65 2e 20 20 52 65 6d 6f 76 69 6e 67 20 75  ete.  Removing u
fcf0: 73 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63  ser-defined func
fd00: 74 69 6f 6e 73 20 6f 72 20 63 6f 6c 6c 61 74 69  tions or collati
fd10: 6e 67 0a 2a 2a 20 73 65 71 75 65 6e 63 65 73 2c  ng.** sequences,
fd20: 20 6f 72 20 63 68 61 6e 67 69 6e 67 20 61 6e 20   or changing an 
fd30: 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75  authorization fu
fd40: 6e 63 74 69 6f 6e 20 61 72 65 20 74 68 65 20 74  nction are the t
fd50: 79 70 65 73 20 6f 66 0a 2a 2a 20 74 68 69 6e 67  ypes of.** thing
fd60: 73 20 74 68 61 74 20 6d 61 6b 65 20 70 72 65 70  s that make prep
fd70: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 20  ared statements 
fd80: 6f 62 73 6f 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69  obsolete..*/.voi
fd90: 64 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50  d sqlite3ExpireP
fda0: 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74  reparedStatement
fdb0: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  s(sqlite3 *db){.
fdc0: 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 66 6f 72    Vdbe *p;.  for
fdd0: 28 70 20 3d 20 64 62 2d 3e 70 56 64 62 65 3b 20  (p = db->pVdbe; 
fde0: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a  p; p=p->pNext){.
fdf0: 20 20 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d      p->expired =
fe00: 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a   1;.  }.}../*.**
fe10: 20 52 65 74 75 72 6e 20 74 68 65 20 64 61 74 61   Return the data
fe20: 62 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20  base associated 
fe30: 77 69 74 68 20 74 68 65 20 56 64 62 65 2e 0a 2a  with the Vdbe..*
fe40: 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74  /.sqlite3 *sqlit
fe50: 65 33 56 64 62 65 44 62 28 56 64 62 65 20 2a 76  e3VdbeDb(Vdbe *v
fe60: 29 7b 0a 20 20 72 65 74 75 72 6e 20 76 2d 3e 64  ){.  return v->d
fe70: 62 3b 0a 7d 0a                                   b;.}.