/ Hex Artifact Content
Login

Artifact 1dce6e5f51d6119220e12ecbceccccf97ca8b8be:


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: 41 6c 6c 6f 63 3c 3d 69 20 29 7b 0a 20 20 20 20  Alloc<=i ){.    
0ab0: 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20  return 0;.  }.  
0ac0: 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d  pOp = &p->aOp[i]
0ad0: 3b 0a 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20  ;.  pOp->opcode 
0ae0: 3d 20 6f 70 3b 0a 20 20 70 4f 70 2d 3e 70 31 20  = op;.  pOp->p1 
0af0: 3d 20 70 31 3b 0a 20 20 70 4f 70 2d 3e 70 32 20  = p1;.  pOp->p2 
0b00: 3d 20 70 32 3b 0a 20 20 70 4f 70 2d 3e 70 33 20  = p2;.  pOp->p3 
0b10: 3d 20 30 3b 0a 20 20 70 4f 70 2d 3e 70 33 74 79  = 0;.  pOp->p3ty
0b20: 70 65 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b  pe = P3_NOTUSED;
0b30: 0a 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d 20  .  p->expired = 
0b40: 30 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45  0;.#ifdef SQLITE
0b50: 5f 44 45 42 55 47 0a 20 20 69 66 28 20 73 71 6c  _DEBUG.  if( sql
0b60: 69 74 65 33 5f 76 64 62 65 5f 61 64 64 6f 70 5f  ite3_vdbe_addop_
0b70: 74 72 61 63 65 20 29 20 73 71 6c 69 74 65 33 56  trace ) sqlite3V
0b80: 64 62 65 50 72 69 6e 74 4f 70 28 30 2c 20 69 2c  dbePrintOp(0, i,
0b90: 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 23 65   &p->aOp[i]);.#e
0ba0: 6e 64 69 66 0a 20 20 72 65 74 75 72 6e 20 69 3b  ndif.  return i;
0bb0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 6e  .}../*.** Add an
0bc0: 20 6f 70 63 6f 64 65 20 74 68 61 74 20 69 6e 63   opcode that inc
0bd0: 6c 75 64 65 73 20 74 68 65 20 70 33 20 76 61 6c  ludes the p3 val
0be0: 75 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ue..*/.int sqlit
0bf0: 65 33 56 64 62 65 4f 70 33 28 56 64 62 65 20 2a  e3VdbeOp3(Vdbe *
0c00: 70 2c 20 69 6e 74 20 6f 70 2c 20 69 6e 74 20 70  p, int op, int p
0c10: 31 2c 20 69 6e 74 20 70 32 2c 20 63 6f 6e 73 74  1, int p2, const
0c20: 20 63 68 61 72 20 2a 7a 50 33 2c 69 6e 74 20 70   char *zP3,int p
0c30: 33 74 79 70 65 29 7b 0a 20 20 69 6e 74 20 61 64  3type){.  int ad
0c40: 64 72 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  dr = sqlite3Vdbe
0c50: 41 64 64 4f 70 28 70 2c 20 6f 70 2c 20 70 31 2c  AddOp(p, op, p1,
0c60: 20 70 32 29 3b 0a 20 20 73 71 6c 69 74 65 33 56   p2);.  sqlite3V
0c70: 64 62 65 43 68 61 6e 67 65 50 33 28 70 2c 20 61  dbeChangeP3(p, a
0c80: 64 64 72 2c 20 7a 50 33 2c 20 70 33 74 79 70 65  ddr, zP3, p3type
0c90: 29 3b 0a 20 20 72 65 74 75 72 6e 20 61 64 64 72  );.  return addr
0ca0: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74  ;.}../*.** Creat
0cb0: 65 20 61 20 6e 65 77 20 73 79 6d 62 6f 6c 69 63  e a new symbolic
0cc0: 20 6c 61 62 65 6c 20 66 6f 72 20 61 6e 20 69 6e   label for an in
0cd0: 73 74 72 75 63 74 69 6f 6e 20 74 68 61 74 20 68  struction that h
0ce0: 61 73 20 79 65 74 20 74 6f 20 62 65 0a 2a 2a 20  as yet to be.** 
0cf0: 63 6f 64 65 64 2e 20 20 54 68 65 20 73 79 6d 62  coded.  The symb
0d00: 6f 6c 69 63 20 6c 61 62 65 6c 20 69 73 20 72 65  olic label is re
0d10: 61 6c 6c 79 20 6a 75 73 74 20 61 20 6e 65 67 61  ally just a nega
0d20: 74 69 76 65 20 6e 75 6d 62 65 72 2e 20 20 54 68  tive number.  Th
0d30: 65 0a 2a 2a 20 6c 61 62 65 6c 20 63 61 6e 20 62  e.** label can b
0d40: 65 20 75 73 65 64 20 61 73 20 74 68 65 20 50 32  e used as the P2
0d50: 20 76 61 6c 75 65 20 6f 66 20 61 6e 20 6f 70 65   value of an ope
0d60: 72 61 74 69 6f 6e 2e 20 20 4c 61 74 65 72 2c 20  ration.  Later, 
0d70: 77 68 65 6e 0a 2a 2a 20 74 68 65 20 6c 61 62 65  when.** the labe
0d80: 6c 20 69 73 20 72 65 73 6f 6c 76 65 64 20 74 6f  l is resolved to
0d90: 20 61 20 73 70 65 63 69 66 69 63 20 61 64 64 72   a specific addr
0da0: 65 73 73 2c 20 74 68 65 20 56 44 42 45 20 77 69  ess, the VDBE wi
0db0: 6c 6c 20 73 63 61 6e 0a 2a 2a 20 74 68 72 6f 75  ll scan.** throu
0dc0: 67 68 20 69 74 73 20 6f 70 65 72 61 74 69 6f 6e  gh its operation
0dd0: 20 6c 69 73 74 20 61 6e 64 20 63 68 61 6e 67 65   list and change
0de0: 20 61 6c 6c 20 76 61 6c 75 65 73 20 6f 66 20 50   all values of P
0df0: 32 20 77 68 69 63 68 20 6d 61 74 63 68 0a 2a 2a  2 which match.**
0e00: 20 74 68 65 20 6c 61 62 65 6c 20 69 6e 74 6f 20   the label into 
0e10: 74 68 65 20 72 65 73 6f 6c 76 65 64 20 61 64 64  the resolved add
0e20: 72 65 73 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ress..**.** The 
0e30: 56 44 42 45 20 6b 6e 6f 77 73 20 74 68 61 74 20  VDBE knows that 
0e40: 61 20 50 32 20 76 61 6c 75 65 20 69 73 20 61 20  a P2 value is a 
0e50: 6c 61 62 65 6c 20 62 65 63 61 75 73 65 20 6c 61  label because la
0e60: 62 65 6c 73 20 61 72 65 0a 2a 2a 20 61 6c 77 61  bels are.** alwa
0e70: 79 73 20 6e 65 67 61 74 69 76 65 20 61 6e 64 20  ys negative and 
0e80: 50 32 20 76 61 6c 75 65 73 20 61 72 65 20 73 75  P2 values are su
0e90: 70 70 6f 73 65 20 74 6f 20 62 65 20 6e 6f 6e 2d  ppose to be non-
0ea0: 6e 65 67 61 74 69 76 65 2e 0a 2a 2a 20 48 65 6e  negative..** Hen
0eb0: 63 65 2c 20 61 20 6e 65 67 61 74 69 76 65 20 50  ce, a negative P
0ec0: 32 20 76 61 6c 75 65 20 69 73 20 61 20 6c 61 62  2 value is a lab
0ed0: 65 6c 20 74 68 61 74 20 68 61 73 20 79 65 74 20  el that has yet 
0ee0: 74 6f 20 62 65 20 72 65 73 6f 6c 76 65 64 2e 0a  to be resolved..
0ef0: 2a 2a 0a 2a 2a 20 5a 65 72 6f 20 69 73 20 72 65  **.** Zero is re
0f00: 74 75 72 6e 65 64 20 69 66 20 61 20 6d 61 6c 6c  turned if a mall
0f10: 6f 63 28 29 20 66 61 69 6c 73 2e 0a 2a 2f 0a 69  oc() fails..*/.i
0f20: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61  nt sqlite3VdbeMa
0f30: 6b 65 4c 61 62 65 6c 28 56 64 62 65 20 2a 70 29  keLabel(Vdbe *p)
0f40: 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 20 3d  {.  int i;.  i =
0f50: 20 70 2d 3e 6e 4c 61 62 65 6c 2b 2b 3b 0a 20 20   p->nLabel++;.  
0f60: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
0f70: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
0f80: 54 20 29 3b 0a 20 20 69 66 28 20 69 3e 3d 70 2d  T );.  if( i>=p-
0f90: 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63 20 29 7b 0a  >nLabelAlloc ){.
0fa0: 20 20 20 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c      p->nLabelAll
0fb0: 6f 63 20 3d 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c  oc = p->nLabelAl
0fc0: 6c 6f 63 2a 32 20 2b 20 31 30 3b 0a 20 20 20 20  loc*2 + 10;.    
0fd0: 73 71 6c 69 74 65 52 65 61 6c 6c 6f 63 4f 72 46  sqliteReallocOrF
0fe0: 72 65 65 28 28 76 6f 69 64 2a 2a 29 26 70 2d 3e  ree((void**)&p->
0ff0: 61 4c 61 62 65 6c 2c 0a 20 20 20 20 20 20 20 20  aLabel,.        
1000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1010: 20 20 70 2d 3e 6e 4c 61 62 65 6c 41 6c 6c 6f 63    p->nLabelAlloc
1020: 2a 73 69 7a 65 6f 66 28 70 2d 3e 61 4c 61 62 65  *sizeof(p->aLabe
1030: 6c 5b 30 5d 29 29 3b 0a 20 20 7d 0a 20 20 69 66  l[0]));.  }.  if
1040: 28 20 70 2d 3e 61 4c 61 62 65 6c 20 29 7b 0a 20  ( p->aLabel ){. 
1050: 20 20 20 70 2d 3e 61 4c 61 62 65 6c 5b 69 5d 20     p->aLabel[i] 
1060: 3d 20 2d 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75  = -1;.  }.  retu
1070: 72 6e 20 2d 31 2d 69 3b 0a 7d 0a 0a 2f 2a 0a 2a  rn -1-i;.}../*.*
1080: 2a 20 52 65 73 6f 6c 76 65 20 6c 61 62 65 6c 20  * Resolve label 
1090: 22 78 22 20 74 6f 20 62 65 20 74 68 65 20 61 64  "x" to be the ad
10a0: 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65 78  dress of the nex
10b0: 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f  t instruction to
10c0: 0a 2a 2a 20 62 65 20 69 6e 73 65 72 74 65 64 2e  .** be inserted.
10d0: 20 20 54 68 65 20 70 61 72 61 6d 65 74 65 72 20    The parameter 
10e0: 22 78 22 20 6d 75 73 74 20 68 61 76 65 20 62 65  "x" must have be
10f0: 65 6e 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  en obtained from
1100: 0a 2a 2a 20 61 20 70 72 69 6f 72 20 63 61 6c 6c  .** a prior call
1110: 20 74 6f 20 73 71 6c 69 74 65 33 56 64 62 65 4d   to sqlite3VdbeM
1120: 61 6b 65 4c 61 62 65 6c 28 29 2e 0a 2a 2f 0a 76  akeLabel()..*/.v
1130: 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 52  oid sqlite3VdbeR
1140: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 56 64 62 65  esolveLabel(Vdbe
1150: 20 2a 70 2c 20 69 6e 74 20 78 29 7b 0a 20 20 69   *p, int x){.  i
1160: 6e 74 20 6a 20 3d 20 2d 31 2d 78 3b 0a 20 20 61  nt j = -1-x;.  a
1170: 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d  ssert( p->magic=
1180: 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54  =VDBE_MAGIC_INIT
1190: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 6a 3e   );.  assert( j>
11a0: 3d 30 20 26 26 20 6a 3c 70 2d 3e 6e 4c 61 62 65  =0 && j<p->nLabe
11b0: 6c 20 29 3b 0a 20 20 69 66 28 20 70 2d 3e 61 4c  l );.  if( p->aL
11c0: 61 62 65 6c 20 29 7b 0a 20 20 20 20 70 2d 3e 61  abel ){.    p->a
11d0: 4c 61 62 65 6c 5b 6a 5d 20 3d 20 70 2d 3e 6e 4f  Label[j] = p->nO
11e0: 70 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  p;.  }.}../*.** 
11f0: 52 65 74 75 72 6e 20 6e 6f 6e 2d 7a 65 72 6f 20  Return non-zero 
1200: 69 66 20 6f 70 63 6f 64 65 20 27 6f 70 27 20 69  if opcode 'op' i
1210: 73 20 67 75 61 72 65 6e 74 65 65 64 20 6e 6f 74  s guarenteed not
1220: 20 74 6f 20 70 75 73 68 20 6d 6f 72 65 20 76 61   to push more va
1230: 6c 75 65 73 0a 2a 2a 20 6f 6e 74 6f 20 74 68 65  lues.** onto the
1240: 20 56 44 42 45 20 73 74 61 63 6b 20 74 68 61 6e   VDBE stack than
1250: 20 69 74 20 70 6f 70 73 20 6f 66 66 2e 0a 2a 2f   it pops off..*/
1260: 0a 73 74 61 74 69 63 20 69 6e 74 20 6f 70 63 6f  .static int opco
1270: 64 65 4e 6f 50 75 73 68 28 75 38 20 6f 70 29 7b  deNoPush(u8 op){
1280: 0a 20 20 2f 2a 20 54 68 65 20 31 30 20 4e 4f 50  .  /* The 10 NOP
1290: 55 53 48 5f 4d 41 53 4b 5f 6e 20 63 6f 6e 73 74  USH_MASK_n const
12a0: 61 6e 74 73 20 61 72 65 20 64 65 66 69 6e 65 64  ants are defined
12b0: 20 69 6e 20 74 68 65 20 61 75 74 6f 6d 61 74 69   in the automati
12c0: 63 61 6c 6c 79 0a 20 20 2a 2a 20 67 65 6e 65 72  cally.  ** gener
12d0: 61 74 65 64 20 68 65 61 64 65 72 20 66 69 6c 65  ated header file
12e0: 20 6f 70 63 6f 64 65 73 2e 68 2e 20 45 61 63 68   opcodes.h. Each
12f0: 20 69 73 20 61 20 31 36 2d 62 69 74 20 62 69 74   is a 16-bit bit
1300: 6d 61 73 6b 2c 20 6f 6e 65 0a 20 20 2a 2a 20 62  mask, one.  ** b
1310: 69 74 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  it corresponding
1320: 20 74 6f 20 65 61 63 68 20 6f 70 63 6f 64 65 20   to each opcode 
1330: 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79 20 74  implemented by t
1340: 68 65 20 76 69 72 74 75 61 6c 0a 20 20 2a 2a 20  he virtual.  ** 
1350: 6d 61 63 68 69 6e 65 20 69 6e 20 76 64 62 65 2e  machine in vdbe.
1360: 63 2e 20 54 68 65 20 62 69 74 20 69 73 20 74 72  c. The bit is tr
1370: 75 65 20 69 66 20 74 68 65 20 77 6f 72 64 20 22  ue if the word "
1380: 6e 6f 2d 70 75 73 68 22 20 61 70 70 65 61 72 73  no-push" appears
1390: 0a 20 20 2a 2a 20 69 6e 20 61 20 63 6f 6d 6d 65  .  ** in a comme
13a0: 6e 74 20 6f 6e 20 74 68 65 20 73 61 6d 65 20 6c  nt on the same l
13b0: 69 6e 65 20 61 73 20 74 68 65 20 22 63 61 73 65  ine as the "case
13c0: 20 4f 50 5f 58 58 58 3a 22 20 69 6e 20 0a 20 20   OP_XXX:" in .  
13d0: 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 45 78  ** sqlite3VdbeEx
13e0: 65 63 28 29 20 69 6e 20 76 64 62 65 2e 63 2e 0a  ec() in vdbe.c..
13f0: 20 20 2a 2a 0a 20 20 2a 2a 20 49 66 20 74 68 65    **.  ** If the
1400: 20 62 69 74 20 69 73 20 74 72 75 65 2c 20 74 68   bit is true, th
1410: 65 6e 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e  en the correspon
1420: 64 69 6e 67 20 6f 70 63 6f 64 65 20 69 73 20 67  ding opcode is g
1430: 75 61 72 65 6e 74 65 65 64 20 6e 6f 74 0a 20 20  uarenteed not.  
1440: 2a 2a 20 74 6f 20 67 72 6f 77 20 74 68 65 20 73  ** to grow the s
1450: 74 61 63 6b 20 77 68 65 6e 20 69 74 20 69 73 20  tack when it is 
1460: 65 78 65 63 75 74 65 64 2e 20 4f 74 68 65 72 77  executed. Otherw
1470: 69 73 65 2c 20 69 74 20 6d 61 79 20 67 72 6f 77  ise, it may grow
1480: 20 74 68 65 0a 20 20 2a 2a 20 73 74 61 63 6b 20   the.  ** stack 
1490: 62 79 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 65  by at most one e
14a0: 6e 74 72 79 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  ntry..  **.  ** 
14b0: 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 30 20 63 6f  NOPUSH_MASK_0 co
14c0: 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 6f 70 63  rresponds to opc
14d0: 6f 64 65 73 20 30 20 74 6f 20 31 35 2e 20 4e 4f  odes 0 to 15. NO
14e0: 50 55 53 48 5f 4d 41 53 4b 5f 31 20 63 6f 6e 74  PUSH_MASK_1 cont
14f0: 61 69 6e 73 0a 20 20 2a 2a 20 6f 6e 65 20 62 69  ains.  ** one bi
1500: 74 20 66 6f 72 20 6f 70 63 6f 64 65 73 20 31 36  t for opcodes 16
1510: 20 74 6f 20 33 31 2c 20 61 6e 64 20 73 6f 20 6f   to 31, and so o
1520: 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 31 36 2d  n..  **.  ** 16-
1530: 62 69 74 20 62 69 74 6d 61 73 6b 73 20 28 72 61  bit bitmasks (ra
1540: 74 68 65 72 20 74 68 61 6e 20 33 32 2d 62 69 74  ther than 32-bit
1550: 29 20 61 72 65 20 73 70 65 63 69 66 69 65 64 20  ) are specified 
1560: 69 6e 20 6f 70 63 6f 64 65 73 2e 68 20 0a 20 20  in opcodes.h .  
1570: 2a 2a 20 62 65 63 61 75 73 65 20 74 68 65 20 66  ** because the f
1580: 69 6c 65 20 69 73 20 67 65 6e 65 72 61 74 65 64  ile is generated
1590: 20 62 79 20 61 6e 20 61 77 6b 20 70 72 6f 67 72   by an awk progr
15a0: 61 6d 2e 20 41 77 6b 20 6d 61 6e 69 70 75 6c 61  am. Awk manipula
15b0: 74 65 73 0a 20 20 2a 2a 20 61 6c 6c 20 6e 75 6d  tes.  ** all num
15c0: 62 65 72 73 20 61 73 20 66 6c 6f 61 74 69 6e 67  bers as floating
15d0: 2d 70 6f 69 6e 74 20 61 6e 64 20 77 65 20 64 6f  -point and we do
15e0: 6e 27 74 20 77 61 6e 74 20 74 6f 20 72 69 73 6b  n't want to risk
15f0: 20 61 20 72 6f 75 6e 64 69 6e 67 0a 20 20 2a 2a   a rounding.  **
1600: 20 65 72 72 6f 72 20 69 66 20 73 6f 6d 65 6f 6e   error if someon
1610: 65 20 62 75 69 6c 64 73 20 77 69 74 68 20 61 6e  e builds with an
1620: 20 61 77 6b 20 74 68 61 74 20 75 73 65 73 20 28   awk that uses (
1630: 66 6f 72 20 65 78 61 6d 70 6c 65 29 20 33 32 2d  for example) 32-
1640: 62 69 74 20 0a 20 20 2a 2a 20 49 45 45 45 20 66  bit .  ** IEEE f
1650: 6c 6f 61 74 73 2e 0a 20 20 2a 2f 20 0a 20 20 73  loats..  */ .  s
1660: 74 61 74 69 63 20 63 6f 6e 73 74 20 75 33 32 20  tatic const u32 
1670: 6d 61 73 6b 73 5b 35 5d 20 3d 20 7b 0a 20 20 20  masks[5] = {.   
1680: 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 30 20 2b   NOPUSH_MASK_0 +
1690: 20 28 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 31 3c   (NOPUSH_MASK_1<
16a0: 3c 31 36 29 2c 0a 20 20 20 20 4e 4f 50 55 53 48  <16),.    NOPUSH
16b0: 5f 4d 41 53 4b 5f 32 20 2b 20 28 4e 4f 50 55 53  _MASK_2 + (NOPUS
16c0: 48 5f 4d 41 53 4b 5f 33 3c 3c 31 36 29 2c 0a 20  H_MASK_3<<16),. 
16d0: 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f 34     NOPUSH_MASK_4
16e0: 20 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53 4b 5f   + (NOPUSH_MASK_
16f0: 35 3c 3c 31 36 29 2c 0a 20 20 20 20 4e 4f 50 55  5<<16),.    NOPU
1700: 53 48 5f 4d 41 53 4b 5f 36 20 2b 20 28 4e 4f 50  SH_MASK_6 + (NOP
1710: 55 53 48 5f 4d 41 53 4b 5f 37 3c 3c 31 36 29 2c  USH_MASK_7<<16),
1720: 0a 20 20 20 20 4e 4f 50 55 53 48 5f 4d 41 53 4b  .    NOPUSH_MASK
1730: 5f 38 20 2b 20 28 4e 4f 50 55 53 48 5f 4d 41 53  _8 + (NOPUSH_MAS
1740: 4b 5f 39 3c 3c 31 36 29 0a 20 20 7d 3b 0a 20 20  K_9<<16).  };.  
1750: 61 73 73 65 72 74 28 20 6f 70 3c 33 32 2a 35 20  assert( op<32*5 
1760: 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 6d 61 73  );.  return (mas
1770: 6b 73 5b 6f 70 3e 3e 35 5d 20 26 20 28 31 3c 3c  ks[op>>5] & (1<<
1780: 28 6f 70 26 30 78 31 46 29 29 29 3b 0a 7d 0a 0a  (op&0x1F)));.}..
1790: 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a 69  #ifndef NDEBUG.i
17a0: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 4f 70  nt sqlite3VdbeOp
17b0: 63 6f 64 65 4e 6f 50 75 73 68 28 75 38 20 6f 70  codeNoPush(u8 op
17c0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 6f 70 63 6f  ){.  return opco
17d0: 64 65 4e 6f 50 75 73 68 28 6f 70 29 3b 0a 7d 0a  deNoPush(op);.}.
17e0: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 4c 6f  #endif../*.** Lo
17f0: 6f 70 20 74 68 72 6f 75 67 68 20 74 68 65 20 70  op through the p
1800: 72 6f 67 72 61 6d 20 6c 6f 6f 6b 69 6e 67 20 66  rogram looking f
1810: 6f 72 20 50 32 20 76 61 6c 75 65 73 20 74 68 61  or P2 values tha
1820: 74 20 61 72 65 20 6e 65 67 61 74 69 76 65 2e 0a  t are negative..
1830: 2a 2a 20 45 61 63 68 20 73 75 63 68 20 76 61 6c  ** Each such val
1840: 75 65 20 69 73 20 61 20 6c 61 62 65 6c 2e 20 20  ue is a label.  
1850: 52 65 73 6f 6c 76 65 20 74 68 65 20 6c 61 62 65  Resolve the labe
1860: 6c 20 62 79 20 73 65 74 74 69 6e 67 20 74 68 65  l by setting the
1870: 20 50 32 0a 2a 2a 20 76 61 6c 75 65 20 74 6f 20   P2.** value to 
1880: 69 74 73 20 63 6f 72 72 65 63 74 20 6e 6f 6e 2d  its correct non-
1890: 7a 65 72 6f 20 76 61 6c 75 65 2e 0a 2a 2a 0a 2a  zero value..**.*
18a0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69  * This routine i
18b0: 73 20 63 61 6c 6c 65 64 20 6f 6e 63 65 20 61 66  s called once af
18c0: 74 65 72 20 61 6c 6c 20 6f 70 63 6f 64 65 73 20  ter all opcodes 
18d0: 68 61 76 65 20 62 65 65 6e 20 69 6e 73 65 72 74  have been insert
18e0: 65 64 2e 0a 2a 2a 0a 2a 2a 20 56 61 72 69 61 62  ed..**.** Variab
18f0: 6c 65 20 2a 70 4d 61 78 46 75 6e 63 41 72 67 73  le *pMaxFuncArgs
1900: 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 6d   is set to the m
1910: 61 78 69 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20  aximum value of 
1920: 61 6e 79 20 50 32 20 61 72 67 75 6d 65 6e 74 20  any P2 argument 
1930: 0a 2a 2a 20 74 6f 20 61 6e 20 4f 50 5f 46 75 6e  .** to an OP_Fun
1940: 63 74 69 6f 6e 20 6f 72 20 4f 50 5f 41 67 67 53  ction or OP_AggS
1950: 74 65 70 20 6f 70 63 6f 64 65 2e 20 54 68 69 73  tep opcode. This
1960: 20 69 73 20 75 73 65 64 20 62 79 20 0a 2a 2a 20   is used by .** 
1970: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 52  sqlite3VdbeMakeR
1980: 65 61 64 79 28 29 20 74 6f 20 73 69 7a 65 20 74  eady() to size t
1990: 68 65 20 56 64 62 65 2e 61 70 41 72 67 5b 5d 20  he Vdbe.apArg[] 
19a0: 61 72 72 61 79 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  array..**.** The
19b0: 20 69 6e 74 65 67 65 72 20 2a 70 4d 61 78 53 74   integer *pMaxSt
19c0: 61 63 6b 20 69 73 20 73 65 74 20 74 6f 20 74 68  ack is set to th
19d0: 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72  e maximum number
19e0: 20 6f 66 20 76 64 62 65 20 73 74 61 63 6b 0a 2a   of vdbe stack.*
19f0: 2a 20 65 6e 74 72 69 65 73 20 74 68 61 74 20 73  * entries that s
1a00: 74 61 74 69 63 20 61 6e 61 6c 79 73 69 73 20 72  tatic analysis r
1a10: 65 76 65 61 6c 73 20 74 68 69 73 20 70 72 6f 67  eveals this prog
1a20: 72 61 6d 20 6d 69 67 68 74 20 6e 65 65 64 2e 0a  ram might need..
1a30: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  **.** This routi
1a40: 6e 65 20 61 6c 73 6f 20 64 6f 65 73 20 74 68 65  ne also does the
1a50: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69 6d   following optim
1a60: 69 7a 61 74 69 6f 6e 3a 20 20 49 74 20 73 63 61  ization:  It sca
1a70: 6e 73 20 66 6f 72 0a 2a 2a 20 48 61 6c 74 20 69  ns for.** Halt i
1a80: 6e 73 74 72 75 63 74 69 6f 6e 73 20 77 68 65 72  nstructions wher
1a90: 65 20 50 31 3d 3d 53 51 4c 49 54 45 5f 43 4f 4e  e P1==SQLITE_CON
1aa0: 53 54 52 41 49 4e 54 20 6f 72 20 50 32 3d 3d 4f  STRAINT or P2==O
1ab0: 45 5f 41 62 6f 72 74 20 6f 72 20 66 6f 72 0a 2a  E_Abort or for.*
1ac0: 2a 20 49 64 78 49 6e 73 65 72 74 20 69 6e 73 74  * IdxInsert inst
1ad0: 72 75 63 74 69 6f 6e 73 20 77 68 65 72 65 20 50  ructions where P
1ae0: 32 21 3d 30 2e 20 20 49 66 20 6e 6f 20 73 75 63  2!=0.  If no suc
1af0: 68 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73  h instruction is
1b00: 0a 2a 2a 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20  .** found, then 
1b10: 65 76 65 72 79 20 53 74 61 74 65 6d 65 6e 74 20  every Statement 
1b20: 69 6e 73 74 72 75 63 74 69 6f 6e 20 69 73 20 63  instruction is c
1b30: 68 61 6e 67 65 64 20 74 6f 20 61 20 4e 6f 6f 70  hanged to a Noop
1b40: 2e 20 20 49 6e 0a 2a 2a 20 74 68 69 73 20 77 61  .  In.** this wa
1b50: 79 2c 20 77 65 20 61 76 6f 69 64 20 63 72 65 61  y, we avoid crea
1b60: 74 69 6e 67 20 74 68 65 20 73 74 61 74 65 6d 65  ting the stateme
1b70: 6e 74 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20  nt journal file 
1b80: 75 6e 6e 65 63 65 73 73 61 72 69 6c 79 2e 0a 2a  unnecessarily..*
1b90: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 72 65  /.static void re
1ba0: 73 6f 6c 76 65 50 32 56 61 6c 75 65 73 28 56 64  solveP2Values(Vd
1bb0: 62 65 20 2a 70 2c 20 69 6e 74 20 2a 70 4d 61 78  be *p, int *pMax
1bc0: 46 75 6e 63 41 72 67 73 2c 20 69 6e 74 20 2a 70  FuncArgs, int *p
1bd0: 4d 61 78 53 74 61 63 6b 29 7b 0a 20 20 69 6e 74  MaxStack){.  int
1be0: 20 69 3b 0a 20 20 69 6e 74 20 6e 4d 61 78 41 72   i;.  int nMaxAr
1bf0: 67 73 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e 4d  gs = 0;.  int nM
1c00: 61 78 53 74 61 63 6b 20 3d 20 70 2d 3e 6e 4f 70  axStack = p->nOp
1c10: 3b 0a 20 20 4f 70 20 2a 70 4f 70 3b 0a 20 20 69  ;.  Op *pOp;.  i
1c20: 6e 74 20 2a 61 4c 61 62 65 6c 20 3d 20 70 2d 3e  nt *aLabel = p->
1c30: 61 4c 61 62 65 6c 3b 0a 20 20 69 6e 74 20 64 6f  aLabel;.  int do
1c40: 65 73 53 74 61 74 65 6d 65 6e 74 52 6f 6c 6c 62  esStatementRollb
1c50: 61 63 6b 20 3d 20 30 3b 0a 20 20 69 6e 74 20 68  ack = 0;.  int h
1c60: 61 73 53 74 61 74 65 6d 65 6e 74 42 65 67 69 6e  asStatementBegin
1c70: 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 4f 70 3d   = 0;.  for(pOp=
1c80: 70 2d 3e 61 4f 70 2c 20 69 3d 70 2d 3e 6e 4f 70  p->aOp, i=p->nOp
1c90: 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 2c 20 70  -1; i>=0; i--, p
1ca0: 4f 70 2b 2b 29 7b 0a 20 20 20 20 75 38 20 6f 70  Op++){.    u8 op
1cb0: 63 6f 64 65 20 3d 20 70 4f 70 2d 3e 6f 70 63 6f  code = pOp->opco
1cc0: 64 65 3b 0a 0a 20 20 20 20 69 66 28 20 6f 70 63  de;..    if( opc
1cd0: 6f 64 65 3d 3d 4f 50 5f 46 75 6e 63 74 69 6f 6e  ode==OP_Function
1ce0: 20 7c 7c 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 41   || opcode==OP_A
1cf0: 67 67 53 74 65 70 20 29 7b 0a 20 20 20 20 20 20  ggStep ){.      
1d00: 69 66 28 20 70 4f 70 2d 3e 70 32 3e 6e 4d 61 78  if( pOp->p2>nMax
1d10: 41 72 67 73 20 29 20 6e 4d 61 78 41 72 67 73 20  Args ) nMaxArgs 
1d20: 3d 20 70 4f 70 2d 3e 70 32 3b 0a 20 20 20 20 7d  = pOp->p2;.    }
1d30: 65 6c 73 65 20 69 66 28 20 6f 70 63 6f 64 65 3d  else if( opcode=
1d40: 3d 4f 50 5f 48 61 6c 74 20 29 7b 0a 20 20 20 20  =OP_Halt ){.    
1d50: 20 20 69 66 28 20 70 4f 70 2d 3e 70 31 3d 3d 53    if( pOp->p1==S
1d60: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54  QLITE_CONSTRAINT
1d70: 20 26 26 20 70 4f 70 2d 3e 70 32 3d 3d 4f 45 5f   && pOp->p2==OE_
1d80: 41 62 6f 72 74 20 29 7b 0a 20 20 20 20 20 20 20  Abort ){.       
1d90: 20 64 6f 65 73 53 74 61 74 65 6d 65 6e 74 52 6f   doesStatementRo
1da0: 6c 6c 62 61 63 6b 20 3d 20 31 3b 0a 20 20 20 20  llback = 1;.    
1db0: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69 66    }.    }else if
1dc0: 28 20 6f 70 63 6f 64 65 3d 3d 4f 50 5f 49 64 78  ( opcode==OP_Idx
1dd0: 49 6e 73 65 72 74 20 29 7b 0a 20 20 20 20 20 20  Insert ){.      
1de0: 69 66 28 20 70 4f 70 2d 3e 70 32 20 29 7b 0a 20  if( pOp->p2 ){. 
1df0: 20 20 20 20 20 20 20 64 6f 65 73 53 74 61 74 65         doesState
1e00: 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20 3d 20 31  mentRollback = 1
1e10: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 65  ;.      }.    }e
1e20: 6c 73 65 20 69 66 28 20 6f 70 63 6f 64 65 3d 3d  lse if( opcode==
1e30: 4f 50 5f 53 74 61 74 65 6d 65 6e 74 20 29 7b 0a  OP_Statement ){.
1e40: 20 20 20 20 20 20 68 61 73 53 74 61 74 65 6d 65        hasStateme
1e50: 6e 74 42 65 67 69 6e 20 3d 20 31 3b 0a 20 20 20  ntBegin = 1;.   
1e60: 20 7d 0a 0a 20 20 20 20 69 66 28 20 6f 70 63 6f   }..    if( opco
1e70: 64 65 4e 6f 50 75 73 68 28 6f 70 63 6f 64 65 29  deNoPush(opcode)
1e80: 20 29 7b 0a 20 20 20 20 20 20 6e 4d 61 78 53 74   ){.      nMaxSt
1e90: 61 63 6b 2d 2d 3b 0a 20 20 20 20 7d 0a 0a 20 20  ack--;.    }..  
1ea0: 20 20 69 66 28 20 70 4f 70 2d 3e 70 32 3e 3d 30    if( pOp->p2>=0
1eb0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
1ec0: 20 61 73 73 65 72 74 28 20 2d 31 2d 70 4f 70 2d   assert( -1-pOp-
1ed0: 3e 70 32 3c 70 2d 3e 6e 4c 61 62 65 6c 20 29 3b  >p2<p->nLabel );
1ee0: 0a 20 20 20 20 70 4f 70 2d 3e 70 32 20 3d 20 61  .    pOp->p2 = a
1ef0: 4c 61 62 65 6c 5b 2d 31 2d 70 4f 70 2d 3e 70 32  Label[-1-pOp->p2
1f00: 5d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 46  ];.  }.  sqliteF
1f10: 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c 29 3b 0a  ree(p->aLabel);.
1f20: 20 20 70 2d 3e 61 4c 61 62 65 6c 20 3d 20 30 3b    p->aLabel = 0;
1f30: 0a 0a 20 20 2a 70 4d 61 78 46 75 6e 63 41 72 67  ..  *pMaxFuncArg
1f40: 73 20 3d 20 6e 4d 61 78 41 72 67 73 3b 0a 20 20  s = nMaxArgs;.  
1f50: 2a 70 4d 61 78 53 74 61 63 6b 20 3d 20 6e 4d 61  *pMaxStack = nMa
1f60: 78 53 74 61 63 6b 3b 0a 0a 20 20 2f 2a 20 49 66  xStack;..  /* If
1f70: 20 77 65 20 6e 65 76 65 72 20 72 6f 6c 6c 62 61   we never rollba
1f80: 63 6b 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74  ck a statement t
1f90: 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74 68 65 6e  ransaction, then
1fa0: 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20   statement.  ** 
1fb0: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 72 65  transactions are
1fc0: 20 6e 6f 74 20 6e 65 65 64 65 64 2e 20 20 53 6f   not needed.  So
1fd0: 20 63 68 61 6e 67 65 20 65 76 65 72 79 20 4f 50   change every OP
1fe0: 5f 53 74 61 74 65 6d 65 6e 74 0a 20 20 2a 2a 20  _Statement.  ** 
1ff0: 6f 70 63 6f 64 65 20 69 6e 74 6f 20 61 6e 20 4f  opcode into an O
2000: 50 5f 4e 6f 6f 70 2e 20 20 54 68 69 73 20 61 76  P_Noop.  This av
2010: 6f 69 64 20 61 20 63 61 6c 6c 20 74 6f 20 73 71  oid a call to sq
2020: 6c 69 74 65 33 4f 73 4f 70 65 6e 45 78 63 6c 75  lite3OsOpenExclu
2030: 73 69 76 65 28 29 0a 20 20 2a 2a 20 77 68 69 63  sive().  ** whic
2040: 68 20 63 61 6e 20 62 65 20 65 78 70 65 6e 73 69  h can be expensi
2050: 76 65 20 6f 6e 20 73 6f 6d 65 20 70 6c 61 74 66  ve on some platf
2060: 6f 72 6d 73 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  orms..  */.  if(
2070: 20 68 61 73 53 74 61 74 65 6d 65 6e 74 42 65 67   hasStatementBeg
2080: 69 6e 20 26 26 20 21 64 6f 65 73 53 74 61 74 65  in && !doesState
2090: 6d 65 6e 74 52 6f 6c 6c 62 61 63 6b 20 29 7b 0a  mentRollback ){.
20a0: 20 20 20 20 66 6f 72 28 70 4f 70 3d 70 2d 3e 61      for(pOp=p->a
20b0: 4f 70 2c 20 69 3d 70 2d 3e 6e 4f 70 2d 31 3b 20  Op, i=p->nOp-1; 
20c0: 69 3e 3d 30 3b 20 69 2d 2d 2c 20 70 4f 70 2b 2b  i>=0; i--, pOp++
20d0: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 4f 70  ){.      if( pOp
20e0: 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 53 74 61  ->opcode==OP_Sta
20f0: 74 65 6d 65 6e 74 20 29 7b 0a 20 20 20 20 20 20  tement ){.      
2100: 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d 20    pOp->opcode = 
2110: 4f 50 5f 4e 6f 6f 70 3b 0a 20 20 20 20 20 20 7d  OP_Noop;.      }
2120: 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a  .    }.  }.}../*
2130: 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 61  .** Return the a
2140: 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 6e 65  ddress of the ne
2150: 78 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 74  xt instruction t
2160: 6f 20 62 65 20 69 6e 73 65 72 74 65 64 2e 0a 2a  o be inserted..*
2170: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
2180: 65 43 75 72 72 65 6e 74 41 64 64 72 28 56 64 62  eCurrentAddr(Vdb
2190: 65 20 2a 70 29 7b 0a 20 20 61 73 73 65 72 74 28  e *p){.  assert(
21a0: 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f   p->magic==VDBE_
21b0: 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20  MAGIC_INIT );.  
21c0: 72 65 74 75 72 6e 20 70 2d 3e 6e 4f 70 3b 0a 7d  return p->nOp;.}
21d0: 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 20 77 68  ../*.** Add a wh
21e0: 6f 6c 65 20 6c 69 73 74 20 6f 66 20 6f 70 65 72  ole list of oper
21f0: 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20 6f 70  ations to the op
2200: 65 72 61 74 69 6f 6e 20 73 74 61 63 6b 2e 20 20  eration stack.  
2210: 52 65 74 75 72 6e 20 74 68 65 0a 2a 2a 20 61 64  Return the.** ad
2220: 64 72 65 73 73 20 6f 66 20 74 68 65 20 66 69 72  dress of the fir
2230: 73 74 20 6f 70 65 72 61 74 69 6f 6e 20 61 64 64  st operation add
2240: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  ed..*/.int sqlit
2250: 65 33 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28  e3VdbeAddOpList(
2260: 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 6e 4f 70  Vdbe *p, int nOp
2270: 2c 20 56 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e  , VdbeOpList con
2280: 73 74 20 2a 61 4f 70 29 7b 0a 20 20 69 6e 74 20  st *aOp){.  int 
2290: 61 64 64 72 3b 0a 20 20 61 73 73 65 72 74 28 20  addr;.  assert( 
22a0: 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d  p->magic==VDBE_M
22b0: 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a 20 20 72  AGIC_INIT );.  r
22c0: 65 73 69 7a 65 4f 70 41 72 72 61 79 28 70 2c 20  esizeOpArray(p, 
22d0: 70 2d 3e 6e 4f 70 20 2b 20 6e 4f 70 29 3b 0a 20  p->nOp + nOp);. 
22e0: 20 69 66 28 20 73 71 6c 69 74 65 33 4d 61 6c 6c   if( sqlite3Mall
22f0: 6f 63 46 61 69 6c 65 64 28 29 20 29 7b 0a 20 20  ocFailed() ){.  
2300: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a    return 0;.  }.
2310: 20 20 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 3b    addr = p->nOp;
2320: 0a 20 20 69 66 28 20 6e 4f 70 3e 30 20 29 7b 0a  .  if( nOp>0 ){.
2330: 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 56      int i;.    V
2340: 64 62 65 4f 70 4c 69 73 74 20 63 6f 6e 73 74 20  dbeOpList const 
2350: 2a 70 49 6e 20 3d 20 61 4f 70 3b 0a 20 20 20 20  *pIn = aOp;.    
2360: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 4f 70 3b 20  for(i=0; i<nOp; 
2370: 69 2b 2b 2c 20 70 49 6e 2b 2b 29 7b 0a 20 20 20  i++, pIn++){.   
2380: 20 20 20 69 6e 74 20 70 32 20 3d 20 70 49 6e 2d     int p2 = pIn-
2390: 3e 70 32 3b 0a 20 20 20 20 20 20 56 64 62 65 4f  >p2;.      VdbeO
23a0: 70 20 2a 70 4f 75 74 20 3d 20 26 70 2d 3e 61 4f  p *pOut = &p->aO
23b0: 70 5b 69 2b 61 64 64 72 5d 3b 0a 20 20 20 20 20  p[i+addr];.     
23c0: 20 70 4f 75 74 2d 3e 6f 70 63 6f 64 65 20 3d 20   pOut->opcode = 
23d0: 70 49 6e 2d 3e 6f 70 63 6f 64 65 3b 0a 20 20 20  pIn->opcode;.   
23e0: 20 20 20 70 4f 75 74 2d 3e 70 31 20 3d 20 70 49     pOut->p1 = pI
23f0: 6e 2d 3e 70 31 3b 0a 20 20 20 20 20 20 70 4f 75  n->p1;.      pOu
2400: 74 2d 3e 70 32 20 3d 20 70 32 3c 30 20 3f 20 61  t->p2 = p2<0 ? a
2410: 64 64 72 20 2b 20 41 44 44 52 28 70 32 29 20 3a  ddr + ADDR(p2) :
2420: 20 70 32 3b 0a 20 20 20 20 20 20 70 4f 75 74 2d   p2;.      pOut-
2430: 3e 70 33 20 3d 20 70 49 6e 2d 3e 70 33 3b 0a 20  >p3 = pIn->p3;. 
2440: 20 20 20 20 20 70 4f 75 74 2d 3e 70 33 74 79 70       pOut->p3typ
2450: 65 20 3d 20 70 49 6e 2d 3e 70 33 20 3f 20 50 33  e = pIn->p3 ? P3
2460: 5f 53 54 41 54 49 43 20 3a 20 50 33 5f 4e 4f 54  _STATIC : P3_NOT
2470: 55 53 45 44 3b 0a 23 69 66 64 65 66 20 53 51 4c  USED;.#ifdef SQL
2480: 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 20 20  ITE_DEBUG.      
2490: 69 66 28 20 73 71 6c 69 74 65 33 5f 76 64 62 65  if( sqlite3_vdbe
24a0: 5f 61 64 64 6f 70 5f 74 72 61 63 65 20 29 7b 0a  _addop_trace ){.
24b0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
24c0: 64 62 65 50 72 69 6e 74 4f 70 28 30 2c 20 69 2b  dbePrintOp(0, i+
24d0: 61 64 64 72 2c 20 26 70 2d 3e 61 4f 70 5b 69 2b  addr, &p->aOp[i+
24e0: 61 64 64 72 5d 29 3b 0a 20 20 20 20 20 20 7d 0a  addr]);.      }.
24f0: 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 20 20 20  #endif.    }.   
2500: 20 70 2d 3e 6e 4f 70 20 2b 3d 20 6e 4f 70 3b 0a   p->nOp += nOp;.
2510: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 61 64 64    }.  return add
2520: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e  r;.}../*.** Chan
2530: 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20  ge the value of 
2540: 74 68 65 20 50 31 20 6f 70 65 72 61 6e 64 20 66  the P1 operand f
2550: 6f 72 20 61 20 73 70 65 63 69 66 69 63 20 69 6e  or a specific in
2560: 73 74 72 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68  struction..** Th
2570: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73  is routine is us
2580: 65 66 75 6c 20 77 68 65 6e 20 61 20 6c 61 72 67  eful when a larg
2590: 65 20 70 72 6f 67 72 61 6d 20 69 73 20 6c 6f 61  e program is loa
25a0: 64 65 64 20 66 72 6f 6d 20 61 0a 2a 2a 20 73 74  ded from a.** st
25b0: 61 74 69 63 20 61 72 72 61 79 20 75 73 69 6e 67  atic array using
25c0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
25d0: 70 4c 69 73 74 20 62 75 74 20 77 65 20 77 61 6e  pList but we wan
25e0: 74 20 74 6f 20 6d 61 6b 65 20 61 0a 2a 2a 20 66  t to make a.** f
25f0: 65 77 20 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73  ew minor changes
2600: 20 74 6f 20 74 68 65 20 70 72 6f 67 72 61 6d 2e   to the program.
2610: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
2620: 56 64 62 65 43 68 61 6e 67 65 50 31 28 56 64 62  VdbeChangeP1(Vdb
2630: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20  e *p, int addr, 
2640: 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65  int val){.  asse
2650: 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44  rt( p->magic==VD
2660: 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b  BE_MAGIC_INIT );
2670: 0a 20 20 69 66 28 20 70 20 26 26 20 61 64 64 72  .  if( p && addr
2680: 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f 70 3e 61 64  >=0 && p->nOp>ad
2690: 64 72 20 26 26 20 70 2d 3e 61 4f 70 20 29 7b 0a  dr && p->aOp ){.
26a0: 20 20 20 20 70 2d 3e 61 4f 70 5b 61 64 64 72 5d      p->aOp[addr]
26b0: 2e 70 31 20 3d 20 76 61 6c 3b 0a 20 20 7d 0a 7d  .p1 = val;.  }.}
26c0: 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20 74  ../*.** Change t
26d0: 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65 20  he value of the 
26e0: 50 32 20 6f 70 65 72 61 6e 64 20 66 6f 72 20 61  P2 operand for a
26f0: 20 73 70 65 63 69 66 69 63 20 69 6e 73 74 72 75   specific instru
2700: 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72  ction..** This r
2710: 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66 75 6c  outine is useful
2720: 20 66 6f 72 20 73 65 74 74 69 6e 67 20 61 20 6a   for setting a j
2730: 75 6d 70 20 64 65 73 74 69 6e 61 74 69 6f 6e 2e  ump destination.
2740: 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33  .*/.void sqlite3
2750: 56 64 62 65 43 68 61 6e 67 65 50 32 28 56 64 62  VdbeChangeP2(Vdb
2760: 65 20 2a 70 2c 20 69 6e 74 20 61 64 64 72 2c 20  e *p, int addr, 
2770: 69 6e 74 20 76 61 6c 29 7b 0a 20 20 61 73 73 65  int val){.  asse
2780: 72 74 28 20 76 61 6c 3e 3d 30 20 29 3b 0a 20 20  rt( val>=0 );.  
2790: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
27a0: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
27b0: 54 20 29 3b 0a 20 20 69 66 28 20 70 20 26 26 20  T );.  if( p && 
27c0: 61 64 64 72 3e 3d 30 20 26 26 20 70 2d 3e 6e 4f  addr>=0 && p->nO
27d0: 70 3e 61 64 64 72 20 26 26 20 70 2d 3e 61 4f 70  p>addr && p->aOp
27e0: 20 29 7b 0a 20 20 20 20 70 2d 3e 61 4f 70 5b 61   ){.    p->aOp[a
27f0: 64 64 72 5d 2e 70 32 20 3d 20 76 61 6c 3b 0a 20  ddr].p2 = val;. 
2800: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e   }.}../*.** Chan
2810: 67 65 20 74 65 68 20 50 32 20 6f 70 65 72 61 6e  ge teh P2 operan
2820: 64 20 6f 66 20 69 6e 73 74 72 75 63 74 69 6f 6e  d of instruction
2830: 20 61 64 64 72 20 73 6f 20 74 68 61 74 20 69 74   addr so that it
2840: 20 70 6f 69 6e 74 73 20 74 6f 0a 2a 2a 20 74 68   points to.** th
2850: 65 20 61 64 64 72 65 73 73 20 6f 66 20 74 68 65  e address of the
2860: 20 6e 65 78 74 20 69 6e 73 74 72 75 63 74 69 6f   next instructio
2870: 6e 20 74 6f 20 62 65 20 63 6f 64 65 64 2e 0a 2a  n to be coded..*
2880: 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64  /.void sqlite3Vd
2890: 62 65 4a 75 6d 70 48 65 72 65 28 56 64 62 65 20  beJumpHere(Vdbe 
28a0: 2a 70 2c 20 69 6e 74 20 61 64 64 72 29 7b 0a 20  *p, int addr){. 
28b0: 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e   sqlite3VdbeChan
28c0: 67 65 50 32 28 70 2c 20 61 64 64 72 2c 20 70 2d  geP2(p, addr, p-
28d0: 3e 6e 4f 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  >nOp);.}../*.** 
28e0: 44 65 6c 65 74 65 20 61 20 50 33 20 76 61 6c 75  Delete a P3 valu
28f0: 65 20 69 66 20 6e 65 63 65 73 73 61 72 79 2e 0a  e if necessary..
2900: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66  */.static void f
2910: 72 65 65 50 33 28 69 6e 74 20 70 33 74 79 70 65  reeP3(int p3type
2920: 2c 20 76 6f 69 64 20 2a 70 33 29 7b 0a 20 20 69  , void *p3){.  i
2930: 66 28 20 70 33 20 29 7b 0a 20 20 20 20 73 77 69  f( p3 ){.    swi
2940: 74 63 68 28 20 70 33 74 79 70 65 20 29 7b 0a 20  tch( p3type ){. 
2950: 20 20 20 20 20 63 61 73 65 20 50 33 5f 44 59 4e       case P3_DYN
2960: 41 4d 49 43 3a 0a 20 20 20 20 20 20 63 61 73 65  AMIC:.      case
2970: 20 50 33 5f 4b 45 59 49 4e 46 4f 3a 0a 20 20 20   P3_KEYINFO:.   
2980: 20 20 20 63 61 73 65 20 50 33 5f 4b 45 59 49 4e     case P3_KEYIN
2990: 46 4f 5f 48 41 4e 44 4f 46 46 3a 20 7b 0a 20 20  FO_HANDOFF: {.  
29a0: 20 20 20 20 20 20 73 71 6c 69 74 65 46 72 65 65        sqliteFree
29b0: 28 70 33 29 3b 0a 20 20 20 20 20 20 20 20 62 72  (p3);.        br
29c0: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  eak;.      }.   
29d0: 20 20 20 63 61 73 65 20 50 33 5f 56 44 42 45 46     case P3_VDBEF
29e0: 55 4e 43 3a 20 7b 0a 20 20 20 20 20 20 20 20 56  UNC: {.        V
29f0: 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75  dbeFunc *pVdbeFu
2a00: 6e 63 20 3d 20 28 56 64 62 65 46 75 6e 63 20 2a  nc = (VdbeFunc *
2a10: 29 70 33 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  )p3;.        sql
2a20: 69 74 65 33 56 64 62 65 44 65 6c 65 74 65 41 75  ite3VdbeDeleteAu
2a30: 78 44 61 74 61 28 70 56 64 62 65 46 75 6e 63 2c  xData(pVdbeFunc,
2a40: 20 30 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c   0);.        sql
2a50: 69 74 65 46 72 65 65 28 70 56 64 62 65 46 75 6e  iteFree(pVdbeFun
2a60: 63 29 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61  c);.        brea
2a70: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20  k;.      }.     
2a80: 20 63 61 73 65 20 50 33 5f 4d 45 4d 3a 20 7b 0a   case P3_MEM: {.
2a90: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
2aa0: 61 6c 75 65 46 72 65 65 28 28 73 71 6c 69 74 65  alueFree((sqlite
2ab0: 33 5f 76 61 6c 75 65 2a 29 70 33 29 3b 0a 20 20  3_value*)p3);.  
2ac0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
2ad0: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d     }.    }.  }.}
2ae0: 0a 0a 0a 2f 2a 0a 2a 2a 20 43 68 61 6e 67 65 20  .../*.** Change 
2af0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65  the value of the
2b00: 20 50 33 20 6f 70 65 72 61 6e 64 20 66 6f 72 20   P3 operand for 
2b10: 61 20 73 70 65 63 69 66 69 63 20 69 6e 73 74 72  a specific instr
2b20: 75 63 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20  uction..** This 
2b30: 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 66 75  routine is usefu
2b40: 6c 20 77 68 65 6e 20 61 20 6c 61 72 67 65 20 70  l when a large p
2b50: 72 6f 67 72 61 6d 20 69 73 20 6c 6f 61 64 65 64  rogram is loaded
2b60: 20 66 72 6f 6d 20 61 0a 2a 2a 20 73 74 61 74 69   from a.** stati
2b70: 63 20 61 72 72 61 79 20 75 73 69 6e 67 20 73 71  c array using sq
2b80: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 4c 69  lite3VdbeAddOpLi
2b90: 73 74 20 62 75 74 20 77 65 20 77 61 6e 74 20 74  st but we want t
2ba0: 6f 20 6d 61 6b 65 20 61 0a 2a 2a 20 66 65 77 20  o make a.** few 
2bb0: 6d 69 6e 6f 72 20 63 68 61 6e 67 65 73 20 74 6f  minor changes to
2bc0: 20 74 68 65 20 70 72 6f 67 72 61 6d 2e 0a 2a 2a   the program..**
2bd0: 0a 2a 2a 20 49 66 20 6e 3e 3d 30 20 74 68 65 6e  .** If n>=0 then
2be0: 20 74 68 65 20 50 33 20 6f 70 65 72 61 6e 64 20   the P3 operand 
2bf0: 69 73 20 64 79 6e 61 6d 69 63 2c 20 6d 65 61 6e  is dynamic, mean
2c00: 69 6e 67 20 74 68 61 74 20 61 20 63 6f 70 79 20  ing that a copy 
2c10: 6f 66 0a 2a 2a 20 74 68 65 20 73 74 72 69 6e 67  of.** the string
2c20: 20 69 73 20 6d 61 64 65 20 69 6e 74 6f 20 6d 65   is made into me
2c30: 6d 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72  mory obtained fr
2c40: 6f 6d 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28  om sqliteMalloc(
2c50: 29 2e 0a 2a 2a 20 41 20 76 61 6c 75 65 20 6f 66  )..** A value of
2c60: 20 6e 3d 3d 30 20 6d 65 61 6e 73 20 63 6f 70 79   n==0 means copy
2c70: 20 62 79 74 65 73 20 6f 66 20 7a 50 33 20 75 70   bytes of zP3 up
2c80: 20 74 6f 20 61 6e 64 20 69 6e 63 6c 75 64 69 6e   to and includin
2c90: 67 20 74 68 65 0a 2a 2a 20 66 69 72 73 74 20 6e  g the.** first n
2ca0: 75 6c 6c 20 62 79 74 65 2e 20 20 49 66 20 6e 3e  ull byte.  If n>
2cb0: 30 20 74 68 65 6e 20 63 6f 70 79 20 6e 2b 31 20  0 then copy n+1 
2cc0: 62 79 74 65 73 20 6f 66 20 7a 50 33 2e 0a 2a 2a  bytes of zP3..**
2cd0: 0a 2a 2a 20 49 66 20 6e 3d 3d 50 33 5f 4b 45 59  .** If n==P3_KEY
2ce0: 49 4e 46 4f 20 69 74 20 6d 65 61 6e 73 20 74 68  INFO it means th
2cf0: 61 74 20 7a 50 33 20 69 73 20 61 20 70 6f 69 6e  at zP3 is a poin
2d00: 74 65 72 20 74 6f 20 61 20 4b 65 79 49 6e 66 6f  ter to a KeyInfo
2d10: 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2a 20 41   structure..** A
2d20: 20 63 6f 70 79 20 69 73 20 6d 61 64 65 20 6f 66   copy is made of
2d30: 20 74 68 65 20 4b 65 79 49 6e 66 6f 20 73 74 72   the KeyInfo str
2d40: 75 63 74 75 72 65 20 69 6e 74 6f 20 6d 65 6d 6f  ucture into memo
2d50: 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f 6d  ry obtained from
2d60: 0a 2a 2a 20 73 71 6c 69 74 65 4d 61 6c 6c 6f 63  .** sqliteMalloc
2d70: 2c 20 74 6f 20 62 65 20 66 72 65 65 64 20 77 68  , to be freed wh
2d80: 65 6e 20 74 68 65 20 56 64 62 65 20 69 73 20 66  en the Vdbe is f
2d90: 69 6e 61 6c 69 7a 65 64 2e 0a 2a 2a 20 6e 3d 3d  inalized..** n==
2da0: 50 33 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f  P3_KEYINFO_HANDO
2db0: 46 46 20 69 6e 64 69 63 61 74 65 73 20 74 68 61  FF indicates tha
2dc0: 74 20 7a 50 33 20 70 6f 69 6e 74 73 20 74 6f 20  t zP3 points to 
2dd0: 61 20 4b 65 79 49 6e 66 6f 20 73 74 72 75 63 74  a KeyInfo struct
2de0: 75 72 65 0a 2a 2a 20 73 74 6f 72 65 64 20 69 6e  ure.** stored in
2df0: 20 6d 65 6d 6f 72 79 20 74 68 61 74 20 74 68 65   memory that the
2e00: 20 63 61 6c 6c 65 72 20 68 61 73 20 6f 62 74 61   caller has obta
2e10: 69 6e 65 64 20 66 72 6f 6d 20 73 71 6c 69 74 65  ined from sqlite
2e20: 4d 61 6c 6c 6f 63 2e 20 54 68 65 20 0a 2a 2a 20  Malloc. The .** 
2e30: 63 61 6c 6c 65 72 20 73 68 6f 75 6c 64 20 6e 6f  caller should no
2e40: 74 20 66 72 65 65 20 74 68 65 20 61 6c 6c 6f 63  t free the alloc
2e50: 61 74 69 6f 6e 2c 20 69 74 20 77 69 6c 6c 20 62  ation, it will b
2e60: 65 20 66 72 65 65 64 20 77 68 65 6e 20 74 68 65  e freed when the
2e70: 20 56 64 62 65 20 69 73 0a 2a 2a 20 66 69 6e 61   Vdbe is.** fina
2e80: 6c 69 7a 65 64 2e 0a 2a 2a 20 0a 2a 2a 20 4f 74  lized..** .** Ot
2e90: 68 65 72 20 76 61 6c 75 65 73 20 6f 66 20 6e 20  her values of n 
2ea0: 28 50 33 5f 53 54 41 54 49 43 2c 20 50 33 5f 43  (P3_STATIC, P3_C
2eb0: 4f 4c 4c 53 45 51 20 65 74 63 2e 29 20 69 6e 64  OLLSEQ etc.) ind
2ec0: 69 63 61 74 65 20 74 68 61 74 20 7a 50 33 20 70  icate that zP3 p
2ed0: 6f 69 6e 74 73 0a 2a 2a 20 74 6f 20 61 20 73 74  oints.** to a st
2ee0: 72 69 6e 67 20 6f 72 20 73 74 72 75 63 74 75 72  ring or structur
2ef0: 65 20 74 68 61 74 20 69 73 20 67 75 61 72 61 6e  e that is guaran
2f00: 74 65 65 64 20 74 6f 20 65 78 69 73 74 20 66 6f  teed to exist fo
2f10: 72 20 74 68 65 20 6c 69 66 65 74 69 6d 65 20 6f  r the lifetime o
2f20: 66 0a 2a 2a 20 74 68 65 20 56 64 62 65 2e 20 49  f.** the Vdbe. I
2f30: 6e 20 74 68 65 73 65 20 63 61 73 65 73 20 77 65  n these cases we
2f40: 20 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74   can just copy t
2f50: 68 65 20 70 6f 69 6e 74 65 72 2e 0a 2a 2a 0a 2a  he pointer..**.*
2f60: 2a 20 49 66 20 61 64 64 72 3c 30 20 74 68 65 6e  * If addr<0 then
2f70: 20 63 68 61 6e 67 65 20 50 33 20 6f 6e 20 74 68   change P3 on th
2f80: 65 20 6d 6f 73 74 20 72 65 63 65 6e 74 6c 79 20  e most recently 
2f90: 69 6e 73 65 72 74 65 64 20 69 6e 73 74 72 75 63  inserted instruc
2fa0: 74 69 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71  tion..*/.void sq
2fb0: 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 50  lite3VdbeChangeP
2fc0: 33 28 56 64 62 65 20 2a 70 2c 20 69 6e 74 20 61  3(Vdbe *p, int a
2fd0: 64 64 72 2c 20 63 6f 6e 73 74 20 63 68 61 72 20  ddr, const char 
2fe0: 2a 7a 50 33 2c 20 69 6e 74 20 6e 29 7b 0a 20 20  *zP3, int n){.  
2ff0: 4f 70 20 2a 70 4f 70 3b 0a 20 20 61 73 73 65 72  Op *pOp;.  asser
3000: 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d 56 44 42  t( p->magic==VDB
3010: 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 29 3b 0a  E_MAGIC_INIT );.
3020: 20 20 69 66 28 20 70 3d 3d 30 20 7c 7c 20 70 2d    if( p==0 || p-
3030: 3e 61 4f 70 3d 3d 30 20 7c 7c 20 73 71 6c 69 74  >aOp==0 || sqlit
3040: 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29  e3MallocFailed()
3050: 20 29 7b 0a 20 20 20 20 69 66 20 28 6e 20 21 3d   ){.    if (n !=
3060: 20 50 33 5f 4b 45 59 49 4e 46 4f 29 20 7b 0a 20   P3_KEYINFO) {. 
3070: 20 20 20 20 20 66 72 65 65 50 33 28 6e 2c 20 28       freeP3(n, (
3080: 76 6f 69 64 2a 29 2a 28 63 68 61 72 2a 2a 29 26  void*)*(char**)&
3090: 7a 50 33 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  zP3);.    }.    
30a0: 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20 69 66  return;.  }.  if
30b0: 28 20 61 64 64 72 3c 30 20 7c 7c 20 61 64 64 72  ( addr<0 || addr
30c0: 3e 3d 70 2d 3e 6e 4f 70 20 29 7b 0a 20 20 20 20  >=p->nOp ){.    
30d0: 61 64 64 72 20 3d 20 70 2d 3e 6e 4f 70 20 2d 20  addr = p->nOp - 
30e0: 31 3b 0a 20 20 20 20 69 66 28 20 61 64 64 72 3c  1;.    if( addr<
30f0: 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a  0 ) return;.  }.
3100: 20 20 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b    pOp = &p->aOp[
3110: 61 64 64 72 5d 3b 0a 20 20 66 72 65 65 50 33 28  addr];.  freeP3(
3120: 70 4f 70 2d 3e 70 33 74 79 70 65 2c 20 70 4f 70  pOp->p3type, pOp
3130: 2d 3e 70 33 29 3b 0a 20 20 70 4f 70 2d 3e 70 33  ->p3);.  pOp->p3
3140: 20 3d 20 30 3b 0a 20 20 69 66 28 20 7a 50 33 3d   = 0;.  if( zP3=
3150: 3d 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70  =0 ){.    pOp->p
3160: 33 20 3d 20 30 3b 0a 20 20 20 20 70 4f 70 2d 3e  3 = 0;.    pOp->
3170: 70 33 74 79 70 65 20 3d 20 50 33 5f 4e 4f 54 55  p3type = P3_NOTU
3180: 53 45 44 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28  SED;.  }else if(
3190: 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 20 29   n==P3_KEYINFO )
31a0: 7b 0a 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70  {.    KeyInfo *p
31b0: 4b 65 79 49 6e 66 6f 3b 0a 20 20 20 20 69 6e 74  KeyInfo;.    int
31c0: 20 6e 46 69 65 6c 64 2c 20 6e 42 79 74 65 3b 0a   nField, nByte;.
31d0: 0a 20 20 20 20 6e 46 69 65 6c 64 20 3d 20 28 28  .    nField = ((
31e0: 4b 65 79 49 6e 66 6f 2a 29 7a 50 33 29 2d 3e 6e  KeyInfo*)zP3)->n
31f0: 46 69 65 6c 64 3b 0a 20 20 20 20 6e 42 79 74 65  Field;.    nByte
3200: 20 3d 20 73 69 7a 65 6f 66 28 2a 70 4b 65 79 49   = sizeof(*pKeyI
3210: 6e 66 6f 29 20 2b 20 28 6e 46 69 65 6c 64 2d 31  nfo) + (nField-1
3220: 29 2a 73 69 7a 65 6f 66 28 70 4b 65 79 49 6e 66  )*sizeof(pKeyInf
3230: 6f 2d 3e 61 43 6f 6c 6c 5b 30 5d 29 20 2b 20 6e  o->aColl[0]) + n
3240: 46 69 65 6c 64 3b 0a 20 20 20 20 70 4b 65 79 49  Field;.    pKeyI
3250: 6e 66 6f 20 3d 20 73 71 6c 69 74 65 4d 61 6c 6c  nfo = sqliteMall
3260: 6f 63 52 61 77 28 20 6e 42 79 74 65 20 29 3b 0a  ocRaw( nByte );.
3270: 20 20 20 20 70 4f 70 2d 3e 70 33 20 3d 20 28 63      pOp->p3 = (c
3280: 68 61 72 2a 29 70 4b 65 79 49 6e 66 6f 3b 0a 20  har*)pKeyInfo;. 
3290: 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f 20     if( pKeyInfo 
32a0: 29 7b 0a 20 20 20 20 20 20 75 6e 73 69 67 6e 65  ){.      unsigne
32b0: 64 20 63 68 61 72 20 2a 61 53 6f 72 74 4f 72 64  d char *aSortOrd
32c0: 65 72 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79  er;.      memcpy
32d0: 28 70 4b 65 79 49 6e 66 6f 2c 20 7a 50 33 2c 20  (pKeyInfo, zP3, 
32e0: 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 61 53  nByte);.      aS
32f0: 6f 72 74 4f 72 64 65 72 20 3d 20 70 4b 65 79 49  ortOrder = pKeyI
3300: 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 3b  nfo->aSortOrder;
3310: 0a 20 20 20 20 20 20 69 66 28 20 61 53 6f 72 74  .      if( aSort
3320: 4f 72 64 65 72 20 29 7b 0a 20 20 20 20 20 20 20  Order ){.       
3330: 20 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74   pKeyInfo->aSort
3340: 4f 72 64 65 72 20 3d 20 28 75 6e 73 69 67 6e 65  Order = (unsigne
3350: 64 20 63 68 61 72 2a 29 26 70 4b 65 79 49 6e 66  d char*)&pKeyInf
3360: 6f 2d 3e 61 43 6f 6c 6c 5b 6e 46 69 65 6c 64 5d  o->aColl[nField]
3370: 3b 0a 20 20 20 20 20 20 20 20 6d 65 6d 63 70 79  ;.        memcpy
3380: 28 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74  (pKeyInfo->aSort
3390: 4f 72 64 65 72 2c 20 61 53 6f 72 74 4f 72 64 65  Order, aSortOrde
33a0: 72 2c 20 6e 46 69 65 6c 64 29 3b 0a 20 20 20 20  r, nField);.    
33b0: 20 20 7d 0a 20 20 20 20 20 20 70 4f 70 2d 3e 70    }.      pOp->p
33c0: 33 74 79 70 65 20 3d 20 50 33 5f 4b 45 59 49 4e  3type = P3_KEYIN
33d0: 46 4f 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  FO;.    }else{. 
33e0: 20 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65       pOp->p3type
33f0: 20 3d 20 50 33 5f 4e 4f 54 55 53 45 44 3b 0a 20   = P3_NOTUSED;. 
3400: 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28     }.  }else if(
3410: 20 6e 3d 3d 50 33 5f 4b 45 59 49 4e 46 4f 5f 48   n==P3_KEYINFO_H
3420: 41 4e 44 4f 46 46 20 29 7b 0a 20 20 20 20 70 4f  ANDOFF ){.    pO
3430: 70 2d 3e 70 33 20 3d 20 28 63 68 61 72 2a 29 7a  p->p3 = (char*)z
3440: 50 33 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74  P3;.    pOp->p3t
3450: 79 70 65 20 3d 20 50 33 5f 4b 45 59 49 4e 46 4f  ype = P3_KEYINFO
3460: 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 6e 3c  ;.  }else if( n<
3470: 30 20 29 7b 0a 20 20 20 20 70 4f 70 2d 3e 70 33  0 ){.    pOp->p3
3480: 20 3d 20 28 63 68 61 72 2a 29 7a 50 33 3b 0a 20   = (char*)zP3;. 
3490: 20 20 20 70 4f 70 2d 3e 70 33 74 79 70 65 20 3d     pOp->p3type =
34a0: 20 6e 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20   n;.  }else{.   
34b0: 20 69 66 28 20 6e 3d 3d 30 20 29 20 6e 20 3d 20   if( n==0 ) n = 
34c0: 73 74 72 6c 65 6e 28 7a 50 33 29 3b 0a 20 20 20  strlen(zP3);.   
34d0: 20 70 4f 70 2d 3e 70 33 20 3d 20 73 71 6c 69 74   pOp->p3 = sqlit
34e0: 65 53 74 72 4e 44 75 70 28 7a 50 33 2c 20 6e 29  eStrNDup(zP3, n)
34f0: 3b 0a 20 20 20 20 70 4f 70 2d 3e 70 33 74 79 70  ;.    pOp->p3typ
3500: 65 20 3d 20 50 33 5f 44 59 4e 41 4d 49 43 3b 0a  e = P3_DYNAMIC;.
3510: 20 20 7d 0a 7d 0a 0a 23 69 66 6e 64 65 66 20 4e    }.}..#ifndef N
3520: 44 45 42 55 47 0a 2f 2a 0a 2a 2a 20 52 65 70 6c  DEBUG./*.** Repl
3530: 61 63 65 20 74 68 65 20 50 33 20 66 69 65 6c 64  ace the P3 field
3540: 20 6f 66 20 74 68 65 20 6d 6f 73 74 20 72 65 63   of the most rec
3550: 65 6e 74 6c 79 20 63 6f 64 65 64 20 69 6e 73 74  ently coded inst
3560: 72 75 63 74 69 6f 6e 20 77 69 74 68 0a 2a 2a 20  ruction with.** 
3570: 63 6f 6d 6d 65 6e 74 20 74 65 78 74 2e 0a 2a 2f  comment text..*/
3580: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
3590: 65 43 6f 6d 6d 65 6e 74 28 56 64 62 65 20 2a 70  eComment(Vdbe *p
35a0: 2c 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46  , const char *zF
35b0: 6f 72 6d 61 74 2c 20 2e 2e 2e 29 7b 0a 20 20 76  ormat, ...){.  v
35c0: 61 5f 6c 69 73 74 20 61 70 3b 0a 20 20 61 73 73  a_list ap;.  ass
35d0: 65 72 74 28 20 70 2d 3e 6e 4f 70 3e 30 20 29 3b  ert( p->nOp>0 );
35e0: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 4f  .  assert( p->aO
35f0: 70 3d 3d 30 20 7c 7c 20 70 2d 3e 61 4f 70 5b 70  p==0 || p->aOp[p
3600: 2d 3e 6e 4f 70 2d 31 5d 2e 70 33 3d 3d 30 20 0a  ->nOp-1].p3==0 .
3610: 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 71 6c            || sql
3620: 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64  ite3MallocFailed
3630: 28 29 20 29 3b 0a 20 20 76 61 5f 73 74 61 72 74  () );.  va_start
3640: 28 61 70 2c 20 7a 46 6f 72 6d 61 74 29 3b 0a 20  (ap, zFormat);. 
3650: 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e   sqlite3VdbeChan
3660: 67 65 50 33 28 70 2c 20 2d 31 2c 20 73 71 6c 69  geP3(p, -1, sqli
3670: 74 65 33 56 4d 50 72 69 6e 74 66 28 7a 46 6f 72  te3VMPrintf(zFor
3680: 6d 61 74 2c 20 61 70 29 2c 20 50 33 5f 44 59 4e  mat, ap), P3_DYN
3690: 41 4d 49 43 29 3b 0a 20 20 76 61 5f 65 6e 64 28  AMIC);.  va_end(
36a0: 61 70 29 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a 2f  ap);.}.#endif../
36b0: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20  *.** Return the 
36c0: 6f 70 63 6f 64 65 20 66 6f 72 20 61 20 67 69 76  opcode for a giv
36d0: 65 6e 20 61 64 64 72 65 73 73 2e 0a 2a 2f 0a 56  en address..*/.V
36e0: 64 62 65 4f 70 20 2a 73 71 6c 69 74 65 33 56 64  dbeOp *sqlite3Vd
36f0: 62 65 47 65 74 4f 70 28 56 64 62 65 20 2a 70 2c  beGetOp(Vdbe *p,
3700: 20 69 6e 74 20 61 64 64 72 29 7b 0a 20 20 61 73   int addr){.  as
3710: 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63 3d 3d  sert( p->magic==
3720: 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20  VDBE_MAGIC_INIT 
3730: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 61 64 64  );.  assert( add
3740: 72 3e 3d 30 20 26 26 20 61 64 64 72 3c 70 2d 3e  r>=0 && addr<p->
3750: 6e 4f 70 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  nOp );.  return 
3760: 26 70 2d 3e 61 4f 70 5b 61 64 64 72 5d 3b 0a 7d  &p->aOp[addr];.}
3770: 0a 0a 23 69 66 20 21 64 65 66 69 6e 65 64 28 53  ..#if !defined(S
3780: 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41  QLITE_OMIT_EXPLA
3790: 49 4e 29 20 7c 7c 20 21 64 65 66 69 6e 65 64 28  IN) || !defined(
37a0: 4e 44 45 42 55 47 29 20 5c 0a 20 20 20 20 20 7c  NDEBUG) \.     |
37b0: 7c 20 64 65 66 69 6e 65 64 28 56 44 42 45 5f 50  | defined(VDBE_P
37c0: 52 4f 46 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e  ROFILE) || defin
37d0: 65 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29  ed(SQLITE_DEBUG)
37e0: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 75 74 65 20 61  ./*.** Compute a
37f0: 20 73 74 72 69 6e 67 20 74 68 61 74 20 64 65 73   string that des
3800: 63 72 69 62 65 73 20 74 68 65 20 50 33 20 70 61  cribes the P3 pa
3810: 72 61 6d 65 74 65 72 20 66 6f 72 20 61 6e 20 6f  rameter for an o
3820: 70 63 6f 64 65 2e 0a 2a 2a 20 55 73 65 20 7a 54  pcode..** Use zT
3830: 65 6d 70 20 66 6f 72 20 61 6e 79 20 72 65 71 75  emp for any requ
3840: 69 72 65 64 20 74 65 6d 70 6f 72 61 72 79 20 62  ired temporary b
3850: 75 66 66 65 72 20 73 70 61 63 65 2e 0a 2a 2f 0a  uffer space..*/.
3860: 73 74 61 74 69 63 20 63 68 61 72 20 2a 64 69 73  static char *dis
3870: 70 6c 61 79 50 33 28 4f 70 20 2a 70 4f 70 2c 20  playP3(Op *pOp, 
3880: 63 68 61 72 20 2a 7a 54 65 6d 70 2c 20 69 6e 74  char *zTemp, int
3890: 20 6e 54 65 6d 70 29 7b 0a 20 20 63 68 61 72 20   nTemp){.  char 
38a0: 2a 7a 50 33 3b 0a 20 20 61 73 73 65 72 74 28 20  *zP3;.  assert( 
38b0: 6e 54 65 6d 70 3e 3d 32 30 20 29 3b 0a 20 20 73  nTemp>=20 );.  s
38c0: 77 69 74 63 68 28 20 70 4f 70 2d 3e 70 33 74 79  witch( pOp->p3ty
38d0: 70 65 20 29 7b 0a 20 20 20 20 63 61 73 65 20 50  pe ){.    case P
38e0: 33 5f 4b 45 59 49 4e 46 4f 3a 20 7b 0a 20 20 20  3_KEYINFO: {.   
38f0: 20 20 20 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 20     int i, j;.   
3900: 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79     KeyInfo *pKey
3910: 49 6e 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a  Info = (KeyInfo*
3920: 29 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20  )pOp->p3;.      
3930: 73 70 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22  sprintf(zTemp, "
3940: 6b 65 79 69 6e 66 6f 28 25 64 22 2c 20 70 4b 65  keyinfo(%d", pKe
3950: 79 49 6e 66 6f 2d 3e 6e 46 69 65 6c 64 29 3b 0a  yInfo->nField);.
3960: 20 20 20 20 20 20 69 20 3d 20 73 74 72 6c 65 6e        i = strlen
3970: 28 7a 54 65 6d 70 29 3b 0a 20 20 20 20 20 20 66  (zTemp);.      f
3980: 6f 72 28 6a 3d 30 3b 20 6a 3c 70 4b 65 79 49 6e  or(j=0; j<pKeyIn
3990: 66 6f 2d 3e 6e 46 69 65 6c 64 3b 20 6a 2b 2b 29  fo->nField; j++)
39a0: 7b 0a 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65  {.        CollSe
39b0: 71 20 2a 70 43 6f 6c 6c 20 3d 20 70 4b 65 79 49  q *pColl = pKeyI
39c0: 6e 66 6f 2d 3e 61 43 6f 6c 6c 5b 6a 5d 3b 0a 20  nfo->aColl[j];. 
39d0: 20 20 20 20 20 20 20 69 66 28 20 70 43 6f 6c 6c         if( pColl
39e0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e   ){.          in
39f0: 74 20 6e 20 3d 20 73 74 72 6c 65 6e 28 70 43 6f  t n = strlen(pCo
3a00: 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20  ll->zName);.    
3a10: 20 20 20 20 20 20 69 66 28 20 69 2b 6e 3e 6e 54        if( i+n>nT
3a20: 65 6d 70 2d 36 20 29 7b 0a 20 20 20 20 20 20 20  emp-6 ){.       
3a30: 20 20 20 20 20 73 74 72 63 70 79 28 26 7a 54 65       strcpy(&zTe
3a40: 6d 70 5b 69 5d 2c 22 2c 2e 2e 2e 22 29 3b 0a 20  mp[i],",...");. 
3a50: 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b             break
3a60: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  ;.          }.  
3a70: 20 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b          zTemp[i+
3a80: 2b 5d 20 3d 20 27 2c 27 3b 0a 20 20 20 20 20 20  +] = ',';.      
3a90: 20 20 20 20 69 66 28 20 70 4b 65 79 49 6e 66 6f      if( pKeyInfo
3aa0: 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20 26 26 20  ->aSortOrder && 
3ab0: 70 4b 65 79 49 6e 66 6f 2d 3e 61 53 6f 72 74 4f  pKeyInfo->aSortO
3ac0: 72 64 65 72 5b 6a 5d 20 29 7b 0a 20 20 20 20 20  rder[j] ){.     
3ad0: 20 20 20 20 20 20 20 7a 54 65 6d 70 5b 69 2b 2b         zTemp[i++
3ae0: 5d 20 3d 20 27 2d 27 3b 0a 20 20 20 20 20 20 20  ] = '-';.       
3af0: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 73     }.          s
3b00: 74 72 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c  trcpy(&zTemp[i],
3b10: 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a   pColl->zName);.
3b20: 20 20 20 20 20 20 20 20 20 20 69 20 2b 3d 20 6e            i += n
3b30: 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20  ;.        }else 
3b40: 69 66 28 20 69 2b 34 3c 6e 54 65 6d 70 2d 36 20  if( i+4<nTemp-6 
3b50: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 74 72  ){.          str
3b60: 63 70 79 28 26 7a 54 65 6d 70 5b 69 5d 2c 22 2c  cpy(&zTemp[i],",
3b70: 6e 69 6c 22 29 3b 0a 20 20 20 20 20 20 20 20 20  nil");.         
3b80: 20 69 20 2b 3d 20 34 3b 0a 20 20 20 20 20 20 20   i += 4;.       
3b90: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20   }.      }.     
3ba0: 20 7a 54 65 6d 70 5b 69 2b 2b 5d 20 3d 20 27 29   zTemp[i++] = ')
3bb0: 27 3b 0a 20 20 20 20 20 20 7a 54 65 6d 70 5b 69  ';.      zTemp[i
3bc0: 5d 20 3d 20 30 3b 0a 20 20 20 20 20 20 61 73 73  ] = 0;.      ass
3bd0: 65 72 74 28 20 69 3c 6e 54 65 6d 70 20 29 3b 0a  ert( i<nTemp );.
3be0: 20 20 20 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d        zP3 = zTem
3bf0: 70 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  p;.      break;.
3c00: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 50      }.    case P
3c10: 33 5f 43 4f 4c 4c 53 45 51 3a 20 7b 0a 20 20 20  3_COLLSEQ: {.   
3c20: 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c     CollSeq *pCol
3c30: 6c 20 3d 20 28 43 6f 6c 6c 53 65 71 2a 29 70 4f  l = (CollSeq*)pO
3c40: 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 73 70 72  p->p3;.      spr
3c50: 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 63 6f 6c  intf(zTemp, "col
3c60: 6c 73 65 71 28 25 2e 32 30 73 29 22 2c 20 70 43  lseq(%.20s)", pC
3c70: 6f 6c 6c 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20  oll->zName);.   
3c80: 20 20 20 7a 50 33 20 3d 20 7a 54 65 6d 70 3b 0a     zP3 = zTemp;.
3c90: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
3ca0: 20 7d 0a 20 20 20 20 63 61 73 65 20 50 33 5f 46   }.    case P3_F
3cb0: 55 4e 43 44 45 46 3a 20 7b 0a 20 20 20 20 20 20  UNCDEF: {.      
3cc0: 46 75 6e 63 44 65 66 20 2a 70 44 65 66 20 3d 20  FuncDef *pDef = 
3cd0: 28 46 75 6e 63 44 65 66 2a 29 70 4f 70 2d 3e 70  (FuncDef*)pOp->p
3ce0: 33 3b 0a 20 20 20 20 20 20 63 68 61 72 20 7a 4e  3;.      char zN
3cf0: 75 6d 5b 33 30 5d 3b 0a 20 20 20 20 20 20 73 70  um[30];.      sp
3d00: 72 69 6e 74 66 28 7a 54 65 6d 70 2c 20 22 25 2e  rintf(zTemp, "%.
3d10: 2a 73 22 2c 20 6e 54 65 6d 70 2c 20 70 44 65 66  *s", nTemp, pDef
3d20: 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 20 20  ->zName);.      
3d30: 73 70 72 69 6e 74 66 28 7a 4e 75 6d 2c 22 28 25  sprintf(zNum,"(%
3d40: 64 29 22 2c 20 70 44 65 66 2d 3e 6e 41 72 67 29  d)", pDef->nArg)
3d50: 3b 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 6c  ;.      if( strl
3d60: 65 6e 28 7a 54 65 6d 70 29 2b 73 74 72 6c 65 6e  en(zTemp)+strlen
3d70: 28 7a 4e 75 6d 29 2b 31 3c 3d 6e 54 65 6d 70 20  (zNum)+1<=nTemp 
3d80: 29 7b 0a 20 20 20 20 20 20 20 20 73 74 72 63 61  ){.        strca
3d90: 74 28 7a 54 65 6d 70 2c 20 7a 4e 75 6d 29 3b 0a  t(zTemp, zNum);.
3da0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7a 50        }.      zP
3db0: 33 20 3d 20 7a 54 65 6d 70 3b 0a 20 20 20 20 20  3 = zTemp;.     
3dc0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20   break;.    }.  
3dd0: 20 20 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20    default: {.   
3de0: 20 20 20 7a 50 33 20 3d 20 70 4f 70 2d 3e 70 33     zP3 = pOp->p3
3df0: 3b 0a 20 20 20 20 20 20 69 66 28 20 7a 50 33 3d  ;.      if( zP3=
3e00: 3d 30 20 7c 7c 20 70 4f 70 2d 3e 6f 70 63 6f 64  =0 || pOp->opcod
3e10: 65 3d 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a 20 20  e==OP_Noop ){.  
3e20: 20 20 20 20 20 20 7a 50 33 20 3d 20 22 22 3b 0a        zP3 = "";.
3e30: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
3e40: 7d 0a 20 20 72 65 74 75 72 6e 20 7a 50 33 3b 0a  }.  return zP3;.
3e50: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 20 64  }.#endif...#if d
3e60: 65 66 69 6e 65 64 28 56 44 42 45 5f 50 52 4f 46  efined(VDBE_PROF
3e70: 49 4c 45 29 20 7c 7c 20 64 65 66 69 6e 65 64 28  ILE) || defined(
3e80: 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a 2f 2a  SQLITE_DEBUG)./*
3e90: 0a 2a 2a 20 50 72 69 6e 74 20 61 20 73 69 6e 67  .** Print a sing
3ea0: 6c 65 20 6f 70 63 6f 64 65 2e 20 20 54 68 69 73  le opcode.  This
3eb0: 20 72 6f 75 74 69 6e 65 20 69 73 20 75 73 65 64   routine is used
3ec0: 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 20 6f   for debugging o
3ed0: 6e 6c 79 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  nly..*/.void sql
3ee0: 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70 28  ite3VdbePrintOp(
3ef0: 46 49 4c 45 20 2a 70 4f 75 74 2c 20 69 6e 74 20  FILE *pOut, int 
3f00: 70 63 2c 20 4f 70 20 2a 70 4f 70 29 7b 0a 20 20  pc, Op *pOp){.  
3f10: 63 68 61 72 20 2a 7a 50 33 3b 0a 20 20 63 68 61  char *zP3;.  cha
3f20: 72 20 7a 50 74 72 5b 35 30 5d 3b 0a 20 20 73 74  r zPtr[50];.  st
3f30: 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20  atic const char 
3f40: 2a 7a 46 6f 72 6d 61 74 31 20 3d 20 22 25 34 64  *zFormat1 = "%4d
3f50: 20 25 2d 31 33 73 20 25 34 64 20 25 34 64 20 25   %-13s %4d %4d %
3f60: 73 5c 6e 22 3b 0a 20 20 69 66 28 20 70 4f 75 74  s\n";.  if( pOut
3f70: 3d 3d 30 20 29 20 70 4f 75 74 20 3d 20 73 74 64  ==0 ) pOut = std
3f80: 6f 75 74 3b 0a 20 20 7a 50 33 20 3d 20 64 69 73  out;.  zP3 = dis
3f90: 70 6c 61 79 50 33 28 70 4f 70 2c 20 7a 50 74 72  playP3(pOp, zPtr
3fa0: 2c 20 73 69 7a 65 6f 66 28 7a 50 74 72 29 29 3b  , sizeof(zPtr));
3fb0: 0a 20 20 66 70 72 69 6e 74 66 28 70 4f 75 74 2c  .  fprintf(pOut,
3fc0: 20 7a 46 6f 72 6d 61 74 31 2c 0a 20 20 20 20 20   zFormat1,.     
3fd0: 20 70 63 2c 20 73 71 6c 69 74 65 33 4f 70 63 6f   pc, sqlite3Opco
3fe0: 64 65 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70 63  deNames[pOp->opc
3ff0: 6f 64 65 5d 2c 20 70 4f 70 2d 3e 70 31 2c 20 70  ode], pOp->p1, p
4000: 4f 70 2d 3e 70 32 2c 20 7a 50 33 29 3b 0a 20 20  Op->p2, zP3);.  
4010: 66 66 6c 75 73 68 28 70 4f 75 74 29 3b 0a 7d 0a  fflush(pOut);.}.
4020: 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 52 65  #endif../*.** Re
4030: 6c 65 61 73 65 20 61 6e 20 61 72 72 61 79 20 6f  lease an array o
4040: 66 20 4e 20 4d 65 6d 20 65 6c 65 6d 65 6e 74 73  f N Mem elements
4050: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
4060: 72 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28  releaseMemArray(
4070: 4d 65 6d 20 2a 70 2c 20 69 6e 74 20 4e 29 7b 0a  Mem *p, int N){.
4080: 20 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 77    if( p ){.    w
4090: 68 69 6c 65 28 20 4e 2d 2d 3e 30 20 29 7b 0a 20  hile( N-->0 ){. 
40a0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
40b0: 4d 65 6d 52 65 6c 65 61 73 65 28 70 2b 2b 29 3b  MemRelease(p++);
40c0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 23 69  .    }.  }.}..#i
40d0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
40e0: 54 5f 45 58 50 4c 41 49 4e 0a 2f 2a 0a 2a 2a 20  T_EXPLAIN./*.** 
40f0: 47 69 76 65 20 61 20 6c 69 73 74 69 6e 67 20 6f  Give a listing o
4100: 66 20 74 68 65 20 70 72 6f 67 72 61 6d 20 69 6e  f the program in
4110: 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63   the virtual mac
4120: 68 69 6e 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  hine..**.** The 
4130: 69 6e 74 65 72 66 61 63 65 20 69 73 20 74 68 65  interface is the
4140: 20 73 61 6d 65 20 61 73 20 73 71 6c 69 74 65 33   same as sqlite3
4150: 56 64 62 65 45 78 65 63 28 29 2e 20 20 42 75 74  VdbeExec().  But
4160: 20 69 6e 73 74 65 61 64 20 6f 66 0a 2a 2a 20 72   instead of.** r
4170: 75 6e 6e 69 6e 67 20 74 68 65 20 63 6f 64 65 2c  unning the code,
4180: 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68 65 20   it invokes the 
4190: 63 61 6c 6c 62 61 63 6b 20 6f 6e 63 65 20 66 6f  callback once fo
41a0: 72 20 65 61 63 68 20 69 6e 73 74 72 75 63 74 69  r each instructi
41b0: 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 66 65 61 74  on..** This feat
41c0: 75 72 65 20 69 73 20 75 73 65 64 20 74 6f 20 69  ure is used to i
41d0: 6d 70 6c 65 6d 65 6e 74 20 22 45 58 50 4c 41 49  mplement "EXPLAI
41e0: 4e 22 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  N"..*/.int sqlit
41f0: 65 33 56 64 62 65 4c 69 73 74 28 0a 20 20 56 64  e3VdbeList(.  Vd
4200: 62 65 20 2a 70 20 20 20 20 20 20 20 20 20 20 20  be *p           
4210: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 56          /* The V
4220: 44 42 45 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69  DBE */.){.  sqli
4230: 74 65 33 20 2a 64 62 20 3d 20 70 2d 3e 64 62 3b  te3 *db = p->db;
4240: 0a 20 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20  .  int i;.  int 
4250: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
4260: 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e 65 78  .  assert( p->ex
4270: 70 6c 61 69 6e 20 29 3b 0a 20 20 69 66 28 20 70  plain );.  if( p
4280: 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41  ->magic!=VDBE_MA
4290: 47 49 43 5f 52 55 4e 20 29 20 72 65 74 75 72 6e  GIC_RUN ) return
42a0: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
42b0: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6d 61    assert( db->ma
42c0: 67 69 63 3d 3d 53 51 4c 49 54 45 5f 4d 41 47 49  gic==SQLITE_MAGI
42d0: 43 5f 42 55 53 59 20 29 3b 0a 20 20 61 73 73 65  C_BUSY );.  asse
42e0: 72 74 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54  rt( p->rc==SQLIT
42f0: 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 72 63 3d 3d 53  E_OK || p->rc==S
4300: 51 4c 49 54 45 5f 42 55 53 59 20 29 3b 0a 0a 20  QLITE_BUSY );.. 
4310: 20 2f 2a 20 45 76 65 6e 20 74 68 6f 75 67 68 20   /* Even though 
4320: 74 68 69 73 20 6f 70 63 6f 64 65 20 64 6f 65 73  this opcode does
4330: 20 6e 6f 74 20 70 75 74 20 64 79 6e 61 6d 69 63   not put dynamic
4340: 20 73 74 72 69 6e 67 73 20 6f 6e 74 6f 20 74 68   strings onto th
4350: 65 0a 20 20 2a 2a 20 74 68 65 20 73 74 61 63 6b  e.  ** the stack
4360: 2c 20 74 68 65 79 20 6d 61 79 20 62 65 63 6f 6d  , they may becom
4370: 65 20 64 79 6e 61 6d 69 63 20 69 66 20 74 68 65  e dynamic if the
4380: 20 75 73 65 72 20 63 61 6c 6c 73 0a 20 20 2a 2a   user calls.  **
4390: 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f   sqlite3_column_
43a0: 74 65 78 74 31 36 28 29 2c 20 63 61 75 73 69 6e  text16(), causin
43b0: 67 20 61 20 74 72 61 6e 73 6c 61 74 69 6f 6e 20  g a translation 
43c0: 74 6f 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 69  to UTF-16 encodi
43d0: 6e 67 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70  ng..  */.  if( p
43e0: 2d 3e 70 54 6f 73 3d 3d 26 70 2d 3e 61 53 74 61  ->pTos==&p->aSta
43f0: 63 6b 5b 34 5d 20 29 7b 0a 20 20 20 20 72 65 6c  ck[4] ){.    rel
4400: 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e  easeMemArray(p->
4410: 61 53 74 61 63 6b 2c 20 35 29 3b 0a 20 20 7d 0a  aStack, 5);.  }.
4420: 20 20 70 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20    p->resOnStack 
4430: 3d 20 30 3b 0a 0a 20 20 64 6f 7b 0a 20 20 20 20  = 0;..  do{.    
4440: 69 20 3d 20 70 2d 3e 70 63 2b 2b 3b 0a 20 20 7d  i = p->pc++;.  }
4450: 77 68 69 6c 65 28 20 69 3c 70 2d 3e 6e 4f 70 20  while( i<p->nOp 
4460: 26 26 20 70 2d 3e 65 78 70 6c 61 69 6e 3d 3d 32  && p->explain==2
4470: 20 26 26 20 70 2d 3e 61 4f 70 5b 69 5d 2e 6f 70   && p->aOp[i].op
4480: 63 6f 64 65 21 3d 4f 50 5f 45 78 70 6c 61 69 6e  code!=OP_Explain
4490: 20 29 3b 0a 20 20 69 66 28 20 69 3e 3d 70 2d 3e   );.  if( i>=p->
44a0: 6e 4f 70 20 29 7b 0a 20 20 20 20 70 2d 3e 72 63  nOp ){.    p->rc
44b0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
44c0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 44 4f    rc = SQLITE_DO
44d0: 4e 45 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  NE;.  }else if( 
44e0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
44f0: 54 45 5f 49 6e 74 65 72 72 75 70 74 20 29 7b 0a  TE_Interrupt ){.
4500: 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d      db->flags &=
4510: 20 7e 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75   ~SQLITE_Interru
4520: 70 74 3b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20  pt;.    p->rc = 
4530: 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54  SQLITE_INTERRUPT
4540: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ;.    rc = SQLIT
4550: 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 73 71 6c  E_ERROR;.    sql
4560: 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 26 70  ite3SetString(&p
4570: 2d 3e 7a 45 72 72 4d 73 67 2c 20 73 71 6c 69 74  ->zErrMsg, sqlit
4580: 65 33 45 72 72 53 74 72 28 70 2d 3e 72 63 29 2c  e3ErrStr(p->rc),
4590: 20 28 63 68 61 72 2a 29 30 29 3b 0a 20 20 7d 65   (char*)0);.  }e
45a0: 6c 73 65 7b 0a 20 20 20 20 4f 70 20 2a 70 4f 70  lse{.    Op *pOp
45b0: 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20   = &p->aOp[i];. 
45c0: 20 20 20 4d 65 6d 20 2a 70 4d 65 6d 20 3d 20 70     Mem *pMem = p
45d0: 2d 3e 61 53 74 61 63 6b 3b 0a 20 20 20 20 70 4d  ->aStack;.    pM
45e0: 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f  em->flags = MEM_
45f0: 49 6e 74 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 74  Int;.    pMem->t
4600: 79 70 65 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54  ype = SQLITE_INT
4610: 45 47 45 52 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e  EGER;.    pMem->
4620: 69 20 3d 20 69 3b 20 20 20 20 20 20 20 20 20 20  i = i;          
4630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4640: 20 20 20 20 20 20 2f 2a 20 50 72 6f 67 72 61 6d        /* Program
4650: 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 20 20 20   counter */.    
4660: 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20 70 4d 65  pMem++;..    pMe
4670: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53  m->flags = MEM_S
4680: 74 61 74 69 63 7c 4d 45 4d 5f 53 74 72 7c 4d 45  tatic|MEM_Str|ME
4690: 4d 5f 54 65 72 6d 3b 0a 20 20 20 20 70 4d 65 6d  M_Term;.    pMem
46a0: 2d 3e 7a 20 3d 20 73 71 6c 69 74 65 33 4f 70 63  ->z = sqlite3Opc
46b0: 6f 64 65 4e 61 6d 65 73 5b 70 4f 70 2d 3e 6f 70  odeNames[pOp->op
46c0: 63 6f 64 65 5d 3b 20 20 2f 2a 20 4f 70 63 6f 64  code];  /* Opcod
46d0: 65 20 2a 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 6e  e */.    pMem->n
46e0: 20 3d 20 73 74 72 6c 65 6e 28 70 4d 65 6d 2d 3e   = strlen(pMem->
46f0: 7a 29 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79  z);.    pMem->ty
4700: 70 65 20 3d 20 53 51 4c 49 54 45 5f 54 45 58 54  pe = SQLITE_TEXT
4710: 3b 0a 20 20 20 20 70 4d 65 6d 2d 3e 65 6e 63 20  ;.    pMem->enc 
4720: 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20  = SQLITE_UTF8;. 
4730: 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20 20 20     pMem++;..    
4740: 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45  pMem->flags = ME
4750: 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d 65 6d 2d  M_Int;.    pMem-
4760: 3e 69 20 3d 20 70 4f 70 2d 3e 70 31 3b 20 20 20  >i = pOp->p1;   
4770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4780: 20 20 20 20 20 20 20 2f 2a 20 50 31 20 2a 2f 0a         /* P1 */.
4790: 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65 20 3d      pMem->type =
47a0: 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45 52 3b   SQLITE_INTEGER;
47b0: 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a 20 20  .    pMem++;..  
47c0: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
47d0: 4d 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 70 4d 65  MEM_Int;.    pMe
47e0: 6d 2d 3e 69 20 3d 20 70 4f 70 2d 3e 70 32 3b 20  m->i = pOp->p2; 
47f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4800: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 32 20 2a           /* P2 *
4810: 2f 0a 20 20 20 20 70 4d 65 6d 2d 3e 74 79 70 65  /.    pMem->type
4820: 20 3d 20 53 51 4c 49 54 45 5f 49 4e 54 45 47 45   = SQLITE_INTEGE
4830: 52 3b 0a 20 20 20 20 70 4d 65 6d 2b 2b 3b 0a 0a  R;.    pMem++;..
4840: 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20      pMem->flags 
4850: 3d 20 4d 45 4d 5f 53 68 6f 72 74 7c 4d 45 4d 5f  = MEM_Short|MEM_
4860: 53 74 72 7c 4d 45 4d 5f 54 65 72 6d 3b 20 20 20  Str|MEM_Term;   
4870: 2f 2a 20 50 33 20 2a 2f 0a 20 20 20 20 70 4d 65  /* P3 */.    pMe
4880: 6d 2d 3e 7a 20 3d 20 64 69 73 70 6c 61 79 50 33  m->z = displayP3
4890: 28 70 4f 70 2c 20 70 4d 65 6d 2d 3e 7a 53 68 6f  (pOp, pMem->zSho
48a0: 72 74 2c 20 73 69 7a 65 6f 66 28 70 4d 65 6d 2d  rt, sizeof(pMem-
48b0: 3e 7a 53 68 6f 72 74 29 29 3b 0a 20 20 20 20 70  >zShort));.    p
48c0: 4d 65 6d 2d 3e 74 79 70 65 20 3d 20 53 51 4c 49  Mem->type = SQLI
48d0: 54 45 5f 54 45 58 54 3b 0a 20 20 20 20 70 4d 65  TE_TEXT;.    pMe
48e0: 6d 2d 3e 65 6e 63 20 3d 20 53 51 4c 49 54 45 5f  m->enc = SQLITE_
48f0: 55 54 46 38 3b 0a 0a 20 20 20 20 70 2d 3e 6e 52  UTF8;..    p->nR
4900: 65 73 43 6f 6c 75 6d 6e 20 3d 20 35 20 2d 20 32  esColumn = 5 - 2
4910: 2a 28 70 2d 3e 65 78 70 6c 61 69 6e 2d 31 29 3b  *(p->explain-1);
4920: 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20 3d 20 70  .    p->pTos = p
4930: 4d 65 6d 3b 0a 20 20 20 20 70 2d 3e 72 63 20 3d  Mem;.    p->rc =
4940: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20   SQLITE_OK;.    
4950: 70 2d 3e 72 65 73 4f 6e 53 74 61 63 6b 20 3d 20  p->resOnStack = 
4960: 31 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49  1;.    rc = SQLI
4970: 54 45 5f 52 4f 57 3b 0a 20 20 7d 0a 20 20 72 65  TE_ROW;.  }.  re
4980: 74 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69  turn rc;.}.#endi
4990: 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54  f /* SQLITE_OMIT
49a0: 5f 45 58 50 4c 41 49 4e 20 2a 2f 0a 0a 2f 2a 0a  _EXPLAIN */../*.
49b0: 2a 2a 20 50 72 69 6e 74 20 74 68 65 20 53 51 4c  ** Print the SQL
49c0: 20 74 68 61 74 20 77 61 73 20 75 73 65 64 20 74   that was used t
49d0: 6f 20 67 65 6e 65 72 61 74 65 20 61 20 56 44 42  o generate a VDB
49e0: 45 20 70 72 6f 67 72 61 6d 2e 0a 2a 2f 0a 76 6f  E program..*/.vo
49f0: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 50 72  id sqlite3VdbePr
4a00: 69 6e 74 53 71 6c 28 56 64 62 65 20 2a 70 29 7b  intSql(Vdbe *p){
4a10: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44  .#ifdef SQLITE_D
4a20: 45 42 55 47 0a 20 20 69 6e 74 20 6e 4f 70 20 3d  EBUG.  int nOp =
4a30: 20 70 2d 3e 6e 4f 70 3b 0a 20 20 56 64 62 65 4f   p->nOp;.  VdbeO
4a40: 70 20 2a 70 4f 70 3b 0a 20 20 69 66 28 20 6e 4f  p *pOp;.  if( nO
4a50: 70 3c 31 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  p<1 ) return;.  
4a60: 70 4f 70 20 3d 20 26 70 2d 3e 61 4f 70 5b 6e 4f  pOp = &p->aOp[nO
4a70: 70 2d 31 5d 3b 0a 20 20 69 66 28 20 70 4f 70 2d  p-1];.  if( pOp-
4a80: 3e 6f 70 63 6f 64 65 3d 3d 4f 50 5f 4e 6f 6f 70  >opcode==OP_Noop
4a90: 20 26 26 20 70 4f 70 2d 3e 70 33 21 3d 30 20 29   && pOp->p3!=0 )
4aa0: 7b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72  {.    const char
4ab0: 20 2a 7a 20 3d 20 70 4f 70 2d 3e 70 33 3b 0a 20   *z = pOp->p3;. 
4ac0: 20 20 20 77 68 69 6c 65 28 20 69 73 73 70 61 63     while( isspac
4ad0: 65 28 2a 28 75 38 2a 29 7a 29 20 29 20 7a 2b 2b  e(*(u8*)z) ) z++
4ae0: 3b 0a 20 20 20 20 70 72 69 6e 74 66 28 22 53 51  ;.    printf("SQ
4af0: 4c 3a 20 5b 25 73 5d 5c 6e 22 2c 20 7a 29 3b 0a  L: [%s]\n", z);.
4b00: 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a    }.#endif.}../*
4b10: 0a 2a 2a 20 50 72 65 70 61 72 65 20 61 20 76 69  .** Prepare a vi
4b20: 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 20 66 6f  rtual machine fo
4b30: 72 20 65 78 65 63 75 74 69 6f 6e 2e 20 20 54 68  r execution.  Th
4b40: 69 73 20 69 6e 76 6f 6c 76 65 73 20 74 68 69 6e  is involves thin
4b50: 67 73 20 73 75 63 68 0a 2a 2a 20 61 73 20 61 6c  gs such.** as al
4b60: 6c 6f 63 61 74 69 6e 67 20 73 74 61 63 6b 20 73  locating stack s
4b70: 70 61 63 65 20 61 6e 64 20 69 6e 69 74 69 61 6c  pace and initial
4b80: 69 7a 69 6e 67 20 74 68 65 20 70 72 6f 67 72 61  izing the progra
4b90: 6d 20 63 6f 75 6e 74 65 72 2e 0a 2a 2a 20 41 66  m counter..** Af
4ba0: 74 65 72 20 74 68 65 20 56 44 42 45 20 68 61 73  ter the VDBE has
4bb0: 20 62 65 20 70 72 65 70 70 65 64 2c 20 69 74 20   be prepped, it 
4bc0: 63 61 6e 20 62 65 20 65 78 65 63 75 74 65 64 20  can be executed 
4bd0: 62 79 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 0a 2a  by one or more.*
4be0: 2a 20 63 61 6c 6c 73 20 74 6f 20 73 71 6c 69 74  * calls to sqlit
4bf0: 65 33 56 64 62 65 45 78 65 63 28 29 2e 20 20 0a  e3VdbeExec().  .
4c00: 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 68  **.** This is th
4c10: 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 6d 6f  e only way to mo
4c20: 76 65 20 61 20 56 44 42 45 20 66 72 6f 6d 20 56  ve a VDBE from V
4c30: 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49 54 20 74  DBE_MAGIC_INIT t
4c40: 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43 5f  o.** VDBE_MAGIC_
4c50: 52 55 4e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  RUN..*/.void sql
4c60: 69 74 65 33 56 64 62 65 4d 61 6b 65 52 65 61 64  ite3VdbeMakeRead
4c70: 79 28 0a 20 20 56 64 62 65 20 2a 70 2c 20 20 20  y(.  Vdbe *p,   
4c80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4c90: 20 20 20 20 2f 2a 20 54 68 65 20 56 44 42 45 20      /* The VDBE 
4ca0: 2a 2f 0a 20 20 69 6e 74 20 6e 56 61 72 2c 20 20  */.  int nVar,  
4cb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4cc0: 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66      /* Number of
4cd0: 20 27 3f 27 20 73 65 65 20 69 6e 20 74 68 65 20   '?' see in the 
4ce0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f  SQL statement */
4cf0: 0a 20 20 69 6e 74 20 6e 4d 65 6d 2c 20 20 20 20  .  int nMem,    
4d00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4d10: 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6d    /* Number of m
4d20: 65 6d 6f 72 79 20 63 65 6c 6c 73 20 74 6f 20 61  emory cells to a
4d30: 6c 6c 6f 63 61 74 65 20 2a 2f 0a 20 20 69 6e 74  llocate */.  int
4d40: 20 6e 43 75 72 73 6f 72 2c 20 20 20 20 20 20 20   nCursor,       
4d50: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
4d60: 75 6d 62 65 72 20 6f 66 20 63 75 72 73 6f 72 73  umber of cursors
4d70: 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 2a 2f 0a   to allocate */.
4d80: 20 20 69 6e 74 20 69 73 45 78 70 6c 61 69 6e 20    int isExplain 
4d90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4da0: 20 2f 2a 20 54 72 75 65 20 69 66 20 74 68 65 20   /* True if the 
4db0: 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 73  EXPLAIN keywords
4dc0: 20 69 73 20 70 72 65 73 65 6e 74 20 2a 2f 0a 29   is present */.)
4dd0: 7b 0a 20 20 69 6e 74 20 6e 3b 0a 0a 20 20 61 73  {.  int n;..  as
4de0: 73 65 72 74 28 20 70 21 3d 30 20 29 3b 0a 20 20  sert( p!=0 );.  
4df0: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
4e00: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 49 4e 49  ==VDBE_MAGIC_INI
4e10: 54 20 29 3b 0a 0a 20 20 2f 2a 20 54 68 65 72 65  T );..  /* There
4e20: 20 73 68 6f 75 6c 64 20 62 65 20 61 74 20 6c 65   should be at le
4e30: 61 73 74 20 6f 6e 65 20 6f 70 63 6f 64 65 2e 0a  ast one opcode..
4e40: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70    */.  assert( p
4e50: 2d 3e 6e 4f 70 3e 30 20 29 3b 0a 0a 20 20 2f 2a  ->nOp>0 );..  /*
4e60: 20 53 65 74 20 74 68 65 20 6d 61 67 69 63 20 74   Set the magic t
4e70: 6f 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e  o VDBE_MAGIC_RUN
4e80: 20 73 6f 6f 6e 65 72 20 72 61 74 68 65 72 20 74   sooner rather t
4e90: 68 61 6e 20 6c 61 74 65 72 2e 20 54 68 69 73 0a  han later. This.
4ea0: 20 20 20 2a 20 69 73 20 62 65 63 61 75 73 65 20     * is because 
4eb0: 74 68 65 20 63 61 6c 6c 20 74 6f 20 72 65 73 69  the call to resi
4ec0: 7a 65 4f 70 41 72 72 61 79 28 29 20 62 65 6c 6f  zeOpArray() belo
4ed0: 77 20 6d 61 79 20 73 68 72 69 6e 6b 20 74 68 65  w may shrink the
4ee0: 0a 20 20 20 2a 20 70 2d 3e 61 4f 70 5b 5d 20 61  .   * p->aOp[] a
4ef0: 72 72 61 79 20 74 6f 20 73 61 76 65 20 6d 65 6d  rray to save mem
4f00: 6f 72 79 20 69 66 20 63 61 6c 6c 65 64 20 77 68  ory if called wh
4f10: 65 6e 20 69 6e 20 56 44 42 45 5f 4d 41 47 49 43  en in VDBE_MAGIC
4f20: 5f 52 55 4e 20 0a 20 20 20 2a 20 73 74 61 74 65  _RUN .   * state
4f30: 2e 0a 20 20 20 2a 2f 0a 20 20 70 2d 3e 6d 61 67  ..   */.  p->mag
4f40: 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f  ic = VDBE_MAGIC_
4f50: 52 55 4e 3b 0a 0a 20 20 2f 2a 20 4e 6f 20 69 6e  RUN;..  /* No in
4f60: 73 74 72 75 63 74 69 6f 6e 20 65 76 65 72 20 70  struction ever p
4f70: 75 73 68 65 73 20 6d 6f 72 65 20 74 68 61 6e 20  ushes more than 
4f80: 61 20 73 69 6e 67 6c 65 20 65 6c 65 6d 65 6e 74  a single element
4f90: 20 6f 6e 74 6f 20 74 68 65 0a 20 20 2a 2a 20 73   onto the.  ** s
4fa0: 74 61 63 6b 2e 20 20 41 6e 64 20 74 68 65 20 73  tack.  And the s
4fb0: 74 61 63 6b 20 6e 65 76 65 72 20 67 72 6f 77 73  tack never grows
4fc0: 20 6f 6e 20 73 75 63 63 65 73 73 69 76 65 20 65   on successive e
4fd0: 78 65 63 75 74 69 6f 6e 73 20 6f 66 20 74 68 65  xecutions of the
4fe0: 0a 20 20 2a 2a 20 73 61 6d 65 20 6c 6f 6f 70 2e  .  ** same loop.
4ff0: 20 20 53 6f 20 74 68 65 20 74 6f 74 61 6c 20 6e    So the total n
5000: 75 6d 62 65 72 20 6f 66 20 69 6e 73 74 72 75 63  umber of instruc
5010: 74 69 6f 6e 73 20 69 73 20 61 6e 20 75 70 70 65  tions is an uppe
5020: 72 20 62 6f 75 6e 64 0a 20 20 2a 2a 20 6f 6e 20  r bound.  ** on 
5030: 74 68 65 20 6d 61 78 69 6d 75 6d 20 73 74 61 63  the maximum stac
5040: 6b 20 64 65 70 74 68 20 72 65 71 75 69 72 65 64  k depth required
5050: 2e 20 20 28 41 64 64 65 64 20 6c 61 74 65 72 3a  .  (Added later:
5060: 29 20 20 54 68 65 0a 20 20 2a 2a 20 72 65 73 6f  )  The.  ** reso
5070: 6c 76 65 50 32 56 61 6c 75 65 73 28 29 20 63 61  lveP2Values() ca
5080: 6c 6c 20 63 6f 6d 70 75 74 65 73 20 61 20 74 69  ll computes a ti
5090: 67 68 74 65 72 20 75 70 70 65 72 20 62 6f 75 6e  ghter upper boun
50a0: 64 20 6f 6e 20 74 68 65 0a 20 20 2a 2a 20 73 74  d on the.  ** st
50b0: 61 63 6b 20 73 69 7a 65 2e 0a 20 20 2a 2a 0a 20  ack size..  **. 
50c0: 20 2a 2a 20 41 6c 6c 6f 63 61 74 69 6f 6e 20 61   ** Allocation a
50d0: 6c 6c 20 74 68 65 20 73 74 61 63 6b 20 73 70 61  ll the stack spa
50e0: 63 65 20 77 65 20 77 69 6c 6c 20 65 76 65 72 20  ce we will ever 
50f0: 6e 65 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28  need..  */.  if(
5100: 20 70 2d 3e 61 53 74 61 63 6b 3d 3d 30 20 29 7b   p->aStack==0 ){
5110: 0a 20 20 20 20 69 6e 74 20 6e 41 72 67 3b 20 20  .    int nArg;  
5120: 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 6d 20       /* Maximum 
5130: 6e 75 6d 62 65 72 20 6f 66 20 61 72 67 73 20 70  number of args p
5140: 61 73 73 65 64 20 74 6f 20 61 20 75 73 65 72 20  assed to a user 
5150: 66 75 6e 63 74 69 6f 6e 2e 20 2a 2f 0a 20 20 20  function. */.   
5160: 20 69 6e 74 20 6e 53 74 61 63 6b 3b 20 20 20 20   int nStack;    
5170: 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e 75 6d 62   /* Maximum numb
5180: 65 72 20 6f 66 20 73 74 61 63 6b 20 65 6e 74 72  er of stack entr
5190: 69 65 73 20 72 65 71 75 69 72 65 64 20 2a 2f 0a  ies required */.
51a0: 20 20 20 20 72 65 73 6f 6c 76 65 50 32 56 61 6c      resolveP2Val
51b0: 75 65 73 28 70 2c 20 26 6e 41 72 67 2c 20 26 6e  ues(p, &nArg, &n
51c0: 53 74 61 63 6b 29 3b 0a 20 20 20 20 72 65 73 69  Stack);.    resi
51d0: 7a 65 4f 70 41 72 72 61 79 28 70 2c 20 70 2d 3e  zeOpArray(p, p->
51e0: 6e 4f 70 29 3b 0a 20 20 20 20 61 73 73 65 72 74  nOp);.    assert
51f0: 28 20 6e 56 61 72 3e 3d 30 20 29 3b 0a 20 20 20  ( nVar>=0 );.   
5200: 20 61 73 73 65 72 74 28 20 6e 53 74 61 63 6b 3c   assert( nStack<
5210: 70 2d 3e 6e 4f 70 20 29 3b 0a 20 20 20 20 6e 53  p->nOp );.    nS
5220: 74 61 63 6b 20 3d 20 69 73 45 78 70 6c 61 69 6e  tack = isExplain
5230: 20 3f 20 31 30 20 3a 20 6e 53 74 61 63 6b 3b 0a   ? 10 : nStack;.
5240: 20 20 20 20 70 2d 3e 61 53 74 61 63 6b 20 3d 20      p->aStack = 
5250: 73 71 6c 69 74 65 4d 61 6c 6c 6f 63 28 0a 20 20  sqliteMalloc(.  
5260: 20 20 20 20 20 20 6e 53 74 61 63 6b 2a 73 69 7a        nStack*siz
5270: 65 6f 66 28 70 2d 3e 61 53 74 61 63 6b 5b 30 5d  eof(p->aStack[0]
5280: 29 20 20 20 20 2f 2a 20 61 53 74 61 63 6b 20 2a  )    /* aStack *
5290: 2f 0a 20 20 20 20 20 20 2b 20 6e 41 72 67 2a 73  /.      + nArg*s
52a0: 69 7a 65 6f 66 28 4d 65 6d 2a 29 20 20 20 20 20  izeof(Mem*)     
52b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 61 70 41 72           /* apAr
52c0: 67 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e 56 61  g */.      + nVa
52d0: 72 2a 73 69 7a 65 6f 66 28 4d 65 6d 29 20 20 20  r*sizeof(Mem)   
52e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 61              /* a
52f0: 56 61 72 20 2a 2f 0a 20 20 20 20 20 20 2b 20 6e  Var */.      + n
5300: 56 61 72 2a 73 69 7a 65 6f 66 28 63 68 61 72 2a  Var*sizeof(char*
5310: 29 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  )             /*
5320: 20 61 7a 56 61 72 20 2a 2f 0a 20 20 20 20 20 20   azVar */.      
5330: 2b 20 6e 4d 65 6d 2a 73 69 7a 65 6f 66 28 4d 65  + nMem*sizeof(Me
5340: 6d 29 20 20 20 20 20 20 20 20 20 20 20 20 20 20  m)              
5350: 20 2f 2a 20 61 4d 65 6d 20 2a 2f 0a 20 20 20 20   /* aMem */.    
5360: 20 20 2b 20 6e 43 75 72 73 6f 72 2a 73 69 7a 65    + nCursor*size
5370: 6f 66 28 43 75 72 73 6f 72 2a 29 20 20 20 20 20  of(Cursor*)     
5380: 20 20 20 2f 2a 20 61 70 43 73 72 20 2a 2f 0a 20     /* apCsr */. 
5390: 20 20 20 29 3b 0a 20 20 20 20 69 66 28 20 21 73     );.    if( !s
53a0: 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c  qlite3MallocFail
53b0: 65 64 28 29 20 29 7b 0a 20 20 20 20 20 20 70 2d  ed() ){.      p-
53c0: 3e 61 4d 65 6d 20 3d 20 26 70 2d 3e 61 53 74 61  >aMem = &p->aSta
53d0: 63 6b 5b 6e 53 74 61 63 6b 5d 3b 0a 20 20 20 20  ck[nStack];.    
53e0: 20 20 70 2d 3e 6e 4d 65 6d 20 3d 20 6e 4d 65 6d    p->nMem = nMem
53f0: 3b 0a 20 20 20 20 20 20 70 2d 3e 61 56 61 72 20  ;.      p->aVar 
5400: 3d 20 26 70 2d 3e 61 4d 65 6d 5b 6e 4d 65 6d 5d  = &p->aMem[nMem]
5410: 3b 0a 20 20 20 20 20 20 70 2d 3e 6e 56 61 72 20  ;.      p->nVar 
5420: 3d 20 6e 56 61 72 3b 0a 20 20 20 20 20 20 70 2d  = nVar;.      p-
5430: 3e 6f 6b 56 61 72 20 3d 20 30 3b 0a 20 20 20 20  >okVar = 0;.    
5440: 20 20 70 2d 3e 61 70 41 72 67 20 3d 20 28 4d 65    p->apArg = (Me
5450: 6d 2a 2a 29 26 70 2d 3e 61 56 61 72 5b 6e 56 61  m**)&p->aVar[nVa
5460: 72 5d 3b 0a 20 20 20 20 20 20 70 2d 3e 61 7a 56  r];.      p->azV
5470: 61 72 20 3d 20 28 63 68 61 72 2a 2a 29 26 70 2d  ar = (char**)&p-
5480: 3e 61 70 41 72 67 5b 6e 41 72 67 5d 3b 0a 20 20  >apArg[nArg];.  
5490: 20 20 20 20 70 2d 3e 61 70 43 73 72 20 3d 20 28      p->apCsr = (
54a0: 43 75 72 73 6f 72 2a 2a 29 26 70 2d 3e 61 7a 56  Cursor**)&p->azV
54b0: 61 72 5b 6e 56 61 72 5d 3b 0a 20 20 20 20 20 20  ar[nVar];.      
54c0: 70 2d 3e 6e 43 75 72 73 6f 72 20 3d 20 6e 43 75  p->nCursor = nCu
54d0: 72 73 6f 72 3b 0a 20 20 20 20 20 20 66 6f 72 28  rsor;.      for(
54e0: 6e 3d 30 3b 20 6e 3c 6e 56 61 72 3b 20 6e 2b 2b  n=0; n<nVar; n++
54f0: 29 7b 0a 20 20 20 20 20 20 20 20 70 2d 3e 61 56  ){.        p->aV
5500: 61 72 5b 6e 5d 2e 66 6c 61 67 73 20 3d 20 4d 45  ar[n].flags = ME
5510: 4d 5f 4e 75 6c 6c 3b 0a 20 20 20 20 20 20 7d 0a  M_Null;.      }.
5520: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 66 6f 72 28      }.  }.  for(
5530: 6e 3d 30 3b 20 6e 3c 70 2d 3e 6e 4d 65 6d 3b 20  n=0; n<p->nMem; 
5540: 6e 2b 2b 29 7b 0a 20 20 20 20 70 2d 3e 61 4d 65  n++){.    p->aMe
5550: 6d 5b 6e 5d 2e 66 6c 61 67 73 20 3d 20 4d 45 4d  m[n].flags = MEM
5560: 5f 4e 75 6c 6c 3b 0a 20 20 7d 0a 0a 23 69 66 64  _Null;.  }..#ifd
5570: 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a  ef SQLITE_DEBUG.
5580: 20 20 69 66 28 20 28 70 2d 3e 64 62 2d 3e 66 6c    if( (p->db->fl
5590: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 56 64 62  ags & SQLITE_Vdb
55a0: 65 4c 69 73 74 69 6e 67 29 21 3d 30 0a 20 20 20  eListing)!=0.   
55b0: 20 7c 7c 20 73 71 6c 69 74 65 33 4f 73 46 69 6c   || sqlite3OsFil
55c0: 65 45 78 69 73 74 73 28 22 76 64 62 65 5f 65 78  eExists("vdbe_ex
55d0: 70 6c 61 69 6e 22 29 0a 20 20 29 7b 0a 20 20 20  plain").  ){.   
55e0: 20 69 6e 74 20 69 3b 0a 20 20 20 20 70 72 69 6e   int i;.    prin
55f0: 74 66 28 22 56 44 42 45 20 50 72 6f 67 72 61 6d  tf("VDBE Program
5600: 20 4c 69 73 74 69 6e 67 3a 5c 6e 22 29 3b 0a 20   Listing:\n");. 
5610: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 50 72     sqlite3VdbePr
5620: 69 6e 74 53 71 6c 28 70 29 3b 0a 20 20 20 20 66  intSql(p);.    f
5630: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70  or(i=0; i<p->nOp
5640: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71  ; i++){.      sq
5650: 6c 69 74 65 33 56 64 62 65 50 72 69 6e 74 4f 70  lite3VdbePrintOp
5660: 28 73 74 64 6f 75 74 2c 20 69 2c 20 26 70 2d 3e  (stdout, i, &p->
5670: 61 4f 70 5b 69 5d 29 3b 0a 20 20 20 20 7d 0a 20  aOp[i]);.    }. 
5680: 20 7d 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33   }.  if( sqlite3
5690: 4f 73 46 69 6c 65 45 78 69 73 74 73 28 22 76 64  OsFileExists("vd
56a0: 62 65 5f 74 72 61 63 65 22 29 20 29 7b 0a 20 20  be_trace") ){.  
56b0: 20 20 70 2d 3e 74 72 61 63 65 20 3d 20 73 74 64    p->trace = std
56c0: 6f 75 74 3b 0a 20 20 7d 0a 23 65 6e 64 69 66 0a  out;.  }.#endif.
56d0: 20 20 70 2d 3e 70 54 6f 73 20 3d 20 26 70 2d 3e    p->pTos = &p->
56e0: 61 53 74 61 63 6b 5b 2d 31 5d 3b 0a 20 20 70 2d  aStack[-1];.  p-
56f0: 3e 70 63 20 3d 20 2d 31 3b 0a 20 20 70 2d 3e 72  >pc = -1;.  p->r
5700: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
5710: 20 70 2d 3e 75 6e 69 71 75 65 43 6e 74 20 3d 20   p->uniqueCnt = 
5720: 30 3b 0a 20 20 70 2d 3e 72 65 74 75 72 6e 44 65  0;.  p->returnDe
5730: 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e 65 72  pth = 0;.  p->er
5740: 72 6f 72 41 63 74 69 6f 6e 20 3d 20 4f 45 5f 41  rorAction = OE_A
5750: 62 6f 72 74 3b 0a 20 20 70 2d 3e 70 6f 70 53 74  bort;.  p->popSt
5760: 61 63 6b 20 3d 20 20 30 3b 0a 20 20 70 2d 3e 65  ack =  0;.  p->e
5770: 78 70 6c 61 69 6e 20 7c 3d 20 69 73 45 78 70 6c  xplain |= isExpl
5780: 61 69 6e 3b 0a 20 20 70 2d 3e 6d 61 67 69 63 20  ain;.  p->magic 
5790: 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e  = VDBE_MAGIC_RUN
57a0: 3b 0a 20 20 70 2d 3e 6e 43 68 61 6e 67 65 20 3d  ;.  p->nChange =
57b0: 20 30 3b 0a 20 20 70 2d 3e 63 61 63 68 65 43 74   0;.  p->cacheCt
57c0: 72 20 3d 20 31 3b 0a 20 20 70 2d 3e 6d 69 6e 57  r = 1;.  p->minW
57d0: 72 69 74 65 46 69 6c 65 46 6f 72 6d 61 74 20 3d  riteFileFormat =
57e0: 20 32 35 35 3b 0a 23 69 66 64 65 66 20 56 44 42   255;.#ifdef VDB
57f0: 45 5f 50 52 4f 46 49 4c 45 0a 20 20 7b 0a 20 20  E_PROFILE.  {.  
5800: 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 66 6f 72    int i;.    for
5810: 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20  (i=0; i<p->nOp; 
5820: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 70 2d 3e 61  i++){.      p->a
5830: 4f 70 5b 69 5d 2e 63 6e 74 20 3d 20 30 3b 0a 20  Op[i].cnt = 0;. 
5840: 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63       p->aOp[i].c
5850: 79 63 6c 65 73 20 3d 20 30 3b 0a 20 20 20 20 7d  ycles = 0;.    }
5860: 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f  .  }.#endif.}../
5870: 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 20 63 75 72  *.** Close a cur
5880: 73 6f 72 20 61 6e 64 20 72 65 6c 65 61 73 65 20  sor and release 
5890: 61 6c 6c 20 74 68 65 20 72 65 73 6f 75 72 63 65  all the resource
58a0: 73 20 74 68 61 74 20 63 75 72 73 6f 72 20 68 61  s that cursor ha
58b0: 70 70 65 6e 73 0a 2a 2a 20 74 6f 20 68 6f 6c 64  ppens.** to hold
58c0: 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65  ..*/.void sqlite
58d0: 33 56 64 62 65 46 72 65 65 43 75 72 73 6f 72 28  3VdbeFreeCursor(
58e0: 43 75 72 73 6f 72 20 2a 70 43 78 29 7b 0a 20 20  Cursor *pCx){.  
58f0: 69 66 28 20 70 43 78 3d 3d 30 20 29 7b 0a 20 20  if( pCx==0 ){.  
5900: 20 20 72 65 74 75 72 6e 3b 0a 20 20 7d 0a 20 20    return;.  }.  
5910: 69 66 28 20 70 43 78 2d 3e 70 43 75 72 73 6f 72  if( pCx->pCursor
5920: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42   ){.    sqlite3B
5930: 74 72 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28  treeCloseCursor(
5940: 70 43 78 2d 3e 70 43 75 72 73 6f 72 29 3b 0a 20  pCx->pCursor);. 
5950: 20 7d 0a 20 20 69 66 28 20 70 43 78 2d 3e 70 42   }.  if( pCx->pB
5960: 74 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  t ){.    sqlite3
5970: 42 74 72 65 65 43 6c 6f 73 65 28 70 43 78 2d 3e  BtreeClose(pCx->
5980: 70 42 74 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  pBt);.  }.  sqli
5990: 74 65 46 72 65 65 28 70 43 78 2d 3e 70 44 61 74  teFree(pCx->pDat
59a0: 61 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65  a);.  sqliteFree
59b0: 28 70 43 78 2d 3e 61 54 79 70 65 29 3b 0a 20 20  (pCx->aType);.  
59c0: 73 71 6c 69 74 65 46 72 65 65 28 70 43 78 29 3b  sqliteFree(pCx);
59d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20  .}../*.** Close 
59e0: 61 6c 6c 20 63 75 72 73 6f 72 73 0a 2a 2f 0a 73  all cursors.*/.s
59f0: 74 61 74 69 63 20 76 6f 69 64 20 63 6c 6f 73 65  tatic void close
5a00: 41 6c 6c 43 75 72 73 6f 72 73 28 56 64 62 65 20  AllCursors(Vdbe 
5a10: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20  *p){.  int i;.  
5a20: 69 66 28 20 70 2d 3e 61 70 43 73 72 3d 3d 30 20  if( p->apCsr==0 
5a30: 29 20 72 65 74 75 72 6e 3b 0a 20 20 66 6f 72 28  ) return;.  for(
5a40: 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43 75 72 73 6f  i=0; i<p->nCurso
5a50: 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c  r; i++){.    sql
5a60: 69 74 65 33 56 64 62 65 46 72 65 65 43 75 72 73  ite3VdbeFreeCurs
5a70: 6f 72 28 70 2d 3e 61 70 43 73 72 5b 69 5d 29 3b  or(p->apCsr[i]);
5a80: 0a 20 20 20 20 70 2d 3e 61 70 43 73 72 5b 69 5d  .    p->apCsr[i]
5a90: 20 3d 20 30 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a   = 0;.  }.}../*.
5aa0: 2a 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65 20  ** Clean up the 
5ab0: 56 4d 20 61 66 74 65 72 20 65 78 65 63 75 74 69  VM after executi
5ac0: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 72  on..**.** This r
5ad0: 6f 75 74 69 6e 65 20 77 69 6c 6c 20 61 75 74 6f  outine will auto
5ae0: 6d 61 74 69 63 61 6c 6c 79 20 63 6c 6f 73 65 20  matically close 
5af0: 61 6e 79 20 63 75 72 73 6f 72 73 2c 20 6c 69 73  any cursors, lis
5b00: 74 73 2c 20 61 6e 64 2f 6f 72 0a 2a 2a 20 73 6f  ts, and/or.** so
5b10: 72 74 65 72 73 20 74 68 61 74 20 77 65 72 65 20  rters that were 
5b20: 6c 65 66 74 20 6f 70 65 6e 2e 20 20 49 74 20 61  left open.  It a
5b30: 6c 73 6f 20 64 65 6c 65 74 65 73 20 74 68 65 20  lso deletes the 
5b40: 76 61 6c 75 65 73 20 6f 66 0a 2a 2a 20 76 61 72  values of.** var
5b50: 69 61 62 6c 65 73 20 69 6e 20 74 68 65 20 61 56  iables in the aV
5b60: 61 72 5b 5d 20 61 72 72 61 79 2e 0a 2a 2f 0a 73  ar[] array..*/.s
5b70: 74 61 74 69 63 20 76 6f 69 64 20 43 6c 65 61 6e  tatic void Clean
5b80: 75 70 28 56 64 62 65 20 2a 70 29 7b 0a 20 20 69  up(Vdbe *p){.  i
5b90: 6e 74 20 69 3b 0a 20 20 69 66 28 20 70 2d 3e 61  nt i;.  if( p->a
5ba0: 53 74 61 63 6b 20 29 7b 0a 20 20 20 20 72 65 6c  Stack ){.    rel
5bb0: 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d 3e  easeMemArray(p->
5bc0: 61 53 74 61 63 6b 2c 20 31 20 2b 20 28 70 2d 3e  aStack, 1 + (p->
5bd0: 70 54 6f 73 20 2d 20 70 2d 3e 61 53 74 61 63 6b  pTos - p->aStack
5be0: 29 29 3b 0a 20 20 20 20 70 2d 3e 70 54 6f 73 20  ));.    p->pTos 
5bf0: 3d 20 26 70 2d 3e 61 53 74 61 63 6b 5b 2d 31 5d  = &p->aStack[-1]
5c00: 3b 0a 20 20 7d 0a 20 20 63 6c 6f 73 65 41 6c 6c  ;.  }.  closeAll
5c10: 43 75 72 73 6f 72 73 28 70 29 3b 0a 20 20 72 65  Cursors(p);.  re
5c20: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d  leaseMemArray(p-
5c30: 3e 61 4d 65 6d 2c 20 70 2d 3e 6e 4d 65 6d 29 3b  >aMem, p->nMem);
5c40: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 46 69  .  sqlite3VdbeFi
5c50: 66 6f 43 6c 65 61 72 28 26 70 2d 3e 73 46 69 66  foClear(&p->sFif
5c60: 6f 29 3b 0a 20 20 69 66 28 20 70 2d 3e 63 6f 6e  o);.  if( p->con
5c70: 74 65 78 74 53 74 61 63 6b 20 29 7b 0a 20 20 20  textStack ){.   
5c80: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 63   for(i=0; i<p->c
5c90: 6f 6e 74 65 78 74 53 74 61 63 6b 54 6f 70 3b 20  ontextStackTop; 
5ca0: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  i++){.      sqli
5cb0: 74 65 33 56 64 62 65 46 69 66 6f 43 6c 65 61 72  te3VdbeFifoClear
5cc0: 28 26 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63  (&p->contextStac
5cd0: 6b 5b 69 5d 2e 73 46 69 66 6f 29 3b 0a 20 20 20  k[i].sFifo);.   
5ce0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65   }.    sqliteFre
5cf0: 65 28 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63  e(p->contextStac
5d00: 6b 29 3b 0a 20 20 7d 0a 20 20 70 2d 3e 63 6f 6e  k);.  }.  p->con
5d10: 74 65 78 74 53 74 61 63 6b 20 3d 20 30 3b 0a 20  textStack = 0;. 
5d20: 20 70 2d 3e 63 6f 6e 74 65 78 74 53 74 61 63 6b   p->contextStack
5d30: 44 65 70 74 68 20 3d 20 30 3b 0a 20 20 70 2d 3e  Depth = 0;.  p->
5d40: 63 6f 6e 74 65 78 74 53 74 61 63 6b 54 6f 70 20  contextStackTop 
5d50: 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 46 72 65  = 0;.  sqliteFre
5d60: 65 28 70 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20  e(p->zErrMsg);. 
5d70: 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30 3b   p->zErrMsg = 0;
5d80: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 74 20 74 68  .}../*.** Set th
5d90: 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 65 73 75  e number of resu
5da0: 6c 74 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20  lt columns that 
5db0: 77 69 6c 6c 20 62 65 20 72 65 74 75 72 6e 65 64  will be returned
5dc0: 20 62 79 20 74 68 69 73 20 53 51 4c 0a 2a 2a 20   by this SQL.** 
5dd0: 73 74 61 74 65 6d 65 6e 74 2e 20 54 68 69 73 20  statement. This 
5de0: 69 73 20 6e 6f 77 20 73 65 74 20 61 74 20 63 6f  is now set at co
5df0: 6d 70 69 6c 65 20 74 69 6d 65 2c 20 72 61 74 68  mpile time, rath
5e00: 65 72 20 74 68 61 6e 20 64 75 72 69 6e 67 0a 2a  er than during.*
5e10: 2a 20 65 78 65 63 75 74 69 6f 6e 20 6f 66 20 74  * execution of t
5e20: 68 65 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20  he vdbe program 
5e30: 73 6f 20 74 68 61 74 20 73 71 6c 69 74 65 33 5f  so that sqlite3_
5e40: 63 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 29 20 63  column_count() c
5e50: 61 6e 0a 2a 2a 20 62 65 20 63 61 6c 6c 65 64 20  an.** be called 
5e60: 6f 6e 20 61 6e 20 53 51 4c 20 73 74 61 74 65 6d  on an SQL statem
5e70: 65 6e 74 20 62 65 66 6f 72 65 20 73 71 6c 69 74  ent before sqlit
5e80: 65 33 5f 73 74 65 70 28 29 2e 0a 2a 2f 0a 76 6f  e3_step()..*/.vo
5e90: 69 64 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  id sqlite3VdbeSe
5ea0: 74 4e 75 6d 43 6f 6c 73 28 56 64 62 65 20 2a 70  tNumCols(Vdbe *p
5eb0: 2c 20 69 6e 74 20 6e 52 65 73 43 6f 6c 75 6d 6e  , int nResColumn
5ec0: 29 7b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  ){.  Mem *pColNa
5ed0: 6d 65 3b 0a 20 20 69 6e 74 20 6e 3b 0a 20 20 72  me;.  int n;.  r
5ee0: 65 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70  eleaseMemArray(p
5ef0: 2d 3e 61 43 6f 6c 4e 61 6d 65 2c 20 70 2d 3e 6e  ->aColName, p->n
5f00: 52 65 73 43 6f 6c 75 6d 6e 2a 32 29 3b 0a 20 20  ResColumn*2);.  
5f10: 73 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 43  sqliteFree(p->aC
5f20: 6f 6c 4e 61 6d 65 29 3b 0a 20 20 6e 20 3d 20 6e  olName);.  n = n
5f30: 52 65 73 43 6f 6c 75 6d 6e 2a 32 3b 0a 20 20 70  ResColumn*2;.  p
5f40: 2d 3e 6e 52 65 73 43 6f 6c 75 6d 6e 20 3d 20 6e  ->nResColumn = n
5f50: 52 65 73 43 6f 6c 75 6d 6e 3b 0a 20 20 70 2d 3e  ResColumn;.  p->
5f60: 61 43 6f 6c 4e 61 6d 65 20 3d 20 70 43 6f 6c 4e  aColName = pColN
5f70: 61 6d 65 20 3d 20 28 4d 65 6d 2a 29 73 71 6c 69  ame = (Mem*)sqli
5f80: 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f 66  teMalloc( sizeof
5f90: 28 4d 65 6d 29 2a 6e 20 29 3b 0a 20 20 69 66 28  (Mem)*n );.  if(
5fa0: 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 3d 3d 30 20   p->aColName==0 
5fb0: 29 20 72 65 74 75 72 6e 3b 0a 20 20 77 68 69 6c  ) return;.  whil
5fc0: 65 28 20 6e 2d 2d 20 3e 20 30 20 29 7b 0a 20 20  e( n-- > 0 ){.  
5fd0: 20 20 28 70 43 6f 6c 4e 61 6d 65 2b 2b 29 2d 3e    (pColName++)->
5fe0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c  flags = MEM_Null
5ff0: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53  ;.  }.}../*.** S
6000: 65 74 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  et the name of t
6010: 68 65 20 69 64 78 27 74 68 20 63 6f 6c 75 6d 6e  he idx'th column
6020: 20 74 6f 20 62 65 20 72 65 74 75 72 6e 65 64 20   to be returned 
6030: 62 79 20 74 68 65 20 53 51 4c 20 73 74 61 74 65  by the SQL state
6040: 6d 65 6e 74 2e 0a 2a 2a 20 7a 4e 61 6d 65 20 6d  ment..** zName m
6050: 75 73 74 20 62 65 20 61 20 70 6f 69 6e 74 65 72  ust be a pointer
6060: 20 74 6f 20 61 20 6e 75 6c 20 74 65 72 6d 69 6e   to a nul termin
6070: 61 74 65 64 20 73 74 72 69 6e 67 2e 0a 2a 2a 0a  ated string..**.
6080: 2a 2a 20 54 68 69 73 20 63 61 6c 6c 20 6d 75 73  ** This call mus
6090: 74 20 62 65 20 6d 61 64 65 20 61 66 74 65 72 20  t be made after 
60a0: 61 20 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65  a call to sqlite
60b0: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
60c0: 29 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 4e 3d 3d 50  )..**.** If N==P
60d0: 33 5f 53 54 41 54 49 43 20 20 69 74 20 6d 65 61  3_STATIC  it mea
60e0: 6e 73 20 74 68 61 74 20 7a 4e 61 6d 65 20 69 73  ns that zName is
60f0: 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 61 20   a pointer to a 
6100: 63 6f 6e 73 74 61 6e 74 20 73 74 61 74 69 63 0a  constant static.
6110: 2a 2a 20 73 74 72 69 6e 67 20 61 6e 64 20 77 65  ** string and we
6120: 20 63 61 6e 20 6a 75 73 74 20 63 6f 70 79 20 74   can just copy t
6130: 68 65 20 70 6f 69 6e 74 65 72 2e 20 49 66 20 69  he pointer. If i
6140: 74 20 69 73 20 50 33 5f 44 59 4e 41 4d 49 43 2c  t is P3_DYNAMIC,
6150: 20 74 68 65 6e 20 0a 2a 2a 20 74 68 65 20 73 74   then .** the st
6160: 72 69 6e 67 20 69 73 20 66 72 65 65 64 20 75 73  ring is freed us
6170: 69 6e 67 20 73 71 6c 69 74 65 46 72 65 65 28 29  ing sqliteFree()
6180: 20 77 68 65 6e 20 74 68 65 20 76 64 62 65 20 69   when the vdbe i
6190: 73 20 66 69 6e 69 73 68 65 64 20 77 69 74 68 0a  s finished with.
61a0: 2a 2a 20 69 74 2e 20 4f 74 68 65 72 77 69 73 65  ** it. Otherwise
61b0: 2c 20 4e 20 62 79 74 65 73 20 6f 66 20 7a 4e 61  , N bytes of zNa
61c0: 6d 65 20 61 72 65 20 63 6f 70 69 65 64 2e 0a 2a  me are copied..*
61d0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62  /.int sqlite3Vdb
61e0: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 56 64 62 65  eSetColName(Vdbe
61f0: 20 2a 70 2c 20 69 6e 74 20 69 64 78 2c 20 63 6f   *p, int idx, co
6200: 6e 73 74 20 63 68 61 72 20 2a 7a 4e 61 6d 65 2c  nst char *zName,
6210: 20 69 6e 74 20 4e 29 7b 0a 20 20 69 6e 74 20 72   int N){.  int r
6220: 63 3b 0a 20 20 4d 65 6d 20 2a 70 43 6f 6c 4e 61  c;.  Mem *pColNa
6230: 6d 65 3b 0a 20 20 61 73 73 65 72 74 28 20 69 64  me;.  assert( id
6240: 78 3c 28 32 2a 70 2d 3e 6e 52 65 73 43 6f 6c 75  x<(2*p->nResColu
6250: 6d 6e 29 20 29 3b 0a 20 20 69 66 28 20 73 71 6c  mn) );.  if( sql
6260: 69 74 65 33 4d 61 6c 6c 6f 63 46 61 69 6c 65 64  ite3MallocFailed
6270: 28 29 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49  () ) return SQLI
6280: 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 61 73 73 65  TE_NOMEM;.  asse
6290: 72 74 28 20 70 2d 3e 61 43 6f 6c 4e 61 6d 65 21  rt( p->aColName!
62a0: 3d 30 20 29 3b 0a 20 20 70 43 6f 6c 4e 61 6d 65  =0 );.  pColName
62b0: 20 3d 20 26 28 70 2d 3e 61 43 6f 6c 4e 61 6d 65   = &(p->aColName
62c0: 5b 69 64 78 5d 29 3b 0a 20 20 69 66 28 20 4e 3d  [idx]);.  if( N=
62d0: 3d 50 33 5f 44 59 4e 41 4d 49 43 20 7c 7c 20 4e  =P3_DYNAMIC || N
62e0: 3d 3d 50 33 5f 53 54 41 54 49 43 20 29 7b 0a 20  ==P3_STATIC ){. 
62f0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 56     rc = sqlite3V
6300: 64 62 65 4d 65 6d 53 65 74 53 74 72 28 70 43 6f  dbeMemSetStr(pCo
6310: 6c 4e 61 6d 65 2c 20 7a 4e 61 6d 65 2c 20 2d 31  lName, zName, -1
6320: 2c 20 53 51 4c 49 54 45 5f 55 54 46 38 2c 20 53  , SQLITE_UTF8, S
6330: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
6340: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 72 63 20 3d   }else{.    rc =
6350: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 53   sqlite3VdbeMemS
6360: 65 74 53 74 72 28 70 43 6f 6c 4e 61 6d 65 2c 20  etStr(pColName, 
6370: 7a 4e 61 6d 65 2c 20 4e 2c 20 53 51 4c 49 54 45  zName, N, SQLITE
6380: 5f 55 54 46 38 2c 53 51 4c 49 54 45 5f 54 52 41  _UTF8,SQLITE_TRA
6390: 4e 53 49 45 4e 54 29 3b 0a 20 20 7d 0a 20 20 69  NSIENT);.  }.  i
63a0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
63b0: 20 26 26 20 4e 3d 3d 50 33 5f 44 59 4e 41 4d 49   && N==P3_DYNAMI
63c0: 43 20 29 7b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d  C ){.    pColNam
63d0: 65 2d 3e 66 6c 61 67 73 20 3d 20 28 70 43 6f 6c  e->flags = (pCol
63e0: 4e 61 6d 65 2d 3e 66 6c 61 67 73 26 28 7e 4d 45  Name->flags&(~ME
63f0: 4d 5f 53 74 61 74 69 63 29 29 7c 4d 45 4d 5f 44  M_Static))|MEM_D
6400: 79 6e 3b 0a 20 20 20 20 70 43 6f 6c 4e 61 6d 65  yn;.    pColName
6410: 2d 3e 78 44 65 6c 20 3d 20 30 3b 0a 20 20 7d 0a  ->xDel = 0;.  }.
6420: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6430: 2f 2a 0a 2a 2a 20 41 20 72 65 61 64 20 6f 72 20  /*.** A read or 
6440: 77 72 69 74 65 20 74 72 61 6e 73 61 63 74 69 6f  write transactio
6450: 6e 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74  n may or may not
6460: 20 62 65 20 61 63 74 69 76 65 20 6f 6e 20 64 61   be active on da
6470: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 0a 2a 2a  tabase handle.**
6480: 20 64 62 2e 20 49 66 20 61 20 74 72 61 6e 73 61   db. If a transa
6490: 63 74 69 6f 6e 20 69 73 20 61 63 74 69 76 65 2c  ction is active,
64a0: 20 63 6f 6d 6d 69 74 20 69 74 2e 20 49 66 20 74   commit it. If t
64b0: 68 65 72 65 20 69 73 20 61 0a 2a 2a 20 77 72 69  here is a.** wri
64c0: 74 65 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 73  te-transaction s
64d0: 70 61 6e 6e 69 6e 67 20 6d 6f 72 65 20 74 68 61  panning more tha
64e0: 6e 20 6f 6e 65 20 64 61 74 61 62 61 73 65 20 66  n one database f
64f0: 69 6c 65 2c 20 74 68 69 73 20 72 6f 75 74 69 6e  ile, this routin
6500: 65 0a 2a 2a 20 74 61 6b 65 73 20 63 61 72 65 20  e.** takes care 
6510: 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  of the master jo
6520: 75 72 6e 61 6c 20 74 72 69 63 6b 65 72 79 2e 0a  urnal trickery..
6530: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 76 64  */.static int vd
6540: 62 65 43 6f 6d 6d 69 74 28 73 71 6c 69 74 65 33  beCommit(sqlite3
6550: 20 2a 64 62 29 7b 0a 20 20 69 6e 74 20 69 3b 0a   *db){.  int i;.
6560: 20 20 69 6e 74 20 6e 54 72 61 6e 73 20 3d 20 30    int nTrans = 0
6570: 3b 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20  ;  /* Number of 
6580: 64 61 74 61 62 61 73 65 73 20 77 69 74 68 20 61  databases with a
6590: 6e 20 61 63 74 69 76 65 20 77 72 69 74 65 2d 74  n active write-t
65a0: 72 61 6e 73 61 63 74 69 6f 6e 20 2a 2f 0a 20 20  ransaction */.  
65b0: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f  int rc = SQLITE_
65c0: 4f 4b 3b 0a 20 20 69 6e 74 20 6e 65 65 64 58 63  OK;.  int needXc
65d0: 6f 6d 6d 69 74 20 3d 20 30 3b 0a 0a 20 20 66 6f  ommit = 0;..  fo
65e0: 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62  r(i=0; i<db->nDb
65f0: 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 42 74 72  ; i++){ .    Btr
6600: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
6610: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66  b[i].pBt;.    if
6620: 28 20 70 42 74 20 26 26 20 73 71 6c 69 74 65 33  ( pBt && sqlite3
6630: 42 74 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70  BtreeIsInTrans(p
6640: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 6e 65 65  Bt) ){.      nee
6650: 64 58 63 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20  dXcommit = 1;.  
6660: 20 20 20 20 69 66 28 20 69 21 3d 31 20 29 20 6e      if( i!=1 ) n
6670: 54 72 61 6e 73 2b 2b 3b 0a 20 20 20 20 7d 0a 20  Trans++;.    }. 
6680: 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72   }..  /* If ther
6690: 65 20 61 72 65 20 61 6e 79 20 77 72 69 74 65 2d  e are any write-
66a0: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 74 20  transactions at 
66b0: 61 6c 6c 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  all, invoke the 
66c0: 63 6f 6d 6d 69 74 20 68 6f 6f 6b 20 2a 2f 0a 20  commit hook */. 
66d0: 20 69 66 28 20 6e 65 65 64 58 63 6f 6d 6d 69 74   if( needXcommit
66e0: 20 26 26 20 64 62 2d 3e 78 43 6f 6d 6d 69 74 43   && db->xCommitC
66f0: 61 6c 6c 62 61 63 6b 20 29 7b 0a 20 20 20 20 73  allback ){.    s
6700: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28  qlite3SafetyOff(
6710: 64 62 29 3b 0a 20 20 20 20 72 63 20 3d 20 64 62  db);.    rc = db
6720: 2d 3e 78 43 6f 6d 6d 69 74 43 61 6c 6c 62 61 63  ->xCommitCallbac
6730: 6b 28 64 62 2d 3e 70 43 6f 6d 6d 69 74 41 72 67  k(db->pCommitArg
6740: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 61  );.    sqlite3Sa
6750: 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20 20  fetyOn(db);.    
6760: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20  if( rc ){.      
6770: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 43 4f  return SQLITE_CO
6780: 4e 53 54 52 41 49 4e 54 3b 0a 20 20 20 20 7d 0a  NSTRAINT;.    }.
6790: 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 73 69    }..  /* The si
67a0: 6d 70 6c 65 20 63 61 73 65 20 2d 20 6e 6f 20 6d  mple case - no m
67b0: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 64 61 74  ore than one dat
67c0: 61 62 61 73 65 20 66 69 6c 65 20 28 6e 6f 74 20  abase file (not 
67d0: 63 6f 75 6e 74 69 6e 67 20 74 68 65 0a 20 20 2a  counting the.  *
67e0: 2a 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 29  * TEMP database)
67f0: 20 68 61 73 20 61 20 74 72 61 6e 73 61 63 74 69   has a transacti
6800: 6f 6e 20 61 63 74 69 76 65 2e 20 20 20 54 68 65  on active.   The
6810: 72 65 20 69 73 20 6e 6f 20 6e 65 65 64 20 66 6f  re is no need fo
6820: 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61 73 74 65  r the.  ** maste
6830: 72 2d 6a 6f 75 72 6e 61 6c 2e 0a 20 20 2a 2a 0a  r-journal..  **.
6840: 20 20 2a 2a 20 49 66 20 74 68 65 20 72 65 74 75    ** If the retu
6850: 72 6e 20 76 61 6c 75 65 20 6f 66 20 73 71 6c 69  rn value of sqli
6860: 74 65 33 42 74 72 65 65 47 65 74 46 69 6c 65 6e  te3BtreeGetFilen
6870: 61 6d 65 28 29 20 69 73 20 61 20 7a 65 72 6f 20  ame() is a zero 
6880: 6c 65 6e 67 74 68 0a 20 20 2a 2a 20 73 74 72 69  length.  ** stri
6890: 6e 67 2c 20 69 74 20 6d 65 61 6e 73 20 74 68 65  ng, it means the
68a0: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 69   main database i
68b0: 73 20 3a 6d 65 6d 6f 72 79 3a 2e 20 20 49 6e 20  s :memory:.  In 
68c0: 74 68 61 74 20 63 61 73 65 20 77 65 20 64 6f 0a  that case we do.
68d0: 20 20 2a 2a 20 6e 6f 74 20 73 75 70 70 6f 72 74    ** not support
68e0: 20 61 74 6f 6d 69 63 20 6d 75 6c 74 69 2d 66 69   atomic multi-fi
68f0: 6c 65 20 63 6f 6d 6d 69 74 73 2c 20 73 6f 20 75  le commits, so u
6900: 73 65 20 74 68 65 20 73 69 6d 70 6c 65 20 63 61  se the simple ca
6910: 73 65 20 74 68 65 6e 0a 20 20 2a 2a 20 74 6f 6f  se then.  ** too
6920: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 30 3d 3d  ..  */.  if( 0==
6930: 73 74 72 6c 65 6e 28 73 71 6c 69 74 65 33 42 74  strlen(sqlite3Bt
6940: 72 65 65 47 65 74 46 69 6c 65 6e 61 6d 65 28 64  reeGetFilename(d
6950: 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 29 20  b->aDb[0].pBt)) 
6960: 7c 7c 20 6e 54 72 61 6e 73 3c 3d 31 20 29 7b 0a  || nTrans<=1 ){.
6970: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 72 63 3d      for(i=0; rc=
6980: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 69 3c  =SQLITE_OK && i<
6990: 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 7b 20 0a  db->nDb; i++){ .
69a0: 20 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74        Btree *pBt
69b0: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42   = db->aDb[i].pB
69c0: 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 74  t;.      if( pBt
69d0: 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d   ){.        rc =
69e0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e   sqlite3BtreeSyn
69f0: 63 28 70 42 74 2c 20 30 29 3b 0a 20 20 20 20 20  c(pBt, 0);.     
6a00: 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a   }.    }..    /*
6a10: 20 44 6f 20 74 68 65 20 63 6f 6d 6d 69 74 20 6f   Do the commit o
6a20: 6e 6c 79 20 69 66 20 61 6c 6c 20 64 61 74 61 62  nly if all datab
6a30: 61 73 65 73 20 73 75 63 63 65 73 73 66 75 6c 6c  ases successfull
6a40: 79 20 73 79 6e 63 65 64 20 2a 2f 0a 20 20 20 20  y synced */.    
6a50: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
6a60: 4b 20 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 69  K ){.      for(i
6a70: 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69  =0; i<db->nDb; i
6a80: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 42 74 72  ++){.        Btr
6a90: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
6aa0: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
6ab0: 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20    if( pBt ){.   
6ac0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74         sqlite3Bt
6ad0: 72 65 65 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a  reeCommit(pBt);.
6ae0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
6af0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f  }.    }.  }..  /
6b00: 2a 20 54 68 65 20 63 6f 6d 70 6c 65 78 20 63 61  * The complex ca
6b10: 73 65 20 2d 20 54 68 65 72 65 20 69 73 20 61 20  se - There is a 
6b20: 6d 75 6c 74 69 2d 66 69 6c 65 20 77 72 69 74 65  multi-file write
6b30: 2d 74 72 61 6e 73 61 63 74 69 6f 6e 20 61 63 74  -transaction act
6b40: 69 76 65 2e 0a 20 20 2a 2a 20 54 68 69 73 20 72  ive..  ** This r
6b50: 65 71 75 69 72 65 73 20 61 20 6d 61 73 74 65 72  equires a master
6b60: 20 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 74 6f   journal file to
6b70: 20 65 6e 73 75 72 65 20 74 68 65 20 74 72 61 6e   ensure the tran
6b80: 73 61 63 74 69 6f 6e 20 69 73 0a 20 20 2a 2a 20  saction is.  ** 
6b90: 63 6f 6d 6d 69 74 74 65 64 20 61 74 6f 6d 69 63  committed atomic
6ba0: 6c 79 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66  ly..  */.#ifndef
6bb0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 49 53   SQLITE_OMIT_DIS
6bc0: 4b 49 4f 0a 20 20 65 6c 73 65 7b 0a 20 20 20 20  KIO.  else{.    
6bd0: 69 6e 74 20 6e 65 65 64 53 79 6e 63 20 3d 20 30  int needSync = 0
6be0: 3b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4d 61 73  ;.    char *zMas
6bf0: 74 65 72 20 3d 20 30 3b 20 20 20 2f 2a 20 46 69  ter = 0;   /* Fi
6c00: 6c 65 2d 6e 61 6d 65 20 66 6f 72 20 74 68 65 20  le-name for the 
6c10: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 2a  master journal *
6c20: 2f 0a 20 20 20 20 63 68 61 72 20 63 6f 6e 73 74  /.    char const
6c30: 20 2a 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71   *zMainFile = sq
6c40: 6c 69 74 65 33 42 74 72 65 65 47 65 74 46 69 6c  lite3BtreeGetFil
6c50: 65 6e 61 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d  ename(db->aDb[0]
6c60: 2e 70 42 74 29 3b 0a 20 20 20 20 4f 73 46 69 6c  .pBt);.    OsFil
6c70: 65 20 2a 6d 61 73 74 65 72 20 3d 20 30 3b 0a 0a  e *master = 0;..
6c80: 20 20 20 20 2f 2a 20 53 65 6c 65 63 74 20 61 20      /* Select a 
6c90: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
6ca0: 69 6c 65 20 6e 61 6d 65 20 2a 2f 0a 20 20 20 20  ile name */.    
6cb0: 64 6f 20 7b 0a 20 20 20 20 20 20 75 33 32 20 72  do {.      u32 r
6cc0: 61 6e 64 6f 6d 3b 0a 20 20 20 20 20 20 73 71 6c  andom;.      sql
6cd0: 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65 72 29  iteFree(zMaster)
6ce0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52  ;.      sqlite3R
6cf0: 61 6e 64 6f 6d 6e 65 73 73 28 73 69 7a 65 6f 66  andomness(sizeof
6d00: 28 72 61 6e 64 6f 6d 29 2c 20 26 72 61 6e 64 6f  (random), &rando
6d10: 6d 29 3b 0a 20 20 20 20 20 20 7a 4d 61 73 74 65  m);.      zMaste
6d20: 72 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e  r = sqlite3MPrin
6d30: 74 66 28 22 25 73 2d 6d 6a 25 30 38 58 22 2c 20  tf("%s-mj%08X", 
6d40: 7a 4d 61 69 6e 46 69 6c 65 2c 20 72 61 6e 64 6f  zMainFile, rando
6d50: 6d 26 30 78 37 66 66 66 66 66 66 66 29 3b 0a 20  m&0x7fffffff);. 
6d60: 20 20 20 20 20 69 66 28 20 21 7a 4d 61 73 74 65       if( !zMaste
6d70: 72 20 29 7b 0a 20 20 20 20 20 20 20 20 72 65 74  r ){.        ret
6d80: 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  urn SQLITE_NOMEM
6d90: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 77  ;.      }.    }w
6da0: 68 69 6c 65 28 20 73 71 6c 69 74 65 33 4f 73 46  hile( sqlite3OsF
6db0: 69 6c 65 45 78 69 73 74 73 28 7a 4d 61 73 74 65  ileExists(zMaste
6dc0: 72 29 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 4f 70  r) );..    /* Op
6dd0: 65 6e 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f  en the master jo
6de0: 75 72 6e 61 6c 2e 20 2a 2f 0a 20 20 20 20 72 63  urnal. */.    rc
6df0: 20 3d 20 73 71 6c 69 74 65 33 4f 73 4f 70 65 6e   = sqlite3OsOpen
6e00: 45 78 63 6c 75 73 69 76 65 28 7a 4d 61 73 74 65  Exclusive(zMaste
6e10: 72 2c 20 26 6d 61 73 74 65 72 2c 20 30 29 3b 0a  r, &master, 0);.
6e20: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
6e30: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73  TE_OK ){.      s
6e40: 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65  qliteFree(zMaste
6e50: 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  r);.      return
6e60: 20 72 63 3b 0a 20 20 20 20 7d 0a 20 0a 20 20 20   rc;.    }. .   
6e70: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 6e 61   /* Write the na
6e80: 6d 65 20 6f 66 20 65 61 63 68 20 64 61 74 61 62  me of each datab
6e90: 61 73 65 20 66 69 6c 65 20 69 6e 20 74 68 65 20  ase file in the 
6ea0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 6e 74 6f  transaction into
6eb0: 20 74 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20   the new.    ** 
6ec0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
6ed0: 69 6c 65 2e 20 49 66 20 61 6e 20 65 72 72 6f 72  ile. If an error
6ee0: 20 6f 63 63 75 72 73 20 61 74 20 74 68 69 73 20   occurs at this 
6ef0: 70 6f 69 6e 74 20 63 6c 6f 73 65 0a 20 20 20 20  point close.    
6f00: 2a 2a 20 61 6e 64 20 64 65 6c 65 74 65 20 74 68  ** and delete th
6f10: 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c  e master journal
6f20: 20 66 69 6c 65 2e 20 41 6c 6c 20 74 68 65 20 69   file. All the i
6f30: 6e 64 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61  ndividual journa
6f40: 6c 20 66 69 6c 65 73 0a 20 20 20 20 2a 2a 20 73  l files.    ** s
6f50: 74 69 6c 6c 20 68 61 76 65 20 27 6e 75 6c 6c 27  till have 'null'
6f60: 20 61 73 20 74 68 65 20 6d 61 73 74 65 72 20 6a   as the master j
6f70: 6f 75 72 6e 61 6c 20 70 6f 69 6e 74 65 72 2c 20  ournal pointer, 
6f80: 73 6f 20 74 68 65 79 20 77 69 6c 6c 20 72 6f 6c  so they will rol
6f90: 6c 0a 20 20 20 20 2a 2a 20 62 61 63 6b 20 69 6e  l.    ** back in
6fa0: 64 65 70 65 6e 64 65 6e 74 6c 79 20 69 66 20 61  dependently if a
6fb0: 20 66 61 69 6c 75 72 65 20 6f 63 63 75 72 73 2e   failure occurs.
6fc0: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28  .    */.    for(
6fd0: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
6fe0: 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20 42 74 72  i++){ .      Btr
6ff0: 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44  ee *pBt = db->aD
7000: 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 20 20  b[i].pBt;.      
7010: 69 66 28 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69  if( i==1 ) conti
7020: 6e 75 65 3b 20 20 20 2f 2a 20 49 67 6e 6f 72 65  nue;   /* Ignore
7030: 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 62 61   the TEMP databa
7040: 73 65 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20  se */.      if( 
7050: 70 42 74 20 26 26 20 73 71 6c 69 74 65 33 42 74  pBt && sqlite3Bt
7060: 72 65 65 49 73 49 6e 54 72 61 6e 73 28 70 42 74  reeIsInTrans(pBt
7070: 29 20 29 7b 0a 20 20 20 20 20 20 20 20 63 68 61  ) ){.        cha
7080: 72 20 63 6f 6e 73 74 20 2a 7a 46 69 6c 65 20 3d  r const *zFile =
7090: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74   sqlite3BtreeGet
70a0: 4a 6f 75 72 6e 61 6c 6e 61 6d 65 28 70 42 74 29  Journalname(pBt)
70b0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 7a 46  ;.        if( zF
70c0: 69 6c 65 5b 30 5d 3d 3d 30 20 29 20 63 6f 6e 74  ile[0]==0 ) cont
70d0: 69 6e 75 65 3b 20 20 2f 2a 20 49 67 6e 6f 72 65  inue;  /* Ignore
70e0: 20 3a 6d 65 6d 6f 72 79 3a 20 64 61 74 61 62 61   :memory: databa
70f0: 73 65 73 20 2a 2f 0a 20 20 20 20 20 20 20 20 69  ses */.        i
7100: 66 28 20 21 6e 65 65 64 53 79 6e 63 20 26 26 20  f( !needSync && 
7110: 21 73 71 6c 69 74 65 33 42 74 72 65 65 53 79 6e  !sqlite3BtreeSyn
7120: 63 44 69 73 61 62 6c 65 64 28 70 42 74 29 20 29  cDisabled(pBt) )
7130: 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 65 65 64  {.          need
7140: 53 79 6e 63 20 3d 20 31 3b 0a 20 20 20 20 20 20  Sync = 1;.      
7150: 20 20 7d 0a 20 20 20 20 20 20 20 20 72 63 20 3d    }.        rc =
7160: 20 73 71 6c 69 74 65 33 4f 73 57 72 69 74 65 28   sqlite3OsWrite(
7170: 6d 61 73 74 65 72 2c 20 7a 46 69 6c 65 2c 20 73  master, zFile, s
7180: 74 72 6c 65 6e 28 7a 46 69 6c 65 29 2b 31 29 3b  trlen(zFile)+1);
7190: 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21  .        if( rc!
71a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
71b0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f          sqlite3O
71c0: 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72 29 3b  sClose(&master);
71d0: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  .          sqlit
71e0: 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74  e3OsDelete(zMast
71f0: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 73  er);.          s
7200: 71 6c 69 74 65 46 72 65 65 28 7a 4d 61 73 74 65  qliteFree(zMaste
7210: 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 72 65  r);.          re
7220: 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 20 20 20  turn rc;.       
7230: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d   }.      }.    }
7240: 0a 0a 0a 20 20 20 20 2f 2a 20 53 79 6e 63 20 74  ...    /* Sync t
7250: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
7260: 6c 20 66 69 6c 65 2e 20 42 65 66 6f 72 65 20 64  l file. Before d
7270: 6f 69 6e 67 20 74 68 69 73 2c 20 6f 70 65 6e 20  oing this, open 
7280: 74 68 65 20 64 69 72 65 63 74 6f 72 79 0a 20 20  the directory.  
7290: 20 20 2a 2a 20 74 68 65 20 6d 61 73 74 65 72 20    ** the master 
72a0: 6a 6f 75 72 6e 61 6c 20 66 69 6c 65 20 69 73 20  journal file is 
72b0: 73 74 6f 72 65 20 69 6e 20 73 6f 20 74 68 61 74  store in so that
72c0: 20 69 74 20 67 65 74 73 20 73 79 6e 63 65 64 20   it gets synced 
72d0: 74 6f 6f 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  too..    */.    
72e0: 7a 4d 61 69 6e 46 69 6c 65 20 3d 20 73 71 6c 69  zMainFile = sqli
72f0: 74 65 33 42 74 72 65 65 47 65 74 44 69 72 6e 61  te3BtreeGetDirna
7300: 6d 65 28 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42  me(db->aDb[0].pB
7310: 74 29 3b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  t);.    rc = sql
7320: 69 74 65 33 4f 73 4f 70 65 6e 44 69 72 65 63 74  ite3OsOpenDirect
7330: 6f 72 79 28 6d 61 73 74 65 72 2c 20 7a 4d 61 69  ory(master, zMai
7340: 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69 66 28 20  nFile);.    if( 
7350: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c  rc!=SQLITE_OK ||
7360: 0a 20 20 20 20 20 20 20 20 20 20 28 6e 65 65 64  .          (need
7370: 53 79 6e 63 20 26 26 20 28 72 63 3d 73 71 6c 69  Sync && (rc=sqli
7380: 74 65 33 4f 73 53 79 6e 63 28 6d 61 73 74 65 72  te3OsSync(master
7390: 2c 30 29 29 21 3d 53 51 4c 49 54 45 5f 4f 4b 29  ,0))!=SQLITE_OK)
73a0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
73b0: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
73c0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
73d0: 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74 65 72  OsDelete(zMaster
73e0: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 46  );.      sqliteF
73f0: 72 65 65 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20  ree(zMaster);.  
7400: 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20      return rc;. 
7410: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 53 79 6e     }..    /* Syn
7420: 63 20 61 6c 6c 20 74 68 65 20 64 62 20 66 69 6c  c all the db fil
7430: 65 73 20 69 6e 76 6f 6c 76 65 64 20 69 6e 20 74  es involved in t
7440: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20  he transaction. 
7450: 54 68 65 20 73 61 6d 65 20 63 61 6c 6c 0a 20 20  The same call.  
7460: 20 20 2a 2a 20 73 65 74 73 20 74 68 65 20 6d 61    ** sets the ma
7470: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 70 6f 69  ster journal poi
7480: 6e 74 65 72 20 69 6e 20 65 61 63 68 20 69 6e 64  nter in each ind
7490: 69 76 69 64 75 61 6c 20 6a 6f 75 72 6e 61 6c 2e  ividual journal.
74a0: 20 49 66 0a 20 20 20 20 2a 2a 20 61 6e 20 65 72   If.    ** an er
74b0: 72 6f 72 20 6f 63 63 75 72 73 20 68 65 72 65 2c  ror occurs here,
74c0: 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74   do not delete t
74d0: 68 65 20 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61  he master journa
74e0: 6c 20 66 69 6c 65 2e 0a 20 20 20 20 2a 2a 0a 20  l file..    **. 
74f0: 20 20 20 2a 2a 20 49 66 20 74 68 65 20 65 72 72     ** If the err
7500: 6f 72 20 6f 63 63 75 72 73 20 64 75 72 69 6e 67  or occurs during
7510: 20 74 68 65 20 66 69 72 73 74 20 63 61 6c 6c 20   the first call 
7520: 74 6f 20 73 71 6c 69 74 65 33 42 74 72 65 65 53  to sqlite3BtreeS
7530: 79 6e 63 28 29 2c 0a 20 20 20 20 2a 2a 20 74 68  ync(),.    ** th
7540: 65 6e 20 74 68 65 72 65 20 69 73 20 61 20 63 68  en there is a ch
7550: 61 6e 63 65 20 74 68 61 74 20 74 68 65 20 6d 61  ance that the ma
7560: 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66 69 6c  ster journal fil
7570: 65 20 77 69 6c 6c 20 62 65 0a 20 20 20 20 2a 2a  e will be.    **
7580: 20 6f 72 70 68 61 6e 65 64 2e 20 42 75 74 20 77   orphaned. But w
7590: 65 20 63 61 6e 6e 6f 74 20 64 65 6c 65 74 65 20  e cannot delete 
75a0: 69 74 2c 20 69 6e 20 63 61 73 65 20 74 68 65 20  it, in case the 
75b0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 0a 20  master journal. 
75c0: 20 20 20 2a 2a 20 66 69 6c 65 20 6e 61 6d 65 20     ** file name 
75d0: 77 61 73 20 77 72 69 74 74 65 6e 20 69 6e 74 6f  was written into
75e0: 20 74 68 65 20 6a 6f 75 72 6e 61 6c 20 66 69 6c   the journal fil
75f0: 65 20 62 65 66 6f 72 65 20 74 68 65 20 66 61 69  e before the fai
7600: 6c 75 72 65 0a 20 20 20 20 2a 2a 20 6f 63 63 75  lure.    ** occu
7610: 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  red..    */.    
7620: 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e  for(i=0; i<db->n
7630: 44 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20  Db; i++){ .     
7640: 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62   Btree *pBt = db
7650: 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20  ->aDb[i].pBt;.  
7660: 20 20 20 20 69 66 28 20 70 42 74 20 26 26 20 73      if( pBt && s
7670: 71 6c 69 74 65 33 42 74 72 65 65 49 73 49 6e 54  qlite3BtreeIsInT
7680: 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20 20 20  rans(pBt) ){.   
7690: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
76a0: 33 42 74 72 65 65 53 79 6e 63 28 70 42 74 2c 20  3BtreeSync(pBt, 
76b0: 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  zMaster);.      
76c0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45    if( rc!=SQLITE
76d0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 20  _OK ){.         
76e0: 20 73 71 6c 69 74 65 33 4f 73 43 6c 6f 73 65 28   sqlite3OsClose(
76f0: 26 6d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20  &master);.      
7700: 20 20 20 20 73 71 6c 69 74 65 46 72 65 65 28 7a      sqliteFree(z
7710: 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 20 20 20  Master);.       
7720: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20     return rc;.  
7730: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
7740: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
7750: 33 4f 73 43 6c 6f 73 65 28 26 6d 61 73 74 65 72  3OsClose(&master
7760: 29 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 6c 65 74  );..    /* Delet
7770: 65 20 74 68 65 20 6d 61 73 74 65 72 20 6a 6f 75  e the master jou
7780: 72 6e 61 6c 20 66 69 6c 65 2e 20 54 68 69 73 20  rnal file. This 
7790: 63 6f 6d 6d 69 74 73 20 74 68 65 20 74 72 61 6e  commits the tran
77a0: 73 61 63 74 69 6f 6e 2e 20 41 66 74 65 72 0a 20  saction. After. 
77b0: 20 20 20 2a 2a 20 64 6f 69 6e 67 20 74 68 69 73     ** doing this
77c0: 20 74 68 65 20 64 69 72 65 63 74 6f 72 79 20 69   the directory i
77d0: 73 20 73 79 6e 63 65 64 20 61 67 61 69 6e 20 62  s synced again b
77e0: 65 66 6f 72 65 20 61 6e 79 20 69 6e 64 69 76 69  efore any indivi
77f0: 64 75 61 6c 0a 20 20 20 20 2a 2a 20 74 72 61 6e  dual.    ** tran
7800: 73 61 63 74 69 6f 6e 20 66 69 6c 65 73 20 61 72  saction files ar
7810: 65 20 64 65 6c 65 74 65 64 2e 0a 20 20 20 20 2a  e deleted..    *
7820: 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  /.    rc = sqlit
7830: 65 33 4f 73 44 65 6c 65 74 65 28 7a 4d 61 73 74  e3OsDelete(zMast
7840: 65 72 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  er);.    assert(
7850: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
7860: 3b 0a 20 20 20 20 73 71 6c 69 74 65 46 72 65 65  ;.    sqliteFree
7870: 28 7a 4d 61 73 74 65 72 29 3b 0a 20 20 20 20 7a  (zMaster);.    z
7880: 4d 61 73 74 65 72 20 3d 20 30 3b 0a 20 20 20 20  Master = 0;.    
7890: 72 63 20 3d 20 73 71 6c 69 74 65 33 4f 73 53 79  rc = sqlite3OsSy
78a0: 6e 63 44 69 72 65 63 74 6f 72 79 28 7a 4d 61 69  ncDirectory(zMai
78b0: 6e 46 69 6c 65 29 3b 0a 20 20 20 20 69 66 28 20  nFile);.    if( 
78c0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
78d0: 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69  .      /* This i
78e0: 73 20 6e 6f 74 20 67 6f 6f 64 2e 20 54 68 65 20  s not good. The 
78f0: 6d 61 73 74 65 72 20 6a 6f 75 72 6e 61 6c 20 66  master journal f
7900: 69 6c 65 20 68 61 73 20 62 65 65 6e 20 64 65 6c  ile has been del
7910: 65 74 65 64 2c 20 62 75 74 0a 20 20 20 20 20 20  eted, but.      
7920: 2a 2a 20 74 68 65 20 64 69 72 65 63 74 6f 72 79  ** the directory
7930: 20 73 79 6e 63 20 66 61 69 6c 65 64 2e 20 54 68   sync failed. Th
7940: 65 72 65 20 69 73 20 6e 6f 20 63 6f 6d 70 6c 65  ere is no comple
7950: 74 65 6c 79 20 73 61 66 65 20 63 6f 75 72 73 65  tely safe course
7960: 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 61 63 74   of.      ** act
7970: 69 6f 6e 20 66 72 6f 6d 20 68 65 72 65 2e 20 54  ion from here. T
7980: 68 65 20 69 6e 64 69 76 69 64 75 61 6c 20 6a 6f  he individual jo
7990: 75 72 6e 61 6c 73 20 63 6f 6e 74 61 69 6e 20 74  urnals contain t
79a0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 0a 20  he name of the. 
79b0: 20 20 20 20 20 2a 2a 20 6d 61 73 74 65 72 20 6a       ** master j
79c0: 6f 75 72 6e 61 6c 20 66 69 6c 65 2c 20 62 75 74  ournal file, but
79d0: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79   there is no way
79e0: 20 6f 66 20 6b 6e 6f 77 69 6e 67 20 69 66 20 74   of knowing if t
79f0: 68 61 74 0a 20 20 20 20 20 20 2a 2a 20 6d 61 73  hat.      ** mas
7a00: 74 65 72 20 6a 6f 75 72 6e 61 6c 20 65 78 69 73  ter journal exis
7a10: 74 73 20 6e 6f 77 20 6f 72 20 69 66 20 69 74 20  ts now or if it 
7a20: 77 69 6c 6c 20 65 78 69 73 74 20 61 66 74 65 72  will exist after
7a30: 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67 0a 20   the operating. 
7a40: 20 20 20 20 20 2a 2a 20 73 79 73 74 65 6d 20 63       ** system c
7a50: 72 61 73 68 20 74 68 61 74 20 6d 61 79 20 66 6f  rash that may fo
7a60: 6c 6c 6f 77 20 74 68 65 20 66 73 79 6e 63 28 29  llow the fsync()
7a70: 20 66 61 69 6c 75 72 65 2e 0a 20 20 20 20 20 20   failure..      
7a80: 2a 2f 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  */.      return 
7a90: 72 63 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f  rc;.    }..    /
7aa0: 2a 20 41 6c 6c 20 66 69 6c 65 73 20 61 6e 64 20  * All files and 
7ab0: 64 69 72 65 63 74 6f 72 69 65 73 20 68 61 76 65  directories have
7ac0: 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 73 79   already been sy
7ad0: 6e 63 65 64 2c 20 73 6f 20 74 68 65 20 66 6f 6c  nced, so the fol
7ae0: 6c 6f 77 69 6e 67 0a 20 20 20 20 2a 2a 20 63 61  lowing.    ** ca
7af0: 6c 6c 73 20 74 6f 20 73 71 6c 69 74 65 33 42 74  lls to sqlite3Bt
7b00: 72 65 65 43 6f 6d 6d 69 74 28 29 20 61 72 65 20  reeCommit() are 
7b10: 6f 6e 6c 79 20 63 6c 6f 73 69 6e 67 20 66 69 6c  only closing fil
7b20: 65 73 20 61 6e 64 20 64 65 6c 65 74 69 6e 67 0a  es and deleting.
7b30: 20 20 20 20 2a 2a 20 6a 6f 75 72 6e 61 6c 73 2e      ** journals.
7b40: 20 49 66 20 73 6f 6d 65 74 68 69 6e 67 20 67 6f   If something go
7b50: 65 73 20 77 72 6f 6e 67 20 77 68 69 6c 65 20 74  es wrong while t
7b60: 68 69 73 20 69 73 20 68 61 70 70 65 6e 69 6e 67  his is happening
7b70: 20 77 65 20 64 6f 6e 27 74 0a 20 20 20 20 2a 2a   we don't.    **
7b80: 20 72 65 61 6c 6c 79 20 63 61 72 65 2e 20 54 68   really care. Th
7b90: 65 20 69 6e 74 65 67 72 69 74 79 20 6f 66 20 74  e integrity of t
7ba0: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69  he transaction i
7bb0: 73 20 61 6c 72 65 61 64 79 20 67 75 61 72 61 6e  s already guaran
7bc0: 74 65 65 64 2c 0a 20 20 20 20 2a 2a 20 62 75 74  teed,.    ** but
7bd0: 20 73 6f 6d 65 20 73 74 72 61 79 20 27 63 6f 6c   some stray 'col
7be0: 64 27 20 6a 6f 75 72 6e 61 6c 73 20 6d 61 79 20  d' journals may 
7bf0: 62 65 20 6c 79 69 6e 67 20 61 72 6f 75 6e 64 2e  be lying around.
7c00: 20 52 65 74 75 72 6e 69 6e 67 20 61 6e 0a 20 20   Returning an.  
7c10: 20 20 2a 2a 20 65 72 72 6f 72 20 63 6f 64 65 20    ** error code 
7c20: 77 6f 6e 27 74 20 68 65 6c 70 20 6d 61 74 74 65  won't help matte
7c30: 72 73 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 66  rs..    */.    f
7c40: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44  or(i=0; i<db->nD
7c50: 62 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 20 20 20  b; i++){ .      
7c60: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
7c70: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
7c80: 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20     if( pBt ){.  
7c90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 42 74 72        sqlite3Btr
7ca0: 65 65 43 6f 6d 6d 69 74 28 70 42 74 29 3b 0a 20  eeCommit(pBt);. 
7cb0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
7cc0: 0a 23 65 6e 64 69 66 0a 0a 20 20 72 65 74 75 72  .#endif..  retur
7cd0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  n rc;.}../*.** F
7ce0: 69 6e 64 20 65 76 65 72 79 20 61 63 74 69 76 65  ind every active
7cf0: 20 56 4d 20 6f 74 68 65 72 20 74 68 61 6e 20 70   VM other than p
7d00: 56 64 62 65 20 61 6e 64 20 63 68 61 6e 67 65 20  Vdbe and change 
7d10: 69 74 73 20 73 74 61 74 75 73 20 74 6f 0a 2a 2a  its status to.**
7d20: 20 61 62 6f 72 74 65 64 2e 20 20 54 68 69 73 20   aborted.  This 
7d30: 68 61 70 70 65 6e 73 20 77 68 65 6e 20 6f 6e 65  happens when one
7d40: 20 56 4d 20 63 61 75 73 65 73 20 61 20 72 6f 6c   VM causes a rol
7d50: 6c 62 61 63 6b 20 64 75 65 20 74 6f 20 61 6e 0a  lback due to an.
7d60: 2a 2a 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 52  ** ON CONFLICT R
7d70: 4f 4c 4c 42 41 43 4b 20 63 6c 61 75 73 65 20 28  OLLBACK clause (
7d80: 66 6f 72 20 65 78 61 6d 70 6c 65 29 2e 20 20 54  for example).  T
7d90: 68 65 20 6f 74 68 65 72 20 56 4d 73 20 6d 75 73  he other VMs mus
7da0: 74 20 62 65 0a 2a 2a 20 61 62 6f 72 74 65 64 20  t be.** aborted 
7db0: 73 6f 20 74 68 61 74 20 74 68 65 79 20 64 6f 20  so that they do 
7dc0: 6e 6f 74 20 68 61 76 65 20 64 61 74 61 20 72 6f  not have data ro
7dd0: 6c 6c 65 64 20 6f 75 74 20 66 72 6f 6d 20 75 6e  lled out from un
7de0: 64 65 72 6e 65 61 74 68 0a 2a 2a 20 74 68 65 6d  derneath.** them
7df0: 20 6c 65 61 64 69 6e 67 20 74 6f 20 61 20 73 65   leading to a se
7e00: 67 66 61 75 6c 74 2e 0a 2a 2f 0a 73 74 61 74 69  gfault..*/.stati
7e10: 63 20 76 6f 69 64 20 61 62 6f 72 74 4f 74 68 65  c void abortOthe
7e20: 72 41 63 74 69 76 65 56 64 62 65 73 28 56 64 62  rActiveVdbes(Vdb
7e30: 65 20 2a 70 56 64 62 65 29 7b 0a 20 20 56 64 62  e *pVdbe){.  Vdb
7e40: 65 20 2a 70 4f 74 68 65 72 3b 0a 20 20 66 6f 72  e *pOther;.  for
7e50: 28 70 4f 74 68 65 72 3d 70 56 64 62 65 2d 3e 64  (pOther=pVdbe->d
7e60: 62 2d 3e 70 56 64 62 65 3b 20 70 4f 74 68 65 72  b->pVdbe; pOther
7e70: 3b 20 70 4f 74 68 65 72 3d 70 4f 74 68 65 72 2d  ; pOther=pOther-
7e80: 3e 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28  >pNext){.    if(
7e90: 20 70 4f 74 68 65 72 3d 3d 70 56 64 62 65 20 29   pOther==pVdbe )
7ea0: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69   continue;.    i
7eb0: 66 28 20 70 4f 74 68 65 72 2d 3e 6d 61 67 69 63  f( pOther->magic
7ec0: 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e  !=VDBE_MAGIC_RUN
7ed0: 20 7c 7c 20 70 4f 74 68 65 72 2d 3e 70 63 3c 30   || pOther->pc<0
7ee0: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20   ) continue;.   
7ef0: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
7f00: 28 70 4f 74 68 65 72 29 3b 0a 20 20 20 20 70 4f  (pOther);.    pO
7f10: 74 68 65 72 2d 3e 61 62 6f 72 74 65 64 20 3d 20  ther->aborted = 
7f20: 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 20 0a 2a 2a  1;.  }.}../* .**
7f30: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 68   This routine ch
7f40: 65 63 6b 73 20 74 68 61 74 20 74 68 65 20 73 71  ecks that the sq
7f50: 6c 69 74 65 33 2e 61 63 74 69 76 65 56 64 62 65  lite3.activeVdbe
7f60: 43 6e 74 20 63 6f 75 6e 74 20 76 61 72 69 61 62  Cnt count variab
7f70: 6c 65 0a 2a 2a 20 6d 61 74 63 68 65 73 20 74 68  le.** matches th
7f80: 65 20 6e 75 6d 62 65 72 20 6f 66 20 76 64 62 65  e number of vdbe
7f90: 27 73 20 69 6e 20 74 68 65 20 6c 69 73 74 20 73  's in the list s
7fa0: 71 6c 69 74 65 33 2e 70 56 64 62 65 20 74 68 61  qlite3.pVdbe tha
7fb0: 74 20 61 72 65 0a 2a 2a 20 63 75 72 72 65 6e 74  t are.** current
7fc0: 6c 79 20 61 63 74 69 76 65 2e 20 41 6e 20 61 73  ly active. An as
7fd0: 73 65 72 74 69 6f 6e 20 66 61 69 6c 73 20 69 66  sertion fails if
7fe0: 20 74 68 65 20 74 77 6f 20 63 6f 75 6e 74 73 20   the two counts 
7ff0: 64 6f 20 6e 6f 74 20 6d 61 74 63 68 2e 0a 2a 2a  do not match..**
8000: 20 54 68 69 73 20 69 73 20 61 6e 20 69 6e 74 65   This is an inte
8010: 72 6e 61 6c 20 73 65 6c 66 2d 63 68 65 63 6b 20  rnal self-check 
8020: 6f 6e 6c 79 20 2d 20 69 74 20 69 73 20 6e 6f 74  only - it is not
8030: 20 61 6e 20 65 73 73 65 6e 74 69 61 6c 20 70 72   an essential pr
8040: 6f 63 65 73 73 69 6e 67 0a 2a 2a 20 73 74 65 70  ocessing.** step
8050: 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20  ..**.** This is 
8060: 61 20 6e 6f 2d 6f 70 20 69 66 20 4e 44 45 42 55  a no-op if NDEBU
8070: 47 20 69 73 20 64 65 66 69 6e 65 64 2e 0a 2a 2f  G is defined..*/
8080: 0a 23 69 66 6e 64 65 66 20 4e 44 45 42 55 47 0a  .#ifndef NDEBUG.
8090: 73 74 61 74 69 63 20 76 6f 69 64 20 63 68 65 63  static void chec
80a0: 6b 41 63 74 69 76 65 56 64 62 65 43 6e 74 28 73  kActiveVdbeCnt(s
80b0: 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20 56  qlite3 *db){.  V
80c0: 64 62 65 20 2a 70 3b 0a 20 20 69 6e 74 20 63 6e  dbe *p;.  int cn
80d0: 74 20 3d 20 30 3b 0a 20 20 70 20 3d 20 64 62 2d  t = 0;.  p = db-
80e0: 3e 70 56 64 62 65 3b 0a 20 20 77 68 69 6c 65 28  >pVdbe;.  while(
80f0: 20 70 20 29 7b 0a 20 20 20 20 69 66 28 20 70 2d   p ){.    if( p-
8100: 3e 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47  >magic==VDBE_MAG
8110: 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 70 63 3e  IC_RUN && p->pc>
8120: 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6e 74 2b  =0 ){.      cnt+
8130: 2b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 20 3d  +;.    }.    p =
8140: 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a 20   p->pNext;.  }. 
8150: 20 61 73 73 65 72 74 28 20 63 6e 74 3d 3d 64 62   assert( cnt==db
8160: 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 20  ->activeVdbeCnt 
8170: 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 65 66 69  );.}.#else.#defi
8180: 6e 65 20 63 68 65 63 6b 41 63 74 69 76 65 56 64  ne checkActiveVd
8190: 62 65 43 6e 74 28 78 29 0a 23 65 6e 64 69 66 0a  beCnt(x).#endif.
81a0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  ./*.** This rout
81b0: 69 6e 65 20 69 73 20 63 61 6c 6c 65 64 20 74 68  ine is called th
81c0: 65 20 77 68 65 6e 20 61 20 56 44 42 45 20 74 72  e when a VDBE tr
81d0: 69 65 73 20 74 6f 20 68 61 6c 74 2e 20 20 49 66  ies to halt.  If
81e0: 20 74 68 65 20 56 44 42 45 0a 2a 2a 20 68 61 73   the VDBE.** has
81f0: 20 6d 61 64 65 20 63 68 61 6e 67 65 73 20 61 6e   made changes an
8200: 64 20 69 73 20 69 6e 20 61 75 74 6f 63 6f 6d 6d  d is in autocomm
8210: 69 74 20 6d 6f 64 65 2c 20 74 68 65 6e 20 63 6f  it mode, then co
8220: 6d 6d 69 74 20 74 68 6f 73 65 0a 2a 2a 20 63 68  mmit those.** ch
8230: 61 6e 67 65 73 2e 20 20 49 66 20 61 20 72 6f 6c  anges.  If a rol
8240: 6c 62 61 63 6b 20 69 73 20 6e 65 65 64 65 64 2c  lback is needed,
8250: 20 74 68 65 6e 20 64 6f 20 74 68 65 20 72 6f 6c   then do the rol
8260: 6c 62 61 63 6b 2e 0a 2a 2a 0a 2a 2a 20 54 68 69  lback..**.** Thi
8270: 73 20 72 6f 75 74 69 6e 65 20 69 73 20 74 68 65  s routine is the
8280: 20 6f 6e 6c 79 20 77 61 79 20 74 6f 20 6d 6f 76   only way to mov
8290: 65 20 74 68 65 20 73 74 61 74 65 20 6f 66 20 61  e the state of a
82a0: 20 56 4d 20 66 72 6f 6d 0a 2a 2a 20 53 51 4c 49   VM from.** SQLI
82b0: 54 45 5f 4d 41 47 49 43 5f 52 55 4e 20 74 6f 20  TE_MAGIC_RUN to 
82c0: 53 51 4c 49 54 45 5f 4d 41 47 49 43 5f 48 41 4c  SQLITE_MAGIC_HAL
82d0: 54 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20  T..**.** Return 
82e0: 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 20  an error code.  
82f0: 49 66 20 74 68 65 20 63 6f 6d 6d 69 74 20 63 6f  If the commit co
8300: 75 6c 64 20 6e 6f 74 20 63 6f 6d 70 6c 65 74 65  uld not complete
8310: 20 62 65 63 61 75 73 65 20 6f 66 0a 2a 2a 20 6c   because of.** l
8320: 6f 63 6b 20 63 6f 6e 74 65 6e 74 69 6f 6e 2c 20  ock contention, 
8330: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 42 55  return SQLITE_BU
8340: 53 59 2e 20 20 49 66 20 53 51 4c 49 54 45 5f 42  SY.  If SQLITE_B
8350: 55 53 59 20 69 73 20 72 65 74 75 72 6e 65 64 2c  USY is returned,
8360: 20 69 74 0a 2a 2a 20 6d 65 61 6e 73 20 74 68 65   it.** means the
8370: 20 63 6c 6f 73 65 20 64 69 64 20 6e 6f 74 20 68   close did not h
8380: 61 70 70 65 6e 20 61 6e 64 20 6e 65 65 64 73 20  appen and needs 
8390: 74 6f 20 62 65 20 72 65 70 65 61 74 65 64 2e 0a  to be repeated..
83a0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64  */.int sqlite3Vd
83b0: 62 65 48 61 6c 74 28 56 64 62 65 20 2a 70 29 7b  beHalt(Vdbe *p){
83c0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d  .  sqlite3 *db =
83d0: 20 70 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 3b   p->db;.  int i;
83e0: 0a 20 20 69 6e 74 20 28 2a 78 46 75 6e 63 29 28  .  int (*xFunc)(
83f0: 42 74 72 65 65 20 2a 70 42 74 29 20 3d 20 30 3b  Btree *pBt) = 0;
8400: 20 20 2f 2a 20 46 75 6e 63 74 69 6f 6e 20 74 6f    /* Function to
8410: 20 63 61 6c 6c 20 6f 6e 20 65 61 63 68 20 62 74   call on each bt
8420: 72 65 65 20 62 61 63 6b 65 6e 64 20 2a 2f 0a 20  ree backend */. 
8430: 20 69 6e 74 20 69 73 53 70 65 63 69 61 6c 45 72   int isSpecialEr
8440: 72 6f 72 3b 20 20 20 20 20 20 20 20 20 20 20 20  ror;            
8450: 2f 2a 20 53 65 74 20 74 6f 20 74 72 75 65 20 69  /* Set to true i
8460: 66 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 6f  f SQLITE_NOMEM o
8470: 72 20 49 4f 45 52 52 20 2a 2f 0a 0a 20 20 2f 2a  r IOERR */..  /*
8480: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63   This function c
8490: 6f 6e 74 61 69 6e 73 20 74 68 65 20 6c 6f 67 69  ontains the logi
84a0: 63 20 74 68 61 74 20 64 65 74 65 72 6d 69 6e 65  c that determine
84b0: 73 20 69 66 20 61 20 73 74 61 74 65 6d 65 6e 74  s if a statement
84c0: 20 6f 72 0a 20 20 2a 2a 20 74 72 61 6e 73 61 63   or.  ** transac
84d0: 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 63 6f 6d  tion will be com
84e0: 6d 69 74 74 65 64 20 6f 72 20 72 6f 6c 6c 65 64  mitted or rolled
84f0: 20 62 61 63 6b 20 61 73 20 61 20 72 65 73 75 6c   back as a resul
8500: 74 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 65 78  t of the.  ** ex
8510: 65 63 75 74 69 6f 6e 20 6f 66 20 74 68 69 73 20  ecution of this 
8520: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 2e  virtual machine.
8530: 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 53 70 65 63   .  **.  ** Spec
8540: 69 61 6c 20 65 72 72 6f 72 73 3a 0a 20 20 2a 2a  ial errors:.  **
8550: 0a 20 20 2a 2a 20 20 20 20 20 49 66 20 61 6e 20  .  **     If an 
8560: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 65 72 72  SQLITE_NOMEM err
8570: 6f 72 20 68 61 73 20 6f 63 63 75 72 65 64 20 69  or has occured i
8580: 6e 20 61 20 73 74 61 74 65 6d 65 6e 74 20 74 68  n a statement th
8590: 61 74 20 77 72 69 74 65 73 20 74 6f 0a 20 20 2a  at writes to.  *
85a0: 2a 20 20 20 20 20 74 68 65 20 64 61 74 61 62 61  *     the databa
85b0: 73 65 2c 20 74 68 65 6e 20 65 69 74 68 65 72 20  se, then either 
85c0: 61 20 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 74  a statement or t
85d0: 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20  ransaction must 
85e0: 62 65 20 72 6f 6c 6c 65 64 0a 20 20 2a 2a 20 20  be rolled.  **  
85f0: 20 20 20 62 61 63 6b 20 74 6f 20 65 6e 73 75 72     back to ensur
8600: 65 20 74 68 65 20 74 72 65 65 2d 73 74 72 75 63  e the tree-struc
8610: 74 75 72 65 73 20 61 72 65 20 69 6e 20 61 20 63  tures are in a c
8620: 6f 6e 73 69 73 74 65 6e 74 20 73 74 61 74 65 2e  onsistent state.
8630: 20 41 0a 20 20 2a 2a 20 20 20 20 20 73 74 61 74   A.  **     stat
8640: 65 6d 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f  ement transactio
8650: 6e 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b  n is rolled back
8660: 20 69 66 20 6f 6e 65 20 69 73 20 6f 70 65 6e 2c   if one is open,
8670: 20 6f 74 68 65 72 77 69 73 65 20 74 68 65 0a 20   otherwise the. 
8680: 20 2a 2a 20 20 20 20 20 65 6e 74 69 72 65 20 74   **     entire t
8690: 72 61 6e 73 61 63 74 69 6f 6e 20 6d 75 73 74 20  ransaction must 
86a0: 62 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 0a  be rolled back..
86b0: 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 20 49 66    **.  **     If
86c0: 20 61 6e 20 53 51 4c 49 54 45 5f 49 4f 45 52 52   an SQLITE_IOERR
86d0: 20 65 72 72 6f 72 20 68 61 73 20 6f 63 63 75 72   error has occur
86e0: 65 64 20 69 6e 20 61 20 73 74 61 74 65 6d 65 6e  ed in a statemen
86f0: 74 20 74 68 61 74 20 77 72 69 74 65 73 20 74 6f  t that writes to
8700: 0a 20 20 2a 2a 20 20 20 20 20 74 68 65 20 64 61  .  **     the da
8710: 74 61 62 61 73 65 2c 20 74 68 65 6e 20 74 68 65  tabase, then the
8720: 20 65 6e 74 69 72 65 20 74 72 61 6e 73 61 63 74   entire transact
8730: 69 6f 6e 20 6d 75 73 74 20 62 65 20 72 6f 6c 6c  ion must be roll
8740: 65 64 20 62 61 63 6b 2e 20 54 68 65 0a 20 20 2a  ed back. The.  *
8750: 2a 20 20 20 20 20 49 2f 4f 20 65 72 72 6f 72 20  *     I/O error 
8760: 6d 61 79 20 68 61 76 65 20 63 61 75 73 65 64 20  may have caused 
8770: 67 61 72 62 61 67 65 20 74 6f 20 62 65 20 77 72  garbage to be wr
8780: 69 74 74 65 6e 20 74 6f 20 74 68 65 20 6a 6f 75  itten to the jou
8790: 72 6e 61 6c 20 0a 20 20 2a 2a 20 20 20 20 20 66  rnal .  **     f
87a0: 69 6c 65 2e 20 57 65 72 65 20 74 68 65 20 74 72  ile. Were the tr
87b0: 61 6e 73 61 63 74 69 6f 6e 20 74 6f 20 63 6f 6e  ansaction to con
87c0: 74 69 6e 75 65 20 61 6e 64 20 65 76 65 6e 74 75  tinue and eventu
87d0: 61 6c 6c 79 20 62 65 20 72 6f 6c 6c 65 64 20 0a  ally be rolled .
87e0: 20 20 2a 2a 20 20 20 20 20 62 61 63 6b 20 74 68    **     back th
87f0: 61 74 20 67 61 72 62 61 67 65 20 6d 69 67 68 74  at garbage might
8800: 20 65 6e 64 20 75 70 20 69 6e 20 74 68 65 20 64   end up in the d
8810: 61 74 61 62 61 73 65 20 66 69 6c 65 2e 0a 20 20  atabase file..  
8820: 2a 2a 20 20 20 20 20 0a 20 20 2a 2a 20 20 20 20  **     .  **    
8830: 20 49 6e 20 62 6f 74 68 20 6f 66 20 74 68 65 20   In both of the 
8840: 61 62 6f 76 65 20 63 61 73 65 73 2c 20 74 68 65  above cases, the
8850: 20 56 64 62 65 2e 65 72 72 6f 72 41 63 74 69 6f   Vdbe.errorActio
8860: 6e 20 76 61 72 69 61 62 6c 65 20 69 73 20 0a 20  n variable is . 
8870: 20 2a 2a 20 20 20 20 20 69 67 6e 6f 72 65 64 2e   **     ignored.
8880: 20 49 66 20 74 68 65 20 73 71 6c 69 74 65 33 2e   If the sqlite3.
8890: 61 75 74 6f 43 6f 6d 6d 69 74 20 66 6c 61 67 20  autoCommit flag 
88a0: 69 73 20 66 61 6c 73 65 20 61 6e 64 20 61 20 74  is false and a t
88b0: 72 61 6e 73 61 63 74 69 6f 6e 0a 20 20 2a 2a 20  ransaction.  ** 
88c0: 20 20 20 20 69 73 20 72 6f 6c 6c 65 64 20 62 61      is rolled ba
88d0: 63 6b 2c 20 69 74 20 77 69 6c 6c 20 62 65 20 73  ck, it will be s
88e0: 65 74 20 74 6f 20 74 72 75 65 2e 0a 20 20 2a 2a  et to true..  **
88f0: 0a 20 20 2a 2a 20 4f 74 68 65 72 20 65 72 72 6f  .  ** Other erro
8900: 72 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 6f  rs:.  **.  ** No
8910: 20 65 72 72 6f 72 3a 0a 20 20 2a 2a 0a 20 20 2a   error:.  **.  *
8920: 2f 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  /..  if( sqlite3
8930: 4d 61 6c 6c 6f 63 46 61 69 6c 65 64 28 29 20 29  MallocFailed() )
8940: 7b 0a 20 20 20 20 70 2d 3e 72 63 20 3d 20 53 51  {.    p->rc = SQ
8950: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
8960: 20 20 69 66 28 20 70 2d 3e 6d 61 67 69 63 21 3d    if( p->magic!=
8970: 56 44 42 45 5f 4d 41 47 49 43 5f 52 55 4e 20 29  VDBE_MAGIC_RUN )
8980: 7b 0a 20 20 20 20 2f 2a 20 41 6c 72 65 61 64 79  {.    /* Already
8990: 20 68 61 6c 74 65 64 2e 20 20 4e 6f 74 68 69 6e   halted.  Nothin
89a0: 67 20 74 6f 20 64 6f 2e 20 2a 2f 0a 20 20 20 20  g to do. */.    
89b0: 61 73 73 65 72 74 28 20 70 2d 3e 6d 61 67 69 63  assert( p->magic
89c0: 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41 4c  ==VDBE_MAGIC_HAL
89d0: 54 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  T );.    return 
89e0: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20  SQLITE_OK;.  }. 
89f0: 20 63 6c 6f 73 65 41 6c 6c 43 75 72 73 6f 72 73   closeAllCursors
8a00: 28 70 29 3b 0a 20 20 63 68 65 63 6b 41 63 74 69  (p);.  checkActi
8a10: 76 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 0a  veVdbeCnt(db);..
8a20: 20 20 2f 2a 20 4e 6f 20 63 6f 6d 6d 69 74 20 6f    /* No commit o
8a30: 72 20 72 6f 6c 6c 62 61 63 6b 20 6e 65 65 64 65  r rollback neede
8a40: 64 20 69 66 20 74 68 65 20 70 72 6f 67 72 61 6d  d if the program
8a50: 20 6e 65 76 65 72 20 73 74 61 72 74 65 64 20 2a   never started *
8a60: 2f 0a 20 20 69 66 28 20 70 2d 3e 70 63 3e 3d 30  /.  if( p->pc>=0
8a70: 20 29 7b 0a 0a 20 20 20 20 2f 2a 20 43 68 65 63   ){..    /* Chec
8a80: 6b 20 66 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65  k for one of the
8a90: 20 73 70 65 63 69 61 6c 20 65 72 72 6f 72 73 20   special errors 
8aa0: 2d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 6f  - SQLITE_NOMEM o
8ab0: 72 20 53 51 4c 49 54 45 5f 49 4f 45 52 52 20 2a  r SQLITE_IOERR *
8ac0: 2f 0a 20 20 20 20 69 73 53 70 65 63 69 61 6c 45  /.    isSpecialE
8ad0: 72 72 6f 72 20 3d 20 28 28 70 2d 3e 72 63 3d 3d  rror = ((p->rc==
8ae0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20  SQLITE_NOMEM || 
8af0: 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f  p->rc==SQLITE_IO
8b00: 45 52 52 29 3f 31 3a 30 29 3b 0a 20 20 20 20 69  ERR)?1:0);.    i
8b10: 66 28 20 69 73 53 70 65 63 69 61 6c 45 72 72 6f  f( isSpecialErro
8b20: 72 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68  r ){.      /* Th
8b30: 69 73 20 6c 6f 6f 70 20 64 6f 65 73 20 73 74 61  is loop does sta
8b40: 74 69 63 20 61 6e 61 6c 79 73 69 73 20 6f 66 20  tic analysis of 
8b50: 74 68 65 20 71 75 65 72 79 20 74 6f 20 73 65 65  the query to see
8b60: 20 77 68 69 63 68 20 6f 66 20 74 68 65 0a 20 20   which of the.  
8b70: 20 20 20 20 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67      ** following
8b80: 20 74 68 72 65 65 20 63 61 74 65 67 6f 72 69 65   three categorie
8b90: 73 20 69 74 20 66 61 6c 6c 73 20 69 6e 74 6f 3a  s it falls into:
8ba0: 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20  .      **.      
8bb0: 2a 2a 20 20 20 20 20 52 65 61 64 2d 6f 6e 6c 79  **     Read-only
8bc0: 0a 20 20 20 20 20 20 2a 2a 20 20 20 20 20 51 75  .      **     Qu
8bd0: 65 72 79 20 77 69 74 68 20 73 74 61 74 65 6d 65  ery with stateme
8be0: 6e 74 20 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20  nt journal.     
8bf0: 20 2a 2a 20 20 20 20 20 51 75 65 72 79 20 77 69   **     Query wi
8c00: 74 68 6f 75 74 20 73 74 61 74 65 6d 65 6e 74 20  thout statement 
8c10: 6a 6f 75 72 6e 61 6c 0a 20 20 20 20 20 20 2a 2a  journal.      **
8c20: 0a 20 20 20 20 20 20 2a 2a 20 57 65 20 63 6f 75  .      ** We cou
8c30: 6c 64 20 64 6f 20 73 6f 6d 65 74 68 69 6e 67 20  ld do something 
8c40: 6d 6f 72 65 20 65 6c 65 67 61 6e 74 20 74 68 61  more elegant tha
8c50: 6e 20 74 68 69 73 20 73 74 61 74 69 63 20 61 6e  n this static an
8c60: 61 6c 79 73 69 73 20 28 69 2e 65 2e 0a 20 20 20  alysis (i.e..   
8c70: 20 20 20 2a 2a 20 73 74 6f 72 65 20 74 68 65 20     ** store the 
8c80: 74 79 70 65 20 6f 66 20 71 75 65 72 79 20 61 73  type of query as
8c90: 20 70 61 72 74 20 6f 66 20 74 68 65 20 63 6f 6d   part of the com
8ca0: 70 6c 69 61 74 69 6f 6e 20 70 68 61 73 65 29 2c  pliation phase),
8cb0: 20 62 75 74 20 0a 20 20 20 20 20 20 2a 2a 20 68   but .      ** h
8cc0: 61 6e 64 6c 69 6e 67 20 6d 61 6c 6c 6f 63 28 29  andling malloc()
8cd0: 20 6f 72 20 49 4f 20 66 61 69 6c 75 72 65 20 69   or IO failure i
8ce0: 73 20 61 20 66 61 69 72 6c 79 20 6f 62 73 63 75  s a fairly obscu
8cf0: 72 65 20 65 64 67 65 20 63 61 73 65 20 73 6f 20  re edge case so 
8d00: 0a 20 20 20 20 20 20 2a 2a 20 74 68 69 73 20 69  .      ** this i
8d10: 73 20 70 72 6f 62 61 62 6c 79 20 65 61 73 69 65  s probably easie
8d20: 72 2e 20 54 6f 64 6f 3a 20 4d 69 67 68 74 20 62  r. Todo: Might b
8d30: 65 20 61 6e 20 6f 70 70 6f 72 74 75 6e 69 74 79  e an opportunity
8d40: 20 74 6f 20 72 65 64 75 63 65 20 0a 20 20 20 20   to reduce .    
8d50: 20 20 2a 2a 20 63 6f 64 65 20 73 69 7a 65 20 61    ** code size a
8d60: 20 76 65 72 79 20 73 6d 61 6c 6c 20 61 6d 6f 75   very small amou
8d70: 6e 74 20 74 68 6f 75 67 68 2e 2e 2e 0a 20 20 20  nt though....   
8d80: 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20     */.      int 
8d90: 69 73 52 65 61 64 4f 6e 6c 79 20 3d 20 31 3b 0a  isReadOnly = 1;.
8da0: 20 20 20 20 20 20 69 6e 74 20 69 73 53 74 61 74        int isStat
8db0: 65 6d 65 6e 74 20 3d 20 30 3b 0a 20 20 20 20 20  ement = 0;.     
8dc0: 20 61 73 73 65 72 74 28 70 2d 3e 61 4f 70 20 7c   assert(p->aOp |
8dd0: 7c 20 70 2d 3e 6e 4f 70 3d 3d 30 29 3b 0a 20 20  | p->nOp==0);.  
8de0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
8df0: 2d 3e 6e 4f 70 3b 20 69 2b 2b 29 7b 20 0a 20 20  ->nOp; i++){ .  
8e00: 20 20 20 20 20 20 73 77 69 74 63 68 28 20 70 2d        switch( p-
8e10: 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64 65 20 29  >aOp[i].opcode )
8e20: 7b 0a 20 20 20 20 20 20 20 20 20 20 63 61 73 65  {.          case
8e30: 20 4f 50 5f 54 72 61 6e 73 61 63 74 69 6f 6e 3a   OP_Transaction:
8e40: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 73 52  .            isR
8e50: 65 61 64 4f 6e 6c 79 20 3d 20 30 3b 0a 20 20 20  eadOnly = 0;.   
8e60: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a           break;.
8e70: 20 20 20 20 20 20 20 20 20 20 63 61 73 65 20 4f            case O
8e80: 50 5f 53 74 61 74 65 6d 65 6e 74 3a 0a 20 20 20  P_Statement:.   
8e90: 20 20 20 20 20 20 20 20 20 69 73 53 74 61 74 65           isState
8ea0: 6d 65 6e 74 20 3d 20 31 3b 0a 20 20 20 20 20 20  ment = 1;.      
8eb0: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
8ec0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20       }.      }. 
8ed0: 20 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68   .      /* If th
8ee0: 65 20 71 75 65 72 79 20 77 61 73 20 72 65 61 64  e query was read
8ef0: 2d 6f 6e 6c 79 2c 20 77 65 20 6e 65 65 64 20 64  -only, we need d
8f00: 6f 20 6e 6f 20 72 6f 6c 6c 62 61 63 6b 20 61 74  o no rollback at
8f10: 20 61 6c 6c 2e 20 4f 74 68 65 72 77 69 73 65 2c   all. Otherwise,
8f20: 0a 20 20 20 20 20 20 2a 2a 20 70 72 6f 63 65 65  .      ** procee
8f30: 64 20 77 69 74 68 20 74 68 65 20 73 70 65 63 69  d with the speci
8f40: 61 6c 20 68 61 6e 64 6c 69 6e 67 2e 0a 20 20 20  al handling..   
8f50: 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20     */.      if( 
8f60: 21 69 73 52 65 61 64 4f 6e 6c 79 20 29 7b 0a 20  !isReadOnly ){. 
8f70: 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 72 63         if( p->rc
8f80: 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 26  ==SQLITE_NOMEM &
8f90: 26 20 69 73 53 74 61 74 65 6d 65 6e 74 20 29 7b  & isStatement ){
8fa0: 0a 20 20 20 20 20 20 20 20 20 20 78 46 75 6e 63  .          xFunc
8fb0: 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 52   = sqlite3BtreeR
8fc0: 6f 6c 6c 62 61 63 6b 53 74 6d 74 3b 0a 20 20 20  ollbackStmt;.   
8fd0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
8fe0: 20 20 20 20 20 20 2f 2a 20 57 65 20 61 72 65 20        /* We are 
8ff0: 66 6f 72 63 65 64 20 74 6f 20 72 6f 6c 6c 20 62  forced to roll b
9000: 61 63 6b 20 74 68 65 20 61 63 74 69 76 65 20 74  ack the active t
9010: 72 61 6e 73 61 63 74 69 6f 6e 2e 20 42 65 66 6f  ransaction. Befo
9020: 72 65 20 64 6f 69 6e 67 0a 20 20 20 20 20 20 20  re doing.       
9030: 20 20 20 2a 2a 20 73 6f 2c 20 61 62 6f 72 74 20     ** so, abort 
9040: 61 6e 79 20 6f 74 68 65 72 20 73 74 61 74 65 6d  any other statem
9050: 65 6e 74 73 20 74 68 69 73 20 68 61 6e 64 6c 65  ents this handle
9060: 20 63 75 72 72 65 6e 74 6c 79 20 68 61 73 20 61   currently has a
9070: 63 74 69 76 65 2e 0a 20 20 20 20 20 20 20 20 20  ctive..         
9080: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 61 62   */.          ab
9090: 6f 72 74 4f 74 68 65 72 41 63 74 69 76 65 56 64  ortOtherActiveVd
90a0: 62 65 73 28 70 29 3b 0a 20 20 20 20 20 20 20 20  bes(p);.        
90b0: 20 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63    sqlite3Rollbac
90c0: 6b 41 6c 6c 28 64 62 29 3b 0a 20 20 20 20 20 20  kAll(db);.      
90d0: 20 20 20 20 64 62 2d 3e 61 75 74 6f 43 6f 6d 6d      db->autoComm
90e0: 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20  it = 1;.        
90f0: 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  }.      }.    }.
9100: 20 20 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65    .    /* If the
9110: 20 61 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61   auto-commit fla
9120: 67 20 69 73 20 73 65 74 20 61 6e 64 20 74 68 69  g is set and thi
9130: 73 20 69 73 20 74 68 65 20 6f 6e 6c 79 20 61 63  s is the only ac
9140: 74 69 76 65 20 76 64 62 65 2c 20 74 68 65 6e 0a  tive vdbe, then.
9150: 20 20 20 20 2a 2a 20 77 65 20 64 6f 20 65 69 74      ** we do eit
9160: 68 65 72 20 61 20 63 6f 6d 6d 69 74 20 6f 72 20  her a commit or 
9170: 72 6f 6c 6c 62 61 63 6b 20 6f 66 20 74 68 65 20  rollback of the 
9180: 63 75 72 72 65 6e 74 20 74 72 61 6e 73 61 63 74  current transact
9190: 69 6f 6e 2e 20 0a 20 20 20 20 2a 2a 0a 20 20 20  ion. .    **.   
91a0: 20 2a 2a 20 4e 6f 74 65 3a 20 54 68 69 73 20 62   ** Note: This b
91b0: 6c 6f 63 6b 20 61 6c 73 6f 20 72 75 6e 73 20 69  lock also runs i
91c0: 66 20 6f 6e 65 20 6f 66 20 74 68 65 20 73 70 65  f one of the spe
91d0: 63 69 61 6c 20 65 72 72 6f 72 73 20 68 61 6e 64  cial errors hand
91e0: 6c 65 64 20 0a 20 20 20 20 2a 2a 20 61 62 6f 76  led .    ** abov
91f0: 65 20 68 61 73 20 6f 63 63 75 72 65 64 2e 20 0a  e has occured. .
9200: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 64      */.    if( d
9210: 62 2d 3e 61 75 74 6f 43 6f 6d 6d 69 74 20 26 26  b->autoCommit &&
9220: 20 64 62 2d 3e 61 63 74 69 76 65 56 64 62 65 43   db->activeVdbeC
9230: 6e 74 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 69  nt==1 ){.      i
9240: 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45  f( p->rc==SQLITE
9250: 5f 4f 4b 20 7c 7c 20 28 70 2d 3e 65 72 72 6f 72  _OK || (p->error
9260: 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69 6c 20  Action==OE_Fail 
9270: 26 26 20 21 69 73 53 70 65 63 69 61 6c 45 72 72  && !isSpecialErr
9280: 6f 72 29 20 29 7b 0a 09 2f 2a 20 54 68 65 20 61  or) ){../* The a
9290: 75 74 6f 2d 63 6f 6d 6d 69 74 20 66 6c 61 67 20  uto-commit flag 
92a0: 69 73 20 74 72 75 65 2c 20 61 6e 64 20 74 68 65  is true, and the
92b0: 20 76 64 62 65 20 70 72 6f 67 72 61 6d 20 77 61   vdbe program wa
92c0: 73 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 75  s .        ** su
92d0: 63 63 65 73 73 66 75 6c 20 6f 72 20 68 69 74 20  ccessful or hit 
92e0: 61 6e 20 27 4f 52 20 46 41 49 4c 27 20 63 6f 6e  an 'OR FAIL' con
92f0: 73 74 72 61 69 6e 74 2e 20 54 68 69 73 20 6d 65  straint. This me
9300: 61 6e 73 20 61 20 63 6f 6d 6d 69 74 20 0a 20 20  ans a commit .  
9310: 20 20 20 20 20 20 2a 2a 20 69 73 20 72 65 71 75        ** is requ
9320: 69 72 65 64 2e 0a 20 20 20 20 20 20 20 20 2a 2f  ired..        */
9330: 0a 20 20 20 20 20 20 20 20 69 6e 74 20 72 63 20  .        int rc 
9340: 3d 20 76 64 62 65 43 6f 6d 6d 69 74 28 64 62 29  = vdbeCommit(db)
9350: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63  ;.        if( rc
9360: 3d 3d 53 51 4c 49 54 45 5f 42 55 53 59 20 29 7b  ==SQLITE_BUSY ){
9370: 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72  .          retur
9380: 6e 20 53 51 4c 49 54 45 5f 42 55 53 59 3b 0a 20  n SQLITE_BUSY;. 
9390: 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28         }else if(
93a0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
93b0: 7b 0a 20 20 20 20 20 20 20 20 20 20 70 2d 3e 72  {.          p->r
93c0: 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20 20 20  c = rc;.        
93d0: 20 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62 61 63    sqlite3Rollbac
93e0: 6b 41 6c 6c 28 64 62 29 3b 0a 20 20 20 20 20 20  kAll(db);.      
93f0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
9400: 20 20 20 73 71 6c 69 74 65 33 43 6f 6d 6d 69 74     sqlite3Commit
9410: 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28  InternalChanges(
9420: 64 62 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  db);.        }. 
9430: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
9440: 20 20 20 20 73 71 6c 69 74 65 33 52 6f 6c 6c 62      sqlite3Rollb
9450: 61 63 6b 41 6c 6c 28 64 62 29 3b 0a 20 20 20 20  ackAll(db);.    
9460: 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 69 66    }.    }else if
9470: 28 20 21 78 46 75 6e 63 20 29 7b 0a 20 20 20 20  ( !xFunc ){.    
9480: 20 20 69 66 28 20 70 2d 3e 72 63 3d 3d 53 51 4c    if( p->rc==SQL
9490: 49 54 45 5f 4f 4b 20 7c 7c 20 70 2d 3e 65 72 72  ITE_OK || p->err
94a0: 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f 46 61 69  orAction==OE_Fai
94b0: 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 78 46 75  l ){.        xFu
94c0: 6e 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  nc = sqlite3Btre
94d0: 65 43 6f 6d 6d 69 74 53 74 6d 74 3b 0a 20 20 20  eCommitStmt;.   
94e0: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 2d 3e     }else if( p->
94f0: 65 72 72 6f 72 41 63 74 69 6f 6e 3d 3d 4f 45 5f  errorAction==OE_
9500: 41 62 6f 72 74 20 29 7b 0a 20 20 20 20 20 20 20  Abort ){.       
9510: 20 78 46 75 6e 63 20 3d 20 73 71 6c 69 74 65 33   xFunc = sqlite3
9520: 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b 53 74 6d  BtreeRollbackStm
9530: 74 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a  t;.      }else{.
9540: 20 20 20 20 20 20 20 20 61 62 6f 72 74 4f 74 68          abortOth
9550: 65 72 41 63 74 69 76 65 56 64 62 65 73 28 70 29  erActiveVdbes(p)
9560: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
9570: 33 52 6f 6c 6c 62 61 63 6b 41 6c 6c 28 64 62 29  3RollbackAll(db)
9580: 3b 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61 75  ;.        db->au
9590: 74 6f 43 6f 6d 6d 69 74 20 3d 20 31 3b 0a 20 20  toCommit = 1;.  
95a0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 0a 20      }.    }.  . 
95b0: 20 20 20 2f 2a 20 49 66 20 78 46 75 6e 63 20 69     /* If xFunc i
95c0: 73 20 6e 6f 74 20 4e 55 4c 4c 2c 20 74 68 65 6e  s not NULL, then
95d0: 20 69 74 20 69 73 20 6f 6e 65 20 6f 66 20 73 71   it is one of sq
95e0: 6c 69 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61  lite3BtreeRollba
95f0: 63 6b 53 74 6d 74 20 6f 72 0a 20 20 20 20 2a 2a  ckStmt or.    **
9600: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d   sqlite3BtreeCom
9610: 6d 69 74 53 74 6d 74 2e 20 43 61 6c 6c 20 69 74  mitStmt. Call it
9620: 20 6f 6e 63 65 20 6f 6e 20 65 61 63 68 20 62 61   once on each ba
9630: 63 6b 65 6e 64 2e 20 49 66 20 61 6e 20 65 72 72  ckend. If an err
9640: 6f 72 20 6f 63 63 75 72 73 0a 20 20 20 20 2a 2a  or occurs.    **
9650: 20 61 6e 64 20 74 68 65 20 72 65 74 75 72 6e 20   and the return 
9660: 63 6f 64 65 20 69 73 20 73 74 69 6c 6c 20 53 51  code is still SQ
9670: 4c 49 54 45 5f 4f 4b 2c 20 73 65 74 20 74 68 65  LITE_OK, set the
9680: 20 72 65 74 75 72 6e 20 63 6f 64 65 20 74 6f 20   return code to 
9690: 74 68 65 20 6e 65 77 0a 20 20 20 20 2a 2a 20 65  the new.    ** e
96a0: 72 72 6f 72 20 76 61 6c 75 65 2e 0a 20 20 20 20  rror value..    
96b0: 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 21 78  */.    assert(!x
96c0: 46 75 6e 63 20 7c 7c 0a 20 20 20 20 20 20 78 46  Func ||.      xF
96d0: 75 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74 72 65  unc==sqlite3Btre
96e0: 65 43 6f 6d 6d 69 74 53 74 6d 74 20 7c 7c 0a 20  eCommitStmt ||. 
96f0: 20 20 20 20 20 78 46 75 6e 63 3d 3d 73 71 6c 69       xFunc==sqli
9700: 74 65 33 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b  te3BtreeRollback
9710: 53 74 6d 74 0a 20 20 20 20 29 3b 0a 20 20 20 20  Stmt.    );.    
9720: 66 6f 72 28 69 3d 30 3b 20 78 46 75 6e 63 20 26  for(i=0; xFunc &
9730: 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b  & i<db->nDb; i++
9740: 29 7b 20 0a 20 20 20 20 20 20 69 6e 74 20 72 63  ){ .      int rc
9750: 3b 0a 20 20 20 20 20 20 42 74 72 65 65 20 2a 70  ;.      Btree *p
9760: 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e  Bt = db->aDb[i].
9770: 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70  pBt;.      if( p
9780: 42 74 20 29 7b 0a 20 20 20 20 20 20 20 20 72 63  Bt ){.        rc
9790: 20 3d 20 78 46 75 6e 63 28 70 42 74 29 3b 0a 20   = xFunc(pBt);. 
97a0: 20 20 20 20 20 20 20 69 66 28 20 70 2d 3e 72 63         if( p->rc
97b0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 70 2d  ==SQLITE_OK ) p-
97c0: 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20  >rc = rc;.      
97d0: 7d 0a 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 2f  }.    }.  .    /
97e0: 2a 20 49 66 20 74 68 69 73 20 77 61 73 20 61 6e  * If this was an
97f0: 20 49 4e 53 45 52 54 2c 20 55 50 44 41 54 45 20   INSERT, UPDATE 
9800: 6f 72 20 44 45 4c 45 54 45 20 61 6e 64 20 74 68  or DELETE and th
9810: 65 20 73 74 61 74 65 6d 65 6e 74 20 77 61 73 20  e statement was 
9820: 63 6f 6d 6d 69 74 74 65 64 2c 20 0a 20 20 20 20  committed, .    
9830: 2a 2a 20 73 65 74 20 74 68 65 20 63 68 61 6e 67  ** set the chang
9840: 65 20 63 6f 75 6e 74 65 72 2e 20 0a 20 20 20 20  e counter. .    
9850: 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d 3e 63 68  */.    if( p->ch
9860: 61 6e 67 65 43 6e 74 4f 6e 20 26 26 20 70 2d 3e  angeCntOn && p->
9870: 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 69  pc>=0 ){.      i
9880: 66 28 20 21 78 46 75 6e 63 20 7c 7c 20 78 46 75  f( !xFunc || xFu
9890: 6e 63 3d 3d 73 71 6c 69 74 65 33 42 74 72 65 65  nc==sqlite3Btree
98a0: 43 6f 6d 6d 69 74 53 74 6d 74 20 29 7b 0a 20 20  CommitStmt ){.  
98b0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
98c0: 65 53 65 74 43 68 61 6e 67 65 73 28 64 62 2c 20  eSetChanges(db, 
98d0: 70 2d 3e 6e 43 68 61 6e 67 65 29 3b 0a 20 20 20  p->nChange);.   
98e0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
98f0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74    sqlite3VdbeSet
9900: 43 68 61 6e 67 65 73 28 64 62 2c 20 30 29 3b 0a  Changes(db, 0);.
9910: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 2d        }.      p-
9920: 3e 6e 43 68 61 6e 67 65 20 3d 20 30 3b 0a 20 20  >nChange = 0;.  
9930: 20 20 7d 0a 20 20 0a 20 20 20 20 2f 2a 20 52 6f    }.  .    /* Ro
9940: 6c 6c 62 61 63 6b 20 6f 72 20 63 6f 6d 6d 69 74  llback or commit
9950: 20 61 6e 79 20 73 63 68 65 6d 61 20 63 68 61 6e   any schema chan
9960: 67 65 73 20 74 68 61 74 20 6f 63 63 75 72 72 65  ges that occurre
9970: 64 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 2d  d. */.    if( p-
9980: 3e 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 26  >rc!=SQLITE_OK &
9990: 26 20 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49  & db->flags&SQLI
99a0: 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73  TE_InternChanges
99b0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
99c0: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
99d0: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 20  hema(db, 0);.   
99e0: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 3d 20 28     db->flags = (
99f0: 64 62 2d 3e 66 6c 61 67 73 20 7c 20 53 51 4c 49  db->flags | SQLI
9a00: 54 45 5f 49 6e 74 65 72 6e 43 68 61 6e 67 65 73  TE_InternChanges
9a10: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20  );.    }.  }..  
9a20: 2f 2a 20 57 65 20 68 61 76 65 20 73 75 63 63 65  /* We have succe
9a30: 73 73 66 75 6c 6c 79 20 68 61 6c 74 65 64 20 61  ssfully halted a
9a40: 6e 64 20 63 6c 6f 73 65 64 20 74 68 65 20 56 4d  nd closed the VM
9a50: 2e 20 20 52 65 63 6f 72 64 20 74 68 69 73 20 66  .  Record this f
9a60: 61 63 74 2e 20 2a 2f 0a 20 20 69 66 28 20 70 2d  act. */.  if( p-
9a70: 3e 70 63 3e 3d 30 20 29 7b 0a 20 20 20 20 64 62  >pc>=0 ){.    db
9a80: 2d 3e 61 63 74 69 76 65 56 64 62 65 43 6e 74 2d  ->activeVdbeCnt-
9a90: 2d 3b 0a 20 20 7d 0a 20 20 70 2d 3e 6d 61 67 69  -;.  }.  p->magi
9aa0: 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f 48  c = VDBE_MAGIC_H
9ab0: 41 4c 54 3b 0a 20 20 63 68 65 63 6b 41 63 74 69  ALT;.  checkActi
9ac0: 76 65 56 64 62 65 43 6e 74 28 64 62 29 3b 0a 0a  veVdbeCnt(db);..
9ad0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
9ae0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c 65  OK;.}../*.** Cle
9af0: 61 6e 20 75 70 20 61 20 56 44 42 45 20 61 66 74  an up a VDBE aft
9b00: 65 72 20 65 78 65 63 75 74 69 6f 6e 20 62 75 74  er execution but
9b10: 20 64 6f 20 6e 6f 74 20 64 65 6c 65 74 65 20 74   do not delete t
9b20: 68 65 20 56 44 42 45 20 6a 75 73 74 20 79 65 74  he VDBE just yet
9b30: 2e 0a 2a 2a 20 57 72 69 74 65 20 61 6e 79 20 65  ..** Write any e
9b40: 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 69 6e  rror messages in
9b50: 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 20 20 52  to *pzErrMsg.  R
9b60: 65 74 75 72 6e 20 74 68 65 20 72 65 73 75 6c 74  eturn the result
9b70: 20 63 6f 64 65 2e 0a 2a 2a 0a 2a 2a 20 41 66 74   code..**.** Aft
9b80: 65 72 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20  er this routine 
9b90: 69 73 20 72 75 6e 2c 20 74 68 65 20 56 44 42 45  is run, the VDBE
9ba0: 20 73 68 6f 75 6c 64 20 62 65 20 72 65 61 64 79   should be ready
9bb0: 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 64 0a   to be executed.
9bc0: 2a 2a 20 61 67 61 69 6e 2e 0a 2a 2a 0a 2a 2a 20  ** again..**.** 
9bd0: 54 6f 20 6c 6f 6f 6b 20 61 74 20 69 74 20 61 6e  To look at it an
9be0: 6f 74 68 65 72 20 77 61 79 2c 20 74 68 69 73 20  other way, this 
9bf0: 72 6f 75 74 69 6e 65 20 72 65 73 65 74 73 20 74  routine resets t
9c00: 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 0a  he state of the.
9c10: 2a 2a 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  ** virtual machi
9c20: 6e 65 20 66 72 6f 6d 20 56 44 42 45 5f 4d 41 47  ne from VDBE_MAG
9c30: 49 43 5f 52 55 4e 20 6f 72 20 56 44 42 45 5f 4d  IC_RUN or VDBE_M
9c40: 41 47 49 43 5f 48 41 4c 54 20 62 61 63 6b 20 74  AGIC_HALT back t
9c50: 6f 0a 2a 2a 20 56 44 42 45 5f 4d 41 47 49 43 5f  o.** VDBE_MAGIC_
9c60: 49 4e 49 54 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  INIT..*/.int sql
9c70: 69 74 65 33 56 64 62 65 52 65 73 65 74 28 56 64  ite3VdbeReset(Vd
9c80: 62 65 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 2d  be *p){.  if( p-
9c90: 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d 41 47  >magic!=VDBE_MAG
9ca0: 49 43 5f 52 55 4e 20 26 26 20 70 2d 3e 6d 61 67  IC_RUN && p->mag
9cb0: 69 63 21 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48  ic!=VDBE_MAGIC_H
9cc0: 41 4c 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ALT ){.    sqlit
9cd0: 65 33 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 53  e3Error(p->db, S
9ce0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 2c 20 30 29  QLITE_MISUSE, 0)
9cf0: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  ;.    return SQL
9d00: 49 54 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a  ITE_MISUSE;.  }.
9d10: 0a 20 20 2f 2a 20 49 66 20 74 68 65 20 56 4d 20  .  /* If the VM 
9d20: 64 69 64 20 6e 6f 74 20 72 75 6e 20 74 6f 20 63  did not run to c
9d30: 6f 6d 70 6c 65 74 69 6f 6e 20 6f 72 20 69 66 20  ompletion or if 
9d40: 69 74 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61  it encountered a
9d50: 6e 0a 20 20 2a 2a 20 65 72 72 6f 72 2c 20 74 68  n.  ** error, th
9d60: 65 6e 20 69 74 20 6d 69 67 68 74 20 6e 6f 74 20  en it might not 
9d70: 68 61 76 65 20 62 65 65 6e 20 68 61 6c 74 65 64  have been halted
9d80: 20 70 72 6f 70 65 72 6c 79 2e 20 20 53 6f 20 68   properly.  So h
9d90: 61 6c 74 0a 20 20 2a 2a 20 69 74 20 6e 6f 77 2e  alt.  ** it now.
9da0: 0a 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56  .  */.  sqlite3V
9db0: 64 62 65 48 61 6c 74 28 70 29 3b 0a 0a 20 20 2f  dbeHalt(p);..  /
9dc0: 2a 20 49 66 20 74 68 65 20 56 44 42 45 20 68 61  * If the VDBE ha
9dd0: 73 20 62 65 20 72 75 6e 20 65 76 65 6e 20 70 61  s be run even pa
9de0: 72 74 69 61 6c 6c 79 2c 20 74 68 65 6e 20 74 72  rtially, then tr
9df0: 61 6e 73 66 65 72 20 74 68 65 20 65 72 72 6f 72  ansfer the error
9e00: 20 63 6f 64 65 0a 20 20 2a 2a 20 61 6e 64 20 65   code.  ** and e
9e10: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 66 72 6f  rror message fro
9e20: 6d 20 74 68 65 20 56 44 42 45 20 69 6e 74 6f 20  m the VDBE into 
9e30: 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73  the main databas
9e40: 65 20 73 74 72 75 63 74 75 72 65 2e 20 20 42 75  e structure.  Bu
9e50: 74 0a 20 20 2a 2a 20 69 66 20 74 68 65 20 56 44  t.  ** if the VD
9e60: 42 45 20 68 61 73 20 6a 75 73 74 20 62 65 65 6e  BE has just been
9e70: 20 73 65 74 20 74 6f 20 72 75 6e 20 62 75 74 20   set to run but 
9e80: 68 61 73 20 6e 6f 74 20 61 63 74 75 61 6c 6c 79  has not actually
9e90: 20 65 78 65 63 75 74 65 64 20 61 6e 79 0a 20 20   executed any.  
9ea0: 2a 2a 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20  ** instructions 
9eb0: 79 65 74 2c 20 6c 65 61 76 65 20 74 68 65 20 6d  yet, leave the m
9ec0: 61 69 6e 20 64 61 74 61 62 61 73 65 20 65 72 72  ain database err
9ed0: 6f 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 75  or information u
9ee0: 6e 63 68 61 6e 67 65 64 2e 0a 20 20 2a 2f 0a 20  nchanged..  */. 
9ef0: 20 69 66 28 20 70 2d 3e 70 63 3e 3d 30 20 29 7b   if( p->pc>=0 ){
9f00: 0a 20 20 20 20 69 66 28 20 70 2d 3e 7a 45 72 72  .    if( p->zErr
9f10: 4d 73 67 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  Msg ){.      sql
9f20: 69 74 65 33 2a 20 64 62 20 3d 20 70 2d 3e 64 62  ite3* db = p->db
9f30: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
9f40: 61 6c 75 65 53 65 74 53 74 72 28 64 62 2d 3e 70  alueSetStr(db->p
9f50: 45 72 72 2c 20 2d 31 2c 20 70 2d 3e 7a 45 72 72  Err, -1, p->zErr
9f60: 4d 73 67 2c 20 53 51 4c 49 54 45 5f 55 54 46 38  Msg, SQLITE_UTF8
9f70: 2c 20 73 71 6c 69 74 65 33 46 72 65 65 58 29 3b  , sqlite3FreeX);
9f80: 0a 20 20 20 20 20 20 64 62 2d 3e 65 72 72 43 6f  .      db->errCo
9f90: 64 65 20 3d 20 70 2d 3e 72 63 3b 0a 20 20 20 20  de = p->rc;.    
9fa0: 20 20 70 2d 3e 7a 45 72 72 4d 73 67 20 3d 20 30    p->zErrMsg = 0
9fb0: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20  ;.    }else if( 
9fc0: 70 2d 3e 72 63 20 29 7b 0a 20 20 20 20 20 20 73  p->rc ){.      s
9fd0: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64  qlite3Error(p->d
9fe0: 62 2c 20 70 2d 3e 72 63 2c 20 30 29 3b 0a 20 20  b, p->rc, 0);.  
9ff0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73    }else{.      s
a000: 71 6c 69 74 65 33 45 72 72 6f 72 28 70 2d 3e 64  qlite3Error(p->d
a010: 62 2c 20 53 51 4c 49 54 45 5f 4f 4b 2c 20 30 29  b, SQLITE_OK, 0)
a020: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20  ;.    }.  }else 
a030: 69 66 28 20 70 2d 3e 72 63 20 26 26 20 70 2d 3e  if( p->rc && p->
a040: 65 78 70 69 72 65 64 20 29 7b 0a 20 20 20 20 2f  expired ){.    /
a050: 2a 20 54 68 65 20 65 78 70 69 72 65 64 20 66 6c  * The expired fl
a060: 61 67 20 77 61 73 20 73 65 74 20 6f 6e 20 74 68  ag was set on th
a070: 65 20 56 44 42 45 20 62 65 66 6f 72 65 20 74 68  e VDBE before th
a080: 65 20 66 69 72 73 74 20 63 61 6c 6c 0a 20 20 20  e first call.   
a090: 20 2a 2a 20 74 6f 20 73 71 6c 69 74 65 33 5f 73   ** to sqlite3_s
a0a0: 74 65 70 28 29 2e 20 46 6f 72 20 63 6f 6e 73 69  tep(). For consi
a0b0: 73 74 65 6e 63 79 20 28 73 69 6e 63 65 20 73 71  stency (since sq
a0c0: 6c 69 74 65 33 5f 73 74 65 70 28 29 20 77 61 73  lite3_step() was
a0d0: 0a 20 20 20 20 2a 2a 20 63 61 6c 6c 65 64 29 2c  .    ** called),
a0e0: 20 73 65 74 20 74 68 65 20 64 61 74 61 62 61 73   set the databas
a0f0: 65 20 65 72 72 6f 72 20 69 6e 20 74 68 69 73 20  e error in this 
a100: 63 61 73 65 20 61 73 20 77 65 6c 6c 2e 0a 20 20  case as well..  
a110: 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33    */.    sqlite3
a120: 45 72 72 6f 72 28 70 2d 3e 64 62 2c 20 70 2d 3e  Error(p->db, p->
a130: 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f  rc, 0);.  }..  /
a140: 2a 20 52 65 63 6c 61 69 6d 20 61 6c 6c 20 6d 65  * Reclaim all me
a150: 6d 6f 72 79 20 75 73 65 64 20 62 79 20 74 68 65  mory used by the
a160: 20 56 44 42 45 0a 20 20 2a 2f 0a 20 20 43 6c 65   VDBE.  */.  Cle
a170: 61 6e 75 70 28 70 29 3b 0a 0a 20 20 2f 2a 20 53  anup(p);..  /* S
a180: 61 76 65 20 70 72 6f 66 69 6c 69 6e 67 20 69 6e  ave profiling in
a190: 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d 20 74  formation from t
a1a0: 68 69 73 20 56 44 42 45 20 72 75 6e 2e 0a 20 20  his VDBE run..  
a1b0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 2d 3e  */.  assert( p->
a1c0: 70 54 6f 73 3c 26 70 2d 3e 61 53 74 61 63 6b 5b  pTos<&p->aStack[
a1d0: 70 2d 3e 70 63 3c 30 3f 30 3a 70 2d 3e 70 63 5d  p->pc<0?0:p->pc]
a1e0: 20 7c 7c 20 21 70 2d 3e 61 53 74 61 63 6b 20 29   || !p->aStack )
a1f0: 3b 0a 23 69 66 64 65 66 20 56 44 42 45 5f 50 52  ;.#ifdef VDBE_PR
a200: 4f 46 49 4c 45 0a 20 20 7b 0a 20 20 20 20 46 49  OFILE.  {.    FI
a210: 4c 45 20 2a 6f 75 74 20 3d 20 66 6f 70 65 6e 28  LE *out = fopen(
a220: 22 76 64 62 65 5f 70 72 6f 66 69 6c 65 2e 6f 75  "vdbe_profile.ou
a230: 74 22 2c 20 22 61 22 29 3b 0a 20 20 20 20 69 66  t", "a");.    if
a240: 28 20 6f 75 74 20 29 7b 0a 20 20 20 20 20 20 69  ( out ){.      i
a250: 6e 74 20 69 3b 0a 20 20 20 20 20 20 66 70 72 69  nt i;.      fpri
a260: 6e 74 66 28 6f 75 74 2c 20 22 2d 2d 2d 2d 20 22  ntf(out, "---- "
a270: 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30  );.      for(i=0
a280: 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b 29  ; i<p->nOp; i++)
a290: 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e 74  {.        fprint
a2a0: 66 28 6f 75 74 2c 20 22 25 30 32 78 22 2c 20 70  f(out, "%02x", p
a2b0: 2d 3e 61 4f 70 5b 69 5d 2e 6f 70 63 6f 64 65 29  ->aOp[i].opcode)
a2c0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
a2d0: 66 70 72 69 6e 74 66 28 6f 75 74 2c 20 22 5c 6e  fprintf(out, "\n
a2e0: 22 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d  ");.      for(i=
a2f0: 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b  0; i<p->nOp; i++
a300: 29 7b 0a 20 20 20 20 20 20 20 20 66 70 72 69 6e  ){.        fprin
a310: 74 66 28 6f 75 74 2c 20 22 25 36 64 20 25 31 30  tf(out, "%6d %10
a320: 6c 6c 64 20 25 38 6c 6c 64 20 22 2c 0a 20 20 20  lld %8lld ",.   
a330: 20 20 20 20 20 20 20 20 70 2d 3e 61 4f 70 5b 69          p->aOp[i
a340: 5d 2e 63 6e 74 2c 0a 20 20 20 20 20 20 20 20 20  ].cnt,.         
a350: 20 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c    p->aOp[i].cycl
a360: 65 73 2c 0a 20 20 20 20 20 20 20 20 20 20 20 70  es,.           p
a370: 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 3e 30 20 3f  ->aOp[i].cnt>0 ?
a380: 20 70 2d 3e 61 4f 70 5b 69 5d 2e 63 79 63 6c 65   p->aOp[i].cycle
a390: 73 2f 70 2d 3e 61 4f 70 5b 69 5d 2e 63 6e 74 20  s/p->aOp[i].cnt 
a3a0: 3a 20 30 0a 20 20 20 20 20 20 20 20 29 3b 0a 20  : 0.        );. 
a3b0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64         sqlite3Vd
a3c0: 62 65 50 72 69 6e 74 4f 70 28 6f 75 74 2c 20 69  bePrintOp(out, i
a3d0: 2c 20 26 70 2d 3e 61 4f 70 5b 69 5d 29 3b 0a 20  , &p->aOp[i]);. 
a3e0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 66 63 6c       }.      fcl
a3f0: 6f 73 65 28 6f 75 74 29 3b 0a 20 20 20 20 7d 0a  ose(out);.    }.
a400: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 70 2d 3e    }.#endif.  p->
a410: 6d 61 67 69 63 20 3d 20 56 44 42 45 5f 4d 41 47  magic = VDBE_MAG
a420: 49 43 5f 49 4e 49 54 3b 0a 20 20 70 2d 3e 61 62  IC_INIT;.  p->ab
a430: 6f 72 74 65 64 20 3d 20 30 3b 0a 20 20 69 66 28  orted = 0;.  if(
a440: 20 70 2d 3e 72 63 3d 3d 53 51 4c 49 54 45 5f 53   p->rc==SQLITE_S
a450: 43 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c  CHEMA ){.    sql
a460: 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61  ite3ResetInterna
a470: 6c 53 63 68 65 6d 61 28 70 2d 3e 64 62 2c 20 30  lSchema(p->db, 0
a480: 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20  );.  }.  return 
a490: 70 2d 3e 72 63 3b 0a 7d 0a 20 0a 2f 2a 0a 2a 2a  p->rc;.}. ./*.**
a4a0: 20 43 6c 65 61 6e 20 75 70 20 61 6e 64 20 64 65   Clean up and de
a4b0: 6c 65 74 65 20 61 20 56 44 42 45 20 61 66 74 65  lete a VDBE afte
a4c0: 72 20 65 78 65 63 75 74 69 6f 6e 2e 20 20 52 65  r execution.  Re
a4d0: 74 75 72 6e 20 61 6e 20 69 6e 74 65 67 65 72 20  turn an integer 
a4e0: 77 68 69 63 68 20 69 73 0a 2a 2a 20 74 68 65 20  which is.** the 
a4f0: 72 65 73 75 6c 74 20 63 6f 64 65 2e 20 20 57 72  result code.  Wr
a500: 69 74 65 20 61 6e 79 20 65 72 72 6f 72 20 6d 65  ite any error me
a510: 73 73 61 67 65 20 74 65 78 74 20 69 6e 74 6f 20  ssage text into 
a520: 2a 70 7a 45 72 72 4d 73 67 2e 0a 2a 2f 0a 69 6e  *pzErrMsg..*/.in
a530: 74 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e  t sqlite3VdbeFin
a540: 61 6c 69 7a 65 28 56 64 62 65 20 2a 70 29 7b 0a  alize(Vdbe *p){.
a550: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
a560: 45 5f 4f 4b 3b 0a 0a 20 20 69 66 28 20 70 2d 3e  E_OK;..  if( p->
a570: 6d 61 67 69 63 3d 3d 56 44 42 45 5f 4d 41 47 49  magic==VDBE_MAGI
a580: 43 5f 52 55 4e 20 7c 7c 20 70 2d 3e 6d 61 67 69  C_RUN || p->magi
a590: 63 3d 3d 56 44 42 45 5f 4d 41 47 49 43 5f 48 41  c==VDBE_MAGIC_HA
a5a0: 4c 54 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73  LT ){.    rc = s
a5b0: 71 6c 69 74 65 33 56 64 62 65 52 65 73 65 74 28  qlite3VdbeReset(
a5c0: 70 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  p);.  }else if( 
a5d0: 70 2d 3e 6d 61 67 69 63 21 3d 56 44 42 45 5f 4d  p->magic!=VDBE_M
a5e0: 41 47 49 43 5f 49 4e 49 54 20 29 7b 0a 20 20 20  AGIC_INIT ){.   
a5f0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
a600: 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 73 71 6c  ISUSE;.  }.  sql
a610: 69 74 65 33 56 64 62 65 44 65 6c 65 74 65 28 70  ite3VdbeDelete(p
a620: 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  );.  return rc;.
a630: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 74 68  }../*.** Call th
a640: 65 20 64 65 73 74 72 75 63 74 6f 72 20 66 6f 72  e destructor for
a650: 20 65 61 63 68 20 61 75 78 64 61 74 61 20 65 6e   each auxdata en
a660: 74 72 79 20 69 6e 20 70 56 64 62 65 46 75 6e 63  try in pVdbeFunc
a670: 20 66 6f 72 20 77 68 69 63 68 0a 2a 2a 20 74 68   for which.** th
a680: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
a690: 62 69 74 20 69 6e 20 6d 61 73 6b 20 69 73 20 63  bit in mask is c
a6a0: 6c 65 61 72 2e 20 20 41 75 78 64 61 74 61 20 65  lear.  Auxdata e
a6b0: 6e 74 72 69 65 73 20 62 65 79 6f 6e 64 20 33 31  ntries beyond 31
a6c0: 0a 2a 2a 20 61 72 65 20 61 6c 77 61 79 73 20 64  .** are always d
a6d0: 65 73 74 72 6f 79 65 64 2e 20 20 54 6f 20 64 65  estroyed.  To de
a6e0: 73 74 72 6f 79 20 61 6c 6c 20 61 75 78 64 61 74  stroy all auxdat
a6f0: 61 20 65 6e 74 72 69 65 73 2c 20 63 61 6c 6c 20  a entries, call 
a700: 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20  this.** routine 
a710: 77 69 74 68 20 6d 61 73 6b 3d 3d 30 2e 0a 2a 2f  with mask==0..*/
a720: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 56 64 62  .void sqlite3Vdb
a730: 65 44 65 6c 65 74 65 41 75 78 44 61 74 61 28 56  eDeleteAuxData(V
a740: 64 62 65 46 75 6e 63 20 2a 70 56 64 62 65 46 75  dbeFunc *pVdbeFu
a750: 6e 63 2c 20 69 6e 74 20 6d 61 73 6b 29 7b 0a 20  nc, int mask){. 
a760: 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d   int i;.  for(i=
a770: 30 3b 20 69 3c 70 56 64 62 65 46 75 6e 63 2d 3e  0; i<pVdbeFunc->
a780: 6e 41 75 78 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nAux; i++){.    
a790: 73 74 72 75 63 74 20 41 75 78 44 61 74 61 20 2a  struct AuxData *
a7a0: 70 41 75 78 20 3d 20 26 70 56 64 62 65 46 75 6e  pAux = &pVdbeFun
a7b0: 63 2d 3e 61 70 41 75 78 5b 69 5d 3b 0a 20 20 20  c->apAux[i];.   
a7c0: 20 69 66 28 20 28 69 3e 33 31 20 7c 7c 20 21 28   if( (i>31 || !(
a7d0: 6d 61 73 6b 26 28 31 3c 3c 69 29 29 29 20 26 26  mask&(1<<i))) &&
a7e0: 20 70 41 75 78 2d 3e 70 41 75 78 20 29 7b 0a 20   pAux->pAux ){. 
a7f0: 20 20 20 20 20 69 66 28 20 70 41 75 78 2d 3e 78       if( pAux->x
a800: 44 65 6c 65 74 65 20 29 7b 0a 20 20 20 20 20 20  Delete ){.      
a810: 20 20 70 41 75 78 2d 3e 78 44 65 6c 65 74 65 28    pAux->xDelete(
a820: 70 41 75 78 2d 3e 70 41 75 78 29 3b 0a 20 20 20  pAux->pAux);.   
a830: 20 20 20 7d 0a 20 20 20 20 20 20 70 41 75 78 2d     }.      pAux-
a840: 3e 70 41 75 78 20 3d 20 30 3b 0a 20 20 20 20 7d  >pAux = 0;.    }
a850: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65  .  }.}../*.** De
a860: 6c 65 74 65 20 61 6e 20 65 6e 74 69 72 65 20 56  lete an entire V
a870: 44 42 45 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  DBE..*/.void sql
a880: 69 74 65 33 56 64 62 65 44 65 6c 65 74 65 28 56  ite3VdbeDelete(V
a890: 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 69  dbe *p){.  int i
a8a0: 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 20 72  ;.  if( p==0 ) r
a8b0: 65 74 75 72 6e 3b 0a 20 20 43 6c 65 61 6e 75 70  eturn;.  Cleanup
a8c0: 28 70 29 3b 0a 20 20 69 66 28 20 70 2d 3e 70 50  (p);.  if( p->pP
a8d0: 72 65 76 20 29 7b 0a 20 20 20 20 70 2d 3e 70 50  rev ){.    p->pP
a8e0: 72 65 76 2d 3e 70 4e 65 78 74 20 3d 20 70 2d 3e  rev->pNext = p->
a8f0: 70 4e 65 78 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a  pNext;.  }else{.
a900: 20 20 20 20 61 73 73 65 72 74 28 20 70 2d 3e 64      assert( p->d
a910: 62 2d 3e 70 56 64 62 65 3d 3d 70 20 29 3b 0a 20  b->pVdbe==p );. 
a920: 20 20 20 70 2d 3e 64 62 2d 3e 70 56 64 62 65 20     p->db->pVdbe 
a930: 3d 20 70 2d 3e 70 4e 65 78 74 3b 0a 20 20 7d 0a  = p->pNext;.  }.
a940: 20 20 69 66 28 20 70 2d 3e 70 4e 65 78 74 20 29    if( p->pNext )
a950: 7b 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 2d 3e  {.    p->pNext->
a960: 70 50 72 65 76 20 3d 20 70 2d 3e 70 50 72 65 76  pPrev = p->pPrev
a970: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 2d 3e 61  ;.  }.  if( p->a
a980: 4f 70 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d  Op ){.    for(i=
a990: 30 3b 20 69 3c 70 2d 3e 6e 4f 70 3b 20 69 2b 2b  0; i<p->nOp; i++
a9a0: 29 7b 0a 20 20 20 20 20 20 4f 70 20 2a 70 4f 70  ){.      Op *pOp
a9b0: 20 3d 20 26 70 2d 3e 61 4f 70 5b 69 5d 3b 0a 20   = &p->aOp[i];. 
a9c0: 20 20 20 20 20 66 72 65 65 50 33 28 70 4f 70 2d       freeP3(pOp-
a9d0: 3e 70 33 74 79 70 65 2c 20 70 4f 70 2d 3e 70 33  >p3type, pOp->p3
a9e0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c  );.    }.    sql
a9f0: 69 74 65 46 72 65 65 28 70 2d 3e 61 4f 70 29 3b  iteFree(p->aOp);
aa00: 0a 20 20 7d 0a 20 20 72 65 6c 65 61 73 65 4d 65  .  }.  releaseMe
aa10: 6d 41 72 72 61 79 28 70 2d 3e 61 56 61 72 2c 20  mArray(p->aVar, 
aa20: 70 2d 3e 6e 56 61 72 29 3b 0a 20 20 73 71 6c 69  p->nVar);.  sqli
aa30: 74 65 46 72 65 65 28 70 2d 3e 61 4c 61 62 65 6c  teFree(p->aLabel
aa40: 29 3b 0a 20 20 73 71 6c 69 74 65 46 72 65 65 28  );.  sqliteFree(
aa50: 70 2d 3e 61 53 74 61 63 6b 29 3b 0a 20 20 72 65  p->aStack);.  re
aa60: 6c 65 61 73 65 4d 65 6d 41 72 72 61 79 28 70 2d  leaseMemArray(p-
aa70: 3e 61 43 6f 6c 4e 61 6d 65 2c 20 70 2d 3e 6e 52  >aColName, p->nR
aa80: 65 73 43 6f 6c 75 6d 6e 2a 32 29 3b 0a 20 20 73  esColumn*2);.  s
aa90: 71 6c 69 74 65 46 72 65 65 28 70 2d 3e 61 43 6f  qliteFree(p->aCo
aaa0: 6c 4e 61 6d 65 29 3b 0a 20 20 70 2d 3e 6d 61 67  lName);.  p->mag
aab0: 69 63 20 3d 20 56 44 42 45 5f 4d 41 47 49 43 5f  ic = VDBE_MAGIC_
aac0: 44 45 41 44 3b 0a 20 20 73 71 6c 69 74 65 46 72  DEAD;.  sqliteFr
aad0: 65 65 28 70 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  ee(p);.}../*.** 
aae0: 49 66 20 61 20 4d 6f 76 65 54 6f 20 6f 70 65 72  If a MoveTo oper
aaf0: 61 74 69 6f 6e 20 69 73 20 70 65 6e 64 69 6e 67  ation is pending
ab00: 20 6f 6e 20 74 68 65 20 67 69 76 65 6e 20 63 75   on the given cu
ab10: 72 73 6f 72 2c 20 74 68 65 6e 20 64 6f 20 74 68  rsor, then do th
ab20: 61 74 0a 2a 2a 20 4d 6f 76 65 54 6f 20 6e 6f 77  at.** MoveTo now
ab30: 2e 20 20 52 65 74 75 72 6e 20 61 6e 20 65 72 72  .  Return an err
ab40: 6f 72 20 63 6f 64 65 2e 20 20 49 66 20 6e 6f 20  or code.  If no 
ab50: 4d 6f 76 65 54 6f 20 69 73 20 70 65 6e 64 69 6e  MoveTo is pendin
ab60: 67 2c 20 74 68 69 73 0a 2a 2a 20 72 6f 75 74 69  g, this.** routi
ab70: 6e 65 20 64 6f 65 73 20 6e 6f 74 68 69 6e 67 20  ne does nothing 
ab80: 61 6e 64 20 72 65 74 75 72 6e 73 20 53 51 4c 49  and returns SQLI
ab90: 54 45 5f 4f 4b 2e 0a 2a 2f 0a 69 6e 74 20 73 71  TE_OK..*/.int sq
aba0: 6c 69 74 65 33 56 64 62 65 43 75 72 73 6f 72 4d  lite3VdbeCursorM
abb0: 6f 76 65 74 6f 28 43 75 72 73 6f 72 20 2a 70 29  oveto(Cursor *p)
abc0: 7b 0a 20 20 69 66 28 20 70 2d 3e 64 65 66 65 72  {.  if( p->defer
abd0: 72 65 64 4d 6f 76 65 74 6f 20 29 7b 0a 20 20 20  redMoveto ){.   
abe0: 20 69 6e 74 20 72 65 73 2c 20 72 63 3b 0a 20 20   int res, rc;.  
abf0: 20 20 65 78 74 65 72 6e 20 69 6e 74 20 73 71 6c    extern int sql
ac00: 69 74 65 33 5f 73 65 61 72 63 68 5f 63 6f 75 6e  ite3_search_coun
ac10: 74 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  t;.    assert( p
ac20: 2d 3e 69 73 54 61 62 6c 65 20 29 3b 0a 20 20 20  ->isTable );.   
ac30: 20 69 66 28 20 70 2d 3e 69 73 54 61 62 6c 65 20   if( p->isTable 
ac40: 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  ){.      rc = sq
ac50: 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f  lite3BtreeMoveto
ac60: 28 70 2d 3e 70 43 75 72 73 6f 72 2c 20 30 2c 20  (p->pCursor, 0, 
ac70: 70 2d 3e 6d 6f 76 65 74 6f 54 61 72 67 65 74 2c  p->movetoTarget,
ac80: 20 26 72 65 73 29 3b 0a 20 20 20 20 7d 65 6c 73   &res);.    }els
ac90: 65 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71  e{.      rc = sq
aca0: 6c 69 74 65 33 42 74 72 65 65 4d 6f 76 65 74 6f  lite3BtreeMoveto
acb0: 28 70 2d 3e 70 43 75 72 73 6f 72 2c 28 63 68 61  (p->pCursor,(cha
acc0: 72 2a 29 26 70 2d 3e 6d 6f 76 65 74 6f 54 61 72  r*)&p->movetoTar
acd0: 67 65 74 2c 0a 20 20 20 20 20 20 20 20 20 20 20  get,.           
ace0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
acf0: 20 20 20 73 69 7a 65 6f 66 28 69 36 34 29 2c 26     sizeof(i64),&
ad00: 72 65 73 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  res);.    }.    
ad10: 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e 20  if( rc ) return 
ad20: 72 63 3b 0a 20 20 20 20 2a 70 2d 3e 70 49 6e 63  rc;.    *p->pInc
ad30: 72 4b 65 79 20 3d 20 30 3b 0a 20 20 20 20 70 2d  rKey = 0;.    p-
ad40: 3e 6c 61 73 74 52 6f 77 69 64 20 3d 20 6b 65 79  >lastRowid = key
ad50: 54 6f 49 6e 74 28 70 2d 3e 6d 6f 76 65 74 6f 54  ToInt(p->movetoT
ad60: 61 72 67 65 74 29 3b 0a 20 20 20 20 70 2d 3e 72  arget);.    p->r
ad70: 6f 77 69 64 49 73 56 61 6c 69 64 20 3d 20 72 65  owidIsValid = re
ad80: 73 3d 3d 30 3b 0a 20 20 20 20 69 66 28 20 72 65  s==0;.    if( re
ad90: 73 3c 30 20 29 7b 0a 20 20 20 20 20 20 72 63 20  s<0 ){.      rc 
ada0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 4e 65  = sqlite3BtreeNe
adb0: 78 74 28 70 2d 3e 70 43 75 72 73 6f 72 2c 20 26  xt(p->pCursor, &
adc0: 72 65 73 29 3b 0a 20 20 20 20 20 20 69 66 28 20  res);.      if( 
add0: 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  rc ) return rc;.
ade0: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
adf0: 33 5f 73 65 61 72 63 68 5f 63 6f 75 6e 74 2b 2b  3_search_count++
ae00: 3b 0a 20 20 20 20 70 2d 3e 64 65 66 65 72 72 65  ;.    p->deferre
ae10: 64 4d 6f 76 65 74 6f 20 3d 20 30 3b 0a 20 20 20  dMoveto = 0;.   
ae20: 20 70 2d 3e 63 61 63 68 65 53 74 61 74 75 73 20   p->cacheStatus 
ae30: 3d 20 43 41 43 48 45 5f 53 54 41 4c 45 3b 0a 20  = CACHE_STALE;. 
ae40: 20 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49   }.  return SQLI
ae50: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  TE_OK;.}../*.** 
ae60: 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 66 75  The following fu
ae70: 6e 63 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 73  nctions:.**.** s
ae80: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
ae90: 54 79 70 65 28 29 0a 2a 2a 20 73 71 6c 69 74 65  Type().** sqlite
aea0: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
aeb0: 65 6e 28 29 0a 2a 2a 20 73 71 6c 69 74 65 33 56  en().** sqlite3V
aec0: 64 62 65 53 65 72 69 61 6c 52 65 61 64 28 29 0a  dbeSerialRead().
aed0: 2a 2a 20 73 71 6c 69 74 65 33 56 64 62 65 53 65  ** sqlite3VdbeSe
aee0: 72 69 61 6c 4c 65 6e 28 29 0a 2a 2a 20 73 71 6c  rialLen().** sql
aef0: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 57 72  ite3VdbeSerialWr
af00: 69 74 65 28 29 0a 2a 2a 0a 2a 2a 20 65 6e 63 61  ite().**.** enca
af10: 70 73 75 6c 61 74 65 20 74 68 65 20 63 6f 64 65  psulate the code
af20: 20 74 68 61 74 20 73 65 72 69 61 6c 69 7a 65 73   that serializes
af30: 20 76 61 6c 75 65 73 20 66 6f 72 20 73 74 6f 72   values for stor
af40: 61 67 65 20 69 6e 20 53 51 4c 69 74 65 0a 2a 2a  age in SQLite.**
af50: 20 64 61 74 61 20 61 6e 64 20 69 6e 64 65 78 20   data and index 
af60: 72 65 63 6f 72 64 73 2e 20 45 61 63 68 20 73 65  records. Each se
af70: 72 69 61 6c 69 7a 65 64 20 76 61 6c 75 65 20 63  rialized value c
af80: 6f 6e 73 69 73 74 73 20 6f 66 20 61 0a 2a 2a 20  onsists of a.** 
af90: 27 73 65 72 69 61 6c 2d 74 79 70 65 27 20 61 6e  'serial-type' an
afa0: 64 20 61 20 62 6c 6f 62 20 6f 66 20 64 61 74 61  d a blob of data
afb0: 2e 20 54 68 65 20 73 65 72 69 61 6c 20 74 79 70  . The serial typ
afc0: 65 20 69 73 20 61 6e 20 38 2d 62 79 74 65 20 75  e is an 8-byte u
afd0: 6e 73 69 67 6e 65 64 0a 2a 2a 20 69 6e 74 65 67  nsigned.** integ
afe0: 65 72 2c 20 73 74 6f 72 65 64 20 61 73 20 61 20  er, stored as a 
aff0: 76 61 72 69 6e 74 2e 0a 2a 2a 0a 2a 2a 20 49 6e  varint..**.** In
b000: 20 61 6e 20 53 51 4c 69 74 65 20 69 6e 64 65 78   an SQLite index
b010: 20 72 65 63 6f 72 64 2c 20 74 68 65 20 73 65 72   record, the ser
b020: 69 61 6c 20 74 79 70 65 20 69 73 20 73 74 6f 72  ial type is stor
b030: 65 64 20 64 69 72 65 63 74 6c 79 20 62 65 66 6f  ed directly befo
b040: 72 65 0a 2a 2a 20 74 68 65 20 62 6c 6f 62 20 6f  re.** the blob o
b050: 66 20 64 61 74 61 20 74 68 61 74 20 69 74 20 63  f data that it c
b060: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 2e 20 49  orresponds to. I
b070: 6e 20 61 20 74 61 62 6c 65 20 72 65 63 6f 72 64  n a table record
b080: 2c 20 61 6c 6c 20 73 65 72 69 61 6c 0a 2a 2a 20  , all serial.** 
b090: 74 79 70 65 73 20 61 72 65 20 73 74 6f 72 65 64  types are stored
b0a0: 20 61 74 20 74 68 65 20 73 74 61 72 74 20 6f 66   at the start of
b0b0: 20 74 68 65 20 72 65 63 6f 72 64 2c 20 61 6e 64   the record, and
b0c0: 20 74 68 65 20 62 6c 6f 62 73 20 6f 66 20 64 61   the blobs of da
b0d0: 74 61 20 61 74 0a 2a 2a 20 74 68 65 20 65 6e 64  ta at.** the end
b0e0: 2e 20 48 65 6e 63 65 20 74 68 65 73 65 20 66 75  . Hence these fu
b0f0: 6e 63 74 69 6f 6e 73 20 61 6c 6c 6f 77 20 74 68  nctions allow th
b100: 65 20 63 61 6c 6c 65 72 20 74 6f 20 68 61 6e 64  e caller to hand
b110: 6c 65 20 74 68 65 0a 2a 2a 20 73 65 72 69 61 6c  le the.** serial
b120: 2d 74 79 70 65 20 61 6e 64 20 64 61 74 61 20 62  -type and data b
b130: 6c 6f 62 20 73 65 70 65 72 61 74 65 6c 79 2e 0a  lob seperately..
b140: 2a 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  **.** The follow
b150: 69 6e 67 20 74 61 62 6c 65 20 64 65 73 63 72 69  ing table descri
b160: 62 65 73 20 74 68 65 20 76 61 72 69 6f 75 73 20  bes the various 
b170: 73 74 6f 72 61 67 65 20 63 6c 61 73 73 65 73 20  storage classes 
b180: 66 6f 72 20 64 61 74 61 3a 0a 2a 2a 0a 2a 2a 20  for data:.**.** 
b190: 20 20 73 65 72 69 61 6c 20 74 79 70 65 20 20 20    serial type   
b1a0: 20 20 20 20 20 62 79 74 65 73 20 6f 66 20 64 61       bytes of da
b1b0: 74 61 20 20 20 20 20 20 74 79 70 65 0a 2a 2a 20  ta      type.** 
b1c0: 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d    --------------
b1d0: 20 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d       -----------
b1e0: 2d 2d 2d 2d 20 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d  ----    --------
b1f0: 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 20 20 20  -------.**      
b200: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0               
b210: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
b220: 20 20 20 4e 55 4c 4c 0a 2a 2a 20 20 20 20 20 20     NULL.**      
b230: 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  1               
b240: 20 20 20 20 20 20 31 20 20 20 20 20 20 20 20 20        1         
b250: 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65     signed intege
b260: 72 0a 2a 2a 20 20 20 20 20 20 32 20 20 20 20 20  r.**      2     
b270: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b280: 32 20 20 20 20 20 20 20 20 20 20 20 20 73 69 67  2            sig
b290: 6e 65 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20  ned integer.**  
b2a0: 20 20 20 20 33 20 20 20 20 20 20 20 20 20 20 20      3           
b2b0: 20 20 20 20 20 20 20 20 20 20 33 20 20 20 20 20            3     
b2c0: 20 20 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e         signed in
b2d0: 74 65 67 65 72 0a 2a 2a 20 20 20 20 20 20 34 20  teger.**      4 
b2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b2f0: 20 20 20 20 34 20 20 20 20 20 20 20 20 20 20 20      4           
b300: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 0a   signed integer.
b310: 2a 2a 20 20 20 20 20 20 35 20 20 20 20 20 20 20  **      5       
b320: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 36 20                6 
b330: 20 20 20 20 20 20 20 20 20 20 20 73 69 67 6e 65             signe
b340: 64 20 69 6e 74 65 67 65 72 0a 2a 2a 20 20 20 20  d integer.**    
b350: 20 20 36 20 20 20 20 20 20 20 20 20 20 20 20 20    6             
b360: 20 20 20 20 20 20 20 20 38 20 20 20 20 20 20 20          8       
b370: 20 20 20 20 20 73 69 67 6e 65 64 20 69 6e 74 65       signed inte
b380: 67 65 72 0a 2a 2a 20 20 20 20 20 20 37 20 20 20  ger.**      7   
b390: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b3a0: 20 20 38 20 20 20 20 20 20 20 20 20 20 20 20 49    8            I
b3b0: 45 45 45 20 66 6c 6f 61 74 0a 2a 2a 20 20 20 20  EEE float.**    
b3c0: 20 20 38 20 20 20 20 20 20 20 20 20 20 20 20 20    8             
b3d0: 20 20 20 20 20 20 20 20 30 20 20 20 20 20 20 20          0       
b3e0: 20 20 20 20 20 49 6e 74 65 67 65 72 20 63 6f 6e       Integer con
b3f0: 73 74 61 6e 74 20 30 0a 2a 2a 20 20 20 20 20 20  stant 0.**      
b400: 39 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  9               
b410: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
b420: 20 20 20 49 6e 74 65 67 65 72 20 63 6f 6e 73 74     Integer const
b430: 61 6e 74 20 31 0a 2a 2a 20 20 20 20 20 31 30 2c  ant 1.**     10,
b440: 31 31 20 20 20 20 20 20 20 20 20 20 20 20 20 20  11              
b450: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b460: 20 72 65 73 65 72 76 65 64 20 66 6f 72 20 65 78   reserved for ex
b470: 70 61 6e 73 69 6f 6e 0a 2a 2a 20 20 20 20 4e 3e  pansion.**    N>
b480: 3d 31 32 20 61 6e 64 20 65 76 65 6e 20 20 20 20  =12 and even    
b490: 20 20 20 28 4e 2d 31 32 29 2f 32 20 20 20 20 20     (N-12)/2     
b4a0: 20 20 20 42 4c 4f 42 0a 2a 2a 20 20 20 20 4e 3e     BLOB.**    N>
b4b0: 3d 31 33 20 61 6e 64 20 6f 64 64 20 20 20 20 20  =13 and odd     
b4c0: 20 20 20 28 4e 2d 31 33 29 2f 32 20 20 20 20 20     (N-13)/2     
b4d0: 20 20 20 74 65 78 74 0a 2a 2a 0a 2a 2a 20 54 68     text.**.** Th
b4e0: 65 20 38 20 61 6e 64 20 39 20 74 79 70 65 73 20  e 8 and 9 types 
b4f0: 77 65 72 65 20 61 64 64 65 64 20 69 6e 20 33 2e  were added in 3.
b500: 33 2e 30 2c 20 66 69 6c 65 20 66 6f 72 6d 61 74  3.0, file format
b510: 20 34 2e 20 20 50 72 69 6f 72 20 76 65 72 73 69   4.  Prior versi
b520: 6f 6e 73 0a 2a 2a 20 6f 66 20 53 51 4c 69 74 65  ons.** of SQLite
b530: 20 77 69 6c 6c 20 6e 6f 74 20 75 6e 64 65 72 73   will not unders
b540: 74 61 6e 64 20 74 68 6f 73 65 20 73 65 72 69 61  tand those seria
b550: 6c 20 74 79 70 65 73 2e 0a 2a 2f 0a 0a 2f 2a 0a  l types..*/../*.
b560: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 73 65  ** Return the se
b570: 72 69 61 6c 2d 74 79 70 65 20 66 6f 72 20 74 68  rial-type for th
b580: 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 69  e value stored i
b590: 6e 20 70 4d 65 6d 2e 0a 2a 2f 0a 75 33 32 20 73  n pMem..*/.u32 s
b5a0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
b5b0: 54 79 70 65 28 4d 65 6d 20 2a 70 4d 65 6d 2c 20  Type(Mem *pMem, 
b5c0: 69 6e 74 20 66 69 6c 65 5f 66 6f 72 6d 61 74 29  int file_format)
b5d0: 7b 0a 20 20 69 6e 74 20 66 6c 61 67 73 20 3d 20  {.  int flags = 
b5e0: 70 4d 65 6d 2d 3e 66 6c 61 67 73 3b 0a 0a 20 20  pMem->flags;..  
b5f0: 69 66 28 20 66 6c 61 67 73 26 4d 45 4d 5f 4e 75  if( flags&MEM_Nu
b600: 6c 6c 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  ll ){.    return
b610: 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c   0;.  }.  if( fl
b620: 61 67 73 26 4d 45 4d 5f 49 6e 74 20 29 7b 0a 20  ags&MEM_Int ){. 
b630: 20 20 20 2f 2a 20 46 69 67 75 72 65 20 6f 75 74     /* Figure out
b640: 20 77 68 65 74 68 65 72 20 74 6f 20 75 73 65 20   whether to use 
b650: 31 2c 20 32 2c 20 34 2c 20 36 20 6f 72 20 38 20  1, 2, 4, 6 or 8 
b660: 62 79 74 65 73 2e 20 2a 2f 0a 23 20 20 20 64 65  bytes. */.#   de
b670: 66 69 6e 65 20 4d 41 58 5f 36 42 59 54 45 20 28  fine MAX_6BYTE (
b680: 28 28 28 69 36 34 29 30 78 30 30 30 30 31 30 30  (((i64)0x0000100
b690: 30 29 3c 3c 33 32 29 2d 31 29 0a 20 20 20 20 69  0)<<32)-1).    i
b6a0: 36 34 20 69 20 3d 20 70 4d 65 6d 2d 3e 69 3b 0a  64 i = pMem->i;.
b6b0: 20 20 20 20 75 36 34 20 75 3b 0a 20 20 20 20 69      u64 u;.    i
b6c0: 66 28 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 3d  f( file_format>=
b6d0: 34 20 26 26 20 28 69 26 31 29 3d 3d 69 20 29 7b  4 && (i&1)==i ){
b6e0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 38 2b  .      return 8+
b6f0: 69 3b 0a 20 20 20 20 7d 0a 20 20 20 20 75 20 3d  i;.    }.    u =
b700: 20 69 3c 30 20 3f 20 2d 69 20 3a 20 69 3b 0a 20   i<0 ? -i : i;. 
b710: 20 20 20 69 66 28 20 75 3c 3d 31 32 37 20 29 20     if( u<=127 ) 
b720: 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 69 66  return 1;.    if
b730: 28 20 75 3c 3d 33 32 37 36 37 20 29 20 72 65 74  ( u<=32767 ) ret
b740: 75 72 6e 20 32 3b 0a 20 20 20 20 69 66 28 20 75  urn 2;.    if( u
b750: 3c 3d 38 33 38 38 36 30 37 20 29 20 72 65 74 75  <=8388607 ) retu
b760: 72 6e 20 33 3b 0a 20 20 20 20 69 66 28 20 75 3c  rn 3;.    if( u<
b770: 3d 32 31 34 37 34 38 33 36 34 37 20 29 20 72 65  =2147483647 ) re
b780: 74 75 72 6e 20 34 3b 0a 20 20 20 20 69 66 28 20  turn 4;.    if( 
b790: 75 3c 3d 4d 41 58 5f 36 42 59 54 45 20 29 20 72  u<=MAX_6BYTE ) r
b7a0: 65 74 75 72 6e 20 35 3b 0a 20 20 20 20 72 65 74  eturn 5;.    ret
b7b0: 75 72 6e 20 36 3b 0a 20 20 7d 0a 20 20 69 66 28  urn 6;.  }.  if(
b7c0: 20 66 6c 61 67 73 26 4d 45 4d 5f 52 65 61 6c 20   flags&MEM_Real 
b7d0: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 37 3b  ){.    return 7;
b7e0: 0a 20 20 7d 0a 20 20 69 66 28 20 66 6c 61 67 73  .  }.  if( flags
b7f0: 26 4d 45 4d 5f 53 74 72 20 29 7b 0a 20 20 20 20  &MEM_Str ){.    
b800: 69 6e 74 20 6e 20 3d 20 70 4d 65 6d 2d 3e 6e 3b  int n = pMem->n;
b810: 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 3e 3d  .    assert( n>=
b820: 30 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 );.    return 
b830: 28 28 6e 2a 32 29 20 2b 20 31 33 29 3b 0a 20 20  ((n*2) + 13);.  
b840: 7d 0a 20 20 69 66 28 20 66 6c 61 67 73 26 4d 45  }.  if( flags&ME
b850: 4d 5f 42 6c 6f 62 20 29 7b 0a 20 20 20 20 72 65  M_Blob ){.    re
b860: 74 75 72 6e 20 28 70 4d 65 6d 2d 3e 6e 2a 32 20  turn (pMem->n*2 
b870: 2b 20 31 32 29 3b 0a 20 20 7d 0a 20 20 72 65 74  + 12);.  }.  ret
b880: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
b890: 52 65 74 75 72 6e 20 74 68 65 20 6c 65 6e 67 74  Return the lengt
b8a0: 68 20 6f 66 20 74 68 65 20 64 61 74 61 20 63 6f  h of the data co
b8b0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 74 6f 20 74  rresponding to t
b8c0: 68 65 20 73 75 70 70 6c 69 65 64 20 73 65 72 69  he supplied seri
b8d0: 61 6c 2d 74 79 70 65 2e 0a 2a 2f 0a 69 6e 74 20  al-type..*/.int 
b8e0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61  sqlite3VdbeSeria
b8f0: 6c 54 79 70 65 4c 65 6e 28 75 33 32 20 73 65 72  lTypeLen(u32 ser
b900: 69 61 6c 5f 74 79 70 65 29 7b 0a 20 20 69 66 28  ial_type){.  if(
b910: 20 73 65 72 69 61 6c 5f 74 79 70 65 3e 3d 31 32   serial_type>=12
b920: 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 28   ){.    return (
b930: 73 65 72 69 61 6c 5f 74 79 70 65 2d 31 32 29 2f  serial_type-12)/
b940: 32 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  2;.  }else{.    
b950: 73 74 61 74 69 63 20 63 6f 6e 73 74 20 75 38 20  static const u8 
b960: 61 53 69 7a 65 5b 5d 20 3d 20 7b 20 30 2c 20 31  aSize[] = { 0, 1
b970: 2c 20 32 2c 20 33 2c 20 34 2c 20 36 2c 20 38 2c  , 2, 3, 4, 6, 8,
b980: 20 38 2c 20 30 2c 20 30 2c 20 30 2c 20 30 20 7d   8, 0, 0, 0, 0 }
b990: 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 61 53 69  ;.    return aSi
b9a0: 7a 65 5b 73 65 72 69 61 6c 5f 74 79 70 65 5d 3b  ze[serial_type];
b9b0: 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 57 72  .  }.}../*.** Wr
b9c0: 69 74 65 20 74 68 65 20 73 65 72 69 61 6c 69 7a  ite the serializ
b9d0: 65 64 20 64 61 74 61 20 62 6c 6f 62 20 66 6f 72  ed data blob for
b9e0: 20 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65   the value store
b9f0: 64 20 69 6e 20 70 4d 65 6d 20 69 6e 74 6f 20 0a  d in pMem into .
ba00: 2a 2a 20 62 75 66 2e 20 49 74 20 69 73 20 61 73  ** buf. It is as
ba10: 73 75 6d 65 64 20 74 68 61 74 20 74 68 65 20 63  sumed that the c
ba20: 61 6c 6c 65 72 20 68 61 73 20 61 6c 6c 6f 63 61  aller has alloca
ba30: 74 65 64 20 73 75 66 66 69 63 69 65 6e 74 20 73  ted sufficient s
ba40: 70 61 63 65 2e 0a 2a 2a 20 52 65 74 75 72 6e 20  pace..** Return 
ba50: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62 79  the number of by
ba60: 74 65 73 20 77 72 69 74 74 65 6e 2e 0a 2a 2f 20  tes written..*/ 
ba70: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
ba80: 53 65 72 69 61 6c 50 75 74 28 75 6e 73 69 67 6e  SerialPut(unsign
ba90: 65 64 20 63 68 61 72 20 2a 62 75 66 2c 20 4d 65  ed char *buf, Me
baa0: 6d 20 2a 70 4d 65 6d 2c 20 69 6e 74 20 66 69 6c  m *pMem, int fil
bab0: 65 5f 66 6f 72 6d 61 74 29 7b 0a 20 20 75 33 32  e_format){.  u32
bac0: 20 73 65 72 69 61 6c 5f 74 79 70 65 20 3d 20 73   serial_type = s
bad0: 71 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c  qlite3VdbeSerial
bae0: 54 79 70 65 28 70 4d 65 6d 2c 20 66 69 6c 65 5f  Type(pMem, file_
baf0: 66 6f 72 6d 61 74 29 3b 0a 20 20 69 6e 74 20 6c  format);.  int l
bb00: 65 6e 3b 0a 0a 20 20 2f 2a 20 49 6e 74 65 67 65  en;..  /* Intege
bb10: 72 20 61 6e 64 20 52 65 61 6c 20 2a 2f 0a 20 20  r and Real */.  
bb20: 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65 3c  if( serial_type<
bb30: 3d 37 20 26 26 20 73 65 72 69 61 6c 5f 74 79 70  =7 && serial_typ
bb40: 65 3e 30 20 29 7b 0a 20 20 20 20 75 36 34 20 76  e>0 ){.    u64 v
bb50: 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20  ;.    int i;.   
bb60: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
bb70: 3d 3d 37 20 29 7b 0a 20 20 20 20 20 20 76 20 3d  ==7 ){.      v =
bb80: 20 2a 28 75 36 34 2a 29 26 70 4d 65 6d 2d 3e 72   *(u64*)&pMem->r
bb90: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
bba0: 20 20 20 76 20 3d 20 2a 28 75 36 34 2a 29 26 70     v = *(u64*)&p
bbb0: 4d 65 6d 2d 3e 69 3b 0a 20 20 20 20 7d 0a 20 20  Mem->i;.    }.  
bbc0: 20 20 6c 65 6e 20 3d 20 69 20 3d 20 73 71 6c 69    len = i = sqli
bbd0: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
bbe0: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
bbf0: 29 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 69 2d  );.    while( i-
bc00: 2d 20 29 7b 0a 20 20 20 20 20 20 62 75 66 5b 69  - ){.      buf[i
bc10: 5d 20 3d 20 28 76 26 30 78 46 46 29 3b 0a 20 20  ] = (v&0xFF);.  
bc20: 20 20 20 20 76 20 3e 3e 3d 20 38 3b 0a 20 20 20      v >>= 8;.   
bc30: 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 6c 65   }.    return le
bc40: 6e 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 53 74 72  n;.  }..  /* Str
bc50: 69 6e 67 20 6f 72 20 62 6c 6f 62 20 2a 2f 0a 20  ing or blob */. 
bc60: 20 69 66 28 20 73 65 72 69 61 6c 5f 74 79 70 65   if( serial_type
bc70: 3e 3d 31 32 20 29 7b 0a 20 20 20 20 6c 65 6e 20  >=12 ){.    len 
bc80: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  = sqlite3VdbeSer
bc90: 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61  ialTypeLen(seria
bca0: 6c 5f 74 79 70 65 29 3b 0a 20 20 20 20 6d 65 6d  l_type);.    mem
bcb0: 63 70 79 28 62 75 66 2c 20 70 4d 65 6d 2d 3e 7a  cpy(buf, pMem->z
bcc0: 2c 20 6c 65 6e 29 3b 0a 20 20 20 20 72 65 74 75  , len);.    retu
bcd0: 72 6e 20 6c 65 6e 3b 0a 20 20 7d 0a 0a 20 20 2f  rn len;.  }..  /
bce0: 2a 20 4e 55 4c 4c 20 6f 72 20 63 6f 6e 73 74 61  * NULL or consta
bcf0: 6e 74 73 20 30 20 6f 72 20 31 20 2a 2f 0a 20 20  nts 0 or 1 */.  
bd00: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a  return 0;.}../*.
bd10: 2a 2a 20 44 65 73 65 72 69 61 6c 69 7a 65 20 74  ** Deserialize t
bd20: 68 65 20 64 61 74 61 20 62 6c 6f 62 20 70 6f 69  he data blob poi
bd30: 6e 74 65 64 20 74 6f 20 62 79 20 62 75 66 20 61  nted to by buf a
bd40: 73 20 73 65 72 69 61 6c 20 74 79 70 65 20 73 65  s serial type se
bd50: 72 69 61 6c 5f 74 79 70 65 0a 2a 2a 20 61 6e 64  rial_type.** and
bd60: 20 73 74 6f 72 65 20 74 68 65 20 72 65 73 75 6c   store the resul
bd70: 74 20 69 6e 20 70 4d 65 6d 2e 20 20 52 65 74 75  t in pMem.  Retu
bd80: 72 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  rn the number of
bd90: 20 62 79 74 65 73 20 72 65 61 64 2e 0a 2a 2f 20   bytes read..*/ 
bda0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65  .int sqlite3Vdbe
bdb0: 53 65 72 69 61 6c 47 65 74 28 0a 20 20 63 6f 6e  SerialGet(.  con
bdc0: 73 74 20 75 6e 73 69 67 6e 65 64 20 63 68 61 72  st unsigned char
bdd0: 20 2a 62 75 66 2c 20 20 20 20 20 2f 2a 20 42 75   *buf,     /* Bu
bde0: 66 66 65 72 20 74 6f 20 64 65 73 65 72 69 61 6c  ffer to deserial
bdf0: 69 7a 65 20 66 72 6f 6d 20 2a 2f 0a 20 20 75 33  ize from */.  u3
be00: 32 20 73 65 72 69 61 6c 5f 74 79 70 65 2c 20 20  2 serial_type,  
be10: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
be20: 65 72 69 61 6c 20 74 79 70 65 20 74 6f 20 64 65  erial type to de
be30: 73 65 72 69 61 6c 69 7a 65 20 2a 2f 0a 20 20 4d  serialize */.  M
be40: 65 6d 20 2a 70 4d 65 6d 20 20 20 20 20 20 20 20  em *pMem        
be50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
be60: 4d 65 6d 6f 72 79 20 63 65 6c 6c 20 74 6f 20 77  Memory cell to w
be70: 72 69 74 65 20 76 61 6c 75 65 20 69 6e 74 6f 20  rite value into 
be80: 2a 2f 0a 29 7b 0a 20 20 73 77 69 74 63 68 28 20  */.){.  switch( 
be90: 73 65 72 69 61 6c 5f 74 79 70 65 20 29 7b 0a 20  serial_type ){. 
bea0: 20 20 20 63 61 73 65 20 31 30 3a 20 20 20 2f 2a     case 10:   /*
beb0: 20 52 65 73 65 72 76 65 64 20 66 6f 72 20 66 75   Reserved for fu
bec0: 74 75 72 65 20 75 73 65 20 2a 2f 0a 20 20 20 20  ture use */.    
bed0: 63 61 73 65 20 31 31 3a 20 20 20 2f 2a 20 52 65  case 11:   /* Re
bee0: 73 65 72 76 65 64 20 66 6f 72 20 66 75 74 75 72  served for futur
bef0: 65 20 75 73 65 20 2a 2f 0a 20 20 20 20 63 61 73  e use */.    cas
bf00: 65 20 30 3a 20 7b 20 20 2f 2a 20 4e 55 4c 4c 20  e 0: {  /* NULL 
bf10: 2a 2f 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  */.      pMem->f
bf20: 6c 61 67 73 20 3d 20 4d 45 4d 5f 4e 75 6c 6c 3b  lags = MEM_Null;
bf30: 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20  .      break;.  
bf40: 20 20 7d 0a 20 20 20 20 63 61 73 65 20 31 3a 20    }.    case 1: 
bf50: 7b 20 2f 2a 20 31 2d 62 79 74 65 20 73 69 67 6e  { /* 1-byte sign
bf60: 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a 20 20  ed integer */.  
bf70: 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20 28 73      pMem->i = (s
bf80: 69 67 6e 65 64 20 63 68 61 72 29 62 75 66 5b 30  igned char)buf[0
bf90: 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66  ];.      pMem->f
bfa0: 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a  lags = MEM_Int;.
bfb0: 20 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a        return 1;.
bfc0: 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65 20 32      }.    case 2
bfd0: 3a 20 7b 20 2f 2a 20 32 2d 62 79 74 65 20 73 69  : { /* 2-byte si
bfe0: 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a 2f 0a  gned integer */.
bff0: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20        pMem->i = 
c000: 28 28 28 73 69 67 6e 65 64 20 63 68 61 72 29 62  (((signed char)b
c010: 75 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62 75 66  uf[0])<<8) | buf
c020: 5b 31 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d 2d  [1];.      pMem-
c030: 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e 74  >flags = MEM_Int
c040: 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 32  ;.      return 2
c050: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73 65  ;.    }.    case
c060: 20 33 3a 20 7b 20 2f 2a 20 33 2d 62 79 74 65 20   3: { /* 3-byte 
c070: 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20 2a  signed integer *
c080: 2f 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20  /.      pMem->i 
c090: 3d 20 28 28 28 73 69 67 6e 65 64 20 63 68 61 72  = (((signed char
c0a0: 29 62 75 66 5b 30 5d 29 3c 3c 31 36 29 20 7c 20  )buf[0])<<16) | 
c0b0: 28 62 75 66 5b 31 5d 3c 3c 38 29 20 7c 20 62 75  (buf[1]<<8) | bu
c0c0: 66 5b 32 5d 3b 0a 20 20 20 20 20 20 70 4d 65 6d  f[2];.      pMem
c0d0: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
c0e0: 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  t;.      return 
c0f0: 33 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  3;.    }.    cas
c100: 65 20 34 3a 20 7b 20 2f 2a 20 34 2d 62 79 74 65  e 4: { /* 4-byte
c110: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 20   signed integer 
c120: 2a 2f 0a 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69  */.      pMem->i
c130: 20 3d 20 28 62 75 66 5b 30 5d 3c 3c 32 34 29 20   = (buf[0]<<24) 
c140: 7c 20 28 62 75 66 5b 31 5d 3c 3c 31 36 29 20 7c  | (buf[1]<<16) |
c150: 20 28 62 75 66 5b 32 5d 3c 3c 38 29 20 7c 20 62   (buf[2]<<8) | b
c160: 75 66 5b 33 5d 3b 0a 20 20 20 20 20 20 70 4d 65  uf[3];.      pMe
c170: 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49  m->flags = MEM_I
c180: 6e 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  nt;.      return
c190: 20 34 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61   4;.    }.    ca
c1a0: 73 65 20 35 3a 20 7b 20 2f 2a 20 36 2d 62 79 74  se 5: { /* 6-byt
c1b0: 65 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72  e signed integer
c1c0: 20 2a 2f 0a 20 20 20 20 20 20 75 36 34 20 78 20   */.      u64 x 
c1d0: 3d 20 28 28 28 73 69 67 6e 65 64 20 63 68 61 72  = (((signed char
c1e0: 29 62 75 66 5b 30 5d 29 3c 3c 38 29 20 7c 20 62  )buf[0])<<8) | b
c1f0: 75 66 5b 31 5d 3b 0a 20 20 20 20 20 20 75 33 32  uf[1];.      u32
c200: 20 79 20 3d 20 28 62 75 66 5b 32 5d 3c 3c 32 34   y = (buf[2]<<24
c210: 29 20 7c 20 28 62 75 66 5b 33 5d 3c 3c 31 36 29  ) | (buf[3]<<16)
c220: 20 7c 20 28 62 75 66 5b 34 5d 3c 3c 38 29 20 7c   | (buf[4]<<8) |
c230: 20 62 75 66 5b 35 5d 3b 0a 20 20 20 20 20 20 78   buf[5];.      x
c240: 20 3d 20 28 78 3c 3c 33 32 29 20 7c 20 79 3b 0a   = (x<<32) | y;.
c250: 20 20 20 20 20 20 70 4d 65 6d 2d 3e 69 20 3d 20        pMem->i = 
c260: 2a 28 69 36 34 2a 29 26 78 3b 0a 20 20 20 20 20  *(i64*)&x;.     
c270: 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20 4d   pMem->flags = M
c280: 45 4d 5f 49 6e 74 3b 0a 20 20 20 20 20 20 72 65  EM_Int;.      re
c290: 74 75 72 6e 20 36 3b 0a 20 20 20 20 7d 0a 20 20  turn 6;.    }.  
c2a0: 20 20 63 61 73 65 20 36 3a 20 20 20 2f 2a 20 38    case 6:   /* 8
c2b0: 2d 62 79 74 65 20 73 69 67 6e 65 64 20 69 6e 74  -byte signed int
c2c0: 65 67 65 72 20 2a 2f 0a 20 20 20 20 63 61 73 65  eger */.    case
c2d0: 20 37 3a 20 7b 20 2f 2a 20 49 45 45 45 20 66 6c   7: { /* IEEE fl
c2e0: 6f 61 74 69 6e 67 20 70 6f 69 6e 74 20 2a 2f 0a  oating point */.
c2f0: 20 20 20 20 20 20 75 36 34 20 78 3b 0a 20 20 20        u64 x;.   
c300: 20 20 20 75 33 32 20 79 3b 0a 23 69 66 6e 64 65     u32 y;.#ifnde
c310: 66 20 4e 44 45 42 55 47 0a 20 20 20 20 20 20 2f  f NDEBUG.      /
c320: 2a 20 56 65 72 69 66 79 20 74 68 61 74 20 69 6e  * Verify that in
c330: 74 65 67 65 72 73 20 61 6e 64 20 66 6c 6f 61 74  tegers and float
c340: 69 6e 67 20 70 6f 69 6e 74 20 76 61 6c 75 65 73  ing point values
c350: 20 75 73 65 20 74 68 65 20 73 61 6d 65 0a 20 20   use the same.  
c360: 20 20 20 20 2a 2a 20 62 79 74 65 20 6f 72 64 65      ** byte orde
c370: 72 2e 20 20 54 68 65 20 62 79 74 65 20 6f 72 64  r.  The byte ord
c380: 65 72 20 64 69 66 66 65 72 73 20 6f 6e 20 73 6f  er differs on so
c390: 6d 65 20 28 62 72 6f 6b 65 6e 29 20 61 72 63 68  me (broken) arch
c3a0: 69 74 65 63 74 75 72 65 73 2e 0a 20 20 20 20 20  itectures..     
c3b0: 20 2a 2f 0a 20 20 20 20 20 20 73 74 61 74 69 63   */.      static
c3c0: 20 63 6f 6e 73 74 20 75 36 34 20 74 31 20 3d 20   const u64 t1 = 
c3d0: 28 28 75 36 34 29 30 78 33 66 66 30 30 30 30 30  ((u64)0x3ff00000
c3e0: 29 3c 3c 33 32 3b 0a 20 20 20 20 20 20 61 73 73  )<<32;.      ass
c3f0: 65 72 74 28 20 31 2e 30 3d 3d 2a 28 64 6f 75 62  ert( 1.0==*(doub
c400: 6c 65 2a 29 26 74 31 20 29 3b 0a 23 65 6e 64 69  le*)&t1 );.#endi
c410: 66 0a 0a 20 20 20 20 20 20 78 20 3d 20 28 62 75  f..      x = (bu
c420: 66 5b 30 5d 3c 3c 32 34 29 20 7c 20 28 62 75 66  f[0]<<24) | (buf
c430: 5b 31 5d 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b  [1]<<16) | (buf[
c440: 32 5d 3c 3c 38 29 20 7c 20 62 75 66 5b 33 5d 3b  2]<<8) | buf[3];
c450: 0a 20 20 20 20 20 20 79 20 3d 20 28 62 75 66 5b  .      y = (buf[
c460: 34 5d 3c 3c 32 34 29 20 7c 20 28 62 75 66 5b 35  4]<<24) | (buf[5
c470: 5d 3c 3c 31 36 29 20 7c 20 28 62 75 66 5b 36 5d  ]<<16) | (buf[6]
c480: 3c 3c 38 29 20 7c 20 62 75 66 5b 37 5d 3b 0a 20  <<8) | buf[7];. 
c490: 20 20 20 20 20 78 20 3d 20 28 78 3c 3c 33 32 29       x = (x<<32)
c4a0: 20 7c 20 79 3b 0a 20 20 20 20 20 20 69 66 28 20   | y;.      if( 
c4b0: 73 65 72 69 61 6c 5f 74 79 70 65 3d 3d 36 20 29  serial_type==6 )
c4c0: 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e  {.        pMem->
c4d0: 69 20 3d 20 2a 28 69 36 34 2a 29 26 78 3b 0a 20  i = *(i64*)&x;. 
c4e0: 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e 66 6c 61         pMem->fla
c4f0: 67 73 20 3d 20 4d 45 4d 5f 49 6e 74 3b 0a 20 20  gs = MEM_Int;.  
c500: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
c510: 20 20 20 70 4d 65 6d 2d 3e 72 20 3d 20 2a 28 64     pMem->r = *(d
c520: 6f 75 62 6c 65 2a 29 26 78 3b 0a 20 20 20 20 20  ouble*)&x;.     
c530: 20 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d     pMem->flags =
c540: 20 4d 45 4d 5f 52 65 61 6c 3b 0a 20 20 20 20 20   MEM_Real;.     
c550: 20 7d 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20   }.      return 
c560: 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 61 73  8;.    }.    cas
c570: 65 20 38 3a 20 20 20 20 2f 2a 20 49 6e 74 65 67  e 8:    /* Integ
c580: 65 72 20 30 20 2a 2f 0a 20 20 20 20 63 61 73 65  er 0 */.    case
c590: 20 39 3a 20 7b 20 20 2f 2a 20 49 6e 74 65 67 65   9: {  /* Intege
c5a0: 72 20 31 20 2a 2f 0a 20 20 20 20 20 20 70 4d 65  r 1 */.      pMe
c5b0: 6d 2d 3e 69 20 3d 20 73 65 72 69 61 6c 5f 74 79  m->i = serial_ty
c5c0: 70 65 2d 38 3b 0a 20 20 20 20 20 20 70 4d 65 6d  pe-8;.      pMem
c5d0: 2d 3e 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 49 6e  ->flags = MEM_In
c5e0: 74 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20  t;.      return 
c5f0: 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 65 66  0;.    }.    def
c600: 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 20 69 6e  ault: {.      in
c610: 74 20 6c 65 6e 20 3d 20 28 73 65 72 69 61 6c 5f  t len = (serial_
c620: 74 79 70 65 2d 31 32 29 2f 32 3b 0a 20 20 20 20  type-12)/2;.    
c630: 20 20 70 4d 65 6d 2d 3e 7a 20 3d 20 28 63 68 61    pMem->z = (cha
c640: 72 20 2a 29 62 75 66 3b 0a 20 20 20 20 20 20 70  r *)buf;.      p
c650: 4d 65 6d 2d 3e 6e 20 3d 20 6c 65 6e 3b 0a 20 20  Mem->n = len;.  
c660: 20 20 20 20 70 4d 65 6d 2d 3e 78 44 65 6c 20 3d      pMem->xDel =
c670: 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 73 65   0;.      if( se
c680: 72 69 61 6c 5f 74 79 70 65 26 30 78 30 31 20 29  rial_type&0x01 )
c690: 7b 0a 20 20 20 20 20 20 20 20 70 4d 65 6d 2d 3e  {.        pMem->
c6a0: 66 6c 61 67 73 20 3d 20 4d 45 4d 5f 53 74 72 20  flags = MEM_Str 
c6b0: 7c 20 4d 45 4d 5f 45 70 68 65 6d 3b 0a 20 20 20  | MEM_Ephem;.   
c6c0: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
c6d0: 20 20 70 4d 65 6d 2d 3e 66 6c 61 67 73 20 3d 20    pMem->flags = 
c6e0: 4d 45 4d 5f 42 6c 6f 62 20 7c 20 4d 45 4d 5f 45  MEM_Blob | MEM_E
c6f0: 70 68 65 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 20  phem;.      }.  
c700: 20 20 20 20 72 65 74 75 72 6e 20 6c 65 6e 3b 0a      return len;.
c710: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75      }.  }.  retu
c720: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  rn 0;.}../*.** T
c730: 68 65 20 68 65 61 64 65 72 20 6f 66 20 61 20 72  he header of a r
c740: 65 63 6f 72 64 20 63 6f 6e 73 69 73 74 73 20 6f  ecord consists o
c750: 66 20 61 20 73 65 71 75 65 6e 63 65 20 76 61 72  f a sequence var
c760: 69 61 62 6c 65 2d 6c 65 6e 67 74 68 20 69 6e 74  iable-length int
c770: 65 67 65 72 73 2e 0a 2a 2a 20 54 68 65 73 65 20  egers..** These 
c780: 69 6e 74 65 67 65 72 73 20 61 72 65 20 61 6c 6d  integers are alm
c790: 6f 73 74 20 61 6c 77 61 79 73 20 73 6d 61 6c 6c  ost always small
c7a0: 20 61 6e 64 20 61 72 65 20 65 6e 63 6f 64 65 64   and are encoded
c7b0: 20 61 73 20 61 20 73 69 6e 67 6c 65 20 62 79 74   as a single byt
c7c0: 65 2e 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77  e..** The follow
c7d0: 69 6e 67 20 6d 61 63 72 6f 20 74 61 6b 65 73 20  ing macro takes 
c7e0: 61 64 76 61 6e 74 61 67 65 20 74 68 69 73 20 66  advantage this f
c7f0: 61 63 74 20 74 6f 20 70 72 6f 76 69 64 65 20 61  act to provide a
c800: 20 66 61 73 74 20 64 65 63 6f 64 65 0a 2a 2a 20   fast decode.** 
c810: 6f 66 20 74 68 65 20 69 6e 74 65 67 65 72 73 20  of the integers 
c820: 69 6e 20 61 20 72 65 63 6f 72 64 20 68 65 61 64  in a record head
c830: 65 72 2e 20 20 49 74 20 69 73 20 66 61 73 74 65  er.  It is faste
c840: 72 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e  r for the common
c850: 20 63 61 73 65 0a 2a 2a 20 77 68 65 72 65 20 74   case.** where t
c860: 68 65 20 69 6e 74 65 67 65 72 20 69 73 20 61 20  he integer is a 
c870: 73 69 6e 67 6c 65 20 62 79 74 65 2e 20 20 49 74  single byte.  It
c880: 20 69 73 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f   is a little slo
c890: 77 65 72 20 77 68 65 6e 20 74 68 65 0a 2a 2a 20  wer when the.** 
c8a0: 69 6e 74 65 67 65 72 20 69 73 20 74 77 6f 20 6f  integer is two o
c8b0: 72 20 6d 6f 72 65 20 62 79 74 65 73 2e 20 20 42  r more bytes.  B
c8c0: 75 74 20 6f 76 65 72 61 6c 6c 20 69 74 20 69 73  ut overall it is
c8d0: 20 66 61 73 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 54   faster..**.** T
c8e0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 65 78 70  he following exp
c8f0: 72 65 73 73 69 6f 6e 73 20 61 72 65 20 65 71 75  ressions are equ
c900: 69 76 61 6c 65 6e 74 3a 0a 2a 2a 0a 2a 2a 20 20  ivalent:.**.**  
c910: 20 20 20 78 20 3d 20 73 71 6c 69 74 65 33 47 65     x = sqlite3Ge
c920: 74 56 61 72 69 6e 74 33 32 28 20 41 2c 20 26 42  tVarint32( A, &B
c930: 20 29 3b 0a 2a 2a 0a 2a 2a 20 20 20 20 20 78 20   );.**.**     x 
c940: 3d 20 47 65 74 56 61 72 69 6e 74 28 20 41 2c 20  = GetVarint( A, 
c950: 42 20 29 3b 0a 2a 2a 0a 2a 2f 0a 23 64 65 66 69  B );.**.*/.#defi
c960: 6e 65 20 47 65 74 56 61 72 69 6e 74 28 41 2c 42  ne GetVarint(A,B
c970: 29 20 20 28 28 42 20 3d 20 2a 28 41 29 29 3c 3d  )  ((B = *(A))<=
c980: 30 78 37 66 20 3f 20 31 20 3a 20 73 71 6c 69 74  0x7f ? 1 : sqlit
c990: 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 41 2c  e3GetVarint32(A,
c9a0: 20 26 42 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 69   &B))../*.** Thi
c9b0: 73 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6d 70 61  s function compa
c9c0: 72 65 73 20 74 68 65 20 74 77 6f 20 74 61 62 6c  res the two tabl
c9d0: 65 20 72 6f 77 73 20 6f 72 20 69 6e 64 65 78 20  e rows or index 
c9e0: 72 65 63 6f 72 64 73 20 73 70 65 63 69 66 69 65  records specifie
c9f0: 64 20 62 79 20 0a 2a 2a 20 7b 6e 4b 65 79 31 2c  d by .** {nKey1,
ca00: 20 70 4b 65 79 31 7d 20 61 6e 64 20 7b 6e 4b 65   pKey1} and {nKe
ca10: 79 32 2c 20 70 4b 65 79 32 7d 2c 20 72 65 74 75  y2, pKey2}, retu
ca20: 72 6e 69 6e 67 20 61 20 6e 65 67 61 74 69 76 65  rning a negative
ca30: 2c 20 7a 65 72 6f 0a 2a 2a 20 6f 72 20 70 6f 73  , zero.** or pos
ca40: 69 74 69 76 65 20 69 6e 74 65 67 65 72 20 69 66  itive integer if
ca50: 20 7b 6e 4b 65 79 31 2c 20 70 4b 65 79 31 7d 20   {nKey1, pKey1} 
ca60: 69 73 20 6c 65 73 73 20 74 68 61 6e 2c 20 65 71  is less than, eq
ca70: 75 61 6c 20 74 6f 20 6f 72 20 0a 2a 2a 20 67 72  ual to or .** gr
ca80: 65 61 74 65 72 20 74 68 61 6e 20 7b 6e 4b 65 79  eater than {nKey
ca90: 32 2c 20 70 4b 65 79 32 7d 2e 20 20 42 6f 74 68  2, pKey2}.  Both
caa0: 20 4b 65 79 31 20 61 6e 64 20 4b 65 79 32 20 6d   Key1 and Key2 m
cab0: 75 73 74 20 62 65 20 62 79 74 65 20 73 74 72 69  ust be byte stri
cac0: 6e 67 73 0a 2a 2a 20 63 6f 6d 70 6f 73 65 64 20  ngs.** composed 
cad0: 62 79 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65  by the OP_MakeRe
cae0: 63 6f 72 64 20 6f 70 63 6f 64 65 20 6f 66 20 74  cord opcode of t
caf0: 68 65 20 56 44 42 45 2e 0a 2a 2f 0a 69 6e 74 20  he VDBE..*/.int 
cb00: 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72  sqlite3VdbeRecor
cb10: 64 43 6f 6d 70 61 72 65 28 0a 20 20 76 6f 69 64  dCompare(.  void
cb20: 20 2a 75 73 65 72 44 61 74 61 2c 0a 20 20 69 6e   *userData,.  in
cb30: 74 20 6e 4b 65 79 31 2c 20 63 6f 6e 73 74 20 76  t nKey1, const v
cb40: 6f 69 64 20 2a 70 4b 65 79 31 2c 20 0a 20 20 69  oid *pKey1, .  i
cb50: 6e 74 20 6e 4b 65 79 32 2c 20 63 6f 6e 73 74 20  nt nKey2, const 
cb60: 76 6f 69 64 20 2a 70 4b 65 79 32 0a 29 7b 0a 20  void *pKey2.){. 
cb70: 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 49 6e   KeyInfo *pKeyIn
cb80: 66 6f 20 3d 20 28 4b 65 79 49 6e 66 6f 2a 29 75  fo = (KeyInfo*)u
cb90: 73 65 72 44 61 74 61 3b 0a 20 20 75 33 32 20 64  serData;.  u32 d
cba0: 31 2c 20 64 32 3b 20 20 20 20 20 20 20 20 20 20  1, d2;          
cbb0: 2f 2a 20 4f 66 66 73 65 74 20 69 6e 74 6f 20 61  /* Offset into a
cbc0: 4b 65 79 5b 5d 20 6f 66 20 6e 65 78 74 20 64 61  Key[] of next da
cbd0: 74 61 20 65 6c 65 6d 65 6e 74 20 2a 2f 0a 20 20  ta element */.  
cbe0: 75 33 32 20 69 64 78 31 2c 20 69 64 78 32 3b 20  u32 idx1, idx2; 
cbf0: 20 20 20 20 20 2f 2a 20 4f 66 66 73 65 74 20 69       /* Offset i
cc00: 6e 74 6f 20 61 4b 65 79 5b 5d 20 6f 66 20 6e 65  nto aKey[] of ne
cc10: 78 74 20 68 65 61 64 65 72 20 65 6c 65 6d 65 6e  xt header elemen
cc20: 74 20 2a 2f 0a 20 20 75 33 32 20 73 7a 48 64 72  t */.  u32 szHdr
cc30: 31 2c 20 73 7a 48 64 72 32 3b 20 20 2f 2a 20 4e  1, szHdr2;  /* N
cc40: 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 69  umber of bytes i
cc50: 6e 20 68 65 61 64 65 72 20 2a 2f 0a 20 20 69 6e  n header */.  in
cc60: 74 20 69 20 3d 20 30 3b 0a 20 20 69 6e 74 20 6e  t i = 0;.  int n
cc70: 46 69 65 6c 64 3b 0a 20 20 69 6e 74 20 72 63 20  Field;.  int rc 
cc80: 3d 20 30 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73  = 0;.  const uns
cc90: 69 67 6e 65 64 20 63 68 61 72 20 2a 61 4b 65 79  igned char *aKey
cca0: 31 20 3d 20 28 63 6f 6e 73 74 20 75 6e 73 69 67  1 = (const unsig
ccb0: 6e 65 64 20 63 68 61 72 20 2a 29 70 4b 65 79 31  ned char *)pKey1
ccc0: 3b 0a 20 20 63 6f 6e 73 74 20 75 6e 73 69 67 6e  ;.  const unsign
ccd0: 65 64 20 63 68 61 72 20 2a 61 4b 65 79 32 20 3d  ed char *aKey2 =
cce0: 20 28 63 6f 6e 73 74 20 75 6e 73 69 67 6e 65 64   (const unsigned
ccf0: 20 63 68 61 72 20 2a 29 70 4b 65 79 32 3b 0a 0a   char *)pKey2;..
cd00: 20 20 4d 65 6d 20 6d 65 6d 31 3b 0a 20 20 4d 65    Mem mem1;.  Me
cd10: 6d 20 6d 65 6d 32 3b 0a 20 20 6d 65 6d 31 2e 65  m mem2;.  mem1.e
cd20: 6e 63 20 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 65  nc = pKeyInfo->e
cd30: 6e 63 3b 0a 20 20 6d 65 6d 32 2e 65 6e 63 20 3d  nc;.  mem2.enc =
cd40: 20 70 4b 65 79 49 6e 66 6f 2d 3e 65 6e 63 3b 0a   pKeyInfo->enc;.
cd50: 20 20 0a 20 20 69 64 78 31 20 3d 20 47 65 74 56    .  idx1 = GetV
cd60: 61 72 69 6e 74 28 61 4b 65 79 31 2c 20 73 7a 48  arint(aKey1, szH
cd70: 64 72 31 29 3b 0a 20 20 64 31 20 3d 20 73 7a 48  dr1);.  d1 = szH
cd80: 64 72 31 3b 0a 20 20 69 64 78 32 20 3d 20 47 65  dr1;.  idx2 = Ge
cd90: 74 56 61 72 69 6e 74 28 61 4b 65 79 32 2c 20 73  tVarint(aKey2, s
cda0: 7a 48 64 72 32 29 3b 0a 20 20 64 32 20 3d 20 73  zHdr2);.  d2 = s
cdb0: 7a 48 64 72 32 3b 0a 20 20 6e 46 69 65 6c 64 20  zHdr2;.  nField 
cdc0: 3d 20 70 4b 65 79 49 6e 66 6f 2d 3e 6e 46 69 65  = pKeyInfo->nFie
cdd0: 6c 64 3b 0a 20 20 77 68 69 6c 65 28 20 69 64 78  ld;.  while( idx
cde0: 31 3c 73 7a 48 64 72 31 20 26 26 20 69 64 78 32  1<szHdr1 && idx2
cdf0: 3c 73 7a 48 64 72 32 20 29 7b 0a 20 20 20 20 75  <szHdr2 ){.    u
ce00: 33 32 20 73 65 72 69 61 6c 5f 74 79 70 65 31 3b  32 serial_type1;
ce10: 0a 20 20 20 20 75 33 32 20 73 65 72 69 61 6c 5f  .    u32 serial_
ce20: 74 79 70 65 32 3b 0a 0a 20 20 20 20 2f 2a 20 52  type2;..    /* R
ce30: 65 61 64 20 74 68 65 20 73 65 72 69 61 6c 20 74  ead the serial t
ce40: 79 70 65 73 20 66 6f 72 20 74 68 65 20 6e 65 78  ypes for the nex
ce50: 74 20 65 6c 65 6d 65 6e 74 20 69 6e 20 65 61 63  t element in eac
ce60: 68 20 6b 65 79 2e 20 2a 2f 0a 20 20 20 20 69 64  h key. */.    id
ce70: 78 31 20 2b 3d 20 47 65 74 56 61 72 69 6e 74 28  x1 += GetVarint(
ce80: 20 61 4b 65 79 31 2b 69 64 78 31 2c 20 73 65 72   aKey1+idx1, ser
ce90: 69 61 6c 5f 74 79 70 65 31 20 29 3b 0a 20 20 20  ial_type1 );.   
cea0: 20 69 66 28 20 64 31 3e 3d 6e 4b 65 79 31 20 26   if( d1>=nKey1 &
ceb0: 26 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72  & sqlite3VdbeSer
cec0: 69 61 6c 54 79 70 65 4c 65 6e 28 73 65 72 69 61  ialTypeLen(seria
ced0: 6c 5f 74 79 70 65 31 29 3e 30 20 29 20 62 72 65  l_type1)>0 ) bre
cee0: 61 6b 3b 0a 20 20 20 20 69 64 78 32 20 2b 3d 20  ak;.    idx2 += 
cef0: 47 65 74 56 61 72 69 6e 74 28 20 61 4b 65 79 32  GetVarint( aKey2
cf00: 2b 69 64 78 32 2c 20 73 65 72 69 61 6c 5f 74 79  +idx2, serial_ty
cf10: 70 65 32 20 29 3b 0a 20 20 20 20 69 66 28 20 64  pe2 );.    if( d
cf20: 32 3e 3d 6e 4b 65 79 32 20 26 26 20 73 71 6c 69  2>=nKey2 && sqli
cf30: 74 65 33 56 64 62 65 53 65 72 69 61 6c 54 79 70  te3VdbeSerialTyp
cf40: 65 4c 65 6e 28 73 65 72 69 61 6c 5f 74 79 70 65  eLen(serial_type
cf50: 32 29 3e 30 20 29 20 62 72 65 61 6b 3b 0a 0a 20  2)>0 ) break;.. 
cf60: 20 20 20 2f 2a 20 41 73 73 65 72 74 20 74 68 61     /* Assert tha
cf70: 74 20 74 68 65 72 65 20 69 73 20 65 6e 6f 75 67  t there is enoug
cf80: 68 20 73 70 61 63 65 20 6c 65 66 74 20 69 6e 20  h space left in 
cf90: 65 61 63 68 20 6b 65 79 20 66 6f 72 20 74 68 65  each key for the
cfa0: 20 62 6c 6f 62 20 6f 66 0a 20 20 20 20 2a 2a 20   blob of.    ** 
cfb0: 64 61 74 61 20 74 6f 20 67 6f 20 77 69 74 68 20  data to go with 
cfc0: 74 68 65 20 73 65 72 69 61 6c 20 74 79 70 65 20  the serial type 
cfd0: 6a 75 73 74 20 72 65 61 64 2e 20 54 68 69 73 20  just read. This 
cfe0: 61 73 73 65 72 74 20 6d 61 79 20 66 61 69 6c 20  assert may fail 
cff0: 69 66 0a 20 20 20 20 2a 2a 20 74 68 65 20 66 69  if.    ** the fi
d000: 6c 65 20 69 73 20 63 6f 72 72 75 70 74 65 64 2e  le is corrupted.
d010: 20 20 54 68 65 6e 20 72 65 61 64 20 74 68 65 20    Then read the 
d020: 76 61 6c 75 65 20 66 72 6f 6d 20 65 61 63 68 20  value from each 
d030: 6b 65 79 20 69 6e 74 6f 20 6d 65 6d 31 0a 20 20  key into mem1.  
d040: 20 20 2a 2a 20 61 6e 64 20 6d 65 6d 32 20 72 65    ** and mem2 re
d050: 73 70 65 63 74 69 76 65 6c 79 2e 0a 20 20 20 20  spectively..    
d060: 2a 2f 0a 20 20 20 20 64 31 20 2b 3d 20 73 71 6c  */.    d1 += sql
d070: 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 47 65  ite3VdbeSerialGe
d080: 74 28 26 61 4b 65 79 31 5b 64 31 5d 2c 20 73 65  t(&aKey1[d1], se
d090: 72 69 61 6c 5f 74 79 70 65 31 2c 20 26 6d 65 6d  rial_type1, &mem
d0a0: 31 29 3b 0a 20 20 20 20 64 32 20 2b 3d 20 73 71  1);.    d2 += sq
d0b0: 6c 69 74 65 33 56 64 62 65 53 65 72 69 61 6c 47  lite3VdbeSerialG
d0c0: 65 74 28 26 61 4b 65 79 32 5b 64 32 5d 2c 20 73  et(&aKey2[d2], s
d0d0: 65 72 69 61 6c 5f 74 79 70 65 32 2c 20 26 6d 65  erial_type2, &me
d0e0: 6d 32 29 3b 0a 0a 20 20 20 20 72 63 20 3d 20 73  m2);..    rc = s
d0f0: 71 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 61 72 65  qlite3MemCompare
d100: 28 26 6d 65 6d 31 2c 20 26 6d 65 6d 32 2c 20 69  (&mem1, &mem2, i
d110: 3c 6e 46 69 65 6c 64 20 3f 20 70 4b 65 79 49 6e  <nField ? pKeyIn
d120: 66 6f 2d 3e 61 43 6f 6c 6c 5b 69 5d 20 3a 20 30  fo->aColl[i] : 0
d130: 29 3b 0a 20 20 20 20 69 66 28 20 6d 65 6d 31 2e  );.    if( mem1.
d140: 66 6c 61 67 73 20 26 20 4d 45 4d 5f 44 79 6e 20  flags & MEM_Dyn 
d150: 29 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d  ) sqlite3VdbeMem
d160: 52 65 6c 65 61 73 65 28 26 6d 65 6d 31 29 3b 0a  Release(&mem1);.
d170: 20 20 20 20 69 66 28 20 6d 65 6d 32 2e 66 6c 61      if( mem2.fla
d180: 67 73 20 26 20 4d 45 4d 5f 44 79 6e 20 29 20 73  gs & MEM_Dyn ) s
d190: 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52 65 6c  qlite3VdbeMemRel
d1a0: 65 61 73 65 28 26 6d 65 6d 32 29 3b 0a 20 20 20  ease(&mem2);.   
d1b0: 20 69 66 28 20 72 63 21 3d 30 20 29 7b 0a 20 20   if( rc!=0 ){.  
d1c0: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d      break;.    }
d1d0: 0a 20 20 20 20 69 2b 2b 3b 0a 20 20 7d 0a 0a 20  .    i++;.  }.. 
d1e0: 20 2f 2a 20 4f 6e 65 20 6f 66 20 74 68 65 20 6b   /* One of the k
d1f0: 65 79 73 20 72 61 6e 20 6f 75 74 20 6f 66 20 66  eys ran out of f
d200: 69 65 6c 64 73 2c 20 62 75 74 20 61 6c 6c 20 74  ields, but all t
d210: 68 65 20 66 69 65 6c 64 73 20 75 70 20 74 6f 20  he fields up to 
d220: 74 68 61 74 20 70 6f 69 6e 74 0a 20 20 2a 2a 20  that point.  ** 
d230: 77 65 72 65 20 65 71 75 61 6c 2e 20 49 66 20 74  were equal. If t
d240: 68 65 20 69 6e 63 72 4b 65 79 20 66 6c 61 67 20  he incrKey flag 
d250: 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 74 68  is true, then th
d260: 65 20 73 65 63 6f 6e 64 20 6b 65 79 20 69 73 0a  e second key is.
d270: 20 20 2a 2a 20 74 72 65 61 74 65 64 20 61 73 20    ** treated as 
d280: 6c 61 72 67 65 72 2e 0a 20 20 2a 2f 0a 20 20 69  larger..  */.  i
d290: 66 28 20 72 63 3d 3d 30 20 29 7b 0a 20 20 20 20  f( rc==0 ){.    
d2a0: 69 66 28 20 70 4b 65 79 49 6e 66 6f 2d 3e 69 6e  if( pKeyInfo->in
d2b0: 63 72 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 72  crKey ){.      r
d2c0: 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 65 6c 73  c = -1;.    }els
d2d0: 65 20 69 66 28 20 64 31 3c 6e 4b 65 79 31 20 29  e if( d1<nKey1 )
d2e0: 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 31 3b 0a  {.      rc = 1;.
d2f0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 64 32      }else if( d2
d300: 3c 6e 4b 65 79 32 20 29 7b 0a 20 20 20 20 20 20  <nKey2 ){.      
d310: 72 63 20 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a 20  rc = -1;.    }. 
d320: 20 7d 65 6c 73 65 20 69 66 28 20 70 4b 65 79 49   }else if( pKeyI
d330: 6e 66 6f 2d 3e 61 53 6f 72 74 4f 72 64 65 72 20  nfo->aSortOrder 
d340: 26 26 20 69 3c 70 4b 65 79 49 6e 66 6f 2d 3e 6e  && i<pKeyInfo->n
d350: 46 69 65 6c 64 0a 20 20 20 20 20 20 20 20 20 20  Field.          
d360: 20 20 20 20 20 26 26 20 70 4b 65 79 49 6e 66 6f       && pKeyInfo
d370: 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 69 5d 20  ->aSortOrder[i] 
d380: 29 7b 0a 20 20 20 20 72 63 20 3d 20 2d 72 63 3b  ){.    rc = -rc;
d390: 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72  .  }..  return r
d3a0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20  c;.}../*.** The 
d3b0: 61 72 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 69  argument is an i
d3c0: 6e 64 65 78 20 65 6e 74 72 79 20 63 6f 6d 70 6f  ndex entry compo
d3d0: 73 65 64 20 75 73 69 6e 67 20 74 68 65 20 4f 50  sed using the OP
d3e0: 5f 4d 61 6b 65 52 65 63 6f 72 64 20 6f 70 63 6f  _MakeRecord opco
d3f0: 64 65 2e 0a 2a 2a 20 54 68 65 20 6c 61 73 74 20  de..** The last 
d400: 65 6e 74 72 79 20 69 6e 20 74 68 69 73 20 72 65  entry in this re
d410: 63 6f 72 64 20 73 68 6f 75 6c 64 20 62 65 20 61  cord should be a
d420: 6e 20 69 6e 74 65 67 65 72 20 28 73 70 65 63 69  n integer (speci
d430: 66 69 63 61 6c 6c 79 0a 2a 2a 20 61 6e 20 69 6e  fically.** an in
d440: 74 65 67 65 72 20 72 6f 77 69 64 29 2e 20 20 54  teger rowid).  T
d450: 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 75  his routine retu
d460: 72 6e 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f  rns the number o
d470: 66 20 62 79 74 65 73 20 69 6e 0a 2a 2a 20 74 68  f bytes in.** th
d480: 61 74 20 69 6e 74 65 67 65 72 2e 0a 2a 2f 0a 69  at integer..*/.i
d490: 6e 74 20 73 71 6c 69 74 65 33 56 64 62 65 49 64  nt sqlite3VdbeId
d4a0: 78 52 6f 77 69 64 4c 65 6e 28 69 6e 74 20 6e 4b  xRowidLen(int nK
d4b0: 65 79 2c 20 63 6f 6e 73 74 20 75 38 20 2a 61 4b  ey, const u8 *aK
d4c0: 65 79 29 7b 0a 20 20 75 33 32 20 73 7a 48 64 72  ey){.  u32 szHdr
d4d0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 53 69 7a 65  ;        /* Size
d4e0: 20 6f 66 20 74 68 65 20 68 65 61 64 65 72 20 2a   of the header *
d4f0: 2f 0a 20 20 75 33 32 20 74 79 70 65 52 6f 77 69  /.  u32 typeRowi
d500: 64 3b 20 20 20 20 2f 2a 20 53 65 72 69 61 6c 20  d;    /* Serial 
d510: 74 79 70 65 20 6f 66 20 74 68 65 20 72 6f 77 69  type of the rowi
d520: 64 20 2a 2f 0a 0a 20 20 73 71 6c 69 74 65 33 47  d */..  sqlite3G
d530: 65 74 56 61 72 69 6e 74 33 32 28 61 4b 65 79 2c  etVarint32(aKey,
d540: 20 26 73 7a 48 64 72 29 3b 0a 20 20 73 71 6c 69   &szHdr);.  sqli
d550: 74 65 33 47 65 74 56 61 72 69 6e 74 33 32 28 26  te3GetVarint32(&
d560: 61 4b 65 79 5b 73 7a 48 64 72 2d 31 5d 2c 20 26  aKey[szHdr-1], &
d570: 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 72 65  typeRowid);.  re
d580: 74 75 72 6e 20 73 71 6c 69 74 65 33 56 64 62 65  turn sqlite3Vdbe
d590: 53 65 72 69 61 6c 54 79 70 65 4c 65 6e 28 74 79  SerialTypeLen(ty
d5a0: 70 65 52 6f 77 69 64 29 3b 0a 7d 0a 20 20 0a 0a  peRowid);.}.  ..
d5b0: 2f 2a 0a 2a 2a 20 70 43 75 72 20 70 6f 69 6e 74  /*.** pCur point
d5c0: 73 20 61 74 20 61 6e 20 69 6e 64 65 78 20 65 6e  s at an index en
d5d0: 74 72 79 20 63 72 65 61 74 65 64 20 75 73 69 6e  try created usin
d5e0: 67 20 74 68 65 20 4f 50 5f 4d 61 6b 65 52 65 63  g the OP_MakeRec
d5f0: 6f 72 64 20 6f 70 63 6f 64 65 2e 0a 2a 2a 20 52  ord opcode..** R
d600: 65 61 64 20 74 68 65 20 72 6f 77 69 64 20 28 74  ead the rowid (t
d610: 68 65 20 6c 61 73 74 20 66 69 65 6c 64 20 69 6e  he last field in
d620: 20 74 68 65 20 72 65 63 6f 72 64 29 20 61 6e 64   the record) and
d630: 20 73 74 6f 72 65 20 69 74 20 69 6e 20 2a 72 6f   store it in *ro
d640: 77 69 64 2e 0a 2a 2a 20 52 65 74 75 72 6e 20 53  wid..** Return S
d650: 51 4c 49 54 45 5f 4f 4b 20 69 66 20 65 76 65 72  QLITE_OK if ever
d660: 79 74 68 69 6e 67 20 77 6f 72 6b 73 2c 20 6f 72  ything works, or
d670: 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 6f   an error code o
d680: 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 69 6e 74  therwise..*/.int
d690: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 52   sqlite3VdbeIdxR
d6a0: 6f 77 69 64 28 42 74 43 75 72 73 6f 72 20 2a 70  owid(BtCursor *p
d6b0: 43 75 72 2c 20 69 36 34 20 2a 72 6f 77 69 64 29  Cur, i64 *rowid)
d6c0: 7b 0a 20 20 69 36 34 20 6e 43 65 6c 6c 4b 65 79  {.  i64 nCellKey
d6d0: 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 75 33  ;.  int rc;.  u3
d6e0: 32 20 73 7a 48 64 72 3b 20 20 20 20 20 20 20 20  2 szHdr;        
d6f0: 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 68  /* Size of the h
d700: 65 61 64 65 72 20 2a 2f 0a 20 20 75 33 32 20 74  eader */.  u32 t
d710: 79 70 65 52 6f 77 69 64 3b 20 20 20 20 2f 2a 20  ypeRowid;    /* 
d720: 53 65 72 69 61 6c 20 74 79 70 65 20 6f 66 20 74  Serial type of t
d730: 68 65 20 72 6f 77 69 64 20 2a 2f 0a 20 20 75 33  he rowid */.  u3
d740: 32 20 6c 65 6e 52 6f 77 69 64 3b 20 20 20 20 20  2 lenRowid;     
d750: 2f 2a 20 53 69 7a 65 20 6f 66 20 74 68 65 20 72  /* Size of the r
d760: 6f 77 69 64 20 2a 2f 0a 20 20 4d 65 6d 20 6d 2c  owid */.  Mem m,
d770: 20 76 3b 0a 0a 20 20 73 71 6c 69 74 65 33 42 74   v;..  sqlite3Bt
d780: 72 65 65 4b 65 79 53 69 7a 65 28 70 43 75 72 2c  reeKeySize(pCur,
d790: 20 26 6e 43 65 6c 6c 4b 65 79 29 3b 0a 20 20 69   &nCellKey);.  i
d7a0: 66 28 20 6e 43 65 6c 6c 4b 65 79 3c 3d 30 20 29  f( nCellKey<=0 )
d7b0: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  {.    return SQL
d7c0: 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54  ITE_CORRUPT_BKPT
d7d0: 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c  ;.  }.  rc = sql
d7e0: 69 74 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42  ite3VdbeMemFromB
d7f0: 74 72 65 65 28 70 43 75 72 2c 20 30 2c 20 6e 43  tree(pCur, 0, nC
d800: 65 6c 6c 4b 65 79 2c 20 31 2c 20 26 6d 29 3b 0a  ellKey, 1, &m);.
d810: 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20    if( rc ){.    
d820: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20  return rc;.  }. 
d830: 20 73 71 6c 69 74 65 33 47 65 74 56 61 72 69 6e   sqlite3GetVarin
d840: 74 33 32 28 28 75 38 2a 29 6d 2e 7a 2c 20 26 73  t32((u8*)m.z, &s
d850: 7a 48 64 72 29 3b 0a 20 20 73 71 6c 69 74 65 33  zHdr);.  sqlite3
d860: 47 65 74 56 61 72 69 6e 74 33 32 28 28 75 38 2a  GetVarint32((u8*
d870: 29 26 6d 2e 7a 5b 73 7a 48 64 72 2d 31 5d 2c 20  )&m.z[szHdr-1], 
d880: 26 74 79 70 65 52 6f 77 69 64 29 3b 0a 20 20 6c  &typeRowid);.  l
d890: 65 6e 52 6f 77 69 64 20 3d 20 73 71 6c 69 74 65  enRowid = sqlite
d8a0: 33 56 64 62 65 53 65 72 69 61 6c 54 79 70 65 4c  3VdbeSerialTypeL
d8b0: 65 6e 28 74 79 70 65 52 6f 77 69 64 29 3b 0a 20  en(typeRowid);. 
d8c0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 72 69   sqlite3VdbeSeri
d8d0: 61 6c 47 65 74 28 28 75 38 2a 29 26 6d 2e 7a 5b  alGet((u8*)&m.z[
d8e0: 6d 2e 6e 2d 6c 65 6e 52 6f 77 69 64 5d 2c 20 74  m.n-lenRowid], t
d8f0: 79 70 65 52 6f 77 69 64 2c 20 26 76 29 3b 0a 20  ypeRowid, &v);. 
d900: 20 2a 72 6f 77 69 64 20 3d 20 76 2e 69 3b 0a 20   *rowid = v.i;. 
d910: 20 73 71 6c 69 74 65 33 56 64 62 65 4d 65 6d 52   sqlite3VdbeMemR
d920: 65 6c 65 61 73 65 28 26 6d 29 3b 0a 20 20 72 65  elease(&m);.  re
d930: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
d940: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 61 72 65  }../*.** Compare
d950: 20 74 68 65 20 6b 65 79 20 6f 66 20 74 68 65 20   the key of the 
d960: 69 6e 64 65 78 20 65 6e 74 72 79 20 74 68 61 74  index entry that
d970: 20 63 75 72 73 6f 72 20 70 43 20 69 73 20 70 6f   cursor pC is po
d980: 69 6e 74 20 74 6f 20 61 67 61 69 6e 73 74 0a 2a  int to against.*
d990: 2a 20 74 68 65 20 6b 65 79 20 73 74 72 69 6e 67  * the key string
d9a0: 20 69 6e 20 70 4b 65 79 20 28 6f 66 20 6c 65 6e   in pKey (of len
d9b0: 67 74 68 20 6e 4b 65 79 29 2e 20 20 57 72 69 74  gth nKey).  Writ
d9c0: 65 20 69 6e 74 6f 20 2a 70 52 65 73 20 61 20 6e  e into *pRes a n
d9d0: 75 6d 62 65 72 0a 2a 2a 20 74 68 61 74 20 69 73  umber.** that is
d9e0: 20 6e 65 67 61 74 69 76 65 2c 20 7a 65 72 6f 2c   negative, zero,
d9f0: 20 6f 72 20 70 6f 73 69 74 69 76 65 20 69 66 20   or positive if 
da00: 70 43 20 69 73 20 6c 65 73 73 20 74 68 61 6e 2c  pC is less than,
da10: 20 65 71 75 61 6c 20 74 6f 2c 0a 2a 2a 20 6f 72   equal to,.** or
da20: 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 70 4b   greater than pK
da30: 65 79 2e 20 20 52 65 74 75 72 6e 20 53 51 4c 49  ey.  Return SQLI
da40: 54 45 5f 4f 4b 20 6f 6e 20 73 75 63 63 65 73 73  TE_OK on success
da50: 2e 0a 2a 2a 0a 2a 2a 20 70 4b 65 79 20 69 73 20  ..**.** pKey is 
da60: 65 69 74 68 65 72 20 63 72 65 61 74 65 64 20 77  either created w
da70: 69 74 68 6f 75 74 20 61 20 72 6f 77 69 64 20 6f  ithout a rowid o
da80: 72 20 69 73 20 74 72 75 6e 63 61 74 65 64 20 73  r is truncated s
da90: 6f 20 74 68 61 74 20 69 74 0a 2a 2a 20 6f 6d 69  o that it.** omi
daa0: 74 73 20 74 68 65 20 72 6f 77 69 64 20 61 74 20  ts the rowid at 
dab0: 74 68 65 20 65 6e 64 2e 20 20 54 68 65 20 72 6f  the end.  The ro
dac0: 77 69 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f  wid at the end o
dad0: 66 20 74 68 65 20 69 6e 64 65 78 20 65 6e 74 72  f the index entr
dae0: 79 0a 2a 2a 20 69 73 20 69 67 6e 6f 72 65 64 20  y.** is ignored 
daf0: 61 73 20 77 65 6c 6c 2e 0a 2a 2f 0a 69 6e 74 20  as well..*/.int 
db00: 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 4b 65  sqlite3VdbeIdxKe
db10: 79 43 6f 6d 70 61 72 65 28 0a 20 20 43 75 72 73  yCompare(.  Curs
db20: 6f 72 20 2a 70 43 2c 20 20 20 20 20 20 20 20 20  or *pC,         
db30: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63          /* The c
db40: 75 72 73 6f 72 20 74 6f 20 63 6f 6d 70 61 72 65  ursor to compare
db50: 20 61 67 61 69 6e 73 74 20 2a 2f 0a 20 20 69 6e   against */.  in
db60: 74 20 6e 4b 65 79 2c 20 63 6f 6e 73 74 20 75 38  t nKey, const u8
db70: 20 2a 70 4b 65 79 2c 20 20 20 2f 2a 20 54 68 65   *pKey,   /* The
db80: 20 6b 65 79 20 74 6f 20 63 6f 6d 70 61 72 65 20   key to compare 
db90: 2a 2f 0a 20 20 69 6e 74 20 2a 72 65 73 20 20 20  */.  int *res   
dba0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
dbb0: 20 2f 2a 20 57 72 69 74 65 20 74 68 65 20 63 6f   /* Write the co
dbc0: 6d 70 61 72 69 73 6f 6e 20 72 65 73 75 6c 74 20  mparison result 
dbd0: 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 69 36 34  here */.){.  i64
dbe0: 20 6e 43 65 6c 6c 4b 65 79 3b 0a 20 20 69 6e 74   nCellKey;.  int
dbf0: 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20   rc;.  BtCursor 
dc00: 2a 70 43 75 72 20 3d 20 70 43 2d 3e 70 43 75 72  *pCur = pC->pCur
dc10: 73 6f 72 3b 0a 20 20 69 6e 74 20 6c 65 6e 52 6f  sor;.  int lenRo
dc20: 77 69 64 3b 0a 20 20 4d 65 6d 20 6d 3b 0a 0a 20  wid;.  Mem m;.. 
dc30: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4b 65 79   sqlite3BtreeKey
dc40: 53 69 7a 65 28 70 43 75 72 2c 20 26 6e 43 65 6c  Size(pCur, &nCel
dc50: 6c 4b 65 79 29 3b 0a 20 20 69 66 28 20 6e 43 65  lKey);.  if( nCe
dc60: 6c 6c 4b 65 79 3c 3d 30 20 29 7b 0a 20 20 20 20  llKey<=0 ){.    
dc70: 2a 72 65 73 20 3d 20 30 3b 0a 20 20 20 20 72 65  *res = 0;.    re
dc80: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
dc90: 20 20 7d 0a 20 20 72 63 20 3d 20 73 71 6c 69 74    }.  rc = sqlit
dca0: 65 33 56 64 62 65 4d 65 6d 46 72 6f 6d 42 74 72  e3VdbeMemFromBtr
dcb0: 65 65 28 70 43 2d 3e 70 43 75 72 73 6f 72 2c 20  ee(pC->pCursor, 
dcc0: 30 2c 20 6e 43 65 6c 6c 4b 65 79 2c 20 31 2c 20  0, nCellKey, 1, 
dcd0: 26 6d 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b  &m);.  if( rc ){
dce0: 0a 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  .    return rc;.
dcf0: 20 20 7d 0a 20 20 6c 65 6e 52 6f 77 69 64 20 3d    }.  lenRowid =
dd00: 20 73 71 6c 69 74 65 33 56 64 62 65 49 64 78 52   sqlite3VdbeIdxR
dd10: 6f 77 69 64 4c 65 6e 28 6d 2e 6e 2c 20 28 75 38  owidLen(m.n, (u8
dd20: 2a 29 6d 2e 7a 29 3b 0a 20 20 2a 72 65 73 20 3d  *)m.z);.  *res =
dd30: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f   sqlite3VdbeReco
dd40: 72 64 43 6f 6d 70 61 72 65 28 70 43 2d 3e 70 4b  rdCompare(pC->pK
dd50: 65 79 49 6e 66 6f 2c 20 6d 2e 6e 2d 6c 65 6e 52  eyInfo, m.n-lenR
dd60: 6f 77 69 64 2c 20 6d 2e 7a 2c 20 6e 4b 65 79 2c  owid, m.z, nKey,
dd70: 20 70 4b 65 79 29 3b 0a 20 20 73 71 6c 69 74 65   pKey);.  sqlite
dd80: 33 56 64 62 65 4d 65 6d 52 65 6c 65 61 73 65 28  3VdbeMemRelease(
dd90: 26 6d 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51  &m);.  return SQ
dda0: 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a  LITE_OK;.}../*.*
ddb0: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 73  * This routine s
ddc0: 65 74 73 20 74 68 65 20 76 61 6c 75 65 20 74 6f  ets the value to
ddd0: 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 79 20   be returned by 
dde0: 73 75 62 73 65 71 75 65 6e 74 20 63 61 6c 6c 73  subsequent calls
ddf0: 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 63   to.** sqlite3_c
de00: 68 61 6e 67 65 73 28 29 20 6f 6e 20 74 68 65 20  hanges() on the 
de10: 64 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20  database handle 
de20: 27 64 62 27 2e 20 0a 2a 2f 0a 76 6f 69 64 20 73  'db'. .*/.void s
de30: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 68 61  qlite3VdbeSetCha
de40: 6e 67 65 73 28 73 71 6c 69 74 65 33 20 2a 64 62  nges(sqlite3 *db
de50: 2c 20 69 6e 74 20 6e 43 68 61 6e 67 65 29 7b 0a  , int nChange){.
de60: 20 20 64 62 2d 3e 6e 43 68 61 6e 67 65 20 3d 20    db->nChange = 
de70: 6e 43 68 61 6e 67 65 3b 0a 20 20 64 62 2d 3e 6e  nChange;.  db->n
de80: 54 6f 74 61 6c 43 68 61 6e 67 65 20 2b 3d 20 6e  TotalChange += n
de90: 43 68 61 6e 67 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  Change;.}../*.**
dea0: 20 53 65 74 20 61 20 66 6c 61 67 20 69 6e 20 74   Set a flag in t
deb0: 68 65 20 76 64 62 65 20 74 6f 20 75 70 64 61 74  he vdbe to updat
dec0: 65 20 74 68 65 20 63 68 61 6e 67 65 20 63 6f 75  e the change cou
ded0: 6e 74 65 72 20 77 68 65 6e 20 69 74 20 69 73 20  nter when it is 
dee0: 66 69 6e 61 6c 69 73 65 64 0a 2a 2a 20 6f 72 20  finalised.** or 
def0: 72 65 73 65 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73  reset..*/.void s
df00: 71 6c 69 74 65 33 56 64 62 65 43 6f 75 6e 74 43  qlite3VdbeCountC
df10: 68 61 6e 67 65 73 28 56 64 62 65 20 2a 76 29 7b  hanges(Vdbe *v){
df20: 0a 20 20 76 2d 3e 63 68 61 6e 67 65 43 6e 74 4f  .  v->changeCntO
df30: 6e 20 3d 20 31 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  n = 1;.}../*.** 
df40: 4d 61 72 6b 20 65 76 65 72 79 20 70 72 65 70 61  Mark every prepa
df50: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 73  red statement as
df60: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20  sociated with a 
df70: 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74  database connect
df80: 69 6f 6e 0a 2a 2a 20 61 73 20 65 78 70 69 72 65  ion.** as expire
df90: 64 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 70 69  d..**.** An expi
dfa0: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 6d 65  red statement me
dfb0: 61 6e 73 20 74 68 61 74 20 72 65 63 6f 6d 70 69  ans that recompi
dfc0: 6c 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 73 74  lation of the st
dfd0: 61 74 65 6d 65 6e 74 20 69 73 0a 2a 2a 20 72 65  atement is.** re
dfe0: 63 6f 6d 6d 65 6e 64 2e 20 20 53 74 61 74 65 6d  commend.  Statem
dff0: 65 6e 74 73 20 65 78 70 69 72 65 20 77 68 65 6e  ents expire when
e000: 20 74 68 69 6e 67 73 20 68 61 70 70 65 6e 20 74   things happen t
e010: 68 61 74 20 6d 61 6b 65 20 74 68 65 69 72 0a 2a  hat make their.*
e020: 2a 20 70 72 6f 67 72 61 6d 73 20 6f 62 73 6f 6c  * programs obsol
e030: 65 74 65 2e 20 20 52 65 6d 6f 76 69 6e 67 20 75  ete.  Removing u
e040: 73 65 72 2d 64 65 66 69 6e 65 64 20 66 75 6e 63  ser-defined func
e050: 74 69 6f 6e 73 20 6f 72 20 63 6f 6c 6c 61 74 69  tions or collati
e060: 6e 67 0a 2a 2a 20 73 65 71 75 65 6e 63 65 73 2c  ng.** sequences,
e070: 20 6f 72 20 63 68 61 6e 67 69 6e 67 20 61 6e 20   or changing an 
e080: 61 75 74 68 6f 72 69 7a 61 74 69 6f 6e 20 66 75  authorization fu
e090: 6e 63 74 69 6f 6e 20 61 72 65 20 74 68 65 20 74  nction are the t
e0a0: 79 70 65 73 20 6f 66 0a 2a 2a 20 74 68 69 6e 67  ypes of.** thing
e0b0: 73 20 74 68 61 74 20 6d 61 6b 65 20 70 72 65 70  s that make prep
e0c0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 73 20  ared statements 
e0d0: 6f 62 73 6f 6c 65 74 65 2e 0a 2a 2f 0a 76 6f 69  obsolete..*/.voi
e0e0: 64 20 73 71 6c 69 74 65 33 45 78 70 69 72 65 50  d sqlite3ExpireP
e0f0: 72 65 70 61 72 65 64 53 74 61 74 65 6d 65 6e 74  reparedStatement
e100: 73 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  s(sqlite3 *db){.
e110: 20 20 56 64 62 65 20 2a 70 3b 0a 20 20 66 6f 72    Vdbe *p;.  for
e120: 28 70 20 3d 20 64 62 2d 3e 70 56 64 62 65 3b 20  (p = db->pVdbe; 
e130: 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a  p; p=p->pNext){.
e140: 20 20 20 20 70 2d 3e 65 78 70 69 72 65 64 20 3d      p->expired =
e150: 20 31 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a   1;.  }.}../*.**
e160: 20 52 65 74 75 72 6e 20 74 68 65 20 64 61 74 61   Return the data
e170: 62 61 73 65 20 61 73 73 6f 63 69 61 74 65 64 20  base associated 
e180: 77 69 74 68 20 74 68 65 20 56 64 62 65 2e 0a 2a  with the Vdbe..*
e190: 2f 0a 73 71 6c 69 74 65 33 20 2a 73 71 6c 69 74  /.sqlite3 *sqlit
e1a0: 65 33 56 64 62 65 44 62 28 56 64 62 65 20 2a 76  e3VdbeDb(Vdbe *v
e1b0: 29 7b 0a 20 20 72 65 74 75 72 6e 20 76 2d 3e 64  ){.  return v->d
e1c0: 62 3b 0a 7d 0a                                   b;.}.