/ Hex Artifact Content
Login

Artifact 1d765d671ae31a067b2b064c3f193690f91eea62:


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 54  rn p;.}../*.** T
0540: 75 72 6e 20 74 72 61 63 69 6e 67 20 6f 6e 20 6f  urn tracing on o
0550: 72 20 6f 66 66 0a 2a 2f 0a 76 6f 69 64 20 73 71  r off.*/.void sq
0560: 6c 69 74 65 33 56 64 62 65 54 72 61 63 65 28 56  lite3VdbeTrace(V
0570: 64 62 65 20 2a 70 2c 20 46 49 4c 45 20 2a 74 72  dbe *p, FILE *tr
0580: 61 63 65 29 7b 0a 20 20 70 2d 3e 74 72 61 63 65  ace){.  p->trace
0590: 20 3d 20 74 72 61 63 65 3b 0a 7d 0a 0a 2f 2a 0a   = trace;.}../*.
05a0: 2a 2a 20 52 65 73 69 7a 65 20 74 68 65 20 56 64  ** Resize the Vd
05b0: 62 65 2e 61 4f 70 20 61 72 72 61 79 20 73 6f 20  be.aOp array so 
05c0: 74 68 61 74 20 69 74 20 63 6f 6e 74 61 69 6e 73  that it contains
05d0: 20 61 74 20 6c 65 61 73 74 20 4e 0a 2a 2a 20 65   at least N.** e
05e0: 6c 65 6d 65 6e 74 73 2e 20 49 66 20 74 68 65 20  lements. If the 
05f0: 56 64 62 65 20 69 73 20 69 6e 20 56 44 42 45 5f  Vdbe is in VDBE_
0600: 4d 41 47 49 43 5f 52 55 4e 20 73 74 61 74 65 2c  MAGIC_RUN state,
0610: 20 74 68 65 6e 0a 2a 2a 20 74 68 65 20 56 64 62   then.** the Vdb
0620: 65 2e 61 4f 70 20 61 72 72 61 79 20 77 69 6c 6c  e.aOp array will
0630: 20 62 65 20 73 69 7a 65 64 20 74 6f 20 63 6f 6e   be sized to con
0640: 74 61 69 6e 20 65 78 61 63 74 6c 79 20 4e 20 0a  tain exactly N .
0650: 2a 2a 20 65 6c 65 6d 65 6e 74 73 2e 0a 2a 2f 0a  ** elements..*/.
0660: 73 74 61 74 69 63 20 76 6f 69 64 20 72 65 73 69  static void resi
0670: 7a 65 4f 70 41 72 72 61 79 28 56 64 62 65 20 2a  zeOpArray(Vdbe *
0680: 70 2c 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74  p, int N){.  int
0690: 20 72 75 6e 4d 6f 64 65 20 3d 20 70 2d 3e 6d 61   runMode = p->ma
06a0: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
06b0: 52 55 4e 3b 0a 20 20 69 66 28 20 72 75 6e 4d 6f  RUN;.  if( runMo
06c0: 64 65 20 7c 7c 20 70 2d 3e 6e 4f 70 41 6c 6c 6f  de || p->nOpAllo
06d0: 63 3c 4e 20 29 7b 0a 20 20 20 20 56 64 62 65 4f  c<N ){.    VdbeO
06e0: 70 20 2a 70 4e 65 77 3b 0a 20 20 20 20 69 6e 74  p *pNew;.    int
06f0: 20 6e 4e 65 77 20 3d 20 4e 20 2b 20 31 30 30 2a   nNew = N + 100*
0700: 28 21 72 75 6e 4d 6f 64 65 29 3b 0a 20 20 20 20  (!runMode);.    
0710: 69 6e 74 20 6f 6c 64 53 69 7a 65 20 3d 20 70 2d  int oldSize = p-
0720: 3e 6e 4f 70 41 6c 6c 6f 63 3b 0a 20 20 20 20 70  >nOpAlloc;.    p
0730: 4e 65 77 20 3d 20 73 71 6c 69 74 65 52 65 61 6c  New = sqliteReal
0740: 6c 6f 63 28 70 2d 3e 61 4f 70 2c 20 6e 4e 65 77  loc(p->aOp, nNew
0750: 2a 73 69 7a 65 6f 66 28 4f 70 29 29 3b 0a 20 20  *sizeof(Op));.  
0760: 20 20 69 66 28 20 70 4e 65 77 20 29 7b 0a 20 20    if( pNew ){.  
0770: 20 20 20 20 70 2d 3e 6e 4f 70 41 6c 6c 6f 63 20      p->nOpAlloc 
0780: 3d 20 6e 4e 65 77 3b 0a 20 20 20 20 20 20 70 2d  = nNew;.      p-
0790: 3e 61 4f 70 20 3d 20 70 4e 65 77 3b 0a 20 20 20  >aOp = pNew;.   
07a0: 20 20 20 69 66 28 20 6e 4e 65 77 3e 6f 6c 64 53     if( nNew>oldS
07b0: 69 7a 65 20 29 7b 0a 20 20 20 20 20 20 20 20 6d  ize ){.        m
07c0: 65 6d 73 65 74 28 26 70 2d 3e 61 4f 70 5b 6f 6c  emset(&p->aOp[ol
07d0: 64 53 69 7a 65 5d 2c 20 30 2c 20 28 6e 4e 65 77  dSize], 0, (nNew
07e0: 2d 6f 6c 64 53 69 7a 65 29 2a 73 69 7a 65 6f 66  -oldSize)*sizeof
07f0: 28 4f 70 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20  (Op));.      }. 
0800: 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a     }.  }.}../*.*
0810: 2a 20 41 64 64 20 61 20 6e 65 77 20 69 6e 73 74  * Add a new inst
0820: 72 75 63 74 69 6f 6e 20 74 6f 20 74 68 65 20 6c  ruction to the l
0830: 69 73 74 20 6f 66 20 69 6e 73 74 72 75 63 74 69  ist of instructi
0840: 6f 6e 73 20 63 75 72 72 65 6e 74 20 69 6e 20 74  ons current in t
0850: 68 65 0a 2a 2a 20 56 44 42 45 2e 20 20 52 65 74  he.** VDBE.  Ret
0860: 75 72 6e 20 74 68 65 20 61 64 64 72 65 73 73 20  urn the address 
0870: 6f 66 20 74 68 65 20 6e 65 77 20 69 6e 73 74 72  of the new instr
0880: 75 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 50 61  uction..**.** Pa
0890: 72 61 6d 65 74 65 72 73 3a 0a 2a 2a 0a 2a 2a 20  rameters:.**.** 
08a0: 20 20 20 70 20 20 20 20 20 20 20 20 20 20 20 20     p            
08b0: 20 20 20 50 6f 69 6e 74 65 72 20 74 6f 20 74 68     Pointer to th
08c0: 65 20 56 44 42 45 0a 2a 2a 0a 2a 2a 20 20 20 20  e VDBE.**.**    
08d0: 6f 70 20 20 20 20 20 20 20 20 20 20 20 20 20 20  op              
08e0: 54 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20 74  The opcode for t
08f0: 68 69 73 20 69 6e 73 74 72 75 63 74 69 6f 6e 0a  his instruction.
0900: 2a 2a 0a 2a 2a 20 20 20 20 70 31 2c 20 70 32 20  **.**    p1, p2 
0910: 20 20 20 20 20 20 20 20 20 46 69 72 73 74 20 74           First t
0920: 77 6f 20 6f 66 20 74 68 65 20 74 68 72 65 65 20  wo of the three 
0930: 70 6f 73 73 69 62 6c 65 20 6f 70 65 72 61 6e 64  possible operand
0940: 73 2e 0a 2a 2a 0a 2a 2a 20 55 73 65 20 74 68 65  s..**.** Use the
0950: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 6f   sqlite3VdbeReso
0960: 6c 76 65 4c 61 62 65 6c 28 29 20 66 75 6e 63 74  lveLabel() funct
0970: 69 6f 6e 20 74 6f 20 66 69 78 20 61 6e 20 61 64  ion to fix an ad
0980: 64 72 65 73 73 20 61 6e 64 0a 2a 2a 20 74 68 65  dress and.** the
0990: 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e   sqlite3VdbeChan
09a0: 67 65 50 33 28 29 20 66 75 6e 63 74 69 6f 6e 20  geP3() function 
09b0: 74 6f 20 63 68 61 6e 67 65 20 74 68 65 20 76 61  to change the va
09c0: 6c 75 65 20 6f 66 20 74 68 65 20 50 33 0a 2a 2a  lue of the P3.**
09d0: 20 6f 70 65 72 61 6e 64 2e 0a 2a 2f 0a 69 6e 74   operand..*/.int
09e0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
09f0: 70 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6f  p(Vdbe *p, int o
0a00: 70 2c 20 69 6e 74 20 70 31 2c 20 69 6e 74 20 70  p, int p1, int p
0a10: 32 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 56  2){.  int i;.  V
0a20: 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 0a 20 20 69  dbeOp *pOp;..  i
0a30: 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 70 2d 3e   = p->nOp;.  p->
0a40: 6e 4f 70 2b 2b 3b 0a 20 20 61 73 73 65 72 74 28  nOp++;.  assert(
0a50: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
0a60: 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20  MAGIC_INIT );.  
0a70: 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c  resizeOpArray(p,
0a80: 20 69 2b 31 29 3b 0a 20 20 69 66 28 20 70 2d 3e   i+1);.  if( p->
0a90: 61 4f 70 3d 3d 30 20 7c 7c 20 70 2d 3e 6e 4f 70  aOp==0 || p->nOp
0aa0: 3c 3d 69 20 29 7b 0a 20 20 20 20 72 65 74 75 72  <=i ){.    retur
0ab0: 6e 20 30 3b 0a 20 20 7d 0a 20 20 70 4f 70 20 3d  n 0;.  }.  pOp =
0ac0: 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20 20 70   &p->aOp[i];.  p
0ad0: 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d 20 6f 70 3b  Op->opcode = op;
0ae0: 0a 20 20 70 4f 70 2d 3e 70 31 20 3d 20 70 31 3b  .  pOp->p1 = p1;
0af0: 0a 20 20 70 4f 70 2d 3e 70 32 20 3d 20 70 32 3b  .  pOp->p2 = p2;
0b00: 0a 20 20 70 4f 70 2d 3e 70 33 20 3d 20 30 3b 0a  .  pOp->p3 = 0;.
0b10: 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d 20    pOp->p3type = 
0b20: 50 33 5f 4e 4f 54 55 53 45 44 3b 0a 20 20 70 2d  P3_NOTUSED;.  p-
0b30: 3e 65 78 70 69 72 65 64 20 3d 20 30 3b 0a 23 69  >expired = 0;.#i
0b40: 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55  fdef SQLITE_DEBU
0b50: 47 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f  G.  if( sqlite3_
0b60: 76 64 62 65 5f 61 64 64 6f 70 5f 74 72 61 63 65  vdbe_addop_trace
0b70: 20 29 20 73 71 6c 69 74 65 33 56 64 62 65 50 72   ) sqlite3VdbePr
0b80: 69 6e 74 4f 70 28 30 2c 20 69 2c 20 26 70 2d 3e  intOp(0, i, &p->
0b90: 61 4f 70 5b 69 5d 29 3b 0a 23 65 6e 64 69 66 0a  aOp[i]);.#endif.
0ba0: 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a 0a 2f    return i;.}../
0bb0: 2a 0a 2a 2a 20 41 64 64 20 61 6e 20 6f 70 63 6f  *.** Add an opco
0bc0: 64 65 20 74 68 61 74 20 69 6e 63 6c 75 64 65 73  de that includes
0bd0: 20 74 68 65 20 70 33 20 76 61 6c 75 65 2e 0a 2a   the p3 value..*
0be0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
0bf0: 65 4f 70 33 28 56 64 62 65 20 2a 70 2c 20 69 6e  eOp3(Vdbe *p, in
0c00: 74 20 6f 70 2c 20 69 6e 74 20 70 31 2c 20 69 6e  t op, int p1, in
0c10: 74 20 70 32 2c 20 63 6f 6e 73 74 20 63 68 61 72  t p2, const char
0c20: 20 2a 7a 50 33 2c 69 6e 74 20 70 33 74 79 70 65   *zP3,int p3type
0c30: 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 20 3d 20  ){.  int addr = 
0c40: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
0c50: 28 70 2c 20 6f 70 2c 20 70 31 2c 20 70 32 29 3b  (p, op, p1, p2);
0c60: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 43 68  .  sqlite3VdbeCh
0c70: 61 6e 67 65 50 33 28 70 2c 20 61 64 64 72 2c 20  angeP3(p, addr, 
0c80: 7a 50 33 2c 20 70 33 74 79 70 65 29 3b 0a 20 20  zP3, p3type);.  
0c90: 72 65 74 75 72 6e 20 61 64 64 72 3b 0a 7d 0a 0a  return addr;.}..
0ca0: 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 61 20 6e  /*.** Create a n
0cb0: 65 77 20 73 79 6d 62 6f 6c 69 63 20 6c 61 62 65  ew symbolic labe
0cc0: 6c 20 66 6f 72 20 61 6e 20 69 6e 73 74 72 75 63  l for an instruc
0cd0: 74 69 6f 6e 20 74 68 61 74 20 68 61 73 20 79 65  tion that has ye
0ce0: 74 20 74 6f 20 62 65 0a 2a 2a 20 63 6f 64 65 64  t to be.** coded
0cf0: 2e 20 20 54 68 65 20 73 79 6d 62 6f 6c 69 63 20  .  The symbolic 
0d00: 6c 61 62 65 6c 20 69 73 20 72 65 61 6c 6c 79 20  label is really 
0d10: 6a 75 73 74 20 61 20 6e 65 67 61 74 69 76 65 20  just a negative 
0d20: 6e 75 6d 62 65 72 2e 20 20 54 68 65 0a 2a 2a 20  number.  The.** 
0d30: 6c 61 62 65 6c 20 63 61 6e 20 62 65 20 75 73 65  label can be use
0d40: 64 20 61 73 20 74 68 65 20 50 32 20 76 61 6c 75  d as the P2 valu
0d50: 65 20 6f 66 20 61 6e 20 6f 70 65 72 61 74 69 6f  e of an operatio
0d60: 6e 2e 20 20 4c 61 74 65 72 2c 20 77 68 65 6e 0a  n.  Later, when.
0d70: 2a 2a 20 74 68 65 20 6c 61 62 65 6c 20 69 73 20  ** the label is 
0d80: 72 65 73 6f 6c 76 65 64 20 74 6f 20 61 20 73 70  resolved to a sp
0d90: 65 63 69 66 69 63 20 61 64 64 72 65 73 73 2c 20  ecific address, 
0da0: 74 68 65 20 56 44 42 45 20 77 69 6c 6c 20 73 63  the VDBE will sc
0db0: 61 6e 0a 2a 2a 20 74 68 72 6f 75 67 68 20 69 74  an.** through it
0dc0: 73 20 6f 70 65 72 61 74 69 6f 6e 20 6c 69 73 74  s operation list
0dd0: 20 61 6e 64 20 63 68 61 6e 67 65 20 61 6c 6c 20   and change all 
0de0: 76 61 6c 75 65 73 20 6f 66 20 50 32 20 77 68 69  values of P2 whi
0df0: 63 68 20 6d 61 74 63 68 0a 2a 2a 20 74 68 65 20  ch match.** the 
0e00: 6c 61 62 65 6c 20 69 6e 74 6f 20 74 68 65 20 72  label into the r
0e10: 65 73 6f 6c 76 65 64 20 61 64 64 72 65 73 73 2e  esolved address.
0e20: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 56 44 42 45 20  .**.** The VDBE 
0e30: 6b 6e 6f 77 73 20 74 68 61 74 20 61 20 50 32 20  knows that a P2 
0e40: 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62 65 6c  value is a label
0e50: 20 62 65 63 61 75 73 65 20 6c 61 62 65 6c 73 20   because labels 
0e60: 61 72 65 0a 2a 2a 20 61 6c 77 61 79 73 20 6e 65  are.** always ne
0e70: 67 61 74 69 76 65 20 61 6e 64 20 50 32 20 76 61  gative and P2 va
0e80: 6c 75 65 73 20 61 72 65 20 73 75 70 70 6f 73 65  lues are suppose
0e90: 20 74 6f 20 62 65 20 6e 6f 6e 2d 6e 65 67 61 74   to be non-negat
0ea0: 69 76 65 2e 0a 2a 2a 20 48 65 6e 63 65 2c 20 61  ive..** Hence, a
0eb0: 20 6e 65 67 61 74 69 76 65 20 50 32 20 76 61 6c   negative P2 val
0ec0: 75 65 20 69 73 20 61 20 6c 61 62 65 6c 20 74 68  ue is a label th
0ed0: 61 74 20 68 61 73 20 79 65 74 20 74 6f 20 62 65  at has yet to be
0ee0: 20 72 65 73 6f 6c 76 65 64 2e 0a 2a 2a 0a 2a 2a   resolved..**.**
0ef0: 20 5a 65 72 6f 20 69 73 20 72 65 74 75 72 6e 65   Zero is returne
0f00: 64 20 69 66 20 61 20 6d 61 6c 6c 6f 63 28 29 20  d if a malloc() 
0f10: 66 61 69 6c 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  fails..*/.int sq
0f20: 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62  lite3VdbeMakeLab
0f30: 65 6c 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69  el(Vdbe *p){.  i
0f40: 6e 74 20 69 3b 0a 20 20 69 20 3d 20 70 2d 3e 6e  nt i;.  i = p->n
0f50: 4c 61 62 65 6c 2b 2b 3b 0a 20 20 61 73 73 65 72  Label++;.  asser
0f60: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
0f70: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
0f80: 20 20 69 66 28 20 69 3e 3d 70 2d 3e 6e 4c 61 62    if( i>=p->nLab
0f90: 65 6c 41 6c 6c 6f 63 20 29 7b 0a 20 20 20 20 70  elAlloc ){.    p
0fa0: 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20 3d 20  ->nLabelAlloc = 
0fb0: 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 2a 32  p->nLabelAlloc*2
0fc0: 20 2b 20 31 30 3b 0a 20 20 20 20 73 71 6c 69 74   + 10;.    sqlit
0fd0: 65 52 65 61 6c 6c 6f 63 4f 72 46 72 65 65 28 28  eReallocOrFree((
0fe0: 76 6f 69 64 2a 2a 29 26 70 2d 3e 61 4c 61 62 65  void**)&p->aLabe
0ff0: 6c 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  l,.             
1000: 20 20 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e               p->
1010: 6e 4c 61 62 65 6c 41 6c 6c 6f 63 2a 73 69 7a 65  nLabelAlloc*size
1020: 6f 66 28 70 2d 3e 61 4c 61 62 65 6c 5b 30 5d 29  of(p->aLabel[0])
1030: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e  );.  }.  if( p->
1040: 61 4c 61 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d  aLabel ){.    p-
1050: 3e 61 4c 61 62 65 6c 5b 69 5d 20 3d 20 2d 31 3b  >aLabel[i] = -1;
1060: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 2d 31  .  }.  return -1
1070: 2d 69 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 73  -i;.}../*.** Res
1080: 6f 6c 76 65 20 6c 61 62 65 6c 20 22 78 22 20 74  olve label "x" t
1090: 6f 20 62 65 20 74 68 65 20 61 64 64 72 65 73 73  o be the address
10a0: 20 6f 66 20 74 68 65 20 6e 65 78 74 20 69 6e 73   of the next ins
10b0: 74 72 75 63 74 69 6f 6e 20 74 6f 0a 2a 2a 20 62  truction to.** b
10c0: 65 20 69 6e 73 65 72 74 65 64 2e 20 20 54 68 65  e inserted.  The
10d0: 20 70 61 72 61 6d 65 74 65 72 20 22 78 22 20 6d   parameter "x" m
10e0: 75 73 74 20 68 61 76 65 20 62 65 65 6e 20 6f 62  ust have been ob
10f0: 74 61 69 6e 65 64 20 66 72 6f 6d 0a 2a 2a 20 61  tained from.** a
1100: 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 20 73   prior call to s
1110: 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61  qlite3VdbeMakeLa
1120: 62 65 6c 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73  bel()..*/.void s
1130: 71 6c 69 74 65 33 56 64 62 65 52 65 73 6f 6c 76  qlite3VdbeResolv
1140: 65 4c 61 62 65 6c 28 56 64 62 65 20 2a 70 2c 20  eLabel(Vdbe *p, 
1150: 69 6e 74 20 78 29 7b 0a 20 20 69 6e 74 20 6a 20  int x){.  int j 
1160: 3d 20 2d 31 2d 78 3b 0a 20 20 61 73 73 65 72 74  = -1-x;.  assert
1170: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
1180: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
1190: 20 61 73 73 65 72 74 28 20 6a 3e 3d 30 20 26 26   assert( j>=0 &&
11a0: 20 6a 3c 70 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a   j<p->nLabel );.
11b0: 20 20 69 66 28 20 70 2d 3e 61 4c 61 62 65 6c 20    if( p->aLabel 
11c0: 29 7b 0a 20 20 20 20 70 2d 3e 61 4c 61 62 65 6c  ){.    p->aLabel
11d0: 5b 6a 5d 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20  [j] = p->nOp;.  
11e0: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  }.}../*.** Retur
11f0: 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 69 66 20 6f 70  n non-zero if op
1200: 63 6f 64 65 20 27 6f 70 27 20 69 73 20 67 75 61  code 'op' is gua
1210: 72 65 6e 74 65 65 64 20 6e 6f 74 20 74 6f 20 70  renteed not to p
1220: 75 73 68 20 6d 6f 72 65 20 76 61 6c 75 65 73 0a  ush more values.
1230: 2a 2a 20 6f 6e 74 6f 20 74 68 65 20 56 44 42 45  ** onto the VDBE
1240: 20 73 74 61 63 6b 20 74 68 61 6e 20 69 74 20 70   stack than it p
1250: 6f 70 73 20 6f 66 66 2e 0a 2a 2f 0a 73 74 61 74  ops off..*/.stat
1260: 69 63 20 69 6e 74 20 6f 70 63 6f 64 65 4e 6f 50  ic int opcodeNoP
1270: 75 73 68 28 75 38 20 6f 70 29 7b 0a 20 20 2f 2a  ush(u8 op){.  /*
1280: 20 54 68 65 20 31 30 20 4e 4f 50 55 53 48 5f 4d   The 10 NOPUSH_M
1290: 41 53 4b 5f 6e 20 63 6f 6e 73 74 61 6e 74 73 20  ASK_n constants 
12a0: 61 72 65 20 64 65 66 69 6e 65 64 20 69 6e 20 74  are defined in t
12b0: 68 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  he automatically
12c0: 0a 20 20 2a 2a 20 67 65 6e 65 72 61 74 65 64 20  .  ** generated 
12d0: 68 65 61 64 65 72 20 66 69 6c 65 20 6f 70 63 6f  header file opco
12e0: 64 65 73 2e 68 2e 20 45 61 63 68 20 69 73 20 61  des.h. Each is a
12f0: 20 31 36 2d 62 69 74 20 62 69 74 6d 61 73 6b 2c   16-bit bitmask,
1300: 20 6f 6e 65 0a 20 20 2a 2a 20 62 69 74 20 63 6f   one.  ** bit co
1310: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 65  rresponding to e
1320: 61 63 68 20 6f 70 63 6f 64 65 20 69 6d 70 6c 65  ach opcode imple
1330: 6d 65 6e 74 65 64 20 62 79 20 74 68 65 20 76 69  mented by the vi
1340: 72 74 75 61 6c 0a 20 20 2a 2a 20 6d 61 63 68 69  rtual.  ** machi
1350: 6e 65 20 69 6e 20 76 64 62 65 2e 63 2e 20 54 68  ne in vdbe.c. Th
1360: 65 20 62 69 74 20 69 73 20 74 72 75 65 20 69 66  e bit is true if
1370: 20 74 68 65 20 77 6f 72 64 20 22 6e 6f 2d 70 75   the word "no-pu
1380: 73 68 22 20 61 70 70 65 61 72 73 0a 20 20 2a 2a  sh" appears.  **
1390: 20 69 6e 20 61 20 63 6f 6d 6d 65 6e 74 20 6f 6e   in a comment on
13a0: 20 74 68 65 20 73 61 6d 65 20 6c 69 6e 65 20 61   the same line a
13b0: 73 20 74 68 65 20 22 63 61 73 65 20 4f 50 5f 58  s the "case OP_X
13c0: 58 58 3a 22 20 69 6e 20 0a 20 20 2a 2a 20 73 71  XX:" in .  ** sq
13d0: 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 29 20  lite3VdbeExec() 
13e0: 69 6e 20 76 64 62 65 2e 63 2e 0a 20 20 2a 2a 0a  in vdbe.c..  **.
13f0: 20 20 2a 2a 20 49 66 20 74 68 65 20 62 69 74 20    ** If the bit 
1400: 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68  is true, then th
1410: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
1420: 6f 70 63 6f 64 65 20 69 73 20 67 75 61 72 65 6e  opcode is guaren
1430: 74 65 65 64 20 6e 6f 74 0a 20 20 2a 2a 20 74 6f  teed not.  ** to
1440: 20 67 72 6f 77 20 74 68 65 20 73 74 61 63 6b 20   grow the stack 
1450: 77 68 65 6e 20 69 74 20 69 73 20 65 78 65 63 75  when it is execu
1460: 74 65 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20  ted. Otherwise, 
1470: 69 74 20 6d 61 79 20 67 72 6f 77 20 74 68 65 0a  it may grow the.
1480: 20 20 2a 2a 20 73 74 61 63 6b 20 62 79 20 61 74    ** stack by at
1490: 20 6d 6f 73 74 20 6f 6e 65 20 65 6e 74 72 79 2e   most one entry.
14a0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 4f 50 55 53  .  **.  ** NOPUS
14b0: 48 5f 4d 41 53 4b 5f 30 20 63 6f 72 72 65 73 70  H_MASK_0 corresp
14c0: 6f 6e 64 73 20 74 6f 20 6f 70 63 6f 64 65 73 20  onds to opcodes 
14d0: 30 20 74 6f 20 31 35 2e 20 4e 4f 50 55 53 48 5f  0 to 15. NOPUSH_
14e0: 4d 41 53 4b 5f 31 20 63 6f 6e 74 61 69 6e 73 0a  MASK_1 contains.
14f0: 20 20 2a 2a 20 6f 6e 65 20 62 69 74 20 66 6f 72    ** one bit for
1500: 20 6f 70 63 6f 64 65 73 20 31 36 20 74 6f 20 33   opcodes 16 to 3
1510: 31 2c 20 61 6e 64 20 73 6f 20 6f 6e 2e 0a 20 20  1, and so on..  
1520: 2a 2a 0a 20 20 2a 2a 20 31 36 2d 62 69 74 20 62  **.  ** 16-bit b
1530: 69 74 6d 61 73 6b 73 20 28 72 61 74 68 65 72 20  itmasks (rather 
1540: 74 68 61 6e 20 33 32 2d 62 69 74 29 20 61 72 65  than 32-bit) are
1550: 20 73 70 65 63 69 66 69 65 64 20 69 6e 20 6f 70   specified in op
1560: 63 6f 64 65 73 2e 68 20 0a 20 20 2a 2a 20 62 65  codes.h .  ** be
1570: 63 61 75 73 65 20 74 68 65 20 66 69 6c 65 20 69  cause the file i
1580: 73 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 61  s generated by a
1590: 6e 20 61 77 6b 20 70 72 6f 67 72 61 6d 2e 20 41  n awk program. A
15a0: 77 6b 20 6d 61 6e 69 70 75 6c 61 74 65 73 0a 20  wk manipulates. 
15b0: 20 2a 2a 20 61 6c 6c 20 6e 75 6d 62 65 72 73 20   ** all numbers 
15c0: 61 73 20 66 6c 6f 61 74 69 6e 67 2d 70 6f 69 6e  as floating-poin
15d0: 74 20 61 6e 64 20 77 65 20 64 6f 6e 27 74 20 77  t and we don't w
15e0: 61 6e 74 20 74 6f 20 72 69 73 6b 20 61 20 72 6f  ant to risk a ro
15f0: 75 6e 64 69 6e 67 0a 20 20 2a 2a 20 65 72 72 6f  unding.  ** erro
1600: 72 20 69 66 20 73 6f 6d 65 6f 6e 65 20 62 75 69  r if someone bui
1610: 6c 64 73 20 77 69 74 68 20 61 6e 20 61 77 6b 20  lds with an awk 
1620: 74 68 61 74 20 75 73 65 73 20 28 66 6f 72 20 65  that uses (for e
1630: 78 61 6d 70 6c 65 29 20 33 32 2d 62 69 74 20 0a  xample) 32-bit .
1640: 20 20 2a 2a 20 49 45 45 45 20 66 6c 6f 61 74 73    ** IEEE floats
1650: 2e 0a 20 20 2a 2f 20 0a 20 20 73 74 61 74 69 63  ..  */ .  static
1660: 20 63 6f 6e 73 74 20 75 33 32 20 6d 61 73 6b 73   const u32 masks
1670: 5b 35 5d 20 3d 20 7b 0a 20 20 20 20 4e 4f 50 55  [5] = {.    NOPU
1680: 53 48 5f 4d 41 53 4b 5f 30 20 2b 20 28 4e 4f 50  SH_MASK_0 + (NOP
1690: 55 53 48 5f 4d 41 53 4b 5f 31 3c 3c 31 36 29 2c  USH_MASK_1<<16),
16a0: 0a 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b  .    NOPUSH_MASK
16b0: 5f 32 20 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53  _2 + (NOPUSH_MAS
16c0: 4b 5f 33 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f  K_3<<16),.    NO
16d0: 50 55 53 48 5f 4d 41 53 4b 5f 34 20 2b 20 28 4e  PUSH_MASK_4 + (N
16e0: 4f 50 55 53 48 5f 4d 41 53 4b 5f 35 3c 3c 31 36  OPUSH_MASK_5<<16
16f0: 29 2c 0a 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41  ),.    NOPUSH_MA
1700: 53 4b 5f 36 20 2b 20 28 4e 4f 50 55 53 48 5f 4d  SK_6 + (NOPUSH_M
1710: 41 53 4b 5f 37 3c 3c 31 36 29 2c 0a 20 20 20 20  ASK_7<<16),.    
1720: 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 38 20 2b 20  NOPUSH_MASK_8 + 
1730: 28 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 39 3c 3c  (NOPUSH_MASK_9<<
1740: 31 36 29 0a 20 20 7d 3b 0a 20 20 61 73 73 65 72  16).  };.  asser
1750: 74 28 20 6f 70 3c 33 32 2a 35 20 29 3b 0a 20 20  t( op<32*5 );.  
1760: 72 65 74 75 72 6e 20 28 6d 61 73 6b 73 5b 6f 70  return (masks[op
1770: 3e 3e 35 5d 20 26 20 28 31 3c 3c 28 6f 70 26 30  >>5] & (1<<(op&0
1780: 78 31 46 29 29 29 3b 0a 7d 0a 0a 23 69 66 6e 64  x1F)));.}..#ifnd
1790: 65 66 20 4e 44 45 42 55 47 0a 69 6e 74 20 73 71  ef NDEBUG.int sq
17a0: 6c 69 74 65 33 56 64 62 65 4f 70 63 6f 64 65 4e  lite3VdbeOpcodeN
17b0: 6f 50 75 73 68 28 75 38 20 6f 70 29 7b 0a 20 20  oPush(u8 op){.  
17c0: 72 65 74 75 72 6e 20 6f 70 63 6f 64 65 4e 6f 50  return opcodeNoP
17d0: 75 73 68 28 6f 70 29 3b 0a 7d 0a 23 65 6e 64 69  ush(op);.}.#endi
17e0: 66 0a 0a 2f 2a 0a 2a 2a 20 4c 6f 6f 70 20 74 68  f../*.** Loop th
17f0: 72 6f 75 67 68 20 74 68 65 20 70 72 6f 67 72 61  rough the progra
1800: 6d 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 50 32  m looking for P2
1810: 20 76 61 6c 75 65 73 20 74 68 61 74 20 61 72 65   values that are
1820: 20 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 45 61   negative..** Ea
1830: 63 68 20 73 75 63 68 20 76 61 6c 75 65 20 69 73  ch such value is
1840: 20 61 20 6c 61 62 65 6c 2e 20 20 52 65 73 6f 6c   a label.  Resol
1850: 76 65 20 74 68 65 20 6c 61 62 65 6c 20 62 79 20  ve the label by 
1860: 73 65 74 74 69 6e 67 20 74 68 65 20 50 32 0a 2a  setting the P2.*
1870: 2a 20 76 61 6c 75 65 20 74 6f 20 69 74 73 20 63  * value to its c
1880: 6f 72 72 65 63 74 20 6e 6f 6e 2d 7a 65 72 6f 20  orrect non-zero 
1890: 76 61 6c 75 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  value..**.** Thi
18a0: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 63 61 6c  s routine is cal
18b0: 6c 65 64 20 6f 6e 63 65 20 61 66 74 65 72 20 61  led once after a
18c0: 6c 6c 20 6f 70 63 6f 64 65 73 20 68 61 76 65 20  ll opcodes have 
18d0: 62 65 65 6e 20 69 6e 73 65 72 74 65 64 2e 0a 2a  been inserted..*
18e0: 2a 0a 2a 2a 20 56 61 72 69 61 62 6c 65 20 2a 70  *.** Variable *p
18f0: 4d 61 78 46 75 6e 63 41 72 67 73 20 69 73 20 73  MaxFuncArgs is s
1900: 65 74 20 74 6f 20 74 68 65 20 6d 61 78 69 6d 75  et to the maximu
1910: 6d 20 76 61 6c 75 65 20 6f 66 20 61 6e 79 20 50  m value of any P
1920: 32 20 61 72 67 75 6d 65 6e 74 20 0a 2a 2a 20 74  2 argument .** t
1930: 6f 20 61 6e 20 4f 50 5f 46 75 6e 63 74 69 6f 6e  o an OP_Function
1940: 20 6f 72 20 4f 50 5f 41 67 67 53 74 65 70 20 6f   or OP_AggStep o
1950: 70 63 6f 64 65 2e 20 54 68 69 73 20 69 73 20 75  pcode. This is u
1960: 73 65 64 20 62 79 20 0a 2a 2a 20 73 71 6c 69 74  sed by .** sqlit
1970: 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64 79 28  e3VdbeMakeReady(
1980: 29 20 74 6f 20 73 69 7a 65 20 74 68 65 20 56 64  ) to size the Vd
1990: 62 65 2e 61 70 41 72 67 5b 5d 20 61 72 72 61 79  be.apArg[] array
19a0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 6e 74 65  ..**.** The inte
19b0: 67 65 72 20 2a 70 4d 61 78 53 74 61 63 6b 20 69  ger *pMaxStack i
19c0: 73 20 73 65 74 20 74 6f 20 74 68 65 20 6d 61 78  s set to the max
19d0: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 76  imum number of v
19e0: 64 62 65 20 73 74 61 63 6b 0a 2a 2a 20 65 6e 74  dbe stack.** ent
19f0: 72 69 65 73 20 74 68 61 74 20 73 74 61 74 69 63  ries that static
1a00: 20 61 6e 61 6c 79 73 69 73 20 72 65 76 65 61 6c   analysis reveal
1a10: 73 20 74 68 69 73 20 70 72 6f 67 72 61 6d 20 6d  s this program m
1a20: 69 67 68 74 20 6e 65 65 64 2e 0a 2a 2a 0a 2a 2a  ight need..**.**
1a30: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 61 6c   This routine al
1a40: 73 6f 20 64 6f 65 73 20 74 68 65 20 66 6f 6c 6c  so does the foll
1a50: 6f 77 69 6e 67 20 6f 70 74 69 6d 69 7a 61 74 69  owing optimizati
1a60: 6f 6e 3a 20 20 49 74 20 73 63 61 6e 73 20 66 6f  on:  It scans fo
1a70: 72 0a 2a 2a 20 48 61 6c 74 20 69 6e 73 74 72 75  r.** Halt instru
1a80: 63 74 69 6f 6e 73 20 77 68 65 72 65 20 50 31 3d  ctions where P1=
1a90: 3d 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49  =SQLITE_CONSTRAI
1aa0: 4e 54 20 6f 72 20 50 32 3d 3d 4f 45 5f 41 62 6f  NT or P2==OE_Abo
1ab0: 72 74 20 6f 72 20 66 6f 72 0a 2a 2a 20 49 64 78  rt or for.** Idx
1ac0: 49 6e 73 65 72 74 20 69 6e 73 74 72 75 63 74 69  Insert instructi
1ad0: 6f 6e 73 20 77 68 65 72 65 20 50 32 21 3d 30 2e  ons where P2!=0.
1ae0: 20 20 49 66 20 6e 6f 20 73 75 63 68 20 69 6e 73    If no such ins
1af0: 74 72 75 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 66  truction is.** f
1b00: 6f 75 6e 64 2c 20 74 68 65 6e 20 65 76 65 72 79  ound, then every
1b10: 20 53 74 61 74 65 6d 65 6e 74 20 69 6e 73 74 72   Statement instr
1b20: 75 63 74 69 6f 6e 20 69 73 20 63 68 61 6e 67 65  uction is change
1b30: 64 20 74 6f 20 61 20 4e 6f 6f 70 2e 20 20 49 6e  d to a Noop.  In
1b40: 0a 2a 2a 20 74 68 69 73 20 77 61 79 2c 20 77 65  .** this way, we
1b50: 20 61 76 6f 69 64 20 63 72 65 61 74 69 6e 67 20   avoid creating 
1b60: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 6a 6f  the statement jo
1b70: 75 72 6e 61 6c 20 66 69 6c 65 20 75 6e 6e 65 63  urnal file unnec
1b80: 65 73 73 61 72 69 6c 79 2e 0a 2a 2f 0a 73 74 61  essarily..*/.sta
1b90: 74 69 63 20 76 6f 69 64 20 72 65 73 6f 6c 76 65  tic void resolve
1ba0: 50 32 56 61 6c 75 65 73 28 56 64 62 65 20 2a 70  P2Values(Vdbe *p
1bb0: 2c 20 69 6e 74 20 2a 70 4d 61 78 46 75 6e 63 41  , int *pMaxFuncA
1bc0: 72 67 73 2c 20 69 6e 74 20 2a 70 4d 61 78 53 74  rgs, int *pMaxSt
1bd0: 61 63 6b 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20  ack){.  int i;. 
1be0: 20 69 6e 74 20 6e 4d 61 78 41 72 67 73 20 3d 20   int nMaxArgs = 
1bf0: 30 3b 0a 20 20 69 6e 74 20 6e 4d 61 78 53 74 61  0;.  int nMaxSta
1c00: 63 6b 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20 4f  ck = p->nOp;.  O
1c10: 70 20 2a 70 4f 70 3b 0a 20 20 69 6e 74 20 2a 61  p *pOp;.  int *a
1c20: 4c 61 62 65 6c 20 3d 20 70 2d 3e 61 4c 61 62 65  Label = p->aLabe
1c30: 6c 3b 0a 20 20 69 6e 74 20 64 6f 65 73 53 74 61  l;.  int doesSta
1c40: 74 65 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20 3d  tementRollback =
1c50: 20 30 3b 0a 20 20 69 6e 74 20 68 61 73 53 74 61   0;.  int hasSta
1c60: 74 65 6d 65 6e 74 42 65 67 69 6e 20 3d 20 30 3b  tementBegin = 0;
1c70: 0a 20 20 66 6f 72 28 70 4f 70 3d 70 2d 3e 61 4f  .  for(pOp=p->aO
1c80: 70 2c 20 69 3d 70 2d 3e 6e 4f 70 2d 31 3b 20 69  p, i=p->nOp-1; i
1c90: 3e 3d 30 3b 20 69 2d 2d 2c 20 70 4f 70 2b 2b 29  >=0; i--, pOp++)
1ca0: 7b 0a 20 20 20 20 75 38 20 6f 70 63 6f 64 65 20  {.    u8 opcode 
1cb0: 3d 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3b 0a 0a  = pOp->opcode;..
1cc0: 20 20 20 20 69 66 28 20 6f 70 63 6f 64 65 3d 3d      if( opcode==
1cd0: 4f 50 5f 46 75 6e 63 74 69 6f 6e 20 7c 7c 20 6f  OP_Function || o
1ce0: 70 63 6f 64 65 3d 3d 4f 50 5f 41 67 67 53 74 65  pcode==OP_AggSte
1cf0: 70 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  p ){.      if( p
1d00: 4f 70 2d 3e 70 32 3e 6e 4d 61 78 41 72 67 73 20  Op->p2>nMaxArgs 
1d10: 29 20 6e 4d 61 78 41 72 67 73 20 3d 20 70 4f 70  ) nMaxArgs = pOp
1d20: 2d 3e 70 32 3b 0a 20 20 20 20 7d 65 6c 73 65 20  ->p2;.    }else 
1d30: 69 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 48  if( opcode==OP_H
1d40: 61 6c 74 20 29 7b 0a 20 20 20 20 20 20 69 66 28  alt ){.      if(
1d50: 20 70 4f 70 2d 3e 70 31 3d 3d 53 51 4c 49 54 45   pOp->p1==SQLITE
1d60: 5f 43 4f 4e 53 54 52 41 49 4e 54 20 26 26 20 70  _CONSTRAINT && p
1d70: 4f 70 2d 3e 70 32 3d 3d 4f 45 5f 41 62 6f 72 74  Op->p2==OE_Abort
1d80: 20 29 7b 0a 20 20 20 20 20 20 20 20 64 6f 65 73   ){.        does
1d90: 53 74 61 74 65 6d 65 6e 74 52 6f 6c 6c 62 61 63  StatementRollbac
1da0: 6b 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a 20  k = 1;.      }. 
1db0: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 6f 70 63     }else if( opc
1dc0: 6f 64 65 3d 3d 4f 50 5f 49 64 78 49 6e 73 65 72  ode==OP_IdxInser
1dd0: 74 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70  t ){.      if( p
1de0: 4f 70 2d 3e 70 32 20 29 7b 0a 20 20 20 20 20 20  Op->p2 ){.      
1df0: 20 20 64 6f 65 73 53 74 61 74 65 6d 65 6e 74 52    doesStatementR
1e00: 6f 6c 6c 62 61 63 6b 20 3d 20 31 3b 0a 20 20 20  ollback = 1;.   
1e10: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69     }.    }else i
1e20: 66 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 53 74  f( opcode==OP_St
1e30: 61 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20 20 20  atement ){.     
1e40: 20 68 61 73 53 74 61 74 65 6d 65 6e 74 42 65 67   hasStatementBeg
1e50: 69 6e 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 0a 20  in = 1;.    }.. 
1e60: 20 20 20 69 66 28 20 6f 70 63 6f 64 65 4e 6f 50     if( opcodeNoP
1e70: 75 73 68 28 6f 70 63 6f 64 65 29 20 29 7b 0a 20  ush(opcode) ){. 
1e80: 20 20 20 20 20 6e 4d 61 78 53 74 61 63 6b 2d 2d       nMaxStack--
1e90: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28  ;.    }..    if(
1ea0: 20 70 4f 70 2d 3e 70 32 3e 3d 30 20 29 20 63 6f   pOp->p2>=0 ) co
1eb0: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61 73 73 65  ntinue;.    asse
1ec0: 72 74 28 20 2d 31 2d 70 4f 70 2d 3e 70 32 3c 70  rt( -1-pOp->p2<p
1ed0: 2d 3e 6e 4c 61 62 65 6c 20 29 3b 0a 20 20 20 20  ->nLabel );.    
1ee0: 70 4f 70 2d 3e 70 32 20 3d 20 61 4c 61 62 65 6c  pOp->p2 = aLabel
1ef0: 5b 2d 31 2d 70 4f 70 2d 3e 70 32 5d 3b 0a 20 20  [-1-pOp->p2];.  
1f00: 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28 70  }.  sqliteFree(p
1f10: 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 70 2d 3e  ->aLabel);.  p->
1f20: 61 4c 61 62 65 6c 20 3d 20 30 3b 0a 0a 20 20 2a  aLabel = 0;..  *
1f30: 70 4d 61 78 46 75 6e 63 41 72 67 73 20 3d 20 6e  pMaxFuncArgs = n
1f40: 4d 61 78 41 72 67 73 3b 0a 20 20 2a 70 4d 61 78  MaxArgs;.  *pMax
1f50: 53 74 61 63 6b 20 3d 20 6e 4d 61 78 53 74 61 63  Stack = nMaxStac
1f60: 6b 3b 0a 0a 20 20 2f 2a 20 49 66 20 77 65 20 6e  k;..  /* If we n
1f70: 65 76 65 72 20 72 6f 6c 6c 62 61 63 6b 20 61 20  ever rollback a 
1f80: 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73 61  statement transa
1f90: 63 74 69 6f 6e 2c 20 74 68 65 6e 20 73 74 61 74  ction, then stat
1fa0: 65 6d 65 6e 74 0a 20 20 2a 2a 20 74 72 61 6e 73  ement.  ** trans
1fb0: 61 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20  actions are not 
1fc0: 6e 65 65 64 65 64 2e 20 20 53 6f 20 63 68 61 6e  needed.  So chan
1fd0: 67 65 20 65 76 65 72 79 20 4f 50 5f 53 74 61 74  ge every OP_Stat
1fe0: 65 6d 65 6e 74 0a 20 20 2a 2a 20 6f 70 63 6f 64  ement.  ** opcod
1ff0: 65 20 69 6e 74 6f 20 61 6e 20 4f 50 5f 4e 6f 6f  e into an OP_Noo
2000: 70 2e 20 20 54 68 69 73 20 61 76 6f 69 64 20 61  p.  This avoid a
2010: 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33   call to sqlite3
2020: 4f 73 4f 70 65 6e 45 78 63 6c 75 73 69 76 65 28  OsOpenExclusive(
2030: 29 0a 20 20 2a 2a 20 77 68 69 63 68 20 63 61 6e  ).  ** which can
2040: 20 62 65 20 65 78 70 65 6e 73 69 76 65 20 6f 6e   be expensive on
2050: 20 73 6f 6d 65 20 70 6c 61 74 66 6f 72 6d 73 2e   some platforms.
2060: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 68 61 73 53  .  */.  if( hasS
2070: 74 61 74 65 6d 65 6e 74 42 65 67 69 6e 20 26 26  tatementBegin &&
2080: 20 21 64 6f 65 73 53 74 61 74 65 6d 65 6e 74 52   !doesStatementR
2090: 6f 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 66  ollback ){.    f
20a0: 6f 72 28 70 4f 70 3d 70 2d 3e 61 4f 70 2c 20 69  or(pOp=p->aOp, i
20b0: 3d 70 2d 3e 6e 4f 70 2d 31 3b 20 69 3e 3d 30 3b  =p->nOp-1; i>=0;
20c0: 20 69 2d 2d 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20   i--, pOp++){.  
20d0: 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63      if( pOp->opc
20e0: 6f 64 65 3d 3d 4f 50 5f 53 74 61 74 65 6d 65 6e  ode==OP_Statemen
20f0: 74 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4f 70  t ){.        pOp
2100: 2d 3e 6f 70 63 6f 64 65 20 3d 20 4f 50 5f 4e 6f  ->opcode = OP_No
2110: 6f 70 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  op;.      }.    
2120: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  }.  }.}../*.** R
2130: 65 74 75 72 6e 20 74 68 65 20 61 64 64 72 65 73  eturn the addres
2140: 73 20 6f 66 20 74 68 65 20 6e 65 78 74 20 69 6e  s of the next in
2150: 73 74 72 75 63 74 69 6f 6e 20 74 6f 20 62 65 20  struction to be 
2160: 69 6e 73 65 72 74 65 64 2e 0a 2a 2f 0a 69 6e 74  inserted..*/.int
2170: 20 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 72   sqlite3VdbeCurr
2180: 65 6e 74 41 64 64 72 28 56 64 62 65 20 2a 70 29  entAddr(Vdbe *p)
2190: 7b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d  {.  assert( p->m
21a0: 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43  agic==VDBE_MAGIC
21b0: 5f 49 4e 49 54 20 29 3b 0a 20 20 72 65 74 75 72  _INIT );.  retur
21c0: 6e 20 70 2d 3e 6e 4f 70 3b 0a 7d 0a 0a 2f 2a 0a  n p->nOp;.}../*.
21d0: 2a 2a 20 41 64 64 20 61 20 77 68 6f 6c 65 20 6c  ** Add a whole l
21e0: 69 73 74 20 6f 66 20 6f 70 65 72 61 74 69 6f 6e  ist of operation
21f0: 73 20 74 6f 20 74 68 65 20 6f 70 65 72 61 74 69  s to the operati
2200: 6f 6e 20 73 74 61 63 6b 2e 20 20 52 65 74 75 72  on stack.  Retur
2210: 6e 20 74 68 65 0a 2a 2a 20 61 64 64 72 65 73 73  n the.** address
2220: 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6f 70   of the first op
2230: 65 72 61 74 69 6f 6e 20 61 64 64 65 64 2e 0a 2a  eration added..*
2240: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
2250: 65 41 64 64 4f 70 4c 69 73 74 28 56 64 62 65 20  eAddOpList(Vdbe 
2260: 2a 70 2c 20 69 6e 74 20 6e 4f 70 2c 20 56 64 62  *p, int nOp, Vdb
2270: 65 4f 70 4c 69 73 74 20 63 6f 6e 73 74 20 2a 61  eOpList const *a
2280: 4f 70 29 7b 0a 20 20 69 6e 74 20 61 64 64 72 3b  Op){.  int addr;
2290: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61  .  assert( p->ma
22a0: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
22b0: 49 4e 49 54 20 29 3b 0a 20 20 72 65 73 69 7a 65  INIT );.  resize
22c0: 4f 70 41 72 72 61 79 28 70 2c 20 70 2d 3e 6e 4f  OpArray(p, p->nO
22d0: 70 20 2b 20 6e 4f 70 29 3b 0a 20 20 69 66 28 20  p + nOp);.  if( 
22e0: 73 71 6c 69 74 65 33 54 68 72 65 61 64 44 61 74  sqlite3ThreadDat
22f0: 61 52 65 61 64 4f 6e 6c 79 28 29 2d 3e 6d 61 6c  aReadOnly()->mal
2300: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
2310: 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20   return 0;.  }. 
2320: 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 3b 0a   addr = p->nOp;.
2330: 20 20 69 66 28 20 6e 4f 70 3e 30 20 29 7b 0a 20    if( nOp>0 ){. 
2340: 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 56 64     int i;.    Vd
2350: 62 65 4f 70 4c 69 73 74 20 63 6f 6e 73 74 20 2a  beOpList const *
2360: 70 49 6e 20 3d 20 61 4f 70 3b 0a 20 20 20 20 66  pIn = aOp;.    f
2370: 6f 72 28 69 3d 30 3b 20 69 3c 6e 4f 70 3b 20 69  or(i=0; i<nOp; i
2380: 2b 2b 2c 20 70 49 6e 2b 2b 29 7b 0a 20 20 20 20  ++, pIn++){.    
2390: 20 20 69 6e 74 20 70 32 20 3d 20 70 49 6e 2d 3e    int p2 = pIn->
23a0: 70 32 3b 0a 20 20 20 20 20 20 56 64 62 65 4f 70  p2;.      VdbeOp
23b0: 20 2a 70 4f 75 74 20 3d 20 26 70 2d 3e 61 4f 70   *pOut = &p->aOp
23c0: 5b 69 2b 61 64 64 72 5d 3b 0a 20 20 20 20 20 20  [i+addr];.      
23d0: 70 4f 75 74 2d 3e 6f 70 63 6f 64 65 20 3d 20 70  pOut->opcode = p
23e0: 49 6e 2d 3e 6f 70 63 6f 64 65 3b 0a 20 20 20 20  In->opcode;.    
23f0: 20 20 70 4f 75 74 2d 3e 70 31 20 3d 20 70 49 6e    pOut->p1 = pIn
2400: 2d 3e 70 31 3b 0a 20 20 20 20 20 20 70 4f 75 74  ->p1;.      pOut
2410: 2d 3e 70 32 20 3d 20 70 32 3c 30 20 3f 20 61 64  ->p2 = p2<0 ? ad
2420: 64 72 20 2b 20 41 44 44 52 28 70 32 29 20 3a 20  dr + ADDR(p2) : 
2430: 70 32 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d 3e  p2;.      pOut->
2440: 70 33 20 3d 20 70 49 6e 2d 3e 70 33 3b 0a 20 20  p3 = pIn->p3;.  
2450: 20 20 20 20 70 4f 75 74 2d 3e 70 33 74 79 70 65      pOut->p3type
2460: 20 3d 20 70 49 6e 2d 3e 70 33 20 3f 20 50 33 5f   = pIn->p3 ? P3_
2470: 53 54 41 54 49 43 20 3a 20 50 33 5f 4e 4f 54 55  STATIC : P3_NOTU
2480: 53 45 44 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  SED;.#ifdef SQLI
2490: 54 45 5f 44 45 42 55 47 0a 20 20 20 20 20 20 69  TE_DEBUG.      i
24a0: 66 28 20 73 71 6c 69 74 65 33 5f 76 64 62 65 5f  f( sqlite3_vdbe_
24b0: 61 64 64 6f 70 5f 74 72 61 63 65 20 29 7b 0a 20  addop_trace ){. 
24c0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64         sqlite3Vd
24d0: 62 65 50 72 69 6e 74 4f 70 28 30 2c 20 69 2b 61  bePrintOp(0, i+a
24e0: 64 64 72 2c 20 26 70 2d 3e 61 4f 70 5b 69 2b 61  ddr, &p->aOp[i+a
24f0: 64 64 72 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 23  ddr]);.      }.#
2500: 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20 20  endif.    }.    
2510: 70 2d 3e 6e 4f 70 20 2b 3d 20 6e 4f 70 3b 0a 20  p->nOp += nOp;. 
2520: 20 7d 0a 20 20 72 65 74 75 72 6e 20 61 64 64 72   }.  return addr
2530: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67  ;.}../*.** Chang
2540: 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74  e the value of t
2550: 68 65 20 50 31 20 6f 70 65 72 61 6e 64 20 66 6f  he P1 operand fo
2560: 72 20 61 20 73 70 65 63 69 66 69 63 20 69 6e 73  r a specific ins
2570: 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69  truction..** Thi
2580: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65  s routine is use
2590: 66 75 6c 20 77 68 65 6e 20 61 20 6c 61 72 67 65  ful when a large
25a0: 20 70 72 6f 67 72 61 6d 20 69 73 20 6c 6f 61 64   program is load
25b0: 65 64 20 66 72 6f 6d 20 61 0a 2a 2a 20 73 74 61  ed from a.** sta
25c0: 74 69 63 20 61 72 72 61 79 20 75 73 69 6e 67 20  tic array using 
25d0: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
25e0: 4c 69 73 74 20 62 75 74 20 77 65 20 77 61 6e 74  List but we want
25f0: 20 74 6f 20 6d 61 6b 65 20 61 0a 2a 2a 20 66 65   to make a.** fe
2600: 77 20 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73 20  w minor changes 
2610: 74 6f 20 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a  to the program..
2620: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
2630: 64 62 65 43 68 61 6e 67 65 50 31 28 56 64 62 65  dbeChangeP1(Vdbe
2640: 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 69   *p, int addr, i
2650: 6e 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65 72  nt val){.  asser
2660: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
2670: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
2680: 20 20 69 66 28 20 70 20 26 26 20 61 64 64 72 3e    if( p && addr>
2690: 3d 30 20 26 26 20 70 2d 3e 6e 4f 70 3e 61 64 64  =0 && p->nOp>add
26a0: 72 20 26 26 20 70 2d 3e 61 4f 70 20 29 7b 0a 20  r && p->aOp ){. 
26b0: 20 20 20 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 2e     p->aOp[addr].
26c0: 70 31 20 3d 20 76 61 6c 3b 0a 20 20 7d 0a 7d 0a  p1 = val;.  }.}.
26d0: 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74 68  ./*.** Change th
26e0: 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20 50  e value of the P
26f0: 32 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61 20  2 operand for a 
2700: 73 70 65 63 69 66 69 63 20 69 6e 73 74 72 75 63  specific instruc
2710: 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72 6f  tion..** This ro
2720: 75 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c 20  utine is useful 
2730: 66 6f 72 20 73 65 74 74 69 6e 67 20 61 20 6a 75  for setting a ju
2740: 6d 70 20 64 65 73 74 69 6e 61 74 69 6f 6e 2e 0a  mp destination..
2750: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
2760: 64 62 65 43 68 61 6e 67 65 50 32 28 56 64 62 65  dbeChangeP2(Vdbe
2770: 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20 69   *p, int addr, i
2780: 6e 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65 72  nt val){.  asser
2790: 74 28 20 76 61 6c 3e 3d 30 20 29 3b 0a 20 20 61  t( val>=0 );.  a
27a0: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
27b0: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
27c0: 20 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20 61   );.  if( p && a
27d0: 64 64 72 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f 70  ddr>=0 && p->nOp
27e0: 3e 61 64 64 72 20 26 26 20 70 2d 3e 61 4f 70 20  >addr && p->aOp 
27f0: 29 7b 0a 20 20 20 20 70 2d 3e 61 4f 70 5b 61 64  ){.    p->aOp[ad
2800: 64 72 5d 2e 70 32 20 3d 20 76 61 6c 3b 0a 20 20  dr].p2 = val;.  
2810: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67  }.}../*.** Chang
2820: 65 20 74 65 68 20 50 32 20 6f 70 65 72 61 6e 64  e teh P2 operand
2830: 20 6f 66 20 69 6e 73 74 72 75 63 74 69 6f 6e 20   of instruction 
2840: 61 64 64 72 20 73 6f 20 74 68 61 74 20 69 74 20  addr so that it 
2850: 70 6f 69 6e 74 73 20 74 6f 0a 2a 2a 20 74 68 65  points to.** the
2860: 20 61 64 64 72 65 73 73 20 6f 66 20 74 68 65 20   address of the 
2870: 6e 65 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e  next instruction
2880: 20 74 6f 20 62 65 20 63 6f 64 65 64 2e 0a 2a 2f   to be coded..*/
2890: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
28a0: 65 4a 75 6d 70 48 65 72 65 28 56 64 62 65 20 2a  eJumpHere(Vdbe *
28b0: 70 2c 20 69 6e 74 20 61 64 64 72 29 7b 0a 20 20  p, int addr){.  
28c0: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
28d0: 65 50 32 28 70 2c 20 61 64 64 72 2c 20 70 2d 3e  eP2(p, addr, p->
28e0: 6e 4f 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44  nOp);.}../*.** D
28f0: 65 6c 65 74 65 20 61 20 50 33 20 76 61 6c 75 65  elete a P3 value
2900: 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 0a 2a   if necessary..*
2910: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 72  /.static void fr
2920: 65 65 50 33 28 69 6e 74 20 70 33 74 79 70 65 2c  eeP3(int p3type,
2930: 20 76 6f 69 64 20 2a 70 33 29 7b 0a 20 20 69 66   void *p3){.  if
2940: 28 20 70 33 20 29 7b 0a 20 20 20 20 73 77 69 74  ( p3 ){.    swit
2950: 63 68 28 20 70 33 74 79 70 65 20 29 7b 0a 20 20  ch( p3type ){.  
2960: 20 20 20 20 63 61 73 65 20 50 33 5f 44 59 4e 41      case P3_DYNA
2970: 4d 49 43 3a 0a 20 20 20 20 20 20 63 61 73 65 20  MIC:.      case 
2980: 50 33 5f 4b 45 59 49 4e 46 4f 3a 0a 20 20 20 20  P3_KEYINFO:.    
2990: 20 20 63 61 73 65 20 50 33 5f 4b 45 59 49 4e 46    case P3_KEYINF
29a0: 4f 5f 48 41 4e 44 4f 46 46 3a 20 7b 0a 20 20 20  O_HANDOFF: {.   
29b0: 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28       sqliteFree(
29c0: 70 33 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65  p3);.        bre
29d0: 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ak;.      }.    
29e0: 20 20 63 61 73 65 20 50 33 5f 56 44 42 45 46 55    case P3_VDBEFU
29f0: 4e 43 3a 20 7b 0a 20 20 20 20 20 20 20 20 56 64  NC: {.        Vd
2a00: 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75 6e  beFunc *pVdbeFun
2a10: 63 20 3d 20 28 56 64 62 65 46 75 6e 63 20 2a 29  c = (VdbeFunc *)
2a20: 70 33 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  p3;.        sqli
2a30: 74 65 33 56 64 62 65 44 65 6c 65 74 65 41 75 78  te3VdbeDeleteAux
2a40: 44 61 74 61 28 70 56 64 62 65 46 75 6e 63 2c 20  Data(pVdbeFunc, 
2a50: 30 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  0);.        sqli
2a60: 74 65 46 72 65 65 28 70 56 64 62 65 46 75 6e 63  teFree(pVdbeFunc
2a70: 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  );.        break
2a80: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
2a90: 63 61 73 65 20 50 33 5f 4d 45 4d 3a 20 7b 0a 20  case P3_MEM: {. 
2aa0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 61         sqlite3Va
2ab0: 6c 75 65 46 72 65 65 28 28 73 71 6c 69 74 65 33  lueFree((sqlite3
2ac0: 5f 76 61 6c 75 65 2a 29 70 33 29 3b 0a 20 20 20  _value*)p3);.   
2ad0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20       break;.    
2ae0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a    }.    }.  }.}.
2af0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74  ../*.** Change t
2b00: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20  he value of the 
2b10: 50 33 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61  P3 operand for a
2b20: 20 73 70 65 63 69 66 69 63 20 69 6e 73 74 72 75   specific instru
2b30: 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72  ction..** This r
2b40: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c  outine is useful
2b50: 20 77 68 65 6e 20 61 20 6c 61 72 67 65 20 70 72   when a large pr
2b60: 6f 67 72 61 6d 20 69 73 20 6c 6f 61 64 65 64 20  ogram is loaded 
2b70: 66 72 6f 6d 20 61 0a 2a 2a 20 73 74 61 74 69 63  from a.** static
2b80: 20 61 72 72 61 79 20 75 73 69 6e 67 20 73 71 6c   array using sql
2b90: 69 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73  ite3VdbeAddOpLis
2ba0: 74 20 62 75 74 20 77 65 20 77 61 6e 74 20 74 6f  t but we want to
2bb0: 20 6d 61 6b 65 20 61 0a 2a 2a 20 66 65 77 20 6d   make a.** few m
2bc0: 69 6e 6f 72 20 63 68 61 6e 67 65 73 20 74 6f 20  inor changes to 
2bd0: 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2a 0a  the program..**.
2be0: 2a 2a 20 49 66 20 6e 3e 3d 30 20 74 68 65 6e 20  ** If n>=0 then 
2bf0: 74 68 65 20 50 33 20 6f 70 65 72 61 6e 64 20 69  the P3 operand i
2c00: 73 20 64 79 6e 61 6d 69 63 2c 20 6d 65 61 6e 69  s dynamic, meani
2c10: 6e 67 20 74 68 61 74 20 61 20 63 6f 70 79 20 6f  ng that a copy o
2c20: 66 0a 2a 2a 20 74 68 65 20 73 74 72 69 6e 67 20  f.** the string 
2c30: 69 73 20 6d 61 64 65 20 69 6e 74 6f 20 6d 65 6d  is made into mem
2c40: 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f  ory obtained fro
2c50: 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 29  m sqliteMalloc()
2c60: 2e 0a 2a 2a 20 41 20 76 61 6c 75 65 20 6f 66 20  ..** A value of 
2c70: 6e 3d 3d 30 20 6d 65 61 6e 73 20 63 6f 70 79 20  n==0 means copy 
2c80: 62 79 74 65 73 20 6f 66 20 7a 50 33 20 75 70 20  bytes of zP3 up 
2c90: 74 6f 20 61 6e 64 20 69 6e 63 6c 75 64 69 6e 67  to and including
2ca0: 20 74 68 65 0a 2a 2a 20 66 69 72 73 74 20 6e 75   the.** first nu
2cb0: 6c 6c 20 62 79 74 65 2e 20 20 49 66 20 6e 3e 30  ll byte.  If n>0
2cc0: 20 74 68 65 6e 20 63 6f 70 79 20 6e 2b 31 20 62   then copy n+1 b
2cd0: 79 74 65 73 20 6f 66 20 7a 50 33 2e 0a 2a 2a 0a  ytes of zP3..**.
2ce0: 2a 2a 20 49 66 20 6e 3d 3d 50 33 5f 4b 45 59 49  ** If n==P3_KEYI
2cf0: 4e 46 4f 20 69 74 20 6d 65 61 6e 73 20 74 68 61  NFO it means tha
2d00: 74 20 7a 50 33 20 69 73 20 61 20 70 6f 69 6e 74  t zP3 is a point
2d10: 65 72 20 74 6f 20 61 20 4b 65 79 49 6e 66 6f 20  er to a KeyInfo 
2d20: 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 20 41 20  structure..** A 
2d30: 63 6f 70 79 20 69 73 20 6d 61 64 65 20 6f 66 20  copy is made of 
2d40: 74 68 65 20 4b 65 79 49 6e 66 6f 20 73 74 72 75  the KeyInfo stru
2d50: 63 74 75 72 65 20 69 6e 74 6f 20 6d 65 6d 6f 72  cture into memor
2d60: 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d 0a  y obtained from.
2d70: 2a 2a 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 2c  ** sqliteMalloc,
2d80: 20 74 6f 20 62 65 20 66 72 65 65 64 20 77 68 65   to be freed whe
2d90: 6e 20 74 68 65 20 56 64 62 65 20 69 73 20 66 69  n the Vdbe is fi
2da0: 6e 61 6c 69 7a 65 64 2e 0a 2a 2a 20 6e 3d 3d 50  nalized..** n==P
2db0: 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46  3_KEYINFO_HANDOF
2dc0: 46 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74  F indicates that
2dd0: 20 7a 50 33 20 70 6f 69 6e 74 73 20 74 6f 20 61   zP3 points to a
2de0: 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74 75   KeyInfo structu
2df0: 72 65 0a 2a 2a 20 73 74 6f 72 65 64 20 69 6e 20  re.** stored in 
2e00: 6d 65 6d 6f 72 79 20 74 68 61 74 20 74 68 65 20  memory that the 
2e10: 63 61 6c 6c 65 72 20 68 61 73 20 6f 62 74 61 69  caller has obtai
2e20: 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 4d  ned from sqliteM
2e30: 61 6c 6c 6f 63 2e 20 54 68 65 20 0a 2a 2a 20 63  alloc. The .** c
2e40: 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20 6e 6f 74  aller should not
2e50: 20 66 72 65 65 20 74 68 65 20 61 6c 6c 6f 63 61   free the alloca
2e60: 74 69 6f 6e 2c 20 69 74 20 77 69 6c 6c 20 62 65  tion, it will be
2e70: 20 66 72 65 65 64 20 77 68 65 6e 20 74 68 65 20   freed when the 
2e80: 56 64 62 65 20 69 73 0a 2a 2a 20 66 69 6e 61 6c  Vdbe is.** final
2e90: 69 7a 65 64 2e 0a 2a 2a 20 0a 2a 2a 20 4f 74 68  ized..** .** Oth
2ea0: 65 72 20 76 61 6c 75 65 73 20 6f 66 20 6e 20 28  er values of n (
2eb0: 50 33 5f 53 54 41 54 49 43 2c 20 50 33 5f 43 4f  P3_STATIC, P3_CO
2ec0: 4c 4c 53 45 51 20 65 74 63 2e 29 20 69 6e 64 69  LLSEQ etc.) indi
2ed0: 63 61 74 65 20 74 68 61 74 20 7a 50 33 20 70 6f  cate that zP3 po
2ee0: 69 6e 74 73 0a 2a 2a 20 74 6f 20 61 20 73 74 72  ints.** to a str
2ef0: 69 6e 67 20 6f 72 20 73 74 72 75 63 74 75 72 65  ing or structure
2f00: 20 74 68 61 74 20 69 73 20 67 75 61 72 61 6e 74   that is guarant
2f10: 65 65 64 20 74 6f 20 65 78 69 73 74 20 66 6f 72  eed to exist for
2f20: 20 74 68 65 20 6c 69 66 65 74 69 6d 65 20 6f 66   the lifetime of
2f30: 0a 2a 2a 20 74 68 65 20 56 64 62 65 2e 20 49 6e  .** the Vdbe. In
2f40: 20 74 68 65 73 65 20 63 61 73 65 73 20 77 65 20   these cases we 
2f50: 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74 68  can just copy th
2f60: 65 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a  e pointer..**.**
2f70: 20 49 66 20 61 64 64 72 3c 30 20 74 68 65 6e 20   If addr<0 then 
2f80: 63 68 61 6e 67 65 20 50 33 20 6f 6e 20 74 68 65  change P3 on the
2f90: 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20 69   most recently i
2fa0: 6e 73 65 72 74 65 64 20 69 6e 73 74 72 75 63 74  nserted instruct
2fb0: 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ion..*/.void sql
2fc0: 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 33  ite3VdbeChangeP3
2fd0: 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61 64  (Vdbe *p, int ad
2fe0: 64 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  dr, const char *
2ff0: 7a 50 33 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 4f  zP3, int n){.  O
3000: 70 20 2a 70 4f 70 3b 0a 20 20 61 73 73 65 72 74  p *pOp;.  assert
3010: 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45  ( p->magic==VDBE
3020: 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20  _MAGIC_INIT );. 
3030: 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d 3e   if( p==0 || p->
3040: 61 4f 70 3d 3d 30 20 7c 7c 20 73 71 6c 69 74 65  aOp==0 || sqlite
3050: 33 54 68 72 65 61 64 44 61 74 61 52 65 61 64 4f  3ThreadDataReadO
3060: 6e 6c 79 28 29 2d 3e 6d 61 6c 6c 6f 63 46 61 69  nly()->mallocFai
3070: 6c 65 64 20 29 7b 0a 20 20 20 20 69 66 20 28 6e  led ){.    if (n
3080: 20 21 3d 20 50 33 5f 4b 45 59 49 4e 46 4f 29 20   != P3_KEYINFO) 
3090: 7b 0a 20 20 20 20 20 20 66 72 65 65 50 33 28 6e  {.      freeP3(n
30a0: 2c 20 28 76 6f 69 64 2a 29 2a 28 63 68 61 72 2a  , (void*)*(char*
30b0: 2a 29 26 7a 50 33 29 3b 0a 20 20 20 20 7d 0a 20  *)&zP3);.    }. 
30c0: 20 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20     return;.  }. 
30d0: 20 69 66 28 20 61 64 64 72 3c 30 20 7c 7c 20 61   if( addr<0 || a
30e0: 64 64 72 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20  ddr>=p->nOp ){. 
30f0: 20 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70     addr = p->nOp
3100: 20 2d 20 31 3b 0a 20 20 20 20 69 66 28 20 61 64   - 1;.    if( ad
3110: 64 72 3c 30 20 29 20 72 65 74 75 72 6e 3b 0a 20  dr<0 ) return;. 
3120: 20 7d 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61   }.  pOp = &p->a
3130: 4f 70 5b 61 64 64 72 5d 3b 0a 20 20 66 72 65 65  Op[addr];.  free
3140: 50 33 28 70 4f 70 2d 3e 70 33 74 79 70 65 2c 20  P3(pOp->p3type, 
3150: 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 70 4f 70 2d  pOp->p3);.  pOp-
3160: 3e 70 33 20 3d 20 30 3b 0a 20 20 69 66 28 20 7a  >p3 = 0;.  if( z
3170: 50 33 3d 3d 30 20 29 7b 0a 20 20 20 20 70 4f 70  P3==0 ){.    pOp
3180: 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 20 20 70 4f  ->p3 = 0;.    pO
3190: 70 2d 3e 70 33 74 79 70 65 20 3d 20 50 33 5f 4e  p->p3type = P3_N
31a0: 4f 54 55 53 45 44 3b 0a 20 20 7d 65 6c 73 65 20  OTUSED;.  }else 
31b0: 69 66 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46  if( n==P3_KEYINF
31c0: 4f 20 29 7b 0a 20 20 20 20 4b 65 79 49 6e 66 6f  O ){.    KeyInfo
31d0: 20 2a 70 4b 65 79 49 6e 66 6f 3b 0a 20 20 20 20   *pKeyInfo;.    
31e0: 69 6e 74 20 6e 46 69 65 6c 64 2c 20 6e 42 79 74  int nField, nByt
31f0: 65 3b 0a 0a 20 20 20 20 6e 46 69 65 6c 64 20 3d  e;..    nField =
3200: 20 28 28 4b 65 79 49 6e 66 6f 2a 29 7a 50 33 29   ((KeyInfo*)zP3)
3210: 2d 3e 6e 46 69 65 6c 64 3b 0a 20 20 20 20 6e 42  ->nField;.    nB
3220: 79 74 65 20 3d 20 73 69 7a 65 6f 66 28 2a 70 4b  yte = sizeof(*pK
3230: 65 79 49 6e 66 6f 29 20 2b 20 28 6e 46 69 65 6c  eyInfo) + (nFiel
3240: 64 2d 31 29 2a 73 69 7a 65 6f 66 28 70 4b 65 79  d-1)*sizeof(pKey
3250: 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 30 5d 29 20  Info->aColl[0]) 
3260: 2b 20 6e 46 69 65 6c 64 3b 0a 20 20 20 20 70 4b  + nField;.    pK
3270: 65 79 49 6e 66 6f 20 3d 20 73 71 6c 69 74 65 4d  eyInfo = sqliteM
3280: 61 6c 6c 6f 63 52 61 77 28 20 6e 42 79 74 65 20  allocRaw( nByte 
3290: 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d  );.    pOp->p3 =
32a0: 20 28 63 68 61 72 2a 29 70 4b 65 79 49 6e 66 6f   (char*)pKeyInfo
32b0: 3b 0a 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e  ;.    if( pKeyIn
32c0: 66 6f 20 29 7b 0a 20 20 20 20 20 20 63 68 61 72  fo ){.      char
32d0: 20 2a 61 53 6f 72 74 4f 72 64 65 72 3b 0a 20 20   *aSortOrder;.  
32e0: 20 20 20 20 6d 65 6d 63 70 79 28 70 4b 65 79 49      memcpy(pKeyI
32f0: 6e 66 6f 2c 20 7a 50 33 2c 20 6e 42 79 74 65 29  nfo, zP3, nByte)
3300: 3b 0a 20 20 20 20 20 20 61 53 6f 72 74 4f 72 64  ;.      aSortOrd
3310: 65 72 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 61  er = pKeyInfo->a
3320: 53 6f 72 74 4f 72 64 65 72 3b 0a 20 20 20 20 20  SortOrder;.     
3330: 20 69 66 28 20 61 53 6f 72 74 4f 72 64 65 72 20   if( aSortOrder 
3340: 29 7b 0a 20 20 20 20 20 20 20 20 70 4b 65 79 49  ){.        pKeyI
3350: 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20  nfo->aSortOrder 
3360: 3d 20 28 63 68 61 72 2a 29 26 70 4b 65 79 49 6e  = (char*)&pKeyIn
3370: 66 6f 2d 3e 61 43 6f 6c 6c 5b 6e 46 69 65 6c 64  fo->aColl[nField
3380: 5d 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70  ];.        memcp
3390: 79 28 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  y(pKeyInfo->aSor
33a0: 74 4f 72 64 65 72 2c 20 61 53 6f 72 74 4f 72 64  tOrder, aSortOrd
33b0: 65 72 2c 20 6e 46 69 65 6c 64 29 3b 0a 20 20 20  er, nField);.   
33c0: 20 20 20 7d 0a 20 20 20 20 20 20 70 4f 70 2d 3e     }.      pOp->
33d0: 70 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59 49  p3type = P3_KEYI
33e0: 4e 46 4f 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  NFO;.    }else{.
33f0: 20 20 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70        pOp->p3typ
3400: 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a  e = P3_NOTUSED;.
3410: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66      }.  }else if
3420: 28 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 5f  ( n==P3_KEYINFO_
3430: 48 41 4e 44 4f 46 46 20 29 7b 0a 20 20 20 20 70  HANDOFF ){.    p
3440: 4f 70 2d 3e 70 33 20 3d 20 28 63 68 61 72 2a 29  Op->p3 = (char*)
3450: 7a 50 33 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33  zP3;.    pOp->p3
3460: 74 79 70 65 20 3d 20 50 33 5f 4b 45 59 49 4e 46  type = P3_KEYINF
3470: 4f 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 6e  O;.  }else if( n
3480: 3c 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70  <0 ){.    pOp->p
3490: 33 20 3d 20 28 63 68 61 72 2a 29 7a 50 33 3b 0a  3 = (char*)zP3;.
34a0: 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20      pOp->p3type 
34b0: 3d 20 6e 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  = n;.  }else{.  
34c0: 20 20 69 66 28 20 6e 3d 3d 30 20 29 20 6e 20 3d    if( n==0 ) n =
34d0: 20 73 74 72 6c 65 6e 28 7a 50 33 29 3b 0a 20 20   strlen(zP3);.  
34e0: 20 20 70 4f 70 2d 3e 70 33 20 3d 20 73 71 6c 69    pOp->p3 = sqli
34f0: 74 65 53 74 72 4e 44 75 70 28 7a 50 33 2c 20 6e  teStrNDup(zP3, n
3500: 29 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79  );.    pOp->p3ty
3510: 70 65 20 3d 20 50 33 5f 44 59 4e 41 4d 49 43 3b  pe = P3_DYNAMIC;
3520: 0a 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 20  .  }.}..#ifndef 
3530: 4e 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65 70  NDEBUG./*.** Rep
3540: 6c 61 63 65 20 74 68 65 20 50 33 20 66 69 65 6c  lace the P3 fiel
3550: 64 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65  d of the most re
3560: 63 65 6e 74 6c 79 20 63 6f 64 65 64 20 69 6e 73  cently coded ins
3570: 74 72 75 63 74 69 6f 6e 20 77 69 74 68 0a 2a 2a  truction with.**
3580: 20 63 6f 6d 6d 65 6e 74 20 74 65 78 74 2e 0a 2a   comment text..*
3590: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
35a0: 62 65 43 6f 6d 6d 65 6e 74 28 56 64 62 65 20 2a  beComment(Vdbe *
35b0: 70 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  p, const char *z
35c0: 46 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a 20 20  Format, ...){.  
35d0: 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 61 73  va_list ap;.  as
35e0: 73 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29  sert( p->nOp>0 )
35f0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61  ;.  assert( p->a
3600: 4f 70 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 5b  Op==0 || p->aOp[
3610: 70 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 3d 3d 30 20  p->nOp-1].p3==0 
3620: 0a 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71  .          || sq
3630: 6c 69 74 65 33 54 68 72 65 61 64 44 61 74 61 52  lite3ThreadDataR
3640: 65 61 64 4f 6e 6c 79 28 29 2d 3e 6d 61 6c 6c 6f  eadOnly()->mallo
3650: 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 76 61 5f  cFailed );.  va_
3660: 73 74 61 72 74 28 61 70 2c 20 7a 46 6f 72 6d 61  start(ap, zForma
3670: 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  t);.  sqlite3Vdb
3680: 65 43 68 61 6e 67 65 50 33 28 70 2c 20 2d 31 2c  eChangeP3(p, -1,
3690: 20 73 71 6c 69 74 65 33 56 4d 50 72 69 6e 74 66   sqlite3VMPrintf
36a0: 28 7a 46 6f 72 6d 61 74 2c 20 61 70 29 2c 20 50  (zFormat, ap), P
36b0: 33 5f 44 59 4e 41 4d 49 43 29 3b 0a 20 20 76 61  3_DYNAMIC);.  va
36c0: 5f 65 6e 64 28 61 70 29 3b 0a 7d 0a 23 65 6e 64  _end(ap);.}.#end
36d0: 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  if../*.** Return
36e0: 20 74 68 65 20 6f 70 63 6f 64 65 20 66 6f 72 20   the opcode for 
36f0: 61 20 67 69 76 65 6e 20 61 64 64 72 65 73 73 2e  a given address.
3700: 0a 2a 2f 0a 56 64 62 65 4f 70 20 2a 73 71 6c 69  .*/.VdbeOp *sqli
3710: 74 65 33 56 64 62 65 47 65 74 4f 70 28 56 64 62  te3VdbeGetOp(Vdb
3720: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 29 7b  e *p, int addr){
3730: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 6d 61  .  assert( p->ma
3740: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
3750: 49 4e 49 54 20 29 3b 0a 20 20 61 73 73 65 72 74  INIT );.  assert
3760: 28 20 61 64 64 72 3e 3d 30 20 26 26 20 61 64 64  ( addr>=0 && add
3770: 72 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 72 65  r<p->nOp );.  re
3780: 74 75 72 6e 20 26 70 2d 3e 61 4f 70 5b 61 64 64  turn &p->aOp[add
3790: 72 5d 3b 0a 7d 0a 0a 23 69 66 20 21 64 65 66 69  r];.}..#if !defi
37a0: 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  ned(SQLITE_OMIT_
37b0: 45 58 50 4c 41 49 4e 29 20 7c 7c 20 21 64 65 66  EXPLAIN) || !def
37c0: 69 6e 65 64 28 4e 44 45 42 55 47 29 20 5c 0a 20  ined(NDEBUG) \. 
37d0: 20 20 20 20 7c 7c 20 64 65 66 69 6e 65 64 28 56      || defined(V
37e0: 44 42 45 5f 50 52 4f 46 49 4c 45 29 20 7c 7c 20  DBE_PROFILE) || 
37f0: 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 44  defined(SQLITE_D
3800: 45 42 55 47 29 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70  EBUG)./*.** Comp
3810: 75 74 65 20 61 20 73 74 72 69 6e 67 20 74 68 61  ute a string tha
3820: 74 20 64 65 73 63 72 69 62 65 73 20 74 68 65 20  t describes the 
3830: 50 33 20 70 61 72 61 6d 65 74 65 72 20 66 6f 72  P3 parameter for
3840: 20 61 6e 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 55   an opcode..** U
3850: 73 65 20 7a 54 65 6d 70 20 66 6f 72 20 61 6e 79  se zTemp for any
3860: 20 72 65 71 75 69 72 65 64 20 74 65 6d 70 6f 72   required tempor
3870: 61 72 79 20 62 75 66 66 65 72 20 73 70 61 63 65  ary buffer space
3880: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 63 68 61 72  ..*/.static char
3890: 20 2a 64 69 73 70 6c 61 79 50 33 28 4f 70 20 2a   *displayP3(Op *
38a0: 70 4f 70 2c 20 63 68 61 72 20 2a 7a 54 65 6d 70  pOp, char *zTemp
38b0: 2c 20 69 6e 74 20 6e 54 65 6d 70 29 7b 0a 20 20  , int nTemp){.  
38c0: 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 61 73 73  char *zP3;.  ass
38d0: 65 72 74 28 20 6e 54 65 6d 70 3e 3d 32 30 20 29  ert( nTemp>=20 )
38e0: 3b 0a 20 20 73 77 69 74 63 68 28 20 70 4f 70 2d  ;.  switch( pOp-
38f0: 3e 70 33 74 79 70 65 20 29 7b 0a 20 20 20 20 63  >p3type ){.    c
3900: 61 73 65 20 50 33 5f 4b 45 59 49 4e 46 4f 3a 20  ase P3_KEYINFO: 
3910: 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 2c 20 6a  {.      int i, j
3920: 3b 0a 20 20 20 20 20 20 4b 65 79 49 6e 66 6f 20  ;.      KeyInfo 
3930: 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 28 4b 65 79  *pKeyInfo = (Key
3940: 49 6e 66 6f 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20  Info*)pOp->p3;. 
3950: 20 20 20 20 20 73 70 72 69 6e 74 66 28 7a 54 65       sprintf(zTe
3960: 6d 70 2c 20 22 6b 65 79 69 6e 66 6f 28 25 64 22  mp, "keyinfo(%d"
3970: 2c 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65  , pKeyInfo->nFie
3980: 6c 64 29 3b 0a 20 20 20 20 20 20 69 20 3d 20 73  ld);.      i = s
3990: 74 72 6c 65 6e 28 7a 54 65 6d 70 29 3b 0a 20 20  trlen(zTemp);.  
39a0: 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70      for(j=0; j<p
39b0: 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b  KeyInfo->nField;
39c0: 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 43   j++){.        C
39d0: 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 20 3d 20  ollSeq *pColl = 
39e0: 70 4b 65 79 49 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b  pKeyInfo->aColl[
39f0: 6a 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20  j];.        if( 
3a00: 70 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20  pColl ){.       
3a10: 20 20 20 69 6e 74 20 6e 20 3d 20 73 74 72 6c 65     int n = strle
3a20: 6e 28 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b  n(pColl->zName);
3a30: 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 69  .          if( i
3a40: 2b 6e 3e 6e 54 65 6d 70 2d 36 20 29 7b 0a 20 20  +n>nTemp-6 ){.  
3a50: 20 20 20 20 20 20 20 20 20 20 73 74 72 63 70 79            strcpy
3a60: 28 26 7a 54 65 6d 70 5b 69 5d 2c 22 2c 2e 2e 2e  (&zTemp[i],",...
3a70: 22 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ");.            
3a80: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20  break;.         
3a90: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 7a 54 65   }.          zTe
3aa0: 6d 70 5b 69 2b 2b 5d 20 3d 20 27 2c 27 3b 0a 20  mp[i++] = ',';. 
3ab0: 20 20 20 20 20 20 20 20 20 69 66 28 20 70 4b 65           if( pKe
3ac0: 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65  yInfo->aSortOrde
3ad0: 72 20 26 26 20 70 4b 65 79 49 6e 66 6f 2d 3e 61  r && pKeyInfo->a
3ae0: 53 6f 72 74 4f 72 64 65 72 5b 6a 5d 20 29 7b 0a  SortOrder[j] ){.
3af0: 20 20 20 20 20 20 20 20 20 20 20 20 7a 54 65 6d              zTem
3b00: 70 5b 69 2b 2b 5d 20 3d 20 27 2d 27 3b 0a 20 20  p[i++] = '-';.  
3b10: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
3b20: 20 20 20 20 73 74 72 63 70 79 28 26 7a 54 65 6d      strcpy(&zTem
3b30: 70 5b 69 5d 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61  p[i], pColl->zNa
3b40: 6d 65 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69  me);.          i
3b50: 20 2b 3d 20 6e 3b 0a 20 20 20 20 20 20 20 20 7d   += n;.        }
3b60: 65 6c 73 65 20 69 66 28 20 69 2b 34 3c 6e 54 65  else if( i+4<nTe
3b70: 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20 20 20 20  mp-6 ){.        
3b80: 20 20 73 74 72 63 70 79 28 26 7a 54 65 6d 70 5b    strcpy(&zTemp[
3b90: 69 5d 2c 22 2c 6e 69 6c 22 29 3b 0a 20 20 20 20  i],",nil");.    
3ba0: 20 20 20 20 20 20 69 20 2b 3d 20 34 3b 0a 20 20        i += 4;.  
3bb0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
3bc0: 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b 2b 5d        zTemp[i++]
3bd0: 20 3d 20 27 29 27 3b 0a 20 20 20 20 20 20 7a 54   = ')';.      zT
3be0: 65 6d 70 5b 69 5d 20 3d 20 30 3b 0a 20 20 20 20  emp[i] = 0;.    
3bf0: 20 20 61 73 73 65 72 74 28 20 69 3c 6e 54 65 6d    assert( i<nTem
3c00: 70 20 29 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d  p );.      zP3 =
3c10: 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20 20 62 72   zTemp;.      br
3c20: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63  eak;.    }.    c
3c30: 61 73 65 20 50 33 5f 43 4f 4c 4c 53 45 51 3a 20  ase P3_COLLSEQ: 
3c40: 7b 0a 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 20  {.      CollSeq 
3c50: 2a 70 43 6f 6c 6c 20 3d 20 28 43 6f 6c 6c 53 65  *pColl = (CollSe
3c60: 71 2a 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20  q*)pOp->p3;.    
3c70: 20 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c    sprintf(zTemp,
3c80: 20 22 63 6f 6c 6c 73 65 71 28 25 2e 32 30 73 29   "collseq(%.20s)
3c90: 22 2c 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29  ", pColl->zName)
3ca0: 3b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54  ;.      zP3 = zT
3cb0: 65 6d 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  emp;.      break
3cc0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
3cd0: 20 50 33 5f 46 55 4e 43 44 45 46 3a 20 7b 0a 20   P3_FUNCDEF: {. 
3ce0: 20 20 20 20 20 46 75 6e 63 44 65 66 20 2a 70 44       FuncDef *pD
3cf0: 65 66 20 3d 20 28 46 75 6e 63 44 65 66 2a 29 70  ef = (FuncDef*)p
3d00: 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 63 68  Op->p3;.      ch
3d10: 61 72 20 7a 4e 75 6d 5b 33 30 5d 3b 0a 20 20 20  ar zNum[30];.   
3d20: 20 20 20 73 70 72 69 6e 74 66 28 7a 54 65 6d 70     sprintf(zTemp
3d30: 2c 20 22 25 2e 2a 73 22 2c 20 6e 54 65 6d 70 2c  , "%.*s", nTemp,
3d40: 20 70 44 65 66 2d 3e 7a 4e 61 6d 65 29 3b 0a 20   pDef->zName);. 
3d50: 20 20 20 20 20 73 70 72 69 6e 74 66 28 7a 4e 75       sprintf(zNu
3d60: 6d 2c 22 28 25 64 29 22 2c 20 70 44 65 66 2d 3e  m,"(%d)", pDef->
3d70: 6e 41 72 67 29 3b 0a 20 20 20 20 20 20 69 66 28  nArg);.      if(
3d80: 20 73 74 72 6c 65 6e 28 7a 54 65 6d 70 29 2b 73   strlen(zTemp)+s
3d90: 74 72 6c 65 6e 28 7a 4e 75 6d 29 2b 31 3c 3d 6e  trlen(zNum)+1<=n
3da0: 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 20 20  Temp ){.        
3db0: 73 74 72 63 61 74 28 7a 54 65 6d 70 2c 20 7a 4e  strcat(zTemp, zN
3dc0: 75 6d 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  um);.      }.   
3dd0: 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a     zP3 = zTemp;.
3de0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3df0: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20   }.    default: 
3e00: 7b 0a 20 20 20 20 20 20 7a 50 33 20 3d 20 70 4f  {.      zP3 = pO
3e10: 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 69 66 28  p->p3;.      if(
3e20: 20 7a 50 33 3d 3d 30 20 7c 7c 20 70 4f 70 2d 3e   zP3==0 || pOp->
3e30: 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70 20  opcode==OP_Noop 
3e40: 29 7b 0a 20 20 20 20 20 20 20 20 7a 50 33 20 3d  ){.        zP3 =
3e50: 20 22 22 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20   "";.      }.   
3e60: 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20   }.  }.  return 
3e70: 7a 50 33 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 0a  zP3;.}.#endif...
3e80: 23 69 66 20 64 65 66 69 6e 65 64 28 56 44 42 45  #if defined(VDBE
3e90: 5f 50 52 4f 46 49 4c 45 29 20 7c 7c 20 64 65 66  _PROFILE) || def
3ea0: 69 6e 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55  ined(SQLITE_DEBU
3eb0: 47 29 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 61  G)./*.** Print a
3ec0: 20 73 69 6e 67 6c 65 20 6f 70 63 6f 64 65 2e 20   single opcode. 
3ed0: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
3ee0: 20 75 73 65 64 20 66 6f 72 20 64 65 62 75 67 67   used for debugg
3ef0: 69 6e 67 20 6f 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69  ing only..*/.voi
3f00: 64 20 73 71 6c 69 74 65 33 56 64 62 65 50 72 69  d sqlite3VdbePri
3f10: 6e 74 4f 70 28 46 49 4c 45 20 2a 70 4f 75 74 2c  ntOp(FILE *pOut,
3f20: 20 69 6e 74 20 70 63 2c 20 4f 70 20 2a 70 4f 70   int pc, Op *pOp
3f30: 29 7b 0a 20 20 63 68 61 72 20 2a 7a 50 33 3b 0a  ){.  char *zP3;.
3f40: 20 20 63 68 61 72 20 7a 50 74 72 5b 35 30 5d 3b    char zPtr[50];
3f50: 0a 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20  .  static const 
3f60: 63 68 61 72 20 2a 7a 46 6f 72 6d 61 74 31 20 3d  char *zFormat1 =
3f70: 20 22 25 34 64 20 25 2d 31 33 73 20 25 34 64 20   "%4d %-13s %4d 
3f80: 25 34 64 20 25 73 5c 6e 22 3b 0a 20 20 69 66 28  %4d %s\n";.  if(
3f90: 20 70 4f 75 74 3d 3d 30 20 29 20 70 4f 75 74 20   pOut==0 ) pOut 
3fa0: 3d 20 73 74 64 6f 75 74 3b 0a 20 20 7a 50 33 20  = stdout;.  zP3 
3fb0: 3d 20 64 69 73 70 6c 61 79 50 33 28 70 4f 70 2c  = displayP3(pOp,
3fc0: 20 7a 50 74 72 2c 20 73 69 7a 65 6f 66 28 7a 50   zPtr, sizeof(zP
3fd0: 74 72 29 29 3b 0a 20 20 66 70 72 69 6e 74 66 28  tr));.  fprintf(
3fe0: 70 4f 75 74 2c 20 7a 46 6f 72 6d 61 74 31 2c 0a  pOut, zFormat1,.
3ff0: 20 20 20 20 20 20 70 63 2c 20 73 71 6c 69 74 65        pc, sqlite
4000: 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70 4f 70  3OpcodeNames[pOp
4010: 2d 3e 6f 70 63 6f 64 65 5d 2c 20 70 4f 70 2d 3e  ->opcode], pOp->
4020: 70 31 2c 20 70 4f 70 2d 3e 70 32 2c 20 7a 50 33  p1, pOp->p2, zP3
4030: 29 3b 0a 20 20 66 66 6c 75 73 68 28 70 4f 75 74  );.  fflush(pOut
4040: 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a  );.}.#endif../*.
4050: 2a 2a 20 52 65 6c 65 61 73 65 20 61 6e 20 61 72  ** Release an ar
4060: 72 61 79 20 6f 66 20 4e 20 4d 65 6d 20 65 6c 65  ray of N Mem ele
4070: 6d 65 6e 74 73 0a 2a 2f 0a 73 74 61 74 69 63 20  ments.*/.static 
4080: 76 6f 69 64 20 72 65 6c 65 61 73 65 4d 65 6d 41  void releaseMemA
4090: 72 72 61 79 28 4d 65 6d 20 2a 70 2c 20 69 6e 74  rray(Mem *p, int
40a0: 20 4e 29 7b 0a 20 20 69 66 28 20 70 20 29 7b 0a   N){.  if( p ){.
40b0: 20 20 20 20 77 68 69 6c 65 28 20 4e 2d 2d 3e 30      while( N-->0
40c0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
40d0: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
40e0: 70 2b 2b 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  p++);.    }.  }.
40f0: 7d 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  }..#ifndef SQLIT
4100: 45 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 2f  E_OMIT_EXPLAIN./
4110: 2a 0a 2a 2a 20 47 69 76 65 20 61 20 6c 69 73 74  *.** Give a list
4120: 69 6e 67 20 6f 66 20 74 68 65 20 70 72 6f 67 72  ing of the progr
4130: 61 6d 20 69 6e 20 74 68 65 20 76 69 72 74 75 61  am in the virtua
4140: 6c 20 6d 61 63 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a  l machine..**.**
4150: 20 54 68 65 20 69 6e 74 65 72 66 61 63 65 20 69   The interface i
4160: 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 73 71  s the same as sq
4170: 6c 69 74 65 33 56 64 62 65 45 78 65 63 28 29 2e  lite3VdbeExec().
4180: 20 20 42 75 74 20 69 6e 73 74 65 61 64 20 6f 66    But instead of
4190: 0a 2a 2a 20 72 75 6e 6e 69 6e 67 20 74 68 65 20  .** running the 
41a0: 63 6f 64 65 2c 20 69 74 20 69 6e 76 6f 6b 65 73  code, it invokes
41b0: 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e   the callback on
41c0: 63 65 20 66 6f 72 20 65 61 63 68 20 69 6e 73 74  ce for each inst
41d0: 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73  ruction..** This
41e0: 20 66 65 61 74 75 72 65 20 69 73 20 75 73 65 64   feature is used
41f0: 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 22 45   to implement "E
4200: 58 50 4c 41 49 4e 22 2e 0a 2a 2f 0a 69 6e 74 20  XPLAIN"..*/.int 
4210: 73 71 6c 69 74 65 33 56 64 62 65 4c 69 73 74 28  sqlite3VdbeList(
4220: 0a 20 20 56 64 62 65 20 2a 70 20 20 20 20 20 20  .  Vdbe *p      
4230: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4240: 54 68 65 20 56 44 42 45 20 2a 2f 0a 29 7b 0a 20  The VDBE */.){. 
4250: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
4260: 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20  ->db;.  int i;. 
4270: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
4280: 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  _OK;..  assert( 
4290: 70 2d 3e 65 78 70 6c 61 69 6e 20 29 3b 0a 20 20  p->explain );.  
42a0: 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56 44  if( p->magic!=VD
42b0: 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 20 72  BE_MAGIC_RUN ) r
42c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
42d0: 55 53 45 3b 0a 20 20 61 73 73 65 72 74 28 20 64  USE;.  assert( d
42e0: 62 2d 3e 6d 61 67 69 63 3d 3d 53 51 4c 49 54 45  b->magic==SQLITE
42f0: 5f 4d 41 47 49 43 5f 42 55 53 59 20 29 3b 0a 20  _MAGIC_BUSY );. 
4300: 20 61 73 73 65 72 74 28 20 70 2d 3e 72 63 3d 3d   assert( p->rc==
4310: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e  SQLITE_OK || p->
4320: 72 63 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20  rc==SQLITE_BUSY 
4330: 29 3b 0a 0a 20 20 2f 2a 20 45 76 65 6e 20 74 68  );..  /* Even th
4340: 6f 75 67 68 20 74 68 69 73 20 6f 70 63 6f 64 65  ough this opcode
4350: 20 64 6f 65 73 20 6e 6f 74 20 70 75 74 20 64 79   does not put dy
4360: 6e 61 6d 69 63 20 73 74 72 69 6e 67 73 20 6f 6e  namic strings on
4370: 74 6f 20 74 68 65 0a 20 20 2a 2a 20 74 68 65 20  to the.  ** the 
4380: 73 74 61 63 6b 2c 20 74 68 65 79 20 6d 61 79 20  stack, they may 
4390: 62 65 63 6f 6d 65 20 64 79 6e 61 6d 69 63 20 69  become dynamic i
43a0: 66 20 74 68 65 20 75 73 65 72 20 63 61 6c 6c 73  f the user calls
43b0: 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f 63 6f  .  ** sqlite3_co
43c0: 6c 75 6d 6e 5f 74 65 78 74 31 36 28 29 2c 20 63  lumn_text16(), c
43d0: 61 75 73 69 6e 67 20 61 20 74 72 61 6e 73 6c 61  ausing a transla
43e0: 74 69 6f 6e 20 74 6f 20 55 54 46 2d 31 36 20 65  tion to UTF-16 e
43f0: 6e 63 6f 64 69 6e 67 2e 0a 20 20 2a 2f 0a 20 20  ncoding..  */.  
4400: 69 66 28 20 70 2d 3e 70 54 6f 73 3d 3d 26 70 2d  if( p->pTos==&p-
4410: 3e 61 53 74 61 63 6b 5b 34 5d 20 29 7b 0a 20 20  >aStack[4] ){.  
4420: 20 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61    releaseMemArra
4430: 79 28 70 2d 3e 61 53 74 61 63 6b 2c 20 35 29 3b  y(p->aStack, 5);
4440: 0a 20 20 7d 0a 20 20 70 2d 3e 72 65 73 4f 6e 53  .  }.  p->resOnS
4450: 74 61 63 6b 20 3d 20 30 3b 0a 0a 20 20 64 6f 7b  tack = 0;..  do{
4460: 0a 20 20 20 20 69 20 3d 20 70 2d 3e 70 63 2b 2b  .    i = p->pc++
4470: 3b 0a 20 20 7d 77 68 69 6c 65 28 20 69 3c 70 2d  ;.  }while( i<p-
4480: 3e 6e 4f 70 20 26 26 20 70 2d 3e 65 78 70 6c 61  >nOp && p->expla
4490: 69 6e 3d 3d 32 20 26 26 20 70 2d 3e 61 4f 70 5b  in==2 && p->aOp[
44a0: 69 5d 2e 6f 70 63 6f 64 65 21 3d 4f 50 5f 45 78  i].opcode!=OP_Ex
44b0: 70 6c 61 69 6e 20 29 3b 0a 20 20 69 66 28 20 69  plain );.  if( i
44c0: 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20 20 20  >=p->nOp ){.    
44d0: 70 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  p->rc = SQLITE_O
44e0: 4b 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  K;.    rc = SQLI
44f0: 54 45 5f 44 4f 4e 45 3b 0a 20 20 7d 65 6c 73 65  TE_DONE;.  }else
4500: 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20 26   if( db->flags &
4510: 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70   SQLITE_Interrup
4520: 74 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61  t ){.    db->fla
4530: 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 49 6e  gs &= ~SQLITE_In
4540: 74 65 72 72 75 70 74 3b 0a 20 20 20 20 70 2d 3e  terrupt;.    p->
4550: 72 63 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45  rc = SQLITE_INTE
4560: 52 52 55 50 54 3b 0a 20 20 20 20 72 63 20 3d 20  RRUPT;.    rc = 
4570: 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20  SQLITE_ERROR;.  
4580: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
4590: 6e 67 28 26 70 2d 3e 7a 45 72 72 4d 73 67 2c 20  ng(&p->zErrMsg, 
45a0: 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 70 2d  sqlite3ErrStr(p-
45b0: 3e 72 63 29 2c 20 28 63 68 61 72 2a 29 30 29 3b  >rc), (char*)0);
45c0: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 4f 70  .  }else{.    Op
45d0: 20 2a 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b   *pOp = &p->aOp[
45e0: 69 5d 3b 0a 20 20 20 20 4d 65 6d 20 2a 70 4d 65  i];.    Mem *pMe
45f0: 6d 20 3d 20 70 2d 3e 61 53 74 61 63 6b 3b 0a 20  m = p->aStack;. 
4600: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
4610: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d   MEM_Int;.    pM
4620: 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54  em->type = SQLIT
4630: 45 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 70  E_INTEGER;.    p
4640: 4d 65 6d 2d 3e 69 20 3d 20 69 3b 20 20 20 20 20  Mem->i = i;     
4650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4660: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72             /* Pr
4670: 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 20 2a 2f  ogram counter */
4680: 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20  .    pMem++;..  
4690: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
46a0: 4d 45 4d 5f 53 74 61 74 69 63 7c 4d 45 4d 5f 53  MEM_Static|MEM_S
46b0: 74 72 7c 4d 45 4d 5f 54 65 72 6d 3b 0a 20 20 20  tr|MEM_Term;.   
46c0: 20 70 4d 65 6d 2d 3e 7a 20 3d 20 73 71 6c 69 74   pMem->z = sqlit
46d0: 65 33 4f 70 63 6f 64 65 4e 61 6d 65 73 5b 70 4f  e3OpcodeNames[pO
46e0: 70 2d 3e 6f 70 63 6f 64 65 5d 3b 20 20 2f 2a 20  p->opcode];  /* 
46f0: 4f 70 63 6f 64 65 20 2a 2f 0a 20 20 20 20 70 4d  Opcode */.    pM
4700: 65 6d 2d 3e 6e 20 3d 20 73 74 72 6c 65 6e 28 70  em->n = strlen(p
4710: 4d 65 6d 2d 3e 7a 29 3b 0a 20 20 20 20 70 4d 65  Mem->z);.    pMe
4720: 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45  m->type = SQLITE
4730: 5f 54 45 58 54 3b 0a 20 20 20 20 70 4d 65 6d 2d  _TEXT;.    pMem-
4740: 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f 55 54  >enc = SQLITE_UT
4750: 46 38 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a  F8;.    pMem++;.
4760: 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73  .    pMem->flags
4770: 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20   = MEM_Int;.    
4780: 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e 70  pMem->i = pOp->p
4790: 31 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1;              
47a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
47b0: 31 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 74  1 */.    pMem->t
47c0: 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54  ype = SQLITE_INT
47d0: 45 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b  EGER;.    pMem++
47e0: 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  ;..    pMem->fla
47f0: 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20  gs = MEM_Int;.  
4800: 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 70 4f 70 2d    pMem->i = pOp-
4810: 3e 70 32 3b 20 20 20 20 20 20 20 20 20 20 20 20  >p2;            
4820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4830: 20 50 32 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d   P2 */.    pMem-
4840: 3e 74 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 49  >type = SQLITE_I
4850: 4e 54 45 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d  NTEGER;.    pMem
4860: 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65 6d 2d 3e 66  ++;..    pMem->f
4870: 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 68 6f 72 74  lags = MEM_Short
4880: 7c 4d 45 4d 5f 53 74 72 7c 4d 45 4d 5f 54 65 72  |MEM_Str|MEM_Ter
4890: 6d 3b 20 20 20 2f 2a 20 50 33 20 2a 2f 0a 20 20  m;   /* P3 */.  
48a0: 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 64 69 73 70    pMem->z = disp
48b0: 6c 61 79 50 33 28 70 4f 70 2c 20 70 4d 65 6d 2d  layP3(pOp, pMem-
48c0: 3e 7a 53 68 6f 72 74 2c 20 73 69 7a 65 6f 66 28  >zShort, sizeof(
48d0: 70 4d 65 6d 2d 3e 7a 53 68 6f 72 74 29 29 3b 0a  pMem->zShort));.
48e0: 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d      pMem->type =
48f0: 20 53 51 4c 49 54 45 5f 54 45 58 54 3b 0a 20 20   SQLITE_TEXT;.  
4900: 20 20 70 4d 65 6d 2d 3e 65 6e 63 20 3d 20 53 51    pMem->enc = SQ
4910: 4c 49 54 45 5f 55 54 46 38 3b 0a 0a 20 20 20 20  LITE_UTF8;..    
4920: 70 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d 20  p->nResColumn = 
4930: 35 20 2d 20 32 2a 28 70 2d 3e 65 78 70 6c 61 69  5 - 2*(p->explai
4940: 6e 2d 31 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f  n-1);.    p->pTo
4950: 73 20 3d 20 70 4d 65 6d 3b 0a 20 20 20 20 70 2d  s = pMem;.    p-
4960: 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  >rc = SQLITE_OK;
4970: 0a 20 20 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61  .    p->resOnSta
4980: 63 6b 20 3d 20 31 3b 0a 20 20 20 20 72 63 20 3d  ck = 1;.    rc =
4990: 20 53 51 4c 49 54 45 5f 52 4f 57 3b 0a 20 20 7d   SQLITE_ROW;.  }
49a0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
49b0: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
49c0: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 20 2a 2f  _OMIT_EXPLAIN */
49d0: 0a 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 74 68  ../*.** Print th
49e0: 65 20 53 51 4c 20 74 68 61 74 20 77 61 73 20 75  e SQL that was u
49f0: 73 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20  sed to generate 
4a00: 61 20 56 44 42 45 20 70 72 6f 67 72 61 6d 2e 0a  a VDBE program..
4a10: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56  */.void sqlite3V
4a20: 64 62 65 50 72 69 6e 74 53 71 6c 28 56 64 62 65  dbePrintSql(Vdbe
4a30: 20 2a 70 29 7b 0a 23 69 66 64 65 66 20 53 51 4c   *p){.#ifdef SQL
4a40: 49 54 45 5f 44 45 42 55 47 0a 20 20 69 6e 74 20  ITE_DEBUG.  int 
4a50: 6e 4f 70 20 3d 20 70 2d 3e 6e 4f 70 3b 0a 20 20  nOp = p->nOp;.  
4a60: 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a 20 20 69  VdbeOp *pOp;.  i
4a70: 66 28 20 6e 4f 70 3c 31 20 29 20 72 65 74 75 72  f( nOp<1 ) retur
4a80: 6e 3b 0a 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61  n;.  pOp = &p->a
4a90: 4f 70 5b 6e 4f 70 2d 31 5d 3b 0a 20 20 69 66 28  Op[nOp-1];.  if(
4aa0: 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50   pOp->opcode==OP
4ab0: 5f 4e 6f 6f 70 20 26 26 20 70 4f 70 2d 3e 70 33  _Noop && pOp->p3
4ac0: 21 3d 30 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74  !=0 ){.    const
4ad0: 20 63 68 61 72 20 2a 7a 20 3d 20 70 4f 70 2d 3e   char *z = pOp->
4ae0: 70 33 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 69  p3;.    while( i
4af0: 73 73 70 61 63 65 28 2a 28 75 38 2a 29 7a 29 20  sspace(*(u8*)z) 
4b00: 29 20 7a 2b 2b 3b 0a 20 20 20 20 70 72 69 6e 74  ) z++;.    print
4b10: 66 28 22 53 51 4c 3a 20 5b 25 73 5d 5c 6e 22 2c  f("SQL: [%s]\n",
4b20: 20 7a 29 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a   z);.  }.#endif.
4b30: 7d 0a 0a 2f 2a 0a 2a 2a 20 50 72 65 70 61 72 65  }../*.** Prepare
4b40: 20 61 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69   a virtual machi
4b50: 6e 65 20 66 6f 72 20 65 78 65 63 75 74 69 6f 6e  ne for execution
4b60: 2e 20 20 54 68 69 73 20 69 6e 76 6f 6c 76 65 73  .  This involves
4b70: 20 74 68 69 6e 67 73 20 73 75 63 68 0a 2a 2a 20   things such.** 
4b80: 61 73 20 61 6c 6c 6f 63 61 74 69 6e 67 20 73 74  as allocating st
4b90: 61 63 6b 20 73 70 61 63 65 20 61 6e 64 20 69 6e  ack space and in
4ba0: 69 74 69 61 6c 69 7a 69 6e 67 20 74 68 65 20 70  itializing the p
4bb0: 72 6f 67 72 61 6d 20 63 6f 75 6e 74 65 72 2e 0a  rogram counter..
4bc0: 2a 2a 20 41 66 74 65 72 20 74 68 65 20 56 44 42  ** After the VDB
4bd0: 45 20 68 61 73 20 62 65 20 70 72 65 70 70 65 64  E has be prepped
4be0: 2c 20 69 74 20 63 61 6e 20 62 65 20 65 78 65 63  , it can be exec
4bf0: 75 74 65 64 20 62 79 20 6f 6e 65 20 6f 72 20 6d  uted by one or m
4c00: 6f 72 65 0a 2a 2a 20 63 61 6c 6c 73 20 74 6f 20  ore.** calls to 
4c10: 73 71 6c 69 74 65 33 56 64 62 65 45 78 65 63 28  sqlite3VdbeExec(
4c20: 29 2e 20 20 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20  ).  .**.** This 
4c30: 69 73 20 74 68 65 20 6f 6e 6c 79 20 77 61 79 20  is the only way 
4c40: 74 6f 20 6d 6f 76 65 20 61 20 56 44 42 45 20 66  to move a VDBE f
4c50: 72 6f 6d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49  rom VDBE_MAGIC_I
4c60: 4e 49 54 20 74 6f 0a 2a 2a 20 56 44 42 45 5f 4d  NIT to.** VDBE_M
4c70: 41 47 49 43 5f 52 55 4e 2e 0a 2a 2f 0a 76 6f 69  AGIC_RUN..*/.voi
4c80: 64 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b  d sqlite3VdbeMak
4c90: 65 52 65 61 64 79 28 0a 20 20 56 64 62 65 20 2a  eReady(.  Vdbe *
4ca0: 70 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  p,              
4cb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20           /* The 
4cc0: 56 44 42 45 20 2a 2f 0a 20 20 69 6e 74 20 6e 56  VDBE */.  int nV
4cd0: 61 72 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ar,             
4ce0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62           /* Numb
4cf0: 65 72 20 6f 66 20 27 3f 27 20 73 65 65 20 69 6e  er of '?' see in
4d00: 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65   the SQL stateme
4d10: 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 4d 65 6d  nt */.  int nMem
4d20: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
4d30: 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72         /* Number
4d40: 20 6f 66 20 6d 65 6d 6f 72 79 20 63 65 6c 6c 73   of memory cells
4d50: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a   to allocate */.
4d60: 20 20 69 6e 74 20 6e 43 75 72 73 6f 72 2c 20 20    int nCursor,  
4d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4d80: 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 75   /* Number of cu
4d90: 72 73 6f 72 73 20 74 6f 20 61 6c 6c 6f 63 61 74  rsors to allocat
4da0: 65 20 2a 2f 0a 20 20 69 6e 74 20 69 73 45 78 70  e */.  int isExp
4db0: 6c 61 69 6e 20 20 20 20 20 20 20 20 20 20 20 20  lain            
4dc0: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66        /* True if
4dd0: 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b 65 79   the EXPLAIN key
4de0: 77 6f 72 64 73 20 69 73 20 70 72 65 73 65 6e 74  words is present
4df0: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 3b 0a   */.){.  int n;.
4e00: 0a 20 20 61 73 73 65 72 74 28 20 70 21 3d 30 20  .  assert( p!=0 
4e10: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  );.  assert( p->
4e20: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
4e30: 43 5f 49 4e 49 54 20 29 3b 0a 0a 20 20 2f 2a 20  C_INIT );..  /* 
4e40: 54 68 65 72 65 20 73 68 6f 75 6c 64 20 62 65 20  There should be 
4e50: 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 6f 70 63  at least one opc
4e60: 6f 64 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65  ode..  */.  asse
4e70: 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b 0a  rt( p->nOp>0 );.
4e80: 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 20 6d 61  .  /* Set the ma
4e90: 67 69 63 20 74 6f 20 56 44 42 45 5f 4d 41 47 49  gic to VDBE_MAGI
4ea0: 43 5f 52 55 4e 20 73 6f 6f 6e 65 72 20 72 61 74  C_RUN sooner rat
4eb0: 68 65 72 20 74 68 61 6e 20 6c 61 74 65 72 2e 20  her than later. 
4ec0: 54 68 69 73 0a 20 20 20 2a 20 69 73 20 62 65 63  This.   * is bec
4ed0: 61 75 73 65 20 74 68 65 20 63 61 6c 6c 20 74 6f  ause the call to
4ee0: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 29   resizeOpArray()
4ef0: 20 62 65 6c 6f 77 20 6d 61 79 20 73 68 72 69 6e   below may shrin
4f00: 6b 20 74 68 65 0a 20 20 20 2a 20 70 2d 3e 61 4f  k the.   * p->aO
4f10: 70 5b 5d 20 61 72 72 61 79 20 74 6f 20 73 61 76  p[] array to sav
4f20: 65 20 6d 65 6d 6f 72 79 20 69 66 20 63 61 6c 6c  e memory if call
4f30: 65 64 20 77 68 65 6e 20 69 6e 20 56 44 42 45 5f  ed when in VDBE_
4f40: 4d 41 47 49 43 5f 52 55 4e 20 0a 20 20 20 2a 20  MAGIC_RUN .   * 
4f50: 73 74 61 74 65 2e 0a 20 20 20 2a 2f 0a 20 20 70  state..   */.  p
4f60: 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d  ->magic = VDBE_M
4f70: 41 47 49 43 5f 52 55 4e 3b 0a 0a 20 20 2f 2a 20  AGIC_RUN;..  /* 
4f80: 4e 6f 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 65  No instruction e
4f90: 76 65 72 20 70 75 73 68 65 73 20 6d 6f 72 65 20  ver pushes more 
4fa0: 74 68 61 6e 20 61 20 73 69 6e 67 6c 65 20 65 6c  than a single el
4fb0: 65 6d 65 6e 74 20 6f 6e 74 6f 20 74 68 65 0a 20  ement onto the. 
4fc0: 20 2a 2a 20 73 74 61 63 6b 2e 20 20 41 6e 64 20   ** stack.  And 
4fd0: 74 68 65 20 73 74 61 63 6b 20 6e 65 76 65 72 20  the stack never 
4fe0: 67 72 6f 77 73 20 6f 6e 20 73 75 63 63 65 73 73  grows on success
4ff0: 69 76 65 20 65 78 65 63 75 74 69 6f 6e 73 20 6f  ive executions o
5000: 66 20 74 68 65 0a 20 20 2a 2a 20 73 61 6d 65 20  f the.  ** same 
5010: 6c 6f 6f 70 2e 20 20 53 6f 20 74 68 65 20 74 6f  loop.  So the to
5020: 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 69 6e  tal number of in
5030: 73 74 72 75 63 74 69 6f 6e 73 20 69 73 20 61 6e  structions is an
5040: 20 75 70 70 65 72 20 62 6f 75 6e 64 0a 20 20 2a   upper bound.  *
5050: 2a 20 6f 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d  * on the maximum
5060: 20 73 74 61 63 6b 20 64 65 70 74 68 20 72 65 71   stack depth req
5070: 75 69 72 65 64 2e 20 20 28 41 64 64 65 64 20 6c  uired.  (Added l
5080: 61 74 65 72 3a 29 20 20 54 68 65 0a 20 20 2a 2a  ater:)  The.  **
5090: 20 72 65 73 6f 6c 76 65 50 32 56 61 6c 75 65 73   resolveP2Values
50a0: 28 29 20 63 61 6c 6c 20 63 6f 6d 70 75 74 65 73  () call computes
50b0: 20 61 20 74 69 67 68 74 65 72 20 75 70 70 65 72   a tighter upper
50c0: 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 0a 20 20   bound on the.  
50d0: 2a 2a 20 73 74 61 63 6b 20 73 69 7a 65 2e 0a 20  ** stack size.. 
50e0: 20 2a 2a 0a 20 20 2a 2a 20 41 6c 6c 6f 63 61 74   **.  ** Allocat
50f0: 69 6f 6e 20 61 6c 6c 20 74 68 65 20 73 74 61 63  ion all the stac
5100: 6b 20 73 70 61 63 65 20 77 65 20 77 69 6c 6c 20  k space we will 
5110: 65 76 65 72 20 6e 65 65 64 2e 0a 20 20 2a 2f 0a  ever need..  */.
5120: 20 20 69 66 28 20 70 2d 3e 61 53 74 61 63 6b 3d    if( p->aStack=
5130: 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 41  =0 ){.    int nA
5140: 72 67 3b 20 20 20 20 20 20 20 2f 2a 20 4d 61 78  rg;       /* Max
5150: 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 61  imum number of a
5160: 72 67 73 20 70 61 73 73 65 64 20 74 6f 20 61 20  rgs passed to a 
5170: 75 73 65 72 20 66 75 6e 63 74 69 6f 6e 2e 20 2a  user function. *
5180: 2f 0a 20 20 20 20 69 6e 74 20 6e 53 74 61 63 6b  /.    int nStack
5190: 3b 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d  ;     /* Maximum
51a0: 20 6e 75 6d 62 65 72 20 6f 66 20 73 74 61 63 6b   number of stack
51b0: 20 65 6e 74 72 69 65 73 20 72 65 71 75 69 72 65   entries require
51c0: 64 20 2a 2f 0a 20 20 20 20 72 65 73 6f 6c 76 65  d */.    resolve
51d0: 50 32 56 61 6c 75 65 73 28 70 2c 20 26 6e 41 72  P2Values(p, &nAr
51e0: 67 2c 20 26 6e 53 74 61 63 6b 29 3b 0a 20 20 20  g, &nStack);.   
51f0: 20 72 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70   resizeOpArray(p
5200: 2c 20 70 2d 3e 6e 4f 70 29 3b 0a 20 20 20 20 61  , p->nOp);.    a
5210: 73 73 65 72 74 28 20 6e 56 61 72 3e 3d 30 20 29  ssert( nVar>=0 )
5220: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 53  ;.    assert( nS
5230: 74 61 63 6b 3c 70 2d 3e 6e 4f 70 20 29 3b 0a 20  tack<p->nOp );. 
5240: 20 20 20 6e 53 74 61 63 6b 20 3d 20 69 73 45 78     nStack = isEx
5250: 70 6c 61 69 6e 20 3f 20 31 30 20 3a 20 6e 53 74  plain ? 10 : nSt
5260: 61 63 6b 3b 0a 20 20 20 20 70 2d 3e 61 53 74 61  ack;.    p->aSta
5270: 63 6b 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f  ck = sqliteMallo
5280: 63 28 0a 20 20 20 20 20 20 20 20 6e 53 74 61 63  c(.        nStac
5290: 6b 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 53 74 61  k*sizeof(p->aSta
52a0: 63 6b 5b 30 5d 29 20 20 20 20 2f 2a 20 61 53 74  ck[0])    /* aSt
52b0: 61 63 6b 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e  ack */.      + n
52c0: 41 72 67 2a 73 69 7a 65 6f 66 28 4d 65 6d 2a 29  Arg*sizeof(Mem*)
52d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
52e0: 20 61 70 41 72 67 20 2a 2f 0a 20 20 20 20 20 20   apArg */.      
52f0: 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66 28 4d 65  + nVar*sizeof(Me
5300: 6d 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20  m)              
5310: 20 2f 2a 20 61 56 61 72 20 2a 2f 0a 20 20 20 20   /* aVar */.    
5320: 20 20 2b 20 6e 56 61 72 2a 73 69 7a 65 6f 66 28    + nVar*sizeof(
5330: 63 68 61 72 2a 29 20 20 20 20 20 20 20 20 20 20  char*)          
5340: 20 20 20 2f 2a 20 61 7a 56 61 72 20 2a 2f 0a 20     /* azVar */. 
5350: 20 20 20 20 20 2b 20 6e 4d 65 6d 2a 73 69 7a 65       + nMem*size
5360: 6f 66 28 4d 65 6d 29 20 20 20 20 20 20 20 20 20  of(Mem)         
5370: 20 20 20 20 20 20 2f 2a 20 61 4d 65 6d 20 2a 2f        /* aMem */
5380: 0a 20 20 20 20 20 20 2b 20 6e 43 75 72 73 6f 72  .      + nCursor
5390: 2a 73 69 7a 65 6f 66 28 43 75 72 73 6f 72 2a 29  *sizeof(Cursor*)
53a0: 20 20 20 20 20 20 20 20 2f 2a 20 61 70 43 73 72          /* apCsr
53b0: 20 2a 2f 0a 20 20 20 20 29 3b 0a 20 20 20 20 69   */.    );.    i
53c0: 66 28 20 21 73 71 6c 69 74 65 33 54 68 72 65 61  f( !sqlite3Threa
53d0: 64 44 61 74 61 52 65 61 64 4f 6e 6c 79 28 29 2d  dDataReadOnly()-
53e0: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b  >mallocFailed ){
53f0: 0a 20 20 20 20 20 20 70 2d 3e 61 4d 65 6d 20 3d  .      p->aMem =
5400: 20 26 70 2d 3e 61 53 74 61 63 6b 5b 6e 53 74 61   &p->aStack[nSta
5410: 63 6b 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 4d  ck];.      p->nM
5420: 65 6d 20 3d 20 6e 4d 65 6d 3b 0a 20 20 20 20 20  em = nMem;.     
5430: 20 70 2d 3e 61 56 61 72 20 3d 20 26 70 2d 3e 61   p->aVar = &p->a
5440: 4d 65 6d 5b 6e 4d 65 6d 5d 3b 0a 20 20 20 20 20  Mem[nMem];.     
5450: 20 70 2d 3e 6e 56 61 72 20 3d 20 6e 56 61 72 3b   p->nVar = nVar;
5460: 0a 20 20 20 20 20 20 70 2d 3e 6f 6b 56 61 72 20  .      p->okVar 
5470: 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d 3e 61 70  = 0;.      p->ap
5480: 41 72 67 20 3d 20 28 4d 65 6d 2a 2a 29 26 70 2d  Arg = (Mem**)&p-
5490: 3e 61 56 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20  >aVar[nVar];.   
54a0: 20 20 20 70 2d 3e 61 7a 56 61 72 20 3d 20 28 63     p->azVar = (c
54b0: 68 61 72 2a 2a 29 26 70 2d 3e 61 70 41 72 67 5b  har**)&p->apArg[
54c0: 6e 41 72 67 5d 3b 0a 20 20 20 20 20 20 70 2d 3e  nArg];.      p->
54d0: 61 70 43 73 72 20 3d 20 28 43 75 72 73 6f 72 2a  apCsr = (Cursor*
54e0: 2a 29 26 70 2d 3e 61 7a 56 61 72 5b 6e 56 61 72  *)&p->azVar[nVar
54f0: 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 43 75 72  ];.      p->nCur
5500: 73 6f 72 20 3d 20 6e 43 75 72 73 6f 72 3b 0a 20  sor = nCursor;. 
5510: 20 20 20 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c       for(n=0; n<
5520: 6e 56 61 72 3b 20 6e 2b 2b 29 7b 0a 20 20 20 20  nVar; n++){.    
5530: 20 20 20 20 70 2d 3e 61 56 61 72 5b 6e 5d 2e 66      p->aVar[n].f
5540: 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b  lags = MEM_Null;
5550: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
5560: 20 7d 0a 20 20 66 6f 72 28 6e 3d 30 3b 20 6e 3c   }.  for(n=0; n<
5570: 70 2d 3e 6e 4d 65 6d 3b 20 6e 2b 2b 29 7b 0a 20  p->nMem; n++){. 
5580: 20 20 20 70 2d 3e 61 4d 65 6d 5b 6e 5d 2e 66 6c     p->aMem[n].fl
5590: 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a  ags = MEM_Null;.
55a0: 20 20 7d 0a 0a 23 69 66 64 65 66 20 53 51 4c 49    }..#ifdef SQLI
55b0: 54 45 5f 44 45 42 55 47 0a 20 20 69 66 28 20 28  TE_DEBUG.  if( (
55c0: 70 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  p->db->flags & S
55d0: 51 4c 49 54 45 5f 56 64 62 65 4c 69 73 74 69 6e  QLITE_VdbeListin
55e0: 67 29 21 3d 30 0a 20 20 20 20 7c 7c 20 73 71 6c  g)!=0.    || sql
55f0: 69 74 65 33 4f 73 46 69 6c 65 45 78 69 73 74 73  ite3OsFileExists
5600: 28 22 76 64 62 65 5f 65 78 70 6c 61 69 6e 22 29  ("vdbe_explain")
5610: 0a 20 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b  .  ){.    int i;
5620: 0a 20 20 20 20 70 72 69 6e 74 66 28 22 56 44 42  .    printf("VDB
5630: 45 20 50 72 6f 67 72 61 6d 20 4c 69 73 74 69 6e  E Program Listin
5640: 67 3a 5c 6e 22 29 3b 0a 20 20 20 20 73 71 6c 69  g:\n");.    sqli
5650: 74 65 33 56 64 62 65 50 72 69 6e 74 53 71 6c 28  te3VdbePrintSql(
5660: 70 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b  p);.    for(i=0;
5670: 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b   i<p->nOp; i++){
5680: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
5690: 62 65 50 72 69 6e 74 4f 70 28 73 74 64 6f 75 74  bePrintOp(stdout
56a0: 2c 20 69 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29  , i, &p->aOp[i])
56b0: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66  ;.    }.  }.  if
56c0: 28 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65 45  ( sqlite3OsFileE
56d0: 78 69 73 74 73 28 22 76 64 62 65 5f 74 72 61 63  xists("vdbe_trac
56e0: 65 22 29 20 29 7b 0a 20 20 20 20 70 2d 3e 74 72  e") ){.    p->tr
56f0: 61 63 65 20 3d 20 73 74 64 6f 75 74 3b 0a 20 20  ace = stdout;.  
5700: 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e 70 54  }.#endif.  p->pT
5710: 6f 73 20 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b  os = &p->aStack[
5720: 2d 31 5d 3b 0a 20 20 70 2d 3e 70 63 20 3d 20 2d  -1];.  p->pc = -
5730: 31 3b 0a 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c  1;.  p->rc = SQL
5740: 49 54 45 5f 4f 4b 3b 0a 20 20 70 2d 3e 75 6e 69  ITE_OK;.  p->uni
5750: 71 75 65 43 6e 74 20 3d 20 30 3b 0a 20 20 70 2d  queCnt = 0;.  p-
5760: 3e 72 65 74 75 72 6e 44 65 70 74 68 20 3d 20 30  >returnDepth = 0
5770: 3b 0a 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69  ;.  p->errorActi
5780: 6f 6e 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20  on = OE_Abort;. 
5790: 20 70 2d 3e 70 6f 70 53 74 61 63 6b 20 3d 20 20   p->popStack =  
57a0: 30 3b 0a 20 20 70 2d 3e 65 78 70 6c 61 69 6e 20  0;.  p->explain 
57b0: 7c 3d 20 69 73 45 78 70 6c 61 69 6e 3b 0a 20 20  |= isExplain;.  
57c0: 70 2d 3e 6d 61 67 69 63 20 3d 20 56 44 42 45 5f  p->magic = VDBE_
57d0: 4d 41 47 49 43 5f 52 55 4e 3b 0a 20 20 70 2d 3e  MAGIC_RUN;.  p->
57e0: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20 70  nChange = 0;.  p
57f0: 2d 3e 63 61 63 68 65 43 74 72 20 3d 20 31 3b 0a  ->cacheCtr = 1;.
5800: 20 20 70 2d 3e 6d 69 6e 57 72 69 74 65 46 69 6c    p->minWriteFil
5810: 65 46 6f 72 6d 61 74 20 3d 20 32 35 35 3b 0a 23  eFormat = 255;.#
5820: 69 66 64 65 66 20 56 44 42 45 5f 50 52 4f 46 49  ifdef VDBE_PROFI
5830: 4c 45 0a 20 20 7b 0a 20 20 20 20 69 6e 74 20 69  LE.  {.    int i
5840: 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69  ;.    for(i=0; i
5850: 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20  <p->nOp; i++){. 
5860: 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63       p->aOp[i].c
5870: 6e 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 70 2d  nt = 0;.      p-
5880: 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 20 3d  >aOp[i].cycles =
5890: 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65   0;.    }.  }.#e
58a0: 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c  ndif.}../*.** Cl
58b0: 6f 73 65 20 61 20 63 75 72 73 6f 72 20 61 6e 64  ose a cursor and
58c0: 20 72 65 6c 65 61 73 65 20 61 6c 6c 20 74 68 65   release all the
58d0: 20 72 65 73 6f 75 72 63 65 73 20 74 68 61 74 20   resources that 
58e0: 63 75 72 73 6f 72 20 68 61 70 70 65 6e 73 0a 2a  cursor happens.*
58f0: 2a 20 74 6f 20 68 6f 6c 64 2e 0a 2a 2f 0a 76 6f  * to hold..*/.vo
5900: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 46 72  id sqlite3VdbeFr
5910: 65 65 43 75 72 73 6f 72 28 43 75 72 73 6f 72 20  eeCursor(Cursor 
5920: 2a 70 43 78 29 7b 0a 20 20 69 66 28 20 70 43 78  *pCx){.  if( pCx
5930: 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72  ==0 ){.    retur
5940: 6e 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 43 78  n;.  }.  if( pCx
5950: 2d 3e 70 43 75 72 73 6f 72 20 29 7b 0a 20 20 20  ->pCursor ){.   
5960: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f   sqlite3BtreeClo
5970: 73 65 43 75 72 73 6f 72 28 70 43 78 2d 3e 70 43  seCursor(pCx->pC
5980: 75 72 73 6f 72 29 3b 0a 20 20 7d 0a 20 20 69 66  ursor);.  }.  if
5990: 28 20 70 43 78 2d 3e 70 42 74 20 29 7b 0a 20 20  ( pCx->pBt ){.  
59a0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6c    sqlite3BtreeCl
59b0: 6f 73 65 28 70 43 78 2d 3e 70 42 74 29 3b 0a 20  ose(pCx->pBt);. 
59c0: 20 7d 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28   }.  sqliteFree(
59d0: 70 43 78 2d 3e 70 44 61 74 61 29 3b 0a 20 20 73  pCx->pData);.  s
59e0: 71 6c 69 74 65 46 72 65 65 28 70 43 78 2d 3e 61  qliteFree(pCx->a
59f0: 54 79 70 65 29 3b 0a 20 20 73 71 6c 69 74 65 46  Type);.  sqliteF
5a00: 72 65 65 28 70 43 78 29 3b 0a 7d 0a 0a 2f 2a 0a  ree(pCx);.}../*.
5a10: 2a 2a 20 43 6c 6f 73 65 20 61 6c 6c 20 63 75 72  ** Close all cur
5a20: 73 6f 72 73 0a 2a 2f 0a 73 74 61 74 69 63 20 76  sors.*/.static v
5a30: 6f 69 64 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73  oid closeAllCurs
5a40: 6f 72 73 28 56 64 62 65 20 2a 70 29 7b 0a 20 20  ors(Vdbe *p){.  
5a50: 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e  int i;.  if( p->
5a60: 61 70 43 73 72 3d 3d 30 20 29 20 72 65 74 75 72  apCsr==0 ) retur
5a70: 6e 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  n;.  for(i=0; i<
5a80: 70 2d 3e 6e 43 75 72 73 6f 72 3b 20 69 2b 2b 29  p->nCursor; i++)
5a90: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
5aa0: 65 46 72 65 65 43 75 72 73 6f 72 28 70 2d 3e 61  eFreeCursor(p->a
5ab0: 70 43 73 72 5b 69 5d 29 3b 0a 20 20 20 20 70 2d  pCsr[i]);.    p-
5ac0: 3e 61 70 43 73 72 5b 69 5d 20 3d 20 30 3b 0a 20  >apCsr[i] = 0;. 
5ad0: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61   }.}../*.** Clea
5ae0: 6e 20 75 70 20 74 68 65 20 56 4d 20 61 66 74 65  n up the VM afte
5af0: 72 20 65 78 65 63 75 74 69 6f 6e 2e 0a 2a 2a 0a  r execution..**.
5b00: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
5b10: 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c  will automatical
5b20: 6c 79 20 63 6c 6f 73 65 20 61 6e 79 20 63 75 72  ly close any cur
5b30: 73 6f 72 73 2c 20 6c 69 73 74 73 2c 20 61 6e 64  sors, lists, and
5b40: 2f 6f 72 0a 2a 2a 20 73 6f 72 74 65 72 73 20 74  /or.** sorters t
5b50: 68 61 74 20 77 65 72 65 20 6c 65 66 74 20 6f 70  hat were left op
5b60: 65 6e 2e 20 20 49 74 20 61 6c 73 6f 20 64 65 6c  en.  It also del
5b70: 65 74 65 73 20 74 68 65 20 76 61 6c 75 65 73 20  etes the values 
5b80: 6f 66 0a 2a 2a 20 76 61 72 69 61 62 6c 65 73 20  of.** variables 
5b90: 69 6e 20 74 68 65 20 61 56 61 72 5b 5d 20 61 72  in the aVar[] ar
5ba0: 72 61 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ray..*/.static v
5bb0: 6f 69 64 20 43 6c 65 61 6e 75 70 28 56 64 62 65  oid Cleanup(Vdbe
5bc0: 20 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20   *p){.  int i;. 
5bd0: 20 69 66 28 20 70 2d 3e 61 53 74 61 63 6b 20 29   if( p->aStack )
5be0: 7b 0a 20 20 20 20 72 65 6c 65 61 73 65 4d 65 6d  {.    releaseMem
5bf0: 41 72 72 61 79 28 70 2d 3e 61 53 74 61 63 6b 2c  Array(p->aStack,
5c00: 20 31 20 2b 20 28 70 2d 3e 70 54 6f 73 20 2d 20   1 + (p->pTos - 
5c10: 70 2d 3e 61 53 74 61 63 6b 29 29 3b 0a 20 20 20  p->aStack));.   
5c20: 20 70 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e 61   p->pTos = &p->a
5c30: 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20 20 7d 0a 20  Stack[-1];.  }. 
5c40: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
5c50: 28 70 29 3b 0a 20 20 72 65 6c 65 61 73 65 4d 65  (p);.  releaseMe
5c60: 6d 41 72 72 61 79 28 70 2d 3e 61 4d 65 6d 2c 20  mArray(p->aMem, 
5c70: 70 2d 3e 6e 4d 65 6d 29 3b 0a 20 20 73 71 6c 69  p->nMem);.  sqli
5c80: 74 65 33 56 64 62 65 46 69 66 6f 43 6c 65 61 72  te3VdbeFifoClear
5c90: 28 26 70 2d 3e 73 46 69 66 6f 29 3b 0a 20 20 69  (&p->sFifo);.  i
5ca0: 66 28 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61  f( p->contextSta
5cb0: 63 6b 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d  ck ){.    for(i=
5cc0: 30 3b 20 69 3c 70 2d 3e 63 6f 6e 74 65 78 74 53  0; i<p->contextS
5cd0: 74 61 63 6b 54 6f 70 3b 20 69 2b 2b 29 7b 0a 20  tackTop; i++){. 
5ce0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
5cf0: 46 69 66 6f 43 6c 65 61 72 28 26 70 2d 3e 63 6f  FifoClear(&p->co
5d00: 6e 74 65 78 74 53 74 61 63 6b 5b 69 5d 2e 73 46  ntextStack[i].sF
5d10: 69 66 6f 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  ifo);.    }.    
5d20: 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 63 6f  sqliteFree(p->co
5d30: 6e 74 65 78 74 53 74 61 63 6b 29 3b 0a 20 20 7d  ntextStack);.  }
5d40: 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61  .  p->contextSta
5d50: 63 6b 20 3d 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e  ck = 0;.  p->con
5d60: 74 65 78 74 53 74 61 63 6b 44 65 70 74 68 20 3d  textStackDepth =
5d70: 20 30 3b 0a 20 20 70 2d 3e 63 6f 6e 74 65 78 74   0;.  p->context
5d80: 53 74 61 63 6b 54 6f 70 20 3d 20 30 3b 0a 20 20  StackTop = 0;.  
5d90: 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a 45  sqliteFree(p->zE
5da0: 72 72 4d 73 67 29 3b 0a 20 20 70 2d 3e 7a 45 72  rrMsg);.  p->zEr
5db0: 72 4d 73 67 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a  rMsg = 0;.}../*.
5dc0: 2a 2a 20 53 65 74 20 74 68 65 20 6e 75 6d 62 65  ** Set the numbe
5dd0: 72 20 6f 66 20 72 65 73 75 6c 74 20 63 6f 6c 75  r of result colu
5de0: 6d 6e 73 20 74 68 61 74 20 77 69 6c 6c 20 62 65  mns that will be
5df0: 20 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 69   returned by thi
5e00: 73 20 53 51 4c 0a 2a 2a 20 73 74 61 74 65 6d 65  s SQL.** stateme
5e10: 6e 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 77 20  nt. This is now 
5e20: 73 65 74 20 61 74 20 63 6f 6d 70 69 6c 65 20 74  set at compile t
5e30: 69 6d 65 2c 20 72 61 74 68 65 72 20 74 68 61 6e  ime, rather than
5e40: 20 64 75 72 69 6e 67 0a 2a 2a 20 65 78 65 63 75   during.** execu
5e50: 74 69 6f 6e 20 6f 66 20 74 68 65 20 76 64 62 65  tion of the vdbe
5e60: 20 70 72 6f 67 72 61 6d 20 73 6f 20 74 68 61 74   program so that
5e70: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
5e80: 63 6f 75 6e 74 28 29 20 63 61 6e 0a 2a 2a 20 62  count() can.** b
5e90: 65 20 63 61 6c 6c 65 64 20 6f 6e 20 61 6e 20 53  e called on an S
5ea0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 62 65 66  QL statement bef
5eb0: 6f 72 65 20 73 71 6c 69 74 65 33 5f 73 74 65 70  ore sqlite3_step
5ec0: 28 29 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ()..*/.void sqli
5ed0: 74 65 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c  te3VdbeSetNumCol
5ee0: 73 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6e  s(Vdbe *p, int n
5ef0: 52 65 73 43 6f 6c 75 6d 6e 29 7b 0a 20 20 4d 65  ResColumn){.  Me
5f00: 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 20 20 69  m *pColName;.  i
5f10: 6e 74 20 6e 3b 0a 20 20 72 65 6c 65 61 73 65 4d  nt n;.  releaseM
5f20: 65 6d 41 72 72 61 79 28 70 2d 3e 61 43 6f 6c 4e  emArray(p->aColN
5f30: 61 6d 65 2c 20 70 2d 3e 6e 52 65 73 43 6f 6c 75  ame, p->nResColu
5f40: 6d 6e 2a 32 29 3b 0a 20 20 73 71 6c 69 74 65 46  mn*2);.  sqliteF
5f50: 72 65 65 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 29  ree(p->aColName)
5f60: 3b 0a 20 20 6e 20 3d 20 6e 52 65 73 43 6f 6c 75  ;.  n = nResColu
5f70: 6d 6e 2a 32 3b 0a 20 20 70 2d 3e 6e 52 65 73 43  mn*2;.  p->nResC
5f80: 6f 6c 75 6d 6e 20 3d 20 6e 52 65 73 43 6f 6c 75  olumn = nResColu
5f90: 6d 6e 3b 0a 20 20 70 2d 3e 61 43 6f 6c 4e 61 6d  mn;.  p->aColNam
5fa0: 65 20 3d 20 70 43 6f 6c 4e 61 6d 65 20 3d 20 28  e = pColName = (
5fb0: 4d 65 6d 2a 29 73 71 6c 69 74 65 4d 61 6c 6c 6f  Mem*)sqliteMallo
5fc0: 63 28 20 73 69 7a 65 6f 66 28 4d 65 6d 29 2a 6e  c( sizeof(Mem)*n
5fd0: 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61 43 6f   );.  if( p->aCo
5fe0: 6c 4e 61 6d 65 3d 3d 30 20 29 20 72 65 74 75 72  lName==0 ) retur
5ff0: 6e 3b 0a 20 20 77 68 69 6c 65 28 20 6e 2d 2d 20  n;.  while( n-- 
6000: 3e 20 30 20 29 7b 0a 20 20 20 20 28 70 43 6f 6c  > 0 ){.    (pCol
6010: 4e 61 6d 65 2b 2b 29 2d 3e 66 6c 61 67 73 20 3d  Name++)->flags =
6020: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a 7d   MEM_Null;.  }.}
6030: 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68 65 20  ../*.** Set the 
6040: 6e 61 6d 65 20 6f 66 20 74 68 65 20 69 64 78 27  name of the idx'
6050: 74 68 20 63 6f 6c 75 6d 6e 20 74 6f 20 62 65 20  th column to be 
6060: 72 65 74 75 72 6e 65 64 20 62 79 20 74 68 65 20  returned by the 
6070: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a  SQL statement..*
6080: 2a 20 7a 4e 61 6d 65 20 6d 75 73 74 20 62 65 20  * zName must be 
6090: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20 6e  a pointer to a n
60a0: 75 6c 20 74 65 72 6d 69 6e 61 74 65 64 20 73 74  ul terminated st
60b0: 72 69 6e 67 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  ring..**.** This
60c0: 20 63 61 6c 6c 20 6d 75 73 74 20 62 65 20 6d 61   call must be ma
60d0: 64 65 20 61 66 74 65 72 20 61 20 63 61 6c 6c 20  de after a call 
60e0: 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  to sqlite3VdbeSe
60f0: 74 4e 75 6d 43 6f 6c 73 28 29 2e 0a 2a 2a 0a 2a  tNumCols()..**.*
6100: 2a 20 49 66 20 4e 3d 3d 50 33 5f 53 54 41 54 49  * If N==P3_STATI
6110: 43 20 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74  C  it means that
6120: 20 7a 4e 61 6d 65 20 69 73 20 61 20 70 6f 69 6e   zName is a poin
6130: 74 65 72 20 74 6f 20 61 20 63 6f 6e 73 74 61 6e  ter to a constan
6140: 74 20 73 74 61 74 69 63 0a 2a 2a 20 73 74 72 69  t static.** stri
6150: 6e 67 20 61 6e 64 20 77 65 20 63 61 6e 20 6a 75  ng and we can ju
6160: 73 74 20 63 6f 70 79 20 74 68 65 20 70 6f 69 6e  st copy the poin
6170: 74 65 72 2e 20 49 66 20 69 74 20 69 73 20 50 33  ter. If it is P3
6180: 5f 44 59 4e 41 4d 49 43 2c 20 74 68 65 6e 20 0a  _DYNAMIC, then .
6190: 2a 2a 20 74 68 65 20 73 74 72 69 6e 67 20 69 73  ** the string is
61a0: 20 66 72 65 65 64 20 75 73 69 6e 67 20 73 71 6c   freed using sql
61b0: 69 74 65 46 72 65 65 28 29 20 77 68 65 6e 20 74  iteFree() when t
61c0: 68 65 20 76 64 62 65 20 69 73 20 66 69 6e 69 73  he vdbe is finis
61d0: 68 65 64 20 77 69 74 68 0a 2a 2a 20 69 74 2e 20  hed with.** it. 
61e0: 4f 74 68 65 72 77 69 73 65 2c 20 4e 20 62 79 74  Otherwise, N byt
61f0: 65 73 20 6f 66 20 7a 4e 61 6d 65 20 61 72 65 20  es of zName are 
6200: 63 6f 70 69 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73  copied..*/.int s
6210: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c  qlite3VdbeSetCol
6220: 4e 61 6d 65 28 56 64 62 65 20 2a 70 2c 20 69 6e  Name(Vdbe *p, in
6230: 74 20 69 64 78 2c 20 63 6f 6e 73 74 20 63 68 61  t idx, const cha
6240: 72 20 2a 7a 4e 61 6d 65 2c 20 69 6e 74 20 4e 29  r *zName, int N)
6250: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 4d 65  {.  int rc;.  Me
6260: 6d 20 2a 70 43 6f 6c 4e 61 6d 65 3b 0a 20 20 61  m *pColName;.  a
6270: 73 73 65 72 74 28 20 69 64 78 3c 28 32 2a 70 2d  ssert( idx<(2*p-
6280: 3e 6e 52 65 73 43 6f 6c 75 6d 6e 29 20 29 3b 0a  >nResColumn) );.
6290: 20 20 69 66 28 20 73 71 6c 69 74 65 33 54 68 72    if( sqlite3Thr
62a0: 65 61 64 44 61 74 61 52 65 61 64 4f 6e 6c 79 28  eadDataReadOnly(
62b0: 29 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  )->mallocFailed 
62c0: 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  ) return SQLITE_
62d0: 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65 72 74 28  NOMEM;.  assert(
62e0: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21 3d 30 20   p->aColName!=0 
62f0: 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65 20 3d 20  );.  pColName = 
6300: 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 5b 69 64  &(p->aColName[id
6310: 78 5d 29 3b 0a 20 20 69 66 28 20 4e 3d 3d 50 33  x]);.  if( N==P3
6320: 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e 3d 3d 50  _DYNAMIC || N==P
6330: 33 5f 53 54 41 54 49 43 20 29 7b 0a 20 20 20 20  3_STATIC ){.    
6340: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
6350: 4d 65 6d 53 65 74 53 74 72 28 70 43 6f 6c 4e 61  MemSetStr(pColNa
6360: 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31 2c 20 53  me, zName, -1, S
6370: 51 4c 49 54 45 5f 55 54 46 38 2c 20 53 51 4c 49  QLITE_UTF8, SQLI
6380: 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 7d 65  TE_STATIC);.  }e
6390: 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d 20 73 71  lse{.    rc = sq
63a0: 6c 69 74 65 33 56 64 62 65 4d 65 6d 53 65 74 53  lite3VdbeMemSetS
63b0: 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20 7a 4e 61  tr(pColName, zNa
63c0: 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45 5f 55 54  me, N, SQLITE_UT
63d0: 46 38 2c 53 51 4c 49 54 45 5f 54 52 41 4e 53 49  F8,SQLITE_TRANSI
63e0: 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  ENT);.  }.  if( 
63f0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
6400: 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49 43 20 29   N==P3_DYNAMIC )
6410: 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e  {.    pColName->
6420: 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c 4e 61 6d  flags = (pColNam
6430: 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45 4d 5f 53  e->flags&(~MEM_S
6440: 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44 79 6e 3b  tatic))|MEM_Dyn;
6450: 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65 2d 3e 78  .    pColName->x
6460: 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72  Del = 0;.  }.  r
6470: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
6480: 2a 2a 20 41 20 72 65 61 64 20 6f 72 20 77 72 69  ** A read or wri
6490: 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6d  te transaction m
64a0: 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 20 62 65  ay or may not be
64b0: 20 61 63 74 69 76 65 20 6f 6e 20 64 61 74 61 62   active on datab
64c0: 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a 20 64 62  ase handle.** db
64d0: 2e 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69  . If a transacti
64e0: 6f 6e 20 69 73 20 61 63 74 69 76 65 2c 20 63 6f  on is active, co
64f0: 6d 6d 69 74 20 69 74 2e 20 49 66 20 74 68 65 72  mmit it. If ther
6500: 65 20 69 73 20 61 0a 2a 2a 20 77 72 69 74 65 2d  e is a.** write-
6510: 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 70 61 6e  transaction span
6520: 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 6f  ning more than o
6530: 6e 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ne database file
6540: 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a  , this routine.*
6550: 2a 20 74 61 6b 65 73 20 63 61 72 65 20 6f 66 20  * takes care of 
6560: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  the master journ
6570: 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a 2a 2f 0a  al trickery..*/.
6580: 73 74 61 74 69 63 20 69 6e 74 20 76 64 62 65 43  static int vdbeC
6590: 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33 20 2a 64  ommit(sqlite3 *d
65a0: 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69  b){.  int i;.  i
65b0: 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30 3b 20 20  nt nTrans = 0;  
65c0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 64 61 74  /* Number of dat
65d0: 61 62 61 73 65 73 20 77 69 74 68 20 61 6e 20 61  abases with an a
65e0: 63 74 69 76 65 20 77 72 69 74 65 2d 74 72 61 6e  ctive write-tran
65f0: 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e 74  saction */.  int
6600: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
6610: 0a 20 20 69 6e 74 20 6e 65 65 64 58 63 6f 6d 6d  .  int needXcomm
6620: 69 74 20 3d 20 30 3b 0a 0a 20 20 66 6f 72 28 69  it = 0;..  for(i
6630: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
6640: 2b 2b 29 7b 20 0a 20 20 20 20 42 74 72 65 65 20  ++){ .    Btree 
6650: 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69  *pBt = db->aDb[i
6660: 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70  ].pBt;.    if( p
6670: 42 74 20 26 26 20 73 71 6c 69 74 65 33 42 74 72  Bt && sqlite3Btr
6680: 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29  eeIsInTrans(pBt)
6690: 20 29 7b 0a 20 20 20 20 20 20 6e 65 65 64 58 63   ){.      needXc
66a0: 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20 20 20 20  ommit = 1;.     
66b0: 20 69 66 28 20 69 21 3d 31 20 29 20 6e 54 72 61   if( i!=1 ) nTra
66c0: 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  ns++;.    }.  }.
66d0: 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 61  .  /* If there a
66e0: 72 65 20 61 6e 79 20 77 72 69 74 65 2d 74 72 61  re any write-tra
66f0: 6e 73 61 63 74 69 6f 6e 73 20 61 74 20 61 6c 6c  nsactions at all
6700: 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 6f 6d  , invoke the com
6710: 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20 20 69 66  mit hook */.  if
6720: 28 20 6e 65 65 64 58 63 6f 6d 6d 69 74 20 26 26  ( needXcommit &&
6730: 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c   db->xCommitCall
6740: 62 61 63 6b 20 29 7b 0a 20 20 20 20 73 71 6c 69  back ){.    sqli
6750: 74 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29  te3SafetyOff(db)
6760: 3b 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 78  ;.    rc = db->x
6770: 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63 6b 28 64  CommitCallback(d
6780: 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67 29 3b 0a  b->pCommitArg);.
6790: 20 20 20 20 73 71 6c 69 74 65 33 53 61 66 65 74      sqlite3Safet
67a0: 79 4f 6e 28 64 62 29 3b 0a 20 20 20 20 69 66 28  yOn(db);.    if(
67b0: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 72 65 74   rc ){.      ret
67c0: 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54  urn SQLITE_CONST
67d0: 52 41 49 4e 54 3b 0a 20 20 20 20 7d 0a 20 20 7d  RAINT;.    }.  }
67e0: 0a 0a 20 20 2f 2a 20 54 68 65 20 73 69 6d 70 6c  ..  /* The simpl
67f0: 65 20 63 61 73 65 20 2d 20 6e 6f 20 6d 6f 72 65  e case - no more
6800: 20 74 68 61 6e 20 6f 6e 65 20 64 61 74 61 62 61   than one databa
6810: 73 65 20 66 69 6c 65 20 28 6e 6f 74 20 63 6f 75  se file (not cou
6820: 6e 74 69 6e 67 20 74 68 65 0a 20 20 2a 2a 20 54  nting the.  ** T
6830: 45 4d 50 20 64 61 74 61 62 61 73 65 29 20 68 61  EMP database) ha
6840: 73 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  s a transaction 
6850: 61 63 74 69 76 65 2e 20 20 20 54 68 65 72 65 20  active.   There 
6860: 69 73 20 6e 6f 20 6e 65 65 64 20 66 6f 72 20 74  is no need for t
6870: 68 65 0a 20 20 2a 2a 20 6d 61 73 74 65 72 2d 6a  he.  ** master-j
6880: 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2a 0a 20 20 2a  ournal..  **.  *
6890: 2a 20 49 66 20 74 68 65 20 72 65 74 75 72 6e 20  * If the return 
68a0: 76 61 6c 75 65 20 6f 66 20 73 71 6c 69 74 65 33  value of sqlite3
68b0: 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65  BtreeGetFilename
68c0: 28 29 20 69 73 20 61 20 7a 65 72 6f 20 6c 65 6e  () is a zero len
68d0: 67 74 68 0a 20 20 2a 2a 20 73 74 72 69 6e 67 2c  gth.  ** string,
68e0: 20 69 74 20 6d 65 61 6e 73 20 74 68 65 20 6d 61   it means the ma
68f0: 69 6e 20 64 61 74 61 62 61 73 65 20 69 73 20 3a  in database is :
6900: 6d 65 6d 6f 72 79 3a 2e 20 20 49 6e 20 74 68 61  memory:.  In tha
6910: 74 20 63 61 73 65 20 77 65 20 64 6f 0a 20 20 2a  t case we do.  *
6920: 2a 20 6e 6f 74 20 73 75 70 70 6f 72 74 20 61 74  * not support at
6930: 6f 6d 69 63 20 6d 75 6c 74 69 2d 66 69 6c 65 20  omic multi-file 
6940: 63 6f 6d 6d 69 74 73 2c 20 73 6f 20 75 73 65 20  commits, so use 
6950: 74 68 65 20 73 69 6d 70 6c 65 20 63 61 73 65 20  the simple case 
6960: 74 68 65 6e 0a 20 20 2a 2a 20 74 6f 6f 2e 0a 20  then.  ** too.. 
6970: 20 2a 2f 0a 20 20 69 66 28 20 30 3d 3d 73 74 72   */.  if( 0==str
6980: 6c 65 6e 28 73 71 6c 69 74 65 33 42 74 72 65 65  len(sqlite3Btree
6990: 47 65 74 46 69 6c 65 6e 61 6d 65 28 64 62 2d 3e  GetFilename(db->
69a0: 61 44 62 5b 30 5d 2e 70 42 74 29 29 20 7c 7c 20  aDb[0].pBt)) || 
69b0: 6e 54 72 61 6e 73 3c 3d 31 20 29 7b 0a 20 20 20  nTrans<=1 ){.   
69c0: 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51   for(i=0; rc==SQ
69d0: 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c 64 62 2d  LITE_OK && i<db-
69e0: 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20  >nDb; i++){ .   
69f0: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20     Btree *pBt = 
6a00: 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a  db->aDb[i].pBt;.
6a10: 20 20 20 20 20 20 69 66 28 20 70 42 74 20 29 7b        if( pBt ){
6a20: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71  .        rc = sq
6a30: 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 28 70  lite3BtreeSync(p
6a40: 42 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a  Bt, 0);.      }.
6a50: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 44 6f      }..    /* Do
6a60: 20 74 68 65 20 63 6f 6d 6d 69 74 20 6f 6e 6c 79   the commit only
6a70: 20 69 66 20 61 6c 6c 20 64 61 74 61 62 61 73 65   if all database
6a80: 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 73  s successfully s
6a90: 79 6e 63 65 64 20 2a 2f 0a 20 20 20 20 69 66 28  ynced */.    if(
6aa0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
6ab0: 7b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b  {.      for(i=0;
6ac0: 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29   i<db->nDb; i++)
6ad0: 7b 0a 20 20 20 20 20 20 20 20 42 74 72 65 65 20  {.        Btree 
6ae0: 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69  *pBt = db->aDb[i
6af0: 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 20 20 69  ].pBt;.        i
6b00: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20  f( pBt ){.      
6b10: 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65      sqlite3Btree
6b20: 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20  Commit(pBt);.   
6b30: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
6b40: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54     }.  }..  /* T
6b50: 68 65 20 63 6f 6d 70 6c 65 78 20 63 61 73 65 20  he complex case 
6b60: 2d 20 54 68 65 72 65 20 69 73 20 61 20 6d 75 6c  - There is a mul
6b70: 74 69 2d 66 69 6c 65 20 77 72 69 74 65 2d 74 72  ti-file write-tr
6b80: 61 6e 73 61 63 74 69 6f 6e 20 61 63 74 69 76 65  ansaction active
6b90: 2e 0a 20 20 2a 2a 20 54 68 69 73 20 72 65 71 75  ..  ** This requ
6ba0: 69 72 65 73 20 61 20 6d 61 73 74 65 72 20 6a 6f  ires a master jo
6bb0: 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f 20 65 6e  urnal file to en
6bc0: 73 75 72 65 20 74 68 65 20 74 72 61 6e 73 61 63  sure the transac
6bd0: 74 69 6f 6e 20 69 73 0a 20 20 2a 2a 20 63 6f 6d  tion is.  ** com
6be0: 6d 69 74 74 65 64 20 61 74 6f 6d 69 63 6c 79 2e  mitted atomicly.
6bf0: 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51  .  */.#ifndef SQ
6c00: 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53 4b 49 4f  LITE_OMIT_DISKIO
6c10: 0a 20 20 65 6c 73 65 7b 0a 20 20 20 20 69 6e 74  .  else{.    int
6c20: 20 6e 65 65 64 53 79 6e 63 20 3d 20 30 3b 0a 20   needSync = 0;. 
6c30: 20 20 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72     char *zMaster
6c40: 20 3d 20 30 3b 20 20 20 2f 2a 20 46 69 6c 65 2d   = 0;   /* File-
6c50: 6e 61 6d 65 20 66 6f 72 20 74 68 65 20 6d 61 73  name for the mas
6c60: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 2a 2f 0a 20  ter journal */. 
6c70: 20 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 7a     char const *z
6c80: 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74  MainFile = sqlit
6c90: 65 33 42 74 72 65 65 47 65 74 46 69 6c 65 6e 61  e3BtreeGetFilena
6ca0: 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42  me(db->aDb[0].pB
6cb0: 74 29 3b 0a 20 20 20 20 4f 73 46 69 6c 65 20 2a  t);.    OsFile *
6cc0: 6d 61 73 74 65 72 20 3d 20 30 3b 0a 0a 20 20 20  master = 0;..   
6cd0: 20 2f 2a 20 53 65 6c 65 63 74 20 61 20 6d 61 73   /* Select a mas
6ce0: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
6cf0: 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20 64 6f 20   name */.    do 
6d00: 7b 0a 20 20 20 20 20 20 75 33 32 20 72 61 6e 64  {.      u32 rand
6d10: 6f 6d 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  om;.      sqlite
6d20: 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20  Free(zMaster);. 
6d30: 20 20 20 20 20 73 71 6c 69 74 65 33 52 61 6e 64       sqlite3Rand
6d40: 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66 28 72 61  omness(sizeof(ra
6d50: 6e 64 6f 6d 29 2c 20 26 72 61 6e 64 6f 6d 29 3b  ndom), &random);
6d60: 0a 20 20 20 20 20 20 7a 4d 61 73 74 65 72 20 3d  .      zMaster =
6d70: 20 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28   sqlite3MPrintf(
6d80: 22 25 73 2d 6d 6a 25 30 38 58 22 2c 20 7a 4d 61  "%s-mj%08X", zMa
6d90: 69 6e 46 69 6c 65 2c 20 72 61 6e 64 6f 6d 26 30  inFile, random&0
6da0: 78 37 66 66 66 66 66 66 66 29 3b 0a 20 20 20 20  x7fffffff);.    
6db0: 20 20 69 66 28 20 21 7a 4d 61 73 74 65 72 20 29    if( !zMaster )
6dc0: 7b 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  {.        return
6dd0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
6de0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 77 68 69 6c       }.    }whil
6df0: 65 28 20 73 71 6c 69 74 65 33 4f 73 46 69 6c 65  e( sqlite3OsFile
6e00: 45 78 69 73 74 73 28 7a 4d 61 73 74 65 72 29 20  Exists(zMaster) 
6e10: 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 70 65 6e 20  );..    /* Open 
6e20: 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e  the master journ
6e30: 61 6c 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20  al. */.    rc = 
6e40: 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63  sqlite3OsOpenExc
6e50: 6c 75 73 69 76 65 28 7a 4d 61 73 74 65 72 2c 20  lusive(zMaster, 
6e60: 26 6d 61 73 74 65 72 2c 20 30 29 3b 0a 20 20 20  &master, 0);.   
6e70: 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f   if( rc!=SQLITE_
6e80: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  OK ){.      sqli
6e90: 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b  teFree(zMaster);
6ea0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63  .      return rc
6eb0: 3b 0a 20 20 20 20 7d 0a 20 0a 20 20 20 20 2f 2a  ;.    }. .    /*
6ec0: 20 57 72 69 74 65 20 74 68 65 20 6e 61 6d 65 20   Write the name 
6ed0: 6f 66 20 65 61 63 68 20 64 61 74 61 62 61 73 65  of each database
6ee0: 20 66 69 6c 65 20 69 6e 20 74 68 65 20 74 72 61   file in the tra
6ef0: 6e 73 61 63 74 69 6f 6e 20 69 6e 74 6f 20 74 68  nsaction into th
6f00: 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20 6d 61 73  e new.    ** mas
6f10: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
6f20: 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f 63  . If an error oc
6f30: 63 75 72 73 20 61 74 20 74 68 69 73 20 70 6f 69  curs at this poi
6f40: 6e 74 20 63 6c 6f 73 65 0a 20 20 20 20 2a 2a 20  nt close.    ** 
6f50: 61 6e 64 20 64 65 6c 65 74 65 20 74 68 65 20 6d  and delete the m
6f60: 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69  aster journal fi
6f70: 6c 65 2e 20 41 6c 6c 20 74 68 65 20 69 6e 64 69  le. All the indi
6f80: 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 20 66  vidual journal f
6f90: 69 6c 65 73 0a 20 20 20 20 2a 2a 20 73 74 69 6c  iles.    ** stil
6fa0: 6c 20 68 61 76 65 20 27 6e 75 6c 6c 27 20 61 73  l have 'null' as
6fb0: 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72   the master jour
6fc0: 6e 61 6c 20 70 6f 69 6e 74 65 72 2c 20 73 6f 20  nal pointer, so 
6fd0: 74 68 65 79 20 77 69 6c 6c 20 72 6f 6c 6c 0a 20  they will roll. 
6fe0: 20 20 20 2a 2a 20 62 61 63 6b 20 69 6e 64 65 70     ** back indep
6ff0: 65 6e 64 65 6e 74 6c 79 20 69 66 20 61 20 66 61  endently if a fa
7000: 69 6c 75 72 65 20 6f 63 63 75 72 73 2e 0a 20 20  ilure occurs..  
7010: 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30    */.    for(i=0
7020: 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b  ; i<db->nDb; i++
7030: 29 7b 20 0a 20 20 20 20 20 20 42 74 72 65 65 20  ){ .      Btree 
7040: 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69  *pBt = db->aDb[i
7050: 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28  ].pBt;.      if(
7060: 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69 6e 75 65   i==1 ) continue
7070: 3b 20 20 20 2f 2a 20 49 67 6e 6f 72 65 20 74 68  ;   /* Ignore th
7080: 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 20  e TEMP database 
7090: 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 42 74  */.      if( pBt
70a0: 20 26 26 20 73 71 6c 69 74 65 33 42 74 72 65 65   && sqlite3Btree
70b0: 49 73 49 6e 54 72 61 6e 73 28 70 42 74 29 20 29  IsInTrans(pBt) )
70c0: 7b 0a 20 20 20 20 20 20 20 20 63 68 61 72 20 63  {.        char c
70d0: 6f 6e 73 74 20 2a 7a 46 69 6c 65 20 3d 20 73 71  onst *zFile = sq
70e0: 6c 69 74 65 33 42 74 72 65 65 47 65 74 4a 6f 75  lite3BtreeGetJou
70f0: 72 6e 61 6c 6e 61 6d 65 28 70 42 74 29 3b 0a 20  rnalname(pBt);. 
7100: 20 20 20 20 20 20 20 69 66 28 20 7a 46 69 6c 65         if( zFile
7110: 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75  [0]==0 ) continu
7120: 65 3b 20 20 2f 2a 20 49 67 6e 6f 72 65 20 3a 6d  e;  /* Ignore :m
7130: 65 6d 6f 72 79 3a 20 64 61 74 61 62 61 73 65 73  emory: databases
7140: 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20   */.        if( 
7150: 21 6e 65 65 64 53 79 6e 63 20 26 26 20 21 73 71  !needSync && !sq
7160: 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63 44 69  lite3BtreeSyncDi
7170: 73 61 62 6c 65 64 28 70 42 74 29 20 29 7b 0a 20  sabled(pBt) ){. 
7180: 20 20 20 20 20 20 20 20 20 6e 65 65 64 53 79 6e           needSyn
7190: 63 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 7d  c = 1;.        }
71a0: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71  .        rc = sq
71b0: 6c 69 74 65 33 4f 73 57 72 69 74 65 28 6d 61 73  lite3OsWrite(mas
71c0: 74 65 72 2c 20 7a 46 69 6c 65 2c 20 73 74 72 6c  ter, zFile, strl
71d0: 65 6e 28 7a 46 69 6c 65 29 2b 31 29 3b 0a 20 20  en(zFile)+1);.  
71e0: 20 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51        if( rc!=SQ
71f0: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20  LITE_OK ){.     
7200: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 43 6c       sqlite3OsCl
7210: 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a 20 20  ose(&master);.  
7220: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f          sqlite3O
7230: 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29  sDelete(zMaster)
7240: 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  ;.          sqli
7250: 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29 3b  teFree(zMaster);
7260: 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72  .          retur
7270: 6e 20 72 63 3b 0a 20 20 20 20 20 20 20 20 7d 0a  n rc;.        }.
7280: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 0a        }.    }...
7290: 20 20 20 20 2f 2a 20 53 79 6e 63 20 74 68 65 20      /* Sync the 
72a0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
72b0: 69 6c 65 2e 20 42 65 66 6f 72 65 20 64 6f 69 6e  ile. Before doin
72c0: 67 20 74 68 69 73 2c 20 6f 70 65 6e 20 74 68 65  g this, open the
72d0: 20 64 69 72 65 63 74 6f 72 79 0a 20 20 20 20 2a   directory.    *
72e0: 2a 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  * the master jou
72f0: 72 6e 61 6c 20 66 69 6c 65 20 69 73 20 73 74 6f  rnal file is sto
7300: 72 65 20 69 6e 20 73 6f 20 74 68 61 74 20 69 74  re in so that it
7310: 20 67 65 74 73 20 73 79 6e 63 65 64 20 74 6f 6f   gets synced too
7320: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 7a 4d 61  ..    */.    zMa
7330: 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69 74 65 33  inFile = sqlite3
7340: 42 74 72 65 65 47 65 74 44 69 72 6e 61 6d 65 28  BtreeGetDirname(
7350: 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 3b  db->aDb[0].pBt);
7360: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
7370: 33 4f 73 4f 70 65 6e 44 69 72 65 63 74 6f 72 79  3OsOpenDirectory
7380: 28 6d 61 73 74 65 72 2c 20 7a 4d 61 69 6e 46 69  (master, zMainFi
7390: 6c 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21  le);.    if( rc!
73a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 0a 20 20  =SQLITE_OK ||.  
73b0: 20 20 20 20 20 20 20 20 28 6e 65 65 64 53 79 6e          (needSyn
73c0: 63 20 26 26 20 28 72 63 3d 73 71 6c 69 74 65 33  c && (rc=sqlite3
73d0: 4f 73 53 79 6e 63 28 6d 61 73 74 65 72 2c 30 29  OsSync(master,0)
73e0: 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 29 20 29 7b  )!=SQLITE_OK) ){
73f0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73  .      sqlite3Os
7400: 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a  Close(&master);.
7410: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 73 44        sqlite3OsD
7420: 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29 3b 0a  elete(zMaster);.
7430: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
7440: 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20  (zMaster);.     
7450: 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20   return rc;.    
7460: 7d 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 61  }..    /* Sync a
7470: 6c 6c 20 74 68 65 20 64 62 20 66 69 6c 65 73 20  ll the db files 
7480: 69 6e 76 6f 6c 76 65 64 20 69 6e 20 74 68 65 20  involved in the 
7490: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 54 68 65  transaction. The
74a0: 20 73 61 6d 65 20 63 61 6c 6c 0a 20 20 20 20 2a   same call.    *
74b0: 2a 20 73 65 74 73 20 74 68 65 20 6d 61 73 74 65  * sets the maste
74c0: 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65  r journal pointe
74d0: 72 20 69 6e 20 65 61 63 68 20 69 6e 64 69 76 69  r in each indivi
74e0: 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 2e 20 49 66  dual journal. If
74f0: 0a 20 20 20 20 2a 2a 20 61 6e 20 65 72 72 6f 72  .    ** an error
7500: 20 6f 63 63 75 72 73 20 68 65 72 65 2c 20 64 6f   occurs here, do
7510: 20 6e 6f 74 20 64 65 6c 65 74 65 20 74 68 65 20   not delete the 
7520: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
7530: 69 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20 20 20 20  ile..    **.    
7540: 2a 2a 20 49 66 20 74 68 65 20 65 72 72 6f 72 20  ** If the error 
7550: 6f 63 63 75 72 73 20 64 75 72 69 6e 67 20 74 68  occurs during th
7560: 65 20 66 69 72 73 74 20 63 61 6c 6c 20 74 6f 20  e first call to 
7570: 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e 63  sqlite3BtreeSync
7580: 28 29 2c 0a 20 20 20 20 2a 2a 20 74 68 65 6e 20  (),.    ** then 
7590: 74 68 65 72 65 20 69 73 20 61 20 63 68 61 6e 63  there is a chanc
75a0: 65 20 74 68 61 74 20 74 68 65 20 6d 61 73 74 65  e that the maste
75b0: 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 77  r journal file w
75c0: 69 6c 6c 20 62 65 0a 20 20 20 20 2a 2a 20 6f 72  ill be.    ** or
75d0: 70 68 61 6e 65 64 2e 20 42 75 74 20 77 65 20 63  phaned. But we c
75e0: 61 6e 6e 6f 74 20 64 65 6c 65 74 65 20 69 74 2c  annot delete it,
75f0: 20 69 6e 20 63 61 73 65 20 74 68 65 20 6d 61 73   in case the mas
7600: 74 65 72 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20  ter journal.    
7610: 2a 2a 20 66 69 6c 65 20 6e 61 6d 65 20 77 61 73  ** file name was
7620: 20 77 72 69 74 74 65 6e 20 69 6e 74 6f 20 74 68   written into th
7630: 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 62  e journal file b
7640: 65 66 6f 72 65 20 74 68 65 20 66 61 69 6c 75 72  efore the failur
7650: 65 0a 20 20 20 20 2a 2a 20 6f 63 63 75 72 65 64  e.    ** occured
7660: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72  ..    */.    for
7670: 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b  (i=0; i<db->nDb;
7680: 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74   i++){ .      Bt
7690: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
76a0: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20  Db[i].pBt;.     
76b0: 20 69 66 28 20 70 42 74 20 26 26 20 73 71 6c 69   if( pBt && sqli
76c0: 74 65 33 42 74 72 65 65 49 73 49 6e 54 72 61 6e  te3BtreeIsInTran
76d0: 73 28 70 42 74 29 20 29 7b 0a 20 20 20 20 20 20  s(pBt) ){.      
76e0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74    rc = sqlite3Bt
76f0: 72 65 65 53 79 6e 63 28 70 42 74 2c 20 7a 4d 61  reeSync(pBt, zMa
7700: 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 69  ster);.        i
7710: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc!=SQLITE_OK
7720: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71   ){.          sq
7730: 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28 26 6d 61  lite3OsClose(&ma
7740: 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20  ster);.         
7750: 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73   sqliteFree(zMas
7760: 74 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20  ter);.          
7770: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20  return rc;.     
7780: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20     }.      }.   
7790: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 4f 73   }.    sqlite3Os
77a0: 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b 0a  Close(&master);.
77b0: 0a 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 20 74  .    /* Delete t
77c0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
77d0: 6c 20 66 69 6c 65 2e 20 54 68 69 73 20 63 6f 6d  l file. This com
77e0: 6d 69 74 73 20 74 68 65 20 74 72 61 6e 73 61 63  mits the transac
77f0: 74 69 6f 6e 2e 20 41 66 74 65 72 0a 20 20 20 20  tion. After.    
7800: 2a 2a 20 64 6f 69 6e 67 20 74 68 69 73 20 74 68  ** doing this th
7810: 65 20 64 69 72 65 63 74 6f 72 79 20 69 73 20 73  e directory is s
7820: 79 6e 63 65 64 20 61 67 61 69 6e 20 62 65 66 6f  ynced again befo
7830: 72 65 20 61 6e 79 20 69 6e 64 69 76 69 64 75 61  re any individua
7840: 6c 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63  l.    ** transac
7850: 74 69 6f 6e 20 66 69 6c 65 73 20 61 72 65 20 64  tion files are d
7860: 65 6c 65 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20  eleted..    */. 
7870: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4f     rc = sqlite3O
7880: 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72 29  sDelete(zMaster)
7890: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 63  ;.    assert( rc
78a0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20  ==SQLITE_OK );. 
78b0: 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a 4d     sqliteFree(zM
78c0: 61 73 74 65 72 29 3b 0a 20 20 20 20 7a 4d 61 73  aster);.    zMas
78d0: 74 65 72 20 3d 20 30 3b 0a 20 20 20 20 72 63 20  ter = 0;.    rc 
78e0: 3d 20 73 71 6c 69 74 65 33 4f 73 53 79 6e 63 44  = sqlite3OsSyncD
78f0: 69 72 65 63 74 6f 72 79 28 7a 4d 61 69 6e 46 69  irectory(zMainFi
7900: 6c 65 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21  le);.    if( rc!
7910: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
7920: 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73 20 6e      /* This is n
7930: 6f 74 20 67 6f 6f 64 2e 20 54 68 65 20 6d 61 73  ot good. The mas
7940: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65  ter journal file
7950: 20 68 61 73 20 62 65 65 6e 20 64 65 6c 65 74 65   has been delete
7960: 64 2c 20 62 75 74 0a 20 20 20 20 20 20 2a 2a 20  d, but.      ** 
7970: 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 73 79  the directory sy
7980: 6e 63 20 66 61 69 6c 65 64 2e 20 54 68 65 72 65  nc failed. There
7990: 20 69 73 20 6e 6f 20 63 6f 6d 70 6c 65 74 65 6c   is no completel
79a0: 79 20 73 61 66 65 20 63 6f 75 72 73 65 20 6f 66  y safe course of
79b0: 0a 20 20 20 20 20 20 2a 2a 20 61 63 74 69 6f 6e  .      ** action
79c0: 20 66 72 6f 6d 20 68 65 72 65 2e 20 54 68 65 20   from here. The 
79d0: 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e  individual journ
79e0: 61 6c 73 20 63 6f 6e 74 61 69 6e 20 74 68 65 20  als contain the 
79f0: 6e 61 6d 65 20 6f 66 20 74 68 65 0a 20 20 20 20  name of the.    
7a00: 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a 6f 75 72    ** master jour
7a10: 6e 61 6c 20 66 69 6c 65 2c 20 62 75 74 20 74 68  nal file, but th
7a20: 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20 6f 66  ere is no way of
7a30: 20 6b 6e 6f 77 69 6e 67 20 69 66 20 74 68 61 74   knowing if that
7a40: 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72  .      ** master
7a50: 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73 74 73 20   journal exists 
7a60: 6e 6f 77 20 6f 72 20 69 66 20 69 74 20 77 69 6c  now or if it wil
7a70: 6c 20 65 78 69 73 74 20 61 66 74 65 72 20 74 68  l exist after th
7a80: 65 20 6f 70 65 72 61 74 69 6e 67 0a 20 20 20 20  e operating.    
7a90: 20 20 2a 2a 20 73 79 73 74 65 6d 20 63 72 61 73    ** system cras
7aa0: 68 20 74 68 61 74 20 6d 61 79 20 66 6f 6c 6c 6f  h that may follo
7ab0: 77 20 74 68 65 20 66 73 79 6e 63 28 29 20 66 61  w the fsync() fa
7ac0: 69 6c 75 72 65 2e 0a 20 20 20 20 20 20 2a 2f 0a  ilure..      */.
7ad0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
7ae0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 41  .    }..    /* A
7af0: 6c 6c 20 66 69 6c 65 73 20 61 6e 64 20 64 69 72  ll files and dir
7b00: 65 63 74 6f 72 69 65 73 20 68 61 76 65 20 61 6c  ectories have al
7b10: 72 65 61 64 79 20 62 65 65 6e 20 73 79 6e 63 65  ready been synce
7b20: 64 2c 20 73 6f 20 74 68 65 20 66 6f 6c 6c 6f 77  d, so the follow
7b30: 69 6e 67 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 73  ing.    ** calls
7b40: 20 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65   to sqlite3Btree
7b50: 43 6f 6d 6d 69 74 28 29 20 61 72 65 20 6f 6e 6c  Commit() are onl
7b60: 79 20 63 6c 6f 73 69 6e 67 20 66 69 6c 65 73 20  y closing files 
7b70: 61 6e 64 20 64 65 6c 65 74 69 6e 67 0a 20 20 20  and deleting.   
7b80: 20 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e 20 49 66   ** journals. If
7b90: 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f 65 73 20   something goes 
7ba0: 77 72 6f 6e 67 20 77 68 69 6c 65 20 74 68 69 73  wrong while this
7bb0: 20 69 73 20 68 61 70 70 65 6e 69 6e 67 20 77 65   is happening we
7bc0: 20 64 6f 6e 27 74 0a 20 20 20 20 2a 2a 20 72 65   don't.    ** re
7bd0: 61 6c 6c 79 20 63 61 72 65 2e 20 54 68 65 20 69  ally care. The i
7be0: 6e 74 65 67 72 69 74 79 20 6f 66 20 74 68 65 20  ntegrity of the 
7bf0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 61  transaction is a
7c00: 6c 72 65 61 64 79 20 67 75 61 72 61 6e 74 65 65  lready guarantee
7c10: 64 2c 0a 20 20 20 20 2a 2a 20 62 75 74 20 73 6f  d,.    ** but so
7c20: 6d 65 20 73 74 72 61 79 20 27 63 6f 6c 64 27 20  me stray 'cold' 
7c30: 6a 6f 75 72 6e 61 6c 73 20 6d 61 79 20 62 65 20  journals may be 
7c40: 6c 79 69 6e 67 20 61 72 6f 75 6e 64 2e 20 52 65  lying around. Re
7c50: 74 75 72 6e 69 6e 67 20 61 6e 0a 20 20 20 20 2a  turning an.    *
7c60: 2a 20 65 72 72 6f 72 20 63 6f 64 65 20 77 6f 6e  * error code won
7c70: 27 74 20 68 65 6c 70 20 6d 61 74 74 65 72 73 2e  't help matters.
7c80: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28  .    */.    for(
7c90: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
7ca0: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72  i++){ .      Btr
7cb0: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
7cc0: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
7cd0: 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20  if( pBt ){.     
7ce0: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 43     sqlite3BtreeC
7cf0: 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20 20 20 20  ommit(pBt);.    
7d00: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65    }.    }.  }.#e
7d10: 6e 64 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 72  ndif..  return r
7d20: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 69 6e 64  c;.}../*.** Find
7d30: 20 65 76 65 72 79 20 61 63 74 69 76 65 20 56 4d   every active VM
7d40: 20 6f 74 68 65 72 20 74 68 61 6e 20 70 56 64 62   other than pVdb
7d50: 65 20 61 6e 64 20 63 68 61 6e 67 65 20 69 74 73  e and change its
7d60: 20 73 74 61 74 75 73 20 74 6f 0a 2a 2a 20 61 62   status to.** ab
7d70: 6f 72 74 65 64 2e 20 20 54 68 69 73 20 68 61 70  orted.  This hap
7d80: 70 65 6e 73 20 77 68 65 6e 20 6f 6e 65 20 56 4d  pens when one VM
7d90: 20 63 61 75 73 65 73 20 61 20 72 6f 6c 6c 62 61   causes a rollba
7da0: 63 6b 20 64 75 65 20 74 6f 20 61 6e 0a 2a 2a 20  ck due to an.** 
7db0: 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 52 4f 4c 4c  ON CONFLICT ROLL
7dc0: 42 41 43 4b 20 63 6c 61 75 73 65 20 28 66 6f 72  BACK clause (for
7dd0: 20 65 78 61 6d 70 6c 65 29 2e 20 20 54 68 65 20   example).  The 
7de0: 6f 74 68 65 72 20 56 4d 73 20 6d 75 73 74 20 62  other VMs must b
7df0: 65 0a 2a 2a 20 61 62 6f 72 74 65 64 20 73 6f 20  e.** aborted so 
7e00: 74 68 61 74 20 74 68 65 79 20 64 6f 20 6e 6f 74  that they do not
7e10: 20 68 61 76 65 20 64 61 74 61 20 72 6f 6c 6c 65   have data rolle
7e20: 64 20 6f 75 74 20 66 72 6f 6d 20 75 6e 64 65 72  d out from under
7e30: 6e 65 61 74 68 0a 2a 2a 20 74 68 65 6d 20 6c 65  neath.** them le
7e40: 61 64 69 6e 67 20 74 6f 20 61 20 73 65 67 66 61  ading to a segfa
7e50: 75 6c 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  ult..*/.static v
7e60: 6f 69 64 20 61 62 6f 72 74 4f 74 68 65 72 41 63  oid abortOtherAc
7e70: 74 69 76 65 56 64 62 65 73 28 56 64 62 65 20 2a  tiveVdbes(Vdbe *
7e80: 70 56 64 62 65 29 7b 0a 20 20 56 64 62 65 20 2a  pVdbe){.  Vdbe *
7e90: 70 4f 74 68 65 72 3b 0a 20 20 66 6f 72 28 70 4f  pOther;.  for(pO
7ea0: 74 68 65 72 3d 70 56 64 62 65 2d 3e 64 62 2d 3e  ther=pVdbe->db->
7eb0: 70 56 64 62 65 3b 20 70 4f 74 68 65 72 3b 20 70  pVdbe; pOther; p
7ec0: 4f 74 68 65 72 3d 70 4f 74 68 65 72 2d 3e 70 4e  Other=pOther->pN
7ed0: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 4f  ext){.    if( pO
7ee0: 74 68 65 72 3d 3d 70 56 64 62 65 20 29 20 63 6f  ther==pVdbe ) co
7ef0: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20  ntinue;.    if( 
7f00: 70 4f 74 68 65 72 2d 3e 6d 61 67 69 63 21 3d 56  pOther->magic!=V
7f10: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 7c 7c  DBE_MAGIC_RUN ||
7f20: 20 70 4f 74 68 65 72 2d 3e 70 63 3c 30 20 29 20   pOther->pc<0 ) 
7f30: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 63 6c  continue;.    cl
7f40: 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73 28 70 4f  oseAllCursors(pO
7f50: 74 68 65 72 29 3b 0a 20 20 20 20 70 4f 74 68 65  ther);.    pOthe
7f60: 72 2d 3e 61 62 6f 72 74 65 64 20 3d 20 31 3b 0a  r->aborted = 1;.
7f70: 20 20 7d 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 54 68    }.}../* .** Th
7f80: 69 73 20 72 6f 75 74 69 6e 65 20 63 68 65 63 6b  is routine check
7f90: 73 20 74 68 61 74 20 74 68 65 20 73 71 6c 69 74  s that the sqlit
7fa0: 65 33 2e 61 63 74 69 76 65 56 64 62 65 43 6e 74  e3.activeVdbeCnt
7fb0: 20 63 6f 75 6e 74 20 76 61 72 69 61 62 6c 65 0a   count variable.
7fc0: 2a 2a 20 6d 61 74 63 68 65 73 20 74 68 65 20 6e  ** matches the n
7fd0: 75 6d 62 65 72 20 6f 66 20 76 64 62 65 27 73 20  umber of vdbe's 
7fe0: 69 6e 20 74 68 65 20 6c 69 73 74 20 73 71 6c 69  in the list sqli
7ff0: 74 65 33 2e 70 56 64 62 65 20 74 68 61 74 20 61  te3.pVdbe that a
8000: 72 65 0a 2a 2a 20 63 75 72 72 65 6e 74 6c 79 20  re.** currently 
8010: 61 63 74 69 76 65 2e 20 41 6e 20 61 73 73 65 72  active. An asser
8020: 74 69 6f 6e 20 66 61 69 6c 73 20 69 66 20 74 68  tion fails if th
8030: 65 20 74 77 6f 20 63 6f 75 6e 74 73 20 64 6f 20  e two counts do 
8040: 6e 6f 74 20 6d 61 74 63 68 2e 0a 2a 2a 20 54 68  not match..** Th
8050: 69 73 20 69 73 20 61 6e 20 69 6e 74 65 72 6e 61  is is an interna
8060: 6c 20 73 65 6c 66 2d 63 68 65 63 6b 20 6f 6e 6c  l self-check onl
8070: 79 20 2d 20 69 74 20 69 73 20 6e 6f 74 20 61 6e  y - it is not an
8080: 20 65 73 73 65 6e 74 69 61 6c 20 70 72 6f 63 65   essential proce
8090: 73 73 69 6e 67 0a 2a 2a 20 73 74 65 70 2e 0a 2a  ssing.** step..*
80a0: 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 61 20 6e  *.** This is a n
80b0: 6f 2d 6f 70 20 69 66 20 4e 44 45 42 55 47 20 69  o-op if NDEBUG i
80c0: 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f 0a 23 69  s defined..*/.#i
80d0: 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 73 74 61  fndef NDEBUG.sta
80e0: 74 69 63 20 76 6f 69 64 20 63 68 65 63 6b 41 63  tic void checkAc
80f0: 74 69 76 65 56 64 62 65 43 6e 74 28 73 71 6c 69  tiveVdbeCnt(sqli
8100: 74 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65  te3 *db){.  Vdbe
8110: 20 2a 70 3b 0a 20 20 69 6e 74 20 63 6e 74 20 3d   *p;.  int cnt =
8120: 20 30 3b 0a 20 20 70 20 3d 20 64 62 2d 3e 70 56   0;.  p = db->pV
8130: 64 62 65 3b 0a 20 20 77 68 69 6c 65 28 20 70 20  dbe;.  while( p 
8140: 29 7b 0a 20 20 20 20 69 66 28 20 70 2d 3e 6d 61  ){.    if( p->ma
8150: 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic==VDBE_MAGIC_
8160: 52 55 4e 20 26 26 20 70 2d 3e 70 63 3e 3d 30 20  RUN && p->pc>=0 
8170: 29 7b 0a 20 20 20 20 20 20 63 6e 74 2b 2b 3b 0a  ){.      cnt++;.
8180: 20 20 20 20 7d 0a 20 20 20 20 70 20 3d 20 70 2d      }.    p = p-
8190: 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 61 73  >pNext;.  }.  as
81a0: 73 65 72 74 28 20 63 6e 74 3d 3d 64 62 2d 3e 61  sert( cnt==db->a
81b0: 63 74 69 76 65 56 64 62 65 43 6e 74 20 29 3b 0a  ctiveVdbeCnt );.
81c0: 7d 0a 23 65 6c 73 65 0a 23 64 65 66 69 6e 65 20  }.#else.#define 
81d0: 63 68 65 63 6b 41 63 74 69 76 65 56 64 62 65 43  checkActiveVdbeC
81e0: 6e 74 28 78 29 0a 23 65 6e 64 69 66 0a 0a 2f 2a  nt(x).#endif../*
81f0: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
8200: 20 69 73 20 63 61 6c 6c 65 64 20 74 68 65 20 77   is called the w
8210: 68 65 6e 20 61 20 56 44 42 45 20 74 72 69 65 73  hen a VDBE tries
8220: 20 74 6f 20 68 61 6c 74 2e 20 20 49 66 20 74 68   to halt.  If th
8230: 65 20 56 44 42 45 0a 2a 2a 20 68 61 73 20 6d 61  e VDBE.** has ma
8240: 64 65 20 63 68 61 6e 67 65 73 20 61 6e 64 20 69  de changes and i
8250: 73 20 69 6e 20 61 75 74 6f 63 6f 6d 6d 69 74 20  s in autocommit 
8260: 6d 6f 64 65 2c 20 74 68 65 6e 20 63 6f 6d 6d 69  mode, then commi
8270: 74 20 74 68 6f 73 65 0a 2a 2a 20 63 68 61 6e 67  t those.** chang
8280: 65 73 2e 20 20 49 66 20 61 20 72 6f 6c 6c 62 61  es.  If a rollba
8290: 63 6b 20 69 73 20 6e 65 65 64 65 64 2c 20 74 68  ck is needed, th
82a0: 65 6e 20 64 6f 20 74 68 65 20 72 6f 6c 6c 62 61  en do the rollba
82b0: 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  ck..**.** This r
82c0: 6f 75 74 69 6e 65 20 69 73 20 74 68 65 20 6f 6e  outine is the on
82d0: 6c 79 20 77 61 79 20 74 6f 20 6d 6f 76 65 20 74  ly way to move t
82e0: 68 65 20 73 74 61 74 65 20 6f 66 20 61 20 56 4d  he state of a VM
82f0: 20 66 72 6f 6d 0a 2a 2a 20 53 51 4c 49 54 45 5f   from.** SQLITE_
8300: 4d 41 47 49 43 5f 52 55 4e 20 74 6f 20 53 51 4c  MAGIC_RUN to SQL
8310: 49 54 45 5f 4d 41 47 49 43 5f 48 41 4c 54 2e 0a  ITE_MAGIC_HALT..
8320: 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 61 6e 20  **.** Return an 
8330: 65 72 72 6f 72 20 63 6f 64 65 2e 20 20 49 66 20  error code.  If 
8340: 74 68 65 20 63 6f 6d 6d 69 74 20 63 6f 75 6c 64  the commit could
8350: 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65 20 62 65   not complete be
8360: 63 61 75 73 65 20 6f 66 0a 2a 2a 20 6c 6f 63 6b  cause of.** lock
8370: 20 63 6f 6e 74 65 6e 74 69 6f 6e 2c 20 72 65 74   contention, ret
8380: 75 72 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 2e  urn SQLITE_BUSY.
8390: 20 20 49 66 20 53 51 4c 49 54 45 5f 42 55 53 59    If SQLITE_BUSY
83a0: 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20 69 74   is returned, it
83b0: 0a 2a 2a 20 6d 65 61 6e 73 20 74 68 65 20 63 6c  .** means the cl
83c0: 6f 73 65 20 64 69 64 20 6e 6f 74 20 68 61 70 70  ose did not happ
83d0: 65 6e 20 61 6e 64 20 6e 65 65 64 73 20 74 6f 20  en and needs to 
83e0: 62 65 20 72 65 70 65 61 74 65 64 2e 0a 2a 2f 0a  be repeated..*/.
83f0: 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 48  int sqlite3VdbeH
8400: 61 6c 74 28 56 64 62 65 20 2a 70 29 7b 0a 20 20  alt(Vdbe *p){.  
8410: 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 2d  sqlite3 *db = p-
8420: 3e 64 62 3b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  >db;.  int i;.  
8430: 69 6e 74 20 28 2a 78 46 75 6e 63 29 28 42 74 72  int (*xFunc)(Btr
8440: 65 65 20 2a 70 42 74 29 20 3d 20 30 3b 20 20 2f  ee *pBt) = 0;  /
8450: 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f 20 63 61  * Function to ca
8460: 6c 6c 20 6f 6e 20 65 61 63 68 20 62 74 72 65 65  ll on each btree
8470: 20 62 61 63 6b 65 6e 64 20 2a 2f 0a 0a 20 20 69   backend */..  i
8480: 66 28 20 73 71 6c 69 74 65 33 54 68 72 65 61 64  f( sqlite3Thread
8490: 44 61 74 61 52 65 61 64 4f 6e 6c 79 28 29 2d 3e  DataReadOnly()->
84a0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a  mallocFailed ){.
84b0: 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51 4c 49      p->rc = SQLI
84c0: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 0a 20  TE_NOMEM;.  }.. 
84d0: 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d 56   if( p->magic!=V
84e0: 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29 7b  DBE_MAGIC_RUN ){
84f0: 0a 20 20 20 20 2f 2a 20 41 6c 72 65 61 64 79 20  .    /* Already 
8500: 68 61 6c 74 65 64 2e 20 20 4e 6f 74 68 69 6e 67  halted.  Nothing
8510: 20 74 6f 20 64 6f 2e 20 2a 2f 0a 20 20 20 20 61   to do. */.    a
8520: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
8530: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54  =VDBE_MAGIC_HALT
8540: 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   );.    return S
8550: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20  QLITE_OK;.  }.  
8560: 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73 28  closeAllCursors(
8570: 70 29 3b 0a 20 20 63 68 65 63 6b 41 63 74 69 76  p);.  checkActiv
8580: 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 20 20  eVdbeCnt(db);.  
8590: 69 66 28 20 70 2d 3e 70 63 3c 30 20 29 7b 0a 20  if( p->pc<0 ){. 
85a0: 20 20 20 2f 2a 20 4e 6f 20 63 6f 6d 6d 69 74 20     /* No commit 
85b0: 6f 72 20 72 6f 6c 6c 62 61 63 6b 20 6e 65 65 64  or rollback need
85c0: 65 64 20 69 66 20 74 68 65 20 70 72 6f 67 72 61  ed if the progra
85d0: 6d 20 6e 65 76 65 72 20 73 74 61 72 74 65 64 20  m never started 
85e0: 2a 2f 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64  */.  }else if( d
85f0: 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 26 26  b->autoCommit &&
8600: 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43   db->activeVdbeC
8610: 6e 74 3d 3d 31 20 29 7b 0a 0a 20 20 20 20 69 66  nt==1 ){..    if
8620: 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f  ( p->rc==SQLITE_
8630: 4f 4b 20 7c 7c 20 28 70 2d 3e 65 72 72 6f 72 41  OK || (p->errorA
8640: 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20 26  ction==OE_Fail &
8650: 26 20 70 2d 3e 72 63 21 3d 53 51 4c 49 54 45 5f  & p->rc!=SQLITE_
8660: 4e 4f 4d 45 4d 29 29 7b 0a 20 20 20 20 20 20 2f  NOMEM)){.      /
8670: 2a 20 54 68 65 20 61 75 74 6f 2d 63 6f 6d 6d 69  * The auto-commi
8680: 74 20 66 6c 61 67 20 69 73 20 74 72 75 65 2c 20  t flag is true, 
8690: 74 68 65 72 65 20 61 72 65 20 6e 6f 20 6f 74 68  there are no oth
86a0: 65 72 20 61 63 74 69 76 65 20 71 75 65 72 69 65  er active querie
86b0: 73 0a 20 20 20 20 20 20 2a 2a 20 75 73 69 6e 67  s.      ** using
86c0: 20 74 68 69 73 20 68 61 6e 64 6c 65 20 61 6e 64   this handle and
86d0: 20 74 68 65 20 76 64 62 65 20 70 72 6f 67 72 61   the vdbe progra
86e0: 6d 20 77 61 73 20 73 75 63 63 65 73 73 66 75 6c  m was successful
86f0: 20 6f 72 20 68 69 74 20 61 6e 0a 20 20 20 20 20   or hit an.     
8700: 20 2a 2a 20 27 4f 52 20 46 41 49 4c 27 20 63 6f   ** 'OR FAIL' co
8710: 6e 73 74 72 61 69 6e 74 2e 20 54 68 69 73 20 6d  nstraint. This m
8720: 65 61 6e 73 20 61 20 63 6f 6d 6d 69 74 20 69 73  eans a commit is
8730: 20 72 65 71 75 69 72 65 64 2e 0a 20 20 20 20 20   required..     
8740: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 72 63   */.      int rc
8750: 20 3d 20 76 64 62 65 43 6f 6d 6d 69 74 28 64 62   = vdbeCommit(db
8760: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d  );.      if( rc=
8770: 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a  =SQLITE_BUSY ){.
8780: 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 53          return S
8790: 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20 20 20 20  QLITE_BUSY;.    
87a0: 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d    }else if( rc!=
87b0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
87c0: 20 20 20 20 20 70 2d 3e 72 63 20 3d 20 72 63 3b       p->rc = rc;
87d0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
87e0: 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29 3b  RollbackAll(db);
87f0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  .      }else{.  
8800: 20 20 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6d        sqlite3Com
8810: 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67  mitInternalChang
8820: 65 73 28 64 62 29 3b 0a 20 20 20 20 20 20 7d 0a  es(db);.      }.
8830: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
8840: 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b   sqlite3Rollback
8850: 41 6c 6c 28 64 62 29 3b 0a 20 20 20 20 7d 0a 20  All(db);.    }. 
8860: 20 7d 65 6c 73 65 7b 0a 0a 20 20 20 20 69 66 28   }else{..    if(
8870: 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 4e   p->rc==SQLITE_N
8880: 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 2f 2a  OMEM ){.      /*
8890: 20 54 68 69 73 20 6c 6f 6f 70 20 64 6f 65 73 20   This loop does 
88a0: 73 74 61 74 69 63 20 61 6e 61 6c 79 73 69 73 20  static analysis 
88b0: 6f 66 20 74 68 65 20 71 75 65 72 79 20 74 6f 20  of the query to 
88c0: 73 65 65 20 77 68 69 63 68 20 6f 66 20 74 68 65  see which of the
88d0: 0a 20 20 20 20 20 20 2a 2a 20 66 6f 6c 6c 6f 77  .      ** follow
88e0: 69 6e 67 20 74 68 72 65 65 20 63 61 74 65 67 6f  ing three catego
88f0: 72 69 65 73 20 69 74 20 66 61 6c 6c 73 20 69 6e  ries it falls in
8900: 74 6f 3a 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20  to:.      **.   
8910: 20 20 20 2a 2a 20 20 20 20 20 52 65 61 64 2d 6f     **     Read-o
8920: 6e 6c 79 0a 20 20 20 20 20 20 2a 2a 20 20 20 20  nly.      **    
8930: 20 51 75 65 72 79 20 77 69 74 68 20 73 74 61 74   Query with stat
8940: 65 6d 65 6e 74 20 6a 6f 75 72 6e 61 6c 20 20 20  ement journal   
8950: 20 20 20 20 20 20 20 2d 3e 20 72 6f 6c 6c 62 61         -> rollba
8960: 63 6b 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 20  ck statement.   
8970: 20 20 20 2a 2a 20 20 20 20 20 51 75 65 72 79 20     **     Query 
8980: 77 69 74 68 6f 75 74 20 73 74 61 74 65 6d 65 6e  without statemen
8990: 74 20 6a 6f 75 72 6e 61 6c 20 20 20 20 20 20 20  t journal       
89a0: 2d 3e 20 72 6f 6c 6c 62 61 63 6b 20 74 72 61 6e  -> rollback tran
89b0: 73 61 63 74 69 6f 6e 0a 20 20 20 20 20 20 2a 2a  saction.      **
89c0: 0a 20 20 20 20 20 20 2a 2a 20 57 65 20 63 6f 75  .      ** We cou
89d0: 6c 64 20 64 6f 20 73 6f 6d 65 74 68 69 6e 67 20  ld do something 
89e0: 6d 6f 72 65 20 65 6c 65 67 61 6e 74 20 74 68 61  more elegant tha
89f0: 6e 20 74 68 69 73 20 73 74 61 74 69 63 20 61 6e  n this static an
8a00: 61 6c 79 73 69 73 20 28 69 2e 65 2e 0a 20 20 20  alysis (i.e..   
8a10: 20 20 20 2a 2a 20 73 74 6f 72 65 20 74 68 65 20     ** store the 
8a20: 74 79 70 65 20 6f 66 20 71 75 65 72 79 20 61 73  type of query as
8a30: 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6d   part of the com
8a40: 70 6c 69 61 74 69 6f 6e 20 70 68 61 73 65 29 2c  pliation phase),
8a50: 20 62 75 74 20 0a 20 20 20 20 20 20 2a 2a 20 68   but .      ** h
8a60: 61 6e 64 6c 69 6e 67 20 6d 61 6c 6c 6f 63 28 29  andling malloc()
8a70: 20 66 61 69 6c 75 72 65 20 69 73 20 61 20 66 61   failure is a fa
8a80: 69 72 6c 79 20 6f 62 73 63 75 72 65 20 65 64 67  irly obscure edg
8a90: 65 20 63 61 73 65 20 73 6f 20 74 68 69 73 20 69  e case so this i
8aa0: 73 0a 20 20 20 20 20 20 2a 2a 20 70 72 6f 62 61  s.      ** proba
8ab0: 62 6c 79 20 65 61 73 69 65 72 2e 0a 20 20 20 20  bly easier..    
8ac0: 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 54 6f    **.      ** To
8ad0: 64 6f 3a 20 54 68 69 73 20 6d 65 61 6e 73 20 77  do: This means w
8ae0: 65 20 61 6c 77 61 79 73 20 6f 76 65 72 72 69 64  e always overrid
8af0: 65 20 74 68 65 20 70 2d 3e 65 72 72 6f 72 41 63  e the p->errorAc
8b00: 74 69 6f 6e 20 76 61 6c 75 65 20 66 6f 72 20 61  tion value for a
8b10: 0a 20 20 20 20 20 20 2a 2a 20 6d 61 6c 6c 6f 63  .      ** malloc
8b20: 28 29 20 66 61 69 6c 75 72 65 2e 20 49 73 20 74  () failure. Is t
8b30: 68 65 72 65 20 61 6e 79 20 6f 74 68 65 72 20 63  here any other c
8b40: 68 6f 69 63 65 20 68 65 72 65 20 74 68 6f 75 67  hoice here thoug
8b50: 68 3f 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20  h?.      */.    
8b60: 20 20 69 6e 74 20 69 73 52 65 61 64 4f 6e 6c 79    int isReadOnly
8b70: 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 6e 74 20   = 1;.      int 
8b80: 69 73 53 74 61 74 65 6d 65 6e 74 20 3d 20 30 3b  isStatement = 0;
8b90: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 70 2d  .      assert(p-
8ba0: 3e 61 4f 70 20 7c 7c 20 70 2d 3e 6e 4f 70 3d 3d  >aOp || p->nOp==
8bb0: 30 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d  0);.      for(i=
8bc0: 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b  0; i<p->nOp; i++
8bd0: 29 7b 20 0a 20 20 20 20 20 20 20 20 73 77 69 74  ){ .        swit
8be0: 63 68 28 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f 70  ch( p->aOp[i].op
8bf0: 63 6f 64 65 20 29 7b 0a 20 20 20 20 20 20 20 20  code ){.        
8c00: 20 20 63 61 73 65 20 4f 50 5f 54 72 61 6e 73 61    case OP_Transa
8c10: 63 74 69 6f 6e 3a 0a 20 20 20 20 20 20 20 20 20  ction:.         
8c20: 20 20 20 69 73 52 65 61 64 4f 6e 6c 79 20 3d 20     isReadOnly = 
8c30: 30 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 62  0;.            b
8c40: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20  reak;.          
8c50: 63 61 73 65 20 4f 50 5f 53 74 61 74 65 6d 65 6e  case OP_Statemen
8c60: 74 3a 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  t:.            i
8c70: 73 53 74 61 74 65 6d 65 6e 74 20 3d 20 31 3b 0a  sStatement = 1;.
8c80: 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61              brea
8c90: 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  k;.        }.   
8ca0: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 28     }.      if( (
8cb0: 69 73 52 65 61 64 4f 6e 6c 79 7c 7c 69 73 53 74  isReadOnly||isSt
8cc0: 61 74 65 6d 65 6e 74 29 20 26 26 20 70 2d 3e 65  atement) && p->e
8cd0: 72 72 6f 72 41 63 74 69 6f 6e 21 3d 4f 45 5f 52  rrorAction!=OE_R
8ce0: 6f 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 20  ollback ){.     
8cf0: 20 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69 6f     p->errorActio
8d00: 6e 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20 20  n = OE_Abort;.  
8d10: 20 20 20 20 7d 65 6c 73 65 7b 20 0a 20 20 20 20      }else{ .    
8d20: 20 20 20 20 70 2d 3e 65 72 72 6f 72 41 63 74 69      p->errorActi
8d30: 6f 6e 20 3d 20 4f 45 5f 52 6f 6c 6c 62 61 63 6b  on = OE_Rollback
8d40: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
8d50: 0a 20 20 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d  .    if( p->rc==
8d60: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e  SQLITE_OK || p->
8d70: 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f  errorAction==OE_
8d80: 46 61 69 6c 20 29 7b 0a 20 20 20 20 20 20 78 46  Fail ){.      xF
8d90: 75 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72  unc = sqlite3Btr
8da0: 65 65 43 6f 6d 6d 69 74 53 74 6d 74 3b 0a 20 20  eeCommitStmt;.  
8db0: 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 65    }else if( p->e
8dc0: 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 41  rrorAction==OE_A
8dd0: 62 6f 72 74 20 29 7b 0a 20 20 20 20 20 20 78 46  bort ){.      xF
8de0: 75 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72  unc = sqlite3Btr
8df0: 65 65 52 6f 6c 6c 62 61 63 6b 53 74 6d 74 3b 0a  eeRollbackStmt;.
8e00: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
8e10: 20 61 62 6f 72 74 4f 74 68 65 72 41 63 74 69 76   abortOtherActiv
8e20: 65 56 64 62 65 73 28 70 29 3b 0a 20 20 20 20 20  eVdbes(p);.     
8e30: 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63 6b   sqlite3Rollback
8e40: 41 6c 6c 28 64 62 29 3b 0a 20 20 20 20 20 20 64  All(db);.      d
8e50: 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 3d 20  b->autoCommit = 
8e60: 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20  1;.    }.  }..  
8e70: 2f 2a 20 49 66 20 78 46 75 6e 63 20 69 73 20 6e  /* If xFunc is n
8e80: 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 69 74  ot NULL, then it
8e90: 20 69 73 20 6f 6e 65 20 6f 66 20 0a 20 20 2a 2a   is one of .  **
8ea0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 52 6f 6c   sqlite3BtreeRol
8eb0: 6c 62 61 63 6b 53 74 6d 74 20 6f 72 20 73 71 6c  lbackStmt or sql
8ec0: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53  ite3BtreeCommitS
8ed0: 74 6d 74 2e 20 43 61 6c 6c 20 69 74 20 6f 6e 63  tmt. Call it onc
8ee0: 65 20 6f 6e 0a 20 20 2a 2a 20 65 61 63 68 20 62  e on.  ** each b
8ef0: 61 63 6b 65 6e 64 2e 20 49 66 20 61 6e 20 65 72  ackend. If an er
8f00: 72 6f 72 20 6f 63 63 75 72 73 20 61 6e 64 20 74  ror occurs and t
8f10: 68 65 20 72 65 74 75 72 6e 20 63 6f 64 65 20 69  he return code i
8f20: 73 20 73 74 69 6c 6c 0a 20 20 2a 2a 20 53 51 4c  s still.  ** SQL
8f30: 49 54 45 5f 4f 4b 2c 20 73 65 74 20 74 68 65 20  ITE_OK, set the 
8f40: 72 65 74 75 72 6e 20 63 6f 64 65 20 74 6f 20 74  return code to t
8f50: 68 65 20 6e 65 77 20 65 72 72 6f 72 20 76 61 6c  he new error val
8f60: 75 65 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72  ue..  */.  asser
8f70: 74 28 21 78 46 75 6e 63 20 7c 7c 0a 20 20 20 20  t(!xFunc ||.    
8f80: 78 46 75 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74  xFunc==sqlite3Bt
8f90: 72 65 65 43 6f 6d 6d 69 74 53 74 6d 74 20 7c 7c  reeCommitStmt ||
8fa0: 0a 20 20 20 20 78 46 75 6e 63 3d 3d 73 71 6c 69  .    xFunc==sqli
8fb0: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
8fc0: 53 74 6d 74 0a 20 20 29 3b 0a 20 20 66 6f 72 28  Stmt.  );.  for(
8fd0: 69 3d 30 3b 20 78 46 75 6e 63 20 26 26 20 69 3c  i=0; xFunc && i<
8fe0: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a  db->nDb; i++){ .
8ff0: 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20      int rc;.    
9000: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
9010: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
9020: 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20   if( pBt ){.    
9030: 20 20 72 63 20 3d 20 78 46 75 6e 63 28 70 42 74    rc = xFunc(pBt
9040: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 2d 3e  );.      if( p->
9050: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc==SQLITE_OK ) 
9060: 70 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20  p->rc = rc;.    
9070: 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74  }.  }..  /* If t
9080: 68 69 73 20 77 61 73 20 61 6e 20 49 4e 53 45 52  his was an INSER
9090: 54 2c 20 55 50 44 41 54 45 20 6f 72 20 44 45 4c  T, UPDATE or DEL
90a0: 45 54 45 2c 20 73 65 74 20 74 68 65 20 63 68 61  ETE, set the cha
90b0: 6e 67 65 20 63 6f 75 6e 74 65 72 2e 20 2a 2f 0a  nge counter. */.
90c0: 20 20 69 66 28 20 70 2d 3e 63 68 61 6e 67 65 43    if( p->changeC
90d0: 6e 74 4f 6e 20 26 26 20 70 2d 3e 70 63 3e 3d 30  ntOn && p->pc>=0
90e0: 20 29 7b 0a 20 20 20 20 69 66 28 20 21 78 46 75   ){.    if( !xFu
90f0: 6e 63 20 7c 7c 20 78 46 75 6e 63 3d 3d 73 71 6c  nc || xFunc==sql
9100: 69 74 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 53  ite3BtreeCommitS
9110: 74 6d 74 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  tmt ){.      sql
9120: 69 74 65 33 56 64 62 65 53 65 74 43 68 61 6e 67  ite3VdbeSetChang
9130: 65 73 28 64 62 2c 20 70 2d 3e 6e 43 68 61 6e 67  es(db, p->nChang
9140: 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  e);.    }else{. 
9150: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
9160: 53 65 74 43 68 61 6e 67 65 73 28 64 62 2c 20 30  SetChanges(db, 0
9170: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 2d 3e  );.    }.    p->
9180: 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20 7d  nChange = 0;.  }
9190: 0a 0a 20 20 2f 2a 20 52 6f 6c 6c 62 61 63 6b 20  ..  /* Rollback 
91a0: 6f 72 20 63 6f 6d 6d 69 74 20 61 6e 79 20 73 63  or commit any sc
91b0: 68 65 6d 61 20 63 68 61 6e 67 65 73 20 74 68 61  hema changes tha
91c0: 74 20 6f 63 63 75 72 72 65 64 2e 20 2a 2f 0a 20  t occurred. */. 
91d0: 20 69 66 28 20 70 2d 3e 72 63 21 3d 53 51 4c 49   if( p->rc!=SQLI
91e0: 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 66 6c 61  TE_OK && db->fla
91f0: 67 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e  gs&SQLITE_Intern
9200: 43 68 61 6e 67 65 73 20 29 7b 0a 20 20 20 20 73  Changes ){.    s
9210: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72  qlite3ResetInter
9220: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 30 29  nalSchema(db, 0)
9230: 3b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20  ;.    db->flags 
9240: 3d 20 28 64 62 2d 3e 66 6c 61 67 73 20 7c 20 53  = (db->flags | S
9250: 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e  QLITE_InternChan
9260: 67 65 73 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  ges);.  }..  /* 
9270: 57 65 20 68 61 76 65 20 73 75 63 63 65 73 73 66  We have successf
9280: 75 6c 6c 79 20 68 61 6c 74 65 64 20 61 6e 64 20  ully halted and 
9290: 63 6c 6f 73 65 64 20 74 68 65 20 56 4d 2e 20 20  closed the VM.  
92a0: 52 65 63 6f 72 64 20 74 68 69 73 20 66 61 63 74  Record this fact
92b0: 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63  . */.  if( p->pc
92c0: 3e 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d 3e 61  >=0 ){.    db->a
92d0: 63 74 69 76 65 56 64 62 65 43 6e 74 2d 2d 3b 0a  ctiveVdbeCnt--;.
92e0: 20 20 7d 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d    }.  p->magic =
92f0: 20 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54   VDBE_MAGIC_HALT
9300: 3b 0a 20 20 63 68 65 63 6b 41 63 74 69 76 65 56  ;.  checkActiveV
9310: 64 62 65 43 6e 74 28 64 62 29 3b 0a 0a 20 20 72  dbeCnt(db);..  r
9320: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
9330: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e 20  .}../*.** Clean 
9340: 75 70 20 61 20 56 44 42 45 20 61 66 74 65 72 20  up a VDBE after 
9350: 65 78 65 63 75 74 69 6f 6e 20 62 75 74 20 64 6f  execution but do
9360: 20 6e 6f 74 20 64 65 6c 65 74 65 20 74 68 65 20   not delete the 
9370: 56 44 42 45 20 6a 75 73 74 20 79 65 74 2e 0a 2a  VDBE just yet..*
9380: 2a 20 57 72 69 74 65 20 61 6e 79 20 65 72 72 6f  * Write any erro
9390: 72 20 6d 65 73 73 61 67 65 73 20 69 6e 74 6f 20  r messages into 
93a0: 2a 70 7a 45 72 72 4d 73 67 2e 20 20 52 65 74 75  *pzErrMsg.  Retu
93b0: 72 6e 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f  rn the result co
93c0: 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20  de..**.** After 
93d0: 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  this routine is 
93e0: 72 75 6e 2c 20 74 68 65 20 56 44 42 45 20 73 68  run, the VDBE sh
93f0: 6f 75 6c 64 20 62 65 20 72 65 61 64 79 20 74 6f  ould be ready to
9400: 20 62 65 20 65 78 65 63 75 74 65 64 0a 2a 2a 20   be executed.** 
9410: 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a 20 54 6f 20  again..**.** To 
9420: 6c 6f 6f 6b 20 61 74 20 69 74 20 61 6e 6f 74 68  look at it anoth
9430: 65 72 20 77 61 79 2c 20 74 68 69 73 20 72 6f 75  er way, this rou
9440: 74 69 6e 65 20 72 65 73 65 74 73 20 74 68 65 20  tine resets the 
9450: 73 74 61 74 65 20 6f 66 20 74 68 65 0a 2a 2a 20  state of the.** 
9460: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20  virtual machine 
9470: 66 72 6f 6d 20 56 44 42 45 5f 4d 41 47 49 43 5f  from VDBE_MAGIC_
9480: 52 55 4e 20 6f 72 20 56 44 42 45 5f 4d 41 47 49  RUN or VDBE_MAGI
9490: 43 5f 48 41 4c 54 20 62 61 63 6b 20 74 6f 0a 2a  C_HALT back to.*
94a0: 2a 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  * VDBE_MAGIC_INI
94b0: 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  T..*/.int sqlite
94c0: 33 56 64 62 65 52 65 73 65 74 28 56 64 62 65 20  3VdbeReset(Vdbe 
94d0: 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d 3e 6d 61  *p){.  if( p->ma
94e0: 67 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f  gic!=VDBE_MAGIC_
94f0: 52 55 4e 20 26 26 20 70 2d 3e 6d 61 67 69 63 21  RUN && p->magic!
9500: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c 54  =VDBE_MAGIC_HALT
9510: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45   ){.    sqlite3E
9520: 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c 49  rror(p->db, SQLI
9530: 54 45 5f 4d 49 53 55 53 45 2c 20 30 29 3b 0a 20  TE_MISUSE, 0);. 
9540: 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45     return SQLITE
9550: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20  _MISUSE;.  }..  
9560: 2f 2a 20 49 66 20 74 68 65 20 56 4d 20 64 69 64  /* If the VM did
9570: 20 6e 6f 74 20 72 75 6e 20 74 6f 20 63 6f 6d 70   not run to comp
9580: 6c 65 74 69 6f 6e 20 6f 72 20 69 66 20 69 74 20  letion or if it 
9590: 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 6e 0a 20  encountered an. 
95a0: 20 2a 2a 20 65 72 72 6f 72 2c 20 74 68 65 6e 20   ** error, then 
95b0: 69 74 20 6d 69 67 68 74 20 6e 6f 74 20 68 61 76  it might not hav
95c0: 65 20 62 65 65 6e 20 68 61 6c 74 65 64 20 70 72  e been halted pr
95d0: 6f 70 65 72 6c 79 2e 20 20 53 6f 20 68 61 6c 74  operly.  So halt
95e0: 0a 20 20 2a 2a 20 69 74 20 6e 6f 77 2e 0a 20 20  .  ** it now..  
95f0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65  */.  sqlite3Vdbe
9600: 48 61 6c 74 28 70 29 3b 0a 0a 20 20 2f 2a 20 49  Halt(p);..  /* I
9610: 66 20 74 68 65 20 56 44 42 45 20 68 61 73 20 62  f the VDBE has b
9620: 65 20 72 75 6e 20 65 76 65 6e 20 70 61 72 74 69  e run even parti
9630: 61 6c 6c 79 2c 20 74 68 65 6e 20 74 72 61 6e 73  ally, then trans
9640: 66 65 72 20 74 68 65 20 65 72 72 6f 72 20 63 6f  fer the error co
9650: 64 65 0a 20 20 2a 2a 20 61 6e 64 20 65 72 72 6f  de.  ** and erro
9660: 72 20 6d 65 73 73 61 67 65 20 66 72 6f 6d 20 74  r message from t
9670: 68 65 20 56 44 42 45 20 69 6e 74 6f 20 74 68 65  he VDBE into the
9680: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 73   main database s
9690: 74 72 75 63 74 75 72 65 2e 20 20 42 75 74 0a 20  tructure.  But. 
96a0: 20 2a 2a 20 69 66 20 74 68 65 20 56 44 42 45 20   ** if the VDBE 
96b0: 68 61 73 20 6a 75 73 74 20 62 65 65 6e 20 73 65  has just been se
96c0: 74 20 74 6f 20 72 75 6e 20 62 75 74 20 68 61 73  t to run but has
96d0: 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79 20 65 78   not actually ex
96e0: 65 63 75 74 65 64 20 61 6e 79 0a 20 20 2a 2a 20  ecuted any.  ** 
96f0: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 79 65 74  instructions yet
9700: 2c 20 6c 65 61 76 65 20 74 68 65 20 6d 61 69 6e  , leave the main
9710: 20 64 61 74 61 62 61 73 65 20 65 72 72 6f 72 20   database error 
9720: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75 6e 63 68  information unch
9730: 61 6e 67 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66  anged..  */.  if
9740: 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b 0a 20 20  ( p->pc>=0 ){.  
9750: 20 20 69 66 28 20 70 2d 3e 7a 45 72 72 4d 73 67    if( p->zErrMsg
9760: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
9770: 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d  3Error(p->db, p-
9780: 3e 72 63 2c 20 22 25 73 22 2c 20 70 2d 3e 7a 45  >rc, "%s", p->zE
9790: 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 73 71  rrMsg);.      sq
97a0: 6c 69 74 65 46 72 65 65 28 70 2d 3e 7a 45 72 72  liteFree(p->zErr
97b0: 4d 73 67 29 3b 0a 20 20 20 20 20 20 70 2d 3e 7a  Msg);.      p->z
97c0: 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 20 20  ErrMsg = 0;.    
97d0: 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 72 63 20  }else if( p->rc 
97e0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
97f0: 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d 3e  Error(p->db, p->
9800: 72 63 2c 20 30 29 3b 0a 20 20 20 20 7d 65 6c 73  rc, 0);.    }els
9810: 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  e{.      sqlite3
9820: 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53 51 4c  Error(p->db, SQL
9830: 49 54 45 5f 4f 4b 2c 20 30 29 3b 0a 20 20 20 20  ITE_OK, 0);.    
9840: 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d  }.  }else if( p-
9850: 3e 72 63 20 26 26 20 70 2d 3e 65 78 70 69 72 65  >rc && p->expire
9860: 64 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20  d ){.    /* The 
9870: 65 78 70 69 72 65 64 20 66 6c 61 67 20 77 61 73  expired flag was
9880: 20 73 65 74 20 6f 6e 20 74 68 65 20 56 44 42 45   set on the VDBE
9890: 20 62 65 66 6f 72 65 20 74 68 65 20 66 69 72 73   before the firs
98a0: 74 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 74 6f  t call.    ** to
98b0: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e   sqlite3_step().
98c0: 20 46 6f 72 20 63 6f 6e 73 69 73 74 65 6e 63 79   For consistency
98d0: 20 28 73 69 6e 63 65 20 73 71 6c 69 74 65 33 5f   (since sqlite3_
98e0: 73 74 65 70 28 29 20 77 61 73 0a 20 20 20 20 2a  step() was.    *
98f0: 2a 20 63 61 6c 6c 65 64 29 2c 20 73 65 74 20 74  * called), set t
9900: 68 65 20 64 61 74 61 62 61 73 65 20 65 72 72 6f  he database erro
9910: 72 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 61  r in this case a
9920: 73 20 77 65 6c 6c 2e 0a 20 20 20 20 2a 2f 0a 20  s well..    */. 
9930: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
9940: 70 2d 3e 64 62 2c 20 70 2d 3e 72 63 2c 20 30 29  p->db, p->rc, 0)
9950: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 63 6c  ;.  }..  /* Recl
9960: 61 69 6d 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 75  aim all memory u
9970: 73 65 64 20 62 79 20 74 68 65 20 56 44 42 45 0a  sed by the VDBE.
9980: 20 20 2a 2f 0a 20 20 43 6c 65 61 6e 75 70 28 70    */.  Cleanup(p
9990: 29 3b 0a 0a 20 20 2f 2a 20 53 61 76 65 20 70 72  );..  /* Save pr
99a0: 6f 66 69 6c 69 6e 67 20 69 6e 66 6f 72 6d 61 74  ofiling informat
99b0: 69 6f 6e 20 66 72 6f 6d 20 74 68 69 73 20 56 44  ion from this VD
99c0: 42 45 20 72 75 6e 2e 0a 20 20 2a 2f 0a 20 20 61  BE run..  */.  a
99d0: 73 73 65 72 74 28 20 70 2d 3e 70 54 6f 73 3c 26  ssert( p->pTos<&
99e0: 70 2d 3e 61 53 74 61 63 6b 5b 70 2d 3e 70 63 3c  p->aStack[p->pc<
99f0: 30 3f 30 3a 70 2d 3e 70 63 5d 20 7c 7c 20 21 70  0?0:p->pc] || !p
9a00: 2d 3e 61 53 74 61 63 6b 20 29 3b 0a 23 69 66 64  ->aStack );.#ifd
9a10: 65 66 20 56 44 42 45 5f 50 52 4f 46 49 4c 45 0a  ef VDBE_PROFILE.
9a20: 20 20 7b 0a 20 20 20 20 46 49 4c 45 20 2a 6f 75    {.    FILE *ou
9a30: 74 20 3d 20 66 6f 70 65 6e 28 22 76 64 62 65 5f  t = fopen("vdbe_
9a40: 70 72 6f 66 69 6c 65 2e 6f 75 74 22 2c 20 22 61  profile.out", "a
9a50: 22 29 3b 0a 20 20 20 20 69 66 28 20 6f 75 74 20  ");.    if( out 
9a60: 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 3b 0a  ){.      int i;.
9a70: 20 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75        fprintf(ou
9a80: 74 2c 20 22 2d 2d 2d 2d 20 22 29 3b 0a 20 20 20  t, "---- ");.   
9a90: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d     for(i=0; i<p-
9aa0: 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  >nOp; i++){.    
9ab0: 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74 2c      fprintf(out,
9ac0: 20 22 25 30 32 78 22 2c 20 70 2d 3e 61 4f 70 5b   "%02x", p->aOp[
9ad0: 69 5d 2e 6f 70 63 6f 64 65 29 3b 0a 20 20 20 20  i].opcode);.    
9ae0: 20 20 7d 0a 20 20 20 20 20 20 66 70 72 69 6e 74    }.      fprint
9af0: 66 28 6f 75 74 2c 20 22 5c 6e 22 29 3b 0a 20 20  f(out, "\n");.  
9b00: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
9b10: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
9b20: 20 20 20 20 20 66 70 72 69 6e 74 66 28 6f 75 74       fprintf(out
9b30: 2c 20 22 25 36 64 20 25 31 30 6c 6c 64 20 25 38  , "%6d %10lld %8
9b40: 6c 6c 64 20 22 2c 0a 20 20 20 20 20 20 20 20 20  lld ",.         
9b50: 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 2c    p->aOp[i].cnt,
9b60: 0a 20 20 20 20 20 20 20 20 20 20 20 70 2d 3e 61  .           p->a
9b70: 4f 70 5b 69 5d 2e 63 79 63 6c 65 73 2c 0a 20 20  Op[i].cycles,.  
9b80: 20 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b           p->aOp[
9b90: 69 5d 2e 63 6e 74 3e 30 20 3f 20 70 2d 3e 61 4f  i].cnt>0 ? p->aO
9ba0: 70 5b 69 5d 2e 63 79 63 6c 65 73 2f 70 2d 3e 61  p[i].cycles/p->a
9bb0: 4f 70 5b 69 5d 2e 63 6e 74 20 3a 20 30 0a 20 20  Op[i].cnt : 0.  
9bc0: 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20        );.       
9bd0: 20 73 71 6c 69 74 65 33 56 64 62 65 50 72 69 6e   sqlite3VdbePrin
9be0: 74 4f 70 28 6f 75 74 2c 20 69 2c 20 26 70 2d 3e  tOp(out, i, &p->
9bf0: 61 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 20 20 7d  aOp[i]);.      }
9c00: 0a 20 20 20 20 20 20 66 63 6c 6f 73 65 28 6f 75  .      fclose(ou
9c10: 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65  t);.    }.  }.#e
9c20: 6e 64 69 66 0a 20 20 70 2d 3e 6d 61 67 69 63 20  ndif.  p->magic 
9c30: 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  = VDBE_MAGIC_INI
9c40: 54 3b 0a 20 20 70 2d 3e 61 62 6f 72 74 65 64 20  T;.  p->aborted 
9c50: 3d 20 30 3b 0a 20 20 69 66 28 20 70 2d 3e 72 63  = 0;.  if( p->rc
9c60: 3d 3d 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20  ==SQLITE_SCHEMA 
9c70: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65  ){.    sqlite3Re
9c80: 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d  setInternalSchem
9c90: 61 28 70 2d 3e 64 62 2c 20 30 29 3b 0a 20 20 7d  a(p->db, 0);.  }
9ca0: 0a 20 20 72 65 74 75 72 6e 20 70 2d 3e 72 63 3b  .  return p->rc;
9cb0: 0a 7d 0a 20 0a 2f 2a 0a 2a 2a 20 43 6c 65 61 6e  .}. ./*.** Clean
9cc0: 20 75 70 20 61 6e 64 20 64 65 6c 65 74 65 20 61   up and delete a
9cd0: 20 56 44 42 45 20 61 66 74 65 72 20 65 78 65 63   VDBE after exec
9ce0: 75 74 69 6f 6e 2e 20 20 52 65 74 75 72 6e 20 61  ution.  Return a
9cf0: 6e 20 69 6e 74 65 67 65 72 20 77 68 69 63 68 20  n integer which 
9d00: 69 73 0a 2a 2a 20 74 68 65 20 72 65 73 75 6c 74  is.** the result
9d10: 20 63 6f 64 65 2e 20 20 57 72 69 74 65 20 61 6e   code.  Write an
9d20: 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20  y error message 
9d30: 74 65 78 74 20 69 6e 74 6f 20 2a 70 7a 45 72 72  text into *pzErr
9d40: 4d 73 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  Msg..*/.int sqli
9d50: 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28  te3VdbeFinalize(
9d60: 56 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20  Vdbe *p){.  int 
9d70: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
9d80: 0a 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 3d  .  if( p->magic=
9d90: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20  =VDBE_MAGIC_RUN 
9da0: 7c 7c 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  || p->magic==VDB
9db0: 45 5f 4d 41 47 49 43 5f 48 41 4c 54 20 29 7b 0a  E_MAGIC_HALT ){.
9dc0: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
9dd0: 56 64 62 65 52 65 73 65 74 28 70 29 3b 0a 20 20  VdbeReset(p);.  
9de0: 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e 6d 61 67  }else if( p->mag
9df0: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49  ic!=VDBE_MAGIC_I
9e00: 4e 49 54 20 29 7b 0a 20 20 20 20 72 65 74 75 72  NIT ){.    retur
9e10: 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b  n SQLITE_MISUSE;
9e20: 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 64  .  }.  sqlite3Vd
9e30: 62 65 44 65 6c 65 74 65 28 70 29 3b 0a 20 20 72  beDelete(p);.  r
9e40: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
9e50: 2a 2a 20 43 61 6c 6c 20 74 68 65 20 64 65 73 74  ** Call the dest
9e60: 72 75 63 74 6f 72 20 66 6f 72 20 65 61 63 68 20  ructor for each 
9e70: 61 75 78 64 61 74 61 20 65 6e 74 72 79 20 69 6e  auxdata entry in
9e80: 20 70 56 64 62 65 46 75 6e 63 20 66 6f 72 20 77   pVdbeFunc for w
9e90: 68 69 63 68 0a 2a 2a 20 74 68 65 20 63 6f 72 72  hich.** the corr
9ea0: 65 73 70 6f 6e 64 69 6e 67 20 62 69 74 20 69 6e  esponding bit in
9eb0: 20 6d 61 73 6b 20 69 73 20 63 6c 65 61 72 2e 20   mask is clear. 
9ec0: 20 41 75 78 64 61 74 61 20 65 6e 74 72 69 65 73   Auxdata entries
9ed0: 20 62 65 79 6f 6e 64 20 33 31 0a 2a 2a 20 61 72   beyond 31.** ar
9ee0: 65 20 61 6c 77 61 79 73 20 64 65 73 74 72 6f 79  e always destroy
9ef0: 65 64 2e 20 20 54 6f 20 64 65 73 74 72 6f 79 20  ed.  To destroy 
9f00: 61 6c 6c 20 61 75 78 64 61 74 61 20 65 6e 74 72  all auxdata entr
9f10: 69 65 73 2c 20 63 61 6c 6c 20 74 68 69 73 0a 2a  ies, call this.*
9f20: 2a 20 72 6f 75 74 69 6e 65 20 77 69 74 68 20 6d  * routine with m
9f30: 61 73 6b 3d 3d 30 2e 0a 2a 2f 0a 76 6f 69 64 20  ask==0..*/.void 
9f40: 73 71 6c 69 74 65 33 56 64 62 65 44 65 6c 65 74  sqlite3VdbeDelet
9f50: 65 41 75 78 44 61 74 61 28 56 64 62 65 46 75 6e  eAuxData(VdbeFun
9f60: 63 20 2a 70 56 64 62 65 46 75 6e 63 2c 20 69 6e  c *pVdbeFunc, in
9f70: 74 20 6d 61 73 6b 29 7b 0a 20 20 69 6e 74 20 69  t mask){.  int i
9f80: 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70  ;.  for(i=0; i<p
9f90: 56 64 62 65 46 75 6e 63 2d 3e 6e 41 75 78 3b 20  VdbeFunc->nAux; 
9fa0: 69 2b 2b 29 7b 0a 20 20 20 20 73 74 72 75 63 74  i++){.    struct
9fb0: 20 41 75 78 44 61 74 61 20 2a 70 41 75 78 20 3d   AuxData *pAux =
9fc0: 20 26 70 56 64 62 65 46 75 6e 63 2d 3e 61 70 41   &pVdbeFunc->apA
9fd0: 75 78 5b 69 5d 3b 0a 20 20 20 20 69 66 28 20 28  ux[i];.    if( (
9fe0: 69 3e 33 31 20 7c 7c 20 21 28 6d 61 73 6b 26 28  i>31 || !(mask&(
9ff0: 31 3c 3c 69 29 29 29 20 26 26 20 70 41 75 78 2d  1<<i))) && pAux-
a000: 3e 70 41 75 78 20 29 7b 0a 20 20 20 20 20 20 69  >pAux ){.      i
a010: 66 28 20 70 41 75 78 2d 3e 78 44 65 6c 65 74 65  f( pAux->xDelete
a020: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 41 75 78   ){.        pAux
a030: 2d 3e 78 44 65 6c 65 74 65 28 70 41 75 78 2d 3e  ->xDelete(pAux->
a040: 70 41 75 78 29 3b 0a 20 20 20 20 20 20 7d 0a 20  pAux);.      }. 
a050: 20 20 20 20 20 70 41 75 78 2d 3e 70 41 75 78 20       pAux->pAux 
a060: 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d  = 0;.    }.  }.}
a070: 0a 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20 61  ../*.** Delete a
a080: 6e 20 65 6e 74 69 72 65 20 56 44 42 45 2e 0a 2a  n entire VDBE..*
a090: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
a0a0: 62 65 44 65 6c 65 74 65 28 56 64 62 65 20 2a 70  beDelete(Vdbe *p
a0b0: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 66  ){.  int i;.  if
a0c0: 28 20 70 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b  ( p==0 ) return;
a0d0: 0a 20 20 43 6c 65 61 6e 75 70 28 70 29 3b 0a 20  .  Cleanup(p);. 
a0e0: 20 69 66 28 20 70 2d 3e 70 50 72 65 76 20 29 7b   if( p->pPrev ){
a0f0: 0a 20 20 20 20 70 2d 3e 70 50 72 65 76 2d 3e 70  .    p->pPrev->p
a100: 4e 65 78 74 20 3d 20 70 2d 3e 70 4e 65 78 74 3b  Next = p->pNext;
a110: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73  .  }else{.    as
a120: 73 65 72 74 28 20 70 2d 3e 64 62 2d 3e 70 56 64  sert( p->db->pVd
a130: 62 65 3d 3d 70 20 29 3b 0a 20 20 20 20 70 2d 3e  be==p );.    p->
a140: 64 62 2d 3e 70 56 64 62 65 20 3d 20 70 2d 3e 70  db->pVdbe = p->p
a150: 4e 65 78 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Next;.  }.  if( 
a160: 70 2d 3e 70 4e 65 78 74 20 29 7b 0a 20 20 20 20  p->pNext ){.    
a170: 70 2d 3e 70 4e 65 78 74 2d 3e 70 50 72 65 76 20  p->pNext->pPrev 
a180: 3d 20 70 2d 3e 70 50 72 65 76 3b 0a 20 20 7d 0a  = p->pPrev;.  }.
a190: 20 20 69 66 28 20 70 2d 3e 61 4f 70 20 29 7b 0a    if( p->aOp ){.
a1a0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
a1b0: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 0a 20 20 20  ->nOp; i++){.   
a1c0: 20 20 20 4f 70 20 2a 70 4f 70 20 3d 20 26 70 2d     Op *pOp = &p-
a1d0: 3e 61 4f 70 5b 69 5d 3b 0a 20 20 20 20 20 20 66  >aOp[i];.      f
a1e0: 72 65 65 50 33 28 70 4f 70 2d 3e 70 33 74 79 70  reeP3(pOp->p3typ
a1f0: 65 2c 20 70 4f 70 2d 3e 70 33 29 3b 0a 20 20 20  e, pOp->p3);.   
a200: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65   }.    sqliteFre
a210: 65 28 70 2d 3e 61 4f 70 29 3b 0a 20 20 7d 0a 20  e(p->aOp);.  }. 
a220: 20 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79   releaseMemArray
a230: 28 70 2d 3e 61 56 61 72 2c 20 70 2d 3e 6e 56 61  (p->aVar, p->nVa
a240: 72 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65  r);.  sqliteFree
a250: 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 73  (p->aLabel);.  s
a260: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 53 74  qliteFree(p->aSt
a270: 61 63 6b 29 3b 0a 20 20 72 65 6c 65 61 73 65 4d  ack);.  releaseM
a280: 65 6d 41 72 72 61 79 28 70 2d 3e 61 43 6f 6c 4e  emArray(p->aColN
a290: 61 6d 65 2c 20 70 2d 3e 6e 52 65 73 43 6f 6c 75  ame, p->nResColu
a2a0: 6d 6e 2a 32 29 3b 0a 20 20 73 71 6c 69 74 65 46  mn*2);.  sqliteF
a2b0: 72 65 65 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65 29  ree(p->aColName)
a2c0: 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20 3d 20 56  ;.  p->magic = V
a2d0: 44 42 45 5f 4d 41 47 49 43 5f 44 45 41 44 3b 0a  DBE_MAGIC_DEAD;.
a2e0: 20 20 73 71 6c 69 74 65 46 72 65 65 28 70 29 3b    sqliteFree(p);
a2f0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 61 20 4d  .}../*.** If a M
a300: 6f 76 65 54 6f 20 6f 70 65 72 61 74 69 6f 6e 20  oveTo operation 
a310: 69 73 20 70 65 6e 64 69 6e 67 20 6f 6e 20 74 68  is pending on th
a320: 65 20 67 69 76 65 6e 20 63 75 72 73 6f 72 2c 20  e given cursor, 
a330: 74 68 65 6e 20 64 6f 20 74 68 61 74 0a 2a 2a 20  then do that.** 
a340: 4d 6f 76 65 54 6f 20 6e 6f 77 2e 20 20 52 65 74  MoveTo now.  Ret
a350: 75 72 6e 20 61 6e 20 65 72 72 6f 72 20 63 6f 64  urn an error cod
a360: 65 2e 20 20 49 66 20 6e 6f 20 4d 6f 76 65 54 6f  e.  If no MoveTo
a370: 20 69 73 20 70 65 6e 64 69 6e 67 2c 20 74 68 69   is pending, thi
a380: 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 64 6f 65  s.** routine doe
a390: 73 20 6e 6f 74 68 69 6e 67 20 61 6e 64 20 72 65  s nothing and re
a3a0: 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 4f 4b 2e  turns SQLITE_OK.
a3b0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56  .*/.int sqlite3V
a3c0: 64 62 65 43 75 72 73 6f 72 4d 6f 76 65 74 6f 28  dbeCursorMoveto(
a3d0: 43 75 72 73 6f 72 20 2a 70 29 7b 0a 20 20 69 66  Cursor *p){.  if
a3e0: 28 20 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76  ( p->deferredMov
a3f0: 65 74 6f 20 29 7b 0a 20 20 20 20 69 6e 74 20 72  eto ){.    int r
a400: 65 73 2c 20 72 63 3b 0a 20 20 20 20 65 78 74 65  es, rc;.    exte
a410: 72 6e 20 69 6e 74 20 73 71 6c 69 74 65 33 5f 73  rn int sqlite3_s
a420: 65 61 72 63 68 5f 63 6f 75 6e 74 3b 0a 20 20 20  earch_count;.   
a430: 20 61 73 73 65 72 74 28 20 70 2d 3e 69 73 54 61   assert( p->isTa
a440: 62 6c 65 20 29 3b 0a 20 20 20 20 69 66 28 20 70  ble );.    if( p
a450: 2d 3e 69 73 54 61 62 6c 65 20 29 7b 0a 20 20 20  ->isTable ){.   
a460: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
a470: 74 72 65 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43  treeMoveto(p->pC
a480: 75 72 73 6f 72 2c 20 30 2c 20 70 2d 3e 6d 6f 76  ursor, 0, p->mov
a490: 65 74 6f 54 61 72 67 65 74 2c 20 26 72 65 73 29  etoTarget, &res)
a4a0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
a4b0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
a4c0: 74 72 65 65 4d 6f 76 65 74 6f 28 70 2d 3e 70 43  treeMoveto(p->pC
a4d0: 75 72 73 6f 72 2c 28 63 68 61 72 2a 29 26 70 2d  ursor,(char*)&p-
a4e0: 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74 2c 0a 20  >movetoTarget,. 
a4f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a500: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 69 7a               siz
a510: 65 6f 66 28 69 36 34 29 2c 26 72 65 73 29 3b 0a  eof(i64),&res);.
a520: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 63      }.    if( rc
a530: 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20   ) return rc;.  
a540: 20 20 2a 70 2d 3e 70 49 6e 63 72 4b 65 79 20 3d    *p->pIncrKey =
a550: 20 30 3b 0a 20 20 20 20 70 2d 3e 6c 61 73 74 52   0;.    p->lastR
a560: 6f 77 69 64 20 3d 20 6b 65 79 54 6f 49 6e 74 28  owid = keyToInt(
a570: 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74 29  p->movetoTarget)
a580: 3b 0a 20 20 20 20 70 2d 3e 72 6f 77 69 64 49 73  ;.    p->rowidIs
a590: 56 61 6c 69 64 20 3d 20 72 65 73 3d 3d 30 3b 0a  Valid = res==0;.
a5a0: 20 20 20 20 69 66 28 20 72 65 73 3c 30 20 29 7b      if( res<0 ){
a5b0: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69  .      rc = sqli
a5c0: 74 65 33 42 74 72 65 65 4e 65 78 74 28 70 2d 3e  te3BtreeNext(p->
a5d0: 70 43 75 72 73 6f 72 2c 20 26 72 65 73 29 3b 0a  pCursor, &res);.
a5e0: 20 20 20 20 20 20 69 66 28 20 72 63 20 29 20 72        if( rc ) r
a5f0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a  eturn rc;.    }.
a600: 20 20 20 20 73 71 6c 69 74 65 33 5f 73 65 61 72      sqlite3_sear
a610: 63 68 5f 63 6f 75 6e 74 2b 2b 3b 0a 20 20 20 20  ch_count++;.    
a620: 70 2d 3e 64 65 66 65 72 72 65 64 4d 6f 76 65 74  p->deferredMovet
a630: 6f 20 3d 20 30 3b 0a 20 20 20 20 70 2d 3e 63 61  o = 0;.    p->ca
a640: 63 68 65 53 74 61 74 75 73 20 3d 20 43 41 43 48  cheStatus = CACH
a650: 45 5f 53 54 41 4c 45 3b 0a 20 20 7d 0a 20 20 72  E_STALE;.  }.  r
a660: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
a670: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 66 6f  .}../*.** The fo
a680: 6c 6c 6f 77 69 6e 67 20 66 75 6e 63 74 69 6f 6e  llowing function
a690: 73 3a 0a 2a 2a 0a 2a 2a 20 73 71 6c 69 74 65 33  s:.**.** sqlite3
a6a0: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 29  VdbeSerialType()
a6b0: 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53  .** sqlite3VdbeS
a6c0: 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 29 0a 2a  erialTypeLen().*
a6d0: 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  * sqlite3VdbeSer
a6e0: 69 61 6c 52 65 61 64 28 29 0a 2a 2a 20 73 71 6c  ialRead().** sql
a6f0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 4c 65  ite3VdbeSerialLe
a700: 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56 64  n().** sqlite3Vd
a710: 62 65 53 65 72 69 61 6c 57 72 69 74 65 28 29 0a  beSerialWrite().
a720: 2a 2a 0a 2a 2a 20 65 6e 63 61 70 73 75 6c 61 74  **.** encapsulat
a730: 65 20 74 68 65 20 63 6f 64 65 20 74 68 61 74 20  e the code that 
a740: 73 65 72 69 61 6c 69 7a 65 73 20 76 61 6c 75 65  serializes value
a750: 73 20 66 6f 72 20 73 74 6f 72 61 67 65 20 69 6e  s for storage in
a760: 20 53 51 4c 69 74 65 0a 2a 2a 20 64 61 74 61 20   SQLite.** data 
a770: 61 6e 64 20 69 6e 64 65 78 20 72 65 63 6f 72 64  and index record
a780: 73 2e 20 45 61 63 68 20 73 65 72 69 61 6c 69 7a  s. Each serializ
a790: 65 64 20 76 61 6c 75 65 20 63 6f 6e 73 69 73 74  ed value consist
a7a0: 73 20 6f 66 20 61 0a 2a 2a 20 27 73 65 72 69 61  s of a.** 'seria
a7b0: 6c 2d 74 79 70 65 27 20 61 6e 64 20 61 20 62 6c  l-type' and a bl
a7c0: 6f 62 20 6f 66 20 64 61 74 61 2e 20 54 68 65 20  ob of data. The 
a7d0: 73 65 72 69 61 6c 20 74 79 70 65 20 69 73 20 61  serial type is a
a7e0: 6e 20 38 2d 62 79 74 65 20 75 6e 73 69 67 6e 65  n 8-byte unsigne
a7f0: 64 0a 2a 2a 20 69 6e 74 65 67 65 72 2c 20 73 74  d.** integer, st
a800: 6f 72 65 64 20 61 73 20 61 20 76 61 72 69 6e 74  ored as a varint
a810: 2e 0a 2a 2a 0a 2a 2a 20 49 6e 20 61 6e 20 53 51  ..**.** In an SQ
a820: 4c 69 74 65 20 69 6e 64 65 78 20 72 65 63 6f 72  Lite index recor
a830: 64 2c 20 74 68 65 20 73 65 72 69 61 6c 20 74 79  d, the serial ty
a840: 70 65 20 69 73 20 73 74 6f 72 65 64 20 64 69 72  pe is stored dir
a850: 65 63 74 6c 79 20 62 65 66 6f 72 65 0a 2a 2a 20  ectly before.** 
a860: 74 68 65 20 62 6c 6f 62 20 6f 66 20 64 61 74 61  the blob of data
a870: 20 74 68 61 74 20 69 74 20 63 6f 72 72 65 73 70   that it corresp
a880: 6f 6e 64 73 20 74 6f 2e 20 49 6e 20 61 20 74 61  onds to. In a ta
a890: 62 6c 65 20 72 65 63 6f 72 64 2c 20 61 6c 6c 20  ble record, all 
a8a0: 73 65 72 69 61 6c 0a 2a 2a 20 74 79 70 65 73 20  serial.** types 
a8b0: 61 72 65 20 73 74 6f 72 65 64 20 61 74 20 74 68  are stored at th
a8c0: 65 20 73 74 61 72 74 20 6f 66 20 74 68 65 20 72  e start of the r
a8d0: 65 63 6f 72 64 2c 20 61 6e 64 20 74 68 65 20 62  ecord, and the b
a8e0: 6c 6f 62 73 20 6f 66 20 64 61 74 61 20 61 74 0a  lobs of data at.
a8f0: 2a 2a 20 74 68 65 20 65 6e 64 2e 20 48 65 6e 63  ** the end. Henc
a900: 65 20 74 68 65 73 65 20 66 75 6e 63 74 69 6f 6e  e these function
a910: 73 20 61 6c 6c 6f 77 20 74 68 65 20 63 61 6c 6c  s allow the call
a920: 65 72 20 74 6f 20 68 61 6e 64 6c 65 20 74 68 65  er to handle the
a930: 0a 2a 2a 20 73 65 72 69 61 6c 2d 74 79 70 65 20  .** serial-type 
a940: 61 6e 64 20 64 61 74 61 20 62 6c 6f 62 20 73 65  and data blob se
a950: 70 65 72 61 74 65 6c 79 2e 0a 2a 2a 0a 2a 2a 20  perately..**.** 
a960: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61  The following ta
a970: 62 6c 65 20 64 65 73 63 72 69 62 65 73 20 74 68  ble describes th
a980: 65 20 76 61 72 69 6f 75 73 20 73 74 6f 72 61 67  e various storag
a990: 65 20 63 6c 61 73 73 65 73 20 66 6f 72 20 64 61  e classes for da
a9a0: 74 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 73 65 72 69  ta:.**.**   seri
a9b0: 61 6c 20 74 79 70 65 20 20 20 20 20 20 20 20 62  al type        b
a9c0: 79 74 65 73 20 6f 66 20 64 61 74 61 20 20 20 20  ytes of data    
a9d0: 20 20 74 79 70 65 0a 2a 2a 20 20 20 2d 2d 2d 2d    type.**   ----
a9e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 20 20 20 2d  ----------     -
a9f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20  --------------  
aa00: 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d    --------------
aa10: 2d 0a 2a 2a 20 20 20 20 20 20 30 20 20 20 20 20  -.**      0     
aa20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aa30: 30 20 20 20 20 20 20 20 20 20 20 20 20 4e 55 4c  0            NUL
aa40: 4c 0a 2a 2a 20 20 20 20 20 20 31 20 20 20 20 20  L.**      1     
aa50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aa60: 31 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67  1            sig
aa70: 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20  ned integer.**  
aa80: 20 20 20 20 32 20 20 20 20 20 20 20 20 20 20 20      2           
aa90: 20 20 20 20 20 20 20 20 20 20 32 20 20 20 20 20            2     
aaa0: 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e         signed in
aab0: 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 33 20  teger.**      3 
aac0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aad0: 20 20 20 20 33 20 20 20 20 20 20 20 20 20 20 20      3           
aae0: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a   signed integer.
aaf0: 2a 2a 20 20 20 20 20 20 34 20 20 20 20 20 20 20  **      4       
ab00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 34 20                4 
ab10: 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65             signe
ab20: 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20  d integer.**    
ab30: 20 20 35 20 20 20 20 20 20 20 20 20 20 20 20 20    5             
ab40: 20 20 20 20 20 20 20 20 36 20 20 20 20 20 20 20          6       
ab50: 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65       signed inte
ab60: 67 65 72 0a 2a 2a 20 20 20 20 20 20 36 20 20 20  ger.**      6   
ab70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ab80: 20 20 38 20 20 20 20 20 20 20 20 20 20 20 20 73    8            s
ab90: 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a  igned integer.**
aba0: 20 20 20 20 20 20 37 20 20 20 20 20 20 20 20 20        7         
abb0: 20 20 20 20 20 20 20 20 20 20 20 20 38 20 20 20              8   
abc0: 20 20 20 20 20 20 20 20 20 49 45 45 45 20 66 6c           IEEE fl
abd0: 6f 61 74 0a 2a 2a 20 20 20 20 20 20 38 20 20 20  oat.**      8   
abe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
abf0: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 49    0            I
ac00: 6e 74 65 67 65 72 20 63 6f 6e 73 74 61 6e 74 20  nteger constant 
ac10: 30 0a 2a 2a 20 20 20 20 20 20 39 20 20 20 20 20  0.**      9     
ac20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ac30: 30 20 20 20 20 20 20 20 20 20 20 20 20 49 6e 74  0            Int
ac40: 65 67 65 72 20 63 6f 6e 73 74 61 6e 74 20 31 0a  eger constant 1.
ac50: 2a 2a 20 20 20 20 20 31 30 2c 31 31 20 20 20 20  **     10,11    
ac60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ac70: 20 20 20 20 20 20 20 20 20 20 20 72 65 73 65 72             reser
ac80: 76 65 64 20 66 6f 72 20 65 78 70 61 6e 73 69 6f  ved for expansio
ac90: 6e 0a 2a 2a 20 20 20 20 4e 3e 3d 31 32 20 61 6e  n.**    N>=12 an
aca0: 64 20 65 76 65 6e 20 20 20 20 20 20 20 28 4e 2d  d even       (N-
acb0: 31 32 29 2f 32 20 20 20 20 20 20 20 20 42 4c 4f  12)/2        BLO
acc0: 42 0a 2a 2a 20 20 20 20 4e 3e 3d 31 33 20 61 6e  B.**    N>=13 an
acd0: 64 20 6f 64 64 20 20 20 20 20 20 20 20 28 4e 2d  d odd        (N-
ace0: 31 33 29 2f 32 20 20 20 20 20 20 20 20 74 65 78  13)/2        tex
acf0: 74 0a 2a 2a 0a 2a 2a 20 54 68 65 20 38 20 61 6e  t.**.** The 8 an
ad00: 64 20 39 20 74 79 70 65 73 20 77 65 72 65 20 61  d 9 types were a
ad10: 64 64 65 64 20 69 6e 20 33 2e 33 2e 30 2c 20 66  dded in 3.3.0, f
ad20: 69 6c 65 20 66 6f 72 6d 61 74 20 34 2e 20 20 50  ile format 4.  P
ad30: 72 69 6f 72 20 76 65 72 73 69 6f 6e 73 0a 2a 2a  rior versions.**
ad40: 20 6f 66 20 53 51 4c 69 74 65 20 77 69 6c 6c 20   of SQLite will 
ad50: 6e 6f 74 20 75 6e 64 65 72 73 74 61 6e 64 20 74  not understand t
ad60: 68 6f 73 65 20 73 65 72 69 61 6c 20 74 79 70 65  hose serial type
ad70: 73 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 52 65 74  s..*/../*.** Ret
ad80: 75 72 6e 20 74 68 65 20 73 65 72 69 61 6c 2d 74  urn the serial-t
ad90: 79 70 65 20 66 6f 72 20 74 68 65 20 76 61 6c 75  ype for the valu
ada0: 65 20 73 74 6f 72 65 64 20 69 6e 20 70 4d 65 6d  e stored in pMem
adb0: 2e 0a 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65 33  ..*/.u32 sqlite3
adc0: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 4d  VdbeSerialType(M
add0: 65 6d 20 2a 70 4d 65 6d 2c 20 69 6e 74 20 66 69  em *pMem, int fi
ade0: 6c 65 5f 66 6f 72 6d 61 74 29 7b 0a 20 20 69 6e  le_format){.  in
adf0: 74 20 66 6c 61 67 73 20 3d 20 70 4d 65 6d 2d 3e  t flags = pMem->
ae00: 66 6c 61 67 73 3b 0a 0a 20 20 69 66 28 20 66 6c  flags;..  if( fl
ae10: 61 67 73 26 4d 45 4d 5f 4e 75 6c 6c 20 29 7b 0a  ags&MEM_Null ){.
ae20: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20      return 0;.  
ae30: 7d 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45  }.  if( flags&ME
ae40: 4d 5f 49 6e 74 20 29 7b 0a 20 20 20 20 2f 2a 20  M_Int ){.    /* 
ae50: 46 69 67 75 72 65 20 6f 75 74 20 77 68 65 74 68  Figure out wheth
ae60: 65 72 20 74 6f 20 75 73 65 20 31 2c 20 32 2c 20  er to use 1, 2, 
ae70: 34 2c 20 36 20 6f 72 20 38 20 62 79 74 65 73 2e  4, 6 or 8 bytes.
ae80: 20 2a 2f 0a 23 20 20 20 64 65 66 69 6e 65 20 4d   */.#   define M
ae90: 41 58 5f 36 42 59 54 45 20 28 28 28 28 69 36 34  AX_6BYTE ((((i64
aea0: 29 30 78 30 30 30 30 31 30 30 30 29 3c 3c 33 32  )0x00001000)<<32
aeb0: 29 2d 31 29 0a 20 20 20 20 69 36 34 20 69 20 3d  )-1).    i64 i =
aec0: 20 70 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20 75 36   pMem->i;.    u6
aed0: 34 20 75 3b 0a 20 20 20 20 69 66 28 20 66 69 6c  4 u;.    if( fil
aee0: 65 5f 66 6f 72 6d 61 74 3e 3d 34 20 26 26 20 28  e_format>=4 && (
aef0: 69 26 31 29 3d 3d 69 20 29 7b 0a 20 20 20 20 20  i&1)==i ){.     
af00: 20 72 65 74 75 72 6e 20 38 2b 69 3b 0a 20 20 20   return 8+i;.   
af10: 20 7d 0a 20 20 20 20 75 20 3d 20 69 3c 30 20 3f   }.    u = i<0 ?
af20: 20 2d 69 20 3a 20 69 3b 0a 20 20 20 20 69 66 28   -i : i;.    if(
af30: 20 75 3c 3d 31 32 37 20 29 20 72 65 74 75 72 6e   u<=127 ) return
af40: 20 31 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 33   1;.    if( u<=3
af50: 32 37 36 37 20 29 20 72 65 74 75 72 6e 20 32 3b  2767 ) return 2;
af60: 0a 20 20 20 20 69 66 28 20 75 3c 3d 38 33 38 38  .    if( u<=8388
af70: 36 30 37 20 29 20 72 65 74 75 72 6e 20 33 3b 0a  607 ) return 3;.
af80: 20 20 20 20 69 66 28 20 75 3c 3d 32 31 34 37 34      if( u<=21474
af90: 38 33 36 34 37 20 29 20 72 65 74 75 72 6e 20 34  83647 ) return 4
afa0: 3b 0a 20 20 20 20 69 66 28 20 75 3c 3d 4d 41 58  ;.    if( u<=MAX
afb0: 5f 36 42 59 54 45 20 29 20 72 65 74 75 72 6e 20  _6BYTE ) return 
afc0: 35 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 36 3b  5;.    return 6;
afd0: 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73  .  }.  if( flags
afe0: 26 4d 45 4d 5f 52 65 61 6c 20 29 7b 0a 20 20 20  &MEM_Real ){.   
aff0: 20 72 65 74 75 72 6e 20 37 3b 0a 20 20 7d 0a 20   return 7;.  }. 
b000: 20 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 53   if( flags&MEM_S
b010: 74 72 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 20  tr ){.    int n 
b020: 3d 20 70 4d 65 6d 2d 3e 6e 3b 0a 20 20 20 20 61  = pMem->n;.    a
b030: 73 73 65 72 74 28 20 6e 3e 3d 30 20 29 3b 0a 20  ssert( n>=0 );. 
b040: 20 20 20 72 65 74 75 72 6e 20 28 28 6e 2a 32 29     return ((n*2)
b050: 20 2b 20 31 33 29 3b 0a 20 20 7d 0a 20 20 69 66   + 13);.  }.  if
b060: 28 20 66 6c 61 67 73 26 4d 45 4d 5f 42 6c 6f 62  ( flags&MEM_Blob
b070: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28   ){.    return (
b080: 70 4d 65 6d 2d 3e 6e 2a 32 20 2b 20 31 32 29 3b  pMem->n*2 + 12);
b090: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
b0a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e  .}../*.** Return
b0b0: 20 74 68 65 20 6c 65 6e 67 74 68 20 6f 66 20 74   the length of t
b0c0: 68 65 20 64 61 74 61 20 63 6f 72 72 65 73 70 6f  he data correspo
b0d0: 6e 64 69 6e 67 20 74 6f 20 74 68 65 20 73 75 70  nding to the sup
b0e0: 70 6c 69 65 64 20 73 65 72 69 61 6c 2d 74 79 70  plied serial-typ
b0f0: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
b100: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
b110: 65 6e 28 75 33 32 20 73 65 72 69 61 6c 5f 74 79  en(u32 serial_ty
b120: 70 65 29 7b 0a 20 20 69 66 28 20 73 65 72 69 61  pe){.  if( seria
b130: 6c 5f 74 79 70 65 3e 3d 31 32 20 29 7b 0a 20 20  l_type>=12 ){.  
b140: 20 20 72 65 74 75 72 6e 20 28 73 65 72 69 61 6c    return (serial
b150: 5f 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20 20 7d  _type-12)/2;.  }
b160: 65 6c 73 65 7b 0a 20 20 20 20 73 74 61 74 69 63  else{.    static
b170: 20 63 6f 6e 73 74 20 75 38 20 61 53 69 7a 65 5b   const u8 aSize[
b180: 5d 20 3d 20 7b 20 30 2c 20 31 2c 20 32 2c 20 33  ] = { 0, 1, 2, 3
b190: 2c 20 34 2c 20 36 2c 20 38 2c 20 38 2c 20 30 2c  , 4, 6, 8, 8, 0,
b1a0: 20 30 2c 20 30 2c 20 30 20 7d 3b 0a 20 20 20 20   0, 0, 0 };.    
b1b0: 72 65 74 75 72 6e 20 61 53 69 7a 65 5b 73 65 72  return aSize[ser
b1c0: 69 61 6c 5f 74 79 70 65 5d 3b 0a 20 20 7d 0a 7d  ial_type];.  }.}
b1d0: 0a 0a 2f 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68  ../*.** Write th
b1e0: 65 20 73 65 72 69 61 6c 69 7a 65 64 20 64 61 74  e serialized dat
b1f0: 61 20 62 6c 6f 62 20 66 6f 72 20 74 68 65 20 76  a blob for the v
b200: 61 6c 75 65 20 73 74 6f 72 65 64 20 69 6e 20 70  alue stored in p
b210: 4d 65 6d 20 69 6e 74 6f 20 0a 2a 2a 20 62 75 66  Mem into .** buf
b220: 2e 20 49 74 20 69 73 20 61 73 73 75 6d 65 64 20  . It is assumed 
b230: 74 68 61 74 20 74 68 65 20 63 61 6c 6c 65 72 20  that the caller 
b240: 68 61 73 20 61 6c 6c 6f 63 61 74 65 64 20 73 75  has allocated su
b250: 66 66 69 63 69 65 6e 74 20 73 70 61 63 65 2e 0a  fficient space..
b260: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 6e 75  ** Return the nu
b270: 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 77 72  mber of bytes wr
b280: 69 74 74 65 6e 2e 0a 2a 2f 20 0a 69 6e 74 20 73  itten..*/ .int s
b290: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
b2a0: 50 75 74 28 75 6e 73 69 67 6e 65 64 20 63 68 61  Put(unsigned cha
b2b0: 72 20 2a 62 75 66 2c 20 4d 65 6d 20 2a 70 4d 65  r *buf, Mem *pMe
b2c0: 6d 2c 20 69 6e 74 20 66 69 6c 65 5f 66 6f 72 6d  m, int file_form
b2d0: 61 74 29 7b 0a 20 20 75 33 32 20 73 65 72 69 61  at){.  u32 seria
b2e0: 6c 5f 74 79 70 65 20 3d 20 73 71 6c 69 74 65 33  l_type = sqlite3
b2f0: 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 28 70  VdbeSerialType(p
b300: 4d 65 6d 2c 20 66 69 6c 65 5f 66 6f 72 6d 61 74  Mem, file_format
b310: 29 3b 0a 20 20 69 6e 74 20 6c 65 6e 3b 0a 0a 20  );.  int len;.. 
b320: 20 2f 2a 20 49 6e 74 65 67 65 72 20 61 6e 64 20   /* Integer and 
b330: 52 65 61 6c 20 2a 2f 0a 20 20 69 66 28 20 73 65  Real */.  if( se
b340: 72 69 61 6c 5f 74 79 70 65 3c 3d 37 20 26 26 20  rial_type<=7 && 
b350: 73 65 72 69 61 6c 5f 74 79 70 65 3e 30 20 29 7b  serial_type>0 ){
b360: 0a 20 20 20 20 75 36 34 20 76 3b 0a 20 20 20 20  .    u64 v;.    
b370: 69 6e 74 20 69 3b 0a 20 20 20 20 69 66 28 20 73  int i;.    if( s
b380: 65 72 69 61 6c 5f 74 79 70 65 3d 3d 37 20 29 7b  erial_type==7 ){
b390: 0a 20 20 20 20 20 20 76 20 3d 20 2a 28 75 36 34  .      v = *(u64
b3a0: 2a 29 26 70 4d 65 6d 2d 3e 72 3b 0a 20 20 20 20  *)&pMem->r;.    
b3b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 76 20 3d  }else{.      v =
b3c0: 20 2a 28 75 36 34 2a 29 26 70 4d 65 6d 2d 3e 69   *(u64*)&pMem->i
b3d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6c 65 6e 20  ;.    }.    len 
b3e0: 3d 20 69 20 3d 20 73 71 6c 69 74 65 33 56 64 62  = i = sqlite3Vdb
b3f0: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73  eSerialTypeLen(s
b400: 65 72 69 61 6c 5f 74 79 70 65 29 3b 0a 20 20 20  erial_type);.   
b410: 20 77 68 69 6c 65 28 20 69 2d 2d 20 29 7b 0a 20   while( i-- ){. 
b420: 20 20 20 20 20 62 75 66 5b 69 5d 20 3d 20 28 76       buf[i] = (v
b430: 26 30 78 46 46 29 3b 0a 20 20 20 20 20 20 76 20  &0xFF);.      v 
b440: 3e 3e 3d 20 38 3b 0a 20 20 20 20 7d 0a 20 20 20  >>= 8;.    }.   
b450: 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 7d   return len;.  }
b460: 0a 0a 20 20 2f 2a 20 53 74 72 69 6e 67 20 6f 72  ..  /* String or
b470: 20 62 6c 6f 62 20 2a 2f 0a 20 20 69 66 28 20 73   blob */.  if( s
b480: 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32 20 29  erial_type>=12 )
b490: 7b 0a 20 20 20 20 6c 65 6e 20 3d 20 73 71 6c 69  {.    len = sqli
b4a0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
b4b0: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
b4c0: 29 3b 0a 20 20 20 20 6d 65 6d 63 70 79 28 62 75  );.    memcpy(bu
b4d0: 66 2c 20 70 4d 65 6d 2d 3e 7a 2c 20 6c 65 6e 29  f, pMem->z, len)
b4e0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 6c 65 6e  ;.    return len
b4f0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4e 55 4c 4c  ;.  }..  /* NULL
b500: 20 6f 72 20 63 6f 6e 73 74 61 6e 74 73 20 30 20   or constants 0 
b510: 6f 72 20 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e  or 1 */.  return
b520: 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 73   0;.}../*.** Des
b530: 65 72 69 61 6c 69 7a 65 20 74 68 65 20 64 61 74  erialize the dat
b540: 61 20 62 6c 6f 62 20 70 6f 69 6e 74 65 64 20 74  a blob pointed t
b550: 6f 20 62 79 20 62 75 66 20 61 73 20 73 65 72 69  o by buf as seri
b560: 61 6c 20 74 79 70 65 20 73 65 72 69 61 6c 5f 74  al type serial_t
b570: 79 70 65 0a 2a 2a 20 61 6e 64 20 73 74 6f 72 65  ype.** and store
b580: 20 74 68 65 20 72 65 73 75 6c 74 20 69 6e 20 70   the result in p
b590: 4d 65 6d 2e 20 20 52 65 74 75 72 6e 20 74 68 65  Mem.  Return the
b5a0: 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73   number of bytes
b5b0: 20 72 65 61 64 2e 0a 2a 2f 20 0a 69 6e 74 20 73   read..*/ .int s
b5c0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
b5d0: 47 65 74 28 0a 20 20 63 6f 6e 73 74 20 75 6e 73  Get(.  const uns
b5e0: 69 67 6e 65 64 20 63 68 61 72 20 2a 62 75 66 2c  igned char *buf,
b5f0: 20 20 20 20 20 2f 2a 20 42 75 66 66 65 72 20 74       /* Buffer t
b600: 6f 20 64 65 73 65 72 69 61 6c 69 7a 65 20 66 72  o deserialize fr
b610: 6f 6d 20 2a 2f 0a 20 20 75 33 32 20 73 65 72 69  om */.  u32 seri
b620: 61 6c 5f 74 79 70 65 2c 20 20 20 20 20 20 20 20  al_type,        
b630: 20 20 20 20 20 20 2f 2a 20 53 65 72 69 61 6c 20        /* Serial 
b640: 74 79 70 65 20 74 6f 20 64 65 73 65 72 69 61 6c  type to deserial
b650: 69 7a 65 20 2a 2f 0a 20 20 4d 65 6d 20 2a 70 4d  ize */.  Mem *pM
b660: 65 6d 20 20 20 20 20 20 20 20 20 20 20 20 20 20  em              
b670: 20 20 20 20 20 20 20 2f 2a 20 4d 65 6d 6f 72 79         /* Memory
b680: 20 63 65 6c 6c 20 74 6f 20 77 72 69 74 65 20 76   cell to write v
b690: 61 6c 75 65 20 69 6e 74 6f 20 2a 2f 0a 29 7b 0a  alue into */.){.
b6a0: 20 20 73 77 69 74 63 68 28 20 73 65 72 69 61 6c    switch( serial
b6b0: 5f 74 79 70 65 20 29 7b 0a 20 20 20 20 63 61 73  _type ){.    cas
b6c0: 65 20 31 30 3a 20 20 20 2f 2a 20 52 65 73 65 72  e 10:   /* Reser
b6d0: 76 65 64 20 66 6f 72 20 66 75 74 75 72 65 20 75  ved for future u
b6e0: 73 65 20 2a 2f 0a 20 20 20 20 63 61 73 65 20 31  se */.    case 1
b6f0: 31 3a 20 20 20 2f 2a 20 52 65 73 65 72 76 65 64  1:   /* Reserved
b700: 20 66 6f 72 20 66 75 74 75 72 65 20 75 73 65 20   for future use 
b710: 2a 2f 0a 20 20 20 20 63 61 73 65 20 30 3a 20 7b  */.    case 0: {
b720: 20 20 2f 2a 20 4e 55 4c 4c 20 2a 2f 0a 20 20 20    /* NULL */.   
b730: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
b740: 20 4d 45 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20   MEM_Null;.     
b750: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
b760: 20 20 63 61 73 65 20 31 3a 20 7b 20 2f 2a 20 31    case 1: { /* 1
b770: 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 6e 74  -byte signed int
b780: 65 67 65 72 20 2a 2f 0a 20 20 20 20 20 20 70 4d  eger */.      pM
b790: 65 6d 2d 3e 69 20 3d 20 28 73 69 67 6e 65 64 20  em->i = (signed 
b7a0: 63 68 61 72 29 62 75 66 5b 30 5d 3b 0a 20 20 20  char)buf[0];.   
b7b0: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
b7c0: 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20   MEM_Int;.      
b7d0: 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d 0a  return 1;.    }.
b7e0: 20 20 20 20 63 61 73 65 20 32 3a 20 7b 20 2f 2a      case 2: { /*
b7f0: 20 32 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69   2-byte signed i
b800: 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20 20 20  nteger */.      
b810: 70 4d 65 6d 2d 3e 69 20 3d 20 28 28 28 73 69 67  pMem->i = (((sig
b820: 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30 5d 29  ned char)buf[0])
b830: 3c 3c 38 29 20 7c 20 62 75 66 5b 31 5d 3b 0a 20  <<8) | buf[1];. 
b840: 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73       pMem->flags
b850: 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20   = MEM_Int;.    
b860: 20 20 72 65 74 75 72 6e 20 32 3b 0a 20 20 20 20    return 2;.    
b870: 7d 0a 20 20 20 20 63 61 73 65 20 33 3a 20 7b 20  }.    case 3: { 
b880: 2f 2a 20 33 2d 62 79 74 65 20 73 69 67 6e 65 64  /* 3-byte signed
b890: 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20 20   integer */.    
b8a0: 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 28 28 73    pMem->i = (((s
b8b0: 69 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30  igned char)buf[0
b8c0: 5d 29 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b 31  ])<<16) | (buf[1
b8d0: 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 32 5d 3b 0a  ]<<8) | buf[2];.
b8e0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
b8f0: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
b900: 20 20 20 72 65 74 75 72 6e 20 33 3b 0a 20 20 20     return 3;.   
b910: 20 7d 0a 20 20 20 20 63 61 73 65 20 34 3a 20 7b   }.    case 4: {
b920: 20 2f 2a 20 34 2d 62 79 74 65 20 73 69 67 6e 65   /* 4-byte signe
b930: 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20 20  d integer */.   
b940: 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 62 75     pMem->i = (bu
b950: 66 5b 30 5d 3c 3c 32 34 29 20 7c 20 28 62 75 66  f[0]<<24) | (buf
b960: 5b 31 5d 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b  [1]<<16) | (buf[
b970: 32 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 33 5d 3b  2]<<8) | buf[3];
b980: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61  .      pMem->fla
b990: 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20  gs = MEM_Int;.  
b9a0: 20 20 20 20 72 65 74 75 72 6e 20 34 3b 0a 20 20      return 4;.  
b9b0: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 35 3a 20    }.    case 5: 
b9c0: 7b 20 2f 2a 20 36 2d 62 79 74 65 20 73 69 67 6e  { /* 6-byte sign
b9d0: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20  ed integer */.  
b9e0: 20 20 20 20 75 36 34 20 78 20 3d 20 28 28 28 73      u64 x = (((s
b9f0: 69 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30  igned char)buf[0
ba00: 5d 29 3c 3c 38 29 20 7c 20 62 75 66 5b 31 5d 3b  ])<<8) | buf[1];
ba10: 0a 20 20 20 20 20 20 75 33 32 20 79 20 3d 20 28  .      u32 y = (
ba20: 62 75 66 5b 32 5d 3c 3c 32 34 29 20 7c 20 28 62  buf[2]<<24) | (b
ba30: 75 66 5b 33 5d 3c 3c 31 36 29 20 7c 20 28 62 75  uf[3]<<16) | (bu
ba40: 66 5b 34 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 35  f[4]<<8) | buf[5
ba50: 5d 3b 0a 20 20 20 20 20 20 78 20 3d 20 28 78 3c  ];.      x = (x<
ba60: 3c 33 32 29 20 7c 20 79 3b 0a 20 20 20 20 20 20  <32) | y;.      
ba70: 70 4d 65 6d 2d 3e 69 20 3d 20 2a 28 69 36 34 2a  pMem->i = *(i64*
ba80: 29 26 78 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  )&x;.      pMem-
ba90: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74  >flags = MEM_Int
baa0: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 36  ;.      return 6
bab0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
bac0: 20 36 3a 20 20 20 2f 2a 20 38 2d 62 79 74 65 20   6:   /* 8-byte 
bad0: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a  signed integer *
bae0: 2f 0a 20 20 20 20 63 61 73 65 20 37 3a 20 7b 20  /.    case 7: { 
baf0: 2f 2a 20 49 45 45 45 20 66 6c 6f 61 74 69 6e 67  /* IEEE floating
bb00: 20 70 6f 69 6e 74 20 2a 2f 0a 20 20 20 20 20 20   point */.      
bb10: 75 36 34 20 78 3b 0a 20 20 20 20 20 20 75 33 32  u64 x;.      u32
bb20: 20 79 3b 0a 23 69 66 6e 64 65 66 20 4e 44 45 42   y;.#ifndef NDEB
bb30: 55 47 0a 20 20 20 20 20 20 2f 2a 20 56 65 72 69  UG.      /* Veri
bb40: 66 79 20 74 68 61 74 20 69 6e 74 65 67 65 72 73  fy that integers
bb50: 20 61 6e 64 20 66 6c 6f 61 74 69 6e 67 20 70 6f   and floating po
bb60: 69 6e 74 20 76 61 6c 75 65 73 20 75 73 65 20 74  int values use t
bb70: 68 65 20 73 61 6d 65 0a 20 20 20 20 20 20 2a 2a  he same.      **
bb80: 20 62 79 74 65 20 6f 72 64 65 72 2e 20 20 54 68   byte order.  Th
bb90: 65 20 62 79 74 65 20 6f 72 64 65 72 20 64 69 66  e byte order dif
bba0: 66 65 72 73 20 6f 6e 20 73 6f 6d 65 20 28 62 72  fers on some (br
bbb0: 6f 6b 65 6e 29 20 61 72 63 68 69 74 65 63 74 75  oken) architectu
bbc0: 72 65 73 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  res..      */.  
bbd0: 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74      static const
bbe0: 20 75 36 34 20 74 31 20 3d 20 28 28 75 36 34 29   u64 t1 = ((u64)
bbf0: 30 78 33 66 66 30 30 30 30 30 29 3c 3c 33 32 3b  0x3ff00000)<<32;
bc00: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 31  .      assert( 1
bc10: 2e 30 3d 3d 2a 28 64 6f 75 62 6c 65 2a 29 26 74  .0==*(double*)&t
bc20: 31 20 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 20  1 );.#endif..   
bc30: 20 20 20 78 20 3d 20 28 62 75 66 5b 30 5d 3c 3c     x = (buf[0]<<
bc40: 32 34 29 20 7c 20 28 62 75 66 5b 31 5d 3c 3c 31  24) | (buf[1]<<1
bc50: 36 29 20 7c 20 28 62 75 66 5b 32 5d 3c 3c 38 29  6) | (buf[2]<<8)
bc60: 20 7c 20 62 75 66 5b 33 5d 3b 0a 20 20 20 20 20   | buf[3];.     
bc70: 20 79 20 3d 20 28 62 75 66 5b 34 5d 3c 3c 32 34   y = (buf[4]<<24
bc80: 29 20 7c 20 28 62 75 66 5b 35 5d 3c 3c 31 36 29  ) | (buf[5]<<16)
bc90: 20 7c 20 28 62 75 66 5b 36 5d 3c 3c 38 29 20 7c   | (buf[6]<<8) |
bca0: 20 62 75 66 5b 37 5d 3b 0a 20 20 20 20 20 20 78   buf[7];.      x
bcb0: 20 3d 20 28 78 3c 3c 33 32 29 20 7c 20 79 3b 0a   = (x<<32) | y;.
bcc0: 20 20 20 20 20 20 69 66 28 20 73 65 72 69 61 6c        if( serial
bcd0: 5f 74 79 70 65 3d 3d 36 20 29 7b 0a 20 20 20 20  _type==6 ){.    
bce0: 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 2a 28      pMem->i = *(
bcf0: 69 36 34 2a 29 26 78 3b 0a 20 20 20 20 20 20 20  i64*)&x;.       
bd00: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
bd10: 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 7d 65  EM_Int;.      }e
bd20: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65  lse{.        pMe
bd30: 6d 2d 3e 72 20 3d 20 2a 28 64 6f 75 62 6c 65 2a  m->r = *(double*
bd40: 29 26 78 3b 0a 20 20 20 20 20 20 20 20 70 4d 65  )&x;.        pMe
bd50: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 52  m->flags = MEM_R
bd60: 65 61 6c 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  eal;.      }.   
bd70: 20 20 20 72 65 74 75 72 6e 20 38 3b 0a 20 20 20     return 8;.   
bd80: 20 7d 0a 20 20 20 20 63 61 73 65 20 38 3a 20 20   }.    case 8:  
bd90: 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 30 20 2a    /* Integer 0 *
bda0: 2f 0a 20 20 20 20 63 61 73 65 20 39 3a 20 7b 20  /.    case 9: { 
bdb0: 20 2f 2a 20 49 6e 74 65 67 65 72 20 31 20 2a 2f   /* Integer 1 */
bdc0: 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d  .      pMem->i =
bdd0: 20 73 65 72 69 61 6c 5f 74 79 70 65 2d 38 3b 0a   serial_type-8;.
bde0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67        pMem->flag
bdf0: 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20  s = MEM_Int;.   
be00: 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 20     return 0;.   
be10: 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 3a 20   }.    default: 
be20: 7b 0a 20 20 20 20 20 20 69 6e 74 20 6c 65 6e 20  {.      int len 
be30: 3d 20 28 73 65 72 69 61 6c 5f 74 79 70 65 2d 31  = (serial_type-1
be40: 32 29 2f 32 3b 0a 20 20 20 20 20 20 70 4d 65 6d  2)/2;.      pMem
be50: 2d 3e 7a 20 3d 20 28 63 68 61 72 20 2a 29 62 75  ->z = (char *)bu
be60: 66 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 6e  f;.      pMem->n
be70: 20 3d 20 6c 65 6e 3b 0a 20 20 20 20 20 20 70 4d   = len;.      pM
be80: 65 6d 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20  em->xDel = 0;.  
be90: 20 20 20 20 69 66 28 20 73 65 72 69 61 6c 5f 74      if( serial_t
bea0: 79 70 65 26 30 78 30 31 20 29 7b 0a 20 20 20 20  ype&0x01 ){.    
beb0: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
bec0: 3d 20 4d 45 4d 5f 53 74 72 20 7c 20 4d 45 4d 5f  = MEM_Str | MEM_
bed0: 45 70 68 65 6d 3b 0a 20 20 20 20 20 20 7d 65 6c  Ephem;.      }el
bee0: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d  se{.        pMem
bef0: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 42 6c  ->flags = MEM_Bl
bf00: 6f 62 20 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a  ob | MEM_Ephem;.
bf10: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 65        }.      re
bf20: 74 75 72 6e 20 6c 65 6e 3b 0a 20 20 20 20 7d 0a  turn len;.    }.
bf30: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a    }.  return 0;.
bf40: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 68 65 61  }../*.** The hea
bf50: 64 65 72 20 6f 66 20 61 20 72 65 63 6f 72 64 20  der of a record 
bf60: 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 73 65  consists of a se
bf70: 71 75 65 6e 63 65 20 76 61 72 69 61 62 6c 65 2d  quence variable-
bf80: 6c 65 6e 67 74 68 20 69 6e 74 65 67 65 72 73 2e  length integers.
bf90: 0a 2a 2a 20 54 68 65 73 65 20 69 6e 74 65 67 65  .** These intege
bfa0: 72 73 20 61 72 65 20 61 6c 6d 6f 73 74 20 61 6c  rs are almost al
bfb0: 77 61 79 73 20 73 6d 61 6c 6c 20 61 6e 64 20 61  ways small and a
bfc0: 72 65 20 65 6e 63 6f 64 65 64 20 61 73 20 61 20  re encoded as a 
bfd0: 73 69 6e 67 6c 65 20 62 79 74 65 2e 0a 2a 2a 20  single byte..** 
bfe0: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6d 61  The following ma
bff0: 63 72 6f 20 74 61 6b 65 73 20 61 64 76 61 6e 74  cro takes advant
c000: 61 67 65 20 74 68 69 73 20 66 61 63 74 20 74 6f  age this fact to
c010: 20 70 72 6f 76 69 64 65 20 61 20 66 61 73 74 20   provide a fast 
c020: 64 65 63 6f 64 65 0a 2a 2a 20 6f 66 20 74 68 65  decode.** of the
c030: 20 69 6e 74 65 67 65 72 73 20 69 6e 20 61 20 72   integers in a r
c040: 65 63 6f 72 64 20 68 65 61 64 65 72 2e 20 20 49  ecord header.  I
c050: 74 20 69 73 20 66 61 73 74 65 72 20 66 6f 72 20  t is faster for 
c060: 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 73 65 0a  the common case.
c070: 2a 2a 20 77 68 65 72 65 20 74 68 65 20 69 6e 74  ** where the int
c080: 65 67 65 72 20 69 73 20 61 20 73 69 6e 67 6c 65  eger is a single
c090: 20 62 79 74 65 2e 20 20 49 74 20 69 73 20 61 20   byte.  It is a 
c0a0: 6c 69 74 74 6c 65 20 73 6c 6f 77 65 72 20 77 68  little slower wh
c0b0: 65 6e 20 74 68 65 0a 2a 2a 20 69 6e 74 65 67 65  en the.** intege
c0c0: 72 20 69 73 20 74 77 6f 20 6f 72 20 6d 6f 72 65  r is two or more
c0d0: 20 62 79 74 65 73 2e 20 20 42 75 74 20 6f 76 65   bytes.  But ove
c0e0: 72 61 6c 6c 20 69 74 20 69 73 20 66 61 73 74 65  rall it is faste
c0f0: 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c  r..**.** The fol
c100: 6c 6f 77 69 6e 67 20 65 78 70 72 65 73 73 69 6f  lowing expressio
c110: 6e 73 20 61 72 65 20 65 71 75 69 76 61 6c 65 6e  ns are equivalen
c120: 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 78 20 3d  t:.**.**     x =
c130: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
c140: 74 33 32 28 20 41 2c 20 26 42 20 29 3b 0a 2a 2a  t32( A, &B );.**
c150: 0a 2a 2a 20 20 20 20 20 78 20 3d 20 47 65 74 56  .**     x = GetV
c160: 61 72 69 6e 74 28 20 41 2c 20 42 20 29 3b 0a 2a  arint( A, B );.*
c170: 2a 0a 2a 2f 0a 23 64 65 66 69 6e 65 20 47 65 74  *.*/.#define Get
c180: 56 61 72 69 6e 74 28 41 2c 42 29 20 20 28 28 42  Varint(A,B)  ((B
c190: 20 3d 20 2a 28 41 29 29 3c 3d 30 78 37 66 20 3f   = *(A))<=0x7f ?
c1a0: 20 31 20 3a 20 73 71 6c 69 74 65 33 47 65 74 56   1 : sqlite3GetV
c1b0: 61 72 69 6e 74 33 32 28 41 2c 20 26 42 29 29 0a  arint32(A, &B)).
c1c0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
c1d0: 74 69 6f 6e 20 63 6f 6d 70 61 72 65 73 20 74 68  tion compares th
c1e0: 65 20 74 77 6f 20 74 61 62 6c 65 20 72 6f 77 73  e two table rows
c1f0: 20 6f 72 20 69 6e 64 65 78 20 72 65 63 6f 72 64   or index record
c200: 73 20 73 70 65 63 69 66 69 65 64 20 62 79 20 0a  s specified by .
c210: 2a 2a 20 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31  ** {nKey1, pKey1
c220: 7d 20 61 6e 64 20 7b 6e 4b 65 79 32 2c 20 70 4b  } and {nKey2, pK
c230: 65 79 32 7d 2c 20 72 65 74 75 72 6e 69 6e 67 20  ey2}, returning 
c240: 61 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f  a negative, zero
c250: 0a 2a 2a 20 6f 72 20 70 6f 73 69 74 69 76 65 20  .** or positive 
c260: 69 6e 74 65 67 65 72 20 69 66 20 7b 6e 4b 65 79  integer if {nKey
c270: 31 2c 20 70 4b 65 79 31 7d 20 69 73 20 6c 65 73  1, pKey1} is les
c280: 73 20 74 68 61 6e 2c 20 65 71 75 61 6c 20 74 6f  s than, equal to
c290: 20 6f 72 20 0a 2a 2a 20 67 72 65 61 74 65 72 20   or .** greater 
c2a0: 74 68 61 6e 20 7b 6e 4b 65 79 32 2c 20 70 4b 65  than {nKey2, pKe
c2b0: 79 32 7d 2e 20 20 42 6f 74 68 20 4b 65 79 31 20  y2}.  Both Key1 
c2c0: 61 6e 64 20 4b 65 79 32 20 6d 75 73 74 20 62 65  and Key2 must be
c2d0: 20 62 79 74 65 20 73 74 72 69 6e 67 73 0a 2a 2a   byte strings.**
c2e0: 20 63 6f 6d 70 6f 73 65 64 20 62 79 20 74 68 65   composed by the
c2f0: 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f   OP_MakeRecord o
c300: 70 63 6f 64 65 20 6f 66 20 74 68 65 20 56 44 42  pcode of the VDB
c310: 45 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  E..*/.int sqlite
c320: 33 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61  3VdbeRecordCompa
c330: 72 65 28 0a 20 20 76 6f 69 64 20 2a 75 73 65 72  re(.  void *user
c340: 44 61 74 61 2c 0a 20 20 69 6e 74 20 6e 4b 65 79  Data,.  int nKey
c350: 31 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 70  1, const void *p
c360: 4b 65 79 31 2c 20 0a 20 20 69 6e 74 20 6e 4b 65  Key1, .  int nKe
c370: 79 32 2c 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  y2, const void *
c380: 70 4b 65 79 32 0a 29 7b 0a 20 20 4b 65 79 49 6e  pKey2.){.  KeyIn
c390: 66 6f 20 2a 70 4b 65 79 49 6e 66 6f 20 3d 20 28  fo *pKeyInfo = (
c3a0: 4b 65 79 49 6e 66 6f 2a 29 75 73 65 72 44 61 74  KeyInfo*)userDat
c3b0: 61 3b 0a 20 20 75 33 32 20 64 31 2c 20 64 32 3b  a;.  u32 d1, d2;
c3c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 66 66            /* Off
c3d0: 73 65 74 20 69 6e 74 6f 20 61 4b 65 79 5b 5d 20  set into aKey[] 
c3e0: 6f 66 20 6e 65 78 74 20 64 61 74 61 20 65 6c 65  of next data ele
c3f0: 6d 65 6e 74 20 2a 2f 0a 20 20 75 33 32 20 69 64  ment */.  u32 id
c400: 78 31 2c 20 69 64 78 32 3b 20 20 20 20 20 20 2f  x1, idx2;      /
c410: 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f 20 61 4b  * Offset into aK
c420: 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20 68 65 61  ey[] of next hea
c430: 64 65 72 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20  der element */. 
c440: 20 75 33 32 20 73 7a 48 64 72 31 2c 20 73 7a 48   u32 szHdr1, szH
c450: 64 72 32 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20  dr2;  /* Number 
c460: 6f 66 20 62 79 74 65 73 20 69 6e 20 68 65 61 64  of bytes in head
c470: 65 72 20 2a 2f 0a 20 20 69 6e 74 20 69 20 3d 20  er */.  int i = 
c480: 30 3b 0a 20 20 69 6e 74 20 6e 46 69 65 6c 64 3b  0;.  int nField;
c490: 0a 20 20 69 6e 74 20 72 63 20 3d 20 30 3b 0a 20  .  int rc = 0;. 
c4a0: 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20   const unsigned 
c4b0: 63 68 61 72 20 2a 61 4b 65 79 31 20 3d 20 28 63  char *aKey1 = (c
c4c0: 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68  onst unsigned ch
c4d0: 61 72 20 2a 29 70 4b 65 79 31 3b 0a 20 20 63 6f  ar *)pKey1;.  co
c4e0: 6e 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61  nst unsigned cha
c4f0: 72 20 2a 61 4b 65 79 32 20 3d 20 28 63 6f 6e 73  r *aKey2 = (cons
c500: 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72 20  t unsigned char 
c510: 2a 29 70 4b 65 79 32 3b 0a 0a 20 20 4d 65 6d 20  *)pKey2;..  Mem 
c520: 6d 65 6d 31 3b 0a 20 20 4d 65 6d 20 6d 65 6d 32  mem1;.  Mem mem2
c530: 3b 0a 20 20 6d 65 6d 31 2e 65 6e 63 20 3d 20 70  ;.  mem1.enc = p
c540: 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20  KeyInfo->enc;.  
c550: 6d 65 6d 32 2e 65 6e 63 20 3d 20 70 4b 65 79 49  mem2.enc = pKeyI
c560: 6e 66 6f 2d 3e 65 6e 63 3b 0a 20 20 0a 20 20 69  nfo->enc;.  .  i
c570: 64 78 31 20 3d 20 47 65 74 56 61 72 69 6e 74 28  dx1 = GetVarint(
c580: 61 4b 65 79 31 2c 20 73 7a 48 64 72 31 29 3b 0a  aKey1, szHdr1);.
c590: 20 20 64 31 20 3d 20 73 7a 48 64 72 31 3b 0a 20    d1 = szHdr1;. 
c5a0: 20 69 64 78 32 20 3d 20 47 65 74 56 61 72 69 6e   idx2 = GetVarin
c5b0: 74 28 61 4b 65 79 32 2c 20 73 7a 48 64 72 32 29  t(aKey2, szHdr2)
c5c0: 3b 0a 20 20 64 32 20 3d 20 73 7a 48 64 72 32 3b  ;.  d2 = szHdr2;
c5d0: 0a 20 20 6e 46 69 65 6c 64 20 3d 20 70 4b 65 79  .  nField = pKey
c5e0: 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 3b 0a 20 20  Info->nField;.  
c5f0: 77 68 69 6c 65 28 20 69 64 78 31 3c 73 7a 48 64  while( idx1<szHd
c600: 72 31 20 26 26 20 69 64 78 32 3c 73 7a 48 64 72  r1 && idx2<szHdr
c610: 32 20 29 7b 0a 20 20 20 20 75 33 32 20 73 65 72  2 ){.    u32 ser
c620: 69 61 6c 5f 74 79 70 65 31 3b 0a 20 20 20 20 75  ial_type1;.    u
c630: 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65 32 3b  32 serial_type2;
c640: 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68  ..    /* Read th
c650: 65 20 73 65 72 69 61 6c 20 74 79 70 65 73 20 66  e serial types f
c660: 6f 72 20 74 68 65 20 6e 65 78 74 20 65 6c 65 6d  or the next elem
c670: 65 6e 74 20 69 6e 20 65 61 63 68 20 6b 65 79 2e  ent in each key.
c680: 20 2a 2f 0a 20 20 20 20 69 64 78 31 20 2b 3d 20   */.    idx1 += 
c690: 47 65 74 56 61 72 69 6e 74 28 20 61 4b 65 79 31  GetVarint( aKey1
c6a0: 2b 69 64 78 31 2c 20 73 65 72 69 61 6c 5f 74 79  +idx1, serial_ty
c6b0: 70 65 31 20 29 3b 0a 20 20 20 20 69 66 28 20 64  pe1 );.    if( d
c6c0: 31 3e 3d 6e 4b 65 79 31 20 26 26 20 73 71 6c 69  1>=nKey1 && sqli
c6d0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
c6e0: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
c6f0: 31 29 3e 30 20 29 20 62 72 65 61 6b 3b 0a 20 20  1)>0 ) break;.  
c700: 20 20 69 64 78 32 20 2b 3d 20 47 65 74 56 61 72    idx2 += GetVar
c710: 69 6e 74 28 20 61 4b 65 79 32 2b 69 64 78 32 2c  int( aKey2+idx2,
c720: 20 73 65 72 69 61 6c 5f 74 79 70 65 32 20 29 3b   serial_type2 );
c730: 0a 20 20 20 20 69 66 28 20 64 32 3e 3d 6e 4b 65  .    if( d2>=nKe
c740: 79 32 20 26 26 20 73 71 6c 69 74 65 33 56 64 62  y2 && sqlite3Vdb
c750: 65 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 73  eSerialTypeLen(s
c760: 65 72 69 61 6c 5f 74 79 70 65 32 29 3e 30 20 29  erial_type2)>0 )
c770: 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 2f 2a 20   break;..    /* 
c780: 41 73 73 65 72 74 20 74 68 61 74 20 74 68 65 72  Assert that ther
c790: 65 20 69 73 20 65 6e 6f 75 67 68 20 73 70 61 63  e is enough spac
c7a0: 65 20 6c 65 66 74 20 69 6e 20 65 61 63 68 20 6b  e left in each k
c7b0: 65 79 20 66 6f 72 20 74 68 65 20 62 6c 6f 62 20  ey for the blob 
c7c0: 6f 66 0a 20 20 20 20 2a 2a 20 64 61 74 61 20 74  of.    ** data t
c7d0: 6f 20 67 6f 20 77 69 74 68 20 74 68 65 20 73 65  o go with the se
c7e0: 72 69 61 6c 20 74 79 70 65 20 6a 75 73 74 20 72  rial type just r
c7f0: 65 61 64 2e 20 54 68 69 73 20 61 73 73 65 72 74  ead. This assert
c800: 20 6d 61 79 20 66 61 69 6c 20 69 66 0a 20 20 20   may fail if.   
c810: 20 2a 2a 20 74 68 65 20 66 69 6c 65 20 69 73 20   ** the file is 
c820: 63 6f 72 72 75 70 74 65 64 2e 20 20 54 68 65 6e  corrupted.  Then
c830: 20 72 65 61 64 20 74 68 65 20 76 61 6c 75 65 20   read the value 
c840: 66 72 6f 6d 20 65 61 63 68 20 6b 65 79 20 69 6e  from each key in
c850: 74 6f 20 6d 65 6d 31 0a 20 20 20 20 2a 2a 20 61  to mem1.    ** a
c860: 6e 64 20 6d 65 6d 32 20 72 65 73 70 65 63 74 69  nd mem2 respecti
c870: 76 65 6c 79 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  vely..    */.   
c880: 20 64 31 20 2b 3d 20 73 71 6c 69 74 65 33 56 64   d1 += sqlite3Vd
c890: 62 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b 65  beSerialGet(&aKe
c8a0: 79 31 5b 64 31 5d 2c 20 73 65 72 69 61 6c 5f 74  y1[d1], serial_t
c8b0: 79 70 65 31 2c 20 26 6d 65 6d 31 29 3b 0a 20 20  ype1, &mem1);.  
c8c0: 20 20 64 32 20 2b 3d 20 73 71 6c 69 74 65 33 56    d2 += sqlite3V
c8d0: 64 62 65 53 65 72 69 61 6c 47 65 74 28 26 61 4b  dbeSerialGet(&aK
c8e0: 65 79 32 5b 64 32 5d 2c 20 73 65 72 69 61 6c 5f  ey2[d2], serial_
c8f0: 74 79 70 65 32 2c 20 26 6d 65 6d 32 29 3b 0a 0a  type2, &mem2);..
c900: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
c910: 4d 65 6d 43 6f 6d 70 61 72 65 28 26 6d 65 6d 31  MemCompare(&mem1
c920: 2c 20 26 6d 65 6d 32 2c 20 69 3c 6e 46 69 65 6c  , &mem2, i<nFiel
c930: 64 20 3f 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 43  d ? pKeyInfo->aC
c940: 6f 6c 6c 5b 69 5d 20 3a 20 30 29 3b 0a 20 20 20  oll[i] : 0);.   
c950: 20 69 66 28 20 6d 65 6d 31 2e 66 6c 61 67 73 20   if( mem1.flags 
c960: 26 20 4d 45 4d 5f 44 79 6e 20 29 20 73 71 6c 69  & MEM_Dyn ) sqli
c970: 74 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73  te3VdbeMemReleas
c980: 65 28 26 6d 65 6d 31 29 3b 0a 20 20 20 20 69 66  e(&mem1);.    if
c990: 28 20 6d 65 6d 32 2e 66 6c 61 67 73 20 26 20 4d  ( mem2.flags & M
c9a0: 45 4d 5f 44 79 6e 20 29 20 73 71 6c 69 74 65 33  EM_Dyn ) sqlite3
c9b0: 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28 26  VdbeMemRelease(&
c9c0: 6d 65 6d 32 29 3b 0a 20 20 20 20 69 66 28 20 72  mem2);.    if( r
c9d0: 63 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 62 72  c!=0 ){.      br
c9e0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69  eak;.    }.    i
c9f0: 2b 2b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4f 6e  ++;.  }..  /* On
ca00: 65 20 6f 66 20 74 68 65 20 6b 65 79 73 20 72 61  e of the keys ra
ca10: 6e 20 6f 75 74 20 6f 66 20 66 69 65 6c 64 73 2c  n out of fields,
ca20: 20 62 75 74 20 61 6c 6c 20 74 68 65 20 66 69 65   but all the fie
ca30: 6c 64 73 20 75 70 20 74 6f 20 74 68 61 74 20 70  lds up to that p
ca40: 6f 69 6e 74 0a 20 20 2a 2a 20 77 65 72 65 20 65  oint.  ** were e
ca50: 71 75 61 6c 2e 20 49 66 20 74 68 65 20 69 6e 63  qual. If the inc
ca60: 72 4b 65 79 20 66 6c 61 67 20 69 73 20 74 72 75  rKey flag is tru
ca70: 65 2c 20 74 68 65 6e 20 74 68 65 20 73 65 63 6f  e, then the seco
ca80: 6e 64 20 6b 65 79 20 69 73 0a 20 20 2a 2a 20 74  nd key is.  ** t
ca90: 72 65 61 74 65 64 20 61 73 20 6c 61 72 67 65 72  reated as larger
caa0: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d  ..  */.  if( rc=
cab0: 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 4b  =0 ){.    if( pK
cac0: 65 79 49 6e 66 6f 2d 3e 69 6e 63 72 4b 65 79 20  eyInfo->incrKey 
cad0: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 2d 31  ){.      rc = -1
cae0: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
caf0: 64 31 3c 6e 4b 65 79 31 20 29 7b 0a 20 20 20 20  d1<nKey1 ){.    
cb00: 20 20 72 63 20 3d 20 31 3b 0a 20 20 20 20 7d 65    rc = 1;.    }e
cb10: 6c 73 65 20 69 66 28 20 64 32 3c 6e 4b 65 79 32  lse if( d2<nKey2
cb20: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 2d   ){.      rc = -
cb30: 31 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  1;.    }.  }else
cb40: 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 61   if( pKeyInfo->a
cb50: 53 6f 72 74 4f 72 64 65 72 20 26 26 20 69 3c 70  SortOrder && i<p
cb60: 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 0a  KeyInfo->nField.
cb70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 26                 &
cb80: 26 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72  & pKeyInfo->aSor
cb90: 74 4f 72 64 65 72 5b 69 5d 20 29 7b 0a 20 20 20  tOrder[i] ){.   
cba0: 20 72 63 20 3d 20 2d 72 63 3b 0a 20 20 7d 0a 0a   rc = -rc;.  }..
cbb0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
cbc0: 2f 2a 0a 2a 2a 20 54 68 65 20 61 72 67 75 6d 65  /*.** The argume
cbd0: 6e 74 20 69 73 20 61 6e 20 69 6e 64 65 78 20 65  nt is an index e
cbe0: 6e 74 72 79 20 63 6f 6d 70 6f 73 65 64 20 75 73  ntry composed us
cbf0: 69 6e 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52  ing the OP_MakeR
cc00: 65 63 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a  ecord opcode..**
cc10: 20 54 68 65 20 6c 61 73 74 20 65 6e 74 72 79 20   The last entry 
cc20: 69 6e 20 74 68 69 73 20 72 65 63 6f 72 64 20 73  in this record s
cc30: 68 6f 75 6c 64 20 62 65 20 61 6e 20 69 6e 74 65  hould be an inte
cc40: 67 65 72 20 28 73 70 65 63 69 66 69 63 61 6c 6c  ger (specificall
cc50: 79 0a 2a 2a 20 61 6e 20 69 6e 74 65 67 65 72 20  y.** an integer 
cc60: 72 6f 77 69 64 29 2e 20 20 54 68 69 73 20 72 6f  rowid).  This ro
cc70: 75 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 68  utine returns th
cc80: 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65  e number of byte
cc90: 73 20 69 6e 0a 2a 2a 20 74 68 61 74 20 69 6e 74  s in.** that int
cca0: 65 67 65 72 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  eger..*/.int sql
ccb0: 69 74 65 33 56 64 62 65 49 64 78 52 6f 77 69 64  ite3VdbeIdxRowid
ccc0: 4c 65 6e 28 69 6e 74 20 6e 4b 65 79 2c 20 63 6f  Len(int nKey, co
ccd0: 6e 73 74 20 75 38 20 2a 61 4b 65 79 29 7b 0a 20  nst u8 *aKey){. 
cce0: 20 75 33 32 20 73 7a 48 64 72 3b 20 20 20 20 20   u32 szHdr;     
ccf0: 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68     /* Size of th
cd00: 65 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 75 33  e header */.  u3
cd10: 32 20 74 79 70 65 52 6f 77 69 64 3b 20 20 20 20  2 typeRowid;    
cd20: 2f 2a 20 53 65 72 69 61 6c 20 74 79 70 65 20 6f  /* Serial type o
cd30: 66 20 74 68 65 20 72 6f 77 69 64 20 2a 2f 0a 0a  f the rowid */..
cd40: 20 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69    sqlite3GetVari
cd50: 6e 74 33 32 28 61 4b 65 79 2c 20 26 73 7a 48 64  nt32(aKey, &szHd
cd60: 72 29 3b 0a 20 20 73 71 6c 69 74 65 33 47 65 74  r);.  sqlite3Get
cd70: 56 61 72 69 6e 74 33 32 28 26 61 4b 65 79 5b 73  Varint32(&aKey[s
cd80: 7a 48 64 72 2d 31 5d 2c 20 26 74 79 70 65 52 6f  zHdr-1], &typeRo
cd90: 77 69 64 29 3b 0a 20 20 72 65 74 75 72 6e 20 73  wid);.  return s
cda0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
cdb0: 54 79 70 65 4c 65 6e 28 74 79 70 65 52 6f 77 69  TypeLen(typeRowi
cdc0: 64 29 3b 0a 7d 0a 20 20 0a 0a 2f 2a 0a 2a 2a 20  d);.}.  ../*.** 
cdd0: 70 43 75 72 20 70 6f 69 6e 74 73 20 61 74 20 61  pCur points at a
cde0: 6e 20 69 6e 64 65 78 20 65 6e 74 72 79 20 63 72  n index entry cr
cdf0: 65 61 74 65 64 20 75 73 69 6e 67 20 74 68 65 20  eated using the 
ce00: 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70  OP_MakeRecord op
ce10: 63 6f 64 65 2e 0a 2a 2a 20 52 65 61 64 20 74 68  code..** Read th
ce20: 65 20 72 6f 77 69 64 20 28 74 68 65 20 6c 61 73  e rowid (the las
ce30: 74 20 66 69 65 6c 64 20 69 6e 20 74 68 65 20 72  t field in the r
ce40: 65 63 6f 72 64 29 20 61 6e 64 20 73 74 6f 72 65  ecord) and store
ce50: 20 69 74 20 69 6e 20 2a 72 6f 77 69 64 2e 0a 2a   it in *rowid..*
ce60: 2a 20 52 65 74 75 72 6e 20 53 51 4c 49 54 45 5f  * Return SQLITE_
ce70: 4f 4b 20 69 66 20 65 76 65 72 79 74 68 69 6e 67  OK if everything
ce80: 20 77 6f 72 6b 73 2c 20 6f 72 20 61 6e 20 65 72   works, or an er
ce90: 72 6f 72 20 63 6f 64 65 20 6f 74 68 65 72 77 69  ror code otherwi
cea0: 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  se..*/.int sqlit
ceb0: 65 33 56 64 62 65 49 64 78 52 6f 77 69 64 28 42  e3VdbeIdxRowid(B
cec0: 74 43 75 72 73 6f 72 20 2a 70 43 75 72 2c 20 69  tCursor *pCur, i
ced0: 36 34 20 2a 72 6f 77 69 64 29 7b 0a 20 20 69 36  64 *rowid){.  i6
cee0: 34 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e  4 nCellKey;.  in
cef0: 74 20 72 63 3b 0a 20 20 75 33 32 20 73 7a 48 64  t rc;.  u32 szHd
cf00: 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a  r;        /* Siz
cf10: 65 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20  e of the header 
cf20: 2a 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f 77  */.  u32 typeRow
cf30: 69 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61 6c  id;    /* Serial
cf40: 20 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f 77   type of the row
cf50: 69 64 20 2a 2f 0a 20 20 75 33 32 20 6c 65 6e 52  id */.  u32 lenR
cf60: 6f 77 69 64 3b 20 20 20 20 20 2f 2a 20 53 69 7a  owid;     /* Siz
cf70: 65 20 6f 66 20 74 68 65 20 72 6f 77 69 64 20 2a  e of the rowid *
cf80: 2f 0a 20 20 4d 65 6d 20 6d 2c 20 76 3b 0a 0a 20  /.  Mem m, v;.. 
cf90: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79   sqlite3BtreeKey
cfa0: 53 69 7a 65 28 70 43 75 72 2c 20 26 6e 43 65 6c  Size(pCur, &nCel
cfb0: 6c 4b 65 79 29 3b 0a 20 20 69 66 28 20 6e 43 65  lKey);.  if( nCe
cfc0: 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20 20  llKey<=0 ){.    
cfd0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f  return SQLITE_CO
cfe0: 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d 0a  RRUPT_BKPT;.  }.
cff0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64    rc = sqlite3Vd
d000: 62 65 4d 65 6d 46 72 6f 6d 42 74 72 65 65 28 70  beMemFromBtree(p
d010: 43 75 72 2c 20 30 2c 20 6e 43 65 6c 6c 4b 65 79  Cur, 0, nCellKey
d020: 2c 20 31 2c 20 26 6d 29 3b 0a 20 20 69 66 28 20  , 1, &m);.  if( 
d030: 72 63 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  rc ){.    return
d040: 20 72 63 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74   rc;.  }.  sqlit
d050: 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 28 75  e3GetVarint32((u
d060: 38 2a 29 6d 2e 7a 2c 20 26 73 7a 48 64 72 29 3b  8*)m.z, &szHdr);
d070: 0a 20 20 73 71 6c 69 74 65 33 47 65 74 56 61 72  .  sqlite3GetVar
d080: 69 6e 74 33 32 28 28 75 38 2a 29 26 6d 2e 7a 5b  int32((u8*)&m.z[
d090: 73 7a 48 64 72 2d 31 5d 2c 20 26 74 79 70 65 52  szHdr-1], &typeR
d0a0: 6f 77 69 64 29 3b 0a 20 20 6c 65 6e 52 6f 77 69  owid);.  lenRowi
d0b0: 64 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53  d = sqlite3VdbeS
d0c0: 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 74 79 70  erialTypeLen(typ
d0d0: 65 52 6f 77 69 64 29 3b 0a 20 20 73 71 6c 69 74  eRowid);.  sqlit
d0e0: 65 33 56 64 62 65 53 65 72 69 61 6c 47 65 74 28  e3VdbeSerialGet(
d0f0: 28 75 38 2a 29 26 6d 2e 7a 5b 6d 2e 6e 2d 6c 65  (u8*)&m.z[m.n-le
d100: 6e 52 6f 77 69 64 5d 2c 20 74 79 70 65 52 6f 77  nRowid], typeRow
d110: 69 64 2c 20 26 76 29 3b 0a 20 20 2a 72 6f 77 69  id, &v);.  *rowi
d120: 64 20 3d 20 76 2e 69 3b 0a 20 20 73 71 6c 69 74  d = v.i;.  sqlit
d130: 65 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65  e3VdbeMemRelease
d140: 28 26 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20 53  (&m);.  return S
d150: 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a  QLITE_OK;.}../*.
d160: 2a 2a 20 43 6f 6d 70 61 72 65 20 74 68 65 20 6b  ** Compare the k
d170: 65 79 20 6f 66 20 74 68 65 20 69 6e 64 65 78 20  ey of the index 
d180: 65 6e 74 72 79 20 74 68 61 74 20 63 75 72 73 6f  entry that curso
d190: 72 20 70 43 20 69 73 20 70 6f 69 6e 74 20 74 6f  r pC is point to
d1a0: 20 61 67 61 69 6e 73 74 0a 2a 2a 20 74 68 65 20   against.** the 
d1b0: 6b 65 79 20 73 74 72 69 6e 67 20 69 6e 20 70 4b  key string in pK
d1c0: 65 79 20 28 6f 66 20 6c 65 6e 67 74 68 20 6e 4b  ey (of length nK
d1d0: 65 79 29 2e 20 20 57 72 69 74 65 20 69 6e 74 6f  ey).  Write into
d1e0: 20 2a 70 52 65 73 20 61 20 6e 75 6d 62 65 72 0a   *pRes a number.
d1f0: 2a 2a 20 74 68 61 74 20 69 73 20 6e 65 67 61 74  ** that is negat
d200: 69 76 65 2c 20 7a 65 72 6f 2c 20 6f 72 20 70 6f  ive, zero, or po
d210: 73 69 74 69 76 65 20 69 66 20 70 43 20 69 73 20  sitive if pC is 
d220: 6c 65 73 73 20 74 68 61 6e 2c 20 65 71 75 61 6c  less than, equal
d230: 20 74 6f 2c 0a 2a 2a 20 6f 72 20 67 72 65 61 74   to,.** or great
d240: 65 72 20 74 68 61 6e 20 70 4b 65 79 2e 20 20 52  er than pKey.  R
d250: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20  eturn SQLITE_OK 
d260: 6f 6e 20 73 75 63 63 65 73 73 2e 0a 2a 2a 0a 2a  on success..**.*
d270: 2a 20 70 4b 65 79 20 69 73 20 65 69 74 68 65 72  * pKey is either
d280: 20 63 72 65 61 74 65 64 20 77 69 74 68 6f 75 74   created without
d290: 20 61 20 72 6f 77 69 64 20 6f 72 20 69 73 20 74   a rowid or is t
d2a0: 72 75 6e 63 61 74 65 64 20 73 6f 20 74 68 61 74  runcated so that
d2b0: 20 69 74 0a 2a 2a 20 6f 6d 69 74 73 20 74 68 65   it.** omits the
d2c0: 20 72 6f 77 69 64 20 61 74 20 74 68 65 20 65 6e   rowid at the en
d2d0: 64 2e 20 20 54 68 65 20 72 6f 77 69 64 20 61 74  d.  The rowid at
d2e0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20   the end of the 
d2f0: 69 6e 64 65 78 20 65 6e 74 72 79 0a 2a 2a 20 69  index entry.** i
d300: 73 20 69 67 6e 6f 72 65 64 20 61 73 20 77 65 6c  s ignored as wel
d310: 6c 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  l..*/.int sqlite
d320: 33 56 64 62 65 49 64 78 4b 65 79 43 6f 6d 70 61  3VdbeIdxKeyCompa
d330: 72 65 28 0a 20 20 43 75 72 73 6f 72 20 2a 70 43  re(.  Cursor *pC
d340: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
d350: 20 20 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20    /* The cursor 
d360: 74 6f 20 63 6f 6d 70 61 72 65 20 61 67 61 69 6e  to compare again
d370: 73 74 20 2a 2f 0a 20 20 69 6e 74 20 6e 4b 65 79  st */.  int nKey
d380: 2c 20 63 6f 6e 73 74 20 75 38 20 2a 70 4b 65 79  , const u8 *pKey
d390: 2c 20 20 20 2f 2a 20 54 68 65 20 6b 65 79 20 74  ,   /* The key t
d3a0: 6f 20 63 6f 6d 70 61 72 65 20 2a 2f 0a 20 20 69  o compare */.  i
d3b0: 6e 74 20 2a 72 65 73 20 20 20 20 20 20 20 20 20  nt *res         
d3c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 72             /* Wr
d3d0: 69 74 65 20 74 68 65 20 63 6f 6d 70 61 72 69 73  ite the comparis
d3e0: 6f 6e 20 72 65 73 75 6c 74 20 68 65 72 65 20 2a  on result here *
d3f0: 2f 0a 29 7b 0a 20 20 69 36 34 20 6e 43 65 6c 6c  /.){.  i64 nCell
d400: 4b 65 79 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  Key;.  int rc;. 
d410: 20 42 74 43 75 72 73 6f 72 20 2a 70 43 75 72 20   BtCursor *pCur 
d420: 3d 20 70 43 2d 3e 70 43 75 72 73 6f 72 3b 0a 20  = pC->pCursor;. 
d430: 20 69 6e 74 20 6c 65 6e 52 6f 77 69 64 3b 0a 20   int lenRowid;. 
d440: 20 4d 65 6d 20 6d 3b 0a 0a 20 20 73 71 6c 69 74   Mem m;..  sqlit
d450: 65 33 42 74 72 65 65 4b 65 79 53 69 7a 65 28 70  e3BtreeKeySize(p
d460: 43 75 72 2c 20 26 6e 43 65 6c 6c 4b 65 79 29 3b  Cur, &nCellKey);
d470: 0a 20 20 69 66 28 20 6e 43 65 6c 6c 4b 65 79 3c  .  if( nCellKey<
d480: 3d 30 20 29 7b 0a 20 20 20 20 2a 72 65 73 20 3d  =0 ){.    *res =
d490: 20 30 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53   0;.    return S
d4a0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20  QLITE_OK;.  }.  
d4b0: 72 63 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  rc = sqlite3Vdbe
d4c0: 4d 65 6d 46 72 6f 6d 42 74 72 65 65 28 70 43 2d  MemFromBtree(pC-
d4d0: 3e 70 43 75 72 73 6f 72 2c 20 30 2c 20 6e 43 65  >pCursor, 0, nCe
d4e0: 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a 20  llKey, 1, &m);. 
d4f0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 72   if( rc ){.    r
d500: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20  eturn rc;.  }.  
d510: 6c 65 6e 52 6f 77 69 64 20 3d 20 73 71 6c 69 74  lenRowid = sqlit
d520: 65 33 56 64 62 65 49 64 78 52 6f 77 69 64 4c 65  e3VdbeIdxRowidLe
d530: 6e 28 6d 2e 6e 2c 20 28 75 38 2a 29 6d 2e 7a 29  n(m.n, (u8*)m.z)
d540: 3b 0a 20 20 2a 72 65 73 20 3d 20 73 71 6c 69 74  ;.  *res = sqlit
d550: 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70  e3VdbeRecordComp
d560: 61 72 65 28 70 43 2d 3e 70 4b 65 79 49 6e 66 6f  are(pC->pKeyInfo
d570: 2c 20 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 2c 20  , m.n-lenRowid, 
d580: 6d 2e 7a 2c 20 6e 4b 65 79 2c 20 70 4b 65 79 29  m.z, nKey, pKey)
d590: 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4d  ;.  sqlite3VdbeM
d5a0: 65 6d 52 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20  emRelease(&m);. 
d5b0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
d5c0: 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  K;.}../*.** This
d5d0: 20 72 6f 75 74 69 6e 65 20 73 65 74 73 20 74 68   routine sets th
d5e0: 65 20 76 61 6c 75 65 20 74 6f 20 62 65 20 72 65  e value to be re
d5f0: 74 75 72 6e 65 64 20 62 79 20 73 75 62 73 65 71  turned by subseq
d600: 75 65 6e 74 20 63 61 6c 6c 73 20 74 6f 0a 2a 2a  uent calls to.**
d610: 20 73 71 6c 69 74 65 33 5f 63 68 61 6e 67 65 73   sqlite3_changes
d620: 28 29 20 6f 6e 20 74 68 65 20 64 61 74 61 62 61  () on the databa
d630: 73 65 20 68 61 6e 64 6c 65 20 27 64 62 27 2e 20  se handle 'db'. 
d640: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
d650: 56 64 62 65 53 65 74 43 68 61 6e 67 65 73 28 73  VdbeSetChanges(s
d660: 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e 74 20  qlite3 *db, int 
d670: 6e 43 68 61 6e 67 65 29 7b 0a 20 20 64 62 2d 3e  nChange){.  db->
d680: 6e 43 68 61 6e 67 65 20 3d 20 6e 43 68 61 6e 67  nChange = nChang
d690: 65 3b 0a 20 20 64 62 2d 3e 6e 54 6f 74 61 6c 43  e;.  db->nTotalC
d6a0: 68 61 6e 67 65 20 2b 3d 20 6e 43 68 61 6e 67 65  hange += nChange
d6b0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 61  ;.}../*.** Set a
d6c0: 20 66 6c 61 67 20 69 6e 20 74 68 65 20 76 64 62   flag in the vdb
d6d0: 65 20 74 6f 20 75 70 64 61 74 65 20 74 68 65 20  e to update the 
d6e0: 63 68 61 6e 67 65 20 63 6f 75 6e 74 65 72 20 77  change counter w
d6f0: 68 65 6e 20 69 74 20 69 73 20 66 69 6e 61 6c 69  hen it is finali
d700: 73 65 64 0a 2a 2a 20 6f 72 20 72 65 73 65 74 2e  sed.** or reset.
d710: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
d720: 56 64 62 65 43 6f 75 6e 74 43 68 61 6e 67 65 73  VdbeCountChanges
d730: 28 56 64 62 65 20 2a 76 29 7b 0a 20 20 76 2d 3e  (Vdbe *v){.  v->
d740: 63 68 61 6e 67 65 43 6e 74 4f 6e 20 3d 20 31 3b  changeCntOn = 1;
d750: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 61 72 6b 20 65  .}../*.** Mark e
d760: 76 65 72 79 20 70 72 65 70 61 72 65 64 20 73 74  very prepared st
d770: 61 74 65 6d 65 6e 74 20 61 73 73 6f 63 69 61 74  atement associat
d780: 65 64 20 77 69 74 68 20 61 20 64 61 74 61 62 61  ed with a databa
d790: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 0a 2a 2a  se connection.**
d7a0: 20 61 73 20 65 78 70 69 72 65 64 2e 0a 2a 2a 0a   as expired..**.
d7b0: 2a 2a 20 41 6e 20 65 78 70 69 72 65 64 20 73 74  ** An expired st
d7c0: 61 74 65 6d 65 6e 74 20 6d 65 61 6e 73 20 74 68  atement means th
d7d0: 61 74 20 72 65 63 6f 6d 70 69 6c 61 74 69 6f 6e  at recompilation
d7e0: 20 6f 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e   of the statemen
d7f0: 74 20 69 73 0a 2a 2a 20 72 65 63 6f 6d 6d 65 6e  t is.** recommen
d800: 64 2e 20 20 53 74 61 74 65 6d 65 6e 74 73 20 65  d.  Statements e
d810: 78 70 69 72 65 20 77 68 65 6e 20 74 68 69 6e 67  xpire when thing
d820: 73 20 68 61 70 70 65 6e 20 74 68 61 74 20 6d 61  s happen that ma
d830: 6b 65 20 74 68 65 69 72 0a 2a 2a 20 70 72 6f 67  ke their.** prog
d840: 72 61 6d 73 20 6f 62 73 6f 6c 65 74 65 2e 20 20  rams obsolete.  
d850: 52 65 6d 6f 76 69 6e 67 20 75 73 65 72 2d 64 65  Removing user-de
d860: 66 69 6e 65 64 20 66 75 6e 63 74 69 6f 6e 73 20  fined functions 
d870: 6f 72 20 63 6f 6c 6c 61 74 69 6e 67 0a 2a 2a 20  or collating.** 
d880: 73 65 71 75 65 6e 63 65 73 2c 20 6f 72 20 63 68  sequences, or ch
d890: 61 6e 67 69 6e 67 20 61 6e 20 61 75 74 68 6f 72  anging an author
d8a0: 69 7a 61 74 69 6f 6e 20 66 75 6e 63 74 69 6f 6e  ization function
d8b0: 20 61 72 65 20 74 68 65 20 74 79 70 65 73 20 6f   are the types o
d8c0: 66 0a 2a 2a 20 74 68 69 6e 67 73 20 74 68 61 74  f.** things that
d8d0: 20 6d 61 6b 65 20 70 72 65 70 61 72 65 64 20 73   make prepared s
d8e0: 74 61 74 65 6d 65 6e 74 73 20 6f 62 73 6f 6c 65  tatements obsole
d8f0: 74 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  te..*/.void sqli
d900: 74 65 33 45 78 70 69 72 65 50 72 65 70 61 72 65  te3ExpirePrepare
d910: 64 53 74 61 74 65 6d 65 6e 74 73 28 73 71 6c 69  dStatements(sqli
d920: 74 65 33 20 2a 64 62 29 7b 0a 20 20 56 64 62 65  te3 *db){.  Vdbe
d930: 20 2a 70 3b 0a 20 20 66 6f 72 28 70 20 3d 20 64   *p;.  for(p = d
d940: 62 2d 3e 70 56 64 62 65 3b 20 70 3b 20 70 3d 70  b->pVdbe; p; p=p
d950: 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 70 2d  ->pNext){.    p-
d960: 3e 65 78 70 69 72 65 64 20 3d 20 31 3b 0a 20 20  >expired = 1;.  
d970: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72  }.}../*.** Retur
d980: 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61  n the database a
d990: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74  ssociated with t
d9a0: 68 65 20 56 64 62 65 2e 0a 2a 2f 0a 73 71 6c 69  he Vdbe..*/.sqli
d9b0: 74 65 33 20 2a 73 71 6c 69 74 65 33 56 64 62 65  te3 *sqlite3Vdbe
d9c0: 44 62 28 56 64 62 65 20 2a 76 29 7b 0a 20 20 72  Db(Vdbe *v){.  r
d9d0: 65 74 75 72 6e 20 76 2d 3e 64 62 3b 0a 7d 0a     eturn v->db;.}.